Repository: rk700/PyMuPDF Branch: main Commit: ae19b1ad6ce0 Files: 589 Total size: 9.1 MB Directory structure: gitextract_dv05yjlp/ ├── .gitattributes ├── .github/ │ ├── ISSUE_TEMPLATE/ │ │ ├── bug_report.yml │ │ └── feature_request.md │ └── workflows/ │ ├── build_wheels.yml │ ├── cla.yml │ ├── test-valgrind.yml │ ├── test.yml │ ├── test_multiple.yml │ ├── test_pyodide.yml │ ├── test_quick.yml │ └── test_sysinstall.yml ├── .gitignore ├── .python-version ├── .readthedocs.yaml ├── .vs/ │ ├── ProjectSettings.json │ ├── PyMuPDF/ │ │ └── v15/ │ │ └── .suo │ └── VSWorkspaceState.json ├── COPYING ├── README.md ├── READMEb.md ├── READMEd.md ├── changes.txt ├── docs/ │ ├── 404.rst │ ├── README.md │ ├── _static/ │ │ ├── custom.css │ │ └── prism/ │ │ ├── prism.css │ │ ├── prism.html │ │ └── prism.js │ ├── about-feature-matrix.rst │ ├── about-performance.rst │ ├── about.rst │ ├── algebra.rst │ ├── annot.rst │ ├── app1.rst │ ├── app2.rst │ ├── app3.rst │ ├── app4.rst │ ├── archive-class.rst │ ├── changes.rst │ ├── classes.rst │ ├── colors.rst │ ├── colorspace.rst │ ├── conf.py │ ├── converting-files.rst │ ├── coop_low.rst │ ├── device.rst │ ├── displaylist.rst │ ├── document-writer-class.rst │ ├── document.rst │ ├── extensions/ │ │ ├── __init__.py │ │ ├── fulltoc.py │ │ └── searchrepair.py │ ├── faq/ │ │ └── index.rst │ ├── faq.rst │ ├── font.rst │ ├── footer.rst │ ├── functions.rst │ ├── glossary.rst │ ├── header-404.rst │ ├── header.rst │ ├── how-to-open-a-file.rst │ ├── identity.rst │ ├── index.rst │ ├── installation.rst │ ├── irect.rst │ ├── link.rst │ ├── linkdest.rst │ ├── locales/ │ │ ├── ja/ │ │ │ ├── .readthedocs.yaml │ │ │ └── LC_MESSAGES/ │ │ │ ├── 404.mo │ │ │ ├── 404.po │ │ │ ├── about-feature-matrix.mo │ │ │ ├── about-feature-matrix.po │ │ │ ├── about-performance.mo │ │ │ ├── about-performance.po │ │ │ ├── about.mo │ │ │ ├── about.po │ │ │ ├── algebra.mo │ │ │ ├── algebra.po │ │ │ ├── annot.mo │ │ │ ├── annot.po │ │ │ ├── app1.mo │ │ │ ├── app1.po │ │ │ ├── app2.mo │ │ │ ├── app2.po │ │ │ ├── app3.mo │ │ │ ├── app3.po │ │ │ ├── app4.mo │ │ │ ├── app4.po │ │ │ ├── archive-class.mo │ │ │ ├── archive-class.po │ │ │ ├── changes.mo │ │ │ ├── changes.po │ │ │ ├── classes.mo │ │ │ ├── classes.po │ │ │ ├── colors.mo │ │ │ ├── colors.po │ │ │ ├── colorspace.mo │ │ │ ├── colorspace.po │ │ │ ├── converting-files.mo │ │ │ ├── converting-files.po │ │ │ ├── coop_low.mo │ │ │ ├── coop_low.po │ │ │ ├── deprecated.mo │ │ │ ├── deprecated.po │ │ │ ├── device.mo │ │ │ ├── device.po │ │ │ ├── displaylist.mo │ │ │ ├── displaylist.po │ │ │ ├── document-writer-class.mo │ │ │ ├── document-writer-class.po │ │ │ ├── document.mo │ │ │ ├── document.po │ │ │ ├── faq.mo │ │ │ ├── faq.po │ │ │ ├── font.mo │ │ │ ├── font.po │ │ │ ├── footer.mo │ │ │ ├── footer.po │ │ │ ├── functions.mo │ │ │ ├── functions.po │ │ │ ├── glossary.mo │ │ │ ├── glossary.po │ │ │ ├── header-404.mo │ │ │ ├── header-404.po │ │ │ ├── header.mo │ │ │ ├── header.po │ │ │ ├── how-to-open-a-file.mo │ │ │ ├── how-to-open-a-file.po │ │ │ ├── identity.mo │ │ │ ├── identity.po │ │ │ ├── index.mo │ │ │ ├── index.po │ │ │ ├── installation.mo │ │ │ ├── installation.po │ │ │ ├── intro.mo │ │ │ ├── intro.po │ │ │ ├── irect.mo │ │ │ ├── irect.po │ │ │ ├── link.mo │ │ │ ├── link.po │ │ │ ├── linkdest.mo │ │ │ ├── linkdest.po │ │ │ ├── lowlevel.mo │ │ │ ├── lowlevel.po │ │ │ ├── matrix.mo │ │ │ ├── matrix.po │ │ │ ├── module.mo │ │ │ ├── module.po │ │ │ ├── outline.mo │ │ │ ├── outline.po │ │ │ ├── packaging.mo │ │ │ ├── packaging.po │ │ │ ├── page.mo │ │ │ ├── page.po │ │ │ ├── pixmap.mo │ │ │ ├── pixmap.po │ │ │ ├── point.mo │ │ │ ├── point.po │ │ │ ├── pymupdf-layout/ │ │ │ │ ├── index.mo │ │ │ │ └── index.po │ │ │ ├── pymupdf-pro/ │ │ │ │ ├── index.mo │ │ │ │ └── index.po │ │ │ ├── pymupdf-pro.mo │ │ │ ├── pymupdf-pro.po │ │ │ ├── pymupdf4llm/ │ │ │ │ ├── api.mo │ │ │ │ ├── api.po │ │ │ │ ├── index.mo │ │ │ │ └── index.po │ │ │ ├── pyodide.mo │ │ │ ├── pyodide.po │ │ │ ├── quad.mo │ │ │ ├── quad.po │ │ │ ├── rag.mo │ │ │ ├── rag.po │ │ │ ├── recipes-annotations.mo │ │ │ ├── recipes-annotations.po │ │ │ ├── recipes-common-issues-and-their-solutions.mo │ │ │ ├── recipes-common-issues-and-their-solutions.po │ │ │ ├── recipes-drawing-and-graphics.mo │ │ │ ├── recipes-drawing-and-graphics.po │ │ │ ├── recipes-images.mo │ │ │ ├── recipes-images.po │ │ │ ├── recipes-journalling.mo │ │ │ ├── recipes-journalling.po │ │ │ ├── recipes-low-level-interfaces.mo │ │ │ ├── recipes-low-level-interfaces.po │ │ │ ├── recipes-multiprocessing.mo │ │ │ ├── recipes-multiprocessing.po │ │ │ ├── recipes-ocr.mo │ │ │ ├── recipes-ocr.po │ │ │ ├── recipes-optional-content.mo │ │ │ ├── recipes-optional-content.po │ │ │ ├── recipes-stories.mo │ │ │ ├── recipes-stories.po │ │ │ ├── recipes-text.mo │ │ │ ├── recipes-text.po │ │ │ ├── recipes.mo │ │ │ ├── recipes.po │ │ │ ├── rect.mo │ │ │ ├── rect.po │ │ │ ├── resources.mo │ │ │ ├── resources.po │ │ │ ├── shape.mo │ │ │ ├── shape.po │ │ │ ├── story-class.mo │ │ │ ├── story-class.po │ │ │ ├── supported-files-table.mo │ │ │ ├── supported-files-table.po │ │ │ ├── textpage.mo │ │ │ ├── textpage.po │ │ │ ├── textwriter.mo │ │ │ ├── textwriter.po │ │ │ ├── the-basics.mo │ │ │ ├── the-basics.po │ │ │ ├── tools.mo │ │ │ ├── tools.po │ │ │ ├── tutorial.mo │ │ │ ├── tutorial.po │ │ │ ├── vars.mo │ │ │ ├── vars.po │ │ │ ├── version.mo │ │ │ ├── version.po │ │ │ ├── widget.mo │ │ │ ├── widget.po │ │ │ ├── xml-class.mo │ │ │ ├── xml-class.po │ │ │ ├── znames.mo │ │ │ └── znames.po │ │ └── ko/ │ │ ├── .readthedocs.yaml │ │ └── LC_MESSAGES/ │ │ ├── 404.mo │ │ ├── 404.po │ │ ├── about-feature-matrix.mo │ │ ├── about-feature-matrix.po │ │ ├── about-performance.mo │ │ ├── about-performance.po │ │ ├── about.mo │ │ ├── about.po │ │ ├── algebra.mo │ │ ├── algebra.po │ │ ├── annot.mo │ │ ├── annot.po │ │ ├── app1.mo │ │ ├── app1.po │ │ ├── app2.mo │ │ ├── app2.po │ │ ├── app3.mo │ │ ├── app3.po │ │ ├── app4.mo │ │ ├── app4.po │ │ ├── archive-class.mo │ │ ├── archive-class.po │ │ ├── changes.mo │ │ ├── changes.po │ │ ├── classes.mo │ │ ├── classes.po │ │ ├── colors.mo │ │ ├── colors.po │ │ ├── colorspace.mo │ │ ├── colorspace.po │ │ ├── converting-files.mo │ │ ├── converting-files.po │ │ ├── coop_low.mo │ │ ├── coop_low.po │ │ ├── device.mo │ │ ├── device.po │ │ ├── displaylist.mo │ │ ├── displaylist.po │ │ ├── document-writer-class.mo │ │ ├── document-writer-class.po │ │ ├── document.mo │ │ ├── document.po │ │ ├── faq.mo │ │ ├── faq.po │ │ ├── font.mo │ │ ├── font.po │ │ ├── footer.mo │ │ ├── footer.po │ │ ├── functions.mo │ │ ├── functions.po │ │ ├── glossary.mo │ │ ├── glossary.po │ │ ├── header-404.mo │ │ ├── header-404.po │ │ ├── header.mo │ │ ├── header.po │ │ ├── how-to-open-a-file.mo │ │ ├── how-to-open-a-file.po │ │ ├── identity.mo │ │ ├── identity.po │ │ ├── index.mo │ │ ├── index.po │ │ ├── installation.mo │ │ ├── installation.po │ │ ├── irect.mo │ │ ├── irect.po │ │ ├── link.mo │ │ ├── link.po │ │ ├── linkdest.mo │ │ ├── linkdest.po │ │ ├── lowlevel.mo │ │ ├── lowlevel.po │ │ ├── matrix.mo │ │ ├── matrix.po │ │ ├── module.mo │ │ ├── module.po │ │ ├── outline.mo │ │ ├── outline.po │ │ ├── packaging.mo │ │ ├── packaging.po │ │ ├── page.mo │ │ ├── page.po │ │ ├── pixmap.mo │ │ ├── pixmap.po │ │ ├── point.mo │ │ ├── point.po │ │ ├── pymupdf-layout/ │ │ │ ├── index.mo │ │ │ └── index.po │ │ ├── pymupdf-pro/ │ │ │ ├── index.mo │ │ │ └── index.po │ │ ├── pymupdf4llm/ │ │ │ ├── api.mo │ │ │ ├── api.po │ │ │ ├── index.mo │ │ │ └── index.po │ │ ├── pyodide.mo │ │ ├── pyodide.po │ │ ├── quad.mo │ │ ├── quad.po │ │ ├── rag.mo │ │ ├── rag.po │ │ ├── recipes-annotations.mo │ │ ├── recipes-annotations.po │ │ ├── recipes-common-issues-and-their-solutions.mo │ │ ├── recipes-common-issues-and-their-solutions.po │ │ ├── recipes-drawing-and-graphics.mo │ │ ├── recipes-drawing-and-graphics.po │ │ ├── recipes-images.mo │ │ ├── recipes-images.po │ │ ├── recipes-journalling.mo │ │ ├── recipes-journalling.po │ │ ├── recipes-low-level-interfaces.mo │ │ ├── recipes-low-level-interfaces.po │ │ ├── recipes-multiprocessing.mo │ │ ├── recipes-multiprocessing.po │ │ ├── recipes-ocr.mo │ │ ├── recipes-ocr.po │ │ ├── recipes-optional-content.mo │ │ ├── recipes-optional-content.po │ │ ├── recipes-stories.mo │ │ ├── recipes-stories.po │ │ ├── recipes-text.mo │ │ ├── recipes-text.po │ │ ├── recipes.mo │ │ ├── recipes.po │ │ ├── rect.mo │ │ ├── rect.po │ │ ├── resources.mo │ │ ├── resources.po │ │ ├── shape.mo │ │ ├── shape.po │ │ ├── story-class.mo │ │ ├── story-class.po │ │ ├── supported-files-table.mo │ │ ├── supported-files-table.po │ │ ├── textpage.mo │ │ ├── textpage.po │ │ ├── textwriter.mo │ │ ├── textwriter.po │ │ ├── the-basics.mo │ │ ├── the-basics.po │ │ ├── tools.mo │ │ ├── tools.po │ │ ├── tutorial.mo │ │ ├── tutorial.po │ │ ├── vars.mo │ │ ├── vars.po │ │ ├── version.mo │ │ ├── version.po │ │ ├── widget.mo │ │ ├── widget.po │ │ ├── xml-class.mo │ │ ├── xml-class.po │ │ ├── znames.mo │ │ └── znames.po │ ├── lowlevel.rst │ ├── matrix.rst │ ├── module.rst │ ├── ocr/ │ │ └── tesseract-language-packs.rst │ ├── outline.rst │ ├── packaging.rst │ ├── page.rst │ ├── pixmap.rst │ ├── point.rst │ ├── pymupdf-pro/ │ │ └── index.rst │ ├── pymupdf4llm/ │ │ ├── api.rst │ │ ├── index.rst │ │ └── ocr-plugins.rst │ ├── pyodide.rst │ ├── quad.rst │ ├── rag.rst │ ├── recipes-annotations.rst │ ├── recipes-common-issues-and-their-solutions.rst │ ├── recipes-drawing-and-graphics.rst │ ├── recipes-images.rst │ ├── recipes-journalling.rst │ ├── recipes-low-level-interfaces.rst │ ├── recipes-multiprocessing.rst │ ├── recipes-ocr.rst │ ├── recipes-optional-content.rst │ ├── recipes-stories.rst │ ├── recipes-text.rst │ ├── recipes.rst │ ├── rect.rst │ ├── requirements.txt │ ├── resources.rst │ ├── samples/ │ │ ├── annotations-freetext1.py │ │ ├── annotations-freetext2.py │ │ ├── annotations-ink.py │ │ ├── code-printer.py │ │ ├── filmfestival-sql.py │ │ ├── json-example.py │ │ ├── multiprocess-gui.py │ │ ├── multiprocess-render.py │ │ ├── national-capitals.py │ │ ├── new-annots.py │ │ ├── quickfox-image-no-go.py │ │ ├── quickfox.py │ │ ├── showpdf-page.py │ │ ├── simple-grid.py │ │ ├── story-write-stabilized-links.py │ │ ├── story-write-stabilized.py │ │ ├── story-write.py │ │ ├── table01.py │ │ └── text-lister.py │ ├── shape.rst │ ├── story-class.rst │ ├── supported-files-table.rst │ ├── textpage.rst │ ├── textwriter.rst │ ├── the-basics.rst │ ├── tools.rst │ ├── tutorial.rst │ ├── vars.rst │ ├── version.rst │ ├── widget.rst │ ├── xml-class.rst │ └── znames.rst ├── pyproject.toml ├── pytest.ini ├── scripts/ │ ├── gh_release.py │ ├── sysinstall.py │ └── test.py ├── setup.py ├── src/ │ ├── __init__.py │ ├── __main__.py │ ├── _apply_pages.py │ ├── _wxcolors.py │ ├── extra.i │ ├── fitz___init__.py │ ├── fitz_table.py │ ├── fitz_utils.py │ ├── pipcl.py │ ├── pymupdf.py │ ├── table.py │ ├── utils.py │ └── wdev.py ├── src_classic/ │ ├── __init__.py │ ├── __main__.py │ ├── _config.h │ ├── fitz_old.i │ ├── helper-annot.i │ ├── helper-convert.i │ ├── helper-defines.i │ ├── helper-devices.i │ ├── helper-fields.i │ ├── helper-fileobj.i │ ├── helper-geo-c.i │ ├── helper-geo-py.i │ ├── helper-globals.i │ ├── helper-other.i │ ├── helper-pdfinfo.i │ ├── helper-pixmap.i │ ├── helper-portfolio.i │ ├── helper-python.i │ ├── helper-select.i │ ├── helper-stext.i │ ├── helper-xobject.i │ ├── utils.py │ └── version.i ├── tests/ │ ├── README.md │ ├── conftest.py │ ├── gentle_compare.py │ ├── resources/ │ │ ├── Bezier.epub │ │ ├── PragmaticaC.otf │ │ ├── chinese-tables.pickle │ │ ├── cython.pickle │ │ ├── full_toc.txt │ │ ├── metadata.txt │ │ ├── simple_toc.txt │ │ ├── symbols.txt │ │ ├── test_2608_expected │ │ ├── test_2608_expected_1.26 │ │ ├── test_2608_expected_1.28 │ │ ├── test_3493.epub │ │ ├── test_3615.epub │ │ ├── test_3654.docx │ │ ├── test_3687-3.epub │ │ ├── test_3687.epub │ │ ├── test_3842_expected_1.28.txt │ │ ├── test_3842_partial.txt │ │ ├── test_4496.hwpx │ │ ├── test_open2.cbz │ │ ├── test_open2.doc │ │ ├── test_open2.docx │ │ ├── test_open2.epub │ │ ├── test_open2.fb2 │ │ ├── test_open2.html │ │ ├── test_open2.mobi │ │ ├── test_open2.xhtml │ │ ├── test_open2.xml │ │ ├── test_open2.xps │ │ └── test_open2_expected.json │ ├── run_compound.py │ ├── test_2548.py │ ├── test_2634.py │ ├── test_2904.py │ ├── test_2907.py │ ├── test_4141.py │ ├── test_4503.py │ ├── test_4505.py │ ├── test_4520.py │ ├── test_4614.py │ ├── test_4716.py │ ├── test_4767.py │ ├── test_4942.py │ ├── test_annots.py │ ├── test_badfonts.py │ ├── test_balance_count.py │ ├── test_barcode.py │ ├── test_clip_page.py │ ├── test_cluster_drawings.py │ ├── test_codespell.py │ ├── test_crypting.py │ ├── test_docs_samples.py │ ├── test_drawings.py │ ├── test_embeddedfiles.py │ ├── test_extractimage.py │ ├── test_flake8.py │ ├── test_font.py │ ├── test_general.py │ ├── test_geometry.py │ ├── test_imagebbox.py │ ├── test_imagemasks.py │ ├── test_import.py │ ├── test_insertimage.py │ ├── test_insertpdf.py │ ├── test_linebreaks.py │ ├── test_linequad.py │ ├── test_memory.py │ ├── test_metadata.py │ ├── test_mupdf_regressions.py │ ├── test_named_links.py │ ├── test_nonpdf.py │ ├── test_object_manipulation.py │ ├── test_objectstreams.py │ ├── test_optional_content.py │ ├── test_page_links.py │ ├── test_pagedelete.py │ ├── test_pagelabels.py │ ├── test_pixmap.py │ ├── test_pylint.py │ ├── test_release.py │ ├── test_remove-rotation.py │ ├── test_rewrite_images.py │ ├── test_rtl.py │ ├── test_showpdfpage.py │ ├── test_spikes.py │ ├── test_story.py │ ├── test_tables.py │ ├── test_tesseract.py │ ├── test_textbox.py │ ├── test_textextract.py │ ├── test_textsearch.py │ ├── test_threads.py │ ├── test_toc.py │ ├── test_typing.py │ ├── test_widgets.py │ ├── test_word_delimiters.py │ └── util.py └── valgrind.supp ================================================ FILE CONTENTS ================================================ ================================================ FILE: .gitattributes ================================================ *.pdf binary ================================================ FILE: .github/ISSUE_TEMPLATE/bug_report.yml ================================================ name: Bug Report description: Create a bug report for PyMuPDF # We omit `title: "..."` so that the field defaults to blank. If we set it to # empty string, Github seems to reject this .yml file. body: - type: textarea id: description attributes: label: Description of the bug description: | A clear and concise description of the bug. validations: required: true - type: textarea id: reproduce attributes: label: How to reproduce the bug # Should not word-wrap this description here. description: | * Explain the steps required to reproduce the bug. * Include required code snippets, example files, etc. * Describe what you expected to happen (if not obvious). * If applicable, add screenshots to help explain the problem. * Include any other information that could be relevant, for example information about the Python environment. For problems when building or installing PyMuPDF: * Give the **exact** build/install commands that were run. * Give the **complete** output from these commands. validations: required: true # - type: markdown # attributes: # value: | # # The information below is required. - type: dropdown id: version attributes: label: PyMuPDF version options: - 1.27.2.3 - 1.27.2.2 - 1.27.2 - 1.27.1 - 1.27.0 - 1.26.x or earlier - Built from source description: | * For example from `pymupdf.pymupdf_version`. * We generally only look at bugs in the most recent release of PyMuPDF. validations: required: true - type: dropdown id: os_name attributes: label: Operating system #multiple: true options: - - Windows - Linux - MacOS - OpenBSD - Other validations: required: true - type: dropdown id: python_version attributes: label: Python version #multiple: true # Need quotes around `3.10` otherwise it is treated as a number and shows as `3.1`. options: - - "3.14" - "3.13" - "3.12" - "3.11" - "3.10" - "3.9" validations: required: true ================================================ FILE: .github/ISSUE_TEMPLATE/feature_request.md ================================================ --- name: Feature request about: Suggest an idea for this project title: '' labels: enhancement assignees: --- **Is your feature request related to a problem? Please describe.** A clear and concise description of what the problem is. Potentially add an issue reference. **Describe the solution you'd like** A clear and concise description of what you want to happen. **Describe alternatives you've considered** Are there several options for how your request could be met? **Additional context** Add any other context or screenshots about the feature request here. ================================================ FILE: .github/workflows/build_wheels.yml ================================================ name: Build wheels on: workflow_dispatch: inputs: flavours: description: 'If set, we build separate PyMuPDF and PyMuPDFb wheels.' type: boolean default: false sdist: type: boolean default: true wheels_linux_aarch64: type: boolean default: true wheels_linux_auto: type: boolean default: true wheels_linux_pyodide: type: boolean default: false wheels_windows_auto: type: boolean default: true wheels_macos_auto: type: boolean default: true wheels_cps: description: 'wheels_cps: sets $CIBW_BUILD, E.g. "cp310* cp311*".' type: string PYMUPDF_SETUP_MUPDF_BUILD: description: 'Value for PYMUPDF_SETUP_MUPDF_BUILD, e.g.: git:--branch master https://github.com/ArtifexSoftware/mupdf.git' type: string default: '-' #PYMUPDF_SETUP_MUPDF_BUILD_TYPE: # description: 'Value for PYMUPDF_SETUP_MUPDF_BUILD, e.g. debug.' # type: string # default: '-' # We can't currently have more than 10 inputs PYMUPDF_SETUP_PY_LIMITED_API: description: 'If not "0", we build a single wheel for each platform.' type: string default: '' jobs: build_sdist: if: ${{ inputs.sdist }} name: Build sdist runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Build sdist env: inputs_wheels_default: 0 inputs_sdist: 1 inputs_flavours: ${{inputs.flavours}} inputs_PYMUPDF_SETUP_MUPDF_BUILD: ${{inputs.PYMUPDF_SETUP_MUPDF_BUILD}} run: python scripts/gh_release.py - uses: actions/upload-artifact@v4 with: name: sdist-${{ matrix.os }} path: dist/*.tar.gz build_wheels: #if: ${{ inputs.wheels }} name: Build wheels on ${{ matrix.os }} runs-on: ${{ matrix.os }} strategy: matrix: # 2024-05-08: Need to specify macos-15-intel/14 to get x86_64/arm64. os: [ubuntu-latest, windows-2019, macos-15-intel, macos-14] # Avoid cancelling of all cibuildwheel runs after a single failure. fail-fast: false steps: - uses: actions/checkout@v4 # Get Python 3.12 x32 and x64 on Windows. (As of 2023-10-12 these are not # always available by default.) # - name: Install Python 3.12 x32 on Windows. if: runner.os == 'Windows' uses: actions/setup-python@v5 with: python-version: '3.12' architecture: x86 - name: Install Python 3.12 x64 on Windows. if: runner.os == 'Windows' uses: actions/setup-python@v5 with: python-version: '3.12' # Get Python for running cibuildwheel. This also ensures that 'python' # works on MacOS, where it seems only 'python3' is available by default. # # Note that it seem to be important on MacOS not to specify a # Python version here with `python-version: '3.12'` - this makes # `python-config3` return settings for Python-3.12, instead of for # whatever Python is being used by cibuildwheel. # - uses: actions/setup-python@v5 # On Linux, get qemu so we can build for aarch64. # - name: Set up QEMU if: runner.os == 'Linux' uses: docker/setup-qemu-action@v1 with: platforms: all - name: gh_release # Doesn't seem to be a way to passing inputs.* on command # line, so we set environment instead. E.g. see: # https://github.com/orgs/community/discussions/27088 # env: inputs_flavours: ${{inputs.flavours}} inputs_sdist: ${{inputs.sdist}} inputs_wheels_linux_aarch64: ${{inputs.wheels_linux_aarch64}} inputs_wheels_linux_auto: ${{inputs.wheels_linux_auto}} inputs_wheels_linux_pyodide: ${{inputs.wheels_linux_pyodide}} #inputs_wheels_macos_arm64: ${{inputs.wheels_macos_arm64}} inputs_wheels_macos_auto: ${{inputs.wheels_macos_auto}} inputs_wheels_windows_auto: ${{inputs.wheels_windows_auto}} inputs_PYMUPDF_SETUP_MUPDF_BUILD: ${{inputs.PYMUPDF_SETUP_MUPDF_BUILD}} #inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE: ${{inputs.PYMUPDF_SETUP_MUPDF_BUILD_TYPE}} inputs_wheels_cps: ${{inputs.wheels_cps}} PYMUPDF_SETUP_PY_LIMITED_API: ${{inputs.PYMUPDF_SETUP_PY_LIMITED_API}} run: python scripts/gh_release.py # Upload generated wheels, to be accessible from github Actions page. # - uses: actions/upload-artifact@v4 with: name: wheels-${{ matrix.os }} path: ./wheelhouse/*.whl ================================================ FILE: .github/workflows/cla.yml ================================================ name: "CLA Assistant" on: pull_request_target: types: [opened,closed,synchronize] jobs: CLAAssistant: runs-on: ubuntu-latest steps: - name: "CLA Assistant" if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I have read the CLA Document and I hereby sign the CLA') || github.event_name == 'pull_request_target' # Beta Release uses: contributor-assistant/github-action@v2.4.0 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # the below token should have repo scope and must be manually added by you in the repository's secret PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }} with: path-to-signatures: 'signatures/version1/cla.json' path-to-document: 'https://artifex.com/documents/Artifex%20Contributor%20License%20Agreement.pdf' # branch should not be protected branch: 'CLA' allowlist: # the following are the optional inputs - If the optional inputs are not given, then default values will be taken #remote-organization-name: enter the remote organization name where the signatures should be stored (Default is storing the signatures in the same repository) #remote-repository-name: enter the remote repository name where the signatures should be stored (Default is storing the signatures in the same repository) #create-file-commit-message: 'For example: Creating file for storing CLA Signatures' #signed-commit-message: 'For example: $contributorName has signed the CLA in #$pullRequestNo' #custom-notsigned-prcomment: 'pull request comment with Introductory message to ask new contributors to sign' #custom-pr-sign-comment: 'The signature to be committed in order to sign the CLA' #custom-allsigned-prcomment: 'pull request comment when all contributors has signed, defaults to **CLA Assistant Lite bot** All Contributors have signed the CLA.' #lock-pullrequest-aftermerge: false - if you don't want this bot to automatically lock the pull request after merging (default - true) #use-dco-flag: true - If you are using DCO instead of CLA ================================================ FILE: .github/workflows/test-valgrind.yml ================================================ name: Test valgrind on: workflow_dispatch: schedule: - cron: '13 6 * * *' jobs: valgrind: name: valgrind runs-on: ubuntu-latest strategy: matrix: args: [ '', '-m "git:--branch master https://github.com/ArtifexSoftware/mupdf"', '-m "git:--branch 1.27.x https://github.com/ArtifexSoftware/mupdf"', ] fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 - name: valgrind run: python scripts/test.py ${{matrix.args}} -P 1 -T valgrind build test ================================================ FILE: .github/workflows/test.yml ================================================ # Run scripts/test.py directly on multiple Github servers. Instead of # specifying individual inputs, we support a single string input which is used # for the command line directly. # # This ensures we behave exactly like scripts/test.py, without confusion caused # by having to translate between differing APIs. name: Tests on: #schedule: # - cron: '47 4 * * *' #pull_request: # branches: [main] workflow_dispatch: inputs: args: type: string default: '' description: 'Arguments to pass to scripts/test.py' jobs: test: name: Test runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest, windows-2022, macos-15-intel, macos-14] # Avoid cancelling of all runs after a single failure. fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: python-version: '3.12' # https://github.com/pypa/cibuildwheel/issues/2114 # https://cibuildwheel.pypa.io/en/stable/faq/#emulation # - name: Set up QEMU if: runner.os == 'Linux' && runner.arch == 'X64' uses: docker/setup-qemu-action@v3 with: platforms: all - name: test env: PYMUPDF_test_args: ${{inputs.args}} run: python scripts/test.py -a PYMUPDF_test_args # Upload generated wheels, to be accessible from github Actions page. # - uses: actions/upload-artifact@v4 with: path: | wheelhouse/pymupdf*.whl wheelhouse/pymupdf*.tar.gz name: artifact-${{ matrix.os }} ================================================ FILE: .github/workflows/test_multiple.yml ================================================ # Run scripts/test.py on multiple OS's (Windows, Linux, MacOS x64, MacOS arm64) # and with multiple specifications of MuPDF (PyMuPDF's hard-coded default, # master branch, release branch). name: multiple on: workflow_dispatch: inputs: args: type: string default: '' description: 'Additional arguments to scripts/test.py' schedule: - cron: '13 6 * * *' jobs: multiple: name: multiple runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest, windows-2022, macos-15-intel, macos-14] args: [ '', '-m "git:--branch master https://github.com/ArtifexSoftware/mupdf"', '-m "git:--branch 1.27.x https://github.com/ArtifexSoftware/mupdf"', ] fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 - name: multiple env: PYMUPDF_test_args: ${{inputs.args}} run: python scripts/test.py ${{matrix.args}} wheel test -a PYMUPDF_test_args ================================================ FILE: .github/workflows/test_pyodide.yml ================================================ name: Test pyodide # Build and test pyodide wheels using cibuildwheel. on: workflow_dispatch: schedule: - cron: '13 5 * * *' jobs: pyodide: name: pyodide runs-on: ubuntu-latest strategy: matrix: # 2025-09-05: We don't test with default mupdf because mupdf-1.26.7 # does not have the required pyodide rpath changes. args: [ # '', '-m "git:--branch master https://github.com/ArtifexSoftware/mupdf"', '-m "git:--branch 1.27.x https://github.com/ArtifexSoftware/mupdf"', ] fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: python-version: 3.12 - name: pyodide run: python scripts/test.py ${{matrix.args}} --cibw-pyodide 1 cibw # We do not use upload-artifact@v4 because it fails due to us creating # identically-named wheels. #- uses: actions/upload-artifact@v4 # with: # path: ./wheelhouse/*.whl ================================================ FILE: .github/workflows/test_quick.yml ================================================ name: test_quick on: pull_request: branches: [main] workflow_dispatch: inputs: args: type: string default: '' description: 'Additional arguments to scripts/test.py' jobs: master: name: mupdf master runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest] fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 - name: mupdf master env: PYMUPDF_test_args: ${{inputs.args}} run: python scripts/test.py build test -m 'git:--branch master https://github.com/ArtifexSoftware/mupdf.git' -a PYMUPDF_test_args release: name: mupdf release runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest] fail-fast: false steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 - name: mupdf release env: PYMUPDF_test_args: ${{inputs.args}} run: python scripts/test.py build test -m 'git:--branch 1.27.x https://github.com/ArtifexSoftware/mupdf.git' -a PYMUPDF_test_args ================================================ FILE: .github/workflows/test_sysinstall.yml ================================================ name: Test sysinstall on: schedule: - cron: '13 4 * * *' workflow_dispatch: inputs: args: description: 'Extra args for scripts/sysinstall.py.' jobs: sysinstall: name: Test sysinstall runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest] steps: - uses: actions/checkout@v4 # It seems to be important not to install a custom python here, # because `sudo` (which we need to use when installing to /usr/local # etc) always ends up running the default python, even if we set # $PATH etc. So for example we can end up with mupdf files and # pymupdf files being installed into .../python3.11/site-packages and # .../python3.10/site-packages, and tests all fail to import pymupdf. # #- uses: actions/setup-python@v5 #with: # # 3.12 doesn't have setuptools. As of 2024-01-03, MuPDF build requires setuptools before it # # sees `--venv` and defers to a venv, so we currently have to force use of python 3.11. # python-version: '3.11' - name: sysinstall_venv env: PYMUDF_SCRIPTS_SYSINSTALL_ARGS_POST: ${{inputs.args}} run: # Use venv. python3 scripts/sysinstall.py --mupdf-git '--branch master https://github.com/ArtifexSoftware/mupdf.git' - name: sysinstall_sudo env: PYMUDF_SCRIPTS_SYSINSTALL_ARGS_POST: ${{inputs.args}} run: # Do not use a venv, instead install required packages with sudo. python3 scripts/sysinstall.py --mupdf-git '--branch master https://github.com/ArtifexSoftware/mupdf.git' --pip sudo --root / ================================================ FILE: .gitignore ================================================ *.pyc *.so *.o *.swp build/ demo/README.rst docs/build docs/_build ================================================ FILE: .python-version ================================================ 3.12 ================================================ FILE: .readthedocs.yaml ================================================ # .readthedocs.yaml # Read the Docs configuration file # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details # Required version: 2 # Set the version of Python and other tools you might need build: os: ubuntu-20.04 tools: python: "3.13" # let's use the default Python version provided by Read the Docs # You can also specify other tool versions: # nodejs: "16" # rust: "1.55" # golang: "1.17" # Build documentation in the docs/ directory with Sphinx sphinx: configuration: docs/conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF formats: all # Optionally declare the Python requirements required to build your docs python: install: - requirements: docs/requirements.txt ================================================ FILE: .vs/ProjectSettings.json ================================================ { "CurrentProjectSetting": "" } ================================================ FILE: .vs/VSWorkspaceState.json ================================================ { "ExpandedNodes": [ "" ], "SelectedNode": "", "PreviewInSolutionExplorer": false } ================================================ FILE: COPYING ================================================ GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU Affero General Public License is a free, copyleft license for software and other kinds of works, specifically designed to ensure cooperation with the community in the case of network server software. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, our General Public Licenses are intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. Developers that use our General Public Licenses protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software. A secondary benefit of defending all users' freedom is that improvements made in alternate versions of the program, if they receive widespread use, become available for other developers to incorporate. Many developers of free software are heartened and encouraged by the resulting cooperation. However, in the case of software used on network servers, this result may fail to come about. The GNU General Public License permits making a modified version and letting the public access it on a server without ever releasing its source code to the public. The GNU Affero General Public License is designed specifically to ensure that, in such cases, the modified source code becomes available to the community. It requires the operator of a network server to provide the source code of the modified version running there to the users of that server. Therefore, public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version. An older license, called the Affero General Public License and published by Affero, was designed to accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has released a new version of the Affero GPL which permits relicensing under this license. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU Affero General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Remote Network Interaction; Use with the GNU General Public License. Notwithstanding any other provision of this License, if you modify the Program, your modified version must prominently offer all users interacting with it remotely through a computer network (if your version supports such interaction) an opportunity to receive the Corresponding Source of your version by providing access to the Corresponding Source from a network server at no charge, through some standard or customary means of facilitating copying of software. This Corresponding Source shall include the Corresponding Source for any work covered by version 3 of the GNU General Public License that is incorporated pursuant to the following paragraph. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the work with which it is combined will remain governed by version 3 of the GNU General Public License. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU Affero General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU Affero General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU Affero General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU Affero General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program 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. This program 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 this program. If not, see . Also add information on how to contact you by electronic and paper mail. If your software can interact with users remotely through a computer network, you should also make sure that it provides a way for users to get its source. For example, if your program is a web application, its interface could display a "Source" link that leads users to an archive of the code. There are many ways you could offer source, and different solutions will be better for different programs; see section 13 for the specific requirements. You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU AGPL, see . ================================================ FILE: README.md ================================================

PyMuPDF

# PyMuPDF

pymupdf%2FPyMuPDF | Trendshift

[![Docs](https://img.shields.io/badge/docs-live-brightgreen)](https://pymupdf.readthedocs.io) [![PyPI Version](https://img.shields.io/pypi/v/pymupdf?color=blue&label=PyPI)](https://pypi.org/project/PyMuPDF/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pymupdf)](https://pypi.org/project/pymupdf/) [![License AGPL](https://img.shields.io/github/license/pymupdf/pymupdf)](https://github.com/pymupdf/PyMuPDF/blob/master/COPYING) [![PyPI Downloads](https://static.pepy.tech/badge/pymupdf/month)](https://pepy.tech/projects/pymupdf) [![Github Stars](https://img.shields.io/github/stars/pymupdf/PyMuPDF?style=social)](https://github.com/pymupdf/PyMuPDF/stargazers) [![Discord](https://img.shields.io/discord/770681584617652264?color=6A7EC2&logo=discord&logoColor=ffffff)](https://pymupdf.io/discord/artifex/) [![Forum](https://img.shields.io/badge/Forum-ff6600?logo=python&logoColor=ffffff)](https://forum.mupdf.com/c/general/4) [![Twitter](https://img.shields.io/twitter/follow/pymupdf4llm)](https://x.com/pymupdf4llm) [![Hugging Face](https://img.shields.io/badge/%F0%9F%A4%97_Hugging_Face-007ec6)](https://huggingface.co/artifex-software) [![Demo](https://img.shields.io/badge/PyMuPDF4LLM-live?badge&label=DEMO&logo=python&logoColor=ffffff)](https://demo.pymupdf.io) **The PDF engine behind over 50 million monthly downloads, powering AI pipelines worldwide.** **PyMuPDF is a high-performance Python library for data extraction, analysis, conversion, rendering and manipulation of PDF (and other) documents.** Built on top of MuPDF — a lightweight, fast C engine — PyMuPDF gives you precise, low-level control over documents alongside high-level convenience APIs. No mandatory external dependencies. [![Star on GitHub](https://img.shields.io/github/stars/pymupdf/PyMuPDF.svg?style=for-the-badge&label=Star&logo=github)](https://github.com/pymupdf/PyMuPDF/) --- ## Why PyMuPDF? - **Fast** — powered by [MuPDF](https://mupdf.com/), a best-in-class C rendering engine - **Accurate** — pixel-perfect text extraction with font, color, and position metadata - **Versatile** — read, write, annotate, redact, merge, split, and convert documents - **LLM-ready** — native Markdown output via [PyMuPDF4LLM](https://pypi.org/project/pymupdf4llm/) for RAG and AI pipelines - **No mandatory dependencies** — `pip install pymupdf` and you're done --- ## Installation ```bash pip install pymupdf ``` Wheels are available for **Windows**, **macOS**, and **Linux** on Python 3.10–3.14. If no pre-built wheel exists for your platform, pip will compile from source (requires a C/C++ toolchain). ### Optional extras | Package | Purpose | |---|---| | `pymupdf-fonts` | Extended font collection for text output | | `pymupdf4llm` | LLM/RAG-optimised Markdown and JSON extraction | | `pymupdfpro` | Adds Office document support | | `tesseract-ocr` | OCR for scanned pages and images (separate install) | ```bash # More fonts pip install pymupdf-fonts # LLM-ready extraction pip install pymupdf4llm # Office support pip install pymupdfpro # OCR (Tesseract must be installed separately) # macOS brew install tesseract # Ubuntu / Debian sudo apt install tesseract-ocr ``` --- ## Supported File Formats ### Input | Category | Formats | |---|---| | PDF & derivatives | PDF, XPS, EPUB, CBZ, MOBI, FB2, SVG, TXT | | Images | PNG, JPEG, BMP, TIFF, GIF, and more | | Microsoft Office *(Pro)* | DOC, DOCX, XLS, XLSX, PPT, PPTX | | Korean Office *(Pro)* | HWP, HWPX | ### Output | Format | Notes | |---|---| | PDF | Full fidelity conversion from Office formats | | SVG | Vector page rendering | | Image (PNG, JPEG, …) | Page rasterisation at any DPI | | Markdown | Structure-aware, LLM-ready | | JSON | Bounding boxes, layout data, per-element detail | | Plain text | Fast, lightweight extraction | --- ## Quick start ### Extract text ```python import pymupdf doc = pymupdf.open("document.pdf") for page in doc: print(page.get_text()) ``` ### Extract text with layout metadata ```python import pymupdf doc = pymupdf.open("document.pdf") page = doc[0] blocks = page.get_text("dict")["blocks"] for block in blocks: if block["type"] == 0: # text block for line in block["lines"]: for span in line["spans"]: print(f"{span['text']!r} font={span['font']} size={span['size']:.1f}") ``` ### Extract tables ```python import pymupdf doc = pymupdf.open("spreadsheet.pdf") page = doc[0] tables = page.find_tables() for table in tables: print(table.to_markdown()) # or get as Pandas DataFrame df = table.to_pandas() ``` ### Render a page to an image ```python import pymupdf doc = pymupdf.open("document.pdf") page = doc[0] pixmap = page.get_pixmap(dpi=150) pixmap.save("page_0.png") ``` ### OCR a scanned document ```python import pymupdf doc = pymupdf.open("scanned.pdf") page = doc[0] # Requires Tesseract installed and on PATH text = page.get_textpage_ocr(language="eng").extractText() print(text) ``` ### Convert to Markdown for LLMs ```python import pymupdf4llm md = pymupdf4llm.to_markdown("report.pdf") # Pass directly to your LLM or vector store print(md) ``` ### Annotate and redact ```python import pymupdf doc = pymupdf.open("contract.pdf") page = doc[0] # Add a highlight annotation rect = pymupdf.Rect(72, 100, 400, 120) page.add_highlight_annot(rect) # Add a redaction and apply it page.add_redact_annot(rect) page.apply_redactions() doc.save("contract_redacted.pdf") ``` ### Merge PDFs ```python import pymupdf merger = pymupdf.open() for path in ["part1.pdf", "part2.pdf", "part3.pdf"]: merger.insert_pdf(pymupdf.open(path)) merger.save("merged.pdf") ``` ### Convert an Office document to PDF ```python import pymupdf.pro pymupdf.pro.unlock("YOUR-LICENSE-KEY") doc = pymupdf.open("presentation.pptx") pdf_bytes = doc.convert_to_pdf() with open("output.pdf", "wb") as f: f.write(pdf_bytes) ``` ### Extract LLM-ready Markdown from a Word document ```python import pymupdf4llm import pymupdf.pro pymupdf.pro.unlock("YOUR-LICENSE-KEY") md = pymupdf4llm.to_markdown("document.docx") print(md) ``` --- ## Features ### Core capabilities | Feature | Description | |---|---| | **Text extraction** | Plain text, rich dict (font, size, color, bbox), HTML, XML, raw blocks | | **Table detection** | `find_tables()` — locate, extract, and export tables as Markdown or structured data | | **Image extraction** | Extract embedded images and render any page to a high-resolution `Pixmap` | | **Rendering** | Render PDF pages to images or `Pixmap` data for use in UI or other workflows | | **OCR** | Tesseract integration — full-page or partial OCR, configurable language | | **Annotations** | Read and write highlights, underlines, squiggly lines, sticky notes, free text, ink, stamps | | **Redaction** | Add and permanently apply redaction annotations | | **Forms** | Read and fill PDF AcroForm fields | | **PDF editing** | Insert, delete, and reorder pages; set metadata; merge and split documents | | **Drawing** | Draw lines, curves, rectangles, and circles; insert HTML boxes | | **Encryption** | Open password-protected PDFs; save with RC4 or AES encryption | | **Links** | Extract hyperlinks, internal cross-references, and URI targets | | **Bookmarks** | Read and write the outline / table of contents tree | | **Metadata** | Title, author, creation date, producer, subject, and custom entries | | **Color spaces** | RGB, CMYK, greyscale; color space conversion | ### LLM & AI output (via PyMuPDF4LLM) | Output | API | |---|---| | Markdown | `pymupdf4llm.to_markdown(path)` | | JSON | `pymupdf4llm.to_json(path)` | | Plain text | `pymupdf4llm.to_text(path)` | Supports multi-column layouts, natural reading order and page chunking. [![Demo](https://img.shields.io/badge/Pymupdf4llm-live?style=for-the-badge&label=DEMO&logo=python&logoColor=ffffff)](https://demo.pymupdf.io) --- ## Supported Python versions Python **3.10 – 3.14** (as of v1.27.x). Wheels ship for: - `manylinux` x86\_64 and aarch64 - `musllinux` x86\_64 - macOS x86\_64 and arm64 - Windows x86 and x86\_64 --- ## Performance PyMuPDF is built on MuPDF — one of the fastest PDF rendering engines available. Typical benchmarks against pure-Python PDF libraries show **10–50× speed improvements** for text extraction and **100× or more** for page rendering, with a minimal memory footprint. For AI workloads, PyMuPDF4LLM processes documents **without a GPU**, cutting infrastructure costs significantly compared to vision-based LLM approaches. --- ## Recipes
Extract all images from a PDF ```python import pymupdf from pathlib import Path doc = pymupdf.open("document.pdf") out = Path("images") out.mkdir(exist_ok=True) for page_index, page in enumerate(doc): for img_index, img in enumerate(page.get_images()): xref = img[0] pix = pymupdf.Pixmap(doc, xref) if pix.n > 4: # convert CMYK pix = pymupdf.Pixmap(pymupdf.csRGB, pix) pix.save(out / f"page{page_index}_img{img_index}.png") ```
Search for text across a document ```python import pymupdf doc = pymupdf.open("document.pdf") needle = "confidential" for page in doc: hits = page.search_for(needle) if hits: print(f"Page {page.number}: {len(hits)} occurrence(s)") for rect in hits: page.add_highlight_annot(rect) doc.save("highlighted.pdf") ```
Split a PDF into individual pages ```python import pymupdf doc = pymupdf.open("document.pdf") for i, page in enumerate(doc): out = pymupdf.open() out.insert_pdf(doc, from_page=i, to_page=i) out.save(f"page_{i + 1}.pdf") ```
Insert a watermark on every page ```python import pymupdf doc = pymupdf.open("document.pdf") for page in doc: page.insert_text( point=pymupdf.Point(72, page.rect.height / 2), text="DRAFT", fontsize=72, color=(0.8, 0.8, 0.8), rotate=45, ) doc.save("watermarked.pdf") ```
--- ## Office Document Processing PyMuPDF can be extended with PyMuPDF Pro. This adds a conversion layer that handles Microsoft and Korean Office formats natively — no Office installation, no COM interop, no LibreOffice subprocess. Once unlocked, `pymupdf.open()` accepts Office files exactly like PDFs: ```python import pymupdf.pro pymupdf.pro.unlock("YOUR-LICENSE-KEY") # Works identically regardless of format for fmt in ["contract.docx", "data.xlsx", "deck.pptx", "report.hwpx"]: doc = pymupdf.open(fmt) for page in doc: print(page.get_text()) ``` [Get a trial license key for PyMuPDF Pro](https://pymupdf.pro/try-pro) **What you can do with Office documents:** - Extract text and images page-by-page - Convert to PDF with `doc.convert_to_pdf()` - Rasterise pages to PNG/JPEG for visual inspection - Feed directly into PyMuPDF4LLM for AI-ready output ### Restrictions Without a License Key When `pymupdf.pro.unlock()` is called **without** a key, the following restrictions apply: | Restriction | Detail | |---|---| | Page limit | Only the **first 3 pages** of any document are accessible | | Time limit | Evaluation period — functionality expires after a set duration | All other Pro features work normally within these constraints, making it straightforward to prototype before purchasing a license. --- ## Frequently Asked Questions ### Can I use PyMuPDF, PyMuPDF4LLM and PyMuPDF Pro without sending data to the cloud? Yes, absolutely — and this is one of PyMuPDF's most significant advantages. PyMuPDF runs entirely locally. It is a native Python library built on top of the MuPDF C engine. When you call `pymupdf.open()`, `page.get_text()`, `page.find_tables()`, or any other method, everything executes in-process on your own machine. No data is transmitted anywhere. There are no telemetry calls, no licence validation callbacks, no cloud dependencies of any kind in the open-source AGPL build or the commercial build. Once the package is installed, it works fully air-gapped. This makes PyMuPDF well-suited for: - Regulated industries — healthcare (HIPAA), finance, legal, government, where documents cannot leave a controlled environment - On-premise deployments — servers with no outbound internet access - Air-gapped systems — classified or sensitive environments - Self-hosted RAG pipelines — processing confidential documents locally before feeding an on-premise LLM - Saving on token costs for document pre-processing before sending data to your LLM The only thing you need an internet connection for is the initial `pip install`. After that, the package and all its capabilities are entirely self-contained. ### Should I `import pymupdf` or `import fitz`? Use `import pymupdf`. The `fitz` name is a legacy alias that still works as of v1.24.0+, but `import pymupdf` is the recommended and future-proof approach. The two are interchangeable in existing code: ```python import pymupdf # recommended # import fitz # legacy alias — still works but avoid for new code ``` ### Does PyMuPDF work with Korean, Japanese, or Chinese documents? Yes — PyMuPDF has solid CJK support ### How do I extract Markdown from PDF for LLM? Let PyMuPDF4LLM do everything (recommended for RAG). PyMuPDF4LLM is a high-level wrapper that outputs standard text and table content together in an integrated Markdown-formatted string across all document pages PyMuPDF — tables are detected, converted to GitHub-compatible Markdown, and interleaved with surrounding text in the correct reading order. This is the best starting point for feeding an LLM or building a RAG pipeline. ```python import pymupdf4llm md = pymupdf4llm.to_markdown("report.pdf") print(md) # Tables appear as Markdown | col1 | col2 | ... inline with the text ``` ### Text extraction returns garbled characters or empty output. Why? This usually means the PDF uses custom font encodings without a proper character map (CMAP). The font's glyphs are present but cannot be mapped back to Unicode. In these cases: - Use OCR as a fallback (`page.get_textpage_ocr()`) - Consider that scanned PDFs will always need OCR — text extraction on scans returns nothing ### How do I extract text from a specific area of a page? Pass a `clip` rectangle to `get_text()`: ```python import pymupdf doc = pymupdf.open("input.pdf") page = doc[0] # Define the area you want (x0, y0, x1, y1) in points clip = pymupdf.Rect(50, 100, 400, 300) text = page.get_text("text", clip=clip) ``` ### How do I search for text and find its location on the page? ```python import pymupdf doc = pymupdf.open("input.pdf") page = doc[0] # Returns a list of Rect objects surrounding each match locations = page.search_for("invoice number") for rect in locations: print(rect) # e.g. Rect(72.0, 120.5, 210.0, 134.0) ``` ### `get_images` shows no images but I can clearly see charts in the PDF. Why? Charts and diagrams created by tools like matplotlib, Excel, or R are typically rendered as vector graphics (PDF drawing commands), not raster images. `get_images` only lists embedded raster image objects and will not detect vector graphics. To capture these, rasterise the entire page with `page.get_pixmap()`. ### How does OCR work in PyMuPDF? Does it require a separate Tesseract installation? PyMuPDF uses MuPDF's built-in Tesseract-based OCR support, so there is no Python-level `pytesseract` dependency. However, PyMuPDF still needs access to the **Tesseract language data files** (`tessdata`), and automatic tessdata discovery may invoke the `tesseract` executable (for example, to list available languages) if you do not explicitly provide a tessdata path. In practice, the recommended setup is to either install Tesseract so discovery works automatically, or configure the tessdata location yourself via the `tessdata` parameter or the `TESSDATA_PREFIX` environment variable. Over 100 languages are supported. ```python import pymupdf doc = pymupdf.open("scanned.pdf") page = doc[0] # Get a text page using OCR tp = page.get_textpage_ocr(language="eng") text = page.get_text(textpage=tp) print(text) ``` ### How do I run OCR on a standalone image file (not a PDF)? ```python import pymupdf pix = pymupdf.Pixmap("image.png") if pix.alpha: pix = pymupdf.Pixmap(pix, 0) # remove alpha channel — required for OCR # Wrap in a 1-page PDF and OCR it doc = pymupdf.open() page = doc.new_page(width=pix.width, height=pix.height) page.insert_image(page.rect, pixmap=pix) tp = page.get_textpage_ocr() text = page.get_text(textpage=tp) ``` ### How do I highlight text in a PDF? ```python import pymupdf doc = pymupdf.open("input.pdf") page = doc[0] # Use quads=True for accurate highlights on non-horizontal text quads = page.search_for("important term", quads=True) page.add_highlight_annot(quads) doc.save("highlighted.pdf") ``` PyMuPDF supports all standard PDF text markers: highlight, underline, strikeout, and squiggly. ### How do I permanently redact (remove) content from a PDF? Redaction is a deliberate two-step process so you can review before committing: ```python import pymupdf doc = pymupdf.open("input.pdf") page = doc[0] # Step 1: Mark the area(s) to redact rect = page.search_for("confidential")[0] page.add_redact_annot(rect, fill=(1, 1, 1)) # white fill # Step 2: Apply — permanently removes the underlying content page.apply_redactions() doc.save("redacted.pdf") ``` After `apply_redactions()`, the original content is gone. It cannot be recovered from the saved file. ### How do I read form field values from a PDF? ```python import pymupdf doc = pymupdf.open("form.pdf") page = doc[0] for field in page.widgets(): print(f"{field.field_name}: {field.field_value}") ``` ### How do I fill in a PDF form programmatically? ```python import pymupdf doc = pymupdf.open("form.pdf") page = doc[0] for field in page.widgets(): if field.field_name == "First Name": field.field_value = "Ada" field.update() doc.save("filled_form.pdf") ``` ### Can I use multithreading with PyMuPDF? No. PyMuPDF does not support multithreaded use, even with Python's newer free-threading mode. The underlying MuPDF library only provides partial thread safety, and a fully thread-safe PyMuPDF implementation would still impose a single-threaded overhead — negating the benefit. **Use multiprocessing instead.** Each process opens the file independently and works on its own page range: ```python from multiprocessing import Pool import pymupdf def process_pages(args): path, start, end = args doc = pymupdf.open(path) # each process opens its own handle results = [] for i in range(start, end): results.append(doc[i].get_text()) return results with Pool(4) as pool: chunks = [("input.pdf", 0, 25), ("input.pdf", 25, 50), ...] all_results = pool.map(process_pages, chunks) ``` ### How can I speed up repeated text extraction on the same page? Reuse a `TextPage` object. Creating a `TextPage` is the expensive part — once created, switching between extraction formats is cheap: ```python import pymupdf page = doc[0] tp = page.get_textpage() # create once text = page.get_text("text", textpage=tp) words = page.get_text("words", textpage=tp) data = page.get_text("dict", textpage=tp) ``` This can reduce execution time by 50–95% for repeated extractions on the same page. ### How do I read and write PDF metadata? ```python import pymupdf doc = pymupdf.open("input.pdf") # Read print(doc.metadata) # {'title': '...', 'author': '...', 'subject': '...', 'keywords': '...', ...} # Write doc.set_metadata({ "title": "Annual Report 2025", "author": "Finance Team", "keywords": "annual, finance, 2025" }) doc.save("output.pdf") ``` ### How do I read or set the table of contents / bookmarks? ```python import pymupdf doc = pymupdf.open("input.pdf") # Read — returns a list of [level, title, page_number] entries toc = doc.get_toc() for level, title, page in toc: print(" " * level, title, "→ page", page) # Write new_toc = [ [1, "Introduction", 1], [1, "Methods", 5], [2, "Data sources", 6], ] doc.set_toc(new_toc) doc.save("output.pdf") ``` --- ## Documentation Full installation guide, API reference, cookbook, and tutorial at **[pymupdf.readthedocs.io](https://pymupdf.readthedocs.io)**. - [Installation guide](https://pymupdf.readthedocs.io/en/latest/installation.html) - [API reference](https://pymupdf.readthedocs.io/en/latest/classes.html) - [Cookbook](https://pymupdf.readthedocs.io/en/latest/the-basics.html) - [Tutorial](https://pymupdf.readthedocs.io/en/latest/tutorial.html) - [Changelog](https://pymupdf.readthedocs.io/en/latest/changes.html) - [PyMuPDF4LLM docs](https://pymupdf.readthedocs.io/en/latest/pymupdf4llm/) - [PyMuPDF Pro docs](https://pymupdf.readthedocs.io/en/latest/pymupdf-pro/index.html) --- ## Related projects | Project | Description | |---|---| | [PyMuPDF4LLM](https://github.com/pymupdf/pymupdf4llm) | LLM/RAG-optimised Markdown and JSON extraction | | [PyMuPDF Pro](https://pymupdf.io/pro) | Adds Office and HWP document support | | [pymupdf-fonts](https://pypi.org/project/pymupdf-fonts/) | Extended font collection for PyMuPDF text output | --- ## Licensing PyMuPDF and MuPDF are maintained by [Artifex Software, Inc.](https://artifex.com) - **Open source** — [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html). Free for open-source projects. - **Commercial** — separate commercial licences available from [Artifex](https://artifex.com/licensing) for proprietary applications. --- ## Contributing Contributions are welcome. Please open an issue before submitting large pull requests. - [Issue tracker](https://github.com/pymupdf/PyMuPDF/issues) - [Discord community](https://pymupdf.pro/discord/artifex/) ## ⭐ Support this project If you find this useful, please consider giving it a star — it helps others discover it! [![Star on GitHub](https://img.shields.io/github/stars/pymupdf/PyMuPDF.svg?style=for-the-badge&label=Star&logo=github)](https://github.com/pymupdf/PyMuPDF/) ================================================ FILE: READMEb.md ================================================ # PyMuPDFb This wheel contains [MuPDF](https://mupdf.readthedocs.io/) shared libraries for use by [PyMuPDF](https://pymupdf.readthedocs.io/). This wheel is shared by PyMuPDF wheels that are specific to different Python versions, significantly reducing the total size of a release. ================================================ FILE: READMEd.md ================================================ # PyMuPDFd This wheel contains [MuPDF](https://mupdf.readthedocs.io/) build-time files that were used to build [PyMuPDF](https://pymupdf.readthedocs.io/). ================================================ FILE: changes.txt ================================================ Change Log ========== **Changes in version 1.27.2.3** (2026-04-24) * Fixed issues: * **Fixed** `4928 `_: pymupdf.Document.scrub raises AttributeError for a document with annotations * **Fixed** `4942 `_: bug: IndexError for Page.get_links after Page.clip_to_rect * **Fixed** `4954 `_: get_drawings() returns incorrect lineJoin and width * **Fixed** `4958 `_: bug: inserting rotated pages to another document messes up link coordinates * Other: * Fixed incorrect generation of `lineJoin j` in PDF content, introduced in 1.27.2.2. * Allow build to (incorrectly) claim to be thread-safe, for #4760. See setup.py for details. * Use pypi.org's pipcl package instead of our own pipcl.py file. **Changes in version 1.27.2.2** (2026-03-20) * Fixed issues: * **Fixed** `4902 `_: Incorrect linewidth in elements returned by Page.get_texttrace() * **Fixed** `4932 `_: "Page" has no attribute "find_tables" in PyMuPDF 1.27 * Other: * Added `Annot.__bool__()`. **Changes in version 1.27.2.** (2026-03-10) * Use MuPDF-1.27.2. * Fixed issues: * **Fixed** `4903 `_: Typing broken because of `*_forward_decl` * Other: * Retrospectively marked #4907 as fixed in pymupdf-1.27.1. * Improved `get_textpage_ocr()`. For partial OCR, **all** page areas outside legible text are now OCRed, not just those within images. This means that OCR will now also be performed for vector graphics, and for text containing illegible characters. * Provide a Linux wheel for free-threading python, specifically cp314-cp314t-manylinux_2_28_x86_64. **Changes in version 1.27.1** (2026-02-11) * Use MuPDF-1.27.1. * Fixed issues: * **Fixed** `4599 `_: page.cluster_drawings extract a lot of small clusters once upgraded to 1.26 * **Fixed** `4751 `_: Memory leaking in page.widgets() * **Fixed** `4762 `_: Importing pymupdf make pillow segmentation fault for converting jp2 file on ArchLinux * **Fixed** `4790 `_: Problem to delete pages on PDF * **Fixed** `4857 `_: Package is missing py.typed file required for type checking * **Fixed** `4886 `_: width attribute behaviour seems wrong * **Fixed** `4907 `_: signal 11:SIGSEGV while using display_list.get_textpage() * Other: * Added `pymupdf.TEXT_CLIP`. * Removed support for mupdf < 1.26. * New arg `raise_on_repair` in `Document.save()`. * New method `Document.repair()`. **Changes in version 1.26.7** (2025-12-11) * Use MuPDF-1.26.12. * **Fixed** `4801 `_: Build failure dumping all environment variables Other: * Retrospectively mark `4756 `_ as fixed in 1.26.6. * Improved safety of `pymupdf embed-extract`. This now refuses to write to an existing file or outside current directory, unless `-output` or new flag `-unsafe` is specified. **Changes in version 1.26.6** (2025-11-05) * Use MuPDF-1.26.11. * Supported Python versions are now 3.10-3.14. * Fixed issues: * **Fixed** `4699 `_: cannot find ExtGState resource * **Fixed** `4712 `_: Crash with "corrupted double-linked list" * **Fixed** `4720 `_: Memory leaking in rewrite_images? * **Fixed** `4742 `_: 'Rect' object has no attribute 'get_area' * **Fixed** `4746 `_: Document.__init__() got an unexpected keyword argument 'encoding' * **Fixed** `4756 `_: swig --version doesn't work in all versions of swig; -version should be used instead **Changes in version 1.26.5** (2025-10-10) * Use MuPDF-1.26.10. * Fixed issues: * **Fixed** `2883 `_: Improve the Python type annotations for fitz_new * **Fixed** `4507 `_: Bugs in pyodide * **Fixed** `4613 `_: Thai and number blocks are not auto-scaled and get wrong hyphen when using in insert_htmlbox * **Fixed** `4700 `_: pymupdf.open() processes .zip file without raising * **Fixed** `4716 `_: Problems with unreadable characters * Other: * Supported Python versions are now 3.9-3.14. * We now define all class methods explicitly instead of with dynamic assignment; this improves type hints. * Removed `pymupdf.utils.Shape` class, was duplicate of `pymupdf.Shape`. * Allow use of cibuildwheel to build and test on Pyodide. * Fixed various Pyodide bugs. * In documentation, added section about Linux wheels and glibc compatibility. * Improved documentation of pymupdf.open()'s arg. * Retrospectively mark `4544 `_ as fixed in 1.26.4. **Changes in version 1.26.4 (2025-08-25)** * Use MuPDF-1.26.7. * Fixed issues: * **Fixed** `3806 `_: pdf to image rendering ignore optional content offs * **Fixed** `4388 `_: Incorrect PixMap from page due to cached data from other PDF * **Fixed** `4457 `_: Wrong characters displayed after font subsetting (w/ native method) * **Fixed** `4462 `_: delete_pages() does not accept a single int * **Fixed** `4533 `_: Open PDF error segmentation fault * **Fixed** `4544 `_: About pdf_clip_page * **Fixed** `4565 `_: MacOS uses Tesseract and not Tesseract-OCR * **Fixed** `4571 `_: Broken merged pdfs. * **Fixed** `4590 `_: TypeError in utils.py scrub(): annot.update_file(buffer=...) is invalid * **Fixed** `4614 `_: Intercept bad widgets when inserting to another PDF * **Fixed** `4639 `_: pymupdf.mupdf.FzErrorGeneric: code=1: Director error: : 'JM_new_bbox_device_Device' object has no attribute 'layer_name' * Other: * Check that #4392 `Segfault when running with pytest and -Werror` is fixed if PyMuPDF is built with swig>=4.4. * Add `Page.clip_to_rect()`. * Improved search for Tesseract data. * Retrospectively mark #4496 as fixed in 1.26.1. * Retrospectively mark #4503 as fixed in 1.26.3. * Added experimental support for Graal. **Changes in version 1.26.3 (2025-07-02)** * Use MuPDF-1.26.3. * Fixed issues: * **Fixed** `4462 `_: delete_pages() does not accept a single int * **Fixed** `4503 `_: Undetected character styles * **Fixed** `4527 `_: Rect.intersects() is much slower than necessary * **Fixed** `4564 `_: Possible encoding issue in PDF metadata * **Fixed** `4575 `_: Bug with IRect contains method * Other: * Class Shape is now available as pymupdf.Shape. * Added table cell markdown support. **Changes in version 1.26.2** [Skipped.] **Changes in version 1.26.1 (2025-06-11)** * Use MuPDF-1.26.2. * Fixed issues: * **Fixed** `4520 `_: show_pdf_page does not like empty pages created by new_page * **Fixed** `4524 `_: fitz.get_text ignores 'pages' kwarg * **Fixed** `4412 `_: Regression? Spurious error? in insert_pdf in v1.25.4 * **Fixed** `4496 `_: pymupdf4llm with pymupdfpro * Other: * Partial fix for `4503 `_: Undetected character styles * New method `Document.rewrite_images()`, useful for reducing file size, changing image formats, or converting color spaces. * `Page.get_text()`: restrict positional args to match docs. * Removed bogus definition of class `Shape`. * Removed release date from module, docs and changelog. * `pymupdf.pymupdf_date` and `pymupdf.VersionDate` are now both None. * They will be removed in a future release. **Changes in version 1.26.0 (2025-05-22)** * Use MuPDF-1.26.1. * Fixed issues: * **Fixed** `4324 `_: cluster_drawings() fails to cluster horizontal and vertical thin lines * **Fixed** `4363 `_: Trouble with searching * **Fixed** `4404 `_: IndexError in page.get_links() * **Fixed** `4412 `_: Regression? Spurious error? in insert_pdf in v1.25.4 * **Fixed** `4423 `_: pymupdf.mupdf.FzErrorFormat: code=7: cannot find object in xref error encountered after version 1.25.3 * **Fixed** `4435 `_: get_pixmap method stuck on one page * **Fixed** `4439 `_: New Xml class from data does not work - bug in code * **Fixed** `4445 `_: Broken XREF table incorrectly repaired * **Fixed** `4447 `_: Stroke color of annotations cannot be correctly set * **Fixed** `4479 `_: set_layer_ui_config() toggles all layers rather than just one * **Fixed** `4505 `_: Follow Widget flag values up its parent structure * Other: * Partial fixed for `4457 `_: Wrong characters displayed after font subsetting (w/ native method) * Support image stamp annotations. * Support recoloring pages. * Added example of using Django's file storage API to open files with pymupdf. * Clarified FreeText annotation color options. We now raise an exception if an attempt is made to set attributes that can not be supported. * Fixed potential segv in Pixmap.is_unicolor(). * Added runtime assert that that PyMuPDF and MuPDF were built with compatible NDEBUG settings (related to `4390 `_). * Simplified handling of filename/filetype when opening documents. * Removed PDF linearization support. * Calls to `Document.save()` with `linear` set to true will now raise an exception. * See https://artifex.com/blog/mupdf-removes-linearisation for more information. **Changes in version 1.25.5 (2025-03-31)** * Fixed issues: * **Fixed** `4372 `_: Text insertion fails due to missing /Resources object * **Fixed** `4400 `_: Infinite loop in fill_textbox * **Fixed** `4403 `_: Unable to get_text() - layer/clip nesting too deep * **Fixed** `4415 `_: PDF page is mirrored, origin is at bottom-left * Other: * Use MuPDF-1.25.6. * Fixed MuPDF SEGV on MacOS with particular fonts. * Fixed `Annot.get_textpage()`'s `clip` arg. * Fixed Python-3.14 (pre-release) build error. **Changes in version 1.25.4 (2025-03-14)** * Use MuPDF-1.25.5. * Fixed issues: * **Fixed** `4079 `_: Unexpected result for apply_redactions() * **Fixed** `4224 `_: MuPDF error: format error: negative code in 1d faxd * **Fixed** `4303 `_: page.get_image_info() returns outdated cached results after replacing image * **Fixed** `4309 `_: FzErrorFormat Error When Deleting First Page * **Fixed** `4336 `_: Major Performance Regression: pix.color_count is 150x slower in version 1.25.3 compared to 1.23.8 * **Fixed** `4341 `_: Invalid label retrieval when /Kids is an array of multiple /Nums * Other: * Fixed handling of duplicate widget names when joining PDFs (PR #4347). * Improved Pyodide build. * Avoid SWIG-related build errors with Python-3.13 by disabling PY_LIMITED_API. **Changes in version 1.25.3 (2025-02-06)** * Use MuPDF-1.25.4. * Fixed issues: * **Fixed** `4139 `_: Text color numbers change between 1.24.14 and 1.25.0 * **Fixed** `4141 `_: Some insertion methods fails for pages without a /Resources object * **Fixed** `4180 `_: Search problems * **Fixed** `4182 `_: Text coordinate extraction error * **Fixed** `4245 `_: Highlighting issue distorted on recent versions * **Fixed** `4254 `_: add_freetext_annot is drawing text outside the annotation box * Other: * In annotations: * Added support for subtype FreeTextCallout. * Added support for rich text. * Added miter_limit arg to insert_text*() to allow suppression of spikes caused by long miters. * Add Widget Support to `Document.insert_pdf()`. * Add `bibi` to span dicts. * Add `synthetic' to char dict. * Fixed Pyodide builds. **Changes in version 1.25.2 (2025-01-17)** * Fixed issues: * **Fixed** `4055 `_: "Yes" for all checkboxes does not work for all PDF rendering engines. * **Fixed** `4155 `_: samples_mv is unsafe * **Fixed** `4162 `_: Got AttributeError, when tried to add Signature field * **Fixed** `4186 `_: Incorrect handling of JPEG with color space CMYK image extraction * **Fixed** `4195 `_: Pixmaps that are inverted and have an alpha channel are not rendered properly * **Fixed** `4225 `_: pixmap.pil_save() fails due to colorspace definition * **Fixed** `4232 `_: Incorrect Font style and Size * Other: * Use Python's built-in glyphname <> unicode conversion. * Improve speed of pixmap color inversion. * Add new `char_flags` member to span dictionary, for example allows detection of invisible text. * Detect image masks in TextPage output. * Added `Pixmap.pil_image()`. **Changes in version 1.25.1 (2024-12-11)** * Use MuPDF-1.25.2. * Fixed issues: * **Fixed** `4125 `_: memory leak while convert Pixmap's colorspace * **Fixed** `4034 `_: Possible regression in pdf cleaning during save. **Changes in version 1.25.0 (2024-12-05)** * Use MuPDF-1.25.1. * Fixed issues: * **Fixed** `4026 `_: page.get_text('blocks') output two piece of very similar text with different bbox * **Fixed** `4004 `_: Segmentation Fault When Updating PDF Form Field Value * **Fixed** `3887 `_: Subset Fonts problem using Fallback Font * **Fixed** `3886 `_: Another issue with destroying PDF when inserting html * **Fixed** `3751 `_: apply_redactions causes part of the page content to be hidden / transparent .. codespell:ignore-begin **Changes in version 1.24.14 (2024-11-19)** * Use MuPDF-1.24.11. * Fixed issues: * **Fixed** `3448 `_: get_pixmap function removes the table and leaves just the content behind * **Fixed** `3758 `_: Got "malloc(): unaligned tcache chunk detected Aborted (core dumped)" while using add_redact_annot/apply_redactions * **Fixed** `3813 `_: Stories: Ordered list count broken with nested unordered list * **Fixed** `3933 `_: font.valid_codepoints() - malfunction * **Fixed** `4018 `_: PyMuPDF hangs when iterating over zero page PDF pages backwards * **Fixed** `4043 `_: fullcopypage bug * **Fixed** `4047 `_: Segmentation Fault in add_redact_annot * **Fixed** `4050 `_: Content of dict returned by doc.embfile_info() does not fit to documentation * Other: * Ensure that words from `Page.get_text()` never contain RTL/LTR char mixtures. * Fix building with system MuPDF. * Add dot product for points and vectors. **Changes in version 1.24.13 (2024-10-29)** * Fixed issues: * **Fixed** `3848 `_: Piximap program crash * **Fixed** `3950 `_: Unable to consistently extract field labels from PDFs * **Fixed** `3981 `_: PyMuPDF 1.24.12 with pyinstaller throws error. * **Fixed** `3994 `_: pix.color_topusage raise Segmentation fault (core dumped) **Changes in version 1.24.12 (2024-10-21)** * Fixed issues: * **Fixed** `3914 `_: Ability to print MuPDF errors to logging instead of stdout * **Fixed** `3916 `_: insert_htmlbox error: int too large to convert to float * **Fixed** `3950 `_: Unable to consistently extract field labels from PDFs * Supported Python versions are now 3.9-3.13. * Dropped support for Python-3.8 because end-of-life. * Added support for Python-3.13 because now released. * See: https://devguide.python.org/versions/ **Changes in version 1.24.11 (2024-10-03)** * Use MuPDF-1.24.10. * Fixed issues: * **Fixed** `3624 `_: Pdf file transform to image have a black block * **Fixed** `3859 `_: doc.need_appearances() fails with "AttributeError: module 'pymupdf.mupdf' has no attribute 'PDF_TRUE' " * **Fixed** `3863 `_: apply_redactions() does not work as expected * **Fixed** `3905 `_: open stream can raise a FzErrorFormat error instead of FileDataError * Wheels now use the Python Stable ABI: * There is one PyMuPDF wheel for each platform. * Each wheel works with all supported Python versions. * Each wheel is built using the oldest supported Python version (currently 3.8). * There is no PyMuPDFb wheel. * Other: * Improvements to get_text_words() with sort=True. * Tests now always get the latest versions of required Python packages. * Removed dependency on setuptools. * Added item to PyMuPDF-1.24.10 changes below - fix of #3630. **Changes in version 1.24.10 (2024-09-02)** * Use MuPDF-1.24.9. * Fixed issues: * **Fixed** `3450 `_: get_pixmap function takes too long to process * **Fixed** `3569 `_: Invalid OCGs not ignored by SVG image creation * **Fixed** `3603 `_: ObjStm compression and PDF linearization doesn't work together * **Fixed** `3650 `_: Linebreak inserted between each letter * **Fixed** `3661 `_: Update Document to check the /XYZ len * **Fixed** `3698 `_: documentation issue - old code in the annotations documentation * **Fixed** `3705 `_: Document.select() behaves weirdly in some particular kind of pdf files * **Fixed** `3706 `_: extend Document.__getitem__ type annotation to reflect that the method also accepts slices * **Fixed** `3727 `_: Method get_pixmap() make the program exit without any exceptions or messages * **Fixed** `3767 `_: Cannot get Tessdata with Tesseract-OCR 5 * **Fixed** `3773 `_: Link.set_border gives TypeError: '<' not supported between instances of 'NoneType' and 'int' * **Fixed** `3774 `_: fitz.__version__` does not work anymore * **Fixed** `3789 `_: ValueError: not enough values to unpack (expected 3, got 2) is thrown when call insert_pdf * **Fixed** `3820 `_: class improves namedDest handling * **Fixed** `3630 `_: page.apply_redactions gives unwanted black rectangle * Other: * Object streams and linearization cannot be used together; attempting to do so will raise an exception. (#3603) * Fixed handling of non-existing /Contents object. **Changes in version 1.24.9 (2024-07-24)** * Use MuPDF-1.24.8. **Changes in version 1.24.8 (2024-07-22)** * Fixed issues: * **Fixed** `3636 `_: API documentation for the open function is not obvious to find. * **Fixed** `3654 `_: docx parsing was broken in 1.24.7 * **Fixed** `3677 `_: Unable to extract subset font name using the newer versions of PyMuPDF : 1.24.6 and 1.24.7. * **Fixed** `3687 `_: Page.get_text results in AssertionError for epub files Other: * Fixed various spelling mistakes spotted by codespell. * Improved how we modify MuPDF's default configuration on Windows. * Make text search to work with ligatures. **Changes in version 1.24.7 (2024-06-26)** * Fixed issues: * **Fixed** `3615 `_: Document.pagemode or Document.pagelayout crashes for epub files * **Fixed** `3616 `_: not last version reported **Changes in version 1.24.6 (2024-06-25)** * Use MuPDF-1.24.4 * Fixed issues: * **Fixed** `3599 `_: Story.fit_width() has a weird line * **Fixed** `3594 `_: Garbled extraction for Amazon Sustainability Report * **Fixed** `3591 `_: 'width' in Page.get_drawings() returns width equal as 0 * **Fixed** `3561 `_: ZeroDivisionError: float division by zero with page.apply_redactions() * **Fixed** `3559 `_: SegFault 11 when empty H1 H2 H3 H4 etc element is used in insert_htmlbox * **Fixed** `3539 `_: Add dotted gridline detection to table recognition * **Fixed** `3519 `_: get_toc(simple=False) AttributeError: 'Outline' object has no attribute 'rect' * **Fixed** `3510 `_: page.get_label() gets wrong label on the first page of doc * **Fixed** `3494 `_: 1.24.2/1.24.3: spurious characters introduced when using subset_fonts and insert_pdf * **Fixed** `3470 `_: subset_fonts error exit without exception/warning * **Fixed** `3400 `_: set_toc alters link coordinates for some rotated pages on pymupdf 1.24.2 * **Fixed** `3347 `_: Incorrect links to points on pages having different heights * **Fixed** `3237 `_: Set_metadata() does not work * **Fixed** `3493 `_: Isolate PyMuPDF from other libraries; issues when PyMuPDF is loaded with other libraries like GdkPixbuf * Other: * Fixed concurrent use of PyMuPDF caused by use of constant temporary filenames. * Add musllinux x86_64 wheels to release. * Added clearer version information: * `pymupdf.pymupdf_version`. * `pymupdf.mupdf_version`. * `pymupdf.pymupdf_date`. **Changes in version 1.24.5 (2024-05-30)** * Fixed issues: * **Fixed** `3479 `_: regression: fill_textbox: IndexError: pop from empty list * **Fixed** `3488 `_: set_toc method error * Other: * Some more fixes to use MuPDF floating formatting. * Removed/disabled some unnecessary diagnostics. * Fixed utils.do_links() crash. * Experimental new functions `pymupdf.apply_pages()` and `pymupdf.get_text()`. * Addresses wrong label generation for label styles "a" and "A". **Changes in version 1.24.4 (2024-05-16)** * **Fixed** `3418 `_: Re-introduced bug, text align add_redact_annot * **Fixed** `3472 `_: insert_pdf gives SystemError * Other: * Fixed sysinstall test failing to remove all of prior installation before new install. * Fixed `utils.do_links()` crash. * Correct `TextPage` creation Code. * Unified various diagnostics. * Fix bug in `page_merge()`. **Changes in version 1.24.3 (2024-05-09)** * The Python module is now called `pymupdf`. `fitz` is still supported for backwards compatibility. * Use MuPDF-1.24.2. * Fixed issues: * **Fixed** `3357 `_: PyMuPDF==1.24.0 will hanging when using page.get_text("text") * **Fixed** `3376 `_: Redacting results are not as expected in 1.24.x. * **Fixed** `3379 `_: Documentation mismatch for get_text_blocks return value order. * **Fixed** `3381 `_: Contents stream contains floats in scientific notation * **Fixed** `3402 `_: Cannot add Widgets containing inter-field-calculation JavaScript * **Fixed** `3414 `_: missing attribute set_dpi() * **Fixed** `3430 `_: page.get_text() cause process freeze with certain pdf on v1.24.2 * Other: * New/modified methods: * `Page.remove_rotation()`: new, set page rotation to zero while keeping appearance. * Fixed some problems when checking for PDF properties. * Fixed pip builds from sdist (see discussion `3360 `_: Alpine linux docker build failing "No matching distribution found for pymupdfb==1.24.1"). **Changes in version 1.24.2 (2024-04-17)** * Removed obsolete classic implementation from releases (previously available as module `fitz_old`). * Fixed issues: * **Fixed** `3331 `_: Document.pages() is incorrectly type-hinted * **Fixed** `3354 `_: PyMuPDF==1.24.1: AttributeError: property 'metadata' of 'Document' object has no setter * Other: * New/modified methods: * `Document.bake()`: new, make annotations / fields permanent content. * `Page.cluster_drawings()`: new, identifies drawing items (i.e. vector graphics or line-art) that belong together based on their geometrical vicinity. * `Page.apply_redactions()`: added new parameter `text`. * `Document.subset_fonts()`: use MuPDF's `pdf_subset_fonts()` instead of PyMuPDF code. * The `Document` class now supports page numbers specified as slices. * Avoid causing MuPDF warnings. **Changes in version 1.24.1 (2024-04-02)** * Fixed issues: * **Fixed** `3278 `_: apply_redactions moves some unredacted text * **Fixed** `3301 `_: Be more permissive when classifying links as kind LINK_URI * **Fixed** `3306 `_: Text containing capital 'ET' not appearing as annotation * Other: * Use MuPDF-1.24.1. * Support ObjStm Compression. Methods `Document.save()`, `Document.ez_save()` and `Document.write()` now support new parameters `use_objstm`, compression_effort` and `preserve_metadata`. **Changes in version 1.24.0 (2024-03-21)** * Fixed issues: * **Fixed** `3281 `_: Preparing metadata (pyproject.toml) did not run successfully * **Fixed** `3279 `_: PyMuPDF no longer builds in Alpine Linux * **Fixed** `3257 `_: apply_redactions() deleting text outside of annotated box * **Fixed** `3216 `_: AttributeError: 'Annot' object has no attribute '__del__' * **Fixed** `3207 `_: get_drawings's items is missing line from h path operator * **Fixed** `3201 `_: Memory leaks when merging PDFs * **Fixed** `3197 `_: page.get_text() returns hexadecimal text for some characters * **Fixed** `3196 `_: Remove text not working in 1.23.25 version vs 1.20.2 * **Fixed** `3172 `_: PDF's 45º lines disappearing in png conversion * **Fixed** `3135 `_: Do not log warnings to stdout * **Fixed** `3125 `_: get_pixmap method stuck on one page and runs forever * **Fixed** `2964 `_: There is an issue with the image generated by the page.get_pixmap() function * Other: * Use MuPDF-1.24.0. * Add support for redacting vector graphics. * Several fixes for table module * Add new method for outputting the table as a markdown string. * Address errors in computing the table header object: We now allow None as the cell value, because this will be resolved where needed (e.g. in the pandas DataFrame). We previously tried to enforce rect-like tuples in all header cell bboxes, however this fails for tables with all-None columns. This fix enables this and constructs an empty string in the corresponding cell string. We now correctly include start / stop points of lines in the bbox of the clustered graphic. We previously joined the line's rectangle - which had no effect because this is always empty. * Improved exception text if we fail to open document. * Fixed build with new libclang 18. **Changes in version 1.23.26 (2024-02-29)** * Fixed issues: * **Fixed** `3199 `_: Add entry_points to setuptools configuration to provide command-line console scripts * **Fixed** `3209 `_: Empty vertices in ink annotation * Other: * Improvements to table detection: * Improved check for empty tables, fixes bugs when determining table headers. * Improved computation of enveloping vector graphic rectangles. * Ignore more meaningless "pseudo" tables * Install command-line 'pymupdf' command that runs fitz/__main__.py. * Don't overwrite MuPDF's config.h when building on non-Windows. * Fix `Story` constructor's `archive` arg to match docs - now accepts a single `Archive` constructor arg. * Do not include MuPDF source in sdist; will be downloaded automatically when building. **Changes in version 1.23.25 (2024-02-20)** * Fixed issues: * **Fixed** `3182 `_: Pixmap.invert_irect argument type error * **Fixed** `3186 `_: extractText() extracts broken text from pdf * **Fixed** `3191 `_: Error on .find_tables() * Other: * When building, be able to specify python-config directly, with environment variable `PIPCL_PYTHON_CONFIG`. **Changes in version 1.23.24 (2024-02-19)** * Fixed issues: * **Fixed** `3148 `_: Table extraction - vertical text not handled correctly * **Fixed** `3179 `_: Table Detection: Incorrect Separation of Vector Graphics Clusters * **Fixed** `3180 `_: Cannot show optional content group: AttributeError: module 'fitz.mupdf' has no attribute 'pdf_array_push_drop' * Other: * Be able to test system install using `sudo pip install` instead of a venv. **Changes in version 1.23.23 (2024-02-18)** * Fixed issues: * **Fixed** `3126 `_: Initialising Archive with a pathlib.Path fails. * **Fixed** `3131 `_: Calling the next attribute of an Annot raises a "No attribute .parent" warning * **Fixed** `3134 `_: Using an IRect as clip parameter in Page.get_pixmap no longer works since 1.23.9 * **Fixed** `3140 `_: PDF document stays in use after closing * **Fixed** `3150 `_: doc.select() hangs on this doc. * **Fixed** `3163 `_: AssertionError on using fitz.IRect * **Fixed** `3177 `_: fitz.Pixmap(None, pix) Unrecognised args for constructing Pixmap * Other: * Improved `Document.select() by using new MuPDF function `pdf_rearrange_pages()`. This is a more complete (and faster) implementation of what needs to be done here in that not only pages will be rearranged, but also consequential changes will be made to the table of contents, links to removed pages and affected entries in the Optional Content definitions. * `TextWriter.appendv()`: added `small_caps` arg. * Fixed some valgrind errors with MuPDF master. * Fixed `Document.insert_image()` when build with MuPDF master. **Changes in version 1.23.22 (2024-02-12)** * Fixed issues: * **Fixed** `3143 `_: Difference in decoding of OCGs names between doc.get_ocgs() and page.get_drawings() * **Fixed** `3139 `_: Pixmap resizing needs positional arg "clip" - even if None. * Other: * Removed the use of MuPDF function `fz_image_size()` from PyMuPDF. **Changes in version 1.23.21 (2024-02-01)** * Fixed issues: * Other: * Fixed bug in set_xml_metadata(), PR `3112 `_: Fix pdf_add_stream metadata error * Fixed lack of `.parent` member in `TextPage` from `Annot.get_textpage()`. * Fixed bug in `Page.add_widget()`. **Changes in version 1.23.20 (2024-01-29)** * Bug fixes: * **Fixed** `3100 `_: Wrong internal property accessed in get_xml_metadata * Other: * Significantly improved speed of `Document.get_toc()`. **Changes in version 1.23.19 (2024-01-25)** * Bug fixes: * **Fixed** `3087 `_: Exception in insert_image with mask specified * **Fixed** `3094 `_: TypeError: '<' not supported between instances of 'FzLocation' and 'int' in doc.delete_pages * Other: * When finding tables: * Allow addition of user-defined "virtual" vector graphics when finding tables. * Confirm that the enveloping bboxes of vector graphics are inside the clip rectangle. * Avoid slow finding of rectangle intersections. * Added `Font.bbox` property. **Changes in version 1.23.18 (2024-01-23)** * Bug fixes: * **Fixed** `3081 `_: doc.close() not closing the document * Other: * Reduced size of sdist to fit on pypi.org (by reducing size of two test files). * Fix `Annot.file_info()` if no `Desc` item. **Changes in version 1.23.17 (2024-01-22)** * Bug fixes: * **Fixed** `3062 `_: page_rotation_reset does not return page to original rotation * **Fixed** `3070 `_: update_link(): AttributeError: 'Page' object has no attribute 'super' * Other: * Fixed bug in `Page.links()` (PR #3075). * Fixed bug in `Page.get_bboxlog()` with layers. * Add support for timeouts in scripts/ and tests/run_compound.py. **Changes in version 1.23.16 (2024-01-18)** * Bug fixes: * **Fixed** `3058 `_: Pixmap created from CMYK JPEG delivers RGB format * Other: * In table detection strategy "lines_strict", exclude fill-only vector graphics. * Fixed sysinstall test failure. * In documentation, update feature matrix with item about text writing. **Changes in version 1.23.15 (2024-01-16)** * Bug fixes: * **Fixed** `3050 `_: python3.9 pix.set_pixel has something wrong in c.append( ord(i)) * Other: * Improved docs for Page.find_tables(). **Changes in version 1.23.14 (2024-01-15)** * Bug fixes: * **Fixed** `3038 `_: JM_pixmap_from_display_list > Assertion Error : Checking for wrong type * **Fixed** `3039 `_: Issue with doc.close() not closing the document in PyMuPDF * Other: * Ensure valid "re" rectangles in `Page.get_drawings()` with derotated pages. **Changes in version 1.23.13 (2024-01-15)** * Bug fixes: * **Fixed** `2979 `_: list index out of range in to_pandas() * **Fixed** `3001 `_: Calling find_tables() on one document alters the bounding boxes of a subsequent document * Other: * Fixed `Rect.height` and `Rect.width` to never return negative values. * Fixed `TextPage.extractIMGINFO()`'s returned `dictkey_yres` value. **Changes in version 1.23.12 (2024-01-12)** * * **Fixed** `3027 `_: Page.get_text throws Attribute Error for 'parent' **Changes in version 1.23.11 (2024-01-12)** * Fixed some Pixmap construction bugs. * Fixed Pixmap.yres(). **Changes in version 1.23.10 (2024-01-12)** * Bug fixes: * **Fixed** `3020 `_: Can't resize a PixMap * Other: * Fixed Page.delete_image(). **Changes in version 1.23.9 (2024-01-11)** * Default to new "rebased" implementation. * The old "classic" implementation is available with `import fitz_old as fitz`. * For more information about why we are changing to the rebased implementation, see: https://github.com/pymupdf/PyMuPDF/discussions/2680 * Use MuPDF-1.23.9. * Bug fixes (rebased implementation only): * **Fixed** `2911 `_: Page.derotation_matrix returns a tuple instead of a Matrix with rebased implementation * **Fixed** `2919 `_: Rebased version: KeyError in resolve_names when merging pdfs * **Fixed** `2922 `_: New feature that allows inserting named-destination links doesn't work * **Fixed** `2943 `_: ZeroDivisionError: float division by zero when use apply_redactions() * **Fixed** `2950 `_: Shelling out to pip during tests is problematic * **Fixed** `2954 `_: Replacement unicode character in text extraction * **Fixed** `2957 `_: apply_redactions() moving text * **Fixed** `2961 `_: Passing a string as a page number raises IndexError instead of TypeError. * **Fixed** `2969 `_: annot.next throws AttributeError * **Fixed** `2978 `_: 1.23.9rc1: module 'fitz.mupdf' has no attribute 'fz_copy_pixmap_rect' * **Fixed** `2907 `_: segfault trying to call clean_contents on certain pdfs with python 3.12 * **Fixed** `2905 `_: SystemError: returned a result with an exception set * **Fixed** `2742 `_: Segmentation Fault when inserting three (but not two) copies of the same source page into one destination page * Other: * Add optional setting of opacity to `Page.insert_htmlbox()`. * Fixed issue with add_redact_annot() mentioned in #2934. * Fixed `Page.rotation()` to return 0 for non-PDF documents instead of raising an exception. * Fixed internal quad detection to cope with any Python sequence. * Fixed rebased `fitz.pymupdf_version_tuple` - was previously set to mupdf version. * Improved support for Linux system installs, including adding regular testing on Github. * Add missing `flake8` to `scripts/gh_release.py:test_packages`. * Use newly public functions in MuPDF-1.23.8. * Improved `scripts/test.py` to help investigation of MuPDF issues. **Changes in version 1.23.8 (2023-12-19)** * Bug fixes (rebased implementation only): * **Fixed** `2634 `_: get_toc and set_toc do not behave consistently for rotated pages * **Fixed** `2861 `_: AttributeError in getLinkDict during PDF Merge * **Fixed** `2871 `_: KeyError in getLinkDict during PDF merge * **Fixed** `2886 `_: Error in Skeleton for Named Link Destinations * Bug fixes (rebased and classic implementations): * **Fixed** `2885 `_: pymupdf find tables too slow * Other: * Rebased implementation: * `Page.insert_htmlbox()`: new, much more powerful alternative to `Page.insert_textbox()` or `TextWriter.fill_textbox()`, using `Story`. * `Story.fit*()`: new methods for fitting a Story into an expanded rect. * `Story.write_with_links()`: add support for external links. * `Document.language()`: fixed to use MuPDF's new `mupdf.fz_string_from_text_language2()`. * `Document.subset_fonts()` - fixed. * Fixed internal `Archive._add_treeitem()` method. * Fixed `fitz_new.__doc__` to contain PyMuPDF and Python version information, and OS name. * Removed use of `(*args, **kwargs)` in API, we now specify keyword args explicitly. * Work with new MuPDF Python exception classes. * Fixed bug where `button_states()` returns None when `/AP` points to an indirect object. * Fixed pillow test to not ignore all errors, and install pillow when testing. * Added test for `fitz.css_for_pymupdf_font()` (uses package `pymupdf-fonts`). * Simplified Github Actions test specifications. * Updated `tests/README.md`. **Changes in version 1.23.7 (2023-11-30)** * Bug fixes in rebased implementation, not fixed in classic implementation: * **Fixed** `2232 `_: Geometry helper classes should support keyword arguments * **Fixed** `2788 `_: Problem with get_toc in pymupdf 1.23.6 * **Fixed** `2791 `_: Experiencing small memory leak in save() * Bug fixes (rebased and classic implementations): * **Fixed** `2736 `_: Failure when set cropbox with mediabox negative value * **Fixed** `2749 `_: RuntimeError: cycle in structure tree * **Fixed** `2753 `_: Story.write_with_links will ignore everything after the first "page break" in the HTML. * **Fixed** `2812 `_: find_tables on landscape page generates reversed text * **Fixed** `2829 `_: [cannot create /Annot for kind] is still printed despite #2345 is closed. * **Fixed** `2841 `_: Unexpected KeyError when using scrub with fitz_new * Use MuPDF-1.23.7. * Other: * Rebased implementation: * Added flake8 code checking to test suite, and made various fixes. * Disable diagnostics during Document constructor to match classic implementation. * Additional fix to `2553 `_: Invalid characters in versions >= 1.22 * Fixed `MuPDF Bug 707324 `_: Story: HTML table row background color repeated incorrectly * Added `scripts/test.py`, for simple build+test of PyMuPDF git checkout. * Added `fitz.pymupdf_version_tuple`, e.g. `(1, 23, 6)`. * Restored mistakenly-reverted fix for `2345 `_: Turn off print statements in utils.py * Include any trailing `... repeated times...` text in warnings returned by `mupdf_warnings()` (rebased only). **Changes in version 1.23.6 (2023-11-06)** * Bug fixes: * **Fixed** `2553 `_: Invalid characters in versions >= 1.22 * **Fixed** `2608 `_: Incorrect utf32 text extraction (high & low surrogates are split) * **Fixed** `2710 `_: page.rect and text location wrong / differing from older version * **Fixed** `2774 `_: wrong encoding for "\?" character when sort=True * **Fixed** `2775 `_: fitz_new does not work with python3.10 or earlier * **Fixed** `2777 `_: With fitz_new, wrong type for Page.mediabox * Other: * Use MuPDF-1.23.5. * Added Document.resolve_names() (rebased implementation only). **Changes in version 1.23.5 (2023-10-11)** * Bug fixes: * **Fixed** `2341 `_: Handling negative values in the zoom section for LINK_GOTO in linkDest * **Fixed** `2522 `_: Typo in set_layer() - NameError: name 'f' is not defined * **Fixed** `2548 `_: Fitz freezes on some PDFs when calling the fitz.Page.get_text_blocks method. * **Fixed** `2596 `_: save(garbage=3) breaks get_pixmap() with side effect * **Fixed** `2635 `_: "clean=True" makes objects invisible in the pdf * **Fixed** `2637 `_: Page.insert_textbox incorrectly handles the last word if it starts a new line * **Fixed** `2699 `_: extract paragraph with below table * **Fixed** `2703 `_: Wrong fontsize calculation in corner cases ("page.get_texttrace()") * **Fixed** `2710 `_: page.rect and text location wrong / differing from older version * **Fixed** `2723 `_: When will a Python 3.12 wheel be available? * **Fixed** `2730 `_: persistent get_text() formatting * Other: * Use MuPDF-1.23.4. * Fix optimisation flags with system installs. * Fixed the problem that the clip parameter does not take effect during table recognition * Support Pillow mode "RGBa" * Support extra word delimiters * Support checking valid PDF name objects **Changes in version 1.23.4 (2023-09-26)** * Improved build instructions. * Fixed Tesseract in rebased implementation. * Improvements to build/install with system MuPDF. * Fixed Pyodide builds. * Fixed rebased bug in _insert_image(). * Bug fixes: * **Fixed** `2556 `_: Segmentation fault at calling get_cdrawings(extended=True) * **Fixed** `2637 `_: Page.insert_textbox incorrectly handles the last word if it starts a new line * **Fixed** `2683 `_: Windows sdist build failure - non-quoting of path and using UNIX which command * **Fixed** `2691 `_: Page.get_textpage_ocr() bug in rebased fitz_new version * **Fixed** `2692 `_: Page.get_pixmap(clip=Rect()) bug in rebased fitz_new version **Changes in version 1.23.3 (2023-08-31)** * Fixed use of Tesseract for OCR. **Changes in version 1.23.2 (2023-08-28)** * **Fixed** `#2613 `_: release 1.23.0 not MacOS-arm64 compatible **Changes in version 1.23.1 (2023-08-24)** * Updated README and package summary description. * Fixed a problem on some Linux installations with Python-3.10 (and possibly earlier versions) where `import fitz` failed with `ImportError: libcrypt.so.2: cannot open shared object file: No such file or directory`. * Fixed `incompatible architecture` error on MacOS arm64. * Fixed installation warning from Poetry about missing entry in wheels' RECORD files. **Changes in version 1.23.0 (2023-08-22)** * Add method `find_tables()` to the `Page` object. This allows locating tables on any supported document page, and extracting table content by cell. * New "rebased" implementation of PyMuPDF. The rebased implementation is available as Python module `fitz_new`. It can be used as a drop-in replacement with `import fitz_new as fitz`. * Python-independent MuPDF libraries are now in a second wheel called `PyMuPDFb` that will be automatically installed by pip. This is to save space on pypi.org - a full release only needs one `PyMuPDFb` wheel for each OS. * Bug fixes: * **Fixed** `#2542 `_: fitz.utils.scrub AttributeError Annot object has no attribute fileUpd inside * **Fixed** `#2533 `_: get_texttrace returned a incorrect character bbox * **Fixed** `#2537 `_: Validation when setting a grouped RadioButton throws a RuntimeError: path to 'V' has indirects * Other changes: * Dropped support for Python-3.7. * Fix for wrong page / annot `/Contents` cleaning. We need to set `pdf_filter_options::no_update` to zero. * Added new function get_tessdata(). * Cope with problem `/Annot` arrays. When copying page annotations in method Document.insert_pdf we previously did not check the validity of members of the `/Annots` array. For faulty members (like null or non-dictionary items) this could cause unnecessary exceptions. This fix implements more checks and skips such array items. * Additional annotation type checks. We did not previously check for annotation type when getting / setting annotation border properties. This is now checked in accordance with MuPDF. * Increase fault tolerance. Avoid exceptions in method `insert_pdf()` when source pages contains invalid items in the `/Annots` array. * Return empty border dict for applicable annots. We previously were returning a non-empty border dictionary even for non-applicable annotation types. We now return the empty dictionary `{}` in these cases. This requires some corresponding changes in the annotation `.update()` method, namely for dashes and border width. * Restrict `set_rect` to applicable annot types. We were insufficiently excluding non-applicable annotation types from `set_rect()` method. We now let MuPDF catch unsupported annotations and return `False` in these cases. * Wrong fontsize computation in `page.get_texttrace()`. When computing the font size we were using the final text transformation matrix, where we should have taken `span->trm` instead. This is corrected here. * Updates to cope with changes to latest MuPDF. `pdf_lookup_anchor()` has been removed. * Update fill_textbox to better respect rect.width The function norm_words in fill_textbox had a bug in its last loop, appending n+1 characters when actually measuring width of n characters. It led to a bug in fill_texbox when you tried to write a single word mostly composed of "wide" letters (M,m, W, w...), causing the written text to exceed the given rect. The fix was just to replace n+1 by n. * Add `script_focus` and `script_blur` options to widget. **Changes in version 1.22.5 (2023-06-21)** * This release uses ``MuPDF-1.22.2``. * Bug fixes: * **Fixed** `#2365 `_: Incorrect dictionary values for type "fs" drawings. * **Fixed** `#2391 `_: Check box automatically uncheck when we update same checkbox more than 1 times. * **Fixed** `#2400 `_: Gaps within text of same line not filled with spaces. * **Fixed** `#2404 `_: Blacklining an image in PDF won't remove underlying content in version 1.22.X. * **Fixed** `#2430 `_: Incorrectly reducing ref count of Py_None. * **Fixed** `#2450 `_: Empty fill color and fill opacity for paths with fill and stroke operations with 1.22.* * **Fixed** `#2462 `_: Error at "get_drawing(extended=True )" * **Fixed** `#2468 `_: Decode error when trying to get drawings * **Fixed** `#2710 `_: page.rect and text location wrong / differing from older version * **Fixed** `#2723 `_: When will a Python 3.12 wheel be available? * New features: * **Changed** Annotations now support "cloudy" borders. The :attr:`Annot.border` property has the new item `clouds`, and method :meth:`Annot.set_border` supports the corresponding `clouds` argument. * **Changed** Radio button widgets in the same RB group are now consistently updated **if the group is defined in the standard way**. * **Added** Support for the `/Locked` key in PDF Optional Content. This array inside the catalog entry `/OCProperties` can now be extracted and set. * **Added** Support for new parameter `tessdata` in OCR functions. New function :meth:`get_tessdata` locates the language support folder if Tesseract is installed. **Changes in version 1.22.3 (2023-05-10)** * This release uses ``MuPDF-1.22.0``. * Bug fixes: * **Fixed** `#2333 `_: Unable to set any of button radio group in form **Changes in version 1.22.2 (2023-04-26)** * This release uses ``MuPDF-1.22.0``. * Bug fixes: * **Fixed** `#2369 `_: Image extraction bugs with newer versions **Changes in version 1.22.1 (2023-04-18)** * This release uses ``MuPDF-1.22.0``. * Bug fixes: * **Fixed** `#2345 `_: Turn off print statements in utils.py * **Fixed** `#2348 `_: extract_image returns an extension "flate" instead of "png" * **Fixed** `#2350 `_: Can not make widget (checkbox) to read-only by adding flags PDF_FIELD_IS_READ_ONLY * **Fixed** `#2355 `_: 1.22.0 error when using get_toc (AttributeError: 'SwigPyObject' object has no attribute) **Changes in version 1.22.0 (2023-04-14)** * This release uses ``MuPDF-1.22.0``. * Behavioural changes: * Text extraction now includes glyphs that overlap with clip rect; previously they were included only if they were entirely contained within the clip rect. * Bug fixes: * **Fixed** `#1763 `_: Interactive(smartform) form PDF calculation not working in pymupdf * **Fixed** `#1995 `_: RuntimeError: image is too high for a long paged pdf file when trying * **Fixed** `#2093 `_: Image in pdf changes color after applying redactions * **Fixed** `#2108 `_: Redaction removing more text than expected * **Fixed** `#2141 `_: Failed to read JPX header when trying to get blocks * **Fixed** `#2144 `_: Replace image throws an error * **Fixed** `#2146 `_: Wrong Handling of Reference Count of "None" Object * **Fixed** `#2161 `_: Support adding images as pages directly * **Fixed** `#2168 `_: ``page.add_highlight_annot(start=pointa, stop=pointb)`` not working * **Fixed** `#2173 `_: Double free of ``Colorspace`` used in ``Pixmap`` * **Fixed** `#2179 `_: Incorrect documentation for ``pixmap.tint_with()`` * **Fixed** `#2208 `_: Pushbutton widget appears as check box * **Fixed** `#2210 `_: ``apply_redactions()`` move pdf text to right after redaction * **Fixed** `#2220 `_: ``Page.delete_image()`` | object has no attribute ``is_image`` * **Fixed** `#2228 `_: open some pdf cost too much time * **Fixed** `#2238 `_: Bug - can not extract data from file in the newest version 1.21.1 * **Fixed** `#2242 `_: Python quits silently in ``Story.element_positions()`` if callback function prototype is wrong * **Fixed** `#2246 `_: TextWriter write text in a wrong position * **Fixed** `#2248 `_: After redacting the content, the position of the remaining text changes * **Fixed** `#2250 `_: docs: unclear or broken link in page.rst * **Fixed** `#2251 `_: mupdf_display_errors does not apply to Pixmap when loading broken image * **Fixed** `#2270 `_: ``Annot.get_text("words")`` - doesn't return the first line of words * **Fixed** `#2275 `_: insert_image: document that rotations are counterclockwise * **Fixed** `#2278 `_: Can not make widget (checkbox) to read-only by adding flags PDF_FIELD_IS_READ_ONLY * **Fixed** `#2290 `_: Different image format/data from Page.get_text("dict") and Fitz.get_page_images() * **Fixed** `#2293 `_: 68 failed tests when installing from sdist on my box * **Fixed** `#2300 `_: Too much recursion in tree (parents), makes program terminate * **Fixed** `#2322 `_: add_highlight_annot using clip generates "A Number is Out of Range" error in PDF * Other: * Add key "/AS (Yes)" to the underlying annot object of a selected button form field. * Remove unused ``Document`` methods ``has_xref_streams()`` and ``has_old_style_xrefs()`` as MuPDF equivalents have been removed. * Add new ``Document`` methods and properties for getting/setting ``/PageMode``, ``/PageLayout`` and ``/MarkInfo``. * New ``Document`` property ``version_count``, which contains the number of incremental saves plus one. * New ``Document`` property ``is_fast_webaccess`` which tells whether the document is linearized. * ``DocumentWriter`` is now a context manager. * Add support for ``Pixmap`` JPEG output. * Add support for drawing rectangles with rounded corners. * ``get_drawings()``: added optional ``extended`` arg. * Fixed issue where trace devices' state was not being initialised correctly; data returned from things like ``fitz.Page.get_texttrace()`` might be slightly altered, e.g. ``linewidth`` values. * Output warning to ``stderr`` if it looks like we are being used with current directory containing an invalid ``fitz/`` directory, because this can break import of ``fitz`` module. For example this happens if one attempts to use ``fitz`` when current directory is a PyMuPDF checkout. * Documentation: * General rework: * Introduces a new home page and new table of contents. * Structural update to include new About section. * Comparison & performance graphing. * Includes performance methodology in appendix. * Updates conf.py to understand single back-ticks as code. * Converts double back-ticks to single back-ticks. * Removes redundant files. * Improve ``insert_file()`` documentation. * ``get_bboxlog()``: added optional ``layers`` to ``get_bboxlog()``. * ``Page.get_texttrace()``: add new dictionary key ``layer``, name of Optional Content Group. * Mention use of Python venv in installation documentation. * Added missing fix for #2057 to release 1.21.1's changelog. * Fixes many links to the PyMuPDF-Utilities repo scripts. * Avoid duplication of ``changes.txt`` and ``docs/changes.rst``. * Build * Added ``pyproject.toml`` file to improve builds using pip etc. **Changes in Version 1.21.1 (2022-12-13)** * This release uses ``MuPDF-1.21.1``. * Bug fixes: * **Fixed** `#2110 `_: Fully embedded font is extracted only partially if it occupies more than one object * **Fixed** `#2094 `_: Rectangle Detection Logic * **Fixed** `#2088 `_: Destination point not set for named links in toc * **Fixed** `#2087 `_: Image with Filter "[/FlateDecode/JPXDecode]" not extracted * **Fixed** `#2086 `_: Document.save() owner_pw & user_pw has buffer overflow bug * **Fixed** `#2076 `_: Segfault in fitz.py * **Fixed** `#2057 `_: Document.save garbage parameter not working in PyMuPDF 1.21.0 * **Fixed** `#2051 `_: Missing DPI Parameter * **Fixed** `#2048 `_: Invalid size of TextPage and bbox with newest version 1.21.0 * **Fixed** `#2045 `_: SystemError: returned a result with an error set * **Fixed** `#2039 `_: 1.21.0 fails to build against system libmupdf * **Fixed** `#2036 `_: Archive::Archive defined twice * Other * Swallow "&zoom=nan" in link uri strings. * Add new Page utility methods ``Page.replace_image()`` and ``Page.delete_image()``. * Documentation: * `#2040 `_: Added note about test failure with non-default build of MuPDF, to ``tests/README.md``. * `#2037 `_: In ``docs/installation.rst``, mention incompatibility with chocolatey.org on Windows. * `#2061 `_: Fixed description of ``Annot.file_info``. * `#2065 `_: Show how to insert internal PDF link. * Improved description of building from source without an sdist. * Added information about running tests. * `#2084 `_: Fixed broken link to PyMuPDF-Utilities. **Changes in Version 1.21.0 (2022-11-8)** * This release uses ``MuPDF-1.21.0``. * New feature: Stories. * Added wheels for Python-3.11. * Bug fixes: * **Fixed** `#1701 `_: Broken custom image insertion. * **Fixed** `#1854 `_: `Document.delete_pages()` declines keyword arguments. * **Fixed** `#1868 `_: Access Violation Error at `page.apply_redactions()`. * **Fixed** `#1909 `_: Adding text with `fontname="Helvetica"` can silently fail. * **Fixed** `#1913 `_: `draw_rect()`: does not respect width if color is not specified. * **Fixed** `#1917 `_: `subset_fonts()`: make it possible to silence the stdout. * **Fixed** `#1936 `_: Rectangle detection can be incorrect producing wrong output. * **Fixed** `#1945 `_: Segmentation fault when saving with `clean=True`. * **Fixed** `#1965 `_: `pdfocr_save()` Hard Crash. * **Fixed** `#1971 `_: Segmentation fault when using `get_drawings()`. * **Fixed** `#1946 `_: `block_no` and `block_type` switched in `get_text()` docs. * **Fixed** `#2013 `_: AttributeError: 'Widget' object has no attribute '_annot' in delete widget. * Misc changes to core code: * Fixed various compiler warnings and a sequence-point bug. * Added support for Memento builds. * Fixed leaks detected by Memento in test suite. * Fixed handling of exceptions in set_name() and set_rect(). * Allow build with latest MuPDF, for regular testing of PyMuPDF master. * Cope with new MuPDF exceptions when setting rect for some Annot types. * Reduced cosmetic differences between MuPDF's config.h and PyMuPDF's _config.h. * Cope with various changes to MuPDF API. * Other: * Fixed various broken links and typos in docs. * Mention install of `swig-python` on MacOS for #875. * Added (untested) wheels for macos-arm64. **Changes in Version 1.20.2** * This release uses ``MuPDF-1.20.3``. * **Fixed** `#1787 `_. Fix linking issues on Unix systems. * **Fixed** `#1824 `_. SegFault when applying redactions overlapping a transparent image. (Fixed in ``MuPDF-1.20.3``.) * Improvements to documentation: * Improved information about building from source in ``docs/installation.rst``. * Clarified memory allocation setting ``JM_MEMORY` in ``docs/tools.rst``. * Fixed link to PDF Reference manual in ``docs/app3.rst``. * Fixed building of html documentation on OpenBSD. * Moved old ``docs/faq.rst`` into separate ``docs/recipes-*`` files. * Removed some unused files and directories: * ``installation/`` * ``docs/wheelnames.txt`` **Changes in Version 1.20.1** * **Fixed** `#1724 `_. Fix for building on FreeBSD. * **Fixed** `#1771 `_. `linkDest()` had a broken call to `re.match()`, introduced in 1.20.0. * **Fixed** `#1751 `_. `get_drawings()` and `get_cdrawings()` previously always returned with `closePath=False`. * **Fixed** `#1645 `_. Default FreeText annotation text color is now black. * Improvements to sphinx-generated documentation: * Use readthedocs theme with enhancements. * Renamed the `.txt` files to have `.rst` suffixes. ------ **Changes in Version 1.20.0** This release uses ``MuPDF-1.20.0``, released 2022-06-15. * Cope with new MuPDF link uri format, changed from ``#,,`` to ``#page=&zoom=,,``. * In ``tests/test_insertpdf.py``, use new reference output ``joined-1.20.pdf``. We also check that new output values are approximately the same as the old ones. * **Fixed** `#1738 `_. Leak of `pdf_graft_map`. Also fixed a SEGV issue that this seemed to expose, caused by incorrect freeing of underlying fz_document. * **Fixed** `#1733 `_. Fixed ownership of `Annotation.get_pixmap()`. Changes to build/release process: * If pip builds from source because an appropriate wheel is not available, we no longer require MuPDF to be pre-installed. Instead the required MuPDF source is embedded in the sdist and automatically built into PyMuPDF. * Various changes to ``setup.py`` to download the required MuPDF release as required. See comments at start of setup.py for details. * Added ``.github/workflows/build_wheels.yml`` to control building of wheels on Github. ------ **Changes in Version 1.19.6** * **Fixed** `#1620 `_. The :ref:`TextPage` created by :meth:`Page.get_textpage` will now be freed correctly (removed memory leak). * **Fixed** `#1601 `_. Document open errors should now be more concise and easier to interpret. In the course of this, two PyMuPDF-specific Python exceptions have been **added:** - ``EmptyFileError`` -- raised when trying to create a :ref:`Document` (``fitz.open()``) from an empty file or zero-length memory. - ``FileDataError`` -- raised when MuPDF encounters irrecoverable document structure issues. * **Added** :meth:`Page.load_widget` given a PDF field's xref. * **Added** Dictionary :attr:`pdfcolor` which provide the about 500 colors defined as PDF color values with the lower case color name as key. * **Added** algebra functionality to the :ref:`Quad` class. These objects can now also be added and subtracted among themselves, and be multiplied by numbers and matrices. * **Added** new constants defining the default text extraction flags for more comfortable handling. Their naming convention is like :data:`TEXTFLAGS_WORDS` for ``page.get_text("words")``. See :ref:`text_extraction_flags`. * **Changed** :meth:`Page.annots` and :meth:`Page.widgets` to detect and prevent reloading the page (illegally) inside the iterator loops via :meth:`Document.reload_page`. Doing this brings down the interpreter. Documented clean ways to do annotation and widget mass updates within properly designed loops. * **Changed** several internal utility functions to become standalone ("SWIG inline") as opposed to be part of the :ref:`Tools` class. This, among other things, increases the performance of geometry object creation. * **Changed** :meth:`Document.update_stream` to always accept stream updates - whether or not the dictionary object behind the xref already is a stream. Thus the former ``new`` parameter is now ignored and will be removed in v1.20.0. ------ **Changes in Version 1.19.5** * **Fixed** `#1518 `_. A limited "fix": in some cases, rectangles and quadrupels were not correctly encoded to support re-drawing by :ref:`Shape`. * **Fixed** `#1521 `_. This had the same ultimate reason behind issue #1510. * **Fixed** `#1513 `_. Some Optional Content functions did not support non-ASCII characters. * **Fixed** `#1510 `_. Support more soft-mask image subtypes. * **Fixed** `#1507 `_. Immunize against items in the outlines chain, that are ``"null"`` objects. * **Fixed** re-opened `#1417 `_. ("too many open files"). This was due to insufficient calls to MuPDF's ``fz_drop_document()``. This also fixes `#1550 `_. * **Fixed** several undocumented issues in relation to incorrectly setting the text span origin :data:`point_like`. * **Fixed** undocumented error computing the character bbox in method :meth:`Page.get_texttrace` when text is **flipped** (as opposed to just rotated). * **Added** items to the dictionary returned by :meth:`image_properties`: ``orientation`` and ``transform`` report the natural image orientation (EXIF data). * **Added** method :meth:`Document.xref_copy`. It will make a given target PDF object an exact copy of a source object. ------ **Changes in Version 1.19.4** * **Fixed** `#1505 `_. Immunize against circular outline items. * **Fixed** `#1484 `_. Correct CropBox coordinates are now returned in all situations. * **Fixed** `#1479 `_. * **Fixed** `#1474 `_. TextPage objects are now properly deleted again. * **Added** :ref:`Page` methods and attributes for PDF ``/ArtBox``, ``/BleedBox``, ``/TrimBox``. * **Added** global attribute :attr:`TESSDATA_PREFIX` for easy checking of OCR support. * **Changed** :meth:`Document.xref_set_key` such that dictionary keys will physically be removed if set to value ``"null"``. * **Changed** :meth:`Document.extract_font` to optionally return a dictionary (instead of a tuple). ------ **Changes in Version 1.19.3** This patch version implements minor improvements for :ref:`Pixmap` and also some important fixes. * **Fixed** `#1351 `_. Reverted code that introduced the memory growth in v1.18.15. * **Fixed** `#1417 `_. Developed circumvention for growth of open file handles using :meth:`Document.insert_pdf`. * **Fixed** `#1418 `_. Developed circumvention for memory growth using :meth:`Document.insert_pdf`. * **Fixed** `#1430 `_. Developed circumvention for mass pixmap generations of document pages. * **Fixed** `#1433 `_. Solves a bbox error for some Type 3 font in PyMuPDF text processing. * **Added** :meth:`Pixmap.color_topusage` to determine the share of the most frequently used color. Solves `#1397 `_. * **Added** :meth:`Pixmap.warp` which makes a new pixmap from a given arbitrary convex quad inside the pixmap. * **Added** :attr:`Annot.irt_xref` and :meth:`Annot.set_irt_xref` to inquire or set the `/IRT` ("In Response To") property of an annotation. Implements `#1450 `_. * **Added** :meth:`Rect.torect` and :meth:`IRect.torect` which compute a matrix that transforms to a given other rectangle. * **Changed** :meth:`Pixmap.color_count` to also return the count of each color. * **Changed** :meth:`Page.get_texttrace` to also return correct span and character bboxes if ``span["dir"] != (1, 0)``. ------ **Changes in Version 1.19.2** This patch version implements minor improvements for :meth:`Page.get_drawings` and also some important fixes. * **Fixed** `#1388 `_. Fixed intermittent memory corruption when insert or updating annotations. * **Fixed** `#1375 `_. Inconsistencies between line numbers as returned by the "words" and the "dict" options of :meth:`Page.get_text` have been corrected. * **Fixed** `#1364 `_. The check for being a ``"rawdict"`` span in :meth:`recover_span_quad` now works correctly. * **Fixed** `#1342 `_. Corrected the check for rectangle infiniteness in :meth:`Page.show_pdf_page`. * **Changed** :meth:`Page.get_drawings`, :meth:`Page.get_cdrawings` to return an indicator on the area orientation covered by a rectangle. This implements `#1355 `_. Also, the recognition rate for rectangles and quads has been significantly improved. * **Changed** all text search and extraction methods to set the new ``flags`` option ``TEXT_MEDIABOX_CLIP`` to ON by default. That bit causes the automatic suppression of all characters that are completely outside a page's mediabox (in as far as that notion is supported for a document type). This eliminates the need for using ``clip=page.rect`` or similar for omitting text outside the visible area. * **Added** parameter ``"dpi"`` to :meth:`Page.get_pixmap` and :meth:`Annot.get_pixmap`. When given, parameter ``"matrix"`` is ignored, and a :ref:`Pixmap` with the desired dots per inch is created. * **Added** attributes :attr:`Pixmap.is_monochrome` and :attr:`Pixmap.is_unicolor` allowing fast checks of pixmap properties. Addresses `#1397 `_. * **Added** method :meth:`Pixmap.color_count` to determine the unique colors in the pixmap. * **Added** boolean parameter ``"compress"`` to PDF document method :meth:`Document.update_stream`. Addresses / enables solution for `#1408 `_. ------ **Changes in Version 1.19.1** This is the first patch version to support MuPDF v1.19.0. Apart from one bug fix, it includes important improvements for OCR support and the option to **sort extracted text** to the standard reading order "from top-left to bottom-right". * **Fixed** `#1328 `_. "words" text extraction again returns correct ``(x0, y0)`` coordinates. * **Changed** :meth:`Page.get_textpage_ocr`: it now supports parameter ``dpi`` to control OCR quality. It is also possible to choose whether the **full page** should be OCRed or **only the images displayed** by the page. * **Changed** :meth:`Page.get_drawings` and :meth:`Page.get_cdrawings` to automatically convert colors to RGB color tuples. Implements `#1332 `_. Similar change was applied to :meth:`Page.get_texttrace`. * **Changed** :meth:`Page.get_text` to support a parameter ``sort``. If set to ``True`` the output is conveniently sorted. ------ **Changes in Version 1.19.0** This is the first version supporting MuPDF 1.19.*, published 2021-10-05. It introduces many new features compared to the previous version 1.18.*. PyMuPDF has now picked up integrated Tesseract OCR support, which was already present in MuPDF v1.18.0. * Supported images can be OCRed via their :ref:`Pixmap` which results in a 1-page PDF with a text layer. * All supported document pages (i.e. not only PDFs), can be OCRed using specialized text extraction methods. The result is a mixture of standard and OCR text (depending on which part of the page was deemed to require OCRing) that can be searched and extracted without restrictions. * All this requires an independent installation of Tesseract. MuPDF actually (only) needs the location of Tesseract's ``"tessdata"`` folder, where its language support data are stored. This location must be available as environment variable ``TESSDATA_PREFIX``. A new MuPDF feature is **journalling PDF updates**, which is also supported by this PyMuPDF version. Changes may be logged, rolled back or replayed, allowing to implement a whole new level of control over PDF document integrity -- similar to functions present in modern database systems. A third feature (unrelated to the new MuPDF version) includes the ability to detect when page **objects cover or hide each other**. It is now e.g. possible to see that text is covered by a drawing or an image. * **Changed** terminology and meaning of important geometry concepts: Rectangles are now characterized as *finite*, *valid* or *empty*, while the definitions of these terms have also changed. Rectangles specifically are now thought of being "open": not all corners and sides are considered part of the rectangle. Please do read the :ref:`Rect` section for details. * **Added** new parameter `"no_new_id"` to :meth:`Document.save` / :meth:`Document.tobytes` methods. Use it to suppress updating the second item of the document ``/ID`` which in PDF indicates that the original file has been updated. If the PDF has no ``/ID`` at all yet, then no new one will be created either. * **Added** a **journalling facility** for PDF updates. This allows logging changes, undoing or redoing them, or saving the journal for later use. Refer to :meth:`Document.journal_enable` and friends. * **Added** new :ref:`Pixmap` methods :meth:`Pixmap.pdfocr_save` and :meth:`Pixmap.pdfocr_tobytes`, which generate a 1-page PDF containing the pixmap as PNG image with OCR text layer. * **Added** :meth:`Page.get_textpage_ocr` which executes optical character recognition for the page, then extracts the results and stores them together with "normal" page content in a :ref:`TextPage`. Use or reuse this object in subsequent text extractions and text searches to avoid multiple efforts. The existing text search and text extraction methods have been extended to support a separately created textpage -- see next item. * **Added** a new parameter ``textpage`` to text extraction and text search methods. This allows reuse of a previously created :ref:`TextPage` and thus achieves significant runtime benefits -- which is especially important for the new OCR features. But "normal" text extractions can definitely also benefit. * **Added** :meth:`Page.get_texttrace`, a technical method delivering low-level text character properties. It was present before as a private method, but the author felt it now is mature enough to be officially available. It specifically includes a "sequence number" which indicates the page appearance build operation that painted the text. * **Added** :meth:`Page.get_bboxlog` which delivers the list of rectangles of page objects like text, images or drawings. Its significance lies in its sequence: rectangles intersecting areas with a lower index are covering or hiding them. * **Changed** methods :meth:`Page.get_drawings` and :meth:`Page.get_cdrawings` to include a "sequence number" indicating the page appearance build operation that created the drawing. * **Fixed** `#1311 `_. Field values in comboboxes should now be handled correctly. * **Fixed** `#1290 `_. Error was caused by incorrect rectangle emptiness check, which is fixed due to new geometry logic of this version. * **Fixed** `#1286 `_. Text alignment for redact annotations is working again. * **Fixed** `#1287 `_. Infinite loop issue for non-Windows systems when applying some redactions has been resolved. * **Fixed** `#1284 `_. Text layout destruction after applying redactions in some cases has been resolved. ------ **Changes in Version 1.18.18 / 1.18.19** * **Fixed** issue `#1266 `_. Failure to set :attr:`Pixmap.samples` in important cases, was hotfixed in a new version 1.18.19. * **Fixed** issue `#1257 `_. Removing the read-only flag from PDF fields is now possible. * **Fixed** issue `#1252 `_. Now correctly specifying the ``zoom`` value for PDF link annotations. * **Fixed** issue `#1244 `_. Now correctly computing the transform matrix in :meth:`Page.get_image__bbox`. * **Fixed** issue `#1241 `_. Prevent returning artifact characters in :meth:`Page.get_textbox`, which happened in certain constellations. * **Fixed** issue `#1234 `_. Avoid creating infinite rectangles in corner cases -- :meth:`Page.get_drawings`, :meth:`Page.get_cdrawings`. * **Added** test data and test scripts to the source PyPI source distribution. ------ **Changes in Version 1.18.17** Focus of this version are major performance improvements of selected functions. * **Fixed** issue `#1199 `_. Using a non-existing page number in :meth:`Document.get_page_images` and friends will no longer lead to segfaults. * **Changed** :meth:`Page.get_drawings` to now differentiate between "stroke", "fill" and combined paths. Paths containing more than one rectangle (i.e. "re" items) are now supported. Extracting "clipped" paths is now available as an option. * **Added** :meth:`Page.get_cdrawings`, performance-optimized version of :meth:`Page.get_drawings`. * **Added** :attr:`Pixmap.samples_mv`, *memoryview* of a pixmap's pixel area. Does not copy and thus always accesses the current state of that area. * **Added** :attr:`Pixmap.samples_ptr`, Python "pointer" to a pixmap's pixel area. Allows much faster creation (factor 800+) of Qt images. ------ **Changes in Version 1.18.16** * **Fixed** issue `#1184 `_. Existing PDF widget fonts in a PDF are now accepted (i.e. not forcedly changed to a Base-14 font). * **Fixed** issue `#1154 `_. Text search hits should now be correct when ``clip`` is specified. * **Fixed** issue `#1152 `_. * **Fixed** issue `#1146 `_. * **Added** :attr:`Link.flags` and :meth:`Link.set_flags` to the :ref:`Link` class. Implements enhancement requests `#1187 `_. * **Added** option to *simulate* :meth:`TextWriter.fill_textbox` output for predicting the number of lines, that a given text would occupy in the textbox. * **Added** text output support as subcommand `gettext` to the ``fitz`` CLI module. Most importantly, original **physical text layout** reproduction is now supported. ------ **Changes in Version 1.18.15** * **Fixed** issue `#1088 `_. Removing an annotation's fill color should now work again both ways, using the ``fill_color=[]`` argument in :meth:`Annot.update` as well as ``fill=[]`` in :meth:`Annot.set_colors`. * **Fixed** issue `#1081 `_. :meth:`Document.subset_fonts`: fixed an error which created wrong character widths for some fonts. * **Fixed** issue `#1078 `_. :meth:`Page.get_text` and other methods related to text extraction: changed the default value of the :ref:`TextPage` ``flags`` parameter. All whitespace and :data:`ligatures` are now preserved. * **Fixed** issue `#1085 `_. The old *snake_cased* alias of ``fitz.detTextlength`` is now defined correctly. * **Changed** :meth:`Document.subset_fonts` will now correctly prefix font subsets with an appropriate six letter uppercase tag, complying with the PDF specification. * **Added** new method :meth:`Widget.button_states` which returns the possible values that a button-type field can have when being set to "on" or "off". * **Added** support of text with **Small Capital** letters to the :ref:`Font` and :ref:`TextWriter` classes. This is reflected by an additional bool parameter ``small_caps`` in various of their methods. ------ **Changes in Version 1.18.14** * **Finished** implementing new, "snake_cased" names for methods and properties, that were "camelCased" and awkward in many aspects. At the end of this documentation, there is section :ref:`Deprecated` with more background and a mapping of old to new names. * **Fixed** issue `#1053 `_. :meth:`Page.insert_image`: when given, include image mask in the hash computation. * **Fixed** issue `#1043 `_. Added ``Pixmap.getPNGdata`` to the aliases of :meth:`Pixmap.tobytes`. * **Fixed** an internal error when computing the enveloping rectangle of drawn paths as returned by :meth:`Page.get_drawings`. * **Fixed** an internal error occasionally causing loops when outputting text via :meth:`TextWriter.fill_textbox`. * **Added** :meth:`Font.char_lengths`, which returns a tuple of character widths of a string. * **Added** more ways to specify pages in :meth:`Document.delete_pages`. Now a sequence (list, tuple or range) can be specified, and the Python ``del`` statement can be used. In the latter case, Python ``slices`` are also accepted. * **Changed** :meth:`Document.del_toc_item`, which disables a single item of the TOC: previously, the title text was removed. Instead, now the complete item will be shown grayed-out by supporting viewers. ------ **Changes in Version 1.18.13** * **Fixed** issue `#1014 `_. * **Fixed** an internal memory leak when computing image bboxes -- :meth:`Page.get_image_bbox`. * **Added** support for low-level access and modification of the PDF trailer. Applies to :meth:`Document.xref_get_keys`, :meth:`Document.xref_get_key`, and :meth:`Document.xref_set_key`. * **Added** documentation for maintaining private entries in PDF metadata. * **Added** documentation for handling transparent image insertions, :meth:`Page.insert_image`. * **Added** :meth:`Page.get_image_rects`, an improved version of :meth:`Page.get_image_bbox`. * **Changed** :meth:`Document.delete_pages` to support various ways of specifying pages to delete. Implements `#1042 `_. * **Changed** :meth:`Page.insert_image` to also accept the xref of an existing image in the file. This allows "copying" images between pages, and extremely fast multiple insertions. * **Changed** :meth:`Page.insert_image` to also accept the integer parameter ``alpha``. To be used for performance improvements. * **Changed** :meth:`Pixmap.set_alpha` to support new parameters for pre-multiplying colors with their alpha values and setting a specific color to fully transparent (e.g. white). * **Changed** :meth:`Document.embfile_add` to automatically set creation and modification date-time. Correspondingly, :meth:`Document.embfile_upd` automatically maintains modification date-time (``/ModDate`` PDF key), and :meth:`Document.embfile_info` correspondingly reports these data. In addition, the embedded file's associated "collection item" is included via its :data:`xref`. This supports the development of PDF portfolio applications. ------ **Changes in Version 1.18.11 / 1.18.12** * **Fixed** issue `#972 `_. Improved layout of source distribution material. * **Fixed** issue `#962 `_. Stabilized Linux distribution detection for generating PyMuPDF from sources. * **Added:** :meth:`Page.get_xobjects` delivers the result of :meth:`Document.get_page_xobjects`. * **Added:** :meth:`Page.get_image_info` delivers meta information for all images shown on the page. * **Added:** :meth:`Tools.mupdf_display_warnings` allows setting on / off the display of MuPDF-generated warnings. The default is off. * **Added:** :meth:`Document.ez_save` convenience alias of :meth:`Document.save` with some different defaults. * **Changed:** Image extractions of document pages now also contain the image's **transformation matrix**. This concerns :meth:`Page.get_image_bbox` and the DICT, JSON, RAWDICT, and RAWJSON variants of :meth:`Page.get_text`. ------ **Changes in Version 1.18.10** * **Fixed** issue `#941 `_. Added old aliases for :meth:`DisplayList.get_pixmap` and :meth:`DisplayList.get_textpage`. * **Fixed** issue `#929 `_. Stabilized removal of JavaScript objects with :meth:`Document.scrub`. * **Fixed** issue `#927 `_. Removed a loop in the reworked :meth:`TextWriter.fill_textbox`. * **Changed** :meth:`Document.xref_get_keys` and :meth:`Document.xref_get_key` to also allow accessing the PDF trailer dictionary. This can be done by using `-1` as the xref number argument. * **Added** a number of functions for reconstructing the quads for text lines, spans and characters extracted by :meth:`Page.get_text` options "dict" and "rawdict". See :meth:`recover_quad` and friends. * **Added** :meth:`Tools.unset_quad_corrections` to suppress character quad corrections (occasionally required for erroneous fonts). ------ **Changes in Version 1.18.9** * **Fixed** issue `#888 `_. Removed ambiguous statements concerning PyMuPDF's license, which is now clearly stated to be GNU AGPL V3. * **Fixed** issue `#895 `_. * **Fixed** issue `#896 `_. Since v1.17.6 PyMuPDF suppresses the font subset tags and only reports the base fontname in text extraction outputs "dict" / "json" / "rawdict" / "rawjson". Now a new global parameter can request the old behaviour, :meth:`Tools.set_subset_fontnames`. * **Fixed** issue `#885 `_. Pixmap creation now also works with filenames given as ``pathlib.Paths``. * **Changed** :meth:`Document.subset_fonts`: Text is **not rewritten** any more and should therefore **retain all its original properties** -- like being hidden or being controlled by Optional Content mechanisms. * **Changed** :ref:`TextWriter` output to also accept text in right to left mode (Arabian, Hebrew): :meth:`TextWriter.fill_textbox`, :meth:`TextWriter.append`. These methods now accept a new boolean parameter `right_to_left`, which is *False* by default. Implements `#897 `_. * **Changed** :meth:`TextWriter.fill_textbox` to return all lines of text, that did not fit in the given rectangle. Also changed the default of the ``warn`` parameter to no longer print a warning message in overflow situations. * **Added** a utility function :meth:`recover_quad`, which computes the quadrilateral of a span. This function can be used for correctly marking text extracted with the "dict" or "rawdict" options of :meth:`Page.get_text`. ------ **Changes in Version 1.18.8** This is a bug fix version only. We are publishing early because of the potentially widely used functions. * **Fixed** issue `#881 `_. Fixed a memory leak in :meth:`Page.insert_image` when inserting images from files or memory. * **Fixed** issue `#878 `_. ``pathlib.Path`` objects should now correctly handle file path hierarchies. ------ **Changes in Version 1.18.7** * **Added** an experimental :meth:`Document.subset_fonts` which reduces the size of eligible fonts based on their use by text in the PDF. Implements `#855 `_. * **Implemented** request `#870 `_: :meth:`Document.convert_to_pdf` now also supports PDF documents. * **Renamed** ``Document.write`` to :meth:`Document.tobytes` for greater clarity. But the deprecated name remains available for some time. * **Implemented** request `#843 `_: :meth:`Document.tobytes` now supports linearized PDF output. :meth:`Document.save` now also supports writing to Python **file objects**. In addition, the open function now also supports Python file objects. * **Fixed** issue `#844 `_. * **Fixed** issue `#838 `_. * **Fixed** issue `#823 `_. More logic for better support of OCRed text output (Tesseract, ABBYY). * **Fixed** issue `#818 `_. * **Fixed** issue `#814 `_. * **Added** :meth:`Document.get_page_labels` which returns a list of page label definitions of a PDF. * **Added** :meth:`Document.has_annots` and :meth:`Document.has_links` to check whether these object types are present anywhere in a PDF. * **Added** expert low-level functions to simplify inquiry and modification of PDF object sources: :meth:`Document.xref_get_keys` lists the keys of object :data:`xref`, :meth:`Document.xref_get_key` returns type and content of a key, and :meth:`Document.xref_set_key` modifies the key's value. * **Added** parameter ``thumbnails`` to :meth:`Document.scrub` to also allow removing page thumbnail images. * **Improved** documentation for how to add valid text marker annotations for non-horizontal text. We continued the process of renaming methods and properties from *"mixedCase"* to *"snake_case"*. Documentation usually mentions the new names only, but old, deprecated names remain available for some time. ------ **Changes in Version 1.18.6** * **Fixed** issue `#812 `_. * **Fixed** issue `#793 `_. Invalid document metadata previously prevented opening some documents at all. This error has been removed. * **Fixed** issue `#792 `_. Text search and text extraction will make no rectangle containment checks at all if the default ``clip=None`` is used. * **Fixed** issue `#785 `_. * **Fixed** issue `#780 `_. Corrected a parameter check error. * **Fixed** issue `#779 `_. Fixed typo * **Added** an option to set the desired line height for text boxes. Implements `#804 `_. * **Changed** text position retrieval to better cope with Tesseract's glyphless font. Implements `#803 `_. * **Added** an option to choose the prefix of new annotations, fields and links for providing unique annotation ids. Implements request `#807 `_. * **Added** getting and setting color and text properties for Table of Contents items for PDFs. Implements `#779 `_. * **Added** PDF page label handling: :meth:`Page.get_label()` returns the page label, :meth:`Document.get_page_numbers` return all page numbers having a specified label, and :meth:`Document.set_page_labels` adds or updates a PDF's page label definition. .. note:: This version introduces **Python type hinting**. The goal is to provide each parameter and the return value of all functions and methods with type information. This still is work in progress although the majority of functions has already been handled. ------ **Changes in Version 1.18.5** Apart from several fixes, this version also focusses on several minor, but important feature improvements. Among the latter is a more precise computation of proper line heights and insertion points for writing / inserting text. As opposed to using font-agnostic constants, these values are now taken from the font's properties. Also note that this is the first version which does no longer provide pregenerated wheels for Python versions older than 3.6. PIP also discontinues support for these by end of this year 2020. * **Fixed** issue `#771 `_. By using "small glyph heights" option, the full page text can be extracted. * **Fixed** issue `#768 `_. * **Fixed** issue `#750 `_. * **Fixed** issue `#739 `_. The "dict", "rawdict" and corresponding JSON output variants now have two new *span* keys: ``"ascender"`` and ``"descender"``. These floats represent special font properties which can be used to compute bboxes of spans or characters of **exactly fontsize height** (as opposed to the default line height). An example algorithm is shown in section "Span Dictionary" `here `_. Also improved the detection and correction of ill-specified ascender / descender values encountered in some fonts. * **Added** a new, experimental :meth:`Tools.set_small_glyph_heights` -- also in response to issue `#739 `_. This method sets or unsets a global parameter to **always compute bboxes with fontsize height**. If "on", text searching and all text extractions will returned rectangles, bboxes and quads with a smaller height. * **Fixed** issue `#728 `_. * **Changed** fill color logic of 'Polyline' annotations: this parameter now only pertains to line end symbols -- the annotation itself can no longer have a fill color. Also addresses issue `#727 `_. * **Changed** :meth:`Page.getImageBbox` to also compute the bbox if the image is contained in an XObject. * **Changed** :meth:`Shape.insertTextbox`, resp. :meth:`Page.insertTextbox`, resp. :meth:`TextWriter.fillTextbox` to respect font's properties "ascender" / "descender" when computing line height and insertion point. This should no longer lead to line overlaps for multi-line output. These methods used to ignore font specifics and used constant values instead. ------ **Changes in Version 1.18.4** This version adds several features to support PDF Optional Content. Among other things, this includes OCMDs (Optional Content Membership Dictionaries) with the full scope of *"visibility expressions"* (PDF key ``/VE``), text insertions (including the :ref:`TextWriter` class) and drawings. * **Fixed** issue `#727 `_. Freetext annotations now support an uncolored rectangle when ``fill_color=None``. * **Fixed** issue `#726 `_. UTF-8 encoding errors are now handled for HTML / XML :meth:`Page.getText` output. * **Fixed** issue `#724 `_. Empty values are no longer stored in the PDF /Info metadata dictionary. * **Added** new methods :meth:`Document.set_oc` and :meth:`Document.get_oc` to set or get optional content references for **existing** image and form XObjects. These methods are similar to the same-named methods of :ref:`Annot`. * **Added** :meth:`Document.set_ocmd`, :meth:`Document.get_ocmd` for handling OCMDs. * **Added** **Optional Content** support for text insertion and drawing. * **Added** new method :meth:`Page.deleteWidget`, which deletes a form field from a page. This is analogous to deleting annotations. * **Added** support for Popup annotations. This includes defining the Popup rectangle and setting the Popup to open or closed. Methods / attributes :meth:`Annot.set_popup`, :meth:`Annot.set_open`, :attr:`Annot.has_popup`, :attr:`Annot.is_open`, :attr:`Annot.popup_rect`, :attr:`Annot.popup_xref`. Other changes: * The **naming of methods and attributes** in PyMuPDF is far from being satisfactory: we have *CamelCases*, *mixedCases* and *lower_case_with_underscores* all over the place. With the :ref:`Annot` as the first candidate, we have started an activity to clean this up step by step, converting to lower case with underscores for methods and attributes while keeping UPPERCASE for the constants. - Old names will remain available to prevent code breaks, but they will no longer be mentioned in the documentation. - New methods and attributes of all classes will be named according to the new standard. ------ **Changes in Version 1.18.3** As a major new feature, this version introduces support for PDF's **Optional Content** concept. * **Fixed** issue `#714 `_. * **Fixed** issue `#711 `_. * **Fixed** issue `#707 `_: if a PDF user password, but no owner password is supplied nor present, then the user password is also used as the owner password. * **Fixed** ``expand`` and ``deflate`` parameters of methods :meth:`Document.save` and :meth:`Document.write`. Individual image and font compression should now finally work. Addresses issue `#713 `_. * **Added** a support of PDF optional content. This includes several new :ref:`Document` methods for inquiring and setting optional content status and adding optional content configurations and groups. In addition, images, form XObjects and annotations now can be bound to optional content specifications. **Resolved** issue `#709 `_. ------ **Changes in Version 1.18.2** This version contains some interesting improvements for text searching: any number of search hits is now returned and the **hit_max** parameter was removed. The new **clip** parameter in addition allows to restrict the search area. Searching now detects hyphenations at line breaks and accordingly finds hyphenated words. * **Fixed** issue `#575 `_: if using ``quads=False`` in text searching, then overlapping rectangles on the same line are joined. Previously, parts of the search string, which belonged to different "marked content" items, each generated their own rectangle -- just as if occurring on separate lines. * **Added** :attr:`Document.isRepaired`, which is true if the PDF was repaired on open. * **Added** :meth:`Document.setXmlMetadata` which either updates or creates PDF XML metadata. Implements issue `#691 `_. * **Added** :meth:`Document.getXmlMetadata` returns PDF XML metadata. * **Changed** creation of PDF documents: they will now always carry a PDF identification (``/ID`` field) in the document trailer. Implements issue `#691 `_. * **Changed** :meth:`Page.searchFor`: a new parameter ``clip`` is accepted to restrict the search to this rectangle. Correspondingly, the attribute :attr:`TextPage.rect` is now respected by :meth:`TextPage.search`. * **Changed** parameter ``hit_max`` in :meth:`Page.searchFor` and :meth:`TextPage.search` is now obsolete: methods will return all hits. * **Changed** character **selection criteria** in :meth:`Page.getText`: a character is now considered to be part of a ``clip`` if its bbox is fully contained. Before this, a non-empty intersection was sufficient. * **Changed** :meth:`Document.scrub` to support a new option `redact_images`. This addresses issue `#697 `_. ------ **Changes in Version 1.18.1** * **Fixed** issue `#692 `_. PyMuPDF now detects and recovers from more cyclic resource dependencies in PDF pages and for the first time reports them in the MuPDF warnings store. * **Fixed** issue `#686 `_. * **Added** opacity options for the :ref:`Shape` class: Stroke and fill colors can now be set to some transparency value. This means that all :ref:`Page` draw methods, methods :meth:`Page.insertText`, :meth:`Page.insertTextbox`, :meth:`Shape.finish`, :meth:`Shape.insertText`, and :meth:`Shape.insertTextbox` support two new parameters: *stroke_opacity* and *fill_opacity*. * **Added** new parameter ``mask`` to :meth:`Page.insertImage` for optionally providing an external image mask. Resolves issue `#685 `_. * **Added** :meth:`Annot.soundGet` for extracting the sound of an audio annotation. ------ **Changes in Version 1.18.0** This is the first PyMuPDF version supporting MuPDF v1.18. The focus here is on extending PyMuPDF's own functionality -- apart from bug fixing. Subsequent PyMuPDF patches may address features new in MuPDF. * **Fixed** issue `#519 `_. This upstream bug occurred occasionally for some pages only and seems to be fixed now: page layout should no longer be ruined in these cases. * **Fixed** issue `#675 `_. - Unsuccessful storage allocations should now always lead to exceptions (circumvention of an upstream bug intermittently crashing the interpreter). - :ref:`Pixmap` size is now based on ``size_t`` instead of ``int`` in C and should be correct even for extremely large pixmaps. * **Fixed** issue `#668 `_. Specification of dashes for PDF drawing insertion should now correctly reflect the PDF spec. * **Fixed** issue `#669 `_. A major source of memory leakage in :meth:`Page.insert_pdf` has been removed. * **Added** keyword *"images"* to :meth:`Page.apply_redactions` for fine-controlling the handling of images. * **Added** :meth:`Annot.getText` and :meth:`Annot.getTextbox`, which offer the same functionality as the :ref:`Page` versions. * **Added** key *"number"* to the block dictionaries of :meth:`Page.getText` / :meth:`Annot.getText` for options "dict" and "rawdict". * **Added** :meth:`glyph_name_to_unicode` and :meth:`unicode_to_glyph_name`. Both functions do not really connect to a specific font and are now independently available, too. The data are now based on the `Adobe Glyph List `_. * **Added** convenience functions :meth:`adobe_glyph_names` and :meth:`adobe_glyph_unicodes` which return the respective available data. * **Added** :meth:`Page.getDrawings` which returns details of drawing operations on a document page. Works for all document types. * Improved performance of :meth:`Document.insert_pdf`. Multiple object copies are now also suppressed across multiple separate insertions from the same source. This saves time, memory and target file size. Previously this mechanism was only active within each single method execution. The feature can also be suppressed with the new method bool parameter *final=1*, which is the default. * For PNG images created from pixmaps, the resolution (dpi) is now automatically set from the respective :attr:`Pixmap.xres` and :attr:`Pixmap.yres` values. ------ **Changes in Version 1.17.7** * **Fixed** issue `#651 `_. An upstream bug causing interpreter crashes in corner case redaction processings was fixed by backporting MuPDF changes from their development repo. * **Fixed** issue `#645 `_. Pixmap top-left coordinates can be set (again) by their own method, :meth:`Pixmap.set_origin`. * **Fixed** issue `#622 `_. :meth:`Page.insertImage` again accepts a :data:`rect_like` parameter. * **Added** several new methods to improve and speed-up table of contents (TOC) handling. Among other things, TOC items can now changed or deleted individually -- without always replacing the complete TOC. Furthermore, access to some PDF page attributes is now possible without first **loading** the page. This has a very significant impact on the performance of TOC manipulation. * **Added** an option to :meth:`Document.insert_pdf` which allows displaying progress messages. Addresses `#640 `_. * **Added** :meth:`Page.getTextbox` which extracts text contained in a rectangle. In many cases, this should obsolete writing your own script for this type of thing. * **Added** new ``clip`` parameter to :meth:`Page.getText` to simplify and speed up text extraction of page sub areas. * **Added** :meth:`TextWriter.appendv` to add text in **vertical write mode**. Addresses issue `#653 `_ ------ **Changes in Version 1.17.6** * **Fixed** issue `#605 `_ * **Fixed** issue `#600 `_ -- text should now be correctly positioned also for pages with a CropBox smaller than MediaBox. * **Added** text span dictionary key ``origin`` which contains the lower left coordinate of the first character in that span. * **Added** attribute :attr:`Font.buffer`, a *bytes* copy of the font file. * **Added** parameter *sanitize* to :meth:`Page.cleanContents`. Allows switching of sanitization, so only syntax cleaning will be done. ------ **Changes in Version 1.17.5** * **Fixed** issue `#561 `_ -- second go: certain :ref:`TextWriter` usages with many alternating fonts did not work correctly. * **Fixed** issue `#566 `_. * **Fixed** issue `#568 `_. * **Fixed** -- opacity is now correctly taken from the :ref:`TextWriter` object, if not given in :meth:`TextWriter.writeText`. * **Added** a new global attribute :attr:`fitz_fontdescriptors`. Contains information about usable fonts from repository `pymupdf-fonts `_. * **Added** :meth:`Font.valid_codepoints` which returns an array of unicode codepoints for which the font has a glyph. * **Added** option ``text_as_path`` to :meth:`Page.getSVGimage`. this implements `#580 `_. Generates much smaller SVG files with parseable text if set to *False*. ------ **Changes in Version 1.17.4** * **Fixed** issue `#561 `_. Handling of more than 10 :ref:`Font` objects on one page should now work correctly. * **Fixed** issue `#562 `_. Annotation pixmaps are no longer derived from the page pixmap, thus avoiding unintended inclusion of page content. * **Fixed** issue `#559 `_. This **MuPDF** bug is being temporarily fixed with a pre-version of MuPDF's next release. * **Added** utility function :meth:`repair_mono_font` for correcting displayed character spacing for some mono-spaced fonts. * **Added** utility method :meth:`Document.need_appearances` for fine-controlling Form PDF behavior. Addresses issue `#563 `_. * **Added** utility function :meth:`sRGB_to_pdf` to recover the PDF color triple for a given color integer in sRGB format. * **Added** utility function :meth:`sRGB_to_rgb` to recover the (R, G, B) color triple for a given color integer in sRGB format. * **Added** utility function :meth:`make_table` which delivers table cells for a given rectangle and desired numbers of columns and rows. * **Added** support for optional fonts in repository `pymupdf-fonts `_. ------ **Changes in Version 1.17.3** * **Fixed** an undocumented issue, which prevented fully cleaning a PDF page when using :meth:`Page.cleanContents`. * **Fixed** issue `#540 `_. Text extraction for EPUB should again work correctly. * **Fixed** issue `#548 `_. Documentation now includes ``LINK_NAMED``. * **Added** new parameter to control start of text in :meth:`TextWriter.fillTextbox`. Implements `#549 `_. * **Changed** documentation of :meth:`Page.add_redact_annot` to explain the usage of non-builtin fonts. ------ **Changes in Version 1.17.2** * **Fixed** issue `#533 `_. * **Added** options to modify 'Redact' annotation appearance. Implements `#535 `_. ------ **Changes in Version 1.17.1** * **Fixed** issue `#520 `_. * **Fixed** issue `#525 `_. Vertices for 'Ink' annots should now be correct. * **Fixed** issue `#524 `_. It is now possible to query and set rotation for applicable annotation types. Also significantly improved inline documentation for better support of interactive help. ------ **Changes in Version 1.17.0** This version is based on MuPDF v1.17. Following are highlights of new and changed features: * **Added** extended language support for annotations and widgets: a mixture of Latin, Greece, Russian, Chinese, Japanese and Korean characters can now be used in 'FreeText' annotations and text widgets. No special arrangement is required to use it. * Faster page access is implemented for documents supporting a "chapter" structure. This applies to EPUB documents currently. This comes with several new :ref:`Document` methods and changes for :meth:`Document.loadPage` and the "indexed" page access *doc[n]*: In addition to specifying a page number as before, a tuple *(chapter, pno)* can be specified to identify the desired page. * **Changed:** Improved support of redaction annotations: images overlapped by redactions are **permanently modified** by erasing the overlap areas. Also links are removed if overlapped by redactions. This is now fully in sync with PDF specifications. Other changes: * **Changed** :meth:`TextWriter.writeText` to support the *"morph"* parameter. * **Added** methods :meth:`Rect.morph`, :meth:`IRect.morph`, and :meth:`Quad.morph`, which return a new :ref:`Quad`. * **Changed** :meth:`Page.add_freetext_annot` to support text alignment via a new *"align"* parameter. * **Fixed** issue `#508 `_. Improved image rectangle calculation to hopefully deliver correct values in most if not all cases. * **Fixed** issue `#502 `_. * **Fixed** issue `#500 `_. :meth:`Document.convertToPDF` should no longer cause memory leaks. * **Fixed** issue `#496 `_. Annotations and widgets / fields are now added or modified using the coordinates of the **unrotated page**. This behavior is now in sync with other methods modifying PDF pages. * **Added** :attr:`Page.rotationMatrix` and :attr:`Page.derotationMatrix` to support coordinate transformations between the rotated and the original versions of a PDF page. Potential code breaking changes: * The private method ``Page._getTransformation()`` has been removed. Use the public :attr:`Page.transformationMattrix` instead. ------ **Changes in Version 1.16.18** This version introduces several new features around PDF text output. The motivation is to simplify this task, while at the same time offering extending features. One major achievement is using MuPDF's capabilities to dynamically choosing fallback fonts whenever a character cannot be found in the current one. This seamlessly works for Base-14 fonts in combination with CJK fonts (China, Japan, Korea). So a text may contain **any combination of characters** from the Latin, Greek, Russian, Chinese, Japanese and Korean languages. * **Fixed** issue `#493 `_. ``Pixmap(doc, xref)`` should now again correctly resemble the loaded image object. * **Fixed** issue `#488 `_. Widget names are now modifiable. * **Added** new class :ref:`Font` which represents a font. * **Added** new class :ref:`TextWriter` which serves as a container for text to be written on a page. * **Added** :meth:`Page.writeText` to write one or more :ref:`TextWriter` objects to the page. ------ **Changes in Version 1.16.17** * **Fixed** issue `#479 `_. PyMuPDF should now more correctly report image resolutions. This applies to both, images (either from images files or extracted from PDF documents) and pixmaps created from images. * **Added** :meth:`Pixmap.set_dpi` which sets the image resolution in x and y directions. ------ **Changes in Version 1.16.16** * **Fixed** issue `#477 `_. * **Fixed** issue `#476 `_. * **Changed** annotation line end symbol coloring and fixed an error coloring the interior of 'Polyline' /'Polygon' annotations. ------ **Changes in Version 1.16.14** * **Changed** text marker annotations to accept parameters beyond just quadrilaterals such that now **text lines between two given points can be marked**. * **Added** :meth:`Document.scrub` which **removes potentially sensitive data** from a PDF. Implements `#453 `_. * **Added** :meth:`Annot.blendMode` which returns the **blend mode** of annotations. * **Added** :meth:`Annot.setBlendMode` to set the annotation's blend mode. This resolves issue `#416 `_. * **Changed** :meth:`Annot.update` to accept additional parameters for setting blend mode and opacity. * **Added** advanced graphics features to **control the anti-aliasing values**, :meth:`Tools.set_aa_level`. Resolves `#467 `_ * **Fixed** issue `#474 `_. * **Fixed** issue `#466 `_. ------ **Changes in Version 1.16.13** * **Added** :meth:`Document.getPageXObjectList` which returns a list of **Form XObjects** of the page. * **Added** :meth:`Page.setMediaBox` for changing the physical PDF page size. * **Added** :ref:`Page` methods which have been internal before: :meth:`Page.cleanContents` (= :meth:`Page._cleanContents`), :meth:`Page.getContents` (= :meth:`Page._getContents`), :meth:`Page.getTransformation` (= :meth:`Page._getTransformation`). ------ **Changes in Version 1.16.12** * **Fixed** issue `#447 `_ * **Fixed** issue `#461 `_. * **Fixed** issue `#397 `_. * **Fixed** issue `#463 `_. * **Added** JavaScript support to PDF form fields, thereby fixing `#454 `_. * **Added** a new annotation method :meth:`Annot.delete_responses`, which removes 'Popup' and response annotations referring to the current one. Mainly serves data protection purposes. * **Added** a new form field method :meth:`Widget.reset`, which resets the field value to its default. * **Changed** and extended handling of redactions: images and XObjects are removed if *contained* in a redaction rectangle. Any partial only overlaps will just be covered by the redaction background color. Now an *overlay* text can be specified to be inserted in the rectangle area to **take the place the deleted original** text. This resolves `#434 `_. ------ **Changes in Version 1.16.11** * **Added** Support for redaction annotations via method :meth:`Page.add_redact_annot` and :meth:`Page.apply_redactions`. * **Fixed** issue #426 ("PolygonAnnotation in 1.16.10 version"). * **Fixed** documentation only issues `#443 `_ and `#444 `_. ------ **Changes in Version 1.16.10** * **Fixed** issue #421 ("annot.set_rect(rect) has no effect on text Annotation") * **Fixed** issue #417 ("Strange behavior for page.deleteAnnot on 1.16.9 compare to 1.13.20") * **Fixed** issue #415 ("Annot.setOpacity throws mupdf warnings") * **Changed** all "add annotation / widget" methods to store a unique name in the */NM* PDF key. * **Changed** :meth:`Annot.setInfo` to also accept direct parameters in addition to a dictionary. * **Changed** :attr:`Annot.info` to now also show the annotation's unique id (*/NM* PDF key) if present. * **Added** :meth:`Page.annot_names` which returns a list of all annotation names (*/NM* keys). * **Added** :meth:`Page.load_annot` which loads an annotation given its unique id (*/NM* key). * **Added** :meth:`Document.reload_page` which provides a new copy of a page after finishing any pending updates to it. ------ **Changes in Version 1.16.9** * **Fixed** #412 ("Feature Request: Allow controlling whether TOC entries should be collapsed") * **Fixed** #411 ("Seg Fault with page.firstWidget") * **Fixed** #407 ("Annot.setOpacity trouble") * **Changed** methods :meth:`Annot.setBorder`, :meth:`Annot.setColors`, :meth:`Link.setBorder`, and :meth:`Link.setColors` to also accept direct parameters, and not just cumbersome dictionaries. ------ **Changes in Version 1.16.8** * **Added** several new methods to the :ref:`Document` class, which make dealing with PDF low-level structures easier. I also decided to provide them as "normal" methods (as opposed to private ones starting with an underscore "_"). These are :meth:`Document.xrefObject`, :meth:`Document.xrefStream`, :meth:`Document.xrefStreamRaw`, :meth:`Document.PDFTrailer`, :meth:`Document.PDFCatalog`, :meth:`Document.metadataXML`, :meth:`Document.updateObject`, :meth:`Document.updateStream`. * **Added** :meth:`Tools.mupdf_disply_errors` which sets the display of mupdf errors on *sys.stderr*. * **Added** a commandline facility. This a major new feature: you can now invoke several utility functions via *"python -m fitz ..."*. It should obsolete the need for many of the most trivial scripts. Please refer to :ref:`Module`. ------ **Changes in Version 1.16.7** Minor changes to better synchronize the binary image streams of :ref:`TextPage` image blocks and :meth:`Document.extractImage` images. * **Fixed** issue #394 ("PyMuPDF Segfaults when using TOOLS.mupdf_warnings()"). * **Changed** redirection of MuPDF error messages: apart from writing them to Python *sys.stderr*, they are now also stored with the MuPDF warnings. * **Changed** :meth:`Tools.mupdf_warnings` to automatically empty the store (if not deactivated via a parameter). * **Changed** :meth:`Page.getImageBbox` to return an **infinite rectangle** if the image could not be located on the page -- instead of raising an exception. ------ **Changes in Version 1.16.6** * **Fixed** issue #390 ("Incomplete deletion of annotations"). * **Changed** :meth:`Page.searchFor` / :meth:`Document.searchPageFor` to also support the *flags* parameter, which controls the data included in a :ref:`TextPage`. * **Changed** :meth:`Document.getPageImageList`, :meth:`Document.getPageFontList` and their :ref:`Page` counterparts to support a new parameter *full*. If true, the returned items will contain the :data:`xref` of the *Form XObject* where the font or image is referenced. ------ **Changes in Version 1.16.5** More performance improvements for text extraction. * **Fixed** second part of issue #381 (see item in v1.16.4). * **Added** :meth:`Page.getTextPage`, so it is no longer required to create an intermediate display list for text extractions. Page level wrappers for text extraction and text searching are now based on this, which should improve performance by ca. 5%. ------ **Changes in Version 1.16.4** * **Fixed** issue #381 ("TextPage.extractDICT ... failed ... after upgrading ... to 1.16.3") * **Added** method :meth:`Document.pages` which delivers a generator iterator over a page range. * **Added** method :meth:`Page.links` which delivers a generator iterator over the links of a page. * **Added** method :meth:`Page.annots` which delivers a generator iterator over the annotations of a page. * **Added** method :meth:`Page.widgets` which delivers a generator iterator over the form fields of a page. * **Changed** :attr:`Document.is_form_pdf` to now contain the number of widgets, and *False* if not a PDF or this number is zero. ------ **Changes in Version 1.16.3** Minor changes compared to version 1.16.2. The code of the "dict" and "rawdict" variants of :meth:`Page.getText` has been ported to C which has greatly improved their performance. This improvement is mostly noticeable with text-oriented documents, where they now should execute almost two times faster. * **Fixed** issue #369 ("mupdf: cmsCreateTransform failed") by removing ICC colorspace support. * **Changed** :meth:`Page.getText` to accept additional keywords "blocks" and "words". These will deliver the results of :meth:`Page.getTextBlocks` and :meth:`Page.getTextWords`, respectively. So all text extraction methods are now available via a uniform API. Correspondingly, there are now new methods :meth:`TextPage.extractBLOCKS` and :meth:`TextPage.extractWords`. * **Changed** :meth:`Page.getText` to default bit indicator *TEXT_INHIBIT_SPACES* to **off**. Insertion of additional spaces is **not suppressed** by default. ------ **Changes in Version 1.16.2** * **Changed** text extraction methods of :ref:`Page` to allow detail control of the amount of extracted data. * **Added** :meth:`planish_line` which maps a given line (defined as a pair of points) to the x-axis. * **Fixed** an issue (w/o Github number) which brought down the interpreter when encountering certain non-UTF-8 encodable characters while using :meth:`Page.getText` with the "dict" option. * **Fixed** issue #362 ("Memory Leak with getText('rawDICT')"). ------ **Changes in Version 1.16.1** * **Added** property :attr:`Quad.is_convex` which checks whether a line is contained in the quad if it connects two points of it. * **Changed** :meth:`Document.insert_pdf` to now allow dropping or including links and annotations independently during the copy. Fixes issue #352 ("Corrupt PDF data and ..."), which seemed to intermittently occur when using the method for some problematic PDF files. * **Fixed** a bug which, in matrix division using the syntax *"m1/m2"*, caused matrix *"m1"* to be **replaced** by the result instead of delivering a new matrix. * **Fixed** issue #354 ("SyntaxWarning with Python 3.8"). We now always use *"=="* for literals (instead of the *"is"* Python keyword). * **Fixed** issue #353 ("mupdf version check"), to no longer refuse the import when there are only patch level deviations from MuPDF. ------ **Changes in Version 1.16.0** This major new version of MuPDF comes with several nice new or changed features. Some of them imply programming API changes, however. This is a synopsis of what has changed: * PDF document encryption and decryption is now **fully supported**. This includes setting **permissions**, **passwords** (user and owner passwords) and the desired encryption method. * In response to the new encryption features, PyMuPDF returns an integer (ie. a combination of bits) for document permissions, and no longer a dictionary. * Redirection of MuPDF errors and warnings is now natively supported. PyMuPDF redirects error messages from MuPDF to *sys.stderr* and no longer buffers them. Warnings continue to be buffered and will not be displayed. Functions exist to access and reset the warnings buffer. * Annotations are now **only supported for PDF**. * Annotations and widgets (form fields) are now **separate object chains** on a page (although widgets technically still **are** PDF annotations). This means, that you will **never encounter widgets** when using :attr:`Page.firstAnnot` or :meth:`Annot.next`. You must use :attr:`Page.firstWidget` and :meth:`Widget.next` to access form fields. * As part of MuPDF's changes regarding widgets, only the following four fonts are supported, when **adding** or **changing** form fields: **Courier, Helvetica, Times-Roman** and **ZapfDingBats**. List of change details: * **Added** :meth:`Document.can_save_incrementally` which checks conditions that are preventing use of option *incremental=True* of :meth:`Document.save`. * **Added** :attr:`Page.firstWidget` which points to the first field on a page. * **Added** :meth:`Page.getImageBbox` which returns the rectangle occupied by an image shown on the page. * **Added** :meth:`Annot.setName` which lets you change the (icon) name field. * **Added** outputting the text color in :meth:`Page.getText`: the *"dict"*, *"rawdict"* and *"xml"* options now also show the color in sRGB format. * **Changed** :attr:`Document.permissions` to now contain an integer of bool indicators -- was a dictionary before. * **Changed** :meth:`Document.save`, :meth:`Document.write`, which now fully support password-based decryption and encryption of PDF files. * **Changed the names of all Python constants** related to annotations and widgets. Please make sure to consult the **Constants and Enumerations** chapter if your script is dealing with these two classes. This decision goes back to the dropped support for non-PDF annotations. The **old names** (starting with "ANNOT_*" or "WIDGET_*") will be available as deprecated synonyms. * **Changed** font support for widgets: only *Cour* (Courier), *Helv* (Helvetica, default), *TiRo* (Times-Roman) and *ZaDb* (ZapfDingBats) are accepted when **adding or changing** form fields. Only the plain versions are possible -- not their italic or bold variations. **Reading** widgets, however will show its original font. * **Changed** the name of the warnings buffer to :meth:`Tools.mupdf_warnings` and the function to empty this buffer is now called :meth:`Tools.reset_mupdf_warnings`. * **Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap`: a new bool argument *annots* can now be used to **suppress the rendering of annotations** on the page. * **Changed** :meth:`Page.add_file_annot` and :meth:`Page.add_text_annot` to enable setting an icon. * **Removed** widget-related methods and attributes from the :ref:`Annot` object. * **Removed** :ref:`Document` attributes *openErrCode*, *openErrMsg*, and :ref:`Tools` attributes / methods *stderr*, *reset_stderr*, *stdout*, and *reset_stdout*. * **Removed** **thirdparty zlib** dependency in PyMuPDF: there are now compression functions available in MuPDF. Source installers of PyMuPDF may now omit this extra installation step. **No version published for MuPDF v1.15.0** ------ **Changes in Version 1.14.20 / 1.14.21** * **Changed** text marker annotations to support multiple rectangles / quadrilaterals. This fixes issue #341 ("Question : How to addhighlight so that a string spread across more than a line is covered by one highlight?") and similar (#285). * **Fixed** issue #331 ("Importing PyMuPDF changes warning filtering behaviour globally"). ------ **Changes in Version 1.14.19** * **Fixed** issue #319 ("InsertText function error when use custom font"). * **Added** new method :meth:`Document.get_sigflags` which returns information on whether a PDF is signed. Resolves issue #326 ("How to detect signature in a form pdf?"). ------ **Changes in Version 1.14.17** * **Added** :meth:`Document.fullcopyPage` to make full page copies within a PDF (not just copied references as :meth:`Document.copyPage` does). * **Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap` now use *alpha=False* as default. * **Changed** text extraction: the span dictionary now (again) contains its rectangle under the *bbox* key. * **Changed** :meth:`Document.movePage` and :meth:`Document.copyPage` to use direct functions instead of wrapping :meth:`Document.select` -- similar to :meth:`Document.delete_page` in v1.14.16. ------ **Changes in Version 1.14.16** * **Changed** :ref:`Document` methods around PDF */EmbeddedFiles* to no longer use MuPDF's "portfolio" functions. That support will be dropped in MuPDF v1.15 -- therefore another solution was required. * **Changed** :meth:`Document.embfile_Count` to be a function (was an attribute). * **Added** new method :meth:`Document.embfile_Names` which returns a list of names of embedded files. * **Changed** :meth:`Document.delete_page` and :meth:`Document.delete_pages` to internally no longer use :meth:`Document.select`, but instead use functions to perform the deletion directly. As it has turned out, the :meth:`Document.select` method yields invalid outline trees (tables of content) for very complex PDFs and sophisticated use of annotations. ------ **Changes in Version 1.14.15** * **Fixed** issues #301 ("Line cap and Line join"), #300 ("How to draw a shape without outlines") and #298 ("utils.updateRect exception"). These bugs pertain to drawing shapes with PyMuPDF. Drawing shapes without any border is fully supported. Line cap styles and line line join style are now differentiated and support all possible PDF values (0, 1, 2) instead of just being a bool. The previous parameter *roundCap* is deprecated in favor of *lineCap* and *lineJoin* and will be deleted in the next release. * **Fixed** issue #290 ("Memory Leak with getText('rawDICT')"). This bug caused memory not being (completely) freed after invoking the "dict", "rawdict" and "json" versions of :meth:`Page.getText`. ------ **Changes in Version 1.14.14** * **Added** new low-level function :meth:`ImageProperties` to determine a number of characteristics for an image. * **Added** new low-level function :meth:`Document.is_stream`, which checks whether an object is of stream type. * **Changed** low-level functions :meth:`Document._getXrefString` and :meth:`Document._getTrailerString` now by default return object definitions in a formatted form which makes parsing easy. ------ **Changes in Version 1.14.13** * **Changed** methods working with binary input: while ever supporting bytes and bytearray objects, they now also accept *io.BytesIO* input, using their *getvalue()* method. This pertains to document creation, embedded files, FileAttachment annotations, pixmap creation and others. Fixes issue #274 ("Segfault when using BytesIO as a stream for insertImage"). * **Fixed** issue #278 ("Is insertImage(keep_proportion=True) broken?"). Images are now correctly presented when keeping aspect ratio. ------ **Changes in Version 1.14.12** * **Changed** the draw methods of :ref:`Page` and :ref:`Shape` to support not only RGB, but also GRAY and CMYK colorspaces. This solves issue #270 ("Is there a way to use CMYK color to draw shapes?"). This change also applies to text insertion methods of :ref:`Shape`, resp. :ref:`Page`. * **Fixed** issue #269 ("AttributeError in Document.insert_page()"), which occurred when using :meth:`Document.insert_page` with text insertion. ------ **Changes in Version 1.14.11** * **Changed** :meth:`Page.show_pdf_page` to always position the source rectangle centered in the target. This method now also supports **rotation by arbitrary angles**. The argument *reuse_xref* has been deprecated: prevention of duplicates is now **handled internally**. * **Changed** :meth:`Page.insertImage` to support rotated display of the image and keeping the aspect ratio. Only rotations by multiples of 90 degrees are supported here. * **Fixed** issue #265 ("TypeError: insertText() got an unexpected keyword argument 'idx'"). This issue only occurred when using :meth:`Document.insert_page` with also inserting text. ------ **Changes in Version 1.14.10** * **Changed** :meth:`Page.show_pdf_page` to support rotation of the source rectangle. Fixes #261 ("Cannot rotate inserted pages"). * **Fixed** a bug in :meth:`Page.insertImage` which prevented insertion of multiple images provided as streams. ------ **Changes in Version 1.14.9** * **Added** new low-level method :meth:`Document._getTrailerString`, which returns the trailer object of a PDF. This is much like :meth:`Document._getXrefString` except that the PDF trailer has no / needs no :data:`xref` to identify it. * **Added** new parameters for text insertion methods. You can now set stroke and fill colors of glyphs (text characters) independently, as well as the thickness of the glyph border. A new parameter *render_mode* controls the use of these colors, and whether the text should be visible at all. * **Fixed** issue #258 ("Copying image streams to new PDF without size increase"): For JPX images embedded in a PDF, :meth:`Document.extractImage` will now return them in their original format. Previously, the MuPDF base library was used, which returns them in PNG format (entailing a massive size increase). * **Fixed** issue #259 ("Morphing text to fit inside rect"). Clarified use of :meth:`get_text_length` and removed extra line breaks for long words. ------ **Changes in Version 1.14.8** * **Added** :meth:`Pixmap.set_rect` to change the pixel values in a rectangle. This is also an alternative to setting the color of a complete pixmap (:meth:`Pixmap.clear_with`). * **Fixed** an image extraction issue with JBIG2 (monochrome) encoded PDF images. The issue occurred in :meth:`Page.getText` (parameters "dict" and "rawdict") and in :meth:`Document.extractImage` methods. * **Fixed** an issue with not correctly clearing a non-alpha :ref:`Pixmap` (:meth:`Pixmap.clear_with`). * **Fixed** an issue with not correctly inverting colors of a non-alpha :ref:`Pixmap` (:meth:`Pixmap.invert_irect`). ------ **Changes in Version 1.14.7** * **Added** :meth:`Pixmap.set_pixel` to change one pixel value. * **Added** documentation for image conversion in the :ref:`FAQ`. * **Added** new function :meth:`get_text_length` to determine the string length for a given font. * **Added** Postscript image output (changed :meth:`Pixmap.save` and :meth:`Pixmap.tobytes`). * **Changed** :meth:`Pixmap.save` and :meth:`Pixmap.tobytes` to ensure valid combinations of colorspace, alpha and output format. * **Changed** :meth:`Pixmap.save`: the desired format is now inferred from the filename. * **Changed** FreeText annotations can now have a transparent background - see :meth:`Annot.update`. ------ **Changes in Version 1.14.5** * **Changed:** :ref:`Shape` methods now strictly use the transformation matrix of the :ref:`Page` -- instead of "manually" calculating locations. * **Added** method :meth:`Pixmap.pixel` which returns the pixel value (a list) for given pixel coordinates. * **Added** method :meth:`Pixmap.tobytes` which returns a bytes object representing the pixmap in a variety of formats. Previously, this could be done for PNG outputs only (:meth:`Pixmap.tobytes`). * **Changed:** output of methods :meth:`Pixmap.save` and (the new) :meth:`Pixmap.tobytes` may now also be PSD (Adobe Photoshop Document). * **Added** method :meth:`Shape.drawQuad` which draws a :ref:`Quad`. This actually is a shorthand for a :meth:`Shape.drawPolyline` with the edges of the quad. * **Changed** method :meth:`Shape.drawOval`: the argument can now be **either** a rectangle (:data:`rect_like`) **or** a quadrilateral (:data:`quad_like`). ------ **Changes in Version 1.14.4** * **Fixes** issue #239 "Annotation coordinate consistency". ------ **Changes in Version 1.14.3** This patch version contains minor bug fixes and CJK font output support. * **Added** support for the four CJK fonts as PyMuPDF generated text output. This pertains to methods :meth:`Page.insertFont`, :meth:`Shape.insertText`, :meth:`Shape.insertTextbox`, and corresponding :ref:`Page` methods. The new fonts are available under "reserved" fontnames "china-t" (traditional Chinese), "china-s" (simplified Chinese), "japan" (Japanese), and "korea" (Korean). * **Added** full support for the built-in fonts 'Symbol' and 'Zapfdingbats'. * **Changed:** The 14 standard fonts can now each be referenced by a 4-letter abbreviation. ------ **Changes in Version 1.14.1** This patch version contains minor performance improvements. * **Added** support for :ref:`Document` filenames given as *pathlib* object by using the Python *str()* function. ------ **Changes in Version 1.14.0** To support MuPDF v1.14.0, massive changes were required in PyMuPDF -- most of them purely technical, with little visibility to developers. But there are also quite a lot of interesting new and improved features. Following are the details: * **Added** "ink" annotation. * **Added** "rubber stamp" annotation. * **Added** "squiggly" text marker annotation. * **Added** new class :ref:`Quad` (quadrilateral or tetragon) -- which represents a general four-sided shape in the plane. The special subtype of rectangular, non-empty tetragons is used in text marker annotations and as returned objects in text search methods. * **Added** a new option "decrypt" to :meth:`Document.save` and :meth:`Document.write`. Now you can **keep encryption** when saving a password protected PDF. * **Added** suppression and redirection of unsolicited messages issued by the underlying C-library MuPDF. Consult :ref:`RedirectMessages` for details. * **Changed:** Changes to annotations now **always require** :meth:`Annot.update` to become effective. * **Changed** free text annotations to support the full Latin character set and range of appearance options. * **Changed** text searching, :meth:`Page.searchFor`, to optionally return :ref:`Quad` instead :ref:`Rect` objects surrounding each search hit. * **Changed** plain text output: we now add a *\n* to each line if it does not itself end with this character. * **Fixed** issue 211 ("Something wrong in the doc"). * **Fixed** issue 213 ("Rewritten outline is displayed only by mupdf-based applications"). * **Fixed** issue 214 ("PDF decryption GONE!"). * **Fixed** issue 215 ("Formatting of links added with pyMuPDF"). * **Fixed** issue 217 ("extraction through json is failing for my pdf"). Behind the curtain, we have changed the implementation of geometry objects: they now purely exist in Python and no longer have "shadow" twins on the C-level (in MuPDF). This has improved processing speed in that area by more than a factor of two. Because of the same reason, most methods involving geometry parameters now also accept the corresponding Python sequence. For example, in method *"page.show_pdf_page(rect, ...)"* parameter *rect* may now be any :data:`rect_like` sequence. We also invested considerable effort to further extend and improve the :ref:`FAQ` chapter. ------ **Changes in Version 1.13.19** This version contains some technical / performance improvements and bug fixes. * **Changed** memory management: for Python 3 builds, Python memory management is exclusively used across all C-level code (i.e. no more native *malloc()* in MuPDF code or PyMuPDF interface code). This leads to improved memory usage profiles and also some runtime improvements: we have seen > 2% shorter runtimes for text extractions and pixmap creations (on Windows machines only to date). * **Fixed** an error occurring in Python 2.7, which crashed the interpreter when using :meth:`TextPage.extractRAWDICT` (= *Page.getText("rawdict")*). * **Fixed** an error occurring in Python 2.7, when creating link destinations. * **Extended** the :ref:`FAQ` chapter with more examples. ------ **Changes in Version 1.13.18** * **Added** method :meth:`TextPage.extractRAWDICT`, and a corresponding new string parameter "rawdict" to method :meth:`Page.getText`. It extracts text and images from a page in Python *dict* form like :meth:`TextPage.extractDICT`, but with the detail level of :meth:`TextPage.extractXML`, which is position information down to each single character. ------ **Changes in Version 1.13.17** * **Fixed** an error that intermittently caused an exception in :meth:`Page.show_pdf_page`, when pages from many different source PDFs were shown. * **Changed** method :meth:`Document.extractImage` to now return more meta information about the extracted image. Also, its performance has been greatly improved. Several demo scripts have been changed to make use of this method. * **Changed** method :meth:`Document._getXrefStream` to now return *None* if the object is no stream and no longer raise an exception if otherwise. * **Added** method :meth:`Document._deleteObject` which deletes a PDF object identified by its :data:`xref`. Only to be used by the experienced PDF expert. * **Added** a method :meth:`paper_rect` which returns a :ref:`Rect` for a supplied paper format string. Example: *fitz.paper_rect("letter") = fitz.Rect(0.0, 0.0, 612.0, 792.0)*. * **Added** a :ref:`FAQ` chapter to this document. ------ **Changes in Version 1.13.16** * **Added** support for correctly setting transparency (opacity) for certain annotation types. * **Added** a tool property (:attr:`Tools.fitz_config`) showing the configuration of this PyMuPDF version. * **Fixed** issue #193 ('insertText(overlay=False) gives "cannot resize a buffer with shared storage" error') by avoiding read-only buffers. ------ **Changes in Version 1.13.15** * **Fixed** issue #189 ("cannot find builtin CJK font"), so we are supporting builtin CJK fonts now (CJK = China, Japan, Korea). This should lead to correctly generated pixmaps for documents using these languages. This change has consequences for our binary file size: it will now range between 8 and 10 MB, depending on the OS. * **Fixed** issue #191 ("Jupyter notebook kernel dies after ca. 40 pages"), which occurred when modifying the contents of an annotation. ------ **Changes in Version 1.13.14** This patch version contains several improvements, mainly for annotations. * **Changed** :attr:`Annot.lineEnds` is now a list of two integers representing the line end symbols. Previously was a *dict* of strings. * **Added** support of line end symbols for applicable annotations. PyMuPDF now can generate these annotations including the line end symbols. * **Added** :meth:`Annot.setLineEnds` adds line end symbols to applicable annotation types ('Line', 'PolyLine', 'Polygon'). * **Changed** technical implementation of :meth:`Page.insertImage` and :meth:`Page.show_pdf_page`: they now create there own contents objects, thereby avoiding changes of potentially large streams with consequential compression / decompression efforts and high change volumes with incremental updates. ------ **Changes in Version 1.13.13** This patch version contains several improvements for embedded files and file attachment annotations. * **Added** :meth:`Document.embfile_Upd` which allows changing **file content and metadata** of an embedded file. It supersedes the old method :meth:`Document.embfile_SetInfo` (which will be deleted in a future version). Content is automatically compressed and metadata may be unicode. * **Changed** :meth:`Document.embfile_Add` to now automatically compress file content. Accompanying metadata can now be unicode (had to be ASCII in the past). * **Changed** :meth:`Document.embfile_Del` to now automatically delete **all entries** having the supplied identifying name. The return code is now an integer count of the removed entries (was *None* previously). * **Changed** embedded file methods to now also accept or show the PDF unicode filename as additional parameter *ufilename*. * **Added** :meth:`Page.add_file_annot` which adds a new file attachment annotation. * **Changed** :meth:`Annot.fileUpd` (file attachment annot) to now also accept the PDF unicode *ufilename* parameter. The description parameter *desc* correctly works with unicode. Furthermore, **all** parameters are optional, so metadata may be changed without also replacing the file content. * **Changed** :meth:`Annot.fileInfo` (file attachment annot) to now also show the PDF unicode filename as parameter *ufilename*. * **Fixed** issue #180 ("page.getText(output='dict') return invalid bbox") to now also work for vertical text. * **Fixed** issue #185 ("Can't render the annotations created by PyMuPDF"). The issue's cause was the minimalistic MuPDF approach when creating annotations. Several annotation types have no */AP* ("appearance") object when created by MuPDF functions. MuPDF, SumatraPDF and hence also PyMuPDF cannot render annotations without such an object. This fix now ensures, that an appearance object is always created together with the annotation itself. We still do not support line end styles. ------ **Changes in Version 1.13.12** * **Fixed** issue #180 ("page.getText(output='dict') return invalid bbox"). Note that this is a circumvention of an MuPDF error, which generates zero-height character rectangles in some cases. When this happens, this fix ensures a bbox height of at least fontsize. * **Changed** for ListBox and ComboBox widgets, the attribute list of selectable values has been renamed to :attr:`Widget.choice_values`. * **Changed** when adding widgets, any missing of the :ref:`Base-14-Fonts` is automatically added to the PDF. Widget text fonts can now also be chosen from existing widget fonts. Any specified field values are now honored and lead to a field with a preset value. * **Added** :meth:`Annot.updateWidget` which allows changing existing form fields -- including the field value. ------ **Changes in Version 1.13.11** While the preceding patch subversions only contained various fixes, this version again introduces major new features: * **Added** basic support for PDF widget annotations. You can now add PDF form fields of types Text, CheckBox, ListBox and ComboBox. Where necessary, the PDF is transformed to a Form PDF with the first added widget. * **Fixed** issues #176 ("wrong file embedding"), #177 ("segment fault when invoking page.getText()")and #179 ("Segmentation fault using page.getLinks() on encrypted PDF"). ------ **Changes in Version 1.13.7** * **Added** support of variable page sizes for reflowable documents (e-books, HTML, etc.): new parameters *rect* and *fontsize* in :ref:`Document` creation (open), and as a separate method :meth:`Document.layout`. * **Added** :ref:`Annot` creation of many annotations types: sticky notes, free text, circle, rectangle, line, polygon, polyline and text markers. * **Added** support of annotation transparency (:attr:`Annot.opacity`, :meth:`Annot.setOpacity`). * **Changed** :attr:`Annot.vertices`: point coordinates are now grouped as pairs of floats (no longer as separate floats). * **Changed** annotation colors dictionary: the two keys are now named *"stroke"* (formerly *"common"*) and *"fill"*. * **Added** :attr:`Document.isDirty` which is *True* if a PDF has been changed in this session. Reset to *False* on each :meth:`Document.save` or :meth:`Document.write`. ------ **Changes in Version 1.13.6** * Fix #173: for memory-resident documents, ensure the stream object will not be garbage-collected by Python before document is closed. ------ **Changes in Version 1.13.5** * New low-level method :meth:`Page._setContents` defines an object given by its :data:`xref` to serve as the :data:`contents` object. * Changed and extended PDF form field support: the attribute *widget_text* has been renamed to :attr:`Annot.widget_value`. Values of all form field types (except signatures) are now supported. A new attribute :attr:`Annot.widget_choices` contains the selectable values of listboxes and comboboxes. All these attributes now contain *None* if no value is present. ------ **Changes in Version 1.13.4** * :meth:`Document.convertToPDF` now supports page ranges, reverted page sequences and page rotation. If the document already is a PDF, an exception is raised. * Fixed a bug (introduced with v1.13.0) that prevented :meth:`Page.insertImage` for transparent images. ------ **Changes in Version 1.13.3** Introduces a way to convert **any MuPDF supported document** to a PDF. If you ever wanted PDF versions of your XPS, EPUB, CBZ or FB2 files -- here is a way to do this. * :meth:`Document.convertToPDF` returns a Python *bytes* object in PDF format. Can be opened like normal in PyMuPDF, or be written to disk with the *".pdf"* extension. ------ **Changes in Version 1.13.2** The major enhancement is PDF form field support. Form fields are annotations of type *(19, 'Widget')*. There is a new document method to check whether a PDF is a form. The :ref:`Annot` class has new properties describing field details. * :attr:`Document.is_form_pdf` is true if object type */AcroForm* and at least one form field exists. * :attr:`Annot.widget_type`, :attr:`Annot.widget_text` and :attr:`Annot.widget_name` contain the details of a form field (i.e. a "Widget" annotation). ------ **Changes in Version 1.13.1** * :meth:`TextPage.extractDICT` is a new method to extract the contents of a document page (text and images). All document types are supported as with the other :ref:`TextPage` *extract*()* methods. The returned object is a dictionary of nested lists and other dictionaries, and **exactly equal** to the JSON-deserialization of the old :meth:`TextPage.extractJSON`. The difference is that the result is created directly -- no JSON module is used. Because the user needs no JSON module to interpret the information, it should be easier to use, and also have a better performance, because it contains images in their original **binary format** -- they need not be base64-decoded. * :meth:`Page.getText` correspondingly supports the new parameter value *"dict"* to invoke the above method. * :meth:`TextPage.extractJSON` (resp. *Page.getText("json")*) is still supported for convenience, but its use is expected to decline. ------ **Changes in Version 1.13.0** This version is based on MuPDF v1.13.0. This release is "primarily a bug fix release". In PyMuPDF, we are also doing some bug fixes while introducing minor enhancements. There only very minimal changes to the user's API. * :ref:`Document` construction is more flexible: the new *filetype* parameter allows setting the document type. If specified, any extension in the filename will be ignored. More completely addresses `issue #156 `_. As part of this, the documentation has been reworked. * Changes to :ref:`Pixmap` constructors: - Colorspace conversion no longer allows dropping the alpha channel: source and target **alpha will now always be the same**. We have seen exceptions and even interpreter crashes when using *alpha = 0*. - As a replacement, the simple pixmap copy lets you choose the target alpha. * :meth:`Document.save` again offers the full garbage collection range 0 thru 4. Because of a bug in :data:`xref` maintenance, we had to temporarily enforce *garbage > 1*. Finally resolves `issue #148 `_. * :meth:`Document.save` now offers to "prettify" PDF source via an additional argument. * :meth:`Page.insertImage` has the additional *stream* \-parameter, specifying a memory area holding an image. * Issue with garbled PNGs on Linux systems has been resolved (`"Problem writing PNG" #133) `_. ------ **Changes in Version 1.12.4** This is an extension of 1.12.3. * Fix of `issue #147 `_: methods :meth:`Document.getPageFontlist` and :meth:`Document.getPageImagelist` now also show fonts and images contained in :data:`resources` nested via "Form XObjects". * Temporary fix of `issue #148 `_: Saving to new PDF files will now automatically use *garbage = 2* if a lower value is given. Final fix is to be expected with MuPDF's next version. At that point we will remove this circumvention. * Preventive fix of illegally using stencil / image mask pixmaps in some methods. * Method :meth:`Document.getPageFontlist` now includes the encoding name for each font in the list. * Method :meth:`Document.getPageImagelist` now includes the decode method name for each image in the list. ------ **Changes in Version 1.12.3** This is an extension of 1.12.2. * Many functions now return *None* instead of *0*, if the result has no other meaning than just indicating successful execution (:meth:`Document.close`, :meth:`Document.save`, :meth:`Document.select`, :meth:`Pixmap.save` and many others). ------ **Changes in Version 1.12.2** This is an extension of 1.12.1. * Method :meth:`Page.show_pdf_page` now accepts the new *clip* argument. This specifies an area of the source page to which the display should be restricted. * New :attr:`Page.CropBox` and :attr:`Page.MediaBox` have been included for convenience. ------ **Changes in Version 1.12.1** This is an extension of version 1.12.0. * New method :meth:`Page.show_pdf_page` displays another's PDF page. This is a **vector** image and therefore remains precise across zooming. Both involved documents must be PDF. * New method :meth:`Page.getSVGimage` creates an SVG image from the page. In contrast to the raster image of a pixmap, this is a vector image format. The return is a unicode text string, which can be saved in a *.svg* file. * Method :meth:`Page.getTextBlocks` now accepts an additional bool parameter "images". If set to true (default is false), image blocks (metadata only) are included in the produced list and thus allow detecting areas with rendered images. * Minor bug fixes. * "text" result of :meth:`Page.getText` concatenates all lines within a block using a single space character. MuPDF's original uses "\\n" instead, producing a rather ragged output. * New properties of :ref:`Page` objects :attr:`Page.MediaBoxSize` and :attr:`Page.CropBoxPosition` provide more information about a page's dimensions. For non-PDF files (and for most PDF files, too) these will be equal to :attr:`Page.rect.bottom_right`, resp. :attr:`Page.rect.top_left`. For example, class :ref:`Shape` makes use of them to correctly position its items. ------ **Changes in Version 1.12.0** This version is based on and requires MuPDF v1.12.0. The new MuPDF version contains quite a number of changes -- most of them around text extraction. Some of the changes impact the programmer's API. * :meth:`Outline.saveText` and :meth:`Outline.saveXML` have been deleted without replacement. You probably haven't used them much anyway. But if you are looking for a replacement: the output of :meth:`Document.get_toc` can easily be used to produce something equivalent. * Class *TextSheet* does no longer exist. * Text "spans" (one of the hierarchy levels of :ref:`TextPage`) no longer contain positioning information (i.e. no "bbox" key). Instead, spans now provide the font information for its text. This impacts our JSON output variant. * HTML output has improved very much: it now creates valid documents which can be displayed by browsers to produce a similar view as the original document. * There is a new output format XHTML, which provides text and images in a browser-readable format. The difference to HTML output is, that no effort is made to reproduce the original layout. * All output formats of :meth:`Page.getText` now support creating complete, valid documents, by wrapping them with appropriate header and trailer information. If you are interested in using the HTML output, please make sure to read :ref:`HTMLQuality`. * To support finding text positions, we have added special methods that don't need detours like :meth:`TextPage.extractJSON` or :meth:`TextPage.extractXML`: use :meth:`Page.getTextBlocks` or resp. :meth:`Page.getTextWords` to create lists of text blocks or resp. words, which are accompanied by their rectangles. This should be much faster than the standard text extraction methods and also avoids using additional packages for interpreting their output. ------ **Changes in Version 1.11.2** This is an extension of v1.11.1. * New :meth:`Page.insertFont` creates a PDF */Font* object and returns its object number. * New :meth:`Document.extractFont` extracts the content of an embedded font given its object number. * Methods **FontList(...)** items no longer contain the PDF generation number. This value never had any significance. Instead, the font file extension is included (e.g. "pfa" for a "PostScript Font for ASCII"), which is more valuable information. * Fonts other than "simple fonts" (Type1) are now also supported. * New options to change :ref:`Pixmap` size: * Method :meth:`Pixmap.shrink` reduces the pixmap proportionally in place. * A new :ref:`Pixmap` copy constructor allows scaling via setting target width and height. ------ **Changes in Version 1.11.1** This is an extension of v1.11.0. * New class *Shape*. It facilitates and extends the creation of image shapes on PDF pages. It contains multiple methods for creating elementary shapes like lines, rectangles or circles, which can be combined into more complex ones and be given common properties like line width or colors. Combined shapes are handled as a unit and e.g. be "morphed" together. The class can accumulate multiple complex shapes and put them all in the page's foreground or background -- thus also reducing the number of updates to the page's :data:`contents` object. * All *Page* draw methods now use the new *Shape* class. * Text insertion methods *insertText()* and *insertTextBox()* now support morphing in addition to text rotation. They have become part of the *Shape* class and thus allow text to be freely combined with graphics. * A new *Pixmap* constructor allows creating pixmap copies with an added alpha channel. A new method also allows directly manipulating alpha values. * Binary algebraic operations with geometry objects (matrices, rectangles and points) now generally also support lists or tuples as the second operand. You can add a tuple *(x, y)* of numbers to a :ref:`Point`. In this context, such sequences are called ":data:`point_like`" (resp. :data:`matrix_like`, :data:`rect_like`). * Geometry objects now fully support in-place operators. For example, *p /= m* replaces point p with *p * 1/m* for a number, or *p * ~m* for a :data:`matrix_like` object *m*. Similarly, if *r* is a rectangle, then *r |= (3, 4)* is the new rectangle that also includes *fitz.Point(3, 4)*, and *r &= (1, 2, 3, 4)* is its intersection with *fitz.Rect(1, 2, 3, 4)*. ------ **Changes in Version 1.11.0** This version is based on and requires MuPDF v1.11. Though MuPDF has declared it as being mostly a bug fix version, one major new feature is indeed contained: support of embedded files -- also called portfolios or collections. We have extended PyMuPDF functionality to embrace this up to an extent just a little beyond the *mutool* utility as follows. * The *Document* class now support embedded files with several new methods and one new property: - *embfile_Info()* returns metadata information about an entry in the list of embedded files. This is more than *mutool* currently provides: it shows all the information that was used to embed the file (not just the entry's name). - *embfile_Get()* retrieves the (decompressed) content of an entry into a *bytes* buffer. - *embfile_Add(...)* inserts new content into the PDF portfolio. We (in contrast to *mutool*) **restrict** this to entries with a **new name** (no duplicate names allowed). - *embfile_Del(...)* deletes an entry from the portfolio (function not offered in MuPDF). - *embfile_SetInfo()* -- changes filename or description of an embedded file. - *embfile_Count* -- contains the number of embedded files. * Several enhancements deal with streamlining geometry objects. These are not connected to the new MuPDF version and most of them are also reflected in PyMuPDF v1.10.0. Among them are new properties to identify the corners of rectangles by name (e.g. *Rect.bottom_right*) and new methods to deal with set-theoretic questions like *Rect.contains(x)* or *IRect.intersects(x)*. Special effort focussed on supporting more "Pythonic" language constructs: *if x in rect ...* is equivalent to *rect.contains(x)*. * The :ref:`Rect` chapter now has more background on empty amd infinite rectangles and how we handle them. The handling itself was also updated for more consistency in this area. * We have started basic support for **generation** of PDF content: - *Document.insert_page()* adds a new page into a PDF, optionally containing some text. - *Page.insertImage()* places a new image on a PDF page. - *Page.insertText()* puts new text on an existing page * For **FileAttachment** annotations, content and name of the attached file can extracted and changed. ------ **Changes in Version 1.10.0** **MuPDF v1.10 Impact** MuPDF version 1.10 has a significant impact on our bindings. Some of the changes also affect the API -- in other words, **you** as a PyMuPDF user. * Link destination information has been reduced. Several properties of the *linkDest* class no longer contain valuable information. In fact, this class as a whole has been deleted from MuPDF's library and we in PyMuPDF only maintain it to provide compatibility to existing code. * In an effort to minimize memory requirements, several improvements have been built into MuPDF v1.10: - A new *config.h* file can be used to de-select unwanted features in the C base code. Using this feature we have been able to reduce the size of our binary *_fitz.o* / *_fitz.pyd* by about 50% (from 9 MB to 4.5 MB). When UPX-ing this, the size goes even further down to a very handy 2.3 MB. - The alpha (transparency) channel for pixmaps is now optional. Letting alpha default to *False* significantly reduces pixmap sizes (by 20% -- CMYK, 25% -- RGB, 50% -- GRAY). Many *Pixmap* constructors therefore now accept an *alpha* boolean to control inclusion of this channel. Other pixmap constructors (e.g. those for file and image input) create pixmaps with no alpha altogether. On the downside, save methods for pixmaps no longer accept a *savealpha* option: this channel will always be saved when present. To minimize code breaks, we have left this parameter in the call patterns -- it will just be ignored. * *DisplayList* and *TextPage* class constructors now **require the mediabox** of the page they are referring to (i.e. the *page.bound()* rectangle). There is no way to construct this information from other sources, therefore a source code change cannot be avoided in these cases. We assume however, that not many users are actually employing these rather low level classes explicitly. So the impact of that change should be minor. **Other Changes compared to Version 1.9.3** * The new :ref:`Document` method *write()* writes an opened PDF to memory (as opposed to a file, like *save()* does). * An annotation can now be scaled and moved around on its page. This is done by modifying its rectangle. * Annotations can now be deleted. :ref:`Page` contains the new method *deleteAnnot()*. * Various annotation attributes can now be modified, e.g. content, dates, title (= author), border, colors. * Method *Document.insert_pdf()* now also copies annotations of source pages. * The *Pages* class has been deleted. As documents can now be accessed with page numbers as indices (like *doc[n] = doc.loadPage(n)*), and document object can be used as iterators, the benefit of this class was too low to maintain it. See the following comments. * *loadPage(n)* / *doc[n]* now accept arbitrary integers to specify a page number, as long as *n < pageCount*. So, e.g. *doc[-500]* is always valid and will load page *(-500) % pageCount*. * A document can now also be used as an iterator like this: *for page in doc: ... ...*. This will yield all pages of *doc* as *page*. * The :ref:`Pixmap` method *getSize()* has been replaced with property *size*. As before *Pixmap.size == len(Pixmap)* is true. * In response to transparency (alpha) being optional, several new parameters and properties have been added to :ref:`Pixmap` and :ref:`Colorspace` classes to support determining their characteristics. * The :ref:`Page` class now contains new properties *firstAnnot* and *firstLink* to provide starting points to the respective class chains, where *firstLink* is just a mnemonic synonym to method *loadLinks()* which continues to exist. Similarly, the new property *rect* is a synonym for method *bound()*, which also continues to exist. * :ref:`Pixmap` methods *samplesRGB()* and *samplesAlpha()* have been deleted because pixmaps can now be created without transparency. * :ref:`Rect` now has a property *irect* which is a synonym of method *round()*. Likewise, :ref:`IRect` now has property *rect* to deliver a :ref:`Rect` which has the same coordinates as floats values. * Document has the new method *searchPageFor()* to search for a text string. It works exactly like the corresponding *Page.searchFor()* with page number as additional parameter. ------ **Changes in Version 1.9.3** This version is also based on MuPDF v1.9a. Changes compared to version 1.9.2: * As a major enhancement, annotations are now supported in a similar way as links. Annotations can be displayed (as pixmaps) and their properties can be accessed. * In addition to the document *select()* method, some simpler methods can now be used to manipulate a PDF: - *copyPage()* copies a page within a document. - *movePage()* is similar, but deletes the original. - *delete_page()* deletes a page - *delete_pages()* deletes a page range * *rotation* or *setRotation()* access or change a PDF page's rotation, respectively. * Available but undocumented before, :ref:`IRect`, :ref:`Rect`, :ref:`Point` and :ref:`Matrix` support the *len()* method and their coordinate properties can be accessed via indices, e.g. *IRect.x1 == IRect[2]*. * For convenience, documents now support simple indexing: *doc.loadPage(n) == doc[n]*. The index may however be in range *-pageCount < n < pageCount*, such that *doc[-1]* is the last page of the document. ------ **Changes in Version 1.9.2** This version is also based on MuPDF v1.9a. Changes compared to version 1.9.1: * *fitz.open()* (no parameters) creates a new empty **PDF** document, i.e. if saved afterwards, it must be given a *.pdf* extension. * :ref:`Document` now accepts all of the following formats (*Document* and *open* are synonyms): - *open()*, - *open(filename)* (equivalent to *open(filename, None)*), - *open(filetype, area)* (equivalent to *open(filetype, stream = area)*). Type of memory area *stream* may be *bytes* or *bytearray*. Thus, e.g. *area = open("file.pdf", "rb").read()* may be used directly (without first converting it to bytearray). * New method *Document.insert_pdf()* (PDFs only) inserts a range of pages from another PDF. * *Document* objects doc now support the *len()* function: ``len(doc) == doc.pageCount``. * New method *Document.getPageImageList()* creates a list of images used on a page. * New method *Document.getPageFontList()* creates a list of fonts referenced by a page. * New pixmap constructor *fitz.Pixmap(doc, xref)* creates a pixmap based on an opened PDF document and an :data:`xref` number of the image. * New pixmap constructor *fitz.Pixmap(cspace, spix)* creates a pixmap as a copy of another one *spix* with the colorspace converted to *cspace*. This works for all colorspace combinations. * Pixmap constructor *fitz.Pixmap(colorspace, width, height, samples)* now allows *samples* to also be *bytes*, not only *bytearray*. ------ **Changes in Version 1.9.1** This version of PyMuPDF is based on MuPDF library source code version 1.9a published on April 21, 2016. Please have a look at MuPDF's website to see which changes and enhancements are contained herein. Changes in version 1.9.1 compared to version 1.8.0 are the following: * New methods *get_area()* for both *fitz.Rect* and *fitz.IRect* * Pixmaps can now be created directly from files using the new constructor *fitz.Pixmap(filename)*. * The Pixmap constructor *fitz.Pixmap(image)* has been extended accordingly. * *fitz.Rect* can now be created with all possible combinations of points and coordinates. * PyMuPDF classes and methods now all contain __doc__ strings, most of them created by SWIG automatically. While the PyMuPDF documentation certainly is more detailed, this feature should help a lot when programming in Python-aware IDEs. * A new document method of *getPermits()* returns the permissions associated with the current access to the document (print, edit, annotate, copy), as a Python dictionary. * The identity matrix *fitz.Identity* is now **immutable**. * The new document method *select(list)* removes all pages from a document that are not contained in the list. Pages can also be duplicated and re-arranged. * Various improvements and new members in our demo and examples collections. Perhaps most prominently: *PDF_display* now supports scrolling with the mouse wheel, and there is a new example program *wxTableExtract* which allows to graphically identify and extract table data in documents. * *fitz.open()* is now an alias of *fitz.Document()*. * New pixmap method *tobytes()* which will return a bytearray formatted as a PNG image of the pixmap. * New pixmap method *samplesRGB()* providing a *samples* version with alpha bytes stripped off (RGB colorspaces only). * New pixmap method *samplesAlpha()* providing the alpha bytes only of the *samples* area. * New iterator *fitz.Pages(doc)* over a document's set of pages. * New matrix methods *invert()* (calculate inverted matrix), *concat()* (calculate matrix product), *pretranslate()* (perform a shift operation). * New *IRect* methods *intersect()* (intersection with another rectangle), *translate()* (perform a shift operation). * New *Rect* methods *intersect()* (intersection with another rectangle), *transform()* (transformation with a matrix), *include_point()* (enlarge rectangle to also contain a point), *include_rect()* (enlarge rectangle to also contain another one). * Documented *Point.transform()* (transform a point with a matrix). * *Matrix*, *IRect*, *Rect* and *Point* classes now support compact, algebraic formulations for manipulating such objects. * Incremental saves for changes are possible now using the call pattern *doc.save(doc.name, incremental=True)*. * A PDF's metadata can now be deleted, set or changed by document method *set_metadata()*. Supports incremental saves. * A PDF's bookmarks (or table of contents) can now be deleted, set or changed with the entries of a list using document method *set_toc(list)*. Supports incremental saves. .. codespell:ignore-end ================================================ FILE: docs/404.rst ================================================ .. include:: header-404.rst 404! ====== **This page is not available.** Please use the menu or search to find what you are looking for. .. include:: footer.rst ================================================ FILE: docs/README.md ================================================ # PyMuPDF documentation Welcome to the PyMuPDF documentation. This documentation relies on [Sphinx](https://www.sphinx-doc.org/en/master/) to publish HTML docs from markdown files written with [restructured text](https://en.wikipedia.org/wiki/ReStructuredText) (RST). ## Sphinx version This README assumes you have [Sphinx v5.0.2 installed](https://www.sphinx-doc.org/en/master/usage/installation.html) on your system. ## Dependencies pip install sphinxcontrib-googleanalytics pip install sphinx-notfound-page pip install sphinx-copybutton pip install sphinx-autobuild pip install furo ## Updating the documentation Within `docs` update the associated restructured text (`.rst`) files. These files represent the corresponding document pages. ### Conventions - Code parameters and referenced code objects should be referenced within backticks, not italics, double backtick is better for safety - When referencing names of some of our products surround with | , e.g. |PyMuPDF| , not PyMuPDF, see `header.rst` for products names listing - When hyperlinking, avoid inline hyperlinks and try to references link from common location at page bottom, also avoid the use of "here" or "click here" as this provides little information about the link content. e.g. "`Click here ` for our Story class". Should be re-written to something more like "Find out more `on our Story class `" ## Building HTML documentation - Ensure you have the `furo` theme installed: `pip install furo` Furo theme, Copyright (c) 2020 Pradyun Gedam , thank you to: https://github.com/pradyunsg/furo/blob/main/LICENSE - From the "docs" location run: `sphinx-build -b html . build/html` This then creates the HTML documentation within `build/html`. > Use: `sphinx-build -a -b html . build/html` to build all, including the assets in `_static` (important if you have updated CSS). ### Using Sphinx Autobuild A better way of building the documentation if you are actively working on updates is to run: `sphinx-autobuild . _build/html` This will serve the docs on a localhost and auto-update the pages live as you make edits. ## Internationalization PyMuPDF docs can be delivered in multiple languages - English, Japanese & Korean. To add a new language, e.g. Korean, use: `sphinx-build -b gettext . _build/gettext` `sphinx-intl update -p _build/gettext -l ko` ### Building the Localiized documentation - From the "docs" location run: #### Japanese: `sphinx-build -a -b html -D language=ja . _build/html/ja` Once built HTML docs HTML pages are in `_build/html/ja`. #### Korean: `sphinx-build -a -b html -D language=ko . _build/html/ko` Once built HTML docs HTML pages are in `_build/html/ko`. Note: subsequent runs can omit the `-a` parameter to speed up builds (it will just build what has changed). Note: When build the corresponding `.mo` binary files will also be generated - these updated binaries should also be committed to Git. ### Depoloying Docs will be automatically deployed to RTD once pushes are made to relevant branches. ### Updating - Updating, after changes on the `main` branch and a sync with the main `en` .rst files, from the "docs" location, do: `sphinx-build -b gettext . _build/gettext` then: `sphinx-intl update -p _build/gettext -l ja` `sphinx-intl update -p _build/gettext -l ko` This will update the corresponding `po` files for further edits. Then check these files for "#, fuzzy" entries as the new stuff might exist there and requires editing. ## Building PDF documentation - First ensure you have [rst2pdf](https://pypi.org/project/rst2pdf/) installed: `python -m pip install rst2pdf` - Then run: `sphinx-build -b pdf . build/pdf` This will then generate a single PDF for all of the documentation within `build/pdf`. --- For full details see: [Using Sphinx](https://www.sphinx-doc.org/en/master/usage/index.html) ================================================ FILE: docs/_static/custom.css ================================================ /* main document page: ensures pages fit to the available width and height */ .wy-nav-content { min-width: 100%; min-height: 100vh; } /* Accessibility: Artifex color for main document links */ .wy-nav-content a { color: #007aff; } /* Artifex blue color for background elements */ .wy-side-nav-search, .wy-nav-top { background-color: #007aff; } /* Accessibility: ensures that the version number is readable against the background color */ .wy-side-nav-search>div.version { color:hsla(0,0%,100%,1); } .htmltag { padding: 2px 5px; background-color: #fbff68; border-radius: 4px; border: 1px solid #222; color:#000; } .discordLink { display:flex; justify-content:flex-end; margin:0; padding:0; font-size: 13px; } .discordLink img { width: 30px; height: 30px; margin-left: 8px; } .feedbackLink { display:flex; justify-content:flex-end; margin:0 0 10px; padding:0; font-size: 13px; } .intro-title { font-size: 22px; margin: 0 0 20px 0; } h1 { padding: 10px !important; background-color: #007aff !important; color: #fff !important; border-radius: 5px !important; margin-top: 20px !important; margin-left: -10px !important; } cite { font-weight: bold; font-style: normal; } .red-color { color: #cc0000; } .orange-color { color: #ff6600; } .green-color { color: #00cc00; } button.cta { -webkit-appearance: none; -moz-appearance: none; border:0; text-transform:uppercase; border-radius:5px; font-size:16px; font-weight:500; min-height:40px; line-height:40px; padding: 0 15px; color:#fff; cursor:pointer; } button.cta.orange { width:auto; background-image: linear-gradient(to right, #ea5842, #ec6343, #ed6d45, #ef7747, #f0804a) !important; } button.cta.orange:hover { background:#ea5842 !important; } button.cta a { color:#fff !important; } .footer-version { font-weight: bold; font-size: 12px; color: #999; } /*** Furo theme overrides ***/ /* This is to do with hiding the Furo link text and the "Made with" text */ .bottom-of-page .left-details { font-size:0; } .bottom-of-page .left-details a { display:none; } /* Now ensure that the other copyright text is visible here */ .bottom-of-page .left-details > * { font-size:12px; } .sidebar-brand-text { font-size: 13px; padding: 0; margin: 0; } .sidebar-logo { width: auto; height: 60px; } .sidebar-container { margin: 0; padding: 0; } .sidebar-search-container.top { /*position:sticky; top:10px;*/ border-radius: 20px; border: solid #333 1px; /*background-color: #fff;*/ } .sidebar-search-container.top .sidebar-search { border-top: 0 !important; border-bottom: 0 !important; } .sidebar-drawer .sidebar-search-container { width: 95%; } .toc-drawer .toc-title { font-weight: bold; text-decoration: underline; } :target>h1:first-of-type, span:target~h1:first-of-type { background-color: #007aff !important; color: #fff !important; padding-top: 40px; /* accommodates header search blocking target */ margin-top: -40px; } :target>h2:first-of-type, :target>h3:first-of-type, :target>h4:first-of-type, :target>h5:first-of-type, :target>h6:first-of-type, span:target~h2:first-of-type, span:target~h3:first-of-type, span:target~h4:first-of-type, span:target~h5:first-of-type, span:target~h6:first-of-type { background-color: transparent !important; padding-top: 40px; /* accommodates header search blocking target */ margin-top: -40px; text-decoration: underline; } /* small screens */ @media all and (max-width : 550px) { .discordLink img { display: none; } } ================================================ FILE: docs/_static/prism/prism.css ================================================ /* PrismJS 1.29.0 https://prismjs.com/download.html#themes=prism&languages=markup+css+clike+javascript+bash+c+csharp+cpp+java+kotlin+objectivec+python+shell-session+swift&plugins=normalize-whitespace+toolbar+copy-to-clipboard */ code[class*=language-],pre[class*=language-]{color:#000;background:0 0;text-shadow:0 1px #fff;font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace;font-size:14px;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}code[class*=language-] ::-moz-selection,code[class*=language-]::-moz-selection,pre[class*=language-] ::-moz-selection,pre[class*=language-]::-moz-selection{text-shadow:none;background:#b3d4fc}code[class*=language-] ::selection,code[class*=language-]::selection,pre[class*=language-] ::selection,pre[class*=language-]::selection{text-shadow:none;background:#b3d4fc}@media print{code[class*=language-],pre[class*=language-]{text-shadow:none}}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto}:not(pre)>code[class*=language-],pre[class*=language-]{background:#f5f2f0}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal}.token.cdata,.token.comment,.token.doctype,.token.prolog{color:#708090}.token.punctuation{color:#999}.token.namespace{opacity:.7}.token.boolean,.token.constant,.token.deleted,.token.number,.token.property,.token.symbol,.token.tag{color:#905}.token.attr-name,.token.builtin,.token.char,.token.inserted,.token.selector,.token.string{color:#690}.language-css .token.string,.style .token.string,.token.entity,.token.operator,.token.url{color:#9a6e3a;background:hsla(0,0%,100%,.5)}.token.atrule,.token.attr-value,.token.keyword{color:#07a}.token.class-name,.token.function{color:#dd4a68}.token.important,.token.regex,.token.variable{color:#e90}.token.bold,.token.important{font-weight:700}.token.italic{font-style:italic}.token.entity{cursor:help} div.code-toolbar{position:relative}div.code-toolbar>.toolbar{position:absolute;z-index:10;top:.3em;right:.2em;transition:opacity .3s ease-in-out;opacity:0}div.code-toolbar:hover>.toolbar{opacity:1}div.code-toolbar:focus-within>.toolbar{opacity:1}div.code-toolbar>.toolbar>.toolbar-item{display:inline-block}div.code-toolbar>.toolbar>.toolbar-item>a{cursor:pointer}div.code-toolbar>.toolbar>.toolbar-item>button{background:0 0;border:0;color:inherit;font:inherit;line-height:normal;overflow:visible;padding:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}div.code-toolbar>.toolbar>.toolbar-item>a,div.code-toolbar>.toolbar>.toolbar-item>button,div.code-toolbar>.toolbar>.toolbar-item>span{color:#bbb;font-size:.8em;padding:0 .5em;background:#f5f2f0;background:rgba(224,224,224,.2);box-shadow:0 2px 0 0 rgba(0,0,0,.2);border-radius:.5em}div.code-toolbar>.toolbar>.toolbar-item>a:focus,div.code-toolbar>.toolbar>.toolbar-item>a:hover,div.code-toolbar>.toolbar>.toolbar-item>button:focus,div.code-toolbar>.toolbar>.toolbar-item>button:hover,div.code-toolbar>.toolbar>.toolbar-item>span:focus,div.code-toolbar>.toolbar>.toolbar-item>span:hover{color:inherit;text-decoration:none} ================================================ FILE: docs/_static/prism/prism.html ================================================ See: https://prismjs.com/download.html 
                
                import fitz

                MEDIABOX = fitz.paper_rect("letter")
                WHERE = MEDIABOX + (36, 36, -36, -36)

                # create story, let it look at script folder for resources
                story = fitz.Story(archive=".")
                body = story.body  # access the body of its DOM

                with body.add_paragraph() as para:
                    # store desired content
                    para.set_font("sans-serif").set_color("blue").add_text("Hello World!")

                # another paragraph for our image:
                with body.add_paragraph() as para:
                    # store image in another paragraph
                    para.add_image("world.jpg")

                writer = fitz.DocumentWriter("output.pdf")

                more = 1

                while more:
                    device = writer.begin_page(MEDIABOX)
                    more, _ = story.place(WHERE)
                    story.draw(device)
                    writer.end_page()

                writer.close()
Here is some inline code ok... ================================================ FILE: docs/_static/prism/prism.js ================================================ /* PrismJS 1.29.0 https://prismjs.com/download.html#themes=prism&languages=markup+css+clike+javascript+bash+c+csharp+cpp+java+kotlin+objectivec+python+shell-session+swift&plugins=normalize-whitespace+toolbar+copy-to-clipboard */ var _self="undefined"!=typeof window?window:"undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{},Prism=function(e){var n=/(?:^|\s)lang(?:uage)?-([\w-]+)(?=\s|$)/i,t=0,r={},a={manual:e.Prism&&e.Prism.manual,disableWorkerMessageHandler:e.Prism&&e.Prism.disableWorkerMessageHandler,util:{encode:function e(n){return n instanceof i?new i(n.type,e(n.content),n.alias):Array.isArray(n)?n.map(e):n.replace(/&/g,"&").replace(/=g.reach);A+=w.value.length,w=w.next){var E=w.value;if(n.length>e.length)return;if(!(E instanceof i)){var P,L=1;if(y){if(!(P=l(b,A,e,m))||P.index>=e.length)break;var S=P.index,O=P.index+P[0].length,j=A;for(j+=w.value.length;S>=j;)j+=(w=w.next).value.length;if(A=j-=w.value.length,w.value instanceof i)continue;for(var C=w;C!==n.tail&&(jg.reach&&(g.reach=W);var z=w.prev;if(_&&(z=u(n,z,_),A+=_.length),c(n,z,L),w=u(n,z,new i(f,p?a.tokenize(N,p):N,k,N)),M&&u(n,w,M),L>1){var I={cause:f+","+d,reach:W};o(e,n,t,w.prev,A,I),g&&I.reach>g.reach&&(g.reach=I.reach)}}}}}}function s(){var e={value:null,prev:null,next:null},n={value:null,prev:e,next:null};e.next=n,this.head=e,this.tail=n,this.length=0}function u(e,n,t){var r=n.next,a={value:t,prev:n,next:r};return n.next=a,r.prev=a,e.length++,a}function c(e,n,t){for(var r=n.next,a=0;a"+i.content+""},!e.document)return e.addEventListener?(a.disableWorkerMessageHandler||e.addEventListener("message",(function(n){var t=JSON.parse(n.data),r=t.language,i=t.code,l=t.immediateClose;e.postMessage(a.highlight(i,a.languages[r],r)),l&&e.close()}),!1),a):a;var g=a.util.currentScript();function f(){a.manual||a.highlightAll()}if(g&&(a.filename=g.src,g.hasAttribute("data-manual")&&(a.manual=!0)),!a.manual){var h=document.readyState;"loading"===h||"interactive"===h&&g&&g.defer?document.addEventListener("DOMContentLoaded",f):window.requestAnimationFrame?window.requestAnimationFrame(f):window.setTimeout(f,16)}return a}(_self);"undefined"!=typeof module&&module.exports&&(module.exports=Prism),"undefined"!=typeof global&&(global.Prism=Prism); Prism.languages.markup={comment:{pattern://,greedy:!0},prolog:{pattern:/<\?[\s\S]+?\?>/,greedy:!0},doctype:{pattern:/"'[\]]|"[^"]*"|'[^']*')+(?:\[(?:[^<"'\]]|"[^"]*"|'[^']*'|<(?!!--)|)*\]\s*)?>/i,greedy:!0,inside:{"internal-subset":{pattern:/(^[^\[]*\[)[\s\S]+(?=\]>$)/,lookbehind:!0,greedy:!0,inside:null},string:{pattern:/"[^"]*"|'[^']*'/,greedy:!0},punctuation:/^$|[[\]]/,"doctype-tag":/^DOCTYPE/i,name:/[^\s<>'"]+/}},cdata:{pattern://i,greedy:!0},tag:{pattern:/<\/?(?!\d)[^\s>\/=$<%]+(?:\s(?:\s*[^\s>\/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+(?=[\s>]))|(?=[\s/>])))+)?\s*\/?>/,greedy:!0,inside:{tag:{pattern:/^<\/?[^\s>\/]+/,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"special-attr":[],"attr-value":{pattern:/=\s*(?:"[^"]*"|'[^']*'|[^\s'">=]+)/,inside:{punctuation:[{pattern:/^=/,alias:"attr-equals"},{pattern:/^(\s*)["']|["']$/,lookbehind:!0}]}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:[{pattern:/&[\da-z]{1,8};/i,alias:"named-entity"},/&#x?[\da-f]{1,8};/i]},Prism.languages.markup.tag.inside["attr-value"].inside.entity=Prism.languages.markup.entity,Prism.languages.markup.doctype.inside["internal-subset"].inside=Prism.languages.markup,Prism.hooks.add("wrap",(function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&/,"&"))})),Object.defineProperty(Prism.languages.markup.tag,"addInlined",{value:function(a,e){var s={};s["language-"+e]={pattern:/(^$)/i,lookbehind:!0,inside:Prism.languages[e]},s.cdata=/^$/i;var t={"included-cdata":{pattern://i,inside:s}};t["language-"+e]={pattern:/[\s\S]+/,inside:Prism.languages[e]};var n={};n[a]={pattern:RegExp("(<__[^>]*>)(?:))*\\]\\]>|(?!)".replace(/__/g,(function(){return a})),"i"),lookbehind:!0,greedy:!0,inside:t},Prism.languages.insertBefore("markup","cdata",n)}}),Object.defineProperty(Prism.languages.markup.tag,"addAttribute",{value:function(a,e){Prism.languages.markup.tag.inside["special-attr"].push({pattern:RegExp("(^|[\"'\\s])(?:"+a+")\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+(?=[\\s>]))","i"),lookbehind:!0,inside:{"attr-name":/^[^\s=]+/,"attr-value":{pattern:/=[\s\S]+/,inside:{value:{pattern:/(^=\s*(["']|(?!["'])))\S[\s\S]*(?=\2$)/,lookbehind:!0,alias:[e,"language-"+e],inside:Prism.languages[e]},punctuation:[{pattern:/^=/,alias:"attr-equals"},/"|'/]}}}})}}),Prism.languages.html=Prism.languages.markup,Prism.languages.mathml=Prism.languages.markup,Prism.languages.svg=Prism.languages.markup,Prism.languages.xml=Prism.languages.extend("markup",{}),Prism.languages.ssml=Prism.languages.xml,Prism.languages.atom=Prism.languages.xml,Prism.languages.rss=Prism.languages.xml; !function(s){var e=/(?:"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"|'(?:\\(?:\r\n|[\s\S])|[^'\\\r\n])*')/;s.languages.css={comment:/\/\*[\s\S]*?\*\//,atrule:{pattern:RegExp("@[\\w-](?:[^;{\\s\"']|\\s+(?!\\s)|"+e.source+")*?(?:;|(?=\\s*\\{))"),inside:{rule:/^@[\w-]+/,"selector-function-argument":{pattern:/(\bselector\s*\(\s*(?![\s)]))(?:[^()\s]|\s+(?![\s)])|\((?:[^()]|\([^()]*\))*\))+(?=\s*\))/,lookbehind:!0,alias:"selector"},keyword:{pattern:/(^|[^\w-])(?:and|not|only|or)(?![\w-])/,lookbehind:!0}}},url:{pattern:RegExp("\\burl\\((?:"+e.source+"|(?:[^\\\\\r\n()\"']|\\\\[^])*)\\)","i"),greedy:!0,inside:{function:/^url/i,punctuation:/^\(|\)$/,string:{pattern:RegExp("^"+e.source+"$"),alias:"url"}}},selector:{pattern:RegExp("(^|[{}\\s])[^{}\\s](?:[^{};\"'\\s]|\\s+(?![\\s{])|"+e.source+")*(?=\\s*\\{)"),lookbehind:!0},string:{pattern:e,greedy:!0},property:{pattern:/(^|[^-\w\xA0-\uFFFF])(?!\s)[-_a-z\xA0-\uFFFF](?:(?!\s)[-\w\xA0-\uFFFF])*(?=\s*:)/i,lookbehind:!0},important:/!important\b/i,function:{pattern:/(^|[^-a-z0-9])[-a-z0-9]+(?=\()/i,lookbehind:!0},punctuation:/[(){};:,]/},s.languages.css.atrule.inside.rest=s.languages.css;var t=s.languages.markup;t&&(t.tag.addInlined("style","css"),t.tag.addAttribute("style","css"))}(Prism); Prism.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\s\S]*?(?:\*\/|$)/,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/(["'])(?:\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/(\b(?:class|extends|implements|instanceof|interface|new|trait)\s+|\bcatch\s+\()[\w.\\]+/i,lookbehind:!0,inside:{punctuation:/[.\\]/}},keyword:/\b(?:break|catch|continue|do|else|finally|for|function|if|in|instanceof|new|null|return|throw|try|while)\b/,boolean:/\b(?:false|true)\b/,function:/\b\w+(?=\()/,number:/\b0x[\da-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:e[+-]?\d+)?/i,operator:/[<>]=?|[!=]=?=?|--?|\+\+?|&&?|\|\|?|[?*/~^%]/,punctuation:/[{}[\];(),.:]/}; Prism.languages.javascript=Prism.languages.extend("clike",{"class-name":[Prism.languages.clike["class-name"],{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$A-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\.(?:constructor|prototype))/,lookbehind:!0}],keyword:[{pattern:/((?:^|\})\s*)catch\b/,lookbehind:!0},{pattern:/(^|[^.]|\.\.\.\s*)\b(?:as|assert(?=\s*\{)|async(?=\s*(?:function\b|\(|[$\w\xA0-\uFFFF]|$))|await|break|case|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally(?=\s*(?:\{|$))|for|from(?=\s*(?:['"]|$))|function|(?:get|set)(?=\s*(?:[#\[$\w\xA0-\uFFFF]|$))|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)\b/,lookbehind:!0}],function:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*(?:\.\s*(?:apply|bind|call)\s*)?\()/,number:{pattern:RegExp("(^|[^\\w$])(?:NaN|Infinity|0[bB][01]+(?:_[01]+)*n?|0[oO][0-7]+(?:_[0-7]+)*n?|0[xX][\\dA-Fa-f]+(?:_[\\dA-Fa-f]+)*n?|\\d+(?:_\\d+)*n|(?:\\d+(?:_\\d+)*(?:\\.(?:\\d+(?:_\\d+)*)?)?|\\.\\d+(?:_\\d+)*)(?:[Ee][+-]?\\d+(?:_\\d+)*)?)(?![\\w$])"),lookbehind:!0},operator:/--|\+\+|\*\*=?|=>|&&=?|\|\|=?|[!=]==|<<=?|>>>?=?|[-+*/%&|^!=<>]=?|\.{3}|\?\?=?|\?\.?|[~:]/}),Prism.languages.javascript["class-name"][0].pattern=/(\b(?:class|extends|implements|instanceof|interface|new)\s+)[\w.\\]+/,Prism.languages.insertBefore("javascript","keyword",{regex:{pattern:RegExp("((?:^|[^$\\w\\xA0-\\uFFFF.\"'\\])\\s]|\\b(?:return|yield))\\s*)/(?:(?:\\[(?:[^\\]\\\\\r\n]|\\\\.)*\\]|\\\\.|[^/\\\\\\[\r\n])+/[dgimyus]{0,7}|(?:\\[(?:[^[\\]\\\\\r\n]|\\\\.|\\[(?:[^[\\]\\\\\r\n]|\\\\.|\\[(?:[^[\\]\\\\\r\n]|\\\\.)*\\])*\\])*\\]|\\\\.|[^/\\\\\\[\r\n])+/[dgimyus]{0,7}v[dgimyus]{0,7})(?=(?:\\s|/\\*(?:[^*]|\\*(?!/))*\\*/)*(?:$|[\r\n,.;:})\\]]|//))"),lookbehind:!0,greedy:!0,inside:{"regex-source":{pattern:/^(\/)[\s\S]+(?=\/[a-z]*$)/,lookbehind:!0,alias:"language-regex",inside:Prism.languages.regex},"regex-delimiter":/^\/|\/$/,"regex-flags":/^[a-z]+$/}},"function-variable":{pattern:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*[=:]\s*(?:async\s*)?(?:\bfunction\b|(?:\((?:[^()]|\([^()]*\))*\)|(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)\s*=>))/,alias:"function"},parameter:[{pattern:/(function(?:\s+(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*)?\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\))/,lookbehind:!0,inside:Prism.languages.javascript},{pattern:/(^|[^$\w\xA0-\uFFFF])(?!\s)[_$a-z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*=>)/i,lookbehind:!0,inside:Prism.languages.javascript},{pattern:/(\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*=>)/,lookbehind:!0,inside:Prism.languages.javascript},{pattern:/((?:\b|\s|^)(?!(?:as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)(?![$\w\xA0-\uFFFF]))(?:(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*\s*)\(\s*|\]\s*\(\s*)(?!\s)(?:[^()\s]|\s+(?![\s)])|\([^()]*\))+(?=\s*\)\s*\{)/,lookbehind:!0,inside:Prism.languages.javascript}],constant:/\b[A-Z](?:[A-Z_]|\dx?)*\b/}),Prism.languages.insertBefore("javascript","string",{hashbang:{pattern:/^#!.*/,greedy:!0,alias:"comment"},"template-string":{pattern:/`(?:\\[\s\S]|\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}|(?!\$\{)[^\\`])*`/,greedy:!0,inside:{"template-punctuation":{pattern:/^`|`$/,alias:"string"},interpolation:{pattern:/((?:^|[^\\])(?:\\{2})*)\$\{(?:[^{}]|\{(?:[^{}]|\{[^}]*\})*\})+\}/,lookbehind:!0,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:Prism.languages.javascript}},string:/[\s\S]+/}},"string-property":{pattern:/((?:^|[,{])[ \t]*)(["'])(?:\\(?:\r\n|[\s\S])|(?!\2)[^\\\r\n])*\2(?=\s*:)/m,lookbehind:!0,greedy:!0,alias:"property"}}),Prism.languages.insertBefore("javascript","operator",{"literal-property":{pattern:/((?:^|[,{])[ \t]*)(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?=\s*:)/m,lookbehind:!0,alias:"property"}}),Prism.languages.markup&&(Prism.languages.markup.tag.addInlined("script","javascript"),Prism.languages.markup.tag.addAttribute("on(?:abort|blur|change|click|composition(?:end|start|update)|dblclick|error|focus(?:in|out)?|key(?:down|up)|load|mouse(?:down|enter|leave|move|out|over|up)|reset|resize|scroll|select|slotchange|submit|unload|wheel)","javascript")),Prism.languages.js=Prism.languages.javascript; !function(e){var t="\\b(?:BASH|BASHOPTS|BASH_ALIASES|BASH_ARGC|BASH_ARGV|BASH_CMDS|BASH_COMPLETION_COMPAT_DIR|BASH_LINENO|BASH_REMATCH|BASH_SOURCE|BASH_VERSINFO|BASH_VERSION|COLORTERM|COLUMNS|COMP_WORDBREAKS|DBUS_SESSION_BUS_ADDRESS|DEFAULTS_PATH|DESKTOP_SESSION|DIRSTACK|DISPLAY|EUID|GDMSESSION|GDM_LANG|GNOME_KEYRING_CONTROL|GNOME_KEYRING_PID|GPG_AGENT_INFO|GROUPS|HISTCONTROL|HISTFILE|HISTFILESIZE|HISTSIZE|HOME|HOSTNAME|HOSTTYPE|IFS|INSTANCE|JOB|LANG|LANGUAGE|LC_ADDRESS|LC_ALL|LC_IDENTIFICATION|LC_MEASUREMENT|LC_MONETARY|LC_NAME|LC_NUMERIC|LC_PAPER|LC_TELEPHONE|LC_TIME|LESSCLOSE|LESSOPEN|LINES|LOGNAME|LS_COLORS|MACHTYPE|MAILCHECK|MANDATORY_PATH|NO_AT_BRIDGE|OLDPWD|OPTERR|OPTIND|ORBIT_SOCKETDIR|OSTYPE|PAPERSIZE|PATH|PIPESTATUS|PPID|PS1|PS2|PS3|PS4|PWD|RANDOM|REPLY|SECONDS|SELINUX_INIT|SESSION|SESSIONTYPE|SESSION_MANAGER|SHELL|SHELLOPTS|SHLVL|SSH_AUTH_SOCK|TERM|UID|UPSTART_EVENTS|UPSTART_INSTANCE|UPSTART_JOB|UPSTART_SESSION|USER|WINDOWID|XAUTHORITY|XDG_CONFIG_DIRS|XDG_CURRENT_DESKTOP|XDG_DATA_DIRS|XDG_GREETER_DATA_DIR|XDG_MENU_PREFIX|XDG_RUNTIME_DIR|XDG_SEAT|XDG_SEAT_PATH|XDG_SESSION_DESKTOP|XDG_SESSION_ID|XDG_SESSION_PATH|XDG_SESSION_TYPE|XDG_VTNR|XMODIFIERS)\\b",a={pattern:/(^(["']?)\w+\2)[ \t]+\S.*/,lookbehind:!0,alias:"punctuation",inside:null},n={bash:a,environment:{pattern:RegExp("\\$"+t),alias:"constant"},variable:[{pattern:/\$?\(\([\s\S]+?\)\)/,greedy:!0,inside:{variable:[{pattern:/(^\$\(\([\s\S]+)\)\)/,lookbehind:!0},/^\$\(\(/],number:/\b0x[\dA-Fa-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:[Ee]-?\d+)?/,operator:/--|\+\+|\*\*=?|<<=?|>>=?|&&|\|\||[=!+\-*/%<>^&|]=?|[?~:]/,punctuation:/\(\(?|\)\)?|,|;/}},{pattern:/\$\((?:\([^)]+\)|[^()])+\)|`[^`]+`/,greedy:!0,inside:{variable:/^\$\(|^`|\)$|`$/}},{pattern:/\$\{[^}]+\}/,greedy:!0,inside:{operator:/:[-=?+]?|[!\/]|##?|%%?|\^\^?|,,?/,punctuation:/[\[\]]/,environment:{pattern:RegExp("(\\{)"+t),lookbehind:!0,alias:"constant"}}},/\$(?:\w+|[#?*!@$])/],entity:/\\(?:[abceEfnrtv\\"]|O?[0-7]{1,3}|U[0-9a-fA-F]{8}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{1,2})/};e.languages.bash={shebang:{pattern:/^#!\s*\/.*/,alias:"important"},comment:{pattern:/(^|[^"{\\$])#.*/,lookbehind:!0},"function-name":[{pattern:/(\bfunction\s+)[\w-]+(?=(?:\s*\(?:\s*\))?\s*\{)/,lookbehind:!0,alias:"function"},{pattern:/\b[\w-]+(?=\s*\(\s*\)\s*\{)/,alias:"function"}],"for-or-select":{pattern:/(\b(?:for|select)\s+)\w+(?=\s+in\s)/,alias:"variable",lookbehind:!0},"assign-left":{pattern:/(^|[\s;|&]|[<>]\()\w+(?:\.\w+)*(?=\+?=)/,inside:{environment:{pattern:RegExp("(^|[\\s;|&]|[<>]\\()"+t),lookbehind:!0,alias:"constant"}},alias:"variable",lookbehind:!0},parameter:{pattern:/(^|\s)-{1,2}(?:\w+:[+-]?)?\w+(?:\.\w+)*(?=[=\s]|$)/,alias:"variable",lookbehind:!0},string:[{pattern:/((?:^|[^<])<<-?\s*)(\w+)\s[\s\S]*?(?:\r?\n|\r)\2/,lookbehind:!0,greedy:!0,inside:n},{pattern:/((?:^|[^<])<<-?\s*)(["'])(\w+)\2\s[\s\S]*?(?:\r?\n|\r)\3/,lookbehind:!0,greedy:!0,inside:{bash:a}},{pattern:/(^|[^\\](?:\\\\)*)"(?:\\[\s\S]|\$\([^)]+\)|\$(?!\()|`[^`]+`|[^"\\`$])*"/,lookbehind:!0,greedy:!0,inside:n},{pattern:/(^|[^$\\])'[^']*'/,lookbehind:!0,greedy:!0},{pattern:/\$'(?:[^'\\]|\\[\s\S])*'/,greedy:!0,inside:{entity:n.entity}}],environment:{pattern:RegExp("\\$?"+t),alias:"constant"},variable:n.variable,function:{pattern:/(^|[\s;|&]|[<>]\()(?:add|apropos|apt|apt-cache|apt-get|aptitude|aspell|automysqlbackup|awk|basename|bash|bc|bconsole|bg|bzip2|cal|cargo|cat|cfdisk|chgrp|chkconfig|chmod|chown|chroot|cksum|clear|cmp|column|comm|composer|cp|cron|crontab|csplit|curl|cut|date|dc|dd|ddrescue|debootstrap|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|docker|docker-compose|du|egrep|eject|env|ethtool|expand|expect|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|git|gparted|grep|groupadd|groupdel|groupmod|groups|grub-mkconfig|gzip|halt|head|hg|history|host|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|ip|java|jobs|join|kill|killall|less|link|ln|locate|logname|logrotate|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|lynx|make|man|mc|mdadm|mkconfig|mkdir|mke2fs|mkfifo|mkfs|mkisofs|mknod|mkswap|mmv|more|most|mount|mtools|mtr|mutt|mv|nano|nc|netstat|nice|nl|node|nohup|notify-send|npm|nslookup|op|open|parted|passwd|paste|pathchk|ping|pkill|pnpm|podman|podman-compose|popd|pr|printcap|printenv|ps|pushd|pv|quota|quotacheck|quotactl|ram|rar|rcp|reboot|remsync|rename|renice|rev|rm|rmdir|rpm|rsync|scp|screen|sdiff|sed|sendmail|seq|service|sftp|sh|shellcheck|shuf|shutdown|sleep|slocate|sort|split|ssh|stat|strace|su|sudo|sum|suspend|swapon|sync|sysctl|tac|tail|tar|tee|time|timeout|top|touch|tr|traceroute|tsort|tty|umount|uname|unexpand|uniq|units|unrar|unshar|unzip|update-grub|uptime|useradd|userdel|usermod|users|uudecode|uuencode|v|vcpkg|vdir|vi|vim|virsh|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yarn|yes|zenity|zip|zsh|zypper)(?=$|[)\s;|&])/,lookbehind:!0},keyword:{pattern:/(^|[\s;|&]|[<>]\()(?:case|do|done|elif|else|esac|fi|for|function|if|in|select|then|until|while)(?=$|[)\s;|&])/,lookbehind:!0},builtin:{pattern:/(^|[\s;|&]|[<>]\()(?:\.|:|alias|bind|break|builtin|caller|cd|command|continue|declare|echo|enable|eval|exec|exit|export|getopts|hash|help|let|local|logout|mapfile|printf|pwd|read|readarray|readonly|return|set|shift|shopt|source|test|times|trap|type|typeset|ulimit|umask|unalias|unset)(?=$|[)\s;|&])/,lookbehind:!0,alias:"class-name"},boolean:{pattern:/(^|[\s;|&]|[<>]\()(?:false|true)(?=$|[)\s;|&])/,lookbehind:!0},"file-descriptor":{pattern:/\B&\d\b/,alias:"important"},operator:{pattern:/\d?<>|>\||\+=|=[=~]?|!=?|<<[<-]?|[&\d]?>>|\d[<>]&?|[<>][&=]?|&[>&]?|\|[&|]?/,inside:{"file-descriptor":{pattern:/^\d/,alias:"important"}}},punctuation:/\$?\(\(?|\)\)?|\.\.|[{}[\];\\]/,number:{pattern:/(^|\s)(?:[1-9]\d*|0)(?:[.,]\d+)?\b/,lookbehind:!0}},a.inside=e.languages.bash;for(var s=["comment","function-name","for-or-select","assign-left","parameter","string","environment","function","keyword","builtin","boolean","file-descriptor","operator","punctuation","number"],o=n.variable[1].inside,i=0;i>=?|<<=?|->|([-+&|:])\1|[?:~]|[-+*/%&|^!=<>]=?/}),Prism.languages.insertBefore("c","string",{char:{pattern:/'(?:\\(?:\r\n|[\s\S])|[^'\\\r\n]){0,32}'/,greedy:!0}}),Prism.languages.insertBefore("c","string",{macro:{pattern:/(^[\t ]*)#\s*[a-z](?:[^\r\n\\/]|\/(?!\*)|\/\*(?:[^*]|\*(?!\/))*\*\/|\\(?:\r\n|[\s\S]))*/im,lookbehind:!0,greedy:!0,alias:"property",inside:{string:[{pattern:/^(#\s*include\s*)<[^>]+>/,lookbehind:!0},Prism.languages.c.string],char:Prism.languages.c.char,comment:Prism.languages.c.comment,"macro-name":[{pattern:/(^#\s*define\s+)\w+\b(?!\()/i,lookbehind:!0},{pattern:/(^#\s*define\s+)\w+\b(?=\()/i,lookbehind:!0,alias:"function"}],directive:{pattern:/^(#\s*)[a-z]+/,lookbehind:!0,alias:"keyword"},"directive-hash":/^#/,punctuation:/##|\\(?=[\r\n])/,expression:{pattern:/\S[\s\S]*/,inside:Prism.languages.c}}}}),Prism.languages.insertBefore("c","function",{constant:/\b(?:EOF|NULL|SEEK_CUR|SEEK_END|SEEK_SET|__DATE__|__FILE__|__LINE__|__TIMESTAMP__|__TIME__|__func__|stderr|stdin|stdout)\b/}),delete Prism.languages.c.boolean; !function(e){function n(e,n){return e.replace(/<<(\d+)>>/g,(function(e,s){return"(?:"+n[+s]+")"}))}function s(e,s,a){return RegExp(n(e,s),a||"")}function a(e,n){for(var s=0;s>/g,(function(){return"(?:"+e+")"}));return e.replace(/<>/g,"[^\\s\\S]")}var t="bool byte char decimal double dynamic float int long object sbyte short string uint ulong ushort var void",r="class enum interface record struct",i="add alias and ascending async await by descending from(?=\\s*(?:\\w|$)) get global group into init(?=\\s*;) join let nameof not notnull on or orderby partial remove select set unmanaged value when where with(?=\\s*{)",o="abstract as base break case catch checked const continue default delegate do else event explicit extern finally fixed for foreach goto if implicit in internal is lock namespace new null operator out override params private protected public readonly ref return sealed sizeof stackalloc static switch this throw try typeof unchecked unsafe using virtual volatile while yield";function l(e){return"\\b(?:"+e.trim().replace(/ /g,"|")+")\\b"}var d=l(r),p=RegExp(l(t+" "+r+" "+i+" "+o)),c=l(r+" "+i+" "+o),u=l(t+" "+r+" "+o),g=a("<(?:[^<>;=+\\-*/%&|^]|<>)*>",2),b=a("\\((?:[^()]|<>)*\\)",2),h="@?\\b[A-Za-z_]\\w*\\b",f=n("<<0>>(?:\\s*<<1>>)?",[h,g]),m=n("(?!<<0>>)<<1>>(?:\\s*\\.\\s*<<1>>)*",[c,f]),k="\\[\\s*(?:,\\s*)*\\]",y=n("<<0>>(?:\\s*(?:\\?\\s*)?<<1>>)*(?:\\s*\\?)?",[m,k]),w=n("[^,()<>[\\];=+\\-*/%&|^]|<<0>>|<<1>>|<<2>>",[g,b,k]),v=n("\\(<<0>>+(?:,<<0>>+)+\\)",[w]),x=n("(?:<<0>>|<<1>>)(?:\\s*(?:\\?\\s*)?<<2>>)*(?:\\s*\\?)?",[v,m,k]),$={keyword:p,punctuation:/[<>()?,.:[\]]/},_="'(?:[^\r\n'\\\\]|\\\\.|\\\\[Uux][\\da-fA-F]{1,8})'",B='"(?:\\\\.|[^\\\\"\r\n])*"';e.languages.csharp=e.languages.extend("clike",{string:[{pattern:s("(^|[^$\\\\])<<0>>",['@"(?:""|\\\\[^]|[^\\\\"])*"(?!")']),lookbehind:!0,greedy:!0},{pattern:s("(^|[^@$\\\\])<<0>>",[B]),lookbehind:!0,greedy:!0}],"class-name":[{pattern:s("(\\busing\\s+static\\s+)<<0>>(?=\\s*;)",[m]),lookbehind:!0,inside:$},{pattern:s("(\\busing\\s+<<0>>\\s*=\\s*)<<1>>(?=\\s*;)",[h,x]),lookbehind:!0,inside:$},{pattern:s("(\\busing\\s+)<<0>>(?=\\s*=)",[h]),lookbehind:!0},{pattern:s("(\\b<<0>>\\s+)<<1>>",[d,f]),lookbehind:!0,inside:$},{pattern:s("(\\bcatch\\s*\\(\\s*)<<0>>",[m]),lookbehind:!0,inside:$},{pattern:s("(\\bwhere\\s+)<<0>>",[h]),lookbehind:!0},{pattern:s("(\\b(?:is(?:\\s+not)?|as)\\s+)<<0>>",[y]),lookbehind:!0,inside:$},{pattern:s("\\b<<0>>(?=\\s+(?!<<1>>|with\\s*\\{)<<2>>(?:\\s*[=,;:{)\\]]|\\s+(?:in|when)\\b))",[x,u,h]),inside:$}],keyword:p,number:/(?:\b0(?:x[\da-f_]*[\da-f]|b[01_]*[01])|(?:\B\.\d+(?:_+\d+)*|\b\d+(?:_+\d+)*(?:\.\d+(?:_+\d+)*)?)(?:e[-+]?\d+(?:_+\d+)*)?)(?:[dflmu]|lu|ul)?\b/i,operator:/>>=?|<<=?|[-=]>|([-+&|])\1|~|\?\?=?|[-+*/%&|^!=<>]=?/,punctuation:/\?\.?|::|[{}[\];(),.:]/}),e.languages.insertBefore("csharp","number",{range:{pattern:/\.\./,alias:"operator"}}),e.languages.insertBefore("csharp","punctuation",{"named-parameter":{pattern:s("([(,]\\s*)<<0>>(?=\\s*:)",[h]),lookbehind:!0,alias:"punctuation"}}),e.languages.insertBefore("csharp","class-name",{namespace:{pattern:s("(\\b(?:namespace|using)\\s+)<<0>>(?:\\s*\\.\\s*<<0>>)*(?=\\s*[;{])",[h]),lookbehind:!0,inside:{punctuation:/\./}},"type-expression":{pattern:s("(\\b(?:default|sizeof|typeof)\\s*\\(\\s*(?!\\s))(?:[^()\\s]|\\s(?!\\s)|<<0>>)*(?=\\s*\\))",[b]),lookbehind:!0,alias:"class-name",inside:$},"return-type":{pattern:s("<<0>>(?=\\s+(?:<<1>>\\s*(?:=>|[({]|\\.\\s*this\\s*\\[)|this\\s*\\[))",[x,m]),inside:$,alias:"class-name"},"constructor-invocation":{pattern:s("(\\bnew\\s+)<<0>>(?=\\s*[[({])",[x]),lookbehind:!0,inside:$,alias:"class-name"},"generic-method":{pattern:s("<<0>>\\s*<<1>>(?=\\s*\\()",[h,g]),inside:{function:s("^<<0>>",[h]),generic:{pattern:RegExp(g),alias:"class-name",inside:$}}},"type-list":{pattern:s("\\b((?:<<0>>\\s+<<1>>|record\\s+<<1>>\\s*<<5>>|where\\s+<<2>>)\\s*:\\s*)(?:<<3>>|<<4>>|<<1>>\\s*<<5>>|<<6>>)(?:\\s*,\\s*(?:<<3>>|<<4>>|<<6>>))*(?=\\s*(?:where|[{;]|=>|$))",[d,f,h,x,p.source,b,"\\bnew\\s*\\(\\s*\\)"]),lookbehind:!0,inside:{"record-arguments":{pattern:s("(^(?!new\\s*\\()<<0>>\\s*)<<1>>",[f,b]),lookbehind:!0,greedy:!0,inside:e.languages.csharp},keyword:p,"class-name":{pattern:RegExp(x),greedy:!0,inside:$},punctuation:/[,()]/}},preprocessor:{pattern:/(^[\t ]*)#.*/m,lookbehind:!0,alias:"property",inside:{directive:{pattern:/(#)\b(?:define|elif|else|endif|endregion|error|if|line|nullable|pragma|region|undef|warning)\b/,lookbehind:!0,alias:"keyword"}}}});var E=B+"|"+_,R=n("/(?![*/])|//[^\r\n]*[\r\n]|/\\*(?:[^*]|\\*(?!/))*\\*/|<<0>>",[E]),z=a(n("[^\"'/()]|<<0>>|\\(<>*\\)",[R]),2),S="\\b(?:assembly|event|field|method|module|param|property|return|type)\\b",j=n("<<0>>(?:\\s*\\(<<1>>*\\))?",[m,z]);e.languages.insertBefore("csharp","class-name",{attribute:{pattern:s("((?:^|[^\\s\\w>)?])\\s*\\[\\s*)(?:<<0>>\\s*:\\s*)?<<1>>(?:\\s*,\\s*<<1>>)*(?=\\s*\\])",[S,j]),lookbehind:!0,greedy:!0,inside:{target:{pattern:s("^<<0>>(?=\\s*:)",[S]),alias:"keyword"},"attribute-arguments":{pattern:s("\\(<<0>>*\\)",[z]),inside:e.languages.csharp},"class-name":{pattern:RegExp(m),inside:{punctuation:/\./}},punctuation:/[:,]/}}});var A=":[^}\r\n]+",F=a(n("[^\"'/()]|<<0>>|\\(<>*\\)",[R]),2),P=n("\\{(?!\\{)(?:(?![}:])<<0>>)*<<1>>?\\}",[F,A]),U=a(n("[^\"'/()]|/(?!\\*)|/\\*(?:[^*]|\\*(?!/))*\\*/|<<0>>|\\(<>*\\)",[E]),2),Z=n("\\{(?!\\{)(?:(?![}:])<<0>>)*<<1>>?\\}",[U,A]);function q(n,a){return{interpolation:{pattern:s("((?:^|[^{])(?:\\{\\{)*)<<0>>",[n]),lookbehind:!0,inside:{"format-string":{pattern:s("(^\\{(?:(?![}:])<<0>>)*)<<1>>(?=\\}$)",[a,A]),lookbehind:!0,inside:{punctuation:/^:/}},punctuation:/^\{|\}$/,expression:{pattern:/[\s\S]+/,alias:"language-csharp",inside:e.languages.csharp}}},string:/[\s\S]+/}}e.languages.insertBefore("csharp","string",{"interpolation-string":[{pattern:s('(^|[^\\\\])(?:\\$@|@\\$)"(?:""|\\\\[^]|\\{\\{|<<0>>|[^\\\\{"])*"',[P]),lookbehind:!0,greedy:!0,inside:q(P,F)},{pattern:s('(^|[^@\\\\])\\$"(?:\\\\.|\\{\\{|<<0>>|[^\\\\"{])*"',[Z]),lookbehind:!0,greedy:!0,inside:q(Z,U)}],char:{pattern:RegExp(_),greedy:!0}}),e.languages.dotnet=e.languages.cs=e.languages.csharp}(Prism); !function(e){var t=/\b(?:alignas|alignof|asm|auto|bool|break|case|catch|char|char16_t|char32_t|char8_t|class|co_await|co_return|co_yield|compl|concept|const|const_cast|consteval|constexpr|constinit|continue|decltype|default|delete|do|double|dynamic_cast|else|enum|explicit|export|extern|final|float|for|friend|goto|if|import|inline|int|int16_t|int32_t|int64_t|int8_t|long|module|mutable|namespace|new|noexcept|nullptr|operator|override|private|protected|public|register|reinterpret_cast|requires|return|short|signed|sizeof|static|static_assert|static_cast|struct|switch|template|this|thread_local|throw|try|typedef|typeid|typename|uint16_t|uint32_t|uint64_t|uint8_t|union|unsigned|using|virtual|void|volatile|wchar_t|while)\b/,n="\\b(?!)\\w+(?:\\s*\\.\\s*\\w+)*\\b".replace(//g,(function(){return t.source}));e.languages.cpp=e.languages.extend("c",{"class-name":[{pattern:RegExp("(\\b(?:class|concept|enum|struct|typename)\\s+)(?!)\\w+".replace(//g,(function(){return t.source}))),lookbehind:!0},/\b[A-Z]\w*(?=\s*::\s*\w+\s*\()/,/\b[A-Z_]\w*(?=\s*::\s*~\w+\s*\()/i,/\b\w+(?=\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>\s*::\s*\w+\s*\()/],keyword:t,number:{pattern:/(?:\b0b[01']+|\b0x(?:[\da-f']+(?:\.[\da-f']*)?|\.[\da-f']+)(?:p[+-]?[\d']+)?|(?:\b[\d']+(?:\.[\d']*)?|\B\.[\d']+)(?:e[+-]?[\d']+)?)[ful]{0,4}/i,greedy:!0},operator:/>>=?|<<=?|->|--|\+\+|&&|\|\||[?:~]|<=>|[-+*/%&|^!=<>]=?|\b(?:and|and_eq|bitand|bitor|not|not_eq|or|or_eq|xor|xor_eq)\b/,boolean:/\b(?:false|true)\b/}),e.languages.insertBefore("cpp","string",{module:{pattern:RegExp('(\\b(?:import|module)\\s+)(?:"(?:\\\\(?:\r\n|[^])|[^"\\\\\r\n])*"|<[^<>\r\n]*>|'+"(?:\\s*:\\s*)?|:\\s*".replace(//g,(function(){return n}))+")"),lookbehind:!0,greedy:!0,inside:{string:/^[<"][\s\S]+/,operator:/:/,punctuation:/\./}},"raw-string":{pattern:/R"([^()\\ ]{0,16})\([\s\S]*?\)\1"/,alias:"string",greedy:!0}}),e.languages.insertBefore("cpp","keyword",{"generic-function":{pattern:/\b(?!operator\b)[a-z_]\w*\s*<(?:[^<>]|<[^<>]*>)*>(?=\s*\()/i,inside:{function:/^\w+/,generic:{pattern:/<[\s\S]+/,alias:"class-name",inside:e.languages.cpp}}}}),e.languages.insertBefore("cpp","operator",{"double-colon":{pattern:/::/,alias:"punctuation"}}),e.languages.insertBefore("cpp","class-name",{"base-clause":{pattern:/(\b(?:class|struct)\s+\w+\s*:\s*)[^;{}"'\s]+(?:\s+[^;{}"'\s]+)*(?=\s*[;{])/,lookbehind:!0,greedy:!0,inside:e.languages.extend("cpp",{})}}),e.languages.insertBefore("inside","double-colon",{"class-name":/\b[a-z_]\w*\b(?!\s*::)/i},e.languages.cpp["base-clause"])}(Prism); !function(e){var n=/\b(?:abstract|assert|boolean|break|byte|case|catch|char|class|const|continue|default|do|double|else|enum|exports|extends|final|finally|float|for|goto|if|implements|import|instanceof|int|interface|long|module|native|new|non-sealed|null|open|opens|package|permits|private|protected|provides|public|record(?!\s*[(){}[\]<>=%~.:,;?+\-*/&|^])|requires|return|sealed|short|static|strictfp|super|switch|synchronized|this|throw|throws|to|transient|transitive|try|uses|var|void|volatile|while|with|yield)\b/,t="(?:[a-z]\\w*\\s*\\.\\s*)*(?:[A-Z]\\w*\\s*\\.\\s*)*",s={pattern:RegExp("(^|[^\\w.])"+t+"[A-Z](?:[\\d_A-Z]*[a-z]\\w*)?\\b"),lookbehind:!0,inside:{namespace:{pattern:/^[a-z]\w*(?:\s*\.\s*[a-z]\w*)*(?:\s*\.)?/,inside:{punctuation:/\./}},punctuation:/\./}};e.languages.java=e.languages.extend("clike",{string:{pattern:/(^|[^\\])"(?:\\.|[^"\\\r\n])*"/,lookbehind:!0,greedy:!0},"class-name":[s,{pattern:RegExp("(^|[^\\w.])"+t+"[A-Z]\\w*(?=\\s+\\w+\\s*[;,=()]|\\s*(?:\\[[\\s,]*\\]\\s*)?::\\s*new\\b)"),lookbehind:!0,inside:s.inside},{pattern:RegExp("(\\b(?:class|enum|extends|implements|instanceof|interface|new|record|throws)\\s+)"+t+"[A-Z]\\w*\\b"),lookbehind:!0,inside:s.inside}],keyword:n,function:[e.languages.clike.function,{pattern:/(::\s*)[a-z_]\w*/,lookbehind:!0}],number:/\b0b[01][01_]*L?\b|\b0x(?:\.[\da-f_p+-]+|[\da-f_]+(?:\.[\da-f_p+-]+)?)\b|(?:\b\d[\d_]*(?:\.[\d_]*)?|\B\.\d[\d_]*)(?:e[+-]?\d[\d_]*)?[dfl]?/i,operator:{pattern:/(^|[^.])(?:<<=?|>>>?=?|->|--|\+\+|&&|\|\||::|[?:~]|[-+*/%&|^!=<>]=?)/m,lookbehind:!0},constant:/\b[A-Z][A-Z_\d]+\b/}),e.languages.insertBefore("java","string",{"triple-quoted-string":{pattern:/"""[ \t]*[\r\n](?:(?:"|"")?(?:\\.|[^"\\]))*"""/,greedy:!0,alias:"string"},char:{pattern:/'(?:\\.|[^'\\\r\n]){1,6}'/,greedy:!0}}),e.languages.insertBefore("java","class-name",{annotation:{pattern:/(^|[^.])@\w+(?:\s*\.\s*\w+)*/,lookbehind:!0,alias:"punctuation"},generics:{pattern:/<(?:[\w\s,.?]|&(?!&)|<(?:[\w\s,.?]|&(?!&)|<(?:[\w\s,.?]|&(?!&)|<(?:[\w\s,.?]|&(?!&))*>)*>)*>)*>/,inside:{"class-name":s,keyword:n,punctuation:/[<>(),.:]/,operator:/[?&|]/}},import:[{pattern:RegExp("(\\bimport\\s+)"+t+"(?:[A-Z]\\w*|\\*)(?=\\s*;)"),lookbehind:!0,inside:{namespace:s.inside.namespace,punctuation:/\./,operator:/\*/,"class-name":/\w+/}},{pattern:RegExp("(\\bimport\\s+static\\s+)"+t+"(?:\\w+|\\*)(?=\\s*;)"),lookbehind:!0,alias:"static",inside:{namespace:s.inside.namespace,static:/\b\w+$/,punctuation:/\./,operator:/\*/,"class-name":/\w+/}}],namespace:{pattern:RegExp("(\\b(?:exports|import(?:\\s+static)?|module|open|opens|package|provides|requires|to|transitive|uses|with)\\s+)(?!)[a-z]\\w*(?:\\.[a-z]\\w*)*\\.?".replace(//g,(function(){return n.source}))),lookbehind:!0,inside:{punctuation:/\./}}})}(Prism); !function(n){n.languages.kotlin=n.languages.extend("clike",{keyword:{pattern:/(^|[^.])\b(?:abstract|actual|annotation|as|break|by|catch|class|companion|const|constructor|continue|crossinline|data|do|dynamic|else|enum|expect|external|final|finally|for|fun|get|if|import|in|infix|init|inline|inner|interface|internal|is|lateinit|noinline|null|object|open|operator|out|override|package|private|protected|public|reified|return|sealed|set|super|suspend|tailrec|this|throw|to|try|typealias|val|var|vararg|when|where|while)\b/,lookbehind:!0},function:[{pattern:/(?:`[^\r\n`]+`|\b\w+)(?=\s*\()/,greedy:!0},{pattern:/(\.)(?:`[^\r\n`]+`|\w+)(?=\s*\{)/,lookbehind:!0,greedy:!0}],number:/\b(?:0[xX][\da-fA-F]+(?:_[\da-fA-F]+)*|0[bB][01]+(?:_[01]+)*|\d+(?:_\d+)*(?:\.\d+(?:_\d+)*)?(?:[eE][+-]?\d+(?:_\d+)*)?[fFL]?)\b/,operator:/\+[+=]?|-[-=>]?|==?=?|!(?:!|==?)?|[\/*%<>]=?|[?:]:?|\.\.|&&|\|\||\b(?:and|inv|or|shl|shr|ushr|xor)\b/}),delete n.languages.kotlin["class-name"];var e={"interpolation-punctuation":{pattern:/^\$\{?|\}$/,alias:"punctuation"},expression:{pattern:/[\s\S]+/,inside:n.languages.kotlin}};n.languages.insertBefore("kotlin","string",{"string-literal":[{pattern:/"""(?:[^$]|\$(?:(?!\{)|\{[^{}]*\}))*?"""/,alias:"multiline",inside:{interpolation:{pattern:/\$(?:[a-z_]\w*|\{[^{}]*\})/i,inside:e},string:/[\s\S]+/}},{pattern:/"(?:[^"\\\r\n$]|\\.|\$(?:(?!\{)|\{[^{}]*\}))*"/,alias:"singleline",inside:{interpolation:{pattern:/((?:^|[^\\])(?:\\{2})*)\$(?:[a-z_]\w*|\{[^{}]*\})/i,lookbehind:!0,inside:e},string:/[\s\S]+/}}],char:{pattern:/'(?:[^'\\\r\n]|\\(?:.|u[a-fA-F0-9]{0,4}))'/,greedy:!0}}),delete n.languages.kotlin.string,n.languages.insertBefore("kotlin","keyword",{annotation:{pattern:/\B@(?:\w+:)?(?:[A-Z]\w*|\[[^\]]+\])/,alias:"builtin"}}),n.languages.insertBefore("kotlin","function",{label:{pattern:/\b\w+@|@\w+\b/,alias:"symbol"}}),n.languages.kt=n.languages.kotlin,n.languages.kts=n.languages.kotlin}(Prism); Prism.languages.objectivec=Prism.languages.extend("c",{string:{pattern:/@?"(?:\\(?:\r\n|[\s\S])|[^"\\\r\n])*"/,greedy:!0},keyword:/\b(?:asm|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|in|inline|int|long|register|return|self|short|signed|sizeof|static|struct|super|switch|typedef|typeof|union|unsigned|void|volatile|while)\b|(?:@interface|@end|@implementation|@protocol|@class|@public|@protected|@private|@property|@try|@catch|@finally|@throw|@synthesize|@dynamic|@selector)\b/,operator:/-[->]?|\+\+?|!=?|<>?=?|==?|&&?|\|\|?|[~^%?*\/@]/}),delete Prism.languages.objectivec["class-name"],Prism.languages.objc=Prism.languages.objectivec; Prism.languages.python={comment:{pattern:/(^|[^\\])#.*/,lookbehind:!0,greedy:!0},"string-interpolation":{pattern:/(?:f|fr|rf)(?:("""|''')[\s\S]*?\1|("|')(?:\\.|(?!\2)[^\\\r\n])*\2)/i,greedy:!0,inside:{interpolation:{pattern:/((?:^|[^{])(?:\{\{)*)\{(?!\{)(?:[^{}]|\{(?!\{)(?:[^{}]|\{(?!\{)(?:[^{}])+\})+\})+\}/,lookbehind:!0,inside:{"format-spec":{pattern:/(:)[^:(){}]+(?=\}$)/,lookbehind:!0},"conversion-option":{pattern:/![sra](?=[:}]$)/,alias:"punctuation"},rest:null}},string:/[\s\S]+/}},"triple-quoted-string":{pattern:/(?:[rub]|br|rb)?("""|''')[\s\S]*?\1/i,greedy:!0,alias:"string"},string:{pattern:/(?:[rub]|br|rb)?("|')(?:\\.|(?!\1)[^\\\r\n])*\1/i,greedy:!0},function:{pattern:/((?:^|\s)def[ \t]+)[a-zA-Z_]\w*(?=\s*\()/g,lookbehind:!0},"class-name":{pattern:/(\bclass\s+)\w+/i,lookbehind:!0},decorator:{pattern:/(^[\t ]*)@\w+(?:\.\w+)*/m,lookbehind:!0,alias:["annotation","punctuation"],inside:{punctuation:/\./}},keyword:/\b(?:_(?=\s*:)|and|as|assert|async|await|break|case|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|match|nonlocal|not|or|pass|print|raise|return|try|while|with|yield)\b/,builtin:/\b(?:__import__|abs|all|any|apply|ascii|basestring|bin|bool|buffer|bytearray|bytes|callable|chr|classmethod|cmp|coerce|compile|complex|delattr|dict|dir|divmod|enumerate|eval|execfile|file|filter|float|format|frozenset|getattr|globals|hasattr|hash|help|hex|id|input|int|intern|isinstance|issubclass|iter|len|list|locals|long|map|max|memoryview|min|next|object|oct|open|ord|pow|property|range|raw_input|reduce|reload|repr|reversed|round|set|setattr|slice|sorted|staticmethod|str|sum|super|tuple|type|unichr|unicode|vars|xrange|zip)\b/,boolean:/\b(?:False|None|True)\b/,number:/\b0(?:b(?:_?[01])+|o(?:_?[0-7])+|x(?:_?[a-f0-9])+)\b|(?:\b\d+(?:_\d+)*(?:\.(?:\d+(?:_\d+)*)?)?|\B\.\d+(?:_\d+)*)(?:e[+-]?\d+(?:_\d+)*)?j?(?!\w)/i,operator:/[-+%=]=?|!=|:=|\*\*?=?|\/\/?=?|<[<=>]?|>[=>]?|[&|^~]/,punctuation:/[{}[\];(),.:]/},Prism.languages.python["string-interpolation"].inside.interpolation.inside.rest=Prism.languages.python,Prism.languages.py=Prism.languages.python; !function(s){var n=['"(?:\\\\[^]|\\$\\([^)]+\\)|\\$(?!\\()|`[^`]+`|[^"\\\\`$])*"',"'[^']*'","\\$'(?:[^'\\\\]|\\\\[^])*'","<<-?\\s*([\"']?)(\\w+)\\1\\s[^]*?[\r\n]\\2"].join("|");s.languages["shell-session"]={command:{pattern:RegExp('^(?:[^\\s@:$#%*!/\\\\]+@[^\r\n@:$#%*!/\\\\]+(?::[^\0-\\x1F$#%*?"<>:;|]+)?|[/~.][^\0-\\x1F$#%*?"<>@:;|]*)?[$#%](?=\\s)'+"(?:[^\\\\\r\n \t'\"<$]|[ \t](?:(?!#)|#.*$)|\\\\(?:[^\r]|\r\n?)|\\$(?!')|<(?!<)|<>)+".replace(/<>/g,(function(){return n})),"m"),greedy:!0,inside:{info:{pattern:/^[^#$%]+/,alias:"punctuation",inside:{user:/^[^\s@:$#%*!/\\]+@[^\r\n@:$#%*!/\\]+/,punctuation:/:/,path:/[\s\S]+/}},bash:{pattern:/(^[$#%]\s*)\S[\s\S]*/,lookbehind:!0,alias:"language-bash",inside:s.languages.bash},"shell-symbol":{pattern:/^[$#%]/,alias:"important"}}},output:/.(?:.*(?:[\r\n]|.$))*/},s.languages["sh-session"]=s.languages.shellsession=s.languages["shell-session"]}(Prism); Prism.languages.swift={comment:{pattern:/(^|[^\\:])(?:\/\/.*|\/\*(?:[^/*]|\/(?!\*)|\*(?!\/)|\/\*(?:[^*]|\*(?!\/))*\*\/)*\*\/)/,lookbehind:!0,greedy:!0},"string-literal":[{pattern:RegExp('(^|[^"#])(?:"(?:\\\\(?:\\((?:[^()]|\\([^()]*\\))*\\)|\r\n|[^(])|[^\\\\\r\n"])*"|"""(?:\\\\(?:\\((?:[^()]|\\([^()]*\\))*\\)|[^(])|[^\\\\"]|"(?!""))*""")(?!["#])'),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\\()(?:[^()]|\([^()]*\))*(?=\))/,lookbehind:!0,inside:null},"interpolation-punctuation":{pattern:/^\)|\\\($/,alias:"punctuation"},punctuation:/\\(?=[\r\n])/,string:/[\s\S]+/}},{pattern:RegExp('(^|[^"#])(#+)(?:"(?:\\\\(?:#+\\((?:[^()]|\\([^()]*\\))*\\)|\r\n|[^#])|[^\\\\\r\n])*?"|"""(?:\\\\(?:#+\\((?:[^()]|\\([^()]*\\))*\\)|[^#])|[^\\\\])*?""")\\2'),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\#+\()(?:[^()]|\([^()]*\))*(?=\))/,lookbehind:!0,inside:null},"interpolation-punctuation":{pattern:/^\)|\\#+\($/,alias:"punctuation"},string:/[\s\S]+/}}],directive:{pattern:RegExp("#(?:(?:elseif|if)\\b(?:[ \t]*(?:![ \t]*)?(?:\\b\\w+\\b(?:[ \t]*\\((?:[^()]|\\([^()]*\\))*\\))?|\\((?:[^()]|\\([^()]*\\))*\\))(?:[ \t]*(?:&&|\\|\\|))?)+|(?:else|endif)\\b)"),alias:"property",inside:{"directive-name":/^#\w+/,boolean:/\b(?:false|true)\b/,number:/\b\d+(?:\.\d+)*\b/,operator:/!|&&|\|\||[<>]=?/,punctuation:/[(),]/}},literal:{pattern:/#(?:colorLiteral|column|dsohandle|file(?:ID|Literal|Path)?|function|imageLiteral|line)\b/,alias:"constant"},"other-directive":{pattern:/#\w+\b/,alias:"property"},attribute:{pattern:/@\w+/,alias:"atrule"},"function-definition":{pattern:/(\bfunc\s+)\w+/,lookbehind:!0,alias:"function"},label:{pattern:/\b(break|continue)\s+\w+|\b[a-zA-Z_]\w*(?=\s*:\s*(?:for|repeat|while)\b)/,lookbehind:!0,alias:"important"},keyword:/\b(?:Any|Protocol|Self|Type|actor|as|assignment|associatedtype|associativity|async|await|break|case|catch|class|continue|convenience|default|defer|deinit|didSet|do|dynamic|else|enum|extension|fallthrough|fileprivate|final|for|func|get|guard|higherThan|if|import|in|indirect|infix|init|inout|internal|is|isolated|lazy|left|let|lowerThan|mutating|none|nonisolated|nonmutating|open|operator|optional|override|postfix|precedencegroup|prefix|private|protocol|public|repeat|required|rethrows|return|right|safe|self|set|some|static|struct|subscript|super|switch|throw|throws|try|typealias|unowned|unsafe|var|weak|where|while|willSet)\b/,boolean:/\b(?:false|true)\b/,nil:{pattern:/\bnil\b/,alias:"constant"},"short-argument":/\$\d+\b/,omit:{pattern:/\b_\b/,alias:"keyword"},number:/\b(?:[\d_]+(?:\.[\de_]+)?|0x[a-f0-9_]+(?:\.[a-f0-9p_]+)?|0b[01_]+|0o[0-7_]+)\b/i,"class-name":/\b[A-Z](?:[A-Z_\d]*[a-z]\w*)?\b/,function:/\b[a-z_]\w*(?=\s*\()/i,constant:/\b(?:[A-Z_]{2,}|k[A-Z][A-Za-z_]+)\b/,operator:/[-+*/%=!<>&|^~?]+|\.[.\-+*/%=!<>&|^~?]+/,punctuation:/[{}[\]();,.:\\]/},Prism.languages.swift["string-literal"].forEach((function(e){e.inside.interpolation.inside=Prism.languages.swift})); !function(){if("undefined"!=typeof Prism){var e=Object.assign||function(e,t){for(var n in t)t.hasOwnProperty(n)&&(e[n]=t[n]);return e},t={"remove-trailing":"boolean","remove-indent":"boolean","left-trim":"boolean","right-trim":"boolean","break-lines":"number",indent:"number","remove-initial-line-feed":"boolean","tabs-to-spaces":"number","spaces-to-tabs":"number"};n.prototype={setDefaults:function(t){this.defaults=e(this.defaults,t)},normalize:function(t,n){for(var r in n=e(this.defaults,n)){var i=r.replace(/-(\w)/g,(function(e,t){return t.toUpperCase()}));"normalize"!==r&&"setDefaults"!==i&&n[r]&&this[i]&&(t=this[i].call(this,t,n[r]))}return t},leftTrim:function(e){return e.replace(/^\s+/,"")},rightTrim:function(e){return e.replace(/\s+$/,"")},tabsToSpaces:function(e,t){return t=0|t||4,e.replace(/\t/g,new Array(++t).join(" "))},spacesToTabs:function(e,t){return t=0|t||4,e.replace(RegExp(" {"+t+"}","g"),"\t")},removeTrailing:function(e){return e.replace(/\s*?$/gm,"")},removeInitialLineFeed:function(e){return e.replace(/^(?:\r?\n|\r)/,"")},removeIndent:function(e){var t=e.match(/^[^\S\n\r]*(?=\S)/gm);return t&&t[0].length?(t.sort((function(e,t){return e.length-t.length})),t[0].length?e.replace(RegExp("^"+t[0],"gm"),""):e):e},indent:function(e,t){return e.replace(/^[^\S\n\r]*(?=\S)/gm,new Array(++t).join("\t")+"$&")},breakLines:function(e,t){t=!0===t?80:0|t||80;for(var n=e.split("\n"),i=0;it&&(o[l]="\n"+o[l],a=s)}n[i]=o.join("")}return n.join("\n")}},"undefined"!=typeof module&&module.exports&&(module.exports=n),Prism.plugins.NormalizeWhitespace=new n({"remove-trailing":!0,"remove-indent":!0,"left-trim":!0,"right-trim":!0}),Prism.hooks.add("before-sanity-check",(function(e){var n=Prism.plugins.NormalizeWhitespace;if((!e.settings||!1!==e.settings["whitespace-normalization"])&&Prism.util.isActive(e.element,"whitespace-normalization",!0))if(e.element&&e.element.parentNode||!e.code){var r=e.element.parentNode;if(e.code&&r&&"pre"===r.nodeName.toLowerCase()){for(var i in null==e.settings&&(e.settings={}),t)if(Object.hasOwnProperty.call(t,i)){var o=t[i];if(r.hasAttribute("data-"+i))try{var a=JSON.parse(r.getAttribute("data-"+i)||"true");typeof a===o&&(e.settings[i]=a)}catch(e){}}for(var l=r.childNodes,s="",c="",u=!1,m=0;m table { border-style: hidden; } #feature-matrix th { border: 1px #999 solid; padding: 10px 2px; background-color: #007aff; color: white; text-align: center; } #feature-matrix tr { } #feature-matrix td { border: 1px #999 solid; padding: 10px 2px; text-align: center; } #feature-matrix tr td.yes { background-color: #83e57c !important; color: #000; } #feature-matrix tr td.yes::before { content: "✔︎ "; } #feature-matrix tr td.no { background-color: #e5887c !important; color: #000; } #feature-matrix tr td.no::before { content: "✕ "; } #feature-matrix tr td.limited { background-color: #e4c07b !important; color: #000; } #feature-matrix .icon-holder { line-height: 40px; } #feature-matrix .icon { text-indent: 45px; line-height: 40px; width: 100px; height: 40px; } #feature-matrix .icon.pdf { background: url("_images/icon-pdf.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.xps { background: url("_images/icon-xps.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.epub { background: url("_images/icon-epub.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.mobi { background: url("_images/icon-mobi.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.fb2 { background: url("_images/icon-fb2.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.cbz { background: url("_images/icon-cbz.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.svg { background: url("_images/icon-svg.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.image { background: url("_images/icon-image.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.txt { background: url("_images/icon-txt.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.docx { background: url("_images/icon-docx.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.pptx { background: url("_images/icon-pptx.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.xlsx { background: url("_images/icon-xlsx.svg") 0 0 transparent no-repeat; background-size: 40px 40px; } #feature-matrix .icon.hangul { background: url("_images/icon-hangul.svg") 0 0 transparent no-repeat; background-size: 40px 40px; }
Feature PyMuPDF pikepdf PyPDF2 pdfrw pdfplumber / pdfminer
Supports Multiple Document Formats PDF XPS EPUB MOBI FB2 CBZ SVG TXT Image
DOCX XLSX PPTX HWPX See note 		PDF PDF PDF PDF
Implementation Python and C Python and C++ Python Python Python
Render Document Pages All document types No rendering No rendering No rendering No rendering
Write Text to PDF Page
See: Page.insert_htmlbox
or:
Page.insert_textbox
or:
TextWriter
Supports CJK characters
Extract Text All document types PDF only PDF only
Extract Text as Markdown (.md) All document types
Extract Tables All document types PDF only
Extract Vector Graphics All document types Limited
Draw Vector Graphics (PDF)
Based on Existing, Mature Library MuPDF QPDF
Automatic Repair of Damaged PDFs
Encrypted PDFs Limited Limited
Linerarized PDFs
Incremental Updates
Integrates with Jupyter and IPython Notebooks
Joining / Merging PDF with other Document Types All document types PDF only PDF only PDF only PDF only
OCR API for Seamless Integration with Tesseract All document types
Integrated Checkpoint / Restart Feature (PDF)
PDF Optional Content
PDF Embedded Files Limited Limited
PDF Redactions
PDF Annotations Full Limited
PDF Form Fields Create, read, update Limited, no creation
PDF Page Labels Read-only
Support Font Sub-Setting

================================================ FILE: docs/about-performance.rst ================================================ .. raw:: html
Copying

This refers to opening a document and then saving it to a new file. This test measures the speed of reading a PDF and re-writing as a new PDF. This process is also at the core of functions like merging / joining multiple documents. The numbers below therefore apply to PDF joining and merging.

The results for all 7,031 pages are:

600
500
400
300
200
100

⏱

seconds
3.05
10.54
33.57
494.04
PyMuPDF
PDFrw
PikePDF
PyPDF2
fastest
←
←
slowest

Text Extraction

This refers to extracting simple, plain text from every page of the document and storing it in a text file.

The results for all 7,031 pages are:

400
300
200
100

⏱

seconds
8.01
27.42
101.64
227.27
PyMuPDF
XPDF
PyPDF2
PDFMiner
fastest
←
←
slowest

Rendering

This refers to making an image (like PNG) from every page of a document at a given DPI resolution. This feature is the basis for displaying a document in a GUI window.

The results for all 7,031 pages are:

1000
800
600
400
200

⏱

seconds
367.04
646
851.52
PyMuPDF
XPDF
PDF2JPG
fastest
←
slowest

================================================ FILE: docs/about.rst ================================================ .. include:: header.rst .. _About: .. _About_Features: Features Comparison ----------------------------------------------- .. _About_Feature_Matrix: Feature Matrix ~~~~~~~~~~~~~~~~~~~ The following table illustrates how |PyMuPDF| compares with other typical solutions. .. include:: about-feature-matrix.rst ---- .. note:: .. image:: images/icons/icon-docx.svg :width: 40 :height: 40 :alt: DOCX icon .. image:: images/icons/icon-xlsx.svg :width: 40 :height: 40 :alt: XLSX icon .. image:: images/icons/icon-pptx.svg :width: 40 :height: 40 :alt: PPTX icon .. image:: images/icons/icon-hangul.svg :width: 40 :height: 40 :alt: HWPX icon A note about **Office** document types (DOCX, XLXS, PPTX) and **Hangul** documents (HWPX). These documents can be loaded into |PyMuPDF| and you will receive a :ref:`Document ` object. There are some caveats: - we convert the input to **HTML** to layout the content. - because of this the original page separation has gone. When saving out the result any faithful representation of the original layout cannot be expected. Therefore input files are mostly in a form that's useful for text extraction. ---- .. _About_PyMuPDF_Product_Suite: PyMuPDF Product Suite ----------------------------------------------- |PyMuPDF| is the standard version of the library, however there are a family of additional products each with different features and functionality. **Additional products** in the |PyMuPDF| product suite are: - |PyMuPDF Pro| adds support for Office document formats. - |PyMuPDF4LLM| is optimized for large language model (LLM) applications, providing enhanced text extraction and processing capabilities. It focuses on layout analysis and semantic understanding, ideal for document conversion and formatting tasks with enhanced results. .. note:: All of the products above depend on the same core product - |PyMuPDF| and therefore have full access to all of its features. These additional products can be seen as optional extras to the enhance the core |PyMuPDF| library. .. _About_PyMuPDF_Products_Comparison: PyMuPDF Products Comparison ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following table illustrates what features the products offer: .. list-table:: PyMuPDF Products Comparison :widths: 10 30 30 30 :header-rows: 1 * - - PyMuPDF - PyMuPDF Pro - PyMuPDF4LLM * - **Input Documents** - `PDF`, `XPS`, `EPUB`, `CBZ`, `MOBI`, `FB2`, `SVG`, `TXT`, Images (*standard document types*) - *as PyMuPDF* and: `DOC`/`DOCX`, `XLS`/`XLSX`, `PPT`/`PPTX`, `HWP`/`HWPX` - *as PyMuPDF* * - **Output Documents** - Can convert any input document to `PDF`, `SVG` or Image - *as PyMuPDF* - *as PyMuPDF* and: Markdown (`MD`), `JSON` or `TXT` * - **Page Analysis** - Basic page analysis to return document structure - *as PyMuPDF* - Advanced Page Analysis with trained data for enhanced results * - **Data extraction** - Basic data extraction with structured layout information and bounding box data - *as PyMuPDF* - Advanced data extraction including layout analysis with semantic understanding and enhanced bounding box data * - **Table extraction** - Basic table extraction as part of text extraction - *as PyMuPDF* - Advanced table extraction with cell structure, including support for merged cells and complex layouts * - **Image extraction** - Basic image extraction - *as PyMuPDF* - Advanced detection and rendering of image areas on page saving them to disk or embedding in MD output * - **Vector extraction** - Vector extraction and clustering - *as PyMuPDF* - Superior detection of "picture" areas * - **Popular RAG Integrations** - Langchain, LlamaIndex - *as PyMuPDF* - *as PyMuPDF* and with some additional help methods for RAG workflows * - **OCR** - On-demand invocation of built-in Tesseract for text detection on pages or images - *as PyMuPDF* - Automatic OCR based on page content analysis. OCR adapators for popular OCR engines available ---- .. _About_Performance: Performance ----------------------------------------------- To benchmark |PyMuPDF| performance against a range of tasks a test suite with a fixed set of :ref:`8 PDFs with a total of 7,031 pages` containing text & images is used to obtain performance timings. Here are current results, grouped by task: .. include:: about-performance.rst .. note:: For more detail regarding the methodology for these performance timings see: :ref:`Performance Comparison Methodology`. .. _About_License: License and Copyright ---------------------- |PyMuPDF| and |MuPDF| are now available under both, open-source |AGPL| and commercial license agreements. Please read the full text of the |AGPL| license agreement, available in the distribution material (file COPYING) and `on the GNU license page `_, to ensure that your use case complies with the guidelines of the license. If you determine you cannot meet the requirements of the |AGPL|, please contact `Artifex `_ for more information regarding a commercial license. .. raw:: html

:title:`Artifex` is the exclusive commercial licensing agent for :title:`MuPDF`. :title:`Artifex`, the :title:`Artifex` logo, :title:`MuPDF`, and the :title:`MuPDF` logo are registered trademarks of :title:`Artifex Software Inc.` .. include:: version.rst .. include:: footer.rst ================================================ FILE: docs/algebra.rst ================================================ .. include:: header.rst .. _Algebra: Operator Algebra for Geometry Objects ====================================== .. highlight:: python Instances of classes :ref:`Point`, :ref:`IRect`, :ref:`Rect`, :ref:`Quad` and :ref:`Matrix` are collectively also called "geometry" objects. They all are special cases of Python sequences, see :ref:`SequenceTypes` for more background. We have defined operators for these classes that allow dealing with them (almost) like ordinary numbers in terms of addition, subtraction, multiplication, division, and some others. This chapter is a synopsis of what is possible. General Remarks ----------------- 1. Operators can be either **binary** (i.e. involving two objects) or **unary**. 2. The resulting type of **binary** operations is either a **new object of the left operand's class,** a bool or (for dot products) a float. 3. The result of **unary** operations is either a **new object** of the same class, a bool or a float. 4. The binary operators `+, -, *, /` are defined for all classes. They *roughly* do what you would expect -- **except, that the second operand ...** - may always be a number which then performs the operation on every component of the first one, - may always be a numeric sequence of the same length (2, 4 or 6) -- we call such sequences :data:`point_like`, :data:`rect_like`, :data:`quad_like` or :data:`matrix_like`, respectively. 5. Rectangles support **additional binary** operations: **intersection** (operator `"&"`), **union** (operator `"|"`) and **containment** checking. 6. Binary operators fully support in-place operations. So if "°" is a binary operator then the expression `a °= b` is always valid and the same as `a = a ° b`. Therefore, be careful and do **not** do `p1 *= p2` for two points, because thereafter "p1" is a **float**. Unary Operations ------------------ =========== =================================================================== Oper. Result =========== =================================================================== bool(OBJ) is false exactly if all components of OBJ are zero abs(OBJ) the rectangle area -- equal to norm(OBJ) for the other types norm(OBJ) square root of the component squares (Euclidean norm) +OBJ new copy of OBJ -OBJ new copy of OBJ with negated components ~m inverse of matrix "m", or the null matrix if not invertible =========== =================================================================== Binary Operations ------------------ These are expressions like `a ° b` where "°" is any of the operators `+, -, *, /`. Also binary operations are expressions of the form `a == b` and `b in a`. If "b" is a number, then the respective operation is executed for each component of "a". Otherwise, if "b" is **not a number,** then the following happens: ========= =========================================================================== Oper. Result ========= =========================================================================== a+b, a-b component-wise execution, "b" must be "a-like". a*m, a/m "a" can be a point, rectangle or matrix and "m" is a :data:`matrix_like`. *"a/m"* is treated as *"a*~m"* (see note below for non-invertible matrices). If "a" is a **point** or a **rectangle**, then *"a.transform(m)"* is executed. If "a" is a matrix, then matrix concatenation takes place. a*b returns the **vector dot product** for a point "a" and point-like "b". a&b **intersection rectangle:** "a" must be a rectangle and "b" :data:`rect_like`. Delivers the **largest rectangle** contained in both operands. a|b **union rectangle:** "a" must be a rectangle, and "b" may be :data:`point_like` or :data:`rect_like`. Delivers the **smallest rectangle** containing both operands. b in a if "b" is a number, then `b in tuple(a)` is returned. If "b" is :data:`point_like`, :data:`rect_like` or :data:`quad_like`, then "a" must be a rectangle, and `a.contains(b)` is returned. a == b ``True`` if *bool(a-b)* is ``False`` ("b" may be "a-like"). ========= =========================================================================== .. note:: Please note an important difference to usual arithmetic: Matrix multiplication is **not commutative**, i.e. in general we have `m*n != n*m` for two matrices. Also, there are non-zero matrices which have no inverse, for example `m = Matrix(1, 0, 1, 0, 1, 0)`. If you try to divide by any of these, you will receive a `ZeroDivisionError` exception using operator *"/"*, e.g. for the expression `pymupdf.Identity / m`. But if you formulate `pymupdf.Identity * ~m`, the result will be `pymupdf.Matrix()` (the null matrix). Admittedly, this represents an inconsistency, and we are considering to remove it. For the time being, you can choose to avoid an exception and check whether ~m is the null matrix, or accept a potential *ZeroDivisionError* by using `pymupdf.Identity / m`. .. note:: * With these conventions, all the usual algebra rules apply. For example, arbitrarily using brackets **(among objects of the same class!)** is possible: if r1, r2 are rectangles and m1, m2 are matrices, you can do this `(r1 + r2) * m1 * m2`. * For all objects of the same class, `a + b + c == (a + b) + c == a + (b + c)` is true. * For matrices in addition the following is true: `(m1 + m2) * m3 == m1 * m3 + m2 * m3` (distributivity property). * **But the sequence of applying matrices is important:** If r is a rectangle and m1, m2 are matrices, then -- **caution!:** - `r * m1 * m2 == (r * m1) * m2 != r * (m1 * m2)` Some Examples -------------- Manipulation with numbers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For the usual arithmetic operations, numbers are always allowed as second operand. In addition, you can formulate `"x in OBJ"`, where x is a number. It is implemented as `"x in tuple(OBJ)"`:: >>> pymupdf.Rect(1, 2, 3, 4) + 5 pymupdf.Rect(6.0, 7.0, 8.0, 9.0) >>> 3 in pymupdf.Rect(1, 2, 3, 4) True >>> The following will create the upper left quarter of a document page rectangle:: >>> page.rect Rect(0.0, 0.0, 595.0, 842.0) >>> page.rect / 2 Rect(0.0, 0.0, 297.5, 421.0) >>> The following will deliver the **middle point of a line** that connects two points **p1** and **p2**:: >>> p1 = pymupdf.Point(1, 2) >>> p2 = pymupdf.Point(4711, 3141) >>> mp = (p1 + p2) / 2 >>> mp Point(2356.0, 1571.5) >>> Compute the **vector dot product** of two points. You can compute the **cosine of angles** and check orthogonality. >>> p1 = pymupdf.Point(1, 0) >>> p2 = pymupdf.Point(1, 1) >>> dot = p1 * p2 >>> dot 1.0 >>> # compute the cosine of the angle between p1 and p2: >>> cosine = dot / (abs(p1) * abs(p2)) >>> cosine # cosine of 45 degrees 0.7071067811865475 >>> math.cos(mat.radians(45)) # verify: 0.7071067811865476 >>> # check orhogonality >>> p3 = pymupdf.Point(0, 1) >>> # p1 and p3 are orthogonal so, as expected: >>> p1 * p3 0.0 Manipulation with "like" Objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The second operand of a binary operation can always be "like" the left operand. "Like" in this context means "a sequence of numbers of the same length". With the above examples:: >>> p1 + p2 Point(4712.0, 3143.0) >>> p1 + (4711, 3141) Point(4712.0, 3143.0) >>> p1 += (4711, 3141) >>> p1 Point(4712.0, 3143.0) >>> To shift a rectangle for 5 pixels to the right, do this:: >>> pymupdf.Rect(100, 100, 200, 200) + (5, 0, 5, 0) # add 5 to the x coordinates Rect(105.0, 100.0, 205.0, 200.0) >>> Points, rectangles and matrices can be *transformed* with matrices. In PyMuPDF, we treat this like a **"multiplication"** (or resp. **"division"**), where the second operand may be "like" a matrix. Division in this context means "multiplication with the inverted matrix":: >>> m = pymupdf.Matrix(1, 2, 3, 4, 5, 6) >>> n = pymupdf.Matrix(6, 5, 4, 3, 2, 1) >>> p = pymupdf.Point(1, 2) >>> p * m Point(12.0, 16.0) >>> p * (1, 2, 3, 4, 5, 6) Point(12.0, 16.0) >>> p / m Point(2.0, -2.0) >>> p / (1, 2, 3, 4, 5, 6) Point(2.0, -2.0) >>> >>> m * n # matrix multiplication Matrix(14.0, 11.0, 34.0, 27.0, 56.0, 44.0) >>> m / n # matrix division Matrix(2.5, -3.5, 3.5, -4.5, 5.5, -7.5) >>> >>> m / m # result is equal to the Identity matrix Matrix(1.0, 0.0, 0.0, 1.0, 0.0, 0.0) >>> >>> # look at this non-invertible matrix: >>> m = pymupdf.Matrix(1, 0, 1, 0, 1, 0) >>> ~m Matrix(0.0, 0.0, 0.0, 0.0, 0.0, 0.0) >>> # we try dividing by it in two ways: >>> p = pymupdf.Point(1, 2) >>> p * ~m # this delivers point (0, 0): Point(0.0, 0.0) >>> p / m # but this is an exception: Traceback (most recent call last): File "", line 1, in p / m File "... /site-packages/fitz/pymupdf.py", line 869, in __truediv__ raise ZeroDivisionError("matrix not invertible") ZeroDivisionError: matrix not invertible >>> As a specialty, rectangles support additional binary operations: * **intersection** -- the common area of rectangle-likes, operator *"&"* * **inclusion** -- enlarge to include a point-like or rect-like, operator *"|"* * **containment** check -- whether a point-like or rect-like is inside Here is an example for creating the smallest rectangle enclosing given points:: >>> # first define some point-likes >>> points = [] >>> for i in range(10): for j in range(10): points.append((i, j)) >>> >>> # now create a rectangle containing all these 100 points >>> # start with an empty rectangle >>> r = pymupdf.Rect(points[0], points[0]) >>> for p in points[1:]: # and include remaining points one by one r |= p >>> r # here is the to be expected result: Rect(0.0, 0.0, 9.0, 9.0) >>> (4, 5) in r # this point-like lies inside the rectangle True >>> # and this rect-like is also inside >>> (4, 4, 5, 5) in r True >>> .. include:: footer.rst ================================================ FILE: docs/annot.rst ================================================ .. include:: header.rst .. _Annot: ================ Annot ================ |pdf_only_class| Quote from the :ref:`AdobeManual`: *"An annotation associates an object such as a note, sound, or movie with a location on a page of a PDF document, or provides a way to interact with the user by means of the mouse and keyboard."* There is a parent-child relationship between an annotation and its page. If the page object becomes unusable (closed document, any document structure change, etc.), then so does every of its existing annotation objects -- an exception is raised saying that the object is "orphaned", whenever an annotation property or method is accessed. ================================== ============================================================== **Attribute** **Short Description** ================================== ============================================================== :meth:`Annot.delete_responses` delete all responding annotations :meth:`Annot.get_file` get attached file content :meth:`Annot.get_oc` get :data:`xref` of an :data:`OCG` / :data:`OCMD` :meth:`Annot.get_pixmap` image of the annotation as a pixmap :meth:`Annot.get_sound` get the sound of an audio annotation :meth:`Annot.get_text` extract annotation text :meth:`Annot.get_textbox` extract annotation text :meth:`Annot.get_textpage` create a TextPage for the annotation :meth:`Annot.set_border` set annotation's border properties :meth:`Annot.set_blendmode` set annotation's blend mode :meth:`Annot.set_colors` set annotation's colors :meth:`Annot.set_flags` set annotation's flags field :meth:`Annot.set_irt_xref` define the annotation to being "In Response To" :meth:`Annot.set_name` set annotation's name field :meth:`Annot.set_oc` set :data:`xref` to an :data:`OCG` / :data:`OCMD` :meth:`Annot.set_opacity` change transparency :meth:`Annot.set_open` open / close annotation or its Popup :meth:`Annot.set_popup` create a Popup for the annotation :meth:`Annot.set_rect` change annotation rectangle :meth:`Annot.set_rotation` change rotation :meth:`Annot.update_file` update attached file content :meth:`Annot.update` apply accumulated annot changes :attr:`Annot.blendmode` annotation BlendMode :attr:`Annot.border` border details :attr:`Annot.colors` border / background and fill colors :attr:`Annot.file_info` get attached file information :attr:`Annot.flags` annotation flags :attr:`Annot.has_popup` whether annotation has a Popup :attr:`Annot.irt_xref` annotation to which this one responds :attr:`Annot.info` various information :attr:`Annot.is_open` whether annotation or its Popup is open :attr:`Annot.line_ends` start / end appearance of line-type annotations :attr:`Annot.next` link to the next annotation :attr:`Annot.opacity` the annot's transparency :attr:`Annot.parent` page object of the annotation :attr:`Annot.popup_rect` rectangle of the annotation's Popup :attr:`Annot.popup_xref` the PDF :data:`xref` number of the annotation's Popup :attr:`Annot.rect` rectangle containing the annotation :attr:`Annot.type` type of the annotation :attr:`Annot.vertices` point coordinates of Polygons, PolyLines, etc. :attr:`Annot.xref` the PDF :data:`xref` number ================================== ============================================================== **Class API** .. class:: Annot .. index:: pair: matrix; Annot.get_pixmap pair: colorspace; Annot.get_pixmap pair: alpha; Annot.get_pixmap pair: dpi; Annot.get_pixmap .. method:: get_pixmap(matrix=pymupdf.Identity, dpi=None, colorspace=pymupdf.csRGB, alpha=False) * Changed in v1.19.2: added support of dpi parameter. Creates a pixmap from the annotation as it appears on the page in untransformed coordinates. The pixmap's :ref:`IRect` equals *Annot.rect.irect* (see below). **All parameters are keyword only.** :arg matrix_like matrix: a matrix to be used for image creation. Default is :ref:`Identity`. :arg int dpi: (new in v1.19.2) desired resolution in dots per inch. If not `None`, the matrix parameter is ignored. :arg colorspace: a colorspace to be used for image creation. Default is ``pymupdf.csRGB``. :type colorspace: :ref:`Colorspace` :arg bool alpha: whether to include transparency information. Default is ``False``. :rtype: :ref:`Pixmap` .. note:: * If the annotation has just been created or modified, you should :meth:`Document.reload_page` the page first via `page = doc.reload_page(page)`. * The pixmap will have *"premultiplied"* pixels if `alpha=True`. To learn about some background, e.g. look for "Premultiplied alpha" `in this online glossary `_. .. index:: pair: blocks; Annot.get_text pair: dict; Annot.get_text pair: clip; Annot.get_text pair: flags; Annot.get_text pair: html; Annot.get_text pair: json; Annot.get_text pair: rawdict; Annot.get_text pair: text; Annot.get_text pair: words; Annot.get_text pair: xhtml; Annot.get_text pair: xml; Annot.get_text .. method:: get_text(opt, clip=None, flags=None) * New in 1.18.0 Retrieves the content of the annotation in a variety of formats -- much like the same method for :ref:`Page`.. This currently only delivers relevant data for annotation types 'FreeText' and 'Stamp'. Other types return an empty string (or equivalent objects). :arg str opt: (positional only) the desired format - one of the following values. Please note that this method works exactly like the same-named method of :ref:`Page`. * "text" -- :meth:`TextPage.extractTEXT`, default * "blocks" -- :meth:`TextPage.extractBLOCKS` * "words" -- :meth:`TextPage.extractWORDS` * "html" -- :meth:`TextPage.extractHTML` * "xhtml" -- :meth:`TextPage.extractXHTML` * "xml" -- :meth:`TextPage.extractXML` * "dict" -- :meth:`TextPage.extractDICT` * "json" -- :meth:`TextPage.extractJSON` * "rawdict" -- :meth:`TextPage.extractRAWDICT` :arg rect-like clip: (keyword only) restrict the extraction to this area. Should hardly ever be required, defaults to :attr:`Annot.rect`. :arg int flags: (keyword only) control the amount of data returned. Defaults to simple text extraction. .. method:: get_textbox(rect) * New in 1.18.0 Return the annotation text. Mostly (except line breaks) equal to :meth:`Annot.get_text` with the "text" option. :arg rect-like rect: the area to consider, defaults to :attr:`Annot.rect`. .. method:: get_textpage(clip=None, flags=3) Create a :ref:`TextPage` for the annotation. :arg int flags: indicator bits controlling the content available for subsequent text extractions and searches -- see the parameter of :meth:`Annot.get_text`. :arg rect-like clip: restrict extracted text to this area. :returns: :ref:`TextPage` |history_begin| * v1.25.5: fixed `clip` arg. |history_end| .. method:: set_info(info=None, content=None, title=None, creationDate=None, modDate=None, subject=None) * Changed in version 1.16.10 Changes annotation properties. These include dates, contents, subject and author (title). Changes for *name* and *id* will be ignored. The update happens selectively: To leave a property unchanged, set it to ``None``. To delete existing data, use an empty string. :arg dict info: a dictionary compatible with the *info* property (see below). All entries must be strings. If this argument is not a dictionary, the other arguments are used instead -- else they are ignored. :arg str content: *(new in v1.16.10)* see description in :attr:`info`. :arg str title: *(new in v1.16.10)* see description in :attr:`info`. :arg str creationDate: *(new in v1.16.10)* date of annot creation. If given, should be in PDF datetime format. :arg str modDate: *(new in v1.16.10)* date of last modification. If given, should be in PDF datetime format. :arg str subject: *(new in v1.16.10)* see description in :attr:`info`. .. method:: set_line_ends(start, end) Sets an annotation's line ending styles. Each of these annotation types is defined by a list of points which are connected by lines. The symbol identified by *start* is attached to the first point, and *end* to the last point of this list. For unsupported annotation types, a no-operation with a warning message results. .. note:: * Some symbols have an interior area (diamonds, circles, squares, etc.). These areas are filled with the fill color or the stroke color, depending on the annotation type. :arg int start: The symbol number for the first point. :arg int end: The symbol number for the last point. .. method:: set_oc(xref) Set the annotation's visibility using PDF optional content mechanisms. This visibility is controlled by the user interface of supporting PDF viewers. It is independent from other attributes like :attr:`Annot.flags`. :arg int xref: the :data:`xref` of an optional contents group (OCG or OCMD). Any previous xref will be overwritten. If zero, a previous entry will be removed. An exception occurs if the xref is not zero and does not point to a valid PDF object. .. note:: This does **not require executing** :meth:`Annot.update` to take effect. .. method:: get_oc() Return the :data:`xref` of an optional content object, or zero if there is none. :returns: zero or the xref of an OCG (or OCMD). .. method:: set_irt_xref(xref) * New in v1.19.3 Set annotation to be "In Response To" another one. :arg int xref: The :data:`xref` of another annotation. .. note:: Must refer to an existing annotation on this page. Setting this property requires no subsequent `update()`. .. method:: set_open(value) * New in v1.18.4 Set the annotation's Popup annotation to open or closed -- **or** the annotation itself, if its type is 'Text' ("sticky note"). :arg bool value: the desired open state. .. method:: set_popup(rect) * New in v1.18.4 Create a Popup annotation for the annotation and specify its rectangle. If the Popup already exists, only its rectangle is updated. :arg rect_like rect: the desired rectangle. .. method:: set_opacity(value) Set the annotation's transparency. Opacity can also be set in :meth:`Annot.update`. :arg float value: a float in range *[0, 1]*. Any value outside is assumed to be 1. E.g. a value of 0.5 sets the transparency to 50%. Three overlapping 'Circle' annotations with each opacity set to 0.5: .. image:: images/img-opacity.* .. attribute:: blendmode * New in v1.18.4 The annotation's blend mode. See :ref:`AdobeManual`, page 324 for explanations. :rtype: str :returns: the blend mode or ``None``. .. method:: set_blendmode(blendmode) * New in v1.16.14 Set the annotation's blend mode. See :ref:`AdobeManual`, page 324 for explanations. The blend mode can also be set in :meth:`Annot.update`. :arg str blendmode: set the blend mode. Use :meth:`Annot.update` to reflect this in the visual appearance. For predefined values see :ref:`BlendModes`. Use `PDF_BM_Normal` to **remove** a blend mode. .. method:: set_name(name) * New in version 1.16.0 Change the name field of any annotation type. For 'FileAttachment' and 'Text' annotations, this is the icon name, for 'Stamp' annotations the text in the stamp. The visual result (if any) depends on your PDF viewer. See also :ref:`mupdficons`. :arg str name: the new name. .. caution:: If you set the name of a 'Stamp' annotation, then this will **not change** the rectangle, nor will the text be layouted in any way. If you choose a standard text from :ref:`StampIcons` (the **exact** name piece after `"STAMP_"`), you should receive the original layout. An **arbitrary text** will not be changed to upper case, but be written in font "Times-Bold" as is, horizontally centered in **one line** and be shortened to fit. To get your text fully displayed, its length using :data:`fontsize` 20 must not exceed 190 points. So please make sure that the following inequality is true: `pymupdf.get_text_length(text, fontname="tibo", fontsize=20) <= 190`. .. method:: set_rect(rect) Change the rectangle of an annotation. The annotation can be moved around and both sides of the rectangle can be independently scaled. However, the annotation appearance will never get rotated, flipped or sheared. This method only affects certain annotation types [#f2]_ and will lead to a message on Python's `sys.stderr` in other cases. No exception will be raised, but `False` will be returned. :arg rect_like rect: the new rectangle of the annotation (finite and not empty). E.g. using a value of *annot.rect + (5, 5, 5, 5)* will shift the annot position 5 pixels to the right and downwards. .. note:: You **need not** invoke :meth:`Annot.update` for activation of the effect. .. method:: set_rotation(angle) Set the rotation of an annotation. This rotates the annotation rectangle around its center point. Then a **new annotation rectangle** is calculated from the resulting quad. :arg int angle: rotation angle in degrees. Arbitrary values are possible, but will be clamped to the interval `[0, 360)`. .. note:: * You **must invoke** :meth:`Annot.update` to activate the effect. * For PDF_ANNOT_FREE_TEXT, only one of the values 0, 90, 180 and 270 is possible and will **rotate the text** inside the current rectangle (which remains unchanged). Other values are silently ignored and replaced by 0. * Otherwise, only the following :ref:`AnnotationTypes` can be rotated: 'Square', 'Circle', 'Caret', 'Text', 'FileAttachment', 'Ink', 'Line', 'Polyline', 'Polygon', and 'Stamp'. For all others the method is a no-op. .. method:: set_border(border=None, width=None, style=None, dashes=None, clouds=None) * Changed in version 1.16.9: Allow specification without using a dictionary. The direct parameters are used if *border* is not a dictionary. * Changed in version 1.22.5: Support of the "cloudy" border effect. PDF only: Change border width, dashing, style and cloud effect. See the :attr:`Annot.border` attribute for more details. :arg dict border: a dictionary as returned by the :attr:`border` property, with keys *"width"* (*float*), *"style"* (*str*), *"dashes"* (*sequence*) and *clouds* (*int*). Omitted keys will leave the resp. property unchanged. Set the border argument to `None` (the default) to use the other arguments. :arg float width: A non-negative value will change the border line width. :arg str style: A value other than `None` will change this border property. :arg sequence dashes: All items of the sequence must be integers, otherwise the parameter is ignored. To remove dashing use: `dashes=[]`. If dashes is a non-empty sequence, "style" will automatically be set to "D" (dashed). :arg int clouds: A value >= 0 will change this property. Use `clouds=0` to remove the cloudy appearance completely. Only annotation types 'Square', 'Circle', and 'Polygon' are supported with this property. .. method:: set_flags(flags) Changes the annotation flags. Use the `|` operator to combine several. :arg int flags: an integer specifying the required flags. .. method:: set_colors(colors=None, stroke=None, fill=None) Changes the "stroke" and "fill" colors for supported annotation types -- not all annotation types accept both. **Do not use this method at all for FreeText annotations** because it has its special conventions to deal with up to three colors (border, fill, text). :arg dict colors: a dictionary containing color specifications. For accepted dictionary keys and values see below. The most practical way should be to first make a copy of the *colors* property and then modify this dictionary as required. :arg sequence stroke: see above. :arg sequence fill: see above. To completely remove a color specification, use an empty sequence like `[]`. If you specify `None`, an existing specification will not be changed. .. method:: delete_responses() * New in version 1.16.12 Delete annotations referring to this one. This includes any 'Popup' annotations and all annotations responding to it. .. index:: pair: blend_mode; Annot.update pair: fontsize; Annot.update pair: text_color; Annot.update pair: border_color; Annot.update pair: fill_color; Annot.update pair: cross_out; Annot.update pair: rotate; Annot.update .. method:: update(opacity=None, blend_mode=None, fontsize=0, text_color=None, border_color=None, fill_color=None, cross_out=True, rotate=-1) Synchronize the appearance of an annotation with its properties after relevant changes. You can safely **omit** this method **only** for the following changes: * :meth:`Annot.set_rect` * :meth:`Annot.set_flags` * :meth:`Annot.set_oc` * :meth:`Annot.update_file` * :meth:`Annot.set_info` (except any changes to *"content"*) All arguments are optional. *(Changed in v1.16.14)* Blend mode and opacity are applicable to **all annotation types**. The other arguments are mostly special use, as described below. Color specifications may be made in the usual format used in PuMuPDF as sequences of floats ranging from 0.0 to 1.0 (including both). The sequence length must be 1, 3 or 4 (supporting GRAY, RGB and CMYK colorspaces respectively). For GRAY, just a float is also acceptable. :arg float opacity: *(new in v1.16.14)* **valid for all annotation types:** change or set the annotation's transparency. Valid values are *0 <= opacity < 1*. :arg str blend_mode: *(new in v1.16.14)* **valid for all annotation types:** change or set the annotation's blend mode. For valid values see :ref:`BlendModes`. :arg float fontsize: change :data:`fontsize` of the text. 'FreeText' annotations only. :arg sequence,float text_color: change the text color. 'FreeText' annotations only. This has the same effect as ``border_color``. Note that the text color of rich-text annotations cannot be changed at all because it is set by HTML / CSS syntax and part of the text itself. :arg sequence,float border_color: change the border color. 'FreeText' annotations only. This has the same effect as ``text_color``. :arg sequence,float fill_color: the fill color. :arg bool cross_out: *(new in v1.17.2)* add two diagonal lines to the annotation rectangle. 'Redact' annotations only. If not desired, ``False`` must be specified even if the annotation was created with ``False``. :arg int rotate: new rotation value. Default (-1) means no change. Supports 'FreeText' and several other annotation types (see :meth:`Annot.set_rotation`), [#f1]_. Only choose 0, 90, 180, or 270 degrees for 'FreeText'. Otherwise any integer is acceptable. :rtype: bool This method is the only way to change the colors of a FreeText annotation. You cannot use :meth:`Annot.set_colors` for this purpose. But be aware that for rich-text annotations, the text color is never changed. The text color is set by the ``text_color`` entry of the ``info`` dictionary. This is a limitation of |MuPDF| and not a bug. .. caution:: Using this method inside a :meth:`Page.annots` loop is **not recommended!** This is because most annotation updates require the owning page to be reloaded -- which cannot be done inside this loop. Please use the example coding pattern given in the documentation of this generator. .. attribute:: file_info Basic information of the annot's attached file. :rtype: dict :returns: a dictionary with keys *filename*, *ufilename*, *desc* (description), *size* (uncompressed file size), *length* (compressed length) for FileAttachment annot types, else ``None``. .. method:: get_file() Returns attached file content. :rtype: bytes :returns: the content of the attached file. .. index:: pair: buffer; Annot.update_file pair: filename; Annot.update_file pair: ufilename; Annot.update_file pair: desc; Annot.update_file .. method:: update_file(buffer=None, filename=None, ufilename=None, desc=None) Updates the content of an attached file. All arguments are optional. No arguments lead to a no-op. :arg bytes|bytearray|BytesIO buffer: the new file content. Omit to only change meta-information. *(Changed in version 1.14.13)* *io.BytesIO* is now also supported. :arg str filename: new filename to associate with the file. :arg str ufilename: new unicode filename to associate with the file. :arg str desc: new description of the file content. .. method:: get_sound() Return the embedded sound of an audio annotation. :rtype: dict :returns: the sound audio file and accompanying properties. These are the possible dictionary keys, of which only "rate" and "stream" are always present. =========== ======================================================= Key Description =========== ======================================================= rate (float, requ.) samples per second channels (int, opt.) number of sound channels bps (int, opt.) bits per sample value per channel encoding (str, opt.) encoding format: Raw, Signed, muLaw, ALaw compression (str, opt.) name of compression filter stream (bytes, requ.) the sound file content =========== ======================================================= .. attribute:: opacity The annotation's transparency. If set, it is a value in range *[0, 1]*. The PDF default is 1. However, in an effort to tell the difference, we return *-1.0* if not set. :rtype: float .. attribute:: parent The owning page object of the annotation. :rtype: :ref:`Page` .. attribute:: rotation The annot rotation. :rtype: int :returns: a value [-1, 359]. If rotation is not at all, -1 is returned (and implies a rotation angle of 0). Other possible values are normalized to some value value 0 <= angle < 360. .. attribute:: rect The rectangle containing the annotation. :rtype: :ref:`Rect` .. attribute:: next The next annotation on this page or None. :rtype: *Annot* .. attribute:: type A number and one or two strings describing the annotation type, like **[2, 'FreeText', 'FreeTextCallout']**. The second string entry is optional and may be empty. See the appendix :ref:`AnnotationTypes` for a list of possible values and their meanings. :rtype: list .. attribute:: info A dictionary containing various information. All fields are optional strings. For information items not provided, an empty string is returned. * *name* -- e.g. for 'Stamp' annotations it will contain the stamp text like "Sold" or "Experimental", for other annot types you will see the name of the annot's icon here ("PushPin" for FileAttachment). * *content* -- a string containing the text for type *Text* and *FreeText* annotations. Commonly used for filling the text field of annotation pop-up windows. * *title* -- a string containing the title of the annotation pop-up window. By convention, this is used for the **annotation author**. * *creationDate* -- creation timestamp. * *modDate* -- last modified timestamp. * *subject* -- subject. * *id* -- *(new in version 1.16.10)* a unique identification of the annotation. This is taken from PDF key */NM*. Annotations added by PyMuPDF will have a unique name, which appears here. :rtype: dict .. attribute:: flags An integer whose low order bits contain flags for how the annotation should be presented. :rtype: int .. attribute:: line_ends A pair of integers specifying start and end symbol of annotations types 'FreeText', 'Line', 'PolyLine', and 'Polygon'. ``None`` if not applicable. For possible values and descriptions in this list, see the :ref:`AdobeManual`, table 1.76 on page 400. :rtype: tuple .. attribute:: vertices A list containing a variable number of point ("vertices") coordinates (each given by a pair of floats) for various types of annotations: * 'Line' -- the starting and ending coordinates (2 float pairs). * 'FreeText' -- 2 or 3 float pairs designating the starting, the (optional) knee point, and the ending coordinates. * 'PolyLine' / 'Polygon' -- the coordinates of the edges connected by line pieces (n float pairs for n points). * text markup annotations -- 4 float pairs specifying the *QuadPoints* of the marked text span (see :ref:`AdobeManual`, page 403). * 'Ink' -- list of one to many sublists of vertex coordinates. Each such sublist represents a separate line in the drawing. :rtype: list .. attribute:: colors dictionary of two lists of floats in range *0 <= float <= 1* specifying the "stroke" and the interior ("fill") colors. The stroke color is used for borders and everything that is actively painted or written ("stroked"). The fill color is used for the interior of objects like line ends, circles and squares. The lengths of these lists implicitly determine the colorspaces used: 1 = GRAY, 3 = RGB, 4 = CMYK. So "[1.0, 0.0, 0.0]" stands for RGB color red. Both lists can be empty if no color is specified. Be aware about some potentially unexpected cases: * The color of Highlight annotations is a **stroke** color, contrary to intuition. * The color if FreeText annotations is a **stroke** color, but appears as the color that fills the rectangle and any applicable line end symbols. Text color and border color cannot be accessed at all. :rtype: dict .. attribute:: xref The PDF :data:`xref`. :rtype: int .. attribute:: irt_xref The PDF :data:`xref` of an annotation to which this one responds. Return zero if this is no response annotation. :rtype: int .. attribute:: popup_xref The PDF :data:`xref` of the associated Popup annotation. Zero if non-existent. :rtype: int .. attribute:: has_popup Whether the annotation has a Popup annotation. :rtype: bool .. attribute:: is_open Whether the annotation's Popup is open -- **or** the annotation itself ('Text' annotations only). :rtype: bool .. attribute:: popup_rect The rectangle of the associated Popup annotation. Infinite rectangle if non-existent. :rtype: :ref:`Rect` .. attribute:: rect_delta A tuple of four floats representing the `/RD` entry of the annotation. The four numbers describe the numerical differences (left, top, -right, -bottom) between two rectangles: the :attr:`rect` of the annotation and a rectangle contained within that rectangle. If the entry is missing, this property is `(0, 0, 0, 0)`. If the annotation border is a normal, straight line, these numbers are typically border width divided by 2. If the annotation has a "cloudy" border, you will see the breadth of the cloud semi-circles here. In general, the numbers need not be identical. To compute the inner rectangle do `a.rect + a.rect_delta`. .. attribute:: border A dictionary containing border characteristics. Empty if no border information exists. The following keys may be present: * *width* -- a float indicating the border thickness in points. The value is -1.0 if no width is specified. * *dashes* -- a sequence of integers specifying a line dashing pattern. *[]* means no dashes, *[n]* means equal on-off lengths of *n* points, longer lists will be interpreted as specifying alternating on-off length values. See the :ref:`AdobeManual` page 126 for more details. * *style* -- 1-byte border style: **"S"** (Solid) = solid line surrounding the annotation, **"D"** (Dashed) = dashed line surrounding the annotation, the dash pattern is specified by the *dashes* entry, **"B"** (Beveled) = a simulated embossed rectangle that appears to be raised above the surface of the page, **"I"** (Inset) = a simulated engraved rectangle that appears to be recessed below the surface of the page, **"U"** (Underline) = a single line along the bottom of the annotation rectangle. * *clouds* -- an integer indicating a "cloudy" border, where ``n`` is an integer `-1 <= n <= 2`. A value `n = 0` indicates a straight line (no clouds), 1 means small and 2 means large semi-circles, mimicking the cloudy appearance. If -1, then no specification is present. :rtype: dict .. _mupdficons: Annotation Icons in MuPDF ------------------------- This is a list of icons referenceable by name for annotation types 'Text' and 'FileAttachment'. You can use them via the *icon* parameter when adding an annotation, or use the as argument in :meth:`Annot.set_name`. It is left to your discretion which item to choose when -- no mechanism will keep you from using e.g. the "Speaker" icon for a 'FileAttachment'. .. image:: images/mupdf-icons.* Example -------- Change the graphical image of an annotation. Also update the "author" and the text to be shown in the popup window:: doc = pymupdf.open("circle-in.pdf") page = doc[0] # page 0 annot = page.first_annot # get the annotation annot.set_border(dashes=[3]) # set dashes to "3 on, 3 off ..." # set stroke and fill color to some blue annot.set_colors({"stroke":(0, 0, 1), "fill":(0.75, 0.8, 0.95)}) info = annot.info # get info dict info["title"] = "Jorj X. McKie" # set author # text in popup window ... info["content"] = "I changed border and colors and enlarged the image by 20%." info["subject"] = "Demonstration of PyMuPDF" # some PDF viewers also show this annot.set_info(info) # update info dict r = annot.rect # take annot rect r.x1 = r.x0 + r.width * 1.2 # new location has same top-left r.y1 = r.y0 + r.height * 1.2 # but 20% longer sides annot.set_rect(r) # update rectangle annot.update() # update the annot's appearance doc.save("circle-out.pdf") # save This is how the circle annotation looks like before and after the change (pop-up windows displayed using Nitro PDF viewer): |circle| .. |circle| image:: images/img-circle.* .. rubric:: Footnotes .. [#f1] Rotating an annotation also changes its rectangle. Depending on how the annotation was defined, the original rectangle is **cannot be reconstructed** by setting the rotation value to zero again and will be lost. .. [#f2] Only the following annotation types support method :meth:`Annot.set_rect`: Text, FreeText, Square, Circle, Redact, Stamp, Caret, FileAttachment, Sound, and Movie. .. include:: footer.rst ================================================ FILE: docs/app1.rst ================================================ .. include:: header.rst .. _Appendix1: ====================================== Appendix 1: Details on Text Extraction ====================================== This chapter provides background on the text extraction methods of PyMuPDF. Information of interest are * what do they provide? * what do they imply (processing time / data sizes)? General structure of a TextPage ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :ref:`TextPage` is one of (Py-) MuPDF's classes. It is normally created (and destroyed again) behind the curtain, when :ref:`Page` text extraction methods are used, but it is also available directly and can be used as a persistent object. Other than its name suggests, images may optionally also be part of a text page:: A **text page** consists of blocks (= roughly paragraphs). A **block** consists of either lines and their characters, or an image. A **line** consists of spans. A **span** consists of adjacent characters with identical font properties: name, size, flags and color. Plain Text ~~~~~~~~~~ Function :meth:`TextPage.extractText` (or *Page.get_text("text")*) extracts a page's plain **text in original order** as specified by the creator of the document. An example output:: >>> print(page.get_text("text")) Some text on first page. .. note:: The output may not equal an accustomed "natural" reading order. However, you can request a reordering following the scheme "top-left to bottom-right" by executing `page.get_text("text", sort=True)`. BLOCKS ~~~~~~~~~~ Function :meth:`TextPage.extractBLOCKS` (or *Page.get_text("blocks")*) extracts a page's text blocks as a list of items like:: (x0, y0, x1, y1, "lines in block", block_no, block_type) Where the first 4 items are the float coordinates of the block's bbox. The lines within each block are concatenated by a new-line character. This is a high-speed method, which by default also extracts image meta information: Each image appears as a block with one text line, which contains meta information. The image itself is not shown. As with simple text output above, the `sort` argument can be used as well to obtain a reading order. Example output:: >>> print(page.get_text("blocks", sort=False)) [(50.0, 88.17500305175781, 166.1709747314453, 103.28900146484375, 'Some text on first page.', 0, 0)] WORDS ~~~~~~~~~~ Function :meth:`TextPage.extractWORDS` (or *Page.get_text("words")*) extracts a page's text **words** as a list of items like:: (x0, y0, x1, y1, "word", block_no, line_no, word_no) Where the first 4 items are the float coordinates of the words's bbox. The last three integers provide some more information on the word's whereabouts. This is a high-speed method. As with the previous methods, argument `sort=True` will reorder the words. Example output:: >>> for word in page.get_text("words", sort=False): print(word) (50.0, 88.17500305175781, 78.73200225830078, 103.28900146484375, 'Some', 0, 0, 0) (81.79000091552734, 88.17500305175781, 99.5219955444336, 103.28900146484375, 'text', 0, 0, 1) (102.57999420166016, 88.17500305175781, 114.8119888305664, 103.28900146484375, 'on', 0, 0, 2) (117.86998748779297, 88.17500305175781, 135.5909881591797, 103.28900146484375, 'first', 0, 0, 3) (138.64898681640625, 88.17500305175781, 166.1709747314453, 103.28900146484375, 'page.', 0, 0, 4) HTML ~~~~ :meth:`TextPage.extractHTML` (or *Page.get_text("html")* output fully reflects the structure of the page's ``TextPage`` -- much like DICT / JSON below. This includes images, font information and text positions. If wrapped in HTML header and trailer code, it can readily be displayed by an internet browser. Our above example:: >>> for line in page.get_text("html").splitlines(): print(line)

Some text on first page.

.. _HTMLQuality: Controlling Quality of HTML Output ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ While HTML output has improved a lot in MuPDF v1.12.0, it is not yet bug-free: we have found problems in the areas **font support** and **image positioning**. * HTML text contains references to the fonts used of the original document. If these are not known to the browser (a fat chance!), it will replace them with others; the results will probably look awkward. This issue varies greatly by browser -- on my Windows machine, MS Edge worked just fine, whereas Firefox looked horrible. * For PDFs with a complex structure, images may not be positioned and / or sized correctly. This seems to be the case for rotated pages and pages, where the various possible page bbox variants do not coincide (e.g. *MediaBox != CropBox*). We do not know yet, how to address this -- we filed a bug at MuPDF's site. To address the font issue, you can use a simple utility script to scan through the HTML file and replace font references. Here is a little example that replaces all fonts with one of the :ref:`Base-14-Fonts`: serifed fonts will become "Times", non-serifed "Helvetica" and monospaced will become "Courier". Their respective variations for "bold", "italic", etc. are hopefully done correctly by your browser:: import sys filename = sys.argv[1] otext = open(filename).read() # original html text string pos1 = 0 # search start poition font_serif = "font-family:Times" # enter ... font_sans = "font-family:Helvetica" # ... your choices ... font_mono = "font-family:Courier" # ... here found_one = False # true if search successful while True: pos0 = otext.find("font-family:", pos1) # start of a font spec if pos0 < 0: # none found - we are done break pos1 = otext.find(";", pos0) # end of font spec test = otext[pos0 : pos1] # complete font spec string testn = "" # the new font spec string if test.endswith(",serif"): # font with serifs? testn = font_serif # use Times instead elif test.endswith(",sans-serif"): # sans serifs font? testn = font_sans # use Helvetica elif test.endswith(",monospace"): # monospaced font? testn = font_mono # becomes Courier if testn != "": # any of the above found? otext = otext.replace(test, testn) # change the source found_one = True pos1 = 0 # start over if found_one: ofile = open(filename + ".html", "w") ofile.write(otext) ofile.close() else: print("Warning: could not find any font specs!") DICT (or JSON) ~~~~~~~~~~~~~~~~ :meth:`TextPage.extractDICT` (or *Page.get_text("dict", sort=False)*) output fully reflects the structure of a ``TextPage`` and provides image content and position detail (*bbox* -- boundary boxes in pixel units) for every block, line and span. Images are stored as *bytes* for DICT output and base64 encoded strings for JSON output. For a visualization of the dictionary structure have a look at :ref:`textpagedict`. Here is how this looks like:: { "width": 300.0, "height": 350.0, "blocks": [{ "type": 0, "bbox": (50.0, 88.17500305175781, 166.1709747314453, 103.28900146484375), "lines": ({ "wmode": 0, "dir": (1.0, 0.0), "bbox": (50.0, 88.17500305175781, 166.1709747314453, 103.28900146484375), "spans": ({ "size": 11.0, "flags": 0, "font": "Helvetica", "color": 0, "origin": (50.0, 100.0), "text": "Some text on first page.", "bbox": (50.0, 88.17500305175781, 166.1709747314453, 103.28900146484375) }) }] }] } RAWDICT (or RAWJSON) ~~~~~~~~~~~~~~~~~~~~~ :meth:`TextPage.extractRAWDICT` (or *Page.get_text("rawdict", sort=False)*) is an **information superset of DICT** and takes the detail level one step deeper. It looks exactly like the above, except that the *"text"* items (*string*) in the spans are replaced by the list *"chars"*. Each *"chars"* entry is a character *dict*. For example, here is what you would see in place of item *"text": "Text in black color."* above:: "chars": [{ "origin": (50.0, 100.0), "bbox": (50.0, 88.17500305175781, 57.336997985839844, 103.28900146484375), "c": "S" }, { "origin": (57.33700180053711, 100.0), "bbox": (57.33700180053711, 88.17500305175781, 63.4530029296875, 103.28900146484375), "c": "o" }, { "origin": (63.4530029296875, 100.0), "bbox": (63.4530029296875, 88.17500305175781, 72.61600494384766, 103.28900146484375), "c": "m" }, { "origin": (72.61600494384766, 100.0), "bbox": (72.61600494384766, 88.17500305175781, 78.73200225830078, 103.28900146484375), "c": "e" }, { "origin": (78.73200225830078, 100.0), "bbox": (78.73200225830078, 88.17500305175781, 81.79000091552734, 103.28900146484375), "c": " " < ... deleted ... > }, { "origin": (163.11297607421875, 100.0), "bbox": (163.11297607421875, 88.17500305175781, 166.1709747314453, 103.28900146484375), "c": "." }], XML ~~~ The :meth:`TextPage.extractXML` (or *Page.get_text("xml")*) version extracts text (no images) with the detail level of RAWDICT:: >>> for line in page.get_text("xml").splitlines(): print(line) ... deleted ... .. note:: We have successfully tested `lxml `_ to interpret this output. XHTML ~~~~~ :meth:`TextPage.extractXHTML` (or *Page.get_text("xhtml")*) is a variation of TEXT but in HTML format, containing the bare text and images ("semantic" output)::

Some text on first page.

.. _text_extraction_flags: Text Extraction Flags Defaults ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * New in version 1.16.2: Method :meth:`Page.get_text` supports a keyword parameter *flags* *(int)* to control the amount and the quality of extracted data. The following table shows the defaults settings (flags parameter omitted or None) for each extraction variant. If you specify flags with a value other than ``None``, be aware that you must set **all desired** options. A description of the respective bit settings can be found in :ref:`TextPreserve`. * New in v1.19.6: The default combinations in the following table are now available as Python constants: :data:`TEXTFLAGS_TEXT`, :data:`TEXTFLAGS_WORDS`, :data:`TEXTFLAGS_BLOCKS`, :data:`TEXTFLAGS_DICT`, :data:`TEXTFLAGS_RAWDICT`, :data:`TEXTFLAGS_HTML`, :data:`TEXTFLAGS_XHTML`, :data:`TEXTFLAGS_XML`, and :data:`TEXTFLAGS_SEARCH`. You can now easily modify a default flag, e.g. - **include** images in a "blocks" output: `flags = TEXTFLAGS_BLOCKS | TEXT_PRESERVE_IMAGES` - **exclude** images from a "dict" output: `flags = TEXTFLAGS_DICT & ~TEXT_PRESERVE_IMAGES` - set **dehyphenation off** in text searches: `flags = TEXTFLAGS_SEARCH & ~TEXT_DEHYPHENATE` ========================= ==== ==== ===== === ==== ======= ===== ====== ====== Indicator text html xhtml xml dict rawdict words blocks search ========================= ==== ==== ===== === ==== ======= ===== ====== ====== preserve ligatures 1 1 1 1 1 1 1 1 0 preserve whitespace 1 1 1 1 1 1 1 1 1 preserve images n/a 1 1 n/a 1 1 n/a 0 0 inhibit spaces 0 0 0 0 0 0 0 0 0 dehyphenate 0 0 0 0 0 0 0 0 1 clip to mediabox 1 1 1 1 1 1 1 1 1 use CID instead of U+FFFD 1 1 1 1 1 1 1 1 0 ========================= ==== ==== ===== === ==== ======= ===== ====== ====== * **search** refers to the text search function. * **"json"** is handled exactly like **"dict"** and is hence left out. * **"rawjson"** is handled exactly like **"rawdict"** and is hence left out. * An "n/a" specification means a value of 0 and setting this bit never has any effect on the output (but an adverse effect on performance). * If you are not interested in images when using an output variant which includes them by default, then by all means set the respective bit off: You will experience a better performance and much lower space requirements. To show the effect of `TEXT_INHIBIT_SPACES` have a look at this example:: >>> print(page.get_text("text")) H a l l o ! Mo r e t e x t i s f o l l o w i n g i n E n g l i s h . . . l e t ' s s e e w h a t h a p p e n s . >>> print(page.get_text("text", flags=pymupdf.TEXT_INHIBIT_SPACES)) Hallo! More text is following in English ... let's see what happens. >>> Performance ~~~~~~~~~~~~ The text extraction methods differ significantly both: in terms of information they supply, and in terms of resource requirements and runtimes. Generally, more information of course means, that more processing is required and a higher data volume is generated. .. note:: Especially images have a **very significant** impact. Make sure to exclude them (via the *flags* parameter) whenever you do not need them. To process the below mentioned 2'700 total pages with default flags settings required 160 seconds across all extraction methods. When all images where excluded, less than 50% of that time (77 seconds) were needed. To begin with, all methods are **very fast** in relation to other products out there in the market. In terms of processing speed, we are not aware of a faster (free) tool. Even the most detailed method, RAWDICT, processes all 1'310 pages of the :ref:`AdobeManual` in less than 5 seconds (simple text needs less than 2 seconds here). The following table shows average relative speeds ("RSpeed", baseline 1.00 is TEXT), taken across ca. 1400 text-heavy and 1300 image-heavy pages. ======= ====== ===================================================================== ========== Method RSpeed Comments no images ======= ====== ===================================================================== ========== TEXT 1.00 no images, **plain** text, line breaks 1.00 BLOCKS 1.00 image bboxes (only), **block** level text with bboxes, line breaks 1.00 WORDS 1.02 no images, **word** level text with bboxes 1.02 XML 2.72 no images, **char** level text, layout and font details 2.72 XHTML 3.32 **base64** images, **span** level text, no layout info 1.00 HTML 3.54 **base64** images, **span** level text, layout and font details 1.01 DICT 3.93 **binary** images, **span** level text, layout and font details 1.04 RAWDICT 4.50 **binary** images, **char** level text, layout and font details 1.68 ======= ====== ===================================================================== ========== As mentioned: when excluding image extraction (last column), the relative speeds are changing drastically: except RAWDICT and XML, the other methods are almost equally fast, and RAWDICT requires 40% less execution time than the **now slowest XML**. Look at chapter **Appendix 1** for more performance information. .. include:: footer.rst ================================================ FILE: docs/app2.rst ================================================ .. include:: header.rst .. _Appendix2: ================================================ Appendix 2: Considerations on Embedded Files ================================================ This chapter provides some background on embedded files support in PyMuPDF. General ---------- Starting with version 1.4, PDF supports embedding arbitrary files as part ("Embedded File Streams") of a PDF document file (see chapter "7.11.4 Embedded File Streams", pp. 103 of the :ref:`AdobeManual`). In many aspects, this is comparable to concepts also found in ZIP files or the OLE technique in MS Windows. PDF embedded files do, however, *not* support directory structures as does the ZIP format. An embedded file can in turn contain embedded files itself. Advantages of this concept are that embedded files are under the PDF umbrella, benefitting from its permissions / password protection and integrity aspects: all data, which a PDF may reference or even may be dependent on, can be bundled into it and so form a single, consistent unit of information. In addition to embedded files, PDF 1.7 adds *collections* to its support range. This is an advanced way of storing and presenting meta information (i.e. arbitrary and extensible properties) of embedded files. MuPDF Support -------------- After adding initial support for collections (portfolios) and */EmbeddedFiles* in MuPDF version 1.11, this support was dropped again in version 1.15. As a consequence, the cli utility *mutool* no longer offers access to embedded files. PyMuPDF -- having implemented an */EmbeddedFiles* API in response in its version 1.11.0 -- was therefore forced to change gears starting with its version 1.16.0 (we never published a MuPDF v1.15.x compatible PyMuPDF). We are now maintaining our own code basis supporting embedded files. This code makes use of basic MuPDF dictionary and array functions only. PyMuPDF Support ------------------ We continue to support the full old API with respect to embedded files -- with only minor, cosmetic changes. There even also is a new function, which delivers a list of all names under which embedded data are registered in a PDF, :meth:`Document.embfile_names`. .. include:: footer.rst ================================================ FILE: docs/app3.rst ================================================ .. include:: header.rst .. _Appendix3: ================================================ Appendix 3: Assorted Technical Information ================================================ This section deals with various technical topics, that are not necessarily related to each other. ------------ .. _ImageTransformation: Image Transformation Matrix ---------------------------- Starting with version 1.18.11, the image transformation matrix is returned by some methods for text and image extraction: :meth:`Page.get_text` and :meth:`Page.get_image_bbox`. The transformation matrix contains information about how an image was transformed to fit into the rectangle (its "boundary box" = "bbox") on some document page. By inspecting the image's bbox on the page and this matrix, one can determine for example, whether and how the image is displayed scaled or rotated on a page. The relationship between image dimension and its bbox on a page is the following: 1. Using the original image's width and height, - define the image rectangle `imgrect = pymupdf.Rect(0, 0, width, height)` - define the "shrink matrix" `shrink = pymupdf.Matrix(1/width, 0, 0, 1/height, 0, 0)`. 2. Transforming the image rectangle with its shrink matrix, will result in the unit rectangle: `imgrect * shrink = pymupdf.Rect(0, 0, 1, 1)`. 3. Using the image **transformation matrix** "transform", the following steps will compute the bbox:: imgrect = pymupdf.Rect(0, 0, width, height) shrink = pymupdf.Matrix(1/width, 0, 0, 1/height, 0, 0) bbox = imgrect * shrink * transform 4. Inspecting the matrix product `shrink * transform` will reveal all information about what happened to the image rectangle to make it fit into the bbox on the page: rotation, scaling of its sides and translation of its origin. Let us look at an example: >>> imginfo = page.get_images()[0] # get an image item on a page >>> imginfo (5, 0, 439, 501, 8, 'DeviceRGB', '', 'fzImg0', 'DCTDecode') >>> #------------------------------------------------ >>> # define image shrink matrix and rectangle >>> #------------------------------------------------ >>> shrink = pymupdf.Matrix(1 / 439, 0, 0, 1 / 501, 0, 0) >>> imgrect = pymupdf.Rect(0, 0, 439, 501) >>> #------------------------------------------------ >>> # determine image bbox and transformation matrix: >>> #------------------------------------------------ >>> bbox, transform = page.get_image_bbox("fzImg0", transform=True) >>> #------------------------------------------------ >>> # confirm equality - permitting rounding errors >>> #------------------------------------------------ >>> bbox Rect(100.0, 112.37525939941406, 300.0, 287.624755859375) >>> imgrect * shrink * transform Rect(100.0, 112.375244140625, 300.0, 287.6247253417969) >>> #------------------------------------------------ >>> shrink * transform Matrix(0.0, -0.39920157194137573, 0.3992016017436981, 0.0, 100.0, 287.6247253417969) >>> #------------------------------------------------ >>> # the above shows: >>> # image sides are scaled by same factor ~0.4, >>> # and the image is rotated by 90 degrees clockwise >>> # compare this with pymupdf.Matrix(-90) * 0.4 >>> #------------------------------------------------ ------------ .. _Base-14-Fonts: PDF Base 14 Fonts --------------------- The following 14 builtin font names **must be supported by every PDF viewer** application. They are available as a dictionary, which maps their full names amd their abbreviations in lower case to the full font basename. Wherever a **fontname** must be provided in PyMuPDF, any **key or value** from the dictionary may be used:: In [2]: pymupdf.Base14_fontdict Out[2]: {'courier': 'Courier', 'courier-oblique': 'Courier-Oblique', 'courier-bold': 'Courier-Bold', 'courier-boldoblique': 'Courier-BoldOblique', 'helvetica': 'Helvetica', 'helvetica-oblique': 'Helvetica-Oblique', 'helvetica-bold': 'Helvetica-Bold', 'helvetica-boldoblique': 'Helvetica-BoldOblique', 'times-roman': 'Times-Roman', 'times-italic': 'Times-Italic', 'times-bold': 'Times-Bold', 'times-bolditalic': 'Times-BoldItalic', 'symbol': 'Symbol', 'zapfdingbats': 'ZapfDingbats', 'helv': 'Helvetica', 'heit': 'Helvetica-Oblique', 'hebo': 'Helvetica-Bold', 'hebi': 'Helvetica-BoldOblique', 'cour': 'Courier', 'coit': 'Courier-Oblique', 'cobo': 'Courier-Bold', 'cobi': 'Courier-BoldOblique', 'tiro': 'Times-Roman', 'tibo': 'Times-Bold', 'tiit': 'Times-Italic', 'tibi': 'Times-BoldItalic', 'symb': 'Symbol', 'zadb': 'ZapfDingbats'} In contrast to their obligation, not all PDF viewers support these fonts correctly and completely -- this is especially true for Symbol and ZapfDingbats. Also, the glyph (visual) images will be specific to every reader. To see how these fonts can be used -- including the **CJK built-in** fonts -- look at the table in :meth:`Page.insert_font`. ------------ .. _AdobeManual: Adobe PDF References --------------------------- This PDF Reference manual published by Adobe is frequently quoted throughout this documentation. It can be viewed and downloaded from `opensource.adobe.com `_. ------------ .. _SequenceTypes: Using Python Sequences as Arguments in PyMuPDF ------------------------------------------------ When PyMuPDF objects and methods require a Python **list** of numerical values, other Python **sequence types** are also allowed. Python classes are said to implement the **sequence protocol**, if they have a `__getitem__()` method. This basically means, you can interchangeably use Python *list* or *tuple* or even *array.array*, *numpy.array* and *bytearray* types in these cases. For example, specifying a sequence `"s"` in any of the following ways * `s = [1, 2]` -- a list * `s = (1, 2)` -- a tuple * `s = array.array("i", (1, 2))` -- an array.array * `s = numpy.array((1, 2))` -- a numpy array * `s = bytearray((1, 2))` -- a bytearray will make it usable in the following example expressions: * `pymupdf.Point(s)` * `pymupdf.Point(x, y) + s` * `doc.select(s)` Similarly with all geometry objects :ref:`Rect`, :ref:`IRect`, :ref:`Matrix` and :ref:`Point`. Because all PyMuPDF geometry classes themselves are special cases of sequences, they (with the exception of :ref:`Quad` -- see below) can be freely used where numerical sequences can be used, e.g. as arguments for functions like *list()*, *tuple()*, *array.array()* or *numpy.array()*. Look at the following snippet to see this work. >>> import pymupdf, array, numpy as np >>> m = pymupdf.Matrix(1, 2, 3, 4, 5, 6) >>> >>> list(m) [1.0, 2.0, 3.0, 4.0, 5.0, 6.0] >>> >>> tuple(m) (1.0, 2.0, 3.0, 4.0, 5.0, 6.0) >>> >>> array.array("f", m) array('f', [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]) >>> >>> np.array(m) array([1., 2., 3., 4., 5., 6.]) .. note:: :ref:`Quad` is a Python sequence object as well and has a length of 4. Its items however are :data:`point_like` -- not numbers. Therefore, the above remarks do not apply. ------------ .. _ReferenialIntegrity: Ensuring Consistency of Important Objects in PyMuPDF ------------------------------------------------------------ PyMuPDF is a Python binding for the C library MuPDF. While a lot of effort has been invested by MuPDF's creators to approximate some sort of an object-oriented behavior, they certainly could not overcome basic shortcomings of the C language in that respect. Python on the other hand implements the OO-model in a very clean way. The interface code between PyMuPDF and MuPDF consists of two basic files: *pymupdf.py* and *fitz_wrap.c*. They are created by the excellent SWIG tool for each new version. When you use one of PyMuPDF's objects or methods, this will result in execution of some code in *pymupdf.py*, which in turn will call some C code compiled with *fitz_wrap.c*. Because SWIG goes a long way to keep the Python and the C level in sync, everything works fine, if a certain set of rules is being strictly followed. For example: **never access** a :ref:`Page` object, after you have closed (or deleted or set to ``None``) the owning :ref:`Document`. Or, less obvious: **never access** a page or any of its children (links or annotations) after you have executed one of the document methods *select()*, *delete_page()*, *insert_page()* ... and more. But just no longer accessing invalidated objects is actually not enough: They should rather be actively deleted entirely, to also free C-level resources (meaning allocated memory). The reason for these rules lies in the fact that there is a hierarchical 2-level one-to-many relationship between a document and its pages and also between a page and its links / annotations. To maintain a consistent situation, any of the above actions must lead to a complete reset -- in **Python and, synchronously, in C**. SWIG cannot know about this and consequently does not do it. The required logic has therefore been built into PyMuPDF itself in the following way. 1. If a page "loses" its owning document or is being deleted itself, all of its currently existing annotations and links will be made unusable in Python, and their C-level counterparts will be deleted and deallocated. 2. If a document is closed (or deleted or set to ``None``) or if its structure has changed, then similarly all currently existing pages and their children will be made unusable, and corresponding C-level deletions will take place. "Structure changes" include methods like *select()*, *delePage()*, *insert_page()*, *insert_pdf()* and so on: all of these will result in a cascade of object deletions. The programmer will normally not realize any of this. If he, however, tries to access invalidated objects, exceptions will be raised. Invalidated objects cannot be directly deleted as with Python statements like *del page* or *page = None*, etc. Instead, their *__del__* method must be invoked. All pages, links and annotations have the property *parent*, which points to the owning object. This is the property that can be checked on the application level: if *obj.parent == None* then the object's parent is gone, and any reference to its properties or methods will raise an exception informing about this "orphaned" state. A sample session: >>> page = doc[n] >>> annot = page.first_annot >>> annot.type # everything works fine [5, 'Circle'] >>> page = None # this turns 'annot' into an orphan >>> annot.type <... omitted lines ...> RuntimeError: orphaned object: parent is None >>> >>> # same happens, if you do this: >>> annot = doc[n].first_annot # deletes the page again immediately! >>> annot.type # so, 'annot' is 'born' orphaned <... omitted lines ...> RuntimeError: orphaned object: parent is None This shows the cascading effect: >>> doc = pymupdf.open("some.pdf") >>> page = doc[n] >>> annot = page.first_annot >>> page.rect pymupdf.Rect(0.0, 0.0, 595.0, 842.0) >>> annot.type [5, 'Circle'] >>> del doc # or doc = None or doc.close() >>> page.rect <... omitted lines ...> RuntimeError: orphaned object: parent is None >>> annot.type <... omitted lines ...> RuntimeError: orphaned object: parent is None .. note:: Objects outside the above relationship are not included in this mechanism. If you e.g. created a table of contents by *toc = doc.get_toc()*, and later close or change the document, then this cannot and does not change variable *toc* in any way. It is your responsibility to refresh such variables as required. ------------ .. _FormXObject: Design of Method :meth:`Page.show_pdf_page` -------------------------------------------- Purpose and Capabilities ~~~~~~~~~~~~~~~~~~~~~~~~~~~ The method displays an image of a ("source") page of another PDF document within a specified rectangle of the current ("containing", "target") page. * **In contrast** to :meth:`Page.insert_image`, this display is vector-based and hence remains accurate across zooming levels. * **Just like** :meth:`Page.insert_image`, the size of the display is adjusted to the given rectangle. The following variations of the display are currently supported: * Bool parameter `"keep_proportion"` controls whether to maintain the aspect ratio (default) or not. * Rectangle parameter `"clip"` restricts the visible part of the source page rectangle. Default is the full page. * float `"rotation"` rotates the display by an arbitrary angle (degrees). If the angle is not an integer multiple of 90, only 2 of the 4 corners may be positioned on the target border if also `"keep_proportion"` is true. * Bool parameter `"overlay"` controls whether to put the image on top (foreground, default) of current page content or not (background). Use cases include (but are not limited to) the following: 1. "Stamp" a series of pages of the current document with the same image, like a company logo or a watermark. 2. Combine arbitrary input pages into one output page to support “booklet” or double-sided printing (known as "4-up", "n-up"). 3. Split up (large) input pages into several arbitrary pieces. This is also called “posterization”, because you e.g. can split an A4 page horizontally and vertically, print the 4 pieces enlarged to separate A4 pages, and end up with an A2 version of your original page. Technical Implementation ~~~~~~~~~~~~~~~~~~~~~~~~~ This is done using PDF **"Form XObjects"**, see section 8.10 on page 217 of :ref:`AdobeManual`. On execution of a :meth:`Page.show_pdf_page`, the following things happen: 1. The :data:`resources` and :data:`contents` objects of source page in source document are copied over to the target document, jointly creating a new **Form XObject** with the following properties. The PDF :data:`xref` number of this object is returned by the method. a. `/BBox` equals `/Mediabox` of the source page b. `/Matrix` equals the identity matrix. c. `/Resources` equals that of the source page. This involves a “deep-copy” of hierarchically nested other objects (including fonts, images, etc.). The complexity involved here is covered by MuPDF's grafting [#f1]_ technique functions. d. This is a stream object type, and its stream is an exact copy of the combined data of the source page's :data:`contents` objects. This Form XObject is only executed once per shown source page. Subsequent displays of the same source page will skip this step and only create "pointer" Form XObjects (done in next step) to this object. 2. A second **Form XObject** is then created which the target page uses to invoke the display. This object has the following properties: a. `/BBox` equals the `/CropBox` of the source page (or `"clip"`). b. `/Matrix` represents the mapping of `/BBox` to the target rectangle. c. `/XObject` references the previous Form XObject via the fixed name `fullpage`. d. The stream of this object contains exactly one fixed statement: `/fullpage Do`. e. If the method's `"oc"` argument is given, its value is assigned to this Form XObject as `/OC`. 3. The :data:`resources` and :data:`contents` objects of the target page are now modified as follows. a. Add an entry to the `/XObject` dictionary of `/Resources` with the name `fzFrm` (with n chosen such that this entry is unique on the page). b. Depending on `"overlay"`, prepend or append a new object to the page's `/Contents` array, containing the statement `q /fzFrm Do Q`. This design approach ensures that: 1. The (potentially large) source page is only copied once to the target PDF. Only small "pointer" Form XObjects objects are created per each target page to show the source page. 2. Each referring target page can have its own `"oc"` parameter to control the source page's visibility individually. .. _RedirectMessages: Diagnostics ---------------------------- .. _Messages: |PyMuPDF| messages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |PyMuPDF| has a Message system for showing text diagnostics. By default messages are written to `sys.stdout`. This can be controlled in two ways: * Set environment variable `PYMUPDF_MESSAGE` before |PyMuPDF| is imported. * Call `set_messages()`: |MuPDF| errors and warnings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |MuPDF| generates text errors and warnings. * These errors and warnings are appended to an internal list, accessible with `Tools.mupdf_warnings()`. Also see `Tools.reset_mupdf_warnings()`. * By default these errors and warnings are also sent to the |PyMuPDF| message system. * This can be controlled with `mupdf_display_errors()` and `mupdf_display_warnings()`. * These messages are prefixed with `MuPDF error:` and `MuPDF warning:` respectively. Some |MuPDF| errors may lead to Python exceptions. Example output for a **recoverable error**. We are opening a damaged PDF, but MuPDF is able to repair it and gives us a little information on what happened. Then we illustrate how to find out whether the document can later be saved incrementally. Checking the :attr:`Document.is_dirty` attribute at this point also indicates that during `pymupdf.open` the document had to be repaired: >>> import pymupdf >>> doc = pymupdf.open("damaged-file.pdf") # leads to a sys.stderr message: mupdf: cannot find startxref >>> print(pymupdf.TOOLS.mupdf_warnings()) # check if there is more info: cannot find startxref trying to repair broken xref repairing PDF document object missing 'endobj' token >>> doc.can_save_incrementally() # this is to be expected: False >>> # the following indicates whether there are updates so far >>> # this is the case because of the repair actions: >>> doc.is_dirty True >>> # the document has nevertheless been created: >>> doc pymupdf.Document('damaged-file.pdf') >>> # we now know that any save must occur to a new file Example output for an **unrecoverable error**: >>> import pymupdf >>> doc = pymupdf.open("does-not-exist.pdf") mupdf: cannot open does-not-exist.pdf: No such file or directory Traceback (most recent call last): File "", line 1, in doc = pymupdf.open("does-not-exist.pdf") File "C:\Users\Jorj\AppData\Local\Programs\Python\Python37\lib\site-packages\fitz\pymupdf.py", line 2200, in __init__ _pymupdf.Document_swiginit(self, _pymupdf.new_Document(filename, stream, filetype, rect, width, height, fontsize)) RuntimeError: cannot open does-not-exist.pdf: No such file or directory >>> .. _Coordinates: Coordinates -------------------------------------------- This is one of the most frequently used terms in this documentation. A **coordinate** generally means a pair of numbers `(x, y)` referring to some location, like a corner of a rectangle (:ref:`Rect`), a :ref:`Point` and so forth. The two values usually are floats, but there a objects like images which only allow them to be integers. To actually *find* a coordinate's location, we also need to know the *reference* point for ``x`` and ``y`` - in other words, we must know where location `(0, 0)` is positioned. Once `(0, 0)` (the "origin") is known, we speak of a "coordinate system". Several coordinate systems exist in document processing. For instance, the coordinate systems of a PDF page and the image created from it are **different**. We therefore need ways to *transform* coordinates from one system to another (and also back occasionally). This is the task of a :ref:`Matrix`. It is a mathematical function which works much like a factor that can be "multiplied" with a point or rectangle to give us the corresponding point / rectangle in another coordinate system. The inverse of a transformation matrix can be used to revert the transformation. Much like multiplying by some factor, say 3, can be reverted by dividing the result by 3 (or multiplying it with 1/3). Coordinates and Images ~~~~~~~~~~~~~~~~~~~~~~~ Images have a coordinate system with integer coordinates. Origin `(0, 0)` is the top-left point. ``x`` values must be in `range(width)`, and ``y`` values in `range(height)`. Therefore, ``y`` values *increase* if we go *downwards*. For every image, there is only a **finite number** of coordinates, namely `width * height`. A location in an image is also called a "pixel". - How **large** an image will be (in centimeters or inches) when e.g. printed, depends on additional information: the "resolution". This is measured in **DPI** (dots per inch, or pixels per inch). To find the printed size of some image, we therefore must divide its width and its height by the corresponding DPI values (there may separate ones for width and for height) and will get the respective number of inches. Origin Point, Point Size and Y-Axis ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In |PDF|, the origin `(0, 0)` of a page is located at its **bottom-left point**. In |MuPDF|, the origin `(0, 0)` of a page is located at its **top-left point**. .. image:: images/img-coordinate-space.png Coordinates are float numbers and measured in **points**, where: - **one point equals 1/72 inches**. Typical document page sizes are **ISO A4** and **Letter**. A **Letter** page has a size of **8.5 x 11 inches**, corresponding to **612 x 792 points**. In the |PDF| coordinate system, the top-left point of a **Letter** page hence has the coordinate `(0, 792)` as **the y-axis points upwards**. Now we know our document size the |MuPDF| coordinate system for the bottom right would be coordinate `(612, 792)` (and for |PDF| this coordinate would then be `(612,0)`). - Theoretically, there are **infinitely many** coordinate positions on a |PDF| page. In practice however, at most the first 5 decimal places are sufficient for a reasonable precision. - In |MuPDF|, multiple document formats are supported - |PDF| just being one among **over a dozen others**. Images are also supported as documents in |MuPDF| (therefore having one page usually). This is one of the reasons why |MuPDF| uses a coordinate system with the origin `(0, 0)` being the **top-left** point of any document page. **The y-axis points downwards**, like with images. Coordinates in |MuPDF| in any case are floats, like in |PDF|. - A rectangle `Rect(0, 0, 100, 100)` for instance in |MuPDF| (and thus |PyMuPDF|) therefore is a square with edges of length 100 points (= 1.39 inches or 3.53 centimeters). Its top-left corner is the origin. To switch between the two coordinate systems |PDF| to |MuPDF|, every :ref:`Page` object has a :attr:`Page.transformation_matrix`. Its inverse can be used to compute a rectangle's PDF coordinates. In this way we can conveniently find that `Rect(0, 0, 100, 100)` in |MuPDF| is the same as `Rect(0, 692, 100, 792)` in |PDF|. See this code snippet:: >>> page = doc.new_page(width=612, height=792) # make new Letter page >>> ptm = page.transformation_matrix >>> # the inverse matrix of ptm is ~ptm >>> pymupdf.Rect(0, 0, 100, 100) * ~ptm Rect(0.0, 692.0, 100.0, 792.0) .. rubric:: Footnotes .. [#f1] MuPDF supports "deep-copying" objects between PDF documents. To avoid duplicate data in the target, it uses so-called "graftmaps", like a form of scratchpad: for each object to be copied, its :data:`xref` number is looked up in the graftmap. If found, copying is skipped. Otherwise, the new :data:`xref` is recorded and the copy takes place. PyMuPDF makes use of this technique in two places so far: :meth:`Document.insert_pdf` and :meth:`Page.show_pdf_page`. This process is fast and very efficient, because it prevents multiple copies of typically large and frequently referenced data, like images and fonts. However, you may still want to consider using garbage collection (option 4) in any of the following cases: 1. The target PDF is not new / empty: grafting does not check for resources that already existed (e.g. images, fonts) in the target document before opening it. 2. Using :meth:`Page.show_pdf_page` for more than one source document: each grafting occurs **within one source** PDF only, not across multiple. So if e.g. the same image exists in pages from different source PDFs, then this will not be detected until garbage collection. .. include:: footer.rst ================================================ FILE: docs/app4.rst ================================================ .. include:: header.rst .. role:: red-color .. role:: orange-color .. role:: green-color .. _Appendix4: ================================================ Appendix 4: Performance Comparison Methodology ================================================ This article documents the approach to measure :title:`PyMuPDF's` performance and the tools and example files used to do comparisons. The following three sections deal with different performance aspects: * :ref:`Document Copying` - This includes opening and parsing :title:`PDFs`, then writing them to an output file. Because the same basic activities are also used for joining (merging) :title:`PDFs`, the results also apply to these use cases. * :ref:`Text Extraction` - This extracts plain text from :title:`PDFs` and writes it to an output text file. * :ref:`Page Rendering` - This converts |PDF| pages to image files looking identical to the pages. This ability is the basic prerequisite for using a tool in :title:`Python GUI` scripts to scroll through documents. We have chosen a medium-quality (resolution 150 DPI) version. Please note that in all cases the actual speed in dealing with |PDF| structures is not directly measured: instead, the timings also include the durations of writing files to the operating system's file system. This cannot be avoided because tools other than |PyMuPDF| do not offer the option to e.g., separate the image **creation** step from the following step, which **writes** the image into a file. So all timings documented include a common, OS-oriented base effort. Therefore, performance **differences per tool are actually larger** than the numbers suggest. .. _Appendix4_Files_Used: Files used ------------ A set of eight files is used for the performance testing. With each file we have the following information: - **Name** of the file and download **link**. - **Size** in bytes. - Total number of **pages** in file. - Total number of bookmarks (**Table of Contents** entries). - Total number of **links**. - **KB size** per page. - **Textsize per page** is the amount text in the whole file in KB, divided by the number of pages. - Any **notes** to generally describe the type of file. .. list-table:: :header-rows: 1 * - **Name** - **Size (bytes)** - **Pages** - **TOC size** - **Links** - **KB/page** - **Textsize/page** - **Notes** * - `adobe.pdf` - 32,472,771 - 1,310 - 794 - 32,096 - 24 - 1,942 - linearized, many links / bookmarks * - `artifex-website.pdf` - 31,570,732 - 47 - 46 - 2,035 - 656 - 3,538 - graphics oriented * - `db-systems.pdf` - 29,326,355 - 1,241 - 0 - 0 - 23 - 2,142 - * - `fontforge.pdf` - 8,222,384 - 214 - 31 - 242 - 38 - 1,058 - mix of text & graphics * - `pandas.pdf` - 10,585,962 - 3,071 - 536 - 16,554 - 3 - 1,539 - many pages * - `pymupdf.pdf` - 6,805,176 - 478 - 276 - 5,277 - 14 - 1,937 - text oriented * - `pythonbook.pdf` - 9,983,856 - 669 - 198 - 1,953 - 15 - 1,929 - * - `sample-50-MB-pdf-file.pdf` - 52,521,850 - 1 - 0 - 0 - 51,291 - 23,860 - single page, graphics oriented, large file size .. note:: **adobe.pdf** and **pymupdf.pdf** are clearly text oriented, **artifex-website.pdf** and **sample-50-MB-pdf-file.pdf** are graphics oriented. Other files are a mix of both. Tools used ------------- In each section, the same fixed set of |PDF| files is being processed by a set of tools. The set of tools used per performance aspect however varies, depending on the supported tool features. All tools are either platform independent, or at least can run on both, :title:`Windows` and :title:`Unix` / :title:`Linux`. .. list-table:: :header-rows: 1 * - **Tool** - **Description** * - |PyMuPDF| - The tool of this manual. * - PDFrw_ - A pure :title:`Python` tool, being used by :title:`rst2pdf`, has interface to :title:`ReportLab`. * - PyPDF2_ - A pure :title:`Python` tool with a large function set. * - PDFMiner_ - A pure :title:`Python` to extract text and other data from |PDF|. * - XPDF_ - A command line utility with multiple functions. * - PikePDF_ - A :title:`Python` package similar to :title:`PDFrw`, but based on :title:`C++` library :title:`QPDF`. * - PDF2JPG_ - A :title:`Python` package specialized on rendering |PDF| pages to :title:`JPG` images. .. _app4_copying: Copying / Joining / Merging ---------------------------------- How fast is a |PDF| file read and its content parsed for further processing? The sheer parsing performance cannot directly be compared, because batch utilities always execute a requested task completely, in one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for parsing, meaning it only parses those parts of a document that are required in any moment. To find an answer to the question, we therefore measure the time to copy a |PDF| file to an output file with each tool, and do nothing else. These are the :title:`Python` commands for how each tool is used: |PyMuPDF| .. code-block:: python import pymupdf doc = pymupdf.open("input.pdf") doc.save("output.pdf") :title:`PDFrw` .. code-block:: python doc = PdfReader("input.pdf") writer = PdfWriter() writer.trailer = doc writer.write("output.pdf") :title:`PikePDF` .. code-block:: python from pikepdf import Pdf doc = Pdf.open("input.pdf") doc.save("output.pdf") :title:`PyPDF2` .. code-block:: python pdfmerge = PyPDF2.PdfMerger() pdfmerge.append("input.pdf") pdfmerge.write("output.pdf") pdfmerge.close() **Observations** These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: :header-rows: 1 * - **Name** - |PyMuPDF| - **PDFrw** - **PikePDF** - **PyPDF2** * - adobe.pdf - 1.75 - 5.15 - 22.37 - 374.05 * - artifex-website.pdf - 0.26 - 0.38 - 1.41 - 2.81 * - db-systems.pdf - 0.15 - 0.8 - 1.68 - 2.46 * - fontforge.pdf - 0.09 - 0.14 - 0.28 - 1.1 * - pandas.pdf - 0.38 - 2.21 - 2.73 - 70.3 * - pymupdf.pdf - 0.11 - 0.56 - 0.83 - 6.05 * - pythonbook.pdf - 0.19 - 1.2 - 1.34 - 37.19 * - sample-50-MB-pdf-file.pdf - 0.12 - 0.1 - 2.93 - 0.08 * - **Total** - **3.05** - **10.54** - **33.57** - **494.04** * - - - - - * - **Rate compared to PyMuPDF** - :green-color:`1.0` - :orange-color:`3.5` - :orange-color:`11.0` - :red-color:`162` .. _app4_text_extraction: Text Extraction ---------------------------------- The following table shows plain text extraction durations. All tools have been used with their most basic functionality - i.e. no layout re-arrangements, etc. **Observations** These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: :header-rows: 1 * - **Name** - |PyMuPDF| - **XPDF** - **PyPDF2** - **PDFMiner** * - adobe.pdf - 2.01 - 6.19 - 22.2 - 49.15 * - artifex-website.pdf - 0.18 - 0.3 - 1.1 - 4.06 * - db-systems.pdf - 1.57 - 4.26 - 25.75 - 42.19 * - fontforge.pdf - 0.24 - 0.47 - 2.69 - 4.2 * - pandas.pdf - 2.41 - 10.54 - 25.38 - 76.56 * - pymupdf.pdf - 0.49 - 2.34 - 6.44 - 13.55 * - pythonbook.pdf - 0.84 - 2.88 - 9.28 - 24.27 * - sample-50-MB-pdf-file.pdf - 0.27 - 0.44 - 8.8 - 13.29 * - **Total** - **8.01** - **27.42** - **101.64** - **227.27** * - - - - - * - **Rate compared to PyMuPDF** - :green-color:`1.0` - :orange-color:`3.42` - :orange-color:`12.69` - :red-color:`28.37` .. _app4_page_rendering: Page Rendering -------------------------- We have tested rendering speed of |PyMuPDF| against :title:`pdf2jpg` and :title:`XPDF` at a resolution of 150 DPI, These are the :title:`Python` commands for how each tool is used: |PyMuPDF| .. code-block:: python def ProcessFile(datei): print "processing:", datei doc=pymupdf.open(datei) for p in pymupdf.Pages(doc): pix = p.get_pixmap(dpi=150) pix.save(f"t-{p.number}.png") pix = None doc.close() return :title:`XPDF` .. code-block:: python pdftopng.exe -r 150 file.pdf ./ :title:`PDF2JPG` .. code-block:: python def ProcessFile(datei): print("processing:", datei) pdf2jpg.convert_pdf2jpg(datei, "images", pages="ALL", dpi=150) return **Observations** These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: :header-rows: 1 * - **Name** - |PyMuPDF| - **XPDF** - **PDF2JPG** * - adobe.pdf - 51.33 - 98.16 - 75.71 * - artifex-website.pdf - 26.35 - 51.28 - 54.11 * - db-systems.pdf - 84.59 - 143.16 - 405.22 * - fontforge.pdf - 12.23 - 22.18 - 20.14 * - pandas.pdf - 138.74 - 241.67 - 202.06 * - pymupdf.pdf - 22.35 - 39.11 - 33.38 * - pythonbook.pdf - 30.44 - 49.12 - 55.68 * - sample-50-MB-pdf-file.pdf - 1.01 - 1.32 - 5.22 * - **Total** - **367.04** - **646** - **851.52** * - - - - * - **Rate compared to PyMuPDF** - :green-color:`1.0` - :orange-color:`1.76` - :red-color:`2.32` .. include:: footer.rst .. External links .. _PDFrw : https://pypi.org/project/pdfrw/ .. _PyPDF2 : https://pypi.org/project/pypdf/ .. _PDFMiner : https://pypi.org/project/pdfminer.six/ .. _PDFtk : https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/ .. _XPDF : https://www.xpdfreader.com/ .. _PikePDF : https://pypi.org/search/?q=pikepdf .. _PDF2JPG : https://pypi.org/project/pdf2jpg/ .. _adobe.pdf : https://artifex.com/samples/pdf/adobe.pdf .. _artifex-website.pdf : https://artifex.com/samples/pdf/artifex-website.pdf .. _db-systems.pdf : https://artifex.com/samples/pdf/db-systems.pdf .. _fontforge.pdf : https://artifex.com/samples/pdf/fontforge.pdf .. _pandas.pdf : https://artifex.com/samples/pdf/pandas.pdf .. _pymupdf.pdf : https://artifex.com/samples/pdf/pymupdf.pdf .. _pythonbook.pdf : https://artifex.com/samples/pdf/pythonbook.pdf .. _sample-50-MB-pdf-file.pdf : https://artifex.com/samples/pdf/sample-50-MB-pdf-file.pdf ================================================ FILE: docs/archive-class.rst ================================================ .. include:: header.rst .. _Archive: ================ Archive ================ * New in v1.21.0 This class represents a generalization of file folders and container files like ZIP and TAR archives. Archives allow accessing arbitrary collections of file folders, ZIP / TAR files and single binary data elements as if they all were part of one hierarchical tree of folders. In PyMuPDF, archives are currently only used by :ref:`Story` objects to specify where to look for fonts, images and other resources. ================================ =================================================== **Method / Attribute** **Short Description** ================================ =================================================== :meth:`Archive.add` add new data to the archive :meth:`Archive.has_entry` check if given name is a member :meth:`Archive.read_entry` read the data given by the name :attr:`Archive.entry_list` list[dict] of archive items ================================ =================================================== **Class API** .. class:: Archive .. method:: __init__(self [, content [, path]]) Creates a new archive. Without parameters, an empty archive is created. If provided, `content` may be one of the following: * another Archive: the archive is being made a sub-archive of the new one. * a string: this must be the name of a local folder or file. `pathlib.Path` objects are also supported. - A **folder** will be converted to a sub-archive, so its files (and any sub-folders) can be accessed by their names. - A **file** will be read with mode `"rb"` and these binary data (a `bytes` object) be treated as a single-member sub-archive. In this case, the `path` parameter is **mandatory** and should be the member name under which this item can be found / retrieved. * a `zipfile.ZipFile` or `tarfile.TarFile` object: Will be added as a sub-archive. * a Python binary object (`bytes`, `bytearray`, `io.BytesIO`): this will add a single-member sub-archive. In this case, the `path` parameter is **mandatory** and should be the member name under which this item can be found / retrieved. * a tuple `(data, name)`: This will add a single-member sub-archive with the member name ``name``. ``data`` may be a Python binary object or a local file name (in which case its binary file content is used). Use this format if you need to specify `path`. * a Python sequence: This is a convenience format to specify any combination of the above. If provided, `path` must be a string. * If `content` is either binary data or a file name, this parameter is mandatory and must be the name under which the data can be found. * Otherwise this parameter is optional. It can be used to simulate a folder name or a mount point, under which this sub-archive's elements can be found. For example this specification `Archive((data, "name"), "path")` means that `data` will be found using the element name `"path/name"`. Similar is true for other sub-archives: to retrieve members of a ZIP sub-archive, their names must be prefixed with `"path/"`. The main purpose of this parameter probably is to differentiate between duplicate names. .. note:: If duplicate entry names exist in the archive, always the last entry with that name will be found / retrieved. During archive creation, or appending more data to an archive (see :meth:`Archive.add`) no check for duplicates will be made. Use the `path` parameter to prevent this from happening. .. method:: add(content [,path]) Append a sub-archive. The meaning of the parameters are exactly the same as explained above. Of course, parameter `content` is not optional here. .. method:: has_entry(name) Checks whether an entry exists in any of the sub-archives. :arg str name: The fully qualified name of the entry. So must include any `path` prefix under which the entry's sub-archive has been added. :returns: `True` or `False`. .. method:: read_entry(name) Retrieve the data of an entry. :arg str name: The fully qualified name of the entry. So must include any `path` prefix under which the entry's sub-archive has been added. :returns: The binary data (`bytes`) of the entry. If not found, an exception is raised. .. attribute:: entry_list A list of the archive's sub-archives. Each list item is a dictionary with the following keys: * `entries` -- a list of (top-level) entry names in this sub-archive. * `fmt` -- the format of the sub-archive. This is one of the strings "dir" (file folder), "zip" (ZIP archive), "tar" (TAR archive), or "tree" for single binary entries or file content. * `path` -- the value of the `path` parameter under which this sub-archive was added. **Example:** >>> from pprint import pprint >>> import pymupdf >>> dir1 = "fitz-32" # a folder name >>> dir2 = "fitz-64" # a folder name >>> img = ("nur-ruhig.jpg", "img") # an image file >>> members = (dir1, img, dir2) # we want to append these in one go >>> arch = pymupdf.Archive() >>> arch.add(members, path="mypath") >>> pprint(arch.entry_list) [{'entries': ['310', '37', '38', '39'], 'fmt': 'dir', 'path': 'mypath'}, {'entries': ['img'], 'fmt': 'tree', 'path': 'mypath'}, {'entries': ['310', '311', '37', '38', '39', 'pypy'], 'fmt': 'dir', 'path': 'mypath'}] >>> .. include:: footer.rst ================================================ FILE: docs/changes.rst ================================================ .. include:: header.rst .. include:: ../changes.txt .. include:: footer.rst ================================================ FILE: docs/classes.rst ================================================ .. include:: header.rst ============ Classes ============ .. toctree:: :maxdepth: 2 annot.rst archive-class.rst colorspace.rst displaylist.rst document.rst document-writer-class.rst font.rst identity.rst irect.rst link.rst linkdest.rst matrix.rst outline.rst page.rst pixmap.rst point.rst quad.rst rect.rst shape.rst story-class.rst textpage.rst textwriter.rst tools.rst widget.rst xml-class.rst .. include:: footer.rst ================================================ FILE: docs/colors.rst ================================================ .. include:: header.rst .. _ColorDatabase: ================ Color Database ================ Since the introduction of methods involving colors (like :meth:`Page.draw_circle`), a requirement may be to have access to predefined colors. The fabulous GUI package `wxPython `_ has a database of over 540 predefined RGB colors, which are given more or less memorizable names. Among them are not only standard names like "green" or "blue", but also "turquoise", "skyblue", and 100 (not only 50 ...) shades of "gray", etc. We have taken the liberty to copy this database (a list of tuples) modified into PyMuPDF and make its colors available as PDF compatible float triples: for wxPython's *("WHITE", 255, 255, 255)* we return *(1, 1, 1)*, which can be directly used in *color* and *fill* parameters. We also accept any mixed case of "wHiTe" to find a color. Function *getColor()* ------------------------ As the color database may not be needed very often, one additional import statement seems acceptable to get access to it:: >>> # "getColor" is the only method you really need >>> from pymupdf.utils import getColor >>> getColor("aliceblue") (0.9411764705882353, 0.9725490196078431, 1.0) >>> # >>> # to get a list of all existing names >>> from pymupdf.utils import getColorList >>> cl = getColorList() >>> cl ['ALICEBLUE', 'ANTIQUEWHITE', 'ANTIQUEWHITE1', 'ANTIQUEWHITE2', 'ANTIQUEWHITE3', 'ANTIQUEWHITE4', 'AQUAMARINE', 'AQUAMARINE1'] ... >>> # >>> # to see the full integer color coding >>> from pymupdf.utils import getColorInfoList >>> il = getColorInfoList() >>> il [('ALICEBLUE', 240, 248, 255), ('ANTIQUEWHITE', 250, 235, 215), ('ANTIQUEWHITE1', 255, 239, 219), ('ANTIQUEWHITE2', 238, 223, 204), ('ANTIQUEWHITE3', 205, 192, 176), ('ANTIQUEWHITE4', 139, 131, 120), ('AQUAMARINE', 127, 255, 212), ('AQUAMARINE1', 127, 255, 212)] ... Printing the Color Database ---------------------------- If you want to actually see how the many available colors look like, use scripts `print by RGB `_ or `print by HSV `_ in the examples directory. They create PDFs (already existing in the same directory) with all these colors. Their only difference is sorting order: one takes the RGB values, the other one the Hue-Saturation-Values as sort criteria. This is a screen print of what these files look like. .. image:: images/img-colordb.* .. include:: footer.rst ================================================ FILE: docs/colorspace.rst ================================================ .. include:: header.rst .. _Colorspace: ================ Colorspace ================ Represents the color space of a :ref:`Pixmap`. **Class API** .. class:: Colorspace .. method:: __init__(self, n) Constructor :arg int n: A number identifying the colorspace. Possible values are :data:`CS_RGB`, :data:`CS_GRAY` and :data:`CS_CMYK`. .. attribute:: name The name identifying the colorspace. Example: *pymupdf.csCMYK.name = 'DeviceCMYK'*. :type: str .. attribute:: n The number of bytes required to define the color of one pixel. Example: *pymupdf.csCMYK.n == 4*. :type: int **Predefined Colorspaces** For saving some typing effort, there exist predefined colorspace objects for the three available cases. * :data:`csRGB` = *pymupdf.Colorspace(pymupdf.CS_RGB)* * :data:`csGRAY` = *pymupdf.Colorspace(pymupdf.CS_GRAY)* * :data:`csCMYK` = *pymupdf.Colorspace(pymupdf.CS_CMYK)* .. include:: footer.rst ================================================ FILE: docs/conf.py ================================================ # -*- coding: utf-8 -*- # import re import sys import os import datetime # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. sys.path.insert(0, os.path.abspath(".")) # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. # needs_sphinx = "4.2.0" # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. # extensions = ["sphinx.ext.autodoc", "sphinx.ext.coverage", "sphinx.ext.ifconfig"] extensions = ['sphinx_copybutton','notfound.extension','sphinxcontrib.googleanalytics'] # rst2pdf is not available on OpenBSD. if hasattr(os, "uname") and os.uname()[0] != "OpenBSD": extensions.append("rst2pdf.pdfbuilder") # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"] # The suffix of source filenames. source_suffix = ".rst" # from: pip install sphinxcontrib-googleanalytics googleanalytics_id = "G-JZTN4VTL9M" # The encoding of source files. # source_encoding = 'utf-8-sig' # The master toctree document. root_doc = "index" rst_epilog = '' # General information about the project. project = "PyMuPDF" thisday = datetime.date.today() copyright = "2015-" + str(thisday.year) + ", Artifex" # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The full version, including alpha/beta/rc tags. if 1: # Importing setup.py requires pipcl etc so instead of importing, we grep # for the version info in setup.py and scripts/test.py. setup_py_path = os.path.normpath(f'{__file__}/../../setup.py') with open(setup_py_path) as f: setup_py_text = f.read() regex = "\nversion_p = '([0-9.]+)'\n" m = re.search(regex, setup_py_text) assert m, f'Cannot find version number in {setup_py_path!r} with {regex=}.' version = m.group(1) test_py_path = os.path.normpath(f'{__file__}/../../scripts/test.py') with open(test_py_path) as f: test_py_text = f.read() regex = '\npython_versions_minor = (.+)\n' m = re.search(regex, test_py_text) assert m, f'Cannot find python_versions_minor in {test_py_path!r} with {regex=}.' python_versions_minor = m.group(1) python_versions_minor = eval(m.group(1)) else: # PyMuPDF version is set in setup.py, so we import it here. sys.path.insert(0, os.path.abspath(f'{__file__}/../..')) try: import setup finally: del sys.path[0] version = setup.version_p del setup # Necessary otherwise sphinx seems to do `setup()`. # Supported Python versions are set in scripts.test.py. sys.path.insert(0, os.path.abspath(f'{__file__}/../../scripts')) try: import test finally: del sys.path[0] python_versions_minor = test.python_versions_minor del test python_versions_list = [f'3.{i}' for i in python_versions_minor] python_versions = ', '.join(python_versions_list[:-1]) + f' and {python_versions_list[-1]}' # Make `|python_versions|` available in .rst files. rst_epilog += f'.. |python_versions| replace:: {python_versions}\n' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: # today = '' # Else, today_fmt is used as the format for a strftime call. # today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = ["_build", "build"] # The reST default role (used for this markup: `text`) to use for all # documents. default_role = "any" # If true, '()' will be appended to :func: etc. cross-reference text. add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = "sphinx" # A list of ignored prefixes for module index sorting. modindex_common_prefix = [] # If true, keep warnings as "system message" paragraphs in the built documents. keep_warnings = False # Localization vars gettext_uuid = True gettext_compact = False locale_dirs = ["locales"] # -- Options for HTML output ---------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = "furo" # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. html_theme_options = { "canonical_url": "", "logo_only": False, "display_version": True, "prev_next_buttons_location": None, # Toc options "collapse_navigation": True, "sticky_navigation": True, "navigation_depth": 4, "includehidden": True, "titles_only": False, } # Add any paths that contain custom themes here, relative to this directory. # html_theme_path = [] # html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". # html_title = None # A shorter title for the navigation bar. Default is the same as html_title. # html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. html_favicon = "_static/PyMuPDF.ico" # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ["_static"] html_theme_options = { "light_logo": "sidebar-logo-dark.svg", "dark_logo": "sidebar-logo-light.svg", } # A list of CSS files. The entry must be a filename string or a tuple containing # the filename string and the attributes dictionary. The filename must be # relative to the html_static_path, or a full URI html_css_files = ["custom.css"] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. # html_extra_path = [] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. html_last_updated_fmt = "%d. %b %Y" # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. # html_use_smartypants = False # Custom sidebar templates, maps document names to template names. # html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. html_additional_pages = {} # If false, no module index is generated. html_domain_indices = True # If false, no index is generated. html_use_index = True # If true, the index is split into individual pages for each letter. html_split_index = True # If true, links to the reST sources are added to the pages. html_show_sourcelink = True html_sourcelink_suffix = ".rst" # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. html_show_sphinx = False # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. html_use_opensearch = "" # This is the file name suffix for HTML files (e.g. ".xhtml"). html_file_suffix = None # Output file base name for HTML help builder. htmlhelp_basename = "PyMuPDF" # -- Options for LaTeX output --------------------------------------------- latex_elements = { # "fontpkg": r"\usepackage[sfdefault]{ClearSans} \usepackage[T1]{fontenc}" } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [("index", "PyMuPDF.tex", "PyMuPDF Documentation", "Artifex", "manual")] # The name of an image file (relative to this directory) to place at the top of # the title page. latex_logo = "images/pymupdf-logo.png" # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. # latex_use_parts = False # If true, show page references after internal links. latex_show_pagerefs = False # If true, show URL addresses after external links. # latex_show_urls = True # latex_use_xindy = True # Documents to append as an appendix to all manuals. # latex_appendices = [] # If false, no module index is generated. latex_domain_indices = True # -- Options for PDF output -------------------------------------------------- # Grouping the document tree into PDF files. List of tuples # (source start file, target name, title, author). pdf_documents = [("index", "PyMuPDF", "PyMuPDF Manual", "Artifex")] # A comma-separated list of custom stylesheets. Example: # pdf_stylesheets = ["sphinx", "bahnschrift", "a4"] # Create a compressed PDF pdf_compressed = True # A colon-separated list of folders to search for fonts. Example: # pdf_font_path=['/usr/share/fonts', '/usr/share/texmf-dist/fonts/'] # Language to be used for hyphenation support pdf_language = "en_US" # If false, no index is generated. pdf_use_index = True # If false, no modindex is generated. pdf_use_modindex = True # If false, no coverpage is generated. pdf_use_coverpage = True pdf_break_level = 2 pdf_verbosity = 0 pdf_invariant = True ================================================ FILE: docs/converting-files.rst ================================================ .. include:: header.rst .. _ConvertingFiles: ============================== Converting Files ============================== Files to PDF ~~~~~~~~~~~~~~~~~~ :ref:`Document types supported by PyMuPDF` can easily be converted to |PDF| by using the :meth:`Document.convert_to_pdf` method. This method returns a buffer of data which can then be utilized by |PyMuPDF| to create a new |PDF|. **Example** .. code-block:: python import pymupdf xps = pymupdf.open("input.xps") pdfbytes = xps.convert_to_pdf() pdf = pymupdf.open("pdf", pdfbytes) pdf.save("output.pdf") PDF to SVG ~~~~~~~~~~~~~~~~~~ Technically, as SVG files cannot be multipage, we must export each page as an SVG. To get an SVG representation of a page use the :meth:`Page.get_svg_image` method. **Example** .. code-block:: python import pymupdf doc = pymupdf.open("input.pdf") page = doc[0] # Convert page to SVG svg_content = page.get_svg_image() # Save to file with open("output.svg", "w", encoding="utf-8") as f: f.write(svg_content) doc.close() PDF to Markdown ~~~~~~~~~~~~~~~~~ By utlilizing the :doc:`PyMuPDF4LLM API ` we are able to convert PDF to a Markdown representation. **Example** .. code-block:: python import pymupdf4llm import pathlib md_text = pymupdf4llm.to_markdown("test.pdf") print(md_text) pathlib.Path("4llm-output.md").write_bytes(md_text.encode()) PDF to DOCX ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Use the pdf2docx_ library which uses |PyMuPDF| to provide document conversion from |PDF| to **DOCX** format. **Example** .. code-block:: python from pdf2docx import Converter pdf_file = 'input.pdf' docx_file = 'output.docx' # convert pdf to docx cv = Converter(pdf_file) cv.convert(docx_file) # all pages by default cv.close() .. include:: footer.rst ================================================ FILE: docs/coop_low.rst ================================================ .. include:: header.rst .. _cooperation: =============================================================== Working together: DisplayList and TextPage =============================================================== Here are some instructions on how to use these classes together. In some situations, performance improvements may be achievable, when you fall back to the detail level explained here. Create a DisplayList --------------------- A :ref:`DisplayList` represents an interpreted document page. Methods for pixmap creation, text extraction and text search are -- behind the curtain -- all using the page's display list to perform their tasks. If a page must be rendered several times (e.g. because of changed zoom levels), or if text search and text extraction should both be performed, overhead can be saved, if the display list is created only once and then used for all other tasks. >>> dl = page.get_displaylist() # create the display list You can also create display lists for many pages "on stack" (in a list), may be during document open, during idling times, or you store it when a page is visited for the first time (e.g. in GUI scripts). Note, that for everything what follows, only the display list is needed -- the corresponding :ref:`Page` object could have been deleted. Generate Pixmap ------------------ The following creates a Pixmap from a :ref:`DisplayList`. Parameters are the same as for :meth:`Page.get_pixmap`. >>> pix = dl.get_pixmap() # create the page's pixmap The execution time of this statement may be up to 50% shorter than that of :meth:`Page.get_pixmap`. Perform Text Search --------------------- With the display list from above, we can also search for text. For this we need to create a :ref:`TextPage`. >>> tp = dl.get_textpage() # display list from above >>> rlist = tp.search("needle") # look up "needle" locations >>> for r in rlist: # work with the found locations, e.g. pix.invert_irect(r.irect) # invert colors in the rectangles Extract Text ---------------- With the same :ref:`TextPage` object from above, we can now immediately use any or all of the 5 text extraction methods. .. note:: Above, we have created our text page without argument. This leads to a default argument of 3 (:data:`ligatures` and white-space are preserved), IAW images will **not** be extracted -- see below. >>> txt = tp.extractText() # plain text format >>> json = tp.extractJSON() # json format >>> html = tp.extractHTML() # HTML format >>> xml = tp.extractXML() # XML format >>> xml = tp.extractXHTML() # XHTML format Further Performance improvements --------------------------------- Pixmap ~~~~~~~ As explained in the :ref:`Page` chapter: If you do not need transparency set *alpha = 0* when creating pixmaps. This will save 25% memory (if RGB, the most common case) and possibly 5% execution time (depending on the GUI software). TextPage ~~~~~~~~~ If you do not need images extracted alongside the text of a page, you can set the following option: >>> flags = pymupdf.TEXT_PRESERVE_LIGATURES | pymupdf.TEXT_PRESERVE_WHITESPACE >>> tp = dl.get_textpage(flags) This will save ca. 25% overall execution time for the HTML, XHTML and JSON text extractions and **hugely** reduce the amount of storage (both, memory and disk space) if the document is graphics oriented. If you however do need images, use a value of 7 for flags: >>> flags = pymupdf.TEXT_PRESERVE_LIGATURES | pymupdf.TEXT_PRESERVE_WHITESPACE | pymupdf.TEXT_PRESERVE_IMAGES .. include:: footer.rst ================================================ FILE: docs/device.rst ================================================ .. include:: header.rst .. _Device: ================ Device ================ The different format handlers (pdf, xps, etc.) interpret pages to a "device". Devices are the basis for everything that can be done with a page: rendering, text extraction and searching. The device type is determined by the selected construction method. **Class API** .. class:: Device .. method:: __init__(self, object, clip) Constructor for either a pixel map or a display list device. :arg object: either a ``Pixmap`` or a ``DisplayList``. :type object: :ref:`Pixmap` or :ref:`DisplayList` :arg clip: An optional `IRect` for ``Pixmap`` devices to restrict rendering to a certain area of the page. If the complete page is required, specify ``None``. For display list devices, this parameter must be omitted. :type clip: :ref:`IRect` .. method:: __init__(self, textpage, flags=0) Constructor for a text page device. :arg textpage: ``TextPage`` object :type textpage: :ref:`TextPage` :arg int flags: control the way how text is parsed into the text page. Currently 3 options can be coded into this parameter, see :ref:`TextPreserve`. To set these options use something like `flags=0 | TEXT_PRESERVE_LIGATURES | ...`. .. include:: footer.rst ================================================ FILE: docs/displaylist.rst ================================================ .. include:: header.rst .. _DisplayList: ================ DisplayList ================ DisplayList is a list containing drawing commands (text, images, etc.). The intent is two-fold: 1. as a caching-mechanism to reduce parsing of a page 2. as a data structure in multi-threading setups, where one thread parses the page and another one renders pages. This aspect is currently not supported by PyMuPDF. A display list is populated with objects from a page, usually by executing :meth:`Page.get_displaylist`. There also exists an independent constructor. "Replay" the list (once or many times) by invoking one of its methods :meth:`~DisplayList.run`, :meth:`~DisplayList.get_pixmap` or :meth:`~DisplayList.get_textpage`. ================================= ============================================ **Method** **Short Description** ================================= ============================================ :meth:`~DisplayList.run` Run a display list through a device. :meth:`~DisplayList.get_pixmap` generate a pixmap :meth:`~DisplayList.get_textpage` generate a text page :attr:`~DisplayList.rect` mediabox of the display list ================================= ============================================ **Class API** .. class:: DisplayList .. method:: __init__(self, mediabox) Create a new display list. :arg mediabox: The page's rectangle. :type mediabox: :ref:`Rect` :rtype: ``DisplayList`` .. method:: run(device, matrix, area) Run the display list through a device. The device will populate the display list with its "commands" (i.e. text extraction or image creation). The display list can later be used to "read" a page many times without having to re-interpret it from the document file. You will most probably instead use one of the specialized run methods below -- :meth:`get_pixmap` or :meth:`get_textpage`. :arg device: Device :type device: :ref:`Device` :arg matrix: Transformation matrix to apply to the display list contents. :type matrix: :ref:`Matrix` :arg area: Only the part visible within this area will be considered when the list is run through the device. :type area: :ref:`Rect` .. index:: pair: matrix; DisplayList.get_pixmap pair: colorspace; DisplayList.get_pixmap pair: clip; DisplayList.get_pixmap pair: alpha; DisplayList.get_pixmap .. method:: get_pixmap(matrix=pymupdf.Identity, colorspace=pymupdf.csRGB, alpha=0, clip=None) Run the display list through a draw device and return a pixmap. :arg matrix: matrix to use. Default is the identity matrix. :type matrix: :ref:`Matrix` :arg colorspace: the desired colorspace. Default is RGB. :type colorspace: :ref:`Colorspace` :arg int alpha: determine whether or not (0, default) to include a transparency channel. :arg irect_like clip: restrict rendering to the intersection of this area with :attr:`DisplayList.rect`. :rtype: :ref:`Pixmap` :returns: pixmap of the display list. .. method:: get_textpage(flags) Run the display list through a text device and return a text page. :arg int flags: control which information is parsed into a text page. Default value in PyMuPDF is `3 = TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE`, i.e. :data:`ligatures` are **passed through**, white spaces are **passed through** (not translated to spaces), and images are **not included**. See :ref:`TextPreserve`. :rtype: :ref:`TextPage` :returns: text page of the display list. .. attribute:: rect Contains the display list's mediabox. This will equal the page's rectangle if it was created via :meth:`Page.get_displaylist`. :type: :ref:`Rect` .. include:: footer.rst ================================================ FILE: docs/document-writer-class.rst ================================================ .. include:: header.rst .. _DocumentWriter: ================ DocumentWriter ================ |pdf_only_class| * New in v1.21.0 This class represents a utility which can output various :ref:`document types supported by PyMuPDF`. In |PyMuPDF| only used for outputting PDF documents whose pages are populated by :ref:`Story` DOMs. Using DocumentWriter_ also for other document types might happen in the future. ================================= =================================================== **Method / Attribute** **Short Description** ================================= =================================================== :meth:`DocumentWriter.begin_page` start a new output page :meth:`DocumentWriter.end_page` finish the current output page :meth:`DocumentWriter.close` flush pending output and close the file ================================= =================================================== **Class API** .. class:: DocumentWriter .. method:: __init__(self, path, options=None) Create a document writer object, passing a Python file pointer or a file path. Options to use when saving the file may also be passed. This class can also be used as a Python context manager. :arg path: the output file. This may be a string file name, or any Python file pointer. .. note:: By using a `io.BytesIO()` object as file pointer, a document writer can create a PDF in memory. Subsequently, this PDF can be re-opened for input and be further manipulated. This technique is used by several example scripts in :ref:`Stories recipes`. :arg str options: specify saving options for the output PDF. Typical are "compress" or "clean". More possible values may be taken from help output of the `mutool convert` CLI utility. .. method:: begin_page(mediabox) Start a new output page of a given dimension. :arg rect_like mediabox: a rectangle specifying the page size. After this method, output operations may write content to the page. .. method:: end_page() Finish a page. This flushes any pending data and appends the page to the output document. .. method:: close() Close the output file. This method is required for writing any pending data. For usage examples consult the section of :ref:`Story`. .. include:: footer.rst ================================================ FILE: docs/document.rst ================================================ .. include:: header.rst .. _Document: ================ Document ================ .. highlight:: python This class represents a document. It can be constructed from a file or from memory. There exists the alias *open* for this class, i.e. `pymupdf.Document(...)` and `pymupdf.open(...)` do exactly the same thing. For details on **embedded files** refer to Appendix 3. .. note:: Starting with v1.17.0, a new page addressing mechanism for **EPUB files only** is supported. This document type is internally organized in chapters such that pages can most efficiently be found by their so-called "location". The location is a tuple *(chapter, pno)* consisting of the chapter number and the page number **in that chapter**. Both numbers are zero-based. While it is still possible to locate a page via its (absolute) number, doing so may mean that the complete EPUB document must be laid out before the page can be addressed. This may have a significant performance impact if the document is very large. Using the page's *(chapter, pno)* prevents this from happening. To maintain a consistent API, PyMuPDF supports the page *location* syntax for **all file types** -- documents without this feature simply have just one chapter. :meth:`Document.load_page` and the equivalent index access now also support a *location* argument. There are a number of methods for converting between page numbers and locations, for determining the chapter count, the page count per chapter, for computing the next and the previous locations, and the last page location of a document. ======================================= ========================================================== **Method / Attribute** **Short Description** ======================================= ========================================================== :meth:`Document.add_layer` PDF only: make new optional content configuration :meth:`Document.add_ocg` PDF only: add new optional content group :meth:`Document.authenticate` gain access to an encrypted document :meth:`Document.bake` PDF only: make annotations / fields permanent content :meth:`Document.can_save_incrementally` check if incremental save is possible :meth:`Document.chapter_page_count` number of pages in chapter :meth:`Document.close` close the document :meth:`Document.convert_to_pdf` write a PDF version to memory :meth:`Document.copy_page` PDF only: copy a page reference :meth:`Document.del_toc_item` PDF only: remove a single TOC item :meth:`Document.delete_page` PDF only: delete a page :meth:`Document.delete_pages` PDF only: delete multiple pages :meth:`Document.embfile_add` PDF only: add a new embedded file from buffer :meth:`Document.embfile_count` PDF only: number of embedded files :meth:`Document.embfile_del` PDF only: delete an embedded file entry :meth:`Document.embfile_get` PDF only: extract an embedded file buffer :meth:`Document.embfile_info` PDF only: metadata of an embedded file :meth:`Document.embfile_names` PDF only: list of embedded files :meth:`Document.embfile_upd` PDF only: change an embedded file :meth:`Document.extract_font` PDF only: extract a font by :data:`xref` :meth:`Document.extract_image` PDF only: extract an embedded image by :data:`xref` :meth:`Document.ez_save` PDF only: :meth:`Document.save` with different defaults :meth:`Document.find_bookmark` retrieve page location after laid out document :meth:`Document.fullcopy_page` PDF only: duplicate a page :meth:`Document.get_layer` PDF only: lists of OCGs in ON, OFF, RBGroups :meth:`Document.get_layers` PDF only: list of optional content configurations :meth:`Document.get_oc` PDF only: get OCG /OCMD xref of image / form xobject :meth:`Document.get_ocgs` PDF only: info on all optional content groups :meth:`Document.get_ocmd` PDF only: retrieve definition of an :data:`OCMD` :meth:`Document.get_page_fonts` PDF only: list of fonts referenced by a page :meth:`Document.get_page_images` PDF only: list of images referenced by a page :meth:`Document.get_page_labels` PDF only: list of page label definitions :meth:`Document.get_page_numbers` PDF only: get page numbers having a given label :meth:`Document.get_page_pixmap` create a pixmap of a page by page number :meth:`Document.get_page_text` extract the text of a page by page number :meth:`Document.get_page_xobjects` PDF only: list of XObjects referenced by a page :meth:`Document.get_sigflags` PDF only: determine signature state :meth:`Document.get_toc` extract the table of contents :meth:`Document.get_xml_metadata` PDF only: read the XML metadata :meth:`Document.has_annots` PDF only: check if PDF contains any annots :meth:`Document.has_links` PDF only: check if PDF contains any links :meth:`Document.insert_page` PDF only: insert a new page :meth:`Document.insert_pdf` PDF only: insert pages from another PDF :meth:`Document.insert_file` PDF only: insert pages from arbitrary document :meth:`Document.journal_can_do` PDF only: which journal actions are possible :meth:`Document.journal_enable` PDF only: enables journalling for the document :meth:`Document.journal_load` PDF only: load journal from a file :meth:`Document.journal_op_name` PDF only: return name of a journalling step :meth:`Document.journal_position` PDF only: return journalling status :meth:`Document.journal_redo` PDF only: redo current operation :meth:`Document.journal_save` PDF only: save journal to a file :meth:`Document.journal_start_op` PDF only: start an "operation" giving it a name :meth:`Document.journal_stop_op` PDF only: end current operation :meth:`Document.journal_undo` PDF only: undo current operation :meth:`Document.layer_ui_configs` PDF only: list of optional content intents :meth:`Document.layout` re-paginate the document (if supported) :meth:`Document.load_page` read a page :meth:`Document.make_bookmark` create a page pointer in reflowable documents :meth:`Document.move_page` PDF only: move a page to different location in doc :meth:`Document.need_appearances` PDF only: get/set `/NeedAppearances` property :meth:`Document.new_page` PDF only: insert a new empty page :meth:`Document.next_location` return (chapter, pno) of following page :meth:`Document.outline_xref` PDF only: :data:`xref` a TOC item :meth:`Document.page_cropbox` PDF only: the unrotated page rectangle :meth:`Document.page_xref` PDF only: :data:`xref` of a page number :meth:`Document.pages` iterator over a page range :meth:`Document.pdf_catalog` PDF only: :data:`xref` of catalog (root) :meth:`Document.pdf_trailer` PDF only: trailer source :meth:`Document.prev_location` return (chapter, pno) of preceding page :meth:`Document.rewrite_images` PDF only: rewrite / extra compression for images :meth:`Document.recolor` PDF only: execute :meth:`Page.recolor` for all pages :meth:`Document.reload_page` PDF only: provide a new copy of a page :meth:`Document.resolve_names` PDF only: Convert destination names into a Python dict :meth:`Document.save` PDF only: save the document :meth:`Document.saveIncr` PDF only: save the document incrementally :meth:`Document.scrub` PDF only: remove sensitive data :meth:`Document.search_page_for` search for a string on a page :meth:`Document.select` PDF only: select a subset of pages :meth:`Document.set_layer_ui_config` PDF only: set OCG visibility temporarily :meth:`Document.set_layer` PDF only: mass changing OCG states :meth:`Document.set_markinfo` PDF only: set the MarkInfo values :meth:`Document.set_metadata` PDF only: set the metadata :meth:`Document.set_oc` PDF only: attach OCG/OCMD to image / form xobject :meth:`Document.set_ocmd` PDF only: create or update an :data:`OCMD` :meth:`Document.set_page_labels` PDF only: add/update page label definitions :meth:`Document.set_pagemode` PDF only: set the PageMode :meth:`Document.set_pagelayout` PDF only: set the PageLayout :meth:`Document.set_toc_item` PDF only: change a single TOC item :meth:`Document.set_toc` PDF only: set the table of contents (TOC) :meth:`Document.set_xml_metadata` PDF only: create or update document XML metadata :meth:`Document.subset_fonts` PDF only: create font subsets :meth:`Document.switch_layer` PDF only: activate OC configuration :meth:`Document.tobytes` PDF only: writes document to memory :meth:`Document.xref_copy` PDF only: copy a PDF dictionary to another :data:`xref` :meth:`Document.xref_get_key` PDF only: get the value of a dictionary key :meth:`Document.xref_get_keys` PDF only: list the keys of object at :data:`xref` :meth:`Document.xref_object` PDF only: get the definition source of :data:`xref` :meth:`Document.xref_set_key` PDF only: set the value of a dictionary key :meth:`Document.xref_stream_raw` PDF only: raw stream source at :data:`xref` :meth:`Document.xref_xml_metadata` PDF only: :data:`xref` of XML metadata :attr:`Document.chapter_count` number of chapters :attr:`Document.FormFonts` PDF only: list of global widget fonts :attr:`Document.is_closed` has document been closed? :attr:`Document.is_dirty` PDF only: has document been changed yet? :attr:`Document.is_encrypted` document (still) encrypted? :attr:`Document.is_fast_webaccess` is PDF linearized? :attr:`Document.is_form_pdf` is this a Form PDF? :attr:`Document.is_pdf` is this a PDF? :attr:`Document.is_reflowable` is this a reflowable document? :attr:`Document.is_repaired` PDF only: has this PDF been repaired during open? :attr:`Document.last_location` (chapter, pno) of last page :attr:`Document.metadata` metadata :attr:`Document.markinfo` PDF MarkInfo value :attr:`Document.name` filename of document :attr:`Document.needs_pass` require password to access data? :attr:`Document.outline` first `Outline` item :attr:`Document.page_count` number of pages :attr:`Document.permissions` permissions to access the document :attr:`Document.pagemode` PDF PageMode value :attr:`Document.pagelayout` PDF PageLayout value :attr:`Document.version_count` PDF count of versions ======================================= ========================================================== **Class API** .. class:: Document .. index:: pair: filename; open pair: stream; open pair: filetype; open pair: rect; open pair: width; open pair: height; open pair: fontsize; open pair: open; Document pair: filename; Document pair: stream; Document pair: filetype; Document pair: rect; Document pair: fontsize; Document .. method:: __init__(self, filename=None, stream=None, *, filetype=None, rect=None, width=0, height=0, fontsize=11) Create a ``Document`` object. * With default parameters, a **new empty PDF** document will be created. * If ``stream`` is given, then the document is created from memory. * If ``stream`` is `None`, then a document is created from the file given by ``filename``. :arg str,pathlib filename: A UTF-8 string or ``pathlib.Path`` object containing a file path. The document type is always determined from the file content. The ``filetype`` parameter is ignored, except when content inspection was unsuccessful. This is regularly the case for plain text types like "txt", "html", "xml" etc. with a wrong or missing file extension. :arg bytes,bytearray,BytesIO stream: A memory area containing file data. The document type is always detected from the data content. The ``filetype`` parameter is ignored, except when content inspection was unsuccessful. This is regularly the case for plain text types like "txt", "html", "xml" etc. :arg str filetype: A string specifying the type of document. This is only ever needed when file content inspection fails. Text types like "txt", "html", "xml" etc. cannot be disambiguated by their content. When such files are provided in memory or being provided with the wrong file extension, this parameter **must** be used. :arg rect_like rect: a rectangle specifying the desired page size. This parameter is only meaningful for documents with a variable page layout ("reflowable" documents), like e-books or HTML, and ignored otherwise. If specified, it must be a non-empty, finite rectangle with top-left coordinates (0, 0). Together with parameter :data:`fontsize`, each page will be accordingly laid out and hence also determine the number of pages. :arg float width: may used together with ``height`` as an alternative to ``rect`` to specify layout information. :arg float height: may used together with ``width`` as an alternative to ``rect`` to specify layout information. :arg float fontsize: the default :data:`fontsize` for reflowable document types. This parameter is ignored if none of the parameters ``rect`` or ``width`` and ``height`` are specified. Will be used to calculate the page layout. :raises TypeError: if the *type* of any parameter does not conform. :raises FileNotFoundError: if the file / path cannot be found. Re-implemented as subclass of `RuntimeError`. :raises EmptyFileError: if the file / path is empty or the `bytes` object in memory has zero length. A subclass of `FileDataError` and `RuntimeError`. :raises ValueError: if an unknown file type is explicitly specified. :raises FileDataError: if the document has an invalid structure for the given type -- or is no file at all (but e.g. a folder). A subclass of `RuntimeError`. :return: A document object. If the document cannot be created, an exception is raised in the above sequence. Note that PyMuPDF-specific exceptions, `FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted if you check for `RuntimeError`. In case of problems you can see more detail in the internal messages store: `print(pymupdf.TOOLS.mupdf_warnings())` (which will be emptied by this call, but you can also prevent this -- consult :meth:`Tools.mupdf_warnings`). Overview of possible forms, note: `open` is a synonym of `Document`:: >>> # from a file >>> doc = pymupdf.open("some.xps") >>> # handle wrong extension >>> doc = pymupdf.open("some.file", filetype="xps") # assert expected type >>> doc = pymupdf.open("some.file", filetype="txt") # treat as plain text >>> >>> # from memory >>> doc = pymupdf.open(stream=mem_area) # works for any supported type >>> doc = pymupdf.open(stream=unknown-type, filetype="txt") # treat as plain text >>> >>> # new empty PDF >>> doc = pymupdf.open() >>> doc = pymupdf.open(None) >>> doc = pymupdf.open("") .. note:: Raster images with a wrong (but supported) file extension **are no problem**. MuPDF will determine the correct image type when file **content** is actually accessed and will process it without complaint. The Document class can be also be used as a **context manager**. Exiting the content manager will close the document automatically. >>> import pymupdf >>> with pymupdf.open(...) as doc: for page in doc: print(f"page {page.number}") page 0 page 1 page 2 page 3 >>> doc.is_closed True >>> .. method:: get_oc(xref) * New in v1.18.4 Return the cross reference number of an :data:`OCG` or :data:`OCMD` attached to an image or form xobject. :arg int xref: the :data:`xref` of an image or form xobject. Valid such cross reference numbers are returned by :meth:`Document.get_page_images`, resp. :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is raised. :rtype: int :returns: the cross reference number of an optional contents object or zero if there is none. .. method:: set_oc(xref, ocxref) * New in v1.18.4 If :data:`xref` represents an image or form xobject, set or remove the cross reference number *ocxref* of an optional contents object. :arg int xref: the :data:`xref` of an image or form xobject [#f5]_. Valid such cross reference numbers are returned by :meth:`Document.get_page_images`, resp. :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is raised. :arg int ocxref: the :data:`xref` number of an :data:`OCG` / :data:`OCMD`. If not zero, an invalid reference raises an exception. If zero, any OC reference is removed. .. method:: get_layers() * New in v1.18.3 Show optional layer configurations. There always is a standard one, which is not included in the response. >>> for item in doc.get_layers(): print(item) {'number': 0, 'name': 'my-config', 'creator': ''} >>> # use 'number' as config identifier in add_ocg .. method:: add_layer(name, creator=None, on=None) * New in v1.18.3 Add an optional content configuration. Layers serve as a collection of ON / OFF states for optional content groups and allow fast visibility switches between different views on the same document. :arg str name: arbitrary name. :arg str creator: (optional) creating software. :arg sequ on: a sequence of OCG :data:`xref` numbers which should be set to ON when this layer gets activated. All OCGs not listed here will be set to OFF. .. method:: switch_layer(number, as_default=False) * New in v1.18.3 Switch to a document view as defined by the optional layer's configuration number. This is temporary, except if established as default. :arg int number: config number as returned by :meth:`Document.layer_configs`. :arg bool as_default: make this the default configuration. Activates the ON / OFF states of OCGs as defined in the identified layer. If ``as_default=True``, then additionally all layers, including the standard one, are merged and the result is written back to the standard layer, and **all optional layers are deleted**. .. method:: add_ocg(name, config=-1, on=True, intent="View", usage="Artwork") * New in v1.18.3 Add an optional content group. An OCG is the most important unit of information to determine object visibility. For a PDF, in order to be regarded as having optional content, at least one OCG must exist. :arg str name: arbitrary name. Will show up in supporting PDF viewers. :arg int config: layer configuration number. Default -1 is the standard configuration. :arg bool on: standard visibility status for objects pointing to this OCG. :arg str,list intent: a string or list of strings declaring the visibility intents. There are two PDF standard values to choose from: "View" and "Design". Default is "View". Correct **spelling is important**. :arg str usage: another influencer for OCG visibility. This will become part of the OCG's `/Usage` key. There are two PDF standard values to choose from: "Artwork" and "Technical". Default is "Artwork". Please only change when required. :returns: :data:`xref` of the created OCG. Use as entry for `oc` parameter in supporting objects. .. note:: Multiple OCGs with identical parameters may be created. This will not cause problems. Garbage option 3 of :meth:`Document.save` will get rid of any duplicates. .. method:: set_ocmd(xref=0, ocgs=None, policy="AnyOn", ve=None) * New in v1.18.4 Create or update an :data:`OCMD`, **Optional Content Membership Dictionary.** :arg int xref: :data:`xref` of the OCMD to be updated, or 0 for a new OCMD. :arg list ocgs: a sequence of :data:`xref` numbers of existing :data:`OCG` PDF objects. :arg str policy: one of "AnyOn" (default), "AnyOff", "AllOn", "AllOff" (mixed or lower case). :arg list ve: a "visibility expression". This is a list of arbitrarily nested other lists -- see explanation below. Use as an alternative to the combination *ocgs* / *policy* if you need to formulate more complex conditions. :rtype: int :returns: :data:`xref` of the OCMD. Use as `oc=xref` parameter in supporting objects, and respectively in :meth:`Document.set_oc` or :meth:`Annot.set_oc`. .. note:: Like an OCG, an OCMD has a visibility state ON or OFF, and it can be used like an OCG. In contrast to an OCG, the OCMD state is determined by evaluating the state of one or more OCGs via special forms of **boolean expressions.** If the expression evaluates to true, the OCMD state is ON and OFF for false. There are two ways to formulate OCMD visibility: 1. Use the combination of *ocgs* and *policy*: The *policy* value is interpreted as follows: - AnyOn -- (default) true if at least one OCG is ON. - AnyOff -- true if at least one OCG is OFF. - AllOn -- true if all OCGs are ON. - AllOff -- true if all OCGs are OFF. Suppose you want two PDF objects be displayed exactly one at a time (if one is ON, then the other one must be OFF): Solution: use an **OCG** for object 1 and an **OCMD** for object 2. Create the OCMD via `set_ocmd(ocgs=[xref], policy="AllOff")`, with the :data:`xref` of the OCG. 2. Use the **visibility expression** *ve*: This is a list of two or more items. The **first item** is a logical keyword: one of the strings **"and"**, **"or"**, or **"not"**. The **second** and all subsequent items must either be an integer or another list. An integer must be the :data:`xref` number of an OCG. A list must again have at least two items starting with one of the boolean keywords. This syntax is a bit awkward, but quite powerful: - Each list must start with a logical keyword. - If the keyword is a **"not"**, then the list must have exactly two items. If it is **"and"** or **"or"**, any number of other items may follow. - Items following the logical keyword may be either integers or again a list. An *integer* must be the xref of an OCG. A *list* must conform to the previous rules. **Examples:** - `set_ocmd(ve=["or", 4, ["not", 5], ["and", 6, 7]])`. This delivers ON if the following is true: **"4 is ON, or 5 is OFF, or 6 and 7 are both ON"**. - `set_ocmd(ve=["not", xref])`. This has the same effect as the OCMD example created under 1. For more details and examples see page 224 of :ref:`AdobeManual`. Also do have a look at example scripts `here `_. Visibility expressions, `/VE`, are part of PDF specification version 1.6. So not all PDF viewers / readers may already support this feature and hence will react in some standard way for those cases. .. method:: get_ocmd(xref) * New in v1.18.4 Retrieve the definition of an :data:`OCMD`. :arg int xref: the :data:`xref` of the OCMD. :rtype: dict :returns: a dictionary with the keys :data:`xref`, *ocgs*, *policy* and *ve*. .. method:: get_layer(config=-1) * New in v1.18.3 List of optional content groups by status in the specified configuration. This is a dictionary with lists of cross reference numbers for OCGs that occur in the arrays `/ON`, `/OFF` or in some radio button group (`/RBGroups`). :arg int config: the configuration layer (default is the standard config layer). >>> pprint(doc.get_layer()) {'off': [8, 9, 10], 'on': [5, 6, 7], 'rbgroups': [[7, 10]]} >>> .. method:: set_layer(config, *, on=None, off=None, basestate=None, rbgroups=None, locked=None) * New in v1.18.3 * Changed in v1.22.5: Support list of *locked* OCGs. Mass status changes of optional content groups. **Permanently** sets the status of OCGs. :arg int config: desired configuration layer, choose -1 for the default one. :arg list on: list of :data:`xref` of OCGs to set ON. Replaces previous values. An empty list will cause no OCG being set to ON anymore. Should be specified if `basestate="ON"` is used. :arg list off: list of :data:`xref` of OCGs to set OFF. Replaces previous values. An empty list will cause no OCG being set to OFF anymore. Should be specified if `basestate="OFF"` is used. :arg str basestate: state of OCGs that are not mentioned in *on* or *off*. Possible values are "ON", "OFF" or "Unchanged". Upper / lower case possible. :arg list rbgroups: a list of lists. Replaces previous values. Each sublist should contain two or more OCG xrefs. OCGs in the same sublist are handled like buttons in a radio button group: setting one to ON automatically sets all other group members to OFF. :arg list locked: a list of OCG xref number that cannot be changed by the user interface. Values `None` will not change the corresponding PDF array. >>> doc.set_layer(-1, basestate="OFF") # only changes the base state >>> pprint(doc.get_layer()) {'basestate': 'OFF', 'off': [8, 9, 10], 'on': [5, 6, 7], 'rbgroups': [[7, 10]]} .. method:: get_ocgs() * New in v1.18.3 Details of all optional content groups. This is a dictionary of dictionaries like this (key is the OCG's :data:`xref`): >>> pprint(doc.get_ocgs()) {13: {'on': True, 'intent': ['View', 'Design'], 'name': 'Circle', 'usage': 'Artwork'}, 14: {'on': True, 'intent': ['View', 'Design'], 'name': 'Square', 'usage': 'Artwork'}, 15: {'on': False, 'intent': ['View'], 'name': 'Square', 'usage': 'Artwork'}} >>> .. method:: layer_ui_configs() * New in v1.18.3 Show the visibility status of optional content that is modifiable by the user interface of supporting PDF viewers. * Only reports items contained in the currently selected layer configuration. * The meaning of the dictionary keys is as follows: - *depth:* item's nesting level in the `/Order` array - *locked:* true if cannot be changed via user interfaces - *number:* running sequence number - *on:* item state - *text:* text string or name field of the originating OCG - *type:* one of "label" (set by a text string), "checkbox" (set by a single OCG) or "radiobox" (set by a set of connected OCGs) .. method:: set_layer_ui_config(number, action=0) * New in v1.18.3 Modify OC visibility status of content groups. This is analog to what supporting PDF viewers would offer. Please note that visibility is **not** a property stored with the OCG. It is not even information necessarily present in the PDF document at all. Instead, the current visibility is **temporarily** set using the user interface of some supporting PDF consumer software. The same type of functionality is offered by this method. To make **permanent** changes, use :meth:`Document.set_layer`. :arg int,str number: either the sequence number of the item in list :meth:`Document.layer_configs` or the "text" of one of these items. :arg int action: `PDF_OC_ON` = set on (default), `PDF_OC_TOGGLE` = toggle on/off, `PDF_OC_OFF` = set off. .. method:: authenticate(password) Decrypts the document with the string *password*. If successful, document data can be accessed. For PDF documents, the "owner" and the "user" have different privileges, and hence different passwords may exist for these authorization levels. The method will automatically establish the appropriate (owner or user) access rights for the provided password. :arg str password: owner or user password. :rtype: int :returns: a positive value if successful, zero otherwise (the string does not match either password). If positive, the indicator :attr:`Document.is_encrypted` is set to ``False``. **Positive** return codes carry the following information detail: * 1 => authenticated, but the PDF has neither owner nor user passwords. * 2 => authenticated with the **user** password. * 4 => authenticated with the **owner** password. * 6 => authenticated and both passwords are equal -- probably a rare situation. .. note:: The document may be protected by an owner, but **not** by a user password. Detect this situation via `doc.authenticate("") == 2`. This allows opening and reading the document without authentication, but, depending on the :attr:`Document.permissions` value, other actions may be prohibited. PyMuPDF (like MuPDF) in this case **ignores those restrictions**. So, -- in contrast to any PDF viewers -- you can for example extract text and add or modify content, even if the respective permission flags `PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`, etc. are set off! It is your responsibility building a legally compliant application where applicable. .. method:: get_page_numbers(label, only_one=False) * New in v 1.18.6 PDF only: Return a list of page numbers that have the specified label -- note that labels may not be unique in a PDF. This implies a sequential search through **all page numbers** to compare their labels. .. note:: Implementation detail -- pages are **not loaded** for this purpose. :arg str label: the label to look for, e.g. "vii" (Roman number 7). :arg bool only_one: stop after first hit. Useful e.g. if labelling is known to be unique, or there are many pages, etc. The default will check every page number. :rtype: list :returns: list of page numbers that have this label. Empty if none found, no labels defined, etc. .. method:: get_page_labels() * New in v1.18.7 PDF only: Extract the list of page label definitions. Typically used for modifications before feeding it into :meth:`Document.set_page_labels`. :returns: a list of dictionaries as defined in :meth:`Document.set_page_labels`. .. method:: set_page_labels(labels) * New in v1.18.6 PDF only: Add or update the page label definitions of the PDF. :arg list labels: a list of dictionaries. Each dictionary defines a label building rule and a 0-based "start" page number. That start page is the first for which the label definition is valid. Each dictionary has up to 4 items and looks like `{'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}` and has the following items. - `startpage`: (int) the first page number (0-based) to apply the label rule. This key **must be present**. The rule is applied to all subsequent pages until either end of document or superseded by the rule with the next larger page number. - `prefix`: (str) an arbitrary string to start the label with, e.g. "A-". Default is "". - `style`: (str) the numbering style. Available are "D" (decimal), "r"/"R" (Roman numbers, lower / upper case), and "a"/"A" (lower / upper case alphabetical numbering: "a" through "z", then "aa" through "zz", etc.). Default is "". If "", no numbering will take place and the pages in that range will receive the same label consisting of the `prefix` value. If prefix is also omitted, then the label will be "". - `firstpagenum`: (int) start numbering with this value. Default is 1, smaller values are ignored. For example:: [{'startpage': 6, 'prefix': 'A-', 'style': 'D', 'firstpagenum': 10}, {'startpage': 10, 'prefix': '', 'style': 'D', 'firstpagenum': 1}] will generate the labels "A-10", "A-11", "A-12", "A-13", "1", "2", "3", ... for pages 6, 7 and so on until end of document. Pages 0 through 5 will have the label "". .. method:: make_bookmark(loc) * New in v.1.17.3 Return a page pointer in a reflowable document. After re-layouting the document, the result of this method can be used to find the new location of the page. .. note:: Do not confuse with items of a table of contents, TOC. :arg list,tuple loc: page location. Must be a valid *(chapter, pno)*. :rtype: pointer :returns: a long integer in pointer format. To be used for finding the new location of the page after re-layouting the document. Do not touch or re-assign. .. method:: find_bookmark(bookmark) * New in v.1.17.3 Return the new page location after re-layouting the document. :arg pointer bookmark: created by :meth:`Document.make_bookmark`. :rtype: tuple :returns: the new (chapter, pno) of the page. .. method:: chapter_page_count(chapter) * New in v.1.17.0 Return the number of pages of a chapter. :arg int chapter: the 0-based chapter number. :rtype: int :returns: number of pages in chapter. Relevant only for document types with chapter support (EPUB currently). .. method:: next_location(page_id) * New in v.1.17.0 Return the location of the following page. :arg tuple page_id: the current page id. This must be a tuple *(chapter, pno)* identifying an existing page. :returns: The tuple of the following page, i.e. either *(chapter, pno + 1)* or *(chapter + 1, 0)*, **or** the empty tuple *()* if the argument was the last page. Relevant only for document types with chapter support (EPUB currently). .. method:: prev_location(page_id) * New in v.1.17.0 Return the locator of the preceding page. :arg tuple page_id: the current page id. This must be a tuple *(chapter, pno)* identifying an existing page. :returns: The tuple of the preceding page, i.e. either *(chapter, pno - 1)* or the last page of the preceding chapter, **or** the empty tuple *()* if the argument was the first page. Relevant only for document types with chapter support (EPUB currently). .. method:: load_page(page_id=0) * Changed in v1.17.0: For document types supporting a so-called "chapter structure" (like EPUB), pages can also be loaded via the combination of chapter number and relative page number, instead of the absolute page number. This should **significantly speed up access** for large documents. Create a :ref:`Page` object for further processing (like rendering, text searching, etc.). :arg int,tuple page_id: *(Changed in v1.17.0)* Either a 0-based page number, or a tuple *(chapter, pno)*. For an **integer**, any `-∞ < page_id < page_count` is acceptable. While page_id is negative, :attr:`page_count` will be added to it. For example: to load the last page, you can use *doc.load_page(-1)*. After this you have page.number = doc.page_count - 1. For a tuple, *chapter* must be in range :attr:`Document.chapter_count`, and *pno* must be in range :meth:`Document.chapter_page_count` of that chapter. Both values are 0-based. Using this notation, :attr:`Page.number` will equal the given tuple. Relevant only for document types with chapter support (EPUB currently). :rtype: :ref:`Page` .. note:: Documents also follow the Python sequence protocol with page numbers as indices: *doc.load_page(n) == doc[n]*. For **absolute page numbers** only, expressions like *"for page in doc: ..."* and *"for page in reversed(doc): ..."* will successively yield the document's pages. Refer to :meth:`Document.pages` which allows processing pages as with slicing. You can also use index notation with the new chapter-based page identification: use *page = doc[(5, 2)]* to load the third page of the sixth chapter. To maintain a consistent API, for document types not supporting a chapter structure (like PDFs), :attr:`Document.chapter_count` is 1, and pages can also be loaded via tuples *(0, pno)*. See this [#f3]_ footnote for comments on performance improvements. .. method:: rewrite_images(dpi_threshold=None, dpi_target=0, quality=0, lossy=True, lossless=True, bitonal=True, color=True, gray=True, set_to_gray=False, options=None) PDF only: Walk through all images and rewrite them according to the specified parameters. This is useful for reducing file size, changing image formats, or converting color spaces. The typical usage is extra compression of images for significantly reducing the file size of the PDF. When setting quality and the dpi parameters to positive values and accepting defaults for the rest, the following will happen: * Lossy and lossless images will be rewritten as JPEG images (FZ_RECOMPRESS_JPEG) as far as technically possible. * Bitonal (monochrome) images will be rewritten in FAX format (FZ_RECOMPRESS_FAX). * Subsampling method is **FZ_SUBSAMPLE_AVERAGE** (see below). :arg int dpi_target: target DPI value for the resampled images. Ignored if `dpi_threshold` is `None`, otherwise must be less than `dpi_threshold` and positive. :arg int dpi_threshold: If None (the default) no resampling takes place. Otherwise images with a DPI value larger than this will be resampled to `dpi_target` (which must be less than `dpi_threshold`). :arg int quality: desired target JPEG quality, a value between 0 and 100. 0 means no quality change, 100 means best quality. :arg bool lossy: include lossy image types (e.g. JPEG). :arg bool lossless: include lossless image types (e.g. PNG). :arg bool bitonal: include black-and-white images (e.g. FAX). :arg bool color: include colored images. :arg bool gray: include grayscale images. :arg bool set_to_gray: if True, the PDF will be converted to grayscale by executing :meth:`Document.recolor` before all image processing. Please note that this will also change text and vector graphics to grayscale -- not just the images. :arg dict options: This parameter is intended for expert users. Except ``set_to_gray``, all other parameters are ignored. It must be an object prepared in the following way: ``options = pymupdf.mupdf.PdfImageRewriterOptions()``. Then attributes of this object can be set to achieve fine-grained control. Following are the adjustable attributes of the ``options`` object and their default (do nothing) values. :: options.bitonal_image_recompress_method = FZ_RECOMPRESS_NEVER options.bitonal_image_recompress_quality = None options.bitonal_image_subsample_method = FZ_SUBSAMPLE_AVERAGE options.bitonal_image_subsample_threshold = 0 options.bitonal_image_subsample_to = 0 options.color_lossless_image_recompress_method = FZ_RECOMPRESS_NEVER options.color_lossless_image_recompress_quality = None options.color_lossless_image_subsample_method = FZ_SUBSAMPLE_AVERAGE options.color_lossless_image_subsample_threshold = 0 options.color_lossless_image_subsample_to = 0 options.color_lossy_image_recompress_method = FZ_RECOMPRESS_NEVER options.color_lossy_image_recompress_quality = None options.color_lossy_image_subsample_method = FZ_SUBSAMPLE_AVERAGE options.color_lossy_image_subsample_threshold = 0 options.color_lossy_image_subsample_to = 0 options.gray_lossless_image_recompress_method = FZ_RECOMPRESS_NEVER options.gray_lossless_image_recompress_quality = None options.gray_lossless_image_subsample_method = FZ_SUBSAMPLE_AVERAGE options.gray_lossless_image_subsample_threshold = 0 options.gray_lossless_image_subsample_to = 0 options.gray_lossy_image_recompress_method = FZ_RECOMPRESS_NEVER options.gray_lossy_image_recompress_quality = None options.gray_lossy_image_subsample_method = FZ_SUBSAMPLE_AVERAGE options.gray_lossy_image_subsample_threshold = 0 options.gray_lossy_image_subsample_to = 0 The ``*_recompress_method`` attributes may be one of the values **FZ_RECOMPRESS_NEVER (0), FZ_RECOMPRESS_SAME (1), FZ_RECOMPRESS_LOSSLESS (2), FZ_RECOMPRESS_JPEG (3), FZ_RECOMPRESS_J2K (4), FZ_RECOMPRESS_FAX (5)**. Value FZ_RECOMPRESS_NEVER will skip this image type altogether and FZ_RECOMPRESS_SAME will not change the type. The other values will execute type conversions (as far as technically possible). The ``*_quality`` values are strings of integers from "0" to "100" or ``None``. The ``*_subsample_method`` attributes are either **FZ_SUBSAMPLE_AVERAGE (0)** or **FZ_SUBSAMPLE_BICUBIC (1)** and refer to how a pixel value is derived from its neighboring pixels during subsampling. For some background see `this Wikipedia article about bicubic interpolation `_. Attributes ``*_subsample_threshold`` excludes images from subsampling which have a lower DPI. Participating images will be subsampled to the DPI values given by the ``*_subsample_to`` values. Values of 0 mean that no subsampling will take place. The ``*_subsample_threshold`` values should be chosen notably larger than the ``*_subsample_to`` values to ensure that there are enough size savings. After all, every subsampling inevitably incurs quality losses. An example for a good choice is ``threshold=100`` and ``to=72``. .. method:: recolor(components=1) PDF only: Change the color component counts for all object types text, images and vector graphics for all pages. :arg int components: desired color space indicated by the number of color components: 1 = DeviceGRAY, 3 = DeviceRGB, 4 = DeviceCMYK. The typical use case is 1 (DeviceGRAY) which converts the PDF to grayscale. .. method:: reload_page(page) * New in v1.16.10 PDF only: Provide a new copy of a page after finishing and updating all pending changes. :arg page: page object. :type page: :ref:`Page` :rtype: :ref:`Page` :returns: a new copy of the same page. All pending updates (e.g. to annotations or widgets) will be finalized and a fresh copy of the page will be loaded. .. note:: In a typical use case, a page :ref:`Pixmap` should be taken after annotations / widgets have been added or changed. To force all those changes being reflected in the page structure, this method re-instates a fresh copy while keeping the object hierarchy "document -> page -> annotations/widgets" intact. .. method:: resolve_names() PDF only: Convert destination names into a Python dict. :returns: A dictionary with the following layout: * *key*: (str) the name. * *value*: (dict) with the following layout: * "page": target page number (0-based). If no page number found -1. * "to": (x, y) target point on page. Currently in PDF coordinates, i.e. point (0,0) is the bottom-left of the page. * "zoom": (float) the zoom factor. * "dest": (str) only present if the target location on the page has not been provided as "/XYZ" or if no page number was found. Examples:: { '__bookmark_1': {'page': 0, 'to': (0.0, 541.0), 'zoom': 0.0}, '__bookmark_2': {'page': 0, 'to': (0.0, 481.45), 'zoom': 0.0}, } or:: { '21154a7c20684ceb91f9c9adc3b677c40': {'page': -1, 'dest': '/XYZ 15.75 1486 0'}, ... } All names found in the catalog under keys "/Dests" and "/Names/Dests" are included. * New in v1.23.6 .. method:: page_cropbox(pno) * New in v1.17.7 PDF only: Return the unrotated page rectangle -- **without loading the page** (via :meth:`Document.load_page`). This is meant for internal purpose requiring best possible performance. :arg int pno: 0-based page number. :returns: :ref:`Rect` of the page like :meth:`Page.rect`, but ignoring any rotation. .. method:: page_xref(pno) * New in v1.17.7 PDF only: Return the :data:`xref` of the page -- **without loading the page** (via :meth:`Document.load_page`). This is meant for internal purpose requiring best possible performance. :arg int pno: 0-based page number. :returns: :data:`xref` of the page like :attr:`Page.xref`. .. method:: pages(start=None, [stop=None, [step=None]]) * New in v1.16.4 A generator for a range of pages. Parameters have the same meaning as in the built-in function *range()*. Intended for expressions of the form *"for page in doc.pages(start, stop, step): ..."*. :arg int start: start iteration with this page number. Default is zero, allowed values are `-∞ < start < page_count`. While this is negative, :attr:`page_count` is added **before** starting the iteration. :arg int stop: stop iteration at this page number. Default is :attr:`page_count`, possible are `-∞ < stop <= page_count`. Larger values are **silently replaced** by the default. Negative values will cyclically emit the pages in reversed order. As with the built-in *range()*, this is the first page **not** returned. :arg int step: stepping value. Defaults are 1 if start < stop and -1 if start > stop. Zero is not allowed. :returns: a generator iterator over the document's pages. Some examples: * "doc.pages()" emits all pages. * "doc.pages(4, 9, 2)" emits pages 4, 6, 8. * "doc.pages(0, None, 2)" emits all pages with even numbers. * "doc.pages(-2)" emits the last two pages. * "doc.pages(-1, -1)" emits all pages in reversed order. * "doc.pages(-1, -10)" always emits 10 pages in reversed order, starting with the last page -- **repeatedly** if the document has less than 10 pages. So for a 4-page document the following page numbers are emitted: 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, 3. .. index:: pair: from_page; Document.convert_to_pdf pair: to_page; Document.convert_to_pdf pair: rotate; Document.convert_to_pdf .. method:: convert_to_pdf(from_page=-1, to_page=-1, rotate=0) Create a PDF version of the current document and write it to memory. **All document types** are supported. The parameters have the same meaning as in :meth:`insert_pdf`. In essence, you can restrict the conversion to a page subset, specify page rotation, and revert page sequence. :arg int from_page: first page to copy (0-based). Default is first page. :arg int to_page: last page to copy (0-based). Default is last page. :arg int rotate: rotation angle. Default is 0 (no rotation). Should be *n * 90* with an integer n (not checked). :rtype: bytes :returns: a Python *bytes* object containing a PDF file image. It is created by internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`. You can output it directly to disk or open it as a PDF. Here are some examples:: >>> # convert an XPS file to PDF >>> xps = pymupdf.open("some.xps") >>> pdfbytes = xps.convert_to_pdf() >>> >>> # either do this --> >>> pdf = pymupdf.open("pdf", pdfbytes) >>> pdf.save("some.pdf") >>> >>> # or this --> >>> pdfout = open("some.pdf", "wb") >>> pdfout.tobytes(pdfbytes) >>> pdfout.close() >>> # copy image files to PDF pages >>> # each page will have image dimensions >>> doc = pymupdf.open() # new PDF >>> imglist = [ ... image file names ...] # e.g. a directory listing >>> for img in imglist: imgdoc=pymupdf.open(img) # open image as a document pdfbytes=imgdoc.convert_to_pdf() # make a 1-page PDF of it imgpdf=pymupdf.open("pdf", pdfbytes) doc.insert_pdf(imgpdf) # insert the image PDF >>> doc.save("allmyimages.pdf") .. note:: The method uses the same logic as the *mutool convert* CLI. This works very well in most cases -- however, beware of the following limitations. * Image files: perfect, no issues detected. However, image transparency is ignored. If you need that (like for a watermark), use :meth:`Page.insert_image` instead. Otherwise, this method is recommended for its much better performance. * XPS: appearance very good. Links work fine, outlines (bookmarks) are lost, but can easily be recovered [#f2]_. * EPUB, CBZ, FB2: similar to XPS. * SVG: medium. Roughly comparable to `svglib `_. .. method:: get_toc(simple=True) Creates a table of contents (TOC) out of the document's outline chain. :arg bool simple: Indicates whether a simple or a detailed TOC is required. If ``False``, each item of the list also contains a dictionary with :ref:`linkDest` details for each outline entry. :rtype: list :returns: a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its entries have the following meanings: * *lvl* -- hierarchy level (positive *int*). The first entry is always 1. Entries in a row are either **equal**, **increase** by 1, or **decrease** by any number. * *title* -- title (*str*) * *page* -- 1-based source page number (*int*). `-1` if no destination or outside document. * *dest* -- (*dict*) included only if *simple=False*. Contains details of the TOC item as follows: - kind: destination kind, see :ref:`linkDest Kinds`. - file: filename if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`. - page: target page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only. - to: position on target page (:ref:`Point`). - zoom: (float) zoom factor on target page. - xref: :data:`xref` of the item (0 if no PDF). - color: item color in PDF RGB format `(red, green, blue)`, or omitted (always omitted if no PDF). - bold: true if bold item text or omitted. PDF only. - italic: true if italic item text, or omitted. PDF only. - collapse: true if sub-items are folded, or omitted. PDF only. - nameddest: target name if kind=4. PDF only. (New in 1.23.7.) .. method:: xref_get_keys(xref) * New in v1.18.7 PDF only: Return the PDF dictionary keys of the :data:`dictionary` object provided by its xref number. :arg int xref: the :data:`xref`. *(Changed in v1.18.10)* Use `-1` to access the special dictionary "PDF trailer". :returns: a tuple of dictionary keys present in object :data:`xref`. Examples: >>> from pprint import pprint >>> import pymupdf >>> doc=pymupdf.open("pymupdf.pdf") >>> xref = doc.page_xref(0) # xref of page 0 >>> pprint(doc.xref_get_keys(xref)) # primary level keys of a page ('Type', 'Contents', 'Resources', 'MediaBox', 'Parent') >>> pprint(doc.xref_get_keys(-1)) # primary level keys of the trailer ('Type', 'Index', 'Size', 'W', 'Root', 'Info', 'ID', 'Length', 'Filter') >>> .. method:: xref_get_key(xref, key) * New in v1.18.7 PDF only: Return type and value of a PDF dictionary key of a :data:`dictionary` object given by its xref. :arg int xref: the :data:`xref`. *Changed in v1.18.10:* Use `-1` to access the special dictionary "PDF trailer". :arg str key: the desired PDF key. Must **exactly** match (case-sensitive) one of the keys contained in :meth:`Document.xref_get_keys`. :rtype: tuple :returns: A tuple (type, value) of strings, where type is one of "xref", "array", "dict", "int", "float", "null", "bool", "name", "string" or "unknown" (should not occur). Independent of "type", the value of the key is **always** formatted as a string -- see the following example -- and (almost always) a faithful reflection of what is stored in the PDF. In most cases, the format of the value string also gives a clue about the key type: * A "name" always starts with a "/" slash. * An "xref" always ends with " 0 R". * An "array" is always enclosed in "[...]" brackets. * A "dict" is always enclosed in "<<...>>" brackets. * A "bool", resp. "null" always equal either "true", "false", resp. "null". * "float" and "int" are represented by their string format -- and are thus not always distinguishable. * A "string" is converted to UTF-8 and may therefore deviate from what is stored in the PDF. For example, the PDF key "Author" may have a value of "" in the file, but the method will return `('string', 'Jorj X. McKie')`. >>> for key in doc.xref_get_keys(xref): print(key, "=" , doc.xref_get_key(xref, key)) Type = ('name', '/Page') Contents = ('xref', '1297 0 R') Resources = ('xref', '1296 0 R') MediaBox = ('array', '[0 0 612 792]') Parent = ('xref', '1301 0 R') >>> # >>> # Now same thing for the PDF trailer. >>> # It has no xref, so -1 must be used instead. >>> # >>> for key in doc.xref_get_keys(-1): print(key, "=", doc.xref_get_key(-1, key)) Type = ('name', '/XRef') Index = ('array', '[0 8802]') Size = ('int', '8802') W = ('array', '[1 3 1]') Root = ('xref', '8799 0 R') Info = ('xref', '8800 0 R') ID = ('array', '[]') Length = ('int', '21111') Filter = ('name', '/FlateDecode') >>> .. method:: xref_set_key(xref, key, value) * New in v1.18.7, changed in v 1.18.13 * Changed in v1.19.4: remove a key "physically" if set to "null". PDF only: Set (add, update, delete) the value of a PDF key for the :data:`dictionary` object given by its xref. .. caution:: This is an expert function: if you do not know what you are doing, there is a high risk to render (parts of) the PDF unusable. Please do consult :ref:`AdobeManual` about object specification formats (page 18) and the structure of special dictionary types like page objects. :arg int xref: the :data:`xref`. *Changed in v1.18.13:* To update the PDF trailer, specify -1. :arg str key: the desired PDF key (without leading "/"). Must not be empty. Any valid PDF key -- whether already present in the object (which will be overwritten) -- or new. It is possible to use PDF path notation like `"Resources/ExtGState"` -- which sets the value for key `"/ExtGState"` as a sub-object of `"/Resources"`. :arg str value: the value for the key. It must be a non-empty string and, depending on the desired PDF object type, the following rules must be observed. There is some syntax checking, but **no type checking** and no checking if it makes sense PDF-wise, i.e. **no semantics checking**. Upper / lower case is important! * *:data:`xref`* -- must be provided as `"nnn 0 R"` with a valid :data:`xref` number nnn of the PDF. The suffix "`0 R`" is required to be recognizable as an xref by PDF applications. * **array** -- a string like `"[a b c d e f]"`. The brackets are required. Array items must be separated by at least one space (not commas like in Python). An empty array `"[]"` is possible and *equivalent* to removing the key. Array items may be any PDF objects, like dictionaries, xrefs, other arrays, etc. Like in Python, array items may be of different types. * **dict** -- a string like `"<< ... >>"`. The brackets are required and must enclose a valid PDF dictionary definition. The empty dictionary `"<<>>"` is possible and *equivalent* to removing the key. * **int** -- an integer formatted **as a string**. * **float** -- a float formatted **as a string**. Scientific notation (with exponents) is **not allowed by PDF**. * **null** -- the string `"null"`. This is the PDF equivalent to Python's `None` and causes the key to be ignored -- however not necessarily removed, resp. removed on saves with garbage collection. *Changed in v1.19.4:* If the key is no path hierarchy (i.e. contains no slash "/"), then it will be completely removed. * **bool** -- one of the strings `"true"` or `"false"`. * **name** -- a valid PDF name with a leading slash like this: `"/PageLayout"`. See page 16 of the :ref:`AdobeManual`. * **string** -- a valid PDF string. **All PDF strings must be enclosed by brackets**. Denote the empty string as `"()"`. Depending on its content, the possible brackets are - "(...)" for ASCII-only text. Reserved PDF characters must be backslash-escaped and non-ASCII characters must be provided as 3-digit backslash-escaped octals -- including leading zeros. Example: 12 = 0x0C must be encoded as `\014`. - "<...>" for hex-encoded text. Every character must be represented by two hex-digits (lower or upper case). - If in doubt, we **strongly recommend** to use :meth:`get_pdf_str`! This function automatically generates the right brackets, escapes, and overall format. It will for example do conversions like these: >>> # because of the € symbol, the following yields UTF-16BE BOM >>> pymupdf.get_pdf_str("Pay in $ or €.") '' >>> # escapes for brackets and non-ASCII >>> pymupdf.get_pdf_str("Prices in EUR (USD also accepted). Areas are in m².") '(Prices in EUR \\(USD also accepted\\). Areas are in m\\262.)' .. method:: get_page_pixmap(pno: int, *, matrix: matrix_like = Identity, dpi=None, colorspace: Colorspace = csRGB, clip: rect_like = None, alpha: bool = False, annots: bool = True) Creates a pixmap from page *pno* (zero-based). Invokes :meth:`Page.get_pixmap`. All parameters except `pno` are *keyword-only.* :arg int pno: page number, 0-based in `-∞ < pno < page_count`. :rtype: :ref:`Pixmap` .. method:: get_page_xobjects(pno) * New in v1.16.13 * Changed in v1.18.11 PDF only: Return a list of all XObjects referenced by a page. :arg int pno: page number, 0-based, `-∞ < pno < page_count`. :rtype: list :returns: a list of (non-image) XObjects. These objects typically represent pages *embedded* (not copied) from other PDFs. For example, :meth:`Page.show_pdf_page` will create this type of object. An item of this list has the following layout: `(xref, name, invoker, bbox)`, where * *:data:`xref`* (*int*) is the XObject's :data:`xref`. * **name** (*str*) is the symbolic name to reference the XObject. * **invoker** (*int*) the :data:`xref` of the invoking XObject or zero if the page directly invokes it. * **bbox** (:ref:`Rect`) the boundary box of the XObject's location on the page **in untransformed coordinates**. To get actual, non-rotated page coordinates, multiply with the page's transformation matrix :attr:`Page.transformation_matrix`. *Changed in v.18.11:* the bbox is now formatted as :ref:`Rect`. .. method:: get_page_images(pno, full=False) PDF only: Return a list of all images (directly or indirectly) referenced by the page. :arg int pno: page number, 0-based, `-∞ < pno < page_count`. :arg bool full: whether to also include the referencer's :data:`xref` (which is zero if this is the page). :rtype: list :returns: a list of images **referenced** by this page. Each item looks like: `(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, filter, referencer)` * ``xref`` (*int*) is the image object number * ``smask`` (*int*) is the object number of its soft-mask image * ``width`` (*int*) is the image width * ``height`` (*int*) is the image height * ``bpc`` (*int*) denotes the number of bits per component (normally 8) * ``colorspace`` (*str*) a string naming the colorspace (like **DeviceRGB**) * ``alt_colorspace`` (*str*) is any alternate colorspace depending on the value of **colorspace** * ``name`` (*str*) is the symbolic name by which the image is referenced * ``filter`` (*str*) is the decode filter of the image (:ref:`AdobeManual`, pp. 22). * ``referencer`` (*int*) the :data:`xref` of the referencer. Zero if directly referenced by the page. Only present if *full=True*. .. note:: In general, this is not the list of images that are **actually displayed**. This method only parses several PDF objects to collect references to embedded images. It does not analyse the page's :data:`contents`, where all the actual image display commands are defined. To get this information, please use :meth:`Page.get_image_info`. Also have a look at the discussion in section :ref:`textpagedict`. .. method:: get_page_fonts(pno, full=False) PDF only: Return a list of all fonts (directly or indirectly) referenced by the page object definition. :arg int pno: page number, 0-based, `-∞ < pno < page_count`. :arg bool full: whether to also include the referencer's :data:`xref`. If ``True``, the returned items are one entry longer. Use this option if you need to know, whether the page directly references the font. In this case the last entry is 0. If the font is referenced by an `/XObject` of the page, you will find its :data:`xref` here. :rtype: list :returns: a list of fonts referenced by the object definition of the page. Each entry looks like: `(xref, ext, type, basefont, name, encoding, referencer)` * ``xref`` (*int*) is the font object number (may be zero if the PDF uses one of the builtin fonts directly) * ``ext`` (*str*) font file extension (e.g. "ttf", see :ref:`FontExtensions`) * ``type`` (*str*) is the font type (like "Type1" or "TrueType" etc.) * ``basefont`` (*str*) is the base font name, * ``name`` (*str*) is the symbolic name, by which the font is referenced * ``encoding`` (*str*) the font's character encoding if different from its built-in encoding (:ref:`AdobeManual`, p. 254): * ``referencer`` (*int* optional) the :data:`xref` of the referencer. Zero if directly referenced by the page, otherwise the xref of an XObject. Only present if *full=True*. Example:: >>> pprint(doc.get_page_fonts(0, full=False)) [(12, 'ttf', 'TrueType', 'FNUUTH+Calibri-Bold', 'R8', ''), (13, 'ttf', 'TrueType', 'DOKBTG+Calibri', 'R10', ''), (14, 'ttf', 'TrueType', 'NOHSJV+Calibri-Light', 'R12', ''), (15, 'ttf', 'TrueType', 'NZNDCL+CourierNewPSMT', 'R14', ''), (16, 'ttf', 'Type0', 'MNCSJY+SymbolMT', 'R17', 'Identity-H'), (17, 'cff', 'Type1', 'UAEUYH+Helvetica', 'R20', 'WinAnsiEncoding'), (18, 'ttf', 'Type0', 'ECPLRU+Calibri', 'R23', 'Identity-H'), (19, 'ttf', 'Type0', 'TONAYT+CourierNewPSMT', 'R27', 'Identity-H')] .. note:: * This list has no duplicate entries: the combination of :data:`xref`, *name* and *referencer* is unique. * In general, this is a true superset of the fonts actually in use by this page. The PDF creator may e.g. have specified some global list, of which each page make only partial use. * Be aware that font names returned by some variants of :meth:`Page.get_text` (respectively :ref:`TextPage` methods) need not (exactly) equal the base font name shown here. Reasons for any differences include: - This method always shows any subset prefixes (the pattern ``ABCDEF+``), whereas text extractions do not do this by default. - Text extractions use the base library to access the font name, which has a length cap of 31 bytes and generally interrogates the font file binary to access the name. Method ``get_page_fonts()`` however looks at the PDF definition source. - Text extractions work for all supported document types in exactly the same way -- not just for PDFs. Consequently they do not contain PDF-specifics. .. method:: get_page_text(pno, output="text", flags=3, textpage=None, sort=False) Extracts the text of a page given its page number *pno* (zero-based). Invokes :meth:`Page.get_text`. :arg int pno: page number, 0-based, any value `-∞ < pno < page_count`. For other parameter refer to the page method. :rtype: str .. index:: pair: fontsize; Document.layout pair: rect; Document.layout pair: width; Document.layout pair: height; Document.layout .. method:: layout(rect=None, width=0, height=0, fontsize=11) Re-paginate ("reflow") the document based on the given page dimension and fontsize. This only affects some document types like e-books and HTML. Ignored if not supported. Supported documents have ``True`` in property :attr:`is_reflowable`. :arg rect_like rect: desired page size. Must be finite, not empty and start at point (0, 0). :arg float width: use it together with ``height`` as alternative to ``rect``. :arg float height: use it together with ``width`` as alternative to ``rect``. :arg float fontsize: the desired default fontsize. .. method:: select(s) PDF only: Keeps only those pages of the document whose numbers occur in the list. Empty sequences or elements outside `range(doc.page_count)` will cause a *ValueError*. For more details see remarks at the bottom or this chapter. :arg sequence s: The sequence (see :ref:`SequenceTypes`) of page numbers (zero-based) to be included. Pages not in the sequence will be deleted (from memory) and become unavailable until the document is reopened. **Page numbers can occur multiple times and in any order:** the resulting document will reflect the sequence exactly as specified. .. note:: * Page numbers in the sequence need not be unique nor be in any particular order. This makes the method a versatile utility to e.g. select only the even or the odd pages or meeting some other criteria and so forth. * On a technical level, the method will always create a new :data:`pagetree`. * When dealing with only a few pages, methods :meth:`copy_page`, :meth:`move_page`, :meth:`delete_page` are easier to use. In fact, they are also **much faster** -- by at least one order of magnitude when the document has many pages. .. method:: set_metadata(m) PDF only: Sets or updates the metadata of the document as specified in *m*, a Python dictionary. :arg dict m: A dictionary with the same keys as *metadata* (see below). All keys are optional. A PDF's format and encryption method cannot be set or changed and will be ignored. If any value should not contain data, do not specify its key or set the value to `None`. If you use *{}* all metadata information will be cleared to the string *"none"*. If you want to selectively change only some values, modify a copy of *doc.metadata* and use it as the argument. Arbitrary unicode values are possible if specified as UTF-8-encoded. *(Changed in v1.18.4)* Empty values or "none" are no longer written, but completely omitted. .. method:: get_xml_metadata() PDF only: Get the document XML metadata. :rtype: str :returns: XML metadata of the document. Empty string if not present or not a PDF. .. method:: set_xml_metadata(xml) PDF only: Sets or updates XML metadata of the document. :arg str xml: the new XML metadata. Should be XML syntax, however no checking is done by this method and any string is accepted. .. method:: set_pagelayout(value) * New in v1.22.2 PDF only: Set the `/PageLayout`. :arg str value: one of the strings "SinglePage", "OneColumn", "TwoColumnLeft", "TwoColumnRight", "TwoPageLeft", "TwoPageRight". Lower case is supported. .. method:: set_pagemode(value) * New in v1.22.2 PDF only: Set the `/PageMode`. :arg str value: one of the strings "UseNone", "UseOutlines", "UseThumbs", "FullScreen", "UseOC", "UseAttachments". Lower case is supported. .. method:: set_markinfo(value) * New in v1.22.2 PDF only: Set the `/MarkInfo` values. :arg dict value: a dictionary like this one: `{"Marked": False, "UserProperties": False, "Suspects": False}`. This dictionary contains information about the usage of Tagged PDF conventions. For details please see the `PDF specifications `_. .. method:: set_toc(toc, collapse=1) PDF only: Replaces the **complete current outline** tree (table of contents) with the one provided as the argument. After successful execution, the new outline tree can be accessed as usual via :meth:`Document.get_toc` or via :attr:`Document.outline`. Like with other output-oriented methods, changes become permanent only via :meth:`save` (incremental save supported). Internally, this method consists of the following two steps. For a demonstration see example below. - Step 1 deletes all existing bookmarks. - Step 2 creates a new TOC from the entries contained in *toc*. :arg sequence toc: A list / tuple with **all bookmark entries** that should form the new table of contents. Output variants of :meth:`get_toc` are acceptable. To completely remove the table of contents specify an empty sequence or None. Each item must be a list with the following format. * [lvl, title, page [, dest]] where - **lvl** is the hierarchy level (int > 0) of the item, which **must be 1** for the first item and at most 1 larger than the previous one. - **title** (str) is the title to be displayed. It is assumed to be UTF-8-encoded (relevant for multibyte code points only). - **page** (int) is the target page number **(attention: 1-based)**. Must be in valid range if positive. Set it to -1 if there is no target, or the target is external. - **dest** (optional) is a dictionary or a number. If a number, it will be interpreted as the desired height (in points) this entry should point to on the page. Use a dictionary (like the one given as output by `get_toc(False)`) for a detailed control of the bookmark's properties, see :meth:`Document.get_toc` for a description. :arg int collapse: *(new in v1.16.9)* controls the hierarchy level beyond which outline entries should initially show up collapsed. The default 1 will hence only display level 1, higher levels must be unfolded using the PDF viewer. To unfold everything, specify either a large integer, 0 or None. :rtype: int :returns: the number of inserted, resp. deleted items. Changed in v1.23.8: Destination 'to' coordinates should now be in the same coordinate system as those returned by `get_toc()` (internally they are now transformed with `page.cropbox` and `page.rotation_matrix`). So for example `set_toc(get_toc())` now gives unchanged destination 'to' coordinates. .. method:: outline_xref(idx) * New in v1.17.7 PDF only: Return the :data:`xref` of the outline item. This is mainly used for internal purposes. :arg int idx: index of the item in list :meth:`Document.get_toc`. :returns: :data:`xref`. .. method:: del_toc_item(idx) * New in v1.17.7 * Changed in v1.18.14: no longer remove the item's text, but show it grayed-out. PDF only: Remove this TOC item. This is a high-speed method, which **disables** the respective item, but leaves the overall TOC structure intact. Physically, the item still exists in the TOC tree, but is shown grayed-out and will no longer point to any destination. This also implies that you can reassign the item to a new destination using :meth:`Document.set_toc_item`, when required. :arg int idx: the index of the item in list :meth:`Document.get_toc`. .. method:: set_toc_item(idx, dest_dict=None, kind=None, pno=None, uri=None, title=None, to=None, filename=None, zoom=0) * New in v1.17.7 * Changed in v1.18.6 PDF only: Changes the TOC item identified by its index. Change the item **title**, **destination**, **appearance** (color, bold, italic) or collapsing sub-items -- or to remove the item altogether. Use this method if you need specific changes for selected entries only and want to avoid replacing the complete TOC. This is beneficial especially when dealing with large table of contents. :arg int idx: the index of the entry in the list created by :meth:`Document.get_toc`. :arg dict dest_dict: the new destination. A dictionary like the last entry of an item in `doc.get_toc(False)`. Using this as a template is recommended. When given, **all other parameters are ignored** -- except title. :arg int kind: the link kind, see :ref:`linkDest Kinds`. If :data:`LINK_NONE`, then all remaining parameter will be ignored, and the TOC item will be removed -- same as :meth:`Document.del_toc_item`. If None, then only the title is modified and the remaining parameters are ignored. All other values will lead to making a new destination dictionary using the subsequent arguments. :arg int pno: the 1-based page number, i.e. a value 1 <= pno <= doc.page_count. Required for LINK_GOTO. :arg str uri: the URL text. Required for LINK_URI. :arg str title: the desired new title. None if no change. :arg point_like to: (optional) points to a coordinate on the target page. Relevant for LINK_GOTO. If omitted, a point near the page's top is chosen. :arg str filename: required for LINK_GOTOR and LINK_LAUNCH. :arg float zoom: use this zoom factor when showing the target page. **Example use:** Change the TOC of the SWIG manual to achieve this: Collapse everything below top level and show the chapter on Python support in red, bold and italic:: >>> import pymupdf >>> doc=pymupdf.open("SWIGDocumentation.pdf") >>> toc = doc.get_toc(False) # we need the detailed TOC >>> # list of level 1 indices and their titles >>> lvl1 = [(i, item[1]) for i, item in enumerate(toc) if item[0] == 1] >>> for i, title in lvl1: d = toc[i][3] # get the destination dict d["collapse"] = True # collapse items underneath if "Python" in title: # show the 'Python' chapter d["color"] = (1, 0, 0) # in red, d["bold"] = True # bold and d["italic"] = True # italic doc.set_toc_item(i, dest_dict=d) # update this toc item >>> doc.save("NEWSWIG.pdf",garbage=3,deflate=True) In the previous example, we have changed only 42 of the 1240 TOC items of the file. .. method:: bake(*, annots=True, widgets=True) PDF only: Convert annotations and / or widgets to become permanent parts of the pages. The PDF **will be changed** by this method. If `widgets` is `True`, the document will also no longer be a "Form PDF". All pages will look the same, but will no longer have annotations, respectively fields. The visible parts will be converted to standard text, vector graphics or images as required. The method may thus be a viable **alternative for PDF-to-PDF conversions** using :meth:`Document.convert_to_pdf`. Please consider that annotations are complex objects and may consist of more data "underneath" their visual appearance. Examples are "Text" and "FileAttachment" annotations. When "baking in" annotations / widgets with this method, all this underlying information (attached files, comments, associated PopUp annotations, etc.) will be lost and be removed on next garbage collection. Use this feature for instance for :meth:`Page.show_pdf_page` (which supports neither annotations nor widgets) when the source pages should look exactly the same in the target. :arg bool annots: convert annotations. :arg bool widgets: convert fields / widgets. After execution, the document will no longer be a "Form PDF". .. method:: can_save_incrementally() * New in v1.16.0 Check whether the document can be saved incrementally. Use it to choose the right option without encountering exceptions. .. method:: repair() Repair document. * Slow for large documents. * Does nothing on non-PDF documents. * New in v1.27.0 .. method:: scrub(attached_files=True, clean_pages=True, embedded_files=True, hidden_text=True, javascript=True, metadata=True, redactions=True, redact_images=0, remove_links=True, reset_fields=True, reset_responses=True, thumbnails=True, xml_metadata=True) * New in v1.16.14 PDF only: Remove potentially sensitive data from the PDF. This function is inspired by the similar "Sanitize" function in Adobe Acrobat products. The process is configurable by a number of options. :arg bool attached_files: Search for 'FileAttachment' annotations and remove the file content. :arg bool clean_pages: Remove any comments from page painting sources. If this option is set to ``False``, then this is also done for *hidden_text* and *redactions*. :arg bool embedded_files: Remove embedded files. :arg bool hidden_text: Remove OCRed text and invisible text [#f7]_. :arg bool javascript: Remove JavaScript sources. :arg bool metadata: Remove PDF standard metadata. :arg bool redactions: Apply redaction annotations. :arg int redact_images: how to handle images if applying redactions. One of 0 (ignore), 1 (blank out overlaps) or 2 (remove). :arg bool remove_links: Remove all links. :arg bool reset_fields: Reset all form fields to their defaults. :arg bool reset_responses: Remove all responses from all annotations. :arg bool thumbnails: Remove thumbnail images from pages. :arg bool xml_metadata: Remove XML metadata. .. method:: save(outfile, garbage=0, clean=False, deflate=False, deflate_images=False, deflate_fonts=False, incremental=False, ascii=False, expand=0, linear=False, pretty=False, no_new_id=False, encryption=PDF_ENCRYPT_NONE, permissions=-1, owner_pw=None, user_pw=None, use_objstms=0, compression_effort=0, raise_on_repair=False) * Changed in v1.18.7 * Changed in v1.19.0 * Changed in v1.24.1 PDF only: Saves the document in its **current state**. :arg str,Path,fp outfile: The file path, `pathlib.Path` or file object to save to. A file object must have been created before via `open(...)` or `io.BytesIO()`. Choosing `io.BytesIO()` is similar to :meth:`Document.tobytes` below, which equals the `getvalue()` output of an internally created `io.BytesIO()`. :arg int garbage: Do garbage collection. Positive values exclude "incremental". * 0 = none * 1 = remove unused (unreferenced) objects. * 2 = in addition to 1, compact the :data:`xref` table. * 3 = in addition to 2, merge duplicate objects. * 4 = in addition to 3, check :data:`stream` objects for duplication. This may be slow because such data are typically large. :arg bool clean: Clean and sanitize content streams [#f1]_. Corresponds to "mutool clean -sc". :arg bool deflate: Deflate (compress) uncompressed streams. :arg bool deflate_images: *(new in v1.18.3)* Deflate (compress) uncompressed image streams [#f4]_. :arg bool deflate_fonts: *(new in v1.18.3)* Deflate (compress) uncompressed fontfile streams [#f4]_. :arg bool incremental: Only save changes to the PDF. Excludes "garbage" and "linear". Can only be used if *outfile* is a string or a `pathlib.Path` and equal to :attr:`Document.name`. Cannot be used for files that are decrypted or repaired and also in some other cases. To be sure, check :meth:`Document.can_save_incrementally`. If this is false, saving to a new file is required. :arg bool ascii: convert binary data to ASCII. :arg int expand: Decompress objects. Generates versions that can be better read by some other programs and will lead to larger files. * 0 = none * 1 = images * 2 = fonts * 255 = all :arg bool linear: Save a linearised version of the document. This option creates a file format for improved performance for Internet access. Excludes "incremental" and "use_objstms". :arg bool pretty: Prettify the document source for better readability. PDF objects will be reformatted to look like the default output of :meth:`Document.xref_object`. :arg bool no_new_id: Suppress the update of the file's `/ID` field. If the file happens to have no such field at all, also suppress creation of a new one. Default is `False`, so every save will lead to an updated file identification. :arg int permissions: *(new in v1.16.0)* Set the desired permission levels. See :ref:`PermissionCodes` for possible values. Default is granting all. :arg int encryption: *(new in v1.16.0)* set the desired encryption method. See :ref:`EncryptionMethods` for possible values. :arg str owner_pw: *(new in v1.16.0)* set the document's owner password. *(Changed in v1.18.3)* If not provided, the user password is taken if provided. The string length must not exceed 40 characters. :arg str user_pw: *(new in v1.16.0)* set the document's user password. The string length must not exceed 40 characters. :arg int use_objstms: *(new in v1.24.0)* compression option that converts eligible PDF object definitions to information that is stored in some other object's :data:`stream` data. Depending on the `deflate` parameter value, the converted object definitions will be compressed -- which can lead to very significant file size reductions. .. warning:: The method does not check, whether a file of that name already exists, will hence not ask for confirmation, and overwrite the file. It is your responsibility as a programmer to handle this. :arg int compression_effort: * 0 for default * 1 for minimum effort. * 100 for maximum effort. :arg bool raise_on_repair: *(new in v1.27.0)* If true we raise an exception if the save caused a repair. This is useful because repairs can cause changes to be lost. Also see `Document.repair()`. .. note:: **File size reduction** 1. Use the save options like `garbage=3|4, deflate=True, use_objstms=True|1`. Do not touch the default values `expand=False|0, clean=False|0, incremental=False|0, linear=False|0`. This is a "lossless" file size reduction. There is a convenience version of this method with these values set by default, :meth:`Document.ez_save` -- please see below. 2. "Lossy" file size reduction in essence must give up something with respect to images, like (a) remove all images (b) replace images by their grayscale versions (c) reduce image resolutions. Find examples in the `PyMuPDF Utilities "replace-image" folder `_. .. method:: ez_save(*args, **kwargs) * New in v1.18.11 PDF only: The same as :meth:`Document.save` but with changed defaults `deflate=True, garbage=3, use_objstms=1`. .. method:: saveIncr() PDF only: saves the document incrementally. This is a convenience abbreviation for ``doc.save(doc.name, incremental=True, encryption=PDF_ENCRYPT_KEEP)``. .. note:: Saving incrementally may be required if the document contains verified signatures which would be invalidated by saving to a new file. .. method:: tobytes(garbage=0, clean=False, deflate=False, deflate_images=False, deflate_fonts=False, ascii=False, expand=0, linear=False, pretty=False, no_new_id=False, encryption=PDF_ENCRYPT_NONE, permissions=-1, owner_pw=None, user_pw=None, use_objstms=0) * Changed in v1.18.7 * Changed in v1.19.0 * Changed in v1.24.1 PDF only: Writes the **current content of the document** to a bytes object instead of to a file. Obviously, you should be wary about memory requirements. The meanings of the parameters exactly equal those in :meth:`save`. Chapter :ref:`FAQ` contains an example for using this method as a pre-processor to `pdfrw `_. *(Changed in v1.16.0)* for extended encryption support. :rtype: bytes :returns: a bytes object containing the complete document. .. method:: search_page_for(pno, text, quads=False) Search for "text" on page number "pno". Works exactly like the corresponding :meth:`Page.search_for`. Any integer `-∞ < pno < page_count` is acceptable. .. index:: pair: append; Document.insert_pdf pair: join; Document.insert_pdf pair: merge; Document.insert_pdf pair: from_page; Document.insert_pdf pair: to_page; Document.insert_pdf pair: start_at; Document.insert_pdf pair: rotate; Document.insert_pdf pair: links; Document.insert_pdf pair: annots; Document.insert_pdf pair: widgets; Document.insert_pdf pair: join_duplicates; Document.insert_pdf pair: show_progress; Document.insert_pdf .. method:: insert_pdf(docsrc, *, from_page=-1, to_page=-1, start_at=-1, rotate=-1, links=True, annots=True, widgets=True, join_duplicates=False, show_progress=0, final=1) PDF only: Copy the page range **[from_page, to_page]** (including both) of PDF document *docsrc* into the current one. Inserts will start with page number *start_at*. Value -1 indicates default values. All pages thus copied will be rotated as specified. Links, annotations and widgets can be excluded in the target, see below. All page numbers are 0-based. :arg docsrc: An opened PDF *Document* which must not be the current document. However, it may refer to the same underlying file. :type docsrc: *Document* :arg int from_page: First page number in *docsrc*. Default is zero. :arg int to_page: Last page number in *docsrc* to copy. Defaults to last page. :arg int start_at: First copied page, will become page number *start_at* in the target. Default -1 appends the page range to the end. If zero, the page range will be inserted before current first page. :arg int rotate: All copied pages will be rotated by the provided value (degrees, integer multiple of 90). :arg bool links: Choose whether (internal and external) links should be included in the copy. Default is `True`. *Named* links (:data:`LINK_NAMED`) and internal links to outside the copied page range are **always excluded**. :arg bool annots: choose whether annotations should be included in the copy. :arg bool widgets: choose whether annotations should be included in the copy. If `True` and at least one of the source pages contains form fields, the target PDF will be turned into a Form PDF (if not already being one). :arg bool join_duplicates: *(New in version 1.25.5)* Choose how to handle duplicate root field names in the source pages. This parameter is ignored if `widgets=False`. Default is ``False`` which will add unifying strings to the name of those source root fields which have a duplicate in the target. For instance, if "name" already occurs in the target, the source widget's name will be changed to "name [text]" with a suitably chosen string "text". If ``True``, root fields with duplicate names in source and target will be converted to so-called "Kids" of a "Parent" object (which lists all kid widgets in a PDF array). This will effectively turn those kids into instances of the "same" widget: if e.g. one of the kids is changed, then all its instances will automatically inherit this change -- no matter on which page they happen to be displayed. :arg int show_progress: *(new in v1.17.7)* specify an interval size greater zero to see progress messages on `sys.stdout`. After each interval, a message like `Inserted 30 of 47 pages.` will be printed. :arg int final: *(new in v1.18.0)* controls whether the list of already copied objects should be **dropped** after this method, default ``True``. Set it to 0 except for the last one of multiple insertions from the same source PDF. This saves target file size and speeds up execution considerably. .. note:: 1. This is a page-based method. Document-level information of source documents is therefore mostly ignored. Examples include Optional Content, Embedded Files, `StructureElem`, table of contents, page labels, metadata, named destinations (and other named entries) and some more. 2. If `from_page > to_page`, pages will be **copied in reverse order**. If `0 <= from_page == to_page`, then one page will be copied. 3. `docsrc` TOC entries **will not be copied**. It is easy however, to recover a table of contents for the resulting document. Look at the examples below and at program `join.py `_ in the *examples* directory: it can join PDF documents and at the same time piece together respective parts of the tables of contents. .. index:: pair: append; Document.insert_file pair: join; Document.insert_file pair: merge; Document.insert_file pair: from_page; Document.insert_file pair: to_page; Document.insert_file pair: start_at; Document.insert_file pair: rotate; Document.insert_file pair: links; Document.insert_file pair: annots; Document.insert_file pair: show_progress; Document.insert_file .. method:: insert_file(infile, from_page=-1, to_page=-1, start_at=-1, rotate=-1, links=True, annots=True, show_progress=0, final=1) * New in v1.22.0 PDF only: Add an arbitrary supported document to the current PDF. Opens "infile" as a document, converts it to a PDF and then invokes :meth:`Document.insert_pdf`. Parameters are the same as for that method. Among other things, this features an easy way to append images as full pages to an output PDF. :arg multiple infile: the input document to insert. May be a filename specification as is valid for creating a :ref:`Document` or a :ref:`Pixmap`. .. index:: pair: width; Document.new_page pair: height; Document.new_page .. method:: new_page(pno=-1, width=595, height=842) PDF only: Insert an empty page. :arg int pno: page number index (zero-indexed) at which to insert page. Special values -1 and *doc.page_count* insert **after** the last page. :arg float width: page width. :arg float height: page height. :rtype: :ref:`Page` :returns: the created page object. Be aware that the page numbers of pages after the inserted one will have changed after method execution. For the same reason, **all existing page objects will be invalidated.** Using them will lead to exceptions. .. index:: pair: fontsize; Document.insert_page pair: width; Document.insert_page pair: height; Document.insert_page pair: fontname; Document.insert_page pair: fontfile; Document.insert_page pair: color; Document.insert_page .. method:: insert_page(pno, text=None, fontsize=11, width=595, height=842, fontname="helv", fontfile=None, color=None) PDF only: Insert a new page and insert some text. Convenience function which combines :meth:`Document.new_page` and (parts of) :meth:`Page.insert_text`. :arg int pno: page number index (zero-indexed) at which to insert page. Special values -1 and `doc.page_count` insert **after** the last page. Changed in v1.14.12 This is now a positional parameter For the other parameters, please consult the aforementioned methods. :rtype: int :returns: the result of :meth:`Page.insert_text` (number of successfully inserted lines). .. method:: delete_page(pno=-1) PDF only: Delete a page given by its 0-based number in `-∞ < pno < page_count`. * Changed in v1.18.14: support Python's `del` statement. :arg int pno: the page to be deleted. Negative number count backwards from the end of the document (like with indices). Default is the last page. .. method:: delete_pages(*args, **kwds) * Changed in v1.18.13: more flexibility specifying pages to delete. * Changed in v1.18.14: support Python's `del` statement. PDF only: Delete multiple pages given as 0-based numbers. **Format 1:** Use keywords. Represents the old format. A contiguous range of pages is removed. * "from_page": first page to delete. Zero if omitted. * "to_page": last page to delete. Last page in document if omitted. Must not be less then "from_page". **Format 2:** Two page numbers as positional parameters. Handled like Format 1. **Format 3:** One positional integer parameter. Equivalent to :meth:`Page.delete_page`. **Format 4:** One positional parameter of type *list*, *tuple* or *range()* of page numbers. The items of this sequence may be in any order and may contain duplicates. **Format 5:** *(New in v1.18.14)* Using the Python `del` statement and index / slice notation is now possible. .. note:: *(Changed in v1.14.17, optimized in v1.17.7)* In an effort to maintain a valid PDF structure, this method and :meth:`delete_page` will also deactivate items in the table of contents which point to deleted pages. "Deactivation" here means, that the bookmark will point to nowhere and the title will be shown grayed-out by supporting PDF viewers. The overall TOC structure is left intact. It will also remove any **links on remaining pages** which point to a deleted one. This action may have an extended response time for documents with many pages. Following examples will all delete pages 500 through 519: * `doc.delete_pages(500, 519)` * `doc.delete_pages(from_page=500, to_page=519)` * `doc.delete_pages((500, 501, 502, ... , 519))` * `doc.delete_pages(range(500, 520))` * `del doc[500:520]` * `del doc[(500, 501, 502, ... , 519)]` * `del doc[range(500, 520)]` For the :ref:`AdobeManual` the above takes about 0.6 seconds, because the remaining 1290 pages must be cleaned from invalid links. In general, the performance of this method is dependent on the number of remaining pages -- **not** on the number of deleted pages: in the above example, **deleting all pages except** those 20, will need much less time. .. method:: copy_page(pno, to=-1) PDF only: Copy a page reference within the document. :arg int pno: the page to be copied. Must be in range `0 <= pno < page_count`. :arg int to: the page number in front of which to copy. The default inserts **after** the last page. .. note:: Only a new **reference** to the page object will be created -- not a new page object, all copied pages will have identical attribute values, including the :attr:`Page.xref`. This implies that any changes to one of these copies will appear on all of them. .. method:: fullcopy_page(pno, to=-1) * New in v1.14.17 PDF only: Make a full copy (duplicate) of a page. :arg int pno: the page to be duplicated. Must be in range `0 <= pno < page_count`. :arg int to: the page number in front of which to copy. The default inserts **after** the last page. .. note:: * In contrast to :meth:`copy_page`, this method creates a new page object (with a new :data:`xref`), which can be changed independently from the original. * Any Popup and "IRT" ("in response to") annotations are **not copied** to avoid potentially incorrect situations. .. method:: move_page(pno, to=-1) PDF only: Move (copy and then delete original) a page within the document. :arg int pno: the page to be moved. Must be in range `0 <= pno < page_count`. :arg int to: the page number in front of which to insert the moved page. The default moves **after** the last page. .. method:: need_appearances(value=None) * New in v1.17.4 PDF only: Get or set the */NeedAppearances* property of Form PDFs. Quote: *"(Optional) A flag specifying whether to construct appearance streams and appearance dictionaries for all widget annotations in the document ... Default value: false."* This may help controlling the behavior of some readers / viewers. :arg bool value: set the property to this value. If omitted or `None`, inquire the current value. :rtype: bool :returns: * None: not a Form PDF, or property not defined. * True / False: the value of the property (either just set or existing for inquiries). Has no effect if no Form PDF. .. method:: get_sigflags() PDF only: Return whether the document contains signature fields. This is an optional PDF property: if not present (return value -1), no conclusions can be drawn -- the PDF creator may just not have bothered using it. :rtype: int :returns: * -1: not a Form PDF / no signature fields recorded / no *SigFlags* found. * 1: at least one signature field exists. * 3: contains signatures that may be invalidated if the file is saved (written) in a way that alters its previous contents, as opposed to an incremental update. .. index:: pair: filename; Document.embfile_add pair: ufilename; Document.embfile_add pair: desc; Document.embfile_add .. method:: embfile_add(name, buffer, filename=None, ufilename=None, desc=None) * Changed in v1.14.16: The sequence of positional parameters "name" and "buffer" has been changed to comply with the call pattern of other functions. PDF only: Embed a new file. All string parameters except the name may be unicode (in previous versions, only ASCII worked correctly). File contents will be compressed (where beneficial). :arg str name: entry identifier, **must not already exist**. :arg bytes,bytearray,BytesIO buffer: file contents. *(Changed in v1.14.13)* *io.BytesIO* is now also supported. :arg str filename: optional filename. Documentation only, will be set to *name* if `None`. :arg str ufilename: optional unicode filename. Documentation only, will be set to *filename* if `None`. :arg str desc: optional description. Documentation only, will be set to *name* if `None`. :rtype: int :returns: *(Changed in v1.18.13)* The method now returns the :data:`xref` of the inserted file. In addition, the file object now will be automatically given the PDF keys `/CreationDate` and `/ModDate` based on the current date-time. .. method:: embfile_count() * Changed in v1.14.16: This is now a method. In previous versions, this was a property. PDF only: Return the number of embedded files. .. method:: embfile_get(item) PDF only: Retrieve the content of embedded file by its entry number or name. If the document is not a PDF, or entry cannot be found, an exception is raised. :arg int,str item: index or name of entry. An integer must be in `range(embfile_count())`. :rtype: bytes .. method:: embfile_del(item) * Changed in v1.14.16: Items can now be deleted by index, too. PDF only: Remove an entry from `/EmbeddedFiles`. As always, physical deletion of the embedded file content (and file space regain) will occur only when the document is saved to a new file with a suitable garbage option. :arg int/str item: index or name of entry. .. warning:: When specifying an entry name, this function will only **delete the first item** with that name. Be aware that PDFs not created with PyMuPDF may contain duplicate names. So you may want to take appropriate precautions. .. method:: embfile_info(item) * Changed in v1.18.13 PDF only: Retrieve information of an embedded file given by its number or by its name. :arg int/str item: index or name of entry. An integer must be in `range(embfile_count())`. :rtype: dict :returns: a dictionary with the following keys: * ``name`` -- (*str*) name under which this entry is stored * ``filename`` -- (*str*) filename * ``ufilename`` -- (*unicode*) filename * ``description`` -- (*str*) description * ``size`` -- (*int*) original file size * ``length`` -- (*int*) compressed file length * ``creationDate`` -- (*str*) date-time of item creation in PDF format * ``modDate`` -- (*str*) date-time of last change in PDF format * ``collection`` -- (*int*) :data:`xref` of the associated PDF portfolio item if any, else zero. * ``checksum`` -- (*str*) a hashcode of the stored file content as a hexadecimal string. Should be MD5 according to PDF specifications, but be prepared to see other hashing algorithms. .. method:: embfile_names() PDF only: Return a list of embedded file names. The sequence of the names equals the physical sequence in the document. :rtype: list .. index:: pair: filename; Document.embfile_upd pair: ufilename; Document.embfile_upd pair: desc; Document.embfile_upd .. method:: embfile_upd(item, buffer=None, filename=None, ufilename=None, desc=None) PDF only: Change an embedded file given its entry number or name. All parameters are optional. Letting them default leads to a no-operation. :arg int/str item: index or name of entry. An integer must be in `range(embfile_count())`. :arg bytes,bytearray,BytesIO buffer: the new file content. *(Changed in v1.14.13)* *io.BytesIO* is now also supported. :arg str filename: the new filename. :arg str ufilename: the new unicode filename. :arg str desc: the new description. *(Changed in v1.18.13)* The method now returns the :data:`xref` of the file object. :rtype: int :returns: xref of the file object. Automatically, its `/ModDate` PDF key will be updated with the current date-time. .. method:: close() Release objects and space allocations associated with the document. If created from a file, also closes *filename* (releasing control to the OS). Explicitly closing a document is equivalent to deleting it, `del doc`, or assigning it to something else like `doc = None`. .. method:: xref_object(xref, compressed=False, ascii=False) * New in v1.16.8 * Changed in v1.18.10 PDF only: Return the definition source of a PDF object. :arg int xref: the object's :data:`xref`. *Changed in v1.18.10:* A value of `-1` returns the PDF trailer source. :arg bool compressed: whether to generate a compact output with no line breaks or spaces. :arg bool ascii: whether to ASCII-encode binary data. :rtype: str :returns: The object definition source. .. method:: pdf_catalog() * New in v1.16.8 PDF only: Return the :data:`xref` number of the PDF catalog (or root) object. Use that number with :meth:`Document.xref_object` to see its source. .. method:: pdf_trailer(compressed=False) * New in v1.16.8 PDF only: Return the trailer source of the PDF, which is usually located at the PDF file's end. This is :meth:`Document.xref_object` with an :data:`xref` argument of -1. .. method:: xref_stream(xref) * New in v1.16.8 PDF only: Return the **decompressed** contents of the :data:`xref` stream object. :arg int xref: :data:`xref` number. :rtype: bytes :returns: the (decompressed) stream of the object. .. method:: xref_stream_raw(xref) * New in v1.16.8 PDF only: Return the **unmodified** (esp. **not decompressed**) contents of the :data:`xref` stream object. Otherwise equal to :meth:`Document.xref_stream`. :rtype: bytes :returns: the (original, unmodified) stream of the object. .. method:: update_object(xref, obj_str, page=None) * New in v1.16.8 PDF only: Replace object definition of :data:`xref` with the provided string. The xref may also be new, in which case this instruction completes the object definition. If a page object is also given, its links and annotations will be reloaded afterwards. :arg int xref: :data:`xref` number. :arg str obj_str: a string containing a valid PDF object definition. :arg page: a page object. If provided, indicates, that annotations of this page should be refreshed (reloaded) to reflect changes incurred with links and / or annotations. :type page: :ref:`Page` :rtype: int :returns: zero if successful, otherwise an exception will be raised. .. method:: update_stream(xref, data, new=False, compress=True) * New in v.1.16.8 * Changed in v1.19.2: added parameter "compress" * Changed in v1.19.6: deprecated parameter "new". Now confirms that the object is a PDF dictionary object. Replace the stream of an object identified by :data:`xref`, which must be a PDF dictionary. If the object is no :data:`stream`, it will be turned into one. The function automatically performs a compress operation ("deflate") where beneficial. :arg int xref: :data:`xref` number. :arg bytes|bytearray|BytesIO stream: the new content of the stream. *(Changed in v1.14.13:)* *io.BytesIO* objects are now also supported. :arg bool new: *deprecated* and ignored. Will be removed some time after v1.20.0. :arg bool compress: whether to compress the inserted stream. If `True` (default), the stream will be inserted using `/FlateDecode` compression (if beneficial), otherwise the stream will inserted as is. :raises ValueError: if :data:`xref` does not represent a PDF :data:`dict`. An empty dictionary ``<<>>`` is accepted. So if you just created the xref and want to give it a stream, first execute `doc.update_object(xref, "<<>>")`, and then insert the stream data with this method. The method is primarily (but not exclusively) intended to manipulate streams containing PDF operator syntax (see pp. 643 of the :ref:`AdobeManual`) as it is the case for e.g. page content streams. If you update a contents stream, consider using save parameter *clean=True* to ensure consistency between PDF operator source and the object structure. Example: Let us assume that you no longer want a certain image appear on a page. This can be achieved by deleting the respective reference in its contents source(s) -- and indeed: the image will be gone after reloading the page. But the page's :data:`resources` object would still show the image as being referenced by the page. This save option will clean up any such mismatches. .. method:: Document.xref_copy(source, target, *, keep=None) * New in v1.19.5 PDF Only: Make ``target`` xref an exact copy of ``source``. If ``source`` is a :data:`stream`, then this data is also copied. :arg int source: the source :data:`xref`. It must be an existing **dictionary** object. :arg int target: the target xref. Must be an existing **dictionary** object. If the xref has just been created, make sure to initialize it as a PDF dictionary with the minimum specification ``<<>>``. :arg list keep: an optional list of top-level keys in ``target``, that should not be removed in preparation of the copy process. .. note:: * This method has much in common with Python's *dict* method `copy()`. * Both xref numbers must represent existing dictionaries. * Before data is copied from *source*, all *target* dictionary keys are deleted. You can specify exceptions from this in the ``keep`` list. If *source* however has a same-named key, its value will still replace the target. * If ``source`` is a :data:`stream` object, then these data will also be copied over, and ``target`` will be converted to a stream object. * A typical use case is to replace or remove an existing image without using redaction annotations. Example scripts can be seen `in this PyMuPDF Utilities example `_. .. method:: Document.extract_image(xref) PDF Only: Extract data and meta information of an image stored in the document. The output can directly be used to be stored as an image file, as input for PIL, :ref:`Pixmap` creation, etc. This method avoids using pixmaps wherever possible to present the image in its original format (e.g. as JPEG). :arg int xref: :data:`xref` of an image object. If this is not in `range(1, doc.xref_length())`, or the object is no image or other errors occur, `None` is returned and no exception is raised. :rtype: dict :returns: a dictionary with the following keys * *ext* (*str*) image type (e.g. *'jpeg'*), usable as image file extension * *smask* (*int*) :data:`xref` number of a stencil (/SMask) image or zero * ``width`` (*int*) image width * ``height`` (*int*) image height * *colorspace* (*int*) the image's *colorspace.n* number. * *cs-name* (*str*) the image's *colorspace.name*. * *xres* (*int*) resolution in x direction. Please also see :data:`resolution`. * *yres* (*int*) resolution in y direction. Please also see :data:`resolution`. * *image* (*bytes*) image data, usable as image file content >>> d = doc.extract_image(1373) >>> d {'ext': 'png', 'smask': 2934, 'width': 5, 'height': 629, 'colorspace': 3, 'xres': 96, 'yres': 96, 'cs-name': 'DeviceRGB', 'image': b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x05\ ...'} >>> imgout = open(f"image.{d['ext']}", "wb") >>> imgout.write(d["image"]) 102 >>> imgout.close() .. note:: There is a functional overlap with *pix = pymupdf.Pixmap(doc, xref)*, followed by a *pix.tobytes()*. Main differences are that extract_image, **(1)** does not always deliver PNG image formats, **(2)** is **very** much faster with non-PNG images, **(3)** usually results in much less disk storage for extracted images, **(4)** returns `None` in error cases (generates no exception). Look at the following example images within the same PDF. * xref 1268 is a PNG -- Comparable execution time and identical output:: In [23]: %timeit pix = pymupdf.Pixmap(doc, 1268);pix.tobytes() 10.8 ms ± 52.4 µs per loop (mean ± std. dev. of 7 runs, 100 loops each) In [24]: len(pix.tobytes()) Out[24]: 21462 In [25]: %timeit img = doc.extract_image(1268) 10.8 ms ± 86 µs per loop (mean ± std. dev. of 7 runs, 100 loops each) In [26]: len(img["image"]) Out[26]: 21462 * xref 1186 is a JPEG -- :meth:`Document.extract_image` is **many times faster** and produces a **much smaller** output (2.48 MB vs. 0.35 MB):: In [27]: %timeit pix = pymupdf.Pixmap(doc, 1186);pix.tobytes() 341 ms ± 2.86 ms per loop (mean ± std. dev. of 7 runs, 1 loop each) In [28]: len(pix.tobytes()) Out[28]: 2599433 In [29]: %timeit img = doc.extract_image(1186) 15.7 µs ± 116 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each) In [30]: len(img["image"]) Out[30]: 371177 .. method:: Document.extract_font(xref, info_only=False, named=None) * Changed in v1.19.4: return a dictionary if `named == True`. PDF Only: Return an embedded font file's data and appropriate file extension. This can be used to store the font as an external file. The method does not throw exceptions (other than via checking for PDF and valid :data:`xref`). :arg int xref: PDF object number of the font to extract. :arg bool info_only: only return font information, not the buffer. To be used for information-only purposes, avoids allocation of large buffer areas. :arg bool named: If true, a dictionary with the following keys is returned: 'name' (font base name), 'ext' (font file extension), 'type' (font type), 'content' (font file content). :rtype: tuple,dict :returns: a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte suggested file extension (*str*), *basename* is the font's name (*str*), *type* is the font's type (e.g. "Type1") and *content* is a bytes object containing the font file's content (or *b""*). For possible extension values and their meaning see :ref:`FontExtensions`. Return details on error: * `("", "", "", b"")` -- invalid xref or xref is not a (valid) font object. * `(basename, "n/a", "Type1", b"")` -- *basename* is not embedded and thus cannot be extracted. This is the case for e.g. the :ref:`Base-14-Fonts` and Type 3 fonts. Example: >>> # store font as an external file >>> name, ext, _, content = doc.extract_font(4711) >>> # assuming content is not None: >>> ofile = open(name + "." + ext, "wb") >>> ofile.write(content) >>> ofile.close() .. warning:: The basename is returned unchanged from the PDF. So it may contain characters (such as blanks) which may disqualify it as a filename for your operating system. Take appropriate action. .. note:: * The returned *basename* in general is **not** the original file name, but it probably has some similarity. * If parameter `named == True`, a dictionary with the following keys is returned: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': b''}`. .. method:: xref_xml_metadata() * New in v1.16.8 PDF only: Return the :data:`xref` of the document's XML metadata. .. method:: has_links() .. method:: has_annots() * New in v1.18.7 PDF only: Check whether there are links, resp. annotations anywhere in the document. :returns: ``True`` / ``False``. As opposed to fields, which are also stored in a central place of a PDF document, the existence of links / annotations can only be detected by parsing each page. These methods are tuned to do this efficiently and will immediately return, if the answer is ``True`` for a page. For PDFs with many thousand pages however, an answer may take some time [#f6]_ if no link, resp. no annotation is found. .. method:: subset_fonts(verbose=False, fallback=False) PDF only: Investigate eligible fonts for their use by text in the document. If a font is supported and a size reduction is possible, that font is replaced by a version with a subset of its characters. Use this method immediately before saving the document. :arg bool verbose: write various progress information to sysout. This currently only has an effect if `fallback` is `True`. :arg bool fallback: if `True` use the deprecated algorithm that makes use of package `fontTools `_ (which hence must be installed). If using the recommended value `False` (default), MuPDF's native function is used -- which is **very much faster** and can subset a broader range of font types. Package fontTools is not required then. The greatest benefit can be achieved when creating new PDFs using large fonts like is typical for Asian scripts. When using the :ref:`Story` class or method :meth:`Page.insert_htmlbox`, multiple fonts may automatically be included -- without the programmer becoming aware of it. In all these cases, the set of actually used unicodes mostly is very small compared to the number of glyphs available in the used fonts. Using this method can easily reduce the embedded font binaries by two orders of magnitude -- from several megabytes down to a low two-digit kilobyte amount. Creating font subsets leaves behind a large number of large, now unused PDF objects ("ghosts"). Therefore, make sure to compress and garbage-collect when saving the file. We recommend to use :meth:`Document.ez_save`. |history_begin| * New in v1.18.7 * Changed in v1.18.9 * Changed in v1.24.2 use native function of MuPDF. |history_end| .. method:: journal_enable() * New in v1.19.0 PDF only: Enable journalling. Use this before you start logging operations. .. method:: journal_start_op(name) * New in v1.19.0 PDF only: Start journalling an *"operation"* identified by a string "name". Updates will fail for a journal-enabled PDF, if no operation has been started. .. method:: journal_stop_op() * New in v1.19.0 PDF only: Stop the current operation. The updates between start and stop of an operation belong to the same unit of work and will be undone / redone together. .. method:: journal_position() * New in v1.19.0 PDF only: Return the numbers of the current operation and the total operation count. :returns: a tuple `(step, steps)` containing the current operation number and the total number of operations in the journal. If **step** is 0, we are at the top of the journal. If **step** equals **steps**, we are at the bottom. Updating the PDF with anything other than undo or redo will automatically remove all journal entries after the current one and the new update will become the new last entry in the journal. The updates corresponding to the removed journal entries will be permanently lost. .. method:: journal_op_name(step) * New in v1.19.0 PDF only: Return the name of operation number *step.* .. method:: journal_can_do() * New in v1.19.0 PDF only: Show whether forward ("redo") and / or backward ("undo") executions are possible from the current journal position. :returns: a dictionary `{"undo": bool, "redo": bool}`. The respective method is available if its value is `True`. .. method:: journal_undo() * New in v1.19.0 PDF only: Revert (undo) the current step in the journal. This moves towards the journal's top. .. method:: journal_redo() * New in v1.19.0 PDF only: Re-apply (redo) the current step in the journal. This moves towards the journal's bottom. .. method:: journal_save(filename) * New in v1.19.0 PDF only: Save the journal to a file. :arg str,fp filename: either a filename as string or a file object opened as "wb" (or an `io.BytesIO()` object). .. method:: journal_load(filename) * New in v1.19.0 PDF only: Load journal from a file. Enables journalling for the document. If journalling is already enabled, an exception is raised. :arg str,fp filename: the filename (str) of the journal or a file object opened as "rb" (or an `io.BytesIO()` object). .. method:: save_snapshot() * New in v1.19.0 PDF only: Saves a "snapshot" of the document. This is a PDF document with a special, incremental-save format compatible with journalling -- therefore no save options are available. Saving a snapshot is not possible for new documents. This is a normal PDF document with no usage restrictions whatsoever. If it is not being changed in any way, it can be used together with its journal to undo / redo operations or continue updating. .. attribute:: outline Contains the first :ref:`Outline` entry of the document (or `None`). Can be used as a starting point to walk through all outline items. Accessing this property for encrypted, not authenticated documents will raise an *AttributeError*. :type: :ref:`Outline` .. attribute:: is_closed ``False`` if document is still open. If closed, most other attributes and methods will have been deleted / disabled. In addition, :ref:`Page` objects referring to this document (i.e. created with :meth:`Document.load_page`) and their dependent objects will no longer be usable. For reference purposes, :attr:`Document.name` still exists and will contain the filename of the original document (if applicable). :type: bool .. attribute:: is_dirty ``True`` if this is a PDF document and contains unsaved changes, else ``False``. :type: bool .. attribute:: is_pdf ``True`` if this is a PDF document, else ``False``. :type: bool .. attribute:: is_form_pdf ``False`` if this is not a PDF or has no form fields, otherwise the number of root form fields (fields with no ancestors). *(Changed in v1.16.4)* Returns the total number of (root) form fields. :type: bool,int .. attribute:: is_reflowable ``True`` if document has a variable page layout (like e-books or HTML). In this case you can set the desired page dimensions during document creation (open) or via method :meth:`layout`. :type: bool .. attribute:: is_repaired * New in v1.18.2 ``True`` if PDF has been repaired during open (because of major structure issues). Always ``False`` for non-PDF documents. If true, more details have been stored in `TOOLS.mupdf_warnings()`, and :meth:`Document.can_save_incrementally` will return ``False``. :type: bool .. attribute:: is_fast_webaccess * New in v1.22.2 ``True`` if PDF is in linearized format. ``False`` for non-PDF documents. :type: bool .. attribute:: markinfo * New in v1.22.2 A dictionary indicating the `/MarkInfo` value. If not specified, the empty dictionary is returned. If not a PDF, `None` is returned. :type: dict .. attribute:: pagemode * New in v1.22.2 A string containing the `/PageMode` value. If not specified, the default "UseNone" is returned. If not a PDF, `None` is returned. :type: str .. attribute:: pagelayout * New in v1.22.2 A string containing the `/PageLayout` value. If not specified, the default "SinglePage" is returned. If not a PDF, `None` is returned. :type: str .. attribute:: version_count * New in v1.22.2 An integer counting the number of versions present in the document. Zero if not a PDF, otherwise the number of incremental saves plus one. :type: int .. attribute:: needs_pass Indicates whether the document is password-protected against access. This indicator remains unchanged -- **even after the document has been authenticated**. Precludes incremental saves if true. :type: bool .. attribute:: is_encrypted This indicator initially equals :attr:`Document.needs_pass`. After successful authentication, it is set to ``False`` to reflect the situation. :type: bool .. attribute:: permissions * Changed in v1.16.0: This is now an integer comprised of bit indicators. Was a dictionary previously. Contains the permissions to access the document. This is an integer containing bool values in respective bit positions. For example, if *doc.permissions & pymupdf.PDF_PERM_MODIFY > 0*, you may change the document. See :ref:`PermissionCodes` for details. :type: int .. attribute:: metadata Contains the document's meta data as a Python dictionary or `None` (if *is_encrypted=True* and *needPass=True*). Keys are *format*, *encryption*, *title*, *author*, *subject*, *keywords*, *creator*, *producer*, *creationDate*, *modDate*, *trapped*. All item values are strings or `None`. Except *format* and *encryption*, for PDF documents, the key names correspond in an obvious way to the PDF keys */Creator*, */Producer*, */CreationDate*, */ModDate*, */Title*, */Author*, */Subject*, */Trapped* and */Keywords* respectively. - *format* contains the document format (e.g. 'PDF-1.6', 'XPS', 'EPUB'). - *encryption* either contains `None` (no encryption), or a string naming an encryption method (e.g. *'Standard V4 R4 128-bit RC4'*). Note that an encryption method may be specified **even if** *needs_pass=False*. In such cases not all permissions will probably have been granted. Check :attr:`Document.permissions` for details. - If the date fields contain valid data (which need not be the case at all!), they are strings in the PDF-specific timestamp format "D:", where - is the 12 character ISO timestamp *YYYYMMDDhhmmss* (*YYYY* - year, *MM* - month, *DD* - day, *hh* - hour, *mm* - minute, *ss* - second), and - is a time zone value (time interval relative to GMT) containing a sign ('+' or '-'), the hour (*hh*), and the minute (*'mm'*, note the apostrophes!). - A Paraguayan value might hence look like *D:20150415131602-04'00'*, which corresponds to the timestamp April 15, 2015, at 1:16:02 pm local time Asuncion. :type: dict .. Attribute:: name Contains the *filename* or *filetype* value with which *Document* was created. :type: str .. Attribute:: page_count Contains the number of pages of the document. May return 0 for documents with no pages. Function `len(doc)` will also deliver this result. :type: int .. Attribute:: chapter_count * New in v1.17.0 Contains the number of chapters in the document. Always at least 1. Relevant only for document types with chapter support (EPUB currently). Other documents will return 1. :type: int .. Attribute:: last_location * New in v1.17.0 Contains (chapter, pno) of the document's last page. Relevant only for document types with chapter support (EPUB currently). Other documents will return `(0, page_count - 1)` and `(0, -1)` if it has no pages. :type: int .. Attribute:: FormFonts A list of form field font names defined in the */AcroForm* object. `None` if not a PDF. :type: list .. NOTE:: For methods that change the structure of a PDF (:meth:`insert_pdf`, :meth:`select`, :meth:`copy_page`, :meth:`delete_page` and others), be aware that objects or properties in your program may have been invalidated or orphaned. Examples are :ref:`Page` objects and their children (links, annotations, widgets), variables holding old page counts, tables of content and the like. Remember to keep such variables up to date or delete orphaned objects. Also refer to :ref:`ReferenialIntegrity`. :meth:`set_metadata` Example ------------------------------- Clear metadata information. If you do this out of privacy / data protection concerns, make sure you save the document as a new file with *garbage > 0*. Only then the old */Info* object will also be physically removed from the file. In this case, you may also want to clear any XML metadata inserted by several PDF editors: >>> import pymupdf >>> doc=pymupdf.open("pymupdf.pdf") >>> doc.metadata # look at what we currently have {'producer': 'rst2pdf, reportlab', 'format': 'PDF 1.4', 'encryption': None, 'author': 'Jorj X. McKie', 'modDate': "D:20160611145816-04'00'", 'keywords': 'PDF, XPS, EPUB, CBZ', 'title': 'The PyMuPDF Documentation', 'creationDate': "D:20160611145816-04'00'", 'creator': 'sphinx', 'subject': 'PyMuPDF 1.9.1'} >>> doc.set_metadata({}) # clear all fields >>> doc.metadata # look again to show what happened {'producer': 'none', 'format': 'PDF 1.4', 'encryption': None, 'author': 'none', 'modDate': 'none', 'keywords': 'none', 'title': 'none', 'creationDate': 'none', 'creator': 'none', 'subject': 'none'} >>> doc.del_xml_metadata() # clear any XML metadata >>> doc.save("anonymous.pdf", garbage = 4) # save anonymized doc :meth:`set_toc` Demonstration ---------------------------------- This shows how to modify or add a table of contents. Also have a look at `import.py `_ and `export.py `_ in the examples directory. >>> import pymupdf >>> doc = pymupdf.open("test.pdf") >>> toc = doc.get_toc() >>> for t in toc: print(t) # show what we have [1, 'The PyMuPDF Documentation', 1] [2, 'Introduction', 1] [3, 'Note on the Name fitz', 1] [3, 'License', 1] >>> toc[1][1] += " modified by set_toc" # modify something >>> doc.set_toc(toc) # replace outline tree 3 # number of bookmarks inserted >>> for t in doc.get_toc(): print(t) # demonstrate it worked [1, 'The PyMuPDF Documentation', 1] [2, 'Introduction modified by set_toc', 1] # <<< this has changed [3, 'Note on the Name fitz', 1] [3, 'License', 1] :meth:`insert_pdf` Examples ---------------------------- **(1) Concatenate two documents including their TOCs:** >>> doc1 = pymupdf.open("file1.pdf") # must be a PDF >>> doc2 = pymupdf.open("file2.pdf") # must be a PDF >>> pages1 = len(doc1) # save doc1's page count >>> toc1 = doc1.get_toc(False) # save TOC 1 >>> toc2 = doc2.get_toc(False) # save TOC 2 >>> doc1.insert_pdf(doc2) # doc2 at end of doc1 >>> for t in toc2: # increase toc2 page numbers t[2] += pages1 # by old len(doc1) >>> doc1.set_toc(toc1 + toc2) # now result has total TOC Obviously, similar ways can be found in more general situations. Just make sure that hierarchy levels in a row do not increase by more than one. Inserting dummy bookmarks before and after *toc2* segments would heal such cases. A ready-to-use GUI (wxPython) solution can be found in script `join.py `_ of the examples directory. **(2) More examples:** >>> # insert 5 pages of doc2, where its page 21 becomes page 15 in doc1 >>> doc1.insert_pdf(doc2, from_page=21, to_page=25, start_at=15) >>> # same example, but pages are rotated and copied in reverse order >>> doc1.insert_pdf(doc2, from_page=25, to_page=21, start_at=15, rotate=90) >>> # put copied pages in front of doc1 >>> doc1.insert_pdf(doc2, from_page=21, to_page=25, start_at=0) Other Examples ---------------- **Extract all page-referenced images of a PDF into separate PNG files**:: for i in range(doc.page_count): imglist = doc.get_page_images(i) for img in imglist: xref = img[0] # xref number pix = pymupdf.Pixmap(doc, xref) # make pixmap from image if pix.n - pix.alpha < 4: # can be saved as PNG pix.save(f"p{i}-{xref}.png") else: # CMYK: must convert first pix0 = pymupdf.Pixmap(pymupdf.csRGB, pix) pix0.save(f"p{i}-{xref}.png") pix0 = None # free Pixmap resources pix = None # free Pixmap resources **Rotate all pages of a PDF:** >>> for page in doc: page.set_rotation(90) .. rubric:: Footnotes .. [#f1] Content streams describe what (e.g. text or images) appears where and how on a page. PDF uses a specialized mini language similar to PostScript to do this (pp. 643 in :ref:`AdobeManual`), which gets interpreted when a page is loaded. .. [#f2] However, you **can** use :meth:`Document.get_toc` and :meth:`Page.get_links` (which are available for all document types) and copy this information over to the output PDF. See demo `convert.py `_. .. [#f3] For applicable (EPUB) document types, loading a page via its absolute number may result in layouting a large part of the document, before the page can be accessed. To avoid this performance impact, prefer chapter-based access. Use convenience methods and attributes :meth:`Document.next_location`, :meth:`Document.prev_location` and :attr:`Document.last_location` for maintaining a high level of coding efficiency. .. [#f4] These parameters cause separate handling of stream categories: use it together with `expand` to restrict decompression to streams other than images / fontfiles. .. [#f5] Examples for "Form XObjects" are created by :meth:`Page.show_pdf_page`. .. [#f6] For a ``False`` the **complete document** must be scanned. Both methods **do not load pages,** but only scan object definitions. This makes them at least 10 times faster than application-level loops (where total response time roughly equals the time for loading all pages). For the :ref:`AdobeManual` (756 pages) and the Pandas documentation (over 3070 pages) -- both have no annotations -- the method needs about 11 ms for the answer ``False``. So response times will probably become significant only well beyond this order of magnitude. .. [#f7] This only works under certain conditions. For example, if there is normal text covered by some image on top of it, then this is undetectable and the respective text is **not** removed. Similar is true for white text on white background, and so on. .. include:: footer.rst ================================================ FILE: docs/extensions/__init__.py ================================================ ================================================ FILE: docs/extensions/fulltoc.py ================================================ # -*- encoding: utf-8 -*- # # Copyright © 2012 New Dream Network, LLC (DreamHost) # # Author: Doug Hellmann # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. from sphinx import addnodes def html_page_context(app, pagename, templatename, context, doctree): """Event handler for the html-page-context signal. Modifies the context directly. - Replaces the 'toc' value created by the HTML builder with one that shows all document titles and the local table of contents. - Sets display_toc to True so the table of contents is always displayed, even on empty pages. - Replaces the 'toctree' function with one that uses the entire document structure, ignores the maxdepth argument, and uses only prune and collapse. """ rendered_toc = get_rendered_toctree(app.builder, pagename) context["toc"] = rendered_toc context["display_toc"] = True # force toctree to display if "toctree" not in context: # json builder doesn't use toctree func, so nothing to replace return def make_toctree(collapse=True, maxdepth=-1, includehidden=True): return get_rendered_toctree( app.builder, pagename, prune=False, collapse=collapse, ) context["toctree"] = make_toctree def get_rendered_toctree(builder, docname, prune=False, collapse=True): """Build the toctree relative to the named document, with the given parameters, and then return the rendered HTML fragment. """ fulltoc = build_full_toctree( builder, docname, prune=prune, collapse=collapse, ) rendered_toc = builder.render_partial(fulltoc)["fragment"] return rendered_toc def build_full_toctree(builder, docname, prune, collapse): """Return a single toctree starting from docname containing all sub-document doctrees. """ env = builder.env doctree = env.get_doctree(env.config.master_doc) toctrees = [] for toctreenode in doctree.traverse(addnodes.toctree): toctree = env.resolve_toctree( docname, builder, toctreenode, collapse=collapse, prune=prune, includehidden=True, ) if toctree is not None: toctrees.append(toctree) if not toctrees: return None result = toctrees[0] for toctree in toctrees[1:]: if toctree: result.extend(toctree.children) env.resolve_references(result, docname, builder) return result def setup(app): app.connect("html-page-context", html_page_context) ================================================ FILE: docs/extensions/searchrepair.py ================================================ import os def modify_search_index(app, exception): if exception is None: # build succeeded filename = os.path.join(app.outdir, "searchindex.js") if os.path.exists(filename): searchfile = open(filename) data1 = searchfile.read() searchfile.close() p1 = data1.find("filenames:[") p2 = data1.find("]", p1) s = data1[p1:p2].replace(".txt", "") data2 = data1[:p1] data2 += s data2 += data1[p2:] searchfile = open(filename, "w") searchfile.write(data2) searchfile.close() def setup(app): app.connect("build-finished", modify_search_index) ================================================ FILE: docs/faq/index.rst ================================================ .. include:: ../header.rst FAQ ============= .. raw:: html .. raw:: html

Installation & Setup

QI installed PyMuPDF but import pymupdf says "no module named pymupdf". What's wrong?+

This is the single most common installation issue. A few things to check:

First, make sure you installed pymupdf (not pymypdf or mupdf):

pip install pymupdf

Second, verify your IDE (PyCharm, VS Code, etc.) is using the same Python interpreter and virtual environment where you installed it. Try running python -c "import pymupdf; print(pymupdf.__doc__)" directly in a terminal to isolate IDE issues.

Third, there is a separate PyPI package literally named fitz that has nothing to do with PyMuPDF. These two packages cannot coexist in the same environment. If you installed both, uninstall fitz and reinstall pymupdf.

Note:import fitz still works as a legacy alias, but import pymupdf is the recommended import since version 1.24.0.
QHow do I install PyMuPDF on Apple Silicon (M1/M2/M3/M4/M5)?+

PyMuPDF now ships pre-built wheels for Apple Silicon. A simple pip install pymupdf should work. 

pip install pymupdf
QWhen will PyMuPDF support the latest MuPDF version?+

PyMuPDF releases typically follow MuPDF releases by a few days. When a new MuPDF version is released, the PyMuPDF team updates bindings and pushes a new release within 1-2 days. Check the changelog for the latest version mapping.

QHow do I install PyMuPDF in a Docker container?+

Standard pip install pymupdf works in most Linux containers. For OCR support, you also need Tesseract language data files. A typical Dockerfile:

FROM python:3.11-slim
    RUN apt-get update && apt-get install -y tesseract-ocr tesseract-ocr-eng
    RUN pip install pymupdf
Performance note: OCR in Docker may be slower than on bare metal due to thread detection differences. Explicitly setting OMP_THREAD_LIMIT can help.

Text Extraction

QWhat are the different text extraction modes and when should I use each?+

page.get_text() accepts several output format options:

"text" — Plain text. Good for simple extraction where layout doesn't matter.

"blocks" — Returns a list of text blocks with bounding boxes. Useful for identifying paragraphs.

"words" — Individual words with positions. Good for spatial analysis.

"dict" — Structured dictionary with blocks, lines, and spans including font information. Use this when you need font names, sizes, and colors.

"rawdict" — Like "dict" but with individual character-level positions. The most detailed but largest output. Use when you need exact character placement.

"json" / "rawjson" — Same as dict/rawdict but as JSON strings. Easier to save to a file for inspection.

Tip: If you want to inspect the output structure, use "json" or "rawjson" and save to a file rather than trying to dump a deeply nested dict to CSV.
QI can see text in the PDF but get_text() returns empty or garbled characters. Why?+

Several possible causes:

Scanned PDF: The page is an image, not real text. You need OCR. See the OCR section.

Scrambled encoding: Some PDF creators intentionally scramble character sequences as copy-protection. The text looks correct visually but the internal encoding is randomized. There is no reliable way to detect this programmatically. If you see lots of U+FFFD (replacement characters), this is likely the cause.

Custom font encoding: The font does not provide a back-translation to Unicode. If the font's internal /ToUnicode map is missing, the information simply cannot be recovered. OCR is your fallback here.

Diagnostic: Try page.get_text("rawdict") and inspect the character codes. If they're all 0xFFFD or nonsensical, the encoding is broken at the PDF level, not a PyMuPDF issue.
QHow do I extract text from a specific rectangular area of a page?+

Use the clip parameter:

rect = pymupdf.Rect(100, 100, 400, 300)
    text = page.get_text(clip=rect)

    # With full detail:
    data = page.get_text("rawdict", clip=rect)

This works with all output formats ("text", "dict", "rawdict", etc.).

QText extraction doesn't follow reading order. Columns are mixed up. How do I fix this?+

Text extraction order depends entirely on how the PDF was created. The internal order may not match visual reading order. Use sort=True to sort blocks by position (top-left to bottom-right):

text = page.get_text(sort=True)

For multi-column layouts, this helps but isn't perfect. You may need to identify column boundaries yourself using block bounding boxes and split text accordingly. There is no universal solution because PDF creators can store text in arbitrary order.

QHow do I extract only bold (or italic) text from a PDF?+

Use "dict" output and filter by span flags:

data = page.get_text("dict")
    for block in data["blocks"]:
        if "lines" not in block:
            continue
        for line in block["lines"]:
            for span in line["spans"]:
                # flags: bit 0 = superscript, bit 1 = italic, 
                # bit 2 = serif, bit 3 = monospace, bit 4 = bold
                if span["flags"] & (1 << 4):  # bold
                    print(span["text"])

You can also check the font name. Bold fonts typically have "Bold", "Bd", or "Heavy" in their name.

QHow do I find and locate specific text on a page?+

Use page.search_for():

areas = page.search_for("your search term")
    for rect in areas:
        print(rect)  # pymupdf.Rect with coordinates

This returns a list of Rect objects showing where each occurrence appears. Note: regular expressions are not supported. If you need regex matching, first extract the full text with get_text(), find matches, then use search_for() to locate each match on the page.

Performance note: Adding quads=True is actually slightly faster than the default, because rects are internally converted from quads.
QCan I render specific spans from rawdict back onto a blank page?+

Yes, but it requires manual work. You need to: (1) extract the font(s) used in the spans, (2) write your own positioning code using the character-level data from "rawdict", and (3) use TextWriter or insert_text() to place each character. This is an advanced use case where you're essentially re-rendering specific text elements.

Table Extraction

QHow do I extract tables from a PDF into a pandas DataFrame?+
import pymupdf
    import pandas as pd

    doc = pymupdf.open("input.pdf")
    page = doc[0]  # first page
    tables = page.find_tables()

    for table in tables:
        df = table.to_pandas()
        print(df)

The find_tables() method detects tables using vector graphics (lines and rectangles). No intermediate image conversion is involved.

Qfind_tables() isn't detecting my table. What can I do?+

Table detection depends on how the table was constructed in the PDF. Common issues:

No visible borders: If the table has no drawn lines or rectangles, the detection may fail. Try the strategy="text" parameter for text-based detection.

Background colors only: Some tables use cell background colors without borders. These are harder to detect reliably.

PyMuPDF's table extraction is ported from pdfplumber (chosen over alternatives like tabula for its pure-Python implementation and better accuracy). For extremely unusual table structures, you may need to combine get_text("dict") with your own spatial logic.

QCan I extract a table, modify it, and write it back to the same location in the PDF?+

This has a very high probability of failure. You can extract and store table content, structure, and location, but writing it back only works if there are zero structural changes: no new cells, no removed cells, no cell size changes, no merged cells. Even then, there is no native "replace table" function. You would need to redact the original area and rebuild the table from scratch using text insertion and drawing commands.

OCR

QHow does OCR work in PyMuPDF? Does it use Tesseract?+

Yes. MuPDF contains the Tesseract C++ code directly (it's compiled in, not called as an external process). PyMuPDF calls MuPDF functions to invoke Tesseract. The only external requirement is Tesseract language data files (tessdata). Over 100 languages are supported.

There is no Python-level Tesseract dependency. Everything runs through the C/C++ layer.

QHow do I OCR an image file (not a PDF)?+
import pymupdf

    pix = pymupdf.Pixmap("image.png")

    # Remove alpha channel if present (required for OCR)
    if pix.alpha:
        pix = pymupdf.Pixmap(pix, 0)

    # Create a 1-page PDF with OCR text layer
    doc = pymupdf.open("pdf", pix.pdfocr_tobytes())

    # Now extract the text
    text = doc[0].get_text()
Common error: If your image has a transparency (alpha) channel, OCR will fail. Always check and remove it with pymupdf.Pixmap(pix, 0) first.
QHow do I OCR a specific language (e.g., Ukrainian, Chinese)?+

Install the Tesseract language data file for your language, then specify it:

# For a full page OCR:
    tp = page.get_textpage_ocr(language="ukr")  # Ukrainian
    text = page.get_text(textpage=tp)

    # For image-to-PDF OCR:
    doc = pymupdf.open("pdf", pix.pdfocr_tobytes(language="chi_sim"))  # Chinese Simplified

Make sure the corresponding .traineddata file exists in your Tesseract data directory.

QOCR is very slow in my Docker container compared to running locally. Why?+

Tesseract uses OpenMP for parallelism. In Docker, thread detection may not work correctly, causing it to use fewer threads than available. Try setting OMP_THREAD_LIMIT environment variable explicitly. Also ensure your container has adequate CPU resources allocated.

QHow do I determine if a page needs OCR or already has extractable text?+

There's no silver bullet. A reasonable heuristic:

text = page.get_text().strip()
    if not text or len(text) < 10:
        # Probably needs OCR
        tp = page.get_textpage_ocr()
        text = page.get_text(textpage=tp)

For scrambled text (copy-protection), you might get text that looks like random characters. Checking for high rates of U+FFFD replacement characters can help detect this. But detecting scrambled text reliably is fundamentally difficult.

PyMuPDF4LLM & AI Pipelines

QDoes PyMuPDF4LLM send my data to any external service or API?+

No. PyMuPDF4LLM is completely derived from PyMuPDF. There is no access to anything beyond your local machine. No calls to any AI, LLM, RAG, or cloud service. Everything works exactly the same when all internet access is blocked. It is fully GDPR-compatible in terms of data processing.

QHow do I get page-level metadata (like LlamaIndex documents) from PyMuPDF4LLM?+

Use the page_chunks option:

import pymupdf4llm

    # Returns a list of page dictionaries (similar to LlamaIndex Document objects)
    result = pymupdf4llm.to_markdown("input.pdf", page_chunks=True)

    for page in result:
        print(page["metadata"])  # page number, etc.
        print(page["text"][:200])  # markdown content
QPyMuPDF4LLM merges my tables into plain text instead of markdown tables. Why?+

Table detection depends on the PDF structure. Some tables are defined in unusual ways (partial borders, background colors only on some cells, inconsistent cell structures). There's a limit to how creatively a table might have been defined.

Try adjusting table detection parameters. If the table structure is truly unconventional, you may need to fall back to page.find_tables() with custom parameters and handle table conversion to markdown separately.

QWhat is the licensing situation for PyMuPDF4LLM in a commercial product?+

PyMuPDF4LLM has the same license as PyMuPDF and MuPDF: either GNU AGPL or a commercial license from Artifex. If you're using it as part of a commercial product's data pipeline (even if it's just parsing PDFs for a RAG system), the AGPL obligations apply. Contact Artifex to evaluate your situation and discuss commercial licensing.

QCan I process multiple PDFs at once with PyMuPDF4LLM?+

The API processes one PDF at a time. For batch processing, loop over your files:

import pymupdf4llm
    from pathlib import Path

    for pdf in Path("./docs").glob("*.pdf"):
        md = pymupdf4llm.to_markdown(str(pdf), page_chunks=True)
        # process each result
QWhich AI frameworks use PyMuPDF for PDF parsing?+

LlamaIndex uses PyMuPDF. LangChain includes PyMuPDF as one of its PDF loader alternatives. Many RAG pipeline implementations in the ecosystem rely on PyMuPDF for the extraction layer.

Images & Pixmaps

QExtracted images have a black background where transparency should be. How do I preserve transparency?+

When extracting images, check for an SMask (soft mask). The page.extract_image(xref) result dictionary has an "smask" key. If its value is > 0, that's the xref of the transparency mask. You need to extract both and combine them:

img = page.extract_image(xref)
    if img["smask"] > 0:
        mask_pix = pymupdf.Pixmap(doc, img["smask"])
        main_pix = pymupdf.Pixmap(doc, xref)
        # Combine image with its mask
        pix = pymupdf.Pixmap(main_pix, mask_pix)
    else:
        pix = pymupdf.Pixmap(doc, xref)
QHow do I insert an image into a page?+

Use page.insert_image() with a target rectangle:

# Insert from file
    rect = pymupdf.Rect(100, 100, 300, 250)
    page.insert_image(rect, filename="logo.png")

    # Use page.rect for full-page:
    page.insert_image(page.rect, filename="background.jpg")
Common mistake: Don't pass the filename as a positional argument. Use filename= explicitly. The call pattern is insert_image(rect, filename=None, pixmap=None, stream=None, ...).
QHow do I render a page to an image (screenshot)?+
page = doc[0]
    pix = page.get_pixmap(dpi=150)  # default is 72 dpi
    pix.save("page.png")

    # Higher resolution:
    pix = page.get_pixmap(dpi=300)

You can also use a Matrix for more control over scaling and rotation.

QCan I extract vector graphics (logos, diagrams) as images?+

Vector graphics (line art) cannot be extracted as images directly because they aren't images in the PDF. PyMuPDF can extract vector drawings as path data via page.get_drawings(), which returns elementary drawing commands (lines, curves, rectangles). To get a visual representation, render the relevant area to a Pixmap using a clip rectangle.

Text Insertion

QWhat's the difference between insert_text, insert_textbox, and insert_htmlbox?+

page.insert_text(point, text) — Places text starting at a single point. No wrapping. You control exact position.

page.insert_textbox(rect, text) — Fills text into a rectangle with automatic line breaks. Returns a value indicating overflow (negative = text didn't fit).

page.insert_htmlbox(rect, html) — Like textbox but accepts HTML/CSS for rich formatting. Tremendously more flexible: supports mixed fonts, colors, alignment, etc. This is generally the recommended approach for complex text insertion.

QMy inserted text is white (invisible). How do I make it black?+

Black is the default color. If text appears white, you may be inserting on a dark background or there's a color space issue. Explicitly set color:

page.insert_text((100, 100), "Hello", color=pymupdf.pdfcolor["black"])

    # Or using RGB tuple (0-1 range):
    page.insert_text((100, 100), "Hello", color=(0, 0, 0))
QHow do I create a landscape page?+
# Use paper size with "-l" suffix for landscape
    mediabox = pymupdf.paper_rect("a4-l")
    page = doc.new_page(width=mediabox.width, height=mediabox.height)

    # See all available paper sizes:
    print(pymupdf.paper_sizes())
QHow do I set margins when inserting text on a new page?+

Create a fill rectangle with margins subtracted from the page rectangle:

page = doc.new_page()
    left, top, right, bottom = 72, 72, 72, 72  # 1 inch margins
    fill_rect = page.rect + (left, top, -right, -bottom)
    page.insert_textbox(fill_rect, text, fontname="helv", fontsize=11)
QThe Euro sign (€) and other special characters show as "?" in my text. Why?+

The built-in Base-14 fonts (like "helv") only support characters up to Unicode 256. The Euro sign is at 0x80 in this range. Either replace € with chr(0x80) in your text, or use a proper Unicode font file:

page.insert_text((100, 100), "Price: 50€",
        fontfile="/path/to/arial.ttf",
        fontname="arial")

For CJK and extended characters, use the pymupdf-fonts package which includes FiraGO and CJK fallback fonts.

QHow do I dynamically fit text to a rectangle (auto font size)?+

Two approaches:

Option 1: Reduce font size until it fits:

fontsize = 20
    while True:
        rc = page.insert_textbox(rect, text, fontsize=fontsize)
        if rc >= 0:  # positive = text fit
            break
        fontsize -= 0.5  # shrink and retry

Option 2: Use insert_htmlbox() which handles overflow more gracefully and gives you CSS-level control.

QHow do I add text on top of an image (with a background rectangle)?+

Draw the background rectangle first, then insert text on top:

shape = page.new_shape()
    shape.draw_rect(rect)
    shape.finish(fill=(1, 1, 0.8))  # light yellow fill
    shape.commit()

    page.insert_textbox(rect, text, fontsize=12)

Order matters: shapes drawn first appear behind text inserted later.

Annotations

QDoes PyMuPDF support "cloudy" border style for annotations?+

No. The cloudy border effect (common in Adobe PDF annotations) is not implemented in MuPDF's C core, so it's not available through PyMuPDF either.

QHow do I redact (permanently remove) content from a PDF?+
# Step 1: Mark areas for redaction
    rect = page.search_for("confidential")[0]
    page.add_redact_annot(rect, fill=(1, 1, 1))  # white fill

    # Step 2: Apply redactions (permanently removes content)
    page.apply_redactions()

    doc.save("redacted.pdf")

After applying redactions, the original content is permanently removed from the PDF. This is a two-step process by design, so you can review before committing.

Replacement text: You can also insert replacement text during redaction, but the formatting options are limited. For more control, apply the redaction to clear the area, then use insert_text() or insert_htmlbox() in a separate step.
QCan I "flatten" annotations so they become part of the page content?+

MuPDF has work-in-progress support for this. If you flatten annotations, they become part of the page content stream and can no longer be edited, moved, or recognized as annotations by other PDF viewers. For form fields, this means they lose interactivity.

QHow do I add a highlight annotation to found text?+
quads = page.search_for("important text", quads=True)
    for quad in quads:
        annot = page.add_highlight_annot(quad)
        annot.set_colors(stroke=(1, 1, 0))  # yellow
        annot.update()

Using quads=True gives more precise highlighting, especially for rotated or non-horizontal text.

Forms & Widgets

QHow do I create a fillable form field (widget) in a PDF?+
import pymupdf

    doc = pymupdf.open()
    page = doc.new_page()

    # Create a text input field
    widget = pymupdf.Widget()
    widget.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT
    widget.rect = pymupdf.Rect(50, 50, 250, 80)
    widget.field_name = "name"
    widget.field_value = "Enter name"

    annot = page.add_widget(widget)
    doc.save("form.pdf")
QHow do I create a date field widget?+
widget = pymupdf.Widget()
    widget.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT
    widget.field_flags |= pymupdf.PDF_WIDGET_TX_FORMAT_DATE
    widget.rect = pymupdf.Rect(20, 20, 160, 80)
    widget.field_name = "Date"
    widget.field_value = "12/12/2024"
    annot = page.add_widget(widget)
QFonts in my form fields don't render correctly on mobile devices or non-Adobe readers.+

This is a common problem. PDF viewers that don't have the specified font will substitute or fail to render. The solution is to embed fonts in the PDF. Note that new form fields created by PyMuPDF have certain font restrictions. If you need specific fonts embedded, you may need to work at the xref level:

# After adding a widget:
    annot = page.add_widget(widget)
    xref = annot.xref  # use this to access low-level PDF objects

Fonts

QWhat fonts are available by default without loading external font files?+

The PDF Base-14 fonts are always available:

"helv" (Helvetica), "heit" (Helvetica Italic), "hebo" (Helvetica Bold), "hebi" (Helvetica Bold Italic)

"tiro" (Times Roman), "tiit", "tibo", "tibi"

"cour" (Courier), "coit", "cobo", "cobi"

"symb" (Symbol), "zadb" (ZapfDingbats)

These only support characters up to about Unicode 256. For CJK, extended Latin, Arabic, etc., install pymupdf-fonts or provide your own font files.

QHow do I get the font name of extracted text?+

Use "dict" output format. Each span includes font information:

data = page.get_text("dict")
    for block in data["blocks"]:
        if "lines" not in block:
            continue
        for line in block["lines"]:
            for span in line["spans"]:
                print(f"Font: {span['font']}, Size: {span['size']}")
QIs there a universal fallback font that can render any character?+

No single font covers everything including emojis. FiraGO (available in pymupdf-fonts) covers extended Latin and many scripts not in CJK. The CJK fallback font ("Droid Sans Fallback Regular") covers Chinese, Japanese, and Korean. But you cannot change or extend the fallback font chain. For maximum coverage, use a rich font like FiraGO as your primary and accept that some exotic characters may not render.

Merging & Splitting PDFs

QHow do I extract specific pages from one PDF into a new PDF?+
src = pymupdf.open("input.pdf")
    doc = pymupdf.open()  # new empty PDF
    doc.insert_pdf(src, from_page=0, to_page=4)  # pages 1-5 (0-based)
    doc.save("output.pdf")
QMy output PDF is the same size as the original even though I only extracted 2 pages from 20. Why?+

Different pages often share resources (fonts, images, etc.) that are referenced but not deduplicated on save. Use ez_save() instead of save(), or use save with garbage collection and deflation:

# Best option for size reduction:
    doc.ez_save("output.pdf")

    # Or with explicit options:
    doc.save("output.pdf", garbage=4, deflate=True, clean=True)

clean=True can also help by cleaning content streams, but note this may increase file size for some PDFs (due to decompression of already-compressed streams).

QHow do I overlay one page on top of another (watermark / stamp)?+

Use page.show_pdf_page() to render a source page onto a target page:

src = pymupdf.open("watermark.pdf")
    doc = pymupdf.open("document.pdf")

    for page in doc:
        page.show_pdf_page(page.rect, src, 0)  # overlay page 0 of watermark

    doc.save("stamped.pdf")
Note: insert_pdf() adds new pages. show_pdf_page() overlays content onto an existing page. These are different operations.

Geometry & Coordinates

QWhat is the coordinate system in PyMuPDF? Where is (0,0)?+

The origin (0,0) is at the top-left of the page. X increases to the right, Y increases downward. This matches screen coordinates but differs from the PDF specification (which uses bottom-left origin). PyMuPDF handles the transformation internally.

An A4 page in portrait has dimensions approximately (0, 0, 595, 842) in points (1 point = 1/72 inch).

QWhat's the difference between page.rect, page.mediabox, and page.cropbox?+

page.mediabox — The physical page size as defined in the PDF. This is the largest boundary.

page.cropbox — The visible area when displayed. May be smaller than mediabox. This is what viewers typically show.

page.rect — The effective page rectangle considering rotation. Use this for most operations as it reflects what you actually see.

QWhat does bbox mean and what order are the coordinates?+

A bounding box (bbox) is defined as (x0, y0, x1, y1) where (x0, y0) is the top-left corner and (x1, y1) is the bottom-right corner. This forms a pymupdf.Rect:

rect = pymupdf.Rect(x0, y0, x1, y1)
    print(rect.width)   # x1 - x0
    print(rect.height)  # y1 - y0
    print(rect.tl)      # top-left Point(x0, y0)
    print(rect.br)      # bottom-right Point(x1, y1)
QHow do I check if a word/block is inside a given rectangle?+

Use rectangle containment or intersection:

region = pymupdf.Rect(100, 100, 400, 300)
    word_rect = pymupdf.Rect(word[:4])  # first 4 elements of a "words" tuple

    if word_rect in region:        # fully contained
        print("inside")
    if word_rect.intersects(region):  # overlaps
        print("overlaps")

Performance & Large Files

QHow do I handle very large PDFs without running out of memory?+

Close input/output documents at intervals to free resources. You can also shrink MuPDF's internal cache:

import pymupdf

    # Process in batches
    for i in range(0, total_pages, 50):
        src = pymupdf.open("huge.pdf")
        doc = pymupdf.open()
        doc.insert_pdf(src, from_page=i, to_page=min(i+49, total_pages-1))
        doc.save(f"batch_{i}.pdf")
        doc.close()
        src.close()
        pymupdf.TOOLS.store_shrink(100)  # free MuPDF cache

The major memory consumer is shared resources (fonts, images) that are referenced across pages. Batch processing with intermediate saves helps.

QCan I use multiprocessing with PyMuPDF?+

Yes, but each process needs its own document objects. Don't share pymupdf.Document objects across processes. A common pattern is to split work by page ranges, let each process open the file independently, and combine results afterward.

Note: Threading with GIL release was tested but found to have intolerable overhead. Multiprocessing is the better approach for parallelism.
QCan I use multithreading with PyMuPDF, perhaps with free-threading Python?+

No, PyMuPDF does not support multithreaded use, even with newer free-thread Python.

Making PyMuPDF work with threads is a tricky problem. The underlying MuPDF library only provides partial thread safety so the results would not be as performant as might be naively assumed, and the implementation would inevitably introduce and expose subtle bugs.

Any thread-safe implementation of PyMuPDF would also necessarily impose a single-threaded overhead.

The preferred approach is to use multiple processes instead of multiple threads. This gives most of what is generally required, with simplicity and guaranteed correctness.

Format Conversion

QHow do I convert HTML to PDF?+

Use the Story class:

import pymupdf

    html = """
    <h1>Hello World</h1>
    <p>This is a <b>bold</b> paragraph.</p>
    """

    story = pymupdf.Story(html)
    writer = pymupdf.DocumentWriter("output.pdf")
    mediabox = pymupdf.paper_rect("a4")

    while True:
        device = writer.begin_page(mediabox)
        more, filled = story.place(mediabox + (36, 36, -36, -36))
        story.draw(device)
        writer.end_page()
        if not more:
            break

    writer.close()

The Story class supports HTML and CSS for layout, including fonts, colors, and basic page flow.

QWhat document formats can PyMuPDF open?+

PDF, XPS, EPUB, MOBI, FB2, CBZ, SVG, and various image formats (PNG, JPEG, BMP, TIFF, etc.). All are opened with pymupdf.open(). For image formats, the result is a single-page document.

================================================ FILE: docs/faq.rst ================================================ .. include:: header.rst .. _FAQ: ============================== FAQ ============================== A collection of recipes in “How-To” format for using PyMuPDF. Please see: :ref:`Recipes: Table of Contents` .. include:: footer.rst ================================================ FILE: docs/font.rst ================================================ .. include:: header.rst .. _Font: ================ Font ================ * New in v1.16.18 This class represents a font as defined in |MuPDF| (``fz_font_s`` structure). It is required for the new class :ref:`TextWriter` and the new :meth:`Page.write_text`. Currently, it has no connection to how fonts are used in methods :meth:`Page.insert_text` or :meth:`Page.insert_textbox`, respectively. A ``Font`` object also contains useful general information, like the font bbox, the number of defined glyphs, glyph names or the ``bbox`` of a single glyph. ==================================== ============================================ **Method / Attribute** **Short Description** ==================================== ============================================ :meth:`~Font.glyph_advance` Width of a character :meth:`~Font.glyph_bbox` Glyph rectangle :meth:`~Font.glyph_name_to_unicode` Get unicode from glyph name :meth:`~Font.has_glyph` Return glyph id of unicode :meth:`~Font.text_length` Compute string length :meth:`~Font.char_lengths` Tuple of char widths of a string :meth:`~Font.unicode_to_glyph_name` Get glyph name of a unicode :meth:`~Font.valid_codepoints` Array of supported unicodes :attr:`~Font.ascender` Font ascender :attr:`~Font.descender` Font descender :attr:`~Font.bbox` Font rectangle :attr:`~Font.buffer` Copy of the font's binary image :attr:`~Font.flags` Collection of font properties :attr:`~Font.glyph_count` Number of supported glyphs :attr:`~Font.name` Name of font :attr:`~Font.is_bold` `True` if bold :attr:`~Font.is_monospaced` `True` if mono-spaced :attr:`~Font.is_serif` `True` if serif, `False` if sans-serif :attr:`~Font.is_italic` `True` if italic ==================================== ============================================ **Class API** .. class:: Font .. index:: pair: Font, fontfile pair: Font, fontbuffer pair: Font, script pair: Font, ordering pair: Font, is_bold pair: Font, is_italic pair: Font, is_serif pair: Font, fontname pair: Font, language .. method:: __init__(self, fontname=None, fontfile=None, fontbuffer=None, script=0, language=None, ordering=-1, is_bold=0, is_italic=0, is_serif=0) Font constructor. The large number of parameters are used to locate font, which most closely resembles the requirements. Not all parameters are ever required -- see the below pseudo code explaining the logic how the parameters are evaluated. :arg str fontname: one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a select few other names like (watch the correct spelling): "Arial", "Times", "Times Roman". *(Changed in v1.17.5)* If you have installed `pymupdf-fonts `_, there are also new "reserved" fontnames available, which are listed in :attr:`fitz_fonts` and in the table further down. :arg str fontfile: the filename of a fontfile somewhere on your system [#f1]_. :arg bytes,bytearray,io.BytesIO fontbuffer: a fontfile loaded in memory [#f1]_. :arg in script: the number of a UCDN script. Currently supported in PyMuPDF are numbers 24, and 32 through 35. :arg str language: one of the values "zh-Hant" (traditional Chinese), "zh-Hans" (simplified Chinese), "ja" (Japanese) and "ko" (Korean). Otherwise, all ISO 639 codes from the subsets 1, 2, 3 and 5 are also possible, but are currently documentary only. :arg int ordering: an alternative selector for one of the CJK fonts. :arg bool is_bold: look for a bold font. :arg bool is_italic: look for an italic font. :arg bool is_serif: look for a serifed font. :returns: a |MuPDF| font if successful. This is the overall sequence of checks to determine an appropriate font: =========== ============================================================ Argument Action =========== ============================================================ fontfile? Create font from file, exception if failure. fontbuffer? Create font from buffer, exception if failure. ordering>=0 Create universal font, always succeeds. fontname? Create a Base-14 font, universal font, or font provided by `pymupdf-fonts `_. See table below. =========== ============================================================ .. note:: With the usual reserved names "helv", "tiro", etc., you will create fonts with the expected names "Helvetica", "Times-Roman" and so on. **However**, and in contrast to :meth:`Page.insert_font` and friends, * a font file will **always** be embedded in your PDF, * Greek and Cyrillic characters are supported without needing the *encoding* parameter. Using *ordering >= 0*, or fontnames "cjk", "china-t", "china-s", "japan" or "korea" will **always create the same "universal"** font **"Droid Sans Fallback Regular"**. This font supports **all Chinese, Japanese, Korean and Latin characters**, including Greek and Cyrillic. This is a sans-serif font. Actually, you would rarely ever need another sans-serif font than **"Droid Sans Fallback Regular"**. **Except** that this font file is relatively large and adds about 1.65 MB (compressed) to your PDF file size. If you do not need CJK support, stick with specifying "helv", "tiro" etc., and you will get away with about 35 KB compressed. If you **know** you have a mixture of CJK and Latin text, consider just using `Font("cjk")` because this supports everything and also significantly (by a factor of up to three) speeds up execution: MuPDF will always find any character in this single font and never needs to check fallbacks. But if you do use some other font, you will still automatically be able to also write CJK characters: MuPDF detects this situation and silently falls back to the universal font (which will then of course also be embedded in your PDF). *(New in v1.17.5)* Optionally, some new "reserved" fontname codes become available if you install `pymupdf-fonts `_, `pip install pymupdf-fonts`. **"Fira Mono"** is a mono-spaced sans font set and **FiraGO** is another non-serifed "universal" font set which supports all Latin (including Cyrillic and Greek) plus Thai, Arabian, Hewbrew and Devanagari -- but none of the CJK languages. The size of a FiraGO font is only a quarter of the "Droid Sans Fallback" size (compressed 400 KB vs. 1.65 MB) -- **and** it provides the weights bold, italic, bold-italic -- which the universal font doesn't. **"Space Mono"** is another nice and small mono-spaced font from Google Fonts, which supports Latin Extended characters and comes with all 4 important weights. The following table maps a fontname code to the corresponding font. For the current content of the package please see its documentation: =========== =========================== ======= ============================= Code Fontname New in Comment =========== =========================== ======= ============================= figo FiraGO Regular v1.0.0 narrower than Helvetica figbo FiraGO Bold v1.0.0 figit FiraGO Italic v1.0.0 figbi FiraGO Bold Italic v1.0.0 fimo Fira Mono Regular v1.0.0 fimbo Fira Mono Bold v1.0.0 spacemo Space Mono Regular v1.0.1 spacembo Space Mono Bold v1.0.1 spacemit Space Mono Italic v1.0.1 spacembi Space Mono Bold-Italic v1.0.1 math Noto Sans Math Regular v1.0.2 math symbols music Noto Music Regular v1.0.2 musical symbols symbol1 Noto Sans Symbols Regular v1.0.2 replacement for "symb" symbol2 Noto Sans Symbols2 Regular v1.0.2 extended symbol set notos Noto Sans Regular v1.0.3 alternative to Helvetica notosit Noto Sans Italic v1.0.3 notosbo Noto Sans Bold v1.0.3 notosbi Noto Sans BoldItalic v1.0.3 =========== =========================== ======= ============================= .. index:: pair: Font.has_glyph, language pair: Font.has_glyph, script pair: Font.has_glyph, fallback .. method:: has_glyph(chr, language=None, script=0, fallback=False) Check whether the unicode ``chr`` exists in the font or (option) some fallback font. May be used to check whether any "TOFU" symbols will appear on output. :arg int chr: the unicode of the character (i.e. ``ord()``). :arg str language: the language -- currently unused. :arg int script: the UCDN script number. :arg bool fallback: *(new in v1.17.5)* perform an extended search in fallback fonts or restrict to current font (default). :returns: *(changed in 1.17.7)* the glyph number. Zero indicates no glyph found. .. method:: valid_codepoints() * New in v1.17.5 Return an array of unicodes supported by this font. :returns: an ``array.array`` [#f2]_ of length at most :attr:`Font.glyph_count`. I.e. ``chr()`` of every item in this array has a glyph in the font without using fallbacks. This is an example display of the supported glyphs: >>> import pymupdf >>> font = pymupdf.Font("math") >>> vuc = font.valid_codepoints() >>> for i in vuc: >>> print(f"{i:04X} {chr(i)} ({font.unicode_to_glyph_name(i)})") 0000 000D (CR) 0020 (space) 0021 ! (exclam) 0022 " (quotedbl) 0023 # (numbersign) 0024 $ (dollar) 0025 % (percent) ... 00AC ¬ (logicalnot) 00B1 ± (plusminus) ... 21D0 ⇐ (arrowdblleft) 21D1 ⇑ (arrowdblup) 21D2 ⇒ (arrowdblright) 21D3 ⇓ (arrowdbldown) 21D4 ⇔ (arrowdblboth) ... 221E ∞ (infinity) ... .. note:: This method only returns meaningful data for fonts having a CMAP (character map, charmap, the `/ToUnicode` PDF key). Otherwise, this array will have length 1 and contain zero only. .. index:: pair: Font.glyph_advance, language pair: Font.glyph_advance, script pair: Font.glyph_advance, wmode .. method:: glyph_advance(chr, language=None, script=0, wmode=0) Calculate the "width" of the character's glyph (visual representation). :arg int chr: the unicode number of the character. Use ``ord()``, not the character itself. Again, this should normally work even if a character is not supported by that font, because fallback fonts will be checked where necessary. :arg int wmode: write mode, ``0`` = horizontal, ``1`` = vertical. The other parameters are not in use currently. :returns: a float representing the glyph's width relative to **fontsize 1**. .. method:: glyph_name_to_unicode(name) Return the unicode value for a given glyph name. Use it in conjunction with `chr()` if you want to output e.g. a certain symbol. :arg str name: The name of the glyph. :returns: The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: `font.glyph_name_to_unicode("Sigma") = 931`, `font.glyph_name_to_unicode("sigma") = 963`. Refer to the `Adobe Glyph List `_ publication for a list of glyph names and their unicode numbers. Example: >>> font = pymupdf.Font("helv") >>> font.has_glyph(font.glyph_name_to_unicode("infinity")) True .. index:: pair: Font.glyph_bbox, language pair: Font.glyph_bbox, script .. method:: glyph_bbox(chr, language=None, script=0) The glyph rectangle relative to :data:`fontsize` 1. :arg int chr: ``ord()`` of the character. :returns: a :ref:`Rect`. .. method:: unicode_to_glyph_name(ch) Show the name of the character's glyph. :arg int ch: the unicode number of the character. Use ``ord()``, not the character itself. :returns: a string representing the glyph's name. E.g. `font.glyph_name(ord("#")) = "numbersign"`. For an invalid code ".notfound" is returned. .. note:: *(Changed in v1.18.0)* This method and :meth:`Font.glyph_name_to_unicode` no longer depend on a font and instead retrieve information from the **Adobe Glyph List**. Also available as `pymupdf.unicode_to_glyph_name()` and resp. `pymupdf.glyph_name_to_unicode()`. .. index:: pair: text_length, fontsize .. method:: text_length(text, fontsize=11) Calculate the length in points of a unicode string. .. note:: There is a functional overlap with :meth:`get_text_length` for Base-14 fonts only. :arg str text: a text string, UTF-8 encoded. :arg float fontsize: the :data:`fontsize`. :rtype: float :returns: the length of the string in points when stored in the PDF. If a character is not contained in the font, it will automatically be looked up in a fallback font. .. note:: This method was originally implemented in Python, based on calling :meth:`Font.glyph_advance`. For performance reasons, it has been rewritten in C for v1.18.14. To compute the width of a single character, you can now use either of the following without performance penalty: 1. `font.glyph_advance(ord("Ä")) * fontsize` 2. `font.text_length("Ä", fontsize=fontsize)` For multi-character strings, the method offers a huge performance advantage compared to the previous implementation: instead of about 0.5 microseconds for each character, only 12.5 nanoseconds are required for the second and subsequent ones. .. index:: pair: char_lengths, fontsize .. method:: char_lengths(text, fontsize=11) *New in v1.18.14* Sequence of character lengths in points of a unicode string. :arg str text: a text string, UTF-8 encoded. :arg float fontsize: the :data:`fontsize`. :rtype: tuple :returns: the lengths in points of the characters of a string when stored in the PDF. It works like :meth:`Font.text_length` broken down to single characters. This is a high speed method, used e.g. in :meth:`TextWriter.fill_textbox`. The following is true (allowing rounding errors): `font.text_length(text) == sum(font.char_lengths(text))`. >>> font = pymupdf.Font("helv") >>> text = "PyMuPDF" >>> font.text_length(text) 50.115999937057495 >>> pymupdf.get_text_length(text, fontname="helv") 50.115999937057495 >>> sum(font.char_lengths(text)) 50.115999937057495 >>> pprint(font.char_lengths(text)) (7.336999952793121, # P 5.5, # y 9.163000047206879, # M 6.115999937057495, # u 7.336999952793121, # P 7.942000031471252, # D 6.721000015735626) # F .. attribute:: buffer * New in v1.17.6 Copy of the binary font file content. :rtype: bytes .. attribute:: flags A dictionary with various font properties, each represented as bools. Example for Helvetica:: >>> pprint(font.flags) {'bold': 0, 'fake-bold': 0, 'fake-italic': 0, 'invalid-bbox': 0, 'italic': 0, 'mono': 0, 'opentype': 0, 'serif': 1, 'stretch': 0, 'substitute': 0} :rtype: dict .. attribute:: name :rtype: str Name of the font. May be "" or "(null)". .. attribute:: bbox The font bbox. This is the maximum of its glyph bboxes. :rtype: :ref:`Rect` .. attribute:: glyph_count :rtype: int The number of glyphs defined in the font. .. attribute:: ascender * New in v1.18.0 The ascender value of the font, see `ascender typography `_ for details. Please note that there is a difference to the strict definition: our value includes everything above the baseline -- not just the height difference between upper case "A" and and lower case "a". :rtype: float .. attribute:: descender * New in v1.18.0 The descender value of the font, see `descender typography `_ for details. This value always is negative and is the portion that some glyphs descend below the base line, for example "g" or "y". As a consequence, the value `ascender - descender` is the total height, that every glyph of the font fits into. This is true at least for most fonts -- as always, there are exceptions, especially for calligraphic fonts, etc. :rtype: float .. attribute:: is_bold .. attribute:: is_italic .. attribute:: is_monospaced .. attribute:: is_serif A number of attributes with obvious meanings. Reflect some values of the :attr:`Font.flags` dictionary. :rtype: bool .. rubric:: Footnotes .. [#f1] MuPDF does not support all fontfiles with this feature and will raise exceptions like *"mupdf: FT_New_Memory_Face((null)): unknown file format"*, if it encounters issues. .. [#f2] The built-in Python module `array` has been chosen for its speed and low memory requirement. .. include:: footer.rst ================================================ FILE: docs/footer.rst ================================================ .. _documentation_footer: ---- .. raw:: html

This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.

.. rst-class:: footer-version This documentation covers all versions up to |version|. .. External Links: .. _pdf2docx: https://pdf2docx.readthedocs.io/en/latest/ .. _pdf2docx extract tables method: https://pdf2docx.readthedocs.io/en/latest/quickstart.table.html ================================================ FILE: docs/functions.rst ================================================ .. include:: header.rst ============ Functions ============ The following are miscellaneous functions and attributes on a fairly low-level technical detail. Some functions provide detail access to PDF structures. Others are stripped-down, high performance versions of other functions which provide more information. Yet others are handy, general-purpose utilities. ==================================== ============================================================== **Function** **Short Description** ==================================== ============================================================== :attr:`Annot.apn_bbox` PDF only: bbox of the appearance object :attr:`Annot.apn_matrix` PDF only: the matrix of the appearance object :attr:`Page.is_wrapped` check whether contents wrapping is present :meth:`adobe_glyph_names` list of glyph names defined in **Adobe Glyph List** :meth:`adobe_glyph_unicodes` list of unicodes defined in **Adobe Glyph List** :meth:`Annot.clean_contents` PDF only: clean the annot's :data:`contents` object :meth:`Annot.set_apn_bbox` PDF only: set the bbox of the appearance object :meth:`Annot.set_apn_matrix` PDF only: set the matrix of the appearance object :meth:`ConversionHeader` return header string for *get_text* methods :meth:`ConversionTrailer` return trailer string for *get_text* methods :meth:`Document.del_xml_metadata` PDF only: remove XML metadata :meth:`Document.get_char_widths` PDF only: return a list of glyph widths of a font :meth:`Document.get_new_xref` PDF only: create and return a new :data:`xref` entry :meth:`Document.is_stream` PDF only: check whether an :data:`xref` is a stream object :meth:`Document.xml_metadata_xref` PDF only: return XML metadata :data:`xref` number :meth:`Document.xref_length` PDF only: return length of :data:`xref` table :meth:`EMPTY_IRECT` return the (standard) empty / invalid rectangle :meth:`EMPTY_QUAD` return the (standard) empty / invalid quad :meth:`EMPTY_RECT` return the (standard) empty / invalid rectangle :meth:`get_pdf_now` return the current timestamp in PDF format :meth:`get_pdf_str` return PDF-compatible string :meth:`get_text_length` return string length for a given font & :data:`fontsize` :meth:`glyph_name_to_unicode` return unicode from a glyph name :meth:`image_profile` return a dictionary of basic image properties :meth:`INFINITE_IRECT` return the (only existing) infinite rectangle :meth:`INFINITE_QUAD` return the (only existing) infinite quad :meth:`INFINITE_RECT` return the (only existing) infinite rectangle :meth:`make_table` split rectangle in sub-rectangles :meth:`Page.clean_contents` PDF only: clean the page's :data:`contents` objects :meth:`Page.get_bboxlog` list of rectangles that envelop text, drawing or image objects :meth:`Page.get_contents` PDF only: return a list of content :data:`xref` numbers :meth:`Page.get_displaylist` create the page's display list :meth:`Page.get_text_blocks` extract text blocks as a Python list :meth:`Page.get_text_words` extract text words as a Python list :meth:`Page.get_texttrace` low-level text information :meth:`Page.read_contents` PDF only: get complete, concatenated /Contents source :meth:`Page.run` run a page through a device :meth:`Page.set_contents` PDF only: set page's :data:`contents` to some :data:`xref` :meth:`Page.wrap_contents` wrap contents with stacking commands :meth:`css_for_pymupdf_font` create CSS source for a font in package pymupdf_fonts :meth:`paper_rect` return rectangle for a known paper format :meth:`paper_size` return width, height for a known paper format :meth:`paper_sizes` dictionary of pre-defined paper formats :meth:`planish_line` matrix to map a line to the x-axis :meth:`recover_char_quad` compute the quad of a char ("rawdict") :meth:`recover_line_quad` compute the quad of a subset of line spans :meth:`recover_quad` compute the quad of a span ("dict", "rawdict") :meth:`recover_span_quad` compute the quad of a subset of span characters :meth:`set_messages` set destination of |PyMuPDF| messages. :meth:`sRGB_to_pdf` return PDF RGB color tuple from an sRGB integer :meth:`sRGB_to_rgb` return (R, G, B) color tuple from an sRGB integer :meth:`unicode_to_glyph_name` return glyph name from a unicode :meth:`get_tessdata` locates the language support of the Tesseract-OCR installation :meth:`colors_pdf_dict` return dict of color names. :meth:`colors_wx_list` return list of color names. :attr:`fitz_fontdescriptors` dictionary of available supplement fonts :attr:`PYMUPDF_MESSAGE` destination of |PyMuPDF| messages. :attr:`pdfcolor` dictionary of almost 500 RGB colors in PDF format. ==================================== ============================================================== .. method:: paper_size(s) Convenience function to return width and height of a known paper format code. These values are given in pixels for the standard resolution 72 pixels = 1 inch. Currently defined formats include **'A0'** through **'A10'**, **'B0'** through **'B10'**, **'C0'** through **'C10'**, **'Card-4x6'**, **'Card-5x7'**, **'Commercial'**, **'Executive'**, **'Invoice'**, **'Ledger'**, **'Legal'**, **'Legal-13'**, **'Letter'**, **'Monarch'** and **'Tabloid-Extra'**, each in either portrait or landscape format. A format name must be supplied as a string (case **in** \sensitive), optionally suffixed with "-L" (landscape) or "-P" (portrait). No suffix defaults to portrait. :arg str s: any format name from above in upper or lower case, like *"A4"* or *"letter-l"*. :rtype: tuple :returns: *(width, height)* of the paper format. For an unknown format *(-1, -1)* is returned. Examples: *pymupdf.paper_size("A4")* returns *(595, 842)* and *pymupdf.paper_size("letter-l")* delivers *(792, 612)*. ----- .. method:: paper_rect(s) Convenience function to return a :ref:`Rect` for a known paper format. :arg str s: any format name supported by :meth:`paper_size`. :rtype: :ref:`Rect` :returns: *pymupdf.Rect(0, 0, width, height)* with *width, height=pymupdf.paper_size(s)*. >>> import pymupdf >>> pymupdf.paper_rect("letter-l") pymupdf.Rect(0.0, 0.0, 792.0, 612.0) >>> ----- .. method:: set_messages(*, text=None, fd=None, stream=None, path=None, path_append=None, pylogging=None, pylogging_logger=None, pylogging_level=None, pylogging_name=None, ) Sets destination of |PyMuPDF| messages to a file descriptor, a file, an existing stream or `Python's logging system `_. Usually one would only set one arg, or one or more `pylogging*` args. :arg str text: A text specification of destination; for details see description of environmental variable `PYMUPDF_MESSAGE`. :arg int fd: Write to file descriptor. :arg stream: Write to existing stream, which must have methods `.write(text)` and `.flush()`. :arg str path: Write to a file. :arg str path_append: Append to a file. :arg pylogging: Write to Python's `logging` system. :arg logging.Logger pylogging_logger: Write to Python's `logging` system using specified Logger. :arg int pylogging_level: Write to Python's `logging` system using specified level. :arg str pylogging_name: Write to Python's `logging` system using specified logger name. Only used if `pylogging_logger` is ``None``. Default is `pymupdf`. If any `pylogging*` arg is not ``None``, we write to `Python's logging system `_. ----- .. method:: sRGB_to_pdf(srgb) *New in v1.17.4* Convenience function returning a PDF color triple (red, green, blue) for a given sRGB color integer as it occurs in :meth:`Page.get_text` dictionaries "dict" and "rawdict". :arg int srgb: an integer of format RRGGBB, where each color component is an integer in range(255). :returns: a tuple (red, green, blue) with float items in interval *0 <= item <= 1* representing the same color. Example `sRGB_to_pdf(0xff0000) = (1, 0, 0)` (red). ----- .. method:: sRGB_to_rgb(srgb) *New in v1.17.4* Convenience function returning a color (red, green, blue) for a given *sRGB* color integer. :arg int srgb: an integer of format RRGGBB, where each color component is an integer in range(255). :returns: a tuple (red, green, blue) with integer items in `range(256)` representing the same color. Example `sRGB_to_pdf(0xff0000) = (255, 0, 0)` (red). ----- .. method:: glyph_name_to_unicode(name) *New in v1.18.0* Return the unicode number of a glyph name based on the **Adobe Glyph List**. :arg str name: the name of some glyph. The function is based on the `Adobe Glyph List `_. :rtype: int :returns: the unicode. Invalid ``name`` entries return `0xfffd (65533)`. .. note:: A similar functionality is provided by package `fontTools `_ in its *agl* sub-package. ----- .. method:: unicode_to_glyph_name(ch) *New in v1.18.0* Return the glyph name of a unicode number, based on the **Adobe Glyph List**. :arg int ch: the unicode given by e.g. `ord("ß")`. The function is based on the `Adobe Glyph List `_. :rtype: str :returns: the glyph name. E.g. `pymupdf.unicode_to_glyph_name(ord("Ä"))` returns `'Adieresis'`. .. note:: A similar functionality is provided by package `fontTools `_: in its *agl* sub-package. ----- .. method:: adobe_glyph_names() *New in v1.18.0* Return a list of glyph names defined in the **Adobe Glyph List**. :rtype: list :returns: list of strings. .. note:: A similar functionality is provided by package `fontTools `_ in its *agl* sub-package. ----- .. method:: adobe_glyph_unicodes() *New in v1.18.0* Return a list of unicodes for there exists a glyph name in the **Adobe Glyph List**. :rtype: list :returns: list of integers. .. note:: A similar functionality is provided by package `fontTools `_ in its *agl* sub-package. ----- .. method:: css_for_pymupdf_font(fontcode, *, CSS=None, archive=None, name=None) *New in v1.21.0* **Utility function for use with "Story" applications.** Create CSS `@font-face` items for the given fontcode in pymupdf-fonts. Creates a CSS font-family for all fonts starting with string "fontcode". The font naming convention in package pymupdf-fonts is "fontcode", where the suffix "sf" is one of "" (empty), "it"/"i", "bo"/"b" or "bi". These suffixes thus represent the regular, italic, bold or bold-italic variants of that font. For example, font code "notos" refers to fonts * "notos" - "Noto Sans Regular" * "notosit" - "Noto Sans Italic" * "notosbo" - "Noto Sans Bold" * "notosbi" - "Noto Sans Bold Italic" The function creates (up to) four CSS `@font-face` definitions and collectively assigns the `font-family` name "notos" to them (or the "name" value if provided). Associated font buffers are placed / added to the provided archive. To use the font in the Python API for :ref:`Story`, execute `.set_font(fontcode)` (or "name" if given). The correct font weight or style will automatically be selected as required. For example to replace the "sans-serif" HTML standard (i.e. Helvetica) with the above "notos", execute the following. Whenever "sans-serif" is used (whether explicitly or implicitly), the Noto Sans fonts will be selected. `CSS = pymupdf.css_for_pymupdf_font("notos", name="sans-serif", archive=...)` Expects and returns the CSS source, with the new CSS definitions appended. :arg str fontcode: one of the font codes present in package `pymupdf-fonts `_ (usually) representing the regular version of the font family. :arg str CSS: any already existing CSS source, or `None`. The function will append its new definitions to this. This is the string that **must be used** as `user_css` when creating the :ref:`Story`. :arg archive: :ref:`Archive`, **mandatory**. All font binaries (i.e. up to four) found for "fontcode" will be added to the archive. This is the archive that **must be used** as `archive` when creating the :ref:`Story`. :arg str name: the name under which the "fontcode" fonts should be found. If omitted, "fontcode" will be used. :rtype: str :returns: Modified CSS, with appended `@font-face` statements for each font variant of fontcode. Fontbuffers associated with "fontcode" will have been added to 'archive'. The function will automatically find up to 4 font variants. All pymupdf-fonts (that are no special purpose like math or music, etc.) have regular, bold, italic and bold-italic variants. To see currently available font codes check `pymupdf.fitz_fontdescriptors.keys()`. This will show something like `dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', 'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', 'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', 'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', 'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])`. Here is a complete snippet for using the "Noto Sans" font instead of "Helvetica":: arch = pymupdf.Archive() CSS = pymupdf.css_for_pymupdf_font("notos", name="sans-serif", archive=arch) story = pymupdf.Story(user_css=CSS, archive=arch) ----- .. _Functions_make_table: .. method:: make_table(rect, cols=1, rows=1) *New in v1.17.4* Convenience function to split a rectangle into sub-rectangles of equal size. Returns a list of `rows` lists, each containing `cols` :ref:`Rect` items. Each sub-rectangle can then be addressed by its row and column index. :arg rect_like rect: the rectangle to split. :arg int cols: the desired number of columns. :arg int rows: the desired number of rows. :returns: a list of :ref:`Rect` objects of equal size, whose union equals *rect*. Here is the layout of a 3x4 table created by `cell = pymupdf.make_table(rect, cols=4, rows=3)`: .. image:: images/img-make-table.* :scale: 60 ----- .. method:: planish_line(p1, p2) * New in version 1.16.2)* Return a matrix which maps the line from p1 to p2 to the x-axis such that p1 will become (0,0) and p2 a point with the same distance to (0,0). :arg point_like p1: starting point of the line. :arg point_like p2: end point of the line. :rtype: :ref:`Matrix` :returns: a matrix which combines a rotation and a translation:: >>> p1 = pymupdf.Point(1, 1) >>> p2 = pymupdf.Point(4, 5) >>> abs(p2 - p1) # distance of points 5.0 >>> m = pymupdf.planish_line(p1, p2) >>> p1 * m Point(0.0, 0.0) >>> p2 * m Point(5.0, -5.960464477539063e-08) >>> # distance of the resulting points >>> abs(p2 * m - p1 * m) 5.0 .. image:: images/img-planish.png :scale: 40 ----- .. method:: paper_sizes A dictionary of pre-defines paper formats. Used as basis for :meth:`paper_size`. ----- .. attribute:: fitz_fontdescriptors * New in v1.17.5 A dictionary of usable fonts from repository `pymupdf-fonts `_. Items are keyed by their reserved fontname and provide information like this:: In [2]: pymupdf.fitz_fontdescriptors.keys() Out[2]: dict_keys(['figbo', 'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', 'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2']) In [3]: pymupdf.fitz_fontdescriptors["fimo"] Out[3]: {'name': 'Fira Mono Regular', 'size': 125712, 'mono': True, 'bold': False, 'italic': False, 'serif': True, 'glyphs': 1485} If `pymupdf-fonts` is not installed, the dictionary is empty. The dictionary keys can be used to define a :ref:`Font` via e.g. `font = pymupdf.Font("fimo")` -- just like you can do it with the builtin fonts "Helvetica" and friends. ----- .. attribute:: PYMUPDF_MESSAGE If in `os.environ` when |PyMuPDF| is imported, sets destination of |PyMuPDF| messages. Otherwise messages are sent to `sys.stdout`. * If the value starts with `fd:`, the remaining text should be an integer file descriptor to which messages are written. * For example `PYMUPDF_MESSAGE=fd:2` will send messages to stderr. * If the value starts with `path:`, the remaining text is the path of a file to which messages are written. If the file already exists, it is truncated. * If the value starts with `path+:`, the remaining text is the path of file to which messages are written. If the file already exists, we append output. * If the value starts with `logging:`, messages are written to `Python's logging system `_. The remaining text can contain comma-separated name=value items: * `level=` sets the logging level. * `name=` sets the logger name (default is `pymupdf`). Other items are ignored. * Other prefixes will cause an error. Also see `set_messages()`. ----- .. attribute:: pdfcolor * New in v1.19.6 Contains about 500 RGB colors in PDF format with the color name as key. To see what is there, you can obviously look at `pymupdf.pdfcolor.keys()`. Examples: * `pymupdf.pdfcolor["red"] = (1.0, 0.0, 0.0)` * `pymupdf.pdfcolor["skyblue"] = (0.5294117647058824, 0.807843137254902, 0.9215686274509803)` * `pymupdf.pdfcolor["wheat"] = (0.9607843137254902, 0.8705882352941177, 0.7019607843137254)` ----- .. method:: get_pdf_now() Convenience function to return the current local timestamp in PDF compatible format, e.g. *D:20170501121525-04'00'* for local datetime May 1, 2017, 12:15:25 in a timezone 4 hours westward of the UTC meridian. :rtype: str :returns: current local PDF timestamp. ----- .. method:: get_text_length(text, fontname="helv", fontsize=11, encoding=TEXT_ENCODING_LATIN) * New in version 1.14.7 Calculate the length of text on output with a given **builtin** font, :data:`fontsize` and encoding. :arg str text: the text string. :arg str fontname: the font name. Must be one of either the :ref:`Base-14-Fonts` or the CJK fonts, identified by their "reserved" fontnames (see table in :meth:`Page.insert_font`). :arg float fontsize: the :data:`fontsize`. :arg int encoding: the encoding to use. Besides 0 = Latin, 1 = Greek and 2 = Cyrillic (Russian) are available. Relevant for Base-14 fonts "Helvetica", "Courier" and "Times" and their variants only. Make sure to use the same value as in the corresponding text insertion. :rtype: float :returns: the length in points the string will have (e.g. when used in :meth:`Page.insert_text`). .. note:: This function will only do the calculation -- it won't insert font nor text. .. note:: The :ref:`Font` class offers a similar method, :meth:`Font.text_length`, which supports Base-14 fonts and any font with a character map (CMap, Type 0 fonts). .. warning:: If you use this function to determine the required rectangle width for the (:ref:`Page` or :ref:`Shape`) *insert_textbox* methods, be aware that they calculate on a **by-character level**. Because of rounding effects, this will mostly lead to a slightly larger number: *sum([pymupdf.get_text_length(c) for c in text]) > pymupdf.get_text_length(text)*. So either (1) do the same, or (2) use something like *pymupdf.get_text_length(text + "'")* for your calculation. ----- .. method:: get_pdf_str(text) Make a PDF-compatible string: if the text contains code points *ord(c) > 255*, then it will be converted to UTF-16BE with BOM as a hexadecimal character string enclosed in "<>" brackets like **. Otherwise, it will return the string enclosed in (round) brackets, replacing any characters outside the ASCII range with some special code. Also, every "(", ")" or backslash is escaped with a backslash. :arg str text: the object to convert :rtype: str :returns: PDF-compatible string enclosed in either *()* or *<>*. ----- .. method:: image_profile(stream) * New in v1.16.7 * Changed in v1.19.5: also return natural image orientation extracted from EXIF data if present. * Changed in v1.22.5: always return `None` in error cases instead of an empty dictionary. Show important properties of an image provided as a memory area. Its main purpose is to avoid using other Python packages just to determine them. :arg bytes|bytearray|BytesIO|file stream: either an image in memory or an **opened** file. An image in memory may be any of the formats `bytes`, `bytearray` or `io.BytesIO`. :rtype: dict :returns: No exception is ever raised. In case of an error, `None` is returned. Otherwise, there are the following items:: In [2]: pymupdf.image_profile(open("nur-ruhig.jpg", "rb").read()) Out[2]: {'width': 439, 'height': 501, 'orientation': 0, # natural orientation (from EXIF) 'transform': (1.0, 0.0, 0.0, 1.0, 0.0, 0.0), # orientation matrix 'xres': 96, 'yres': 96, 'colorspace': 3, 'bpc': 8, 'ext': 'jpeg', 'cs-name': 'DeviceRGB'} There is the following relation to **Exif** information encoded in `orientation`, and correspondingly in the `transform` matrix-like (quoted from MuPDF documentation, *ccw* = counter-clockwise): 0. Undefined 1. 0 degree ccw rotation. (Exif = 1) 2. 90 degree ccw rotation. (Exif = 8) 3. 180 degree ccw rotation. (Exif = 3) 4. 270 degree ccw rotation. (Exif = 6) 5. flip on X. (Exif = 2) 6. flip on X, then rotate ccw by 90 degrees. (Exif = 5) 7. flip on X, then rotate ccw by 180 degrees. (Exif = 4) 8. flip on X, then rotate ccw by 270 degrees. (Exif = 7) .. note:: * For some "exotic" images (FAX encodings, RAW formats and the like), this method will not work. You can however still work with such images in PyMuPDF, e.g. by using :meth:`Document.extract_image` or create pixmaps via `Pixmap(doc, xref)`. These methods will automatically convert exotic images to the PNG format before returning results. * You can also get the properties of images embedded in a PDF, via their :data:`xref`. In this case make sure to extract the raw stream: `pymupdf.image_profile(doc.xref_stream_raw(xref))`. * Images as returned by the image blocks of :meth:`Page.get_text` using "dict" or "rawdict" options are also supported. ----- .. method:: ConversionHeader("text", filename="UNKNOWN") Return the header string required to make a valid document out of page text outputs. :arg str output: type of document. Use the same as the output parameter of *get_text()*. :arg str filename: optional arbitrary name to use in output types "json" and "xml". :rtype: str ----- .. method:: ConversionTrailer(output) Return the trailer string required to make a valid document out of page text outputs. See :meth:`Page.get_text` for an example. :arg str output: type of document. Use the same as the output parameter of *get_text()*. :rtype: str ----- .. method:: Document.del_xml_metadata() Delete an object containing XML-based metadata from the PDF. (Py-) MuPDF does not support XML-based metadata. Use this if you want to make sure that the conventional metadata dictionary will be used exclusively. Many thirdparty PDF programs insert their own metadata in XML format and thus may override what you store in the conventional dictionary. This method deletes any such reference, and the corresponding PDF object will be deleted during next garbage collection of the file. ----- .. method:: Document.xml_metadata_xref() Return the XML-based metadata :data:`xref` of the PDF if present -- also refer to :meth:`Document.del_xml_metadata`. You can use it to retrieve the content via :meth:`Document.xref_stream` and then work with it using some XML software. :rtype: int :returns: :data:`xref` of PDF file level XML metadata -- or 0 if none exists. ----- .. method:: Page.run(dev, transform) Run a page through a device. :arg dev: Device, obtained from one of the :ref:`Device` constructors. :type dev: :ref:`Device` :arg transform: Transformation to apply to the page. Set it to :ref:`Identity` if no transformation is desired. :type transform: :ref:`Matrix` ----- .. method:: Page.get_bboxlog(layers=False) * New in v1.19.0 * Changed in v1.22.0: optionally also return the OCG name applicable to the boundary box. :returns: a list of rectangles that envelop text, image or drawing objects. Each item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple consists of rectangle coordinates, and *type* is one of the following values. If `layers=True`, there is a third item containing the OCG name or `None`: `(type, (x0, y0, x1, y1), None)`. * `"fill-text"` -- normal text (painted without character borders) * `"stroke-text"` -- text showing character borders only * `"ignore-text"` -- text that should not be displayed (e.g. as used by OCR text layers) * `"fill-path"` -- drawing with fill color (and no border) * `"stroke-path"` -- drawing with border (and no fill color) * `"fill-image"` -- displays an image * `"fill-shade"` -- display a shading The item sequence represents the **sequence in which these commands are executed** to build the page's appearance. Therefore, if an item's bbox intersects or contains that of a previous item, then the previous item may be (partially) covered / hidden. So this list can be used to detect such situations. An item's index in this list equals the value of a `"seqno"` in dictionaries as returned by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`. ----- .. method:: Page.get_texttrace() * New in v1.18.16 * Changed in v1.19.0: added key "seqno". * Changed in v1.19.1: stroke and fill colors now always are either RGB or GRAY * Changed in v1.19.3: span and character bboxes are now also correct if `dir != (1, 0)`. * Changed in v1.22.0: add new dictionary key "layer". Return low-level text information of the page. The method is available for **all** document types. The result is a list of Python dictionaries with the following content:: { 'ascender': 0.83251953125, # font ascender (1) 'bbox': (458.14019775390625, # span bbox x0 (7) 749.4671630859375, # span bbox y0 467.76458740234375, # span bbox x1 757.5071411132812), # span bbox y1 'bidi': 0, # bidirectional level (1) 'chars': ( # char information, tuple[tuple] (45, # unicode (4) 16, # glyph id (font dependent) (458.14019775390625, # origin.x (1) 755.3758544921875), # origin.y (1) (458.14019775390625, # char bbox x0 (6) 749.4671630859375, # char bbox y0 462.9649963378906, # char bbox x1 757.5071411132812)), # char bbox y1 ( ... ), # more characters ), 'color': (0.0,), # text color, tuple[float] (1) 'colorspace': 1, # number of colorspace components (1) 'descender': -0.30029296875, # font descender (1) 'dir': (1.0, 0.0), # writing direction (1) 'flags': 12, # font flags (1) 'font': 'CourierNewPSMT', # font name (1) 'linewidth': 0.4019999980926514, # current line width value (3) 'opacity': 1.0, # alpha value of the text (5) 'layer': None, # name of Optional Content Group (9) 'seqno': 246, # sequence number (8) 'size': 8.039999961853027, # font size (1) 'spacewidth': 4.824785133358091, # width of space char 'type': 0, # span type (2) 'wmode': 0 # writing mode (1) } Details: 1. Information above tagged with "(1)" has the same meaning and value as explained in :ref:`TextPage`. - Please note that the font ``flags`` value will never contain a *superscript* flag bit: the detection of superscripts is done within MuPDF :ref:`TextPage` code -- it is not a property of any font. - Also note, that the text *color* is encoded as the usual tuple of floats 0 <= f <= 1 -- not in sRGB format. Depending on `span["type"]`, interpret this as fill color or stroke color. 2. There are 3 text span types: - 0: Filled text -- equivalent to PDF text rendering mode 0 (`0 Tr`, the default in PDF), only each character's "inside" is shown. - 1: Stroked text -- equivalent to `1 Tr`, only the character borders are shown. - 3: Ignored text -- equivalent to `3 Tr` (hidden text). 3. Line width in this context is important only for processing `span["type"] != 0`: it determines the thickness of the character's border line. This value may not be provided at all with the text data. In this case, a value of 5% of the :data:`fontsize` (`span["size"] * 0,05`) is generated. Often, an "artificial" bold text in PDF is created by `2 Tr`. There is no equivalent span type for this case. Instead, respective text is represented by two consecutive spans -- which are identical in every aspect, except for their types, which are 0, resp 1. It is your responsibility to handle this type of situation - in :meth:`Page.get_text`, MuPDF is doing this for you. 4. For data compactness, the character's unicode is provided here. Use built-in function `chr()` for the character itself. 5. The alpha / opacity value of the span's text, `0 <= opacity <= 1`, 0 is invisible text, 1 (100%) is intransparent. Depending on `span["type"]`, interpret this value as *fill* opacity or, resp. *stroke* opacity. 6. *(Changed in v1.19.0)* This value is equal or close to `char["bbox"]` of "rawdict". In particular, the bbox **height** value is always computed as if **"small glyph heights"** had been requested. 7. *(New in v1.19.0)* This is the union of all character bboxes. 8. *(New in v1.19.0)* Enumerates the commands that build up the page's appearance. Can be used to find out whether text is effectively hidden by objects, which are painted "later", or *over* some object. So if there is a drawing or image with a higher sequence number, whose bbox overlaps (parts of) this text span, one may assume that such an object hides the resp. text. Different text spans have identical sequence numbers if they were created in one go. 9. *(New in v1.22.0)* The name of the Optional Content Group (OCG) if applicable or `None`. Here is a list of similarities and differences of `page.get_texttrace()` compared to `page.get_text("rawdict")`: * The method is up to **twice as fast,** compared to "rawdict" extraction. Depends on the amount of text. * The returned data is very **much smaller in size** -- although it provides more information. * Additional types of text **invisibility can be detected**: opacity = 0 or type > 1 or overlapping bbox of an object with a higher sequence number. * If MuPDF returns unicode 0xFFFD (65533) for unrecognized characters, you may still be able to deduct desired information from the glyph id. * The `span["chars"]` **contains no spaces**, **except** the document creator has explicitly coded them. They **will never be generated** like it happens in :meth:`Page.get_text` methods. To provide some help for doing your own computations here, the width of a space character is given. This value is derived from the font where possible. Otherwise the value of a fallback font is taken. * There is no effort to organize text like it happens for a :ref:`TextPage` (the hierarchy of blocks, lines, spans, and characters). Characters are simply extracted in sequence, one by one, and put in a span. Whenever any of the span's characteristics changes, a new span is started. So you may find characters with different `origin.y` values in the same span (which means they would appear in different lines). You cannot assume, that span characters are sorted in any particular order -- you must make sense of the info yourself, taking `span["dir"]`, `span["wmode"]`, etc. into account. * Ligatures are represented like this: - MuPDF handles the following ligatures: "fi", "ff", "fl", "ft", "st", "ffi", and "ffl" (only the first 3 are mostly ever used). If the page contains e.g. ligature "fi", you will find the following two character items subsequent to each other:: (102, glyph, (x, y), (x0, y0, x1, y1)) # 102 = ord("f") (105, -1, (x, y), (x0, y0, x0, y1)) # 105 = ord("i"), empty bbox! - This means that the bbox of the first ligature character is the area containing the complete, compound glyph. Subsequent ligature components are recognizable by their glyph value -1 and a bbox of width zero. - You may want to replace those 2 or 3 char tuples by one, that represents the ligature itself. Use the following mapping of ligatures to unicodes: + `"ff" -> 0xFB00` + `"fi" -> 0xFB01` + `"fl" -> 0xFB02` + `"ffi" -> 0xFB03` + `"ffl" -> 0xFB04` + `"ft" -> 0xFB05` + `"st" -> 0xFB06` So you may want to replace the two example tuples above by the following single one: `(0xFB01, glyph, (x, y), (x0, y0, x1, y1))` (there is usually no need to lookup the correct glyph id for 0xFB01 in the resp. font, but you may execute `font.has_glyph(0xFB01)` and use its return value). * **Changed in v1.19.3:** Similar to other text extraction methods, the character and span bboxes envelop the character quads. To recover the quads, follow the same methods :meth:`recover_quad`, :meth:`recover_char_quad` or :meth:`recover_span_quad` as explained in :ref:`textpagedict`. Use either `None` or `span["dir"]` for the writing direction. * **Changed in v1.21.1:** If applicable, the name of the OCG is shown in `"layer"`. ----- .. method:: Page.wrap_contents() Ensures that the page's so-called graphics state is balanced and new content can be inserted correctly. In versions 1.24.1+ of PyMuPDF the method was improved and is being executed automatically as required, so you should no longer need to concern yourself with it. We discourage using :meth:`Page.clean_contents` to achieve this. ----- .. attribute:: Page.is_wrapped Indicate whether the page's so-called graphic state is balanced. If `False`, :meth:`Page.wrap_contents` should be executed if new content is inserted (only relevant in `overlay=True` mode). In newer versions (1.24.1+), this check and corresponding adjustments are automatically executed -- you therefore should not be concerned about this anymore. :rtype: bool ----- .. method:: Page.get_text_blocks(flags=None) Deprecated wrapper for :meth:`TextPage.extractBLOCKS`. Use :meth:`Page.get_text` with the "blocks" option instead. :rtype: list[tuple] ----- .. method:: Page.get_text_words(flags=None, delimiters=None) Deprecated wrapper for :meth:`TextPage.extractWORDS`. Use :meth:`Page.get_text` with the "words" option instead. :rtype: list[tuple] ----- .. method:: Page.get_displaylist() Run a page through a list device and return its display list. :rtype: :ref:`DisplayList` :returns: the display list of the page. ----- .. method:: Page.get_contents() PDF only: Retrieve a list of :data:`xref` of :data:`contents` objects of a page. May be empty or contain multiple integers. If the page is cleaned (:meth:`Page.clean_contents`), it will be no more than one entry. The "source" of each `/Contents` object can be individually read by :meth:`Document.xref_stream` using an item of this list. Method :meth:`Page.read_contents` in contrast walks through this list and concatenates the corresponding sources into one `bytes` object. :rtype: list[int] ----- .. method:: Page.set_contents(xref) PDF only: Let the page's `/Contents` key point to this xref. Any previously used contents objects will be ignored and can be removed via garbage collection. ----- .. method:: Page.clean_contents(sanitize=True) * Changed in v1.17.6 PDF only: Clean and concatenate all :data:`contents` objects associated with this page. "Cleaning" includes syntactical corrections, standardizations and "pretty printing" of the contents stream. Discrepancies between :data:`contents` and :data:`resources` objects will also be corrected if sanitize is true. See :meth:`Page.get_contents` for more details. Changed in version 1.16.0 Annotations are no longer implicitly cleaned by this method. Use :meth:`Annot.clean_contents` separately. :arg bool sanitize: *(new in v1.17.6)* if true, synchronization between resources and their actual use in the contents object is snychronized. For example, if a font is not actually used for any text of the page, then it will be deleted from the `/Resources/Font` object. .. warning:: This is a complex function which may generate large amounts of new data and render old data unused. It is **not recommended** using it together with the **incremental save** option. Also note that the resulting singleton new */Contents* object is **uncompressed**. So you should save to a **new file** using options *"deflate=True, garbage=3"*. Do not any longer use this method to ensure correct insertions on PDF pages. Since PyMuPDF version 1.24.2 this is taken care of automatically. ----- .. method:: Page.read_contents() *New in version 1.17.0.* Return the concatenation of all :data:`contents` objects associated with the page -- without cleaning or otherwise modifying them. Use this method whenever you need to parse this source in its entirety without having to bother how many separate contents objects exist. :rtype: bytes ----- .. method:: Annot.clean_contents(sanitize=True) Clean the :data:`contents` streams associated with the annotation. This is the same type of action which :meth:`Page.clean_contents` performs -- just restricted to this annotation. ----- .. method:: Document.get_char_widths(xref=0, limit=256) Return a list of character glyphs and their widths for a font that is present in the document. A font must be specified by its PDF cross reference number :data:`xref`. This function is called automatically from :meth:`Page.insert_text` and :meth:`Page.insert_textbox`. So you should rarely need to do this yourself. :arg int xref: cross reference number of a font embedded in the PDF. To find a font :data:`xref`, use e.g. *doc.get_page_fonts(pno)* of page number *pno* and take the first entry of one of the returned list entries. :arg int limit: limits the number of returned entries. The default of 256 is enforced for all fonts that only support 1-byte characters, so-called "simple fonts" (checked by this method). All :ref:`Base-14-Fonts` are simple fonts. :rtype: list :returns: a list of *limit* tuples. Each character *c* has an entry *(g, w)* in this list with an index of *ord(c)*. Entry *g* (integer) of the tuple is the glyph id of the character, and float *w* is its normalized width. The actual width for some :data:`fontsize` can be calculated as *w * fontsize*. For simple fonts, the *g* entry can always be safely ignored. In all other cases *g* is the basis for graphically representing *c*. This function calculates the pixel width of a string called *text*:: def pixlen(text, widthlist, fontsize): try: return sum([widthlist[ord(c)] for c in text]) * fontsize except IndexError: raise ValueError(f"max. code point found: {ord(max(text))}, increase limit") ----- .. method:: Document.is_stream(xref) * New in version 1.14.14 PDF only: Check whether the object represented by :data:`xref` is a :data:`stream` type. Return is ``False`` if not a PDF or if the number is outside the valid xref range. :arg int xref: :data:`xref` number. :returns: ``True`` if the object definition is followed by data wrapped in keyword pair *stream*, *endstream*. ----- .. method:: Document.get_new_xref() Increase the :data:`xref` by one entry and return that number. This can then be used to insert a new object. :rtype: int :returns: the number of the new :data:`xref` entry. Please note, that only a new entry in the PDF's cross reference table is created. At this point, there will not yet exist a PDF object associated with it. To create an (empty) object with this number use `doc.update_xref(xref, "<<>>")`. ----- .. method:: Document.xref_length() Return length of :data:`xref` table. :rtype: int :returns: the number of entries in the :data:`xref` table. ----- .. method:: recover_quad(line_dir, span) Compute the quadrilateral of a text span extracted via options "dict" or "rawdict" of :meth:`Page.get_text`. :arg tuple line_dir: `line["dir"]` of the owning line. Use `None` for a span from :meth:`Page.get_texttrace`. :arg dict span: the span. :returns: the :ref:`Quad` of the span, usable for text marker annotations ('Highlight', etc.). ----- .. method:: recover_char_quad(line_dir, span, char) Compute the quadrilateral of a text character extracted via option "rawdict" of :meth:`Page.get_text`. :arg tuple line_dir: `line["dir"]` of the owning line. Use `None` for a span from :meth:`Page.get_texttrace`. :arg dict span: the span. :arg dict char: the character. :returns: the :ref:`Quad` of the character, usable for text marker annotations ('Highlight', etc.). ----- .. method:: recover_span_quad(line_dir, span, chars=None) Compute the quadrilateral of a subset of characters of a span extracted via option "rawdict" of :meth:`Page.get_text`. :arg tuple line_dir: `line["dir"]` of the owning line. Use `None` for a span from :meth:`Page.get_texttrace`. :arg dict span: the span. :arg list chars: the characters to consider. If given, the selected extraction option must be "rawdict". :returns: the :ref:`Quad` of the selected characters, usable for text marker annotations ('Highlight', etc.). ----- .. method:: recover_line_quad(line, spans=None) Compute the quadrilateral of a subset of spans of a text line extracted via options "dict" or "rawdict" of :meth:`Page.get_text`. :arg dict line: the line. :arg list spans: a sub-list of `line["spans"]`. If omitted, the full line quad will be returned. :returns: the :ref:`Quad` of the selected line spans, usable for text marker annotations ('Highlight', etc.). ----- .. method:: get_tessdata(tessdata=None) Detect Tesseract language support folder. This function is used to enable OCR via Tesseract even if the language support folder is not specified directly or in environment variable TESSDATA_PREFIX. * If is set we return it directly. * Otherwise we return `os.environ['TESSDATA_PREFIX']` if set. * Otherwise we search for a Tesseract installation and return its language support folder. * Otherwise we raise an exception. ----- .. method:: INFINITE_QUAD() .. method:: INFINITE_RECT() .. method:: INFINITE_IRECT() Return the (unique) infinite rectangle `Rect(-2147483648.0, -2147483648.0, 2147483520.0, 2147483520.0)`, resp. the :ref:`IRect` and :ref:`Quad` counterparts. It is the largest possible rectangle: all valid rectangles are contained in it. ----- .. method:: EMPTY_QUAD() .. method:: EMPTY_RECT() .. method:: EMPTY_IRECT() Return the "standard" empty and invalid rectangle `Rect(2147483520.0, 2147483520.0, -2147483648.0, -2147483648.0)` resp. quad. Its top-left and bottom-right point values are reversed compared to the infinite rectangle. It will e.g. be used to indicate empty bboxes in `page.get_text("dict")` dictionaries. There are however infinitely many empty or invalid rectangles. ----- .. method:: colors_pdf_dict() Returns a dict mapping lower-case color name to `(red, green, blue)` tuple, and `red`, `green`, `blue` are floats in range 0..1. .. method:: colors_wx_list() Returns a list of `(colorname, red, green, blue)` tuples, where `colorname` is upper case and `red`, `green`, `blue` are integers in range 0..255. .. include:: footer.rst ================================================ FILE: docs/glossary.rst ================================================ .. include:: header.rst .. _Glossary: ============== Glossary ============== .. data:: coordinate This is an essential general mathematical / geometrical term for understanding this documentation. Please see this section for a more detailed discussion: :ref:`Coordinates`. .. data:: matrix_like A Python sequence of 6 numbers. .. data:: rect_like A Python sequence of 4 numbers. .. data:: irect_like A Python sequence of 4 integers. .. data:: point_like A Python sequence of 2 numbers. .. data:: quad_like A Python sequence of 4 :data:`point_like` items. .. data:: inheritable A number of values in a PDF can inherited by objects further down in a parent-child relationship. The mediabox (physical size) of pages may for example be specified only once or in some node(s) of the :data:`pagetree` and will then be taken as value for all *kids*, that do not specify their own value. .. _Glossary_MediaBox: .. data:: MediaBox A PDF array of 4 floats specifying a physical page size -- (:data:`inheritable`, mandatory). This rectangle should contain all other PDF -- optional -- page rectangles, which may be specified in addition: CropBox, TrimBox, ArtBox and BleedBox. Please consult :ref:`AdobeManual` for details. The MediaBox is the only rectangle, for which there is no difference between MuPDF and PDF coordinate systems: :attr:`Page.mediabox` will always show the same coordinates as the `/MediaBox` key in a page's object definition. For all other rectangles, MuPDF transforms y coordinates such that the **top** border is the point of reference. This can sometimes be confusing -- you may for example encounter a situation like this one: * The page definition contains the following identical values: `/MediaBox [ 36 45 607.5 765 ]`, `/CropBox [ 36 45 607.5 765 ]`. * PyMuPDF accordingly shows `page.mediabox = Rect(36.0, 45.0, 607.5, 765.0)`. * **BUT:** `page.cropbox = Rect(36.0, 0.0, 607.5, 720.0)`, because the two y-coordinates have been transformed (45 subtracted from both of them). .. data:: CropBox A PDF array of 4 floats specifying a page's visible area -- (:data:`inheritable`, optional). It is the default for TrimBox, ArtBox and BleedBox. If not present, it defaults to MediaBox. This value is **not affected** if the page is rotated -- in contrast to :attr:`Page.rect`. Also, other than the page rectangle, the top-left corner of the cropbox may or may not be *(0, 0)*. .. data:: catalog A central PDF :data:`dictionary` -- also called the "root" -- containing document-wide parameters and pointers to many other information. Its :data:`xref` is returned by :meth:`Document.pdf_catalog`. .. data:: trailer More precisely, the **PDF trailer** contains information in :data:`dictionary` format. It is usually located at the file's end. In this dictionary, you will find things like the xrefs of the catalog and the metadata, the number of :data:`xref` numbers, etc. Here is the definition of the PDF spec: *"The trailer of a PDF file enables an application reading the file to quickly find the cross-reference table and certain special objects. Applications should read a PDF file from its end."* To access the trailer in PyMuPDF, use the usual methods :meth:`Document.xref_object`, :meth:`Document.xref_get_key` and :meth:`Document.xref_get_keys` with `-1` instead of a positive xref number. .. data:: contents A **content stream** is a PDF :data:`object` with an attached :data:`stream`, whose data consists of a sequence of instructions describing the graphical elements to be painted on a page, see "Stream Objects" on page 19 of :ref:`AdobeManual`. For an overview of the mini-language used in these streams, see chapter "Operator Summary" on page 643 of the :ref:`AdobeManual`. A PDF :data:`page` can have none to many contents objects. If it has none, the page is empty (but still may show annotations). If it has several, they will be interpreted in sequence as if their instructions had been present in one such object (i.e. like in a concatenated string). It should be noted that there are more stream object types which use the same syntax: e.g. appearance dictionaries associated with annotations and Form XObjects. PyMuPDF provides a number of methods to deal with contents of PDF pages: * :meth:`Page.read_contents()` -- reads and concatenates all page contents into one `bytes` object. * :meth:`Page.clean_contents()` -- a wrapper of a MuPDF function that reads, concatenates and syntax-cleans all page contents. After this, only one `/Contents` object will exist. In addition, page :data:`resources` will have been synchronized with it such that it will contain exactly those images, fonts and other objects that the page actually references. * :meth:`Page.get_contents()` -- return a list of :data:`xref` numbers of a page's :data:`contents` objects. May be empty. Use :meth:`Document.xref_stream()` with one of these xrefs to read the resp. contents section. * :meth:`Page.set_contents()` -- set a page's `/Contents` key to the provided :data:`xref` number. .. data:: resources A :data:`dictionary` containing references to any resources (like images or fonts) required by a PDF :data:`page` (required, inheritable, :ref:`AdobeManual` p. 81) and certain other objects (Form XObjects). This dictionary appears as a sub-dictionary in the object definition under the key */Resources*. Being an inheritable object type, there may exist "parent" resources for all pages or certain subsets of pages. .. data:: dictionary A PDF :data:`object` type, which is somewhat comparable to the same-named Python notion: "A dictionary object is an associative table containing pairs of objects, known as the dictionary's entries. The first element of each entry is the key and the second element is the value. The key must be a name (...). The value can be any kind of object, including another dictionary. A dictionary entry whose value is null (...) is equivalent to an absent entry." (:ref:`AdobeManual` p. 18). Dictionaries are the most important :data:`object` type in PDF. Here is an example (describing a :data:`page`):: << /Contents 40 0 R % value: an indirect object /Type/Page % value: a name object /MediaBox[0 0 595.32 841.92] % value: an array object /Rotate 0 % value: a number object /Parent 12 0 R % value: an indirect object /Resources<< % value: a dictionary object /ExtGState<> /Font<< /R8 27 0 R/R10 21 0 R/R12 24 0 R/R14 15 0 R /R17 4 0 R/R20 30 0 R/R23 7 0 R /R27 20 0 R >> /ProcSet[/PDF/Text] % value: array of two name objects >> /Annots[55 0 R] % value: array, one entry (indirect object) >> *Contents*, *Type*, *MediaBox*, etc. are **keys**, *40 0 R*, *Page*, *[0 0 595.32 841.92]*, etc. are the respective **values**. The strings *"<<"* and *">>"* are used to enclose object definitions. This example also shows the syntax of **nested** dictionary values: *Resources* has an object as its value, which in turn is a dictionary with keys like *ExtGState* (with the value *<>*, which is another dictionary), etc. .. data:: page A PDF page is a :data:`dictionary` object which defines one page in a PDF, see :ref:`AdobeManual` p. 71. .. data:: pagetree The pages of a document are accessed through a structure known as the page tree, which defines the ordering of pages in the document. The tree structure allows PDF consumer applications, using only limited memory, to quickly open a document containing thousands of pages. The tree contains nodes of two types: intermediate nodes, called page tree nodes, and leaf nodes, called page objects. (:ref:`AdobeManual` p. 75). While it is possible to list all page references in just one array, PDFs with many pages are often created using *balanced tree* structures ("page trees") for faster access to any single page. In relation to the total number of pages, this can reduce the average page access time by page number from a linear to some logarithmic order of magnitude. For fast page access, MuPDF can use its own array in memory -- independently from what may or may not be present in the document file. This array is indexed by page number and therefore much faster than even the access via a perfectly balanced page tree. .. data:: object Similar to Python, PDF supports the notion *object*, which can come in eight basic types: boolean values ("true" or "false"), integer and real numbers, strings (**always** enclosed in brackets -- either "()", or "<>" to indicate hexadecimal), names (must always start with a "/", e.g. `/Contents`), arrays (enclosed in brackets "[]"), dictionaries (enclosed in brackets "<<>>"), streams (enclosed by keywords "stream" / "endstream"), and the null object ("null") (:ref:`AdobeManual` p. 13). Objects can be made identifiable by assigning a label. This label is then called *indirect* object. PyMuPDF supports retrieving definitions of indirect objects via their cross reference number via :meth:`Document.xref_object`. .. data:: stream A PDF :data:`dictionary` :data:`object` type which is followed by a sequence of bytes, similar to Python *bytes*. "However, a PDF application can read a stream incrementally, while a string must be read in its entirety. Furthermore, a stream can be of unlimited length, whereas a string is subject to an implementation limit. For this reason, objects with potentially large amounts of data, such as images and page descriptions, are represented as streams." "A stream consists of a :data:`dictionary` followed by zero or more bytes bracketed between the keywords *stream* and *endstream*":: nnn 0 obj << dictionary definition >> stream (zero or more bytes) endstream endobj See :ref:`AdobeManual` p. 19. PyMuPDF supports retrieving stream content via :meth:`Document.xref_stream`. Use :meth:`Document.is_stream` to determine whether an object is of stream type. .. data:: unitvector A mathematical notion meaning a vector of norm ("length") 1 -- usually the Euclidean norm is implied. In PyMuPDF, this term is restricted to :ref:`Point` objects, see :attr:`Point.unit`. .. data:: xref Abbreviation for cross-reference number: this is an integer unique identification for objects in a PDF. There exists a cross-reference table (which may physically consist of several separate segments) in each PDF, which stores the relative position of each object for quick lookup. The cross-reference table is one entry longer than the number of existing object: item zero is reserved and must not be used in any way. Many PyMuPDF classes have an :data:`xref` attribute (which is zero for non-PDFs), and one can find out the total number of objects in a PDF via :meth:`Document.xref_length` *- 1*. .. data:: fontsize When referring to font size this metric is measured in points where 1 inch = 72 points. .. data:: resolution Images and :ref:`Pixmap` objects may contain resolution information provided as "dots per inch", dpi, in each direction (horizontal and vertical). When MuPDF reads an image from a file or from a PDF object, it will parse this information and put it in :attr:`Pixmap.xres`, :attr:`Pixmap.yres`, respectively. If it finds no meaningful information in the input (like non-positive values or values exceeding 4800), it will use "sane" defaults instead. The usual default value is 96, but it may also be 72 in some cases (e.g. for JPX images). .. data:: OCPD Optional content properties dictionary - a sub :data:`dictionary` of the PDF :data:`catalog`. The central place to store optional content information, which is identified by the key `/OCProperties`. This dictionary has two required and one optional entry: (1) `/OCGs`, required, an array listing all optional content groups, (2) `/D`, required, the default optional content configuration dictionary (OCCD), (3) `/Configs`, optional, an array of alternative OCCDs. .. data:: OCCD Optional content configuration dictionary - a PDF :data:`dictionary` inside the PDF :data:`OCPD`. It stores a setting of ON / OFF states of OCGs and how they are presented to a PDF viewer program. Selecting a configuration is quick way to achieve temporary mass visibility state changes. After opening a PDF, the `/D` configuration of the :data:`OCPD` is always activated. Viewer should offer a way to switch between the `/D`, or one of the optional configurations contained in array `/Configs`. .. data:: OCG Optional content group -- a :data:`dictionary` object used to control the visibility of other PDF objects like images or annotations. Independently on which page they are defined, objects with the same OCG can simultaneously be shown or hidden by setting their OCG to ON or OFF. This can be achieved via the user interface provided by many PDF viewers (Adobe Acrobat), or programmatically. .. data:: OCMD Optional content membership dictionary -- a :data:`dictionary` object which can be used like an :data:`OCG`: it has a visibility state. The visibility of an OCMD is **computed:** it is a logical expression, which uses the state of one or more OCGs to produce a boolean value. The expression's result is interpreted as ON (true) or OFF (false). .. data:: ligature Some frequent character combinations are represented by their own special glyphs in more advanced fonts. Typical examples are "fi", "fl", "ffi" and "ffl". These compounds are called *ligatures*. In PyMuPDF text extractions, there is the option to either return the corresponding unicode unchanged, or split ligatures up into their constituent parts: "fi" ==> "f" + "i", etc. .. include:: footer.rst ================================================ FILE: docs/header-404.rst ================================================ .. meta:: :author: Artifex :description: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents. :keywords: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript .. raw:: html
================================================ FILE: docs/header.rst ================================================ .. meta:: :author: Artifex :description: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents. :keywords: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript .. |history_begin| raw:: html
Show/hide history .. |history_end| raw:: html
.. |pdf_only_class| raw:: html
This class is for PDF only.
.. names of common things .. |PyMuPDF| raw:: html PyMuPDF .. |PyMuPDF Pro| raw:: html PyMuPDF Pro .. |PyMuPDF4LLM| raw:: html PyMuPDF4LLM .. |PyMuPDF Layout| raw:: html PyMuPDF Layout .. |MuPDF| raw:: html MuPDF .. |PDF| raw:: html PDF .. |Markdown| raw:: html Markdown .. |JSON| raw:: html JSON .. |TXT| raw:: html TXT .. |AGPL| raw:: html AGPL .. |PyPI| raw:: html PyPI .. raw:: html ================================================ FILE: docs/how-to-open-a-file.rst ================================================ .. include:: header.rst .. _HowToOpenAFile: ============================== Opening Files ============================== .. _Supported_File_Types: Supported File Types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | PyMuPDF """"""""" |PyMuPDF| can open files other than just |PDF|. The following file types are supported: .. include:: supported-files-table.rst ---- PyMuPDF Pro """"""""""""""" |PyMuPDF Pro| can open Office files. The following file types are supported: .. list-table:: :header-rows: 1 * - **DOC/DOCX** - **XLS/XLSX** - **PPT/PPTX** - **HWP/HWPX** * - .. image:: images/icons/icon-docx.svg :width: 40 :height: 40 - .. image:: images/icons/icon-xlsx.svg :width: 40 :height: 40 - .. image:: images/icons/icon-pptx.svg :width: 40 :height: 40 - .. image:: images/icons/icon-hangul.svg :width: 40 :height: 40 How to Open a File ~~~~~~~~~~~~~~~~~~~~~ To open a file, do the following: .. code-block:: python doc = pymupdf.open("a.pdf") .. note:: The above creates a :ref:`Document`. The instruction `doc = pymupdf.Document("a.pdf")` does exactly the same. So, `open` is just a convenient alias and you can find its full API documented in that chapter. File Recognizer: Opening with :index:`a Wrong File Extension ` """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" If you have a document with a wrong file extension for its type, do not worry: it will still be opened correctly, thanks to the integrated file "content recognizer". This component looks at the actual data in the file using a number of heuristics -- independent of the file extension. This of course is also true for file names **without** an extension. Here is a list of details about how the file content recognizer works: * When opening from a file name, use the ``filetype`` parameter if your file format cannot be determined by content inspection. This is for instance the case for all text files: "txt", "html", "xml" or source files. If the file extension is missing or wrong or the file resides in memory, the ``filetype`` must be used. File formats that can successfully be recognized will be opened even without or wrong extensions, and the ``filetype`` paraneter will be ignored. * Files based on text content do not contain unambiguously recognizable internal structures. This is true for source files (Python, C, etc.) but also HTML, XML and so on. Here, the file extensions and the ``filetype`` parameter continue to play a role and are used to create a "Tex" / "HTML" / ... document. Correspondingly, text files with other / no extensions, can successfully be opened using ``filetype``. ---------- Opening Remote Files ~~~~~~~~~~~~~~~~~~~~~~~~~~ For remote files on a server (i.e. non-local files), you will need to *stream* the file data to |PyMuPDF|. For example use the `requests `_ library as follows: .. code-block:: python import pymupdf import requests r = requests.get('https://mupdf.com/docs/mupdf_explored.pdf') data = r.content doc = pymupdf.Document(stream=data) Opening Files from Cloud Services """""""""""""""""""""""""""""""""""""" For further examples which deal with files held on typical cloud services please see these `Cloud Interactions code snippets `_. ---------- Opening Django Files ~~~~~~~~~~~~~~~~~~~~~~~~~~ Django implements a `File Storage API `_ to store files. The default is the `FileSystemStorage `_, but the `django-storages `_ library provides a number of other storage backends. You can open the file, move the contents into memory, then pass the contents to |PyMuPDF| as a stream. .. code-block:: python import pymupdf from django.core.files.storage import default_storage from .models import MyModel obj = MyModel.objects.get(id=1) with default_storage.open(obj.file.name) as f: data = f.read() doc = pymupdf.Document(stream=data) Please note that if the file you open is large, you may run out of memory. The File Storage API works well if you're using different storage backends in different environments. If you're only using the `FileSystemStorage`, you can simply use the `obj.file.name` to open the file directly with |PyMuPDF| as shown in an earlier example. ---------- Opening Files as Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |PyMuPDF| has the capability to open any plain text file as a document. In order to do this you should provide the `filetype` parameter for the `pymupdf.open` function as `"txt"`. .. code-block:: python doc = pymupdf.open("my_program.py", filetype="txt") In this way you are able to open a variety of file types and perform the typical **non-PDF** specific features like text searching, text extracting and page rendering. Obviously, once you have rendered your `txt` content, then saving as |PDF| or merging with other |PDF| files is no problem. Examples """""""""""""""""" Opening a `C#` file ........................... .. code-block:: python doc = pymupdf.open("MyClass.cs", filetype="txt") Opening an ``XML`` file ........................... .. code-block:: python doc = pymupdf.open("my_data.xml", filetype="txt") Opening a `JSON` file ........................... .. code-block:: python doc = pymupdf.open("more_of_my_data.json", filetype="txt") And so on! As you can imagine many text based file formats can be *very simply opened* and *interpreted* by |PyMuPDF|. This can make data analysis and extraction for a wide range of previously unavailable files possible. .. include:: footer.rst ================================================ FILE: docs/identity.rst ================================================ .. include:: header.rst .. _Identity: ============ Identity ============ Identity is a :ref:`Matrix` that performs no action -- to be used whenever the syntax requires a matrix, but no actual transformation should take place. It has the form *pymupdf.Matrix(1, 0, 0, 1, 0, 0)*. Identity is a constant, an "immutable" object. So, all of its matrix properties are read-only and its methods are disabled. If you need a **mutable** identity matrix as a starting point, use one of the following statements:: >>> m = pymupdf.Matrix(1, 0, 0, 1, 0, 0) # specify the values >>> m = pymupdf.Matrix(1, 1) # use scaling by factor 1 >>> m = pymupdf.Matrix(0) # use rotation by zero degrees >>> m = pymupdf.Matrix(pymupdf.Identity) # make a copy of Identity .. include:: footer.rst ================================================ FILE: docs/index.rst ================================================ .. include:: header.rst .. This is the TOC in the sidebar! .. raw:: html Welcome to |PyMuPDF| ================================ |PyMuPDF| is a high-performance **Python** library for data extraction, analysis, conversion & manipulation of |PDF| (and other) documents. |PyMuPDF| is hosted on `GitHub `_ and registered on `PyPI `_. .. if we want a Github repo badge .. raw:: html pymupdf%2FPyMuPDF | Trendshift ---- This documentation covers all versions up to |version|. ---- .. toctree:: :caption: About :maxdepth: 1 about.rst pymupdf4llm/index.rst pymupdf-pro/index.rst .. toctree:: :caption: User Guide :maxdepth: 1 installation.rst the-basics.rst tutorial.rst rag.rst resources.rst faq/index.rst .. toctree:: :caption: How to Guide :maxdepth: 3 recipes.rst .. toctree:: :caption: API Reference :maxdepth: 2 module.rst classes.rst pymupdf4llm/api.rst algebra.rst lowlevel.rst glossary.rst vars.rst colors.rst .. toctree:: :caption: Other :maxdepth: 2 app1.rst app2.rst app3.rst app4.rst changes.rst znames.rst | ---- .. include:: footer.rst ================================================ FILE: docs/installation.rst ================================================ .. include:: header.rst Installation ============= Requirements --------------------------------------------------------- All the examples below assume that you are running inside a Python virtual environment. See: https://docs.python.org/3/library/venv.html for details. We also assume that `pip` is up to date. For example: * Windows:: py -m venv pymupdf-venv .\pymupdf-venv\Scripts\activate python -m pip install --upgrade pip * Linux, MacOS:: python -m venv pymupdf-venv . pymupdf-venv/bin/activate python -m pip install --upgrade pip Installation --------------------------------------------------------- |PyMuPDF| should be installed using pip with:: pip install --upgrade pymupdf This will install from a Python wheel if one is available for your platform. Installation when a suitable wheel is not available --------------------------------------------------------- If a suitable Python wheel is not available, pip will automatically build from source using a Python sdist. **This requires C/C++ development tools to be installed**: * On Windows: * Install Visual Studio 2019. If not installed in a standard location, set environmental variable `PYMUPDF_SETUP_DEVENV` to the location of the `devenv.com` binary. * Having other installed versions of Visual Studio, for example Visual Studio 2022, can cause problems because one can end up with MuPDF and PyMuPDF code being compiled with different compiler versions. The build will automatically download and build MuPDF. .. _problems-after-installation: Problems after installation --------------------------------------------------------- * On Windows, Python error:: ImportError: DLL load failed while importing _extra This has been occasionally seen if `MSVCP140.dll` is missing, and appears to be caused by a bug in some versions (2015-2017) of `Microsoft Visual C++ Redistributables`. It is recommended to search for `MSVCP140.dll` in https://msdn.com to find instructions for how to reinstall it. For example https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist has permalinks to the latest supported versions. See https://github.com/pymupdf/PyMuPDF/issues/2678 for more details. * Python error:: ModuleNotFoundError: No module named 'frontend' This can happen if PyMuPDF's legacy name `fitz` is used (for example `import fitz` instead of `import pymupdf`), and an unrelated Python package called `fitz` (https://pypi.org/project/fitz/) is installed. The fitz package appears to be no longer maintained (the latest release is from 2017), but unfortunately it does not seem possible to remove it from pypi.org. It does not even work on its own, as well as breaking the use of PyMuPDF's legacy name. There are a few ways to avoid this problem: * Use `import pymupdf` instead of `import fitz`, and update one's code to match. * Or uninstall the `fitz` package and reinstall PyMuPDF:: pip uninstall fitz pip install --force-reinstall pymupdf * Or use `import pymupdf as fitz`. However this has not been well tested. * With Jupyter labs on Apple Silicon (arm64), Python error:: ImportError: /opt/conda/lib/python3.11/site-packages/pymupdf/libmupdf.so.24.4: undefined symbol: fz_pclm_write_options_usage This appears to be a problem in Jupyter labs; see: https://github.com/pymupdf/PyMuPDF/issues/3643#issuecomment-2210588778. * On Windows, Python error:: ImportError: dynamic module does not define module export function (PyInit__extra) This was reported 2025-03-26 in https://github.com/pymupdf/PyMuPDF/issues/4405. The fix appears to be to install the latest `VC_redist.x64.exe`. Notes --------------------------------------------------------- * Wheels are available for the following platforms: * Windows 32-bit Intel. * Windows 64-bit Intel. * Linux 64-bit Intel. * Linux 64-bit ARM. * MacOS 64-bit Intel. * MacOS 64-bit ARM. Details: * We release a single wheel for each of the above platforms. * Each wheel uses the Python Stable ABI of the current oldest supported Python version (currently 3.10), and so works with all later Python versions, including new Python releases. * Wheels are tested on all Python versions currently marked as "Supported" on https://devguide.python.org/versions/, currently |python_versions|. * Wheels are not available for Python installed with `Chocolatey `_ on Windows. Instead install Python using the Windows installer from the python.org website, see: http://www.python.org/downloads * Wheels are not available for Linux-aarch64 with `Musl libc `_ (For example `Alpine Linux `_ on aarch64), and building from source is known to fail. * There are no **mandatory** external dependencies. However, some optional feature are available only if additional components are installed: * `Pillow `_ is required for :meth:`Pixmap.pil_save` and :meth:`Pixmap.pil_tobytes`. * `fontTools `_ is required for :meth:`Document.subset_fonts`. * `pymupdf-fonts `_ is a collection of nice fonts to be used for text output methods. * `Tesseract-OCR `_ for optical character recognition in images and document pages. Tesseract is separate software, not a Python package. To enable OCR functions in PyMuPDF, Tesseract must be installed and the `tessdata` folder name specified; see below. .. note:: You can install these additional components at any time -- before or after installing PyMuPDF. PyMuPDF will detect their presence during import or when the respective functions are being used. Build and install from a local PyMuPDF source tree --------------------------------------------------------- Initial setup: * Install C/C++ development tools as described above. * Enter a Python venv and update pip, as described above. * Get a PyMuPDF source tree: * Clone the PyMuPDF git repository:: git clone https://github.com/pymupdf/PyMuPDF.git * Or download and extract a `.zip` or `.tar.gz` source release from https://github.com/pymupdf/PyMuPDF/releases. Then one can build PyMuPDF in two ways: * Build and install PyMuPDF with default MuPDF version:: cd PyMuPDF && pip install . This will automatically download a specific hard-coded MuPDF source release, and build it into PyMuPDF. * Or build and install PyMuPDF using a local MuPDF source tree: * Clone the MuPDF git repository:: git clone --recursive https://git.ghostscript.com/mupdf.git * Build PyMuPDF, specifying the location of the local MuPDF tree with the environmental variables `PYMUPDF_SETUP_MUPDF_BUILD`:: cd PyMuPDF && PYMUPDF_SETUP_MUPDF_BUILD=../mupdf pip install . Also, one can build for different Python versions in the same PyMuPDF tree: * PyMuPDF will build for the version of Python that is being used to run `pip`. To run `pip` with a specific Python version, use `python -m pip` instead of `pip`. So for example on Windows one can build different versions with:: cd PyMuPDF && py -3.10 -m pip install . or:: cd PyMuPDF && py -3.10-32 -m pip install . Running tests --------------------------------------------------------- Having a PyMuPDF tree available allows one to run PyMuPDF's `pytest` test suite:: pip install pytest fontTools pytest PyMuPDF/tests Notes about using a non-default MuPDF ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Using a non-default build of MuPDF by setting environmental variable `PYMUPDF_SETUP_MUPDF_BUILD` can cause various things to go wrong and so is not generally supported: * If MuPDF's major version number differs from what PyMuPDF uses by default, PyMuPDF can fail to build, because MuPDF's API can change between major versions. * Runtime behaviour of PyMuPDF can change because MuPDF's runtime behaviour changes between different minor releases. This can also break some PyMuPDF tests. * If MuPDF was built with its default config instead of PyMuPDF's customised config (for example if MuPDF is a system install), it is possible that `tests/test_textbox.py:test_textbox3()` will fail. One can skip this particular test by adding `-k 'not test_textbox3'` to the `pytest` command line. Official PyMuPDF Linux wheels may not install on older Linux systems -------------------------------------------------------------------- Releases of PyMuPDF are incompatible with older Linux systems. For example as of 2025-09-03, `pip install pymupdf` does not work on some AWS Lambda systems - see https://github.com/pymupdf/PyMuPDF/discussions/4631. This is because official PyMuPDF Linux wheels are built with a version of glibc determined by the current Python manylinux environment. These wheels are incompatible with Linux systems that have an older glibc. The official Python manylinux environment is updated periodically to use newer glibc versions, so new releases of PyMuPDF become increasingly incompatible with older Linux systems. There is nothing that can be done about this, other than updating older Linux systems, or building PyMuPDF locally from source. For more details, please see: `Python Packaging Authority `_. Packaging --------- See :doc:`packaging`. Using with Pyodide ------------------ See :doc:`pyodide`. .. _installation_ocr: Enabling Integrated OCR Support --------------------------------------------------------- PyMuPDF will already contain all the logic to support OCR functions. But it additionally does need `Tesseract's language support data `_. If not specified explicitly, PyMuPDF will attempt to find the installed Tesseract's `tessdata`, but this should probably not be relied upon. Otherwise PyMuPDF requires that Tesseract's language support folder is specified explicitly either in PyMuPDF OCR functions' `tessdata` arguments or `os.environ["TESSDATA_PREFIX"]`. So for a working OCR functionality, make sure to complete this checklist: 1. Locate Tesseract's language support folder. Typically you will find it here: * Windows: `C:/Program Files/Tesseract-OCR/tessdata` * Unix systems: `/usr/share/tesseract-ocr/4.00/tessdata` 2. Specify the language support folder when calling PyMuPDF OCR functions: * Set the `tessdata` argument. * Or set `os.environ["TESSDATA_PREFIX"]` from within Python. * Or set environment variable `TESSDATA_PREFIX` before running Python, for example: * Windows: `setx TESSDATA_PREFIX "C:/Program Files/Tesseract-OCR/tessdata"` * Unix systems: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-ocr/4.00/tessdata` .. note:: English language support is included by default in Tesseract installation. :ref:`Tesseract Language Packs ` for other languages must be installed separately, and the `tessdata` folder must be specified to PyMuPDF as described above, for OCR to work with those languages. .. note:: Find out more on the `official documentation for installing Tesseract website `_. .. include:: footer.rst ================================================ FILE: docs/irect.rst ================================================ .. include:: header.rst .. _IRect: ========== IRect ========== IRect is a rectangular bounding box, very similar to :ref:`Rect`, except that all corner coordinates are integers. IRect is used to specify an area of pixels, e.g. to receive image data during rendering. Otherwise, e.g. considerations concerning emptiness and validity of rectangles also apply to this class. Methods and attributes have the same names, and in many cases are implemented by re-using the respective :ref:`Rect` counterparts. ============================== ============================================== **Attribute / Method** **Short Description** ============================== ============================================== :meth:`IRect.contains` checks containment of another object :meth:`IRect.get_area` calculate rectangle area :meth:`IRect.intersect` common part with another rectangle :meth:`IRect.intersects` checks for non-empty intersection :meth:`IRect.morph` transform with a point and a matrix :meth:`IRect.torect` matrix that transforms to another rectangle :meth:`IRect.norm` the Euclidean norm :meth:`IRect.normalize` makes a rectangle finite :attr:`IRect.bottom_left` bottom left point, synonym *bl* :attr:`IRect.bottom_right` bottom right point, synonym *br* :attr:`IRect.height` height of the rectangle :attr:`IRect.is_empty` whether rectangle is empty :attr:`IRect.is_infinite` whether rectangle is infinite :attr:`IRect.rect` the :ref:`Rect` equivalent :attr:`IRect.top_left` top left point, synonym *tl* :attr:`IRect.top_right` top_right point, synonym *tr* :attr:`IRect.quad` :ref:`Quad` made from rectangle corners :attr:`IRect.width` width of the rectangle :attr:`IRect.x0` X-coordinate of the top left corner :attr:`IRect.x1` X-coordinate of the bottom right corner :attr:`IRect.y0` Y-coordinate of the top left corner :attr:`IRect.y1` Y-coordinate of the bottom right corner ============================== ============================================== **Class API** .. class:: IRect .. method:: __init__(self) .. method:: __init__(self, x0, y0, x1, y1) .. method:: __init__(self, irect) .. method:: __init__(self, sequence) Overloaded constructors. Also see examples below and those for the :ref:`Rect` class. If another irect is specified, a **new copy** will be made. If sequence is specified, it must be a Python sequence type of 4 numbers (see :ref:`SequenceTypes`). Non-integer numbers will be truncated, non-numeric values will raise an exception. The other parameters mean integer coordinates. .. method:: get_area([unit]) Calculates the area of the rectangle and, with no parameter, equals *abs(IRect)*. Like an empty rectangle, the area of an infinite rectangle is also zero. :arg str unit: Specify required unit: respective squares of "px" (pixels, default), "in" (inches), "cm" (centimeters), or "mm" (millimeters). :rtype: float .. method:: intersect(ir) The intersection (common rectangular area) of the current rectangle and *ir* is calculated and replaces the current rectangle. If either rectangle is empty, the result is also empty. If either rectangle is infinite, the other one is taken as the result -- and hence also infinite if both rectangles were infinite. :arg rect_like ir: Second rectangle. .. method:: contains(x) Checks whether *x* is contained in the rectangle. It may be :data:`rect_like`, :data:`point_like` or a number. If *x* is an empty rectangle, this is always true. Conversely, if the rectangle is empty this is always ``False``, if *x* is not an empty rectangle and not a number. If *x* is a number, it will be checked to be one of the four components. *x in irect* and *irect.contains(x)* are equivalent. :arg x: the object to check. :type x: :ref:`IRect` or :ref:`Rect` or :ref:`Point` or `int`. :rtype: bool .. method:: intersects(r) Checks whether the rectangle and the :data:`rect_like` "r" contain a common non-empty :ref:`IRect`. This will always be ``False`` if either is infinite or empty. :arg rect_like r: the rectangle to check. :rtype: bool .. method:: torect(rect) * New in version 1.19.3 Compute the matrix which transforms this rectangle to a given one. See :meth:`Rect.torect`. :arg rect_like rect: the target rectangle. Must not be empty or infinite. :rtype: :ref:`Matrix` :returns: a matrix `mat` such that `self * mat = rect`. Can for example be used to transform between the page and the pixmap coordinates. .. method:: morph(fixpoint, matrix) * New in version 1.17.0 Return a new quad after applying a matrix to it using a fixed point. :arg point_like fixpoint: the fixed point. :arg matrix_like matrix: the matrix. :returns: a new :ref:`Quad`. This a wrapper of the same-named quad method. If infinite, the infinite quad is returned. .. method:: norm() * New in version 1.16.0 Return the Euclidean norm of the rectangle treated as a vector of four numbers. .. method:: normalize() Make the rectangle finite. This is done by shuffling rectangle corners. After this, the bottom right corner will indeed be south-eastern to the top left one. See :ref:`Rect` for a more details. .. attribute:: top_left .. attribute:: tl Equals *Point(x0, y0)*. :type: :ref:`Point` .. attribute:: top_right .. attribute:: tr Equals *Point(x1, y0)*. :type: :ref:`Point` .. attribute:: bottom_left .. attribute:: bl Equals *Point(x0, y1)*. :type: :ref:`Point` .. attribute:: bottom_right .. attribute:: br Equals *Point(x1, y1)*. :type: :ref:`Point` .. attribute:: rect The :ref:`Rect` with the same coordinates as floats. :type: :ref:`Rect` .. attribute:: quad The quadrilateral *Quad(irect.tl, irect.tr, irect.bl, irect.br)*. :type: :ref:`Quad` .. attribute:: width Contains the width of the bounding box. Equals *abs(x1 - x0)*. :type: int .. attribute:: height Contains the height of the bounding box. Equals *abs(y1 - y0)*. :type: int .. attribute:: x0 X-coordinate of the left corners. :type: int .. attribute:: y0 Y-coordinate of the top corners. :type: int .. attribute:: x1 X-coordinate of the right corners. :type: int .. attribute:: y1 Y-coordinate of the bottom corners. :type: int .. attribute:: is_infinite ``True`` if rectangle is infinite, ``False`` otherwise. :type: bool .. attribute:: is_empty ``True`` if rectangle is empty, ``False`` otherwise. :type: bool .. note:: * This class adheres to the Python sequence protocol, so components can be accessed via their index, too. Also refer to :ref:`SequenceTypes`. * Rectangles can be used with arithmetic operators -- see chapter :ref:`Algebra`. .. include:: footer.rst ================================================ FILE: docs/link.rst ================================================ .. include:: header.rst .. _Link: ================ Link ================ Represents a pointer to somewhere (this document, other documents, the internet). Links exist per document page, and they are forward-chained to each other, starting from an initial link which is accessible by the :attr:`Page.first_link` property. There is a parent-child relationship between a link and its page. If the page object becomes unusable (closed document, any document structure change, etc.), then so does every of its existing link objects -- an exception is raised saying that the object is "orphaned", whenever a link property or method is accessed. ========================= ============================================ **Attribute** **Short Description** ========================= ============================================ :meth:`Link.set_border` modify border properties :meth:`Link.set_colors` modify color properties :meth:`Link.set_flags` modify link flags :attr:`Link.border` border characteristics :attr:`Link.colors` border line color :attr:`Link.dest` points to destination details :attr:`Link.is_external` checks if the link is an external destination :attr:`Link.flags` link annotation flags :attr:`Link.next` points to next link :attr:`Link.rect` clickable area in untransformed coordinates :attr:`Link.uri` link destination :attr:`Link.xref` :data:`xref` number of the entry ========================= ============================================ **Class API** .. class:: Link .. method:: set_border(border=None, width=0, style=None, dashes=None) PDF only: Change border width and dashing properties. *(Changed in version 1.16.9)* Allow specification without using a dictionary. The direct parameters are used if *border* is not a dictionary. :arg dict border: a dictionary as returned by the :attr:`border` property, with keys *"width"* (*float*), *"style"* (*str*) and *"dashes"* (*sequence*). Omitted keys will leave the resp. property unchanged. To e.g. remove dashing use: *"dashes": []*. If dashes is not an empty sequence, "style" will automatically be set to "D" (dashed). :arg float width: see above. :arg str style: see above. :arg sequence dashes: see above. .. method:: set_colors(colors=None, stroke=None) PDF only: Changes the "stroke" color. .. note:: In PDF, links are a subtype of annotations technically and **do not support fill colors**. However, to keep a consistent API, we do allow specifying a `fill=` parameter like with all annotations, which will be ignored with a warning. *(Changed in version 1.16.9)* Allow colors to be directly set. These parameters are used if *colors* is not a dictionary. :arg dict colors: a dictionary containing color specifications. For accepted dictionary keys and values see below. The most practical way should be to first make a copy of the *colors* property and then modify this dictionary as required. :arg sequence stroke: see above. .. method:: set_flags(flags) *New in v1.18.16* Set the PDF `/F` property of the link annotation. See :meth:`Annot.set_flags` for details. If not a PDF, this method is a no-op. .. attribute:: flags *New in v1.18.16* Return the link annotation flags, an integer (see :attr:`Annot.flags` for details). Zero if not a PDF. .. attribute:: colors Meaningful for PDF only: A dictionary of two tuples of floats in range `0 <= float <= 1` specifying the *stroke* and the interior (*fill*) colors. If not a PDF, ``None`` is returned. As mentioned above, the fill color is always `None` for links. The stroke color is used for the border of the link rectangle. The length of the tuple implicitly determines the colorspace: 1 = GRAY, 3 = RGB, 4 = CMYK. So `(1.0, 0.0, 0.0)` stands for RGB color red. The value of each float *f* is mapped to the integer value *i* in range 0 to 255 via the computation *f = i / 255*. :rtype: dict .. attribute:: border Meaningful for PDF only: A dictionary containing border characteristics. It will be ``None`` for non-PDFs and an empty dictionary if no border information exists. The following keys can occur: * *width* -- a float indicating the border thickness in points. The value is -1.0 if no width is specified. * *dashes* -- a sequence of integers specifying a line dash pattern. *[]* means no dashes, *[n]* means equal on-off lengths of *n* points, longer lists will be interpreted as specifying alternating on-off length values. See the :ref:`AdobeManual` page 126 for more detail. * *style* -- 1-byte border style: *S* (Solid) = solid rectangle surrounding the annotation, *D* (Dashed) = dashed rectangle surrounding the link, the dash pattern is specified by the *dashes* entry, *B* (Beveled) = a simulated embossed rectangle that appears to be raised above the surface of the page, *I* (Inset) = a simulated engraved rectangle that appears to be recessed below the surface of the page, *U* (Underline) = a single line along the bottom of the annotation rectangle. :rtype: dict .. attribute:: rect The area that can be clicked in untransformed coordinates. :type: :ref:`Rect` .. attribute:: is_external A bool specifying whether the link target is outside of the current document. :type: bool .. attribute:: uri A string specifying the link target. The meaning of this property should be evaluated in conjunction with property `is_external`: * `is_external` is true: `uri` points to some target outside the current PDF, which may be an internet resource (`uri` starts with ``http://`` or similar), another file (`uri` starts with "file:" or "file://") or some other service like an e-mail address (`uri` starts with ``mailto:``). * `is_external` is false: `uri` will be `None` or point to an internal location. In case of PDF documents, this should either be *#nnnn* to indicate a 1-based (!) page number *nnnn*, or a named location. The format varies for other document types, for example "../FixedDoc.fdoc#PG_2_LNK_1" for page number 2 (1-based) in an XPS document. :type: str .. attribute:: xref An integer specifying the PDF :data:`xref`. Zero if not a PDF. :type: int .. attribute:: next The next link or ``None``. :type: *Link* .. attribute:: dest The link destination details object. :type: :ref:`linkDest` .. include:: footer.rst ================================================ FILE: docs/linkdest.rst ================================================ .. include:: header.rst .. _linkDest: ================ linkDest ================ Class representing the `dest` property of an outline entry or a link. Describes the destination to which such entries point. .. note:: Up to MuPDF v1.9.0 this class existed inside MuPDF and was dropped in version 1.10.0. For backward compatibility, PyMuPDF is still maintaining it, although some of its attributes are no longer backed by data actually available via MuPDF. =========================== ==================================== **Attribute** **Short Description** =========================== ==================================== :attr:`linkDest.dest` destination :attr:`linkDest.fileSpec` file specification (path, filename) :attr:`linkDest.flags` descriptive flags :attr:`linkDest.isMap` is this a MAP? :attr:`linkDest.isUri` is this a URI? :attr:`linkDest.kind` kind of destination :attr:`linkDest.lt` top left coordinates :attr:`linkDest.named` name if named destination :attr:`linkDest.newWindow` name of new window :attr:`linkDest.page` page number :attr:`linkDest.rb` bottom right coordinates :attr:`linkDest.uri` URI =========================== ==================================== **Class API** .. class:: linkDest .. attribute:: dest Target destination name if :attr:`linkDest.kind` is :data:`LINK_GOTOR` and :attr:`linkDest.page` is *-1*. :type: str .. attribute:: fileSpec Contains the filename and path this link points to, if :attr:`linkDest.kind` is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`. :type: str .. attribute:: flags A bitfield describing the validity and meaning of the different aspects of the destination. As far as possible, link destinations are constructed such that e.g. :attr:`linkDest.lt` and :attr:`linkDest.rb` can be treated as defining a bounding box. But the flags indicate which of the values were actually specified, see :ref:`linkDest Flags`. :type: int .. attribute:: isMap This flag specifies whether to track the mouse position when the URI is resolved. Default value: False. :type: bool .. attribute:: isUri Specifies whether this destination is an internet resource (as opposed to e.g. a local file specification in URI format). :type: bool .. attribute:: kind Indicates the type of this destination, like a place in this document, a URI, a file launch, an action or a place in another file. Look at :ref:`linkDest Kinds` to see the names and numerical values. :type: int .. attribute:: lt The top left :ref:`Point` of the destination. :type: :ref:`Point` .. attribute:: named This destination refers to some named action to perform (e.g. a javascript, see :ref:`AdobeManual`). Standard actions provided are *NextPage*, *PrevPage*, *FirstPage*, and *LastPage*. :type: str .. attribute:: newWindow If true, the destination should be launched in a new window. :type: bool .. attribute:: page The page number (in this or the target document) this destination points to. Only set if :attr:`linkDest.kind` is :data:`LINK_GOTOR` or :data:`LINK_GOTO`. May be *-1* if :attr:`linkDest.kind` is :data:`LINK_GOTOR`. In this case :attr:`linkDest.dest` contains the **name** of a destination in the target document. :type: int .. attribute:: rb The bottom right :ref:`Point` of this destination. :type: :ref:`Point` .. attribute:: uri The name of the URI this destination points to. :type: str .. include:: footer.rst ================================================ FILE: docs/locales/ja/.readthedocs.yaml ================================================ # .readthedocs.yaml # Note: We use this dedicated yaml inside the locales/ja folder as RTD was having problems building a PDF # This yaml is the same as the main one - it just removes the PDF build option # Required version: 2 # Set the version of Python and other tools you might need build: os: ubuntu-20.04 tools: python: "3.9" # You can also specify other tool versions: # nodejs: "16" # rust: "1.55" # golang: "1.17" # Build documentation in the docs/ directory with Sphinx sphinx: configuration: docs/conf.py # Optionally declare the Python requirements required to build your docs python: install: - requirements: docs/requirements.txt ================================================ FILE: docs/locales/ja/LC_MESSAGES/404.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header-404.rst:-1 7d1db678351e48a589812b0fc43a3c6e msgid "Artifex" msgstr "" #: ../../header-404.rst:-1 1240b3bfde8e4c75af72a7add2aa6ece msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header-404.rst:-1 e9db42018d9749a3a1b1fcd7d2ffbad7 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../404.rst:4 47500cd0e1e4472092d58a3f1eb0de05 msgid "404!" msgstr "" #: ../../404.rst:7 00f23d61373848a99a4874c470e1479a msgid "**This page is not available.**" msgstr "**このページは利用できません。**" #: ../../404.rst:10 108326f9c443411e998790ba1e98be35 msgid "Please use the menu or search to find what you are looking for." msgstr "メニューまたは検索を使用して、お探しのものを見つけてください。" #: ../../footer.rst:60 eab1290efc024ba1b73c0d32ce382104 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/about-feature-matrix.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-08-16 14:20+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ja/LC_MESSAGES/about-performance.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-08-16 14:20+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ja/LC_MESSAGES/about.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 c21340a4b75747d5952e637a324049bf msgid "Artifex" msgstr "" #: ../../header.rst:-1 12768be3aef44279a0f53bb67e659597 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 4d3f2343a3e8462e92d346b6ef1bbe0f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../about.rst:10 6bf350a1548242f08f4231816b75ae9e msgid "Features Comparison" msgstr "機能の比較" #: ../../about.rst:16 e6e0680f36684a24b35c48e7756b8ee2 msgid "Feature Matrix" msgstr "機能比較表" #: ../../about.rst:18 fdad9ebd21e342da9d1b6b35ca5ad4e9 msgid "" "The following table illustrates how |PyMuPDF| compares with other typical" " solutions." msgstr "以下の表は、|PyMuPDF| が他の典型的な解決策と比較した場合の違いを示しています。" #: ../../about.rst:47 5f1d6f3b09ac43e1ae7043dc7a879c02 msgid "" "A note about **Office** document types (DOCX, XLXS, PPTX) and **Hangul** " "documents (HWPX). These documents can be loaded into |PyMuPDF| and you " "will receive a :ref:`Document ` object." msgstr "" #: ../../about.rst:49 9add749bf1d7451aabfcb79190677ddb msgid "There are some caveats:" msgstr "" #: ../../about.rst:52 a610a8b3f5cf4333938a9e7a75157f1d msgid "we convert the input to **HTML** to layout the content." msgstr "" #: ../../about.rst:53 a71abef4bb604e3b8f1065200afb7907 msgid "because of this the original page separation has gone." msgstr "" #: ../../about.rst:55 255d6618e34f4f11ae7a1a0f54f57322 msgid "" "When saving out the result any faithful representation of the original " "layout cannot be expected." msgstr "" #: ../../about.rst:57 59954cbab9914471b64ad43b7eb7a58b msgid "" "Therefore input files are mostly in a form that's useful for text " "extraction." msgstr "" #: ../../about.rst:65 f3ad21fdc6c841f090824af510994edb msgid "Performance" msgstr "パフォーマンス" #: ../../about.rst:69 482ba1a4696f429da50d900517f9001b msgid "" "To benchmark |PyMuPDF| performance against a range of tasks a test suite " "with a fixed set of :ref:`8 PDFs with a total of 7,031 " "pages` containing text & images is used to obtain " "performance timings." msgstr "" ":ref:`8つのPDFファイル（合計7,031ページ）` " "にテキストと画像が含まれている固定されたセットのテストスイートを使用して、|PyMuPDF| " "のパフォーマンスをさまざまなタスクに対してベンチマークします。" #: ../../about.rst:72 11c5e7e482204c7682f05223297c6488 msgid "Here are current results, grouped by task:" msgstr "以下は、タスクごとにグループ化された現在の結果です：" #: ../../about.rst:81 9f36f4db74ab492ba26cc4fb9946f818 msgid "" "For more detail regarding the methodology for these performance timings " "see: :ref:`Performance Comparison Methodology`." msgstr "これらのパフォーマンスのタイミングに関する方法の詳細については、:ref:`パフォーマンス比較方法` を参照してください。" #: ../../about.rst:89 e86ca33131a544e8a4cc0821737a9a86 msgid "License and Copyright" msgstr "ライセンスと著作権" #: ../../about.rst:93 061c6a01a19c40198fd34033af39cc6d msgid "" "|PyMuPDF| and |MuPDF| are now available under both, open-source |AGPL| " "and commercial license agreements. Please read the full text of the " "|AGPL| license agreement, available in the distribution material (file " "COPYING) and `on the GNU license page " "`_, to ensure that your use " "case complies with the guidelines of the license. If you determine you " "cannot meet the requirements of the |AGPL|, please contact `Artifex " "`_ for more information " "regarding a commercial license." msgstr "" "PyMuPDFとMuPDFは現在、オープンソースのAGPLと商用ライセンス契約の両方で提供されています。ライセンスのガイドラインに従うことを確認するため、配布資料（COPYINGファイル）と" " `ここ `_ " "にあるAGPLライセンス契約の全文をお読みください。AGPLの要件を満たせないと判断された場合は、商用ライセンスに関する詳細情報については、 " "`Artifex `_ にお問い合わせください。" #: ../../about.rst:111 0cf7adfbbbe6404aae5016ba8cf4ca79 msgid "" ":title:`Artifex` is the exclusive commercial licensing agent for " ":title:`MuPDF`." msgstr ":title:`Artifex` Artifexは、:title:`MuPDF` の独占的な商業ライセンスエージェントです。" #: ../../about.rst:113 1206bde366264e91900de44a990e7b13 msgid "" ":title:`Artifex`, the :title:`Artifex` logo, :title:`MuPDF`, and the " ":title:`MuPDF` logo are registered trademarks of :title:`Artifex Software" " Inc.`" msgstr "" ":title:`Artifex` 、:title:`Artifex` のロゴ、:title:`MuPDF` " "、およびMuPDFのロゴは、:title:`Artifex Software Inc.` の登録商標です。" #: ../../version.rst:3 b23f02d66d164eb195ed6512c8e9ff6c #, fuzzy msgid "This documentation covers PyMuPDF |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #: ../../version.rst:5 ca881a8c265b46618c644701ea14c695 msgid "" "The major and minor versions of |PyMuPDF| and |MuPDF| will always be the " "same. Only the third qualifier (patch level) may deviate from that of " "|MuPDF|." msgstr "" #: ../../version.rst:7 a91d12805e42498fb4eebcb3f7923eb8 msgid "" "Typically PyMuPDF is released more frequently than MuPDF so it will often" " be the case that the patch level of PyMuPDF will be greater than the " "embedded MuPDF." msgstr "" #: ../../version.rst:11 2e3b5e5955fc4cba8aafc25d3d650e7a msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2." msgstr "" #: ../../version.rst:13 a60af2aa03494194b19ecf8e3bc095fc msgid "Also see `pymupdf_version` and `mupdf_version`." msgstr "" #: ../../footer.rst:46 ea2d1136af82416baa3286db6ed38f96 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "This documentation covers **PyMuPDF " #~ "v1.23.0rc1** features as of **2023-08-10 " #~ "00:00:01**." #~ msgstr "" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.4**" #~ " features as of **2023-09-26 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.5**" #~ " features as of **2023-10-11 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.8**" #~ " features as of **2023-12-19 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.26**" #~ " features as of **2024-02-29 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.24.2**" #~ " features as of **2024-04-17 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.24.10**" #~ " features as of **2024-09-02 00:00:01**." #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.25.5**" #~ " features as of **2025-03-31 00:00:01**." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/algebra.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a244f13b9c764d21b6a4e35ef573b3fc msgid "Artifex" msgstr "" #: ../../header.rst:-1 9bd00aa1c6e2464c98edbdfe23c4f225 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 0bb8ce2fa7b8439cb16f9ec725fae345 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../algebra.rst:6 a46fc8868909429d85fea1440fd28881 msgid "Operator Algebra for Geometry Objects" msgstr "幾何学オブジェクトのためのオペレーター代数" #: ../../algebra.rst:10 f2868bfbb77d48739b417240e859be75 msgid "" "Instances of classes :ref:`Point`, :ref:`IRect`, :ref:`Rect`, :ref:`Quad`" " and :ref:`Matrix` are collectively also called \"geometry\" objects." msgstr "" "クラス :ref:`Point` 、 :ref:`IRect` 、 :ref:`Rect` 、 :ref:`Quad` 、および " ":ref:`Matrix` のインスタンスは、集合的に「幾何学オブジェクト」とも呼ばれます。" #: ../../algebra.rst:12 7c7e99aaa08449cc9a3e4a9c1891053e msgid "" "They all are special cases of Python sequences, see :ref:`SequenceTypes` " "for more background." msgstr "これらはすべてPythonシーケンスの特殊なケースであり、詳細については、PyMuPDFでのPythonシーケンスを引数として使用するを参照してください。" #: ../../algebra.rst:14 b6a45b1271a0423d9097d983f99dac54 msgid "" "We have defined operators for these classes that allow dealing with them " "(almost) like ordinary numbers in terms of addition, subtraction, " "multiplication, division, and some others." msgstr "これらのクラスには、加算、減算、乗算、除算など、通常の数値とほぼ同じように取り扱うための演算子が定義されています。" #: ../../algebra.rst:16 b84d121c948844b78d31027bcf1cc8bb msgid "This chapter is a synopsis of what is possible." msgstr "この章では、可能な操作の要約を説明します。" #: ../../algebra.rst:19 8da4401664bf45689416d5a624615e21 msgid "General Remarks" msgstr "一般的な注意事項" #: ../../algebra.rst:20 b27e0413604140b6a4e3d9dd5604397e msgid "" "Operators can be either **binary** (i.e. involving two objects) or " "**unary**." msgstr "演算子は2つのオブジェクトを含むバイナリ演算子または単項演算子になります。" #: ../../algebra.rst:22 ff83ad4ef4924a928f7fe7c91f007de7 msgid "" "The resulting type of **binary** operations is either a **new object of " "the left operand's class,** a bool or (for dot products) a float." msgstr "バイナリ演算の結果の型は、左オペランドのクラスの新しいオブジェクトまたはbool型です。" #: ../../algebra.rst:24 b6935b28e0494757bdefacd86e1f3a36 msgid "" "The result of **unary** operations is either a **new object** of the same" " class, a bool or a float." msgstr "単項演算の結果は、同じクラスの新しいオブジェクト、bool型、またはfloat型のいずれかです。" #: ../../algebra.rst:26 a1336f1afec74044ada260ccd870436a msgid "" "The binary operators `+, -, *, /` are defined for all classes. They " "*roughly* do what you would expect -- **except, that the second operand " "...**" msgstr "" "バイナリ演算子 ``+`` 、``-`` 、``*`` 、 ``/`` " "はすべてのクラスで定義されています。これらはおおよその期待通りの動作をしますが、2番目のオペランドは...（省略されました）。" #: ../../algebra.rst:28 e18cb846582247cb975a9ddc6340a73e msgid "" "may always be a number which then performs the operation on every " "component of the first one," msgstr "第2のオペランドは常に数値であり、それにより最初のオペランドのすべての要素に対して操作を行います。" #: ../../algebra.rst:29 e60ed0a7fa554df0a16910687c2c88be msgid "" "may always be a numeric sequence of the same length (2, 4 or 6) -- we " "call such sequences :data:`point_like`, :data:`rect_like`, " ":data:`quad_like` or :data:`matrix_like`, respectively." msgstr "" "第2のオペランドは常に同じ長さの数値のシーケンスであることができます（2つ、4つ、または6つ） - それぞれ :data:`point_like`" " 、 :data:`rect_like` 、 :data:`quad_like` 、または :data:`matrix_like` と呼びます。" #: ../../algebra.rst:31 d93daa3887f04faead0f46a53b4c2a9a msgid "" "Rectangles support **additional binary** operations: **intersection** " "(operator `\"&\"`), **union** (operator `\"|\"`) and **containment** " "checking." msgstr "矩形は追加のバイナリ演算をサポートしています：交差（演算子“&”）、結合（演算子“|”）、および包含チェック。" #: ../../algebra.rst:33 03d276c145154e428f81b4e854a12723 msgid "" "Binary operators fully support in-place operations. So if \"°\" is a " "binary operator then the expression `a °= b` is always valid and the same" " as `a = a ° b`. Therefore, be careful and do **not** do `p1 *= p2` for " "two points, because thereafter \"p1\" is a **float**." msgstr "バイナリ演算子は「インプレース演算」を完全にサポートしています。つまり、"°"がバイナリ演算子である場合、式 ``a °= b`` は常に有効であり、 ``a = a ° b`` と同じです。したがって、2つの点に対して ``p1 *= p2`` を行わないように注意してください。なぜなら、その後「p1」は浮動小数点数になってしまうからです。" #: ../../algebra.rst:37 b197551ac91841fba96a5406efd0e076 msgid "Unary Operations" msgstr "単項演算" #: ../../algebra.rst:40 ../../algebra.rst:59 299776843ce14340b3ffec69dbf18e83 #: 9ef10cc27f674df49def7dbf4b132848 msgid "Oper." msgstr "演算" #: ../../algebra.rst:40 ../../algebra.rst:59 0723d28bc56b478c85107cedb40b5793 #: 7bff453d3e3548e4910efaf0d7e280d4 msgid "Result" msgstr "結果" #: ../../algebra.rst:42 d7ac030d071642528ff3bf57fcc11bd3 msgid "bool(OBJ)" msgstr "" #: ../../algebra.rst:42 0d27ce4c315a43758b0c7f988ac2baca msgid "is false exactly if all components of OBJ are zero" msgstr "OBJのすべての成分がゼロの場合にのみfalse" #: ../../algebra.rst:43 3a98a962f2cb4317ad6986bbdec24e65 msgid "abs(OBJ)" msgstr "" #: ../../algebra.rst:43 6c1997e211ee4d939dd044c813508abb msgid "the rectangle area -- equal to norm(OBJ) for the other types" msgstr "他のタイプに対してnorm(OBJ)と等しい長方形の面積" #: ../../algebra.rst:44 94bcec1a0e3d4e96be8a96074d02378d msgid "norm(OBJ)" msgstr "" #: ../../algebra.rst:44 e0b98f2206cf4032b715abe02f8be8cd msgid "square root of the component squares (Euclidean norm)" msgstr "成分の二乗の平方根（ユークリッドノルム）" #: ../../algebra.rst:45 00744445072349b8b253bc092cc7bb87 msgid "+OBJ" msgstr "" #: ../../algebra.rst:45 0b56037ce3e04d528042a1a6098bb2f9 msgid "new copy of OBJ" msgstr "OBJの新しいコピー" #: ../../algebra.rst:46 0c1dfe4fe3344199b8b76d70f4f7d7f3 msgid "-OBJ" msgstr "" #: ../../algebra.rst:46 ef82c60af2dc4d238eba6b421e3047d9 msgid "new copy of OBJ with negated components" msgstr "成分が反転されたOBJの新しいコピー" #: ../../algebra.rst:47 ee6061816bb3437fa7e09c6d431dc788 msgid "~m" msgstr "" #: ../../algebra.rst:47 1e8a0c10344348238fc0f64c83edd642 msgid "inverse of matrix \"m\", or the null matrix if not invertible" msgstr "行列 \"m\" の逆行列、または逆行列が存在しない場合は零行列" #: ../../algebra.rst:52 398158a768f84b89a520021ea6d0a25f msgid "Binary Operations" msgstr "二項演算" #: ../../algebra.rst:53 01209ef26eeb4f6284e42a5165ad12aa msgid "" "These are expressions like `a ° b` where \"°\" is any of the operators " "`+, -, *, /`. Also binary operations are expressions of the form `a == b`" " and `b in a`." msgstr "これらは ``a ° b`` のような式であり、ここで「°」は ``+``, ``-``, ``*``, ``/`` などの演算子のいずれかです。また、バイナリ演算には ``a == b`` や ``b in a`` のような形式の式も含まれます。" #: ../../algebra.rst:55 347337c08b6e49ba8133b876c65de703 msgid "" "If \"b\" is a number, then the respective operation is executed for each " "component of \"a\". Otherwise, if \"b\" is **not a number,** then the " "following happens:" msgstr "もし「b」が数値である場合、それぞれの演算は「a」の各コンポーネントに対して実行されます。一方、「b」が数値ではない場合、以下のことが起こります：" #: ../../algebra.rst:61 882647f50a3548ada51850492e59336c msgid "a+b, a-b" msgstr "" #: ../../algebra.rst:61 529c2b3a1c8f440f8afd4fba9ce0396e msgid "component-wise execution, \"b\" must be \"a-like\"." msgstr "成分ごとの実行。\"b\" は \"a\" と同様の要素数である必要があります。" #: ../../algebra.rst:62 2606cc3b045c4835abe58d011464d50a msgid "a*m, a/m" msgstr "" #: ../../algebra.rst:62 7d3849829e3b4508827663e012314f30 msgid "" "\"a\" can be a point, rectangle or matrix and \"m\" is a " ":data:`matrix_like`. *\"a/m\"* is treated as *\"a*~m\"* (see note below " "for non-invertible matrices). If \"a\" is a **point** or a **rectangle**," " then *\"a.transform(m)\"* is executed. If \"a\" is a matrix, then matrix" " concatenation takes place." msgstr "" "\"a\" はポイント、矩形、または行列になりますが、\"m\" は :data:`matrix_like` でなければなりません。\"a/m\"" " は \"a*〜m\" として処理されます（非逆行列の場合は以下の注記を参照）。\"a\" " "がポイントまたは矩形の場合、\"a.transform(m)\" が実行されます。\"a\" が行列の場合、行列の連結が行われます。" #: ../../algebra.rst:67 b98d2bd8c76145a093239f6b2583ff78 msgid "a*b" msgstr "" #: ../../algebra.rst:67 55f9b0922451482484ef7fe2110fefb7 msgid "returns the **vector dot product** for a point \"a\" and point-like \"b\"." msgstr "点「a」と点のような「b」に対して、ベクトルの内積を返します。" #: ../../algebra.rst:68 2c02e64b04dd47a89a57341e5557c6f4 msgid "a&b" msgstr "" #: ../../algebra.rst:68 b1ebf38a599942378b28ecc93be28dbc msgid "" "**intersection rectangle:** \"a\" must be a rectangle and \"b\" " ":data:`rect_like`. Delivers the **largest rectangle** contained in both " "operands." msgstr "" "共通の長方形: \"a\" は長方形であり、\"b\" は :data:`rect_like` " "形式である必要があります。両方のオペランドに含まれる最大の長方形を返します。" #: ../../algebra.rst:71 6b94ffc704eb47269f5a3961a01cc914 msgid "a|b" msgstr "" #: ../../algebra.rst:71 f10408473ce74344941deb9adedaea81 msgid "" "**union rectangle:** \"a\" must be a rectangle, and \"b\" may be " ":data:`point_like` or :data:`rect_like`. Delivers the **smallest " "rectangle** containing both operands." msgstr "" "合併した長方形: \"a\" は長方形であり、\"b\" は 点のような :data:`point_like` :data:`rect_like`" " 形式である必要があります。両方のオペランドを含む最小の長方形を返します。" #: ../../algebra.rst:74 68ba14dfcb0944fb8f12d32ccd74acfc msgid "b in a" msgstr "" #: ../../algebra.rst:74 20c6156b787d407bba8ac0eb66d0003f msgid "" "if \"b\" is a number, then `b in tuple(a)` is returned. If \"b\" is " ":data:`point_like`, :data:`rect_like` or :data:`quad_like`, then \"a\" " "must be a rectangle, and `a.contains(b)` is returned." msgstr "" "もし \"b\" が数値である場合、 `b in tuple(a)` が返されます。もし \"b\" が :data:`point_like` " "形式、 :data:`rect_like` 形式、または :data:`quad_like` 形式である場合、\"a\" " "は長方形である必要があり、`a.contains(b)` が返されます。" #: ../../algebra.rst:77 14c642acfd6a4cc09dd70b7edfc9479d msgid "a == b" msgstr "" #: ../../algebra.rst:77 b5f52a2ccb364df6aafabfc00b804bfd msgid "``True`` if *bool(a-b)* is ``False`` (\"b\" may be \"a-like\")." msgstr "bool(a-b) が `False` であれば `True` を返します（\"b\"は\"a-like\"である可能性があります）。" #: ../../algebra.rst:81 91cf0864d56a40f89a084004444ece8e msgid "Please note an important difference to usual arithmetic:" msgstr "以下は通常の算術との重要な違いに注意してください：" #: ../../algebra.rst:83 c2257dafe2e54f93bdf6e878a27abb1e msgid "" "Matrix multiplication is **not commutative**, i.e. in general we have " "`m*n != n*m` for two matrices. Also, there are non-zero matrices which " "have no inverse, for example `m = Matrix(1, 0, 1, 0, 1, 0)`. If you try " "to divide by any of these, you will receive a `ZeroDivisionError` " "exception using operator *\"/\"*, e.g. for the expression " "`pymupdf.Identity / m`. But if you formulate `pymupdf.Identity * ~m`, the" " result will be `pymupdf.Matrix()` (the null matrix)." msgstr "" "行列の乗算は可換ではありません。つまり、一般に2つの行列に対して `m*n != n*m` " "が成り立ちます。また、逆行列を持たないゼロでない行列も存在します。例えば、`m = Matrix(1, 0, 1, 0, 1, 0)` " "のような行列があります。これらの行列で除算しようとすると、演算子 *\"/\"* を使用して `pymupdf.Identity / m` " "のような式で `ZeroDivisionError` 例外が発生します。しかし、`pymupdf.Identity * ~m` " "のように記述すると、結果は `pymupdf.Matrix()` （零行列）となります。" #: ../../algebra.rst:85 0e187d91aa3543128b18a63bdf168871 msgid "" "Admittedly, this represents an inconsistency, and we are considering to " "remove it. For the time being, you can choose to avoid an exception and " "check whether ~m is the null matrix, or accept a potential " "*ZeroDivisionError* by using `pymupdf.Identity / m`." msgstr "" "認めるところがあるかもしれませんが、これは矛盾を示しており、私たちはこれを取り除くことを検討しています。当面の間は、例外を回避し、`~m` " "が零行列であるかどうかをチェックするか、`pymupdf.Identity / m` を使用して `ZeroDivisionError` " "の可能性を受け入れることができます。" #: ../../algebra.rst:89 de603159545946e8bdc68fe78cd85024 msgid "" "With these conventions, all the usual algebra rules apply. For example, " "arbitrarily using brackets **(among objects of the same class!)** is " "possible: if r1, r2 are rectangles and m1, m2 are matrices, you can do " "this `(r1 + r2) * m1 * m2`." msgstr "" "これらの規則に従うと、すべての通常の代数のルールが適用されます。例えば、任意の括弧を使うことができます（同じクラスのオブジェクトの間で！）：もし " "`r1`, `r2` が長方形であり、`m1`, `m2` が行列であれば、次のようにできます： `(r1 + r2) * m1 * m2` 。" #: ../../algebra.rst:90 2e9035f1be214ad5993be5461f301e62 msgid "" "For all objects of the same class, `a + b + c == (a + b) + c == a + (b + " "c)` is true." msgstr "同じクラスのオブジェクトに対して、 `a + b + c == (a + b) + c == a + (b + c)` が成り立ちます。" #: ../../algebra.rst:91 695f00e56afc43e8bbde8536925b9ffc msgid "" "For matrices in addition the following is true: `(m1 + m2) * m3 == m1 * " "m3 + m2 * m3` (distributivity property)." msgstr "行列の加法については、次のような性質が成り立ちます： `(m1 + m2) * m3 == m1 * m3 + m2 * m3` （分配律）。" #: ../../algebra.rst:92 85174e316c684b489921150e95d1aed3 msgid "" "**But the sequence of applying matrices is important:** If r is a " "rectangle and m1, m2 are matrices, then -- **caution!:**" msgstr "ただし、行列の適用順序が重要です：もし `r` が長方形であり、 `m1` , `m2` が行列である場合、注意してください！次のような場合：" #: ../../algebra.rst:93 8db6b272b39a4051b95fd6474751c244 msgid "`r * m1 * m2 == (r * m1) * m2 != r * (m1 * m2)`" msgstr "" #: ../../algebra.rst:96 5a5c13a7f2b542b59628658c7a3217f1 msgid "Some Examples" msgstr "いくつかの例" #: ../../algebra.rst:99 b685ff344b354dd6b03324c45389e661 msgid "Manipulation with numbers" msgstr "数値の操作" #: ../../algebra.rst:100 92463489f90f4556b3d5a7b306e1e7ac msgid "" "For the usual arithmetic operations, numbers are always allowed as second" " operand. In addition, you can formulate `\"x in OBJ\"`, where x is a " "number. It is implemented as `\"x in tuple(OBJ)\"`::" msgstr "" "通常の算術演算では、数値は常に第二オペランドとして使用できます。さらに、`\"x in OBJ\"` " "のように式を記述することもできます。ここで、xは数値です。これは `\"x in tuple(OBJ)\"` として実装されています::" #: ../../algebra.rst:108 d3192c1a63bb460ba17fe04f2de5b3ff msgid "" "The following will create the upper left quarter of a document page " "rectangle::" msgstr "以下は、ドキュメントページの四角形の左上の四分の一を作成します::" #: ../../algebra.rst:116 9f9d44b5091a4a65844a451e8d7c92c4 msgid "" "The following will deliver the **middle point of a line** that connects " "two points **p1** and **p2**::" msgstr "以下は、点 `p1` と点 `p2` を結ぶ直線の中点を求めます::" #: ../../algebra.rst:125 2908e3f62351463a817217bed9ee7101 msgid "" "Compute the **vector dot product** of two points. You can compute the " "**cosine of angles** and check orthogonality." msgstr "2つの点のベクトル内積を計算します。これにより、角度のコサインを計算したり、直交性を確認したりすることができます。" #: ../../algebra.rst:149 05936628739f4f5392d49359e0f8860d msgid "Manipulation with \"like\" Objects" msgstr "「Like」オブジェクトを用いた操作" #: ../../algebra.rst:151 64ff208b10184910a7052e2d2fde5560 msgid "" "The second operand of a binary operation can always be \"like\" the left " "operand. \"Like\" in this context means \"a sequence of numbers of the " "same length\". With the above examples::" msgstr "2項演算の第2オペランドは常に左オペランドと「like」することができます。「Like」とは、この文脈では「同じ長さの数列」という意味です。上記の例を用いて説明します。" #: ../../algebra.rst:162 7626451d4f89418ea6f21c0194766c1e msgid "To shift a rectangle for 5 pixels to the right, do this::" msgstr "長方形を右に5ピクセルシフトさせるには、次のようにします::" #: ../../algebra.rst:168 ffbacdbea5aa4828ab455e4e9da44bf2 msgid "" "Points, rectangles and matrices can be *transformed* with matrices. In " "PyMuPDF, we treat this like a **\"multiplication\"** (or resp. " "**\"division\"**), where the second operand may be \"like\" a matrix. " "Division in this context means \"multiplication with the inverted " "matrix\"::" msgstr "点、長方形、および行列は行列で変換できます。PyMuPDFでは、これを「乗算」（または「除算」とも）として扱います。ここで、第2オペランドは行列と「like」することができます。「除算」とは、この文脈では「逆行列との乗算」を意味します。" #: ../../algebra.rst:208 f6063ded1f794fdfa330d05aab12b59a msgid "As a specialty, rectangles support additional binary operations:" msgstr "特に、長方形は追加の2項演算をサポートしています：" #: ../../algebra.rst:210 8ddb30b3a1e6414cb4ab801649852302 msgid "**intersection** -- the common area of rectangle-likes, operator *\"&\"*" msgstr "**交差** -- 長方形や類似の長方形の共通領域を示す演算子 *\"&\"*" #: ../../algebra.rst:211 44b3d1c0634a46f1ae3506fe5d9c9046 msgid "" "**inclusion** -- enlarge to include a point-like or rect-like, operator " "*\"|\"*" msgstr "**含有** -- 点状または長方形状を含むように拡大する演算子 *\"|\"*" #: ../../algebra.rst:212 462847c9ff494bef9387ce0aff093bfd msgid "**containment** check -- whether a point-like or rect-like is inside" msgstr "**含有確認** 点状または長方形状が内部にあるかどうかを確認します" #: ../../algebra.rst:214 8733fac916f74438a2cecf7b54a9c218 msgid "" "Here is an example for creating the smallest rectangle enclosing given " "points::" msgstr "以下は、与えられた点を囲む最小の長方形を作成する例です::" #: ../../footer.rst:60 1533c6c3a8344ce0b45e9762c0145328 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "Binary operators fully support in-place" #~ " operations, so expressions like `a " #~ "/= b` are valid if b is " #~ "numeric or \"a_like\"." #~ msgstr "" #~ "バイナリ演算子は、すべての場所で完全にサポートされているため、``b`` が数値または「a_like」の場合、 " #~ "``a /= b`` のような式が有効です" #~ msgid "" #~ "For every geometry object \"a\" and " #~ "every number \"b\", the operations \"a" #~ " ° b\" and \"a °= b\" are " #~ "always defined for the operators *+, " #~ "-, *, /*. The respective operation " #~ "is simply executed for each component" #~ " of \"a\". If the **second operand" #~ " is not a number**, then the " #~ "following is defined:" #~ msgstr "" #~ "あらゆるジオメトリオブジェクト\"a\"とあらゆる数値 \"b\" に対して、演算子 ``+``," #~ " ``-`` , ``*`` , ``/`` については常に " #~ "\"a ° b\" と \"a °= b\" " #~ "の操作が定義されています。それぞれの操作は、\"a\" " #~ "の各成分に対して単純に実行されます。もし第二オペランドが数値でない場合、次のように定義されます：" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/annot.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4ac2fe405aa74919af4d4a1801389523 msgid "Artifex" msgstr "" #: ../../header.rst:-1 aee68aa3a3cc4589bddde105fa520c68 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 60584b8003094a8b9570ee372d8eab4b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../annot.rst:7 f0fb0074a9b6446f8124c5e84ab64978 msgid "Annot" msgstr "Annot (注釈)" #: ../../annot.rst:9 fafaf69d450d48c5b26a1a93cb2eaa69 msgid "|pdf_only_class|" msgstr "PDFのみ。" #: ../../annot.rst:11 4869b122c6834f279f19045fee171ca8 msgid "Quote from the :ref:`AdobeManual`:" msgstr ":ref:`AdobeManual` からの引用: " #: ../../annot.rst:13 e7b3050079714378a72611a6fde2125b msgid "" "*\"An annotation associates an object such as a note, sound, or movie " "with a location on a page of a PDF document, or provides a way to " "interact with the user by means of the mouse and keyboard.\"*" msgstr "「注釈は、ノート、音声、動画などのオブジェクトをPDFドキュメントのページ上の位置に関連付けるか、マウスとキーボードを介してユーザーと対話する手段を提供します。」" #: ../../annot.rst:15 5c314b35139f446694f6aca06c7824f1 msgid "" "There is a parent-child relationship between an annotation and its page. " "If the page object becomes unusable (closed document, any document " "structure change, etc.), then so does every of its existing annotation " "objects -- an exception is raised saying that the object is \"orphaned\"," " whenever an annotation property or method is accessed." msgstr "注釈とそのページとの間には親子関係があります。ページオブジェクトが使用できなくなる場合（閉じたドキュメント、文書構造の変更など）、そのページに存在するすべての注釈オブジェクトも同様に使用できなくなります。注釈のプロパティやメソッドにアクセスされるたびに、オブジェクトが「孤立した」という例外が発生します。" #: ../../annot.rst:18 ce89c615b0d9400e96011970b5b97556 msgid "**Attribute**" msgstr "**アトリビュート** " #: ../../annot.rst:18 715a7d9d0eca46759c21efd06dcef6ad msgid "**Short Description**" msgstr "**短い説明** " #: ../../annot.rst:20 46ba2c1aef7f47fb8cf735ab0ab8ca51 msgid ":meth:`Annot.delete_responses`" msgstr "" #: ../../annot.rst:20 542edab529f14f8a90c247c58f61d0e4 msgid "delete all responding annotations" msgstr "すべての応答アノテーションを削除します" #: ../../annot.rst:21 d6f4ad7997854c15ba7ef55c7c2df885 msgid ":meth:`Annot.get_file`" msgstr "" #: ../../annot.rst:21 df78c21ef62f4d29b9892ced6ce30eab msgid "get attached file content" msgstr "添付ファイルの内容を取得します" #: ../../annot.rst:22 aaa2f1576e2940d187b785f39fd5d297 msgid ":meth:`Annot.get_oc`" msgstr "" #: ../../annot.rst:22 52de51aa8f364679a043608a648fdb6d msgid "get :data:`xref` of an :data:`OCG` / :data:`OCMD`" msgstr ":data:`xref` を :data:`OCG` または :data:`OCMD` に取得します。" #: ../../annot.rst:23 ba830719161c41318892442d95b2cb34 msgid ":meth:`Annot.get_pixmap`" msgstr "" #: ../../annot.rst:23 558b79769da645e1be5e25ee89f039ab msgid "image of the annotation as a pixmap" msgstr "アノテーションの画像をピクマップとして取得します" #: ../../annot.rst:24 a7049ccda64e4dd6890da7abe84fabf6 msgid ":meth:`Annot.get_sound`" msgstr "" #: ../../annot.rst:24 374a09b731894e87b56c7e841b17d330 msgid "get the sound of an audio annotation" msgstr "オーディオアノテーションの音声を取得します" #: ../../annot.rst:25 35a90d1b5a004ad387963f3d9607d749 msgid ":meth:`Annot.get_text`" msgstr "" #: ../../annot.rst:25 ../../annot.rst:26 6131792a9d994335b4444e4823388a9a #: f86eecd4858f4cb89a366a146014aee5 msgid "extract annotation text" msgstr "アノテーションテキストを抽出します" #: ../../annot.rst:26 04cf9bb3fb1442709930c64bc5f6b0bb msgid ":meth:`Annot.get_textbox`" msgstr "" #: ../../annot.rst:27 19db3425545544fcbcd820ce607ec897 msgid ":meth:`Annot.get_textpage`" msgstr "" #: ../../annot.rst:27 c85fb9dd00d64ff99bd74482953c24bf msgid "create a TextPage for the annotation" msgstr "アノテーションのためのポップアップを作成します" #: ../../annot.rst:28 802ef16921bd4a60800fbad10cc481fd msgid ":meth:`Annot.set_border`" msgstr "" #: ../../annot.rst:28 2237d589cf4b43f8accb31706b0ac2e1 msgid "set annotation's border properties" msgstr "アノテーションの境界線のプロパティを設定します" #: ../../annot.rst:29 d6e3ab0ff8c247faa2df18a3dbd4fb5f msgid ":meth:`Annot.set_blendmode`" msgstr "" #: ../../annot.rst:29 8ff755a8802d4e4bb4f4c6466fd93439 msgid "set annotation's blend mode" msgstr "アノテーションのブレンドモードを設定します" #: ../../annot.rst:30 ff206dc2f63444dfae9fbe12712ba514 msgid ":meth:`Annot.set_colors`" msgstr "" #: ../../annot.rst:30 3a8dce63eadd4ffe82a27bc21a526045 msgid "set annotation's colors" msgstr "アノテーションの色を設定します" #: ../../annot.rst:31 ../../annot.rst:341 7c620a1bbb3d466d8c82b9c8817c33ee #: a00f8a2d06fa46afb1028c82837e4185 msgid ":meth:`Annot.set_flags`" msgstr "" #: ../../annot.rst:31 37269417aa5845e78bc95975097fddad msgid "set annotation's flags field" msgstr "アノテーションのフラグフィールドを設定します" #: ../../annot.rst:32 60f6edb527ee49f1935786a1f19697cb msgid ":meth:`Annot.set_irt_xref`" msgstr "" #: ../../annot.rst:32 fe64d8f927974fa7be28efe034d209b8 msgid "define the annotation to being \"In Response To\"" msgstr "アノテーションを「応答対象」として定義します" #: ../../annot.rst:33 efcba97648754ee0b6f2bf66c5fb7b3b msgid ":meth:`Annot.set_name`" msgstr "" #: ../../annot.rst:33 f1f066d0c2da4d5f93f7b21c9e06512b msgid "set annotation's name field" msgstr "アノテーションの名前フィールドを設定します" #: ../../annot.rst:34 ../../annot.rst:342 068e0ee638a844e4b73d54c8713fd9bb #: 444417b076ed4a7f9938de802c9c8687 msgid ":meth:`Annot.set_oc`" msgstr "" #: ../../annot.rst:34 2afdd097e4904b54a8f1ea48f5b61be3 msgid "set :data:`xref` to an :data:`OCG` / :data:`OCMD`" msgstr ":data:`xref` を :data:`OCG` または :data:`OCMD` に設定します。" #: ../../annot.rst:35 c399de4849964e058e1637e53fdef2f9 msgid ":meth:`Annot.set_opacity`" msgstr "" #: ../../annot.rst:35 fff897c6b9cd4cf7bfd2472ea748ca06 msgid "change transparency" msgstr "透明度を変更します" #: ../../annot.rst:36 d97cf692893c4fe7a6b799f4897c0aef msgid ":meth:`Annot.set_open`" msgstr "" #: ../../annot.rst:36 75aaff0f9c3c458ab962d5b77a5d79d3 msgid "open / close annotation or its Popup" msgstr "アノテーションまたはそのポップアップを開く/閉じる" #: ../../annot.rst:37 39f62e91ffef48ce9321e816caa20faa msgid ":meth:`Annot.set_popup`" msgstr "" #: ../../annot.rst:37 a674eec367f341508c884d315088746a msgid "create a Popup for the annotation" msgstr "アノテーションのためのポップアップを作成します" #: ../../annot.rst:38 ../../annot.rst:340 305b0c54c12a450e8f06569799bb8a9f #: f592c57486d9486c86df308aa89526da msgid ":meth:`Annot.set_rect`" msgstr "" #: ../../annot.rst:38 26f28928df154a75b841a456bdfdbf0d msgid "change annotation rectangle" msgstr "アノテーションの長方形を変更します" #: ../../annot.rst:39 de6a1b1b820b471b86603c34dea03532 msgid ":meth:`Annot.set_rotation`" msgstr "" #: ../../annot.rst:39 9acc32b08f1d4f599b3735e31324426f msgid "change rotation" msgstr "回転を変更します" #: ../../annot.rst:40 ../../annot.rst:343 18be6c4fae4e4cccb293fd8e12521dae #: 5200f1161df84772b72d390ec55d63cc msgid ":meth:`Annot.update_file`" msgstr "" #: ../../annot.rst:40 c1b5d04cd03e4575a6d8bc9e47a2ac7f msgid "update attached file content" msgstr "添付ファイルの内容を更新します" #: ../../annot.rst:41 736a77ca795b4bffab978f162c15c221 msgid ":meth:`Annot.update`" msgstr "" #: ../../annot.rst:41 53fe58b99d874419bf45e91f443bea49 msgid "apply accumulated annot changes" msgstr "蓄積されたアノテーションの変更を適用します" #: ../../annot.rst:42 076fef78de8747f98f8de5614822a3a3 msgid ":attr:`Annot.blendmode`" msgstr "" #: ../../annot.rst:42 3663d5144b7e4772a20a3ab76b0b7378 msgid "annotation BlendMode" msgstr "アノテーションのブレンドモード" #: ../../annot.rst:43 209656247f2147b79d61220568d6e982 msgid ":attr:`Annot.border`" msgstr "" #: ../../annot.rst:43 cd995c15bfff4706a84f1d0deeef716c msgid "border details" msgstr "境界線の詳細" #: ../../annot.rst:44 a5a847e7aa1e4a66a59312e3ad69222e msgid ":attr:`Annot.colors`" msgstr "" #: ../../annot.rst:44 7b16476edb2c47ee929046394941f61e msgid "border / background and fill colors" msgstr "境界線/背景および塗りつぶしの色" #: ../../annot.rst:45 c79db9da10a34adf8724954ae760d148 msgid ":attr:`Annot.file_info`" msgstr "" #: ../../annot.rst:45 5e6d650320a44ec89edde9ad8443d028 msgid "get attached file information" msgstr "添付ファイル情報を取得します" #: ../../annot.rst:46 830bf8e01251454db4eff541902734e7 msgid ":attr:`Annot.flags`" msgstr "" #: ../../annot.rst:46 d8e2f38116e34d6b8bcc0e11a02f64c4 msgid "annotation flags" msgstr "アノテーションフラグ" #: ../../annot.rst:47 427dbbb309334a4e938d8526af8aedd7 msgid ":attr:`Annot.has_popup`" msgstr "" #: ../../annot.rst:47 60549aa88002459b888f805a2649e95e msgid "whether annotation has a Popup" msgstr "アノテーションにポップアップがあるかどうか" #: ../../annot.rst:48 91cb2647177c40108aa8a389fbe4baba msgid ":attr:`Annot.irt_xref`" msgstr "" #: ../../annot.rst:48 4b1a08935c844e1b94fd19e67c73c4bf msgid "annotation to which this one responds" msgstr "このアノテーションへの応答としてのアノテーション" #: ../../annot.rst:49 c80c1d9523e54c13bf015a7802006f46 msgid ":attr:`Annot.info`" msgstr "" #: ../../annot.rst:49 e24c29731fb9426296860ef9e14c70f4 msgid "various information" msgstr "さまざまな情報" #: ../../annot.rst:50 9b1bc0b4f5604360a0fb530ee5571f6f msgid ":attr:`Annot.is_open`" msgstr "" #: ../../annot.rst:50 76000b5c78d64a51b15f2dfb48416053 msgid "whether annotation or its Popup is open" msgstr "アノテーションまたはそのポップアップが開いているかどうか" #: ../../annot.rst:51 c908f9af6c5e4097b190ab575189cc0e msgid ":attr:`Annot.line_ends`" msgstr "" #: ../../annot.rst:51 5b4b1ee3f3ae4f66af35ac09445805c4 msgid "start / end appearance of line-type annotations" msgstr "線タイプのアノテーションの始点/終点の外観" #: ../../annot.rst:52 270077d780344f6c94f61715f13de4c2 msgid ":attr:`Annot.next`" msgstr "" #: ../../annot.rst:52 0dd927ea19014ab0ab931ee426aa46a2 msgid "link to the next annotation" msgstr "次のアノテーションへのリンク" #: ../../annot.rst:53 0642e6954b8f41758e18c9fec902315c msgid ":attr:`Annot.opacity`" msgstr "" #: ../../annot.rst:53 55103257955240a6b3c311e8e1f97f3c msgid "the annot's transparency" msgstr "アノテーションの透明度" #: ../../annot.rst:54 7528c54e1c664627851d592e77e4359b msgid ":attr:`Annot.parent`" msgstr "" #: ../../annot.rst:54 d12a83a84aea44868a11feca2fd75f9e msgid "page object of the annotation" msgstr "アノテーションのページオブジェクト" #: ../../annot.rst:55 17d31eb890f346608a29bac66b130ede msgid ":attr:`Annot.popup_rect`" msgstr "" #: ../../annot.rst:55 e67d5b1efe1a49f8824bf40d6af292e8 msgid "rectangle of the annotation's Popup" msgstr "アノテーションのポップアップの長方形" #: ../../annot.rst:56 f5012088621c45f4a0cfa4ff69b400c8 msgid ":attr:`Annot.popup_xref`" msgstr "" #: ../../annot.rst:56 3c9f31c943c04997b05236036e58e2a7 msgid "the PDF :data:`xref` number of the annotation's Popup" msgstr "アノテーションのポップアップのPDF :data:`xref` 番号" #: ../../annot.rst:57 b0aaf4fc5d1d46a69cbca9c8576c4dff msgid ":attr:`Annot.rect`" msgstr "" #: ../../annot.rst:57 a3afa859fcc54f03b9928dd3e3b37411 msgid "rectangle containing the annotation" msgstr "アノテーションを含む長方形" #: ../../annot.rst:58 e5405a3d8d6c48e3b0ba2375b00d54fc msgid ":attr:`Annot.type`" msgstr "" #: ../../annot.rst:58 49ea84134cbd4fcfa71613fdc7c994d4 msgid "type of the annotation" msgstr "アノテーションのタイプ" #: ../../annot.rst:59 aedf999133ed4add859f5f25fcfd9c0a msgid ":attr:`Annot.vertices`" msgstr "" #: ../../annot.rst:59 0328a5222a444a84b329ee20a13d1815 msgid "point coordinates of Polygons, PolyLines, etc." msgstr "ポリゴン、ポリラインなどの点の座標" #: ../../annot.rst:60 593f8d9df1724b5abbabd4b0fb42cb5f msgid ":attr:`Annot.xref`" msgstr "" #: ../../annot.rst:60 73d760603078437db968d81892fe5450 msgid "the PDF :data:`xref` number" msgstr "PDF :data:`xref` 番号" #: ../../annot.rst:63 df3b29896fc84aa687b9b3d812b47830 msgid "**Class API**" msgstr " **APIクラス** " #: ../../annot.rst:75 b763b56670344531ae43994d27d0e054 msgid "Changed in v1.19.2: added support of dpi parameter." msgstr "v1.19.2で変更: dpiパラメータのサポートが追加されました。" #: ../../annot.rst:77 571f3475af9d4fd8af0faef1dae8b761 msgid "" "Creates a pixmap from the annotation as it appears on the page in " "untransformed coordinates. The pixmap's :ref:`IRect` equals " "*Annot.rect.irect* (see below). **All parameters are keyword only.**" msgstr "" "変換されていない座標でページ上に表示される注釈からピクスマップを作成します。ピクスマップの :ref:`IRect` は " "*Annot.rect.irect* と同じです（以下を参照）。 **すべてのパラメータはキーワード専用です。** " #: ../../annot.rst 038416b4a91041e89e078df4fe4f5636 #: 046b68e35745422e8e27b6ad4743720b 0ef49f86e0bd43f78e79e32e94eeea45 #: 176c3a7acc6e46d38ef37bbfe97eabda 1795f42bf0b242078204d40d7a212c9a #: 2ab60eb3db5f4b3594f30a2bb7fd5444 388ae783a9ec418581e0f622c2641963 #: 43c0bbc7ec774e96973a8f08c6370ebf 4e661fceb8be4c56850376cc43c38594 #: 5327b6738ac2466a95ae4ef2989536c3 7698812a2a694b63b8da213e56c66c7e #: a57f1370f9ac44c2b28c69413752355b a97c7424f15243ca9fa1102ea36941f0 #: bff13711337448f7809f30648c7765cd c8747aff1faa43f59b605c163d80ed7a #: d304c87c1b314f8f8d8449beb2cb9f43 e366806d4cdc4805a5cf6e6605d4c7ab #: e6d90ec622494f2cad21e1c4990e3a26 f73c89ed9881402ba2bd06564113f2e8 #: fe526c08b06a4286849cdeea133c925d msgid "Parameters" msgstr "パラメータ" #: ../../annot.rst:79 4ea40779573a4cd48d2f0ca41a27b6cb msgid "a matrix to be used for image creation. Default is :ref:`Identity`." msgstr "画像の作成に使用される行列。デフォルトは :ref:`Identity` です。" #: ../../annot.rst:81 1ceeea87c25445779a772f81c247bf10 msgid "" "(new in v1.19.2) desired resolution in dots per inch. If not `None`, the " "matrix parameter is ignored." msgstr "（v1.19.2で新規追加）インチあたりのドット数で指定された解像度。 `None` でない場合、matrixパラメータは無視されます。" #: ../../annot.rst:83 17577d5328264f3c8b2c93127b76cb6c msgid "a colorspace to be used for image creation. Default is ``pymupdf.csRGB``." msgstr "画像の作成に使用されるカラースペース。デフォルトは ``pymupdf.csRGB`` です。" #: ../../annot.rst:86 93850b04eff54b39a748a09ca5d3e6bd msgid "whether to include transparency information. Default is ``False``." msgstr "透明情報を含めるかどうか。デフォルトは ``False`` です。" #: ../../annot.rst 089309c51cd74976a42c4fcddda08a0a #: 09996d0975d243b1bc59b758b7d44173 1b331e1086824733a78f979f849d4845 #: 4817d4a35c28463eadae53476e0fd0d5 4b59e1c18c4147e69674c7d1e86501d1 #: 4c64d5922d9847968b2eeaee6487d0d0 4df6734c085c4a6ba495179996cfe92c #: 6347f866f7334ddda019820946166705 67048e418fbe44a79f9f63c0d53cb3a5 #: 7da6735c6b7f428e9eef30245825960b 7e4ad8f3110c429ea89f047da218ee26 #: 7f141e9ca331471ba531fcb59d32b10d 90d37be980f143b8aa9b4c16f83f6c90 #: a74cb6e028054b5abf3bcf4af3e18ad5 a838020417bb45188717e971f12c4b8f #: a8439c00be7b4164a1bbeae31ecffb57 a88e7e1341604dbf90a4215903761bf1 #: b193bdba031541f882f6d4d77564f78c bad1047750b244bca5505f7e797508bc #: d5d3fd4c788c48d6a3ad00aa4327e554 dc6f3b8d0e814a898c59d6e18c7b6fac #: ddc5fc79a0cd4e73a90a35b7de615f40 e556cbfd31a6417f8e4aab208b84c15a #: f867cc47820b4df6923b1b5b90969f1b msgid "Return type" msgstr "戻り値の型" #: ../../annot.rst:88 4081b82925b34d7aa9202a29b34e6645 msgid ":ref:`Pixmap`" msgstr "" #: ../../annot.rst:92 b9b41dd1363b465fb91e965b05c005a3 msgid "" "If the annotation has just been created or modified, you should " ":meth:`Document.reload_page` the page first via `page = " "doc.reload_page(page)`." msgstr "" "注釈が作成または変更されたばかりの場合、まず ``page = doc.reload_page(page)`` " "を使用してページを再読み込みする必要があります。" #: ../../annot.rst:94 968363fd034a4b84834bfe008fd58160 msgid "" "The pixmap will have *\"premultiplied\"* pixels if `alpha=True`. To learn" " about some background, e.g. look for \"Premultiplied alpha\" `in this " "online glossary " "`_." msgstr "" #: ../../annot.rst:112 ../../annot.rst:133 059d5413f3154aaa8134479d9629d7da #: 5b109c06581d4245b9034c003ef2e32f msgid "New in 1.18.0" msgstr "1.18.0 で新たに追加" #: ../../annot.rst:114 70fc1c944cd84ce18b5f51c59bbb47f0 msgid "" "Retrieves the content of the annotation in a variety of formats -- much " "like the same method for :ref:`Page`.. This currently only delivers " "relevant data for annotation types 'FreeText' and 'Stamp'. Other types " "return an empty string (or equivalent objects)." msgstr "" "さまざまなフォーマットで注釈の内容を取得します - これは :ref:`Page` " "の同じメソッドのように動作します。現在、これはアノテーションタイプ「FreeText」と「Stamp」に関連するデータのみを提供します。他の種類は空の文字列（または同等のオブジェクト）を返します。" #: ../../annot.rst:116 4f2629a0de0d499f8b80783953ee846e msgid "" "(positional only) the desired format - one of the following values. " "Please note that this method works exactly like the same-named method of " ":ref:`Page`. * \"text\" -- :meth:`TextPage.extractTEXT`, default * " "\"blocks\" -- :meth:`TextPage.extractBLOCKS` * \"words\" -- " ":meth:`TextPage.extractWORDS` * \"html\" -- :meth:`TextPage.extractHTML` " "* \"xhtml\" -- :meth:`TextPage.extractXHTML` * \"xml\" -- " ":meth:`TextPage.extractXML` * \"dict\" -- :meth:`TextPage.extractDICT` * " "\"json\" -- :meth:`TextPage.extractJSON` * \"rawdict\" -- " ":meth:`TextPage.extractRAWDICT`" msgstr "" #: ../../annot.rst:116 f5480fbc3f3f42fba82218a8e4aec39e msgid "" "(positional only) the desired format - one of the following values. " "Please note that this method works exactly like the same-named method of " ":ref:`Page`." msgstr "" "(位置指定のみ) 望ましいフォーマット - 以下のいずれかの値の1つです。このメソッドは、:ref:`Page` " "の同名のメソッドとまったく同じように動作することに注意してください。" #: ../../annot.rst:118 72a5b0cb198a4de4a1b5bd8012921a2d msgid "\"text\" -- :meth:`TextPage.extractTEXT`, default" msgstr "\"text\" -- :meth:`TextPage.extractTEXT`、デフォルト" #: ../../annot.rst:119 a0de89ee87384b559b91cb65e53fd4fe msgid "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" msgstr "" #: ../../annot.rst:120 abb67ab204e8498a82f39f7786634fa3 msgid "\"words\" -- :meth:`TextPage.extractWORDS`" msgstr "" #: ../../annot.rst:121 2a65cab359de401d84fb6c06d18af7fe msgid "\"html\" -- :meth:`TextPage.extractHTML`" msgstr "" #: ../../annot.rst:122 ebb1a0a333b94886a085c62c2910b11b msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`" msgstr "" #: ../../annot.rst:123 039f6bd299a1459984f1378d7506db1d msgid "\"xml\" -- :meth:`TextPage.extractXML`" msgstr "" #: ../../annot.rst:124 def0587d2e904e678a48944fd55d8845 msgid "\"dict\" -- :meth:`TextPage.extractDICT`" msgstr "" #: ../../annot.rst:125 9d446d90b12e480186eb0f5d4d6a88ca msgid "\"json\" -- :meth:`TextPage.extractJSON`" msgstr "" #: ../../annot.rst:126 ba83222452844c0280bc4ca743ec52d2 msgid "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" msgstr "" #: ../../annot.rst:128 fc5b291ff14745a4acd435eba57c0ee4 msgid "" "(keyword only) restrict the extraction to this area. Should hardly ever " "be required, defaults to :attr:`Annot.rect`." msgstr "(キーワードのみ) このエリアに抽出を制限します。ほとんど必要ない場合がほとんどで、デフォルトは :attr:`Annot.rect` です。" #: ../../annot.rst:129 58a7b13ec10244cab579c577a4a02451 msgid "" "(keyword only) control the amount of data returned. Defaults to simple " "text extraction." msgstr "(キーワードのみ) 返されるデータの量を制御します。単純なテキスト抽出がデフォルトです。" #: ../../annot.rst:135 abea461b229f40449176733f81fe3e1f msgid "" "Return the annotation text. Mostly (except line breaks) equal to " ":meth:`Annot.get_text` with the \"text\" option." msgstr "注釈のテキストを返します。主に（改行を除く）「text」オプションを使用した :meth:`Annot.get_text` と同等です" #: ../../annot.rst:137 7769e9ff53bb477581a82b545145ed52 msgid "the area to consider, defaults to :attr:`Annot.rect`." msgstr "rect (rect-like) – 考慮する領域、デフォルトは :attr:`Annot.rect` です。" #: ../../annot.rst:142 2e28ab6b2bd740c788a328a8a392b3d3 #, fuzzy msgid "Create a :ref:`TextPage` for the annotation." msgstr "アノテーションのためのポップアップを作成します" #: ../../annot.rst:144 ec86c28fbc9c4ea5a4520e3182ebac54 msgid "" "indicator bits controlling the content available for subsequent text " "extractions and searches -- see the parameter of :meth:`Annot.get_text`." msgstr "" "後続のテキスト抽出や検索に利用可能なコンテンツを制御する指標ビット -- :meth:`Annot.get_text` " "のパラメータを参照してください。" #: ../../annot.rst:146 f524fdc0ad6649eabe0dcea86d45490d msgid "restrict extracted text to this area." msgstr "抽出されるテキストをこのエリアに制限します。" #: ../../annot.rst 00ab1155c33d4b8b909387ee865f0f14 #: 054667c67ee948229ce41dcc4618fb84 70e6a4c25ac54573a0e41c8e5ca39783 #: 75932b217be7487a9362d25abfb1105c a5e875b7000f42ec9309633efaa12429 #: c194084f626c4b5799f1d232a00741a2 ffd675b9852a4f828c4dfe677c57a2bf msgid "Returns" msgstr "戻り値" #: ../../annot.rst:148 195337666ae04da792bf99b2e5fc7381 msgid ":ref:`TextPage`" msgstr "" #: ../../annot.rst:150 c08b99010b1b4e45886ecf4295e20ea1 msgid "|history_begin|" msgstr "" #: ../../annot.rst:152 b9da3f595018401c8b8eeb0c1529cca7 msgid "v1.25.5: fixed `clip` arg." msgstr "" #: ../../annot.rst:154 0201b53debf84074b8cde915dfcee8f4 msgid "|history_end|" msgstr "" #: ../../annot.rst:158 7980023e59354afead5f160d58e260cb msgid "Changed in version 1.16.10" msgstr "バージョン 1.16.10 で変更" #: ../../annot.rst:160 0b5d367dc98e4a3a9b3fe1c292ce8cb6 msgid "" "Changes annotation properties. These include dates, contents, subject and" " author (title). Changes for *name* and *id* will be ignored. The update " "happens selectively: To leave a property unchanged, set it to ``None``. " "To delete existing data, use an empty string." msgstr "" "注釈のプロパティを変更します。これには日付、内容、題名、および著者（タイトル）が含まれます。*名前* と *ID* " "の変更は無視されます。更新は選択的に行われます：プロパティを変更しない場合は、それを ``None`` " "に設定します。既存のデータを削除するには、空の文字列を使用します。" #: ../../annot.rst:162 82ce1316fe354b898446a0cf7a1713b5 msgid "" "a dictionary compatible with the *info* property (see below). All entries" " must be strings. If this argument is not a dictionary, the other " "arguments are used instead -- else they are ignored." msgstr "" "*info* " "プロパティと互換性のある辞書（以下参照）。すべてのエントリは文字列である必要があります。この引数が辞書でない場合、他の引数が代わりに使用されます。それ以外の場合、無視されます。" #: ../../annot.rst:163 ../../annot.rst:164 ../../annot.rst:167 #: 83ea81f2fcaf4733afe8ff369d458b6f 86f02eb815724a3a9d24dd57c593a1a3 #: c5a737145dcf4d738178459172d94c07 msgid "*(new in v1.16.10)* see description in :attr:`info`." msgstr "*（v1.16.10 で新規追加）* :attr:`info` の説明を参照してください。" #: ../../annot.rst:165 5b9616a7ad9147aa931d66313938ba67 msgid "" "*(new in v1.16.10)* date of annot creation. If given, should be in PDF " "datetime format." msgstr "*（v1.16.10 で新規追加）* 注釈の作成日。指定する場合、PDF 日時形式である必要があります。" #: ../../annot.rst:166 3764dd0b660a48ecba7d241ddd0c78ef msgid "" "*(new in v1.16.10)* date of last modification. If given, should be in PDF" " datetime format." msgstr "*（v1.16.10 で新規追加）* 最終変更日。指定する場合、PDF 日時形式である必要があります。" #: ../../annot.rst:171 e43517d418724f92aa471da27a597d2b msgid "" "Sets an annotation's line ending styles. Each of these annotation types " "is defined by a list of points which are connected by lines. The symbol " "identified by *start* is attached to the first point, and *end* to the " "last point of this list. For unsupported annotation types, a no-operation" " with a warning message results." msgstr "" "注釈の線終端スタイルを設定します。これらの注釈タイプの各々は、線で接続された点のリストによって定義されています。*start* " "で指定されたシンボルは、最初の点に、*end* " "はこのリストの最後の点に取り付けられます。サポートされていない注釈タイプの場合、警告メッセージとともに無操作となります。" #: ../../annot.rst:175 c6f37bfe8f864b7aa70a6677d903fbdc msgid "" "Some symbols have an interior area (diamonds, circles, squares, etc.). " "These areas are filled with the fill color or the stroke color, depending" " on the annotation type." msgstr "" #: ../../annot.rst:177 35d6ef1a79c74b06ab0a9dcf482f9a65 msgid "The symbol number for the first point." msgstr "最初の点のシンボル番号。" #: ../../annot.rst:178 458ad87b80944b07b309331fa16a70a2 msgid "The symbol number for the last point." msgstr "最後の点のシンボル番号。" #: ../../annot.rst:182 4fed90be4a2f4f6eb36e2d7f41f31319 msgid "" "Set the annotation's visibility using PDF optional content mechanisms. " "This visibility is controlled by the user interface of supporting PDF " "viewers. It is independent from other attributes like " ":attr:`Annot.flags`." msgstr "" "PDFのオプションコンテンツメカニズムを使用して、注釈の表示/非表示を設定します。この表示は、サポートするPDFビューアのユーザーインターフェースによって制御されます。:attr:`Annot.flags`" " のような他の属性とは独立しています。" #: ../../annot.rst:184 613a0a96a3a548efb40200791489f4fd msgid "" "the :data:`xref` of an optional contents group (OCG or OCMD). Any " "previous xref will be overwritten. If zero, a previous entry will be " "removed. An exception occurs if the xref is not zero and does not point " "to a valid PDF object." msgstr "" "オプションコンテンツグループ（OCGまたはOCMD）のxref。以前の :data:`xref` " "は上書きされます。ゼロの場合、以前のエントリが削除されます。xrefがゼロでない場合かつ有効なPDFオブジェクトを指していない場合、例外が発生します。" #: ../../annot.rst:186 55d26af3928947678aaeaa3e33027dcc msgid "This does **not require executing** :meth:`Annot.update` to take effect." msgstr "これは :meth:`Annot.update` の **実行を必要としません。** " #: ../../annot.rst:190 7e388a9f2b75447d8394d6d36c4a1bf8 msgid "" "Return the :data:`xref` of an optional content object, or zero if there " "is none." msgstr "オプションコンテンツオブジェクトの :data:`xref` 、または存在しない場合はゼロを返します。" #: ../../annot.rst:192 e8ec795f695645628c3efbfd3915cec6 msgid "zero or the xref of an OCG (or OCMD)." msgstr "ゼロまたはOCG（またはOCMD）のxref。" #: ../../annot.rst:197 b2f92c06a6294be3bfd5ec01d0e09768 msgid "New in v1.19.3" msgstr "v1.19.3 で新規追加" #: ../../annot.rst:199 ad11cb50eb7b4800aec2e137d3accb71 msgid "Set annotation to be \"In Response To\" another one." msgstr "注釈を別の注釈への「応答として」設定します。" #: ../../annot.rst:201 7b8bf875b3bc4826aa14c687fb8cd5d0 msgid "" "The :data:`xref` of another annotation. .. note:: Must refer to an " "existing annotation on this page. Setting this property requires no " "subsequent `update()`." msgstr "" #: ../../annot.rst:201 9e9d820407064710884e6a66aa7f7f55 msgid "The :data:`xref` of another annotation." msgstr "別の注釈の :data:`xref` 。" #: ../../annot.rst:203 14f320a016824d5198f1d52227d0a926 msgid "" "Must refer to an existing annotation on this page. Setting this property " "requires no subsequent `update()`." msgstr "このプロパティを設定するには、このページの既存の注釈を参照する必要があります。このプロパティを設定する際、後続の `update()` は不要です。" #: ../../annot.rst:208 ../../annot.rst:217 ../../annot.rst:237 #: 481fa7ca48f54e5598a63178e50438ab a466079f958942378ec240211f031c16 #: f9ec8616d1df4181aa40e2958d601327 msgid "New in v1.18.4" msgstr "v1.18.4 で新たに追加" #: ../../annot.rst:210 67cc9664fad84f49a83ba297112ca110 msgid "" "Set the annotation's Popup annotation to open or closed -- **or** the " "annotation itself, if its type is 'Text' (\"sticky note\")." msgstr "注釈のポップアップ注釈を開いた状態または閉じた状態に設定します – *または* その注釈自体、そのタイプが 'Text'（「付箋」）の場合。" #: ../../annot.rst:212 1504f1da1fda45fea8f19f45ffc20d4f msgid "the desired open state." msgstr "望ましい開いた状態。" #: ../../annot.rst:219 c089225b48284823a9b7556a44262d27 msgid "" "Create a Popup annotation for the annotation and specify its rectangle. " "If the Popup already exists, only its rectangle is updated." msgstr "注釈のためのポップアップ注釈を作成し、その矩形を指定します。ポップアップが既に存在する場合、その矩形のみが更新されます。" #: ../../annot.rst:221 c34e5022b5454828b58718e9dcbc45fe msgid "the desired rectangle." msgstr "望ましい矩形。" #: ../../annot.rst:227 facb954df51640a7ae7fd3710883dc98 msgid "" "Set the annotation's transparency. Opacity can also be set in " ":meth:`Annot.update`." msgstr "注釈の透明度を設定します。透明度は :meth:`Annot.update` でも設定できます。" #: ../../annot.rst:229 d7989596080e46c987557189dc9c25ff msgid "" "a float in range *[0, 1]*. Any value outside is assumed to be 1. E.g. a " "value of 0.5 sets the transparency to 50%." msgstr "*[0、1]* の範囲内の浮動小数点数。範囲外の値は 1 と見なされます。例：0.5 の値は透明度を 50% に設定します。" #: ../../annot.rst:231 8cd9cbde74a9498aa0f39f1aceeb59c0 msgid "Three overlapping 'Circle' annotations with each opacity set to 0.5:" msgstr "透明度がそれぞれ 0.5 に設定された3つの重なる「Circle」注釈：" #: ../../annot.rst:239 78ea45fdfd8c457285f97ad98ced56cb msgid "" "The annotation's blend mode. See :ref:`AdobeManual`, page 324 for " "explanations." msgstr "注釈のブレンドモード。詳細については :ref:`AdobeManual` 、ページ324を参照してください。" #: ../../annot.rst:242 30d06915799b4a4d993a5b5fca1059fe msgid "the blend mode or ``None``." msgstr "ブレンドモードまたは ``None`` 。" #: ../../annot.rst:247 9dce9ac76ca040e1a31d5585a57839f6 msgid "New in v1.16.14" msgstr "v1.16.14 で新たに追加" #: ../../annot.rst:249 dc743497d0c04f36b92127b326b52323 msgid "" "Set the annotation's blend mode. See :ref:`AdobeManual`, page 324 for " "explanations. The blend mode can also be set in :meth:`Annot.update`." msgstr "" "注釈のブレンドモードを設定します。詳細については :ref:`AdobeManual` 、ページ324を参照してください。ブレンドモードは " ":meth:`Annot.update` でも設定できます。" #: ../../annot.rst:251 4cc8588ee3a54e0ea07306202519e692 msgid "" "set the blend mode. Use :meth:`Annot.update` to reflect this in the " "visual appearance. For predefined values see :ref:`BlendModes`. Use " "`PDF_BM_Normal` to **remove** a blend mode." msgstr "" "ブレンドモードを設定します。視覚的な外観に反映するには :meth:`Annot.update` " "を使用します。事前定義の値についてはPDF標準のブレンドモードを参照してください。ブレンドモードを **削除する** には " "`PDF_BM_Normal` を使用します。" #: ../../annot.rst:256 f91715c6f8dd45839dff56adcd90fe40 msgid "New in version 1.16.0" msgstr "バージョン1.16.0で新たに追加" #: ../../annot.rst:258 63628e30584640f485f9216a26cc976e msgid "" "Change the name field of any annotation type. For 'FileAttachment' and " "'Text' annotations, this is the icon name, for 'Stamp' annotations the " "text in the stamp. The visual result (if any) depends on your PDF viewer." " See also :ref:`mupdficons`." msgstr "" "すべての注釈タイプの名前フィールドを変更します。「FileAttachment」と「Text」注釈の場合、これはアイコンの名前であり、「Stamp」注釈の場合はスタンプのテキストです。視覚的な結果（ある場合）は、PDFビューアに依存します。:ref:`mupdficons`" " も参照してください。" #: ../../annot.rst:260 c9956808cf6344fe93a68e352c078f3b msgid "the new name." msgstr "新しい名前。" #: ../../annot.rst:262 77d72775e0d649e0aee5cd748dcf35c5 msgid "" "If you set the name of a 'Stamp' annotation, then this will **not " "change** the rectangle, nor will the text be layouted in any way. If you " "choose a standard text from :ref:`StampIcons` (the **exact** name piece " "after `\"STAMP_\"`), you should receive the original layout. An " "**arbitrary text** will not be changed to upper case, but be written in " "font \"Times-Bold\" as is, horizontally centered in **one line** and be " "shortened to fit. To get your text fully displayed, its length using " ":data:`fontsize` 20 must not exceed 190 points. So please make sure that " "the following inequality is true: `pymupdf.get_text_length(text, " "fontname=\"tibo\", fontsize=20) <= 190`." msgstr "" "「Stamp」注釈の名前を設定した場合、これは矩形を **変更せず** 、テキストもレイアウトされません。:ref:`StampIcons` " "から標準のテキストを選択すると（ `\"STAMP_\"` の後の **正確な** 名前部分）、元のレイアウトが表示されるはずです。**任意** " "のテキストは大文字に変更されず、「Times-Bold」フォントで水平中央揃えで **1行** " "に表示され、収まるように短縮されます。テキストを完全に表示するには、フォントサイズ20を使用してのテキストの長さが190ピクセルを超えてはいけません。したがって、以下の不等式が成り立つことを確認してください:" " `pymupdf.get_text_length(text, fontname=\"tibo\", fontsize=20) <= 190` 。" #: ../../annot.rst:266 215783824e424078a9c68252ef072b76 msgid "" "Change the rectangle of an annotation. The annotation can be moved around" " and both sides of the rectangle can be independently scaled. However, " "the annotation appearance will never get rotated, flipped or sheared. " "This method only affects certain annotation types [#f2]_ and will lead to" " a message on Python's `sys.stderr` in other cases. No exception will be " "raised, but `False` will be returned." msgstr "" "注釈の矩形を変更します。注釈は移動し、矩形の両側を独立してスケーリングできます。ただし、注釈の外観は回転、反転、またはせん断されることはありません。このメソッドは特定の注釈タイプにのみ影響を与えます" " [#f2]_ 、それ以外の場合はPythonの `sys.stderr` にメッセージが表示されます。例外は発生しませんが、`False` " "が返されます。" #: ../../annot.rst:268 a55821d5ebaa43a79524ea735d7fce30 msgid "" "the new rectangle of the annotation (finite and not empty). E.g. using a " "value of *annot.rect + (5, 5, 5, 5)* will shift the annot position 5 " "pixels to the right and downwards." msgstr "" "rect (rect_like) – 注釈の新しい矩形（有限で空ではない）です。たとえば、*annot.rect + (5, 5, 5, 5)* " "の値を使用すると、注釈を右に5ピクセル、下に5ピクセル移動させます。" #: ../../annot.rst:270 58ba9ae624c649f59c822a951c81b8d9 msgid "You **need not** invoke :meth:`Annot.update` for activation of the effect." msgstr "効果の有効化には :meth:`Annot.update` を呼び出す **必要はありません** 。" #: ../../annot.rst:275 4182447a9b644af7b8fdaadfb8a05d32 msgid "" "Set the rotation of an annotation. This rotates the annotation rectangle " "around its center point. Then a **new annotation rectangle** is " "calculated from the resulting quad." msgstr "注釈の回転を設定します。これにより、注釈の矩形はその中心点を中心に回転します。その後、結果の四角形から **新しい注釈の矩形** が計算されます。" #: ../../annot.rst:277 6fc24fed55494f8fb4a955d4d8a13eba msgid "" "rotation angle in degrees. Arbitrary values are possible, but will be " "clamped to the interval `[0, 360)`." msgstr "度数法での回転角度。任意の値が可能ですが、区間 `[0, 360)` にクランプされます。" #: ../../annot.rst:280 e4f887994fc5422f95d07305f9ce1cd5 msgid "You **must invoke** :meth:`Annot.update` to activate the effect." msgstr "効果を有効にするには、:meth:`Annot.update` を **呼び出す必要があります** 。" #: ../../annot.rst:281 708375ceb35c401f93a653d662ffa946 msgid "" "For PDF_ANNOT_FREE_TEXT, only one of the values 0, 90, 180 and 270 is " "possible and will **rotate the text** inside the current rectangle (which" " remains unchanged). Other values are silently ignored and replaced by 0." msgstr "" "PDF_ANNOT_FREE_TEXTの場合、値0、90、180、270のいずれかの値のみが可能で、現在の矩形内の **テキストを回転させます**" " （矩形自体は変更されません）。その他の値は静かに無視され、0に置き換えられます。" #: ../../annot.rst:282 9916c3c0474d42789055dd9fb27df6d5 msgid "" "Otherwise, only the following :ref:`AnnotationTypes` can be rotated: " "'Square', 'Circle', 'Caret', 'Text', 'FileAttachment', 'Ink', 'Line', " "'Polyline', 'Polygon', and 'Stamp'. For all others the method is a no-op." msgstr "" "それ以外の場合、次の :ref:`AnnotationTypes` " "のみが回転できます：'Square'、'Circle'、'Caret'、'Text'、'FileAttachment'、'Ink'、'Line'、'Polyline'、'Polygon'、および'Stamp'。それ以外のすべての場合、このメソッドは無効です。" #: ../../annot.rst:287 21f87eefce9f42cd84347e0b9f4c9750 msgid "" "Changed in version 1.16.9: Allow specification without using a " "dictionary. The direct parameters are used if *border* is not a " "dictionary." msgstr "バージョン1.16.9で変更: 辞書を使用せずに指定を許可。*border* が辞書でない場合、直接のパラメータが使用されます。" #: ../../annot.rst:289 a5d1d0e5012145d88adb8f0b58ec843d msgid "Changed in version 1.22.5: Support of the \"cloudy\" border effect." msgstr "バージョン1.22.5で変更: \"cloudy\"ボーダーエフェクトのサポート。" #: ../../annot.rst:291 c189c32c136c4970affbad53b8a4962c msgid "" "PDF only: Change border width, dashing, style and cloud effect. See the " ":attr:`Annot.border` attribute for more details." msgstr "" "PDFのみ: ボーダーの幅、点線、スタイル、およびクラウド効果を変更します。詳細については :attr:`Annot.border` " "属性を参照してください。" #: ../../annot.rst:294 cd430c709f2743de8acc763ed90aa387 msgid "" "a dictionary as returned by the :attr:`border` property, with keys " "*\"width\"* (*float*), *\"style\"* (*str*), *\"dashes\"* (*sequence*) " "and *clouds* (*int*). Omitted keys will leave the resp. property " "unchanged. Set the border argument to `None` (the default) to use the " "other arguments." msgstr "" ":attr:`border` プロパティから返されるような辞書で、キーに " "\"width\"（float）、\"style\"（str）、\"dashes\"（シーケンス）、および " "\"clouds\"（int）を持っています。省略されたキーはそれぞれのプロパティを変更しないままにします。他の引数を使用する場合、border引数を" " `None` （デフォルト）に設定します。" #: ../../annot.rst:296 39acc9934225448197fcfd592c9d832f msgid "A non-negative value will change the border line width." msgstr "非負の値はボーダーの線幅を変更します。" #: ../../annot.rst:297 a68a775771684101adfaada1b555645a msgid "A value other than `None` will change this border property." msgstr "`None` 以外の値はこのボーダープロパティを変更します。" #: ../../annot.rst:298 6abbfe1e60884753b2f408c6140c1522 msgid "" "All items of the sequence must be integers, otherwise the parameter is " "ignored. To remove dashing use: `dashes=[]`. If dashes is a non-empty " "sequence, \"style\" will automatically be set to \"D\" (dashed)." msgstr "" "シーケンスのすべてのアイテムは整数である必要があり、それ以外の場合、パラメータは無視されます。点線を削除するには、`dashes=[]` " "を使用します。dashesが空でないシーケンスの場合、\"style\"は自動的に \"D\"（点線）に設定されます。" #: ../../annot.rst:299 a14bf775a9aa4b5690dfa5d75ad9a268 msgid "" "A value >= 0 will change this property. Use `clouds=0` to remove the " "cloudy appearance completely. Only annotation types 'Square', 'Circle', " "and 'Polygon' are supported with this property." msgstr "" "0以上の値はこのプロパティを変更します。クラウディな外観を完全に削除するには、`clouds=0` " "を使用します。このプロパティはアノテーションタイプ 'Square'、'Circle'、および 'Polygon' のみでサポートされています。" #: ../../annot.rst:303 ef79e54d0a714869a014c9d730425b72 msgid "Changes the annotation flags. Use the `|` operator to combine several." msgstr "注釈のフラグを変更します。複数のフラグを組み合わせるには `|` 演算子を使用します。" #: ../../annot.rst:305 fd0aa1fe5fa54354942159d69033f3dd msgid "an integer specifying the required flags." msgstr "必要なフラグを指定する整数。" #: ../../annot.rst:309 6c045aa7fffe4727b0d500917f834af7 msgid "" "Changes the \"stroke\" and \"fill\" colors for supported annotation types" " -- not all annotation types accept both. **Do not use this method at all" " for FreeText annotations** because it has its special conventions to " "deal with up to three colors (border, fill, text)." msgstr "" "サポートされている注釈タイプに対して「ストローク」と「塗りつぶし」の色を変更します – " "すべての注釈が両方を受け入れるわけではありません。FreeText注釈にはこのメソッドを一切使用しないでください" #: ../../annot.rst:311 db7de1cdaf074887b6a5856f6edce371 msgid "" "a dictionary containing color specifications. For accepted dictionary " "keys and values see below. The most practical way should be to first make" " a copy of the *colors* property and then modify this dictionary as " "required." msgstr "" "色の仕様を含む辞書。受け入れられる辞書のキーと値については以下を参照してください。最も実用的な方法は、まず ** " "プロパティのコピーを作成し、その後必要に応じてこの辞書を変更することです。" #: ../../annot.rst:312 ../../annot.rst:313 75cff1ffb24c4912bfeb81a9ebd1432d #: ab1efc57d7bc48e98cf5e1bdb658a212 msgid "see above." msgstr "上記を参照してください。" #: ../../annot.rst:315 7c1a94d49e3646c1acf119c6dbd9d5d2 msgid "" "To completely remove a color specification, use an empty sequence like " "`[]`. If you specify `None`, an existing specification will not be " "changed." msgstr "色の仕様を完全に削除するには、`[]` のような空のシーケンスを使用してください。`None` を指定した場合、既存の仕様は変更されません。" #: ../../annot.rst:320 2a6d90dee7ce4d77b26b92943743267a msgid "New in version 1.16.12" msgstr "バージョン1.16.12で新規追加" #: ../../annot.rst:322 595743ee33354f6db6ea8007f5c683d9 msgid "" "Delete annotations referring to this one. This includes any 'Popup' " "annotations and all annotations responding to it." msgstr "この注釈を参照する注釈を削除します。これには「ポップアップ」注釈とそれに応答するすべての注釈が含まれます。" #: ../../annot.rst:336 3dd084b1ebf84cde9a0f1628888a078a msgid "" "Synchronize the appearance of an annotation with its properties after " "relevant changes." msgstr "関連する変更後に注釈の外観をプロパティに同期させます。" #: ../../annot.rst:338 7fe415cd7d454f189581594f76164856 msgid "You can safely **omit** this method **only** for the following changes:" msgstr "以下の変更に関して **のみ** 、このメソッドを安全に **省略できます** :" #: ../../annot.rst:344 fe15053758b14d7199c023e93f5fb1b5 msgid ":meth:`Annot.set_info` (except any changes to *\"content\"*)" msgstr ":meth:`Annot.set_info` （*「content」* 以外の変更を除く）" #: ../../annot.rst:346 0073d1e84f5d4733b0ed896ad1863ecc msgid "" "All arguments are optional. *(Changed in v1.16.14)* Blend mode and " "opacity are applicable to **all annotation types**. The other arguments " "are mostly special use, as described below." msgstr "" "すべての引数はオプションです。 *(v1.16.14で変更)* ブレンドモードと不透明度は **すべての注釈タイプ** に適用されます。 " "他の引数は主に特殊な用途として、以下で説明されています。" #: ../../annot.rst:348 f2ba4ab0eec14256874f4795f0809515 msgid "" "Color specifications may be made in the usual format used in PuMuPDF as " "sequences of floats ranging from 0.0 to 1.0 (including both). The " "sequence length must be 1, 3 or 4 (supporting GRAY, RGB and CMYK " "colorspaces respectively). For GRAY, just a float is also acceptable." msgstr "カラーの仕様は、通常のPuMuPDFで使用される形式で指定できます。0.0から1.0までの浮動小数点数のシーケンスです（両方を含む）。シーケンスの長さは1、3、または4である必要があります（GRAY、RGB、およびCMYKのカラースペースをサポートしています）。GRAYの場合、浮動小数点数だけでも受け入れられます。" #: ../../annot.rst:350 f3ccad414cfa4feea70d7d6d4ee37f20 msgid "" "*(new in v1.16.14)* **valid for all annotation types:** change or set the" " annotation's transparency. Valid values are *0 <= opacity < 1*." msgstr "" "*（v1.16.14で新規）* **すべての注釈タイプに対して有効：** 注釈の透明度を変更または設定します。有効な値は *0 <= " "opacity < 1です* 。" #: ../../annot.rst:352 04465250dcde4c4c860e257ac3e888cc msgid "" "*(new in v1.16.14)* **valid for all annotation types:** change or set the" " annotation's blend mode. For valid values see :ref:`BlendModes`." msgstr "" "*（v1.16.14で新規）* **すべての注釈タイプに対して有効：** " "注釈のブレンドモードを変更または設定します。有効な値についてはPDF標準のブレンドモードを参照してください。" #: ../../annot.rst:354 9bc27aa105ae42cd82a2451d40ee6e6e msgid "change :data:`fontsize` of the text. 'FreeText' annotations only." msgstr "テキストのフォントサイズを変更します。 'FreeText' 注釈のみです。" #: ../../annot.rst:356 cf2b46ce81194d3889beefcdf7c9b7bc msgid "" "change the text color. 'FreeText' annotations only. This has the same " "effect as ``border_color``. Note that the text color of rich-text " "annotations cannot be changed at all because it is set by HTML / CSS " "syntax and part of the text itself." msgstr "テキストの色を変更します。 'FreeText' 注釈のみです。" #: ../../annot.rst:358 9573860e39914131a2e6b21985df1d0a msgid "" "change the border color. 'FreeText' annotations only. This has the same " "effect as ``text_color``." msgstr "境界線の色を変更します。 'FreeText' 注釈のみです。" #: ../../annot.rst:360 f201d820422e410380867aef925e12c6 msgid "the fill color." msgstr "塗りつぶしの色です。" #: ../../annot.rst:362 51b7ae492b9d439ea63ad6e688461680 msgid "" "*(new in v1.17.2)* add two diagonal lines to the annotation rectangle. " "'Redact' annotations only. If not desired, ``False`` must be specified " "even if the annotation was created with ``False``." msgstr "" "*（v1.17.2で新規）* 注釈の矩形に2本の対角線を追加します。 'Redact' 注釈のみです。希望しない場合、注釈が``False`` " "で作成された場合でも ``False`` を指定する必要があります。" #: ../../annot.rst:364 ca681b7d888b4269b353a917a0251fcc msgid "" "new rotation value. Default (-1) means no change. Supports 'FreeText' and" " several other annotation types (see :meth:`Annot.set_rotation`), [#f1]_." " Only choose 0, 90, 180, or 270 degrees for 'FreeText'. Otherwise any " "integer is acceptable." msgstr "" "新しい回転値。デフォルト値（-1）は変更なしを意味します。 'FreeText' " "およびいくつかの他の注釈タイプをサポートします:meth:`Annot.set_rotation` を参照） [#f1]_ 。 " "'FreeText' の場合、0、90、180、または270度を選択してください。それ以外の場合、任意の整数が受け入れられます。" #: ../../annot.rst:368 60ab5d4e01554e09aa2155cfcf1bd6a4 msgid "" "This method is the only way to change the colors of a FreeText " "annotation. You cannot use :meth:`Annot.set_colors` for this purpose. But" " be aware that for rich-text annotations, the text color is never " "changed. The text color is set by the ``text_color`` entry of the " "``info`` dictionary. This is a limitation of |MuPDF| and not a bug." msgstr "" "このメソッドは、FreeText注釈の色を変更する唯一の方法です。この目的には、 :meth:`Annot.set_colors()` " "を使用することはできません。 ただし、リッチテキスト注釈の場合は注意が必要です。テキストの色は変更されず、 ``info`` 辞書の " "``text_color`` エントリによって設定されます。 これは |MuPDF| の制限であり、不具合ではありません。" #: ../../annot.rst:370 1112033b5d6844729cb062a449ec85b1 msgid "" "Using this method inside a :meth:`Page.annots` loop is **not " "recommended!** This is because most annotation updates require the owning" " page to be reloaded -- which cannot be done inside this loop. Please use" " the example coding pattern given in the documentation of this generator." msgstr "" ":meth:`Page.annots` ループ内でこのメソッドを使用することは **お勧めしません！** " "これは、ほとんどの注釈の更新には所有ページの再読み込みが必要であり、このループ内で行うことはできないためです。このジェネレータのドキュメントで提供されている例のコーディングパターンを使用してください。" #: ../../annot.rst:375 4a926753fff744ec9116dd6ed7183650 msgid "Basic information of the annot's attached file." msgstr "アノットが添付されたファイルの基本情報。" #: ../../annot.rst:378 dff1e3b1a640429fb53eddd0fa92ce69 msgid "" "a dictionary with keys *filename*, *ufilename*, *desc* (description), " "*size* (uncompressed file size), *length* (compressed length) for " "FileAttachment annot types, else ``None``." msgstr "" "FileAttachmentアノットタイプの場合、*filename* （ファイル名）、*ufilename* " "（Unicodeファイル名）、*desc* （説明）、*size* （非圧縮ファイルサイズ）、*length* " "（圧縮長さ）のキーを持つ辞書。それ以外の場合は ``None`` 。" #: ../../annot.rst:382 fff1e94235db41658c4a47630907af7b msgid "Returns attached file content." msgstr "添付ファイルの内容を返します。" #: ../../annot.rst:385 e7858d0b8f274619a0e53226e2ad2558 msgid "the content of the attached file." msgstr "添付ファイルの内容。" #: ../../annot.rst:395 0a6f0f824993411db432fbc73cedbf48 msgid "" "Updates the content of an attached file. All arguments are optional. No " "arguments lead to a no-op." msgstr "添付ファイルの内容を更新します。すべての引数はオプションです。引数が指定されない場合、操作は行われません。" #: ../../annot.rst:397 14cfd5ce68c443c4b5706490bf7ce62c msgid "" "the new file content. Omit to only change meta-information. *(Changed in" " version 1.14.13)* *io.BytesIO* is now also supported." msgstr "" #: ../../annot.rst:397 13e705e69a1d425184d4be574725693d msgid "the new file content. Omit to only change meta-information." msgstr "新しいファイルの内容。メタ情報のみ変更する場合は省略します。" #: ../../annot.rst:399 a1e92b5db60e4c4599063b1893fd8eed msgid "*(Changed in version 1.14.13)* *io.BytesIO* is now also supported." msgstr "*（バージョン1.14.13で変更）io.BytesIO* もサポートされるようになりました。" #: ../../annot.rst:401 16d4a6c7354947dc9ed4a1af1e661951 msgid "new filename to associate with the file." msgstr "ファイルに関連付ける新しいファイル名。" #: ../../annot.rst:403 f71c9be54bb649adbc2100b1cf7793e5 msgid "new unicode filename to associate with the file." msgstr "ファイルに関連付ける新しいUnicodeファイル名。" #: ../../annot.rst:405 70d2cec5d76d4b4ca6ac53eb58acf503 msgid "new description of the file content." msgstr "ファイル内容の新しい説明。" #: ../../annot.rst:409 dfdaec12a2274c30a1f374a77b655ee8 msgid "Return the embedded sound of an audio annotation." msgstr "オーディオアノテーションの埋め込まれた音声を返します。" #: ../../annot.rst:412 c7fa04ae49d54d39a39b5d2245c490f0 msgid "" "the sound audio file and accompanying properties. These are the possible " "dictionary keys, of which only \"rate\" and \"stream\" are always " "present. =========== " "======================================================= Key " "Description =========== " "======================================================= rate " "(float, requ.) samples per second channels (int, opt.) number of sound" " channels bps (int, opt.) bits per sample value per channel " "encoding (str, opt.) encoding format: Raw, Signed, muLaw, ALaw " "compression (str, opt.) name of compression filter stream (bytes, " "requ.) the sound file content =========== " "=======================================================" msgstr "" #: ../../annot.rst:412 df0e243fcf034592a8492436e6e1659a msgid "" "the sound audio file and accompanying properties. These are the possible " "dictionary keys, of which only \"rate\" and \"stream\" are always " "present." msgstr "音声オーディオファイルと関連するプロパティ。これらは可能な辞書キーで、常に「rate」と「stream」が存在します。" #: ../../annot.rst:415 12be1c52c4314285af838a6ce29fba9e msgid "Key" msgstr "キー" #: ../../annot.rst:415 2bdf4ba35cce4815a2a492cf817897c8 msgid "Description" msgstr "説明" #: ../../annot.rst:417 0d66d09f790c4ff3bc6c27ba0d9b632a msgid "rate" msgstr "" #: ../../annot.rst:417 c1045c0883214be39172475f75e7f5d0 msgid "(float, requ.) samples per second" msgstr "(float, 必須) 1秒あたりのサンプル数" #: ../../annot.rst:418 8abdaaa9d7fe44dfa74cc67416d30c2b msgid "channels" msgstr "" #: ../../annot.rst:418 f74b4b35e92846e28327d70e75e25b02 msgid "(int, opt.) number of sound channels" msgstr "(int, オプション) サウンドチャンネルの数" #: ../../annot.rst:419 942b2b733eed481b9491bc82bc570e1c msgid "bps" msgstr "" #: ../../annot.rst:419 7be514225767447a8a8095e8df1f2bc4 msgid "(int, opt.) bits per sample value per channel" msgstr "(int, オプション) チャンネルごとのサンプル値のビット数" #: ../../annot.rst:420 b38f02b791694df2ae7e91f5e18e4b63 msgid "encoding" msgstr "" #: ../../annot.rst:420 73e6b25cf0da41518e6a2a8c8342f9b9 msgid "(str, opt.) encoding format: Raw, Signed, muLaw, ALaw" msgstr "(str, オプション) エンコーディング形式: Raw, Signed, muLaw, ALaw" #: ../../annot.rst:421 1969b7bd898244968ec9e8b0ccb1bde7 msgid "compression" msgstr "" #: ../../annot.rst:421 a89ee4a1e5ae438bb9abdf27689f1840 msgid "(str, opt.) name of compression filter" msgstr "(str, オプション) 圧縮フィルタの名前" #: ../../annot.rst:422 8ae646c528504b2c930d6aeefa18e74b msgid "stream" msgstr "" #: ../../annot.rst:422 379f471934fe4d5fab7732b175a2bce2 msgid "(bytes, requ.) the sound file content" msgstr "(bytes, 必須) サウンドファイルの内容" #: ../../annot.rst:428 04846fc70fde4de09324de235eedf132 msgid "" "The annotation's transparency. If set, it is a value in range *[0, 1]*. " "The PDF default is 1. However, in an effort to tell the difference, we " "return *-1.0* if not set." msgstr "" "アノテーションの透明度。設定されている場合、範囲 *[0, 1]* の値です。PDFのデフォルトは1ですが、違いを示すために設定されていない場合は" " *-1.0* を返します。" #: ../../annot.rst:434 38341cb4267e49eea899f48c336adc57 msgid "The owning page object of the annotation." msgstr "アノテーションの所属ページオブジェクト。" #: ../../annot.rst:436 b69e2ef1768c4682aeceb59e231073e6 msgid ":ref:`Page`" msgstr "" #: ../../annot.rst:440 d8c838f369404f76b51db3fa29590aaf msgid "The annot rotation." msgstr "アノテーションの回転角度。" #: ../../annot.rst:443 0e4000b23bd0487692990ba93841e11b msgid "" "a value [-1, 359]. If rotation is not at all, -1 is returned (and implies" " a rotation angle of 0). Other possible values are normalized to some " "value value 0 <= angle < 360." msgstr "" "値は[-1, 359]です。回転が全くない場合、-1が返されます（回転角度0を意味します）。その他の可能な値は、一定の値0 <= angle < " "360に正規化されます。" #: ../../annot.rst:447 675380b4c5e64bf7bff950dcc720a751 msgid "The rectangle containing the annotation." msgstr "アノテーションを含む長方形領域。" #: ../../annot.rst:449 ../../annot.rst:549 aebdf20a1fda46b7abc7b4c3e0493882 #: ec14799005724be998a1275792677a12 msgid ":ref:`Rect`" msgstr "" #: ../../annot.rst:453 c70b9c19d6d84a359b2b1a7396054162 msgid "The next annotation on this page or None." msgstr "このページ上の次のアノテーションまたはNone。" #: ../../annot.rst:455 e2f9dcc59c714b54a43f67ec7b62cff8 msgid "*Annot*" msgstr "" #: ../../annot.rst:459 606bb69f415d48c0a7aad4dac9c69fc3 msgid "" "A number and one or two strings describing the annotation type, like " "**[2, 'FreeText', 'FreeTextCallout']**. The second string entry is " "optional and may be empty. See the appendix :ref:`AnnotationTypes` for a " "list of possible values and their meanings." msgstr "" "アノテーションタイプ を説明する数値と1つまたは2つの文字列、例: **[2, 'FreeText', 'FreeTextCallout']** " "。第2の文字列エントリはオプションで、空であるかもしれません。可能な値とその意味については、付録の :ref:`AnnotationTypes` " "のリストを参照してください。" #: ../../annot.rst:465 814b528ad1594607875ed97510496fe2 msgid "" "A dictionary containing various information. All fields are optional " "strings. For information items not provided, an empty string is returned." msgstr "異なる情報を含む辞書。すべてのフィールドはオプションの文字列です。提供されない情報項目については、空の文字列が返されます。" #: ../../annot.rst:467 132313a5fcff4d5b98ca42e3a4bf5fda msgid "" "*name* -- e.g. for 'Stamp' annotations it will contain the stamp text " "like \"Sold\" or \"Experimental\", for other annot types you will see the" " name of the annot's icon here (\"PushPin\" for FileAttachment)." msgstr "" "*name* – たとえば、 'Stamp' 注釈の場合、 'Sold' または 'Experimental' " "のようなスタンプテキストが含まれ、他の注釈のタイプでは注釈のアイコンの名前がここに表示されます（FileAttachment の場合は " "'PushPin'）。" #: ../../annot.rst:469 bc6c85b50da94924bc357226258bd3fc msgid "" "*content* -- a string containing the text for type *Text* and *FreeText* " "annotations. Commonly used for filling the text field of annotation pop-" "up windows." msgstr "" "*content* – *テキスト* タイプと *FreeText* " "注釈のテキストを含む文字列。注釈のポップアップウィンドウのテキストフィールドを埋めるために一般的に使用されます。" #: ../../annot.rst:471 d7645d31cbb64e3cb699a731902ecb75 msgid "" "*title* -- a string containing the title of the annotation pop-up window." " By convention, this is used for the **annotation author**." msgstr "*title* – 注釈のポップアップウィンドウのタイトルを含む文字列。通常、これは **注釈の著者** に使用されます。" #: ../../annot.rst:473 ba6e837b12eb4a59b39297c6410293cb msgid "*creationDate* -- creation timestamp." msgstr "*creationDate* – 作成タイムスタンプ。" #: ../../annot.rst:474 dea7337d10874b83bd25f6be18463264 msgid "*modDate* -- last modified timestamp." msgstr "*modDate* – 最終変更タイムスタンプ。" #: ../../annot.rst:475 affe5f09ffd3424b9ff3466bd9fa10e4 msgid "*subject* -- subject." msgstr "*subject* – 主題。" #: ../../annot.rst:476 2839aeb340104f42b830df272fca2fb6 msgid "" "*id* -- *(new in version 1.16.10)* a unique identification of the " "annotation. This is taken from PDF key */NM*. Annotations added by " "PyMuPDF will have a unique name, which appears here." msgstr "" "*id* – （バージョン1.16.10で新規追加）注釈の一意の識別子。これはPDFキー */ NM* " "から取得されます。PyMuPDFによって追加された注釈には一意の名前があり、ここに表示されます" #: ../../annot.rst:483 16616c415f6e46b7a3677cfdd3112ce3 msgid "" "An integer whose low order bits contain flags for how the annotation " "should be presented." msgstr "注釈の表示方法を示すフラグを含む低位ビットを持つ整数。" #: ../../annot.rst:489 8339de6110f3442eae85a3e339d2b60f msgid "" "A pair of integers specifying start and end symbol of annotations types " "'FreeText', 'Line', 'PolyLine', and 'Polygon'. ``None`` if not " "applicable. For possible values and descriptions in this list, see the " ":ref:`AdobeManual`, table 1.76 on page 400." msgstr "" "'FreeText'、'Line'、'PolyLine'、および'Polygon'の注釈タイプの開始および終了シンボルを指定する2つの整数のペア。該当しない場合は" " *なし* 。このリストでの可能な値と説明については、:ref:`AdobeManual` のページ400の表1.76を参照してください。" #: ../../annot.rst:495 8bf05b20e751463eae59e5c917d94466 msgid "" "A list containing a variable number of point (\"vertices\") coordinates " "(each given by a pair of floats) for various types of annotations:" msgstr "さまざまな種類の注釈に対する、可変数の点（\"頂点\"）座標（各々が浮動小数点数のペアで指定される）を含むリスト：" #: ../../annot.rst:497 8912d31ff3344e5e8152219991bcb863 msgid "'Line' -- the starting and ending coordinates (2 float pairs)." msgstr "'Line' – 開始座標と終了座標（2つの浮動小数点数のペア）。" #: ../../annot.rst:498 a5b0fa3b850f4856bd236c668f63f1eb msgid "" "'FreeText' -- 2 or 3 float pairs designating the starting, the (optional)" " knee point, and the ending coordinates." msgstr "'FreeText' – 開始座標、（オプションの）曲線点、および終了座標を指定する2または3つの浮動小数点数のペア。" #: ../../annot.rst:499 b0ee60812ba343fea5fc2d15019955f2 msgid "" "'PolyLine' / 'Polygon' -- the coordinates of the edges connected by line " "pieces (n float pairs for n points)." msgstr "'PolyLine' / 'Polygon' – 線分で接続されたエッジの座標（nポイントのためのn個の浮動小数点数のペア）。" #: ../../annot.rst:500 8fbc31fb944e4da2868503b7613244d0 msgid "" "text markup annotations -- 4 float pairs specifying the *QuadPoints* of " "the marked text span (see :ref:`AdobeManual`, page 403)." msgstr "" "テキストのマークアップ注釈 – マークされたテキストスパンのQuadPointsを指定する4つの浮動小数点数のペア（Adobe " "PDFリファレンス、ページ403を参照）。" #: ../../annot.rst:501 09ceddfd7c4642e187b77e4fe278f331 msgid "" "'Ink' -- list of one to many sublists of vertex coordinates. Each such " "sublist represents a separate line in the drawing." msgstr "'Ink' – 頂点座標の1つから多数のサブリストのリスト。各サブリストは、描画内の別々の線を表します。" #: ../../annot.rst:508 e363318aa7cb46ff97b34487bc567275 #, fuzzy msgid "" "dictionary of two lists of floats in range *0 <= float <= 1* specifying " "the \"stroke\" and the interior (\"fill\") colors. The stroke color is " "used for borders and everything that is actively painted or written " "(\"stroked\"). The fill color is used for the interior of objects like " "line ends, circles and squares. The lengths of these lists implicitly " "determine the colorspaces used: 1 = GRAY, 3 = RGB, 4 = CMYK. So \"[1.0, " "0.0, 0.0]\" stands for RGB color red. Both lists can be empty if no color" " is specified. Be aware about some potentially unexpected cases:" msgstr "" "*0 <= 浮動小数点数 <= 1の範囲内* で指定された \"ストローク\" " "および内部（\"塗りつぶし\"）カラーの2つの浮動小数点数のリストから成る辞書。ストロークカラーは、境界線やアクティブに塗装されたり書かれたりするすべてに使用されます。塗りつぶしカラーは、線の端、円、正方形などのオブジェクトの内部に使用されます。これらのリストの長さは、暗黙的に使用されるカラースペースを決定します：1" " = GRAY、3 = RGB、4 = CMYK。したがって、\"[1.0, 0.0, 0.0]\" " "はRGBカラーの赤を表します。どちらのリストも指定されていない場合、空にすることができます。" #: ../../annot.rst:510 c98f3742209a4834b74c3d4385888358 msgid "" "The color of Highlight annotations is a **stroke** color, contrary to " "intuition." msgstr "" #: ../../annot.rst:511 2d1b77af92f94df2901498dee3ecf512 msgid "" "The color if FreeText annotations is a **stroke** color, but appears as " "the color that fills the rectangle and any applicable line end symbols. " "Text color and border color cannot be accessed at all." msgstr "" #: ../../annot.rst:517 5673a83fdd3046e1a25a02e890bf9503 msgid "The PDF :data:`xref`." msgstr "PDFの :data:`xref` 。" #: ../../annot.rst:523 80d30458b0ae4d81a75fccb23e4560df msgid "" "The PDF :data:`xref` of an annotation to which this one responds. Return " "zero if this is no response annotation." msgstr "この注釈が応答する注釈のPDF :data:`xref` 。これが応答注釈でない場合はゼロを返します。" #: ../../annot.rst:529 adc968b773a6471aba76a7111c2340a5 msgid "" "The PDF :data:`xref` of the associated Popup annotation. Zero if non-" "existent." msgstr "関連するポップアップ注釈のPDF :data:`xref` 。存在しない場合はゼロ。" #: ../../annot.rst:535 87e7894e6b484ea3b6e9b676e28d88b3 msgid "Whether the annotation has a Popup annotation." msgstr "注釈にポップアップ注釈があるかどうか。" #: ../../annot.rst:541 a5edaf80b163482b844afac753dce499 msgid "" "Whether the annotation's Popup is open -- **or** the annotation itself " "('Text' annotations only)." msgstr "注釈のポップアップが開いているかどうか - **または** 注釈自体（'テキスト'注釈のみ）。" #: ../../annot.rst:547 600f5a64e8a4400da0c1ae35c135efd1 msgid "" "The rectangle of the associated Popup annotation. Infinite rectangle if " "non-existent." msgstr "関連するポップアップ注釈の矩形。存在しない場合は無限の矩形。" #: ../../annot.rst:553 9fd4e2374ea64a4f895272c2450db57b msgid "" "A tuple of four floats representing the `/RD` entry of the annotation. " "The four numbers describe the numerical differences (left, top, -right, " "-bottom) between two rectangles: the :attr:`rect` of the annotation and a" " rectangle contained within that rectangle. If the entry is missing, this" " property is `(0, 0, 0, 0)`. If the annotation border is a normal, " "straight line, these numbers are typically border width divided by 2. If " "the annotation has a \"cloudy\" border, you will see the breadth of the " "cloud semi-circles here. In general, the numbers need not be identical. " "To compute the inner rectangle do `a.rect + a.rect_delta`." msgstr "" "注釈の `/RD` " "エントリを表す4つの浮動小数点数のタプル。これらの4つの数値は、2つの矩形間の数値の差（左、上、-右、-下）を説明しています：注釈の " ":attr:`rect` とその矩形内に含まれる矩形。エントリが存在しない場合、このプロパティは. `（0、0、0、0）` " "です。注釈の境界線が通常のまっすぐな線である場合、これらの数値は通常、境界線の幅を2で割ったものです。注釈に「雲状」の境界線がある場合、ここで雲の半円の幅が表示されます。一般的に、これらの数値は同一である必要はありません。内側の矩形を計算するには、`a.rect" " + a.rect_delta` を使用します。" #: ../../annot.rst:557 76373f31dcbe446392d079eb34532b34 msgid "" "A dictionary containing border characteristics. Empty if no border " "information exists. The following keys may be present:" msgstr "境界線の特性を含む辞書。境界線情報が存在しない場合は空です。次のキーが存在する可能性があります：" #: ../../annot.rst:559 2a2fab2fdf524b6184a1f5b62304135a msgid "" "*width* -- a float indicating the border thickness in points. The value " "is -1.0 if no width is specified." msgstr "*width* – ポイントでの境界線の太さを示す浮動小数点数。幅が指定されていない場合、値は -1.0 です。" #: ../../annot.rst:561 ee7176832c7e4740b78bb806706a9d04 msgid "" "*dashes* -- a sequence of integers specifying a line dashing pattern. " "*[]* means no dashes, *[n]* means equal on-off lengths of *n* points, " "longer lists will be interpreted as specifying alternating on-off length " "values. See the :ref:`AdobeManual` page 126 for more details." msgstr "" "*dashes* – ラインダッシングパターンを指定する整数のシーケンス。*[]* はダッシュなし、*[n]* は *n* " "ポイントの等しいオンオフの長さを意味し、より長いリストは交互のオンオフ長さ値を指定して解釈されます。詳細については、:ref:`AdobeManual`" " のページ126を参照してください。" #: ../../annot.rst:563 994ba35808ba4456b6568752b410a28e msgid "" "*style* -- 1-byte border style: **\"S\"** (Solid) = solid line " "surrounding the annotation, **\"D\"** (Dashed) = dashed line surrounding " "the annotation, the dash pattern is specified by the *dashes* entry, " "**\"B\"** (Beveled) = a simulated embossed rectangle that appears to be " "raised above the surface of the page, **\"I\"** (Inset) = a simulated " "engraved rectangle that appears to be recessed below the surface of the " "page, **\"U\"** (Underline) = a single line along the bottom of the " "annotation rectangle." msgstr "" "*style* – 1バイトの境界線スタイル： **\"S\"** （Solid）= 注釈を囲む実線、 **\"D\"** （Dashed）= " "注釈を囲む破線、破線パターンは *dashes* エントリによって指定され、 **“B”** （Beveled）= " "ページの表面よりも上に浮かぶように見える模擬的な浮き出し矩形、 **\"I\"** （Inset）= " "ページの表面よりも下に凹んだように見える模擬的な浮き彫りの矩形、 **\"U\"** （Underline）= 注釈矩形の底部に沿った単一の線。" #: ../../annot.rst:565 7700bc48fde44a268bcd7c4a8afa5304 msgid "" "*clouds* -- an integer indicating a \"cloudy\" border, where ``n`` is an " "integer `-1 <= n <= 2`. A value `n = 0` indicates a straight line (no " "clouds), 1 means small and 2 means large semi-circles, mimicking the " "cloudy appearance. If -1, then no specification is present." msgstr "" "*clouds* – “雲状”の境界を示す整数。``n`` は整数 `-1 <= n <= 2` を指します。値 `n = 0` " "は直線（雲なし）を示し、1 は小さな半円、2 は大きな半円を模倣した雲の外観を示します。-1 の場合、仕様が存在しないことを示します。" #: ../../annot.rst:573 332ac742d76d48529ceb6b4e40f7295a msgid "Annotation Icons in MuPDF" msgstr "MuPDFの注釈アイコン" #: ../../annot.rst:574 21859a0e63974afa950419ab98ff55e6 msgid "" "This is a list of icons referenceable by name for annotation types 'Text'" " and 'FileAttachment'. You can use them via the *icon* parameter when " "adding an annotation, or use the as argument in :meth:`Annot.set_name`. " "It is left to your discretion which item to choose when -- no mechanism " "will keep you from using e.g. the \"Speaker\" icon for a " "'FileAttachment'." msgstr "" "これは「Text」および「FileAttachment」注釈タイプの名前で参照可能なアイコンのリストです。注釈を追加する際に*icon* " "パラメータを使用したり、:meth:`Annot.set_name` " "の引数として使用したりできます。どのアイテムを選択するかはあなたの裁量に任されています - " "たとえば、「Speaker」アイコンを「FileAttachment」に使用することを防ぐメカニズムは存在しません。" #: ../../annot.rst:580 cb12c1793cdb4341b24fbf6538c60d1c msgid "Example" msgstr "例" #: ../../annot.rst:581 a2296e47889a4fec983f5aa41e485291 msgid "" "Change the graphical image of an annotation. Also update the \"author\" " "and the text to be shown in the popup window::" msgstr "注釈のグラフィカルな画像を変更します。また、ポップアップウィンドウに表示される「著者」とテキストを更新します。" #: ../../annot.rst:604 7bff751c7d604fe38047b43fdeb95933 msgid "" "This is how the circle annotation looks like before and after the change " "(pop-up windows displayed using Nitro PDF viewer):" msgstr "これが、変更前と変更後のサークル注釈の見た目です（Nitro PDFビューアを使用して表示されるポップアップウィンドウ）:" #: ../../annot.rst:606 479b5bc5389b486e92aaf64c6226c673 msgid "|circle|" msgstr "" #: ../../annot.rst:608 031e9835b5ea4674bd3bcd678ae780a5 #: 8bea81da58c844a9abeb9a5253d1a9b6 msgid "circle" msgstr "" #: ../../annot.rst:612 a8717fc2c8cd4706b95166aae42c2f9b msgid "Footnotes" msgstr "脚注" #: ../../annot.rst:613 6d03771b774345a5b005846ee4002288 msgid "" "Rotating an annotation also changes its rectangle. Depending on how the " "annotation was defined, the original rectangle is **cannot be " "reconstructed** by setting the rotation value to zero again and will be " "lost." msgstr "" "注釈を回転させると、その矩形も変更されます。注釈がどのように定義されたかによって、元の矩形は回転値を再びゼロに設定しても **再構築できず** " "、失われます。" #: ../../annot.rst:615 c6c9d602fa054b6fac8c6ec2c52ad078 msgid "" "Only the following annotation types support method " ":meth:`Annot.set_rect`: Text, FreeText, Square, Circle, Redact, Stamp, " "Caret, FileAttachment, Sound, and Movie." msgstr "" ":meth:`Annot.set_rect` " "をサポートする注釈タイプは、次のものだけです：Text、FreeText、Square、Circle、Redact、Stamp、Caret、FileAttachment、Sound、およびMovie。" #: ../../footer.rst:46 bc670bbcee16481398498b6cc9d3f828 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "**This class is supported for PDF documents only.**" #~ msgstr "**このクラスはPDFドキュメントのみに対応しています。** " #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "While 'FreeText', 'Line', 'PolyLine', and " #~ "'Polygon' annotations can have these " #~ "properties, (Py-) MuPDF does not support" #~ " line ends for 'FreeText', because " #~ "the call-out variant of it is " #~ "not supported." #~ msgstr "" #~ "「FreeText」、「Line」、「PolyLine」、および「Polygon」注釈はこれらのプロパティを持つことができますが、（Py-）MuPDF" #~ " は「FreeText」の線終端をサポートしていません。なぜなら、そのコールアウトバリアントはサポートされていないからです。" #~ msgid "" #~ "*(Changed in v1.16.16)* Some symbols " #~ "have an interior area (diamonds, " #~ "circles, squares, etc.). By default, " #~ "these areas are filled with the " #~ "fill color of the annotation. If " #~ "this is ``None``, then white is " #~ "chosen. The *fill_color* argument of " #~ ":meth:`Annot.update` can now be used to" #~ " override this and give line end " #~ "symbols their own fill color." #~ msgstr "" #~ "*（v1.16.16 で変更）* " #~ "一部のシンボルには内部領域（ダイヤモンド、円、正方形など）があります。デフォルトでは、これらの領域は注釈の塗りつぶし色で塗りつぶされます。これが" #~ " ``None`` の場合、白色が選択されます。:meth:`Annot.update` の " #~ "*fill_color* 引数を使用して、線終端シンボルに独自の塗りつぶし色を設定することができるようになりました。" #~ msgid "" #~ "Changed in version 1.16.9: Allow colors" #~ " to be directly set. These parameters" #~ " are used if *colors* is not a" #~ " dictionary." #~ msgstr "バージョン1.16.9で変更: 色を直接設定できるようにしました。これらのパラメータは、*colors* が辞書でない場合に使用されます。" #~ msgid "" #~ "the fill color. * 'Line', 'Polyline'," #~ " 'Polygon' annotations: use it to " #~ "give applicable line end symbols a " #~ "fill color other than that of the" #~ " annotation *(changed in v1.16.16)*." #~ msgstr "" #~ msgid "" #~ "'Line', 'Polyline', 'Polygon' annotations: use" #~ " it to give applicable line end " #~ "symbols a fill color other than " #~ "that of the annotation *(changed in " #~ "v1.16.16)*." #~ msgstr "" #~ "'Line'、'Polyline'、'Polygon' " #~ "注釈：適用可能な線の端のシンボルに注釈の色以外の塗りつぶしの色を与えるために使用します *（v1.16.16で変更）* " #~ "。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/app1.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 fdfbfd4ec6524865abf05d4f02f40bd4 msgid "Artifex" msgstr "" #: ../../header.rst:-1 4ef893e3d65549bdb97761ade9d2fbe0 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 93b3b77eb5fb4d609385d37e1b52f560 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../app1.rst:7 32522e45284f47b9a2baab2001f554fc msgid "Appendix 1: Details on Text Extraction" msgstr "付録1: テキスト抽出の詳細" #: ../../app1.rst:8 7a46450d4e694b47ba30ff347aa1295a msgid "" "This chapter provides background on the text extraction methods of " "PyMuPDF." msgstr "この章では、PyMuPDFのテキスト抽出メソッドに関する背景情報を提供します。" #: ../../app1.rst:10 433c42d12e1e466887a62caef1d48c04 msgid "Information of interest are" msgstr "興味のある情報は以下です" #: ../../app1.rst:12 855bc392f61942508bcfcfee3ff9ad79 msgid "what do they provide?" msgstr "彼らは何を提供するのか？" #: ../../app1.rst:13 7bfcfb2ef4424ff1bfff9c532da582fc msgid "what do they imply (processing time / data sizes)?" msgstr "それらは何を意味するのか（処理時間 / データサイズ）？" #: ../../app1.rst:16 f054be020fee4f7dbe78d82ec1f9a215 msgid "General structure of a TextPage" msgstr "TextPageの一般的な構造" #: ../../app1.rst:17 c38170b0abfd4137afa0635a2f080530 msgid "" ":ref:`TextPage` is one of (Py-) MuPDF's classes. It is normally created " "(and destroyed again) behind the curtain, when :ref:`Page` text " "extraction methods are used, but it is also available directly and can be" " used as a persistent object. Other than its name suggests, images may " "optionally also be part of a text page::" msgstr "" ":ref:`TextPage` は（Py-）MuPDFのクラスの一つです。通常、:ref:`Page` " "のテキスト抽出メソッドが使用されるときにカーテンの後ろで作成され（および破棄され）ますが、直接利用することもでき、永続オブジェクトとして使用することができます。その名前が示すよりも、テキストページにはオプションで画像も含まれる場合があります：" #: ../../app1.rst:27 fa5133b907134789b7b5bcf5427df499 msgid "A **text page** consists of blocks (= roughly paragraphs)." msgstr "**テキストページ** は、ブロック（おおよそ段落）で構成されています。" #: ../../app1.rst:29 8a84fe5ed0fa4b028ce78c0283f42e05 msgid "A **block** consists of either lines and their characters, or an image." msgstr "**ブロック** は、行とその文字、または画像のいずれかから成り立っています。" #: ../../app1.rst:31 b618a5ef31c6418385e67337d450a352 msgid "A **line** consists of spans." msgstr "**行** は、スパンから成り立っています。" #: ../../app1.rst:33 10807e13bcf148d1901a347693b84092 msgid "" "A **span** consists of adjacent characters with identical font " "properties: name, size, flags and color." msgstr "**スパン** は、同一のフォントプロパティ（名前、サイズ、フラグ、色）を持つ隣接する文字から成り立っています。" #: ../../app1.rst:36 94770e1286bd45faa80dd24ab08a2b98 msgid "Plain Text" msgstr "プレーンテキスト" #: ../../app1.rst:38 4e59da8e7882467d9e3fc99a17ebcd20 msgid "" "Function :meth:`TextPage.extractText` (or *Page.get_text(\"text\")*) " "extracts a page's plain **text in original order** as specified by the " "creator of the document." msgstr "" "関数 :meth:`TextPage.extractText` （または *Page.get_text(\"text\")* " "）は、ドキュメントの作成者によって指定された元の順序で、ページのプレーンテキストを抽出します。" #: ../../app1.rst:40 43eb12dcbd3741a39565376bce991deb msgid "An example output::" msgstr "例の出力：" #: ../../app1.rst:45 9b508c1639d948d0bb34f53480a454de msgid "" "The output may not equal an accustomed \"natural\" reading order. " "However, you can request a reordering following the scheme \"top-left to " "bottom-right\" by executing `page.get_text(\"text\", sort=True)`." msgstr "" "出力は通常の「自然な」読み順と一致しない場合があります。ただし、`page.get_text(\"text\", sort=True)` " "を実行することで、「左上から右下」のスキームに従った並べ替えを要求することができます。" #: ../../app1.rst:49 ../../app1.rst:337 01218363ec8b4f25b01be035183f2bad #: ea3b77edca944acd87dfae64354fc218 msgid "BLOCKS" msgstr "ブロック" #: ../../app1.rst:51 84c30a08712041efbd0d51b5d1f3b869 msgid "" "Function :meth:`TextPage.extractBLOCKS` (or *Page.get_text(\"blocks\")*) " "extracts a page's text blocks as a list of items like::" msgstr "" "関数 :meth:`TextPage.extractBLOCKS` （または `Page.get_text(\"blocks\")` " "）は、ページのテキストブロックを以下のような項目のリストとして抽出します：" #: ../../app1.rst:55 eca4a5b7ac1e429d922a4caaf3b1508a msgid "" "Where the first 4 items are the float coordinates of the block's bbox. " "The lines within each block are concatenated by a new-line character." msgstr "最初の4つの項目は、ブロックのバウンディングボックスの浮動小数点座標です。各ブロック内の行は改行文字で連結されます。" #: ../../app1.rst:57 a2ec0b47ebce4d5a924b99a85953372a msgid "" "This is a high-speed method, which by default also extracts image meta " "information: Each image appears as a block with one text line, which " "contains meta information. The image itself is not shown." msgstr "これは高速なメソッドであり、デフォルトでは画像のメタ情報も抽出されます。各画像はメタ情報を含む1行のテキスト行で表されるブロックとして表示されます。画像そのものは表示されません。" #: ../../app1.rst:59 c7b5a7b9a23e458a96b54934b3ed775f msgid "" "As with simple text output above, the `sort` argument can be used as well" " to obtain a reading order." msgstr "前述の単純なテキスト出力と同様に、`sort` 引数を使用して読み順を取得することもできます。" #: ../../app1.rst:61 ../../app1.rst:79 a78d72a8fc184086a8d50d1cf5a9ef1a #: e2343d105e624aeb882debda02386431 msgid "Example output::" msgstr "例の出力：" #: ../../app1.rst:69 ../../app1.rst:338 acff28e048b34b4ba229b68304cfb76b #: cddad20f52224312b51a7f0c5053ac5a msgid "WORDS" msgstr "単語" #: ../../app1.rst:71 89a704f3ac384146b0b14fac38aa5a65 msgid "" "Function :meth:`TextPage.extractWORDS` (or *Page.get_text(\"words\")*) " "extracts a page's text **words** as a list of items like::" msgstr "" "関数 :meth:`TextPage.extractWORDS` （または *Page.get_text(\"words\")* " "）は、ページのテキスト単語を以下のような項目のリストとして抽出します：" #: ../../app1.rst:75 f050c877e9a940cdbec7cc265b1bb992 msgid "" "Where the first 4 items are the float coordinates of the words's bbox. " "The last three integers provide some more information on the word's " "whereabouts." msgstr "最初の4つの項目は、単語のバウンディングボックスの浮動小数点座標です。最後の3つの整数は、単語の位置に関する追加情報を提供します" #: ../../app1.rst:77 0f54ed7a09db4671bf357a69f4eaf0cf msgid "" "This is a high-speed method. As with the previous methods, argument " "`sort=True` will reorder the words." msgstr "これは高速なメソッドです。前のメソッドと同様に、引数 `sort=True` を使用すると単語が再並べ替えされます。" #: ../../app1.rst:95 ../../app1.rst:341 9c256b41e353481a8f9d1120383e185d #: b01eed8bd2214d029f98ed8e402c64ec msgid "HTML" msgstr "" #: ../../app1.rst:97 ae629776c0304c299e0e8d208a5c09fa msgid "" ":meth:`TextPage.extractHTML` (or *Page.get_text(\"html\")* output fully " "reflects the structure of the page's ``TextPage`` -- much like DICT / " "JSON below. This includes images, font information and text positions. If" " wrapped in HTML header and trailer code, it can readily be displayed by " "an internet browser. Our above example::" msgstr "" ":meth:`TextPage.extractHTML` （または *Page.get_text(\"html\"）* の出力は、ページの " "`TextPage` の構造を完全に反映します。これは、以下のDICT / " "JSONのようなものです。これには画像、フォント情報、テキスト位置が含まれます。HTMLヘッダーとトレイラーコードで囲むと、インターネットブラウザで簡単に表示できます。上記の例：" #: ../../app1.rst:113 7390b832da484722ac5b9460920b0c9b msgid "Controlling Quality of HTML Output" msgstr "HTML出力の品質の制御" #: ../../app1.rst:114 cda88645b63f404c8de487595a91b015 msgid "" "While HTML output has improved a lot in MuPDF v1.12.0, it is not yet bug-" "free: we have found problems in the areas **font support** and **image " "positioning**." msgstr "" "MuPDF v1.12.0でHTML出力はかなり改善されましたが、まだバグがないわけではありません。**フォントサポート** や**画像の配置**" " に関する問題が見つかっています。" #: ../../app1.rst:116 8e67f6c0b40547eb8c013174c0840a60 msgid "" "HTML text contains references to the fonts used of the original document." " If these are not known to the browser (a fat chance!), it will replace " "them with others; the results will probably look awkward. This issue " "varies greatly by browser -- on my Windows machine, MS Edge worked just " "fine, whereas Firefox looked horrible." msgstr "" "HTMLテキストには元のドキュメントで使用されたフォントへの参照が含まれています。もしブラウザがそれらを認識できない場合（少ない確率ですが）、他のフォントで置き換えられ、結果が奇妙に見えるかもしれません。この問題はブラウザによって大きく異なります。Windowsマシンでは、MS" " Edgeはうまく動作するかもしれませんが、Firefoxはひどく見えるかもしれません。" #: ../../app1.rst:118 a84f551c6b3c4c0daaeda98b73eff629 msgid "" "For PDFs with a complex structure, images may not be positioned and / or " "sized correctly. This seems to be the case for rotated pages and pages, " "where the various possible page bbox variants do not coincide (e.g. " "*MediaBox != CropBox*). We do not know yet, how to address this -- we " "filed a bug at MuPDF's site." msgstr "" "複雑な構造を持つPDFの場合、画像の位置やサイズが正しく配置されないことがあります。これは回転したページや、さまざまなページbboxのバリアントが一致しない場合に起こる可能性があります（たとえば、*MediaBox" " != CropBox* ）。これに対処する方法はまだわかっていませんが、MuPDFのサイトにバグを報告しました。" #: ../../app1.rst:120 ede45259306f4b25a8a69c2642ee7790 msgid "" "To address the font issue, you can use a simple utility script to scan " "through the HTML file and replace font references. Here is a little " "example that replaces all fonts with one of the :ref:`Base-14-Fonts`: " "serifed fonts will become \"Times\", non-serifed \"Helvetica\" and " "monospaced will become \"Courier\". Their respective variations for " "\"bold\", \"italic\", etc. are hopefully done correctly by your browser::" msgstr "フォントの問題に対処するために、HTMLファイルをスキャンし、フォントの参照を置換するシンプルなユーティリティスクリプトを使用できます。以下は、すべてのフォントをPDFのベース14フォントの一つに置き換える例です：セリフフォントは「Times」になり、セリフのないフォントは「Helvetica」になり、等幅フォントは「Courier」になります。太字、斜体などの各バリエーションは、おそらくブラウザによって正しく処理されるでしょう。" #: ../../app1.rst:160 604f24c1899b445a8e5f147bbea58c6b msgid "DICT (or JSON)" msgstr "DICT（またはJSON）" #: ../../app1.rst:162 2b4124eaa6184e5abeb4751eb27b7d28 msgid "" ":meth:`TextPage.extractDICT` (or *Page.get_text(\"dict\", sort=False)*) " "output fully reflects the structure of a ``TextPage`` and provides image " "content and position detail (*bbox* -- boundary boxes in pixel units) for" " every block, line and span. Images are stored as *bytes* for DICT output" " and base64 encoded strings for JSON output." msgstr "" ":meth:`TextPage.extractDICT` （または *Page.get_text(\"dict\", sort=False)* " "）の出力は、 ``TextPage`` の構造を完全に反映し、各ブロック、行、スパンのために画像の内容と位置の詳細（ *bbox* – " "ピクセル単位の境界ボックス）を提供します。画像はDICT出力では *バイト* " "として格納され、JSON出力ではbase64エンコードされた文字列として格納されます。" #: ../../app1.rst:164 c899504e3d93462ebf94a0ae253c284d msgid "" "For a visualization of the dictionary structure have a look at " ":ref:`textpagedict`." msgstr "辞書の構造の可視化については、辞書出力の構造をご覧ください。" #: ../../app1.rst:166 a85a77c0a97a4b999a9608db09a62055 msgid "Here is how this looks like::" msgstr "以下がその様子です：" #: ../../app1.rst:192 a39d5bea096643a481b871a235198902 msgid "RAWDICT (or RAWJSON)" msgstr "RAWDICT（またはRAWJSON）" #: ../../app1.rst:193 e30e534d09664d99a59c74a2819edd1f msgid "" ":meth:`TextPage.extractRAWDICT` (or *Page.get_text(\"rawdict\", " "sort=False)*) is an **information superset of DICT** and takes the detail" " level one step deeper. It looks exactly like the above, except that the " "*\"text\"* items (*string*) in the spans are replaced by the list " "*\"chars\"*. Each *\"chars\"* entry is a character *dict*. For example, " "here is what you would see in place of item *\"text\": \"Text in black " "color.\"* above::" msgstr "" ":meth:`TextPage.extractRAWDICT` （または *Page.get_text(\"rawdict\", " "sort=False)* ）は、**DICTの情報のスーパーセット** " "であり、詳細レベルを一段階深くします。これは上記のように見えますが、スパン内の *「text」* アイテム（文字列）は *「chars」* " "というリストに置き換えられます。各 *「chars」* エントリは文字の *dict* です。例えば、 *「Text in black " "color.」* の代わりに以下のような項目が表示されます：" #: ../../app1.rst:224 ../../app1.rst:339 1019709da94c447c87b21a8889ff73c6 #: 2e6cf3faa00c40b99808a48b7890f736 msgid "XML" msgstr "" #: ../../app1.rst:226 3e2cf1ef340e453c9ee25d4f7a082534 msgid "" "The :meth:`TextPage.extractXML` (or *Page.get_text(\"xml\")*) version " "extracts text (no images) with the detail level of RAWDICT::" msgstr "" ":meth:`TextPage.extractXML` （または *Page.get_text(\"xml\"）* " "バージョンは、RAWDICTの詳細レベルでテキスト（画像なし）を抽出します：" #: ../../app1.rst:255 b27a0017f5ac4d09a62ef96d7158aa58 msgid "" "We have successfully tested `lxml `_ to " "interpret this output." msgstr "この出力を解釈するためにlxmlを使用して正常にテストしました。" #: ../../app1.rst:258 ../../app1.rst:340 769cf57a03fb4d8ebc77e12339dfe126 #: dfb6a028240f4f25ace3456d80f1e379 msgid "XHTML" msgstr "" #: ../../app1.rst:259 9489175cb6d1431fab9e8388a1b5ee8d msgid "" ":meth:`TextPage.extractXHTML` (or *Page.get_text(\"xhtml\")*) is a " "variation of TEXT but in HTML format, containing the bare text and images" " (\"semantic\" output)::" msgstr "" ":meth:`TextPage.extractXHTML` （または *Page.get_text(\"xhtml\"）* " "は、テキストと画像を含むHTML形式のTEXTのバリエーションです（「セマンティック」出力）：" #: ../../app1.rst:268 e1dc4d16be0744a9a7a2b424f7a34574 msgid "Text Extraction Flags Defaults" msgstr "テキスト抽出フラグのデフォルト値" #: ../../app1.rst:269 d6b62f1e66934d9391f12416f05cf4c3 msgid "" "New in version 1.16.2: Method :meth:`Page.get_text` supports a keyword " "parameter *flags* *(int)* to control the amount and the quality of " "extracted data. The following table shows the defaults settings (flags " "parameter omitted or None) for each extraction variant. If you specify " "flags with a value other than ``None``, be aware that you must set **all " "desired** options. A description of the respective bit settings can be " "found in :ref:`TextPreserve`." msgstr "" "バージョン1.16.2で新しく追加されたメソッド :meth:`Page.get_text` " "は、抽出されるデータの量と品質を制御するためのキーワードパラメータ `flags` " "（整数）をサポートしています。以下の表は、各抽出バリエーションのデフォルト設定（ `flags` " "パラメータが省略されたかNoneの場合）を示しています。 `None` 以外の値でflagsを指定する場合は、**すべての必要なオプション** " "を設定する必要があることに注意してください。各ビット設定の説明は「テキスト抽出フラグ」で確認できます。" #: ../../app1.rst:271 e8bfb1e18c8a40ef9482158b1b48b799 msgid "" "New in v1.19.6: The default combinations in the following table are now " "available as Python constants: :data:`TEXTFLAGS_TEXT`, " ":data:`TEXTFLAGS_WORDS`, :data:`TEXTFLAGS_BLOCKS`, " ":data:`TEXTFLAGS_DICT`, :data:`TEXTFLAGS_RAWDICT`, " ":data:`TEXTFLAGS_HTML`, :data:`TEXTFLAGS_XHTML`, :data:`TEXTFLAGS_XML`, " "and :data:`TEXTFLAGS_SEARCH`. You can now easily modify a default flag, " "e.g." msgstr "" "バージョン1.19.6で新しく追加された変更：次の表のデフォルトの組み合わせは、Pythonの定数として利用可能です： " ":data:`TEXTFLAGS_TEXT` 、 :data:`TEXTFLAGS_WORDS` 、 " ":data:`TEXTFLAGS_BLOCKS` 、 :data:`TEXTFLAGS_DICT` 、 " ":data:`TEXTFLAGS_RAWDICT` 、 :data:`TEXTFLAGS_HTML` 、 " ":data:`TEXTFLAGS_XHTML` 、 :data:`TEXTFLAGS_XML` 、 " ":data:`TEXTFLAGS_SEARCH` 。これにより、デフォルトのフラグを簡単に変更できます。例えば、" #: ../../app1.rst:273 6b7d5e078dee4d8faefcc18f13641d84 msgid "**include** images in a \"blocks\" output:" msgstr "「blocks」出力に画像を **含める** 場合：" #: ../../app1.rst:275 920d23e221534056b885ac4d2aa40959 msgid "`flags = TEXTFLAGS_BLOCKS | TEXT_PRESERVE_IMAGES`" msgstr "" #: ../../app1.rst:277 442e0b5271e84503b89c3efda021a625 msgid "**exclude** images from a \"dict\" output:" msgstr "「dict」出力から画像を **除外する** 場合：" #: ../../app1.rst:279 8cc83a12e452488bbb0828a5b22c007b msgid "`flags = TEXTFLAGS_DICT & ~TEXT_PRESERVE_IMAGES`" msgstr "" #: ../../app1.rst:281 883ad6fe76334652937ecd82fe8393a8 msgid "set **dehyphenation off** in text searches:" msgstr "テキスト検索での **ハイフネーション** をオフに設定する：" #: ../../app1.rst:283 46170567ecc240c88108dc6a14ac7982 msgid "`flags = TEXTFLAGS_SEARCH & ~TEXT_DEHYPHENATE`" msgstr "" #: ../../app1.rst:287 82de7610a8c84cdaa15aafa49960bf9a msgid "Indicator" msgstr "指標" #: ../../app1.rst:287 3892913f9254485a94780c276805766c msgid "text" msgstr "" #: ../../app1.rst:287 37c756db16324c458f86f66f086d1941 msgid "html" msgstr "" #: ../../app1.rst:287 5063d3e2784149f188ffae7dcee78a89 msgid "xhtml" msgstr "" #: ../../app1.rst:287 0f75631f443a4653a3622a073d27d5a5 msgid "xml" msgstr "" #: ../../app1.rst:287 5a83675663804474931ef4cde1e02911 msgid "dict" msgstr "" #: ../../app1.rst:287 78bc13d9ae104947a657ed2b864c5af2 msgid "rawdict" msgstr "" #: ../../app1.rst:287 c2b7a5a2bcd040c48f4832612cda9e17 msgid "words" msgstr "" #: ../../app1.rst:287 e0b980adf7324d1cbf814983a363fe72 msgid "blocks" msgstr "" #: ../../app1.rst:287 dd0b10b8c86e4f088602b83a1b03aa0d msgid "search" msgstr "" #: ../../app1.rst:289 9782eb815e0b457292e05170f64c6ada msgid "preserve ligatures" msgstr "連結を保持" #: ../../app1.rst:289 ../../app1.rst:290 ../../app1.rst:291 ../../app1.rst:293 #: ../../app1.rst:294 ../../app1.rst:295 1e983a6cb6d44aceb3853c9a83ba5aaf #: 20b8ab4098ee4007bac8fd0a40bfdbb3 233a030d06984ee593bb98e31c636824 #: 2b27ec6f790744eb9312d79895d0f846 3b76c164a3bd43af8ddd602b9fb58732 #: 3b9f9e75e6cc47f79c07151895da4ffd 47460e3c55b04dc4b8ace07d8270df1c #: 4bdb19637b214e6491ff869852694c6a 567e1e72445749069d46f1f2eff63e0f #: 59a08f97de8d4245a3e54d4fb26b0291 5c07f51342ce4bba9fc7be3cda6af8df #: 5d843f7031c14f799bd56886af16313f 6f96176fe534473abd3d0a3b10886daf #: 775cb0f5f029464d8b6b265a6bd9fbcb 7f8c04030eb2428a8b6e3e4aa1434875 #: 808f822d5cb846f8bf7e619119fb9318 92acb46014f34d0e94841db5fa7aee7f #: 93a5eb0806364fc79a03a21a7e1aae61 98b5b944f37445a483864fd0c3c1acc4 #: 99ab73e65de34fa382f9740422544e20 a2e3210d3b93435d8ae28371d790b824 #: a3d6d493a3b043b98c7cb1f8282d9733 a8ca4f38d35b49a399948cd811aa950a #: b718c1a0f6744595bea22305cb934b23 bbbec0ca7da34f32aab5fff3961bc220 #: bf51c38c6b3b4c3aa9e4a844f049a028 c89bbe13e12949ddb0baa34db3c1e2dc #: cee800543a0646cca1e99c244818c547 d21544b4657c404689ea4a1442e7b770 #: d540a50f31844489b476bc3b2eccf0bf df435d6f1108468683ceacd21cfd87c9 #: e0d49fa814f943faac85b4230fc44880 ed76c68df9d6403bb3828c2fa2b236f3 #: ef74eb0f02c24d33becc781ce950b651 f20c32d4888f4d029ee7074ede80e23a #: f5ce82fd58e648bd8434116561a19697 f6559ff8a2154209bc3e256c2035e51a #: fbd7fda4af014d3882244ca311699849 fc0e3ef690de498a853cfa1bbf8aa702 msgid "1" msgstr "" #: ../../app1.rst:289 ../../app1.rst:291 ../../app1.rst:292 ../../app1.rst:293 #: ../../app1.rst:295 06a775ff9e024c69b2b20b72b87e2f39 #: 0dcfeff6364f486b85e82098cd35dad9 251e9b0cc0c1420fae3dd91f99f24d7f #: 3698b2725d17402fb0a6d21a9f8528a6 46a337a4a68e49d7a800dd9701077648 #: 4ba8146f24be48239504f8a299500f64 4dda4b0faa7a41b4bd93757bfa5e48fc #: 52d30ea082894e04b0ccd40e6bafc7a5 5994e677f5c94c30828758452ab35e2c #: 6063573b774c440dabdd54208c398123 62ed92eea3bd495b99addd70a3fd7823 #: 6d98e245478f48c590bdc7e8f8585eda 709d6cddbcef491aa2d2d653bb6ecb16 #: 86e73f4e80894ea5b04fa62a9ca34165 9f9ddfd3cdab40c58298f9300c4e6ad0 #: a8f2711acc19466397e196137cd3d96a bc6bd4d438e8412289b2d55436bd3341 #: dbb1a8bf2fa344d9916b1ec4ebf075db ef81628962544a8ebf82a15aac960331 #: f18b0d81b3da4760894d1814700e43c4 fe2557a2e37b4bf29c6cd13888e1ba55 msgid "0" msgstr "" #: ../../app1.rst:290 1beaf7102f1945d8bbb04d397b9227f1 msgid "preserve whitespace" msgstr "空白を保持" #: ../../app1.rst:291 4691c88b06074b38896de74a86973a95 msgid "preserve images" msgstr "画像を保持" #: ../../app1.rst:291 b2eacea067054a2c89b01026f348d200 #: cde51036a4774390b6b3b86bad72cebf d34b28c25d6a4b8eb72ae032050e8ef2 msgid "n/a" msgstr "" #: ../../app1.rst:292 6280ef433e7648fd83936d5d9fabf2e3 msgid "inhibit spaces" msgstr "スペースの抑制" #: ../../app1.rst:293 ffbb4fff9bc14f4b89c7138073298de3 msgid "dehyphenate" msgstr "ハイフネーション解除" #: ../../app1.rst:294 1c61f64ea3c046aa98ef330907277d28 msgid "clip to mediabox" msgstr "メディアボックスにクリップ" #: ../../app1.rst:295 46e9e87165ad4603ad27fca406580f85 msgid "use CID instead of U+FFFD" msgstr "" #: ../../app1.rst:298 d03c9f5449f345a3b73490298a0485f9 msgid "**search** refers to the text search function." msgstr "**検索** はテキスト検索機能を指します。" #: ../../app1.rst:299 e69a3f6563a349f7ac389cad653d8f9f msgid "**\"json\"** is handled exactly like **\"dict\"** and is hence left out." msgstr "**「json」** は **「dict」** とまったく同様に処理されるため、省略されています。" #: ../../app1.rst:300 00f7c04e64ee45e09727561d7a20c052 msgid "" "**\"rawjson\"** is handled exactly like **\"rawdict\"** and is hence left" " out." msgstr "**「rawjson」** は **「rawdict」** とまったく同様に処理されるため、省略されています。" #: ../../app1.rst:301 6b8b4b0d4438489eb25ff507f4d3b024 msgid "" "An \"n/a\" specification means a value of 0 and setting this bit never " "has any effect on the output (but an adverse effect on performance)." msgstr "「n/a」の指定は値が0であり、このビットを設定しても出力に影響を与えることはありません（ただしパフォーマンスに悪影響を及ぼす可能性があります）。" #: ../../app1.rst:302 9e71d45dfa8a432a85b4c21b50596e46 msgid "" "If you are not interested in images when using an output variant which " "includes them by default, then by all means set the respective bit off: " "You will experience a better performance and much lower space " "requirements." msgstr "画像を含む出力バリアントを使用する際に画像に興味がない場合、必ず該当するビットをオフに設定してください。これにより、パフォーマンスが向上し、スペース要件が大幅に削減されます。" #: ../../app1.rst:304 4babe75226f64adeb13494c473d77bda msgid "To show the effect of `TEXT_INHIBIT_SPACES` have a look at this example::" msgstr "`TEXT_INHIBIT_SPACES` の効果を示すために、この例をご覧ください：" #: ../../app1.rst:324 791593433363447884bf96a0f495a7ed msgid "Performance" msgstr "パフォーマンス" #: ../../app1.rst:325 0da8da4ddf0640e08849ffc214bbc392 msgid "" "The text extraction methods differ significantly both: in terms of " "information they supply, and in terms of resource requirements and " "runtimes. Generally, more information of course means, that more " "processing is required and a higher data volume is generated." msgstr "テキスト抽出メソッドは、情報の提供方法とリソース要件、実行時間の両方で大きく異なります。一般的に、情報が多いほど処理が必要であり、より多くのデータが生成されることを意味します。" #: ../../app1.rst:327 20586902aec24daab2b5f3efb0591035 #, python-format msgid "" "Especially images have a **very significant** impact. Make sure to " "exclude them (via the *flags* parameter) whenever you do not need them. " "To process the below mentioned 2'700 total pages with default flags " "settings required 160 seconds across all extraction methods. When all " "images where excluded, less than 50% of that time (77 seconds) were " "needed." msgstr "" "特に画像は **非常に大きな** " "影響を持ちます。必要のない場合は、必ず画像を除外する（フラグパラメータを使用）ようにしてください。以下で言及されている2,700ページの総ページ数をデフォルトのフラグ設定で処理するには、全ての抽出メソッドで160秒が必要でした。画像をすべて除外した場合、その時間の50%未満（77秒）が必要でした。" #: ../../app1.rst:329 2e8a95a956e644ac8d4696dce6c61cc2 msgid "" "To begin with, all methods are **very fast** in relation to other " "products out there in the market. In terms of processing speed, we are " "not aware of a faster (free) tool. Even the most detailed method, " "RAWDICT, processes all 1'310 pages of the :ref:`AdobeManual` in less than" " 5 seconds (simple text needs less than 2 seconds here)." msgstr "" "まず始めに、すべてのメソッドは市場にある他の製品と比べて **非常に高速** " "です。処理速度の観点から、より速い（無料の）ツールは私たちの知る限り存在しません。最も詳細なメソッドであるRAWDICTでも、 " ":ref:`AdobeManual` リファレンスの1,310ページを5秒未満で処理できます（ここでは簡単なテキストは2秒未満で処理されます）。" #: ../../app1.rst:331 b478d8651f884657b5f2968d78bde08e msgid "" "The following table shows average relative speeds (\"RSpeed\", baseline " "1.00 is TEXT), taken across ca. 1400 text-heavy and 1300 image-heavy " "pages." msgstr "以下の表は、約1400ページのテキストが多く、約1300ページが画像が多いページでの平均相対速度（ベースライン1.00はTEXT）を示しています。" #: ../../app1.rst:334 e4cd1e92a16243b9bdc20d79c041f5ab msgid "Method" msgstr "メソッド" #: ../../app1.rst:334 e7cdf152a1914df4b50d9e29af7c6414 msgid "RSpeed" msgstr "平均相対" #: ../../app1.rst:334 d842d0f8ae3a48d0a969867502970a0c msgid "Comments" msgstr "コメント" #: ../../app1.rst:334 48d44a0956cd43a1b911aeb4417696ea msgid "no images" msgstr "画像なし" #: ../../app1.rst:336 52d85a2f5b704adc8c686c36a9f92fe2 msgid "TEXT" msgstr "" #: ../../app1.rst:336 ../../app1.rst:337 ../../app1.rst:340 #: 3bcb90f59d8f4da58255a7a86093aa07 59f27de687b642ddb52e91f17533cc5b #: a0b2dcf2b2ef4bd7ad4cff46bb823559 db1033e32d794e808303b3da34f587ac #: f1cf54ba71c34f339ccf48d538136125 msgid "1.00" msgstr "" #: ../../app1.rst:336 6dabc232af8f4901aea1c358a0ae9564 msgid "no images, **plain** text, line breaks" msgstr "画像なし、 **プレーン** テキスト、改行" #: ../../app1.rst:337 23cec37141ab47548b08ce6a51c47532 msgid "image bboxes (only), **block** level text with bboxes, line breaks" msgstr "画像のバウンディングボックス（のみ）、 **ブロック** レベルのテキストとバウンディングボックス、改行" #: ../../app1.rst:338 04eaefca5e1f41eda6d2831fd36c1a5d #: 4f0d944bd46143d298a7a366f9b35d36 msgid "1.02" msgstr "" #: ../../app1.rst:338 f4c82b98aa294a4ba829c5ba6dd0b736 msgid "no images, **word** level text with bboxes" msgstr "画像なし、 **ワード** レベルのテキストとバウンディングボックス" #: ../../app1.rst:339 6b2dcc5f62e242a3bc9579407a6568a1 #: f95901f3f681472a947f2f30ee664a42 msgid "2.72" msgstr "" #: ../../app1.rst:339 8a17afd3b00a478db3c1a02c3174167f msgid "no images, **char** level text, layout and font details" msgstr "画像なし、**文字** レベルのテキスト、レイアウトとフォントの詳細" #: ../../app1.rst:340 0f0de8a5134b47348c6bb22b8c2a813a msgid "3.32" msgstr "" #: ../../app1.rst:340 fa9159767f484518983dcfa06467eead msgid "**base64** images, **span** level text, no layout info" msgstr "**base64** 画像、 **スパン** レベルのテキスト、レイアウト情報なし" #: ../../app1.rst:341 efb4a91cc528491c86864634ab1c8962 msgid "3.54" msgstr "" #: ../../app1.rst:341 612c89df3d5046f399cd591cbecfa4d1 msgid "**base64** images, **span** level text, layout and font details" msgstr "**base64画像** 、 **スパン** レベルのテキスト、レイアウトとフォントの詳細" #: ../../app1.rst:341 82007c0df4b04de7b342be7f608efe6d msgid "1.01" msgstr "" #: ../../app1.rst:342 22c93672d1754b45979767b416822fc9 msgid "DICT" msgstr "" #: ../../app1.rst:342 73dbc0957638492db3cb33c44afc4ff0 msgid "3.93" msgstr "" #: ../../app1.rst:342 081b9112703a4d6f8b31780c1f8d4708 msgid "**binary** images, **span** level text, layout and font details" msgstr "**バイナリ** 画像、 **スパン** レベルのテキスト、レイアウトとフォントの詳細" #: ../../app1.rst:342 c0b41f51a7214a12a3efec0ecbba1e5f msgid "1.04" msgstr "" #: ../../app1.rst:343 5de542c1e80e424294d32a859e17ca43 msgid "RAWDICT" msgstr "" #: ../../app1.rst:343 8bec4991b902406e931341dbb186a6d0 msgid "4.50" msgstr "" #: ../../app1.rst:343 c4f7dd03bce440c6a1820660104e7a31 msgid "**binary** images, **char** level text, layout and font details" msgstr "**バイナリ** 画像、**文字** レベルのテキスト、レイアウトとフォントの詳細" #: ../../app1.rst:343 71321cf4b722412abdf5f6eaa793ec1d msgid "1.68" msgstr "" #: ../../app1.rst:346 e12d6cb6be1b4701a2b213d3f27afa27 #, python-format msgid "" "As mentioned: when excluding image extraction (last column), the relative" " speeds are changing drastically: except RAWDICT and XML, the other " "methods are almost equally fast, and RAWDICT requires 40% less execution " "time than the **now slowest XML**." msgstr "" "前述のように、画像の抽出を除外する場合（最後の列）、相対速度は大きく変わります。RAWDICTとXMLを除いて、他のメソッドはほぼ同じ速さであり、RAWDICTは" " **今では遅いXML** よりも40％少ない実行時間を必要とします。" #: ../../app1.rst:348 6750dde161a54ad6adb3ada9203f0253 msgid "Look at chapter **Appendix 1** for more performance information." msgstr "もっとパフォーマンス情報については、 **付録1章** をご覧ください。" #: ../../footer.rst:60 05804a3786b14f7fa5098ddfaf65f873 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/app2.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ce178b1ad1a74ee4b4c40ab17fe257ae msgid "Artifex" msgstr "" #: ../../header.rst:-1 419c2281e2e246658e42483c0a1fc0d6 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 ebb04a69cb76400eb6074b4c9c39ec1f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../app2.rst:7 64d6bda691354b77987e85bd9a04296b msgid "Appendix 2: Considerations on Embedded Files" msgstr "付録2：埋め込みファイルに関する考慮事項" #: ../../app2.rst:8 d15d38307aa649f983ce5b15f6c6a3fd msgid "" "This chapter provides some background on embedded files support in " "PyMuPDF." msgstr "この章では、PyMuPDFにおける埋め込みファイルのサポートに関する背景情報を提供します。" #: ../../app2.rst:11 20abd6d046f14fb19306663331d645c0 msgid "General" msgstr "一般" #: ../../app2.rst:12 7dd965f6d81847bb95992e2db8036f26 msgid "" "Starting with version 1.4, PDF supports embedding arbitrary files as part" " (\"Embedded File Streams\") of a PDF document file (see chapter \"7.11.4" " Embedded File Streams\", pp. 103 of the :ref:`AdobeManual`)." msgstr "" "バージョン1.4から、PDFはPDFドキュメントファイルの一部として任意のファイルを埋め込むことができるようになりました（「7.11.4 " "埋め込みファイルストリーム」章を参照、 :ref:`AdobeManual` リファレンスの103ページ）。" #: ../../app2.rst:15 9673011500be45a5b2780b4f29fcb427 msgid "" "In many aspects, this is comparable to concepts also found in ZIP files " "or the OLE technique in MS Windows. PDF embedded files do, however, *not*" " support directory structures as does the ZIP format. An embedded file " "can in turn contain embedded files itself." msgstr "" "多くの側面で、これはZIPファイルやMS " "WindowsのOLE技術でも見られる概念に類似しています。ただし、PDFの埋め込みファイルはZIP形式とは異なり、ディレクトリ構造をサポート " "*しません* 。埋め込みファイル自体もさらに埋め込みファイルを含むことができます。" #: ../../app2.rst:17 21d8ec87be9d4021aec6fa647434f686 msgid "" "Advantages of this concept are that embedded files are under the PDF " "umbrella, benefitting from its permissions / password protection and " "integrity aspects: all data, which a PDF may reference or even may be " "dependent on, can be bundled into it and so form a single, consistent " "unit of information." msgstr "このコンセプトの利点は、埋め込みファイルがPDFの枠組みに含まれ、その権限/パスワード保護および整合性の側面を活用できることです。PDFが参照するデータや依存する可能性があるデータはすべて、PDFにまとめて1つの一貫した情報ユニットを形成することができます。" #: ../../app2.rst:19 27f0645490d24afd94260b80f51190e2 msgid "" "In addition to embedded files, PDF 1.7 adds *collections* to its support " "range. This is an advanced way of storing and presenting meta information" " (i.e. arbitrary and extensible properties) of embedded files." msgstr "" "埋め込みファイルに加えて、PDF 1.7は *コレクション* " "をサポート範囲に追加しました。これは、埋め込みファイルのメタ情報（任意で拡張可能なプロパティ）を格納し、表示する高度な方法です" #: ../../app2.rst:22 6461638e9a0c4f6d8dd9404f02cae88c msgid "MuPDF Support" msgstr "MuPDFのサポート" #: ../../app2.rst:23 7a4bd68162ca408082e0fe0981edfb0e msgid "" "After adding initial support for collections (portfolios) and " "*/EmbeddedFiles* in MuPDF version 1.11, this support was dropped again in" " version 1.15." msgstr "" "MuPDFバージョン1.11でコレクション（ポートフォリオ）と */EmbeddedFiles* " "への初期サポートを追加した後、このサポートはバージョン1.15で再び削除されました。" #: ../../app2.rst:25 5d971b234a074542a7fe67243445baac msgid "" "As a consequence, the cli utility *mutool* no longer offers access to " "embedded files." msgstr "その結果、cliユーティリティ *mutool* ではもはや埋め込みファイルにアクセスできなくなりました。" #: ../../app2.rst:27 121edfcf69c34685bbfd37adf5eed763 msgid "" "PyMuPDF -- having implemented an */EmbeddedFiles* API in response in its " "version 1.11.0 -- was therefore forced to change gears starting with its " "version 1.16.0 (we never published a MuPDF v1.15.x compatible PyMuPDF)." msgstr "" "PyMuPDFは、バージョン1.11.0で */EmbeddedFiles* " "APIを実装したため、バージョン1.16.0からギアを変更せざるを得なくなりました（MuPDF " "v1.15.x互換のPyMuPDFは公開されませんでした）。" #: ../../app2.rst:29 179951424a4d4e85899ade12ee77d71b msgid "" "We are now maintaining our own code basis supporting embedded files. This" " code makes use of basic MuPDF dictionary and array functions only." msgstr "私たちは現在、埋め込みファイルをサポートする独自のコードベースを維持しています。このコードは、基本的なMuPDFの辞書と配列の機能のみを使用しています。" #: ../../app2.rst:32 9f89c97ca1ff44a59f6b127c6a772547 msgid "PyMuPDF Support" msgstr "PyMuPDFのサポート" #: ../../app2.rst:33 cdda1b955d134a22825d992b8d121028 msgid "" "We continue to support the full old API with respect to embedded files --" " with only minor, cosmetic changes." msgstr "私たちは、埋め込みファイルに関する古いAPIを、わずかな見た目の変更のみを行いながら引き続きサポートしています。" #: ../../app2.rst:35 77890c822c424653bfeba8e464bc73a5 msgid "" "There even also is a new function, which delivers a list of all names " "under which embedded data are registered in a PDF, " ":meth:`Document.embfile_names`." msgstr "" "また、PDF内の埋め込みデータが登録されているすべての名前のリストを返す新しい関数も存在します。:meth:`Document.embfile_names`" " です。" #: ../../footer.rst:60 0a64be666c834c3aaf01bfaa636d73ad msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/app3.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 6a4f4d9aba284482b17f5158db768103 msgid "Artifex" msgstr "" #: ../../header.rst:-1 ca8dbdbe51984f3d841ffa5414e59d9f msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 acc2a6d07e304bfeb3e884b734b79031 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../app3.rst:7 635cfbba07cc4d7fafc89714611a9318 msgid "Appendix 3: Assorted Technical Information" msgstr "付録3：さまざまな技術情報" #: ../../app3.rst:8 4769a2a2c2d84bf2b3ee95f7b4bf80e3 msgid "" "This section deals with various technical topics, that are not " "necessarily related to each other." msgstr "このセクションでは、必ずしも関連しないさまざまな技術的なトピックについて取り扱います。" #: ../../app3.rst:15 ec8a4400984a477ca650493b54e8d584 msgid "Image Transformation Matrix" msgstr "画像変換行列" #: ../../app3.rst:16 e34c11954ed74384aadeee4920e21331 msgid "" "Starting with version 1.18.11, the image transformation matrix is " "returned by some methods for text and image extraction: " ":meth:`Page.get_text` and :meth:`Page.get_image_bbox`." msgstr "" "バージョン1.18.11から、テキストと画像の抽出に関する一部のメソッドで画像変換行列が返されます：:meth:`Page.get_text` " "および :meth:`Page.get_image_bbox` 。" #: ../../app3.rst:18 b72e0ef8b41e494489563ac4faed2c68 msgid "" "The transformation matrix contains information about how an image was " "transformed to fit into the rectangle (its \"boundary box\" = \"bbox\") " "on some document page. By inspecting the image's bbox on the page and " "this matrix, one can determine for example, whether and how the image is " "displayed scaled or rotated on a page." msgstr "変換行列には、画像が文書ページ上の矩形（「境界ボックス」=「bbox」）に適合するためにどのように変換されたかに関する情報が含まれています。ページ上の画像のbboxとこの行列を検査することにより、例えば画像がページ上で拡大縮小または回転して表示されるかどうか、そしてどのように表示されるかを判断することができます。" #: ../../app3.rst:20 d13c3c9d78be4c7baf9efb9708ddda02 msgid "" "The relationship between image dimension and its bbox on a page is the " "following:" msgstr "画像の寸法とページ上のbboxとの関係は次のとおりです：" #: ../../app3.rst:24 24589c9043924415af09f8353878e2fa msgid "Using the original image's width and height," msgstr "元の画像の幅と高さを使用して、" #: ../../app3.rst:23 5fcd053e3c4745e3ac9752cf844e3899 msgid "define the image rectangle `imgrect = pymupdf.Rect(0, 0, width, height)`" msgstr "画像の矩形を `imgrect = pymupdf.Rect(0, 0, width, height)` と定義します。" #: ../../app3.rst:24 7a8b751ef2f84e4eb0d4f3bffd76a9ba msgid "" "define the \"shrink matrix\" `shrink = pymupdf.Matrix(1/width, 0, 0, " "1/height, 0, 0)`." msgstr "「縮小行列」を `shrink = pymupdf.Matrix(1/width, 0, 0,1/height, 0, 0)` と定義します。" #: ../../app3.rst:26 be4e302d72a047d9ad89310d107eb3e3 msgid "" "Transforming the image rectangle with its shrink matrix, will result in " "the unit rectangle: `imgrect * shrink = pymupdf.Rect(0, 0, 1, 1)`." msgstr "" "画像矩形を縮小行列で変換すると、単位矩形が得られます： `imgrect * shrink = pymupdf.Rect(0, 0, 1, 1)`" " 。" #: ../../app3.rst:28 cd872603d2774c46a06dda3917faa61c msgid "" "Using the image **transformation matrix** \"transform\", the following " "steps will compute the bbox::" msgstr "画像 **変換行列** 「transform」を使用して、次の手順でbboxを計算します：" #: ../../app3.rst:34 b2fb7d53a3f8485390e8070c74877726 msgid "" "Inspecting the matrix product `shrink * transform` will reveal all " "information about what happened to the image rectangle to make it fit " "into the bbox on the page: rotation, scaling of its sides and translation" " of its origin. Let us look at an example:" msgstr "" "行列の積 `shrink * transform` " "を検査することで、画像矩形がページ上のbboxに適合させるために何が起こったかに関するすべての情報が明らかになります。回転、辺のスケーリング、および原点の移動です。例を見てみましょう：" #: ../../app3.rst:71 5677aee6873b459a93e06865c3302434 msgid "PDF Base 14 Fonts" msgstr "PDFベース14フォント" #: ../../app3.rst:72 3df5aeca5c3f4ccf9325390f51398b06 msgid "" "The following 14 builtin font names **must be supported by every PDF " "viewer** application. They are available as a dictionary, which maps " "their full names amd their abbreviations in lower case to the full font " "basename. Wherever a **fontname** must be provided in PyMuPDF, any **key " "or value** from the dictionary may be used::" msgstr "" "以下の14の組み込みフォント名は、**すべてのPDFビューアアプリケーションでサポートされる必要があります** " "。これらは辞書として利用可能で、それぞれのフルネームとその略称を小文字で完全な **フォントベース名** " "にマッピングします。PyMuPDFでフォント名を提供する必要がある場合、辞書からの任意の **キーまたは値** を使用できます：" #: ../../app3.rst:105 a5f070fd9c6546bfa33ed69a6639683e msgid "" "In contrast to their obligation, not all PDF viewers support these fonts " "correctly and completely -- this is especially true for Symbol and " "ZapfDingbats. Also, the glyph (visual) images will be specific to every " "reader." msgstr "義務とは対照的に、すべてのPDFビューアがこれらのフォントを正確かつ完全にサポートしているわけではありません。特にSymbolとZapfDingbatsについては、これが特に当てはまります。また、グリフ（視覚的な）イメージは、それぞれの閲覧者に固有のものになります。" #: ../../app3.rst:107 6842b8433a9547b6a82435e36e06fb70 msgid "" "To see how these fonts can be used -- including the **CJK built-in** " "fonts -- look at the table in :meth:`Page.insert_font`." msgstr "" "これらのフォントがどのように使用されるか（ **CJK組み込みフォント** も含めて）、:meth:`Page.insert_font` " "のテーブルをご覧ください。" #: ../../app3.rst:114 e3268f776b5a4b06a629bf9f9c25828c msgid "Adobe PDF References" msgstr "Adobe PDFリファレンス" #: ../../app3.rst:116 17a3fab0bc0d4dcc9ab758228d6be220 msgid "" "This PDF Reference manual published by Adobe is frequently quoted " "throughout this documentation. It can be viewed and downloaded from " "`opensource.adobe.com `_." msgstr "" "Adobeによって公開されたこのPDFリファレンスマニュアルは、このドキュメンテーション全体で頻繁に引用されています。 `こちら " "`_ から閲覧およびダウンロードが可能です。" #: ../../app3.rst:125 c4f0367b9f574635971bdcbd0d2ca6fb msgid "Using Python Sequences as Arguments in PyMuPDF" msgstr "PythonシーケンスをPyMuPDFで引数として使用する場合" #: ../../app3.rst:126 3d89e490fbf7457284a6ae3fcc59d506 msgid "" "When PyMuPDF objects and methods require a Python **list** of numerical " "values, other Python **sequence types** are also allowed. Python classes " "are said to implement the **sequence protocol**, if they have a " "`__getitem__()` method." msgstr "" "PyMuPDFのオブジェクトとメソッドが数値の値のPython **リスト** を必要とする場合、他のPython **シーケンス型** " "も許可されています。Pythonのクラスは、`__getitem__()` メソッドを持つ場合、**シーケンスプロトコル** " "を実装していると言われています。" #: ../../app3.rst:128 bd7b31cc19e54f17857367f55587a14e msgid "" "This basically means, you can interchangeably use Python *list* or " "*tuple* or even *array.array*, *numpy.array* and *bytearray* types in " "these cases." msgstr "" "基本的には、これらの場合にPythonの *リスト* や *タプル* 、*array.array* 、*numpy.array* " "、*bytearray* 型を互換性を持って使用できることを意味しています。" #: ../../app3.rst:130 cc50a15ebc1a45c3ba30d1d2615eeb1b msgid "For example, specifying a sequence `\"s\"` in any of the following ways" msgstr "例えば、次のいずれかの方法でシーケンス `\"s\"` を指定すると" #: ../../app3.rst:132 ba9e965ec2384d4aaaacc84791926237 msgid "`s = [1, 2]` -- a list" msgstr "`s = [1, 2]` – リスト" #: ../../app3.rst:133 a1b8ab6b13fe41159b6b656dd7debae0 msgid "`s = (1, 2)` -- a tuple" msgstr "`s = (1, 2)` – タプル" #: ../../app3.rst:134 c68b9c09194b47c78b57fa6656c1ffea msgid "`s = array.array(\"i\", (1, 2))` -- an array.array" msgstr "`s = array.array(\"i\", (1, 2))` – array.array" #: ../../app3.rst:135 3a8427a9db4d4436a94ddb0536f292f1 msgid "`s = numpy.array((1, 2))` -- a numpy array" msgstr "`s = numpy.array((1, 2))` – numpy配列" #: ../../app3.rst:136 33fa18c1c81f441890f097d10863edf5 msgid "`s = bytearray((1, 2))` -- a bytearray" msgstr "`s = bytearray((1, 2))` – bytearray" #: ../../app3.rst:138 723f57c7a65942108b9add6c3d6123e3 msgid "will make it usable in the following example expressions:" msgstr "これによって、以下の例の式で使用可能になります：" #: ../../app3.rst:140 7e8310592817456db2c249694ee67e4c msgid "`pymupdf.Point(s)`" msgstr "" #: ../../app3.rst:141 ef9f88aff26342c1b8b682b45b03735a msgid "`pymupdf.Point(x, y) + s`" msgstr "" #: ../../app3.rst:142 0a05dd917a434de3b831f92af1f206d8 msgid "`doc.select(s)`" msgstr "" #: ../../app3.rst:144 e7823b7a8a1642dea3763c0d1fcf75df msgid "" "Similarly with all geometry objects :ref:`Rect`, :ref:`IRect`, " ":ref:`Matrix` and :ref:`Point`." msgstr "" "同様に、すべてのジオメトリオブジェクト :ref:`Rect` 、:ref:`IRect` 、:ref:`Matrix` 、 " ":ref:`Point` も同様です。" #: ../../app3.rst:146 e62989d3437d4c809e933779b0b4f916 msgid "" "Because all PyMuPDF geometry classes themselves are special cases of " "sequences, they (with the exception of :ref:`Quad` -- see below) can be " "freely used where numerical sequences can be used, e.g. as arguments for " "functions like *list()*, *tuple()*, *array.array()* or *numpy.array()*. " "Look at the following snippet to see this work." msgstr "" "なぜなら、すべてのPyMuPDFジオメトリクラス自体がシーケンスの特殊なケースであるため、（ :ref:`Quad` " "を除く）数値のシーケンスが使用可能な場所で自由に使用できるからです。例えば、 *list()* 、 *tuple()* 、 " "*array.array()* " #: ../../app3.rst:163 cd48dbd7918c44989e77808c4e3d2273 msgid "" ":ref:`Quad` is a Python sequence object as well and has a length of 4. " "Its items however are :data:`point_like` -- not numbers. Therefore, the " "above remarks do not apply." msgstr "" ":ref:`Quad` もPythonのシーケンスオブジェクトであり、長さが4です。ただし、そのアイテムは数値ではなく " ":data:`point_like` です。したがって、上記の注釈は適用されません。" #: ../../app3.rst:170 a239cac6134847fa88f5fdc763bc0034 msgid "Ensuring Consistency of Important Objects in PyMuPDF" msgstr "重要なオブジェクトの整合性を確保するためのPyMuPDF" #: ../../app3.rst:171 94db2c4ab30441ca82c022e184f57bf9 msgid "" "PyMuPDF is a Python binding for the C library MuPDF. While a lot of " "effort has been invested by MuPDF's creators to approximate some sort of " "an object-oriented behavior, they certainly could not overcome basic " "shortcomings of the C language in that respect." msgstr "PyMuPDFは、CライブラリMuPDFのPythonバインディングです。MuPDFの開発者たちは、ある種のオブジェクト指向の振る舞いを模倣するために多くの努力をしてきましたが、C言語の基本的な制約を克服することはできませんでした。" #: ../../app3.rst:173 7cf69b3e065341f0a20a77da785f6027 msgid "" "Python on the other hand implements the OO-model in a very clean way. The" " interface code between PyMuPDF and MuPDF consists of two basic files: " "*pymupdf.py* and *fitz_wrap.c*. They are created by the excellent SWIG " "tool for each new version." msgstr "" "一方で、Pythonは非常にクリーンな方法でOOモデルを実装しています。PyMuPDFとMuPDFの間のインターフェースコードは、基本的に2つのファイルから構成されています：" " *pymupdf.py* と *fitz_wrap.c* 。これらは、新バージョンごとに優れたSWIGツールによって作成されます。" #: ../../app3.rst:175 05bb51a7321b4ecd8dc9585c3e3f3b8c msgid "" "When you use one of PyMuPDF's objects or methods, this will result in " "execution of some code in *pymupdf.py*, which in turn will call some C " "code compiled with *fitz_wrap.c*." msgstr "" "PyMuPDFのオブジェクトやメソッドのいずれかを使用すると、これにより *pymupdf.py* でいくつかのコードが実行され、それがさらに " "*fitz_wrap.c* でコンパイルされたCコードを呼び出します。" #: ../../app3.rst:177 0d437950b2ba4e1cbdfd6ccd5a4b5f4b msgid "" "Because SWIG goes a long way to keep the Python and the C level in sync, " "everything works fine, if a certain set of rules is being strictly " "followed. For example: **never access** a :ref:`Page` object, after you " "have closed (or deleted or set to ``None``) the owning :ref:`Document`. " "Or, less obvious: **never access** a page or any of its children (links " "or annotations) after you have executed one of the document methods " "*select()*, *delete_page()*, *insert_page()* ... and more." msgstr "" "SWIGはPythonとCレベルを同期させるために大いに役立っているため、一定のルールが厳密に守られる限り、すべてが正常に動作します。例えば、所有している" " :ref:`ドキュメント` を閉じたり（または削除したり、Noneに設定したり）した後に :ref:`Page` オブジェクトに " "**アクセスしないでください** 。また、より明確な例では、 *select()* 、*delete_page()* 、 " "*insert_page()* などのドキュメントメソッドを実行した後にページやその子要素（リンクや注釈など）に **アクセスしないでください**" " 。" #: ../../app3.rst:179 740cda1605364f24b13938ce08977597 msgid "" "But just no longer accessing invalidated objects is actually not enough: " "They should rather be actively deleted entirely, to also free C-level " "resources (meaning allocated memory)." msgstr "ただし、無効なオブジェクトへのアクセスをやめるだけでは実際には十分ではありません。これらのオブジェクトは、Cレベルのリソース（割り当てられたメモリ）も解放するために、完全に削除されるべきです。" #: ../../app3.rst:181 9f8e966b70d34ecfabbaf171069a4cca msgid "" "The reason for these rules lies in the fact that there is a hierarchical " "2-level one-to-many relationship between a document and its pages and " "also between a page and its links / annotations. To maintain a consistent" " situation, any of the above actions must lead to a complete reset -- in " "**Python and, synchronously, in C**." msgstr "" "これらのルールの理由は、ドキュメントとそのページ、およびページとそのリンク/注釈の間に階層的な2段階の1対多の関係があるためです。一貫した状況を維持するために、上記のアクションのいずれもが" " **PythonとCの両方で** 完全なリセットを引き起こさなければなりません。" #: ../../app3.rst:183 a7f44e6e345e43358b3a79b7c052cd44 msgid "SWIG cannot know about this and consequently does not do it." msgstr "SWIGはこれを知ることはできないため、それを実行しません。" #: ../../app3.rst:185 9f2723ebd7904acaa02811c5490da7a1 msgid "" "The required logic has therefore been built into PyMuPDF itself in the " "following way." msgstr "必要な論理はしたがって、PyMuPDF自体に以下のように組み込まれています。" #: ../../app3.rst:187 fd908d3774f14df1b4fb95b1d9afb2f4 msgid "" "If a page \"loses\" its owning document or is being deleted itself, all " "of its currently existing annotations and links will be made unusable in " "Python, and their C-level counterparts will be deleted and deallocated." msgstr "ページが所有するドキュメントを失ったり、それ自体が削除されると、現在存在するすべての注釈とリンクはPythonで使用できなくなり、それらのCレベルの対応部分が削除されて解放されます。" #: ../../app3.rst:189 25e9288e71cb47e586bca43a0f860fb2 msgid "" "If a document is closed (or deleted or set to ``None``) or if its " "structure has changed, then similarly all currently existing pages and " "their children will be made unusable, and corresponding C-level deletions" " will take place. \"Structure changes\" include methods like *select()*, " "*delePage()*, *insert_page()*, *insert_pdf()* and so on: all of these " "will result in a cascade of object deletions." msgstr "" "ドキュメントが閉じられたり（または削除されたり、 ``None`` " "に設定されたり）したり、構造が変更されたりすると、同様に現在存在するすべてのページとその子要素は使用できなくなり、対応するCレベルの削除が行われます。「構造の変更」とは、" " *select()* 、 *delete_page()* 、 *insert_page()* 、 *insert_pdf()* " "などのメソッドを含みます。これらのすべてはオブジェクトの削除の連鎖を引き起こします。" #: ../../app3.rst:191 54df808609fb4f028e086d3d8e9d2f3b msgid "" "The programmer will normally not realize any of this. If he, however, " "tries to access invalidated objects, exceptions will be raised." msgstr "プログラマーは通常、これらのいずれも気づかないでしょう。ただし、無効なオブジェクトにアクセスしようとすると、例外が発生します。" #: ../../app3.rst:193 563eaa2415b64daabefd0a63dca2bd34 msgid "" "Invalidated objects cannot be directly deleted as with Python statements " "like *del page* or *page = None*, etc. Instead, their *__del__* method " "must be invoked." msgstr "" "無効なオブジェクトは、 *del page* または *page = None* " "などのPythonステートメントで直接削除することはできません。代わりに、その *__del__* メソッドを呼び出す必要があります。" #: ../../app3.rst:195 e5c1f65e4ac6489ca69e7ebe7b57195c msgid "" "All pages, links and annotations have the property *parent*, which points" " to the owning object. This is the property that can be checked on the " "application level: if *obj.parent == None* then the object's parent is " "gone, and any reference to its properties or methods will raise an " "exception informing about this \"orphaned\" state." msgstr "" "すべてのページ、リンク、注釈には、所有するオブジェクトを指す *親* " "プロパティがあります。これはアプリケーションレベルでチェックできるプロパティです： *obj.parent == None* " "ならば、そのオブジェクトの親は存在せず、そのプロパティやメソッドへの参照は例外を発生させてこの「孤立」した状態について通知します。" #: ../../app3.rst:197 d631125a6585402abe79abea78f9a828 msgid "A sample session:" msgstr "サンプルセッション：" #: ../../app3.rst:214 9f74080977604195aab03d9e5d402dd0 msgid "This shows the cascading effect:" msgstr "これは連鎖効果を示しています。" #: ../../app3.rst:231 2b8666687af94a81ad4c68af9a5f9e6b msgid "" "Objects outside the above relationship are not included in this " "mechanism. If you e.g. created a table of contents by *toc = " "doc.get_toc()*, and later close or change the document, then this cannot " "and does not change variable *toc* in any way. It is your responsibility " "to refresh such variables as required." msgstr "" "上記の関係外のオブジェクトは、このメカニズムに含まれていません。たとえば、 `toc = doc.get_toc()` " "のように目次を作成し、後で文書を閉じたり変更したりする場合、これは変数 toc " "をどのようにも変更しません。必要に応じてそのような変数を更新する責任はあなたにあります。" #: ../../app3.rst:238 d3876be10a3649c3b2ab6f5d57c69ce0 msgid "Design of Method :meth:`Page.show_pdf_page`" msgstr "メソッド :meth:`Page.show_pdf_page` の設計" #: ../../app3.rst:241 3180435e0924483181b1a26a8cba5f32 msgid "Purpose and Capabilities" msgstr "目的と機能" #: ../../app3.rst:243 bf37b033f7ca48c58de17d9d2051b74d msgid "" "The method displays an image of a (\"source\") page of another PDF " "document within a specified rectangle of the current (\"containing\", " "\"target\") page." msgstr "このメソッドは、現在の（「含まれる」、「ターゲット」）ページの指定された矩形内に別のPDF文書の（「ソース」）ページの画像を表示します。" #: ../../app3.rst:245 6f60a372555246208767f53ea2bfd820 msgid "" "**In contrast** to :meth:`Page.insert_image`, this display is vector-" "based and hence remains accurate across zooming levels." msgstr ":meth:`Page.insert_image` **とは異なり** 、この表示はベクターベースであり、ズームレベルを超えて正確に保たれます。" #: ../../app3.rst:246 998a98e328ec42aba32d728c2b4334e4 msgid "" "**Just like** :meth:`Page.insert_image`, the size of the display is " "adjusted to the given rectangle." msgstr ":meth:`Page.insert_image` **と同様に** 、表示のサイズは指定された矩形に調整されます。" #: ../../app3.rst:248 e75e8ccc88234308a5ec9fa48fa086f2 msgid "The following variations of the display are currently supported:" msgstr "現在、次のバリエーションの表示がサポートされています：" #: ../../app3.rst:250 d8cc5e5d21b84c21b682d4ab99c0d9df msgid "" "Bool parameter `\"keep_proportion\"` controls whether to maintain the " "aspect ratio (default) or not." msgstr "Bool パラメーター `\"keep_proportion\"` はアスペクト比を保持するかどうかを制御します（デフォルト）。" #: ../../app3.rst:251 186e450479084963890fe9da769fab60 msgid "" "Rectangle parameter `\"clip\"` restricts the visible part of the source " "page rectangle. Default is the full page." msgstr "矩形パラメーター `\"clip\"` はソースページの矩形の可視部分を制限します。デフォルトはフルページです。" #: ../../app3.rst:252 4f399ef693d44c11953293c07415b9ae msgid "" "float `\"rotation\"` rotates the display by an arbitrary angle (degrees)." " If the angle is not an integer multiple of 90, only 2 of the 4 corners " "may be positioned on the target border if also `\"keep_proportion\"` is " "true." msgstr "" "float `\"rotation\"` " "は表示を任意の角度（度）で回転させます。角度が90の倍数でない場合、`\"keep_proportion\"` も true " "の場合、ターゲットの境界に4つのうち2つのコーナーのみが配置される場合があります。" #: ../../app3.rst:253 64850af2d5454c3b8c0cc5f82512df49 msgid "" "Bool parameter `\"overlay\"` controls whether to put the image on top " "(foreground, default) of current page content or not (background)." msgstr "" "Bool パラメーター `\"overlay\"` " "は、画像を現在のページコンテンツの上（前景、デフォルト）に配置するか、そうでないか（背景）を制御します。" #: ../../app3.rst:255 7e80998882b74dbd8a0af43da85cb0d4 msgid "Use cases include (but are not limited to) the following:" msgstr "使用例は以下のようなものがありますが、これに限定されません：" #: ../../app3.rst:257 996173b99261405f88be22fdbd55394b msgid "" "\"Stamp\" a series of pages of the current document with the same image, " "like a company logo or a watermark." msgstr "現在の文書の複数のページに同じ画像（企業のロゴや透かし）を「スタンプ」する。" #: ../../app3.rst:258 1c47493c9a7d4b9f86bf2e065fad544e msgid "" "Combine arbitrary input pages into one output page to support “booklet” " "or double-sided printing (known as \"4-up\", \"n-up\")." msgstr "任意の入力ページを1つの出力ページに組み合わせ、\"ブックレット\"や両面印刷をサポートする（「4-up」、「n-up」としても知られています）。" #: ../../app3.rst:259 7e5cd1ef35154a02b0bee17ee2806729 msgid "" "Split up (large) input pages into several arbitrary pieces. This is also " "called “posterization”, because you e.g. can split an A4 page " "horizontally and vertically, print the 4 pieces enlarged to separate A4 " "pages, and end up with an A2 version of your original page." msgstr "（大きな）入力ページをいくつかの任意のピースに分割する。これは「ポスタリゼーション」とも呼ばれ、たとえばA4ページを水平および垂直に分割し、4つのピースを別々のA4ページに拡大印刷して、元のページのA2バージョンを作成することができます。" #: ../../app3.rst:262 b540c10d38674f279374416c7ec65281 msgid "Technical Implementation" msgstr "テクニカル実装" #: ../../app3.rst:264 69b731e1cb1b4b1f82341ad0baeff00b msgid "" "This is done using PDF **\"Form XObjects\"**, see section 8.10 on page " "217 of :ref:`AdobeManual`. On execution of a :meth:`Page.show_pdf_page`, " "the following things happen:" msgstr "" "これはPDF **「フォームXObject」** を使用して行われます。 :ref:`AdobeManual` リファレンス " "の217ページ、セクション8.10を参照してください。 :meth:`Page.show_pdf_page` " "が実行されると、次のことが起こります。" #: ../../app3.rst:266 50910b81c885485fadb624aecb9e1577 msgid "" "The :data:`resources` and :data:`contents` objects of source page in " "source document are copied over to the target document, jointly creating " "a new **Form XObject** with the following properties. The PDF " ":data:`xref` number of this object is returned by the method." msgstr "" "ソースドキュメント内のソースページの :data:`resources` と :data:`contents` " "オブジェクトは、ターゲットドキュメントにコピーされ、共同で新しい **フォームXObject** が作成されます。このオブジェクトのPDF " ":data:`xref` 番号がメソッドによって返されます。" #: ../../app3.rst:268 a1333276b2c34164b105e04d7d4d2515 msgid "`/BBox` equals `/Mediabox` of the source page" msgstr "`/BBox` はソースページの `/Mediabox` に等しいです。" #: ../../app3.rst:269 fbe66f56505f421dad721b5efa325673 msgid "`/Matrix` equals the identity matrix." msgstr "`/Matrix` は単位行列と等しいです。" #: ../../app3.rst:270 3a867e67f3d843608d9857ad1253fa34 msgid "" "`/Resources` equals that of the source page. This involves a “deep-copy” " "of hierarchically nested other objects (including fonts, images, etc.). " "The complexity involved here is covered by MuPDF's grafting [#f1]_ " "technique functions." msgstr "" "`/Resources` " "はソースページのものに等しいです。これには、階層的にネストされた他のオブジェクト（フォント、画像など）の「ディープコピー」が含まれます。ここでの複雑さは、MuPDFのグラフティング[1]技術関数によってカバーされています。" #: ../../app3.rst:271 1a49d5440ba142cf9172da9514e3c857 msgid "" "This is a stream object type, and its stream is an exact copy of the " "combined data of the source page's :data:`contents` objects." msgstr "" "これはストリームオブジェクトタイプであり、そのストリームはソースページの :data:`contents` " "オブジェクトの結合データの正確なコピーです。" #: ../../app3.rst:273 dd47a3e1e5374c23ae28df502b54d8a4 msgid "" "This Form XObject is only executed once per shown source page. Subsequent" " displays of the same source page will skip this step and only create " "\"pointer\" Form XObjects (done in next step) to this object." msgstr "このフォームXObjectは、表示されるソースページごとに1回だけ実行されます。同じソースページの後続の表示では、このステップはスキップされ、このオブジェクトへの「ポインター」フォームXObject（次のステップで行われる）のみが作成されます。" #: ../../app3.rst:275 42724012ec184801b99998826eed3a72 msgid "" "A second **Form XObject** is then created which the target page uses to " "invoke the display. This object has the following properties:" msgstr "" "次に、ターゲットページが表示を呼び出すために使用する2番目の **フォームXObject** " "が作成されます。このオブジェクトには次のような特性があります。" #: ../../app3.rst:277 e03b9eae952d4d1bb6e04da71d195465 msgid "`/BBox` equals the `/CropBox` of the source page (or `\"clip\"`)." msgstr "`/BBox` はソースページの `/CropBox`（または `\"クリップ\"` ）に等しいです。" #: ../../app3.rst:278 1749263652a44611a4af6fbe1690c814 msgid "`/Matrix` represents the mapping of `/BBox` to the target rectangle." msgstr "`/Matrix` は `/BBox` からターゲット矩形へのマッピングを表します。" #: ../../app3.rst:279 4fb0197364cf4a88b015f8fa5d6d6ff2 msgid "" "`/XObject` references the previous Form XObject via the fixed name " "`fullpage`." msgstr "`/XObject` は、以前のフォームXObjectを固定された名前 `fullpage` を介して参照します。" #: ../../app3.rst:280 a3736f591c254b8a801d28e108cec9a8 msgid "" "The stream of this object contains exactly one fixed statement: " "`/fullpage Do`." msgstr "このオブジェクトのストリームには、正確に1つの固定されたステートメントが含まれています： `/fullpage Do` 。" #: ../../app3.rst:281 5d63f1c31a56424b8903208d2ac3af39 msgid "" "If the method's `\"oc\"` argument is given, its value is assigned to this" " Form XObject as `/OC`." msgstr "メソッドの `「oc」` 引数が指定された場合、その値はこのフォームXObjectに `/OC` として割り当てられます。" #: ../../app3.rst:283 e5c4f530e1134086bac2da1f45b4d894 msgid "" "The :data:`resources` and :data:`contents` objects of the target page are" " now modified as follows." msgstr "ターゲットページの :data:`リソース` と :data:`コンテンツ` オブジェクトは以下のように変更されます。" #: ../../app3.rst:285 d81644bc7b114307a984f10eed9801e7 msgid "" "Add an entry to the `/XObject` dictionary of `/Resources` with the name " "`fzFrm` (with n chosen such that this entry is unique on the page)." msgstr "" "`/Resources` の `/XObject` 辞書に、 ` fzFrm ` " "という名前のエントリをページ内で一意であるように追加します（nはこのエントリがページで一意であるように選択されます）。" #: ../../app3.rst:286 ff1f4fdf2e59413da229698f3921b8d0 msgid "" "Depending on `\"overlay\"`, prepend or append a new object to the page's " "`/Contents` array, containing the statement `q /fzFrm Do Q`." msgstr "" "`\"overlay\"` に応じて、ページの `/ Contents` 配列に新しいオブジェクトを前または後に追加し、ステートメント `q / " "fzFrm Do Q` を含めます。" #: ../../app3.rst:288 01882ae84bb54534ba3c6ab5ca61b114 msgid "This design approach ensures that:" msgstr "この設計アプローチは次を保証します：" #: ../../app3.rst:290 b9976fb7daeb4b6291c769ba97d9ac06 msgid "" "The (potentially large) source page is only copied once to the target " "PDF. Only small \"pointer\" Form XObjects objects are created per each " "target page to show the source page." msgstr "（潜在的に大きな）ソースページは、ターゲットPDFに1度だけコピーされます。各ターゲットページごとに、ソースページを表示するための小さな「ポインター」フォームXObjectオブジェクトが作成されます。" #: ../../app3.rst:291 521ab75e321e488ca9676c4ce898d1b3 msgid "" "Each referring target page can have its own `\"oc\"` parameter to control" " the source page's visibility individually." msgstr "参照する各ターゲットページは、ソースページの表示を個別に制御するための独自の `「oc」` パラメータを持つことができます。" #: ../../app3.rst:298 05bf5b83ea6142389d3172a05aa36f27 msgid "Diagnostics" msgstr "" #: ../../app3.rst:303 b856bdfa521a4448b19dc8a507f2c401 msgid "|PyMuPDF| messages" msgstr "" #: ../../app3.rst:305 85b5e6f89d3649809ada540c8eea82a1 msgid "|PyMuPDF| has a Message system for showing text diagnostics." msgstr "" #: ../../app3.rst:307 4c84b6f861ea48f3a8e09715aebfc6d9 msgid "" "By default messages are written to `sys.stdout`. This can be controlled " "in two ways:" msgstr "" #: ../../app3.rst:311 74ccaa7010d84feaaff8d9a38c69b5f1 msgid "Set environment variable `PYMUPDF_MESSAGE` before |PyMuPDF| is imported." msgstr "" #: ../../app3.rst:314 2f88318d369944be868c62a39006cca7 msgid "Call `set_messages()`:" msgstr "" #: ../../app3.rst:318 e5c533c2a71c4b608f529bfb4df7afb2 msgid "|MuPDF| errors and warnings" msgstr "" #: ../../app3.rst:320 1523d23bbbce45f1a25c851f5b69abf0 msgid "|MuPDF| generates text errors and warnings." msgstr "" #: ../../app3.rst:323 adb68bfb91384894b21b746a73dd6bc0 msgid "" "These errors and warnings are appended to an internal list, accessible " "with `Tools.mupdf_warnings()`. Also see `Tools.reset_mupdf_warnings()`." msgstr "" #: ../../app3.rst:327 79324fa6e32d42af95e9abf26233099a msgid "" "By default these errors and warnings are also sent to the |PyMuPDF| " "message system." msgstr "" #: ../../app3.rst:330 a71ef1ec2b084888adf04787091192a1 msgid "" "This can be controlled with `mupdf_display_errors()` and " "`mupdf_display_warnings()`." msgstr "" #: ../../app3.rst:334 83b10651533947bc9bd63e655367d81e msgid "" "These messages are prefixed with `MuPDF error:` and `MuPDF warning:` " "respectively." msgstr "" #: ../../app3.rst:337 943f00a7c2a849f483525f7b3653f6a0 msgid "Some |MuPDF| errors may lead to Python exceptions." msgstr "" #: ../../app3.rst:339 0cdf1f5474fa4616a11df5f246a531a1 msgid "" "Example output for a **recoverable error**. We are opening a damaged PDF," " but MuPDF is able to repair it and gives us a little information on what" " happened. Then we illustrate how to find out whether the document can " "later be saved incrementally. Checking the :attr:`Document.is_dirty` " "attribute at this point also indicates that during `pymupdf.open` the " "document had to be repaired:" msgstr "" #: ../../app3.rst:360 af0558fd6f8c4501a41d850a84d3da7b msgid "Example output for an **unrecoverable error**:" msgstr "" #: ../../app3.rst:378 01987f6b7c4e4b13a325bf16dc6d2fda msgid "Coordinates" msgstr "脚注" #: ../../app3.rst:381 cc111c4761774e13839c570b6a760b94 msgid "" "This is one of the most frequently used terms in this documentation. A " "**coordinate** generally means a pair of numbers `(x, y)` referring to " "some location, like a corner of a rectangle (:ref:`Rect`), a :ref:`Point`" " and so forth. The two values usually are floats, but there a objects " "like images which only allow them to be integers." msgstr "" #: ../../app3.rst:383 8e23a5ba1da047d88532eda8f671451a msgid "" "To actually *find* a coordinate's location, we also need to know the " "*reference* point for ``x`` and ``y`` - in other words, we must know " "where location `(0, 0)` is positioned. Once `(0, 0)` (the \"origin\") is " "known, we speak of a \"coordinate system\"." msgstr "" #: ../../app3.rst:385 5720add281a54277b7a0232978fa8662 msgid "" "Several coordinate systems exist in document processing. For instance, " "the coordinate systems of a PDF page and the image created from it are " "**different**. We therefore need ways to *transform* coordinates from one" " system to another (and also back occasionally). This is the task of a " ":ref:`Matrix`. It is a mathematical function which works much like a " "factor that can be \"multiplied\" with a point or rectangle to give us " "the corresponding point / rectangle in another coordinate system. The " "inverse of a transformation matrix can be used to revert the " "transformation. Much like multiplying by some factor, say 3, can be " "reverted by dividing the result by 3 (or multiplying it with 1/3)." msgstr "" #: ../../app3.rst:388 9bd43359dae34a3db3ed2502539abb9f msgid "Coordinates and Images" msgstr "" #: ../../app3.rst:390 ef142876a50648b88ce6825a05daf149 msgid "" "Images have a coordinate system with integer coordinates. Origin `(0, 0)`" " is the top-left point. ``x`` values must be in `range(width)`, and ``y``" " values in `range(height)`. Therefore, ``y`` values *increase* if we go " "*downwards*. For every image, there is only a **finite number** of " "coordinates, namely `width * height`. A location in an image is also " "called a \"pixel\"." msgstr "" #: ../../app3.rst:392 a43cf286a2d14b4892269df18f857b1b msgid "" "How **large** an image will be (in centimeters or inches) when e.g. " "printed, depends on additional information: the \"resolution\". This is " "measured in **DPI** (dots per inch, or pixels per inch). To find the " "printed size of some image, we therefore must divide its width and its " "height by the corresponding DPI values (there may separate ones for width" " and for height) and will get the respective number of inches." msgstr "" #: ../../app3.rst:396 b694fe03ac784433945a778cd53034f2 msgid "Origin Point, Point Size and Y-Axis" msgstr "" #: ../../app3.rst:398 a92885d699744510b39176e360fb8a63 msgid "" "In |PDF|, the origin `(0, 0)` of a page is located at its **bottom-left " "point**. In |MuPDF|, the origin `(0, 0)` of a page is located at its " "**top-left point**." msgstr "" #: ../../app3.rst:403 b0a22dfe25a8493dbcd9b65008507920 msgid "Coordinates are float numbers and measured in **points**, where:" msgstr "" #: ../../app3.rst:405 68d51777bcaf4642b1031f9dc960cd29 msgid "**one point equals 1/72 inches**." msgstr "" #: ../../app3.rst:407 756d6701c9f747b9830a3c7d01111f53 msgid "" "Typical document page sizes are **ISO A4** and **Letter**. A **Letter** " "page has a size of **8.5 x 11 inches**, corresponding to **612 x 792 " "points**. In the |PDF| coordinate system, the top-left point of a " "**Letter** page hence has the coordinate `(0, 792)` as **the y-axis " "points upwards**. Now we know our document size the |MuPDF| coordinate " "system for the bottom right would be coordinate `(612, 792)` (and for " "|PDF| this coordinate would then be `(612,0)`)." msgstr "" #: ../../app3.rst:409 50dac25ebb9848779eb3bff43cb168dc msgid "" "Theoretically, there are **infinitely many** coordinate positions on a " "|PDF| page. In practice however, at most the first 5 decimal places are " "sufficient for a reasonable precision." msgstr "" #: ../../app3.rst:412 e630dd4abdb84c43b0315dfb4e77cef8 msgid "" "In |MuPDF|, multiple document formats are supported - |PDF| just being " "one among **over a dozen others**. Images are also supported as documents" " in |MuPDF| (therefore having one page usually). This is one of the " "reasons why |MuPDF| uses a coordinate system with the origin `(0, 0)` " "being the **top-left** point of any document page. **The y-axis points " "downwards**, like with images. Coordinates in |MuPDF| in any case are " "floats, like in |PDF|." msgstr "" #: ../../app3.rst:414 a69f66be61c5411c909b4daed6378f6c msgid "" "A rectangle `Rect(0, 0, 100, 100)` for instance in |MuPDF| (and thus " "|PyMuPDF|) therefore is a square with edges of length 100 points (= 1.39 " "inches or 3.53 centimeters). Its top-left corner is the origin. To switch" " between the two coordinate systems |PDF| to |MuPDF|, every :ref:`Page` " "object has a :attr:`Page.transformation_matrix`. Its inverse can be used " "to compute a rectangle's PDF coordinates. In this way we can conveniently" " find that `Rect(0, 0, 100, 100)` in |MuPDF| is the same as `Rect(0, 692," " 100, 792)` in |PDF|. See this code snippet::" msgstr "" #: ../../app3.rst:425 0358a41bcfde49298c244a781732a9cc msgid "Footnotes" msgstr "脚注" #: ../../app3.rst:426 2a940ba3cc664855b3afbb56eaefdade msgid "" "MuPDF supports \"deep-copying\" objects between PDF documents. To avoid " "duplicate data in the target, it uses so-called \"graftmaps\", like a " "form of scratchpad: for each object to be copied, its :data:`xref` number" " is looked up in the graftmap. If found, copying is skipped. Otherwise, " "the new :data:`xref` is recorded and the copy takes place. PyMuPDF makes " "use of this technique in two places so far: :meth:`Document.insert_pdf` " "and :meth:`Page.show_pdf_page`. This process is fast and very efficient, " "because it prevents multiple copies of typically large and frequently " "referenced data, like images and fonts. However, you may still want to " "consider using garbage collection (option 4) in any of the following " "cases:" msgstr "" "MuPDFはPDFドキュメント間でオブジェクトを「ディープコピー」することをサポートしています。対象の中で重複するデータを避けるために、「グラフトマップ」と呼ばれる仕組みを使用します。これはスクラッチパッドのようなもので、コピーされる各オブジェクトについて、その" " :data:`xref` 番号をグラフトマップで調べます。もし見つかれば、コピーはスキップされます。それ以外の場合は、新しい " ":data:`xref` が記録され、コピーが行われます。PyMuPDFは、:meth:`Document.insert_pdf` と " ":meth:`Page.show_pdf_page` " "の2つの場所でこの技術を使用しています。このプロセスは高速で非常に効率的です。なぜなら、通常大きなデータや頻繁に参照されるデータ（画像やフォントなど）の複数のコピーを防ぐためです。ただし、次のいずれかの場合にはガベージコレクション（オプション4）の使用を検討することをお勧めします：" #: ../../app3.rst:428 12291c684340429ebe3dfc12d79126a2 msgid "" "The target PDF is not new / empty: grafting does not check for resources " "that already existed (e.g. images, fonts) in the target document before " "opening it." msgstr "対象のPDFが新しい/空でない場合：グラフティングは、対象ドキュメント内で既に存在しているリソース（例：画像、フォント）をチェックしません。" #: ../../app3.rst:429 85b00d1ae84a4e159e1accdfa5034bdc msgid "" "Using :meth:`Page.show_pdf_page` for more than one source document: each " "grafting occurs **within one source** PDF only, not across multiple. So " "if e.g. the same image exists in pages from different source PDFs, then " "this will not be detected until garbage collection." msgstr "" "複数のソースドキュメントで :meth:`Page.show_pdf_page` を使用する場合：グラフティングは **1つのソース** " "PDF内でのみ発生し、複数のソースPDF間では発生しません。したがって、同じ画像が異なるソースPDFのページに存在する場合、これはガベージコレクションまで検出されません" #: ../../footer.rst:46 2a972e62f98f45208da9b9eaf1158726 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Redirecting Error and Warning Messages" #~ msgstr "エラーと警告メッセージのリダイレクト" #~ msgid "" #~ "Since MuPDF version 1.16 error and " #~ "warning messages can be redirected via" #~ " an official plugin." #~ msgstr "MuPDFバージョン1.16以降、エラーと警告メッセージは公式プラグインを介してリダイレクトできます。" #~ msgid "" #~ "PyMuPDF will put error messages to " #~ "`sys.stderr` prefixed with the string " #~ "\"mupdf:\". Warnings are internally stored " #~ "and can be accessed via " #~ "*pymupdf.TOOLS.mupdf_warnings()*. There also is " #~ "a function to empty this store." #~ msgstr "" #~ "PyMuPDFはエラーメッセージを、先頭に文字列「mupdf:」を付けて `sys.stderr` " #~ "に表示します。警告は内部で保存され、*pymupdf.TOOLS.mupdf_warnings()* " #~ "を通じてアクセスできます。また、この保存領域を空にするための関数も存在します。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "For a long time, an older version" #~ " was also available under `this " #~ "`_" #~ " link. It seems to be taken off" #~ " of the web site in October " #~ "2021. Earlier (pre 1.19.*) versions of" #~ " the PyMuPDF documentation used to " #~ "refer to this document. We have " #~ "undertaken an effort to replace " #~ "referrals to the current specification " #~ "above." #~ msgstr "" #~ "長い間、古いバージョンも `この " #~ "`_" #~ " " #~ "リンクで利用可能でしたが、2021年10月にウェブサイトから取り下げられたようです。以前（1.19.*より前）のPyMuPDFドキュメンテーションはこの文書を参照していました。私たちは、上記の現行仕様への参照を置き換える取り組みを行っています。" #~ msgid "MuPDF errors and warnings" #~ msgstr "" #~ msgid "MuPDF generates text errors and warnings." #~ msgstr "" #~ msgid "Some MuPDF errors may lead to Python exceptions." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/app4.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 613ca8dee3af4e18aee8824f32d62bd7 msgid "Artifex" msgstr "" #: ../../header.rst:-1 3fb1879bb92640d0b871ed41914b2b0d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 5800ad4c0c8f4aea8589a92458f2afe9 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../app4.rst:14 452ac8cb00694e9abeae5f9e25ddebf6 msgid "Appendix 4: Performance Comparison Methodology" msgstr "付録4：性能比較方法" #: ../../app4.rst:16 14ceae9e1c7f4b8f8a0319fbb991a23c msgid "" "This article documents the approach to measure :title:`PyMuPDF's` " "performance and the tools and example files used to do comparisons." msgstr "この記事では、|PyMuPDF| の性能を測定するアプローチと、比較を行うために使用されるツールとサンプルファイルについて説明します。" #: ../../app4.rst:18 707cf837e27a4490be01f4ff59f3d6e7 msgid "The following three sections deal with different performance aspects:" msgstr "以下の3つのセクションでは、異なる性能の側面に取り組んでいます：" #: ../../app4.rst:20 19bf7499dda54ae094b5f694a8ea950f msgid "" ":ref:`Document Copying` - This includes opening and parsing" " :title:`PDFs`, then writing them to an output file. Because the same " "basic activities are also used for joining (merging) :title:`PDFs`, the " "results also apply to these use cases." msgstr "" ":ref:`ドキュメントのコピー` - これには |PDF| " "ファイルの開閉と解析、そしてそれらを出力ファイルに書き込む作業が含まれます。同じ基本的なアクティビティは、|PDF| " "ファイルの結合（マージ）にも使用されるため、結果はこれらのユースケースにも適用されます。" #: ../../app4.rst:21 8902b7d3bdf44cdeb0a02ebaeb788364 msgid "" ":ref:`Text Extraction` - This extracts plain text " "from :title:`PDFs` and writes it to an output text file." msgstr "" ":ref:`テキスト抽出` - これにより |PDF| " "ファイルから平文テキストが抽出され、テキストファイルに書き込まれます。" #: ../../app4.rst:22 c9e28e548b684c15b6fc6c839fb268d0 msgid "" ":ref:`Page Rendering` - This converts |PDF| pages to" " image files looking identical to the pages. This ability is the basic " "prerequisite for using a tool in :title:`Python GUI` scripts to scroll " "through documents. We have chosen a medium-quality (resolution 150 DPI) " "version." msgstr "" ":ref:`ページレンダリング` - " "これによりPDFページがページと同じような見た目の画像ファイルに変換されます。この機能は、:title:`Python GUI` " "スクリプトでドキュメントをスクロールするための基本的な前提条件です。中画質版（解像度150 DPI）を選択しました。" #: ../../app4.rst:24 d8c56f0cbbb4415497587ade558105c9 msgid "" "Please note that in all cases the actual speed in dealing with |PDF| " "structures is not directly measured: instead, the timings also include " "the durations of writing files to the operating system's file system. " "This cannot be avoided because tools other than |PyMuPDF| do not offer " "the option to e.g., separate the image **creation** step from the " "following step, which **writes** the image into a file." msgstr "" "|PDF| " "構造の処理速度そのものを直接測定するのではなく、すべての場合において、タイミングにはファイルをオペレーティングシステムのファイルシステムに書き込む時間も含まれることに注意してください。これは回避できない要因です。なぜなら、|PyMuPDF|" " 以外のツールでは、例えばイメージの **作成** ステップと、イメージをファイルに **書き込む** " "後続のステップを分離するオプションが提供されていないためです。" #: ../../app4.rst:26 c95dca0ce6a24b9cbb4e54005da736be msgid "" "So all timings documented include a common, OS-oriented base effort. " "Therefore, performance **differences per tool are actually larger** than " "the numbers suggest." msgstr "" "したがって、すべての記録されたタイミングには共通のOS指向の基本的な努力が含まれています。したがって、**ツールごとの性能の違いは、数字が示す以上に実際には大きいです**" " 。" #: ../../app4.rst:33 5c8d1822086844e0b5b6e63e24468509 msgid "Files used" msgstr "使用されるファイル" #: ../../app4.rst:35 2439752153d84180a23a0e99527d8073 msgid "" "A set of eight files is used for the performance testing. With each file " "we have the following information:" msgstr "性能テストには、8つのファイルセットが使用されます。各ファイルには、次の情報があります：" #: ../../app4.rst:37 b31835ad665241aebc8bce9496462a0b msgid "**Name** of the file and download **link**." msgstr "ファイル **名** とダウンロード **リンク**。" #: ../../app4.rst:38 01b0b7ddaf6342b6acea40fc10548232 msgid "**Size** in bytes." msgstr "バイト単位の **サイズ**。" #: ../../app4.rst:39 5cefe438dda843c68dd254d3911dbf09 msgid "Total number of **pages** in file." msgstr "ファイル内の総 **ページ** 数。" #: ../../app4.rst:40 245d148da06d4becad20aec51e1fd3bf msgid "Total number of bookmarks (**Table of Contents** entries)." msgstr "ブックマーク（ **目次** エントリー）の総数。" #: ../../app4.rst:41 ff1a2993e3254f7686a848f577c48582 msgid "Total number of **links**." msgstr "**リンク** の総数。" #: ../../app4.rst:42 fb20f6986d82495e9890d8753eb1f276 msgid "**KB size** per page." msgstr "ページごとの **KBサイズ** 。" #: ../../app4.rst:43 1224aaf0dfde40e1a5c3bc91ef4011ff msgid "" "**Textsize per page** is the amount text in the whole file in KB, divided" " by the number of pages." msgstr "**ページごとのテキストサイズ** は、ファイル全体のテキスト量をKBで割ったものです。" #: ../../app4.rst:44 8ceb2129883142a09c9d4d383789ed99 msgid "Any **notes** to generally describe the type of file." msgstr "ファイルのタイプを一般的に説明するための **メモ** 。" #: ../../app4.rst:50 ../../app4.rst:217 ../../app4.rst:295 ../../app4.rst:407 #: 1b162242a4a54f7dafcae32349b4ed33 930f7531af8b4c2db858b7c3c63f1c57 #: b459ef8255c34d8bb8f10527b5b13ae0 dd23f2e000014a6ebfbb0df71f4f4550 msgid "**Name**" msgstr "**ファイル名** " #: ../../app4.rst:51 651fc5cd40134ce993378901eaed782d msgid "**Size (bytes)**" msgstr "**サイズ（バイト）** " #: ../../app4.rst:52 830651a701b543dd92495f528872e442 msgid "**Pages**" msgstr "**ページ数** " #: ../../app4.rst:53 ad04afd00ac744a8b7c099d48dcdc0c3 msgid "**TOC size**" msgstr "**目次サイズ** " #: ../../app4.rst:54 4286cb4118494c3c97aa7190ce52bbe1 msgid "**Links**" msgstr "**リンク数** " #: ../../app4.rst:55 dfccc56073594677aaaf87774c57e911 msgid "**KB/page**" msgstr "**KB/ページ** " #: ../../app4.rst:56 85615f3120044a3d8f55f0e03fbe8400 msgid "**Textsize/page**" msgstr "**テキストサイズ/ページ** " #: ../../app4.rst:57 2ed30a8ee08e4381913a180905dc4905 msgid "**Notes**" msgstr "**メモ** " #: ../../app4.rst:58 81403b323ce2471990b6addcb9d327ed msgid "`adobe.pdf`" msgstr "" #: ../../app4.rst:59 6dfced8745d04f139c2262964b78cc6c msgid "32,472,771" msgstr "" #: ../../app4.rst:60 fe260ad1414a49ad820440768eed3e3d msgid "1,310" msgstr "" #: ../../app4.rst:61 aecc68ede79f49e7a2f4965c4d6d21fb msgid "794" msgstr "" #: ../../app4.rst:62 19f68930d6b342c8b63282aacdda31ba msgid "32,096" msgstr "" #: ../../app4.rst:63 3db3ea234e5e4dbfb2cb18370be6526b msgid "24" msgstr "" #: ../../app4.rst:64 df9644ba42384b7f8df8f1a7f9ac9ca6 msgid "1,942" msgstr "" #: ../../app4.rst:65 9a0b2a88e8d14cbbaa5e220051bc2cbc msgid "linearized, many links / bookmarks" msgstr "線形化、多くのリンク/ブックマーク" #: ../../app4.rst:66 b450a19150554327a540a48702926bd8 msgid "`artifex-website.pdf`" msgstr "" #: ../../app4.rst:67 f76c22107d8e466e9e9b938d6d2a0c78 msgid "31,570,732" msgstr "" #: ../../app4.rst:68 121ca9cb77a44f18ae707dc1f62b6828 msgid "47" msgstr "" #: ../../app4.rst:69 74407cbb0f3b41c8b248f809abe4cf58 msgid "46" msgstr "" #: ../../app4.rst:70 5a5a12aa804e4285b2c10f71c7b91631 msgid "2,035" msgstr "" #: ../../app4.rst:71 24d74ed3a9814878b5faa590d81e830c msgid "656" msgstr "" #: ../../app4.rst:72 7f66bf0a79ca4e199dd2d27aea8b4e85 msgid "3,538" msgstr "" #: ../../app4.rst:73 d9c710117eb44abca3a888f45c5f6927 msgid "graphics oriented" msgstr "グラフィックス志向" #: ../../app4.rst:74 49bc871f44cb4ddbb8d76e2d42b3155b msgid "`db-systems.pdf`" msgstr "" #: ../../app4.rst:75 1a5f0c78435c4c6389a2acd6bd91cd28 msgid "29,326,355" msgstr "" #: ../../app4.rst:76 f88d9c860ac246f49fdafd12ed4cc62e msgid "1,241" msgstr "" #: ../../app4.rst:77 ../../app4.rst:78 ../../app4.rst:117 ../../app4.rst:118 #: 35384af101fd403ca7b83c7bf3616f8c 48b4936078bd42bab97c666b770093d6 #: 95853467cdac44e5905fa2aa5f876d2d d6739a13778847ea9c11a2c7b08bc8e0 msgid "0" msgstr "" #: ../../app4.rst:79 d215b500b52e41cc99c84f24fe3890ec msgid "23" msgstr "" #: ../../app4.rst:80 a267452974d549de8748e729075a7ac7 msgid "2,142" msgstr "" #: ../../app4.rst:82 739b78ec9dc84e99917248ee3622b3b2 msgid "`fontforge.pdf`" msgstr "" #: ../../app4.rst:83 25bd9632f03d4b2293dc4c8a076d05fa msgid "8,222,384" msgstr "" #: ../../app4.rst:84 b567e447fe8f4e0490f62422a2d9d569 msgid "214" msgstr "" #: ../../app4.rst:85 75588fdd5beb42a78773ef5340ecc1b6 msgid "31" msgstr "" #: ../../app4.rst:86 0c2001d30c0f4f07963b9f2e38b0f614 msgid "242" msgstr "" #: ../../app4.rst:87 d6c479c026b5484881aa9197ffc88c6a msgid "38" msgstr "" #: ../../app4.rst:88 b9139930537345d284aa9a31220d74c6 msgid "1,058" msgstr "" #: ../../app4.rst:89 710514866ee04905bf3be46a44b683bf msgid "mix of text & graphics" msgstr "テキストとグラフィックスのミックス" #: ../../app4.rst:90 c8a1f504fd3746ba9397d4e3d6b274a6 msgid "`pandas.pdf`" msgstr "" #: ../../app4.rst:91 8642835dbf5d4db99a8c4fbca766a571 msgid "10,585,962" msgstr "" #: ../../app4.rst:92 7b996090e65044c584d83ea7acda42f0 msgid "3,071" msgstr "" #: ../../app4.rst:93 ff6fdff8d91a417583e2686c79665e97 msgid "536" msgstr "" #: ../../app4.rst:94 6916626a7d824adfb4b1475a9d0f3eff msgid "16,554" msgstr "" #: ../../app4.rst:95 bc0f680837344f68abbb708440827a84 msgid "3" msgstr "" #: ../../app4.rst:96 bba11b24685d4d8c94deaa5e074e4bcb msgid "1,539" msgstr "" #: ../../app4.rst:97 40e65f53ef05490796b7a4aec9577410 msgid "many pages" msgstr "多くのページ" #: ../../app4.rst:98 e798c081493c4df095c56e07a50ca1b9 msgid "`pymupdf.pdf`" msgstr "" #: ../../app4.rst:99 9648e1df46804af395045a08a83de9fe msgid "6,805,176" msgstr "" #: ../../app4.rst:100 7f91a57f8a7847b4bd037094e00faa9a msgid "478" msgstr "" #: ../../app4.rst:101 226cdbfe630949eab54a52805869a6e7 msgid "276" msgstr "" #: ../../app4.rst:102 f30b492e535c41748786f54e00e90cb8 msgid "5,277" msgstr "" #: ../../app4.rst:103 2701b877b410466cb1ae77dd1a2a1e90 msgid "14" msgstr "" #: ../../app4.rst:104 bcc9d1ef612c4e95b015b553232ad25a msgid "1,937" msgstr "" #: ../../app4.rst:105 befe3de8428943f2b55fa3759ae8cbd0 msgid "text oriented" msgstr "テキスト志向" #: ../../app4.rst:106 1fde26c15a56401eb49e5db71f99cc25 msgid "`pythonbook.pdf`" msgstr "" #: ../../app4.rst:107 abde300eb8244d23875981f20afdf6ce msgid "9,983,856" msgstr "" #: ../../app4.rst:108 f236fb08a1834afeae13579d512733ba msgid "669" msgstr "" #: ../../app4.rst:109 d7c1691699514ea893a728c74016301d msgid "198" msgstr "" #: ../../app4.rst:110 4af5202a95164d698a13772fb60448a8 msgid "1,953" msgstr "" #: ../../app4.rst:111 b4141c07d695403e87cedbe5de5863dd msgid "15" msgstr "" #: ../../app4.rst:112 72ae61bf2a1b4a52904b806afc0ff6f5 msgid "1,929" msgstr "" #: ../../app4.rst:114 bb501706366848629a8491cb70e58ec9 msgid "`sample-50-MB-pdf-file.pdf`" msgstr "" #: ../../app4.rst:115 542f200f9bbd48719bb31d4cf6850f3b msgid "52,521,850" msgstr "" #: ../../app4.rst:116 d0db6531af4e488ca48300bebf47246e msgid "1" msgstr "" #: ../../app4.rst:119 b80b76ee70584a34977f50acbea06df8 msgid "51,291" msgstr "" #: ../../app4.rst:120 52119106cfb04a489c5842fab93cd2c5 msgid "23,860" msgstr "" #: ../../app4.rst:121 513e58b0ccf547edaf2e1b8d4fc09391 msgid "single page, graphics oriented, large file size" msgstr "単一ページ、グラフィックス志向、大きなファイルサイズ" #: ../../app4.rst:127 b1d1466a4d4f46ee97f9c0c14866930d msgid "" "**adobe.pdf** and **pymupdf.pdf** are clearly text oriented, **artifex-" "website.pdf** and **sample-50-MB-pdf-file.pdf** are graphics oriented. " "Other files are a mix of both." msgstr "" "**adobe.pdf** と **pymupdf.pdf** は明らかにテキスト志向です。 **artifex-website.pdf** と " "**sample-50-MB-pdf-file.pdf** はグラフィックス志向です。その他のファイルは両方のミックスです。" #: ../../app4.rst:131 a46db6b46cbd476c9aa08e828b1899a9 msgid "Tools used" msgstr "使用されるツール" #: ../../app4.rst:133 eff071706abe45db98dc970ba599955e msgid "" "In each section, the same fixed set of |PDF| files is being processed by " "a set of tools. The set of tools used per performance aspect however " "varies, depending on the supported tool features." msgstr "" "各セクションでは、同じ固定されたセットの |PDF| " "ファイルが一連のツールによって処理されます。ただし、性能の側面ごとに使用されるツールのセットは、サポートされるツールの機能に応じて異なります。" #: ../../app4.rst:135 e7ff37e32cbd4cdc993c645e7658d227 msgid "" "All tools are either platform independent, or at least can run on both, " ":title:`Windows` and :title:`Unix` / :title:`Linux`." msgstr "" "すべてのツールは、プラットフォームに依存しないか、少なくとも :title:`Windows` と :title:`Unix` / " ":title:`Linux` の両方で実行できます。" #: ../../app4.rst:141 7507beef7859479e94a8fa9cce614373 msgid "**Tool**" msgstr "ツール" #: ../../app4.rst:142 7e5c5082ee244cc1850b389fa76d162b msgid "**Description**" msgstr "説明" #: ../../app4.rst:143 ../../app4.rst:172 ../../app4.rst:218 ../../app4.rst:296 #: ../../app4.rst:368 ../../app4.rst:408 51f2639233354454a2be6c8cf943caae #: 75b83e125f444081ac46f5b513ffb434 78511b7a3ae24d7ba242cb9f012c945c #: cf82339face445409b1cb2230b1cf737 e2f4e337aa6f46ff9d1a57a84bd40231 #: ea0496359fd4419f88ac295b9d5a7c35 msgid "|PyMuPDF|" msgstr "" #: ../../app4.rst:144 265dd2b9a51a4748ae710d0a7781b16c msgid "The tool of this manual." msgstr "このマニュアルのツールです。" #: ../../app4.rst:145 0d7018f04c2d4b8b91e09d879a94c489 msgid "PDFrw_" msgstr "" #: ../../app4.rst:146 1871dfbb59ed44559c1143b8f664ab3b msgid "" "A pure :title:`Python` tool, being used by :title:`rst2pdf`, has " "interface to :title:`ReportLab`." msgstr "" ":title:`rst2pdf` で使用される純粋な :title:`Python` " "ツールで、ReportLabとのインターフェースを持っています。" #: ../../app4.rst:147 db3dc67db0384a4caf25ec3159cc9e8c msgid "PyPDF2_" msgstr "" #: ../../app4.rst:148 f00f0472c11846dd8a6d1cb0ac0237bf msgid "A pure :title:`Python` tool with a large function set." msgstr "多くの機能を備えた純粋な :title:`Python` ツールです。" #: ../../app4.rst:149 719bb221eb5b4d34a21a977bfddfa966 msgid "PDFMiner_" msgstr "" #: ../../app4.rst:150 7c679bd2a294494c86c754ffaddb5cf3 msgid "A pure :title:`Python` to extract text and other data from |PDF|." msgstr "|PDF| からテキストやその他のデータを抽出するための純粋な :title:`Python` ツールです。" #: ../../app4.rst:151 ef3100ff8d5049009f9896ca197346c5 msgid "XPDF_" msgstr "" #: ../../app4.rst:152 89c9c95eccee414e90d74c494ef8fa0c msgid "A command line utility with multiple functions." msgstr "複数の機能を備えたコマンドラインユーティリティです。" #: ../../app4.rst:153 3ac8573211c94c1996a3f39372a5c365 msgid "PikePDF_" msgstr "" #: ../../app4.rst:154 ad269cc30d2f43dbbd44e72f1cfa24e9 msgid "" "A :title:`Python` package similar to :title:`PDFrw`, but based on " ":title:`C++` library :title:`QPDF`." msgstr "" ":title:`C++` ライブラリ :title:`QPDF` に基づいた :title:`Python` パッケージで、 " ":title:`PDFrw` に類似しています。" #: ../../app4.rst:155 f7a4dbe832784e9c80a9bec19efd26e4 msgid "PDF2JPG_" msgstr "" #: ../../app4.rst:156 2354f030ddfb48028e2dc5dcdca588bf msgid "" "A :title:`Python` package specialized on rendering |PDF| pages to " ":title:`JPG` images." msgstr "|PDF| ページを :title:`JPG` 画像にレンダリングすることに特化した :title:`Python` パッケージです。" #: ../../app4.rst:164 20ec5781714e43979415d31bca6e4d91 msgid "Copying / Joining / Merging" msgstr "コピー / 結合 / マージ" #: ../../app4.rst:166 24e5ae35daf74ce5af40e0c2fc945067 msgid "" "How fast is a |PDF| file read and its content parsed for further " "processing? The sheer parsing performance cannot directly be compared, " "because batch utilities always execute a requested task completely, in " "one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for " "parsing, meaning it only parses those parts of a document that are " "required in any moment." msgstr "" "|PDF| " "ファイルの読み取りおよびそのコンテンツの解析は、どれだけ高速に行われるのでしょうか？純粋な解析の性能を直接比較することはできません。なぜなら、バッチユーティリティは常に要求されたタスクを一度に完全に実行するからです。" " :title:`PDFrw` も解析の際には *レイジー* な戦略を採用しており、必要な瞬間に必要な部分のみを解析します。" #: ../../app4.rst:168 9030ee0b64da48c4b6ba3563a6fe7da8 msgid "" "To find an answer to the question, we therefore measure the time to copy " "a |PDF| file to an output file with each tool, and do nothing else." msgstr "したがって、この質問に答えるために、各ツールで |PDF| ファイルを出力ファイルにコピーする時間を計測し、それ以外の操作は行いません。" #: ../../app4.rst:170 ../../app4.rst:365 75c4e9d6b0f94276ad4a46e7ca064b4c #: d29245da53b44d4c931cdfd53a686bcb msgid "These are the :title:`Python` commands for how each tool is used:" msgstr "各ツールの使用方法に関する :title:`Python` コマンドは以下の通りです：" #: ../../app4.rst:180 40554a7aac2c4529a5cea2cb201adc33 msgid ":title:`PDFrw`" msgstr "" #: ../../app4.rst:190 2027a14c030c4dafa9b213b842921038 msgid ":title:`PikePDF`" msgstr "" #: ../../app4.rst:198 0554b1918f0442929d092d7d1aa8c6db msgid ":title:`PyPDF2`" msgstr "" #: ../../app4.rst:210 ../../app4.rst:288 ../../app4.rst:399 #: 0cc77d5085aa42b092a9d28c9f9b93d1 2151ed94f39e42489d9407b0a8ac0ccb #: 8e952a6e6d1d46499282ea93f770529c msgid "**Observations**" msgstr "**観察結果**" #: ../../app4.rst:212 ../../app4.rst:290 ../../app4.rst:401 #: 190b33a2a1264d58900d557c11876da4 2995f439d6cb495da4b80e31d49c47a7 #: 536ccc62e0b8415f92d295558b4e0e5b msgid "" "These are our run time findings in **seconds** along with a base rate " "summary compared to |PyMuPDF|:" msgstr "以下は、実行時間の結果（ **秒単位**）と、 |PyMuPDF| との比較における基本レートの要約です：" #: ../../app4.rst:219 a51de26a6852481a8e70a53e96187379 msgid "**PDFrw**" msgstr "" #: ../../app4.rst:220 933434ca403749c0a4f630ffec63fbf0 msgid "**PikePDF**" msgstr "" #: ../../app4.rst:221 ../../app4.rst:298 93a77920ab2f426481a1d5037c17135f #: a5fda08d4d34464ba81569732331f63c msgid "**PyPDF2**" msgstr "" #: ../../app4.rst:222 ../../app4.rst:300 ../../app4.rst:411 #: 5544726c03fb43a2afaa6c61866bba6a 5ade818fb72c4831ad8691c9cf811c78 #: af7a989e3b5144c1a3f9d080bc5aea03 msgid "adobe.pdf" msgstr "" #: ../../app4.rst:223 aea85b36f9074c44ac0e480e9feedf9a msgid "1.75" msgstr "" #: ../../app4.rst:224 1d5d21531c014823b5bd62db7bc0135e msgid "5.15" msgstr "" #: ../../app4.rst:225 29285cb95fbc41c7b91b01dda4181c2d msgid "22.37" msgstr "" #: ../../app4.rst:226 68b490eb621f4f4eb992f5e5eb9baff5 msgid "374.05" msgstr "" #: ../../app4.rst:227 ../../app4.rst:305 ../../app4.rst:415 #: 00246b4fa6bb413aaecfac538ed32b19 20452d17f0ed4d98ab1d92047ddb55a7 #: dc633929adc3417d9c90d8be2bf90613 msgid "artifex-website.pdf" msgstr "" #: ../../app4.rst:228 3e3d60bb5a06431f8423b7fa72008e45 msgid "0.26" msgstr "" #: ../../app4.rst:229 ../../app4.rst:243 2ce822ddafa04eacb665dcdd8bb34f25 #: a0ca8a854b9c428a9257c8dbf52b4590 msgid "0.38" msgstr "" #: ../../app4.rst:230 63e990f7145f451dac1615b7274b980f msgid "1.41" msgstr "" #: ../../app4.rst:231 e5e9ce25649c4a7e87d9cfed1d4c1f0a msgid "2.81" msgstr "" #: ../../app4.rst:232 ../../app4.rst:310 ../../app4.rst:419 #: 1abbb91fd2804bff9cc59d244e834dbe 25ef69a136294635ad82241de488155a #: 5c166f9365fb4824bbe295d262a4c695 msgid "db-systems.pdf" msgstr "" #: ../../app4.rst:233 dfa580f9d5494073b720002293a6fa82 msgid "0.15" msgstr "" #: ../../app4.rst:234 0cabf0e69a2e40a8920e44b780f064b6 msgid "0.8" msgstr "" #: ../../app4.rst:235 1b45bb6fb5384d11863727a44bc772d5 msgid "1.68" msgstr "" #: ../../app4.rst:236 482704feedf44b168160d5c6bf430e89 msgid "2.46" msgstr "" #: ../../app4.rst:237 ../../app4.rst:315 ../../app4.rst:423 #: 28cf3f5a2e644968b1b497d836968533 619f6293468e4a5b9414def4ae968f6a #: a54e51785c104643876df4110d7f60fb msgid "fontforge.pdf" msgstr "" #: ../../app4.rst:238 80142473274946b2b76110266168f6d2 msgid "0.09" msgstr "" #: ../../app4.rst:239 fdeb0d08542549ad94e6f5ff68f639e1 msgid "0.14" msgstr "" #: ../../app4.rst:240 fa056a25dbc24ce8bbb7206ac25c05ae msgid "0.28" msgstr "" #: ../../app4.rst:241 ../../app4.rst:308 4bafecabe76b409d8db8ac377d7f7ea9 #: 5206ddcbea3c43ab869b569ff3172038 msgid "1.1" msgstr "" #: ../../app4.rst:242 ../../app4.rst:320 ../../app4.rst:427 #: 283144343a0949668598a967aab1deef 2bf82f9384f34930a1debf451276e32e #: f64eb5e532a04104b1c1491cdd231638 msgid "pandas.pdf" msgstr "" #: ../../app4.rst:244 c0f38df2b0cd4082acfb9b25f340902a msgid "2.21" msgstr "" #: ../../app4.rst:245 9594837d5d2848c6bd8fc40d23f432db msgid "2.73" msgstr "" #: ../../app4.rst:246 d52e2689ad7047df8dcab08a5b7c5417 msgid "70.3" msgstr "" #: ../../app4.rst:247 ../../app4.rst:325 ../../app4.rst:431 #: 6adf778936ea4b1bac0e0112c0f3d53a ca7e5c0d37d843a5a058022264ef4838 #: df12e19f983a4715a95aa5e1c4259037 msgid "pymupdf.pdf" msgstr "" #: ../../app4.rst:248 50c706b1c6eb4ba783605c298016ffd9 msgid "0.11" msgstr "" #: ../../app4.rst:249 e6316c498d704c12a367a5598ce1dfa4 msgid "0.56" msgstr "" #: ../../app4.rst:250 c9b02d42498945f39b746d182ceef93f msgid "0.83" msgstr "" #: ../../app4.rst:251 a866f67188d54c70912cd3e19c35d760 msgid "6.05" msgstr "" #: ../../app4.rst:252 ../../app4.rst:330 ../../app4.rst:435 #: 2d6911f21f034fdb99236c6da0e5c8fc ca646d19848a4024b113f84e29e5f016 #: ddf7610dcd7d4c2085d801cc70dfa46b msgid "pythonbook.pdf" msgstr "" #: ../../app4.rst:253 6f0fe33ac23b4d0baf5009363bc75c5b msgid "0.19" msgstr "" #: ../../app4.rst:254 680b3cbd12934d07830711fdf35d8c00 msgid "1.2" msgstr "" #: ../../app4.rst:255 fbbf220c922f4a53ab16e06f0c5042ee msgid "1.34" msgstr "" #: ../../app4.rst:256 e94988b7dbc347c09260a2b8a03dd461 msgid "37.19" msgstr "" #: ../../app4.rst:257 ../../app4.rst:335 ../../app4.rst:439 #: a9d4ceb80d2c42e0b7bf4c22de480e63 aa346b20c8c14103ad508c92238ca1a8 #: b0d041755ac04554a0acc858c79f4516 msgid "sample-50-MB-pdf-file.pdf" msgstr "" #: ../../app4.rst:258 bcc275d36bf04161834713d6d786e356 msgid "0.12" msgstr "" #: ../../app4.rst:259 cb526a85171a4e5c924b02fae9f5cff1 msgid "0.1" msgstr "" #: ../../app4.rst:260 57e608621ccb4404a586b7361b537020 msgid "2.93" msgstr "" #: ../../app4.rst:261 e280682fa0f048f7bf4a842026ed388c msgid "0.08" msgstr "" #: ../../app4.rst:262 ../../app4.rst:340 ../../app4.rst:443 #: 147889494a0342d39c8d7bc589e777a1 9dde60202b154d62bb5dc5da1b8f3eb4 #: dcdc53ddede34633afbb78b8cb474780 msgid "**Total**" msgstr "**合計** " #: ../../app4.rst:263 482ff9ef77514db0a3105d43540c6a79 msgid "**3.05**" msgstr "" #: ../../app4.rst:264 2f728a892b10493f83a211bbe00dc8c2 msgid "**10.54**" msgstr "" #: ../../app4.rst:265 8a1310321389468b8eeb7302181de22f msgid "**33.57**" msgstr "" #: ../../app4.rst:266 8979d1c755ab4d5480e0e543908439ab msgid "**494.04**" msgstr "" #: ../../app4.rst:272 ../../app4.rst:350 ../../app4.rst:451 #: 39d408ac310b429a9f4630de549c0218 b1cedcb976d7467cb64b4a03e059059f #: d60f7ab07be042e9ac4f315656e9d80e msgid "**Rate compared to PyMuPDF**" msgstr "**PyMuPDFに対する比率** " #: ../../app4.rst:273 ../../app4.rst:351 ../../app4.rst:452 #: 5fe241f7da6f4f1287b2ef598e77e63a a1eabf390faf4118b9fbf1c23bcaa970 #: ca4532068a8749cebe70ecd680077cff msgid ":green-color:`1.0`" msgstr "" #: ../../app4.rst:274 4bebef049b2147ec9412439a06413b0c msgid ":orange-color:`3.5`" msgstr "" #: ../../app4.rst:275 bd4c733cfe544784bfac89860db9068e msgid ":orange-color:`11.0`" msgstr "" #: ../../app4.rst:276 65a3d5ea7ac842238d61067451bc62b9 msgid ":red-color:`162`" msgstr "" #: ../../app4.rst:283 1cd4fd60fed8493aa0180e6aced6f887 msgid "Text Extraction" msgstr "テキスト抽出" #: ../../app4.rst:285 43ec059052ef49239504e79c59d48792 msgid "" "The following table shows plain text extraction durations. All tools have" " been used with their most basic functionality - i.e. no layout re-" "arrangements, etc." msgstr "" "以下の表は、プレーンテキストの抽出にかかる時間を示しています。すべてのツールは、基本的な機能のみを使用しています - " "レイアウトの再配置などはありません。" #: ../../app4.rst:297 ../../app4.rst:409 493d81649a04476aa7e157c8155e8816 #: c7a4bc884d3e4b39ab49157d277af5e6 msgid "**XPDF**" msgstr "" #: ../../app4.rst:299 55447e13f7cc43598fde158caf1adfbf msgid "**PDFMiner**" msgstr "" #: ../../app4.rst:301 71ff39c17b764e46a725f342a082f147 msgid "2.01" msgstr "" #: ../../app4.rst:302 fce895fddd9544e4b84bbc464bc5d54a msgid "6.19" msgstr "" #: ../../app4.rst:303 11d7da5f489c4d5c8f08904e64d58b85 msgid "22.2" msgstr "" #: ../../app4.rst:304 7a43720209f2409891b79edcb6feebc8 msgid "49.15" msgstr "" #: ../../app4.rst:306 86da45bd435e4e2fac8f537ac4dc33c6 msgid "0.18" msgstr "" #: ../../app4.rst:307 9f329e56a13e4944887ba215aadd1c50 msgid "0.3" msgstr "" #: ../../app4.rst:309 412c97e97e644221bec455efaa9ee865 msgid "4.06" msgstr "" #: ../../app4.rst:311 3211848a2c7541c4b98431190bc82a51 msgid "1.57" msgstr "" #: ../../app4.rst:312 7888933412524d77b9710d7c349a6ad8 msgid "4.26" msgstr "" #: ../../app4.rst:313 78ac7fd7df42471aa6a3ac3bb3b13b4f msgid "25.75" msgstr "" #: ../../app4.rst:314 fbda6230814e4005b8c47d862c0364c4 msgid "42.19" msgstr "" #: ../../app4.rst:316 05c924d4dc1e4feb955b06be14c5e7e7 msgid "0.24" msgstr "" #: ../../app4.rst:317 eff929019a05485ab7d424571a631738 msgid "0.47" msgstr "" #: ../../app4.rst:318 d732cff1f2af4741b0cf005af6150933 msgid "2.69" msgstr "" #: ../../app4.rst:319 d717cab56bbc403fa2d497180e09afac msgid "4.2" msgstr "" #: ../../app4.rst:321 6f2bb2d646834a28b637393c83fbe756 msgid "2.41" msgstr "" #: ../../app4.rst:322 297e3c2d5f354ca6a5f331312ada2eb9 msgid "10.54" msgstr "" #: ../../app4.rst:323 e7aaee8a7d6d46738acd6d36fd3a1a2b msgid "25.38" msgstr "" #: ../../app4.rst:324 22691134bd124353bac936a15dc23c7d msgid "76.56" msgstr "" #: ../../app4.rst:326 beb7e60f87f44b00941524176f83234b msgid "0.49" msgstr "" #: ../../app4.rst:327 f1987f898ec44e2eae7731378a36d310 msgid "2.34" msgstr "" #: ../../app4.rst:328 ef61cf5a5cb042fdbb4db7ffb338d866 msgid "6.44" msgstr "" #: ../../app4.rst:329 22b1b07b84d542088f18ea5fb77ba24f msgid "13.55" msgstr "" #: ../../app4.rst:331 0832e852468f492a9ecffee3998af4f2 msgid "0.84" msgstr "" #: ../../app4.rst:332 3a29ccef7ff44af0bbc12374a5983e38 msgid "2.88" msgstr "" #: ../../app4.rst:333 be833e3e8322409ba592cc7891bfd260 msgid "9.28" msgstr "" #: ../../app4.rst:334 fb41a43110744ce98af7eee58740fb05 msgid "24.27" msgstr "" #: ../../app4.rst:336 81ca0ec15e384df3998d921f54470058 msgid "0.27" msgstr "" #: ../../app4.rst:337 fe5e6af169c04db999c3003913c8ad6e msgid "0.44" msgstr "" #: ../../app4.rst:338 9220f3fa950e47009211a9f69d405117 msgid "8.8" msgstr "" #: ../../app4.rst:339 a9338bdb413148689255f70fbeead632 msgid "13.29" msgstr "" #: ../../app4.rst:341 978aa50a4e73446ca6444f7911b99137 msgid "**8.01**" msgstr "" #: ../../app4.rst:342 c80a0bb069c644938e92b9da92483efa msgid "**27.42**" msgstr "" #: ../../app4.rst:343 3aff3e7279a74a2b90e22e23593c2795 msgid "**101.64**" msgstr "" #: ../../app4.rst:344 4fe0e88c92fd44c7af9bc827ce45422c msgid "**227.27**" msgstr "" #: ../../app4.rst:352 63cc33b2658d4c45b2ba8cbe943bd222 msgid ":orange-color:`3.42`" msgstr "" #: ../../app4.rst:353 0533ece4f3e14f7c96cb711e9d3b3fbf msgid ":orange-color:`12.69`" msgstr "" #: ../../app4.rst:354 1a614a3651e448a9911ab3eedaac4d42 msgid ":red-color:`28.37`" msgstr "" #: ../../app4.rst:360 00b592ac57f64130a8654c00830f154e msgid "Page Rendering" msgstr "ページのレンダリング" #: ../../app4.rst:362 f5119aaf183e4f4eb483e9c337c88488 msgid "" "We have tested rendering speed of |PyMuPDF| against :title:`pdf2jpg` and " ":title:`XPDF` at a resolution of 150 DPI," msgstr "" "私たちは、解像度150 DPIで |PyMuPDF| のレンダリング速度を :title:`pdf2jpg` と :title:`XPDF` " "と比較しました。" #: ../../app4.rst:382 02cf04dabcd44b9998f6e4e25bbca5ee msgid ":title:`XPDF`" msgstr "" #: ../../app4.rst:389 90770272b10c416e84826a42e1c212cc msgid ":title:`PDF2JPG`" msgstr "" #: ../../app4.rst:410 c717d43cc70e48e98e87edcf403d8b03 msgid "**PDF2JPG**" msgstr "" #: ../../app4.rst:412 da606418caee4a099a285d88fdee4bcb msgid "51.33" msgstr "" #: ../../app4.rst:413 d42b2bb121b54a939a97fd7c82e60632 msgid "98.16" msgstr "" #: ../../app4.rst:414 97e1e5c516654f909a445d6158df2fef msgid "75.71" msgstr "" #: ../../app4.rst:416 c1a00e6812494e27a1e5513c5dcb6515 msgid "26.35" msgstr "" #: ../../app4.rst:417 525f071275c846daaccf5b9ad9472c35 msgid "51.28" msgstr "" #: ../../app4.rst:418 dab5c30a6ab14679837b7c79be1baef5 msgid "54.11" msgstr "" #: ../../app4.rst:420 6347c08651eb4dfc963827edfe3c2dfa msgid "84.59" msgstr "" #: ../../app4.rst:421 9ff9e6ea2bff413e96b7948a6cdd6c2d msgid "143.16" msgstr "" #: ../../app4.rst:422 088e57b2eec94b3bbbf1258987f8c664 msgid "405.22" msgstr "" #: ../../app4.rst:424 b3cf9ee794b34bad8b6dbfe411512b74 msgid "12.23" msgstr "" #: ../../app4.rst:425 d51b92890c7442579c00adf23e97f279 msgid "22.18" msgstr "" #: ../../app4.rst:426 3f7b41851cdf4ca493af2c869d25b055 msgid "20.14" msgstr "" #: ../../app4.rst:428 226831c9dbf7408f9116226b0776dff5 msgid "138.74" msgstr "" #: ../../app4.rst:429 c0ff7f066efe4586859fcd60916d8201 msgid "241.67" msgstr "" #: ../../app4.rst:430 c348dd9ee91b448aad5e075ccac79cbc msgid "202.06" msgstr "" #: ../../app4.rst:432 5ac66403bf9a49aead460327d7c44f45 msgid "22.35" msgstr "" #: ../../app4.rst:433 9173e53f1f69448a83d553ded32bb807 msgid "39.11" msgstr "" #: ../../app4.rst:434 89611809173d45ae8ac3a4f7089ee725 msgid "33.38" msgstr "" #: ../../app4.rst:436 533943d891b74af491898743b80b7be3 msgid "30.44" msgstr "" #: ../../app4.rst:437 940113c92ada4f3fabf8932a0ec143e4 msgid "49.12" msgstr "" #: ../../app4.rst:438 0698ab345b994705a75ccfaddd9670fa msgid "55.68" msgstr "" #: ../../app4.rst:440 022d36dd2a304fca9d994fd8aebb4229 msgid "1.01" msgstr "" #: ../../app4.rst:441 fb7736a3bc7c4ca29f4fce61faf4b788 msgid "1.32" msgstr "" #: ../../app4.rst:442 dabe4ab239f1407f95b68ad8269a33af msgid "5.22" msgstr "" #: ../../app4.rst:444 23819f93562342a8b546fc017760f1c2 msgid "**367.04**" msgstr "" #: ../../app4.rst:445 1616c1fe2bca4ff2a048b9308c0f246e msgid "**646**" msgstr "" #: ../../app4.rst:446 5bdba98414414ff8ac81e89e0e221e71 msgid "**851.52**" msgstr "" #: ../../app4.rst:453 d581d4e1ac754c2b9e0172b86aeb3edf msgid ":orange-color:`1.76`" msgstr "" #: ../../app4.rst:454 5a2a9f45f5b14d398c5c1891f3ed968c msgid ":red-color:`2.32`" msgstr "" #: ../../footer.rst:46 6f6b539ff34a4640ab8af9e5deaeacb0 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "`adobe.pdf`_" #~ msgstr "" #~ msgid "`artifex-website.pdf`_" #~ msgstr "" #~ msgid "`db-systems.pdf`_" #~ msgstr "" #~ msgid "`fontforge.pdf`_" #~ msgstr "" #~ msgid "`pandas.pdf`_" #~ msgstr "" #~ msgid "`pymupdf.pdf`_" #~ msgstr "" #~ msgid "`pythonbook.pdf`_" #~ msgstr "" #~ msgid "`sample-50-MB-pdf-file.pdf`_" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/archive-class.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d617abc2bac44b79b8895c5a477d435e msgid "Artifex" msgstr "" #: ../../header.rst:-1 11676cd8a070416581b0f70844041acd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 e1542b64861144078ef1fec53974ec47 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../archive-class.rst:7 2f0bf46e9ac54fd68b23bc9210c74150 msgid "Archive" msgstr "Archive (アーカイブ)" #: ../../archive-class.rst:9 46f4ce49429542a1b693c99eadca160d msgid "New in v1.21.0" msgstr "v1.21.0での新機能" #: ../../archive-class.rst:11 90ae46c1e95142ec8216ccb598850553 msgid "" "This class represents a generalization of file folders and container " "files like ZIP and TAR archives. Archives allow accessing arbitrary " "collections of file folders, ZIP / TAR files and single binary data " "elements as if they all were part of one hierarchical tree of folders." msgstr "このクラスは、ファイルフォルダーやZIPやTARアーカイブのようなコンテナファイルの一般化を表します。アーカイブは、ファイルフォルダー、ZIP/TARファイル、および単一のバイナリデータ要素の任意のコレクションにアクセスできるようにし、すべてが1つの階層的なフォルダーツリーの一部であるかのようにします。" #: ../../archive-class.rst:13 3fd435f3261d48d4a0a727f172c9ddb6 msgid "" "In PyMuPDF, archives are currently only used by :ref:`Story` objects to " "specify where to look for fonts, images and other resources." msgstr "" "PyMuPDFでは、アーカイブは現在、フォント、画像、およびその他のリソースを検索する場所を指定するために :ref:`Story` " "オブジェクトによってのみ使用されています。" #: ../../archive-class.rst:16 1829b6e552a94dc5a3c61784652f1d73 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../archive-class.rst:16 2bf68b939c1d44f7be1ca6d449c27e53 msgid "**Short Description**" msgstr "**簡単な説明**" #: ../../archive-class.rst:18 5b94b5437aa84ff9a245301a956f8d18 msgid ":meth:`Archive.add`" msgstr "" #: ../../archive-class.rst:18 8c9d95f042814c25a324f3ce9ec79170 msgid "add new data to the archive" msgstr "アーカイブに新しいデータを追加する" #: ../../archive-class.rst:19 d5b520ec1d214317ac63ec60b509eb43 msgid ":meth:`Archive.has_entry`" msgstr "" #: ../../archive-class.rst:19 054f56f20f6d4fa8a033a1dd80bd3cb6 msgid "check if given name is a member" msgstr "名前で指定されたデータを読む" #: ../../archive-class.rst:20 dc2f8062523044d19ec994b1828e3195 msgid ":meth:`Archive.read_entry`" msgstr "" #: ../../archive-class.rst:20 e680d9fb1dd44a7f85a61af9853e4e6d msgid "read the data given by the name" msgstr "名前で指定されたデータを読む" #: ../../archive-class.rst:21 e41ca685715b4dcbb45e53b209029663 msgid ":attr:`Archive.entry_list`" msgstr "" #: ../../archive-class.rst:21 f31453b71aeb4ade88edbebb982ff071 msgid "list[dict] of archive items" msgstr "アーカイブアイテムのリスト[辞書]" #: ../../archive-class.rst:24 98357f302ae84859bd401682492995fa msgid "**Class API**" msgstr "クラス API" #: ../../archive-class.rst:30 422de49b171f4d18afbb8516afbc9095 msgid "Creates a new archive. Without parameters, an empty archive is created." msgstr "新しいアーカイブを作成します。パラメーターが指定されない場合、空のアーカイブが作成されます。" #: ../../archive-class.rst:32 ae5782f0b4a54bc3be2c009daab1a7ca msgid "If provided, `content` may be one of the following:" msgstr "提供される場合、`content` は次のいずれかであることができます：" #: ../../archive-class.rst:34 fbf461b873ef4da5b1fda4e484d46cbf msgid "another Archive: the archive is being made a sub-archive of the new one." msgstr "別の Archive: アーカイブは新しいアーカイブのサブアーカイブになります。" #: ../../archive-class.rst:36 6ac58a1199014e0a932f80579a01fff4 msgid "" "a string: this must be the name of a local folder or file. `pathlib.Path`" " objects are also supported." msgstr "文字列: これはローカルフォルダまたはファイルの名前である必要があります。`pathlib.Path` オブジェクトもサポートされています。" #: ../../archive-class.rst:38 63b7f15541554ca28bb94dacd2e33b99 msgid "" "A **folder** will be converted to a sub-archive, so its files (and any " "sub-folders) can be accessed by their names." msgstr "**フォルダ** はサブアーカイブに変換され、そのファイル（およびサブフォルダ）は名前でアクセスできます。" #: ../../archive-class.rst:39 547200864ba043b295790af8b0b2a6cf msgid "" "A **file** will be read with mode `\"rb\"` and these binary data (a " "`bytes` object) be treated as a single-member sub-archive. In this case, " "the `path` parameter is **mandatory** and should be the member name under" " which this item can be found / retrieved." msgstr "" "**ファイル** はモード `\"rb\"` で読み取られ、これらのバイナリデータ（ `bytes` " "オブジェクト）は単一のメンバーサブアーカイブとして扱われます。この場合、`path` パラメーターは **必須** " "で、このアイテムが見つかる/取得できるメンバー名である必要があります。" #: ../../archive-class.rst:41 26fc387cc92a49b18be5fbb6e276303a msgid "" "a `zipfile.ZipFile` or `tarfile.TarFile` object: Will be added as a sub-" "archive." msgstr "`zipfile.ZipFile` または `tarfile.TarFile` オブジェクト: サブアーカイブとして追加されます。" #: ../../archive-class.rst:43 a95ece3a221d4379bbdf468f3d625687 msgid "" "a Python binary object (`bytes`, `bytearray`, `io.BytesIO`): this will " "add a single-member sub-archive. In this case, the `path` parameter is " "**mandatory** and should be the member name under which this item can be " "found / retrieved." msgstr "" "Python バイナリオブジェクト（ `bytes`、`bytearray` 、`io.BytesIO` ）: " "これは単一のメンバーサブアーカイブを追加します。この場合、`path` パラメーターは **必須** " "で、このアイテムが見つかる/取得できるメンバー名である必要があります。" #: ../../archive-class.rst:45 6cefb5b8a5ae4538b432a671e5624634 msgid "" "a tuple `(data, name)`: This will add a single-member sub-archive with " "the member name ``name``. ``data`` may be a Python binary object or a " "local file name (in which case its binary file content is used). Use this" " format if you need to specify `path`." msgstr "" "タプル `(data, name)` : これはメンバー名 ``name`` を持つ単一のメンバーサブアーカイブを追加します。 ``data`` " "はPythonバイナリオブジェクトまたはローカルファイル名である可能性があります（その場合、バイナリファイルのコンテンツが使用されます）。`path`" " を指定する必要がある場合は、このフォーマットを使用してください。" #: ../../archive-class.rst:47 8916743a3d2e482e8fac00263e7c6839 msgid "" "a Python sequence: This is a convenience format to specify any " "combination of the above." msgstr "Pythonシーケンス: これは上記のいずれかの組み合わせを指定するための便益フォーマットです。" #: ../../archive-class.rst:49 ea2b6c8e209e48e7a488431fc4d5dc5b msgid "If provided, `path` must be a string." msgstr "提供される場合、`path` は文字列である必要があります。" #: ../../archive-class.rst:51 ce6b5084838e47998c1c0930a1c90a85 msgid "" "If `content` is either binary data or a file name, this parameter is " "mandatory and must be the name under which the data can be found." msgstr "`content` がバイナリデータまたはファイル名の場合、このパラメーターは必須で、データが見つかる名前である必要があります。" #: ../../archive-class.rst:53 bfdfb9696f9d4267b9a0abcd4944814d msgid "" "Otherwise this parameter is optional. It can be used to simulate a folder" " name or a mount point, under which this sub-archive's elements can be " "found. For example this specification `Archive((data, \"name\"), " "\"path\")` means that `data` will be found using the element name " "`\"path/name\"`. Similar is true for other sub-archives: to retrieve " "members of a ZIP sub-archive, their names must be prefixed with " "`\"path/\"`. The main purpose of this parameter probably is to " "differentiate between duplicate names." msgstr "" "それ以外の場合、このパラメーターはオプションです。これは、このサブアーカイブの要素が見つかるマウントポイントまたはフォルダ名をシミュレートするために使用できます。たとえば、この仕様" " `Archive((data, \"name\"), \"path\")` は、データが要素名 \"`\"path/name\"` " "で見つかります。他のサブアーカイブについても同様です：ZIPサブアーカイブのメンバーを取得するには、その名前に `\"path/\"` " "を接頭辞として追加する必要があります。このパラメーターの主な目的は、重複する名前を区別することである可能性があります。" #: ../../archive-class.rst:55 61677063f42641209e56a228534c33f2 msgid "" "If duplicate entry names exist in the archive, always the last entry with" " that name will be found / retrieved. During archive creation, or " "appending more data to an archive (see :meth:`Archive.add`) no check for " "duplicates will be made. Use the `path` parameter to prevent this from " "happening." msgstr "" "アーカイブ内に重複するエントリ名が存在する場合、常にその名前の最後のエントリが見つかり/取得されます。アーカイブの作成中、またはアーカイブにさらにデータを追加する際" " :meth:`Archive.add` を参照）、重複をチェックしません。この問題を防ぐために path パラメーターを使用してください。" #: ../../archive-class.rst:59 dc6f307620b443e59c60965c461c7642 msgid "" "Append a sub-archive. The meaning of the parameters are exactly the same " "as explained above. Of course, parameter `content` is not optional here." msgstr "サブアーカイブを追加します。パラメータの意味は上記とまったく同じです。もちろん、ここではパラメータ `content` はオプションではありません。" #: ../../archive-class.rst:63 e1ad4f204f754654a6584c25842135fb msgid "Checks whether an entry exists in any of the sub-archives." msgstr "エントリがサブアーカイブのいずれかに存在するかどうかを確認します。" #: ../../archive-class.rst 6748d18e7f6946d6b1497df192130d43 #: feda328ffa8445dea3f5c2af2f98fdad msgid "Parameters" msgstr "パラメータ:" #: ../../archive-class.rst:65 ../../archive-class.rst:73 #: 0458d0fa598349cf8a25c5752c8f840b 1806b51351774f19944fb27526851e14 msgid "" "The fully qualified name of the entry. So must include any `path` prefix " "under which the entry's sub-archive has been added." msgstr "エントリの完全修飾名。エントリのサブアーカイブが追加されたパスのプレフィックスを含む必要があります。" #: ../../archive-class.rst 0fb6926638df4e5d88376ea0eea6219d #: b0c94ca65df04318aad6ff6b1d22633e msgid "Returns" msgstr "戻り値:" #: ../../archive-class.rst:67 484ce7feed2141d4b486ae9b49c1c29e msgid "`True` or `False`." msgstr "`True` または `False` 。" #: ../../archive-class.rst:71 affe45e0783c46f782832cb77fb3eb49 msgid "Retrieve the data of an entry." msgstr "エントリのデータを取得します。" #: ../../archive-class.rst:75 dc88278b5cee4df6a0867e93b0e234f2 msgid "" "The binary data (`bytes`) of the entry. If not found, an exception is " "raised." msgstr "エントリのバイナリデータ（ `bytes` ）です。見つからない場合は例外が発生します。" #: ../../archive-class.rst:79 3d32676328d34e37939a65792096baf5 msgid "" "A list of the archive's sub-archives. Each list item is a dictionary with" " the following keys:" msgstr "アーカイブのサブアーカイブのリストです。各リストアイテムは、次のキーを持つ辞書です：" #: ../../archive-class.rst:81 f4a44efa6e934e2ab4d5b59c1abb3212 msgid "`entries` -- a list of (top-level) entry names in this sub-archive." msgstr "`entries` - このサブアーカイブ内の（トップレベルの）エントリ名のリスト。" #: ../../archive-class.rst:82 5aefdd53977e4a2aa8c559d7bac700f6 msgid "" "`fmt` -- the format of the sub-archive. This is one of the strings " "\"dir\" (file folder), \"zip\" (ZIP archive), \"tar\" (TAR archive), or " "\"tree\" for single binary entries or file content." msgstr "" "`fmt` - サブアーカイブの形式。これは文字列 " "\"dir\"（ファイルフォルダ）、\"zip\"（ZIPアーカイブ）、\"tar\"（TARアーカイブ）、または単一のバイナリエントリまたはファイルコンテンツの場合は" " \"tree\" のいずれかです。" #: ../../archive-class.rst:83 ef04652561cc41bca0c8d60f067bb118 msgid "" "`path` -- the value of the `path` parameter under which this sub-archive " "was added." msgstr "`path` - このサブアーカイブが追加されたパラメータの値です。" #: ../../archive-class.rst:85 ddd26ce7aa1e42c09e3a7daa19769a5a msgid "**Example:**" msgstr "**例：** " #: ../../footer.rst:60 9a53a999980d4a2da538998c8bb29234 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/changes.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4b2125667c71405ca651d2f4f33203ce msgid "Artifex" msgstr "" #: ../../header.rst:-1 7a5706b2ba4a4c5f9ab33e6a435e268e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 232846e89a9147f6abd57e2c5299b488 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../../changes.txt:2 4cd69e5be9794686a140129e41fc4b95 msgid "Change Log" msgstr "" #: ../../../changes.txt:5 1505d60909e543b7809db6369fa0db8f msgid "**Changes in version 1.26.7**" msgstr "" #: ../../../changes.txt:7 ../../../changes.txt:43 ../../../changes.txt:73 #: ../../../changes.txt:95 ../../../changes.txt:117 ../../../changes.txt:146 #: ../../../changes.txt:171 ../../../changes.txt:192 ../../../changes.txt:212 #: ../../../changes.txt:236 ../../../changes.txt:285 ../../../changes.txt:335 #: ../../../changes.txt:366 ../../../changes.txt:387 ../../../changes.txt:423 #: ../../../changes.txt:443 ../../../changes.txt:457 ../../../changes.txt:485 #: ../../../changes.txt:507 ../../../changes.txt:530 ../../../changes.txt:556 #: ../../../changes.txt:589 ../../../changes.txt:611 ../../../changes.txt:625 #: ../../../changes.txt:642 ../../../changes.txt:664 ../../../changes.txt:673 #: ../../../changes.txt:686 ../../../changes.txt:698 ../../../changes.txt:715 #: ../../../changes.txt:728 ../../../changes.txt:741 ../../../changes.txt:754 #: ../../../changes.txt:766 ../../../changes.txt:778 ../../../changes.txt:801 #: ../../../changes.txt:833 ../../../changes.txt:859 ../../../changes.txt:899 #: ../../../changes.txt:926 ../../../changes.txt:948 ../../../changes.txt:1200 #: ../../../changes.txt:1334 049a26e13bb94229a79a69f81f7b5fbe #: 1f22271ed0b840efae8df95b0ee00fae 223eca2249444ff9ab2190c5225660fc #: 287da62560f74d3dab59fced5784a79f 289b8aaf54c746ecad54ca30175d6572 #: 2a7d7c2ae08a4078a26a35d98478462f 2d7b554ad4614d72aa34334544b1ad84 #: 3b0c2a7d2f02465d8a435c84b848e950 41d0c2d1b9dc4b92aaee342c76e8f6aa #: 4347b8c87fab492bb324cd690a0a5039 45a493f9bbb34d5d86014fc796fc7e5f #: 4ac9e175442d4fed9094777114001d05 5294b3baa70340d4b0683ea893cb8227 #: 55180f0a4ad14d779385728b45523412 56b9abeb67244e568154b0999908dc54 #: 590720763c4f4b6e944a5b6e9261c46a 5b96e63e430649e09364197f6640d348 #: 66a4fb9f871646b39fd2935322ff2bd7 681b44b2d00a428f95bec75570a9bd96 #: 6d3500e7906d4b5b9d5a852686c41f03 77caed4c8cf543c284393db2214dc425 #: 7930c830c16148e18e377994a974f7f6 8020c55d92a04b68b29f9b5c839563d9 #: 8dd9e915003d41dbbf42283bf55adefe 959e7f541c2147928cc800dcf3f54fa8 #: 980c2a259af24fc599c154fab471a6d4 9eeadae797794ba39efcdfe7dd30ea96 #: a1f33ce2da084e65927b1037ec5431c9 a5748cc98e13464f8d5833fb09a584c6 #: b003035ab22a486d8191c52df2f18d51 b1ac215bbe134f3e83fc2c3f1315274d #: b322fd43be9f42fcb134129f551f03d7 b8505854ea4346dca195196c3c729c8e #: baa47c681a164ab190fd710ab752c1e5 be5cdf51439747e9856bf7da70502394 #: c18708d565ec49bb9b6597c6e4746708 cbe526883f0a481b9e4b1e4727d250df #: d23ff8de34d7483c8f2da67985f1837a e53406c760874e3fba6776cc13ce71c4 #: ea5c09729ad243d1b44e29edb73a3242 f176ccdd28d44b75bfd267fa28648397 #: f325e778302b4997b940c6c03dc96ae8 fab1e85d6fcb480fba201316c8c6be02 msgid "Other:" msgstr "" #: ../../../changes.txt:9 eef8efb3b6884f43ada21c5e779231cb msgid "" "Retrospectively mark `4756 " "`_ as fixed in 1.26.6." msgstr "" #: ../../../changes.txt:10 64ed70e9271b4853b276b73970b50572 msgid "" "Improved safety of `pymupdf embed-extract`. This now refuses to write to " "an existing file or outside current directory, unless `-output` or new " "flag `-unsafe` is specified." msgstr "" #: ../../../changes.txt:15 f3d0c45b85df4b2e8952e6a2da3389b7 msgid "**Changes in version 1.26.6** (2025-11-05)" msgstr "" #: ../../../changes.txt:17 f42bfa1ba64243c3bbb367df56f3ac08 msgid "Use MuPDF-1.26.11." msgstr "" #: ../../../changes.txt:19 50c8518a04f0461d92243888e708323a msgid "Supported Python versions are now 3.10-3.14." msgstr "" #: ../../../changes.txt:21 ../../../changes.txt:35 ../../../changes.txt:59 #: ../../../changes.txt:87 ../../../changes.txt:110 ../../../changes.txt:132 #: ../../../changes.txt:164 ../../../changes.txt:183 ../../../changes.txt:203 #: ../../../changes.txt:226 ../../../changes.txt:249 ../../../changes.txt:259 #: ../../../changes.txt:274 ../../../changes.txt:294 ../../../changes.txt:304 #: ../../../changes.txt:321 ../../../changes.txt:347 ../../../changes.txt:380 #: ../../../changes.txt:396 ../../../changes.txt:406 ../../../changes.txt:438 #: ../../../changes.txt:475 ../../../changes.txt:502 ../../../changes.txt:524 #: ../../../changes.txt:541 ../../../changes.txt:584 ../../../changes.txt:605 #: ../../../changes.txt:619 ../../../changes.txt:632 ../../../changes.txt:658 #: ../../../changes.txt:671 07987b0a21a147d98b3290a64ffa8043 #: 1f57395ac4ea4c218653cd455c477ae4 21d647e365934565aea69ef24f0cd8f9 #: 262f48050967468c829ffe26a450be4b 4cef11a8719641dbb922f8aa1573a9c6 #: 4e96e411a9d04f3394926ff7a164019f 4f462e8fc6bf487c991f26164fb54c0f #: 502470bd29ee4a5f910f9b6c271e6371 5fac41e37738489fa8375e221307b3be #: 7d9274f30a6d48e080212ec423122787 7fb6e1f0f0a04c768954b3b7aa03e2f1 #: 8b358fae935541dd89ec020f9bdb1b41 8dbc5997591e480a88aef01fc75581db #: 94c9d89ad8d543cb833db162ba31fde4 9b23f29736354e1d8ed1668fd1f388bf #: 9e14b9596afa45b3a83e357fbda360af a2ea1d3f01d945e0b1771aa1b29caa0c #: a53b73a9f82648878f41f1760093e351 ad004edc4dba484fadde2289418127fe #: b70bd970a9944857a416f7ca0c9b1c6b bbd89b8b6e3544ab875a3a6e44ebe68d #: c08f485ce1c34a11ba134e40626b051f d727b39943064157a040eb5ba843fe41 #: d855c86985754c219d04723faa8e0b48 db0403d789674d7aae95b0d2af2dd802 #: e0509078460b456b924d980a899d39ea e182efb4eac34ad8bac7dece1504bf23 #: e2459e41e6d84b248942175137234803 e9129fdd854d4510beb02b78caf662e2 #: f752594e63ac42a1bc09a307033985cb f9a85782009445d9b72155a12a8ec8ed msgid "Fixed issues:" msgstr "" #: ../../../changes.txt:23 ae92f1fe5caf4bf1b49a2d9b55379d9c msgid "" "**Fixed** `4699 `_: " "cannot find ExtGState resource" msgstr "" #: ../../../changes.txt:24 22f8d06dd888459aa4f9fe1120d92dc8 msgid "" "**Fixed** `4712 `_: Crash" " with \"corrupted double-linked list\"" msgstr "" #: ../../../changes.txt:25 ccf146dfc96a47d3bab7d6102699c73d msgid "" "**Fixed** `4720 `_: " "Memory leaking in rewrite_images?" msgstr "" #: ../../../changes.txt:26 0f08a4cb18fe493ca72344c67c165f1d msgid "" "**Fixed** `4742 `_: " "'Rect' object has no attribute 'get_area'" msgstr "" #: ../../../changes.txt:27 e4563a3e5c574da8970663d208888aa7 msgid "" "**Fixed** `4746 `_: " "Document.__init__() got an unexpected keyword argument 'encoding'" msgstr "" #: ../../../changes.txt:28 2b1ad6590a63426bb7c3dc1b135aaf86 msgid "" "**Fixed** `4756 `_: swig " "--version doesn't work in all versions of swig; -version should be used " "instead" msgstr "" #: ../../../changes.txt:31 f4b0a46bedf54bc695a3074e319c3da7 msgid "**Changes in version 1.26.5** (2025-10-10)" msgstr "" #: ../../../changes.txt:33 25fffdf714bf48d695db8e6ab1a28c67 msgid "Use MuPDF-1.26.10." msgstr "" #: ../../../changes.txt:37 c88a8d28e397405f93d8379d00535d27 msgid "" "**Fixed** `2883 `_: " "Improve the Python type annotations for fitz_new" msgstr "" #: ../../../changes.txt:38 df91056120a24c1caa9c0b77f3fb1984 msgid "" "**Fixed** `4507 `_: Bugs " "in pyodide" msgstr "" #: ../../../changes.txt:39 70703777c2fa401bbc683f91ad94d06f msgid "" "**Fixed** `4613 `_: Thai " "and number blocks are not auto-scaled and get wrong hyphen when using in " "insert_htmlbox" msgstr "" #: ../../../changes.txt:40 c88bc69f0f244a52ad6f890499799047 msgid "" "**Fixed** `4700 `_: " "pymupdf.open() processes .zip file without raising" msgstr "" #: ../../../changes.txt:41 e323399440274525b34c54f4dec39093 msgid "" "**Fixed** `4716 `_: " "Problems with unreadable characters" msgstr "" #: ../../../changes.txt:45 3abefa34a28e4adf8e2457613ce56b45 msgid "Supported Python versions are now 3.9-3.14." msgstr "" #: ../../../changes.txt:46 16783112fa05425cb0e149b83c62e932 msgid "" "We now define all class methods explicitly instead of with dynamic " "assignment; this improves type hints." msgstr "" #: ../../../changes.txt:47 26f54231a095480aa0f42247a5a89ef4 msgid "Removed `pymupdf.utils.Shape` class, was duplicate of `pymupdf.Shape`." msgstr "" #: ../../../changes.txt:48 7ecda4cd98c54e6a9b9bf91163eff14b msgid "Allow use of cibuildwheel to build and test on Pyodide." msgstr "" #: ../../../changes.txt:49 93135916c58248c283baf01e7d053cd0 msgid "Fixed various Pyodide bugs." msgstr "" #: ../../../changes.txt:50 7ecc6290f1054757b942bc4fb105d1eb msgid "" "In documentation, added section about Linux wheels and glibc " "compatibility." msgstr "" #: ../../../changes.txt:51 92f2c3d79a944460985276d312eca3e4 msgid "Improved documentation of pymupdf.open()'s arg." msgstr "" #: ../../../changes.txt:52 562bb006d36840cdb5aadf8ddd466486 msgid "" "Retrospectively mark `4544 " "`_ as fixed in 1.26.4." msgstr "" #: ../../../changes.txt:55 b67d98ad96244427984fe137baacd5a1 msgid "**Changes in version 1.26.4 (2025-08-25)**" msgstr "" #: ../../../changes.txt:57 6d0728e9c0d245e69d0197ef60d55ff6 msgid "Use MuPDF-1.26.7." msgstr "" #: ../../../changes.txt:61 dae25b5e67ed40678841767ca82960df msgid "" "**Fixed** `3806 `_: pdf " "to image rendering ignore optional content offs" msgstr "" #: ../../../changes.txt:62 d27cf6acd0904ba3854fc86e793e1b0e msgid "" "**Fixed** `4388 `_: " "Incorrect PixMap from page due to cached data from other PDF" msgstr "" #: ../../../changes.txt:63 2485533a6f1c4ceeab94a3a74ea0040a msgid "" "**Fixed** `4457 `_: Wrong" " characters displayed after font subsetting (w/ native method)" msgstr "" #: ../../../changes.txt:64 ../../../changes.txt:89 #: 48034320908941b78280338d69474453 582145c0201942e4a97e4a6715f82496 msgid "" "**Fixed** `4462 `_: " "delete_pages() does not accept a single int" msgstr "" #: ../../../changes.txt:65 ee57c3dd80db447388f6e8ac0d049adb msgid "" "**Fixed** `4533 `_: Open " "PDF error segmentation fault" msgstr "" #: ../../../changes.txt:66 96cc9c5c43084b5e9cf0162eb38b2dbf msgid "" "**Fixed** `4544 `_: About" " pdf_clip_page" msgstr "" #: ../../../changes.txt:67 ed6dabd36ac34857a630542ffd191c57 msgid "" "**Fixed** `4565 `_: MacOS" " uses Tesseract and not Tesseract-OCR" msgstr "" #: ../../../changes.txt:68 fb88b0c8cbc84095bf2500c9a32f50ec msgid "" "**Fixed** `4571 `_: " "Broken merged pdfs." msgstr "" #: ../../../changes.txt:69 ef751fe8798b41eaaf64e166e23768fa msgid "" "**Fixed** `4590 `_: " "TypeError in utils.py scrub(): annot.update_file(buffer=...) is invalid" msgstr "" #: ../../../changes.txt:70 3b8c0e208f554eaebac0ea6abcd8b46d msgid "" "**Fixed** `4614 `_: " "Intercept bad widgets when inserting to another PDF" msgstr "" #: ../../../changes.txt:71 02cfdc76ab714494bf079b968391320e msgid "" "**Fixed** `4639 `_: " "pymupdf.mupdf.FzErrorGeneric: code=1: Director error: : 'JM_new_bbox_device_Device' object has no attribute " "'layer_name'" msgstr "" #: ../../../changes.txt:75 38712224dd5544e7a462aaeb1e2e304b msgid "" "Check that #4392 `Segfault when running with pytest and -Werror` is fixed" " if PyMuPDF is built with swig>=4.4." msgstr "" #: ../../../changes.txt:76 57972c515886453a932d8eac12c3b328 msgid "Add `Page.clip_to_rect()`." msgstr "" #: ../../../changes.txt:77 586a552aa4af4245b5e12d417ae1f42d msgid "Improved search for Tesseract data." msgstr "" #: ../../../changes.txt:78 9f280d1da9b04eedae2eb7fa58bf1973 msgid "Retrospectively mark #4496 as fixed in 1.26.1." msgstr "" #: ../../../changes.txt:79 3fde7874083c4911a6dd9d05ee3f3e7c msgid "Retrospectively mark #4503 as fixed in 1.26.3." msgstr "" #: ../../../changes.txt:80 e25d10cd0c8b485b998c07889f2c2b02 msgid "Added experimental support for Graal." msgstr "" #: ../../../changes.txt:83 a4c9e90997aa40e39b6e88a47283df1f msgid "**Changes in version 1.26.3 (2025-07-02)**" msgstr "" #: ../../../changes.txt:85 f2e0c9ebfbc8436a90fbc5210c2d61c5 msgid "Use MuPDF-1.26.3." msgstr "" #: ../../../changes.txt:90 88b28524dc38400e86ede8dfd69bda83 msgid "" "**Fixed** `4503 `_: " "Undetected character styles" msgstr "" #: ../../../changes.txt:91 82e1019dfacf4e889e4e2708d5c2ab67 msgid "" "**Fixed** `4527 `_: " "Rect.intersects() is much slower than necessary" msgstr "" #: ../../../changes.txt:92 3195a73537bc44b6be38e2643857a820 msgid "" "**Fixed** `4564 `_: " "Possible encoding issue in PDF metadata" msgstr "" #: ../../../changes.txt:93 ed811f813c204c15a71a72b02b3fc7f7 msgid "" "**Fixed** `4575 `_: Bug " "with IRect contains method" msgstr "" #: ../../../changes.txt:97 80940db1fc98463084fb0536e2a74c75 msgid "Class Shape is now available as pymupdf.Shape." msgstr "" #: ../../../changes.txt:98 8d3cbad84fc7406db910769a9e0c49cd msgid "Added table cell markdown support." msgstr "" #: ../../../changes.txt:101 979c685df84c433a99b2ce9a6192393e msgid "**Changes in version 1.26.2**" msgstr "" #: ../../../changes.txt:103 6253d76480234ecb99ef69856e2e4d7c msgid "[Skipped.]" msgstr "" #: ../../../changes.txt:106 696d62b448d042d7ac4c9ae344c9357e msgid "**Changes in version 1.26.1 (2025-06-11)**" msgstr "" #: ../../../changes.txt:108 97fd68cacc0d460ea6453d0f75969b06 msgid "Use MuPDF-1.26.2." msgstr "" #: ../../../changes.txt:112 f027534ba7294a6e8c8c22e759448323 msgid "" "**Fixed** `4520 `_: " "show_pdf_page does not like empty pages created by new_page" msgstr "" #: ../../../changes.txt:113 065f392247ae490ab226f1104d666ddc msgid "" "**Fixed** `4524 `_: " "fitz.get_text ignores 'pages' kwarg" msgstr "" #: ../../../changes.txt:114 ../../../changes.txt:137 #: 1c6997f9c6d7494ba9b55c63784e99cf c6a83f4370734e42a4528f25014f39ab msgid "" "**Fixed** `4412 `_: " "Regression? Spurious error? in insert_pdf in v1.25.4" msgstr "" #: ../../../changes.txt:115 bb0e76951378470a8d36dd42e908266d msgid "" "**Fixed** `4496 `_: " "pymupdf4llm with pymupdfpro" msgstr "" #: ../../../changes.txt:119 87089d7b25b9490a95ea7686681487c8 msgid "" "Partial fix for `4503 `_:" " Undetected character styles" msgstr "" #: ../../../changes.txt:120 ce6c18a243de4e81b72c53d4fefd499e msgid "" "New method `Document.rewrite_images()`, useful for reducing file size, " "changing image formats, or converting color spaces." msgstr "" #: ../../../changes.txt:121 0a3a89d09fd3461ca2a27fcca8f185ed msgid "`Page.get_text()`: restrict positional args to match docs." msgstr "" #: ../../../changes.txt:122 1a528cc8a62e43639f658f1f709590c9 msgid "Removed bogus definition of class `Shape`." msgstr "" #: ../../../changes.txt:123 552b40dd8819435dad4a76eae858df20 msgid "" "Removed release date from module, docs and changelog. * " "`pymupdf.pymupdf_date` and `pymupdf.VersionDate` are now both None. * " "They will be removed in a future release." msgstr "" #: ../../../changes.txt:128 158c863781294c5c93e9b0a8c8e1f847 msgid "**Changes in version 1.26.0 (2025-05-22)**" msgstr "" #: ../../../changes.txt:130 18567733eef64ab68965ed498958d670 msgid "Use MuPDF-1.26.1." msgstr "" #: ../../../changes.txt:134 4ea8e6ad2e414e978386c33aad8021d5 msgid "" "**Fixed** `4324 `_: " "cluster_drawings() fails to cluster horizontal and vertical thin lines" msgstr "" #: ../../../changes.txt:135 17554e87f7084cacb19d789d4694754f msgid "" "**Fixed** `4363 `_: " "Trouble with searching" msgstr "" #: ../../../changes.txt:136 2cb8333bfa3948d0a1e1df290b275159 msgid "" "**Fixed** `4404 `_: " "IndexError in page.get_links()" msgstr "" #: ../../../changes.txt:138 3fb86dc38b76431f8fa289ed24574576 msgid "" "**Fixed** `4423 `_: " "pymupdf.mupdf.FzErrorFormat: code=7: cannot find object in xref error " "encountered after version 1.25.3" msgstr "" #: ../../../changes.txt:139 e4d0ca8ddf164f08b449dac3a6fa04fa msgid "" "**Fixed** `4435 `_: " "get_pixmap method stuck on one page" msgstr "" #: ../../../changes.txt:140 73d115f25755496680f56c79674a6351 msgid "" "**Fixed** `4439 `_: New " "Xml class from data does not work - bug in code" msgstr "" #: ../../../changes.txt:141 b25d62127fea4feaa5d944e835c2a666 msgid "" "**Fixed** `4445 `_: " "Broken XREF table incorrectly repaired" msgstr "" #: ../../../changes.txt:142 a0a2ed6ac1354febb9da6afd02bc9b42 msgid "" "**Fixed** `4447 `_: " "Stroke color of annotations cannot be correctly set" msgstr "" #: ../../../changes.txt:143 616298c000ad48cdbc628ef4cdd172d8 msgid "" "**Fixed** `4479 `_: " "set_layer_ui_config() toggles all layers rather than just one" msgstr "" #: ../../../changes.txt:144 b15ec1ffa6f0419c8b5503c50587840c msgid "" "**Fixed** `4505 `_: " "Follow Widget flag values up its parent structure" msgstr "" #: ../../../changes.txt:148 7b7ea93f30ca49f88b45b05c08ecf10f msgid "" "Partial fixed for `4457 " "`_: Wrong characters " "displayed after font subsetting (w/ native method)" msgstr "" #: ../../../changes.txt:149 b0ae6f4b0bc24e12bd0071f22e599e11 msgid "Support image stamp annotations." msgstr "" #: ../../../changes.txt:150 f5f7682cfc6c4abba06ebd809edf0795 msgid "Support recoloring pages." msgstr "" #: ../../../changes.txt:151 01a95f3b08944431b06a9d2e99e50bdf msgid "" "Added example of using Django's file storage API to open files with " "pymupdf." msgstr "" #: ../../../changes.txt:152 1ea4d799a2714c90a3ad74a4f03f1ed8 msgid "" "Clarified FreeText annotation color options. We now raise an exception if" " an attempt is made to set attributes that can not be supported." msgstr "" #: ../../../changes.txt:154 856acd8f3343442bb8ee7254e8b8d062 msgid "Fixed potential segv in Pixmap.is_unicolor()." msgstr "" #: ../../../changes.txt:155 90dbf6ef976a4d76a799854a5aa774dc msgid "" "Added runtime assert that that PyMuPDF and MuPDF were built with " "compatible NDEBUG settings (related to `4390 " "`_)." msgstr "" #: ../../../changes.txt:157 0862256c36d142c48444aab07763f645 msgid "Simplified handling of filename/filetype when opening documents." msgstr "" #: ../../../changes.txt:158 5e85ed11581b46daaf1a09b8a22dcccb msgid "" "Removed PDF linearization support. * Calls to `Document.save()` with " "`linear` set to true will now raise an exception. * See " "https://artifex.com/blog/mupdf-removes-linearisation for more " "information." msgstr "" #: ../../../changes.txt:162 c7ce1a9bb27545978d6d1d9fed1a4524 msgid "**Changes in version 1.25.5 (2025-03-31)**" msgstr "" #: ../../../changes.txt:166 9548bbf70ba9469e8b935a45f29643ed msgid "" "**Fixed** `4372 `_: Text " "insertion fails due to missing /Resources object" msgstr "" #: ../../../changes.txt:167 f76e7622a9d7433db1b7b82bc7156145 msgid "" "**Fixed** `4400 `_: " "Infinite loop in fill_textbox" msgstr "" #: ../../../changes.txt:168 82f33cb8a6d34f62b854eca17a8c4254 msgid "" "**Fixed** `4403 `_: " "Unable to get_text() - layer/clip nesting too deep" msgstr "" #: ../../../changes.txt:169 84b7b13060424773820d4994525080dc msgid "" "**Fixed** `4415 `_: PDF " "page is mirrored, origin is at bottom-left" msgstr "" #: ../../../changes.txt:173 74a4792d6a8244eb9dcae4beb4bfe0ee msgid "Use MuPDF-1.25.6." msgstr "" #: ../../../changes.txt:174 d248e14b8c1a4e3fab6235c3cf5c614c msgid "Fixed MuPDF SEGV on MacOS with particular fonts." msgstr "" #: ../../../changes.txt:175 82ea9eb171144077a7870ae7a0b9eeb7 msgid "Fixed `Annot.get_textpage()`'s `clip` arg." msgstr "" #: ../../../changes.txt:176 2fccc9761609452e9d10dac746b11059 msgid "Fixed Python-3.14 (pre-release) build error." msgstr "" #: ../../../changes.txt:179 2fbd0061abcd475fafe6ef6a570e0d7a msgid "**Changes in version 1.25.4 (2025-03-14)**" msgstr "" #: ../../../changes.txt:181 9fa9e7eec7694807a4577e93e3fdb54e msgid "Use MuPDF-1.25.5." msgstr "" #: ../../../changes.txt:185 8f7a4be455684495af9c8e17de5ad09d msgid "" "**Fixed** `4079 `_: " "Unexpected result for apply_redactions()" msgstr "" #: ../../../changes.txt:186 6d876027b2104b01830654bbbae308e9 msgid "" "**Fixed** `4224 `_: MuPDF" " error: format error: negative code in 1d faxd" msgstr "" #: ../../../changes.txt:187 b7b89a62c35d4608987e21ec0f356173 msgid "" "**Fixed** `4303 `_: " "page.get_image_info() returns outdated cached results after replacing " "image" msgstr "" #: ../../../changes.txt:188 8b5c375bcfc24c81a1ab34fdfe2e3f87 msgid "" "**Fixed** `4309 `_: " "FzErrorFormat Error When Deleting First Page" msgstr "" #: ../../../changes.txt:189 33ebf7622662470e98f52b0e0681e4b1 msgid "" "**Fixed** `4336 `_: Major" " Performance Regression: pix.color_count is 150x slower in version 1.25.3" " compared to 1.23.8" msgstr "" #: ../../../changes.txt:190 159061230d824914a6d19ad6d73eeb7c msgid "" "**Fixed** `4341 `_: " "Invalid label retrieval when /Kids is an array of multiple /Nums" msgstr "" #: ../../../changes.txt:194 37e49743f93f41d9bf5880142941c864 msgid "Fixed handling of duplicate widget names when joining PDFs (PR #4347)." msgstr "" #: ../../../changes.txt:195 0cac0025172c4dd5baf122fc076da58e msgid "Improved Pyodide build." msgstr "" #: ../../../changes.txt:196 638ca0a27dd548cfa15a4095bd238671 msgid "" "Avoid SWIG-related build errors with Python-3.13 by disabling " "PY_LIMITED_API." msgstr "" #: ../../../changes.txt:199 24df824cc0ed4dcaa55266a462308f72 msgid "**Changes in version 1.25.3 (2025-02-06)**" msgstr "" #: ../../../changes.txt:201 86fbdb38e3ab475cb35bce8474a0517d msgid "Use MuPDF-1.25.4." msgstr "" #: ../../../changes.txt:205 11404e9f065f46d48c17de3eb0a56b4c msgid "" "**Fixed** `4139 `_: Text " "color numbers change between 1.24.14 and 1.25.0" msgstr "" #: ../../../changes.txt:206 f54ac127378c40efbea689f95f729a3d msgid "" "**Fixed** `4141 `_: Some " "insertion methods fails for pages without a /Resources object" msgstr "" #: ../../../changes.txt:207 1debce8303bb430aaf3c754c31d4e54a msgid "" "**Fixed** `4180 `_: " "Search problems" msgstr "" #: ../../../changes.txt:208 a43078709b894315ab60ab8c8077d919 msgid "" "**Fixed** `4182 `_: Text " "coordinate extraction error" msgstr "" #: ../../../changes.txt:209 2aa654ea699a4754864254e38097fcf4 msgid "" "**Fixed** `4245 `_: " "Highlighting issue distorted on recent versions" msgstr "" #: ../../../changes.txt:210 568c972326294ecab31a4378aee8aef3 msgid "" "**Fixed** `4254 `_: " "add_freetext_annot is drawing text outside the annotation box" msgstr "" #: ../../../changes.txt:214 3b1e13a8a53f41568994b6b10d784dd4 msgid "" "In annotations: * Added support for subtype FreeTextCallout. * Added " "support for rich text." msgstr "" #: ../../../changes.txt:217 20ad825019bc421aa9fa359d4c2cf2b9 msgid "" "Added miter_limit arg to insert_text*() to allow suppression of spikes " "caused by long miters." msgstr "" #: ../../../changes.txt:218 d8f3a5bd962d420482fbab442a82a337 msgid "Add Widget Support to `Document.insert_pdf()`." msgstr "" #: ../../../changes.txt:219 b25922bccda743b4a462eff61aa2da32 msgid "Add `bibi` to span dicts." msgstr "" #: ../../../changes.txt:220 16e4de5888954261941fe67d4f618949 msgid "Add `synthetic' to char dict." msgstr "" #: ../../../changes.txt:221 ../../../changes.txt:963 #: 2b958160bd134274b90ba5bd456e66c5 43a26b5aad0e4fe485acf6a41282f421 msgid "Fixed Pyodide builds." msgstr "" #: ../../../changes.txt:224 f65069a7584b4f128fa5b7cc86d526ab msgid "**Changes in version 1.25.2 (2025-01-17)**" msgstr "" #: ../../../changes.txt:228 af70ce0fc1a74152b86dbd49d309fdb9 msgid "" "**Fixed** `4055 `_: " "\"Yes\" for all checkboxes does not work for all PDF rendering engines." msgstr "" #: ../../../changes.txt:229 4410d36a900d450c97588b75ccb21628 msgid "" "**Fixed** `4155 `_: " "samples_mv is unsafe" msgstr "" #: ../../../changes.txt:230 61173d64746b46848303884ad4f7c6c2 msgid "" "**Fixed** `4162 `_: Got " "AttributeError, when tried to add Signature field" msgstr "" #: ../../../changes.txt:231 ade3c33dc1bc4fe5a6c9c79ad335b6ca msgid "" "**Fixed** `4186 `_: " "Incorrect handling of JPEG with color space CMYK image extraction" msgstr "" #: ../../../changes.txt:232 b0f948dd2aec4196879b796a7083ce66 msgid "" "**Fixed** `4195 `_: " "Pixmaps that are inverted and have an alpha channel are not rendered " "properly" msgstr "" #: ../../../changes.txt:233 f983aaf8e72b40329ef333edb032482d msgid "" "**Fixed** `4225 `_: " "pixmap.pil_save() fails due to colorspace definition" msgstr "" #: ../../../changes.txt:234 b9f784c7a8e347f0839af27a4aee0957 msgid "" "**Fixed** `4232 `_: " "Incorrect Font style and Size" msgstr "" #: ../../../changes.txt:238 46a2de9de8a84001a08386537fad1cb6 msgid "Use Python's built-in glyphname <> unicode conversion." msgstr "" #: ../../../changes.txt:239 98aaf3100ca44c3eb46b239c085990ce msgid "Improve speed of pixmap color inversion." msgstr "" #: ../../../changes.txt:240 761c1030615e4b9f8837990276cdd4aa msgid "" "Add new `char_flags` member to span dictionary, for example allows " "detection of invisible text." msgstr "" #: ../../../changes.txt:241 26863d989def4dd6b375f90f90ac816a msgid "Detect image masks in TextPage output." msgstr "" #: ../../../changes.txt:242 c106eb1531f34065ac0918f8967d868c msgid "Added `Pixmap.pil_image()`." msgstr "" #: ../../../changes.txt:245 f2917761f4f342b2b20eb583e456ac86 msgid "**Changes in version 1.25.1 (2024-12-11)**" msgstr "" #: ../../../changes.txt:247 5d2a2817fc15439e8cff5b48d2993934 msgid "Use MuPDF-1.25.2." msgstr "" #: ../../../changes.txt:251 1aa29c8b332c4f06b69b0f5c16618fed msgid "" "**Fixed** `4125 `_: " "memory leak while convert Pixmap's colorspace" msgstr "" #: ../../../changes.txt:252 6619cbba93b64266b96af9f2fb26333c msgid "" "**Fixed** `4034 `_: " "Possible regression in pdf cleaning during save." msgstr "" #: ../../../changes.txt:255 54ab8ad1ec3246298a9019b2227a46d8 msgid "**Changes in version 1.25.0 (2024-12-05)**" msgstr "" #: ../../../changes.txt:257 0a8714b7f18e45878f7b252f8af10ade msgid "Use MuPDF-1.25.1." msgstr "" #: ../../../changes.txt:261 686ebe75128d4be9b77bba0ddb563a43 msgid "" "**Fixed** `4026 `_: " "page.get_text('blocks') output two piece of very similar text with " "different bbox" msgstr "" #: ../../../changes.txt:262 efd9decd0d2a4a319ebd830a2c8531bd msgid "" "**Fixed** `4004 `_: " "Segmentation Fault When Updating PDF Form Field Value" msgstr "" #: ../../../changes.txt:263 ebdb384bd8e4477d80b10127b014145b msgid "" "**Fixed** `3887 `_: " "Subset Fonts problem using Fallback Font" msgstr "" #: ../../../changes.txt:264 e63e1845d9fb45198345afaff67f30e1 msgid "" "**Fixed** `3886 `_: " "Another issue with destroying PDF when inserting html" msgstr "" #: ../../../changes.txt:265 50adbcf9a18043e68b84aa9286698361 msgid "" "**Fixed** `3751 `_: " "apply_redactions causes part of the page content to be hidden / " "transparent" msgstr "" #: ../../../changes.txt:270 09e722df03fa4db18c4e0da832e997f7 msgid "**Changes in version 1.24.14 (2024-11-19)**" msgstr "" #: ../../../changes.txt:272 cb8ebd6072bd4e11919080375887f166 msgid "Use MuPDF-1.24.11." msgstr "" #: ../../../changes.txt:276 50b663786ee641cb9687580189342f8d msgid "" "**Fixed** `3448 `_: " "get_pixmap function removes the table and leaves just the content behind" msgstr "" #: ../../../changes.txt:277 54321b37a7f9420b8567fbb6d1e426a4 msgid "" "**Fixed** `3758 `_: Got " "\"malloc(): unaligned tcache chunk detected Aborted (core dumped)\" while" " using add_redact_annot/apply_redactions" msgstr "" #: ../../../changes.txt:278 296dc7d294134423a31f7b6d74f2aeaf msgid "" "**Fixed** `3813 `_: " "Stories: Ordered list count broken with nested unordered list" msgstr "" #: ../../../changes.txt:279 2215310351ca46c1a25a514468a905a8 msgid "" "**Fixed** `3933 `_: " "font.valid_codepoints() - malfunction" msgstr "" #: ../../../changes.txt:280 ff0631f5b7054df4b90b9fa8739b4ec1 msgid "" "**Fixed** `4018 `_: " "PyMuPDF hangs when iterating over zero page PDF pages backwards" msgstr "" #: ../../../changes.txt:281 a2a87af3e4c84a6abc63ea9d9e914391 msgid "" "**Fixed** `4043 `_: " "fullcopypage bug" msgstr "" #: ../../../changes.txt:282 55686d0fa4674d4299310ada01d1735d msgid "" "**Fixed** `4047 `_: " "Segmentation Fault in add_redact_annot" msgstr "" #: ../../../changes.txt:283 0c2e617044914d04b642de2fa1587abb msgid "" "**Fixed** `4050 `_: " "Content of dict returned by doc.embfile_info() does not fit to " "documentation" msgstr "" #: ../../../changes.txt:287 1bb6617fc61d474c946dbf47c807e5d8 msgid "" "Ensure that words from `Page.get_text()` never contain RTL/LTR char " "mixtures." msgstr "" #: ../../../changes.txt:288 2171b4b55a384da393be21b8cef7cd46 msgid "Fix building with system MuPDF." msgstr "" #: ../../../changes.txt:289 1b697fc68ecb486aa3b482711dd06c98 msgid "Add dot product for points and vectors." msgstr "" #: ../../../changes.txt:292 b3aa2aa2bfbc4c9ba5c5d2c84a823910 msgid "**Changes in version 1.24.13 (2024-10-29)**" msgstr "" #: ../../../changes.txt:296 532324021bbe48718cffa19ecedb034c msgid "" "**Fixed** `3848 `_: " "Piximap program crash" msgstr "" #: ../../../changes.txt:297 ../../../changes.txt:308 #: 2387d394753a42ad872fa2268d7e9a29 cb2a797b491348f58ab3ce4ba98b73d9 msgid "" "**Fixed** `3950 `_: " "Unable to consistently extract field labels from PDFs" msgstr "" #: ../../../changes.txt:298 51536c1106ea45ac9444978b1684c0c1 msgid "" "**Fixed** `3981 `_: " "PyMuPDF 1.24.12 with pyinstaller throws error." msgstr "" #: ../../../changes.txt:299 f44e8a92c6004f9f8c5c59b80ddbf558 msgid "" "**Fixed** `3994 `_: " "pix.color_topusage raise Segmentation fault (core dumped)" msgstr "" #: ../../../changes.txt:302 6bd1fa6f738340babc3df986bdc5a0a5 msgid "**Changes in version 1.24.12 (2024-10-21)**" msgstr "" #: ../../../changes.txt:306 5174733bb6794f2b8c431f53170d0267 msgid "" "**Fixed** `3914 `_: " "Ability to print MuPDF errors to logging instead of stdout" msgstr "" #: ../../../changes.txt:307 78495d3820584622819a2d243eabe922 msgid "" "**Fixed** `3916 `_: " "insert_htmlbox error: int too large to convert to float" msgstr "" #: ../../../changes.txt:310 dc5a73b307bb45128375b3e45f21f804 msgid "Supported Python versions are now 3.9-3.13." msgstr "" #: ../../../changes.txt:312 7fa696ad2ff84d4fb6204d9eeaa72eec msgid "Dropped support for Python-3.8 because end-of-life." msgstr "" #: ../../../changes.txt:313 2be21c1bbf164eb88dd5059514d52c40 msgid "Added support for Python-3.13 because now released." msgstr "" #: ../../../changes.txt:314 a07d59ffaf6a48c8827e65b703ee0856 msgid "See: https://devguide.python.org/versions/" msgstr "" #: ../../../changes.txt:317 d5600d2cd45b4009ba4eb42289cee550 msgid "**Changes in version 1.24.11 (2024-10-03)**" msgstr "" #: ../../../changes.txt:319 9d700953907b44fe86d10f2023bda708 msgid "Use MuPDF-1.24.10." msgstr "" #: ../../../changes.txt:323 808cd9169aeb4de68aaf51afd0fbff17 msgid "" "**Fixed** `3624 `_: Pdf " "file transform to image have a black block" msgstr "" #: ../../../changes.txt:324 8f414ff010194b2abb249bd69290b7a1 msgid "" "**Fixed** `3859 `_: " "doc.need_appearances() fails with \"AttributeError: module " "'pymupdf.mupdf' has no attribute 'PDF_TRUE' \"" msgstr "" #: ../../../changes.txt:325 144003ab4e5743f1a5a6728e0d572424 msgid "" "**Fixed** `3863 `_: " "apply_redactions() does not work as expected" msgstr "" #: ../../../changes.txt:326 dd7478f2b06449c48d6b3c1bda073aa9 msgid "" "**Fixed** `3905 `_: open " "stream can raise a FzErrorFormat error instead of FileDataError" msgstr "" #: ../../../changes.txt:328 bf8693cc8c1349408cbd9fc992ea196e msgid "Wheels now use the Python Stable ABI:" msgstr "" #: ../../../changes.txt:330 efc06a4c0fd84a09a008423f67eee13e msgid "There is one PyMuPDF wheel for each platform." msgstr "" #: ../../../changes.txt:331 4c8dea397efc48d68f2a64b021c76ed0 msgid "Each wheel works with all supported Python versions." msgstr "" #: ../../../changes.txt:332 1c41329749a64d22b3f9e3b61036f38c msgid "" "Each wheel is built using the oldest supported Python version (currently " "3.8)." msgstr "" #: ../../../changes.txt:333 2e864bd74a2f4ef98e175a1e44fec4df msgid "There is no PyMuPDFb wheel." msgstr "" #: ../../../changes.txt:337 aa491896b5e04bd582e529c840ead400 msgid "Improvements to get_text_words() with sort=True." msgstr "" #: ../../../changes.txt:338 283df97df8874c3fa38c6c9a57f6af06 msgid "Tests now always get the latest versions of required Python packages." msgstr "" #: ../../../changes.txt:339 f6a1523241f54a9ba84dfed4f6dde3b2 msgid "Removed dependency on setuptools." msgstr "" #: ../../../changes.txt:340 1596796af81b476e80835455e0a27a29 msgid "Added item to PyMuPDF-1.24.10 changes below - fix of #3630." msgstr "" #: ../../../changes.txt:343 0d1ea2fa95e1430a91731b5c309c154f msgid "**Changes in version 1.24.10 (2024-09-02)**" msgstr "" #: ../../../changes.txt:345 0fdb57593f1f47f78b61e459d90c4fd0 msgid "Use MuPDF-1.24.9." msgstr "" #: ../../../changes.txt:349 4c1b818189074d939767d48fa6ba40e6 msgid "" "**Fixed** `3450 `_: " "get_pixmap function takes too long to process" msgstr "" #: ../../../changes.txt:350 03bc289e1528407b8433671ea3e5587e msgid "" "**Fixed** `3569 `_: " "Invalid OCGs not ignored by SVG image creation" msgstr "" #: ../../../changes.txt:351 3e64094a0a16437ab1fceb4fd8904883 msgid "" "**Fixed** `3603 `_: " "ObjStm compression and PDF linearization doesn't work together" msgstr "" #: ../../../changes.txt:352 4a6c4d95199b49919c2ec7b76da32a3a msgid "" "**Fixed** `3650 `_: " "Linebreak inserted between each letter" msgstr "" #: ../../../changes.txt:353 a5fb10f857014368871b0ee0628a1ef1 msgid "" "**Fixed** `3661 `_: " "Update Document to check the /XYZ len" msgstr "" #: ../../../changes.txt:354 77892cd87ca346d381b0b249574312b4 msgid "" "**Fixed** `3698 `_: " "documentation issue - old code in the annotations documentation" msgstr "" #: ../../../changes.txt:355 8a4df3770f95440c870288e5f497cf93 msgid "" "**Fixed** `3705 `_: " "Document.select() behaves weirdly in some particular kind of pdf files" msgstr "" #: ../../../changes.txt:356 575c721454394ef5954021b2e3910c5a msgid "" "**Fixed** `3706 `_: " "extend Document.__getitem__ type annotation to reflect that the method " "also accepts slices" msgstr "" #: ../../../changes.txt:357 b4081c4845a3495cab35195cfcbd4e5f msgid "" "**Fixed** `3727 `_: " "Method get_pixmap() make the program exit without any exceptions or " "messages" msgstr "" #: ../../../changes.txt:358 4a582d7cc3ca40cfba3314faa5800f56 msgid "" "**Fixed** `3767 `_: " "Cannot get Tessdata with Tesseract-OCR 5" msgstr "" #: ../../../changes.txt:359 9a3c4b91a07e4c118de884a8c386dcfb msgid "" "**Fixed** `3773 `_: " "Link.set_border gives TypeError: '<' not supported between instances of " "'NoneType' and 'int'" msgstr "" #: ../../../changes.txt:360 d3028f61318447b68e56290fbd6732cc msgid "" "**Fixed** `3774 `_: " "fitz.__version__` does not work anymore" msgstr "" #: ../../../changes.txt:361 596c2f50505948db9e84f139ffaea8fa msgid "" "**Fixed** `3789 `_: " "ValueError: not enough values to unpack (expected 3, got 2) is thrown " "when call insert_pdf" msgstr "" #: ../../../changes.txt:362 e99c3b3c69d1484f8ea0b97279da22e4 msgid "" "**Fixed** `3820 `_: class" " improves namedDest handling" msgstr "" #: ../../../changes.txt:364 9c63afe342914710a2f4b27172881a97 msgid "" "**Fixed** `3630 `_: " "page.apply_redactions gives unwanted black rectangle" msgstr "" #: ../../../changes.txt:368 a69ca8bf39fc49c78509e477fc16ec48 msgid "" "Object streams and linearization cannot be used together; attempting to " "do so will raise an exception. (#3603)" msgstr "" #: ../../../changes.txt:370 d667244f9aa14f1d8b25176a013989e0 msgid "Fixed handling of non-existing /Contents object." msgstr "" #: ../../../changes.txt:373 007020c8bc19452da4cd657fdcba20c0 msgid "**Changes in version 1.24.9 (2024-07-24)**" msgstr "" #: ../../../changes.txt:375 3025163fadb648e88e840b5f088e6d56 msgid "Use MuPDF-1.24.8." msgstr "" #: ../../../changes.txt:378 259a038beea8413baaac6ee36c977d21 msgid "**Changes in version 1.24.8 (2024-07-22)**" msgstr "" #: ../../../changes.txt:382 a3d2403d008e4902bda8c294e7d5b193 msgid "" "**Fixed** `3636 `_: API " "documentation for the open function is not obvious to find." msgstr "" #: ../../../changes.txt:383 eb0f33456dca477bb49123d26150dbd5 msgid "" "**Fixed** `3654 `_: docx " "parsing was broken in 1.24.7" msgstr "" #: ../../../changes.txt:384 6c8df8e668094aef8d31035e9dc0e65d msgid "" "**Fixed** `3677 `_: " "Unable to extract subset font name using the newer versions of PyMuPDF : " "1.24.6 and 1.24.7." msgstr "" #: ../../../changes.txt:385 c5b0babed39f440d99efdd7a90d63f4b msgid "" "**Fixed** `3687 `_: " "Page.get_text results in AssertionError for epub files" msgstr "" #: ../../../changes.txt:389 e245fedf7bb24e8d92d8116cb00ad30e msgid "Fixed various spelling mistakes spotted by codespell." msgstr "" #: ../../../changes.txt:390 764d9b752f59499e856f560908cee6d9 msgid "Improved how we modify MuPDF's default configuration on Windows." msgstr "" #: ../../../changes.txt:391 6e8cb04f867c4ad59e8be783e217fc4d msgid "Make text search to work with ligatures." msgstr "" #: ../../../changes.txt:394 25efadfa996341b38552789392dbaf74 msgid "**Changes in version 1.24.7 (2024-06-26)**" msgstr "" #: ../../../changes.txt:398 fa9eea5710484750bedce90cc64b9daf msgid "" "**Fixed** `3615 `_: " "Document.pagemode or Document.pagelayout crashes for epub files" msgstr "" #: ../../../changes.txt:399 795aad875dfc458eb4a6c99bccde0cec msgid "" "**Fixed** `3616 `_: not " "last version reported" msgstr "" #: ../../../changes.txt:402 b75b54baeb764ed5bfca7d9290d654f6 msgid "**Changes in version 1.24.6 (2024-06-25)**" msgstr "" #: ../../../changes.txt:404 ce8d669017974969859f4cf2c64c5c09 msgid "Use MuPDF-1.24.4" msgstr "" #: ../../../changes.txt:408 f726a1ab74364bca9e9f707167e9d0af msgid "" "**Fixed** `3599 `_: " "Story.fit_width() has a weird line" msgstr "" #: ../../../changes.txt:409 8e99b98271ea423bb26bb068ec39ea52 msgid "" "**Fixed** `3594 `_: " "Garbled extraction for Amazon Sustainability Report" msgstr "" #: ../../../changes.txt:410 651a15f12d5043b6b328618180353f68 msgid "" "**Fixed** `3591 `_: " "'width' in Page.get_drawings() returns width equal as 0" msgstr "" #: ../../../changes.txt:411 02fe36631c264c87895576864dc44e43 msgid "" "**Fixed** `3561 `_: " "ZeroDivisionError: float division by zero with page.apply_redactions()" msgstr "" #: ../../../changes.txt:412 99db39151ed74f9d97810a41633d73e2 msgid "" "**Fixed** `3559 `_: " "SegFault 11 when empty H1 H2 H3 H4 etc element is used in insert_htmlbox" msgstr "" #: ../../../changes.txt:413 5e95ed936be0415c95c278cf1d1a9999 msgid "" "**Fixed** `3539 `_: Add " "dotted gridline detection to table recognition" msgstr "" #: ../../../changes.txt:414 75ffb0d518004dc2a74244b12b6c97bd msgid "" "**Fixed** `3519 `_: " "get_toc(simple=False) AttributeError: 'Outline' object has no attribute " "'rect'" msgstr "" #: ../../../changes.txt:415 495d1b01dfb7457ebb231eca62c7c539 msgid "" "**Fixed** `3510 `_: " "page.get_label() gets wrong label on the first page of doc" msgstr "" #: ../../../changes.txt:416 60f43a90ceb845b2adf2947634af64ac msgid "" "**Fixed** `3494 `_: " "1.24.2/1.24.3: spurious characters introduced when using subset_fonts and" " insert_pdf" msgstr "" #: ../../../changes.txt:417 a4e0010c0d8f45beaae70809abc81039 msgid "" "**Fixed** `3470 `_: " "subset_fonts error exit without exception/warning" msgstr "" #: ../../../changes.txt:418 99fd9bbe5dba43aa9c040b3a77aee77c msgid "" "**Fixed** `3400 `_: " "set_toc alters link coordinates for some rotated pages on pymupdf 1.24.2" msgstr "" #: ../../../changes.txt:419 82687af929194a6dbf9c19ea545b5e0b msgid "" "**Fixed** `3347 `_: " "Incorrect links to points on pages having different heights" msgstr "" #: ../../../changes.txt:420 340ce003832a4bf4a832ae0623c2ac19 msgid "" "**Fixed** `3237 `_: " "Set_metadata() does not work" msgstr "" #: ../../../changes.txt:421 ce983433667f4f27a675ad0f4ab90de8 msgid "" "**Fixed** `3493 `_: " "Isolate PyMuPDF from other libraries; issues when PyMuPDF is loaded with " "other libraries like GdkPixbuf" msgstr "" #: ../../../changes.txt:425 85db5876f5884fdb94a243fa8cea3bb5 msgid "" "Fixed concurrent use of PyMuPDF caused by use of constant temporary " "filenames." msgstr "" #: ../../../changes.txt:427 7bc8d5be62d24850bd1a2d0b042c5dc7 msgid "Add musllinux x86_64 wheels to release." msgstr "" #: ../../../changes.txt:429 8442053275014be3a2961c23d5c1e875 msgid "Added clearer version information:" msgstr "" #: ../../../changes.txt:431 898d54fe7f294059a365ce4df283fa8e msgid "`pymupdf.pymupdf_version`." msgstr "" #: ../../../changes.txt:432 e17b0b91f04f41c49b685ec88163c914 msgid "`pymupdf.mupdf_version`." msgstr "" #: ../../../changes.txt:433 b2b4d699826c44f3b82cbbffd7b8134e msgid "`pymupdf.pymupdf_date`." msgstr "" #: ../../../changes.txt:436 0641d353405748829b979a38171a2825 msgid "**Changes in version 1.24.5 (2024-05-30)**" msgstr "" #: ../../../changes.txt:440 d9b804a172e24fa782e586380589a791 msgid "" "**Fixed** `3479 `_: " "regression: fill_textbox: IndexError: pop from empty list" msgstr "" #: ../../../changes.txt:441 d00ec180a30548e7bd1094a5ff22289b msgid "" "**Fixed** `3488 `_: " "set_toc method error" msgstr "" #: ../../../changes.txt:445 53a42d7778c84e85ab793f4fc54ce4e8 msgid "Some more fixes to use MuPDF floating formatting." msgstr "" #: ../../../changes.txt:446 8feda6eedae84994a727c20e7a2336be msgid "Removed/disabled some unnecessary diagnostics." msgstr "" #: ../../../changes.txt:447 e96bd409e11d432aa398f8aeedd58c7a msgid "Fixed utils.do_links() crash." msgstr "" #: ../../../changes.txt:448 24e4d4aed05840ea9abe1c2c2805be34 msgid "" "Experimental new functions `pymupdf.apply_pages()` and " "`pymupdf.get_text()`." msgstr "" #: ../../../changes.txt:449 b8a6f1cfb64748d79bc0b69465631b51 msgid "Addresses wrong label generation for label styles \"a\" and \"A\"." msgstr "" #: ../../../changes.txt:452 0ba74ae644a1428d89fe14ef6b0babee msgid "**Changes in version 1.24.4 (2024-05-16)**" msgstr "" #: ../../../changes.txt:454 8347374b5a5e45b28a7f8f4afb292726 msgid "" "**Fixed** `3418 `_: Re-" "introduced bug, text align add_redact_annot" msgstr "" #: ../../../changes.txt:455 cb6d95a9123f4086b6ac158e88717571 msgid "" "**Fixed** `3472 `_: " "insert_pdf gives SystemError" msgstr "" #: ../../../changes.txt:459 c0361428884345bf8531a84f4780ea38 msgid "" "Fixed sysinstall test failing to remove all of prior installation before " "new install." msgstr "" #: ../../../changes.txt:461 5889a769a9d6497db5651e5de06b452c msgid "Fixed `utils.do_links()` crash." msgstr "" #: ../../../changes.txt:462 18689db9f7b34a0aada6aabae6348c36 msgid "Correct `TextPage` creation Code." msgstr "" #: ../../../changes.txt:463 47ec7c100c6c4cb89c0c9032e653d85d msgid "Unified various diagnostics." msgstr "" #: ../../../changes.txt:464 0ad11e95e8244ebab3b4e28a268c3b58 msgid "Fix bug in `page_merge()`." msgstr "" #: ../../../changes.txt:467 b8f39f2e163741529a0c07525b38ee4e msgid "**Changes in version 1.24.3 (2024-05-09)**" msgstr "" #: ../../../changes.txt:470 cad11f9fca1541eda51c5b1ddc360907 msgid "" "The Python module is now called `pymupdf`. `fitz` is still supported for " "backwards compatibility." msgstr "" #: ../../../changes.txt:473 26ab1d955ad94d82a842066be61b2b45 msgid "Use MuPDF-1.24.2." msgstr "" #: ../../../changes.txt:477 d78b4e742a1540d795b9023df668616a msgid "" "**Fixed** `3357 `_: " "PyMuPDF==1.24.0 will hanging when using page.get_text(\"text\")" msgstr "" #: ../../../changes.txt:478 d3a781ba5c1b4e4ea729e32165591767 msgid "" "**Fixed** `3376 `_: " "Redacting results are not as expected in 1.24.x." msgstr "" #: ../../../changes.txt:479 9d45832a290b4dec88aff88537dbbde6 msgid "" "**Fixed** `3379 `_: " "Documentation mismatch for get_text_blocks return value order." msgstr "" #: ../../../changes.txt:480 fb62ce84c5d24c1b802be0a91c9592fc msgid "" "**Fixed** `3381 `_: " "Contents stream contains floats in scientific notation" msgstr "" #: ../../../changes.txt:481 0862ddcf8e644d3ea7ac0a7c60de28d1 msgid "" "**Fixed** `3402 `_: " "Cannot add Widgets containing inter-field-calculation JavaScript" msgstr "" #: ../../../changes.txt:482 3d4f814eb5ec4e72a5adea1bd245b32f msgid "" "**Fixed** `3414 `_: " "missing attribute set_dpi()" msgstr "" #: ../../../changes.txt:483 cdcbe4b8d58544f0948c1b3c28f9b3d9 msgid "" "**Fixed** `3430 `_: " "page.get_text() cause process freeze with certain pdf on v1.24.2" msgstr "" #: ../../../changes.txt:487 ../../../changes.txt:509 #: 1034de3f71fc4bd187b3f046c83bedbe 8863ca296ccc4716b6f80e99291be2e5 msgid "New/modified methods:" msgstr "" #: ../../../changes.txt:489 8cea70e9366142759f75487402e703b3 msgid "" "`Page.remove_rotation()`: new, set page rotation to zero while keeping " "appearance." msgstr "" #: ../../../changes.txt:491 f1014ad8f9ec4d87968c7de24b7e7f70 msgid "Fixed some problems when checking for PDF properties." msgstr "" #: ../../../changes.txt:492 64cfa246e9094b0ebd62758e2eb3598f msgid "" "Fixed pip builds from sdist (see discussion `3360 " "`_: Alpine linux " "docker build failing \"No matching distribution found for " "pymupdfb==1.24.1\")." msgstr "" #: ../../../changes.txt:497 f8ef0c76081a402dbac0efa8b7644241 msgid "**Changes in version 1.24.2 (2024-04-17)**" msgstr "" #: ../../../changes.txt:499 bf95d9b1e5994a2091c8f66685f22854 msgid "" "Removed obsolete classic implementation from releases (previously " "available as module `fitz_old`)." msgstr "" #: ../../../changes.txt:504 4a87d3564d3d4cedae93e2b51349aaa2 msgid "" "**Fixed** `3331 `_: " "Document.pages() is incorrectly type-hinted" msgstr "" #: ../../../changes.txt:505 84e9e429e5af4263a7fd5db405b5842a msgid "" "**Fixed** `3354 `_: " "PyMuPDF==1.24.1: AttributeError: property 'metadata' of 'Document' object" " has no setter" msgstr "" #: ../../../changes.txt:511 818e26cf4c0f4ce08f1bf68e48eab8b0 msgid "`Document.bake()`: new, make annotations / fields permanent content." msgstr "" #: ../../../changes.txt:512 6a0b794fe12f4bb4a005a8f1bdc5c188 msgid "" "`Page.cluster_drawings()`: new, identifies drawing items (i.e. vector " "graphics or line-art) that belong together based on their geometrical " "vicinity." msgstr "" #: ../../../changes.txt:515 f1fb556a239a49e6b90a938b0360868a msgid "`Page.apply_redactions()`: added new parameter `text`." msgstr "" #: ../../../changes.txt:516 c47d84ec4dd34a6687719bcfafebdb25 msgid "" "`Document.subset_fonts()`: use MuPDF's `pdf_subset_fonts()` instead of " "PyMuPDF code." msgstr "" #: ../../../changes.txt:518 b56ff5e11e894337b35ae03c405c4666 msgid "The `Document` class now supports page numbers specified as slices." msgstr "" #: ../../../changes.txt:519 68a2d9fa6804400dbecc0e1d60d85280 msgid "Avoid causing MuPDF warnings." msgstr "" #: ../../../changes.txt:522 167f53146b304aaf9812103ca9c4e29c msgid "**Changes in version 1.24.1 (2024-04-02)**" msgstr "" #: ../../../changes.txt:526 9dcf0965da0a489cabf3d2ab88226762 msgid "" "**Fixed** `3278 `_: " "apply_redactions moves some unredacted text" msgstr "" #: ../../../changes.txt:527 c23c377d35194a0094bd6e4beab89d9d msgid "" "**Fixed** `3301 `_: Be " "more permissive when classifying links as kind LINK_URI" msgstr "" #: ../../../changes.txt:528 c6e16db559364535a9c002bd61adb627 msgid "" "**Fixed** `3306 `_: Text " "containing capital 'ET' not appearing as annotation" msgstr "" #: ../../../changes.txt:532 ae65e5dcbdbb47e7b6182ae2f1e35080 msgid "Use MuPDF-1.24.1." msgstr "" #: ../../../changes.txt:533 606e5f2a82694796b16017c9e6988751 msgid "" "Support ObjStm Compression. Methods `Document.save()`, " "`Document.ez_save()` and `Document.write()` now support new parameters " "`use_objstm`, compression_effort` and `preserve_metadata`." msgstr "" #: ../../../changes.txt:539 e0d826430dab4605843b857d55556f31 msgid "**Changes in version 1.24.0 (2024-03-21)**" msgstr "" #: ../../../changes.txt:543 56ae3cb3eae74794bf8c66f9478e1eaa msgid "" "**Fixed** `3281 `_: " "Preparing metadata (pyproject.toml) did not run successfully" msgstr "" #: ../../../changes.txt:544 c2af0005171741dfa062c48305fdff68 msgid "" "**Fixed** `3279 `_: " "PyMuPDF no longer builds in Alpine Linux" msgstr "" #: ../../../changes.txt:545 d9b6c05ed6004aca8f3189adad180c42 msgid "" "**Fixed** `3257 `_: " "apply_redactions() deleting text outside of annoted box" msgstr "" #: ../../../changes.txt:546 8baeb884a8f84d2fbf0d5b17af55639c msgid "" "**Fixed** `3216 `_: " "AttributeError: 'Annot' object has no attribute '__del__'" msgstr "" #: ../../../changes.txt:547 37068b47c21542ccbcc5d6326e7046f1 msgid "" "**Fixed** `3207 `_: " "get_drawings's items is missing line from h path operator" msgstr "" #: ../../../changes.txt:548 a4e36666ffbc4aca8006de811d305b60 msgid "" "**Fixed** `3201 `_: " "Memory leaks when merging PDFs" msgstr "" #: ../../../changes.txt:549 72cdc09b51ef425ab50c8aae8a380ce6 msgid "" "**Fixed** `3197 `_: " "page.get_text() returns hexadecimal text for some characters" msgstr "" #: ../../../changes.txt:550 055ea678a07b4991b05894009ada4484 msgid "" "**Fixed** `3196 `_: " "Remove text not working in 1.23.25 version vs 1.20.2" msgstr "" #: ../../../changes.txt:551 eebdd0d853a04d7890db0116aeda3b84 msgid "" "**Fixed** `3172 `_: PDF's" " 45º lines dissapearing in png conversion" msgstr "" #: ../../../changes.txt:552 fd48b5fe2cf74dbb8772e3ffda26cc5b msgid "" "**Fixed** `3135 `_: Do " "not log warnings to stdout" msgstr "" #: ../../../changes.txt:553 5a2c034748ca435d97157e0e01631edc msgid "" "**Fixed** `3125 `_: " "get_pixmap method stuck on one page and runs forever" msgstr "" #: ../../../changes.txt:554 2b0bc004e652473d8424fbaf44acc132 msgid "" "**Fixed** `2964 `_: There" " is an issue with the image generated by the page.get_pixmap() function" msgstr "" #: ../../../changes.txt:558 7489ffec843d457ca500cfb476753615 msgid "Use MuPDF-1.24.0." msgstr "" #: ../../../changes.txt:559 7c55068e2bc44f7a90942db48624c211 msgid "Add support for redacting vector graphics." msgstr "" #: ../../../changes.txt:560 994636840ff242bb90c2538f8b313764 msgid "Several fixes for table module" msgstr "" #: ../../../changes.txt:562 1cde4b0108a34c66bcf26a1e69169d92 msgid "Add new method for outputting the table as a markdown string." msgstr "" #: ../../../changes.txt:564 9fcf8beb4cbf4808b3636964252fb397 msgid "Address errors in computing the table header object:" msgstr "" #: ../../../changes.txt:566 466f446d303f45039a8d621fa72be582 msgid "" "We now allow None as the cell value, because this will be resolved where " "needed (e.g. in the pandas DataFrame)." msgstr "" #: ../../../changes.txt:569 b1456724d60f446b99497879dec77edc msgid "" "We previously tried to enforce rect-like tuples in all header cell " "bboxes, however this fails for tables with all-None columns. This fix " "enables this and constructs an empty string in the corresponding cell " "string." msgstr "" #: ../../../changes.txt:574 bd966cd782ae48e6bf574d6aa1e75969 msgid "" "We now correctly include start / stop points of lines in the bbox of the " "clustered graphic. We previously joined the line's rectangle - which had" " no effect because this is always empty." msgstr "" #: ../../../changes.txt:578 8b34024dc26b46d6bb00721aee57b203 msgid "Improved exception text if we fail to open document." msgstr "" #: ../../../changes.txt:579 2ad46d306493434ba2f21cbc55598c4e msgid "Fixed build with new libclang 18." msgstr "" #: ../../../changes.txt:582 e0f45c4d68334077bde30abcb37f442c msgid "**Changes in version 1.23.26 (2024-02-29)**" msgstr "" #: ../../../changes.txt:586 2f2ec05926254e2f9d6790002f8f0dbb msgid "" "**Fixed** `3199 `_: Add " "entry_points to setuptools configuration to provide command-line console " "scripts" msgstr "" #: ../../../changes.txt:587 254166b6829a47ebae52f0d1befd4f8c msgid "" "**Fixed** `3209 `_: Empty" " vertices in ink annotation" msgstr "" #: ../../../changes.txt:591 72a0f38fcb3f4fadae2a9750a83ecf70 msgid "Improvements to table detection:" msgstr "" #: ../../../changes.txt:593 70ae893cd45741a59c2a753e1efe9d04 msgid "" "Improved check for empty tables, fixes bugs when determining table " "headers." msgstr "" #: ../../../changes.txt:594 db5ad6c22fa8479fb66f6ada59044c7e msgid "Improved computation of enveloping vector graphic rectangles." msgstr "" #: ../../../changes.txt:595 7f5ea75a3d2b47809b85588c78b70318 msgid "Ignore more meaningless \"pseudo\" tables" msgstr "" #: ../../../changes.txt:597 6cd939d409f341f6a264ff3b4624cca6 msgid "Install command-line 'pymupdf' command that runs fitz/__main__.py." msgstr "" #: ../../../changes.txt:598 6afb7824085740ccaf2fc01c782dffcb msgid "Don't overwrite MuPDF's config.h when building on non-Windows." msgstr "" #: ../../../changes.txt:599 86e24a39bb0541a4ac1e71e88541c698 msgid "" "Fix `Story` constructor's `archive` arg to match docs - now accepts a " "single `Archive` constructor arg." msgstr "" #: ../../../changes.txt:600 a3ea96e9f72f483bbf461ca1d128b1e4 msgid "" "Do not include MuPDF source in sdist; will be downloaded automatically " "when building." msgstr "" #: ../../../changes.txt:603 b80b43ad742c43ab9880dd54056a9973 msgid "**Changes in version 1.23.25 (2024-02-20)**" msgstr "" #: ../../../changes.txt:607 ea65b6e10b4443fd98d4487f8a6227ce msgid "" "**Fixed** `3182 `_: " "Pixmap.invert_irect argument type error" msgstr "" #: ../../../changes.txt:608 420d27a70b34444aba118e43db9e4802 msgid "" "**Fixed** `3186 `_: " "extractText() extracts broken text from pdf" msgstr "" #: ../../../changes.txt:609 90aadcf4b788454abbf2665a0b7b8f22 msgid "" "**Fixed** `3191 `_: Error" " on .find_tables()" msgstr "" #: ../../../changes.txt:613 0a5a831494a04b18b50fdfc5d3833038 msgid "" "When building, be able to specify python-config directly, with " "environment variable `PIPCL_PYTHON_CONFIG`." msgstr "" #: ../../../changes.txt:617 93b9bfcd66aa426eaacb92d54e23c667 msgid "**Changes in version 1.23.24 (2024-02-19)**" msgstr "" #: ../../../changes.txt:621 3748e8d370624cd1889b240a694cc72e msgid "" "**Fixed** `3148 `_: Table" " extraction - vertical text not handled correctly" msgstr "" #: ../../../changes.txt:622 0017cea29f1247be99c102c56a8fabd1 msgid "" "**Fixed** `3179 `_: Table" " Detection: Incorrect Separation of Vector Graphics Clusters" msgstr "" #: ../../../changes.txt:623 dde9c50cb60147428936ac9e5bdacc81 msgid "" "**Fixed** `3180 `_: " "Cannot show optional content group: AttributeError: module 'fitz.mupdf' " "has no attribute 'pdf_array_push_drop'" msgstr "" #: ../../../changes.txt:627 838816f12e394f49b9e2ef7b4559fd71 msgid "Be able to test system install using `sudo pip install` instead of a venv." msgstr "" #: ../../../changes.txt:630 0b4ca8027622493090312b1e74a4839a msgid "**Changes in version 1.23.23 (2024-02-18)**" msgstr "" #: ../../../changes.txt:634 5c5c4b53219b4e8492fec8aafaa14b7e msgid "" "**Fixed** `3126 `_: " "Initialising Archive with a pathlib.Path fails." msgstr "" #: ../../../changes.txt:635 e5745b8508084965a56f4151794f8378 msgid "" "**Fixed** `3131 `_: " "Calling the next attribute of an Annot raises a \"No attribute .parent\" " "warning" msgstr "" #: ../../../changes.txt:636 59d2c178ba9c4d47977704a9feccc1ea msgid "" "**Fixed** `3134 `_: Using" " an IRect as clip parameter in Page.get_pixmap no longer works since " "1.23.9" msgstr "" #: ../../../changes.txt:637 43be27e8f82c45ef90522a9da30a0a72 msgid "" "**Fixed** `3140 `_: PDF " "document stays in use after closing" msgstr "" #: ../../../changes.txt:638 cbe3a25490474db9973829ac9e661e5b msgid "" "**Fixed** `3150 `_: " "doc.select() hangs on this doc." msgstr "" #: ../../../changes.txt:639 b40c96dbbba64f6f82a0dbc3fb5570db msgid "" "**Fixed** `3163 `_: " "AssertionError on using fitz.IRect" msgstr "" #: ../../../changes.txt:640 5b0e909d8b1c42c4815f57178c08f1d0 msgid "" "**Fixed** `3177 `_: " "fitz.Pixmap(None, pix) Unrecognised args for constructing Pixmap" msgstr "" #: ../../../changes.txt:645 bcff5266d81d44828538dd318c25c548 msgid "" "Improved `Document.select() by using new MuPDF function " "`pdf_rearrange_pages()`. This is a more complete (and faster) " "implementation of what needs to be done here in that not only pages will " "be rearranged, but also consequential changes will be made to the table " "of contents, links to removed pages and affected entries in the Optional " "Content definitions." msgstr "" #: ../../../changes.txt:651 7e5e70f9786348e485e9f480c4c5f649 msgid "`TextWriter.appendv()`: added `small_caps` arg." msgstr "" #: ../../../changes.txt:652 511da4bdc4cb4d488b5540f7118d05c6 msgid "Fixed some valgrind errors with MuPDF master." msgstr "" #: ../../../changes.txt:653 9fa27b2a0f6542779698b58b6ef2797f msgid "Fixed `Document.insert_image()` when build with MuPDF master." msgstr "" #: ../../../changes.txt:656 8215b8e723014b82adeefa3d490e76cf msgid "**Changes in version 1.23.22 (2024-02-12)**" msgstr "" #: ../../../changes.txt:660 9499acfbd68c4038bf82444da1a07c47 msgid "" "**Fixed** `3143 `_: " "Difference in decoding of OCGs names between doc.get_ocgs() and " "page.get_drawings()" msgstr "" #: ../../../changes.txt:662 6a05eddb0f5846589fe4c0086fc9e146 msgid "" "**Fixed** `3139 `_: " "Pixmap resizing needs positional arg \"clip\" - even if None." msgstr "" #: ../../../changes.txt:666 9a6bd516b5734957b5d8700fec418b18 msgid "Removed the use of MuPDF function `fz_image_size()` from PyMuPDF." msgstr "" #: ../../../changes.txt:669 32b339e622b6447890c25a4ab191fd39 msgid "**Changes in version 1.23.21 (2024-02-01)**" msgstr "" #: ../../../changes.txt:675 fab60867577a487b9c3f486166614839 msgid "" "Fixed bug in set_xml_metadata(), PR `3112 " "https://github.com/pymupdf/PyMuPDF/pull/3112>`_: Fix pdf_add_stream " "metadata error" msgstr "" #: ../../../changes.txt:676 5db3c0df43d7466bb49c93da76eb7ded msgid "Fixed lack of `.parent` member in `TextPage` from `Annot.get_textpage()`." msgstr "" #: ../../../changes.txt:677 6886cfc95dcf48449baf3597f9ed5a5b msgid "Fixed bug in `Page.add_widget()`." msgstr "" #: ../../../changes.txt:680 466b6a96778a400fa703f8a164dc6006 msgid "**Changes in version 1.23.20 (2024-01-29)**" msgstr "" #: ../../../changes.txt:682 ../../../changes.txt:693 ../../../changes.txt:711 #: ../../../changes.txt:723 ../../../changes.txt:737 ../../../changes.txt:750 #: ../../../changes.txt:761 ../../../changes.txt:773 ../../../changes.txt:797 #: ../../../changes.txt:917 ../../../changes.txt:934 ../../../changes.txt:966 #: ../../../changes.txt:1023 ../../../changes.txt:1099 #: ../../../changes.txt:1133 ../../../changes.txt:1142 #: ../../../changes.txt:1151 ../../../changes.txt:1169 #: ../../../changes.txt:1269 ../../../changes.txt:1308 #: 10bae71e3a574059884b4f1d5baea65c 11746df9cf7b4144bc9cabc8e95b78a9 #: 35c5e4be6606427a95322276ca783f0e 4bbb30be5f60421a87e36a340ddbe65f #: 524f6c6556b5468c90bac3e6f81b279d 5a44d84debe5475da967de80ba53914b #: 5ed487b98bc84f92a08fdb4934e8535b 74166ebee93f4e9e999f1cd22be78aaf #: 780c7d9984234abebe430e3254afc4e8 a47d1d46827b45bebe969ac04f21dc0f #: a6ae2f8c435749c4a8dc5fbe5c95dff6 a776aae290f74bdfaa636b31d9b933e0 #: bb6b3124820a4512a56446f360c94404 c7fa8793bb6d44aca1771c6152ac83d8 #: d22de0587ab24d4ab437626e883261d4 dd73709cf4c74a6e9d9a8eba46753cd2 #: e4a33a6c03dd49d0a338e5b67900cac8 f7e8261277e44b8abe33e6e0f05bcde7 #: f98503e4ea7c425391e56ac00fbae870 fc10345ba347482ba6bf7042461f8232 msgid "Bug fixes:" msgstr "" #: ../../../changes.txt:684 e101eae15b004da2849ab4be087a4010 msgid "" "**Fixed** `3100 `_: Wrong" " internal property accessed in get_xml_metadata" msgstr "" #: ../../../changes.txt:688 30795d0573e140c88dd4cf9e6887fbe0 msgid "Significantly improved speed of `Document.get_toc()`." msgstr "" #: ../../../changes.txt:691 f23cca9b1fc84d0ea474332f2e1c6c2c msgid "**Changes in version 1.23.19 (2024-01-25)**" msgstr "" #: ../../../changes.txt:695 36758073da3a48f5bc485fd6a9fc328e msgid "" "**Fixed** `3087 `_: " "Exception in insert_image with mask specified" msgstr "" #: ../../../changes.txt:696 202f997680f84ed9b7bf363b2b348028 msgid "" "**Fixed** `3094 `_: " "TypeError: '<' not supported between instances of 'FzLocation' and 'int' " "in doc.delete_pages" msgstr "" #: ../../../changes.txt:700 b8dceb00014f42ccb7877fe431320209 msgid "When finding tables:" msgstr "" #: ../../../changes.txt:702 311dca44e7df40e0a0c2ece5cca045f3 msgid "" "Allow addition of user-defined \"virtual\" vector graphics when finding " "tables." msgstr "" #: ../../../changes.txt:703 743195d5487f4c79b7dea4defa19efdb msgid "" "Confirm that the enveloping bboxes of vector graphics are inside the clip" " rectangle." msgstr "" #: ../../../changes.txt:704 91bcfe988eab4abe82d29ec6a73c24ac msgid "Avoid slow finding of rectangle intersections." msgstr "" #: ../../../changes.txt:706 6fbf98c2146642699598279e74ace969 msgid "Added `Font.bbox` property." msgstr "" #: ../../../changes.txt:709 02dd1c5dc69346c3aa052addbe84f62d msgid "**Changes in version 1.23.18 (2024-01-23)**" msgstr "" #: ../../../changes.txt:713 e98e1fa4a6be43e19c1235f235206973 msgid "" "**Fixed** `3081 `_: " "doc.close() not closing the document" msgstr "" #: ../../../changes.txt:717 da8086b4179148e78eef2c50eb3cd527 msgid "" "Reduced size of sdist to fit on pypi.org (by reducing size of two test " "files)." msgstr "" #: ../../../changes.txt:718 0b7e1df1d1024f52810b0f1778d8d2de msgid "Fix `Annot.file_info()` if no `Desc` item." msgstr "" #: ../../../changes.txt:721 df117a0a6648402e8810ca3b417979b4 msgid "**Changes in version 1.23.17 (2024-01-22)**" msgstr "" #: ../../../changes.txt:725 37f262e5ed6b4d118a5a82e4beb2b4ad msgid "" "**Fixed** `3062 `_: " "page_rotation_reset does not return page to original rotation" msgstr "" #: ../../../changes.txt:726 f86ef7904604429884e4c81fcf5ae787 msgid "" "**Fixed** `3070 `_: " "update_link(): AttributeError: 'Page' object has no attribute 'super'" msgstr "" #: ../../../changes.txt:730 6c6a0371126c46b0bcc8ebc5df7be344 msgid "Fixed bug in `Page.links()` (PR #3075)." msgstr "" #: ../../../changes.txt:731 a9475e5785414f199b597f416d8e1f8d msgid "Fixed bug in `Page.get_bboxlog()` with layers." msgstr "" #: ../../../changes.txt:732 8867fda0c26e4548b930e7d40da999bc msgid "Add support for timeouts in scripts/ and tests/run_compound.py." msgstr "" #: ../../../changes.txt:735 50f7599b93df4914acc301398f9fb589 msgid "**Changes in version 1.23.16 (2024-01-18)**" msgstr "" #: ../../../changes.txt:739 98d0c677086e45b8aefb2561c344d108 msgid "" "**Fixed** `3058 `_: " "Pixmap created from CMYK JPEG delivers RGB format" msgstr "" #: ../../../changes.txt:743 6280e0fb16044307be72a98e78055199 msgid "" "In table detection strategy \"lines_strict\", exclude fill-only vector " "graphics." msgstr "" #: ../../../changes.txt:744 7b87c57e26184d6fab0bf49037ae0ee0 msgid "Fixed sysinstall test failure." msgstr "" #: ../../../changes.txt:745 479fcf54b5cc40719b42543c6b8eb8d7 msgid "In documentation, update feature matrix with item about text writing." msgstr "" #: ../../../changes.txt:748 a58ed680108b456f811bd161fcda9c91 msgid "**Changes in version 1.23.15 (2024-01-16)**" msgstr "" #: ../../../changes.txt:752 db43cbaa428745bbbc155e1449a46274 msgid "" "**Fixed** `3050 `_: " "python3.9 pix.set_pixel has something wrong in c.append( ord(i))" msgstr "" #: ../../../changes.txt:756 85116010a87b4782a3c2cf37d6d3c233 msgid "Improved docs for Page.find_tables()." msgstr "" #: ../../../changes.txt:759 a0e9d51dec614dd5aad7a32d5195c117 msgid "**Changes in version 1.23.14 (2024-01-15)**" msgstr "" #: ../../../changes.txt:763 a147e66fe72c47f7ab10b2211f76dd3f msgid "" "**Fixed** `3038 `_: " "JM_pixmap_from_display_list > Assertion Error : Checking for wrong type" msgstr "" #: ../../../changes.txt:764 8e99271499a243a0ad21780cd0aa3b4f msgid "" "**Fixed** `3039 `_: Issue" " with doc.close() not closing the document in PyMuPDF" msgstr "" #: ../../../changes.txt:768 3976a531e434472590b8052395aea031 msgid "" "Ensure valid \"re\" rectangles in `Page.get_drawings()` with derotated " "pages." msgstr "" #: ../../../changes.txt:771 082bdc523e1f473f85543e64d3853ad8 msgid "**Changes in version 1.23.13 (2024-01-15)**" msgstr "" #: ../../../changes.txt:775 797a7ea0082844de9aa334285db2046a msgid "" "**Fixed** `2979 `_: list " "index out of range in to_pandas()" msgstr "" #: ../../../changes.txt:776 95667931dbcb4237bae8f4c9af83594b msgid "" "**Fixed** `3001 `_: " "Calling find_tables() on one document alters the bounding boxes of a " "subsequent document" msgstr "" #: ../../../changes.txt:780 186cd9d07f9b4a58beb7e8e41f3bc17d msgid "Fixed `Rect.height` and `Rect.width` to never return negative values." msgstr "" #: ../../../changes.txt:781 27c5d3626f094ec5863b809e2a812c25 msgid "Fixed `TextPage.extractIMGINFO()`'s returned `dictkey_yres` value." msgstr "" #: ../../../changes.txt:784 8255dfd1b9d149ba8ce261e1ceaff664 msgid "**Changes in version 1.23.12 (2024-01-12)**" msgstr "" #: ../../../changes.txt:786 5bb9f57d3682407b99532c75233dba1f msgid "" "**Fixed** `3027 `_: " "Page.get_text throws Attribute Error for 'parent'" msgstr "" #: ../../../changes.txt:789 2dae2447cbb74e1fb8e1a42264ec7e70 msgid "**Changes in version 1.23.11 (2024-01-12)**" msgstr "" #: ../../../changes.txt:791 cd671647a36347d9b8adbfb7ee2447a9 msgid "Fixed some Pixmap construction bugs." msgstr "" #: ../../../changes.txt:792 e891dfad684a4752b4e5805a6293dfcf msgid "Fixed Pixmap.yres()." msgstr "" #: ../../../changes.txt:795 f131f3b1f3b641e989cfeab5425a3e9c msgid "**Changes in version 1.23.10 (2024-01-12)**" msgstr "" #: ../../../changes.txt:799 ac50349144d841ab902a3ae407ef8714 msgid "" "**Fixed** `3020 `_: Can't" " resize a PixMap" msgstr "" #: ../../../changes.txt:803 3f395fa335f948a6bf2ec8e7dca4ea01 msgid "Fixed Page.delete_image()." msgstr "" #: ../../../changes.txt:806 c60fab8d493747628cff1c624cb39043 msgid "**Changes in version 1.23.9 (2024-01-11)**" msgstr "" #: ../../../changes.txt:808 1fa84ae4248d423485aa5cb183570533 msgid "Default to new \"rebased\" implementation." msgstr "" #: ../../../changes.txt:810 950a6848918d4d6b80203a0558ed5266 msgid "" "The old \"classic\" implementation is available with `import fitz_old as " "fitz`." msgstr "" #: ../../../changes.txt:811 bebd4b40a6314a9b99d384b13f921a74 msgid "" "For more information about why we are changing to the rebased " "implementation, see: https://github.com/pymupdf/PyMuPDF/discussions/2680" msgstr "" #: ../../../changes.txt:814 0a613f5215304e7b922f3fbb0c54ad9c msgid "Use MuPDF-1.23.9." msgstr "" #: ../../../changes.txt:816 ../../../changes.txt:848 #: 79b8f33e4c684085bbd12543c914a92c ed73712d903c42daa048538222480c72 msgid "Bug fixes (rebased implementation only):" msgstr "" #: ../../../changes.txt:818 f0a68870dc7e4101b40fb65d25d18b5a msgid "" "**Fixed** `2911 `_: " "Page.derotation_matrix returns a tuple instead of a Matrix with rebased " "implementation" msgstr "" #: ../../../changes.txt:819 b056b928a27c4740bfc45a1e268ab0d2 msgid "" "**Fixed** `2919 `_: " "Rebased version: KeyError in resolve_names when merging pdfs" msgstr "" #: ../../../changes.txt:820 736154fa84784e259b795c962116ed21 msgid "" "**Fixed** `2922 `_: New " "feature that allows inserting named-destination links doesn't work" msgstr "" #: ../../../changes.txt:821 bfe6879a0e3449928a0e143e35d1973d msgid "" "**Fixed** `2943 `_: " "ZeroDivisionError: float division by zero when use apply_redactions()" msgstr "" #: ../../../changes.txt:822 3aea2bcd6a984d8f8e814d25a05ea0cd msgid "" "**Fixed** `2950 `_: " "Shelling out to pip during tests is problematic" msgstr "" #: ../../../changes.txt:823 64a074a99c094bf2b64bf0a1175cfd6e msgid "" "**Fixed** `2954 `_: " "Replacement unicode character in text extraction" msgstr "" #: ../../../changes.txt:824 f1ab1e9632c440a1ad3ddceab5970793 msgid "" "**Fixed** `2957 `_: " "apply_redactions() moving text" msgstr "" #: ../../../changes.txt:825 be824c3a45bd4be0b2bc52d892f31652 msgid "" "**Fixed** `2961 `_: " "Passing a string as a page number raises IndexError instead of TypeError." msgstr "" #: ../../../changes.txt:826 e776dd1532cf4e4b930371d30841afe9 msgid "" "**Fixed** `2969 `_: " "annot.next throws AttributeError" msgstr "" #: ../../../changes.txt:827 ac77c79a100942f8a6159beb24f4e67a msgid "" "**Fixed** `2978 `_: " "1.23.9rc1: module 'fitz.mupdf' has no attribute 'fz_copy_pixmap_rect'" msgstr "" #: ../../../changes.txt:829 362af45c412f45c39a1d822fab1286b1 msgid "" "**Fixed** `2907 `_: " "segfault trying to call clean_contents on certain pdfs with python 3.12" msgstr "" #: ../../../changes.txt:830 c1135c0939ef4daab6a8385631c53704 msgid "" "**Fixed** `2905 `_: " "SystemError: returned a " "result with an exception set" msgstr "" #: ../../../changes.txt:831 a9d0e8515e0c4113af2e60251120838a msgid "" "**Fixed** `2742 `_: " "Segmentation Fault when inserting three (but not two) copies of the same " "source page into one destination page" msgstr "" #: ../../../changes.txt:835 bdbbaa0c597e4d8690d2acc01a05a511 msgid "Add optional setting of opacity to `Page.insert_htmlbox()`." msgstr "" #: ../../../changes.txt:836 ec4580cff71a44b881bd2289b03e1e76 msgid "Fixed issue with add_redact_annot() mentioned in #2934." msgstr "" #: ../../../changes.txt:837 37a7489f60b24988aabf68ab765c53aa msgid "" "Fixed `Page.rotation()` to return 0 for non-PDF documents instead of " "raising an exception." msgstr "" #: ../../../changes.txt:838 c15327390f2c412599adc9f6c2cd41eb msgid "Fixed internal quad detection to cope with any Python sequence." msgstr "" #: ../../../changes.txt:839 b5b25dcbb0e04533b6f266160078d7ac msgid "" "Fixed rebased `fitz.pymupdf_version_tuple` - was previously set to mupdf " "version." msgstr "" #: ../../../changes.txt:840 417b49c5b97a43b2884451f91a6ccd72 msgid "" "Improved support for Linux system installs, including adding regular " "testing on Github." msgstr "" #: ../../../changes.txt:841 dc9b6649df764b6d8bdd0aeb241c8116 msgid "Add missing `flake8` to `scripts/gh_release.py:test_packages`." msgstr "" #: ../../../changes.txt:842 526255ea77784aa5a86322e409396fbf msgid "Use newly public functions in MuPDF-1.23.8." msgstr "" #: ../../../changes.txt:843 78af7dcf823d4333b745e1411e2535c0 msgid "Improved `scripts/test.py` to help investigation of MuPDF issues." msgstr "" #: ../../../changes.txt:846 c4377b33474d4f08b8bb6ea1785e8cae msgid "**Changes in version 1.23.8 (2023-12-19)**" msgstr "" #: ../../../changes.txt:850 06bc7d28ba624f879fc3f4225f042ebd msgid "" "**Fixed** `2634 `_: " "get_toc and set_toc do not behave consistently for rotated pages" msgstr "" #: ../../../changes.txt:851 eaabee50b85a41f5a1eee3082375a7d5 msgid "" "**Fixed** `2861 `_: " "AttributeError in getLinkDict during PDF Merge" msgstr "" #: ../../../changes.txt:852 11a45b3c36814980abef6db057685eef msgid "" "**Fixed** `2871 `_: " "KeyError in getLinkDict during PDF merge" msgstr "" #: ../../../changes.txt:853 f6127a8b2c46475da27184f59e39e7ef msgid "" "**Fixed** `2886 `_: Error" " in Skeleton for Named Link Destinations" msgstr "" #: ../../../changes.txt:855 ../../../changes.txt:888 #: 586f106b986842b08028b0f5f627f7ca d8af7ffde72c450d915b0463309a4314 msgid "Bug fixes (rebased and classic implementations):" msgstr "" #: ../../../changes.txt:857 b33ad6378a46458cb75ad39284db9641 msgid "" "**Fixed** `2885 `_: " "pymupdf find tables too slow" msgstr "" #: ../../../changes.txt:861 ../../../changes.txt:901 #: 4728a8ecae8e40aa81aac714354f5cd8 dfafbc41ed064d4e9417228eef3b8869 msgid "Rebased implementation:" msgstr "" #: ../../../changes.txt:863 d5e148c0135c420faee01c379333d863 msgid "" "`Page.insert_htmlbox()`: new, much more powerful alternative to " "`Page.insert_textbox()` or `TextWriter.fill_textbox()`, using `Story`." msgstr "" #: ../../../changes.txt:864 61b9573e3d5140e89cab3a5f2306ae99 msgid "`Story.fit*()`: new methods for fitting a Story into an expanded rect." msgstr "" #: ../../../changes.txt:865 2c6161c5bc974598a30735ae4181b27c msgid "`Story.write_with_links()`: add support for external links." msgstr "" #: ../../../changes.txt:866 98b4230a54804ef4acb0b180f44e9ae5 msgid "" "`Document.language()`: fixed to use MuPDF's new " "`mupdf.fz_string_from_text_language2()`." msgstr "" #: ../../../changes.txt:867 40995750950149ef83a0d8f6ddad76ef msgid "`Document.subset_fonts()` - fixed." msgstr "" #: ../../../changes.txt:868 8f0552b58651471a97e511567a32e0c2 msgid "Fixed internal `Archive._add_treeitem()` method." msgstr "" #: ../../../changes.txt:869 87b1222b024441dea38cf29daba33184 msgid "" "Fixed `fitz_new.__doc__` to contain PyMuPDF and Python version " "information, and OS name." msgstr "" #: ../../../changes.txt:870 386cb55b9f0c4087ae1996bb06b51a33 msgid "" "Removed use of `(*args, **kwargs)` in API, we now specify keyword args " "explicitly." msgstr "" #: ../../../changes.txt:871 c59b0cc5fecc4bdd9562cd2ce75075d3 msgid "Work with new MuPDF Python exception classes." msgstr "" #: ../../../changes.txt:873 e3e5a541241440ed9d367ef19430a835 msgid "" "Fixed bug where `button_states()` returns None when `/AP` points to an " "indirect object." msgstr "" #: ../../../changes.txt:874 5af1990cff754cd89a3aa438eb9d383b msgid "" "Fixed pillow test to not ignore all errors, and install pillow when " "testing." msgstr "" #: ../../../changes.txt:875 1f1299ee32f346b6b3729cf40091e92c msgid "" "Added test for `fitz.css_for_pymupdf_font()` (uses package `pymupdf-" "fonts`)." msgstr "" #: ../../../changes.txt:876 8a8e3b21e7fe474598e60c7c3d327f5b msgid "Simplified Github Actions test specifications." msgstr "" #: ../../../changes.txt:877 285e6db854b84f7fab4a2c650152d2a2 msgid "Updated `tests/README.md`." msgstr "" #: ../../../changes.txt:880 25533a44e1824331b867fb200db45187 msgid "**Changes in version 1.23.7 (2023-11-30)**" msgstr "" #: ../../../changes.txt:882 583b1de242bb4157b4445d6446ee6bbb msgid "Bug fixes in rebased implementation, not fixed in classic implementation:" msgstr "" #: ../../../changes.txt:884 235fe8226daa4b0abbac192cae7fd37a msgid "" "**Fixed** `2232 `_: " "Geometry helper classes should support keyword arguments" msgstr "" #: ../../../changes.txt:885 e575834fcd73477b81b61829f22f495d msgid "" "**Fixed** `2788 `_: " "Problem with get_toc in pymupdf 1.23.6" msgstr "" #: ../../../changes.txt:886 48886ca53b3d4f75bb21c99311bdb5f3 msgid "" "**Fixed** `2791 `_: " "Experiencing small memory leak in save()" msgstr "" #: ../../../changes.txt:890 10a6b50400ed447497a29b25510f48e4 msgid "" "**Fixed** `2736 `_: " "Failure when set cropbox with mediabox negative value" msgstr "" #: ../../../changes.txt:891 2a0b37db8390439fbb646a9c37103f52 msgid "" "**Fixed** `2749 `_: " "RuntimeError: cycle in structure tree" msgstr "" #: ../../../changes.txt:892 3d06cf904a104c3d90b146fa78bf69ef msgid "" "**Fixed** `2753 `_: " "Story.write_with_links will ignore everything after the first \"page " "break\" in the HTML." msgstr "" #: ../../../changes.txt:893 8a53b50ea2524665955b3157294a2b2d msgid "" "**Fixed** `2812 `_: " "find_tables on landscape page generates reversed text" msgstr "" #: ../../../changes.txt:894 888fb15372974a36b1fe3d66ef22e391 msgid "" "**Fixed** `2829 `_: " "[cannot create /Annot for kind] is still printed despite #2345 is closed." msgstr "" #: ../../../changes.txt:895 4bddd57842e24f349a1d201577c84f44 msgid "" "**Fixed** `2841 `_: " "Unexpected KeyError when using scrub with fitz_new" msgstr "" #: ../../../changes.txt:897 94aee473c47b4b39a4c3c4cb53567f41 msgid "Use MuPDF-1.23.7." msgstr "" #: ../../../changes.txt:903 bec49d14f00548e4b548e3392c71e4f9 msgid "Added flake8 code checking to test suite, and made various fixes." msgstr "" #: ../../../changes.txt:904 5c2f03ef2da94a85b04bdcaa6b4452b2 msgid "" "Disable diagnostics during Document constructor to match classic " "implementation." msgstr "" #: ../../../changes.txt:906 614caa01606b4df1a5f36c79ba7597dc msgid "" "Additional fix to `2553 " "`_: Invalid characters in" " versions >= 1.22" msgstr "" #: ../../../changes.txt:907 249c2e20b6584ff5bde073c96d14cef8 msgid "" "Fixed `MuPDF Bug 707324 " "`_: Story: HTML " "table row background color repeated incorrectly" msgstr "" #: ../../../changes.txt:908 40274b78dadb4924955e4fcee62c82e9 msgid "Added `scripts/test.py`, for simple build+test of PyMuPDF git checkout." msgstr "" #: ../../../changes.txt:909 f4348c71af1f40479d9eb7d08fdba3aa msgid "Added `fitz.pymupdf_version_tuple`, e.g. `(1, 23, 6)`." msgstr "" #: ../../../changes.txt:910 0125831c6ca04067b9605b86aefa7ebb msgid "" "Restored mistakenly-reverted fix for `2345 " "`_: Turn off print " "statements in utils.py" msgstr "" #: ../../../changes.txt:911 ecf3f5029df1424ca67fedcd1eac52e1 msgid "" "Include any trailing `... repeated times...` text in warnings " "returned by `mupdf_warnings()` (rebased only)." msgstr "" #: ../../../changes.txt:915 dae1fc58258f4a368eb9b9e73fdc3418 msgid "**Changes in version 1.23.6 (2023-11-06)**" msgstr "" #: ../../../changes.txt:919 4b44a7b92e344051be42fcb7b2fd86ca msgid "" "**Fixed** `2553 `_: " "Invalid characters in versions >= 1.22" msgstr "" #: ../../../changes.txt:920 c22c67eda878468e84fdce9860d9470e msgid "" "**Fixed** `2608 `_: " "Incorrect utf32 text extraction (high & low surrogates are split)" msgstr "" #: ../../../changes.txt:921 ../../../changes.txt:944 #: 6e09bf78b2e8482189006eea2acba2bb 9836ec3981e942eab17d9cf2073f8760 msgid "" "**Fixed** `2710 `_: " "page.rect and text location wrong / differing from older version" msgstr "" #: ../../../changes.txt:922 cf4d2d380bbc48eb852fc95710f97677 msgid "" "**Fixed** `2774 `_: wrong" " encoding for \"\\?\" character when sort=True" msgstr "" #: ../../../changes.txt:923 1f6c84f41d254543a72dc62354b851c3 msgid "" "**Fixed** `2775 `_: " "fitz_new does not work with python3.10 or earlier" msgstr "" #: ../../../changes.txt:924 87951ce6577046f9b2d94ccd7a8d15cf msgid "" "**Fixed** `2777 `_: With " "fitz_new, wrong type for Page.mediabox" msgstr "" #: ../../../changes.txt:928 8d946635456d4d35be553ed4ef5c4c20 msgid "Use MuPDF-1.23.5." msgstr "" #: ../../../changes.txt:929 f7013808115244fc929c4e70b737e840 msgid "Added Document.resolve_names() (rebased implementation only)." msgstr "" #: ../../../changes.txt:932 fc23c2f02e0f4d6eaaf921039e93a96f msgid "**Changes in version 1.23.5 (2023-10-11)**" msgstr "" #: ../../../changes.txt:936 6009b9edb3184a869f2ce12fd73c20bd msgid "" "**Fixed** `2341 `_: " "Handling negative values in the zoom section for LINK_GOTO in linkDest" msgstr "" #: ../../../changes.txt:937 0dd0674d2f134d99b73659b6f62b19a1 msgid "" "**Fixed** `2522 `_: Typo " "in set_layer() - NameError: name 'f' is not defined" msgstr "" #: ../../../changes.txt:938 c5288d50055d4c5da1a7e0df44a0ac43 msgid "" "**Fixed** `2548 `_: Fitz " "freezes on some PDFs when calling the fitz.Page.get_text_blocks method." msgstr "" #: ../../../changes.txt:939 5ff84b8fb6be4feb8cdbf5edbbb0abaa msgid "" "**Fixed** `2596 `_: " "save(garbage=3) breaks get_pixmap() with side effect" msgstr "" #: ../../../changes.txt:940 123cb55d916f49108937ed096e7ddb25 msgid "" "**Fixed** `2635 `_: " "\"clean=True\" makes objects invisible in the pdf" msgstr "" #: ../../../changes.txt:941 ../../../changes.txt:969 #: 7654b31ea4c84890bf69fa4688837d78 8eef4b86cdec4085ae3f96a960c2ce20 msgid "" "**Fixed** `2637 `_: " "Page.insert_textbox incorrectly handles the last word if it starts a new " "line" msgstr "" #: ../../../changes.txt:942 bcc1d82ed2934ae49084a16db226ddf1 msgid "" "**Fixed** `2699 `_: " "extract paragraph with below table" msgstr "" #: ../../../changes.txt:943 75014a04729c49dd8bc091fb9ba66444 msgid "" "**Fixed** `2703 `_: Wrong" " fontsize calculation in corner cases (\"page.get_texttrace()\")" msgstr "" #: ../../../changes.txt:945 f469c85d192646e5aab002778053d0a5 msgid "" "**Fixed** `2723 `_: When " "will a Python 3.12 wheel be available?" msgstr "" #: ../../../changes.txt:946 0fa82c24bbeb42d2be8390fbba927f0d msgid "" "**Fixed** `2730 `_: " "persistent get_text() formatting" msgstr "" #: ../../../changes.txt:950 72690f1bf41e43bda38ccd424aacca3c msgid "Use MuPDF-1.23.4." msgstr "" #: ../../../changes.txt:951 30ff227bd04646bdb17474afeccd9981 msgid "Fix optimisation flags with system installs." msgstr "" #: ../../../changes.txt:952 6906912e05f34a26b46e5f8c0b9dd6e0 msgid "" "Fixed the problem that the clip parameter does not take effect during " "table recognition" msgstr "" #: ../../../changes.txt:953 70a6a8cd8dcc4c90acf6957467999a4f msgid "Support Pillow mode \"RGBa\"" msgstr "" #: ../../../changes.txt:954 500cf538fcc84a5d88b63e846009e940 msgid "Support extra word delimiters" msgstr "" #: ../../../changes.txt:955 c5a98d3b81ca4f3b92ee9b55641041eb msgid "Support checking valid PDF name objects" msgstr "" #: ../../../changes.txt:958 9780d5d181924c1f98f6e987dee32f09 msgid "**Changes in version 1.23.4 (2023-09-26)**" msgstr "" #: ../../../changes.txt:960 89f0cd5d2bdb4c2a86b8130279eaafbd msgid "Improved build instructions." msgstr "" #: ../../../changes.txt:961 ba599b28412843c2b4970a1f78cfe599 msgid "Fixed Tesseract in rebased implementation." msgstr "" #: ../../../changes.txt:962 ad9696206b1147e8a6e75796ad68f204 msgid "Improvements to build/install with system MuPDF." msgstr "" #: ../../../changes.txt:964 0b8845dfb30c4a3ebf1bab255c2231f3 msgid "Fixed rebased bug in _insert_image()." msgstr "" #: ../../../changes.txt:968 0c9e490c29db4714af654a120396b8e6 msgid "" "**Fixed** `2556 `_: " "Segmentation fault at caling get_cdrawings(extended=True)" msgstr "" #: ../../../changes.txt:970 b47698c2a99a4d67be8d09ea95ac3f34 msgid "" "**Fixed** `2683 `_: " "Windows sdist build failure - non-quoting of path and using UNIX which " "command" msgstr "" #: ../../../changes.txt:971 2e8eaa9c953340e3b7f9cab5aa9c144a msgid "" "**Fixed** `2691 `_: " "Page.get_textpage_ocr() bug in rebased fitz_new version" msgstr "" #: ../../../changes.txt:972 01bf199cda4f40eb80f58292500d052e msgid "" "**Fixed** `2692 `_: " "Page.get_pixmap(clip=Rect()) bug in rebased fitz_new version" msgstr "" #: ../../../changes.txt:975 e635ca7f3a7144c7b155a0d53f366bc4 msgid "**Changes in version 1.23.3 (2023-08-31)**" msgstr "" #: ../../../changes.txt:977 b622f722651945db8c9065920951a027 msgid "Fixed use of Tesseract for OCR." msgstr "" #: ../../../changes.txt:980 0b6d628f664246e1af3613f80ef88e31 msgid "**Changes in version 1.23.2 (2023-08-28)**" msgstr "" #: ../../../changes.txt:982 5b021aef8d8846649ea00de593b61159 msgid "" "**Fixed** `#2613 `_: " "release 1.23.0 not MacOS-arm64 compatible" msgstr "" #: ../../../changes.txt:985 18a26e38b78544d8bed38a8639d031b2 msgid "**Changes in version 1.23.1 (2023-08-24)**" msgstr "" #: ../../../changes.txt:987 e62a756953074ab996467e70681646a5 msgid "Updated README and package summary description." msgstr "" #: ../../../changes.txt:990 a21901dee64f4a1899288f13aaebfd95 msgid "" "Fixed a problem on some Linux installations with Python-3.10 (and " "possibly earlier versions) where `import fitz` failed with `ImportError: " "libcrypt.so.2: cannot open shared object file: No such file or " "directory`." msgstr "" #: ../../../changes.txt:996 57b658dc047548bbbf4b37367da3eb2a msgid "Fixed `incompatible architecture` error on MacOS arm64." msgstr "" #: ../../../changes.txt:999 d42dcb0953b54804aee03e472206b6ee msgid "" "Fixed installation warning from Poetry about missing entry in wheels' " "RECORD files." msgstr "" #: ../../../changes.txt:1003 d3a8e8bb4f464faf90ac4e4f2d3d4257 msgid "**Changes in version 1.23.0 (2023-08-22)**" msgstr "" #: ../../../changes.txt:1005 73d894b0d405493fa197c028fc016e16 msgid "Add method `find_tables()` to the `Page` object." msgstr "" #: ../../../changes.txt:1007 0381413ce0b8400e912c1027cc2af4d5 msgid "" "This allows locating tables on any supported document page, and " "extracting table content by cell." msgstr "" #: ../../../changes.txt:1010 7e8f7d58a9bc4339b09e0b5f9ac4ee2d msgid "New \"rebased\" implementation of PyMuPDF." msgstr "" #: ../../../changes.txt:1012 9fc6a3029b014900b58e9338c2babb18 msgid "" "The rebased implementation is available as Python module `fitz_new`. It " "can be used as a drop-in replacement with `import fitz_new as fitz`." msgstr "" #: ../../../changes.txt:1017 738d34d7aebd43ff89c69b82aa7d46e8 msgid "" "Python-independent MuPDF libraries are now in a second wheel called " "`PyMuPDFb` that will be automatically installed by pip." msgstr "" #: ../../../changes.txt:1020 bca75d93dfe54dd0b930fe20a80af757 msgid "" "This is to save space on pypi.org - a full release only needs one " "`PyMuPDFb` wheel for each OS." msgstr "" #: ../../../changes.txt:1025 5ea8868d14804747b7a032703ca8e9b5 msgid "" "**Fixed** `#2542 `_: " "fitz.utils.scrub AttributeError Annot object has no attribute fileUpd " "inside" msgstr "" #: ../../../changes.txt:1026 d834522e9a47458f8df14e8f629b6a80 msgid "" "**Fixed** `#2533 `_: " "get_texttrace returned a incorrect character bbox" msgstr "" #: ../../../changes.txt:1027 fa9e61cc88804262a37529823e6ae230 msgid "" "**Fixed** `#2537 `_: " "Validation when setting a grouped RadioButton throws a RuntimeError: path" " to 'V' has indirects" msgstr "" #: ../../../changes.txt:1029 ../../../changes.txt:1829 #: ../../../changes.txt:1993 8bbac0324fdd4e349f9a5fa96e73089b #: eaf8cd2128cd4c5c877473f9bd315793 ec5d869f0874493ea625e47c43bf59f8 msgid "Other changes:" msgstr "" #: ../../../changes.txt:1031 038268fa0e3d4530b127e02b008b0de5 msgid "Dropped support for Python-3.7." msgstr "" #: ../../../changes.txt:1033 2f238ba63e474abd882d994c5d8a6c7d msgid "Fix for wrong page / annot `/Contents` cleaning." msgstr "" #: ../../../changes.txt:1035 8de4c1abb94c4af0ae76a8bc208f2498 msgid "We need to set `pdf_filter_options::no_update` to zero." msgstr "" #: ../../../changes.txt:1037 3be90380c41041df9c0e8a4b1514f49a msgid "Added new function get_tessdata()." msgstr "" #: ../../../changes.txt:1039 e2dd7eb60faf45958693b36439454d65 msgid "Cope with problem `/Annot` arrays." msgstr "" #: ../../../changes.txt:1041 f3a9365058d14581b262aefd3dc3f5cd msgid "" "When copying page annotations in method Document.insert_pdf we previously" " did not check the validity of members of the `/Annots` array. For " "faulty members (like null or non-dictionary items) this could cause " "unnecessary exceptions. This fix implements more checks and skips such " "array items." msgstr "" #: ../../../changes.txt:1047 15b514dde25a435db2d8761712b2b511 msgid "Additional annotation type checks." msgstr "" #: ../../../changes.txt:1049 3d28a76d5772428ca847e78115435df5 msgid "" "We did not previously check for annotation type when getting / setting " "annotation border properties. This is now checked in accordance with " "MuPDF." msgstr "" #: ../../../changes.txt:1053 1db4c46ee27f4603907a8be59ce434bd msgid "Increase fault tolerance." msgstr "" #: ../../../changes.txt:1055 cfeadbde1d1a4bd28e4394f298039395 msgid "" "Avoid exceptions in method `insert_pdf()` when source pages contains " "invalid items in the `/Annots` array." msgstr "" #: ../../../changes.txt:1058 e95424ad171f4befacebac209026dccf msgid "Return empty border dict for applicable annots." msgstr "" #: ../../../changes.txt:1060 d32e47da50ad4e1bbec4315e5deb475a msgid "" "We previously were returning a non-empty border dictionary even for non-" "applicable annotation types. We now return the empty dictionary `{}` in " "these cases. This requires some corresponding changes in the annotation " "`.update()` method, namely for dashes and border width." msgstr "" #: ../../../changes.txt:1065 a743fc735f8e4751aa4c9fb35972a0e6 msgid "Restrict `set_rect` to applicable annot types." msgstr "" #: ../../../changes.txt:1067 33dd0a503f44425489708bfc1eba3781 msgid "" "We were insufficiently excluding non-applicable annotation types from " "`set_rect()` method. We now let MuPDF catch unsupported annotations and " "return `False` in these cases." msgstr "" #: ../../../changes.txt:1071 3c981f3c14264a87a5e5864716eb590f msgid "Wrong fontsize computation in `page.get_texttrace()`." msgstr "" #: ../../../changes.txt:1073 d2bca3e2d5044d88b32f20c0e92bf049 msgid "" "When computing the font size we were using the final text transformation " "matrix, where we should have taken `span->trm` instead. This is " "corrected here." msgstr "" #: ../../../changes.txt:1077 4e4387c698a9431c875e14e61bfe5993 msgid "Updates to cope with changes to latest MuPDF." msgstr "" #: ../../../changes.txt:1079 68949888709c441996bba638e370acdd msgid "`pdf_lookup_anchor()` has been removed." msgstr "" #: ../../../changes.txt:1081 8e5efc45233c429083dbb2e7710b8e46 msgid "Update fill_textbox to better respect rect.width" msgstr "" #: ../../../changes.txt:1083 193ee81062494935a4b6e5f7a2d5d470 msgid "" "The function norm_words in fill_textbox had a bug in its last loop, " "appending n+1 characters when actually measuring width of n characters. " "It led to a bug in fill_texbox when you tried to write a single word " "mostly composed of \"wide\" letters (M,m, W, w...), causing the written " "text to exceed the given rect." msgstr "" #: ../../../changes.txt:1089 6719947ef5ad4b44b30317c8cd0d27f0 msgid "The fix was just to replace n+1 by n." msgstr "" #: ../../../changes.txt:1091 a7647cf90c074ee7bf1e22c92b11aad2 msgid "Add `script_focus` and `script_blur` options to widget." msgstr "" #: ../../../changes.txt:1095 e7f3a5c65c2a4b4095652b5ee87ecf26 msgid "**Changes in version 1.22.5 (2023-06-21)**" msgstr "" #: ../../../changes.txt:1097 e0f897c4559d4185828a667deab0b5e1 msgid "This release uses ``MuPDF-1.22.2``." msgstr "" #: ../../../changes.txt:1101 d01a2996634d4afd910a1b19f88fe54d msgid "" "**Fixed** `#2365 `_: " "Incorrect dictionary values for type \"fs\" drawings." msgstr "" #: ../../../changes.txt:1102 37372904c5fc4a288d1bcfae3658be44 msgid "" "**Fixed** `#2391 `_: " "Check box automatically uncheck when we update same checkbox more than 1 " "times." msgstr "" #: ../../../changes.txt:1103 da93bf73beab4c7394a870d6ef00aa74 msgid "" "**Fixed** `#2400 `_: Gaps" " within text of same line not filled with spaces." msgstr "" #: ../../../changes.txt:1104 c7bbdcecf83d4af18820e8854d6ed2f7 msgid "" "**Fixed** `#2404 `_: " "Blacklining an image in PDF won't remove underlying content in version " "1.22.X." msgstr "" #: ../../../changes.txt:1105 5dab0dae25104c5fac71c4bea81bd2ab msgid "" "**Fixed** `#2430 `_: " "Incorrectly reducing ref count of Py_None." msgstr "" #: ../../../changes.txt:1106 28dd826ad25d4fe989f269746f3f3beb msgid "" "**Fixed** `#2450 `_: " "Empty fill color and fill opacity for paths with fill and stroke " "operations with 1.22.*" msgstr "" #: ../../../changes.txt:1107 6eeb2a8ef825424fad2bdbac330da13d msgid "" "**Fixed** `#2462 `_: " "Error at \"get_drawing(extended=True )\"" msgstr "" #: ../../../changes.txt:1108 d83cacb33bfb43289ba1cac19694532b msgid "" "**Fixed** `#2468 `_: " "Decode error when trying to get drawings" msgstr "" #: ../../../changes.txt:1109 6816013f54d4446bb7b60530a6e49ad6 msgid "" "**Fixed** `#2710 `_: " "page.rect and text location wrong / differing from older version" msgstr "" #: ../../../changes.txt:1110 2a55b8aad74742ba905c8261e774e40e msgid "" "**Fixed** `#2723 `_: When" " will a Python 3.12 wheel be available?" msgstr "" #: ../../../changes.txt:1112 89917a32f35f46348baa0a3c330b174e msgid "New features:" msgstr "" #: ../../../changes.txt:1114 84e05da539e34fb1b20339210c836492 msgid "" "**Changed** Annotations now support \"cloudy\" borders. The " ":attr:`Annot.border` property has the new item `clouds`, and method " ":meth:`Annot.set_border` supports the corresponding `clouds` argument." msgstr "" #: ../../../changes.txt:1118 bce76d38c410446ba81647f0896ef355 msgid "" "**Changed** Radio button widgets in the same RB group are now " "consistently updated **if the group is defined in the standard way**." msgstr "" #: ../../../changes.txt:1121 f53cb26ab76e43dfbbd2f4c2efc5a821 msgid "" "**Added** Support for the `/Locked` key in PDF Optional Content. This " "array inside the catalog entry `/OCProperties` can now be extracted and " "set." msgstr "" #: ../../../changes.txt:1124 def96ff824944143acfaffad2e689880 msgid "" "**Added** Support for new parameter `tessdata` in OCR functions. New " "function :meth:`get_tessdata` locates the language support folder if " "Tesseract is installed." msgstr "" #: ../../../changes.txt:1129 ab43957ddc794c8a9b04c475426c4984 msgid "**Changes in version 1.22.3 (2023-05-10)**" msgstr "" #: ../../../changes.txt:1131 ../../../changes.txt:1140 #: ../../../changes.txt:1149 ../../../changes.txt:1161 #: 03ca33346d3944328c25a5c144420613 07f4c427f5f544f5bd7d767983484060 #: 0fb05318e4944beeb5124143ee76589f d7e781b29559409897126ce3786cd3e7 msgid "This release uses ``MuPDF-1.22.0``." msgstr "" #: ../../../changes.txt:1135 91c90d81ef504a9d8aeaffb101145d25 msgid "" "**Fixed** `#2333 `_: " "Unable to set any of button radio group in form" msgstr "" #: ../../../changes.txt:1138 016b5d8017ec4b46aa0db0ca2575d91b msgid "**Changes in version 1.22.2 (2023-04-26)**" msgstr "" #: ../../../changes.txt:1144 2a883f3384d24cb4b50c413be7b7248d msgid "" "**Fixed** `#2369 `_: " "Image extraction bugs with newer versions" msgstr "" #: ../../../changes.txt:1147 558df7978ec349b98ce43b9afb00b02e msgid "**Changes in version 1.22.1 (2023-04-18)**" msgstr "" #: ../../../changes.txt:1153 2f26d737893143a0b598c60bbf17e7c1 msgid "" "**Fixed** `#2345 `_: Turn" " off print statements in utils.py" msgstr "" #: ../../../changes.txt:1154 88393d4c4b1c4de88301c4a0c889142a msgid "" "**Fixed** `#2348 `_: " "extract_image returns an extension \"flate\" instead of \"png\"" msgstr "" #: ../../../changes.txt:1155 a669f7b9c4be4a208b4f533e8f283873 msgid "" "**Fixed** `#2350 `_: Can " "not make widget (checkbox) to read-only by adding flags " "PDF_FIELD_IS_READ_ONLY" msgstr "" #: ../../../changes.txt:1156 2b3bdc6748004a1aa84e2d6b31562785 msgid "" "**Fixed** `#2355 `_: " "1.22.0 error when using get_toc (AttributeError: 'SwigPyObject' object " "has no attribute)" msgstr "" #: ../../../changes.txt:1159 350bcb28a30944fdacb28843123738f2 msgid "**Changes in version 1.22.0 (2023-04-14)**" msgstr "" #: ../../../changes.txt:1163 44f570ec1df54e41a946bffb631b53c9 msgid "Behavioural changes:" msgstr "" #: ../../../changes.txt:1165 3826a16556c6458d8e1e603e51ffd973 msgid "" "Text extraction now includes glyphs that overlap with clip rect; " "previously they were included only if they were entirely contained within" " the clip rect." msgstr "" #: ../../../changes.txt:1171 3c30c3109974444198cf37e90e8ecabb msgid "" "**Fixed** `#1763 `_: " "Interactive(smartform) form PDF calculation not working in pymupdf" msgstr "" #: ../../../changes.txt:1172 af42fd504f0640239d81c483794b7e87 msgid "" "**Fixed** `#1995 `_: " "RuntimeError: image is too high for a long paged pdf file when trying" msgstr "" #: ../../../changes.txt:1173 c1d1a1930cec45f3aeb64999517485da msgid "" "**Fixed** `#2093 `_: " "Image in pdf changes color after applying redactions" msgstr "" #: ../../../changes.txt:1174 44f1654607db4a3a8bea70e0742f243f msgid "" "**Fixed** `#2108 `_: " "Redaction removing more text than expected" msgstr "" #: ../../../changes.txt:1175 13a17730caa849b68c2ae08ecb2ca4d8 msgid "" "**Fixed** `#2141 `_: " "Failed to read JPX header when trying to get blocks" msgstr "" #: ../../../changes.txt:1176 59f63490e3084544a37ad382c51db86f msgid "" "**Fixed** `#2144 `_: " "Replace image throws an error" msgstr "" #: ../../../changes.txt:1177 126c1e66cfb94388a6f083d43390e614 msgid "" "**Fixed** `#2146 `_: " "Wrong Handling of Reference Count of \"None\" Object" msgstr "" #: ../../../changes.txt:1178 c2df8c498e4c4870b10129059c78dc55 msgid "" "**Fixed** `#2161 `_: " "Support adding images as pages directly" msgstr "" #: ../../../changes.txt:1179 fa791f2adef34202b8f713657d47816f msgid "" "**Fixed** `#2168 `_: " "``page.add_highlight_annot(start=pointa, stop=pointb)`` not working" msgstr "" #: ../../../changes.txt:1180 e34fc762c8864c6db478c2a49d9e26ef msgid "" "**Fixed** `#2173 `_: " "Double free of ``Colorspace`` used in ``Pixmap``" msgstr "" #: ../../../changes.txt:1181 18b7a0bf38a14b94a56b1ba2feea09b9 msgid "" "**Fixed** `#2179 `_: " "Incorrect documentation for ``pixmap.tint_with()``" msgstr "" #: ../../../changes.txt:1182 30fdc624e4da4b0da0d438177b35bb4d msgid "" "**Fixed** `#2208 `_: " "Pushbutton widget appears as check box" msgstr "" #: ../../../changes.txt:1183 4d209898906843229670a95f12041360 msgid "" "**Fixed** `#2210 `_: " "``apply_redactions()`` move pdf text to right after redaction" msgstr "" #: ../../../changes.txt:1184 e6423ce2ee3e42cd842814a3ea98cae3 msgid "" "**Fixed** `#2220 `_: " "``Page.delete_image()`` | object has no attribute ``is_image``" msgstr "" #: ../../../changes.txt:1185 c6210c2a77804a929b68c35607fa6823 msgid "" "**Fixed** `#2228 `_: open" " some pdf cost too much time" msgstr "" #: ../../../changes.txt:1186 b599a24386c74a8c913ae912d614557a msgid "" "**Fixed** `#2238 `_: Bug " "- can not extract data from file in the newest version 1.21.1" msgstr "" #: ../../../changes.txt:1187 b350fda19a5149f5848f62509b82c19a msgid "" "**Fixed** `#2242 `_: " "Python quits silently in ``Story.element_positions()`` if callback " "function prototype is wrong" msgstr "" #: ../../../changes.txt:1188 e6dc566181194da487883bc82530e4c5 msgid "" "**Fixed** `#2246 `_: " "TextWriter write text in a wrong position" msgstr "" #: ../../../changes.txt:1189 3a1d2b5a77714081819e4147e4876ed9 msgid "" "**Fixed** `#2248 `_: " "After redacting the content, the position of the remaining text changes" msgstr "" #: ../../../changes.txt:1190 be48ed21d0f44f6dba17fab6201c8b78 msgid "" "**Fixed** `#2250 `_: " "docs: unclear or broken link in page.rst" msgstr "" #: ../../../changes.txt:1191 1f64252d8b684958a8360570bc1b540a msgid "" "**Fixed** `#2251 `_: " "mupdf_display_errors does not apply to Pixmap when loading broken image" msgstr "" #: ../../../changes.txt:1192 e8ac54952809456694e4b366c0992b6d msgid "" "**Fixed** `#2270 `_: " "``Annot.get_text(\"words\")`` - doesn't return the first line of words" msgstr "" #: ../../../changes.txt:1193 982ad8c99b6f4f739e357ee11cd3b514 msgid "" "**Fixed** `#2275 `_: " "insert_image: document that rotations are counterclockwise" msgstr "" #: ../../../changes.txt:1194 eb8b181a15924a07abee72fea8a50ce9 msgid "" "**Fixed** `#2278 `_: Can " "not make widget (checkbox) to read-only by adding flags " "PDF_FIELD_IS_READ_ONLY" msgstr "" #: ../../../changes.txt:1195 2dd5e761dcb94cde9a62d9e95e521f8a msgid "" "**Fixed** `#2290 `_: " "Different image format/data from Page.get_text(\"dict\") and " "Fitz.get_page_images()" msgstr "" #: ../../../changes.txt:1196 b626d2a058c1457bb8fc7b175049d787 msgid "" "**Fixed** `#2293 `_: 68 " "failed tests when installing from sdist on my box" msgstr "" #: ../../../changes.txt:1197 c7c26b4cf78644b98a99810e21c743c5 msgid "" "**Fixed** `#2300 `_: Too " "much recursion in tree (parents), makes program terminate" msgstr "" #: ../../../changes.txt:1198 53cf50d333db4541900b708daa262c2d msgid "" "**Fixed** `#2322 `_: " "add_highlight_annot using clip generates \"A Number is Out of Range\" " "error in PDF" msgstr "" #: ../../../changes.txt:1202 dc34fa0179bf4c0097c613d4e4d7cd5d msgid "" "Add key \"/AS (Yes)\" to the underlying annot object of a selected button" " form field." msgstr "" #: ../../../changes.txt:1204 851dc87410c04af3811c1fce6e46d473 msgid "" "Remove unused ``Document`` methods ``has_xref_streams()`` and " "``has_old_style_xrefs()`` as MuPDF equivalents have been removed." msgstr "" #: ../../../changes.txt:1207 85d63fb357cc4ae6843661251e81671d msgid "" "Add new ``Document`` methods and properties for getting/setting " "``/PageMode``, ``/PageLayout`` and ``/MarkInfo``." msgstr "" #: ../../../changes.txt:1210 4692f2e3d07246f4b715a11b16c41826 msgid "" "New ``Document`` property ``version_count``, which contains the number of" " incremental saves plus one." msgstr "" #: ../../../changes.txt:1213 35dcac5f24064e0aa4e37ed607d7ee66 msgid "" "New ``Document`` property ``is_fast_webaccess`` which tells whether the " "document is linearized." msgstr "" #: ../../../changes.txt:1216 123a5e07f4e14c818cdcd4df6eb3afee msgid "``DocumentWriter`` is now a context manager." msgstr "" #: ../../../changes.txt:1218 78db04ba2a9c48b7ad95cf5a7935dbd9 msgid "Add support for ``Pixmap`` JPEG output." msgstr "" #: ../../../changes.txt:1220 75aea400570e4b6e9fec59457f4f883e msgid "Add support for drawing rectangles with rounded corners." msgstr "" #: ../../../changes.txt:1222 8f7ef5836f6341ec93a07f437355992f msgid "``get_drawings()``: added optional ``extended`` arg." msgstr "" #: ../../../changes.txt:1224 e60534dd491e4153a778b53b862c3666 msgid "" "Fixed issue where trace devices' state was not being initialised " "correctly; data returned from things like ``fitz.Page.get_texttrace()`` " "might be slightly altered, e.g. ``linewidth`` values." msgstr "" #: ../../../changes.txt:1228 5ce1cdb70dd7438d9abe42cb5886dddc msgid "" "Output warning to ``stderr`` if it looks like we are being used with " "current directory containing an invalid ``fitz/`` directory, because this" " can break import of ``fitz`` module. For example this happens if one " "attempts to use ``fitz`` when current directory is a PyMuPDF checkout." msgstr "" #: ../../../changes.txt:1234 ../../../changes.txt:1289 #: 349693fd237b4cbc8a22aa6cf3da10f1 8656870c12324ba69e9770b2a5f4fad6 msgid "Documentation:" msgstr "" #: ../../../changes.txt:1236 d223e4e942aa4b40ae6748f3f806de5d msgid "General rework:" msgstr "" #: ../../../changes.txt:1238 f085940fb9eb4248aa37862aa5ee511f msgid "Introduces a new home page and new table of contents." msgstr "" #: ../../../changes.txt:1239 7d45f07d7c9f45d085714f462f775464 msgid "Structural update to include new About section." msgstr "" #: ../../../changes.txt:1240 fbd4e460a3094b4e9f3cbe8bdb120960 msgid "Comparison & performance graphing." msgstr "" #: ../../../changes.txt:1241 42f77bb0503d48488766f5fdb4d19c15 msgid "Includes performance methodology in appendix." msgstr "" #: ../../../changes.txt:1242 3bc9a3e24e0249a7a103014e58b0cfe0 msgid "Updates conf.py to understand single back-ticks as code." msgstr "" #: ../../../changes.txt:1243 a3e9a116b3fb453fa81fe3081ca9ac28 msgid "Converts double back-ticks to single back-ticks." msgstr "" #: ../../../changes.txt:1244 dc12d40a4c6148f6b2c2740f969fe028 msgid "Removes redundant files." msgstr "" #: ../../../changes.txt:1246 4b1314b91c0c4a57afc180019e7fcf7f msgid "Improve ``insert_file()`` documentation." msgstr "" #: ../../../changes.txt:1248 d4504863060147358071d6130ed1d42c msgid "``get_bboxlog()``: aded optional ``layers`` to ``get_bboxlog()``." msgstr "" #: ../../../changes.txt:1249 c11f7f0d2dab4b70968cca0abf587247 msgid "" "``Page.get_texttrace()``: add new dictionary key ``layer``, name of " "Optional Content Group." msgstr "" #: ../../../changes.txt:1251 202373f80f8d415a95fc9f1ab5c7f3c6 msgid "Mention use of Python venv in installation documentation." msgstr "" #: ../../../changes.txt:1253 b7d408d9e1624b44b165a77a64070262 msgid "Added missing fix for #2057 to release 1.21.1's changelog." msgstr "" #: ../../../changes.txt:1255 e6cde05edeef4042a0657f838649a63c msgid "Fixes many links to the PyMuPDF-Utilities repo scripts." msgstr "" #: ../../../changes.txt:1257 038857900256474c9fded24cb273f8b5 msgid "Avoid duplication of ``changes.txt`` and ``docs/changes.rst``." msgstr "" #: ../../../changes.txt:1259 e343ebb10ae64a2baebc475af2998387 msgid "Build" msgstr "" #: ../../../changes.txt:1261 70564fcedaa2459bbccc68bc3d893e47 msgid "Added ``pyproject.toml`` file to improve builds using pip etc." msgstr "" #: ../../../changes.txt:1265 b1ea3fa1f44849439039e1a63d88a6e4 msgid "**Changes in Version 1.21.1 (2022-12-13)**" msgstr "" #: ../../../changes.txt:1267 92d79ae3bac04eae98a0a5093fe8273d msgid "This release uses ``MuPDF-1.21.1``." msgstr "" #: ../../../changes.txt:1271 3276e784b07a47648e6c6390b6cd3266 msgid "" "**Fixed** `#2110 `_: " "Fully embedded font is extracted only partially if it occupies more than " "one object" msgstr "" #: ../../../changes.txt:1272 950a39d02c9a4c8b8fa42d3ac1ac9e37 msgid "" "**Fixed** `#2094 `_: " "Rectangle Detection Logic" msgstr "" #: ../../../changes.txt:1273 2f5a46c0803d4b5a9cbbacd71100b204 msgid "" "**Fixed** `#2088 `_: " "Destination point not set for named links in toc" msgstr "" #: ../../../changes.txt:1274 97e2df4608364a7782f5c3a2e5b51f8d msgid "" "**Fixed** `#2087 `_: " "Image with Filter \"[/FlateDecode/JPXDecode]\" not extracted" msgstr "" #: ../../../changes.txt:1275 2168171e471542ada426f030b803e71d msgid "" "**Fixed** `#2086 `_: " "Document.save() owner_pw & user_pw has buffer overflow bug" msgstr "" #: ../../../changes.txt:1276 a23066f8e8654302b8b78db3816529c8 msgid "" "**Fixed** `#2076 `_: " "Segfault in fitz.py" msgstr "" #: ../../../changes.txt:1277 13898161176b4a65990185478cb80a77 msgid "" "**Fixed** `#2057 `_: " "Document.save garbage parameter not working in PyMuPDF 1.21.0" msgstr "" #: ../../../changes.txt:1278 9d7d27f10c4946fd8036c536b9c192e1 msgid "" "**Fixed** `#2051 `_: " "Missing DPI Parameter" msgstr "" #: ../../../changes.txt:1279 f53e894aea1048b0b6ea80c4ea26c7c5 msgid "" "**Fixed** `#2048 `_: " "Invalid size of TextPage and bbox with newest version 1.21.0" msgstr "" #: ../../../changes.txt:1280 f969ab18933245a593f97d97ee9ecbf6 msgid "" "**Fixed** `#2045 `_: " "SystemError: returned a result " "with an error set" msgstr "" #: ../../../changes.txt:1281 1f16bd21e2a8445d9592684ec7ecca51 msgid "" "**Fixed** `#2039 `_: " "1.21.0 fails to build against system libmupdf" msgstr "" #: ../../../changes.txt:1282 3c45097d33ee470a9481317257d311f7 msgid "" "**Fixed** `#2036 `_: " "Archive::Archive defined twice" msgstr "" #: ../../../changes.txt:1284 6533ecdf4d754fe7a4443b4a1b02bb72 msgid "Other" msgstr "" #: ../../../changes.txt:1286 9b576f8a8de143e3b3b9de9b6368ca18 msgid "Swallow \"&zoom=nan\" in link uri strings." msgstr "" #: ../../../changes.txt:1287 f70b7dad981d4d249124939b4f1aaaee msgid "" "Add new Page utility methods ``Page.replace_image()`` and " "``Page.delete_image()``." msgstr "" #: ../../../changes.txt:1291 4f89ab38e60b43ea987d07e27961bb7d msgid "" "`#2040 `_: Added note " "about test failure with non-default build of MuPDF, to " "``tests/README.md``." msgstr "" #: ../../../changes.txt:1292 558ff70ae6224480af3e735540cac2e3 msgid "" "`#2037 `_: In " "``docs/installation.rst``, mention incompatibility with chocolatey.org on" " Windows." msgstr "" #: ../../../changes.txt:1293 397d721cec884107af23df22baffdcb0 msgid "" "`#2061 `_: Fixed " "description of ``Annot.file_info``." msgstr "" #: ../../../changes.txt:1294 c6511b374b8b434caf2413b84c80813d msgid "" "`#2065 `_: Show how to " "insert internal PDF link." msgstr "" #: ../../../changes.txt:1295 6a5f0c4f501b4afd92cfe917137a0758 msgid "Improved description of building from source without an sdist." msgstr "" #: ../../../changes.txt:1296 67690117d7be41879e6fa66746eefeb1 msgid "Added information about running tests." msgstr "" #: ../../../changes.txt:1297 49b3f25fb63147c3b4c90a255b9ef648 msgid "" "`#2084 `_: Fixed broken " "link to PyMuPDF-Utilities." msgstr "" #: ../../../changes.txt:1300 575f368bd94e401b9952c6d42b41700d msgid "**Changes in Version 1.21.0 (2022-11-8)**" msgstr "" #: ../../../changes.txt:1302 673df835349745e7865e5b7f56344a60 msgid "This release uses ``MuPDF-1.21.0``." msgstr "" #: ../../../changes.txt:1304 17bf58b166d24d168b6139c6e77d3a91 msgid "New feature: Stories." msgstr "" #: ../../../changes.txt:1306 a17fc35b1e5e48ab82510fb0a263af42 msgid "Added wheels for Python-3.11." msgstr "" #: ../../../changes.txt:1310 15df913e178e4f6781add4fa251aec7f msgid "" "**Fixed** `#1701 `_: " "Broken custom image insertion." msgstr "" #: ../../../changes.txt:1311 2e7ca2e90f944214af8d8a773028ae37 msgid "" "**Fixed** `#1854 `_: " "`Document.delete_pages()` declines keyword arguments." msgstr "" #: ../../../changes.txt:1312 346bb412bfad447b83a0e599f7336a01 msgid "" "**Fixed** `#1868 `_: " "Access Violation Error at `page.apply_redactions()`." msgstr "" #: ../../../changes.txt:1313 9284226d16f4445cb9f22941a7e04dab msgid "" "**Fixed** `#1909 `_: " "Adding text with `fontname=\"Helvetica\"` can silently fail." msgstr "" #: ../../../changes.txt:1314 c11ff004104f4de1b6e767abc09ba8c4 msgid "" "**Fixed** `#1913 `_: " "`draw_rect()`: does not respect width if color is not specified." msgstr "" #: ../../../changes.txt:1315 0f7b31ba423c48a185bae37f8c31c421 msgid "" "**Fixed** `#1917 `_: " "`subset_fonts()`: make it possible to silence the stdout." msgstr "" #: ../../../changes.txt:1316 a785e9b369404f42b2a872e50d17133b msgid "" "**Fixed** `#1936 `_: " "Rectangle detection can be incorrect producing wrong output." msgstr "" #: ../../../changes.txt:1317 08fa2dec869748e4aa0d6b44cb796106 msgid "" "**Fixed** `#1945 `_: " "Segmentation fault when saving with `clean=True`." msgstr "" #: ../../../changes.txt:1318 3f1f9499ba9540f090c963df0a8cf1c2 msgid "" "**Fixed** `#1965 `_: " "`pdfocr_save()` Hard Crash." msgstr "" #: ../../../changes.txt:1319 e675868f950a47b89b02bdec849ddfaf msgid "" "**Fixed** `#1971 `_: " "Segmentation fault when using `get_drawings()`." msgstr "" #: ../../../changes.txt:1320 9af37195cb0a40ef94d54604e449326c msgid "" "**Fixed** `#1946 `_: " "`block_no` and `block_type` switched in `get_text()` docs." msgstr "" #: ../../../changes.txt:1321 cad632bb6e5347fdb160df1d5e205e7f msgid "" "**Fixed** `#2013 `_: " "AttributeError: 'Widget' object has no attribute '_annot' in delete " "widget." msgstr "" #: ../../../changes.txt:1323 c6abbf7c5af64afe8a6d1294f4458a5b msgid "Misc changes to core code:" msgstr "" #: ../../../changes.txt:1325 bcadf404caaf42199adda95adecf0183 msgid "Fixed various compiler warnings and a sequence-point bug." msgstr "" #: ../../../changes.txt:1326 1e7ac8c3fc184879954a671e241386ce msgid "Added support for Memento builds." msgstr "" #: ../../../changes.txt:1327 2d4b0ca48cff409ab625548ad136c9dd msgid "Fixed leaks detected by Memento in test suite." msgstr "" #: ../../../changes.txt:1328 eb361878f2a34aba8443b994d71d171a msgid "Fixed handling of exceptions in set_name() and set_rect()." msgstr "" #: ../../../changes.txt:1329 a57b2a7cb8ee4135a049aa057aa122ab msgid "Allow build with latest MuPDF, for regular testing of PyMuPDF master." msgstr "" #: ../../../changes.txt:1330 94ed6dc32d87489980b579f7731e909a msgid "Cope with new MuPDF exceptions when setting rect for some Annot types." msgstr "" #: ../../../changes.txt:1331 0ddc8291d7994c71af6956edb68bd61f msgid "" "Reduced cosmetic differences between MuPDF's config.h and PyMuPDF's " "_config.h." msgstr "" #: ../../../changes.txt:1332 ca97b466331943fbaf5357ca77d105ff msgid "Cope with various changes to MuPDF API." msgstr "" #: ../../../changes.txt:1336 ebefa94d051a413c87fa9a3656dcceda msgid "Fixed various broken links and typos in docs." msgstr "" #: ../../../changes.txt:1337 425cc8bc1fcf4fdaac66e442ee2e5513 msgid "Mention install of `swig-python` on MacOS for #875." msgstr "" #: ../../../changes.txt:1338 7073906d3d64408c836b7d3de96519aa msgid "Added (untested) wheels for macos-arm64." msgstr "" #: ../../../changes.txt:1343 30436208e7954516bb195ab1ea1ed488 msgid "**Changes in Version 1.20.2**" msgstr "" #: ../../../changes.txt:1345 ccf93339cf7245b2820d527e6e093f20 msgid "This release uses ``MuPDF-1.20.3``." msgstr "" #: ../../../changes.txt:1347 e392d8912dbc4a8596ade19a8161d639 msgid "" "**Fixed** `#1787 `_. Fix " "linking issues on Unix systems." msgstr "" #: ../../../changes.txt:1350 4d180eaf011b4a9fbb8c216aa4a505ec msgid "" "**Fixed** `#1824 `_. " "SegFault when applying redactions overlapping a transparent image. (Fixed" " in ``MuPDF-1.20.3``.)" msgstr "" #: ../../../changes.txt:1354 6cb696c83bfc47bbb07c549f1a1f0267 msgid "Improvements to documentation:" msgstr "" #: ../../../changes.txt:1356 0ad4a7a79fe54f24869d872723b404e8 msgid "" "Improved information about building from source in " "``docs/installation.rst``." msgstr "" #: ../../../changes.txt:1357 81117814315f48efbc87955f9a7ef58d msgid "Clarified memory allocation setting ``JM_MEMORY` in ``docs/tools.rst``." msgstr "" #: ../../../changes.txt:1358 b488d65744d743c4b1333dacf311664c msgid "Fixed link to PDF Reference manual in ``docs/app3.rst``." msgstr "" #: ../../../changes.txt:1359 472c19e0e68c4c109bde0bb001020dac msgid "Fixed building of html documentation on OpenBSD." msgstr "" #: ../../../changes.txt:1360 c99ee292bc6c46c686c3cad285701923 msgid "Moved old ``docs/faq.rst`` into separate ``docs/recipes-*`` files." msgstr "" #: ../../../changes.txt:1362 5fed1f452c8f47549032bcab7853bdde msgid "Removed some unused files and directories:" msgstr "" #: ../../../changes.txt:1364 7c310414b4384898a324f2841f54decd msgid "``installation/``" msgstr "" #: ../../../changes.txt:1365 5e5ae4637cb640d19cd1b1a5305c90d8 msgid "``docs/wheelnames.txt``" msgstr "" #: ../../../changes.txt:1368 f4d58a60a4f946a69ea863d1d7d30c62 msgid "**Changes in Version 1.20.1**" msgstr "" #: ../../../changes.txt:1370 23e14128203842beadfff33baa6792ae msgid "" "**Fixed** `#1724 `_. Fix " "for building on FreeBSD." msgstr "" #: ../../../changes.txt:1373 ca0919e2a72b45eca23b6ffabb073f2d msgid "" "**Fixed** `#1771 `_. " "`linkDest()` had a broken call to `re.match()`, introduced in 1.20.0." msgstr "" #: ../../../changes.txt:1376 1acfe9e0464545878372d78884eac896 msgid "" "**Fixed** `#1751 `_. " "`get_drawings()` and `get_cdrawings()` previously always returned with " "`closePath=False`." msgstr "" #: ../../../changes.txt:1379 b1c751d4d6b249f7b1603c75f54e6948 msgid "" "**Fixed** `#1645 `_. " "Default FreeText annotation text color is now black." msgstr "" #: ../../../changes.txt:1382 f7bb3767b4b546a8921290a547e0cf50 msgid "Improvements to sphinx-generated documentation:" msgstr "" #: ../../../changes.txt:1384 a5a5cb7bebe241279daf65c0700e6d10 msgid "Use readthedocs theme with enhancements." msgstr "" #: ../../../changes.txt:1385 d06c9bab26ef40449327e0f849c88152 msgid "Renamed the `.txt` files to have `.rst` suffixes." msgstr "" #: ../../../changes.txt:1389 7af006a5c3a84b03914bc4dcb23055ef msgid "**Changes in Version 1.20.0**" msgstr "" #: ../../../changes.txt:1391 c5bccf72f35e4edf807800d879e696ff msgid "This release uses ``MuPDF-1.20.0``, released 2022-06-15." msgstr "" #: ../../../changes.txt:1393 68d1b02687f849fab3365ec98f0308d4 msgid "" "Cope with new MuPDF link uri format, changed from ``#,,`` " "to ``#page=&zoom=,,``." msgstr "" #: ../../../changes.txt:1395 d17d731c792044cfa0b4bc0486f4c5a8 msgid "" "In ``tests/test_insertpdf.py``, use new reference output " "``joined-1.20.pdf``. We also check that new output values are " "approximately the same as the old ones." msgstr "" #: ../../../changes.txt:1397 96cbfad0c6cb404db15d7aa8d13c5f65 msgid "" "**Fixed** `#1738 `_. Leak" " of `pdf_graft_map`. Also fixed a SEGV issue that this seemed to expose, " "caused by incorrect freeing of underlying fz_document." msgstr "" #: ../../../changes.txt:1400 a1460a0ec164432ebbe35656a0272c02 msgid "" "**Fixed** `#1733 `_. " "Fixed ownership of `Annotation.get_pixmap()`." msgstr "" #: ../../../changes.txt:1402 1fb8672935f346f18177065d4a876d9b msgid "Changes to build/release process:" msgstr "" #: ../../../changes.txt:1404 d1f37ff28e754e3891af3658a6d2c4f7 msgid "" "If pip builds from source because an appropriate wheel is not available, " "we no longer require MuPDF to be pre-installed. Instead the required " "MuPDF source is embedded in the sdist and automatically built into " "PyMuPDF." msgstr "" #: ../../../changes.txt:1406 c6743d7a837547bfbd14121f922f188b msgid "" "Various changes to ``setup.py`` to download the required MuPDF release as" " required. See comments at start of setup.py for details." msgstr "" #: ../../../changes.txt:1408 2deed3b348e44634a95976500ca61ff1 msgid "" "Added ``.github/workflows/build_wheels.yml`` to control building of " "wheels on Github." msgstr "" #: ../../../changes.txt:1412 bfd2558d12c24e4ba3c0aee0edff3507 msgid "**Changes in Version 1.19.6**" msgstr "" #: ../../../changes.txt:1414 e9b569d9e70b42518f53a71536bd4f28 msgid "" "**Fixed** `#1620 `_. The " ":ref:`TextPage` created by :meth:`Page.get_textpage` will now be freed " "correctly (removed memory leak)." msgstr "" #: ../../../changes.txt:1415 058f760c8ce740e48a627eb2aee78a56 msgid "" "**Fixed** `#1601 `_. " "Document open errors should now be more concise and easier to interpret. " "In the course of this, two PyMuPDF-specific Python exceptions have been " "**added:**" msgstr "" #: ../../../changes.txt:1417 15ef5b12f13b4750a9571bf258d1dd43 msgid "" "``EmptyFileError`` -- raised when trying to create a :ref:`Document` " "(``fitz.open()``) from an empty file or zero-length memory." msgstr "" #: ../../../changes.txt:1418 f1c391fa54a1405ba4a28d352d108404 msgid "" "``FileDataError`` -- raised when MuPDF encounters irrecoverable document " "structure issues." msgstr "" #: ../../../changes.txt:1420 56b2878654114138ac79fad54cecad1b msgid "**Added** :meth:`Page.load_widget` given a PDF field's xref." msgstr "" #: ../../../changes.txt:1422 c0ece2db951a48efac1849cd7074f28e msgid "" "**Added** Dictionary :attr:`pdfcolor` which provide the about 500 colors " "defined as PDF color values with the lower case color name as key." msgstr "" #: ../../../changes.txt:1424 f9628cc364244bf3a41e4b3a8c2d40c6 msgid "" "**Added** algebra functionality to the :ref:`Quad` class. These objects " "can now also be added and subtracted among themselves, and be multiplied " "by numbers and matrices." msgstr "" #: ../../../changes.txt:1426 b66574a55e8d41d7accf7dd33f070642 msgid "" "**Added** new constants defining the default text extraction flags for " "more comfortable handling. Their naming convention is like " ":data:`TEXTFLAGS_WORDS` for ``page.get_text(\"words\")``. See " ":ref:`text_extraction_flags`." msgstr "" #: ../../../changes.txt:1428 8f6f15bc876b4df68cda93624b20a4ea msgid "" "**Changed** :meth:`Page.annots` and :meth:`Page.widgets` to detect and " "prevent reloading the page (illegally) inside the iterator loops via " ":meth:`Document.reload_page`. Doing this brings down the interpretor. " "Documented clean ways to do annotation and widget mass updates within " "properly designed loops." msgstr "" #: ../../../changes.txt:1430 287feb6044a2402d9651e9690ee78512 msgid "" "**Changed** several internal utility functions to become standalone " "(\"SWIG inline\") as opposed to be part of the :ref:`Tools` class. This, " "among other things, increases the performance of geometry object " "creation." msgstr "" #: ../../../changes.txt:1432 ec2b054b07e449debcbc15b510c35e5e msgid "" "**Changed** :meth:`Document.update_stream` to always accept stream " "updates - whether or not the dictionary object behind the xref already is" " a stream. Thus the former ``new`` parameter is now ignored and will be " "removed in v1.20.0." msgstr "" #: ../../../changes.txt:1437 89534acd0d50489793f84d93defb75d9 msgid "**Changes in Version 1.19.5**" msgstr "" #: ../../../changes.txt:1439 15c312e55ff84d4990200b73b5ab7088 msgid "" "**Fixed** `#1518 `_. A " "limited \"fix\": in some cases, rectangles and quadrupels were not " "correctly encoded to support re-drawing by :ref:`Shape`." msgstr "" #: ../../../changes.txt:1441 4ba09954c0b641a2926f1026d979da09 msgid "" "**Fixed** `#1521 `_. This" " had the same ultimate reason behind issue #1510." msgstr "" #: ../../../changes.txt:1443 dde5fa3810eb4a82b0aa2e61d8cf863b msgid "" "**Fixed** `#1513 `_. Some" " Optional Content functions did not support non-ASCII characters." msgstr "" #: ../../../changes.txt:1445 3d2e4740ec0b41b4aaad51d97655f8e9 msgid "" "**Fixed** `#1510 `_. " "Support more soft-mask image subtypes." msgstr "" #: ../../../changes.txt:1447 e79ebb09f5ea405a8ed23fbed6aa913a msgid "" "**Fixed** `#1507 `_. " "Immunize against items in the outlines chain, that are ``\"null\"`` " "objects." msgstr "" #: ../../../changes.txt:1449 cd737a2d921f4ee6929d54d756b3ca78 msgid "" "**Fixed** re-opened `#1417 " "`_. (\"too many open " "files\"). This was due to insufficient calls to MuPDF's " "``fz_drop_document()``. This also fixes `#1550 " "`_." msgstr "" #: ../../../changes.txt:1451 10995303e588406895c48eaa98334bdd msgid "" "**Fixed** several undocumented issues in relation to incorrectly setting " "the text span origin :data:`point_like`." msgstr "" #: ../../../changes.txt:1453 c395df4c98a441958d507eaf1a55d6de msgid "" "**Fixed** undocumented error computing the character bbox in method " ":meth:`Page.get_texttrace` when text is **flipped** (as opposed to just " "rotated)." msgstr "" #: ../../../changes.txt:1455 d82b9d2a17b64ddb90e236a9e42f1420 msgid "" "**Added** items to the dictionary returned by :meth:`image_properties`: " "``orientation`` and ``transform`` report the natural image orientation " "(EXIF data)." msgstr "" #: ../../../changes.txt:1457 30117ed837094556807bb67193004816 msgid "" "**Added** method :meth:`Document.xref_copy`. It will make a given target " "PDF object an exact copy of a source object." msgstr "" #: ../../../changes.txt:1462 c6cda05060f04f1080faf3f5125286a2 msgid "**Changes in Version 1.19.4**" msgstr "" #: ../../../changes.txt:1465 b2517533bd4f4096af88ca08d40edf65 msgid "" "**Fixed** `#1505 `_. " "Immunize against circular outline items." msgstr "" #: ../../../changes.txt:1467 a0d1479b30084068bad49749240fac45 msgid "" "**Fixed** `#1484 `_. " "Correct CropBox coordinates are now returned in all situations." msgstr "" #: ../../../changes.txt:1469 cf4a7ec57222449f974ef9027151cf36 msgid "**Fixed** `#1479 `_." msgstr "" #: ../../../changes.txt:1471 89d3111a652d4fe8809050d5c921e6ea msgid "" "**Fixed** `#1474 `_. " "TextPage objects are now properly deleted again." msgstr "" #: ../../../changes.txt:1473 ae6c28903fab4ede991daa53cbb1c7b1 msgid "" "**Added** :ref:`Page` methods and attributes for PDF ``/ArtBox``, " "``/BleedBox``, ``/TrimBox``." msgstr "" #: ../../../changes.txt:1475 d88880cbc50841bfa7c2c78158e9dd46 msgid "" "**Added** global attribute :attr:`TESSDATA_PREFIX` for easy checking of " "OCR support." msgstr "" #: ../../../changes.txt:1477 2be427b5e13c407995bd4f89c694dada msgid "" "**Changed** :meth:`Document.xref_set_key` such that dictionary keys will " "physically be removed if set to value ``\"null\"``." msgstr "" #: ../../../changes.txt:1479 2a9573afceb049e6b671e0432bd529be msgid "" "**Changed** :meth:`Document.extract_font` to optionally return a " "dictionary (instead of a tuple)." msgstr "" #: ../../../changes.txt:1483 4f57093fd45345639ada517bdde872fb msgid "**Changes in Version 1.19.3**" msgstr "" #: ../../../changes.txt:1485 18dfed128cbf40c38cad3ea42fd28a79 msgid "" "This patch version implements minor improvements for :ref:`Pixmap` and " "also some important fixes." msgstr "" #: ../../../changes.txt:1487 1296ee8815a942b6b05e865c50765b3b msgid "" "**Fixed** `#1351 `_." " Reverted code that introduced the memory growth in v1.18.15." msgstr "" #: ../../../changes.txt:1489 3fb4097c0d9c45d884b47f003b15344b msgid "" "**Fixed** `#1417 `_." " Developped circumvention for growth of open file handles using " ":meth:`Document.insert_pdf`." msgstr "" #: ../../../changes.txt:1491 770e6646f6e74afcb2d4d3dcf9c81366 msgid "" "**Fixed** `#1418 `_." " Developped circumvention for memory growth using " ":meth:`Document.insert_pdf`." msgstr "" #: ../../../changes.txt:1493 9689f4e9544c4246b896448b2322a17e msgid "" "**Fixed** `#1430 `_." " Developped circumvention for mass pixmap generations of document pages." msgstr "" #: ../../../changes.txt:1495 056b81d61e89402fb676e8fa87a24efc msgid "" "**Fixed** `#1433 `_." " Solves a bbox error for some Type 3 font in PyMuPDF text processing." msgstr "" #: ../../../changes.txt:1497 d99a708337c94a539ed17294cc959f0d msgid "" "**Added** :meth:`Pixmap.color_topusage` to determine the share of the " "most frequently used color. Solves `#1397 " "`_." msgstr "" #: ../../../changes.txt:1499 72e87358c82b4604b24eac87ac4b4a0f msgid "" "**Added** :meth:`Pixmap.warp` which makes a new pixmap from a given " "arbitrary convex quad inside the pixmap." msgstr "" #: ../../../changes.txt:1501 82fcb8b930d84658abdd8396247c78de msgid "" "**Added** :attr:`Annot.irt_xref` and :meth:`Annot.set_irt_xref` to " "inquire or set the `/IRT` (\"In Responde To\") property of an annotation." " Implements `#1450 " "`_." msgstr "" #: ../../../changes.txt:1503 9d4d189ab5d14fb799a720844599254d msgid "" "**Added** :meth:`Rect.torect` and :meth:`IRect.torect` which compute a " "matrix that transforms to a given other rectangle." msgstr "" #: ../../../changes.txt:1505 4efbe89603de46a59e1fac42a1a66f6a msgid "" "**Changed** :meth:`Pixmap.color_count` to also return the count of each " "color." msgstr "" #: ../../../changes.txt:1506 d98f12929cce4021be5db663b7606192 msgid "" "**Changed** :meth:`Page.get_texttrace` to also return correct span and " "character bboxes if ``span[\"dir\"] != (1, 0)``." msgstr "" #: ../../../changes.txt:1510 d093ad5f399047259588e551285fd994 msgid "**Changes in Version 1.19.2**" msgstr "" #: ../../../changes.txt:1512 2de7c1c23ba441aa92a089ee02a4635b msgid "" "This patch version implements minor improvements for " ":meth:`Page.get_drawings` and also some important fixes." msgstr "" #: ../../../changes.txt:1514 79ddabf469564139b54099c248dbd2b3 msgid "" "**Fixed** `#1388 `_." " Fixed intermittent memory corruption when insert or updating " "annotations." msgstr "" #: ../../../changes.txt:1516 3f76bb3657c5462ba1ebcdd58bdd3116 msgid "" "**Fixed** `#1375 `_." " Inconsistencies between line numbers as returned by the \"words\" and " "the \"dict\" options of :meth:`Page.get_text` have been corrected." msgstr "" #: ../../../changes.txt:1518 da3c5e5c691b4bf89bac0ae41797880b msgid "" "**Fixed** `#1364 `_. The " "check for being a ``\"rawdict\"`` span in :meth:`recover_span_quad` now " "works correctly." msgstr "" #: ../../../changes.txt:1520 63807063fb894a7e983829cafe298fe5 msgid "" "**Fixed** `#1342 `_. " "Corrected the check for rectangle infiniteness in " ":meth:`Page.show_pdf_page`." msgstr "" #: ../../../changes.txt:1522 517a112dc4114acab7f4f5c1b91d6fa8 msgid "" "**Changed** :meth:`Page.get_drawings`, :meth:`Page.get_cdrawings` to " "return an indicator on the area orientation covered by a rectangle. This " "implements `#1355 `_. " "Also, the recognition rate for rectangles and quads has been " "significantly improved." msgstr "" #: ../../../changes.txt:1524 dcddfb46c54741fd8eda15a642648605 msgid "" "**Changed** all text search and extraction methods to set the new " "``flags`` option ``TEXT_MEDIABOX_CLIP`` to ON by default. That bit causes" " the automatic suppression of all characters that are completely outside " "a page's mediabox (in as far as that notion is supported for a document " "type). This eliminates the need for using ``clip=page.rect`` or similar " "for omitting text outside the visible area." msgstr "" #: ../../../changes.txt:1526 f1b34d7957c44c178eece4e7a6585117 msgid "" "**Added** parameter ``\"dpi\"`` to :meth:`Page.get_pixmap` and " ":meth:`Annot.get_pixmap`. When given, parameter ``\"matrix\"`` is " "ignored, and a :ref:`Pixmap` with the desired dots per inch is created." msgstr "" #: ../../../changes.txt:1528 1317c20bf9004475b5d9e6eff7531e6d msgid "" "**Added** attributes :attr:`Pixmap.is_monochrome` and " ":attr:`Pixmap.is_unicolor` allowing fast checks of pixmap properties. " "Addresses `#1397 `_." msgstr "" #: ../../../changes.txt:1530 2f34d297248a424d9e4bd6390d4abd59 msgid "" "**Added** method :meth:`Pixmap.color_count` to determine the unique " "colors in the pixmap." msgstr "" #: ../../../changes.txt:1532 0eb08456d2ad4e70b01c79a2c2394012 msgid "" "**Added** boolean parameter ``\"compress\"`` to PDF document method " ":meth:`Document.update_stream`. Addresses / enables solution for `#1408 " "`_." msgstr "" #: ../../../changes.txt:1536 e801177ed48145dda1d2c1383f2b0ffc msgid "**Changes in Version 1.19.1**" msgstr "" #: ../../../changes.txt:1538 57c5fb9887f847ba933543ad12d8a479 msgid "" "This is the first patch version to support MuPDF v1.19.0. Apart from one " "bug fix, it includes important improvements for OCR support and the " "option to **sort extracted text** to the standard reading order \"from " "top-left to bottom-right\"." msgstr "" #: ../../../changes.txt:1540 650b810759ce426fb04200ced720f29f msgid "" "**Fixed** `#1328 `_. " "\"words\" text extraction again returns correct ``(x0, y0)`` coordinates." msgstr "" #: ../../../changes.txt:1542 3ba1314a889d44d78998ee7e4000e490 msgid "" "**Changed** :meth:`Page.get_textpage_ocr`: it now supports parameter " "``dpi`` to control OCR quality. It is also possible to choose whether the" " **full page** should be OCRed or **only the images displayed** by the " "page." msgstr "" #: ../../../changes.txt:1544 e63faaa903ec48a596466ba7c81be36a msgid "" "**Changed** :meth:`Page.get_drawings` and :meth:`Page.get_cdrawings` to " "automatically convert colors to RGB color tuples. Implements `#1332 " "`_. Similar change " "was applied to :meth:`Page.get_texttrace`." msgstr "" #: ../../../changes.txt:1546 478ae75188fb496dbd68e612249a93be msgid "" "**Changed** :meth:`Page.get_text` to support a parameter ``sort``. If set" " to ``True`` the output is conveniently sorted." msgstr "" #: ../../../changes.txt:1551 1fcee4618b1a4606bc1bb1cb00a3c04c msgid "**Changes in Version 1.19.0**" msgstr "" #: ../../../changes.txt:1553 ddc73ab2354e49519073ae9c706da26e msgid "" "This is the first version supporting MuPDF 1.19.*, published 2021-10-05. " "It introduces many new features compared to the previous version 1.18.*." msgstr "" #: ../../../changes.txt:1555 b350897b3a7d4af6a0a1184d0161e9f5 msgid "" "PyMuPDF has now picked up integrated Tesseract OCR support, which was " "already present in MuPDF v1.18.0." msgstr "" #: ../../../changes.txt:1557 35dd462d0329459bb8788ee6118ce5b5 msgid "" "Supported images can be OCRed via their :ref:`Pixmap` which results in a " "1-page PDF with a text layer." msgstr "" #: ../../../changes.txt:1558 40eb6a6a0deb477f802cfaa332cd816d msgid "" "All supported document pages (i.e. not only PDFs), can be OCRed using " "specialized text extraction methods. The result is a mixture of standard " "and OCR text (depending on which part of the page was deemed to require " "OCRing) that can be searched and extracted without restrictions." msgstr "" #: ../../../changes.txt:1559 734f1859407e4513b2cad5b0b02ac6f4 msgid "" "All this requires an independent installation of Tesseract. MuPDF " "actually (only) needs the location of Tesseract's ``\"tessdata\"`` " "folder, where its language support data are stored. This location must be" " available as environment variable ``TESSDATA_PREFIX``." msgstr "" #: ../../../changes.txt:1561 b0bd5ab69f33429697fd89f94ea87403 msgid "" "A new MuPDF feature is **journalling PDF updates**, which is also " "supported by this PyMuPDF version. Changes may be logged, rolled back or " "replayed, allowing to implement a whole new level of control over PDF " "document integrity -- similar to functions present in modern database " "systems." msgstr "" #: ../../../changes.txt:1563 c3bc9664f319416cbfbd764f183ecaf1 msgid "" "A third feature (unrelated to the new MuPDF version) includes the ability" " to detect when page **objects cover or hide each other**. It is now e.g." " possible to see that text is covered by a drawing or an image." msgstr "" #: ../../../changes.txt:1565 368ec08cb31e489e94e2d8a7e4ee86e4 msgid "" "**Changed** terminology and meaning of important geometry concepts: " "Rectangles are now characterized as *finite*, *valid* or *empty*, while " "the definitions of these terms have also changed. Rectangles specifically" " are now thought of being \"open\": not all corners and sides are " "considered part of the retangle. Please do read the :ref:`Rect` section " "for details." msgstr "" #: ../../../changes.txt:1567 6dd7d23a06ad4f14b2021126e1286e49 msgid "" "**Added** new parameter `\"no_new_id\"` to :meth:`Document.save` / " ":meth:`Document.tobytes` methods. Use it to suppress updating the second " "item of the document ``/ID`` which in PDF indicates that the original " "file has been updated. If the PDF has no ``/ID`` at all yet, then no new " "one will be created either." msgstr "" #: ../../../changes.txt:1569 de9906d677934e3c8dbe4a106dce7c74 msgid "" "**Added** a **journalling facility** for PDF updates. This allows logging" " changes, undoing or redoing them, or saving the journal for later use. " "Refer to :meth:`Document.journal_enable` and friends." msgstr "" #: ../../../changes.txt:1571 c4160924dc184c4b927a1b6297223458 msgid "" "**Added** new :ref:`Pixmap` methods :meth:`Pixmap.pdfocr_save` and " ":meth:`Pixmap.pdfocr_tobytes`, which generate a 1-page PDF containing the" " pixmap as PNG image with OCR text layer." msgstr "" #: ../../../changes.txt:1573 0e3c62d627264d9f8ffce673e0023b81 msgid "" "**Added** :meth:`Page.get_textpage_ocr` which executes optical character " "recognition for the page, then extracts the results and stores them " "together with \"normal\" page content in a :ref:`TextPage`. Use or reuse " "this object in subsequent text extractions and text searches to avoid " "multiple efforts. The existing text search and text extraction methods " "have been extended to support a separately created textpage -- see next " "item." msgstr "" #: ../../../changes.txt:1575 04ef1d300161437ba5b4e28ffed12386 msgid "" "**Added** a new parameter ``textpage`` to text extraction and text search" " methods. This allows reuse of a previously created :ref:`TextPage` and " "thus achieves significant runtime benefits -- which is especially " "important for the new OCR features. But \"normal\" text extractions can " "definitely also benefit." msgstr "" #: ../../../changes.txt:1577 a6d0664ee9d14b07908e08d426ef50e7 msgid "" "**Added** :meth:`Page.get_texttrace`, a technical method delivering low-" "level text character properties. It was present before as a private " "method, but the author felt it now is mature enough to be officially " "available. It specifically includes a \"sequence number\" which indicates" " the page appearance build operation that painted the text." msgstr "" #: ../../../changes.txt:1579 ccb6adfad05549ff96a7d75a2f08de75 msgid "" "**Added** :meth:`Page.get_bboxlog` which delivers the list of rectangles " "of page objects like text, images or drawings. Its significance lies in " "its sequence: rectangles intersecting areas with a lower index are " "covering or hiding them." msgstr "" #: ../../../changes.txt:1581 3edfcd55b842410ab082ab50b80e132f msgid "" "**Changed** methods :meth:`Page.get_drawings` and " ":meth:`Page.get_cdrawings` to include a \"sequence number\" indicating " "the page appearance build operation that created the drawing." msgstr "" #: ../../../changes.txt:1583 d4fd7415a1f44eb0b738d6f5df0af7cb msgid "" "**Fixed** `#1311 `_. " "Field values in comboboxes should now be handled correctly." msgstr "" #: ../../../changes.txt:1584 7733dd257974437aa148b45f6ada6568 msgid "" "**Fixed** `#1290 `_. " "Error was caused by incorrect rectangle emptiness check, which is fixed " "due to new geometry logic of this version." msgstr "" #: ../../../changes.txt:1585 f61c1c44cead4da28d5a0d498a515a7c msgid "" "**Fixed** `#1286 `_. Text" " alignment for redact annotations is working again." msgstr "" #: ../../../changes.txt:1586 bba07d14226e43b498663a99b03b7eb5 msgid "" "**Fixed** `#1287 `_. " "Infinite loop issue for non-Windows systems when applying some redactions" " has been resolved." msgstr "" #: ../../../changes.txt:1587 5324927b491340e983434647e41ce37e msgid "" "**Fixed** `#1284 `_. Text" " layout destruction after applying redactions in some cases has been " "resolved." msgstr "" #: ../../../changes.txt:1591 29ec5f63fdcc4f7b857449ced614ae34 msgid "**Changes in Version 1.18.18 / 1.18.19**" msgstr "" #: ../../../changes.txt:1593 629737c065e9445f96330c435e44d4dc msgid "" "**Fixed** issue `#1266 " "`_. Failure to set " ":attr:`Pixmap.samples` in important cases, was hotfixed in a new version " "1.18.19." msgstr "" #: ../../../changes.txt:1595 0abe968e8c8349d6991a7e4002c7cc03 msgid "" "**Fixed** issue `#1257 " "`_. Removing the read-" "only flag from PDF fields is now possible." msgstr "" #: ../../../changes.txt:1597 d5ee064120c44b55a574eb82a9b65093 msgid "" "**Fixed** issue `#1252 " "`_. Now correctly " "specifying the ``zoom`` value for PDF link annotations." msgstr "" #: ../../../changes.txt:1599 a7183e1808424b69a1a92a0c6c19251d msgid "" "**Fixed** issue `#1244 " "`_. Now correctly " "computing the transform matrix in :meth:`Page.get_image__bbox`." msgstr "" #: ../../../changes.txt:1601 5b909b03e5e84a92b114914838261915 msgid "" "**Fixed** issue `#1241 " "`_. Prevent returning " "artifact characters in :meth:`Page.get_textbox`, which happened in " "certain constellations." msgstr "" #: ../../../changes.txt:1603 76b7202d83754586a167674467627ca6 msgid "" "**Fixed** issue `#1234 " "`_. Avoid creating " "infinite rectangles in corner cases -- :meth:`Page.get_drawings`, " ":meth:`Page.get_cdrawings`." msgstr "" #: ../../../changes.txt:1605 11277e7c50c84168b89d7c869c0aeb1e msgid "" "**Added** test data and test scripts to the source PyPI source " "distribution." msgstr "" #: ../../../changes.txt:1609 490bf1a121f24135b3e3256666187363 msgid "**Changes in Version 1.18.17**" msgstr "" #: ../../../changes.txt:1611 d1e131b0d646485daf1c919e31b766d3 msgid "" "Focus of this version are major performance improvements of selected " "functions." msgstr "" #: ../../../changes.txt:1613 03ea6bb0f78c4d679bd6c08b450d9c4e msgid "" "**Fixed** issue `#1199 " "`_. Using a non-existing " "page number in :meth:`Document.get_page_images` and friends will no " "longer lead to segfaults." msgstr "" #: ../../../changes.txt:1615 0316ddf4a6a14b918ae314d88765508c msgid "" "**Changed** :meth:`Page.get_drawings` to now differentiate between " "\"stroke\", \"fill\" and combined paths. Paths containing more than one " "rectangle (i.e. \"re\" items) are now supported. Extracting \"clipped\" " "paths is now available as an option." msgstr "" #: ../../../changes.txt:1617 68269b90e4374ece9bcc4beae2a5d8ab msgid "" "**Added** :meth:`Page.get_cdrawings`, performance-optimized version of " ":meth:`Page.get_drawings`." msgstr "" #: ../../../changes.txt:1619 b9fdb8798cef43d6af0ab313e6117152 msgid "" "**Added** :attr:`Pixmap.samples_mv`, *memoryview* of a pixmap's pixel " "area. Does not copy and thus always accesses the current state of that " "area." msgstr "" #: ../../../changes.txt:1621 b4530586fbcc46de94110b7f601c43dd msgid "" "**Added** :attr:`Pixmap.samples_ptr`, Python \"pointer\" to a pixmap's " "pixel area. Allows much faster creation (factor 800+) of Qt images." msgstr "" #: ../../../changes.txt:1627 494c735b3a214b2bb172c9afb76b92b1 msgid "**Changes in Version 1.18.16**" msgstr "" #: ../../../changes.txt:1629 9320ef32a6ec458db091ec9991261f2f msgid "" "**Fixed** issue `#1184 " "`_. Existing PDF widget " "fonts in a PDF are now accepted (i.e. not forcedly changed to a Base-14 " "font)." msgstr "" #: ../../../changes.txt:1631 159b6408c2ea4b86a063f21fcce0b7de msgid "" "**Fixed** issue `#1154 " "`_. Text search hits " "should now be correct when ``clip`` is specified." msgstr "" #: ../../../changes.txt:1633 e98ab6e601d143ab99e23ce8ac756e25 msgid "**Fixed** issue `#1152 `_." msgstr "" #: ../../../changes.txt:1635 0793a7276f6a47c7833dc4f02c69c59c msgid "**Fixed** issue `#1146 `_." msgstr "" #: ../../../changes.txt:1637 634669f89d54425fabf3395cef374ae3 msgid "" "**Added** :attr:`Link.flags` and :meth:`Link.set_flags` to the " ":ref:`Link` class. Implements enhancement requests `#1187 " "`_." msgstr "" #: ../../../changes.txt:1639 f0c43b248f16409a8f0905afee41db5d msgid "" "**Added** option to *simulate* :meth:`TextWriter.fill_textbox` output for" " predicting the number of lines, that a given text would occupy in the " "textbox." msgstr "" #: ../../../changes.txt:1641 7ed434aeca7e4c8283c2ce9ac764e204 msgid "" "**Added** text output support as subcommand `gettext` to the ``fitz`` CLI" " module. Most importantly, original **physical text layout** reproduction" " is now supported." msgstr "" #: ../../../changes.txt:1646 7a61839613704cb6ba89df11cfd8e0c5 msgid "**Changes in Version 1.18.15**" msgstr "" #: ../../../changes.txt:1648 76b9d70df76946379cb92b397413d1b1 msgid "" "**Fixed** issue `#1088 " "`_. Removing an " "annotation's fill color should now work again both ways, using the " "``fill_color=[]`` argument in :meth:`Annot.update` as well as ``fill=[]``" " in :meth:`Annot.set_colors`." msgstr "" #: ../../../changes.txt:1650 be8edc4369ba4c6d92c42fd279c10a37 msgid "" "**Fixed** issue `#1081 " "`_. " ":meth:`Document.subset_fonts`: fixed an error which created wrong " "character widths for some fonts." msgstr "" #: ../../../changes.txt:1652 c86ec8d5f336461a9a82cf58dab23bca msgid "" "**Fixed** issue `#1078 " "`_. :meth:`Page.get_text`" " and other methods related to text extraction: changed the default value " "of the :ref:`TextPage` ``flags`` parameter. All whitespace and " ":data:`ligatures` are now preserved." msgstr "" #: ../../../changes.txt:1654 6bf853d1b4f24ed3b493acbbaf102307 msgid "" "**Fixed** issue `#1085 " "`_. The old *snake_cased*" " alias of ``fitz.detTextlength`` is now defined correctly." msgstr "" #: ../../../changes.txt:1656 0974e8722a4445e0894e2188d5074069 msgid "" "**Changed** :meth:`Document.subset_fonts` will now correctly prefix font " "subsets with an appropriate six letter uppercase tag, complying with the " "PDF specification." msgstr "" #: ../../../changes.txt:1658 437884a2beb34834be5a5813ff146205 msgid "" "**Added** new method :meth:`Widget.button_states` which returns the " "possible values that a button-type field can have when being set to " "\"on\" or \"off\"." msgstr "" #: ../../../changes.txt:1660 e165a6b51c0c42f6ac55bb2164ed36ce msgid "" "**Added** support of text with **Small Capital** letters to the " ":ref:`Font` and :ref:`TextWriter` classes. This is reflected by an " "additional bool parameter ``small_caps`` in various of their methods." msgstr "" #: ../../../changes.txt:1665 5fa6df6719ec4a30bc5737a2250ddf26 msgid "**Changes in Version 1.18.14**" msgstr "" #: ../../../changes.txt:1667 246831ba1ef247c09cc05eb90a12135b msgid "" "**Finished** implementing new, \"snake_cased\" names for methods and " "properties, that were \"camelCased\" and awkward in many aspects. At the " "end of this documentation, there is section :ref:`Deprecated` with more " "background and a mapping of old to new names." msgstr "" #: ../../../changes.txt:1669 e9896e6c30074ac28de21b72e13344fd msgid "" "**Fixed** issue `#1053 " "`_. " ":meth:`Page.insert_image`: when given, include image mask in the hash " "computation." msgstr "" #: ../../../changes.txt:1671 856342d7e04c4c05ad362a20f30a00c5 msgid "" "**Fixed** issue `#1043 " "`_. Added " "``Pixmap.getPNGdata`` to the aliases of :meth:`Pixmap.tobytes`." msgstr "" #: ../../../changes.txt:1673 a40ac7bfdd1d4c329450f6a5ba99872e msgid "" "**Fixed** an internal error when computing the enveloping rectangle of " "drawn paths as returned by :meth:`Page.get_drawings`." msgstr "" #: ../../../changes.txt:1675 dae13ebf211f48aaa0f6305a01c8c616 msgid "" "**Fixed** an internal error occasionally causing loops when outputting " "text via :meth:`TextWriter.fill_textbox`." msgstr "" #: ../../../changes.txt:1677 944833cd11d14508b1e6e8fa1a487586 msgid "" "**Added** :meth:`Font.char_lengths`, which returns a tuple of character " "widths of a string." msgstr "" #: ../../../changes.txt:1679 4c127faaaa4542d68be1974e72156cdb msgid "" "**Added** more ways to specify pages in :meth:`Document.delete_pages`. " "Now a sequence (list, tuple or range) can be specified, and the Python " "``del`` statement can be used. In the latter case, Python ``slices`` are " "also accepted." msgstr "" #: ../../../changes.txt:1681 06fd838ceb61465d9f689dfd3aebbab2 msgid "" "**Changed** :meth:`Document.del_toc_item`, which disables a single item " "of the TOC: previously, the title text was removed. Instead, now the " "complete item will be shown grayed-out by supporting viewers." msgstr "" #: ../../../changes.txt:1686 7a4fd8bb15ab4fbcaaa183993d721089 msgid "**Changes in Version 1.18.13**" msgstr "" #: ../../../changes.txt:1688 aeb68fdb27db43d68f6b5362aa749391 msgid "**Fixed** issue `#1014 `_." msgstr "" #: ../../../changes.txt:1689 8ee7d51d2b5941f8b64a7092fe06f789 msgid "" "**Fixed** an internal memory leak when computing image bboxes -- " ":meth:`Page.get_image_bbox`." msgstr "" #: ../../../changes.txt:1690 6e3c2aaf0d0b4752b02aa8c91326937e msgid "" "**Added** support for low-level access and modification of the PDF " "trailer. Applies to :meth:`Document.xref_get_keys`, " ":meth:`Document.xref_get_key`, and :meth:`Document.xref_set_key`." msgstr "" #: ../../../changes.txt:1691 d26b610465374b1a95f57d151f841d2e msgid "**Added** documentation for maintaining private entries in PDF metadata." msgstr "" #: ../../../changes.txt:1692 49f75a7ada254386acc0d8b341ed91c6 msgid "" "**Added** documentation for handling transparent image insertions, " ":meth:`Page.insert_image`." msgstr "" #: ../../../changes.txt:1693 457c2b1325b24f60ab107fe02a4e0085 msgid "" "**Added** :meth:`Page.get_image_rects`, an improved version of " ":meth:`Page.get_image_bbox`." msgstr "" #: ../../../changes.txt:1694 a7471bfaf29b46c0bf1baba965058c8b msgid "" "**Changed** :meth:`Document.delete_pages` to support various ways of " "specifying pages to delete. Implements `#1042 " "`_." msgstr "" #: ../../../changes.txt:1695 3f2e525e5db5466cbf2b21ae6e3e9c36 msgid "" "**Changed** :meth:`Page.insert_image` to also accept the xref of an " "existing image in the file. This allows \"copying\" images between pages," " and extremely fast mutiple insertions." msgstr "" #: ../../../changes.txt:1696 819681238cbc4a129e57b370dfb026fc msgid "" "**Changed** :meth:`Page.insert_image` to also accept the integer " "parameter ``alpha``. To be used for performance improvements." msgstr "" #: ../../../changes.txt:1697 43b014e80e8041ce88847b0848cd3523 msgid "" "**Changed** :meth:`Pixmap.set_alpha` to support new parameters for pre-" "multiplying colors with their alpha values and setting a specific color " "to fully transparent (e.g. white)." msgstr "" #: ../../../changes.txt:1698 d00c4f08df31471e976b37826d70cb1c msgid "" "**Changed** :meth:`Document.embfile_add` to automatically set creation " "and modification date-time. Correspondingly, :meth:`Document.embfile_upd`" " automatically maintains modification date-time (``/ModDate`` PDF key), " "and :meth:`Document.embfile_info` correspondingly reports these data. In " "addition, the embedded file's associated \"collection item\" is included " "via its :data:`xref`. This supports the development of PDF portfolio " "applications." msgstr "" #: ../../../changes.txt:1702 d6c3f0ac21134173a004ebfa78fe2315 msgid "**Changes in Version 1.18.11 / 1.18.12**" msgstr "" #: ../../../changes.txt:1704 5c6ecd8a73da4cd6a54e60917ddff07a msgid "" "**Fixed** issue `#972 `_. " "Improved layout of source distribution material." msgstr "" #: ../../../changes.txt:1705 086168881dcc4f639364df509a6877b1 msgid "" "**Fixed** issue `#962 `_. " "Stabilized Linux distribution detection for generating PyMuPDF from " "sources." msgstr "" #: ../../../changes.txt:1706 3a60973423d2463aa5423dc31856ba76 msgid "" "**Added:** :meth:`Page.get_xobjects` delivers the result of " ":meth:`Document.get_page_xobjects`." msgstr "" #: ../../../changes.txt:1707 a0b89ac75a28458fb93356628c87d9ab msgid "" "**Added:** :meth:`Page.get_image_info` delivers meta information for all " "images shown on the page." msgstr "" #: ../../../changes.txt:1708 9e865b21aa37414dbfea24ec37e19b67 msgid "" "**Added:** :meth:`Tools.mupdf_display_warnings` allows setting on / off " "the display of MuPDF-generated warnings. The default is off." msgstr "" #: ../../../changes.txt:1709 e3d2420ee8c24d1aa43455c800972e3c msgid "" "**Added:** :meth:`Document.ez_save` convenience alias of " ":meth:`Document.save` with some different defaults." msgstr "" #: ../../../changes.txt:1710 7007006565b94595b23bf039c3e09338 msgid "" "**Changed:** Image extractions of document pages now also contain the " "image's **transformation matrix**. This concerns " ":meth:`Page.get_image_bbox` and the DICT, JSON, RAWDICT, and RAWJSON " "variants of :meth:`Page.get_text`." msgstr "" #: ../../../changes.txt:1715 62af1c5f6b62467897742422e1590f7d msgid "**Changes in Version 1.18.10**" msgstr "" #: ../../../changes.txt:1717 922707d45703479bbd67527180a768ec msgid "" "**Fixed** issue `#941 `_. " "Added old aliases for :meth:`DisplayList.get_pixmap` and " ":meth:`DisplayList.get_textpage`." msgstr "" #: ../../../changes.txt:1718 5f5903a43c1f44a3bf154f3b1530d64a msgid "" "**Fixed** issue `#929 `_. " "Stabilized removal of JavaScript objects with :meth:`Document.scrub`." msgstr "" #: ../../../changes.txt:1719 0972fadf04e741629d46a18515526a9d msgid "" "**Fixed** issue `#927 `_. " "Removed a loop in the reworked :meth:`TextWriter.fill_textbox`." msgstr "" #: ../../../changes.txt:1720 033e96b4eceb4014bd5620c1e986198d msgid "" "**Changed** :meth:`Document.xref_get_keys` and " ":meth:`Document.xref_get_key` to also allow accessing the PDF trailer " "dictionary. This can be done by using `-1` as the xref number argument." msgstr "" #: ../../../changes.txt:1721 74ff56e5727c43138b496604bbfe57f9 msgid "" "**Added** a number of functions for reconstructing the quads for text " "lines, spans and characters extracted by :meth:`Page.get_text` options " "\"dict\" and \"rawdict\". See :meth:`recover_quad` and friends." msgstr "" #: ../../../changes.txt:1722 29aa32686d874d42b22bfa8a3901aa14 msgid "" "**Added** :meth:`Tools.unset_quad_corrections` to suppress character quad" " corrections (occasionally required for erroneous fonts)." msgstr "" #: ../../../changes.txt:1726 3a7453ab65404c52984aee45364e6724 msgid "**Changes in Version 1.18.9**" msgstr "" #: ../../../changes.txt:1729 e1b22c2f9fe54eb993a50fcd6112601f msgid "" "**Fixed** issue `#888 `_. " "Removed ambiguous statements concerning PyMuPDF's license, which is now " "clearly stated to be GNU AGPL V3." msgstr "" #: ../../../changes.txt:1730 f4d998abf2364f48a156cb6de76c69b7 msgid "**Fixed** issue `#895 `_." msgstr "" #: ../../../changes.txt:1731 69b074661fb04a1c9748f0ae259d8153 msgid "" "**Fixed** issue `#896 `_. " "Since v1.17.6 PyMuPDF suppresses the font subset tags and only reports " "the base fontname in text extraction outputs \"dict\" / \"json\" / " "\"rawdict\" / \"rawjson\". Now a new global parameter can request the old" " behaviour, :meth:`Tools.set_subset_fontnames`." msgstr "" #: ../../../changes.txt:1732 0e51b11e295245bdb5143f3055f5f4c6 msgid "" "**Fixed** issue `#885 `_. " "Pixmap creation now also works with filenames given as ``pathlib.Paths``." msgstr "" #: ../../../changes.txt:1733 3bfe043f395249f2ad66c8714a4dcd24 msgid "" "**Changed** :meth:`Document.subset_fonts`: Text is **not rewritten** any " "more and should therefore **retain all its origial properties** -- like " "being hidden or being controlled by Optional Content mechanisms." msgstr "" #: ../../../changes.txt:1734 23ad1d2d69494a61b31f3bf6e0d688e0 msgid "" "**Changed** :ref:`TextWriter` output to also accept text in right to left" " mode (Arabian, Hebrew): :meth:`TextWriter.fill_textbox`, " ":meth:`TextWriter.append`. These methods now accept a new boolean " "parameter `right_to_left`, which is *False* by default. Implements `#897 " "`_." msgstr "" #: ../../../changes.txt:1735 27997725f8e4450c87939082e366439e msgid "" "**Changed** :meth:`TextWriter.fill_textbox` to return all lines of text, " "that did not fit in the given rectangle. Also changed the default of the " "``warn`` parameter to no longer print a warning message in overflow " "situations." msgstr "" #: ../../../changes.txt:1736 66e2fd480ef348c094149914650471d0 msgid "" "**Added** a utility function :meth:`recover_quad`, which computes the " "quadrilateral of a span. This function can be used for correctly marking " "text extracted with the \"dict\" or \"rawdict\" options of " ":meth:`Page.get_text`." msgstr "" #: ../../../changes.txt:1740 dce8476d6a3749f89835fc274cdabd84 msgid "**Changes in Version 1.18.8**" msgstr "" #: ../../../changes.txt:1743 fa20b571b5c14e288bfcba7b82655bee msgid "" "This is a bug fix version only. We are publishing early because of the " "potentially widely used functions." msgstr "" #: ../../../changes.txt:1745 21142c13d0cd44bea29198c954e7f0e6 msgid "" "**Fixed** issue `#881 `_. " "Fixed a memory leak in :meth:`Page.insert_image` when inserting images " "from files or memory." msgstr "" #: ../../../changes.txt:1746 5f457acfd5954696ae76970b611ac49a msgid "" "**Fixed** issue `#878 `_. " "``pathlib.Path`` objects should now correctly handle file path " "hierarchies." msgstr "" #: ../../../changes.txt:1751 85971c3fb54e449190448842ef48209a msgid "**Changes in Version 1.18.7**" msgstr "" #: ../../../changes.txt:1754 fbe2287c70d74d55bfa1dd7a61d1a827 msgid "" "**Added** an experimental :meth:`Document.subset_fonts` which reduces the" " size of eligible fonts based on their use by text in the PDF. Implements" " `#855 `_." msgstr "" #: ../../../changes.txt:1755 e300f81c0c2a414a95786dc2a5b922be msgid "" "**Implemented** request `#870 " "`_: " ":meth:`Document.convert_to_pdf` now also supports PDF documents." msgstr "" #: ../../../changes.txt:1756 8b39542efeb8486782751bc4045f8c45 msgid "" "**Renamed** ``Document.write`` to :meth:`Document.tobytes` for greater " "clarity. But the deprecated name remains available for some time." msgstr "" #: ../../../changes.txt:1757 6717eb5a2cfb422a8b239e698e9d1a4e msgid "" "**Implemented** request `#843 " "`_: " ":meth:`Document.tobytes` now supports linearized PDF output. " ":meth:`Document.save` now also supports writing to Python **file " "objects**. In addition, the open function now also supports Python file " "objects." msgstr "" #: ../../../changes.txt:1758 318196b9b9f24559b099a5a3b86b61a3 msgid "**Fixed** issue `#844 `_." msgstr "" #: ../../../changes.txt:1759 22303a902c214152a94cf6908eaada79 msgid "**Fixed** issue `#838 `_." msgstr "" #: ../../../changes.txt:1760 8d1575cb41f944d1ab091d1f15fdfe3f msgid "" "**Fixed** issue `#823 `_. " "More logic for better support of OCRed text output (Tesseract, ABBYY)." msgstr "" #: ../../../changes.txt:1761 938fa234a4d64b4998e755f30a353917 msgid "**Fixed** issue `#818 `_." msgstr "" #: ../../../changes.txt:1762 5b25601056b641bebbe1fdbe9fbf59fc msgid "**Fixed** issue `#814 `_." msgstr "" #: ../../../changes.txt:1763 b4352fd5bf734216a09bc2b65068a9a1 msgid "" "**Added** :meth:`Document.get_page_labels` which returns a list of page " "label definitions of a PDF." msgstr "" #: ../../../changes.txt:1764 d10d74d2add045f19432215b68dc5965 msgid "" "**Added** :meth:`Document.has_annots` and :meth:`Document.has_links` to " "check whether these object types are present anywhere in a PDF." msgstr "" #: ../../../changes.txt:1765 344e56b009634edaa8a7654870785c6a msgid "" "**Added** expert low-level functions to simplify inquiry and modification" " of PDF object sources: :meth:`Document.xref_get_keys` lists the keys of " "object :data:`xref`, :meth:`Document.xref_get_key` returns type and " "content of a key, and :meth:`Document.xref_set_key` modifies the key's " "value." msgstr "" #: ../../../changes.txt:1766 97ffd95b565242c8a475c6f2123f9b83 msgid "" "**Added** parameter ``thumbnails`` to :meth:`Document.scrub` to also " "allow removing page thumbnail images." msgstr "" #: ../../../changes.txt:1767 be54a84b631a4f539269cea4d2530c10 msgid "" "**Improved** documentation for how to add valid text marker annotations " "for non-horizontal text." msgstr "" #: ../../../changes.txt:1769 7ec7306e128341c2a63a9daaf99494bb msgid "" "We continued the process of renaming methods and properties from " "*\"mixedCase\"* to *\"snake_case\"*. Documentation usually mentions the " "new names only, but old, deprecated names remain available for some time." msgstr "" #: ../../../changes.txt:1775 40b8c78ac8154766b3f786804b70d764 msgid "**Changes in Version 1.18.6**" msgstr "" #: ../../../changes.txt:1777 099ac66b71ab437b8f793444fbf3c368 msgid "**Fixed** issue `#812 `_." msgstr "" #: ../../../changes.txt:1778 8d754c7625ba4e16b8b1d2da2931571c msgid "" "**Fixed** issue `#793 `_. " "Invalid document metadata previously prevented opening some documents at " "all. This error has been removed." msgstr "" #: ../../../changes.txt:1779 b6756d8e13654194ae64028173969354 msgid "" "**Fixed** issue `#792 `_. " "Text search and text extraction will make no rectangle containment checks" " at all if the default ``clip=None`` is used." msgstr "" #: ../../../changes.txt:1780 f3374a74399e41139ae1b0fd15053232 msgid "**Fixed** issue `#785 `_." msgstr "" #: ../../../changes.txt:1781 6f0ad41d3e0845679fc1b7f630d9350e msgid "" "**Fixed** issue `#780 `_. " "Corrected a parameter check error." msgstr "" #: ../../../changes.txt:1782 a9af2b2f5b024f1d90aca0eed1eff596 msgid "" "**Fixed** issue `#779 `_. " "Fixed typo" msgstr "" #: ../../../changes.txt:1783 52e2c5d1e3734d0b9c1eafeea70502c0 msgid "" "**Added** an option to set the desired line height for text boxes. " "Implements `#804 `_." msgstr "" #: ../../../changes.txt:1784 8a89dd2499fa4288aa2e4376409bc950 msgid "" "**Changed** text position retrieval to better cope with Tesseract's " "glyphless font. Implements `#803 " "`_." msgstr "" #: ../../../changes.txt:1785 1c3abaa13d464f07839341b87f7b065c msgid "" "**Added** an option to choose the prefix of new annotations, fields and " "links for providing unique annotation ids. Implements request `#807 " "`_." msgstr "" #: ../../../changes.txt:1786 705f241926b94e4faed825b90187d9a8 msgid "" "**Added** getting and setting color and text properties for Table of " "Contents items for PDFs. Implements `#779 " "`_." msgstr "" #: ../../../changes.txt:1787 f290b3e394a643ef92eb166d6ac700ba msgid "" "**Added** PDF page label handling: :meth:`Page.get_label()` returns the " "page label, :meth:`Document.get_page_numbers` return all page numbers " "having a specified label, and :meth:`Document.set_page_labels` adds or " "updates a PDF's page label definition." msgstr "" #: ../../../changes.txt:1792 204e52071aeb4560ad583594170382fc msgid "" "This version introduces **Python type hinting**. The goal is to provide " "each parameter and the return value of all functions and methods with " "type information. This still is work in progress although the majority of" " functions has already been handled." msgstr "" #: ../../../changes.txt:1797 ff861662db5c4fe985c61a23a602d0ab msgid "**Changes in Version 1.18.5**" msgstr "" #: ../../../changes.txt:1799 8972338cdcc14af3a7644a3dcddf69e2 msgid "" "Apart from several fixes, this version also focusses on several minor, " "but important feature improvements. Among the latter is a more precise " "computation of proper line heights and insertion points for writing / " "inserting text. As opposed to using font-agnostic constants, these values" " are now taken from the font's properties." msgstr "" #: ../../../changes.txt:1801 f9a9d31367f946218578af60d466b702 msgid "" "Also note that this is the first version which does no longer provide " "pregenerated wheels for Python versions older than 3.6. PIP also " "discontinues support for these by end of this year 2020." msgstr "" #: ../../../changes.txt:1803 93396822ddee484c904221f0e650bb40 msgid "" "**Fixed** issue `#771 `_. " "By using \"small glyph heights\" option, the full page text can be " "extracted." msgstr "" #: ../../../changes.txt:1804 4283660ecb4e497a8d5f66c223269138 msgid "**Fixed** issue `#768 `_." msgstr "" #: ../../../changes.txt:1805 cb94c9971f18482b8a6116bac1e91eda msgid "**Fixed** issue `#750 `_." msgstr "" #: ../../../changes.txt:1806 0f4ccdc52d33496780a6883b3eac2040 msgid "" "**Fixed** issue `#739 `_. " "The \"dict\", \"rawdict\" and corresponding JSON output variants now have" " two new *span* keys: ``\"ascender\"`` and ``\"descender\"``. These " "floats represent special font properties which can be used to compute " "bboxes of spans or characters of **exactly fontsize height** (as opposed " "to the default line height). An example algorithm is shown in section " "\"Span Dictionary\" `here " "`_. Also improved the " "detection and correction of ill-specified ascender / descender values " "encountered in some fonts." msgstr "" #: ../../../changes.txt:1807 46d09243233b47bfabfb624aabe62a7f msgid "" "**Added** a new, experimental :meth:`Tools.set_small_glyph_heights` -- " "also in response to issue `#739 " "`_. This method sets or " "unsets a global parameter to **always compute bboxes with fontsize " "height**. If \"on\", text searching and all text extractions will " "returned rectangles, bboxes and quads with a smaller height." msgstr "" #: ../../../changes.txt:1808 2348f09c087f4e77a9552300a273b2f9 msgid "**Fixed** issue `#728 `_." msgstr "" #: ../../../changes.txt:1809 24ffb89f8a2847978a993810a34d9d8e msgid "" "**Changed** fill color logic of 'Polyline' annotations: this parameter " "now only pertains to line end symbols -- the annotation itself can no " "longer have a fill color. Also addresses issue `#727 " "`_." msgstr "" #: ../../../changes.txt:1810 d11988b7d91c474394a305026cbdac36 msgid "" "**Changed** :meth:`Page.getImageBbox` to also compute the bbox if the " "image is contained in an XObject." msgstr "" #: ../../../changes.txt:1811 92be2318a74e44bcbfe6d9d124cc6944 msgid "" "**Changed** :meth:`Shape.insertTextbox`, resp. " ":meth:`Page.insertTextbox`, resp. :meth:`TextWriter.fillTextbox` to " "respect font's properties \"ascender\" / \"descender\" when computing " "line height and insertion point. This should no longer lead to line " "overlaps for multi-line output. These methods used to ignore font " "specifics and used constant values instead." msgstr "" #: ../../../changes.txt:1816 726b3c851a2742a08174e040daa6b3fc msgid "**Changes in Version 1.18.4**" msgstr "" #: ../../../changes.txt:1818 0669695e181f46b8b1d1c44f84c7cc1e msgid "" "This version adds several features to support PDF Optional Content. Among" " other things, this includes OCMDs (Optional Content Membership " "Dictionaries) with the full scope of *\"visibility expressions\"* (PDF " "key ``/VE``), text insertions (including the :ref:`TextWriter` class) and" " drawings." msgstr "" #: ../../../changes.txt:1820 298b682a9c8e4b17b5d9c2763ce13305 msgid "" "**Fixed** issue `#727 `_. " "Freetext annotations now support an uncolored rectangle when " "``fill_color=None``." msgstr "" #: ../../../changes.txt:1821 2e4c66207d0441dd87fc8dee4d8db80f msgid "" "**Fixed** issue `#726 `_. " "UTF-8 encoding errors are now handled for HTML / XML :meth:`Page.getText`" " output." msgstr "" #: ../../../changes.txt:1822 e3ea52520ca74100aa5db3c1a47bcb22 msgid "" "**Fixed** issue `#724 `_. " "Empty values are no longer stored in the PDF /Info metadata dictionary." msgstr "" #: ../../../changes.txt:1823 a76c87f209e9404ea2a27260f984c079 msgid "" "**Added** new methods :meth:`Document.set_oc` and :meth:`Document.get_oc`" " to set or get optional content references for **existing** image and " "form XObjects. These methods are similar to the same-named methods of " ":ref:`Annot`." msgstr "" #: ../../../changes.txt:1824 6ae1cf58b5734e2db334370bae53194f msgid "" "**Added** :meth:`Document.set_ocmd`, :meth:`Document.get_ocmd` for " "handling OCMDs." msgstr "" #: ../../../changes.txt:1825 02c47a051f444e57a07a5c2cc00d8ece msgid "**Added** **Optional Content** support for text insertion and drawing." msgstr "" #: ../../../changes.txt:1826 033f5fd3092446d89a8b4be25eaf8fa5 msgid "" "**Added** new method :meth:`Page.deleteWidget`, which deletes a form " "field from a page. This is analogous to deleting annotations." msgstr "" #: ../../../changes.txt:1827 f3f7aabfa367473eb2a71dd0d3b0c8ef msgid "" "**Added** support for Popup annotations. This includes defining the Popup" " rectangle and setting the Popup to open or closed. Methods / attributes " ":meth:`Annot.set_popup`, :meth:`Annot.set_open`, :attr:`Annot.has_popup`," " :attr:`Annot.is_open`, :attr:`Annot.popup_rect`, " ":attr:`Annot.popup_xref`." msgstr "" #: ../../../changes.txt:1831 fff305ae1bfa4fa7a3b33de7de989103 msgid "" "The **naming of methods and attributes** in PyMuPDF is far from being " "satisfactory: we have *CamelCases*, *mixedCases* and " "*lower_case_with_underscores* all over the place. With the :ref:`Annot` " "as the first candidate, we have started an activity to clean this up step" " by step, converting to lower case with underscores for methods and " "attributes while keeping UPPERCASE for the constants." msgstr "" #: ../../../changes.txt:1833 5a5df8a85edd445a9168a3050257beb0 msgid "" "Old names will remain available to prevent code breaks, but they will no " "longer be mentioned in the documentation." msgstr "" #: ../../../changes.txt:1834 d9dd3ce555be40288946b5c7b8684d7d msgid "" "New methods and attributes of all classes will be named according to the " "new standard." msgstr "" #: ../../../changes.txt:1838 8d1aa669d43242329cb1e644baaea966 msgid "**Changes in Version 1.18.3**" msgstr "" #: ../../../changes.txt:1840 0cc7942ae4f54d4698a56df9bcfc4df1 msgid "" "As a major new feature, this version introduces support for PDF's " "**Optional Content** concept." msgstr "" #: ../../../changes.txt:1842 eba5a3b05af340fd8d30d56d8053156a msgid "**Fixed** issue `#714 `_." msgstr "" #: ../../../changes.txt:1843 e0d1304eda394d6a88565ba84484d6fe msgid "**Fixed** issue `#711 `_." msgstr "" #: ../../../changes.txt:1844 bc199ec49e1945f1947218cd0c858828 msgid "" "**Fixed** issue `#707 `_: " "if a PDF user password, but no owner password is supplied nor present, " "then the user password is also used as the owner password." msgstr "" #: ../../../changes.txt:1845 1e99eff725e24f2f91fffda242611187 msgid "" "**Fixed** ``expand`` and ``deflate`` parameters of methods " ":meth:`Document.save` and :meth:`Document.write`. Individual image and " "font compression should now finally work. Addresses issue `#713 " "`_." msgstr "" #: ../../../changes.txt:1846 c7dbcce5af3f4805bc0bff4a3aa999c8 msgid "" "**Added** a support of PDF optional content. This includes several new " ":ref:`Document` methods for inquiring and setting optional content status" " and adding optional content configurations and groups. In addition, " "images, form XObjects and annotations now can be bound to optional " "content specifications. **Resolved** issue `#709 " "`_." msgstr "" #: ../../../changes.txt:1852 7005feac30d44416a7ae56c3c62aa421 msgid "**Changes in Version 1.18.2**" msgstr "" #: ../../../changes.txt:1854 2557dd6711e74c5687da189106d7b072 msgid "" "This version contains some interesting improvements for text searching: " "any number of search hits is now returned and the **hit_max** parameter " "was removed. The new **clip** parameter in addition allows to restrict " "the search area. Searching now detects hyphenations at line breaks and " "accordingly finds hyphenated words." msgstr "" #: ../../../changes.txt:1856 f5a9d7fa7c5b434388c99b444417932e msgid "" "**Fixed** issue `#575 `_: " "if using ``quads=False`` in text searching, then overlapping rectangles " "on the same line are joined. Previously, parts of the search string, " "which belonged to different \"marked content\" items, each generated " "their own rectangle -- just as if occurring on separate lines." msgstr "" #: ../../../changes.txt:1857 fa0f315fcdbb4aa7a85ebd875b0542b2 msgid "" "**Added** :attr:`Document.isRepaired`, which is true if the PDF was " "repaired on open." msgstr "" #: ../../../changes.txt:1858 29939ef23137444db25656ddb5c2a50b msgid "" "**Added** :meth:`Document.setXmlMetadata` which either updates or creates" " PDF XML metadata. Implements issue `#691 " "`_." msgstr "" #: ../../../changes.txt:1859 be99f9d509a84865a76d789e59d88508 msgid "**Added** :meth:`Document.getXmlMetadata` returns PDF XML metadata." msgstr "" #: ../../../changes.txt:1860 b5792e748a424e2f81526972850dbdf9 msgid "" "**Changed** creation of PDF documents: they will now always carry a PDF " "identification (``/ID`` field) in the document trailer. Implements issue " "`#691 `_." msgstr "" #: ../../../changes.txt:1861 66eda59a33aa45ee88d7c201c85dfd3a msgid "" "**Changed** :meth:`Page.searchFor`: a new parameter ``clip`` is accepted " "to restrict the search to this rectangle. Correspondingly, the attribute " ":attr:`TextPage.rect` is now respected by :meth:`TextPage.search`." msgstr "" #: ../../../changes.txt:1862 40efc3861a01468ba0b65c1950845cde msgid "" "**Changed** parameter ``hit_max`` in :meth:`Page.searchFor` and " ":meth:`TextPage.search` is now obsolete: methods will return all hits." msgstr "" #: ../../../changes.txt:1863 52c4e18a02684b35894a335001e4b449 msgid "" "**Changed** character **selection criteria** in :meth:`Page.getText`: a " "character is now considered to be part of a ``clip`` if its bbox is fully" " contained. Before this, a non-empty intersection was sufficient." msgstr "" #: ../../../changes.txt:1864 b05dff665c9644849dfb39e3b881dc36 msgid "" "**Changed** :meth:`Document.scrub` to support a new option " "`redact_images`. This addresses issue `#697 " "`_." msgstr "" #: ../../../changes.txt:1869 dcb97ced9507410d944ce850f20740d7 msgid "**Changes in Version 1.18.1**" msgstr "" #: ../../../changes.txt:1871 ba246f3cc40a4c189c06444a474f03c8 msgid "" "**Fixed** issue `#692 `_. " "PyMuPDF now detects and recovers from more cyclic resource dependencies " "in PDF pages and for the first time reports them in the MuPDF warnings " "store." msgstr "" #: ../../../changes.txt:1872 5ea166e77dfd422487491dc7989ac87b msgid "**Fixed** issue `#686 `_." msgstr "" #: ../../../changes.txt:1873 24c8bae3003740b3b7ef2f1245674d54 msgid "" "**Added** opacity options for the :ref:`Shape` class: Stroke and fill " "colors can now be set to some transparency value. This means that all " ":ref:`Page` draw methods, methods :meth:`Page.insertText`, " ":meth:`Page.insertTextbox`, :meth:`Shape.finish`, " ":meth:`Shape.insertText`, and :meth:`Shape.insertTextbox` support two new" " parameters: *stroke_opacity* and *fill_opacity*." msgstr "" #: ../../../changes.txt:1874 0eab763d4bde434c99750d05c7744be8 msgid "" "**Added** new parameter ``mask`` to :meth:`Page.insertImage` for " "optionally providing an external image mask. Resolves issue `#685 " "`_." msgstr "" #: ../../../changes.txt:1875 d7eb84e2b45346e9805c75ed708951db msgid "" "**Added** :meth:`Annot.soundGet` for extracting the sound of an audio " "annotation." msgstr "" #: ../../../changes.txt:1879 8a1eef562c944225a15aca32aa0a68d0 msgid "**Changes in Version 1.18.0**" msgstr "" #: ../../../changes.txt:1881 f828b2f6db734312b557796ab1a48396 msgid "" "This is the first PyMuPDF version supporting MuPDF v1.18. The focus here " "is on extending PyMuPDF's own functionality -- apart from bug fixing. " "Subsequent PyMuPDF patches may address features new in MuPDF." msgstr "" #: ../../../changes.txt:1883 a9a5a178f719434b9bd31e65ea52f799 msgid "" "**Fixed** issue `#519 `_. " "This upstream bug occurred occasionally for some pages only and seems to " "be fixed now: page layout should no longer be ruined in these cases." msgstr "" #: ../../../changes.txt:1885 532d4ce5429a41979de31fd798876926 msgid "**Fixed** issue `#675 `_." msgstr "" #: ../../../changes.txt:1887 4afda8086e88434b991c90a40f6b3c63 msgid "" "Unsuccessful storage allocations should now always lead to exceptions " "(circumvention of an upstream bug intermittently crashing the " "interpreter)." msgstr "" #: ../../../changes.txt:1888 9b95a7d89275404592c843e6e1a69d20 msgid "" ":ref:`Pixmap` size is now based on ``size_t`` instead of ``int`` in C and" " should be correct even for extremely large pixmaps." msgstr "" #: ../../../changes.txt:1890 50d1e348ab4a420e82ff6163e457c791 msgid "" "**Fixed** issue `#668 `_. " "Specification of dashes for PDF drawing insertion should now correctly " "reflect the PDF spec." msgstr "" #: ../../../changes.txt:1891 e2c585c3927446b58b695299aacefa37 msgid "" "**Fixed** issue `#669 `_. " "A major source of memory leakage in :meth:`Page.insert_pdf` has been " "removed." msgstr "" #: ../../../changes.txt:1892 21f99d039e0b406ba748fa27b51b61ab msgid "" "**Added** keyword *\"images\"* to :meth:`Page.apply_redactions` for fine-" "controlling the handling of images." msgstr "" #: ../../../changes.txt:1893 06f2d99671fb4a4693ac550bbe174f39 msgid "" "**Added** :meth:`Annot.getText` and :meth:`Annot.getTextbox`, which offer" " the same functionality as the :ref:`Page` versions." msgstr "" #: ../../../changes.txt:1894 cc38d6a9295a4baabbe0fa91a8729818 msgid "" "**Added** key *\"number\"* to the block dictionaries of " ":meth:`Page.getText` / :meth:`Annot.getText` for options \"dict\" and " "\"rawdict\"." msgstr "" #: ../../../changes.txt:1895 95b81b00ad5f4f67abab2d83e62fa830 msgid "" "**Added** :meth:`glyph_name_to_unicode` and " ":meth:`unicode_to_glyph_name`. Both functions do not really connect to a " "specific font and are now independently available, too. The data are now " "based on the `Adobe Glyph List `_." msgstr "" #: ../../../changes.txt:1896 3435f8b2d002434ea2961e3bfa9e9ef5 msgid "" "**Added** convenience functions :meth:`adobe_glyph_names` and " ":meth:`adobe_glyph_unicodes` which return the respective available data." msgstr "" #: ../../../changes.txt:1897 46734bcd601a4c10b224d8af13288ece msgid "" "**Added** :meth:`Page.getDrawings` which returns details of drawing " "operations on a document page. Works for all document types." msgstr "" #: ../../../changes.txt:1898 0a520f7de35d43a992a69aaff5c5b428 msgid "" "Improved performance of :meth:`Document.insert_pdf`. Multiple object " "copies are now also suppressed across multiple separate insertions from " "the same source. This saves time, memory and target file size. Previously" " this mechanism was only active within each single method execution. The " "feature can also be suppressed with the new method bool parameter " "*final=1*, which is the default." msgstr "" #: ../../../changes.txt:1899 61af4c935234421da5ee00ff3ad32977 msgid "" "For PNG images created from pixmaps, the resolution (dpi) is now " "automatically set from the respective :attr:`Pixmap.xres` and " ":attr:`Pixmap.yres` values." msgstr "" #: ../../../changes.txt:1904 5787bf266f7743eba6c3ad62840101c8 msgid "**Changes in Version 1.17.7**" msgstr "" #: ../../../changes.txt:1906 fe5734ffddc1440683824cf9eaeb5f6e msgid "" "**Fixed** issue `#651 `_. " "An upstream bug causing interpreter crashes in corner case redaction " "processings was fixed by backporting MuPDF changes from their development" " repo." msgstr "" #: ../../../changes.txt:1907 ebc978213c4446bba6ca783ac6fc99e5 msgid "" "**Fixed** issue `#645 `_. " "Pixmap top-left coordinates can be set (again) by their own method, " ":meth:`Pixmap.set_origin`." msgstr "" #: ../../../changes.txt:1908 28e1c70a439943fb93756b8877d3f067 msgid "" "**Fixed** issue `#622 `_. " ":meth:`Page.insertImage` again accepts a :data:`rect_like` parameter." msgstr "" #: ../../../changes.txt:1909 878ea74492ff47559c0f731484ecd4c7 msgid "" "**Added** severeal new methods to improve and speed-up table of contents " "(TOC) handling. Among other things, TOC items can now changed or deleted " "individually -- without always replacing the complete TOC. Furthermore, " "access to some PDF page attributes is now possible without first " "**loading** the page. This has a very significant impact on the " "performance of TOC manipulation." msgstr "" #: ../../../changes.txt:1910 4808333e353f4b9d9eb4c65d42a50c6d msgid "" "**Added** an option to :meth:`Document.insert_pdf` which allows " "displaying progress messages. Adresses `#640 " "`_." msgstr "" #: ../../../changes.txt:1911 16de294b58a64f549ba7bd27e208d30b msgid "" "**Added** :meth:`Page.getTextbox` which extracts text contained in a " "rectangle. In many cases, this should obsolete writing your own script " "for this type of thing." msgstr "" #: ../../../changes.txt:1912 9711b2846e2c49f3bb6c283d0b1d9d67 msgid "" "**Added** new ``clip`` parameter to :meth:`Page.getText` to simplify and " "speed up text extraction of page sub areas." msgstr "" #: ../../../changes.txt:1913 8376ab0f05934f11b21f7fe154f09584 msgid "" "**Added** :meth:`TextWriter.appendv` to add text in **vertical write " "mode**. Addresses issue `#653 " "`_" msgstr "" #: ../../../changes.txt:1918 bd8548ec9f5e41a8ad54094881be2323 msgid "**Changes in Version 1.17.6**" msgstr "" #: ../../../changes.txt:1920 d2312ab353dc4344a3ef174e63c10207 msgid "**Fixed** issue `#605 `_" msgstr "" #: ../../../changes.txt:1921 d52cabcacf8e4c7b8f280b8bb95e5d14 msgid "" "**Fixed** issue `#600 `_ " "-- text should now be correctly positioned also for pages with a CropBox " "smaller than MediaBox." msgstr "" #: ../../../changes.txt:1922 84afef0f9451476d83841dc61e1ae4d6 msgid "" "**Added** text span dictionary key ``origin`` which contains the lower " "left coordinate of the first character in that span." msgstr "" #: ../../../changes.txt:1923 c2104decab38443f85a9f4afbcf59e5f msgid "**Added** attribute :attr:`Font.buffer`, a *bytes* copy of the font file." msgstr "" #: ../../../changes.txt:1924 3b8f869df37e4187b691a5636fabbcc4 msgid "" "**Added** parameter *sanitize* to :meth:`Page.cleanContents`. Allows " "switching of sanitization, so only syntax cleaning will be done." msgstr "" #: ../../../changes.txt:1928 79b5769975fc461580fc75e187439f1a msgid "**Changes in Version 1.17.5**" msgstr "" #: ../../../changes.txt:1930 c3dee94cf9eb4f8c9c29a712da46feee msgid "" "**Fixed** issue `#561 `_ " "-- second go: certain :ref:`TextWriter` usages with many alternating " "fonts did not work correctly." msgstr "" #: ../../../changes.txt:1931 b1cd45be4c3e414b9a31943b87ffa257 msgid "**Fixed** issue `#566 `_." msgstr "" #: ../../../changes.txt:1932 c4be58f459d54570a15caabfa48b2fea msgid "**Fixed** issue `#568 `_." msgstr "" #: ../../../changes.txt:1933 a3a69f69f7e446d190a422fd95946055 msgid "" "**Fixed** -- opacity is now correctly taken from the :ref:`TextWriter` " "object, if not given in :meth:`TextWriter.writeText`." msgstr "" #: ../../../changes.txt:1934 60e36a0e76204fc39ca63f66c0e017f0 msgid "" "**Added** a new global attribute :attr:`fitz_fontdescriptors`. Contains " "information about usable fonts from repository `pymupdf-fonts " "`_." msgstr "" #: ../../../changes.txt:1935 c5bbfe6d1dfc44bea3cf4c3d67f6d27d msgid "" "**Added** :meth:`Font.valid_codepoints` which returns an array of unicode" " codepoints for which the font has a glyph." msgstr "" #: ../../../changes.txt:1936 d2abd73772384a31a507c1e1d6f4988b msgid "" "**Added** option ``text_as_path`` to :meth:`Page.getSVGimage`. this " "implements `#580 `_. " "Generates much smaller SVG files with parseable text if set to *False*." msgstr "" #: ../../../changes.txt:1941 0214e36149a247f698e38dfd899ff4fb msgid "**Changes in Version 1.17.4**" msgstr "" #: ../../../changes.txt:1943 e333e2461114401ea23d111aa11cbe48 msgid "" "**Fixed** issue `#561 `_. " "Handling of more than 10 :ref:`Font` objects on one page should now work " "correctly." msgstr "" #: ../../../changes.txt:1944 3dc7e6c23bdb4fa2af06fa690d6c50e1 msgid "" "**Fixed** issue `#562 `_. " "Annotation pixmaps are no longer derived from the page pixmap, thus " "avoiding unintended inclusion of page content." msgstr "" #: ../../../changes.txt:1945 598609fee1c2419f8f22dd734d9e4621 msgid "" "**Fixed** issue `#559 `_. " "This **MuPDF** bug is being temporarily fixed with a pre-version of " "MuPDF's next release." msgstr "" #: ../../../changes.txt:1946 2b01a159631746d0b9e27d2f4ee7f2f3 msgid "" "**Added** utility function :meth:`repair_mono_font` for correcting " "displayed character spacing for some mono-spaced fonts." msgstr "" #: ../../../changes.txt:1947 d63409b0745449c5b326f78fcbdb243d msgid "" "**Added** utility method :meth:`Document.need_appearances` for fine-" "controlling Form PDF behavior. Addresses issue `#563 " "`_." msgstr "" #: ../../../changes.txt:1948 261813b8c1164f85bd099615986583b1 msgid "" "**Added** utility function :meth:`sRGB_to_pdf` to recover the PDF color " "triple for a given color integer in sRGB format." msgstr "" #: ../../../changes.txt:1949 087525d5979d4e88b699951008f083cd msgid "" "**Added** utility function :meth:`sRGB_to_rgb` to recover the (R, G, B) " "color triple for a given color integer in sRGB format." msgstr "" #: ../../../changes.txt:1950 dfce06d94de945d298f54486d626b557 msgid "" "**Added** utility function :meth:`make_table` which delivers table cells " "for a given rectangle and desired numbers of columns and rows." msgstr "" #: ../../../changes.txt:1951 a5085ba0096648a5abdb1bac873f8a91 msgid "" "**Added** support for optional fonts in repository `pymupdf-fonts " "`_." msgstr "" #: ../../../changes.txt:1955 6035ab0f4f8f4c22b602c2975ca7a9bb msgid "**Changes in Version 1.17.3**" msgstr "" #: ../../../changes.txt:1957 dd9eec4fdfa74a648a0ddfffafa83372 msgid "" "**Fixed** an undocumented issue, which prevented fully cleaning a PDF " "page when using :meth:`Page.cleanContents`." msgstr "" #: ../../../changes.txt:1958 0847e901e54e42ab97132b411ad8703a msgid "" "**Fixed** issue `#540 `_. " "Text extraction for EPUB should again work correctly." msgstr "" #: ../../../changes.txt:1959 14b815222173483085dcc120dceb9f9b msgid "" "**Fixed** issue `#548 `_. " "Documentation now includes ``LINK_NAMED``." msgstr "" #: ../../../changes.txt:1960 f5eb1a9ec46e48479fef6e71d0ce3f21 msgid "" "**Added** new parameter to control start of text in " ":meth:`TextWriter.fillTextbox`. Implements `#549 " "`_." msgstr "" #: ../../../changes.txt:1961 67cf556f751344f683f697a61d518948 msgid "" "**Changed** documentation of :meth:`Page.add_redact_annot` to explain the" " usage of non-builtin fonts." msgstr "" #: ../../../changes.txt:1965 cc0c58ad8b0b41eda4f8e5716f2b16a8 msgid "**Changes in Version 1.17.2**" msgstr "" #: ../../../changes.txt:1967 c27ffc8eec8040018fa36d5790749cec msgid "**Fixed** issue `#533 `_." msgstr "" #: ../../../changes.txt:1968 27350a32fc7840bb8591f6081f20d94d msgid "" "**Added** options to modify 'Redact' annotation appearance. Implements " "`#535 `_." msgstr "" #: ../../../changes.txt:1973 b8bea379222d4215963ee2eb2ffa9049 msgid "**Changes in Version 1.17.1**" msgstr "" #: ../../../changes.txt:1975 60814804b9f84f3d8b98c3cf2dc5f20c msgid "**Fixed** issue `#520 `_." msgstr "" #: ../../../changes.txt:1976 9c3b1af133ad4aa9a4f08296f7affa70 msgid "" "**Fixed** issue `#525 `_. " "Vertices for 'Ink' annots should now be correct." msgstr "" #: ../../../changes.txt:1977 98b1d51b954b4c56bebe479ae1c44fdb msgid "" "**Fixed** issue `#524 `_. " "It is now possible to query and set rotation for applicable annotation " "types." msgstr "" #: ../../../changes.txt:1979 465b318c922644768dbf6d5a01328404 msgid "" "Also significantly improved inline documentation for better support of " "interactive help." msgstr "" #: ../../../changes.txt:1983 5cd63263f85a4783a6ccfc029201386b msgid "**Changes in Version 1.17.0**" msgstr "" #: ../../../changes.txt:1985 b87f5b93bd9b48eeb6c65b06340048e4 msgid "" "This version is based on MuPDF v1.17. Following are highlights of new and" " changed features:" msgstr "" #: ../../../changes.txt:1987 b2f1ba6ba94140b98e5cc0fe7a3faa3b msgid "" "**Added** extended language support for annotations and widgets: a " "mixture of Latin, Greece, Russian, Chinese, Japanese and Korean " "characters can now be used in 'FreeText' annotations and text widgets. No" " special arrangement is required to use it." msgstr "" #: ../../../changes.txt:1989 e733e136ba8c438db34aca4bb17fc4ef msgid "" "Faster page access is implemented for documents supporting a \"chapter\" " "structure. This applies to EPUB documents currently. This comes with " "several new :ref:`Document` methods and changes for " ":meth:`Document.loadPage` and the \"indexed\" page access *doc[n]*: In " "addition to specifying a page number as before, a tuple *(chaper, pno)* " "can be specified to identify the desired page." msgstr "" #: ../../../changes.txt:1991 971b877040f248cdba6abf69baeef371 msgid "" "**Changed:** Improved support of redaction annotations: images overlapped" " by redactions are **permanantly modified** by erasing the overlap areas." " Also links are removed if overlapped by redactions. This is now fully in" " sync with PDF specifications." msgstr "" #: ../../../changes.txt:1995 b49d2e2fb4e447e1b521a7c628189360 msgid "" "**Changed** :meth:`TextWriter.writeText` to support the *\"morph\"* " "parameter." msgstr "" #: ../../../changes.txt:1996 3fc9ed296a4f4010832533bc9a26128c msgid "" "**Added** methods :meth:`Rect.morph`, :meth:`IRect.morph`, and " ":meth:`Quad.morph`, which return a new :ref:`Quad`." msgstr "" #: ../../../changes.txt:1997 b20b08f09a414edaacd286b8f526b6f8 msgid "" "**Changed** :meth:`Page.add_freetext_annot` to support text alignment via" " a new *\"align\"* parameter." msgstr "" #: ../../../changes.txt:1998 2361ff8be9cc46e1b8f08ddefa02efae msgid "" "**Fixed** issue `#508 `_. " "Improved image rectangle calculation to hopefully deliver correct values " "in most if not all cases." msgstr "" #: ../../../changes.txt:1999 236cc95410f34fcc89f66e66388bfb9b msgid "**Fixed** issue `#502 `_." msgstr "" #: ../../../changes.txt:2000 b1667139e4fd40a187d32b0c93485b50 msgid "" "**Fixed** issue `#500 `_. " ":meth:`Document.convertToPDF` should no longer cause memory leaks." msgstr "" #: ../../../changes.txt:2001 08f135a6cd9f48d68424126027bef590 msgid "" "**Fixed** issue `#496 `_. " "Annotations and widgets / fields are now added or modified using the " "coordinates of the **unrotated page**. This behavior is now in sync with " "other methods modifying PDF pages." msgstr "" #: ../../../changes.txt:2002 0129ba9864fa48e3b4ddbc7f32269fc2 msgid "" "**Added** :attr:`Page.rotationMatrix` and :attr:`Page.derotationMatrix` " "to support coordinate transformations between the rotated and the " "original versions of a PDF page." msgstr "" #: ../../../changes.txt:2004 35a97c98b52e49278109e56b99107387 msgid "Potential code breaking changes:" msgstr "" #: ../../../changes.txt:2006 1a3fbe2084e24a759582e9aa05cc4591 msgid "" "The private method ``Page._getTransformation()`` has been removed. Use " "the public :attr:`Page.transformationMattrix` instead." msgstr "" #: ../../../changes.txt:2011 f06ca5ab722a487f87a29410f2bb377a msgid "**Changes in Version 1.16.18**" msgstr "" #: ../../../changes.txt:2013 75fa0dcdb41144b680ec66bfd4a6bd1a msgid "" "This version introduces several new features around PDF text output. The " "motivation is to simplify this task, while at the same time offering " "extending features." msgstr "" #: ../../../changes.txt:2015 13b1f23e60414710b4271079289007c0 msgid "" "One major achievement is using MuPDF's capabilities to dynamically " "choosing fallback fonts whenever a character cannot be found in the " "current one. This seemlessly works for Base-14 fonts in combination with " "CJK fonts (China, Japan, Korea). So a text may contain **any combination " "of characters** from the Latin, Greek, Russian, Chinese, Japanese and " "Korean languages." msgstr "" #: ../../../changes.txt:2017 6ffef279ab3d445ca46586a05c3e8d90 msgid "" "**Fixed** issue `#493 `_. " "``Pixmap(doc, xref)`` should now again correctly resemble the loaded " "image object." msgstr "" #: ../../../changes.txt:2018 afdb0475290145d38834c612bbb45088 msgid "" "**Fixed** issue `#488 `_. " "Widget names are now modifiable." msgstr "" #: ../../../changes.txt:2019 141ce60e1fc44924a6cbdea1662c8a7d msgid "**Added** new class :ref:`Font` which represents a font." msgstr "" #: ../../../changes.txt:2020 819be8edbaf04a2ebe870b12436fdad6 msgid "" "**Added** new class :ref:`TextWriter` which serves as a container for " "text to be written on a page." msgstr "" #: ../../../changes.txt:2021 be45ac51b3d7415e8150584132c49a33 msgid "" "**Added** :meth:`Page.writeText` to write one or more :ref:`TextWriter` " "objects to the page." msgstr "" #: ../../../changes.txt:2026 c355f22137584b4cbab6f6354bd95bda msgid "**Changes in Version 1.16.17**" msgstr "" #: ../../../changes.txt:2029 f3f07b3f33cc44c5984500283eb306e1 msgid "" "**Fixed** issue `#479 `_. " "PyMuPDF should now more correctly report image resolutions. This applies " "to both, images (either from images files or extracted from PDF " "documents) and pixmaps created from images." msgstr "" #: ../../../changes.txt:2030 96daad3b07ac4308a44d307f62c89c50 msgid "" "**Added** :meth:`Pixmap.set_dpi` which sets the image resolution in x and" " y directions." msgstr "" #: ../../../changes.txt:2034 33fc9fed734a4bf4990dd592129e984c msgid "**Changes in Version 1.16.16**" msgstr "" #: ../../../changes.txt:2037 765ca3ee977d42678126cf84057b4e3d msgid "**Fixed** issue `#477 `_." msgstr "" #: ../../../changes.txt:2038 6240d3c9c41c46be9652ecabcbae2fbb msgid "**Fixed** issue `#476 `_." msgstr "" #: ../../../changes.txt:2039 d5cd872ddead486aa29ca5b255ba885e msgid "" "**Changed** annotation line end symbol coloring and fixed an error " "coloring the interior of 'Polyline' /'Polygon' annotations." msgstr "" #: ../../../changes.txt:2043 bb450a98e5e04667aed64c1004529927 msgid "**Changes in Version 1.16.14**" msgstr "" #: ../../../changes.txt:2046 3228fbb9e5b4467498da27f2ad55fe5b msgid "" "**Changed** text marker annotations to accept parameters beyond just " "quadrilaterals such that now **text lines between two given points can be" " marked**." msgstr "" #: ../../../changes.txt:2048 a97e5cc2834a4e96b0ede1ad6db5c900 msgid "" "**Added** :meth:`Document.scrub` which **removes potentially sensitive " "data** from a PDF. Implements `#453 " "`_." msgstr "" #: ../../../changes.txt:2050 2f3c7cef276444c480a491776e3ef6e8 msgid "" "**Added** :meth:`Annot.blendMode` which returns the **blend mode** of " "annotations." msgstr "" #: ../../../changes.txt:2052 866e4a88a77d48a1b7aafb511b41907c msgid "" "**Added** :meth:`Annot.setBlendMode` to set the annotation's blend mode. " "This resolves issue `#416 " "`_." msgstr "" #: ../../../changes.txt:2053 501eb9ee56e84e60be74f5ba75eaecb4 msgid "" "**Changed** :meth:`Annot.update` to accept additional parameters for " "setting blend mode and opacity." msgstr "" #: ../../../changes.txt:2054 85b91d3af2b944e09ffc418872e3540e msgid "" "**Added** advanced graphics features to **control the anti-aliasing " "values**, :meth:`Tools.set_aa_level`. Resolves `#467 " "`_" msgstr "" #: ../../../changes.txt:2056 60b4c208b1c04edc9d0cc75db8e9b3ab msgid "**Fixed** issue `#474 `_." msgstr "" #: ../../../changes.txt:2057 4f4fa5bbd4bb45dc965381d06a2c28e1 msgid "**Fixed** issue `#466 `_." msgstr "" #: ../../../changes.txt:2063 c2150d5e98ed4b29a8d7d0e0e049893a msgid "**Changes in Version 1.16.13**" msgstr "" #: ../../../changes.txt:2066 6ffa2c895b184d7c9579c04c5e72d6cc msgid "" "**Added** :meth:`Document.getPageXObjectList` which returns a list of " "**Form XObjects** of the page." msgstr "" #: ../../../changes.txt:2067 1ad5db1dcf4e406d84fe85e8ac783a34 msgid "" "**Added** :meth:`Page.setMediaBox` for changing the physical PDF page " "size." msgstr "" #: ../../../changes.txt:2068 dc4ffb1b3bba4dd7a2c0b5018278954e msgid "" "**Added** :ref:`Page` methods which have been internal before: " ":meth:`Page.cleanContents` (= :meth:`Page._cleanContents`), " ":meth:`Page.getContents` (= :meth:`Page._getContents`), " ":meth:`Page.getTransformation` (= :meth:`Page._getTransformation`)." msgstr "" #: ../../../changes.txt:2074 0a926e1f6bb64ff4ab4b4fed8ea0ee89 msgid "**Changes in Version 1.16.12**" msgstr "" #: ../../../changes.txt:2076 6f5ea75220774bb684dc3fe1dbf48e9b msgid "**Fixed** issue `#447 `_" msgstr "" #: ../../../changes.txt:2077 71bac266ce3746019c6a08f26d3ec822 msgid "**Fixed** issue `#461 `_." msgstr "" #: ../../../changes.txt:2078 373fc96ec8a54dee8c321088ee944682 msgid "**Fixed** issue `#397 `_." msgstr "" #: ../../../changes.txt:2079 7cf9d00c4d19420abaaf8c58b10147a0 msgid "**Fixed** issue `#463 `_." msgstr "" #: ../../../changes.txt:2080 fe57fdfdfd8d4dbab5eed84540ad2c09 msgid "" "**Added** JavaScript support to PDF form fields, thereby fixing `#454 " "`_." msgstr "" #: ../../../changes.txt:2081 3eb09d62dd6044afa545088e6207f9f5 msgid "" "**Added** a new annotation method :meth:`Annot.delete_responses`, which " "removes 'Popup' and response annotations referring to the current one. " "Mainly serves data protection purposes." msgstr "" #: ../../../changes.txt:2082 5c849834cfb14620809866c9ac0b1f25 msgid "" "**Added** a new form field method :meth:`Widget.reset`, which resets the " "field value to its default." msgstr "" #: ../../../changes.txt:2083 1d43ac4e7dcf4344b0dfdcf700f6d7a5 msgid "" "**Changed** and extended handling of redactions: images and XObjects are " "removed if *contained* in a redaction rectangle. Any partial only " "overlaps will just be covered by the redaction background color. Now an " "*overlay* text can be specified to be inserted in the rectangle area to " "**take the place the deleted original** text. This resolves `#434 " "`_." msgstr "" #: ../../../changes.txt:2087 d41286ba5ebd44c280d5f43f2c164594 msgid "**Changes in Version 1.16.11**" msgstr "" #: ../../../changes.txt:2089 74c14cc395804937832a051835d5fecb msgid "" "**Added** Support for redaction annotations via method " ":meth:`Page.add_redact_annot` and :meth:`Page.apply_redactions`." msgstr "" #: ../../../changes.txt:2090 68b7efcedf5f4d94964ff855c1baaa83 msgid "**Fixed** issue #426 (\"PolygonAnnotation in 1.16.10 version\")." msgstr "" #: ../../../changes.txt:2091 247da6da5b67427fab1dc09bed47037f msgid "" "**Fixed** documentation only issues `#443 " "`_ and `#444 " "`_." msgstr "" #: ../../../changes.txt:2095 ed5a70ba54b5438786c6e36834b30a3d msgid "**Changes in Version 1.16.10**" msgstr "" #: ../../../changes.txt:2097 9147f50e16864bfe9fc59b9c324a45ca msgid "" "**Fixed** issue #421 (\"annot.set_rect(rect) has no effect on text " "Annotation\")" msgstr "" #: ../../../changes.txt:2098 2a0e32d4811546f3a036844d15350182 msgid "" "**Fixed** issue #417 (\"Strange behavior for page.deleteAnnot on 1.16.9 " "compare to 1.13.20\")" msgstr "" #: ../../../changes.txt:2099 85979328a4bc4780a1adf5da1b2e3893 msgid "**Fixed** issue #415 (\"Annot.setOpacity throws mupdf warnings\")" msgstr "" #: ../../../changes.txt:2100 2419b5fdf6bd4e14bf9217b890caa587 msgid "" "**Changed** all \"add annotation / widget\" methods to store a unique " "name in the */NM* PDF key." msgstr "" #: ../../../changes.txt:2101 9d4a65a638864c41800994ff9674b45a msgid "" "**Changed** :meth:`Annot.setInfo` to also accept direct parameters in " "addition to a dictionary." msgstr "" #: ../../../changes.txt:2102 d7c062a9ce2e4526a3f42e875262dd86 msgid "" "**Changed** :attr:`Annot.info` to now also show the annotation's unique " "id (*/NM* PDF key) if present." msgstr "" #: ../../../changes.txt:2103 e8cff5d5c3c8451381b2fbccf05c6ad9 msgid "" "**Added** :meth:`Page.annot_names` which returns a list of all annotation" " names (*/NM* keys)." msgstr "" #: ../../../changes.txt:2104 9e3fa2fe09b54dc29528cfced4d8729f msgid "" "**Added** :meth:`Page.load_annot` which loads an annotation given its " "unique id (*/NM* key)." msgstr "" #: ../../../changes.txt:2105 f5d8b4dd62cf460a9126ea02f116c488 msgid "" "**Added** :meth:`Document.reload_page` which provides a new copy of a " "page after finishing any pending updates to it." msgstr "" #: ../../../changes.txt:2110 072a5e68ce9a45629a888405caa5a5d2 msgid "**Changes in Version 1.16.9**" msgstr "" #: ../../../changes.txt:2112 c18c92f84efa4cfa8b797880e17d8bcb msgid "" "**Fixed** #412 (\"Feature Request: Allow controlling whether TOC entries " "should be collapsed\")" msgstr "" #: ../../../changes.txt:2113 f9a9a45513f74bfa9a4747231296426f msgid "**Fixed** #411 (\"Seg Fault with page.firstWidget\")" msgstr "" #: ../../../changes.txt:2114 cbe0b8f39db641068257179e30232c1f msgid "**Fixed** #407 (\"Annot.setOpacity trouble\")" msgstr "" #: ../../../changes.txt:2115 c4b9b8f9ef874c7f88678471ea871da9 msgid "" "**Changed** methods :meth:`Annot.setBorder`, :meth:`Annot.setColors`, " ":meth:`Link.setBorder`, and :meth:`Link.setColors` to also accept direct " "parameters, and not just cumbersome dictionaries." msgstr "" #: ../../../changes.txt:2119 d0e24eb6d1f34da0aca34159c1e8309c msgid "**Changes in Version 1.16.8**" msgstr "" #: ../../../changes.txt:2121 78fe31bc2d304b78a7a2cec103ad3a86 msgid "" "**Added** several new methods to the :ref:`Document` class, which make " "dealing with PDF low-level structures easier. I also decided to provide " "them as \"normal\" methods (as opposed to private ones starting with an " "underscore \"_\"). These are :meth:`Document.xrefObject`, " ":meth:`Document.xrefStream`, :meth:`Document.xrefStreamRaw`, " ":meth:`Document.PDFTrailer`, :meth:`Document.PDFCatalog`, " ":meth:`Document.metadataXML`, :meth:`Document.updateObject`, " ":meth:`Document.updateStream`." msgstr "" #: ../../../changes.txt:2122 f907ccb57c184be2857e9e13341bcf7f msgid "" "**Added** :meth:`Tools.mupdf_disply_errors` which sets the display of " "mupdf errors on *sys.stderr*." msgstr "" #: ../../../changes.txt:2123 462c8d75060e4a88a09ea596464f5368 msgid "" "**Added** a commandline facility. This a major new feature: you can now " "invoke several utility functions via *\"python -m fitz ...\"*. It should " "obsolete the need for many of the most trivial scripts. Please refer to " ":ref:`Module`." msgstr "" #: ../../../changes.txt:2128 4f1ac7ae88d343e886b0fc8edee75d46 msgid "**Changes in Version 1.16.7**" msgstr "" #: ../../../changes.txt:2130 59ec1afd2e0b4cd3a5dc260bd354751e msgid "" "Minor changes to better synchronize the binary image streams of " ":ref:`TextPage` image blocks and :meth:`Document.extractImage` images." msgstr "" #: ../../../changes.txt:2132 ac25ec6537ba4e92aab44dcf172c4ba8 msgid "" "**Fixed** issue #394 (\"PyMuPDF Segfaults when using " "TOOLS.mupdf_warnings()\")." msgstr "" #: ../../../changes.txt:2133 d9b7bf416f824ce09246787bdda98e63 msgid "" "**Changed** redirection of MuPDF error messages: apart from writing them " "to Python *sys.stderr*, they are now also stored with the MuPDF warnings." msgstr "" #: ../../../changes.txt:2134 f40406dcc3f04e31b7a7a9805de02e42 msgid "" "**Changed** :meth:`Tools.mupdf_warnings` to automatically empty the store" " (if not deactivated via a parameter)." msgstr "" #: ../../../changes.txt:2135 2299c535d3cb4aa6a186707196175500 msgid "" "**Changed** :meth:`Page.getImageBbox` to return an **infinite rectangle**" " if the image could not be located on the page -- instead of raising an " "exception." msgstr "" #: ../../../changes.txt:2140 bfbc4d7dee2442f3b0f015ea21421028 msgid "**Changes in Version 1.16.6**" msgstr "" #: ../../../changes.txt:2142 c28c263feaa6419cb63d73ad8209d28d msgid "**Fixed** issue #390 (\"Incomplete deletion of annotations\")." msgstr "" #: ../../../changes.txt:2143 c5219152f7854dc88d39a7689713a4a8 msgid "" "**Changed** :meth:`Page.searchFor` / :meth:`Document.searchPageFor` to " "also support the *flags* parameter, which controls the data included in a" " :ref:`TextPage`." msgstr "" #: ../../../changes.txt:2144 21ea396db0a04f04ac4bf6146ab72b59 msgid "" "**Changed** :meth:`Document.getPageImageList`, " ":meth:`Document.getPageFontList` and their :ref:`Page` counterparts to " "support a new parameter *full*. If true, the returned items will contain " "the :data:`xref` of the *Form XObject* where the font or image is " "referenced." msgstr "" #: ../../../changes.txt:2148 69f333b42ed44c918c9378c6632bd3e2 msgid "**Changes in Version 1.16.5**" msgstr "" #: ../../../changes.txt:2150 9f2ab73d9d874b4784539e77ddee4f5b msgid "More performance improvements for text extraction." msgstr "" #: ../../../changes.txt:2152 fb2a1a0548f3424b8d89927d5f5047ee msgid "**Fixed** second part of issue #381 (see item in v1.16.4)." msgstr "" #: ../../../changes.txt:2153 3f0ac5e4286c4997836ff33e123dbaf4 msgid "" "**Added** :meth:`Page.getTextPage`, so it is no longer required to create" " an intermediate display list for text extractions. Page level wrappers " "for text extraction and text searching are now based on this, which " "should improve performance by ca. 5%." msgstr "" #: ../../../changes.txt:2157 9e9865f910ed4d4399d4dfbe3c3d0597 msgid "**Changes in Version 1.16.4**" msgstr "" #: ../../../changes.txt:2160 e7d84df2ad7448e1880d04a6a7858521 msgid "" "**Fixed** issue #381 (\"TextPage.extractDICT ... failed ... after " "upgrading ... to 1.16.3\")" msgstr "" #: ../../../changes.txt:2161 17ca6aae522d4d84a5b1c510ca445cc6 msgid "" "**Added** method :meth:`Document.pages` which delivers a generator " "iterator over a page range." msgstr "" #: ../../../changes.txt:2162 b2b7308c362b461bb878fcc1538a0c92 msgid "" "**Added** method :meth:`Page.links` which delivers a generator iterator " "over the links of a page." msgstr "" #: ../../../changes.txt:2163 765160822cdc4aa9b4b723db791c91b6 msgid "" "**Added** method :meth:`Page.annots` which delivers a generator iterator " "over the annotations of a page." msgstr "" #: ../../../changes.txt:2164 3eb7fc95d4214c22a621ccb900d1e490 msgid "" "**Added** method :meth:`Page.widgets` which delivers a generator iterator" " over the form fields of a page." msgstr "" #: ../../../changes.txt:2165 d91d637897d54651a998f7dc0d19dc08 msgid "" "**Changed** :attr:`Document.is_form_pdf` to now contain the number of " "widgets, and *False* if not a PDF or this number is zero." msgstr "" #: ../../../changes.txt:2170 c01be0ed23784665aa2ce10d9ee9e605 msgid "**Changes in Version 1.16.3**" msgstr "" #: ../../../changes.txt:2172 112fd892e91d4394b0bbd52b9a508533 msgid "" "Minor changes compared to version 1.16.2. The code of the \"dict\" and " "\"rawdict\" variants of :meth:`Page.getText` has been ported to C which " "has greatly improved their performance. This improvement is mostly " "noticeable with text-oriented documents, where they now should execute " "almost two times faster." msgstr "" #: ../../../changes.txt:2174 529a6e2ef3a44e7496d36d3b262a6697 msgid "" "**Fixed** issue #369 (\"mupdf: cmsCreateTransform failed\") by removing " "ICC colorspace support." msgstr "" #: ../../../changes.txt:2175 d2e2ed462d9a420181f57a3bf178f0c7 msgid "" "**Changed** :meth:`Page.getText` to accept additional keywords \"blocks\"" " and \"words\". These will deliver the results of " ":meth:`Page.getTextBlocks` and :meth:`Page.getTextWords`, respectively. " "So all text extraction methods are now available via a uniform API. " "Correspondingly, there are now new methods :meth:`TextPage.extractBLOCKS`" " and :meth:`TextPage.extractWords`." msgstr "" #: ../../../changes.txt:2176 1c333634e45449ce9b326aff470a6f28 msgid "" "**Changed** :meth:`Page.getText` to default bit indicator " "*TEXT_INHIBIT_SPACES* to **off**. Insertion of additional spaces is **not" " suppressed** by default." msgstr "" #: ../../../changes.txt:2180 12e20189c1f143da88f1568d186c2402 msgid "**Changes in Version 1.16.2**" msgstr "" #: ../../../changes.txt:2182 5b0a0190d48d45a79172681a52191e85 msgid "" "**Changed** text extraction methods of :ref:`Page` to allow detail " "control of the amount of extracted data." msgstr "" #: ../../../changes.txt:2183 26cc0a7bee624a97a6c6ee19ee703703 msgid "" "**Added** :meth:`planish_line` which maps a given line (defined as a pair" " of points) to the x-axis." msgstr "" #: ../../../changes.txt:2184 b3df1c1be11846f9993b323a07181579 msgid "" "**Fixed** an issue (w/o Github number) which brought down the interpreter" " when encountering certain non-UTF-8 encodable characters while using " ":meth:`Page.getText` with te \"dict\" option." msgstr "" #: ../../../changes.txt:2185 e6ba0bd1a32e4b12891ded9326249a81 msgid "**Fixed** issue #362 (\"Memory Leak with getText('rawDICT')\")." msgstr "" #: ../../../changes.txt:2189 e9569fdba664447da20f33096718b92f msgid "**Changes in Version 1.16.1**" msgstr "" #: ../../../changes.txt:2191 dcc8cf6fc2384f3bb994e03b3a87c729 msgid "" "**Added** property :attr:`Quad.is_convex` which checks whether a line is " "contained in the quad if it connects two points of it." msgstr "" #: ../../../changes.txt:2192 cc61e8f19f5e488b8316b4e8235659f5 msgid "" "**Changed** :meth:`Document.insert_pdf` to now allow dropping or " "including links and annotations independently during the copy. Fixes " "issue #352 (\"Corrupt PDF data and ...\"), which seemed to intermittently" " occur when using the method for some problematic PDF files." msgstr "" #: ../../../changes.txt:2193 d407b04268d44237912c00860184f190 msgid "" "**Fixed** a bug which, in matrix division using the syntax *\"m1/m2\"*, " "caused matrix *\"m1\"* to be **replaced** by the result instead of " "delivering a new matrix." msgstr "" #: ../../../changes.txt:2194 7817d3234a47487b971b3830ef28ec19 msgid "" "**Fixed** issue #354 (\"SyntaxWarning with Python 3.8\"). We now always " "use *\"==\"* for literals (instead of the *\"is\"* Python keyword)." msgstr "" #: ../../../changes.txt:2195 ec50e4c219bd4062ad4ed5c0dddaac86 msgid "" "**Fixed** issue #353 (\"mupdf version check\"), to no longer refuse the " "import when there are only patch level deviations from MuPDF." msgstr "" #: ../../../changes.txt:2201 97813723c7e74febb3697d506c0094da msgid "**Changes in Version 1.16.0**" msgstr "" #: ../../../changes.txt:2203 2c7908f042184d21a92a433a0dace8f2 msgid "" "This major new version of MuPDF comes with several nice new or changed " "features. Some of them imply programming API changes, however. This is a " "synopsis of what has changed:" msgstr "" #: ../../../changes.txt:2205 a005bf6b6c26445f8a8e708efa7b1e6d msgid "" "PDF document encryption and decryption is now **fully supported**. This " "includes setting **permissions**, **passwords** (user and owner " "passwords) and the desired encryption method." msgstr "" #: ../../../changes.txt:2206 f64056f6bc3f4c5c9e5716fd5b547a3b msgid "" "In response to the new encryption features, PyMuPDF returns an integer " "(ie. a combination of bits) for document permissions, and no longer a " "dictionary." msgstr "" #: ../../../changes.txt:2207 12c5b87d97b548be96df9490e4a9b1f8 msgid "" "Redirection of MuPDF errors and warnings is now natively supported. " "PyMuPDF redirects error messages from MuPDF to *sys.stderr* and no longer" " buffers them. Warnings continue to be buffered and will not be " "displayed. Functions exist to access and reset the warnings buffer." msgstr "" #: ../../../changes.txt:2208 9ee23cc47bf54e33ac5b25ec8bd3a5b0 msgid "Annotations are now **only supported for PDF**." msgstr "" #: ../../../changes.txt:2209 043f8a35721a45789fc958c22ae0db05 msgid "" "Annotations and widgets (form fields) are now **separate object chains** " "on a page (although widgets technically still **are** PDF annotations). " "This means, that you will **never encounter widgets** when using " ":attr:`Page.firstAnnot` or :meth:`Annot.next`. You must use " ":attr:`Page.firstWidget` and :meth:`Widget.next` to access form fields." msgstr "" #: ../../../changes.txt:2210 98ff046f99264c3aadf74240a8bc473d msgid "" "As part of MuPDF's changes regarding widgets, only the following four " "fonts are supported, when **adding** or **changing** form fields: " "**Courier, Helvetica, Times-Roman** and **ZapfDingBats**." msgstr "" #: ../../../changes.txt:2212 c153729a2d494ff0ae2def2ff637078a msgid "List of change details:" msgstr "" #: ../../../changes.txt:2214 b23f45be6d7741b295688a68df3dab61 msgid "" "**Added** :meth:`Document.can_save_incrementally` which checks conditions" " that are preventing use of option *incremental=True* of " ":meth:`Document.save`." msgstr "" #: ../../../changes.txt:2215 f4ec8c96484849b498b2ccf6668ed972 msgid "" "**Added** :attr:`Page.firstWidget` which points to the first field on a " "page." msgstr "" #: ../../../changes.txt:2216 bcff0ac6bdc749b7b1bdca9295590789 msgid "" "**Added** :meth:`Page.getImageBbox` which returns the rectangle occupied " "by an image shown on the page." msgstr "" #: ../../../changes.txt:2217 027854d96da7483d84939b2e60db8b94 msgid "" "**Added** :meth:`Annot.setName` which lets you change the (icon) name " "field." msgstr "" #: ../../../changes.txt:2218 bcc01e342bb8486ca3ef80ba6e2007f8 msgid "" "**Added** outputting the text color in :meth:`Page.getText`: the " "*\"dict\"*, *\"rawdict\"* and *\"xml\"* options now also show the color " "in sRGB format." msgstr "" #: ../../../changes.txt:2219 bc0cbfa3b0484956b6eaea0bdb98a8fc msgid "" "**Changed** :attr:`Document.permissions` to now contain an integer of " "bool indicators -- was a dictionary before." msgstr "" #: ../../../changes.txt:2220 820b45730e5f4cd09d1a94837ecb4e08 msgid "" "**Changed** :meth:`Document.save`, :meth:`Document.write`, which now " "fully support password-based decryption and encryption of PDF files." msgstr "" #: ../../../changes.txt:2221 4731ba6ffeda46a2a2d03259b480522f msgid "" "**Changed the names of all Python constants** related to annotations and " "widgets. Please make sure to consult the **Constants and Enumerations** " "chapter if your script is dealing with these two classes. This decision " "goes back to the dropped support for non-PDF annotations. The **old " "names** (starting with \"ANNOT_*\" or \"WIDGET_*\") will be available as " "deprecated synonyms." msgstr "" #: ../../../changes.txt:2222 238de30d8f3c49d48c79ee5b21a0e5f6 msgid "" "**Changed** font support for widgets: only *Cour* (Courier), *Helv* " "(Helvetica, default), *TiRo* (Times-Roman) and *ZaDb* (ZapfDingBats) are " "accepted when **adding or changing** form fields. Only the plain versions" " are possible -- not their italic or bold variations. **Reading** " "widgets, however will show its original font." msgstr "" #: ../../../changes.txt:2223 e763e7235e744348bb116c13b8db7bfa msgid "" "**Changed** the name of the warnings buffer to " ":meth:`Tools.mupdf_warnings` and the function to empty this buffer is now" " called :meth:`Tools.reset_mupdf_warnings`." msgstr "" #: ../../../changes.txt:2224 e51bbdba4a7f47c99ae6f3828cb8299d msgid "" "**Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap`: a " "new bool argument *annots* can now be used to **suppress the rendering of" " annotations** on the page." msgstr "" #: ../../../changes.txt:2225 caaa515792364bf3902f0f1c3f484995 msgid "" "**Changed** :meth:`Page.add_file_annot` and :meth:`Page.add_text_annot` " "to enable setting an icon." msgstr "" #: ../../../changes.txt:2226 0086e4a6b881460f8c71102f2729bc2d msgid "" "**Removed** widget-related methods and attributes from the :ref:`Annot` " "object." msgstr "" #: ../../../changes.txt:2227 f50931d062644b8f880b652ea90f83f5 msgid "" "**Removed** :ref:`Document` attributes *openErrCode*, *openErrMsg*, and " ":ref:`Tools` attributes / methods *stderr*, *reset_stderr*, *stdout*, and" " *reset_stdout*." msgstr "" #: ../../../changes.txt:2228 a67f4a89f4f64dd68267c94b2d73ce86 msgid "" "**Removed** **thirdparty zlib** dependency in PyMuPDF: there are now " "compression functions available in MuPDF. Source installers of PyMuPDF " "may now omit this extra installation step." msgstr "" #: ../../../changes.txt:2230 42c8303233d940a8bb202082575e9d67 msgid "**No version published for MuPDF v1.15.0**" msgstr "" #: ../../../changes.txt:2235 0e262b2012e24e66bcbb16697b9750e3 msgid "**Changes in Version 1.14.20 / 1.14.21**" msgstr "" #: ../../../changes.txt:2237 cf8c37c3fab846c3bfc824d30a64fe50 msgid "" "**Changed** text marker annotations to support multiple rectangles / " "quadrilaterals. This fixes issue #341 (\"Question : How to addhighlight " "so that a string spread across more than a line is covered by one " "highlight?\") and similar (#285)." msgstr "" #: ../../../changes.txt:2238 cea5aecbd9e84d1aa23aa5d28149aa16 msgid "" "**Fixed** issue #331 (\"Importing PyMuPDF changes warning filtering " "behaviour globally\")." msgstr "" #: ../../../changes.txt:2243 97bdc13f89b8480bb31a7a26ed32a594 msgid "**Changes in Version 1.14.19**" msgstr "" #: ../../../changes.txt:2245 6b2efadb462c476c86b64734cc2f0abe msgid "**Fixed** issue #319 (\"InsertText function error when use custom font\")." msgstr "" #: ../../../changes.txt:2246 55649a3c6956439eb948ff4f5d16de35 msgid "" "**Added** new method :meth:`Document.get_sigflags` which returns " "information on whether a PDF is signed. Resolves issue #326 (\"How to " "detect signature in a form pdf?\")." msgstr "" #: ../../../changes.txt:2251 8b00c1d84be44f0e843dcc2f618a054f msgid "**Changes in Version 1.14.17**" msgstr "" #: ../../../changes.txt:2253 bf77aace3abb4d87a3a27f4fde38cdee msgid "" "**Added** :meth:`Document.fullcopyPage` to make full page copies within a" " PDF (not just copied references as :meth:`Document.copyPage` does)." msgstr "" #: ../../../changes.txt:2254 f5f13a70b41041ac94342d177b78283e msgid "" "**Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap` now " "use *alpha=False* as default." msgstr "" #: ../../../changes.txt:2255 0b81e0a298f842cfae56289c691fc8af msgid "" "**Changed** text extraction: the span dictionary now (again) contains its" " rectangle under the *bbox* key." msgstr "" #: ../../../changes.txt:2256 80171c31ff824cf5a8796464b7f185bd msgid "" "**Changed** :meth:`Document.movePage` and :meth:`Document.copyPage` to " "use direct functions instead of wrapping :meth:`Document.select` -- " "similar to :meth:`Document.delete_page` in v1.14.16." msgstr "" #: ../../../changes.txt:2260 2102f0e54ede402daf1c78dac1d0ca26 msgid "**Changes in Version 1.14.16**" msgstr "" #: ../../../changes.txt:2262 6703d3f0199a482cadb2d9a376aaa7c6 msgid "" "**Changed** :ref:`Document` methods around PDF */EmbeddedFiles* to no " "longer use MuPDF's \"portfolio\" functions. That support will be dropped " "in MuPDF v1.15 -- therefore another solution was required." msgstr "" #: ../../../changes.txt:2263 6447adac2fa6472d8d443e4326ffe0f4 msgid "" "**Changed** :meth:`Document.embfile_Count` to be a function (was an " "attribute)." msgstr "" #: ../../../changes.txt:2264 0f5ec06d87f74cdc82a5f05fa5beae80 msgid "" "**Added** new method :meth:`Document.embfile_Names` which returns a list " "of names of embedded files." msgstr "" #: ../../../changes.txt:2265 c99e5b42134b48d28118a34b7b00f400 msgid "" "**Changed** :meth:`Document.delete_page` and " ":meth:`Document.delete_pages` to internally no longer use " ":meth:`Document.select`, but instead use functions to perform the " "deletion directly. As it has turned out, the :meth:`Document.select` " "method yields invalid outline trees (tables of content) for very complex " "PDFs and sophisticated use of annotations." msgstr "" #: ../../../changes.txt:2270 d47507f7f3114b71864f6f89dff1d8de msgid "**Changes in Version 1.14.15**" msgstr "" #: ../../../changes.txt:2272 685a47651ab74ab9baa02751bdfeea45 msgid "" "**Fixed** issues #301 (\"Line cap and Line join\"), #300 (\"How to draw a" " shape without outlines\") and #298 (\"utils.updateRect exception\"). " "These bugs pertain to drawing shapes with PyMuPDF. Drawing shapes without" " any border is fully supported. Line cap styles and line line join style " "are now differentiated and support all possible PDF values (0, 1, 2) " "instead of just being a bool. The previous parameter *roundCap* is " "deprecated in favor of *lineCap* and *lineJoin* and will be deleted in " "the next release." msgstr "" #: ../../../changes.txt:2273 69635ffd084f40da8a77aef036ecbc5b msgid "" "**Fixed** issue #290 (\"Memory Leak with getText('rawDICT')\"). This bug " "caused memory not being (completely) freed after invoking the \"dict\", " "\"rawdict\" and \"json\" versions of :meth:`Page.getText`." msgstr "" #: ../../../changes.txt:2278 347daa4b4d614a538c8264a0f7513365 msgid "**Changes in Version 1.14.14**" msgstr "" #: ../../../changes.txt:2280 fd89b8ffed0e45b4becf36770405f0a5 msgid "" "**Added** new low-level function :meth:`ImageProperties` to determine a " "number of characteristics for an image." msgstr "" #: ../../../changes.txt:2281 5b71c3a43a3d4b468a46d3704d1a5fed msgid "" "**Added** new low-level function :meth:`Document.is_stream`, which checks" " whether an object is of stream type." msgstr "" #: ../../../changes.txt:2282 7704e37dc4954c43891ea6905e994602 msgid "" "**Changed** low-level functions :meth:`Document._getXrefString` and " ":meth:`Document._getTrailerString` now by default return object " "definitions in a formatted form which makes parsing easy." msgstr "" #: ../../../changes.txt:2286 60c8b7ae348144f590caa8dd2b6475b4 msgid "**Changes in Version 1.14.13**" msgstr "" #: ../../../changes.txt:2288 409b6e7270844e05986a6af2e04bf234 msgid "" "**Changed** methods working with binary input: while ever supporting " "bytes and bytearray objects, they now also accept *io.BytesIO* input, " "using their *getvalue()* method. This pertains to document creation, " "embedded files, FileAttachment annotations, pixmap creation and others. " "Fixes issue #274 (\"Segfault when using BytesIO as a stream for " "insertImage\")." msgstr "" #: ../../../changes.txt:2289 517a02e2889046a4bf151c5da878dec9 msgid "" "**Fixed** issue #278 (\"Is insertImage(keep_proportion=True) broken?\"). " "Images are now correctly presented when keeping aspect ratio." msgstr "" #: ../../../changes.txt:2294 d22de33a96de48479a5d908ec0ba6cd2 msgid "**Changes in Version 1.14.12**" msgstr "" #: ../../../changes.txt:2296 8e8898b2f62f4ccfabbc4633afa8d524 msgid "" "**Changed** the draw methods of :ref:`Page` and :ref:`Shape` to support " "not only RGB, but also GRAY and CMYK colorspaces. This solves issue #270 " "(\"Is there a way to use CMYK color to draw shapes?\"). This change also " "applies to text insertion methods of :ref:`Shape`, resp. :ref:`Page`." msgstr "" #: ../../../changes.txt:2297 12008f80180643aeb7c59cd9d81f7b17 msgid "" "**Fixed** issue #269 (\"AttributeError in Document.insert_page()\"), " "which occurred when using :meth:`Document.insert_page` with text " "insertion." msgstr "" #: ../../../changes.txt:2302 5926b5208b964e5bb1c6d9aa237e3b25 msgid "**Changes in Version 1.14.11**" msgstr "" #: ../../../changes.txt:2304 7cd2f991658242e0a818633e00e32840 msgid "" "**Changed** :meth:`Page.show_pdf_page` to always position the source " "rectangle centered in the target. This method now also supports " "**rotation by arbitrary angles**. The argument *reuse_xref* has been " "deprecated: prevention of duplicates is now **handled internally**." msgstr "" #: ../../../changes.txt:2305 92cb4e6a37f04f8fbe1fe50f20b4315e msgid "" "**Changed** :meth:`Page.insertImage` to support rotated display of the " "image and keeping the aspect ratio. Only rotations by multiples of 90 " "degrees are supported here." msgstr "" #: ../../../changes.txt:2306 a3321e012bd14420978e83b39fe71692 msgid "" "**Fixed** issue #265 (\"TypeError: insertText() got an unexpected keyword" " argument 'idx'\"). This issue only occurred when using " ":meth:`Document.insert_page` with also inserting text." msgstr "" #: ../../../changes.txt:2310 ce94e552e8634de490994f5a58a88b5a msgid "**Changes in Version 1.14.10**" msgstr "" #: ../../../changes.txt:2312 91400574def7471c9bcf3e3b784293fa msgid "" "**Changed** :meth:`Page.show_pdf_page` to support rotation of the source " "rectangle. Fixes #261 (\"Cannot rotate insterted pages\")." msgstr "" #: ../../../changes.txt:2313 373a473d44604ea0a33bee60a4608003 msgid "" "**Fixed** a bug in :meth:`Page.insertImage` which prevented insertion of " "multiple images provided as streams." msgstr "" #: ../../../changes.txt:2318 a745612de5d944648494f2f4fe5a7367 msgid "**Changes in Version 1.14.9**" msgstr "" #: ../../../changes.txt:2320 786372a66f0346f5b2ebf49918ac01fc msgid "" "**Added** new low-level method :meth:`Document._getTrailerString`, which " "returns the trailer object of a PDF. This is much like " ":meth:`Document._getXrefString` except that the PDF trailer has no / " "needs no :data:`xref` to identify it." msgstr "" #: ../../../changes.txt:2321 166ee0276f23464790afa4aa78d3fb2b msgid "" "**Added** new parameters for text insertion methods. You can now set " "stroke and fill colors of glyphs (text characters) independently, as well" " as the thickness of the glyph border. A new parameter *render_mode* " "controls the use of these colors, and whether the text should be visible " "at all." msgstr "" #: ../../../changes.txt:2322 ec5e00cd07f74051b60872c21459da65 msgid "" "**Fixed** issue #258 (\"Copying image streams to new PDF without size " "increase\"): For JPX images embedded in a PDF, " ":meth:`Document.extractImage` will now return them in their original " "format. Previously, the MuPDF base library was used, which returns them " "in PNG format (entailing a massive size increase)." msgstr "" #: ../../../changes.txt:2323 9c4df9a330534524ae96733260628fa2 msgid "" "**Fixed** issue #259 (\"Morphing text to fit inside rect\"). Clarified " "use of :meth:`get_text_length` and removed extra line breaks for long " "words." msgstr "" #: ../../../changes.txt:2327 40cd0da7bb2c49d28cf036e85d01e73d msgid "**Changes in Version 1.14.8**" msgstr "" #: ../../../changes.txt:2329 c23dc29674cd4476a5d1ce8bdba7c25b msgid "" "**Added** :meth:`Pixmap.set_rect` to change the pixel values in a " "rectangle. This is also an alternative to setting the color of a complete" " pixmap (:meth:`Pixmap.clear_with`)." msgstr "" #: ../../../changes.txt:2330 647ba02e1ad3448b85b1e417300551d5 msgid "" "**Fixed** an image extraction issue with JBIG2 (monochrome) encoded PDF " "images. The issue occurred in :meth:`Page.getText` (parameters \"dict\" " "and \"rawdict\") and in :meth:`Document.extractImage` methods." msgstr "" #: ../../../changes.txt:2331 97187008a30a4a7cad0a589358db47c2 msgid "" "**Fixed** an issue with not correctly clearing a non-alpha :ref:`Pixmap` " "(:meth:`Pixmap.clear_with`)." msgstr "" #: ../../../changes.txt:2332 e8d31f10770246f0a19e29e3fe088dba msgid "" "**Fixed** an issue with not correctly inverting colors of a non-alpha " ":ref:`Pixmap` (:meth:`Pixmap.invert_irect`)." msgstr "" #: ../../../changes.txt:2336 67dff84982fa4c1680c49d7d32e32cd7 msgid "**Changes in Version 1.14.7**" msgstr "" #: ../../../changes.txt:2338 7a13d485e8154810a7af7370e7e9252d msgid "**Added** :meth:`Pixmap.set_pixel` to change one pixel value." msgstr "" #: ../../../changes.txt:2339 4c9debbd3ad14281953bef2ed96535b3 msgid "**Added** documentation for image conversion in the :ref:`FAQ`." msgstr "" #: ../../../changes.txt:2340 78bdc22a5a5e4e64a9d8b4b07bfb1123 msgid "" "**Added** new function :meth:`get_text_length` to determine the string " "length for a given font." msgstr "" #: ../../../changes.txt:2341 a5c814fd37c640aa8a93aa10f85c235c msgid "" "**Added** Postscript image output (changed :meth:`Pixmap.save` and " ":meth:`Pixmap.tobytes`)." msgstr "" #: ../../../changes.txt:2342 f3c2525369734e7089b7c83e8cf9de47 msgid "" "**Changed** :meth:`Pixmap.save` and :meth:`Pixmap.tobytes` to ensure " "valid combinations of colorspace, alpha and output format." msgstr "" #: ../../../changes.txt:2343 b9e74f4416644fccb65daa7e89c723c3 msgid "" "**Changed** :meth:`Pixmap.save`: the desired format is now inferred from " "the filename." msgstr "" #: ../../../changes.txt:2344 2d75602bfe7c4491afe16b74bc43214f msgid "" "**Changed** FreeText annotations can now have a transparent background - " "see :meth:`Annot.update`." msgstr "" #: ../../../changes.txt:2348 6c3551ae311845ee9b99b03931d18295 msgid "**Changes in Version 1.14.5**" msgstr "" #: ../../../changes.txt:2350 bf604455e7bc49078d6f8fad925b9c40 msgid "" "**Changed:** :ref:`Shape` methods now strictly use the transformation " "matrix of the :ref:`Page` -- instead of \"manually\" calculating " "locations." msgstr "" #: ../../../changes.txt:2351 a31dae7889694da7be488d4e185ec9eb msgid "" "**Added** method :meth:`Pixmap.pixel` which returns the pixel value (a " "list) for given pixel coordinates." msgstr "" #: ../../../changes.txt:2352 27fb489fd3c4437dae7d84ea827220f4 msgid "" "**Added** method :meth:`Pixmap.tobytes` which returns a bytes object " "representing the pixmap in a variety of formats. Previously, this could " "be done for PNG outputs only (:meth:`Pixmap.tobytes`)." msgstr "" #: ../../../changes.txt:2353 1c71f20d72344b9d92a9db58d371f81b msgid "" "**Changed:** output of methods :meth:`Pixmap.save` and (the new) " ":meth:`Pixmap.tobytes` may now also be PSD (Adobe Photoshop Document)." msgstr "" #: ../../../changes.txt:2354 fa29ec91aa714c5f907b7366ffb9a3b9 msgid "" "**Added** method :meth:`Shape.drawQuad` which draws a :ref:`Quad`. This " "actually is a shorthand for a :meth:`Shape.drawPolyline` with the edges " "of the quad." msgstr "" #: ../../../changes.txt:2355 91031a98d09349dbb69473db2e7329ec msgid "" "**Changed** method :meth:`Shape.drawOval`: the argument can now be " "**either** a rectangle (:data:`rect_like`) **or** a quadrilateral " "(:data:`quad_like`)." msgstr "" #: ../../../changes.txt:2359 0e8436f8a5324f5c854c6da3891f584a msgid "**Changes in Version 1.14.4**" msgstr "" #: ../../../changes.txt:2361 f161930e41614a59bd8398be1a48b0c9 msgid "**Fixes** issue #239 \"Annotation coordinate consistency\"." msgstr "" #: ../../../changes.txt:2366 f717329397b04912b44b761001662800 msgid "**Changes in Version 1.14.3**" msgstr "" #: ../../../changes.txt:2368 c8623149250744e589dc449330738ae7 msgid "This patch version contains minor bug fixes and CJK font output support." msgstr "" #: ../../../changes.txt:2370 090ca3d9b2344ba888c0876c7b71ace0 msgid "" "**Added** support for the four CJK fonts as PyMuPDF generated text " "output. This pertains to methods :meth:`Page.insertFont`, " ":meth:`Shape.insertText`, :meth:`Shape.insertTextbox`, and corresponding " ":ref:`Page` methods. The new fonts are available under \"reserved\" " "fontnames \"china-t\" (traditional Chinese), \"china-s\" (simplified " "Chinese), \"japan\" (Japanese), and \"korea\" (Korean)." msgstr "" #: ../../../changes.txt:2371 0883c9f987274b41ae7f270c3f497622 msgid "**Added** full support for the built-in fonts 'Symbol' and 'Zapfdingbats'." msgstr "" #: ../../../changes.txt:2372 28cecba376654ea4aabaf41a9a9e76a0 msgid "" "**Changed:** The 14 standard fonts can now each be referenced by a " "4-letter abbreviation." msgstr "" #: ../../../changes.txt:2376 2af6e8674b4443da9ecbfff548ce5a69 msgid "**Changes in Version 1.14.1**" msgstr "" #: ../../../changes.txt:2378 b0f0dfdd4d05439fbb192a2fff012afd msgid "This patch version contains minor performance improvements." msgstr "" #: ../../../changes.txt:2380 d55c7a1c5617427cae944d98885ab488 msgid "" "**Added** support for :ref:`Document` filenames given as *pathlib* object" " by using the Python *str()* function." msgstr "" #: ../../../changes.txt:2385 8408ffdc08bd4b988e1d1d8706e8852d msgid "**Changes in Version 1.14.0**" msgstr "" #: ../../../changes.txt:2387 5e88bed306444855bb7cb18769259f07 msgid "" "To support MuPDF v1.14.0, massive changes were required in PyMuPDF -- " "most of them purely technical, with little visibility to developers. But " "there are also quite a lot of interesting new and improved features. " "Following are the details:" msgstr "" #: ../../../changes.txt:2389 ddc84ec9e77d406180396849960f6fd3 msgid "**Added** \"ink\" annotation." msgstr "" #: ../../../changes.txt:2390 5ef49f9b2028452da946e586194111bd msgid "**Added** \"rubber stamp\" annotation." msgstr "" #: ../../../changes.txt:2391 4a7bb926db894ea39c7f10315f2e825a msgid "**Added** \"squiggly\" text marker annotation." msgstr "" #: ../../../changes.txt:2392 3398303dd33846db9cfde43f06070d2d msgid "" "**Added** new class :ref:`Quad` (quadrilateral or tetragon) -- which " "represents a general four-sided shape in the plane. The special subtype " "of rectangular, non-empty tetragons is used in text marker annotations " "and as returned objects in text search methods." msgstr "" #: ../../../changes.txt:2393 6c56ac281b924d2fb189ede6e9c8be61 msgid "" "**Added** a new option \"decrypt\" to :meth:`Document.save` and " ":meth:`Document.write`. Now you can **keep encryption** when saving a " "password protected PDF." msgstr "" #: ../../../changes.txt:2394 b394b2a1574646c89160273346915f47 msgid "" "**Added** suppression and redirection of unsolicited messages issued by " "the underlying C-library MuPDF. Consult :ref:`RedirectMessages` for " "details." msgstr "" #: ../../../changes.txt:2395 47856295d652463f8184801b60dee8a0 msgid "" "**Changed:** Changes to annotations now **always require** " ":meth:`Annot.update` to become effective." msgstr "" #: ../../../changes.txt:2396 ef1b316a5b024381bc8ab808d69d2891 msgid "" "**Changed** free text annotations to support the full Latin character set" " and range of appearance options." msgstr "" #: ../../../changes.txt:2397 506d4cd601f04e2c83386b5ec8940898 msgid "" "**Changed** text searching, :meth:`Page.searchFor`, to optionally return " ":ref:`Quad` instead :ref:`Rect` objects surrounding each search hit." msgstr "" #: ../../../changes.txt:2398 4fd963295c354372b9e8574e51f097ee msgid "" "**Changed** plain text output: we now add a *\\n* to each line if it does" " not itself end with this character." msgstr "" #: ../../../changes.txt:2399 1db7b0929bbf4596b2a0d22f3ca7b59c msgid "**Fixed** issue 211 (\"Something wrong in the doc\")." msgstr "" #: ../../../changes.txt:2400 f1128c764272467f8fb8a6c3a9b0087e msgid "" "**Fixed** issue 213 (\"Rewritten outline is displayed only by mupdf-based" " applications\")." msgstr "" #: ../../../changes.txt:2401 f7b1e5c7dc7c4676a9bf4838c03b508c msgid "**Fixed** issue 214 (\"PDF decryption GONE!\")." msgstr "" #: ../../../changes.txt:2402 7a1c216e3cf04513bac8a38d46fb777a msgid "**Fixed** issue 215 (\"Formatting of links added with pyMuPDF\")." msgstr "" #: ../../../changes.txt:2403 9c9ae8e5f826442d8888cefae230e64e msgid "**Fixed** issue 217 (\"extraction through json is failing for my pdf\")." msgstr "" #: ../../../changes.txt:2405 5ae51da467b64e26bfb10cf525eb9581 msgid "" "Behind the curtain, we have changed the implementation of geometry " "objects: they now purely exist in Python and no longer have \"shadow\" " "twins on the C-level (in MuPDF). This has improved processing speed in " "that area by more than a factor of two." msgstr "" #: ../../../changes.txt:2407 b5211152c64342a49990467a8d763bd5 msgid "" "Because of the same reason, most methods involving geometry parameters " "now also accept the corresponding Python sequence. For example, in method" " *\"page.show_pdf_page(rect, ...)\"* parameter *rect* may now be any " ":data:`rect_like` sequence." msgstr "" #: ../../../changes.txt:2409 79b7deaba4ec49f58fd8987c7e950e28 msgid "" "We also invested considerable effort to further extend and improve the " ":ref:`FAQ` chapter." msgstr "" #: ../../../changes.txt:2414 fd91322d1a494ed189d8932bb19e425a msgid "**Changes in Version 1.13.19**" msgstr "" #: ../../../changes.txt:2416 c99f01c86e0f418e8ece858b509f575f msgid "" "This version contains some technical / performance improvements and bug " "fixes." msgstr "" #: ../../../changes.txt:2418 f6ca673e1a514b8c88882528546fc938 #, python-format msgid "" "**Changed** memory management: for Python 3 builds, Python memory " "management is exclusively used across all C-level code (i.e. no more " "native *malloc()* in MuPDF code or PyMuPDF interface code). This leads to" " improved memory usage profiles and also some runtime improvements: we " "have seen > 2% shorter runtimes for text extractions and pixmap creations" " (on Windows machines only to date)." msgstr "" #: ../../../changes.txt:2419 5bfccbbb021842b9abb0b04bf9de48c3 msgid "" "**Fixed** an error occurring in Python 2.7, which crashed the interpreter" " when using :meth:`TextPage.extractRAWDICT` (= " "*Page.getText(\"rawdict\")*)." msgstr "" #: ../../../changes.txt:2420 0f2cb31dfbf9466fa8a235d46d2c6e8a msgid "" "**Fixed** an error occurring in Python 2.7, when creating link " "destinations." msgstr "" #: ../../../changes.txt:2421 08e34b265b7e454f94220ea943997f4d msgid "**Extended** the :ref:`FAQ` chapter with more examples." msgstr "" #: ../../../changes.txt:2425 63b7e43da4034c64859e960033709c83 msgid "**Changes in Version 1.13.18**" msgstr "" #: ../../../changes.txt:2427 cf5beb6e03c54affafc84f316858c9aa msgid "" "**Added** method :meth:`TextPage.extractRAWDICT`, and a corresponding new" " string parameter \"rawdict\" to method :meth:`Page.getText`. It extracts" " text and images from a page in Python *dict* form like " ":meth:`TextPage.extractDICT`, but with the detail level of " ":meth:`TextPage.extractXML`, which is position information down to each " "single character." msgstr "" #: ../../../changes.txt:2431 9b563f0c8c3a4d1fb8e8fe127bb76d6c msgid "**Changes in Version 1.13.17**" msgstr "" #: ../../../changes.txt:2433 b3c0162af9db4f608389e2c811c7bc4b msgid "" "**Fixed** an error that intermittently caused an exception in " ":meth:`Page.show_pdf_page`, when pages from many different source PDFs " "were shown." msgstr "" #: ../../../changes.txt:2434 c35c79318b584e5790dbea763351299b msgid "" "**Changed** method :meth:`Document.extractImage` to now return more meta " "information about the extracted imgage. Also, its performance has been " "greatly improved. Several demo scripts have been changed to make use of " "this method." msgstr "" #: ../../../changes.txt:2435 ef0a501dd401489f8d0796417bf84a65 msgid "" "**Changed** method :meth:`Document._getXrefStream` to now return *None* " "if the object is no stream and no longer raise an exception if otherwise." msgstr "" #: ../../../changes.txt:2436 7032fecda32745aeb0b54febfa6571f7 msgid "" "**Added** method :meth:`Document._deleteObject` which deletes a PDF " "object identified by its :data:`xref`. Only to be used by the experienced" " PDF expert." msgstr "" #: ../../../changes.txt:2437 64f62a994fb742cf84570443580cf6a2 msgid "" "**Added** a method :meth:`paper_rect` which returns a :ref:`Rect` for a " "supplied paper format string. Example: *fitz.paper_rect(\"letter\") = " "fitz.Rect(0.0, 0.0, 612.0, 792.0)*." msgstr "" #: ../../../changes.txt:2438 31e24169fc6849878acc3c4b81c2931b msgid "**Added** a :ref:`FAQ` chapter to this document." msgstr "" #: ../../../changes.txt:2442 43d63ac60a0c46a591e1b79f54377917 msgid "**Changes in Version 1.13.16**" msgstr "" #: ../../../changes.txt:2444 d904d04d3cfb4dcda46139c25fe24c71 msgid "" "**Added** support for correctly setting transparency (opacity) for " "certain annotation types." msgstr "" #: ../../../changes.txt:2445 3b7e735489e94623ac095480bdcbc2a5 msgid "" "**Added** a tool property (:attr:`Tools.fitz_config`) showing the " "configuration of this PyMuPDF version." msgstr "" #: ../../../changes.txt:2446 9c879f61145948b188ee8d93c5efe154 msgid "" "**Fixed** issue #193 ('insertText(overlay=False) gives \"cannot resize a " "buffer with shared storage\" error') by avoiding read-only buffers." msgstr "" #: ../../../changes.txt:2450 5d037ed847b44095be41047f123f2c7d msgid "**Changes in Version 1.13.15**" msgstr "" #: ../../../changes.txt:2452 7b20562ab960458cb2a37834b262bc0a msgid "" "**Fixed** issue #189 (\"cannot find builtin CJK font\"), so we are " "supporting builtin CJK fonts now (CJK = China, Japan, Korea). This should" " lead to correctly generated pixmaps for documents using these languages." " This change has consequences for our binary file size: it will now range" " between 8 and 10 MB, depending on the OS." msgstr "" #: ../../../changes.txt:2453 09714417974d4784bbb8ce28449b0ed4 msgid "" "**Fixed** issue #191 (\"Jupyter notebook kernel dies after ca. 40 " "pages\"), which occurred when modifying the contents of an annotation." msgstr "" #: ../../../changes.txt:2457 5adc29b99ec94005bffd7ef24998e110 msgid "**Changes in Version 1.13.14**" msgstr "" #: ../../../changes.txt:2459 7f38a7f515424bdf958094ead9ab7ef0 msgid "This patch version contains several improvements, mainly for annotations." msgstr "" #: ../../../changes.txt:2461 b1c7424aa4d54a5caefae33e0e5f4f84 msgid "" "**Changed** :attr:`Annot.lineEnds` is now a list of two integers " "representing the line end symbols. Previously was a *dict* of strings." msgstr "" #: ../../../changes.txt:2462 641b3d6d6a8f46359ce78aacec1a00fe msgid "" "**Added** support of line end symbols for applicable annotations. PyMuPDF" " now can generate these annotations including the line end symbols." msgstr "" #: ../../../changes.txt:2463 f00765d5f2434220a9bfa1b43ce083c6 msgid "" "**Added** :meth:`Annot.setLineEnds` adds line end symbols to applicable " "annotation types ('Line', 'PolyLine', 'Polygon')." msgstr "" #: ../../../changes.txt:2464 c43498bf8fbe4da3bbbd2a1b57eb2ade msgid "" "**Changed** technical implementation of :meth:`Page.insertImage` and " ":meth:`Page.show_pdf_page`: they now create there own contents objects, " "thereby avoiding changes of potentially large streams with consequential " "compression / decompression efforts and high change volumes with " "incremental updates." msgstr "" #: ../../../changes.txt:2468 6d6106b5cef0412c859b77efff74d76a msgid "**Changes in Version 1.13.13**" msgstr "" #: ../../../changes.txt:2470 76e178082cef4bbcaf9d02facb74a2a8 msgid "" "This patch version contains several improvements for embedded files and " "file attachment annotations." msgstr "" #: ../../../changes.txt:2472 a3ecffcb691f41e18fa492558ef375d5 msgid "" "**Added** :meth:`Document.embfile_Upd` which allows changing **file " "content and metadata** of an embedded file. It supersedes the old method " ":meth:`Document.embfile_SetInfo` (which will be deleted in a future " "version). Content is automatically compressed and metadata may be " "unicode." msgstr "" #: ../../../changes.txt:2473 8741c8c5503e49c5a9e436d200d0c70c msgid "" "**Changed** :meth:`Document.embfile_Add` to now automatically compress " "file content. Accompanying metadata can now be unicode (had to be ASCII " "in the past)." msgstr "" #: ../../../changes.txt:2474 c8825e3ce49940899586673a8c1ca760 msgid "" "**Changed** :meth:`Document.embfile_Del` to now automatically delete " "**all entries** having the supplied identifying name. The return code is " "now an integer count of the removed entries (was *None* previously)." msgstr "" #: ../../../changes.txt:2475 4958c06f7c0b4eaca87af2482582ca8c msgid "" "**Changed** embedded file methods to now also accept or show the PDF " "unicode filename as additional parameter *ufilename*." msgstr "" #: ../../../changes.txt:2476 0f95f3527f1a489a9a72167a6cee97cf msgid "" "**Added** :meth:`Page.add_file_annot` which adds a new file attachment " "annotation." msgstr "" #: ../../../changes.txt:2477 14f2faf502b74997b3e11958e4ffd5dd msgid "" "**Changed** :meth:`Annot.fileUpd` (file attachment annot) to now also " "accept the PDF unicode *ufilename* parameter. The description parameter " "*desc* correctly works with unicode. Furthermore, **all** parameters are " "optional, so metadata may be changed without also replacing the file " "content." msgstr "" #: ../../../changes.txt:2478 f11e4025175f468fb362dc45b4b459a8 msgid "" "**Changed** :meth:`Annot.fileInfo` (file attachment annot) to now also " "show the PDF unicode filename as parameter *ufilename*." msgstr "" #: ../../../changes.txt:2479 96f083ba329841dc866568603f6bf4e0 msgid "" "**Fixed** issue #180 (\"page.getText(output='dict') return invalid " "bbox\") to now also work for vertical text." msgstr "" #: ../../../changes.txt:2480 b9c17d72bfcd4a87983f018daf4d8fd9 msgid "" "**Fixed** issue #185 (\"Can't render the annotations created by " "PyMuPDF\"). The issue's cause was the minimalistic MuPDF approach when " "creating annotations. Several annotation types have no */AP* " "(\"appearance\") object when created by MuPDF functions. MuPDF, " "SumatraPDF and hence also PyMuPDF cannot render annotations without such " "an object. This fix now ensures, that an appearance object is always " "created together with the annotation itself. We still do not support line" " end styles." msgstr "" #: ../../../changes.txt:2484 17b80da49d874916b1fa04cbc2e8225e msgid "**Changes in Version 1.13.12**" msgstr "" #: ../../../changes.txt:2486 16cf3df1aa764ac99837e6ba6929de3a msgid "" "**Fixed** issue #180 (\"page.getText(output='dict') return invalid " "bbox\"). Note that this is a circumvention of an MuPDF error, which " "generates zero-height character rectangles in some cases. When this " "happens, this fix ensures a bbox height of at least fontsize." msgstr "" #: ../../../changes.txt:2487 61159291a2db420095ce281675ae121e msgid "" "**Changed** for ListBox and ComboBox widgets, the attribute list of " "selectable values has been renamed to :attr:`Widget.choice_values`." msgstr "" #: ../../../changes.txt:2488 bab6778e8c2944089f3b525aa8b0827d msgid "" "**Changed** when adding widgets, any missing of the :ref:`Base-14-Fonts` " "is automatically added to the PDF. Widget text fonts can now also be " "chosen from existing widget fonts. Any specified field values are now " "honored and lead to a field with a preset value." msgstr "" #: ../../../changes.txt:2489 30b1813eb102490a896faa64748c1400 msgid "" "**Added** :meth:`Annot.updateWidget` which allows changing existing form " "fields -- including the field value." msgstr "" #: ../../../changes.txt:2493 9bc92bc23e1a46ab8548886763c96d47 msgid "**Changes in Version 1.13.11**" msgstr "" #: ../../../changes.txt:2495 474a1a3d16e74ac7bcfe223ce5d3daad msgid "" "While the preceeding patch subversions only contained various fixes, this" " version again introduces major new features:" msgstr "" #: ../../../changes.txt:2497 5edc44b1ecc84b25be1507861ce353f4 msgid "" "**Added** basic support for PDF widget annotations. You can now add PDF " "form fields of types Text, CheckBox, ListBox and ComboBox. Where " "necessary, the PDF is tranformed to a Form PDF with the first added " "widget." msgstr "" #: ../../../changes.txt:2498 1a904dc65fe64ade80e693aa4edb88ae msgid "" "**Fixed** issues #176 (\"wrong file embedding\"), #177 (\"segment fault " "when invoking page.getText()\")and #179 (\"Segmentation fault using " "page.getLinks() on encrypted PDF\")." msgstr "" #: ../../../changes.txt:2503 7b2a31d79daa40d497d99853e692f397 msgid "**Changes in Version 1.13.7**" msgstr "" #: ../../../changes.txt:2505 445d2b1c88854acbb84fecfeeb62cdc1 msgid "" "**Added** support of variable page sizes for reflowable documents " "(e-books, HTML, etc.): new parameters *rect* and *fontsize* in " ":ref:`Document` creation (open), and as a separate method " ":meth:`Document.layout`." msgstr "" #: ../../../changes.txt:2506 b16382d708314b4c9ed3ac5b10f9a517 msgid "" "**Added** :ref:`Annot` creation of many annotations types: sticky notes, " "free text, circle, rectangle, line, polygon, polyline and text markers." msgstr "" #: ../../../changes.txt:2507 1444d852579b4d93837b7fe871afbf81 msgid "" "**Added** support of annotation transparency (:attr:`Annot.opacity`, " ":meth:`Annot.setOpacity`)." msgstr "" #: ../../../changes.txt:2508 d544fe252c1f408785338b846f68eb33 msgid "" "**Changed** :attr:`Annot.vertices`: point coordinates are now grouped as " "pairs of floats (no longer as separate floats)." msgstr "" #: ../../../changes.txt:2509 d7dd102d5d974b77a860d4ee2a960da8 msgid "" "**Changed** annotation colors dictionary: the two keys are now named " "*\"stroke\"* (formerly *\"common\"*) and *\"fill\"*." msgstr "" #: ../../../changes.txt:2510 8ba3ff12895543d4b2b60a1b9a3646d4 msgid "" "**Added** :attr:`Document.isDirty` which is *True* if a PDF has been " "changed in this session. Reset to *False* on each :meth:`Document.save` " "or :meth:`Document.write`." msgstr "" #: ../../../changes.txt:2514 572be3e137d346d1bc831219977e2a47 msgid "**Changes in Version 1.13.6**" msgstr "" #: ../../../changes.txt:2516 32c7a915842343e78b6da4d29061d488 msgid "" "Fix #173: for memory-resident documents, ensure the stream object will " "not be garbage-collected by Python before document is closed." msgstr "" #: ../../../changes.txt:2520 dfb8278835404213b0f3e00e10fa6f44 msgid "**Changes in Version 1.13.5**" msgstr "" #: ../../../changes.txt:2522 d0f227e259ff4badbddfa8bc99f77761 msgid "" "New low-level method :meth:`Page._setContents` defines an object given by" " its :data:`xref` to serve as the :data:`contents` object." msgstr "" #: ../../../changes.txt:2523 f305bdd0987e4a1f95ef94714cb586b7 msgid "" "Changed and extended PDF form field support: the attribute *widget_text* " "has been renamed to :attr:`Annot.widget_value`. Values of all form field " "types (except signatures) are now supported. A new attribute " ":attr:`Annot.widget_choices` contains the selectable values of listboxes " "and comboboxes. All these attributes now contain *None* if no value is " "present." msgstr "" #: ../../../changes.txt:2527 4fd769eb21f048a19b8230f7e72178ca msgid "**Changes in Version 1.13.4**" msgstr "" #: ../../../changes.txt:2529 53ed864ab32f470bb28b858354a50e08 msgid "" ":meth:`Document.convertToPDF` now supports page ranges, reverted page " "sequences and page rotation. If the document already is a PDF, an " "exception is raised." msgstr "" #: ../../../changes.txt:2530 76b57e7db1504c5aba637f3c1da9e11c msgid "" "Fixed a bug (introduced with v1.13.0) that prevented " ":meth:`Page.insertImage` for transparent images." msgstr "" #: ../../../changes.txt:2534 2ee92c34815a4f8fb2c8e58d119f4ea1 msgid "**Changes in Version 1.13.3**" msgstr "" #: ../../../changes.txt:2536 b6964dbe69ac4c14913e804c1db84219 msgid "" "Introduces a way to convert **any MuPDF supported document** to a PDF. If" " you ever wanted PDF versions of your XPS, EPUB, CBZ or FB2 files -- here" " is a way to do this." msgstr "" #: ../../../changes.txt:2538 3b8c44dc6cc2424186ca83fb933f4d4d msgid "" ":meth:`Document.convertToPDF` returns a Python *bytes* object in PDF " "format. Can be opened like normal in PyMuPDF, or be written to disk with " "the *\".pdf\"* extension." msgstr "" #: ../../../changes.txt:2542 a74fa53b1f63473e95f8ae83eadc426f msgid "**Changes in Version 1.13.2**" msgstr "" #: ../../../changes.txt:2544 7ebed477136d45edbc0674eaaa9dff08 msgid "" "The major enhancement is PDF form field support. Form fields are " "annotations of type *(19, 'Widget')*. There is a new document method to " "check whether a PDF is a form. The :ref:`Annot` class has new properties " "describing field details." msgstr "" #: ../../../changes.txt:2546 6224991d69044aed91933c6ef3db8872 msgid "" ":attr:`Document.is_form_pdf` is true if object type */AcroForm* and at " "least one form field exists." msgstr "" #: ../../../changes.txt:2547 3c3eddc4ca6a41179dba2d970ae478cf msgid "" ":attr:`Annot.widget_type`, :attr:`Annot.widget_text` and " ":attr:`Annot.widget_name` contain the details of a form field (i.e. a " "\"Widget\" annotation)." msgstr "" #: ../../../changes.txt:2551 33caa17db3314e8f8ec675dfcc887087 msgid "**Changes in Version 1.13.1**" msgstr "" #: ../../../changes.txt:2553 9344a01be7c64abbbe4577c065593441 msgid "" ":meth:`TextPage.extractDICT` is a new method to extract the contents of a" " document page (text and images). All document types are supported as " "with the other :ref:`TextPage` *extract*()* methods. The returned object " "is a dictionary of nested lists and other dictionaries, and **exactly " "equal** to the JSON-deserialization of the old " ":meth:`TextPage.extractJSON`. The difference is that the result is " "created directly -- no JSON module is used. Because the user needs no " "JSON module to interpet the information, it should be easier to use, and " "also have a better performance, because it contains images in their " "original **binary format** -- they need not be base64-decoded." msgstr "" #: ../../../changes.txt:2554 a0c4ad5a3c484f91ac0a8e10f14f5e12 msgid "" ":meth:`Page.getText` correspondingly supports the new parameter value " "*\"dict\"* to invoke the above method." msgstr "" #: ../../../changes.txt:2555 093f2f8fbd7d47c8a423fd962433aaf6 msgid "" ":meth:`TextPage.extractJSON` (resp. *Page.getText(\"json\")*) is still " "supported for convenience, but its use is expected to decline." msgstr "" #: ../../../changes.txt:2559 0502f4342d864193843c189056a3f649 msgid "**Changes in Version 1.13.0**" msgstr "" #: ../../../changes.txt:2561 a1fd3f8dcf7347f0b02e341033bab447 msgid "" "This version is based on MuPDF v1.13.0. This release is \"primarily a bug" " fix release\"." msgstr "" #: ../../../changes.txt:2563 f6293a0c60534e0aa61af056ce5873ab msgid "" "In PyMuPDF, we are also doing some bug fixes while introducing minor " "enhancements. There only very minimal changes to the user's API." msgstr "" #: ../../../changes.txt:2565 112b9e394ace4296b2004b9cc2566a4c msgid "" ":ref:`Document` construction is more flexible: the new *filetype* " "parameter allows setting the document type. If specified, any extension " "in the filename will be ignored. More completely addresses `issue #156 " "`_. As part of this, the " "documentation has been reworked." msgstr "" #: ../../../changes.txt:2569 1fd37787dc5e4b74860ae968de485c3a msgid "Changes to :ref:`Pixmap` constructors:" msgstr "" #: ../../../changes.txt:2568 b1dfea15e23f480e9294338557073269 msgid "" "Colorspace conversion no longer allows dropping the alpha channel: source" " and target **alpha will now always be the same**. We have seen " "exceptions and even interpreter crashes when using *alpha = 0*." msgstr "" #: ../../../changes.txt:2569 d13b23318d24436a98e726ab0c700090 msgid "As a replacement, the simple pixmap copy lets you choose the target alpha." msgstr "" #: ../../../changes.txt:2571 1245466299bd401c91dede79edbe0761 msgid "" ":meth:`Document.save` again offers the full garbage collection range 0 " "thru 4. Because of a bug in :data:`xref` maintenance, we had to " "temporarily enforce *garbage > 1*. Finally resolves `issue #148 " "`_." msgstr "" #: ../../../changes.txt:2573 5e0acf1f4a8b4284b68c4664d8506094 msgid "" ":meth:`Document.save` now offers to \"prettify\" PDF source via an " "additional argument." msgstr "" #: ../../../changes.txt:2574 696c719c11ba4d4f8436604179238f4f msgid "" ":meth:`Page.insertImage` has the additional *stream* \\-parameter, " "specifying a memory area holding an image." msgstr "" #: ../../../changes.txt:2576 083d9194c33f41068f0776f565c79c87 msgid "" "Issue with garbled PNGs on Linux systems has been resolved (`\"Problem " "writing PNG\" #133) `_." msgstr "" #: ../../../changes.txt:2581 98cc7e1927894f43bd5433b0231b3dcf msgid "**Changes in Version 1.12.4**" msgstr "" #: ../../../changes.txt:2583 7611c52e40a247d499880fc162bf20bb msgid "This is an extension of 1.12.3." msgstr "" #: ../../../changes.txt:2585 55de61bfb5954f95b17921dcd4914391 msgid "" "Fix of `issue #147 `_: " "methods :meth:`Document.getPageFontlist` and " ":meth:`Document.getPageImagelist` now also show fonts and images " "contained in :data:`resources` nested via \"Form XObjects\"." msgstr "" #: ../../../changes.txt:2586 241a50f48e4b403481f23435638646e1 msgid "" "Temporary fix of `issue #148 " "`_: Saving to new PDF " "files will now automatically use *garbage = 2* if a lower value is given." " Final fix is to be expected with MuPDF's next version. At that point we " "will remove this circumvention." msgstr "" #: ../../../changes.txt:2587 d1aeb27a9161455f91a41a0c53d1de52 msgid "" "Preventive fix of illegally using stencil / image mask pixmaps in some " "methods." msgstr "" #: ../../../changes.txt:2588 4d9f3bf7e9db4f75a524f3e201db2d32 msgid "" "Method :meth:`Document.getPageFontlist` now includes the encoding name " "for each font in the list." msgstr "" #: ../../../changes.txt:2589 da72830c7d2c40009f927c37bd604e55 msgid "" "Method :meth:`Document.getPageImagelist` now includes the decode method " "name for each image in the list." msgstr "" #: ../../../changes.txt:2593 b3c6fae68a704c8eb5f4e78304a1d854 msgid "**Changes in Version 1.12.3**" msgstr "" #: ../../../changes.txt:2595 4c52faae63874d45873aa766f417ab6f msgid "This is an extension of 1.12.2." msgstr "" #: ../../../changes.txt:2597 943612aea06749f4962d1ced1418925a msgid "" "Many functions now return *None* instead of *0*, if the result has no " "other meaning than just indicating successful execution " "(:meth:`Document.close`, :meth:`Document.save`, :meth:`Document.select`, " ":meth:`Pixmap.save` and many others)." msgstr "" #: ../../../changes.txt:2601 6f0d4e2bdd41401d94ed4fe0fd9ec7e8 msgid "**Changes in Version 1.12.2**" msgstr "" #: ../../../changes.txt:2603 630bed92f4e34421925b88efe1ba42b6 msgid "This is an extension of 1.12.1." msgstr "" #: ../../../changes.txt:2605 50a351aa4579484893c9094cda2cfeba msgid "" "Method :meth:`Page.show_pdf_page` now accepts the new *clip* argument. " "This specifies an area of the source page to which the display should be " "restricted." msgstr "" #: ../../../changes.txt:2607 80570d982b004e41989292ba7bb4ddb9 msgid "" "New :attr:`Page.CropBox` and :attr:`Page.MediaBox` have been included for" " convenience." msgstr "" #: ../../../changes.txt:2612 54fd6f1c51e04778bac0835de4f0361a msgid "**Changes in Version 1.12.1**" msgstr "" #: ../../../changes.txt:2614 db11fc420c4b4bd59ba30cf2a4f190d3 msgid "This is an extension of version 1.12.0." msgstr "" #: ../../../changes.txt:2616 82affdfbc4bb42ccabe2c77070a11719 msgid "" "New method :meth:`Page.show_pdf_page` displays another's PDF page. This " "is a **vector** image and therefore remains precise across zooming. Both " "involved documents must be PDF." msgstr "" #: ../../../changes.txt:2618 f0e7a4343cf14d058e07063707db7b7e msgid "" "New method :meth:`Page.getSVGimage` creates an SVG image from the page. " "In contrast to the raster image of a pixmap, this is a vector image " "format. The return is a unicode text string, which can be saved in a " "*.svg* file." msgstr "" #: ../../../changes.txt:2620 c81d51dc94f646fda815c43c09bab73d msgid "" "Method :meth:`Page.getTextBlocks` now accepts an additional bool " "parameter \"images\". If set to true (default is false), image blocks " "(metadata only) are included in the produced list and thus allow " "detecting areas with rendered images." msgstr "" #: ../../../changes.txt:2622 5eafe44f47b34527bfff5138b15affd3 msgid "Minor bug fixes." msgstr "" #: ../../../changes.txt:2624 6bf7252d584b4c8e9b97592fc0d934e4 msgid "" "\"text\" result of :meth:`Page.getText` concatenates all lines within a " "block using a single space character. MuPDF's original uses \"\\\\n\" " "instead, producing a rather ragged output." msgstr "" #: ../../../changes.txt:2626 94bf5fb0e50249e78857f02ebaaff525 msgid "" "New properties of :ref:`Page` objects :attr:`Page.MediaBoxSize` and " ":attr:`Page.CropBoxPosition` provide more information about a page's " "dimensions. For non-PDF files (and for most PDF files, too) these will be" " equal to :attr:`Page.rect.bottom_right`, resp. " ":attr:`Page.rect.top_left`. For example, class :ref:`Shape` makes use of " "them to correctly position its items." msgstr "" #: ../../../changes.txt:2630 74d15ecb1b914538a684a22683984be7 msgid "**Changes in Version 1.12.0**" msgstr "" #: ../../../changes.txt:2632 ac50d19ead2044d4afef9637fadb68d5 msgid "" "This version is based on and requires MuPDF v1.12.0. The new MuPDF " "version contains quite a number of changes -- most of them around text " "extraction. Some of the changes impact the programmer's API." msgstr "" #: ../../../changes.txt:2634 1b465153b5814abe8ed0d412684e1e54 msgid "" ":meth:`Outline.saveText` and :meth:`Outline.saveXML` have been deleted " "without replacement. You probably haven't used them much anyway. But if " "you are looking for a replacement: the output of :meth:`Document.get_toc`" " can easily be used to produce something equivalent." msgstr "" #: ../../../changes.txt:2636 b2b48a42c44c4a1dab5f5c66edaf406a msgid "Class *TextSheet* does no longer exist." msgstr "" #: ../../../changes.txt:2638 f6faca5ccc3b4ddab529d2c73f600396 msgid "" "Text \"spans\" (one of the hierarchy levels of :ref:`TextPage`) no longer" " contain positioning information (i.e. no \"bbox\" key). Instead, spans " "now provide the font information for its text. This impacts our JSON " "output variant." msgstr "" #: ../../../changes.txt:2640 cc737a16a9114bea9f2892a3d611d32f msgid "" "HTML output has improved very much: it now creates valid documents which " "can be displayed by browsers to produce a similar view as the original " "document." msgstr "" #: ../../../changes.txt:2642 88630dce5a784283a7c487d4fd39dfe4 msgid "" "There is a new output format XHTML, which provides text and images in a " "browser-readable format. The difference to HTML output is, that no effort" " is made to reproduce the original layout." msgstr "" #: ../../../changes.txt:2644 3af5ba7ff439426696f0f07a23e1d8fa msgid "" "All output formats of :meth:`Page.getText` now support creating complete," " valid documents, by wrapping them with appropriate header and trailer " "information. If you are interested in using the HTML output, please make " "sure to read :ref:`HTMLQuality`." msgstr "" #: ../../../changes.txt:2646 87e42d9c77a54890af57f976c5071ba7 msgid "" "To support finding text positions, we have added special methods that " "don't need detours like :meth:`TextPage.extractJSON` or " ":meth:`TextPage.extractXML`: use :meth:`Page.getTextBlocks` or resp. " ":meth:`Page.getTextWords` to create lists of text blocks or resp. words, " "which are accompanied by their rectangles. This should be much faster " "than the standard text extraction methods and also avoids using " "additional packages for interpreting their output." msgstr "" #: ../../../changes.txt:2651 239ae39492b748df849ea403ef2108f0 msgid "**Changes in Version 1.11.2**" msgstr "" #: ../../../changes.txt:2653 2c6897b2b1734812a1b0c402d1ba8907 msgid "This is an extension of v1.11.1." msgstr "" #: ../../../changes.txt:2655 b024b8bd2f954e69a9f3a58c001cc2d8 msgid "" "New :meth:`Page.insertFont` creates a PDF */Font* object and returns its " "object number." msgstr "" #: ../../../changes.txt:2657 17bf32eed08e4af7a9235c26da714f4c msgid "" "New :meth:`Document.extractFont` extracts the content of an embedded font" " given its object number." msgstr "" #: ../../../changes.txt:2659 8a06bf9858264b8aaddd5dcc4b335cca msgid "" "Methods **FontList(...)** items no longer contain the PDF generation " "number. This value never had any significance. Instead, the font file " "extension is included (e.g. \"pfa\" for a \"PostScript Font for ASCII\")," " which is more valuable information." msgstr "" #: ../../../changes.txt:2661 f45d17bd4282467ca8855a3a25ae091d msgid "Fonts other than \"simple fonts\" (Type1) are now also supported." msgstr "" #: ../../../changes.txt:2663 18c58364a89d48b6aa981d0c901c91ea msgid "New options to change :ref:`Pixmap` size:" msgstr "" #: ../../../changes.txt:2665 399900b7d04b4cda9bdb0645844fa951 msgid "Method :meth:`Pixmap.shrink` reduces the pixmap proportionally in place." msgstr "" #: ../../../changes.txt:2667 3c624215a18b4ee5acf3b3f95f7d3b8f msgid "" "A new :ref:`Pixmap` copy constructor allows scaling via setting target " "width and height." msgstr "" #: ../../../changes.txt:2672 787726e4ea8e4f998d5c45f15750e062 msgid "**Changes in Version 1.11.1**" msgstr "" #: ../../../changes.txt:2674 3f97c63d1ab042b0938270157fe47048 msgid "This is an extension of v1.11.0." msgstr "" #: ../../../changes.txt:2676 51d6f21f07544106b1652c72ebc2ffe2 msgid "" "New class *Shape*. It facilitates and extends the creation of image " "shapes on PDF pages. It contains multiple methods for creating elementary" " shapes like lines, rectangles or circles, which can be combined into " "more complex ones and be given common properties like line width or " "colors. Combined shapes are handled as a unit and e.g. be \"morphed\" " "together. The class can accumulate multiple complex shapes and put them " "all in the page's foreground or background -- thus also reducing the " "number of updates to the page's :data:`contents` object." msgstr "" #: ../../../changes.txt:2678 2d4cfa604e58468ea1577f10209e6280 msgid "All *Page* draw methods now use the new *Shape* class." msgstr "" #: ../../../changes.txt:2680 fc7ba2646c3448c297ae41f9fadeda05 msgid "" "Text insertion methods *insertText()* and *insertTextBox()* now support " "morphing in addition to text rotation. They have become part of the " "*Shape* class and thus allow text to be freely combined with graphics." msgstr "" #: ../../../changes.txt:2682 737fb07ba7c242ff9478cdcd66f9c5ec msgid "" "A new *Pixmap* constructor allows creating pixmap copies with an added " "alpha channel. A new method also allows directly manipulating alpha " "values." msgstr "" #: ../../../changes.txt:2684 8ce597ee78ed4486bbf604c79de4b733 msgid "" "Binary algebraic operations with geometry objects (matrices, rectangles " "and points) now generally also support lists or tuples as the second " "operand. You can add a tuple *(x, y)* of numbers to a :ref:`Point`. In " "this context, such sequences are called \":data:`point_like`\" (resp. " ":data:`matrix_like`, :data:`rect_like`)." msgstr "" #: ../../../changes.txt:2686 5788fb7d7f784ac09ae37611ece715fa msgid "" "Geometry objects now fully support in-place operators. For example, *p /=" " m* replaces point p with *p * 1/m* for a number, or *p * ~m* for a " ":data:`matrix_like` object *m*. Similarly, if *r* is a rectangle, then *r" " |= (3, 4)* is the new rectangle that also includes *fitz.Point(3, 4)*, " "and *r &= (1, 2, 3, 4)* is its intersection with *fitz.Rect(1, 2, 3, 4)*." msgstr "" #: ../../../changes.txt:2690 34897b5e1f8042e392f5a46fcd148809 msgid "**Changes in Version 1.11.0**" msgstr "" #: ../../../changes.txt:2692 d292bd8392b648e4a31cef92ae09f8b5 msgid "This version is based on and requires MuPDF v1.11." msgstr "" #: ../../../changes.txt:2694 6de44e4ec25b476cb9fc163cdece9c5f msgid "" "Though MuPDF has declared it as being mostly a bug fix version, one major" " new feature is indeed contained: support of embedded files -- also " "called portfolios or collections. We have extended PyMuPDF functionality " "to embrace this up to an extent just a little beyond the *mutool* utility" " as follows." msgstr "" #: ../../../changes.txt:2696 3f70b50c029542ff87e1112b28bb11f5 msgid "" "The *Document* class now support embedded files with several new methods " "and one new property:" msgstr "" #: ../../../changes.txt:2698 1922650fdba747cd960cf08984a60150 msgid "" "*embfile_Info()* returns metadata information about an entry in the list " "of embedded files. This is more than *mutool* currently provides: it " "shows all the information that was used to embed the file (not just the " "entry's name)." msgstr "" #: ../../../changes.txt:2699 3a1e2417a0dd47e985c0fd31c45e52fa msgid "" "*embfile_Get()* retrieves the (decompressed) content of an entry into a " "*bytes* buffer." msgstr "" #: ../../../changes.txt:2700 9c68f32b3ab04c2ba2849db67d9b5edc msgid "" "*embfile_Add(...)* inserts new content into the PDF portfolio. We (in " "contrast to *mutool*) **restrict** this to entries with a **new name** " "(no duplicate names allowed)." msgstr "" #: ../../../changes.txt:2701 274f3e1bbceb4acfb7ceb07d7a164afb msgid "" "*embfile_Del(...)* deletes an entry from the portfolio (function not " "offered in MuPDF)." msgstr "" #: ../../../changes.txt:2702 0a75c5b044d54d62b32f6e6a9c1bb143 msgid "" "*embfile_SetInfo()* -- changes filename or description of an embedded " "file." msgstr "" #: ../../../changes.txt:2703 f80bb0230db84d0fb5d130853430ffb0 msgid "*embfile_Count* -- contains the number of embedded files." msgstr "" #: ../../../changes.txt:2705 5474da97a2ee44f59d0e2fd58ad55665 msgid "" "Several enhancements deal with streamlining geometry objects. These are " "not connected to the new MuPDF version and most of them are also " "reflected in PyMuPDF v1.10.0. Among them are new properties to identify " "the corners of rectangles by name (e.g. *Rect.bottom_right*) and new " "methods to deal with set-theoretic questions like *Rect.contains(x)* or " "*IRect.intersects(x)*. Special effort focussed on supporting more " "\"Pythonic\" language constructs: *if x in rect ...* is equivalent to " "*rect.contains(x)*." msgstr "" #: ../../../changes.txt:2707 2a7db4a61ce24c848f83c0863bad09b7 msgid "" "The :ref:`Rect` chapter now has more background on empty amd infinite " "rectangles and how we handle them. The handling itself was also updated " "for more consistency in this area." msgstr "" #: ../../../changes.txt:2709 33aee8dea574413681caf242adf8da6a msgid "We have started basic support for **generation** of PDF content:" msgstr "" #: ../../../changes.txt:2711 deb4a2603a53455cb82d849ad34308aa msgid "" "*Document.insert_page()* adds a new page into a PDF, optionally " "containing some text." msgstr "" #: ../../../changes.txt:2712 f7497c0e1764493a945c64046add98a1 msgid "*Page.insertImage()* places a new image on a PDF page." msgstr "" #: ../../../changes.txt:2713 59797715081c4303a9d023f624eeda19 msgid "*Page.insertText()* puts new text on an existing page" msgstr "" #: ../../../changes.txt:2715 1e1119160b9b47b6838fe3a16078aabc msgid "" "For **FileAttachment** annotations, content and name of the attached file" " can extracted and changed." msgstr "" #: ../../../changes.txt:2719 b6b1a71f6e9c4006ad908aca83e94958 msgid "**Changes in Version 1.10.0**" msgstr "" #: ../../../changes.txt:2721 2d15107ed72748df88b1f193e0590a28 msgid "**MuPDF v1.10 Impact**" msgstr "" #: ../../../changes.txt:2723 bcefb5c4e9884f03a30f600abedbeb81 msgid "" "MuPDF version 1.10 has a significant impact on our bindings. Some of the " "changes also affect the API -- in other words, **you** as a PyMuPDF user." msgstr "" #: ../../../changes.txt:2725 50ef82a6f0904d01b9d131853ef968fe msgid "" "Link destination information has been reduced. Several properties of the " "*linkDest* class no longer contain valuable information. In fact, this " "class as a whole has been deleted from MuPDF's library and we in PyMuPDF " "only maintain it to provide compatibilty to existing code." msgstr "" #: ../../../changes.txt:2727 e0f444dd42e048608c890061f2205bab msgid "" "In an effort to minimize memory requirements, several improvements have " "been built into MuPDF v1.10:" msgstr "" #: ../../../changes.txt:2729 dd57640466d6465693ecfa9e6153edb1 msgid "" "A new *config.h* file can be used to de-select unwanted features in the C" " base code. Using this feature we have been able to reduce the size of " "our binary *_fitz.o* / *_fitz.pyd* by about 50% (from 9 MB to 4.5 MB). " "When UPX-ing this, the size goes even further down to a very handy 2.3 " "MB." msgstr "" #: ../../../changes.txt:2731 42d66398d41a44a099a22715ab110b6a msgid "" "The alpha (transparency) channel for pixmaps is now optional. Letting " "alpha default to *False* significantly reduces pixmap sizes (by 20% -- " "CMYK, 25% -- RGB, 50% -- GRAY). Many *Pixmap* constructors therefore now " "accept an *alpha* boolean to control inclusion of this channel. Other " "pixmap constructors (e.g. those for file and image input) create pixmaps " "with no alpha alltogether. On the downside, save methods for pixmaps no " "longer accept a *savealpha* option: this channel will always be saved " "when present. To minimize code breaks, we have left this parameter in the" " call patterns -- it will just be ignored." msgstr "" #: ../../../changes.txt:2733 58b3832200ca448a9f2942f1ec5f30d9 msgid "" "*DisplayList* and *TextPage* class constructors now **require the " "mediabox** of the page they are referring to (i.e. the *page.bound()* " "rectangle). There is no way to construct this information from other " "sources, therefore a source code change cannot be avoided in these cases." " We assume however, that not many users are actually employing these " "rather low level classes explixitely. So the impact of that change should" " be minor." msgstr "" #: ../../../changes.txt:2735 01de368016c141b1b2553cd585883f58 msgid "**Other Changes compared to Version 1.9.3**" msgstr "" #: ../../../changes.txt:2737 df26434942574d7da8fc1befaf6d049e msgid "" "The new :ref:`Document` method *write()* writes an opened PDF to memory " "(as opposed to a file, like *save()* does)." msgstr "" #: ../../../changes.txt:2738 5190f090e6f84628be18a2e1c9fd43df msgid "" "An annotation can now be scaled and moved around on its page. This is " "done by modifying its rectangle." msgstr "" #: ../../../changes.txt:2739 0eb2ec9314ee488196226314519b9129 msgid "" "Annotations can now be deleted. :ref:`Page` contains the new method " "*deleteAnnot()*." msgstr "" #: ../../../changes.txt:2740 99724b99bd0548eaa19c8c85f41c3b21 msgid "" "Various annotation attributes can now be modified, e.g. content, dates, " "title (= author), border, colors." msgstr "" #: ../../../changes.txt:2741 d958d6b52dd140669174995b9aa48a2c msgid "" "Method *Document.insert_pdf()* now also copies annotations of source " "pages." msgstr "" #: ../../../changes.txt:2742 a77b60cbc9834c8885e873395b2e5293 msgid "" "The *Pages* class has been deleted. As documents can now be accessed with" " page numbers as indices (like *doc[n] = doc.loadPage(n)*), and document " "object can be used as iterators, the benefit of this class was too low to" " maintain it. See the following comments." msgstr "" #: ../../../changes.txt:2743 8310daf4e1854f8d93f3fccbab7b350f msgid "" "*loadPage(n)* / *doc[n]* now accept arbitrary integers to specify a page " "number, as long as *n < pageCount*. So, e.g. *doc[-500]* is always valid " "and will load page *(-500) % pageCount*." msgstr "" #: ../../../changes.txt:2744 1204cbb1b1c544fb9e21c114bb1d1ba0 msgid "" "A document can now also be used as an iterator like this: *for page in " "doc: ... ...*. This will yield all pages of " "*doc* as *page*." msgstr "" #: ../../../changes.txt:2745 638b89cc45b748c1871ca2d5aead5130 msgid "" "The :ref:`Pixmap` method *getSize()* has been replaced with property " "*size*. As before *Pixmap.size == len(Pixmap)* is true." msgstr "" #: ../../../changes.txt:2746 08362ae590bb4f6d909e17c344eac186 msgid "" "In response to transparency (alpha) being optional, several new " "parameters and properties have been added to :ref:`Pixmap` and " ":ref:`Colorspace` classes to support determining their characteristics." msgstr "" #: ../../../changes.txt:2747 26af3ec444444862b651b0a46668621b msgid "" "The :ref:`Page` class now contains new properties *firstAnnot* and " "*firstLink* to provide starting points to the respective class chains, " "where *firstLink* is just a mnemonic synonym to method *loadLinks()* " "which continues to exist. Similarly, the new property *rect* is a synonym" " for method *bound()*, which also continues to exist." msgstr "" #: ../../../changes.txt:2748 ded24a5038154723bb3341c82e3cbf85 msgid "" ":ref:`Pixmap` methods *samplesRGB()* and *samplesAlpha()* have been " "deleted because pixmaps can now be created without transparency." msgstr "" #: ../../../changes.txt:2749 0f12d21dba014e89b8c28b88440ddf0d msgid "" ":ref:`Rect` now has a property *irect* which is a synonym of method " "*round()*. Likewise, :ref:`IRect` now has property *rect* to deliver a " ":ref:`Rect` which has the same coordinates as floats values." msgstr "" #: ../../../changes.txt:2750 30d1287837f24dc3b01d070c0235a6b3 msgid "" "Document has the new method *searchPageFor()* to search for a text " "string. It works exactly like the corresponding *Page.searchFor()* with " "page number as additional parameter." msgstr "" #: ../../../changes.txt:2755 efde2cd3f108453c92668ab6680d8c22 msgid "**Changes in Version 1.9.3**" msgstr "" #: ../../../changes.txt:2757 0ea28511a44f47cbabd5e1818b9aa8aa msgid "" "This version is also based on MuPDF v1.9a. Changes compared to version " "1.9.2:" msgstr "" #: ../../../changes.txt:2759 4e290039221648db96c98c392772b446 msgid "" "As a major enhancement, annotations are now supported in a similar way as" " links. Annotations can be displayed (as pixmaps) and their properties " "can be accessed." msgstr "" #: ../../../changes.txt:2760 9b2336cd5062432881d29cf06440709d msgid "" "In addition to the document *select()* method, some simpler methods can " "now be used to manipulate a PDF:" msgstr "" #: ../../../changes.txt:2762 8d2322bb4a7d4981a30ae2ec5a2cbdb0 msgid "*copyPage()* copies a page within a document." msgstr "" #: ../../../changes.txt:2763 b7683db8abd54cb09161d5edf19f4bd3 msgid "*movePage()* is similar, but deletes the original." msgstr "" #: ../../../changes.txt:2764 a4c469e758a1452bb9ab330b06d00638 msgid "*delete_page()* deletes a page" msgstr "" #: ../../../changes.txt:2765 edfd6b26956f4fbfbe96ae5f0b82abd1 msgid "*delete_pages()* deletes a page range" msgstr "" #: ../../../changes.txt:2767 39a894ab055d4710b6bd443c6df69890 msgid "" "*rotation* or *setRotation()* access or change a PDF page's rotation, " "respectively." msgstr "" #: ../../../changes.txt:2768 4c32f65b4b694d6bb428aa23ca44e50a msgid "" "Available but undocumented before, :ref:`IRect`, :ref:`Rect`, " ":ref:`Point` and :ref:`Matrix` support the *len()* method and their " "coordinate properties can be accessed via indices, e.g. *IRect.x1 == " "IRect[2]*." msgstr "" #: ../../../changes.txt:2769 f60011476e35442c8866a3831c378b54 msgid "" "For convenience, documents now support simple indexing: *doc.loadPage(n) " "== doc[n]*. The index may however be in range *-pageCount < n < " "pageCount*, such that *doc[-1]* is the last page of the document." msgstr "" #: ../../../changes.txt:2773 b923307f30254e48ba8f3dfb4835b05a msgid "**Changes in Version 1.9.2**" msgstr "" #: ../../../changes.txt:2775 6449dd561a1d46078eff4b1c6983b1ae msgid "" "This version is also based on MuPDF v1.9a. Changes compared to version " "1.9.1:" msgstr "" #: ../../../changes.txt:2777 f9a699d3f70e4d6caed1fb3017bf1f0b msgid "" "*fitz.open()* (no parameters) creates a new empty **PDF** document, i.e. " "if saved afterwards, it must be given a *.pdf* extension." msgstr "" #: ../../../changes.txt:2778 6d6ed72ba57c49cab25dd46b125a7992 msgid "" ":ref:`Document` now accepts all of the following formats (*Document* and " "*open* are synonyms):" msgstr "" #: ../../../changes.txt:2780 a3a89203f10e4adeb3cfe637ceb6fdff msgid "*open()*," msgstr "" #: ../../../changes.txt:2781 adac8cae62784b188b7532c740bb1379 msgid "*open(filename)* (equivalent to *open(filename, None)*)," msgstr "" #: ../../../changes.txt:2782 5d35476e5dcf46248458a566565f6b6f msgid "*open(filetype, area)* (equivalent to *open(filetype, stream = area)*)." msgstr "" #: ../../../changes.txt:2784 2fdc6dd492a14cc68fa4d2de4e051cfc msgid "" "Type of memory area *stream* may be *bytes* or *bytearray*. Thus, e.g. " "*area = open(\"file.pdf\", \"rb\").read()* may be used directly (without " "first converting it to bytearray)." msgstr "" #: ../../../changes.txt:2785 ad12c912ac3247a4a7c774429b01c39b msgid "" "New method *Document.insert_pdf()* (PDFs only) inserts a range of pages " "from another PDF." msgstr "" #: ../../../changes.txt:2786 93f16447ec77443ba90329b70366c78f msgid "" "*Document* objects doc now support the *len()* function: ``len(doc) == " "doc.pageCount``." msgstr "" #: ../../../changes.txt:2787 b9dfdd6106944a0ab643f64882fa6526 msgid "" "New method *Document.getPageImageList()* creates a list of images used on" " a page." msgstr "" #: ../../../changes.txt:2788 f2906fa3f14c4f93bddbe0029d43681f msgid "" "New method *Document.getPageFontList()* creates a list of fonts " "referenced by a page." msgstr "" #: ../../../changes.txt:2789 a053e3c6bd69480aa1a4639e8522af69 msgid "" "New pixmap constructor *fitz.Pixmap(doc, xref)* creates a pixmap based on" " an opened PDF document and an :data:`xref` number of the image." msgstr "" #: ../../../changes.txt:2790 9dfdd7f9d9b14e15963c179646bcbbeb msgid "" "New pixmap constructor *fitz.Pixmap(cspace, spix)* creates a pixmap as a " "copy of another one *spix* with the colorspace converted to *cspace*. " "This works for all colorspace combinations." msgstr "" #: ../../../changes.txt:2791 2a61334e5c304e09a3efe93e1daf2a53 msgid "" "Pixmap constructor *fitz.Pixmap(colorspace, width, height, samples)* now " "allows *samples* to also be *bytes*, not only *bytearray*." msgstr "" #: ../../../changes.txt:2796 b95080e967b24b66ae4b63c42d239889 msgid "**Changes in Version 1.9.1**" msgstr "" #: ../../../changes.txt:2798 9273e10701d143069e9c0424e4b6bded msgid "" "This version of PyMuPDF is based on MuPDF library source code version " "1.9a published on April 21, 2016." msgstr "" #: ../../../changes.txt:2800 517fc4042ed6446e9e7457b0f69e8504 msgid "" "Please have a look at MuPDF's website to see which changes and " "enhancements are contained herein." msgstr "" #: ../../../changes.txt:2802 c70db83bdb1d48d198e4344cae4de7b5 msgid "Changes in version 1.9.1 compared to version 1.8.0 are the following:" msgstr "" #: ../../../changes.txt:2804 0d6385d834804b7d9b0ab1c6ef0d85b8 msgid "New methods *get_area()* for both *fitz.Rect* and *fitz.IRect*" msgstr "" #: ../../../changes.txt:2805 85fda6915f8c488cb6fbe936f1ea49ab msgid "" "Pixmaps can now be created directly from files using the new constructor " "*fitz.Pixmap(filename)*." msgstr "" #: ../../../changes.txt:2806 d92fe0f7f8304a5190d37c53f89f3a24 msgid "The Pixmap constructor *fitz.Pixmap(image)* has been extended accordingly." msgstr "" #: ../../../changes.txt:2807 cdaceee4b768492e9110c3d0cd75e175 msgid "" "*fitz.Rect* can now be created with all possible combinations of points " "and coordinates." msgstr "" #: ../../../changes.txt:2808 03f45a90666540d8b5cb4c257457b006 msgid "" "PyMuPDF classes and methods now all contain __doc__ strings, most of " "them created by SWIG automatically. While the PyMuPDF documentation " "certainly is more detailed, this feature should help a lot when " "programming in Python-aware IDEs." msgstr "" #: ../../../changes.txt:2809 2ddafe376f5e4f4e9ac5c3db523eea26 msgid "" "A new document method of *getPermits()* returns the permissions " "associated with the current access to the document (print, edit, " "annotate, copy), as a Python dictionary." msgstr "" #: ../../../changes.txt:2810 38dbe8d276f348d6b76c6d0a15d0676f msgid "The identity matrix *fitz.Identity* is now **immutable**." msgstr "" #: ../../../changes.txt:2811 fa0425c7b7b04f0bb7c04eec634e2756 msgid "" "The new document method *select(list)* removes all pages from a document " "that are not contained in the list. Pages can also be duplicated and re-" "arranged." msgstr "" #: ../../../changes.txt:2812 3c561ea70df341be88b491b64dc6f313 msgid "" "Various improvements and new members in our demo and examples " "collections. Perhaps most prominently: *PDF_display* now supports " "scrolling with the mouse wheel, and there is a new example program " "*wxTableExtract* which allows to graphically identify and extract table " "data in documents." msgstr "" #: ../../../changes.txt:2813 4d9bea8a8e514d67958c633b66ca31fb msgid "*fitz.open()* is now an alias of *fitz.Document()*." msgstr "" #: ../../../changes.txt:2814 f62c2e04dea346d0a23964798a6150e8 msgid "" "New pixmap method *tobytes()* which will return a bytearray formatted as " "a PNG image of the pixmap." msgstr "" #: ../../../changes.txt:2815 691532d03793437899a4b59421388b4c msgid "" "New pixmap method *samplesRGB()* providing a *samples* version with alpha" " bytes stripped off (RGB colorspaces only)." msgstr "" #: ../../../changes.txt:2816 2780806eef3f43b28a7e9601a270e9f2 msgid "" "New pixmap method *samplesAlpha()* providing the alpha bytes only of the " "*samples* area." msgstr "" #: ../../../changes.txt:2817 21fbef3bc0e64a59a9a9b9f5005063e8 msgid "New iterator *fitz.Pages(doc)* over a document's set of pages." msgstr "" #: ../../../changes.txt:2818 707a5edabf3e4c3cbb66ed5d280d40ae msgid "" "New matrix methods *invert()* (calculate inverted matrix), *concat()* " "(calculate matrix product), *pretranslate()* (perform a shift operation)." msgstr "" #: ../../../changes.txt:2819 cc8cea5eaf77474aa84e90031d6f3318 msgid "" "New *IRect* methods *intersect()* (intersection with another rectangle), " "*translate()* (perform a shift operation)." msgstr "" #: ../../../changes.txt:2820 893b259908084462b3a1a85629a6ee06 msgid "" "New *Rect* methods *intersect()* (intersection with another rectangle), " "*transform()* (transformation with a matrix), *include_point()* (enlarge " "rectangle to also contain a point), *include_rect()* (enlarge rectangle " "to also contain another one)." msgstr "" #: ../../../changes.txt:2821 21838e58f15b4457816e55450382ccb9 msgid "Documented *Point.transform()* (transform a point with a matrix)." msgstr "" #: ../../../changes.txt:2822 3f2842cba4c044eb99d8d250d9f84740 msgid "" "*Matrix*, *IRect*, *Rect* and *Point* classes now support compact, " "algebraic formulations for manipulating such objects." msgstr "" #: ../../../changes.txt:2823 bb13c21e58c14cf59f36e99322166ac4 msgid "" "Incremental saves for changes are possible now using the call pattern " "*doc.save(doc.name, incremental=True)*." msgstr "" #: ../../../changes.txt:2824 34093067a0274622aa66ca0e40f20da0 msgid "" "A PDF's metadata can now be deleted, set or changed by document method " "*set_metadata()*. Supports incremental saves." msgstr "" #: ../../../changes.txt:2825 0e2f9f83f2244178a0772a7f0de76b0d msgid "" "A PDF's bookmarks (or table of contents) can now be deleted, set or " "changed with the entries of a list using document method *set_toc(list)*." " Supports incremental saves." msgstr "" #: ../../footer.rst:46 0555f8605d724eadbe65f9eb27755b4f msgid "This documentation covers all versions up to |version|." msgstr "" #~ msgid "**Changes in version 1.23.0rc1 (2023-08-10)**" #~ msgstr "" #~ msgid "Contains a new \"rebased\" implementation of PyMuPDF." #~ msgstr "" #~ msgid "" #~ "**Fixed** `#2542 " #~ "`_: " #~ "fritz.utils.scrub AttributeError Annot object " #~ "has no attribute fileUpd inside" #~ msgstr "" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "Other: * Use MuPDF-1.23.4. * Fix " #~ "optimisation flags with system installs. " #~ "* Fixed the problem that the clip" #~ " parameter does not take effect " #~ "during table recognition * Support " #~ "Pillow mode \"RGBa\" * Support extra " #~ "word delimiters * Support checking valid" #~ " PDF name objects" #~ msgstr "" #~ msgid "**Changes in version 1.24.3 (2024-04-xx)**" #~ msgstr "" #~ msgid "" #~ "**Fixed** `3180 " #~ "`_: Cannot " #~ "show optional content group: AttributeError:" #~ " module 'pymupdf.mupdf' has no attribute" #~ " 'pdf_array_push_drop'" #~ msgstr "" #~ msgid "" #~ "**Fixed** `3163 " #~ "`_: " #~ "AssertionError on using pymupdf.IRect" #~ msgstr "" #~ msgid "" #~ "**Fixed** `3177 " #~ "`_: " #~ "pymupdf.Pixmap(None, pix) Unrecognised args " #~ "for constructing Pixmap" #~ msgstr "" #~ msgid "" #~ "**Fixed** `2978 " #~ "`_: 1.23.9rc1:" #~ " module 'pymupdf.mupdf' has no attribute" #~ " 'fz_copy_pixmap_rect'" #~ msgstr "" #~ msgid "" #~ "Fixed rebased `pymupdf.pymupdf_version_tuple` - " #~ "was previously set to mupdf version." #~ msgstr "" #~ msgid "" #~ "Added test for `pymupdf.css_for_pymupdf_font()` " #~ "(uses package `pymupdf-fonts`)." #~ msgstr "" #~ msgid "Added `pymupdf.pymupdf_version_tuple`, e.g. `(1, 23, 6)`." #~ msgstr "" #~ msgid "" #~ "**Fixed** `2548 " #~ "`_: Fitz " #~ "freezes on some PDFs when calling " #~ "the pymupdf.Page.get_text_blocks method." #~ msgstr "" #~ msgid "" #~ "**Fixed** `#2542 " #~ "`_: " #~ "pymupdf.utils.scrub AttributeError Annot object " #~ "has no attribute fileUpd inside" #~ msgstr "" #~ msgid "" #~ "**Fixed** `#2290 " #~ "`_: Different" #~ " image format/data from Page.get_text(\"dict\")" #~ " and pymupdf.get_page_images()" #~ msgstr "" #~ msgid "" #~ "Fixed issue where trace devices' state" #~ " was not being initialised correctly; " #~ "data returned from things like " #~ "``pymupdf.Page.get_texttrace()`` might be slightly" #~ " altered, e.g. ``linewidth`` values." #~ msgstr "" #~ msgid "" #~ "**Fixed** `#2076 " #~ "`_: Segfault " #~ "in pymupdf.py" #~ msgstr "" #~ msgid "" #~ "``EmptyFileError`` -- raised when trying " #~ "to create a :ref:`Document` " #~ "(``pymupdf.open()``) from an empty file " #~ "or zero-length memory." #~ msgstr "" #~ msgid "" #~ "**Fixed** issue `#1085 " #~ "`_. The " #~ "old *snake_cased* alias of " #~ "``pymupdf.detTextlength`` is now defined " #~ "correctly." #~ msgstr "" #~ msgid "" #~ "**Added** a method :meth:`paper_rect` which" #~ " returns a :ref:`Rect` for a supplied" #~ " paper format string. Example: " #~ "*pymupdf.paper_rect(\"letter\") = pymupdf.Rect(0.0, " #~ "0.0, 612.0, 792.0)*." #~ msgstr "" #~ msgid "" #~ "Geometry objects now fully support " #~ "in-place operators. For example, *p " #~ "/= m* replaces point p with *p " #~ "* 1/m* for a number, or *p *" #~ " ~m* for a :data:`matrix_like` object " #~ "*m*. Similarly, if *r* is a " #~ "rectangle, then *r |= (3, 4)* is" #~ " the new rectangle that also includes" #~ " *pymupdf.Point(3, 4)*, and *r &= (1," #~ " 2, 3, 4)* is its intersection " #~ "with *pymupdf.Rect(1, 2, 3, 4)*." #~ msgstr "" #~ msgid "" #~ "A new *config.h* file can be used" #~ " to de-select unwanted features in" #~ " the C base code. Using this " #~ "feature we have been able to " #~ "reduce the size of our binary " #~ "*_pymupdf.o* / *_pymupdf.pyd* by about " #~ "50% (from 9 MB to 4.5 MB). " #~ "When UPX-ing this, the size goes" #~ " even further down to a very " #~ "handy 2.3 MB." #~ msgstr "" #~ msgid "" #~ "*pymupdf.open()* (no parameters) creates a " #~ "new empty |PDF| document, i.e. if " #~ "saved afterwards, it must be given " #~ "a *.pdf* extension." #~ msgstr "" #~ msgid "" #~ "New pixmap constructor *pymupdf.Pixmap(doc, " #~ "xref)* creates a pixmap based on " #~ "an opened PDF document and an " #~ ":data:`xref` number of the image." #~ msgstr "" #~ msgid "" #~ "New pixmap constructor *pymupdf.Pixmap(cspace, " #~ "spix)* creates a pixmap as a copy" #~ " of another one *spix* with the " #~ "colorspace converted to *cspace*. This " #~ "works for all colorspace combinations." #~ msgstr "" #~ msgid "" #~ "Pixmap constructor *pymupdf.Pixmap(colorspace, " #~ "width, height, samples)* now allows " #~ "*samples* to also be *bytes*, not " #~ "only *bytearray*." #~ msgstr "" #~ msgid "New methods *get_area()* for both *pymupdf.Rect* and *pymupdf.IRect*" #~ msgstr "" #~ msgid "" #~ "Pixmaps can now be created directly " #~ "from files using the new constructor " #~ "*pymupdf.Pixmap(filename)*." #~ msgstr "" #~ msgid "" #~ "The Pixmap constructor *pymupdf.Pixmap(image)* " #~ "has been extended accordingly." #~ msgstr "" #~ msgid "" #~ "*pymupdf.Rect* can now be created with" #~ " all possible combinations of points " #~ "and coordinates." #~ msgstr "" #~ msgid "The identity matrix *pymupdf.Identity* is now **immutable**." #~ msgstr "" #~ msgid "*pymupdf.open()* is now an alias of *pymupdf.Document()*." #~ msgstr "" #~ msgid "New iterator *pymupdf.Pages(doc)* over a document's set of pages." #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "**Changed** :ref:`TextWriter` output to also" #~ " accept text in right to left " #~ "mode (Arabian, Hebrew): " #~ ":meth:`TextWriter.fill_textbox`, :meth:`TextWriter.append`. " #~ "These methods now accept a new " #~ "boolean parameter `right_to_left`, which is" #~ " ``False`` by default. Implements `#897 " #~ "`_." #~ msgstr "" #~ msgid "" #~ "**Added** option ``text_as_path`` to " #~ ":meth:`Page.getSVGimage`. this implements `#580 " #~ "`_. Generates " #~ "much smaller SVG files with parseable" #~ " text if set to ``False``." #~ msgstr "" #~ msgid "" #~ "**Fixed** issue `#559 " #~ "`_. This " #~ "|MuPDF| bug is being temporarily fixed" #~ " with a pre-version of MuPDF's " #~ "next release." #~ msgstr "" #~ msgid "" #~ "**Changed** :attr:`Document.is_form_pdf` to now " #~ "contain the number of widgets, and " #~ "``False`` if not a PDF or this " #~ "number is zero." #~ msgstr "" #~ msgid "" #~ "**Changed** method :meth:`Document._getXrefStream` " #~ "to now return ``None`` if the " #~ "object is no stream and no longer" #~ " raise an exception if otherwise." #~ msgstr "" #~ msgid "" #~ "**Changed** :meth:`Document.embfile_Del` to now " #~ "automatically delete **all entries** having" #~ " the supplied identifying name. The " #~ "return code is now an integer " #~ "count of the removed entries (was " #~ "``None`` previously)." #~ msgstr "" #~ msgid "" #~ "**Added** :attr:`Document.isDirty` which is " #~ "``True`` if a PDF has been changed" #~ " in this session. Reset to ``False``" #~ " on each :meth:`Document.save` or " #~ ":meth:`Document.write`." #~ msgstr "" #~ msgid "" #~ "Changed and extended PDF form field " #~ "support: the attribute *widget_text* has " #~ "been renamed to :attr:`Annot.widget_value`. " #~ "Values of all form field types " #~ "(except signatures) are now supported. A" #~ " new attribute :attr:`Annot.widget_choices` " #~ "contains the selectable values of " #~ "listboxes and comboboxes. All these " #~ "attributes now contain ``None`` if no" #~ " value is present." #~ msgstr "" #~ msgid "" #~ "Many functions now return ``None`` " #~ "instead of *0*, if the result has" #~ " no other meaning than just " #~ "indicating successful execution " #~ "(:meth:`Document.close`, :meth:`Document.save`, " #~ ":meth:`Document.select`, :meth:`Pixmap.save` and " #~ "many others)." #~ msgstr "" #~ msgid "" #~ "A new ``Pixmap`` constructor allows " #~ "creating pixmap copies with an added " #~ "alpha channel. A new method also " #~ "allows directly manipulating alpha values." #~ msgstr "" #~ msgid "" #~ "The alpha (transparency) channel for " #~ "pixmaps is now optional. Letting alpha" #~ " default to ``False`` significantly reduces" #~ " pixmap sizes (by 20% -- CMYK, " #~ "25% -- RGB, 50% -- GRAY). Many " #~ "``Pixmap`` constructors therefore now accept" #~ " an *alpha* boolean to control " #~ "inclusion of this channel. Other pixmap" #~ " constructors (e.g. those for file " #~ "and image input) create pixmaps with " #~ "no alpha alltogether. On the downside," #~ " save methods for pixmaps no longer" #~ " accept a *savealpha* option: this " #~ "channel will always be saved when " #~ "present. To minimize code breaks, we " #~ "have left this parameter in the " #~ "call patterns -- it will just be" #~ " ignored." #~ msgstr "" #~ msgid "" #~ "``DisplayList`` and ``TextPage`` class " #~ "constructors now **require the mediabox** " #~ "of the page they are referring to" #~ " (i.e. the *page.bound()* rectangle). There" #~ " is no way to construct this " #~ "information from other sources, therefore " #~ "a source code change cannot be " #~ "avoided in these cases. We assume " #~ "however, that not many users are " #~ "actually employing these rather low " #~ "level classes explixitely. So the impact" #~ " of that change should be minor." #~ msgstr "" #~ msgid "" #~ "*fitz.open()* (no parameters) creates a " #~ "new empty |PDF| document, i.e. if " #~ "saved afterwards, it must be given " #~ "a *.pdf* extension." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/classes.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 2a3afd4ee887482197b760f562ffccc4 msgid "Artifex" msgstr "" #: ../../header.rst:-1 88c2fb74c3264e88ab5b351998d6487c msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 704d5cb7888e4240b2b40aab099a2c07 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../classes.rst:5 7c00ecb7e10b4a23a407ab80742606b5 msgid "Classes" msgstr "" #: ../../footer.rst:60 3cc655b31f5a4c8c856c90f57dbc49cf msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/colors.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 35fb650a253a4f3b8498a5be6524cf11 msgid "Artifex" msgstr "" #: ../../header.rst:-1 82dc5bc568734b99a2d2f57e0a4da5d0 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 546a16c6fc534b38a0db66fe761c1c61 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../colors.rst:7 248d0e17c78b4f6fa1b57235e07bb572 msgid "Color Database" msgstr "カラーデータベース" #: ../../colors.rst:8 866762e2283b43a5a605f529de6310df msgid "" "Since the introduction of methods involving colors (like " ":meth:`Page.draw_circle`), a requirement may be to have access to " "predefined colors." msgstr "" ":meth:`Page.draw_circle`) " "のような色を含むメソッドが導入されて以来、事前定義された色にアクセスする必要があるかもしれません。）" #: ../../colors.rst:10 03afc088d6e34acc9076fc34915e9064 msgid "" "The fabulous GUI package `wxPython `_ has a " "database of over 540 predefined RGB colors, which are given more or less " "memorizable names. Among them are not only standard names like \"green\" " "or \"blue\", but also \"turquoise\", \"skyblue\", and 100 (not only 50 " "...) shades of \"gray\", etc." msgstr "" "素晴らしいGUIパッケージ `wxPython `_ " "には、記憶しやすい名前が与えられた540以上の事前定義されたRGBカラーのデータベースがあります。その中には「green」や「blue」のような標準的な名前だけでなく、「turquoise」や「skyblue」、「gray」の100のシェードなどが含まれています（50だけでなく…）。" #: ../../colors.rst:12 7ff92a944ea44490b292556c69b2273b msgid "" "We have taken the liberty to copy this database (a list of tuples) " "modified into PyMuPDF and make its colors available as PDF compatible " "float triples: for wxPython's *(\"WHITE\", 255, 255, 255)* we return *(1," " 1, 1)*, which can be directly used in *color* and *fill* parameters. We " "also accept any mixed case of \"wHiTe\" to find a color." msgstr "" "私たちは、このデータベース（タプルのリスト）をPyMuPDFにコピーし、その色をPDF互換の浮動小数点トリプルとして利用可能にしました。例えば、wxPythonの(\"WHITE\"," " 255, 255, 255)は(1, 1, 1)として返され、これは *直接色* や *塗りつぶし* " "のパラメータとして使用できます。また、「wHiTe」といった大小文字の組み合わせも受け入れます。" #: ../../colors.rst:15 e54f7361ac594e49854f711406c08592 msgid "Function *getColor()*" msgstr "関数 *getColor()* " #: ../../colors.rst:16 2f1966c2184a4746af35dea0735b144d msgid "" "As the color database may not be needed very often, one additional import" " statement seems acceptable to get access to it::" msgstr "カラーデータベースはあまり頻繁に必要ないかもしれないため、アクセスするために1つの追加のインポート文は受け入れられると思われます。" #: ../../colors.rst:41 7d1b6378ac6440948098bc91a988cb05 msgid "Printing the Color Database" msgstr "カラーデータベースの印刷" #: ../../colors.rst:42 a5973aca56984f88bf0fe7e9e3c52644 msgid "" "If you want to actually see how the many available colors look like, use " "scripts `print by RGB `_ or `print by HSV " "`_ in the examples directory. They create PDFs (already " "existing in the same directory) with all these colors. Their only " "difference is sorting order: one takes the RGB values, the other one the " "Hue-Saturation-Values as sort criteria. This is a screen print of what " "these files look like." msgstr "" "実際に利用可能な多くの色がどのように見えるかを確認したい場合は、examplesディレクトリにある `RGB印刷 " "`_ または `HSV印刷 `_ " "のスクリプトを使用してください。これらのスクリプトは、これらすべての色を含むPDFを作成します（すでに同じディレクトリに存在します）。これらのファイルはRGB値を使用するものと" "、ソート基準としてHue-Saturation-" "Valueを使用するものの2つの違いだけです。以下は、これらのファイルがどのように見えるかのスクリーンプリントです。" #: ../../footer.rst:60 d448c701ca134c668840e68d45395229 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/colorspace.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4d4488c4917748bd91bcc3dd579d4cd8 msgid "Artifex" msgstr "" #: ../../header.rst:-1 806d51d5b25e4c2dbf32c0b904cf8d32 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 7c1c6b7e76d04443adc894e153404331 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../colorspace.rst:7 9117f6e8aa1a4dc0a4d17d89aa5543d1 msgid "Colorspace" msgstr "Colorspace (カラースペース)" #: ../../colorspace.rst:9 9ff1e9e9281248fbbe713af3f44fa1a1 msgid "Represents the color space of a :ref:`Pixmap`." msgstr ":ref:`Pixmap` のカラースペースを表します。" #: ../../colorspace.rst:12 b21c879680e34acdbd48605116e91b1a msgid "**Class API**" msgstr "**クラス API** " #: ../../colorspace.rst:18 728f2df68cff450fba89dc0e2961d0fd msgid "Constructor" msgstr "コンストラクタ" #: ../../colorspace.rst 89cae8192bc741d38d655d66d7b02a2c msgid "Parameters" msgstr "パラメータ:" #: ../../colorspace.rst:20 9ca03de683124137b4c31d0d8cedbbb3 msgid "" "A number identifying the colorspace. Possible values are :data:`CS_RGB`, " ":data:`CS_GRAY` and :data:`CS_CMYK`." msgstr "" "カラースペースを識別する番号。可能な値は :data:`CS_RGB` 、:data:`CS_GRAY` 、および :data:`CS_CMYK`" " です。" #: ../../colorspace.rst:24 ee0b34b3c30b495c99bb627cad25b1df msgid "" "The name identifying the colorspace. Example: *pymupdf.csCMYK.name = " "'DeviceCMYK'*." msgstr "カラースペースを識別する名前です。例: *pymupdf.csCMYK.name = 'DeviceCMYK'* 。" #: ../../colorspace.rst 1dec254d03ca404d997d0b3d10053f1d #: 57ea4a70ca2340d6aa71a8e9824e03a8 msgid "type" msgstr "型:" #: ../../colorspace.rst:26 0a4657c57f1d49e39feed5228f4c5d25 msgid "str" msgstr "" #: ../../colorspace.rst:30 b3000e3e34554cb5b72ca9feabc9711c msgid "" "The number of bytes required to define the color of one pixel. Example: " "*pymupdf.csCMYK.n == 4*." msgstr "1ピクセルの色を定義するのに必要なバイト数です。例: *pymupdf.csCMYK.n == 4* 。" #: ../../colorspace.rst:32 09c02be8130e4c67b7e790e38c19788f msgid "int" msgstr "" #: ../../colorspace.rst:35 305216fe8af54e58abf2e1fce4d6f78a msgid "**Predefined Colorspaces**" msgstr "**事前定義済みのカラースペース** " #: ../../colorspace.rst:37 2a6d64970b50414ca57b9df4b896c7d6 msgid "" "For saving some typing effort, there exist predefined colorspace objects " "for the three available cases." msgstr "入力を簡略化するために、三つの利用可能なケースのための事前定義されたカラースペースオブジェクトが存在します。" #: ../../colorspace.rst:39 acc3013bd78b41dc8fddea9d4ee301a5 msgid ":data:`csRGB` = *pymupdf.Colorspace(pymupdf.CS_RGB)*" msgstr "" #: ../../colorspace.rst:40 5813b3b4dcbf437f8815044834076e72 msgid ":data:`csGRAY` = *pymupdf.Colorspace(pymupdf.CS_GRAY)*" msgstr "" #: ../../colorspace.rst:41 57fef72a75814b848806cf016b2c1baf msgid ":data:`csCMYK` = *pymupdf.Colorspace(pymupdf.CS_CMYK)*" msgstr "" #: ../../footer.rst:60 e39ad3f11f894208aed37df423e4558e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/converting-files.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f8990f687e0047c89745e6b15ef5f312 msgid "Artifex" msgstr "" #: ../../header.rst:-1 606c02d809cb449ab8e5df484cb2149f msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 90891c93f09445feb007b8f80d447d93 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../converting-files.rst:7 153e0c6c14bf4b8bac1dcdc565ac0f16 msgid "Converting Files" msgstr "ファイルの変換" #: ../../converting-files.rst:12 9b1bc6f3061c4fd9a084829ef7554c37 msgid "Files to PDF" msgstr "ファイルからPDFへ" #: ../../converting-files.rst:14 38d5a093dfc24e72b3627f1a2c952515 msgid "" ":ref:`Document types supported by PyMuPDF` can easily be " "converted to |PDF| by using the :meth:`Document.convert_to_pdf` method. " "This method returns a buffer of data which can then be utilized by " "|PyMuPDF| to create a new |PDF|." msgstr ":ref:`PyMuPDFでサポートされているドキュメントタイプ` は、:meth:`Document.convert_to_pdf` メソッドを使用することで簡単に |PDF| に変換できます。このメソッドはデータバッファを返し、それを |PyMuPDF| が利用して新しい |PDF| を作成できます。" #: ../../converting-files.rst:18 ../../converting-files.rst:38 #: ../../converting-files.rst:62 ../../converting-files.rst:82 #: 2eff8f1c0f704e9d9e23a98078353847 7345723f19864e81be97447aab194cd9 #: c3ae18efff164928b70b884d3a47caac ecdbf8cbbb2d46bc9bf312b716b264af msgid "**Example**" msgstr "**例**" #: ../../converting-files.rst:32 4e3eda1d4bff4593ae1f0333bcc47a5d msgid "PDF to SVG" msgstr "PDFからSVGへ" #: ../../converting-files.rst:34 d8f0e0e26f99486485d27038482b5558 msgid "" "Technically, as SVG files cannot be multipage, we must export each page " "as an SVG." msgstr "技術的には、SVGファイルは複数ページを持つことができないため、各ページをSVGとしてエクスポートする必要があります。" #: ../../converting-files.rst:36 45efc8839a1b44e9a877335aa51df1b6 msgid "" "To get an SVG representation of a page use the :meth:`Page.get_svg_image`" " method." msgstr "ページのSVG表現を取得するには、:meth:`Page.get_svg_image` メソッドを使用します。" #: ../../converting-files.rst:58 9249883d41654d3c8041c561743679c6 msgid "PDF to Markdown" msgstr "PDFからMarkdownへ" #: ../../converting-files.rst:60 9d35a0dc74c742419817cfab8ac5fbb6 msgid "" "By utlilizing the :doc:`PyMuPDF4LLM API ` we are able to" " convert PDF to a Markdown representation." msgstr ":doc:`PyMuPDF4LLM API ` を利用することで、PDFをMarkdown表現に変換できます。" #: ../../converting-files.rst:76 a8c608159d57471c89e55f3c44adafe2 msgid "PDF to DOCX" msgstr "PDFからDOCXへ" #: ../../converting-files.rst:78 443eb3ec0d3a4ba89f8e4361a7607e16 msgid "" "Use the pdf2docx_ library which uses |PyMuPDF| to provide document " "conversion from |PDF| to **DOCX** format." msgstr "|PyMuPDF| を使用してドキュメントを |PDF| から **DOCX** 形式に変換する pdf2docx_ ライブラリを使用します。" #: ../../footer.rst:46 bf92de7cbdc140fba9255f9a43b9932a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/coop_low.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 5a355454a0e14f23a63b8a2e7ce669e8 msgid "Artifex" msgstr "" #: ../../header.rst:-1 09967d10ba634cb1bff385ff21b01dde msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 d1d359d0d40748de8b9c0d01760f6668 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../coop_low.rst:7 bdf9ff13324144f3aea1e6e6fb99a106 msgid "Working together: DisplayList and TextPage" msgstr "共同作業：DisplayList と TextPage" #: ../../coop_low.rst:8 f4bd6483319f4150b1c8bb96b8e13933 msgid "Here are some instructions on how to use these classes together." msgstr "これらのクラスを一緒に使用する方法に関するいくつかの手順があります。" #: ../../coop_low.rst:10 ed7509d3a4e1434498829a99374f641b msgid "" "In some situations, performance improvements may be achievable, when you " "fall back to the detail level explained here." msgstr "一部の状況では、ここで説明されている詳細レベルに戻ると、パフォーマンスの向上が可能かもしれません。" #: ../../coop_low.rst:13 cd9e800e616545078dedc61814a029c7 msgid "Create a DisplayList" msgstr "DisplayList の作成" #: ../../coop_low.rst:14 c3a4cb6ce3974be5af359b73bd3b8d71 msgid "" "A :ref:`DisplayList` represents an interpreted document page. Methods for" " pixmap creation, text extraction and text search are -- behind the " "curtain -- all using the page's display list to perform their tasks. If a" " page must be rendered several times (e.g. because of changed zoom " "levels), or if text search and text extraction should both be performed, " "overhead can be saved, if the display list is created only once and then " "used for all other tasks." msgstr "" ":ref:`DisplayList` " "は解釈された文書ページを表します。ピクセルマップの作成、テキスト抽出、およびテキスト検索のメソッドは、幕の内側で、それぞれのタスクを実行するためにページの表示リストを使用しています。ページを複数回描画する必要がある場合（ズームレベルが変更されたためなど）、またはテキストの検索とテキストの抽出の両方を実行する必要がある場合、表示リストは一度だけ作成し、その後のすべてのタスクに使用すると、オーバーヘッドを節約できます。" #: ../../coop_low.rst:18 4a46c1c8dddf48029189e3b15bc68591 msgid "" "You can also create display lists for many pages \"on stack\" (in a " "list), may be during document open, during idling times, or you store it " "when a page is visited for the first time (e.g. in GUI scripts)." msgstr "ディスプレイリストを多くのページに対して「スタック上」（リスト内）で作成することもできます。これはドキュメントを開いている間、アイドリング時間中、またはページが初めて訪れられたとき（GUIスクリプトなど）に行うことができます。" #: ../../coop_low.rst:20 2f2b49df380e40cea8dba1b11f5ee9a8 msgid "" "Note, that for everything what follows, only the display list is needed " "-- the corresponding :ref:`Page` object could have been deleted." msgstr "" "注意：以下のすべてのことについて、ディスプレイリストのみが必要です - 対応する :ref:`Page` " "オブジェクトは削除されている可能性があります。" #: ../../coop_low.rst:23 aebfe0ed572842b9ba5b11a8d1aab0d2 msgid "Generate Pixmap" msgstr "ピクセルマップの生成" #: ../../coop_low.rst:24 7dd16880b19c48e9837fd5dc2c621515 msgid "" "The following creates a Pixmap from a :ref:`DisplayList`. Parameters are " "the same as for :meth:`Page.get_pixmap`." msgstr "" "以下は、:ref:`DisplayList` からピクセルマップを生成するものです。パラメータは :meth:`Page.get_pixmap` " "と同じです。" #: ../../coop_low.rst:28 e89f1e9ef8d649f4a06985425cfa62a4 #, python-format msgid "" "The execution time of this statement may be up to 50% shorter than that " "of :meth:`Page.get_pixmap`." msgstr "この文の実行時間は、:meth:`Page.get_pixmap` の実行時間よりも最大50％短くなる可能性があります。" #: ../../coop_low.rst:31 d7fa50d37ba94e5cb71679b146596aa3 msgid "Perform Text Search" msgstr "テキスト検索を実行" #: ../../coop_low.rst:32 883c1b8167124e3c87bee02cb540ebbb msgid "With the display list from above, we can also search for text." msgstr "上記のディスプレイリストを使用して、テキストを検索することもできます。" #: ../../coop_low.rst:34 dffc2a72113945cbbce0613fb18a4903 msgid "For this we need to create a :ref:`TextPage`." msgstr "これには、:ref:`TextPage` を作成する必要があります。" #: ../../coop_low.rst:42 268c3ac74027425381db0e5a5b1beeec msgid "Extract Text" msgstr "テキストの抽出" #: ../../coop_low.rst:43 499d4763043d407c8815a5ff4c386e37 msgid "" "With the same :ref:`TextPage` object from above, we can now immediately " "use any or all of the 5 text extraction methods." msgstr "前述の :ref:`TextPage` オブジェクトを使用することで、今すぐに5つのテキスト抽出メソッドのいずれかまたはすべてを使用できます。" #: ../../coop_low.rst:45 6f1b9f5de2eb487c9502d14d7e74597c msgid "" "Above, we have created our text page without argument. This leads to a " "default argument of 3 (:data:`ligatures` and white-space are preserved), " "IAW images will **not** be extracted -- see below." msgstr "" "前述のように、テキストページを引数なしで作成しました。これにより、デフォルトの引数3（合字と空白が保持されます）が適用されます。つまり、画像は抽出" " **されません** - 以下を参照してください。" #: ../../coop_low.rst:54 ab9774b34e1845db917cc426db636fd8 msgid "Further Performance improvements" msgstr "さらなるパフォーマンスの向上" #: ../../coop_low.rst:56 8aa6869464d643f1b386fb7323425982 msgid "Pixmap" msgstr "" #: ../../coop_low.rst:57 d58917690b86432a8db25b4e290c8aab msgid "As explained in the :ref:`Page` chapter:" msgstr "ページの章で説明されているように：" #: ../../coop_low.rst:59 5f452558de7e46d1a6bb4d407940f71d #, python-format msgid "" "If you do not need transparency set *alpha = 0* when creating pixmaps. " "This will save 25% memory (if RGB, the most common case) and possibly 5% " "execution time (depending on the GUI software)." msgstr "" "透明度が不要な場合は、ピクスマップを作成する際に alpha = 0 " "に設定します。これにより、メモリが25％節約されます（RGBの場合、最も一般的なケース）し、GUIソフトウェアに依存して実行時間が5％削減される可能性があります。" #: ../../coop_low.rst:62 75cc3ebbf8db48479d9f9b81f89a5254 msgid "TextPage" msgstr "" #: ../../coop_low.rst:63 08ee726963904764a54737759d3c18d6 msgid "" "If you do not need images extracted alongside the text of a page, you can" " set the following option:" msgstr "ページのテキストと一緒に画像を抽出する必要がない場合、以下のオプションを設定できます：" #: ../../coop_low.rst:68 4251f3ef7f5f4ac69038ff012e1254c6 #, python-format msgid "" "This will save ca. 25% overall execution time for the HTML, XHTML and " "JSON text extractions and **hugely** reduce the amount of storage (both, " "memory and disk space) if the document is graphics oriented." msgstr "" "これにより、HTML、XHTML、およびJSONのテキスト抽出全体の実行時間が約25％節約され、ドキュメントがグラフィックス志向である場合、ストレージ（メモリとディスクスペースの両方）の量が" " **大幅に** 削減されます。" #: ../../coop_low.rst:70 bbd6a64180374797a986afa4351f7218 msgid "If you however do need images, use a value of 7 for flags:" msgstr "ただし、画像が必要な場合は、フラグに7の値を使用してください：" #: ../../footer.rst:60 ef9f02956d6945e086760c64e2387362 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/deprecated.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-05-06 22:50+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../deprecated.rst:3 d1d5b6242bd2429487e3c00f4bd27b44 msgid ":index:`_isWrapped` -- :attr:`Page.is_wrapped`" msgstr "" #: ../../deprecated.rst:4 eadbd707ba5b49ffaa1a8578c63f2fa7 msgid ":index:`addCaretAnnot` -- :meth:`Page.add_caret_annot`" msgstr "" #: ../../deprecated.rst:5 f3d2fc15c03d40fe9c5aeee5eb43619e msgid ":index:`addCircleAnnot` -- :meth:`Page.add_circle_annot`" msgstr "" #: ../../deprecated.rst:6 051b8aa821bb412898f73279004d2d87 msgid ":index:`addFileAnnot` -- :meth:`Page.add_file_annot`" msgstr "" #: ../../deprecated.rst:7 6b9299e0c63d4f9c840acf5cef786d3b msgid ":index:`addFreetextAnnot` -- :meth:`Page.add_freetext_annot`" msgstr "" #: ../../deprecated.rst:8 448eb9354f114ddc801e1e7e17c90813 msgid ":index:`addHighlightAnnot` -- :meth:`Page.add_highlight_annot`" msgstr "" #: ../../deprecated.rst:9 afdf93da30d0472583f679bb32992982 msgid ":index:`addInkAnnot` -- :meth:`Page.add_ink_annot`" msgstr "" #: ../../deprecated.rst:10 111293a76e4048d0b5e1605e9e874812 msgid ":index:`addLineAnnot` -- :meth:`Page.add_line_annot`" msgstr "" #: ../../deprecated.rst:11 27c091e35cd143f5b67a0e8c8fa0875f msgid ":index:`addPolygonAnnot` -- :meth:`Page.add_polygon_annot`" msgstr "" #: ../../deprecated.rst:12 6933d20ce2e141c5a3fadbd053766d4d msgid ":index:`addPolylineAnnot` -- :meth:`Page.add_polyline_annot`" msgstr "" #: ../../deprecated.rst:13 30c229985fe44b80af84338499a2f559 msgid ":index:`addRectAnnot` -- :meth:`Page.add_rect_annot`" msgstr "" #: ../../deprecated.rst:14 d78dac9a27684b5da29499e4b2f6b8f5 msgid ":index:`addRedactAnnot` -- :meth:`Page.add_redact_annot`" msgstr "" #: ../../deprecated.rst:15 04264798641b4de3938500d873c2c6f8 msgid ":index:`addSquigglyAnnot` -- :meth:`Page.add_squiggly_annot`" msgstr "" #: ../../deprecated.rst:16 fc348b38ada34284b4ff935bc0b96c15 msgid ":index:`addStampAnnot` -- :meth:`Page.add_stamp_annot`" msgstr "" #: ../../deprecated.rst:17 bee1ce84496246a38df53948bf77f357 msgid ":index:`addStrikeoutAnnot` -- :meth:`Page.add_strikeout_annot`" msgstr "" #: ../../deprecated.rst:18 25dad72947f64b9e8b569df99549e4e9 msgid ":index:`addTextAnnot` -- :meth:`Page.add_text_annot`" msgstr "" #: ../../deprecated.rst:19 00aa64572a5f41b9a8cbed77037f912b msgid ":index:`addUnderlineAnnot` -- :meth:`Page.add_underline_annot`" msgstr "" #: ../../deprecated.rst:20 c385a1bc52db4e72a107bfed39ab9073 msgid ":index:`addWidget` -- :meth:`Page.add_widget`" msgstr "" #: ../../deprecated.rst:21 18d7411089ff4ab38e8a6b325dbafb58 msgid ":index:`chapterCount` -- :attr:`Document.chapter_count`" msgstr "" #: ../../deprecated.rst:22 3e8e8070762748c6ab15040d7ddfbf98 msgid ":index:`chapterPageCount` -- :meth:`Document.chapter_page_count`" msgstr "" #: ../../deprecated.rst:23 877a39673c34487ebea478f53dfbf4c4 msgid ":index:`cleanContents` -- :meth:`Page.clean_contents`" msgstr "" #: ../../deprecated.rst:24 d264e6c6a4f34ccda276df5fadd9f2f3 msgid ":index:`clearWith` -- :meth:`Pixmap.clear_with`" msgstr "" #: ../../deprecated.rst:25 c6e7724402164c7595cec2d1b515954d msgid ":index:`convertToPDF` -- :meth:`Document.convert_to_pdf`" msgstr "" #: ../../deprecated.rst:26 30efb14a60a04279b22147f212ff2ce0 msgid ":index:`copyPage` -- :meth:`Document.copy_page`" msgstr "" #: ../../deprecated.rst:27 71be569311b643fcad76f9175f84ad8d msgid ":index:`copyPixmap` -- :meth:`Pixmap.copy`" msgstr "" #: ../../deprecated.rst:28 9d169e01195d45ef8b642a34622387b3 msgid ":index:`CropBox` -- :attr:`Page.cropbox`" msgstr "" #: ../../deprecated.rst:29 d4e6e34a1e174e78aaaa16cc1589987b msgid ":index:`CropBoxPosition` -- :attr:`Page.cropbox_position`" msgstr "" #: ../../deprecated.rst:30 eb2e77d896d148228b3ac65c9ac53982 msgid ":index:`deleteAnnot` -- :meth:`Page.delete_annot`" msgstr "" #: ../../deprecated.rst:31 8f12dc1d6a2c47bc90ace8d1c4c0837a msgid ":index:`deleteLink` -- :meth:`Page.delete_link`" msgstr "" #: ../../deprecated.rst:32 9e4d33fa051741b48c48b7cdb720d90d msgid ":index:`deletePage` -- :meth:`Document.delete_page`" msgstr "" #: ../../deprecated.rst:33 66877e75a8c649ff8eebd342e28ceedf msgid ":index:`deletePageRange` -- :meth:`Document.delete_pages`" msgstr "" #: ../../deprecated.rst:34 25721559e2fe452c86484ce93215a810 msgid ":index:`deleteWidget` -- :meth:`Page.delete_widget`" msgstr "" #: ../../deprecated.rst:35 0c1a8e11e7fd4587ae4312e58bf62d33 msgid ":index:`derotationMatrix` -- :attr:`Page.derotation_matrix`" msgstr "" #: ../../deprecated.rst:36 9c6cfa1376f94b509d2447887df70621 msgid ":index:`drawBezier` -- :meth:`Page.draw_bezier`" msgstr "" #: ../../deprecated.rst:37 22e65f0dbdfd44d3b77a5f0b9e807410 msgid ":index:`drawBezier` -- :meth:`Shape.draw_bezier`" msgstr "" #: ../../deprecated.rst:38 9240fc36aeb64362af89de7221a1ec18 msgid ":index:`drawCircle` -- :meth:`Page.draw_circle`" msgstr "" #: ../../deprecated.rst:39 3e71c253f1c64091b41e692eb39e85cb msgid ":index:`drawCircle` -- :meth:`Shape.draw_circle`" msgstr "" #: ../../deprecated.rst:40 be7a4c92ba9346599ed48970f720d423 msgid ":index:`drawCurve` -- :meth:`Page.draw_curve`" msgstr "" #: ../../deprecated.rst:41 513be296f2cb4b618a91597a2df7e65d msgid ":index:`drawCurve` -- :meth:`Shape.draw_curve`" msgstr "" #: ../../deprecated.rst:42 c0b7d4f8b2ad4691bd0aa7859ea33b77 msgid ":index:`drawLine` -- :meth:`Page.draw_line`" msgstr "" #: ../../deprecated.rst:43 554d906bb05f409190d6e6893190f958 msgid ":index:`drawLine` -- :meth:`Shape.draw_line`" msgstr "" #: ../../deprecated.rst:44 b2405f1b84e642eeafb66539f9808fb8 msgid ":index:`drawOval` -- :meth:`Page.draw_oval`" msgstr "" #: ../../deprecated.rst:45 aa69dd3ae74a463bb7b144a8d78c7cb4 msgid ":index:`drawOval` -- :meth:`Shape.draw_oval`" msgstr "" #: ../../deprecated.rst:46 bd4e3e4e051d4f2aa442d3d777a3b5ff msgid ":index:`drawPolyline` -- :meth:`Page.draw_polyline`" msgstr "" #: ../../deprecated.rst:47 65c2a5f2e60d4e8791bd6bc4911e5d02 msgid ":index:`drawPolyline` -- :meth:`Shape.draw_polyline`" msgstr "" #: ../../deprecated.rst:48 ada5b07f1393444ca6f56d8878c5344f msgid ":index:`drawQuad` -- :meth:`Page.draw_quad`" msgstr "" #: ../../deprecated.rst:49 bacd1883810d4581a41f8c39d4b1d590 msgid ":index:`drawQuad` -- :meth:`Shape.draw_quad`" msgstr "" #: ../../deprecated.rst:50 44a58d0bc884449eb62d74622f5c6c95 msgid ":index:`drawRect` -- :meth:`Page.draw_rect`" msgstr "" #: ../../deprecated.rst:51 c0cc88dd71fb497996d4893f4a14d229 msgid ":index:`drawRect` -- :meth:`Shape.draw_rect`" msgstr "" #: ../../deprecated.rst:52 f0925417a417408fb57e98400f82de38 msgid ":index:`drawSector` -- :meth:`Page.draw_sector`" msgstr "" #: ../../deprecated.rst:53 4e06c452b87b43dc88597aecb0183689 msgid ":index:`drawSector` -- :meth:`Shape.draw_sector`" msgstr "" #: ../../deprecated.rst:54 f8a714b644134acc857618d42422b411 msgid ":index:`drawSquiggle` -- :meth:`Page.draw_squiggle`" msgstr "" #: ../../deprecated.rst:55 93bb79f96d144fd38674d32e9aaa84c9 msgid ":index:`drawSquiggle` -- :meth:`Shape.draw_squiggle`" msgstr "" #: ../../deprecated.rst:56 cf3932da67be42dc8007fbee0a4427ec msgid ":index:`drawZigzag` -- :meth:`Page.draw_zigzag`" msgstr "" #: ../../deprecated.rst:57 3107e38c57054eeea4d24f265b0f6671 msgid ":index:`drawZigzag` -- :meth:`Shape.draw_zigzag`" msgstr "" #: ../../deprecated.rst:58 03b818471af840fdb95c8dc2d8e7b209 msgid ":index:`embeddedFileAdd` -- :meth:`Document.embfile_add`" msgstr "" #: ../../deprecated.rst:59 5167d2308e644b71a09de926761ece0f msgid ":index:`embeddedFileCount` -- :meth:`Document.embfile_count`" msgstr "" #: ../../deprecated.rst:60 161231ecd2224595bf3872c106a60136 msgid ":index:`embeddedFileDel` -- :meth:`Document.embfile_del`" msgstr "" #: ../../deprecated.rst:61 1023a942cc61494caba4804eeb29cebc msgid ":index:`embeddedFileGet` -- :meth:`Document.embfile_get`" msgstr "" #: ../../deprecated.rst:62 a52dfb754efa438ea2c232dc7130cf4b msgid ":index:`embeddedFileInfo` -- :meth:`Document.embfile_info`" msgstr "" #: ../../deprecated.rst:63 ef355611163d4b0bb14aaa00d18a0564 msgid ":index:`embeddedFileNames` -- :meth:`Document.embfile_names`" msgstr "" #: ../../deprecated.rst:64 999df931002c417da988825a29f420e0 msgid ":index:`embeddedFileUpd` -- :meth:`Document.embfile_upd`" msgstr "" #: ../../deprecated.rst:65 bf948d4f5d5f4caab2b7b01337d456e2 msgid ":index:`extractFont` -- :meth:`Document.extract_font`" msgstr "" #: ../../deprecated.rst:66 93fd021db67c403a8c52df83b26fea46 msgid ":index:`extractImage` -- :meth:`Document.extract_image`" msgstr "" #: ../../deprecated.rst:67 3021f35e288d4b7896cc4998b8d5cd4c msgid ":index:`fileGet` -- :meth:`Annot.get_file`" msgstr "" #: ../../deprecated.rst:68 e766fa14928e487d81044fb5bfec79a7 msgid ":index:`fileUpd` -- :meth:`Annot.update_file`" msgstr "" #: ../../deprecated.rst:69 054a45d2bd564e99936796752bc21ae2 msgid ":index:`fillTextbox` -- :meth:`TextWriter.fill_textbox`" msgstr "" #: ../../deprecated.rst:70 5611c1d6bebc4834ba3309d08e108fe4 msgid ":index:`findBookmark` -- :meth:`Document.find_bookmark`" msgstr "" #: ../../deprecated.rst:71 19590b26aef74066bd9089aaa473b418 msgid ":index:`firstAnnot` -- :attr:`Page.first_annot`" msgstr "" #: ../../deprecated.rst:72 11cd12cfd924436f9989b50bf24076ce msgid ":index:`firstLink` -- :attr:`Page.first_link`" msgstr "" #: ../../deprecated.rst:73 e0341c36f0474b29b165756ff2bf2e39 msgid ":index:`firstWidget` -- :attr:`Page.first_widget`" msgstr "" #: ../../deprecated.rst:74 3e529771a460436ca6ec8cc3553b1646 msgid ":index:`fullcopyPage` -- :meth:`Document.fullcopy_page`" msgstr "" #: ../../deprecated.rst:75 7a0f1fd1838049589f29544cbafbee6e msgid ":index:`gammaWith` -- :meth:`Pixmap.gamma_with`" msgstr "" #: ../../deprecated.rst:76 3e03080a489a4185ab0403f5e4a10533 msgid ":index:`getArea` -- :meth:`Rect.get_area`" msgstr "" #: ../../deprecated.rst:77 d08fd4faaef048ef9455a3dc22e0abe0 msgid ":index:`getArea` -- :meth:`IRect.get_area`" msgstr "" #: ../../deprecated.rst:78 8feb6c6033434a7eb93729dd7a214492 msgid ":index:`getCharWidths` -- :meth:`Document.get_char_widths`" msgstr "" #: ../../deprecated.rst:79 e820322f7d12476983ff2f6844edebb7 msgid ":index:`getContents` -- :meth:`Page.get_contents`" msgstr "" #: ../../deprecated.rst:80 315689e05e6b4ee79e9ee34b4855c9b3 msgid ":index:`getDisplayList` -- :meth:`Page.get_displaylist`" msgstr "" #: ../../deprecated.rst:81 59ef935a55fb48e0ad3d0b05fe9bba6a msgid ":index:`getDrawings` -- :meth:`Page.get_drawings`" msgstr "" #: ../../deprecated.rst:82 fdac52da208b4710a3dcf0603259e088 msgid ":index:`getFontList` -- :meth:`Page.get_fonts`" msgstr "" #: ../../deprecated.rst:83 1cb6609cac5344bbb52338df5723abbb msgid ":index:`getImageBbox` -- :meth:`Page.get_image_bbox`" msgstr "" #: ../../deprecated.rst:84 b2db41e3b28c49fe85ada1aaa5d11c93 msgid ":index:`getImageData` -- :meth:`Pixmap.tobytes`" msgstr "" #: ../../deprecated.rst:85 4016e42ec02d47a98cd479a56c1d6f81 msgid ":index:`getImageList` -- :meth:`Page.get_images`" msgstr "" #: ../../deprecated.rst:86 ba9df1a02bbb41d699430071a0853142 msgid ":index:`getLinks` -- :meth:`Page.get_links`" msgstr "" #: ../../deprecated.rst:87 e45e78c952c149b99893f2bdf0464ce9 msgid ":index:`getOCGs` -- :meth:`Document.get_ocgs`" msgstr "" #: ../../deprecated.rst:88 8cb86892aeb14018b456bb1500228603 msgid ":index:`getPageFontList` -- :meth:`Document.get_page_fonts`" msgstr "" #: ../../deprecated.rst:89 def3f6e7f54a48d584b35944ac483909 msgid ":index:`getPageImageList` -- :meth:`Document.get_page_images`" msgstr "" #: ../../deprecated.rst:90 e60fafcb1644487f85f736966a96e6f3 msgid ":index:`getPagePixmap` -- :meth:`Document.get_page_pixmap`" msgstr "" #: ../../deprecated.rst:91 404571c66f3f4449b253bac469681083 msgid ":index:`getPageText` -- :meth:`Document.get_page_text`" msgstr "" #: ../../deprecated.rst:92 d912b4e08d8e43759b50bd3fe66bf799 msgid ":index:`getPageXObjectList` -- :meth:`Document.get_page_xobjects`" msgstr "" #: ../../deprecated.rst:93 b989c010b0e941358950411ecae89d0d msgid ":index:`getPDFnow` -- :meth:`get_pdf_now`" msgstr "" #: ../../deprecated.rst:94 afc6743031c3459a8b023575e22108ce msgid ":index:`getPDFstr` -- :meth:`get_pdf_str`" msgstr "" #: ../../deprecated.rst:95 4513c128c5d24612b222b6bf32c9ba78 msgid ":index:`getPixmap` -- :meth:`Page.get_pixmap`" msgstr "" #: ../../deprecated.rst:96 8e17558bf3a7484da7e142427292d305 msgid ":index:`getPixmap` -- :meth:`Annot.get_pixmap`" msgstr "" #: ../../deprecated.rst:97 aaaba69a72e34566b856f031a3cc9f3b msgid ":index:`getPixmap` -- :meth:`DisplayList.get_pixmap`" msgstr "" #: ../../deprecated.rst:98 b6a103d877a149f78ef58e60d1576a51 msgid ":index:`getPNGData` -- :meth:`Pixmap.tobytes`" msgstr "" #: ../../deprecated.rst:99 8991d6c4e3dc4accaf8c4e5726f4c4a7 msgid ":index:`getPNGdata` -- :meth:`Pixmap.tobytes`" msgstr "" #: ../../deprecated.rst:100 d37fe89c453843e9bbc3c6518487b009 msgid ":index:`getRectArea` -- :meth:`Rect.get_area`" msgstr "" #: ../../deprecated.rst:101 31cafead100b4a0eab043b8db48315c9 msgid ":index:`getRectArea` -- :meth:`IRect.get_area`" msgstr "" #: ../../deprecated.rst:102 18a3052627f84e0d9076a72aaedd1f56 msgid ":index:`getSigFlags` -- :meth:`Document.get_sigflags`" msgstr "" #: ../../deprecated.rst:103 c8a9c4bf70704bc09d700cd72ee9ab2b msgid ":index:`getSVGimage` -- :meth:`Page.get_svg_image`" msgstr "" #: ../../deprecated.rst:104 962d959e225d4325824133ce80ea7844 msgid ":index:`getText` -- :meth:`Page.get_text`" msgstr "" #: ../../deprecated.rst:105 d84d77c264e44b28bf9d043ea4bc2a40 msgid ":index:`getText` -- :meth:`Annot.get_text`" msgstr "" #: ../../deprecated.rst:106 0e7807a62c5e48aab9c53b62bc99d5f5 msgid ":index:`getTextBlocks` -- :meth:`Page.get_text_blocks`" msgstr "" #: ../../deprecated.rst:107 eaa539c4b1e643f1bb4d8541e3c2cae0 msgid ":index:`getTextbox` -- :meth:`Page.get_textbox`" msgstr "" #: ../../deprecated.rst:108 73c3be87d16b4ce1ab32e14a43c83625 msgid ":index:`getTextbox` -- :meth:`Annot.get_textbox`" msgstr "" #: ../../deprecated.rst:109 57184e466926474a8122c92d716efc01 msgid ":index:`getTextLength` -- :meth:`get_text_length`" msgstr "" #: ../../deprecated.rst:110 ef0865561e5245caaf7cad5c31fa5b7a msgid ":index:`getTextPage` -- :meth:`Page.get_textpage`" msgstr "" #: ../../deprecated.rst:111 145ac3860c93466f80ff59355fc3ff5a msgid ":index:`getTextPage` -- :meth:`Annot.get_textpage`" msgstr "" #: ../../deprecated.rst:112 9751cae710914d3bab31ee6ba59c5991 msgid ":index:`getTextPage` -- :meth:`DisplayList.get_textpage`" msgstr "" #: ../../deprecated.rst:113 5f860f6e22a941eca21077328b814fea msgid ":index:`getTextWords` -- :meth:`Page.get_text_words`" msgstr "" #: ../../deprecated.rst:114 285cb38b768c4499b093536527cca417 msgid ":index:`getToC` -- :meth:`Document.get_toc`" msgstr "" #: ../../deprecated.rst:115 06baade7ba234e409910b5725a990d12 msgid ":index:`getXmlMetadata` -- :meth:`Document.get_xml_metadata`" msgstr "" #: ../../deprecated.rst:116 9fcdf92180a34622be5d144da780ea7a msgid ":index:`ImageProperties` -- :meth:`image_properties`" msgstr "" #: ../../deprecated.rst:117 f394aac5cf1143c38ce86651288f35f0 msgid ":index:`includePoint` -- :meth:`Rect.include_point`" msgstr "" #: ../../deprecated.rst:118 570fa5daadf74e338f232b7b4971d361 msgid ":index:`includePoint` -- :meth:`IRect.include_point`" msgstr "" #: ../../deprecated.rst:119 8ddaec2281cd46aa8b6c4dcff8562392 msgid ":index:`includeRect` -- :meth:`Rect.include_rect`" msgstr "" #: ../../deprecated.rst:120 ff5100ed366b479f96fb5c7fedb20a24 msgid ":index:`includeRect` -- :meth:`IRect.include_rect`" msgstr "" #: ../../deprecated.rst:121 0dfb59dc42064652be63a6368543020e msgid ":index:`insertFont` -- :meth:`Page.insert_font`" msgstr "" #: ../../deprecated.rst:122 d4a5843f50214d2880c0e10589ce890f msgid ":index:`insertImage` -- :meth:`Page.insert_image`" msgstr "" #: ../../deprecated.rst:123 6f95549ce82d47e5ba18bbb14215c08d msgid ":index:`insertLink` -- :meth:`Page.insert_link`" msgstr "" #: ../../deprecated.rst:124 b5e3f22cdb294479ade281982639843b msgid ":index:`insertPage` -- :meth:`Document.insert_page`" msgstr "" #: ../../deprecated.rst:125 030309c3c03340bab039d374155ef986 msgid ":index:`insertPDF` -- :meth:`Document.insert_pdf`" msgstr "" #: ../../deprecated.rst:126 df931ba7d0564c688d145b7f8a2871e0 msgid ":index:`insertText` -- :meth:`Page.insert_text`" msgstr "" #: ../../deprecated.rst:127 17b568407a8e44f8a855291d34cf1d90 msgid ":index:`insertText` -- :meth:`Shape.insert_text`" msgstr "" #: ../../deprecated.rst:128 561e6f7e79fa47f98b59b04cc29ee2f6 msgid ":index:`insertTextbox` -- :meth:`Page.insert_textbox`" msgstr "" #: ../../deprecated.rst:129 54f104892aa04a8993366721a1017bd0 msgid ":index:`insertTextbox` -- :meth:`Shape.insert_textbox`" msgstr "" #: ../../deprecated.rst:130 8f6ad8ae4e3441d0bbe6ceddd469e8a7 msgid ":index:`invertIRect` -- :meth:`Pixmap.invert_irect`" msgstr "" #: ../../deprecated.rst:131 3c2a3d820abe454a99bf6a608d7f9750 msgid ":index:`isConvex` -- :attr:`Quad.is_convex`" msgstr "" #: ../../deprecated.rst:132 ff4a100633ac4aef8956ee89fea3928c msgid ":index:`isDirty` -- :attr:`Document.is_dirty`" msgstr "" #: ../../deprecated.rst:133 b3d2162130f7469da99822ab533562fb msgid ":index:`isEmpty` -- :attr:`Rect.is_empty`" msgstr "" #: ../../deprecated.rst:134 7902fb832f4d46148e5fb12d33180721 msgid ":index:`isEmpty` -- :attr:`IRect.is_empty`" msgstr "" #: ../../deprecated.rst:135 219e226b694b4424a8cc0b243125195b msgid ":index:`isEmpty` -- :attr:`Quad.is_empty`" msgstr "" #: ../../deprecated.rst:136 6d2a36ec88b848888e47502f443ddd2f msgid ":index:`isFormPDF` -- :attr:`Document.is_form_pdf`" msgstr "" #: ../../deprecated.rst:137 ee6a8794ac454167bf112c26aee0679e msgid ":index:`isInfinite` -- :attr:`Rect.is_infinite`" msgstr "" #: ../../deprecated.rst:138 0e449ebf4dbf41c3a5684705c4764d1e msgid ":index:`isInfinite` -- :attr:`IRect.is_infinite`" msgstr "" #: ../../deprecated.rst:139 bb7e257c9c5d4c649588be9dcc1539e8 msgid ":index:`isPDF` -- :attr:`Document.is_pdf`" msgstr "" #: ../../deprecated.rst:140 6034a32b2cd641c587f398e466223fbb msgid ":index:`isRectangular` -- :attr:`Quad.is_rectangular`" msgstr "" #: ../../deprecated.rst:141 e04e5574d4294c58a6e2e047385e4bab msgid ":index:`isRectilinear` -- :attr:`Matrix.is_rectilinear`" msgstr "" #: ../../deprecated.rst:142 72f57f01824e4c2090e4cecaaa3bd7b3 msgid ":index:`isReflowable` -- :attr:`Document.is_reflowable`" msgstr "" #: ../../deprecated.rst:143 6f1427d4d36448bea20405dd494e4e9b msgid ":index:`isRepaired` -- :attr:`Document.is_repaired`" msgstr "" #: ../../deprecated.rst:144 46501c7649d2435db16b4ba2b180de44 msgid ":index:`isStream` -- :meth:`Document.is_stream`" msgstr "" #: ../../deprecated.rst:145 d8c668fe2a6a41368d3753de325db923 msgid ":index:`lastLocation` -- :attr:`Document.last_location`" msgstr "" #: ../../deprecated.rst:146 23b2e4723f784739b87a95d0e621af1b msgid ":index:`lineEnds` -- :attr:`Annot.line_ends`" msgstr "" #: ../../deprecated.rst:147 9f84a5afe9f94be08d591804cdb1f2dd msgid ":index:`loadAnnot` -- :meth:`Page.load_annot`" msgstr "" #: ../../deprecated.rst:148 a9b23d3b3f6343dcb80e169000f2b2f5 msgid ":index:`loadLinks` -- :meth:`Page.load_links`" msgstr "" #: ../../deprecated.rst:149 25f9456cfe284e5fb321a13a57937aff msgid ":index:`loadPage` -- :meth:`Document.load_page`" msgstr "" #: ../../deprecated.rst:150 9c522c046f63431fad4d3d4dcae73d31 msgid ":index:`makeBookmark` -- :meth:`Document.make_bookmark`" msgstr "" #: ../../deprecated.rst:151 89dd42c792e44a5db93d7cf5e8d1bdd0 msgid ":index:`MediaBox` -- :attr:`Page.mediabox`" msgstr "" #: ../../deprecated.rst:152 2ce8cf40024f432a8a6d298e8396809e msgid ":index:`MediaBoxSize` -- :attr:`Page.mediabox_size`" msgstr "" #: ../../deprecated.rst:153 fc3637603edc44449553dd1fc10ef2dc msgid ":index:`metadataXML` -- :meth:`Document.xref_xml_metadata`" msgstr "" #: ../../deprecated.rst:154 4734ad7ca35e4295bc39b9343fae96bf msgid ":index:`movePage` -- :meth:`Document.move_page`" msgstr "" #: ../../deprecated.rst:155 29dc231050284695b482c40ab67035cd msgid ":index:`needsPass` -- :attr:`Document.needs_pass`" msgstr "" #: ../../deprecated.rst:156 b7bbcca1b65140f7a23f06023146091a msgid ":index:`newPage` -- :meth:`Document.new_page`" msgstr "" #: ../../deprecated.rst:157 7b9a25eacb194c1085cd415855c4860e msgid ":index:`newShape` -- :meth:`Page.new_shape`" msgstr "" #: ../../deprecated.rst:158 8173575617414d0989cd5e7b5dbe4825 msgid ":index:`nextLocation` -- :meth:`Document.next_location`" msgstr "" #: ../../deprecated.rst:159 0b83f1a78c974acba949f3651c3987ca msgid ":index:`pageCount` -- :attr:`Document.page_count`" msgstr "" #: ../../deprecated.rst:160 d347647e7c4845689c148b6687cbe86e msgid ":index:`pageCropBox` -- :meth:`Document.page_cropbox`" msgstr "" #: ../../deprecated.rst:161 07ab9db3d77249908e0570a9f601b00b msgid ":index:`pageXref` -- :meth:`Document.page_xref`" msgstr "" #: ../../deprecated.rst:162 c48b011bfa7a49f4a715474371748d0d msgid ":index:`PaperRect` -- :meth:`paper_rect`" msgstr "" #: ../../deprecated.rst:163 794d8f18e4b34f019a7e5a1eff5f2db4 msgid ":index:`PaperSize` -- :meth:`paper_size`" msgstr "" #: ../../deprecated.rst:164 912bd5afa4174ad7ad07cacc9d16aef4 msgid ":index:`paperSizes` -- :attr:`paper_sizes`" msgstr "" #: ../../deprecated.rst:165 b03e09c6342c41299da1cdecfe87a1fc msgid ":index:`PDFCatalog` -- :meth:`Document.pdf_catalog`" msgstr "" #: ../../deprecated.rst:166 962d9ba05d8841d1b1c66b3fc304d6f8 msgid ":index:`PDFTrailer` -- :meth:`Document.pdf_trailer`" msgstr "" #: ../../deprecated.rst:167 2f4783d82c5a4d14b0f377fcffb5fed8 msgid ":index:`pillowData` -- :meth:`Pixmap.pil_tobytes`" msgstr "" #: ../../deprecated.rst:168 baf9bf3a1e884ddb99139199010c1f5b msgid ":index:`pillowWrite` -- :meth:`Pixmap.pil_save`" msgstr "" #: ../../deprecated.rst:169 96c05e011f1242b9b8163d060e11876a msgid ":index:`planishLine` -- :meth:`planish_line`" msgstr "" #: ../../deprecated.rst:170 68bd0d9d10734094b2e9dbc55162e13a msgid ":index:`preRotate` -- :meth:`Matrix.prerotate`" msgstr "" #: ../../deprecated.rst:171 8bdcf39ac3a04ec584a07c3670e6c1c7 msgid ":index:`preScale` -- :meth:`Matrix.prescale`" msgstr "" #: ../../deprecated.rst:172 cf845bc2492648df9b941b7ef7db68b6 msgid ":index:`preShear` -- :meth:`Matrix.preshear`" msgstr "" #: ../../deprecated.rst:173 14c5026144d84103b74a07b30fee2512 msgid ":index:`preTranslate` -- :meth:`Matrix.pretranslate`" msgstr "" #: ../../deprecated.rst:174 fc0559ee8c6343eea94b1b7e3948e03e msgid ":index:`previousLocation` -- :meth:`Document.prev_location`" msgstr "" #: ../../deprecated.rst:175 27731a7d4029401da7bc531da68f1a21 msgid ":index:`readContents` -- :meth:`Page.read_contents`" msgstr "" #: ../../deprecated.rst:176 133ffd4b0d204ec4b93e2e4cfafcb76f msgid ":index:`resolveLink` -- :meth:`Document.resolve_link`" msgstr "" #: ../../deprecated.rst:177 dd161914317344ab9c50aa1713b3bc8a msgid ":index:`rotationMatrix` -- :attr:`Page.rotation_matrix`" msgstr "" #: ../../deprecated.rst:178 12c65e9ce74e4188ade3e84773fff4a4 msgid ":index:`searchFor` -- :meth:`Page.search_for`" msgstr "" #: ../../deprecated.rst:179 7ebba037060c4ccb94fb6611ec91a95c msgid ":index:`searchPageFor` -- :meth:`Document.search_page_for`" msgstr "" #: ../../deprecated.rst:180 1bd92b7e92794d7ea9fd5fe12a917fb5 msgid ":index:`setAlpha` -- :meth:`Pixmap.set_alpha`" msgstr "" #: ../../deprecated.rst:181 d939772fbf0440968d64b115e336901b msgid ":index:`setBlendMode` -- :meth:`Annot.set_blendmode`" msgstr "" #: ../../deprecated.rst:182 eee4c968e1ce440b9bca3317f1c97c2b msgid ":index:`setBorder` -- :meth:`Annot.set_border`" msgstr "" #: ../../deprecated.rst:183 8972027ca4c64c239a0ac5796eda537e msgid ":index:`setColors` -- :meth:`Annot.set_colors`" msgstr "" #: ../../deprecated.rst:184 25dcdb414c364adcaecd75bbad18538b msgid ":index:`setCropBox` -- :meth:`Page.set_cropbox`" msgstr "" #: ../../deprecated.rst:185 3478d381553d46b98ad378b06d3535d7 msgid ":index:`setFlags` -- :meth:`Annot.set_flags`" msgstr "" #: ../../deprecated.rst:186 a3f6ed932990480d8ef802f1aa8dc611 msgid ":index:`setInfo` -- :meth:`Annot.set_info`" msgstr "" #: ../../deprecated.rst:187 399b02fa3d8645c9a0e6a63968a49ab6 msgid ":index:`setLanguage` -- :meth:`Document.set_language`" msgstr "" #: ../../deprecated.rst:188 15718079cc2847dea27b601e918c69d2 msgid ":index:`setLineEnds` -- :meth:`Annot.set_line_ends`" msgstr "" #: ../../deprecated.rst:189 c64721b035484fb7afc912582cdde029 msgid ":index:`setMediaBox` -- :meth:`Page.set_mediabox`" msgstr "" #: ../../deprecated.rst:190 dda850ad8d874c678fc63fb40bdf18f0 msgid ":index:`setMetadata` -- :meth:`Document.set_metadata`" msgstr "" #: ../../deprecated.rst:191 da20869148a84b22aae622c6cf2f1a94 msgid ":index:`setName` -- :meth:`Annot.set_name`" msgstr "" #: ../../deprecated.rst:192 3465192236a64449886c7a641b6ae7e4 msgid ":index:`setOC` -- :meth:`Annot.set_oc`" msgstr "" #: ../../deprecated.rst:193 565618b0eeda4dab9fcb83f7cb66ced6 msgid ":index:`setOpacity` -- :meth:`Annot.set_opacity`" msgstr "" #: ../../deprecated.rst:194 0da4f191ff2a4ee6b4dcd65f2389eaa2 msgid ":index:`setOrigin` -- :meth:`Pixmap.set_origin`" msgstr "" #: ../../deprecated.rst:195 18647efea53342d5b7557f7cae05e4a1 msgid ":index:`setPixel` -- :meth:`Pixmap.set_pixel`" msgstr "" #: ../../deprecated.rst:196 a24782160fb141e8ac764c333d987674 msgid ":index:`setRect` -- :meth:`Annot.set_rect`" msgstr "" #: ../../deprecated.rst:197 b6d40d4e98674081b1a9af6708231fdf msgid ":index:`setRect` -- :meth:`Pixmap.set_rect`" msgstr "" #: ../../deprecated.rst:198 5c6f3e60a4784efe97eec74f3efead31 msgid ":index:`setResolution` -- :meth:`Pixmap.set_dpi`" msgstr "" #: ../../deprecated.rst:199 d3cf7265bb0345caaa35cee0ccec1f58 msgid ":index:`setRotation` -- :meth:`Page.set_rotation`" msgstr "" #: ../../deprecated.rst:200 1573ef9d77b343afb19a92a27d87756e msgid ":index:`setToC` -- :meth:`Document.set_toc`" msgstr "" #: ../../deprecated.rst:201 458d23fe34464a6595998b7eb1018338 msgid ":index:`setXmlMetadata` -- :meth:`Document.set_xml_metadata`" msgstr "" #: ../../deprecated.rst:202 dbff7623129443ae909b28be52fdaacb msgid ":index:`showPDFpage` -- :meth:`Page.show_pdf_page`" msgstr "" #: ../../deprecated.rst:203 7e7c0909bd734d378738029819134255 msgid ":index:`soundGet` -- :meth:`Annot.get_sound`" msgstr "" #: ../../deprecated.rst:204 8161ab61491b42ad924a02953ddd540b msgid ":index:`tintWith` -- :meth:`Pixmap.tint_with`" msgstr "" #: ../../deprecated.rst:205 315914d9d5214bf9bb07a4f746a91ac6 msgid ":index:`transformationMatrix` -- :attr:`Page.transformation_matrix`" msgstr "" #: ../../deprecated.rst:206 8e9b02db2d39463b950c2d3bbff108a3 msgid ":index:`updateLink` -- :meth:`Page.update_link`" msgstr "" #: ../../deprecated.rst:207 8263c336e9bb402ca9cbd9086d43d75b msgid ":index:`updateObject` -- :meth:`Document.update_object`" msgstr "" #: ../../deprecated.rst:208 6ae4d97e8c5e4da99256aeead52810f1 msgid ":index:`updateStream` -- :meth:`Document.update_stream`" msgstr "" #: ../../deprecated.rst:209 73f4ed438af740348f883a9f36ca6474 msgid ":index:`wrapContents` -- :meth:`Page.wrap_contents`" msgstr "" #: ../../deprecated.rst:210 78a6c29c00914e158bb52d47d3e67380 msgid ":index:`writeImage` -- :meth:`Pixmap.save`" msgstr "" #: ../../deprecated.rst:211 43019b552508422699e7de4d4adc0be3 msgid ":index:`writePNG` -- :meth:`Pixmap.save`" msgstr "" #: ../../deprecated.rst:212 534c176a9f984bbba09535e897312f16 msgid ":index:`writeText` -- :meth:`Page.write_text`" msgstr "" #: ../../deprecated.rst:213 cd67b2d738be4ecd8d5087581b2752ec msgid ":index:`writeText` -- :meth:`TextWriter.write_text`" msgstr "" #: ../../deprecated.rst:214 63dbb736b48743d28f2b8f6a1feac7f0 msgid ":index:`xrefLength` -- :meth:`Document.xref_length`" msgstr "" #: ../../deprecated.rst:215 e817cc360dfe4f009e7c7b400c69193d msgid ":index:`xrefObject` -- :meth:`Document.xref_object`" msgstr "" #: ../../deprecated.rst:216 7c0ef03c3a82406985b37ac2a4840260 msgid ":index:`xrefStream` -- :meth:`Document.xref_stream`" msgstr "" #: ../../deprecated.rst:217 c3fdec8f544048ccbff884ecff95a30c msgid ":index:`xrefStreamRaw` -- :meth:`Document.xref_stream_raw`" msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/device.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 db41752d7d77475b91dce6987192b03e msgid "Artifex" msgstr "" #: ../../header.rst:-1 9d1395b42c0242c2937c063ec31289da msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 c674fa9ee73a4fcf888b701a69a14f4a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../device.rst:7 d8f699f2197d4cccb1a32e36349536c8 msgid "Device" msgstr "Device (デバイス)" #: ../../device.rst:9 c03889a987f445ea84d79f3d5abfb84d msgid "" "The different format handlers (pdf, xps, etc.) interpret pages to a " "\"device\". Devices are the basis for everything that can be done with a " "page: rendering, text extraction and searching. The device type is " "determined by the selected construction method." msgstr "" "異なるフォーマットハンドラ（pdf、xps " "など）はページを「デバイス」に解釈します。デバイスはページで行うすべてのことの基盤であり、レンダリング、テキスト抽出、検索などが行えます。デバイスのタイプは選択した構築方法によって決まります。" #: ../../device.rst:11 5997f573701045499919ec1f18ab7518 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../device.rst:17 4b9fd079e127474e94506fe9eadb79d7 msgid "Constructor for either a pixel map or a display list device." msgstr "ピクセルマップまたは表示リストデバイスのコンストラクタ。" #: ../../device.rst 3029384c54544ad783072064ea96675d #: ca7a504aacc440719aba0931b7724c60 msgid "Parameters" msgstr "" #: ../../device.rst:19 9b095106055b4d568344ac7d142034f3 msgid "either a ``Pixmap`` or a ``DisplayList``." msgstr "``Pixmap`` または ``DisplayList`` のいずれか。" #: ../../device.rst:22 30003de713004e58977091af11644238 msgid "" "An optional `IRect` for ``Pixmap`` devices to restrict rendering to a " "certain area of the page. If the complete page is required, specify " "``None``. For display list devices, this parameter must be omitted." msgstr "" "``Pixmap`` デバイス用の任意の `IRect` " "で、ページの特定の領域にレンダリングを制限するためのものです。完全なページが必要な場合は、``None`` " "を指定してください。表示リストデバイスの場合、このパラメータは省略する必要があります。" #: ../../device.rst:27 5a3223623124424ba115721d21086469 msgid "Constructor for a text page device." msgstr "テキストページデバイスのコンストラクタ。" #: ../../device.rst:29 8f77a7687a804d458ddb9a4be4624d77 msgid "``TextPage`` object" msgstr "TextPageオブジェクト" #: ../../device.rst:32 53c8b35c8b0e4e488b05cfbe1c988a0d #, fuzzy msgid "" "control the way how text is parsed into the text page. Currently 3 " "options can be coded into this parameter, see :ref:`TextPreserve`. To set" " these options use something like `flags=0 | TEXT_PRESERVE_LIGATURES | " "...`." msgstr "テキストがテキストページに解析される方法を制御するフラグです" #: ../../footer.rst:46 233763b8ff7c42718f2a5b6285c3802f msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/displaylist.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 85ee81383b5446bab311d8f7b3c8fcac msgid "Artifex" msgstr "" #: ../../header.rst:-1 2aadbeed28004bc5b1af3cafca54cd49 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 5f03ea6228c540d490e7e21dbe7a682e msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../displaylist.rst:7 ffd953b6fbc64a39866787a0edce72c2 msgid "DisplayList" msgstr "DisplayList（ディスプレイリスト）" #: ../../displaylist.rst:9 a98bdb15facb45eca03a302e65321649 msgid "" "DisplayList is a list containing drawing commands (text, images, etc.). " "The intent is two-fold:" msgstr "DisplayListは、描画コマンド（テキスト、画像など）を含むリストです。その目的は二つあります：" #: ../../displaylist.rst:11 f34b2f44389140eca2d21b0d7c566835 msgid "as a caching-mechanism to reduce parsing of a page" msgstr "ページのパースを削減するためのキャッシュメカニズムとして" #: ../../displaylist.rst:12 11fd7eeaa74c41e38f44f93fe53f799d msgid "" "as a data structure in multi-threading setups, where one thread parses " "the page and another one renders pages. This aspect is currently not " "supported by PyMuPDF." msgstr "ページをパースするスレッドとページをレンダリングする別のスレッドでのデータ構造として。この側面は現在、PyMuPDFではサポートされていません。" #: ../../displaylist.rst:14 f47fc55997964be8872823d0d68a9434 msgid "" "A display list is populated with objects from a page, usually by " "executing :meth:`Page.get_displaylist`. There also exists an independent " "constructor." msgstr "" "ディスプレイリストは通常、:meth:`Page.get_displaylist` " "を実行することによってページからオブジェクトで満たされます。また、独立したコンストラクタも存在します。" #: ../../displaylist.rst:16 478941b4f0a74dd5ac00af8a2e5de8e0 msgid "" "\"Replay\" the list (once or many times) by invoking one of its methods " ":meth:`~DisplayList.run`, :meth:`~DisplayList.get_pixmap` or " ":meth:`~DisplayList.get_textpage`." msgstr "" "このリストを（一度または複数回）再生するには、そのメソッドのうちのいずれかを呼び出します。:meth:`~DisplayList.run` " "、:meth:`~DisplayList.get_pixmap` 、または :meth:`~DisplayList.get_textpage` " "です。" #: ../../displaylist.rst:20 b035d30ab932458c89921fc2091ca6ed msgid "**Method**" msgstr "**メソッド** " #: ../../displaylist.rst:20 9ec33062cfa84f33adb5ca985df1b62a msgid "**Short Description**" msgstr "**短い説明** " #: ../../displaylist.rst:22 f063e9c7368a4d1bb4efbf9e02d9a7b0 msgid ":meth:`~DisplayList.run`" msgstr "" #: ../../displaylist.rst:22 916c809bdfae4d9b912c30cda33c7d3b msgid "Run a display list through a device." msgstr "ディスプレイリストをデバイスを介して実行します。" #: ../../displaylist.rst:23 a412fe84e6a943109a82c9872dc2a953 msgid ":meth:`~DisplayList.get_pixmap`" msgstr "" #: ../../displaylist.rst:23 b2523139914a4541a0c3f79442bf5c6f msgid "generate a pixmap" msgstr "ピクスマップを生成します。" #: ../../displaylist.rst:24 5bfdb590999b469981c332ada5769bbf msgid ":meth:`~DisplayList.get_textpage`" msgstr "" #: ../../displaylist.rst:24 24b92e98327b4214865e137898c355c1 msgid "generate a text page" msgstr "テキストページを生成します。" #: ../../displaylist.rst:25 758211c051284705afa9e186fdea6e54 msgid ":attr:`~DisplayList.rect`" msgstr "" #: ../../displaylist.rst:25 8247482dba784fabb5f89ce11f17a64c msgid "mediabox of the display list" msgstr "ディスプレイリストのメディアボックス（表示領域）です。" #: ../../displaylist.rst:29 879da44f5b924a8299e2cdf2daa64852 msgid "**Class API**" msgstr "**Class API（クラスAPI）** " #: ../../displaylist.rst:35 7024f17715094e0bac4657dc96d778fe msgid "Create a new display list." msgstr "新しいディスプレイリストを作成します。" #: ../../displaylist.rst 368347bd6e354c7286c6d761323614c6 #: 5cffa7e1860f48d2b2b02af84396e8b7 a68f36c6fdbd4638841bd4b5d14e01c5 #: fbf69acf127c475684179bebec45b555 msgid "Parameters" msgstr "パラメーター" #: ../../displaylist.rst:37 1a15f2e868934ebfbb706101234b942c msgid "The page's rectangle." msgstr "ページの矩形。" #: ../../displaylist.rst 4aa7e95bfb304eb786873dc128080192 #: 9628266c652c43e397ab17aff7b09d9a fdc8f4060e4044a4bba226ce56c05efe msgid "Return type" msgstr "戻り値の型" #: ../../displaylist.rst:40 136f549e2738445d8d830e101523615c msgid "``DisplayList``" msgstr "" #: ../../displaylist.rst:44 a708030e4a714162a183122ff845f300 msgid "" "Run the display list through a device. The device will populate the " "display list with its \"commands\" (i.e. text extraction or image " "creation). The display list can later be used to \"read\" a page many " "times without having to re-interpret it from the document file." msgstr "デバイスを介してディスプレイリストを実行します。デバイスはディスプレイリストをその「コマンド」（つまりテキストの抽出または画像の作成）で満たします。ディスプレイリストは後で文書ファイルから再解釈することなく、ページを多くの回数「読む」ために使用できます。" #: ../../displaylist.rst:46 4c8291909a844ff4a2f2ab416252270b msgid "" "You will most probably instead use one of the specialized run methods " "below -- :meth:`get_pixmap` or :meth:`get_textpage`." msgstr "" "おそらく、以下の専門の実行メソッドの1つを代わりに使用するでしょう - :meth:`get_pixmap` または " ":meth:`get_textpage` 。" #: ../../displaylist.rst:48 4f7a4933e8924fe0b4bf3ba52b68b918 msgid "Device" msgstr "デバイス" #: ../../displaylist.rst:51 c7fc73de742e46aaa1a3bfac323ffe52 msgid "Transformation matrix to apply to the display list contents." msgstr "ディスプレイリストのコンテンツに適用する変換行列。" #: ../../displaylist.rst:54 8d876f1c867a4ba9aab91aa8844f11ed msgid "" "Only the part visible within this area will be considered when the list " "is run through the device." msgstr "デバイスを介してリストを実行する際にこの領域内で可視部分のみが考慮されます。" #: ../../displaylist.rst:65 4cd71203402f42c084c05537b4069b8e msgid "Run the display list through a draw device and return a pixmap." msgstr "ディスプレイリストを描画デバイスを介して実行し、ピクスマップを返します。" #: ../../displaylist.rst:67 40ffabb8733d4c159fb9c1bf5f123b7a msgid "matrix to use. Default is the identity matrix." msgstr "使用する行列。デフォルトは単位行列です。" #: ../../displaylist.rst:70 9f80e04939df4e869a6aae307600f9b9 msgid "the desired colorspace. Default is RGB." msgstr "望ましいカラースペース。デフォルトはRGBです。" #: ../../displaylist.rst:73 004942119bb548268104bdbf345c6626 msgid "determine whether or not (0, default) to include a transparency channel." msgstr "透明チャネルを含めるかどうかを決定します（0、デフォルトは含めない）。" #: ../../displaylist.rst:75 63499de6adb349218d9c228d37571c9b msgid "" "restrict rendering to the intersection of this area with " ":attr:`DisplayList.rect`." msgstr ":attr:`DisplayList.rect` との交差部分にレンダリングを制限します。" #: ../../displaylist.rst:77 2b4519ceb62d4ff5aaf26469b6ad27e7 msgid ":ref:`Pixmap`" msgstr "" #: ../../displaylist.rst 9e12b4a400bd4f28a64154727e1341e8 #: dfd4f14a1c4c40b4b4593b30d2801610 msgid "Returns" msgstr "戻り値" #: ../../displaylist.rst:78 4d9e816a554e498f8b4ced5ead7fae63 msgid "pixmap of the display list." msgstr "ディスプレイリストのピクスマップ。" #: ../../displaylist.rst:82 d201e153d5a74b6286a3f24dd07771e4 msgid "Run the display list through a text device and return a text page." msgstr "ディスプレイリストをテキストデバイスを介して実行し、テキストページを返します。" #: ../../displaylist.rst:84 f7168bc2140948b1b23ee9a6555aa19c msgid "" "control which information is parsed into a text page. Default value in " "PyMuPDF is `3 = TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE`, i.e." " :data:`ligatures` are **passed through**, white spaces are **passed " "through** (not translated to spaces), and images are **not included**. " "See :ref:`TextPreserve`." msgstr "" "テキストページに解析される情報を制御します。PyMuPDFのデフォルト値は `3 = TEXT_PRESERVE_LIGATURES | " "TEXT_PRESERVE_WHITESPACE` です。つまり、:data:`ligatures` はそのまま **通過** し、空白はそのまま" " **通過** します（スペースに変換されません）、画像は **含まれません** 。:ref:`TextPreserve` を参照してください。" #: ../../displaylist.rst:86 331d9ffb9e2c41b2a7aa918985944d03 msgid ":ref:`TextPage`" msgstr "" #: ../../displaylist.rst:87 9a3d633bb3b9470e9633979dc60e32db msgid "text page of the display list." msgstr "ディスプレイリストのテキストページ。" #: ../../displaylist.rst:91 a0532ee2b43e4881966b65e83c28a1f5 msgid "" "Contains the display list's mediabox. This will equal the page's " "rectangle if it was created via :meth:`Page.get_displaylist`." msgstr "" "ディスプレイリストのmediaboxを含みます。これは、:meth:`Page.get_displaylist` " "を介して作成された場合、ページの矩形と等しいです。" #: ../../displaylist.rst 027bab9cbfe6488eb3f5cf5818313a0e msgid "type" msgstr "" #: ../../displaylist.rst:93 3a0e088ac75d4a128417cd79855b6777 msgid ":ref:`Rect`" msgstr "" #: ../../footer.rst:60 5f7c2ee2445b4bd69c561fa6fb3cf797 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/document-writer-class.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a8b3ae3a5d614d1e8729320973185b23 msgid "Artifex" msgstr "" #: ../../header.rst:-1 fdd48e8301e84183b56ee383e825d1d8 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 ee68e630d503448088146398fe92de3e msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../document-writer-class.rst:7 2e25f1ee520c42cd915962f032064cf1 msgid "DocumentWriter" msgstr "DocumentWriter(ドキュメントライター)" #: ../../document-writer-class.rst:9 9c9bc94001de467cb49c9bf4b7b82cfc msgid "|pdf_only_class|" msgstr "PDFのみ。" #: ../../document-writer-class.rst:12 0d6e81eab559420a9cb87ac6aab3fea5 msgid "New in v1.21.0" msgstr "バージョン1.21.0で導入" #: ../../document-writer-class.rst:14 b10e3b014d11420d87f829cd717b0cd1 msgid "" "This class represents a utility which can output various :ref:`document " "types supported by PyMuPDF`." msgstr "" "このクラスは、MuPDFで :ref:`サポートされている ` " "さまざまなドキュメントタイプを出力できるユーティリティを表します。" #: ../../document-writer-class.rst:16 9c4bec500209410f8b4cbcf2371d35db msgid "" "In |PyMuPDF| only used for outputting PDF documents whose pages are " "populated by :ref:`Story` DOMs." msgstr "" "PyMuPDFでは、:ref:`Story` " "DOM（ドキュメントオブジェクトモデル）でページが埋められたPDFドキュメントを出力するためにのみ使用されます。" #: ../../document-writer-class.rst:18 9871fdeac3864a2da5273e4540a0a267 msgid "" "Using DocumentWriter_ also for other document types might happen in the " "future." msgstr "将来的には、DocumentWriter_ を他のドキュメントタイプにも使用することがあるかもしれません。" #: ../../document-writer-class.rst:21 9968d643215c4572b41cf341313b8f65 msgid "**Method / Attribute**" msgstr "**メソッド/属性** " #: ../../document-writer-class.rst:21 606c7ae0f2594eddbe42178bb8644d9a msgid "**Short Description**" msgstr "**簡単な説明** " #: ../../document-writer-class.rst:23 50c0babb7b8840198f03c08d30e9d3c5 msgid ":meth:`DocumentWriter.begin_page`" msgstr "" #: ../../document-writer-class.rst:23 3bb196d61c3a4aa0b7994d563be77f25 msgid "start a new output page" msgstr "新しい出力ページを開始します。" #: ../../document-writer-class.rst:24 1f63440a5b0e4d6ea6e75dda50dddea3 msgid ":meth:`DocumentWriter.end_page`" msgstr "" #: ../../document-writer-class.rst:24 10f5e50934fe4657a5d2600346ceafcf msgid "finish the current output page" msgstr "現在の出力ページを終了します。" #: ../../document-writer-class.rst:25 b0dad4d0d79645819b89624337d71ac9 msgid ":meth:`DocumentWriter.close`" msgstr "" #: ../../document-writer-class.rst:25 7fbb29ccb4b845ec90dd86ccb30df13f msgid "flush pending output and close the file" msgstr "保留中の出力をフラッシュし、ファイルを閉じます。" #: ../../document-writer-class.rst:28 1c4c83c4a8944dd48400b056f6f197d2 msgid "**Class API**" msgstr "**クラスAPI** " #: ../../document-writer-class.rst:34 b3f94e8ec90e4ea783dc2ad85b3a4c37 msgid "" "Create a document writer object, passing a Python file pointer or a file " "path. Options to use when saving the file may also be passed." msgstr "Pythonファイルポインタまたはファイルパスを渡してドキュメントライターオブジェクトを作成します。ファイルを保存する際に使用するオプションも渡すことができます。" #: ../../document-writer-class.rst:36 8c30ef19be644ae4acdc8aa962a11f4b msgid "This class can also be used as a Python context manager." msgstr "このクラスはPythonのコンテキストマネージャとしても使用できます。" #: ../../document-writer-class.rst 269746a16d004bdba23418807f5f2e30 #: d6b77987b178432f8bf67e15280f52aa msgid "Parameters" msgstr "" #: ../../document-writer-class.rst:38 397489f724624b7e9532d6d269dd6670 msgid "" "the output file. This may be a string file name, or any Python file " "pointer. .. note:: By using a `io.BytesIO()` object as file pointer, a " "document writer can create a PDF in memory. Subsequently, this PDF can be" " re-opened for input and be further manipulated. This technique is used " "by several example scripts in :ref:`Stories recipes`." msgstr "" #: ../../document-writer-class.rst:38 05e9879e1f4b4ae59a5e41c552e922db msgid "" "the output file. This may be a string file name, or any Python file " "pointer." msgstr "出力ファイル。これは文字列のファイル名またはPythonファイルポインタのいずれかです。" #: ../../document-writer-class.rst:40 37022195f8fe44c0806b5b19a88bcd4c msgid "" "By using a `io.BytesIO()` object as file pointer, a document writer can " "create a PDF in memory. Subsequently, this PDF can be re-opened for input" " and be further manipulated. This technique is used by several example " "scripts in :ref:`Stories recipes`." msgstr "" "`io.BytesIO()` " "オブジェクトをファイルポインタとして使用することで、ドキュメントライターはメモリ内にPDFを作成できます。その後、このPDFは入力用に再オープンしてさらに操作できます。これは、:ref:`Storiesレシピ`" " のいくつかのサンプルスクリプトで使用されています。" #: ../../document-writer-class.rst:42 76a68fdef51c4889b0ad25785985c8b1 msgid "" "specify saving options for the output PDF. Typical are \"compress\" or " "\"clean\". More possible values may be taken from help output of the " "`mutool convert` CLI utility." msgstr "" "出力PDFの保存オプションを指定します。一般的なものは「compress」や「clean」です。その他の可能な値は、`mutool " "convert` CLI ユーティリティのヘルプ出力から取得できます。" #: ../../document-writer-class.rst:46 26994c9b27a84276951802359dd085d9 msgid "Start a new output page of a given dimension." msgstr "指定された寸法の新しい出力ページを開始します。" #: ../../document-writer-class.rst:48 76ed5effaf3f494e924c1e4409c325a4 msgid "" "a rectangle specifying the page size. After this method, output " "operations may write content to the page." msgstr "ページサイズを指定する矩形。このメソッドの後、出力操作はページにコンテンツを書き込むことができます。" #: ../../document-writer-class.rst:52 3ea8959411e545e6b5a8f32498bf303e msgid "" "Finish a page. This flushes any pending data and appends the page to the " "output document." msgstr "ページを終了します。保留中のデータをフラッシュし、ページを出力ドキュメントに追加します。" #: ../../document-writer-class.rst:56 444a43febca543608815926d8f431a3e msgid "" "Close the output file. This method is required for writing any pending " "data." msgstr "出力ファイルを閉じます。保留中のデータを書き込むためにこのメソッドが必要です。" #: ../../document-writer-class.rst:58 6f307923a0ba47a5a19b6b9a85f7bdc9 msgid "For usage examples consult the section of :ref:`Story`." msgstr "使用例については、:ref:`Story` のセクションを参照してください。" #: ../../footer.rst:60 0ad0cba35bcc45868f1d5640bc7e226b msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/document.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 43b4736175594b648a25f0be7fc42424 msgid "Artifex" msgstr "" #: ../../header.rst:-1 8a34ee99def04d0395e3977c82a70fb3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 bf3099d94f984c22b00ddb5b985eef67 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../document.rst:7 e9a8d6bb8a584459bedbb314700c7bc7 msgid "Document" msgstr "Document (ドキュメント)" #: ../../document.rst:11 3a88bb195d634bd1b5bd4e541a3d9a7e msgid "" "This class represents a document. It can be constructed from a file or " "from memory." msgstr "このクラスはドキュメントを表します。ファイルまたはメモリから構築することができます。" #: ../../document.rst:13 f093a1011e1247d4b515a122f0025bb6 msgid "" "There exists the alias *open* for this class, i.e. " "`pymupdf.Document(...)` and `pymupdf.open(...)` do exactly the same " "thing." msgstr "" "このクラスには *「open」* というエイリアスが存在し、つまり、 `pymupdf.Document(...)` と " "`pymupdf.open(...)` はまったく同じことを行います。" #: ../../document.rst:15 77bb8938b5534efcb6b05b4559346d2f msgid "For details on **embedded files** refer to Appendix 3." msgstr "**埋め込まれたファイル** の詳細については、付録3を参照してください。" #: ../../document.rst:19 ed504bde84854a89962d6285ce0c78ac msgid "" "Starting with v1.17.0, a new page addressing mechanism for **EPUB files " "only** is supported. This document type is internally organized in " "chapters such that pages can most efficiently be found by their so-called" " \"location\". The location is a tuple *(chapter, pno)* consisting of the" " chapter number and the page number **in that chapter**. Both numbers are" " zero-based." msgstr "" "バージョン1.17.0から、 **EPUBファイル専用** " "の新しいページアドレッシングメカニズムがサポートされています。このドキュメントタイプは、ページがその「場所」によって最も効率的に見つけられるように、章ごとに内部的に組織されています。場所は" " *（章、pno）* というタプルで構成され、章番号と **その章の中** のページ番号を指します。どちらの番号もゼロベースです。" #: ../../document.rst:21 15f2eedab10243529b4aa77b9b0c2f8b msgid "" "While it is still possible to locate a page via its (absolute) number, " "doing so may mean that the complete EPUB document must be laid out before" " the page can be addressed. This may have a significant performance " "impact if the document is very large. Using the page's *(chapter, pno)* " "prevents this from happening." msgstr "" "依然として（絶対的な）番号を使用してページを見つけることは可能ですが、これを行うとページにアクセスする前に完全なEPUBドキュメントをレイアウトする必要があるかもしれません。これはドキュメントが非常に大きい場合、重要なパフォーマンスの影響を持つ可能性があります。ページの" " *（章、pno）* を使用することで、これを防ぐことができます。" #: ../../document.rst:23 a9abb22b0c094890a8af3b64d7d76262 msgid "" "To maintain a consistent API, PyMuPDF supports the page *location* syntax" " for **all file types** -- documents without this feature simply have " "just one chapter. :meth:`Document.load_page` and the equivalent index " "access now also support a *location* argument." msgstr "" "一貫性のあるAPIを維持するために、PyMuPDFは **すべてのファイルタイプ** にページの場所構文をサポートしています - " "この機能のないドキュメントは単に1つの章を持っています。:meth:`Document.load_page` および同等のインデックスアクセスも " "*場所* 引数をサポートしています。" #: ../../document.rst:25 9d716392e88a47ecaad2863ac6b61457 msgid "" "There are a number of methods for converting between page numbers and " "locations, for determining the chapter count, the page count per chapter," " for computing the next and the previous locations, and the last page " "location of a document." msgstr "ページ番号と場所の間で変換するためのいくつかのメソッドがあり、章の数を決定するためのメソッド、章ごとのページ数を決定するためのメソッド、次の場所と前の場所を計算するためのメソッド、およびドキュメントの最後のページの場所を計算するためのメソッドがあります。" #: ../../document.rst:28 add4a5f06f184d7ebc7b45e419cb3a63 msgid "**Method / Attribute**" msgstr "**メソッド / 属性** " #: ../../document.rst:28 5b71e73348ff43b28c42f734ed068fbd msgid "**Short Description**" msgstr "**短い説明** " #: ../../document.rst:30 58a8217257e948d98b9b26ab120c3aea msgid ":meth:`Document.add_layer`" msgstr "" #: ../../document.rst:30 39da0dbb831848f1837f2799cac832e1 msgid "PDF only: make new optional content configuration" msgstr "PDFのみ：新しいオプションコンテンツ設定を作成" #: ../../document.rst:31 d82b8d9a76b246c0a8be037689fbfa06 msgid ":meth:`Document.add_ocg`" msgstr "" #: ../../document.rst:31 e5ebdc27906c4b5c8896ae1c353b4787 msgid "PDF only: add new optional content group" msgstr "PDFのみ：新しいオプションコンテンツグループを追加" #: ../../document.rst:32 e8f6741a63574c62b27f98b22177e828 msgid ":meth:`Document.authenticate`" msgstr "" #: ../../document.rst:32 defb0d7ebb00414b928eb0e592ae812e msgid "gain access to an encrypted document" msgstr "暗号化されたドキュメントへのアクセスを取得" #: ../../document.rst:33 b11af2c7c8694f3fa35bab1d987786a2 #, fuzzy msgid ":meth:`Document.bake`" msgstr ":meth:`Document.make_bookmark` によって作成されたもの。" #: ../../document.rst:33 cf7e8fd44e594a9c90ab7a1833253b0a msgid "PDF only: make annotations / fields permanent content" msgstr "PDFのみ：注釈やフォームフィールドを永続的なコンテンツに変換します" #: ../../document.rst:34 20cad3262c664426bb762687b9c4bbd9 msgid ":meth:`Document.can_save_incrementally`" msgstr "" #: ../../document.rst:34 7b023782514349ee95ef2e72917994c8 msgid "check if incremental save is possible" msgstr "インクリメンタルセーブが可能かどうかを確認" #: ../../document.rst:35 dc05c297ca0b4aefa1f1b7c427aa28c5 msgid ":meth:`Document.chapter_page_count`" msgstr "" #: ../../document.rst:35 4574736b834e4e998c95dfdb960afd78 msgid "number of pages in chapter" msgstr "章内のページ数" #: ../../document.rst:36 12d37dd646db4d7094ac889b471a0ef8 msgid ":meth:`Document.close`" msgstr "" #: ../../document.rst:36 4ce3e236e34a4972bcc35cabc61b8cb1 msgid "close the document" msgstr "ドキュメントを閉じる" #: ../../document.rst:37 1ba7c8f336184fe5bc4a0d56e99b08ec msgid ":meth:`Document.convert_to_pdf`" msgstr "" #: ../../document.rst:37 cc1e97d3992c4552aa43c0f0c4f6807b msgid "write a PDF version to memory" msgstr "PDFバージョンをメモリに書き込む" #: ../../document.rst:38 9d859e8c86fa4677925790093524225b msgid ":meth:`Document.copy_page`" msgstr "" #: ../../document.rst:38 466c568ee935410294a9e211b1e10040 msgid "PDF only: copy a page reference" msgstr "PDFのみ：ページの参照をコピー" #: ../../document.rst:39 3905e8ae3b06492b9fe02446094b4407 msgid ":meth:`Document.del_toc_item`" msgstr "" #: ../../document.rst:39 9fe2cfba44bd4f73abd8e1af06023fc4 msgid "PDF only: remove a single TOC item" msgstr "PDFのみ：単一のTOCアイテムを削除" #: ../../document.rst:40 2e8f53ae81b44437bb7e36151dfdf856 msgid ":meth:`Document.delete_page`" msgstr "" #: ../../document.rst:40 87da7bfbf0754384ad4bd489a1b62fb7 msgid "PDF only: delete a page" msgstr "PDFのみ：ページを削除" #: ../../document.rst:41 ac488459c0594d6cb9b355f29f9f1434 msgid ":meth:`Document.delete_pages`" msgstr "" #: ../../document.rst:41 5ef25e49d8ed498fb185e70e5bbff4e3 msgid "PDF only: delete multiple pages" msgstr "PDFのみ：複数のページを削除" #: ../../document.rst:42 c2175653712c47fca1ee1cfaba870c91 msgid ":meth:`Document.embfile_add`" msgstr "" #: ../../document.rst:42 5fcdd01035ed45c189614dd16f46d767 msgid "PDF only: add a new embedded file from buffer" msgstr "PDFのみ：バッファから新しい埋め込みファイルを追加" #: ../../document.rst:43 95b5b715b6224242a7dfafbc0041b9bd msgid ":meth:`Document.embfile_count`" msgstr "" #: ../../document.rst:43 8f3b00e038294a4aa1b2634f512da7dc msgid "PDF only: number of embedded files" msgstr "PDFのみ：埋め込みファイルの数" #: ../../document.rst:44 d39ae28e4b06484dac1e6ba1528cce4c msgid ":meth:`Document.embfile_del`" msgstr "" #: ../../document.rst:44 7649e79372904462bbdd49f9ab148373 msgid "PDF only: delete an embedded file entry" msgstr "PDFのみ：埋め込みファイルエントリを削除" #: ../../document.rst:45 964881d13cae457589969e927b3b7163 msgid ":meth:`Document.embfile_get`" msgstr "" #: ../../document.rst:45 93f0d4af7e2f49c08cd5565455a16206 msgid "PDF only: extract an embedded file buffer" msgstr "PDFのみ：埋め込みファイルバッファを抽出" #: ../../document.rst:46 e82abf28eaa84b889bf8baed0b1f0132 msgid ":meth:`Document.embfile_info`" msgstr "" #: ../../document.rst:46 5d46af817ace455296fb97fec4708e1d msgid "PDF only: metadata of an embedded file" msgstr "PDFのみ：埋め込みファイルのメタデータ" #: ../../document.rst:47 24b4158b60f6487290d8264abb16f507 msgid ":meth:`Document.embfile_names`" msgstr "" #: ../../document.rst:47 a79a87dd6905428b8c336bc3a5cbfe4c msgid "PDF only: list of embedded files" msgstr "PDFのみ：埋め込みファイルのリスト" #: ../../document.rst:48 d1405add281648888c3aec36f1efa31e msgid ":meth:`Document.embfile_upd`" msgstr "" #: ../../document.rst:48 3109aa1e33fe4baf82b62abfe73bf1c8 msgid "PDF only: change an embedded file" msgstr "PDFのみ：埋め込みファイルを変更" #: ../../document.rst:49 df47ab4f60c34106a30295d4248cecc3 msgid ":meth:`Document.extract_font`" msgstr "" #: ../../document.rst:49 a57f7fb1ecec44c1bef98124eabe2af5 msgid "PDF only: extract a font by :data:`xref`" msgstr "PDFのみ： :data:`xref` によるフォントの抽出" #: ../../document.rst:50 74fa6cb6cbf94754807bc74f0001e10c msgid ":meth:`Document.extract_image`" msgstr "" #: ../../document.rst:50 ff6d3d0e82a64512ad8964b9c9a0628b msgid "PDF only: extract an embedded image by :data:`xref`" msgstr "PDFのみ： :data:`xref` による埋め込み画像の抽出" #: ../../document.rst:51 78f28501b7974812a1cd4f5830cd36dc msgid ":meth:`Document.ez_save`" msgstr "" #: ../../document.rst:51 4a02f4a72a144d43b1754ec32416bb64 msgid "PDF only: :meth:`Document.save` with different defaults" msgstr "PDFのみ：異なるデフォルト値で :meth:`Document.save` を実行" #: ../../document.rst:52 3154749d16cf48fe96a7f9c8425bfbf6 msgid ":meth:`Document.find_bookmark`" msgstr "" #: ../../document.rst:52 143e38f832604238a5f900679410b485 msgid "retrieve page location after laid out document" msgstr "レイアウトされたドキュメント後のページ位置を取得" #: ../../document.rst:53 b271556405414cbaa9d1b57ab58b468c msgid ":meth:`Document.fullcopy_page`" msgstr "" #: ../../document.rst:53 e7f3a9b06b2c485c9be33faed6e5fe7c msgid "PDF only: duplicate a page" msgstr "PDFのみ：ページの複製" #: ../../document.rst:54 7bbeb29bdb63453191c3222b3e097f13 msgid ":meth:`Document.get_layer`" msgstr "" #: ../../document.rst:54 04bc7e5eed374ce89ccbc02847258286 msgid "PDF only: lists of OCGs in ON, OFF, RBGroups" msgstr "PDFのみ：ON、OFF、RBGroups内のOCGのリスト" #: ../../document.rst:55 970f7427be2f4166889a754bf4d7c025 msgid ":meth:`Document.get_layers`" msgstr "" #: ../../document.rst:55 5697cfd27e9d4b869c8dd5d641f0d33c msgid "PDF only: list of optional content configurations" msgstr "PDFのみ：オプションコンテンツ設定のリスト" #: ../../document.rst:56 78785446fbb14cc19554b28a594181f5 msgid ":meth:`Document.get_oc`" msgstr "" #: ../../document.rst:56 2556f20aa201451e8bf65b2c20eada2f msgid "PDF only: get OCG /OCMD xref of image / form xobject" msgstr "PDFのみ：画像/フォームオブジェクトのOCG / OCMD xrefを取得" #: ../../document.rst:57 258b50d4a33e45028451dc2a77148f6f msgid ":meth:`Document.get_ocgs`" msgstr "" #: ../../document.rst:57 afcf637c1119411594869f521a33bd71 msgid "PDF only: info on all optional content groups" msgstr "PDFのみ：すべてのオプションコンテンツグループの情報" #: ../../document.rst:58 b9e9fda4a6094db0b0ae6679e3068cce msgid ":meth:`Document.get_ocmd`" msgstr "" #: ../../document.rst:58 2f8facbc52ee427597b065b7b3e02635 msgid "PDF only: retrieve definition of an :data:`OCMD`" msgstr "PDFのみ： :data:`OCMD` の定義を取得" #: ../../document.rst:59 c07ac7981fea4d33bb0144049e3239ee msgid ":meth:`Document.get_page_fonts`" msgstr "" #: ../../document.rst:59 3236ca270e6648a08aba4bdba5284c5f msgid "PDF only: list of fonts referenced by a page" msgstr "PDFのみ：ページで参照されるフォントのリスト" #: ../../document.rst:60 644a31787f044848869b3f02a9340f62 msgid ":meth:`Document.get_page_images`" msgstr "" #: ../../document.rst:60 6c413f170ae84b1d869a89042deb238e msgid "PDF only: list of images referenced by a page" msgstr "PDFのみ：ページで参照される画像のリスト" #: ../../document.rst:61 0bed94104d8144f38c441256e6514eb2 msgid ":meth:`Document.get_page_labels`" msgstr "" #: ../../document.rst:61 41f65092ee164fc297f86373c5ab102b msgid "PDF only: list of page label definitions" msgstr "PDFのみ：ページラベルの定義のリスト" #: ../../document.rst:62 862369882af44617a8819906a976bc16 msgid ":meth:`Document.get_page_numbers`" msgstr "" #: ../../document.rst:62 8615e9cd79d941a78c49c2ce9ac0c575 msgid "PDF only: get page numbers having a given label" msgstr "PDFのみ：指定されたラベルを持つページ番号を取得" #: ../../document.rst:63 dad59db4773e4ee9a396ad31b592ad81 msgid ":meth:`Document.get_page_pixmap`" msgstr "" #: ../../document.rst:63 cbe4b263ffeb44519224759f35a7b530 msgid "create a pixmap of a page by page number" msgstr "ページ番号によるページのピクスマップの作成" #: ../../document.rst:64 876f95670aed4e86bbdd960315d3bc1b msgid ":meth:`Document.get_page_text`" msgstr "" #: ../../document.rst:64 be31a13a38bd43c6913b7a80c953ee33 msgid "extract the text of a page by page number" msgstr "ページ番号によるページのテキストの抽出" #: ../../document.rst:65 978642d705ed459086758fef87cc6513 msgid ":meth:`Document.get_page_xobjects`" msgstr "" #: ../../document.rst:65 9ce6ba28bcd84aa2a35ce24bb1699f48 msgid "PDF only: list of XObjects referenced by a page" msgstr "PDFのみ：ページで参照されるXObjectのリスト" #: ../../document.rst:66 b597ff3290d34f83bf1b564ee7d148f8 msgid ":meth:`Document.get_sigflags`" msgstr "" #: ../../document.rst:66 16ae9c3a7a1e428283fdbab18375d352 msgid "PDF only: determine signature state" msgstr "PDFのみ：署名状態を確認" #: ../../document.rst:67 87689643a05c46b4868a2969cda519ea msgid ":meth:`Document.get_toc`" msgstr "" #: ../../document.rst:67 031806a18b7d4bc0a5ca012eda1b7dbb msgid "extract the table of contents" msgstr "目次を抽出" #: ../../document.rst:68 5cfc41d652204ddc955125491bc8ba44 msgid ":meth:`Document.get_xml_metadata`" msgstr "" #: ../../document.rst:68 08d4b18bcfad4ff28f56780ac161ad6d msgid "PDF only: read the XML metadata" msgstr "PDFのみ：XMLメタデータを読み込む" #: ../../document.rst:69 ff2b33d4bb2c42f4bb77426a3e22dbd7 msgid ":meth:`Document.has_annots`" msgstr "" #: ../../document.rst:69 1e8a505220e24e65a8c808697aa64afa msgid "PDF only: check if PDF contains any annots" msgstr "PDFのみ：PDFに注釈が含まれているかを確認" #: ../../document.rst:70 38f7a0c4a98d4ecb90798f4830568061 msgid ":meth:`Document.has_links`" msgstr "" #: ../../document.rst:70 948d1a0444544a568098d8f5abcbe626 msgid "PDF only: check if PDF contains any links" msgstr "PDFのみ：PDFにリンクが含まれているかを確認" #: ../../document.rst:71 d1ce6cf6cce1457caabc424ad112e57e msgid ":meth:`Document.insert_page`" msgstr "" #: ../../document.rst:71 fff75002fe13475b84fc3f18e1ff8ada msgid "PDF only: insert a new page" msgstr "PDFのみ：新しいページを挿入" #: ../../document.rst:72 cf8bb81eaa8a48ea9d5a1fbdc1a7ab5a msgid ":meth:`Document.insert_pdf`" msgstr "" #: ../../document.rst:72 289d2e5d58fe42a1a42bcf72bf0d6ff8 msgid "PDF only: insert pages from another PDF" msgstr "PDFのみ：別のPDFからページを挿入" #: ../../document.rst:73 8cd752947d534369a28e538b9fb6853c msgid ":meth:`Document.insert_file`" msgstr "" #: ../../document.rst:73 5cc1ad88bf844c96bf15f6586fd84cb8 msgid "PDF only: insert pages from arbitrary document" msgstr "PDFのみ：任意のドキュメントからページを挿入" #: ../../document.rst:74 8178801a98ca4bfca4dc9b6ad47ba89f msgid ":meth:`Document.journal_can_do`" msgstr "" #: ../../document.rst:74 2c867cd421094f95bc050a133eafad70 msgid "PDF only: which journal actions are possible" msgstr "PDFのみ：どのジャーナルアクションが可能か" #: ../../document.rst:75 283b597442494a8ba9ae9b5bec8bd8fa msgid ":meth:`Document.journal_enable`" msgstr "" #: ../../document.rst:75 8416ce80179c432d8919be5ce1cb0af6 msgid "PDF only: enables journalling for the document" msgstr "PDFのみ：ドキュメントのジャーナルを有効にする" #: ../../document.rst:76 6b953871829946af9c2773facdc83609 msgid ":meth:`Document.journal_load`" msgstr "" #: ../../document.rst:76 180edecda8984b7cb87a6274ea19f89a msgid "PDF only: load journal from a file" msgstr "PDFのみ：ファイルからジャーナルを読み込む" #: ../../document.rst:77 8391be9d1b0441a0910e17782c0b15ef msgid ":meth:`Document.journal_op_name`" msgstr "" #: ../../document.rst:77 a817a795918345018097f192480ce45b msgid "PDF only: return name of a journalling step" msgstr "PDFのみ：ジャーナルステップの名前を返す" #: ../../document.rst:78 bdb35edbe9394a7fb719c39e4a98e434 msgid ":meth:`Document.journal_position`" msgstr "" #: ../../document.rst:78 22c8acf5b55d4901a0706583047f98ac msgid "PDF only: return journalling status" msgstr "PDFのみ：ジャーナリングステータスを返す" #: ../../document.rst:79 bfb92de11a49415b9a637a6bdd41a08a msgid ":meth:`Document.journal_redo`" msgstr "" #: ../../document.rst:79 941f312fd6dc434bb3e7bb22b43982f9 msgid "PDF only: redo current operation" msgstr "PDFのみ：現在の操作をやり直す" #: ../../document.rst:80 e39c415d7d064a2ebd5d1597dbd8837e msgid ":meth:`Document.journal_save`" msgstr "" #: ../../document.rst:80 b584d240bee04b9d8dbaa84d5f8ace78 msgid "PDF only: save journal to a file" msgstr "PDFのみ：ジャーナルをファイルに保存" #: ../../document.rst:81 377ee634b1b64808a581ac868f85eae3 msgid ":meth:`Document.journal_start_op`" msgstr "" #: ../../document.rst:81 a0ca366002234f6886d132221ae925fc msgid "PDF only: start an \"operation\" giving it a name" msgstr "PDFのみ：名前を付けて「操作」を開始" #: ../../document.rst:82 10f762396c4f489d8414e1f85d21c394 msgid ":meth:`Document.journal_stop_op`" msgstr "" #: ../../document.rst:82 ba97728a122047fd83681c7e71538f60 msgid "PDF only: end current operation" msgstr "PDFのみ：現在の操作を終了" #: ../../document.rst:83 84244b3958754e2f8e60e088d4e9eaf8 msgid ":meth:`Document.journal_undo`" msgstr "" #: ../../document.rst:83 ac3708bf674842c5802292badc7ce153 msgid "PDF only: undo current operation" msgstr "PDFのみ：現在の操作を元に戻す" #: ../../document.rst:84 e59cb5b39d03491fb5bae5b59bbfcb28 msgid ":meth:`Document.layer_ui_configs`" msgstr "" #: ../../document.rst:84 d9375c2112274868896c4d42fc331428 msgid "PDF only: list of optional content intents" msgstr "PDFのみ：オプションコンテンツインテントのリスト" #: ../../document.rst:85 407287d007564aa49ddd7d761d16a854 msgid ":meth:`Document.layout`" msgstr "" #: ../../document.rst:85 24b905752b8f4103b44d7a072952a14d msgid "re-paginate the document (if supported)" msgstr "ドキュメントを再ページ化（サポートされている場合）" #: ../../document.rst:86 05540cbb5a6844d2b0066a9329eec704 msgid ":meth:`Document.load_page`" msgstr "" #: ../../document.rst:86 d027aa3f5e7f40449d955369ac59be65 msgid "read a page" msgstr "ページを読み込む" #: ../../document.rst:87 0f4a3571b20e46c8a8b0a056ca69d9c4 msgid ":meth:`Document.make_bookmark`" msgstr "" #: ../../document.rst:87 3b3bccdfd1ea485b9725001d0321b5c5 msgid "create a page pointer in reflowable documents" msgstr "リフローアブルドキュメント内でページポインタを作成" #: ../../document.rst:88 41b1ca13914b4f2c945a7fed504d9517 msgid ":meth:`Document.move_page`" msgstr "" #: ../../document.rst:88 00c89823b1274ff99f648f5b2c87ef02 msgid "PDF only: move a page to different location in doc" msgstr "PDFのみ：ページをドキュメント内の異なる場所に移動" #: ../../document.rst:89 e84ed54f2d154b439faeaab883f5e93b msgid ":meth:`Document.need_appearances`" msgstr "" #: ../../document.rst:89 676fd03bdf7e409b984fe0faa6d88a76 msgid "PDF only: get/set `/NeedAppearances` property" msgstr "PDFのみ： `/NeedAppearances` プロパティを取得/設定" #: ../../document.rst:90 669abfabfa6b490aae5c20a6028b2af7 msgid ":meth:`Document.new_page`" msgstr "" #: ../../document.rst:90 8535930473244385bd64d7584523da86 msgid "PDF only: insert a new empty page" msgstr "PDFのみ：新しい空白ページを挿入" #: ../../document.rst:91 8706fe76caf44c4a9380d5fc92e71903 msgid ":meth:`Document.next_location`" msgstr "" #: ../../document.rst:91 da98e11be3fc4193abf54b8f9d212634 msgid "return (chapter, pno) of following page" msgstr "次のページの（章、pno）" #: ../../document.rst:92 22873ddadc3b468c8092ae45a23efe56 msgid ":meth:`Document.outline_xref`" msgstr "" #: ../../document.rst:92 939075b4724544878a76f87d8dd1283e msgid "PDF only: :data:`xref` a TOC item" msgstr "PDFのみ：TOCアイテムを :data:`xref` " #: ../../document.rst:93 6722c38d0d78497091278cbd1e7b0d6b msgid ":meth:`Document.page_cropbox`" msgstr "" #: ../../document.rst:93 04b54737e5ca450ca0f3e1483639382d msgid "PDF only: the unrotated page rectangle" msgstr "PDFのみ：回転していないページの矩形" #: ../../document.rst:94 af8716cd59ac46be87f21422bc3f8c5e msgid ":meth:`Document.page_xref`" msgstr "" #: ../../document.rst:94 caf5f921388245b5b5f9b49940c056a7 msgid "PDF only: :data:`xref` of a page number" msgstr "PDFのみ：ページ番号の :data:`xref`" #: ../../document.rst:95 571b7ea1b2ed4a0da1e2203deda7aa8d msgid ":meth:`Document.pages`" msgstr "" #: ../../document.rst:95 278ecce412fc4bc58337a84b851ec028 msgid "iterator over a page range" msgstr "ページ範囲のイテレータ" #: ../../document.rst:96 b85d12a3953342a89d8ffe83eb92ebf9 msgid ":meth:`Document.pdf_catalog`" msgstr "" #: ../../document.rst:96 14e5593718754a4da76d72a4bd33e7bd msgid "PDF only: :data:`xref` of catalog (root)" msgstr "PDFのみ：カタログ（ルート）の :data:`xref` " #: ../../document.rst:97 c11a1743ca684d3ca89d53ff36f33438 msgid ":meth:`Document.pdf_trailer`" msgstr "" #: ../../document.rst:97 8108cc2e14de4c0c948f8ea439c4819c msgid "PDF only: trailer source" msgstr "PDFのみ：トレイラーソース" #: ../../document.rst:98 b323bdef35c64155905c4cc4403eac19 msgid ":meth:`Document.prev_location`" msgstr "" #: ../../document.rst:98 7617a1f4aac44dddbcc6f92b8d6c45c0 msgid "return (chapter, pno) of preceding page" msgstr "前のページの（章、pno）を返す" #: ../../document.rst:99 dedcbf0566f74df9aad30be8105ef527 #, fuzzy msgid ":meth:`Document.rewrite_images`" msgstr ":meth:`Document.make_bookmark` によって作成されたもの。" #: ../../document.rst:99 974b6b3159ed459e8e279788df4cced8 msgid "PDF only: rewrite / extra compression for images" msgstr "" #: ../../document.rst:100 d2f820953f0446d8be040f143bfd61fb #, fuzzy msgid ":meth:`Document.recolor`" msgstr ":meth:`Document.make_bookmark` によって作成されたもの。" #: ../../document.rst:100 feaa2f0d59f5474facff3305163251d5 msgid "PDF only: execute :meth:`Page.recolor` for all pages" msgstr "" #: ../../document.rst:101 51ab18b8dc104059b4b26a3cc37ee5a2 msgid ":meth:`Document.reload_page`" msgstr "" #: ../../document.rst:101 82cadc34466a4036abf146722491a023 msgid "PDF only: provide a new copy of a page" msgstr "PDFのみ：ページの新しいコピーを提供" #: ../../document.rst:102 ba53f93a3acc4fbd883b60252e16bf2d msgid ":meth:`Document.resolve_names`" msgstr "" #: ../../document.rst:102 ea55d63d05fa4c9b897eac4f3ec3a2e4 msgid "PDF only: Convert destination names into a Python dict" msgstr "PDFのみ: ページの目的地名をPythonの辞書に変換します" #: ../../document.rst:103 1f12d96d086840e0b6a9c584969fe937 msgid ":meth:`Document.save`" msgstr "" #: ../../document.rst:103 bcb05fe7cc084d47a2a47419224e8e50 msgid "PDF only: save the document" msgstr "PDFのみ：ドキュメントを保存" #: ../../document.rst:104 c17d570731634e2899a9fef7b19f17b8 msgid ":meth:`Document.saveIncr`" msgstr "" #: ../../document.rst:104 c0269e939b344fd597a6956b62bbf2bb msgid "PDF only: save the document incrementally" msgstr "PDFのみ：ドキュメントを増分保存" #: ../../document.rst:105 96f92a2b46f64f5d93f97b5e38e2e0a7 msgid ":meth:`Document.scrub`" msgstr "" #: ../../document.rst:105 1ded1c45911c40bb88b0e8789286f7a1 msgid "PDF only: remove sensitive data" msgstr "PDFのみ：機密データを削除" #: ../../document.rst:106 f6dacc40814f47b2a61ebd3fef801051 msgid ":meth:`Document.search_page_for`" msgstr "" #: ../../document.rst:106 f416a3e245d2413e9b92e1ac94a34eb9 msgid "search for a string on a page" msgstr "ページ上で文字列を検索" #: ../../document.rst:107 5b7fa0d81fc6489fb3aa22c2f9532987 msgid ":meth:`Document.select`" msgstr "" #: ../../document.rst:107 1b7f3ad42e3748a9bc0b1c819ebfb37f msgid "PDF only: select a subset of pages" msgstr "PDFのみ：ページのサブセットを選択" #: ../../document.rst:108 a1bef9a0f9aa4faf97bc5a4d7dd2c439 msgid ":meth:`Document.set_layer_ui_config`" msgstr "" #: ../../document.rst:108 4cabc4e8de1547b6933c5571b6715a17 msgid "PDF only: set OCG visibility temporarily" msgstr "PDFのみ：一時的にOCGの表示を設定" #: ../../document.rst:109 8f9c6e7f590c4b078b22910ae021833f msgid ":meth:`Document.set_layer`" msgstr "" #: ../../document.rst:109 cccc69e7410e4bb695682ffd1ad32d9f msgid "PDF only: mass changing OCG states" msgstr "PDFのみ：OCGステータスを一括変更" #: ../../document.rst:110 05d50371618b43b4aa923361a11eb0b5 msgid ":meth:`Document.set_markinfo`" msgstr "" #: ../../document.rst:110 a7ac2c7a68e546a49bd24c64b96a58e6 msgid "PDF only: set the MarkInfo values" msgstr "PDFのみ：MarkInfoの値を設定" #: ../../document.rst:111 b936b94e1de847abaf79d0a2b034e2bc msgid ":meth:`Document.set_metadata`" msgstr "" #: ../../document.rst:111 ab7be95036d144ae96c077e8c019ae15 msgid "PDF only: set the metadata" msgstr "PDFのみ：メタデータを設定" #: ../../document.rst:112 e1375d72fe6846d9a08e10a4ee9927c7 msgid ":meth:`Document.set_oc`" msgstr "" #: ../../document.rst:112 f3c50c202d7c4cdf837fb18d8b5c40cf msgid "PDF only: attach OCG/OCMD to image / form xobject" msgstr "PDFのみ：画像/フォームオブジェクトにOCG/OCMDを添付" #: ../../document.rst:113 2fdc13211d934a72829f8f6851b833e5 msgid ":meth:`Document.set_ocmd`" msgstr "" #: ../../document.rst:113 77f29139986644ce953f3f1afce1e36c msgid "PDF only: create or update an :data:`OCMD`" msgstr "PDFのみ：:data:`OCMD` を作成または更新" #: ../../document.rst:114 56b1be1913b8456b8af7a92efb5bce6c msgid ":meth:`Document.set_page_labels`" msgstr "" #: ../../document.rst:114 e2ee4ffee5244f369f11d507a9b056ac msgid "PDF only: add/update page label definitions" msgstr "PDFのみ：ページラベルの定義を追加/更新" #: ../../document.rst:115 2a236deda376461d8e02dd777aa86a45 msgid ":meth:`Document.set_pagemode`" msgstr "" #: ../../document.rst:115 11e3ef0ce8e7442c849b83550cdd06e9 msgid "PDF only: set the PageMode" msgstr "PDFのみ：PageModeを設定" #: ../../document.rst:116 32bd955e107e410b89537cae1c991d61 msgid ":meth:`Document.set_pagelayout`" msgstr "" #: ../../document.rst:116 4a6c5debab1643529562d2e5e7f9ec92 msgid "PDF only: set the PageLayout" msgstr "PDFのみ：PageLayoutを設定" #: ../../document.rst:117 2144e914bdaf45a399949c3c3df56bb5 msgid ":meth:`Document.set_toc_item`" msgstr "" #: ../../document.rst:117 c03b6a76e34d4c29b288cefc04600f0d msgid "PDF only: change a single TOC item" msgstr "PDFのみ：単一のTOCアイテムを変更" #: ../../document.rst:118 f8fd3e681d2e40dbbd45e3b30913de56 msgid ":meth:`Document.set_toc`" msgstr "" #: ../../document.rst:118 c25e27e0effa448d8988947b633e20cb msgid "PDF only: set the table of contents (TOC)" msgstr "PDFのみ：目次（TOC）を設定" #: ../../document.rst:119 a304c7f00f824dd88396f97ef442c347 msgid ":meth:`Document.set_xml_metadata`" msgstr "" #: ../../document.rst:119 e2419cc26cce4233b4a8273cac482f57 msgid "PDF only: create or update document XML metadata" msgstr "PDFのみ：ドキュメントXMLメタデータを作成または更新" #: ../../document.rst:120 2e11620ea9d6476e9a56a93b2c3c2d5d msgid ":meth:`Document.subset_fonts`" msgstr "" #: ../../document.rst:120 ae59a4fbc18b440eb2a7542d14a4c882 msgid "PDF only: create font subsets" msgstr "PDFのみ：フォントのサブセットを作成" #: ../../document.rst:121 85fa8be173614f9395fad32a48d9021b msgid ":meth:`Document.switch_layer`" msgstr "" #: ../../document.rst:121 e2bf17afb8eb44fb8d394c7da1b04185 msgid "PDF only: activate OC configuration" msgstr "PDFのみ：OC設定をアクティブ化" #: ../../document.rst:122 7cf8c2ba034d430383e1bbf0dfe7f8e5 msgid ":meth:`Document.tobytes`" msgstr "" #: ../../document.rst:122 96ef34ce12fa4117920b6d9a451bfec0 msgid "PDF only: writes document to memory" msgstr "PDFのみ：ドキュメントをメモリに書き込む" #: ../../document.rst:123 9c18cc7be02846ceabcc47cb305f4e32 msgid ":meth:`Document.xref_copy`" msgstr "" #: ../../document.rst:123 1d344c6f485149d08e8cbcb30f14bbfd msgid "PDF only: copy a PDF dictionary to another :data:`xref`" msgstr "PDFのみ：PDF辞書を別の :data:`xref` にコピー" #: ../../document.rst:124 d40fcf719f7745d0988864bbd78a0702 msgid ":meth:`Document.xref_get_key`" msgstr "" #: ../../document.rst:124 73c52ddd3eee43a0a4ee02fd0c0654c6 msgid "PDF only: get the value of a dictionary key" msgstr "PDFのみ：辞書キーの値を取得" #: ../../document.rst:125 573343d13a364c9c8d257a1d98a89f3e msgid ":meth:`Document.xref_get_keys`" msgstr "" #: ../../document.rst:125 81c53f9f870f4f59a618391c6a2cb5c4 msgid "PDF only: list the keys of object at :data:`xref`" msgstr "PDFのみ： :data:`xref` のオブジェクトのキーをリスト" #: ../../document.rst:126 76398d72d880411cb46bd73eda703503 msgid ":meth:`Document.xref_object`" msgstr "" #: ../../document.rst:126 53a6e32b9e6b411ebcf5c8e3f096bd6c msgid "PDF only: get the definition source of :data:`xref`" msgstr "PDFのみ：:data:`xref` の定義ソースを取得" #: ../../document.rst:127 e66235038073450c9f5a839095cac4c4 msgid ":meth:`Document.xref_set_key`" msgstr "" #: ../../document.rst:127 8204850e62a846f88fbffa42e2637b9a msgid "PDF only: set the value of a dictionary key" msgstr "PDFのみ：辞書キーの値を設定" #: ../../document.rst:128 fd30d01999014bbab567b38ddb4353f0 msgid ":meth:`Document.xref_stream_raw`" msgstr "" #: ../../document.rst:128 99ccc2453ba946e7831daec6b7581cf6 msgid "PDF only: raw stream source at :data:`xref`" msgstr "PDFのみ： :data:`xref` での生のストリームソース" #: ../../document.rst:129 413b3807f32f45a580cca989305c9008 msgid ":meth:`Document.xref_xml_metadata`" msgstr "" #: ../../document.rst:129 fe64670c8c334c77b851161354240171 msgid "PDF only: :data:`xref` of XML metadata" msgstr "PDFのみ： XMLメタデータの :data:`xref` " #: ../../document.rst:130 9db7fc2a6be446c9a0d597777ccb3db5 msgid ":attr:`Document.chapter_count`" msgstr "" #: ../../document.rst:130 d81d64b31cb94d3caeca06bd43e1e31e msgid "number of chapters" msgstr "章の数" #: ../../document.rst:131 88fa80583a8148bdb519161be5facabe msgid ":attr:`Document.FormFonts`" msgstr "" #: ../../document.rst:131 822a58355d084a57bf43f78079ad7109 msgid "PDF only: list of global widget fonts" msgstr "PDFのみ：グローバルウィジェットフォントのリスト" #: ../../document.rst:132 3187d844634044e2978d4d650d2b453e msgid ":attr:`Document.is_closed`" msgstr "" #: ../../document.rst:132 58a7a1c8d488427daf9b1a3fd1b0baa1 msgid "has document been closed?" msgstr "ドキュメントが閉じられていますか？" #: ../../document.rst:133 c6f2bfcdd3db47b9ae0572f8c6b52068 msgid ":attr:`Document.is_dirty`" msgstr "" #: ../../document.rst:133 c18fd15219484228bbb05b979d2fe93a msgid "PDF only: has document been changed yet?" msgstr "PDFのみ：ドキュメントは変更されましたか？" #: ../../document.rst:134 c0b6d32bf1e4495dbf4add91153500f6 msgid ":attr:`Document.is_encrypted`" msgstr "" #: ../../document.rst:134 8d7f114a51b14761b0bad0ab267c341c msgid "document (still) encrypted?" msgstr "ドキュメントは（まだ）暗号化されていますか？" #: ../../document.rst:135 1d1dc29fc5324c8b9c4c46188293b390 msgid ":attr:`Document.is_fast_webaccess`" msgstr "" #: ../../document.rst:135 e076fbc4f4f4419f8dfdbbc78e750bc2 msgid "is PDF linearized?" msgstr "PDFは線形化されていますか？" #: ../../document.rst:136 4c5d509be68646a2a5e6d9288e486e9d msgid ":attr:`Document.is_form_pdf`" msgstr "" #: ../../document.rst:136 7587e6c5fa74464484f04d42b82a8154 msgid "is this a Form PDF?" msgstr "これはフォームPDFですか？" #: ../../document.rst:137 fc1951f5f9b644eca1bf32692e0a1084 msgid ":attr:`Document.is_pdf`" msgstr "" #: ../../document.rst:137 6744e037129540b5a068f48e079dd435 msgid "is this a PDF?" msgstr "これはPDFですか？" #: ../../document.rst:138 03fdede084af4116b4d1587c067ff1f9 msgid ":attr:`Document.is_reflowable`" msgstr "" #: ../../document.rst:138 4a6c359253dd4c9690d177ea6a3b6683 msgid "is this a reflowable document?" msgstr "これはリフローアブルドキュメントですか？" #: ../../document.rst:139 26433c11990f4f1e902b967ec62f9520 msgid ":attr:`Document.is_repaired`" msgstr "" #: ../../document.rst:139 3c658c42265747b7b521caba0b46b998 msgid "PDF only: has this PDF been repaired during open?" msgstr "PDFのみ：このPDFは開いている間に修復されましたか？" #: ../../document.rst:140 cb53e80ca0614de784a45e404b379a60 msgid ":attr:`Document.last_location`" msgstr "" #: ../../document.rst:140 b7ace66466d54470b61071e9bfce414a msgid "(chapter, pno) of last page" msgstr "最後のページの（章、pno）" #: ../../document.rst:141 d4fd8a51760b4c4a964822cf87c4fd5b msgid ":attr:`Document.metadata`" msgstr "" #: ../../document.rst:141 e49fe7d5415b4ea0aa5ff965dea0a4c2 msgid "metadata" msgstr "メタデータ" #: ../../document.rst:142 b1eb281747194e0c9dc37769e5a35996 msgid ":attr:`Document.markinfo`" msgstr "" #: ../../document.rst:142 5c53ed8e5b3a43f790eb41430cf74c00 msgid "PDF MarkInfo value" msgstr "PDF MarkInfoの値" #: ../../document.rst:143 28f8419fd8854bc281aa1a7973a0d651 msgid ":attr:`Document.name`" msgstr "" #: ../../document.rst:143 c074932b6df14c2a9bbac171d00a72e1 msgid "filename of document" msgstr "ドキュメントのファイル名" #: ../../document.rst:144 c143ec8f77d7403ba2f5e950ada44f9f msgid ":attr:`Document.needs_pass`" msgstr "" #: ../../document.rst:144 3a653b354e264d5ab111c00c2150d5ce msgid "require password to access data?" msgstr "データにアクセスするにはパスワードが必要ですか？" #: ../../document.rst:145 57c337795d3b41af8567072e6b7cf577 msgid ":attr:`Document.outline`" msgstr "" #: ../../document.rst:145 4c478e059e5b4ac0ac83ee75ae7da76b msgid "first `Outline` item" msgstr "最初のアウトラインアイテム" #: ../../document.rst:146 396a4b645ae04c80b5961baa2e075796 msgid ":attr:`Document.page_count`" msgstr "" #: ../../document.rst:146 67b13af7113547a8918fa5f210dcfaeb msgid "number of pages" msgstr "ページ数" #: ../../document.rst:147 cd51b0df05524051bca654f008981df0 msgid ":attr:`Document.permissions`" msgstr "" #: ../../document.rst:147 f33c48f888124f82af9dc413e5f9a50e msgid "permissions to access the document" msgstr "ドキュメントへのアクセス権限" #: ../../document.rst:148 0868038137794381a564152619e1814b msgid ":attr:`Document.pagemode`" msgstr "" #: ../../document.rst:148 783f323a456349b186450d63549da121 msgid "PDF PageMode value" msgstr "PDF PageModeの値" #: ../../document.rst:149 032d2ee20d6542c4975ad6c7e2f75522 msgid ":attr:`Document.pagelayout`" msgstr "" #: ../../document.rst:149 d9816800d017496f8603c2fca0b2e1d0 msgid "PDF PageLayout value" msgstr "PDF PageLayoutの値" #: ../../document.rst:150 cf17ce8d51c043f3a964384ca0a92c53 msgid ":attr:`Document.version_count`" msgstr "" #: ../../document.rst:150 646aa6db9c8b4351b27593bdfaf5f24c msgid "PDF count of versions" msgstr "PDFバージョンの数" #: ../../document.rst:153 8f58511508294d49bd7a7f950c9bd7c9 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../document.rst:174 b482340231f44738bb9cf3c571f4f7d5 msgid "Create a ``Document`` object." msgstr "``Document`` オブジェクトを作成します。" #: ../../document.rst:176 1c55311b5fa64850a06598e2a8ce9a7c msgid "With default parameters, a **new empty PDF** document will be created." msgstr "デフォルトのパラメータを使用すると、**新しい空の PDF** ドキュメントが作成されます。" #: ../../document.rst:177 22c55c2d255f491f89be960f4babb5e5 msgid "If ``stream`` is given, then the document is created from memory." msgstr "``stream`` が指定された場合、ドキュメントはメモリから作成されます。" #: ../../document.rst:178 3a8f75233dd54040a52ad9ae44d26e74 msgid "" "If ``stream`` is `None`, then a document is created from the file given " "by ``filename``." msgstr "" "*stream* が `None` の場合、*filename* " "で指定されたファイルからドキュメントが作成されます。そのタイプは拡張子から推測されます。これは *filetype* によって上書きできます。" #: ../../document.rst 00a908e8a7684c1db0a3b35d910dfc89 #: 035c82154d7945aeaedacdae5ef9e83e 0494f5c7dd3e4dbdad753d8fc418426a #: 053524db9ab3421685fe89d78c566686 09e2f20f6eb4448a8af6859f0c972be3 #: 1164be645ddb4224a7d1dfbaf1cd5aae 11a4366dcede41cfaa7fdd36496c01f8 #: 134ee532dfa449f7a4ae06f57cf5988e 13b2e4a1b9744b59bf530b2f115364c0 #: 242606a542a04a0eb4db1492072bbbd1 26c165f89a5f499eb2bad0cdc07423df #: 28a91b3ddd5446e6ac630c63f80bc46c 2d988720b730480abd51f3485f33b9dd #: 2dc2f4b45060421cb1b0e7609a77cf95 36c8dc94af7341e0bdd08b5127d8485c #: 38acd225df3c4b4ca9c150e5d7033af0 3d87ac16734548f390215976b31c8c04 #: 3ef1c3fc9e334d3fb17e329f068ea72c 409cb3c2f05441b9be706339b72b0f8b #: 448429be618e43a0b10ba1ae0e5d7e88 45ae45d35fe74d62b719166a69e7064d #: 45bce8087950479e8fa7477db3a20711 530ff5d58e3a4d9e98c9aeb8c5605bdb #: 551a6935861b439098d9d062611f616a 58261b2fcc5c49f5933bcfdab369ef17 #: 5a5aea508b954bb49e513cf02243ce16 5ac5beffb52646b18b7348ac1b2737e7 #: 5ea82374068c4ab4b571bb6daa9be348 6414b2f2a6ac4b7ba788941cca287706 #: 6a5b8d3dc8bf40e29ded3ec3e9ffc38b 6c98f98bb31f4c98ae8a19bf33683ff0 #: 6f1d6803f6944c3eb09805a162627403 6f37c861b8b84191948d358812e43a6a #: 73823030d66d461c9de9c71a08b04c67 7423014684c24e4e94f2ed1856e30e86 #: 766ac26fd7d04013a82d44a6359f02e4 7a58704d8b8c46fa9d2a7e06b609b5e6 #: 7c1441be492648c6868dc599cbcf5290 7d00af6b27284bc49da99cf2abcd1c4a #: 7f44721ca2974b3390c251bd6d32cb0d 8645eb3d5aff4b538c51ae5de766f320 #: 8cf10f5e5765410c89421d4efc29c2bb 8faa136e57734811b95284b118993d56 #: 9098706c0a9241599811b31b5e16c768 99d0a9c7f22d43fd91b94d3c9d440d40 #: 9af405444dc145959d9744d4fca8d186 9c7eefa6c1ab43fb9581311c53f3dbae #: 9cd2f9315b7e4cf6b879188ba6e88ad3 9e5092bbf1e14cdba4a8622d40c8e74a #: a542a56d8f1347c6bbbeb1c6edbd40a1 a72dfd60198e40ae9582c427e0a70e8a #: ac4cc19f3f184b118dc2bb188462d316 ac57ebf36eac4d7eb5338b7d3e1d2a38 #: af376c9284994378ba44d7d738372d08 b294f327f5df461a865037b3521e9b64 #: b34e803114f74c439be67a2ea91fa82c b38308ff71d54e1f94cc7c713b830e63 #: b8c7e0cb4b5c4e28b7cd299e01fc5c13 c37ef0bd30d84df79116ba9247cfb66c #: c8b4346f33e5443fbb32425aeaac3976 cb94891111504901bb93c32cc492a56e #: cc075b040dc84fd79ab823949da8569a cc70b1049ca94aae8a5ed47bbc2731b1 #: cc8c8e6cb09e446dbd6c913800d9e92d cd44b293d5944613acbb4ebf13982f69 #: de44007b099b4574b6ba370e8062081d e91161bf404a4c1aa6938f7206969d75 #: e92666d7cb144f5aa9320e4172973126 ecb58c0295154bcba79da2c6bb14ecd0 #: f5e2748d98ca490ba49440b716ce1557 f6ab3d9b4a4c4173b419ce4f678343f3 #: f9bc09fc5ea34227a7114500e5ce81a6 fa33f17ae9614356bbae44d1f3ec88ff #: fd852a1fe1934034b07fecc82f20016f msgid "Parameters" msgstr "パラメータ" #: ../../document.rst:180 58d96afc6c3f4041817e26ee41843ed2 msgid "" "A UTF-8 string or ``pathlib.Path`` object containing a file path. The " "document type is always determined from the file content. The " "``filetype`` parameter is ignored, except when content inspection was " "unsuccessful. This is regularly the case for plain text types like " "\"txt\", \"html\", \"xml\" etc. with a wrong or missing file extension." msgstr ""ファイルパスを含むUTF-8文字列または ``pathlib.Path`` オブジェクトです。" "ドキュメントタイプは常にファイルの内容から判定されます。" "``filetype`` パラメータは、内容の検査が失敗した場合を除いて無視されます。" "これは、誤った、または欠落したファイル拡張子を持つ " "\"txt\"、\"html\"、\"xml\" などのプレーンテキストタイプでよくあるケースです。"" #: ../../document.rst:182 42a021002ca24463805b8c682c3ef247 msgid "" "A memory area containing file data. The document type is always detected " "from the data content. The ``filetype`` parameter is ignored, except when" " content inspection was unsuccessful. This is regularly the case for " "plain text types like \"txt\", \"html\", \"xml\" etc." msgstr ""ファイルデータを含むメモリ領域です。ドキュメントタイプは常にデータの内容から検出されます。" "``filetype`` パラメータは、内容の検査が失敗した場合を除いて無視されます。" "これは、\"txt\"、\"html\"、\"xml\" などのプレーンテキストタイプでよくあるケースです。"" #: ../../document.rst:184 df0bacd926f548f7993192643669e3da msgid "" "A string specifying the type of document. This is only ever needed when " "file content inspection fails. Text types like \"txt\", \"html\", \"xml\"" " etc. cannot be disambiguated by their content. When such files are " "provided in memory or being provided with the wrong file extension, this " "parameter **must** be used." msgstr ""ドキュメントのタイプを指定する文字列です。これは、ファイル内容の検査が失敗した場合にのみ必要です。" "\"txt\"、\"html\"、\"xml\" などのテキストタイプは、その内容によって識別することができません。" "このようなファイルがメモリ内で提供される場合、または誤ったファイル拡張子で提供される場合、" "このパラメータを **必ず** 使用してください。"" #: ../../document.rst:186 78759e58f1034e9b8808547679e5f0c7 msgid "" "a rectangle specifying the desired page size. This parameter is only " "meaningful for documents with a variable page layout (\"reflowable\" " "documents), like e-books or HTML, and ignored otherwise. If specified, it" " must be a non-empty, finite rectangle with top-left coordinates (0, 0). " "Together with parameter :data:`fontsize`, each page will be accordingly " "laid out and hence also determine the number of pages." msgstr "" "希望のページサイズを指定する矩形。このパラメータは可変ページレイアウト（\"reflowable\" ドキュメント）を持つドキュメント（電子書籍や" " HTML のようなもの）にのみ意味があり、それ以外の場合は無視されます。指定される場合、非空で有限な矩形で、左上座標 (0, 0) " "を持っていなければなりません。*fontsize* パラメータと一緒に、各ページのレイアウトが適切に行われ、したがってページ数も決定されます。" #: ../../document.rst:188 a39ff59bcd5b443e8be15251425208dd msgid "" "may used together with ``height`` as an alternative to ``rect`` to " "specify layout information." msgstr "レイアウト情報を指定するための ``rect`` の代替として、 ``height`` と一緒に使用できます。" #: ../../document.rst:190 5850f945318e4c5ba3ad88d7be9ed8f7 msgid "" "may used together with ``width`` as an alternative to ``rect`` to specify" " layout information." msgstr "レイアウト情報を指定するための ``rect`` の代替として、 ``width`` と一緒に使用できます。" #: ../../document.rst:192 a2fc132738884e6f835292f70dbf813b msgid "" "the default :data:`fontsize` for reflowable document types. This " "parameter is ignored if none of the parameters ``rect`` or ``width`` and " "``height`` are specified. Will be used to calculate the page layout." msgstr "" "可変ページドキュメントタイプのデフォルト :data:`fontsize`。 ``rect`` または ``width`` と " "``height`` のいずれのパラメータも指定されていない場合、このパラメータは無視されます。ページレイアウトを計算するために使用されます。" #: ../../document.rst 31cdc47b32794a798531bbe848c5bda9 #: 8c8d6154dfd44d2ba07f8f96a6d9efca msgid "Raises" msgstr "" #: ../../document.rst:194 93b67db706e5441b96d643f164ce062f msgid "if the *type* of any parameter does not conform." msgstr "任意のパラメータの *型* が準拠していない場合。" #: ../../document.rst:195 42762fcf592649558e1963103f6dc8a7 msgid "" "if the file / path cannot be found. Re-implemented as subclass of " "`RuntimeError`." msgstr "ファイル/パスが見つからない場合。`RuntimeError` のサブクラスとして再実装されました。" #: ../../document.rst:196 2057576b00c94522986d094e8c68c1df msgid "" "if the file / path is empty or the `bytes` object in memory has zero " "length. A subclass of `FileDataError` and `RuntimeError`." msgstr "" "ファイル/パスが空であるか、メモリ内の `bytes` オブジェクトの長さがゼロの場合。`FileDataError` および " "`RuntimeError` のサブクラス。" #: ../../document.rst:197 7af323bd72ba4aeab2300ae9ce1c8deb msgid "if an unknown file type is explicitly specified." msgstr "明示的に未知のファイルタイプが指定された場合。" #: ../../document.rst:198 18d265e2b9244cc3abe76c5bbd2278b0 msgid "" "if the document has an invalid structure for the given type -- or is no " "file at all (but e.g. a folder). A subclass of `RuntimeError`." msgstr "" "ドキュメントが指定されたタイプに対して無効な構造を持っているか、ファイルではない場合（たとえば、フォルダの場合）。`RuntimeError` " "のサブクラス。" #: ../../document.rst 047c76e2fca94ff59ddfc0ba555820e2 #: 05f5daa98f00493bbb7a374f27f0a4b2 0659f08fa83e47a5955522391fa15698 #: 06edaf8239974c938d93dc80fa34d7b3 07f23348a83747a994bfc38292cb6817 #: 158edb1f340741378949ce4bab7d1208 192965113ee04caf8146575bc393c6b2 #: 2059d856b5964cc6a0bf7b8f3fda5404 22190b4c653441329a53fd9cd6af3bb8 #: 226eb33d228e44ddb55b37be48020765 24bc92cfaa3940289ca3ea8cd27d3106 #: 2dafdb9211e64d488d5e9593226ca06e 312853a1c43e4fe0a603faa0c4dceabc #: 31ab2b887428472a8ad5bd876a2c0fa3 3ecac14ada7f4ac787def38bf6a8f6cf #: 3f9435a31fca4d4d8cbb170875d2a3a4 464a3d0819674be3a513b02da8c87f09 #: 4c3f4194da5c4dea946bb543c410e000 556c0e94fdbc48f7ad1c45b988d89c4b #: 57359910ea7448e7a17fd9dedd43b13f 57bff51834564091b9d1b4055ff2a4e2 #: 6056f1e956114601907e8db93075c69d 64ecbf4b3b474f7eb72622284e2cb7ba #: 66279346c97044d48e845dc1660bd20c 729ef3cc086d42e98982d5116d01854d #: 760161a30c3e4264b6add40c459ecd55 779098b76b7e497ea7d0ac5ff5f230ba #: 7807cc54e173424c98cd91c0e09a81fe 7ae314f6b0e24da3a92ce747b3bbcf11 #: 882d32145fa2437186746febf7ff6b9e 8dd9a3cf674448ce866dfa99e2966320 #: 977bcac8f3714ed9bc2f7a27dce3d310 9988c1213e394ff0839023541b3cda02 #: acbfc888b60d461b8e34b1893ba6857b ad784150a80c454cb020cf1b36616ada #: addfabd60db741858e920a4caf7bee46 aff867c7df6c43feb44be7a1705c3c90 #: b532e1af2f86421292f40080c67d8130 ce1aa2bb29194111b35b8883f494fbbb #: cfed3fbff8a046ed885355b399d4a2ab ebbe17e44f874fdd8ecbc146d1756273 #: ec39975fff364d138618b3f0a03d7f7c f01df95655be4d7ba337b69dc87134d0 #: faa22c65030b43fabbb90aae7cc4bcbb fb61cf4fd04246d88877968bcd325279 msgid "Returns" msgstr "" #: ../../document.rst:200 cf78e0bdd8b34963964a9914c2b152e3 msgid "" "A document object. If the document cannot be created, an exception is " "raised in the above sequence. Note that PyMuPDF-specific exceptions, " "`FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted" " if you check for `RuntimeError`. In case of problems you can see more " "detail in the internal messages store: " "`print(pymupdf.TOOLS.mupdf_warnings())` (which will be emptied by this " "call, but you can also prevent this -- consult " ":meth:`Tools.mupdf_warnings`)." msgstr "" #: ../../document.rst:200 a8c942677a9c4be198f8b855f9a7aa87 msgid "" "A document object. If the document cannot be created, an exception is " "raised in the above sequence. Note that PyMuPDF-specific exceptions, " "`FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted" " if you check for `RuntimeError`." msgstr "" "ドキュメントオブジェクト。ドキュメントを作成できない場合、上記の順序で例外が発生します。PyMuPDF固有の例外、`FileNotFoundError`" " 、`EmptyFileError` 、および `FileDataError` は、`RuntimeError` " "をチェックする場合にキャッチされます。" #: ../../document.rst:202 e37b3dcfa1ef4bb18a5147e0847b1947 msgid "" "In case of problems you can see more detail in the internal messages " "store: `print(pymupdf.TOOLS.mupdf_warnings())` (which will be emptied by " "this call, but you can also prevent this -- consult " ":meth:`Tools.mupdf_warnings`)." msgstr "" "問題が発生した場合、内部メッセージストアで詳細を確認できます： `print(pymupdf.TOOLS.mupdf_warnings())` " "（この呼び出しによって空にされますが、これを防ぐこともできます - :meth:`Tools.mupdf_warnings` " "を参照してください）。" #: ../../document.rst:204 2b66040c852944bf8054bbb5fc40f830 msgid "Overview of possible forms, note: `open` is a synonym of `Document`::" msgstr "可能なフォームの概要、注： `open` は `Document` の同義語です::" #: ../../document.rst:221 64bcc08b1e204f36b85a92e3bf4a7b7b msgid "" "Raster images with a wrong (but supported) file extension **are no " "problem**. MuPDF will determine the correct image type when file " "**content** is actually accessed and will process it without complaint." msgstr "" "サポートされているが正しくないファイル拡張子を持つラスター画像は **問題ありません** 。MuPDFは、ファイルの実際の **内容** " "がアクセスされると正しい画像タイプを判断し、何もクレームをつけずに処理します。" #: ../../document.rst:223 f9c50ee3ebf24470b38de4cdc1f54b1b msgid "" "The Document class can be also be used as a **context manager**. Exiting " "the content manager will close the document automatically." msgstr "Document クラスは **コンテキストマネージャ** としても使用できます。終了時に、ドキュメントは自動的に閉じられます。" #: ../../document.rst:239 ../../document.rst:249 ../../document.rst:309 #: ../../document.rst:355 1730d717878941ef892b30c483eca126 #: 483dca214c8e48079d2e4c46ba3235ca 4d05d842450e4edfae325ef65d2b7611 #: f30d1bf6555e43a49b37fc613c1508b0 msgid "New in v1.18.4" msgstr "v1.18.4 で新規追加" #: ../../document.rst:241 eba6c4b1e61146a6bb640a3f95719819 msgid "" "Return the cross reference number of an :data:`OCG` or :data:`OCMD` " "attached to an image or form xobject." msgstr "画像またはフォームXObjectに添付された :data:`OCG` または :data:`OCMD` のクロスリファレンス番号を返します。" #: ../../document.rst:243 ad2e8305cca245ccbb0fb3c0b6258d90 msgid "" "the :data:`xref` of an image or form xobject. Valid such cross reference " "numbers are returned by :meth:`Document.get_page_images`, resp. " ":meth:`Document.get_page_xobjects`. For invalid numbers, an exception is " "raised." msgstr "" "画像またはフォームXObjectの :data:`xref` " "。有効なクロスリファレンス番号は、:meth:`Document.get_page_images` または " ":meth:`Document.get_page_xobjects` で返されます。無効な番号の場合、例外が発生します。" #: ../../document.rst 0500953c20e7437cb07eb1e5b5ab6d95 #: 0a34e8c806934adbb39a562cec45ed00 0dbcdc6042ab41719e7bfb23d45e9498 #: 0f529499a28c45e689047cb279bef176 2dfb2fc75f3c4ae48c9621d951c8b20d #: 34e50adf35b049d59f94366d6a1c4d01 3c8c31137eed41449dd23adac7aa0431 #: 4b2ccda028124833b98c4b8d75dc5796 4bef2068106e4e12b153e5f9c3d0a73f #: 553755100d5e4a9fbdac0009e6aab03b 613035964f614edeaf5c9e07ebae1838 #: 6ef8b75ae6c942cb8bab3048fece0e1c 7f12d638e7764df0b3b1b81088afcdad #: 80b0f09950a4445fa028f7bff7e85366 80f84520db924d0398f865a7c6875a5f #: 821c42fa24fe4ff68ef126f5150071ab 8a85efe68f114c0eae3355efc6be9ed9 #: 90fd0a7b1fd84565868c7a4915335e92 910331f87ce84bedb176f82e21061663 #: ab6d6004faef490596417bcdad04ff0e ab9ee70f563b4f58b630bd00db9096cc #: b1fb8a32cfbf4a3185cc6a0b9dffa6f0 b35706daab7e445e88f47d8377413f7f #: ba9ffa28e36f4e13bbd25d4f25a464a1 bfdee673d70a4b918589e416740c1b9c #: cbc5f629858c4424b7ee4ec850a7588b cd443890b968437eae8ea9cc73288cec #: d1a86fcdf8044a5cae21c2c3e71a8a30 d211bea9230d4be78a69c08250062eca #: e5405416c793476395b89cc26926e4a6 e810c1ec77c24b9b983b6168bc72c737 #: e9ad8885d4414821ab5dda6ccb064634 f51ea798020a41dfa00ef5586e64de2a #: f8a557a2ff2a48ecbece73e853f0a03b fc5ab7c5392b43dfb5212c6091f15304 #: fef16f5342014574b4c13ceed01202b0 msgid "Return type" msgstr "戻り値の型" #: ../../document.rst:245 c041477b58714e209412601d6ad826df msgid "" "the cross reference number of an optional contents object or zero if " "there is none." msgstr "オプションコンテンツオブジェクトのクロスリファレンス番号、または存在しない場合はゼロ。" #: ../../document.rst:251 c8de893dbc234e21bc29025c8fced233 msgid "" "If :data:`xref` represents an image or form xobject, set or remove the " "cross reference number *ocxref* of an optional contents object." msgstr "" ":data:`xref` が画像またはフォームXObjectを表す場合、オプションコンテンツオブジェクトのクロスリファレンス番号 *ocxref*" " を設定または削除します。" #: ../../document.rst:253 6267c33679a84edbad42cf549b96a4d7 msgid "" "the :data:`xref` of an image or form xobject [#f5]_. Valid such cross " "reference numbers are returned by :meth:`Document.get_page_images`, resp." " :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is" " raised." msgstr "" "画像またはフォームXObjectの :data:`xref` " "[#f5]_。有効なクロスリファレンス番号は、:meth:`Document.get_page_images` または " ":meth:`Document.get_page_xobjects` で返されます。無効な番号の場合、例外が発生します。" #: ../../document.rst:254 dafcd054da864b7bac355ee5b787c2db msgid "" "the :data:`xref` number of an :data:`OCG` / :data:`OCMD`. If not zero, an" " invalid reference raises an exception. If zero, any OC reference is " "removed." msgstr "" ":data:`OCG` / :data:`OCMD` の :data:`xref` " "番号。ゼロでない場合、無効な参照は例外を発生させます。ゼロの場合、任意のOC参照が削除されます。" #: ../../document.rst:259 ../../document.rst:269 ../../document.rst:280 #: ../../document.rst:292 ../../document.rst:366 ../../document.rst:378 #: ../../document.rst:400 ../../document.rst:418 ../../document.rst:434 #: 23926cee6be044648a5c37b816d143bd 5cb2942c0bd2436aa86c4ef9fe4aeb7c #: 89fe4090f50d42499290ad8b8c5d9d27 8aab2fbbb4b740cc93f678bbf28f5d89 #: bbf66277dd1d49b8aa08f5333630c6aa bfee650f7a0840288662be53901e0e16 #: d64e06f1af29426e832fa442c29fae08 e6c3241b846345b49e2c2654f71724b5 #: ec6c47d3bc2e4eeb91c14aba11424529 msgid "New in v1.18.3" msgstr "v1.18.3 で新規追加" #: ../../document.rst:261 4a50ac946de94468b0d17ce0c5cd0bfd msgid "" "Show optional layer configurations. There always is a standard one, which" " is not included in the response." msgstr "オプションのレイヤー構成を表示します。常に標準のものが存在し、それは応答に含まれていません。" #: ../../document.rst:271 62a7c759e42d4b04873f1b12d3184db4 msgid "" "Add an optional content configuration. Layers serve as a collection of ON" " / OFF states for optional content groups and allow fast visibility " "switches between different views on the same document." msgstr "" "オプションのコンテンツ構成を追加します。レイヤーはオプションコンテンツグループのON / " "OFFの状態のコレクションとして機能し、同じドキュメントの異なるビュー間での高速な表示切り替えを可能にします。" #: ../../document.rst:273 0407f1ddb2e2486d857a6ecfee7bdd01 msgid "arbitrary name." msgstr "任意の名前。" #: ../../document.rst:274 78e5e16c7cde40f587fa378470778e67 msgid "(optional) creating software." msgstr "（オプション）作成ソフトウェア。" #: ../../document.rst:275 141b82fff5454e1bb16c1ad6b039bbed msgid "" "a sequence of OCG :data:`xref` numbers which should be set to ON when " "this layer gets activated. All OCGs not listed here will be set to OFF." msgstr "" "このレイヤーがアクティブになったときにONに設定されるOCG :data:`xref` " "番号のシーケンス。ここでリストされていないすべてのOCGはOFFに設定されます。" #: ../../document.rst:282 f4c042d87e1840a2843af4d4117001eb msgid "" "Switch to a document view as defined by the optional layer's " "configuration number. This is temporary, except if established as " "default." msgstr "オプションレイヤーの構成番号によって定義されたドキュメントビューに切り替えます。これは一時的なものであり、デフォルトとして確立されていない限り、一時的なものです。" #: ../../document.rst:284 c5e86d78dd054fe59d48bfdfd027505f msgid "config number as returned by :meth:`Document.layer_configs`." msgstr ":meth:`Document.layer_configs` によって返される構成番号。" #: ../../document.rst:285 12da226f47384fb9856ab8e3539b8f7f msgid "make this the default configuration." msgstr "これをデフォルト構成にします。" #: ../../document.rst:287 a0359149d06f41c3a0c31aa7fd513161 msgid "" "Activates the ON / OFF states of OCGs as defined in the identified layer." " If ``as_default=True``, then additionally all layers, including the " "standard one, are merged and the result is written back to the standard " "layer, and **all optional layers are deleted**." msgstr "" "識別されたレイヤーで定義されたOCGのON / OFFの状態をアクティブにします。 ``as_default=True`` " "の場合、追加で、標準のレイヤーを含むすべてのレイヤーがマージされ、結果が標準レイヤーに書き込まれ、 " "**すべてのオプションレイヤーが削除されます** 。" #: ../../document.rst:294 019d0c5001d94da99732a3ea85edb766 msgid "" "Add an optional content group. An OCG is the most important unit of " "information to determine object visibility. For a PDF, in order to be " "regarded as having optional content, at least one OCG must exist." msgstr "オプションコンテンツグループを追加します。OCGはオブジェクトの表示を決定するための最も重要な情報単位です。PDFでは、オプションコンテンツとして扱われるためには、少なくとも1つのOCGが存在する必要があります。" #: ../../document.rst:296 df98d756b4024732b2403d8409bb80d0 msgid "arbitrary name. Will show up in supporting PDF viewers." msgstr "任意の名前。サポートするPDFビューアに表示されます。" #: ../../document.rst:297 645459e390354faea10340dc61b7b599 msgid "layer configuration number. Default -1 is the standard configuration." msgstr "レイヤー構成番号。デフォルトは-1で、標準構成です。" #: ../../document.rst:298 f6fa2faa541148c5accbe497d973571b msgid "standard visibility status for objects pointing to this OCG." msgstr "このOCGを指すオブジェクトの標準の表示状態。" #: ../../document.rst:299 40453f0b3a0b40219a2f25b7ebc97193 msgid "" "a string or list of strings declaring the visibility intents. There are " "two PDF standard values to choose from: \"View\" and \"Design\". Default " "is \"View\". Correct **spelling is important**." msgstr "" "表示意図を宣言する文字列または文字列のリスト。PDF標準の2つの値から選択できます: \"View\" と \"Design\"。デフォルトは " "\"View\" です。 **正確なスペルが重要です** 。" #: ../../document.rst:300 5c48545ceb124bb5a9377cf6d70d146f msgid "" "another influencer for OCG visibility. This will become part of the OCG's" " `/Usage` key. There are two PDF standard values to choose from: " "\"Artwork\" and \"Technical\". Default is \"Artwork\". Please only change" " when required." msgstr "" "OCGの表示に影響を与えるもう一つの要因。これはOCGの `/Usage` キーの一部になります。PDF標準の2つの値から選択できます: " "\"Artwork\" と \"Technical\"。デフォルトは \"Artwork\" です。必要な場合にのみ変更してください。" #: ../../document.rst:302 747d12bc0ae0484c9865443714401394 msgid "" ":data:`xref` of the created OCG. Use as entry for `oc` parameter in " "supporting objects." msgstr "作成されたOCGの :data:`xref` 。サポートオブジェクトの `oc` パラメータのエントリとして使用します。" #: ../../document.rst:304 e6da50b60736424ab6212f1f73d1e613 msgid "" "Multiple OCGs with identical parameters may be created. This will not " "cause problems. Garbage option 3 of :meth:`Document.save` will get rid of" " any duplicates." msgstr "" "同一のパラメータを持つ複数のOCGを作成することができます。これは問題を引き起こしません。:meth:`Document.save` " "のゴミオプション3を使用すれば、重複を削除できます。" #: ../../document.rst:311 af571053832447268949688f1f4dfb77 msgid "" "Create or update an :data:`OCMD`, **Optional Content Membership " "Dictionary.**" msgstr ":data:`OCMD` （ **Optional Content Membership Dictionary** ）を作成または更新します。" #: ../../document.rst:313 176f6da4c473440c9136b9f539104722 msgid ":data:`xref` of the OCMD to be updated, or 0 for a new OCMD." msgstr "更新するOCMDの :data:`xref` 、または新しいOCMDの場合は0" #: ../../document.rst:314 c62679a99da644e8b4803a0c9d329a9a msgid "a sequence of :data:`xref` numbers of existing :data:`OCG` PDF objects." msgstr "既存の :data:`OCG` PDFオブジェクトの :data:`xref` 番号のシーケンス。" #: ../../document.rst:315 4b77e6d94ae7432085d1e1936f946ec6 msgid "" "one of \"AnyOn\" (default), \"AnyOff\", \"AllOn\", \"AllOff\" (mixed or " "lower case)." msgstr "\"AnyOn\"（デフォルト）、\"AnyOff\"、\"AllOn\"、\"AllOff\"のいずれか。大文字小文字は区別されません。" #: ../../document.rst:316 52aa1d09e9274734ae9c2082f3543182 msgid "" "a \"visibility expression\". This is a list of arbitrarily nested other " "lists -- see explanation below. Use as an alternative to the combination " "*ocgs* / *policy* if you need to formulate more complex conditions." msgstr "" "\"表示条件式\"。これは他のリストを任意に入れ子にしたリストです - 説明は以下を参照してください。より複雑な条件を定式化する必要がある場合、 " "*ocgs* / *policy* の組み合わせの代替として使用します。" #: ../../document.rst:318 82c5e6b9f0df4f9e8364caf4e1030f20 msgid "" ":data:`xref` of the OCMD. Use as `oc=xref` parameter in supporting " "objects, and respectively in :meth:`Document.set_oc` or " ":meth:`Annot.set_oc`." msgstr "" "OCMDの :data:`xref` 。サポートオブジェクトの `oc=xref` " "パラメータとして使用し、:meth:`Document.set_oc` または :meth:`Annot.set_oc` にもそれぞれ使用します。" #: ../../document.rst:322 ff4a88e9bc164073a711f1c9e12ff4e5 msgid "" "Like an OCG, an OCMD has a visibility state ON or OFF, and it can be used" " like an OCG. In contrast to an OCG, the OCMD state is determined by " "evaluating the state of one or more OCGs via special forms of **boolean " "expressions.** If the expression evaluates to true, the OCMD state is ON " "and OFF for false." msgstr "" "OCGと同様に、OCMDには表示状態ONまたはOFFがあり、OCGのように使用できます。OCGとは異なり、OCMDの状態は **ブール式** " "の特別な形式を使用して1つ以上のOCGの状態を評価することによって決定されます。式がtrueに評価される場合、OCMDの状態はONで、falseに評価される場合はOFFです。" #: ../../document.rst:324 7624a64d7d344afcb6b9c711969255fd msgid "There are two ways to formulate OCMD visibility:" msgstr "OCMDの表示を定式化する方法は2つあります:" #: ../../document.rst:326 f286a0292bdc4233bb5cae6692a86360 msgid "" "Use the combination of *ocgs* and *policy*: The *policy* value is " "interpreted as follows:" msgstr "*ocgs* と *policy* の組み合わせを使用する: *policy* の値は次のように解釈されます：" #: ../../document.rst:328 cd5febb83dd14249b5c74b772683ca78 msgid "AnyOn -- (default) true if at least one OCG is ON." msgstr "(デフォルト) 少なくとも1つのOCGがONの場合、true。" #: ../../document.rst:329 d198b9b66f374b60b940b079312cd963 msgid "AnyOff -- true if at least one OCG is OFF." msgstr "少なくとも1つのOCGがOFFの場合、true。" #: ../../document.rst:330 075a921c145249f5b1eca9f6602422ba msgid "AllOn -- true if all OCGs are ON." msgstr "すべてのOCGがONの場合、true。" #: ../../document.rst:331 fa6c2c43aba44d159e35b8f57e646e0c msgid "AllOff -- true if all OCGs are OFF." msgstr "すべてのOCGがOFFの場合、true。" #: ../../document.rst:333 06df4aa95eb7403f92d354cdafc71cc9 msgid "" "Suppose you want two PDF objects be displayed exactly one at a time (if " "one is ON, then the other one must be OFF):" msgstr "2つのPDFオブジェクトを、必ず1つずつ表示するようにしたい場合（1つがONの場合、他の1つはOFFにする必要があります）：" #: ../../document.rst:335 65c7260ce3b54ff484d2f1642d17fc89 msgid "" "Solution: use an **OCG** for object 1 and an **OCMD** for object 2. " "Create the OCMD via `set_ocmd(ocgs=[xref], policy=\"AllOff\")`, with the " ":data:`xref` of the OCG." msgstr "" "解決策: オブジェクト1用のOCGとオブジェクト2用のOCMDを使用します。 OCMDは `set_ocmd(ocgs=[xref], " "policy=\"AllOff\")` を使用して作成し、OCGの :data:`xref` を指定します。" #: ../../document.rst:337 daf6a22c4b2a43d6a4bab99eff6c02c3 msgid "" "Use the **visibility expression** *ve*: This is a list of two or more " "items. The **first item** is a logical keyword: one of the strings " "**\"and\"**, **\"or\"**, or **\"not\"**. The **second** and all " "subsequent items must either be an integer or another list. An integer " "must be the :data:`xref` number of an OCG. A list must again have at " "least two items starting with one of the boolean keywords. This syntax is" " a bit awkward, but quite powerful:" msgstr "" "**表示条件式** *ve* を使用する: これは2つ以上のアイテムから成るリストです。 **最初のアイテム** は論理キーワードで、文字列 " "**\"and\"** 、**\"or\"** 、または **\"not\"** " "のいずれかです。2番目以降のアイテムは整数または別のリストである必要があります。整数はOCGの :data:`xref` " "番号でなければなりません。リストは再び少なくとも2つのアイテムから始まり、ブールキーワードのいずれかで始まる必要があります。この構文はやや厄介ですが、非常に強力です：" #: ../../document.rst:339 3542e922141d45e9bcd5d64b3ad00ead msgid "Each list must start with a logical keyword." msgstr "各リストは論理キーワードで始まる必要があります。" #: ../../document.rst:340 fa6c94f45a68492895b165d5688053b2 msgid "" "If the keyword is a **\"not\"**, then the list must have exactly two " "items. If it is **\"and\"** or **\"or\"**, any number of other items may " "follow." msgstr "" "キーワードが **\"not\"** の場合、リストは正確に2つのアイテムを持たなければなりません。 **\"and\"** または " "**\"or\"** の場合、その後にいくつでも他のアイテムが続くことができます。" #: ../../document.rst:341 2d88da6745cb40e5afe68d8a712a15df msgid "" "Items following the logical keyword may be either integers or again a " "list. An *integer* must be the xref of an OCG. A *list* must conform to " "the previous rules." msgstr "" "論理キーワードの後に続くアイテムは、整数または再びリストである必要があります。 *整数* はOCGのxref番号でなければなりません。 *リスト*" " は前述のルールに従う必要があります。" #: ../../document.rst:343 d786a59eab5449a5ad1c6130e01c2bca msgid "**Examples:**" msgstr "**例:** " #: ../../document.rst:345 32e37d05f4b94a2c9f8a2241e144216c msgid "" "`set_ocmd(ve=[\"or\", 4, [\"not\", 5], [\"and\", 6, 7]])`. This delivers " "ON if the following is true: **\"4 is ON, or 5 is OFF, or 6 and 7 are " "both ON\"**." msgstr "" "`set_ocmd(ve=[\"or\", 4, [\"not\", 5], [\"and\", 6, 7]])` " "。これは次の条件がtrueの場合にONを返します: **\"4がON、または5がOFF、または6と7が両方ON** \"。" #: ../../document.rst:346 8bff1ec6e8a545a19fcf60c341c39b3f msgid "" "`set_ocmd(ve=[\"not\", xref])`. This has the same effect as the OCMD " "example created under 1." msgstr "`set_ocmd(ve=[\"not\", xref])` 。これは1で作成されたOCMDの例と同じ効果があります。" #: ../../document.rst:348 bb5ab99cc5154c058bd6c6c21d77efdb msgid "" "For more details and examples see page 224 of :ref:`AdobeManual`. Also do" " have a look at example scripts `here `_." msgstr "" "詳細と例については、 :ref:`AdobeManual` の224ページを参照してください。また、`こちら " "`_ の例のスクリプトもご覧いただけます。" #: ../../document.rst:350 710f05e9b696464fa3f0137f62c2204b msgid "" "Visibility expressions, `/VE`, are part of PDF specification version 1.6." " So not all PDF viewers / readers may already support this feature and " "hence will react in some standard way for those cases." msgstr "" "表示条件式 `/VE` " "はPDF仕様バージョン1.6の一部です。したがって、すべてのPDFビューア/リーダーがすでにこの機能をサポートしているわけではなく" #: ../../document.rst:357 fad572b38ee64c15b7ffc0ca037efa59 msgid "Retrieve the definition of an :data:`OCMD`." msgstr ":data:`OCMD` の定義を取得します。" #: ../../document.rst:359 3a57bb52cf234bbeaa0eef4f2d589d31 msgid "the :data:`xref` of the OCMD." msgstr ":data:`xref` （int）- OCMDのxref。" #: ../../document.rst:361 8beef4ef63b642df94ebb105bec160d8 msgid "a dictionary with the keys :data:`xref`, *ocgs*, *policy* and *ve*." msgstr ":data:`xref` 、*ocgs* 、*policy*、*ve* のキーを持つ辞書" #: ../../document.rst:368 e2155a3ac05040b9add64191e6b9e0ff msgid "" "List of optional content groups by status in the specified configuration." " This is a dictionary with lists of cross reference numbers for OCGs that" " occur in the arrays `/ON`, `/OFF` or in some radio button group " "(`/RBGroups`)." msgstr "" "指定された構成内のステータス別オプションコンテンツグループのリスト。これは、OCGsのクロスリファレンス番号のリストを持つ辞書で、`/ON` " "、`/OFF` 、またはラジオボタングループ (`/RBGroups`) のいずれかに出現するOCGsに対応しています。" #: ../../document.rst:370 5c4df35639784744a466356b3362cbc6 msgid "the configuration layer (default is the standard config layer)." msgstr "構成レイヤー（デフォルトは標準の構成レイヤー）。" #: ../../document.rst:380 2f281f33088346b08c527ae42e6f1c4e msgid "Changed in v1.22.5: Support list of *locked* OCGs." msgstr "バージョン1.22.5で変更: *ロックされた* OCGのリストをサポート。" #: ../../document.rst:382 e1b37420106d4246a034d0a858461ca2 msgid "" "Mass status changes of optional content groups. **Permanently** sets the " "status of OCGs." msgstr "オプションコンテンツグループの大量ステータス変更。OCGのステータスを **永続的に** 設定します。" #: ../../document.rst:384 a2e67c4937b043b797822f7cd599b808 msgid "desired configuration layer, choose -1 for the default one." msgstr "希望の構成レイヤー、デフォルトのものには-1を選択します。" #: ../../document.rst:385 a5d626582a0c4adeac28522f8e23f533 msgid "" "list of :data:`xref` of OCGs to set ON. Replaces previous values. An " "empty list will cause no OCG being set to ON anymore. Should be specified" " if `basestate=\"ON\"` is used." msgstr "" "ONに設定するOCGの :data:`xref` " "のリスト。以前の値を置換します。空のリストはもうOCGをONに設定しなくなります。`basestate=\"ON\"` " "が使用される場合は指定する必要があります。" #: ../../document.rst:386 b105d154868648c0a78aa7ddeab0e341 msgid "" "list of :data:`xref` of OCGs to set OFF. Replaces previous values. An " "empty list will cause no OCG being set to OFF anymore. Should be " "specified if `basestate=\"OFF\"` is used." msgstr "" "OFFに設定するOCGの :data:`xref` のリスト。以前の値を置換します。空のリストはもうOCGをOFFに設定しなくなります。 " "`basestate=\"OFF\"` が使用される場合は指定する必要があります。" #: ../../document.rst:387 00ee5fd0e019474a870809b586d7a8dc msgid "" "state of OCGs that are not mentioned in *on* or *off*. Possible values " "are \"ON\", \"OFF\" or \"Unchanged\". Upper / lower case possible." msgstr "" "*on* または *off* " "で言及されていないOCGの状態。可能な値は「ON」、「OFF」または「Unchanged」です。大文字/小文字を区別できます。" #: ../../document.rst:388 00be43e01f734962a6706a02e112feb2 msgid "" "a list of lists. Replaces previous values. Each sublist should contain " "two or more OCG xrefs. OCGs in the same sublist are handled like buttons " "in a radio button group: setting one to ON automatically sets all other " "group members to OFF." msgstr "" "リストのリスト。以前の値を置換します。各サブリストには2つ以上のOCG " "xrefを含める必要があります。同じサブリスト内のOCGはラジオボタングループ内のボタンのように処理され、1つをONに設定すると他のすべてのグループメンバーがOFFに設定されます。" #: ../../document.rst:389 fa0a09aca08c40b1b90f36b23146c355 msgid "a list of OCG xref number that cannot be changed by the user interface." msgstr "ユーザーインターフェースで変更できないOCG xref番号のリスト。" #: ../../document.rst:391 e1c4e0490d9940e1883ad98f81859df8 msgid "Values `None` will not change the corresponding PDF array." msgstr "値 `None` は対応するPDF配列を変更しません。" #: ../../document.rst:402 6b83e49681b24a10b144d4a9e4acc01d msgid "" "Details of all optional content groups. This is a dictionary of " "dictionaries like this (key is the OCG's :data:`xref`):" msgstr "オプションコンテンツグループの詳細情報。これは次のような辞書の辞書です（キーはOCGの :data:`xref` です）：" #: ../../document.rst:420 36edc40743fe4afb943bac223003f082 msgid "" "Show the visibility status of optional content that is modifiable by the " "user interface of supporting PDF viewers." msgstr "サポートするPDFビューアのユーザーインターフェースで変更可能なオプションコンテンツの表示状態を表示します。" #: ../../document.rst:422 75b0b7f00565469eb5c15de91d146e92 msgid "" "Only reports items contained in the currently selected layer " "configuration." msgstr "現在選択されているレイヤー設定に含まれるアイテムのみを報告します。" #: ../../document.rst:429 34d23ea600964ffa9e171337ddac9bef msgid "The meaning of the dictionary keys is as follows:" msgstr "辞書のキーの意味は次の通りです：" #: ../../document.rst:425 a6f590d8251a4781a92016be8710b113 msgid "*depth:* item's nesting level in the `/Order` array" msgstr "*depth:* `/Order` 配列内のアイテムのネストレベル" #: ../../document.rst:426 f6a9c537d38e4cdb89490b8d63d75c4b msgid "*locked:* true if cannot be changed via user interfaces" msgstr "*locked:* ユーザーインターフェースを介して変更できない場合はtrue" #: ../../document.rst:427 208b1ca352e74127bda9ca8a9983cbe6 msgid "*number:* running sequence number" msgstr "*number:* 連続するシーケンス番号" #: ../../document.rst:428 ab611eafc0ae4bbfb5cfc33ec4c9f161 msgid "*on:* item state" msgstr "*on:* アイテムの状態" #: ../../document.rst:429 6fd780d71a13487ca690fbfc3311d4bd msgid "*text:* text string or name field of the originating OCG" msgstr "*text:* 元のOCGのテキスト文字列または名前フィールド" #: ../../document.rst:430 286752141da0452e9dff2a920379fecb msgid "" "*type:* one of \"label\" (set by a text string), \"checkbox\" (set by a " "single OCG) or \"radiobox\" (set by a set of connected OCGs)" msgstr "" "*type:* \"label\"（テキスト文字列によって設定）、\"checkbox\"（単一のOCGによって設定）、または " "\"radiobox\"（接続されたOCGのセットによって設定）のいずれか" #: ../../document.rst:436 623754e00b3f43feaccf231803da154d msgid "" "Modify OC visibility status of content groups. This is analog to what " "supporting PDF viewers would offer." msgstr "コンテンツグループのOC表示状態を変更します。これは、サポートするPDFビューアが提供するものと同様です。" #: ../../document.rst:438 7a68db8cb2cb477680821155ce320684 msgid "" "Please note that visibility is **not** a property stored with the OCG. It" " is not even information necessarily present in the PDF document at all. " "Instead, the current visibility is **temporarily** set using the user " "interface of some supporting PDF consumer software. The same type of " "functionality is offered by this method." msgstr "" "表示状態はOCGとして保存されるプロパティ **ではない** " "ことに注意してください。それはPDFドキュメントに必ずしも存在しない情報でもありません。代わりに、現在の表示状態はサポートするPDF消費者ソフトウェアのユーザーインターフェースを使用して**一時的に**" " 設定されます。このメソッドでも同じタイプの機能が提供されます。" #: ../../document.rst:440 81a92011a9ea497fb7600465d2f7249c msgid "To make **permanent** changes, use :meth:`Document.set_layer`." msgstr "**永続的な** 変更を行うには、:meth:`Document.set_layer` を使用してください。" #: ../../document.rst:442 995bfe639a02475fbeeb37b8f6e73e95 msgid "" "either the sequence number of the item in list " ":meth:`Document.layer_configs` or the \"text\" of one of these items." msgstr ":meth:`Document.layer_configs` リストのアイテムのシーケンス番号またはこれらのアイテムの「テキスト」。" #: ../../document.rst:443 775f2c9f68934b7098b0531a61f3e3a1 msgid "" "`PDF_OC_ON` = set on (default), `PDF_OC_TOGGLE` = toggle on/off, " "`PDF_OC_OFF` = set off." msgstr "" "`PDF_OC_ON` = ONに設定（デフォルト）、`PDF_OC_TOGGLE` = ON/OFFを切り替え、`PDF_OC_OFF` = " "OFFに設定。" #: ../../document.rst:448 27be24636736454f8669d2bf32f5850e msgid "" "Decrypts the document with the string *password*. If successful, document" " data can be accessed. For PDF documents, the \"owner\" and the \"user\" " "have different privileges, and hence different passwords may exist for " "these authorization levels. The method will automatically establish the " "appropriate (owner or user) access rights for the provided password." msgstr "" "文字列の *パスワード* " "でドキュメントを複合化します。成功した場合、ドキュメントデータにアクセスできます。PDFドキュメントの場合、「オーナー」および「ユーザー」には異なる特権があり、したがってこれらの認証レベルに異なるパスワードが存在する可能性があります。このメソッドは提供されたパスワードに適切な（オーナーまたはユーザー）アクセス権を自動的に確立します。" #: ../../document.rst:450 85327273191345d7a0064b7bfa2198b3 msgid "owner or user password." msgstr "オーナーまたはユーザーパスワード。" #: ../../document.rst:453 9c5364f7fc154375a06079af2df92681 msgid "" "a positive value if successful, zero otherwise (the string does not match" " either password). If positive, the indicator " ":attr:`Document.is_encrypted` is set to ``False``. **Positive** return " "codes carry the following information detail: * 1 => authenticated, but " "the PDF has neither owner nor user passwords. * 2 => authenticated with " "the **user** password. * 4 => authenticated with the **owner** password. " "* 6 => authenticated and both passwords are equal -- probably a rare " "situation. .. note:: The document may be protected by an owner, but " "**not** by a user password. Detect this situation via " "`doc.authenticate(\"\") == 2`. This allows opening and reading the " "document without authentication, but, depending on the " ":attr:`Document.permissions` value, other actions may be prohibited. " "PyMuPDF (like MuPDF) in this case **ignores those restrictions**. So, -- " "in contrast to any PDF viewers -- you can for example extract text and " "add or modify content, even if the respective permission flags " "`PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`, etc. are set " "off! It is your responsibility building a legally compliant application " "where applicable." msgstr "" #: ../../document.rst:453 08583032eafa41b7ac9b194f3bda03fa msgid "" "a positive value if successful, zero otherwise (the string does not match" " either password). If positive, the indicator " ":attr:`Document.is_encrypted` is set to ``False``. **Positive** return " "codes carry the following information detail:" msgstr "" "成功した場合は正の値、それ以外はゼロです（文字列がどちらのパスワードとも一致しない場合）。正の戻り値がある場合、インジケータ " ":attr:`Document.is_encrypted` は ``False`` に設定されます。**正の** " "戻り値コードには、次の情報の詳細が含まれています：" #: ../../document.rst:455 91f0bb6a692a4682a4c34c71ee148f1e msgid "1 => authenticated, but the PDF has neither owner nor user passwords." msgstr "1 => 認証済み、ただしPDFにはオーナーまたはユーザーパスワードがありません。" #: ../../document.rst:456 ba4f57095e824261b0a64d65bc13465d msgid "2 => authenticated with the **user** password." msgstr "2 => **ユーザー** パスワードで認証済み。" #: ../../document.rst:457 bfb7a0beede248c8a99fea4df83c1674 msgid "4 => authenticated with the **owner** password." msgstr "4 => **オーナー** パスワードで認証済み。" #: ../../document.rst:458 b8eaae626e8f42f29a0612cb9c166585 msgid "" "6 => authenticated and both passwords are equal -- probably a rare " "situation." msgstr "6 => 認証済みで両方のパスワードが等しい-おそらくまれな状況" #: ../../document.rst:462 73fc6cf7a70b4ed7b17c292f3bc63fa7 msgid "" "The document may be protected by an owner, but **not** by a user " "password. Detect this situation via `doc.authenticate(\"\") == 2`. This " "allows opening and reading the document without authentication, but, " "depending on the :attr:`Document.permissions` value, other actions may be" " prohibited. PyMuPDF (like MuPDF) in this case **ignores those " "restrictions**. So, -- in contrast to any PDF viewers -- you can for " "example extract text and add or modify content, even if the respective " "permission flags `PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`," " etc. are set off! It is your responsibility building a legally compliant" " application where applicable." msgstr "" "ドキュメントはオーナーによって保護されている場合でも、ユーザーパスワードによって保護 **されていない** " "場合があります。この状況は、`doc.authenticate(\"\") == 2` " "を使用して検出できます。これにより、認証なしでドキュメントを開いて読むことができますが、:attr:`Document.permissions` " "値に応じて、他のアクションが制限される場合があります。この場合、PyMuPDF（MuPDFと同様）はこれらの **制限を無視します** " "。したがって、`PDF_PERM_COPY` 、`PDF_PERM_MODIFY` 、`PDF_PERM_ANNOTATE` " "などの対応する許可フラグがオフに設定されていても、テキストを抽出したり、コンテンツを追加または変更したりすることができます！該当する場合、法的に適合するアプリケーションを構築する責任があります。" #: ../../document.rst:466 119ec5a546d0492cbc3d44a94c5c6e67 msgid "New in v 1.18.6" msgstr "バージョン 1.18.6 での新機能" #: ../../document.rst:468 71cef20992634be89bc64e392ac17031 msgid "" "PDF only: Return a list of page numbers that have the specified label -- " "note that labels may not be unique in a PDF. This implies a sequential " "search through **all page numbers** to compare their labels." msgstr "" "PDF のみ：指定されたラベルを持つページ番号のリストを返します。ラベルは PDF " "では一意でないことがあることに注意してください。これは、**すべてのページ番号** を逐次検索してそのラベルを比較することを意味します。" #: ../../document.rst:470 a2a599a9359442d8b21007f88a6371db msgid "Implementation detail -- pages are **not loaded** for this purpose." msgstr "実装の詳細 - この目的でページは **読み込まれません** 。" #: ../../document.rst:472 946caeaeaaec48838a6a321dc1963727 msgid "the label to look for, e.g. \"vii\" (Roman number 7)." msgstr "検索対象のラベル、例： \"vii\"（ローマ数字 7）。" #: ../../document.rst:473 76acb3f67de149159a5b95ff30cb08b6 msgid "" "stop after first hit. Useful e.g. if labelling is known to be unique, or " "there are many pages, etc. The default will check every page number." msgstr "最初の一致で停止します。ラベリングが一意であることがわかっている場合や、多くのページがある場合などに便利です。デフォルトではすべてのページ番号をチェックします。" #: ../../document.rst:475 9adccc3fc8054990ad6014e9041d93de msgid "" "list of page numbers that have this label. Empty if none found, no labels" " defined, etc." msgstr "このラベルを持つページ番号のリスト。見つからない場合やラベルが定義されていない場合などは空です。" #: ../../document.rst:480 ../../document.rst:843 ../../document.rst:864 #: ../../document.rst:1897 ../../document.rst:1921 #: 05910086455448f18e257168cd8e2a36 14ada1583e2942948f2bb1e6134d7866 #: 3450b554a2e0411eacdd819c036cccc2 80adb24663644aa28fa9a11528256936 #: 92afdec41f4a4a328c24a25cbcd0b7a6 msgid "New in v1.18.7" msgstr "バージョン 1.18.7 での新機能" #: ../../document.rst:482 743daa378cfe4792ad9fa83a2909eb8d msgid "" "PDF only: Extract the list of page label definitions. Typically used for " "modifications before feeding it into :meth:`Document.set_page_labels`." msgstr "" "PDF のみ：ページラベルの定義のリストを抽出します。通常は :meth:`Document.set_page_labels` " "に渡す前の変更に使用されます。" #: ../../document.rst:484 0f5d97b8193a461b8fe7e04b712adae9 msgid "a list of dictionaries as defined in :meth:`Document.set_page_labels`." msgstr ":meth:`Document.set_page_labels` で定義されたように辞書のリスト。" #: ../../document.rst:488 244cbe336b1e4cddb8491c05e5ec5b15 msgid "New in v1.18.6" msgstr "バージョン 1.18.6 での新機能" #: ../../document.rst:490 470a1bc4f0404283b7358f77bc840a9d msgid "PDF only: Add or update the page label definitions of the PDF." msgstr "PDF のみ：PDF のページラベルの定義を追加または更新します。" #: ../../document.rst:492 d0c5ec05dc0f4ba5a381635a4cf3c93b msgid "" "a list of dictionaries. Each dictionary defines a label building rule and" " a 0-based \"start\" page number. That start page is the first for which " "the label definition is valid. Each dictionary has up to 4 items and " "looks like `{'startpage': int, 'prefix': str, 'style': str, " "'firstpagenum': int}` and has the following items. - `startpage`: (int) " "the first page number (0-based) to apply the label rule. This key **must " "be present**. The rule is applied to all subsequent pages until either " "end of document or superseded by the rule with the next larger page " "number. - `prefix`: (str) an arbitrary string to start the label with, " "e.g. \"A-\". Default is \"\". - `style`: (str) the numbering style. " "Available are \"D\" (decimal), \"r\"/\"R\" (Roman numbers, lower / upper " "case), and \"a\"/\"A\" (lower / upper case alphabetical numbering: \"a\" " "through \"z\", then \"aa\" through \"zz\", etc.). Default is \"\". If " "\"\", no numbering will take place and the pages in that range will " "receive the same label consisting of the `prefix` value. If prefix is " "also omitted, then the label will be \"\". - `firstpagenum`: (int) start " "numbering with this value. Default is 1, smaller values are ignored." msgstr "" #: ../../document.rst:492 0fab77fbe73e4149aa809d1d7d83d4ce msgid "" "a list of dictionaries. Each dictionary defines a label building rule and" " a 0-based \"start\" page number. That start page is the first for which " "the label definition is valid. Each dictionary has up to 4 items and " "looks like `{'startpage': int, 'prefix': str, 'style': str, " "'firstpagenum': int}` and has the following items." msgstr "" "辞書のリスト。各辞書はラベル構築ルールと 0 ベースの \"start\" " "ページ番号を定義します。その開始ページはラベル定義が有効になる最初のページです。各辞書は最大 4 つの項目を持ち、 `{'startpage': " "int, 'prefix': str, 'style': str, 'firstpagenum': int}` という形式で、次の項目を持ちます。" #: ../../document.rst:494 7eeface47e22458b9ccd093d60a289a2 msgid "" "`startpage`: (int) the first page number (0-based) to apply the label " "rule. This key **must be present**. The rule is applied to all subsequent" " pages until either end of document or superseded by the rule with the " "next larger page number." msgstr "" "`startpage` :（int）ラベルルールを適用する最初のページ番号（0 ベース）。このキーは **存在する必要があります** " "。ルールはドキュメントの終端に達するか、次の大きなページ番号を持つルールに置き換えられるまで、すべての後続ページに適用されます。" #: ../../document.rst:495 74fd610222f54117be5ff8aa62d5e852 msgid "" "`prefix`: (str) an arbitrary string to start the label with, e.g. \"A-\"." " Default is \"\"." msgstr "`prefix` :（str）ラベルの先頭に付ける任意の文字列、例： \"A-\"。デフォルトは \"\" です。" #: ../../document.rst:496 27261aba29414162837b13ebf37bfbb9 msgid "" "`style`: (str) the numbering style. Available are \"D\" (decimal), " "\"r\"/\"R\" (Roman numbers, lower / upper case), and \"a\"/\"A\" (lower /" " upper case alphabetical numbering: \"a\" through \"z\", then \"aa\" " "through \"zz\", etc.). Default is \"\". If \"\", no numbering will take " "place and the pages in that range will receive the same label consisting " "of the `prefix` value. If prefix is also omitted, then the label will be " "\"\"." msgstr "" "style:（str）番号付けのスタイル。使用できるのは \"D\"（10 進数）、\"r\"/\"R\"（ローマ数字、小文字/大文字）、および " "\"a\"/\"A\"（小文字/大文字のアルファベット番号： \"a\" から \"z\"、次に \"aa\" から \"zz\" " "など）。デフォルトは \"\" です。 \"\" " "の場合、番号付けは行われず、その範囲のページはプレフィックス値から成る同じラベルを受け取ります。`prefix` も省略された場合、ラベルは " "\"\" になります。" #: ../../document.rst:497 3ceaa9f717194b72bdd2f7f205217200 msgid "" "`firstpagenum`: (int) start numbering with this value. Default is 1, " "smaller values are ignored." msgstr "`firstpagenum` :（int）この値から番号付けを開始します。デフォルトは 1 で、小さい値は無視されます。" #: ../../document.rst:499 2afd6593eaf0423e8afcd6635c826754 msgid "For example::" msgstr "例::" #: ../../document.rst:504 040ded0fb2be4e5cbeadc76208560d19 msgid "" "will generate the labels \"A-10\", \"A-11\", \"A-12\", \"A-13\", \"1\", " "\"2\", \"3\", ... for pages 6, 7 and so on until end of document. Pages 0" " through 5 will have the label \"\"." msgstr "" "次のラベルを生成します: \"A-10\"、\"A-11\"、\"A-12\"、\"A-13\"、\"1\"、\"2\"、\"3\"、... " "ページ 6、7、など、ドキュメントの終了まで続きます。ページ 0 から 5 まではラベル \"A-\" が付きます。" #: ../../document.rst:509 ../../document.rst:523 #: 0aa8b9c83c1b41719f9cbd43feabcdf8 846b39d637a5466f8c256fcfce4f4571 msgid "New in v.1.17.3" msgstr "バージョン 1.17.3 での新機能" #: ../../document.rst:511 12e98a99804a4723ac02582721c5a896 msgid "" "Return a page pointer in a reflowable document. After re-layouting the " "document, the result of this method can be used to find the new location " "of the page." msgstr "リフロータブルなドキュメント内のページポインターを返します。ドキュメントの再レイアウト後、このメソッドの結果はページの新しい位置を見つけるために使用できます。" #: ../../document.rst:513 c31102cafa52492ca638735d028e8d7f msgid "Do not confuse with items of a table of contents, TOC." msgstr "目次の項目とは混同しないでください。" #: ../../document.rst:515 9ffd70204ee543ffa134b90dad39f75a msgid "page location. Must be a valid *(chapter, pno)*." msgstr "ページの位置。有効なものである必要があります *（章、ページ番号）* 。" #: ../../document.rst:518 c028fcff4f6a4c409c5bd4f2c7094af3 msgid "" "a long integer in pointer format. To be used for finding the new location" " of the page after re-layouting the document. Do not touch or re-assign." msgstr "ポインターフォーマットの長整数。ドキュメントの再レイアウト後のページの新しい位置を見つけるために使用されます。変更しないでください。" #: ../../document.rst:525 aae59f9b08ae4ed7b02b7f7a2dd7a991 msgid "Return the new page location after re-layouting the document." msgstr "ドキュメントの再レイアウト後の新しいページの位置を返します。" #: ../../document.rst:527 a8da17fc210f4a43a9d2b4ceb3185c5f msgid "created by :meth:`Document.make_bookmark`." msgstr ":meth:`Document.make_bookmark` によって作成されたもの。" #: ../../document.rst:530 1d07a10894004002a21058fdfeac44af msgid "the new (chapter, pno) of the page." msgstr "ページの新しい（章、ページ番号）。" #: ../../document.rst:535 ../../document.rst:547 ../../document.rst:558 #: 61c1413e338345c9ab33c2b1c5f9decc 6a5cad42e88f4f499c7181e080b1f971 #: 946e1b36b28b4432a39b16f8c68d62e0 msgid "New in v.1.17.0" msgstr "バージョン 1.17.0 での新機能" #: ../../document.rst:537 c8b174e76e7b434db43abd0893095ba8 msgid "Return the number of pages of a chapter." msgstr "章のページ数を返します。" #: ../../document.rst:539 967dfc416734482196f7a8ffa7d45bd4 msgid "the 0-based chapter number." msgstr "0 ベースの章番号。" #: ../../document.rst:542 2a83ec2d4ea54b1897eeb50f82566adc msgid "" "number of pages in chapter. Relevant only for document types with chapter" " support (EPUB currently)." msgstr "章内のページ数。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。" #: ../../document.rst:549 162f24578e6749c8ada15b85d4be6bea msgid "Return the location of the following page." msgstr "次のページの位置を返します。" #: ../../document.rst:551 ../../document.rst:562 #: 76dcbeac58be4a63aa5feb22ccbcc31e b635038017484753aa510b172311664a msgid "" "the current page id. This must be a tuple *(chapter, pno)* identifying an" " existing page." msgstr "現在のページ ID。これは既存のページを識別するタプル *（章、ページ番号）* である必要があります。" #: ../../document.rst:553 077a38466aeb4464b21c75847fc03419 msgid "" "The tuple of the following page, i.e. either *(chapter, pno + 1)* or " "*(chapter + 1, 0)*, **or** the empty tuple *()* if the argument was the " "last page. Relevant only for document types with chapter support (EPUB " "currently)." msgstr "" "次のページのタプル、つまり *（章、ページ番号 + 1）* または *（章 + 1、0）* 、**または** " "引数が最後のページである場合は空のタプル *()* 。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。" #: ../../document.rst:560 540ac91bacd24f2184f90373daac0a7e msgid "Return the locator of the preceding page." msgstr "前のページの位置を返します。" #: ../../document.rst:564 bec578e6b61c4cc9b0f254bbcb0f48b7 msgid "" "The tuple of the preceding page, i.e. either *(chapter, pno - 1)* or the " "last page of the preceding chapter, **or** the empty tuple *()* if the " "argument was the first page. Relevant only for document types with " "chapter support (EPUB currently)." msgstr "" "前のページのタプル、つまり *（章、ページ番号 - 1）* **または** 前の章の最後のページ、または引数が最初のページである場合は空のタプル " "*()* 。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。" #: ../../document.rst:569 68dfefa5502f425289fc497e0d9c6238 msgid "" "Changed in v1.17.0: For document types supporting a so-called \"chapter " "structure\" (like EPUB), pages can also be loaded via the combination of " "chapter number and relative page number, instead of the absolute page " "number. This should **significantly speed up access** for large " "documents." msgstr "" "バージョン 1.17.0 で変更: \"章の構造\" " "をサポートするドキュメントタイプ（例：EPUB）の場合、絶対ページ番号の代わりに章番号と相対ページ番号の組み合わせを使用してページをロードすることもできます。これにより、大きなドキュメントへの" " **アクセスが大幅に高速化される** はずです。" #: ../../document.rst:571 e7a2e814cced49258d2f9b21245d2ce6 msgid "" "Create a :ref:`Page` object for further processing (like rendering, text " "searching, etc.)." msgstr "さらなる処理（レンダリング、テキスト検索など）のための :ref:`Page` オブジェクトを作成します。" #: ../../document.rst:573 ac4b297778cb465a83c732f4f6565380 msgid "" "*(Changed in v1.17.0)* Either a 0-based page number, or a tuple " "*(chapter, pno)*. For an **integer**, any `-∞ < page_id < page_count` is " "acceptable. While page_id is negative, :attr:`page_count` will be added " "to it. For example: to load the last page, you can use " "*doc.load_page(-1)*. After this you have page.number = doc.page_count - " "1. For a tuple, *chapter* must be in range " ":attr:`Document.chapter_count`, and *pno* must be in range " ":meth:`Document.chapter_page_count` of that chapter. Both values are " "0-based. Using this notation, :attr:`Page.number` will equal the given " "tuple. Relevant only for document types with chapter support (EPUB " "currently)." msgstr "" #: ../../document.rst:573 b9bae2aee5bb433692e4d9ced23afc6b msgid "*(Changed in v1.17.0)*" msgstr "*（バージョン 1.17.0 で変更）*" #: ../../document.rst:575 17221ad920ec4edda2e3f56e1ee986a5 msgid "" "Either a 0-based page number, or a tuple *(chapter, pno)*. For an " "**integer**, any `-∞ < page_id < page_count` is acceptable. While page_id" " is negative, :attr:`page_count` will be added to it. For example: to " "load the last page, you can use *doc.load_page(-1)*. After this you have " "page.number = doc.page_count - 1." msgstr "" "0ベースのページ番号またはタプル *（章、ページ番号）* のいずれか。**整数** の場合、`-∞ < page_id < page_count`" " が許容されます。`page_id` が負の場合、 :attr:`page_count` " "が追加されます。たとえば、最後のページを読み込むには、*doc.load_page(-1)* を使用できます。これにより、 " "`page.number = doc.page_count - 1` となります。" #: ../../document.rst:577 039ea62786ac4483a2ff851942f8e61e msgid "" "For a tuple, *chapter* must be in range :attr:`Document.chapter_count`, " "and *pno* must be in range :meth:`Document.chapter_page_count` of that " "chapter. Both values are 0-based. Using this notation, " ":attr:`Page.number` will equal the given tuple. Relevant only for " "document types with chapter support (EPUB currently)." msgstr "" "タプルの場合、*chapter* は :attr:`Document.chapter_count` の範囲内になければならず、*ページ番号* " "はその章の :meth:`Document.chapter_page_count` " "の範囲内になければなりません。両方の値は0から始まります。この表記法を使用すると、:attr:`Page.number` " "は指定されたタプルに等しくなります。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。" #: ../../document.rst:579 ../../document.rst:683 ../../document.rst:1452 #: 0006a5a1428c489b85ee1ef72f368b66 1abd4533c839432f8b762c82cf15dc63 #: 78a10b5d4c74403ab6e8fb90b05f6cc0 msgid ":ref:`Page`" msgstr "" #: ../../document.rst:583 d4516954d08e43daae3d737a83243151 msgid "" "Documents also follow the Python sequence protocol with page numbers as " "indices: *doc.load_page(n) == doc[n]*." msgstr "" "ドキュメントはページ番号をインデックスとするPythonのシーケンスプロトコルに従います：indices: *doc.load_page(n) " "== doc[n]* 。" #: ../../document.rst:585 caf16253efc94349815ad78668652297 msgid "" "For **absolute page numbers** only, expressions like *\"for page in doc: " "...\"* and *\"for page in reversed(doc): ...\"* will successively yield " "the document's pages. Refer to :meth:`Document.pages` which allows " "processing pages as with slicing." msgstr "" "**絶対ページ番号** の場合、式 *\"for page in doc: …\"* および *\"for page in " "reversed(doc): …\"* は文書のページを順次生成します。スライシングのようにページを処理できる " ":meth:`Document.pages` を参照してください。" #: ../../document.rst:587 4eec9f75b1a648e5954520327f163582 msgid "" "You can also use index notation with the new chapter-based page " "identification: use *page = doc[(5, 2)]* to load the third page of the " "sixth chapter." msgstr "" "新しい章ベースのページ識別にもインデックス表記を使用できます： *page = doc[(5, 2)]* として、 " "6番目の章の3番目のページを読み込むことができます。" #: ../../document.rst:589 d88b05b23ebe48cdbc81a8716291829e msgid "" "To maintain a consistent API, for document types not supporting a chapter" " structure (like PDFs), :attr:`Document.chapter_count` is 1, and pages " "can also be loaded via tuples *(0, pno)*. See this [#f3]_ footnote for " "comments on performance improvements." msgstr "" "一貫性のあるAPIを維持するため、章の構造をサポートしていないドキュメントタイプ（PDFなど）の場合、:attr:`Document.chapter_count`" " は1であり、ページはタプル *（0、pno）* を使用しても読み込むことができます。パフォーマンスの改善に関するコメントについては、この " "[#f3]_ の注釈を参照してください。" #: ../../document.rst:594 5877b0a8ee034827a6486e55a27c1721 msgid "" "PDF only: Walk through all images and rewrite them according to the " "specified parameters. This is useful for reducing file size, changing " "image formats, or converting color spaces." msgstr "" #: ../../document.rst:596 1894640743d14d81939992952b89a89f msgid "" "The typical usage is extra compression of images for significantly " "reducing the file size of the PDF. When setting quality and the dpi " "parameters to positive values and accepting defaults for the rest, the " "following will happen:" msgstr "" #: ../../document.rst:598 3a74a4a4263048e1bfc0579a97bb35b8 msgid "" "Lossy and lossless images will be rewritten as JPEG images " "(FZ_RECOMPRESS_JPEG) as far as technically possible." msgstr "" #: ../../document.rst:600 01a553ed3bbe401db8ad3152294f8695 msgid "" "Bitonal (monochrome) images will be rewritten in FAX format " "(FZ_RECOMPRESS_FAX)." msgstr "" #: ../../document.rst:602 38e8687fa2994142bc5da75bec6d83e2 msgid "Subsampling method is **FZ_SUBSAMPLE_AVERAGE** (see below)." msgstr "" #: ../../document.rst:604 79b3413d2429401d99ae3a43030056f6 msgid "" "target DPI value for the resampled images. Ignored if `dpi_threshold` is " "`None`, otherwise must be less than `dpi_threshold` and positive." msgstr "" #: ../../document.rst:606 41d9689ed361448fbcb5a13023c76806 msgid "" "If None (the default) no resampling takes place. Otherwise images with a " "DPI value larger than this will be resampled to `dpi_target` (which must " "be less than `dpi_threshold`)." msgstr "" #: ../../document.rst:608 29da9ea4d0af4d69a22f61ffa363e949 msgid "" "desired target JPEG quality, a value between 0 and 100. 0 means no " "quality change, 100 means best quality." msgstr "" #: ../../document.rst:610 1aa75d1dd8f3426d8dcb2ebb3b2e4c90 msgid "include lossy image types (e.g. JPEG)." msgstr "" #: ../../document.rst:612 9697131e0d414bb4933c23e702734b4d msgid "include lossless image types (e.g. PNG)." msgstr "" #: ../../document.rst:614 0c8117c9cafd459880a5aec4cc9d974d msgid "include black-and-white images (e.g. FAX)." msgstr "" #: ../../document.rst:616 21bb122962844205b76401ccbbb01a30 msgid "include colored images." msgstr "" #: ../../document.rst:618 2eb49df120b7429296a9281ccd362ad8 msgid "include grayscale images." msgstr "" #: ../../document.rst:620 b54e5d5881bd40679b8c78f0b46f72ec msgid "" "if True, the PDF will be converted to grayscale by executing " ":meth:`Document.recolor` before all image processing. Please note that " "this will also change text and vector graphics to grayscale -- not just " "the images." msgstr "" #: ../../document.rst:622 3afbe56d4eae4bf291351d87ea284a07 msgid "" "This parameter is intended for expert users. Except ``set_to_gray``, all " "other parameters are ignored. It must be an object prepared in the " "following way: ``options = pymupdf.mupdf.PdfImageRewriterOptions()``. " "Then attributes of this object can be set to achieve fine-grained " "control. Following are the adjustable attributes of the ``options`` " "object and their default (do nothing) values." msgstr "" #: ../../document.rst:652 226b700f0609456da42369d0a574ec09 msgid "" "The ``*_recompress_method`` attributes may be one of the values " "**FZ_RECOMPRESS_NEVER (0), FZ_RECOMPRESS_SAME (1), FZ_RECOMPRESS_LOSSLESS" " (2), FZ_RECOMPRESS_JPEG (3), FZ_RECOMPRESS_J2K (4), FZ_RECOMPRESS_FAX " "(5)**. Value FZ_RECOMPRESS_NEVER will skip this image type altogether and" " FZ_RECOMPRESS_SAME will not change the type. The other values will " "execute type conversions (as far as technically possible)." msgstr "" #: ../../document.rst:654 28345897c04e47cb8bd7b419a399e52e msgid "" "The ``*_quality`` values are strings of integers from \"0\" to \"100\" or" " ``None``." msgstr "" #: ../../document.rst:656 431fb82d92d144e39a7eb33de4cee3d5 msgid "" "The ``*_subsample_method`` attributes are either **FZ_SUBSAMPLE_AVERAGE " "(0)** or **FZ_SUBSAMPLE_BICUBIC (1)** and refer to how a pixel value is " "derived from its neighboring pixels during subsampling. For some " "background see `this Wikipedia article about bicubic interpolation " "`_." msgstr "" #: ../../document.rst:658 a5582d3eeef04969839b567872912234 msgid "" "Attributes ``*_subsample_threshold`` excludes images from subsampling " "which have a lower DPI. Participating images will be subsampled to the " "DPI values given by the ``*_subsample_to`` values. Values of 0 mean that " "no subsampling will take place." msgstr "" #: ../../document.rst:660 c5e4028872844f00bd7eb9ce4c910e75 msgid "" "The ``*_subsample_threshold`` values should be chosen notably larger than" " the ``*_subsample_to`` values to ensure that there are enough size " "savings. After all, every subsampling inevitably incurs quality losses." msgstr "" #: ../../document.rst:662 4021cd52c00c475ca2229590caeff58a msgid "An example for a good choice is ``threshold=100`` and ``to=72``." msgstr "" #: ../../document.rst:667 62fadb98a46e4b6ab9224f097849e731 msgid "" "PDF only: Change the color component counts for all object types text, " "images and vector graphics for all pages." msgstr "" #: ../../document.rst:669 fac366c35c4f430489dc4d0814e4349d msgid "" "desired color space indicated by the number of color components: 1 = " "DeviceGRAY, 3 = DeviceRGB, 4 = DeviceCMYK." msgstr "" #: ../../document.rst:671 baaefdcc658142cfb2d0d72964381651 msgid "" "The typical use case is 1 (DeviceGRAY) which converts the PDF to " "grayscale." msgstr "" #: ../../document.rst:676 b3feb6280dce4bb68a6d09f67ad179e5 msgid "New in v1.16.10" msgstr "バージョン 1.16.10 での新機能" #: ../../document.rst:678 e20ca78781fd4ff7a8ed580599a1ec63 msgid "" "PDF only: Provide a new copy of a page after finishing and updating all " "pending changes." msgstr "PDF のみ：保留中のすべての変更を終了および更新した後、ページの新しいコピーを提供します。" #: ../../document.rst:680 d63490fa56354fc49d5d536ea547ebe1 msgid "page object." msgstr "ページオブジェクト。" #: ../../document.rst:685 f33b5c1ccafd4b1c975285d4daf5b37d msgid "" "a new copy of the same page. All pending updates (e.g. to annotations or " "widgets) will be finalized and a fresh copy of the page will be loaded. " ".. note:: In a typical use case, a page :ref:`Pixmap` should be taken " "after annotations / widgets have been added or changed. To force all " "those changes being reflected in the page structure, this method re-" "instates a fresh copy while keeping the object hierarchy \"document -> " "page -> annotations/widgets\" intact." msgstr "" #: ../../document.rst:685 5e83a01c5a4f43609931c09d2cd5bf4e msgid "" "a new copy of the same page. All pending updates (e.g. to annotations or " "widgets) will be finalized and a fresh copy of the page will be loaded." msgstr "同じページの新しいコピー。すべての保留中の更新（注釈やウィジェットなど）が確定し、ページの新しいコピーが読み込まれます。" #: ../../document.rst:687 aa9f1f86225a4ad39148e534ef4be453 msgid "" "In a typical use case, a page :ref:`Pixmap` should be taken after " "annotations / widgets have been added or changed. To force all those " "changes being reflected in the page structure, this method re-instates a " "fresh copy while keeping the object hierarchy \"document -> page -> " "annotations/widgets\" intact." msgstr "" "典型的なユースケースでは、注釈やウィジェットが追加または変更された後にページの :ref:`Pixmap` " "を取得する必要があります。これらの変更がページ構造に反映されるようにするために、このメソッドは \"document -> page -> " "annotations/widgets\" のオブジェクト階層を保持したまま、新しいコピーを再設定します。" #: ../../document.rst:692 e255e70994eb4eea840af29512883ee8 msgid "PDF only: Convert destination names into a Python dict." msgstr "PDFのみ: ページの目的地名をPythonの辞書に変換します" #: ../../document.rst:694 e3317825d1b84d09a0976e4563a7d1e8 msgid "" "A dictionary with the following layout: * *key*: (str) the name. * " "*value*: (dict) with the following layout: * \"page\": target page " "number (0-based). If no page number found -1. * \"to\": (x, y) target" " point on page. Currently in PDF coordinates, i.e. point (0,0) is " "the bottom-left of the page. * \"zoom\": (float) the zoom factor." " * \"dest\": (str) only present if the target location on the page " "has not been provided as \"/XYZ\" or if no page number was found. " "Examples:: { '__bookmark_1': {'page': 0, 'to': (0.0, 541.0)," " 'zoom': 0.0}, '__bookmark_2': {'page': 0, 'to': (0.0, 481.45), " "'zoom': 0.0}, } or:: { " "'21154a7c20684ceb91f9c9adc3b677c40': {'page': -1, 'dest': '/XYZ 15.75 " "1486 0'}, ... }" msgstr "" #: ../../document.rst:695 d974d89343f748ec8a5cc27429f3e94d msgid "A dictionary with the following layout:" msgstr "以下のキーを持つ辞書:" #: ../../document.rst:697 f4ac483d1fc042b18a323b154eb5a4f2 msgid "*key*: (str) the name." msgstr "キー: (str) 名前" #: ../../document.rst:703 333b90d0cade45ef8d3c12111bba5ae8 msgid "*value*: (dict) with the following layout:" msgstr "以下のキーを持つ辞書:" #: ../../document.rst:699 1299456f72ed4127a7574602814bfe6f msgid "\"page\": target page number (0-based). If no page number found -1." msgstr "\"page\": 対象のページ番号（0から始まる）。ページ番号が見つからない場合は-1。" #: ../../document.rst:700 7e4c618113094b25b9edc3ad8396e7bf msgid "" "\"to\": (x, y) target point on page. Currently in PDF coordinates, i.e. " "point (0,0) is the bottom-left of the page." msgstr "\"to\": (x, y) ページ上のターゲットポイント。現在はPDF座標であり、つまり点(0,0)がページの左下になります。" #: ../../document.rst:702 cfa4c5d417154aa5a6c373ee783adb27 msgid "\"zoom\": (float) the zoom factor." msgstr "\"zoom\": ターゲットページ上のズームファクター（float）。" #: ../../document.rst:703 37cf95d00aae40aaba647f6bc7c9e566 msgid "" "\"dest\": (str) only present if the target location on the page has not " "been provided as \"/XYZ\" or if no page number was found." msgstr "\"dest\": (str) \"/XYZ\" としてターゲット位置が指定されていない場合や、ページ番号が見つからない場合にのみ存在します。" #: ../../document.rst:705 4171adc015d64c7c9d92bebe575448f8 msgid "Examples::" msgstr "例::" #: ../../document.rst:712 d7fb5dcb203748afb273aac0c2a9a100 msgid "or::" msgstr "または:" #: ../../document.rst:719 a874c7048ebb4429a74d36e9cd9d1ca5 msgid "" "All names found in the catalog under keys \"/Dests\" and \"/Names/Dests\"" " are included." msgstr "キー \"/Dests\" および \"/Names/Dests\" の下でカタログ内に見つかるすべての名前が含まれます。" #: ../../document.rst:722 51b104ce68654b67ab928f76dddb73f1 msgid "New in v1.23.6" msgstr "v1.23.6で新登場" #: ../../document.rst:727 ../../document.rst:737 ../../document.rst:1166 #: ../../document.rst:1176 ../../document.rst:1188 #: 00ae9907f6a54b55baab674cf76aed28 2415dd9f180a4b7382a3d9297719fed0 #: 27ca4d25a0534901a9ec78d94dced53f a3a52436d0f141078ff75591bac0f5bf #: d5f1f55ab01a49bca5f15494ce1880e5 msgid "New in v1.17.7" msgstr "バージョン 1.17.7 での新機能" #: ../../document.rst:729 abe5b967ce1c41568bb16dd577d6a71e msgid "" "PDF only: Return the unrotated page rectangle -- **without loading the " "page** (via :meth:`Document.load_page`). This is meant for internal " "purpose requiring best possible performance." msgstr "" "PDF のみ：ページを読み込まずに（:meth:`Document.load_page` " "を介さずに）、回転を無視してページの長方形を返します。これは、最高のパフォーマンスを必要とする内部目的のために使用されます。" #: ../../document.rst:731 ../../document.rst:741 #: 87245fe71e5749bbb5fdd8323971d38a 9aa5f7f4352646a6874011b4413b9eb2 msgid "0-based page number." msgstr "0から始まるページ番号。" #: ../../document.rst:733 8ae5e02a100d4c57be33964251202070 msgid ":ref:`Rect` of the page like :meth:`Page.rect`, but ignoring any rotation." msgstr ":meth:`Page.rect` のようなページの :ref:`Rect` ですが、回転を無視します。" #: ../../document.rst:739 afe91f4bac4e4f20b4d11da8c7b6a121 msgid "" "PDF only: Return the :data:`xref` of the page -- **without loading the " "page** (via :meth:`Document.load_page`). This is meant for internal " "purpose requiring best possible performance." msgstr "" "PDF のみ： **ページを読み込まずに** （:meth:`Document.load_page` を介さずに）、ページの " ":data:`xref` を返します。これは、最高のパフォーマンスを必要とする内部目的のために使用されます。" #: ../../document.rst:743 e13e841034c54a368597cae910b0bd41 msgid ":data:`xref` of the page like :attr:`Page.xref`." msgstr ":attr:`Page.xref` のようなページの :data:`xref` 。" #: ../../document.rst:747 9212f6c6b841428ea6bd7592d5586fb1 msgid "New in v1.16.4" msgstr "バージョン 1.16.4 での新機能" #: ../../document.rst:749 17449b4eba2f4041965b2d8d7fb19b83 msgid "" "A generator for a range of pages. Parameters have the same meaning as in " "the built-in function *range()*. Intended for expressions of the form " "*\"for page in doc.pages(start, stop, step): ...\"*." msgstr "" "一連のページのためのジェネレーター。パラメーターの意味は組み込みの *range()* 関数と同じです。 *\"for page in " "doc.pages(start, stop, step): …\"* の形式の式に使用することを意図しています。" #: ../../document.rst:751 775c0864ae46420c9c3f515b377a7e2e msgid "" "start iteration with this page number. Default is zero, allowed values " "are `-∞ < start < page_count`. While this is negative, :attr:`page_count`" " is added **before** starting the iteration." msgstr "" "このページ番号から反復を開始します。デフォルトはゼロで、許容値は `-∞ < start < page_count` " "です。負の値の間は反復を開始する **前に** :attr:`page_count` が追加されます。" #: ../../document.rst:752 99edc914fc1f455b97fabaf836e1ebbf msgid "" "stop iteration at this page number. Default is :attr:`page_count`, " "possible are `-∞ < stop <= page_count`. Larger values are **silently " "replaced** by the default. Negative values will cyclically emit the pages" " in reversed order. As with the built-in *range()*, this is the first " "page **not** returned." msgstr "" "このページ番号で反復を停止します。デフォルトは :attr:`page_count` で、可能な値は `-∞ < stop <= " "page_count` です。大きな値はデフォルトで **静かに置き換えられます** 。負の値は逆順でページを循環的に生成します。組み込みの " "*range()* 関数と同様に、これは **返されない** 最初のページです。" #: ../../document.rst:753 94a16241b73e479a8fb39b6e7ecdf23b msgid "" "stepping value. Defaults are 1 if start < stop and -1 if start > stop. " "Zero is not allowed." msgstr "ステップ値。start < stop の場合はデフォルトで1、start > stop の場合は-1です。ゼロは許可されていません。" #: ../../document.rst:755 a7bd93c5ab5640fd8a828ca438a31865 msgid "" "a generator iterator over the document's pages. Some examples: * " "\"doc.pages()\" emits all pages. * \"doc.pages(4, 9, 2)\" emits pages 4, " "6, 8. * \"doc.pages(0, None, 2)\" emits all pages with even numbers. * " "\"doc.pages(-2)\" emits the last two pages. * \"doc.pages(-1, -1)\" emits" " all pages in reversed order. * \"doc.pages(-1, -10)\" always emits 10 " "pages in reversed order, starting with the last page -- **repeatedly** if" " the document has less than 10 pages. So for a 4-page document the " "following page numbers are emitted: 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, " "3." msgstr "" #: ../../document.rst:755 cc92b04eb37d4654ac39f335cb55af6e msgid "a generator iterator over the document's pages. Some examples:" msgstr "ドキュメントのページに対するジェネレーターイテレーターです。いくつかの例:" #: ../../document.rst:757 2aee4283e6af403382105fb2889ef17e msgid "\"doc.pages()\" emits all pages." msgstr "\"doc.pages()\" はすべてのページを生成します。" #: ../../document.rst:758 56483ad2fcb04e8ab0aec6fd11cb6e1f msgid "\"doc.pages(4, 9, 2)\" emits pages 4, 6, 8." msgstr "\"doc.pages(4, 9, 2)\" はページ4、6、8を生成します。" #: ../../document.rst:759 5cd6a791eadb403db8d65526627bdb2d msgid "\"doc.pages(0, None, 2)\" emits all pages with even numbers." msgstr "\"doc.pages(0, None, 2)\" はすべての偶数ページを生成します。" #: ../../document.rst:760 20d5d59f55454cbf886fcc21995dad97 msgid "\"doc.pages(-2)\" emits the last two pages." msgstr "\"doc.pages(-2)\" は最後の2ページを生成します。" #: ../../document.rst:761 591d03692b724c96b7a6d853e1e12b95 msgid "\"doc.pages(-1, -1)\" emits all pages in reversed order." msgstr "\"doc.pages(-1, -1)\" は逆の順序ですべてのページを生成します。" #: ../../document.rst:762 630fb05a54d244e7b9f565ba6c0792b3 msgid "" "\"doc.pages(-1, -10)\" always emits 10 pages in reversed order, starting " "with the last page -- **repeatedly** if the document has less than 10 " "pages. So for a 4-page document the following page numbers are emitted: " "3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, 3." msgstr "" "\"doc.pages(-1, -10)\" は常に逆の順序で10ページを生成し、最後のページから始まり、ドキュメントが10ページ未満の場合は " "**繰り返し** 生成します。したがって、4ページのドキュメントの場合、次のページ番号が生成されます: " "3、2、1、0、3、2、1、0、3、2、1、0、3。" #: ../../document.rst:771 0fa355e484264f9abb37a38413d80d59 msgid "" "Create a PDF version of the current document and write it to memory. " "**All document types** are supported. The parameters have the same " "meaning as in :meth:`insert_pdf`. In essence, you can restrict the " "conversion to a page subset, specify page rotation, and revert page " "sequence." msgstr "" "現在のドキュメントのPDFバージョンを作成し、メモリに書き込みます。**すべてのドキュメントタイプ** がサポートされています。パラメータは " ":meth:`insert_pdf` と同じ意味を持ちます。 " "基本的に、ページのサブセットに変換を制限し、ページの回転を指定し、ページの順序を逆にすることができます。" #: ../../document.rst:773 f660af86d92b44218c359971345422f9 msgid "first page to copy (0-based). Default is first page." msgstr "コピーする最初のページ（0ベース）。デフォルトは最初のページです。" #: ../../document.rst:775 3d05e54e25ec4883ba7e2f21584ced49 msgid "last page to copy (0-based). Default is last page." msgstr "コピーする最後のページ（0ベース）。デフォルトは最後のページです。" #: ../../document.rst:777 e908fe6a3ae046c19144a9205411192b msgid "" "rotation angle. Default is 0 (no rotation). Should be *n * 90* with an " "integer n (not checked)." msgstr "回転角度。デフォルトは0度（回転なし）です。整数n（チェックされていない）で *n * 90* である必要があります。" #: ../../document.rst:780 85de97fa9e5449bc9293fe03eef6116f msgid "" "a Python *bytes* object containing a PDF file image. It is created by " "internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`." " You can output it directly to disk or open it as a PDF. Here are some " "examples:: >>> # convert an XPS file to PDF >>> xps = " "pymupdf.open(\"some.xps\") >>> pdfbytes = xps.convert_to_pdf() >>> >>> # " "either do this --> >>> pdf = pymupdf.open(\"pdf\", pdfbytes) >>> " "pdf.save(\"some.pdf\") >>> >>> # or this --> >>> pdfout = " "open(\"some.pdf\", \"wb\") >>> pdfout.tobytes(pdfbytes) >>> " "pdfout.close() >>> # copy image files to PDF pages >>> # each page will " "have image dimensions >>> doc = pymupdf.open() # new " "PDF >>> imglist = [ ... image file names ...] # e.g. a directory listing " ">>> for img in imglist: imgdoc=pymupdf.open(img) # open" " image as a document pdfbytes=imgdoc.convert_to_pdf() # make a " "1-page PDF of it imgpdf=pymupdf.open(\"pdf\", pdfbytes) " "doc.insert_pdf(imgpdf) # insert the image PDF >>> " "doc.save(\"allmyimages.pdf\")" msgstr "" #: ../../document.rst:780 20b5ab52b58544c4999de0b6274f05b2 msgid "" "a Python *bytes* object containing a PDF file image. It is created by " "internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`." " You can output it directly to disk or open it as a PDF. Here are some " "examples::" msgstr "" "PDFファイルイメージを含むPythonの *bytes* オブジェクト。内部的に `tobytes(garbage=4, " "deflate=True)` を使用して作成されます。:meth:`tobytes` " "を参照してください。これを直接ディスクに出力するか、PDFとして開くことができます。以下にいくつかの例を示します::" #: ../../document.rst:806 d8485f88d433407bb0cd60e194f20727 msgid "" "The method uses the same logic as the *mutool convert* CLI. This works " "very well in most cases -- however, beware of the following limitations." msgstr "" "このメソッドは、*mutool convert* " "CLIと同じロジックを使用しています。これはほとんどの場合非常にうまく機能しますが、以下の制限に注意してください。" #: ../../document.rst:808 357cacd34cd642f39b1da1f75056dc90 msgid "" "Image files: perfect, no issues detected. However, image transparency is " "ignored. If you need that (like for a watermark), use " ":meth:`Page.insert_image` instead. Otherwise, this method is recommended " "for its much better performance." msgstr "" "画像ファイル: 完璧で、問題は検出されません。ただし、画像の透明度は無視されます。透明度が必要な場合（ウォーターマークなど）、代わりに " ":meth:`Page.insert_image` " "を使用してください。それ以外の場合、このメソッドははるかに優れたパフォーマンスのために推奨されます。" #: ../../document.rst:809 06b36e92e8d645b7bc68371b93dbc572 msgid "" "XPS: appearance very good. Links work fine, outlines (bookmarks) are " "lost, but can easily be recovered [#f2]_." msgstr "XPS: 外観は非常に良好です。リンクは正常に機能し、アウトライン（ブックマーク）は失われますが、簡単に回復できます [#f2]_。" #: ../../document.rst:810 8d7b046661b24660b15edfc764b15786 msgid "EPUB, CBZ, FB2: similar to XPS." msgstr "EPUB、CBZ、FB2: XPSと類似しています。" #: ../../document.rst:811 78e1835be7ce41eaa08865503b86c38c msgid "" "SVG: medium. Roughly comparable to `svglib " "`_." msgstr "SVG: 中程度です。おおよそ `svglib `_ と比較できます。" #: ../../document.rst:815 55fb4e92b6f84d06b5b5c8aec273b3e2 msgid "Creates a table of contents (TOC) out of the document's outline chain." msgstr "ドキュメントのアウトラインチェーンから目次（TOC）を作成します。" #: ../../document.rst:817 3c16d727444c4c31980289c39d4e07b3 msgid "" "Indicates whether a simple or a detailed TOC is required. If ``False``, " "each item of the list also contains a dictionary with :ref:`linkDest` " "details for each outline entry." msgstr "" "簡単なTOCまたは詳細なTOCが必要かを示す値です。``False`` の場合、リストの各アイテムにはアウトラインエントリごとの " ":ref:`linkDest` の詳細を含む辞書も含まれます。" #: ../../document.rst:821 e45ac6b1b63f4d28b26628339a2251b7 msgid "" "a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its " "entries have the following meanings: * *lvl* -- hierarchy level " "(positive *int*). The first entry is always 1. Entries in a row are " "either **equal**, **increase** by 1, or **decrease** by any number. * " "*title* -- title (*str*) * *page* -- 1-based source page number (*int*). " "`-1` if no destination or outside document. * *dest* -- (*dict*) included" " only if *simple=False*. Contains details of the TOC item as follows: " "- kind: destination kind, see :ref:`linkDest Kinds`. - file: filename " "if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`. - page: target " "page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only. - to: " "position on target page (:ref:`Point`). - zoom: (float) zoom factor on " "target page. - xref: :data:`xref` of the item (0 if no PDF). - color:" " item color in PDF RGB format `(red, green, blue)`, or omitted (always " "omitted if no PDF). - bold: true if bold item text or omitted. PDF " "only. - italic: true if italic item text, or omitted. PDF only. - " "collapse: true if sub-items are folded, or omitted. PDF only. - " "nameddest: target name if kind=4. PDF only. (New in 1.23.7.)" msgstr "" #: ../../document.rst:821 1f4b3e4744174653ae693109208dc49e msgid "" "a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its " "entries have the following meanings:" msgstr "リストのリスト。各エントリは次の形式を持っています: *[lvl, title, page, dest]* 。そのエントリは次の意味を持っています:" #: ../../document.rst:823 e192fb552d1c4616a8fb7a8144812e58 msgid "" "*lvl* -- hierarchy level (positive *int*). The first entry is always 1. " "Entries in a row are either **equal**, **increase** by 1, or **decrease**" " by any number." msgstr "" "*lvl* – 階層レベル（正の整数）。最初のエントリは常に1です。行内のエントリは **等しい** か、1ずつ **増加** または任意の数で " "**減少** します。" #: ../../document.rst:824 29ecc17d35fa4115831c070fb3dc3da6 msgid "*title* -- title (*str*)" msgstr "*title* – タイトル（*str*）" #: ../../document.rst:825 b5a9d59ce8954429a123261cd1e5e2ce msgid "" "*page* -- 1-based source page number (*int*). `-1` if no destination or " "outside document." msgstr "*page* – 1から始まるページ番号（*int*）。`-1` の場合、宛先なしまたはドキュメント外。" #: ../../document.rst:826 1ed7122c8921425fa82f34ab81b0e14a msgid "" "*dest* -- (*dict*) included only if *simple=False*. Contains details of " "the TOC item as follows:" msgstr "*dest* – (*dict*) *simple=False* の場合のみ含まれます。TOCアイテムの詳細が以下のように含まれます:" #: ../../document.rst:828 18fd10a0fe68426b8268f99befab8ea5 msgid "kind: destination kind, see :ref:`linkDest Kinds`." msgstr "kind: 宛先の種類、:ref:`linkDest Kinds` を参照。" #: ../../document.rst:829 aeeca928a4f149d4b22d0f844cb317ce msgid "file: filename if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." msgstr "file: `kind` が :data:`LINK_GOTOR` または :data:`LINK_LAUNCH` の場合のファイル名。" #: ../../document.rst:830 21331bc906fb47aa9693dfe714690418 msgid "page: target page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only." msgstr "page: ターゲットページ、0ベース、:data:`LINK_GOTOR` または :data:`LINK_GOTO` の場合のみ。" #: ../../document.rst:831 129a6492e95f4d6b9235c8566486f1cd msgid "to: position on target page (:ref:`Point`)." msgstr "to: ターゲットページ上の位置 (:ref:`Point`)。" #: ../../document.rst:832 1760adf4a8fe4f5d916c06a0718c0b3c msgid "zoom: (float) zoom factor on target page." msgstr "zoom: ターゲットページ上のズームファクター（float）。" #: ../../document.rst:833 b72db90d2fd5463883c5566c8d708676 msgid "xref: :data:`xref` of the item (0 if no PDF)." msgstr "xref: アイテムの :data:`xref` （PDFがない場合は0）。" #: ../../document.rst:834 ef52959e5a364bbdbede8eba835399d0 msgid "" "color: item color in PDF RGB format `(red, green, blue)`, or omitted " "(always omitted if no PDF)." msgstr "color: PDF RGB形式 `(red, green, blue)` のアイテムカラー、または省略（PDFがない場合は常に省略）。" #: ../../document.rst:835 c6abd3655b1041c49d660425bdda3b9d msgid "bold: true if bold item text or omitted. PDF only." msgstr "bold: アイテムテキストが太字の場合、または省略。PDFのみ。" #: ../../document.rst:836 790bd5ed794d4267aa960bc8d4ea5458 msgid "italic: true if italic item text, or omitted. PDF only." msgstr "italic: アイテムテキストがイタリックの場合、または省略。PDFのみ。" #: ../../document.rst:837 7a972813f0bc46f2aec437108637c21c msgid "collapse: true if sub-items are folded, or omitted. PDF only." msgstr "collapse: サブアイテムが折りたたまれている場合、または省略。PDFのみ。" #: ../../document.rst:838 0a4c3b65b69e40f2bc742b0f74fa774e msgid "nameddest: target name if kind=4. PDF only. (New in 1.23.7.)" msgstr "" #: ../../document.rst:845 a5836c5cdff0458b8bee0e893e323504 msgid "" "PDF only: Return the PDF dictionary keys of the :data:`dictionary` object" " provided by its xref number." msgstr "PDFのみ: xref番号で提供される :data:`dictionary` オブジェクトのPDF辞書キーを返します。" #: ../../document.rst:847 05b0b53203ac4aa9b0d24d401d355137 msgid "" "the :data:`xref`. *(Changed in v1.18.10)* Use `-1` to access the special " "dictionary \"PDF trailer\"." msgstr ":data:`xref` 。 *(v1.18.10で変更)* \"PDF trailer\" としてアクセスするには `-1` を使用します。" #: ../../document.rst:849 608982aaeb9c4e0483f619e22304399f msgid "" "a tuple of dictionary keys present in object :data:`xref`. Examples: >>>" " from pprint import pprint >>> import pymupdf >>> " "doc=pymupdf.open(\"pymupdf.pdf\") >>> xref = doc.page_xref(0) # xref of " "page 0 >>> pprint(doc.xref_get_keys(xref)) # primary level keys of a " "page ('Type', 'Contents', 'Resources', 'MediaBox', 'Parent') >>> " "pprint(doc.xref_get_keys(-1)) # primary level keys of the trailer " "('Type', 'Index', 'Size', 'W', 'Root', 'Info', 'ID', 'Length', 'Filter') " ">>>" msgstr "" #: ../../document.rst:849 df215624f145490e82a53931b1a144ba msgid "a tuple of dictionary keys present in object :data:`xref`. Examples:" msgstr ":data:`xref` オブジェクトに存在する辞書キーのタプル。例:" #: ../../document.rst:866 6575211909ea416eb59abe9e9d74b18a msgid "" "PDF only: Return type and value of a PDF dictionary key of a " ":data:`dictionary` object given by its xref." msgstr "PDFのみ: xrefによって提供される :data:`dictionary` オブジェクトのPDF辞書キーの戻り値の型と値を返します。" #: ../../document.rst:868 e72020a16f2c46d9b9c110390a8ef3b8 msgid "" "the :data:`xref`. *Changed in v1.18.10:* Use `-1` to access the special " "dictionary \"PDF trailer\"." msgstr ":data:`xref` 。*v1.18.10で変更:* 特別な辞書 \"PDF trailer\" にアクセスするには `-1` を使用します。" #: ../../document.rst:870 15710a8605c242738c9d34bc9295c2a8 msgid "" "the desired PDF key. Must **exactly** match (case-sensitive) one of the " "keys contained in :meth:`Document.xref_get_keys`." msgstr "" "望ましいPDFキー。:meth:`Document.xref_get_keys` " "に含まれるキーのいずれかと厳密に一致する必要があります（大文字と小文字を区別します）。" #: ../../document.rst:874 1d8b5b14cc604c8097524b1e8ce3bd1a msgid "" "A tuple (type, value) of strings, where type is one of \"xref\", " "\"array\", \"dict\", \"int\", \"float\", \"null\", \"bool\", \"name\", " "\"string\" or \"unknown\" (should not occur). Independent of \"type\", " "the value of the key is **always** formatted as a string -- see the " "following example -- and (almost always) a faithful reflection of what is" " stored in the PDF. In most cases, the format of the value string also " "gives a clue about the key type:" msgstr "" "文字列のタプル（type、value）、ここでtypeは次のいずれかです: " "\"xref\"、\"array\"、\"dict\"、\"int\"、\"float\"、\"null\"、\"bool\"、\"name\"、\"string\"" " または \"unknown\"（発生しないはず）。\"type\" に関係なく、キーの値は **常に** 文字列としてフォーマットされます – " "以下の例を参照 – " "そして（ほとんどの場合）PDFに格納されている内容の忠実な反映です。ほとんどの場合、値文字列のフォーマットもキーのタイプについてのヒントを提供します:" #: ../../document.rst:876 f3a754b526724add862cf709d3e6a80f msgid "A \"name\" always starts with a \"/\" slash." msgstr "\"name\" は常に \"/\" スラッシュで始まります。" #: ../../document.rst:877 156bcb3e4be0431a950ef8733fb4726f msgid "An \"xref\" always ends with \" 0 R\"." msgstr "\"xref\" は常に \" 0 R\" で終わります。" #: ../../document.rst:878 028b075a7b6743b4992177c05b64dd3c msgid "An \"array\" is always enclosed in \"[...]\" brackets." msgstr "\"array\" は常に \"[...]\" 角括弧で囲まれています。" #: ../../document.rst:879 498042f7ba7941f489e490897176da71 msgid "A \"dict\" is always enclosed in \"<<...>>\" brackets." msgstr "\"dict\" は常に \"<<...>>\" 角括弧で囲まれています。" #: ../../document.rst:880 9a602b09b09445b8ab3a85710d4daff4 msgid "" "A \"bool\", resp. \"null\" always equal either \"true\", \"false\", resp." " \"null\"." msgstr "\"bool\" または \"null\" は常に \"true\"、\"false\" または \"null\" のいずれかです。" #: ../../document.rst:881 3599f60a08a442d2a3fe36a99d5cbfbe msgid "" "\"float\" and \"int\" are represented by their string format -- and are " "thus not always distinguishable." msgstr "\"float\" と \"int\" は文字列形式で表され、したがって常に区別できるわけではありません。" #: ../../document.rst:882 178b674795594e1d8c179336c614b1c2 msgid "" "A \"string\" is converted to UTF-8 and may therefore deviate from what is" " stored in the PDF. For example, the PDF key \"Author\" may have a value " "of \"\" in the " "file, but the method will return `('string', 'Jorj X. McKie')`." msgstr "" "\"string\" はUTF-8に変換され、したがってPDFに格納されている内容と異なる場合があります。たとえば、PDFキー " "\"Author\" はファイル内で " "\"FEFF004A006F0072006A00200058002E0020004D0063004B00690065\" " "という値を持つかもしれませんが、このメソッドは `('string', 'Jorj X. McKie')` を返します。" #: ../../document.rst:911 5ec6251f88fd4c9a8f9aa0c0de4ef793 msgid "New in v1.18.7, changed in v 1.18.13" msgstr "バージョン1.18.7で新規追加、バージョン1.18.13で変更されました。" #: ../../document.rst:912 277a8925b1254249865a344d4e15ce92 msgid "Changed in v1.19.4: remove a key \"physically\" if set to \"null\"." msgstr "バージョン1.19.4で変更: \"null\" に設定された場合、キーを \"物理的に\" 削除します。" #: ../../document.rst:914 3800031db9924e0b93e21a204f5abfd2 msgid "" "PDF only: Set (add, update, delete) the value of a PDF key for the " ":data:`dictionary` object given by its xref." msgstr "PDFのみ: xrefによって提供される :data:`dictionary` オブジェクトのPDFキーの値を設定（追加、更新、削除）します。" #: ../../document.rst:916 87400e3bfd904856bd104cdc238c25ef msgid "" "This is an expert function: if you do not know what you are doing, there " "is a high risk to render (parts of) the PDF unusable. Please do consult " ":ref:`AdobeManual` about object specification formats (page 18) and the " "structure of special dictionary types like page objects." msgstr "" "これはエキスパート向けの機能です。何をしているのかわからない場合、PDFの（一部の）使用不能の高いリスクがあります。PDFオブジェクト仕様フォーマット（ページ18）やページオブジェクトなどの特別な辞書タイプの構造については" " :ref:`AdobeManual` を参照してください。" #: ../../document.rst:918 249156cd0aa4484c824c8bd971c5f55d msgid "" "the :data:`xref`. *Changed in v1.18.13:* To update the PDF trailer, " "specify -1." msgstr ":data:`xref` 。バージョン1.18.13で変更: PDFトレーラーを更新する場合、-1を指定します。" #: ../../document.rst:919 defb25fd803549ecbd76352234501833 msgid "" "the desired PDF key (without leading \"/\"). Must not be empty. Any valid" " PDF key -- whether already present in the object (which will be " "overwritten) -- or new. It is possible to use PDF path notation like " "`\"Resources/ExtGState\"` -- which sets the value for key " "`\"/ExtGState\"` as a sub-object of `\"/Resources\"`." msgstr "" "望ましいPDFキー（先頭の \"/\" " "なし）。空であってはいけません。既にオブジェクト内に存在するかどうかに関係なく、新しいPDFキーでも構いません。PDFパス表記 " "（`\"Resources/ExtGState\"` のような）を使用して、`\"/Resources\"` のサブオブジェクトとしてキー " "`\"/ExtGState\"` の値を設定することも可能です。" #: ../../document.rst:920 90eda3333fa54a88ba8598e27bdc720a msgid "" "the value for the key. It must be a non-empty string and, depending on " "the desired PDF object type, the following rules must be observed. There " "is some syntax checking, but **no type checking** and no checking if it " "makes sense PDF-wise, i.e. **no semantics checking**. Upper / lower case " "is important!" msgstr "キーの値。空でない文字列である必要があり、望ましいPDFオブジェクトのタイプに応じて以下のルールを守る必要があります。一部の構文チェックは行われますが、型チェックやPDFとして意味があるかどうかのチェックは行われません。大文字と小文字の区別が重要です！" #: ../../document.rst:922 a7fd503efdb34cf08f1886ee7162fb2f msgid "" "*:data:`xref`* -- must be provided as `\"nnn 0 R\"` with a valid " ":data:`xref` number nnn of the PDF. The suffix \"`0 R`\" is required to " "be recognizable as an xref by PDF applications." msgstr "" "*:data:`xref`* – 有効なPDFのxref番号nnnを持つ `\"nnn 0 R\"` として提供される必要があります。サフィックス" " \"`0 R`\" はPDFアプリケーションによって :data:`xref` として認識されるため必要です。" #: ../../document.rst:923 80568ddddb28424aafbeb4bfb8629262 msgid "" "**array** -- a string like `\"[a b c d e f]\"`. The brackets are " "required. Array items must be separated by at least one space (not commas" " like in Python). An empty array `\"[]\"` is possible and *equivalent* to" " removing the key. Array items may be any PDF objects, like dictionaries," " xrefs, other arrays, etc. Like in Python, array items may be of " "different types." msgstr "" "**array** – `\"[a b c d e f]\"` " "のような文字列。角括弧が必要です。配列の要素は少なくとも1つのスペースで区切られている必要があります（Pythonのようなカンマではありません）。空の配列" " `\"[]\"` も可能で、キーを削除することと *同等* " "です。配列のアイテムは、辞書、xref、他の配列など、PDFオブジェクトである必要があります。Pythonと同様に、配列のアイテムは異なるタイプである場合があります。" #: ../../document.rst:924 8776c9b8b4a24c0591f8ceec49ed2dca msgid "" "**dict** -- a string like `\"<< ... >>\"`. The brackets are required and " "must enclose a valid PDF dictionary definition. The empty dictionary " "`\"<<>>\"` is possible and *equivalent* to removing the key." msgstr "" "**dict** – `\"<< ... >>\"` のような文字列。角括弧が必要で、有効なPDF辞書定義を囲む必要があります。空の辞書 " "`\"<<>>\"` も可能で、キーを削除することと *同等* です。" #: ../../document.rst:925 e8b31a1d2c3a4878a02465e970ff484d msgid "**int** -- an integer formatted **as a string**." msgstr "**int** – **文字列として** フォーマットされた整数。" #: ../../document.rst:926 4efb1d2d1f8248bd9c93bdbed526f048 msgid "" "**float** -- a float formatted **as a string**. Scientific notation (with" " exponents) is **not allowed by PDF**." msgstr "**float** – 文字列としてフォーマットされた浮動小数点数。科学的表記法（指数を含む）は **PDFでは許可されていません** 。" #: ../../document.rst:927 28ad2273e2b04ec1a4e28b1e8627be22 msgid "" "**null** -- the string `\"null\"`. This is the PDF equivalent to Python's" " `None` and causes the key to be ignored -- however not necessarily " "removed, resp. removed on saves with garbage collection. *Changed in " "v1.19.4:* If the key is no path hierarchy (i.e. contains no slash \"/\")," " then it will be completely removed." msgstr "" "**null** – 文字列 `\"null\"`。これはPythonの `None` " "に相当し、キーを無視させますが、必ずしも削除されるわけではありません。ガベージコレクションを伴う保存時に削除される場合があります。*バージョン1.19.4で変更:*" " キーがパス階層でない場合（つまりスラッシュ \"/\" を含まない場合）、それは完全に削除されます。" #: ../../document.rst:928 adabb0e0f0ed4a6681b1296c1502547a msgid "**bool** -- one of the strings `\"true\"` or `\"false\"`." msgstr "**bool** – `\"true\"` または `\"false\"` のいずれかの文字列。" #: ../../document.rst:929 1594ca312d7f48acbc4d82268247f9ee msgid "" "**name** -- a valid PDF name with a leading slash like this: " "`\"/PageLayout\"`. See page 16 of the :ref:`AdobeManual`." msgstr "" "**name** – `\"/PageLayout\"` のように先頭にスラッシュを持つ有効なPDF名。:ref:`AdobeManual` " "のページ16を参照してください。" #: ../../document.rst:930 28a5e09473bf4296a58a3ec3460e12be msgid "" "**string** -- a valid PDF string. **All PDF strings must be enclosed by " "brackets**. Denote the empty string as `\"()\"`. Depending on its " "content, the possible brackets are" msgstr "" "**string** – 有効なPDF文字列。 **すべてのPDF文字列は角括弧で囲まれている必要があります** 。空の文字列は `\"()\"`" " として表記されます。内容に応じて、可能な角括弧は次の通りです。" #: ../../document.rst:932 bf4426b2937d496185dc5ca3086d1560 msgid "" "\"(...)\" for ASCII-only text. Reserved PDF characters must be backslash-" "escaped and non-ASCII characters must be provided as 3-digit backslash-" "escaped octals -- including leading zeros. Example: 12 = 0x0C must be " "encoded as `\\014`." msgstr "" "\"(…)\"：ASCIIのテキストの場合。予約されたPDF文字はバックスラッシュでエスケープし、非ASCII文字は先頭にゼロパディングされた3桁のバックスラッシュエスケープの8進数で提供する必要があります。例:" " 12 = 0x0C は `\\014` としてエンコードする必要があります。" #: ../../document.rst:933 b3138023eeab42d8976d82ae328a48e7 msgid "" "\"<...>\" for hex-encoded text. Every character must be represented by " "two hex-digits (lower or upper case)." msgstr "\"<…>\"：16進数でエンコードされたテキストの場合。各文字は2桁の16進数で表されなければなりません（大文字または小文字）。" #: ../../document.rst:935 04514ffed9104a3f82cba27d60dae539 msgid "" "If in doubt, we **strongly recommend** to use :meth:`get_pdf_str`! This " "function automatically generates the right brackets, escapes, and overall" " format. It will for example do conversions like these:" msgstr "" "疑念がある場合は、:meth:`get_pdf_str` " "の使用を**強くお勧めします**！この関数は自動的に適切な角括弧、エスケープ、および全体のフォーマットを生成します。たとえば、次のような変換を行います。" #: ../../document.rst:947 e157d6a6ebb44a58a5382b3125619640 msgid "" "Creates a pixmap from page *pno* (zero-based). Invokes " ":meth:`Page.get_pixmap`." msgstr "*pno* （ゼロベース）のページからピクスマップを作成します。:meth:`Page.get_pixmap` を呼び出します。" #: ../../document.rst:949 bb646c2e759e4d2bbee44f4ad97ec08e msgid "All parameters except `pno` are *keyword-only.*" msgstr "`pno` 以外のすべてのパラメーターは *キーワード専用* です。" #: ../../document.rst:951 663b27e190f34a04a42b233cf48b0d2d msgid "page number, 0-based in `-∞ < pno < page_count`." msgstr "pno (int) – ページ番号、ゼロベース、`-∞ < pno < page_count`。" #: ../../document.rst:953 83e16eb54fbc471cbb9c5e21748734af msgid ":ref:`Pixmap`" msgstr "" #: ../../document.rst:957 4aaceb696b71426cac76aa4f65fadab7 msgid "New in v1.16.13" msgstr "バージョン1.16.13で新規追加" #: ../../document.rst:958 b4622be6eecf433d824b4e0092311b23 msgid "Changed in v1.18.11" msgstr "バージョン1.18.11で変更" #: ../../document.rst:960 a50d47a57f9a458cbdb6f4c19c9ecc2f msgid "PDF only: Return a list of all XObjects referenced by a page." msgstr "PDFのみ: ページによって参照されるすべてのXObjectのリストを返します。" #: ../../document.rst:962 ../../document.rst:977 ../../document.rst:1004 #: b512284cd0944db08267225142b30973 b7a9d1c1640a44e49194253e80f28940 #: bcc36ae910474f22b80c5aeb1e3cd296 msgid "page number, 0-based, `-∞ < pno < page_count`." msgstr "ページ番号、ゼロベース、`-∞ < pno < page_count`。" #: ../../document.rst:965 c4fd71139bd44bb8ada4e97a475737cd msgid "" "a list of (non-image) XObjects. These objects typically represent pages " "*embedded* (not copied) from other PDFs. For example, " ":meth:`Page.show_pdf_page` will create this type of object. An item of " "this list has the following layout: `(xref, name, invoker, bbox)`, where" " * *:data:`xref`* (*int*) is the XObject's :data:`xref`. * **name** " "(*str*) is the symbolic name to reference the XObject. * **invoker** " "(*int*) the :data:`xref` of the invoking XObject or zero if the page " "directly invokes it. * **bbox** (:ref:`Rect`) the boundary box of the " "XObject's location on the page **in untransformed coordinates**. To get " "actual, non-rotated page coordinates, multiply with the page's " "transformation matrix :attr:`Page.transformation_matrix`. *Changed in " "v.18.11:* the bbox is now formatted as :ref:`Rect`." msgstr "" #: ../../document.rst:965 21d6f7f8ef56493e8984e44eec7d841b msgid "" "a list of (non-image) XObjects. These objects typically represent pages " "*embedded* (not copied) from other PDFs. For example, " ":meth:`Page.show_pdf_page` will create this type of object. An item of " "this list has the following layout: `(xref, name, invoker, bbox)`, where" msgstr "" "（画像でない）XObjectのリスト。これらのオブジェクトは通常、他のPDFから **埋め込まれた** " "（コピーされていない）ページを表します。例えば、:meth:`Page.show_pdf_page` " "はこのタイプのオブジェクトを作成します。このリストのアイテムは以下のレイアウトを持っています：`(xref, name, invoker, " "bbox)`、ここで" #: ../../document.rst:967 d6f78447afef45d7a168cf13ab89fbcc msgid "*:data:`xref`* (*int*) is the XObject's :data:`xref`." msgstr "*:data:`xref`* (*int*) はXObjectの :data:`xref` です。" #: ../../document.rst:968 2f42c8f85790488dbce62e7093baa9c5 msgid "**name** (*str*) is the symbolic name to reference the XObject." msgstr "**name** (*str*) はXObjectを参照するための象徴的な名前です。" #: ../../document.rst:969 2355cf43667b42aaae40b91b5a5937b9 msgid "" "**invoker** (*int*) the :data:`xref` of the invoking XObject or zero if " "the page directly invokes it." msgstr "" "**invoker** (*int*) は、ページがそれを直接呼び出す場合はゼロ、それ以外の場合は呼び出し元XObjectの " ":data:`xref` です。" #: ../../document.rst:970 ce656f07b3d3474ba08d6e123b8117c4 msgid "" "**bbox** (:ref:`Rect`) the boundary box of the XObject's location on the " "page **in untransformed coordinates**. To get actual, non-rotated page " "coordinates, multiply with the page's transformation matrix " ":attr:`Page.transformation_matrix`. *Changed in v.18.11:* the bbox is now" " formatted as :ref:`Rect`." msgstr "" "**bbox** (:ref:`Rect`) はXObjectのページ上の位置の境界ボックスで、**変換されていない座標で** " "表されます。実際の、回転していないページ座標を取得するには、ページの変換行列 :attr:`Page.transformation_matrix`" " を掛けてください。*バージョン1.18.11で変更:* **bbox** は今や :ref:`Rect` としてフォーマットされています。" #: ../../document.rst:975 6fe8a93907b94d18969a4b9ab14c4359 msgid "" "PDF only: Return a list of all images (directly or indirectly) referenced" " by the page." msgstr "PDFのみ: ページによって参照されるすべての画像（直接または間接的に）のリストを返します。" #: ../../document.rst:978 9f4e6fd3f1e04b22a5a95840ab1550ff msgid "" "whether to also include the referencer's :data:`xref` (which is zero if " "this is the page)." msgstr "このページがそのページ自体の場合、参照元の :data:`xref` も含めるかどうか（これがページの場合はゼロ）。" #: ../../document.rst:982 4efb3fbf341f42098699c1b7689ee45c msgid "" "a list of images **referenced** by this page. Each item looks like: " "`(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, " "filter, referencer)` * ``xref`` (*int*) is the image object number *" " ``smask`` (*int*) is the object number of its soft-mask image * " "``width`` (*int*) is the image width * ``height`` (*int*) is the image " "height * ``bpc`` (*int*) denotes the number of bits per component " "(normally 8) * ``colorspace`` (*str*) a string naming the colorspace " "(like **DeviceRGB**) * ``alt_colorspace`` (*str*) is any alternate " "colorspace depending on the value of **colorspace** * ``name`` (*str*) " "is the symbolic name by which the image is referenced * ``filter`` " "(*str*) is the decode filter of the image (:ref:`AdobeManual`, pp. 22)." " * ``referencer`` (*int*) the :data:`xref` of the referencer. Zero if " "directly referenced by the page. Only present if *full=True*." msgstr "" #: ../../document.rst:982 8f9928f663504d3d9168282aed83e5cc #, fuzzy msgid "a list of images **referenced** by this page. Each item looks like:" msgstr "このページで **参照されている** 画像のリスト。各アイテムは以下のようになります：" #: ../../document.rst:984 00f4ef107d1c4db385603c6339a76099 msgid "" "`(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, " "filter, referencer)`" msgstr "" #: ../../document.rst:986 3d896dcb29714890a22bfb1f0ffc4a34 #, fuzzy msgid "``xref`` (*int*) is the image object number" msgstr "*:data:`xref`* (*int*) は画像オブジェクトの番号です" #: ../../document.rst:987 9acc8321d4094ed1b2397b95f2886d22 #, fuzzy msgid "``smask`` (*int*) is the object number of its soft-mask image" msgstr "**smask** (*int*) はそのソフトマスク画像のオブジェクト番号です" #: ../../document.rst:988 0f53d4a9d9074947a83aab2d9a176cb1 #, fuzzy msgid "``width`` (*int*) is the image width" msgstr "*width* (*int*) 画像の幅" #: ../../document.rst:989 35c2acc0727549249953c971d8917290 #, fuzzy msgid "``height`` (*int*) is the image height" msgstr "*height* (*int*) 画像の高さ" #: ../../document.rst:990 7413ba2b65df40ec96a73858402002a4 #, fuzzy msgid "``bpc`` (*int*) denotes the number of bits per component (normally 8)" msgstr "**bpc** (*int*) はコンポーネントごとのビット数を示します（通常は8）" #: ../../document.rst:991 b43082aeae534bf3af1fdd913d40e5b1 #, fuzzy msgid "``colorspace`` (*str*) a string naming the colorspace (like **DeviceRGB**)" msgstr "**colorspace** (*str*) は色空間の名前を示す文字列です（ **DeviceRGB** など）" #: ../../document.rst:992 029549b0601a446da7e5e1b15bdc3f5d #, fuzzy msgid "" "``alt_colorspace`` (*str*) is any alternate colorspace depending on the " "value of **colorspace**" msgstr "**alt. colorspace** (*str*) は **colorspace** の値に依存する代替の色空間です" #: ../../document.rst:993 e2137f9fc6d845d4b63d058fc6cd19d3 #, fuzzy msgid "``name`` (*str*) is the symbolic name by which the image is referenced" msgstr "**name** (*str*) は画像が参照される際の象徴的な名前です" #: ../../document.rst:994 6676261a491d4bc4b0e9543f4d842080 #, fuzzy msgid "" "``filter`` (*str*) is the decode filter of the image (:ref:`AdobeManual`," " pp. 22)." msgstr "**filter** (*str*) は画像のデコードフィルタです（:ref:`AdobeManual`、pp. 22）。" #: ../../document.rst:995 d92b9e1700fd4c62854642a1f6dde89c #, fuzzy msgid "" "``referencer`` (*int*) the :data:`xref` of the referencer. Zero if " "directly referenced by the page. Only present if *full=True*." msgstr "" "**referencer** (*int*) は参照元の :data:`xref` です。直接ページから参照されている場合はゼロ。 " "*full=True* の場合のみ存在します" #: ../../document.rst:997 c07f09a4315a4410bcdfa4e0e35c5613 msgid "" "In general, this is not the list of images that are **actually " "displayed**. This method only parses several PDF objects to collect " "references to embedded images. It does not analyse the page's " ":data:`contents`, where all the actual image display commands are " "defined. To get this information, please use :meth:`Page.get_image_info`." " Also have a look at the discussion in section :ref:`textpagedict`." msgstr "" "一般的に、これは **実際に表示されている** " "画像のリストではありません。このメソッドは埋め込まれた画像への参照を収集するためにいくつかのPDFオブジェクトのみを解析します。実際の画像表示コマンドが定義されているページの内容は解析しません。この情報を取得するには、:meth:`Page.get_image_info`" " を使用してください。また、:ref:`textpagedict` のセクションでの議論もご覧ください。" #: ../../document.rst:1002 50688d36bbf24221a9c4c9d2d3383083 #, fuzzy msgid "" "PDF only: Return a list of all fonts (directly or indirectly) referenced " "by the page object definition." msgstr "PDFのみ: ページによって参照されるすべてのフォント（直接または間接的に）のリストを返します。" #: ../../document.rst:1005 0f887570532b4208be1fe1b83d43adbc msgid "" "whether to also include the referencer's :data:`xref`. If ``True``, the " "returned items are one entry longer. Use this option if you need to know," " whether the page directly references the font. In this case the last " "entry is 0. If the font is referenced by an `/XObject` of the page, you " "will find its :data:`xref` here." msgstr "" "参照元の :data:`xref` も含めるかどうか。``True`` " "の場合、返されるアイテムは1つ多くなります。ページがフォントを直接参照しているかどうかを知る必要がある場合は、このオプションを使用します。この場合、最後のエントリは0です。フォントがページの" " `/XObject` によって参照される場合、その :data:`xref` をここで見つけることができます。" #: ../../document.rst:1009 b483bbc3f4c244c6acc8c409b25f1dd5 msgid "" "a list of fonts referenced by the object definition of the page. Each " "entry looks like: `(xref, ext, type, basefont, name, encoding, " "referencer)` * ``xref`` (*int*) is the font object number (may be " "zero if the PDF uses one of the builtin fonts directly) * ``ext`` " "(*str*) font file extension (e.g. \"ttf\", see :ref:`FontExtensions`)" " * ``type`` (*str*) is the font type (like \"Type1\" or \"TrueType\" " "etc.) * ``basefont`` (*str*) is the base font name, * ``name`` " "(*str*) is the symbolic name, by which the font is referenced * " "``encoding`` (*str*) the font's character encoding if different from its " "built-in encoding (:ref:`AdobeManual`, p. 254): * ``referencer`` " "(*int* optional) the :data:`xref` of the referencer. Zero if directly " "referenced by the page, otherwise the xref of an XObject. Only present if" " *full=True*." msgstr "" #: ../../document.rst:1009 58bcdadb2ba8444d931f586e64adae5e #, fuzzy msgid "" "a list of fonts referenced by the object definition of the page. Each " "entry looks like:" msgstr "このページで参照されているフォントのリスト。各エントリは以下のようになります：" #: ../../document.rst:1011 4a04236fee1f48d1a11fcb7b3892c541 msgid "`(xref, ext, type, basefont, name, encoding, referencer)`" msgstr "" #: ../../document.rst:1013 82b62283f3904f859c1cfc7fd913aa3a #, fuzzy msgid "" "``xref`` (*int*) is the font object number (may be zero if the PDF uses " "one of the builtin fonts directly)" msgstr "" "*:data:`xref`* (*int*) " "はフォントオブジェクト番号です（PDFが組み込みフォントを直接使用している場合、ゼロになることがあります）" #: ../../document.rst:1014 b281d41a2a104abc96fb433a1ccf6917 #, fuzzy msgid "" "``ext`` (*str*) font file extension (e.g. \"ttf\", see " ":ref:`FontExtensions`)" msgstr "**ext** (*str*) フォントファイルの拡張子（例: \"ttf\"、:ref:`FontExtensions` を参照）" #: ../../document.rst:1015 a3da8b4719364cddb5b13b0530926e71 #, fuzzy msgid "``type`` (*str*) is the font type (like \"Type1\" or \"TrueType\" etc.)" msgstr "**type** (*str*) フォントの種類（\"Type1\"や\"TrueType\"など）" #: ../../document.rst:1016 a967a9a698a54fc6b11d779661ce60f1 #, fuzzy msgid "``basefont`` (*str*) is the base font name," msgstr "**basefont** (*str*) ベースフォント名" #: ../../document.rst:1017 614bd868a5294452b00f8986ef84424a #, fuzzy msgid "``name`` (*str*) is the symbolic name, by which the font is referenced" msgstr "**name** (*str*) フォントが参照される象徴的な名前" #: ../../document.rst:1018 76630068ae7f4e588fb71e0a5e8fda81 #, fuzzy msgid "" "``encoding`` (*str*) the font's character encoding if different from its " "built-in encoding (:ref:`AdobeManual`, p. 254):" msgstr "" "**encoding** (*str*) " "フォントの文字エンコーディング。組み込みエンコーディングと異なる場合（:ref:`AdobeManual`、p. 254を参照）：" #: ../../document.rst:1019 d9bbbba29f0d49179ac6534d71492729 #, fuzzy msgid "" "``referencer`` (*int* optional) the :data:`xref` of the referencer. Zero " "if directly referenced by the page, otherwise the xref of an XObject. " "Only present if *full=True*." msgstr "" "**referencer** (*int*、オプション) 参照元のxref。ページから直接参照されている場合は0、それ以外の場合はXObjectの" " :data:`xref` です。 *full=True* の場合のみ存在します。" #: ../../document.rst:1021 0754eb9f62d34168ad17f5bc693e308d msgid "Example::" msgstr "例::" #: ../../document.rst:1034 bf4929ce53d44735a61082c4227b290d msgid "" "This list has no duplicate entries: the combination of :data:`xref`, " "*name* and *referencer* is unique." msgstr "このリストには重複するエントリはありません：:data:`xref` 、*name* 、および *referencer* の組み合わせは一意です。" #: ../../document.rst:1035 1b9423c83bd84bdfbc55c57f23bc2164 #, fuzzy msgid "" "In general, this is a true superset of the fonts actually in use by this " "page. The PDF creator may e.g. have specified some global list, of which " "each page make only partial use." msgstr "一般的に、これはこのページで実際に使用されているフォントのスーパーセットです。PDF作成者は、各ページが部分的にしか使用しない、グローバルリストを指定したかもしれません。" #: ../../document.rst:1036 9b8712ad035b4ee5af594a3e164f7d0b msgid "" "Be aware that font names returned by some variants of " ":meth:`Page.get_text` (respectively :ref:`TextPage` methods) need not " "(exactly) equal the base font name shown here. Reasons for any " "differences include:" msgstr "" #: ../../document.rst:1038 9e3187a8049f43a8ab6ba7659956a13b msgid "" "This method always shows any subset prefixes (the pattern ``ABCDEF+``), " "whereas text extractions do not do this by default." msgstr "" #: ../../document.rst:1039 0abee5e9efcf4f259b19dbbf3c112ac9 msgid "" "Text extractions use the base library to access the font name, which has " "a length cap of 31 bytes and generally interrogates the font file binary " "to access the name. Method ``get_page_fonts()`` however looks at the PDF " "definition source." msgstr "" #: ../../document.rst:1040 ceff7473261d4ef0af2e8cd13f8a1f2b msgid "" "Text extractions work for all supported document types in exactly the " "same way -- not just for PDFs. Consequently they do not contain PDF-" "specifics." msgstr "" #: ../../document.rst:1044 b8db4c274c904f3e8d043eaf8c4fa329 msgid "" "Extracts the text of a page given its page number *pno* (zero-based). " "Invokes :meth:`Page.get_text`." msgstr "ページ番号 *pno* （0から始まる）を指定して、ページのテキストを抽出します。:meth:`Page.get_text` を呼び出します。" #: ../../document.rst:1046 ab0bf8a80bdf468dae5fcab8e58d513e msgid "page number, 0-based, any value `-∞ < pno < page_count`." msgstr "ページ番号、0から始まる、任意の値 `-∞ < pno < page_count`。" #: ../../document.rst:1048 27bf81508d0b4d2c934168e49148ac1b msgid "For other parameter refer to the page method." msgstr "その他のパラメータについては、ページのメソッドを参照してください。" #: ../../document.rst:1060 881bca230ae54f04b7233142e165e1fc msgid "" "Re-paginate (\"reflow\") the document based on the given page dimension " "and fontsize. This only affects some document types like e-books and " "HTML. Ignored if not supported. Supported documents have ``True`` in " "property :attr:`is_reflowable`." msgstr "" "与えられたページの寸法とフォントサイズに基づいて、ドキュメントを再ページ割り（\"リフロー\"）します。これは電子書籍やHTMLなどの一部のドキュメントタイプにのみ影響します。サポートされていない場合は無視されます。サポートされているドキュメントには" " :attr:`is_reflowable` プロパティで ``True`` が設定されています。" #: ../../document.rst:1062 b4368178fd834f7cba473e3683f57587 msgid "desired page size. Must be finite, not empty and start at point (0, 0)." msgstr "望ましいページサイズ。有限で、空でなく、ポイント（0, 0）で始まる必要があります。" #: ../../document.rst:1063 ff2a60554e4c4e2a812c93fbdb80be62 #, fuzzy msgid "use it together with ``height`` as alternative to ``rect``." msgstr "*rect* との代替として、*height* と一緒に使用します。" #: ../../document.rst:1064 0ba8b89ec07f4191990fb69a81e9d18e #, fuzzy msgid "use it together with ``width`` as alternative to ``rect``." msgstr "*rect* との代替として、*width* と一緒に使用します。" #: ../../document.rst:1065 9073142bb51c42689875626b7abe5c25 msgid "the desired default fontsize." msgstr "望ましいデフォルトのフォントサイズ。" #: ../../document.rst:1069 a01cabf5e69f408980b2a61a12447312 msgid "" "PDF only: Keeps only those pages of the document whose numbers occur in " "the list. Empty sequences or elements outside `range(doc.page_count)` " "will cause a *ValueError*. For more details see remarks at the bottom or " "this chapter." msgstr "" "PDFのみ：ドキュメントのページ番号がリストに含まれるページのみ保持します。空のシーケンスまたは範囲外の要素 " "`range(doc.page_count)` は *ValueError* " "を引き起こします。詳細については、この章の最後の注釈を参照してください。" #: ../../document.rst:1071 b811b2733b5a4543a065fd5bef0c2d19 msgid "" "The sequence (see :ref:`SequenceTypes`) of page numbers (zero-based) to " "be included. Pages not in the sequence will be deleted (from memory) and " "become unavailable until the document is reopened. **Page numbers can " "occur multiple times and in any order:** the resulting document will " "reflect the sequence exactly as specified." msgstr "" "(:ref:`SequenceTypes`) – " "ページ番号（0から始まる）のシーケンス（PyMuPDFで引数として使用する場合はPythonシーケンスを使用）を含めるためのもの。シーケンス内に含まれていないページは（メモリから）削除され、ドキュメントが再オープンされるまで利用できなくなります。**ページ番号は複数回発生し、任意の順序で発生できます：**" " 結果のドキュメントは指定された正確なシーケンスを反映します。" #: ../../document.rst:1075 a0e792f0e7504785a8c3f46ae77381a0 msgid "" "Page numbers in the sequence need not be unique nor be in any particular " "order. This makes the method a versatile utility to e.g. select only the " "even or the odd pages or meeting some other criteria and so forth." msgstr "シーケンス内のページ番号は一意である必要も、特定の順序である必要もありません。これにより、この方法は、例えば偶数のページだけを選択したり、奇数のページだけを選択したり、その他の基準を満たしたりするなど、多目的に使用できます。" #: ../../document.rst:1077 a835fa5157904b5ab455cb2eb91f202c msgid "" "On a technical level, the method will always create a new " ":data:`pagetree`." msgstr "技術的なレベルでは、この方法は常に新しい :data:`pagetree` を作成します。" #: ../../document.rst:1079 ccc5be5dc4ae4ec0b2ef3ca6f735a437 msgid "" "When dealing with only a few pages, methods :meth:`copy_page`, " ":meth:`move_page`, :meth:`delete_page` are easier to use. In fact, they " "are also **much faster** -- by at least one order of magnitude when the " "document has many pages." msgstr "" "数ページしか扱わない場合、methods :meth:`copy_page` " "、:meth:`move_page`、:meth:`delete_page` " "を使用する方が簡単です。実際、これらの方法は、文書に多くのページがある場合でも、少なくとも1桁のオーダーで **高速です** 。" #: ../../document.rst:1084 6ea57c9287dc40f394387af6be79301e msgid "" "PDF only: Sets or updates the metadata of the document as specified in " "*m*, a Python dictionary." msgstr "PDFのみ： *m* で指定されたPythonの辞書と同じキーを持つ辞書を設定または更新します。" #: ../../document.rst:1086 8f5fd7f7e37241278a248b6dfdf47633 msgid "" "A dictionary with the same keys as *metadata* (see below). All keys are " "optional. A PDF's format and encryption method cannot be set or changed " "and will be ignored. If any value should not contain data, do not specify" " its key or set the value to `None`. If you use *{}* all metadata " "information will be cleared to the string *\"none\"*. If you want to " "selectively change only some values, modify a copy of *doc.metadata* and " "use it as the argument. Arbitrary unicode values are possible if " "specified as UTF-8-encoded." msgstr "" "*metadata* " "（以下参照）と同じキーを持つ辞書。すべてのキーはオプションです。PDFのフォーマットと暗号化方法は設定または変更できないため、無視されます。データを含めないべき値がある場合、そのキーを指定しないか、値を" " `None` に設定しないでください。*{}* を使用すると、すべてのメタデータ情報が文字列 *\"none\"* " "にクリアされます。一部の値のみを選択的に変更したい場合は、*doc.metadata* " "のコピーを変更して引数として使用してください。UTF-8でエンコードされた場合、任意のUnicode値が指定可能です。" #: ../../document.rst:1088 378dd664bfff4b00a333924796f6afa1 msgid "" "*(Changed in v1.18.4)* Empty values or \"none\" are no longer written, " "but completely omitted." msgstr "*（v1.18.4で変更）* 空の値または \"none\" は書き込まれなくなり、完全に省略されます。" #: ../../document.rst:1092 7defc5da9e384a81910c8e57c5c08c9b msgid "PDF only: Get the document XML metadata." msgstr "PDFのみ：ドキュメントのXMLメタデータを取得します。" #: ../../document.rst:1095 022fd903a25f47d892ec5c148aa9731c msgid "XML metadata of the document. Empty string if not present or not a PDF." msgstr "ドキュメントのXMLメタデータ。存在しない場合やPDFでない場合は空の文字列。" #: ../../document.rst:1099 3bc746006bd14cad95bbd71e15614ea4 msgid "PDF only: Sets or updates XML metadata of the document." msgstr "PDFのみ：ドキュメントのXMLメタデータを設定または更新します。" #: ../../document.rst:1101 815c87ed354f45afb5034d3fa4df2b7a msgid "" "the new XML metadata. Should be XML syntax, however no checking is done " "by this method and any string is accepted." msgstr "xml（str）–新しいXMLメタデータ。XML構文である必要がありますが、このメソッドではチェックされず、任意の文字列が受け入れられます。" #: ../../document.rst:1106 ../../document.rst:1115 ../../document.rst:1124 #: ../../document.rst:2062 ../../document.rst:2070 ../../document.rst:2078 #: ../../document.rst:2086 ../../document.rst:2094 #: 4956c403ef204b3a9535793528deea60 54acf2c9d3094866ada7757386c3c700 #: 697a878d761047fb8f538a6c5d2b112d 897bf7c435d6499494abe2b762aa7625 #: d481448871f2481096ebf5ba1c5cd890 e1271d18b89947ae8490b4cecbcc4277 #: e7a671ebea5446029fd0019bf910f05a fc68fc012f1e4cbcbcf1e4f9c9adbca6 msgid "New in v1.22.2" msgstr "v1.22.2で新登場" #: ../../document.rst:1108 6095a410473445d68dd1082d0e3598f9 msgid "PDF only: Set the `/PageLayout`." msgstr "PDFのみ：`/PageLayout` を設定します。" #: ../../document.rst:1110 b8d4a1a8ad4c46a6bb4dc931bfb281a2 msgid "" "one of the strings \"SinglePage\", \"OneColumn\", \"TwoColumnLeft\", " "\"TwoColumnRight\", \"TwoPageLeft\", \"TwoPageRight\". Lower case is " "supported." msgstr "以下の文字列のいずれか、\"SinglePage\"、\"OneColumn\"、\"TwoColumnLeft\"、\"TwoColumnRight\"、\"TwoPageLeft\"、\"TwoPageRight\"。小文字もサポートされています。" #: ../../document.rst:1117 83135c81dcbb41e49d6872b76d675476 msgid "PDF only: Set the `/PageMode`." msgstr "PDFのみ：`/PageMode` を設定します。" #: ../../document.rst:1119 361f59248bed437f82de57b9c0cff394 msgid "" "one of the strings \"UseNone\", \"UseOutlines\", \"UseThumbs\", " "\"FullScreen\", \"UseOC\", \"UseAttachments\". Lower case is supported." msgstr "以下の文字列のいずれか、\"UseNone\"、\"UseOutlines\"、\"UseThumbs\"、\"FullScreen\"、\"UseOC\"、\"UseAttachments\"。小文字もサポートされています。" #: ../../document.rst:1126 484c93332c134d25b3c8e46c7153b12a msgid "PDF only: Set the `/MarkInfo` values." msgstr "PDFのみ：`/MarkInfo` の値を設定します。" #: ../../document.rst:1128 a217e06c6a7c47e1a6fe64aeadf09de5 msgid "" "a dictionary like this one: `{\"Marked\": False, \"UserProperties\": " "False, \"Suspects\": False}`. This dictionary contains information about " "the usage of Tagged PDF conventions. For details please see the `PDF " "specifications `_." msgstr "" "次のような辞書：`{\"Marked\": False, \"UserProperties\": False, \"Suspects\": " "False}`。この辞書にはタグ付きPDF規則の使用に関する情報が含まれています。詳細については `PDF仕様 " "`_ を参照してください。" #: ../../document.rst:1133 1a3785bb335b40d5b5f05f19d59dc55f msgid "" "PDF only: Replaces the **complete current outline** tree (table of " "contents) with the one provided as the argument. After successful " "execution, the new outline tree can be accessed as usual via " ":meth:`Document.get_toc` or via :attr:`Document.outline`. Like with other" " output-oriented methods, changes become permanent only via :meth:`save` " "(incremental save supported). Internally, this method consists of the " "following two steps. For a demonstration see example below." msgstr "" "PDFのみ：提供された引数で **現在のアウトラインツリー（目次）全体** を置き換えます。成功した実行後、新しいアウトラインツリーは通常通り D" " :meth:`Document.get_toc` または :attr:`Document.outline` " "を使用してアクセスできます。他の出力指向のメソッドと同様に、変更は :meth:`save` " "（増分保存対応）を介してのみ永続的になります。内部的には、このメソッドは次の2つのステップで構成されています。デモンストレーションについては以下の例を参照してください。" #: ../../document.rst:1135 fab5fac64dd3452580cdcccdd7303f00 msgid "Step 1 deletes all existing bookmarks." msgstr "ステップ1：すべての既存のブックマークを削除します。" #: ../../document.rst:1137 3e9734d29cee4dd182cbcc2cfd77a07c msgid "Step 2 creates a new TOC from the entries contained in *toc*." msgstr "ステップ2：*toc* に含まれるエントリを使用して新しいTOCを作成します。" #: ../../document.rst:1139 1e6897bee93b42f48e1da50ac920665c msgid "" "A list / tuple with **all bookmark entries** that should form the new " "table of contents. Output variants of :meth:`get_toc` are acceptable. To " "completely remove the table of contents specify an empty sequence or " "None. Each item must be a list with the following format. * [lvl, title," " page [, dest]] where - **lvl** is the hierarchy level (int > 0) of " "the item, which **must be 1** for the first item and at most 1 larger " "than the previous one. - **title** (str) is the title to be displayed." " It is assumed to be UTF-8-encoded (relevant for multibyte code points " "only). - **page** (int) is the target page number **(attention: " "1-based)**. Must be in valid range if positive. Set it to -1 if there is " "no target, or the target is external. - **dest** (optional) is a " "dictionary or a number. If a number, it will be interpreted as the " "desired height (in points) this entry should point to on the page. Use a " "dictionary (like the one given as output by `get_toc(False)`) for a " "detailed control of the bookmark's properties, see " ":meth:`Document.get_toc` for a description." msgstr "" #: ../../document.rst:1141 fe3a1323fbad4254982338ebfe8c989f msgid "" "A list / tuple with **all bookmark entries** that should form the new " "table of contents. Output variants of :meth:`get_toc` are acceptable. To " "completely remove the table of contents specify an empty sequence or " "None. Each item must be a list with the following format." msgstr "" "新しい目次を形成するための **すべてのブックマークエントリ** を含むリスト/タプル。:meth:`get_toc` " "の出力バリエーションが許容されます。目次を完全に削除するには、空のシーケンスまたはNoneを指定してください。各アイテムは、次の形式である必要があります。" #: ../../document.rst:1143 85509f224b1249c4b5b63690222e9eb0 msgid "[lvl, title, page [, dest]] where" msgstr "[lvl, title, page [, dest]] ここで" #: ../../document.rst:1145 690744393f344093958f9ddfa8f135c0 msgid "" "**lvl** is the hierarchy level (int > 0) of the item, which **must be 1**" " for the first item and at most 1 larger than the previous one." msgstr "**lvl** はアイテムの階層レベル（int > 0）で、最初のアイテムの場合は1で、前のアイテムより最大1大きくする必要があります。" #: ../../document.rst:1147 0e0033a874d3456abc5787e7192d318d msgid "" "**title** (str) is the title to be displayed. It is assumed to be " "UTF-8-encoded (relevant for multibyte code points only)." msgstr "" "**title** " "（str）は表示されるタイトルです。UTF-8でエンコードされていると仮定されています（マルチバイトコードポイントの場合に関連します）。" #: ../../document.rst:1149 4803db27502949be9cae49f68a00c3c4 msgid "" "**page** (int) is the target page number **(attention: 1-based)**. Must " "be in valid range if positive. Set it to -1 if there is no target, or the" " target is external." msgstr "" "**page**（int）は対象のページ番号です **（注意：1から始まります）** " "。正の場合、有効な範囲内になければなりません。対象がない場合、または対象が外部の場合は-1に設定します。" #: ../../document.rst:1151 de6ec335a2dc463b9619f7d960d55fd8 msgid "" "**dest** (optional) is a dictionary or a number. If a number, it will be " "interpreted as the desired height (in points) this entry should point to " "on the page. Use a dictionary (like the one given as output by " "`get_toc(False)`) for a detailed control of the bookmark's properties, " "see :meth:`Document.get_toc` for a description." msgstr "" "**dest** " "（オプション）は辞書または数値です。数値の場合、このエントリがページ上で指し示すべき目標の高さ（ポイント単位）と解釈されます。詳細なブックマークのプロパティを制御するには（`get_toc(False)`" " によって出力されるものと同様の辞書を使用してください）、:meth:`Document.get_toc` の説明を参照してください。" #: ../../document.rst:1153 4b2509feab4d42c1896479cb753f319a msgid "" "*(new in v1.16.9)* controls the hierarchy level beyond which outline " "entries should initially show up collapsed. The default 1 will hence only" " display level 1, higher levels must be unfolded using the PDF viewer. To" " unfold everything, specify either a large integer, 0 or None." msgstr "" "*（v1.16.9で新規追加）* " "アウトラインエントリが初めて折りたたまれて表示される階層レベルを制御します。デフォルトの1はレベル1のみを表示し、より高いレベルはPDFビューアを使用して展開する必要があります。すべてを展開するには、大きな整数、0、またはNoneを指定してください。" #: ../../document.rst:1156 2e9ef17d9ad7433caf717d11a0bef04d msgid "the number of inserted, resp. deleted items." msgstr "挿入されたアイテム、または削除されたアイテムの数。" #: ../../document.rst:1158 cc6b2a61bf8745ad9a685a8bdb934307 msgid "" "Changed in v1.23.8: Destination 'to' coordinates should now be in the " "same coordinate system as those returned by `get_toc()` (internally they " "are now transformed with `page.cropbox` and `page.rotation_matrix`). So " "for example `set_toc(get_toc())` now gives unchanged destination 'to' " "coordinates." msgstr "" "1.23.8 で変更されました: デスティネーションの 'to' 座標は、現在 `get_toc()` で返される座標系と同じ座標系であるべきです" " (内部的には `page.cropbox` と `page.rotation_matrix` で変換されます)。したがって、例えば " "`set_toc(get_toc())` は、変更されていない 'to' 座標を与えます。" #: ../../document.rst:1168 69ead51269304dd6b951d0f68345cb21 msgid "" "PDF only: Return the :data:`xref` of the outline item. This is mainly " "used for internal purposes." msgstr "PDFのみ：アウトラインアイテムの :data:`xref` を返します。これは主に内部用途で使用されます。" #: ../../document.rst:1170 ac5515f1060a4f2f8cfea8c5de047f36 #, fuzzy msgid "index of the item in list :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` のリスト内のアイテムのインデックス。" #: ../../document.rst:1172 968f01ffca3d4358afb5662a933cd835 msgid ":data:`xref`." msgstr "" #: ../../document.rst:1177 34e33888ad8a4b238bbf919bd98c86cd msgid "" "Changed in v1.18.14: no longer remove the item's text, but show it " "grayed-out." msgstr "v1.18.14で変更: アイテムのテキストを削除しなくなり、灰色で表示されます。" #: ../../document.rst:1179 dd42c42f2ed74d9f9c635912f3d908da msgid "" "PDF only: Remove this TOC item. This is a high-speed method, which " "**disables** the respective item, but leaves the overall TOC structure " "intact. Physically, the item still exists in the TOC tree, but is shown " "grayed-out and will no longer point to any destination." msgstr "" "PDFのみ: この目次アイテムを削除します。これは高速なメソッドで、該当するアイテムを **無効にします** " "が、全体の目次構造はそのままです。物理的には、アイテムはまだ目次ツリーに存在しますが、灰色で表示され、もはやどの宛先も指し示しません。" #: ../../document.rst:1181 14518935bf6542a1909828b5acc5bb9d msgid "" "This also implies that you can reassign the item to a new destination " "using :meth:`Document.set_toc_item`, when required." msgstr "" "これはまた、必要な場合に:meth:`Document.set_toc_item` " "を使用してアイテムを新しい宛先に再割り当てできることを意味します。" #: ../../document.rst:1183 22d9b55991c34bb6b5b50464e9d3ede0 msgid "the index of the item in list :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` のリスト内のアイテムのインデックス。" #: ../../document.rst:1189 f97ad420e8f2448d89a3942f5f4ecdde msgid "Changed in v1.18.6" msgstr "v1.18.6で変更" #: ../../document.rst:1191 f37714c941aa4caab4557723d10633c7 msgid "" "PDF only: Changes the TOC item identified by its index. Change the item " "**title**, **destination**, **appearance** (color, bold, italic) or " "collapsing sub-items -- or to remove the item altogether." msgstr "" "PDFのみ: インデックスによって識別されるTOCアイテムを変更します。アイテムの **タイトル** 、**宛先** 、 **外観** " "（色、太字、イタリック）を変更したり、サブアイテムを折りたたんだり、アイテムを完全に削除したりするために使用します。" #: ../../document.rst:1193 28fc5be05b3a4afa92b7a5f95bbf478b msgid "" "Use this method if you need specific changes for selected entries only " "and want to avoid replacing the complete TOC. This is beneficial " "especially when dealing with large table of contents." msgstr "選択したエントリに対して特定の変更が必要で、完全なTOCを置き換えたくない場合にこのメソッドを使用します。大きな目次を扱う場合に特に便利です。" #: ../../document.rst:1195 288fc512c31544d3be554d8f5cce5cb9 msgid "the index of the entry in the list created by :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` によって作成されたリスト内のエントリのインデックス。" #: ../../document.rst:1196 a16b6cc4ad6a49e496bc2541ff752cfd msgid "" "the new destination. A dictionary like the last entry of an item in " "`doc.get_toc(False)`. Using this as a template is recommended. When " "given, **all other parameters are ignored** -- except title." msgstr "" "新しい宛先。`doc.get_toc(False)` のアイテムの最後のエントリのような辞書を使用することが推奨されます。指定された場合、他の " "**すべてのパラメータは無視されます** - タイトル以外。" #: ../../document.rst:1197 8d519eb7f6f84aa586f6894b855ec1b4 msgid "" "the link kind, see :ref:`linkDest Kinds`. If :data:`LINK_NONE`, then all " "remaining parameter will be ignored, and the TOC item will be removed -- " "same as :meth:`Document.del_toc_item`. If None, then only the title is " "modified and the remaining parameters are ignored. All other values will " "lead to making a new destination dictionary using the subsequent " "arguments." msgstr "" "リンクの種類、:ref:`linkDest Kinds` を参照してください。:data:`LINK_NONE` " "の場合、残りのパラメータはすべて無視され、TOCアイテムは削除されます - :meth:`Document.del_toc_item` " "と同じです。Noneの場合、タイトルのみが変更され、残りのパラメータは無視されます。それ以外の値は、後続の引数を使用して新しい宛先辞書を作成します。" #: ../../document.rst:1198 23d121f44ba448deb820d78571787db2 msgid "" "the 1-based page number, i.e. a value 1 <= pno <= doc.page_count. " "Required for LINK_GOTO." msgstr "1から始まるページ番号、つまり1 <= pno <= doc.page_count。LINK_GOTOの場合に必要です。" #: ../../document.rst:1199 32c7c87f9e8e403ab8146f49e7a37529 msgid "the URL text. Required for LINK_URI." msgstr "URLのテキスト。LINK_URIの場合に必要です。" #: ../../document.rst:1200 43fcbce5ce9847278bc2628a403f4e40 msgid "the desired new title. None if no change." msgstr "新しいタイトル。変更しない場合はNone。" #: ../../document.rst:1201 6840fbdc207c43779b48e2f8df7435b6 msgid "" "(optional) points to a coordinate on the target page. Relevant for " "LINK_GOTO. If omitted, a point near the page's top is chosen." msgstr "（オプション）対象ページ上の座標を指定します。LINK_GOTOの場合に関連します。省略された場合、ページの上部近くのポイントが選択されます。" #: ../../document.rst:1202 7c940e27b57c48529e5d3e8ff0325a69 msgid "required for LINK_GOTOR and LINK_LAUNCH." msgstr "LINK_GOTORおよびLINK_LAUNCHに必要です。" #: ../../document.rst:1203 132587a96eb44d79895a5275d7a58ec9 msgid "use this zoom factor when showing the target page." msgstr "対象ページを表示する際にこのズームファクターを使用します。" #: ../../document.rst:1205 51f0afa8fe36446da6457ee40177e6ac msgid "**Example use:** Change the TOC of the SWIG manual to achieve this:" msgstr "**使用例:** SWIGマニュアルのTOCを変更して、次のことを達成します：" #: ../../document.rst:1207 89691e2e24d042b7afaa252f2404e728 msgid "" "Collapse everything below top level and show the chapter on Python " "support in red, bold and italic::" msgstr "トップレベル以下をすべて折りたたみ、Pythonサポートの章を赤色で太字かつイタリックで表示::" #: ../../document.rst:1224 cb071d795eef4051859facdf9c2c7f83 msgid "" "In the previous example, we have changed only 42 of the 1240 TOC items of" " the file." msgstr "前の例では、ファイルの1240のTOCアイテムのうち、わずか42のみを変更しました。" #: ../../document.rst:1228 4b6c6cb7b0cd41fe85e5ecb9dfbff8ec msgid "" "PDF only: Convert annotations and / or widgets to become permanent parts " "of the pages. The PDF **will be changed** by this method. If `widgets` is" " `True`, the document will also no longer be a \"Form PDF\"." msgstr "" "PDF のみ: 注釈やウィジェットをページの永続的な部分に変換します。このメソッドによって PDF **は変更されます**。 `widgets` " "が `True` の場合、ドキュメントは「フォーム PDF」ではなくなります。" #: ../../document.rst:1230 b1618c1259c44d298694a1fdd071bea7 msgid "" "All pages will look the same, but will no longer have annotations, " "respectively fields. The visible parts will be converted to standard " "text, vector graphics or images as required." msgstr "すべてのページが同じように見えますが、注釈またはフィールドがなくなります。必要に応じて、表示される部分は標準のテキスト、ベクトルグラフィックス、または画像に変換されます。" #: ../../document.rst:1232 4e629c4362f5458dacd2bb2f00dc9a42 msgid "" "The method may thus be a viable **alternative for PDF-to-PDF " "conversions** using :meth:`Document.convert_to_pdf`." msgstr "" "このメソッドは、:meth:`Document.convert_to_pdf` を使用して PDF を PDF " "に変換する際の代替手段として有効な選択肢です。" #: ../../document.rst:1234 eac5b3e2fdae4934a3324c3826cb5be0 msgid "" "Please consider that annotations are complex objects and may consist of " "more data \"underneath\" their visual appearance. Examples are \"Text\" " "and \"FileAttachment\" annotations. When \"baking in\" annotations / " "widgets with this method, all this underlying information (attached " "files, comments, associated PopUp annotations, etc.) will be lost and be " "removed on next garbage collection." msgstr "" "注釈は複雑なオブジェクトであり、視覚的な外観の下にさらに多くのデータが存在する場合があります。例としては、\"Text\" や " "\"FileAttachment\" " "の注釈が挙げられます。このメソッドで注釈やウィジェットを組み込む際には、この下部情報（添付ファイル、コメント、関連するポップアップ注釈など）がすべて失われ、次のガベージコレクション時に削除されます。" #: ../../document.rst:1236 8a23bab53bf14c8aa574e2e600474bcd #, fuzzy msgid "" "Use this feature for instance for :meth:`Page.show_pdf_page` (which " "supports neither annotations nor widgets) when the source pages should " "look exactly the same in the target." msgstr "" "たとえば、 :meth:`Document.insert_pdf` （ウィジェットのコピーをサポートしていない）や " ":meth:`Page.show_pdf_page` " "（注釈やウィジェットをサポートしていない）などのメソッドで、ソースページがターゲットで完全に同じように見えるようにする場合にこの機能を使用します。" #: ../../document.rst:1239 a39cbfa8407c4df6af1eb80d30cb91ff msgid "convert annotations." msgstr "注釈を変換するかどうか。" #: ../../document.rst:1240 45f21baaa61b4e06b77104c6c6735089 msgid "" "convert fields / widgets. After execution, the document will no longer be" " a \"Form PDF\"." msgstr "フィールド / ウィジェットを変換します。実行後、ドキュメントはもはや「フォーム PDF」ではありません。" #: ../../document.rst:1245 6cddb53c70e64e57b442090c1f2207d2 msgid "New in v1.16.0" msgstr "v1.16.0で新規追加" #: ../../document.rst:1247 fa1fdbe516594d0d98a0d538a5555317 msgid "" "Check whether the document can be saved incrementally. Use it to choose " "the right option without encountering exceptions." msgstr "ドキュメントを増分保存できるかどうかを確認します。例外を発生させずに正しいオプションを選択するために使用します。" #: ../../document.rst:1251 34130af2a2be4418bd86e36c3ebe8d5a msgid "New in v1.16.14" msgstr "v1.16.14で新規追加" #: ../../document.rst:1253 d9e7b0b6be0e4bb98d2275cf4c18136d msgid "" "PDF only: Remove potentially sensitive data from the PDF. This function " "is inspired by the similar \"Sanitize\" function in Adobe Acrobat " "products. The process is configurable by a number of options." msgstr "" "PDFのみ：PDFから潜在的に機密性の高いデータを削除します。この関数はAdobe " "Acrobat製品の類似の「Sanitize」機能にインスパイアを受けたものです。プロセスはさまざまなオプションで設定可能です。" #: ../../document.rst:1255 122850b369374792b6f0ff12b94fc87b msgid "Search for 'FileAttachment' annotations and remove the file content." msgstr "'FileAttachment' 注釈を検索してファイルコンテンツを削除します。" #: ../../document.rst:1256 e8f4d3ec34634deeb615c44f546d61d3 msgid "" "Remove any comments from page painting sources. If this option is set to " "``False``, then this is also done for *hidden_text* and *redactions*." msgstr "" "ページ描画ソースからコメントを削除します。このオプションが ``False`` に設定されている場合、*hidden_text* と " "*redactions* に対しても同様の処理が行われます。" #: ../../document.rst:1257 6919e0d4f13c46b1ade6ed30abaf7ef7 msgid "Remove embedded files." msgstr "埋め込みファイルを削除します。" #: ../../document.rst:1258 7e5564f6654a4449bb1bad2f78316f86 msgid "Remove OCRed text and invisible text [#f7]_." msgstr "OCRedテキストと不可視テキストを削除します [#f7]_。" #: ../../document.rst:1259 fd5111edbec040ae8e77d30b21c503a4 msgid "Remove JavaScript sources." msgstr "JavaScriptソースを削除します。" #: ../../document.rst:1260 7054ef539ad641c2bf57e166ebbd4952 msgid "Remove PDF standard metadata." msgstr "PDF標準のメタデータを削除します。" #: ../../document.rst:1261 8f65baf5ab154d0b992eefec509ce93e msgid "Apply redaction annotations." msgstr "レダクション注釈を適用します。" #: ../../document.rst:1262 f7f0f74a02e9491988b1dc2a0587aaae msgid "" "how to handle images if applying redactions. One of 0 (ignore), 1 (blank " "out overlaps) or 2 (remove)." msgstr "レダクションを適用する場合の画像の処理方法。0（無視）、1（オーバーラップをブランク化）、または2（削除）のいずれかです。" #: ../../document.rst:1263 a65be763835e4d588b701873d968784e msgid "Remove all links." msgstr "すべてのリンクを削除します。" #: ../../document.rst:1264 9931675e2d0040f7a193eb79f2ee2884 msgid "Reset all form fields to their defaults." msgstr "すべてのフォームフィールドをデフォルトにリセットします。" #: ../../document.rst:1265 5f0d45da4d9f4c71b72ef46e91b342fd msgid "Remove all responses from all annotations." msgstr "すべての注釈からすべての応答を削除します。" #: ../../document.rst:1266 3253836eaaec4b2ca87df3b3b95f015a msgid "Remove thumbnail images from pages." msgstr "ページからサムネイル画像を削除します。" #: ../../document.rst:1267 73179141037a4f01b4e064b767ebb9a8 msgid "Remove XML metadata." msgstr "XMLメタデータを削除します。" #: ../../document.rst:1272 ../../document.rst:1349 #: 46784658632a419388980eb13c1041a1 da6e920ba12d438988b9655f9fac67c5 msgid "Changed in v1.18.7" msgstr "v1.18.7で変更" #: ../../document.rst:1273 ../../document.rst:1350 #: 12262e65b5664f109f47051864977083 56c375b6fe6a4791bf227b919ad7e097 msgid "Changed in v1.19.0" msgstr "v1.19.0で変更" #: ../../document.rst:1274 ../../document.rst:1351 #: 5260dc902fd9499b8410a0aaa18efdd9 b9acb7ade9fc4b05939e79ad1d0d7a94 #, fuzzy msgid "Changed in v1.24.1" msgstr "v1.14.12で変更" #: ../../document.rst:1276 bc516f2e012c4878bd37006c7e9e88b0 msgid "PDF only: Saves the document in its **current state**." msgstr "PDFのみ：ドキュメントの **現在の状態** を保存します。" #: ../../document.rst:1278 ce7de6ce58a34138ace194aa363ea3c0 msgid "" "The file path, `pathlib.Path` or file object to save to. A file object " "must have been created before via `open(...)` or `io.BytesIO()`. Choosing" " `io.BytesIO()` is similar to :meth:`Document.tobytes` below, which " "equals the `getvalue()` output of an internally created `io.BytesIO()`." msgstr "" "保存先のファイルパス、`pathlib.Path` 、またはファイルオブジェクト。ファイルオブジェクトは `open(...)` または " "`io.BytesIO()` を介して事前に作成されている必要があります。`io.BytesIO()` を選択することは、以下の " ":meth:`Document.tobytes` と同等で、内部で作成された `io.BytesIO()` の `getvalue()` " "出力に等しいです。" #: ../../document.rst:1280 aa801ed2c60e4edc9a6b9a636ce2c7ce msgid "" "Do garbage collection. Positive values exclude \"incremental\". * 0 = " "none * 1 = remove unused (unreferenced) objects. * 2 = in addition to 1, " "compact the :data:`xref` table. * 3 = in addition to 2, merge duplicate " "objects. * 4 = in addition to 3, check :data:`stream` objects for " "duplication. This may be slow because such data are typically large." msgstr "" #: ../../document.rst:1280 98a9fdc676634ec3b02acc9b22deea8a msgid "Do garbage collection. Positive values exclude \"incremental\"." msgstr "ガベージコレクションを実行します。正の値は「増分」を除外します。" #: ../../document.rst:1282 ../../document.rst:1300 #: 01264ad0b1f348908fb979dacacd82dd a59c0bd122c043e99f85c56dbb619e23 msgid "0 = none" msgstr "0 = なし" #: ../../document.rst:1283 c584c994c62c47b6bb2d9c9eec495a25 msgid "1 = remove unused (unreferenced) objects." msgstr "1 = 未使用（参照されていない）オブジェクトを削除します。" #: ../../document.rst:1284 90892bbc3ba948e49451a75bd88e5ec1 msgid "2 = in addition to 1, compact the :data:`xref` table." msgstr "2 = 1に加えて、:data:`xref` テーブルを最適化します。" #: ../../document.rst:1285 441ba00255e545c58a3c0873eb9b5b75 msgid "3 = in addition to 2, merge duplicate objects." msgstr "3 = 2に加えて、重複したオブジェクトを統合します。" #: ../../document.rst:1286 da68f0ef05be4518b693fe96dcf63799 msgid "" "4 = in addition to 3, check :data:`stream` objects for duplication. This " "may be slow because such data are typically large." msgstr "4 = 3に加えて、ストリームオブジェクトの重複をチェックします。これは、そのようなデータが通常大きいため、遅い場合があります。" #: ../../document.rst:1288 87ab7b3d94364600a46fd3583338cf33 msgid "" "Clean and sanitize content streams [#f1]_. Corresponds to \"mutool clean " "-sc\"." msgstr "コンテンツストリームをクリーンアップおよびサニタイズします [#f1]_。これは「mutool clean -sc」に対応します。" #: ../../document.rst:1290 307368cf4bae4dd3a31a1c6dba695999 msgid "Deflate (compress) uncompressed streams." msgstr "未圧縮のストリームをデフレート（圧縮）します。" #: ../../document.rst:1291 074aa683f32949a09fd3b5218932b9d2 msgid "*(new in v1.18.3)* Deflate (compress) uncompressed image streams [#f4]_." msgstr "*（v1.18.3で新規追加）* 未圧縮の画像ストリームをデフレート（圧縮）します [#f4]_。" #: ../../document.rst:1292 f47d59f8289a4a0b8f6227e131941c9e msgid "" "*(new in v1.18.3)* Deflate (compress) uncompressed fontfile streams " "[#f4]_." msgstr "（v1.18.3で新規追加）未圧縮のフォントファイルストリームをデフレート（圧縮）します [#f4]_。" #: ../../document.rst:1294 98dd2b4baaf142159a443d2deb715b9b msgid "" "Only save changes to the PDF. Excludes \"garbage\" and \"linear\". Can " "only be used if *outfile* is a string or a `pathlib.Path` and equal to " ":attr:`Document.name`. Cannot be used for files that are decrypted or " "repaired and also in some other cases. To be sure, check " ":meth:`Document.can_save_incrementally`. If this is false, saving to a " "new file is required." msgstr "" "PDFへの変更を保存します。 \"garbage\" および \"linear\" を除外します。*outfile* が文字列または " "`pathlib.Path` であり、:attr:`Document.name` " "に等しい場合にのみ使用できます。復号化または修復されたファイルおよび一部の他の場合には使用できません。確実にするために、:meth:`Document.can_save_incrementally`" " を確認してください。これがFalseの場合、新しいファイルに保存する必要があります。" #: ../../document.rst:1296 b7d42cf66e264b78b3aaa3cee4468fa6 msgid "convert binary data to ASCII." msgstr "バイナリデータをASCIIに変換します。" #: ../../document.rst:1298 005ca024523d404887a1514b77c99675 msgid "" "Decompress objects. Generates versions that can be better read by some " "other programs and will lead to larger files. * 0 = none * 1 = images * " "2 = fonts * 255 = all" msgstr "" #: ../../document.rst:1298 2bb773df27374e8880b5a9762601b294 msgid "" "Decompress objects. Generates versions that can be better read by some " "other programs and will lead to larger files." msgstr "オブジェクトを展開します。他のプログラムにより読みやすいバージョンを生成し、ファイルサイズが大きくなります。" #: ../../document.rst:1301 4c34dc68468f45819bd8a5140a26fc7d msgid "1 = images" msgstr "1 = 画像" #: ../../document.rst:1302 9b54dc5c6dee40a8ac7fda271235a869 msgid "2 = fonts" msgstr "2 = フォント" #: ../../document.rst:1303 7559171a73a04f818f09a84c49f541b8 msgid "255 = all" msgstr "255 = すべて" #: ../../document.rst:1305 4b275a55b310440cbc6bed0da1fcc137 #, fuzzy msgid "" "Save a linearised version of the document. This option creates a file " "format for improved performance for Internet access. Excludes " "\"incremental\" and \"use_objstms\"." msgstr "" "ドキュメントの線形バージョンを保存します。このオプションは、インターネットアクセスのパフォーマンス向上のためのファイル形式を作成します。 " "\"増分\" を除外します。" #: ../../document.rst:1307 8d34e1be34a6456583de08a964b06ffe msgid "" "Prettify the document source for better readability. PDF objects will be " "reformatted to look like the default output of " ":meth:`Document.xref_object`." msgstr "" "ドキュメントソースを見やすく整形します。PDFオブジェクトは、:meth:`Document.xref_object` " "のデフォルト出力のように再フォーマットされます。" #: ../../document.rst:1309 6c8fa6521582483489eafa899e3a7b5e msgid "" "Suppress the update of the file's `/ID` field. If the file happens to " "have no such field at all, also suppress creation of a new one. Default " "is `False`, so every save will lead to an updated file identification." msgstr "" "ファイルの `/ID` フィールドの更新を抑制します。 " "ファイルにそのようなフィールドがまったくない場合、新しいフィールドの作成も抑制します。デフォルトは `False` " "で、各保存でファイル識別情報が更新されます。" #: ../../document.rst:1311 2abbbdfe20de45a989cb6206cb2a676c msgid "" "*(new in v1.16.0)* Set the desired permission levels. See " ":ref:`PermissionCodes` for possible values. Default is granting all." msgstr "" "（v1.16.0で新規追加）希望の権限レベルを設定します。可能な値については :ref:`PermissionCodes` " "を参照してください。デフォルトはすべてを許可します。" #: ../../document.rst:1313 8026bd5ba1c04716af36a27cfb56c0f3 msgid "" "*(new in v1.16.0)* set the desired encryption method. See " ":ref:`EncryptionMethods` for possible values." msgstr "" "*（v1.16.0で新規追加）* 希望の暗号化メソッドを設定します。可能な値については :ref:`EncryptionMethods` " "を参照してください。" #: ../../document.rst:1315 973dde478560485086c44526497bacd5 msgid "" "*(new in v1.16.0)* set the document's owner password. *(Changed in " "v1.18.3)* If not provided, the user password is taken if provided. The " "string length must not exceed 40 characters." msgstr "" "*（v1.16.0で新規追加）* ドキュメントの所有者パスワードを設定します。 (v1.18.3で変更) " "指定しない場合、ユーザーパスワードが提供された場合にユーザーパスワードが使用されます。文字列の長さは40文字を超えてはいけません。" #: ../../document.rst:1317 3c2c2b927a9448bfb0a16d0db2c915e4 msgid "" "*(new in v1.16.0)* set the document's user password. The string length " "must not exceed 40 characters." msgstr "（v1.16.0で新規追加）ドキュメントのユーザーパスワードを設定します。文字列の長さは40文字を超えてはいけません。" #: ../../document.rst:1319 7fee682328a94e6288a75978a7630ce1 msgid "" "*(new in v1.24.0)* compression option that converts eligible PDF object " "definitions to information that is stored in some other object's " ":data:`stream` data. Depending on the `deflate` parameter value, the " "converted object definitions will be compressed -- which can lead to very" " significant file size reductions." msgstr "" "*（v1.24.0で新機能）* 可変化PDFオブジェクト定義を他のオブジェクトの :data:`stream` " "データに格納される情報に変換する圧縮オプションです。`deflate` " "パラメータの値に応じて、変換されたオブジェクト定義が圧縮されます。これにより、ファイルサイズが非常に大幅に削減される可能性があります。" #: ../../document.rst:1321 8ffaa1fceb4f4e34a5b8891e046c1ee3 msgid "" "The method does not check, whether a file of that name already exists, " "will hence not ask for confirmation, and overwrite the file. It is your " "responsibility as a programmer to handle this." msgstr "このメソッドは、その名前のファイルがすでに存在するかどうかをチェックしません。したがって、確認を求めずにファイルを上書きします。これについては、プログラマーとしての責任があります。" #: ../../document.rst:1325 be3ee913b5004b3d9517106841ba688a msgid "**File size reduction**" msgstr "**ファイルサイズの削減**" #: ../../document.rst:1327 1bf790168b284a5d9aaaf7d91cc13bbc #, fuzzy msgid "" "1. Use the save options like `garbage=3|4, deflate=True, " "use_objstms=True|1`. Do not touch the default values `expand=False|0, " "clean=False|0, incremental=False|0, linear=False|0`. This is a " "\"lossless\" file size reduction. There is a convenience version of this " "method with these values set by default, :meth:`Document.ez_save` -- " "please see below." msgstr "" "オプションとして、`garbage=3|4, deflate=True, use_objstms=True|1`. " "デフォルト値に触れないでください。 `expand=False|0, clean=False|0, incremental=False|0` " "は変更しないでください。これは「非破壊的」なファイルサイズの削減です。これらの値がデフォルトで設定されたメソッドの簡易版もあります。 " ":meth:`Document.ez_save()` をご覧ください。" #: ../../document.rst:1330 3d1ee9059bd24a83a6aaae8687200458 msgid "" "\"Lossy\" file size reduction in essence must give up something with " "respect to images, like (a) remove all images (b) replace images by their" " grayscale versions (c) reduce image resolutions. Find examples in the " "`PyMuPDF Utilities \"replace-image\" folder `_." msgstr "" "本質的に「損失のある」ファイルサイズの削減は、画像に関して何かを犠牲にする必要があります。例えば、(a) すべての画像を削除する、(b) " "画像をグレースケールに置換する、(c) 画像の解像度を低下させるなどの方法があります。`PyMuPDF Utilities \"replace-" "image\" folder `_ に例があります。" #: ../../document.rst:1334 805878d8902f44539b76f7fba424c58d msgid "New in v1.18.11" msgstr "v1.18.11で新規追加" #: ../../document.rst:1336 fb2bc3ab13bc4cbdb9cdeedc4a300457 msgid "" "PDF only: The same as :meth:`Document.save` but with changed defaults " "`deflate=True, garbage=3, use_objstms=1`." msgstr "" "PDFのみ：:meth:`Document.save` と同じですが、デフォルト値が `deflate=True, garbage=3, " "use_objstms=1` に変更されています。" #: ../../document.rst:1340 4ca43c0eb0764d4d86c7783d00292313 #, fuzzy msgid "" "PDF only: saves the document incrementally. This is a convenience " "abbreviation for ``doc.save(doc.name, incremental=True, " "encryption=PDF_ENCRYPT_KEEP)``." msgstr "" "PDFのみ：ドキュメントを増分的に保存します。これは、 *doc.save(doc.name, incremental=True, " "encryption=PDF_ENCRYPT_KEEP)* の簡略表記です。" #: ../../document.rst:1344 3722cd78e2724185aa38db282136d51f msgid "" "Saving incrementally may be required if the document contains verified " "signatures which would be invalidated by saving to a new file." msgstr "増分保存が必要な場合、ドキュメントに確認済みの署名が含まれている場合、新しいファイルに保存することによって無効になる可能性があります。" #: ../../document.rst:1353 abab584e13af432a87536b0dd1525b25 msgid "" "PDF only: Writes the **current content of the document** to a bytes " "object instead of to a file. Obviously, you should be wary about memory " "requirements. The meanings of the parameters exactly equal those in " ":meth:`save`. Chapter :ref:`FAQ` contains an example for using this " "method as a pre-processor to `pdfrw " "`_." msgstr "" "PDFのみ： **ドキュメントの現在のコンテンツ** " "をファイルではなくバイトオブジェクトに書き込みます。明らかに、メモリ要件に注意する必要があります。パラメータの意味は :meth:`save` " "とまったく同じです。チャプター :ref:`FAQ` には、このメソッドを `pdfrw " "`_ の前処理として使用する例が含まれています。" #: ../../document.rst:1355 0d08d4531d0547afa8dd2711eb5fb49a msgid "*(Changed in v1.16.0)* for extended encryption support." msgstr "*(v1.16.0で変更)* 拡張暗号サポート用。" #: ../../document.rst:1358 6de0cf28802e42058ca66973d5ee0b8c msgid "a bytes object containing the complete document." msgstr "ドキュメント全体を含むbytesオブジェクト。" #: ../../document.rst:1362 0274353b276b45c697447eefc6c5af10 msgid "" "Search for \"text\" on page number \"pno\". Works exactly like the " "corresponding :meth:`Page.search_for`. Any integer `-∞ < pno < " "page_count` is acceptable." msgstr "" "\"pno\" ページ上で \"text\" を検索します。対応する :meth:`Page.search_for` " "とまったく同じ方法で機能します。整数 `-∞ < pno < page_count` ならどのような値でも受け入れられます。" #: ../../document.rst:1380 8f33a8224c6b4cd698ee597a13d325b1 #, fuzzy msgid "" "PDF only: Copy the page range **[from_page, to_page]** (including both) " "of PDF document *docsrc* into the current one. Inserts will start with " "page number *start_at*. Value -1 indicates default values. All pages thus" " copied will be rotated as specified. Links, annotations and widgets can " "be excluded in the target, see below. All page numbers are 0-based." msgstr "" "PDFのみ：PDFドキュメント *docsrc* のページ範囲 **[from_page、to_page]** " "（両方を含む）を現在のドキュメントにコピーします。挿入はページ番号 *start_at* " "から開始します。値-1はデフォルト値を示します。したがって、コピーされるすべてのページは指定されたように回転します。リンクと注釈は対象から除外することができます（以下参照）。すべてのページ番号は0から始まります。" #: ../../document.rst:1382 5c1428d40caa43a5a10f4b77f20b3e69 msgid "" "An opened PDF *Document* which must not be the current document. However," " it may refer to the same underlying file." msgstr "現在のドキュメントではない、開かれたPDF *ドキュメント* 。ただし、同じ基盤ファイルを参照する場合があります。" #: ../../document.rst:1385 07b6f53e82724a5ab67dd0b79067fa1e msgid "First page number in *docsrc*. Default is zero." msgstr "*docsrc* 内の最初のページ番号。デフォルトはゼロです。" #: ../../document.rst:1387 fea37107f5404d54996345114e37441b msgid "Last page number in *docsrc* to copy. Defaults to last page." msgstr "コピーする *docsrc* 内の最後のページ番号。デフォルトは最終ページです。" #: ../../document.rst:1389 524d0fb0b9814e21962ad50b5f471743 msgid "" "First copied page, will become page number *start_at* in the target. " "Default -1 appends the page range to the end. If zero, the page range " "will be inserted before current first page." msgstr "" "コピーされる最初のページ、対象のページ番号 *start_at* " "になります。デフォルト-1はページ範囲を末尾に追加します。ゼロの場合、ページ範囲は現在の最初のページの前に挿入されます。" #: ../../document.rst:1391 4c91282a041f4252be3ddf0b31888ef6 msgid "" "All copied pages will be rotated by the provided value (degrees, integer " "multiple of 90)." msgstr "コピーされるすべてのページは、指定された値（度数、90の整数倍）で回転します。" #: ../../document.rst:1393 d336910ac6904a34ad264c74f9a12eb0 msgid "" "Choose whether (internal and external) links should be included in the " "copy. Default is `True`. *Named* links (:data:`LINK_NAMED`) and internal " "links to outside the copied page range are **always excluded**." msgstr "" "(内部および外部) リンクをコピーに含めるかどうかを選択します。デフォルトは ``True`` です。コピー対象外のコピー範囲外の内部リンクは " "**常に除外されます** 。" #: ../../document.rst:1395 a02aff5f97f748429af6f525e52152d3 #, fuzzy msgid "choose whether annotations should be included in the copy." msgstr "*(v1.16.1で新規追加)* 注釈をコピーに含めるかどうかを選択します。 フォームフィールドはコピーできません。" #: ../../document.rst:1397 b94bf24da9974674ace2e3acc4991939 msgid "" "choose whether annotations should be included in the copy. If `True` and " "at least one of the source pages contains form fields, the target PDF " "will be turned into a Form PDF (if not already being one)." msgstr "" #: ../../document.rst:1399 291ec7b0d4b64883aba67c7050c566bf msgid "" "*(New in version 1.25.5)* Choose how to handle duplicate root field names" " in the source pages. This parameter is ignored if `widgets=False`. " "Default is ``False`` which will add unifying strings to the name of those" " source root fields which have a duplicate in the target. For instance, " "if \"name\" already occurs in the target, the source widget's name will " "be changed to \"name [text]\" with a suitably chosen string \"text\". If" " ``True``, root fields with duplicate names in source and target will be " "converted to so-called \"Kids\" of a \"Parent\" object (which lists all " "kid widgets in a PDF array). This will effectively turn those kids into " "instances of the \"same\" widget: if e.g. one of the kids is changed, " "then all its instances will automatically inherit this change -- no " "matter on which page they happen to be displayed." msgstr "" #: ../../document.rst:1399 78659c3b81a3457a9ea0a009a43d5632 msgid "" "*(New in version 1.25.5)* Choose how to handle duplicate root field names" " in the source pages. This parameter is ignored if `widgets=False`." msgstr "" #: ../../document.rst:1401 690ea9568fba4c748332acfea9bf268d msgid "" "Default is ``False`` which will add unifying strings to the name of those" " source root fields which have a duplicate in the target. For instance, " "if \"name\" already occurs in the target, the source widget's name will " "be changed to \"name [text]\" with a suitably chosen string \"text\"." msgstr "" #: ../../document.rst:1403 207b76f69b4b43b8abf32aaed907a586 msgid "" "If ``True``, root fields with duplicate names in source and target will " "be converted to so-called \"Kids\" of a \"Parent\" object (which lists " "all kid widgets in a PDF array). This will effectively turn those kids " "into instances of the \"same\" widget: if e.g. one of the kids is " "changed, then all its instances will automatically inherit this change --" " no matter on which page they happen to be displayed." msgstr "" #: ../../document.rst:1405 8d9fefec8ad44d23b3c63e2ae6a7a00f msgid "" "*(new in v1.17.7)* specify an interval size greater zero to see progress " "messages on `sys.stdout`. After each interval, a message like `Inserted " "30 of 47 pages.` will be printed." msgstr "" "*(v1.17.7で新規追加)* `sys.stdout` " "で進捗メッセージを表示するための大きなゼロより大きい間隔を指定します。各間隔後、`Inserted 30 of 47 pages.` " "のようなメッセージが印刷されます。" #: ../../document.rst:1407 d77922d1b37a405687f51453c41a5a42 msgid "" "*(new in v1.18.0)* controls whether the list of already copied objects " "should be **dropped** after this method, default ``True``. Set it to 0 " "except for the last one of multiple insertions from the same source PDF. " "This saves target file size and speeds up execution considerably." msgstr "" "*(v1.18.0で新規追加)* このメソッドの後にすでにコピーされたオブジェクトのリストを **削除する** かどうかを制御します。デフォルトは" " ``True`` " "です。同じソースPDFからの複数の挿入の最後以外は、0に設定します。これにより、対象ファイルのサイズが節約され、実行が大幅に高速化されます。" #: ../../document.rst:1411 56b4354a86094489a6bf9bde208dc994 msgid "" "This is a page-based method. Document-level information of source " "documents is therefore mostly ignored. Examples include Optional Content," " Embedded Files, `StructureElem`, table of contents, page labels, " "metadata, named destinations (and other named entries) and some more." msgstr "" #: ../../document.rst:1413 5a07fe3f9eea4d2fae962abdd3b1a7ff msgid "" "If `from_page > to_page`, pages will be **copied in reverse order**. If " "`0 <= from_page == to_page`, then one page will be copied." msgstr "" "`from_page > to_page` の場合、ページは **逆の順序でコピーされます** 。`0 <= from_page == " "to_page` の場合、1ページがコピーされます。" #: ../../document.rst:1415 dc1395aabeda4fbcabbf2f13c6749c77 msgid "" "`docsrc` TOC entries **will not be copied**. It is easy however, to " "recover a table of contents for the resulting document. Look at the " "examples below and at program `join.py `_ in the " "*examples* directory: it can join PDF documents and at the same time " "piece together respective parts of the tables of contents." msgstr "" "*docsrc* のTOCエントリは **コピーされません** " "。ただし、結果のドキュメントの目次を復元することは簡単です。以下の例と、*examples* ディレクトリのプログラム `join.py " "`_ " "を参照してください：これはPDFドキュメントを結合し、同時に対応する目次の部分を組み立てることができます。" #: ../../document.rst:1432 45174efe8b574e39bd0fee7fda1c588a msgid "New in v1.22.0" msgstr "v1.22.0で新規追加" #: ../../document.rst:1434 cd44330e994a49b99c61e25595eb7c0b msgid "" "PDF only: Add an arbitrary supported document to the current PDF. Opens " "\"infile\" as a document, converts it to a PDF and then invokes " ":meth:`Document.insert_pdf`. Parameters are the same as for that method. " "Among other things, this features an easy way to append images as full " "pages to an output PDF." msgstr "" "PDFのみ：任意のサポートされているドキュメントを現在のPDFに追加します。 \"infile\" " "をドキュメントとして開き、PDFに変換し、:meth:`Document.insert_pdf` " "を呼び出します。パラメータはそのメソッドと同じです。他のことの中で、これには画像を出力PDFに完全なページとして追加する簡単な方法が含まれています。" #: ../../document.rst:1436 e33a6fdc9cda41afbf2acefddf2174a3 msgid "" "the input document to insert. May be a filename specification as is valid" " for creating a :ref:`Document` or a :ref:`Pixmap`." msgstr "" "挿入する入力ドキュメント。:ref:`Document` を作成する際に有効なファイル名の指定または :ref:`Pixmap` " "である可能性があります。" #: ../../document.rst:1445 43f27667e5fa455e8b6be14bbed94320 msgid "PDF only: Insert an empty page." msgstr "PDFのみ：空のページを挿入します。" #: ../../document.rst:1447 760c94fa936d413985a6348d9a97a2fa #, fuzzy msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and *doc.page_count* insert **after** the last page." msgstr "" "新しいページを挿入する前のページ番号。`1 < pno <= page_count` である必要があります。特別な値-1および " "*doc.page_count* は最後のページの後に挿入します。" #: ../../document.rst:1449 9c2a0e62a39a43d19cf8bc37207291e7 msgid "page width." msgstr "ページの幅。" #: ../../document.rst:1450 4a2e0f95cd75496fb7ca0aa473e0434a msgid "page height." msgstr "ページの高さ。" #: ../../document.rst:1453 0bd2d3396b664c20a387f310baf3c618 msgid "" "the created page object. Be aware that the page numbers of pages after " "the inserted one will have changed after method execution. For the same " "reason, **all existing page objects will be invalidated.** Using them " "will lead to exceptions." msgstr "" #: ../../document.rst:1465 e582e4a0e898429a8087c9237aea9caf msgid "" "PDF only: Insert a new page and insert some text. Convenience function " "which combines :meth:`Document.new_page` and (parts of) " ":meth:`Page.insert_text`." msgstr "" "PDFのみ：新しいページを挿入し、テキストを挿入します。:meth:`Document.new_page` と " ":meth:`Page.insert_text` の一部を組み合わせた便利な関数です。" #: ../../document.rst:1467 05fc5d62cf1442ef87870b03bf4656e6 #, fuzzy msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and `doc.page_count` insert **after** the last page. Changed in " "v1.14.12 This is now a positional parameter" msgstr "" "**挿入する前** のページ番号（0ベース）を指定します。範囲 `range(-1, doc.page_count + 1)` " "内である必要があります。特別な値-1および `doc.page_count` は最後のページの **後** に挿入します。" #: ../../document.rst:1467 93c42f35dfc74d969baf39f16e854b2c #, fuzzy msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and `doc.page_count` insert **after** the last page." msgstr "" "**挿入する前** のページ番号（0ベース）を指定します。範囲 `range(-1, doc.page_count + 1)` " "内である必要があります。特別な値-1および `doc.page_count` は最後のページの **後** に挿入します。" #: ../../document.rst:1470 b97cd8599f7b49db97a3779b3b40e27a msgid "Changed in v1.14.12" msgstr "v1.14.12で変更" #: ../../document.rst:1470 f6d15d624bcd4485930085e83cc129ac msgid "This is now a positional parameter" msgstr "これは今ポジションパラメータです" #: ../../document.rst:1472 cf6bb035b54e4fcdad814450ae34dcef msgid "For the other parameters, please consult the aforementioned methods." msgstr "その他のパラメータについては、前述のメソッドをご参照ください。" #: ../../document.rst:1475 62dbaf5e5aea49478a003ee16008856d msgid "" "the result of :meth:`Page.insert_text` (number of successfully inserted " "lines)." msgstr ":meth:`Page.insert_text` の結果（正常に挿入された行数）。" #: ../../document.rst:1479 587c560e526a416f9adba46d934431cd #, fuzzy msgid "" "PDF only: Delete a page given by its 0-based number in `-∞ < pno < " "page_count`." msgstr "PDFのみ：0ベースの番号で指定されたページを削除します。`-∞ < pno < page_count - 1` です。" #: ../../document.rst:1481 ../../document.rst:1488 #: 2de6c5ed33694928b05b3af60acc735b 5e0e19b1164a4922a5c4de39dadf8d94 msgid "Changed in v1.18.14: support Python's `del` statement." msgstr "v1.18.14で変更：Pythonの `del` 文をサポート。" #: ../../document.rst:1483 b53db2a971f54e8fa8fe54fc059f0ece msgid "" "the page to be deleted. Negative number count backwards from the end of " "the document (like with indices). Default is the last page." msgstr "削除するページ。負の数は文書の末尾から逆に数えます（インデックスと同様）。デフォルトは最後のページです。" #: ../../document.rst:1487 f663c7417d0c4717918bc0edbdaa19f6 msgid "Changed in v1.18.13: more flexibility specifying pages to delete." msgstr "v1.18.13 で変更されました: 削除するページを指定する柔軟性が向上しました。" #: ../../document.rst:1490 5a7de5dc80b84affad561bc4fedaf80b msgid "PDF only: Delete multiple pages given as 0-based numbers." msgstr "PDF のみ: 0 ベースの番号として指定された複数のページを削除します。" #: ../../document.rst:1494 875c5dde7ff14ca9aa7522c71259f94c msgid "" "**Format 1:** Use keywords. Represents the old format. A contiguous range" " of pages is removed." msgstr "**フォーマット 1:** キーワードを使用します。古いフォーマットを表します。連続したページ範囲が削除されます。" #: ../../document.rst:1493 6b7772a6ff3f4a2db6d2dcb99fded671 msgid "\"from_page\": first page to delete. Zero if omitted." msgstr "\"from_page\": 削除する最初のページ。省略された場合はゼロです。" #: ../../document.rst:1494 0e5c6f821d7044d5ac7c0e6f5ed7f64b msgid "" "\"to_page\": last page to delete. Last page in document if omitted. Must " "not be less then \"from_page\"." msgstr "" "\"to_page\": 削除する最後のページ。省略された場合はドキュメント内の最後のページです。\"from_page\" " "より小さくしてはいけません。" #: ../../document.rst:1496 e8904441ed83424eb87fa87a6a684b2a msgid "" "**Format 2:** Two page numbers as positional parameters. Handled like " "Format 1." msgstr "**フォーマット 2:** 位置パラメータとしての2つのページ番号。フォーマット 1 と同様に処理されます。" #: ../../document.rst:1498 163ec2bcd7934971b9000245d8e3d209 msgid "" "**Format 3:** One positional integer parameter. Equivalent to " ":meth:`Page.delete_page`." msgstr "**フォーマット 3:** 1 つの位置パラメータの整数。:meth:`Page.delete_page` に相当します。" #: ../../document.rst:1500 ac9b0d2bb525429d8ac5afe495854517 msgid "" "**Format 4:** One positional parameter of type *list*, *tuple* or " "*range()* of page numbers. The items of this sequence may be in any order" " and may contain duplicates." msgstr "" "**フォーマット 4:** ページ番号のリスト、*タプル*、または *range()* " "の1つの位置パラメータ。このシーケンスのアイテムは任意の順序であり、重複していてもかまいません。" #: ../../document.rst:1502 2e8e4f3f1ff24632b93215697d0a2594 msgid "" "**Format 5:** *(New in v1.18.14)* Using the Python `del` statement and " "index / slice notation is now possible." msgstr "" "**フォーマット 5:** *(v1.18.14 で新規)* Python の `del` ステートメントとインデックス / " "スライス表記を使用することができます。" #: ../../document.rst:1506 be52d2bac85f42c8a561522fc5dc7694 msgid "" "*(Changed in v1.14.17, optimized in v1.17.7)* In an effort to maintain a " "valid PDF structure, this method and :meth:`delete_page` will also " "deactivate items in the table of contents which point to deleted pages. " "\"Deactivation\" here means, that the bookmark will point to nowhere and " "the title will be shown grayed-out by supporting PDF viewers. The overall" " TOC structure is left intact." msgstr "" "*(v1.14.17 で変更, v1.17.7 で最適化)* 有効な PDF 構造を維持するために、このメソッドと " ":meth:`delete_page` は、削除されたページを指す目次のアイテムも無効化します。ここでの \"無効化\" " "とは、ブックマークがどこを指しているのか分からなくなり、サポートされている PDF " "ビューアによってタイトルがグレーアウト表示されることを意味します。全体の目次構造は維持されます。" #: ../../document.rst:1508 2ea9db623ee644ce851f517b21468bbc msgid "" "It will also remove any **links on remaining pages** which point to a " "deleted one. This action may have an extended response time for documents" " with many pages." msgstr "" "また、削除されたページを指す **残りのページ上のリンク** " "も削除されます。これにより、多くのページを持つドキュメントでは拡張された応答時間が発生する可能性があります。" #: ../../document.rst:1510 9e268616509345318e19407e7f4fce54 msgid "Following examples will all delete pages 500 through 519:" msgstr "以下の例はすべて、ページ500から519を削除します:" #: ../../document.rst:1512 8554875e1e58416180c485b06d4698b6 msgid "`doc.delete_pages(500, 519)`" msgstr "" #: ../../document.rst:1513 1c822f9af13441608441afe5bf0640dd msgid "`doc.delete_pages(from_page=500, to_page=519)`" msgstr "" #: ../../document.rst:1514 e46ee2d732134660b9a9f857991dabce msgid "`doc.delete_pages((500, 501, 502, ... , 519))`" msgstr "" #: ../../document.rst:1515 b30e293c5c9640ba9f5d8f3875607c97 msgid "`doc.delete_pages(range(500, 520))`" msgstr "" #: ../../document.rst:1516 1e369b51a48c4110bfb776a7c91dac36 msgid "`del doc[500:520]`" msgstr "" #: ../../document.rst:1517 33382327b14c40309cb885c892db74dc msgid "`del doc[(500, 501, 502, ... , 519)]`" msgstr "" #: ../../document.rst:1518 835883ce222348f1939be4af90e88154 msgid "`del doc[range(500, 520)]`" msgstr "" #: ../../document.rst:1520 65e4760990f848c7a684989dd067afbd msgid "" "For the :ref:`AdobeManual` the above takes about 0.6 seconds, because the" " remaining 1290 pages must be cleaned from invalid links." msgstr "" ":ref:`AdobeManual` " "では、上記の操作に約0.6秒かかります。なぜなら、残りの1290ページから無効なリンクを削除する必要があるからです。" #: ../../document.rst:1522 7af3a67223f04f44835189f49959825d msgid "" "In general, the performance of this method is dependent on the number of " "remaining pages -- **not** on the number of deleted pages: in the above " "example, **deleting all pages except** those 20, will need much less " "time." msgstr "" "一般的に、このメソッドのパフォーマンスは残りのページの数に依存します - 削除されたページの数には依存 **しません** " "。上記の例では、20個のページ **以外のすべてのページを削除する** 場合、はるかに少ない時間がかかります。" #: ../../document.rst:1527 652ee83c146f452098f4379a8c73047a msgid "PDF only: Copy a page reference within the document." msgstr "PDF のみ: ドキュメント内でページの参照をコピーします。" #: ../../document.rst:1529 ac1cce6e9936446eb35a3ffe8ca915d1 msgid "the page to be copied. Must be in range `0 <= pno < page_count`." msgstr "コピーするページ。範囲は `0 <= pno < page_count` である必要があります。" #: ../../document.rst:1531 ../../document.rst:1543 #: c41b90dc8ef640408f1a617a2e0fc519 ca3166610784468cbc085259ba27a3ea msgid "" "the page number in front of which to copy. The default inserts **after** " "the last page." msgstr "コピーする位置の前のページ番号。デフォルトでは最後のページの **後** に挿入されます。" #: ../../document.rst:1533 8468fc8b63444047b7a1fe75547cd1fd msgid "" "Only a new **reference** to the page object will be created -- not a new " "page object, all copied pages will have identical attribute values, " "including the :attr:`Page.xref`. This implies that any changes to one of " "these copies will appear on all of them." msgstr "" "ページオブジェクトへの新しい **参照** のみが作成されます - " "新しいページオブジェクトは作成されません。すべてのコピーされたページは、:attr:`Page.xref` " "を含む属性値が同じになります。これは、これらのコピーの1つに対する変更がすべてのコピーに反映されることを意味します。" #: ../../document.rst:1537 d97170af740a4e5fbd5d5be2e8c4c008 msgid "New in v1.14.17" msgstr "v1.14.17 で新規" #: ../../document.rst:1539 e5bfe27961644509afa6eb237a7aaa90 msgid "PDF only: Make a full copy (duplicate) of a page." msgstr "PDF のみ: ページの完全なコピー（複製）を作成します。" #: ../../document.rst:1541 bb27bf35370f4350896c2af762ffb1bc msgid "the page to be duplicated. Must be in range `0 <= pno < page_count`." msgstr "複製するページ。範囲は `0 <= pno < page_count` である必要があります。" #: ../../document.rst:1547 f703ba87ea974305a4c30425ca1ff9b9 msgid "" "In contrast to :meth:`copy_page`, this method creates a new page object " "(with a new :data:`xref`), which can be changed independently from the " "original." msgstr "" ":meth:`copy_page` とは異なり、このメソッドは新しいページオブジェクト（新しい :data:`xref` " "を持つ）を作成します。これは元のページから独立して変更できます。" #: ../../document.rst:1549 07e3b642c6b94e9e8f52daa72f74a907 msgid "" "Any Popup and \"IRT\" (\"in response to\") annotations are **not copied**" " to avoid potentially incorrect situations." msgstr "ポップアップと \"IRT\"（\"応答先\"）注釈は、潜在的に誤った状況を回避するために **コピーされません** 。" #: ../../document.rst:1553 43ec556cbc38492c8049b8372e53daac msgid "PDF only: Move (copy and then delete original) a page within the document." msgstr "PDF のみ: ドキュメント内でページを移動します（コピーしてから元のページを削除）。" #: ../../document.rst:1555 b044a8f7a7af40788e9d81537eb619ad msgid "the page to be moved. Must be in range `0 <= pno < page_count`." msgstr "移動するページ。範囲は `0 <= pno < page_count` である必要があります。" #: ../../document.rst:1557 946f21ee475c42878bf3b1dae84f7d69 msgid "" "the page number in front of which to insert the moved page. The default " "moves **after** the last page." msgstr "移動したページの前に挿入するページ番号。デフォルトでは最後のページの **後** に移動します。" #: ../../document.rst:1562 e8d7a9d259534c618a11baa88ffeb3fc msgid "New in v1.17.4" msgstr "v1.17.4 で新規" #: ../../document.rst:1564 8b3171a1d9a142c9a9c030fe8d31c8d2 msgid "" "PDF only: Get or set the */NeedAppearances* property of Form PDFs. Quote:" " *\"(Optional) A flag specifying whether to construct appearance streams " "and appearance dictionaries for all widget annotations in the document " "... Default value: false.\"* This may help controlling the behavior of " "some readers / viewers." msgstr "" "PDF のみ: Form PDF の */NeedAppearances* プロパティを取得または設定します。引用: " "*\"（オプション）ドキュメント内のすべてのウィジェット注釈の外観ストリームと外観辞書を構築するかどうかを指定するフラグ...デフォルト値: " "false\"* 。これは一部のリーダー/ビューアの動作を制御するのに役立つかもしれません。" #: ../../document.rst:1566 21bdc7002b114b8794f1a0a9c6ee76a5 msgid "" "set the property to this value. If omitted or `None`, inquire the current" " value." msgstr "プロパティをこの値に設定します。省略された場合または `None` の場合、現在の値を問い合わせます。" #: ../../document.rst:1569 78f9700e38dd443e9f73a91fda3dc450 msgid "" "* None: not a Form PDF, or property not defined. * True / False: the " "value of the property (either just set or existing for inquiries). Has no" " effect if no Form PDF." msgstr "" #: ../../document.rst:1570 c0025670860c42d5bd1c8f5c34a6dad6 msgid "None: not a Form PDF, or property not defined." msgstr "None: フォーム PDF ではないか、プロパティが定義されていない。" #: ../../document.rst:1571 eb06f30be4434520bda89c558742261d msgid "" "True / False: the value of the property (either just set or existing for " "inquiries). Has no effect if no Form PDF." msgstr "True / False: プロパティの値（設定されたばかりまたは問い合わせ用に存在する）。フォーム PDF がない場合は影響しません。" #: ../../document.rst:1577 75e79125f8c7472cb0a19ed8e1458e1a msgid "" "PDF only: Return whether the document contains signature fields. This is " "an optional PDF property: if not present (return value -1), no " "conclusions can be drawn -- the PDF creator may just not have bothered " "using it." msgstr "" "PDF のみ: ドキュメントに署名フィールドが含まれているかどうかを返します。これはオプションの PDF プロパティです。存在しない場合（返り値 " "-1）、結論を導くことはできません - PDF の作成者は単にそれを使用しなかった可能性があります。" #: ../../document.rst:1580 9a14234501f54034bb1bf739d64a15fa msgid "" "* -1: not a Form PDF / no signature fields recorded / no *SigFlags* " "found. * 1: at least one signature field exists. * 3: contains " "signatures that may be invalidated if the file is saved (written) in a " "way that alters its previous contents, as opposed to an incremental " "update." msgstr "" #: ../../document.rst:1581 9bad9283ef584aa2b078c83f7d777b63 msgid "-1: not a Form PDF / no signature fields recorded / no *SigFlags* found." msgstr "-1: フォーム PDF でない / 署名フィールドが記録されていない / *SigFlags* が見つからない。" #: ../../document.rst:1582 deabde5552354d23bc0241dce237b354 msgid "1: at least one signature field exists." msgstr "1: 少なくとも1つの署名フィールドが存在します。" #: ../../document.rst:1583 af34d2d341994de4b3f79434d0d6027a msgid "" "3: contains signatures that may be invalidated if the file is saved " "(written) in a way that alters its previous contents, as opposed to an " "incremental update." msgstr "3: ファイルが前の内容を変更する方法で保存（書き込み）されると、署名が無効になる可能性のある署名が含まれています。これは増分更新とは対照的です。" #: ../../document.rst:1592 04fdb7d7d7c84095a3494d40af0b5926 msgid "" "Changed in v1.14.16: The sequence of positional parameters \"name\" and " "\"buffer\" has been changed to comply with the call pattern of other " "functions." msgstr "" "v1.14.16 で変更されました: 位置パラメータ \"name\" と \"buffer\" " "の順序が他の関数の呼び出しパターンに従うように変更されました。" #: ../../document.rst:1594 fcd3db75809240cc8f190dd9a00289d2 msgid "" "PDF only: Embed a new file. All string parameters except the name may be " "unicode (in previous versions, only ASCII worked correctly). File " "contents will be compressed (where beneficial)." msgstr "" "PDF のみ: 新しいファイルを埋め込みます。名前以外のすべての文字列パラメータは Unicode である場合があります（以前のバージョンでは " "ASCII しか正しく動作しませんでした）。ファイルの内容は（有益な場合に）圧縮されます。" #: ../../document.rst:1596 2cea88e56a044b0c8bad08e9a205ccde msgid "entry identifier, **must not already exist**." msgstr "エントリの識別子、**すでに存在しない必要** があります。" #: ../../document.rst:1597 b4cb313585c3435fa169abd1fa4d1619 msgid "" "file contents. *(Changed in v1.14.13)* *io.BytesIO* is now also " "supported." msgstr "" #: ../../document.rst:1597 4280d1c050654a94a34238d69e159094 msgid "file contents." msgstr "ファイルの内容。" #: ../../document.rst:1599 ../../document.rst:1673 #: 31a1f516458f40c39c3f700e4ef89de4 b0eb6859ed644497bc3e05f9f73434b3 msgid "*(Changed in v1.14.13)* *io.BytesIO* is now also supported." msgstr "*(v1.14.13 で変更)* *io.BytesIO* もサポートされるようになりました。" #: ../../document.rst:1601 ac97d3204a544f86b77d976c92acbf7b msgid "optional filename. Documentation only, will be set to *name* if `None`." msgstr "オプションのファイル名。ドキュメンテーション専用で、`None` の場合は *name* に設定されます。" #: ../../document.rst:1602 a5690203a4ba480eb382e82deceb9895 msgid "" "optional unicode filename. Documentation only, will be set to *filename* " "if `None`." msgstr "オプションのUnicodeファイル名。ドキュメンテーション専用で、`None` の場合は *filename* に設定されます。" #: ../../document.rst:1603 6d4f198ba29348218b4fe50cccdefa1f msgid "optional description. Documentation only, will be set to *name* if `None`." msgstr "オプションの説明。ドキュメンテーション専用で、`None` の場合は *name* に設定されます。" #: ../../document.rst:1606 7b71f66a34ea47e9a71e7fe5e7d64fa0 msgid "" "*(Changed in v1.18.13)* The method now returns the :data:`xref` of the " "inserted file. In addition, the file object now will be automatically " "given the PDF keys `/CreationDate` and `/ModDate` based on the current " "date-time." msgstr "" "*(v1.18.13 で変更)* このメソッドは挿入されたファイルの :data:`xref` " "も返すようになりました。さらに、ファイルオブジェクトには現在の日時に基づいて自動的に PDF キー `/CreationDate` および " "`/ModDate` が設定されるようになりました。" #: ../../document.rst:1611 207a6bc78c654390b4b1f2cf463dd50f msgid "" "Changed in v1.14.16: This is now a method. In previous versions, this was" " a property." msgstr "v1.14.16 で変更されました: これは現在のメソッドです。以前のバージョンではプロパティでした。" #: ../../document.rst:1613 0cb7ff09b67448ac9cd78cb7b0b7efb7 msgid "PDF only: Return the number of embedded files." msgstr "PDF のみ: 埋め込まれたファイルの数を返します。" #: ../../document.rst:1617 005666a2614842c9b4353f5f802b6c55 msgid "" "PDF only: Retrieve the content of embedded file by its entry number or " "name. If the document is not a PDF, or entry cannot be found, an " "exception is raised." msgstr "" "PDF のみ: エントリ番号または名前によって埋め込まれたファイルの内容を取得します。ドキュメントが PDF " "でない場合、またはエントリが見つからない場合、例外が発生します。" #: ../../document.rst:1619 ../../document.rst:1639 ../../document.rst:1670 #: 869875aa0dfe44808e52deebefea1de1 b13cd4114f2545a9be72cfc74d7c87be #: bf32473089a3483e8ddc9dac22d37916 msgid "index or name of entry. An integer must be in `range(embfile_count())`." msgstr "エントリのインデックスまたは名前。整数は範囲内である必要があります `range(embfile_count())`。" #: ../../document.rst:1625 e338d280c75b4573b622feabbe710c57 msgid "Changed in v1.14.16: Items can now be deleted by index, too." msgstr "v1.14.16 で変更されました: インデックスによってアイテムを削除できるようになりました。" #: ../../document.rst:1627 333fc09a48dc4e96be1d0d96576eccba msgid "" "PDF only: Remove an entry from `/EmbeddedFiles`. As always, physical " "deletion of the embedded file content (and file space regain) will occur " "only when the document is saved to a new file with a suitable garbage " "option." msgstr "" "PDF のみ: `/EmbeddedFiles` " "からエントリを削除します。いつものように、適切なガベージオプションを使用して新しいファイルに保存すると、埋め込まれたファイルの内容の物理的な削除（およびファイルスペースの回復）が行われます。" #: ../../document.rst:1629 eee9b150efa74ebb95b8d065ce663d9e msgid "index or name of entry." msgstr "エントリのインデックスまたは名前。" #: ../../document.rst:1631 8c4ab8c1f77e4c2985abe3c93f92b10d msgid "" "When specifying an entry name, this function will only **delete the first" " item** with that name. Be aware that PDFs not created with PyMuPDF may " "contain duplicate names. So you may want to take appropriate precautions." msgstr "" "エントリ名を指定する場合、この関数はその名前を持つ **最初のアイテムのみを削除します** 。PyMuPDF で作成された PDF 以外の PDF" " には重複する名前が含まれている可能性があるため、適切な注意を払う必要があるかもしれません。" #: ../../document.rst:1635 ce3e3fdc43df49f29497bf219a55ffb7 msgid "Changed in v1.18.13" msgstr "v1.18.13 で変更されました" #: ../../document.rst:1637 66294342e3bd417fa3d25391a8d4394d msgid "" "PDF only: Retrieve information of an embedded file given by its number or" " by its name." msgstr "PDF のみ: 埋め込まれたファイルの情報を取得します。エントリ番号または名前によって指定されたファイルの情報を取得します。" #: ../../document.rst:1642 d938771d7b2e410ebbe66f3bffdc3111 msgid "" "a dictionary with the following keys: * ``name`` -- (*str*) name under " "which this entry is stored * ``filename`` -- (*str*) filename * " "``ufilename`` -- (*unicode*) filename * ``description`` -- (*str*) " "description * ``size`` -- (*int*) original file size * ``length`` -- " "(*int*) compressed file length * ``creationDate`` -- (*str*) date-time of" " item creation in PDF format * ``modDate`` -- (*str*) date-time of last " "change in PDF format * ``collection`` -- (*int*) :data:`xref` of the " "associated PDF portfolio item if any, else zero. * ``checksum`` -- " "(*str*) a hashcode of the stored file content as a hexadecimal string. " "Should be MD5 according to PDF specifications, but be prepared to see " "other hashing algorithms." msgstr "" #: ../../document.rst:1642 ab305172c9934b6d9c00eb5ed6e4649a msgid "a dictionary with the following keys:" msgstr "以下のキーを持つ辞書:" #: ../../document.rst:1644 b7a076e5859b4bcab80e34541859d7ca msgid "``name`` -- (*str*) name under which this entry is stored" msgstr "``name`` – (*str*) このエントリが格納されている名前" #: ../../document.rst:1645 121172b7332143a8b549ef30f4bd5bb1 msgid "``filename`` -- (*str*) filename" msgstr "``filename`` – (*str*) ファイル名" #: ../../document.rst:1646 89fd41822ad34573a7b952b2fd4303ac msgid "``ufilename`` -- (*unicode*) filename" msgstr "``ufilename`` – (*unicode*) Unicode ファイル名" #: ../../document.rst:1647 437589e818d74dc3aa02750c07e6aff9 msgid "``description`` -- (*str*) description" msgstr "``description`` – (*str*) 説明" #: ../../document.rst:1648 8bf22226e6b946ba8904a12c9047c6db msgid "``size`` -- (*int*) original file size" msgstr "``size`` – (*int*) 元のファイルサイズ" #: ../../document.rst:1649 aac50a010de4434abbf736335b328344 msgid "``length`` -- (*int*) compressed file length" msgstr "``length`` – (*int*) 圧縮ファイルの長さ" #: ../../document.rst:1650 e79e7816a4a14e959f1d7ae2ce4e4ee3 msgid "``creationDate`` -- (*str*) date-time of item creation in PDF format" msgstr "``creationDate`` – (*str*) PDF 形式のアイテム作成の日時" #: ../../document.rst:1651 d29662d08223403686e394f5d5d4de79 msgid "``modDate`` -- (*str*) date-time of last change in PDF format" msgstr "``modDate`` – (*str*) PDF 形式の最終変更の日時" #: ../../document.rst:1652 69752e18d0a54012a9dbebd7a2a8eded msgid "" "``collection`` -- (*int*) :data:`xref` of the associated PDF portfolio " "item if any, else zero." msgstr "``collection`` – (*int*) 関連する PDF ポートフォリオアイテムの :data:`xref`（あれば）、それ以外はゼロ。" #: ../../document.rst:1653 870473bef4414d4a9f160c797a395163 msgid "" "``checksum`` -- (*str*) a hashcode of the stored file content as a " "hexadecimal string. Should be MD5 according to PDF specifications, but be" " prepared to see other hashing algorithms." msgstr "" "``checksum`` – (*str*) 16進数の文字列として格納されたファイルコンテンツのハッシュコード。PDF 仕様に従えば MD5 " "であるべきですが、他のハッシュアルゴリズムも見る可能性があるので、準備しておいてください。" #: ../../document.rst:1657 b293ff432c4943c7b13c527f6ae85be2 msgid "" "PDF only: Return a list of embedded file names. The sequence of the names" " equals the physical sequence in the document." msgstr "PDF のみ: 埋め込まれたファイルの名前のリストを返します。名前のシーケンスはドキュメント内の物理的なシーケンスと同じです。" #: ../../document.rst:1668 40d7ae2aac41481b8256423dedbe2570 msgid "" "PDF only: Change an embedded file given its entry number or name. All " "parameters are optional. Letting them default leads to a no-operation." msgstr "" "PDF のみ: " "エントリ番号または名前によって指定された埋め込まれたファイルを変更します。すべてのパラメータはオプションです。デフォルトで設定すると、操作は行われません。" #: ../../document.rst:1671 f59d2798159c472e8b861edc7cafc49e msgid "" "the new file content. *(Changed in v1.14.13)* *io.BytesIO* is now also " "supported." msgstr "新しいファイルの内容。*(v1.14.13 で変更)* *io.BytesIO* もサポートされるようになりました。" #: ../../document.rst:1671 cb03da4bee5c476891ce54c568329d5b msgid "the new file content." msgstr "新しいファイルの内容。" #: ../../document.rst:1675 5b7dac2348554f989d99d3971995632c msgid "the new filename." msgstr "新しいファイル名。" #: ../../document.rst:1676 cf4779ea31f6485baa24ba26f618ee73 msgid "the new unicode filename." msgstr "新しいUnicodeファイル名。" #: ../../document.rst:1677 0c0c1f586af547b3806f6c000e271d90 msgid "the new description." msgstr "新しい説明。" #: ../../document.rst:1679 0588e113557544cfa618e9fa05550f26 msgid "" "*(Changed in v1.18.13)* The method now returns the :data:`xref` of the " "file object." msgstr "*(v1.18.13 で変更)* このメソッドはファイルオブジェクトの :data:`xref` も返すようになりました。" #: ../../document.rst:1682 caacf7f8451042be88437cdd7ebf80f6 msgid "" "xref of the file object. Automatically, its `/ModDate` PDF key will be " "updated with the current date-time." msgstr "ファイルオブジェクトのxref。自動的に、`/ModDate` PDF キーが現在の日時で更新されます。" #: ../../document.rst:1687 c1612e02ab6e4aaa90882747a1695057 msgid "" "Release objects and space allocations associated with the document. If " "created from a file, also closes *filename* (releasing control to the " "OS). Explicitly closing a document is equivalent to deleting it, `del " "doc`, or assigning it to something else like `doc = None`." msgstr "" "文書に関連付けられたオブジェクトとスペースの割り当てを解放します。ファイルから作成された場合、ファイル名も閉じられ（OS " "に制御を解放）ます。文書を明示的に閉じることは、それを削除すること、`del doc` 、または `doc = None` " "のように別のものに割り当てることと同等です。" #: ../../document.rst:1691 ../../document.rst:1705 ../../document.rst:1712 #: ../../document.rst:1719 ../../document.rst:1730 ../../document.rst:1739 #: ../../document.rst:1888 2d1db6abe10b4b30a5fee4fc3150a1a2 #: 3696c9e47a5d4f279ca6e13ca9badc38 5dffd418b2484c78bff8e129dd0beda0 #: 90fec84dc6174a0e8a82750746e35157 c721b36a29cf4051bbf9e0ca82266951 #: c9d56f09885c4db3afad4b92d4bb30c5 d854778651b548139937059eb60c11db msgid "New in v1.16.8" msgstr "" #: ../../document.rst:1692 a23659b9ffbc469f9b1e6aeaf63329c8 msgid "Changed in v1.18.10" msgstr "v1.18.10 で変更" #: ../../document.rst:1694 8ef598a908184a068d803110e0727a3e msgid "PDF only: Return the definition source of a PDF object." msgstr "PDF のみ: PDF オブジェクトの定義ソースを返します。" #: ../../document.rst:1696 2f3c19c00a5c4c33880871794c2207c2 #, fuzzy msgid "" "the object's :data:`xref`. *Changed in v1.18.10:* A value of `-1` returns" " the PDF trailer source." msgstr "オブジェクトの :data`xref` 。*v1.18.10 で変更:* -1 の値は PDF トレーラーのソースを返します。" #: ../../document.rst:1697 d7825dd896e841a4946cd46633cc1cba msgid "whether to generate a compact output with no line breaks or spaces." msgstr "改行やスペースのないコンパクトな出力を生成するかどうか。" #: ../../document.rst:1698 4a2d6a2741b84dbbabd0ae4824b249b6 msgid "whether to ASCII-encode binary data." msgstr "バイナリデータを ASCII エンコードするかどうか。" #: ../../document.rst:1701 d289d49008164203be7390dad133165b msgid "The object definition source." msgstr "オブジェクトの定義ソース。" #: ../../document.rst:1707 33f4eb609f2e4a31bcedf6bbb15f807b msgid "" "PDF only: Return the :data:`xref` number of the PDF catalog (or root) " "object. Use that number with :meth:`Document.xref_object` to see its " "source." msgstr "" "PDF のみ: PDF カタログ（またはルート）オブジェクトの :data:`xref` 番号を返します。これを " ":meth:`Document.xref_object` で使用してそのソースを表示できます。" #: ../../document.rst:1714 25deae598bf0499b83ce312067283693 msgid "" "PDF only: Return the trailer source of the PDF, which is usually located" " at the PDF file's end. This is :meth:`Document.xref_object` with an " ":data:`xref` argument of -1." msgstr "" "PDF のみ: PDF のトレーラーソースを返します。通常、これは PDF ファイルの末尾にあります。これは " ":meth:`Document.xref_object` で :data:`xref` 引数が -1 の場合です。" #: ../../document.rst:1721 e4cb3087b0c64d3eb47f44d544152d83 msgid "" "PDF only: Return the **decompressed** contents of the :data:`xref` stream" " object." msgstr "PDF のみ: :data:`xref` ストリームオブジェクトの **解凍された** コンテンツを返します。" #: ../../document.rst:1723 ../../document.rst:1743 ../../document.rst:1762 #: bd1262c85c614c2d81fa5f15f512c739 e80e7230a803497aa97d368a20d6e190 #: f5b32eb85c0e4db8be3bb7ba4cea4d21 msgid ":data:`xref` number." msgstr ":data:`xref` 番号。" #: ../../document.rst:1726 c2333be86e844fc98605aa5bf81d198f msgid "the (decompressed) stream of the object." msgstr "（解凍された）オブジェクトのストリーム。" #: ../../document.rst:1732 283d3fc3dd6540698765de3addb1126c msgid "" "PDF only: Return the **unmodified** (esp. **not decompressed**) contents " "of the :data:`xref` stream object. Otherwise equal to " ":meth:`Document.xref_stream`." msgstr "" "PDF のみ: :data:`xref` ストリームオブジェクトの**変更前**（特に " "**解凍されていない**）コンテンツを返します。それ以外の点では :meth:`Document.xref_stream` と同等です。" #: ../../document.rst:1735 462546377c3c4cd4b1472360c095b7c1 msgid "the (original, unmodified) stream of the object." msgstr "（元の、変更前の）オブジェクトのストリーム。" #: ../../document.rst:1741 0b9b082e450d41eb9b314d3946b524a8 msgid "" "PDF only: Replace object definition of :data:`xref` with the provided " "string. The xref may also be new, in which case this instruction " "completes the object definition. If a page object is also given, its " "links and annotations will be reloaded afterwards." msgstr "" "PDF のみ: :data:`xref` のオブジェクト定義を提供された文字列で置き換えます。xref " "が新しい場合、この命令はオブジェクト定義を完成させます。ページオブジェクトも指定された場合、そのリンクと注釈が後で再ロードされ、リンクと/または注釈に関連する変更が反映されます。" #: ../../document.rst:1745 8933f62dde2645e88c680302e0737fdd msgid "a string containing a valid PDF object definition." msgstr "有効な PDF オブジェクト定義を含む文字列。" #: ../../document.rst:1747 a2630fd6e0d64414b7ad457df37269b0 msgid "" "a page object. If provided, indicates, that annotations of this page " "should be refreshed (reloaded) to reflect changes incurred with links and" " / or annotations." msgstr "ページオブジェクト。指定された場合、このページの注釈が変更を反映するために再ロードされることを示します。" #: ../../document.rst:1751 6e2ff3cc8ba1477faddb0b4a8c62a0c1 msgid "zero if successful, otherwise an exception will be raised." msgstr "成功した場合はゼロ、それ以外の場合は例外が発生します。" #: ../../document.rst:1756 59e3f67362e24cab9751cfb4f80bdaee msgid "New in v.1.16.8" msgstr "v1.16.8 で新規" #: ../../document.rst:1757 e613c9bdf9154e69bfdb4290b3db58b3 msgid "Changed in v1.19.2: added parameter \"compress\"" msgstr "v1.19.2 で変更: パラメータ \"compress\" を追加" #: ../../document.rst:1758 b5a2a17e15894322882de2242d8fd8d7 msgid "" "Changed in v1.19.6: deprecated parameter \"new\". Now confirms that the " "object is a PDF dictionary object." msgstr "" "v1.19.6 で変更: パラメータ \"new\" を非推奨にし、無視します。オブジェクトが PDF " "辞書オブジェクトであることを確認するようになりました。" #: ../../document.rst:1760 be549db0daac4457bfaa4bd7267ba26b msgid "" "Replace the stream of an object identified by :data:`xref`, which must be" " a PDF dictionary. If the object is no :data:`stream`, it will be turned " "into one. The function automatically performs a compress operation " "(\"deflate\") where beneficial." msgstr "" "xref で識別されるオブジェクトのストリームを置き換えます。:data:`xref` は PDF " "辞書である必要があります。オブジェクトがストリームでない場合、それをストリームに変換します。この関数は、有益な場合には自動的に圧縮操作（\"deflate\"）を実行します。" #: ../../document.rst:1764 10fe63cbe0d341f3a69640433bd62174 msgid "" "the new content of the stream. *(Changed in v1.14.13:)* *io.BytesIO* " "objects are now also supported." msgstr "" #: ../../document.rst:1764 af4a5ac5fb2a4e098c781ed0b4edc120 msgid "the new content of the stream." msgstr "ストリームの新しい内容。" #: ../../document.rst:1766 8f1f5a91c7ab489dbcf4485406b77160 msgid "*(Changed in v1.14.13:)* *io.BytesIO* objects are now also supported." msgstr "*(v1.14.13 で変更:)* *io.BytesIO* オブジェクトもサポートされるようになりました。" #: ../../document.rst:1768 15ae756f4ecb41b288efbd1eb2c46b65 msgid "*deprecated* and ignored. Will be removed some time after v1.20.0." msgstr "*非推奨* で無視されます。v1.20.0 以降のある時点で削除されます。" #: ../../document.rst:1769 937c966669724ea086fc25ab2b60cdac msgid "" "whether to compress the inserted stream. If `True` (default), the stream " "will be inserted using `/FlateDecode` compression (if beneficial), " "otherwise the stream will inserted as is." msgstr "" "挿入されるストリームを圧縮するかどうか。`True` の場合（デフォルト）、ストリームは `/FlateDecode` " "圧縮を使用して挿入されます（有益な場合）、それ以外の場合はストリームはそのまま挿入されます。" #: ../../document.rst:1771 52d2cd2519ce458b821f982d7560f805 msgid "" "if :data:`xref` does not represent a PDF :data:`dict`. An empty " "dictionary ``<<>>`` is accepted. So if you just created the xref and want" " to give it a stream, first execute `doc.update_object(xref, \"<<>>\")`, " "and then insert the stream data with this method." msgstr "" ":data:`xref` が PDF 辞書を表していない場合。空の辞書 < は受け入れられます。したがって、xref " "を作成し、それにストリームを指定する場合は、まず `doc.update_object(xref, \"<<>>\")` " "を実行し、その後、このメソッドでストリームデータを挿入してください。" #: ../../document.rst:1773 cb6a6dc6a8254e4c8bb0f9c0590b4a57 msgid "" "The method is primarily (but not exclusively) intended to manipulate " "streams containing PDF operator syntax (see pp. 643 of the " ":ref:`AdobeManual`) as it is the case for e.g. page content streams." msgstr "" "このメソッドは主に（しかし排他的ではなく）PDFオペレータ構文を含むストリームを操作することを意図しています（:ref:`AdobeManual`" " の pp. 643 参照）。例えばページのコンテンツストリームのようにです。" #: ../../document.rst:1775 e6f22217dcf04f5ca0789618ccc4b6a1 msgid "" "If you update a contents stream, consider using save parameter " "*clean=True* to ensure consistency between PDF operator source and the " "object structure." msgstr "" "コンテンツストリームを更新する場合、PDFオペレータのソースとオブジェクト構造の間の整合性を確保するために save パラメータを " "*clean=True* で使用することを検討してください。" #: ../../document.rst:1777 9175289674fe42d58a6b6abdb5e16e51 msgid "" "Example: Let us assume that you no longer want a certain image appear on " "a page. This can be achieved by deleting the respective reference in its " "contents source(s) -- and indeed: the image will be gone after reloading " "the page. But the page's :data:`resources` object would still show the " "image as being referenced by the page. This save option will clean up any" " such mismatches." msgstr "" "例: ある画像をページに表示させたくないと仮定しましょう。これは、そのコンテンツソース内の該当する参照を削除することによって実現できます - " "そして実際には、ページを再読み込みした後、画像は消えてしまいます。ただし、ページの :data:`resources` " "は、まだその画像がページによって参照されていると表示されます。この保存オプションは、そのような不一致をクリーンアップします。" #: ../../document.rst:1782 d9275845ca0549f9810fe1c459229023 msgid "New in v1.19.5" msgstr "v1.19.5 で新規" #: ../../document.rst:1784 1978f66df0e74a988b853cc4459b38d0 #, fuzzy msgid "" "PDF Only: Make ``target`` xref an exact copy of ``source``. If ``source``" " is a :data:`stream`, then this data is also copied." msgstr "" "PDF のみ: *ターゲット* の xref をソースの正確なコピーにします。*ソース* が :data:`stream` " "の場合、これらのデータもコピーされます。" #: ../../document.rst:1786 ede3e57cd1a54c4dae2acc826a5ca8bf msgid "the source :data:`xref`. It must be an existing **dictionary** object." msgstr "ソースの :data:`xref`。既存の **辞書** オブジェクトである必要があります。" #: ../../document.rst:1787 a114c0a1e048457db2694da7e1b8a322 msgid "" "the target xref. Must be an existing **dictionary** object. If the xref " "has just been created, make sure to initialize it as a PDF dictionary " "with the minimum specification ``<<>>``." msgstr "" "ターゲットの :data:`xref`。既存の **辞書** オブジェクトである必要があります。xref が新たに作成されたばかりの場合、最小仕様" " ``<<>>`` を持つ PDF 辞書として初期化することを確認してください。" #: ../../document.rst:1788 59c3eb8299844c509459fa4e5a6ff3b1 msgid "" "an optional list of top-level keys in ``target``, that should not be " "removed in preparation of the copy process." msgstr "``target`` 内のトップレベルのキーを削除する準備段階で削除しない、オプションのキーリスト。" #: ../../document.rst:1792 1447fd7c08ef42a7ae90572fa47e3c80 msgid "This method has much in common with Python's *dict* method `copy()`." msgstr "このメソッドは、Python の *dict* メソッド `copy()` と多くの共通点があります。" #: ../../document.rst:1793 c332b30c15b841de889aa5834596e374 msgid "Both xref numbers must represent existing dictionaries." msgstr "両方の xref 番号は既存の辞書を表す必要があります。" #: ../../document.rst:1794 c4b2efbb94164cf0bb995217e6390c71 msgid "" "Before data is copied from *source*, all *target* dictionary keys are " "deleted. You can specify exceptions from this in the ``keep`` list. If " "*source* however has a same-named key, its value will still replace the " "target." msgstr "" "データがソースからコピーされる前に、すべての *ターゲット* 辞書のキーが削除されます。この削除からの例外を ``keep`` " "リストで指定できます。ただし、*ソース* に同じ名前のキーがある場合、その値はターゲットに置き換えられます。" #: ../../document.rst:1795 a83d35411e754766978f64291fb8cb50 msgid "" "If ``source`` is a :data:`stream` object, then these data will also be " "copied over, and ``target`` will be converted to a stream object." msgstr "" "``source`` が ``stream`` オブジェクトである場合、そのデータもコピーされ、``target`` は ``stream`` " "オブジェクトに変換されます。" #: ../../document.rst:1796 344e7a4ddcfb4ab89dcfcc2862bc8f8d msgid "" "A typical use case is to replace or remove an existing image without " "using redaction annotations. Example scripts can be seen `in this PyMuPDF" " Utilities example `_." msgstr "" "典型的な使用例は、赤塗り注釈を使用せずに既存の画像を置き換えたり削除したりすることです。例のスクリプトは `こちら " "`_ で確認できます。" #: ../../document.rst:1800 bb36292ec69e4f9b98c4ec88541612f9 msgid "" "PDF Only: Extract data and meta information of an image stored in the " "document. The output can directly be used to be stored as an image file, " "as input for PIL, :ref:`Pixmap` creation, etc. This method avoids using " "pixmaps wherever possible to present the image in its original format " "(e.g. as JPEG)." msgstr "" "PDF のみ: " "文書に格納された画像のデータとメタ情報を抽出します。出力は、画像ファイルとして保存するための直接的な使用、PIL、:ref:`Pixmap` " "の作成などに使用できます。このメソッドは、できる限りピクマップを使用せず、画像をその元の形式（例：JPEG " "として）で表示することを目的としています。" #: ../../document.rst:1802 78f689ab3d4340b284a59caa46718c80 msgid "" ":data:`xref` of an image object. If this is not in `range(1, " "doc.xref_length())`, or the object is no image or other errors occur, " "`None` is returned and no exception is raised." msgstr "" "画像オブジェクトの :data:`xref`。これが `range(1, doc.xref_length())` " "の範囲外であるか、オブジェクトが画像でないか、その他のエラーが発生した場合、 `None` が返され、例外は発生しません。" #: ../../document.rst:1805 6f94452f16664114839249285cdf2d94 msgid "" "a dictionary with the following keys * *ext* (*str*) image type (e.g. " "*'jpeg'*), usable as image file extension * *smask* (*int*) :data:`xref` " "number of a stencil (/SMask) image or zero * ``width`` (*int*) image " "width * ``height`` (*int*) image height * *colorspace* (*int*) the " "image's *colorspace.n* number. * *cs-name* (*str*) the image's " "*colorspace.name*. * *xres* (*int*) resolution in x direction. Please " "also see :data:`resolution`. * *yres* (*int*) resolution in y direction. " "Please also see :data:`resolution`. * *image* (*bytes*) image data, " "usable as image file content" msgstr "" #: ../../document.rst:1805 d87f3e046f2f4b23bc0807e8168812e2 msgid "a dictionary with the following keys" msgstr "以下のキーを持つ辞書" #: ../../document.rst:1807 ba7ba718761e492e8f662d09ddc95835 msgid "*ext* (*str*) image type (e.g. *'jpeg'*), usable as image file extension" msgstr "*ext* (*str*) 画像タイプ（例：*'jpeg'*）、画像ファイルの拡張子として使用可能" #: ../../document.rst:1808 9522a445d9c2447e81797f1553daa0ed msgid "*smask* (*int*) :data:`xref` number of a stencil (/SMask) image or zero" msgstr "*smask* (*int*) ステンシル（/SMask）画像の :data:`xref` 番号またはゼロ" #: ../../document.rst:1809 07061033da1b4b1888cc6d96246e3731 #, fuzzy msgid "``width`` (*int*) image width" msgstr "*width* (*int*) 画像の幅" #: ../../document.rst:1810 7a2ee3334e0b43b799cce3fa8a5067cf #, fuzzy msgid "``height`` (*int*) image height" msgstr "*height* (*int*) 画像の高さ" #: ../../document.rst:1811 674a1227dfb24764810f8a3c8e1d5115 msgid "*colorspace* (*int*) the image's *colorspace.n* number." msgstr "*colorspace* (*int*) 画像のカラースペースの数" #: ../../document.rst:1812 87b5931935934adaac549c6c0d2dae5c msgid "*cs-name* (*str*) the image's *colorspace.name*." msgstr "*cs-name* (*str*) 画像のカラースペースの名前" #: ../../document.rst:1813 d1cdc8cf4e38466bad4393a9edda8188 msgid "" "*xres* (*int*) resolution in x direction. Please also see " ":data:`resolution`." msgstr "*xres* (*int*) x 方向の解像度。:data:`resolution` も参照してください。" #: ../../document.rst:1814 41f36105a6ef458ca0d0efda56b787f7 msgid "" "*yres* (*int*) resolution in y direction. Please also see " ":data:`resolution`." msgstr "*yres* (*int*) y 方向の解像度。:data:`resolution` も参照してください。" #: ../../document.rst:1815 3b09fc2f822e4a66bcf89f5064888d20 msgid "*image* (*bytes*) image data, usable as image file content" msgstr "*image* (*bytes*) 画像データ、画像ファイルのコンテンツとして使用可能" #: ../../document.rst:1827 a2ca74b0d3fb44a6af4caf922486b13a msgid "" "There is a functional overlap with *pix = pymupdf.Pixmap(doc, xref)*, " "followed by a *pix.tobytes()*. Main differences are that extract_image, " "**(1)** does not always deliver PNG image formats, **(2)** is **very** " "much faster with non-PNG images, **(3)** usually results in much less " "disk storage for extracted images, **(4)** returns `None` in error cases " "(generates no exception). Look at the following example images within the" " same PDF." msgstr "" "*pix = pymupdf.Pixmap(doc, xref)* *に続いてpix.tobytes()* " "という機能的な重複があります。主な違いは、extract_imageは、**(1)** 必ずしもPNG画像形式を提供しない、 **(2)** " "PNG以外の画像では非常に高速である、 **(3)** 抽出された画像のディスクストレージが通常ははるかに少ない、 **(4)** " "エラーケースでは `None` を返す（例外を生成しない）という点です。同じPDF内の以下の例の画像を見てみましょう。" #: ../../document.rst:1829 ebb9a040a28642529996bc8a3d5e3341 msgid "xref 1268 is a PNG -- Comparable execution time and identical output::" msgstr "xref 1268 は PNG 形式です - 比較可能な実行時間と同じ出力::" #: ../../document.rst:1841 b4ad30db2af64226b788bc78cdbf2620 msgid "" "xref 1186 is a JPEG -- :meth:`Document.extract_image` is **many times " "faster** and produces a **much smaller** output (2.48 MB vs. 0.35 MB)::" msgstr "" "xref 1186 は JPEG です - :meth:`Document.extract_image` は " "**何倍も速く**、はるかに小さい出力を生成します（2.48 MB に対して 0.35 MB）::" #: ../../document.rst:1856 f238369b37934968ae4ada422517679c msgid "Changed in v1.19.4: return a dictionary if `named == True`." msgstr "v1.19.4 で変更: `named == True` の場合、辞書を返します。" #: ../../document.rst:1858 63b965c660cb48f599a8e3ef61279d03 msgid "" "PDF Only: Return an embedded font file's data and appropriate file " "extension. This can be used to store the font as an external file. The " "method does not throw exceptions (other than via checking for PDF and " "valid :data:`xref`)." msgstr "" "PDF のみ: " "埋め込まれたフォントファイルのデータと適切なファイル拡張子を返します。これを使用してフォントを外部ファイルとして保存することができます。このメソッドは例外をスローしません（PDF" " および有効な :data:`xref` のチェックを除く）。" #: ../../document.rst:1860 5868fff7a5c1434d8331e423b2da5b01 msgid "PDF object number of the font to extract." msgstr "抽出するフォントの PDF オブジェクト番号。" #: ../../document.rst:1861 e93cee0f89174e4bac856b0c26d404a5 msgid "" "only return font information, not the buffer. To be used for information-" "only purposes, avoids allocation of large buffer areas." msgstr "フォント情報のみを返し、バッファの割り当てを回避するために使用します。" #: ../../document.rst:1862 fa79f073e29f4634a730854470e90a80 msgid "" "If true, a dictionary with the following keys is returned: 'name' (font " "base name), 'ext' (font file extension), 'type' (font type), 'content' " "(font file content)." msgstr "" "`True` の場合、次のキーを持つ辞書が返されます： 'name'（フォントのベース名）、 'ext'（フォントファイルの拡張子）、 " "'type'（フォントのタイプ）、 'content'（フォントファイルの内容）。" #: ../../document.rst:1865 ab89baff11f24d95bf92e569980f0cfe #, fuzzy msgid "" "a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte " "suggested file extension (*str*), *basename* is the font's name (*str*), " "*type* is the font's type (e.g. \"Type1\") and *content* is a bytes " "object containing the font file's content (or *b\"\"*). For possible " "extension values and their meaning see :ref:`FontExtensions`. Return " "details on error: * `(\"\", \"\", \"\", b\"\")` -- invalid xref or xref " "is not a (valid) font object. * `(basename, \"n/a\", \"Type1\", b\"\")` " "-- *basename* is not embedded and thus cannot be extracted. This is the " "case for e.g. the :ref:`Base-14-Fonts` and Type 3 fonts." msgstr "" "`(basename, ext, type, content)` のタプルで、ext " "は3バイトの推奨ファイル拡張子（*str*）で、*basename* はフォントの名前（*str*）で、*type* " "はフォントのタイプ（例：「Type1」）で、*content* はフォントファイルの内容を含むバイトオブジェクトです（または *b\"\"* " "）。可能な拡張子の値とその意味については :ref:`FontExtensions` を参照してください。エラー時の返り値の詳細:" #: ../../document.rst:1865 3b2b1686981b408f9b4ca383fc8e0886 msgid "" "a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte " "suggested file extension (*str*), *basename* is the font's name (*str*), " "*type* is the font's type (e.g. \"Type1\") and *content* is a bytes " "object containing the font file's content (or *b\"\"*). For possible " "extension values and their meaning see :ref:`FontExtensions`. Return " "details on error:" msgstr "" "`(basename, ext, type, content)` のタプルで、ext " "は3バイトの推奨ファイル拡張子（*str*）で、*basename* はフォントの名前（*str*）で、*type* " "はフォントのタイプ（例：「Type1」）で、*content* はフォントファイルの内容を含むバイトオブジェクトです（または *b\"\"* " "）。可能な拡張子の値とその意味については :ref:`FontExtensions` を参照してください。エラー時の返り値の詳細:" #: ../../document.rst:1867 481c41a571e542b7a7aa786175062a42 msgid "" "`(\"\", \"\", \"\", b\"\")` -- invalid xref or xref is not a (valid) font" " object." msgstr "`(\"\", \"\", \"\", b\"\")` – 無効な xref または xref が（有効な）フォントオブジェクトではない場合。" #: ../../document.rst:1868 cb4b7c40a27e4f8d8952d515656acd8b msgid "" "`(basename, \"n/a\", \"Type1\", b\"\")` -- *basename* is not embedded and" " thus cannot be extracted. This is the case for e.g. the " ":ref:`Base-14-Fonts` and Type 3 fonts." msgstr "" "`(basename, \"n/a\", \"Type1\", b\"\")` – *basename* " "は埋め込まれておらず、したがって抽出できません。これは、例えば :ref:`Base-14-Fonts` フォントや Type 3 " "フォントの場合に該当します。" #: ../../document.rst:1870 41ac3a9a578a46a889335bb7b87bcaf6 msgid "Example:" msgstr "例:" #: ../../document.rst:1879 02cfca352adb406f958c62b5d22f6565 msgid "" "The basename is returned unchanged from the PDF. So it may contain " "characters (such as blanks) which may disqualify it as a filename for " "your operating system. Take appropriate action." msgstr "" "*ベースネーム* は PDF から変更されずに返されます。そのため、それには (空白などの) " "ファイル名として使用できない文字が含まれている可能性があります。適切な措置を取ってください。" #: ../../document.rst:1882 986fdf8314ca4329828c2ddb689dc2cd msgid "" "The returned *basename* in general is **not** the original file name, but" " it probably has some similarity." msgstr "通常、返される *ベースネーム* は元のファイル名ではなく、いくつかの類似性があるかもしれません。" #: ../../document.rst:1883 1a93938a9e004ef4a3f2d30cbd5711b6 msgid "" "If parameter `named == True`, a dictionary with the following keys is " "returned: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': " "b''}`." msgstr "" "`named == True` の場合、次のキーを持つ辞書が返されます: `{'name': 'T1', 'ext': 'n/a', " "'type': 'Type3', 'content': b''}`。" #: ../../document.rst:1890 bf48f5599c0b4eba92b57c5c2878337f msgid "PDF only: Return the :data:`xref` of the document's XML metadata." msgstr "PDF のみ: ドキュメントの XML メタデータの :data:`xref` を返します。" #: ../../document.rst:1899 b15d00f9e287463e9d85fb59c132c2fb msgid "" "PDF only: Check whether there are links, resp. annotations anywhere in " "the document." msgstr "PDF のみ: ドキュメント内にリンクまたは注釈が存在するかどうかを確認します。" #: ../../document.rst:1901 a8ad087d8d95460885065c1393b39d3c msgid "" "``True`` / ``False``. As opposed to fields, which are also stored in a " "central place of a PDF document, the existence of links / annotations can" " only be detected by parsing each page. These methods are tuned to do " "this efficiently and will immediately return, if the answer is ``True`` " "for a page. For PDFs with many thousand pages however, an answer may take" " some time [#f6]_ if no link, resp. no annotation is found." msgstr "" "``True`` / ``False`` 。フィールドとは異なり、リンクや注釈の存在は PDF " "ドキュメントの中心的な場所に格納されているわけではなく、各ページを解析してのみ検出できます。これらのメソッドは効率的に実行するように調整されており、ページに対して" " ``True`` の回答がある場合、すぐに返されます。ただし、多くのページを持つ PDF " "の場合、リンクや注釈が見つからない場合、回答に時間がかかることがあります [#f6]_。" #: ../../document.rst:1906 e21fcef1343540d1a708042f4c0792a7 msgid "" "PDF only: Investigate eligible fonts for their use by text in the " "document. If a font is supported and a size reduction is possible, that " "font is replaced by a version with a subset of its characters." msgstr "" "PDF のみ: " "ドキュメント内のテキストによる使用を検討するための適格なフォントを調査します。サポートされているフォントで、サイズの削減が可能な場合、そのフォントは文字のサブセットを含むバージョンで置換されます。" #: ../../document.rst:1908 09503144287d4b18848ae8923ddfa67b msgid "Use this method immediately before saving the document." msgstr "このメソッドは、ドキュメントを保存する直前に使用します" #: ../../document.rst:1910 539a01e1c805488b9294c170eac3feac msgid "" "write various progress information to sysout. This currently only has an " "effect if `fallback` is `True`." msgstr "さまざまな進行状況情報を sysout に書き込みます。現在、これは `fallback` が `True` の場合にのみ効果があります。" #: ../../document.rst:1911 8981e0208a9f4e28b42ee5f66a328834 msgid "" "if `True` use the deprecated algorithm that makes use of package " "`fontTools `_ (which hence must be " "installed). If using the recommended value `False` (default), MuPDF's " "native function is used -- which is **very much faster** and can subset a" " broader range of font types. Package fontTools is not required then." msgstr "" "`True` の場合、非推奨のアルゴリズムを使用して、パッケージ `fontTools " "`_ を使用します（従って、fontTools " "がインストールされている必要があります）。推奨される値 `False` （デフォルト）を使用すると、MuPDF " "のネイティブ関数が使用されます。これは非常に高速で、より広範なフォントタイプをサブセット化できます。この場合、パッケージ fontTools " "は必要ありません。" #: ../../document.rst:1913 a15a1047f45b4352a716896e69d6a301 msgid "" "The greatest benefit can be achieved when creating new PDFs using large " "fonts like is typical for Asian scripts. When using the :ref:`Story` " "class or method :meth:`Page.insert_htmlbox`, multiple fonts may " "automatically be included -- without the programmer becoming aware of it." msgstr "" "最大の利点は、アジアのスクリプトに典型的な大きなフォントを使用して新しい PDF を作成する場合に得られます。 :ref:`Story` " "クラスまたはメソッド :meth:`Page.insert_htmlbox` " "を使用する場合、複数のフォントが自動的に含まれる場合がありますが、プログラマーが気付かない場合もあります。" #: ../../document.rst:1915 7fadfbd8f00548ec9586225f78483b9b msgid "" "In all these cases, the set of actually used unicodes mostly is very " "small compared to the number of glyphs available in the used fonts. Using" " this method can easily reduce the embedded font binaries by two orders " "of magnitude -- from several megabytes down to a low two-digit kilobyte " "amount." msgstr "" "これらのすべての場合、実際に使用される Unicode " "のセットは、使用されるフォントの使用可能なグリフの数に比べて非常に小さいことがほとんどです。このメソッドを使用すると、埋め込まれたフォントのバイナリを容易に2桁のキロバイト量にまで減らすことができます。" #: ../../document.rst:1917 866600d061f646dbb57bf75dabe4392e msgid "" "Creating font subsets leaves behind a large number of large, now unused " "PDF objects (\"ghosts\"). Therefore, make sure to compress and garbage-" "collect when saving the file. We recommend to use " ":meth:`Document.ez_save`." msgstr "" "フォントのサブセットを作成すると、多数の大きな、今は使用されていない PDF " "オブジェクト（「ゴースト」）が残ります。そのため、ファイルを保存する際に圧縮およびガベージコレクトを行ってください。:meth:`Document.ez_save`" " の使用をお勧めします。" #: ../../document.rst:1919 024990b74b30463dbc350e966d4356da msgid "|history_begin|" msgstr "" #: ../../document.rst:1922 513bd76513be4e288a19f6b96bbaa3ef msgid "Changed in v1.18.9" msgstr "v1.18.9で変更" #: ../../document.rst:1923 c85bdf00338b456db45d324b6c867387 msgid "Changed in v1.24.2 use native function of MuPDF." msgstr "v1.24.2 で変更され、MuPDF のネイティブ機能を使用するようになりました。" #: ../../document.rst:1925 3535b4d59fd44f9a83c2e71b62145fcd msgid "|history_end|" msgstr "" #: ../../document.rst:1930 ../../document.rst:1936 ../../document.rst:1943 #: ../../document.rst:1950 ../../document.rst:1959 ../../document.rst:1966 #: ../../document.rst:1975 ../../document.rst:1982 ../../document.rst:1989 #: ../../document.rst:1998 ../../document.rst:2007 #: 23c850b632f041fc84bbedf086e50e40 29d64060d52e41a994835f8172a847b0 #: 60d9d50b61334a3683c961e3a783127f 6b69181c8a7a4cfcaa51258244099614 #: 92ffa30293174c12bdea4b8d6057552d b587c518ff2b4b239282ddc410c7020a #: bda3066db65e4117823bef6cd27678a5 bf910fcc06ee45ccb89cd50ea75979e3 #: da2ebdf8956f483cb5f692d348eb4f5e dd484398c14a4d69b0296188557677a0 #: e1bd5bb69f054b608a0564f9de3951e3 msgid "New in v1.19.0" msgstr "v1.19.0 で新規追加" #: ../../document.rst:1932 e3b3225611884f5f8a13d93a5fa8fed2 msgid "" "PDF only: Enable journalling. Use this before you start logging " "operations." msgstr "PDF のみ: ジャーナリングを有効にします。ログ操作を開始する前にこれを使用します。" #: ../../document.rst:1938 8249cad73bec4dd3811b53fedbf3851b msgid "" "PDF only: Start journalling an *\"operation\"* identified by a string " "\"name\". Updates will fail for a journal-enabled PDF, if no operation " "has been started." msgstr "" "PDF のみ: 文字列 \"name\" で識別される *\"操作\"* のジャーナリングを開始します。ジャーナリングが有効な PDF " "に対しては、操作が開始されていない場合、更新が失敗します。" #: ../../document.rst:1945 704071b7f7704603a6810cce4ef29486 msgid "" "PDF only: Stop the current operation. The updates between start and stop " "of an operation belong to the same unit of work and will be undone / " "redone together." msgstr "PDF のみ: 現在の操作を停止します。操作の開始から終了までの間の更新は、同じユニットの作業に属し、一緒に元に戻される / やり直されます。" #: ../../document.rst:1952 8856cfd27a08421e8a3a415ac03757b5 msgid "" "PDF only: Return the numbers of the current operation and the total " "operation count." msgstr "PDF のみ: 現在の操作番号と総操作数を返します。" #: ../../document.rst:1954 7aef4dabfe7f42ee8e132777108552c3 msgid "" "a tuple `(step, steps)` containing the current operation number and the " "total number of operations in the journal. If **step** is 0, we are at " "the top of the journal. If **step** equals **steps**, we are at the " "bottom. Updating the PDF with anything other than undo or redo will " "automatically remove all journal entries after the current one and the " "new update will become the new last entry in the journal. The updates " "corresponding to the removed journal entries will be permanently lost." msgstr "" "ジャーナル内の現在の操作番号と総操作数を含むタプル `(step, steps)` が返されます。**step** が 0 " "の場合、ジャーナルの先頭にいることを示します。**step** が **steps** " "と等しい場合、ジャーナルの末尾にいることを示します。undo または redo 以外の何かで PDF " "を更新すると、現在のエントリ以降のすべてのジャーナルエントリが自動的に削除され、新しい更新がジャーナルの新しい最後のエントリになります。削除されたジャーナルエントリに対応する更新は永久に失われます。" #: ../../document.rst:1961 5804540e567442e986c965d58055649e msgid "PDF only: Return the name of operation number *step.*" msgstr "PDF のみ: 操作番号 *step* の操作名を返します。" #: ../../document.rst:1968 f0a5f14026814bc0838219dad0e6c78d msgid "" "PDF only: Show whether forward (\"redo\") and / or backward (\"undo\") " "executions are possible from the current journal position." msgstr "PDF のみ: 現在のジャーナル位置から前方（\"やり直し\"）および後方（\"元に戻す\"）の実行が可能かどうかを表示します。" #: ../../document.rst:1970 5066e32c51d74905ac1aaf5bb22faf52 msgid "" "a dictionary `{\"undo\": bool, \"redo\": bool}`. The respective method is" " available if its value is `True`." msgstr "`{\"undo\": bool, \"redo\": bool}` 形式の辞書。各メソッドはその値が `True` の場合に利用可能です。" #: ../../document.rst:1977 bca8256424854422903812de1880cf69 msgid "" "PDF only: Revert (undo) the current step in the journal. This moves " "towards the journal's top." msgstr "PDF のみ: ジャーナル内の現在のステップを元に戻します（元に戻す）。これにより、ジャーナルの先頭に向かって移動します。" #: ../../document.rst:1984 c840e9624cdb422484fa864d8235880f msgid "" "PDF only: Re-apply (redo) the current step in the journal. This moves " "towards the journal's bottom." msgstr "PDF のみ：現在のステップをジャーナルのボトムに戻して再適用します。" #: ../../document.rst:1991 58b8caa5be0c42e4ad1af76dfb16eb62 msgid "PDF only: Save the journal to a file." msgstr "PDF のみ：ジャーナルをファイルに保存します。" #: ../../document.rst:1993 64c4bc40fb8f405e9953e7eb030677d4 msgid "" "either a filename as string or a file object opened as \"wb\" (or an " "`io.BytesIO()` object)." msgstr "文字列としてのファイル名または \"wb\" で開かれたファイルオブジェクト (または `io.BytesIO()` オブジェクト)。" #: ../../document.rst:2000 b77b3dcb8b40499faf7067ff14e0ac3d msgid "" "PDF only: Load journal from a file. Enables journalling for the document." " If journalling is already enabled, an exception is raised." msgstr "" "PDF " "のみ：ファイルからジャーナルを読み込みます。ドキュメントのジャーナリングを有効にします。既にジャーナリングが有効になっている場合、例外が発生します。" #: ../../document.rst:2002 4961c34dc2e34a79bc11de4657129a91 msgid "" "the filename (str) of the journal or a file object opened as \"rb\" (or " "an `io.BytesIO()` object)." msgstr "ジャーナルのファイル名 (str) または \"rb\" で開かれたファイルオブジェクト (または `io.BytesIO()` オブジェクト)。" #: ../../document.rst:2009 b7d0c0f588064a908bf9eb652ed74157 msgid "" "PDF only: Saves a \"snapshot\" of the document. This is a PDF document " "with a special, incremental-save format compatible with journalling -- " "therefore no save options are available. Saving a snapshot is not " "possible for new documents." msgstr "" "PDF のみ：ドキュメントの「スナップショット」を保存します。これは、ジャーナリングと互換性のある特別なインクリメンタルセーブ形式を持つ PDF " "ドキュメントです。そのため、セーブオプションは利用できません。新しいドキュメントにはスナップショットを保存することはできません。" #: ../../document.rst:2011 2545bccc73fa4299b3e544581d325b2d msgid "" "This is a normal PDF document with no usage restrictions whatsoever. If " "it is not being changed in any way, it can be used together with its " "journal to undo / redo operations or continue updating." msgstr "" "これは通常の PDF " "ドキュメントで、制限はありません。何も変更されていない場合、そのスナップショットはジャーナルと共に操作を元に戻したり、やり直したり、更新を続けたりするために使用できます。" #: ../../document.rst:2016 e424a27e6b2643928977f3d6aa555cb3 msgid "" "Contains the first :ref:`Outline` entry of the document (or `None`). Can " "be used as a starting point to walk through all outline items. Accessing " "this property for encrypted, not authenticated documents will raise an " "*AttributeError*." msgstr "" "ドキュメントの最初のアウトラインエントリを含みます (または " "`None`)。すべてのアウトラインアイテムを歩く出発点として使用できます。暗号化された、認証されていないドキュメントに対してこのプロパティにアクセスすると、*AttributeError*" " が発生します。" #: ../../document.rst 1602273cc936401281de518030afe066 #: 16f29bf99132426f87c8a1a3a19e00e2 28f47def4ae34ebba8d1b7ed547bef39 #: 2d1462d16cab46708c2ea82e0c12389d 3042551ff76e414a8b0fbd0249e3dbc2 #: 32ae939840b646df97a2f59c6dbbb95d 37ba5b84daea4a13bd04359c6cd8f01d #: 610be889b0ed46b6b67b919761c5328c 7198eba9028c42ab86329761fdd6189d #: 7f3d268e33dc4d32ade745103b248f42 8757f1490fa24ef3a7e6900eece671f5 #: 8c9cfec8c566490b9639225e031a57fe a081d38bf1be4385a577bfc95efe4956 #: a15d802d6d3f4b57988cd8306eb4c8ef a4df564b9c0a486e84405a39b6299935 #: b1f9eacd35de4db691b1ed0287a78333 bb8e4f6e9b2c4e09abe1a99243658dca #: c4a68e2e7f19437b8849a9ffe38fbf3b cda3e67477524036890a97e0103ac73b #: ce0880d44e354062a461cde8ea9b8ecc f50c8eac8d5b46b989ee843ce5e55e52 msgid "type" msgstr "タイプ" #: ../../document.rst:2018 09f8caef7fbd48cd82a0924621d2a9e0 msgid ":ref:`Outline`" msgstr "" #: ../../document.rst:2022 f6902ea6d7c74e0e9df77ba8f44bc184 msgid "" "``False`` if document is still open. If closed, most other attributes and" " methods will have been deleted / disabled. In addition, :ref:`Page` " "objects referring to this document (i.e. created with " ":meth:`Document.load_page`) and their dependent objects will no longer be" " usable. For reference purposes, :attr:`Document.name` still exists and " "will contain the filename of the original document (if applicable)." msgstr "" "もし文書がまだ開いている場合は ``False`` " "です。閉じた場合、他のほとんどの属性やメソッドが削除されたり無効になります。また、この文書を参照する :ref:`Page` " "オブジェクト（すなわち :meth:`Document.load_page` " "で作成されたもの）とそれに依存するオブジェクトは利用できなくなります。参照用に、:attr:`Document.name` " "はまだ存在し、元の文書のファイル名が含まれます（該当する場合）。" #: ../../document.rst:2024 ../../document.rst:2030 ../../document.rst:2036 #: ../../document.rst:2050 ../../document.rst:2058 ../../document.rst:2066 #: ../../document.rst:2104 ../../document.rst:2110 #: 0cefab557d984344bfda0158a1f52684 394c1dd8d7534572ba79ebb0cccca67f #: 66e5ea720bed4a8db1dc0ce57284dd20 7727b1750813444ba91203426800b004 #: 7e8cf3312cff4ac48dce16a36311f52a aa51fa3df40249eaa4a1e1a0d5310e13 #: d9e029f9473442ebbb79145d3e00c7d3 f2ab1deb6ba9463aaa494cc84adb11ea msgid "bool" msgstr "" #: ../../document.rst:2028 be46ed59c726495784dfc24c6c0e257d msgid "" "``True`` if this is a PDF document and contains unsaved changes, else " "``False``." msgstr "これがPDFドキュメントであり、保存されていない変更が含まれている場合は ``True`` 、それ以外は ``False`` です。" #: ../../document.rst:2034 b53c8bd571224a64808858ec1262f49c msgid "``True`` if this is a PDF document, else ``False``." msgstr "これがPDFドキュメントである場合は ``True`` 、それ以外は ``False`` です。" #: ../../document.rst:2040 5b077860c7f84173a695652fa22ede87 msgid "" "``False`` if this is not a PDF or has no form fields, otherwise the " "number of root form fields (fields with no ancestors)." msgstr "" "これがPDFでないか、フォームフィールドが含まれていない場合は ``False`` " "であり、それ以外の場合はルートフォームフィールド（祖先のないフィールド）の数です。" #: ../../document.rst:2042 c94346686fa04426a6f4827511abb382 msgid "*(Changed in v1.16.4)* Returns the total number of (root) form fields." msgstr "*（v1.16.4で変更）* （ルート）フォームフィールドの合計数を返します。" #: ../../document.rst:2044 64d2a67af100488b8d2efa6e1883d02a msgid "bool,int" msgstr "" #: ../../document.rst:2048 c2a8e91d886f4dd39afa57c9e57ace12 msgid "" "``True`` if document has a variable page layout (like e-books or HTML). " "In this case you can set the desired page dimensions during document " "creation (open) or via method :meth:`layout`." msgstr "" "文書が可変ページレイアウト（電子書籍やHTMLのような）を持つ場合は ``True`` です。この場合、文書の作成（オープン）時または " ":meth:`layout` メソッドを使用して所望のページ寸法を設定できます。" #: ../../document.rst:2054 097934b832ba49788816a0be330fcc4d msgid "New in v1.18.2" msgstr "v1.18.2で新しく追加されました。" #: ../../document.rst:2056 a3953a101b3d436c889b977615129521 msgid "" "``True`` if PDF has been repaired during open (because of major structure" " issues). Always ``False`` for non-PDF documents. If true, more details " "have been stored in `TOOLS.mupdf_warnings()`, and " ":meth:`Document.can_save_incrementally` will return ``False``." msgstr "" "PDFがオープン時に修復された場合は ``True`` です（主要な構造上の問題のため）。非PDF文書の場合は常に ``False`` " "です。``True`` の場合、詳細は `TOOLS.mupdf_warnings()` " "に保存され、:meth:`Document.can_save_incrementally` は ``False`` を返します。" #: ../../document.rst:2064 2cce725fd9f3422f8aecbdee94679aea msgid "``True`` if PDF is in linearized format. ``False`` for non-PDF documents." msgstr "PDFが直線化形式である場合は ``True`` です。非PDF文書の場合はFalseです。" #: ../../document.rst:2072 f3bed56567f343e7be019a7113151958 msgid "" "A dictionary indicating the `/MarkInfo` value. If not specified, the " "empty dictionary is returned. If not a PDF, `None` is returned." msgstr "`/MarkInfo` の値を示す辞書です。指定されていない場合、空の辞書が返されます。PDFでない場合は `None` が返されます。" #: ../../document.rst:2074 ../../document.rst:2138 #: 4fac34bbddf141cc9db4746145385918 c43c67dc2942407d8e9945f28ce574e8 msgid "dict" msgstr "" #: ../../document.rst:2080 3c2381448f9746669bed68baf5d9bb53 msgid "" "A string containing the `/PageMode` value. If not specified, the default " "\"UseNone\" is returned. If not a PDF, `None` is returned." msgstr "" "`/PageMode` の値を含む文字列です。指定されていない場合、デフォルトの「UseNone」が返されます。PDFでない場合、`None` " "が返されます。" #: ../../document.rst:2082 ../../document.rst:2090 ../../document.rst:2144 #: 3be5c37120cd4a79b8474f458308b81a 531912d21abf43ce967a311e2f37dbb5 #: 68eeac57aeee49e799a0fb10f3ff10db msgid "str" msgstr "" #: ../../document.rst:2088 94d13e47f92c425ca9ceffd8061d5b3c msgid "" "A string containing the `/PageLayout` value. If not specified, the " "default \"SinglePage\" is returned. If not a PDF, `None` is returned." msgstr "" "`/PageLayout` " "の値を含む文字列です。指定されていない場合、デフォルトの「SinglePage」が返されます。PDFでない場合、`None` が返されます。" #: ../../document.rst:2096 376302c8e2864821a4ed3203d7970057 msgid "" "An integer counting the number of versions present in the document. Zero " "if not a PDF, otherwise the number of incremental saves plus one." msgstr "ドキュメント内に存在するバージョンの数をカウントする整数です。PDFでない場合、ゼロです。それ以外の場合、増分保存の数に1を加えたものです。" #: ../../document.rst:2098 ../../document.rst:2118 ../../document.rst:2150 #: ../../document.rst:2158 ../../document.rst:2166 #: 3ccae1d5a11a4795b4cb9fbb7abb90fb 551cfa067ca747078f3544b2b9a4c75d #: 6dc1779125fa4a5e89941961eedf2852 c694fc32adcc41ba87ad799a94b4e7e4 #: e3e8e1e7807b4796bdf0baacbe43920e msgid "int" msgstr "" #: ../../document.rst:2102 15c8db41a1944a7bbc1153ac5f6933af msgid "" "Indicates whether the document is password-protected against access. This" " indicator remains unchanged -- **even after the document has been " "authenticated**. Precludes incremental saves if true." msgstr "" "ドキュメントがアクセス制限のあるパスワードで保護されているかどうかを示します。この指示は、**ドキュメントが認証された後も** 変更されません。 " "`True` の場合、増分保存が不可能です。" #: ../../document.rst:2108 cfd83d7fc9914f1ea0b309e4421dafc9 msgid "" "This indicator initially equals :attr:`Document.needs_pass`. After " "successful authentication, it is set to ``False`` to reflect the " "situation." msgstr "" "この指示は、最初に :attr:`Document.needs_pass` と等しいです。認証が成功した後、状況を反映するために " "``False`` に設定されます。" #: ../../document.rst:2114 9694db51001240f19eb22fb0d5f7c271 msgid "" "Changed in v1.16.0: This is now an integer comprised of bit indicators. " "Was a dictionary previously." msgstr "" #: ../../document.rst:2116 1db1f23f8ebc4475b568658aa43f199a msgid "" "Contains the permissions to access the document. This is an integer " "containing bool values in respective bit positions. For example, if " "*doc.permissions & pymupdf.PDF_PERM_MODIFY > 0*, you may change the " "document. See :ref:`PermissionCodes` for details." msgstr "" "アクセス許可を示します。これは、対応するビット位置にbool値を含む整数です。例えば、*doc.permissions & " "pymupdf.PDF_PERM_MODIFY > 0* " "の場合、ドキュメントを変更できます。詳細については、:ref:`PermissionCodes` を参照してください。" #: ../../document.rst:2122 7962fdc44f174396b7e69eae4e54c130 msgid "" "Contains the document's meta data as a Python dictionary or `None` (if " "*is_encrypted=True* and *needPass=True*). Keys are *format*, " "*encryption*, *title*, *author*, *subject*, *keywords*, *creator*, " "*producer*, *creationDate*, *modDate*, *trapped*. All item values are " "strings or `None`." msgstr "" "文書のメタデータをPythonの辞書形式で含んでいます。ただし、*is_encrypted=True* かつ *needPass=True* " "の場合は `None` です。キーは " "*format*、*encryption*、*title*、*author*、*subject*、*keywords*、*creator*、*producer*、*creationDate*、*modDate*、*trapped*" " です。すべてのアイテムの値は文字列または `None` です。" #: ../../document.rst:2124 6cfc801351f94f7b861f48bb410d28c7 msgid "" "Except *format* and *encryption*, for PDF documents, the key names " "correspond in an obvious way to the PDF keys */Creator*, */Producer*, " "*/CreationDate*, */ModDate*, */Title*, */Author*, */Subject*, */Trapped* " "and */Keywords* respectively." msgstr "" "*format* と *encryption* を除いて、PDF 文書の場合、キー名は明らかな方法で PDF キー " "*/Creator*、*/Producer*、*/CreationDate*、*/ModDate*、*/Title*、*/Author*、*/Subject*、*/Trapped*、*/Keywords*" " に対応しています。" #: ../../document.rst:2126 f20bf71e53de47268b103331add7edf9 msgid "*format* contains the document format (e.g. 'PDF-1.6', 'XPS', 'EPUB')." msgstr "*format* には文書のフォーマット（例： 'PDF-1.6'、'XPS'、'EPUB'）が含まれます。" #: ../../document.rst:2128 3efef9d77a4c425db7765bd868246cfe msgid "" "*encryption* either contains `None` (no encryption), or a string naming " "an encryption method (e.g. *'Standard V4 R4 128-bit RC4'*). Note that an " "encryption method may be specified **even if** *needs_pass=False*. In " "such cases not all permissions will probably have been granted. Check " ":attr:`Document.permissions` for details." msgstr "" "*encryption* には `None` （暗号化なし）または暗号化メソッドを示す文字列（例： *'Standard V4 R4 " "128-bit RC4'*） が含まれます。 *needs_pass=False* " "の場合でも暗号化メソッドが指定される場合があります。その場合、すべての権限が付与されていない可能性があります。詳細は " ":attr:`Document.permissions` を確認してください。" #: ../../document.rst:2130 9d90a31d5dc443e499dc24e80ac6a7fd msgid "" "If the date fields contain valid data (which need not be the case at " "all!), they are strings in the PDF-specific timestamp format " "\"D:\", where" msgstr "" "日付フィールドに有効なデータが含まれている場合（必ずしもそうである必要はありません！）、それらは PDF 固有のタイムスタンプ形式 " "\"D:\" の文字列です。" #: ../../document.rst:2132 20a10dd0049e479fb79845780b64734a msgid "" " is the 12 character ISO timestamp *YYYYMMDDhhmmss* (*YYYY* - year, " "*MM* - month, *DD* - day, *hh* - hour, *mm* - minute, *ss* - second), and" msgstr "" " は 12 文字の ISO タイムスタンプ YYYYMMDDhhmmss（*YYYY* - 年、*MM* - 月、*DD* - " "日、*hh* - 時、*mm* - 分、*ss* - 秒）であり、" #: ../../document.rst:2134 5da96c47c93747d58f34b49ac5ef58cd msgid "" " is a time zone value (time interval relative to GMT) containing a " "sign ('+' or '-'), the hour (*hh*), and the minute (*'mm'*, note the " "apostrophes!)." msgstr "" " は GMT に対する時刻間隔を示す符号（'+' または " "'-'）、時間（*hh*）、および分（*'mm'*、アポストロフィに注意！）を含むタイムゾーン値です。" #: ../../document.rst:2136 22d1786adac24570a27a1aae46488101 msgid "" "A Paraguayan value might hence look like *D:20150415131602-04'00'*, which" " corresponds to the timestamp April 15, 2015, at 1:16:02 pm local time " "Asuncion." msgstr "" "したがって、パラグアイの値は *D:20150415131602-04'00'* となり、これは Asuncion の現地時間で 2015 年 4" " 月 15 日午後 1 時 16 分 02 秒を表します。" #: ../../document.rst:2142 b0cf324cb8914ca695f619ae42bd9652 msgid "" "Contains the *filename* or *filetype* value with which *Document* was " "created." msgstr "*Document* が作成された *ファイル名* または *ファイルタイプ* の値を含みます。" #: ../../document.rst:2148 7f4ed0f5c41e456189313cbfc5952e49 msgid "" "Contains the number of pages of the document. May return 0 for documents " "with no pages. Function `len(doc)` will also deliver this result." msgstr "文書のページ数を含みます。ページがない文書の場合は 0 を返す場合があります。`len(doc)` 関数もこの結果を返します。" #: ../../document.rst:2154 ../../document.rst:2162 #: 73610f94f5a34127a2dda3a113913b25 c06566f44d3f4e20a91862264e4a1c99 msgid "New in v1.17.0" msgstr "v1.17.0 で新たに追加されました" #: ../../document.rst:2156 8cf8164c876c405e800d30202732e6f6 msgid "" "Contains the number of chapters in the document. Always at least 1. " "Relevant only for document types with chapter support (EPUB currently). " "Other documents will return 1." msgstr "" "文書の章の数を含みます。常に少なくとも 1 です。章のサポートがある文書タイプ（現在は EPUB のみ）にのみ関連します。その他の文書は 1 " "を返します。" #: ../../document.rst:2164 e5dfbd74ae114264bf5b918a7e215bda msgid "" "Contains (chapter, pno) of the document's last page. Relevant only for " "document types with chapter support (EPUB currently). Other documents " "will return `(0, page_count - 1)` and `(0, -1)` if it has no pages." msgstr "" "文書の最後のページの（章、pno）を含みます。章のサポートがある文書タイプ（現在は EPUB のみ）にのみ関連します。その他の文書は `(0, " "page_count - 1)` と `(0, -1)` を返します。" #: ../../document.rst:2170 6161488e20a3440a8af171ec632bfd3e msgid "" "A list of form field font names defined in the */AcroForm* object. `None`" " if not a PDF." msgstr "*/AcroForm* オブジェクトで定義されたフォームフィールドのフォント名のリストです。PDF でない場合は `None` です。" #: ../../document.rst:2172 ef0288df376442b1b18ffdc60b13aad3 msgid "list" msgstr "" #: ../../document.rst:2174 3cddcafda79b4acfa4346bad9396da59 msgid "" "For methods that change the structure of a PDF (:meth:`insert_pdf`, " ":meth:`select`, :meth:`copy_page`, :meth:`delete_page` and others), be " "aware that objects or properties in your program may have been " "invalidated or orphaned. Examples are :ref:`Page` objects and their " "children (links, annotations, widgets), variables holding old page " "counts, tables of content and the like. Remember to keep such variables " "up to date or delete orphaned objects. Also refer to " ":ref:`ReferenialIntegrity`." msgstr "" "PDFの構造を変更するメソッド " "(:meth:`insert_pdf`、:meth:`select`、:meth:`copy_page`、:meth:`delete_page` " "など）を使用する場合、プログラム内のオブジェクトやプロパティが無効化されたり孤立したりする可能性があることに注意してください。これには " ":ref:`Page` " "オブジェクトとその子要素（リンク、注釈、ウィジェット）、古いページ数を保持する変数、目次などが含まれます。このような変数を最新の情報に保つか、孤立したオブジェクトを削除することを忘れないでください。:ref:`ReferenialIntegrity`" " も参照してください。" #: ../../document.rst:2177 a2398cf6ad98476d944c903b70fee21b msgid ":meth:`set_metadata` Example" msgstr ":meth:`set_metadata` の例" #: ../../document.rst:2178 ddf7de671f964452acd94d777e10a07d msgid "" "Clear metadata information. If you do this out of privacy / data " "protection concerns, make sure you save the document as a new file with " "*garbage > 0*. Only then the old */Info* object will also be physically " "removed from the file. In this case, you may also want to clear any XML " "metadata inserted by several PDF editors:" msgstr "" "メタデータ情報をクリアします。プライバシー/データ保護の理由からこれを行う場合は、*ガベージ > 0* " "でドキュメントを新しいファイルとして保存してから古い */Info* " "オブジェクトもファイルから物理的に削除されることを確認してください。この場合、いくつかのPDFエディタによって挿入されたXMLメタデータもクリアすることを検討するかもしれません。" #: ../../document.rst:2196 642d2b67cd2f40c088b9ab627d5bcce7 msgid ":meth:`set_toc` Demonstration" msgstr ":meth:`set_toc` のデモンストレーション" #: ../../document.rst:2197 23344c44c0964dfd87e2ed6368dfe5f2 msgid "" "This shows how to modify or add a table of contents. Also have a look at " "`import.py `_ and `export.py " "`_ in the examples directory." msgstr "" "これは、目次を変更または追加する方法を示しています。また、examplesディレクトリにある `import.py " "`_ と `export.py `_ " "も参照してみてください。" #: ../../document.rst:2217 c5bd350315cb42bb9d44f2ed5f142cf7 msgid ":meth:`insert_pdf` Examples" msgstr ":meth:`insert_pdf` の例" #: ../../document.rst:2218 37f35aaa221e450b9c7923b3fb645393 msgid "**(1) Concatenate two documents including their TOCs:**" msgstr "**（1）2つの文書を連結して、それぞれの目次を含める：**" #: ../../document.rst:2230 19d9ac4c4ce54408a9ff1fc42b2ec3ab msgid "" "Obviously, similar ways can be found in more general situations. Just " "make sure that hierarchy levels in a row do not increase by more than " "one. Inserting dummy bookmarks before and after *toc2* segments would " "heal such cases. A ready-to-use GUI (wxPython) solution can be found in " "script `join.py `_ of the examples " "directory." msgstr "" "明らかに、より一般的な状況についても同様の方法が見つかるでしょう。連続するヒエラルキーレベルが1以上増加しないように注意してください。 " "**toc2** " "セグメントの前後にダミーのブックマークを挿入することで、そのような場合を修正できます。すぐに使用できるGUI（wxPython）の解決策は、examplesディレクトリのスクリプト" " `join.py `_ で見つけることができます。" #: ../../document.rst:2232 ec37bfa672424492b706bb55ae38792d msgid "**(2) More examples:**" msgstr "**（2）その他の例：**" #: ../../document.rst:2244 daa47d21176046b3b8cdcc9a15eff373 msgid "Other Examples" msgstr "他の例" #: ../../document.rst:2245 25b5f7ff173e4cbb974822ddf15bda53 msgid "**Extract all page-referenced images of a PDF into separate PNG files**::" msgstr "**PDF内のすべてのページ参照画像を個別のPNGファイルに抽出します**::" #: ../../document.rst:2260 9dcc333da1824dcb84886586cf37039d msgid "**Rotate all pages of a PDF:**" msgstr "**PDFのすべてのページを回転させます：**" #: ../../document.rst:2265 00e524b709ed425197a1390a21596acd msgid "Footnotes" msgstr "脚注" #: ../../document.rst:2266 a15a2e8120a74e39a05d411ee7c1c7d1 msgid "" "Content streams describe what (e.g. text or images) appears where and how" " on a page. PDF uses a specialized mini language similar to PostScript to" " do this (pp. 643 in :ref:`AdobeManual`), which gets interpreted when a " "page is loaded." msgstr "" "コンテンツストリームは、ページ上に何が表示され、どのように表示されるかを説明します。PDFは、ページが読み込まれると解釈される、PostScriptに似た専門のミニ言語を使用しています（:ref:`AdobeManual`" " のpp. 643）。" #: ../../document.rst:2268 ca3b618244bb41b19d1e10271e0d41c1 msgid "" "However, you **can** use :meth:`Document.get_toc` and " ":meth:`Page.get_links` (which are available for all document types) and " "copy this information over to the output PDF. See demo `convert.py " "`_." msgstr "" "ただし、:meth:`Document.get_toc` と :meth:`Page.get_links` " "（すべてのドキュメントタイプで利用可能）を使用して、この情報を出力PDFにコピーできます。デモ `convert.py " "`_ を参照してください。" #: ../../document.rst:2270 6f0e49f40f3b42b282cf974f985eacf7 msgid "" "For applicable (EPUB) document types, loading a page via its absolute " "number may result in layouting a large part of the document, before the " "page can be accessed. To avoid this performance impact, prefer chapter-" "based access. Use convenience methods and attributes " ":meth:`Document.next_location`, :meth:`Document.prev_location` and " ":attr:`Document.last_location` for maintaining a high level of coding " "efficiency." msgstr "" "該当する（EPUB）ドキュメントタイプの場合、絶対番号でページを読み込むと、ページにアクセスする前にドキュメントの大部分のレイアウトが発生する場合があります。このパフォーマンスへの影響を避けるために、章ベースのアクセスを優先します。:meth:`Document.prev_location`、:attr:`Document.last_location`、:attr:`Document.last_location`" " といった便利なメソッドや属性を使用して、高いコーディング効率を維持してください。" #: ../../document.rst:2272 7e142ce80a5a4b0a88149a89bca628b3 msgid "" "These parameters cause separate handling of stream categories: use it " "together with `expand` to restrict decompression to streams other than " "images / fontfiles." msgstr "" "これらのパラメータはストリームカテゴリの別々の処理を引き起こします：これらを `expand` " "と一緒に使用して、画像やフォントファイル以外のストリームの解凍を制限できます。" #: ../../document.rst:2274 03c1d89d03c1475593eabb3e4292b9a3 msgid "Examples for \"Form XObjects\" are created by :meth:`Page.show_pdf_page`." msgstr "「Form XObjects」の例は、:meth:`Page.show_pdf_page` によって作成されます。" #: ../../document.rst:2276 7a2f02a6696b4fbe97fb5959655cf631 msgid "" "For a ``False`` the **complete document** must be scanned. Both methods " "**do not load pages,** but only scan object definitions. This makes them " "at least 10 times faster than application-level loops (where total " "response time roughly equals the time for loading all pages). For the " ":ref:`AdobeManual` (756 pages) and the Pandas documentation (over 3070 " "pages) -- both have no annotations -- the method needs about 11 ms for " "the answer ``False``. So response times will probably become significant " "only well beyond this order of magnitude." msgstr "" "``False`` の場合、完全なドキュメントをスキャンする必要があります。ただし、これらのメソッドは " "**ページを読み込まず**、オブジェクト定義のみをスキャンします。これにより、アプリケーションレベルのループよりも少なくとも10倍高速になります（合計応答時間はすべてのページを読み込む時間とほぼ同じです）。:ref:`AdobeManual`（756ページ）とPandasのドキュメンテーション（3070ページ以上）の両方に注釈がない場合、このメソッドは" " ``False`` " "の回答に約11ミリ秒かかります。したがって、応答時間はおそらくこのオーダーオブマグニチュードをはるかに超えた範囲で初めて重要になる可能性があります。" #: ../../document.rst:2278 877071710b344f2f93ce93231f4a36a5 msgid "" "This only works under certain conditions. For example, if there is normal" " text covered by some image on top of it, then this is undetectable and " "the respective text is **not** removed. Similar is true for white text on" " white background, and so on." msgstr "" "これは特定の条件下でのみ機能します。たとえば、上に何らかの画像が覆っている通常のテキストがある場合、これは検出不可能で、該当するテキストは削除 " "**されません**。同様に、白い背景の白いテキストなども同様です。" #: ../../footer.rst:46 1a755c93e67b4ba193138e8e29cfc599 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "a list of lists. Each entry has" #~ " the form *[lvl, title, page, dest]*." #~ " Its entries have the following " #~ "meanings: * *lvl* -- hierarchy level" #~ " (positive *int*). The first entry is" #~ " always 1. Entries in a row are" #~ " either **equal**, **increase** by 1, " #~ "or **decrease** by any number. * " #~ "*title* -- title (*str*) * *page* " #~ "-- 1-based page number (*int*). If " #~ "`-1` either no destination or outside" #~ " document. * *dest* -- (*dict*) " #~ "included only if *simple=False*. Contains " #~ "details of the TOC item as " #~ "follows: - kind: destination kind, " #~ "see :ref:`linkDest Kinds`. - file: " #~ "filename if kind is :data:`LINK_GOTOR` " #~ "or :data:`LINK_LAUNCH`. - page: target " #~ "page, 0-based, :data:`LINK_GOTOR` or " #~ ":data:`LINK_GOTO` only. - to: position " #~ "on target page (:ref:`Point`). - zoom:" #~ " (float) zoom factor on target page." #~ " - xref: :data:`xref` of the item" #~ " (0 if no PDF). - color: item" #~ " color in PDF RGB format `(red, " #~ "green, blue)`, or omitted (always " #~ "omitted if no PDF). - bold: true" #~ " if bold item text or omitted. " #~ "PDF only. - italic: true if " #~ "italic item text, or omitted. PDF " #~ "only. - collapse: true if sub-" #~ "items are folded, or omitted. PDF " #~ "only." #~ msgstr "" #~ msgid "Only available in PyMuPDF's \"rebased\" implementation." #~ msgstr "" #~ msgid "arg int xref" #~ msgstr "" #~ msgid "arg bool info_only" #~ msgstr "" #~ msgid "arg bool named" #~ msgstr "" #~ msgid "rtype" #~ msgstr "" #~ msgid "tuple,dict" #~ msgstr "" #~ msgid "returns" #~ msgstr "" #~ msgid "New in v1.18.7, changed in v1.18.9" #~ msgstr "v1.18.7 で新規追加、v1.18.9 で変更" #~ msgid "" #~ "Package `fontTools `_" #~ " **must be installed**. It is " #~ "required for creating the font subsets." #~ " If not installed, the method raises" #~ " an `ImportError` exception." #~ msgstr "" #~ "`fontTools `_ パッケージが" #~ " **インストールされている必要があります**。フォントサブセットの作成に必要です。インストールされていない場合、メソッドは " #~ "`ImportError` 例外を発生させます。" #~ msgid "" #~ "Supported font types only include " #~ "embedded OTF, TTF and WOFF that " #~ "are **not already subsets**." #~ msgstr "" #~ "サポートされているフォントタイプには、埋め込まれた OTF、TTF、および WOFF " #~ "のみが含まれ、**すでにサブセットであるものは含まれません** 。" #~ msgid "" #~ "**Changed in v1.18.9:** A subset font" #~ " directly replaces its original -- " #~ "text remains untouched and **is not " #~ "rewritten.** It thus should retain all" #~ " its properties, like spacing, hiddenness," #~ " control by Optional Content, etc." #~ msgstr "" #~ "**v1.18.9** で変更: サブセットフォントはその元のフォントを直接置換します - " #~ "テキストは変更されず、**書き直されません**。したがって、スペーシング、非表示、オプションのコンテンツによる制御など、すべてのプロパティが保持されるはずです。" #~ msgid "" #~ "The greatest benefit can be achieved " #~ "when creating new PDFs using large " #~ "fonts like is typical for Asian " #~ "scripts. In these cases, the set " #~ "of actually used unicodes mostly is " #~ "small compared to the number of " #~ "glyphs in the font. Using this " #~ "feature can easily reduce the embedded" #~ " font binary by two orders of " #~ "magnitude -- from several megabytes to" #~ " a low two-digit kilobyte amount." #~ msgstr "" #~ "最大の利点は、アジアの文字に典型的な大きなフォントを使用して新しい PDF " #~ "を作成する場合に得られます。このような場合、実際に使用されているユニコードのセットは、フォント内のグリフの数と比較して非常に小さいことが多いです。この機能を使用すると、埋め込まれたフォントのバイナリサイズを容易に2桁のキロバイト単位にまで削減できます" #~ " - 数メガバイトから低二桁キロバイトの量にまで。" #~ msgid "" #~ "a list of images **referenced** by " #~ "this page. Each item looks like " #~ "`(xref, smask, width, height, bpc, " #~ "colorspace, alt. colorspace, name, filter, " #~ "referencer)` Where * *:data:`xref`* " #~ "(*int*) is the image object number " #~ "* **smask** (*int*) is the object " #~ "number of its soft-mask image *" #~ " **width** and **height** (*ints*) are " #~ "the image dimensions * **bpc** (*int*)" #~ " denotes the number of bits per " #~ "component (normally 8) * **colorspace** " #~ "(*str*) a string naming the colorspace" #~ " (like **DeviceRGB**) * **alt. " #~ "colorspace** (*str*) is any alternate " #~ "colorspace depending on the value of " #~ "**colorspace** * **name** (*str*) is " #~ "the symbolic name by which the " #~ "image is referenced * **filter** " #~ "(*str*) is the decode filter of " #~ "the image (:ref:`AdobeManual`, pp. 22). " #~ "* **referencer** (*int*) the :data:`xref` " #~ "of the referencer. Zero if directly " #~ "referenced by the page. Only present " #~ "if *full=True*." #~ msgstr "" #~ msgid "" #~ "`(xref, smask, width, height, bpc, " #~ "colorspace, alt. colorspace, name, filter, " #~ "referencer)`" #~ msgstr "" #~ msgid "**width** and **height** (*ints*) are the image dimensions" #~ msgstr "**width** と **height** （*int*）は画像の寸法です" #~ msgid "arg int idx: index of the item in list :meth:`Document.get_toc`." #~ msgstr "引数 int idx: :meth:`Document.get_toc` リスト内のアイテムのインデックス。" #~ msgid "" #~ "Changed in v1.19.3 - as a fix " #~ "to issue `#537 " #~ "`_, form " #~ "fields are always excluded." #~ msgstr "" #~ "v1.19.3で変更 - 問題＃ `#537 " #~ "`_ " #~ "の修正として、フォームフィールドは常に除外されます。" #~ msgid "" #~ "This is a page-based method. " #~ "Document-level information of source " #~ "documents is therefore ignored. Examples " #~ "include Optional Content, Embedded Files, " #~ "`StructureElem`, `AcroForm`, table of " #~ "contents, page labels, metadata, named " #~ "destinations (and other named entries) " #~ "and some more. As a consequence, " #~ "specifically, **Form Fields (widgets) can " #~ "never be copied** -- although they " #~ "seem to appear on pages only. Look" #~ " at :meth:`Document.bake` for converting a" #~ " source document if you need to " #~ "retain at least widget **appearances.**" #~ msgstr "" #~ "これはページベースのメソッドです。そのため、ソース文書のドキュメントレベルの情報は無視されます。例には、オプショナルコンテンツ、埋め込みファイル、" #~ " `StructureElem` 、 `AcroForm` " #~ "、目次、ページラベル、メタデータ、名前付き目的地（および他の名前付きエントリ）などがあります。その結果、具体的にはフォームフィールド（ウィジェット）はコピーできません。" #~ " - たとえそれらがページ上に表示されているように見える場合でも。ウィジェットの **外観** " #~ "を少なくとも保持する必要がある場合は、:meth:`Document.bake` をご覧ください。" #~ msgid "the created page object." #~ msgstr "作成されたページオブジェクト。" #~ msgid "" #~ "a dictionary with the following keys:" #~ " * *name* -- (*str*) name under " #~ "which this entry is stored * " #~ "*filename* -- (*str*) filename * " #~ "*ufilename* -- (*unicode*) filename * " #~ "*desc* -- (*str*) description * *size*" #~ " -- (*int*) original file size * " #~ "*length* -- (*int*) compressed file " #~ "length * *creationDate* -- *(New in " #~ "v1.18.13)* (*str*) date-time of item " #~ "creation in PDF format * *modDate* " #~ "-- *(New in v1.18.13)* (*str*) date-" #~ "time of last change in PDF format" #~ " * *collection* -- *(New in " #~ "v1.18.13)* (*int*) :data:`xref` of the " #~ "associated PDF portfolio item if any," #~ " else zero. * *checksum* -- *(New " #~ "in v1.18.13)* (*str*) a hashcode of " #~ "the stored file content as a " #~ "hexadecimal string. Should be MD5 " #~ "according to PDF specifications, but be" #~ " prepared to see other hashing " #~ "algorithms." #~ msgstr "" #~ msgid "New in v1.14.16" #~ msgstr "v1.14.16 で新規" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "Changed in v1.14.13: support `io.BytesIO` for memory documents." #~ msgstr "v1.14.13 で変更: メモリドキュメント用に `io.BytesIO` をサポート。" #~ msgid "" #~ "Changed in v1.19.6: Clearer, shorter and" #~ " more consistent exception messages. File" #~ " type \"pdf\" is always assumed if" #~ " not specified. Empty files and " #~ "memory areas will always lead to " #~ "exceptions." #~ msgstr "" #~ "v1.19.6 で変更: " #~ "より明確で短く、一貫性のある例外メッセージ。ファイルタイプが指定されていない場合、常にファイルタイプ \"pdf\" " #~ "が仮定されます。空のファイルとメモリ領域は常に例外を発生させます。" #~ msgid "" #~ "If *stream* is given, then the " #~ "document is created from memory and, " #~ "if not a PDF, either *filename* or" #~ " *filetype* must indicate its type." #~ msgstr "" #~ "*stream* が指定されている場合、ドキュメントはメモリから作成され、PDF でない場合は " #~ "*filename* または *filetype* のいずれかがそのタイプを示さなければなりません。" #~ msgid "" #~ "A UTF-8 string or *pathlib* object " #~ "containing a file path. The document " #~ "type is inferred from the filename " #~ "extension. If not present or not " #~ "matching :ref:`a supported " #~ "type`, a PDF document is" #~ " assumed. For memory documents, this " #~ "argument may be used instead of " #~ "`filetype`, see below." #~ msgstr "" #~ "ファイルパスを含む UTF-8 文字列または *pathlib* " #~ "オブジェクト。ドキュメントのタイプはファイル名の拡張子から推測されます。存在しないか、:ref:`サポートされてい`" #~ " ないタイプに一致しない場合、PDF ドキュメントが仮定されます。メモリドキュメントの場合、`filetype` " #~ "の代わりにこの引数を使用できます。詳細は以下を参照してください。" #~ msgid "" #~ "A memory area containing a supported " #~ "document. If not a PDF, its type" #~ " **must** be specified by either " #~ "`filename` or `filetype`." #~ msgstr "" #~ "(bytes, bytearray, BytesIO) - " #~ ":ref:`サポートされている` ドキュメントを含むメモリ領域。PDF " #~ "でない場合、そのタイプは `filename` または `filetype` " #~ "のいずれかによって指定 **しなければなりません** 。" #~ msgid "" #~ "A string specifying the type of " #~ "document. This may be anything looking" #~ " like a filename (e.g. \"x.pdf\"), in" #~ " which case MuPDF uses the extension" #~ " to determine the type, or a " #~ "mime type like *application/pdf*. Just " #~ "using strings like \"pdf\" or \".pdf\"" #~ " will also work. May be omitted " #~ "for PDF documents, otherwise must match" #~ " :ref:`a supported document " #~ "type`." #~ msgstr "" #~ "ドキュメントのタイプを指定する文字列。ファイル名のように見えるもの（例: " #~ "\"x.pdf\"）である必要があります。この場合、MuPDF " #~ "は拡張子を使用してタイプを判断します。*application/pdf* のような mime " #~ "タイプも使用できます。単に \"pdf\" または \".pdf\" " #~ "のような文字列を使用することもできます。PDF ドキュメントの場合、省略可能であり、それ以外の場合は " #~ ":ref:`サポートされている` ドキュメントタイプに一致しなければなりません。" #~ msgid "" #~ "Not all document types are checked " #~ "for valid formats already at open " #~ "time. Raster images for example will " #~ "raise exceptions only later, when trying" #~ " to access the content. Other types" #~ " (notably with non-binary content) " #~ "may also be opened (and sometimes " #~ "**accessed**) successfully -- sometimes even" #~ " when having invalid content for the" #~ " format:" #~ msgstr "" #~ "すべてのドキュメントタイプがオープン時に有効なフォーマットで確認されるわけではありません。例えば、ラスター画像はコンテンツにアクセスしようとした際に例外を発生させることがあります。他のタイプ（特にバイナリでないコンテンツを持つもの）は、有効なコンテンツを持たない場合でも成功してオープンされ（そして時に" #~ " **アクセスされる** こともあります）：" #~ msgid "" #~ "HTM, HTML, XHTML: **always** opened, " #~ "`metadata[\"format\"]` is \"HTML5\", resp. " #~ "\"XHTML\"." #~ msgstr "" #~ "HTM、HTML、XHTML: **常に** オープンされ、 " #~ "`metadata[\"format\"]` は \"HTML5\" または " #~ "\"XHTML\" です。" #~ msgid "" #~ "XML, FB2: **always** opened, " #~ "`metadata[\"format\"]` is \"FictionBook2\"." #~ msgstr "XML、FB2: **常に** オープンされ、 `metadata[\"format\"]` は \"FictionBook2\" です。" #~ msgid "" #~ "PDF only: Change the color component " #~ "counts for all object types text, " #~ "image and vector graphics for all " #~ "pages." #~ msgstr "" #~ msgid "" #~ "a list of images **referenced** by " #~ "this page. Each item looks like " #~ "`(xref, smask, width, height, bpc, " #~ "colorspace, alt_colorspace, name, filter, " #~ "referencer)` Where * *:data:`xref`* " #~ "(*int*) is the image object number " #~ "* **smask** (*int*) is the object " #~ "number of its soft-mask image *" #~ " **width** (*int*) is the image width" #~ " * **height** (*int*) is the image" #~ " height * **bpc** (*int*) denotes " #~ "the number of bits per component " #~ "(normally 8) * **colorspace** (*str*) " #~ "a string naming the colorspace (like " #~ "**DeviceRGB**) * **alt_colorspace** (*str*) " #~ "is any alternate colorspace depending on" #~ " the value of **colorspace** * " #~ "**name** (*str*) is the symbolic name" #~ " by which the image is referenced" #~ " * **filter** (*str*) is the decode" #~ " filter of the image (:ref:`AdobeManual`," #~ " pp. 22). * **referencer** (*int*) " #~ "the :data:`xref` of the referencer. Zero" #~ " if directly referenced by the page." #~ " Only present if *full=True*." #~ msgstr "" #~ msgid "Where" #~ msgstr "ここで" #~ msgid "**(xref, ext, type, basefont, name, encoding, referencer)**," #~ msgstr "" #~ msgid "where" #~ msgstr "ここで" #~ msgid "" #~ "page number (0-based) **in front of " #~ "which** to insert. Must be in " #~ "`range(-1, doc.page_count + 1)`. Special " #~ "values -1 and `doc.page_count` insert " #~ "**after** the last page. Changed in " #~ "v1.14.12 This is now a positional " #~ "parameter" #~ msgstr "" #~ msgid "" #~ "a dictionary with the following keys" #~ " * *ext* (*str*) image type (e.g." #~ " *'jpeg'*), usable as image file " #~ "extension * *smask* (*int*) :data:`xref` " #~ "number of a stencil (/SMask) image " #~ "or zero * *width* (*int*) image " #~ "width * *height* (*int*) image height" #~ " * *colorspace* (*int*) the image's " #~ "*colorspace.n* number. * *cs-name* " #~ "(*str*) the image's *colorspace.name*. * " #~ "*xres* (*int*) resolution in x " #~ "direction. Please also see :data:`resolution`." #~ " * *yres* (*int*) resolution in y " #~ "direction. Please also see :data:`resolution`." #~ " * *image* (*bytes*) image data, " #~ "usable as image file content" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/faq.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 fc37bbaea9e645f2a1934950c4d360aa msgid "Artifex" msgstr "" #: ../../header.rst:-1 3e2f00868cab4dc9b3f9c47206f4e0e1 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 dc5cbb9888564cd2904f297d4612db6a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../faq.rst:7 34a4b295156e4a8b80a33df4e0d989fe msgid "FAQ" msgstr "" #: ../../faq.rst:9 42099b86e20e4e99a1843a506f01916e msgid "A collection of recipes in “How-To” format for using PyMuPDF." msgstr "" #: ../../faq.rst:12 b75419af6b7a47d9900bf518ab5e1ad3 msgid "Please see:" msgstr "" #: ../../faq.rst:14 478d3b75ae384ae8b14fb10fdd9b39fc msgid ":ref:`Recipes: Table of Contents`" msgstr "" #: ../../footer.rst:60 ebceb100878042a6ade4b6d7432a599e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/font.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 e188dde9abe149bc8995bf7a6a0bc7d6 msgid "Artifex" msgstr "" #: ../../header.rst:-1 3cb714fa525c44bbbbd491bc8f62336e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 c23c7d47fe3e429dbde810adabc353b6 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../font.rst:7 d2748ea1ae9940f6b22b259ae4533e13 msgid "Font" msgstr "Font (フォント)" #: ../../font.rst:9 3bf53a70d692484eaabd5afc3aab44c8 msgid "New in v1.16.18" msgstr "新機能：v1.16.18" #: ../../font.rst:11 4c18f6c0f2b6494fbf226048ecce0907 msgid "" "This class represents a font as defined in |MuPDF| (``fz_font_s`` " "structure). It is required for the new class :ref:`TextWriter` and the " "new :meth:`Page.write_text`. Currently, it has no connection to how fonts" " are used in methods :meth:`Page.insert_text` or " ":meth:`Page.insert_textbox`, respectively." msgstr "" "このクラスは、|MuPDF| で定義されたフォント（ ``fz_font_s`` 構造体）を表します。これは、新しいクラス " ":ref:`TextWriter` と新しい :meth:`Page.write_text` " "に必要であり、現在、:meth:`Page.insert_text` または :meth:`Page.insert_textbox` " "メソッドでフォントがどのように使用されているかとは関係ありません。" #: ../../font.rst:13 2125868871f645fb9fa0d4390f116a1a msgid "" "A ``Font`` object also contains useful general information, like the font" " bbox, the number of defined glyphs, glyph names or the ``bbox`` of a " "single glyph." msgstr "" "``Font`` オブジェクトには、フォント ``bbox`` 、定義済みグリフの数、グリフ名、単一グリフの ``bbox`` " "など、有用な一般情報も含まれています。" #: ../../font.rst:17 842b44a70bf34b07ac2692aa84a193da msgid "**Method / Attribute**" msgstr "**メソッド/属性** " #: ../../font.rst:17 f69a466cefe443c3855949e5cc5ffcd6 msgid "**Short Description**" msgstr "**短い説明** " #: ../../font.rst:19 1bba986439da408a84c24de22da3768d msgid ":meth:`~Font.glyph_advance`" msgstr "" #: ../../font.rst:19 627a6c4218dd4762ae098709cdb920ad msgid "Width of a character" msgstr "文字の幅" #: ../../font.rst:20 6ca041bd76a54c949510e2ed77ca58f0 msgid ":meth:`~Font.glyph_bbox`" msgstr "" #: ../../font.rst:20 d9fb542d691c44a19873b891f02b7812 msgid "Glyph rectangle" msgstr "グリフの矩形" #: ../../font.rst:21 e7791392edbd4e5d9094df1b320d2c5b msgid ":meth:`~Font.glyph_name_to_unicode`" msgstr "" #: ../../font.rst:21 13f06c680aba44698114079c036bcdba msgid "Get unicode from glyph name" msgstr "グリフ名からUnicodeを取得" #: ../../font.rst:22 c04368ada6c341f093c2f4872cd5cd52 msgid ":meth:`~Font.has_glyph`" msgstr "" #: ../../font.rst:22 689634c88d144bef9223b78f39009eda msgid "Return glyph id of unicode" msgstr "UnicodeのグリフIDを返す" #: ../../font.rst:23 a369a0e87b4340168dce9cd130684d3c msgid ":meth:`~Font.text_length`" msgstr "" #: ../../font.rst:23 f20e22d5c6534f99a10aad9ab98d9ae3 msgid "Compute string length" msgstr "文字列の長さを計算" #: ../../font.rst:24 d46c723021014de19f30cce31dd6fa83 msgid ":meth:`~Font.char_lengths`" msgstr "" #: ../../font.rst:24 2c939c616c2a45d19cef1d2e9148c5f8 msgid "Tuple of char widths of a string" msgstr "文字列の文字幅のタプル" #: ../../font.rst:25 30fcbf0fac8c4137ac05697051b7a487 msgid ":meth:`~Font.unicode_to_glyph_name`" msgstr "" #: ../../font.rst:25 96a805868d65421593f69cabcbdff444 msgid "Get glyph name of a unicode" msgstr "Unicodeのグリフ名を取得" #: ../../font.rst:26 556560ade52f45878ccd9247ed48b124 msgid ":meth:`~Font.valid_codepoints`" msgstr "" #: ../../font.rst:26 f98352016c9a420597ecdc2d4da47bcd msgid "Array of supported unicodes" msgstr "サポートされているUnicodeの配列" #: ../../font.rst:27 8046f6ca0658408896ffec620e7c19d2 msgid ":attr:`~Font.ascender`" msgstr "" #: ../../font.rst:27 bdef6c925fd24cd6a8bd423203561e10 msgid "Font ascender" msgstr "フォントのアセンダ" #: ../../font.rst:28 b9972b7d50024c5f92aae461b95e9b9d msgid ":attr:`~Font.descender`" msgstr "" #: ../../font.rst:28 333b36880ce240299a20b8d485071b31 msgid "Font descender" msgstr "フォントのディセンダ" #: ../../font.rst:29 1ca68d63143c41ae9afaf82231bb0b98 msgid ":attr:`~Font.bbox`" msgstr "" #: ../../font.rst:29 88947fe258eb49d5a4bcd7f9262d6f64 msgid "Font rectangle" msgstr "フォントの矩形" #: ../../font.rst:30 70204c08ad4f48bfb90c610ace5e2f16 msgid ":attr:`~Font.buffer`" msgstr "" #: ../../font.rst:30 d8dc88a830a143b69cf9198d43a1d8be msgid "Copy of the font's binary image" msgstr "フォントのバイナリイメージのコピー" #: ../../font.rst:31 087ab4d9b8c245329f433d0e0bc1dae2 msgid ":attr:`~Font.flags`" msgstr "" #: ../../font.rst:31 b08397d234cf4d828c277f81b7e5797c msgid "Collection of font properties" msgstr "フォントのプロパティのコレクション" #: ../../font.rst:32 1b9e053341ba4bf29f37614365fca44e msgid ":attr:`~Font.glyph_count`" msgstr "" #: ../../font.rst:32 9266fb9484fe42618bd4b861302ec139 msgid "Number of supported glyphs" msgstr "サポートされているグリフの数" #: ../../font.rst:33 a1a23dee533f4eb9a0253e7ed4dc2160 msgid ":attr:`~Font.name`" msgstr "" #: ../../font.rst:33 f7c44ea05506418686745a0a8b4ccf1e msgid "Name of font" msgstr "フォントの名前" #: ../../font.rst:34 4d8600344c934dca966561b9b23705a3 msgid ":attr:`~Font.is_bold`" msgstr "" #: ../../font.rst:34 42bd831f9b604a58adec9428f2799d4a msgid "`True` if bold" msgstr "" #: ../../font.rst:35 4fd252e5611e4f25ad7279f120909cc1 msgid ":attr:`~Font.is_monospaced`" msgstr "" #: ../../font.rst:35 53567d475247479ebe27771a05253749 msgid "`True` if mono-spaced" msgstr "" #: ../../font.rst:36 386c083d80e24cd8889a76d1ed0d655e msgid ":attr:`~Font.is_serif`" msgstr "" #: ../../font.rst:36 dc515a68d8984513880dd9652137056b msgid "`True` if serif, `False` if sans-serif" msgstr "" #: ../../font.rst:37 ef38964ab5634a4a8afc1a4043834bcb msgid ":attr:`~Font.is_italic`" msgstr "" #: ../../font.rst:37 6ab8b6017630445e8a8d73bd87250888 msgid "`True` if italic" msgstr "" #: ../../font.rst:41 ef6bc7e0d9cf42848d2ea5ec97cad0e8 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../font.rst:60 07b4413b01ae4ae89132a4d69299fcff msgid "" "Font constructor. The large number of parameters are used to locate font," " which most closely resembles the requirements. Not all parameters are " "ever required -- see the below pseudo code explaining the logic how the " "parameters are evaluated." msgstr "" "フォントコンストラクタ。多くのパラメータは、要件に最も近いフォントを特定するために使用されます。必ずしもすべてのパラメータが必要とされるわけではありません" " - パラメータが評価されるロジックを説明する以下の疑似コードを参照してください。" #: ../../font.rst 51829dd751b848658d1ba228b94ce1de #: 6865a3bfb8444b439d877a9d8a59cb0a 722fbb72278d4e3e8bb0df13f398859a #: 8cbc7148711c4ee9a078b6a806370c78 a100d7e7206946cda8a733ebb3f80137 #: c931f89accb14562827a19ea990df0aa f0f58970e4794ad2b4f9ab161b976692 #: f42510c818544c6180a85f87a852dd28 msgid "Parameters" msgstr "パラメータ" #: ../../font.rst:62 b7c66967af094eed88e4cd0bfa9c0b59 msgid "" "one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a " "select few other names like (watch the correct spelling): \"Arial\", " "\"Times\", \"Times Roman\". *(Changed in v1.17.5)* If you have " "installed `pymupdf-fonts `_, " "there are also new \"reserved\" fontnames available, which are listed in " ":attr:`fitz_fonts` and in the table further down." msgstr "" #: ../../font.rst:62 4f54e9a21f4e4cdd94eb896e84a11207 msgid "" "one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a " "select few other names like (watch the correct spelling): \"Arial\", " "\"Times\", \"Times Roman\"." msgstr "" ":ref:`Base-14-Fonts` またはCJKフォントの名前のいずれか。また、\"Arial\"、\"Times\"、\"Times " "Roman\"などの選択的な名前も可能です。" #: ../../font.rst:64 33128ec921644adcb669eed87f58d1ad msgid "*(Changed in v1.17.5)*" msgstr "(v1.17.5で変更)" #: ../../font.rst:66 2580ac163f6d40a6a97df2667e044b70 msgid "" "If you have installed `pymupdf-fonts `_, there are also new \"reserved\" fontnames available, which are" " listed in :attr:`fitz_fonts` and in the table further down." msgstr "" "`pymupdf-fonts `_ " "をインストールしている場合、:attr:`fitz_fonts` と下の表でリストされている新しい「予約済み」フォント名も利用可能です。" #: ../../font.rst:68 0115b8805a994350b1e9b88652d9c671 msgid "the filename of a fontfile somewhere on your system [#f1]_." msgstr "システムのどこかにあるフォントファイルのファイル名 [#f1]_。" #: ../../font.rst:69 855671c475ce4d4a95574d50da436fa8 msgid "a fontfile loaded in memory [#f1]_." msgstr "メモリ内にロードされたフォントファイル [#f1]_。" #: ../../font.rst:70 b4cd7e175eb14d658f5faa379b3ef701 msgid "" "the number of a UCDN script. Currently supported in PyMuPDF are numbers " "24, and 32 through 35." msgstr "" "UCDN（Unicode Character Database " "Number）のスクリプト番号です。現在、PyMuPDFでサポートされている番号は、24、および32から35です。" #: ../../font.rst:71 d5a5fc15ea7c4e1b8d26964a61b402e8 msgid "" "one of the values \"zh-Hant\" (traditional Chinese), \"zh-Hans\" " "(simplified Chinese), \"ja\" (Japanese) and \"ko\" (Korean). Otherwise, " "all ISO 639 codes from the subsets 1, 2, 3 and 5 are also possible, but " "are currently documentary only." msgstr "UCDNスクリプトの番号。現在、PyMuPDFでサポートされているのは24、および32から35の数値です" #: ../../font.rst:72 5b0e786be58c4a09a48eacc61882197e msgid "an alternative selector for one of the CJK fonts." msgstr "CJKフォントの選択のための代替セレクタ。" #: ../../font.rst:73 6af1f2fb252e4071bab746f2ad57c01d msgid "look for a bold font." msgstr "太字のフォントを探します。" #: ../../font.rst:74 6f2bffef2aa94c92b00fa9cf6d97a283 msgid "look for an italic font." msgstr "イタリック体のフォントを探します。" #: ../../font.rst:75 23ca0f2751ed4b2f834236f7e744dd36 msgid "look for a serifed font." msgstr "セリフ付きのフォントを探します。" #: ../../font.rst 1d22b29a05e741f387368f96870d4c1b #: 1e8b6f0bc4da4c4db71fcd4ce33f7f4d 1ebfff0006a54633b2e48a4cf728c55b #: 3126e087ce6d47cbb326a10281420878 3aaf4a67eaa8475e97bebd3b14716268 #: 3b8e58b5a2034fddbba0b9f34d785351 425ebf256d4842928912c98469178b2e #: 455992af6eea4168919f71ca6e0a63e9 7512b5e1267b491c80d9886fcb846c91 msgid "Returns" msgstr "戻り値" #: ../../font.rst:77 d564d7e503224782b914ea4c4d4bd55b msgid "" "a |MuPDF| font if successful. This is the overall sequence of checks to " "determine an appropriate font: =========== " "============================================================ Argument " "Action =========== " "============================================================ fontfile? " "Create font from file, exception if failure. fontbuffer? Create font from" " buffer, exception if failure. ordering>=0 Create universal font, always " "succeeds. fontname? Create a Base-14 font, universal font, or font" " provided by `pymupdf-fonts `_. See table below. =========== " "============================================================" msgstr "" #: ../../font.rst:77 cea38fccea5241229aadba228571f8be msgid "" "a |MuPDF| font if successful. This is the overall sequence of checks to " "determine an appropriate font:" msgstr "成功した場合は |MuPDF| フォント。適切なフォントを特定するための全体のチェックのシーケンスは次のとおりです。" #: ../../font.rst:80 580ec24b97e749299e613764ef3403c6 msgid "Argument" msgstr "引数" #: ../../font.rst:80 c41ca6b5584649b586f676f06f22549b msgid "Action" msgstr "アクション" #: ../../font.rst:82 98333181f4584c9c8bca13c85c415262 msgid "fontfile?" msgstr "" #: ../../font.rst:82 73d6da924f634bc7b6e4fe044072fe6d msgid "Create font from file, exception if failure." msgstr "ファイルからフォントを作成し、失敗した場合は例外をスローします。" #: ../../font.rst:83 130073b0bea44ffc890479cdb5f5340d msgid "fontbuffer?" msgstr "" #: ../../font.rst:83 a74986c74e6843eea78fcc35d447c3a2 msgid "Create font from buffer, exception if failure." msgstr "バッファからフォントを作成し、失敗した場合は例外をスローします。" #: ../../font.rst:84 29919d8588f5493dafda4cfe7f0555b1 msgid "ordering>=0" msgstr "" #: ../../font.rst:84 3f0b6b784f1742238213e67a82078abf msgid "Create universal font, always succeeds." msgstr "ユニバーサルフォントを作成し、常に成功します。" #: ../../font.rst:85 fe70636ee76b429da54199e913507119 msgid "fontname?" msgstr "" #: ../../font.rst:85 a411aeb787b5416f854bb729f143e0b6 msgid "" "Create a Base-14 font, universal font, or font provided by `pymupdf-fonts" " `_. See table below." msgstr "" "ベース14フォント、ユニバーサルフォント、または `pymupdf-fonts `_ で提供されるフォントを作成します。下の表を参照してください。" #: ../../font.rst:92 d6d370d9961e418c8c6a25a191d46651 msgid "" "With the usual reserved names \"helv\", \"tiro\", etc., you will create " "fonts with the expected names \"Helvetica\", \"Times-Roman\" and so on. " "**However**, and in contrast to :meth:`Page.insert_font` and friends," msgstr "" "通常の予約済みの名前「helv」、「tiro」などを使用すると、期待どおりの名前「Helvetica」、「Times-" "Roman」などのフォントが作成されます。**ただし** 、:meth:`Page.insert_font` などとは異なり、" #: ../../font.rst:94 31fed8debc7c42ca9166ee0b1ef74c98 msgid "a font file will **always** be embedded in your PDF," msgstr "フォントファイルはPDFに **常に** 埋め込まれます。" #: ../../font.rst:95 9b3d8892b4424474889b2416ef13836b msgid "" "Greek and Cyrillic characters are supported without needing the " "*encoding* parameter." msgstr "ギリシャ文字およびキリル文字は *エンコーディング* パラメータを必要とせずにサポートされます。" #: ../../font.rst:97 c07988cc48644ac8846d43cf555ae595 msgid "" "Using *ordering >= 0*, or fontnames \"cjk\", \"china-t\", \"china-s\", " "\"japan\" or \"korea\" will **always create the same \"universal\"** font" " **\"Droid Sans Fallback Regular\"**. This font supports **all Chinese, " "Japanese, Korean and Latin characters**, including Greek and Cyrillic. " "This is a sans-serif font." msgstr "" "ordering >= " "0を使用するか、フォント名「cjk」、「china-t」、「china-s」、「japan」、「korea」を使用すると、**常に同じ「汎用」**" " フォント **「Droid Sans Fallback " "Regular」が作成されます**。このフォントは、**中国語、日本語、韓国語、ラテン文字、ギリシャ文字、キリル文字を含むすべての文字をサポートしています**。これはサンセリフのフォントです。" #: ../../font.rst:99 6db4519008e44ee682c2a27e4d316f4b msgid "" "Actually, you would rarely ever need another sans-serif font than " "**\"Droid Sans Fallback Regular\"**. **Except** that this font file is " "relatively large and adds about 1.65 MB (compressed) to your PDF file " "size. If you do not need CJK support, stick with specifying \"helv\", " "\"tiro\" etc., and you will get away with about 35 KB compressed." msgstr "" "実際、通常、「Droid Sans Fallback " "Regular」以外のサンセリフのフォントはほとんど必要ありません。ただし、このフォントファイルは比較的大きく、PDFファイルサイズを約1.65 " "MB（圧縮）増加させます。CJKのサポートが必要でない場合は、「helv」、「tiro」などを指定し、約35 KB（圧縮）で済むでしょう。" #: ../../font.rst:101 79c699cd0e0a44828e95752e5f6f2ebe msgid "" "If you **know** you have a mixture of CJK and Latin text, consider just " "using `Font(\"cjk\")` because this supports everything and also " "significantly (by a factor of up to three) speeds up execution: MuPDF " "will always find any character in this single font and never needs to " "check fallbacks." msgstr "" "CJKとラテン文字の混合テキストがあることを **知っている** 場合は、単に `Font(\"cjk\")` " "を使用して、すべてをサポートし、実行を大幅に高速化します（最大3倍）。MuPDFは常にこの単一のフォントで任意の文字を見つけることができ、フォールバックをチェックする必要はありません。" #: ../../font.rst:103 71613c830de34e6f9ecdf39faec59a38 msgid "" "But if you do use some other font, you will still automatically be able " "to also write CJK characters: MuPDF detects this situation and silently " "falls back to the universal font (which will then of course also be " "embedded in your PDF)." msgstr "ただし、他のフォントを使用する場合、CJK文字を書き込むことも自動的にできるようになります。MuPDFはこの状況を検出し、静かにユニバーサルフォントにフォールバックします（その場合、当然、PDFにも埋め込まれます）。" #: ../../font.rst:105 f904db70b3d246e1b10894809cb39326 msgid "" "*(New in v1.17.5)* Optionally, some new \"reserved\" fontname codes " "become available if you install `pymupdf-fonts `_, `pip install pymupdf-fonts`. **\"Fira Mono\"** is a " "mono-spaced sans font set and **FiraGO** is another non-serifed " "\"universal\" font set which supports all Latin (including Cyrillic and " "Greek) plus Thai, Arabian, Hewbrew and Devanagari -- but none of the CJK " "languages. The size of a FiraGO font is only a quarter of the \"Droid " "Sans Fallback\" size (compressed 400 KB vs. 1.65 MB) -- **and** it " "provides the weights bold, italic, bold-italic -- which the universal " "font doesn't." msgstr "" "*（v1.17.5で新登場）* オプションで、`pymupdf-fonts `_ をインストールすると、いくつかの新しい「予約済み」フォント名コードが利用可能になります。 **\"Fira Mono\"** " "は等幅のサンセリフフォントセットで、**FiraGO** " "はラテン文字（キリル文字とギリシャ文字を含む）およびタイ語、アラビア語、ヘブライ語、デーバナガリ語をサポートする別のサンセリフの「ユニバーサル」フォントセットですが、CJK言語はサポートしていません。" " FiraGOフォントのサイズは「Droid Sans Fallback」のサイズの1/4だけです（圧縮400 KB対1.65 MB） " "**そして** 、ユニバーサルフォントにはない太字、イタリック、太字イタリックのウェイトを提供しています。" #: ../../font.rst:107 51115005ef5b45048d055b7507f8bde1 msgid "" "**\"Space Mono\"** is another nice and small mono-spaced font from Google" " Fonts, which supports Latin Extended characters and comes with all 4 " "important weights." msgstr "" "**\"Space Mono\"** " "はGoogleフォントからのもう1つの素敵で小さな等幅フォントで、ラテン拡張文字をサポートし、すべての4つの重要なウェイトが含まれています。" #: ../../font.rst:109 96727739a91940c6a331ed087081f309 msgid "" "The following table maps a fontname code to the corresponding font. For " "the current content of the package please see its documentation:" msgstr "次の表は、フォント名コードを対応するフォントにマッピングしています。パッケージの現在の内容については、そのドキュメンテーションを参照してください：" #: ../../font.rst:112 1a8503b417cf4c8fada552e8610a6e75 msgid "Code" msgstr "コード" #: ../../font.rst:112 2d8f3f6732334560b3d503193be52bed msgid "Fontname" msgstr "フォント名" #: ../../font.rst:112 c74b2b12e6aa454b8f2dbb4143ffd7bf msgid "New in" msgstr "バージョン" #: ../../font.rst:112 09250ac84f2f444481bee3de0bd29007 msgid "Comment" msgstr "コメント" #: ../../font.rst:114 3092d884950f4b6eb710a9de0dd03966 msgid "figo" msgstr "" #: ../../font.rst:114 660c171a6c564814aecb4286056ec31a msgid "FiraGO Regular" msgstr "FiraGO レギュラー" #: ../../font.rst:114 ../../font.rst:115 ../../font.rst:116 ../../font.rst:117 #: ../../font.rst:118 ../../font.rst:119 3e80c8fdb0dd48d780069b2449ee507f #: 410d087d7e1243d1a54c1ae0aab172ac 6f27e46024f84abd97777e835ae6517f #: 794afaec71784e91b7e817f22ead4ffe baa94f214aea4d77a1a5fad071d449f1 #: ed541c0c11684da3bebb342489caa3cb msgid "v1.0.0" msgstr "" #: ../../font.rst:114 aababde120ff4dbcbe21832121ff155b msgid "narrower than Helvetica" msgstr "Helveticaよりも狭い" #: ../../font.rst:115 01a9c98efef34d0aba6ba3fa0d37813b msgid "figbo" msgstr "" #: ../../font.rst:115 b83719e8b5724cd69e516c29b9367ebb msgid "FiraGO Bold" msgstr "FiraGO ボールド" #: ../../font.rst:116 4bbe563434c7425796dc77766d23c9c8 msgid "figit" msgstr "" #: ../../font.rst:116 480523c94e564e26be18e84adb38e861 msgid "FiraGO Italic" msgstr "FiraGO イタリック" #: ../../font.rst:117 1e31c41d5df44c4fb09a83fdbd89e06d msgid "figbi" msgstr "" #: ../../font.rst:117 0e71b818d3cd4256a6f49c7416f6b1ca msgid "FiraGO Bold Italic" msgstr "FiraGO ボールドイタリック" #: ../../font.rst:118 7137d532bea243b482a7189e3a3286f8 msgid "fimo" msgstr "" #: ../../font.rst:118 d52c3785bf6c4c6c9fa414b6953b3c21 msgid "Fira Mono Regular" msgstr "Fira Mono レギュラー" #: ../../font.rst:119 a6bb6a057367406e8c6451c50221bd10 msgid "fimbo" msgstr "" #: ../../font.rst:119 a9be831c53d643c381182387817e7347 msgid "Fira Mono Bold" msgstr "Fira Mono ボールド" #: ../../font.rst:120 2ff90048652c45d8ad808bd8e873a930 msgid "spacemo" msgstr "" #: ../../font.rst:120 10b17a9bdac441b2a4af57265d22e503 msgid "Space Mono Regular" msgstr "Space Mono レギュラー" #: ../../font.rst:120 ../../font.rst:121 ../../font.rst:122 ../../font.rst:123 #: 71f76d3cde6b47a3b8a7a0a571913454 74e5c245413f43a1b0bcd54884d11f9b #: 811a2ce8ecf443c3b7c4a0009f550f69 ad9d314c839645d1b264c21f9d500a5d msgid "v1.0.1" msgstr "" #: ../../font.rst:121 cc6628c7c246454785eae18aa76df135 msgid "spacembo" msgstr "" #: ../../font.rst:121 899d31ca415d4d60a771344775afb052 msgid "Space Mono Bold" msgstr "Space Mono ボールド" #: ../../font.rst:122 0fa8a8df23aa46a18ebc85a45faef555 msgid "spacemit" msgstr "" #: ../../font.rst:122 121e740c51fa4e13b45b780076fdc770 msgid "Space Mono Italic" msgstr "Space Mono イタリック" #: ../../font.rst:123 8c761931925c4c9080802855c8de2158 msgid "spacembi" msgstr "" #: ../../font.rst:123 c294981796074117b39f66e1d0fc697f msgid "Space Mono Bold-Italic" msgstr "Space Mono ボールドイタリック" #: ../../font.rst:124 fb3d22993d774962addb0d5e18962566 msgid "math" msgstr "" #: ../../font.rst:124 d72ffadba17c47d98e45bad69d43f48a msgid "Noto Sans Math Regular" msgstr "Noto Sans Math レギュラー" #: ../../font.rst:124 ../../font.rst:125 ../../font.rst:126 ../../font.rst:127 #: 4a51871589de44a49f3d817a3e4641ca a1e187ea3001421b848c3e15b2da294f #: c7f9419b4b474f9990c0e7b2548b89bd f44b20960c864e1a812db6b82ccc7b01 msgid "v1.0.2" msgstr "" #: ../../font.rst:124 3527017ccae847e198b6aa3fd407bf86 msgid "math symbols" msgstr "数学記号" #: ../../font.rst:125 f0c044192be8422bbb062dcfe3fa3867 msgid "music" msgstr "" #: ../../font.rst:125 5091921f86b8478b884595a229b30799 msgid "Noto Music Regular" msgstr "Noto Music レギュラー" #: ../../font.rst:125 0cfb05fc68a6412895e997a6f27ab557 msgid "musical symbols" msgstr "音楽記号" #: ../../font.rst:126 198d0ac76851400696fd7bfe7e9c60b3 msgid "symbol1" msgstr "" #: ../../font.rst:126 8bf74ea20b3d41c081691ba396ba7ec2 msgid "Noto Sans Symbols Regular" msgstr "Noto Sans Symbols レギュラー" #: ../../font.rst:126 96ef9a86cd4c4af9ad70de3493072981 msgid "replacement for \"symb\"" msgstr "\"symb\"の代替" #: ../../font.rst:127 4eae35b6626f44edb67bbd03f28f00d6 msgid "symbol2" msgstr "" #: ../../font.rst:127 b1fdca63e3d74dd29efec985e0b244dc msgid "Noto Sans Symbols2 Regular" msgstr "Noto Sans Symbols2 レギュラー" #: ../../font.rst:127 0bd6d32f20eb48dd988041621b3d5200 msgid "extended symbol set" msgstr "拡張記号セット" #: ../../font.rst:128 aa751e08f13849d1a55e72c6aebf8f49 msgid "notos" msgstr "" #: ../../font.rst:128 89dea662c0eb4c7eb232a7fdba6ebc9a msgid "Noto Sans Regular" msgstr "Noto Sans レギュラー" #: ../../font.rst:128 ../../font.rst:129 ../../font.rst:130 ../../font.rst:131 #: 459d3d0e43ff4bf5aa61c68e8e685e29 67cb7c095cf74781840d29e84aa0034b #: 91a98cec9643445d9d588f6c148714f4 d8bd23d980b1436583464316e47308db msgid "v1.0.3" msgstr "" #: ../../font.rst:128 6b98b595462b4d478057da307cdea30a msgid "alternative to Helvetica" msgstr "Helveticaの代替" #: ../../font.rst:129 691a807af162494ab0b5af4186c9110c msgid "notosit" msgstr "" #: ../../font.rst:129 24201a800ba0419c9bee4bf90edf8825 msgid "Noto Sans Italic" msgstr "Noto Sans イタリック" #: ../../font.rst:130 4dd91c5ba63544bba1ceb32e1fdefd55 msgid "notosbo" msgstr "" #: ../../font.rst:130 ff244216f5904a4697fcab3f6d021a6a msgid "Noto Sans Bold" msgstr "Noto Sans ボールド" #: ../../font.rst:131 aa8c2e1781f54593b3331c086c19b814 msgid "notosbi" msgstr "" #: ../../font.rst:131 6857edcacab24c27817264bb11d9bdad msgid "Noto Sans BoldItalic" msgstr "Noto Sans ボールドイタリック" #: ../../font.rst:141 2a37a1a4a1aa4945b8df8dbf7e64e154 msgid "" "Check whether the unicode ``chr`` exists in the font or (option) some " "fallback font. May be used to check whether any \"TOFU\" symbols will " "appear on output." msgstr "" "指定した Unicode 文字 ``chr`` " "がフォント内または（オプションで）フォールバックフォント内に存在するかどうかを確認します。これは、「TOFU（豆腐）」と呼ばれる記号が出力に表示されるかどうかを確認するために使用できます。" #: ../../font.rst:143 009b9aeb3f9944d596e9f49f9899c324 msgid "the unicode of the character (i.e. ``ord()``)." msgstr "文字の Unicode 値（すなわち、``ord()`` 関数の結果）。" #: ../../font.rst:144 a8641b2b63ec4b07875c388e202271b9 msgid "the language -- currently unused." msgstr "言語（現在は未使用）。" #: ../../font.rst:145 1bf9dc08f5954b5f965c6b5ea1570763 msgid "the UCDN script number." msgstr "UCDN（Unicode Common Locale Data Repository）スクリプト番号。" #: ../../font.rst:146 c652199037ea41779589cd7c702796e7 msgid "" "*(new in v1.17.5)* perform an extended search in fallback fonts or " "restrict to current font (default)." msgstr "*（v1.17.5 で新たに追加）* フォールバックフォントでの拡張検索を実行するか、現在のフォントに制限するかを指定します（デフォルト）。" #: ../../font.rst:147 97e5feeeb43a4af0bb9163c00cad3e2b msgid "*(changed in 1.17.7)* the glyph number. Zero indicates no glyph found." msgstr "*（v1.17.7 で変更）* グリフ番号。ゼロはグリフが見つからないことを示します。" #: ../../font.rst:151 fed10a374e2445d1be29d1f78a496de5 msgid "New in v1.17.5" msgstr "v1.17.5 で新たに追加" #: ../../font.rst:153 290f44f3033a469e89d5444b5d3ec4f9 msgid "Return an array of unicodes supported by this font." msgstr "このフォントがサポートする Unicode の配列を返します。" #: ../../font.rst:155 ab16e827b27d4022b45b4c90a328da02 #, python-format msgid "" "an ``array.array`` [#f2]_ of length at most :attr:`Font.glyph_count`. " "I.e. ``chr()`` of every item in this array has a glyph in the font " "without using fallbacks. This is an example display of the supported " "glyphs: >>> import pymupdf >>> font = pymupdf.Font(\"math\") >>> vuc = " "font.valid_codepoints() >>> for i in vuc: print(\"%04X %s (%s)\" % " "(i, chr(i), font.unicode_to_glyph_name(i))) 0000 000D (CR) 0020 " "(space) 0021 ! (exclam) 0022 \" (quotedbl) 0023 # (numbersign) 0024 $ " "(dollar) 0025 % (percent) ... 00AC ¬ (logicalnot) 00B1 ± (plusminus) ... " "21D0 ⇐ (arrowdblleft) 21D1 ⇑ (arrowdblup) 21D2 ⇒ (arrowdblright) 21D3 ⇓ " "(arrowdbldown) 21D4 ⇔ (arrowdblboth) ... 221E ∞ (infinity) ..." msgstr "" #: ../../font.rst:155 7031be6a1bcf4a65b62350eb968608e6 msgid "" "an ``array.array`` [#f2]_ of length at most :attr:`Font.glyph_count`. " "I.e. ``chr()`` of every item in this array has a glyph in the font " "without using fallbacks. This is an example display of the supported " "glyphs:" msgstr "" ":attr:`Font.glyph_count` 以上の長さを持つ ``array.array`` [#f2]_。つまり、この配列内の各アイテムの" " ``chr()`` は、フォールバックを使用せずにフォント内にグリフを持っていることを示します。以下はサポートされるグリフの例示です：" #: ../../font.rst:183 c5ad65fa71a74dd9a63ab09809f0f9cf msgid "" "This method only returns meaningful data for fonts having a CMAP " "(character map, charmap, the `/ToUnicode` PDF key). Otherwise, this array" " will have length 1 and contain zero only." msgstr "" "このメソッドは、CMAP（文字マップ、charmap、`/ToUnicode` PDF " "キー）を持つフォントに対してのみ意味のあるデータを返します。それ以外の場合、この配列は長さ1で、ゼロのみを含みます。" #: ../../font.rst:192 af8b042889b54a38b2a5ddd689449328 msgid "Calculate the \"width\" of the character's glyph (visual representation)." msgstr "文字のグリフ（視覚的な表現）の「幅」を計算します。" #: ../../font.rst:194 c1f6c6b34907404e97ad72617e0fc346 msgid "" "the unicode number of the character. Use ``ord()``, not the character " "itself. Again, this should normally work even if a character is not " "supported by that font, because fallback fonts will be checked where " "necessary." msgstr "" "文字のUnicode番号。文字自体ではなく、``ord()`` " "を使用します。文字がそのフォントでサポートされていない場合でも、必要に応じてフォールバックフォントがチェックされるため、通常は機能するはずです。" #: ../../font.rst:195 e838a07682d84a869e2fa1cc89abf58a msgid "write mode, ``0`` = horizontal, ``1`` = vertical." msgstr "書き込みモード、 ``0`` = 横方向、 ``1`` = 縦方向。" #: ../../font.rst:197 2dc7e2ceacbb4ef690b919a430d04d1b msgid "The other parameters are not in use currently." msgstr "その他のパラメータは現在使用されていません。" #: ../../font.rst:199 e8423a5397284db1919f456052773ded msgid "a float representing the glyph's width relative to **fontsize 1**." msgstr "**フォントサイズ** 1に対するグリフの幅を表す浮動小数点数。" #: ../../font.rst:203 47dc9dab1b4c4cb8b9e6a069008d81b1 msgid "" "Return the unicode value for a given glyph name. Use it in conjunction " "with `chr()` if you want to output e.g. a certain symbol." msgstr "指定されたグリフ名のUnicode値を返します。特定のシンボルを出力したい場合は、`chr()` と組み合わせて使用します。" #: ../../font.rst:205 749831c099134aa7bf7ffe282b0836b5 msgid "The name of the glyph." msgstr "グリフの名前。" #: ../../font.rst:207 377293d9901943dbb4c7c31c7985c7d9 msgid "" "The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: " "`font.glyph_name_to_unicode(\"Sigma\") = 931`, " "`font.glyph_name_to_unicode(\"sigma\") = 963`. Refer to the `Adobe Glyph " "List `_ publication for a list of glyph names " "and their unicode numbers. Example: >>> font = pymupdf.Font(\"helv\") " ">>> font.has_glyph(font.glyph_name_to_unicode(\"infinity\")) True" msgstr "" #: ../../font.rst:207 765a70f4e5934d66adf72deeaaad3599 msgid "" "The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: " "`font.glyph_name_to_unicode(\"Sigma\") = 931`, " "`font.glyph_name_to_unicode(\"sigma\") = 963`. Refer to the `Adobe Glyph " "List `_ publication for a list of glyph names " "and their unicode numbers. Example:" msgstr "" "Unicode整数、または名前が不明な場合は65533 = " "0xFFFDです。例：`font.glyph_name_to_unicode(\"Sigma\") = " "931`、`font.glyph_name_to_unicode(\"sigma\") = 963` 。Adobe Glyph " "Listの出版物を参照して、グリフ名とUnicode番号のリストを確認してください。例：" #: ../../font.rst:219 ceed99f4b1f641ae9879e4ef9b43cfcf msgid "The glyph rectangle relative to :data:`fontsize` 1." msgstr ":data:`fontsize` 1に対するグリフの矩形領域。" #: ../../font.rst:221 9803fc558ea94924824b3c6f36f33ce5 msgid "``ord()`` of the character." msgstr "文字の ``ord()`` 。" #: ../../font.rst:223 cae0a18260bf47dcb9d033363ab5176b msgid "a :ref:`Rect`." msgstr ":ref:`Rect`。" #: ../../font.rst:228 c530486f148348589a870c1a6fad982d msgid "Show the name of the character's glyph." msgstr "文字のグリフの名前を表示します。" #: ../../font.rst:230 b33374c8c5234c618bbb03b5c25bd99b msgid "" "the unicode number of the character. Use ``ord()``, not the character " "itself." msgstr "文字のunicode番号。文字自体ではなく ``ord()`` を使用します。" #: ../../font.rst:232 39265ca9c3774508a81f7b6c33627e8d msgid "" "a string representing the glyph's name. E.g. `font.glyph_name(ord(\"#\"))" " = \"numbersign\"`. For an invalid code \".notfound\" is returned. .. " "note:: *(Changed in v1.18.0)* This method and " ":meth:`Font.glyph_name_to_unicode` no longer depend on a font and instead" " retrieve information from the **Adobe Glyph List**. Also available as " "`pymupdf.unicode_to_glyph_name()` and resp. " "`pymupdf.glyph_name_to_unicode()`." msgstr "" #: ../../font.rst:232 7b64931c6f244cfca3c0761329de7f73 msgid "" "a string representing the glyph's name. E.g. `font.glyph_name(ord(\"#\"))" " = \"numbersign\"`. For an invalid code \".notfound\" is returned." msgstr "" "グリフの名前を表す文字列。例：`font.glyph_name(ord(\"#\")) = \"numbersign\"` " "。無効なコードの場合、\".notfound\" が返されます。" #: ../../font.rst:234 20712f7e063243888f6395b18c3acae8 msgid "" "*(Changed in v1.18.0)* This method and :meth:`Font.glyph_name_to_unicode`" " no longer depend on a font and instead retrieve information from the " "**Adobe Glyph List**. Also available as `pymupdf.unicode_to_glyph_name()`" " and resp. `pymupdf.glyph_name_to_unicode()`." msgstr "" "*(1.18.0で変更)* このメソッドと:meth:`Font.glyph_name_to_unicode` " "はもはやフォントに依存せず、**Adobe Glyph List** " "から情報を取得します。`pymupdf.unicode_to_glyph_name()` とresp. " "`pymupdf.glyph_name_to_unicode()` としても利用可能です。" #: ../../font.rst:241 38b6209e6a4344a8b3be848dc476755c msgid "Calculate the length in points of a unicode string." msgstr "Unicode文字列の長さをポイント単位で計算します。" #: ../../font.rst:243 142ac4b87bb644ffa8514275b3e51007 msgid "" "There is a functional overlap with :meth:`get_text_length` for Base-14 " "fonts only." msgstr "Base-14フォントに対しては、:meth:`get_text_length` と機能が重複しています。" #: ../../font.rst:245 ../../font.rst:269 7c8abec195d7425ab74856419d327b59 #: f31ddd69af474ca98115ec49230627cf msgid "a text string, UTF-8 encoded." msgstr "テキスト文字列、UTF-8エンコード。" #: ../../font.rst:247 ../../font.rst:271 280e2e6390a84299b1eb50742751cc45 #: 5880b72ffefe4073a534b44ef82aa00b msgid "the :data:`fontsize`." msgstr ":data:`fontsize`。" #: ../../font.rst 24af9fb41f6d40be800f9d6a56909af0 #: 375fd3e160764b6f97a1b86fc740fe8a 465db7792c4b472f806017a0d364f367 #: 53682f9b23a84002ab90b511020b49f6 5fa74d99fa99412f91d3a82aefa8e4bf #: 70db0a0a767e4ee8867951f816a54be0 9353b0e144af4fc7a2f47be5d63e325b #: b579c7fff96e4c608f8eb22666e2666d d2e13bff74024b768ddd4405202d6cab #: d3196a22363c47ecb37dd5972f00334e msgid "Return type" msgstr "" #: ../../font.rst:251 ec7a7979f9e7418fbdceaeee4f29b39d msgid "" "the length of the string in points when stored in the PDF. If a character" " is not contained in the font, it will automatically be looked up in a " "fallback font. .. note:: This method was originally implemented in " "Python, based on calling :meth:`Font.glyph_advance`. For performance " "reasons, it has been rewritten in C for v1.18.14. To compute the width of" " a single character, you can now use either of the following without " "performance penalty: 1. `font.glyph_advance(ord(\"Ä\")) * fontsize`" " 2. `font.text_length(\"Ä\", fontsize=fontsize)` For multi-" "character strings, the method offers a huge performance advantage " "compared to the previous implementation: instead of about 0.5 " "microseconds for each character, only 12.5 nanoseconds are required for " "the second and subsequent ones." msgstr "" #: ../../font.rst:251 f41d04198f2341a990157155d7f740b1 msgid "" "the length of the string in points when stored in the PDF. If a character" " is not contained in the font, it will automatically be looked up in a " "fallback font." msgstr "PDFに格納された文字列のポイント単位の長さ。文字がフォントに含まれていない場合、自動的にフォールバックフォントで検索されます。" #: ../../font.rst:253 57ccdf4bd0474e3280e1cdda9d041027 msgid "" "This method was originally implemented in Python, based on calling " ":meth:`Font.glyph_advance`. For performance reasons, it has been " "rewritten in C for v1.18.14. To compute the width of a single character, " "you can now use either of the following without performance penalty:" msgstr "" "このメソッドは元々Pythonで実装され、:meth:`Font.glyph_advance` " "を呼び出すことに基づいていました。性能の理由から、v1.18.14向けにCで書き直されました。単一の文字の幅を計算するには、以下のいずれかを使用でき、パフォーマンスに差異はありません：" #: ../../font.rst:255 b485562f46994ef3a76ed0ba8f486f14 msgid "`font.glyph_advance(ord(\"Ä\")) * fontsize`" msgstr "" #: ../../font.rst:256 7b3106bb9bf0498198809c557ab60339 msgid "`font.text_length(\"Ä\", fontsize=fontsize)`" msgstr "" #: ../../font.rst:258 3724b3d50f664946b0d42d8fab2f84f6 msgid "" "For multi-character strings, the method offers a huge performance " "advantage compared to the previous implementation: instead of about 0.5 " "microseconds for each character, only 12.5 nanoseconds are required for " "the second and subsequent ones." msgstr "複数文字の文字列に対して、このメソッドは以前の実装と比べて非常に高速で、各文字ごとに約0.5マイクロ秒かかる代わりに、2番目以降の文字には12.5ナノ秒しか必要ありません。" #: ../../font.rst:265 aafd060e84e541abbe7b30af94aa8ded msgid "*New in v1.18.14*" msgstr "*v1.18.14で新たに導入*" #: ../../font.rst:267 7decb74d1d39477b9462d29370e42a35 msgid "Sequence of character lengths in points of a unicode string." msgstr "Unicode文字列の文字の長さ（ポイント単位）のシーケンス。" #: ../../font.rst:275 76401a090dc249fcab049f83b6f83cee msgid "" "the lengths in points of the characters of a string when stored in the " "PDF. It works like :meth:`Font.text_length` broken down to single " "characters. This is a high speed method, used e.g. in " ":meth:`TextWriter.fill_textbox`. The following is true (allowing rounding" " errors): `font.text_length(text) == sum(font.char_lengths(text))`. >>> " "font = pymupdf.Font(\"helv\") >>> text = \"PyMuPDF\" >>> " "font.text_length(text) 50.115999937057495 >>> " "pymupdf.get_text_length(text, fontname=\"helv\") 50.115999937057495 >>> " "sum(font.char_lengths(text)) 50.115999937057495 >>> " "pprint(font.char_lengths(text)) (7.336999952793121, # P 5.5," " # y 9.163000047206879, # M 6.115999937057495, # u " "7.336999952793121, # P 7.942000031471252, # D 6.721000015735626) # " "F" msgstr "" #: ../../font.rst:275 1544e745681a4b6da063619a2e9620b7 msgid "" "the lengths in points of the characters of a string when stored in the " "PDF. It works like :meth:`Font.text_length` broken down to single " "characters. This is a high speed method, used e.g. in " ":meth:`TextWriter.fill_textbox`. The following is true (allowing rounding" " errors): `font.text_length(text) == sum(font.char_lengths(text))`." msgstr "" "PDFに保存される文字列の各文字の長さ（ポイント単位）。これは、:meth:`Font.text_length` " "を各文字に分解したようなものです。高速なメソッドであり、例えば:meth:`TextWriter.fill_textbox` " "で使用されています。以下が成り立ちます（丸め誤差を許容する）：`font.text_length(text) == " "sum(font.char_lengths(text))`。" #: ../../font.rst:297 d80b29e9dd8c454da9c51b26d9cad2fe msgid "New in v1.17.6" msgstr "新機能 v1.17.6" #: ../../font.rst:299 30834747dcfd4dc48a79f57ad356cdd3 msgid "Copy of the binary font file content." msgstr "バイナリフォントファイルのコンテンツのコピー。" #: ../../font.rst:305 71cd13ec6bab4c46bb9c7dbb8108fb63 msgid "" "A dictionary with various font properties, each represented as bools. " "Example for Helvetica::" msgstr "Helveticaの例など、さまざまなフォントプロパティを持つ辞書で、それぞれがブール値として表されています。" #: ../../font.rst:325 dbe85241cd3a4910a0da84236fc69d03 msgid "Name of the font. May be \"\" or \"(null)\"." msgstr "フォントの名前。空文字列であることもあります。" #: ../../font.rst:329 190864bf642d4836b3e8ed0493dc4672 msgid "The font bbox. This is the maximum of its glyph bboxes." msgstr "フォントのbbox。これは、そのグリフのbboxの最大値です。" #: ../../font.rst:331 33b968a3b28241e9a604dd232bd3bf7c msgid ":ref:`Rect`" msgstr "" #: ../../font.rst:337 38e95b49eec642f784ca39d58b0b40df msgid "The number of glyphs defined in the font." msgstr "グリフ数。" #: ../../font.rst:341 ../../font.rst:349 aa9a0f03418b4adba2109af305a941e1 #: b18be968a53743bdb4bdab316af4c374 msgid "New in v1.18.0" msgstr "v1.18.0で新規追加" #: ../../font.rst:343 d3c64bfaff7540aa857c6dcc2fc2b0a0 msgid "" "The ascender value of the font, see `ascender typography " "`_ for details. " "Please note that there is a difference to the strict definition: our " "value includes everything above the baseline -- not just the height " "difference between upper case \"A\" and and lower case \"a\"." msgstr "フォントのアセンダー値。詳細についてはこちらを参照してください。ただし、厳密な定義とは異なり、私たちの値にはベースラインを上回るすべてが含まれます。単に大文字の「A」と小文字の「a」の高さの違いだけでなく、ベースラインを上回るすべてが含まれます。" #: ../../font.rst:351 7fba1bd77fd74cc1abdb335fe3269fbc msgid "" "The descender value of the font, see `descender typography " "`_ for details. This value " "always is negative and is the portion that some glyphs descend below the " "base line, for example \"g\" or \"y\". As a consequence, the value " "`ascender - descender` is the total height, that every glyph of the font " "fits into. This is true at least for most fonts -- as always, there are " "exceptions, especially for calligraphic fonts, etc." msgstr "" "フォントのディセンダー値。詳細についてはこちらを参照してください。この値は常に負であり、一部のグリフがベースライン以下に降りる部分、例えば「g」や「y」です。したがって、`アセンダー" " - ディセンダー` " "の値は、フォントのすべてのグリフが収まる総高さです。これはほとんどのフォントに当てはまりますが、いくつかの例外があります。特にカリグラフィーフォントなどです。" #: ../../font.rst:363 4ffede0fc21c4b5fa0f667a903b92e93 msgid "" "A number of attributes with obvious meanings. Reflect some values of the " ":attr:`Font.flags` dictionary." msgstr "明らかな意味を持つ属性がいくつかあります。これらは :attr:`Font.flags` 辞書の値の一部を反映しています。" #: ../../font.rst:368 4bd92baafe77479faa63b31082e0c69a msgid "Footnotes" msgstr "脚注" #: ../../font.rst:369 d66637c72e2b45aea7edd3cb116ec328 msgid "" "MuPDF does not support all fontfiles with this feature and will raise " "exceptions like *\"mupdf: FT_New_Memory_Face((null)): unknown file " "format\"*, if it encounters issues." msgstr "" "MuPDFはこの機能を持つすべてのフォントファイルをサポートしておらず、問題が発生すると *「mupdf: " "FT_New_Memory_Face((null)): unknown file format」* " "といった例外を発生させます。:ref:`TextWriter` のメソッドは :attr:`Font.is_writable` をチェックします。" #: ../../font.rst:371 7213fcc59c214e508d3da6221ec0d21a msgid "" "The built-in Python module `array` has been chosen for its speed and low " "memory requirement." msgstr "組み込みの *array* モジュールは、その速度と値のコンパクトな表現のために選択されました。" #: ../../footer.rst:46 3dc04747492b4b4bac6e2c6af8d83002 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid ":attr:`~Font.is_writable`" #~ msgstr "" #~ msgid "Font usable with :ref:`TextWriter`" #~ msgstr ":ref:`TextWriter` で使用可能なフォント" #~ msgid "Indicates whether this font can be used with :ref:`TextWriter`." #~ msgstr "このフォントを :ref:`TextWriter` で使用できるかどうかを示します。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "a MuPDF font if successful. This " #~ "is the overall sequence of checks " #~ "to determine an appropriate font: " #~ "=========== " #~ "============================================================ " #~ "Argument Action =========== " #~ "============================================================ " #~ "fontfile? Create font from file, " #~ "exception if failure. fontbuffer? Create " #~ "font from buffer, exception if failure." #~ " ordering>=0 Create universal font, always" #~ " succeeds. fontname? Create a Base-14 " #~ "font, universal font, or font " #~ "provided by `pymupdf-fonts " #~ "`_. See " #~ "table below. =========== " #~ "============================================================" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/footer.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../footer.rst:60 74c961cfd0e64769bcdb58467763a6c6 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/functions.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4362cd8e08a74daebc63e2250a1293cd msgid "Artifex" msgstr "" #: ../../header.rst:-1 8c3fd3acd0a54dacaaaea104c5ca20e2 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 7d4f452edf45487b8855a2fdb4b7f37b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../functions.rst:5 764415be522b4af7bed822bf808d3c81 msgid "Functions" msgstr "関数" #: ../../functions.rst:6 7d85734965b44884afa1f60ccbb9fce3 msgid "" "The following are miscellaneous functions and attributes on a fairly low-" "level technical detail." msgstr "以下は、PDFに関する低レベルな技術的詳細に関するさまざまな関数と属性です。" #: ../../functions.rst:8 87eea67bd6bd469c809cfb2f400fd0ac msgid "" "Some functions provide detail access to PDF structures. Others are " "stripped-down, high performance versions of other functions which provide" " more information." msgstr "一部の関数は、PDF構造への詳細なアクセスを提供します。他の関数の高性能バージョンで、より多くの情報を提供する関数から派生しています。" #: ../../functions.rst:10 3e757537a03d4b07bdcba164caba05f3 msgid "Yet others are handy, general-purpose utilities." msgstr "また、その他にも便利な汎用ユーティリティが含まれています。" #: ../../functions.rst:14 3a980a38ec2e42368864c2737353297a msgid "**Function**" msgstr "**関数**" #: ../../functions.rst:14 53d11d16c6cb41359e0d1eb9434091a8 msgid "**Short Description**" msgstr "**短い説明**" #: ../../functions.rst:16 add8a0f8af544090bd2b69bec2a08b06 msgid ":attr:`Annot.apn_bbox`" msgstr "" #: ../../functions.rst:16 5e6c725340da4680b4b2182ec97992ef msgid "PDF only: bbox of the appearance object" msgstr "PDFのみ：外観オブジェクトのバウンディングボックス" #: ../../functions.rst:17 0e00e13e8cd249aea5b27907a5924ac2 msgid ":attr:`Annot.apn_matrix`" msgstr "" #: ../../functions.rst:17 f099fa1353fa448486e549396e8c85c4 msgid "PDF only: the matrix of the appearance object" msgstr "PDFのみ：外観オブジェクトの行列" #: ../../functions.rst:18 04cb195c672149e79a5dbf453e0dd2d2 msgid ":attr:`Page.is_wrapped`" msgstr "" #: ../../functions.rst:18 733534121ca84a7dae39d79a0e4fdf8e msgid "check whether contents wrapping is present" msgstr "コンテンツの折り返しが存在するかどうかを確認します" #: ../../functions.rst:19 6070d8798ae847c7b81482b126630c8a msgid ":meth:`adobe_glyph_names`" msgstr "" #: ../../functions.rst:19 3e1263f453fb48c78527c09031c8dfda msgid "list of glyph names defined in **Adobe Glyph List**" msgstr "**Adobe Glyph List** で定義されたグリフ名のリスト" #: ../../functions.rst:20 8540cf95e6284b908e38968f6e2b84b1 msgid ":meth:`adobe_glyph_unicodes`" msgstr "" #: ../../functions.rst:20 868c1c4b39334083b57fc6f75dc63c73 msgid "list of unicodes defined in **Adobe Glyph List**" msgstr "**Adobe Glyph List** で定義されたUnicodeのリスト" #: ../../functions.rst:21 b9f2db6bdc1f4375b9d86730afc564cf msgid ":meth:`Annot.clean_contents`" msgstr "" #: ../../functions.rst:21 c89e0a09bfd5482e9a00164e53985cdb msgid "PDF only: clean the annot's :data:`contents` object" msgstr "PDFのみ：アノテーションの :data:`contents` オブジェクトをクリーンアップ" #: ../../functions.rst:22 32cff1b105fc415ab1df92fb4a1367ee msgid ":meth:`Annot.set_apn_bbox`" msgstr "" #: ../../functions.rst:22 490b8142dc73479a84f8532efe1a7dd0 msgid "PDF only: set the bbox of the appearance object" msgstr "PDFのみ：外観オブジェクトのバウンディングボックスを設定" #: ../../functions.rst:23 825eafcadc4840a6b3da5b4eae9803b5 msgid ":meth:`Annot.set_apn_matrix`" msgstr "" #: ../../functions.rst:23 bd593d88e1054999ba94daf514352282 msgid "PDF only: set the matrix of the appearance object" msgstr "PDFのみ：外観オブジェクトの行列を設定" #: ../../functions.rst:24 c442dc2915174eb9bca27cc7aaec5a63 msgid ":meth:`ConversionHeader`" msgstr "" #: ../../functions.rst:24 39f5b60624524140bcf3d19279f48605 msgid "return header string for *get_text* methods" msgstr "*get_text* メソッド用のヘッダー文字列を返す" #: ../../functions.rst:25 2832c8a25ff645c1833824445cd50d2e msgid ":meth:`ConversionTrailer`" msgstr "" #: ../../functions.rst:25 809aa5cd142a4d28927bdedc1f5d789a msgid "return trailer string for *get_text* methods" msgstr "*get_text* メソッド用のトレーラー文字列を返す" #: ../../functions.rst:26 793c18c2f91c4349a65f71f6504d9872 msgid ":meth:`Document.del_xml_metadata`" msgstr "" #: ../../functions.rst:26 2c210b89288b437482fee9c882c0c7a4 msgid "PDF only: remove XML metadata" msgstr "PDFのみ：XMLメタデータを削除" #: ../../functions.rst:27 0bd03bc3092d4f75ab36f591dd57098a msgid ":meth:`Document.get_char_widths`" msgstr "" #: ../../functions.rst:27 cb86339da05542aaafc997cf781c9fb9 msgid "PDF only: return a list of glyph widths of a font" msgstr "PDFのみ：フォントのグリフ幅のリストを返す" #: ../../functions.rst:28 56fc88a38fce4ad58e50e488249dc90a msgid ":meth:`Document.get_new_xref`" msgstr "" #: ../../functions.rst:28 950c2315e268432ca322e1428ccede80 msgid "PDF only: create and return a new :data:`xref` entry" msgstr "PDFのみ：新しい :data:`xref` エントリを作成して返す" #: ../../functions.rst:29 496d02cad3d94be590dc49051170a1c4 msgid ":meth:`Document.is_stream`" msgstr "" #: ../../functions.rst:29 586f78f3e3d24a80bc537b10b6756ccb msgid "PDF only: check whether an :data:`xref` is a stream object" msgstr "PDFのみ：:data:`xref` がストリームオブジェクトであるかどうかを確認" #: ../../functions.rst:30 578b7d1ff1d6471a84f62fa135e05681 msgid ":meth:`Document.xml_metadata_xref`" msgstr "" #: ../../functions.rst:30 253ad5dd537940c684f95c34413e9613 msgid "PDF only: return XML metadata :data:`xref` number" msgstr "PDFのみ：XMLメタデータの :data:`xref` 番号を返す" #: ../../functions.rst:31 4f8b6a367f104e19b3686d48c220b2e8 msgid ":meth:`Document.xref_length`" msgstr "" #: ../../functions.rst:31 944580e1219b4d6da596e2f0ecac1e0c msgid "PDF only: return length of :data:`xref` table" msgstr "PDFのみ：:data:`xref` テーブルの長さを返す" #: ../../functions.rst:32 9e00d8d6db8640a48b68b28cce3d2d56 msgid ":meth:`EMPTY_IRECT`" msgstr "" #: ../../functions.rst:32 ../../functions.rst:34 #: 4f93c48b456e40edb3bf54e18372fbcd 8885468553b943e2804495b185674bdb msgid "return the (standard) empty / invalid rectangle" msgstr "標準の空の/無効な矩形を返す" #: ../../functions.rst:33 116425823f97476ba4ef170d8f70b2a5 msgid ":meth:`EMPTY_QUAD`" msgstr "" #: ../../functions.rst:33 1db98794aff94fc58a84179249ea06eb msgid "return the (standard) empty / invalid quad" msgstr "標準の空の/無効な四角形を返す" #: ../../functions.rst:34 9000c9e5d6c6449ea2fac2877457a80c msgid ":meth:`EMPTY_RECT`" msgstr "" #: ../../functions.rst:35 a2378f40c3bd4ff68bf33e9d7f8d55a0 msgid ":meth:`get_pdf_now`" msgstr "" #: ../../functions.rst:35 e3d896a505e3415f91020a611d1b60cb msgid "return the current timestamp in PDF format" msgstr "現在のタイムスタンプをPDF形式で返す" #: ../../functions.rst:36 44be0971a3e943d4b339543e89c7d3e5 msgid ":meth:`get_pdf_str`" msgstr "" #: ../../functions.rst:36 d222dad1da46497a90683f26ca17b272 msgid "return PDF-compatible string" msgstr "PDF互換の文字列を返す" #: ../../functions.rst:37 97fc6fa0db4446d9884dd169f4279dba msgid ":meth:`get_text_length`" msgstr "" #: ../../functions.rst:37 110ac58da1a44ce2999975602c6c0e1a msgid "return string length for a given font & :data:`fontsize`" msgstr "指定したフォントと :data:`fontsize` の文字列長を返す" #: ../../functions.rst:38 c90ff4bd56b84326a2666157890bfd03 msgid ":meth:`glyph_name_to_unicode`" msgstr "" #: ../../functions.rst:38 401f5bf92bb74478b4d7029ec15dd089 msgid "return unicode from a glyph name" msgstr "グリフ名からUnicodeを返す" #: ../../functions.rst:39 99beef3b550a46ba98443a9d326de35b msgid ":meth:`image_profile`" msgstr "" #: ../../functions.rst:39 143bc56e8ef9413e96b151d77c64ae6f msgid "return a dictionary of basic image properties" msgstr "基本的な画像プロパティの辞書を返します。" #: ../../functions.rst:40 2290ac67413048f9a7e8bc3c1bed82da msgid ":meth:`INFINITE_IRECT`" msgstr "" #: ../../functions.rst:40 ../../functions.rst:42 #: 6c93c70e175b4feebad851e5e2d302e5 db34282539ff4d0cbcbb59a0746f4ad5 msgid "return the (only existing) infinite rectangle" msgstr "（唯一存在する）無限の矩形を返します。" #: ../../functions.rst:41 15427ddf5f9d40ea95e44583d180da0e msgid ":meth:`INFINITE_QUAD`" msgstr "" #: ../../functions.rst:41 c51f25d2a9ab403aaf35fdc880ac80ea msgid "return the (only existing) infinite quad" msgstr "（唯一存在する）無限のクワッドを返します。" #: ../../functions.rst:42 9c580aaf4136403aa2944098c657ef29 msgid ":meth:`INFINITE_RECT`" msgstr "" #: ../../functions.rst:43 ffa25a10067248539ecece4ed9e0453d msgid ":meth:`make_table`" msgstr "" #: ../../functions.rst:43 7533bf849012437cbd56f1d3ab66a42c msgid "split rectangle in sub-rectangles" msgstr "矩形をサブ矩形に分割します。" #: ../../functions.rst:44 312874e2effa4bc0bfd1300774e3a463 msgid ":meth:`Page.clean_contents`" msgstr "" #: ../../functions.rst:44 01e6fccf3e744a89a6858df35f24007a msgid "PDF only: clean the page's :data:`contents` objects" msgstr "PDF のみ：ページの :data:`contents` オブジェクトをクリーンアップします" #: ../../functions.rst:45 3dd8b9b45ab44ebba9d1b686be8dc50b msgid ":meth:`Page.get_bboxlog`" msgstr "" #: ../../functions.rst:45 dfbe6b6c5f9f47fd88042b9ae17531f3 msgid "list of rectangles that envelop text, drawing or image objects" msgstr "テキスト、描画、または画像オブジェクトを囲む矩形のリストです。" #: ../../functions.rst:46 c65e19fd4d02409cb4543812fa3b43d4 msgid ":meth:`Page.get_contents`" msgstr "" #: ../../functions.rst:46 299985f0af5147d7aa248ec6d462f2d1 msgid "PDF only: return a list of content :data:`xref` numbers" msgstr "PDF のみ：コンテンツ :data:`xref` 番号のリストを返します。" #: ../../functions.rst:47 c2ceb3b6204947318ef0c33b8b87b0d3 msgid ":meth:`Page.get_displaylist`" msgstr "" #: ../../functions.rst:47 c37180301960473ba34f6e7663b61b99 msgid "create the page's display list" msgstr "ページの表示リストを作成します。" #: ../../functions.rst:48 5b0003105f4240f88525d89fa0c0908d msgid ":meth:`Page.get_text_blocks`" msgstr "" #: ../../functions.rst:48 dd0afb0850654e8695ffc98210144dc8 msgid "extract text blocks as a Python list" msgstr "テキスト ブロックを Python リストとして抽出します。" #: ../../functions.rst:49 76e04262af69408e9a63c3184fb7bad0 msgid ":meth:`Page.get_text_words`" msgstr "" #: ../../functions.rst:49 9f393e28ef804590afa7ec5de0048155 msgid "extract text words as a Python list" msgstr "テキストワードを Python リストとして抽出します。" #: ../../functions.rst:50 1c8ae2f8f1f84b618bf7807fb1a10cc4 msgid ":meth:`Page.get_texttrace`" msgstr "" #: ../../functions.rst:50 e214fbbc63ae4d19a39fbd35f361f107 msgid "low-level text information" msgstr "低レベルのテキスト情報です。" #: ../../functions.rst:51 c12d9e81a4f14a1ead2ead8d7f981a7c msgid ":meth:`Page.read_contents`" msgstr "" #: ../../functions.rst:51 4ea4aa95a0e74da39d80427e97d0c2f4 msgid "PDF only: get complete, concatenated /Contents source" msgstr "PDF のみ：完全な連結 /Contents ソースを取得します。" #: ../../functions.rst:52 0a7b92c5ce184b8696922871f9786f30 msgid ":meth:`Page.run`" msgstr "" #: ../../functions.rst:52 e20ec70bf4894a6aa07e7a11aaf63d9e msgid "run a page through a device" msgstr "ページをデバイスを介して実行します。" #: ../../functions.rst:53 f318ac76d76d4865bd43843061a922e7 msgid ":meth:`Page.set_contents`" msgstr "" #: ../../functions.rst:53 efe0c81605704542bfd7c295f5f6ccce msgid "PDF only: set page's :data:`contents` to some :data:`xref`" msgstr "PDF のみ：ページの :data:`contents` を特定の :data:`xref` に設定します。" #: ../../functions.rst:54 4eb1f3fa01d74d89bd9e13660d80aace msgid ":meth:`Page.wrap_contents`" msgstr "" #: ../../functions.rst:54 1e1087f91ea540e786db6751528af559 msgid "wrap contents with stacking commands" msgstr "スタッキング コマンドでコンテンツをラップします。" #: ../../functions.rst:55 09fa362cbcc546d5bf5d8ff7ab48a08e msgid ":meth:`css_for_pymupdf_font`" msgstr "" #: ../../functions.rst:55 e8300bd4f1b44f5db6278ec60b77cd26 msgid "create CSS source for a font in package pymupdf_fonts" msgstr "パッケージ pymupdf_fonts のフォント用の CSS ソースを作成します。" #: ../../functions.rst:56 f03759eda97c48b2a48fa4f9b0fedb9a msgid ":meth:`paper_rect`" msgstr "" #: ../../functions.rst:56 b1fb4ea8173343e4b372c4196e07d4ea msgid "return rectangle for a known paper format" msgstr "既知の用紙形式の矩形を返します。" #: ../../functions.rst:57 18bd1781e96740a0bd73013a3d7b664c msgid ":meth:`paper_size`" msgstr "" #: ../../functions.rst:57 4c71d20789bf4aafba9b403c91023308 msgid "return width, height for a known paper format" msgstr "既知の用紙形式の幅と高さを返します。" #: ../../functions.rst:58 448bae55c0144a77bf34e084c2087748 msgid ":meth:`paper_sizes`" msgstr "" #: ../../functions.rst:58 a4b88a6f83704283b1d067b9b422950b msgid "dictionary of pre-defined paper formats" msgstr "事前定義の用紙形式の辞書です。" #: ../../functions.rst:59 b534913dfb3a46caa10a1f68b16f99f5 msgid ":meth:`planish_line`" msgstr "" #: ../../functions.rst:59 dfa9809478844cd3a030cab4d9dfd1c2 msgid "matrix to map a line to the x-axis" msgstr "直線を x 軸にマップする行列です。" #: ../../functions.rst:60 73b07e7023524c939f290cfec3c5147d msgid ":meth:`recover_char_quad`" msgstr "" #: ../../functions.rst:60 5d790e90a6db4ee39f6b9c7eaeaabaee msgid "compute the quad of a char (\"rawdict\")" msgstr "文字のクワッドを計算します（\"rawdict\"）。" #: ../../functions.rst:61 c7b763ff7e8242908671eb76801b55c5 msgid ":meth:`recover_line_quad`" msgstr "" #: ../../functions.rst:61 907e455060ee4289a865a3187bb4704e msgid "compute the quad of a subset of line spans" msgstr "ラインスパンのサブセットのクワッドを計算します" #: ../../functions.rst:62 7f4adbdf1e7345cd91ccb084d979616b msgid ":meth:`recover_quad`" msgstr "" #: ../../functions.rst:62 0077aa420f404be69c0b00c321022093 msgid "compute the quad of a span (\"dict\", \"rawdict\")" msgstr "スパンのクワッドを計算する (\"dict\", \"rawdict\")" #: ../../functions.rst:63 02efaa1a3ddc4f1c8aa20484a700e7e4 msgid ":meth:`recover_span_quad`" msgstr "" #: ../../functions.rst:63 8ce412850eb445b78abe6ca665a2a77f msgid "compute the quad of a subset of span characters" msgstr "行スパンのサブセットのクワッドを計算します。" #: ../../functions.rst:64 c8a3bffef95e412ca257c252d6bff657 msgid ":meth:`set_messages`" msgstr "" #: ../../functions.rst:64 ae0c40a4b5ed4b718dfb8abc492ca10e msgid "set destination of |PyMuPDF| messages." msgstr "" #: ../../functions.rst:65 0d4e3f46893442b5b8eba64b982bf3f2 msgid ":meth:`sRGB_to_pdf`" msgstr "" #: ../../functions.rst:65 d696f1caa15445b6bb8d91e71984f0a4 msgid "return PDF RGB color tuple from an sRGB integer" msgstr "sRGB 整数から PDF RGB カラー タプルを返します。" #: ../../functions.rst:66 65f3ad24442c445fb34dae8002131da9 msgid ":meth:`sRGB_to_rgb`" msgstr "" #: ../../functions.rst:66 3d999340cd904162a8038d1a4126b947 msgid "return (R, G, B) color tuple from an sRGB integer" msgstr "sRGB 整数から (R、G、B) カラー タプルを返します。" #: ../../functions.rst:67 766d7f863ca4428e842619c0ebca36ef msgid ":meth:`unicode_to_glyph_name`" msgstr "" #: ../../functions.rst:67 6d5f5fe4327b4bf9b8aae045c9bf2b99 msgid "return glyph name from a unicode" msgstr "Unicode からグリフ名を返します。" #: ../../functions.rst:68 b9b504a041b94a4f8519153749eb4825 msgid ":meth:`get_tessdata`" msgstr "" #: ../../functions.rst:68 a2891d94940c4cf8a54ab447f7b15370 msgid "locates the language support of the Tesseract-OCR installation" msgstr "Tesseract-OCR インストールの言語サポートを特定します。" #: ../../functions.rst:69 f1824ee678fd459f92586806ad603df7 msgid ":meth:`colors_pdf_dict`" msgstr "" #: ../../functions.rst:69 0d099e9629fb4b689e08965adfc300e0 msgid "return dict of color names." msgstr "" #: ../../functions.rst:70 8dffcc2057e74973bf33f55a5145efa7 msgid ":meth:`colors_wx_list`" msgstr "" #: ../../functions.rst:70 df83f96c7f9049f9a2135f8c7c3e1f45 msgid "return list of color names." msgstr "" #: ../../functions.rst:71 a7d1b2ff6e7b499991be2827f2ce182f msgid ":attr:`fitz_fontdescriptors`" msgstr "" #: ../../functions.rst:71 2bd5030a1ab34dfea799a7bac792e409 msgid "dictionary of available supplement fonts" msgstr "利用可能な補足フォントの辞書です。" #: ../../functions.rst:72 213d79bfa9874a63ac1a4cfeb7032132 msgid ":attr:`PYMUPDF_MESSAGE`" msgstr "" #: ../../functions.rst:72 01828b10e24e4ca7a6ec84f910c2955e msgid "destination of |PyMuPDF| messages." msgstr "" #: ../../functions.rst:73 fe68fe9641d94830aac3959ef70a3a46 msgid ":attr:`pdfcolor`" msgstr "" #: ../../functions.rst:73 19755c9b06fb412fac21ab46d85760d4 msgid "dictionary of almost 500 RGB colors in PDF format." msgstr "PDF 形式のほぼ 500 以上の RGB カラーの辞書です。" #: ../../functions.rst:78 688881b3cb454361936fad432734136c msgid "" "Convenience function to return width and height of a known paper format " "code. These values are given in pixels for the standard resolution 72 " "pixels = 1 inch." msgstr "既知の用紙フォーマットの幅と高さを返す便利な関数です。これらの値は、標準解像度 72 ピクセル = 1 インチのピクセル単位で指定されます。" #: ../../functions.rst:80 df6f7db7c5e64bb99187e217a5e55d94 msgid "" "Currently defined formats include **'A0'** through **'A10'**, **'B0'** " "through **'B10'**, **'C0'** through **'C10'**, **'Card-4x6'**, **'Card-" "5x7'**, **'Commercial'**, **'Executive'**, **'Invoice'**, **'Ledger'**, " "**'Legal'**, **'Legal-13'**, **'Letter'**, **'Monarch'** and **'Tabloid-" "Extra'**, each in either portrait or landscape format." msgstr "" "現在の定義されたフォーマットには、**‘A0’** から **‘A10’**、**‘B0’** から **‘B10’**、**‘C0’** から " "**‘C10’**、**‘Card-4x6’**、**‘Card-" "5x7’**、**‘Commercial’**、**‘Executive’**、**‘Invoice’**、**‘Ledger’**、**‘Legal’**、**‘Legal-13’**、**‘Letter’**、**‘Monarch" "’**、**‘Tabloid-Extra’** が含まれており、各フォーマットは縦向きまたは横向きで提供されています。" #: ../../functions.rst:82 1227353c5f80413d8e4366aaa7e00301 msgid "" "A format name must be supplied as a string (case **in** \\sensitive), " "optionally suffixed with \"-L\" (landscape) or \"-P\" (portrait). No " "suffix defaults to portrait." msgstr "" "フォーマット名は、文字列として指定する必要があります（大文字小文字を区別しない）。オプションで \" -L\"（横向き）または \" " "-P\"（縦向き）でサフィックスを付けることができます。サフィックスが指定されていない場合、デフォルトは縦向きです。" #: ../../functions.rst 0859ddc790de48e98a47485cde669401 #: 09aae792d39a4719b5feaf0ab83fff20 19bfd0356987458d83477865a5d1a227 #: 49070de6bbd648339c39152b16917361 5abb2b0067e04d25a6a480258935ec7b #: 64942c1bcabb4af8b61d6c1763fa9ec1 7e3314757aad4fc1a94940b29ca6827c #: 813511b4bfb04affbe03c50f1c74e9c8 82b50464d79647069ebf77eb5eaa2f72 #: 89cb96a7503f42ea8e5af77eae2653a1 92ffa13c8ae94cb2b2fa323e85adf355 #: 99b800f8ef394726a8cf31b1e64c2e16 9d31e1e684094f7b843f37fca583e403 #: 9fd573cd7d544e0aa4901376821e273b a1c3d38ad8b348718a4c58ba8de0d1f6 #: a36d22d544834da3858edb86ef6f1644 ac8c99d18c2b4b9bb781c6f88660d86b #: b6d2ba4ce7ea4aeda4dcafbeb54f8f0d b770518ae6a749dbb83e9e8e640a10ee #: cd5810abe8154ef1bb614e2940eece1a f11cee020a504c72a63ce27fbbd09651 #: fa237829f2624242ba676a501a682730 fe1aebb4ec3b40bd940fea19abc2ba9f msgid "Parameters" msgstr "" #: ../../functions.rst:84 58f6fc5980274479b8466f9943b239a0 msgid "" "any format name from above in upper or lower case, like *\"A4\"* or " "*\"letter-l\"*." msgstr "" "上記のいずれかのフォーマット名を大文字または小文字で指定します。たとえば、*\"A4\"* または *\"letter-l\"* " "のように指定します。" #: ../../functions.rst 03f1fe2e5c3943e183598885bc51d1dc #: 1857900ce17a4569876c842ed42c6268 20b469d28e6e4ef18b3176a5e74627d3 #: 20f0ad032864401e8e11b10c90f9c24b 27537b59f5694129a544cd09ee1e4957 #: 2e112e3af1b74659bdb9c43d7db12a74 3062eec0ad0247d28f2f532f9cd5cce4 #: 51bd37f77a214f6a8d3c6918723b9eea 5a94a14aae9b4984be7e3591cb6101df #: 6b1952aa0aa84cbe8c865623124268ab 6cf6024e798045079d4c6551e3a7b175 #: 8bbd1c084844464088dab98f7d9f4965 9caea92222fe4cdc8432df38e26f83c6 #: acae4a31653a4d72b4a2e701c6c059b0 ad60dbf189334ee5a807f1faec163c26 #: b13938ce54e342d49bb6ee61f3927459 bd9c2eff50e34f239e7589f9e6ad949c #: d3cd059ede494646bac809314f2a7aa3 dedeff11b7fe409fa341704aee20d714 #: f446e807ba984edf862a261ccd18ee92 f661f3aea2174106b4f7c07557d2937d #: fcea4521481d45bb8138e2bc86f57dd6 fd35d8681ef34d8882c8131bfbb9325f #: ffae2284aadc4ea5b7ce903b300110e5 msgid "Return type" msgstr "" #: ../../functions.rst 241f189d177b4abe8781c1323a0ec686 #: 269469e84adb406bba0203eeb27db4ea 3002f251a3b34a938e7f3b2d8ff54f55 #: 393bd2c99abb435c9096087b1340609a 4c3f97315cf04d0891ea76a1bc4cdec7 #: 4ce3f7bf85464affb653fdc3cde40999 4d87d3c54e3f482fbeae0695ccae2f3d #: 54eed5b94cd8484089e327a49e09c976 6b22f8b9a6ca4d4cbc8cc4d236263067 #: 7c586b43f1e2413b82c7aec73497ad09 7d42f6afd5844f1caca525f80b3c1328 #: 8bc58d3f2fc9447e98d7349da31213de a168611b4d644084a80c9ebf51127c66 #: a636bdbee8ca4bb993b51dab8564eb04 afce09bb4d3e4e5dad5ccfaa3e62395a #: b4b81ec6ce2548c6a66b0675d31bd1d6 b7e7fb7a4c2747b1adf7a8583f8654c4 #: b8cab8292e6e4f3ea1b79e200dca449d be0506cde75249c5b7cf35d1ae34c87d #: c02e22251e0c496c99819e2bbfd566f2 e1d0fe254797467e8a7b7fe3ea0ae483 #: e1de8b977cf8465eb45cad2ef5f5e0dd eb4281b814a647efb2ad231baf1ca7ae #: f468fa01ceb94ad8ac3451a68a33ae39 fda237d8691b4a959eeca8fe09b6bbae msgid "Returns" msgstr "" #: ../../functions.rst:87 b4296412402b46a4965f9ad12430f3a5 msgid "" "*(width, height)* of the paper format. For an unknown format *(-1, -1)* " "is returned. Examples: *pymupdf.paper_size(\"A4\")* returns *(595, 842)* " "and *pymupdf.paper_size(\"letter-l\")* delivers *(792, 612)*." msgstr "" "用紙フォーマットの *(幅、高さ)*。不明なフォーマットの場合、(-1、-1) " "が返されます。例：*pymupdf.paper_size(\"A4\")* は (595、842) " "を返し、*pymupdf.paper_size(\"letter-l\")* は *(792、612)* を返します。" #: ../../functions.rst:93 5b13894197174f5b9b605cf39be91764 msgid "Convenience function to return a :ref:`Rect` for a known paper format." msgstr "既知の紙のフォーマットに対応する :ref:`Rect` を返す便益関数です。" #: ../../functions.rst:95 2b01808a6f984885ad72685e42b6ba34 msgid "any format name supported by :meth:`paper_size`." msgstr ":meth:`paper_size` でサポートされている任意のフォーマット名。" #: ../../functions.rst:97 398230d02c1a4139a2c25e15afd00441 msgid ":ref:`Rect`" msgstr "" #: ../../functions.rst:98 3bcbeafd12094f66b7da10fbb6e44d13 msgid "" "*pymupdf.Rect(0, 0, width, height)* with *width, " "height=pymupdf.paper_size(s)*." msgstr "" #: ../../functions.rst:109 dfd4fa5a7ed645d687e1add0d26f8fd9 msgid "" "Sets destination of |PyMuPDF| messages to a file descriptor, a file, an " "existing stream or `Python's logging system " "`_." msgstr "" #: ../../functions.rst:113 7ca7d103b38f48e6807607f1b5fb4e04 msgid "Usually one would only set one arg, or one or more `pylogging*` args." msgstr "" #: ../../functions.rst:115 d3110ebcfa014f9a9e9dffbfb07b8429 msgid "" "A text specification of destination; for details see description of " "environmental variable `PYMUPDF_MESSAGE`." msgstr "" #: ../../functions.rst:118 f2568fbdee6a469e86d30e697b54e228 msgid "Write to file descriptor." msgstr "" #: ../../functions.rst:120 3005a922a0bd4a02926e0a5b40014183 msgid "" "Write to existing stream, which must have methods `.write(text)` and " "`.flush()`." msgstr "" #: ../../functions.rst:123 7bae0338bdf7484c9e843251d5c4268e msgid "Write to a file." msgstr "" #: ../../functions.rst:125 629d6fa80e1140f48a18cd82a8d2631d msgid "Append to a file." msgstr "" #: ../../functions.rst:127 af3dad1d6ce942b8bc8207879fb6e153 msgid "Write to Python's `logging` system." msgstr "" #: ../../functions.rst:129 edef27de299d43b580f0142468f71ade msgid "Write to Python's `logging` system using specified Logger." msgstr "" #: ../../functions.rst:131 97f0f14a9c6543069de109bdaa320698 msgid "Write to Python's `logging` system using specified level." msgstr "" #: ../../functions.rst:133 54a6240e34794f1d8f029e59eef09948 msgid "" "Write to Python's `logging` system using specified logger name. Only used" " if `pylogging_logger` is ``None``. Default is `pymupdf`." msgstr "" #: ../../functions.rst:137 7fc3645c02074a4aa4ff724cf1ab0856 msgid "" "If any `pylogging*` arg is not ``None``, we write to `Python's logging " "system `_." msgstr "" #: ../../functions.rst:144 ../../functions.rst:156 ../../functions.rst:270 #: 70ea9f075bbc45bc9f22e2b8a925f0c2 d9fd6097dd8642d681771c59c34ec163 #: e3bdeda869f54aae9ed48140bfa9aa51 msgid "*New in v1.17.4*" msgstr "*バージョン1.17.4で新たに追加*" #: ../../functions.rst:146 0aa93594a530468e84df8471d05d150d msgid "" "Convenience function returning a PDF color triple (red, green, blue) for " "a given sRGB color integer as it occurs in :meth:`Page.get_text` " "dictionaries \"dict\" and \"rawdict\"." msgstr "" ":meth:`Page.get_text` の辞書 \"dict\" および \"rawdict\" に存在する与えられた sRGB " "カラー整数に対して、PDF カラーのトリプル（赤、緑、青）を返す便益関数です。" #: ../../functions.rst:148 ../../functions.rst:160 #: 864b3d47658d4c118df2f33b9208300f 8b645478645441eebd77be6157685571 msgid "" "an integer of format RRGGBB, where each color component is an integer in " "range(255)." msgstr "各カラーコンポーネントが範囲[0, 255]の整数である RRGGBB 形式の整数。" #: ../../functions.rst:150 87564fe0c411497099602ced50913c18 msgid "" "a tuple (red, green, blue) with float items in interval *0 <= item <= 1* " "representing the same color. Example `sRGB_to_pdf(0xff0000) = (1, 0, 0)` " "(red)." msgstr "" "*0 <= item <= 1* " "の間の浮動小数点数アイテムを持つタプル（赤、緑、青）で、同じカラーを表します。例：`sRGB_to_pdf(0xff0000) = (1, 0, " "0)` （赤）。" #: ../../functions.rst:158 33afb580cfbe4b5fb5fed85569086eeb msgid "" "Convenience function returning a color (red, green, blue) for a given " "*sRGB* color integer." msgstr "与えられた *sRGB* カラー整数に対して、カラー（赤、緑、青）を返す便益関数です。" #: ../../functions.rst:162 99b662fe46f9469682b0a7ec89eed460 msgid "" "a tuple (red, green, blue) with integer items in `range(256)` " "representing the same color. Example `sRGB_to_pdf(0xff0000) = (255, 0, " "0)` (red)." msgstr "" "整数アイテムが `range(256)` の範囲にある、同じ色を表すタプル（赤、緑、青）。例： `sRGB_to_pdf(0xff0000) = " "(255, 0, 0)` （赤）" #: ../../functions.rst:168 ../../functions.rst:183 ../../functions.rst:198 #: ../../functions.rst:211 79490e25884e4b379b80f56b00625d5c #: 8802b9dd8e1644918618883055d9afaf 8d692f79ec3d47b5a19c94c7e7f90981 #: cc00fcf3f3834541862d9a786318f32f msgid "*New in v1.18.0*" msgstr "*バージョン1.18.0で新たに追加*" #: ../../functions.rst:170 5ba3d698e66646eeba96e992e95fc235 msgid "" "Return the unicode number of a glyph name based on the **Adobe Glyph " "List**." msgstr "**Adobe Glyph List** に基づくグリフ名のUnicode番号を返す関数です。" #: ../../functions.rst:172 bdb4dabbf07a42e1b2aaa60fafc3f6a5 msgid "" "the name of some glyph. The function is based on the `Adobe Glyph List " "`_." msgstr "" "グリフの名前。この関数は `Adobe Glyph List `_ に基づいています。" #: ../../functions.rst:175 7f83c8a40f1f4f5182386d25b2900e70 #, fuzzy msgid "the unicode. Invalid ``name`` entries return `0xfffd (65533)`." msgstr "Unicode番号。無効な *name* のエントリは `0xfffd (65533)` を返します。" #: ../../functions.rst:177 ../../functions.rst:205 ../../functions.rst:218 #: 06e18a271eb844ff8ee1fc0870be4fb8 d7d9853398734fcbb59570519db66ef3 #: e5f542bf904c4baf92ddadf03e7802e6 msgid "" "A similar functionality is provided by package `fontTools " "`_ in its *agl* sub-package." msgstr "" "同様の機能は、`fontTools `_ パッケージの *agl* " "サブパッケージで提供されています。" #: ../../functions.rst:185 9c9f41d26b6f44d5a0675c56c191b7b5 msgid "" "Return the glyph name of a unicode number, based on the **Adobe Glyph " "List**." msgstr "以下は、**Adobe Glyph List** に基づいた、Unicode番号に基づいたグリフ名を返す関数です。" #: ../../functions.rst:187 3efb1935917c44828cdb74dd8e802d39 #: a7cc8fab866e446fb5d9bd91531a6e33 msgid "" "the unicode given by e.g. `ord(\"ß\")`. The function is based on the " "`Adobe Glyph List `_." msgstr "" "Unicode番号、例：`ord(\"ß\")` によって与えられます。この関数は `Adobe Glyph List " "`_ に基づいています。" #: ../../functions.rst:190 5176a1a461ef43a1bfbefacc552c8a8b msgid "" "the glyph name. E.g. `pymupdf.unicode_to_glyph_name(ord(\"Ä\"))` returns " "`'Adieresis'`." msgstr "グリフ名、例：`pymupdf.unicode_to_glyph_name(ord(\"Ä\"))` は `'Adieresis'` を返します。" #: ../../functions.rst:192 2d968ce1f4004533b122972fdbbabdf7 msgid "" "A similar functionality is provided by package `fontTools " "`_: in its *agl* sub-package." msgstr "" "類似の機能は、`fontTools `_ パッケージの *agl* " "サブパッケージで提供されています。" #: ../../functions.rst:200 cdc27cc2524340f49b6cc45e587c802c msgid "Return a list of glyph names defined in the **Adobe Glyph List**." msgstr "**Adobe Glyph List** で定義されたグリフ名のリストを返します。" #: ../../functions.rst:203 2fd087c0315e407ea96067edc1c4393c msgid "list of strings." msgstr "文字列のリスト。" #: ../../functions.rst:213 a02dfb86773a455382f6a6c0268d3499 msgid "" "Return a list of unicodes for there exists a glyph name in the **Adobe " "Glyph List**." msgstr "**Adobe Glyph List** にグリフ名が存在するUnicodeのリストを返します。" #: ../../functions.rst:216 b7378500b7af448d86db01202a45986c msgid "list of integers." msgstr "整数のリスト。" #: ../../functions.rst:224 44322f42c7554831ac045bccb97dbc3c msgid "*New in v1.21.0*" msgstr "*新機能 v1.21.0*" #: ../../functions.rst:226 24ae3761fb07422393846de0c9c3fa88 msgid "**Utility function for use with \"Story\" applications.**" msgstr "**\"Story\" アプリケーションで使用するためのユーティリティ関数。**" #: ../../functions.rst:228 fd42be5d92474036bd944ca8660478de msgid "" "Create CSS `@font-face` items for the given fontcode in pymupdf-fonts. " "Creates a CSS font-family for all fonts starting with string " "\"fontcode\"." msgstr "" "指定された \"fontcode\" に対して CSS `@font-face` アイテムを作成します。文字列 \"fontcode\" " "で始まるすべてのフォント用に CSS font-family を作成します。" #: ../../functions.rst:230 a814b536199949e891f96f03e13d68a2 msgid "" "The font naming convention in package pymupdf-fonts is \"fontcode\", " "where the suffix \"sf\" is one of \"\" (empty), \"it\"/\"i\", " "\"bo\"/\"b\" or \"bi\". These suffixes thus represent the regular, " "italic, bold or bold-italic variants of that font." msgstr "" "パッケージ pymupdf-fonts でのフォントの命名規則は \"fontcode\" で、サフィックス \"sf\" " "は（空白）、\"it\"、\"i\"、\"bo\"、\"b\"、\"bi\" " "のいずれかです。したがって、これらのサフィックスは、フォントの通常の、イタリックの、太字の、太字イタリックのバリアントを表します。" #: ../../functions.rst:232 ee523a99cc234e859fb1a6cabd4448c4 msgid "For example, font code \"notos\" refers to fonts" msgstr "例えば、フォントコード \"notos\" は以下のフォントに対応します。" #: ../../functions.rst:234 1624cd3ce5cb41d68b00cfbdefbab550 msgid "\"notos\" - \"Noto Sans Regular\"" msgstr "" #: ../../functions.rst:235 b5bfb596ccb74dcf835b39d8f7d13881 msgid "\"notosit\" - \"Noto Sans Italic\"" msgstr "" #: ../../functions.rst:236 f4b764ed2d584d8893bf0b2de910b9cf msgid "\"notosbo\" - \"Noto Sans Bold\"" msgstr "" #: ../../functions.rst:237 a8b2daa11b7845f3bed1ce18440ef016 msgid "\"notosbi\" - \"Noto Sans Bold Italic\"" msgstr "" #: ../../functions.rst:239 cb8e8390629f4d188e7e1dbc5af60b03 msgid "" "The function creates (up to) four CSS `@font-face` definitions and " "collectively assigns the `font-family` name \"notos\" to them (or the " "\"name\" value if provided). Associated font buffers are placed / added " "to the provided archive." msgstr "" "この関数は（最大で）4つの CSS `@font-face` 定義を作成し、それらに `font-family` 名 " "\"notos\"（または指定された \"name\" " "の値）を割り当てます。関連するフォントバッファは提供されたアーカイブに配置されます/追加されます。" #: ../../functions.rst:241 b1578620590c4d49a662b6873f7c33e7 msgid "" "To use the font in the Python API for :ref:`Story`, execute " "`.set_font(fontcode)` (or \"name\" if given). The correct font weight or " "style will automatically be selected as required." msgstr "" ":ref:`Story` の Python API でフォントを使用するには、`.set_font(fontcode)`（または指定した場合は " "\"name\"）を実行します。必要に応じて正しいフォントウェイトまたはスタイルが自動的に選択されます。" #: ../../functions.rst:243 5c4c7320f1f8400e924e56c72a17c2c3 msgid "" "For example to replace the \"sans-serif\" HTML standard (i.e. Helvetica) " "with the above \"notos\", execute the following. Whenever \"sans-serif\" " "is used (whether explicitly or implicitly), the Noto Sans fonts will be " "selected." msgstr "" "たとえば、上記の \"notos\" で \"sans-serif\" HTML 標準（Helvetica）を置き換えるには、次のように実行します" "。\"sans-serif\" が使用される場合（明示的にまたは暗黙的に）、Noto Sans フォントが選択されます。" #: ../../functions.rst:245 3ab4384a20d149669910ef03ad792c3a msgid "" "`CSS = pymupdf.css_for_pymupdf_font(\"notos\", name=\"sans-serif\", " "archive=...)`" msgstr "" #: ../../functions.rst:247 3206db2b9e4548d9873d135de0833c62 msgid "Expects and returns the CSS source, with the new CSS definitions appended." msgstr "CSS ソースが期待されており、新しい CSS 定義が追加されています。" #: ../../functions.rst:249 a2d622ad8ee347cdbf24cf65b46dd835 msgid "" "one of the font codes present in package `pymupdf-fonts " "`_ (usually) representing the " "regular version of the font family." msgstr "" "`pymupdf-fonts `_ " "パッケージに存在するフォントファミリーの通常バージョンを表す、フォントコード。" #: ../../functions.rst:250 3e43aa6f3cb7415c856593e0c2009f4d msgid "" "any already existing CSS source, or `None`. The function will append its " "new definitions to this. This is the string that **must be used** as " "`user_css` when creating the :ref:`Story`." msgstr "" "既存の CSS ソース、または `None`。新しい定義はこれに追加されます。これは :ref:`Story` を作成する際に " "`user_css` として **使用する必要がある** 文字列です。" #: ../../functions.rst:251 96d99d7375ed4394a4e5ec1661857dde msgid "" ":ref:`Archive`, **mandatory**. All font binaries (i.e. up to four) found " "for \"fontcode\" will be added to the archive. This is the archive that " "**must be used** as `archive` when creating the :ref:`Story`." msgstr "" ":ref:`Archive`、**必須** です。\"fontcode\" " "に対して見つかるすべてのフォントバイナリ（最大で4つ）がアーカイブに追加されます。これは :ref:`Story` を作成する際に " ":ref:`Archive` として**使用する必要があります** 。" #: ../../functions.rst:252 efd7cc2ac7184a718e3bdc84648becc0 msgid "" "the name under which the \"fontcode\" fonts should be found. If omitted, " "\"fontcode\" will be used." msgstr "\"fontcode\" フォントが見つかる名前。省略した場合、\"fontcode\" が使用されます。" #: ../../functions.rst:255 d17bb0f3f24845159c50104934ef2fc9 msgid "" "Modified CSS, with appended `@font-face` statements for each font variant" " of fontcode. Fontbuffers associated with \"fontcode\" will have been " "added to 'archive'. The function will automatically find up to 4 font " "variants. All pymupdf-fonts (that are no special purpose like math or " "music, etc.) have regular, bold, italic and bold-italic variants. To see " "currently available font codes check " "`pymupdf.fitz_fontdescriptors.keys()`. This will show something like " "`dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', " "'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', " "'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', " "'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', " "'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])`." msgstr "" "変更された CSS。\"fontcode\" の各フォントバリアントに対して追加された `@font-face` " "ステートメントを含みます。関連する pymupdf-fonts のフォントバッファが 'archive' に追加されます。関数は最大で 4 " "つのフォントバリアントを自動的に見つけます。現在利用可能なフォントコードを確認するには、`pymupdf.fitz_fontdescriptors.keys()`" " を使用します。これにより、`dict_keys(['cascadia', 'cascadiai', 'cascadiab', " "'cascadiabi', 'figbo', 'figo', 'figbi', 'figit', 'fimbo', 'fimo', " "'spacembo', 'spacembi', 'spacemit', 'spacemo', 'math', 'music', " "'symbol1', 'symbol2', 'notosbo', 'notosbi', 'notosit', 'notos', 'ubuntu'," " 'ubuntubo', 'ubuntubi', 'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', " "'ubuntmit'])` のようなものが表示されます。" #: ../../functions.rst:257 9c918c7741a8450fadc38bb8e6d8248e msgid "" "Here is a complete snippet for using the \"Noto Sans\" font instead of " "\"Helvetica\"::" msgstr "以下は \"Helvetica\" の代わりに \"Noto Sans\" フォントを使用する完全なスニペットです::" #: ../../functions.rst:272 b6bf01dfadf043f89d73dc2362986d56 #, fuzzy msgid "" "Convenience function to split a rectangle into sub-rectangles of equal " "size. Returns a list of `rows` lists, each containing `cols` :ref:`Rect` " "items. Each sub-rectangle can then be addressed by its row and column " "index." msgstr "" "矩形をサブ矩形に分割するための関数です。*行* のリストを含むリストを返し、各リストには指定された *列数* の :ref:`Rect` " "アイテムが含まれています。各サブ矩形はその行と列のインデックスでアクセスできます。" #: ../../functions.rst:274 2379b768d70b429e80b9ee76ff6affc6 msgid "the rectangle to split." msgstr "分割する矩形。" #: ../../functions.rst:275 bc2cff2237ae4cc2b772925cc341db0f msgid "the desired number of columns." msgstr "列の数。" #: ../../functions.rst:276 bb04dcac38e94e4ea02e6ce480164b8f msgid "the desired number of rows." msgstr "行の数。" #: ../../functions.rst:277 afead5470e7e4b4ba96f6b47fa94c27f msgid "" "a list of :ref:`Rect` objects of equal size, whose union equals *rect*. " "Here is the layout of a 3x4 table created by `cell = " "pymupdf.make_table(rect, cols=4, rows=3)`:" msgstr "" "等しいサイズの :ref:`Rect` オブジェクトのリストで、それらの合併は元の *rect* と同じです。たとえば、`cell = " "pymupdf.make_table(rect, cols=4, rows=3)` によって作成された 3x4 " "のテーブルのレイアウトは次のようになります：" #: ../../functions.rst:287 3cf17d4592c24625a3c0f8b4ccf257b9 msgid "New in version 1.16.2)*" msgstr "*バージョン1.16.2で新たに導入されました。*" #: ../../functions.rst:289 3de02919aba44c58882ea49db6a70ca4 msgid "" "Return a matrix which maps the line from p1 to p2 to the x-axis such that" " p1 will become (0,0) and p2 a point with the same distance to (0,0)." msgstr "p1からp2への直線をx軸にマッピングする行列を返します。その際、p1は(0,0)になり、p2は(0,0)から同じ距離に配置されるように変換されます。" #: ../../functions.rst:291 d5051adab1c74eff8ca8bbcac46881e6 msgid "starting point of the line." msgstr "直線の始点。" #: ../../functions.rst:292 0739796326eb427b8251e930406ec398 msgid "end point of the line." msgstr "直線の終点。" #: ../../functions.rst:294 b3f32ee30e7e408ea53d346c946793b4 msgid ":ref:`Matrix`" msgstr "" #: ../../functions.rst:295 80f96c88c5c54adb87efd7e63247f4cf msgid "" "a matrix which combines a rotation and a translation:: >>> p1 = " "pymupdf.Point(1, 1) >>> p2 = pymupdf.Point(4, 5) >>> abs(p2 - p1) " "# distance of points 5.0 >>> m = pymupdf.planish_line(p1, p2) " ">>> p1 * m Point(0.0, 0.0) >>> p2 * m Point(5.0, " "-5.960464477539063e-08) >>> # distance of the resulting points >>> " "abs(p2 * m - p1 * m) 5.0 .. image:: images/img-planish.png " ":scale: 40" msgstr "" #: ../../functions.rst:295 85ea149f226e4e2ca4d42190a34693e5 msgid "a matrix which combines a rotation and a translation::" msgstr "回転と平行移動を組み合わせた行列::" #: ../../functions.rst:319 d7085018534f47e2b428476e6d18257b msgid "" "A dictionary of pre-defines paper formats. Used as basis for " ":meth:`paper_size`." msgstr "あらかじめ定義された用紙フォーマットの辞書。:meth:`paper_size` の基盤として使用されます。" #: ../../functions.rst:325 1100f2cd223244e098a59cab294695cd msgid "New in v1.17.5" msgstr "バージョン1.17.5で新たに導入されました" #: ../../functions.rst:327 611b74fc7f2f49e7be426fe3db89be8f msgid "" "A dictionary of usable fonts from repository `pymupdf-fonts " "`_. Items are keyed by their " "reserved fontname and provide information like this::" msgstr "" "`pymupdf-fonts `_ " "リポジトリから使用可能なフォントの辞書。アイテムは予約されたフォント名でキー付けされ、以下のような情報を提供します::" #: ../../functions.rst:343 43582b0da1f84beba44a5e36e2cdd048 msgid "If `pymupdf-fonts` is not installed, the dictionary is empty." msgstr "`pymupdf-fonts` がインストールされていない場合、この辞書は空です。" #: ../../functions.rst:345 5c5c8927cd35468f8b40e91051754525 msgid "" "The dictionary keys can be used to define a :ref:`Font` via e.g. `font = " "pymupdf.Font(\"fimo\")` -- just like you can do it with the builtin fonts" " \"Helvetica\" and friends." msgstr "" "辞書のキーは、例えば `font = pymupdf.Font(\"fimo\")` " "のように使用してフォントを定義できます。これは、組み込みのフォント \"Helvetica\" やその他のフォントと同様に行うことができます。" #: ../../functions.rst:351 829280be90364ab59d34ab8bcb9ee3a5 msgid "" "If in `os.environ` when |PyMuPDF| is imported, sets destination of " "|PyMuPDF| messages. Otherwise messages are sent to `sys.stdout`." msgstr "" #: ../../functions.rst:355 2a7234b598ca4be78a6ed7fd2cd0e68b msgid "" "If the value starts with `fd:`, the remaining text should be an integer " "file descriptor to which messages are written." msgstr "" #: ../../functions.rst:358 52dfedc05920490596eb9bb364ca70ad msgid "For example `PYMUPDF_MESSAGE=fd:2` will send messages to stderr." msgstr "" #: ../../functions.rst:360 c2c608b9dd754c2095660836dded1873 msgid "" "If the value starts with `path:`, the remaining text is the path of a " "file to which messages are written. If the file already exists, it is " "truncated." msgstr "" #: ../../functions.rst:364 f8a67537ff5540058906057a31801f10 msgid "" "If the value starts with `path+:`, the remaining text is the path of file" " to which messages are written. If the file already exists, we append " "output." msgstr "" #: ../../functions.rst:369 a97a4cc6ac8941099d31bee564b661d6 msgid "" "If the value starts with `logging:`, messages are written to `Python's " "logging system `_. The " "remaining text can contain comma-separated name=value items:" msgstr "" #: ../../functions.rst:373 85f8ee63e7c242de87aa78d6da95ec89 msgid "`level=` sets the logging level." msgstr "" #: ../../functions.rst:374 ced54a7765f14a2c90cc9b941ac3cdaf msgid "`name=` sets the logger name (default is `pymupdf`)." msgstr "" #: ../../functions.rst:376 79d9e976d47c48d2b2f5d924b71d2bdd msgid "Other items are ignored." msgstr "" #: ../../functions.rst:378 e6049a9e63db495e951e0a96d3dbe162 msgid "Other prefixes will cause an error." msgstr "" #: ../../functions.rst:380 cea43b4378c542439ade76acf38cef95 msgid "Also see `set_messages()`." msgstr "" #: ../../functions.rst:387 d33f434c014340318a8b4f2408cf37ee msgid "New in v1.19.6" msgstr "バージョン1.19.6で新たに導入されました" #: ../../functions.rst:389 2d49cc1b71804cc6add57d8ac8aeeb40 msgid "" "Contains about 500 RGB colors in PDF format with the color name as key. " "To see what is there, you can obviously look at " "`pymupdf.pdfcolor.keys()`." msgstr "" "PDF形式の約500個のRGB色が、色の名前をキーとして含まれています。中身を確認するには、`pymupdf.pdfcolor.keys()` " "を見ることができます。" #: ../../functions.rst:391 210b4f32e51c447c920aa1e17090177d msgid "Examples:" msgstr "例：" #: ../../functions.rst:393 78b6aa54c3d8499c933344b9d67aa935 msgid "`pymupdf.pdfcolor[\"red\"] = (1.0, 0.0, 0.0)`" msgstr "" #: ../../functions.rst:394 25976b6b069c4a278c407ca0a6e0dd34 msgid "" "`pymupdf.pdfcolor[\"skyblue\"] = (0.5294117647058824, 0.807843137254902, " "0.9215686274509803)`" msgstr "" #: ../../functions.rst:395 036d984bb9494bfb970022074689d37d msgid "" "`pymupdf.pdfcolor[\"wheat\"] = (0.9607843137254902, 0.8705882352941177, " "0.7019607843137254)`" msgstr "" #: ../../functions.rst:401 8e917a8067e94f15b90b52ee3016acc1 msgid "" "Convenience function to return the current local timestamp in PDF " "compatible format, e.g. *D:20170501121525-04'00'* for local datetime May " "1, 2017, 12:15:25 in a timezone 4 hours westward of the UTC meridian." msgstr "" "PDF互換の形式で現在のローカルタイムスタンプを返す便利な関数です。例: " "ローカルの日付と時刻が2017年5月1日12時15分25秒で、UTC子午線の西4時間のタイムゾーンにある場合、*D:20170501121525-04’00’*" " となります。" #: ../../functions.rst:404 f9d2422e60aa4b95b2387399f8819412 msgid "current local PDF timestamp." msgstr "現在のローカルPDFタイムスタンプ。" #: ../../functions.rst:410 7c48f1b5388547b9847fe88c7fbcd18a msgid "New in version 1.14.7" msgstr "バージョン1.14.7で新規追加" #: ../../functions.rst:412 64c91a6941404cf293748277c1e40776 msgid "" "Calculate the length of text on output with a given **builtin** font, " ":data:`fontsize` and encoding." msgstr "指定された *組み込み* フォント、:data:`fontsize` 、およびエンコーディングで出力されるテキストの長さを計算します。" #: ../../functions.rst:414 1b351f62d3ce47ba820d95770c3b7ccf msgid "the text string." msgstr "テキスト文字列。" #: ../../functions.rst:415 7a65fc2611854e61ae76f3d30079961a #, fuzzy msgid "" "the font name. Must be one of either the :ref:`Base-14-Fonts` or the CJK " "fonts, identified by their \"reserved\" fontnames (see table in " ":meth:`Page.insert_font`)." msgstr "" "フォント名。:ref:`Base-14-Fonts` " "またはCJKフォントのいずれかでなければなりません。これらは「予約済み」フォント名で識別されます（:meth:`Page.insert_font`" " のテーブルを参照）。" #: ../../functions.rst:416 932954ed0adf44ef9900d8f882a388e7 msgid "the :data:`fontsize`." msgstr ":data:`fontsize`。" #: ../../functions.rst:417 d499111356cf4e9081c8c3c2912a57bd msgid "" "the encoding to use. Besides 0 = Latin, 1 = Greek and 2 = Cyrillic " "(Russian) are available. Relevant for Base-14 fonts \"Helvetica\", " "\"Courier\" and \"Times\" and their variants only. Make sure to use the " "same value as in the corresponding text insertion." msgstr "" "使用するエンコーディング。0 = ラテン、1 = ギリシャ、2 = " "キリル文字（ロシア語）が利用可能です。ベース14フォント「Helvetica」、「Courier」、「Times」とそのバリアントにのみ関連します。対応するテキスト挿入で使用する値と同じ値を使用してください。" #: ../../functions.rst:419 9120edd3ebae44b4acc13d6f9de3fc03 msgid "" "the length in points the string will have (e.g. when used in " ":meth:`Page.insert_text`)." msgstr "文字列が持つポイント単位の長さ（たとえば、:meth:`Page.insert_text` で使用する場合）。" #: ../../functions.rst:421 79cef2d8477740418dbe285f8a7e7d06 msgid "" "This function will only do the calculation -- it won't insert font nor " "text." msgstr "この関数は計算のみを行います - フォントまたはテキストを挿入しません。" #: ../../functions.rst:423 00b63292efa741d3a51b9a25802baf30 msgid "" "The :ref:`Font` class offers a similar method, :meth:`Font.text_length`, " "which supports Base-14 fonts and any font with a character map (CMap, " "Type 0 fonts)." msgstr "" ":ref:`Font` クラスは、Base-14フォントおよび文字マップ（CMap、Type " "0フォントをサポートする任意のフォントに対応した似たようなメソッド :meth:`Font.text_length` を提供しています。" #: ../../functions.rst:425 cfcfc76eb218486fa8b032c6c50ab81e msgid "" "If you use this function to determine the required rectangle width for " "the (:ref:`Page` or :ref:`Shape`) *insert_textbox* methods, be aware that" " they calculate on a **by-character level**. Because of rounding effects," " this will mostly lead to a slightly larger number: " "*sum([pymupdf.get_text_length(c) for c in text]) > " "pymupdf.get_text_length(text)*. So either (1) do the same, or (2) use " "something like *pymupdf.get_text_length(text + \"'\")* for your " "calculation." msgstr "" "この関数を使用して（:ref:`Page` または :ref:`Shape`）*insert_textbox* " "メソッドの必要な矩形の幅を決定する場合、**文字単位で** " "計算されることに注意してください。丸め効果のため、これはほとんどの場合、やや大きな数になります：*sum([pymupdf.get_text_length(c)" " for c in text]) > " "pymupdf.get_text_length(text)*。したがって、（1）同じことを行うか、（2）計算に " "*pymupdf.get_text_length(text + \"’\")* のようなものを使用してください。" #: ../../functions.rst:431 763b708ba6ae4ddab04cf7af4a0c1d41 msgid "" "Make a PDF-compatible string: if the text contains code points *ord(c) > " "255*, then it will be converted to UTF-16BE with BOM as a hexadecimal " "character string enclosed in \"<>\" brackets like **. Otherwise," " it will return the string enclosed in (round) brackets, replacing any " "characters outside the ASCII range with some special code. Also, every " "\"(\", \")\" or backslash is escaped with a backslash." msgstr "" "PDF互換の文字列を作成します。テキストに含まれる文字のコードポイントが *ord(c) > 255* の場合、それはUTF-" "16BEに変換され、BOMが含まれた16進数の文字列で \"<>\" " "ブラケットで囲まれます。それ以外の場合は、ASCII範囲外の文字を特別なコードで置き換えて、（丸い）カッコで囲まれた文字列が返されます。また、すべての" " \"(\", \")\", またはバックスラッシュはバックスラッシュでエスケープされます。" #: ../../functions.rst:433 c2b249b32f5f45e889b055dec35c3b1c msgid "the object to convert" msgstr "変換するオブジェクト" #: ../../functions.rst:436 1acb62d7d240428ab032edcf601996ca msgid "PDF-compatible string enclosed in either *()* or *<>*." msgstr "*()* または *<>* で囲まれたPDF互換の文字列。" #: ../../functions.rst:442 702d8585021a43eba297b69d4836db1d msgid "New in v1.16.7" msgstr "バージョン1.16.7で新規追加" #: ../../functions.rst:443 d731f027bad84dc4a0c0fa97dddbc2ba msgid "" "Changed in v1.19.5: also return natural image orientation extracted from " "EXIF data if present." msgstr "バージョン1.19.5で変更：EXIFデータから抽出した自然な画像の向きも返すように変更されました。" #: ../../functions.rst:444 27b180112c374ac4a920954d1634ef4d msgid "" "Changed in v1.22.5: always return `None` in error cases instead of an " "empty dictionary." msgstr "バージョン1.22.5で変更：エラーケースで空の辞書ではなく、常に `None` を返すように変更されました。" #: ../../functions.rst:446 9803cc75c9f044399d2dda1e316afe12 msgid "" "Show important properties of an image provided as a memory area. Its main" " purpose is to avoid using other Python packages just to determine them." msgstr "メモリ領域として提供される画像の重要なプロパティを表示します。主な目的は、これらのプロパティを決定するために他のPythonパッケージを使用しないようにすることです。" #: ../../functions.rst:448 fdf0ee2300ce40418b494c923b925202 msgid "" "either an image in memory or an **opened** file. An image in memory may " "be any of the formats `bytes`, `bytearray` or `io.BytesIO`." msgstr "" "メモリ内の画像または **開いた** ファイル。メモリ内の画像は、`bytes`、`bytearray`、または `io.BytesIO` " "形式のいずれかです。" #: ../../functions.rst:451 fe8ea596a2524046aa4127a94283a123 msgid "" "No exception is ever raised. In case of an error, `None` is returned. " "Otherwise, there are the following items:: In [2]: " "pymupdf.image_profile(open(\"nur-ruhig.jpg\", \"rb\").read()) Out[2]:" " {'width': 439, 'height': 501, 'orientation': 0, # natural " "orientation (from EXIF) 'transform': (1.0, 0.0, 0.0, 1.0, 0.0, 0.0), " "# orientation matrix 'xres': 96, 'yres': 96, 'colorspace': 3," " 'bpc': 8, 'ext': 'jpeg', 'cs-name': 'DeviceRGB'} There is the " "following relation to **Exif** information encoded in `orientation`, and " "correspondingly in the `transform` matrix-like (quoted from MuPDF " "documentation, *ccw* = counter-clockwise): 0. Undefined 1. 0 " "degree ccw rotation. (Exif = 1) 2. 90 degree ccw rotation. (Exif = 8)" " 3. 180 degree ccw rotation. (Exif = 3) 4. 270 degree ccw rotation." " (Exif = 6) 5. flip on X. (Exif = 2) 6. flip on X, then rotate ccw " "by 90 degrees. (Exif = 5) 7. flip on X, then rotate ccw by 180 " "degrees. (Exif = 4) 8. flip on X, then rotate ccw by 270 degrees. " "(Exif = 7) .. note:: * For some \"exotic\" images (FAX encodings, " "RAW formats and the like), this method will not work. You can however " "still work with such images in PyMuPDF, e.g. by using " ":meth:`Document.extract_image` or create pixmaps via `Pixmap(doc, xref)`." " These methods will automatically convert exotic images to the PNG format" " before returning results. * You can also get the properties of images" " embedded in a PDF, via their :data:`xref`. In this case make sure to " "extract the raw stream: " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`. * Images as " "returned by the image blocks of :meth:`Page.get_text` using \"dict\" or " "\"rawdict\" options are also supported." msgstr "" #: ../../functions.rst:452 6c919d4bab45428dbd8afb4362c1639b msgid "" "No exception is ever raised. In case of an error, `None` is returned. " "Otherwise, there are the following items::" msgstr "例外は発生しません。エラーの場合、`None` が返されます。それ以外の場合、以下のアイテムがあります::" #: ../../functions.rst:467 b9c14ed655074650822790e551f4ca7d msgid "" "There is the following relation to **Exif** information encoded in " "`orientation`, and correspondingly in the `transform` matrix-like (quoted" " from MuPDF documentation, *ccw* = counter-clockwise):" msgstr "" "以下は、**Exif** 情報にエンコードされた`orientation` と、対応する `transform` " "マトリックスの関係です（MuPDFドキュメンテーションから引用、*ccw* = 反時計回り）：" #: ../../functions.rst:469 19e611ede392404ba77fd6f75497a37d msgid "Undefined" msgstr "未定義" #: ../../functions.rst:470 32314d4117e54bddb20d74a136422abf msgid "0 degree ccw rotation. (Exif = 1)" msgstr "0度の反時計回りの回転（Exif = 1）" #: ../../functions.rst:471 781696a0f9f242fe89d413224e12432e msgid "90 degree ccw rotation. (Exif = 8)" msgstr "90度の反時計回りの回転（Exif = 8）" #: ../../functions.rst:472 589888419f494f768f3287b5f5fa3e86 msgid "180 degree ccw rotation. (Exif = 3)" msgstr "180度の反時計回りの回転（Exif = 3）" #: ../../functions.rst:473 f01ff82a9eed4b9f844b157ad3881ef5 msgid "270 degree ccw rotation. (Exif = 6)" msgstr "270度の反時計回りの回転（Exif = 6）" #: ../../functions.rst:474 0446ad252a924396aaeed11ed1109b46 msgid "flip on X. (Exif = 2)" msgstr "X軸で反転（Exif = 2）" #: ../../functions.rst:475 26416c1428b9417cb36e3f04129eb26b msgid "flip on X, then rotate ccw by 90 degrees. (Exif = 5)" msgstr "X軸で反転し、さらに90度反時計回りに回転（Exif = 5）" #: ../../functions.rst:476 7bf8066761234bc9b89b24615ac9ff55 msgid "flip on X, then rotate ccw by 180 degrees. (Exif = 4)" msgstr "X軸で反転し、さらに180度反時計回りに回転（Exif = 4）" #: ../../functions.rst:477 e588846b59874666b6702e6ff455f044 msgid "flip on X, then rotate ccw by 270 degrees. (Exif = 7)" msgstr "X軸で反転し、さらに270度反時計回りに回転（Exif = 7）" #: ../../functions.rst:482 b2e5bec7f40640858d351ef7a4d13151 msgid "" "For some \"exotic\" images (FAX encodings, RAW formats and the like), " "this method will not work. You can however still work with such images in" " PyMuPDF, e.g. by using :meth:`Document.extract_image` or create pixmaps " "via `Pixmap(doc, xref)`. These methods will automatically convert exotic " "images to the PNG format before returning results." msgstr "" "一部の「エキゾチック」な画像（FAXエンコーディング、RAWフォーマットなど）では、この方法は機能しない場合があります。ただし、PyMuPDFでは引き続きこのような画像を使用できます。たとえば、:meth:`Document.extract_image`" " を使用したり、`Pixmap(doc, xref)` " "を介してピクマップを作成したりできます。これらのメソッドは、結果を返す前にエキゾチックな画像を自動的にPNG形式に変換します。" #: ../../functions.rst:483 60dfbff3781a411aa5ac084ed06bc481 msgid "" "You can also get the properties of images embedded in a PDF, via their " ":data:`xref`. In this case make sure to extract the raw stream: " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`." msgstr "" "また、PDFに埋め込まれた画像のプロパティをxrefを介して取得することもできます。この場合は生のストリームを抽出してください： " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`。" #: ../../functions.rst:484 68c194bfed0d449c9f716b2f8c1e9a6d msgid "" "Images as returned by the image blocks of :meth:`Page.get_text` using " "\"dict\" or \"rawdict\" options are also supported." msgstr ":meth:`Page.get_text` の画像ブロックが「dict」または「rawdict」オプションを使用して返す画像もサポートされています。" #: ../../functions.rst:491 841e72c301064b7d8cd16a7659df3715 msgid "" "Return the header string required to make a valid document out of page " "text outputs." msgstr "ページのテキスト出力を有効なドキュメントに変換するために必要なヘッダー文字列を返します。" #: ../../functions.rst:493 ../../functions.rst:505 #: 98ab75da842e44f0aba2173690b17420 be09e3df54dd47cc9a0f9dad37daf7ba msgid "type of document. Use the same as the output parameter of *get_text()*." msgstr "ドキュメントの種類。*get_text()* メソッドのoutputパラメータと同じものを使用します。" #: ../../functions.rst:495 91d48bdf66814693aa7ac8c87d1d2704 msgid "optional arbitrary name to use in output types \"json\" and \"xml\"." msgstr "出力タイプ \"json\" および \"xml\" で使用するオプションの任意の名前。" #: ../../functions.rst:503 8f75e703912b484cad9c58f9ef286a30 msgid "" "Return the trailer string required to make a valid document out of page " "text outputs. See :meth:`Page.get_text` for an example." msgstr ":meth:`Page.get_text` の例を参照して、ページテキストの出力から有効な文書を作成するために必要なトレーラー文字列を返します。" #: ../../functions.rst:513 7bf3dbf728174900a685386f86d7b613 msgid "" "Delete an object containing XML-based metadata from the PDF. (Py-) MuPDF " "does not support XML-based metadata. Use this if you want to make sure " "that the conventional metadata dictionary will be used exclusively. Many " "thirdparty PDF programs insert their own metadata in XML format and thus " "may override what you store in the conventional dictionary. This method " "deletes any such reference, and the corresponding PDF object will be " "deleted during next garbage collection of the file." msgstr "PDF内からXMLベースのメタデータを含むオブジェクトを削除します。PyMuPDFではXMLベースのメタデータはサポートされていません。従って、従来のメタデータ辞書が排他的に使用されることを確認したい場合に使用します。多くのサードパーティのPDFプログラムは、独自のXML形式でメタデータを挿入し、従来の辞書に保存されている内容を上書きする可能性があります。このメソッドはそのような参照を削除し、ファイルの次回のガベージコレクション時に対応するPDFオブジェクトが削除されます。" #: ../../functions.rst:519 62c4ccaa8b8c436c990340d78e6341c0 msgid "" "Return the XML-based metadata :data:`xref` of the PDF if present -- also " "refer to :meth:`Document.del_xml_metadata`. You can use it to retrieve " "the content via :meth:`Document.xref_stream` and then work with it using " "some XML software." msgstr "" "PDFのXMLベースのメタデータの :data:`xref` " "を返します。存在する場合は、:meth:`Document.del_xml_metadata` " "にも言及してください。これを使用して、:meth:`Document.xref_stream` " "を介してコンテンツを取得し、それをいくつかのXMLソフトウェアを使用して操作できます。" #: ../../functions.rst:522 28fca2e874754c1b8e1f76de939f070b msgid ":data:`xref` of PDF file level XML metadata -- or 0 if none exists." msgstr "PDFファイルレベルのXMLメタデータの :data:`xref`。存在しない場合は0。" #: ../../functions.rst:528 bb22cba4009542cf9cbe10b1bdf7d0a0 msgid "Run a page through a device." msgstr "ページをデバイスを通じて実行します。" #: ../../functions.rst:530 b59467cb760a428cb9a1ad3ddc2372f5 msgid "Device, obtained from one of the :ref:`Device` constructors." msgstr ":ref:`Device`。デバイスのコンストラクタから取得します。" #: ../../functions.rst:533 764e316039514bc2b1c84a2a3613584f msgid "" "Transformation to apply to the page. Set it to :ref:`Identity` if no " "transformation is desired." msgstr "ページに適用する変換。変換を行わない場合は :ref:`Identity` に設定します。" #: ../../functions.rst:540 132d218ecda54d83a572eccb181b290d msgid "New in v1.19.0" msgstr "新機能 v1.19.0" #: ../../functions.rst:541 eb0d8183af6d46dcaa937647ed837885 msgid "" "Changed in v1.22.0: optionally also return the OCG name applicable to the" " boundary box." msgstr "v1.22.0 で変更: 境界ボックスに適用される OCG 名もオプションで返すように変更されました。" #: ../../functions.rst:543 2b307ac70a2c47239fe84735d4ea5dcc msgid "" "a list of rectangles that envelop text, image or drawing objects. Each " "item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple " "consists of rectangle coordinates, and *type* is one of the following " "values. If `layers=True`, there is a third item containing the OCG name " "or `None`: `(type, (x0, y0, x1, y1), None)`. * `\"fill-text\"` -- normal" " text (painted without character borders) * `\"stroke-text\"` -- text " "showing character borders only * `\"ignore-text\"` -- text that should " "not be displayed (e.g. as used by OCR text layers) * `\"fill-path\"` -- " "drawing with fill color (and no border) * `\"stroke-path\"` -- drawing " "with border (and no fill color) * `\"fill-image\"` -- displays an image *" " `\"fill-shade\"` -- display a shading The item sequence represents the " "**sequence in which these commands are executed** to build the page's " "appearance. Therefore, if an item's bbox intersects or contains that of a" " previous item, then the previous item may be (partially) covered / " "hidden. So this list can be used to detect such situations. An item's " "index in this list equals the value of a `\"seqno\"` in dictionaries as " "returned by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`." msgstr "" #: ../../functions.rst:543 1b114fa4f3f64d72bd937199e3a3d2f7 msgid "" "a list of rectangles that envelop text, image or drawing objects. Each " "item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple " "consists of rectangle coordinates, and *type* is one of the following " "values. If `layers=True`, there is a third item containing the OCG name " "or `None`: `(type, (x0, y0, x1, y1), None)`." msgstr "" "テキスト、画像、または描画オブジェクトを囲む矩形のリスト。各アイテムはタプル `(type, (x0, y0, x1, y1))` " "で、第2のタプルは矩形の座標を表し、*type* は以下の値のいずれかです。`layers=True` の場合、OCG 名または `None` " "を含む第3のアイテムがあります: `(type, (x0, y0, x1, y1), None)`。" #: ../../functions.rst:545 abf0c36f44e04ee8a5a2afa7b724f5a1 msgid "`\"fill-text\"` -- normal text (painted without character borders)" msgstr "`\"fill-text\"` – 通常のテキスト（文字の境界線なしで描画）" #: ../../functions.rst:546 37dd54d3f17044c6b337bff4655966a0 msgid "`\"stroke-text\"` -- text showing character borders only" msgstr "`\"stroke-text\"` – 文字の境界線のみを表示するテキスト" #: ../../functions.rst:547 849119a86cd44565a26d3541b70c0516 msgid "" "`\"ignore-text\"` -- text that should not be displayed (e.g. as used by " "OCR text layers)" msgstr "`\"ignore-text\"` – 表示されないべきテキスト（OCR テキストレイヤーなどで使用されます）" #: ../../functions.rst:548 aec96117beef420c82608445b9e8819a msgid "`\"fill-path\"` -- drawing with fill color (and no border)" msgstr "`\"fill-path\"` – 塗りつぶしカラーで描画（境界線なし）" #: ../../functions.rst:549 b1d6ad4002a641048ce03e94bd21d5bb msgid "`\"stroke-path\"` -- drawing with border (and no fill color)" msgstr "`\"stroke-path\"` – 境界線で描画（塗りつぶしカラーなし）" #: ../../functions.rst:550 b0e26ed279dc4820a41a7f8a4e615183 msgid "`\"fill-image\"` -- displays an image" msgstr "`\"fill-image\"` – 画像を表示" #: ../../functions.rst:551 7ad6ff9b7faf470cbe306351c31df8ec msgid "`\"fill-shade\"` -- display a shading" msgstr "`\"fill-shade\"` – シェーディングを表示" #: ../../functions.rst:553 218f82ee4e624649b8e8a57969e46706 msgid "" "The item sequence represents the **sequence in which these commands are " "executed** to build the page's appearance. Therefore, if an item's bbox " "intersects or contains that of a previous item, then the previous item " "may be (partially) covered / hidden." msgstr "" "**アイテムのシーケンスは、ページの外観を構築するためにこれらのコマンドが実行される** 順序を表します。したがって、アイテムの bbox " "が前のアイテムの bbox と交差または包含されている場合、前のアイテムは（部分的に）カバー / 隠される可能性があります。" #: ../../functions.rst:556 5593f221ed344831866cbd474df50bc3 msgid "" "So this list can be used to detect such situations. An item's index in " "this list equals the value of a `\"seqno\"` in dictionaries as returned " "by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`." msgstr "" "したがって、このリストを使用してそのような状況を検出できます。このリスト内のアイテムのインデックスは、:meth:`Page.get_drawings`" " および :meth:`Page.get_texttrace` によって返される辞書の `\"seqno\"` の値と等しいです。" #: ../../functions.rst:563 1b4ab5c71554402a9c63ee38f27e71cb msgid "New in v1.18.16" msgstr "v1.18.16 で新機能" #: ../../functions.rst:564 83fdfa37d163451e9ff96def5e0de5c0 msgid "Changed in v1.19.0: added key \"seqno\"." msgstr "v1.19.0 で変更: キー \"seqno\" を追加。" #: ../../functions.rst:565 916f4cdfdeda417abeea07844d42deca msgid "" "Changed in v1.19.1: stroke and fill colors now always are either RGB or " "GRAY" msgstr "v1.19.1 で変更: ストロークと塗りつぶしのカラーは常に RGB または GRAY です" #: ../../functions.rst:566 8c99ffdc891844ad872fd6def677e08b msgid "" "Changed in v1.19.3: span and character bboxes are now also correct if " "`dir != (1, 0)`." msgstr "v1.19.3 で変更: `dir != (1, 0)` の場合、スパンと文字の bbox も正確になりました。" #: ../../functions.rst:567 03678344ac2e4f0ba4e15f06b3b558d0 msgid "Changed in v1.22.0: add new dictionary key \"layer\"." msgstr "v1.22.0 で変更: 新しい辞書キー \"layer\" を追加。" #: ../../functions.rst:570 6d08591e52224bc08f77d6dcb26d9a04 msgid "" "Return low-level text information of the page. The method is available " "for **all** document types. The result is a list of Python dictionaries " "with the following content::" msgstr "" "ページの低レベルなテキスト情報を返します。このメソッドは **すべて** のドキュメントタイプで利用可能です。結果は、以下の内容を持つ " "Python 辞書のリストです。" #: ../../functions.rst:606 cc0d6a11bdbc410cb9411001f8e05eee msgid "Details:" msgstr "" #: ../../functions.rst:608 11f8d880efa247139f7f83220839a83a msgid "" "Information above tagged with \"(1)\" has the same meaning and value as " "explained in :ref:`TextPage`." msgstr "「(1)」でタグ付けされた情報は、:ref:`TextPage` で説明された内容と同じ意味と値を持っています。" #: ../../functions.rst:610 4d9d835859f449e0a40b7667d81451a8 #, fuzzy msgid "" "Please note that the font ``flags`` value will never contain a " "*superscript* flag bit: the detection of superscripts is done within " "MuPDF :ref:`TextPage` code -- it is not a property of any font." msgstr "" "フォント `flags` の値には *superscript* フラグビットが含まれないことに注意してください。上付き文字の検出はMuPDF " ":ref:`TextPage` 内で行われます。これは任意のフォントのプロパティではありません。" #: ../../functions.rst:611 d9f311aa264940be9b1fd7dc476446f3 msgid "" "Also note, that the text *color* is encoded as the usual tuple of floats " "0 <= f <= 1 -- not in sRGB format. Depending on `span[\"type\"]`, " "interpret this as fill color or stroke color." msgstr "" "また、テキストの *color* は通常の浮動小数点数のタプル（0 <= f <= " "1）でエンコードされており、sRGB形式ではありません。`span[\"type\"]` " "に応じて、これを塗りつぶし色またはストローク色として解釈してください。" #: ../../functions.rst:613 c32efb528d114e888542af9a76a9477a msgid "There are 3 text span types:" msgstr "テキストスパンには3つのタイプがあります：" #: ../../functions.rst:615 ea8c6854860c4abc84f35271f246cf6f msgid "" "0: Filled text -- equivalent to PDF text rendering mode 0 (`0 Tr`, the " "default in PDF), only each character's \"inside\" is shown." msgstr "0：塗りつぶしテキスト - PDFテキストレンダリングモード0（`0 Tr`、PDFのデフォルト）と同等で、各文字の「内部」のみが表示されます。" #: ../../functions.rst:616 8c5b60838d0043ad832b76f6964725ec msgid "" "1: Stroked text -- equivalent to `1 Tr`, only the character borders are " "shown." msgstr "1：ストロークテキスト - `1 Tr` に相当し、文字の境界のみが表示されます。" #: ../../functions.rst:617 aad83dab705242819a32cf3d87f3fcd2 msgid "3: Ignored text -- equivalent to `3 Tr` (hidden text)." msgstr "3：無視されたテキスト - `3 Tr` に相当し（非表示テキスト）。" #: ../../functions.rst:619 95d1e914c8254b37a6c64251be78ac76 #, python-format msgid "" "Line width in this context is important only for processing " "`span[\"type\"] != 0`: it determines the thickness of the character's " "border line. This value may not be provided at all with the text data. In" " this case, a value of 5% of the :data:`fontsize` (`span[\"size\"] * " "0,05`) is generated. Often, an \"artificial\" bold text in PDF is created" " by `2 Tr`. There is no equivalent span type for this case. Instead, " "respective text is represented by two consecutive spans -- which are " "identical in every aspect, except for their types, which are 0, resp 1. " "It is your responsibility to handle this type of situation - in " ":meth:`Page.get_text`, MuPDF is doing this for you." msgstr "" "この文脈では、線の幅は `span[\"type\"] != 0` " "を処理する際にのみ重要であり、文字の境界線の厚さを決定します。この値はテキストデータと一緒に提供されないこともあります。この場合、:data:`fontsize`" " の5％（`span[\"size\"] * 0.05`）の値が生成されます。PDF内の「人工」の太字テキストは、通常、`2 Tr` " "によって作成されます。この場合、このケースの等価なスパンタイプは存在しません。代わりに、対応するテキストは2つの連続したスパンによって表されます。これらのスパンはすべての側面が同一であり、タイプ以外は異なります（0、1）。このタイプの状況を処理する責任はあなたにあります。:meth:`Page.get_text`" " では、MuPDFがこれを代わりに行います。" #: ../../functions.rst:620 606f56ad2fa34ddb82e2171ac68c7ae0 msgid "" "For data compactness, the character's unicode is provided here. Use " "built-in function `chr()` for the character itself." msgstr "データのコンパクトさのために、文字のUnicodeがここで提供されます。文字自体には `chr()` という組み込み関数を使用します。" #: ../../functions.rst:621 eafb5c8d2c0a47fe87b904f337b62657 msgid "" "The alpha / opacity value of the span's text, `0 <= opacity <= 1`, 0 is " "invisible text, 1 (100%) is intransparent. Depending on `span[\"type\"]`," " interpret this value as *fill* opacity or, resp. *stroke* opacity." msgstr "" "スパンのテキストのアルファ/不透明度値、`0 <= opacity <= " "1`、0は見えないテキスト、1（100％）は不透明です。`span[\"type\"]` に応じて、この値を *fill* の不透明度または " "*stroke* の不透明度として解釈してください。" #: ../../functions.rst:622 eb23d9902fba49d087006466112feef8 msgid "" "*(Changed in v1.19.0)* This value is equal or close to `char[\"bbox\"]` " "of \"rawdict\". In particular, the bbox **height** value is always " "computed as if **\"small glyph heights\"** had been requested." msgstr "" "*（v1.19.0で変更）* この値は「rawdict」の `char[\"bbox\"]` と等しいか、近い値です。特に、bboxの " "**高さ** の値は常に **「小さなグリフの高さ」** が要求されたかのように計算されます。" #: ../../functions.rst:623 3ef916cf4c6d4625b153f657810bcaac msgid "*(New in v1.19.0)* This is the union of all character bboxes." msgstr "*（v1.19.0で新規）* これはすべての文字bboxの合併です。" #: ../../functions.rst:624 b64b0fd0a2f8435aada9591350d3276e msgid "" "*(New in v1.19.0)* Enumerates the commands that build up the page's " "appearance. Can be used to find out whether text is effectively hidden by" " objects, which are painted \"later\", or *over* some object. So if there" " is a drawing or image with a higher sequence number, whose bbox overlaps" " (parts of) this text span, one may assume that such an object hides the " "resp. text. Different text spans have identical sequence numbers if they " "were created in one go." msgstr "" "*（v1.19.0で新規）* " "ページの外観を構築するコマンドを列挙します。テキストが実際には後で「描画」されるオブジェクトによって隠れるか、またはいくつかのオブジェクトの上にかかっているかを判断するのに使用できます。したがって、bboxがこのテキストスパンのbboxと交差または含まれている場合、以前のアイテムが（部分的に）カバー/非表示にされる可能性があります。" #: ../../functions.rst:625 4e53fc30ab4b434a8dd462b37df55b15 msgid "" "*(New in v1.22.0)* The name of the Optional Content Group (OCG) if " "applicable or `None`." msgstr "*（v1.22.0で新規）* 該当する場合、Optional Content Group（OCG）の名前、または `None`" #: ../../functions.rst:627 18fcebc358184f629a5dac8dd24f561d msgid "" "Here is a list of similarities and differences of `page.get_texttrace()` " "compared to `page.get_text(\"rawdict\")`:" msgstr "" "以下は、`page.get_texttrace()` と `page.get_text(\"rawdict\")` " "を比較した類似点と相違点のリストです：" #: ../../functions.rst:629 10242bfca81e4c638b761ecd11ecc22b msgid "" "The method is up to **twice as fast,** compared to \"rawdict\" " "extraction. Depends on the amount of text." msgstr "メソッドは、テキストの量に依存しますが、\"rawdict\" の抽出と比較して最大 **2倍速い** です。" #: ../../functions.rst:630 563d2bcc5e534c8aa65c037cb918a041 msgid "" "The returned data is very **much smaller in size** -- although it " "provides more information." msgstr "返されるデータは **非常に小さく** 、より多くの情報を提供します。" #: ../../functions.rst:631 22d9ce68958844f9b04f8ce7c51e84a7 msgid "" "Additional types of text **invisibility can be detected**: opacity = 0 or" " type > 1 or overlapping bbox of an object with a higher sequence number." msgstr "" "追加のテキストの **不可視性のタイプを検出できます** ：不透明度 = 0またはタイプ > " "1またはシーケンス番号の高いオブジェクトとの境界ボックスが重なる。" #: ../../functions.rst:632 b7e1c0e67b62467e9bdadba9d42d6c6b msgid "" "If MuPDF returns unicode 0xFFFD (65533) for unrecognized characters, you " "may still be able to deduct desired information from the glyph id." msgstr "" "MuPDFが認識できない文字に対してUnicode " "0xFFFD（65533）を返す場合、グリフIDから必要な情報を導き出すことができるかもしれません。" #: ../../functions.rst:633 b1f31df6bda84153ace8673ae63e9996 msgid "" "The `span[\"chars\"]` **contains no spaces**, **except** the document " "creator has explicitly coded them. They **will never be generated** like " "it happens in :meth:`Page.get_text` methods. To provide some help for " "doing your own computations here, the width of a space character is " "given. This value is derived from the font where possible. Otherwise the " "value of a fallback font is taken." msgstr "" "`span[\"chars\"]` には **スペースは含まれません** 。ただし、ドキュメントの作成者が明示的にコード化しない限り、それらは " ":meth:`Page.get_text` メソッドで発生するように " "**生成されません**。自分自身の計算を行うのを助けるために、スペース文字の幅が提供されます。この値はフォントから派生しています。それ以外の場合はフォールバックフォントの値が取られます。" #: ../../functions.rst:634 c94dc74956874bfa8ac4c59d48c0cc87 msgid "" "There is no effort to organize text like it happens for a :ref:`TextPage`" " (the hierarchy of blocks, lines, spans, and characters). Characters are " "simply extracted in sequence, one by one, and put in a span. Whenever any" " of the span's characteristics changes, a new span is started. So you may" " find characters with different `origin.y` values in the same span (which" " means they would appear in different lines). You cannot assume, that " "span characters are sorted in any particular order -- you must make sense" " of the info yourself, taking `span[\"dir\"]`, `span[\"wmode\"]`, etc. " "into account." msgstr "" ":ref:`TextPage` " "のようにテキストを整理する取り組みはありません（ブロック、行、スパン、および文字の階層構造）。文字は単純に順番に抽出され、スパンに配置されます。スパンの特性が変更されるたびに、新しいスパンが開始されます。したがって、同じスパン内で異なる" " `origin.y` " "値を持つ文字を見つけることができます（これは異なる行に表示されることを意味します）。スパンの文字が特定の順序でソートされているとは仮定できません。情報を理解し、`span[\"dir\"]`、`span[\"wmode\"]`" " などを考慮に入れる必要があります。" #: ../../functions.rst:652 7acddc7741614360bf17d5596c8cc5ab msgid "Ligatures are represented like this:" msgstr "リガチャは次のように表されます：" #: ../../functions.rst:636 e72abf836baf467c93105d9dde8d8035 msgid "" "MuPDF handles the following ligatures: \"fi\", \"ff\", \"fl\", \"ft\", " "\"st\", \"ffi\", and \"ffl\" (only the first 3 are mostly ever used). If " "the page contains e.g. ligature \"fi\", you will find the following two " "character items subsequent to each other::" msgstr "" "MuPDFは次のリガチャを処理します。 \"fi\"、 \"ff\"、 \"fl\"、 \"ft\"、 \"st\"、 \"ffi\"、および " "\"ffl\"（ほとんどは最初の3つが使用されます）。したがって、ページに \"fi\" " "のようなリガチャが含まれている場合、次の2つの文字アイテムが連続して表示されます。" #: ../../functions.rst:641 d46f58a609804bea982da0876d2ba90f msgid "" "This means that the bbox of the first ligature character is the area " "containing the complete, compound glyph. Subsequent ligature components " "are recognizable by their glyph value -1 and a bbox of width zero." msgstr "これにより、最初の合字文字のbboxは、完全な合成グリフを含む領域です。後続の合字コンポーネントは、そのグリフ値が-1で幅がゼロであることで識別できます。" #: ../../functions.rst:642 5f6b5b48f4684036ad328bffca38325a msgid "" "You may want to replace those 2 or 3 char tuples by one, that represents " "the ligature itself. Use the following mapping of ligatures to unicodes:" msgstr "これらの2つまたは3つの文字のタプルを、合字自体を表す1つに置き換えたい場合があるかもしれません。次のような合字をUnicodeにマッピングします。" #: ../../functions.rst:644 889bc72258b64c39bbba09ab96188589 msgid "`\"ff\" -> 0xFB00`" msgstr "" #: ../../functions.rst:645 950a98981e9b4f3cad52eca1073f9df2 msgid "`\"fi\" -> 0xFB01`" msgstr "" #: ../../functions.rst:646 897debd680f84f00b2b72a621eb0ef78 msgid "`\"fl\" -> 0xFB02`" msgstr "" #: ../../functions.rst:647 06805958e3a24f58ba7fe31f2c71b37c msgid "`\"ffi\" -> 0xFB03`" msgstr "" #: ../../functions.rst:648 108d095c0546443c9aed1a351b544e51 msgid "`\"ffl\" -> 0xFB04`" msgstr "" #: ../../functions.rst:649 685cc70784514cb8b5c01b88bff6ab68 msgid "`\"ft\" -> 0xFB05`" msgstr "" #: ../../functions.rst:650 0b2c082689e24ccca607cf35dac9ca2f msgid "`\"st\" -> 0xFB06`" msgstr "" #: ../../functions.rst:652 3916ffdd9f474f4a8021e3466c4251ec msgid "" "So you may want to replace the two example tuples above by the following " "single one: `(0xFB01, glyph, (x, y), (x0, y0, x1, y1))` (there is usually" " no need to lookup the correct glyph id for 0xFB01 in the resp. font, but" " you may execute `font.has_glyph(0xFB01)` and use its return value)." msgstr "" "したがって、上記の2つの例のタプルを次の単一のタプルで置き換えたい場合があります：`(0xFB01, glyph, (x, y), (x0, " "y0, x1, " "y1))`（通常、0xFB01の正しいグリフIDをフォント内で調べる必要はありませんが、`font.has_glyph(0xFB01)` " "を実行し、その戻り値を使用することができます）。" #: ../../functions.rst:654 57e26aabbddd4a9f9a02d4b02c1ef955 #, fuzzy msgid "" "**Changed in v1.19.3:** Similar to other text extraction methods, the " "character and span bboxes envelop the character quads. To recover the " "quads, follow the same methods :meth:`recover_quad`, " ":meth:`recover_char_quad` or :meth:`recover_span_quad` as explained in " ":ref:`textpagedict`. Use either `None` or `span[\"dir\"]` for the writing" " direction." msgstr "" "**v1.19.3で変更：** " "他のテキスト抽出方法と同様に、文字とスパンのbboxは文字のクアッドを包含します。クアッドを回復するには、:ref:`textpagedict` " "で説明されている :meth:`recover_quad`、:meth:`recover_char_quad`、または " ":meth:`recover_span_quad` の同じ方法を使用します。書き込み方向にはNoneまたはspan `span[\"dir\"]`" " を使用してください。" #: ../../functions.rst:656 c735d25ff37c439293d1c84142159a58 msgid "" "**Changed in v1.21.1:** If applicable, the name of the OCG is shown in " "`\"layer\"`." msgstr "**v1.21.1** で変更：該当する場合、OCGの名前が `\"layer\"` に表示されます。" #: ../../functions.rst:662 73cb0ecbc9904cfd9eedd2cf201a34ac msgid "" "Ensures that the page's so-called graphics state is balanced and new " "content can be inserted correctly." msgstr "" #: ../../functions.rst:664 2fce8c9f6cfc4f5580d8dbfbdac54581 msgid "" "In versions 1.24.1+ of PyMuPDF the method was improved and is being " "executed automatically as required, so you should no longer need to " "concern yourself with it." msgstr "" #: ../../functions.rst:666 6ca70959e73644b19510f3250902df9a msgid "We discourage using :meth:`Page.clean_contents` to achieve this." msgstr "" #: ../../functions.rst:672 fbfdfc139dba4d859c7e23c259a08157 msgid "" "Indicate whether the page's so-called graphic state is balanced. If " "`False`, :meth:`Page.wrap_contents` should be executed if new content is " "inserted (only relevant in `overlay=True` mode). In newer versions " "(1.24.1+), this check and corresponding adjustments are automatically " "executed -- you therefore should not be concerned about this anymore." msgstr "" #: ../../functions.rst:680 de1474a27a3c4f17a4b06482b9593875 msgid "" "Deprecated wrapper for :meth:`TextPage.extractBLOCKS`. Use " ":meth:`Page.get_text` with the \"blocks\" option instead." msgstr "" ":meth:`TextPage.extractBLOCKS` の非推奨のラッパーです。代わりにオプション \"blocks\" を使用して " ":meth:`Page.get_text` を使用してください。" #: ../../functions.rst:688 88b9617fbc71462e867dbd12dd918d79 msgid "" "Deprecated wrapper for :meth:`TextPage.extractWORDS`. Use " ":meth:`Page.get_text` with the \"words\" option instead." msgstr "" #: ../../functions.rst:696 e63d78e973014b5da39d398c04e37cd0 msgid "Run a page through a list device and return its display list." msgstr "ページをリストデバイスを介して実行し、そのディスプレイリストを返します。" #: ../../functions.rst:698 18c7a9bcd3614b61abe4ffa70c25080c msgid ":ref:`DisplayList`" msgstr "" #: ../../functions.rst:699 95ce406969764ffea7a51bd7cb001954 msgid "the display list of the page." msgstr "ページのディスプレイリスト。" #: ../../functions.rst:705 2f7950caaff2497e85a41efaf8b7ab40 #, fuzzy msgid "" "PDF only: Retrieve a list of :data:`xref` of :data:`contents` objects of " "a page. May be empty or contain multiple integers. If the page is cleaned" " (:meth:`Page.clean_contents`), it will be no more than one entry. The " "\"source\" of each `/Contents` object can be individually read by " ":meth:`Document.xref_stream` using an item of this list. Method " ":meth:`Page.read_contents` in contrast walks through this list and " "concatenates the corresponding sources into one `bytes` object." msgstr "" "PDFのみ：ページの :data:`contents` オブジェクトの :data:`xref` " "のリストを取得します。空であるか、複数の整数を含むことがあります。ページがクリーンアップされた場合（:meth:`Page.clean_contents`）、最大で1つのエントリになります。各/Contentsオブジェクトの" " \"source\" は、このリストのアイテムを使用して :meth:`Document.xref_stream` " "で個別に読み取ることができます。一方、:meth:`Page.read_contents` メソッドは、このリストを走査し、対応するソースを1つの" " `bytes` オブジェクトに連結します。" #: ../../functions.rst:713 0e0e858c5fb34899bf5b31067d9f6cf0 msgid "" "PDF only: Let the page's `/Contents` key point to this xref. Any " "previously used contents objects will be ignored and can be removed via " "garbage collection." msgstr "" "PDFのみ：ページの `/Contents` " "キーをこのxrefに設定します。以前に使用されていたコンテンツオブジェクトは無視され、ガベージコレクションを使用して削除できます。" #: ../../functions.rst:719 5d1261cb25b84350a7512c2587a9a33e msgid "Changed in v1.17.6" msgstr "v1.17.6で変更" #: ../../functions.rst:721 246c4ca104b04817bab2b24be75d9bcb msgid "" "PDF only: Clean and concatenate all :data:`contents` objects associated " "with this page. \"Cleaning\" includes syntactical corrections, " "standardizations and \"pretty printing\" of the contents stream. " "Discrepancies between :data:`contents` and :data:`resources` objects will" " also be corrected if sanitize is true. See :meth:`Page.get_contents` for" " more details." msgstr "" "PDFのみ：このページに関連付けられたすべての :data:`contents` ツオブジェクトをクリーンアップして連結します。 " "\"クリーニング\"には、構文の修正、標準化、およびコンテンツストリームの \"きれいな印刷\"が含まれます。 " "sanitizeがtrueの場合、:data:`contents` と :data:`resources` " "オブジェクト間の不一致も修正されます。詳細については、:meth:`Page.get_contents` を参照してください。" #: ../../functions.rst:723 301ef7e95bd144f8b88b541724fc0d58 msgid "" "Changed in version 1.16.0 Annotations are no longer implicitly cleaned by" " this method. Use :meth:`Annot.clean_contents` separately." msgstr "" "バージョン1.16.0以降、注釈はこのメソッドによって暗黙的にクリーンアップされなくなりました。 " ":meth:`Annot.clean_contents` を別途使用してください。" #: ../../functions.rst:725 fb9142fcb2a94012a3fdd682a262552a msgid "" "*(new in v1.17.6)* if true, synchronization between resources and their " "actual use in the contents object is snychronized. For example, if a font" " is not actually used for any text of the page, then it will be deleted " "from the `/Resources/Font` object." msgstr "" "*（v1.17.6で新たに）* " "trueの場合、リソースとコンテンツオブジェクト間の同期が行われます。たとえば、ページのテキストでフォントが実際に使用されていない場合、それは " "`/Resources/Font` オブジェクトから削除されます。" #: ../../functions.rst:727 fc916fcfc1a14c108f31a9985fbb06f9 msgid "" "This is a complex function which may generate large amounts of new data " "and render old data unused. It is **not recommended** using it together " "with the **incremental save** option. Also note that the resulting " "singleton new */Contents* object is **uncompressed**. So you should save " "to a **new file** using options *\"deflate=True, garbage=3\"*." msgstr "" "これは大量の新しいデータを生成し、古いデータを使用しないようにする複雑な機能です。**増分保存** オプションと一緒に使用することは " "**お勧めできません** 。また、結果のシングルトンの新しい */Contents* オブジェクトは **非圧縮です**。したがって、オプション " "*\"deflate=True、garbage=3\"* を使用して **新しいファイル** に保存する必要があります。" #: ../../functions.rst:729 ee091ea4bbad4137bdf94b65bf7e1505 msgid "" "Do not any longer use this method to ensure correct insertions on PDF " "pages. Since PyMuPDF version 1.24.2 this is taken care of automatically." msgstr "" #: ../../functions.rst:735 da8e22bf756d4516a6435fef2ee406ef msgid "" "*New in version 1.17.0.* Return the concatenation of all :data:`contents`" " objects associated with the page -- without cleaning or otherwise " "modifying them. Use this method whenever you need to parse this source in" " its entirety without having to bother how many separate contents objects" " exist." msgstr "" "*v1.17.0で新たに追加。* ページに関連付けられたすべての :data:`contents` " "オブジェクトの連結を返します。クリーニングや変更などを行わずに、このソース全体を解析する必要がある場合にこのメソッドを使用します。" #: ../../functions.rst:744 0ea4768fd42d4fcdb406a86bb35b0b3c msgid "" "Clean the :data:`contents` streams associated with the annotation. This " "is the same type of action which :meth:`Page.clean_contents` performs -- " "just restricted to this annotation." msgstr "" "アノテーションに関連付けられた :data:`contents` " "ストリームをクリーンアップします。これは、:meth:`Page.clean_contents` " "が実行するのと同じ種類のアクションですが、この注釈に制限されています。" #: ../../functions.rst:751 c48de20f6397476e88558a5f14a2c96c msgid "" "Return a list of character glyphs and their widths for a font that is " "present in the document. A font must be specified by its PDF cross " "reference number :data:`xref`. This function is called automatically from" " :meth:`Page.insert_text` and :meth:`Page.insert_textbox`. So you should " "rarely need to do this yourself." msgstr "" "ドキュメント内に存在するフォントに対して、文字のグリフと幅のリストを返します。フォントはPDFのクロスリファレンス番号 :data:`xref` " "で指定する必要があります。この関数は、:meth:`Page.insert_text` および " ":meth:`Page.insert_textbox` から自動的に呼び出されます。したがって、自分で行う必要があることはほとんどありません。" #: ../../functions.rst:753 005b7266f7284e90bab8b77be14c642e msgid "" "cross reference number of a font embedded in the PDF. To find a font " ":data:`xref`, use e.g. *doc.get_page_fonts(pno)* of page number *pno* and" " take the first entry of one of the returned list entries." msgstr "" "ドキュメントに埋め込まれたPDFのクロスリファレンス番号。フォントの :data:`xref` を見つけるには、例えば、ページ番号 *pno* の" " *doc.get_page_fonts(pno)* を使用し、返されたリストエントリの最初を取得します。" #: ../../functions.rst:755 c40931be83a048c2b0e4d6547935db08 msgid "" "limits the number of returned entries. The default of 256 is enforced for" " all fonts that only support 1-byte characters, so-called \"simple " "fonts\" (checked by this method). All :ref:`Base-14-Fonts` are simple " "fonts." msgstr "" "返されるエントリの数を制限します。256のデフォルト値は、1バイトの文字のみをサポートする「シンプルフォント」と呼ばれるフォントに対して適用されます（このメソッドで確認されます）。すべてのPDF" " :ref:`Base-14-Fonts` はシンプルフォントです。" #: ../../functions.rst:758 c0afe718bd2442b18653b0b77f36b88c msgid "" "a list of *limit* tuples. Each character *c* has an entry *(g, w)* in " "this list with an index of *ord(c)*. Entry *g* (integer) of the tuple is " "the glyph id of the character, and float *w* is its normalized width. The" " actual width for some :data:`fontsize` can be calculated as *w * " "fontsize*. For simple fonts, the *g* entry can always be safely ignored. " "In all other cases *g* is the basis for graphically representing *c*." msgstr "" "*limit* のタプルのリストです。各文字cには、*ord(c)* のインデックスでエントリ *（g、w）* があります。タプルの " "*g*（整数）エントリは文字のグリフIDで、float *w* はその正規化された幅です。一部のフォントサイズに対する実際の幅は、*w * " ":data:`fontsize`* として計算できます。シンプルフォントの場合、gエントリは常に安全に無視できます。それ以外の場合、*g* は " "*c* を視覚的に表現するための基礎です。" #: ../../functions.rst:760 d14f388f645f450e95a675c15496f9d0 msgid "This function calculates the pixel width of a string called *text*::" msgstr "この関数は、*text* と呼ばれる文字列のピクセル幅を計算します::" #: ../../functions.rst:772 8580164da36b4e0c9468ee8d665d36ac msgid "New in version 1.14.14" msgstr "バージョン1.14.14で新規追加" #: ../../functions.rst:774 e5ce7ef74ebc4d4f8905c40e607a49ce msgid "" "PDF only: Check whether the object represented by :data:`xref` is a " ":data:`stream` type. Return is ``False`` if not a PDF or if the number is" " outside the valid xref range." msgstr "" "PDFのみ：:data:`xref` によって表されるオブジェクトが :data:`stream` " "タイプかどうかを確認します。PDFでない場合や、有効なxref範囲外の場合はFalseを返します。" #: ../../functions.rst:776 2cbd0ce6bddd4eb7894ddab3fda4d4c8 msgid ":data:`xref` number." msgstr ":data:`xref` 番号。" #: ../../functions.rst:778 9a6d0c88e56045e394739af6408a6b4e msgid "" "``True`` if the object definition is followed by data wrapped in keyword " "pair *stream*, *endstream*." msgstr "*stream*、*endstream* のキーワードペアで囲まれたデータに続いてオブジェクト定義がある場合は ``True``。" #: ../../functions.rst:784 5b978581dd6b490e8af4afbf4586ca56 msgid "" "Increase the :data:`xref` by one entry and return that number. This can " "then be used to insert a new object." msgstr ":data:`xref` を1つ増やしてその番号を返します。これは新しいオブジェクトを挿入するために使用できます。" #: ../../functions.rst:786 948cbb06043d486e90adbfb3b3275fa8 msgid "" "int :returns: the number of the new :data:`xref` entry. Please note, that" " only a new entry in the PDF's cross reference table is created. At this " "point, there will not yet exist a PDF object associated with it. To " "create an (empty) object with this number use `doc.update_xref(xref, " "\"<<>>\")`." msgstr "" "int :returns: 新しい :data:`xref` " "エントリの数。PDFのクロスリファレンステーブルに新しいエントリのみが作成されます。この段階では、それに関連付けられたPDFオブジェクトはまだ存在しません。この番号で（空の）オブジェクトを作成するには、`doc.update_xref(xref、\"<<>>\")`" " を使用します。" #: ../../functions.rst:793 e932ac5caa9f4c298a13a6d379dd7a51 msgid "Return length of :data:`xref` table." msgstr ":data:`xref` テーブルの長さを返します。" #: ../../functions.rst:796 f840df5df4b545b1bbf730bf184c5803 msgid "the number of entries in the :data:`xref` table." msgstr ":data:`xref` テーブルのエントリ数。" #: ../../functions.rst:802 b5d9bd2f14554b25bbb8fb9470c51da6 msgid "" "Compute the quadrilateral of a text span extracted via options \"dict\" " "or \"rawdict\" of :meth:`Page.get_text`." msgstr "" ":meth:`Page.get_text` のオプション \"dict\" または \"rawdict\" " "で抽出されたテキストスパンの四辺形を計算します。" #: ../../functions.rst:804 91a864a4261a4b1abf61f04339ba4ede msgid "" "`line[\"dir\"]` of the owning line. Use `None` for a span from " ":meth:`Page.get_texttrace`." msgstr "" "所有する行の `line[\"dir\"]`。:meth:`Page.get_texttrace` からのスパンの場合は `None` " "を使用します。" #: ../../functions.rst:805 ../../functions.rst:815 ../../functions.rst:826 #: 7033d11e092540f4ba156c04a297c691 74f50cf2036e4339af0cf16e7378d340 #: 994444b97874454798b14763f2d63fca msgid "the span." msgstr "スパン。" #: ../../functions.rst:806 ddc5c01bb3e44f12bf7284bf4fe74e81 msgid "" "the :ref:`Quad` of the span, usable for text marker annotations " "('Highlight', etc.)." msgstr "スパンの :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。" #: ../../functions.rst:812 f9901afa0a67408ebc90c04e01c93f8a msgid "" "Compute the quadrilateral of a text character extracted via option " "\"rawdict\" of :meth:`Page.get_text`." msgstr ":meth:`Page.get_text` のオプション \"rawdict\" で抽出されたテキスト文字の四辺形を計算します。" #: ../../functions.rst:814 ../../functions.rst:825 #: 67860855da1c47c8828ebecc90f766d6 7da81809c8ba42679d5e884d49b6878f msgid "" "`line[\"dir\"]` of the owning line. Use `None` for a span from " ":meth:`Page.get_texttrace`." msgstr "" "所有する行の `line[\"dir\"]`。:meth:`Page.get_texttrace` からのスパンの場合は `None` " "を使用します。" #: ../../functions.rst:816 131dbbd284734ed089c4778deb4dd003 msgid "the character." msgstr "文字。" #: ../../functions.rst:817 f88cafc7c32a4d6fad1b6135cd5cc40f msgid "" "the :ref:`Quad` of the character, usable for text marker annotations " "('Highlight', etc.)." msgstr "文字の :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。" #: ../../functions.rst:823 d59e0653bc4246c7a9357ca70c5860b0 msgid "" "Compute the quadrilateral of a subset of characters of a span extracted " "via option \"rawdict\" of :meth:`Page.get_text`." msgstr ":meth:`Page.get_text` のオプション \"rawdict\" で抽出されたスパンの一部の文字の四辺形を計算します。" #: ../../functions.rst:827 dadf644469074a32aa88fc7fdcf7698b msgid "" "the characters to consider. If given, the selected extraction option must" " be \"rawdict\"." msgstr "考慮する文字。省略した場合、。指定する場合、選択した抽出オプションは \"rawdict\" である必要があります。" #: ../../functions.rst:828 dfa12d94ceb3431eb63330adacb7bfe9 msgid "" "the :ref:`Quad` of the selected characters, usable for text marker " "annotations ('Highlight', etc.)." msgstr "選択された文字の :ref:`Quad` 、テキストマーカーアノテーション（'ハイライト' など）で使用できます。" #: ../../functions.rst:834 6aa28bd6817943bfbb2746f7a6243580 msgid "" "Compute the quadrilateral of a subset of spans of a text line extracted " "via options \"dict\" or \"rawdict\" of :meth:`Page.get_text`." msgstr "" ":meth:`Page.get_text` のオプション \"dict\" または \"rawdict\" " "で抽出されたテキスト行の一部のスパンの四辺形を計算します。" #: ../../functions.rst:836 78daeef8140c41a8a9c0b8b6c4532d1b msgid "the line." msgstr "行。" #: ../../functions.rst:837 e903ee7d5d594fc1811c896806a6bb8e msgid "" "a sub-list of `line[\"spans\"]`. If omitted, the full line quad will be " "returned." msgstr "`line[\"spans\"]` のサブリスト。省略した場合、選択した行の四辺形が返されます。" #: ../../functions.rst:838 4d44abbf27ac4dd98103b18718b1b07a msgid "" "the :ref:`Quad` of the selected line spans, usable for text marker " "annotations ('Highlight', etc.)." msgstr "選択された行のスパンの :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。" #: ../../functions.rst:844 4afcc06f3e38430bafe222f1079b22a0 msgid "Detect Tesseract language support folder." msgstr "" #: ../../functions.rst:846 cab287431498493d97889bd9dc044f9d msgid "" "This function is used to enable OCR via Tesseract even if the language " "support folder is not specified directly or in environment variable " "TESSDATA_PREFIX." msgstr "" #: ../../functions.rst:850 9ae2a9e271bd4bee918746c9384d309b msgid "If is set we return it directly." msgstr "" #: ../../functions.rst:852 ff58521ec09244cf9af0e5556f7a846f msgid "Otherwise we return `os.environ['TESSDATA_PREFIX']` if set." msgstr "" #: ../../functions.rst:854 e6350e60bfa84e9e9bc83ba51e45b115 msgid "" "Otherwise we search for a Tesseract installation and return its language " "support folder." msgstr "" #: ../../functions.rst:857 0e05c86bfe6f46f1b4451934cd24174b msgid "Otherwise we raise an exception." msgstr "" #: ../../functions.rst:867 ec04b5d7ae7c4b2698bdbf79b6fee421 msgid "" "Return the (unique) infinite rectangle `Rect(-2147483648.0, " "-2147483648.0, 2147483520.0, 2147483520.0)`, resp. the :ref:`IRect` and " ":ref:`Quad` counterparts. It is the largest possible rectangle: all valid" " rectangles are contained in it." msgstr "" "(ユニークな) 無限の四角形 " "`Rect(-2147483648.0、-2147483648.0、2147483520.0、2147483520.0)`、または " ":ref:`IRect` と :ref:`Quad` の対応するものを返します。これは最大の可能な四角形で、すべての有効な四角形が含まれます。" #: ../../functions.rst:877 0089e42de5e24fdc9314358b9f612356 msgid "" "Return the \"standard\" empty and invalid rectangle `Rect(2147483520.0, " "2147483520.0, -2147483648.0, -2147483648.0)` resp. quad. Its top-left and" " bottom-right point values are reversed compared to the infinite " "rectangle. It will e.g. be used to indicate empty bboxes in " "`page.get_text(\"dict\")` dictionaries. There are however infinitely many" " empty or invalid rectangles." msgstr "" "「標準」の空白で無効な四角形 `Rect(2147483520.0, 2147483520.0, -2147483648.0, " "-2147483648.0)` " "または対応する四角形を返します。その左上と右下のポイント値は、無限の四角形と比較して反転しています。たとえば、`page.get_text(\"dict\")`" " 辞書内の空の bboxes を示すために使用されます。ただし、無限に多くの空のまたは無効な四角形が存在します。" #: ../../functions.rst:883 fea470f568524b038bb0e30aed353ec9 msgid "" "Returns a dict mapping lower-case color name to `(red, green, blue)` " "tuple, and `red`, `green`, `blue` are floats in range 0..1." msgstr "" #: ../../functions.rst:888 c23cf90537d54067a5727d87647c89d2 msgid "" "Returns a list of `(colorname, red, green, blue)` tuples, where " "`colorname` is upper case and `red`, `green`, `blue` are integers in " "range 0..255." msgstr "" #: ../../footer.rst:46 e369c07a6dfc4a3d9e7f48a78f52b9bf msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "return the quad for a text span (\"dict\" / \"rawdict\")" #~ msgstr "テキスト スパンのクワッドを返す (\"dict\", \"rawdict\")" #~ msgid "*New in v1.18.9*" #~ msgstr "*新機能 v1.18.9*" #~ msgid "" #~ "Convenience function returning the " #~ "quadrilateral enveloping the text of a" #~ " text span, as returned by " #~ ":meth:`Page.get_text` using the \"dict\" or" #~ " \"rawdict\" options." #~ msgstr "" #~ ":meth:`Page.get_text` を使用して、テキストスパンのテキストを囲む四角形を返す便利な関数。オプションとして" #~ " \"dict\" または \"rawdict\" を指定して " #~ ":meth:`Page.get_text` から返されたテキストスパンの情報を使用します。" #~ msgid "the value `line[\"dir\"]` of the span's line." #~ msgstr "スパンのラインの値 `line[\"dir\"]`。" #~ msgid "the span sub-dictionary." #~ msgstr "スパンのサブディクショナリ。" #~ msgid "the quadrilateral of the span's text." #~ msgstr "スパンのテキストの四角形。" #~ msgid "" #~ "Put string pair \"q\" / \"Q\" " #~ "before, resp. after a page's */Contents*" #~ " object(s) to ensure that any " #~ "\"geometry\" changes are **local** only." #~ msgstr "" #~ "ページの */Contents* オブジェクトの前、または後ろに文字列ペア \"q\" /" #~ " \"Q\" を配置して、どんな \"geometry\" の変更も **ローカル**" #~ " な変更だけになるようにします。" #~ msgid "" #~ "Use this method as an alternative, " #~ "minimalist version of :meth:`Page.clean_contents`." #~ " Its advantage is a small footprint" #~ " in terms of processing time and " #~ "impact on the data size of " #~ "incremental saves. Multiple executions of " #~ "this method are no problem and " #~ "have no functional impact: `b\"q q " #~ "contents Q Q\"` is treated like " #~ "`b\"q contents Q\"`." #~ msgstr "" #~ "このメソッドは、:meth:`Page.clean_contents` " #~ "の代替として使用します。その利点は、処理時間と増分保存のデータサイズへの影響が少ないことです。このメソッドの複数回実行は問題ありませんし、機能的な影響もありません。例えば、`b\"q" #~ " q contents Q Q\"` は `b\"q " #~ "contents Q\"` と同様に扱われます。" #~ msgid "" #~ "Indicate whether :meth:`Page.wrap_contents` may " #~ "be required for object insertions in " #~ "standard PDF geometry. Note that this" #~ " is a quick, basic check only: " #~ "a value of ``False`` may still be" #~ " a false alarm. But nevertheless " #~ "executing :meth:`Page.wrap_contents` will have " #~ "no negative side effects." #~ msgstr "" #~ ":meth:`Page.wrap_contents` " #~ "が標準のPDFジオメトリにオブジェクトを挿入する際に必要かどうかを示します。ただし、これは迅速で基本的なチェックであることに注意してください。``False``" #~ " の値でも誤報の可能性があることに留意してください。ただし、:meth:`Page.wrap_contents` " #~ "を実行しても負の副作用はありません。" #~ msgid ":attr:`TESSDATA_PREFIX`" #~ msgstr "" #~ msgid "a copy of `os.environ[\"TESSDATA_PREFIX\"]`" #~ msgstr "os.environ[\"TESSDATA_PREFIX\"] のコピーです" #~ msgid "New in v1.19.4" #~ msgstr "バージョン1.19.4で新たに導入されました" #~ msgid "" #~ "Copy of `os.environ[\"TESSDATA_PREFIX\"]` for " #~ "convenient checking whether there is " #~ "integrated Tesseract OCR support." #~ msgstr "便利なチェックに使用される `os.environ[\"TESSDATA_PREFIX\"]` のコピー" #~ msgid "" #~ "If this attribute is `None`, " #~ "Tesseract-OCR is either not installed, " #~ "or the environment variable is not " #~ "set to point to Tesseract's language " #~ "support folder." #~ msgstr "" #~ "この属性が `None` の場合、Tesseract-" #~ "OCRはインストールされていないか、環境変数がTesseractの言語サポートフォルダを指すように設定されていない可能性があります。" #~ msgid "" #~ "This variable is now checked before " #~ "OCR functions are tried. This prevents" #~ " verbose messages from MuPDF." #~ msgstr "この変数は、OCR関数が試行される前に確認されます。これにより、MuPDFから冗長なメッセージが表示されるのを防ぎます。" #~ msgid "" #~ "This method obsoletes the use of " #~ ":meth:`Page.clean_contents` in most cases. The" #~ " advantage this method is a small " #~ "footprint in terms of processing time" #~ " and a low impact on the data" #~ " size of incremental saves." #~ msgstr "" #~ msgid "" #~ "Return the name of Tesseract's language" #~ " support folder. Use this function if" #~ " the environment variable `TESSDATA_PREFIX` " #~ "has not been set." #~ msgstr "" #~ "Tesseractの言語サポートフォルダの名前を返します。環境変数 `TESSDATA_PREFIX` " #~ "が設定されていない場合にこの関数を使用します" #~ msgid "" #~ "`os.getenv(\"TESSDATA_PREFIX\")` if not `None`. " #~ "Otherwise, if Tesseract-OCR is " #~ "installed, locate the name of " #~ "`tessdata`. If no installation is found," #~ " return `False`. The folder name can" #~ " be used as parameter `tessdata` in" #~ " methods :meth:`Page.get_textpage_ocr`, " #~ ":meth:`Pixmap.pdfocr_save` and " #~ ":meth:`Pixmap.pdfocr_tobytes`." #~ msgstr "" #~ msgid "" #~ "`os.getenv(\"TESSDATA_PREFIX\")` if not `None`. " #~ "Otherwise, if Tesseract-OCR is " #~ "installed, locate the name of " #~ "`tessdata`. If no installation is found," #~ " return `False`." #~ msgstr "" #~ "`os.getenv(\"TESSDATA_PREFIX\")` が `None` でない場合" #~ "、またはTesseract-OCRがインストールされている場合は、`tessdata` " #~ "の名前を見つけます。インストールが見つからない場合、`False` を返します。" #~ msgid "" #~ "The folder name can be used as " #~ "parameter `tessdata` in methods " #~ ":meth:`Page.get_textpage_ocr`, :meth:`Pixmap.pdfocr_save` " #~ "and :meth:`Pixmap.pdfocr_tobytes`." #~ msgstr "" #~ "このフォルダの名前は、メソッド " #~ ":meth:`Page.get_textpage_ocr`、:meth:`Pixmap.pdfocr_save`、および " #~ ":meth:`Pixmap.pdfocr_tobytes` の `tessdata` " #~ "パラメータに使用できます。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "Write to Python's `logging` system using" #~ " specified logger name. Only used if" #~ " `pylogging_logger` is None. Default is " #~ "`pymupdf`." #~ msgstr "" #~ msgid "" #~ "If any `pylogging*` arg is not " #~ "None, we write to `Python's logging " #~ "system `_." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/glossary.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b0e2cd94d0aa4b3a934fbebb0e61235b msgid "Artifex" msgstr "" #: ../../header.rst:-1 f1baafce3d564895b00cf4bc56d7bb33 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 819b0bef657b4ba4a0ab2d3e4ec0b4d8 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../glossary.rst:7 9941910a374d4a0db2b472ea37c6f1f8 msgid "Glossary" msgstr "用語集" #: ../../glossary.rst:11 0c491cef7a4041028d651475e56a294b msgid "" "This is an essential general mathematical / geometrical term for " "understanding this documentation. Please see this section for a more " "detailed discussion: :ref:`Coordinates`." msgstr "" #: ../../glossary.rst:15 b03cc7629633424488939ad7912ff819 msgid "A Python sequence of 6 numbers." msgstr "6つの数字からなるPythonのシーケンス。" #: ../../glossary.rst:19 bd43bb115ff04c94b19ca36c5f5d02f6 msgid "A Python sequence of 4 numbers." msgstr "4つの数字からなるPythonのシーケンス。" #: ../../glossary.rst:23 1a31b68b33264ca5a77bd2b6902ffe53 msgid "A Python sequence of 4 integers." msgstr "4つの整数からなるPythonのシーケンス。" #: ../../glossary.rst:27 2a42549c54164862ab4a896ad4f7e587 msgid "A Python sequence of 2 numbers." msgstr "2つの数字からなるPythonのシーケンス。" #: ../../glossary.rst:31 5d5f5915c82d4921bed1e2f95ab91ecb msgid "A Python sequence of 4 :data:`point_like` items." msgstr "4つの :data:`point_like` アイテムからなるPythonのシーケンス。" #: ../../glossary.rst:35 775806cbba59489bac52cba16de32799 msgid "" "A number of values in a PDF can inherited by objects further down in a " "parent-child relationship. The mediabox (physical size) of pages may for " "example be specified only once or in some node(s) of the :data:`pagetree`" " and will then be taken as value for all *kids*, that do not specify " "their own value." msgstr "" "PDF内のいくつかの値は、親子関係で下位のオブジェクトに継承されることがあります。例えば、ページのmediabox（物理的なサイズ）は一度だけ指定されるか、:data:`pagetree`" " のいくつかのノードで指定され、それ以外の値を指定しない子供たちにとってその値が取得されます。" #: ../../glossary.rst:41 d6aa867681e449c0a945275210eb6353 msgid "" "A PDF array of 4 floats specifying a physical page size -- " "(:data:`inheritable`, mandatory). This rectangle should contain all other" " PDF -- optional -- page rectangles, which may be specified in addition:" " CropBox, TrimBox, ArtBox and BleedBox. Please consult :ref:`AdobeManual`" " for details. The MediaBox is the only rectangle, for which there is no " "difference between MuPDF and PDF coordinate systems: " ":attr:`Page.mediabox` will always show the same coordinates as the " "`/MediaBox` key in a page's object definition. For all other rectangles, " "MuPDF transforms y coordinates such that the **top** border is the point " "of reference. This can sometimes be confusing -- you may for example " "encounter a situation like this one:" msgstr "" "物理的なページサイズを指定する4つの浮動小数点数からなるPDF配列 " "-（:data:`inheritable`、必須）。この矩形には、追加で指定できる他のすべてのPDFページ矩形を含める必要があります。これらの矩形にはCropBox、TrimBox、ArtBox、BleedBoxがあります。詳細については、" " :ref:`AdobeManual` を参照してください。MediaBoxは、MuPDFとPDFの座標系の間に違いがない唯一の矩形です。 " ":attr:`Page.mediabox` は常に、ページオブジェクト定義内の `/MediaBox` " "キーと同じ座標を示します。他のすべての矩形に関して、MuPDFはy座標を変換し、上部境界が参照点となるようにします。これは時に混乱することがあります。例えば、次のような状況に遭遇することがあります。" #: ../../glossary.rst:43 4b7aa0adab17468e947f9b8eb328fd00 msgid "" "The page definition contains the following identical values: `/MediaBox [" " 36 45 607.5 765 ]`, `/CropBox [ 36 45 607.5 765 ]`." msgstr "" "ページ定義には次のような同一の値が含まれています: `/MediaBox [ 36 45 607.5 765 ]` 、 `/CropBox [ " "36 45 607.5 765 ]`。 " #: ../../glossary.rst:44 c3336320e59f48f9986d52f340b7a4d4 msgid "" "PyMuPDF accordingly shows `page.mediabox = Rect(36.0, 45.0, 607.5, " "765.0)`." msgstr "したがって、PyMuPDFは `page.mediabox = Rect(36.0, 45.0, 607.5, 765.0)` と表示します。 " #: ../../glossary.rst:45 a216a8839aee420cbe653cdb1e90cee1 msgid "" "**BUT:** `page.cropbox = Rect(36.0, 0.0, 607.5, 720.0)`, because the two " "y-coordinates have been transformed (45 subtracted from both of them)." msgstr "" "しかし、 `page.cropbox = Rect(36.0, 0.0, 607.5, 720.0)` " "です。なぜなら、2つのy座標が変換されているため（両方から45が引かれているため）です。" #: ../../glossary.rst:49 8fa4e076a5e744bfa85ec3664e4908ce msgid "" "A PDF array of 4 floats specifying a page's visible area -- " "(:data:`inheritable`, optional). It is the default for TrimBox, ArtBox " "and BleedBox. If not present, it defaults to MediaBox. This value is " "**not affected** if the page is rotated -- in contrast to " ":attr:`Page.rect`. Also, other than the page rectangle, the top-left " "corner of the cropbox may or may not be *(0, 0)*." msgstr "" "ページの可視領域を指定する4つの浮動小数点数からなるPDF配列 " "-（:data:`inheritable`、任意）。これはTrimBox、ArtBox、BleedBoxのデフォルト値です。存在しない場合、デフォルトはMediaBoxです。この値はページが回転している場合には影響を受けません" " - :attr:`Page.rect` とは対照的です。また、ページ矩形以外では、クロップボックスの左上隅が(0, " "0)であるかどうかは問題ありません。" #: ../../glossary.rst:54 695d4331e2574a73a6bc119defe798a4 msgid "" "A central PDF :data:`dictionary` -- also called the \"root\" -- " "containing document-wide parameters and pointers to many other " "information. Its :data:`xref` is returned by " ":meth:`Document.pdf_catalog`." msgstr "" "中央のPDF :data:`dictionary` - または「ルート」とも呼ばれる - " "で、文書全体のパラメータと多くの他の情報へのポインタを含んでいます。その :data:`xref` は " ":meth:`Document.pdf_catalog` で返されます。" #: ../../glossary.rst:58 972c6ce4df00407a83efb4a5e33cf1b8 msgid "" "More precisely, the **PDF trailer** contains information in " ":data:`dictionary` format. It is usually located at the file's end. In " "this dictionary, you will find things like the xrefs of the catalog and " "the metadata, the number of :data:`xref` numbers, etc. Here is the " "definition of the PDF spec:" msgstr "" "より正確には、PDFトレーラーには :data:`dictionary` " "形式の情報が含まれています。通常、ファイルの末尾に配置されています。この辞書には、カタログやメタデータの :data:`xref` " "、:data:`xref` の数などが含まれています。PDF仕様の定義は次のとおりです：" #: ../../glossary.rst:60 c620690ecfe5406fbe8d467efeb91794 msgid "" "*\"The trailer of a PDF file enables an application reading the file to " "quickly find the cross-reference table and certain special objects. " "Applications should read a PDF file from its end.\"*" msgstr "「PDFファイルのトレーラーは、ファイルを読むアプリケーションがクロスリファレンステーブルと特定の特別なオブジェクトを迅速に見つけることを可能にします。アプリケーションはPDFファイルを末尾から読むべきです。」" #: ../../glossary.rst:62 bbfcfb28f25f49608557cc077c9f2ff2 msgid "" "To access the trailer in PyMuPDF, use the usual methods " ":meth:`Document.xref_object`, :meth:`Document.xref_get_key` and " ":meth:`Document.xref_get_keys` with `-1` instead of a positive xref " "number." msgstr "" "PyMuPDFでトレーラーにアクセスするには、通常の方法で :meth:`Document.xref_object` 、 " ":meth:`Document.xref_get_key` 、:meth:`Document.xref_get_keys` " "を使用し、正のxref番号の代わりに `-1` を指定します。" #: ../../glossary.rst:66 52c596bdac704429bcc9b0406875b7fc msgid "" "A **content stream** is a PDF :data:`object` with an attached " ":data:`stream`, whose data consists of a sequence of instructions " "describing the graphical elements to be painted on a page, see \"Stream " "Objects\" on page 19 of :ref:`AdobeManual`. For an overview of the mini-" "language used in these streams, see chapter \"Operator Summary\" on page " "643 of the :ref:`AdobeManual`. A PDF :data:`page` can have none to many " "contents objects. If it has none, the page is empty (but still may show " "annotations). If it has several, they will be interpreted in sequence as " "if their instructions had been present in one such object (i.e. like in a" " concatenated string). It should be noted that there are more stream " "object types which use the same syntax: e.g. appearance dictionaries " "associated with annotations and Form XObjects." msgstr "" "コンテンツストリームは、PDF :data:`object` に添付された :data:`stream` " "を持ち、そのデータはページに描画されるグラフィカル要素を記述する命令のシーケンスから成り立っています。 :ref:`AdobeManual` " "の「Stream Objects」（p.19）を参照してください。これらのストリームで使用されるミニ言語の概要については、 " ":ref:`AdobeManual` の「Operator " "Summary」章（p.643）をご覧ください。PDFページには0から多くのコンテンツオブジェクトを持つことができます。コンテンツオブジェクトが存在しない場合、ページは空になります（ただし注釈は表示される可能性があります）。複数のコンテンツオブジェクトがある場合、それらは1つのオブジェクトに存在するかのように順番に解釈されます（つまり、連結された文字列のように）。なお、同じ構文を使用する他のストリームオブジェクトタイプもあることに注意してください。たとえば、注釈に関連する外観辞書やフォームXObjectなどです。" #: ../../glossary.rst:68 fcc09656179a42c7974f67c0e38f4c94 msgid "PyMuPDF provides a number of methods to deal with contents of PDF pages:" msgstr "PyMuPDFは、PDFページのコンテンツに対処するためのいくつかのメソッドを提供しています：" #: ../../glossary.rst:70 aa25f61d861242e7a13b1c745587ebad msgid "" ":meth:`Page.read_contents()` -- reads and concatenates all page contents " "into one `bytes` object." msgstr ":meth:`Page.read_contents()` – ページのすべてのコンテンツを読み込んで1つのバイトオブジェクトに連結します。" #: ../../glossary.rst:71 85a71eda07ba4442b8014231e74ff345 msgid "" ":meth:`Page.clean_contents()` -- a wrapper of a MuPDF function that " "reads, concatenates and syntax-cleans all page contents. After this, only" " one `/Contents` object will exist. In addition, page :data:`resources` " "will have been synchronized with it such that it will contain exactly " "those images, fonts and other objects that the page actually references." msgstr "" ":meth:`Page.clean_contents()` – " "MuPDFの関数をラップして、ページのすべてのコンテンツを読み込んで連結し、構文をクリーンアップします。これにより、1つの " "`/Contents` オブジェクトのみが存在します。さらに、ページの :data:`resources` " "はそれと同期され、ページが実際に参照する画像、フォント、その他のオブジェクトのみが含まれるようになります。" #: ../../glossary.rst:72 47bbed208b0b4183bd6abbb069ce2eb9 msgid "" ":meth:`Page.get_contents()` -- return a list of :data:`xref` numbers of a" " page's :data:`contents` objects. May be empty. Use " ":meth:`Document.xref_stream()` with one of these xrefs to read the resp. " "contents section." msgstr "" ":meth:`Page.get_contents()` – ページの :data:`contents` オブジェクトの :data:`xref` " "番号のリストを返します。空かもしれません。:meth:`Document.xref_stream()` " "をこれらのxrefの1つとともに使用して、対応するコンテンツセクションを読み込むことができます。" #: ../../glossary.rst:73 fc38f58008f949d283ae3b24382f368a msgid "" ":meth:`Page.set_contents()` -- set a page's `/Contents` key to the " "provided :data:`xref` number." msgstr ":meth:`Page.set_contents()` – ページの `/Contents` キーを指定されたxref番号に設定します。" #: ../../glossary.rst:77 7f136697e7be484382e85c200cb2c6dc msgid "" "A :data:`dictionary` containing references to any resources (like images " "or fonts) required by a PDF :data:`page` (required, inheritable, " ":ref:`AdobeManual` p. 81) and certain other objects (Form XObjects). This" " dictionary appears as a sub-dictionary in the object definition under " "the key */Resources*. Being an inheritable object type, there may exist " "\"parent\" resources for all pages or certain subsets of pages." msgstr "" "PDFページに必要なリソース（画像やフォントなど）への参照を含む :data:`dictionary`（必須、継承可能、 " ":ref:`AdobeManual` p. 81）および一部の他のオブジェクト（フォームXObject）が必要です。この " ":data:`dictionary` " "は、オブジェクト定義内のキー/リソースの下にサブ辞書として表示されます。継承可能なオブジェクトタイプであるため、すべてのページまたは一部のページの「親」リソースが存在する可能性があります。" #: ../../glossary.rst:81 bf3936e13b07411e9f15d4dea0704603 msgid "" "A PDF :data:`object` type, which is somewhat comparable to the same-named" " Python notion: \"A dictionary object is an associative table containing " "pairs of objects, known as the dictionary's entries. The first element of" " each entry is the key and the second element is the value. The key must " "be a name (...). The value can be any kind of object, including another " "dictionary. A dictionary entry whose value is null (...) is equivalent to" " an absent entry.\" (:ref:`AdobeManual` p. 18)." msgstr "" "PDF :data:`object` " "のタイプで、同じ名前のPythonの概念に多少似ています。「辞書オブジェクトは、辞書のエントリとして知られるオブジェクトのペアを含む連想テーブルです。各エントリの最初の要素はキーであり、2番目の要素は値です。キーは名前である必要があります（...）。値は他の辞書を含む他の種類のオブジェクトであることができます。値がnull" " (...) の辞書エントリは、不在のエントリと同等です。」（:ref:`AdobeManual` p. 18）。" #: ../../glossary.rst:83 a5774d115d78486887db6243636d5362 msgid "" "Dictionaries are the most important :data:`object` type in PDF. Here is " "an example (describing a :data:`page`)::" msgstr "辞書は、PDF内で最も重要なオブジェクトのタイプです。以下は、:data:`page` を記述する例です::" #: ../../glossary.rst:102 45aa2b19b71e458e8fa25a2c78d596a6 msgid "" "*Contents*, *Type*, *MediaBox*, etc. are **keys**, *40 0 R*, *Page*, *[0 " "0 595.32 841.92]*, etc. are the respective **values**. The strings " "*\"<<\"* and *\">>\"* are used to enclose object definitions." msgstr "" "Contents、Type、MediaBoxなどはキーであり、40 0 R、Page、[0 0 595.32 " "841.92]などはそれぞれの値です。「<<」と「>>」という文字列は、オブジェクト定義を括るために使用されます。" #: ../../glossary.rst:104 a6f9190af07842339804c618355e0e27 msgid "" "This example also shows the syntax of **nested** dictionary values: " "*Resources* has an object as its value, which in turn is a dictionary " "with keys like *ExtGState* (with the value *<>*, which is " "another dictionary), etc." msgstr "" "この例は、ネストされた辞書の値の構文も示しています。Resourcesはその値としてオブジェクトを持ち、それ自体がExtGState（値は<>で、これは別の辞書です）、などのキーを持つ辞書です。" #: ../../glossary.rst:108 b97660907730454fb80cae8fff9da131 msgid "" "A PDF page is a :data:`dictionary` object which defines one page in a " "PDF, see :ref:`AdobeManual` p. 71." msgstr "" "PDFページは、PDF内の1つのページを定義する :data:`dictionary` オブジェクトであり、 :ref:`AdobeManual`" " p. 71を参照してください。" #: ../../glossary.rst:112 97d4db102e0e4330938ad1f4e7fca422 msgid "" "The pages of a document are accessed through a structure known as the " "page tree, which defines the ordering of pages in the document. The tree " "structure allows PDF consumer applications, using only limited memory, to" " quickly open a document containing thousands of pages. The tree contains" " nodes of two types: intermediate nodes, called page tree nodes, and leaf" " nodes, called page objects. (:ref:`AdobeManual` p. 75)." msgstr "" "文書のページは、ページツリーとして知られる構造を介してアクセスされ、文書内のページの順序を定義します。このツリー構造により、限られたメモリしか使用しないPDFコンシューマーアプリケーションでも、数千ページを含む文書を迅速に開くことができます。ツリーには2種類のノードが含まれています。中間ノードはページツリーノードと呼ばれ、葉ノードはページオブジェクトと呼ばれます。（:ref:`AdobeManual`" " p. 75）。" #: ../../glossary.rst:114 2dbcc685903a4543922f7629dbdc1af4 msgid "" "While it is possible to list all page references in just one array, PDFs " "with many pages are often created using *balanced tree* structures " "(\"page trees\") for faster access to any single page. In relation to the" " total number of pages, this can reduce the average page access time by " "page number from a linear to some logarithmic order of magnitude." msgstr "ページ参照を単一の配列でリストすることは可能ですが、多くのページを含むPDFは、より迅速な単一ページへのアクセスのためにバランスの取れたツリー構造（「ページツリー」）を使用して作成されることがよくあります。全ページ数に対して、これにより平均ページアクセス時間がページ番号による線形から対数のオーダーに削減されることがあります。" #: ../../glossary.rst:116 aca1e345565340d197f15bb05ce23148 msgid "" "For fast page access, MuPDF can use its own array in memory -- " "independently from what may or may not be present in the document file. " "This array is indexed by page number and therefore much faster than even " "the access via a perfectly balanced page tree." msgstr "" "高速なページアクセスのために、MuPDFは独自のメモリ内配列を使用できます - " "文書ファイルに存在するかどうかに関係なく。この配列はページ番号でインデックスされるため、完全にバランスが取れたページツリーを経由するアクセスよりもはるかに高速です。" #: ../../glossary.rst:120 cf48ba84c41b4860a00bb4859a5f1ab6 msgid "" "Similar to Python, PDF supports the notion *object*, which can come in " "eight basic types: boolean values (\"true\" or \"false\"), integer and " "real numbers, strings (**always** enclosed in brackets -- either \"()\", " "or \"<>\" to indicate hexadecimal), names (must always start with a " "\"/\", e.g. `/Contents`), arrays (enclosed in brackets \"[]\"), " "dictionaries (enclosed in brackets \"<<>>\"), streams (enclosed by " "keywords \"stream\" / \"endstream\"), and the null object (\"null\") " "(:ref:`AdobeManual` p. 13). Objects can be made identifiable by assigning" " a label. This label is then called *indirect* object. PyMuPDF supports " "retrieving definitions of indirect objects via their cross reference " "number via :meth:`Document.xref_object`." msgstr "" "Pythonに類似して、PDFはオブジェクトの概念をサポートしており、8つの基本型があります：ブール値（「true」または「false」）、整数と実数、文字列（常に括弧で囲まれています" " - 「()」または「<>」で16進数を示す）、名前（必ず「/」で始まる必要があります、例： " "`/Contents`）、配列（括弧「[]」で囲まれています）、辞書（括弧「<<>>」で囲まれています）、ストリーム（キーワード「stream」/「endstream」で囲まれています）、およびヌルオブジェクト（「null」）（:ref:`AdobeManual`" " p. " "13）。オブジェクトはラベルを割り当てることで識別可能にすることができます。このラベルは、間接オブジェクトと呼ばれます。PyMuPDFは、:meth:`Document.xref_object`" " を介して間接オブジェクトの定義をクロスリファレンス番号を使って取得することができます。" #: ../../glossary.rst:124 65f67d11513245eea25bbcfe453941d4 msgid "" "A PDF :data:`dictionary` :data:`object` type which is followed by a " "sequence of bytes, similar to Python *bytes*. \"However, a PDF " "application can read a stream incrementally, while a string must be read " "in its entirety. Furthermore, a stream can be of unlimited length, " "whereas a string is subject to an implementation limit. For this reason, " "objects with potentially large amounts of data, such as images and page " "descriptions, are represented as streams.\" \"A stream consists of a " ":data:`dictionary` followed by zero or more bytes bracketed between the " "keywords *stream* and *endstream*\"::" msgstr "" "PDFの :data:`dictionary` :data:`object` " "タイプで、Pythonのbytesに似たバイト列が続きます。ただし、「PDFアプリケーションはストリームを段階的に読むことができますが、文字列は完全に読む必要があります。さらに、ストリームの長さは無制限ですが、文字列は実装の制限に従います。そのため、画像やページの説明などの大量のデータを含むオブジェクトは、ストリームとして表現されます。」「ストリームは、キーワード「stream」と「endstream」で囲まれた0バイト以上のバイトで構成される" " :data:`dictionary` の後に続きます」::" #: ../../glossary.rst:135 1f0727e3f450432f9923a4ffd2cc8cee msgid "" "See :ref:`AdobeManual` p. 19. PyMuPDF supports retrieving stream content " "via :meth:`Document.xref_stream`. Use :meth:`Document.is_stream` to " "determine whether an object is of stream type." msgstr "" ":ref:`AdobeManual` p. 19を参照してください。PyMuPDFは、:meth:`Document.xref_stream` " "を介してストリームコンテンツを取得するサポートを提供しています。オブジェクトがストリームタイプかどうかを判断するには、:meth:`Document.is_stream`" " を使用します。" #: ../../glossary.rst:139 d732f9dcef7e47028ca43a5647adcb9c msgid "" "A mathematical notion meaning a vector of norm (\"length\") 1 -- usually " "the Euclidean norm is implied. In PyMuPDF, this term is restricted to " ":ref:`Point` objects, see :attr:`Point.unit`." msgstr "" "数学的な概念で、ノルム（「長さ」）が1のベクトルを意味します。通常、ユークリッドノルムが含まれます。PyMuPDFでは、この用語は " ":ref:`Point` オブジェクトに制限されます。:attr:`Point.unit` を参照してください。" #: ../../glossary.rst:143 26fb51d68f234a088d1702a7b331d879 msgid "" "Abbreviation for cross-reference number: this is an integer unique " "identification for objects in a PDF. There exists a cross-reference table" " (which may physically consist of several separate segments) in each PDF," " which stores the relative position of each object for quick lookup. The " "cross-reference table is one entry longer than the number of existing " "object: item zero is reserved and must not be used in any way. Many " "PyMuPDF classes have an :data:`xref` attribute (which is zero for non-" "PDFs), and one can find out the total number of objects in a PDF via " ":meth:`Document.xref_length` *- 1*." msgstr "" "クロスリファレンス番号の省略形：これはPDF内のオブジェクトに対する一意の識別子である整数です。各PDFにはクロスリファレンステーブルが存在し（物理的には複数の別々のセグメントで構成される場合があります）、各オブジェクトの相対位置をクイックルックアップのために保存します。クロスリファレンステーブルは既存のオブジェクトの数よりも1つ長いエントリを持っており、アイテム0は予約され、何の方法でも使用してはいけません。多くのPyMuPDFクラスにはxref属性（非PDFの場合はゼロ）があり、:meth:`Document.xref_length`" " - 1を介してPDF内のオブジェクトの総数を知ることができます。" #: ../../glossary.rst:148 6c021fd6a5aa44d7b8b3e0905f3f7b08 msgid "" "When referring to font size this metric is measured in points where 1 " "inch = 72 points." msgstr "フォントサイズを指す際、このメトリックは1インチ = 72ポイントとして測定されます。" #: ../../glossary.rst:152 c558da0bdc1446d89fcd51030a930245 msgid "" "Images and :ref:`Pixmap` objects may contain resolution information " "provided as \"dots per inch\", dpi, in each direction (horizontal and " "vertical). When MuPDF reads an image from a file or from a PDF object, it" " will parse this information and put it in :attr:`Pixmap.xres`, " ":attr:`Pixmap.yres`, respectively. If it finds no meaningful information " "in the input (like non-positive values or values exceeding 4800), it will" " use \"sane\" defaults instead. The usual default value is 96, but it may" " also be 72 in some cases (e.g. for JPX images)." msgstr "" "イメージや :ref:`Pixmap` " "オブジェクトには、各方向（水平および垂直）の「インチあたりのドット数」である解像度情報が含まれている場合があります。MuPDFはファイルまたはPDFオブジェクトからイメージを読み取る際、この情報を解析し、それぞれ" " :attr:`Pixmap.xres` 、:attr:`Pixmap.yres` " "に設定します。入力内で有意義な情報が見つからない場合（非正の値や4800を超える値など）、代わりに「適切な」デフォルト値を使用します。通常のデフォルト値は96ですが、一部の場合（例えばJPXイメージの場合）は72になる場合もあります。" #: ../../glossary.rst:156 8e9c840d574c4b3d8c897a834b9362df msgid "" "Optional content properties dictionary - a sub :data:`dictionary` of the " "PDF :data:`catalog`. The central place to store optional content " "information, which is identified by the key `/OCProperties`. This " "dictionary has two required and one optional entry: (1) `/OCGs`, " "required, an array listing all optional content groups, (2) `/D`, " "required, the default optional content configuration dictionary (OCCD), " "(3) `/Configs`, optional, an array of alternative OCCDs." msgstr "" "オプショナルコンテンツプロパティ辞書（OCPD） - PDF :data:`catalog` のサブ " ":data:`dictionary`。オプショナルコンテンツ情報を保存する中心的な場所で、キー `/OCProperties` " "で識別されます。この辞書には2つの必須エントリと1つのオプションエントリがあります：（1） `/OCGs` " "、必須、すべてのオプショナルコンテンツグループをリストする配列、（2） `/D` " "、必須、デフォルトのオプショナルコンテンツ構成辞書（OCCD）、（3） `/Configs` 、オプション、代替のOCCDの配列。" #: ../../glossary.rst:161 0100632cdca744f69f1f6913c969d05d msgid "" "Optional content configuration dictionary - a PDF :data:`dictionary` " "inside the PDF :data:`OCPD`. It stores a setting of ON / OFF states of " "OCGs and how they are presented to a PDF viewer program. Selecting a " "configuration is quick way to achieve temporary mass visibility state " "changes. After opening a PDF, the `/D` configuration of the :data:`OCPD` " "is always activated. Viewer should offer a way to switch between the " "`/D`, or one of the optional configurations contained in array " "`/Configs`." msgstr "" "オプショナルコンテンツ構成辞書（OCCD） - PDF :data:`OCPD` 内のPDF " ":data:`dictionary`。これはOCGのON / " "OFF状態とPDFビューアプログラムにどのように表示されるかの設定を保存します。構成を選択することは、一時的な質量表示状態の変更を素早く行う方法です。PDFを開いた後、:data:`OCPD`" " の `/D` 構成は常にアクティブになります。ビューアは `/D` 、または配列 `/Configs` " "に含まれるオプショナル構成のいずれかに切り替える方法を提供する必要があります。" #: ../../glossary.rst:166 43b7c2249e154c59bf5a59cfd2cf86e2 msgid "" "Optional content group -- a :data:`dictionary` object used to control the" " visibility of other PDF objects like images or annotations. " "Independently on which page they are defined, objects with the same OCG " "can simultaneously be shown or hidden by setting their OCG to ON or OFF. " "This can be achieved via the user interface provided by many PDF viewers " "(Adobe Acrobat), or programmatically." msgstr "" "オプショナルコンテンツグループ（OCG） - 画像や注釈などの他のPDFオブジェクトの表示を制御するために使用される " ":data:`dictionary` " "オブジェクト。どのページで定義されているかに関係なく、同じOCGを持つオブジェクトは、OCGをONまたはOFFに設定することで同時に表示または非表示にできます。これは多くのPDFビューア（Adobe" " Acrobat）が提供するユーザーインターフェース、またはプログラムを使用して達成できます。" #: ../../glossary.rst:170 f4ba5ac63bea490bbc335d7fade50a6b msgid "" "Optional content membership dictionary -- a :data:`dictionary` object " "which can be used like an :data:`OCG`: it has a visibility state. The " "visibility of an OCMD is **computed:** it is a logical expression, which " "uses the state of one or more OCGs to produce a boolean value. The " "expression's result is interpreted as ON (true) or OFF (false)." msgstr "" "オプショナルコンテンツメンバーシップ辞書（OCMD） - :data:`OCG` " "のように使用できる辞書オブジェクトで、表示状態を持ちます。OCMDの表示は計算されます：これはOCGの1つ以上の状態を使用してブール値を生成する論理式です。式の結果はON（true）またはOFF（false）として解釈されます。" #: ../../glossary.rst:174 522b5dde5e3b49df8ab57178f4d58ed1 msgid "" "Some frequent character combinations are represented by their own special" " glyphs in more advanced fonts. Typical examples are \"fi\", \"fl\", " "\"ffi\" and \"ffl\". These compounds are called *ligatures*. In PyMuPDF " "text extractions, there is the option to either return the corresponding " "unicode unchanged, or split ligatures up into their constituent parts: " "\"fi\" ==> \"f\" + \"i\", etc." msgstr "" "一部の頻繁な文字の組み合わせは、より高度なフォントでは固有の特別なグリフで表されます。典型的な例には「fi」、「fl」、「ffi」、「ffl」などがあります。これらの複合体はリガチャと呼ばれます。PyMuPDFのテキスト抽出では、対応するユニコードを変更せずに返すオプションがあり、またリガチャをその構成要素に分割することもできます：「fi」" " ==> 「f」+「i」など。" #: ../../footer.rst:60 04c382aafad34653bc0f596f100e3271 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/header-404.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.26\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-03-05 14:46+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header-404.rst:-1 c2c49975f2854128bb488c59ce955f84 msgid "Artifex" msgstr "" #: ../../header-404.rst:-1 371ca3eaed8242b8bf4e8df0b45a6113 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header-404.rst:-1 a60c91d091c44274bed060f48efb71b1 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" ================================================ FILE: docs/locales/ja/LC_MESSAGES/header.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-09-28 14:54+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 5eedbfe14cba4a21b822c8197f635c3f msgid "Artifex" msgstr "" #: ../../header.rst:-1 ef34ef4fc02843218e7c1e16cfb6fe2f msgid "PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 93ea3b2b433546f9b198b2f2455bb6df msgid "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" ================================================ FILE: docs/locales/ja/LC_MESSAGES/how-to-open-a-file.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 21b5c4028adc463abcc84975940e6301 msgid "Artifex" msgstr "" #: ../../header.rst:-1 ee82d615395c4e24b8b07395ed871d70 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 1d5b2478c53f433882bce199582d444d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../how-to-open-a-file.rst:7 5ea3d22849e641d897ccb82f8a12500f msgid "Opening Files" msgstr "ファイルを開く" #: ../../how-to-open-a-file.rst:16 395abd8299ba47be838498d680488494 msgid "Supported File Types" msgstr "サポートされているファイルタイプ" #: ../../how-to-open-a-file.rst:21 cb3463a996b24a14a008c2fc0ad2b685 msgid "PyMuPDF" msgstr "" #: ../../how-to-open-a-file.rst:23 036ac377808741358875a6692e0b2d95 msgid "|PyMuPDF| can open files other than just |PDF|." msgstr "|PyMuPDF| は |PDF| 以外のファイルも開くことができます。" #: ../../how-to-open-a-file.rst:25 ../../how-to-open-a-file.rst:38 #: 1a17fc4b2c2e43a9a47e3a2a1ed82bd4 40ef4134dff248bc8869aed36fd176fc msgid "The following file types are supported:" msgstr "|PyMuPDF| は以下のファイルタイプをサポートしています：" #: ../../how-to-open-a-file.rst:34 fa9ae965eea142478505848892067bb0 msgid "PyMuPDF Pro" msgstr "" #: ../../how-to-open-a-file.rst:36 c4725d269a0e41b0867c5b6b16b8960b msgid "|PyMuPDF Pro| can open Office files." msgstr "" #: ../../how-to-open-a-file.rst:43 d91d49bc138843188ab0077259cd82ae msgid "**DOC/DOCX**" msgstr "" #: ../../how-to-open-a-file.rst:44 6ff3d492743f45da9b9967b7ac205f1c msgid "**XLS/XLSX**" msgstr "" #: ../../how-to-open-a-file.rst:45 4c317c161ef64bebb742fc17e8e5c6d3 msgid "**PPT/PPTX**" msgstr "" #: ../../how-to-open-a-file.rst:46 dfd0df787a6d4a8bada3b55675495889 msgid "**HWP/HWPX**" msgstr "" #: ../../how-to-open-a-file.rst:63 61701c1d1007436987106ec058719b82 msgid "How to Open a File" msgstr "ファイルを開く方法" #: ../../how-to-open-a-file.rst:65 9dd2157acd454f2ea9e62168276399c2 msgid "To open a file, do the following:" msgstr "ファイルを開くには、次の手順を実行します。" #: ../../how-to-open-a-file.rst:72 284b59b0b7ca41789da44c7d61f81fc7 msgid "" "The above creates a :ref:`Document`. The instruction `doc = " "pymupdf.Document(\"a.pdf\")` does exactly the same. So, `open` is just a " "convenient alias and you can find its full API documented in that " "chapter." msgstr "" #: ../../how-to-open-a-file.rst:76 1a5ad0264ff94231899c2caafe461a22 #, fuzzy msgid "" "File Recognizer: Opening with :index:`a Wrong File Extension `" msgstr "拡張子の異なるファイルを開く" #: ../../how-to-open-a-file.rst:78 90b4fc7ee95f43f49a70a15c890eb8b8 #, fuzzy msgid "" "If you have a document with a wrong file extension for its type, do not " "worry: it will still be opened correctly, thanks to the integrated file " "\"content recognizer\"." msgstr "拡張子がファイルタイプと異なっていても、正しく開くことができます。" #: ../../how-to-open-a-file.rst:80 792fc8fc530d4591b0673684e9d0b274 msgid "" "This component looks at the actual data in the file using a number of " "heuristics -- independent of the file extension. This of course is also " "true for file names **without** an extension." msgstr "" #: ../../how-to-open-a-file.rst:82 8eec48ad8d35400f93aa9ef384f1baee msgid "Here is a list of details about how the file content recognizer works:" msgstr "" #: ../../how-to-open-a-file.rst:84 999889fc95024292bbe0dc81938a321a msgid "" "When opening from a file name, use the ``filetype`` parameter if your " "file format cannot be determined by content inspection. This is for " "instance the case for all text files: \"txt\", \"html\", \"xml\" or " "source files. If the file extension is missing or wrong or the file " "resides in memory, the ``filetype`` must be used. File formats that can " "successfully be recognized will be opened even without or wrong " "extensions, and the ``filetype`` paraneter will be ignored." msgstr "" #: ../../how-to-open-a-file.rst:86 1ac5dd5257eb4ed280e6ec3ed082da31 msgid "" "Files based on text content do not contain unambiguously recognizable " "internal structures. This is true for source files (Python, C, etc.) but " "also HTML, XML and so on. Here, the file extensions and the ``filetype`` " "parameter continue to play a role and are used to create a \"Tex\" / " "\"HTML\" / ... document. Correspondingly, text files with other / no " "extensions, can successfully be opened using ``filetype``." msgstr "" #: ../../how-to-open-a-file.rst:92 b9b6d23c55ea4547afea0a22f2d79c6d #, fuzzy msgid "Opening Remote Files" msgstr "ファイルを開く" #: ../../how-to-open-a-file.rst:95 3b43bf59bfc148328c683743eac1329f msgid "" "For remote files on a server (i.e. non-local files), you will need to " "*stream* the file data to |PyMuPDF|." msgstr "" #: ../../how-to-open-a-file.rst:97 34b7bf2e937a4250810966ed193bdfc8 msgid "" "For example use the `requests " "`_ library as follows:" msgstr "" #: ../../how-to-open-a-file.rst:110 f259d8091f7242e7bdd2c51ebdd3f925 msgid "Opening Files from Cloud Services" msgstr "" #: ../../how-to-open-a-file.rst:112 21d40cb6351a4c69bc14196e1eb014ea msgid "" "For further examples which deal with files held on typical cloud services" " please see these `Cloud Interactions code snippets " "`_." msgstr "" #: ../../how-to-open-a-file.rst:120 de92d6a4c46143de86751bded4adc336 #, fuzzy msgid "Opening Django Files" msgstr "C# ファイルを開く" #: ../../how-to-open-a-file.rst:122 2a24401c8daf4ec1967ffd20ab41ce1c msgid "" "Django implements a `File Storage API " "`_ to store " "files. The default is the `FileSystemStorage " "`_, but the `django-storages `_ library provides a number" " of other storage backends." msgstr "" #: ../../how-to-open-a-file.rst:124 ce91bc54879b4e0caad6216633c87800 msgid "" "You can open the file, move the contents into memory, then pass the " "contents to |PyMuPDF| as a stream." msgstr "" #: ../../how-to-open-a-file.rst:139 619bd327f13f4ed1a9204d62ce0a0e40 msgid "Please note that if the file you open is large, you may run out of memory." msgstr "" #: ../../how-to-open-a-file.rst:141 e974ef8989724d7ca39ae4e2f528060d msgid "" "The File Storage API works well if you're using different storage " "backends in different environments. If you're only using the " "`FileSystemStorage`, you can simply use the `obj.file.name` to open the " "file directly with |PyMuPDF| as shown in an earlier example." msgstr "" #: ../../how-to-open-a-file.rst:149 11fadcb68ef146fc93ca9f4473e140a5 msgid "Opening Files as Text" msgstr "ファイルをテキストとして開く" #: ../../how-to-open-a-file.rst:152 79658fdcc60c4f62821491708e3874a6 msgid "" "|PyMuPDF| has the capability to open any plain text file as a document. " "In order to do this you should provide the `filetype` parameter for the " "`pymupdf.open` function as `\"txt\"`." msgstr "" "|PyMuPDF| には、プレーン テキスト ファイルをドキュメントとして開く機能があります。 これを行うには、`pymupdf.open` " "関数の `filetype` パラメータを「txt」として指定する必要があります。" #: ../../how-to-open-a-file.rst:159 d72a0b8f986843488dfc6ddc257e4f45 msgid "" "In this way you are able to open a variety of file types and perform the " "typical **non-PDF** specific features like text searching, text " "extracting and page rendering. Obviously, once you have rendered your " "`txt` content, then saving as |PDF| or merging with other |PDF| files is " "no problem." msgstr "" "このようにして、さまざまな種類のファイルを開いて、テキスト検索、テキスト抽出、ページ レンダリングなどの |PDF| " "に固有ではない一般的な機能を実行できます。 明らかに、txt コンテンツをレンダリングしたら、 |PDF| として保存したり、他の |PDF| " "ファイルと結合したりすることは問題ありません。" #: ../../how-to-open-a-file.rst:163 25cb1a49799b43669b7c520e52fc2e46 msgid "Examples" msgstr "例" #: ../../how-to-open-a-file.rst:167 df4ce47e55a94298b344689b280a64df msgid "Opening a `C#` file" msgstr "C# ファイルを開く" #: ../../how-to-open-a-file.rst:176 2f20ca6b671845fca3ae2bceeb25eebd msgid "Opening an ``XML`` file" msgstr "XML ファイルを開く" #: ../../how-to-open-a-file.rst:184 1c25e62b57d843c9b5b8122f59295144 msgid "Opening a `JSON` file" msgstr "JSON ファイルを開く" #: ../../how-to-open-a-file.rst:191 687e69a017bb48b682d8b720ad323f52 msgid "And so on!" msgstr "等々！" #: ../../how-to-open-a-file.rst:193 f6ae4e85cdb1469bbf04502e1bb02ccd msgid "" "As you can imagine many text based file formats can be *very simply " "opened* and *interpreted* by |PyMuPDF|. This can make data analysis and " "extraction for a wide range of previously unavailable files possible." msgstr "" "ご想像のとおり、多くのテキスト ベースのファイル形式は、|PyMuPDF| によって非常に簡単に開いて解釈できます。 " "これにより、これまで利用できなかった広範囲のファイルのデータ分析と抽出が突然可能になります。" #: ../../footer.rst:46 6894d49c24fc4cfa8f9d99a9257edfdf msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "The above creates a :ref:`Document`. The" #~ " instruction `doc = pymupdf.Document(\"a.pdf\")`" #~ " does exactly the same. So, `open`" #~ " is just a convenient alias and " #~ "you can find its full API " #~ "documented in that chapter." #~ msgstr "" #~ msgid "Assume that *\"some.file\"* is actually an **XPS**. Open it like so:" #~ msgstr "例えば *\"some.file\"* が実際には **XPS** ファイルの場合は、以下のようにして開きます：" #~ msgid "" #~ "|PyMuPDF| itself does not try to " #~ "determine the file type from the " #~ "file contents. **You** are responsible " #~ "for supplying the file type information" #~ " in some way -- either implicitly," #~ " via the file extension, or " #~ "explicitly as shown with the `filetype`" #~ " parameter. There are pure :title:`Python`" #~ " packages like `filetype " #~ "`_ that help you" #~ " doing this. Also consult the " #~ ":ref:`Document` chapter for a full " #~ "description." #~ msgstr "" #~ "|PyMuPDF| " #~ "自体は、ファイルの内容からファイルタイプを判断しようとはしません。このため、ユーザーがファイルの拡張子などを通じて暗黙的に、または " #~ "`filetype `_ " #~ "パラメーターを通じて明示的にファイルタイプの情報を提供する責任があります。また、詳細な説明については " #~ ":ref:`Document` の章を参照してください。" #~ msgid "" #~ "If |PyMuPDF| encounters a file with " #~ "an unknown / missing extension, it " #~ "will try to open it as a " #~ "|PDF|. So in these cases there is" #~ " no need for additional precautions. " #~ "Similarly, for memory documents, you can" #~ " just specify `doc=pymupdf.open(stream=mem_area)` " #~ "to open it as a |PDF| document." #~ msgstr "" #~ "|PyMuPDF| " #~ "は不明なファイルや拡張子のないファイルはPDFとして開きます。このため、これらの場合は追加の情報は必要ありません。同様に、メモリ上のドキュメントの場合は、`doc=pymupdf.open(stream=mem_area)`" #~ " と指定するだけでPDFドキュメントとして開くことができます。" #~ msgid "" #~ "If you attempt to open an " #~ "unsupported file then |PyMuPDF| will " #~ "throw a file data error." #~ msgstr "サポートされていないファイルを開こうとした場合、PyMuPDFはファイルデータエラーをスローします。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/identity.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7b37ecd8dc3743a9a786f62dd0bec6f7 msgid "Artifex" msgstr "" #: ../../header.rst:-1 7dda5857ca604606b110ce5cddbf35fa msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 024f5eebaeb24a6ea2775fd31cbf04c8 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../identity.rst:7 74c7b4d54f2f490aa6411228918d1102 msgid "Identity" msgstr "Identity (アイデンティティ)" #: ../../identity.rst:9 9eea7980a3264df58d614219614f391d msgid "" "Identity is a :ref:`Matrix` that performs no action -- to be used " "whenever the syntax requires a matrix, but no actual transformation " "should take place. It has the form *pymupdf.Matrix(1, 0, 0, 1, 0, 0)*." msgstr "" "アイデンティティは、何もアクションを実行しない :ref:`Matrix` " "で、構文がマトリックスを必要とするが実際の変換が必要ない場合に使用されます。それは *pymupdf.Matrix(1, 0, 0, 1, 0," " 0)* の形をしています。" #: ../../identity.rst:11 cf3f047b3bcd457781d6d1b0a6555a40 msgid "" "Identity is a constant, an \"immutable\" object. So, all of its matrix " "properties are read-only and its methods are disabled." msgstr "アイデンティティは、定数であり、変更できない「不変」のオブジェクトです。そのため、すべてのマトリックスのプロパティは読み取り専用であり、そのメソッドは無効になっています。" #: ../../identity.rst:13 0eeb4dcb5f1f4643912b79cb1dc0929a msgid "" "If you need a **mutable** identity matrix as a starting point, use one of" " the following statements::" msgstr "**変更可能な** アイデンティティマトリックスが必要な場合、次の文のいずれかを使用してください::" #: ../../footer.rst:60 d7eead894067453da2f782c487c8f59e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/index.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../index.rst:33 8fd6f740bd354549b09f02e29d6aeb9f msgid "About" msgstr "" #: ../../index.rst:42 325ca6b150394307ad977ddc59e8199c msgid "User Guide" msgstr "ユーザーガイド" #: ../../index.rst:54 55f11e9ee1a448aaa422415824a72910 msgid "How to Guide" msgstr "使用方法ガイド" #: ../../index.rst:61 382947f10dad49e09057aef86f6b7bdf msgid "API Reference" msgstr "APIリファレンス" #: ../../index.rst:74 cf7180ed975342a3ad0632f165b96c7b msgid "Other" msgstr "その他" #: ../../header.rst:-1 17cdca8041b545be91c717e1482c6e92 msgid "Artifex" msgstr "" #: ../../header.rst:-1 929d834795de4b6c9c42aede9d848712 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 883d9811455e45eea8d6c2f3434cae01 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../index.rst:20 8cfb3ae729874f858ac4b9e18e20bf6a msgid "Welcome to |PyMuPDF|" msgstr "PyMuPDFへようこそ" #: ../../index.rst:22 32ae9730ead142168b8b4abaaef4b7c3 msgid "" "|PyMuPDF| is a high-performance **Python** library for data extraction, " "analysis, conversion & manipulation of |PDF| (and other) documents." msgstr "" "|PyMuPDF| は、|PDF| （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な :title:`Python` " "ライブラリです。" #: ../../index.rst:24 6a8830c4d9b54905a1ec1b90ebb54e90 msgid "" "|PyMuPDF| is hosted on `GitHub `_ and" " registered on `PyPI `_." msgstr "" "|PyMuPDF| は `GitHub `_ でホストされ、`PyPI" " `_ に登録されています。" #: ../../footer.rst:60 ../../index.rst:29 11945e0949f341ad9d1670429005389a #: ec790aafb26941e99e919f9eba35a52e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Find out about **PyMuPDF Utilities**" #~ msgstr "PyMuPDF Utilitiesについて詳しく知る" #~ msgid "" #~ "The :title:`GitHub` repository `PyMuPDF-" #~ "Utilities `_" #~ " contains a full range of examples," #~ " demonstrations and use cases." #~ msgstr "" #~ "GitHubリポジトリ `PyMuPDF-Utilities " #~ "`_ " #~ "には、さまざまな例、デモンストレーション、およびユースケースが含まれています。" #~ msgid "Do you need |PDF| to **DOCX** conversion?" #~ msgstr "|PDF| から **DOCX** への変換が必要ですか?" #~ msgid "" #~ "We recommend the pdf2docx_ library which" #~ " uses |PyMuPDF| and the **python-" #~ "docx** library to provide simple " #~ "document conversion from |PDF| to " #~ "**DOCX** format." #~ msgstr "" #~ "|PyMuPDF| を使用する pdf2docx_ ライブラリと、|PDF| から " #~ "**DOCX** 形式への簡単なドキュメント変換を提供する **python-docx** " #~ "ライブラリをお勧めします。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/installation.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 bc107b9bc1f9411db1b06a2b9a73ce64 msgid "Artifex" msgstr "" #: ../../header.rst:-1 d7d772a2db0344ea81f7e2d671249a0d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 3d75e7a13d97463585cb89b8a4cf50e2 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../installation.rst:6 ../../installation.rst:31 #: 0e5b938092394f76bb79bd60b8b7bcc8 362130f7ee184277a844a2094e73b166 msgid "Installation" msgstr "インストール" #: ../../installation.rst:9 5756ccf1a8cf47d489d528757b4ff1ed msgid "Requirements" msgstr "要件" #: ../../installation.rst:11 59418d8369d141eb9ff64af78a5cd0d1 msgid "" "All the examples below assume that you are running inside a Python " "virtual environment. See: https://docs.python.org/3/library/venv.html for" " details. We also assume that `pip` is up to date." msgstr "" "以下のすべての例は、Pythonの仮想環境内で実行していると仮定しています。詳細については、https://docs.python.org/3/library/venv.html" " を参照してください。また、pipが最新であると仮定しています。" #: ../../installation.rst:15 c0c567ab87e545dcb02f98a499237cac msgid "For example:" msgstr "例えば:" #: ../../installation.rst:17 3566b454695c4d74836795503dc32f88 msgid "Windows::" msgstr "" #: ../../installation.rst:23 30d9561c3bbd45f79998c3672a481495 msgid "Linux, MacOS::" msgstr "" #: ../../installation.rst:33 a214d3639973479385b1f7fb97f49eb2 #, fuzzy msgid "|PyMuPDF| should be installed using pip with::" msgstr "PyMuPDFをインストールするには、次のようにpipを使用してください::" #: ../../installation.rst:37 ea5698bf08544d95ab4dfd879681ba77 msgid "" "This will install from a Python wheel if one is available for your " "platform." msgstr "この方法でインストールすると、対象のプラットフォームに対応するPythonのwheelファイルがある場合は、それを使用してインストールされます。" #: ../../installation.rst:41 41710c287f054c699809c8bb0c6be619 msgid "Installation when a suitable wheel is not available" msgstr "適切なwheelファイルが利用できない場合のインストール方法" #: ../../installation.rst:43 edcf8eac64af49bb9cbe25cbe7de7c5a msgid "" "If a suitable Python wheel is not available, pip will automatically build" " from source using a Python sdist." msgstr "適切なPythonのwheelファイルが利用できない場合、pipは自動的にPythonのsdistからビルドします。" #: ../../installation.rst:46 10c33b59ba9e4c868ae010f2a7028814 msgid "**This requires C/C++ development tools to be installed**:" msgstr "**これにはC/C++の開発ツールがインストールされている必要があります：**" #: ../../installation.rst:48 5ad6beabf5d6474dab9c471133784cb8 msgid "On Windows:" msgstr "Windowsの場合:" #: ../../installation.rst:51 c850480032484111ad409c8a6d7cc794 msgid "" "Install Visual Studio 2019. If not installed in a standard location, set " "environmental variable `PYMUPDF_SETUP_DEVENV` to the location of the " "`devenv.com` binary." msgstr "" "Visual Studio 2019をインストールしてください。標準の場所にインストールされていない場合は、環境変数 " "`PYMUPDF_SETUP_DEVENV` を `devenv.com` バイナリの場所に設定してください" #: ../../installation.rst:56 65947958187d45018d139034858bc083 msgid "" "Having other installed versions of Visual Studio, for example Visual " "Studio 2022, can cause problems because one can end up with MuPDF and " "PyMuPDF code being compiled with different compiler versions." msgstr "" "他のバージョンのVisual Studio（例：Visual Studio " "2022）がインストールされている場合、異なるコンパイラバージョンでMuPDFとPyMuPDFのコードがコンパイルされる可能性があるため、問題が発生することがあります。" #: ../../installation.rst:60 9e448ffec0c64a40968de3839f6b2855 msgid "The build will automatically download and build MuPDF." msgstr "自動的にMuPDFをダウンロードしてビルドします。" #: ../../installation.rst:66 9ea3e134885d4f05a4c3e2a4f5bc1095 msgid "Problems after installation" msgstr "インストール後の問題" #: ../../installation.rst:68 ../../installation.rst:117 #: 0d4df66268c544a69e1dba24527b39dc da5b4f00d11844939c6ba2c50436cde5 msgid "On Windows, Python error::" msgstr "" #: ../../installation.rst:72 05623aa04f7948f1928a5424140c8d9d msgid "" "This has been occasionally seen if `MSVCP140.dll` is missing, and appears" " to be caused by a bug in some versions (2015-2017) of `Microsoft Visual " "C++ Redistributables`." msgstr "" "これは、`MSVCP140.dll` が見つからない場合に時折発生し、`Microsoft Visual C++` " "再頒布可能パッケージの一部のバージョン (2015 ～ 2017) のバグが原因であると思われます。" #: ../../installation.rst:76 9472b21821c84665a04e27961520861f msgid "" "It is recommended to search for `MSVCP140.dll` in https://msdn.com to " "find instructions for how to reinstall it. For example " "https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist has " "permalinks to the latest supported versions." msgstr "" "https://msdn.com で `MSVCP140.dll` を検索して、再インストールする方法の手順を見つけることをお勧めします。 " "たとえば、https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist " "には、サポートされている最新バージョンへのパーマリンクがあります。" #: ../../installation.rst:81 3007dd23091741939a53721b7d628b74 msgid "See https://github.com/pymupdf/PyMuPDF/issues/2678 for more details." msgstr "詳細については、https://github.com/pymupdf/PyMuPDF/issues/2678 を参照してください。" #: ../../installation.rst:84 c9a39b500d3d45a1b18d1c3f00c2982e msgid "Python error::" msgstr "" #: ../../installation.rst:88 53589cbbfa6944378c7034ed948fa3b4 msgid "" "This can happen if PyMuPDF's legacy name `fitz` is used (for example " "`import fitz` instead of `import pymupdf`), and an unrelated Python " "package called `fitz` (https://pypi.org/project/fitz/) is installed." msgstr "" #: ../../installation.rst:92 f32677d324ec471f8b25f4becffc62f5 msgid "" "The fitz package appears to be no longer maintained (the latest release " "is from 2017), but unfortunately it does not seem possible to remove it " "from pypi.org. It does not even work on its own, as well as breaking the " "use of PyMuPDF's legacy name." msgstr "" #: ../../installation.rst:97 31c58415e64d4285b88f8e33a6d97802 msgid "There are a few ways to avoid this problem:" msgstr "" #: ../../installation.rst:100 3f88b66501a544699823982b2254031f msgid "" "Use `import pymupdf` instead of `import fitz`, and update one's code to " "match." msgstr "" #: ../../installation.rst:103 eb2fe6e966f44853b6678fc67361a0c0 msgid "Or uninstall the `fitz` package and reinstall PyMuPDF::" msgstr "" #: ../../installation.rst:108 f733312e30d5442d8681d28dfc2e0418 msgid "Or use `import pymupdf as fitz`. However this has not been well tested." msgstr "" #: ../../installation.rst:110 d2942ed579c547888ca1290602ed28cc msgid "With Jupyter labs on Apple Silicon (arm64), Python error::" msgstr "" #: ../../installation.rst:114 3dedae1d6af9447eb2192ed96052aa90 msgid "" "This appears to be a problem in Jupyter labs; see: " "https://github.com/pymupdf/PyMuPDF/issues/3643#issuecomment-2210588778." msgstr "" #: ../../installation.rst:121 7bd3b3ebec5f4f07900684f56429ad36 msgid "" "This was reported 2025-03-26 in " "https://github.com/pymupdf/PyMuPDF/issues/4405." msgstr "" #: ../../installation.rst:123 b6139c99d78e45a6a9105ecc8404f710 msgid "The fix appears to be to install the latest `VC_redist.x64.exe`." msgstr "" #: ../../installation.rst:127 bccf958282944bd4ac99d1ccf70707d4 msgid "Notes" msgstr "メモ" #: ../../installation.rst:130 61583f96dcfd4261a2c77d364470a2ac msgid "Wheels are available for the following platforms:" msgstr "" #: ../../installation.rst:132 182364ca9ac94666825e7076e6d26a82 msgid "Windows 32-bit Intel." msgstr "" #: ../../installation.rst:133 005535b4e858480eb22fb9ed70cd49fe msgid "Windows 64-bit Intel." msgstr "" #: ../../installation.rst:134 7687fad16e9e41379221c5187c01a9f6 msgid "Linux 64-bit Intel." msgstr "" #: ../../installation.rst:135 e8bae64d60a44c078ddab450469e771d msgid "Linux 64-bit ARM." msgstr "" #: ../../installation.rst:136 2064ef5679e64d3db0b45c1dfbdff952 msgid "MacOS 64-bit Intel." msgstr "" #: ../../installation.rst:137 2190d152d5d0476b86a7e483d9bf4e00 msgid "MacOS 64-bit ARM." msgstr "" #: ../../installation.rst:139 5ba4832bb0ca40c3a6f960f5b5665e84 msgid "Details:" msgstr "" #: ../../installation.rst:141 41c9bfb953b447c484a012628de54f36 msgid "We release a single wheel for each of the above platforms." msgstr "" #: ../../installation.rst:144 8cf71ef8029a4d07ada650d699bfd1fc msgid "" "Each wheel uses the Python Stable ABI of the current oldest supported " "Python version (currently 3.10), and so works with all later Python " "versions, including new Python releases." msgstr "" #: ../../installation.rst:149 85f0cb2340464eacb0b93de71ce3a42b msgid "" "Wheels are tested on all Python versions currently marked as " "\"Supported\" on https://devguide.python.org/versions/, currently " "|python_versions|." msgstr "" #: ../../installation.rst:153 b10deebc967f4ab8bdb0f24ad98ed832 msgid "" "Wheels are not available for Python installed with `Chocolatey " "`_ on Windows. Instead install Python using the " "Windows installer from the python.org website, see: " "http://www.python.org/downloads" msgstr "" "`Chocolatey `_ " "を使用してWindowsにインストールされたPythonには、ホイールが利用できません。代わりに、python.orgのウェブサイトからWindowsインストーラーを使用してPythonをインストールしてください。詳細は、以下を参照してください：http://www.python.org/downloads" #: ../../installation.rst:159 624bcf09993d4be0ae0f8a75b8353859 msgid "" "Wheels are not available for Linux-aarch64 with `Musl libc " "`_ (For example `Alpine Linux " "`_ on aarch64), and building from source is " "known to fail." msgstr "" #: ../../installation.rst:164 efeb850ab27c435e9bdc7b4bfcce4292 msgid "" "There are no **mandatory** external dependencies. However, some optional " "feature are available only if additional components are installed:" msgstr "必須の外部依存関係はありません。ただし、追加のコンポーネントをインストールした場合にのみ、一部のオプション機能が利用可能です：" #: ../../installation.rst:166 112f6dc0117840bb96de1ccb40383a6e msgid "" "`Pillow `_ is required for " ":meth:`Pixmap.pil_save` and :meth:`Pixmap.pil_tobytes`." msgstr "" "`Pillow `_ は :meth:`Pixmap.pil_save` と " ":meth:`Pixmap.pil_tobytes` の実行に必要です。" #: ../../installation.rst:167 1ee77df6b8b94e6798a002846af1766e msgid "" "`fontTools `_ is required for " ":meth:`Document.subset_fonts`." msgstr "" "`fontTools `_ は " ":meth:`Document.subset_fonts` の実行に必要です。" #: ../../installation.rst:168 28cbd6c15f344131b911099e680559b0 msgid "" "`pymupdf-fonts `_ is a " "collection of nice fonts to be used for text output methods." msgstr "" "`pymupdf-fonts `_ " "は、テキスト出力の方法に使用するための素敵なフォントのコレクションです。" #: ../../installation.rst:170 4e52c3cf248c4abcb79594a420fd423f msgid "" "`Tesseract-OCR `_ for optical" " character recognition in images and document pages. Tesseract is " "separate software, not a Python package. To enable OCR functions in " "PyMuPDF, Tesseract must be installed and the `tessdata` folder name " "specified; see below." msgstr "" #: ../../installation.rst:176 c26a998174ff490b98bd7883858b8b37 msgid "" "You can install these additional components at any time -- before or " "after installing PyMuPDF. PyMuPDF will detect their presence during " "import or when the respective functions are being used." msgstr "これらの追加コンポーネントはいつでもインストールできます。PyMuPDFのインストール前または後に行うことができます。PyMuPDFは、これらのコンポーネントがインポート時または対応する機能が使用される際に検出します。" #: ../../installation.rst:180 06f197dc89334f00b8fde2aa343e6a2f msgid "Build and install from a local PyMuPDF source tree" msgstr "ローカルのPyMuPDFソースツリーからビルドしてインストールします" #: ../../installation.rst:182 a5b05e1ca807403ba4f04f8b040f4089 msgid "Initial setup:" msgstr "初期設定：" #: ../../installation.rst:184 6544cbacb1694401940667fbf45ebbe0 msgid "Install C/C++ development tools as described above." msgstr "上記に記載されているように、C/C++の開発ツールをインストールしてください。" #: ../../installation.rst:185 0645317ab66746168a76c49a26e93d39 msgid "Enter a Python venv and update pip, as described above." msgstr "上記に記載されているように、Pythonのvenvに入り、pipをアップデートしてください。" #: ../../installation.rst:187 82271eef944e4faf817e14c489cd2c16 msgid "Get a PyMuPDF source tree:" msgstr "PyMuPDFのソースツリーを取得します：" #: ../../installation.rst:189 3c67a60c157048679a1dafd0e6abe5fb msgid "Clone the PyMuPDF git repository::" msgstr "PyMuPDFのGitリポジトリをクローンしてください::" #: ../../installation.rst:194 7b0c1e0a13d44979ab25c04feb345ad1 msgid "" "Or download and extract a `.zip` or `.tar.gz` source release from " "https://github.com/pymupdf/PyMuPDF/releases." msgstr "" "または、https://github.com/pymupdf/PyMuPDF/releases から `.zip` または `.tar.gz` " "形式のソースリリースをダウンロードして展開してください。" #: ../../installation.rst:197 9edcc8838b654d3a9e1882ee8edefa4c msgid "Then one can build PyMuPDF in two ways:" msgstr "PyMuPDFを2つの方法でビルドできます：" #: ../../installation.rst:199 575e45b815c94f7cad04f1b45e7c3d7f msgid "Build and install PyMuPDF with default MuPDF version::" msgstr "デフォルトのMuPDFバージョンでPyMuPDFをビルドしてインストール::" #: ../../installation.rst:203 bb7099833f204ff3829afd0cd54324cf msgid "" "This will automatically download a specific hard-coded MuPDF source " "release, and build it into PyMuPDF." msgstr "これにより、特定のハードコードされたMuPDFソースリリースが自動的にダウンロードされ、PyMuPDFにビルドされます。" #: ../../installation.rst:206 86e76ec90c1c4d7a89dcb112d69ccbba msgid "Or build and install PyMuPDF using a local MuPDF source tree:" msgstr "または、ローカルのMuPDFソースツリーを使用してPyMuPDFをビルドしてインストールします：" #: ../../installation.rst:208 b9853c693d1f49358428f38af93edc33 msgid "Clone the MuPDF git repository::" msgstr "MuPDFのGitリポジトリをクローンします：" #: ../../installation.rst:213 854b5ebfeb9847efb51d37d0f3e4c259 msgid "" "Build PyMuPDF, specifying the location of the local MuPDF tree with the " "environmental variables `PYMUPDF_SETUP_MUPDF_BUILD`::" msgstr "" "環境変数 `PYMUPDF_SETUP_MUPDF_BUILD` を使用して、ローカルな MuPDF ツリーの場所を指定して PyMuPDF " "をビルドします::" #: ../../installation.rst:218 24b5cda1241e4f36b5aaf31c8df91447 msgid "" "Also, one can build for different Python versions in the same PyMuPDF " "tree:" msgstr "同じPyMuPDFツリー内で異なるPythonバージョン用にビルドする方法：" #: ../../installation.rst:221 fc0b1a2699064aaaa377451775502e20 msgid "" "PyMuPDF will build for the version of Python that is being used to run " "`pip`. To run `pip` with a specific Python version, use `python -m pip` " "instead of `pip`." msgstr "" "PyMuPDF は、`pip` を実行する Python のバージョンに対応してビルドされます。特定の Python バージョンで pip " "を実行するには、`pip` の代わりに `python -m pip` を使用してください。" #: ../../installation.rst:225 dd80aa73dedb4313a237f8c77a2d783d msgid "So for example on Windows one can build different versions with::" msgstr "したがって、Windows 上で異なるバージョンをビルドする場合、次のようにできます::" #: ../../installation.rst:229 4fbc355486c04e7fb88bcdd8ffae7059 msgid "or::" msgstr "または::" #: ../../installation.rst:235 207c24c76f364447839aefe03523527b msgid "Running tests" msgstr "テストの実行" #: ../../installation.rst:237 052b595cbe1448d79c441e326e94f9d7 msgid "" "Having a PyMuPDF tree available allows one to run PyMuPDF's `pytest` test" " suite::" msgstr "PyMuPDFのディレクトリが利用可能な場合、PyMuPDFの `pytest` テストスイートを実行できます。::" #: ../../installation.rst:246 795e4545d04f4e04baa8a0527281f16e msgid "Notes about using a non-default MuPDF" msgstr "非デフォルトのMuPDFを使用する際の注意事項" #: ../../installation.rst:248 9a130c5a8a0946668b8885f28af8aa04 msgid "" "Using a non-default build of MuPDF by setting environmental variable " "`PYMUPDF_SETUP_MUPDF_BUILD` can cause various things to go wrong and so " "is not generally supported:" msgstr "" "環境変数 `PYMUPDF_SETUP_MUPDF_BUILD` " "を設定して非デフォルトのMuPDFビルドを使用すると、さまざまな問題が発生する可能性があるため、一般的にはサポートされていません。" #: ../../installation.rst:252 79b112fde2cc4475bbef94325d535a3d msgid "" "If MuPDF's major version number differs from what PyMuPDF uses by " "default, PyMuPDF can fail to build, because MuPDF's API can change " "between major versions." msgstr "もしMuPDFのメジャーバージョン番号がPyMuPDFがデフォルトで使用するものと異なる場合、PyMuPDFはビルドに失敗する可能性があります。なぜなら、MuPDFのAPIはメジャーバージョン間で変更されることがあるからです。" #: ../../installation.rst:256 26963aaabb354a0fb893981e3cd6b8d0 msgid "" "Runtime behaviour of PyMuPDF can change because MuPDF's runtime behaviour" " changes between different minor releases. This can also break some " "PyMuPDF tests." msgstr "PyMuPDFのランタイム動作は、異なるマイナーリリース間でMuPDFのランタイム動作が変更されるため、変わる可能性があります。これは一部のPyMuPDFのテストにも影響を及ぼすことがあります。" #: ../../installation.rst:260 cf6ea4f83bfa409381276082a6a8bdf9 msgid "" "If MuPDF was built with its default config instead of PyMuPDF's " "customised config (for example if MuPDF is a system install), it is " "possible that `tests/test_textbox.py:test_textbox3()` will fail. One can " "skip this particular test by adding `-k 'not test_textbox3'` to the " "`pytest` command line." msgstr "" "MuPDFがPyMuPDFのカスタマイズされた設定ではなく、デフォルトの設定でビルドされた場合（たとえば、MuPDFがシステムにインストールされた場合）、`tests/test_textbox.py:test_textbox3()`" " が失敗する可能性があります。この特定のテストをスキップするには、`pytest` コマンドラインに `-k 'not " "test_textbox3'` を追加してください。" #: ../../installation.rst:268 700f4d8e58e84935b6c6975860df3b8f msgid "Official PyMuPDF Linux wheels may not install on older Linux systems" msgstr "" #: ../../installation.rst:270 b47547ab827c4869a01099c6505cf69a msgid "Releases of PyMuPDF are incompatible with older Linux systems." msgstr "" #: ../../installation.rst:272 808eb6388cc546d782e08fad72571c1d msgid "" "For example as of 2025-09-03, `pip install pymupdf` does not work on some" " AWS Lambda systems - see " "https://github.com/pymupdf/PyMuPDF/discussions/4631." msgstr "" #: ../../installation.rst:275 debea54d4d7a43c2878628b326c0c3f0 msgid "" "This is because official PyMuPDF Linux wheels are built with a version of" " glibc determined by the current Python manylinux environment. These " "wheels are incompatible with Linux systems that have an older glibc." msgstr "" #: ../../installation.rst:279 bf75483c6b084df08b1cc5bd8206d1bf msgid "" "The official Python manylinux environment is updated periodically to use " "newer glibc versions, so new releases of PyMuPDF become increasingly " "incompatible with older Linux systems." msgstr "" #: ../../installation.rst:283 91117ed642e046819ecc665f9b6c9b50 msgid "" "There is nothing that can be done about this, other than updating older " "Linux systems, or building PyMuPDF locally from source." msgstr "" #: ../../installation.rst:286 e7b222da2a044c2fa1eedf9c819d97ca msgid "" "For more details, please see: `Python Packaging Authority " "`_." msgstr "" #: ../../installation.rst:290 4adbb8931dfd4590a44a57ffb3936e97 msgid "Packaging" msgstr "パッケージング" #: ../../installation.rst:292 53c33343b4c24290ad643762f5bbb050 msgid "See :doc:`packaging`." msgstr ":doc:`packaging` を参照してください。" #: ../../installation.rst:296 477e709115dd4d119aea37fb3a68a54b msgid "Using with Pyodide" msgstr "Pyodideとの使用" #: ../../installation.rst:298 28b8424d39f448fd863709fd16271d9a msgid "See :doc:`pyodide`." msgstr ":doc:`pyodide` を参照してください。" #: ../../installation.rst:304 05d1ad76d8ff49d8b8be1c318e026ccb msgid "Enabling Integrated OCR Support" msgstr "統合OCRサポートの有効化" #: ../../installation.rst:306 1088128a9ea343a09d2433086fcee140 msgid "" "If you do not intend to use this feature, skip this step. Otherwise, it " "is required for both installation paths: **from wheels and from " "sources.**" msgstr "" "もしこの機能を使用しない場合は、このステップをスキップしてください。それ以外の場合は、**ホイールからのインストールとソースからのインストールの両方**" " に必要です。" #: ../../installation.rst:308 18290d46b0854568b242288afd51a0da msgid "" "PyMuPDF will already contain all the logic to support OCR functions. But " "it additionally does need `Tesseract’s language support data " "`_." msgstr "" "PyMuPDFにはすでにOCR機能をサポートするためのロジックが含まれていますが、追加でTesseractの言語サポートデータが必要です。そのため" "、Tesseract-OCRのインストールが依然として必要です。" #: ../../installation.rst:310 0cbfeba7ee2e4382baa33ea4562e36c3 msgid "" "If not specified explicitly, PyMuPDF will attempt to find the installed " "Tesseract's tessdata, but this should probably not be relied upon." msgstr "" #: ../../installation.rst:313 340c284211c64d04a0a7705bbaed97a1 msgid "" "Otherwise PyMuPDF requires that Tesseract's language support folder is " "specified explicitly either in PyMuPDF OCR functions' `tessdata` " "arguments or `os.environ[\"TESSDATA_PREFIX\"]`." msgstr "" #: ../../installation.rst:317 4050e5d26f8d4fcebd4429bf4468f2c1 msgid "So for a working OCR functionality, make sure to complete this checklist:" msgstr "OCR機能を正常に動作させるために、以下のチェックリストを完了してください：" #: ../../installation.rst:319 ae04b692262d427da4c557773bbb6331 msgid "" "Locate Tesseract's language support folder. Typically you will find it " "here:" msgstr "Tesseractの言語サポートフォルダを見つけてください。通常、以下の場所にあります：" #: ../../installation.rst:321 518b279edc7f426199e22b43bb47488e msgid "Windows: `C:/Program Files/Tesseract-OCR/tessdata`" msgstr "" #: ../../installation.rst:322 2829c0e448b44e639344346371835824 msgid "Unix systems: `/usr/share/tesseract-ocr/4.00/tessdata`" msgstr "Unixシステム: `/usr/share/tesseract-ocr/4.00/tessdata`" #: ../../installation.rst:324 d8669511863246a096ce609ebddc096b msgid "Specify the language support folder when calling PyMuPDF OCR functions:" msgstr "" #: ../../installation.rst:326 2defdb35431444ab8cb2a6832cb3cc88 msgid "Set the `tessdata` argument." msgstr "" #: ../../installation.rst:327 eda39b64a6ca464d8c23f1eeec197a8f msgid "Or set `os.environ[\"TESSDATA_PREFIX\"]` from within Python." msgstr "" #: ../../installation.rst:328 d711c5765afc4c0cafadc80892c613e9 msgid "" "Or set environment variable `TESSDATA_PREFIX` before running Python, for " "example:" msgstr "" #: ../../installation.rst:330 adb02ed301f749c0b70fa768f6279980 msgid "" "Windows: `setx TESSDATA_PREFIX \"C:/Program Files/Tesseract-" "OCR/tessdata\"`" msgstr "" #: ../../installation.rst:331 a7d44e96bab64a1492085fe6649aa5ba msgid "" "Unix systems: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-" "ocr/4.00/tessdata`" msgstr "" "Unixシステム: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-" "ocr/4.00/tessdata`" #: ../../footer.rst:46 04ec8ea4e7e743ab9f77de31a752358a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "On Unix-style systems such as " #~ "Linux, OpenBSD and FreeBSD, use the " #~ "system package manager to install SWIG." #~ msgstr "Unixスタイルのシステム（Linux、OpenBSD、FreeBSDなど）では、SWIGをインストールするにはシステムのパッケージマネージャを使用してください。" #~ msgid "For example on Debian Linux, do: `sudo apt install swig`" #~ msgstr "例えば、Debian Linuxの場合は、次のようにしてください： `sudo apt install swig`" #~ msgid "" #~ "Install SWIG by following the " #~ "instructions at: " #~ "https://swig.org/Doc4.0/Windows.html#Windows_installation" #~ msgstr "以下の指示に従って、SWIGをインストールしてください：https://swig.org/Doc4.0/Windows.html#Windows_installation" #~ msgid "" #~ "On MacOS, install MacPorts using the " #~ "instructions at: https://www.macports.org/install.php" #~ msgstr "MacOSでMacPortsをインストールする場合は、以下の指示に従ってください：https://www.macports.org/install.php" #~ msgid "Then install SWIG with: `sudo port install swig`" #~ msgstr "その後、以下のコマンドを使用してSWIGをインストールしてください： `sudo port install swig`" #~ msgid "You may also need: `sudo port install swig-python`" #~ msgstr "以下も必要になるかもしれません： `sudo port install swig-python`" #~ msgid "Installation from source without using an sdist" #~ msgstr "sdistを使用せずにソースからインストールする方法" #~ msgid "" #~ "Clone the git repository at " #~ "https://github.com/pymupdf/PyMuPDF, for example::" #~ msgstr "https://github.com/pymupdf/PyMuPDF から git リポジトリをクローンしてください" #~ msgid "" #~ "PyMuPDF will build for the version " #~ "of Python that runs `setup.py`. So " #~ "for example on Windows one can " #~ "build different versions by using `py" #~ " -3.9` or `py -3.10-32`." #~ msgstr "" #~ "PyMuPDFは、`setup.py` " #~ "を実行するPythonのバージョンにビルドされます。したがって、例えばWindowsで異なるバージョンをビルドする場合、`py " #~ "-3.9` や `py -3.10-32` を使用することができます。" #~ msgid "Building and testing with git checkouts of PyMuPDF and MuPDF" #~ msgstr "PyMuPDFとMuPDFのgitチェックアウトを使ってビルドとテストを行う" #~ msgid "Things to do:" #~ msgstr "やるべきこと：" #~ msgid "Get PyMuPDF." #~ msgstr "PyMuPDFを取得する。" #~ msgid "Get MuPDF." #~ msgstr "MuPDFを取得する。" #~ msgid "Create a Python virtual environment." #~ msgstr "Pythonの仮想環境を作成する。" #~ msgid "" #~ "Build PyMuPDF with environmental variable " #~ "`PYMUPDF_SETUP_MUPDF_BUILD` set to the path" #~ " of the local MuPDF checkout." #~ msgstr "" #~ "`PYMUPDF_SETUP_MUPDF_BUILD` " #~ "環境変数をローカルのMuPDFチェックアウトのパスに設定して、PyMuPDFをビルドする。" #~ msgid "Run PyMuPDF tests." #~ msgstr "PyMuPDFのテストを実行する。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "Wheels are available for Windows (32-bit" #~ " Intel, 64-bit Intel), Linux (64-bit " #~ "Intel, 64-bit ARM) and Mac OSX " #~ "(64-bit Intel, 64-bit ARM), Python " #~ "versions 3.7 and up." #~ msgstr "" #~ "Windows（32ビットIntel、64ビットIntel）、Linux（64ビットIntel、64ビットARM）、およびMac " #~ "OSX（64ビットIntel、64ビットARM）用のホイールが利用可能で、Pythonバージョン3.7以上に対応しています。" #~ msgid "Install Tesseract." #~ msgstr "Tesseractをインストールしてください" #~ msgid "" #~ "As of `PyMuPDF-1.20.0`, the required " #~ "MuPDF source code is already in " #~ "the sdist and is automatically built " #~ "into PyMuPDF." #~ msgstr "`PyMuPDF-1.20.0` 現在、必要なMuPDFのソースコードがsdistに含まれており、自動的にPyMuPDFに組み込まれています。" #~ msgid "" #~ "Build and install from local PyMuPDF " #~ "checkout and optional local MuPDF " #~ "checkout" #~ msgstr "ローカルの PyMuPDF チェックアウトとオプションのローカル MuPDF チェックアウトからビルドしてインストールします。" #~ msgid "Build and install PyMuPDF::" #~ msgstr "PyMuPDFをビルドしてインストールしてください::" #~ msgid "" #~ "When running Python scripts that use " #~ "PyMuPDF, make sure that the current " #~ "directory is not the `PyMuPDF/` " #~ "directory." #~ msgstr "" #~ "PyMuPDFを使用するPythonスクリプトを実行する際は、現在のディレクトリが `PyMuPDF/` " #~ "ディレクトリでないことを確認してください。" #~ msgid "" #~ "Otherwise, confusingly, Python will attempt" #~ " to import `fitz` from the local " #~ "`fitz/` directory, which will fail " #~ "because it only contains source files." #~ msgstr "" #~ "そうでない場合、Pythonは混乱する可能性があります。Pythonはローカルの `fitz/` ディレクトリから" #~ " `fitz` をインポートしようとしますが、それはソースファイルのみを含んでいるため、失敗します。" #~ msgid "On Windows `ImportError: DLL load failed while importing _fitz`." #~ msgstr "Windowsの場合: `ImportError: DLL load failed while importing _fitz`." #~ msgid "" #~ "Wheels are available for Windows (32-bit" #~ " Intel, 64-bit Intel), Linux (64-bit " #~ "Intel, 64-bit ARM) and Mac OSX " #~ "(64-bit Intel, 64-bit ARM), for Python" #~ " versions marked as \"Supported\" on " #~ "https://devguide.python.org/versions/." #~ msgstr "" #~ "ホイールは、Windows向けには（32ビットIntel、64ビットIntel）、Linux向けには（64ビットIntel、64ビットARM）、およびMac" #~ " OSX向けには（64ビットIntel、64ビットARM）提供されています。 " #~ "Pythonのバージョンは、「https://devguide.python.org/versions/」で「サポートされている」とマークされています。" #~ msgid "" #~ "PyMuPDF does not support Python versions" #~ " prior to 3.8. Older wheels can " #~ "be found in `this `_ repository and on `PyPI " #~ "`_." #~ msgstr "" #~ msgid "" #~ "Please note that we generally follow " #~ "the official Python release schedules. " #~ "For Python versions dropping out of " #~ "official support this means, that " #~ "generation of wheels will also be " #~ "ceased for them." #~ msgstr "" #~ "PyMuPDFはPythonバージョン3.8以前をサポートしていません。古いバージョンのホイールは、`この " #~ "`_ リポジトリや " #~ "`PyPI `_ でも見つけることができます" #~ msgid "" #~ "`Tesseract-OCR `_ for optical character " #~ "recognition in images and document " #~ "pages. Tesseract is separate software, " #~ "not a Python package. To enable " #~ "OCR functions in PyMuPDF, the software" #~ " must be installed and the system " #~ "environment variable `\"TESSDATA_PREFIX\"` must " #~ "be defined and contain the `tessdata`" #~ " folder name of the Tesseract " #~ "installation location. See below." #~ msgstr "" #~ "`Tesseract-OCR `_ " #~ "は、画像やドキュメントページの光学文字認識（OCR）のためのソフトウェアです。TesseractはPythonのパッケージではなく、独立したソフトウェアです。PyMuPDFでOCR機能を有効にするには、Tesseractソフトウェアをインストールし、システム環境変数の" #~ " `\"TESSDATA_PREFIX\"` を定義して、Tesseractのインストール場所にある " #~ "`tessdata` フォルダの名前を含める必要があります。以下を参照してください。" #~ msgid "" #~ "The language support folder location " #~ "must be communicated either via storing" #~ " it in the environment variable " #~ "`\"TESSDATA_PREFIX\"`, or as a parameter " #~ "in the applicable functions." #~ msgstr "" #~ "言語サポートフォルダの場所は、`\"TESSDATA_PREFIX\"` " #~ "という環境変数に保存するか、適用される関数のパラメータとして指定する必要があります。" #~ msgid "Set the environment variable `TESSDATA_PREFIX`" #~ msgstr "環境変数 `TESSDATA_PREFIX` を設定してください：" #~ msgid "" #~ "On Windows systems, this must happen " #~ "outside Python -- before starting your" #~ " script. Just manipulating `os.environ` " #~ "will not work!" #~ msgstr "" #~ "Windowsシステムでは、これはPythonの外部で行われる必要があります。スクリプトを実行する前に行ってください。`os.environ`" #~ " を操作するだけではうまく動作しません！" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "Each wheel uses the Python Stable " #~ "ABI of the current oldest supported " #~ "Python version (currently 3.9), and so" #~ " works with all later Python " #~ "versions, including new Python releases." #~ msgstr "" #~ msgid "" #~ "Wheels are tested on all Python " #~ "versions currently marked as \"Supported\" " #~ "on https://devguide.python.org/versions/, currently " #~ "3.9, 3.10, 3.11, 3.12 and 3.13." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/intro.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-09-11 21:42+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a41c7bb7308c4b5b830c403db1c8d522 msgid "Artifex" msgstr "" #: ../../header.rst:-1 4b9111f0fec54685953c69def64e45f3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 49bb2731e94d4111965ffae8aa08a21f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../intro.rst:4 f7699a4ad92d446ba773ba2396f91a3a msgid "Introduction" msgstr "" #: ../../intro.rst:15 12aec34e36c34e14a32ebeecf2c16431 msgid "" "|PyMuPDF| is a Python binding for `MuPDF `_ --" " a lightweight PDF, XPS, and E-book viewer, renderer, and toolkit, which" " is maintained and developed by Artifex Software, Inc" msgstr "" #: ../../intro.rst:17 be6754fe8f954f80897efdca10164de8 msgid "" "MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB, MOBI and FB2 " "(e-books) formats, and it is known for its top performance and high " "rendering quality." msgstr "" #: ../../intro.rst:19 b3268360e4cf4c56a5509810b370fa25 msgid "" "MuPDF stands out among all similar products for its top rendering " "capability and unsurpassed processing speed. At the same time, its " "\"light weight\" makes it an excellent choice for platforms where " "resources are typically limited, like smartphones." msgstr "" #: ../../intro.rst:21 c9802de5dae44cffb37698c1f86e6dde msgid "" "Check this out yourself and compare the various free PDF-viewers. In " "terms of speed and rendering quality `SumatraPDF " "`_ ranges at the top (apart from " "MuPDF's own standalone viewer) -- since it has changed its library basis " "to MuPDF!" msgstr "" #: ../../intro.rst:23 c91ccfeae8fa4367815a63762c89721e msgid "" "With PyMuPDF you can access files with extensions like “.pdf”, “.xps”, " "“.oxps”, “.cbz”, “.fb2”, \".mobi\" or “.epub”. In addition, about 10 " "popular image formats can also be opened and handled like documents." msgstr "" #: ../../intro.rst:25 903db6f8457c48e694fba6a66f5afd03 msgid "" "PyMuPDF provides access to many important functions of MuPDF from within " "a Python environment, and we are continuously seeking to expand this " "function set." msgstr "" #: ../../intro.rst:27 d4748fd6a1fe44e19d6bd9b222cb61cd msgid "" "PyMuPDF runs and has been tested on Mac, Linux and Windows for Python " "versions 3.8 [#f1]_ and up. Other platforms should work too, as long as " "MuPDF and Python support them." msgstr "" #: ../../intro.rst:29 c748d030070b427c80417beaff9b6342 msgid "" "PyMuPDF is hosted on `GitHub `_ and " "registered on `PyPI `_." msgstr "" #: ../../intro.rst:31 2be39641dab44b1c8e1dfa7afe144c4d msgid "" "For MS Windows, Mac OSX and Linux Python wheels are available -- please " "see the installation chapter." msgstr "" #: ../../intro.rst:33 edeb85c952ab458dbd75bc79773b3448 msgid "" "The GitHub repository `PyMuPDF-Utilities `_ contains a full range of examples, demonstrations " "and use cases." msgstr "" #: ../../intro.rst:36 21bc387c7484451aa6678a479ef7b24b msgid "Note on the legacy module name *fitz*" msgstr "" #: ../../intro.rst:37 5b06571ac8e44ca498d5d938ad978bc1 msgid "" "Prior to release 1.24.3, the top level Python import name for this " "library was **\"fitz\"**. This has historical reasons:" msgstr "" #: ../../intro.rst:39 54b20466f423486cb7a419f853600c0f msgid "The original rendering library for MuPDF was called *Libart*." msgstr "" #: ../../intro.rst:41 8e099c2cdacc4a9bb75ad97643b3f913 msgid "" "*\"After Artifex Software acquired the MuPDF project, the development " "focus shifted on writing a new modern graphics library called \"Fitz\". " "Fitz was originally intended as an R&D project to replace the aging " "Ghostscript graphics library, but has instead become the rendering engine" " powering MuPDF.\"* (Quoted from `Wikipedia " "`_)." msgstr "" #: ../../intro.rst:43 b3f34235d3034b02a4880f492a05b577 msgid "`import fitz` is still supported for backwards compatibility." msgstr "" #: ../../intro.rst:47 213da85a65254b2caf874559e9e67019 msgid "" "Use of legacy name `fitz` can fail if defunct package pypi.org `fitz` is " "installed; see :ref:`problems-after-installation`." msgstr "" #: ../../intro.rst:51 3577e73ae4f34a25b80069861e962f37 msgid "License and Copyright" msgstr "" #: ../../intro.rst:52 874d0e2d51844efea0695f5bd19c58c2 msgid "" "In order to comply with MuPDF’s dual licensing model, PyMuPDF has entered" " into an agreement with Artifex who has the right to sublicense PyMuPDF " "to third parties." msgstr "" #: ../../intro.rst:54 0b731cd148964d8db2bd16ba896ea1f9 msgid "" "PyMuPDF and MuPDF are now available under both, open-source AGPL and " "commercial license agreements. Please read the full text of the AGPL " "license agreement, available in the distribution material (file COPYING) " "and `here `_, to ensure that " "your use case complies with the guidelines of the license. If you " "determine you cannot meet the requirements of the AGPL, please contact " "`Artifex `_ for more information regarding " "a commercial license." msgstr "" #: ../../intro.rst:56 473e50eb75544325969f223a85c2172e msgid "Artifex is the exclusive commercial licensing agent for MuPDF." msgstr "" #: ../../intro.rst:58 777d916fb52441aabdd18216e4977bf9 msgid "" "Artifex, the Artifex logo, MuPDF, and the MuPDF logo are registered " "trademarks of Artifex Software Inc. © 2022 Artifex Software, Inc. All " "rights reserved." msgstr "" #: ../../version.rst:3 ac529f29c7004bdab4f7da3dbb922e12 msgid "" "This documentation covers **PyMuPDF v1.24.10** features as of " "**2024-09-02 00:00:01**." msgstr "" #: ../../version.rst:5 d0267645ce504840843677d4a3060147 msgid "" "The major and minor versions of |PyMuPDF| and |MuPDF| will always be " "the same. Only the third qualifier (patch level) may deviate from that of" " |MuPDF|." msgstr "" #: ../../version.rst:7 f26be46a33a04d54965c32772883e3ab msgid "" "Typically PyMuPDF is released more frequently than MuPDF so it will often" " be the case that the patch level of PyMuPDF will be greater than the " "embedded MuPDF." msgstr "" #: ../../version.rst:11 ccdc763817ae4046bebe37eeb819b308 msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2." msgstr "" #: ../../version.rst:13 d116a1d660c74042baf5a7bd51e852b0 msgid "Also see `pymupdf_version` and `mupdf_version`." msgstr "" #: ../../intro.rst:66 7fed4e7b825746bbbcf0054fbe740a34 msgid "Footnotes" msgstr "" #: ../../intro.rst:67 4cbcfdb2063e434a839290ebb3369077 msgid "" "PyMuPDF generally only supports Python versions that are still maintained" " by the Python Software Foundation. Once a Python version is being " "retired, PyMuPDF support will also be ended. This means that wheels for a" " retired Python platform will no longer be provided, and that Python " "language features may be used that did not exist in the retired Python " "version." msgstr "" #: ../../footer.rst:60 4201ffb7de1543f7bcbcec3989cad1e5 msgid "This documentation covers all versions up to |version|." msgstr "" #: ../../footer.rst:-1 9fc4919ea2ad4bbe8a478f523c247979 msgid "Discord logo" msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/irect.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9da9a1f0d8ad4810a00d9c3ffb986077 msgid "Artifex" msgstr "" #: ../../header.rst:-1 c119c5ee601a454eb3d762c5116445d1 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 e312792ce16248f98f71d027cbbe1d64 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../irect.rst:7 ddef2d577f7c46fca0650922f46a8a81 msgid "IRect" msgstr "" #: ../../irect.rst:9 64079ef1a00e45ee981d0d272179f2e3 msgid "" "IRect is a rectangular bounding box, very similar to :ref:`Rect`, except " "that all corner coordinates are integers. IRect is used to specify an " "area of pixels, e.g. to receive image data during rendering. Otherwise, " "e.g. considerations concerning emptiness and validity of rectangles also " "apply to this class. Methods and attributes have the same names, and in " "many cases are implemented by re-using the respective :ref:`Rect` " "counterparts." msgstr "" "IRect（整数長方形）は、:ref:`Rect` " "と非常に似ているが、すべての角の座標が整数であるという点が異なります。IRectは、レンダリング中に画像データを受け取る領域を指定するために使用されます。それ以外にも、長方形の空白や有効性に関する考慮事項が適用されます。メソッドと属性は同じ名前を持ち、多くの場合、対応する" " :ref:`Rect` の対応部分を再利用して実装されています。" #: ../../irect.rst:12 ab97696201f6481cb7a9151183d74b19 msgid "**Attribute / Method**" msgstr "**属性/メソッド**" #: ../../irect.rst:12 efcc94105da54f018a86e821fec2d8cd msgid "**Short Description**" msgstr "**短い説明**" #: ../../irect.rst:14 dc94e84e46af4660871003b4bcf7a4f4 msgid ":meth:`IRect.contains`" msgstr "" #: ../../irect.rst:14 92ea7aa5de9a48a9b5ac185c1794a7e5 msgid "checks containment of another object" msgstr "他のオブジェクトの含まれているかを確認します。" #: ../../irect.rst:15 124cec4d00074c519fbf6ce8ac42a723 msgid ":meth:`IRect.get_area`" msgstr "" #: ../../irect.rst:15 2053892c2f4c422ab19ae350ecbe23e8 msgid "calculate rectangle area" msgstr "長方形の面積を計算します。" #: ../../irect.rst:16 a5bdba1573d44547b8b0673e7cd37dce msgid ":meth:`IRect.intersect`" msgstr "" #: ../../irect.rst:16 d1f0c881eaab47f3a362862bee94a3ec msgid "common part with another rectangle" msgstr "別の長方形との共通部分を取得します。" #: ../../irect.rst:17 11746224755e4a3b9da4cfe7f4269d11 msgid ":meth:`IRect.intersects`" msgstr "" #: ../../irect.rst:17 924de332ec5b4656a802d2e85f6927e7 msgid "checks for non-empty intersection" msgstr "非空の交差をチェックします。" #: ../../irect.rst:18 2132f387192449f0ac037eb9a66f3777 msgid ":meth:`IRect.morph`" msgstr "" #: ../../irect.rst:18 530d3654b8ba4812a36e35dfad701ddf msgid "transform with a point and a matrix" msgstr "ポイントと行列を使用して変換します。" #: ../../irect.rst:19 a3769ab66bee466a8c94fb47b13ff0e2 msgid ":meth:`IRect.torect`" msgstr "" #: ../../irect.rst:19 d7e2a8f91121496a914e133895de1d66 msgid "matrix that transforms to another rectangle" msgstr "別の長方形に変換する行列。" #: ../../irect.rst:20 81cff3d0715f416da3509d8bb9b099ce msgid ":meth:`IRect.norm`" msgstr "" #: ../../irect.rst:20 444fb6d41f6c4e34b0fceb673ba3dc81 msgid "the Euclidean norm" msgstr "ユークリッドノルム。" #: ../../irect.rst:21 c5fbf520ee1e47958587d44173e70ad4 msgid ":meth:`IRect.normalize`" msgstr "" #: ../../irect.rst:21 9fadec1aa0fa42899e37379ddec7c9d1 msgid "makes a rectangle finite" msgstr "長方形を有限にします。" #: ../../irect.rst:22 ad485c24a3a34720ba6cdce4aa57cd30 msgid ":attr:`IRect.bottom_left`" msgstr "" #: ../../irect.rst:22 0f87509f1d3043d49419e4bf77e7d5b6 msgid "bottom left point, synonym *bl*" msgstr "左下のポイント、同義語の *bl* " #: ../../irect.rst:23 6b2e1bb32097415c9539dbb2ae43ca43 msgid ":attr:`IRect.bottom_right`" msgstr "" #: ../../irect.rst:23 4888cfd6ae27499381d64bedabc834ae msgid "bottom right point, synonym *br*" msgstr "右下のポイント、同義語の *br* " #: ../../irect.rst:24 ef3263604d9e406da1601cab4d8bac3e msgid ":attr:`IRect.height`" msgstr "" #: ../../irect.rst:24 ed8730e7d3eb43a38680c2490024ea3a msgid "height of the rectangle" msgstr "長方形の高さ" #: ../../irect.rst:25 c4c26d29c9dc490fb9ce003895f46551 msgid ":attr:`IRect.is_empty`" msgstr "" #: ../../irect.rst:25 2c44a8bb62b7482a8ea229f24405e7a2 msgid "whether rectangle is empty" msgstr "長方形が空かどうか" #: ../../irect.rst:26 62f693c4f27d4da28c1416bdf2633620 msgid ":attr:`IRect.is_infinite`" msgstr "" #: ../../irect.rst:26 583895dab1fb49df97e3c485ef00b41b msgid "whether rectangle is infinite" msgstr "長方形が無限であるかどうか" #: ../../irect.rst:27 bf8fa54275764b07a1cc4cf60133e69e msgid ":attr:`IRect.rect`" msgstr "" #: ../../irect.rst:27 67cc7f8daa2844e0a01efba201d0c056 msgid "the :ref:`Rect` equivalent" msgstr ":ref:`Rect` の同等物" #: ../../irect.rst:28 8f89c6c745e54747aed947c8dd097575 msgid ":attr:`IRect.top_left`" msgstr "" #: ../../irect.rst:28 9593c3c6673e4014bc7f1f38035db854 msgid "top left point, synonym *tl*" msgstr "左上のポイント、同義語の *tl* " #: ../../irect.rst:29 ccd49d6f1ebd447dbc14e886376eeedd msgid ":attr:`IRect.top_right`" msgstr "" #: ../../irect.rst:29 f5d3a7dbdfc2490e90041a1cce9c6e78 msgid "top_right point, synonym *tr*" msgstr "右上のポイント、同義語の *tr* " #: ../../irect.rst:30 092c64736cb9423fbade8738a18def52 msgid ":attr:`IRect.quad`" msgstr "" #: ../../irect.rst:30 02794414a93b473e9430f42716496fae msgid ":ref:`Quad` made from rectangle corners" msgstr "長方形の角から作成された四角形" #: ../../irect.rst:31 8f40f8f7548f45d69bb49e4340ea0e8c msgid ":attr:`IRect.width`" msgstr "" #: ../../irect.rst:31 9a5de017b1ca40b7b146ca25383c738e msgid "width of the rectangle" msgstr "長方形の幅" #: ../../irect.rst:32 0c0b410baf734144851d33016cbdddd0 msgid ":attr:`IRect.x0`" msgstr "" #: ../../irect.rst:32 219bd087640142edad26e0cef53ce452 msgid "X-coordinate of the top left corner" msgstr "左上隅のX座標" #: ../../irect.rst:33 41ac1de7703f44bcbe5f615ba2dce3ea msgid ":attr:`IRect.x1`" msgstr "" #: ../../irect.rst:33 ae41326e3d484ab889ee2b9c5ff3a7de msgid "X-coordinate of the bottom right corner" msgstr "右下隅のX座標" #: ../../irect.rst:34 a3223a0657ab45b087b1c100476b4a17 msgid ":attr:`IRect.y0`" msgstr "" #: ../../irect.rst:34 19062c693a07420a8c8d2f3b3c1eb750 msgid "Y-coordinate of the top left corner" msgstr "左上隅のY座標" #: ../../irect.rst:35 c1c7be5dd2ef41a2b6d447cb43a6a07e msgid ":attr:`IRect.y1`" msgstr "" #: ../../irect.rst:35 be7ae048d8ea46edaf23968ef9c8bce1 msgid "Y-coordinate of the bottom right corner" msgstr "右下隅のY座標" #: ../../irect.rst:38 d9ba47e2fb7f40a5b94b36b2e8690bd1 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../irect.rst:50 1c5e8f4e34f047098b41ead038224c50 msgid "" "Overloaded constructors. Also see examples below and those for the " ":ref:`Rect` class." msgstr "オーバーロードされたコンストラクタ。また、以下の例と :ref:`Rect` クラスの例も参照してください。" #: ../../irect.rst:52 50def18ce8504003afbebdd0a9a55ac1 msgid "If another irect is specified, a **new copy** will be made." msgstr "別のirectが指定された場合、**新しいコピー** が作成されます。" #: ../../irect.rst:54 9b2e5c01c35646e3ad3647dfb830f028 msgid "" "If sequence is specified, it must be a Python sequence type of 4 numbers " "(see :ref:`SequenceTypes`). Non-integer numbers will be truncated, non-" "numeric values will raise an exception." msgstr "シーケンスが指定された場合、それは4つの数値のPythonシーケンス型である必要があります（:ref:`SequenceTypes`）。整数以外の数値は切り捨てられ、数値以外の値は例外を発生させます。" #: ../../irect.rst:56 2cd32524540f40ac87e1e408344a827d msgid "The other parameters mean integer coordinates." msgstr "その他のパラメータは整数座標を意味します。" #: ../../irect.rst:61 840c50265ae3462c89c54b22ce7e67f9 msgid "" "Calculates the area of the rectangle and, with no parameter, equals " "*abs(IRect)*. Like an empty rectangle, the area of an infinite rectangle " "is also zero." msgstr "長方形の面積を計算し、パラメータなしで *abs(IRect)* に等しいです。空の長方形と同様に、無限の長方形の面積もゼロです。" #: ../../irect.rst 4f00a177e1bc4d3d89dda38f1909fa94 #: 4fc3aa5f280242c986288acbfa1b8175 9b5b83039e0c4fdeaf7685aa05b6bb16 #: aa8fbd2f167e422e9b6b3aaac458e3a9 b69ba3e050904df0afe8a6d582ef2363 #: ed922b3129dd4c73b25f962b90ae50aa msgid "Parameters" msgstr "" #: ../../irect.rst:63 3be2e3c29aba4f5189e0cbb7f1144057 msgid "" "Specify required unit: respective squares of \"px\" (pixels, default), " "\"in\" (inches), \"cm\" (centimeters), or \"mm\" (millimeters)." msgstr "" "必要な単位を指定します：「px」（ピクセル、デフォルト）、 「in」（インチ）、 " "「cm」（センチメートル）、または「mm」（ミリメートル）のそれぞれの平方。" #: ../../irect.rst 4e47019f7b9b4864aef1988ad0bcbdd9 #: 8a353e9947ea4ef2b6e0a6872cda119d 9f7bfdd3aed843358d17fe22401cb884 #: a7c70439c9f2475ba9e98c25daaa8da2 msgid "Return type" msgstr "" #: ../../irect.rst:69 782b0a38b1a44a3fb17923582226e601 msgid "" "The intersection (common rectangular area) of the current rectangle and " "*ir* is calculated and replaces the current rectangle. If either " "rectangle is empty, the result is also empty. If either rectangle is " "infinite, the other one is taken as the result -- and hence also infinite" " if both rectangles were infinite." msgstr "" "現在の長方形と *ir* " "の交差（共通の長方形領域）を計算し、現在の長方形に置き換えます。どちらかの長方形が空の場合、結果も空です。どちらかの長方形が無限の場合、もう一方が結果として取られます。したがって、両方の長方形が無限である場合、結果も無限です。" #: ../../irect.rst:71 fcebc17df9614b1882a8032f5fcee80a msgid "Second rectangle." msgstr "第2の長方形。" #: ../../irect.rst:75 bca6b46c6fce4c0391d350804618c7b0 msgid "" "Checks whether *x* is contained in the rectangle. It may be " ":data:`rect_like`, :data:`point_like` or a number. If *x* is an empty " "rectangle, this is always true. Conversely, if the rectangle is empty " "this is always ``False``, if *x* is not an empty rectangle and not a " "number. If *x* is a number, it will be checked to be one of the four " "components. *x in irect* and *irect.contains(x)* are equivalent." msgstr "" "*x* が長方形に含まれているかどうかを確認します。それは " ":data:`rect_like`、:data:`point_like`、または数値であるかもしれません。*x* " "が空の長方形の場合、これは常に真です。逆に、長方形が空の場合、これは常に偽です。xが空の長方形でなく、数値でない場合、これは常に偽です。 *x* " "が数値の場合、それは4つの構成要素の1つであることが確認されます。 *x* in *irect* および *irect.contains(x)* " "は同等です" #: ../../irect.rst:77 2a8a12b2850d4bfba7bba2b40cc06f55 msgid "the object to check." msgstr "確認するオブジェクト。" #: ../../irect.rst:84 50064e8a49c54a6da52a3b0900a114f3 msgid "" "Checks whether the rectangle and the :data:`rect_like` \"r\" contain a " "common non-empty :ref:`IRect`. This will always be ``False`` if either is" " infinite or empty." msgstr "" "長方形と :data:`rect_like`「r」が共通の非空 :ref:`IRect` " "を含むかどうかをチェックします。どちらかが無限または空の場合、これは常に ``False`` になります。" #: ../../irect.rst:86 b0c988e57dce4071a0e518ca1e93877f msgid "the rectangle to check." msgstr "チェックする長方形。" #: ../../irect.rst:92 1bbbf78a89784f7db6abf366bea409ae msgid "New in version 1.19.3" msgstr "バージョン1.19.3で新登場" #: ../../irect.rst:94 f3726b71047d42a58f879f9c00944d3f msgid "" "Compute the matrix which transforms this rectangle to a given one. See " ":meth:`Rect.torect`." msgstr "この長方形を指定された長方形に変換する行列を計算します。:meth:`Rect.torect` を参照してください。" #: ../../irect.rst:96 dcc19ae43b814fe4b56fa555133432ce msgid "the target rectangle. Must not be empty or infinite." msgstr "ターゲットの長方形。空または無限であってはなりません。" #: ../../irect.rst:97 d473a4edcd124daab7417f12570976d0 msgid ":ref:`Matrix`" msgstr "" #: ../../irect.rst e2953f28a3ff42908f0e4d0811230263 #: f368ffdbb210464aac1693355694b761 msgid "Returns" msgstr "" #: ../../irect.rst:98 056021e1cc164996aed45008297df188 msgid "" "a matrix `mat` such that `self * mat = rect`. Can for example be used to " "transform between the page and the pixmap coordinates." msgstr "`self * mat = rect` となるような行列 `mat` 。たとえば、ページとピクセルマップの座標間を変換するために使用できます。" #: ../../irect.rst:103 88b85325f704446180fd037b13f438d8 msgid "New in version 1.17.0" msgstr "新機能 バージョン1.17.0" #: ../../irect.rst:105 2b9036d190fb49e0b5f461aba0df7c7f msgid "Return a new quad after applying a matrix to it using a fixed point." msgstr "指定された固定点に行列を適用した後の新しい四角形を返します。" #: ../../irect.rst:107 3ff780516b4146f3ae0d550b2b4a36ce msgid "the fixed point." msgstr "固定点。" #: ../../irect.rst:108 1fbd651a14a1443596afb4e080f12015 msgid "the matrix." msgstr "行列。" #: ../../irect.rst:109 f932937ceb634ac7890e4cb6a194a02b msgid "" "a new :ref:`Quad`. This a wrapper of the same-named quad method. If " "infinite, the infinite quad is returned." msgstr "新しい :ref:`Quad`。これは同じ名前のquadメソッドのラッパーです。無限であれば、無限の四角形が返されます。" #: ../../irect.rst:113 613eaa02d46e4a9eab41724a4e10baa2 msgid "New in version 1.16.0" msgstr "新機能 バージョン1.16.0" #: ../../irect.rst:115 e05020824bd94a418f7786caff3a68e5 msgid "" "Return the Euclidean norm of the rectangle treated as a vector of four " "numbers." msgstr "四角形を4つの数字のベクトルとして扱った場合のユークリッドノルムを返します。" #: ../../irect.rst:119 deaf5a4b9f8440fd8fe7b802f78ec9b9 msgid "" "Make the rectangle finite. This is done by shuffling rectangle corners. " "After this, the bottom right corner will indeed be south-eastern to the " "top left one. See :ref:`Rect` for a more details." msgstr "" "四角形を有限にします。これは四角形の角を入れ替えることによって行われます。この操作後、右下の角は確かに左上の角の南東になります。詳細については、:ref:`Rect`" " を参照してください。" #: ../../irect.rst:125 55613d17f4fd4a458eca520133551eb0 msgid "Equals *Point(x0, y0)*." msgstr "*Point(x0, y0)* と同等です。" #: ../../irect.rst 1fb6ace84c4d4e938a1ff7c0b704b38f #: 49d4afd12c6a42c4a29bf9c269eadfe0 5b4a83c92ca649dda2e8fa0e691bbd89 #: 6cbe1cdc288d48ee9c6b6bd68a21fea6 7559f9666807471eaa667884ab2f79b5 #: 8d8f0f2b15df45779323571cd1a1b751 c86cbf20e5234741bd7bc1e8fd9a44ca #: d2aad704feb949ebb36c3a4e729a8d5f d793441a05ce4bc48b85052e697d053e #: dc8594c4fac847ac8161c79a639811ce e8ad8d35ebcb4d0795598f07a336334c #: f52efa790e584d859f3797654913b784 f66efb6c2f134fa69083a7c6b1a857ab #: ff031729ca2a4ce1ad1e658f12ce0cfe msgid "type" msgstr "" #: ../../irect.rst:127 ../../irect.rst:135 ../../irect.rst:143 #: ../../irect.rst:151 308d3cb353bb49ae94161cf7dc7218d3 #: 3249e89f3b7c4ac2bea38ea5214c52c5 785ff830f1234dc69f3c770992c2a410 #: 884b7d46c20742c0a7283bee8b40a43f msgid ":ref:`Point`" msgstr "" #: ../../irect.rst:133 921cb3a2a7cf4cbf806f9d772749b917 msgid "Equals *Point(x1, y0)*." msgstr "*Point(x1, y0)* と同等です。" #: ../../irect.rst:141 13776e76c48248909500e8fe82c9d0a4 msgid "Equals *Point(x0, y1)*." msgstr "*Point(x0, y1)* と同等です。" #: ../../irect.rst:149 99f201fd44fd4ed0a1f49b75400f0d0f msgid "Equals *Point(x1, y1)*." msgstr "*Point(x1, y1)* と同等です。" #: ../../irect.rst:155 63204ddea7a14d2592a7ad0f9dd74810 msgid "The :ref:`Rect` with the same coordinates as floats." msgstr "浮動小数点座標と同じ座標を持つ :ref:`Rect` です。" #: ../../irect.rst:157 2d7b927314b342cb96c8fb15d3b8e3b9 msgid ":ref:`Rect`" msgstr "" #: ../../irect.rst:161 57dfabd4e9b049e4900273a9ec4cb817 msgid "The quadrilateral *Quad(irect.tl, irect.tr, irect.bl, irect.br)*." msgstr "四角形 *Quad(irect.tl, irect.tr, irect.bl, irect.br)です* 。" #: ../../irect.rst:163 a199b927484848978ec222114a9da0cc msgid ":ref:`Quad`" msgstr "" #: ../../irect.rst:167 1d437103ee594f9b944058db4631bb9d msgid "Contains the width of the bounding box. Equals *abs(x1 - x0)*." msgstr "境界ボックスの幅を含みます。*abs(x1 - x0)* と同等です。" #: ../../irect.rst:169 ../../irect.rst:175 ../../irect.rst:181 #: ../../irect.rst:187 ../../irect.rst:193 ../../irect.rst:199 #: 083882bcb7354a55bf7f4dd85eef92b9 8ed88f37bd6742da83895a91a8685917 #: 967dc9f8c2fc43b7b56954d34441687f 9958930f4f6e45b5980d2c23669ce09f #: ac4b6a2822ce482a8dbfbf739c4ffa79 bd9b56e6197441be9f3888a17b04d9a4 msgid "int" msgstr "" #: ../../irect.rst:173 b187d2fbc4bd439e834930d74922794b msgid "Contains the height of the bounding box. Equals *abs(y1 - y0)*." msgstr "境界ボックスの高さを含みます。*abs(y1 - y0)* と同等です。" #: ../../irect.rst:179 4777545ac79b48f1a71c4b3dffbbe470 msgid "X-coordinate of the left corners." msgstr "左上隅のX座標です。" #: ../../irect.rst:185 187b3e2a62fa440b84c0265a597e11e0 msgid "Y-coordinate of the top corners." msgstr "上端のY座標です。" #: ../../irect.rst:191 4539d20b89644229aae3fcc4c1196436 msgid "X-coordinate of the right corners." msgstr "右上隅のX座標です。" #: ../../irect.rst:197 69a9d5438d1b4b199976b0b23ba70a7e msgid "Y-coordinate of the bottom corners." msgstr "下端のY座標です。" #: ../../irect.rst:203 34a8989b9f274d83b0a6c5031b749190 msgid "``True`` if rectangle is infinite, ``False`` otherwise." msgstr "四角形が無限の場合は ``True`` 、それ以外の場合は``False`` です。" #: ../../irect.rst:205 ../../irect.rst:211 c8f3501df5c14812ae13827184765c29 #: d6f0997b994c464fa7457bb7c1cce89c msgid "bool" msgstr "" #: ../../irect.rst:209 5fea893d5a0e409aacb5452b2ffa3fcf msgid "``True`` if rectangle is empty, ``False`` otherwise." msgstr "四角形が空の場合は ``True``、それ以外の場合は ``False`` です。" #: ../../irect.rst:216 e58bd147e5934ff788a34135346e5c97 msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "" "このクラスはPythonのシーケンスプロトコルに従っているため、コンポーネントはインデックスを使用してアクセスできます。また、:ref:`SequenceTypes`" " も参照してください。" #: ../../irect.rst:217 0d59de499da146b2914c95df6f414f34 msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "また、四角形は算術演算子と一緒に使用できます - :ref:`Algebra` を参照してください。" #: ../../footer.rst:60 7dccd50b2f2443208394ecb0c842c1dd msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/link.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 789ef3e179a7439395eb0d05014100e0 msgid "Artifex" msgstr "" #: ../../header.rst:-1 d6bae0d656e54c42bbd6fabc354253ae msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 c2865acb728b48b0be9ebcbf4ca09b69 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../link.rst:7 c688c9e8319141a9be77a5892a13809d msgid "Link" msgstr "Link (リンク)" #: ../../link.rst:8 52cdea6624d9492a8f1367f1fee8b4f8 msgid "" "Represents a pointer to somewhere (this document, other documents, the " "internet). Links exist per document page, and they are forward-chained to" " each other, starting from an initial link which is accessible by the " ":attr:`Page.first_link` property." msgstr "" "リンクは、どこかへのポインタを表します（この文書、他の文書、インターネットなど）。リンクは文書のページごとに存在し、最初のリンクは " ":attr:`Page.first_link` プロパティでアクセスできます。リンクはお互いにフォワードチェーンされ、最初のリンクから始まります。" #: ../../link.rst:10 ae08ffa8e9f4429bb99c55016bdcc961 msgid "" "There is a parent-child relationship between a link and its page. If the " "page object becomes unusable (closed document, any document structure " "change, etc.), then so does every of its existing link objects -- an " "exception is raised saying that the object is \"orphaned\", whenever a " "link property or method is accessed." msgstr "リンクとそのページとの親子関係があります。ページオブジェクトが使用できなくなると（ドキュメントがクローズされた場合、ドキュメント構造が変更された場合など）、そのページに存在するリンクオブジェクトも使用できなくなります。リンクのプロパティまたはメソッドにアクセスしようとすると、「オーファン」というオブジェクトが発生し、例外が発生します。" #: ../../link.rst:13 540b33af6e004a60a5c462085df023e5 msgid "**Attribute**" msgstr "**属性**" #: ../../link.rst:13 f47bd46a654a45a4ba851c09a22eea60 msgid "**Short Description**" msgstr "**短い説明**" #: ../../link.rst:15 f7c6af0af71e4dd19562174e5497a60d msgid ":meth:`Link.set_border`" msgstr "" #: ../../link.rst:15 1792d06c2e574c19a323b62f42c2d45c msgid "modify border properties" msgstr "境界線のプロパティを変更します" #: ../../link.rst:16 d9891c2fa8284703a452d3df1a0653fd msgid ":meth:`Link.set_colors`" msgstr "" #: ../../link.rst:16 5c1f73fa45454debbad1d5891c4378cd msgid "modify color properties" msgstr "色のプロパティを変更します" #: ../../link.rst:17 0af10d50600346ea8663643e1de0eb8b msgid ":meth:`Link.set_flags`" msgstr "" #: ../../link.rst:17 6e5bbdf2f3f94fb5a120e1443763be30 msgid "modify link flags" msgstr "リンクフラグを変更します" #: ../../link.rst:18 6dce9d5a48824fff84e601d4aecdc691 msgid ":attr:`Link.border`" msgstr "" #: ../../link.rst:18 604357ac107245f993ae3b1650ebcf79 msgid "border characteristics" msgstr "境界線の特性" #: ../../link.rst:19 56981bc862ef422cac26e01e4529b563 msgid ":attr:`Link.colors`" msgstr "" #: ../../link.rst:19 d2b934f42ed647d39eafa1cf42d776d1 msgid "border line color" msgstr "境界線の色" #: ../../link.rst:20 53bcd3c8bba14f7bbc40266833181e80 msgid ":attr:`Link.dest`" msgstr "" #: ../../link.rst:20 f923e0b3b9744816a353b2e8fa3e2210 msgid "points to destination details" msgstr "宛先の詳細を指します" #: ../../link.rst:21 5eed957ff70b41e98d0eb9285cd96980 msgid ":attr:`Link.is_external`" msgstr "" #: ../../link.rst:21 effa067d28d44d16bb8fe8e503593a5d #, fuzzy msgid "checks if the link is an external destination" msgstr "外部宛先ですか？" #: ../../link.rst:22 bbe68bce0387407795c1edda367ef2ab msgid ":attr:`Link.flags`" msgstr "" #: ../../link.rst:22 ad43a0946bcc486ca5aa72ecdd1d02bf msgid "link annotation flags" msgstr "リンク注釈のフラグ" #: ../../link.rst:23 eef3e8a36ea145629db1a703e87f575d msgid ":attr:`Link.next`" msgstr "" #: ../../link.rst:23 627116875da8492cbc9685c5ef7289cc msgid "points to next link" msgstr "次のリンクを指します" #: ../../link.rst:24 08387b2d8317483d9cc61f3452cea422 msgid ":attr:`Link.rect`" msgstr "" #: ../../link.rst:24 58a914c6c1424572881b90bcc4392db4 #, fuzzy msgid "clickable area in untransformed coordinates" msgstr "変換されていない座標内のクリック可能な領域" #: ../../link.rst:25 b115d680a21b46a6b85d654dd3a49b79 msgid ":attr:`Link.uri`" msgstr "" #: ../../link.rst:25 969ecf8c8c9341bf8ee037a0c9ee9a8b msgid "link destination" msgstr "リンクの宛先" #: ../../link.rst:26 253e0f31052f499b9e4346932b58c7d9 msgid ":attr:`Link.xref`" msgstr "" #: ../../link.rst:26 2e407687ff9648c88d884bc113153b63 msgid ":data:`xref` number of the entry" msgstr "エントリの :data:`xref` 番号" #: ../../link.rst:29 86c8b11333584703a538c055122d3356 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../link.rst:35 12ea65b799b44f38acf6a8810d508ddb msgid "PDF only: Change border width and dashing properties." msgstr "PDFのみ：境界線の幅と破線プロパティを変更します。" #: ../../link.rst:37 3336d65932154a7e8220f704075033f6 msgid "" "*(Changed in version 1.16.9)* Allow specification without using a " "dictionary. The direct parameters are used if *border* is not a " "dictionary." msgstr "*（バージョン1.16.9で変更）* 辞書を使用せずに仕様を許可します。*border* が辞書でない場合、直接のパラメータが使用されます。" #: ../../link.rst 25b24c0fd56f4c30b5aed0630d379730 #: 9ee61ab2fe8942bfabb7ea27592c0b6d msgid "Parameters" msgstr "" #: ../../link.rst:39 528de9f4f21d4757bc32323b7c87d926 msgid "" "a dictionary as returned by the :attr:`border` property, with keys " "*\"width\"* (*float*), *\"style\"* (*str*) and *\"dashes\"* (*sequence*)." " Omitted keys will leave the resp. property unchanged. To e.g. remove " "dashing use: *\"dashes\": []*. If dashes is not an empty sequence, " "\"style\" will automatically be set to \"D\" (dashed)." msgstr "" ":attr:`border` プロパティによって返される辞書で、キー " "*\"width\"*（*浮動小数点*）、*\"style\"*（*str*）、*\"dashes\"*（*シーケンス*）を持っています。省略されたキーは、対応するプロパティを変更しません。例えば点線を削除するには、*「dashes」：[]*" " を使用します。dashes が空のシーケンスでない場合、「style」は自動的に \"D\"（点線）に設定されます。" #: ../../link.rst:41 ../../link.rst:42 ../../link.rst:43 ../../link.rst:54 #: 15adf27929424619b20cae84b36ad609 8795a2d1dc084425af561ecd4c4c5474 #: b0c1d9cdb57843a98c0a60c9326e7883 c13273a1875d45e793d46962a4b7f884 msgid "see above." msgstr "上記を参照してください。" #: ../../link.rst:47 4f104147b1394836b55a5df9c3e2ab47 msgid "PDF only: Changes the \"stroke\" color." msgstr "PDFのみ： \"stroke\" 色を変更します。" #: ../../link.rst:49 16686de7e6af4e18ab0ae3e6db98bf9b msgid "" "In PDF, links are a subtype of annotations technically and **do not " "support fill colors**. However, to keep a consistent API, we do allow " "specifying a `fill=` parameter like with all annotations, which will be " "ignored with a warning." msgstr "" "PDFでは、リンクは技術的には注釈のサブタイプであり、**塗りつぶし色はサポートしていません**。ただし、一貫したAPIを維持するために、すべての注釈と同様に" " `fill=` パラメータを指定することを許可しており、警告とともに無視されます。" #: ../../link.rst:51 59d3c81f089043dc9af7a58db867cfcc msgid "" "*(Changed in version 1.16.9)* Allow colors to be directly set. These " "parameters are used if *colors* is not a dictionary." msgstr "*(バージョン1.16.9で変更)*: 色を直接設定することを許可します。これらのパラメータは、*colors* が辞書でない場合に使用されます。" #: ../../link.rst:53 8c2d9c9d399c48e98a0d4c825a606c31 msgid "" "a dictionary containing color specifications. For accepted dictionary " "keys and values see below. The most practical way should be to first make" " a copy of the *colors* property and then modify this dictionary as " "required." msgstr "" "色仕様を含む辞書。受け入れられる辞書のキーと値については以下を参照してください。最も実用的な方法は、まず *colors* " "プロパティのコピーを作成し、必要に応じてこの辞書を修正することです。" #: ../../link.rst:58 ../../link.rst:65 3104b3d644e844db944ae3665b6c89cb #: be4fe26181df4bd18dfb13ff2743cbac msgid "*New in v1.18.16*" msgstr "*(新バージョン1.18.16で追加)*" #: ../../link.rst:60 383edfd8cffc48289a05af780555e233 msgid "" "Set the PDF `/F` property of the link annotation. See " ":meth:`Annot.set_flags` for details. If not a PDF, this method is a no-" "op." msgstr "" "リンク注釈のPDF `/F` プロパティを設定します。詳細については、:meth:`Annot.set_flags` " "を参照してください。PDFでない場合、このメソッドは無効です。" #: ../../link.rst:67 8ace46d310c8449cb730957a35026758 msgid "" "Return the link annotation flags, an integer (see :attr:`Annot.flags` for" " details). Zero if not a PDF." msgstr "リンク注釈フラグ、整数（詳細については :attr:`Annot.flags` を参照）。PDFでない場合、ゼロです。" #: ../../link.rst:72 4f66fbc6806c4cc3afd7d0c728786903 msgid "" "Meaningful for PDF only: A dictionary of two tuples of floats in range `0" " <= float <= 1` specifying the *stroke* and the interior (*fill*) colors." " If not a PDF, ``None`` is returned. As mentioned above, the fill color " "is always `None` for links. The stroke color is used for the border of " "the link rectangle. The length of the tuple implicitly determines the " "colorspace: 1 = GRAY, 3 = RGB, 4 = CMYK. So `(1.0, 0.0, 0.0)` stands for " "RGB color red. The value of each float *f* is mapped to the integer value" " *i* in range 0 to 255 via the computation *f = i / 255*." msgstr "" "(意味があるのはPDFのみ): ストロークと内部（*塗りつぶし*）の色を指定する `0 <= float <= 1` " "の2つの浮動小数点数のタプルを含む辞書。PDFでない場合、``None`` が返されます。上記のように、リンクの塗りつぶしの色は常に `None`" " です。ストロークの色はリンクの境界のために使用されます。タプルの長さは暗黙的に色空間を決定します: 1 = GRAY、3 = RGB、4 = " "CMYK。したがって、 `(1.0、0.0、0.0)` はRGBカラーの赤を表します。各浮動小数点数 *f* の値は、*f = i / 255* " "の計算を介して範囲0から255の整数値 *i* にマップされます。" #: ../../link.rst a7911594ade24fedb4eb4d5aa32134e3 #: fd0f1aaed0b7451b864e11bf131bfc85 msgid "Return type" msgstr "戻り値のタイプ" #: ../../link.rst:78 8c427c80ff3040929a19af74adb2502f msgid "" "Meaningful for PDF only: A dictionary containing border characteristics. " "It will be ``None`` for non-PDFs and an empty dictionary if no border " "information exists. The following keys can occur:" msgstr "" "(意味があるのはPDFのみ): ボーダーの特性を含む辞書。非PDFの場合、またはボーダー情報が存在しない場合、``None`` " "になります。次のキーが含まれる場合があります:" #: ../../link.rst:80 4a20f270fb5040f285e44464113e3f4e msgid "" "*width* -- a float indicating the border thickness in points. The value " "is -1.0 if no width is specified." msgstr "*width* - ポイント単位でのボーダーの厚さを示す浮動小数点数。幅が指定されていない場合、値は-1.0になります。" #: ../../link.rst:82 031e7d00747b4e7f97f54d9125824c13 msgid "" "*dashes* -- a sequence of integers specifying a line dash pattern. *[]* " "means no dashes, *[n]* means equal on-off lengths of *n* points, longer " "lists will be interpreted as specifying alternating on-off length values." " See the :ref:`AdobeManual` page 126 for more detail." msgstr "" "*dashes* - ラインダッシュパターンを指定する整数のシーケンス。*[]* はダッシュがないことを意味し、*[n]* は " "*n*ポイントの等しいオンオフの長さを指定し、長いリストは交互にオンオフの長さ値を指定すると解釈されます。詳細については " ":ref:`AdobeManual` のページ126を参照してください。" #: ../../link.rst:84 b1ce9fb22af2473084abfad8dcc81664 msgid "" "*style* -- 1-byte border style: *S* (Solid) = solid rectangle surrounding" " the annotation, *D* (Dashed) = dashed rectangle surrounding the link, " "the dash pattern is specified by the *dashes* entry, *B* (Beveled) = a " "simulated embossed rectangle that appears to be raised above the surface " "of the page, *I* (Inset) = a simulated engraved rectangle that appears to" " be recessed below the surface of the page, *U* (Underline) = a single " "line along the bottom of the annotation rectangle." msgstr "" "*style* - 1バイトのボーダースタイル: " "*S*（実線）=注釈を囲む実線の四角形、*D*（破線）=リンクを囲む破線の四角形、ダッシュパターンは *dashes* エントリで指定されます、 " "*B* （ベベル）=ページの表面から持ち上げられたように見える模倣の浮き彫りの四角形、 *I* " "（インセット）=ページの表面からくぼみがあるように見える模倣の刻まれた四角形、 *U* （下線）=注釈四角形の底部に沿った単一の線。" #: ../../link.rst:90 f0b94d1fd724429f9db2c8920d74db77 msgid "The area that can be clicked in untransformed coordinates." msgstr "クリックできる領域、変換されていない座標での" #: ../../link.rst 275915bb29d54074a8eee5bb003e6f35 #: 4cc4afb263e942e982a0c610ec312fed 61d480baed10423880ce97394eef1896 #: 70b3b447b662426ca1084fb4942fc8f6 a60b7e4f00d946b98c5bd0406ac9f8cb #: b81ca89a6ed84d7a914f39bc42817ff7 msgid "type" msgstr "" #: ../../link.rst:92 ef517da173d042b5b2f74bba55ab4cde msgid ":ref:`Rect`" msgstr ":ref:`Rect` （矩形）" #: ../../link.rst:96 d54fc6555294411bab3c8c9b85b0fbcc msgid "" "A bool specifying whether the link target is outside of the current " "document." msgstr "現在の文書の外部にリンクの対象があるかどうかを指定するブール値。" #: ../../link.rst:98 64dfe441deaf43ba9c1393ca9b801ce0 msgid "bool" msgstr "" #: ../../link.rst:102 23ce8eaf99fc4747a0d479729c096f79 msgid "" "A string specifying the link target. The meaning of this property should " "be evaluated in conjunction with property `is_external`:" msgstr "⚠️" #: ../../link.rst:106 434842aad107476da3635f648121b5d5 #, fuzzy msgid "" "`is_external` is true: `uri` points to some target outside the current " "PDF, which may be an internet resource (`uri` starts with ``http://`` or " "similar), another file (`uri` starts with \"file:\" or \"file://\") or " "some other service like an e-mail address (`uri` starts with " "``mailto:``)." msgstr "⚠️" #: ../../link.rst:112 9f133b2c3fce47338ccfeb9dad429fa6 msgid "" "`is_external` is false: `uri` will be `None` or point to an internal " "location. In case of PDF documents, this should either be *#nnnn* to " "indicate a 1-based (!) page number *nnnn*, or a named location. The " "format varies for other document types, for example " "\"../FixedDoc.fdoc#PG_2_LNK_1\" for page number 2 (1-based) in an XPS " "document." msgstr "⚠️" #: ../../link.rst:119 47f95869926845dfa68de8ffff9c59ab msgid "str" msgstr "" #: ../../link.rst:123 05b9e3e95335428f838140f7e0e85b7b msgid "An integer specifying the PDF :data:`xref`. Zero if not a PDF." msgstr "PDF :data:`xref` を指定する整数。PDFでない場合はゼロ。" #: ../../link.rst:125 08dd0b407efc4037b5bf9715bf5410f4 msgid "int" msgstr "" #: ../../link.rst:129 19952b4d82224998827923818129feeb msgid "The next link or ``None``." msgstr "次のリンクまたは ``None``。" #: ../../link.rst:131 7091be260ac544a5955b3c6502751efb msgid "*Link*" msgstr "*Link* （リンク）" #: ../../link.rst:135 7dd1efb015df4899bf9b0392c76b6b6d msgid "The link destination details object." msgstr "リンクの対象の詳細オブジェクト。" #: ../../link.rst:137 428b1356734c407883ebe43912f1f3ea msgid ":ref:`linkDest`" msgstr "" #: ../../footer.rst:60 9de2e7e1b27c4242976413a45087b2a6 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "A string specifying the link target. " #~ "The meaning of this property should " #~ "be evaluated in conjunction with " #~ "property *isExternal*. The value may be" #~ " ``None``, in which case *isExternal " #~ "== False*. If *uri* starts with " #~ "*file://*, *mailto:*, or an internet " #~ "resource name, *isExternal* is ``True``. " #~ "In all other cases *isExternal == " #~ "False* and *uri* points to an " #~ "internal location. In case of PDF " #~ "documents, this should either be *#nnnn*" #~ " to indicate a 1-based (!) page " #~ "number *nnnn*, or a named location. " #~ "The format varies for other document " #~ "types, e.g. *uri = " #~ "'../FixedDoc.fdoc#PG_2_LNK_1'* for page number " #~ "2 (1-based) in an XPS document." #~ msgstr "" #~ "リンクの対象を指定する文字列。このプロパティの意味は、プロパティ *isExternal* " #~ "と共に評価する必要があります。値が ``None`` の場合、*isExternal == " #~ "False* です。 *uri* が *file://、mailto:* " #~ "、またはインターネットリソース名で始まる場合、 *isExternal* は ``True`` " #~ "です。それ以外の場合、 *isExternal == False* で " #~ "*uri* は内部の場所を指します。PDF文書の場合、これは1から始まるページ番号 *nnnn* " #~ "を示すために *#nnnn* " #~ "であるか、名前付きの場所である必要があります。他の文書タイプの場合、フォーマットは異なります。たとえば、XPS文書の場合、 " #~ "*uri = '../FixedDoc.fdoc#PG_2_LNK_1'* " #~ "は、2ページ（1から始まる）を示します。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/linkdest.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 c9d403d602c14550a5468c49b79ec151 msgid "Artifex" msgstr "" #: ../../header.rst:-1 2ce574ba495d4bef8dfc597a774b5eb2 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 8d5420280aa04b0e82c737fe2879efc1 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../linkdest.rst:7 5be0406fa37d496c8d775d5c14ccbc9b msgid "linkDest" msgstr "" #: ../../linkdest.rst:8 dbc5983be663459da1a305db6fd4b633 msgid "" "Class representing the `dest` property of an outline entry or a link. " "Describes the destination to which such entries point." msgstr "アウトラインエントリまたはリンクの `dest` プロパティを表すクラス。これらのエントリが指す先の目的地を説明します。" #: ../../linkdest.rst:10 fadcf1b2cb264b42a61422b1b39f9940 msgid "" "Up to MuPDF v1.9.0 this class existed inside MuPDF and was dropped in " "version 1.10.0. For backward compatibility, PyMuPDF is still maintaining " "it, although some of its attributes are no longer backed by data actually" " available via MuPDF." msgstr "" "MuPDF " "v1.9.0まで、このクラスはMuPDF内に存在し、バージョン1.10.0で削除されました。後方互換性のため、PyMuPDFはそれを引き続き維持していますが、その属性のいくつかは実際にはMuPDFを介して利用可能なデータでバックアップされていないことに注意してください。" #: ../../linkdest.rst:13 5cc4c7e9b4c94a61b74581d3ab546826 msgid "**Attribute**" msgstr "**属性**" #: ../../linkdest.rst:13 2bb1dd6fb2e14d74b6262ace5e110a91 msgid "**Short Description**" msgstr "**短い説明**" #: ../../linkdest.rst:15 4f46e630676f4c0d9573cd5caeeeec87 msgid ":attr:`linkDest.dest`" msgstr "" #: ../../linkdest.rst:15 b8176d37e0ab4c298fa79512e4e04ca7 msgid "destination" msgstr "目的地" #: ../../linkdest.rst:16 7d38469c9fd94cc5ae034b83b7dc6c89 msgid ":attr:`linkDest.fileSpec`" msgstr "" #: ../../linkdest.rst:16 c7535db1bddc446a8d9ec72cbe6ffee5 msgid "file specification (path, filename)" msgstr "ファイル仕様（パス、ファイル名）" #: ../../linkdest.rst:17 09737ba6f55b4fd39a12293d1d0d3425 msgid ":attr:`linkDest.flags`" msgstr "" #: ../../linkdest.rst:17 b064dee65c8e4774b3aaf4042b4297e5 msgid "descriptive flags" msgstr "説明的なフラグ" #: ../../linkdest.rst:18 4bcf60e4eab64157a425d9fc9067c73d msgid ":attr:`linkDest.isMap`" msgstr "" #: ../../linkdest.rst:18 07f875efd9754adc83c776866a862b02 msgid "is this a MAP?" msgstr "これはMAPですか？" #: ../../linkdest.rst:19 91af568ccac84cd5b4ee16d388bbb93e msgid ":attr:`linkDest.isUri`" msgstr "" #: ../../linkdest.rst:19 ee75600c30be45058d58b89f78d55876 msgid "is this a URI?" msgstr "これはURIですか？" #: ../../linkdest.rst:20 855d7ecb78564fbcbf4373cff63475fe msgid ":attr:`linkDest.kind`" msgstr "" #: ../../linkdest.rst:20 8649be963579431cbf6b4132d29871dc msgid "kind of destination" msgstr "目的地の種類" #: ../../linkdest.rst:21 2e3bd4e2ae394a558dbc24ba2ac241b8 msgid ":attr:`linkDest.lt`" msgstr "" #: ../../linkdest.rst:21 704e8f3a402648918640ee171f22159a msgid "top left coordinates" msgstr "左上の座標" #: ../../linkdest.rst:22 e72f8149e16f4a28b4994101fa9458fa msgid ":attr:`linkDest.named`" msgstr "" #: ../../linkdest.rst:22 7024a1c5676a4db182cde158adddcefd msgid "name if named destination" msgstr "名前付き目的地の名前" #: ../../linkdest.rst:23 a607a689ec9a430585a215fd17274636 msgid ":attr:`linkDest.newWindow`" msgstr "" #: ../../linkdest.rst:23 306056d18da1405fb16d64afcd5db2b1 msgid "name of new window" msgstr "新しいウィンドウの名前" #: ../../linkdest.rst:24 0e354263696b4dea884ce7b0e8659268 msgid ":attr:`linkDest.page`" msgstr "" #: ../../linkdest.rst:24 709b2315bb6242709a51deccd9017a09 msgid "page number" msgstr "ページ番号" #: ../../linkdest.rst:25 db8af5778b80458c8954ad3b5d8f4b1d msgid ":attr:`linkDest.rb`" msgstr "" #: ../../linkdest.rst:25 cc7df48156634225ab78f47225de634e msgid "bottom right coordinates" msgstr "右下の座標" #: ../../linkdest.rst:26 9591bd156430496fa34539728e98f4f2 msgid ":attr:`linkDest.uri`" msgstr "" #: ../../linkdest.rst:26 cd8d4153a6044983bdc26e8c29c809ad msgid "URI" msgstr "" #: ../../linkdest.rst:29 578749192c9f4502a4e8daf7c90af448 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../linkdest.rst:35 bcd161881123491fb6ea03b01fee7817 msgid "" "Target destination name if :attr:`linkDest.kind` is :data:`LINK_GOTOR` " "and :attr:`linkDest.page` is *-1*." msgstr "" ":attr:`linkDest.kind` が:data:`LINK_GOTOR` であり、:attr:`linkDest.page` が " "*-1* の場合、対象の宛先名。" #: ../../linkdest.rst 24dee675d4504f8981a51fa2b8c9ae57 #: 3c8f45e7a79841869726ce8c2db738bb 4e7db470641845cb993cb6d79edfc402 #: 5282e07210cd45d1afe857765c18bb82 600998af429f4438b130f86a27543213 #: 6190f4a6cbe547ee9bd7ce0672cbe0ea 6a314b30d1cd42cfb8ce9fbf698ea996 #: 870a506b36024eee8203fa29ce90b30b a7317f9a30854058bcfea86fbe37948e #: cefd59f82f5344b9bb86d527d790c30d df60e9fbe1294169ba1907f3adf1b9ee #: f0cbb7037b834652bf39d488832ee865 msgid "type" msgstr "" #: ../../linkdest.rst:37 ../../linkdest.rst:43 ../../linkdest.rst:79 #: ../../linkdest.rst:103 5bb912195e6349f8b39f6b50f9cb244b #: 621a722c520f47be96d16809c80f9936 ef378de79abf404d8902449278613652 #: f1c0a413cf6f4affa2d72ce50adf67ef msgid "str" msgstr "" #: ../../linkdest.rst:41 0d7b86556af7432ca01f62687b7105b8 msgid "" "Contains the filename and path this link points to, if " ":attr:`linkDest.kind` is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." msgstr "" ":attr:`linkDest.kind` が :data:`LINK_GOTOR` または :data:`LINK_LAUNCH` " "の場合、このリンクが指すファイル名とパスが含まれています。" #: ../../linkdest.rst:47 e82ff43942aa42d181926cc8311a04ad msgid "" "A bitfield describing the validity and meaning of the different aspects " "of the destination. As far as possible, link destinations are constructed" " such that e.g. :attr:`linkDest.lt` and :attr:`linkDest.rb` can be " "treated as defining a bounding box. But the flags indicate which of the " "values were actually specified, see :ref:`linkDest Flags`." msgstr "" "宛先のさまざまな側面の有効性と意味を説明するビットフィールド。できる限り、リンクの宛先は、:attr:`linkDest.lt` と " ":attr:`linkDest.rb` " "をバウンディングボックスを定義するものとして扱えるように構築されています。ただし、フラグは、値のうち実際に指定されたものを示します。:ref:`linkDest" " Flags` を参照してください。" #: ../../linkdest.rst:49 ../../linkdest.rst:67 ../../linkdest.rst:91 #: 1e2a30929fb3424ca85ef2673484279a c4abce4eafe44aa48a61e88929d22db8 #: e6f10f094da249a08f0b1da68a5ad807 msgid "int" msgstr "" #: ../../linkdest.rst:53 5ca1397ac660408a8118784ff2e478e2 msgid "" "This flag specifies whether to track the mouse position when the URI is " "resolved. Default value: False." msgstr "このフラグは、URIが解決されるときにマウスの位置を追跡するかどうかを指定します。デフォルト値：False。" #: ../../linkdest.rst:55 ../../linkdest.rst:61 ../../linkdest.rst:85 #: 03a9fad387d243f5936876e77a91a777 5d8a261398264f87bcb172afe9477166 #: b1cc8e9c4d094ea7b9418b5001babd00 msgid "bool" msgstr "" #: ../../linkdest.rst:59 9653264615ef4612b74c934e94035162 msgid "" "Specifies whether this destination is an internet resource (as opposed to" " e.g. a local file specification in URI format)." msgstr "この宛先がインターネットリソースであるか（URI形式のローカルファイル仕様とは異なる場合）、指定します。" #: ../../linkdest.rst:65 572624f8e5234fcfabe2886d19f59fb8 msgid "" "Indicates the type of this destination, like a place in this document, a " "URI, a file launch, an action or a place in another file. Look at " ":ref:`linkDest Kinds` to see the names and numerical values." msgstr "" "この宛先のタイプを示します。この文書内の場所、URI、ファイル起動、アクション、または他のファイル内の場所など。リンク宛先の種類を確認するには、:ref:`linkDest" " Kinds` を参照してください。" #: ../../linkdest.rst:71 8df3c853090f4d899931e326f5459d67 msgid "The top left :ref:`Point` of the destination." msgstr "宛先の左上の :ref:`Point` 。" #: ../../linkdest.rst:73 ../../linkdest.rst:97 3c5d8c4d8bb041fc8c0f7572f332a8fa #: 4501f09bd6dd44348a5a0d661f366be0 msgid ":ref:`Point`" msgstr "" #: ../../linkdest.rst:77 35ddae2dc20442baa69cb10014649914 msgid "" "This destination refers to some named action to perform (e.g. a " "javascript, see :ref:`AdobeManual`). Standard actions provided are " "*NextPage*, *PrevPage*, *FirstPage*, and *LastPage*." msgstr "" "この宛先は実行する名前付きアクションを指します（たとえば、JavaScriptなど、:ref:`AdobeManual` " "を参照）。提供される標準アクションは、*NextPage*、*PrevPage*、*FirstPage*、および *LastPage* です。" #: ../../linkdest.rst:83 8f9e7bda1b8f488aa95b2e92bbb2e3d2 msgid "If true, the destination should be launched in a new window." msgstr "trueの場合、宛先は新しいウィンドウで起動する必要があります。" #: ../../linkdest.rst:89 2a3bd78c3548465da36247eac48b559e msgid "" "The page number (in this or the target document) this destination points " "to. Only set if :attr:`linkDest.kind` is :data:`LINK_GOTOR` or " ":data:`LINK_GOTO`. May be *-1* if :attr:`linkDest.kind` is " ":data:`LINK_GOTOR`. In this case :attr:`linkDest.dest` contains the " "**name** of a destination in the target document." msgstr "" "この宛先が指すページ番号（この文書または対象の文書内）です。:attr:`linkDest.kind` が :data:`LINK_GOTOR` " "または :data:`LINK_GOTO` の場合にのみ設定されます。:attr:`linkDest.kind` が " ":data:`LINK_GOTOR` の場合、*-1* になる場合があります。この場合、:attr:`linkDest.dest` " "には対象の文書内の宛先の名前が含まれます。" #: ../../linkdest.rst:95 c402b9a2b14a499684cc75932a7b3061 msgid "The bottom right :ref:`Point` of this destination." msgstr "この宛先の右下の :ref:`Point`。" #: ../../linkdest.rst:101 efac7e980e8e403c9d1c9d57cd1420bc msgid "The name of the URI this destination points to." msgstr "この宛先が指すURIの名前。" #: ../../footer.rst:60 d9aa1a371bcc4440af0a82a4a3ca0b1f msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/lowlevel.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f8b51ec0649943efad8a9aad2f2ae5f0 msgid "Artifex" msgstr "" #: ../../header.rst:-1 f7f6d9b162764bd5bab35f0de0f68994 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 320005d084534805bbe61a078db61350 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../lowlevel.rst:5 4f2d1ec9ba784ccaaa499966f89668e5 msgid "Low Level Functions and Classes" msgstr "低レベルの関数とクラス" #: ../../lowlevel.rst:6 b0646074fd384255aef9e51bfce2650a msgid "" "Contains a number of functions and classes for the experienced user. To " "be used for special needs or performance requirements." msgstr "経験豊富なユーザー向けの関数とクラスが多数含まれています。 特別なニーズやパフォーマンス要件に使用します。" #: ../../footer.rst:60 4631787f1e8f470d9ab48b85edc12753 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/matrix.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 22b6a2a0571c4176bce077c545c814b3 msgid "Artifex" msgstr "" #: ../../header.rst:-1 73c9619ac3ee44d084a65d56842dc380 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 84065a34a4a14808906180f02e2efea2 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../matrix.rst:7 8a040befeffb44ac97583a22b00537bb msgid "Matrix" msgstr "Matrix (マトリックス)" #: ../../matrix.rst:9 8eb69980d89943bb8e94c77820ab6263 msgid "" "Matrix is a row-major 3x3 matrix used by image transformations in MuPDF " "(which complies with the respective concepts laid down in the " ":ref:`AdobeManual`). With matrices you can manipulate the rendered image " "of a page in a variety of ways: (parts of) the page can be rotated, " "zoomed, flipped, sheared and shifted by setting some or all of just six " "float values." msgstr "" "マトリックスは、MuPDFでの画像変換に使用される行優先の3x3マトリックスです（これは :ref:`AdobeManual` " "に規定されている対応するコンセプトに従っています）。マトリックスを使用することで、ページの描画画像をさまざまな方法で操作できます。ページの一部またはすべてを回転、拡大縮小、反転、せん断、シフトなどに設定することができます。これらの操作には、たった6つの浮動小数点数値のいくつかまたはすべてを設定します。" #: ../../matrix.rst:12 99311bf26c5b4fd5b0df9afed1d8ff5a #, fuzzy msgid "" "Since all points or pixels live in a two-dimensional space, one column " "vector of that matrix is a constant unit vector, and only the remaining " "six elements are used for manipulations. These six elements are usually " "represented by `[a, b, c, d, e, f]`. Here is how they are positioned in " "the matrix:" msgstr "" "すべてのポイントまたはピクセルは2次元の空間に存在するため、そのマトリックスの1つの列ベクトルは定数ユニットベクトルであり、操作に使用されるのは残りの6つの要素のみです。これらの6つの要素は通常、" " *[a、b、c、d、e、f]* で表されます。以下は、それらがマトリックス内でどのように配置されているかです。" #: ../../matrix.rst:17 981036c6e6c24d00adc24601b311399b msgid "Please note:" msgstr "注意点：" #: ../../matrix.rst:19 f1ae75aa82ce4a989a3afb538b648bd5 msgid "" "the below methods are just convenience functions -- everything they do, " "can also be achieved by directly manipulating the six numerical values" msgstr "以下のメソッドは便宜的な機能であり、行うすべてのことは、6つの数値の値を直接操作しても実現できます。" #: ../../matrix.rst:20 26c41674818040ab9d706c72f62e5b31 msgid "" "all manipulations can be combined -- you can construct a matrix that " "rotates **and** shears **and** scales **and** shifts, etc. in one go. If " "you however choose to do this, do have a look at the **remarks** further " "down or at the :ref:`AdobeManual`." msgstr "" "すべての操作を組み合わせることができます。1回の操作で回転、せん断、スケール、シフトなどを同時に実行するマトリックスを構築できます。ただし、これを行う場合は、後での" " **注釈** または :ref:`AdobeManual` を参照してください。" #: ../../matrix.rst:23 afd4ea95b6d34a6e914cc64e20f4259b msgid "**Method / Attribute**" msgstr "**メソッド／属性**" #: ../../matrix.rst:23 c34d2903bcee45ddb3cc5e621baefea0 msgid "**Description**" msgstr "**説明**" #: ../../matrix.rst:25 11abdcd6cd234d4fa95850fe12580df9 msgid ":meth:`Matrix.prerotate`" msgstr "" #: ../../matrix.rst:25 80427e602a66422cac1da53c44af455f msgid "perform a rotation" msgstr "回転を実行" #: ../../matrix.rst:26 cad3e578828b433ba7ba0051be2032bf msgid ":meth:`Matrix.prescale`" msgstr "" #: ../../matrix.rst:26 a7e0bd6a201641fb912613e9f27fd76f msgid "perform a scaling" msgstr "スケーリングを実行" #: ../../matrix.rst:27 50c7f90d06004c62b19c6bff1b5a0ee9 msgid ":meth:`Matrix.preshear`" msgstr "" #: ../../matrix.rst:27 10745ab48ff842fa86f0dba65a8ac4c9 msgid "perform a shearing (skewing)" msgstr "せん断（歪み）を実行" #: ../../matrix.rst:28 b4c7cc3f2aff4f929fd556b21396c232 msgid ":meth:`Matrix.pretranslate`" msgstr "" #: ../../matrix.rst:28 cefba85880554c02abc66d69a6a32faf msgid "perform a translation (shifting)" msgstr "移動（シフト）を実行" #: ../../matrix.rst:29 b3b9abc777594cf8b33d5290836afe88 msgid ":meth:`Matrix.concat`" msgstr "" #: ../../matrix.rst:29 fe1f3aa66e6042309e54265e9b99b18d msgid "perform a matrix multiplication" msgstr "マトリックスの乗算を実行" #: ../../matrix.rst:30 fb89b2f56f6247ac8fc9b88f34f7e6c1 msgid ":meth:`Matrix.invert`" msgstr "" #: ../../matrix.rst:30 4dab7517ebb647c78b179fbe83285a9f msgid "calculate the inverted matrix" msgstr "反転されたマトリックスを計算" #: ../../matrix.rst:31 3f0c29fd96594bd7824f5d9ab40c0fd7 msgid ":meth:`Matrix.norm`" msgstr "" #: ../../matrix.rst:31 bee6a79c30594e5a9982c37569a07722 msgid "the Euclidean norm" msgstr "ユークリッドノルム" #: ../../matrix.rst:32 b0e601bc11b94c5b978faf3969d20262 msgid ":attr:`Matrix.a`" msgstr "" #: ../../matrix.rst:32 7bd503f42cb2438da182834d71fb2dd4 msgid "zoom factor X direction" msgstr "ズームファクターX方向" #: ../../matrix.rst:33 b20b6e26dcf04b37bf9d3226d6b7720f msgid ":attr:`Matrix.b`" msgstr "" #: ../../matrix.rst:33 dc49e0f4424c40eaa3c9b116b0a0d20f msgid "shearing effect Y direction" msgstr "せん断効果Y方向" #: ../../matrix.rst:34 d2e19dfdd9104ec19d44f40c663bcc03 msgid ":attr:`Matrix.c`" msgstr "" #: ../../matrix.rst:34 0a2f7dcd0de34db7a4c69a001674c37a msgid "shearing effect X direction" msgstr "せん断効果X方向" #: ../../matrix.rst:35 c72a8985cba049b487c8ffebefcf9d99 msgid ":attr:`Matrix.d`" msgstr "" #: ../../matrix.rst:35 c1fe0a57201a4eb6ad2a830ae1b17b15 msgid "zoom factor Y direction" msgstr "ズームファクターY方向" #: ../../matrix.rst:36 e471bd7cfd92424ab1e5f3e5059d4be9 msgid ":attr:`Matrix.e`" msgstr "" #: ../../matrix.rst:36 d19ab3110ade4ac3b17c845a8c80fb37 msgid "horizontal shift" msgstr "水平シフト" #: ../../matrix.rst:37 4a6eb68a255c4608873196c13298d411 msgid ":attr:`Matrix.f`" msgstr "" #: ../../matrix.rst:37 0f0db520282844e9869b27e82d6fba11 msgid "vertical shift" msgstr "垂直シフト" #: ../../matrix.rst:38 e75c12f64eee44059ea4b0762741fdb1 msgid ":attr:`Matrix.is_rectilinear`" msgstr "" #: ../../matrix.rst:38 bc57693d7a8c445eb2a7717732d081b9 msgid "true if rect corners will remain rect corners" msgstr "角の位置が直線のままの場合はTrue" #: ../../matrix.rst:41 01aaa6a5cece41dd86f5e6c6f0d08b42 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../matrix.rst:59 56627216de1442368ffe90a40bd40b5a msgid "Overloaded constructors." msgstr "オーバーロードされたコンストラクター。" #: ../../matrix.rst:61 ab9ade436b794d9cb70e8ec07c59573e msgid "" "Without parameters, the zero matrix *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, " "0.0)* will be created." msgstr "パラメーターなしの場合、ゼロ行列 *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, 0.0)* が作成されます。" #: ../../matrix.rst:63 0ff005031e87475e82c82f509a503432 msgid "" "*zoom-** and *shear-** specify zoom or shear values (float) and create a " "zoom or shear matrix, respectively." msgstr "*zoom-** および *shear-** はズームまたはシアーの値（float）を指定し、それぞれズームまたはシアーの行列を作成します。" #: ../../matrix.rst:65 3772827e3c4e46efaa66e0541654fbde msgid "For \"matrix\" a **new copy** of another matrix will be made." msgstr "\"matrix\" の場合、別の行列の **新しいコピー** が作成されます。" #: ../../matrix.rst:67 e0de220e569d4fb192d61776da7cc98d msgid "" "Float value \"degree\" specifies the creation of a rotation matrix which " "rotates anti-clockwise." msgstr "浮動小数点値 \"degree\" は、反時計回りに回転する行列を作成することを指定します。" #: ../../matrix.rst:69 202fbb08a1534f9b873b978d1ee2f25e msgid "" "A \"sequence\" must be any Python sequence object with exactly 6 float " "entries (see :ref:`SequenceTypes`)." msgstr "" "\"sequence\" は、正確に 6 つの浮動小数点エントリを持つ任意の Python " "シーケンスオブジェクトである必要があります（:ref:`SequenceTypes`）。" #: ../../matrix.rst:71 3290c36cfd044349b8b73b9a12b39105 #, fuzzy msgid "" "*pymupdf.Matrix(1, 1)* and *pymupdf.Matrix(pymupdf.Identity)* create " "modifiable versions of the :ref:`Identity` matrix, which looks like *[1, " "0, 0, 1, 0, 0]*." msgstr "" "*pymupdf.Matrix(1, 1)*、*pymupdf.Matrix(0.0)* および " "*pymupdf.Matrix(pymupdf.Identity)*) は、*[1, 0, 0, 1, 0, 0]* のような " ":ref:`Identity` マトリックスの修正可能なバージョンを作成します。" #: ../../matrix.rst:75 2d27925e056c4beab39284c17c097dc8 msgid "New in version 1.16.0" msgstr "バージョン 1.16.0 で新規追加" #: ../../matrix.rst:77 23099b3eeb904d19a2fca93ba4ff4ac2 msgid "Return the Euclidean norm of the matrix as a vector." msgstr "ベクトルとしての行列のユークリッドノルムを返します。" #: ../../matrix.rst:81 cf82a48349524343a3a9fb35951b2482 msgid "" "Modify the matrix to perform a counter-clockwise rotation for positive " "*deg* degrees, else clockwise. The matrix elements of an identity matrix " "will change in the following way:" msgstr "" "マトリックスを修正して、正の *deg* " "度の場合は反時計回りに、それ以外の場合は時計回りに回転します。アイデンティティマトリックスの行列要素は以下のように変更されます：" #: ../../matrix.rst:83 a024346df65d49e7bcdef1a35d0f0ea9 msgid "*[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*." msgstr "*[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*。" #: ../../matrix.rst 0e2caa4b969d4e8c883315663dfbb010 #: 2a76f7fdef494d7cb96fb9bcb0b288a0 44ed05851fab4cd4b3017cd0b82bc4f4 #: 797389fbee9c42f6a11d44d628804863 c8b2675c06ee43c4abcd46c105be0f19 #: e6e50d5d62724013ba993ce51b6e65a8 msgid "Parameters" msgstr "" #: ../../matrix.rst:85 34bf9b5e70b9486285ffd6799c5556ca msgid "" "The rotation angle in degrees (use conventional notation based on Pi = " "180 degrees)." msgstr "度単位での回転角度（180度ベースの従来の表記法を使用します）。" #: ../../matrix.rst:89 94eb659613c24f939142b8fc6dd19ab4 msgid "" "Modify the matrix to scale by the zoom factors sx and sy. Has effects on " "attributes *a* thru *d* only: *[a, b, c, d, e, f] -> [a*sx, b*sx, c*sy, " "d*sy, e, f]*." msgstr "" "マトリックスを修正してズームファクター sx および sy でスケーリングします。属性 *a* から *d* にのみ影響を与えます： *[a, " "b, c, d, e, f] -> [a*sx, b*sx, c*sy, d*sy, e, f]*。" #: ../../matrix.rst:91 72c725939ccb4e8b90b12926ae88abec msgid "" "Zoom factor in X direction. For the effect see description of attribute " "*a*." msgstr "X方向のズームファクター。効果については属性 *a* の説明を参照してください。" #: ../../matrix.rst:93 2ef911aad48643e18db6f643f2613c9a msgid "" "Zoom factor in Y direction. For the effect see description of attribute " "*d*." msgstr "Y方向のズームファクター。効果については属性 *d* の説明を参照してください。" #: ../../matrix.rst:97 a47d6e8530894f2aac1846c0416c7f14 msgid "" "Modify the matrix to perform a shearing, i.e. transformation of " "rectangles into parallelograms (rhomboids). Has effects on attributes *a*" " thru *d* only: *[a, b, c, d, e, f] -> [c*sy, d*sy, a*sx, b*sx, e, f]*." msgstr "" "行列を修正して、シアリング、つまり長方形を平行四辺形（ひし形）に変換する操作を実行します。属性 *a* から *d* にのみ影響を与えます： " "*[a, b, c, d, e, f] -> [c*sy, d*sy, a*sx, b*sx, e, f]*。" #: ../../matrix.rst:99 7af0396c77db4280bd8b6ef9764cab2d msgid "Shearing effect in X direction. See attribute *c*." msgstr "X 方向のシアリング効果。属性 *c* を参照してください。" #: ../../matrix.rst:101 5a8d7d2b58c348f0bf481d54d9ff5b01 msgid "Shearing effect in Y direction. See attribute *b*." msgstr "Y 方向のシアリング効果。属性 *b* を参照してください。" #: ../../matrix.rst:105 152c5f45800e42b6a038fee68ba116d4 msgid "" "Modify the matrix to perform a shifting / translation operation along the" " x and / or y axis. Has effects on attributes *e* and *f* only: *[a, b, " "c, d, e, f] -> [a, b, c, d, tx*a + ty*c, tx*b + ty*d]*." msgstr "" "X 軸および / または Y 軸に沿ったシフト / 移動操作を実行するために行列を修正します。属性 *e* と *f* にのみ影響を与えます： " "*[a, b, c, d, e, f] -> [a, b, c, d, tx*a + ty*c, tx*b + ty*d]* 。" #: ../../matrix.rst:107 8b15e98fb7734d2fb7d3a90c734616fd msgid "Translation effect in X direction. See attribute *e*." msgstr "X 方向の移動効果。属性 *e* を参照してください。" #: ../../matrix.rst:109 1ac03cdeaadf47039b40d141265dad51 msgid "Translation effect in Y direction. See attribute *f*." msgstr "Y 方向の移動効果。属性 *f* を参照してください。" #: ../../matrix.rst:113 a7232949340949e6bee6b5a75b157849 msgid "" "Calculate the matrix product *m1 * m2* and store the result in the " "current matrix. Any of *m1* or *m2* may be the current matrix. Be aware " "that matrix multiplication is not commutative. So the sequence of *m1*, " "*m2* is important." msgstr "" "行列の積 *m1* * *m2* を計算し、その結果を現在の行列に格納します。*m1* または *m2* " "のいずれかが現在の行列である場合があります。行列の乗算は可換ではないことに注意してください。したがって、*m1*、*m2* の順序が重要です。" #: ../../matrix.rst:115 c868c7bce6e24c17aefb279a2b589bad msgid "First (left) matrix." msgstr "最初の（左側）行列。" #: ../../matrix.rst:118 6a23a720cc824c018154df578fbe2287 msgid "Second (right) matrix." msgstr "2 番目の（右側）行列。" #: ../../matrix.rst:123 c1c62753df994db5a29eaf60b74d5311 msgid "" "Calculate the matrix inverse of *m* and store the result in the current " "matrix. Returns *1* if *m* is not invertible (\"degenerate\"). In this " "case the current matrix **will not change**. Returns *0* if *m* is " "invertible, and the current matrix is replaced with the inverted *m*." msgstr "" "行列 *m* の逆行列を計算し、その結果を現在の行列に格納します。*m* が逆行列を持たない場合（\"degenerate\"）は 1 " "を返します。この場合、現在の行列は *変更されません* 。m が逆行列を持つ場合は 0 を返し、現在の行列は m の逆行列で置き換えられます。" #: ../../matrix.rst:125 6f3f8c966b71407b9e3b02488f7f4034 msgid "Matrix to be inverted. If not provided, the current matrix will be used." msgstr "逆行列を計算する行列。提供されない場合、現在の行列が使用されます。" #: ../../matrix.rst e8077cac107d4551bdd9b1c1d14a4952 msgid "Return type" msgstr "" #: ../../matrix.rst:132 db229e59a31b455b98ea5ccfa578122a msgid "" "Scaling in X-direction **(width)**. For example, a value of 0.5 performs " "a shrink of the **width** by a factor of 2. If a < 0, a left-right flip " "will (additionally) occur." msgstr "X方向 **（幅）** のスケーリング。たとえば、0.5の値は **幅** を2倍に縮小します。a < 0の場合、左右反転が追加で発生します。" #: ../../matrix.rst 6fcedf91827d4c289e6a645364d76ea6 #: 8654b40d08014804b0c0e8c304580291 96cbe6754a4b4f99bb7e0e80e180c0a6 #: afc20c369a9f4c739bc1f16197754859 c2c0c17a6a334d9daf1a246b0a95ca15 #: fab66c3105f3412b8e17b401ecfe57ab fceb1d67502e44b49baa260b088dd68f msgid "type" msgstr "" #: ../../matrix.rst:134 ../../matrix.rst:140 ../../matrix.rst:146 #: ../../matrix.rst:152 ../../matrix.rst:158 ../../matrix.rst:164 #: 137024cc37b74d68971a780ab821bb5c 20de69effd914f3f92727bc07f7de025 #: 5804209069a04b28ae858ceb0466f4d1 5b5b333b8cb346858ac4e11335709c2a #: 789de033d5c0443997dabc1c08157dbc 867fd680a9e9402583480286d03e27ca msgid "float" msgstr "" #: ../../matrix.rst:138 c229f8ba4d804490b761e624fe313b6d msgid "" "Causes a shearing effect: each `Point(x, y)` will become `Point(x, y - " "b*x)`. Therefore, horizontal lines will be \"tilt\"." msgstr "" "シアリング効果を引き起こします：各 `Point(x, y)` は `Point(x、y - b * x)` " "になります。したがって、水平線は「傾斜」します。" #: ../../matrix.rst:144 7b98255d69974126bcf901feb1b268f6 msgid "" "Causes a shearing effect: each `Point(x, y)` will become `Point(x - c*y, " "y)`. Therefore, vertical lines will be \"tilt\"." msgstr "" "シアリング効果を引き起こします：各 `Point(x, y)` は `Point(x - c * y、y)` " "になります。したがって、垂直線は「傾斜」します。" #: ../../matrix.rst:150 ac4f38489ad847b7827dcac0e26521a5 msgid "" "Scaling in Y-direction **(height)**. For example, a value of 1.5 performs" " a stretch of the **height** by 50%. If d < 0, an up-down flip will " "(additionally) occur." msgstr "Y方向 **（高さ）** でのスケーリング。たとえば、1.5の値は **高さ** を50％伸ばします。d < 0の場合、上下反転が追加で発生します。" #: ../../matrix.rst:156 9660c53c0df84ae99b72badb3989dddf msgid "" "Causes a horizontal shift effect: Each *Point(x, y)* will become *Point(x" " + e, y)*. Positive (negative) values of *e* will shift right (left)." msgstr "" "水平シフト効果を引き起こします：各 *Point(x, y)* は *Point(x + e、y)* " "になります。eの正の（負の）値は右に（左に）シフトします。" #: ../../matrix.rst:162 96c71528239744f1b8cd967c2e46cb62 msgid "" "Causes a vertical shift effect: Each *Point(x, y)* will become *Point(x, " "y - f)*. Positive (negative) values of *f* will shift down (up)." msgstr "" "垂直シフト効果を引き起こします：各 *Point(x, y)* は *Point(x、y - f)* になります。*f* " "の正の（負の）値は下に（上に）シフトします。" #: ../../matrix.rst:168 fbbefd1680244e43b84002ed9a436dec msgid "" "Rectilinear means that no shearing is present and that any rotations are " "integer multiples of 90 degrees. Usually this is used to confirm that " "(axis-aligned) rectangles before the transformation are still axis-" "aligned rectangles afterwards." msgstr "矩形の意味は、シアリングが存在せず、回転が90度の整数倍であることを示します。通常、これは変換前の（軸に沿った）矩形が変換後も軸に沿った矩形であることを確認するために使用されます。" #: ../../matrix.rst:170 36d4d94103214600af41eafe39212e90 msgid "bool" msgstr "" #: ../../matrix.rst:174 90ffe958045f48d090dba5ba44f73165 msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "" "このクラスはPythonのシーケンスプロトコルに従っているため、コンポーネントにはインデックスを使用できます。また、:ref:`SequenceTypes`" " を参照してください。" #: ../../matrix.rst:175 ae28f509b9434158ad3509b43fcadd26 msgid "" "Matrices can be used with arithmetic operators almost like ordinary " "numbers: they can be added, subtracted, multiplied or divided -- see " "chapter :ref:`Algebra`." msgstr "" "行列は、通常の数値のようにほとんどの算術演算子を使用して操作できます。行列は加算、減算、乗算、または除算できます。ジオメトリオブジェクトの " ":ref:`Algebra`。" #: ../../matrix.rst:176 8bec4a086d304bbb9bfd022e4556dd29 msgid "" "Matrix multiplication is **not commutative** -- changing the sequence of " "the multiplicands will change the result in general. So it can quickly " "become unclear which result a transformation will yield." msgstr "" "行列の乗算は " "**可換ではありません**。乗算要因のシーケンスを変更すると、一般に結果が変わります。そのため、変換がどの結果を生じるかがすぐに不明確になることがあります。" #: ../../matrix.rst:180 281fd31e543c4617a40894e7ac37597e msgid "Examples" msgstr "例" #: ../../matrix.rst:181 401084daabc9429b9009d38c9e0f2aec msgid "" "Here are examples that illustrate some of the achievable effects. All " "pictures show some text, inserted under control of some matrix and " "relative to a fixed reference point (the red dot)." msgstr "以下は、いくつかの可能な効果を示す例です。すべての図は、固定された参照点（赤いドット）に対するある行列の制御下で挿入されたテキストを示しています。" #: ../../matrix.rst:183 ef95f7140bc84ceb80f3fe9cc5ffe0d2 msgid "The :ref:`Identity` matrix performs no operation." msgstr ":ref:`Identity` 行列は操作を行いません。" #: ../../matrix.rst:188 a80fc2a091374e8cb6815dfe8672bddd msgid "" "The scaling matrix `Matrix(2, 0.5)` stretches by a factor of 2 in " "horizontal, and shrinks by factor 0.5 in vertical direction." msgstr "スケーリング行列 `Matrix(2, 0.5)` は、水平方向に2倍の拡大を行い、垂直方向には0.5倍の縮小を行います。" #: ../../matrix.rst:193 9699134c66a146af9068adb90948b8f2 msgid "" "Attributes :attr:`Matrix.e` and :attr:`Matrix.f` shift horizontally and, " "respectively vertically. In the following 10 to the right and 20 down." msgstr "" "属性 :attr:`Matrix.e` および :attr:`Matrix.f` " "は、それぞれ水平方向および垂直方向にシフトします。以下の場合、右に10、下に20シフトします。" #: ../../matrix.rst:198 168fe9a931a94651ac55f633dffbe987 msgid "A negative :attr:`Matrix.a` causes a left-right flip." msgstr "負の :attr:`Matrix.a` は左右反転を引き起こします。" #: ../../matrix.rst:203 f2cb4722af2e45f6ac67fda814935ea4 msgid "A negative :attr:`Matrix.d` causes an up-down flip." msgstr "負の :attr:`Matrix.d` は上下反転を引き起こします。" #: ../../matrix.rst:208 28cc582a5ec24205816af0c892b692d1 msgid "Attribute :attr:`Matrix.b` tilts upwards / downwards along the x-axis." msgstr "属性 M :attr:`Matrix.b` はx軸に沿って上向き/下向きに傾きます。" #: ../../matrix.rst:213 a2b77644fc61456690d3603561dae948 msgid "Attribute :attr:`Matrix.c` tilts left / right along the y-axis." msgstr "属性 :attr:`Matrix.c` はy軸に沿って左に傾く/右に傾きます。" #: ../../matrix.rst:218 bd842bfbd48b44509584185764d44373 msgid "" "Matrix `Matrix(beta)` performs counterclockwise rotations for positive " "angles `beta`." msgstr "Matrix `Matrix(beta)` は、正の角度 `beta` の反時計回りの回転を実行します。" #: ../../matrix.rst:223 ac0b2cc97b1347ab9f63fa8f97f50072 msgid "Show some effects on a rectangle::" msgstr "" #: ../../footer.rst:46 2a49496b580540908297c502618954b2 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/module.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 62136ba5c5a74ecfa227336e448d62b5 msgid "Artifex" msgstr "" #: ../../header.rst:-1 6fc9c3c622e84783910d3b11c3709f37 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 d611277d72c64dd99b3b9f2f8ec96367 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../module.rst:7 f33c4cbb9f05422084dddcddaf87949a msgid "Command line interface" msgstr "" #: ../../module.rst:9 9f557fd4350a42ed9a1df58860be9669 msgid "New in version 1.16.8" msgstr "バージョン 1.16.8 で新たに追加されました" #: ../../module.rst:11 ecd7d23131464943807a4fb959173755 msgid "" "PyMuPDF can also be used from the command line to perform utility " "functions. This feature should obsolete writing some of the most basic " "scripts." msgstr "PyMuPDFは、ユーティリティ機能を実行するためにモジュールとしてコマンドラインで使用することもできます。この機能により、最も基本的なスクリプトの記述が廃止される可能性があります。" #: ../../module.rst:13 20b8d208b65e4c74bf7ad83bfb388393 msgid "" "Admittedly, there is some functional overlap with the MuPDF CLI `mutool`." " On the other hand, PDF embedded files are no longer supported by MuPDF, " "so PyMuPDF is offering something unique here." msgstr "" "確かに、MuPDF CLI `mutool` " "といくつかの機能的な重複があります。一方で、PDFの埋め込みファイルはもはやMuPDFではサポートされていないため、PyMuPDFはここで独自の機能を提供しています。" #: ../../module.rst:16 61944c3cbe72440580bdadeeb1269b75 msgid "Invocation" msgstr "呼び出し" #: ../../module.rst:18 295dfa35e12a40d48e27c0055204d5a7 msgid "The command-line interface can be invoked in two ways." msgstr "コマンドラインインターフェースは2つの方法で呼び出すことができます。" #: ../../module.rst:20 7177082a690146019882a6b232aa8853 msgid "Use the installed `pymupdf` command::" msgstr "インストールされた `pymupdf` のコマンドを使用します。" #: ../../module.rst:24 87e819afc653442caceed77952e1ed58 msgid "Or use Python's `-m` switch with PyMuPDF's `pymupdf` module::" msgstr "" #: ../../module.rst:31 c1e7f23de6ef452a83faa31ed988d657 msgid "General remarks:" msgstr "一般的な注意事項：" #: ../../module.rst:33 fd3bac8dc3e9421eb2371c451ec1c3da msgid "" "Request help via `\"-h\"`, resp. command-specific help via `\"command " "-h\"`." msgstr "ヘルプを要求するには、`\"-h\"` 、またはコマンド固有のヘルプを要求するには `\"command -h\"` を使用します。" #: ../../module.rst:34 dbd5a72f66d84df5b18b6bec2f4fd2f5 msgid "Parameters may be abbreviated where this does not introduce ambiguities." msgstr "曖昧さが生じない場所では、パラメータは省略形で指定できます。" #: ../../module.rst:35 73cd69c626714f7aa1e084d11447cea6 msgid "" "Several commands support parameters `-pages` and `-xrefs`. They are " "intended for down-selection. Please note that:" msgstr "" "いくつかのコマンドは、 `-pages` と `-xrefs` " "のパラメータをサポートしています。これらは選択範囲を絞るためのものです。以下に注意してください：" #: ../../module.rst:37 7ff6972a285a4695baa4e4276641b755 msgid "**page numbers** for this utility must be given **1-based**." msgstr "このユーティリティでは、**ページ番号** は1から始まる必要があります。" #: ../../module.rst:38 b9688dc1937342d0a9ba2a88937c6d0a msgid "valid :data:`xref` numbers start at 1." msgstr "有効な :data:`xref` 番号は1から始まります。" #: ../../module.rst:39 7c0c1890d37b41f6820770dd6bed4376 msgid "" "Specify a comma-separated list of either *single* integers or integer " "*ranges*. A **range** is a pair of integers separated by one hyphen " "\"-\". Integers must not exceed the maximum page, resp. xref number. To " "specify that maximum, the symbolic variable \"N\" may be used. Integers " "or ranges may occur several times, in any sequence and may overlap. If in" " a range the first number is greater than the second one, the respective " "items will be processed in reversed order." msgstr "" "シングル整数または整数の範囲のコンマ区切りのリストを指定します。範囲は、ハイフン \" - \" " "で区切られた整数のペアです。整数は、最大ページまたは xref 番号を超えてはいけません。最大値を指定するには、記号変数 \"N\" " "を使用できます。整数または範囲は複数回、任意の順序で重複して出現する可能性があります。範囲内の最初の数値が2番目の数値よりも大きい場合、それらのアイテムは逆順で処理されます。" #: ../../module.rst:41 ee46edb0ea2b44e98364d207aaa2d1ef msgid "How to use the module inside your script::" msgstr "スクリプト内でモジュールを使用する方法::" #: ../../module.rst:50 123a2e5ad2564826b878adadaf638eeb msgid "" "Use the following 2-liner and compile it with `Nuitka " "`_ in standalone mode. This will give " "you a CLI executable with all the module's features, that can be used on " "all compatible platforms without Python, PyMuPDF or MuPDF being " "installed." msgstr "" "以下の2行のコードを使用し、 `Nuitka `_ " "をスタンドアロンモードでコンパイルします。これにより、Python、PyMuPDF、またはMuPDFがインストールされていないすべての互換プラットフォームで使用できる、モジュールのすべての機能を備えたCLI実行可能ファイルが得られます。" #: ../../module.rst:59 621c5379e7d44e29a5ae735c58352834 msgid "Cleaning and Copying" msgstr "クリーニングとコピー" #: ../../module.rst:63 a41c329fb87940c482d0805086ecc3cf msgid "" "This command will optimize the PDF and store the result in a new file. " "You can use it also for encryption, decryption and creating sub " "documents. It is mostly similar to the MuPDF command line utility " "*\"mutool clean\"*::" msgstr "" "このコマンドは、PDFを最適化し、その結果を新しいファイルに保存します。また、暗号化、復号化、およびサブドキュメントの作成にも使用できます。これは、ほとんど" " MuPDF のコマンドラインユーティリティ \"mutool clean\" と似ています::" #: ../../module.rst:96 95c61ecff9474da7a32002be18ff00b3 msgid "" "If you specify \"-pages\", be aware that only page-related objects are " "copied, **no document-level items** like e.g. embedded files." msgstr "「-pages」を指定する場合、ページ関連のオブジェクトのみがコピーされることに注意してください。埋め込みファイルのようなドキュメントレベルのアイテムはコピーされません。" #: ../../module.rst:98 958ae9bd4e2244ae9cbb5d24a62a8c94 msgid "Please consult :meth:`Document.save` for the parameter meanings." msgstr "パラメータの意味については、 :meth:`Document.save` をご参照ください。" #: ../../module.rst:102 5b59f04532e94259bf5b3ecd530ca408 msgid "Extracting Fonts and Images" msgstr "フォントと画像の抽出" #: ../../module.rst:103 170896a4fb624362bfbd8172cf909da4 msgid "Extract fonts or images from selected PDF pages to a desired directory::" msgstr "選択したPDFページからフォントや画像を指定したディレクトリに抽出します::" #: ../../module.rst:123 220fe33385e844f3928ec0625f051414 msgid "" "**Image filenames** are built according to the naming scheme: **\"img-" "xref.ext\"**, where \"ext\" is the extension associated with the image " "and \"xref\" the :data:`xref` of the image PDF object." msgstr "" "**画像のファイル名** は、命名規則に従って構築されます： **\"img-xref.ext\"** で、\"ext\" " "は画像に関連する拡張子であり、\"xref\" は画像PDFオブジェクトの :data:`xref` です。" #: ../../module.rst:125 d56994d8f2a8433280e4ef35819f2e7a msgid "" "**Font filenames** consist of the fontname and the associated extension. " "Any spaces in the fontname are replaced with hyphens \"-\"." msgstr "" "**フォントのファイル名** は、フォント名と関連する拡張子から構成されます。フォント名にスペースがある場合、ハイフン \"-\" " "で置き換えられます。" #: ../../module.rst:127 a8e1a30f5fde401d810825a6e3b01a09 msgid "The output directory must already exist." msgstr "出力ディレクトリはすでに存在している必要があります。" #: ../../module.rst:129 f2bc1eaf74014a2c9c0473449a9e7b11 msgid "" "Except for output directory creation, this feature is **functionally " "equivalent** to and obsoletes `this script `_." msgstr "" "出力ディレクトリの作成を除いて、この機能は `このスクリプト `_ " "と機能的に同等であり、これを使うことで廃止できます。" #: ../../module.rst:133 b52a0c02382d4e9abbd491e7b26f50d8 msgid "Joining PDF Documents" msgstr "PDF文書の結合" #: ../../module.rst:134 b52dba2292bb478f86d8bd2a68e72d49 msgid "To join several PDF files specify::" msgstr "複数のPDFファイルを結合するには、次のように指定します::" #: ../../module.rst:153 e75a700cceee42eda662850bcb411254 msgid "" "Each input must be entered as **\"filename,password,pages\"**. Password " "and pages are optional." msgstr "各入力は「ファイル名、パスワード、ページ」の形式で入力してください。パスワードとページはオプションです。" #: ../../module.rst:154 5bbc4bbfbbe44ea29ce63dc28468ecde msgid "" "The password entry **is required** if the \"pages\" entry is used. If the" " PDF needs no password, specify two commas." msgstr "パスワードエントリは「ページ」エントリが使用される場合に必要です。PDFにパスワードが必要ない場合は、2つのコンマを指定してください。" #: ../../module.rst:155 24124b66f3f9496c9cba03a6c3987619 msgid "" "The **\"pages\"** format is the same as explained at the top of this " "section." msgstr "「ページ」のフォーマットは、このセクションの先頭で説明したものと同じです。" #: ../../module.rst:156 6c8cd3be3fd844a18d6859e34270344c msgid "" "Each input file is immediately closed after use. Therefore you can use " "one of them as output filename, and thus overwrite it." msgstr "各入力ファイルは使用後すぐに閉じられます。したがって、出力ファイル名の1つとして使用し、上書きすることができます。" #: ../../module.rst:159 62faf24e6a7143aca5c2f6d4d0a3bd13 msgid "Example: To join the following files" msgstr "例: 以下のファイルを結合する" #: ../../module.rst:161 088838df3b2545f8801c172c3bc996f0 msgid "**file1.pdf:** all pages, back to front, no password" msgstr "**file1.pdf:** すべてのページ、最前面から最後尾、パスワードなし" #: ../../module.rst:162 72f4cc0b55a64f16a43ce016fb9d46a0 msgid "**file2.pdf:** last page, first page, password: \"secret\"" msgstr "**file2.pdf:** 最後のページ、最前面、パスワード: \"secret\"" #: ../../module.rst:163 518dcf41451c4ab098ae80c98c705da7 msgid "**file3.pdf:** pages 5 to last, no password" msgstr "**file3.pdf:** 5ページから最後尾、パスワードなし" #: ../../module.rst:165 579e18430ffe47deaf32eb9b5bb856c7 msgid "and store the result as **output.pdf** enter this command:" msgstr "そして結果を **output.pdf** として保存するには、次のコマンドを入力してください:" #: ../../module.rst:167 945d0c96b4b34fc782a86ae2fcf40aa5 msgid "" "``pymupdf join -o output.pdf file1.pdf,,N-1 file2.pdf,secret,N,1 " "file3.pdf,,5-N``" msgstr "" #: ../../module.rst:171 45664921245f42c09b294edb251048f5 msgid "Low Level Information" msgstr "低レベル情報" #: ../../module.rst:173 fdf3d7f12d914afe950de66d094693fa msgid "" "Display PDF internal information. Again, there are similarities to " "*\"mutool show\"*::" msgstr "PDFの内部情報を表示します。再度、 *「mutool show」* との類似点があります。" #: ../../module.rst:194 ad5c07b578e24a87b4bdfa72f035288d msgid "Examples::" msgstr "例::" #: ../../module.rst:243 a932285ed88f489cb35fb9fd00084410 msgid "Embedded Files Commands" msgstr "埋め込みファイルコマンド" #: ../../module.rst:245 22fe7451356d4b07a68f7b814a48f7db msgid "" "The following commands deal with embedded files -- which is a feature " "completely removed from MuPDF after v1.14, and hence from all its command" " line tools." msgstr "" "以下のコマンドは埋め込みファイルに関するもので、MuPDF " "v1.14以降から完全に削除され、そのためすべてのコマンドラインツールからも削除されています。" #: ../../module.rst:248 031889fce5ba40c8aa00dca7f543935f msgid "Information" msgstr "情報" #: ../../module.rst:250 923441e6e99c4679913ea9650bd321f3 msgid "Show the embedded file names (long or short format)::" msgstr "埋め込みファイルの名前を表示します（長いフォーマットまたは短いフォーマット）::" #: ../../module.rst:266 2938ace8fd974862bd2b852f6d01c1b5 msgid "Example::" msgstr "例::" #: ../../module.rst:287 4b906057dfa84c65ba2f7b3875e76f45 msgid "Detailed output would look like this per entry::" msgstr "詳細な出力は、各エントリごとに以下のようになります::" #: ../../module.rst:297 fa6b969dc09f4e7aa8ddad1a74b85f27 msgid "Extraction" msgstr "抽出" #: ../../module.rst:299 b95b620ad9f548139f65380c81a609eb msgid "Extract an embedded file like this::" msgstr "埋め込みファイルを以下のように抽出します::" #: ../../module.rst:317 b425246653d244139ee6064fef0cce03 msgid "" "For details consult :meth:`Document.embfile_get`. Example (refer to " "previous section)::" msgstr "詳細については、Document.embfile_get() を参照してください。例（前のセクションを参照）::" #: ../../module.rst:323 beb7e7b57a2d40d7b80215a90a015016 msgid "Deletion" msgstr "削除" #: ../../module.rst:324 a66d4e86731745edabc9c4f4e5e0bb9f msgid "Delete an embedded file like this::" msgstr "以下のようにして埋め込みファイルを削除します::" #: ../../module.rst:340 c7c9134eddaa4ad2b9672122f1aa8fe9 msgid "For details consult :meth:`Document.embfile_del`." msgstr "詳細については、 :meth:`Document.embfile_del` を参照してください。" #: ../../module.rst:343 8027d6ea455e4050ace1ead2c3a951fb msgid "Insertion" msgstr "挿入" #: ../../module.rst:344 05c0ffa1d1fd4495a04887a13fa6a0ff msgid "Add a new embedded file using this command::" msgstr "このコマンドを使用して新しい埋め込みファイルを追加します::" #: ../../module.rst:364 a3ce7e14c5a6493190e34f36253a7b11 msgid "" "*\"NAME\"* **must not** already exist in the PDF. For details consult " ":meth:`Document.embfile_add`." msgstr "" "*\"NAME\"* は既にPDF内に存在していてはいけません。詳細については、 :meth:`Document.embfile_add` " "を参照してください。" #: ../../module.rst:367 8b7188f7140248f2ace12ff2559a5810 msgid "Updates" msgstr "更新" #: ../../module.rst:368 bf7de82ffcc6488492d7f1ed813a78d7 msgid "Update an existing embedded file using this command::" msgstr "このコマンドを使用して既存の埋め込みファイルを更新します::" #: ../../module.rst:393 dfb87b27e010457ea91a44ac1607508d msgid "" "Use this method to change meta-information of the file -- just omit the " "*\"PATH\"*. For details consult :meth:`Document.embfile_upd`." msgstr "" "ファイルのメタ情報を変更するために、この方法を使用します - 単に「PATH」を省略してください。詳細については、 " ":meth:`Document.embfile_upd` を参照してください。" #: ../../module.rst:397 9724107b71a3473586bf932f86556d37 msgid "Copying" msgstr "コピー" #: ../../module.rst:398 320c9dfca9614ce1aad38deec15e2f14 msgid "Copy embedded files between PDFs::" msgstr "PDF間で埋め込みファイルをコピーします::" #: ../../module.rst:422 4f474c3c92134dbf92a95d04287f6b7c msgid "Text Extraction" msgstr "テキスト抽出 " #: ../../module.rst:423 10013955206643cdabf54b9427cf9162 msgid "New in v1.18.16" msgstr "v1.18.16で新登場" #: ../../module.rst:425 6175e1799fe14be7857049aacbf4f76e msgid "" "Extract text from arbitrary :ref:`supported " "documents` to a textfile. Currently, there are " "three output formatting modes available: simple, block sorting and " "reproduction of physical layout." msgstr "" "任意の :ref:`サポートされたドキュメント ` " "からテキストをテキストファイルに抽出します。現在、3つの出力フォーマットモードが利用可能です：シンプル、ブロックソート、物理的なレイアウトの再現。" #: ../../module.rst:427 104746a6d24348c085e4d1f05530f3c4 msgid "" "**Simple** text extraction reproduces all text as it appears in the " "document pages -- no effort is made to rearrange in any particular " "reading order." msgstr "" "**シンプル** なテキスト抽出は、ドキュメントページに表示される通りのすべてのテキストを再現します - " "特定の読み取り順序に再配置する努力は行われません。" #: ../../module.rst:428 46976f7ba91e4ed195d1d2970b450ce8 msgid "" "**Block sorting** sorts text blocks (as identified by MuPDF) by ascending" " vertical, then horizontal coordinates. This should be sufficient to " "establish a \"natural\" reading order for basic pages of text." msgstr "" "**ブロックソート** " "は、テキストブロック（MuPDFによって識別される）を垂直座標、水平座標の昇順に並べ替えます。これは、基本的なテキストページの「自然な」読み取り順序を確立するために十分です。" #: ../../module.rst:429 736d584551084ce0ae8db3ab132de413 msgid "" "**Layout** strives to reproduce the original appearance of the input " "pages. You can expect results like this (produced by the command `pymupdf" " gettext -pages 1 demo1.pdf`):" msgstr "" "**レイアウト** は、入力ページの元の外観を再現しようとします。次のような結果が期待できます（コマンド `pymupdf gettext " "-pages 1 demo1.pdf` によって生成されたもの）：" #: ../../module.rst:434 50eb59c01b5243e4a1beb240596e9fcf msgid "" "The \"gettext\" command offers a functionality similar to the CLI tool " "`pdftotext` by XPDF software, http://www.foolabs.com/xpdf/ -- this is " "especially true for \"layout\" mode, which combines that tool's `-layout`" " and `-table` options." msgstr "" "「gettext」コマンドは、XPDFソフトウェアのCLIツール `pdftotext` " "と似た機能を提供します。http://www.foolabs.com/xpdf/ - " "これは特に「レイアウト」モードに当てはまり、このモードはそのツールの `-layout` と `-table` オプションを組み合わせています。" #: ../../module.rst:438 49563f540be445d984dba68ffffbfe02 msgid "" "After each page of the output file, a formfeed character, `hex(12)` is " "written -- even if the input page has no text at all. This behavior can " "be controlled via options." msgstr "" "出力ファイルの各ページの後に、フォームフィード文字 `hex(12)` が書き込まれます - " "入力ページにテキストがない場合でもです。この動作はオプションを介して制御できます。" #: ../../module.rst:440 647dbf1080904cb5b86c438feafcb584 msgid "" "For \"layout\" mode, **only horizontal, left-to-right, top-to bottom** " "text is supported, other text is ignored. In this mode, text is also " "ignored, if its :data:`fontsize` is too small." msgstr "" "「レイアウト」モードでは、水平方向、左から右、上から下のテキストのみがサポートされ、他のテキストは無視されます。また、このモードでは、:data:`fontsize`" " が小さすぎる場合もテキストが無視されます。" #: ../../module.rst:442 baeab1e7bac9497995324b659ebebf03 msgid "" "\"Simple\" and \"blocks\" mode in contrast output **all text** for any " "text size or orientation." msgstr "対照的に、「シンプル」モードと「ブロック」モードでは、テキストのサイズや向きに関係なくすべてのテキストが出力されます。" #: ../../module.rst:444 8617ac5a55024a57b4b1d70bdb264ced msgid "Command::" msgstr "コマンド::" #: ../../module.rst:472 f1019c52949f4174acd4b9381a394601 msgid "" "Command options may be abbreviated as long as no ambiguities are " "introduced. So the following do the same:" msgstr "コマンドのオプションは、曖昧さが生じない限り、省略形を使用することができます。したがって、以下のように同じ結果を得ることができます：" #: ../../module.rst:474 d70e9f44b99141809981474f2ff8b052 msgid "" "`... -output text.txt -noligatures -noformfeed -convert-white -grid 3 " "-extra-spaces ...`" msgstr "" #: ../../module.rst:475 07cb51f3b38747abbb4010f810490249 msgid "`... -o text.txt -nol -nof -c -g 3 -e ...`" msgstr "" #: ../../module.rst:477 f16b9ac2c6c14bd5bb7fcea64f1fcd80 msgid "" "The output filename defaults to the input with its extension replaced by " "`.txt`. As with other commands, you can select page ranges **(caution: " "1-based!)** in `mutool` format, as indicated above." msgstr "" "出力ファイル名は、入力ファイル名の拡張子が `.txt` に置換されたものがデフォルトです。他のコマンドと同様に、上記に示されているように、 " "`mutool` 形式でページ範囲（注意：1から始まる）を選択できます。" #: ../../module.rst:479 f23822348e0f44868acd1a434c638317 msgid "**mode:** (str) select a formatting mode -- default is \"layout\"." msgstr "**mode:** (str) フォーマットモードを選択します - デフォルトは「レイアウト」です。" #: ../../module.rst:480 34f6f03b6b7c4d14b5b53d480ad19652 msgid "" "**noligatures:** (bool) corresponds to **not** " ":data:`TEXT_PRESERVE_LIGATURES`. If specified, ligatures (present in " "advanced fonts: glyphs combining multiple characters like \"fi\") are " "split up into their components (i.e. \"f\", \"i\"). Default is passing " "them through." msgstr "" "**noligatures:** (bool) :data:`TEXT_PRESERVE_LIGATURES` " "に相当します。指定された場合、リガチャ（複数の文字を結合するグリフ、例:「fi」のようなもの）はその構成要素（つまり「f」、「i」）に分割されます。デフォルトはそのまま通過させることです。" #: ../../module.rst:481 7ad52df691114a03bf07a72f2434d4a9 msgid "" "**convert-white:** corresponds to **not** " ":data:`TEXT_PRESERVE_WHITESPACE`. If specified, all white space " "characters (like tabs) are replaced with one or more spaces. Default is " "passing them through." msgstr "" "**convert-white:** :data:`TEXT_PRESERVE_WHITESPACE` " "に相当します。指定された場合、すべての空白文字（タブなど）は1つ以上のスペースに置き換えられます。デフォルトはそのまま通過させることです。" #: ../../module.rst:482 b925a23489d24b3396cf53888050c32d msgid "" "**extra-spaces:** (bool) corresponds to **not** " ":data:`TEXT_INHIBIT_SPACES`. If specified, large gaps between adjacent " "characters will be filled with one or more spaces. Default is off." msgstr "" "**extra-spaces:** (bool) :data:`TEXT_INHIBIT_SPACES` " "に相当します。指定された場合、隣接する文字間の大きな間隔は1つ以上のスペースで埋められます。デフォルトはオフです。" #: ../../module.rst:483 9d95e72389b3445ba510fb682107c642 #, fuzzy msgid "" "**noformfeed:** (bool) instead of `hex(12)` (formfeed), write linebreaks" " ``\\n`` at end of output pages." msgstr "" "**noformfeed:** (bool) `hex(12)` （フォームフィード）の代わりに、出力ページの末尾に ``\\n`` " "個の改行を書き込みます。" #: ../../module.rst:484 703f5774d5234679a03f67da753bc40a msgid "**skip-empty:** (bool) skip pages with no text." msgstr "**skip-empty:** ((bool) テキストがないページをスキップします。" #: ../../module.rst:485 8f19a7610cc64fc88819c1b7fc295330 msgid "" "**grid:** lines with a vertical coordinate difference of no more than " "this value (in points) will be merged into the same output line. Only " "relevant for \"layout\" mode. **Use with care:** 3 or the default 2 " "should be adequate in most cases. If **too large**, lines that are " "*intended* to be different in the original may be merged and will result " "in garbled and / or incomplete output. If **too low**, artifact separate " "output lines may be generated for some spans in the input line, just " "because they are coded in a different font with slightly deviating " "properties." msgstr "" "**grid:** 垂直座標の差がこの値（ポイント単位）を超えない行は、同じ出力行に結合されます。 " "「レイアウト」モードにのみ関連します。注意して使用してください: " "ほとんどの場合、3またはデフォルトの2が適切です。大きすぎると、元のフォントで異なる行が結合され、文字化けや不完全な出力が発生する可能性があります。低すぎると、入力行の一部の範囲で個別の出力行が生成されることがありますが、これはわずかに異なる特性を持つ別のフォントでコーディングされているためです。" #: ../../module.rst:486 eac14db14ad14562a3b3b10a76827016 msgid "" "**fontsize:** include text with :data:`fontsize` larger than this value " "only (default 3). Only relevant for \"layout\" option." msgstr "" "**fontsize:** この値よりも大きな :data:`fontsize` を持つテキストのみを含めます（デフォルト3）。 " "「レイアウト」オプションにのみ関連します。" #: ../../footer.rst:46 bf24bcacdf454aba8a6c79d83a00209b msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Module *fitz*" #~ msgstr "モジュール *fitz*" #~ msgid "Invoke the module like this::" #~ msgstr "次のようにしてモジュールを呼び出します::" #~ msgid "" #~ "*python -m fitz join -o output.pdf " #~ "file1.pdf,,N-1 file2.pdf,secret,N,1 file3.pdf,,5-N*" #~ msgstr "" #~ msgid "Or use Python's `-m` switch with PyMuPDF's `fitz` module::" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "*pymupdf join -o output.pdf file1.pdf,,N-1 " #~ "file2.pdf,secret,N,1 file3.pdf,,5-N*" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/outline.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 bbc8f87339104f1898b46c688e53d1bf msgid "Artifex" msgstr "" #: ../../header.rst:-1 c349cfed692041d1831e68981b1432f3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 ccc1347133a5468990182905e2e49042 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../outline.rst:7 ac9aff233a8946e286c95d2a2f9a8e13 msgid "Outline" msgstr "Outline (アウトライン)" #: ../../outline.rst:9 7a3be59ed3114a5c8bffd3f17bbb2211 #, fuzzy msgid "" "The document outline (otherwise known as \"bookmarks\") is a property of " ":ref:`Document` (see :attr:`Document.outline`). If not ``None``, it " "stands for the first outline item of the document. Its properties in turn" " define the characteristics of this item and also point to other outline " "items in \"horizontal\" or downward direction. The full tree of all " "outline items for e.g. a conventional table of contents (TOC) can be " "recovered by following these \"pointers\"." msgstr "" "*アウトライン*（または「ブックマーク」）は、*Document* のプロパティです。それが ``None`` " "でない場合、それはドキュメントの最初のアウトライン項目を表します。そのプロパティは、この項目の特性を定義し、また「水平」または下向きの方向に他のアウトライン項目を指します。たとえば、通常の目次（TOC）のためのすべてのアウトライン項目の完全なツリーは、これらの「ポインター」をたどることで回復できます。" #: ../../outline.rst:12 b45a2c09637c4f3e9d2b01f1ba92a39f msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../outline.rst:12 47ad240edf4f474fa4acbc5fda0372cb msgid "**Short Description**" msgstr "**短い説明**" #: ../../outline.rst:14 be403d58c4de4b12a011b9ed0d0e543f msgid ":attr:`Outline.down`" msgstr "" #: ../../outline.rst:14 247939926687419fbfef8ca1aca02f0d msgid "next item downwards" msgstr "次の項目は下向き" #: ../../outline.rst:15 96c69672ce3043259545e0e655eb91db msgid ":attr:`Outline.next`" msgstr "" #: ../../outline.rst:15 4a5f23f96cf749c7872473b681590785 msgid "next item same level" msgstr "同じレベルの次の項目" #: ../../outline.rst:16 c573402a06284cd492bec3c1d27d1e3d msgid ":attr:`Outline.page`" msgstr "" #: ../../outline.rst:16 506be6a2e42d4302bdbc7b4e28e2394d msgid "page number (0-based)" msgstr "ページ番号（0から始まる）" #: ../../outline.rst:17 f119da14666b4fd3b371cf4ffc3e472a msgid ":attr:`Outline.title`" msgstr "" #: ../../outline.rst:17 76ae4b21a6a6447da64b2d5e96423ea6 msgid "title" msgstr "タイトル" #: ../../outline.rst:18 a5fad59c22974e90b9ea8aad24218452 msgid ":attr:`Outline.uri`" msgstr "" #: ../../outline.rst:18 841c94119419481b8d836018ece01af9 msgid "string further specifying outline target" msgstr "アウトラインのターゲットをさらに指定する文字列" #: ../../outline.rst:19 8cfeb148873e49c09a78d54e1a2f77c6 msgid ":attr:`Outline.is_external`" msgstr "" #: ../../outline.rst:19 8a8f02b1287645c8905eec8793a1b5b6 msgid "target outside document" msgstr "ドキュメントの外部のターゲットかどうか" #: ../../outline.rst:20 5de9d126a21d480a9e1ca3476bebb4d3 msgid ":attr:`Outline.is_open`" msgstr "" #: ../../outline.rst:20 7fc18da2ba4d4cbe9f3b2a82d39f02da msgid "whether sub-outlines are open or collapsed" msgstr "サブアウトラインが開いているか折りたたまれているか" #: ../../outline.rst:21 6aa64d2eff674fa2890310aecbb14167 msgid ":attr:`Outline.dest`" msgstr "" #: ../../outline.rst:21 0a87f99431e642139f4b43d536359abe msgid "points to destination details object" msgstr "宛先の詳細オブジェクトを指す" #: ../../outline.rst:24 5ed102082bf84d049ca1f0ce22437f31 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../outline.rst:30 7b0ddca9a47d4e648ebdab93710cb150 msgid "" "The next outline item on the next level down. Is ``None`` if the item has" " no children." msgstr "次の階層のアウトライン項目です。アイテムに子要素がない場合は ``None`` です。" #: ../../outline.rst 057e37ce84814a1c8c344aab938047f2 #: 1e93414e062d488e892d2f22750666de 76ab3bd1d70641f185a95f718ad0bb69 #: 7bd6079115d0441a82b8de2daaa1f4f9 9ecaaca5f8fd42c5b695d3f7ac9a5477 #: bc6ef4078c8a4c91a859ae4437517df7 e5dc2bd2705743d59033178491288a7a #: ea89654da5734c92aa2797336d8dfbc6 msgid "type" msgstr "" #: ../../outline.rst:32 8b64d66496a54db0908a0f6af0d7969e msgid ":ref:`Outline`" msgstr "" #: ../../outline.rst:36 b8f40bec44ec498a866b8b610465788d msgid "" "The next outline item at the same level as this item. Is ``None`` if this" " is the last one in its level." msgstr "このアイテムと同じレベルの次のアウトライン項目です。このアイテムがそのレベルで最後の場合、``None`` です。" #: ../../outline.rst:38 78788e777e334a73bb007bf2b10702b8 msgid "`Outline`" msgstr "" #: ../../outline.rst:42 e0f2f185ffc545688e36397b2ab22051 msgid "The page number (0-based) this bookmark points to." msgstr "このブックマークが指すページ番号（0から始まる）です。" #: ../../outline.rst:44 f47207285d9f4747a109ad0f93928b78 msgid "int" msgstr "" #: ../../outline.rst:48 53ed66d010ce46c8a8afa6580844ac5d msgid "The item's title as a string or ``None``." msgstr "アイテムのタイトル、または ``None`` の文字列です。" #: ../../outline.rst:50 ../../outline.rst:83 f43c0734193d4aedae69249948755e99 #: fc9bbc88a2e842c090ac4d2ea7adf221 msgid "str" msgstr "" #: ../../outline.rst:54 d0a15fed61c5446e815f91424b141eab msgid "" "Indicator showing whether any sub-outlines should be expanded (``True``) " "or be collapsed (``False``). This information is interpreted by PDF " "reader software." msgstr "サブアウトラインが展開されるべきか（``True``）折りたたまれるべきか（``False``）を示すインジケーターです。この情報はPDFリーダーソフトウェアによって解釈されます。" #: ../../outline.rst:56 ../../outline.rst:62 1e2367a870064e0ab9fefe235f8f9199 #: 309c517aaa49400181d997b03fb6d487 msgid "bool" msgstr "" #: ../../outline.rst:60 eabf7026067444bd881e44370ac424e5 msgid "" "A bool specifying whether the target is outside (``True``) of the current" " document." msgstr "対象が現在のドキュメントの外部（``True``）かどうかを示すブール値です。" #: ../../outline.rst:66 6e1ed475f293437aa748d4d40f55bbc0 msgid "" "A string specifying the link target. The meaning of this property should " "be evaluated in conjunction with property `is_external`:" msgstr "リンクの対象を指定する文字列。このプロパティの意味は、プロパティ `is_external` と一緒に評価されるべきです。" #: ../../outline.rst:70 048200e34ebe4f88b8f6ecdfad9e9724 #, fuzzy msgid "" "`is_external` is true: ``uri`` points to some target outside the current " "PDF, which may be an internet resource (``uri`` starts with ``http://`` " "or similar), another file (``uri`` starts with ``file:`` or ``file://``) " "or some other service like an e-mail address (``uri`` starts with " "``mailto:``)." msgstr "" "`is_external` がtrueの場合： `uri` は、現在のPDFの外部のターゲットを指します。これは、インターネットリソース（ " "`uri` が \"http://\" などで始まる）、別のファイル（`uri` が \"file:\" または \"file://\" " "で始まる）、または電子メールアドレスなどのその他のサービス（ `uri` が \"mailto:\" で始まる）である可能性があります。" #: ../../outline.rst:76 e2b37e452977480aadfbf5e2b8eb7ced #, fuzzy msgid "" "`is_external` is false: ``uri`` will be `None` or point to an internal " "location. In case of PDF documents, this should either be *#nnnn* to " "indicate a 1-based (!) page number *nnnn*, or a named location. The " "format varies for other document types, for example " "\"../FixedDoc.fdoc#PG_2_LNK_1\" for page number 2 (1-based) in an XPS " "document." msgstr "" "`is_external` がfalseの場合：`uri` は `None` " "になるか、または内部の位置を指します。PDFドキュメントの場合、これは1から始まるページ番号 *nnnn* を示すために *#nnnn* " "であるか、名前付きの場所を示します。他のドキュメントタイプの場合、形式は異なります。たとえば、XPSドキュメントのページ番号2（1から始まる）の場合は" " \"../FixedDoc.fdoc#PG_2_LNK_1\" です。" #: ../../outline.rst:87 0774302e2b4a4cc5be36f90e97235665 msgid "The link destination details object." msgstr "リンクの宛先詳細オブジェクトです。" #: ../../outline.rst:89 2c95888d87c844888823cf7c4bfbdd8d msgid ":ref:`linkDest`" msgstr "" #: ../../footer.rst:46 3da3281d20a349b2afbe0ca6afa704a3 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "A string specifying the link target. " #~ "The meaning of this property should " #~ "be evaluated in conjunction with " #~ "*isExternal*. The value may be ``None``," #~ " in which case *isExternal == False*." #~ " If *uri* starts with *file://*, " #~ "*mailto:*, or an internet resource name," #~ " *isExternal* is ``True``. In all " #~ "other cases *isExternal == False* and" #~ " *uri* points to an internal " #~ "location. In case of PDF documents, " #~ "this should either be *#nnnn* to " #~ "indicate a 1-based (!) page number " #~ "*nnnn*, or a named location. The " #~ "format varies for other document types," #~ " e.g. *uri = '../FixedDoc.fdoc#PG_21_LNK_84'* " #~ "for page number 21 (1-based) in an" #~ " XPS document." #~ msgstr "" #~ "リンクのターゲットを指定する文字列です。このプロパティの意味は *isExternal* " #~ "と連動して評価されるべきです。値が ``None`` の場合、*isExternal == " #~ "False* です。*uri* が *file://、mailto:* " #~ "、またはインターネットリソース名で始まる場合、*isExternal* は ``True`` " #~ "です。それ以外の場合、*isExternal == False* で、*uri* " #~ "は内部の場所を指します。PDFドキュメントの場合、これは1から始まるページ番号 *nnnn* を示すための " #~ "*#nnnn* " #~ "であるか、名前付きの場所である必要があります。他のドキュメントタイプの場合、例えばXPSドキュメントの場合、*uri = " #~ "'../FixedDoc.fdoc#PG_21_LNK_84'* は、ページ番号21（1から始まる）を示します。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/packaging.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-09-11 21:42+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ea339b8cf2d7425a8df74a11b8967508 msgid "Artifex" msgstr "" #: ../../header.rst:-1 5cca523385734e86a2f0b714b8baa7d8 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF（およびその他の）ドキュメントのデータ抽出、解析、変換、および操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 d2a6dea50de74aee87d8c5a1392014ac msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF テキスト抽出、PDF 画像抽出、PDF 変換、PDF テーブル、PDF 分割、PDF 作成、Pyodide、PyScript" #: ../../packaging.rst:5 92d36a7e439d47098564112377f93fb8 msgid "Packaging for Linux distributions" msgstr "Linux ディストリビューション向けのパッケージング" #: ../../packaging.rst:9 db33f856c6964c8f82f944305803a5c3 msgid "Requirements" msgstr "要件" #: ../../packaging.rst:11 dd51b73f026546128b58ca1dbc07d09b msgid "Python" msgstr "" #: ../../packaging.rst:12 619f89f2b9d94ee08bc949768cf1c902 msgid "MuPDF checkout (including submodules)." msgstr "MuPDF チェックアウト（サブモジュールを含む）。" #: ../../packaging.rst:13 3e8513b568314fd08934c01a489b24ff msgid "PyMuPDF checkout." msgstr "PyMuPDF チェックアウト。" #: ../../packaging.rst:14 c0fcde2fbd534fafb5383c841b93e6a0 msgid "System packages listed in `scripts/sysinstall.py:g_sys_packages`." msgstr "`scripts/sysinstall.py:g_sys_packages` にリストされたシステムパッケージ。" #: ../../packaging.rst:15 5628693598754932bd53d13010047308 msgid "Python packages listed in `pyproject.toml`." msgstr "`pyproject.toml` にリストされた Python パッケージ。" #: ../../packaging.rst:17 cb7a28284f2e4f08827c755968f0877e msgid "Extra requirements for running tests:" msgstr "テストの実行に必要な追加要件：" #: ../../packaging.rst:19 7e9780bb68154a86a58fcfad997a5bee msgid "Python packages listed in `scripts/gh_release.py:test_packages`." msgstr "`scripts/gh_release.py:test_packages` にリストされた Python パッケージ。" #: ../../packaging.rst:23 b4c0cecc40d24541aa536d3e453b991a msgid "General steps" msgstr "一般的な手順" #: ../../packaging.rst:25 968e7bb7a90f41a8869285b39c5ffb7b msgid "Build and install MuPDF:" msgstr "MuPDF をビルドしてインストールする：" #: ../../packaging.rst:27 f87b44cacfff43ab983716288eb0f4a4 msgid "Install required system packages." msgstr "必要なシステムパッケージをインストールします。" #: ../../packaging.rst:28 d9ac56053379472a852112940eadff9f msgid "" "Run `make install-shared-python` on MuPDF's `Makefile` with at least " "these make variables:" msgstr "" "MuPDF の `Makefile` で `make install-shared-python` を実行し、少なくともこれらの make " "変数を設定します：" #: ../../packaging.rst:31 f91b3554819741e18f724952afefff0d msgid "`DESTDIR` set to the install directory, e.g. `/`." msgstr "`DESTDIR` をインストールディレクトリに設定します。例: `/`。" #: ../../packaging.rst:33 a1bb9179a5924291a4d95d69779a7638 msgid "" "`prefix` set to location relative to DESTDIR, such as `/usr/local` or " "`/usr`. Must start with `/`." msgstr "" "`prefix` を DESTDIR に相対的な場所に設定します。たとえば `/usr/local` または /usr など、必ず / " "で始める必要があります。" #: ../../packaging.rst:35 ff45c57dc53a474aa442f256588c55cc msgid "`USE_SYSTEM_LIBS=yes`." msgstr "" #: ../../packaging.rst:36 6403f4dd52254fbfa53af0e1352ceeaa msgid "`HAVE_LEPTONICA=yes`." msgstr "" #: ../../packaging.rst:37 482b9da209504d059ff223aedd76019b msgid "`HAVE_TESSERACT=yes`." msgstr "" #: ../../packaging.rst:39 51e3ef8e388c4e2eb2a6f493f0f9c614 msgid "Build and install PyMuPDF:" msgstr "`pip install ./PyMuPDF`" #: ../../packaging.rst:42 499f0afa88564953ac9c266474d2aa0d msgid "" "Run `pip install ./PyMuPDF` or `pip wheel ./PyMuPDF` with at least these " "environment variables:" msgstr "" "`pip install ./PyMuPDF` または `pip wheel ./PyMuPDF` " "を実行します。少なくとも以下の環境変数を設定してください：" #: ../../packaging.rst:46 6d1d80bf3e7648e6be69dc15eac81a10 msgid "" "`PYMUPDF_SETUP_MUPDF_BUILD=` (empty string) to prevent download and build" " of hard-coded MuPDF release." msgstr "" "`PYMUPDF_SETUP_MUPDF_BUILD=` （空の文字列）：ハードコードされた MuPDF " "リリースのダウンロードとビルドを防ぐために設定します。" #: ../../packaging.rst:49 f0669625912e43c2b839e632328453b7 msgid "" "`CFLAGS`, `CXXFLAGS` and `LDFLAGS` set to allow visibility of the " "installed MuPDF headers and shared libraries." msgstr "" "`CFLAGS`、`CXXFLAGS`、および `LDFLAGS` を設定して、インストールされた MuPDF " "のヘッダーと共有ライブラリが見えるようにします。" #: ../../packaging.rst:52 fa04c3bb56c941df8b521704c781e646 msgid "Run PyMuPDF tests:" msgstr "PyMuPDF テストを実行する：" #: ../../packaging.rst:54 ab5423a83a72485ba9d3f2a257dfc8d6 msgid "Ensure required Python packages are available." msgstr "必要な Python パッケージが利用可能であることを確認します" #: ../../packaging.rst:56 9549372318d448939b9315704df3c716 msgid "Run `pytest -k \"not test_color_count and not test_3050\" PyMuPDF`" msgstr "`pytest -k \"not test_color_count and not test_3050\" PyMuPDF` を実行します。" #: ../../packaging.rst:58 d6c894edd7704171b3995de2b1102647 msgid "" "Test `test_color_count` is known fail if MuPDF is not built with " "PyMuPDF's custom config.h." msgstr "" "`test_color_count` テストは、MuPDF が PyMuPDF のカスタム config.h " "でビルドされていない場合に失敗することが既知です。" #: ../../packaging.rst:59 5a4624ddb10d46b9a944a59b2579188b msgid "" "Test `test_3050` is known to fail if MuPDF is built without its own " "third-party libraries." msgstr "`test_3050` テストは、MuPDF が独自のサードパーティライブラリを使用せずにビルドされている場合に失敗することが既知です。" #: ../../packaging.rst:63 a2a65b48ae41408488f21ffce49014d0 msgid "Use of scripts/sysinstall.py" msgstr "scripts/sysinstall.py の使用" #: ../../packaging.rst:65 eea1b531c51e4d31a0e82c6fab02eab2 msgid "" "`scripts/sysinstall.py` provides a useful example of build, install and " "test commands that are known to to work, because it is run regularly by " "Github action `.github/workflows/test_sysinstall.yml`." msgstr "" "`scripts/sysinstall.py` は、定期的に GitHub アクション " "`.github/workflows/test_sysinstall.yml` " "で実行されるため、動作が確認されているビルド、インストール、およびテストコマンドの便利な例を提供しています。" #: ../../packaging.rst:69 388e54101bff4f3fa4ae2619fe831f17 msgid "Run with `-h` or look at the doc-string to see detailed usage information." msgstr "詳細な使用方法については、`-h` を付けて実行するか、ドキュメント文字列を参照してください。" #: ../../packaging.rst:70 9256146054514b818c9dcb29a92af8b5 msgid "It uses Debian-style `apt` commands to install system packages." msgstr "システムパッケージのインストールには、Debian スタイルの `apt` コマンドが使用されます。" #: ../../packaging.rst:71 cb3514ca6d8c491dba99488d16d69d11 msgid "By default it assumes local git checkouts `mupdf/` and `PyMuPDF/`." msgstr "デフォルトでは、ローカルの git チェックアウトである `mupdf/` と `PyMuPDF/` を想定しています。" #: ../../packaging.rst:73 c626332a346d49e2b6784037fc0062b1 msgid "" "To run a full build, install and test for both a local fake root and the " "system root:" msgstr "ローカルのフェイクルートとシステムルートの両方で、フルビルド、インストール、およびテストを実行するには、" #: ../../packaging.rst:81 808c407963ab412c91b112f433a7533a msgid "To see what commands would be run without actually running them:" msgstr "実際に実行せずに実行されるコマンドを確認するには:" #: ../../packaging.rst:89 d5029b9f860543aaa4c5a38f00c82e36 msgid "See also" msgstr "参考にしてください" #: ../../packaging.rst:92 c20265f491b4469d8ab455749f78c3b0 msgid "" "`setup.py`'s initial doc-comment has detailed information about the " "environment variables used when building PyMuPDF." msgstr "" "参考にしてください `setup.py` の最初のドキュメントコメントには、PyMuPDF " "をビルドする際に使用される環境変数に関する詳細な情報が含まれています。" #~ msgid "" #~ "`PYMUPDF_SETUP_IMPLEMENTATIONS=b` to build only " #~ "the rebased implementation. [This will " #~ "become the default in a future " #~ "release.]" #~ msgstr "" #~ msgid "" #~ "[As of 2024-04-15, tere is no need" #~ " to set `PYMUPDF_SETUP_IMPLEMENTATIONS=b` to " #~ "build only the rebased implementation, " #~ "as this is now the default.]" #~ msgstr "" #~ "[2024年4月15日現在、`PYMUPDF_SETUP_IMPLEMENTATIONS=b` " #~ "を設定して、リベースされた実装のみをビルドする必要はありません。これはデフォルトの動作です。]" ================================================ FILE: docs/locales/ja/LC_MESSAGES/page.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 8170fcd05dee4c51bf9505113ceeca73 msgid "Artifex" msgstr "" #: ../../header.rst:-1 6af23f31d1794ebe8d4cd00cdb2c6335 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 2370c44a09c14c6ea409cf2644e17d14 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../page.rst:7 8937c9a408d44d8e9a9409e7bff61e0e msgid "Page" msgstr "Page (ページ)" #: ../../page.rst:9 9245c311a52d403f9622088450ec1ed8 msgid "" "Class representing a document page. A page object is created by " ":meth:`Document.load_page` or, equivalently, via indexing the document " "like `doc[n]` - it has no independent constructor." msgstr "" "ドキュメントページを表すクラス。ページオブジェクトは :meth:`Document.load_page` " "またはドキュメントをインデックスで参照することで作成されます（例： `doc[n]` ） - 独立したコンストラクタはありません。" #: ../../page.rst:11 5b3a16daffa34c41881df3783e022020 msgid "" "There is a parent-child relationship between a document and its pages. If" " the document is closed or deleted, all page objects (and their " "respective children, too) in existence will become unusable " "(\"orphaned\"): If a page property or method is being used, an exception " "is raised." msgstr "ドキュメントとそのページとの親子関係があります。ドキュメントが閉じられるか削除されると、存在するすべてのページオブジェクト（およびそれに関連する子供たちも）が使用できなくなります（「孤児」になります）。ページのプロパティまたはメソッドを使用している場合、例外が発生します。" #: ../../page.rst:13 c43aa4901b134ef0af55b777bc691555 msgid "" "Several page methods have a :ref:`Document` counterpart for convenience. " "At the end of this chapter you will find a synopsis." msgstr "便宜のために、いくつかのページメソッドには :ref:`Document` の対応するメソッドがあります。この章の最後に概要があります。" #: ../../page.rst:15 b2fc39847f5843cf894fb6ef28439127 msgid "" "Many times in this chapter we are using the term **coordinate**. It is of" " high importance to have at least a basic understanding of what that is " "and that you feel comfortable with the section :ref:`Coordinates`." msgstr "" "この章では何度も **「座標」** という用語を使用しています。それが何を意味するかを少なくとも基本的な理解があること、そして " ":ref:`Coordinates` のセクションに慣れていることが非常に重要です。" #: ../../page.rst:18 0638e07e50a943388068f4aee50716dd msgid "Modifying Pages" msgstr "ページの修正" #: ../../page.rst:19 4a50620eb10f44d0877cd46debc5c2a0 msgid "" "Changing page properties and adding or changing page content is available" " for PDF documents only." msgstr "ページのプロパティを変更し、ページの内容を追加または変更することは、PDFドキュメントのみで使用可能です。" #: ../../page.rst:21 86a3398051794f1585b0f0f44c54cd6d msgid "In a nutshell, this is what you can do with PyMuPDF:" msgstr "要するに、PyMuPDFでできることは次のとおりです：" #: ../../page.rst:23 16d07d121728484981e076fe815bd0f7 msgid "Modify page rotation and the visible part (\"cropbox\") of the page." msgstr "ページの回転とページの可視部分（「クロップボックス」）の変更。" #: ../../page.rst:24 a55eb2352dec4ac4808c3f070a2c45bc msgid "Insert images, other PDF pages, text and simple geometrical objects." msgstr "画像、他のPDFページ、テキスト、単純な幾何学的オブジェクトの挿入。" #: ../../page.rst:25 ccfedac9094242d9a2236213fede33ac msgid "Add annotations and form fields." msgstr "アノテーションとフォームフィールドの追加。" #: ../../page.rst:29 648ad24ff28a4782b799c7cc2209686d msgid "" "Methods require coordinates (points, rectangles) to put content in " "desired places. Please be aware that these coordinates **must always** be" " provided relative to the **unrotated** page (since v1.17.0). The reverse" " is also true: except :attr:`Page.rect`, resp. :meth:`Page.bound` (both " "*reflect* when the page is rotated), all coordinates returned by methods " "and attributes pertain to the unrotated page." msgstr "" "メソッドには、コンテンツを所望の場所に配置するために座標（ポイント、矩形）が必要です。v1.17.0以降、これらの座標は常に " "**回転していない** ページに対して提供する **必要があります**。逆もまた真実です：:attr:`Page.rect`, resp. " ":meth:`Page.bound` を除いて（ページが回転したときを *反映* " "しています）、メソッドと属性が返すすべての座標は回転していないページに関連しています。" #: ../../page.rst:31 43cad26b1c8b405cbde663afa1390699 msgid "" "So the returned value of e.g. :meth:`Page.get_image_bbox` will not change" " if you do a :meth:`Page.set_rotation`. The same is true for coordinates " "returned by :meth:`Page.get_text`, annotation rectangles, and so on. If " "you want to find out, where an object is located in **rotated " "coordinates**, multiply the coordinates with " ":attr:`Page.rotation_matrix`. There also is its inverse, " ":attr:`Page.derotation_matrix`, which you can use when interfacing with " "other readers, which may behave differently in this respect." msgstr "" "したがって、:meth:`Page.get_image_bbox` " "などのメソッドの返される値は、Page.set_rotation()を実行しても変更されません。同じことが " ":meth:`Page.get_text`、アノテーションの矩形などから返される座標にも当てはまります。オブジェクトが **回転した座標** " "でどこにあるかを調べたい場合は、座標を:attr:`Page.rotation_matrix` " "で乗算します。:attr:`Page.derotation_matrix` " "とその逆行列もあり、他のリーダーと連携する際に使用できます。この点で異なる動作をするかもしれません。" #: ../../page.rst:35 4602f0a46b4b45d692b0e8b0e0a8b4cd msgid "" "If you add or update annotations, links or form fields on the page and " "immediately afterwards need to work with them (i.e. **without leaving the" " page**), you should reload the page using :meth:`Document.reload_page` " "before referring to these new or updated items." msgstr "" "ページに注釈、リンク、またはフォームフィールドを追加または更新し、直後にこれらの新しいまたは更新されたアイテムを操作する必要がある場合（つまり " "**ページを離れずに**）、:meth:`Document.reload_page` を使用してページを再読み込みする必要があります。" #: ../../page.rst:37 d30757a5570341c492c9b6b2dd27e8da msgid "" "Reloading the page is generally recommended -- although not strictly " "required in all cases. However, some annotation and widget types have " "extended features in PyMuPDF compared to MuPDF. More of these extensions " "may also be added in the future." msgstr "一般的にはページを再読み込みすることをお勧めしますが、すべてのケースで厳密に必要とされるわけではありません。ただし、PyMuPDFの注釈とウィジェットの種類の一部は、MuPDFと比較して拡張機能を持っています。今後もこれらの拡張機能が増えるかもしれません" #: ../../page.rst:39 b54db556e2734b51bbd36600ec731807 msgid "" "Releoading the page ensures all your changes have been fully applied to " "PDF structures, so you can safely create Pixmaps or successfully iterate " "over annotations, links and form fields." msgstr "ページを再読み込むことで、変更がPDF構造に完全に適用され、Pixa画像を作成したり、アノテーション、リンク、フォームフィールドを正常にイテレートしたりできるようになります。" #: ../../page.rst:42 86f8776f6e6a46c2bd6677f03df546f8 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../page.rst:42 41c16cff24c249a6b99784f27f4c62a9 msgid "**Short Description**" msgstr "**短い説明**" #: ../../page.rst:44 e73e4ad3cfa341f28634b14957a79fc4 msgid ":meth:`Page.add_caret_annot`" msgstr "" #: ../../page.rst:44 0a9cf0b37f5d495db9ccba909ec825b7 msgid "PDF only: add a caret annotation" msgstr "PDFのみ：キャレットアノテーションを追加します" #: ../../page.rst:45 41b70f4be08542938df342847627409d msgid ":meth:`Page.add_circle_annot`" msgstr "" #: ../../page.rst:45 218dcdd140e442ef906cbc5f8489d215 msgid "PDF only: add a circle annotation" msgstr "PDFのみ：円注釈を追加します" #: ../../page.rst:46 0d9b6d05bb1b40759acc10ba769f6906 msgid ":meth:`Page.add_file_annot`" msgstr "" #: ../../page.rst:46 876465f48d654d82a63dea158fa06436 msgid "PDF only: add a file attachment annotation" msgstr "PDFのみ：ファイル添付アノテーションを追加します" #: ../../page.rst:47 b2e7234dd6e14d6ead8dc67c38dcd6ef msgid ":meth:`Page.add_freetext_annot`" msgstr "" #: ../../page.rst:47 1e63f79e07b646fc9c5b6ca226e005fb msgid "PDF only: add a text annotation" msgstr "PDFのみ：テキストアノテーションを追加します" #: ../../page.rst:48 0f9e70d7023442f3be97c1dae2ec1c4e msgid ":meth:`Page.add_highlight_annot`" msgstr "" #: ../../page.rst:48 36abc8a5ff054548915094f9d993af36 msgid "PDF only: add a \"highlight\" annotation" msgstr "PDFのみ：「ハイライト」アノテーションを追加します" #: ../../page.rst:49 91e515dbd7054bf8b273bc1712b7ede5 msgid ":meth:`Page.add_ink_annot`" msgstr "" #: ../../page.rst:49 db733d1bfea845e690867fc0e23fbfea msgid "PDF only: add an ink annotation" msgstr "PDFのみ：インク注釈を追加します" #: ../../page.rst:50 87836b81e070400981d42f52007af7c7 msgid ":meth:`Page.add_line_annot`" msgstr "" #: ../../page.rst:50 2adc6fe8aa5c4316a257de5e2135f8e8 msgid "PDF only: add a line annotation" msgstr "PDFのみ：線アノテーションを追加します" #: ../../page.rst:51 b2d616fda77c4a52bd1e433ed3b52703 msgid ":meth:`Page.add_polygon_annot`" msgstr "" #: ../../page.rst:51 85362227a8ad4cbfaf3fb0f24f477a3a msgid "PDF only: add a polygon annotation" msgstr "PDFのみ：多角形アノテーションを追加します" #: ../../page.rst:52 328e52dc8744435a9fb26981dfdc829f msgid ":meth:`Page.add_polyline_annot`" msgstr "" #: ../../page.rst:52 11200ba7725f40f79ca3dce0a53e0658 msgid "PDF only: add a multi-line annotation" msgstr "PDFのみ：多線アノテーションを追加します" #: ../../page.rst:53 51ed3acb625345fb8b7a53c31a1b6b19 msgid ":meth:`Page.add_rect_annot`" msgstr "" #: ../../page.rst:53 22ac83d8d3484f13a9a14fddae22e821 msgid "PDF only: add a rectangle annotation" msgstr "PDFのみ：四角アノテーション釈を追加します" #: ../../page.rst:54 db442110b3b54ccbb5eb1ae5a44bb3d9 msgid ":meth:`Page.add_redact_annot`" msgstr "" #: ../../page.rst:54 e18de06d48a64f5b87eb5d921b043efc msgid "PDF only: add a redaction annotation" msgstr "PDFのみ：黒塗りアノテーションを追加します" #: ../../page.rst:55 806f505045ad4d659c8ff7424ccdb0b0 msgid ":meth:`Page.add_squiggly_annot`" msgstr "" #: ../../page.rst:55 374a25c00ffc44fb802bc987d05fd85b msgid "PDF only: add a \"squiggly\" annotation" msgstr "PDFのみ：「波線」アノテーションを追加します" #: ../../page.rst:56 b22a9d9ab80a4d18b3882b1b2797bc3e msgid ":meth:`Page.add_stamp_annot`" msgstr "" #: ../../page.rst:56 9f8e591880af48f9bde9a32d695627ed msgid "PDF only: add a \"rubber stamp\" annotation" msgstr "PDFのみ：「スタンプ」アノテーションを追加します" #: ../../page.rst:57 1c4fffe9b32a4becb309c4360641ab34 msgid ":meth:`Page.add_strikeout_annot`" msgstr "" #: ../../page.rst:57 d6643236b85b4b26a0f3fda17a9c9ecc msgid "PDF only: add a \"strike-out\" annotation" msgstr "PDFのみ：「取り消し線」アノテーションを追加します" #: ../../page.rst:58 fd38c00281a845e1a4b042ac4bf44a96 msgid ":meth:`Page.add_text_annot`" msgstr "" #: ../../page.rst:58 b4a33cb834274558bd500a00ec92e154 msgid "PDF only: add a comment" msgstr "PDFのみ：コメントを追加します" #: ../../page.rst:59 0e221e35eb7f44379a4f2046ddc3b906 msgid ":meth:`Page.add_underline_annot`" msgstr "" #: ../../page.rst:59 e068f52a14424ecaa984ab47792d7886 msgid "PDF only: add an \"underline\" annotation" msgstr "PDFのみ：「下線」アノテーションを追加します" #: ../../page.rst:60 973d14e3ad8d4ca98132079d720bce1c msgid ":meth:`Page.add_widget`" msgstr "" #: ../../page.rst:60 0548a6ef761045238cc51f6f030dfd77 msgid "PDF only: add a PDF Form field" msgstr "PDFのみ：PDFフォームフィールドを追加します" #: ../../page.rst:61 e83f5334f31f49c59809b11ec3eab44c msgid ":meth:`Page.annot_names`" msgstr "" #: ../../page.rst:61 cf863f93e5054e6c8c65e9c13f29db6b msgid "PDF only: a list of annotation (and widget) names" msgstr "PDFのみ：アノテーション（およびウィジェット）の名前のリスト" #: ../../page.rst:62 7d51dd8ff9a64250aff67b396cb27d97 msgid ":meth:`Page.annot_xrefs`" msgstr "" #: ../../page.rst:62 3028d6c3a5a1465295200f57fe4b9b39 msgid "PDF only: a list of annotation (and widget) xrefs" msgstr "PDFのみ：アノテーション（およびウィジェット）のxrefのリスト" #: ../../page.rst:63 f9476aa9073b4c29b002ff703fed1459 msgid ":meth:`Page.annots`" msgstr "" #: ../../page.rst:63 62c9c440545d4ac7bbdb80a4850e7a15 msgid "return a generator over the annots on the page" msgstr "ページ上のアノテーションのジェネレーターを返します" #: ../../page.rst:64 5ba75b9f8d854aa5ae6d8f8d0abf748e msgid ":meth:`Page.apply_redactions`" msgstr "" #: ../../page.rst:64 54e665bc95f24b30b241db10ed18fe35 msgid "PDF only: process the redactions of the page" msgstr "PDFのみ：ページの塗りつぶしを処理します" #: ../../page.rst:65 48940a168fa5416c9de089ffdbfd71cf msgid ":meth:`Page.clip_to_rect`" msgstr "" #: ../../page.rst:65 75f03d5629d84a5cbe0e590d162fb8c9 msgid "PDF only: remove page content outside a rectangle" msgstr "" #: ../../page.rst:66 88bea8ccf72f49399f12f7f909be3ca0 msgid ":meth:`Page.bound`" msgstr "" #: ../../page.rst:66 ../../page.rst:137 b7afacb8a954462e86e9d8f8b3052327 #: f2d199f18ba54dc682035890309cc3d4 msgid "rectangle of the page" msgstr "ページの矩形" #: ../../page.rst:67 04c89237383a468a84c1c7a4fbd7ca94 msgid ":meth:`Page.cluster_drawings`" msgstr "" #: ../../page.rst:67 cd9d4243e92c4687bd69ec2908325cfe msgid "PDF only: bounding boxes of vector graphics" msgstr "PDFのみ：ベクトルグラフィックスの境界ボックス" #: ../../page.rst:68 708439d9c4c8432db9603b531bb52dc1 msgid ":meth:`Page.delete_annot`" msgstr "" #: ../../page.rst:68 2fd52bbdf7674f0eaa4067190fc99fbc msgid "PDF only: delete an annotation" msgstr "PDFのみ：アノテーションを削除します" #: ../../page.rst:69 07e58c4b429f4cd495cdc2461631dfd2 msgid ":meth:`Page.delete_image`" msgstr "" #: ../../page.rst:69 ea1f41e1c935433d82d9c049d5bf7c51 msgid "PDF only: delete an image" msgstr "PDFのみ：画像を削除します" #: ../../page.rst:70 7fc216eeee264ecab7dd0ca35aa1ec17 msgid ":meth:`Page.delete_link`" msgstr "" #: ../../page.rst:70 4a1fcd926d6d4a2395f61dc2dcf8d355 msgid "PDF only: delete a link" msgstr "PDFのみ：リンクを削除します" #: ../../page.rst:71 a8258588f3ca43abb6c2210464293269 msgid ":meth:`Page.delete_widget`" msgstr "" #: ../../page.rst:71 fdbb77379c8b4f1198a09d22c552b1e7 msgid "PDF only: delete a widget / field" msgstr "PDFのみ：ウィジェット/フィールドを削除します" #: ../../page.rst:72 d7147a663aef49b1b3198691be1cdc51 msgid ":meth:`Page.draw_bezier`" msgstr "" #: ../../page.rst:72 8b72e59ea4044e6ab49f4d05472ceba9 msgid "PDF only: draw a cubic Bezier curve" msgstr "PDFのみ：三次ベジエ曲線を描画します" #: ../../page.rst:73 e974652a1a6f45aa8229cf5deffa331f msgid ":meth:`Page.draw_circle`" msgstr "" #: ../../page.rst:73 ab1d3da2c8ff42fc8fe017430b57d854 msgid "PDF only: draw a circle" msgstr "PDFのみ：円を描画します" #: ../../page.rst:74 cb75b4cc4fb54f92958534162d5b23bd msgid ":meth:`Page.draw_curve`" msgstr "" #: ../../page.rst:74 f7ad1d0eb1434261a85c72f19d1a430a msgid "PDF only: draw a special Bezier curve" msgstr "PDFのみ：特別なベジエ曲線を描画します" #: ../../page.rst:75 821014e377aa404d84cbf5f34c523dbc msgid ":meth:`Page.draw_line`" msgstr "" #: ../../page.rst:75 00ec24619ceb48a992088804eff5de28 msgid "PDF only: draw a line" msgstr "PDFのみ：直線を描画します" #: ../../page.rst:76 bc002085ee9a4d66ba298b35bafb4599 msgid ":meth:`Page.draw_oval`" msgstr "" #: ../../page.rst:76 fef8e3d9c6e04e21b8189b2860b82f3b msgid "PDF only: draw an oval / ellipse" msgstr "PDFのみ：楕円を描画します" #: ../../page.rst:77 9e89eb69dd59435fb35fe33566cf57b0 msgid ":meth:`Page.draw_polyline`" msgstr "" #: ../../page.rst:77 06eaf6fd8ad042cd838a42ac93221e56 msgid "PDF only: connect a point sequence" msgstr "PDFのみ：点のシーケンスを接続します" #: ../../page.rst:78 cf7b9e235bba401cacc271deafd6f401 msgid ":meth:`Page.draw_quad`" msgstr "" #: ../../page.rst:78 2ef56dd6206b4945bcc0e17b13b1f49b msgid "PDF only: draw a quad" msgstr "PDF のみ: クアッドを描く" #: ../../page.rst:79 ad64094c84b54c70a8d3f1b0356f955e msgid ":meth:`Page.draw_rect`" msgstr "" #: ../../page.rst:79 99ffa6aaa0364c4c88ca8ac5c47de0bf msgid "PDF only: draw a rectangle" msgstr "PDFのみ：四角形を描画します" #: ../../page.rst:80 2c663eab158c4b11be91591a29f93faa msgid ":meth:`Page.draw_sector`" msgstr "" #: ../../page.rst:80 02df21db9f47463ea8a7b21c97becaa0 msgid "PDF only: draw a circular sector" msgstr "PDFのみ：円セクタを描画します" #: ../../page.rst:81 2dfce9feeb7a4c1bbad1797a7b4d6707 msgid ":meth:`Page.draw_squiggle`" msgstr "" #: ../../page.rst:81 fda33db89e424deeb78ea729069a761e msgid "PDF only: draw a squiggly line" msgstr "PDFのみ：波線を描画します" #: ../../page.rst:82 f18233d62ec842ce8d0ec507f6ca4432 msgid ":meth:`Page.draw_zigzag`" msgstr "" #: ../../page.rst:82 2c0fde654875416f905af2f467b3cf1c msgid "PDF only: draw a zig-zagged line" msgstr "PDFのみ：ジグザグ線を描画します" #: ../../page.rst:83 0ad5611bf2ea4d9797c43b07aaf17f67 msgid ":meth:`Page.find_tables`" msgstr "" #: ../../page.rst:83 3c716fff66534b89be3e42bff1821cae msgid "locate tables on the page" msgstr "ページ上のテーブルを検出します" #: ../../page.rst:84 9760c26080364bb38b892d7079635820 msgid ":meth:`Page.get_drawings`" msgstr "" #: ../../page.rst:84 1a642c31f38440c99d4eed26eca1cf1e msgid "get vector graphics on page" msgstr "ページ上のベクトルグラフィックを取得します" #: ../../page.rst:85 ../../page.rst:2355 0212137293b847f19ef60d639f77da9f #: bd4a028783c641958b19f4cf86d7d235 msgid ":meth:`Page.get_fonts`" msgstr "" #: ../../page.rst:85 8ffe9443af43443788c6103faf1fe29f msgid "PDF only: get list of referenced fonts" msgstr "PDFのみ：参照されたフォントのリストを取得" #: ../../page.rst:86 d299b9cb1da54036adf1f73e8fe204f5 msgid ":meth:`Page.get_image_bbox`" msgstr "" #: ../../page.rst:86 258e644759a344a1a93e5fe92f4d572d msgid "PDF only: get bbox and matrix of embedded image" msgstr "PDFのみ：埋め込まれた画像のバウンディングボックスと行列を取得" #: ../../page.rst:87 28b400999b9b44a897e4ff4130298469 msgid ":meth:`Page.get_image_info`" msgstr "" #: ../../page.rst:87 1fc9f5618837431d95f9edc92be81f1f msgid "get list of meta information for all used images" msgstr "使用されるすべての画像のメタ情報のリストを取得" #: ../../page.rst:88 356cdd777ea54c359213f21664133141 msgid ":meth:`Page.get_image_rects`" msgstr "" #: ../../page.rst:88 85adc8a6b1f7459186e411e073476e72 msgid "PDF only: improved version of :meth:`Page.get_image_bbox`" msgstr "PDFのみ： :meth:`Page.get_image_bbox` の改良バージョンを取得" #: ../../page.rst:89 ../../page.rst:2356 9c773ca1a4c04ae39dd31e751a19d4a8 #: f6df8c02ac2a4f6083b0ad1a477980f3 msgid ":meth:`Page.get_images`" msgstr "" #: ../../page.rst:89 463a60e6db60402bbfd7e0365544fcc5 msgid "PDF only: get list of referenced images" msgstr "PDFのみ：参照された画像のリストを取得" #: ../../page.rst:90 72a5fbb7f5ae4b5aba9cd75c236dfd17 msgid ":meth:`Page.get_label`" msgstr "" #: ../../page.rst:90 8a64a3606f554ddca8135f8fcf01bdcb msgid "PDF only: return the label of the page" msgstr "PDFのみ：ページのラベルを返す" #: ../../page.rst:91 3d9b2f63e38640eba28039648bcdd37c msgid ":meth:`Page.get_links`" msgstr "" #: ../../page.rst:91 baebde09d09f4430a9a16ab90e53e61c msgid "get all links" msgstr "すべてのリンクを取得" #: ../../page.rst:92 ../../page.rst:2357 4a56014985a94a87ac357a4612aaf5fa #: ed985753e8674d2c99c1b565cc9ccbf7 msgid ":meth:`Page.get_pixmap`" msgstr "" #: ../../page.rst:92 dfbe408764ca4ea7a194aeda516c3b3b msgid "create a page image in raster format" msgstr "ラスターフォーマットのページイメージを作成" #: ../../page.rst:93 84ff5221a3f34016b7d222d2a504b8d8 msgid ":meth:`Page.get_svg_image`" msgstr "" #: ../../page.rst:93 d47abd082cf34e8ba1416053d7f9f36c msgid "create a page image in SVG format" msgstr "SVGフォーマットのページイメージを作成" #: ../../page.rst:94 ../../page.rst:2358 236e4ae277e5430092c860d3b877309e #: 534bf943e881493a9c1890cf7869b882 msgid ":meth:`Page.get_text`" msgstr "" #: ../../page.rst:94 8fcda9fdb4054ee4925dd13a83d5c7f9 msgid "extract the page's text" msgstr "ページのテキストを抽出" #: ../../page.rst:95 8e3abc00882d408bad7eb252ba91611b msgid ":meth:`Page.get_textbox`" msgstr "" #: ../../page.rst:95 05aaa24df0f34405b93ba13e56afaffd msgid "extract text contained in a rectangle" msgstr "特定の矩形に含まれるテキストを抽出" #: ../../page.rst:96 25d5c92ec4e64cb6b99f8822be72860a msgid ":meth:`Page.get_textpage_ocr`" msgstr "" #: ../../page.rst:96 1b455eb2a8fe4616a02979e821ec50ce msgid "create a TextPage with OCR for the page" msgstr "ページのOCR付きのTextPageを作成" #: ../../page.rst:97 b452235a93834d8b98588dc1103fdda3 msgid ":meth:`Page.get_textpage`" msgstr "" #: ../../page.rst:97 86c970be01be4a46b056f68be2cc43b9 msgid "create a TextPage for the page" msgstr "ページのTextPageを作成" #: ../../page.rst:98 f5ea422d48294efdb6c416ce7dc132c5 msgid ":meth:`Page.get_xobjects`" msgstr "" #: ../../page.rst:98 074c5bea324d4dd7b71a76685d7bf5ac msgid "PDF only: get list of referenced xobjects" msgstr "PDFのみ：参照されたxobjectのリストを取得" #: ../../page.rst:99 fad014b3566248f2b8fef12ad6d63683 msgid ":meth:`Page.insert_font`" msgstr "" #: ../../page.rst:99 a13f7d11090b45e7b1e1fdcd51b6771b msgid "PDF only: insert a font for use by the page" msgstr "PDFのみ：ページで使用するフォントを挿入" #: ../../page.rst:100 eb9fab9be3844f698f3f7981238fd0cc msgid ":meth:`Page.insert_image`" msgstr "" #: ../../page.rst:100 5ecd33232193401eba7aad556bde3428 msgid "PDF only: insert an image" msgstr "PDFのみ：画像を挿入" #: ../../page.rst:101 bf9559cfcb304283b984cd3b63082707 msgid ":meth:`Page.insert_link`" msgstr "" #: ../../page.rst:101 065c8f93c7394778aa3bece800130689 msgid "PDF only: insert a link" msgstr "PDFのみ：リンクを挿入" #: ../../page.rst:102 77c641ea6e564e8eb59cd4339292bdcd msgid ":meth:`Page.insert_text`" msgstr "" #: ../../page.rst:102 93437db590444321bf292dcc19733056 msgid "PDF only: insert text" msgstr "PDFのみ：テキストを挿入" #: ../../page.rst:103 c552d045e73f45f9b03240ef2fab0611 msgid ":meth:`Page.insert_htmlbox`" msgstr "" #: ../../page.rst:103 bdbe18d30a0c4be9875135057d42044e msgid "PDF only: insert html text in a rectangle" msgstr "PDFのみ: 指定された矩形にテキストを追加します。" #: ../../page.rst:104 119b6fdbf8b44f5f84c8616c320b6d0a msgid ":meth:`Page.insert_textbox`" msgstr "" #: ../../page.rst:104 33a379824b3d46c7b6df06f0d0e25eb1 msgid "PDF only: insert a text box" msgstr "PDFのみ：テキストボックスを挿入" #: ../../page.rst:105 e4a2a7be4af54df396d64469f81c0902 msgid ":meth:`Page.links`" msgstr "" #: ../../page.rst:105 6752a070405544cba6cff49390f95edd msgid "return a generator of the links on the page" msgstr "ページ上のリンクのジェネレータを返す" #: ../../page.rst:106 10bf8179f1ce486fabaa949403bacd70 msgid ":meth:`Page.load_annot`" msgstr "" #: ../../page.rst:106 014af39f35314a68afbe150161286b66 msgid "PDF only: load a specific annotation" msgstr "PDFのみ：特定のアノテーションを読み込む" #: ../../page.rst:107 e1685690b2d44e14a8978d8b1339627e msgid ":meth:`Page.load_widget`" msgstr "" #: ../../page.rst:107 5f2f4a616a774f9d92c511a1bc7eec7d msgid "PDF only: load a specific field" msgstr "PDFのみ：特定のフィールドを読み込む" #: ../../page.rst:108 a8dd3d29d1384269b38a150ffdca450c msgid ":meth:`Page.load_links`" msgstr "" #: ../../page.rst:108 c159d07089f2405190c47cf67e28fb74 msgid "return the first link on a page" msgstr "ページ上の最初のリンクを返す" #: ../../page.rst:109 94bb3a983df740fbbbc60a44a7e75a25 msgid ":meth:`Page.new_shape`" msgstr "" #: ../../page.rst:109 f7e23a9cbe464b7fbd4ceafb2bd2f884 msgid "PDF only: create a new :ref:`Shape`" msgstr "PDFのみ：新しい :ref:`Shape` を作成" #: ../../page.rst:110 e7cbb0a3cc32479290ed8187d341a4cc msgid ":meth:`Page.recolor`" msgstr "" #: ../../page.rst:110 e17cc9c9d35a4b528ecc51356afc4294 msgid "PDF only: change the colorspace of objects" msgstr "" #: ../../page.rst:111 2b963b54441840a5a4ff1089e26ecb2f msgid ":meth:`Page.remove_rotation`" msgstr "" #: ../../page.rst:111 2a452763180a40b8b9d7840ae8da0992 #, fuzzy msgid "PDF only: set page rotation to 0" msgstr "PDFのみ：ページの回転を設定" #: ../../page.rst:112 8f321974b8444af0b093d1295c75cf05 msgid ":meth:`Page.replace_image`" msgstr "" #: ../../page.rst:112 a847c5c8166640328cfb165bbaa6a992 msgid "PDF only: replace an image" msgstr "PDFのみ：画像を置換" #: ../../page.rst:113 ../../page.rst:2359 0f7e94bdfa2048379aadc4ec274917ac #: 474092e2fbb04bd8b3fb386d1de12af5 msgid ":meth:`Page.search_for`" msgstr "" #: ../../page.rst:113 6556b8acd7d240d7b97207cf0df3d619 msgid "search for a string" msgstr "文字列を検索" #: ../../page.rst:114 dac3b78a1a3c43848aa71d71a9ac932f msgid ":meth:`Page.set_artbox`" msgstr "" #: ../../page.rst:114 c5cb8b37faa84d478e691b9d7aeeb072 msgid "PDF only: modify `/ArtBox`" msgstr "PDFのみ： `/ArtBox` を変更" #: ../../page.rst:115 f33dd235a0224b98a72d79e99d400754 msgid ":meth:`Page.set_bleedbox`" msgstr "" #: ../../page.rst:115 03a5e490c9f342c1b33650557bb311cf msgid "PDF only: modify `/BleedBox`" msgstr "PDFのみ：/BleedBoxを変更" #: ../../page.rst:116 1954aab05621455aafbf63b3dc604da9 msgid ":meth:`Page.set_cropbox`" msgstr "" #: ../../page.rst:116 662dd3600dac46358c61710f34c8ec91 msgid "PDF only: modify the :data:`cropbox` (visible page)" msgstr "PDFのみ： :data:`cropbox` （可視ページ）を変更" #: ../../page.rst:117 6a2fd94e05d047a1a8f604c96105f9d2 msgid ":meth:`Page.set_mediabox`" msgstr "" #: ../../page.rst:117 2b67269297d34d6c9ac1dee4f63a8961 msgid "PDF only: modify `/MediaBox`" msgstr "PDFのみ：/MediaBoxを変更" #: ../../page.rst:118 3c19f680917744e48b7ffa6e60497c91 msgid ":meth:`Page.set_rotation`" msgstr "" #: ../../page.rst:118 44b06f5ab1f4409db21e8180c6840f21 msgid "PDF only: set page rotation" msgstr "PDFのみ：ページの回転を設定" #: ../../page.rst:119 8f9ca0aa08a7434faaa9e139cc23c4cc msgid ":meth:`Page.set_trimbox`" msgstr "" #: ../../page.rst:119 e1be1521eed84ba3ac0ec715ca539607 msgid "PDF only: modify `/TrimBox`" msgstr "PDFのみ：`/TrimBox` を変更" #: ../../page.rst:120 e490c2e919d348a8bd996d89b6379831 msgid ":meth:`Page.show_pdf_page`" msgstr "" #: ../../page.rst:120 0ca4ee87ad0d45d999070687313ee6c2 msgid "PDF only: display PDF page image" msgstr "PDFのみ：PDFページ画像を表示" #: ../../page.rst:121 373f0f9543e5488e8bd497bb817ff8c0 msgid ":meth:`Page.update_link`" msgstr "" #: ../../page.rst:121 3916b852a5ab4aef891aee7bd6819784 msgid "PDF only: modify a link" msgstr "PDFのみ：リンクを変更" #: ../../page.rst:122 833c40f55d4c480bae57ee0a61660f55 msgid ":meth:`Page.widgets`" msgstr "" #: ../../page.rst:122 54727116195946e3a45618e914ff037f msgid "return a generator over the fields on the page" msgstr "ページ上のフィールドのジェネレータを返す" #: ../../page.rst:123 dd2c38c530664eda8d7154c879458e0d msgid ":meth:`Page.write_text`" msgstr "" #: ../../page.rst:123 a543915750f14b829b0c094cb7bfe01d msgid "write one or more :ref:`Textwriter` objects" msgstr "1つ以上の :ref:`Textwriter` オブジェクトを書き込む" #: ../../page.rst:124 9adae32b783846ffb5e94e4430cac493 msgid ":attr:`Page.cropbox_position`" msgstr "" #: ../../page.rst:124 31b13eebd9f441bcab940d3c944776b8 msgid "displacement of the :data:`cropbox`" msgstr ":data:`cropbox` の位置" #: ../../page.rst:125 1e42f4312b634f3f9c8e85739c813eb8 msgid ":attr:`Page.cropbox`" msgstr "" #: ../../page.rst:125 cf64d8442e414dc0879c602b3b0b489e msgid "the page's :data:`cropbox`" msgstr "ページの :data:`cropbox`" #: ../../page.rst:126 fc92d1a42e694fa6ac0161ed12cb39c0 msgid ":attr:`Page.artbox`" msgstr "" #: ../../page.rst:126 ff906dbe697d49c0989435a6d87f1a1d msgid "the page's `/ArtBox`" msgstr "ページの `/ArtBox`" #: ../../page.rst:127 a73f503950b14012a9d0b865c3a9b45b msgid ":attr:`Page.bleedbox`" msgstr "" #: ../../page.rst:127 a368349472a349a381872c4867d6b3a6 msgid "the page's `/BleedBox`" msgstr "ページの `/BleedBox`" #: ../../page.rst:128 1215951372f347e498df9704fb8e3912 msgid ":attr:`Page.trimbox`" msgstr "" #: ../../page.rst:128 e299310368b645b396a106343b8f3f97 msgid "the page's `/TrimBox`" msgstr "ページの `/TrimBox`" #: ../../page.rst:129 07634bad562d4f4da72af4503f45af6c msgid ":attr:`Page.derotation_matrix`" msgstr "" #: ../../page.rst:129 62bff9b163644f9a8a4d57b8c38631b5 msgid "PDF only: get coordinates in unrotated page space" msgstr "PDFのみ：回転されていないページ空間内の座標を取得" #: ../../page.rst:130 9d8f0942aabf4466872c935bff52be92 msgid ":attr:`Page.first_annot`" msgstr "" #: ../../page.rst:130 9b10c13e23d649018aaaa01888b0752c msgid "first :ref:`Annot` on the page" msgstr "ページ上の最初の :ref:`Annot`" #: ../../page.rst:131 007425f57c1c45cab27b9fd5356dc25c msgid ":attr:`Page.first_link`" msgstr "" #: ../../page.rst:131 599bf77705da424f9842f1fc4593e422 msgid "first :ref:`Link` on the page" msgstr "ページ上の最初の :ref:`Link`" #: ../../page.rst:132 d306281af9fe472ebd48cb5da990d400 msgid ":attr:`Page.first_widget`" msgstr "" #: ../../page.rst:132 c045b6255e904caeb1248136a17fdcb4 msgid "first widget (form field) on the page" msgstr "ページ上の最初のウィジェット（フォームフィールド）" #: ../../page.rst:133 61a7569544b04f579eeeccb6dbebf33e msgid ":attr:`Page.mediabox_size`" msgstr "" #: ../../page.rst:133 5740d94335274d2cb2f1a0aaed9e73d2 msgid "bottom-right point of :data:`mediabox`" msgstr ":data:`mediabox` の右下のポイント" #: ../../page.rst:134 93c29178cc5749b6829fd8dfed0b62f9 msgid ":attr:`Page.mediabox`" msgstr "" #: ../../page.rst:134 8800f1ba240a448a94f2b724b21b6f97 msgid "the page's :data:`mediabox`" msgstr "ページの :data:`mediabox`" #: ../../page.rst:135 c50c79da136d456fa1b50250eea7203e msgid ":attr:`Page.number`" msgstr "" #: ../../page.rst:135 0fc96eb9fc344189ad927dad1dbfc341 msgid "page number" msgstr "ページ番号" #: ../../page.rst:136 695f5ae69bcd4635b33ebd6ed673c706 msgid ":attr:`Page.parent`" msgstr "" #: ../../page.rst:136 4061cff6ba714b82bd4a109854384956 msgid "owning document object" msgstr "所属するドキュメントオブジェクト" #: ../../page.rst:137 ddc6ff6c91ee414dbdf6805bbe28c767 msgid ":attr:`Page.rect`" msgstr "" #: ../../page.rst:138 1ea7f17570a540a989a56c5b01d20bff msgid ":attr:`Page.rotation_matrix`" msgstr "" #: ../../page.rst:138 f3a09c1c09e046388be436720f61b660 msgid "PDF only: get coordinates in rotated page space" msgstr "PDFのみ：回転したページ空間内の座標を取得" #: ../../page.rst:139 ddf87c132d5e429eb3e16dd0d9a7533a msgid ":attr:`Page.rotation`" msgstr "" #: ../../page.rst:139 b85fb7d6d7ad4c7ab2a14c0d2093c398 msgid "PDF only: page rotation" msgstr "PDFのみ：ページの回転" #: ../../page.rst:140 8af77a0f8bb64059bbb281a4e56ca015 msgid ":attr:`Page.transformation_matrix`" msgstr "" #: ../../page.rst:140 092b7fc6ca7a4d0f86bfb8f90459e30f msgid "PDF only: translate between PDF and MuPDF space" msgstr "PDFのみ：PDFとMuPDFのスペース間を変換" #: ../../page.rst:141 bb906c9e47254441950fe2061cb7283f msgid ":attr:`Page.xref`" msgstr "" #: ../../page.rst:141 4e19cd5ead774a58b9478f33dfc08d66 msgid "PDF only: page :data:`xref`" msgstr "PDFのみ：ページの :data:`xref`" #: ../../page.rst:144 7dd691ddf1214165b60d22ae28b1c9f0 msgid "**Class API**" msgstr "**クラス API**" #: ../../page.rst:150 c7b40172c5bc47398e0abf78d418e310 msgid "" "Determine the rectangle of the page. Same as property :attr:`Page.rect`. " "For PDF documents this **usually** also coincides with :data:`mediabox` " "and :data:`cropbox`, but not always. For example, if the page is rotated," " then this is reflected by this method -- the :attr:`Page.cropbox` " "however will not change." msgstr "" "ページの長方形を決定します。下記の :attr:`Page.rect` プロパティと同じです。PDF文書の場合、通常は " ":data:`mediabox` と :data:`cropbox` " "と一致しますが、常にそうとは限りません。たとえば、ページが回転している場合、このメソッドに反映されますが、:attr:`Page.cropbox`" " は変更されません。" #: ../../page.rst 07da7245f1d64a65b2b4254797f65491 #: 16467ad0e8d64d7d85006bda933b3200 274157befb1b469fa2f28b340c60adc9 #: 33737a34b2944633a24492dbe9c2d147 3f24c0b2d0254e06b54bf5e2b6f88555 #: 43215cbc86534ac285647938e0b2a2a2 6ad65941237c4751902d551fa14d5e71 #: 780c66ef56ae428dba33fe118ceaeb0e 7f54a5a3c98d4cebb61a506237a4643e #: 86172078b6f44f549b02563feed36a81 963bc09177024b08b6c785605249a826 #: 986fd139ad45437e87c7593c11d6a47b 9a2fe8da29584084a592464409782175 #: 9fb73c5f593f462a967426864943a5aa a42bc637a18a46dfb72820a97f51ba1a #: ab3dd8b5e88049939c12db64481baefa b05be138bafb4bb2ae77367972743409 #: b14e9f1be1b74a14844053e00ed4bf02 c2858bea2fa445b695054db4f9bb3e3d #: c2a8aab54fbb4862893ab1555e5fad49 c8bc2f1e08e5407ab1670a313332ad5e #: ceae107b8e8a40d7a69d740fb4d3a283 d3bf58c1898f437c81297b2d9ddd04b0 #: de7a1f0132d34b6d8cf9fd97e950cf77 dfa066004b01431aaca46c33f8710478 #: e079c387d0ec447cb4127c54e273c96e e16013432c3c473797fe1429e17df94b #: ee88a3da14804c22825ad9be9d13dc1c f19ee08a02c543e4b42dff9b4d74f1d3 #: fb45ddf994894d8e82465a6136c23734 msgid "Return type" msgstr "戻り値の型" #: ../../page.rst:152 ../../page.rst:2200 ../../page.rst:2210 #: ../../page.rst:2222 ../../page.rst:2283 ../../page.rst:2289 #: ../../page.rst:2432 ../../page.rst:2492 17dce4a3dac0430f981fd5f333253854 #: 1fcc8c10d3314f7ba2155b0f3e8a20fb 70bf6ccb650d40ec885b1b2a34b36172 #: 72236d1673274a9781172bacbbac9335 7cc89df9fff64c9aac0c90c75083a7e6 #: 87c39a1029e54b5990a21c179e2f359d a7543904f25e400681f49fb50b50c9de #: be7afb8df5954242b2dca9c5af5a1e97 msgid ":ref:`Rect`" msgstr "" #: ../../page.rst:156 0ec0c7438154470994b23ca319d41d4d msgid "" "PDF only: Add a caret icon. A caret annotation is a visual symbol " "normally used to indicate the presence of text edits on the page." msgstr "" "PDFのみ: " "ケアットアイコンを追加します。ケアットアノテーションは通常、ページ上でテキストの編集が存在することを示すために使用される視覚的なシンボルです" #: ../../page.rst 00b3632567644912bffe0c7c68195548 #: 054320e3c706475d93bbf517174a2cd9 0878b21ab311460bb8d044b195f065c9 #: 09105ffebd5b4af99479ab1908edbf71 09d72a257dd8425ab36e4cf43950a91d #: 0da394c31bee4739a806cd889c071c24 1367cad38f644d23983d0e9832ffec1d #: 16b87a761f6947ecae635b1721df752a 2028dc07db06471db752d79ad2b97ad4 #: 20957df1cc49455882744213ebf99d1f 291031d6bab54401ba4808b736782a57 #: 2fb9573932ef4990aa17dad40ec62903 31c0111741a24d9984a4f7e8f6d384d6 #: 38bbd18c135b4b35b2e8265a0abd6588 3d67d0eb2fe04c27aacb768de4673ca0 #: 40031e90ddd54975b1bda8bf0a808d63 46529b455a46414f8fc3569e8cd74ee0 #: 498ee9c49c214e368374cf7456d63aef 4d3cee8bc2d1469d9a7dd085fddcd328 #: 503687535947403eb1e47df55fe26cc2 535cf8e9a9484fefaf11b8666a8a6642 #: 54f7a37e80354629988dce94a656e940 5bf5fff4bcbb4463ad26a8a5f6b5eb1e #: 6d08910d5dc84544b81029616ce95d40 71f8f7f7626947a39f84c7bcad375207 #: 7e7bec8634ba460780bca9ae053753bc 8302f70a54514fbc89e0b1dde1048026 #: 84033749e37e4b759f3ebe8c94d59fd3 8e4bcb6977f14382bbbbd46621f00dc1 #: 941fa38cd676457fbe97b6490b7ae8cf 9a6bc2252f91444aa5ec776c39df263e #: 9d5a62b410b947b8865a28874d59ea97 a33d3566faac442ab7b530abc59aa4e5 #: ae64f9becd5347639cb3883b239e0f88 b25079f1b5b942f88cd338be4b0166e4 #: b87de502ffdf4ccb85876fbefa001a43 b8c63bbc665f43f1ae6aee0196ff6cae #: bb5b5a5eb33b48d19ffa688a1384052a c3ff7da5a1f844cfb8ec962ae1c60da4 #: ca7e4f1b3e0f4da39ef4397d425ffad9 d000ac18dfbe40e28fd0bdc71f3a858b #: d74c4ba05c7449d3a2b8faa4188e1fe1 f1f1aceff0ce40aeac912afeece61dac #: f280525254e24464af14333042b57307 f40fc35b625c4b8ab27414a1e0a2c197 #: f8023b505b6749289bf7f1735ff8dc84 f8cb1838b1c74387ae60068ec2949d7d #: fdaf5844924a4192b07017546577808b msgid "Parameters" msgstr "パラメータ" #: ../../page.rst:158 f1fd38d47b7b448b98e7fc18cdf0610d msgid "" "the top left point of a 20 x 20 rectangle containing the MuPDF-provided " "icon." msgstr "point (point_like) – MuPDFが提供するアイコンを含む20 x 20の長方形の左上のポイント。" #: ../../page.rst:160 ../../page.rst:181 ../../page.rst:240 ../../page.rst:264 #: ../../page.rst:273 ../../page.rst:284 ../../page.rst:295 ../../page.rst:323 #: ../../page.rst:388 ../../page.rst:600 ../../page.rst:1923 #: ../../page.rst:2258 0a58216226494e178dde4651b0611959 #: 1fe577105c91488e9f0560a7b8796e99 2877c7fb524b42e0b6e9275ef04a546e #: 5605b94a8f004396a557de9db39517c5 58d03141cddf4ab89128aacdfc62091e #: 6b8b6d0719d745b699b11d162b55b2b3 9068eacd05c74b9aa20035a54a6bfd25 #: 90aa1e78784a47c383c80669c4fb882c 9fa31f84235845bca516caf1ba22f068 #: a59e0172e0fd4306839da9756ad512a0 b7f3ee5707fe4eadb31fad70473e9aeb #: b9c8a147995d4e00940e43b61dca788f msgid ":ref:`Annot`" msgstr "" #: ../../page.rst 0dffbb758e964d6d8e27b7cc916fcece #: 19fbc273b908406d9bebee248b9f341e 1ab9f9b6b79c430ebfac79d31add954f #: 1dd29dece91e45be836be0ec87b241f5 2bec5ff55c37456483e4dafce21fed0a #: 40db1e056e2e4015a335ef534d7d7d09 42075d2ac0074ccfad9579bf6a79fa97 #: 4355228500d64c04877e4ef51bf816a2 46ab70cb395f45efa6127ced35e93b87 #: 49e64f07d58e457a9516b85180e23e8f 4b7549ca59cf4895854db1abc8ac1c6d #: 4e7c576b76ad419db6610f3bbc600de3 517df8f478b340bbb8fb49f29e7075f9 #: 5ff6d3905f974c44ab6b29bd90db2428 6197d8c4c73844138b4c591ce0ba628e #: 61cef6bf48df4cec82d6645cfd249e28 63a63e53773f4fa6a34666d256a266c5 #: 6d4f832405714fcb9c1d1a4e6bcd3f97 74b115386a78411cb1e82b6401e27f88 #: 7c0515b75c9146acb8105883bc9ff293 804e462e6dc8457fa3baee083aa7c0af #: 81628f78bf8f4fc0a7752cceb4e6b7a8 8180d1bab4e44971968d755badc44129 #: 81d0d0a948bf405eadb682854c67e850 870d5db2cc324545a4c6657a37454ca5 #: 90896fe1186947b891c9e82e55d7eb0a 916f9182ca0b44f0be8298f1610ee103 #: 99a9710b564e4de1bbb28e4e6e4816ae 9c8d55eba9d7433f9e9fee31b10de98e #: a5242692396a4b0f88b0461287fd9538 a79f1c2cced84134bae0b2cbdb521451 #: c536198c110441ec8f582db7296da842 c81c6629c1d743ada613c4cd50b30e27 #: de8e6016be4241f28bcb504a7760cbe6 dfff7bd57dab4210bfeee1741e0dba54 #: e253b98abd6b43f1821d613362b34a45 eaaa3a14ee1e4d228a712a52abd75d6c #: ef0de4bbb46d4b7ebf89f100548e5a7e ef162dbd023c4bcfbffbc4bd1bb5e973 #: f5694bc35f254fc3ad0381ec573bad5b msgid "Returns" msgstr "戻り値" #: ../../page.rst:161 725d7121e14f4a59ac0c7b1fdce04357 msgid "" "the created annotation. Stroke color blue = (0, 0, 1), no fill color " "support." msgstr "作成されたアノテーション。ストロークの色は青=(0, 0, 1)で、塗りつぶしの色はサポートされていません。" #: ../../page.rst:166 ../../page.rst:243 ../../page.rst:328 ../../page.rst:368 #: ../../page.rst:540 ../../page.rst:613 ../../page.rst:649 ../../page.rst:671 #: ../../page.rst:696 ../../page.rst:711 ../../page.rst:733 ../../page.rst:761 #: ../../page.rst:790 ../../page.rst:857 ../../page.rst:894 ../../page.rst:919 #: ../../page.rst:944 ../../page.rst:968 ../../page.rst:992 ../../page.rst:1017 #: ../../page.rst:1041 ../../page.rst:1066 ../../page.rst:1090 #: ../../page.rst:1115 ../../page.rst:1140 ../../page.rst:1321 #: ../../page.rst:1369 ../../page.rst:1393 ../../page.rst:1451 #: ../../page.rst:1479 ../../page.rst:1501 ../../page.rst:1542 #: ../../page.rst:1653 ../../page.rst:1676 ../../page.rst:1735 #: ../../page.rst:1765 ../../page.rst:1785 ../../page.rst:1800 #: ../../page.rst:1841 ../../page.rst:1882 ../../page.rst:1896 #: ../../page.rst:1910 ../../page.rst:1928 ../../page.rst:1945 #: ../../page.rst:2046 ../../page.rst:2083 ../../page.rst:2107 #: ../../page.rst:2125 ../../page.rst:2172 06e0aca46a0b497995a0933772704269 #: 141cb4fdb9f645d4aeaea7b7024a5052 1a66f50d90b04e749b4732040a0034bf #: 2003c624641d4d84acb78c5bc64570f3 2c4d8bd8d31e4b3d9e373b8eb7af09c2 #: 30c98e90c3b44ec789d6ba46abf05fa1 3224c46abf7343f4afe5cf8537bf7fa1 #: 34d52f2c3e7648e6897fd5ff07398ab3 3b45669122f9411fa021821d3d9661d7 #: 3c4ea15bd48a46b791a050505f8caaee 3d5e060b49d34386b501bf1b8b7c8d1c #: 4988794a42404e5bba37c3323e105fd1 512b3c36f1914ccb91651173577f889e #: 52f0d7450dfe49a78ddf7879e240686a 5a3e49f66f844cf7a226447ba515514c #: 5ce877309d474b3895438c07db4cc025 5d8bc521f1ab40bea08f06305a0133dc #: 62fa68c4de434ad89adf8fd663faa9b0 6aafe1bc29f6405c8373a8f764191655 #: 747b6c2893d54c3f97ed3377cb0e1ce5 766bfd0bdee34cb9a30b2444fa9640e3 #: 76a3a3500f1341a8a5423df815a5d80e 77777ddfc172483ba1f24281cef1af24 #: 8306e28fb421477ca15958f8993a706a 83b6f324e7d44593a436db0e839ee638 #: 84a409e92469401cb2471c796119ffda 8bdd9f15f33f4127a32d7bcfc7ec4422 #: 913f042d35ea407b8ae71b5c88d7ebb0 92eca8a07ce840e58717a6f674b107f8 #: 9d3f92cd8fb1461e99f67ee8f00ffce3 9f34f467e9c2454ea41e4bd724b6f44b #: aa47e7de7bbf4ab9b38289d426fc55b1 aba5c0dd558b410ea11ca40a3e8a9fe6 #: aecae63f68e646e8aad20d73eda5ee5e af34016c28c84aa7aab373f75a440f93 #: b3689628e86b4de7a18aebf3de050de5 b46fa7c15f2343d184eec41fd9db3529 #: ce4a7227d53b4c0bb56195ad279b5e34 d13c0eba77cb4d9ab1f7288b8ce2f473 #: d2499636a4484e5eb81c6ad965045c9e d2c46e917760489bbc62741618ea979a #: d496035da211495894f02763aab46d52 d4b1c15d3db94414aa4c77f192dc5e62 #: d539de04647e4ddeaf022884e895ff0e dafe015561de445e8048fba403c2f26c #: df8f779752144b98944a98a1f1fe0b99 e2839fd8badb49bfaa229c37513be843 #: e76ecfba7ee24286bcb6ee2406fd255a e827f59db4b44f1f9f7b0e526f8bef78 msgid "|history_begin|" msgstr "" #: ../../page.rst:168 a432ca9a84a64f4f93ffef1d2d8b1818 msgid "New in v1.16.0" msgstr "v1.16.0で新たに追加された" #: ../../page.rst:170 ../../page.rst:247 ../../page.rst:332 ../../page.rst:376 #: ../../page.rst:545 ../../page.rst:617 ../../page.rst:653 ../../page.rst:675 #: ../../page.rst:700 ../../page.rst:715 ../../page.rst:737 ../../page.rst:765 #: ../../page.rst:794 ../../page.rst:870 ../../page.rst:898 ../../page.rst:923 #: ../../page.rst:948 ../../page.rst:972 ../../page.rst:996 ../../page.rst:1021 #: ../../page.rst:1045 ../../page.rst:1070 ../../page.rst:1094 #: ../../page.rst:1120 ../../page.rst:1144 ../../page.rst:1345 #: ../../page.rst:1373 ../../page.rst:1397 ../../page.rst:1459 #: ../../page.rst:1484 ../../page.rst:1506 ../../page.rst:1547 #: ../../page.rst:1663 ../../page.rst:1684 ../../page.rst:1740 #: ../../page.rst:1769 ../../page.rst:1793 ../../page.rst:1804 #: ../../page.rst:1855 ../../page.rst:1886 ../../page.rst:1900 #: ../../page.rst:1914 ../../page.rst:1932 ../../page.rst:1949 #: ../../page.rst:2051 ../../page.rst:2090 ../../page.rst:2112 #: ../../page.rst:2130 ../../page.rst:2176 02badfee54914c3f83727889b1b4ff33 #: 0595e10a378642e0bbe023669874e726 08449e46bba64aacade9e311407ea072 #: 0a2994c82ef1450ebb9756b4fb0dfc1f 0c5821d235c84248b3e340f1c793cebf #: 0f22055db7d14cac92d34c39f82872fa 1a567f1151e843229f0254cede4cf4b4 #: 1e1e5b59c2ab4dcab2182160cd9d7fc4 201fa97422c246fdb4cc8f5a01af81a2 #: 2418a5d90afb42e797c383c4b35b82e3 26d6d9eaf82c4a87a18593f4c71dd611 #: 2986afb3a4524ab282fd814b66b7b124 29de7beadc114997b1d486f2e93e4701 #: 2c5f31d1f39c428abbe3963bfe89a076 31a9087f87a342cdbff2a000e761fafe #: 33f63e74eb534732beae8ecb511e8510 3d260b67c14c4b21a1e767eb18a7ca54 #: 46a9d7d5f0b94aa9b18bd4189ed9c34a 47a28c0e7222419b89633a5ae0e77749 #: 5e5876e07cbb430e874d23691122fae2 622972c036ee44af83db95693614231f #: 672303667e104177b5204910e3fdf14f 81d282163d3a4a82bb5cbdcfd15d0dce #: 84f3a15e69814963aa1b9db2971e9707 87f85a7f6fd74f43a16acbad543db66e #: 93e3dda4c5a243db90b873c791394d69 9e980b217a884705aafd2f0704ca0dd6 #: a106f2b5aa45444483dc8651848f0889 a2b7f0a98f5149148ad7f0b0ab94d391 #: af17b808a1324b0bbea2ead2da174b99 b1eedf6b66fe4cad8728aed5fc96761b #: baa2a3be67d7485ea3f4fe4fbd5e6d71 bfaa4ce78d0e46309534834d76880310 #: c096c887b83b4268997e9a453d25b842 c73fd911a20749508df1d8b19b8c57a3 #: c801277ce33e42a6ba3362f269f6c5ef cba5fb8b9aa44348bf2b7d5390911709 #: cc1324586d194932a0ca2cf16122eef1 d3b56b46642d4641908a8dceea5e5077 #: d6737cec766d4e95b377fd109f9d1285 de95b2f374174e2e8d6060866e4a0f78 #: e124096bc19d4cdcb7b3f234de20c1e1 e2e5c451a119407483e7607b1c5ed9ae #: eaffd1e6736a4720841de28506c4dab6 f0c52cf5e35a4bd8a41f7f68312cd088 #: f2da4f7eb3ee47a9b5c788654cbb1c98 f6fb260e08d34ba8901d564ca14d8199 #: f95dac36543742408e550976f9dad77a ffd730a0dc0a496e88a4ac68c698cc8e msgid "|history_end|" msgstr "" #: ../../page.rst:174 d8ec3873695a46faa388afe6e3743ca3 msgid "" "PDF only: Add a comment icon (\"sticky note\") with accompanying text. " "Only the icon is visible, the accompanying text is hidden and can be " "visualized by many PDF viewers by hovering the mouse over the symbol." msgstr "" "PDFのみ: " "コメントアイコン（「付箋」）を追加し、それに関連するテキストを含めます。アイコンのみが表示され、関連するテキストは非表示で、多くのPDFビューアではアイコンの上にマウスを重ねることで可視化できます。" #: ../../page.rst:176 444f1e5c16ea4352a788a5efd10e1569 msgid "" "the top left point of a 20 x 20 rectangle containing the MuPDF-provided " "\"note\" icon." msgstr "提供されたMuPDFアイコンが含まれる20 x 20の矩形の左上の点。" #: ../../page.rst:178 ba51896b030f4534ac7582b69b2e717d msgid "" "the commentary text. This will be shown on double clicking or hovering " "over the icon. May contain any Latin characters." msgstr "コメントテキスト。これはダブルクリックまたはアイコンの上にカーソルを合わせることで表示されます。ラテン文字を含むことができます。" #: ../../page.rst:179 fcd4a7236e1246889d7569f393c0061e msgid "" "choose one of \"Note\" (default), \"Comment\", \"Help\", \"Insert\", " "\"Key\", \"NewParagraph\", \"Paragraph\" as the visual symbol for the " "embodied text [#f4]_. (New in v1.16.0)" msgstr "" "*（v1.16.0で新規追加）* " "\"Note\"（デフォルト）、\"Comment\"、\"Help\"、\"Insert\"、\"Key\"、\"NewParagraph\"、\"Paragraph\"" " のいずれかを、具体的なテキストの視覚的なシンボルとして選択してください。 [#f4]_" #: ../../page.rst:182 00b05d93137644ecae6d4d1ab0d1942c msgid "" "the created annotation. Stroke color yellow = (1, 1, 0), no fill color " "support." msgstr "作成された注釈。ストロークカラーは黄色（1, 1, 0）、塗りつぶしカラーのサポートはありません。" #: ../../page.rst:202 da81bd77253c4a21b14cc4130621cc52 msgid "" "PDF only: Add text in a given rectangle. Optionally, the appearance of a " "\"callout\" shape can be requested by specifying two or three point-like " "objects -- see below." msgstr "" #: ../../page.rst:204 5f99d477c3e745cf8ec1e4a0ff35d8c5 #, fuzzy msgid "" "the rectangle into which the text should be inserted. Text is " "automatically wrapped to a new line at box width. Text portions not " "fitting into the rectangle will be invisible without warning." msgstr "テキストを挿入する矩形。テキストはボックスの幅で自動的に改行されます。ボックスに収まらない行は見えません。" #: ../../page.rst:206 e5b43ec9291c4d949b0f2cd507783ddd msgid "" "the text. May contain any mixture of Latin, Greek, Cyrillic, Chinese, " "Japanese and Korean characters. If `richtext=True` (see below), the " "string is interpreted as HTML syntax. This adds a plethora of ways for " "attractive effects." msgstr "" #: ../../page.rst:208 1b209d97cea54825a17f2e38b4c1f41f #, fuzzy msgid "the :data:`fontsize`. Default is 11. Ignored if `richtext=True`." msgstr ":data:`fontsize`。デフォルトは12です。" #: ../../page.rst:210 c6363a1c3e3844dda24dce395cde51d4 msgid "" "The font name. Default is \"Helv\". Ignored if `richtext=True`, otherwise" " the following **restritions apply:** * Accepted alternatives are " "\"Helv\" (Helvetica), \"Cour\" (Courier), \"TiRo\" (Timnes-Roman), " "\"ZaDb\" (ZapfDingBats) and \"Symb\" (Symbol). The name may be " "abbreviated to the first two characters, like \"Co\" for \"Cour\", lower " "case accepted. * Bold or italic variants of the fonts are **not " "supported.**" msgstr "" #: ../../page.rst:210 8bccdef5bfa349ac8cc4a0b0df77d779 msgid "" "The font name. Default is \"Helv\". Ignored if `richtext=True`, otherwise" " the following **restritions apply:**" msgstr "" #: ../../page.rst:212 36e99423c0944ce5b4cb2ed37304d148 msgid "" "Accepted alternatives are \"Helv\" (Helvetica), \"Cour\" (Courier), " "\"TiRo\" (Timnes-Roman), \"ZaDb\" (ZapfDingBats) and \"Symb\" (Symbol). " "The name may be abbreviated to the first two characters, like \"Co\" for " "\"Cour\", lower case accepted." msgstr "" #: ../../page.rst:214 ef7c988255f8408693dcd893daee5569 msgid "Bold or italic variants of the fonts are **not supported.**" msgstr "" #: ../../page.rst:216 272d5192e6a54a489f66fa6362549341 #, fuzzy msgid "the text color. Default is black. Ignored if `richtext=True`." msgstr "テキストの色。デフォルトは黒です。(v1.16.0で新規追加)" #: ../../page.rst:218 af477130273e4b5fa28d9e37245755e8 msgid "" "the fill color. This is used for ``rect`` and the end point of the " "callout lines when applicable. Default is ``None``." msgstr "" #: ../../page.rst:220 4d76d5a8790d4b839bd983dd6ec9d77c msgid "" "This parameter **only has an effect** if `richtext=True`. Otherwise, " "``text_color`` is used." msgstr "" #: ../../page.rst:222 e0f1c549358349d0a0f8708295f71f6f msgid "" "the width of border and ``callout`` lines. Default is 0 (no border), in " "which case callout lines may still appear with some hairline width, " "depending on the PDF viewer used. In any case, this value must be " "positive to see a border line." msgstr "" #: ../../page.rst:224 b03d77e2b6b64e91aa9ddd2c3b69b614 msgid "" "a list of floats specifying how border and callout lines should be " "dashed. Default is ``None``." msgstr "" #: ../../page.rst:226 9289999654b34275b118b35ca71befbd msgid "" "a list / tuple of two or three :data:`point_like` objects, which will be " "interpreted as end point [, knee point] and start point (in this " "sequence) of up to two line segments, converting this annotation into a " "call-out shape." msgstr "" #: ../../page.rst:228 22ed97f9b1574b94babadcefb21d3b01 msgid "" "the line end symbol of the call-out line. It is drawn at the first point " "specified in the `callout` list. Default is an open arrow. For possible " "values see :ref:`AnnotationLineEnds`." msgstr "" #: ../../page.rst:230 c35ad9a2509141878cedbb95c593fe7b msgid "" "a float `0 <= opacity < 1` turning the annotation transparent. Default is" " no transparency." msgstr "" #: ../../page.rst:232 37a763be7bad491cb45931b9429c4c68 msgid "" "text alignment, one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " "TEXT_ALIGN_RIGHT - justify is **not supported**. Ignored if " "`richtext=True`." msgstr "" #: ../../page.rst:234 a37c990e9bf349eaba83f81515bc08c1 #, fuzzy msgid "" "the text orientation. Accepted values are integer multiples of 90°. " "Invalid entries receive a rotation of 0." msgstr "テキストの向き。受け入れられる値は0、90、270で、無効なエントリはゼロに設定されます。" #: ../../page.rst:236 6d3d35985f8548eab9441accfbadfd21 msgid "" "treat ``text`` as HTML syntax. This allows to achieve **bold**, *italic*," " arbitrary text colors, font sizes, text alignment including justify and " "more - as far as the PDF subset of HTML and styling instructions supports" " this. This is similar to what happens in :meth:`Page.insert_htmlbox`. " "The base library will for example pull in required fonts if it encounters" " characters not contained in the standard ones. Some parameters are " "ignored if this option is set, as mentioned above. Default is ``False``." msgstr "" #: ../../page.rst:238 24105781e9b74f28961a17ef0741d795 msgid "" "supply optional HTML styling information in CSS syntax. Ignored if " "`richtext=False`." msgstr "" #: ../../page.rst:241 e19d564ac39043ba9412a1833b016354 #, fuzzy msgid "the created annotation." msgstr "ウィジェットアノテーション。" #: ../../page.rst:245 cb932ff975034cf5a46ebce5a3d5fef3 msgid "Changed in v1.19.6: add border color parameter" msgstr "v1.19.6で変更：境界色パラメータを追加" #: ../../page.rst:251 d9ffc94d2383440f958329808b2ed6c3 msgid "" "PDF only: Add a file attachment annotation with a \"PushPin\" icon at the" " specified location." msgstr "PDFのみ: 指定された場所に「PushPin」アイコンを持つファイル添付注釈を追加します。" #: ../../page.rst:253 7850850451ec4c9097b96541fdc27394 msgid "" "the top-left point of a 18x18 rectangle containing the MuPDF-provided " "\"PushPin\" icon." msgstr "ムPDFで提供される「PushPin」アイコンを含む18x18の四角形の左上のポイント。" #: ../../page.rst:255 acfe93b4198344eda02d7a03b353ca77 #, fuzzy msgid "" "the data to be stored (actual file content, any data, etc.). Changed in " "v1.14.13: *io.BytesIO* is now also supported." msgstr "格納するデータ（実際のファイルコンテンツ、任意のデータなど）。" #: ../../page.rst:255 2057d907ffcd43ec996b431d8e1bdd4f msgid "the data to be stored (actual file content, any data, etc.)." msgstr "格納するデータ（実際のファイルコンテンツ、任意のデータなど）。" #: ../../page.rst:257 77c6e5d0221f4f609584f3422eb787ea msgid "Changed in v1.14.13: *io.BytesIO* is now also supported." msgstr "v1.14.13で変更: *io.BytesIO* もサポートされるようになりました。" #: ../../page.rst:259 39073228b9ad4c41a7d61973ff451f7f msgid "the filename to associate with the data." msgstr "データに関連付けるファイル名。" #: ../../page.rst:260 41da9cdaf23648b68c9a78554a1290b4 msgid "the optional PDF unicode version of filename. Defaults to filename." msgstr "ファイルのPDF Unicodeバージョンのオプション。デフォルトはファイル名です。" #: ../../page.rst:261 12cc7d8353a347bbb77ac0a487196e29 msgid "an optional description of the file. Defaults to filename." msgstr "ファイルのオプションの説明。デフォルトはファイル名です。" #: ../../page.rst:262 8c253c5f387245ef8decce89d2c40230 msgid "" "choose one of \"PushPin\" (default), \"Graph\", \"Paperclip\", \"Tag\" as" " the visual symbol for the attached data [#f4]_. (New in v1.16.0)" msgstr "" "v1.16.0で新しく追加された）添付データの視覚的なシンボルとして、次のいずれかを選択します。\"PushPin\"（デフォルト）、\"Graph\"、\"Paperclip\"、\"Tag\"" " [#f4]_。" #: ../../page.rst:265 5d93a52505284c3eab585fcea69a39c4 msgid "" "the created annotation. Stroke color yellow = (1, 1, 0), no fill color " "support." msgstr "作成された注釈。線の色は黄色（1, 1, 0）、塗りつぶしのサポートはありません。" #: ../../page.rst:269 b5bdde79e584483899f7f79e214ff8bd msgid "PDF only: Add a \"freehand\" scribble annotation." msgstr "PDFのみ: \"freehand\"の落書き注釈を追加します。" #: ../../page.rst:271 0e40df92c5674ec487c4a9919ab386b7 msgid "" "a list of one or more lists, each containing :data:`point_like` items. " "Each item in these sublists is interpreted as a :ref:`Point` through " "which a connecting line is drawn. Separate sublists thus represent " "separate drawing lines." msgstr "" "1つまたは複数のリストからなり、それぞれが :data:`point_like` " "アイテムを含むリストの1つです。これらのサブリスト内の各アイテムは、接続された線が描画される :ref:`Point` " "として解釈されます。したがって、個々のサブリストは別々の描画ラインを表します。" #: ../../page.rst:274 8e3f7652ecd14f8c8c052fed6fcf46f3 msgid "" "the created annotation in default appearance black =(0, 0, 0),line width " "1. No fill color support." msgstr "作成された注釈はデフォルトの外観で黒色（0, 0, 0）で、線の幅は1です。塗りつぶしのサポートはありません。" #: ../../page.rst:278 b86f901fd3ad4d71a03591ec9cd6df54 msgid "PDF only: Add a line annotation." msgstr "PDFのみ: 直線注釈を追加します。" #: ../../page.rst:280 68b283c40be64dab874b8a80425794b5 msgid "the starting point of the line." msgstr "直線の開始点。" #: ../../page.rst:282 0d2d2c2792b045a0815b8c65212644da msgid "the end point of the line." msgstr "直線の終点。" #: ../../page.rst:285 ba6653fa181c4c5c908a5f2ceac4386d msgid "" "the created annotation. It is drawn with line (stroke) color red = (1, 0," " 0) and line width 1. No fill color support. The **annot rectangle** is " "automatically created to contain both points, each one surrounded by a " "circle of radius 3 * line width to make room for any line end symbols." msgstr "" "作成された注釈。線（ストローク）の色は赤色（1, 0, 0）で、線の幅は1です。塗りつぶしのサポートはありません。**アノテーションの四角形** " "は、各点を囲む半径 3 * 線幅の円で作成され、各点の周りにシンボルの線の終わりのためのスペースを確保します。" #: ../../page.rst:291 9dbfa38e942545b2a0abc3c2d0b1945a msgid "PDF only: Add a rectangle, resp. circle annotation." msgstr "PDFのみ: 長方形、または円の注釈を追加します。" #: ../../page.rst:293 c0d788aeb5e84abea2f2313cc9512956 msgid "" "the rectangle in which the circle or rectangle is drawn, must be finite " "and not empty. If the rectangle is not equal-sided, an ellipse is drawn." msgstr "円または長方形が描かれる矩形。有限で空でない必要があります。矩形が正方形でない場合、楕円が描画されます。" #: ../../page.rst:296 dee1374ec0114b3cab8a319b08afaa42 msgid "" "the created annotation. It is drawn with line (stroke) color red = (1, 0," " 0), line width 1, fill color is supported." msgstr "作成された注釈。線（ストローク）の色は赤色（1、0、0）、線の幅は1で、塗りつぶしのサポートがあります" #: ../../page.rst:301 64d43e8d6be3414694bba69efaee620a msgid "Redactions" msgstr "" #: ../../page.rst:305 a84361a8bc454638a5382f3b141486ef #, fuzzy msgid "" "**PDF only**: Add a redaction annotation. A redaction annotation " "identifies an area whose content should be removed from the document. " "Adding such an annotation is the first of two steps. It makes visible " "what will be removed in the subsequent step, " ":meth:`Page.apply_redactions`." msgstr "" "**PDFのみ** " "：赤塗り注釈を追加します。赤塗り注釈は、文書から削除されるコンテンツを識別します。このような注釈を追加することは、2つの手順の最初です。次の手順、:meth:`Page.apply_redactions`" " で削除される内容を可視化します。" #: ../../page.rst:307 5dac4a2ac6394fc99f25e30413c301da msgid "" "specifies the (rectangular) area to be removed which is always equal to " "the annotation rectangle. This may be a :data:`rect_like` or " ":data:`quad_like` object. If a quad is specified, then the enveloping " "rectangle is taken." msgstr "常に注釈の矩形と等しい削除する領域を指定します。これはrect_likeまたはquad_likeオブジェクトである必要があります。四角形が指定された場合、包括的な矩形が取られます。" #: ../../page.rst:309 4d76e403896a4b05b4f4abebe01e0204 msgid "" "text to be placed in the rectangle after applying the redaction (and thus" " removing old content). (New in v1.16.12)" msgstr "*(v1.16.12で新機能)* 赤字を適用した後に矩形に配置するテキスト（従って古いコンテンツを削除します）。" #: ../../page.rst:311 1f18c3b53454466c85cd51ab44ed410d msgid "" "the font to use when ``text`` is given, otherwise ignored. Only CJK and " "the :ref:`Base-14-Fonts` are supported. Apart from this, the same rules " "apply as for :meth:`Page.insert_textbox` -- which is what the method " ":meth:`Page.apply_redactions` internally invokes." msgstr "" #: ../../page.rst:313 15e6fd75902e4d668d2c53ce39c6612b msgid "" "the :data:`fontsize` to use for the replacing text. If the text is too " "large to fit, several insertion attempts will be made, gradually reducing" " the :data:`fontsize` to no less than 4. If then the text will still not " "fit, no text insertion will take place at all. (New in v1.16.12)" msgstr "" "置換テキストに使用する :data:`fontsize` 。テキストが大きすぎて収まらない場合、:data:`fontsize` " "を4未満にならないように徐々に縮小して、複数の挿入試行が行われます。その後もテキストが収まらない場合、テキストの挿入は行われません。 " "(v1.16.12 で新規追加)" #: ../../page.rst:315 c037bef2ae914aac887186cb50012cc1 #, fuzzy msgid "" "the horizontal alignment for the replacing text. See " ":meth:`insert_textbox` for available values. The vertical alignment is " "(approximately) centered." msgstr "" "置換テキストの水平配置です。使用可能な値については、:meth:`insert_textbox` " "を参照してください。PDFの組み込みフォント（CJKまたは :ref:`Base-14-Fonts` " "）を使用する場合、垂直配置は（おおよそ）中央になります。 (v1.16.12で新規)" #: ../../page.rst:317 8f310d455d444b068857a16bcdfc4f51 msgid "" "the fill color of the rectangle **after applying** the redaction. The " "default is *white = (1, 1, 1)*, which is also taken if ``None`` is " "specified. To suppress a fill color altogether, specify ``False``. In " "this cases the rectangle remains transparent. (New in v1.16.12)" msgstr "" "**適用後** の赤塗りの四角形の塗りつぶし色です。デフォルトは *white = (1, 1, 1)* で、``None`` " "が指定された場合も同様です。塗りつぶし色を抑制するには、``False`` " "を指定します。この場合、四角形は透明のままです。（v1.16.12で新規追加）" #: ../../page.rst:319 f812c2b775b04ee1b3c04c57cbebaed0 msgid "" "the color of the replacing text. Default is *black = (0, 0, 0)*. (New in " "v1.16.12)" msgstr "*(新機能 v1.16.12)* 置換テキストの色です。デフォルトは *black = (0, 0, 0)* です。" #: ../../page.rst:321 a2ae0126926c491abf40d2a1c2b0a3f8 msgid "add two diagonal lines to the annotation rectangle. (New in v1.17.2)" msgstr "*(新機能 v1.17.2)* アノテーションの矩形に2つの対角線を追加します。" #: ../../page.rst:324 6d7e478605e94dbc8eb4b0b84e535142 msgid "" "the created annotation. Its standard appearance looks like a red " "rectangle (no fill color), optionally showing two diagonal lines. Colors," " line width, dashing, opacity and blend mode can now be set and applied " "via :meth:`Annot.update` like with other annotations. (Changed in " "v1.17.2)" msgstr "" "作成された注釈です。その標準的な外観は、赤い四角形（塗りつぶし色なし）であり、必要に応じて二つの対角線を表示します。色、線の太さ、破線、不透明度、およびブレンドモードは、他の注釈と同様に、:meth:`Annot.update`" " を介して設定および適用できます。（v1.17.2で変更）" #: ../../page.rst:330 ../../page.rst:370 185241df5ccf4107bb94ed75536d2869 #: 3f492500f5c74544b8191d63b72a7f35 msgid "New in v1.16.11" msgstr "新機能 v1.16.11" #: ../../page.rst:337 865d86b155654e3d97b02053e505d379 #, fuzzy msgid "" "**PDF only**: Remove all **content** contained in any redaction rectangle" " on the page." msgstr "PDFのみ：赤塗りの矩形に含まれるすべての **テキストコンテンツ** を削除します。" #: ../../page.rst:339 e78a9bf11c1c4ad2bbb5c21f5af5e49a msgid "**This method applies and then deletes all redactions from the page.**" msgstr "**このメソッドは、ページからすべての赤塗りを適用して削除します。**" #: ../../page.rst:341 09073582e1e649d382d2a335dd82d782 msgid "" "How to redact overlapping images. The default (2) blanks out overlapping " "pixels. `PDF_REDACT_IMAGE_NONE | 0` ignores, and `PDF_REDACT_IMAGE_REMOVE" " | 1` completely removes images overlapping any redaction annotation. " "Option `PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE | 3` only removes images" " that are actually visible." msgstr "" "重なる画像をレダクトする方法。デフォルトの（2）は、重なるピクセルを空白にします。 `PDF_REDACT_IMAGE_NONE | 0` " "は無視し、 `PDF_REDACT_IMAGE_REMOVE | 1` は、いずれかのレダクション注釈と重なる画像を完全に削除します。オプション" " `PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE | 3` は、実際に見える画像のみを削除します。" #: ../../page.rst:343 f11b640439064a57804428691b95557c #, fuzzy, python-format msgid "" "How to redact overlapping vector graphics (also called \"line-art\" or " "\"drawings\"). The default (2) removes any overlapping vector graphics. " "`PDF_REDACT_LINE_ART_NONE | 0` ignores, and " "`PDF_REDACT_LINE_ART_REMOVE_IF_COVERED | 1` removes graphics fully " "contained in a redaction annotation. When removing line-art, please be " "aware that **stroked** vector graphics (i.e. type \"s\" or \"sf\") have a" " **larger wrapping rectangle** than one might expect: first of all, at " "least 50% of the path's line width have to be added in each direction to " "truly include all of the drawing. If a so-called \"miter limit\" is " "provided (see page 121 of the PDF specification), the enlarging value is " "`miter * width / 2`. So, when letting everything default (width = 1, " "miter = 10), the redaction rectangle should be at least 5 points larger " "in every direction." msgstr "" "重なるベクトルグラフィックス（または「ラインアート」や「図面」とも呼ばれる）を塗りつぶす方法。デフォルト値（2）では、重なるベクトルグラフィックスがすべて削除されます。`PDF_REDACT_LINE_ART_NONE" " | 0` は無視し、`PDF_REDACT_LINE_ART_IF_COVERED | 1` " "は、赤塗り注釈に完全に含まれるグラフィックスを削除します。ラインアートを削除する際は、 **ストロークされた** " "ベクトルグラフィックス（つまりタイプ「s」または「sf」）が、期待される **よりも大きなラッピング長方形** " "を持つことに注意してください：まず第一に、パスの線幅の少なくとも50％を、各方向に追加する必要があります。描画のすべてを含めるため。所謂「マイターリミット」が提供されている場合（PDF仕様書の121ページを参照）、拡大値は" " `miter * width / " "2`.です。すべてをデフォルト値（幅＝1、マイター＝10）にする場合、赤塗りの長方形は各方向に少なくとも5ポイント大きくする必要があります。" #: ../../page.rst:345 b62537b48f434247b1f5f7043574b596 msgid "" "Whether to redact overlapping text. The default `PDF_REDACT_TEXT_REMOVE |" " 0` removes all characters whose boundary box overlaps any redaction " "rectangle. This complies with the original legal / data protection " "intentions of redaction annotations. Other use cases however may require " "to **keep text** while redacting vector graphics or images. This can be " "achieved by setting `text=True|PDF_REDACT_TEXT_NONE | 1`. This does **not" " comply** with the data protection intentions of redaction annotations. " "**Do so at your own risk.**" msgstr "" "重なるテキストを塗りつぶすかどうかを指定します。デフォルトでは、`PDF_REDACT_TEXT_REMOVE | 0` " "は、境界ボックスが赤塗り四角形と重なるすべての文字を削除します。これは、元の法的/データ保護の意図に適合しています。ただし、他のユースケースでは、ベクトルグラフィックスや画像を赤塗りする一方で**テキストを保持**する必要がある場合があります。これは、`text=True|PDF_REDACT_TEXT_NONE" " | 1` を設定することで実現できます。これは、赤塗り注釈のデータ保護の意図には適合していませんので、自己責任で行ってください。" #: ../../page.rst:347 1aba7daeb2cd4a4ca3d5d9e6f3c074fa msgid "" "`True` if at least one redaction annotation has been processed, `False` " "otherwise." msgstr "少なくとも1つの赤字注釈が処理された場合は ``True``、それ以外の場合は ``False``。" #: ../../page.rst:350 1b977b6ed04246c3ae5faf3f785569f1 msgid "" "Text contained in a redaction rectangle will be **physically** removed " "from the page (assuming :meth:`Document.save` with a suitable garbage " "option) and will no longer appear in e.g. text extractions or anywhere " "else. All redaction annotations will also be removed. Other annotations " "are unaffected." msgstr "" "赤塗りの四角に含まれるテキストは、**物理的に** " "ページから削除されます（適切なゴミオプションを使用したDocument.save()の場合）、テキスト抽出などの場所にはもはや表示されません。また、すべての赤塗りの注釈も削除されます。他の注釈には影響しません。" #: ../../page.rst:352 487f11ac3e46441faf9dd99f32447379 msgid "" "All overlapping links will be removed. If the rectangle of the link was " "covering text, then only the overlapping part of the text is being " "removed. Similar applies to images covered by link rectangles." msgstr "重なっているすべてのリンクは削除されます。リンクの四角がテキストを覆っている場合、テキストの重なる部分のみが削除されます。画像もリンクの四角によってカバーされている場合、同様のことが適用されます。" #: ../../page.rst:354 8e50b4b5fe0b444aa2b5fda22df95a93 msgid "" "The overlapping parts of **images** will be blanked-out for default " "option `PDF_REDACT_IMAGE_PIXELS` (changed in v1.18.0). Option 0 does not " "touch any images and 1 will remove any image with an overlap." msgstr "" "**画像** の重なり部分は、デフォルトのオプションである `PDF_REDACT_IMAGE_PIXELS` " "では塗りつぶされます（v1.18.0で変更されました）。オプション0は画像を一切変更せず、1は重なり合う画像をすべて削除します。" #: ../../page.rst:356 6a9f7ffec9fa4701a8c230e0944d5de8 msgid "" "For option `images=PDF_REDACT_IMAGE_REMOVE` only this page's **references" " to the images** are removed - not necessarily the images themselves. " "Images are completely removed from the file only, if no longer referenced" " at all (assuming suitable garbage collection options)." msgstr "" "`images=PDF_REDACT_IMAGE_REMOVE` のオプションの場合、このページの **画像への参照** " "のみが削除されます。適切なゴミ収集オプションがあると、画像はファイルから完全に削除されます。" #: ../../page.rst:358 e4034acfd25f4158a32e53879651c689 msgid "" "For option `images=PDF_REDACT_IMAGE_PIXELS` a new image of format PNG is " "created, which the page will use in place of the original one. The " "original image is not deleted or replaced as part of this process, so " "other pages may still show the original. In addition, the new, modified " "PNG image currently is **stored uncompressed**. Do keep these aspects in " "mind when choosing the right garbage collection method and compression " "options during save." msgstr "" "`images=PDF_REDACT_IMAGE_PIXELS` " "のオプションでは、新しいPNG形式の画像が作成され、ページは元の画像の代わりにそれを使用します。このプロセスの一環として、元の画像は削除されず、他のページでは引き続き元の画像が表示される可能性があります。さらに、新しい変更されたPNG画像は現在" " **圧縮されていない状態で保存されています** 。保存時に適切なゴミ収集メソッドと圧縮オプションを選択する際に、これらの側面を考慮してください。" #: ../../page.rst:360 dc47a452593a4cb3a3e131031f5730d7 msgid "" "**Text removal** is done by character: A character is removed if its bbox" " has a **non-empty overlap** with a redaction rectangle (changed in MuPDF" " v1.17). Depending on the font properties and / or the chosen line " "height, deletion may occur for undesired text parts. Using " ":meth:`Tools.set_small_glyph_heights` with a ``True`` argument before " "text search may help to prevent this." msgstr "" "**テキストの削除** は文字ごとに行われます：文字のbboxが赤塗りの四角と非空の重なりを持つ場合、文字が削除されます（MuPDF " "v1.17で変更）。フォントの特性や選択した行の高さに応じて、望ましくないテキスト部分が削除される場合があります。テキスト検索前に " ":meth:`Tools.set_small_glyph_heights` を ``True`` " "引数で使用して、これを防ぐのに役立つ場合があります。" #: ../../page.rst:362 ee9e385dfb9447b8a537d61b2365d03f msgid "" "Redactions are a simple way to replace single words in a PDF, or to just " "physically remove them. Locate the word \"secret\" using some text " "extraction or search method and insert a redaction using \"xxxxxx\" as " "replacement text for each occurrence." msgstr "赤塗りは、PDF内の単語を置き換えるための簡単な方法であり、単語を物理的に削除するためのものです。テキスト抽出または検索方法を使用して単語「秘密」を見つけ、それぞれの出現ごとに代替テキスト「xxxxxx」を使用して赤塗りを挿入します。" #: ../../page.rst:364 aeeaa43dc6f547be81c82b217ea0b35f msgid "" "Be wary if the replacement is longer than the original -- this may lead " "to an awkward appearance, line breaks or no new text at all." msgstr "注意が必要です。代替テキストが元のテキストよりも長い場合、見栄えが悪くなったり、改行が発生したり、新しいテキストがまったく表示されなくなる可能性があるためです。" #: ../../page.rst:366 ea636c09a9924bb8b5646e6dfac446f9 msgid "" "For a number of reasons, the new text may not exactly be positioned on " "the same line like the old one -- especially true if the replacement font" " was not one of CJK or :ref:`Base-14-Fonts`." msgstr "" "いくつかの理由から、新しいテキストは古いテキストとまったく同じ行に配置されないことがあります。特に、代替フォントがCJKまたはPDF " ":ref:`Base-14-Fonts` の場合には特に当てはまります。" #: ../../page.rst:371 3a1768a048d347a4807733013681a35b msgid "" "Changed in v1.16.12: The previous *mark* parameter is gone. Instead, the " "respective rectangles are filled with the individual *fill* color of each" " redaction annotation. If a *text* was given in the annotation, then " ":meth:`insert_textbox` is invoked to insert it, using parameters provided" " with the redaction." msgstr "" "v1.16.12で変更：以前の *mark* " "パラメータは削除されました。代わりに、各赤字注釈の個々の塗りつぶし色で各赤字領域が塗りつぶされます。アノテーションで *text* " "が指定された場合、そのテキストを挿入するために、redactionで提供されたパラメータを使用して :meth:`insert_textbox` " "が呼び出されます。" #: ../../page.rst:372 bb9c6db9f287498290c02c005b04b563 msgid "" "Changed in v1.18.0: added option for handling images that overlap " "redaction areas." msgstr "v1.18.0で変更：赤字領域と重なる画像を処理するためのオプションが追加されました。" #: ../../page.rst:373 3106c488a58e4ee7aebb2137a0641e62 msgid "Changed in v1.23.27: added option for removing graphics as well." msgstr "" #: ../../page.rst:374 14c5c16ae5274f2c93cae93f149bbaac msgid "Changed in v1.24.2: added option `keep_text` to leave text untouched." msgstr "" #: ../../page.rst:384 16a23881460e4301bee92bf2d492116a msgid "" "PDF only: Add an annotation consisting of lines which connect the given " "points. A **Polygon's** first and last points are automatically " "connected, which does not happen for a **PolyLine**. The **rectangle** is" " automatically created as the smallest rectangle containing the points, " "each one surrounded by a circle of radius 3 (= 3 * line width). The " "following shows a 'PolyLine' that has been modified with colors and line " "ends." msgstr "" "PDFのみ：指定されたポイントを接続する線から成る注釈を追加します。多角形 **（Polygon）** " "の最初と最後のポイントは自動的に接続されますが、**PolyLine** ではそれが発生しません。各ポイントは半径3の円で囲まれた最小の " "**四角形** として自動的に作成されます（半径3 = 3 * 線の幅）。以下は、色や線端を変更した「PolyLine」の例を示しています。" #: ../../page.rst:386 48e0dcb2eacd42a58db10f609be72065 msgid "a list of :data:`point_like` objects." msgstr "points（list）– :data:`point_like` オブジェクトのリスト。" #: ../../page.rst:389 ffc26708d41548e79d6d16bef4dec96c msgid "" "the created annotation. It is drawn with line color black, line width 1 " "no fill color but fill color support. Use methods of :ref:`Annot` to make" " any changes to achieve something like this:" msgstr "" "作成されたアノテーションです。線の色は黒で描画され、線の幅は1で、塗りつぶし色はサポートされています。このような外見を実現するために、:ref:`Annot`" " のメソッドを使用して変更を加えることができます。" #: ../../page.rst:402 77481744eb7b4202a73407869d31200a msgid "" "PDF only: These annotations are normally used for **marking text** which " "has previously been somehow located (for example via " ":meth:`Page.search_for`). But this is not required: you are free to " "\"mark\" just anything." msgstr "" "PDFのみ: これらのアノテーションは通常、以前に何らかの方法で見つかったテキスト（たとえば、:meth:`Page.search_for` " "を使用して）をマーキングするために使用されます。ただし、これは必須ではありません：何でも「マーク」することができます。" #: ../../page.rst:404 8b9c2a1ec12243d584aa92eb85b61fe6 msgid "" "Standard (stroke only -- no fill color support) colors are chosen per " "annotation type: **yellow** for highlighting, **red** for striking out, " "**green** for underlining, and **magenta** for wavy underlining." msgstr "" "通常、アノテーションの種類ごとに標準の（ストロークのみで、塗りつぶし色はサポートされていません）色が選択されます。ハイライト用に " "**黄色**、取り消し線用に **赤色**、下線用に **緑色**、波線下線用に **マゼンタ色** です。" #: ../../page.rst:406 ddb3fc3897074943b2d1b989ef777ed7 msgid "" "All these four methods convert the arguments into a list of :ref:`Quad` " "objects. The **annotation** rectangle is then calculated to envelop all " "these quadrilaterals." msgstr "" "これらの四つのメソッドは、引数を :ref:`Quad` オブジェクトのリストに変換します。その後、アノテーション " "の矩形は、これらの四角形を包含するように計算されます。" #: ../../page.rst:410 e5e7ecd7dac94d878780bcbf4ccf47ee msgid "" ":meth:`search_for` delivers a list of either :ref:`Rect` or :ref:`Quad` " "objects. Such a list can be directly used as an argument for these " "annotation types and will deliver **one common annotation** for all " "occurrences of the search string::" msgstr "" ":meth:`search_for` は :ref:`Rect` または :ref:`Quad` " "オブジェクトのリストを返します。このようなリストは、これらのアノテーションタイプの引数として直接使用でき、検索文字列のすべての出現に対して " "**共通のアノテーション** を提供します::" #: ../../page.rst:417 be498e99e49f4a21b7e2148a246e5d3a msgid "" "Obviously, text marker annotations need to know what is the top, the " "bottom, the left, and the right side of the area(s) to be marked. If the " "arguments are quads, this information is given by the sequence of the " "quad points. In contrast, a rectangle delivers much less information -- " "this is illustrated by the fact, that 4! = 24 different quads can be " "constructed with the four corners of a rectangle." msgstr "" "明らかに、テキストマーカーアノテーションは、マークされる領域の上部、下部、左部、右部が何であるかを知る必要があります。引数がquadsの場合、この情報は四角形のポイントのシーケンスによって提供されます。対照的に、矩形ははるかに少ない情報を提供します" " - これは、四角形の四つの角を使用して24の異なる四角形が構築できるという事実によって示されています。" #: ../../page.rst:419 7c806b98a76e4db298927d6b2db7f217 msgid "" "Therefore, we **strongly recommend** to use the `quads` option for text " "searches, to ensure correct annotations. A similar consideration applies " "to marking **text spans** extracted with the \"dict\" / \"rawdict\" " "options of :meth:`Page.get_text`. For more details on how to compute " "quadrilaterals in this case, see section \"How to Mark Non-horizontal " "Text\" of :ref:`FAQ`." msgstr "" "したがって、正しいアノテーションを確保するために、テキスト検索に `quads` オプションを使用することを " "**強くお勧めします**。同様の考慮事項は、:meth:`Page.get_text` の「dict」/「rawdict」オプションで抽出された " "**テキストスパン** をマークする場合にも適用されます。この場合の四角形の計算方法の詳細については、:ref:`FAQ` " "の「非水平テキストのマーキング方法」セクションを参照してください。" #: ../../page.rst:421 b12e854cdc77477bb69cfa7be1147221 msgid "" "the location(s) -- rectangle(s) or quad(s) -- to be marked. (Changed in " "v1.14.20) A list or tuple must consist of :data:`rect_like` or " ":data:`quad_like` items (or even a mixture of either). Every item must be" " finite, convex and not empty (as applicable). **Set this parameter to** " "``None`` if you want to use the following arguments (Changed in " "v1.16.14). And vice versa: if not ``None``, the remaining parameters must" " be ``None``." msgstr "" "*(v1.14.20で変更)* マーキングする位置、つまり矩形または四角形。リストまたはタプルは、:data:`rect_like` または " ":data:`quad_like` " "のアイテム（またはその混合）で構成されている必要があります。各アイテムは、適用可能な限り有限で凸面で空でなければなりません " "*（v1.16.14で変更）* 。このパラメータを ``None`` " "に設定すると、次の引数を使用できるようになります。逆もまたしかり：Noneでない場合、残りのパラメータは ``None`` でなければなりません。" #: ../../page.rst:428 089f510a4e0741409b2021b3736270b5 msgid "" "start text marking at this point. Defaults to the top-left point of " "*clip*. Must be provided if `quads` is ``None``. (New in v1.16.14)" msgstr "" "*(v1.16.14で新規)* このポイントでテキストマーキングを開始します。*clip* の左上のポイントがデフォルトです。`quads` が " "``None`` の場合、提供する必要があります。" #: ../../page.rst:429 d2de277e9e6a43a484c54b51d6ea8199 msgid "" "stop text marking at this point. Defaults to the bottom-right point of " "*clip*. Must be used if `quads` is ``None``. (New in v1.16.14)" msgstr "" "*(v1.16.14で新規)* このポイントでテキストマーキングを停止します。*clip* の右下のポイントがデフォルトです。quadsが " "``None`` の場合、使用する必要があります。" #: ../../page.rst:430 ffbdd0cf15b94a05abb2545b0b56572d msgid "" "only consider text lines intersecting this area. Defaults to the page " "rectangle. Only use if `start` and `stop` are provided. (New in v1.16.14)" msgstr "" "*(v1.16.14で新規)* この領域と交差するテキスト行のみを考慮します。ページの矩形がデフォルトです。`start` および `stop` " "が提供されている場合にのみ使用してください。" #: ../../page.rst:432 95d9be073ec0435b8a050f40e80e333d msgid ":ref:`Annot` or ``None`` (changed in v1.16.14)." msgstr ":ref:`Annot` または *(v1.16.14で変更)* ``None``" #: ../../page.rst:433 7d7542fa5b7c41b6aa27c333c40f1708 msgid "" "the created annotation. If *quads* is an empty list, **no annotation** is" " created (changed in v1.16.14)." msgstr "作成された注釈。 *(v1.16.14で変更)* *quads* が空のリストの場合、**アノテーションは作成されません**。" #: ../../page.rst:436 98644a2344314f44ba04ba5bb452616e msgid "" "You can use parameters *start*, *stop* and *clip* to highlight " "consecutive lines between the points *start* and *stop* (starting with " "v1.16.14). Make use of *clip* to further reduce the selected line bboxes " "and thus deal with e.g. multi-column pages. The following multi-line " "highlight on a page with three text columns was created by specifying the" " two red points and setting clip accordingly." msgstr "" "v1.16.14以降、開始、停止、および *clip* というパラメータを使用して、*start* と *stop* " "の間の連続した行をハイライトできます。*clip* " "を使用して、選択した行のbboxをさらに縮小し、たとえば多列のページを扱うことができます。次の多行のハイライトは、2つの赤いポイントを指定し、それに応じてクリップを設定することによって、3つのテキスト列を持つページに作成されました。" #: ../../page.rst:445 75642278b2224e88a9772fd96d3a3059 msgid "" "Cluster vector graphics (synonyms are line-art or drawings) based on " "their geometrical vicinity. The method walks through the output of " ":meth:`Page.get_drawings` and joins paths whose `path[\"rect\"]` are " "closer to each other than some tolerance values (given in the arguments)." " The result is a list of rectangles that each wrap things like tables " "(with gridlines), pie charts, bar charts, etc." msgstr "" "図形のクラスター（同義語は線画やドローイングです）を、幾何学的な近接性に基づいてグループ化します。このメソッドは、 " ":meth:`Page.get_drawings` の出力を処理し、その中で、`path[\"rect\"]` " "がある許容値（引数で指定された）よりも近いパスを結合します。結果は、各々が表（格子状の線がある）、円グラフ、棒グラフなどのものを包含する長方形のリストです。" #: ../../page.rst:447 8af220b5d116468da1c3a74e2d346cd4 msgid "only consider paths inside this area. The default is the full page." msgstr "only consider paths inside this area. The default is the full page." #: ../../page.rst:449 0f2851c495ca480fb94cd3aec130a7b3 msgid "" "(optional) provide a previously generated output of " ":meth:`Page.get_drawings`. If `None` the method will execute the method." msgstr "（任意）以前に生成された :meth:`Page.get_drawings` の出力を提供します。`None` の場合、メソッドが実行されます。" #: ../../page.rst:451 49e0542c28684b6b903d2d86c7b062a6 msgid "" "Assume vector graphics to be close enough neighbors for belonging to the " "same rectangle. Default is 3 points." msgstr "" #: ../../page.rst:453 ce87a4c4de064cb49cd1d3430b4676d3 msgid "" "If `True` (default), the method will to remove rectangles having width or" " height smaller than the respective tolerance value. If `False` no such " "filtering is done." msgstr "" #: ../../page.rst:457 a09f9aad182c477caf151dc66eb6f2cd msgid "" "Find tables on the page and return an object with related information. " "Typically, the default values of the many parameters will be sufficient. " "Adjustments should ever only be needed in corner case situations." msgstr "ページ上のテーブルを見つけ、関連情報を含むオブジェクトを返します。通常、多くのパラメータのデフォルト値は十分です。調整が必要なのは、極めてまれなケースのみです。" #: ../../page.rst:459 74a611af01fb41deac6b00bf3e092130 msgid "" "specify a region to consider within the page rectangle and ignore the " "rest. Default is the full page." msgstr "ページの長方形内で考慮する領域を指定します。デフォルトはページ全体です。" #: ../../page.rst:461 c6cda0b38ecc4c4ab6b9e66681366f13 msgid "" "Request a **table detection** strategy. Valid values are \"lines\", " "\"lines_strict\" and \"text\". Default is **\"lines\"** which uses all " "vector graphics on the page to detect grid lines. Strategy " "**\"lines_strict\"** ignores borderless rectangle vector graphics. " "Sometimes single text pieces have background colors which may lead to " "false columns or lines. This strategy ignores them and can thus increase " "detection precision. If **\"text\"** is specified, text positions are " "used to generate \"virtual\" column and / or row boundaries. Use " "`min_words_*` to request the number of words for considering their " "coordinates. Use parameters `vertical_strategy` and " "`horizontal_strategy` **instead** for a more fine-grained treatment of " "the dimensions." msgstr "**テーブル検出**戦略をリクエストします。有効な値は、**「lines」**、**「lines_strict」** 、**「text」** です" #: ../../page.rst:461 49dcc16d7dc54781abdfa232abec999e msgid "" "Request a **table detection** strategy. Valid values are \"lines\", " "\"lines_strict\" and \"text\"." msgstr "**テーブル検出**戦略をリクエストします。有効な値は、**「lines」**、**「lines_strict」** 、**「text」** です。" #: ../../page.rst:463 487f50ea618a41b69d1d35e5becc936e msgid "" "Default is **\"lines\"** which uses all vector graphics on the page to " "detect grid lines." msgstr "デフォルトは **「lines」** で、ページ上のすべてのベクトルグラフィックスを使用してグリッド線を検出します。" #: ../../page.rst:465 475d14ec21db4fa5b86f652beb2fa96e msgid "" "Strategy **\"lines_strict\"** ignores borderless rectangle vector " "graphics. Sometimes single text pieces have background colors which may " "lead to false columns or lines. This strategy ignores them and can thus " "increase detection precision." msgstr "" "ストラテジー **「lines_strict」** " "は、境界のない四角形のベクトルグラフィックスを無視します。時には、個々のテキスト部分に背景色があることがあり、これが誤った列や行を生じる可能性があります。この戦略はそれらを無視し、したがって検出精度を向上させることができます。" #: ../../page.rst:467 620ca770d5a84f1f8274b964de8e0a8d msgid "" "If **\"text\"** is specified, text positions are used to generate " "\"virtual\" column and / or row boundaries. Use `min_words_*` to request " "the number of words for considering their coordinates." msgstr "検索アルゴリズムを指定します。デフォルトでは「lines」はベクトル描画を探します。指定された場合、「text」ではテキストの位置を使用して「仮想」列境界を生成します。x座標を考慮するための単語数を指定するには、`min_words_*`を使用します。" #: ../../page.rst:469 55aec1b404204b0e83768215c8eae28d msgid "" "Use parameters `vertical_strategy` and `horizontal_strategy` **instead** " "for a more fine-grained treatment of the dimensions." msgstr "サイズの微調整には、`vertical_strategy` と`horizontal_strategy` パラメータを使用してください。" #: ../../page.rst:471 b57bc9f7abbd4ef9babbe5d0dff06e4d msgid "" "y-coordinates of rows. If provided, there will be no attempt to identify " "additional table rows. This influences table detection." msgstr "行のy座標を含む浮動小数点数のリスト。指定した場合、追加のテーブル行を識別しないようにします。" #: ../../page.rst:473 d7014235e8a2469d8a599a403b70c460 msgid "" "x-coordinates of columns. If provided, there will be no attempt to " "identify additional table columns. This influences table detection." msgstr "列のx座標を含む浮動小数点数のリスト。指定した場合、追加のテーブル列を識別しないようにします。" #: ../../page.rst:475 8597b2d142824c29a8116c7c89749dfa msgid "" "relevant for vertical strategy option \"text\": at least this many words " "must coincide to establish a **virtual column** boundary." msgstr "垂直戦略オプション「text」に関連します。少なくともこの数の単語が一致する必要があり、仮想の列境界を確立します。" #: ../../page.rst:477 1fff3607f10f4335ae8da286bcf1b265 msgid "" "relevant for horizontal strategy option \"text\": at least this many " "words must coincide to establish a **virtual row** boundary." msgstr "水平戦略オプション「text」に関連します。少なくともこの数の単語が一致する必要があり、仮想の行境界を確立します。" #: ../../page.rst:479 fe507763ad9248bbbe7ed10253cf19a6 msgid "" "Any two horizontal lines whose y-values differ by no more than this value" " will be **snapped** into one. Accordingly for vertical lines. Default is" " 3. Separate values can be specified instead for the dimensions, using " "`snap_x_tolerance` and `snap_y_tolerance`." msgstr "" "各縦線は、y値の差がこの値以下であれば、一つに結合されます。同様に、各横線も結合されます。デフォルトは3です。この値の代わりに、次元ごとに異なる値を指定することもできます。`snap_x_tolerance`" " および `snap_y_tolerance` を使用してください。" #: ../../page.rst:481 019d0273cf7b4e5d82a05b28826235ea msgid "" "Any two lines will be **joined** to one if the end and the start points " "differ by no more than this value (in points). Default is 3. Instead of " "this value, separate values can be specified for the dimensions using " "`join_x_tolerance` and `join_y_tolerance`." msgstr "" "2つのラインの終点と始点の間の差がこの値（ポイント単位）以下の場合、それらは1つのラインに **結合されます** " "。デフォルトは3です。この値の代わりに、`join_x_tolerance` と `join_y_tolerance` " "を使用して寸法ごとに別々の値を指定できます。" #: ../../page.rst:483 ca0d9fea67634596941e6d13c7395948 msgid "" "Ignore a line if its length does not exceed this value (points). Default " "is 3." msgstr "この値（ポイント単位）を超えない場合、線を無視します。デフォルトは3です" #: ../../page.rst:485 a638d4f3b5d944a19aa7ef553c1b08f2 msgid "" "When combining lines into cell borders, orthogonal lines must be within " "this value (points) to be considered intersecting. Default is 3. Instead " "of this value, separate values can be specified for the dimensions using " "`intersection_x_tolerance` and `intersection_y_tolerance`." msgstr "" "直交するラインをセルの境界線に結合する際に、それらの直交するラインはこの値（ポイント単位）以内である必要があります。デフォルトは3です。この値の代わりに、次元ごとに個別の値を指定することもできます。`intersection_x_tolerance`" " と `intersection_y_tolerance` を使用します。" #: ../../page.rst:487 9b17ecb26f16435eab08ade1ce87a836 msgid "" "Characters will be combined into words only if their distance is no " "larger than this value (points). Default is 3. Instead of this value, " "separate values can be specified for the dimensions using " "`text_x_tolerance` and `text_y_tolerance`." msgstr "" "文字が単語に結合されるのは、その距離がこの値（ポイント）を超えない場合のみです。デフォルト値は3です。この値の代わりに、次元ごとに別々の値を指定することもできます。`text_x_tolerance`" " と `text_y_tolerance` を使用します。" #: ../../page.rst:489 a6a350a7a75140a7be8ccce2ee4fb8c4 #, fuzzy msgid "" "Specify a list of \"lines\" (i.e. pairs of :data:`point_like` objects) as" " **additional**, \"virtual\" vector graphics. These lines may help with " "table and / or cell detection and will not otherwise influence the " "detection strategy. Especially, in contrast to parameters " "`horizontal_lines` and `vertical_lines`, they will not prevent detecting " "rows or columns in other ways. These lines will be treated exactly like " "\"real\" vector graphics in terms of joining, snapping, intersecting, " "minimum length and containment in the `clip` rectangle. Similarly, lines " "not parallel to any of the coordinate axes will be ignored." msgstr "" "以下のような「lines」（つまり、 :data:`point_like` オブジェクトのペア）のリストを追加の「仮想」ベクトル " "グラフィックスとして指定します。これらの線は、テーブルと/またはセルの検出に役立ち、検出戦略には影響しません。特に、`horizontal_lines`" " と `vertical_lines` " "パラメータとは異なり、これらの線は他の方法で行または列を検出するのを妨げません。これらの線は、結合、スナップ、交差、最小長、およびクリップ矩形内への含有の点で、「実際の」ベクトル" " グラフィックスとまったく同様に処理されます。同様に、座標軸のいずれかに平行でない線は無視されます。" #: ../../page.rst:491 2de25b9194a945d9b22879d826f9d4fd #, fuzzy msgid "" "Specify a list of rectangles (:data:`rect_like` objects) as " "**additional**, \"virtual\" vector graphics. These rectangles may help " "with table and / or cell detection and will not otherwise influence the " "detection strategy. Especially, in contrast to parameters " "`horizontal_lines` and `vertical_lines`, they will not prevent detecting " "rows or columns in other ways. These rectangles will be treated exactly " "like \"real\" vector graphics in terms of joining, snapping, " "intersecting, minimum length and containment in the `clip` rectangle." msgstr "" "以下のような「lines」（つまり、 :data:`point_like` オブジェクトのペア）のリストを追加の「仮想」ベクトル " "グラフィックスとして指定します。これらの線は、テーブルと/またはセルの検出に役立ち、検出戦略には影響しません。特に、`horizontal_lines`" " と `vertical_lines` " "パラメータとは異なり、これらの線は他の方法で行または列を検出するのを妨げません。これらの線は、結合、スナップ、交差、最小長、およびクリップ矩形内への含有の点で、「実際の」ベクトル" " グラフィックスとまったく同様に処理されます。同様に、座標軸のいずれかに平行でない線は無視されます。" #: ../../page.rst:493 c824c246b4444d25905dca68201a67e6 msgid "" "list of vector graphics in the format as returned be " ":meth:`Page.get_drawings`. Using this parameter will prevent the method " "to extract vector graphics itself. This is useful if the vector graphics " "are already available. This can save execution time significantly." msgstr "" #: ../../page.rst:497 f04ba862cde54466baab8d1b6048b4a5 msgid "" "a `TableFinder` object that has the following significant attributes: * " "`cells`: a list of **all bboxes** on the page, that have been identified " "as table cells (across all tables). Each cell is a :data:`rect_like` " "tuple `(x0, y0, x1, y1)` of coordinates or `None`. * `tables`: a list of " "`Table` objects. This is `[]` if the page has no tables. Single tables " "can be found as items of this list. But the `TableFinder` object itself " "is also a sequence of its tables. This means that if `tabs` is a " "`TableFinder` object, then table \"n\" is delivered by `tabs.tables[n]` " "as well as by the shorter `tabs[n]`. * The `Table` object has the " "following attributes: * ``bbox``: the bounding box of the table as a " "tuple `(x0, y0, x1, y1)`. * ``cells``: bounding boxes of the table's " "cells (list of tuples). A cell may also be `None`. * ``extract()``: " "this method returns the text content of each table cell as a list of list" " of strings. * ``to_markdown()``: this method returns the table as a " "**string in markdown format** (compatible to Github). Markdown viewers " "can render the string as a table. This output is optimized for **small " "token** sizes, which is especially beneficial for LLM/RAG feeds. Pandas " "DataFrames (see method `to_pandas()` below) offer an equivalent markdown " "table output which however is better readable for the human eye. Any line" " breaks (``\\n``) in cells are replaced by HTML line breaks tags `
`." " * `to_pandas()`: this method returns the table as a `pandas " "`_ `DataFrame " "`_. DataFrames are " "very versatile objects allowing a plethora of table manipulation methods " "and outputs to almost 20 well-known formats, among them Excel files, CSV," " JSON, markdown-formatted tables and more. `DataFrame.to_markdown()` " "generates a Github-compatible markdown format optimized for human " "readability. This method however requires the package `tabulate " "`_ to be installed in addition to " "pandas itself. * ``header``: a `TableHeader` object containing header " "information of the table. * ``col_count``: an integer containing the " "number of table columns. * ``row_count``: an integer containing the " "number of table rows. * ``rows``: a list of `TableRow` objects " "containing two attributes, ``bbox`` is the boundary box of the row, and " "`cells` is a list of table cells contained in this row. * The " "`TableHeader` object has the following attributes: * ``bbox``: the " "bounding box of the header. * `cells`: a list of bounding boxes " "containing the name of the respective column. * `names`: a list of " "strings containing the text of each of the cell bboxes. They represent " "the column names -- which are used when exporting the table to pandas " "DataFrames, markdown, etc. * `external`: a bool indicating whether the " "header bbox is outside the table body (`True`) or not. Table headers are " "never identified by the `TableFinder` logic. Therefore, if `external` is " "true, then the header cells are not part of any cell identified by " "`TableFinder`. If `external == False`, then the first table row is the " "header. Please have a look at these `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages. .. caution:: The " "lifetime of the `TableFinder` object, as well as that of all its tables " "**equals the lifetime of the page**. If the page object is deleted or " "reassigned, all tables are no longer valid. The only way to keep " "table content beyond the page's availability is to **extract it** via " "methods `Table.to_markdown()`, `Table.to_pandas()` or a copy of " "`Table.extract()` (e.g. `Table.extract()[:]`). .. note:: Once a " "table has been extracted to a **Pandas DataFrame** with `to_pandas()` it " "is easy to convert to other file types with the **Pandas API**: - " "table to Markdown, use `to_markdown " "`_" " - table to JSON, use: `to_json " "`_" " - table to Excel, use: `to_excel " "`_" " - table to CSV, use: `to_csv " "`_" " - table to HTML, use: `to_html " "`_" " - table to SQL, use: `to_sql " "`_" msgstr "" #: ../../page.rst:497 84419d75309847998f10e74484826aa4 msgid "a `TableFinder` object that has the following significant attributes:" msgstr "`TableFinder` オブジェクトには、次の重要な属性があります：" #: ../../page.rst:499 914dadb7b99c41e397f201925e416bf3 msgid "" "`cells`: a list of **all bboxes** on the page, that have been identified " "as table cells (across all tables). Each cell is a :data:`rect_like` " "tuple `(x0, y0, x1, y1)` of coordinates or `None`." msgstr "" "**cells:** " "ページ上でテーブルのセルとして識別されたすべてのバウンディングボックスのリスト（すべてのテーブルを対象にします）。各セルは座標のタプル (x0, " "y0, x1, y1) または `None` です。" #: ../../page.rst:500 9583a87c04ff4e42be01211503a625ff msgid "" "`tables`: a list of `Table` objects. This is `[]` if the page has no " "tables. Single tables can be found as items of this list. But the " "`TableFinder` object itself is also a sequence of its tables. This means " "that if `tabs` is a `TableFinder` object, then table \"n\" is delivered " "by `tabs.tables[n]` as well as by the shorter `tabs[n]`." msgstr "" "**tables:** Table オブジェクトのリスト。ページにテーブルが含まれていない場合、これは `[]` " "になります。単一のテーブルはこのリストのアイテムとして見つけることができますが、`TableFinder` " "オブジェクト自体もそのテーブルのシーケンスです。つまり、`tabs` が `TableFinder` オブジェクトである場合、テーブル番号 " "\"n\" は `tabs.tables[n]` およびより短い `tabs[n]` によって提供されます。" #: ../../page.rst:503 2b85b5bbae0b4d1d9f39db8007aca40e msgid "The `Table` object has the following attributes:" msgstr "`Table` オブジェクトには次の属性があります：" #: ../../page.rst:505 c012c8a43f22438dabb93e5220436935 #, fuzzy msgid "``bbox``: the bounding box of the table as a tuple `(x0, y0, x1, y1)`." msgstr "**bbox:** テーブルのバウンディングボックス（タプル）`(x0, y0, x1, y1)`。" #: ../../page.rst:506 698bd70ef8b34723b3be7258f9e41a9b #, fuzzy msgid "" "``cells``: bounding boxes of the table's cells (list of tuples). A cell " "may also be `None`." msgstr "**cells:** テーブルのセルのバウンディングボックス（タプル）のリスト。セルは `None` である場合もあります。" #: ../../page.rst:507 5df00852328d4938af7a291d32ff1081 #, fuzzy msgid "" "``extract()``: this method returns the text content of each table cell as" " a list of list of strings." msgstr "**extract():** このメソッドは、各テーブルセルのテキストコンテンツを文字列のリストのリストとして返します。" #: ../../page.rst:508 4a75e91b2fa2471d8011d96b0fe413ef msgid "" "``to_markdown()``: this method returns the table as a **string in " "markdown format** (compatible to Github). Markdown viewers can render the" " string as a table. This output is optimized for **small token** sizes, " "which is especially beneficial for LLM/RAG feeds. Pandas DataFrames (see " "method `to_pandas()` below) offer an equivalent markdown table output " "which however is better readable for the human eye. Any line breaks " "(``\\n``) in cells are replaced by HTML line breaks tags `
`." msgstr "" #: ../../page.rst:509 e617dce6f36248939178f71102d4b3ad #, fuzzy msgid "" "`to_pandas()`: this method returns the table as a `pandas " "`_ `DataFrame " "`_. DataFrames are " "very versatile objects allowing a plethora of table manipulation methods " "and outputs to almost 20 well-known formats, among them Excel files, CSV," " JSON, markdown-formatted tables and more. `DataFrame.to_markdown()` " "generates a Github-compatible markdown format optimized for human " "readability. This method however requires the package `tabulate " "`_ to be installed in addition to " "pandas itself." msgstr "" "`to_pandas()` : このメソッドは、テーブルを `pandas " "`_ `DataFrame " "`_ として返します。DataFrame" " は非常に多目的なオブジェクトであり、さまざまなテーブル操作メソッドや、Excel ファイル、CSV、JSON、markdown " "形式のテーブルなど、約 20 種類のよく知られたフォーマットへの出力が可能です。`DataFrame.to_markdown()` " "は、人間が読みやすいように最適化された Github 互換の markdown 形式を生成します。ただし、このメソッドには pandas " "だけでなく、 [tablutate](https://pypi.org/project/tabulate/) " "パッケージの追加インストールが必要です。" #: ../../page.rst:510 5f646932780e47628df37150eba6cb11 msgid "" "``header``: a `TableHeader` object containing header information of the " "table." msgstr "**header:** テーブルのヘッダー情報を含む `TableHeader` オブジェクト。" #: ../../page.rst:511 2d6afff58bdd4b22982426aeaf93f0eb #, fuzzy msgid "``col_count``: an integer containing the number of table columns." msgstr "**col_count:** テーブルの列数を含む整数。" #: ../../page.rst:512 a011c98d056a4ab99078f551a9c555a7 #, fuzzy msgid "``row_count``: an integer containing the number of table rows." msgstr "**row_count:** テーブルの行数を含む整数。" #: ../../page.rst:513 ea78abc0fa2b48fc82e3b1818b26a2b9 #, fuzzy msgid "" "``rows``: a list of `TableRow` objects containing two attributes, " "``bbox`` is the boundary box of the row, and `cells` is a list of table " "cells contained in this row." msgstr "" "**rows:** `TableRow` オブジェクトのリストで、*bbox* は行の境界ボックスで、*cells* " "はこの行に含まれるテーブルセルのリストです。" #: ../../page.rst:515 9195a39415c24bd5b313c7328c2cb59f msgid "The `TableHeader` object has the following attributes:" msgstr "`TableHeader` オブジェクトには次の属性があります：" #: ../../page.rst:517 4f75c5d8372b41b596f2132f8f9cb869 msgid "``bbox``: the bounding box of the header." msgstr "**bbox:** ヘッダーのバウンディングボックス。" #: ../../page.rst:518 573cb43edf9046a5b0564d46d89d463c msgid "" "`cells`: a list of bounding boxes containing the name of the respective " "column." msgstr "**cells:** 各列の名前を含むバウンディングボックスのリスト。" #: ../../page.rst:519 9a2e52a4c74c49148081c9d490cbb1b1 msgid "" "`names`: a list of strings containing the text of each of the cell " "bboxes. They represent the column names -- which are used when exporting " "the table to pandas DataFrames, markdown, etc." msgstr "" "**names:** 各セルのバウンディングボックス内のテキストを含む文字列のリスト。これらは列の名前を表します。これらはテーブルを pandas" " DataFrame または CSV などにエクスポートする際に使用できます。" #: ../../page.rst:520 f6724988042c4b698633b4cf7e752649 msgid "" "`external`: a bool indicating whether the header bbox is outside the " "table body (`True`) or not. Table headers are never identified by the " "`TableFinder` logic. Therefore, if `external` is true, then the header " "cells are not part of any cell identified by `TableFinder`. If `external " "== False`, then the first table row is the header." msgstr "" "**external:** ヘッダーのバウンディングボックスがテーブル本体の外部にあるかどうかを示すブール値（`True` " "の場合、外部）。テーブルのヘッダーは TableFinder のロジックによって識別されないため、*external* が True " "の場合、ヘッダーセルは `TableFinder` によって識別された任意のセルの一部ではありません。`external == False` " "の場合、最初のテーブル行がヘッダーです。" #: ../../page.rst:522 75e1dfe474ed4ac0a22da38addfd7eb7 msgid "" "Please have a look at these `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages." msgstr "" "これらの `Jupyter notebooks `_ " "をご覧ください。これらのノートブックでは、1つのページに複数のテーブルがある場合や、複数のページにまたがるテーブル断片を結合するなど、標準的な状況がカバーされています。" #: ../../page.rst:524 5542b53a24dd430ab806eafb4021ebb6 msgid "" "The lifetime of the `TableFinder` object, as well as that of all its " "tables **equals the lifetime of the page**. If the page object is deleted" " or reassigned, all tables are no longer valid." msgstr "" #: ../../page.rst:526 75ed5e4bc66d4338bc281838569cf1ed msgid "" "The only way to keep table content beyond the page's availability is to " "**extract it** via methods `Table.to_markdown()`, `Table.to_pandas()` or " "a copy of `Table.extract()` (e.g. `Table.extract()[:]`)." msgstr "" #: ../../page.rst:530 020511fcaf024437a95dea516e1c4075 msgid "" "Once a table has been extracted to a **Pandas DataFrame** with " "`to_pandas()` it is easy to convert to other file types with the **Pandas" " API**:" msgstr "" #: ../../page.rst:532 1802aeb23deb4170b11761cf16a41608 msgid "" "table to Markdown, use `to_markdown " "`_" msgstr "" #: ../../page.rst:533 05c0dff89ae44350a0f8cb185d9ca6c6 msgid "" "table to JSON, use: `to_json " "`_" msgstr "" #: ../../page.rst:534 b9be51cdd74544d7a7b240e4943d42e4 msgid "" "table to Excel, use: `to_excel " "`_" msgstr "" #: ../../page.rst:535 0b4b368f030c4f65bae428c76e61dd78 msgid "" "table to CSV, use: `to_csv " "`_" msgstr "" #: ../../page.rst:536 c952cf87a79642ff9849bb5c2e32e39b msgid "" "table to HTML, use: `to_html " "`_" msgstr "" #: ../../page.rst:537 307428a286cf4f15a96b17d0e3720f43 msgid "" "table to SQL, use: `to_sql " "`_" msgstr "" #: ../../page.rst:542 b045da5db3aa4ea2af45fd37b2e43ad8 msgid "New in version 1.23.0" msgstr "新機能バージョン1.23.0" #: ../../page.rst:543 e2de54e7d89b48cf868f7e7b254d8f11 msgid "Changed in version 1.23.19: new argument `add_lines`." msgstr "1.23.19で変更された点：新しい引数 `add_lines` 。" #: ../../page.rst:549 e7ba1b19c5964a6b875bacb0405e7b4a msgid "" "There is also the `pdf2docx extract tables method`_ which is capable of " "table extraction if you prefer." msgstr "必要に応じて、テーブル抽出を行う `pdf2docx extract tables method`_ も利" #: ../../page.rst:554 07554ca053404982b9be25b02745810b msgid "" "PDF only: Add a \"rubber stamp\" annotation to e.g. indicate the " "document's intended use (\"DRAFT\", \"CONFIDENTIAL\", etc.). The " "parameter may be either an integer to select text from a predefined array" " of standard texts or an image." msgstr "" #: ../../page.rst:556 0e380a591d864ca49e58155f8217e31a msgid "rectangle where to place the annotation." msgstr "アノテーションを配置する矩形領域。" #: ../../page.rst:557 c7d3ea80fdb64fc9b0957574df07aadd msgid "" "The following options are available: * The id number (int) of the stamp " "text. For available stamps see :ref:`StampIcons`. * A string specifying " "an image file path. * A ``bytes``, ``bytearray`` or ``io.BytesIO`` " "object for an image in memory. * A :ref:`Pixmap`." msgstr "" #: ../../page.rst:557 74442f94aab649a8ba4710d8284a0e27 msgid "The following options are available:" msgstr "" #: ../../page.rst:559 140cb281aae84a22b89e70c6729c9ae6 #, fuzzy msgid "" "The id number (int) of the stamp text. For available stamps see " ":ref:`StampIcons`." msgstr "スタンプテキストのID番号。使用可能なスタンプについては :ref:`StampIcons` を参照してください。" #: ../../page.rst:561 a86218a2b5ca41798ea2e87e076fede6 msgid "A string specifying an image file path." msgstr "" #: ../../page.rst:563 2ab257ca8fa64d76a9a88d8c0cb8fdbf msgid "" "A ``bytes``, ``bytearray`` or ``io.BytesIO`` object for an image in " "memory." msgstr "" #: ../../page.rst:565 6470d3eee4704e8aa7445e56cc77a9aa msgid "A :ref:`Pixmap`." msgstr "" #: ../../page.rst:567 122c6baf020a4bac971ac2367b0cf3df msgid "**Text-based stamps**" msgstr "" #: ../../page.rst:569 ee84cbb991794dbc8418e486393dc58b msgid "" ":attr:`Annot.rect` is automatically calculated as the largest rectangle " "with an aspect ratio of ``width:height = 3.8`` that fits in the provided " "``rect``. Its position is vertically and horizontally centered." msgstr "" #: ../../page.rst:570 c58ca83a6d0d476c87477063c93639f0 msgid "The font chosen is \"Times Bold\" and the text will be upper case." msgstr "選択されるフォントは「Times Bold」で、テキストは大文字になります。" #: ../../page.rst:571 4bb912d4e39343ceb25f2cc8f03fde19 #, fuzzy msgid "" "The appearance can be modified using :meth:`Annot.set_opacity` and by " "setting the \"stroke\" color. By PDF specification, stamp annotations " "have no \"fill\" color." msgstr "" "外観は :meth:`Annot.set_opacity` を使用して変更でき、\"stroke\" " "色を設定することができます（「fill」色はサポートされていません）。" #: ../../page.rst:575 064624bb57674dd49f4b0f0ab02bce4d msgid "**Image-based stamps**" msgstr "" #: ../../page.rst:577 e17409d3940644e6b56475fa8581c0a2 msgid "" "The image is scaled to fit into the rectangle `rect` such that the " "image's center and the center of `rect` coincide. The aspect ratio of the" " image is preserved, so the image may not fill the entire rectangle. " "However, at least one of the given rectangle's width or height are fully " "covered." msgstr "" #: ../../page.rst:578 ec8dc9929ec44befb62f520a5bdce9b6 msgid "" "The annotation can be modified via :meth:`Annot.set_opacity`. This method" " therefore is a way to display images transparently even if no alpha " "channel is present." msgstr "" #: ../../page.rst:579 5ad9fae89ca94e40910abdcf5da94353 msgid "Setting colors has no effect on image stamps." msgstr "" #: ../../page.rst:580 6e2bc4decc3d49899690b03ac8cc7481 msgid "" "Rotating image-based stamps **is not supported**. Setting the rotation " "may lead to unexpected results." msgstr "" #: ../../page.rst:584 a28852a4a1d94c6f9180b933ec9dcd50 msgid "" "PDF only: Add a PDF Form field (\"widget\") to a page. This also **turns " "the PDF into a Form PDF**. Because of the large amount of different " "options available for widgets, we have developed a new class " ":ref:`Widget`, which contains the possible PDF field attributes. It must " "be used for both, form field creation and updates." msgstr "" "PDFのみ：ページにPDFフォームフィールド（ウィジェット）を追加します。これにより、PDFがフォームPDFに変換されます。ウィジェットにはさまざまなオプションがあるため、フォームフィールドの作成と更新の両方に使用する必要があるため、可能なPDFフィールド属性を含む新しいクラス" " :ref:`Widget` を開発しました。" #: ../../page.rst:586 5b4e58c5d61a4b0a86c9ac4f611770a7 msgid "a :ref:`Widget` object which must have been created upfront." msgstr "事前に作成されている必要がある :ref:`Widget` オブジェクト。" #: ../../page.rst:589 bcc225bd9cfb49cea096e52ab83f35d7 msgid "a widget annotation." msgstr "ウィジェットアノテーション。" #: ../../page.rst:593 d639ef397d36485e8aa8bb26d31c0378 msgid "" "The removal will now include any bound 'Popup' or response annotations " "and related objects (changed in v1.16.6)." msgstr "v1.16.6 で変更: 削除操作には、現在は関連する 'Popup' や応答アノテーションおよび関連するオブジェクトも含まれます。" #: ../../page.rst:595 8a00f469b1414059b4c586637e921948 msgid "PDF only: Delete annotation from the page and return the next one." msgstr "PDFのみ：ページから注釈を削除し、次の注釈を返します。" #: ../../page.rst:597 0482b1a51d404765adec9f2a73d29869 msgid "the annotation to be deleted." msgstr "削除するアノテーション。" #: ../../page.rst:601 8d0565728a8f4e40bbedbf26823b785b msgid "" "the annotation following the deleted one. Please remember that physical " "removal requires saving to a new file with garbage > 0." msgstr "削除された注釈の後に続く注釈。物理的な削除には、ガベージ> 0で新しいファイルに保存する必要があることを覚えておいてください。" #: ../../page.rst:605 701b3fe6c5c04d919d89284c697a8e04 msgid "PDF only: Delete field from the page and return the next one." msgstr "PDFのみ：ページからフィールドを削除し、次のフィールドを返します。" #: ../../page.rst:607 1f8e2118ea0f45548c869b582e9da683 msgid "the widget to be deleted." msgstr "削除するウィジェット。" #: ../../page.rst:610 ../../page.rst:1940 ../../page.rst:2264 #: 79632ab9e049470dbe64dda2553e676e 81cdfe378ae74469b530973f279448bc #: 860a45b3a45b411da64f22bbf25a1576 msgid ":ref:`Widget`" msgstr "" #: ../../page.rst:611 0b787a1fc4ec42bda0b70222cd36d91c msgid "" "the widget following the deleted one. Please remember that physical " "removal requires saving to a new file with garbage > 0." msgstr "削除されたウィジェットの後に続くウィジェット。物理的な削除には、ガベージ> 0で新しいファイルに保存する必要があることを覚えておいてください。" #: ../../page.rst:615 1b3c837eecb949b0bc0edd8df4124f3c msgid "(New in v1.18.4)" msgstr "v1.18.4で変更" #: ../../page.rst:622 c49122e36228451b838d9f1aa5efebc9 msgid "" "PDF only: Delete the specified link from the page. The parameter must be " "an **original item** of :meth:`get_links()`, see " ":ref:`link_dict_description`. The reason for this is the dictionary's " "*\"xref\"* key, which identifies the PDF object to be deleted." msgstr "" "PDFのみ：ページから指定したリンクを削除します。パラメータは :meth:`get_links()` " "の元のアイテムである必要があります（以下参照）。これは辞書の *「xref」* キーがPDFオブジェクトを識別するための理由です。" #: ../../page.rst:624 922f58de7690440b8f4d3afd8f153fd3 msgid "the link to be deleted." msgstr "削除するリンクです。" #: ../../page.rst:628 50ac389b0cfe45568e5b6a1734037114 msgid "" "PDF only: Insert a new link on this page. The parameter must be a " "dictionary of format as provided by :meth:`get_links()`, see " ":ref:`link_dict_description`." msgstr "" "PDFのみ：このページに新しいリンクを挿入します。パラメータは :meth:`get_links()` " "で提供される形式の辞書である必要があります（以下参照）。" #: ../../page.rst:630 e2e38196067748a485135b6e842933e0 msgid "the link to be inserted." msgstr "挿入するリンクです。" #: ../../page.rst:634 d59a62d84a804721930f49e18365d762 msgid "" "PDF only: Modify the specified link. The parameter must be a (modified) " "**original item** of :meth:`get_links()`, see " ":ref:`link_dict_description`. The reason for this is the dictionary's " "*\"xref\"* key, which identifies the PDF object to be changed." msgstr "" "PDFのみ：指定されたリンクを変更します。パラメータは :meth:`get_links()` （以下参照）の **元のアイテム** " "である必要があります（変更された場合）。これは辞書の *「xref」* キーがPDFオブジェクトを識別するための理由です。" #: ../../page.rst:636 07822e8f830441a381c271aa8a1209a1 msgid "the link to be modified." msgstr "変更するリンクです。" #: ../../page.rst:638 0de77211c8ab4e39bc3a706653fbbe95 msgid "" "If updating / inserting a URI link (`\"kind\": LINK_URI`), please make " "sure to start the value for the `\"uri\"` key with a disambiguating " "string like `\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, " "`\"mailto:\"`, etc. Otherwise -- depending on your browser or other " "\"consumer\" software -- unexpected default assumptions may lead to " "unwanted behaviours." msgstr "" "URIリンク（`\"kind\": LINK_URI`）を更新/挿入する場合は、\"uri\"キーの値を必ず " "`「http://」`、`「https://」`、`「file://」` " "、`「ftp://」`、「mailto：」などの区別可能な文字列で始めるようにしてください。そうしないと、ブラウザや他の「コンシューマ」ソフトウェアによって、予期しないデフォルトの仮定が不要な動作につながる可能性があります。" #: ../../page.rst:643 69289bebf6b44c29b0292e6d9c0985ed msgid "PDF only: Return the label for the page." msgstr "PDFのみ：ページのラベルを返します。" #: ../../page.rst:647 3eb1a4da448a4ad1aef74e4f8337c3d5 msgid "the label string like \"vii\" for Roman numbering or \"\" if not defined." msgstr "ローマ数字の「vii」などのラベル文字列、または定義されていない場合は \"\"。" #: ../../page.rst:651 ad9f6c2321eb41708816ca80d962a3da msgid "New in v1.18.6" msgstr "v1.18.6で新規追加" #: ../../page.rst:657 e2f26ba92210426f9f0957a589aa226e msgid "Retrieves **all** links of a page." msgstr "ページの **すべて** のリンクを取得します。" #: ../../page.rst:660 dbe8d31972064e49852b68e14f0e731d msgid "" "A list of dictionaries. For a description of the dictionary entries, see " ":ref:`link_dict_description`. Always use this or the :meth:`Page.links` " "method if you intend to make changes to the links of a page." msgstr "" "辞書のリスト。辞書エントリの説明については以下を参照してください。ページのリンクを変更する意図がある場合は、:meth:`Page.links` " "メソッドまたはこれを常に使用してください。" #: ../../page.rst:664 982dbd008c68482ab6a205bec8a0536d msgid "" "Return a generator over the page's links. The results equal the entries " "of :meth:`Page.get_links`." msgstr "ページのリンクをイテレーターとして返します。結果は :meth:`Page.get_links` のエントリと同じです。" #: ../../page.rst:666 c23f5985f84f45ce96f719ffbfc1180b msgid "" "a sequence of integers to down-select to one or more link kinds. Default " "is all links. Example: *kinds=(pymupdf.LINK_GOTO,)* will only return " "internal links." msgstr "" "1つ以上のリンク種別をダウン選択するための整数のシーケンス。デフォルトはすべてのリンクです。例：*kinds=(pymupdf.LINK_GOTO,)*" " は内部リンクのみを返します。" #: ../../page.rst:669 933e377cd2a647b394396f8c8c657dc3 msgid "an entry of :meth:`Page.get_links()` for each iteration." msgstr "各イテレーションごとの :meth:`Page.get_links()` のエントリ。" #: ../../page.rst:673 ../../page.rst:698 ../../page.rst:713 #: 2bcfe2f227934e13883dccdfd49bf552 522c66b3f0834a05b0d694a35a3d60c7 #: 58c5a6638d064f8f9c81265ab468b76e msgid "New in v1.16.4" msgstr "v1.16.4で新規追加" #: ../../page.rst:679 9895c4a674ad4ee9bd390eb10d90b9f3 msgid "Return a generator over the page's annotations." msgstr "ページの注釈をイテレーターとして返します。" #: ../../page.rst:681 b187bf843be8421f8dddb40d6f9e9bc1 msgid "" "a sequence of integers to down-select to one or more annotation types. " "Default is all annotations. Example: `types=(pymupdf.PDF_ANNOT_FREETEXT, " "pymupdf.PDF_ANNOT_TEXT)` will only return 'FreeText' and 'Text' " "annotations." msgstr "" "1つ以上の注釈タイプをダウン選択するための整数のシーケンス。デフォルトはすべての注釈です。例：`types=(pymupdf.PDF_ANNOT_FREETEXT," " pymupdf.PDF_ANNOT_TEXT)` は「FreeText」および「Text」注釈のみを返します。" #: ../../page.rst:684 af312b81213748debdaed085f717b02e msgid "" "an :ref:`Annot` for each iteration. .. caution:: You **cannot " "safely update annotations** from within this generator. This is because " "most annotation updates require reloading the page via `page = " "doc.reload_page(page)`. To circumvent this restriction, make a list of " "annotations xref numbers first and then iterate over these numbers::" " In [4]: xrefs = [annot.xref for annot in " "page.annots(types=[...])] In [5]: for xref in xrefs: ...:" " annot = page.load_annot(xref) ...: annot.update()" " ...: page = doc.reload_page(page) In [6]:" msgstr "" #: ../../page.rst:684 cbc5b2fa7395471cbd33de5cfadaf49a msgid "an :ref:`Annot` for each iteration." msgstr "各イテレーションごとの :ref:`Annot`。" #: ../../page.rst:687 c2f668696d264c1b82fa9512ec3d67fe msgid "" "You **cannot safely update annotations** from within this generator. This" " is because most annotation updates require reloading the page via `page " "= doc.reload_page(page)`. To circumvent this restriction, make a list of " "annotations xref numbers first and then iterate over these numbers::" msgstr "" "このジェネレータ内から **アノテーションを安全に更新することはできません**。これは、ほとんどの注釈の更新にはpage = " "doc.reload_page(page)を介してページを再読み込みする必要があるためです。この制限を回避するために、まず注釈のxref番号のリストを作成し、その後これらの番号を繰り返し処理します::" #: ../../page.rst:704 cf4dc50262134d9b8991d68d2387fda1 msgid "Return a generator over the page's form fields." msgstr "フォームフィールドのジェネレーターを返します。" #: ../../page.rst:706 09b37fc07a8b4617ba3ab3e1ed7e81ee msgid "" "a sequence of integers to down-select to one or more widget types. " "Default is all form fields. Example: " "`types=(pymupdf.PDF_WIDGET_TYPE_TEXT,)` will only return 'Text' fields." msgstr "" "1つ以上のウィジェットタイプに選択を絞り込むための整数のシーケンス。デフォルトではすべてのフォームフィールドが対象です。例: " "`types=(pymupdf.PDF_WIDGET_TYPE_TEXT,)` を指定すると 'Text' フィールドのみが返されます。" #: ../../page.rst:709 b4a6fd5ab9f74f1aa81ff011fd4473d4 msgid "a :ref:`Widget` for each iteration." msgstr "各イテレーションでの :ref:`Widget`" #: ../../page.rst:720 91c0b9169e9b478ab89cee70033f2b07 msgid "" "PDF only: Write the text of one or more :ref:`Textwriter` objects to the " "page." msgstr "PDF のみ: 1つ以上の :ref:`Textwriter` オブジェクトのテキストをページに書き込みます。" #: ../../page.rst:722 a55443e916e2419994c89d95d80a0911 msgid "" "where to place the text. If omitted, the rectangle union of the text " "writers is used." msgstr "テキストを配置する場所。省略した場合、テキストライターの矩形の合併が使用されます。" #: ../../page.rst:723 cce444b656e64b60a81ce94494e38f3d msgid "" "a non-empty tuple / list of :ref:`TextWriter` objects or a single " ":ref:`TextWriter`." msgstr "1つ以上の :ref:`TextWriter` オブジェクトのタプル/リスト、または単一の :ref:`TextWriter` です。" #: ../../page.rst:724 d271cb55070d4f5487e21e1eacd3c751 msgid "set transparency, overwrites resp. value in the text writers." msgstr "透明度を設定し、テキストライターの値を上書きします。" #: ../../page.rst:725 3c29e8bef62342fea254c2dc367dd6c5 msgid "set the text color, overwrites resp. value in the text writers." msgstr "テキストの色を設定し、テキストライターの値を上書きします。" #: ../../page.rst:726 c86c42e9bcd24d43869350b460d4d700 msgid "put the text in foreground or background." msgstr "テキストを前景または背景に配置するかどうか。" #: ../../page.rst:727 63b9bb95ed42482580a37bf19dbe45a5 msgid "maintain the aspect ratio." msgstr "アスペクト比を保持するかどうか。" #: ../../page.rst:728 9e0772c8aa0c408d881ef210c734cb28 msgid "rotate the text by an arbitrary angle." msgstr "テキストを任意の角度で回転します。" #: ../../page.rst:729 16cea029005545c49f87400b6e929e58 msgid "the :data:`xref` of an :data:`OCG` or :data:`OCMD`. (New in v1.18.4)" msgstr "*(v1.18.4 で新たに追加)* :data:`OCG` または :data:`OCMD` の :data:`xref`。" #: ../../page.rst:731 674aebc5fc8e4803bf557ef50bf29172 msgid "" "Parameters *overlay, keep_proportion, rotate* and *oc* have the same " "meaning as in :meth:`Page.show_pdf_page`." msgstr "" "*overlay、keep_proportion、rotate、oc* パラメーターは :meth:`Page.show_pdf_page` " "と同じ意味を持ちます。" #: ../../page.rst:735 efb00b02fde547eeb0b25bf6f23dcc15 msgid "New in v1.16.18" msgstr "v1.16.18 で追加された新機能です。" #: ../../page.rst:759 ac14c88754ee44f99b0bec586cb0acda #, fuzzy msgid "" "PDF only: Insert text lines starting at :data:`point_like` ``point``. See" " :meth:`Shape.insert_text`." msgstr "" "PDFのみ: :data:`point_like` *point* からテキストを挿入します。:meth:`Shape.insert_text` " "を参照してください。" #: ../../page.rst:763 ../../page.rst:792 ../../page.rst:896 ../../page.rst:921 #: ../../page.rst:946 ../../page.rst:970 ../../page.rst:994 ../../page.rst:1019 #: ../../page.rst:1043 ../../page.rst:1068 ../../page.rst:1092 #: ../../page.rst:1117 ../../page.rst:1142 16f565fc3199438e95a9f991424f44b4 #: 3eec8de7562c4ff5807b32eaada58d2d 3fc49e0d00de4149a91ed98db7b39d82 #: 6885c68bc46a4bf5803fc9bb9d518db9 6edade0a885e4aa990ece4507b2ad4c0 #: 919db5753717454db1b1e8ba55000ca4 935d13e1eb4f47bdbbf0d3b48d3afe77 #: 981866858e6e4f62a147faf42cd4c8c5 a36b2ebbf9244ee0ac2a4140992d02c7 #: e01505a51cf44ee98a13168527fcf25f f124938d669846f7b838a60573194e18 #: f2425ff3386d4be590ef1711bc0182f5 f64299f68d4c4b01b12b2e5bccb7fb45 msgid "Changed in v1.18.4" msgstr "v1.18.4 で変更" #: ../../page.rst:788 847e042eb216477ca6976051a061f859 msgid "" "PDF only: Insert text into the specified :data:`rect_like` *rect*. See " ":meth:`Shape.insert_textbox`." msgstr "" "PDF のみ：指定された :data:`rect_like` の *rect* " "にテキストを挿入します。:meth:`Shape.insert_textbox` を参照してください。" #: ../../page.rst:810 6aba6ac9699e4252b53eb6f4ae4a7dcd msgid "" "**PDF only:** Insert text into the specified rectangle. The method has " "similarities with methods :meth:`Page.insert_textbox` and " ":meth:`TextWriter.fill_textbox`, but is **much more powerful**. This is " "achieved by letting a :ref:`Story` object do all the required processing." msgstr "" "**PDFのみ:** 指定された矩形にテキストを挿入します。このメソッドは、:meth:`Page.insert_textbox` メソッドと " ":meth:`TextWriter.fill_textbox` メソッドと類似していますが、はるかに強力です。これは、:ref:`Story` " "(ストーリー) オブジェクトに必要なすべての処理を行わせることで実現されます。" #: ../../page.rst:812 ee10551fb26a4ec0b9db75ebbb21cf0b #, fuzzy msgid "" "Parameter ``text`` may be a string as in the other methods. But it will " "be **interpreted as HTML source** and may therefore also contain HTML " "language elements -- including styling. The `css` parameter may be used " "to pass in additional styling instructions." msgstr "" "パラメータ `text` は、他のメソッドと同様に文字列である場合があります。ただし、これは **HTMLソース** " "として解釈され、そのためスタイリングを含むHTML言語要素も含まれる可能性があります。`css` " "パラメータを使用して追加のスタイリング指示を渡すことができます。" #: ../../page.rst:814 e3b6f6aa9ef74189af88441862202e6b #, fuzzy msgid "" "Automatic line breaks are generated at word boundaries. The \"soft " "hyphen\" character `\"­\"` (or `­`) can be used to cause " "hyphenation and thus may also cause line breaks. **Forced** line breaks " "however are only achievable via the HTML tag ``
`` - ``\\n`` is " "ignored and will be treated like a space." msgstr "" "自動的な改行は単語の境界で生成されます。 \"soft hyphen\" 文字 `\"­\"`（または `­` " "）を使用するとハイフネーションが引き起こされ、その結果改行も生じる場合があります。ただし、強制的な改行はHTMLタグ `
` - " "`\"\\\\n\"` を使用してのみ実現可能であり、\"\n" "\"は無視され、空白と同じように扱われます。" #: ../../page.rst:816 7db693f5847b4c808cdcf8245af57aac msgid "With this method the following can be achieved:" msgstr "このメソッドでは、次のことが可能です。" #: ../../page.rst:818 f3aed1a429bc4b0a87d9d8be413d7ec4 msgid "" "Styling effects like bold, italic, text color, text alignment, font size " "or font switching." msgstr "太字、斜体、テキストの色、テキストの配置、フォントサイズ、またはフォントの切り替えなどのスタイル効果" #: ../../page.rst:819 e0b541df39074db0a80a56cd57984e79 msgid "" "The text may include arbitrary languages -- **including right-to-left** " "languages." msgstr "テキストには、**右から左に書かれる言語を含む** 任意の言語を含めることができます。" #: ../../page.rst:820 d9d140639c804339ba9b3ea6f5fbc848 msgid "" "Scripts like `Devanagari `_ and" " several others in Asia have a highly complex system of ligatures, where " "two or more unicodes together yield one glyph. The Story uses the " "software package `HarfBuzz `_ , to deal with" " these things and produce correct output." msgstr "" "`Devanagari `_ " "やその他のアジアの文字など、2つ以上のUnicodeが一つのグリフに変換される複雑なリガチャーのあるスクリプトは、正しい出力を生成するためにソフトウェアパッケージ" " `HarfBuzz `_ を使用しています。" #: ../../page.rst:821 09c3f85d8cfa4925a966b311e81d4be2 msgid "" "One can also **include images** via HTML tag `` -- the Story will " "take care of the appropriate layout. This is an alternative option to " "insert images, compared to :meth:`Page.insert_image`." msgstr "" "画像はHTMLタグ `` " "を介して含めることができ、Storyが適切なレイアウトを担当します。これは、:meth:`Page.insert_image` " "と比較した画像の挿入の代替オプションです。" #: ../../page.rst:822 15709477c471444fb826b7246bc9303b msgid "" "HTML tables (tag ``) may be included in the text and will be " "handled appropriately." msgstr "HTMLテーブル（ `
` タグ）をテキストに含めることができ、適切に処理されます。" #: ../../page.rst:823 498e6ef15995416fb84b1883d5d92638 msgid "Links are automatically generated when present." msgstr "リンクが存在する場合、自動的にリンクが生成されます。" #: ../../page.rst:825 897b9824e00144589853950e0fc085d7 msgid "If content does not fit in the rectangle, the developer has two choices:" msgstr "もしコンテンツが長方形に収まらない場合、開発者には2つの選択肢があります。:" #: ../../page.rst:827 a9594e868a9140d48ee407ab97e2458e msgid "" "**either** only be informed about this (and accept a no-op, just like " "with the other textbox insertion methods)," msgstr "**それとも** 、このことについての情報のみを受け取り（他のテキストボックスの挿入メソッドと同様に、何も起こらないことを受け入れる）、" #: ../../page.rst:828 c80278844b0f4a10aa7d6f6c3f44d861 msgid "**or** (`scale_low=0` - the default) scale down the content until it fits." msgstr "**または** （ `scale_low=0` - デフォルト）コンテンツを収まるまで縮小します。" #: ../../page.rst:830 9ae3b284474e4a8fa2f79faa63d3257f msgid "rectangle on page to receive the text." msgstr "テキストを配置する長方形の領域。" #: ../../page.rst:831 2a0f0754bb6546f6a30c1c29ce8432c5 msgid "" "the text to be written. Can contain a mixture of plain text and HTML tags" " with styling instructions. Alternatively, a :ref:`Story` object may be " "specified (in which case the internal Story generation step will be " "omitted). A Story must have been generated with all required styling and " "Archive information." msgstr "" "書き込むテキスト。スタイル指示を含むプレーンテキストとHTMLタグの混合物であることができます。代替として、 " ":ref:`Story`（ストーリー）オブジェクトを指定することもできます（その場合、内部のストーリー生成ステップは省略されます）。必要なすべてのスタイリングとアーカイブ情報で生成されたストーリーを指定する必要があります。" #: ../../page.rst:832 14181b61a0884be297ef3685294cdda4 #, fuzzy msgid "" "optional string containing additional CSS instructions. This parameter is" " ignored if ``text`` is a Story." msgstr "（オプション）追加のCSS指示を含む文字列。`text` がストーリーの場合、このパラメータは無視されます。" #: ../../page.rst:833 324740ae7018450e95548a711684a3c1 msgid "" "if necessary, scale down the content until it fits in the target " "rectangle. This sets the down scaling limit. Default is 0, no limit. A " "value of 1 means no down-scaling permitted. A value of e.g. 0.2 means " "maximum down-scaling by 80%." msgstr "コンテンツがターゲットの長方形に収まるまで必要に応じてコンテンツのスケーリングを行います。これはダウンスケーリングの制限を設定します。デフォルトは0で、制限なしを意味します。値が1の場合、ダウンスケーリングは許可されません。たとえば、0.2の値は、最大で80％のダウンスケーリングを意味します。" #: ../../page.rst:834 c292373f60e74b0a9e7acb742bfd00f9 #, fuzzy msgid "" "an Archive object that points to locations where to find images or non-" "standard fonts. If ``text`` refers to images or non-standard fonts, this " "parameter is required. This parameter is ignored if ``text`` is a Story." msgstr "画像や非標準のフォントの場所を指すアーカイブオブジェクト。テキストが画像や非標準のフォントを参照する場合、このパラメータが必要です。テキストがストーリーの場合、このパラメータは無視されます" #: ../../page.rst:835 e06bdf8120344edea5c871c8b734bed9 msgid "" "one of the values 0, 90, 180, 270. Depending on this, text will be " "filled: - 0: top-left to bottom-right. - 90: bottom-left to top-right. -" " 180: bottom-right to top-left. - 270: top-right to bottom-left. .. " "image:: images/img-rotate.*" msgstr "" #: ../../page.rst:835 5d44f86e3d34408fae9c505f2eb51a22 msgid "one of the values 0, 90, 180, 270. Depending on this, text will be filled:" msgstr "0、90、180、270のいずれかの値。これに応じて、テキストが埋められます:" #: ../../page.rst:837 9fd548225f8245c1bdd20ddef928329d msgid "0: top-left to bottom-right." msgstr "0：左上から右下に。" #: ../../page.rst:838 793a65bf3a3545e49a9ab0e68d7e1080 msgid "90: bottom-left to top-right." msgstr "90：左下から右上に。" #: ../../page.rst:839 c66768a9d53b4dd28889d3dc2e47fb81 msgid "180: bottom-right to top-left." msgstr "180：右下から左上に。" #: ../../page.rst:840 0e3ecfcbddc244d3a80913c9e9cf9524 msgid "270: top-right to bottom-left." msgstr "270：右上から左下に。" #: ../../page.rst:844 2aaaebae93dd4932a8c2460350eb2887 msgid "" "the xref of an :data:`OCG` / :data:`OCMD` or 0. Please refer to " ":meth:`Page.show_pdf_page` for details." msgstr "" ":data:`OCG` （オプションコンテンツグループ）/ :data:`OCMD` " "（オプションコンテンツメタデータ）のxrefまたは0。詳細については、 :meth:`Page.show_pdf_page` を参照してください。" #: ../../page.rst:845 b604f2246e724e6b881b6c6f67f39527 msgid "" "set the fill and stroke opacity of the content. Only values `0 <= opacity" " < 1` are considered." msgstr "コンテンツの塗りつぶしとストロークの不透明度を設定します。`0 <= opacity < 1` の値のみ考慮されます。" #: ../../page.rst:846 219fcacb5f0346e0a24bdff2f9da09df msgid "" "put the text in front of other content. Please refer to " ":meth:`Page.show_pdf_page` for details." msgstr "テキストを他のコンテンツの前に配置します。詳細については、:meth:`Page.show_pdf_page` を参照してください。" #: ../../page.rst:848 2d7a34e664184e029228581824d74532 msgid "" "A tuple of floats `(spare_height, scale)`. - spare_height: The " "(positive) height of the remaining space in `rect` below the text, or " "-1 if we failed to fit. - scale: The scaling required; `0 < scale <= 1`. " "Will be `scale_low` if we failed to fit." msgstr "" #: ../../page.rst:848 59f16a716d924e38b4bce004bff088e0 msgid "A tuple of floats `(spare_height, scale)`." msgstr "浮動小数点数のタプル `(spare_height, scale)` です。" #: ../../page.rst:850 9a5db1bacf1b48f4b4b2f4d206231059 msgid "" "spare_height: The (positive) height of the remaining space in `rect` " "below the text, or -1 if we failed to fit." msgstr "" #: ../../page.rst:852 a9b179217d2846d9a9518f6eac262918 msgid "" "scale: The scaling required; `0 < scale <= 1`. Will be `scale_low` if we " "failed to fit." msgstr "" #: ../../page.rst:855 65774661f353460199b1f64e1215ae23 msgid "" "Please refer to examples in this section of the recipes: " ":ref:`RecipesText_I_c`." msgstr "このレシピの例を参照してください：:ref:`RecipesText_I_c`。" #: ../../page.rst:859 a5843434b81d490487977efeb5d8cb77 #, fuzzy msgid "New in v1.26.5:" msgstr "v1.16.5 で新機能。" #: ../../page.rst:861 9207751e2f024fa8a44590fb3b9ebe6d msgid "do additional scaling to fit long words." msgstr "" #: ../../page.rst:863 c4c760f58b134e3fbdab0bbb8f2a7379 msgid "" "If we succeeded and scaled down, the returned `spare_height` is now " "generally positive instead of being fixed to zero, because the final " "rect's height is usually not an exact multiple of the font line height." msgstr "" #: ../../page.rst:867 ad918ee3f341411ba0aa7c506a1f02ea #, fuzzy msgid "New in v1.23.8: rebased-only." msgstr "v1.21.0で新たに追加" #: ../../page.rst:868 8a3a7377bf1a457fbf81074b185a2c90 #, fuzzy msgid "New in v1.23.9: `opacity` parameter." msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:873 af588c948d8f4d3f83c4677718197726 msgid "**Drawing Methods**" msgstr "**描画メソッド**" #: ../../page.rst:892 49a6624229f44fe6ba71c7e9ca8d75ef msgid "" "PDF only: Draw a line from *p1* to *p2* (:data:`point_like` \\s). See " ":meth:`Shape.draw_line`." msgstr "" "PDF のみ：*p1* から *p2* までの直線を描画します（:data:`point_like` " "\\s）。:meth:`Shape.draw_line` を参照してください。" #: ../../page.rst:917 9b38905ad1dd4d0ead359e61852a1b54 msgid "" "PDF only: Draw a zigzag line from *p1* to *p2* (:data:`point_like` \\s). " "See :meth:`Shape.draw_zigzag`." msgstr "" "PDF のみ：p1 から p2 までのジグザグ線を描画します（:data:`point_like` " "\\s）。:meth:`Shape.draw_zigzag` を参照してください。" #: ../../page.rst:942 9c336220359d487c96ab2495463d04bf msgid "" "PDF only: Draw a squiggly (wavy, undulated) line from *p1* to *p2* " "(:data:`point_like` \\s). See :meth:`Shape.draw_squiggle`." msgstr "" "PDF のみ：*p1* から *p2* までの波線（うねり）を描画します（:data:`point_like` " "\\s）。:meth:`Shape.draw_squiggle` を参照してください。" #: ../../page.rst:966 dda4c1acb3be44ea84511701f5e0e066 msgid "" "PDF only: Draw a circle around *center* (:data:`point_like`) with a " "radius of *radius*. See :meth:`Shape.draw_circle`." msgstr "" "PDF のみ：*center* を中心に、半径 *radius* の円を描画します " ":data:`point_like`。:meth:`Shape.draw_circle` を参照してください。" #: ../../page.rst:990 2e0189701fa74750b9dacd5303fc0bd4 msgid "" "PDF only: Draw an oval (ellipse) within the given :data:`rect_like` or " ":data:`quad_like`. See :meth:`Shape.draw_oval`." msgstr "" "PDF のみ：指定された :data:`rect_like` または :data:`quad_like` " "内に楕円を描画します。:meth:`Shape.draw_oval` を参照してください。" #: ../../page.rst:1015 5099c99eeaa644dbb974a50f3152aa30 msgid "" "PDF only: Draw a circular sector, optionally connecting the arc to the " "circle's center (like a piece of pie). See :meth:`Shape.draw_sector`." msgstr "" "PDFのみ: " "円形セクターを描画し、オプションで円の中心とアークを接続します（パイの一部のように）。:meth:`Shape.draw_sector` " "を参照してください。" #: ../../page.rst:1039 f3dd8d945074407c8054e936336973f1 msgid "" "PDF only: Draw several connected lines defined by a sequence of " ":data:`point_like` \\s. See :meth:`Shape.draw_polyline`." msgstr "" "PDFのみ: 一連の :data:`point_like` \\s " "ポイントによって定義された接続された複数のラインを描画します。:meth:`Shape.draw_polyline` を参照してください。" #: ../../page.rst:1064 28ea8c05024f440bb036391514064d3d msgid "" "PDF only: Draw a cubic Bézier curve from *p1* to *p4* with the control " "points *p2* and *p3* (all are :data:`point_like` \\s). See " ":meth:`Shape.draw_bezier`." msgstr "" "PDFのみ: 制御ポイント *p2* および *p3* を使用して、*p1* から *p4* " "へのキュービックベジエ曲線を描画します（すべてのポイントは :data:`point_like` " "です）。:meth:`Shape.draw_bezier` を参照してください。" #: ../../page.rst:1088 157ccab0cc4d491a8bb08c506c20ee93 msgid "" "PDF only: This is a special case of *draw_bezier()*. See " ":meth:`Shape.draw_curve`." msgstr "PDFのみ: これは *draw_bezier()* の特別なケースです。:meth:`Shape.draw_curve` を参照してください。" #: ../../page.rst:1113 b8490d3dba144147892f25e4d622068e msgid "PDF only: Draw a rectangle. See :meth:`Shape.draw_rect`." msgstr "PDFのみ: 四角形を描画します。:meth:`Shape.draw_rect` を参照してください。" #: ../../page.rst:1118 a272604a8c1f470c9a130f447d1fdb3f msgid "Changed in v1.22.0: Added parameter *radius*." msgstr "v1.22.0で変更：パラメーター *radius* を追加しました。" #: ../../page.rst:1138 73015a6ba1b54fef8169908a7281e136 msgid "PDF only: Draw a quadrilateral. See :meth:`Shape.draw_quad`." msgstr "PDFのみ: 四辺形を描画します。:meth:`Shape.draw_quad` を参照してください。" #: ../../page.rst:1156 09dfe16658184db3a8101d292d524018 msgid "" "PDF only: Add a new font to be used by text output methods and return its" " :data:`xref`. If not already present in the file, the font definition " "will be added. Supported are the built-in :data:`Base14_Fonts` and the " "CJK fonts via **\"reserved\"** fontnames. Fonts can also be provided as a" " file path or a memory area containing the image of a font file." msgstr "" "PDFのみ: テキスト出力メソッドで使用する新しいフォントを追加し、その :data:`xref` " "を返します。ファイルにまだ存在しない場合、フォントの定義が追加されます。組み込みの :data:`Base14_Fonts` および CJK " "フォントがサポートされており、**「予約済み」** " "フォント名を介して使用できます。フォントはファイルパスまたはフォントファイルのイメージを含むメモリ領域として提供することもできます。" #: ../../page.rst:1158 2a54c648d14d47758ff2034915e314ce msgid "" "The name by which this font shall be referenced when outputting text on " "this page. In general, you have a \"free\" choice here (but consult the " ":ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of " "building legal PDF names). However, if it matches one of the " ":data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer*" " **are ignored**. In other words, you cannot insert a font via " "*fontfile* / *fontbuffer* and also give it a reserved *fontname*. .. " "note:: A reserved fontname can be specified in any mixture of upper or " "lower case and still match the right built-in font definition: fontnames " "\"helv\", \"Helv\", \"HELV\", \"Helvetica\", etc. all lead to the same " "font definition \"Helvetica\". But from a :ref:`Page` perspective, these " "are **different references**. You can exploit this fact when using " "different *encoding* variants (Latin, Greek, Cyrillic) of the same font " "on a page." msgstr "" #: ../../page.rst:1158 f1417bd8c11d42f18da9e7cc192a9b54 msgid "" "The name by which this font shall be referenced when outputting text on " "this page. In general, you have a \"free\" choice here (but consult the " ":ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of " "building legal PDF names). However, if it matches one of the " ":data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer*" " **are ignored**." msgstr "" "このフォントをこのページ上でテキスト出力する際に参照される名前。 " "一般的に、ここで「自由な」選択ができます（ただし、:ref:`AdobeManual`、ページ16、セクション7.3.5を参照して正当なPDF名の形式的な説明を確認してください）。ただし、:data:`Base14_Fonts`" " またはCJKフォントのいずれかと一致する場合、*fontfile* および *fontbuffer* は **無視されます。**" #: ../../page.rst:1160 b07885c01b7c4d2f98af200a61b2239f msgid "" "In other words, you cannot insert a font via *fontfile* / *fontbuffer* " "and also give it a reserved *fontname*." msgstr "言い換えれば、フォントを *fontfile* / *fontbuffer* 経由で挿入し、予約されたフォント名も指定することはできません。" #: ../../page.rst:1162 6e3e5a1b1302490bbebb40eb041aa480 msgid "" "A reserved fontname can be specified in any mixture of upper or lower " "case and still match the right built-in font definition: fontnames " "\"helv\", \"Helv\", \"HELV\", \"Helvetica\", etc. all lead to the same " "font definition \"Helvetica\". But from a :ref:`Page` perspective, these " "are **different references**. You can exploit this fact when using " "different *encoding* variants (Latin, Greek, Cyrillic) of the same font " "on a page." msgstr "" "予約されたフォント名は、大文字と小文字の組み合わせで指定でき、それでも適切な組み込みフォントの定義に一致します。フォント名「helv」、「Helv」、「HELV」、「Helvetica」などはすべて同じフォント定義「Helvetica」につながります。ただし、ページの観点からはこれらは" " **異なる参照** です。同じフォントの異なる *エンコーディング* " "バリアント（ラテン、ギリシャ、キリル文字など）をページ上で使用する場合、この事実を利用できます。" #: ../../page.rst:1164 b329abbc6b5940dba48a2d1be997d3bd msgid "" "a path to a font file. If used, *fontname* must be **different from all " "reserved names**." msgstr "フォントファイルへのパス。使用する場合、*fontname* は **すべての予約済みの名前と異なる必要があります**。" #: ../../page.rst:1166 298c716b43174038aeedbf20294a8600 msgid "" "the memory image of a font file. If used, *fontname* must be **different " "from all reserved names**. This parameter would typically be used with " ":attr:`Font.buffer` for fonts supported / available via :ref:`Font`." msgstr "" "フォントファイルのメモリイメージ。使用する場合、*fontname* は **すべての予約済みの名前と異なる** " "必要があります。通常、このパラメーターは :attr:`Font.buffer` を介してサポート/利用可能な :ref:`Font` " "に使用されます。" #: ../../page.rst:1168 39ebae8797b04f77959ffa0509ce652e msgid "" "applicable for *fontfile* / *fontbuffer* cases only: enforce treatment as" " a \"simple\" font, i.e. one that only uses character codes up to 255." msgstr "" "*fontfile* / *fontbuffer* " "ケースにのみ適用可能：「シンプル」フォントとしての扱いを強制します。つまり、文字コードが255までしか使用しないフォントです。" #: ../../page.rst:1170 447d0c124033428aa957f8b973050309 msgid "" "applicable for the \"Helvetica\", \"Courier\" and \"Times\" sets of " ":data:`Base14_Fonts` only. Select one of the available encodings Latin " "(0), Cyrillic (2) or Greek (1). Only use the default (0 = Latin) for " "\"Symbol\" and \"ZapfDingBats\"." msgstr "" ":data:`Base14_Fonts` " "の「Helvetica」、「Courier」、「Times」セットにのみ適用可能。利用可能なエンコーディングのうち、ラテン（0）、キリル文字（2）、ギリシャ文字（1）のいずれかを選択します。「Symbol」と「ZapfDingBats」についてはデフォルト（0" " = ラテン）のみを使用してください。" #: ../../page.rst 55c9386c63724c5392c7040df4f8c387 msgid "rytpe" msgstr "" #: ../../page.rst:1172 ../../page.rst:2186 ../../page.rst:2270 #: ../../page.rst:2440 ../../page.rst:2447 2c6cefa6a7064fe39392c90935ff2122 #: 676e80ae36ef403cb3222e23c7e6840b 7a9f38940fcc4070a1e1cc06aa5851eb #: 8c51842a55794d7cbd92e8622328da3d fe56946be4db4f028208db1bac0c8edd msgid "int" msgstr "" #: ../../page.rst:1173 1779ac4a712d4617bd783fabd20b84ee msgid "the :data:`xref` of the installed font." msgstr "インストールされたフォントの :data:`xref`。" #: ../../page.rst:1175 f3eee244ef7e4992a7a6ffe42d5109ab msgid "" "Built-in fonts will not lead to the inclusion of a font file. So the " "resulting PDF file will remain small. However, your PDF viewer software " "is responsible for generating an appropriate appearance -- and there " "**exist** differences on whether or how each one of them does this. This " "is especially true for the CJK fonts. But also Symbol and ZapfDingbats " "are incorrectly handled in some cases. Following are the **Font Names** " "and their correspondingly installed **Base Font** names:" msgstr "" "組み込みフォントはフォントファイルの追加を必要とせず、結果として生成されるPDFファイルは小さく保たれます。ただし、PDFビューアソフトウェアは適切な外観を生成する責任があり、それぞれがこれをどのように行うかには違い" " " "**があります**。これは特にCJKフォントに関して当てはまります。しかし、シンボルとZapfDingbatsも一部のケースで正しく扱われていないことがあります。以下は" " **Font Names** とそれに対応するインストールされた **Base Font** 名です：" #: ../../page.rst:1177 0cc0406f7e4a492daeb1c4db6e780bb9 msgid "**Base-14 Fonts** [#f1]_" msgstr "**ベース14フォント** [1]" #: ../../page.rst:1180 ../../page.rst:1201 4be11b26fad54b2bb9545b4f821120d8 #: 5ba9280b3946433d8d5e7f1249a1c17a msgid "**Font Name**" msgstr "**フォント名**" #: ../../page.rst:1180 ../../page.rst:1201 eccfb3aa2983434c99d693447ff65632 #: f469987f95914ac38d3567e772be2909 msgid "**Installed Base Font**" msgstr "**インストールされたベースフォント**" #: ../../page.rst:1180 ../../page.rst:1201 0637ce2b61f94d70bfa5fd14cc3eba4e #: 779ba5a624ae4a31b519f88f420474a2 msgid "**Comments**" msgstr "**コメント**" #: ../../page.rst:1182 1346d71024ce401593ebe1b1ef929f0b msgid "helv" msgstr "" #: ../../page.rst:1182 8472540636cb4b3e80d4a141f2dc9490 msgid "Helvetica" msgstr "" #: ../../page.rst:1182 ../../page.rst:1186 ../../page.rst:1190 #: 15bcf8de9a4c4b42bd4547caeca437a2 26e37e84ddb44e20b9537973739375c3 #: 5c44fa7e15ec4ab29fb285d84ed09b05 msgid "normal" msgstr "通常" #: ../../page.rst:1183 3fee6d1ad3694348bf8fcac4335b1b17 msgid "heit" msgstr "" #: ../../page.rst:1183 87fa2f15152d45758b2638a2c65b0b80 msgid "Helvetica-Oblique" msgstr "" #: ../../page.rst:1183 ../../page.rst:1187 ../../page.rst:1191 #: 465a0dc7d5d8412d84bb0971fdc0b959 ab575e9dd96549db97f540585a2a1401 #: d09fc6af893444f8ab7b7f844d73072b msgid "italic" msgstr "斜体" #: ../../page.rst:1184 a90419279ba544bf97d046d85a18d8a6 msgid "hebo" msgstr "" #: ../../page.rst:1184 940f9d62685d47d79d73ba75f785b854 msgid "Helvetica-Bold" msgstr "" #: ../../page.rst:1184 ../../page.rst:1188 ../../page.rst:1192 #: 04cf9160aab94c5ea9fe0faf40ad7adf 97e04d362f7242fd8c53039399b33811 #: af07c4f6d96048b5a3bcb67c7533fee7 msgid "bold" msgstr "太字" #: ../../page.rst:1185 fde6ad4e4bcf48a7bd1e80b3871d9b92 msgid "hebi" msgstr "" #: ../../page.rst:1185 d81ace351e8e4bffab2c4c31676b09c7 msgid "Helvetica-BoldOblique" msgstr "" #: ../../page.rst:1185 ../../page.rst:1189 ../../page.rst:1193 #: 5e8fbcd6618b45a0b30369755eb54917 85cf3978bda64f41904f681d9066700d #: a49dcd7211ec4174a9e39f18f4f20287 msgid "bold-italic" msgstr "太字斜体" #: ../../page.rst:1186 eecbf522339f408682429018eb42d819 msgid "cour" msgstr "" #: ../../page.rst:1186 1aabbf1917b940a884122759b6201772 msgid "Courier" msgstr "" #: ../../page.rst:1187 2914ccf1d5474fb4a4171cd1fb40d000 msgid "coit" msgstr "" #: ../../page.rst:1187 356dc6005a6f4ccb8872f1d0dc02b045 msgid "Courier-Oblique" msgstr "" #: ../../page.rst:1188 3146fa4f560442ab8fd3866e31f9f31d msgid "cobo" msgstr "" #: ../../page.rst:1188 b7317958a6a64ff7b299cfa08352c7e3 msgid "Courier-Bold" msgstr "" #: ../../page.rst:1189 6314e10383d44543a4e6f83d8dfd36f5 msgid "cobi" msgstr "" #: ../../page.rst:1189 edae3864abe74d9e9967f2f6616f58ac msgid "Courier-BoldOblique" msgstr "" #: ../../page.rst:1190 8e463570936f44cea10cef6f53bfd751 msgid "tiro" msgstr "" #: ../../page.rst:1190 174a7e61ef724680ae4975dda6e210db msgid "Times-Roman" msgstr "" #: ../../page.rst:1191 e10c734e894746798210ea22c0453c7f msgid "tiit" msgstr "" #: ../../page.rst:1191 181f9f5afcfe408e803a31614283f687 msgid "Times-Italic" msgstr "" #: ../../page.rst:1192 e7fd292fdf5f46839550048a54d145c0 msgid "tibo" msgstr "" #: ../../page.rst:1192 cff467ef11664e0786a2da8638aaf7e8 msgid "Times-Bold" msgstr "" #: ../../page.rst:1193 feb7d3b171814377804d10433dd16286 msgid "tibi" msgstr "" #: ../../page.rst:1193 88f60b707d244358b731b9cf46cdb6aa msgid "Times-BoldItalic" msgstr "" #: ../../page.rst:1194 c57996e01b024a07b7dcdd172113e66d msgid "symb" msgstr "" #: ../../page.rst:1194 4ae4d7c1cb9a4dd5943b5159d29bd4fa msgid "Symbol" msgstr "" #: ../../page.rst:1194 ../../page.rst:1195 82ed675d31704bb7915d0d6fa3d61608 #: a2563ed5af004de389fd34f47716f55a msgid "[#f3]_" msgstr "" #: ../../page.rst:1195 699cea507d7a4aafaae0b57d2da6ff00 msgid "zadb" msgstr "" #: ../../page.rst:1195 c9971b33bd8f4ad1934c43cdca551699 msgid "ZapfDingbats" msgstr "" #: ../../page.rst:1198 ba64298625da4c61bff99a98efb06dda msgid "**CJK Fonts** [#f2]_ (China, Japan, Korea)" msgstr "**CJKフォント** [2] (中国、日本、韓国)" #: ../../page.rst:1203 f7a0ceef14004e83ae9d95c602fbdd52 msgid "china-s" msgstr "" #: ../../page.rst:1203 fcfbc81bc11d4acc8149da6092052844 msgid "Heiti" msgstr "" #: ../../page.rst:1203 1dd341e3f7214b41ab71ab4321f9eb68 msgid "simplified Chinese" msgstr "簡体字中国語" #: ../../page.rst:1204 5dd5140d1ee74ac7b20d9f83860874d5 msgid "china-ss" msgstr "" #: ../../page.rst:1204 93712db63e114dd28efb908d8da11df5 msgid "Song" msgstr "" #: ../../page.rst:1204 bce8b6de318645aaa2cfe29f0acb8e8e msgid "simplified Chinese (serif)" msgstr "簡体字中国語（セリフ）" #: ../../page.rst:1205 f0cbfe83750e4adbb3aa02a97efe7e9b msgid "china-t" msgstr "" #: ../../page.rst:1205 69f469612d1b4fbc9c41f2757d500ffd msgid "Fangti" msgstr "" #: ../../page.rst:1205 c14b5f7d14aa44cba182604bf144df6f msgid "traditional Chinese" msgstr "繁体字中国語" #: ../../page.rst:1206 a11679c0768a4e98874b92f12f1d87eb msgid "china-ts" msgstr "" #: ../../page.rst:1206 5370162be60f43e98245542771de88a0 msgid "Ming" msgstr "" #: ../../page.rst:1206 2a928b4cc6df4bfb80208379140e769c msgid "traditional Chinese (serif)" msgstr "繁体字中国語（セリフ）" #: ../../page.rst:1207 1b7f2377dd8f4f52b5ef57afe4eecde0 msgid "japan" msgstr "" #: ../../page.rst:1207 e34fddfb59a04f2a9b71c94d81918412 msgid "Gothic" msgstr "" #: ../../page.rst:1207 d5c5342d26fc4d6f96eb3997548c5851 msgid "Japanese" msgstr "" #: ../../page.rst:1208 12165a7df13e4b5ab6e43c7e32125931 msgid "japan-s" msgstr "" #: ../../page.rst:1208 0953d1d866774f409553c943377f12a3 msgid "Mincho" msgstr "" #: ../../page.rst:1208 9572a32bd5394a0fb22a993d3da56f12 msgid "Japanese (serif)" msgstr "" #: ../../page.rst:1209 b034ac397af24d97b54198b0dc1a0106 msgid "korea" msgstr "" #: ../../page.rst:1209 77d9bd94bd424297ae8d55caede11d7d msgid "Dotum" msgstr "" #: ../../page.rst:1209 137787a942204c3d92736320affcc205 msgid "Korean" msgstr "" #: ../../page.rst:1210 9a9d738dfda44b9aa58fb64b3124d6bc msgid "korea-s" msgstr "" #: ../../page.rst:1210 f4422a172efb456298f1cfe8feadd41f msgid "Batang" msgstr "" #: ../../page.rst:1210 44e44d3711ab4bc4b187b6a643352c2d msgid "Korean (serif)" msgstr "" #: ../../page.rst:1226 ebfe84984dbf44bba9f5d4cfd48dd7c5 msgid "" "PDF only: Put an image inside the given rectangle. The image may already " "exist in the PDF or be taken from a pixmap, a file, or a memory area." msgstr "PDFのみ：指定された矩形内に画像を配置します。画像はすでにPDF内に存在するか、ピクスマップ、ファイル、またはメモリ領域から取得できます。" #: ../../page.rst:1229 3aeff7f3684742f6808a7cb9c5d040e4 msgid "where to put the image. Must be finite and not empty." msgstr "画像を配置する場所。有限で空でない必要があります。" #: ../../page.rst:1230 d45e6802a1074852961e19a40ec99241 msgid "deprecated and ignored." msgstr "非推奨であり、無視されます。" #: ../../page.rst:1231 2fd482a63d504aba8d5a06556defeaca msgid "" "name of an image file (all formats supported by MuPDF -- see " ":ref:`ImageFiles`)." msgstr "画像ファイルの名前（MuPDFでサポートされているすべての形式 – :ref:`ImageFiles` を参照）。" #: ../../page.rst:1235 c2cd820ab2964b5da51744d5043c6110 msgid "maintain the aspect ratio of the image." msgstr "アスペクト比を保持するかどうか。" #: ../../page.rst:1237 8a4ab9cc08dc417c839101fc59d154c2 msgid "" "image in memory -- to be used as image mask (alpha values) for the base " "image. When specified, the base image must be provided as a filename or a" " stream -- and must not be an image that already has a mask." msgstr "" "メモリ内の画像 -- " "ベース画像のマスク（アルファ値）として使用されます。指定する場合、ベース画像はファイル名またはストリームとして提供する必要があります。また、既にマスクを持つ画像ではない必要があります。" #: ../../page.rst:1241 5950e8c3d6b049b49b8b33f3b7d7e984 msgid "" "(:data:`xref`) make image visibility dependent on this :data:`OCG` or " ":data:`OCMD`. Ignored after the first of multiple insertions. The " "property is stored with the generated PDF image object and therefore " "controls the image's visibility throughout the PDF." msgstr "" "(:data:`xref`) この画像の表示をこの :data:`OCG` または :data:`OCMD` " "に依存させます。複数回の挿入の最初の後には無視されます。このプロパティは生成された PDF 画像オブジェクトに格納されるため、PDF " "全体で画像の表示を制御します。" #: ../../page.rst:1246 ca9ec75c86ff49f1996ec1f71bd991f1 msgid "see :ref:`CommonParms`." msgstr ":ref:`CommonParms` を参照してください。" #: ../../page.rst:1247 2101e44007764ff4b9fc70034e923f14 msgid "a pixmap containing the image." msgstr "画像を含むピクスマップ。" #: ../../page.rst:1248 1c37153fd1a84795bd7d52d410652dd2 msgid "" "rotate the image. Must be an integer multiple of 90 degrees. Positive " "values rotate anti-clockwise. If you need a rotation by an arbitrary " "angle, consider converting the image to a PDF " "(:meth:`Document.convert_to_pdf`) first and then use " ":meth:`Page.show_pdf_page` instead." msgstr "" "(v1.14.11で新機能)* " "画像を回転させます。90度の整数倍である必要があります。正の値は反時計回りに回転します。任意の角度での回転が必要な場合は、まず画像をPDFに変換（:meth:`Document.convert_to_pdf`）し、:meth:`Page.show_pdf_page`" " を使用することを検討してください。" #: ../../page.rst:1255 d82f79d78a2149dea58350e93243aee9 msgid "image in memory (all formats supported by MuPDF -- see :ref:`ImageFiles`)." msgstr "メモリ内の画像（MuPDFでサポートされているすべての形式 – :ref:`ImageFiles` を参照）。" #: ../../page.rst:1258 624aeee769f14067b962ec6c6772884c msgid "" "the :data:`xref` of an image already present in the PDF. If given, " "parameters `filename`, `pixmap`, `stream`, `alpha` and `mask` are " "ignored. The page will simply receive a reference to the existing image." msgstr "" "PDF内にすでに存在する画像の :data:`xref` 。指定された場合、 `filename` 、 `Pixmap` 、 `stream` 、" " `alpha` 、および `mask` パラメータは無視されます。ページは単純に既存の画像への参照を受け取ります。" #: ../../page.rst:1266 256e69a0b35540ffa17700d11892d52a msgid "" "The `xref` of the embedded image. This can be used as the `xref` argument" " for very significant performance boosts, if the image is inserted again." msgstr "埋め込まれた画像の `xref` です。この値は、画像を再度挿入する場合のxref引数として使用でき、非常に大幅なパフォーマンス向上に役立ちます。" #: ../../page.rst:1271 1710b1878d634eec899b7e937995dd29 msgid "This example puts the same image on every page of a document::" msgstr "この例では、ドキュメントのすべてのページに同じ画像を配置します：" #: ../../page.rst:1286 d2f2977024734be187ee6c67296ceddc msgid "" "The method detects multiple insertions of the same image (like in the " "above example) and will store its data only on the first execution. This" " is even true (although less performant), if using the default `xref=0`." msgstr "" "このメソッドは、同じ画像が複数回挿入される場合（上記の例のように）を検出し、データは最初の実行時にのみ保存されます。これは、デフォルトの " "`xref=0` を使用している場合でも（性能は劣るが）同様です" #: ../../page.rst:1291 e09a9f96a77a45a3911b7156af831514 msgid "" "The method cannot detect if the same image had already been part of the " "file before opening it." msgstr "このメソッドは、ファイルを開く前に同じ画像がすでにファイルの一部であるかどうかを検出できません。" #: ../../page.rst:1295 0b1f424f05a748ab81ff1bafa6c48e60 msgid "" "You can use this method to provide a background or foreground image for " "the page, like a copyright or a watermark. Please remember, that " "watermarks require a transparent image if put in foreground ..." msgstr "このメソッドを使用して、ページの背景または前景画像（著作権表示や透かしのようなもの）を提供できます。ただし、前景に透明な画像が必要な場合は、そのことを覚えておいてください..." #: ../../page.rst:1300 ec6d73c55b6f48e58dce7dddb6b9b885 msgid "" "The image may be inserted uncompressed, e.g. if a `Pixmap` is used or if " "the image has an alpha channel. Therefore, consider using `deflate=True` " "when saving the file. In addition, there are ways to control the image " "size -- even if transparency comes into play. Have a look at " ":ref:`RecipesImages_O`." msgstr "" "画像は非圧縮で挿入されることがあります。たとえば、``Pixmap`` " "を使用するか、画像にアルファチャンネルがある場合です。したがって、ファイルを保存する際には *deflate=True* " "を使用することを検討してください。また、透明性が関与する場合でも、画像サイズを効果的に制御する方法が存在します。ドキュメンテーションの " ":ref:`RecipesImages_O` セクションをご覧ください。" #: ../../page.rst:1307 26f522e4130a45c996856013f4248085 msgid "" "The image is stored in the PDF at its original quality level. This may be" " much better than what you need for your display. Consider **decreasing " "the image size** before insertion -- e.g. by using the pixmap option and " "then shrinking it or scaling it down (see :ref:`Pixmap` chapter). The PIL" " method `Image.thumbnail()` can also be used for that purpose. The file " "size savings can be very significant." msgstr "" "画像はPDF内でその元の品質で保存されます。これは、ディスプレイに必要なものよりもはるかに優れている場合があります。挿入前に " "**画像サイズを減少させる** " "ことを検討してください。たとえば、Pixmapオプションを使用してから縮小または縮小することができます（:ref:`Pixmap` " "の章を参照）。PILメソッドの *Image.thumbnail()* " "もそのために使用できます。ファイルサイズの節約は非常に大きい場合があります。" #: ../../page.rst:1316 7dd604efc17a470f8e83896eb438e817 msgid "" "Another efficient way to display the same image on multiple pages is " "another method: :meth:`show_pdf_page`. Consult " ":meth:`Document.convert_to_pdf` for how to obtain intermediary PDFs " "usable for that method." msgstr "同じ画像を複数のページで効率的に表示する別の方法は、別のメソッドです：:meth:`show_pdf_page`。そのメソッドで使用可能な中間のPDFを取得する方法については、:meth:`Document.convert_to_pdf`" #: ../../page.rst:1323 007b8ec985c743b98a2526414fd73df2 msgid "Changed in v1.14.1: By default, the image keeps its aspect ratio." msgstr "v1.14.1で変更：デフォルトでは、画像はアスペクト比を保持します" #: ../../page.rst:1324 4452eaabf85e49498dd430de980d27e9 #, fuzzy msgid "Changed in v1.14.11: Added args `keep_proportion`, `rotate`." msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:1325 2ba03f5cc3b24b45b04e05c824efe689 msgid "Changed in v1.14.13:" msgstr "v1.14.17で変更されました" #: ../../page.rst:1328 7b5b3391686e4574b4aac42a4d8ace9a #, fuzzy msgid "" "The image is now always placed **centered** in the rectangle, i.e. the " "centers of image and rectangle are equal." msgstr "v1.14.13で変更：画像は矩形の **中央に** 常に配置されます。つまり、画像と矩形の中心が等しいです。" #: ../../page.rst:1330 ff7cb4876385436180fb0bf0bbb48d24 msgid "Added support for `stream` as `io.BytesIO`." msgstr "" #: ../../page.rst:1332 9cf81fa0283d4b9cb71320c19ac808f6 msgid "" "Changed in v1.17.6: Insertion rectangle no longer needs to have a non-" "empty intersection with the page's :attr:`Page.cropbox` [#f5]_." msgstr "v1.17.6で変更：挿入矩形はもはやページの :attr:`Page.cropbox` [#f5]_ と非空の交差を持つ必要はありません。" #: ../../page.rst:1335 bd6b8a78d7bc45058b5b8a9b6ec02558 #, fuzzy msgid "Changed in v1.18.1: Added `mask` arg." msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:1336 2c51ffb03126487db1b393ca77b62af8 #, fuzzy msgid "Changed in v1.18.3: Added `oc` arg." msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:1337 71b397af9ab44427bb4ab1ce54bdb69e #, fuzzy msgid "Changed in v1.18.13:" msgstr "v1.18.17で変更" #: ../../page.rst:1339 42bef278e6f241daa5aa1e58f8b0bd66 #, fuzzy msgid "Allow providing the image as the xref of an existing one." msgstr "v1.18.13で変更：既存の画像のxrefとして画像を提供できるようになりました。" #: ../../page.rst:1340 9ab36815831741359f4fd92d83098864 msgid "Added `xref` arg." msgstr "" #: ../../page.rst:1341 8cf02d8c00e0422f86c35c8edecd0bb3 #, fuzzy msgid "Return `xref` of stored image." msgstr "画像の :data:`xref`。" #: ../../page.rst:1343 0d480b48652b455db23c555469c7e152 #, fuzzy msgid "Changed in v1.19.3: deprecate and ignore `alpha` arg." msgstr "*(v1.19.3で変更)* 非推奨。指定された場合、無視されます。" #: ../../page.rst:1356 28427482b562417ea265e0fab0c58c39 msgid "Replace the image at xref with another one." msgstr "xrefで指定された画像を別の画像で置き換えます。" #: ../../page.rst:1358 ../../page.rst:1383 03972eac51224992b99445962cd73e00 #: fb26544be9924f54b1ea2b7cf64b51e5 msgid "the :data:`xref` of the image." msgstr "画像の :data:`xref`。" #: ../../page.rst:1359 4bb1648156be4a2e8852a24a6299b9e6 msgid "the filename of the new image." msgstr "新しい画像のファイル名。" #: ../../page.rst:1360 419422370be4417db9baaab1ddfbbdb9 msgid "the :ref:`Pixmap` of the new image." msgstr "新しい画像の :ref:`Pixmap`。" #: ../../page.rst:1361 ebfa76c83d5f40aaa2fd584dad3aca99 msgid "the memory area containing the new image." msgstr "新しい画像を含むメモリ領域。" #: ../../page.rst:1363 b020ddbad3f24249901bb68283bb3d41 msgid "" "Arguments `filename`, `pixmap`, `stream` have the same meaning as in " ":meth:`Page.insert_image`, especially exactly one of these must be " "provided." msgstr "" "`filename`、`pixmap`、`stream` の引数は、特に :meth:`Page.insert_image` " "での意味と同じです。特に、これらのうちの1つだけを指定する必要があります。" #: ../../page.rst:1365 7dcc679acb8646a2a981d441c0831067 msgid "" "This is a **global replacement:** the new image will also be shown " "wherever the old one has been displayed throughout the file." msgstr "これは **グローバルな置換** です：新しい画像は、古い画像がファイル全体で表示されていた場所でも表示されます。" #: ../../page.rst:1367 0d8c4f895bef4b01b332a9495dbed6f8 msgid "" "This method mainly exists for technical purposes. Typical uses include " "replacing large images by smaller versions, like a lower resolution, " "graylevel instead of colored, etc., or changing transparency." msgstr "このメソッドは主に技術的な目的で存在しています。典型的な使用例には、大きな画像を解像度の低いバージョン、カラーではなくグレースケールなど、より小さなバージョンで置き換えることが含まれます。または透明度を変更することもあります。" #: ../../page.rst:1371 ../../page.rst:1395 5e9c066911d24f75ae4f2ee7a54f420b #: 97f009de6f15443b920db61aeaad86da msgid "New in v1.21.0" msgstr "v1.21.0で新たに追加" #: ../../page.rst:1381 5368e85893144ec286056edbb95d01ce msgid "" "Delete the image at xref. This is slightly misleading: actually the image" " is being replaced with a small transparent :ref:`Pixmap` using above " ":meth:`Page.replace_image`. The visible effect however is equivalent." msgstr "" "画像のxrefを削除します。これはわずかに誤解を招くかもしれませんが、実際には、画像は上記の :meth:`Page.replace_image`" " を使用して小さな透明な :ref:`Pixmap` で置き換えられます。しかし、視覚的な効果は同等です。" #: ../../page.rst:1385 0831eb1b8bca4c61b2d3ebed9d550e5c msgid "" "This is a **global replacement:** the image will disappear wherever the " "old one has been displayed throughout the file." msgstr "これは **グローバルな置換です：** 新しい画像は、古い画像がファイル全体で表示されていた場所でも表示されなくなります。" #: ../../page.rst:1387 c9ddf64d62404209971e52006fcb17e7 msgid "" "If you inspect / extract a page's images by methods like " ":meth:`Page.get_images`, :meth:`Page.get_image_info` or " ":meth:`Page.get_text`, the replacing \"dummy\" image will be detected " "like so `(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` and " "also seem to \"cover\" the same boundary box on the page." msgstr "" ":meth:`Page.get_images`、:meth:`Page.get_image_info`、または " ":meth:`Page.get_text` " "などのメソッドを使用してページの画像を調査/抽出する場合、置き換えられた「ダミー」画像は次のように検出されます`(45, 47, 1, 1, 8," " 'DeviceGray', '', 'Im1', 'FlateDecode')` 、また同じ境界ボックスをページ上に「覆う」ように見えます。" #: ../../page.rst:1418 bb880c0f368a4fbbbae89df8e178f2da #, fuzzy msgid "" "Retrieves the content of a page in a variety of formats. Depending on the" " ``flags`` value, this may include text, images and several other object " "types. The method is a wrapper for multiple :ref:`TextPage` methods by " "choosing the output option `opt` as follows:" msgstr "" "さまざまな形式でページのコンテンツを取得します。出力オプション `opt` を選択することで、複数の :ref:`TextPage` " "メソッドのラッパーとなります。" #: ../../page.rst:1420 b344fdd22cdc43d98962ff99de701878 #, fuzzy msgid "" "\"text\" -- :meth:`TextPage.extractTEXT`, default. Always includes **text" " only.**" msgstr "“text” – :meth:`TextPage.extractTEXT`、デフォルト" #: ../../page.rst:1421 fbf6d08c721944dfac447c3a384d7bf5 msgid "" "\"blocks\" -- :meth:`TextPage.extractBLOCKS`. Includes text and **may** " "include image meta information." msgstr "" #: ../../page.rst:1422 722959ebcd9149aea46db80c88a28f83 msgid "\"words\" -- :meth:`TextPage.extractWORDS`. Always includes **text only.**" msgstr "" #: ../../page.rst:1423 bb571f32650b4f859aaed06999e59518 msgid "\"html\" -- :meth:`TextPage.extractHTML`. May include text and images." msgstr "" #: ../../page.rst:1424 30f45825dda040dcaadc3f958006270c msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`. May include text and images." msgstr "" #: ../../page.rst:1425 e24d7f1a9bb84b0ba6e43afd1213577c msgid "\"xml\" -- :meth:`TextPage.extractXML`. Always includes **text only.**" msgstr "" #: ../../page.rst:1426 1cc75fbc16704d78b2f7f039de703b41 msgid "\"dict\" -- :meth:`TextPage.extractDICT`. May include text and images." msgstr "" #: ../../page.rst:1427 9f8b972db8ef4ed4af0377bd3d686f04 msgid "\"json\" -- :meth:`TextPage.extractJSON`. May include text and images." msgstr "" #: ../../page.rst:1428 939274b46b2742a0b2f06125cc6a7de8 msgid "" "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`. May include text and " "images." msgstr "" #: ../../page.rst:1429 5cea2dd8403c40dba76071690ece94e8 msgid "" "\"rawjson\" -- :meth:`TextPage.extractRAWJSON`. May include text and " "images." msgstr "" #: ../../page.rst:1431 abfc7bb6441b49359a8be48ffb7d3299 #, fuzzy msgid "" "A string indicating the requested format, one of the above. A mixture of " "upper and lower case is supported. If misspelled, option \"text\" is " "silently assumed." msgstr "要求される形式を示す文字列、上記のいずれか。大文字と小文字の組み合わせがサポートされています" #: ../../page.rst:1433 00954f527a9d4159be3ea3fd320a5264 msgid "" "restrict the extraction to this rectangle. If ``None`` (default), the " "visible part of the page is taken. Any content (text, images) that is " "**not fully contained** in ``clip`` will be completely omitted. To avoid " "clipping altogether use ``clip=pymupdf.INFINITE_RECT()``. Only then the " "extraction will contain all items. This parameter has **no effect** on " "options \"html\", \"xhtml\" and \"xml\"." msgstr "" #: ../../page.rst:1435 d00942229f724825a1985c7a3b498e48 msgid "" "indicator bits to control whether to include images or how text should be" " handled with respect to white spaces and :data:`ligatures`. See " ":ref:`TextPreserve` for available indicators and " ":ref:`text_extraction_flags` for default settings. (New in v1.16.2)" msgstr "" "画像を含めるか、テキストをどのように空白や :data:`ligatures` に対応させるかを制御するための指示ビット。 " "使用可能な指示ビットについては、 :ref:`TextPreserve` を参照してください。 また、デフォルト設定については、 " ":ref:`text_extraction_flags` を参照してください。 (v1.16.2で新規追加)" #: ../../page.rst:1437 ff767e74ef754fd0b761adce1c0755af #, fuzzy msgid "" "use a previously created :ref:`TextPage`. This reduces execution time " "**very significantly:** by more than 50% and up to 95%, depending on the " "extraction option. If specified, the 'flags' and 'clip' arguments are " "ignored, because they are textpage-only properties. If omitted, a new, " "temporary textpage will be created." msgstr "" "(v1.19.0で新たに追加) 事前に作成したTextPageを使用します。これにより、実行時間が **非常に大幅に** " "削減されます：抽出オプションに応じて50％以上、95％まで削減されます。指定した場合、 'flags' および 'clip' " "引数は無視されます。テキストページ専用のプロパティであるためです。省略した場合、新しい一時的なテキストページが作成されます。" #: ../../page.rst:1439 0d379c1332d54af0b7fe997a2a196607 msgid "" "sort the output by vertical, then horizontal coordinates. In many cases, " "this should suffice to generate a \"natural\" reading order. Has no " "effect on (X)HTML and XML. For options \"blocks\", \"dict\", \"json\", " "\"rawdict\", \"rawjson\", sorting happens by coordinates `(y1, x0)` of " "the respective block bbox. For options \"words\" and \"text\", the text " "lines are completely re-synthesized to follow the reading sequence and " "appearance in the document -- which even establishes the original layout " "to some extent." msgstr "" #: ../../page.rst:1441 454f4d1a695349a5af19fe16e8ac850b msgid "" "use these characters as *additional* word separators with the \"words\" " "output option (ignored otherwise). By default, all white spaces " "(including non-breaking space `0xA0`) indicate start and end of a word. " "Now you can specify more characters causing this. For instance, the " "default will return `\"john.doe@outlook.com\"` as **one** word. If you " "specify `delimiters=\"@.\"` then the **four** words `\"john\"`, " "`\"doe\"`, `\"outlook\"`, `\"com\"` will be returned. Other possible uses" " include ignoring punctuation characters `delimiters=string.punctuation`." " The \"word\" strings will not contain any delimiting character. (New in " "v1.23.5)" msgstr "" "これらの文字を、追加の単語の区切りとして、\"words\" " "出力オプションで使用します（それ以外の場合は無視されます）。デフォルトでは、すべての空白（非改行スペース `0xA0` " "を含む）が単語の開始と終了を示します。これにより、さらにこれを引き起こす文字を指定できます。例えば、デフォルトでは " "\"john.doe@outlook.com\" は1つの単語として返されます。`delimiters=\"@.\"` " "と指定すると、\"john\"、\"doe\"、\"outlook\"、\"com\" " "の4つの単語が返されます。その他の可能な用途には、句読点を無視するための `delimiters = string.punctuation` " "があります。\"word\" 文字列には、区切り文字は含まれません。 (v1.23.5で新たに追加)" #: ../../page.rst:1443 1a1a305c24f342e6bf95c3f7d5abff5b msgid "*str, list, dict*" msgstr "" #: ../../page.rst:1444 b8027602fe4641e6baffd0342399c796 msgid "" "The page's content as a string, a list or a dictionary. Refer to the " "corresponding :ref:`TextPage` method for details." msgstr "ページの内容を表す文字列、リスト、または辞書。詳細については対応するTextPageメソッドを参照してください。" #: ../../page.rst:1448 f6258a84615d4051a4bdeefcbb6ae5c8 msgid "" "You can use this method as a **document conversion tool** from :ref:`any " "supported document type` to one of TEXT, HTML, " "XHTML or XML documents." msgstr "" "このメソッドを、:ref:`any supported document type` " "からTEXT、HTML、XHTML、またはXMLドキュメントのいずれかに変換する **ドキュメント変換ツール** として使用できます。" #: ../../page.rst:1449 d67d562f042b43baaec86719b9be1cc3 msgid "" "The inclusion of text via the *clip* parameter is decided on a by-" "character level: a character becomes part of the output, if its bbox is " "contained in `clip`. This **deviates** from the algorithm used in " "redaction annotations: a character will be **removed if its bbox " "intersects** any redaction annotation." msgstr "" #: ../../page.rst:1453 02b0706b377a4a2c8542b9912375c6fb msgid "Changed in v1.19.0: added `textpage` parameter" msgstr "v1.19.0で変更：`textpage` パラメータを追加" #: ../../page.rst:1454 6262160ff433484da974bfec2f1d6455 msgid "Changed in v1.19.1: added `sort` parameter" msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:1455 7d8a0f75db5141718c58f57c8ea61339 msgid "" "Changed in v1.19.6: added new constants for defining default flags per " "method." msgstr "v1.19.6で変更：各メソッドごとのデフォルトフラグを定義するための新しい定数を追加" #: ../../page.rst:1456 b540829e88b44088ab6080ee39781162 #, fuzzy msgid "Changed in v1.23.5: added `delimiters` parameter" msgstr "v1.19.1で変更：`sort` パラメータを追加" #: ../../page.rst:1457 f21302e5b5fc433d9eafad550a0c3bf3 msgid "" "Changed in v1.24.11: changed the effect of `sort_True` for \"text\" and " "\"words\" to closely follow natural reading sequence." msgstr "" #: ../../page.rst:1467 f72917c9df2643619cd122f9937e01b7 msgid "Retrieve the text contained in a rectangle." msgstr "指定された矩形に含まれるテキストを取得します。" #: ../../page.rst:1469 d29b943fb6264892af9f65f8294d080f msgid "rect-like." msgstr "矩形のようなもの。" #: ../../page.rst:1470 edd1211e0b82476bb7b10d17c964ea49 msgid "" "a :ref:`TextPage` to use. If omitted, a new, temporary textpage will be " "created." msgstr "使用する :ref:`TextPage`。省略した場合、新しい一時的なテキストページが作成されます。" #: ../../page.rst:1472 f969b8fc7f7c48728eeddb42868ce8ea #, fuzzy msgid "" "a string with interspersed linebreaks where necessary. It is based on " "dedicated code (changed in v1.19.0). A typical use is checking the result" " of :meth:`Page.search_for`: >>> rl = page.search_for(\"currency:\") >>>" " page.get_textbox(rl[0]) 'Currency:' >>>" msgstr "" "必要に応じて改行が挿入された文字列。v1.19.0 で変更: " "それは専用のコードに基づいています。典型的な使用例は、:meth:`Page.search_for` の結果をチェックすることです" #: ../../page.rst:1472 912cee7436a643138c8c1b4f9b301dae msgid "" "a string with interspersed linebreaks where necessary. It is based on " "dedicated code (changed in v1.19.0). A typical use is checking the result" " of :meth:`Page.search_for`:" msgstr "" "必要に応じて改行が挿入された文字列。v1.19.0 で変更: " "それは専用のコードに基づいています。典型的な使用例は、:meth:`Page.search_for` の結果をチェックすることです" #: ../../page.rst:1481 6de0c6ee1c03469881ba013d692e5e35 msgid "New in v1.17.7" msgstr "新機能 v1.17.7" #: ../../page.rst:1482 e4935dced8b94aca9efb4afba263a7fb msgid "Changed in v1.19.0: add `textpage` parameter" msgstr "v1.19.0 で変更: `textpage` パラメータを追加" #: ../../page.rst:1493 7a18efd3d4754d2684bd23bccf41f0ff msgid "Create a :ref:`TextPage` for the page." msgstr "ページ用の :ref:`TextPage` を作成します" #: ../../page.rst:1495 51e00198f9d646eab27c192b9aea744f msgid "" "indicator bits controlling the content available for subsequent text " "extractions and searches -- see the parameter of :meth:`Page.get_text`." msgstr "後続のテキスト抽出と検索で使用可能なコンテンツを制御する指示ビット – :meth:`Page.get_text` のパラメータを参照してください。" #: ../../page.rst:1497 5572906e140e44ecb06655f487590e67 msgid "restrict extracted text to this area. (New in v1.17.7)" msgstr "*(v1.17.7 で新機能)* 抽出されたテキストをこの領域に制限します。" #: ../../page.rst:1499 ed4c7fe483e04e7fa6ef285ed0aabfaa msgid ":ref:`TextPage`" msgstr "" #: ../../page.rst:1503 53211b14972c45ce95fed701a955ce76 msgid "New in v1.16.5" msgstr "v1.16.5 で新機能。" #: ../../page.rst:1504 776bf515596945789a57848499b6c4f3 msgid "Changed in v1.17.7: introduced `clip` parameter." msgstr "v1.17.7 で変更: `clip` パラメータが導入されました。" #: ../../page.rst:1518 c4dd0ac2f6c749dc86e9c9f46bc04ab4 msgid "" "**Optical Character Recognition** (**OCR**) technology can be used to " "extract text data for documents where text is in a raster image format " "throughout the page. Use this method to **OCR** a page for text " "extraction." msgstr "" "**光学式文字認識** （ **OCR** " "）技術は、ページ全体でテキストがラスター画像形式であるドキュメントからテキストデータを抽出するために使用できます。このメソッドを使用して、テキストの抽出のためにページを" " **OCR** します。" #: ../../page.rst:1520 b9a82917607b4e6cb945f63162446435 msgid "" "This method returns a :ref:`TextPage` for the page that includes OCRed " "text. MuPDF will invoke Tesseract-OCR if this method is used. Otherwise " "this is a normal :ref:`TextPage` object." msgstr "" "OCRed テキストを含むページの :ref:`TextPage` を作成します。このメソッドを使用すると、MuPDF は Tesseract-" "OCR を呼び出します。それ以外の場合、これは通常の :ref:`TextPage` オブジェクトです。" #: ../../page.rst:1522 0f72332f2d0b4578b4f0dee4584618de msgid "" "indicator bits controlling the content available for subsequent test " "extractions and searches -- see the parameter of :meth:`Page.get_text`." msgstr "後続のテキスト抽出と検索に使用可能なコンテンツを制御する指示ビット – :meth:`Page.get_text` のパラメータを参照してください。" #: ../../page.rst:1523 660122e729864444930eca6c6058d543 msgid "" "the expected language(s). Use \"+\"-separated values if multiple " "languages are expected, \"eng+spa\" for English and Spanish." msgstr "期待される言語。複数の言語が期待される場合は \"+\" で区切って指定します。たとえば英語とスペイン語の場合は \"eng+spa\" です。" #: ../../page.rst:1524 8e2055a7b98241ab8f2b99472fcd2b36 msgid "" "the desired resolution in dots per inch. Influences recognition quality " "(and execution time)." msgstr "インチ当たりのドット数で指定された解像度。認識品質（および実行時間）に影響を与えます。" #: ../../page.rst:1525 1bbb094f99c7482692d9722355ab839f msgid "whether to OCR the full page, or just the displayed images." msgstr "ページ全体を OCR するか、表示された画像のみを OCR するかを指定します。" #: ../../page.rst:1526 a86b4db13a9647eabfbe9a9ea7764250 msgid "" "The name of Tesseract's language support folder `tessdata`. If omitted, " "this information must be present as environment variable " "`TESSDATA_PREFIX`. Can be determined by function :meth:`get_tessdata`." msgstr "" "Tesseract の言語サポートフォルダ `tessdata` の名前。省略した場合、この情報は環境変数 `TESSDATA_PREFIX` " "として存在している必要があります。tessdata を取得する関数 :meth:`get_tessdata` によって決定できます。" #: ../../page.rst:1528 e2b38a41773d450b9d7fcba677c1cec3 msgid "" "This method does **not** support a clip parameter -- OCR will always " "happen for the complete page rectangle." msgstr "このメソッドは clip パラメータをサポート **していない** ため、OCR は常に完全なページ矩形に対して行われます" #: ../../page.rst:1530 67507d94eba94ed08e5eb43692679739 msgid "" "a :ref:`TextPage`. Execution may be significantly longer than " ":meth:`Page.get_textpage`. For a full page OCR, **all text** will have " "the font \"GlyphlessFont\" from Tesseract. In case of partial OCR, normal" " text will keep its properties, and only text coming from images will " "have the GlyphlessFont. .. note:: **OCRed text is only available** " "to PyMuPDF's text extractions and searches if their `textpage` parameter " "specifies the output of this method. `This Jupyter notebook " "`_ walks through an example for using OCR " "textpages." msgstr "" #: ../../page.rst:1532 cf2a7760cfb443baa47a4bc69a183a10 msgid "" "a :ref:`TextPage`. Execution may be significantly longer than " ":meth:`Page.get_textpage`." msgstr ":ref:`TextPage`。実行時間は :meth:`Page.get_textpage` よりも大幅に長くなる場合があります。" #: ../../page.rst:1534 59281044c1694fa8bc05052dde8a8b61 msgid "" "For a full page OCR, **all text** will have the font \"GlyphlessFont\" " "from Tesseract. In case of partial OCR, normal text will keep its " "properties, and only text coming from images will have the GlyphlessFont." msgstr "" "フルページの OCR の場合、**すべてのテキスト** は Tesseract の \"GlyphlessFont\" になります。部分的な " "OCR の場合、通常のテキストはそのプロパティを保持し、画像から来たテキストのみが GlyphlessFont になります。" #: ../../page.rst:1538 25c757f4eee247258f1ede687682f046 msgid "" "**OCRed text is only available** to PyMuPDF's text extractions and " "searches if their `textpage` parameter specifies the output of this " "method." msgstr "" "OCRed textは、PyMuPDFのテキスト抽出と検索でのみ利用可能であり、その `TextPage` " "パラメータがこのメソッドの出力を指定している場合にのみ利用できます。" #: ../../page.rst:1540 c435c939d0844f6a8b12eeb8cb97a60b #, fuzzy msgid "" "`This Jupyter notebook `_ walks " "through an example for using OCR textpages." msgstr "" "`このJupyter `_ ノートブックは、OCRテキストページを使用する例を説明します。" #: ../../page.rst:1544 82a1337f759a45e69b8059ba07c5f9ec msgid "New in v.1.19.0" msgstr "v1.19.0 で新機能" #: ../../page.rst:1545 ef149d6f0f034e2cabfcfa52f76ef29b msgid "Changed in v1.19.1: support full and partial OCRing a page." msgstr "v1.19.1 で変更: ページのフルと部分的な OCR をサポート" #: ../../page.rst:1552 f8e43b5512004252930e9ec3cb8121e3 msgid "" "Return the vector graphics of the page. These are instructions which draw" " lines, rectangles, quadruples or curves, including properties like " "colors, transparency, line width and dashing, etc. Alternative terms are " "\"line art\" and \"drawings\"." msgstr "ページのベクトルグラフィックスを返します。これらは線、四角形、四角形または曲線を描画するための命令で、色、透明度、線の幅、点線などのプロパティを含みます。代替用語は「ラインアート」と「ドローイング」です。" #: ../../page.rst:1554 869b1f3970494e6d891c51443fe53cb5 msgid "" "a list of dictionaries. Each dictionary item contains one or more single " "draw commands belonging together: they have the same properties (colors, " "dashing, etc.). This is called a **\"path\"** in PDF, so we adopted that " "name here, but the method **works for all document types**." msgstr "" "辞書のリスト。各辞書アイテムには、同じプロパティ（色、破線など）を持つ1つ以上の単一の描画コマンドが含まれます。これらはPDFでは " "**\"path\"** と呼ばれ、ここではその名前を採用していますが、このメソッドは **すべてのドキュメントタイプに対して機能します**。" #: ../../page.rst:1556 f3e8e14810b346db9e0d9daf21785bd0 msgid "" "The path dictionary for fill, stroke and fill-stroke paths has been " "designed to be compatible with class :ref:`Shape`. There are the " "following keys:" msgstr "" "fill、stroke、fill-strokeパスのパス辞書は、:ref:`Shape` " "クラスと互換性があるように設計されています。次のキーがあります：" #: ../../page.rst:1559 ../../page.rst:1624 ../../page.rst:1639 #: 67ad4d2045064408a1ba01ed1133b577 684b63cfdbba471590c8920f29d9f8f7 #: 841c49d1b9c3471fbd4b6331bd834c2d msgid "Key" msgstr "キー" #: ../../page.rst:1559 ../../page.rst:1624 ../../page.rst:1639 #: 53eafcdffbbb462692a32a21d65807cb b73ebbf5174947a7b65775975c268fef #: e6a75d84f7894a54b059143c3eb6d496 msgid "Value" msgstr "値" #: ../../page.rst:1561 ../../page.rst:1626 1cd5ef8dbb2a41cab7389e8a152a5f80 #: dba13b652f364711bedc84bf0829f6b0 msgid "closePath" msgstr "" #: ../../page.rst:1561 ../../page.rst:1568 17de4ae5744f46daa1814aa43c42758f #: 8a0b75118dfd46d1a51e9b65a3de4a58 msgid "Same as the parameter in :ref:`Shape`." msgstr ":ref:`Shape` のパラメーターと同じです。" #: ../../page.rst:1562 e7b3e55be02b4642bd39a31728cf6bfc msgid "color" msgstr "" #: ../../page.rst:1562 1f9691afbd1947d59d6a9c1931f7114a msgid "Stroke color (see :ref:`Shape`)." msgstr "ストロークカラー（:ref:`Shape` を参照）。" #: ../../page.rst:1563 a41f8ac8ad3c456c94b7b376478779c4 msgid "dashes" msgstr "" #: ../../page.rst:1563 75fe6e50f5354e64a476154321cf2884 msgid "Dashed line specification (see :ref:`Shape`)." msgstr "破線の仕様（:ref:`Shape` を参照）。" #: ../../page.rst:1564 ../../page.rst:1627 6893e5608b214e1f8f7e27b226873876 #: b0d4725240454e9fadaba4f5c5c850ed msgid "even_odd" msgstr "" #: ../../page.rst:1564 dc9d1115e0404dcbb68abe6eb77a8b35 msgid "Fill colors of area overlaps -- same as the parameter in :ref:`Shape`." msgstr "領域のオーバーラップの塗りつぶし色（:ref:`Shape` を参照）。" #: ../../page.rst:1565 26b27fdfbe5a46b8b0b8281a09a482b2 msgid "fill" msgstr "" #: ../../page.rst:1565 fd5b317c225545fbb8250da001708803 msgid "Fill color (see :ref:`Shape`)." msgstr "塗りつぶしカラー（:ref:`Shape` を参照）。" #: ../../page.rst:1566 ../../page.rst:1628 35545459a9b744d0a23e37a9aef542d4 #: cb4b82247f4d424fa9f883be7d91afd4 msgid "items" msgstr "" #: ../../page.rst:1566 493c8c2dec8f4027bdb28b760e666c1b msgid "List of draw commands: lines, rectangles, quads or curves." msgstr "描画コマンド（直線、四角形、四角形、曲線など）のリスト。" #: ../../page.rst:1567 37210e119ca1451290adf2a89f269cb2 msgid "lineCap" msgstr "" #: ../../page.rst:1567 a2626ee2b3a74e1fb776f90793e227c5 msgid "Number 3-tuple, use its max value on output with :ref:`Shape`." msgstr "3つの数値からなるタプル。出力時に :ref:`Shape` との最大値を使用します。" #: ../../page.rst:1568 f4d8e219e2f64f1680a7c881a83b260c msgid "lineJoin" msgstr "" #: ../../page.rst:1569 950e8cc3745342f7826691d71f31f7e5 msgid "fill_opacity" msgstr "" #: ../../page.rst:1569 4d4650f75a8e4396adfded67df0767c3 msgid "fill color transparency (see :ref:`Shape`). (New in v1.18.17)" msgstr "v1.18.17で新しく追加された塗りつぶしカラーの透明度（:ref:`Shape` を参照）。" #: ../../page.rst:1570 e9b05909669b4677b8e3a68eb18f0588 msgid "stroke_opacity" msgstr "" #: ../../page.rst:1570 b9a5e59fcfd14e9b9aae6f4ff5098865 msgid "stroke color transparency (see :ref:`Shape`). (New in v1.18.17)" msgstr "v1.18.17で新しく追加されたストロークカラーの透明度（:ref:`Shape` を参照）。" #: ../../page.rst:1571 ../../page.rst:1629 ../../page.rst:1641 #: 396b005a11e4432ab5482ffe50b3d61d 80c6973f07714e1c9453b787c54bf5b7 #: ea83089bd43b454894be96e4850f824b msgid "rect" msgstr "" #: ../../page.rst:1571 9d7bacf5e4354e0c86c3c9bd4401f6dc msgid "Page area covered by this path. Information only." msgstr "このパスでカバーされるページ領域。情報のみ。" #: ../../page.rst:1572 ../../page.rst:1630 ../../page.rst:1642 #: 24fac03d9b2b451384416fe5f78db143 a67392e66f764fd4b96c6c091fcfe069 #: ba34e287651645a8a7de9f9ce9ef0d5c msgid "layer" msgstr "" #: ../../page.rst:1572 285aa0882ae1442d94405a6a35a4492d msgid "name of applicable Optional Content Group. (New in v1.22.0)" msgstr "v1.22.0で新しく追加された適用可能なオプションコンテンツグループの名前" #: ../../page.rst:1573 ../../page.rst:1631 ../../page.rst:1643 #: 273156c615254021b3cf1e377897bbc5 3b054f8bb5b9486d99b99e62d3bf5685 #: a84a2657ecc24963828aa7e4dadfeab4 msgid "level" msgstr "" #: ../../page.rst:1573 110acb6bf408488e9e421af328fa9d51 msgid "the hierarchy level if `extended=True`. (New in v1.22.0)" msgstr "v1.22.0で新しく追加された `extended=True` の場合の階層レベル" #: ../../page.rst:1574 755b90abd14946a39aeeb0c3a6d64858 msgid "seqno" msgstr "" #: ../../page.rst:1574 ab333668880148c5bcbb944ff2e72050 msgid "command number when building page appearance. (New in v1.19.0)" msgstr "v1.19.0で新しく追加されたページ表示を構築する際のコマンド番号" #: ../../page.rst ../../page.rst:1575 ../../page.rst:1633 ../../page.rst:1648 #: 09c8e555385e47fc97e73ebfd3dd04bf 0d0baa2c58864bf0aaf04e11bbc433d9 #: 16fd53bebab845e7b14791cb33f919fe 31ce9aa1df7e40a68f2c5f62e6ba484b #: 3410a53940f0434ca67cfb41198bb2f0 35e83c59c3514d7fb3b3153505e76068 #: 506e3da6e2804fb5a0ba281b65419ac2 52415d0516fe43aa963858ff74eb86c3 #: 5e9311c5c55c47c1b2b2cadc4a66db12 62864ef6f3db473292d55c992c0de8c7 #: 695c03fb5cb74905af8b144210886b6c 6d88f9f8146647408ca720eb2639440d #: 70c939a93c2e4d07b551c6a3357d38bb 71b611108f864cb2a6bfea2fd779ca40 #: 80808763cc4e4f07b8b9799442a48d04 83e3d24314624f098b245e49198c48d1 #: 87a6add728944a7c978acf71d98c584e 8aea933f1c4c46608271d33b001e3347 #: 8b6a6acc29f24bfdb57d92ac9e4a045a 92ff84c878f34a4594725fae0575009b #: 9438f342c06943fface3e341a34df2b8 974268f30c784035a84eaebfe210cd18 #: 9bb07cd381434d8b82e253ba5094c088 a96abc6aa8864f4d92f1c9428ccf8b75 #: ae50cdfdfd9b4989a954861e1a55164a b63e1567826045b5a119a457977b02a7 #: b650a636652a4bed990a6e58a75790ed bbb50ffa42684b95a959efa8633eb29c #: c9b439ade3814c0d8ded9fc9af2b9bc8 caf0437e4fff4cd49a3205aaccb6cc79 #: cb13688627aa446181023ea67d345fe1 e22bdcabea7145ad86fae5a319b7a90a #: fc4dc4c3601b4fc0ba378cbd5a35dda6 msgid "type" msgstr "" #: ../../page.rst:1575 da590961ef344547956aadf05b289b30 msgid "type of this path. (New in v1.18.17)" msgstr "このパスのタイプ。 (v1.18.17で新規追加)" #: ../../page.rst:1576 ../../page.rst:1719 4aa3677ead1f4c61bb6574218d24bab9 #: 6118b6070da0480c9a1c25e056ec8abb msgid "width" msgstr "" #: ../../page.rst:1576 a6722de8bea742f18c275db16917fc03 msgid "Stroke line width. (see :ref:`Shape`)." msgstr "ストロークラインの幅（:ref:`Shape` を参照）。" #: ../../page.rst:1579 ed5265d8748c41bc89dcea0e43820815 msgid "" "Key `\"opacity\"` has been replaced by the new keys `\"fill_opacity\"` " "and `\"stroke_opacity\"`. This is now compatible with the corresponding " "parameters of :meth:`Shape.finish`. (Changed in v1.18.17)" msgstr "" "*(バージョン1.18.17で変更)* キー `\"opacity\"` は新しいキー `\"fill_opacity\"` および " "\"stroke_opacity\"` に置き換えられました。これは、:meth:`Shape.finish` " "の対応するパラメーターと互換性があるようになりました。" #: ../../page.rst:1582 32f9db8262474d6cb9e66a650d39602d msgid "" "For paths other than groups or clips, key `\"type\"` takes one of the " "following values:" msgstr "グループやクリップ以外のパスに対して、キー `\"type\"` は次のいずれかの値を取ります：" #: ../../page.rst:1584 c0b05d924d2a4c7693eed244061cb086 msgid "" "**\"f\"** -- this is a *fill-only* path. Only key-values relevant for " "this operation have a meaning, not applicable ones are present with a " "value of ``None``: `\"color\"`, `\"lineCap\"`, `\"lineJoin\"`, " "`\"width\"`, `\"closePath\"`, `\"dashes\"` and should be ignored." msgstr "" "**\"f\"** - これは *fill-only* のパスです。この操作に関連するキーの値のみが意味を持ち、適用されないものは値が " "``None`` で存在します。: " "`\"color\"`、`\"lineCap\"`、\"lineJoin\"`、`\"width\"`、`\"closePath\"`、`\"dashes\"`" " は無視すべきです。" #: ../../page.rst:1585 8c8a235505ce4644a896122fad7d5260 msgid "" "**\"s\"** -- this is a *stroke-only* path. Similar to previous, key " "`\"fill\"` is present with value ``None``." msgstr "" "**\"s\"** - これは *stroke-only* のパスです。以前と同様に、キー `\"fill\"` は値が ``None`` " "で存在します。" #: ../../page.rst:1586 af52343e1c124d299e93555b1fd95094 msgid "" "**\"fs\"** -- this is a path performing combined *fill* and *stroke* " "operations." msgstr "**\"fs\"** - これは *fill* と *stroke* の組み合わせ操作を実行するパスです" #: ../../page.rst:1588 43313ea722f34fc8a309b70525a81840 msgid "Each item in `path[\"items\"]` is one of the following:" msgstr "`path[\"items\"]` の各アイテムは、次のいずれかです：" #: ../../page.rst:1590 c739530352f348fab20572b09779faa4 msgid "`(\"l\", p1, p2)` - a line from p1 to p2 (:ref:`Point` objects)." msgstr "`(\"l\", p1, p2)` - p1 から p2 への直線（:ref:`Point` オブジェクト）。" #: ../../page.rst:1591 23c7b2f0773c4217b131c3ed4e91144d msgid "" "`(\"c\", p1, p2, p3, p4)` - cubic Bézier curve **from p1 to p4** (p2 and " "p3 are the control points). All objects are of type :ref:`Point`." msgstr "" "`(\"c\", p1, p2, p3, p4)` - **p1 から p4 へ** の三次ベジエ曲線（p2 と p3 " "は制御点です）。すべてのオブジェクトは :ref:`Point` タイプです。" #: ../../page.rst:1592 182b64307110415e801d9fd57ce0dd93 msgid "" "`(\"re\", rect, orientation)` - a :ref:`Rect`. Multiple rectangles within" " the same path are now detected (changed in v1.18.17). Integer " "`orientation` is 1 resp. -1 indicating whether the enclosed area is " "rotated left (1 = anti-clockwise), or resp. right [#f7]_ (changed in " "v1.19.2)." msgstr "" "`(\"re\", rect, orientation)` - a :ref:`Rect` 同じパス内の複数の矩形が検出されます " "(v1.18.17で変更)。整数のorientationは、含まれる領域が左に回転しているかどうかを示します (1 = " "反時計回り)。または右に回転しているかどうかを示します [#f7]_ (v1.19.2で変更)" #: ../../page.rst:1593 a1e0959514f34373885cee413d61fe44 msgid "" "`(\"qu\", quad)` - a :ref:`Quad`. 3 or 4 consecutive lines are detected " "to actually represent a :ref:`Quad` (changed in v1.19.2:). (New in " "v1.18.17)" msgstr "" "`(\"qu\", quad)` - " ":ref:`Quad`。*バージョン1.18.17で新しく追加され、バージョン1.19.2で変更されました:* 3つまたは4つの連続する線が " "Quad を実際に表すことが検出されます。" #: ../../page.rst:1597 8737dee28b734402854dc865731fa242 #, fuzzy msgid "" "Using class :ref:`Shape`, you should be able to recreate the original " "drawings on a separate (PDF) page with high fidelity under normal, not " "too sophisticated circumstances. Please see the following comments on " "restrictions. A coding draft can be found in :ref:`How to Extract " "Drawings `." msgstr "" "クラス :ref:`Shape` " "を使用すると、通常の、あまり洗練されていない状況で、高い忠実度で元の図面を別の（PDF）ページに再作成できるはずです。制約事項に関する以下のコメントをご覧ください。コーディングのドラフトは、:ref:`FAQ`" " の「図面の抽出」章のセクションにあります。" #: ../../page.rst:1599 3aab8e3a27f344888a1f81b6a87ca092 msgid "" "Specifying `extended=True` significantly alters the output. Most " "importantly, new dictionary types are present: \"clip\" and \"group\". " "All paths will now be organized in a hierarchic structure which is " "encoded by the new integer key \"level\", the hierarchy level. Each group" " or clip establishes a new hierarchy, which applies to all subsequent " "paths having a *larger* level value. (New in v1.22.0)" msgstr "" "extended=Trueを指定すると、出力が大幅に変更されます。最も重要なのは、新しい辞書タイプが存在することです: \"clip\" および " "\"group\"。すべてのパスは、新しい整数キー " "\"level\"、つまり階層レベルでエンコードされた階層構造に組織されます。各グループまたはクリップは、新しい階層を確立し、それ以降のすべてのパスに適用されます。" " (v1.22.0で新規)" #: ../../page.rst:1601 1748684dc4e14785be96e811eeb77ccd msgid "" "Any path with a smaller level value than its predecessor will end the " "scope of (at least) the preceding hierarchy level. A \"clip\" path with " "the same level as the preceding clip will end the scope of that clip. " "Same is true for groups. This is best explained by an example::" msgstr "" "前任者よりも小さいレベル値を持つパスは、少なくとも前の階層レベルのスコープを終了します。前のクリップと同じレベルの \"clip\" " "パスは、そのクリップのスコープを終了します。同様に、グループも同じです。これは、次の例で最もよく説明されます：" #: ../../page.rst:1617 6f3f822ea769448791e724a14fb47c4e msgid "" "The clip in line 0 applies to line including line 7. Group in line 2 " "applies to lines 3 to 5, clip in line 3 only applies to line 4." msgstr "行0の「clip」は行7を含む行全体に適用されます。行2の「group」は行3から5までの行に適用され、行3の「clip」は行4にのみ適用されます。" #: ../../page.rst:1619 e9f022fb71814f56ad2df5f517acbd13 msgid "" "\"stroke\" in line 4 is under control of \"group\" in line 2 and \"clip\"" " in line 3 (which in turn is a subset of line 0 clip)." msgstr "行4の「stroke」は行2の「group」と行3の「clip」（それ自体が行0の「clip」のサブセットです）の制御下にあります。" #: ../../page.rst:1621 6625c75c092d46e3a7e09245afa0c057 msgid "" "**\"clip\"** dictionary. Its values (most importantly \"scissor\") remain" " valid / apply as long as following dictionaries have a **larger " "\"level\"** value." msgstr "**「clip」** 辞書。その値（特に「scissor」）は、後続の辞書が「level」の値が大きい限り、有効で適用されます。" #: ../../page.rst:1626 ../../page.rst:1627 ../../page.rst:1628 #: ../../page.rst:1629 ../../page.rst:1630 ../../page.rst:1631 #: ../../page.rst:1641 ../../page.rst:1642 ../../page.rst:1643 #: 0b1b63f41c404901b1643b11b45a5867 62247667752f4b578ccac9e0ecbf590f #: 7c9a0aa3e8c649d7bee3ac7454b43e93 8366a70901664384adfb01a3b67ee7a8 #: 953f66d4fd474cbab098faaf2de24bd4 9aa1a22c1adb4eb9a1439d3e2ff1dc95 #: a1f6eff494b646fbb07a9a6339af5a87 bc4222fbdf6542cdbb7491fb0063b6a2 #: c1372886b46f46a5afba4a892a59ac6b msgid "Same as in \"stroke\" or \"fill\" dictionaries" msgstr "「stroke」または「fill」の辞書と同じ" #: ../../page.rst:1632 ab690b8cb544494f80184b0c2875a553 msgid "scissor" msgstr "" #: ../../page.rst:1632 236ed2afc6734846a1cae6d95ea45663 msgid "the clip rectangle" msgstr "クリップ矩形" #: ../../page.rst:1633 d15367360f8c488fb8e82f9a295c789d msgid "\"clip\"" msgstr "" #: ../../page.rst:1636 d738d1231fd84ceb820cca1d992713db msgid "" "\"group\" dictionary. Its values remain valid (apply) as long as " "following dictionaries have a **larger \"level\"** value. Any dictionary " "with an equal or lower level end this group." msgstr "「group」辞書。その値は、後続の辞書が「level」の値が大きい限り、有効で適用されます。同じレベルまたはそれ以下の辞書がこのグループを終了します。" #: ../../page.rst:1644 cd11376cc4d0426fa447eb7c0f0baff9 msgid "isolated" msgstr "" #: ../../page.rst:1644 e0738e311c024fb998234f0f1fe4f9ed msgid "(bool) Whether this group is isolated" msgstr "（ブール）このグループが孤立しているかどうか" #: ../../page.rst:1645 b2ae44ac73bb4cae949ced93c0d41e4d msgid "knockout" msgstr "" #: ../../page.rst:1645 156f97e7dd9a462388446f5d35f3992c msgid "(bool) Whether this is a \"Knockout Group\"" msgstr "（ブール）これが「Knockout Group」であるかどうか" #: ../../page.rst:1646 ded1960d4efa41c88ecdaba0d99c93a7 msgid "blendmode" msgstr "" #: ../../page.rst:1646 5a270db7a07242328025288ce3607085 msgid "Name of the BlendMode, default is \"Normal\"" msgstr "BlendModeの名前、デフォルトは「Normal」" #: ../../page.rst:1647 404d1a92eafc46789f2290501a8b3971 msgid "opacity" msgstr "" #: ../../page.rst:1647 c6cec53ea64546d5ada9351c5f7021dc msgid "Float value in range [0, 1]." msgstr "範囲[0、1]内の浮動小数点値" #: ../../page.rst:1648 a32b4e5b645e47a38fae496213fe05c8 msgid "\"group\"" msgstr "" #: ../../page.rst:1651 2df5c71b6d04456cb8e757571346136a msgid "" "The method is based on the output of :meth:`Page.get_cdrawings` -- which " "is much faster, but requires somewhat more attention processing its " "output." msgstr "" "このメソッドは、 :meth:`Page.get_cdrawings` " "の出力に基づいています。これははるかに高速ですが、出力の処理には多少の注意が必要です。" #: ../../page.rst:1655 71f7d609802a4816840f59ed160efa23 msgid "New in v1.18.0" msgstr "v1.18.0で新規追加" #: ../../page.rst:1656 fb8f5286189c4662a4cceffc1eba220f msgid "Changed in v1.18.17" msgstr "v1.18.17で変更" #: ../../page.rst:1657 e68c9de4f0a34718a2f1dfa501188aa8 msgid "Changed in v1.19.0: add \"seqno\" key, remove \"clippings\" key" msgstr "v1.19.0で変更: “seqno”キーを追加、“clippings”キーを削除" #: ../../page.rst:1658 2ce82133d3a848308013a2da324444a8 msgid "" "Changed in v1.19.1: \"color\" / \"fill\" keys now always are either are " "RGB tuples or `None`. This resolves issues caused by exotic colorspaces." msgstr "" "v1.19.1で変更: “color” / " "“fill”キーは常にRGBタプルまたはNoneのいずれかであるように変更。これにより、異常なカラースペースに起因する問題が解消されます。" #: ../../page.rst:1659 9b91a351faa841d684907b0234c55356 msgid "" "Changed in v1.19.2: add an indicator for the *\"orientation\"* of the " "area covered by an \"re\" item." msgstr "v1.19.2で変更: \"re\" アイテムでカバーされる領域の *\"orientation\"* を示すインジケーターを追加" #: ../../page.rst:1660 75ed0d5f99574606ba73b9dd0420738f msgid "" "Changed in v1.22.0: add new key `\"layer\"` which contains the name of " "the Optional Content Group of the path (or `None`)." msgstr "v1.22.0で変更: 新しいキー `\"layer\"` を追加。これにはパスのオプションコンテンツグループの名前が含まれます（またはNone）。" #: ../../page.rst:1661 7008b61db0b949ac97b7f1bfa2e2e90c msgid "" "Changed in v1.22.0: add parameter `extended` to also return clipping and " "group paths." msgstr "v1.22.0で変更: クリッピングとグループパスも返すようにするためのパラメーター `extended` を追加" #: ../../page.rst:1669 a96f2efad24c40d9969480c93d059df4 msgid "" "Extract the vector graphics on the page. Apart from following technical " "differences, functionally equivalent to :meth:`Page.get_drawings`, but " "much faster:" msgstr "" "ページ上のベクトルグラフィックスを抽出します。技術的な違いを除いて、:meth:`Page.get_drawings` " "と機能的に同等ですが、はるかに高速です：" #: ../../page.rst:1671 3cf72c72b8b14a14956e2d8174d231e4 msgid "" "Every path type only contains the relevant keys, e.g. a stroke path has " "no `\"fill\"` color key. See comment in method :meth:`Page.get_drawings`." msgstr "" "各パスタイプには関連するキーのみ含まれます。たとえば、ストロークパスには `\"fill\"` カラーキーはありません。 " ":meth:`Page.get_drawings` メソッドのコメントを参照してください。" #: ../../page.rst:1672 80f8f4ff491c4bff8b8aa785b886d608 msgid "" "Coordinates are given as :data:`point_like`, :data:`rect_like` and " ":data:`quad_like` **tuples** -- not as :ref:`Point`, :ref:`Rect`, " ":ref:`Quad` objects." msgstr "" "座は :data:`point_like`、:data:`rect_like`、:data:`quad_like` の **tuples** " "として与えられます。:ref:`Point`、:ref:`Rect`、:ref:`Quad` オブジェクトとしてではなく。" #: ../../page.rst:1674 4b700daa5e5f40fa9606f84421e48b44 msgid "" "If performance is a concern, consider using this method: Compared to " "versions earlier than 1.18.17, you should see much shorter response " "times. We have seen pages that required 2 seconds then, now only need 200" " ms with this method." msgstr "性能が懸念される場合、このメソッドを使用することを検討してください。バージョン1.18.17より前と比較して、応答時間が大幅に短縮されるはずです。以前は2秒かかったページが、このメソッドを使用すると200ミリ秒で完了する場合もあります。" #: ../../page.rst:1678 82ced38ad2c542e2af33c904c6804a7d msgid "New in v1.18.17" msgstr "新機能（v1.18.17）" #: ../../page.rst:1679 0320aecb048143c88baa0ae5cd45aa17 msgid "Changed in v1.19.0: removed \"clippings\" key, added \"seqno\" key." msgstr "v1.19.0で変更：「clippings」キーを削除、新たに「seqno」キーを追加。" #: ../../page.rst:1680 13fe0b91e6a441d8a64550e72fe9e288 msgid "Changed in v1.19.1: always generate RGB color tuples." msgstr "v1.19.1で変更：常にRGBカラータプルを生成します。" #: ../../page.rst:1681 939fc3ee15724d3e9eca02626e4dd209 msgid "" "Changed in v1.22.0: added new key `\"layer\"` which contains the name of " "the Optional Content Group of the path (or `None`)." msgstr "v1.22.0で変更：新たに「layer」というキーが追加され、パスのオプションコンテンツグループの名前（またはNone）が含まれます。" #: ../../page.rst:1682 7d630d9224974c81a4aaefd5f9181654 #, fuzzy msgid "" "Changed in v1.22.0: added parameter `extended` to also return clipping " "paths." msgstr "v1.22.0で変更：クリッピングパスを返すためのパラメータ「extended」が追加されました。" #: ../../page.rst:1689 ea979f6ebe4e41efa9388507c821a9c8 msgid "" "PDF only: Return a list of fonts referenced by the page. Wrapper for " ":meth:`Document.get_page_fonts`." msgstr "PDFのみ：ページで参照されているフォントのリストを返します。:meth:`Document.get_page_fonts` のラッパーです。" #: ../../page.rst:1694 35702954b233483e986ca6767f8e2c41 msgid "" "PDF only: Return a list of images referenced by the page. Wrapper for " ":meth:`Document.get_page_images`." msgstr "PDFのみ：ページで参照されているイメージのリストを返します。:meth:`Document.get_page_images` のラッパーです。" #: ../../page.rst:1703 e27bbe5080354b09be116ea34e97539c msgid "" "Return a list of meta information dictionaries for all images displayed " "by the page. This works for all document types." msgstr "" #: ../../page.rst:1705 58b8fd3467b6413d95b81f9cd5c61415 msgid "" "Compute the MD5 hashcode for each encountered image, which allows " "identifying image duplicates. This adds the key `\"digest\"` to the " "output, whose value is a 16 byte `bytes` object. (New in v1.18.13)" msgstr "" "*新機能（v1.18.13)*：各イメージのMD5ハッシュコードを計算し、イメージの重複を識別できるようにします。これにより、出力に " "`\"digest\"` キーが追加され、その値は16バイトのバイトオブジェクトです。" #: ../../page.rst:1707 e89fb63bb59d4806b77c4b8d8330597e msgid "" "**PDF only.** Try to find the :data:`xref` for each image. Implies " "`hashes=True`. Adds the `\"xref\"` key to the dictionary. If not found, " "the value is 0, which means, the image is either \"inline\" or its xref " "is undetectable for some reason. Please note that this option has an " "extended response time, because the MD5 hashcode will be computed at " "least two times for each image with an xref. (New in v1.18.13)" msgstr "" #: ../../page.rst:1710 5c7d342802164ffc821b3c5a9df090ee msgid "" "A list of dictionaries. This includes information for **exactly those** " "images, that are shown on the page -- including *\"inline images\"*. The " "dictionary layout is similar to that of image blocks in " "`page.get_text(\"dict\")`. In contrast to images included in " ":meth:`Page.get_text`, image **binary content** is not loaded by this " "method, which drastically reduces memory usage. Another difference is " "that image detection is not restricted to the visible part of the page or" " any ``clip`` parameter: method :meth:`Page.get_text` will only extract " "images **fully contained** in the provided ``clip``. =============== " "=============================================================== **Key**" " **Value** =============== " "=============================================================== number" " block number (``int``) bbox image bbox on page, " ":data:`rect_like` width original image width (``int``) height" " original image height (``int``) cs-name colorspace name" " (``str``) colorspace colorspace.n (``int``) xres " "resolution in x-direction (``int``) [#f10]_ yres resolution in" " y-direction (``int``) [#f10]_ bpc bits per component " "(``int``) size storage occupied by image (``int``) digest" " MD5 hashcode (``bytes``), if ``hashes`` is true xref" " image :data:`xref` or 0, if *xrefs* is true transform " "matrix transforming image rect to bbox, :data:`matrix_like` has-mask" " whether the image is transparent and has a mask (``bool``) " "=============== " "=============================================================== Multiple" " occurrences of the same image are always reported. You can detect " "duplicates by comparing their `digest` values." msgstr "" #: ../../page.rst:1710 b56c6cfb35a14ff8aab2e98fbea4236b #, fuzzy msgid "" "A list of dictionaries. This includes information for **exactly those** " "images, that are shown on the page -- including *\"inline images\"*. The " "dictionary layout is similar to that of image blocks in " "`page.get_text(\"dict\")`." msgstr "" "辞書のリスト。これには、ページに表示されているイメージに関する情報が含まれます。:meth:`Page.get_text` " "で含まれている画像ブロックとは異なり、画像の **binary content** " "は読み込まれないため、メモリの使用量が大幅に削減されます。辞書のレイアウトは、ページ.get_text(\"dict\")内のイメージブロックと似ています。" #: ../../page.rst:1712 93ecc3c5bbae4c92ae4cecf391770755 msgid "" "In contrast to images included in :meth:`Page.get_text`, image **binary " "content** is not loaded by this method, which drastically reduces memory " "usage. Another difference is that image detection is not restricted to " "the visible part of the page or any ``clip`` parameter: method " ":meth:`Page.get_text` will only extract images **fully contained** in the" " provided ``clip``." msgstr "" #: ../../page.rst:1715 a7a064c18ac546ac8c5f5be2910e0bf3 msgid "**Key**" msgstr "**キー**" #: ../../page.rst:1715 d16e6fb7b03143b5ba0140010250fd69 msgid "**Value**" msgstr "**値**" #: ../../page.rst:1717 1907cae26e1b493e957c192126f8bd58 msgid "number" msgstr "" #: ../../page.rst:1717 d27911324a5a4a0fafd9d6e2550ef566 #, fuzzy msgid "block number (``int``)" msgstr "ブロック番号 *(整数)*" #: ../../page.rst:1718 f6a7c2aaf9e1462bbeeb72cb31bf79d9 msgid "bbox" msgstr "" #: ../../page.rst:1718 86eb7e0ea23f4bdcac8257dc8460c60c msgid "image bbox on page, :data:`rect_like`" msgstr "ページ上の画像の境界ボックス、:data:`rect_like`" #: ../../page.rst:1719 f952cb79a0dd4bcf9e6f76a0c369e396 #, fuzzy msgid "original image width (``int``)" msgstr "元の画像の幅 *(整数)*" #: ../../page.rst:1720 43cc7cf52ac3463abb66db570a2f515a msgid "height" msgstr "" #: ../../page.rst:1720 8ff4acda1c0b47359b27bb83e55ed142 #, fuzzy msgid "original image height (``int``)" msgstr "元の画像の高さ *(整数*" #: ../../page.rst:1721 7b5e02a5db25462a9201cb3ca634db93 msgid "cs-name" msgstr "" #: ../../page.rst:1721 e8aed799c5204ef995ee98b0e15b1752 #, fuzzy msgid "colorspace name (``str``)" msgstr "カラースペース名 *(文字列)*" #: ../../page.rst:1722 470b51b79e894363aa2f3e7b4395e012 msgid "colorspace" msgstr "" #: ../../page.rst:1722 66bd8b12699c4b87beaa2678b6847f61 #, fuzzy msgid "colorspace.n (``int``)" msgstr "colorspace.n *(整数)*" #: ../../page.rst:1723 010a2b1b2cc040d18328b23373335b39 msgid "xres" msgstr "" #: ../../page.rst:1723 8e9ab06b3360480a969c713111c0e1b7 #, fuzzy msgid "resolution in x-direction (``int``) [#f10]_" msgstr "x方向の解像度 *(整数)*" #: ../../page.rst:1724 2a2d1ea79f0e4c1d952227ba35b19bcc msgid "yres" msgstr "" #: ../../page.rst:1724 1f63c35a38104eaf9ac1f4c0a446c2d3 #, fuzzy msgid "resolution in y-direction (``int``) [#f10]_" msgstr "y方向の解像度 *(整数)*" #: ../../page.rst:1725 6afb17cd205b4d36b405379292e5cc7e msgid "bpc" msgstr "" #: ../../page.rst:1725 2b3f9b22e8954cc68e29c89a9755baab #, fuzzy msgid "bits per component (``int``)" msgstr "コンポーネントごとのビット数 *(整数)*" #: ../../page.rst:1726 87dc60b6e9dd4ff8b3e8dc2dac2d46f8 msgid "size" msgstr "" #: ../../page.rst:1726 a5aa0c1d578b42cf9833f66aca7fec20 #, fuzzy msgid "storage occupied by image (``int``)" msgstr "画像が占めるストレージ容量 *(整数)*" #: ../../page.rst:1727 5b99ae76cf7a47c58d86b4331f33c9a4 msgid "digest" msgstr "" #: ../../page.rst:1727 e999edeff85549c6a9c7ae83208b170d #, fuzzy msgid "MD5 hashcode (``bytes``), if ``hashes`` is true" msgstr "MD5ハッシュコード（バイト）、*hashes* がtrueの場合" #: ../../page.rst:1728 522f8069369a4655b9e90e66fce84ec6 msgid "xref" msgstr "" #: ../../page.rst:1728 0d5fc56e9adb4cc0add3fa114a0d0b1a msgid "image :data:`xref` or 0, if *xrefs* is true" msgstr "画像の :data:`xref` または0、*xrefs* がtrueの場合" #: ../../page.rst:1729 d500ae56d3ae4425a687416bc7d26d3e msgid "transform" msgstr "" #: ../../page.rst:1729 bbf4e06903aa4ffab22418f35b7f0346 msgid "matrix transforming image rect to bbox, :data:`matrix_like`" msgstr "画像の境界ボックスをbboxに変換するための行列、:data:`matrix_like`" #: ../../page.rst:1730 f0f0216b6f1541eaa6cc1001d10aea53 msgid "has-mask" msgstr "" #: ../../page.rst:1730 49f00035ed2d4832890306c637415dbb msgid "whether the image is transparent and has a mask (``bool``)" msgstr "" #: ../../page.rst:1733 3b610224f44344e5b62359a6e14b4856 msgid "" "Multiple occurrences of the same image are always reported. You can " "detect duplicates by comparing their `digest` values." msgstr "同じ画像の複数の出現は常に報告されます。digestの値を比較して重複を検出できます。" #: ../../page.rst:1737 946d5705f3bb433ba251ee6b7b08f6c3 msgid "New in v1.18.11" msgstr "*新機能（v1.18.11)*" #: ../../page.rst:1738 29620790dffa4bf8951b84a7d7d93aeb msgid "" "Changed in v1.18.13: added image MD5 hashcode computation and " ":data:`xref` search." msgstr "*v1.18.13で変更：* イメージのMD5ハッシュコードの計算と :data:`xref` の検索が追加されました。" #: ../../page.rst:1745 38f20a8134cf4edb84b0b83559c20eb7 msgid "" "PDF only: Return a list of Form XObjects referenced by the page. Wrapper " "for :meth:`Document.get_page_xobjects`." msgstr "" "PDFのみ：ページで参照されているフォームXObjectのリストを返します。:meth:`Document.get_page_xobjects` " "のラッパーです。" #: ../../page.rst:1753 f08fc49d243849d6907078ee53743eb5 msgid "" "PDF only: Return boundary boxes and transformation matrices of an " "embedded image. This is an improved version of " ":meth:`Page.get_image_bbox` with the following differences:" msgstr "" "PDFのみ：埋め込み画像の境界ボックスと変換行列を返します。これは :meth:`Page.get_image_bbox` " "の改良バージョンで、次の違いがあります：" #: ../../page.rst:1755 22156183966643a5abe5b2dcacf61595 msgid "" "There is no restriction on **how** the image is invoked (by the page or " "one of its Form XObjects). The result is always complete and correct." msgstr "" "画像が **どのように** " "呼び出されるかに制限はありません（ページまたはそのフォームXObjectのいずれかによって）。結果は常に完全かつ正確です。" #: ../../page.rst:1756 121ff8e320a1435bb587e969f50728e6 msgid "" "The result is a list of :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`) " "objects -- depending on *transform*. Each list item represents one " "location of the image on the page. Multiple occurrences might not be " "detectable by :meth:`Page.get_image_bbox`." msgstr "" "結果は :ref:`Rect` または（:ref:`Rect`、:ref:`Matrix`）オブジェクトのリストです（*transform* " "に応じて異なります）。各リスト項目は、ページ上の画像の1つの場所を表します。:meth:`Page.get_image_bbox` " "では複数の出現を検出できない場合があります。" #: ../../page.rst:1757 db0c1992b2224619af8e0a8bb266e3b1 msgid "" "The method invokes :meth:`Page.get_image_info` with `xrefs=True` and " "therefore has a noticeably longer response time than " ":meth:`Page.get_image_bbox`." msgstr "" "このメソッドは、`xrefs=True` で :meth:`Page.get_image_info` " "を呼び出すため、:meth:`Page.get_image_bbox` よりも明らかに長い応答時間がかかります。" #: ../../page.rst:1759 78a2677113da42d5bd78cf20c9620dbd msgid "" "an item of the list :meth:`Page.get_images`, or the reference **name** " "entry of such an item (item[7]), or the image :data:`xref`." msgstr "" ":meth:`Page.get_images` のリストアイテム、そのようなアイテムの参照 **name** " "エントリ（item[7]）、または画像の :data:`xref`。" #: ../../page.rst:1760 31656212bb61408a979a149a7a68a16a msgid "" "also return the matrix used to transform the image rectangle to the bbox " "on the page. If true, then tuples `(bbox, matrix)` are returned." msgstr "画像の矩形をbboxに変換するために使用される行列も返すかどうか。trueの場合、タプル `(bbox, matrix)` が返されます。" #: ../../page.rst:1763 60ceecb376bd4029a4ab81a98b09e532 msgid "" "Boundary boxes and respective transformation matrices for each image " "occurrence on the page. If the item is not on the page, an empty list " "`[]` is returned." msgstr "ページ上の各画像出現に対する境界ボックスとそれに対応する変換行列。アイテムがページ上にない場合、空のリスト `[]` が返されます。" #: ../../page.rst:1767 15d195e0ae454a65b7d0197c769e3ce8 #, fuzzy msgid "New in v1.18.13" msgstr "*v1.18.13で新規追加*" #: ../../page.rst:1777 94b1ab0ccf4f48ec8d1cb13b3f36d800 msgid "" "PDF only: Return boundary box and transformation matrix of an embedded " "image." msgstr "PDFのみ：埋め込まれたイメージの境界ボックスと変換行列を返します。" #: ../../page.rst:1779 8e645372dbf647aeb56ff450edaebd00 msgid "" "an item of the list :meth:`Page.get_images` with *full=True* specified, " "or the reference **name** entry of such an item, which is item[-3] (or " "item[7] respectively)." msgstr "" ":meth:`Page.get_images` のリストのアイテムで *full=True* " "が指定されているもの、またはそのようなアイテムの参照名 **name** エントリ、つまりitem[-3]（またはitem[7]）。" #: ../../page.rst:1780 428845107f2c47e2abc7f576c506ed08 msgid "" "return the matrix used to transform the image rectangle to the bbox on " "the page (new in v1.18.11). Default is just the bbox. If true, then a " "tuple `(bbox, matrix)` is returned." msgstr "" "*(v1.18.11で新規)* イメージの矩形をページのbboxに変換するために使用される行列も返すかどうか。デフォルトはbboxのみです。 " "trueの場合、タプル `(bbox, matrix)` が返されます。" #: ../../page.rst:1782 819ebb0f28364cdcba4fbe7ca98bd2d4 msgid ":ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`)" msgstr ":ref:`Rect` または（:ref:`Rect`、:ref:`Matrix`）" #: ../../page.rst:1783 ee52dd3a62a6439abd4fda83efaf8d5f msgid "" "the boundary box of the image -- optionally also its transformation " "matrix. |history_begin| * (Changed in v1.16.7): If the page in fact " "does not display this image, an infinite rectangle is returned now. In " "previous versions, an exception was raised. Formally invalid parameters " "still raise exceptions. * (Changed in v1.17.0): Only images referenced " "directly by the page are considered. This means that images occurring in " "embedded PDF pages are ignored and an exception is raised. * (Changed in " "v1.18.5): Removed the restriction introduced in v1.17.0: any item of the " "page's image list may be specified. * (Changed in v1.18.11): Partially " "re-instated a restriction: only those images are considered, that are " "either directly referenced by the page or by a Form XObject directly " "referenced by the page. * (Changed in v1.18.11): Optionally also return " "the transformation matrix together with the bbox as the tuple `(bbox, " "transform)`. |history_end|" msgstr "" #: ../../page.rst:1783 a7f8641e4ad14324ac60e051d749d295 msgid "" "the boundary box of the image -- optionally also its transformation " "matrix." msgstr "イメージの境界ボックス - オプションでその変換行列も。" #: ../../page.rst:1787 9e1a1ef665584353a75fb92c8bafa923 #, fuzzy msgid "" "(Changed in v1.16.7): If the page in fact does not display this image, an" " infinite rectangle is returned now. In previous versions, an exception " "was raised. Formally invalid parameters still raise exceptions." msgstr "" "*(v1.16.7で変更)* " "–実際にはこのイメージを表示していない場合、無限の矩形が返されるようになりました。以前のバージョンでは、例外が発生しました。形式的に無効なパラメータは引き続き例外を発生させます。" #: ../../page.rst:1788 ad45cfaae88845f6b9ecf0120285e6e9 #, fuzzy msgid "" "(Changed in v1.17.0): Only images referenced directly by the page are " "considered. This means that images occurring in embedded PDF pages are " "ignored and an exception is raised." msgstr "" "*(v1.17.0で変更)* " "–ページで直接参照されているイメージのみが考慮されます。これは、埋め込まれたPDFページに存在するイメージは無視され、例外が発生します。" #: ../../page.rst:1789 de570fe3dafb4fd99deff2899b6c1fc0 #, fuzzy msgid "" "(Changed in v1.18.5): Removed the restriction introduced in v1.17.0: any " "item of the page's image list may be specified." msgstr "*(v1.18.5で変更)* –v1.17.0で導入された制限を削除しました：ページのイメージリストの任意のアイテムを指定できます。" #: ../../page.rst:1790 e303c4b6b12a4d76a7a5f2c788dcb37e #, fuzzy msgid "" "(Changed in v1.18.11): Partially re-instated a restriction: only those " "images are considered, that are either directly referenced by the page or" " by a Form XObject directly referenced by the page." msgstr "" "*(v1.18.11で変更)* " "–一部の制限を部分的に再導入しました：ページで直接参照されるイメージまたはページで直接参照されるフォームXObjectによって参照されるイメージのみが考慮されます。" #: ../../page.rst:1791 bc011ef28d61422a955614e4c2d8dc86 #, fuzzy msgid "" "(Changed in v1.18.11): Optionally also return the transformation matrix " "together with the bbox as the tuple `(bbox, transform)`." msgstr "*(v1.18.11で変更)* –オプションでbboxと一緒に変換行列も返すことができます（タプルとして）。" #: ../../page.rst:1797 bcfcaef3b1814721b638515684f8d52c msgid "" "Be aware that :meth:`Page.get_images` may contain \"dead\" entries i.e. " "images, which the page **does not display**. This is no error, but " "intended by the PDF creator. No exception will be raised in this case, " "but an infinite rectangle is returned. You can avoid this from happening " "by executing :meth:`Page.clean_contents` before this method." msgstr "" ":meth:`Page.get_images` " "には「不要な」エントリが含まれている場合があることに注意してください。これはPDF作成者によって意図的に設定されたものであり、エラーではありません。この場合、例外は発生しませんが、無限の矩形が返されます。このような状況を回避するには、このメソッドの前に" " :meth:`Page.clean_contents` を実行することができます。" #: ../../page.rst:1798 49d027f793a94bafb910acbfe3e05a8b msgid "" "The image's \"transformation matrix\" is defined as the matrix, for which" " the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, " "lookup details here: :ref:`ImageTransformation`." msgstr "" "イメージの「変換行列」は、`bbox / transform == pymupdf.Rect(0, 0, 1, 1)` " "という式が真であるための行列であり、詳細はこちらを参照してください：:ref:`ImageTransformation`。" #: ../../page.rst:1802 70224468b38f44aebf1c2a1d3af4a178 msgid "Changed in v1.18.11: return image transformation matrix" msgstr "変更点 v1.18.11：イメージの変換行列を返すようになりました" #: ../../page.rst:1811 d3e86ad4c19a4d3292c0d4ddac497b97 msgid "" "Create an SVG image from the page. Only full page images are currently " "supported." msgstr "ページからSVGイメージを作成します。現在、フルページのイメージのみがサポートされています。" #: ../../page.rst:1813 1eff949fcbd24567ac700df17d5c59c4 msgid "a matrix, default is :ref:`Identity`." msgstr "行列、デフォルトは :ref:`Identity` です。" #: ../../page.rst:1814 df2f3c9f709a489c9ca5f91abbc6b312 msgid "" "-- controls how text is represented. ``True`` outputs each character as a" " series of elementary draw commands, which leads to a more precise text " "display in browsers, but a **very much larger** output for text-oriented " "pages. Display quality for ``False`` relies on the presence of the " "referenced fonts on the current system. For missing fonts, the internet " "browser will fall back to some default -- leading to unpleasant " "appearances. Choose ``False`` if you want to parse the text of the SVG. " "(New in v1.17.5)" msgstr "" "テキストの表現方法を制御します。``True`` " "は、各文字を一連の基本的な描画コマンドとして出力し、これによりブラウザでのテキスト表示がより正確になりますが、テキスト指向のページの場合、非常に大きな出力になります。``False``" " " "の場合、表示品質は現在のシステムに参照されるフォントの存在に依存します。欠落しているフォントの場合、インターネットブラウザはいくつかのデフォルトにフォールバックします" " -- これにより見栄えが悪くなります。SVGのテキストを解析したい場合は ``False`` を選択してください。(v1.17.5で新規追加)" #: ../../page.rst:1816 255d76aeb25540379f4e2750fc40476e msgid "" "a UTF-8 encoded string that contains the image. Because SVG has XML " "syntax it can be saved in a text file, the standard extension is `.svg`." " .. note:: In case of a PDF, you can circumvent the \"full page image " "only\" restriction by modifying the page's CropBox before using the " "method." msgstr "" #: ../../page.rst:1816 d70d0e09fa10457c899a88af18ac233f msgid "" "a UTF-8 encoded string that contains the image. Because SVG has XML " "syntax it can be saved in a text file, the standard extension is `.svg`." msgstr "" "UTF-8エンコードされた文字列で、イメージを含みます。 SVGにはXML構文があるため、テキストファイルに保存でき、標準の拡張子は `.svg`" " です。" #: ../../page.rst:1818 2038b89974854ccb915bf35207525477 msgid "" "In case of a PDF, you can circumvent the \"full page image only\" " "restriction by modifying the page's CropBox before using the method." msgstr "PDFの場合、メソッドを使用する前に、ページのCropBoxを変更して「フルページイメージのみ」制限を回避できます。" #: ../../page.rst:1830 49256f649c7340c2b5790800b7a54e49 msgid "" "Create a pixmap from the page. This is probably the most often used " "method to create a :ref:`Pixmap`." msgstr "ページからピクスマップを作成します。おそらく、:ref:`Pixmap` を作成するために最も頻繁に使用されるメソッドでしょう。" #: ../../page.rst:1832 05f2f80f7ace4f0f8eb70cf8231a45fb msgid "All parameters are *keyword-only.*" msgstr "すべてのパラメータは *keyword-only.* です。" #: ../../page.rst:1834 3aff081d3a1d4330a5efbb941d465d5d msgid "default is :ref:`Identity`." msgstr "デフォルトは :ref:`Identity` です。" #: ../../page.rst:1835 13d257c5df27414c9c926dad92e8d2b4 #, fuzzy msgid "" "desired resolution in x and y direction. If not `None`, the `\"matrix\"` " "parameter is ignored. (New in v1.19.2)" msgstr "(v1.19.2で新たに追加) x方向およびy方向の所望の解像度。`None` でない場合、`\"matrix\"` パラメータは無視されます。" #: ../../page.rst:1836 eff39884626a45f0af6b14007330fc96 msgid "" "The desired colorspace, one of \"GRAY\", \"RGB\" or \"CMYK\" (case " "insensitive). Or specify a :ref:`Colorspace`, ie. one of the predefined " "ones: :data:`csGRAY`, :data:`csRGB` or :data:`csCMYK`." msgstr "" "所望のカラースペース、\"GRAY\"、\"RGB\"、または\"CMYK\"のいずれか（大文字/小文字を区別しない）。または、:ref:`Colorspace`" " のように、事前定義されたもののいずれかを指定できます：:data:`csGRAY`、:data:`csRGB`、:data:`csCMYK`。" #: ../../page.rst:1838 8dda6eb66c8a4a9dbb71d8d35094999d msgid "" "restrict rendering to the intersection of this area with the page's " "rectangle." msgstr "ページの矩形とこの領域の交差に描画を制限します。" #: ../../page.rst:1839 0f258e14c9804c39ad177677aeda8455 #, fuzzy, python-format msgid "" "whether to add an alpha channel. Always accept the default ``False`` if " "you do not really need transparency. This will save a lot of memory (25% " "in case of RGB ... and pixmaps are typically **large**!), and also " "processing time. Also note an **important difference** in how the image " "will be rendered: with ``True`` the pixmap's samples area will be pre-" "cleared with *0x00*. This results in **transparent** areas where the page" " is empty. With ``False`` the pixmap's samples will be pre-cleared with " "*0xff*. This results in **white** where the page has nothing to show. " "|history_begin| Changed in v1.14.17 The default alpha value is now " "``False``. * Generated with *alpha=True* .. image:: images/img-" "alpha-1.* * Generated with *alpha=False* .. image:: images/img-" "alpha-0.* |history_end|" msgstr "" "透明チャネルを追加するかどうか。本当に透明性が必要でない場合は、常にデフォルトの ``False`` " "を受け入れてください。これにより、メモリ（RGBの場合25％…ピクスマップは通常大きいです！）と処理時間が大幅に節約されます。また、画像がレンダリングされる方法についても重要な違いに注意してください：" " ``True`` " "の場合、ピクスマップのサンプル領域は0x00で事前クリアされます。これにより、ページが空白の場所には透明な領域が表示されます。Falseの場合、ピクスマップのサンプルは" " *0xff* で事前クリアされます。これにより、ページに表示する内容がない場所には **white** が表示されます。" #: ../../page.rst:1839 9ed06c39712e4b0c9b1ef2b9190ad178 #, python-format msgid "" "whether to add an alpha channel. Always accept the default ``False`` if " "you do not really need transparency. This will save a lot of memory (25% " "in case of RGB ... and pixmaps are typically **large**!), and also " "processing time. Also note an **important difference** in how the image " "will be rendered: with ``True`` the pixmap's samples area will be pre-" "cleared with *0x00*. This results in **transparent** areas where the page" " is empty. With ``False`` the pixmap's samples will be pre-cleared with " "*0xff*. This results in **white** where the page has nothing to show." msgstr "" "透明チャネルを追加するかどうか。本当に透明性が必要でない場合は、常にデフォルトの ``False`` " "を受け入れてください。これにより、メモリ（RGBの場合25％…ピクスマップは通常大きいです！）と処理時間が大幅に節約されます。また、画像がレンダリングされる方法についても重要な違いに注意してください：" " ``True`` " "の場合、ピクスマップのサンプル領域は0x00で事前クリアされます。これにより、ページが空白の場所には透明な領域が表示されます。Falseの場合、ピクスマップのサンプルは" " *0xff* で事前クリアされます。これにより、ページに表示する内容がない場所には **white** が表示されます。" #: ../../page.rst:1853 99981aa2da1b40108adc66b7b571c447 msgid "Changed in v1.14.17" msgstr "v1.14.17で変更されました" #: ../../page.rst:1844 62f1b49c3dd141c7a8ef0c9daff44467 msgid "The default alpha value is now ``False``." msgstr "デフォルトのalpha値は ``False`` になりました。" #: ../../page.rst:1846 5166a6cd936e46849e89ded514dbdb2e msgid "Generated with *alpha=True*" msgstr "*alpha=True* で生成されたもの" #: ../../page.rst:1851 6528d1cab5cc405bb3b064f7c9215219 msgid "Generated with *alpha=False*" msgstr "*alpha=False* で生成されたもの" #: ../../page.rst:1857 d7ad01e00ec4466ca4c6561aac481fdc msgid "" "*(new in version 1.16.0)* whether to also render annotations or to " "suppress them. You can create pixmaps for annotations separately." msgstr "*(v1.16.0で新たに追加)* アノテーションをレンダリングするか抑制するか。注釈用に個別にピクスマップを作成できます。" #: ../../page.rst:1859 7bfc8bde1fbc42ba9c5adf955fb5f6fe msgid ":ref:`Pixmap`" msgstr "" #: ../../page.rst:1860 1036350ef4604f60bc3bfb184510331d msgid "" "Pixmap of the page. For fine-controlling the generated image, the by far " "most important parameter is **matrix**. E.g. you can increase or decrease" " the image resolution by using **Matrix(xzoom, yzoom)**. If zoom > 1, you" " will get a higher resolution: zoom=2 will double the number of pixels in" " that direction and thus generate a 2 times larger image. Non-positive " "values will flip horizontally, resp. vertically. Similarly, matrices also" " let you rotate or shear, and you can combine effects via e.g. matrix " "multiplication. See the :ref:`Matrix` section to learn more." msgstr "" "ページのピクスマップ。生成されたイメージを細かく制御するために、最も重要なパラメータは **matrix** " "です。たとえば、Matrix(xzoom, yzoom)を使用してイメージの解像度を増減させることができます。zoom > " "1の場合、より高い解像度が得られ、zoom=2はその方向のピクセル数を2倍にし、したがって2倍の大きさのイメージを生成します。非正の値は水平または垂直に反転させます。同様に、行列は回転やシアーも可能にし、行列の乗算を介して効果を組み合わせることもできます。詳細については、:ref:`Matrix`" " セクションをご覧ください。" #: ../../page.rst:1864 e709657156c54e5da49e39a889d755f4 msgid "" "The pixmap will have *\"premultiplied\"* pixels if `alpha=True`. To learn" " about some background, e.g. look for \"Premultiplied alpha\" `here " "`_." msgstr "" #: ../../page.rst:1866 dc63977f417c4d669f251e232b7449ef msgid "" "The method will respect any page rotation and will not exceed the " "intersection of `clip` and :attr:`Page.cropbox`. If you need the page's " "mediabox (and if this is a different rectangle), you can use a snippet " "like the following to achieve this::" msgstr "" "このメソッドはページの回転を尊重し、`clip` と :attr:`Page.cropbox` " "の交差を超えません。ページのmediaboxが必要な場合（およびこれが異なる矩形の場合）、次のようなスニペットを使用してこれを実現できます::" #: ../../page.rst:1884 fe786b6a9efe4d3c8dae1c2c34a4d27b msgid "Changed in v1.19.2: added support of parameter dpi." msgstr "v1.19.2で変更：dpiパラメータのサポートを追加。" #: ../../page.rst:1892 caeb4aa2a305433fa72d601d086e5dcc msgid "" "PDF only: return a list of the names of annotations, widgets and links. " "Technically, these are the */NM* values of every PDF object found in the " "page's */Annots* array." msgstr "" "PDFのみ：アノテーション、ウィジェット、およびリンクの名前のリストを返します。技術的には、これらはページの */Annots* " "配列で見つかるすべてのPDFオブジェクトの */NM* 値です。" #: ../../page.rst:1898 0699ea9e43f8424985dc482f87ffd38f msgid "New in v1.16.10" msgstr "新機能 v1.16.10" #: ../../page.rst:1905 d7384e93d12547c486263203beb5df89 msgid "" "PDF only: return a list of the :data:`xref` numbers of annotations, " "widgets and links -- technically of all entries found in the page's " "*/Annots* array." msgstr "" "PDFのみ：アノテーション、ウィジェット、およびリンクの :data:`xref` " "番号のリストを返します。技術的には、これらはページの/Annots配列で見つかるすべてのエントリのxrefです。" #: ../../page.rst:1908 5b6f31dd87454760829a55acc10e55e4 msgid "" "a list of items *(xref, type)* where type is the annotation type. Use the" " type to tell apart links, fields and annotations, see " ":ref:`AnnotationTypes`." msgstr "" "xref、タイプがアノテーションのタイプであるアイテム *(xref, type)* " "のリスト。リンク、フィールド、およびアノテーションを区別するためにタイプを使用します。:ref:`AnnotationTypes` " "を参照してください。" #: ../../page.rst:1912 ../../page.rst:1930 4b1840a2328c4c0491ae53e88e80dc76 #: b332754a68c4477fab234d683f4ccc96 msgid "New in v1.17.1" msgstr "新機能 v1.17.1" #: ../../page.rst:1919 53ebddaf93d34d5f9f69386f293f9c73 msgid "" "PDF only: return the annotation identified by *ident*. This may be its " "unique name (PDF `/NM` key), or its :data:`xref`." msgstr "PDFのみ：*ident* で識別されるアノテーションを返します。これはその一意の名前（PDF `/NM` キー）またはxrefかもしれません。" #: ../../page.rst:1921 afb025534f664db7ad9db85c38f9072f msgid "the annotation name or xref." msgstr "アノテーションの名前またはxref。" #: ../../page.rst:1924 91e98027fa814f2480abca950000bf48 msgid "the annotation or ``None``." msgstr "アノテーションまたは ``None``。" #: ../../page.rst:1926 32f21d6698f1497e83db2ebea1787d39 msgid "" "Methods :meth:`Page.annot_names`, :meth:`Page.annot_xrefs` provide lists " "of names or xrefs, respectively, from where an item may be picked and " "loaded via this method." msgstr "" "メソッド :meth:`Page.annot_names`、:meth:`Page.annot_xrefs` " "は、アイテムが取得およびこのメソッドを介して読み込まれる名前またはxrefのリストを提供します。" #: ../../page.rst:1936 cca236bad55648c5a810e50ea814bd7f msgid "PDF only: return the field identified by :data:`xref`." msgstr "PDFのみ：:data:`xref` で識別されるフィールドを返します。" #: ../../page.rst:1938 d134928d1cc946309ab62309be76ed11 msgid "the field's xref." msgstr "フィールドのxref。" #: ../../page.rst:1941 41e62df3bd46456bab6e1244b57e31a7 msgid "the field or ``None``." msgstr "フィールドまたは ``None``。" #: ../../page.rst:1943 9c8f4697de594066ae8f9cee0e8400f5 msgid "" "This is similar to the analogous method :meth:`Page.load_annot` -- except" " that here only the xref is supported as identifier." msgstr "これはメソッド :meth:`Page.load_annot` と同様ですが、ここでは識別子としてxrefのみがサポートされています。" #: ../../page.rst:1947 9edc19c825ad440887b7caf99bc36ec3 msgid "New in v1.19.6" msgstr "新機能 v1.19.6" #: ../../page.rst:1953 ad01580beaea437fbd1d6157e0f3a623 msgid "Return the first link on a page. Synonym of property :attr:`first_link`." msgstr "最初のリンクを返します。プロパティ :attr:`first_link` の同義語です。" #: ../../page.rst:1955 ../../page.rst:2252 a74924baab27499ea18455c3c6910571 #: dc342a221f14447d8a7417d1c20a4cc1 msgid ":ref:`Link`" msgstr "" #: ../../page.rst:1956 dee7a33cc0c84aa0b6adfd89805d64e8 msgid "first link on the page (or ``None``)." msgstr "ページ上の最初のリンク（または ``None``）。" #: ../../page.rst:1963 eb961b30b31c4afa82d2e0317201406b msgid "PDF only: Set the rotation of the page." msgstr "PDFのみ：ページの回転を設定します。" #: ../../page.rst:1965 469042c9d56641299b3be924dd53d60b msgid "" "An integer specifying the required rotation in degrees. Must be an " "integer multiple of 90. Values will be converted to one of 0, 90, 180, " "270." msgstr "度数で指定された必要な回転を表す整数。90の整数倍である必要があります。値は0、90、180、270のいずれかに変換されます。" #: ../../page.rst:1969 227ee516ba554a0cb14b99795c5e0a9f #, fuzzy msgid "PDF only: Change the colorspace components of all objects on page." msgstr "PDFのみ: ページの表示領域を変更します。" #: ../../page.rst:1971 d2515f60d6af4e17a82832e769938548 msgid "" "The desired count of color components. Must be one of 1, 3 or 4, which " "results in color spaces DeviceGray, DeviceRGB or DeviceCMYK respectively." " The method affects text, images and vector graphics. For instance, with " "the default value 1, a page will be converted to grayscale. If a page is " "already grayscale, the method will not cause visible changes -- " "independent of the value of ``components``." msgstr "" #: ../../page.rst:1973 dd674046551f4c3cb79fef4fa79b7b15 msgid "These changes are **permanent** and cannot be reverted." msgstr "" #: ../../page.rst:1977 9095c069ad1649f98d53bd1aaff0c92c msgid "" "PDF only: Permanently remove page content outside the given rectangle. " "This is similar to :meth:`Page.set_cropbox`, but the page's rectangle " "will not be changed, only the content outside the rectangle will be " "removed." msgstr "" #: ../../page.rst:1979 37a6c35649b145f08a5decf125e56bf2 #, fuzzy msgid "" "The rectangle to clip to. Must be finite and its intersection with the " "page must not be empty." msgstr "現在のページに画像を配置する場所。有限である必要があり、ページとの交差部分が空でない必要があります。" #: ../../page.rst:1981 9347d32590004624ad7e93346a5d559f msgid "" "The method works best for text: All text on the page will be removed " "(decided by single character) that has no intersection with the " "rectangle. For vector graphics, the method will remove all paths that " "have no intersection with the rectangle. For images, the method will " "remove all images that have no intersection with the rectangle. Vectors " "and images **having** an intersection with the rectangle, will be kept in" " their entirety." msgstr "" #: ../../page.rst:1983 f6a3ae3f011144d49017e42c7f6d1b6b msgid "" "The method roughly has the same effect as if four redactions had been " "applied that cover the rectangle's outside." msgstr "" #: ../../page.rst:1985 ae033183ff37421bbbd56e4a52f60bd2 #, fuzzy msgid "New in v1.26.4." msgstr "v1.16.4で新規追加" #: ../../page.rst:1989 1f930abbc15c4ff89b61da8eff5ec500 msgid "" "PDF only: Set page rotation to 0 while maintaining appearance and page " "content." msgstr "PDFのみ：外観とページ内容を維持しながらページの回転を0に設定します。" #: ../../page.rst:1991 30ffde127f4745dab1c91c8d166bf86b msgid "" "The inverted matrix used to achieve this change. If the page was not " "rotated (rotation 0), :ref:`Identity` is returned. The method " "automatically recomputes the rectangles of any annotations, links and " "widgets present on the page. This method may come in handy when e.g. " "used with :meth:`Page.show_pdf_page`." msgstr "" "この変更を実現するために使用される反転した行列。ページが回転していない場合（回転0）、:ref:`Identity` " "が返されます。メソッドは、ページに存在するアノテーション、リンク、およびウィジェットの矩形を自動的に再計算します" #: ../../page.rst:1991 33e0bd938fe84b5c8783dcfdf5544ae7 msgid "" "The inverted matrix used to achieve this change. If the page was not " "rotated (rotation 0), :ref:`Identity` is returned. The method " "automatically recomputes the rectangles of any annotations, links and " "widgets present on the page." msgstr "" "この変更を実現するために使用される反転した行列。ページが回転していない場合（回転0）、:ref:`Identity` " "が返されます。メソッドは、ページに存在するアノテーション、リンク、およびウィジェットの矩形を自動的に再計算します。" #: ../../page.rst:1993 2da47a2010e34b029e3f0edff15b2ea6 msgid "" "This method may come in handy when e.g. used with " ":meth:`Page.show_pdf_page`." msgstr "このメソッドは、たとえば :meth:`Page.show_pdf_page` と一緒に使用する場合に便利です。" #: ../../page.rst:2003 8097fb4ce62d438a9173044458d89700 msgid "" "PDF only: Display a page of another PDF. This is similar to " ":meth:`Page.insert_image` but the source page will appear like a copy of " "itself and will not be rasterized. This is a multi-purpose method. For " "example, you can use it to:" msgstr "" #: ../../page.rst:2005 a3de5ee714974a4bbc3c15d6db7c596e msgid "" "create \"n-up\" versions of existing PDF files, combining several input " "pages into **one output page** (see example `combine.py " "`_)," msgstr "" "既存のPDFファイルの「n-up」バージョンを作成し、複数の入力ページを1つの出力ページに結合します（例： `combine.py " "`_ を参照）。" #: ../../page.rst:2006 56a92497a6424d06ac1dc154b2b7c2e3 msgid "" "create \"posterized\" PDF files, i.e. every input page is split up in " "parts which each create a separate output page (see `posterize.py " "`_)," msgstr "" "「ポスター化」されたPDFファイルを作成します。つまり、各入力ページは別々の出力ページを作成する部分に分割されます（`posterize.py " "`_ を参照）。" #: ../../page.rst:2007 809839e89a244a85af528e2781c72346 #, fuzzy msgid "" "include PDF-based vector images like company logos, watermarks, etc., see" " `svg-logo.py `_, which puts an SVG-based " "logo on each page." msgstr "" "企業のロゴ、透かし画像など、PDFベースのベクトル画像を含めます。`svg-logo.py `_ " "は、各ページにSVGベースのロゴを配置します（SVGからPDFへの変換を処理するために追加のパッケージが必要です）。" #: ../../page.rst:2009 94e420eeb95544848178411930596331 msgid "" "where to place the image on current page. Must be finite and its " "intersection with the page must not be empty." msgstr "現在のページに画像を配置する場所。有限である必要があり、ページとの交差部分が空でない必要があります。" #: ../../page.rst:2010 4a518b41f0fa4d20a7ddfdacc3b5387e msgid "" "source PDF document containing the page. Must be a different document " "object, but may be the same file." msgstr "ページを含むソースPDFドキュメント。異なるドキュメントオブジェクトである必要がありますが、同じファイルであることもあります。" #: ../../page.rst:2013 2258364ee77342648f9f9d13598d61a0 msgid "page number (0-based, in `-∞ < pno < docsrc.page_count`) to be shown." msgstr "表示するページ番号（0から始まる、`-∞ < pno < docsrc.page_count`）。指定されたページ。" #: ../../page.rst:2015 9eb0129dc8f54fb9976933c50276a085 msgid "" "whether to maintain the width-height-ratio (default). If false, all 4 " "corners are always positioned on the border of the target rectangle -- " "whatever the rotation value. In general, this will deliver distorted and " "/or non-rectangular images." msgstr "幅高さ比率を維持するかどうか（デフォルト）。falseの場合、4つの角は常にターゲット矩形の境界に配置されます（回転値に関係なく）。一般的に、これは歪んだおよび/または非四角形の画像を提供します。" #: ../../page.rst:2017 85f7fd026bd24e8da3654da5636d9989 msgid "put image in foreground (default) or background." msgstr "画像を前景（デフォルト）または背景に配置します。" #: ../../page.rst:2019 42fcaea11ef446568915be1f505467ee msgid "" "(:data:`xref`) make visibility dependent on this :data:`OCG` / " ":data:`OCMD` (which must be defined in the target PDF) [#f9]_. (New in " "v1.18.3)" msgstr "" "*(v1.18.3で新機能)* （:data:`xref`）この :data:`OCG` / :data:`OCMD` " "（ターゲットPDFで定義されている必要があります）に依存する可視性を作成します [#f9]_。" #: ../../page.rst:2020 13030fbfedf34278a676f08d0826d36e msgid "" "show the source rectangle rotated by some angle. Any angle is supported " "(changed in v1.14.11). (New in v1.14.10)" msgstr "*(v1.14.10で新機能)* ソースの矩形を一定の角度で表示します" #: ../../page.rst:2022 149ad5f2cd814d68a80da796e0a382a0 msgid "" "choose which part of the source page to show. Default is the full page, " "else must be finite and its intersection with the source page must not be" " empty." msgstr "表示するソースページの一部を選択します。デフォルトはフルページですが、有限である必要があり、ソースページとの交差部分が空でない必要があります。" #: ../../page.rst:2024 b8efe161593647e58619c74b77cac9a2 #, fuzzy msgid "" "In contrast to method :meth:`Document.insert_pdf`, this method does not " "copy annotations, widgets or links, so these objects are not included in " "the target [#f6]_. But all its **other resources (text, images, fonts, " "etc.)** will be imported into the current PDF. They will therefore appear" " in text extractions and in :meth:`get_fonts` and :meth:`get_images` " "lists -- even if they are not contained in the visible area given by " "*clip*." msgstr "" "メソッド :meth:`Document.insert_pdf` " "とは異なり、このメソッドは注釈、ウィジェット、リンクをコピーしないため、これらは対象に含まれません " "[#f6]_。ただし、その他のすべてのリソース（テキスト、画像、フォントなど）は現在のPDFにインポートされます。したがって、テキストの抽出と " ":meth:`get_fonts` および :meth:`get_images` リストに表示されます。表示領域に含まれていなくても。" #: ../../page.rst:2026 a57abb1f967d4c35b6e7d4beed87ad89 msgid "Example: Show the same source page, rotated by 90 and by -90 degrees:" msgstr "例：同じソースページを90度と-90度回転して表示します。" #: ../../page.rst:2048 c1b751195e4c4efca470bedbe8800d2c msgid "" "Changed in v1.14.11: Parameter *reuse_xref* has been deprecated. Position" " the source rectangle centered in target rectangle. Any rotation angle is" " now supported." msgstr "v1.14.11で変更：パラメータreuse_xrefは非推奨となりました。ソースの矩形をターゲットの矩形の中央に配置します。任意の回転角度がサポートされます。" #: ../../page.rst:2049 81f070423325403d8564dc51aabef7ff msgid "Changed in v1.18.3: New parameter `oc`." msgstr "v1.18.3で変更：新しいパラメータ `oc` が追加されました。" #: ../../page.rst:2055 39c3b9e093904d029cf16873b12f7494 msgid "PDF only: Create a new :ref:`Shape` object for the page." msgstr "PDFのみ：ページ用の新しい :ref:`Shape` オブジェクトを作成します。" #: ../../page.rst:2057 fa925ab7db3840c19b1f80067f7da55d msgid ":ref:`Shape`" msgstr "" #: ../../page.rst:2058 6be44310501147678b1f55bb5578c9e3 msgid "a new :ref:`Shape` to use for compound drawings. See description there." msgstr "複合描画に使用する新しい :ref:`Shape` オブジェクト。詳細はそちらの説明を参照してください。" #: ../../page.rst:2069 a4ff3e983b264801b477b8f199b8e57b msgid "Search for *needle* on a page. Wrapper for :meth:`TextPage.search`." msgstr "ページ上で *needle* を検索します。:meth:`TextPage.search` のラッパーです。" #: ../../page.rst:2071 73895714ee9e477299763e3cb38e6b55 msgid "" "Text to search for. May contain spaces. Upper / lower case is ignored, " "but only works for ASCII characters: For example, \"COMPÉTENCES\" will " "not be found if needle is \"compétences\" -- \"compÉtences\" however " "will. Similar is true for German umlauts and the like." msgstr "検索対象のテキスト。スペースを含めることができます。大文字/小文字は無視されますが、ASCII文字に対してのみ機能します：たとえば、needleが「COMPÉTENCES」の場合、needleが「compétences」の場合には見つかりません。「compÉtences」の場合は見つかります。同様に、ドイツ語のウムラウトなどにも当てはまります。" #: ../../page.rst:2072 002d648a94cf4efd970e8372efdfacc3 #, fuzzy msgid "only search within this area. (New in v1.18.2)" msgstr "*(v1.18.2で新規追加)* この領域内でのみ検索します。" #: ../../page.rst:2073 76ceadd2652e4b9c8e90959e238bfc73 msgid "Return object type :ref:`Quad` instead of :ref:`Rect`." msgstr "四角形の代わりに :ref:`Quad` オブジェクトのタイプを返します。" #: ../../page.rst:2074 e6e8cb9ec29b4a5b839fca538d50fa20 msgid "" "Control the data extracted by the underlying :ref:`TextPage`. By default," " ligatures and white spaces are kept, and hyphenation [#f8]_ is detected." msgstr "" "基本となる :ref:`TextPage` によって抽出されるデータを制御します。デフォルトでは、リガチャと空白を保持し、ハイフン化 [#f8]_" " が検出されます。" #: ../../page.rst:2075 06406f39a7c54d7fa2b7e1270314e74c msgid "" "use a previously created :ref:`TextPage`. This reduces execution time " "**significantly.** If specified, the 'flags' and 'clip' arguments are " "ignored. If omitted, a temporary textpage will be created. (New in " "v1.19.0)" msgstr "" "以前に作成された :ref:`TextPage` （テキストページ）を使用します。これにより、実行時間が大幅に短縮されます。指定された場合、 " "'flags'および 'clip'引数は無視されます。省略された場合、一時的なテキストページが作成されます。 (v1.19.0で新規)" #: ../../page.rst:2079 939066ea93704b6e8c1b0f3cf6d6c2aa msgid "" "A list of :ref:`Rect` or :ref:`Quad` objects, each of which -- " "**normally!** -- surrounds one occurrence of *needle*. **However:** if " "parts of *needle* occur on more than one line, then a separate item is " "generated for each these parts. So, if `needle = \"search string\"`, two " "rectangles may be generated. |history_begin| Changes in v1.18.2: * " "There no longer is a limit on the list length (removal of the `hit_max` " "parameter). * If a word is **hyphenated** at a line break, it will still " "be found. E.g. the needle \"method\" will be found even if hyphenated as " "\"meth-od\" at a line break, and two rectangles will be returned: one " "surrounding \"meth\" (without the hyphen) and another one surrounding " "\"od\". |history_end|" msgstr "" #: ../../page.rst:2081 c05f559f100049cea4ceda637e6a62d8 msgid "" "A list of :ref:`Rect` or :ref:`Quad` objects, each of which -- " "**normally!** -- surrounds one occurrence of *needle*. **However:** if " "parts of *needle* occur on more than one line, then a separate item is " "generated for each these parts. So, if `needle = \"search string\"`, two " "rectangles may be generated." msgstr "" ":ref:`Rect` または :ref:`Quad` " "オブジェクトのリストで、通常、needleの一致を1つ囲みます。ただし、needleの一部が複数の行にまたがる場合、それぞれの部分に対して別のアイテムが生成されます。したがって、`needle" " = \"search string\"` の場合、2つの四角形が生成される可能性があります。" #: ../../page.rst:2085 a4fa930c59aa42a0aca0d7f145f57c91 #, fuzzy msgid "Changes in v1.18.2:" msgstr "**v1.18.2の変更点：**" #: ../../page.rst:2087 34a34ce97b8c4692a917624a7ecdb810 msgid "" "There no longer is a limit on the list length (removal of the `hit_max` " "parameter)." msgstr "リストの長さに制限はもうありません（`hit_max` パラメータの削除）。" #: ../../page.rst:2088 9a6ca09716d44c778fbec65e72e939e1 msgid "" "If a word is **hyphenated** at a line break, it will still be found. E.g." " the needle \"method\" will be found even if hyphenated as \"meth-od\" at" " a line break, and two rectangles will be returned: one surrounding " "\"meth\" (without the hyphen) and another one surrounding \"od\"." msgstr "" "単語が行の区切りでハイフン化されている場合でも、検出されます。たとえば、needleが行の区切りで「meth-" "od」としてハイフン化されていても、「method」としてハイフン化されていない部分を囲む1つの四角形と、「od」としてハイフン化されていない部分を囲む別の四角形が返されます。" #: ../../page.rst:2092 662052c0c33a4e73acb81cb5192fe61d msgid "" "The method supports multi-line text marker annotations: you can use the " "full returned list as **one single** parameter for creating the " "annotation." msgstr "このメソッドは、複数行のテキストマーカーアノテーションをサポートしており、返されたリスト全体を1つのパラメータとして使用してアノテーションを作成できます。" #: ../../page.rst:2096 d72d3688d1fe45db834e99d826ea81cb msgid "" "There is a tricky aspect: the search logic regards **contiguous multiple " "occurrences** of *needle* as one: assuming *needle* is \"abc\", and the " "page contains \"abc\" and \"abcabc\", then only **two** rectangles will " "be returned, one for \"abc\", and a second one for \"abcabc\"." msgstr "" "トリッキーな側面があります。検索ロジックは、連続した複数の *needle* の出現を1つと見なします。つまり、*needle* " "が「abc」で、ページに「abc」と「abcabc」が含まれている場合、2つの矩形のみが返され、1つは「abc」に、もう1つは「abcabc」になります。" #: ../../page.rst:2097 f5397b6783a14dba9b1af693cf68e148 msgid "" "You can always use :meth:`Page.get_textbox` to check what text actually " "is being surrounded by each rectangle." msgstr "常に :meth:`Page.get_textbox` を使用して、各矩形で実際に囲まれているテキストを確認できます。" #: ../../page.rst:2099 ebe71ed021b74b83bd40b6780f483fa1 msgid "" "A feature repeatedly asked for is supporting **regular expressions** when" " specifying the `\"needle\"` string: **There is no way to do this.** If " "you need something in that direction, first extract text in the desired " "format and then subselect the result by matching with some regex pattern." " Here is an example for matching words::" msgstr "" "`\"needle\"` " "文字列を指定する際に正規表現をサポートする機能が何度も要求されていますが、これを行う方法はありません。この方向性の何かが必要な場合は、まず希望の形式でテキストを抽出し、それを正規表現パターンと一致させて結果をサブセレクトしてください。単語を一致させる例を以下に示します。" #: ../../page.rst:2105 6bfe1b333a774f6484753f3cc3b8da11 msgid "" "The `matches` list will contain the words matching the given pattern. In " "the same way you can select `span[\"text\"]` from the output of " "`page.get_text(\"dict\")`." msgstr "" "`matches` リストには、指定されたパターンに一致する単語が含まれます。同様の方法で、`page.get_text(\"dict\")` " "の出力から `span[\"text\"]` を選択できます。" #: ../../page.rst:2109 8c1e32a30f8c426abf7dd87f6070bb8d msgid "" "Changed in v1.18.2: added `clip` parameter. Remove `hit_max` parameter. " "Add default \"dehyphenate\"." msgstr "v1.18.2で変更：`clip` パラメータを追加。`hit_max` パラメータを削除。デフォルトの「デハイフェネート」を追加。" #: ../../page.rst:2110 110f4cf460aa4ed6bec6ae04a6620637 msgid "Changed in v1.19.0: added `textpage` parameter." msgstr "v1.19.0で変更：`textpage` パラメータを追加。" #: ../../page.rst:2117 313a785cdc6f421b99568769e2acd45e msgid "" "PDF only: Change the physical page dimension by setting :data:`mediabox` " "in the page's object definition." msgstr "PDFのみ: ページのオブジェクト定義内で :data:`mediabox` を設定することにより、物理ページの寸法を変更します。" #: ../../page.rst:2119 8d1e74b016eb4617852f1fe9b546a5f9 msgid "the new :data:`mediabox` value." msgstr "新しい :data:`mediabox` の値。" #: ../../page.rst:2121 fc8bf8612c1b4ec497ac37834d417213 msgid "" "This method also removes the page's other (optional) rectangles " "(:data:`cropbox`, ArtBox, TrimBox and Bleedbox) to prevent inconsistent " "situations. This will cause those to assume their default values." msgstr "このメソッドは、ページの他の（オプションの）矩形（:data:`cropbox`、ArtBox、TrimBox、Bleedbox）も削除し、一貫性のない状況を防ぐためにそれらをデフォルト値に戻します。" #: ../../page.rst:2123 97c1c0ea8a6b47b2a9ddbc93131b0204 msgid "" "For non-empty pages this may have undesired effects, because the location" " of all content depends on this value and will therefore change position " "or even disappear." msgstr "これにより、非空のページでは望ましくない効果が発生する可能性があるため、すべてのコンテンツの位置がこの値に依存し、したがって位置が変わるか、完全に消える可能性があります。" #: ../../page.rst:2127 91c689a47be5437e8dac4417d5dd0848 msgid "New in v1.16.13" msgstr "v1.16.13で新規追加" #: ../../page.rst:2128 877c5c9a76684e38a46ebe2fbcc5ca68 msgid "Changed in v1.19.4: remove all other rectangle definitions." msgstr "v1.19.4で変更: 他のすべての矩形定義を削除しました。" #: ../../page.rst:2135 14fdd70511ec4ff2913a0491f7678978 msgid "PDF only: change the visible part of the page." msgstr "PDFのみ: ページの表示領域を変更します。" #: ../../page.rst:2137 7fa9c11b08f441dc87a46fc4dbf98182 msgid "" "the new visible area of the page. Note that this **must** be specified in" " **unrotated coordinates**, not empty, nor infinite and be completely " "contained in the :attr:`Page.mediabox`." msgstr "" "ページの新しい表示領域。これは回転していない座標で指定する必要があり、空ではなく、無限ではなく、:attr:`Page.mediabox` " "に完全に含まれている必要があります。" #: ../../page.rst:2139 25df1b49bf0a4d80891be253a545cf76 msgid "" "After execution **(if the page is not rotated)**, :attr:`Page.rect` will " "equal this rectangle, but be shifted to the top-left position (0, 0) if " "necessary. Example session:" msgstr "" "実行後（ページが回転していない場合）、:attr:`Page.rect` " "はこの矩形と等しくなりますが、必要に応じて左上の位置（0、0）にシフトされます。以下は例セッションです：" #: ../../page.rst:2170 2c53f6bfb41d4389ac83aca28049d92c msgid "" "PDF only: Set the resp. rectangle in the page object. For the meaning of " "these objects see :ref:`AdobeManual`, page 77. Parameter and restrictions" " are the same as for :meth:`Page.set_cropbox`." msgstr "" "PDFのみ: ページオブジェクト内の対応する矩形を設定します。これらのオブジェクトの意味については、:ref:`AdobeManual` " "の77ページを参照してください。パラメータと制約は :meth:`Page.set_cropbox` と同じです。" #: ../../page.rst:2174 51f449db2a3c44e189cf5fca9f485392 msgid "New in v1.19.4" msgstr "v1.19.4で新規追加" #: ../../page.rst:2180 d0971433c9404486893ed8f9b8260a5e msgid "" "Contains the rotation of the page in degrees (always 0 for non-PDF " "types). This is a copy of the value in the PDF file. The PDF " "documentation says:" msgstr "ページの回転角度を度数で含みます（非PDFタイプでは常に0）。" #: ../../page.rst:2182 e4d847e602314207b08e68c851df6531 msgid "" "*\"The number of degrees by which the page should be rotated clockwise " "when displayed or printed. The value must be a multiple of 90. Default " "value: 0.\"*" msgstr "*「ページを表示または印刷する際に、時計回りに回転させる度数。値は90の倍数でなければなりません。デフォルト値：0」* " #: ../../page.rst:2184 f95f2857345c4ab1b2ddf5e5bc9a02d7 msgid "" "In PyMuPDF, we make sure that this attribute is always one of 0, 90, 180 " "or 270." msgstr "PyMuPDFでは、この属性が常に0、90、180、または270のいずれかであることを確認しています。" #: ../../page.rst:2190 61f3d0cf602c4013b227d09247d5dea4 msgid "" "Contains the top-left point of the page's `/CropBox` for a PDF, otherwise" " *Point(0, 0)*." msgstr "PDFの場合、ページの `/CropBox` の左上の点を含みます。それ以外の場合は *Point(0, 0)*。" #: ../../page.rst:2192 ../../page.rst:2216 7816845ecf174917a69749a210307f96 #: a70e370c3c004de999a9efabfc433212 msgid ":ref:`Point`" msgstr "" #: ../../page.rst:2196 6c185f908ac141b989b3b83d6d62f20c msgid "" "The page's `/CropBox` for a PDF. Always the **unrotated** page rectangle " "is returned. For a non-PDF this will always equal the page rectangle." msgstr "" "PDFのページの `/CropBox` です。常に **回転していない** " "ページの矩形が返されます。非PDFの場合、これは常にページの矩形と等しいです。" #: ../../page.rst:2198 d7f9ff9e1ee9469888ae5361c32a62ff msgid "" "In PDF, the relationship between `/MediaBox`, `/CropBox` and page " "rectangle may sometimes be confusing, please do lookup the glossary for " ":data:`MediaBox`." msgstr "" "PDFでは、`/MediaBox`、`/CropBox`、およびページの矩形の関係は混乱することがあります。:data:`MediaBox` " "の用語集を参照してください。" #: ../../page.rst:2208 d9a54722197a46059242db3e1d3a7319 msgid "" "The page's `/ArtBox`, `/BleedBox`, `/TrimBox`, respectively. If not " "provided, defaulting to :attr:`Page.cropbox`." msgstr "" "PDFのページの/ArtBox、/BleedBox、/TrimBoxです。指定されていない場合、:attr:`Page.cropbox` " "にデフォルトで設定されます。" #: ../../page.rst:2214 23b408953e2a4e86961ce70710f0fac0 msgid "" "Contains the width and height of the page's :attr:`Page.mediabox` for a " "PDF, otherwise the bottom-right coordinates of :attr:`Page.rect`." msgstr "" "PDFのページの :attr:`Page.mediabox` の幅と高さを含みます。それ以外の場合、:attr:`Page.rect` " "の右下の座標です。" #: ../../page.rst:2220 3435a4b6c7174525b0cb781fce4321ef msgid "The page's :data:`mediabox` for a PDF, otherwise :attr:`Page.rect`." msgstr "PDFのページの :data:`mediabox`、それ以外の場合は :attr:`Page.rect` です。" #: ../../page.rst:2224 4df8f5c334964811a7137810e8a527a8 msgid "" "For most PDF documents and for **all other document types**, `page.rect " "== page.cropbox == page.mediabox` is true. However, for some PDFs the " "visible page is a true subset of :data:`mediabox`. Also, if the page is " "rotated, its `Page.rect` may not equal `Page.cropbox`. In these cases the" " above attributes help to correctly locate page elements." msgstr "" "ほとんどのPDF文書および他のすべてのドキュメントタイプに対して、`page.rect == page.cropbox == " "page.mediabox` が真です。ただし、一部のPDFでは、表示ページが v " "の真の部分集合である場合があります。また、ページが回転している場合、`Page.rect` は `Page.cropbox` " "と等しくないかもしれません。これらの場合、上記の属性はページの要素を正しく位置付けるのに役立ちます。" #: ../../page.rst:2228 d7f34f4307fe42d2b00939a7c2d9b9d6 msgid "" "This matrix translates coordinates from the PDF space to the MuPDF space." " For example, in PDF `/Rect [x0 y0 x1 y1]` the pair (x0, y0) specifies " "the **bottom-left** point of the rectangle -- in contrast to MuPDF's " "system, where (x0, y0) specify top-left. Multiplying the PDF coordinates " "with this matrix will deliver the (Py-) MuPDF rectangle version. " "Obviously, the inverse matrix will again yield the PDF rectangle." msgstr "" "この行列は、PDF空間からMuPDF空間への座標の変換に使用されます。たとえば、PDFの `/Rect [x0 y0 x1 y1]` " "では、ペア(x0、y0)が矩形の左下の点を指定します。これはMuPDFのシステムとは異なり、ここでは(x0、y0)は左上を指定します。PDF座標をこの行列で掛け算すると、（Py-）MuPDF矩形バージョンが得られます。明らかに、逆行列は再びPDF矩形を返します。" #: ../../page.rst:2230 ../../page.rst:2246 699d02c9b35a4d618e67346779cd3952 #: 6d0fd753260b4a269b9592b9ebba1e22 msgid ":ref:`Matrix`" msgstr "" #: ../../page.rst:2236 a5de7aa7bb6c40b4af9ab822d2fe0c61 msgid "" "These matrices may be used for dealing with rotated PDF pages. When " "adding / inserting anything to a PDF page, the coordinates of the " "**unrotated** page are always used. These matrices help translating " "between the two states. Example: if a page is rotated by 90 degrees -- " "what would then be the coordinates of the top-left Point(0, 0) of an A4 " "page?" msgstr "" "これらの行列は、回転したPDFページの取り扱いに使用できます。PDFページに何かを追加/挿入する際、**回転していない** " "ページの座標が常に使用されます。これらの行列は、2つの状態間での変換を支援します。例：ページが90度回転した場合、A4ページの左上のPoint(0," " 0)の座標は何になりますか？" #: ../../page.rst:2250 46775a2e1ffd4cc3a43e6c5596c0ead9 msgid "Contains the first :ref:`Link` of a page (or ``None``)." msgstr "ページの最初の :ref:`Link` を含みます（または ``None``）。" #: ../../page.rst:2256 0768580c4efd4f2d93de5acfbd002a40 msgid "Contains the first :ref:`Annot` of a page (or ``None``)." msgstr "ページの最初の :ref:`Annot` を含みます（または ``None``）。" #: ../../page.rst:2262 4a694bc3ae1c4722b7ff991244d6257b msgid "Contains the first :ref:`Widget` of a page (or ``None``)." msgstr "ページの最初の :ref:`Widget` を含みます（または ``None``）。" #: ../../page.rst:2268 7d1c6125f8284e8c9f39a10aa30103aa msgid "The page number." msgstr "ページ番号。" #: ../../page.rst:2274 b2669057819b4d6e916eceb404f4d4a6 msgid "The owning document object." msgstr "所属するドキュメントオブジェクト。" #: ../../page.rst:2276 3c750c7bd6f64a0f942eb49c6ba43e3e msgid ":ref:`Document`" msgstr "" #: ../../page.rst:2281 80a0d7ab5d684176876073a103e2c4dd msgid "" "Contains the rectangle of the page. Same as result of " ":meth:`Page.bound()`." msgstr "ページの矩形を含みます。:meth:`Page.bound()` の結果と同じです。" #: ../../page.rst:2287 b211572eb97c4f9288b72564a3087914 msgid "The page's PDF :data:`xref`. Zero if not a PDF." msgstr "ページのPDF :data:`xref`。PDFでない場合はゼロです。" #: ../../page.rst:2296 330f7b7647944c63ac3bc3ca6bf3f7ac msgid "Description of *get_links()* Entries" msgstr "*get_links()* エントリの説明" #: ../../page.rst:2297 2648f2152b014814987e0dc0b7cfaa91 msgid "" "Each entry of the :meth:`Page.get_links` list is a dictionary with the " "following keys:" msgstr ":meth:`Page.get_links` リストの各エントリは、以下のキーを持つ辞書です：" #: ../../page.rst:2299 e5c4e6907f6748d9b291f48ef9be9969 msgid "" "*kind*: (required) an integer indicating the kind of link. This is one " "of *LINK_NONE*, *LINK_GOTO*, *LINK_GOTOR*, *LINK_LAUNCH*, or *LINK_URI*. " "For values and meaning of these names refer to :ref:`linkDest Kinds`." msgstr "" "*kind*：（必須）リンクの種類を示す整数。*LINK_NONE*、*LINK_GOTO*、*LINK_GOTOR*、*LINK_LAUNCH*、または" " *LINK_URI* のいずれかです。" #: ../../page.rst:2301 b82063bc31e64ff5910c18796372ade3 msgid "" "*from*: (required) a :ref:`Rect` describing the \"hot spot\" location on" " the page's visible representation (where the cursor changes to a hand " "image, usually)." msgstr "" "*from*：（必須）ページの可視な表現上の「ホットスポット」の場所を示す :ref:`Rect` " "（通常、カーソルが手のイメージに変わる場所です）。" #: ../../page.rst:2303 5bf55439f5024bf3b33ca376989d47ae msgid "" "*page*: a 0-based integer indicating the destination page. Required for " "*LINK_GOTO* and *LINK_GOTOR*, else ignored." msgstr "page：宛先ページを示す0ベースの整数。*LINK_GOTO*および *LINK_GOTOR* の場合に必要ですが、それ以外の場合は無視されます。" #: ../../page.rst:2305 65bd0136b92944d9a0a10ef2ee48ace2 msgid "" "*to*: either a *pymupdf.Point*, specifying the destination location on " "the provided page, default is *pymupdf.Point(0, 0)*, or a symbolic " "(indirect) name. If an indirect name is specified, *page = -1* is " "required and the name must be defined in the PDF in order for this to " "work. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored." msgstr "" "*to*：宛先ページ上の宛先場所を指定する *pymupdf.Point*、デフォルトは *pymupdf.Point(0, " "0)*、またはシンボリック（間接）名です。間接名が指定された場合、*page = -1* " "が必要で、名前はPDFで定義されている必要があります。*LINK_GOTO* および *LINK_GOTOR* " "の場合に必要ですが、それ以外の場合は無視されます。" #: ../../page.rst:2307 6868a28eed0f4944b3281fe9952cc61d msgid "" "*file*: a string specifying the destination file. Required for " "*LINK_GOTOR* and *LINK_LAUNCH*, else ignored." msgstr "file：宛先ファイルを指定する文字列。LINK_GOTORおよびLINK_LAUNCHの場合に必要ですが、それ以外の場合は無視されます。" #: ../../page.rst:2309 06a46ce37a71407f9de78e7a1c830883 msgid "" "*uri*: a string specifying the destination internet resource. Required " "for *LINK_URI*, else ignored. You should make sure to start this string " "with an unambiguous substring, that classifies the subtype of the URL, " "like `\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, " "`\"mailto:\"`, etc. Otherwise your browser will try to interpret the text" " and come to unwanted / unexpected conclusions about the intended URL " "type." msgstr "" "*uri*: LINK_URI用に指定された、インターネットリソースの宛先を示す文字列。*LINK_URI* " "の場合に必要で、それ以外の場合は無視されます。この文字列は、`\"http://\"`、`\"https://\"`、`\"file://\"`、`\"ftp://\"`、`\"mailto:\"`" " " "など、URLのサブタイプを識別する明確なサブストリングで始めるようにしてください。そうしないと、ブラウザがテキストを解釈し、意図しない/予期しない結論に達する可能性があります。" #: ../../page.rst:2311 d09b61a1ccd94c4782bb9e12c1371ed4 msgid "" ":data:`xref`: an integer specifying the PDF :data:`xref` of the link " "object. Do not change this entry in any way. Required for link deletion " "and update, otherwise ignored. For non-PDF documents, this entry contains" " *-1*. It is also *-1* for **all** entries in the *get_links()* list, if " "**any** of the links is not supported by MuPDF - see " ":ref:`notes_on_supporting_links`." msgstr "" ":data:`xref`: リンクオブジェクトのPDF :data:`xref` " "を指定する整数。このエントリを何らかの方法で変更しないでください。リンクの削除と更新に必要で、それ以外の場合は無視されます。非PDFドキュメントの場合、このエントリには" " *-1* が含まれます。また、MuPDFがサポートしていないリンクがある場合、*get_links()* " "リストのすべてのエントリに対しても-1になります。詳細については以下の注釈を参照してください。" #: ../../page.rst:2316 ca9d2e5b20dc4945ab5c36ba5fe32ee0 msgid "Notes on Supporting Links" msgstr "リンクのサポートに関する注記" #: ../../page.rst:2317 153628a3a4a646ffa511f00e6bf330e6 msgid "" "MuPDF's support for links has changed in **v1.10a**. These changes affect" " link types :data:`LINK_GOTO` and :data:`LINK_GOTOR`." msgstr "" "**v1.10a** 以降、MuPDFのリンクサポートが変更されました。これらの変更は :data:`LINK_GOTO` および " ":data:`LINK_GOTOR` というリンクタイプに影響を与えます。" #: ../../page.rst:2320 ac15e6ee350d44a8a44de4197833bb6f msgid "" "Reading (pertains to method *get_links()* and the *first_link* property " "chain)" msgstr "読み取り *get_links()* メソッドおよび*first_link* プロパティチェーンに関連）" #: ../../page.rst:2322 0d5ea7869b084e17a975066e947fd27c msgid "" "If MuPDF detects a link to another file, it will supply either a " "*LINK_GOTOR* or a *LINK_LAUNCH* link kind. In case of *LINK_GOTOR* " "destination details may either be given as page number (eventually " "including position information), or as an indirect destination." msgstr "" "MuPDFが別のファイルへのリンクを検出する場合、*LINK_GOTOR* または *LINK_LAUNCH* " "リンクの種類を提供します。*LINK_GOTOR* " "の場合、宛先の詳細はページ番号（位置情報を含むことがある）または間接的な宛先として指定できます。" #: ../../page.rst:2324 8460c5420845442387f0514e8c1cbf00 msgid "" "If an indirect destination is given, then this is indicated by *page = " "-1*, and *link.dest.dest* will contain this name. The dictionaries in the" " *get_links()* list will contain this information as the *to* value." msgstr "" "間接的な宛先が指定された場合、page = -1で示され、*link.dest.dest* にこの名前が含まれます。 *get_links()* " "リスト内の辞書には、この情報がto値として含まれます。" #: ../../page.rst:2326 8abfed4c51c3411799b1a19205d7ce7e msgid "" "**Internal links are always** of kind *LINK_GOTO*. If an internal link " "specifies an indirect destination, it **will always be resolved** and the" " resulting direct destination will be returned. Names are **never " "returned for internal links**, and undefined destinations will cause the " "link to be ignored." msgstr "内部リンクは常にLINK_GOTOの種類です。内部リンクが間接的な宛先を指定した場合、常に解決され、結果の直接的な宛先が返されます。内部リンクには名前は返されず、未定義の宛先はリンクが無視される原因になります。" #: ../../page.rst:2329 5b18953ee4ad4219b62275b81fbc5ddf msgid "Writing" msgstr "書き込み" #: ../../page.rst:2331 0de4046ec1434f2caf33d1d0f937dc46 msgid "" "PyMuPDF writes (updates, inserts) links by constructing and writing the " "appropriate PDF object **source**. This makes it possible to specify " "indirect destinations for *LINK_GOTOR* **and** *LINK_GOTO* link kinds " "(pre *PDF 1.2* file formats are **not supported**)." msgstr "" "PyMuPDFはリンクを構築して適切なPDFオブジェクト **ソース** を書き込むことにより、リンクを書き込み（更新、挿入）します。これにより、" " *LINK_GOTOR* および *LINK_GOTO* リンク種別に対して間接的な宛先を指定できます（**PDF 1.2** " "ファイル形式以前はサポートされていません）。" #: ../../page.rst:2333 44475c60d0bb4e1896c7d6d9f54c1bc4 msgid "" "If a *LINK_GOTO* indirect destination specifies an undefined name, this " "link can later on not be found / read again with MuPDF / PyMuPDF. Other " "readers however **will** detect it, but flag it as erroneous." msgstr "" "*LINK_GOTO* の間接的な宛先が未定義の名前を指定した場合、このリンクは後でMuPDF / " "PyMuPDFで再び見つけることはできません。ただし、他のリーダーはそれを検出し、エラーとしてフラグ付けます。" #: ../../page.rst:2335 e97441d500fd4cbca093072001464735 msgid "" "Indirect *LINK_GOTOR* destinations can in general of course not be " "checked for validity and are therefore **always accepted**." msgstr "一般的な注意: 間接的な *LINK_GOTOR* の宛先は一般的に有効性を確認できないため、常に受け入れられます。" #: ../../page.rst:2337 f91d81599f744ef191138bdba01275a1 msgid "" "**Example: How to insert a link pointing to another page in the same " "document**" msgstr "**例: 同じドキュメント内の別のページを指すリンクを挿入する方法**" #: ../../page.rst:2339 253b3fcbe5b34a058e8cce4baddbe409 msgid "" "Determine the rectangle on the current page, where the link should be " "placed. This may be the bbox of an image or some text." msgstr "リンクを配置する現在のページの矩形を決定します。これは画像または一部のテキストのbboxである場合があります。" #: ../../page.rst:2341 75763ee86eb04ffbbe5b886eebd09616 msgid "" "Determine the target page number (\"pno\", 0-based) and a :ref:`Point` on" " it, where the link should be directed to." msgstr "ターゲットページ番号（0から始まる）と、リンクを指定するためのそのページ上の :ref:`Point` を決定します。" #: ../../page.rst:2343 da45c4d7d2cf48049d7c7f88370a9dba msgid "" "Create a dictionary `d = {\"kind\": pymupdf.LINK_GOTO, \"page\": pno, " "\"from\": bbox, \"to\": point}`." msgstr "" "辞書 `d = {\"kind\": pymupdf.LINK_GOTO, \"page\": pno, \"from\": bbox, " "\"to\": point}` を作成します。" #: ../../page.rst:2345 60e5b2f417a74a0c97ba824efdaefd93 msgid "Execute `page.insert_link(d)`." msgstr "page.insert_link(d)を実行します。" #: ../../page.rst:2349 0b3e910653ec4d80abba445bbb13921a msgid "Homologous Methods of :ref:`Document` and :ref:`Page`" msgstr ":ref:`Document` と :ref:`Page` の同様のメソッドに関する説明です。" #: ../../page.rst:2350 26d9e6f47ecb405283f2b5a81a7906f3 msgid "" "This is an overview of homologous methods on the :ref:`Document` and on " "the :ref:`Page` level." msgstr "これは、:ref:`Document` と :ref:`Page` レベルでの同様のメソッドの概要です。" #: ../../page.rst:2353 30f1c80e96954d7a8d908b00de01d053 msgid "**Document Level**" msgstr "**Document Level（ドキュメントレベル）**" #: ../../page.rst:2353 d3484b7b4dab482587ce24b47380e9f6 msgid "**Page Level**" msgstr "**Page Level（ページレベル）**" #: ../../page.rst:2355 749f5d81a505410c95dfc298f9321878 msgid ":meth:`Document.get_page_fonts`" msgstr "" #: ../../page.rst:2356 41cb520def50422cada301e1c49c5f3d msgid ":meth:`Document.get_page_images`" msgstr "" #: ../../page.rst:2357 8a690ea87be148078b0576d999f057fb msgid ":meth:`Document.get_page_pixmap`" msgstr "" #: ../../page.rst:2358 984984f6cc6d4a9498c4a27025b79202 msgid ":meth:`Document.get_page_text`" msgstr "" #: ../../page.rst:2359 49d5563cc8e34fc490cedcd93dcf899f msgid ":meth:`Document.search_page_for`" msgstr "" #: ../../page.rst:2364 77c9d1d7bbef4177962336adc5064826 msgid "" "Most document methods (left column) exist for convenience reasons, and " "are just wrappers for: *Document[pno].*. So they **load and " "discard the page** on each execution." msgstr "" "多くのドキュメントメソッド（左側の列）は利便性のために存在し、*Document[pno].* " "のラッパーであるだけで、各実行でページを読み込んで破棄します。" #: ../../page.rst:2366 e0140280aedb4565a755312c2fe002cc #, fuzzy msgid "" "However, the first two methods work differently. They only need a page's " "object definition statement - the page itself will **not** be loaded. So " "e.g. :meth:`Page.get_fonts` is a wrapper the other way round and defined " "as follows: `page.get_fonts` == " "`page.parent.get_page_fonts(page.number)`." msgstr "" "ただし、最初の2つのメソッドは異なる方法で動作します。これらはページのオブジェクト定義ステートメントだけを必要とし、ページ自体は読み込まれません。例えば、:meth:`Page.get_fonts`" " は逆に定義され、次のようになります: *page.get_fonts == " "page.parent.get_page_fonts(page.number)*。" #: ../../page.rst:2369 3b3743f5a8784405b026dc4dccf459b4 msgid "" "When calling the :ref:`Document` equivalent methods then the page number " "is sent through as a parameter, e.g.:" msgstr "" #: ../../page.rst:2371 23d4fa19cff54bf3a4082b4375479d9c msgid "`Document.get_page_images(pno)` or `Document.get_page_text(pno)`" msgstr "" #: ../../page.rst:2375 7a08e4eae20c4587b61464662be5018f #, fuzzy msgid "" "The page number parameter, ``pno``, is a 0-based integer `-∞ < pno < " "page_count`." msgstr "ページ番号「pno」は0から始まる整数であり、`-∞ < pno < page_count` です。" #: ../../page.rst:2382 0e56aad36ef2434eaaa062ac4d6b1078 msgid "Tables and Related Classes" msgstr "" #: ../../page.rst:2384 630834d3fb7f49fabf1df19c954b5e8e msgid "" "The `TableFinder` class is returned by :meth:`Page.find_tables` and has " "related classes as follows:" msgstr "" #: ../../page.rst:2389 fefc2003da7640af95d0c8fe2fa4ae0b msgid "" "An object always returned by :meth:`Page.find_tables`. Attributes of " "interest:" msgstr "" #: ../../page.rst:2393 b1facb7319d64fe1814982a94e08e694 msgid "" "A list of :class:`Table` objects, each of which represents a table found " "on the page. An empty list if no tables are found." msgstr "" #: ../../page.rst:2397 d9c68273a7ed4f9389de63201f1329e4 msgid "A reference to the :ref:`Page` object." msgstr "" #: ../../page.rst:2399 ../../page.rst:2411 672ced5c87644dc2ab8425cfb3735842 #: a46083173b284a9a95fec38e2ff752ba msgid ":ref:`Page`" msgstr "" #: ../../page.rst:2404 09993a5d0359435c82005cbe7053461a msgid "An object representing a table found on the page." msgstr "" #: ../../page.rst:2409 334f29b68048440bb2c92ed1d075c7e4 msgid "A back-reference to the owning page." msgstr "" #: ../../page.rst:2415 fa2948c2cbd84d36bc110ba375ce9dcf msgid "An array of `Rect` objects for each cell in the table." msgstr "" #: ../../page.rst:2417 ../../page.rst:2454 ../../page.rst:2461 #: ../../page.rst:2498 ../../page.rst:2504 0b50c46907a6406dbbfcc4a9d7d842c0 #: 1f804a3ec218447b9ebe0a4eb0662c6c 6ab7e6b040ab43b3a52010e0236f593d #: 89f000de4e84477dac230df671fd8a17 ff379839dfcf4dc09a1fc2dd862b6e83 msgid "list" msgstr "" #: ../../page.rst:2422 fff4c850223145f2b09c22904bdecb3d msgid "A `TableHeader` object." msgstr "" #: ../../page.rst:2424 16480aa7bae54a44b65eb4a3ad51ca39 msgid "`TableHeader`" msgstr "" #: ../../page.rst:2429 cb817f7210a04ab19d07808de14accbe #, fuzzy msgid "The bounding box of all cells of the table header." msgstr "**bbox:** ヘッダーのバウンディングボックス。" #: ../../page.rst:2438 e42d4b4d7ae94e84bbba1635affb7264 msgid "Number of rows in the table." msgstr "" #: ../../page.rst:2445 dab42295898940e289ac06b2d6448eb3 msgid "Number of columns in the table." msgstr "" #: ../../page.rst:2452 c32a46770fa84ab8a8442c7324cca9b8 msgid "An array of `TableRow` objects for each row in the table." msgstr "" #: ../../page.rst:2459 5e94d9003fcf4a0c9bc37419ed453180 msgid "Extracts table cell text data into a list." msgstr "" #: ../../page.rst:2465 4f9105edf01140a8bcac5f19a880eabb msgid "Extracts table data into Markdown text format." msgstr "" #: ../../page.rst:2468 3fa618e2424d4b4fb55e83275cc442b9 msgid "If ``True`` then markdown syntax is removed from cell content." msgstr "" #: ../../page.rst:2469 888238e384834e50bf7109918e9694c5 msgid "" "If ``True`` then cell content `None` is replaced by the values above " "(columns) or left (rows) in an effort to approximate row and columns " "spans." msgstr "" #: ../../page.rst:2472 a454ab9fb7dc493797f334048225e316 #, fuzzy msgid "string" msgstr "書き込み" #: ../../page.rst:2477 0c321bd8063c4c9f83179c7cc7985e85 msgid "" "Return a `pandas DataFrame `_ " "`DataFrame `_ " "version of the table." msgstr "" #: ../../page.rst:2479 596d18b7bb884f478f918f7acedadd09 msgid "pandas DataFrame" msgstr "" #: ../../page.rst:2486 127cceead5c244e8a61282d74b663861 msgid "Dedicated class for table headers." msgstr "" #: ../../page.rst:2490 a954a6b14acd4faf9c8748ad7f616d9c msgid "" "The bounding box of the union of cells belonging to the table header, " "given as a tuple (x0, y0, x1, y1). This rectangle contains all table " "header cells." msgstr "" #: ../../page.rst:2496 18255190a91e49549ec8607494bcfad6 msgid "A list of tuples for each bbox of a column header." msgstr "" #: ../../page.rst:2502 bbadce9734a54ebf8f060fda7b75f154 msgid "A list of strings with column header text." msgstr "" #: ../../page.rst:2508 d0766391701c4fbcbfc1afe7ab941644 msgid "A boolean indicating whether the header is outside the table cells." msgstr "" #: ../../page.rst:2510 bf9a41b295214c1d8a33fbf5ff2d0674 #, fuzzy msgid "`bool`" msgstr "太字" #: ../../page.rst:2515 7e240363ad36487abb9c0b9048455344 msgid "Dedicated class for table rows." msgstr "" #: ../../page.rst:2522 f121b788e07f4404822f89f64a76f622 msgid "Footnotes" msgstr "脚注" #: ../../page.rst:2523 a6e7a54deb36449583b6c8f5faa956b1 msgid "" "If your existing code already uses the installed base name as a font " "reference (as it was supported by PyMuPDF versions earlier than 1.14), " "this will continue to work." msgstr "既存のコードがフォントの参照としてインストール済みのベース名を使用している場合（これはPyMuPDFバージョン1.14以前でサポートされていました）、これは引き続き機能します。" #: ../../page.rst:2525 041b50e8dc5a4737947d980e5bcdfadc msgid "" "Not all PDF reader software (including internet browsers and office " "software) display all of these fonts. And if they do, the difference " "between the **serifed** and the **non-serifed** version may hardly be " "noticeable. But serifed and non-serifed versions lead to different " "installed base fonts, thus providing an option to be displayable with " "your specific PDF viewer." msgstr "PDFリーダーソフトウェア（インターネットブラウザやオフィスソフトウェアを含む）がすべてのこれらのフォントを表示するわけではありません。そして、表示されても、セリフ付きとセリフなしバージョンの違いはほとんど気付かれないかもしれません。ただし、セリフ付きとセリフなしバージョンは異なるインストール済みベースのフォントにリードするため、特定のPDFビューアで表示可能なオプションが提供されます。" #: ../../page.rst:2527 d0a153a29bcf4cc7bbc8a126f31438ec msgid "" "Not all PDF readers display these fonts at all. Some others do, but use a" " wrong character spacing, etc." msgstr "すべてのPDFリーダーがこれらのフォントを表示するわけではありません。一部の他のソフトウェアは表示するかもしれませんが、文字間隔が間違っているなどの問題が発生する場合があります。" #: ../../page.rst:2529 4c36bdbe56f14fbd93778c7b846894f0 msgid "" "You are generally free to choose any of the :ref:`mupdficons` you " "consider adequate." msgstr "適切と思われるMuPDFの注釈アイコンのいずれを選択することは自由です。" #: ../../page.rst:2531 f0955458c88b48f0bc91091ffac7934c msgid "" "The previous algorithm caused images to be **shrunk** to this " "intersection. Now the image can be anywhere on :attr:`Page.mediabox`, " "potentially being invisible or only partially visible if the cropbox " "(representing the visible page part) is smaller." msgstr "" "以前のアルゴリズムでは、画像がこの交差点に縮小されることがありました。今では画像は　:attr:`Page.mediabox` " "のどこにでも配置でき、cropbox（表示ページ部分を表す）が小さい場合、画像は見えないか部分的にしか見えない可能性があります。" #: ../../page.rst:2533 ee4935ee06214192915f0a7d40c3c57d msgid "" "If you need to also see annotations or fields in the target page, you can" " convert the source PDF using :meth:`Document.bake`. The underlying MuPDF" " function of that method will convert these objects to normal page " "content. Then use :meth:`Page.show_pdf_page` with the converted PDF page." msgstr "" "ターゲットページで注釈やフィールドも表示する必要がある場合、ソースPDFを別のPDFに変換して :meth:`Document.bake` " "を使用してみることができます。そのメソッドの基本となるMuPDFの機能は、これらのオブジェクトを通常のページコンテンツに変換します。その後、変換されたPDFページを使用して" "　:meth:`Page.show_pdf_page` を使用します。" #: ../../page.rst:2535 e97c4c82263941379759ee87f2b26a7d msgid "" "In PDF, an area enclosed by some lines or curves can have a property " "called \"orientation\". This is significant for switching on or off the " "fill color of that area when there exist multiple area overlaps - see " "discussion in method :meth:`Shape.finish` using the \"non-zero winding " "number\" rule. While orientation of curves, quads, triangles and other " "shapes enclosed by lines always was detectable, this has been impossible " "for \"re\" (rectangle) items in the past. Adding the orientation " "parameter now delivers the missing information." msgstr "" "PDFにおいて、いくつかの線や曲線で囲まれた領域は、「方向性（orientation）」と呼ばれるプロパティを持つことがあります。これは、複数の領域が重なる場合にその領域の塗りつぶし色をオンまたはオフに切り替える際に重要です。この方向性は「非ゼロの巡回数" "（non-zero winding number）ルール」を使用した :meth:`Shape.finish` " "メソッドの議論で詳しく説明されています。曲線、四角形、三角形などの線で囲まれた形状の方向性は常に検出可能でしたが、これまでは「re」（長方形）アイテムに対しては不可能でした。orientationパラメータを追加することで、この不足していた情報を提供できるようになりました。" #: ../../page.rst:2537 8612026f5b474906aa96aa5c9f0fe43a msgid "" "Hyphenation detection simply means that if the last character of a line " "is \"-\", it will be assumed to be a continuation character. That " "character will not be found by text searching with its default flag " "setting. Please take note, that a MuPDF *line* may not always be what you" " expect: words separated by overly large gaps (e.g. caused by text " "justification) may constitute separate MuPDF lines. If then any of these " "words ends with a hyphen, it will only be found by text searching if " "hyphenation is switched off." msgstr "" "ハイフネーション検出とは、行の最後の文字が「-」である場合、それが連続文字であると仮定することを意味します。この文字は、デフォルトのフラグ設定を使用してテキスト検索されないでしょう。MuPDFの行が常に期待どおりであるわけではないことに注意してください：文字の間隔が非常に大きい（テキストの正当化によって引き起こされる場合など）、単語が別々のMuPDFの" "　*line* " "を構成する可能性があります。その後、これらの単語のいずれかがハイフンで終わる場合、ハイフネーションがオフになっていない限り、テキスト検索でのみ見つかるでしょう。" #: ../../page.rst:2539 f928aef1dad441f1a458d6f312a66855 msgid "" "Objects inside the source page, like images, text or drawings, are never " "aware of whether their owning page now is under OC control inside the " "target PDF. If source page objects are OC-controlled in the source PDF, " "then this will not be retained on the target: they will become " "unconditionally visible." msgstr "ソースページ内のオブジェクト、例えば画像、テキスト、または図面などは、所有ページがターゲットPDF内でOC（オプションコンテンツ）制御下にあるかどうかを認識することは決してありません。ソースページのオブジェクトがソースPDF内でOCに制御されている場合、これはターゲットに保持されないため、それらは無条件に表示されます。" #: ../../page.rst:2541 fe1cfbaa56a3485cb70119f33c3e64d5 msgid "" "This value is always 96, the default of the PDF interpreter. It **does " "not reflect** the resolution of the image itself. If you need the image's" " resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` " "attributes of the :ref:`Pixmap` created from the image binary." msgstr "" #: ../../footer.rst:46 ada5e78849734f1196f922af9c2cb075 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "image in memory (all formats supported" #~ " by MuPDF -- see :ref:`ImageFiles`). " #~ "Changed in v1.14.13: *io.BytesIO* is now" #~ " also supported." #~ msgstr "" #~ msgid "Changed in v1.14.13: *io.BytesIO* is now also supported." #~ msgstr "v1.14.13で変更：*io.BytesIO* もサポートされるようになりました。" #~ msgid "" #~ "*(new in version v1.18.1)* image in " #~ "memory -- to be used as image " #~ "mask (alpha values) for the base " #~ "image. When specified, the base image" #~ " must be provided as a filename " #~ "or a stream -- and must not " #~ "be an image that already has a " #~ "mask." #~ msgstr "" #~ "*(v1.18.1で新機能)* " #~ "ベース画像の画像マスク（アルファ値）として使用するためのメモリ内の画像。指定する場合、ベース画像はファイル名またはストリームとして提供され、すでにマスクを持っている画像ではない必要があります。" #~ msgid "" #~ "*(New in v1.18.13)* the :data:`xref` of" #~ " an image already present in the " #~ "PDF. If given, parameters `filename`, " #~ "`pixmap`, `stream`, `alpha` and `mask` " #~ "are ignored. The page will simply " #~ "receive a reference to the existing " #~ "image." #~ msgstr "" #~ "(v1.18.13で新機能)* " #~ "PDFに既に存在する画像のxref。指定された場合、`filename`、`pixmap`、`stream`、`alpha`、および " #~ "`mask` のパラメータは無視されます。ページは単に既存の画像への参照を受け取ります。" #~ msgid "" #~ "*(new in v1.18.3)* (:data:`xref`) make " #~ "image visibility dependent on this " #~ ":data:`OCG` or :data:`OCMD`. Ignored after " #~ "the first of multiple insertions. The" #~ " property is stored with the " #~ "generated PDF image object and therefore" #~ " controls the image's visibility throughout" #~ " the PDF." #~ msgstr "" #~ "(v1.18.3で新機能)*（:data:`xref`）画像の表示をこの :data:`OCG`または " #~ ":data:`OCMD` " #~ "に依存させます。複数の挿入の最初の後は無視されます。このプロパティは生成されたPDF画像オブジェクトに保存されるため、PDF全体で画像の表示を制御します。" #~ msgid "*(new in version v1.14.11)* maintain the aspect ratio of the image." #~ msgstr "(v1.14.11で新機能)* 画像のアスペクト比を保持します。" #~ msgid "For a description of *overlay* see :ref:`CommonParms`." #~ msgstr "*overlay* の説明については :ref:`CommonParms` を参照してください。" #~ msgid "*Changed in v1.18.13:* Return xref of stored image." #~ msgstr "*v1.18.13で変更：* 格納された画像のxrefを返します。" #~ msgid "" #~ "the font name. Default is \"Helv\". " #~ "Accepted alternatives are \"Cour\", \"TiRo\"," #~ " \"ZaDb\" and \"Symb\". The name may" #~ " be abbreviated to the first two " #~ "characters, like \"Co\" for \"Cour\". " #~ "Lower case is also accepted. *(Changed" #~ " in v1.16.0)* Bold or italic variants" #~ " of the fonts are **no longer " #~ "accepted**. A user-contributed script " #~ "provides a circumvention for this " #~ "restriction -- see section *Using " #~ "Buttons and JavaScript* in chapter " #~ ":ref:`FAQ`. *(New in v1.17.0)* The " #~ "actual font to use is now " #~ "determined on a by-character level, " #~ "and all required fonts (or sub-" #~ "fonts) are automatically included. Therefore," #~ " you should rarely ever need to " #~ "care about this parameter and let " #~ "it default (except you insist on a" #~ " serifed font for your non-CJK " #~ "text parts)." #~ msgstr "" #~ "フォント名。デフォルトは「Helv」です。受け入れられる代替案は「Cour」、「TiRo」、「ZaDb」、「Symb」です。名前は、最初の2文字まで省略することができます。「Co」のように、小文字も受け入れられます。*（v1.16.0で変更）*" #~ " " #~ "フォントの太字または斜体のバリアントはもはや受け入れられません。この制限を回避するユーザー投稿のスクリプトが提供されており、:ref:`FAQ`" #~ " " #~ "の章で「ボタンとJavaScriptの使用」を参照してください。（v1.17.0で新規追加）使用する実際のフォントは、文字ごとに決定され、必要なすべてのフォント（またはサブフォント）が自動的に含まれます。したがって、このパラメータについて心配する必要はほとんどありません。デフォルトにしておくべきです（CJK以外のテキスト部分にセリフフォントを希望する場合を除く）。" #~ msgid "*(new in v1.16.0)* the text color. Default is black." #~ msgstr "*（v1.16.0で新規追加）* テキストの色。デフォルトは黒です。" #~ msgid "*(new in v1.16.0)* the fill color. Default is white." #~ msgstr "*（v1.16.0で新規追加）* 塗りつぶしの色。デフォルトは白です。" #~ msgid "" #~ "*(new in v1.17.0)* text alignment, one" #~ " of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " #~ "TEXT_ALIGN_RIGHT - justify is **not " #~ "supported**." #~ msgstr "" #~ "*（v1.17.0で新規追加）* " #~ "テキストの配置、TEXT_ALIGN_LEFT、TEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHTのいずれか。ジャスティファイは" #~ " **サポートされていません**。" #~ msgid "" #~ "the data to be stored (actual file" #~ " content, any data, etc.). Changed " #~ "in v1.14.13 *io.BytesIO* is now also " #~ "supported." #~ msgstr "" #~ msgid "" #~ "*(New in v1.16.12)* the font to " #~ "use when *text* is given, otherwise " #~ "ignored. The same rules apply as " #~ "for :meth:`Page.insert_textbox` -- which is" #~ " the method :meth:`Page.apply_redactions` " #~ "internally invokes. The replacement text " #~ "will be **vertically centered**, if this" #~ " is one of the CJK or " #~ ":ref:`Base-14-Fonts`. .. note:: * For " #~ "an **existing** font of the page, " #~ "use its reference name as *fontname* " #~ "(this is *item[4]* of its entry in" #~ " :meth:`Page.get_fonts`). * For a **new," #~ " non-builtin** font, proceed as " #~ "follows:: page.insert_text(point, # " #~ "anywhere, but outside all redaction " #~ "rectangles \"something\", # some " #~ "non-empty string fontname=\"newname\", " #~ "# new, unused reference name " #~ "fontfile=\"...\", # desired font file" #~ " render_mode=3, # makes the text" #~ " invisible ) page.add_redact_annot(..., " #~ "fontname=\"newname\")" #~ msgstr "" #~ msgid "" #~ "*(New in v1.16.12)* the :data:`fontsize` " #~ "to use for the replacing text. If" #~ " the text is too large to fit," #~ " several insertion attempts will be " #~ "made, gradually reducing the :data:`fontsize`" #~ " to no less than 4. If then " #~ "the text will still not fit, no" #~ " text insertion will take place at" #~ " all." #~ msgstr "" #~ "*(新機能 v1.16.12)* 置換テキストに使用する :data:`fontsize` " #~ "です。テキストが収まりきらない場合、:data:`fontsize` " #~ "を徐々に4未満にならないまで縮小し、テキストがまだ収まらない場合はテキストの挿入は行われません。" #~ msgid "" #~ "*(New in v1.16.12)* the horizontal " #~ "alignment for the replacing text. See" #~ " :meth:`insert_textbox` for available values. " #~ "The vertical alignment is (approximately) " #~ "centered if a PDF built-in font" #~ " is used (CJK or :ref:`Base-14-Fonts`)." #~ msgstr "" #~ "*(新機能 v1.16.12)* 置換テキストの水平方向の配置を指定します。使用可能な値については " #~ ":meth:`insert_textbox` を参照してください。PDF組み込みフォント（CJKまたは " #~ ":ref:`Base-14-Fonts`）が使用されている場合、垂直方向の配置は（おおよそ）中央になります。" #~ msgid "" #~ "*(New in v1.16.12)* the fill color " #~ "of the rectangle **after applying** the" #~ " redaction. The default is *white =" #~ " (1, 1, 1)*, which is also " #~ "taken if ``None`` is specified. " #~ "*(Changed in v1.16.13)* To suppress a" #~ " fill color altogether, specify ``False``." #~ " In this cases the rectangle remains" #~ " transparent." #~ msgstr "" #~ "*(新機能 v1.16.12)* レッドアクションを **適用した後** " #~ "の矩形の塗りつぶし色です。デフォルトは *white = (1, 1, 1)*" #~ " で、``None`` が指定された場合もこれが適用されます。 *(新機能 v1.16.13)*" #~ " 塗りつぶし色を抑制するには、``False`` を指定します。この場合、矩形は透明のままです。" #~ msgid "" #~ "the created annotation. *(Changed in " #~ "v1.17.2)* Its standard appearance looks " #~ "like a red rectangle (no fill " #~ "color), optionally showing two diagonal " #~ "lines. Colors, line width, dashing, " #~ "opacity and blend mode can now be" #~ " set and applied via :meth:`Annot.update`" #~ " like with other annotations." #~ msgstr "" #~ "作成されたアノテーション。 *(新機能 v1.17.2)* " #~ "その標準の外観は赤い矩形（塗りつぶし色なし）のようです。オプションで2つの対角線を表示できます。色、線の幅、破線、不透明度、ブレンドモードは、他の注釈と同様に" #~ " :meth:`Annot.update` を介して設定および適用できます。" #~ msgid "" #~ "Find tables on the page and return" #~ " an object with related information. " #~ "Typically, only very few of the " #~ "many arguments ever need to be " #~ "specified -- they mainly are tools " #~ "to react to corner case situations." #~ msgstr "ページ上のテーブルを検出し、関連情報を持つオブジェクトを返します。通常、指定する必要がある引数は非常に少数であり、主に特殊な状況に対応するためのツールです。" #~ msgid "" #~ "request a search algorithm. The " #~ "\"lines\" default looks for vector " #~ "drawings. If \"text\" is specified, text" #~ " positions are used to generate " #~ "\"virtual\" row boundaries. The \"text\" " #~ "choices are recommended when dealing " #~ "with pages without any vector graphics" #~ " -- like when this is an OCRed" #~ " page." #~ msgstr "検索アルゴリズムを指定します。デフォルトでは「lines」はベクトル描画を探します。指定された場合、「text」ではテキストの位置を使用して「仮想」行境界を生成します。「text」の選択肢は、ベクトルグラフィックが含まれていないページと取り扱う場合に推奨されます。" #~ msgid "" #~ "The remaining parameters are limits for" #~ " merging different objects. For instance:" #~ " Two horizontal lines with the same" #~ " x-coordinates and a vertical distance " #~ "less than 3 will be merged " #~ "(\"snapped\") to one line." #~ msgstr "残りのパラメーターは、異なるオブジェクトを統合するための制限です。例えば、x座標が同じで垂直距離が3未満の2つの水平線は1つの線に「スナップ」されます。" #~ msgid "" #~ "a `TableFinder` object that has the " #~ "following significant attributes: * " #~ "**cells:** a list of **all bboxes** " #~ "on the page, that have been " #~ "identified as table cells (across all" #~ " tables). Each cell is a tuple " #~ "`(x0, y0, x1, y1)` of coordinates " #~ "or `None`. * **tables:** a list of" #~ " `Table` objects. This is `[]` if " #~ "the page has no tables. Please " #~ "note that while single tables can " #~ "be found as items of this list," #~ " the `TableFinder` object itself is " #~ "also a sequence of it tables. This" #~ " means that if `tabs` is a " #~ "`TableFinder` object, then table number " #~ "\"n\" is delivered by `tabs.tables[n]` " #~ "as well as by the shorter " #~ "`tabs[n]`. * The `Table` object has" #~ " the following attributes: * **bbox:**" #~ " the bounding box of the table " #~ "as a tuple `(x0, y0, x1, y1)`." #~ " * **cells:** bounding boxes of " #~ "the table's cells (list of tuples). " #~ "A cell may also be `None`. *" #~ " **extract():** this method returns the " #~ "text content of each table cell as" #~ " a list of list of strings. " #~ "* **to_pandas():** this method returns " #~ "the table as a `pandas " #~ "`_ `DataFrame " #~ "`_. *" #~ " **header:** a `TableHeader` object " #~ "containing header information of the " #~ "table. * **col_count:** an integer " #~ "containing the number of table columns." #~ " * **row_count:** an integer containing" #~ " the number of table rows. * " #~ "**rows:** a list of `TableRow` objects" #~ " containing two attributes: *bbox* is " #~ "the boundary box of the row, and" #~ " *cells* is a list of table " #~ "cells contained in this row. * " #~ "The `TableHeader` object has the " #~ "following attributes: * **bbox:** the " #~ "bounding box of the header. * " #~ "**cells:** a list of bounding boxes " #~ "containing the name of the respective" #~ " column. * **names:** a list of" #~ " strings containing the text of each" #~ " of the cell bboxes. They represent" #~ " the column names -- which can " #~ "be used when exporting the table " #~ "to pandas DataFrames or CSV, etc. " #~ "* **external:** a bool indicating " #~ "whether the header bbox is outside " #~ "the table body (`True`) or not. " #~ "Table headers are never identified by" #~ " the `TableFinder` logic. Therefore, if " #~ "*external* is true, then the header " #~ "cells are not part of any cell " #~ "identified by `TableFinder`. If `external " #~ "== False`, then the first table " #~ "row is the header. Please have a" #~ " look at these `Jupyter notebooks " #~ "`_, which cover standard " #~ "situations like multiple tables on one" #~ " page or joining table fragments " #~ "across multiple pages." #~ msgstr "" #~ msgid "" #~ "*(Changed in v1.18.0)* The overlapping " #~ "parts of **images** will be blanked-" #~ "out for default option " #~ "`PDF_REDACT_IMAGE_PIXELS`. Option 0 does not" #~ " touch any images and 1 will " #~ "remove any image with an overlap. " #~ "Please be aware that there is a" #~ " bug for option *PDF_REDACT_IMAGE_PIXELS =" #~ " 2*: transparent images will be " #~ "incorrectly handled!" #~ msgstr "" #~ "*（v1.18.0で変更）* デフォルトオプション `PDF_REDACT_IMAGE_PIXELS` " #~ "の場合、**画像** " #~ "の重なる部分はブランクにされます。オプション0は画像には影響せず、オプション1は重なる画像を完全に削除します。ただし、オプション " #~ "*PDF_REDACT_IMAGE_PIXELS = 2* " #~ "にはバグがあることに注意してください：透明な画像が誤って処理されます！" #~ msgid "" #~ "Automatic line breaks are inserted at" #~ " word boundaries. The \"soft hyphen\" " #~ "character `\"­\"` can be used to" #~ " cause hyphenation and thus also " #~ "cause line breaks. **Forced** line " #~ "breaks however are only achievable via" #~ " the HTML tag `
` - `\"\\\\n\"`" #~ " is ignored and will be treated " #~ "like a space." #~ msgstr "" #~ msgid "" #~ "The text may include arbitrary languages" #~ " -- **including right-to-left** " #~ "languages." #~ msgstr "" #~ msgid "**either** be just informed (and accept a no-op)," #~ msgstr "" #~ msgid "" #~ "**or** (`scale=True` - the default) " #~ "scale down the content until it " #~ "fits." #~ msgstr "" #~ msgid "" #~ "the text to be written. Can " #~ "contain plain text and HTML tags " #~ "with styling instructions. Alternatively, a" #~ " :ref:`Story` object may be specified " #~ "(in which case the internal Story " #~ "generation step will be omitted). A " #~ "Story must have been generated with " #~ "all required styling and Archive " #~ "information." #~ msgstr "" #~ msgid "" #~ "optional string containing additional CSS " #~ "instructions. Ignored if `text` is a " #~ "Story." #~ msgstr "" #~ msgid "" #~ "if necessary scale down the content " #~ "until it fits in the target " #~ "rectangle. This sets the down scaling" #~ " limit. Default is 0, no limit. " #~ "A value of 1 means no down-" #~ "scaling. A value of e.g. 0.2 means" #~ " maximum down-scaling by 80%." #~ msgstr "" #~ msgid "" #~ "an Archive object that points to " #~ "locations where to find images or " #~ "non-standard fonts. If `text` refers " #~ "to images, this parameter is always " #~ "required. Ignored if `text` is a " #~ "Story." #~ msgstr "" #~ msgid "" #~ "A string indicating the requested " #~ "format, one of the above. A " #~ "mixture of upper and lower case is" #~ " supported. Changed in v1.16.3 Values " #~ "\"words\" and \"blocks\" are now also" #~ " accepted." #~ msgstr "" #~ msgid "" #~ "*(new in v1.16.2)* indicator bits to " #~ "control whether to include images or " #~ "how text should be handled with " #~ "respect to white spaces and " #~ ":data:`ligatures`. See :ref:`TextPreserve` for " #~ "available indicators and " #~ ":ref:`text_extraction_flags` for default settings." #~ msgstr "" #~ "*(v1.16.2で新たに追加)* 画像を含めるか、テキストを空白文字と :data:`ligatures` " #~ "にどのように処理するかを制御するための指示ビット。使用可能な指示子については:ref:`TextPreserve` " #~ "を、デフォルト設定についてはText :ref:`text_extraction_flags` を参照してください。" #~ msgid "" #~ "(new in v1.19.1) sort the output " #~ "by vertical, then horizontal coordinates. " #~ "In many cases, this should suffice " #~ "to generate a \"natural\" reading order." #~ " Has no effect on (X)HTML and " #~ "XML. Output option **\"words\"** sorts " #~ "by `(y1, x0)` of the words' " #~ "bboxes. Similar is true for \"blocks\"," #~ " \"dict\", \"json\", \"rawdict\", \"rawjson\":" #~ " they all are sorted by `(y1, " #~ "x0)` of the resp. block bbox. If" #~ " specified for \"text\", then internally" #~ " \"blocks\" is used." #~ msgstr "" #~ "(v1.19.1で新たに追加) " #~ "出力を垂直方向、水平方向の座標で並べ替えます。多くの場合、これで「自然な」読み取り順序を生成できるはずです。これは(X)HTMLおよびXMLには影響しません。出力オプション" #~ " “words” は単語のbboxの `(y1, x0)` " #~ "で並べ替えます。同様のことは “blocks”、 “dict”、 “json”、 " #~ "“rawdict”、 “rawjson”にも当てはまります。それらはすべて、respです。ブロックbboxの " #~ "`(y1, x0)` でソートされます。 “text” に対して指定された場合、内部的には" #~ " “blocks” が使用されます。" #~ msgid "" #~ "(new in v1.23.5) use these characters" #~ " as *additional* word separators with " #~ "the \"words\" output option (ignored " #~ "otherwise). By default, all white spaces" #~ " (including non-breaking space `0xA0`) " #~ "indicate start and end of a word." #~ " Now you can specify more characters" #~ " causing this. For instance, the " #~ "default will return `\"john.doe@outlook.com\"` " #~ "as **one** word. If you specify " #~ "`delimiters=\"@.\"` then the **four** words" #~ " `\"john\"`, `\"doe\"`, `\"outlook\"`, `\"com\"`" #~ " will be returned. Other possible " #~ "uses include ignoring punctuation characters" #~ " `delimiters=string.punctuation`. The \"word\" " #~ "strings will not contain any delimiting" #~ " character." #~ msgstr "" #~ msgid "" #~ "The inclusion of text via the " #~ "*clip* parameter is decided on a " #~ "by-character level: **(changed in " #~ "v1.18.2)** a character becomes part of" #~ " the output, if its bbox is " #~ "contained in *clip*. This **deviates** " #~ "from the algorithm used in redaction " #~ "annotations: a character will be " #~ "**removed if its bbox intersects** any" #~ " redaction annotation." #~ msgstr "" #~ "clipパラメータを使用してテキストを含めるかどうかは、文字単位で決定されます **(v1.18.2で変更)** " #~ "。キャラクタのbboxが *clip* " #~ "に含まれている場合、そのキャラクタは出力の一部となります。これは、赤塗りのアノテーションで使用されるアルゴリズムとは " #~ "**異なります** ：" #~ msgid "" #~ "a string with interspersed linebreaks " #~ "where necessary. Changed in v1.19.0: It" #~ " is based on dedicated code. A " #~ "tyical use is checking the result " #~ "of :meth:`Page.search_for`: >>> rl = " #~ "page.search_for(\"currency:\") >>> page.get_textbox(rl[0])" #~ " 'Currency:' >>>" #~ msgstr "" #~ msgid "(new in v1.18.17) type of this path." #~ msgstr "v1.18.17で新しく追加されたパスのタイプ。" #~ msgid "" #~ "`(\"re\", rect, orientation)` - a " #~ ":ref:`Rect`. *Changed in v1.18.17:* Multiple" #~ " rectangles within the same path are" #~ " now detected. *Changed in v1.19.2:* " #~ "added integer `orientation` which is 1" #~ " resp. -1 indicating whether the " #~ "enclosed area is rotated left (1 =" #~ " anti-clockwise), or resp. right " #~ "[#f7]_." #~ msgstr "" #~ "`(\"re\", rect, orientation)` - " #~ ":ref:`Rect`。*バージョン1.18.17で変更:* " #~ "同じパス内の複数の矩形が検出されるようになりました。*バージョン1.19.2で変更:* 整数の " #~ "orientation が追加され、内包された領域が左に回転（1 = " #~ "反時計回り）するか、右に回転するかを示します [#f7]_。" #~ msgid "" #~ "Starting with v1.19.2, quads and " #~ "rectangles are more reliably recognized " #~ "as such." #~ msgstr "バージョン1.19.2から、四角形と四角形は、より信頼性のある方法で認識されるようになりました。" #~ msgid "" #~ "**New in v1.22.0:** Specifying `extended=True`" #~ " significantly alters the output. Most " #~ "importantly, new dictionary types are " #~ "present: \"clip\" and \"group\". All " #~ "paths will now be organized in a" #~ " hierarchic structure which is encoded " #~ "by the new integer key \"level\", " #~ "the hierarchy level. Each group or " #~ "clip establishes a new hierarchy, which" #~ " applies to all subsequent paths " #~ "having a *larger* level value." #~ msgstr "" #~ "**新機能 v1.22.0:** `extended=True` " #~ "を指定すると、出力が大幅に変更されます。最も重要な変更点は、新しい辞書タイプ「clip」および「group」が存在することです。すべてのパスは、新しい整数キー「level」でエンコードされる階層構造に整理されます。各グループまたはクリップは、その後に大きなレベル値を持つすべての後続のパスに適用される新しい階層を確立します。" #~ msgid "Key `\"type\"` takes one of the following values:" #~ msgstr "`\"type\"` キーは、以下のいずれかの値を取ります：" #~ msgid "" #~ "**\"f\"** -- this is a *fill-only*" #~ " path. Only key-values relevant for" #~ " this operation have a meaning, " #~ "irrelevant ones have been added with " #~ "default values for backward compatibility: " #~ "`\"color\"`, `\"lineCap\"`, `\"lineJoin\"`, " #~ "`\"width\"`, `\"closePath\"`, `\"dashes\"` and " #~ "should be ignored." #~ msgstr "" #~ "**\"f\"**– これは *fill-only* " #~ "のパスです。この操作に関連するキーと値だけが意味を持ち、無関係なものは後方互換性を保つためにデフォルトの値が追加されています。したがって、`\"color\"`、`\"lineCap\"`、`\"lineJoin\"`、`\"width\"`、`\"closePath\"`、`\"dashes\"`" #~ " などは無視されるべきです。" #~ msgid "" #~ "**\"s\"** -- this is a *stroke-" #~ "only* path. Similar to previous, key " #~ "`\"fill\"` is present with value `None`." #~ msgstr "" #~ "**\"s\"** – これは *stroke-only* " #~ "のパスです。前述のように、キー \"fill\" が値 `None` で存在します。" #~ msgid "" #~ "Using class :ref:`Shape`, you should be" #~ " able to recreate the original " #~ "drawings on a separate (PDF) page " #~ "with high fidelity under normal, not " #~ "too sophisticated circumstances. Please see" #~ " the following comments on restrictions." #~ " A coding draft can be found in" #~ " section \"How to Extract Drawings\" " #~ "of chapter :ref:`FAQ`." #~ msgstr "" #~ ":ref:`Shape` " #~ "クラスを使用すると、通常の、あまり複雑でない状況で、元の図面を高い忠実度で別の（PDF）ページに再作成できるはずです。制約事項に関する以下のコメントを参照してください。コーディングの草案は、FAQの「図面の抽出方法」セクションにあります。" #~ msgid "" #~ "*New in v1.18.13:* **PDF only.** Try " #~ "to find the :data:`xref` for each " #~ "image. Implies `hashes=True`. Adds the " #~ "`\"xref\"` key to the dictionary. If " #~ "not found, the value is 0, which" #~ " means, the image is either " #~ "\"inline\" or otherwise undetectable. Please" #~ " note that this option has an " #~ "extended response time, because the MD5" #~ " hashcode will be computed at least" #~ " two times for each image with " #~ "an xref." #~ msgstr "" #~ "*新機能（v1.18.13)*：**PDFのみ。** b各イメージの :data:`xref` " #~ "を見つけようとします。`hashes=True` を含意します。辞書に `\"xref\"` " #~ "キーが追加されます。見つからない場合、値は0で、イメージが「インライン」または他の方法で検出できないことを意味します。このオプションは応答時間が延長されるため、注意が必要です。少なくとも2回のMD5ハッシュコードの計算が各イメージに対して行われます。" #~ msgid "" #~ "the boundary box of the image --" #~ " optionally also its transformation matrix." #~ " * *(Changed in v1.16.7)* -- If " #~ "the page in fact does not display" #~ " this image, an infinite rectangle is" #~ " returned now. In previous versions, " #~ "an exception was raised. Formally " #~ "invalid parameters still raise exceptions. " #~ "* *(Changed in v1.17.0)* -- Only " #~ "images referenced directly by the page" #~ " are considered. This means that " #~ "images occurring in embedded PDF pages" #~ " are ignored and an exception is " #~ "raised. * *(Changed in v1.18.5)* -- " #~ "Removed the restriction introduced in " #~ "v1.17.0: any item of the page's " #~ "image list may be specified. * " #~ "*(Changed in v1.18.11)* -- Partially " #~ "re-instated a restriction: only those " #~ "images are considered, that are either" #~ " directly referenced by the page or" #~ " by a Form XObject directly " #~ "referenced by the page. * *(Changed " #~ "in v1.18.11)* -- Optionally also return" #~ " the transformation matrix together with" #~ " the bbox as the tuple `(bbox, " #~ "transform)`." #~ msgstr "" #~ msgid "" #~ "*(new in v1.17.5)* -- controls how " #~ "text is represented. ``True`` outputs " #~ "each character as a series of " #~ "elementary draw commands, which leads to" #~ " a more precise text display in " #~ "browsers, but a **very much larger** " #~ "output for text-oriented pages. Display" #~ " quality for ``False`` relies on the" #~ " presence of the referenced fonts on" #~ " the current system. For missing " #~ "fonts, the internet browser will fall" #~ " back to some default -- leading " #~ "to unpleasant appearances. Choose ``False``" #~ " if you want to parse the text" #~ " of the SVG." #~ msgstr "" #~ "*(v1.17.5で新規)* " #~ "–テキストの表現方法を制御します。Trueは、各文字を基本的な描画コマンドのシリーズとして出力し、ブラウザでより正確なテキスト表示を提供しますが、テキスト指向のページでは非常に大きな出力になります。" #~ " ``False`` " #~ "の表示品質は、現在のシステム上の参照フォントの存在に依存しています。不足しているフォントの場合、インターネットブラウザはデフォルトにフォールバックし、不快な外観になります。" #~ " SVGのテキストを解析する場合は ``False`` を選択してください。" #~ msgid "" #~ "whether to add an alpha channel. " #~ "Always accept the default ``False`` if" #~ " you do not really need transparency." #~ " This will save a lot of memory" #~ " (25% in case of RGB ... and" #~ " pixmaps are typically **large**!), and " #~ "also processing time. Also note an " #~ "**important difference** in how the " #~ "image will be rendered: with ``True``" #~ " the pixmap's samples area will be" #~ " pre-cleared with *0x00*. This " #~ "results in **transparent** areas where " #~ "the page is empty. With ``False`` " #~ "the pixmap's samples will be pre-" #~ "cleared with *0xff*. This results in " #~ "**white** where the page has nothing " #~ "to show. Changed in v1.14.17 The " #~ "default alpha value is now ``False``." #~ " * Generated with *alpha=True* .." #~ " image:: images/img-alpha-1.* * " #~ "Generated with *alpha=False* .. image::" #~ " images/img-alpha-0.*" #~ msgstr "" #~ msgid "" #~ "(new in v1.19.0) use a previously " #~ "created :ref:`TextPage`. This reduces " #~ "execution time **significantly.** If " #~ "specified, the 'flags' and 'clip' " #~ "arguments are ignored. If omitted, a " #~ "temporary textpage will be created." #~ msgstr "" #~ "(v1.19.0で新規追加) 以前に作成した :ref:`TextPage` " #~ "を使用します。これにより、実行時間が大幅に短縮されます。指定した場合、「flags」と「clip」引数は無視されます。省略した場合、一時的なテキストページが作成されます。" #~ msgid "" #~ "A list of :ref:`Rect` or :ref:`Quad`" #~ " objects, each of which -- " #~ "**normally!** -- surrounds one occurrence " #~ "of *needle*. **However:** if parts of" #~ " *needle* occur on more than one " #~ "line, then a separate item is " #~ "generated for each these parts. So, " #~ "if `needle = \"search string\"`, two " #~ "rectangles may be generated. **Changes " #~ "in v1.18.2:** * There no longer " #~ "is a limit on the list length " #~ "(removal of the `hit_max` parameter). " #~ "* If a word is **hyphenated** at" #~ " a line break, it will still be" #~ " found. E.g. the needle \"method\" " #~ "will be found even if hyphenated " #~ "as \"meth-od\" at a line break," #~ " and two rectangles will be returned:" #~ " one surrounding \"meth\" (without the " #~ "hyphen) and another one surrounding " #~ "\"od\"." #~ msgstr "" #~ msgid "" #~ "a `TableFinder` object that has the " #~ "following significant attributes: * " #~ "**cells:** a list of **all bboxes** " #~ "on the page, that have been " #~ "identified as table cells (across all" #~ " tables). Each cell is a tuple " #~ "`(x0, y0, x1, y1)` of coordinates " #~ "or `None`. * **tables:** a list of" #~ " `Table` objects. This is `[]` if " #~ "the page has no tables. Single " #~ "tables can be found as items of" #~ " this list. But the `TableFinder` " #~ "object itself is also a sequence " #~ "of its tables. This means that if" #~ " `tabs` is a `TableFinder` object, " #~ "then table \"n\" is delivered by " #~ "`tabs.tables[n]` as well as by the " #~ "shorter `tabs[n]`. * The `Table` " #~ "object has the following attributes: " #~ "* **bbox:** the bounding box of " #~ "the table as a tuple `(x0, y0, " #~ "x1, y1)`. * **cells:** bounding boxes" #~ " of the table's cells (list of " #~ "tuples). A cell may also be " #~ "`None`. * **extract():** this method " #~ "returns the text content of each " #~ "table cell as a list of list " #~ "of strings. * **to_pandas():** this " #~ "method returns the table as a " #~ "`pandas `_ `DataFrame" #~ " `_. *" #~ " **header:** a `TableHeader` object " #~ "containing header information of the " #~ "table. * **col_count:** an integer " #~ "containing the number of table columns." #~ " * **row_count:** an integer containing" #~ " the number of table rows. * " #~ "**rows:** a list of `TableRow` objects" #~ " containing two attributes: *bbox* is " #~ "the boundary box of the row, and" #~ " *cells* is a list of table " #~ "cells contained in this row. * " #~ "The `TableHeader` object has the " #~ "following attributes: * **bbox:** the " #~ "bounding box of the header. * " #~ "**cells:** a list of bounding boxes " #~ "containing the name of the respective" #~ " column. * **names:** a list of " #~ "strings containing the text of each " #~ "of the cell bboxes. They represent " #~ "the column names -- which can be" #~ " used when exporting the table to " #~ "pandas DataFrames or CSV, etc. * " #~ "**external:** a bool indicating whether " #~ "the header bbox is outside the " #~ "table body (`True`) or not. Table " #~ "headers are never identified by the " #~ "`TableFinder` logic. Therefore, if *external*" #~ " is true, then the header cells " #~ "are not part of any cell " #~ "identified by `TableFinder`. If `external " #~ "== False`, then the first table " #~ "row is the header. Please have a" #~ " look at these `Jupyter notebooks " #~ "`_, which cover standard " #~ "situations like multiple tables on one" #~ " page or joining table fragments " #~ "across multiple pages." #~ msgstr "" #~ msgid "" #~ "**to_pandas():** this method returns the " #~ "table as a `pandas " #~ "`_ `DataFrame " #~ "`_." #~ msgstr "" #~ "**to_pandas():** このメソッドは、テーブルを `pandas " #~ "`_ `DataFrame " #~ "`_ として返します。" #~ msgid "" #~ "How to redact overlapping images. The" #~ " default (2) blanks out overlapping " #~ "pixels. *PDF_REDACT_IMAGE_NONE* (0) ignores, " #~ "and *PDF_REDACT_IMAGE_REMOVE* (1) completely " #~ "removes all overlapping images." #~ msgstr "重なる画像の赤字領域の処理方法。デフォルト（2）では重なるピクセルを消去します" #~ msgid "" #~ "The overlapping parts of **images** will" #~ " be blanked-out for default option" #~ " `PDF_REDACT_IMAGE_PIXELS` (changed in v1.18.0)." #~ " Option 0 does not touch any " #~ "images and 1 will remove any image" #~ " with an overlap. Please be aware " #~ "that there is a bug for option " #~ "*PDF_REDACT_IMAGE_PIXELS = 2*: transparent " #~ "images will be incorrectly handled!" #~ msgstr "" #~ msgid "PDF only: Add text in a given rectangle." #~ msgstr "PDFのみ: 指定された矩形にテキストを追加します。" #~ msgid "" #~ "the text. May contain any mixture " #~ "of Latin, Greek, Cyrillic, Chinese, " #~ "Japanese and Korean characters. The " #~ "respective required font is automatically " #~ "determined. (New in v1.17.0)" #~ msgstr "" #~ "テキスト。*（v1.17.0で新規追加）* " #~ "ラテン文字、ギリシャ文字、キリル文字、中国語、日本語、韓国語の文字を任意の組み合わせで含めることができます。必要なフォントは自動的に決定されます。" #~ msgid "" #~ "the font name. Default is \"Helv\". " #~ "Accepted alternatives are \"Cour\", \"TiRo\"," #~ " \"ZaDb\" and \"Symb\". The name may" #~ " be abbreviated to the first two " #~ "characters, like \"Co\" for \"Cour\". " #~ "Lower case is also accepted. Bold " #~ "or italic variants of the fonts " #~ "are **not accepted** (changed in " #~ "v1.16.0). A user-contributed script " #~ "provides a circumvention for this " #~ "restriction -- see section *Using " #~ "Buttons and JavaScript* in chapter " #~ ":ref:`FAQ`. The actual font to use " #~ "is now determined on a by-" #~ "character level, and all required fonts" #~ " (or sub-fonts) are automatically " #~ "included. Therefore, you should rarely " #~ "ever need to care about this " #~ "parameter and let it default (except " #~ "you insist on a serifed font for" #~ " your non-CJK text parts). (New " #~ "in v1.17.0)" #~ msgstr "" #~ "フォント名。デフォルトは \"Helv\" です。受け入れられる代替は " #~ "\"Cour\"、\"TiRo\"、\"ZaDb\"、\"Symb\" です。名前は \"Cour\" " #~ "のように最初の2文字に省略されることがあります。小文字も受け入れられます。太字やイタリックのバリアントのフォントは受け入れられません（v1.16.0で変更）。ユーザー投稿のスクリプトがこの制限を回避する方法を提供しています" #~ " - " #~ "FAQの章の「ボタンとJavaScriptの使用」セクションを参照してください。使用する実際のフォントは、今では文字ごとに決定され、必要なすべてのフォント（またはサブフォント）が自動的に含まれます。したがって、このパラメーターについて心配する必要があることはほとんどありませんし、デフォルトのままにしておくことが推奨されます（非CJKテキスト部分にセリフのあるフォントが必要な場合を除く）。（v1.17.0で新規）" #~ msgid "the fill color. Default is white. (New in v1.16.0)" #~ msgstr "塗りつぶしの色です。デフォルトは白です。(v1.16.0 で新規追加)" #~ msgid "the text color. Default is black." #~ msgstr "テキストの色。デフォルトは黒です。" #~ msgid "the border color. Default is `None`. (New in v1.19.6)" #~ msgstr "*（v1.19.6で新規追加）* 境界色。デフォルトは `None` です。" #~ msgid "" #~ "text alignment, one of TEXT_ALIGN_LEFT, " #~ "TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT - justify " #~ "is **not supported**. (New in v1.17.0)" #~ msgstr "" #~ "テキストの配置は、TEXT_ALIGN_LEFT、TEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHTのいずれかを指定します。ジャスティファイは" #~ " **サポートされていません** 。(v1.17.0で新規追加)" #~ msgid "" #~ "the created annotation. Color properties " #~ "**can only be changed** using special" #~ " parameters of :meth:`Annot.update`. There, " #~ "you can also set a border color" #~ " different from the text color." #~ msgstr "" #~ "作成された注釈。色のプロパティは、:meth:`Annot.update` の特別なパラメータを使用して " #~ "**のみ変更できます**。そこでは、テキストの色とは異なる境界色を設定することもできます。" #~ msgid "" #~ "the font to use when *text* is " #~ "given, otherwise ignored. The same rules" #~ " apply as for :meth:`Page.insert_textbox` " #~ "-- which is the method " #~ ":meth:`Page.apply_redactions` internally invokes. " #~ "The replacement text will be " #~ "**vertically centered**, if this is one" #~ " of the CJK or :ref:`Base-14-Fonts`. " #~ "(New in v1.16.12) .. note:: * " #~ "For an **existing** font of the " #~ "page, use its reference name as " #~ "*fontname* (this is *item[4]* of its " #~ "entry in :meth:`Page.get_fonts`). * For " #~ "a **new, non-builtin** font, proceed " #~ "as follows:: page.insert_text(point, # " #~ "anywhere, but outside all redaction " #~ "rectangles \"something\", # some " #~ "non-empty string fontname=\"newname\", " #~ "# new, unused reference name " #~ "fontfile=\"...\", # desired font file" #~ " render_mode=3, # makes the text" #~ " invisible ) page.add_redact_annot(..., " #~ "fontname=\"newname\")" #~ msgstr "" #~ "（新機能 v1.16.12）テキストが指定された場合に使用するフォントで、それ以外の場合は無視されます。 " #~ ":meth:`Page.insert_textbox` " #~ "に適用されるルールと同じです。:meth:`Page.apply_redactions` " #~ "が内部的に呼び出すメソッドです。置換テキストは、CJKフォントまたは P :ref:`Base-14-Fonts`" #~ " の場合、垂直方向に中央揃えになります。" #~ msgid "" #~ "the font to use when *text* is " #~ "given, otherwise ignored. The same rules" #~ " apply as for :meth:`Page.insert_textbox` " #~ "-- which is the method " #~ ":meth:`Page.apply_redactions` internally invokes. " #~ "The replacement text will be " #~ "**vertically centered**, if this is one" #~ " of the CJK or :ref:`Base-14-Fonts`. " #~ "(New in v1.16.12)" #~ msgstr "" #~ "（新機能 v1.16.12）テキストが指定された場合に使用するフォントで、それ以外の場合は無視されます。 " #~ ":meth:`Page.insert_textbox` " #~ "に適用されるルールと同じです。:meth:`Page.apply_redactions` " #~ "が内部的に呼び出すメソッドです。置換テキストは、CJKフォントまたは P :ref:`Base-14-Fonts`" #~ " の場合、垂直方向に中央揃えになります。" #~ msgid "" #~ "For an **existing** font of the " #~ "page, use its reference name as " #~ "*fontname* (this is *item[4]* of its " #~ "entry in :meth:`Page.get_fonts`)." #~ msgstr "" #~ "ページの **既存** のフォントの場合、参照名を *fontname* " #~ "として使用してください（これは :meth:`Page.get_fonts` のエントリの " #~ "*item[4]* です）。" #~ msgid "For a **new, non-builtin** font, proceed as follows::" #~ msgstr "**新しいビルトインでない** フォントの場合、次の手順を実行します::" #~ msgid "" #~ "a `TableFinder` object that has the " #~ "following significant attributes: * `cells`:" #~ " a list of **all bboxes** on " #~ "the page, that have been identified " #~ "as table cells (across all tables). " #~ "Each cell is a :data:`rect_like` tuple" #~ " `(x0, y0, x1, y1)` of coordinates" #~ " or `None`. * `tables`: a list " #~ "of `Table` objects. This is `[]` " #~ "if the page has no tables. Single" #~ " tables can be found as items " #~ "of this list. But the `TableFinder` " #~ "object itself is also a sequence " #~ "of its tables. This means that if" #~ " `tabs` is a `TableFinder` object, " #~ "then table \"n\" is delivered by " #~ "`tabs.tables[n]` as well as by the " #~ "shorter `tabs[n]`. * The `Table` " #~ "object has the following attributes: " #~ "* `bbox`: the bounding box of the" #~ " table as a tuple `(x0, y0, x1," #~ " y1)`. * `cells`: bounding boxes of" #~ " the table's cells (list of tuples)." #~ " A cell may also be `None`. *" #~ " `extract()`: this method returns the " #~ "text content of each table cell as" #~ " a list of list of strings. *" #~ " `to_markdown()`: this method returns the" #~ " table as a **string in markdown " #~ "format** (compatible to Github). Supporting" #~ " viewers can render the string as " #~ "a table. This output is optimized " #~ "for **small token** sizes, which is " #~ "especially beneficial for LLM/RAG feeds. " #~ "Pandas DataFrames (see method `to_pandas()`" #~ " below) offer an equivalent markdown " #~ "table output which however is better " #~ "readable for the human eye. * " #~ "`to_pandas()`: this method returns the " #~ "table as a `pandas " #~ "`_ `DataFrame " #~ "`_. " #~ "DataFrames are very versatile objects " #~ "allowing a plethora of table " #~ "manipulation methods and outputs to " #~ "almost 20 well-known formats, among " #~ "them Excel files, CSV, JSON, " #~ "markdown-formatted tables and more. " #~ "`DataFrame.to_markdown()` generates a Github-" #~ "compatible markdown format optimized for " #~ "human readability. This method however " #~ "requires the package " #~ "[tablutate](https://pypi.org/project/tabulate/) to " #~ "installed in addition to pandas itself." #~ " * ``header``: a `TableHeader` object " #~ "containing header information of the " #~ "table. * `col_count`: an integer " #~ "containing the number of table columns." #~ " * `row_count`: an integer containing " #~ "the number of table rows. * " #~ "`rows`: a list of `TableRow` objects " #~ "containing two attributes, ``bbox`` is " #~ "the boundary box of the row, and" #~ " `cells` is a list of table " #~ "cells contained in this row. * " #~ "The `TableHeader` object has the " #~ "following attributes: * ``bbox``: the " #~ "bounding box of the header. * " #~ "`cells`: a list of bounding boxes " #~ "containing the name of the respective" #~ " column. * `names`: a list of " #~ "strings containing the text of each " #~ "of the cell bboxes. They represent " #~ "the column names -- which are used" #~ " when exporting the table to pandas" #~ " DataFrames, markdown, etc. * `external`:" #~ " a bool indicating whether the header" #~ " bbox is outside the table body " #~ "(`True`) or not. Table headers are " #~ "never identified by the `TableFinder` " #~ "logic. Therefore, if `external` is true," #~ " then the header cells are not " #~ "part of any cell identified by " #~ "`TableFinder`. If `external == False`, " #~ "then the first table row is the" #~ " header. Please have a look at " #~ "these `Jupyter notebooks `_, which" #~ " cover standard situations like multiple" #~ " tables on one page or joining " #~ "table fragments across multiple pages." #~ msgstr "" #~ msgid "" #~ "PDF only: Add a \"rubber stamp\" " #~ "like annotation to e.g. indicate the " #~ "document's intended use (\"DRAFT\", " #~ "\"CONFIDENTIAL\", etc.)." #~ msgstr "PDF専用: \"ドラフト\"、\"機密\"などの文書の意図した使用を示すための「スタンプ」のような注釈を追加します。" #~ msgid "" #~ "The stamp's text and its border " #~ "line will automatically be sized and " #~ "be put horizontally and vertically " #~ "centered in the given rectangle. " #~ ":attr:`Annot.rect` is automatically calculated " #~ "to fit the given **width** and " #~ "will usually be smaller than this " #~ "parameter." #~ msgstr "" #~ "スタンプのテキストとその境界線は、自動的にサイズ変更され、指定された矩形内で水平および垂直方向に中央に配置されます。:attr:`Annot.rect`" #~ " は指定された **幅** に合わせて自動的に計算され、通常はこのパラメータよりも小さくなります。" #~ msgid "" #~ "This can be used to create " #~ "watermark images: on a temporary PDF " #~ "page create a stamp annotation with " #~ "a low opacity value, make a pixmap" #~ " from it with *alpha=True* (and " #~ "potentially also rotate it), discard the" #~ " temporary PDF page and use the " #~ "pixmap with :meth:`insert_image` for your " #~ "target PDF." #~ msgstr "" #~ "これは透かし画像を作成するために使用できます。一時的なPDFページ上に低い不透明度のスタンプ注釈を作成し、*alpha=True* " #~ "でそれからピクスマップを作成し（おそらく回転させることもあります）、一時的なPDFページを破棄し、ターゲットのPDFに挿入するためにピクスマップを" #~ " :meth:`insert_image` で使用します。" #~ msgid "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" #~ msgstr "" #~ msgid "\"words\" -- :meth:`TextPage.extractWORDS`" #~ msgstr "" #~ msgid "\"html\" -- :meth:`TextPage.extractHTML`" #~ msgstr "" #~ msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`" #~ msgstr "" #~ msgid "\"xml\" -- :meth:`TextPage.extractXML`" #~ msgstr "" #~ msgid "\"dict\" -- :meth:`TextPage.extractDICT`" #~ msgstr "" #~ msgid "\"json\" -- :meth:`TextPage.extractJSON`" #~ msgstr "" #~ msgid "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" #~ msgstr "" #~ msgid "\"rawjson\" -- :meth:`TextPage.extractRAWJSON`" #~ msgstr "" #~ msgid "" #~ "A string indicating the requested " #~ "format, one of the above. A " #~ "mixture of upper and lower case is" #~ " supported. Values \"words\" and " #~ "\"blocks\" are also accepted (changed in" #~ " v1.16.3)." #~ msgstr "要求される形式を示す文字列、上記のいずれか。大文字と小文字の組み合わせがサポートされています" #~ msgid "Values \"words\" and \"blocks\" are also accepted (changed in v1.16.3)." #~ msgstr "v1.16.3で変更された値 “words” と “blocks” も受け入れられるようになりました。" #~ msgid "" #~ "restrict extracted text to this " #~ "rectangle. If None, the full page " #~ "is taken. Has **no effect** for " #~ "options \"html\", \"xhtml\" and \"xml\". " #~ "(New in v1.17.7)" #~ msgstr "" #~ "*(v1.17.7で新たに追加)* 抽出されたテキストをこの矩形に制限します。Noneの場合、フルページが取得されます。 " #~ "“html”、“xhtml”、“xml”のオプションには **影響しません**。" #~ msgid "" #~ "sort the output by vertical, then " #~ "horizontal coordinates. In many cases, " #~ "this should suffice to generate a " #~ "\"natural\" reading order. Has no effect" #~ " on (X)HTML and XML. Output option" #~ " **\"words\"** sorts by `(y1, x0)` of" #~ " the words' bboxes. Similar is true" #~ " for \"blocks\", \"dict\", \"json\", " #~ "\"rawdict\", \"rawjson\": they all are " #~ "sorted by `(y1, x0)` of the resp." #~ " block bbox. If specified for " #~ "\"text\", then internally \"blocks\" is " #~ "used. (New in v1.19.1)" #~ msgstr "" #~ "出力を垂直座標、次に水平座標でソートします。多くの場合、これで「自然な」読み取り順序を生成するのに十分です。 " #~ "(X)HTMLおよびXMLには影響しません。出力オプション「words」は、単語の境界ボックスの `(y1, " #~ "x0)` " #~ "でソートされます。\"blocks\"、\"dict\"、\"json\"、\"rawdict\"、\"rawjson\" " #~ "についても同様であり、それぞれのブロックの境界ボックスの `(y1, x0)` でソートされます。" #~ " \"text\" に対して指定された場合、内部的には \"blocks\" が使用されます。" #~ " (v1.19.1で新たに追加)" #~ msgid "" #~ "The inclusion of text via the " #~ "*clip* parameter is decided on a " #~ "by-character level: a character becomes " #~ "part of the output, if its bbox" #~ " is contained in *clip* (changed in" #~ " v1.18.2). This **deviates** from the " #~ "algorithm used in redaction annotations: " #~ "a character will be **removed if " #~ "its bbox intersects** any redaction " #~ "annotation." #~ msgstr "" #~ "*clip* パラメータを使用したテキストの含み方は、文字ごとのレベルで決定されます：文字のバウンディングボックスが " #~ "*clip* に含まれる場合、その文字は出力の一部となります（v1.18.2で変更）。 " #~ "これは、レダクション注釈で使用されるアルゴリズムとは異なります：文字のバウンディングボックスがどのレダクション注釈とも交差する場合、文字は削除されます。" #~ msgid "" #~ "a :ref:`TextPage`. Execution may be " #~ "significantly longer than :meth:`Page.get_textpage`." #~ " For a full page OCR, **all " #~ "text** will have the font " #~ "\"GlyphlessFont\" from Tesseract. In case " #~ "of partial OCR, normal text will " #~ "keep its properties, and only text " #~ "coming from images will have the " #~ "GlyphlessFont. .. note:: **OCRed text " #~ "is only available** to PyMuPDF's text" #~ " extractions and searches if their " #~ "`textpage` parameter specifies the output " #~ "of this method. `This " #~ "`_ Jupyter " #~ "notebook walks through an example for" #~ " using OCR textpages." #~ msgstr "" #~ msgid "" #~ "Return a list of meta information " #~ "dictionaries for all images shown on " #~ "the page. This works for all " #~ "document types. Technically, this is a" #~ " subset of the dictionary output of" #~ " :meth:`Page.get_text`: the image binary " #~ "content and any text on the page" #~ " are ignored." #~ msgstr "" #~ "ページ上に表示されているすべてのイメージに関するメタ情報辞書のリストを返します。これはすべての文書タイプで機能します。技術的には、これは" #~ " :meth:`Page.get_text` " #~ "の辞書出力のサブセットであり、画像のバイナリコンテンツとページ上のテキストは無視されます。" #~ msgid "" #~ "**PDF only.** Try to find the " #~ ":data:`xref` for each image. Implies " #~ "`hashes=True`. Adds the `\"xref\"` key " #~ "to the dictionary. If not found, " #~ "the value is 0, which means, the" #~ " image is either \"inline\" or " #~ "otherwise undetectable. Please note that " #~ "this option has an extended response " #~ "time, because the MD5 hashcode will " #~ "be computed at least two times for" #~ " each image with an xref. (New " #~ "in v1.18.13)" #~ msgstr "" #~ "**PDFのみ。** 各画像の :data:`xref` " #~ "を見つけようとします。`hashes=True` を意味します。辞書に `\"xref\"` " #~ "キーを追加します。見つからない場合、値は0で、画像が「インライン」であるか、または他の方法で検出できないことを意味します。このオプションは、少なくとも各画像に対してMD5ハッシュコードが2回計算されるため、応答時間が延びることに注意してください。(v1.18.13で新規追加)" #~ msgid "" #~ "A list of dictionaries. This includes" #~ " information for **exactly those** images," #~ " that are shown on the page --" #~ " including *\"inline images\"*. In contrast" #~ " to images included in " #~ ":meth:`Page.get_text`, image **binary content** " #~ "is not loaded, which drastically reduces" #~ " memory usage. The dictionary layout " #~ "is similar to that of image blocks" #~ " in `page.get_text(\"dict\")`. =============== " #~ "=============================================================== " #~ "**Key** **Value** =============== " #~ "=============================================================== " #~ "number block number *(int)* bbox" #~ " image bbox on page, " #~ ":data:`rect_like` width original image " #~ "width *(int)* height original image" #~ " height *(int)* cs-name colorspace" #~ " name *(str)* colorspace colorspace.n " #~ "*(int)* xres resolution in " #~ "x-direction *(int)* yres resolution " #~ "in y-direction *(int)* bpc bits" #~ " per component *(int)* size " #~ "storage occupied by image *(int)* digest" #~ " MD5 hashcode *(bytes)*, if " #~ "*hashes* is true xref image " #~ ":data:`xref` or 0, if *xrefs* is " #~ "true transform matrix transforming image" #~ " rect to bbox, :data:`matrix_like` " #~ "=============== " #~ "=============================================================== " #~ "Multiple occurrences of the same image" #~ " are always reported. You can detect" #~ " duplicates by comparing their `digest` " #~ "values." #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "This parameter only has an effect " #~ "if `richtext=True`. Otherwise, ``text_color`` " #~ "is used." #~ msgstr "" #~ msgid "" #~ "the width of border and ``callout`` " #~ "lines. Default is 0 (no border), " #~ "in which case callout lines may " #~ "still appear with some hairline width," #~ " depending on the PDF viewer used." #~ msgstr "" #~ msgid "" #~ "treat ``text`` as HTML syntax. This " #~ "allows to achieve **bold**, *italic*, " #~ "arbitrary text colors, font sizes, text" #~ " alignment including justify and more " #~ "- as far as HTML and styling " #~ "instructions support this. This is " #~ "similar to what happens in " #~ ":meth:`Page.insert_htmlbox`. The base library " #~ "will for example pull in required " #~ "fonts if it encounters characters not" #~ " contained in the standard ones. Some" #~ " parameters are ignored if this " #~ "option is set, as mentioned above. " #~ "Default is ``False``." #~ msgstr "" #~ msgid "" #~ "a `TableFinder` object that has the " #~ "following significant attributes: * `cells`:" #~ " a list of **all bboxes** on " #~ "the page, that have been identified " #~ "as table cells (across all tables). " #~ "Each cell is a :data:`rect_like` tuple" #~ " `(x0, y0, x1, y1)` of coordinates" #~ " or `None`. * `tables`: a list " #~ "of `Table` objects. This is `[]` " #~ "if the page has no tables. Single" #~ " tables can be found as items " #~ "of this list. But the `TableFinder` " #~ "object itself is also a sequence " #~ "of its tables. This means that if" #~ " `tabs` is a `TableFinder` object, " #~ "then table \"n\" is delivered by " #~ "`tabs.tables[n]` as well as by the " #~ "shorter `tabs[n]`. * The `Table` " #~ "object has the following attributes: " #~ "* ``bbox``: the bounding box of " #~ "the table as a tuple `(x0, y0, " #~ "x1, y1)`. * ``cells``: bounding boxes" #~ " of the table's cells (list of " #~ "tuples). A cell may also be " #~ "`None`. * ``extract()``: this method " #~ "returns the text content of each " #~ "table cell as a list of list " #~ "of strings. * ``to_markdown()``: this " #~ "method returns the table as a " #~ "**string in markdown format** (compatible " #~ "to Github). Supporting viewers can " #~ "render the string as a table. This" #~ " output is optimized for **small " #~ "token** sizes, which is especially " #~ "beneficial for LLM/RAG feeds. Pandas " #~ "DataFrames (see method `to_pandas()` below)" #~ " offer an equivalent markdown table " #~ "output which however is better readable" #~ " for the human eye. * " #~ "`to_pandas()`: this method returns the " #~ "table as a `pandas " #~ "`_ `DataFrame " #~ "`_. " #~ "DataFrames are very versatile objects " #~ "allowing a plethora of table " #~ "manipulation methods and outputs to " #~ "almost 20 well-known formats, among " #~ "them Excel files, CSV, JSON, " #~ "markdown-formatted tables and more. " #~ "`DataFrame.to_markdown()` generates a Github-" #~ "compatible markdown format optimized for " #~ "human readability. This method however " #~ "requires the package `tabulate " #~ "`_ to be " #~ "installed in addition to pandas itself." #~ " * ``header``: a `TableHeader` object " #~ "containing header information of the " #~ "table. * ``col_count``: an integer " #~ "containing the number of table columns." #~ " * ``row_count``: an integer containing" #~ " the number of table rows. * " #~ "``rows``: a list of `TableRow` objects" #~ " containing two attributes, ``bbox`` is " #~ "the boundary box of the row, and" #~ " `cells` is a list of table " #~ "cells contained in this row. * " #~ "The `TableHeader` object has the " #~ "following attributes: * ``bbox``: the " #~ "bounding box of the header. * " #~ "`cells`: a list of bounding boxes " #~ "containing the name of the respective" #~ " column. * `names`: a list of " #~ "strings containing the text of each " #~ "of the cell bboxes. They represent " #~ "the column names -- which are used" #~ " when exporting the table to pandas" #~ " DataFrames, markdown, etc. * `external`:" #~ " a bool indicating whether the header" #~ " bbox is outside the table body " #~ "(`True`) or not. Table headers are " #~ "never identified by the `TableFinder` " #~ "logic. Therefore, if `external` is true," #~ " then the header cells are not " #~ "part of any cell identified by " #~ "`TableFinder`. If `external == False`, " #~ "then the first table row is the" #~ " header. Please have a look at " #~ "these `Jupyter notebooks `_, which" #~ " cover standard situations like multiple" #~ " tables on one page or joining " #~ "table fragments across multiple pages. " #~ ".. caution:: The lifetime of the " #~ "`TableFinder` object, as well as that" #~ " of all its tables **equals the " #~ "lifetime of the page**. If the " #~ "page object is deleted or reassigned," #~ " all tables are no longer valid." #~ " The only way to keep table " #~ "content beyond the page's availability " #~ "is to **extract it** via methods " #~ "`Table.to_markdown()`, `Table.to_pandas()` or a " #~ "copy of `Table.extract()` (e.g. " #~ "`Table.extract()[:]`). .. note:: Once a" #~ " table has been extracted to a " #~ "**Pandas DataFrame** with `to_pandas()` it " #~ "is easy to convert to other file" #~ " types with the **Pandas API**: -" #~ " table to Markdown, use `to_markdown " #~ "`_" #~ " - table to JSON, use: `to_json" #~ " " #~ "`_" #~ " - table to Excel, use: `to_excel" #~ " " #~ "`_" #~ " - table to CSV, use: `to_csv " #~ "`_" #~ " - table to HTML, use: `to_html" #~ " " #~ "`_" #~ " - table to SQL, use: `to_sql " #~ "`_" #~ msgstr "" #~ msgid "" #~ "``to_markdown()``: this method returns the " #~ "table as a **string in markdown " #~ "format** (compatible to Github). Supporting" #~ " viewers can render the string as " #~ "a table. This output is optimized " #~ "for **small token** sizes, which is " #~ "especially beneficial for LLM/RAG feeds. " #~ "Pandas DataFrames (see method `to_pandas()`" #~ " below) offer an equivalent markdown " #~ "table output which however is better " #~ "readable for the human eye." #~ msgstr "" #~ "`to_markdown()` ：このメソッドは、テーブルをGitHubと互換性のある " #~ "**Markdown形式の文字列** " #~ "として返します。サポートされているビューアは、文字列をテーブルとしてレンダリングできます。この出力は、LLM/RAGフィードに特に有益な小さいトークンサイズに最適化されています。PandasのDataFrames（後述の" #~ " `to_pandas()` " #~ "メソッドを参照）は、同等のMarkdownテーブル出力を提供しますが、人間の目にはより読みやすいです。" #~ msgid "" #~ "A tuple of floats `(spare_height, " #~ "scale)`. - `spare_height`: -1 if " #~ "content did not fit, else >= 0." #~ " It is the height of the unused" #~ " (still available) rectangle stripe. " #~ "Positive only if scale = 1 (no " #~ "down-scaling happened). - `scale`: " #~ "down-scaling factor, 0 < scale <= " #~ "1. Please refer to examples in " #~ "this section of the recipes: " #~ ":ref:`RecipesText_I_c`." #~ msgstr "" #~ "`spare_height`: " #~ "コンテンツが収まらなかった場合は-1、そうでない場合は0以上の値です。未使用の（まだ利用可能な）長方形のストライプの高さです。スケール=1の場合にのみ正の値です（ダウンスケーリングが行われなかった場合）。" #~ msgid "" #~ "`spare_height`: -1 if content did not" #~ " fit, else >= 0. It is the " #~ "height of the unused (still available)" #~ " rectangle stripe. Positive only if " #~ "scale = 1 (no down-scaling " #~ "happened)." #~ msgstr "" #~ "`spare_height`: " #~ "コンテンツが収まらなかった場合は-1、そうでない場合は0以上の値です。未使用の（まだ利用可能な）長方形のストライプの高さです。スケール=1の場合にのみ正の値です（ダウンスケーリングが行われなかった場合）。" #~ msgid "`scale`: down-scaling factor, 0 < scale <= 1." #~ msgstr "`scale`: ダウンスケーリングファクター、0 < scale <= 1。" #~ msgid "" #~ "A list of dictionaries. This includes" #~ " information for **exactly those** images," #~ " that are shown on the page --" #~ " including *\"inline images\"*. The " #~ "dictionary layout is similar to that " #~ "of image blocks in `page.get_text(\"dict\")`." #~ " In contrast to images included in" #~ " :meth:`Page.get_text`, image **binary content**" #~ " is not loaded by this method, " #~ "which drastically reduces memory usage. " #~ "Another difference is that image " #~ "detection is not restricted to the " #~ "visible part of the page or any" #~ " ``clip`` parameter: method :meth:`Page.get_text`" #~ " will only extract images **fully " #~ "contained** in the provided ``clip``. " #~ "=============== " #~ "=============================================================== " #~ "**Key** **Value** =============== " #~ "=============================================================== " #~ "number block number (``int``) bbox" #~ " image bbox on page, " #~ ":data:`rect_like` width original image " #~ "width (``int``) height original image" #~ " height (``int``) cs-name " #~ "colorspace name (``str``) colorspace " #~ "colorspace.n (``int``) xres resolution" #~ " in x-direction (``int``) yres " #~ "resolution in y-direction (``int``) bpc" #~ " bits per component (``int``) " #~ "size storage occupied by image " #~ "(``int``) digest MD5 hashcode " #~ "(``bytes``), if ``hashes`` is true xref" #~ " image :data:`xref` or 0, if " #~ "*xrefs* is true transform matrix " #~ "transforming image rect to bbox, " #~ ":data:`matrix_like` has-mask whether " #~ "the image is transparent and has a" #~ " mask (``bool``) =============== " #~ "=============================================================== " #~ "Multiple occurrences of the same image" #~ " are always reported. You can detect" #~ " duplicates by comparing their `digest` " #~ "values." #~ msgstr "" #~ msgid "" #~ "PDF only: Display a page of " #~ "another PDF as a **vector image** " #~ "(otherwise similar to :meth:`Page.insert_image`)." #~ " This is a multi-purpose method. " #~ "For example, you can use it to:" #~ msgstr "" #~ "PDFのみ：別のPDFのページをベクトルイメージとして表示します（それ以外は :meth:`Page.insert_image`" #~ " に類似）。これは多目的なメソッドです。たとえば、次のようなことに使用できます。" #~ msgid "*Document.get_page_fonts(pno)*" #~ msgstr "" #~ msgid "*Document.get_page_images(pno)*" #~ msgstr "" #~ msgid "*Document.get_page_pixmap(pno, ...)*" #~ msgstr "" #~ msgid "*Document.get_page_text(pno, ...)*" #~ msgstr "" #~ msgid "*Document.search_page_for(pno, ...)*" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pixmap.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 77cdad9d379a4a459fb8f61a5126752b msgid "Artifex" msgstr "" #: ../../header.rst:-1 32cc68ce63c240bdb7a2fdfe4d927af7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 db64d0baaca745e7910c08e63ef36441 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../pixmap.rst:7 e0494509a30b4c1991cc5e57de63e15b msgid "Pixmap" msgstr "" #: ../../pixmap.rst:9 32dd6915408a408ea1d9db1812927e46 msgid "" "Pixmaps (\"pixel maps\") are objects at the heart of MuPDF's rendering " "capabilities. They represent plane rectangular sets of pixels. Each pixel" " is described by a number of bytes (\"components\") defining its color, " "plus an optional alpha byte defining its transparency." msgstr "Pixmap（「ピクセルマップ」）は、MuPDFの描画機能の中心にあるオブジェクトです。それらは平面的な長方形のピクセルセットを表します。各ピクセルは、その色を定義するバイト数（「コンポーネント」）と、透明度を定義するオプションのアルファバイトで説明されます" #: ../../pixmap.rst:11 0ae7623584d34b0793a6b1689e2e9ff9 msgid "" "In PyMuPDF, there exist several ways to create a pixmap. Except the first" " one, all of them are available as overloaded constructors. A pixmap can " "be created ..." msgstr "PyMuPDFでは、ピクセルマップを作成するためのいくつかの方法が存在します。最初の方法を除いて、すべての方法はオーバーロードされたコンストラクタとして使用できます。ピクセルマップは、以下の方法で作成できます..." #: ../../pixmap.rst:13 73ba045692a74b84a13ce27f369588ef msgid "from a document page (method :meth:`Page.get_pixmap`)" msgstr "ドキュメントページから（メソッド :meth:`Page.get_pixmap` を使用）" #: ../../pixmap.rst:14 d9db8727d6f34c5ea67a95212b48a901 msgid "empty, based on :ref:`Colorspace` and :ref:`IRect` information" msgstr ":ref:`Colorspace` と :ref:`IRect` 情報に基づいて空のものを作成" #: ../../pixmap.rst:15 3bd37a5d119449b79b2df8e6183899b2 msgid "from a file" msgstr "ファイルから" #: ../../pixmap.rst:16 6c2ae5d2cf9e4e9c8a85876940ac2c65 msgid "from an in-memory image" msgstr "メモリ内のイメージから" #: ../../pixmap.rst:17 985854117e77421ab5c08305ad9a7ebc msgid "from a memory area of plain pixels" msgstr "平易なピクセルのメモリ領域から" #: ../../pixmap.rst:18 51817c0b224a4d79becc251812e52d59 msgid "from an image inside a PDF document" msgstr "PDFドキュメント内のイメージから" #: ../../pixmap.rst:19 c50a8dabd5de4315af9f49bd6f4e3300 msgid "as a copy of another pixmap" msgstr "他のピクセルマップのコピーとして" #: ../../pixmap.rst:21 a40603d11eae465f98c51d914e3f60f0 msgid "" "A number of image formats is supported as input for points 3. and 4. " "above. See section :ref:`ImageFiles`." msgstr "" "3.と4.のポイントに対する入力として多くの画像フォーマットがサポートされています。サポートされている入力画像フォーマットの詳細については、:ref:`ImageFiles`" " のセクションを参照してください。" #: ../../pixmap.rst:23 3bdce298316f4c59aea2dcf926ba360d msgid "" "Have a look at the :ref:`FAQ` section to see some pixmap usage \"at " "work\"." msgstr "ピクセルマップの使用例については、:ref:`FAQ` セクションをご覧ください。" #: ../../pixmap.rst:26 c77d9f0a0ac441569275429f77da5352 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../pixmap.rst:26 0c5aa62f906e4af38c4f3f15dbd58acb msgid "**Short Description**" msgstr "**短い説明**" #: ../../pixmap.rst:28 2202b52b548143ffb14aef4ce3088e4e msgid ":meth:`Pixmap.clear_with`" msgstr "" #: ../../pixmap.rst:28 f8c6fd586d294e3194f9966984db1cd7 msgid "clear parts of the pixmap" msgstr "ピクセルマップの一部をクリアします。" #: ../../pixmap.rst:29 74887257fa9a4ce4bccdc2c054561ab8 msgid ":meth:`Pixmap.color_count`" msgstr "" #: ../../pixmap.rst:29 266d94deb7124050adc51b2d0925c285 msgid "determine used colors" msgstr "使用された色を決定します。" #: ../../pixmap.rst:30 6fa71e0e57754c778d2a793a2d4b5e0c msgid ":meth:`Pixmap.color_topusage`" msgstr "" #: ../../pixmap.rst:30 40a15ae449a04a5fa2c777c1ac0a6175 msgid "determine share of most used color" msgstr "最も使用される色のシェアを決定します。" #: ../../pixmap.rst:31 b915ce033980496eb00292ada4fbcca5 msgid ":meth:`Pixmap.copy`" msgstr "" #: ../../pixmap.rst:31 8e57cd2829fa414abc482e80c6d4c4d9 msgid "copy parts of another pixmap" msgstr "別のピクセルマップの一部をコピーします。" #: ../../pixmap.rst:32 112981a34c4348f8ad862d81cdc02514 msgid ":meth:`Pixmap.gamma_with`" msgstr "" #: ../../pixmap.rst:32 f42a9b37c4ac4000a006188d993c87e5 msgid "apply a gamma factor to the pixmap" msgstr "ピクセルマップにガンマ係数を適用します。" #: ../../pixmap.rst:33 01c950df9e2145aa8d39d7760c67ad87 msgid ":meth:`Pixmap.invert_irect`" msgstr "" #: ../../pixmap.rst:33 8fd44b50652147ff824e5fc414ff6a30 msgid "invert the pixels of a given area" msgstr "指定された領域のピクセルを反転させます。" #: ../../pixmap.rst:34 516fe80e3c4a459a81a150dc6a462f8e msgid ":meth:`Pixmap.pdfocr_save`" msgstr "" #: ../../pixmap.rst:34 ../../pixmap.rst:35 67e410a8f8c842c1944b038c5708de2d #: f38b40a1d99c4c509644c872d19b87e2 msgid "save the pixmap as an OCRed 1-page PDF" msgstr "OCR処理済みの1ページのPDFとしてピクセルマップを保存します。" #: ../../pixmap.rst:35 be86eecb9ae84058896ab1db4a2fcab1 msgid ":meth:`Pixmap.pdfocr_tobytes`" msgstr "" #: ../../pixmap.rst:36 b0881e3fa8064b569e1476c50325b3d7 msgid ":meth:`Pixmap.pil_image`" msgstr "" #: ../../pixmap.rst:36 6075a73ecdcb46979d4b836f39403d5f msgid "create a Pillow Image" msgstr "" #: ../../pixmap.rst:37 c71cca896c4e47509c4fa0e362fa044c msgid ":meth:`Pixmap.pil_save`" msgstr "" #: ../../pixmap.rst:37 4be536342cb047aeb0a6b64adbba1e9a #, fuzzy msgid "save as a Pillow Image" msgstr "Pillowを使用してイメージとして保存します。" #: ../../pixmap.rst:38 52b8400d5cce434b87e23399f61d2117 msgid ":meth:`Pixmap.pil_tobytes`" msgstr "" #: ../../pixmap.rst:38 bafc4631127f4561936ab5d1e6403a2d #, fuzzy msgid "write to `bytes` as a Pillow Image" msgstr "Pillowを使用してバイトオブジェクトに書き込みます。" #: ../../pixmap.rst:39 4002db687ffc4feabe3a41f2274b7804 msgid ":meth:`Pixmap.pixel`" msgstr "" #: ../../pixmap.rst:39 efb78dfb56524049a7580e3a15723114 msgid "return the value of a pixel" msgstr "ピクセルの値を返します。" #: ../../pixmap.rst:40 e0ffa2a456944476bb6984b064566f95 msgid ":meth:`Pixmap.save`" msgstr "" #: ../../pixmap.rst:40 7f4131a6b70d41cd802f09e3f4f6f11f msgid "save the pixmap in a variety of formats" msgstr "さまざまな形式でピクセルマップを保存します。" #: ../../pixmap.rst:41 23956dccd6e94052aef51929b1c393dc msgid ":meth:`Pixmap.set_alpha`" msgstr "" #: ../../pixmap.rst:41 3979119c35f341c694e03dd5db7a0115 msgid "set alpha values" msgstr "アルファ値を設定します。" #: ../../pixmap.rst:42 80aa084bf73c4f61abbf2f808d42bdcd msgid ":meth:`Pixmap.set_dpi`" msgstr "" #: ../../pixmap.rst:42 881510d8c71545b59d91fb5dac173605 msgid "set the image resolution" msgstr "イメージの解像度を設定します。" #: ../../pixmap.rst:43 af00886d005e4a1890d7b7789b93e7e7 msgid ":meth:`Pixmap.set_origin`" msgstr "" #: ../../pixmap.rst:43 7e6045d9838046cea1cd1fcb38a15dab msgid "set pixmap x,y values" msgstr "ピクセルマップのx、y値を設定します。" #: ../../pixmap.rst:44 cb25eecee8af4917ab427d3cf303152f msgid ":meth:`Pixmap.set_pixel`" msgstr "" #: ../../pixmap.rst:44 23d1909be60a4b269aaec2547ae2aa05 msgid "set color and alpha of a pixel" msgstr "ピクセルの色とアルファを設定します。" #: ../../pixmap.rst:45 72b4d710dc894939936c377380bbc22e msgid ":meth:`Pixmap.set_rect`" msgstr "" #: ../../pixmap.rst:45 0f7af78460a4450da9d9108517b4d4c4 msgid "set color and alpha of all pixels in a rectangle" msgstr "四角形内のすべてのピクセルの色とアルファを設定します。" #: ../../pixmap.rst:46 b791b993ad61409eaef1d0b360847ffc msgid ":meth:`Pixmap.shrink`" msgstr "" #: ../../pixmap.rst:46 38e21b2c7aa8493e8bb7266e1e835f69 msgid "reduce size keeping proportions" msgstr "比率を保持しながらサイズを縮小します。" #: ../../pixmap.rst:47 be56d7fc15e24cf2826c82badd69df56 msgid ":meth:`Pixmap.tint_with`" msgstr "" #: ../../pixmap.rst:47 d5a1e740218c41ceb31d912cae43599f msgid "tint the pixmap" msgstr "ピクセルマップに色調を付けます。" #: ../../pixmap.rst:48 408bd07e5e004c53845a34ccb73684f6 msgid ":meth:`Pixmap.tobytes`" msgstr "" #: ../../pixmap.rst:48 dbfd2cd88a2e40689877d688108593b5 msgid "return a memory area in a variety of formats" msgstr "さまざまな形式のメモリ領域を返します。" #: ../../pixmap.rst:49 73ad7e8e412146939a933bc554653bd9 msgid ":meth:`Pixmap.warp`" msgstr "" #: ../../pixmap.rst:49 27dcdd34ccd6434c8be2f3d0cab9f361 msgid "return a pixmap made from a quad inside" msgstr "内部の四角形から作成されたピクセルマップを返します。" #: ../../pixmap.rst:50 85defbb4523445e9bfc92785c42fcb0b msgid ":attr:`Pixmap.alpha`" msgstr "" #: ../../pixmap.rst:50 f9f7e74d1a854ce584726e3236d915a4 msgid "transparency indicator" msgstr "透明度指示子" #: ../../pixmap.rst:51 fbf1760092864dcf8f5566ac85074c05 msgid ":attr:`Pixmap.colorspace`" msgstr "" #: ../../pixmap.rst:51 48b501a974724e6cadfe58ebbfebeb9a msgid "pixmap's :ref:`Colorspace`" msgstr "ピクセルマップの :ref:`Colorspace`" #: ../../pixmap.rst:52 b766c11c9d60491bb1cd9e4c8cfd9751 msgid ":attr:`Pixmap.digest`" msgstr "" #: ../../pixmap.rst:52 3d7b532618f3451896efe2d64d4ffdfe msgid "MD5 hashcode of the pixmap" msgstr "ピクセルマップのMD5ハッシュコード" #: ../../pixmap.rst:53 76675540ad27482bada64b6a598d25f9 msgid ":attr:`Pixmap.height`" msgstr "" #: ../../pixmap.rst:53 3c22531079e34fa79dddc4e586d958e6 msgid "pixmap height" msgstr "ピクセルマップの高さ" #: ../../pixmap.rst:54 9182d024c67b490b9fe7855b4f5715d0 msgid ":attr:`Pixmap.interpolate`" msgstr "" #: ../../pixmap.rst:54 3688b5e0286840669d320a95bc5a17fb msgid "interpolation method indicator" msgstr "補間メソッド指示子" #: ../../pixmap.rst:55 b7b0a90b1ba846e89b22db0ed4553281 msgid ":attr:`Pixmap.is_monochrome`" msgstr "" #: ../../pixmap.rst:55 df352c76b67546089f124cbd0e5babb1 msgid "check if only black and white occur" msgstr "黒と白だけが存在するか確認します。" #: ../../pixmap.rst:56 a17ad0a90a7d413c9fb8b1aa83257598 msgid ":attr:`Pixmap.is_unicolor`" msgstr "" #: ../../pixmap.rst:56 81dfed8a598641f6ae936549b0e7f7ba msgid "check if only one color occurs" msgstr "単一の色しか存在しないか確認します。" #: ../../pixmap.rst:57 abd7ff4e70754c9daef32d9525250608 msgid ":attr:`Pixmap.irect`" msgstr "" #: ../../pixmap.rst:57 2791b580e848470a814a376d6e220255 msgid ":ref:`IRect` of the pixmap" msgstr "ピクセルマップの :ref:`IRect` " #: ../../pixmap.rst:58 2fec6f3a895d4409b0e482a40f200f22 msgid ":attr:`Pixmap.n`" msgstr "" #: ../../pixmap.rst:58 c7b79f65d4494cdb897cc22abe8eff21 msgid "bytes per pixel" msgstr "ピクセルごとのバイト数" #: ../../pixmap.rst:59 743bc8e881d44773b5fcf7beffc6a3fa msgid ":attr:`Pixmap.samples_mv`" msgstr "" #: ../../pixmap.rst:59 4179ce00d1e746b295e577083af074b0 msgid "`memoryview` of pixel area" msgstr "ピクセル領域の `memoryview` " #: ../../pixmap.rst:60 c5ff63d0faaa4137832a944521ce8069 msgid ":attr:`Pixmap.samples_ptr`" msgstr "" #: ../../pixmap.rst:60 8116e2e6a5fe470082d7fbdca4673935 msgid "Python pointer to pixel area" msgstr "ピクセル領域へのPythonポインタ" #: ../../pixmap.rst:61 2abc33dc84a348c6ad9b8da90c57e531 msgid ":attr:`Pixmap.samples`" msgstr "" #: ../../pixmap.rst:61 060cb94948d84088a5cf7c6d4319fea3 msgid "`bytes` copy of pixel area" msgstr "ピクセル領域の `bytes` コピー" #: ../../pixmap.rst:62 d41ed2ab508249d0ae96e3145e92258b msgid ":attr:`Pixmap.size`" msgstr "" #: ../../pixmap.rst:62 cfe014376f9745ea9c2ce0e7a11bb369 msgid "pixmap's total length" msgstr "ピクセルマップの合計長さ" #: ../../pixmap.rst:63 34fea4631d014515b7406f2f5bb813bc msgid ":attr:`Pixmap.stride`" msgstr "" #: ../../pixmap.rst:63 5a29f36af34340aea9cba617eed85cc6 msgid "size of one image row" msgstr "1つの画像行のサイズ" #: ../../pixmap.rst:64 62ed9c389676438299a427713f0f7b08 msgid ":attr:`Pixmap.width`" msgstr "" #: ../../pixmap.rst:64 70e7618e0783483ea97302b042784152 msgid "pixmap width" msgstr "ピクセルマップの幅" #: ../../pixmap.rst:65 e62961e6786e48c796a2e5a23a76654f msgid ":attr:`Pixmap.x`" msgstr "" #: ../../pixmap.rst:65 4e8faa2fe6154453bf50951bfbcbfa0e msgid "X-coordinate of top-left corner" msgstr "左上隅のX座標" #: ../../pixmap.rst:66 d69ccf0ae1844b88aaff3eb7fbfa1973 msgid ":attr:`Pixmap.xres`" msgstr "" #: ../../pixmap.rst:66 a1ecbc77214845fea2e4c6cee89a8ce8 msgid "resolution in X-direction" msgstr "X方向の解像度" #: ../../pixmap.rst:67 83ca1188acde43af9c9f6c742f8c9fcb msgid ":attr:`Pixmap.y`" msgstr "" #: ../../pixmap.rst:67 b0432d623ef4473aa3515de8b215d9f5 msgid "Y-coordinate of top-left corner" msgstr "左上隅のY座標" #: ../../pixmap.rst:68 b704d755356e4e53903e4306cb1850d6 msgid ":attr:`Pixmap.yres`" msgstr "" #: ../../pixmap.rst:68 857aeb5083a44b1795d1ede13f95021f msgid "resolution in Y-direction" msgstr "Y方向の解像度" #: ../../pixmap.rst:71 a006e37a45ad4ed88da3603714dc9820 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../pixmap.rst:77 046bff7f68fe47dc89b42ec79b63be49 msgid "" "**New empty pixmap:** Create an empty pixmap of size and origin given by " "the rectangle. So, *irect.top_left* designates the top left corner of the" " pixmap, and its width and height are *irect.width* resp. *irect.height*." " Note that the image area is **not initialized** and will contain crap " "data -- use eg. :meth:`clear_with` or :meth:`set_rect` to be sure." msgstr "" "**新しい空のピクマップ:** 指定された矩形のサイズと原点を持つ空のピクマップを作成します。したがって、*irect.top_left* " "はピクマップの左上隅を示し、その幅と高さは *irect.width* および *irect.height* です。イメージ領域は " "**初期化されず** 、データが格納されます。データを初期化するには、:meth:`clear_with` や :meth:`set_rect` " "などを使用してください。" #: ../../pixmap.rst 02b0fea3d9c34817aad000ad9f071590 #: 054aba92b788492e988045fb104e4481 0eb0df83e45a406cb560af5072cdff86 #: 2d9ab2f5c1024f7085600fc7ec9dc603 42fca49eb0844237a0b14c72c95e7dbc #: 4c84fc0dcb054b659ed6e2dae1b27605 57542313cdbd47cc89f43d9329495cb5 #: 610dfac6df044219bea31b4eb7ef6b47 63f20c0df7eb4be8be807f287c781d58 #: 67a50e42c1294501bb59b8b035850481 687444f1e3dc45509b4ec2a7192c0a48 #: 73fe0913c7364c31916311fc0cffc16e 7e25b63146fa45858f1ff6b966a16913 #: 8b3e2416c26c445bb9979be602f6adf5 95824bfb86ff41de835e47b77393048f #: a5c5caaf10934649be3b74635eb16787 af618a04af8e40efa6512d296a27fb9b #: bdfbcea144bd4cfb93f787f52dfadf48 c7f77794bd054561aa08e0b18497e5bd #: d044792ccaea48328805a0a6efd678c9 d625b8ee73b34a459873edc513b40002 #: d81abb686bb542518846ad32bd035b5e dd1276958278455fb3ad0d1ad3b08045 #: dd4e9e5837dc4c1eb17ec63c8681b4d4 e60d8f4e03c24b918ad9bdf22e21adb0 #: f1bff3e4b66c4afca6ae66a014ac0fc1 f2e0f5d755134588846f75c89c28b5af #: f8a2e37bd2ef4ca79bf827a1a3fe8e70 msgid "Parameters" msgstr "" #: ../../pixmap.rst:79 56321802a9014c348fa2d20d4294c9f2 msgid "colorspace." msgstr "カラースペース。" #: ../../pixmap.rst:82 3753a76b227f496eb369ca2d40057f0c msgid "The pixmap's position and dimension." msgstr "ピクマップの位置と寸法。" #: ../../pixmap.rst:84 0f1256f4866c4a888d73cefe035cfb17 msgid "" "Specifies whether transparency bytes should be included. Default is " "``False``." msgstr "透明度バイトを含めるかどうかを指定します。デフォルトは ``False`` です。" #: ../../pixmap.rst:88 b9326c334f6345fdaf185501bfa27892 msgid "" "**Copy and set colorspace:** Copy *source* pixmap converting colorspace. " "Any colorspace combination is possible, but source colorspace must not be" " ``None``." msgstr "" "**コピーとカラースペースの設定:** カラースペースを変換しながら *ソース* " "ピクマップをコピーします。どのカラースペースの組み合わせでも可能ですが、ソースカラースペースは ``None`` であってはいけません。" #: ../../pixmap.rst:90 97014f607fba4a5cb553297120c90034 msgid "" "desired **target** colorspace. This **may also be** ``None``. In this " "case, a \"masking\" pixmap is created: its :attr:`Pixmap.samples` will " "consist of the source's alpha bytes only." msgstr "" "**ターゲット** となるカラースペース。これは ``None`` **である場合もあります** 。この場合、 \"マスク\" " "ピクマップが作成されます。その :attr:`Pixmap.samples` は、ソースのアルファバイトだけで構成されます。" #: ../../pixmap.rst:93 ../../pixmap.rst:112 36ef86e1d48d4c5a9dd2bf95b2fd7b14 #: 52423174b9b746d2840bdc738fa82069 msgid "the source pixmap." msgstr "ソースピクマップ。" #: ../../pixmap.rst:98 1df405a79ae244d1a01b677a84951540 msgid "New in v1.18.18" msgstr "バージョン 1.18.18 で新規追加" #: ../../pixmap.rst:100 dac52c1c940a488587523e971b8678bb msgid "" "**Copy and add image mask:** Copy *source* pixmap, add an alpha channel " "with transparency data from a mask pixmap." msgstr "**コピーとイメージマスクの追加:** ソースピクマップをコピーし、マスクピクマップから透明度データを持つアルファチャネルを追加します。" #: ../../pixmap.rst:102 760c74ba53044cbcbdf31aee15f90bca msgid "pixmap without alpha channel." msgstr "アルファチャネルを持たないピクマップ。" #: ../../pixmap.rst:105 46e5c3640fcf48d382edee1c823984e6 msgid "a mask pixmap. Must be a graysale pixmap." msgstr "マスクピクマップ。グレースケールのピクマップである必要があります。" #: ../../pixmap.rst:110 d9ec3e84c0ea4239b426990e4164290e msgid "" "**Copy and scale:** Copy *source* pixmap, scaling new width and height " "values -- the image will appear stretched or shrunk accordingly. Supports" " partial copying. The source colorspace may be ``None``." msgstr "" "**コピーとスケーリング:** " "ソースピクマップをコピーし、新しい幅と高さの値にスケーリングします。イメージはそれに応じてストレッチまたは縮小されます。部分的なコピーをサポートしています。ソースカラースペースは" " ``None`` であってもかまいません。" #: ../../pixmap.rst:115 682ea20bf52b4efe901eaeac97e98829 msgid "desired target width." msgstr "ターゲットの幅。" #: ../../pixmap.rst:117 3bf8da6692aa4465bad88ed923353c01 msgid "desired target height." msgstr "ターゲットの高さ。" #: ../../pixmap.rst:119 7aa6286551464fc79c589f402e5f4064 msgid "restrict the resulting pixmap to this region of the **scaled** pixmap." msgstr "**スケーリングされた** ピクマップのこの領域に制限します。" #: ../../pixmap.rst:121 3be7525712a64bad8e5cc168ff57efeb msgid "" "If width or height do not *represent* integers (i.e. `value.is_integer() " "!= True`), then the resulting pixmap **will have an alpha channel**." msgstr "" "幅または高さが整数を *表していない* 場合（つまり、`value.is_integer() != True` の場合）、結果のピクマップには " "**アルファチャンネルが含まれます** 。" #: ../../pixmap.rst:125 fcd3877dc9924a5098cb10a1fec25153 msgid "" "**Copy and add or drop alpha:** Copy *source* and add or drop its alpha " "channel. Identical copy if *alpha* equals *source.alpha*. If an alpha " "channel is added, its values will be set to 255." msgstr "" "**コピーしてアルファの追加または削除：** *ソース* をコピーし、そのアルファチャンネルを追加または削除します。*alpha* が " "*source.alpha* と等しい場合、同一のコピーになります。アルファチャンネルが追加される場合、その値は255に設定されます。" #: ../../pixmap.rst:127 ../../pixmap.rst:305 29341e581eda460c9963b056957f0057 #: 6755e67f1ebd4c6397a96a8387727fc0 msgid "source pixmap." msgstr "ソースのピクマップ。" #: ../../pixmap.rst:130 c616e3541c6f481680da4d95d038b5f5 msgid "" "whether the target will have an alpha channel, default and mandatory if " "source colorspace is ``None``." msgstr "対象にアルファチャンネルがあるかどうか、デフォルトで、ソースのcolorspaceが ``None`` の場合は必須です。" #: ../../pixmap.rst:132 df4cef61a1c149a39965a6f332bf9f2c msgid "" "A typical use includes separation of color and transparency bytes in " "separate pixmaps. Some applications require this like e.g. " "*wx.Bitmap.FromBufferAndAlpha()* of *wxPython*:" msgstr "" "典型的な使用例には、カラーと透明バイトを別々のピクマップに分離することが含まれます。一部のアプリケーションでは、*wxPython* の " "*wx.Bitmap.FromBufferAndAlpha()* など、これが必要です。" #: ../../pixmap.rst:142 154d69621fb94872a7ad34eae19ef7aa msgid "" "**From a file:** Create a pixmap from *filename*. All properties are " "inferred from the input. The origin of the resulting pixmap is *(0, 0)*." msgstr "" "**ファイルから:** ファイル名から pixmap を作成します。すべてのプロパティは入力から推測されます。生成される pixmap の原点は " "*(0, 0)* です。" #: ../../pixmap.rst:144 aedb335cf31242c6807afec841343b05 msgid "Path of the image file." msgstr "画像ファイルのパス。" #: ../../pixmap.rst:148 e21d860e62cb466b8dcd5c58ecd8816a msgid "" "**From memory:** Create a pixmap from a memory area. All properties are " "inferred from the input. The origin of the resulting pixmap is *(0, 0)*." msgstr "" "**メモリから:** メモリ領域から pixmap を作成します。すべてのプロパティは入力から推測されます。生成される pixmap の原点は " "*(0, 0)* です。" #: ../../pixmap.rst:150 74221d3aec5f41afae36e2b37ac8dfc7 msgid "" "Data containing a complete, valid image. Could have been created by e.g. " "*stream = bytearray(open('image.file', 'rb').read())*. Type *bytes* is " "supported in **Python 3 only**, because *bytes == str* in Python 2 and " "the method will interpret the stream as a filename. *Changed in version " "1.14.13:* *io.BytesIO* is now also supported." msgstr "" #: ../../pixmap.rst:150 e9ed395c0d8c4b56a458e072bbd347e0 msgid "" "Data containing a complete, valid image. Could have been created by e.g. " "*stream = bytearray(open('image.file', 'rb').read())*. Type *bytes* is " "supported in **Python 3 only**, because *bytes == str* in Python 2 and " "the method will interpret the stream as a filename." msgstr "" "完全で有効な画像を含むデータ。例えば、*stream = bytearray(open('image.file', 'rb').read())* " "などで作成できます。Python 2 では *bytes* はサポートされていないため、**Python 3 のみ** " "対応しています。なぜなら、Python 2 では *bytes == str* " "となり、このメソッドはストリームをファイル名と解釈する可能性があるからです。" #: ../../pixmap.rst:152 a162db2d5e5f46a092952a708f6e5469 msgid "*Changed in version 1.14.13:* *io.BytesIO* is now also supported." msgstr "*バージョン 1.14.13 で変更:* *io.BytesIO* もサポートされるようになりました。" #: ../../pixmap.rst:157 016950d3c686415a993d228b20deed87 msgid "" "**From plain pixels:** Create a pixmap from *samples*. Each pixel must be" " represented by a number of bytes as controlled by the *colorspace* and " "*alpha* parameters. The origin of the resulting pixmap is *(0, 0)*. This " "method is useful when raw image data are provided by some other program " "-- see :ref:`FAQ`." msgstr "" "**生のピクセルから:** *サンプル* から pixmap を作成します。各ピクセルは、*カラースペース* と *alpha* " "パラメーターによって制御されるバイト数で表現される必要があります。生成される pixmap の原点は *(0, 0)* " "です。このメソッドは、他のプログラムによって生の画像データが提供される場合に有用です - :ref:`FAQ` を参照してください。" #: ../../pixmap.rst:159 cda1965dbe524b2f958354d3bf86203d msgid "Colorspace of image." msgstr "画像のカラースペース。" #: ../../pixmap.rst:162 e4ca43e6639b433195a95bc4b9cff17c msgid "image width" msgstr "画像の幅" #: ../../pixmap.rst:164 e6bd73524bf443928467e7d153097052 msgid "image height" msgstr "画像の高さ" #: ../../pixmap.rst:166 bc04c5ee0a2f4c219321973a46ca1fec msgid "" "an area containing all pixels of the image. Must include alpha values if " "specified. *Changed in version 1.14.13:* (1) *io.BytesIO* can now also " "be used. (2) Data are now **copied** to the pixmap, so may safely be " "deleted or become unavailable." msgstr "" #: ../../pixmap.rst:166 882216b59426469ebf0fc58e1a590a22 msgid "" "an area containing all pixels of the image. Must include alpha values if " "specified." msgstr "画像のすべてのピクセルを含む領域。指定されている場合はアルファ値を含める必要があります。" #: ../../pixmap.rst:168 94da32783c284a7c9e5cd26b1aa7aead msgid "" "*Changed in version 1.14.13:* (1) *io.BytesIO* can now also be used. (2) " "Data are now **copied** to the pixmap, so may safely be deleted or become" " unavailable." msgstr "" "*バージョン 1.14.13 で変更:* (1) *io.BytesIO* も使用できるようになりました。 (2) データは pixmap に " "**コピーされる** ようになり、安全に削除または利用不可能になります。" #: ../../pixmap.rst:170 92e53d092aa1464db50b36eb7899219d msgid "whether a transparency channel is included." msgstr "透明チャネルを含めるかどうか。" #: ../../pixmap.rst:174 d35de668e91d424ebf94418d892dcbd6 msgid "" "The following equation **must be true**: *(colorspace.n + alpha) * width " "* height == len(samples)*." msgstr "" "以下の式が **成り立つ必要があります** : *(colorspace.n + alpha) * width * height == " "len(samples)*。" #: ../../pixmap.rst:175 1c597631a5304c869da76bb9d81e6ed9 msgid "" "Starting with version 1.14.13, the samples data are **copied** to the " "pixmap." msgstr "バージョン 1.14.13 以降、サンプルデータは pixmap に **コピーされます** 。" #: ../../pixmap.rst:180 5c8af01ebb9141c4b8de801dd3f3356e msgid "" "**From a PDF image:** Create a pixmap from an image **contained in PDF** " "*doc* identified by its :data:`xref`. All pimap properties are set by the" " image. Have a look at `extract-img1.py " "`_ " "and `extract-img2.py `_ to see how this can be used to recover all of a PDF's" " images." msgstr "" "**PDFイメージから：** PDFドキュメント内の :data:`xref` " "で識別されるイメージからピクスマップを作成します。ピクスマップのすべてのプロパティはイメージによって設定されます。これがどのように使用されるかを確認するには" "、`extract-img1.py `_ と `extract-img2.py " "`_ " "をご覧ください。これにより、PDFのすべてのイメージを復元できます。" #: ../../pixmap.rst:182 83027e8baba3428f9138b9272d50b7c5 msgid "an opened |PDF| document." msgstr "開かれた |PDF| ドキュメント。" #: ../../pixmap.rst:185 1d115e0cbe8d45c1a12b21ba961b218c msgid "" "the :data:`xref` of an image object. For example, you can make a list of " "images used on a particular page with :meth:`Document.get_page_images`, " "which also shows the :data:`xref` numbers of each image." msgstr "" "画像オブジェクトの :data:`xref`。たとえば、:meth:`Document.get_page_images` " "を使用して特定のページで使用されるすべてのイメージのリストを作成し、各イメージの :data:`xref` 番号も表示できます。" #: ../../pixmap.rst:189 af2a4e8f44da46f9b6b2a58073bb2cfc msgid "Initialize the samples area." msgstr "サンプル領域を初期化します。" #: ../../pixmap.rst:191 e9fa66fe4f434c59baeea5e2c721a40d msgid "" "if specified, values from 0 to 255 are valid. Each color byte of each " "pixel will be set to this value, while alpha will be set to 255 (non-" "transparent) if present. If omitted, then all bytes (including any alpha)" " are cleared to *0x00*." msgstr "" "指定された場合、0から255の値が有効です。各ピクセルの各カラーバイトはこの値に設定され、存在する場合はアルファが255（非透明）に設定されます。省略された場合、すべてのバイト（アルファを含む）が" " *0x00* にクリアされます。" #: ../../pixmap.rst:193 bb47605a216946dba119a8bf60a6dcdd msgid "" "the area to be cleared. Omit to clear the whole pixmap. Can only be " "specified, if *value* is also specified." msgstr "クリアする領域。ピクスマップ全体をクリアするには省略します。*value* も指定されている場合のみ指定できます。" #: ../../pixmap.rst:197 78bf5b67f38f46178532a1e37e7ddd72 msgid "" "Colorize a pixmap by replacing black and / or white with colors given as " "**sRGB integer** values. Only colorspaces :data:`CS_GRAY` and " ":data:`CS_RGB` are supported, others are ignored with a warning." msgstr "" "ピクスマップを色付けして、黒と/または白を **sRGB整数値** として指定された色で置き換えます。:data:`CS_GRAY` と " ":data:`CS_RGB` のカラースペースのみサポートされており、他のカラースペースは警告付きで無視されます。" #: ../../pixmap.rst:199 abae57d0723b4345a89b12f880d933fa msgid "" "If the colorspace is :data:`CS_GRAY`, the average *(red + green + " "blue)/3* will be taken. The pixmap will be changed in place." msgstr "カラースペースが :data:`CS_GRAY` の場合、平均（赤+緑+青）/3が取得されます。ピクスマップはその場で変更されます。" #: ../../pixmap.rst:201 04577dadbfbc43a3abbe3d997f6561ab msgid "replace black with this value. Specifying 0x000000 makes no changes." msgstr "黒をこの値で置き換えます。0x000000を指定しても変更はありません。" #: ../../pixmap.rst:202 43f498ae78e443a28b06bdcc72789414 msgid "replace white with this value. Specifying 0xFFFFFF makes no changes." msgstr "白をこの値で置き換えます。0xFFFFFFを指定しても変更はありません。" #: ../../pixmap.rst:204 391411e29bc24c0183271fc962fc85ae msgid "Examples:" msgstr "例：" #: ../../pixmap.rst:206 6e89c521384c4c5bbc9619d3efe8b909 msgid "`tint_with(0x000000, 0xFFFFFF)` is a no-op." msgstr "`tint_with(0x000000, 0xFFFFFF)` は操作なしです。" #: ../../pixmap.rst:207 64e6d46367ef4feca63cb7fb163d6b63 msgid "" "`tint_with(0x00FF00, 0xFFFFFF)` changes black to green, leaves white " "intact." msgstr "`tint_with(0x00FF00, 0xFFFFFF)` は黒を緑に変更し、白はそのままです。" #: ../../pixmap.rst:208 8ea3f30122264c92b50ec935ec42fc3c msgid "`tint_with(0xFF0000, 0x0000FF)` changes black to red and white to blue." msgstr "`tint_with(0xFF0000, 0x0000FF)` は黒を赤に変更し、白を青に変更します。" #: ../../pixmap.rst:213 ca2f9c12e08649b5870ae3ad64eacd72 msgid "" "Apply a gamma factor to a pixmap, i.e. lighten or darken it. Pixmaps with" " colorspace ``None`` are ignored with a warning." msgstr "ピクセルマップにガンマ係数を適用し、つまり明るくしたり暗くしたりします。色空間が ``None`` のピクセルマップは警告とともに無視されます。" #: ../../pixmap.rst:215 f4c36ad3313f4088882a49b8ff1847ec msgid "" "*gamma = 1.0* does nothing, *gamma < 1.0* lightens, *gamma > 1.0* darkens" " the image." msgstr "*gamma = 1.0* は何も行いません。*gamma < 1.0* は明るくし、*gamma > 1.0* は暗くします。" #: ../../pixmap.rst:219 8543630bd8134fbfbad3e241950d6cea #, fuzzy msgid "" "Shrink the pixmap by dividing both, its width and height by 2\\ " ":sup:``n``." msgstr "Pixmapを2の :sup:`n` 乗で縮小します。" #: ../../pixmap.rst:221 30c7f5ad783249949e9748a49eb7d9f9 msgid "" "determines the new pixmap (samples) size. For example, a value of 2 " "divides width and height by 4 and thus results in a size of one 16\\ " ":sup:`th` of the original. Values less than 1 are ignored with a warning." msgstr "新しいPixmap（サンプル）のサイズを決定します。例えば、値が2の場合、幅と高さを4分の1に分割し、元のサイズの16分の1のサイズになります。1未満の値は警告として無視されます。" #: ../../pixmap.rst:223 f45f17093df4420cb6fbc619648afd22 msgid "" "Use this methods to reduce a pixmap's size retaining its proportion. The " "pixmap is changed \"in place\". If you want to keep original and also " "have more granular choices, use the resp. copy constructor above." msgstr "これを使用して比を保持したままPixmapのサイズを縮小します。Pixmapは「その場で」変更されます。元のピクセルを保持し、より詳細な選択肢を持つ場合は、上記のコピーコンストラクタを使用してください。" #: ../../pixmap.rst:227 1455e6653c744eeba403a49f543d6fab msgid "" "*New in version:: 1.14.5:* Return the value of the pixel at location (x, " "y) (column, line)." msgstr "*バージョン1.14.5* で新規追加：位置（x、y）（列、行）のピクセルの値を返します。" #: ../../pixmap.rst:229 ../../pixmap.rst:239 4665e9dd65654240abe6ee77bae37183 #: ffb7d135ed9a41f1b4f0bfa146d6de82 msgid "the column number of the pixel. Must be in `range(pix.width)`." msgstr "ピクセルの列番号。範囲 `range(pix.width)` 内である必要があります。" #: ../../pixmap.rst:230 f1efa4c149644cc680d5348ad2c2e068 msgid "the line number of the pixel, Must be in `range(pix.height)`." msgstr "ピクセルの行番号、範囲 `range(pix.height)` 内である必要があります。" #: ../../pixmap.rst 369baee8d7234ef2ab7f82e75e9111ad #: a81a4cbd70ad4e0b8fb189a247cfcaaf b3a66cf736f24daea703147e167c320f #: cc865d958a3d4c81b2cbd3d3f814714b d2546977b027475993b2df887c1cb6e8 #: e81aa1c04aa6419da09b400752672904 eb0378b2f08a49a0af740a769d1a6087 msgid "Return type" msgstr "" #: ../../pixmap.rst 186871c10cae496984d33e4181c189b0 #: 24ba23b408644b24bd9aa5c5c7695c13 375a4a43a898465fa252490979e2f154 #: 44939b8c082c4f128aecb10f802bce36 8183d07de46a4c909fc8ff25a1c13b5e #: 82dd9565faa544cf8799ce6981d78e02 a7c02e0b9035405a9f75f61d1ef8a011 msgid "Returns" msgstr "" #: ../../pixmap.rst:233 1c117c2f7320435ab28104a0c9e6b3f0 msgid "" "a list of color values and, potentially the alpha value. Its length and " "content depend on the pixmap's colorspace and the presence of an alpha. " "For RGBA pixmaps the result would e.g. be *[r, g, b, a]*. All items are " "integers in `range(256)`." msgstr "" "色の値と、必要に応じてアルファ値のリスト。その長さと内容は、Pixmap " "の色空間とアルファの存在に依存します。RGBAピクセルマップの場合、結果は例えば *[r、g、b、a]* となります。すべてのアイテムは " "`range(256)` の整数です。" #: ../../pixmap.rst:237 4e3d50e363f54e7da5ab00f4aa58fec5 msgid "" "*New in version 1.14.7:* Manipulate the pixel at location (x, y) (column," " line)." msgstr "*バージョン1.14.7で新規追加：* 位置（x、y）（列、行）のピクセルを操作します。" #: ../../pixmap.rst:240 0dcca10c1c4c4b58b61746cd5da73f43 msgid "the line number of the pixel. Must be in `range(pix.height)`." msgstr "ピクセルの行番号、`range(pix.height)` 内である必要があります。" #: ../../pixmap.rst:241 eee0a54112754d7db4a0e21facaf19c8 msgid "" "the desired pixel value given as a sequence of integers in `range(256)`. " "The length of the sequence must equal :attr:`Pixmap.n`, which includes " "any alpha byte." msgstr "" "`range(256)` の整数で表されるシーケンスとして指定された所望のピクセル値。シーケンスの長さは :attr:`Pixmap.n` " "に等しくなければならず、これにはアルファバイトも含まれます。" #: ../../pixmap.rst:245 223fcf7f54984d26a1a64657ed00a81d msgid "*New in version 1.14.8:* Set the pixels of a rectangle to a value." msgstr "*新しいバージョン1.14.8で導入されました：* 特定の値で長方形のピクセルを設定します。" #: ../../pixmap.rst:247 95d0f97710ba444391fd993ca732bc02 msgid "" "the rectangle to be filled with the value. The actual area is the " "intersection of this parameter and :attr:`Pixmap.irect`. For an empty " "intersection (or an invalid parameter), no change will happen." msgstr "" "値で埋める長方形。実際のエリアはこのパラメータと :attr:`Pixmap.irect` " "の交差です。空の交差（または無効なパラメータ）の場合、変更は行われません。" #: ../../pixmap.rst:248 a8fe7a3cf13a40e6a5abc4a65a481906 msgid "" "the desired value, given as a sequence of integers in `range(256)`. The " "length of the sequence must equal :attr:`Pixmap.n`, which includes any " "alpha byte." msgstr "" "`range(256)` 内の整数のシーケンスとして指定された所望の値。シーケンスの長さは :attr:`Pixmap.n` " "と等しくなければならず、これにはアルファバイトも含まれます。" #: ../../pixmap.rst:251 ef594268cf964435b0f7fae7229908c8 msgid "" "``False`` if the rectangle was invalid or had an empty intersection with " ":attr:`Pixmap.irect`, else ``True``." msgstr "irectが無効であるか、:attr:`Pixmap.irect` と交差しない場合は ``False``、それ以外の場合は ``True`` 。" #: ../../pixmap.rst:255 bcf6532518a34f9c87fe6473f29b283c msgid "" "This method is equivalent to :meth:`Pixmap.set_pixel` executed for each " "pixel in the rectangle, but is obviously **very much faster** if many " "pixels are involved." msgstr "" "このメソッドは、多くのピクセルが関与する場合に **非常に高速** であるため、長方形内の各ピクセルに対して実行される " ":meth:`Pixmap.set_pixel` と同等です。" #: ../../pixmap.rst:256 bc5f1b513a0f4c4fa649296505adae7c msgid "" "This method can be used similar to :meth:`Pixmap.clear_with` to " "initialize a pixmap with a certain color like this: " "*pix.set_rect(pix.irect, (255, 255, 0))* (RGB example, colors the " "complete pixmap with yellow)." msgstr "" "このメソッドは、:meth:`Pixmap.clear_with` " "のように、次のようにして特定の色でピクセルマップを初期化するために使用できます。 *pix.set_rect(pix.irect, (255, " "255, 0))* （RGBの例、ピクセルマップ全体を黄色で色付けします）。" #: ../../pixmap.rst:260 a513c003abe849829c11fe1447ebad4c msgid "New in v1.17.7" msgstr "v1.17.7で新規導入" #: ../../pixmap.rst:262 0b7cc0a788dd40cb8acfbdb60fc95d01 msgid "Set the x and y values of the pixmap's top-left point." msgstr "ピクセルマップの左上の点のxとyの値を設定します。" #: ../../pixmap.rst:264 235e6e23b0b24739bc80e81e21526714 msgid "x coordinate" msgstr "x座標" #: ../../pixmap.rst:265 6abac422a54b4e5bb66a4859637f5a69 msgid "y coordinate" msgstr "y座標" #: ../../pixmap.rst:270 c5527c1032f044a2a640143d01653c61 msgid "New in v1.16.17" msgstr "v1.16.17で新規導入." #: ../../pixmap.rst:272 f49f9e8464474d7cbf7a85f1ba506a82 msgid "" "Changed in v1.18.0: When saving as a PNG image, these values will be " "stored now." msgstr "v1.18.0で変更：PNGイメージとして保存する場合、これらの値が保存されるようになりました。" #: ../../pixmap.rst:274 a468673bcf8b49a68b788fd8ae23b5d5 msgid "Set the resolution (dpi) in x and y direction." msgstr "xおよびy方向の解像度（dpi）を設定します。" #: ../../pixmap.rst:276 0ac91572ffc64e2bba64b0279d3fc7a3 msgid "resolution in x direction." msgstr "x方向の解像度。" #: ../../pixmap.rst:277 1eb356ec57454ca9815ab72ead63956f msgid "resolution in y direction." msgstr "y方向の解像度。" #: ../../pixmap.rst:282 8623995d2c004b0ba2caf470042846f1 msgid "Changed in v 1.18.13" msgstr "変更内容：v1.18.13で変更" #: ../../pixmap.rst:284 82d487067f8d4ced9ef11d081f5e4ce8 msgid "Change the alpha values. The pixmap must have an alpha channel." msgstr "アルファ値を変更します。ピクマップにはアルファチャンネルが必要です。" #: ../../pixmap.rst:286 c98fe169c19c487481ca55cd0633f3f8 msgid "" "the new alpha values. If provided, its length must be at least *width * " "height*. If omitted (`None`), all alpha values are set to 255 (no " "transparency). *Changed in version 1.14.13:* *io.BytesIO* is now also " "accepted." msgstr "" "新しいアルファ値。指定された場合、その長さは少なくとも *幅×高* " "さでなければなりません。省略した場合（`None`）、すべてのアルファ値が255（透明でない）に設定されます。*バージョン1.14.13で変更：*" " *io.BytesIO* も受け入れられるようになりました。" #: ../../pixmap.rst:287 e94c3d6b68c141e2b61b6f54ab717d33 msgid "" "*New in v1.18.13:* whether to premultiply color components with the alpha" " value." msgstr "*v1.18.13で新登場：* カラーコンポーネントをアルファ値と乗算するかどうか。" #: ../../pixmap.rst:288 fbe9e806927d460389c858b14d4f3644 msgid "" "ignore the alpha value and set this color to fully transparent. A " "sequence of integers in `range(256)` with a length of :attr:`Pixmap.n`. " "Default is ``None``. For example, a typical choice for RGB would be " "`opaque=(255, 255, 255)` (white)." msgstr "" "アルファ値を無視し、この色を完全に透明に設定します。長さが :attr:`Pixmap.n` で `range(256)` " "内の整数のシーケンスです。デフォルトは ``None`` です。たとえば、RGBの典型的な選択肢は `opaque=(255, 255, " "255)` （白）です。" #: ../../pixmap.rst:293 e617ef83731c4689a35511a90c29ceeb msgid "" "Invert the color of all pixels in :ref:`IRect` *irect*. Will have no " "effect if colorspace is ``None``." msgstr "" ":ref:`IRect` *irect* 内のすべてのピクセルの色を反転させます。colorspaceが ``None`` " "の場合は効果がありません。" #: ../../pixmap.rst:295 b9d38a022bef44f89d241d1964237fbb msgid "The area to be inverted. Omit to invert everything." msgstr "反転する領域。すべて反転するには省略します。" #: ../../pixmap.rst:299 e764fb3df0324f5187dbb68ba9a917ba msgid "" "Copy the *irect* part of the *source* pixmap into the corresponding area " "of this one. The two pixmaps may have different dimensions and can each " "have :data:`CS_GRAY` or :data:`CS_RGB` colorspaces, but they currently " "**must** have the same alpha property [#f2]_. The copy mechanism " "automatically adjusts discrepancies between source and target like so:" msgstr "" "*ソース* ピクマップの *irect* " "部分を、このピクマップの対応する領域にコピーします。2つのピクマップは異なる寸法を持つことができ、それぞれが :data:`CS_GRAY` " "または :data:`CS_RGB` カラースペースを持つことができますが、現在は同じアルファプロパティ [#f2]_ " "を持っている必要があります。コピー機構は、次のようにソースとターゲットの間の不一致を自動的に調整します。" #: ../../pixmap.rst:301 e270f22850b84663930783d1f33ca33c msgid "" "If copying from :data:`CS_GRAY` to :data:`CS_RGB`, the source gray-shade " "value will be put into each of the three rgb component bytes. If the " "other way round, *(r + g + b) / 3* will be taken as the gray-shade value " "of the target." msgstr "" ":data:`CS_GRAY` から :data:`CS_RGB` " "にコピーする場合、ソースのグレーシェード値は、3つのRGBコンポーネントバイトの各々に配置されます。逆の場合、*（r + g + b）/ 3* " "がターゲットのグレーシェード値として取られます。" #: ../../pixmap.rst:303 e29fc4caf130461db1843ba16fe4fc72 msgid "" "Between *irect* and the target pixmap's rectangle, an \"intersection\" is" " calculated at first. This takes into account the rectangle coordinates " "and the current attribute values :attr:`Pixmap.x` and :attr:`Pixmap.y` " "(which you are free to modify for this purpose via " ":meth:`Pixmap.set_origin`). Then the corresponding data of this " "intersection are copied. If the intersection is empty, nothing will " "happen." msgstr "" "*irect* とターゲットピクマップの長方形の間で、まず「交差」を計算します。これは、長方形の座標と現在の属性値 " ":attr:`Pixmap.x` および :attr:`Pixmap.y` （これを目的のために " ":meth:`Pixmap.set_origin` " "を介して自由に変更できます）を考慮に入れます。その後、この交差のデータがコピーされます。交差が空の場合、何も起こりません。" #: ../../pixmap.rst:308 fb1b535c8adc44baa4c729c25fec3e14 msgid "The area to be copied." msgstr "コピーする領域。" #: ../../pixmap.rst:310 82448c014aa543b68e66cec1b07f3d96 msgid "" "Example: Suppose you have two pixmaps, `pix1` and `pix2` and you want to " "copy the lower right quarter of `pix2` to `pix1` such that it starts at " "the top-left point of `pix1`. Use the following snippet::" msgstr "" "例： `pix1` と `pix2` という2つのピクマップがあるとし、`pix2` の右下の四半期を `pix1` にコピーし、それが " "`pix1` の左上の点から開始するようにしたい場合、次のスニペットを使用します::" #: ../../pixmap.rst:329 7fbfff308f9d4627a4a6f2fc60e1651e msgid "" "Changed in v1.22.0: Added **direct support of JPEG** images. Image " "quality can be controlled via parameter \"jpg_quality\"." msgstr "v1.22.0で変更：**JPEG画像の直接サポート** が追加されました。画像の品質は「jpg_quality」パラメータを使用して制御できます。" #: ../../pixmap.rst:331 97bd54f9e597471292898030e2002c7a msgid "" "Save pixmap as an image file. Depending on the output chosen, only some " "or all colorspaces are supported and different file extensions can be " "chosen. Please see the table below." msgstr "Pixmapを画像ファイルとして保存します。選択した出力に応じて、一部またはすべてのカラースペースがサポートされ、異なるファイル拡張子を選択できます。詳細については以下の表をご覧ください。" #: ../../pixmap.rst:333 9cbb39acd6fd43c7b4231f63399b34d8 msgid "" "The file to save to. May be provided as a string, as a ``pathlib.Path`` " "or as a Python file object. In the latter two cases, the filename is " "taken from the resp. object. The filename's extension determines the " "image format, which can be overruled by the output parameter." msgstr "" "保存先のファイル。文字列、``pathlib.Path`` " "、またはPythonファイルオブジェクトとして提供できます。後の2つの場合、ファイル名は対応するオブジェクトから取得されます。ファイル名の拡張子は画像フォーマットを決定し、出力パラメータで上書きできます。" #: ../../pixmap.rst:335 a8f9fb30eb6f4e129ccdb1eb4dfb2d50 msgid "" "The desired image format. The default is the filename's extension. If " "both, this value and the file extension are unsupported, an exception is " "raised. For possible values see :ref:`PixmapOutput`." msgstr "" "望ましい画像フォーマット。デフォルトはファイル名の拡張子です。この値とファイル拡張子の両方がサポートされていない場合、例外が発生します。:ref:`PixmapOutput`" " を参照してください。" #: ../../pixmap.rst:336 ../../pixmap.rst:346 57c5e89d61b643828893b09c1506e81c #: a4031bcffabf4809bb9b3450054f39ec msgid "" "The desired image quality, default 95. Only applies to JPEG images, else " "ignored. This parameter trades quality against file size. A value of 98 " "is close to lossless. Higher values should not lead to better quality." msgstr "望ましい画像品質、デフォルトは95です。JPEG画像にのみ適用され、それ以外の場合は無視されます。このパラメータは品質とファイルサイズをトレードオフにします。値が98の場合、ほぼロスレスです。より高い値は品質を向上させることはありません。" #: ../../pixmap.rst 31830ae4676c49a29f6eda0ec74b2cc7 #: 35f861d76f76416f84ca4a6cfbb9ba36 9e7d20d2ebff48a5a2f12a7bb9cb207f #: 9e8d92287683474c8894ca359bc0df3c eaa3f51d3c63445d921c804b8d264fba msgid "Raises" msgstr "例外" #: ../../pixmap.rst:338 ../../pixmap.rst:348 74c8c07d5a4d429180ebc61a6dc88b40 #: 888fc652cefb483cbc631acba45b2a8c msgid "For unsupported image formats." msgstr "サポートされていない画像フォーマットの場合。" #: ../../pixmap.rst:342 3e89ee831b4744b2a7778a6f2ab7d705 msgid "" "New in version 1.14.5: Return the pixmap as a *bytes* memory object of " "the specified format -- similar to :meth:`save`." msgstr "" "新機能（バージョン1.14.5）：指定されたフォーマットのピクマップをバイトメモリオブジェクトとして返します。これは :meth:`save` " "と似ています。" #: ../../pixmap.rst:343 4dff4d1183ff44f2a456ec123ddad67f msgid "" "Changed in v1.22.0: Added **direct JPEG support**. Image quality can be " "influenced via new parameter \"jpg_quality\"." msgstr "" "v1.22.0で変更： **JPEG画像の直接サポート** " "が追加されました。画像の品質は「jpg_quality」パラメータを使用して制御できます。" #: ../../pixmap.rst:345 17d9ad6bf1cd4d0caaf174d46a29b286 msgid "" "The desired image format. The default is \"png\". For possible values see" " :ref:`PixmapOutput`." msgstr "望ましい画像フォーマット。デフォルトは \"png\" です。:ref:`PixmapOutput` を参照してください。" #: ../../pixmap.rst:351 7a4a3392440c413b9549ddfd80aa09e8 msgid "" "The requested image format. The default is \"png\". For other possible " "values see :ref:`PixmapOutput`." msgstr "リクエストされた画像フォーマットです。デフォルトは \"png\" です。:ref:`PixmapOutput` を参照してください。" #: ../../pixmap.rst:355 ../../pixmap.rst:370 024249ef113f468bba659314559663a8 #: 3ebc661e655c4894a0780bd40d34f1b9 msgid "New in v1.19.0" msgstr "v1.19.0 で新規追加" #: ../../pixmap.rst:357 ../../pixmap.rst:372 98399e67142a4ab4bfa0146bb6a938e0 #: fde150994fb44c0dac805e2d7807ae53 msgid "Changed in v1.22.5: Support of new parameter for Tesseract's tessdata." msgstr "v1.22.5 で変更：Tesseract の tessdata に関する新しいパラメータのサポート。" #: ../../pixmap.rst:359 7e216757569f4c4ebb1b9d88f2858c00 msgid "" "Perform text recognition using Tesseract and save the image as a 1-page " "PDF with an OCR text layer." msgstr "Tesseract を使用してテキスト認識を実行し、OCR テキスト レイヤーを持つ 1 ページの PDF として画像を保存します。" #: ../../pixmap.rst:361 9e480852cca4498d8cb34f674e078760 msgid "" "identifies the file to save to. May be either a string or a pointer to a " "file opened with \"wb\" (includes `io.BytesIO()` objects)." msgstr "" "保存先のファイルを識別します。文字列または \"wb\" で開かれたファイルへのポインタ (`io.BytesIO()` " "オブジェクトを含む）のいずれかである必要があります。" #: ../../pixmap.rst:362 739251505f694c69af4730ee2d8f7848 msgid "whether to compress the resulting PDF, default is `True`." msgstr "結果の PDF を圧縮するかどうか。デフォルトは `True` です。" #: ../../pixmap.rst:363 8c1c54fe56a34bf19f07465936ed9f10 msgid "" "the languages occurring in the image. This must be specified in Tesseract" " format. Default is \"eng\" for English. Use \"+\"-separated Tesseract " "language codes for multiple languages, like \"eng+spa\" for English and " "Spanish." msgstr "" "画像内で使用される言語。Tesseract の形式で指定する必要があります。デフォルトは " "\"eng\"（英語）です。複数の言語を使用する場合、\"eng+spa\" のように \"+\" で区切った Tesseract " "言語コードを使用します（英語とスペイン語の場合など）。" #: ../../pixmap.rst:364 fcca47fa76a9459cbec299e7f148dec6 #, fuzzy msgid "" "folder name of Tesseract's language support. If omitted, this information" " must be present as environment variable `TESSDATA_PREFIX`." msgstr "" ":arg str tessdata: Tesseractの言語サポートフォルダーの名前です。省略した場合、この情報は環境変数 " "`TESSDATA_PREFIX` として存在している必要があります。" #: ../../pixmap.rst:366 21a4cf67602b4076b49b985e8aa0c66b msgid "" "**Will fail** if Tesseract is not installed or if the environment " "variable \"TESSDATA_PREFIX\" is not set to the `tessdata` folder name and" " not provided as parameter." msgstr "" "Tesseract がインストールされていない場合や、環境変数 \"TESSDATA_PREFIX\" が `tessdata` " "フォルダ名に設定されておらず、またはパラメータとして提供されていない場合、この関数は **失敗します** 。" #: ../../pixmap.rst:374 32b8acd13d9f48e1bfd79ab1023be929 msgid "" "Perform text recognition using Tesseract and convert the image to a " "1-page PDF with an OCR text layer. Internally invokes " ":meth:`Pixmap.pdfocr_save`." msgstr "" "Tesseractを使用してテキスト認識を実行し、画像をOCRテキストレイヤーを持つ1ページのPDFに変換します。内部的には " ":meth:`Pixmap.pdfocr_save` を呼び出します" #: ../../pixmap.rst:376 9e005bf6ab3440c085ee1193ba601f87 msgid "" "A 1-page PDF file in memory. Could be opened like " "`doc=pymupdf.open(\"pdf\", pix.pdfocr_tobytes())`, and text extractions " "could be performed on its `page=doc[0]`. .. note:: Another possible " "use is insertion into some pdf. The following snippet reads the images of" " a folder and stores them as pages in a new PDF that contain an OCR text " "layer:: doc = pymupdf.open() for imgfile in " "os.listdir(folder): pix = pymupdf.Pixmap(imgfile) " "imgpdf = pymupdf.open(\"pdf\", pix.pdfocr_tobytes()) " "doc.insert_pdf(imgpdf) pix = None imgpdf.close() " "doc.save(\"ocr-images.pdf\")" msgstr "" #: ../../pixmap.rst:376 b412ebf7d201478890ec75b641a17871 msgid "" "A 1-page PDF file in memory. Could be opened like " "`doc=pymupdf.open(\"pdf\", pix.pdfocr_tobytes())`, and text extractions " "could be performed on its `page=doc[0]`." msgstr "" "メモリ内の1ページのPDFファイル。次のようにして開くことができます： `doc=pymupdf.open(\"pdf\", " "pix.pdfocr_tobytes())` 、そしてそのページ=doc[0]でテキストの抽出が行えます。" #: ../../pixmap.rst:380 2cd418d767ef4149b35f4d0415d14af1 msgid "" "Another possible use is insertion into some pdf. The following snippet " "reads the images of a folder and stores them as pages in a new PDF that " "contain an OCR text layer::" msgstr "" "別の可能性として、PDF に挿入することが考えられます。次のスニペットは、フォルダ内の画像を読み取り、OCR テキスト レイヤーを含む新しい " "PDF ページとして保存します::" #: ../../pixmap.rst:394 efc06e14189c4871827c5261c0623dfa msgid "Create a Pillow Image from the pixmap. PIL / Pillow must be installed." msgstr "" #: ../../pixmap.rst:396 ../../pixmap.rst:416 ../../pixmap.rst:424 #: 3df2560f6e804a789cc70c26deec880b 8087c1edcca942f186efe9ad6be77c16 #: 85c874d70f274112a51bc6ce56e6e197 msgid "if Pillow is not installed." msgstr "Pillow がインストールされていない場合" #: ../../pixmap.rst:397 69708896f8e44f9eb5a130326ae36b80 msgid "a ``PIL.Image`` object" msgstr "" #: ../../pixmap.rst:401 3f77a2ee05134b31a570bc40ff704b87 msgid "" "Write the pixmap as an image file using Pillow. Use this method for " "output unsupported by MuPDF. Examples are" msgstr "" "Pillow を使用して pixmap を画像ファイルとして書き込みます。これは MuPDF " "でサポートされていない出力に使用します。例として、以下が挙げられます。" #: ../../pixmap.rst:403 8f8925fd0a1e4868840945ccf3b35017 msgid "Formats JPX, J2K, WebP, etc." msgstr "JPX、J2K、WebP などの形式" #: ../../pixmap.rst:404 bd17d3e24fb740469efea4743e5ffb78 msgid "Storing EXIF information." msgstr "EXIF 情報の保存" #: ../../pixmap.rst:405 d7d0bc56bfcb4f179b7f00d2ad59c255 msgid "" "If you do not provide dpi information, the values *xres*, *yres* stored " "with the pixmap are automatically used." msgstr "dpi 情報を提供しない場合、pixmap に格納されている *xres*、*yres* の値が自動的に使用されます。" #: ../../pixmap.rst:407 20bf1e69dd5147b9a108ab328fe2657e #, fuzzy msgid "" "A simple example: `pix.pil_save(\"some.webp\", optimize=True, dpi=(150, " "150))`." msgstr "" "簡単な例: `pix.pil_save(\"some.webp\", optimize=True, dpi=(150, 150))` " "。他のパラメータの詳細については、Pillow のドキュメンテーションを参照してください。" #: ../../pixmap.rst:409 71799e7c62324bbea016ae30eafbc021 msgid "" "If the pixmap's colorspace is RGB with transparency, the alpha values may" " or may not already be multiplied into the color components " "ref/green/blue (called \"premultiplied\"). To enforce undoing " "premultiplication, set this parameter to `True`. To learn about some " "background, e.g. look for `\"Premultiplied alpha\" on this page " "`_." msgstr "" #: ../../pixmap.rst:412 c5f67c82cc1b4a078d120281dc779a59 msgid "For details on other parameters see the Pillow documentation." msgstr "" #: ../../pixmap.rst:414 d3f2fde19b034f09971604debcf8e6dc msgid "" "Since v1.22.0, PyMuPDF supports JPEG output directly. We recommended to " "no longer use this method for JPEG output -- for performance reasons and " "for avoiding unnecessary external dependencies." msgstr "" #: ../../pixmap.rst:420 835e9bbf2bc047f2b9657ca7741ec37e msgid "New in v1.17.3" msgstr "v1.17.3 で新しく追加されました" #: ../../pixmap.rst:422 d0177a551753414586749bf415cf6080 #, fuzzy msgid "" "Return an image as a bytes object in the specified format using Pillow. " "For example `stream = pix.pil_tobytes(format=\"WEBP\", optimize=True, " "dpi=(150, 150))`. Also see above. For details on other parameters see the" " Pillow documentation." msgstr "" "Pillow を使用して指定された形式の画像として bytes オブジェクトとして画像を返します。例: `stream = " "pix.pil_tobytes(format=\"WEBP\", optimize=True)` 。詳細なパラメータについては、Pillow " "のドキュメンテーションを参照してください。" #: ../../pixmap.rst:431 ../../pixmap.rst:466 68173364cda84dab84fa461435fdec56 #: b156a10f58714dae92ca5c3163c24112 msgid "New in v1.19.3" msgstr "v1.19.3 で新しく追加されました" #: ../../pixmap.rst:433 129930765e83498b8cb4362c41d7fb9a msgid "" "Return a new pixmap by \"warping\" the quad such that the quad corners " "become the new pixmap's corners. The target pixmap's `irect` will be `(0," " 0, width, height)`." msgstr "" "四角形を \"ワープ\" して、四角形の角が新しい pixmap の角になるようにします。対象 pixmap の `irect` は `(0, " "0, width, height)` になります。" #: ../../pixmap.rst:435 6c6e2bf54f6c4c1cbd3c172dbbfb7712 msgid "" "a convex quad with coordinates inside :attr:`Pixmap.irect` (including the" " border points)." msgstr ":attr:`Pixmap.irect` の内部にある座標を持つ凸四角形（境界点も含む）" #: ../../pixmap.rst:436 e9644c03761249019390c475ce09eeb9 msgid "desired resulting width." msgstr "望ましい幅" #: ../../pixmap.rst:437 5af3c5ce964244d9ac8c1210ae145777 msgid "desired resulting height." msgstr "望ましい高さ" #: ../../pixmap.rst:438 23af53d676c943ab8270f1f4eb3e15f8 msgid "" "A new pixmap where the quad corners are mapped to the pixmap corners in a" " clockwise fashion: `quad.ul -> irect.tl`, `quad.ur -> irect.tr`, etc." msgstr "" "新しいピクスマップで、四角形の角が時計回りにピクスマップの角にマップされます: `quad.ul -> irect.tl`、`quad.ur ->" " irect.tr` など。" #: ../../pixmap.rst:439 c3fb88fba3f7447889bc2174e90ed4ed msgid "" ":ref:`Pixmap` .. image:: images/img-warp.* :scale: 40 :align: " "center" msgstr "" #: ../../pixmap.rst:439 8eb4c765b10a4af0b07fe6d1cd7386d2 msgid ":ref:`Pixmap`" msgstr "" #: ../../pixmap.rst:448 ../../pixmap.rst:505 ../../pixmap.rst:514 #: 00c62e32e38c4d82895121b426757269 0149558efd01426095beb5bf88035b73 #: 5c3eedb1091c4eb1af8d1010e7f2b3f0 msgid "New in v1.19.2" msgstr "v1.19.2で導入" #: ../../pixmap.rst:449 b8fe5dd5d0294610a99db8d7ebd6deec msgid "Changed in v1.19.3" msgstr "v1.19.3で変更" #: ../../pixmap.rst:451 c2da2a6121594d6c8b3f4e6e7d643cee msgid "Determine the pixmap's unique colors and their count." msgstr "Pixmapのユニークな色とそのカウントを特定します。" #: ../../pixmap.rst:453 992445f66d104d8c89ac2f8297c8e9c4 msgid "" "*(changed in v1.19.3)* If `True` return a dictionary of color pixels and " "their usage count, else just the number of unique colors." msgstr "*（v1.19.3で変更）* `True` の場合、色ピクセルとその使用回数の辞書を返し、それ以外の場合はユニークな色の数だけを返します。" #: ../../pixmap.rst:454 db2ea4eae7a1492dad41fae7951b0160 msgid "" "a rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels " "are considered. This allows inspecting sub-rectangles of a given pixmap " "directly -- instead of building sub-pixmaps." msgstr "" ":attr:`Pixmap.irect` " "内の四角形。指定した場合、そのピクセルのみが考慮されます。これにより、指定されたPixmapのサブ四角形を直接調査できます。" #: ../../pixmap.rst:456 61a615b057024b7a9b6ac7fe5ff849ab msgid "" "either the number of colors, or a dictionary with the items `pixel: " "count`. The pixel key is a `bytes` object of length :attr:`Pixmap.n`. .." " note:: To recover the **tuple** of a pixel, use " "`tuple(colors.keys()[i])` for the i-th item. * The response time " "depends on the pixmap's samples size and may be more than a second for " "very large pixmaps. * Where applicable, pixels with different alpha " "values will be treated as different colors." msgstr "" #: ../../pixmap.rst:456 9ad0b09ff1334369af15be4f052a2f6f msgid "" "either the number of colors, or a dictionary with the items `pixel: " "count`. The pixel key is a `bytes` object of length :attr:`Pixmap.n`." msgstr "" "色の数、または `pixel: count` の項目を持つ辞書。pixelキーは :attr:`Pixmap.n` の長さの `bytes` " "オブジェクトです。" #: ../../pixmap.rst:458 d7bdc5a53abc43d6a1041953b5c0c526 msgid "" "To recover the **tuple** of a pixel, use `tuple(colors.keys()[i])` for " "the i-th item." msgstr "ピクセルのタプルを復元するには、i番目の項目に対して `tuple(colors.keys()[i])` を使用します。" #: ../../pixmap.rst:460 260f96dbe8c04ab1a25159255b8b79a7 msgid "" "The response time depends on the pixmap's samples size and may be more " "than a second for very large pixmaps." msgstr "応答時間はPixmapのsamplesサイズに依存し、非常に大きなPixmapの場合は1秒以上かかることがあります。" #: ../../pixmap.rst:461 1b987ef794b6454eb0d9366a05344070 msgid "" "Where applicable, pixels with different alpha values will be treated as " "different colors." msgstr "該当する場合、異なるアルファ値を持つピクセルは異なる色として扱われます。" #: ../../pixmap.rst:468 2b6490adea534fa6a8de4eaf1edb354a msgid "Return the most frequently used color and its relative frequency." msgstr "最も頻繁に使用される色とその相対頻度を返します。" #: ../../pixmap.rst:470 485c7c5b4da94258b242db7b59b19b53 msgid "" "A rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels " "are considered. This allows inspecting sub-rectangles of a given pixmap " "directly -- instead of building sub-pixmaps." msgstr "" ":attr:`Pixmap.irect` " "内の四角形。指定した場合、そのピクセルのみが考慮されます。これにより、指定されたPixmapのサブ四角形を直接調査できます。" #: ../../pixmap.rst:472 9110208e27134f02a9b9bcdc7700add8 #, python-format msgid "" "A tuple `(ratio, pixel)` where `0 < ratio <= 1` and *pixel* is the pixel " "value of the color. Use this to decide if the image is \"almost\" " "unicolor: a response `(0.95, b\"\\x00\\x00\\x00\")` means that 95% of all" " pixels are black. See an example here :ref:`RecipesImages_P`." msgstr "" "比率 `0 < ratio <= 1` および色のピクセル値を持つタプル。これを使用して画像が「ほぼ」単一の色であるかどうかを判断します。応答 " "`(0.95, b\"\\x00\\x00\\x00\")` " "は、すべてのピクセルの95%が黒であることを示します。こちらの例を参照してください：「Pixmapsの使用方法：テキストの可視性の確認」" #: ../../pixmap.rst:477 5e93c19118c44e4598fc55ffb9cd04f6 msgid "Indicates whether the pixmap contains transparency information." msgstr "Pixmapに透明情報が含まれているかどうかを示します。" #: ../../pixmap.rst 09340208613f48af95d9e1d2a3ef91fa #: 0cc2b878ea234bfe8d91795141e3924d 0ff51066858f4faaad58612b0fbd5896 #: 163c7d4bd8d3405ca26c2650fa5d8a10 3eb04a688a904a5eaadf5d79aed68b1a #: 4869cfa0cd314211b192a2294838c7dc 5124ac9063654c24a37926de5ab662b6 #: 557f147c6be94fe083e8082986fa08b6 5ee3e6766dd44d2582e805125e914472 #: 5f52d2e5c48c47d7aec0c2b7a743fd46 6124bd56d7524796b1aa3c3e18458232 #: 7c890834a7cf4a088780dfb0e21745a8 84cbd010ada9441a9182c12bbe62059b #: 89488e9f1e4c4e3d8c6ca9ce290016a4 8be2b06b344443289085426c1e14fa50 #: 922e0d0d08124b5081bcbb57569a2aa8 a1b9de76b34b47f9b95c7bb1563b9e5a #: d0c0191f32ed43c6a6857c305705698b ead0a6e9dc94433ba020dae746028076 msgid "type" msgstr "" #: ../../pixmap.rst:479 ../../pixmap.rst:509 ../../pixmap.rst:518 #: ../../pixmap.rst:633 3d5651d764be40cca15a078b7f2531b8 #: 694a5ede4c4c43319c089b1737fd0b9c a65782123b144e4186d43ddd5c138a97 #: cd79fe63f067476c8342570d590c3121 msgid "bool" msgstr "" #: ../../pixmap.rst:483 98d329d87318478090434465b043c79d msgid "" "The MD5 hashcode (16 bytes) of the pixmap. This is a technical value used" " for unique identifications." msgstr "PixmapのMD5ハッシュコード（16バイト）。これは一意の識別に使用される技術的な値です。" #: ../../pixmap.rst:485 ../../pixmap.rst:537 d353d95ffd0249c9985587a89eec06f3 #: fe9d2fb1853646c9bb567d4a448e58de msgid "bytes" msgstr "" #: ../../pixmap.rst:489 94c016ffd0e94ef8a92a913eac909cf0 msgid "" "The colorspace of the pixmap. This value may be ``None`` if the image is " "to be treated as a so-called *image mask* or *stencil mask* (currently " "happens for extracted PDF document images only)." msgstr "" "Pixmapのカラースペース。この値は、イメージが *イメージマスク* または *ステンシルマスク* として扱われる場合、``None`` " "になることがあります（現在、抽出されたPDFドキュメントイメージのみが該当）。" #: ../../pixmap.rst:491 b6cfc944281042b38f313e221d8208ee msgid ":ref:`Colorspace`" msgstr "" #: ../../pixmap.rst:495 6a4abc1ca4ea41e5b98e5867969d0aea msgid "" "Contains the length of one row of image data in :attr:`Pixmap.samples`. " "This is primarily used for calculation purposes. The following " "expressions are true:" msgstr ":attr:`Pixmap.samples` 内の画像データの1行の長さを含みます。これは主に計算目的で使用されます。次の式が真です：" #: ../../pixmap.rst:497 9ef5987d2b004c03a37ac85ebe94eb90 msgid "`len(samples) == height * stride`" msgstr "" #: ../../pixmap.rst:498 ad30730142bb41048a7ad4d99adb37ff msgid "`width * n == stride`" msgstr "" #: ../../pixmap.rst:500 ../../pixmap.rst:575 ../../pixmap.rst:581 #: ../../pixmap.rst:589 ../../pixmap.rst:597 ../../pixmap.rst:603 #: ../../pixmap.rst:609 ../../pixmap.rst:615 ../../pixmap.rst:621 #: ../../pixmap.rst:627 565eef89a4f1443196235c362117a790 #: 5790752de4bc4483b7998ab835faa57f 6b853b1effba4f9fa88e23a4ae3e5bf7 #: a40cc5c113bb4004862e82488bb6ad45 accc4d8148f54c7db1495d30f6c968f0 #: bca3975d0f204589a21f970e856552f3 d03716e1479c4f6b823e4712bf40c8e9 #: d2bde8f030b0409d8de6030b27ad0c95 d833bb6cf43f4a109aa43ffba391db0f #: d8b756b8057c42329c2c1040697bad3a msgid "int" msgstr "" #: ../../pixmap.rst:507 8695567f63d74993b36963cb05639cf6 msgid "Is `True` for a gray pixmap which only has the colors black and white." msgstr "灰色のピクマップで、黒と白の色しか持たない場合は `True` です。" #: ../../pixmap.rst:516 b44722fd47e341cb9f851ef65e077148 msgid "" "Is `True` if all pixels are identical (any colorspace). Where applicable," " pixels with different alpha values will be treated as different colors." msgstr "" "すべてのピクセルが同じ場合、`True` " "です（どのカラースペースでも適用）。該当する場合、異なるアルファ値を持つピクセルは異なる色として扱われます。" #: ../../pixmap.rst:523 6f074461eb274b3388c6956012c6f942 msgid "Contains the :ref:`IRect` of the pixmap." msgstr "ピクマップの :ref:`IRect` を含みます。" #: ../../pixmap.rst:525 8f50d53afc654b528e20564902041ddb msgid ":ref:`IRect`" msgstr "" #: ../../pixmap.rst:529 3abafa8c77804d0482f902d9e46ffb92 msgid "" "The color and (if :attr:`Pixmap.alpha` is true) transparency values for " "all pixels. It is an area of `width * height * n` bytes. Each n bytes " "define one pixel. Each successive n bytes yield another pixel in scanline" " order. Subsequent scanlines follow each other with no padding. E.g. for " "an RGBA colorspace this means, *samples* is a sequence of bytes like " "*..., R, G, B, A, ...*, and the four byte values R, G, B, A define one " "pixel." msgstr "" "すべてのピクセルの色と（ :attr:`Pixmap.alpha` がtrueの場合）透明度の値です。これは `width * height * " "n` " "バイトの領域です。各nバイトは1つのピクセルを定義します。各続くnバイトは、スキャンラインの順序で別のピクセルを生成します。連続するスキャンラインはパディングなしで続きます。たとえばRGBAカラースペースの場合、*samples*" " は *…、R、G、B、A、…* のようなバイトのシーケンスで、4つのバイト値R、G、B、Aが1つのピクセルを定義します。" #: ../../pixmap.rst:531 4d2c9332a9384bb2ac55549aea165f04 msgid "" "This area can be passed to other graphics libraries like PIL (Python " "Imaging Library) to do additional processing like saving the pixmap in " "other image formats." msgstr "" "この領域は、PIL（Python Imaging " "Library）などの他のグラフィックライブラリに渡すことができ、ピクマップを他の画像形式で保存するなどの追加の処理を行うのに使用できます。" #: ../../pixmap.rst:534 44ba67d25a5246c9b5c0fd86fc515d65 msgid "" "The underlying data is typically a **large** memory area, from which a " "`bytes` copy is made for this attribute ... each time you access it: for " "example an RGB-rendered letter page has a samples size of almost 1.4 MB. " "So consider assigning a new variable to it or use the `memoryview` " "version :attr:`Pixmap.samples_mv` (new in v1.18.17)." msgstr "" "基本データは通常、この属性にアクセスするたびに `bytes` " "のコピーが作成される大きなメモリ領域です。たとえば、RGBAでレンダリングされた文字ページのsamplesサイズはほぼ1.4 " "MBです。したがって、新しい変数に代入するか、`memoryview` バージョン :attr:`Pixmap.samples_mv` " "（v1.18.17で新機能）を使用するか、などの検討が必要です。" #: ../../pixmap.rst:535 028c2991fa3746d8ba4fcb1363e0ac36 msgid "" "Any changes to the underlying data are available only after accessing " "this attribute again. This is different from using the memoryview " "version." msgstr "基本データへの変更は、この属性に再度アクセスするまで利用できません。これは `memoryview` バージョンを使用する場合とは異なります。" #: ../../pixmap.rst:541 ../../pixmap.rst:563 6231b732cd664d9ea3f80fe04f0151c9 #: a54baa772ece47f4b743977662b324a4 msgid "New in v1.18.17" msgstr "新機能 v1.18.17" #: ../../pixmap.rst:543 090480ef9ce349efab292a2a0fe883b7 msgid "" "Like :attr:`Pixmap.samples`, but in Python `memoryview` format. It is " "built pointing to the memory in the pixmap -- not from a copy of it. So " "its creation speed is independent from the pixmap size, and any changes " "to pixels will be available immediately." msgstr "" ":attr:`Pixmap.samples` と同様ですが、Pythonの `memoryview` " "形式です。これはピクマップ内のメモリを指すように構築されており、コピーではありません。そのため、作成速度はピクマップのサイズに依存せず、ピクセルへの変更はすぐに利用可能です。" #: ../../pixmap.rst:545 93fdd4817c6d451593bce44eed03a5c1 msgid "" "Copies like `bytearray(pix.samples_mv)`, or `bytes(pixmap.samples_mv)` " "are equivalent to and can be used in place of `pix.samples`." msgstr "" "`bytearray(pix.samples_mv)` や `bytes(pixmap.samples_mv)` " "などのコピーは、`pix.samples` の代わりに使用でき、同等です。" #: ../../pixmap.rst:547 a15d8e7edd204441a7b9a76052a64fac msgid "We also have `len(pix.samples) == len(pix.samples_mv)`." msgstr "また、`len(pix.samples) == len(pix.samples_mv)` です。" #: ../../pixmap.rst:549 f7663a0870b54e46b8a6d53a9a5d3958 msgid "" "Look at this example from a 2 MB JPEG: the memoryview is **ten thousand " "times faster**::" msgstr "この2 MBのJPEGからのこの例をご覧ください： `memoryview` は **10000倍高速** です::" #: ../../pixmap.rst:556 4d36f9e0a4af4491be38efa57f54faf8 msgid "" "After the Pixmap has been destroyed, any attempt to use the memoryview " "will fail with ValueError." msgstr "" #: ../../pixmap.rst:559 91107ae487b14fe0b83a14f571082c55 msgid "memoryview" msgstr "" #: ../../pixmap.rst:565 d3bfaae3761a4c0eb851933ffe8701a3 msgid "" "Python pointer to the pixel area. This is a special integer format, which" " can be used by supporting applications (such as PyQt) to directly " "address the samples area and thus build their images extremely fast. For " "example::" msgstr "ピクセル領域へのPythonポインターです。これは特別な整数形式で、サポートするアプリケーション（PyQtなど）がサンプル領域に直接アクセスし、非常に高速に画像を構築できるように使用できます。例えば::" #: ../../pixmap.rst:570 92d9db2f39614549b2c8a9605c681e0b msgid "" "Both of the above lead to the same Qt image, but (2) can be **many " "hundred times faster**, because it avoids an additional copy of the pixel" " area." msgstr "以下はQtイメージへの2つの方法ですが、(2)はピクセル領域の追加のコピーを回避するため、通常 **何百倍も高速** です。" #: ../../pixmap.rst:572 37f284851e024d87b4ae3d3f4b495885 msgid "" "Warning: after the Pixmap has been destroyed, the Python pointer will be " "invalid and attempting to use it may crash the Python interpreter." msgstr "" #: ../../pixmap.rst:579 ad8485f478d04d1791c23f7e6c8cf984 msgid "" "Contains *len(pixmap)*. This will generally equal *len(pix.samples)* plus" " some platform-specific value for defining other attributes of the " "object." msgstr "" "これは *pixmap の長さ* を含んでいます。通常、これは *pix.samples の長さ* " "にプラットフォーム固有の他の属性を定義するためのいくつかの値を加えたものです。" #: ../../pixmap.rst:587 c1796fc010774081b59146b900edf924 msgid "Width of the region in pixels." msgstr "ピクセル単位の領域の幅。" #: ../../pixmap.rst:595 d21ef5432611489797b4691400ea9d15 msgid "Height of the region in pixels." msgstr "ピクセル単位の領域の高さ。" #: ../../pixmap.rst:601 5f88d51c88864babb326d12c5da3c8b4 msgid "" "X-coordinate of top-left corner in pixels. Cannot directly be changed -- " "use :meth:`Pixmap.set_origin`." msgstr "ピクセル単位での左上隅のX座標。直接変更できません。:meth:`Pixmap.set_origin` を使用してください。" #: ../../pixmap.rst:607 d82f9559530f4ed3a33c06c66cd24f3c msgid "" "Y-coordinate of top-left corner in pixels. Cannot directly be changed -- " "use :meth:`Pixmap.set_origin`." msgstr "ピクセル単位での左上隅のY座標。直接変更できません。:meth:`Pixmap.set_origin` を使用してください。" #: ../../pixmap.rst:613 26e889e8aa564bbea3553b3d55151e83 #, fuzzy msgid "" "Number of components per pixel. This number depends on colorspace and " "alpha. If colorspace is not ``None`` (stencil masks), then *Pixmap.n - " "Pixmap.alpha == pixmap.colorspace.n* is true. If colorspace is ``None``, " "then *n == alpha == 1*." msgstr "" "ピクセルごとのコンポーネントの数。この数は色空間とアルファに依存します。色空間が ``None`` " "でない場合（ステンシルマスク）、*Pixmap.n - Pixmap.alpha == pixmap.colorspace.n* " "がtrueです。色空間が ``None`` の場合、*n == alpha == 1* です。" #: ../../pixmap.rst:619 ddc7c2c6d915466a8673711ed573419a msgid "" "Horizontal resolution in dpi (dots per inch). Please also see " ":data:`resolution`. Cannot directly be changed -- use " ":meth:`Pixmap.set_dpi`." msgstr "" "水平解像度（dpi単位）。:data:`resolution` " "も参照してください。直接変更できません。:meth:`Pixmap.set_dpi` を使用してください。" #: ../../pixmap.rst:625 5952023fee854e3f82d65f1dbcc33361 msgid "" "Vertical resolution in dpi (dots per inch). Please also see " ":data:`resolution`. Cannot directly be changed -- use " ":meth:`Pixmap.set_dpi`." msgstr "" "垂直解像度（dpi単位）。:data:`resolution` " "も参照してください。直接変更できません。:meth:`Pixmap.set_dpi` を使用してください。" #: ../../pixmap.rst:631 966a193e7ae14efe944c435e65718b73 msgid "" "An information-only boolean flag set to ``True`` if the image will be " "drawn using \"linear interpolation\". If ``False`` \"nearest neighbour " "sampling\" will be used." msgstr "" "情報のみのブールフラグで、イメージが「線形補間」を使用して描画される場合に ``True`` に設定されます。``False`` " "の場合、「最近傍サンプリング」が使用されます。" #: ../../pixmap.rst:638 32f8505442184689838784d6630b61ca msgid "Supported Input Image Formats" msgstr "サポートされている入力画像フォーマット" #: ../../pixmap.rst:639 708fca4db2a64b96a2de83796cd396e7 msgid "" "The following file types are supported as **input** to construct pixmaps:" " **BMP, JPEG, GIF, TIFF, JXR, JPX**, **PNG**, **PAM** and all of the " "**Portable Anymap** family (**PBM, PGM, PNM, PPM**). This support is two-" "fold:" msgstr "" "次のファイルタイプは、ピクスマップを構築するための **入力** " "としてサポートされています：**BMP、JPEG、GIF、TIFF、JXR、JPX**、**PNG**、**PAM**、およびすべての " "**Portable Anymap** ファミリー（**PBM、PGM、PNM、PPM**）。このサポートは二重の方法で提供されています：" #: ../../pixmap.rst:641 4f4eb0bb22404ab184bf7ed8014abcc3 msgid "" "Directly create a pixmap with *Pixmap(filename)* or *Pixmap(byterray)*. " "The pixmap will then have properties as determined by the image." msgstr "" "*Pixmap（ファイル名）* または *Pixmap（バイト配列）* " "を使用してピクスマップを直接作成します。その後、ピクスマップには画像によって決定されるプロパティが含まれます。" #: ../../pixmap.rst:643 1f9a875b37444d988033c769493f20e4 msgid "" "Open such files with *pymupdf.open(...)*. The result will then appear as " "a document containing one single page. Creating a pixmap of this page " "offers all the options available in this context: apply a matrix, choose " "colorspace and alpha, confine the pixmap to a clip area, etc." msgstr "" "*pymupdf.open(...)* " "を使用してこのようなファイルを開きます。その結果、単一のページを含むドキュメントとして表示されます。このページのピクスマップを作成すると、このコンテキストで利用可能なすべてのオプションを使用できます：行列を適用、色空間とアルファを選択、ピクスマップをクリップエリアに制限などが含まれます。" #: ../../pixmap.rst:645 b8da58f972e349c099d429016189277f msgid "" "**SVG images** are only supported via method 2 above, not directly as " "pixmaps. But remember: the result of this is a **raster image** as is " "always the case with pixmaps [#f1]_." msgstr "" "**SVG画像** は、直接ピクスマップとしてではなく、上記の方法2でのみサポートされています。ただし、ピクスマップの場合と同様、その結果は " "**ラスターイメージ** です [#f1]_。" #: ../../pixmap.rst:650 5eb573904fb7401cb281c16fb4549f3a msgid "Supported Output Image Formats" msgstr "サポートされている出力画像フォーマット" #: ../../pixmap.rst:651 e4357173b7ec40d892ee19fcd4f3b83d msgid "" "A number of image **output** formats are supported. You have the option " "to either write an image directly to a file (:meth:`Pixmap.save`), or to " "generate a bytes object (:meth:`Pixmap.tobytes`). Both methods accept a " "string identifying the desired format (**Format** column below). Please " "note that not all combinations of pixmap colorspace, transparency support" " (alpha) and image format are possible." msgstr "" "いくつかの画像 **出力** " "フォーマットがサポートされています。画像を直接ファイルに書き込むオプション（:meth:`Pixmap.save`）またはバイトオブジェクトを生成するオプション（:meth:`Pixmap.tobytes`）があります。どちらのメソッドも、希望の" " **フォーマット** " "を識別する文字列を受け入れます（下のフォーマット列）。ただし、すべてのピクスマップの色空間、透明度サポート（アルファ）、および画像フォーマットの組み合わせが可能であるわけではないことに注意してください。" #: ../../pixmap.rst:654 4dbea7a06e2b4187a123a1c604d44efe msgid "**Format**" msgstr "**フォーマット**" #: ../../pixmap.rst:654 80b26e8d30f3423393a42e35c1a19bb0 msgid "**Colorspaces**" msgstr "**カラースペース**" #: ../../pixmap.rst:654 227b7bee485d4b79a2402f03891614ea msgid "**alpha**" msgstr "**アルファ**" #: ../../pixmap.rst:654 9797dfa1d6b74610af214069c4ee23d6 msgid "**Extensions**" msgstr "**拡張子**" #: ../../pixmap.rst:654 a635c115d504411785c1bf1a3984582a msgid "**Description**" msgstr "**説明**" #: ../../pixmap.rst:656 3f28e0c2c0e44d239075c2258795286a msgid "jpg, jpeg" msgstr "" #: ../../pixmap.rst:656 ../../pixmap.rst:657 ../../pixmap.rst:663 #: ../../pixmap.rst:664 18832c370236476095068f372050837f #: 3eb2a94753b44fdd9c7731ef24aef48b 4a67821c83134b4db3e4be1914c17d60 #: c83309e3c1934fc7ae1a973ebe7d1300 msgid "gray, rgb, cmyk" msgstr "" #: ../../pixmap.rst:656 ../../pixmap.rst:658 ../../pixmap.rst:659 #: ../../pixmap.rst:661 ../../pixmap.rst:662 ../../pixmap.rst:663 #: 02f9cb78532645d38d5abf940e1679f8 0cdb296b3e59480f8ec76bf53ac1c17b #: 2e0bd0a838434201878c609cff82145c 73c34c7c328f4d31af9f2258cc254f0d #: 947c1b80c66441799e2aba09091f8adb dd93afdec02947318d933a37f2c15024 msgid "no" msgstr "なし" #: ../../pixmap.rst:656 600504f9efd041ffb5b69ec388b137e9 msgid ".jpg, .jpeg" msgstr "" #: ../../pixmap.rst:656 26fa6ed5043a4a66a2c7adf39eb4e0cf msgid "Joint Photographic Experts Group" msgstr "" #: ../../pixmap.rst:657 6f1f99578dd84b0b96b1fb4707aac08b msgid "pam" msgstr "" #: ../../pixmap.rst:657 ../../pixmap.rst:660 ../../pixmap.rst:664 #: 1389030dbadc408693776ddaa02d250f db4043e33252451d9cfa830afcf4325c #: eb6f616d9083427b85a8e817b7b3c601 msgid "yes" msgstr "あり" #: ../../pixmap.rst:657 2f529016f72342f3ad621590a17c2720 msgid ".pam" msgstr "" #: ../../pixmap.rst:657 e2baced162604080b59bf27d358fda6c msgid "Portable Arbitrary Map" msgstr "" #: ../../pixmap.rst:658 95a9f8727e6846bdad7d42b2756dcf5e msgid "pbm" msgstr "" #: ../../pixmap.rst:658 ../../pixmap.rst:659 ../../pixmap.rst:660 #: ../../pixmap.rst:661 ../../pixmap.rst:662 220d5771addc47059dfafb3b7fd7a809 #: 68fd8f934dac404f86a38dcab3bb7bc2 91f4a25b5a5148af9a8c601bdc987ee9 #: 9d56458bd5944b7eab22abdec12c33c6 da23d0d1e79b4239bc3b878fd251ed6f msgid "gray, rgb" msgstr "" #: ../../pixmap.rst:658 10546c5955514cb99a4533ae396c259f msgid ".pbm" msgstr "" #: ../../pixmap.rst:658 3a22578bed7f479ba9f8bd94ddba617b msgid "Portable Bitmap" msgstr "" #: ../../pixmap.rst:659 12f4977253d34e7fb05ef71f9b6bb875 msgid "pgm" msgstr "" #: ../../pixmap.rst:659 34b5715a5a94481fa5410ee5467f5ae1 msgid ".pgm" msgstr "" #: ../../pixmap.rst:659 06d8a88352b54e25b36fc1dbd2289ecc msgid "Portable Graymap" msgstr "" #: ../../pixmap.rst:660 31684d0764064d42a3a8d884741e85be msgid "png" msgstr "" #: ../../pixmap.rst:660 34455c189f334f3ab56545b979560b1b msgid ".png" msgstr "" #: ../../pixmap.rst:660 682ed1780ad3421e9223fdefb0b8184c msgid "Portable Network Graphics" msgstr "" #: ../../pixmap.rst:661 f94a2f8f962f47fc9c9b1a7e2a906e11 msgid "pnm" msgstr "" #: ../../pixmap.rst:661 964f7dfd9ae844129b05d2e56342317d msgid ".pnm" msgstr "" #: ../../pixmap.rst:661 d627891286e44ad3987520c5e705f3a1 msgid "Portable Anymap" msgstr "" #: ../../pixmap.rst:662 3ada12b4d8b84c17aac44fec31492b76 msgid "ppm" msgstr "" #: ../../pixmap.rst:662 29fa1a416b3345479d3cb7258b83155e msgid ".ppm" msgstr "" #: ../../pixmap.rst:662 9045e7c717ae4d61ae56392d64c8f030 msgid "Portable Pixmap" msgstr "" #: ../../pixmap.rst:663 b528c16c8d064788976a0d977cf72a73 msgid "ps" msgstr "" #: ../../pixmap.rst:663 3d3a984cad1f4a1ba8eca7cfbc0af43f msgid ".ps" msgstr "" #: ../../pixmap.rst:663 f472a32950f140dcbd4258d41e955e95 msgid "Adobe PostScript Image" msgstr "" #: ../../pixmap.rst:664 d30993e0b1534a1da119de1e713e1fe7 msgid "psd" msgstr "" #: ../../pixmap.rst:664 c340e5edd2234429989f7c57fcbe6d4f msgid ".psd" msgstr "" #: ../../pixmap.rst:664 5ad137cb3c0c44fb8491eab0123adabe msgid "Adobe Photoshop Document" msgstr "" #: ../../pixmap.rst:668 5b70a01cdd2d49678a5104943c6ceb05 msgid "" "Not all image file types are supported (or at least common) on all OS " "platforms. E.g. PAM and the Portable Anymap formats are rare or even " "unknown on Windows." msgstr "" "すべての画像ファイル形式がすべてのOSプラットフォームでサポートされているわけではありません（または少なくとも一般的ではありません）。たとえば、PAMおよびPortable" " Anymap形式はWindowsでは珍しいか、またはまったく知られていません。" #: ../../pixmap.rst:669 ac24d0029a85434e89d87aea3c768299 msgid "" "Especially pertaining to CMYK colorspaces, you can always convert a CMYK " "pixmap to an RGB pixmap with *rgb_pix = pymupdf.Pixmap(pymupdf.csRGB, " "cmyk_pix)* and then save that in the desired format." msgstr "" "特にCMYKカラースペースに関連することについて、常にCMYK pixmapを *rgb_pix = " "pymupdf.Pixmap(pymupdf.csRGB、cmyk_pix)* に変換し、その後、その形式で保存できます。" #: ../../pixmap.rst:670 0d389b2c11cb4b7dbad0be0409dbf4dc msgid "" "As can be seen, MuPDF's image support range is different for input and " "output. Among those supported both ways, PNG and JPEG are probably the " "most popular." msgstr "ご覧のように、MuPDFの画像サポート範囲は入力と出力で異なります。両方の方法でサポートされているものの中で、PNGとJPEGはおそらく最も人気があります。" #: ../../pixmap.rst:671 78fe092f468843e984dee90661b2dbac msgid "" "We also recommend using \"ppm\" formats as input to tkinter's " "*PhotoImage* method like this: *tkimg = " "tkinter.PhotoImage(data=pix.tobytes(\"ppm\"))* (also see the tutorial). " "This is **very** fast (**60 times** faster than PNG)." msgstr "" "また、tkinterの *PhotoImage* メソッドへの入力として「ppm」形式を使用することをお勧めします。*tkimg = " "tkinter.PhotoImage(data=pix.tobytes(\"ppm\"))* のように（チュートリアルも参照してください）。これは" " **非常に** 高速です（PNGよりも60倍速いです）。" #: ../../pixmap.rst:676 ae8dd148bf7a4c1ea2de109295f929f5 msgid "Footnotes" msgstr "脚注" #: ../../pixmap.rst:677 b53f5a80a69a41dea8df4b23d4e4be3d msgid "" "If you need a **vector image** from the SVG, you must first convert it to" " a PDF. Try :meth:`Document.convert_to_pdf`. If this is not good enough, " "look for other SVG-to-PDF conversion tools like the Python packages " "`svglib `_, `CairoSVG " "`_, `Uniconvertor " "`_" " or the Java solution `Apache Batik `_. " "Have a look at our Wiki for more examples." msgstr "" "SVGから **ベクトル画像** " "が必要な場合、まずそれをPDFに変換する必要があります。:meth:`Document.convert_to_pdf` " "を試してみてください。これで十分でない場合、他のSVGからPDFへの変換ツールを探してみてください。Pythonパッケージ `svglib " "`_ 、 `CairoSVG " "`_ 、 `Uniconvertor " "`_" " 、またはJavaソリューションである `Apache Batik `_ " "などがあります。詳細な例についてはWikiをご覧ください。" #: ../../pixmap.rst:679 7efc30a117974783984b2f586a774632 msgid "" "To also set the alpha property, add an additional step to this method by " "dropping or adding an alpha channel to the result." msgstr "アルファプロパティも設定する場合は、このメソッドに追加ステップを追加し、結果にアルファチャンネルを追加または削除してください。" #: ../../footer.rst:46 e3d72edf62c54080b2839fccccec965e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "Since v1.22.0, PyMuPDF supports JPEG " #~ "output directly. For both, performance " #~ "reasons and for reducing external " #~ "dependencies, the use of this method " #~ "is no longer recommended when outputting" #~ " JPEG images." #~ msgstr "" #~ "v1.22.0 以降、PyMuPDF はJPEG " #~ "出力を直接サポートしています。パフォーマンスの理由と外部の依存関係を減らすために、JPEG " #~ "画像を出力する場合にはこのメソッドの使用は推奨されなくなりました。" #~ msgid ".raises ImportError: if Pillow is not installed." #~ msgstr "**ImportError** -- Pillow がインストールされていない場合" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "a ˇˇPIL.Imageˇˇ object" #~ msgstr "" #~ msgid "" #~ "If the pixmap's colorspace is RGB " #~ "with transparency, the alpha values may" #~ " or may not already be multiplied " #~ "into the color components ref/green/blue " #~ "(called \"premultiplied\"). To enforce undoing" #~ " premultiplication, set this parameter to" #~ " `True`. To learn about some " #~ "background, e.g. look for \"Premultiplied " #~ "alpha\" `here " #~ "`_." #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/point.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 0d500c9fea194e18bdf21282347590bd msgid "Artifex" msgstr "" #: ../../header.rst:-1 e33c40891e6e4d32874b82f04358d0c3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 66e5e2ad40694dd291575cb985997e52 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../point.rst:7 1a7b12dde1344c6b8af9cf30d960d3a2 msgid "Point" msgstr "Point (ポイント)" #: ../../point.rst:9 9373b96698944d69a97d4aa9025c1380 msgid "" "*Point* represents a point in the plane, defined by its x and y " "coordinates." msgstr "*Point* は、そのx座標とy座標で定義される平面上のポイントを表します。" #: ../../point.rst:12 ddd49ef47c8f4f308f1ddf551cc2e567 msgid "**Attribute / Method**" msgstr "**属性/メソッド**" #: ../../point.rst:12 ed814359d1e345869d70ff6ee4cdc137 msgid "**Description**" msgstr "**説明**" #: ../../point.rst:14 4032a33dd2b0453585391c0e32c93025 msgid ":meth:`Point.distance_to`" msgstr "" #: ../../point.rst:14 9b1b84ecc1484fa58a5bd82f7efcc3e0 msgid "calculate distance to point or rect" msgstr "ポイントまたは長方形までの距離を計算します" #: ../../point.rst:15 1d732af9b4494df9b35b7fc90450942a msgid ":meth:`Point.norm`" msgstr "" #: ../../point.rst:15 24cca31dc32d48ebb45024fe75817652 msgid "the Euclidean norm" msgstr "ユークリッドノルム" #: ../../point.rst:16 a4fdce716744491d81882b1974682151 msgid ":meth:`Point.transform`" msgstr "" #: ../../point.rst:16 0af15635b5b848668ada5ffbe0cbd6df msgid "transform point with a matrix" msgstr "行列でポイントを変換します" #: ../../point.rst:17 d888e3fab54a4373b8feaaf91ebd5ae1 msgid ":attr:`Point.abs_unit`" msgstr "" #: ../../point.rst:17 183111208bb2467cb4b0394b7b4ab584 msgid "same as unit, but positive coordinates" msgstr "ユニットと同じですが、座標が正です" #: ../../point.rst:18 9d60bb6c9d1c47ab98ee6fa40c9e579e msgid ":attr:`Point.unit`" msgstr "" #: ../../point.rst:18 3d36d8d93e024d4fb909fb12f00b7ff2 msgid "point coordinates divided by *abs(point)*" msgstr "座標を *abs(point)* で割ったもの" #: ../../point.rst:19 0f6cbe3e87d741b298d27c89be5c87cd msgid ":attr:`Point.x`" msgstr "" #: ../../point.rst:19 ed960716ff06486ba3d689e34b3796e3 msgid "the X-coordinate" msgstr "X座標" #: ../../point.rst:20 dafbd6c6033d4c93957636f1b93bbb34 msgid ":attr:`Point.y`" msgstr "" #: ../../point.rst:20 14468a77b47b4dd6befbf66696bd10e2 msgid "the Y-coordinate" msgstr "Y座標" #: ../../point.rst:23 d7c7ec15f0c64ec0bde77f8040a3949b msgid "**Class API**" msgstr "**クラスAPI**" #: ../../point.rst:35 4f945447bee6442cad5956d1a6846689 msgid "Overloaded constructors." msgstr "オーバーロードされたコンストラクタ。" #: ../../point.rst:37 67c4744696474b708d6c7b4519ea6369 msgid "Without parameters, *Point(0, 0)* will be created." msgstr "パラメーターなしで、*Point(0, 0)* が作成されます。" #: ../../point.rst:39 83a7b067d7034877898de81fa905a27b msgid "" "With another point specified, a **new copy** will be created, " "\"sequence\" is a Python sequence of 2 numbers (see " ":ref:`SequenceTypes`)." msgstr "" "他のポイントが指定された場合、**新しいコピー** が作成され、 " "\"sequence\"は2つの数値からなるPythonシーケンスです（:ref:`SequenceTypes`）。" #: ../../point.rst 019a616c168b4a2f861f9af0ee399ea7 #: 2bca886d5a7047579d56cd8ca0b2d161 e9644af7e0554639a33a4f730ebd999f msgid "Parameters" msgstr "" #: ../../point.rst:41 016a723eaaa64a778d1da1aaff44c2c0 msgid "x coordinate of the point" msgstr "ポイントのx座標" #: ../../point.rst:43 043d8b3675e44b1b8a995cfffb851812 msgid "y coordinate of the point" msgstr "ポイントのy座標" #: ../../point.rst:47 bda3f4adf4774b85838e3f7624d90d0c msgid "" "Calculate the distance to *x*, which may be :data:`point_like` or " ":data:`rect_like`. The distance is given in units of either pixels " "(default), inches, centimeters or millimeters." msgstr "" "*x* までの距離を計算します。 *x* は :data:`point_like` または :data:`rect_like` " "である可能性があります。距離は、ピクセル（デフォルト）、インチ、センチメートル、ミリメートルのいずれかの単位で指定されます。" #: ../../point.rst:49 51eb5b1d201a4f12a44618b02b2f0ac7 msgid "to which to compute the distance." msgstr "距離を計算する対象" #: ../../point.rst:51 0ae910e1ebbb43498a2d28bc4183b6b8 msgid "the unit to be measured in. One of \"px\", \"in\", \"cm\", \"mm\"." msgstr "測定単位。 \"px\"、 \"in\"、 \"cm\"、 \"mm\"のいずれか" #: ../../point.rst 3a555709592f4392804556d4a3ec4e27 #: 73ea2dd2fe974651a11d7cc2de129e1b msgid "Return type" msgstr "" #: ../../point.rst 477b136a22ab4265a3da36bf573fe39d msgid "Returns" msgstr "" #: ../../point.rst:54 2030d7a487e149959a154537312a572e msgid "" "the distance to *x*. If this is :data:`rect_like`, then the distance * " "is the length of the shortest line connecting to one of the rectangle " "sides * is calculated to the **finite version** of it * is zero if it " "**contains** the point" msgstr "" #: ../../point.rst:54 af0a3e229e7e43cebbe0f3ab85666636 msgid "the distance to *x*. If this is :data:`rect_like`, then the distance" msgstr "*x* までの距離。これが :data:`rect_like` の場合、距離" #: ../../point.rst:56 35dd44147c624976886941cec496f10d msgid "" "is the length of the shortest line connecting to one of the rectangle " "sides" msgstr "長方形の任意の辺に接続する最短線の長さ" #: ../../point.rst:57 b958d1db25694ade9997b6fb88065cb1 msgid "is calculated to the **finite version** of it" msgstr "その **有限バージョン** が計算されます" #: ../../point.rst:58 50b8b68670d44ab58ff2a5e1471a2375 msgid "is zero if it **contains** the point" msgstr "ポイントを **含む** 場合はゼロ" #: ../../point.rst:62 961b212deb1f4d2ab46a27116cacccab msgid "New in version 1.16.0" msgstr "バージョン1.16.0で新規追加" #: ../../point.rst:64 ebf5e01ee8414746b3bc426ee94ea1b3 msgid "" "Return the Euclidean norm (the length) of the point as a vector. Equals " "result of function *abs()*." msgstr "ベクトルとしてのポイントのユークリッドノルム（長さ）を返します。 *abs()* 関数の結果と等しいです。" #: ../../point.rst:68 74d77a8f32a14ab58d2ea6a9d9fbd224 msgid "Apply a matrix to the point and replace it with the result." msgstr "ポイントに行列を適用して、その結果で置き換えます。" #: ../../point.rst:70 781600b0f789421093c8d211a828214c msgid "The matrix to be applied." msgstr "適用する行列。" #: ../../point.rst:72 ../../point.rst:80 ../../point.rst:86 #: 5bb59ebd897348deb9ddbeecd467559a 93624a23e8f049d89ba4d5f25f6d5ca5 #: f42faeb785d84a6aa8ca09b294d45d72 msgid ":ref:`Point`" msgstr "" #: ../../point.rst:76 ffda14407cc94228ab7552a1ff1596ad msgid "" "Result of dividing each coordinate by *norm(point)*, the distance of the " "point to (0,0). This is a vector of length 1 pointing in the same " "direction as the point does. Its x, resp. y values are equal to the " "cosine, resp. sine of the angle this vector (and the point itself) has " "with the x axis." msgstr "" "各座標を *norm(point)* " "、ポイントが（0、0）からの距離で割った結果です。これは、ポイント自体がx軸との角度を持つベクトルと同じ方向を指す長さ1のベクトルです。そのx、resp。" " yの値は、このベクトル（およびポイント自体）がx軸とどのような角度を持っているかに等しいです。" #: ../../point.rst 365fd452be064ca7b35dd82343f61722 #: 61aabb3fb7b242c483bcbc3dfbf244a5 ee619eddf0ff4ef4b1cb279d8fa7a6f3 #: f4ef146bdd194e079d0bbdb3fe0a7a02 msgid "type" msgstr "" #: ../../point.rst:84 98dd11ae2ded46fba9aa5bc2f6b1667e msgid "" "Same as :attr:`unit` above, replacing the coordinates with their absolute" " values." msgstr "同じく、上記の :attr:`unit` と同様のもので、座標をそれぞれの絶対値に置き換えたものです。" #: ../../point.rst:90 19dceabb090d4f1db7c2c31ba2634756 msgid "The x coordinate" msgstr "x座標" #: ../../point.rst:92 ../../point.rst:98 3c19788c87c14335baeb6e261c4491a0 #: d9f4c536626243e68f4e6c81133e0338 msgid "float" msgstr "" #: ../../point.rst:96 6300e816dea5405293aee117b39c4d79 msgid "The y coordinate" msgstr "y座標" #: ../../point.rst:102 c67aba539e2441e1b48edda3875e6285 msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "" "このクラスはPythonのシーケンスプロトコルに従っており、コンポーネントはインデックスを使用してアクセスできます。また、PyMuPDFでの引数としてPythonのシーケンスを使用する方法については、:ref:`SequenceTypes`" " を参照してください。" #: ../../point.rst:103 b49de5b5939f4ea2b4916b2303345e68 msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "長方形は算術演算子と共に使用できます - 幾 :ref:`Algebra` を参照してください。" #: ../../footer.rst:60 6e7a0e3f1a044447ac39d419d2f8145a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pymupdf-layout/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-26 17:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 55554f175cc249878ead6e3e984a2e8a msgid "Artifex" msgstr "" #: ../../header.rst:-1 6aa2efac349e4bcab64dd67c0a0d5b13 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 fc386a5037ac4a0ba4239f1c51308e56 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../pymupdf-layout/index.rst:8 65880921881d4c9a95f25a114c1617cc msgid "PyMuPDF Layout" msgstr "" #: ../../pymupdf-layout/index.rst:11 26826b75387e4aadb2a29e8f577d4b8a msgid "" "|PyMuPDF Layout| is a lightweight layout analysis extension for |PyMuPDF|" " that turns PDFs into clean, structured data with minimal setup. It’s " "fast, accurate, and efficient without any GPU requirement." msgstr "PyMuPDF Layout は、PyMuPDF 用の軽量なレイアウト解析拡張機能で、最小限のセットアップで PDF をクリーンで構造化されたデータに変換します。高速で正確かつ効率的であり、GPU を必要としません。" #: ../../pymupdf-layout/index.rst:13 20fc4e9d5eae44d58cced93202624c15 msgid "" "It is an optional, but recommended, addition to the |PyMuPDF| library " "especially if you are required to more accurately extract structured data" " with better semantic information." msgstr "これは PyMuPDF ライブラリへのオプションですが推奨される追加機能であり、特により正確な意味情報を持つ構造化データの抽出が必要な場合に有用です。" #: ../../pymupdf-layout/index.rst:17 6cb4d2e97d464990a633d2defd97698e msgid "Installing" msgstr "インストール" #: ../../pymupdf-layout/index.rst:19 85aefd1baecd485b800f2238aba711c7 msgid "Install from |PyPI| with::" msgstr "|PyPI| からインストールするには::" #: ../../pymupdf-layout/index.rst:26 5e49fc1022b0491e968e6dac9a6ebd28 msgid "Using" msgstr "使用方法" #: ../../pymupdf-layout/index.rst:29 c4caa7b3525f461385db5339599b8e02 msgid "" "In nutshell, |PyMuPDF Layout| detects the layout to extract, but we need " "|PyMuPDF4LLM| for the API interface. This provides us with options to " "extract document content as |Markdown|, |JSON| or |TXT|." msgstr "簡単に言えば、PyMuPDF Layout は抽出するレイアウトを検出しますが、API インターフェースには PyMuPDF4LLM が必要です。これにより、ドキュメントコンテンツを Markdown、JSON、または TXT として抽出するオプションが提供されます。" #: ../../pymupdf-layout/index.rst:31 2851cd8bd3374a3c8fc60a4a0fe524e8 msgid "" "Let's set up the Python coding environment to get started and open a PDF " "then we'll move on to the semantic data extraction." msgstr "それでは、始めるために Python コーディング環境をセットアップし、PDF を開いてから、セマンティックデータ抽出に進みましょう。" #: ../../pymupdf-layout/index.rst:34 6a1648fb91cc454788a795ffc391432a msgid "Register packages and open a PDF" msgstr "パッケージを登録して PDF を開く" #: ../../pymupdf-layout/index.rst:36 1ba188d096bc425abbfee2ba07430823 msgid "First up let's import the libraries and open a sample document::" msgstr "まず、ライブラリをインポートしてサンプルドキュメントを開きましょう::" #: ../../pymupdf-layout/index.rst:42 d7900ddabe0644c09c53ba9fb57126b0 msgid "" "Note, in the above code, that |PyMuPDF Layout| must be imported as shown " "and before importing |PyMuPDF4LLM| to activate |PyMuPDF|'s layout feature" " and make it available to |PyMuPDF4LLM|." msgstr "上記のコードでは、|PyMuPDF Layout| は示されているようにインポートする必要があり、|PyMuPDF| のレイアウト機能を有効にして |PyMuPDF4LLM| で利用可能にするために、|PyMuPDF4LLM| をインポートする前にインポートする必要があることに注意してください。" #: ../../pymupdf-layout/index.rst:44 7b66dd7c7a164f99b1fd0113f2ccf699 msgid "" "Omitting the first line would cause execution of standard |PyMuPDF4LLM| -" " without the layout feature!" msgstr "最初の行を省略すると、レイアウト機能なしの標準 |PyMuPDF4LLM| が実行されます!" #: ../../pymupdf-layout/index.rst:47 a21b9bc7b3844b0ab455c3f364a2057f msgid "Extract the structured data" msgstr "構造化データを抽出する" #: ../../pymupdf-layout/index.rst:49 35bc60862bb24334a75b7dc95b60156f msgid "" "We've activated the |PyMuPDF Layout| library and we've loaded a document," " next let's extract the structured data. This is now like a super-charged" " version of standard |PyMuPDF4LLM| with ``Layout`` working behind the " "scenes combining heuristics with machine learning - for better extraction" " results." msgstr "|PyMuPDF Layout| ライブラリを有効にし、ドキュメントを読み込みました。次に構造化データを抽出しましょう。これは、``Layout`` がバックグラウンドでヒューリスティックと機械学習を組み合わせて動作する、標準 |PyMuPDF4LLM| の強化版のようなもので、より良い抽出結果が得られます。" #: ../../pymupdf-layout/index.rst:52 8fabaa7045ea40bca50d9b6cf1904b2b msgid "Extract as Markdown" msgstr "Markdown として抽出" #: ../../pymupdf-layout/index.rst:60 253f86c879cd4cfda51045e1311a3cba msgid "Extract as JSON" msgstr "JSON として抽出" #: ../../pymupdf-layout/index.rst:68 8da4947d5b974f24803ba5ed16e8cd77 msgid "Extract as TXT" msgstr "TXT として抽出" #: ../../pymupdf-layout/index.rst:76 5bbe37c28031413fa4f86978d66b0161 msgid "" "Please refer top the full :ref:`PyMuPDF4LLM API ` for " "more." msgstr "詳細については、完全な :ref:`PyMuPDF4LLM API ` を参照してください。" #: ../../pymupdf-layout/index.rst:78 6eedc55b27574fb583b04a9b9f3e3f55 msgid "Finally we can save the output to an external file as follows::" msgstr "最後に、次のように出力を外部ファイルに保存できます" #: ../../pymupdf-layout/index.rst:86 9bdb3f269e1c497e91d97cdc3a687bff msgid "Headers & Footers" msgstr "ヘッダーとフッター" #: ../../pymupdf-layout/index.rst:89 c239bc0bbbd64d318e6e8fdc55d1efbe msgid "" "Many documents will have header and footer information on each page of a " "PDF which you may or may not want to include. This information can be " "repetitive and simply not needed ( e.g. the same logo and document title " "or page number information is not always really important when it comes " "to extracting the document content )." msgstr "多くのドキュメントでは、PDF の各ページにヘッダーとフッター情報があり、これを含めたい場合と含めたくない場合があります。この情報は繰り返しになることがあり、単に不要な場合があります（例えば、同じロゴやドキュメントタイトル、ページ番号情報は、ドキュメントコンテンツを抽出する際に常に重要とは限りません）。" #: ../../pymupdf-layout/index.rst:91 ee2ea44ed53e4d95860be54bee8ead00 msgid "" "|PyMuPDF Layout| is trained in detecting these typical document elements " "and able to omit them." msgstr "|PyMuPDF Layout| は、これらの典型的なドキュメント要素を検出するようにトレーニングされており、それらを省略することができます。" #: ../../pymupdf-layout/index.rst:93 2e53e75f3b83455ab9f885efaae230c7 msgid "" "So in this case we can adjust our API calls to ignore these elements as " "follows::" msgstr "したがって、この場合、次のように API 呼び出しを調整してこれらの要素を無視できます::" #: ../../pymupdf-layout/index.rst:101 fc82782444984a34ab18e40f5123faeb msgid "" "Please note that page ``header`` / ``footer`` exclusion is not applicable" " to JSON output as it aims to always represent all data for the included " "pages. Please refer to the full :ref:`PyMuPDF4LLM API `" " for more." msgstr "``header`` / ``footer`` の除外は、含まれるページのすべてのデータを常に表現することを目的としているため、JSON 出力には適用されないことに注意してください。詳細については、完全な :ref:`PyMuPDF4LLM API ` を参照してください。" #: ../../pymupdf-layout/index.rst:104 a00239ede95b43319833ba01713ce8d7 msgid "Extending Capability" msgstr "機能の拡張" #: ../../pymupdf-layout/index.rst:107 f3bec49e1ee042caad2ba1f1f8d07230 msgid "Using with Pro" msgstr "PyMuPDF Pro との使用" #: ../../pymupdf-layout/index.rst:109 1a6a4c0ada2842d588768a849fe3c7f3 msgid "" "We are able to extend |PyMuPDF Layout| to work with |PyMuPDF Pro| and " "thus increase our capability by allowing Office documents to be provided " "as input files. In this case all we have to do is to add the import for " "|PyMuPDF Pro| and unlock it::" msgstr "|PyMuPDF Layout| を |PyMuPDF Pro| と連携させることで機能を拡張し、Office ドキュメントを入力ファイルとして提供できるようにすることで能力を向上させることができます。この場合、|PyMuPDF Pro| のインポートを追加してロックを解除するだけです::" #: ../../pymupdf-layout/index.rst:116 695ebd9778304b3da362108ea2e9695e msgid "Now we can happily load Office files and convert them as follows::" msgstr "これで、次のように Office ファイルを読み込んで変換できます::" #: ../../pymupdf-layout/index.rst:122 14fdcdcd4aab4335919c50efc4749185 msgid "OCR support" msgstr "OCR サポート" #: ../../pymupdf-layout/index.rst:124 99eb4f65329d45c7bb6eaf035c255259 msgid "" "The new layout-sensitive |PyMuPDF4LLM| version also evaluates whether a " "page would benefit from applying OCR to it. If its heuristics come to " "this conclusion, the built-in Tesseract-OCR module is automatically " "invoked. Its results are then handled like normal page content." msgstr "新しいレイアウト対応の |PyMuPDF4LLM| バージョンは、ページに OCR を適用することが有益かどうかも評価します。ヒューリスティックがこの結論に達した場合、組み込みの **Tesseract-OCR** モジュールが自動的に呼び出されます。その結果は、通常のページコンテンツと同様に処理されます。" #: ../../pymupdf-layout/index.rst:126 cdbf9a9f1f5341cc96aaaa1a6a74434f msgid "" "If a page contains (roughly) no text at all, but is covered with images " "or many character-sized vectors, a check is made using `OpenCV " "`_ whether text is *probably* " "detectable on the page at all. This is done to tell apart image-based " "text from ordinary pictures (like photographs)." msgstr "ページにテキストがほとんど含まれていないが、画像や多数の文字サイズのベクターで覆われている場合、`OpenCV `_ を使用して、ページ上でテキストが検出可能かどうかをチェックします。これは、画像ベースのテキストを通常の写真などの画像と区別するために行われます。" #: ../../pymupdf-layout/index.rst:128 8c8ba1c1b2bc4875b04cc60b98293a08 msgid "" "If the page does contain text but too many characters are unreadable " "(like \"�����\"), OCR is also executed, but **for the affected text areas" " only** -- not the full page. This way, we avoid losing already existing " "text and other content like images and vectors." msgstr "ページにテキストが含まれているものの、読み取り不可能な文字（「�����」など）が多すぎる場合、OCR も実行されますが、影響を受けるテキスト領域のみが対象となり、ページ全体ではありません。これにより、既存のテキストや画像やベクターなどの他のコンテンツが失われるのを防ぎます。" #: ../../pymupdf-layout/index.rst:130 225a390ebce94321a090f94ab2165c16 msgid "" "For these heuristics to work we need both, an existing :ref:`Tesseract installation ` and the availability of `OpenCV `_ in the Python environment. If" " either is missing, no OCR is attempted at all." msgstr "これらのヒューリスティックが機能するには、 :ref:`Tesseract installation ` のインストールと Python 環境での `OpenCV `_ の利用可能性の両方が必要です。どちらか一方が欠けている場合、OCR はまったく試行されません。" msgid "The decision tree for whether OCR is actually used or not depends on the following:" msgstr "OCRが実際に使用されるかどうかの決定木は、以下に依存します" msgid ":ref:`PyMuPDF Layout is imported `" msgstr "PyMuPDF Layoutがインポートされている" msgid "In the :ref:`PyMuPDF4LLM API ` you have `use_ocr` enabled (this is set to `True` by default)" msgstr ":ref:`PyMuPDF4LLM API ` で ``use_ocr`` が有効になっている（これはデフォルトで ``True`` に設定されています）" msgid ":ref:`Tesseract is correctly installed `" msgstr ":ref:`Tesseractが正しくインストールされている `" msgid "`OpenCV `_ is available in your Python environment" msgstr "`OpenCV `_ がPython環境で利用可能である" #: ../../pymupdf-layout/index.rst:137 fddcc1ea96e64c658554704bb141490b msgid "|PyMuPDF Layout| and |PyMuPDF4LLM| parameter caveats" msgstr "|PyMuPDF Layout| と |PyMuPDF4LLM| のパラメータに関する注意事項" #: ../../pymupdf-layout/index.rst:139 b7f33df2c3974ea1bbead613286f3639 msgid "" "If you have imported ``pymupdf.layout``, |PyMuPDF4LLM| changes its " "behavior in various areas quite significantly. New methods become " "available and also some features are no longer supported. Please visit " "`this site `_ for" " a detailed description of the changes. That web site is being kept up to" " date while we continue to work on improvements." msgstr "``pymupdf.layout`` をインポートした場合、|PyMuPDF4LLM| はさまざまな領域でその動作を大幅に変更します。新しいメソッドが利用可能になり、一部の機能はサポートされなくなります。変更の詳細については、`このサイト `_ を参照してください。このウェブサイトは、改善作業を続けながら最新の状態に保たれています。" #: ../../footer.rst:46 fcc43bbf382644f6928a40bc9aea37c1 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pymupdf-pro/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ff337a9fa03e4fd6a3d7aaec4930912f msgid "Artifex" msgstr "" #: ../../header.rst:-1 b9e1a76b005b46c7a35e27ac36b668dd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 5b66ad60d8974f3fb8061286f4b23214 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../pymupdf-pro/index.rst:8 07624f1e03dd463c99bf82f95b91a35e msgid "PyMuPDF Pro" msgstr "" #: ../../pymupdf-pro/index.rst:11 879666c817c94726a9df9e5880d5425a msgid "|PyMuPDF Pro| is a set of *commercial extensions* for |PyMuPDF|." msgstr "|PyMuPDF Pro| は、|PyMuPDF| 用の *商用拡張機能* セットです。" #: ../../pymupdf-pro/index.rst:13 ae90e3fd121f4e04a0a9ecd747514717 msgid "" "Enhance |PyMuPDF| capability with **Office** document support & " "**RAG/LLM** integrations." msgstr "**Office** ドキュメントサポートと **RAG/LLM** 統合で |PyMuPDF| の機能を強化します。" #: ../../pymupdf-pro/index.rst:15 aed2c2f793d348d8bf6eb0811eecb47a msgid "" "Enables Office document handling, including ``doc``, ``docx``, ``hwp``, " "``hwpx``, ``ppt``, ``pptx``, ``xls``, ``xlsx``, and others." msgstr "``doc``、``docx``、``hwp``、``hwpx``、``ppt``、``pptx``、``xls``、``xlsx`` などの Office ドキュメント処理を可能にします。" #: ../../pymupdf-pro/index.rst:16 997a064abea1408d914a30cae0872289 msgid "Supports text and table extraction, document conversion and more." msgstr "テキストと表の抽出、ドキュメント変換などをサポートします。" #: ../../pymupdf-pro/index.rst:17 7ee872ab1d5c4992b77ebbf8c3cf149c msgid "Includes the commercial version of |PyMuPDF4LLM|." msgstr "PyMuPDF4LLM の商用バージョンが含まれています。" #: ../../pymupdf-pro/index.rst:19 83cc2a9a8a854516b90d26d2841aad02 msgid "" "To enquire about obtaining a commercial license, then `use this contact " "page `_." msgstr "商用ライセンスの取得についてお問い合わせの場合は、`こちらのお問い合わせページをご利用ください `_。" #: ../../pymupdf-pro/index.rst:24 f0a9c51213864c898871ca01453557e1 msgid "" "A licensed version of |PyMuPDF Pro| also gives you a licensed version of " "|PyMuPDF4LLM|. If you are interested in using the |PyMuPDF4LLM| package " "you should install it separately." msgstr "|PyMuPDF Pro| のライセンス版には、|PyMuPDF4LLM| のライセンス版も含まれています。|PyMuPDF4LLM| パッケージの使用に興味がある場合は、個別にインストールする必要があります。" #: ../../pymupdf-pro/index.rst:28 4a1d503fea744f4ba62d54e186f02d87 msgid "Platform support" msgstr "プラットフォームサポート" #: ../../pymupdf-pro/index.rst:30 78076f4c0458474f913d726a0fb0e0bc msgid "Available for these platforms only:" msgstr "以下のプラットフォームでのみ利用可能" #: ../../pymupdf-pro/index.rst:32 ed38f46c156840689524033bf7da829d msgid "Windows x86_64." msgstr "" #: ../../pymupdf-pro/index.rst:33 259897daea654cb8a90bc8e65c6e4f76 msgid "Linux x86_64 (glibc)." msgstr "" #: ../../pymupdf-pro/index.rst:34 1923df7caa0b4f04a3b259b4c866ba6e msgid "MacOS x86_64." msgstr "" #: ../../pymupdf-pro/index.rst:35 fd5d8bf6fc12467a826ce8202a1d2ec3 msgid "MacOS arm64." msgstr "" #: ../../pymupdf-pro/index.rst:39 f2952d3e2f47435bb640b83bd15721c4 msgid "Office file support" msgstr "Office ファイルサポート" #: ../../pymupdf-pro/index.rst:41 7c38d85a3c164f3a90d869b52ef96eb1 msgid "" "In addition to the `standard file types supported by PyMuPDF " "`, |PyMuPDF Pro| supports:" msgstr "`PyMuPDF がサポートする標準ファイルタイプ ` に加えて、|PyMuPDF Pro| は以下をサポートします" #: ../../pymupdf-pro/index.rst:46 67438064f36f474186aeb4fbfb093d31 msgid "**DOC/DOCX**" msgstr "" #: ../../pymupdf-pro/index.rst:47 9ab995c3f8214b9ab04698d96a84b4e2 msgid "**XLS/XLSX**" msgstr "" #: ../../pymupdf-pro/index.rst:48 9e2c997d6ac44df79efb09f56a593cbb msgid "**PPT/PPTX**" msgstr "" #: ../../pymupdf-pro/index.rst:49 28e3c375094f40258eea347ffcaf5a8f msgid "**HWP/HWPX**" msgstr "" #: ../../pymupdf-pro/index.rst:66 9ccca49db9fb4df98d9464183c30d68c msgid "Usage" msgstr "使用方法" #: ../../pymupdf-pro/index.rst:69 edd61111e81a46198c9ef49a53e782b0 msgid "Installation" msgstr "インストール" #: ../../pymupdf-pro/index.rst:71 f961577e8ffd49469227db2bbdcd9bb2 msgid "Install via pip with:" msgstr "pip でインストールするには" #: ../../pymupdf-pro/index.rst:79 699e6bf8334b4cf8b23793ff0e45ccbf msgid "Loading an **Office** document" msgstr "**Office** ドキュメントを読み込む" #: ../../pymupdf-pro/index.rst:81 08e39b8bfc514665aafb5c1aa211bcfc msgid "" "Import |PyMuPDF Pro| and you can then reference **Office** documents " "directly, e.g.:" msgstr "|PyMuPDF Pro| をインポートすると、**Office** ドキュメントを直接参照できます。例えば:" #: ../../pymupdf-pro/index.rst:92 e21e201731344245a88c7e6bdd9c2dc2 msgid "" "All standard |PyMuPDF| functionality is exposed as expected - |PyMuPDF " "Pro| handles the extended **Office** file types" msgstr "すべての標準 |PyMuPDF| 機能が期待どおりに公開されます - |PyMuPDF Pro| は拡張された **Office** ファイルタイプを処理します" #: ../../pymupdf-pro/index.rst:95 32d84f02e19a40b5bb42c1d26a81afe5 msgid "" "From then on you can work with document pages just as you would do " "normally, but with respect to the `restrictions " "`." msgstr "その後は、`制限事項 ` を考慮しながら、通常どおりドキュメントページを操作できます。" #: ../../pymupdf-pro/index.rst:99 36c298b59008468ab926c22842511b25 msgid "Converting an **Office** document to |PDF|" msgstr "**Office** ドキュメントを |PDF| に変換する" #: ../../pymupdf-pro/index.rst:101 c01333a0e65f42d29d469ace26b3fd91 msgid "" "The following code snippet can convert your **Office** document to |PDF| " "format:" msgstr "次のコードスニペットは、**Office** ドキュメントを |PDF| 形式に変換できます:" #: ../../pymupdf-pro/index.rst:119 cd5eb6eaf8094ced89572a48282454ca msgid "Restrictions" msgstr "制限事項" #: ../../pymupdf-pro/index.rst:122 badbfba0a2a0495290e9594585aaefc9 msgid "" "|PyMuPDF Pro| functionality is restricted without a license key as " "follows:" msgstr "|PyMuPDF Pro| 機能は、ライセンスキーがない場合、次のように制限されます:" #: ../../pymupdf-pro/index.rst:124 0edbc072da504add956116e21d3eebde msgid "**Only the first 3 pages of any document will be available.**" msgstr "どのドキュメントでも最初の3ページのみが利用可能です。" #: ../../pymupdf-pro/index.rst:126 6fa9f0d4dec94b3db782dacdc632f5a0 msgid "" "To unlock full functionality you should `obtain a trial key " "`_." msgstr "すべての機能のロックを解除するには、`トライアルキーを取得 `_ してください。" #: ../../pymupdf-pro/index.rst:132 ff0d00debbdb4746809d8750352f10bc msgid "Trial keys" msgstr "トライアルキー" #: ../../pymupdf-pro/index.rst:134 e689628360fa4b4497ccbb720dd0faca msgid "" "To obtain a license key `please fill out the form on this page " "`_. You will then have the trial key " "emailled to the address you submitted." msgstr "ライセンスキーを取得するには、`このページのフォームに記入 `_ してください。提出したアドレスにトライアルキーがメールで送信されます。" #: ../../pymupdf-pro/index.rst:138 b4af428798424c3baae4771829727b28 msgid "Using a key" msgstr "キーの使用" #: ../../pymupdf-pro/index.rst:141 6766aa2a1d144b81a15c3ad28ce403da msgid "Initialize |PyMuPDF Pro| with a key as follows:" msgstr "次のようにキーで |PyMuPDF Pro| を初期化します" #: ../../pymupdf-pro/index.rst:149 92e495f1e7934e1e83d346f56ab9833d msgid "" "This will allow you to evaluate the product for a limited time. If you " "want to use |PyMuPDF Pro| after this time you should then `enquire about " "obtaining a commercial license `_." msgstr "これにより、限られた期間製品を評価できます。この期間後も |PyMuPDF Pro| を使用したい場合は、`商用ライセンスの取得についてお問い合わせ `_ ください。" #: ../../pymupdf-pro/index.rst:153 a394162132a04de092aabb5d2fcbc814 msgid "Fonts" msgstr "フォント" #: ../../pymupdf-pro/index.rst:155 8e2db8a260ac4b8597a804b55d7ab547 msgid "" "By default `pymupdf.pro.unlock()` searches for all installed font " "directories." msgstr "デフォルトでは、`pymupdf.pro.unlock()` はインストールされているすべてのフォントディレクトリを検索します。" #: ../../pymupdf-pro/index.rst:157 e0cd7217fd79445ea7e79586abad31d1 msgid "This can be controlled with keyword-only args:" msgstr "これは、キーワード専用引数で制御できます:" #: ../../pymupdf-pro/index.rst:159 879866813ec14fd08f5b249e833e7ee7 msgid "" "`fontpath`: specific font directories, either as a list/tuple or " "`os.sep`-separated string. If None (the default), we use " "`os.environ['PYMUPDFPRO_FONT_PATH']` if set." msgstr "`fontpath`: 特定のフォントディレクトリ。リスト/タプルまたは `os.sep` で区切られた文字列として指定します。None（デフォルト）の場合、設定されていれば `os.environ['PYMUPDFPRO_FONT_PATH']` を使用します。" #: ../../pymupdf-pro/index.rst:161 5ca9e3934e6c4c91b603c12662c79cf6 msgid "" "`fontpath_auto`: Whether to append system font directories. If None (the " "default) we use true if `os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` is '1'." " If true we append all system font directories." msgstr "`fontpath_auto`: システムフォントディレクトリを追加するかどうか。None（デフォルト）の場合、`os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` が '1' であれば true を使用します。true の場合、すべてのシステムフォントディレクトリを追加します。" #: ../../pymupdf-pro/index.rst:165 5ecf267b5f8f4e68be5f69f1cbee4782 msgid "" "Function `pymupdf.pro.get_fontpath()` returns a tuple of all font " "directories used by `unlock()`." msgstr "関数 `pymupdf.pro.get_fontpath()` は、`unlock()` で使用されるすべてのフォントディレクトリのタプルを返します。" #: ../../footer.rst:46 b26519c017c744e3b52c222b2633f6ed msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pymupdf-pro.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 0dfe01c73aa0450484e10fe2c161a22f msgid "Artifex" msgstr "" #: ../../header.rst:-1 b4ed4e93bf294eb098966f465bc797c5 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 ec46200e47134602a82ee60a1118c156 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../pymupdf-pro.rst:9 26812dee4da947c7918d490500c2067c msgid "PyMuPDF Pro" msgstr "" #: ../../pymupdf-pro.rst:12 aa17b9e367774bb89e40e6d34d5ec0fe msgid "|PyMuPDF Pro| is a set of *commercial extensions* for |PyMuPDF|." msgstr "" #: ../../pymupdf-pro.rst:14 11f22babd0e94a46b70d2de6efd179bc msgid "" "Enhance |PyMuPDF| capability with **Office** document support & " "**RAG/LLM** integrations." msgstr "" #: ../../pymupdf-pro.rst:16 38e3e965f4184ecc965744d00c2568d5 msgid "" "Enables Office document handling, including ``doc``, ``docx``, ``hwp``, " "``hwpx``, ``ppt``, ``pptx``, ``xls``, ``xlsx``, and others." msgstr "" #: ../../pymupdf-pro.rst:17 0a12a5f74ed941a9be6cef8798aa2cbd msgid "Supports text and table extraction, document conversion and more." msgstr "" #: ../../pymupdf-pro.rst:18 49a700600f224867985cf301867199d8 msgid "Includes the commercial version of |PyMuPDF4LLM|." msgstr "" #: ../../pymupdf-pro.rst:20 9450c9107df04fe5bc38e0324bf54c01 msgid "" "To enquire about obtaining a commercial license, then `use this contact " "page `_." msgstr "" #: ../../pymupdf-pro.rst:25 1321bc95b45541b48337e44f78b58020 msgid "" "A licensed version of |PyMuPDF Pro| also gives you a licensed version of " "|PyMuPDF4LLM|. If you are interested in using the |PyMuPDF4LLM| package " "you should install it separately." msgstr "" #: ../../pymupdf-pro.rst:29 f655cf9fdd1f48dd9e890f8c5aef653f msgid "Platform support" msgstr "" #: ../../pymupdf-pro.rst:31 367befe5f1a34b7fb9665758548f6448 msgid "Available for these platforms only:" msgstr "" #: ../../pymupdf-pro.rst:33 a256db349f5242a38297eda82fd9ee71 msgid "Windows x86_64." msgstr "" #: ../../pymupdf-pro.rst:34 9e2ffb09f61f430f9594a418d1ee8ab0 msgid "Linux x86_64 (glibc)." msgstr "" #: ../../pymupdf-pro.rst:35 97423a8756fc40408f80993fce6a1fc6 msgid "MacOS x86_64." msgstr "" #: ../../pymupdf-pro.rst:36 1a59aca2bbc44194b2dde06a89fac54f msgid "MacOS arm64." msgstr "" #: ../../pymupdf-pro.rst:40 0abf65ed31ca4a949b4b81e0bb521522 msgid "Office file support" msgstr "" #: ../../pymupdf-pro.rst:42 b8f3023035f74b3dacbf2e3210f2c12f msgid "" "In addition to the `standard file types supported by PyMuPDF " "`, |PyMuPDF Pro| supports:" msgstr "" #: ../../pymupdf-pro.rst:47 45349c74355f48c0abf3ae8f486843a6 msgid "**DOC/DOCX**" msgstr "" #: ../../pymupdf-pro.rst:48 777b729313244ad298c7b6d5bb49c369 msgid "**XLS/XLSX**" msgstr "" #: ../../pymupdf-pro.rst:49 371c1c089e4c475caf8acc946169b878 msgid "**PPT/PPTX**" msgstr "" #: ../../pymupdf-pro.rst:50 d6ec7208ebdc4049815db59e7ec6641e msgid "**HWP/HWPX**" msgstr "" #: ../../pymupdf-pro.rst:67 097b80f124fa49fd92bab9375f53b975 msgid "Usage" msgstr "" #: ../../pymupdf-pro.rst:70 f5c7cbdc4f62456199de7159bd404d58 msgid "Installation" msgstr "" #: ../../pymupdf-pro.rst:72 dabefb8cfac54dabb7e1859dbc4578ed msgid "Install via pip with:" msgstr "" #: ../../pymupdf-pro.rst:80 47d8f70087754faa8e60ff7f7e0d1b2a msgid "Loading an **Office** document" msgstr "" #: ../../pymupdf-pro.rst:82 f5cf1df845294870b35e718fadf85b1f msgid "" "Import |PyMuPDF Pro| and you can then reference **Office** documents " "directly, e.g.:" msgstr "" #: ../../pymupdf-pro.rst:93 470f5d9c683947b2b97f3e90e42f8a5d msgid "" "All standard |PyMuPDF| functionality is exposed as expected - |PyMuPDF " "Pro| handles the extended **Office** file types" msgstr "" #: ../../pymupdf-pro.rst:96 72c50a703f314197b00a1d336392d8dc msgid "" "From then on you can work with document pages just as you would do " "normally, but with respect to the `restrictions " "`." msgstr "" #: ../../pymupdf-pro.rst:100 5b447b0138f849efa8d4cb7a1cfd910b msgid "Converting an **Office** document to |PDF|" msgstr "" #: ../../pymupdf-pro.rst:102 b8e5b07700944b9da32ae37ca9175e00 msgid "" "The following code snippet can convert your **Office** document to |PDF| " "format:" msgstr "" #: ../../pymupdf-pro.rst:120 26c5a530a9a54f56bc28027850958f25 msgid "Restrictions" msgstr "" #: ../../pymupdf-pro.rst:123 2391a063f21c4de092b0beca7b94377e msgid "" "|PyMuPDF Pro| functionality is restricted without a license key as " "follows:" msgstr "" #: ../../pymupdf-pro.rst:125 1e6b67342d31405ab0f72646252650df msgid "**Only the first 3 pages of any document will be available.**" msgstr "" #: ../../pymupdf-pro.rst:127 c176b676614c4507959f495c339a3e71 msgid "" "To unlock full functionality you should `obtain a trial key " "`_." msgstr "" #: ../../pymupdf-pro.rst:133 9a01dcbd3af143b6bad7400a98e6b69d msgid "Trial keys" msgstr "" #: ../../pymupdf-pro.rst:135 89e312aa37bd4b749727cd14913e2e70 msgid "" "To obtain a license key `please fill out the form on this page " "`_. You will then have the trial key " "emailled to the address you submitted." msgstr "" #: ../../pymupdf-pro.rst:139 371fa0ea70f44d9e8e6e9155a631426f msgid "Using a key" msgstr "" #: ../../pymupdf-pro.rst:142 25f50e294ef5429e86781bea1e1b1e29 msgid "Initialize |PyMuPDF Pro| with a key as follows:" msgstr "" #: ../../pymupdf-pro.rst:150 b01044f9b9f34927892044fa1c007b7f msgid "" "This will allow you to evaluate the product for a limited time. If you " "want to use |PyMuPDF Pro| after this time you should then `enquire about " "obtaining a commercial license `_." msgstr "" #: ../../pymupdf-pro.rst:154 fcfee54b997f4b5a8368464ac33e8568 msgid "Fonts" msgstr "" #: ../../pymupdf-pro.rst:156 c22971d466c14a31aeb4f6e851c88144 msgid "" "By default `pymupdf.pro.unlock()` searches for all installed font " "directories." msgstr "" #: ../../pymupdf-pro.rst:158 c388a7575cdf4d709d86899170008a23 msgid "This can be controlled with keyword-only args:" msgstr "" #: ../../pymupdf-pro.rst:160 9c1f44585d134e12bb9b74ce4a83121b msgid "" "`fontpath`: specific font directories, either as a list/tuple or " "`os.sep`-separated string. If None (the default), we use " "`os.environ['PYMUPDFPRO_FONT_PATH']` if set." msgstr "" #: ../../pymupdf-pro.rst:162 ae8654a3d7f14d329aa5caf0f2ccde78 msgid "" "`fontpath_auto`: Whether to append system font directories. If None (the " "default) we use true if `os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` is '1'." " If true we append all system font directories." msgstr "" #: ../../pymupdf-pro.rst:166 28aa600bf1164c318f946da4d23619db msgid "" "Function `pymupdf.pro.get_fontpath()` returns a tuple of all font " "directories used by `unlock()`." msgstr "" #: ../../footer.rst:60 fdcd80e27b7c41f882a85b921e2ee500 msgid "This documentation covers all versions up to |version|." msgstr "" #~ msgid "Enhance |PyMuPDF| capability with **Office** document support." #~ msgstr "" #~ msgid "" #~ "|PyMuPDF Pro| offers all the features" #~ " of |PyMuPDF|, plus enhanced functionality" #~ " to support **Office** documents." #~ msgstr "" #~ msgid "Load, parse and extract text data from **Office** files" #~ msgstr "" #~ msgid "Ablility to render **Office** files" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pymupdf4llm/api.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-26 17:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 82786ea5867f4818b6c5c7b3e8a55ef0 msgid "Artifex" msgstr "" #: ../../header.rst:-1 1a6aac6ec3e34205b07c2f37fdc69e13 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 ab4f1a2eeccd4098ae98718eac840f2e msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../pymupdf4llm/api.rst:9 4e5664b1124d48d18fd12e59b727a0bd msgid "API" msgstr "" #: ../../pymupdf4llm/api.rst:12 e4fe663d1ee04cf7bbc808eeb9ce308b msgid "The |PyMuPDF4LLM| API" msgstr "|PyMuPDF4LLM| API" #: ../../footer.rst:46 1ed68f4bf8fd45fab04f7a49fba09f0a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" msgid "Prints the version of the library." msgstr "ライブラリのバージョンを出力します。" msgid "Reads the pages of the file and outputs the text of its pages in |Markdown| format. How this should happen in detail can be influenced by a number of parameters. Please note that **support for building page chunks** from the |Markdown| text is supported." msgstr "ファイルのページを読み取り、各ページのテキストを |Markdown| 形式で出力します。詳細な動作は複数のパラメータで制御できます。 |Markdown| テキストからページチャンクを構築する機能がサポートされていることにご注意ください。" msgid "the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`." msgstr "ファイルは、ファイルパス文字列、または |PyMuPDF| :class:`Document` (``pymupdf.open`` で作成) のいずれかで指定します。``pathlib.Path`` 指定、Pythonファイル風オブジェクト、メモリ内ドキュメントなどを使用する場合は、|PyMuPDF| :class:`Document` を **必ず** 使用してください。" msgid "|PyMuPDFLayoutMode_Ignored| does a simple check for the general background color of the pages (default is ``True``). If any text or vector has this color it will be ignored. May increase detection accuracy." msgstr "|PyMuPDFLayoutMode_Ignored| ページの全体的な背景色を簡易的にチェックします（デフォルトは ``True``）。テキストやベクターがこの色の場合、無視されます。検出精度が向上する可能性があります。" msgid "specify the desired image resolution in dots per inch. Relevant only if `write_images=True` or `embed_images=True`. Default value is 150." msgstr "希望する画像解像度をドット・パー・インチ（DPI）で指定します。``write_images=True`` または ``embed_images=True`` の場合のみ有効です。デフォルト値は150です。" msgid "|PyMuPDFLayoutMode_Valid| use :ref:`OCR capability ` to help analyse the page." msgstr "|PyMuPDFLayoutMode_Valid| :ref:`OCR機能 ` を使用してページの分析を支援します。" msgid "|PyMuPDFLayoutMode_Valid| specify the desired image resolution in dots per inch for applying OCR to the intermediate image of the page. Default value is 400. Only relevant if the page has been determined to profit from OCR (no or few text, most of the page covered by images or character-like vectors, etc.). Large values may increase the OCR precision but increase memory requirements and processing time. There also is a risk of over-sharpening the image which may decrease OCR precision. So the default value should probably be sufficiently high." msgstr "|PyMuPDFLayoutMode_Valid| ページの中間画像にOCRを適用する際の希望する画像解像度をドット・パー・インチ（DPI）で指定します。デフォルト値は400です。ページがOCRの恩恵を受けると判断された場合（テキストが無いまたは少ない、ページの大部分が画像または文字のようなベクターで覆われているなど）のみ有効です。大きな値を指定するとOCRの精度が向上する可能性がありますが、メモリ要件と処理時間が増加します。また、画像が過度にシャープ化されてOCRの精度が低下するリスクもあります。そのため、デフォルト値はおそらく十分に高い値となっています。" msgid "like `write_images`, but images will be included in the markdown text as base64-encoded strings. Mutually exclusive with `write_images` and ignores `image_path`. This may drastically increase the size of your markdown text." msgstr "``write_images`` と同様ですが、画像はbase64エンコードされた文字列としてマークダウンテキストに含まれます。``write_images`` とは相互排他的であり、``image_path`` は無視されます。これによりマークダウンテキストのサイズが大幅に増加する可能性があります。" msgid "|PyMuPDFLayoutMode_Ignored| a value of `True` enforces `page_chunks=True` and adds key "words" to each page dictionary. Its value is a list of words as delivered by PyMuPDF's `Page` method `get_text("words")`. The sequence of the words in this list is the same as the extracted text." msgstr "|PyMuPDFLayoutMode_Ignored| ``True`` を指定すると ``page_chunks=True`` が強制され、各ページの辞書にキー「words」が追加されます。その値は、PyMuPDFの ``Page`` メソッド ``get_text("words")`` によって提供される単語のリストです。このリスト内の単語の順序は、抽出されたテキストと同じです。**「レイアウトモード」では無視されます。**" msgid "Overwrites or sets the desired image file name of written images. Useful when the document is provided as a memory object (which has no inherent file name)." msgstr "書き込まれる画像の希望するファイル名を上書きまたは設定します。ドキュメントがメモリオブジェクト（固有のファイル名を持たない）として提供される場合に便利です。" msgid "|PyMuPDFLayoutMode_Ignored| limit the font size to consider for text extraction. If the font size is lower than what is set then the text won't be considered for extraction. Default is `3`, meaning only text with a font size `>= 3` will be considered for extraction." msgstr "|PyMuPDFLayoutMode_Ignored| テキスト抽出時に考慮するフォントサイズの下限を設定します。フォントサイズが設定値より小さい場合、そのテキストは抽出対象として考慮されません。デフォルトは ``3`` で、フォントサイズが ``>= 3`` のテキストのみが抽出対象として考慮されます。" msgid "|PyMuPDFLayoutMode_Valid| boolean to switch on/off page footer content. This parameter controls whether to include or omit footer text from all the document pages. Useful if the document has repetitive footer content which doesn't add any value to the overall extraction data. Default is `True` meaning that footer content will be considered." msgstr "|PyMuPDFLayoutMode_Valid| ページフッターの内容を含めるか除外するかを切り替えるブール値です。このパラメータは、ドキュメント全ページのフッターテキストを含めるか省略するかを制御します。ドキュメントに繰り返しのフッター内容があり、全体的な抽出データに価値を追加しない場合に便利です。デフォルトは ``True`` で、フッターの内容が考慮されることを意味します。" msgid "generate text output even when overlapping images / graphics. This text then appears after the respective image." msgstr "画像やグラフィックが重なっている場合でもテキスト出力を生成します。このテキストは該当する画像の後に表示されます。" msgid "|PyMuPDFLayoutMode_Ignored| use this to limit dealing with excess amounts of vector graphics elements. Scientific documents, or pages simulating text via graphics commands may contain tens of thousands of these objects. As vector graphics are analyzed for multiple purposes, runtime may quickly become intolerable. With this parameter, all vector graphics will be ignored if their count exceeds the threshold." msgstr "|PyMuPDFLayoutMode_Ignored| 過剰な量のベクターグラフィック要素への対処を制限するために使用します。科学文書や、グラフィックコマンドでテキストをシミュレートするページには、これらのオブジェクトが数万個含まれている場合があります。ベクターグラフィックは複数の目的で分析されるため、実行時間がすぐに許容できないレベルになる可能性があります。このパラメータを使用すると、ベクターグラフィックの数が閾値を超えた場合、すべてのベクターグラフィックが無視されます。" msgid "|PyMuPDFLayoutMode_Ignored| use this if you want to provide your own header detection logic. This may be a callable or an object having a method named `get_header_id`. It must accept a text span (a span dictionary as contained in :meth:`~.extractDICT`) and a keyword parameter "page" (which is the owning :ref:`Page ` object). It must return a string "" or up to 6 "#" characters followed by 1 space. If omitted (`None`), a full document scan will be performed to find the most popular font sizes and derive header levels based on them. To completely avoid this behavior specify `hdr_info=lambda s, page=None: ""` or `hdr_info=False`." msgstr "|PyMuPDFLayoutMode_Ignored| 独自のヘッダー検出ロジックを提供したい場合に使用します。これは、呼び出し可能オブジェクト、または ``get_header_id`` という名前のメソッドを持つオブジェクトです。テキストスパン（:meth:`~.extractDICT` に含まれるスパン辞書）とキーワードパラメータ「page」（所有する :ref:`Page ` オブジェクト）を受け入れる必要があります。空文字列 "" または最大6個の "#" 文字とその後に続く1つのスペースを返す必要があります。省略した場合（``None``）、ドキュメント全体がスキャンされ、最も一般的なフォントサイズを見つけ、それに基づいてヘッダーレベルが導出されます。この動作を完全に回避するには、``hdr_info=lambda s, page=None: ""`` または ``hdr_info=False`` を指定してください。" msgid "|PyMuPDFLayoutMode_Valid| boolean to switch on/off page header content. This parameter controls whether we want to include or omit the header content from all the document pages. Useful if the document has repetitive header content which doesn't add any value to the overall extraction data. Default is `True` meaning that header content will be considered." msgstr "|PyMuPDFLayoutMode_Valid| ページヘッダーの内容を含めるか除外するかを切り替えるブール値です。このパラメータは、ドキュメント全ページのヘッダー内容を含めるか省略するかを制御します。ドキュメントに繰り返しのヘッダー内容があり、全体的な抽出データに価値を追加しない場合に便利です。デフォルトは ``True`` で、ヘッダーの内容が考慮されることを意味します。" msgid "|PyMuPDFLayoutMode_Ignored| if ``True`` includes text even when completely transparent. Default is ``False``: transparent text will be ignored which usually increases detection accuracy." msgstr "|PyMuPDFLayoutMode_Ignored| ``True`` の場合、完全に透明なテキストも含めます。デフォルトは ``False`` で、透明なテキストは無視され、通常は検出精度が向上します。**「レイアウトモード」では無視されます。**" msgid "if `True` then mono-spaced text lines do not receive special formatting. Code blocks will no longer be generated. This value is set to `True` if `extract_words=True` is used." msgstr "``True`` の場合、等幅テキスト行は特別なフォーマットを受けません。コードブロックは生成されなくなります。``extract_words=True`` が使用される場合、この値は ``True`` に設定されます。" msgid "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard vector graphics on the page. This may help detecting text correctly when pages are very crowded (often the case for documents representing presentation slides). Also speeds up processing time. This automatically prevents table detection." msgstr "|PyMuPDFLayoutMode_Ignored| (v.0.0.20の新機能) ページ上のベクターグラフィックを無視します。ページが非常に混雑している場合（プレゼンテーションスライドを表すドキュメントでよくあるケース）、テキストを正しく検出するのに役立つ可能性があります。また、処理時間も短縮されます。これにより、テーブル検出が自動的に無効になります。" msgid "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard images on the page. This may help detecting text correctly when pages are very crowded (often the case for documents representing presentation slides). Also speeds up processing time." msgstr "|PyMuPDFLayoutMode_Ignored| (v.0.0.20の新機能) ページ上の画像を無視します。ページが非常に混雑している場合（プレゼンテーションスライドを表すドキュメントでよくあるケース）、テキストを正しく検出するのに役立つ可能性があります。また、処理時間も短縮されます。" msgid "specify the desired image format via its extension. Default is "png" (portable network graphics). Another popular format may be "jpg". Possible values are all :ref:`supported output formats `." msgstr "拡張子を使用して希望する画像形式を指定します。デフォルトは「png」（ポータブルネットワークグラフィックス）です。他の一般的な形式としては「jpg」があります。使用可能な値は、すべての :ref:`サポートされている出力形式 ` です。" msgid "store images in this folder. Relevant if `write_images=True`. Default is the path of the script directory." msgstr "このフォルダに画像を保存します。``write_images=True`` の場合に有効です。デフォルトはスクリプトディレクトリのパスです。" msgid "|PyMuPDFLayoutMode_Ignored| this must be a ``0 <= value < 1``. Images are ignored if `width / page.rect.width <= image_size_limit` or `height / page.rect.height <= image_size_limit`. For instance, the default value 0.05 means that to be considered for inclusion, an image's width and height must be larger than 5% of the page's width and height, respectively." msgstr "|PyMuPDFLayoutMode_Ignored| ``0 <= value < 1`` の値である必要があります。``width / page.rect.width <= image_size_limit`` または ``height / page.rect.height <= image_size_limit`` の場合、画像は無視されます。たとえば、デフォルト値の0.05は、画像が含まれる対象として考慮されるには、画像の幅と高さがそれぞれページの幅と高さの5%より大きくなければならないことを意味します。" msgid "|PyMuPDFLayoutMode_Ignored| a float or a sequence of 2 or 4 floats specifying page borders. Only objects inside the margins will be considered for output." msgstr "|PyMuPDFLayoutMode_Ignored| ページの境界を指定する浮動小数点数、または2個もしくは4個の浮動小数点数のシーケンスです。マージン内のオブジェクトのみが出力対象として考慮されます。" msgid "`margin=f` yields `(f, f, f, f)` for `(left, top, right, bottom)`." msgstr "``margin=f`` は ``(left, top, right, bottom)`` に対して ``(f, f, f, f)`` を生成します。" msgid "`(top, bottom)` yields `(0, top, 0, bottom)`." msgstr "``(top, bottom)`` は ``(0, top, 0, bottom)`` を生成します。" msgid "To always read full pages **(default)**, use `margins=0`." msgstr "常にページ全体を読み取る **(デフォルト)** には、``margins=0`` を使用します。" msgid "if `True` the output will be a list of `Document.page_count` dictionaries (one per page). Each dictionary has the following structure:" msgstr "``True`` の場合、出力は ``Document.page_count`` 個の辞書のリスト（ページごとに1つ）になります。各辞書は以下の構造を持ちます:" msgid "**\"metadata\"** - a dictionary consisting of the document's metadata :attr:`Document.metadata`, enriched with additional keys **\"file_path\"** (the file name), **\"page_count\"** (number of pages in document), and **\"page_number\"** (1-based page number)." msgstr "**"metadata"** - ドキュメントのメタデータ :attr:`Document.metadata` から構成される辞書で、追加のキー **"file_path"** （ファイル名）、**"page_count"** （ドキュメント内のページ数）、および **"page_number"** （1ベースのページ番号）で拡張されています。" msgid "**\"toc_items\"** - a list of Table of Contents items pointing to this page. Each item of this list has the format `[lvl, title, pagenumber]`, where `lvl` is the hierarchy level, `title` a string and `pagenumber` as a 1-based page number." msgstr "**"toc_items"** - このページを指す目次項目のリストです。このリストの各項目は ``[lvl, title, pagenumber]`` の形式を持ち、``lvl`` は階層レベル、``title`` は文字列、``pagenumber`` は1ベースのページ番号です。" msgid "**\"tables\"** - a list of tables on this page. Each item is a dictionary with keys \"bbox\", \"row_count\" and \"col_count\". Key \"bbox\" is a `pymupdf.Rect` in tuple format of the table's position on the page." msgstr "**"tables"** - このページ上のテーブルのリストです。各項目は、キー「bbox」、「row_count」、「col_count」を持つ辞書です。キー「bbox」は、ページ上のテーブルの位置を示すタプル形式の ``pymupdf.Rect`` です。" msgid "**\"images\"** - |PyMuPDFLayoutMode_EmptyList| a list of images on the page. This a copy of page method :meth:`Page.get_image_info`." msgstr "**\"images\"** - |PyMuPDFLayoutMode_EmptyList| ページ上の画像のリストです。これは、ページメソッド :meth:`Page.get_image_info` のコピーです。" msgid "**\"graphics\"** - |PyMuPDFLayoutMode_EmptyList| a list of vector graphics rectangles on the page. This is a list of boundary boxes of clustered vector graphics as delivered by method :meth:`Page.cluster_drawings`." msgstr "**\"graphics\"** - |PyMuPDFLayoutMode_EmptyList| ページ上のベクターグラフィック矩形のリストです。これは、メソッド :meth:`Page.cluster_drawings` によって提供されるクラスタ化されたベクターグラフィックのバウンディングボックスのリストです。" msgid "**\"text\"** - page content as |Markdown| text." msgstr "**\"text\"** - |Markdown| テキストとしてのページ内容です。" msgid "**\"words\"** - |PyMuPDFLayoutMode_EmptyList| if `extract_words=True` was used. This is a list of tuples `(x0, y0, x1, y1, \"wordstring\", bno, lno, wno)` as delivered by `page.get_text(\"words\")`. The **sequence** of these tuples however is the same as produced in the markdown text string and thus honors multi-column text. This is also true for text in tables: words are extracted in the sequence of table row cells." msgstr "**\"words\"** - |PyMuPDFLayoutMode_EmptyList| ``extract_words=True`` が使用された場合に含まれます。これは、``page.get_text("words")`` によって提供されるタプル ``(x0, y0, x1, y1, "wordstring", bno, lno, wno)`` のリストです。ただし、これらのタプルの **順序** はマークダウンテキスト文字列で生成される順序と同じであり、したがってマルチカラムテキストを尊重します。これはテーブル内のテキストにも当てはまります。単語はテーブル行のセルの順序で抽出されます。" msgid "specify a desired page height. For relevance see the `page_width` parameter. If using the default `None`, the document will appear as one large page with a width of `page_width`. Consequently in this case, no markdown page separators will occur (except the final one), respectively only one page chunk will be returned." msgstr "希望するページの高さを指定します。関連性については ``page_width`` パラメータを参照してください。デフォルトの ``None`` を使用する場合、ドキュメントは ``page_width`` の幅を持つ1つの大きなページとして表示されます。したがって、この場合、マークダウンページ区切り文字は発生せず（最後のものを除く）、それぞれ1つのページチャンクのみが返されます。" msgid "if ``True`` inserts a string ``--- end of page=n ---`` at the end of each page output. Intended for debugging purposes. The page number is 0-based. The separator string is wrapped with line breaks. Default is ``False``." msgstr "``True`` の場合、各ページ出力の最後に文字列 ``--- end of page=n ---`` を挿入します。デバッグ目的を想定しています。ページ番号は0ベースです。区切り文字列は改行で囲まれます。デフォルトは ``False`` です。" msgid "specify a desired page width. This is ignored for documents with a fixed page width like PDF, XPS etc. **Reflowable** documents however, like e-books, office [#f2]_ or text files have no fixed page dimensions. They by default are assumed to have Letter format width (612) and an **unlimited** page height. This means that the **full document is treated as one large page.**" msgstr "希望するページの幅を指定します。PDF、XPSなどの固定ページ幅を持つドキュメントでは無視されます。しかし、電子書籍、オフィス [#f2]_ ファイル、テキストファイルなどの **リフロー可能な** ドキュメントには固定のページサイズがありません。これらはデフォルトでレター形式の幅（612）と **無制限の** ページの高さを持つと見なされます。これは、**ドキュメント全体が1つの大きなページとして扱われる** ことを意味します。" msgid "optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Any Python sequence with integer items is accepted. The sequence is sorted and processed to only contain unique items." msgstr "オプションで、出力対象として考慮するページを指定します（注意:0ベースのページ番号を指定してください）。省略した場合（``None``）、すべてのページが処理されます。整数項目を持つ任意のPythonシーケンスが受け入れられます。シーケンスはソートされ、一意の項目のみを含むように処理されます。" msgid "Default is `False`. A value of `True` displays a progress bar as pages are being converted. Package `tqdm `_ is used if installed, otherwise the built-in text based progress bar is used." msgstr "デフォルトは ``False`` です。``True`` を指定すると、ページが変換される際に進捗バーが表示されます。インストールされている場合はパッケージ `tqdm `_ が使用され、それ以外の場合は組み込みのテキストベースの進捗バーが使用されます。" msgid "|PyMuPDFLayoutMode_Ignored| see: :meth:`table detection strategy `. Default is `"lines_strict"` which ignores background colors. In some occasions, other strategies may be more successful, for example `"lines"` which uses all vector graphics objects for detection." msgstr "|PyMuPDFLayoutMode_Ignored| 参照: :meth:`テーブル検出戦略 `。デフォルトは ``"lines_strict"`` で、背景色を無視します。状況によっては、他の戦略がより成功する場合があります。たとえば、すべてのベクターグラフィックオブジェクトを検出に使用する ``"lines"`` などです。" msgid "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.19) Default is `False`. A value of `True` will use the glyph number of the characters instead of the character itself if the font does not store the Unicode value." msgstr "|PyMuPDFLayoutMode_Ignored| (v.0.0.19の新機能) デフォルトは ``False`` です。``True`` を指定すると、フォントがUnicode値を保存していない場合、文字自体の代わりに文字のグリフ番号が使用されます。" msgid "when encountering images or vector graphics, images will be created from the respective page area and stored in the specified folder. |Markdown| references will be generated pointing to these images. Any text contained in these areas will not be included in the text output (but appear as part of the images). Therefore, if for instance your document has text written on full page images, make sure to set this parameter to `False`." msgstr "画像またはベクターグラフィックに遭遇した場合、該当するページ領域から画像が作成され、指定されたフォルダに保存されます。これらの画像を指す |Markdown| 参照が生成されます。これらの領域に含まれるテキストは、テキスト出力には含まれません（ただし、画像の一部として表示されます）。したがって、たとえば、ドキュメントにフルページ画像上に書かれたテキストがある場合は、このパラメータを ``False`` に設定してください。" msgid "If using :ref:`PyMuPDF Layout `, boundary boxes that are classified as "picture" by the layout module will be treated as images - independent from the mixture of text, images or vector graphics they may be covering. If `force_text=True` is used, text will still be extracted from these areas and included in the output after the respective image reference." msgstr ":ref:`PyMuPDF Layout ` を使用する場合、レイアウトモジュールによって「picture」として分類されたバウンディングボックスは、テキスト、画像、またはベクターグラフィックの混在に関係なく、画像として扱われます。``force_text=True`` が使用された場合、これらの領域からテキストが抽出され、該当する画像参照の後に出力に含まれます。" msgid "Either a string of the combined text of all selected document pages, or a list of dictionaries if `page_chunks=True`." msgstr "選択されたすべてのドキュメントページの結合されたテキストの文字列、または ``page_chunks=True`` の場合は辞書のリストです。" msgid "Reads the pages of the file and outputs the text of its pages in |TXT| format." msgstr "ファイルのページを読み取り、各ページのテキストを |TXT| 形式で出力します。" msgid "|PyMuPDFLayoutMode_Valid|. This method is only available with PyMuPDF Layout." msgstr "|PyMuPDFLayoutMode_Valid| このメソッドは「レイアウトモード」でのみ利用可能です。つまり、pymupdf4llmのインポートが ``import pymupdf.layout`` ステートメントの **後に** 行われた場合のみです。" msgid "the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`." msgstr "ファイルは、ファイルパス文字列、または |PyMuPDF| :class:`Document` (``pymupdf.open`` で作成) のいずれかで指定します。``pathlib.Path`` 指定、Pythonファイル風オブジェクト、メモリ内ドキュメントなどを使用する場合は、|PyMuPDF| :class:`Document` を **必ず** 使用してください。" msgid "boolean to switch on/off page header content. This parameter controls whether to include or omit the header content from all the document pages. Useful if the document has repetitive header content which doesn't add any value to the overall extraction data. Default is `True` meaning that header content will be written." msgstr "ページヘッダーの内容を含めるか除外するかを切り替えるブール値です。このパラメータは、ドキュメント全ページのヘッダー内容を含めるか省略するかを制御します。ドキュメントに繰り返しのヘッダー内容があり、全体的な抽出データに価値を追加しない場合に便利です。デフォルトは ``True`` で、ヘッダーの内容が出力されることを意味します。" msgid "boolean to switch on/off page footer content. This parameter controls whether to include or omit the footer content from all the document pages. Useful if the document has repetitive footer content which doesn't add any value to the overall extraction data. Default is `True` meaning that footer content will be written." msgstr "ページフッターの内容を含めるか除外するかを切り替えるブール値です。このパラメータは、ドキュメント全ページのフッター内容を含めるか省略するかを制御します。ドキュメントに繰り返しのフッター内容があり、全体的な抽出データに価値を追加しない場合に便利です。デフォルトは ``True`` で、フッターの内容が出力されることを意味します。" msgid "if `True` then mono-spaced text lines do not receive special formatting. No blocks will be written and text lines will be written continuously." msgstr "``True`` の場合、等幅テキスト行は特別なフォーマットを受けません。ブロックは書き込まれず、テキスト行は連続して書き込まれます。" msgid "optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Any Python sequence with integer items is accepted. The sequence is sorted and processed to only contain unique items." msgstr "オプションで、出力対象として考慮するページを指定します（注意:0ベースのページ番号を指定してください）。省略した場合（``None``）、すべてのページが処理されます。整数項目を持つ任意のPythonシーケンスが受け入れられます。シーケンスはソートされ、一意の項目のみを含むように処理されます。" msgid "generate text output also when overlapping images / graphics. This text then appears after the respective image reference. Images (i.e. \"picture\" areas) however will not be written to the text output but appear as a text line in the output like `==> picture [width x height] <==`." msgstr "画像やグラフィックが重なっている場合でもテキスト出力を生成します。このテキストは該当する画像参照の後に表示されます。ただし、画像（つまり「picture」領域）はテキスト出力には書き込まれず、``==> picture [width x height] <==`` のようなテキスト行として出力に表示されます。" msgid "Default is `False`. A value of `True` displays a progress bar as pages are being converted. Package `tqdm `_ is used if installed, otherwise the built-in text based progress bar is used." msgstr "デフォルトは ``False`` です。``True`` を指定すると、ページが変換される際に進捗バーが表示されます。インストールされている場合はパッケージ `tqdm `_ が使用され、それ以外の場合は組み込みのテキストベースの進捗バーが使用されます。" msgid "Parses the document and the specified pages and converts the result into a |JSON|-formatted string." msgstr "ドキュメントと指定されたページを解析し、結果を |JSON| 形式の文字列に変換します。" msgid "the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`." msgstr "ファイルは、ファイルパス文字列、または |PyMuPDF| :class:`Document` (``pymupdf.open`` で作成) のいずれかで指定します。``pathlib.Path`` 指定、Pythonファイル風オブジェクト、メモリ内ドキュメントなどを使用する場合は、|PyMuPDF| :class:`Document` を **必ず** 使用してください。" msgid "specify the desired image resolution in dots per inch. Default value is 150. Only relevant if one of the parameters `write_images=True` or `embed_images=True` is used." msgstr "希望する画像解像度をドット・パー・インチ（DPI）で指定します。デフォルト値は150です。``write_images=True`` または ``embed_images=True`` のいずれかのパラメータが使用される場合にのみ有効です。" msgid "specify the desired image format via its extension. Default is \"png\" (portable network graphics). Another popular format may be \"jpg\". Possible values are all :ref:`supported output formats `. Only relevant if one of the parameters `write_images=True` or `embed_images=True` is used." msgstr "拡張子を使用して希望する画像形式を指定します。デフォルトは「png」（ポータブルネットワークグラフィックス）です。他の一般的な形式としては「jpg」があります。使用可能な値は、すべての :ref:`サポートされている出力形式 ` です。``write_images=True`` または ``embed_images=True`` のいずれかのパラメータが使用される場合にのみ有効です。" msgid "store images in this folder. Relevant if `write_images=True`. Default is the path of the script directory. Page areas classified as \"picture\" will be written as image files to the specified location. The image file names will be of the format `{image_path}/{filename}-pagenumber-image_number.{image_format}`." msgstr "このフォルダに画像を保存します。``write_images=True`` の場合に有効です。デフォルトはスクリプトディレクトリのパスです。「picture」として分類されたページ領域は、指定された場所に画像ファイルとして書き込まれます。画像ファイル名は ``{image_path}/{filename}-pagenumber-image_number.{image_format}`` の形式になります。" msgid "generate text output for text that is written upon areas that are classified as \"picture\" by the layout module. This may be especially be useful when picture content is not stored." msgstr "レイアウトモジュールによって「picture」として分類された領域上に書かれたテキストのテキスト出力を生成します。これは、画像内容が保存されない場合に特に便利です。" msgid "display a progress bar during processing." msgstr "処理中に進捗バーを表示します。" msgid "store image binaries for \"picture\" boundary boxes. Base64-encoded images are included in the JSON output. Ignores `image_path` if used. This may drastically increase the size of your JSON text." msgstr "「picture」バウンディングボックスの画像バイナリを保存します。Base64エンコードされた画像がJSON出力に含まれます。使用された場合、``image_path`` は無視されます。これによりJSONテキストのサイズが大幅に増加する可能性があります。" msgid "store image files \"picture\" boundary boxes.when encountering images, image files will be created from the respective page area and stored in the specified folder. Any text contained in these areas will still be included in the text output." msgstr "「picture」バウンディングボックスの画像ファイルを保存します。画像に遭遇した場合、該当するページ領域から画像ファイルが作成され、指定されたフォルダに保存されます。これらの領域に含まれるテキストは、引き続きテキスト出力に含まれます。" msgid "optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Specify any valid Python sequence containing integers between `0` and `page_count - 1`." msgstr "オプションで、出力対象として考慮するページを指定します（注意:0ベースのページ番号を指定してください）。省略した場合（``None``）、すべてのページが処理されます。``0`` から ``page_count - 1`` の間の整数を含む任意の有効なPythonシーケンスを指定してください。" msgid "Please see `this site `_ for more background and the current status of further improvements regarding usage with :ref:`PyMuPDF Layout `." msgstr "レイアウトモードに関する更なる改善の背景と現状については、`このサイト `_ をご覧ください。" msgid "Create a `pdf_markdown_reader.PDFMarkdownReader` using the `LlamaIndex`_ package. Please note that this package will **not automatically be installed** when installing **pymupdf4llm**." msgstr "`LlamaIndex`_ パッケージを使用して ``pdf_markdown_reader.PDFMarkdownReader`` を作成します。このパッケージは **pymupdf4llm** をインストールする際に **自動的にインストールされない** ことに注意してください。" msgid "For details on the possible arguments, please consult the LlamaIndex documentation [#f1]_." msgstr "可能な引数の詳細については、LlamaIndexのドキュメント [#f1]_ を参照してください。" msgid "`NotImplementedError`: Please install required `LlamaIndex`_ package." msgstr "``NotImplementedError``: 必要な `LlamaIndex`_ パッケージをインストールしてください。" msgid "a `pdf_markdown_reader.PDFMarkdownReader` and issues message "Successfully imported LlamaIndex". Please note that this method needs several seconds to execute. For details on using the markdown reader please see below." msgstr "``pdf_markdown_reader.PDFMarkdownReader`` と、メッセージ「Successfully imported LlamaIndex」を返します。このメソッドの実行には数秒かかることに注意してください。マークダウンリーダーの使用方法の詳細については、以下を参照してください。" msgid "This class is not available in \"layout mode\", i.e. if the import of pymupdf4llm has happened **after** the statement ``import pymupdf.layout``." msgstr "このクラスは「レイアウトモード」では利用できません。つまり、pymupdf4llmのインポートが ``import pymupdf.layout`` ステートメントの **後に** 行われた場合は利用できません。" msgid "Create an object which maps text font sizes to the respective number of '#' characters which are used by Markdown syntax to indicate header levels. The object is created by scanning the document for font size \"popularity\". The most popular font size and all smaller sizes are used for body text. Larger font sizes are mapped to the respective header levels - which correspond to the HTML tags `

` to `

`." msgstr "テキストフォントサイズをマークダウン構文でヘッダーレベルを示すために使用される '#' 文字の数にマッピングするオブジェクトを作成します。このオブジェクトは、ドキュメントをスキャンしてフォントサイズの「人気度」を調べることで作成されます。最も一般的なフォントサイズとそれより小さいすべてのサイズは本文テキストに使用されます。より大きいフォントサイズは、それぞれのヘッダーレベル（HTMLタグ ``

`` から ``

`` に対応）にマッピングされます。" msgid "All font sizes are rounded to integer values." msgstr "すべてのフォントサイズは整数値に丸められます。" msgid "If more than 6 header levels would be required, then the largest number smaller than the `
` font size is used for body text." msgstr "6つを超えるヘッダーレベルが必要な場合、``
`` フォントサイズより小さい最大の数値が本文テキストに使用されます。" msgid "Please note that creating the object will read and inspect the text of the entire document - independently of reading the document again in the `to_markdown()` method subsequently. Method `to_markdown()` by default **will create this object** if you do not override its `hdr_info=None` parameter." msgstr "オブジェクトの作成は、その後 ``to_markdown()`` メソッドでドキュメントを再度読み取ることとは独立して、ドキュメント全体のテキストを読み取って検査することに注意してください。``to_markdown()`` メソッドは、``hdr_info=None`` パラメータを上書きしない場合、デフォルトで **このオブジェクトを作成します**。" msgid "the file, to be specified either as a file path string, or as a |PyMuPDF| Document (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| Document." msgstr "ファイルは、ファイルパス文字列、または |PyMuPDF| Document (``pymupdf.open`` で作成) のいずれかで指定します。``pathlib.Path`` 指定、Pythonファイル風オブジェクト、メモリ内ドキュメントなどを使用する場合は、|PyMuPDF| Document を **必ず** 使用してください。" msgid "optional, the pages to consider. If omitted all pages are processed." msgstr "オプションで、考慮するページを指定します。省略した場合、すべてのページが処理されます。" msgid "the default font size limit for body text. Only used when the document scan does not deliver valid information." msgstr "本文テキストのデフォルトのフォントサイズ下限です。ドキュメントスキャンが有効な情報を提供しない場合にのみ使用されます。" msgid "the maximum number of header levels to be used. Valid values are in `range(1, 7)`. The default is 6, which corresponds to the HTML tags `

` to `

`. A smaller value will limit the number of generated header levels. For instance, a value of 3 will only generate header tags \"#\", \"##\" and \"###\". Body text will be assumed for all font sizes smaller than the one corresponding to \"###\"." msgstr "使用する最大ヘッダーレベル数です。有効な値は ``range(1, 7)`` 内です。デフォルトは6で、HTMLタグ ``

`` から ``

`` に対応します。より小さい値を指定すると、生成されるヘッダーレベルの数が制限されます。たとえば、値3を指定すると、ヘッダータグ「#」、「##」、「###」のみが生成されます。「###」に対応するフォントサイズより小さいすべてのフォントサイズは本文テキストと見なされます。" msgid "Return appropriate markdown header prefix. This is either \"\" or a string of \"#\" characters followed by a space." msgstr "適切なマークダウンヘッダープレフィックスを返します。これは空文字列 ``""``、または「#」文字列とそれに続くスペースのいずれかです。" msgid "Given a text span from a \"dict\" extraction, determine the markdown header prefix string of 0 to n concatenated '#' characters." msgstr "「dict」抽出からのテキストスパンを指定すると、0からn個の連結された「#」文字からなるマークダウンヘッダープレフィックス文字列を決定します。" msgid "a dictionary containing the text span information. This is the same dictionary as returned by `page.get_text(\"dict\")`." msgstr "テキストスパン情報を含む辞書です。これは ``page.get_text("dict")`` によって返される辞書と同じものです。" msgid "the owning page object. This can be used when additional information needs to be extracted." msgstr "所有するページオブジェクトです。追加情報を抽出する必要がある場合に使用できます。" msgid "a string of \"#\" characters followed by a space." msgstr "「#」文字列とそれに続くスペースです。" msgid "A dictionary mapping (integer) font sizes to Markdown header strings like ``{14: '# ', 12: '## '}``. The dictionary is created by the :class:`IdentifyHeaders` constructor. The keys are the font sizes of the text spans in the document. The values are the respective header strings." msgstr "整数のフォントサイズを ``{14: '# ', 12: '## '}`` のようなマークダウンヘッダー文字列にマッピングする辞書です。この辞書は :class:`IdentifyHeaders` コンストラクタによって作成されます。キーはドキュメント内のテキストスパンのフォントサイズです。値はそれぞれのヘッダー文字列です。" msgid "An integer value indicating the font size limit for body text. This is computed as ``min(header_id.keys()) - 1``. In the above example, body_limit would be 11." msgstr "本文テキストのフォントサイズ下限を示す整数値です。これは ``min(header_id.keys()) - 1`` として計算されます。上記の例では、body_limitは11になります。" msgid "**How to limit header levels (example)**" msgstr "**ヘッダーレベルを制限する方法（例）**" msgid "Limit the generated header levels to 3::" msgstr "生成されるヘッダーレベルを3に制限します::" msgid "**How to provide your own header logic (example 1)**" msgstr "**独自のヘッダーロジックを提供する方法（例1）**" msgid "Provide your own function which uses pre-determined, fixed font sizes::" msgstr "事前に決定された固定のフォントサイズを使用する独自の関数を提供します::" msgid "**How to provide your own header logic (example 2)**" msgstr "**独自のヘッダーロジックを提供する方法（例2）**" msgid "This user function uses the document's Table of Contents -- under the assumption that the bookmark text is also present as a header line on the page (which certainly need not be the case!)::" msgstr "このユーザー関数はドキュメントの目次を使用します。ブックマークテキストがヘッダー行としてページ上にも存在することを前提としています（これは必ずしもそうであるとは限りません！）::" msgid "Create an object which uses the document's Table of Contents (TOC) to determine header levels. Upon object creation, the table of contents is read via the `Document.get_toc()` method. The TOC data is then used to determine header levels in the `to_markdown()` method." msgstr "ドキュメントの目次（TOC）を使用してヘッダーレベルを決定するオブジェクトを作成します。オブジェクト作成時に、``Document.get_toc()`` メソッドを介して目次が読み取られます。その後、TOCデータは ``to_markdown()`` メソッドでヘッダーレベルを決定するために使用されます。" msgid "This is an alternative to :class:`IdentifyHeaders`. Instead of running through the full document to identify font sizes, it uses the document's Table Of Contents (TOC) to identify headers on pages. Like :class:`IdentifyHeaders`, this also is no guarantee to find headers, but for well-built Table of Contents, there is a good chance for more correctly identifying header lines on document pages than the font-size-based approach." msgstr "これは :class:`IdentifyHeaders` の代替手段です。フォントサイズを識別するためにドキュメント全体を実行する代わりに、ドキュメントの目次（TOC）を使用してページ上のヘッダーを識別します。:class:`IdentifyHeaders` と同様に、これもヘッダーを見つけることを保証するものではありませんが、適切に構築された目次の場合、フォントサイズベースのアプローチよりもドキュメントページ上のヘッダー行をより正確に識別できる可能性が高くなります。" msgid "It also has the advantage of being much faster than the font-size-based approach, as it does not execute a full document scan or even access any of the document pages." msgstr "また、ドキュメント全体のスキャンを実行したり、ドキュメントページにアクセスしたりしないため、フォントサイズベースのアプローチよりもはるかに高速であるという利点もあります。" msgid "Examples where this approach works very well are the Adobe's files on PDF documentation." msgstr "このアプローチが非常にうまく機能する例としては、AdobeのPDFドキュメントに関するファイルがあります。" msgid "Please note that this feature **does not read document pages** where the table of contents may exist as normal standard text. It only accesses data as provided by the `Document.get_toc()` method. It will not identify any headers for documents where the table of contents is not available as a collection of bookmarks." msgstr "この機能は、目次が通常の標準テキストとして存在する可能性のある **ドキュメントページを読み取りません**。``Document.get_toc()`` メソッドによって提供されるデータにのみアクセスします。目次がブックマークのコレクションとして利用できないドキュメントの場合、ヘッダーを識別しません。" msgid "Return appropriate markdown header prefix. This is either an empty string or a string of \"#\" characters followed by a space." msgstr "適切なマークダウンヘッダープレフィックスを返します。これは空文字列、または「#」文字列とそれに続くスペースのいずれかです。" msgid "Given a text span from a \"dict\" extraction variant, determine the markdown header prefix string of 0 to n concatenated \"#\" characters." msgstr "「dict」抽出バリアントからのテキストスパンを指定すると、0からn個の連結された「#」文字からなるマークダウンヘッダープレフィックス文字列を決定します。" msgid "a dictionary containing the text span information. This is the same dictionary as returned by `page.get_text(\"dict\")`." msgstr "テキストスパン情報を含む辞書です。これは ``page.get_text("dict")`` によって返される辞書と同じものです。" msgid "the owning page object. This can be used when additional information needs to be extracted." msgstr "テキストスパン情報を含む辞書です。これは ``page.get_text("dict")`` によって返される辞書と同じものです。" msgid "a string of \"#\" characters followed by a space." msgstr "「#」文字列とそれに続くスペースです。" msgid "**How to use class TocHeaders**" msgstr "**TocHeaders クラスの使用方法**" msgid "This is a version of previous **example 2** that uses :class:`TocHeaders` for header identification::" msgstr "これは、ヘッダー識別に :class:`TocHeaders` を使用する以前の **例2** のバージョンです" msgid "This is the only method of the markdown reader you should currently use to extract markdown data. Please in any case ignore methods `aload_data()` and `lazy_load_data()`. Other methods like `use_doc_meta()` may or may not make sense. For more information, please consult the LlamaIndex documentation [#f1]_." msgstr "これは、マークダウンデータを抽出するために現在使用すべきマークダウンリーダーの唯一のメソッドです。いかなる場合でも、``aload_data()`` および ``lazy_load_data()`` メソッドは無視してください。``use_doc_meta()`` などの他のメソッドは、意味がある場合とない場合があります。詳細については、LlamaIndexのドキュメント [#f1]_ を参照してください。" msgid "Under the hood the method will execute `to_markdown()`." msgstr "内部的には、このメソッドは ``to_markdown()`` を実行します。" msgid "a list of `LlamaIndexDocument` documents - one for each page." msgstr "``LlamaIndexDocument`` ドキュメントのリストです。ページごとに1つです。" msgid "For a list of changes, please see file `CHANGES.md `_." msgstr "変更点の一覧については、ファイル `CHANGES.md `_ を参照してください。" msgid "`LlamaIndex documentation `_" msgstr "`LlamaIndexドキュメント `_" msgid "When using PyMuPDF-Pro, supported office documents are converted internally into a PDF-like format. Therefore, they **will have fixed page dimensions** and be no longer "reflowable". Consequently, the page width and page height specifications will be ignored as well in these cases." msgstr "PyMuPDF-Proを使用する場合、サポートされているオフィスドキュメントは内部的にPDF形式に変換されます。したがって、これらは **固定のページサイズを持ち**、「リフロー可能」ではなくなります。その結果、これらの場合はページ幅とページ高さの指定も無視されます。" msgid "Footnotes" msgstr "脚注" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pymupdf4llm/index.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-26 17:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d999746961f541d091c04253454c2495 msgid "Artifex" msgstr "" #: ../../header.rst:-1 942f0462179c4c28a52bfb5b4819a15a msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" #: ../../header.rst:-1 cc1a6ef974e74b6299fc9df6b833ae6d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" #: ../../pymupdf4llm/index.rst:8 96b9f29894ff49beba7a07931c5c900d msgid "PyMuPDF4LLM" msgstr "" #: ../../pymupdf4llm/index.rst:10 59d6714b7f6549e0a52c173974da2135 msgid "" "|PyMuPDF4LLM| is aimed to make it easier to extract |PDF| content in the " "format you need for **LLM** & **RAG** environments. It supports " ":ref:`Markdown extraction ` as well as :ref:`LlamaIndex" " document output `." msgstr "" "|PyMuPDF4LLM| は、**LLM** や **RAG** 環境で必要な形式で |PDF| " "コンテンツを簡単に抽出できるようにすることを目的としています。 **Markdown** 形式での抽出や、 **LlamaIndex** " "ドキュメント出力もサポートしています。" #: ../../pymupdf4llm/index.rst:12 8b36d59c925f4a0d93873eeab7e4843a msgid "" "When using |PyMuPDF4LLM| with PyMuPDF-Layout, page layout detection will " "be greatly improved. This is true for table detection, but also for the " "detection of page headers and footers, footnotes, list items and text " "paragraphs. In addition two new methods become available, `to_json()` and" " `to_text()`." msgstr "PyMuPDF4LLM を PyMuPDF-Layout と併用すると、ページレイアウト検出が大幅に改善されます。これは表の検出だけでなく、ページヘッダーとフッター、脚注、リスト項目、テキスト段落の検出にも当てはまります。さらに、`to_json()` と `to_text()` という2つの新しいメソッドが利用可能になります。" #: ../../pymupdf4llm/index.rst:16 50bf080e50e64ba58e973f0addf24d73 msgid "" "You can extend the supported file types to also include **Office** " "document formats (DOC/DOCX, XLS/XLSX, PPT/PPTX, HWP/HWPX) by :ref:`using " "PyMuPDF Pro with PyMuPDF4LLM `." msgstr "" ":ref:`PyMuPDF ProをPyMuPDF4LLMと併用することで " "`、対応するファイル形式を拡張し、 **Office** " "ドキュメント形式（DOC/DOCX、XLS/XLSX、PPT/PPTX、HWP/HWPX）も含めることができます。" #: ../../pymupdf4llm/index.rst:19 38428359cdaf4039b439454f5c712ec7 msgid "Features" msgstr "特徴" #: ../../pymupdf4llm/index.rst:21 5f4fb197fcdd4a0ab3ac79607a78a25e msgid "Support for multi-column pages" msgstr "マルチカラムページのサポート" #: ../../pymupdf4llm/index.rst:22 7e249663241a4aacb2f9b1fcb4450393 msgid "" "Support for image and vector graphics extraction (and inclusion of " "references in the MD text)" msgstr "画像およびベクターグラフィックスの抽出のサポート（MDテキストへの参照の挿入を含む）" #: ../../pymupdf4llm/index.rst:23 cf659dc9b2da48d69e7ab3d1cda7f132 msgid "Support for page chunking output." msgstr "ページ分割出力のサポート" #: ../../pymupdf4llm/index.rst:24 20715d6347fb42b7b485fba224287741 msgid "" "Direct support for output as :ref:`LlamaIndex Documents " "`." msgstr ":ref:`LlamaIndexドキュメント ` としての直接出力のサポート" #: ../../pymupdf4llm/index.rst:25 ed7f233894d54e93aca9c1f33a896476 msgid "In \"layout mode\": Support for plain text output similar to Markdown" msgstr "「レイアウトモード」: Markdown と同様のプレーンテキスト出力のサポート" #: ../../pymupdf4llm/index.rst:26 e29cc03c8f6f40be974a1f9262165c9c msgid "In \"layout mode\": Support for JSON output" msgstr "「レイアウトモード」: JSON 出力のサポート" #: ../../pymupdf4llm/index.rst:30 90f6c12aacd14b7eba944b6c1e013ed5 msgid "Functionality" msgstr "機能" #: ../../pymupdf4llm/index.rst:32 e63a722974dc41f3928dc372e66da5c0 msgid "" "This package converts the pages of a file to text in **Markdown** format " "using |PyMuPDF|." msgstr "このパッケージは、|PyMuPDF| を使用して |PDF| のページを **Markdown** 形式のテキストに変換します。" #: ../../pymupdf4llm/index.rst:34 1504c800279e44568bfbbeef3eb2ba6d msgid "" "Standard text and tables are detected, brought in the right reading " "sequence and then together converted to **GitHub**-compatible " "**Markdown** text." msgstr "" "標準のテキストやテーブルが検出され、適切な読み取り順序で取り込まれ、その後一緒に **GitHub** 互換の **Markdown** " "テキストに変換されます。" #: ../../pymupdf4llm/index.rst:36 4d3e28d4b9654f6889e99f25edeafb6f msgid "" "Header lines are identified via the font size and appropriately prefixed " "with one or more `#` tags." msgstr "ヘッダー行はフォントサイズで識別され、適切に1つまたは複数の＃タグで接頭語が付けられます。" #: ../../pymupdf4llm/index.rst:38 d3dc9c01915e4fd5a47c1784eae70c00 msgid "" "Bold, italic, mono-spaced text and code blocks are detected and formatted" " accordingly. Similar applies to ordered and unordered lists." msgstr "太字、斜体、等幅テキスト、およびコードブロックが検出され、それに応じて書式が付けられます。順序付けられたリストと順不同リストにも同様のことが適用されます。" #: ../../pymupdf4llm/index.rst:40 bc9f92950b5b4c038ed82153c462a0c6 msgid "" "By default, all document pages are processed. If desired, a subset of " "pages can be specified by providing a list of `0`-based page numbers." msgstr "デフォルトでは、すべての文書ページが処理されます。必要に応じて、`0` から始まるページ番号のリストを指定してサブセットのページを指定できます。" #: ../../pymupdf4llm/index.rst:44 24714fd3cb744a908099e19f1af6ce7e msgid "Installation" msgstr "インストール" #: ../../pymupdf4llm/index.rst:47 dd73904df42146e18551936620e44355 msgid "Install the package via **pip** with:" msgstr "パッケージを **pip** を使用してインストールするには、次のコマンドを使用します:" #: ../../pymupdf4llm/index.rst:58 a08840e778fe46379ec9110ad3c3608a msgid "Extracting a file as **Markdown**" msgstr "ファイルをMarkdown形式で抽出する" #: ../../pymupdf4llm/index.rst:60 98c0760b58c04cbeb1299faf5b79ab3f msgid "" "To retrieve your document content in **Markdown** simply install the " "package and then use a couple of lines of **Python** code to get results." msgstr "" "ドキュメントの内容を **Markdown** で取得するには、パッケージをインストールし、数行の **Python** " "コードを使用するだけで結果を得ることができます。" #: ../../pymupdf4llm/index.rst:64 6a398956ca7f4c9c9057734393a79743 msgid "Then in your **Python** script do:" msgstr "**Python** スクリプトでは:" #: ../../pymupdf4llm/index.rst:75 b227684a017d42e8b88f83ad2a3c673e msgid "" "Instead of the filename string as above, one can also provide a " ":ref:`PyMuPDF Document `. A second parameter may be a list of " "`0`-based page numbers, e.g. `[0, 1]` would just select the first and " "second pages of the document." msgstr "上記のファイル名文字列の代わりに、:ref:`PyMuPDF Document ` を提供することもできます。2番目のパラメータは、0ベースのページ番号のリストである可能性があります。例えば、[0, 1] はドキュメントの最初と2番目のページのみを選択します。" #: ../../pymupdf4llm/index.rst:78 a0929decafbc41cb86a00b46905219e0 msgid "" "If you want to store your **Markdown** file, e.g. store as a UTF8-encoded" " file, then do:" msgstr "**Markdown** ファイルを保存したい場合、例えばUTF8でエンコードされたファイルとして保存する場合は、次のようにします。" #: ../../pymupdf4llm/index.rst:91 fe47c11343ec4d278c9f9cc524bccb86 msgid "Extracting a file as a **LlamaIndex** document" msgstr "ファイルをLlamaIndexドキュメントとして抽出する" #: ../../pymupdf4llm/index.rst:93 6834228bb5524c319b8c3d5dbe8138d6 msgid "" "|PyMuPDF4LLM| supports direct conversion to a **LLamaIndex** document. A " "document is first converted into **Markdown** format and then a " "**LlamaIndex** document is returned as follows:" msgstr "" "|PyMuPDF4LLM| は **LlamaIndex** ドキュメントへの直接変換をサポートしています。ドキュメントはまず " "**Markdown** 形式に変換され、その後、以下のように **LlamaIndex** ドキュメントとして返されます。" #: ../../pymupdf4llm/index.rst:107 e653025ecf1948759d96b33b7902c524 msgid "Using with |PyMuPDF Pro|" msgstr "PyMuPDF Proとの使用 " #: ../../pymupdf4llm/index.rst:110 9e877b4bd26d43cbaf81821091d51a1b msgid "" "For **Office** document support, |PyMuPDF4LLM| works seamlessly with " "|PyMuPDF Pro|. Assuming you have :doc:`../pymupdf-pro` installed you will" " be able to work with **Office** documents as expected:" msgstr "" "**Office** ドキュメントのサポートのために、|PyMuPDF4LLM| は |PyMuPDF Pro| " "とシームレスに動作します。:doc:`../pymupdf-pro` がインストールされている場合、期待通りに **Office** " "ドキュメントを操作できます。" #: ../../pymupdf4llm/index.rst:121 ff1a10504dbe4b5381a2f6232a21b346 msgid "" "As you can see |PyMuPDF Pro| functionality will be available within the " "|PyMuPDF4LLM| context!" msgstr "ご覧のとおり、|PyMuPDF Pro| の機能は |PyMuPDF4LLM| のコンテキスト内で利用可能になります！" #: ../../pymupdf4llm/index.rst:126 32a7f061e08e4a6ca0f4f3fddb070669 msgid "API" msgstr "" #: ../../pymupdf4llm/index.rst:128 b4ebede9414d489da467192cd788038a msgid "See :ref:`the PyMuPDF4LLM API `." msgstr ":ref:`PyMuPDF4LLM API ` をご覧ください。" #: ../../pymupdf4llm/index.rst:131 bb3e7108ffa0474c9130db24bde17039 msgid "Further Resources" msgstr "追加リソース" #: ../../pymupdf4llm/index.rst:135 ec0ceb929e634253940d9d8b12c34e12 msgid "Sample code" msgstr "サンプルコード" #: ../../pymupdf4llm/index.rst:137 f2d41ac1c1d24d9289e6ce68bc9370de #, fuzzy msgid "" "`Command line RAG Chatbot with PyMuPDF " "`_" msgstr "" "`PyMuPDFを使用したコマンドラインRAGチャットボット `_" #: ../../pymupdf4llm/index.rst:138 bf6ddba28b86427ab7c934e3fe869608 #, fuzzy msgid "" "`Example of a Browser Application using Langchain and PyMuPDF " "`_" msgstr "" "`LangchainとPyMuPDFを使用したブラウザアプリケーションの例 " "`_" #: ../../pymupdf4llm/index.rst:142 05f33a793ba04dbea19e7a464b4c8cd5 msgid "Blogs" msgstr "ブログ" #: ../../pymupdf4llm/index.rst:144 d6c3173afe6a4dbd880c662d9a8b9e66 msgid "" "`RAG/LLM and PDF: Enhanced Text Extraction `_" msgstr "" "`RAG/LLMとPDF: テキスト抽出の強化 `_" #: ../../pymupdf4llm/index.rst:145 2469a1a8ebb649b083d10e876d5b3022 msgid "" "`Creating a RAG Chatbot with ChatGPT and PyMuPDF " "`_" msgstr "" "`ChatGPTとPyMuPDFを使用したRAGチャットボットの作成 `_" #: ../../pymupdf4llm/index.rst:146 750da7ec1111406c9f24fe09151140ae msgid "" "`Building a RAG Chatbot GUI with the ChatGPT API and PyMuPDF " "`_" msgstr "" "`ChatGPT APIとPyMuPDFを使用してRAGチャットボットGUIを構築 `_" #: ../../pymupdf4llm/index.rst:147 d820865d4e2b470b975fd95e67ec0436 msgid "" "`RAG/LLM and PDF: Conversion to Markdown Text with PyMuPDF " "`_" msgstr "" "`RAG/LLMとPDF：PyMuPDFを使用したMarkdownテキストへの変換 `_" #: ../../footer.rst:46 30b12247e1244acba7a2885245d87849 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/pyodide.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 14998f025d1148cda63f25bfef057aa2 msgid "Artifex" msgstr "" #: ../../header.rst:-1 5c54bd9a0f054a82914a040bee536ad6 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF（およびその他の）ドキュメントのデータ抽出、解析、変換、および操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 ce438b15da5b4a318f4e36069383eb06 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF テキスト抽出、PDF 画像抽出、PDF 変換、PDF テーブル、PDF 分割、PDF 作成、Pyodide、PyScript" #: ../../pyodide.rst:4 92e84ecde2114f28830f75ff139cc150 msgid "Pyodide" msgstr "" #: ../../pyodide.rst:8 3c7cff0a2616443fbc6d49b71a7d5ef9 msgid "Overview" msgstr "概要" #: ../../pyodide.rst:11 e962a3c031f2439688768b2b5d926e9a msgid "" "`Pyodide `_ is a client-side Python implementation " "that runs in a web browser." msgstr "`Pyodide `_ は、ウェブブラウザで実行されるクライアントサイドの Python 実装です" #: ../../pyodide.rst:14 e26bc674818d456fb786a4cc5b979023 msgid "The Pyodide build of PyMuPDF is currently experimental." msgstr "PyMuPDF の Pyodide ビルドは現在実験的な段階です。" #: ../../pyodide.rst:18 d8c36794d9a943e19a0cd695b98e4172 msgid "Building a PyMuPDF wheel for Pyodide" msgstr "Pyodide 用の PyMuPDF ホイールの構築" #: ../../pyodide.rst:20 1dcd6f33eb094fc284df0d904ce1cefa msgid "" "A PyMuPDF wheel for Pyodide can be built by running " "`scripts/gh_release.py` with some environmental variable settings. This " "is regularly tested on Github by `.github/workflows/test_pyodide.yml`." msgstr "" "Pyodide 用の PyMuPDF ホイールは、いくつかの環境変数設定を使用して `scripts/gh_release.py` " "を実行することで構築できます。これは、`.github/workflows/test_pyodide.yml` によって定期的に GitHub " "上でテストされています。" #: ../../pyodide.rst:24 04f1fabb002143fb9a715d8db14af45a msgid "" "Here is an example of this, a single Linux command (to be run with the " "current directory set to a PyMuPDF checkout), that builds a Pyodide " "wheel::" msgstr "以下は、これの例です。現在のディレクトリが PyMuPDF のチェックアウトに設定されている場合に実行される単一の Linux コマンドです。" #: ../../pyodide.rst:33 eef89f5827ec4b709ca1d2e0ac5c097f msgid "This does the following (all inside Python venv's):" msgstr "これは以下の作業を行います（すべて Python venv 内で実行）：" #: ../../pyodide.rst:35 12858012b88247c7bb3c683954628295 msgid "" "Download (git clone and pip install) and customise a Pyodide build " "environment." msgstr "Pyodide ビルド環境をダウンロード（git clone および pip install）し、カスタマイズします" #: ../../pyodide.rst:36 3e87e7f44f7545bbbb191af42283fe54 msgid "Download (git clone) the latest MuPDF." msgstr "最新の MuPDF をダウンロード（git clone）します。" #: ../../pyodide.rst:37 160cb2ec1c1c4a209a7fba7562c0d145 msgid "Build MuPDF and PyMuPDF in the Pyodide build environment." msgstr "MuPDF と PyMuPDF を Pyodide ビルド環境でビルドします。" #: ../../pyodide.rst:38 ccad3592e88243efab0d160923ed215a msgid "Create a wheel in `dist/`." msgstr "`dist/` にホイールを作成します" #: ../../pyodide.rst:40 5a3384a91a534d249a926eb839230cea msgid "" "For more information, see the comments for functions " "`build_pyodide_wheel()` and `pyodide_setup()` in `scripts/gh_release.py`." msgstr "" "詳細については、`scripts/gh_release.py` 内の関数 `build_pyodide_wheel()` と " "`pyodide_setup()` のコメントを参照してください。" #: ../../pyodide.rst:45 b46c76365b9046c195143674ad6f9337 msgid "Using a Pyodide wheel" msgstr "Pyodide ホイールの使用方法" #: ../../pyodide.rst:48 6a5b9ebd00244e88809b7cddb3efb929 msgid "" "Upload the wheel (for example " "`PyMuPDF/dist/PyMuPDF-1.24.2-cp311-cp311-emscripten_3_1_32_wasm32.whl`) " "to a webserver which has been configured to allow Cross-origin resource " "sharing (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing)." msgstr "" "`PyMuPDF/dist/PyMuPDF-1.24.2-cp311-cp311-emscripten_3_1_32_wasm32.whl` " "のようなホイールを、Cross-origin resource sharing（https://en.wikipedia.org/wiki" "/Cross-origin_resource_sharing）を許可するように構成されたウェブサーバにアップロードします。" #: ../../pyodide.rst:54 12bd07e412b5464e9cd32cbc111e2a26 msgid "" "The wheel can be used in a Pyodide console running in a web browser, or a" " JupyterLite notebook running in a web browser." msgstr "このホイールは、ウェブブラウザで実行されている Pyodide コンソールまたは JupyterLite ノートブックで使用できます。" #: ../../pyodide.rst:57 fe96c467a1374441b725c5ed97d79a57 msgid "To create a Pyodide console, go to:" msgstr "Pyodide コンソールを作成するには、次のURLにアクセスしてください：" #: ../../pyodide.rst:59 910ab71af3894948a37af8412a6954fb msgid "https://pyodide.org/en/stable/console.html" msgstr "" #: ../../pyodide.rst:61 6433c259686c469bac6c3f3a824351f2 msgid "To create a JupyterLite notebook, go to:" msgstr "JupyterLite ノートブックを作成するには、次のURLにアクセスしてください：" #: ../../pyodide.rst:63 4903ffff457f434691fffa07bd2f73a5 msgid "https://jupyterlite.readthedocs.io/en/latest/_static/lab/index.html" msgstr "" #: ../../pyodide.rst:66 09c760f53c434ee6b3ce75b594a85cad msgid "" "In both these cases, one can use the following code to download the wheel" " (replace `url` with the URL of the uploaded wheel) and import it::" msgstr "れらの場合、以下のコードを使用してホイールをダウンロード（`url` をアップロードされたホイールの URL に置き換える）し、インポートできます：" #: ../../pyodide.rst:74 dbd55ab15c224387b85ff3b29f3fd2c7 msgid "" "Note that `micropip.install()` does not work, because of PyMuPDF's use of" " shared libraries." msgstr "`micropip.install()` は PyMuPDF が共有ライブラリを使用しているため機能しないことに注意してください。" #: ../../pyodide.rst:79 d9fce175d654431a9a455df1cddc005f msgid "Loading a PDF document from a URL into PyMuPDF" msgstr "PyMuPDF にURLからPDFドキュメントを読み込む" #: ../../pyodide.rst:82 5e286969bc7e464ab645cff0b5e85861 msgid "" "Pyodide browser console does not have generic network access, so for " "example `urllib.request.urlopen(url)` fails. But Pyodide has a built-in " "`pyodide.http` module that uses javascript internally, which one can use " "to download into a `bytes` instance, which can be used to create a " "PyMuPDF `Document` instance::" msgstr "" "Pyodide ブラウザコンソールには一般的なネットワークアクセスがないため、例えば `urllib.request.urlopen(url)` " "は失敗します。しかし、Pyodide には JavaScript を内部で使用する組み込みの `pyodide.http` " "モジュールがあります。これを使用して `bytes` インスタンスにダウンロードし、それを使用して PyMuPDF `Document` " "インスタンスを作成できます：" #: ../../pyodide.rst:93 9022520dcaa9430fb6e28b813ef995c2 msgid "It looks like this only works with `https://`, not `http://`." msgstr "これは `https://` でのみ機能するようです。`http://` では機能しません。" #: ../../footer.rst:60 84f62677a793440aa7ea160b7c3c1a2f msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは、|version| までのすべてのバージョンをカバーしています" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/quad.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 3ad4b4dd8a9d444dbdb71d2f893d147d msgid "Artifex" msgstr "" #: ../../header.rst:-1 8e281561019a467090b604cbf8c25baa msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 7a22fe4efbda4a6e9221d09c9a1e31f5 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../quad.rst:7 35e2527763ab458fa5ba06887a186967 msgid "Quad" msgstr "Quad (クアッド)" #: ../../quad.rst:9 7800e12444f748a6831e1efc77128fa3 msgid "" "Represents a four-sided mathematical shape (also called \"quadrilateral\"" " or \"tetragon\") in the plane, defined as a sequence of four " ":ref:`Point` objects ul, ur, ll, lr (conveniently called upper left, " "upper right, lower left, lower right)." msgstr "" "Quad（四角形または四辺形とも呼ばれる）は、平面上の数学的な四角形を表すもので、ul（上部左側）、ur（上部右側）、ll（下部左側）、lr（下部右側）の4つの" " :ref:`Point` オブジェクトのシーケンスとして定義されます。" #: ../../quad.rst:11 4d17c9c46c584b239de386721cba1810 msgid "" "Quads can **be obtained** as results of text search methods " "(:meth:`Page.search_for`), and they **are used** to define text marker " "annotations (see e.g. :meth:`Page.add_squiggly_annot` and friends), and " "in several draw methods (like :meth:`Page.draw_quad` / " ":meth:`Shape.draw_quad`, :meth:`Page.draw_oval`/ " ":meth:`Shape.draw_quad`)." msgstr "" "Quadはテキスト検索メソッド（ :meth:`Page.search_for` など）の結果として **取得でき** " "、テキストマーカーアノテーション :meth:`Page.add_squiggly_annot` " "などを参照）の定義や、:meth:`Page.draw_oval` / :meth:`Shape.draw_quad` " "などのいくつかの描画メソッドで使用されます。" #: ../../quad.rst:15 7b24b5db8f874de9a5211dce20991a59 msgid "" "If the corners of a rectangle are transformed with a **rotation**, " "**scale** or **translation** :ref:`Matrix`, then the resulting quad is " "**rectangular** (= congruent to a rectangle), i.e. all of its corners " "again enclose angles of 90 degrees. Property :attr:`Quad.is_rectangular` " "checks whether a quad can be thought of being the result of such an " "operation." msgstr "" "四角形の角が **回転**、**スケール**、または **移動** :ref:`Matrix` で変換される場合、結果の四角形は **長方形** " "です（長方形と合同の意味）、つまりそのすべての角は再び90度の角度を囲んでいます。:attr:`Quad.is_rectangular` " "プロパティは、四角形がこのような操作の結果であるかどうかを確認します。" #: ../../quad.rst:17 688788bd21fd45f692790d0473acb161 msgid "" "This is not true for all matrices: e.g. shear matrices produce " "parallelograms, and non-invertible matrices deliver \"degenerate\" " "tetragons like triangles or lines." msgstr "これはすべての行列に対して当てはまるわけではありません。例えば、シア行列は平行四辺形を生成し、非可逆行列は三角形や線のような「退化」した四角形を提供します。" #: ../../quad.rst:19 cf1183ff01fc48bf97106c5a287a5ff7 msgid "" "Attribute :attr:`Quad.rect` obtains the enveloping rectangle. Vice versa," " rectangles now have attributes :attr:`Rect.quad`, resp. " ":attr:`IRect.quad` to obtain their respective tetragon versions." msgstr "" "属性 :attr:`Quad.rect` は包括的な長方形を取得します。その逆も成り立ち、長方形には " ":attr:`Rect.quad`、:attr:`IRect.quad` 属性が含まれ、それぞれそれらの四辺形バージョンを取得できます。" #: ../../quad.rst:23 50d7d842d9734fa599c188cc646d7b45 msgid "**Methods / Attributes**" msgstr "**メソッド / 属性**" #: ../../quad.rst:23 19f74f68bb13495c8ebf6c8b0b42f965 msgid "**Short Description**" msgstr "**短い説明**" #: ../../quad.rst:25 e538183055244dc08b0b15c4b8912add msgid ":meth:`Quad.transform`" msgstr "" #: ../../quad.rst:25 9f2dd03a77524dfd9b216fbb23b9cda3 msgid "transform with a matrix" msgstr "行列を使用して変換します" #: ../../quad.rst:26 6235ae5796024a74a6be5aa7991d9d4e msgid ":meth:`Quad.morph`" msgstr "" #: ../../quad.rst:26 ee610799d4d446bc8e8b0e6c5bbbb1d6 msgid "transform with a point and matrix" msgstr "ポイントと行列を使用して変換します" #: ../../quad.rst:27 046b52453a10469e8acd23a2744d436c msgid ":attr:`Quad.ul`" msgstr "" #: ../../quad.rst:27 6a03caf34312460985dc2fa98abdf184 msgid "upper left point" msgstr "左上のポイント" #: ../../quad.rst:28 4ccf2ab7cc924c399255bcdbd26f5233 msgid ":attr:`Quad.ur`" msgstr "" #: ../../quad.rst:28 be0476ca60a84fc08b7232ed236c4a76 msgid "upper right point" msgstr "右上のポイント" #: ../../quad.rst:29 a9835aa97d1b4882af33c92e9119563a msgid ":attr:`Quad.ll`" msgstr "" #: ../../quad.rst:29 b7fffd7413fc4d0cafb1f629cf052760 msgid "lower left point" msgstr "左下のポイント" #: ../../quad.rst:30 c28f7725993c42398e1efe0361e4cd0c msgid ":attr:`Quad.lr`" msgstr "" #: ../../quad.rst:30 928da6d5fb114af49b9f822994eeca25 msgid "lower right point" msgstr "右下のポイント" #: ../../quad.rst:31 b6205ef513fc4875b98f196a42177c78 msgid ":attr:`Quad.is_convex`" msgstr "" #: ../../quad.rst:31 5b826a02006c4d41b209de06b14a5189 msgid "true if quad is a convex set" msgstr "四角形が凸集合である場合は true" #: ../../quad.rst:32 51d60aeda5e54bcbaf2e39b528354d95 msgid ":attr:`Quad.is_empty`" msgstr "" #: ../../quad.rst:32 352c6bcfc0894aaeb7400e72b81e1e94 msgid "true if quad is an empty set" msgstr "四角形が空の集合である場合は true" #: ../../quad.rst:33 36eca873465943169ce2e899cbb1a5e6 msgid ":attr:`Quad.is_rectangular`" msgstr "" #: ../../quad.rst:33 bc110a7f43304b5f9cf4b9e5f348d237 msgid "true if quad is congruent to a rectangle" msgstr "四角形が長方形と合同である場合は true" #: ../../quad.rst:34 42b941820433460aa6e4f0939cbd93a7 msgid ":attr:`Quad.rect`" msgstr "" #: ../../quad.rst:34 6870fe5a0464469ab8425e8f89f7a530 msgid "smallest containing :ref:`Rect`" msgstr "最も小さい包含 :ref:`Rect`" #: ../../quad.rst:35 79aa77876e4d45a289d673fe00a95995 msgid ":attr:`Quad.width`" msgstr "" #: ../../quad.rst:35 1082a3b6b72b40888b3797974c6f1191 msgid "the longest width value" msgstr "最も長い幅の値" #: ../../quad.rst:36 7a4558a4427841528a563259add0a04b msgid ":attr:`Quad.height`" msgstr "" #: ../../quad.rst:36 a3081f95dafb42188a9b34f2e0664367 msgid "the longest height value" msgstr "最も長い高さの値" #: ../../quad.rst:39 b2cf4d9a187b48ff8960c68e29a2f5ce msgid "**Class API**" msgstr "**クラスAPI**" #: ../../quad.rst:51 5500a6189d9147a996038ae4dccde288 msgid "" "Overloaded constructors: \"ul\", \"ur\", \"ll\", \"lr\" stand for " ":data:`point_like` objects (the four corners), \"sequence\" is a Python " "sequence with four :data:`point_like` objects." msgstr "" "オーバーロードされたコンストラクター: \"ul\"、\"ur\"、\"ll\"、\"lr\"は :data:`point_like` " "オブジェクト（4つの角）を表し、\"sequence\" は4つの :data:`point_like` " "オブジェクトを持つPythonのシーケンスです。" #: ../../quad.rst:53 93948e27f11149d3b2de812391df3cbe msgid "If \"quad\" is specified, the constructor creates a **new copy** of it." msgstr "\"quad\" が指定されている場合、コンストラクターはそれの **新しいコピー** を作成します。" #: ../../quad.rst:55 f2671c8b3169475cb8037f714c6b1f02 msgid "" "Without parameters, a quad consisting of 4 copies of *Point(0, 0)* is " "created." msgstr "パラメーターが指定されていない場合、4つの *Point(0, 0)* のコピーからなる四角形が作成されます。" #: ../../quad.rst:60 111c1f817d0f46f4a18dcfd6c663c18a msgid "" "Modify the quadrilateral by transforming each of its corners with a " "matrix." msgstr "四角形の各角を行列で変換して四角形を変更します。" #: ../../quad.rst 8266d43d9f56420bb2aa23d082c0b121 #: 8b1eac95560f446b8e20b55dd12a6816 msgid "Parameters" msgstr "" #: ../../quad.rst:62 ../../quad.rst:69 0d634d4d35d54c30baabad227f22028f #: 9a047b3f95b14bb7b64ad40042d33edf msgid "the matrix." msgstr "行列。" #: ../../quad.rst:66 3267067416df4dd8b8c8377a0d0e60c2 msgid "" "*(New in version 1.17.0)* \"Morph\" the quad with a matrix-like using a " "point-like as fixed point." msgstr "*(バージョン1.17.0で新たに導入)* マトリクスのようなものを使用して四角形を\"変形\"させ、固定ポイントとしてポイントライクを使用します。" #: ../../quad.rst:68 d59f47deb52f43bbaac3720001127772 msgid "the point." msgstr "ポイント。" #: ../../quad.rst aa094e5057b24cf88c8f90ad40d9a6cb msgid "Returns" msgstr "" #: ../../quad.rst:70 c0beb373c7644f0aa60225c4310d6f7e msgid "a new quad (no operation if this is the infinite quad)." msgstr "新しい四角形（これが無限の四角形の場合、操作は行われません）。" #: ../../quad.rst:75 dddc8689476548da8e50846d44537f2d msgid "" "The smallest rectangle containing the quad, represented by the blue area " "in the following picture." msgstr "四角形を含む最小の長方形で、以下の図の青い領域で表されます。" #: ../../quad.rst 0d91757c4c9c4ded9d29ce0f2a2c7b6e #: 25ea7b95ca1c470bbd0c8c43d4724eb8 3608dfc13924419a90f0f72f4942d4bb #: 46bbb10a82e94600b8fc797424ddd669 47c64c1542614109b19d7cfe7ff52b48 #: 8c84322b6cca4f0aaeb2da2b9c139ad2 9c0e2fe975e94117ad5671c3ae223f92 #: d3ab357c8c344e4fbbffbbf6e592d8f7 d6db0b6368ce47b28d082a226b28263e #: ea8761efdea544869198ae33343519b9 msgid "type" msgstr "" #: ../../quad.rst:79 a447749ed60c435c945ea6d5ac0e1531 msgid ":ref:`Rect`" msgstr "" #: ../../quad.rst:83 44f1f1d4404e42f0a16619c78d94e880 msgid "Upper left point." msgstr "左上のポイント" #: ../../quad.rst:85 ../../quad.rst:91 ../../quad.rst:97 ../../quad.rst:103 #: 03736f05a8f5421189f98f0b2563c031 a6060101e92f44bf89658804e52b0c6c #: cd76cb6712a84b878c58e674036c6b57 e745c97cd50f406d99f625378bc07267 msgid ":ref:`Point`" msgstr "" #: ../../quad.rst:89 a15d9aa488ac46398e1300d7a621789d msgid "Upper right point." msgstr "右上のポイント" #: ../../quad.rst:95 e58949b5a6124ea7b84c82246b331fa5 msgid "Lower left point." msgstr "左下のポイント" #: ../../quad.rst:101 459751b609574eee8992e1f4ed63a8be msgid "Lower right point." msgstr "右下のポイント" #: ../../quad.rst:107 42081dff926d4b2dbfc85eebd7c6b91c msgid "New in version 1.16.1" msgstr "新しいバージョン1.16.1で追加されました" #: ../../quad.rst:109 18727351228e45f18f66be1e6b1a0431 msgid "" "Checks if for any two points of the quad, all points on their connecting " "line also belong to the quad." msgstr "このクアッドの任意の2点について、それらを結ぶ直線上のすべての点もこのクアッドに属するかどうかをチェックします。" #: ../../quad.rst:114 ../../quad.rst:120 ../../quad.rst:126 #: 269c1e4494824e2cb5936c9aeaae79e7 c41948d6f881462aac8ced961485b1ec #: dea8b14143c94257a8c383e3f0c1f9a2 msgid "bool" msgstr "" #: ../../quad.rst:118 fb252aa17185476b93956d6738fff2e7 msgid "" "True if enclosed area is zero, which means that at least three of the " "four corners are on the same line. If this is false, the quad may still " "be degenerate or not look like a tetragon at all (triangles, " "parallelograms, trapezoids, ...)." msgstr "" "Enclosed " "areaがゼロの場合はTrueで、これは4つの角のうち少なくとも3つが同じ直線上にあることを意味します。これがfalseの場合、クアッドは依然として退化しているか、全くテトラゴンのようには見えないかもしれません（三角形、平行四辺形、台形など）。" #: ../../quad.rst:124 df1dab125bdf4e06b610448db4325b06 msgid "" "True if all corner angles are 90 degrees. This implies that the quad is " "**convex and not empty**." msgstr "4つの角のすべての角度が90度の場合はTrueです。これは、クアッドが **凸面であり、空ではない** ことを意味します。" #: ../../quad.rst:130 4f39bb3710a4402da4e1c2a2d8e7f5f4 msgid "The maximum length of the top and the bottom side." msgstr "上辺と下辺の最大の長さ。" #: ../../quad.rst:132 ../../quad.rst:138 dbf8525cf293442a8ac2170ef5d5830b #: dc2fb941fd18465297cb72af2629fce0 msgid "float" msgstr "" #: ../../quad.rst:136 637d9c47fc5448c6b6b12ed59410f8cf msgid "The maximum length of the left and the right side." msgstr "上辺と下辺の最大の長さ。" #: ../../quad.rst:141 deee9fb98ab34d4494ac466fabaea29d msgid "Remark" msgstr "リマーク" #: ../../quad.rst:142 1b61ac0c866a4df28afb4a722645cf08 msgid "" "This class adheres to the sequence protocol, so components can be dealt " "with via their indices, too. Also refer to :ref:`SequenceTypes`." msgstr "" "このクラスはシーケンスプロトコルに従っており、要素にはインデックスを使用できます。また、:ref:`SequenceTypes` " "を参照してください。" #: ../../quad.rst:145 6215145a706f4cd4a73d3ab4595807a9 msgid "Algebra and Containment Checks" msgstr "代数と包含チェック" #: ../../quad.rst:146 fb0679a33ccb4fdb98427f9407938675 msgid "" "Starting with v1.19.6, quads can be used in algebraic expressions like " "the other geometry object -- the respective restrictions have been " "lifted. In particular, all the following combinations of containment " "checking are now possible:" msgstr "" "v1.19.6から、クアッドは他のジオメトリオブジェクトと同様に代数的な式で使用できるようになりました - " "対応する制限が解除されました。特に、次の包含チェックの組み合わせがすべて可能になりました。" #: ../../quad.rst:148 0e4401adcb5f4fc485e655c876a8ae28 msgid "`{Point | IRect | Rect | Quad} in {IRect | Rect | Quad}`" msgstr "" #: ../../quad.rst:150 7f8244052cb6402a939f0594f0b6a759 msgid "Please note the following interesting detail:" msgstr "次の興味深い詳細に注意してください：" #: ../../quad.rst:152 9671396ad46747c2ae802633663007ee msgid "" "For a rectangle, only its top-left point belongs to it. Since v1.19.0, " "rectangles are defined to be \"open\", such that its bottom and its right" " edge do not belong to it -- including the respective corners. But for " "quads there exists no such notion like \"openness\", so we have the " "following somewhat surprising implication:" msgstr "" "長方形の場合、その上辺のみがそれに属しています。v1.19.0以降、長方形は「オープン」であると定義されており、その底辺と右端はそれに属していません" " - それには対応する角も含まれます。しかし、クアッドには「オープン」のような概念が存在しないため、次のようなやや驚くべき含意があります：" #: ../../footer.rst:60 cc3f6c4d45844fe8ad36b35c6e3bd3ab msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/rag.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d58a444fc92843a18660ede50d62d095 msgid "Artifex" msgstr "" #: ../../header.rst:-1 6e2254ee60a14d48a1348f2b46d484d2 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDFは、PDF（およびその他）ドキュメントのデータ抽出、解析、変換、および操作のための高性能なPythonライブラリです。" #: ../../header.rst:-1 bc86116b658f4d3fb0e20919e6179a1e msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDF画像抽出、PDF変換、PDFテーブル、PDF分割、PDF作成、Pyodide、PyScript" #: ../../rag.rst:6 1e69d82c08b049a6b539ae49ee8df24e msgid "PyMuPDF, LLM & RAG" msgstr "PyMuPDF、LLM、およびRAG" #: ../../rag.rst:9 056a5c68abb744c7863c87748f5cc0b1 msgid "" "Integrating |PyMuPDF| into your :title:`Large Language Model (LLM)` " "framework and overall :title:`RAG (Retrieval-Augmented Generation`) " "solution provides the fastest and most reliable way to deliver document " "data." msgstr "" "|PyMuPDF| を :title:`大規模言語モデル（LLM）` フレームワークおよび全体的な :title:`RAG（Retrieval-" "Augmented Generation）` ソリューションに統合することで、文書データを提供する最も高速かつ信頼性の高い方法が提供されます。" #: ../../rag.rst:11 fee93922167c4b2d9d9054f8565193f4 msgid "" "There are a few well known :title:`LLM` solutions which have their own " "interfaces with |PyMuPDF| - it is a fast growing area, so please let us " "know if you discover any more!" msgstr "" "いくつかのよく知られた :title:`LLM` ソリューションは、|PyMuPDF| " "と独自のインターフェースを持っています。この分野は急速に成長しているため、もっと見つけた場合はお知らせください。" #: ../../rag.rst:13 87158dfd9b9a4174a93d56546e871f72 msgid "" "If you need to export to :title:`Markdown` or obtain a " ":title:`LlamaIndex` Document from a file:" msgstr ":title:`Markdown` へのエクスポートやファイルから :title:`LlamaIndex` ドキュメントを取得する必要がある場合は:" #: ../../rag.rst:31 51971a71e3ca420db71fb2080da653ad msgid "Integration with :title:`LangChain`" msgstr ":title:`LangChain` との統合" #: ../../rag.rst:33 9e2065dc5185491abcf869e4a276c5be msgid "" "It is simple to integrate directly with :title:`LangChain` by using their" " dedicated loader as follows:" msgstr ":title:`LangChain` の専用ローダーを使用して直接統合するのは簡単です。以下のようにします：" #: ../../rag.rst:43 236dcfb83a264f6c83e921a7905a29bc msgid "" "See `LangChain Using PyMuPDF " "`_ for full details." msgstr "" "`LangChainを完全に利用する詳細については、PyMuPDF " "`_ を参照してください。" #: ../../rag.rst:47 f9ce52737bda4fc5b4075b6ad14b9e2e msgid "Integration with :title:`LlamaIndex`" msgstr ":title:`LlamaIndex` との統合" #: ../../rag.rst:50 1b7d2270a3c74a44b70efbcee8b0d37f msgid "" "Use the dedicated `PyMuPDFReader` from :title:`LlamaIndex` 🦙 to manage " "your document loading." msgstr ":title:`LlamaIndex` 🦙 の専用 `PyMuPDFReader` を使用して、文書の読み込みを管理します。" #: ../../rag.rst:58 40923d58ee41475bb0ee10e7014a578a msgid "" "See `Building RAG from Scratch " "`_" " for more." msgstr "" "詳細は、 `ゼロからRAGを構築する " "`_" " をご覧ください。" #: ../../rag.rst:62 3055cf26690d4e289489b37eaf7b5333 msgid "Preparing Data for Chunking" msgstr "データのチャンキングの準備" #: ../../rag.rst:64 e37920b16364455dad472a5c99218cda msgid "" "Chunking (or splitting) data is essential to give context to your " ":title:`LLM` data and with :title:`Markdown` output now supported by " "|PyMuPDF| this means that `Level 3 chunking " "`_ is " "supported." msgstr "" "データのチャンキング（または分割）は、:title:`LLM` データに文脈を与えるために不可欠であり、|PyMuPDF| が " ":title:`Markdown` 出力をサポートするようになったことで、`レベル3のチャンキング " "`_ " "がサポートされることを意味します。" #: ../../rag.rst:71 9a8d957771b04869afd1441e12a280be msgid "Outputting as :title:`Markdown`" msgstr ":title:`Markdown` 形式で出力" #: ../../rag.rst:73 6076246f267449deace88b822ddabfe0 #, fuzzy msgid "" "In order to export your document in :title:`Markdown` format you will " "need a separate helper. Package :doc:`pymupdf4llm/index` is a high-level " "wrapper of |PyMuPDF| functions which for each page outputs standard and " "table text in an integrated Markdown-formatted string across all document" " pages:" msgstr "" ":title:`Markdown` 形式で文書をエクスポートするには、別途のヘルパーが必要です。パッケージ `pymupdf4llm " "`_ " "は、各ページに対して標準テキストとテーブルテキストを統合されたMarkdown形式の文字列で出力する、|PyMuPDF| " "関数の高レベルなラッパーです。" #: ../../rag.rst:87 58590b8ebc244b9db1cc83c63adc2d1b #, fuzzy msgid "For further information please refer to: :doc:`pymupdf4llm/index`." msgstr "" "詳細については、次を参照してください： `pymupdf4llmのドキュメント " "`_。" #: ../../rag.rst:91 b32a1b079e794491a5e021d26fb18453 msgid "How to use :title:`Markdown` output" msgstr ":title:`Markdown` 出力の使用方法" #: ../../rag.rst:93 8045470b5fa04886b83960e80fc71aae msgid "" "Once you have your data in :title:`Markdown` format you are ready to " "chunk/split it and supply it to your :title:`LLM`, for example, if this " "is :title:`LangChain` then do the following:" msgstr "" ":title:`Markdown` 形式のデータが準備できたら、データをチャンク化/分割して :title:`LLM` " "に供給する準備が整います。例えば、:title:`LangChain` の場合は、次の手順を行います。" #: ../../rag.rst:109 4d0c5d7c2dc04c059fbdb5ad0709c2af msgid "" "For more see `5 Levels of Text Splitting `_" msgstr "" "詳細は `「テキスト分割の5レベル」 `_" " を参照してください。" #: ../../rag.rst:113 896b1dd74ff24363becbdac98144b86c msgid "Related Blogs" msgstr "関連ブログ" #: ../../rag.rst:115 a036501ebb68414192f47e189aec5f3d msgid "" "To find out more about |PyMuPDF|, :title:`LLM` & :title:`RAG` check out " "our blogs for implementations & tutorials." msgstr "" "|PyMuPDF| 、 :title:`LLM` 、および :title:`RAG` " "について詳しく知りたい場合は、実装やチュートリアルに関するブログをチェックしてください。" #: ../../rag.rst:119 a8b36bcfa4c746e4b21ffd62e4c38618 msgid "Methodologies to Extract Text" msgstr "テキストを抽出するための方法論" #: ../../rag.rst:121 f69b739e4b764e0b856de55aa7f97093 msgid "" "`Enhanced Text Extraction `_" msgstr "`テキスト抽出の強化 `_ " #: ../../rag.rst:122 3ae24a0e46354d408bcdaf4deb16af33 msgid "" "`Conversion to Markdown Text with PyMuPDF `_" msgstr "" "`PyMuPDFを使用したMarkdownテキストへの変換 `_" #: ../../rag.rst:127 bbe057c5d511484c8b9bd0b656c6216c msgid "Create a Chatbot to discuss your documents" msgstr "文書を議論するためのチャットボットを作成する" #: ../../rag.rst:129 1255eb5a25064e6c8ae8ca5b8af9b0a4 msgid "" "`Make a simple command line Chatbot `_" msgstr "" "`シンプルなコマンドラインのチャットボットを作成するシンプルなコマンドラインのチャットボットを作成する `_" #: ../../rag.rst:130 569c7f488bc747a2801a4b6532a9c3dd msgid "" "`Make a Chatbot GUI `_" msgstr "" "`チャットボットGUIを作成する `_" #: ../../footer.rst:60 45a2c818f8ae4c1fa455751e51ab3e21 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは、|version| までのすべてのバージョンをカバーしています。" #~ msgid "If you need to export to :title:`Markdown`:" #~ msgstr ":title:`Markdown` にエクスポートする必要がある場合：" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-annotations.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d1ad502e2163461abd37b8e0afad7b09 msgid "Artifex" msgstr "" #: ../../header.rst:-1 9b5018bc6d0347e3ac0dca7c86ee8578 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 9215720d8e8043e38ff196c7e9cfe5f0 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-annotations.rst:7 43c8624c55e14be2aac3624caf95357e msgid "Annotations" msgstr "注釈" #: ../../recipes-annotations.rst:12 3eb67bbfa6584d6e8bfe087440a64e64 msgid "How to Add and Modify Annotations" msgstr "注釈の追加と変更方法" #: ../../recipes-annotations.rst:14 0e7efcdb24c74719b4c01251f4a59aa5 msgid "" "In |PyMuPDF|, new annotations can be added via :ref:`Page` methods. Once " "an annotation exists, it can be modified to a large extent using methods " "of the :ref:`Annot` class." msgstr "" "PyMuPDFでは、新しい注釈を :ref:`Page` メソッドを介して追加することができます。一度注釈が存在すると、 :ref:`Annot`" " クラスのメソッドを使用して大幅に変更できます。" #: ../../recipes-annotations.rst:16 2bf001f41c6b451b9937901bb58f7e23 msgid "" "Annotations can **only** be inserted in |PDF| pages - other document " "types do not support annotation insertion." msgstr "注釈は PDF ページにのみ 挿入可能です。他のドキュメント形式では、注釈の挿入はサポートされていません。" #: ../../recipes-annotations.rst:18 ba516eb1a56945e5a9bac7e9fa24fed1 msgid "" "In contrast to many other tools, initial insert of annotations happens " "with a minimum number of properties. We leave it to the programmer to " "e.g. set attributes like author, creation date or subject." msgstr "他の多くのツールとは異なり、注釈の初期挿入は最小限のプロパティで行われます。例えば、著者、作成日、サブジェクトなどの属性をプログラマーが設定することができます。" #: ../../recipes-annotations.rst:20 bc78178891f1440fbfa8e0aaff01e11c msgid "" "As an overview for these capabilities, look at the following script that " "fills a PDF page with most of the available annotations. Look in the next" " sections for more special situations:" msgstr "これらの機能の概要については、次のスクリプトを参照してください。このスクリプトはPDFページに利用可能な注釈のほとんどを埋めるものです。より特殊な状況については、次のセクションをご覧ください。" #: ../../recipes-annotations.rst:26 c8504dce5bb44372b1c68fe8f9b98fb7 msgid "This script should lead to the following output:" msgstr "このスクリプトは次のような出力を生成します：" #: ../../recipes-annotations.rst:36 96b9bb9ba45a444c973060143fc425cf msgid "How to Use FreeText" msgstr "FreeTextの使用方法" #: ../../recipes-annotations.rst:37 e91fc84e2d79457190b40cbf621719b3 msgid "" "This script shows a couple of basic ways to deal with 'FreeText' " "annotations:" msgstr "このスクリプトは、'FreeText'注釈を扱ういくつかの方法を示しています::" #: ../../recipes-annotations.rst:41 ../../recipes-annotations.rst:50 #: 2cdef3691b1341f4a6850d9d8de067bb 350586a50d5144a2b8d9db627bd71e24 msgid "The result looks like this:" msgstr "結果は次のようになります。" #: ../../recipes-annotations.rst:46 e86ede73d664430791e03da9a5d63702 msgid "Here is an example for using rich text and call-out lines:" msgstr "" #: ../../recipes-annotations.rst:63 f49b197275794adaa27d02d5ac0b32cf msgid "How to Use Ink Annotations" msgstr "インク注釈の使用方法" #: ../../recipes-annotations.rst:64 e0df9dc619c746da9593612a87cd3f0a msgid "" "Ink annotations are used to contain freehand scribbling. A typical " "example may be an image of your signature consisting of first name and " "last name. Technically an ink annotation is implemented as a **list of " "lists of points**. Each point list is regarded as a continuous line " "connecting the points. Different point lists represent independent line " "segments of the annotation." msgstr "インク注釈は、自由な手書きの落書きを含むために使用されます。典型的な例として、名前と姓からなる署名の画像が挙げられます。技術的には、インク注釈は点のリストのリストとして実装されます。各点のリストは、点を結んだ連続的な線と見なされます。異なる点のリストは、注釈の独立した線セグメントを表します。" #: ../../recipes-annotations.rst:66 dbdd441a25c44bd4aae5f2367cf85f3d #, fuzzy msgid "" "The following script creates an ink annotation with two mathematical " "curves (sine and cosine function graphs) as line segments:" msgstr "以下のスクリプトは、二つの数学的な曲線（正弦関数と余弦関数のグラフ）を線セグメントとして持つインク注釈を作成します::" #: ../../recipes-annotations.rst:70 bb6171a96157475f875163c29bc8e76f msgid "This is the result:" msgstr "これが結果です：" #: ../../footer.rst:60 79b679f62bef466ea3444589a3f3ef6f msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Using Buttons and JavaScript" #~ msgstr "ボタンとJavaScriptの使用" #~ msgid "" #~ "Since MuPDF v1.16, 'FreeText' annotations " #~ "no longer support bold or italic " #~ "versions of the Times-Roman, Helvetica" #~ " or Courier fonts." #~ msgstr "" #~ "MuPDF v1.16以降、'FreeText'注釈はもはやTimes-" #~ "Roman、Helvetica、Courierフォントの太字や斜体バージョンをサポートしていません。" #~ msgid "" #~ "A big **thank you** to our user" #~ " `@kurokawaikki `_, " #~ "who contributed the following script to" #~ " **circumvent this restriction**." #~ msgstr "" #~ "この制限を回避するために、次のスクリプトを提供してくれたユーザー `@kurokawaikki " #~ "`_ さんに心から感謝します。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4668aba35041418d9985c1a35575a6b3 msgid "Artifex" msgstr "" #: ../../header.rst:-1 1011e86add0c4e648dea40533c7fd1a2 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 10324b8854a4413791056120093832e9 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-common-issues-and-their-solutions.rst:7 #: 20bc28cec0154c7c9136122bd912f369 msgid "Common Issues and their Solutions" msgstr "一般的な問題とその解決方法" #: ../../recipes-common-issues-and-their-solutions.rst:10 #: 7f1290c0169445d78461fff755cfc034 msgid "How To Dynamically Clean Up Corrupt :title:`PDFs`" msgstr "壊れた |PDF| を動的にクリーンアップする方法" #: ../../recipes-common-issues-and-their-solutions.rst:12 #: ce6827f92d194d24abb5efce34f05be9 msgid "" "This shows a potential use of |PyMuPDF| with another Python PDF library " "(the excellent pure Python package `pdfrw " "`_ is used here as an example)." msgstr "" "これは、別のPython PDFライブラリ（素晴らしい純粋なPythonパッケージである `pdfrw " "`_ " "を例として使用しています）と組み合わせてPyMuPDFを潜在的に使用する方法を示しています。" #: ../../recipes-common-issues-and-their-solutions.rst:14 #: 4b79f85178e14c0bada317304b337db0 msgid "" "If a clean, non-corrupt / decompressed PDF is needed, one could " "dynamically invoke PyMuPDF to recover from many problems like so::" msgstr "" "クリーンで壊れていない / " "解凍されていないPDFが必要な場合、次のようにしてPyMuPDFを動的に呼び出して多くの問題から回復することができます::" #: ../../recipes-common-issues-and-their-solutions.rst:50 #: e6d9c9e53bdc4e6ea4fff95948a77ce0 msgid "" "With the command line utility *pdftk* (`available " "`_ for Windows " "only, but reported to also run under `Wine `_) a" " similar result can be achieved, see `here " "`_. " "However, you must invoke it as a separate process via *subprocess.Popen*," " using stdin and stdout as communication vehicles." msgstr "" "コマンドラインユーティリティ `pdftk `_ （Windowsのみで利用可能ですが、 `Wine `_ " "下でも動作すると報告されています）を使用すると、類似の結果を得ることができます。詳細は `こちら " "`_ " "をご覧ください。ただし、stdinとstdoutを通信手段として使用して別のプロセスとしてsubprocess.Popenを介して呼び出す必要があります。" #: ../../recipes-common-issues-and-their-solutions.rst:55 #: 3f9ab9bf78a74d9781937269cf8ef3cb msgid "How to Convert Any Document to |PDF|" msgstr "どの文書も |PDF| に変換する方法" #: ../../recipes-common-issues-and-their-solutions.rst:57 #: ca2811011d7b40808c8a55f65188b25f msgid "" "Here is a script that converts any |PyMuPDF| :ref:`supported " "document` to a |PDF|. These include XPS, EPUB, FB2," " CBZ and image formats, including multi-page TIFF images." msgstr "" "以下は、任意のPyMuPDFが :ref:`サポートされている ` " "文書をPDFに変換するスクリプトです。これにはXPS、EPUB、FB2、CBZ、および複数ページのTIFFイメージを含む画像フォーマットが含まれます。" #: ../../recipes-common-issues-and-their-solutions.rst:59 #: d7e2dfdcb75b40739daf46856a819f58 msgid "" "It features maintaining any metadata, table of contents and links " "contained in the source document::" msgstr "これにはソース文書に含まれるメタデータ、目次、リンクを保持する機能が備わっています::" #: ../../recipes-common-issues-and-their-solutions.rst:131 #: a41bc630ff314f64bcfa4150a08c3c84 msgid "Changing Annotations: Unexpected Behaviour" msgstr "注釈の変更：予期しない動作" #: ../../recipes-common-issues-and-their-solutions.rst:134 #: 9b87b714c12948aa94ae2868604c760c msgid "Problem" msgstr "問題" #: ../../recipes-common-issues-and-their-solutions.rst:135 #: 5870f9a9b1184a3cb1849e71b71e5026 msgid "There are two scenarios:" msgstr "2つのシナリオがあります：" #: ../../recipes-common-issues-and-their-solutions.rst:137 #: b360eb295e35468b9a48ce456cc717e7 msgid "" "**Updating** an annotation with PyMuPDF which was created by some other " "software." msgstr "他のソフトウェアで作成された注釈をPyMuPDFで**更新**する。" #: ../../recipes-common-issues-and-their-solutions.rst:138 #: c2f4bd673f784318906b6982c2873fdf msgid "" "**Creating** an annotation with PyMuPDF and later changing it with some " "other software." msgstr "PyMuPDFで注釈を**作成**し、後で他のソフトウェアで変更する。" #: ../../recipes-common-issues-and-their-solutions.rst:140 #: 3a2c5f9ca0da4058b2119d1e5ee6432c msgid "" "In both cases you may experience unintended changes, like a different " "annotation icon or text font, the fill color or line dashing have " "disappeared, line end symbols have changed their size or even have " "disappeared too, etc." msgstr "どちらの場合でも、異なる注釈アイコンやテキストフォント、塗りつぶしの色や線の破線が消えたり、線の端のシンボルのサイズが変わったり、さらには消えたりするなど、意図しない変更が発生する可能性があります。" #: ../../recipes-common-issues-and-their-solutions.rst:143 #: ../../recipes-common-issues-and-their-solutions.rst:182 #: ../../recipes-common-issues-and-their-solutions.rst:195 #: 0ec3d7b289ed40d1b1c9a6e6509cb81c 3db222ba67d34ffe8b9c76049639a28f #: 4947608029184f4eacde97cb22e6b0a0 msgid "Cause" msgstr "原因" #: ../../recipes-common-issues-and-their-solutions.rst:144 #: 580b99ed7b294df89844c876e4930bb6 msgid "" "Annotation maintenance is handled differently by each PDF maintenance " "application. Some annotation types may not be supported, or not be " "supported fully or some details may be handled in a different way than in" " another application. **There is no standard.**" msgstr "注釈の保守は、各PDF保守アプリケーションごとに異なる方法で処理されます。一部の注釈タイプはサポートされないか、完全にはサポートされていない場合もあり、また、他のアプリケーションとは異なる方法で詳細が処理される場合もあります。標準規格は存在しません。" #: ../../recipes-common-issues-and-their-solutions.rst:146 #: 0d39ed4b97424a2a87eb4bec722728b0 msgid "" "Almost always a PDF application also comes with its own icons (file " "attachments, sticky notes and stamps) and its own set of supported text " "fonts. For example:" msgstr "ほとんどの場合、PDFアプリケーションには独自のアイコン（ファイル添付、付箋、スタンプなど）とサポートされるテキストフォントのセットが付属しています。例えば：" #: ../../recipes-common-issues-and-their-solutions.rst:148 #: 65134846c0a240acb342d722b107de3f msgid "" "(Py-) MuPDF only supports these 5 basic fonts for 'FreeText' annotations:" " Helvetica, Times-Roman, Courier, ZapfDingbats and Symbol -- no italics /" " no bold variations. When changing a 'FreeText' annotation created by " "some other app, its font will probably not be recognized nor accepted and" " be replaced by Helvetica." msgstr "" "(Py-) MuPDFは、'FreeText'注釈に対してこれらの5つの基本フォントのみをサポートしています：Helvetica、Times-" "Roman、Courier、ZapfDingbats、Symbol - 斜体や太字のバリエーションはありません。他のアプリで作成された " "'FreeText' 注釈を変更する際、そのフォントはおそらく認識されず、Helveticaに置き換えられる可能性があります。" #: ../../recipes-common-issues-and-their-solutions.rst:150 #: e2cbd8bfb3d14500a0612d1d8d2c5ec6 msgid "" "PyMuPDF supports all PDF text markers (highlight, underline, strikeout, " "squiggly), but these types cannot be updated with Adobe Acrobat Reader." msgstr "" "PyMuPDFはすべてのPDFテキストマーカー（ハイライト、下線、取り消し線、波線）をサポートしていますが、これらのタイプはAdobe " "Acrobat Readerで更新することはできません。" #: ../../recipes-common-issues-and-their-solutions.rst:152 #: 5f42aed9c005492a92b5b6aa0cbcd03e msgid "" "In most cases there also exists limited support for line dashing which " "causes existing dashes to be replaced by straight lines. For example:" msgstr "ほとんどの場合、破線には限定的なサポートが存在し、既存の破線が直線に置き換えられることがあります。例えば：" #: ../../recipes-common-issues-and-their-solutions.rst:154 #: 7651dba336694614afc84cba3418f5cc msgid "" "PyMuPDF fully supports all line dashing forms, while other viewers only " "accept a limited subset." msgstr "PyMuPDFはすべての線の破線形式を完全にサポートしていますが、他のビューアは一部の形式しか受け入れません。" #: ../../recipes-common-issues-and-their-solutions.rst:158 #: 01eaf095c9b6491d88ab187baa0e5739 msgid "Solutions" msgstr "解決策" #: ../../recipes-common-issues-and-their-solutions.rst:159 #: ecb162091bfd40ba807179842faf6a91 msgid "Unfortunately there is not much you can do in most of these cases." msgstr "残念ながら、これらの多くの場合、あまり対処できることはありません。" #: ../../recipes-common-issues-and-their-solutions.rst:161 #: f4ff16b309524593aafb3a90fa47384c msgid "Stay with the same software for **creating and changing** an annotation." msgstr "注釈の作成と変更に同じソフトウェアを使用してください。" #: ../../recipes-common-issues-and-their-solutions.rst:162 #: ddc8bae66d8249efbc79df236e51d0d0 msgid "" "When using PyMuPDF to change an \"alien\" annotation, try to **avoid** " ":meth:`Annot.update`. The following methods **can be used without it,** " "so that the original appearance should be maintained:" msgstr "" "\"異なる\"注釈を変更する際にPyMuPDFを使用する場合、:meth:`Annot.update` " "を避けるようにしてください。次のメソッドは、元の外観を維持するために、:meth:`Annot.update` を使用せずに使用できます：" #: ../../recipes-common-issues-and-their-solutions.rst:164 #: 57c092ce6a7d45d4952de8c67279fa4f msgid ":meth:`Annot.set_rect` (location changes)" msgstr ":meth:`Annot.set_rect` (位置の変更)" #: ../../recipes-common-issues-and-their-solutions.rst:165 #: d313ef9ae75449729e1849ab57d05a32 msgid ":meth:`Annot.set_flags` (annotation behaviour)" msgstr ":meth:`Annot.set_flags` (注釈の動作)" #: ../../recipes-common-issues-and-their-solutions.rst:166 #: ff9f33feb2224cd69192417071637524 msgid ":meth:`Annot.set_info` (meta information, except changes to *content*)" msgstr ":meth:`Annot.set_info` (メタ情報、*コンテンツ* の変更以外)" #: ../../recipes-common-issues-and-their-solutions.rst:167 #: 90c72eaaebfa4a848238a0cd487b74e6 msgid ":meth:`Annot.set_popup` (create popup or change its rect)" msgstr ":meth:`Annot.set_popup` (ポップアップの作成または位置の変更)" #: ../../recipes-common-issues-and-their-solutions.rst:168 #: fea8fa06e33040f2b13ce9a7b5306f8f #, fuzzy msgid "" ":meth:`Annot.set_oc` (add / remove reference to optional content " "information)" msgstr ":meth:`Annot.set_optional_content` (オプションコンテンツ情報への参照の追加/削除)" #: ../../recipes-common-issues-and-their-solutions.rst:169 #: cee27cf68bda482690d014a3468ad911 msgid ":meth:`Annot.set_open`" msgstr "" #: ../../recipes-common-issues-and-their-solutions.rst:170 #: 85c766ba5c7c4ec9a875af07684f5f8f msgid ":meth:`Annot.update_file` (file attachment changes)" msgstr ":meth:`Annot.update_file` (ファイル添付の変更)" #: ../../recipes-common-issues-and-their-solutions.rst:174 #: 6e6d7441feb444b08da4f309c51f2989 msgid "Missing or Unreadable Extracted Text" msgstr "欠落または読み取り不可能な抽出テキスト" #: ../../recipes-common-issues-and-their-solutions.rst:175 #: 01ae9eb704e14a1e8f24cf021dc91c0e msgid "" "Fairly often, text extraction does not work text as you would expect: " "text may be missing, or may not appear in the reading sequence visible on" " your screen, or contain garbled characters (like a ? or a \"TOFU\" " "symbol), etc. This can be caused by a number of different problems." msgstr "非常にしばしば、テキスト抽出が期待通りに機能しないことがあります。テキストが欠落しているか、画面上で表示される読み取り順序に表示されないか、文字が文字化けしている（「？」や「TOFU」シンボルなど）ことがあります。これはさまざまな問題が原因で起こる可能性があります。" #: ../../recipes-common-issues-and-their-solutions.rst:178 #: e80411b38d4845d9b2714609a65db94c msgid "Problem: no text is extracted" msgstr "問題：テキストが抽出されない" #: ../../recipes-common-issues-and-their-solutions.rst:179 #: 29d32a1dea084e1886b86272d02868c8 msgid "" "Your PDF viewer does display text, but you cannot select it with your " "cursor, and text extraction delivers nothing." msgstr "PDFビューアはテキストを表示しているが、カーソルで選択できず、テキストの抽出結果が何も表示されない。" #: ../../recipes-common-issues-and-their-solutions.rst:183 #: 407916e2cc0148868141e8b6e9837feb msgid "" "You may be looking at an image embedded in the PDF page (e.g. a scanned " "PDF)." msgstr "PDFページに埋め込まれた画像を表示している可能性がある（例：スキャンされたPDF）。" #: ../../recipes-common-issues-and-their-solutions.rst:184 #: 94397a359e604251a6ce3e563fe0ef48 msgid "" "The PDF creator used no font, but **simulated** text by painting it, " "using little lines and curves. E.g. a capital \"D\" could be painted by a" " line \"|\" and a left-open semi-circle, an \"o\" by an ellipse, and so " "on." msgstr "PDFの作成者がフォントを使用せず、テキストをペイントして小さな線と曲線を使用して模倣している場合がある。たとえば、大文字の「D」は縦棒「|」と左開きの半円で描かれ、「o」は楕円で描かれるなど。" #: ../../recipes-common-issues-and-their-solutions.rst:187 #: ../../recipes-common-issues-and-their-solutions.rst:200 #: 4fedb4cf875041c2a5e70dae89f7991f fb8a38a5ca084321aac57be8d1ebb7bb msgid "Solution" msgstr "解決策" #: ../../recipes-common-issues-and-their-solutions.rst:188 #: 3ab64c25a2be4f59907562b0f68b24dc msgid "" "Use an OCR software like `OCRmyPDF `_" " to insert a hidden text layer underneath the visible page. The resulting" " PDF should behave as expected." msgstr "" "`OCRmyPDF `_ " "のようなOCRソフトウェアを使用して、表示ページの下に非表示のテキストレイヤーを挿入します。その結果のPDFは期待どおりに動作するはずです。" #: ../../recipes-common-issues-and-their-solutions.rst:191 #: a8f6e51df1dc464fbb0f7475eba7a54b msgid "Problem: unreadable text" msgstr "問題：読み取れないテキスト" #: ../../recipes-common-issues-and-their-solutions.rst:192 #: 7e6f3f7dc9964fac985a7fb4c533b3f2 msgid "" "Text extraction does not deliver the text in readable order, duplicates " "some text, or is otherwise garbled." msgstr "テキストの抽出が読みやすい順序で行われず、一部のテキストが重複しているか、その他の理由で文字化けしている。" #: ../../recipes-common-issues-and-their-solutions.rst:196 #: 060884ca10f34a9fa6daba7b2794c592 msgid "" "The single characters are readable as such (no \"\" symbols), but the " "sequence in which the text is **coded in the file** deviates from the " "reading order. The motivation behind may be technical or protection of " "data against unwanted copies." msgstr "個々の文字はそのまま読み取れるが（「」シンボルがない）、テキストがファイル内でコード化された順序が読み取り順序と異なる場合がある。その背後には技術的な問題やデータの不正なコピーからの保護がある可能性がある。" #: ../../recipes-common-issues-and-their-solutions.rst:197 #: 99dd9930809d4551bfe5d806b32e28bc msgid "" "Many \"\" symbols occur, indicating MuPDF could not interpret these " "characters. The font may indeed be unsupported by MuPDF, or the PDF " "creator may haved used a font that displays readable text, but on purpose" " obfuscates the originating corresponding unicode character." msgstr "多くの「」シンボルが表示され、MuPDFがこれらの文字を解釈できないことを示している場合。フォントがMuPDFでサポートされていない可能性があるか、PDFの作成者が読み取り可能なテキストを表示するフォントを使用しているが、意図的に元の対応するUnicode文字を曖昧にしている場合があります。" #: ../../recipes-common-issues-and-their-solutions.rst:201 #: 7e9a1b033ba149c29732bf6d66164707 msgid "Use layout preserving text extraction: `python -m fitz gettext file.pdf`." msgstr "レイアウトを保持するテキスト抽出を使用します： `python -m fitz gettext file.pdf`。" #: ../../recipes-common-issues-and-their-solutions.rst:202 #: 05bbf78e0c8c447794e360a1dda9f6df msgid "" "If other text extraction tools also don't work, then the only solution " "again is OCRing the page." msgstr "他のテキスト抽出ツールも機能しない場合は、再びOCRでページを処理するのが唯一の解決策です。" #: ../../footer.rst:60 8010577d7dfe46e7ab6edda3adc1976a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Misplaced Item Insertions on PDF Pages" #~ msgstr "PDFページ上の誤ったアイテムの挿入" #~ msgid "" #~ "You inserted an item (like an " #~ "image, an annotation or some text) " #~ "on an existing PDF page, but later" #~ " you find it being placed at a" #~ " different location than intended. For " #~ "example an image should be inserted " #~ "at the top, but it unexpectedly " #~ "appears near the bottom of the " #~ "page." #~ msgstr "既存のPDFページにアイテム（画像、注釈、テキストなど）を挿入しましたが、後で意図した場所とは異なる位置に配置されていることがあります。たとえば、画像はページの上部に挿入する予定でしたが、予想外にページの下部近くに表示されています。" #~ msgid "" #~ "The creator of the PDF has " #~ "established a non-standard page geometry" #~ " without keeping it \"local\" (as " #~ "they should!). Most commonly, the PDF" #~ " standard point (0,0) at *bottom-" #~ "left* has been changed to the " #~ "*top-left* point. So top and bottom" #~ " are reversed -- causing your " #~ "insertion to be misplaced." #~ msgstr "PDFの作成者が標準ではないページジオメトリを設定しており、それを「ローカル」に保持していないためです（正しい方法で保持すべきです）。最も一般的には、PDF標準の座標（0,0）が左下にある点から、左上の点に変更されています。したがって、上下が逆転し、挿入が誤って配置されてしまいます。" #~ msgid "" #~ "The visible image of a PDF page" #~ " is controlled by commands coded in" #~ " a special mini-language. For an " #~ "overview of this language consult " #~ "\"Operator Summary\" on pp. 643 of " #~ "the :ref:`AdobeManual`. These commands are " #~ "stored in :data:`contents` objects as " #~ "strings (*bytes* in PyMuPDF)." #~ msgstr "" #~ "PDFページの可視イメージは、特別なミニ言語でコード化されたコマンドによって制御されています。この言語の概要については、 " #~ ":ref:`AdobeManual` のpp. " #~ "643にある「オペレーターサマリー」を参照してください。これらのコマンドは、 :data:`contents` " #~ "オブジェクトに文字列（PyMuPDFではバイト）として格納されます。" #~ msgid "" #~ "There are commands in that language, " #~ "which change the coordinate system of" #~ " the page for all the following " #~ "commands. In order to limit the " #~ "scope of such commands to \"local\", " #~ "they must be wrapped by the " #~ "command pair *q* (\"save graphics " #~ "state\", or \"stack\") and *Q* " #~ "(\"restore graphics state\", or \"unstack\")." #~ msgstr "この言語には、次に続くすべてのコマンドの座標系を変更するコマンドがあります。このようなコマンドのスコープを「ローカル」に制限するためには、コマンドペアq（「グラフィックスステートの保存」または「スタック」）およびQ（「グラフィックスステートの復元」または「アンスタック」）で囲む必要があります。" #~ msgid "So the PDF creator did this::" #~ msgstr "したがって、PDFの作成者は次のように行いました::" #~ msgid "where they should have done this::" #~ msgstr "正しくは、次のように行うべきでした::" #~ msgid "" #~ "In the mini-language's syntax, spaces" #~ " and line breaks are equally accepted" #~ " token delimiters." #~ msgstr "ミニ言語の構文では、スペースと改行は同様にトークンの区切りとして受け入れられます。" #~ msgid "Multiple consecutive delimiters are treated as one." #~ msgstr "複数の連続した区切りは、1つとして扱われます。" #~ msgid "" #~ "Keywords \"stream\" and \"endstream\" are " #~ "inserted automatically -- not by the " #~ "programmer." #~ msgstr "キーワード「stream」と「endstream」は自動的に挿入されます - プログラマーによって挿入されるものではありません。" #~ msgid "" #~ "Since v1.16.0, there is the property " #~ ":attr:`Page.is_wrapped`, which lets you check" #~ " whether a page's contents are " #~ "wrapped in that string pair." #~ msgstr "v1.16.0以降、プロパティPage.is_wrappedがあり、ページの内容がその文字列ペアでラップされているかどうかを確認できます。" #~ msgid "" #~ "If it is ``False`` or if you " #~ "want to be on the safe side, " #~ "pick one of the following:" #~ msgstr "それが `False` であるか、安全側に立ちたい場合、次のいずれかを選択してください：" #~ msgid "" #~ "The easiest way: in your script, " #~ "do a :meth:`Page.clean_contents` before you" #~ " do your first item insertion." #~ msgstr "最も簡単な方法：スクリプトで最初のアイテム挿入を行う前に :meth:`Page.clean_contents` を実行します。" #~ msgid "" #~ "Pre-process your PDF with the " #~ "MuPDF command line utility *mutool clean" #~ " -c ...* and work with its " #~ "output file instead." #~ msgstr "PDFをMuPDFコマンドラインユーティリティ `mutool clean -c …` で前処理し、その出力ファイルで作業します。" #~ msgid "" #~ "Directly wrap the page's :data:`contents` " #~ "with the stacking commands before you" #~ " do your first item insertion." #~ msgstr "最初のアイテム挿入を行う前に、直接ページの内容をスタッキングコマンドでラップします。" #~ msgid "" #~ "**Solutions 1. and 2.** use the " #~ "same technical basis and **do a " #~ "lot more** than what is required " #~ "in this context: they also clean " #~ "up other inconsistencies or redundancies " #~ "that may exist, multiple */Contents* " #~ "objects will be concatenated into one," #~ " and much more." #~ msgstr "" #~ "**解決策1と2** " #~ "は同じ技術的基盤を使用しており、この文脈で必要なもの以上のことを行います：他の不整合や冗長性もクリーンアップされ、複数の " #~ "*/Contents* オブジェクトが1つに結合されるなど、さまざまな操作が行われます。" #~ msgid "" #~ "For **incremental saves,** solution 1. " #~ "has an unpleasant implication: it will" #~ " bloat the update delta, because it" #~ " changes so many things and, in " #~ "addition, stores the **cleaned contents " #~ "uncompressed**. So, if you use " #~ ":meth:`Page.clean_contents` you should consider " #~ "**saving to a new file** with (at" #~ " least) *garbage=3* and *deflate=True*." #~ msgstr "" #~ "増分保存の場合、解決策1には不快な影響があります：多くの変更を行い、さらにクリーンされた内容を非圧縮で保存するため、更新デルタが膨れる可能性があります。したがって、" #~ " :meth:`Page.clean_contents` を使用する場合は、（少なくとも） " #~ "`garbage=3` および `deflate=True` " #~ "を指定して新しいファイルに保存することを検討する必要があります。" #~ msgid "" #~ "**Solution 3.** is completely under your" #~ " control and only does the minimum" #~ " corrective action. There is a handy" #~ " utility method :meth:`Page.wrap_contents` which" #~ " -- as twe name suggests -- " #~ "**wraps** the page's :data:`contents` " #~ "object(s) by the PDF commands `q` " #~ "and `Q`." #~ msgstr "" #~ "**解決策3** は完全にあなたの制御下にあり、最小限の修正しか行いません。便利なユーティリティメソッド " #~ ":meth:`Page.wrap_contents` があり、名前が示すように、ページの内容 " #~ "(:data:`contents`) オブジェクトをPDFコマンド `q` と `Q`" #~ " でラップします。" #~ msgid "" #~ "This solution is extremely fast and " #~ "the changes to the PDF are " #~ "minimal. This is useful in situations" #~ " where incrementally saving the file " #~ "is desirable -- or even a must " #~ "when the PDF has been digitally " #~ "signed and you cannot change this " #~ "status." #~ msgstr "この解決策は非常に高速で、PDFへの変更は最小限です。これは、ファイルを増分保存することが望ましい場合、またはPDFがデジタル署名されており、このステータスを変更できない場合に便利です。" #~ msgid "We recommend the following snippet to get the situation under control:" #~ msgstr "次のスニペットを使用して状況をコントロールすることをお勧めします：" #~ msgid "How to Deal with Messages Issued by :title:`MuPDF`" #~ msgstr ":title:`MuPDF` から発行されるメッセージの処理方法" #~ msgid "" #~ "Since |PyMuPDF| v1.16.0, **error messages**" #~ " issued by the underlying :title:`MuPDF`" #~ " library are being redirected to the" #~ " Python standard device *sys.stderr*. So" #~ " you can handle them like any " #~ "other output going to this devices." #~ msgstr "" #~ "PyMuPDF v1.16.0以降、基盤となるMuPDFライブラリから発行されるエラーメッセージは、Python標準デバイス" #~ " *sys.stderr* " #~ "にリダイレクトされます。したがって、これらのメッセージはこのデバイスに出力される他の出力と同様に扱うことができます。" #~ msgid "" #~ "In addition, these messages go to " #~ "the internal buffer together with any" #~ " :title:`MuPDF` warnings -- see below." #~ msgstr "さらに、これらのメッセージはMuPDFの警告とともに内部バッファに送られます - 以下を参照してください。" #~ msgid "" #~ "We always prefix these messages with " #~ "an identifying string *\"mupdf:\"*. If " #~ "you prefer to not see recoverable " #~ "MuPDF errors at all, issue the " #~ "command `pymupdf.TOOLS.mupdf_display_errors(False)`." #~ msgstr "" #~ "これらのメッセージは常に識別用の文字列 `\"mupdf:\"` " #~ "で始まります。復旧可能なMuPDFエラーを全く表示したくない場合は、コマンド " #~ "`pymupdf.TOOLS.mupdf_display_errors(False)` を発行してください。" #~ msgid "" #~ "MuPDF warnings continue to be stored " #~ "in an internal buffer and can be" #~ " viewed using :meth:`Tools.mupdf_warnings`." #~ msgstr "MuPDFの警告は引き続き内部バッファに保存され、 :meth:`Tools.mupdf_warnings` を使用して表示できます。" #~ msgid "" #~ "Please note that MuPDF errors may " #~ "or may not lead to Python " #~ "exceptions. In other words, you may " #~ "see error messages from which MuPDF " #~ "can recover and continue processing." #~ msgstr "MuPDFのエラーがPython例外につながる場合とつながらない場合があることに注意してください。言い換えれば、MuPDFが回復して処理を続けることができるエラーメッセージが表示される可能性があります。" #~ msgid "" #~ "Example output for a **recoverable " #~ "error**. We are opening a damaged " #~ "PDF, but MuPDF is able to repair" #~ " it and gives us a little " #~ "information on what happened. Then we" #~ " illustrate how to find out whether" #~ " the document can later be saved " #~ "incrementally. Checking the " #~ ":attr:`Document.is_dirty` attribute at this " #~ "point also indicates that during " #~ "`pymupdf.open` the document had to be" #~ " repaired:" #~ msgstr "" #~ "回復可能なエラーの例出力です。損傷したPDFを開いていますが、MuPDFはそれを修復し、何が起こったかに関する少しの情報を提供しています。その後、ドキュメントが後で増分保存できるかどうかを調べる方法も示しています。この時点で" #~ " :attr:`Document.is_dirty` 属性をチェックすることも、 `pymupdf.open`" #~ " の際にドキュメントを修復する必要があったことを示しています::" #~ msgid "Example output for an **unrecoverable error**:" #~ msgstr "**復旧できないエラー**の例出力:" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-drawing-and-graphics.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 cb49434c487144e990e8778af438e31c msgid "Artifex" msgstr "" #: ../../header.rst:-1 b51ec2c5bec0471caa6c704e84d440e8 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 5049a6512fcf48e592552896861b4264 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-drawing-and-graphics.rst:7 c0b1ffca482b4acc93f866d4c279b9d4 msgid "Drawing and Graphics" msgstr "描画とグラフィックス" #: ../../recipes-drawing-and-graphics.rst:11 cead69fa4d944be19c81d6669a194971 msgid "" "When the terms \"Drawings\" or \"Graphics\" are mentioned here we are " "referring to \"Vector Graphics\" or \"Line Art\"." msgstr "ここで「Drawings」や「Graphics」という用語が言及されている場合、それは「ベクトルグラフィックス」や「線画」を指しています。" #: ../../recipes-drawing-and-graphics.rst:13 688ad77eb281436f8d8c2e421a35ccae msgid "Therefore please consider these terms as being synonymous!" msgstr "したがって、これらの用語を同義語として考えてください。" #: ../../recipes-drawing-and-graphics.rst:16 d4e85709e4c54144a43b7930cee0c0b5 msgid "" "PDF files support elementary drawing operations as part of their syntax. " "These are **vector graphics** and include basic geometrical objects like " "lines, curves, circles, rectangles including specifying colors." msgstr "PDFファイルは、その構文の一部として基本的な描画操作をサポートしています。これらは**ベクトルグラフィックス**であり、線、曲線、円、長方形などの基本的な幾何学的オブジェクトを含み、色の指定も可能です。" #: ../../recipes-drawing-and-graphics.rst:18 9cd89e5c62e34160bf2adcbf9cb4d393 msgid "" "The syntax for such operations is defined in \"A Operator Summary\" on " "page 643 of the :ref:`AdobeManual`. Specifying these operators for a PDF " "page happens in its :data:`contents` objects." msgstr "" "このような操作の構文は、:ref:`AdobeManual` の「A Operator " "Summary」のページ643で定義されています。PDFページのためのこれらのオペレータは、その内容 " "(:data:`contents`)オブジェクト内で指定されます。" #: ../../recipes-drawing-and-graphics.rst:20 4a3ebf96479040d49b72aa665e43f8a3 msgid "" "|PyMuPDF| implements a large part of the available features via its " ":ref:`Shape` class, which is comparable to notions like \"canvas\" in " "other packages (e.g. `reportlab `_)." msgstr "" "PyMuPDFは、 :ref:`Shape` クラスを介して利用可能な多くの機能を実装しており、これは他のパッケージ（例： `reportlab " "`_ など）の「キャンバス」のような概念と類似しています。" #: ../../recipes-drawing-and-graphics.rst:22 1bcec4ef8d0a4c69a61128221389abfa msgid "" "A shape is always created as a **child of a page**, usually with an " "instruction like `shape = page.new_shape()`. The class defines numerous " "methods that perform drawing operations on the page's area. For example, " "`last_point = shape.draw_rect(rect)` draws a rectangle along the borders " "of a suitably defined `rect = pymupdf.Rect(...)`." msgstr "" "シェイプは常にページの子として作成され、通常は `shape = page.new_shape()` " "のような命令で行います。このクラスは、ページの領域に描画操作を実行するための多数のメソッドを定義しています。たとえば、 `last_point =" " shape.draw_rect(rect)` は、適切に定義された `rect = pymupdf.Rect(…)` " "の境界に沿って四角形を描画します。" #: ../../recipes-drawing-and-graphics.rst:24 522b5200167c42fc91bcda96ab482884 msgid "" "The returned *last_point* **always** is the :ref:`Point` where drawing " "operation ended (\"last point\"). Every such elementary drawing requires " "a subsequent :meth:`Shape.finish` to \"close\" it, but there may be " "multiple drawings which have one common ``finish()`` method." msgstr "" "返されるlast_pointは常に描画操作が終了する :ref:`Point` " "（「最後のポイント」）です。このような基本的な描画ごとに、それを「閉じる」ために :meth:`Shape.finish` " "が必要ですが、1つの共通の``finish()``メソッドを持つ複数の描画があるかもしれません。" #: ../../recipes-drawing-and-graphics.rst:26 a1a6cf576e374185b575ac29ef915ceb msgid "" "In fact, :meth:`Shape.finish` *defines* a group of preceding draw " "operations to form one -- potentially rather complex -- graphics object. " "|PyMuPDF| provides several predefined graphics in `shapes_and_symbols.py " "`_ which demonstrate " "how this works." msgstr "" "実際には、 :meth:`Shape.finish` " "は、1つの（潜在的に非常に複雑な）グラフィックオブジェクトを形成するための前の描画操作のグループを定義します。PyMuPDFは、これがどのように機能するかを示す" " `shapes_and_symbols.py `_ " "内のいくつかの事前定義されたグラフィックスを提供しています。" #: ../../recipes-drawing-and-graphics.rst:28 6682ec89ed0243e1a7c05a40ab825358 msgid "" "If you import this script, you can also directly use its graphics as in " "the following example::" msgstr "このスクリプトをインポートすると、次の例のようにそのグラフィックスを直接使用することもできます::" #: ../../recipes-drawing-and-graphics.rst:86 ccbd2af5bfaa46dcbe5f2f15e412fc23 msgid "This is the script's outcome:" msgstr "これがスクリプトの結果です:" #: ../../recipes-drawing-and-graphics.rst:97 65b162adbc52489e95a0170bada6afe9 msgid "How to Extract Drawings" msgstr "描画の抽出方法" #: ../../recipes-drawing-and-graphics.rst:99 8373533f008548a89798eddeba96f9d8 msgid "New in v1.18.0" msgstr "v1.18.0で新登場" #: ../../recipes-drawing-and-graphics.rst:101 0acd4de5d8554ebaa10b1347a50cf1de msgid "" "Drawing commands (**vector graphics**) issued by a page can be extracted " "as a list of dictionaries. Interestingly, this is possible for :ref:`all " "supported document types` -- not just PDF: so you " "can use it for XPS, EPUB and others as well." msgstr "" "ページから発行された描画コマンドを抽出できます。興味深いことに、これはすべての :ref:`サポートされている " "` ドキュメントタイプに対して可能です – PDFだけでなく、XPS、EPUBなどにも使用できます。" #: ../../recipes-drawing-and-graphics.rst:103 7a07bc7541854578ad35f95ad5dfc330 msgid "" "Page method, :meth:`Page.get_drawings()` accesses draw commands and " "converts them into a list of Python dictionaries. Each dictionary -- " "called a \"path\" -- represents a separate drawing -- it may be simple " "like a single line, or a complex combination of lines and curves " "representing one of the shapes of the previous section." msgstr "" ":ref:`Page` メソッド、:meth:`Page.get_drawings()` " "は描画コマンドにアクセスし、それらをPythonの辞書のリストに変換します。各辞書 – 「パス」と呼ばれる – は個別の描画を表します – " "それは単純な単一の線であるか、前のセクションの形状の1つを表す線と曲線の複雑な組み合わせであるかもしれません。" #: ../../recipes-drawing-and-graphics.rst:105 7ffb5ff050964de093cfe20336fa283d msgid "" "The *path* dictionary has been designed such that it can easily be used " "by the :ref:`Shape` class and its methods. Here is an example for a page " "with one path, that draws a red-bordered yellow circle inside rectangle " "`Rect(100, 100, 200, 200)`::" msgstr "" "パスの辞書は、 :ref:`Shape` " "クラスとそのメソッドで簡単に使用できるように設計されています。以下は、1つのパスを持つページの例で、そのパスは `Rect(100, 100, " "200, 200)` の内側に赤い境界線の黄色い円を描画します::" #: ../../recipes-drawing-and-graphics.rst:140 c1f4f56de6e1441f988e21f4184bed57 msgid "" "You need (at least) 4 Bézier curves (of 3rd order) to draw a circle with " "acceptable precision. See this `Wikipedia article " "`_ for some background." msgstr "" "適切な精度で円を描画するには、（少なくとも）4つの3次ベジエ曲線が必要です。背景については、この `Wikipediaの記事 " "`_ を参照してください。" #: ../../recipes-drawing-and-graphics.rst:143 be59d541be214b669a9c6663ca6abcd1 msgid "" "The following is a code snippet which extracts the drawings of a page and" " re-draws them on a new page::" msgstr "以下は、ページの描画を抽出し、それらを新しいページに再描画するコードの断片です::" #: ../../recipes-drawing-and-graphics.rst:194 660c9c99b6864b26ad3a377cf1d1f343 msgid "" "As can be seen, there is a high congruence level with the :ref:`Shape` " "class. With one exception: For technical reasons `lineCap` is a tuple of " "3 numbers here, whereas it is an integer in :ref:`Shape` (and in PDF). So" " we simply take the maximum value of that tuple." msgstr "" "ご覧の通り、 :ref:`Shape` クラスとの高い一致度があります。ただし1つ例外があります。技術的な理由から、ここでは `lineCap` " "は3つの数字のタプルですが、 :ref:`Shape` クラス（およびPDF内）では整数です。そのため、そのタプルの最大値を単純に取得します。" #: ../../recipes-drawing-and-graphics.rst:196 d8e69210bfb24c3ebf97b7efbc549af6 msgid "" "Here is a comparison between input and output of an example page, created" " by the previous script:" msgstr "以下は、前のスクリプトで作成された例のページの入力と出力の比較です。" #: ../../recipes-drawing-and-graphics.rst:201 9fc8264dcf1f4bfd98a7c1ad1aa9aee3 msgid "" "The reconstruction of graphics, like shown here, is not perfect. The " "following aspects will not be reproduced as of this version:" msgstr "ここに示されているようなグラフィックスの再構築は完璧ではありません。次の点は、このバージョンでは再現されません：" #: ../../recipes-drawing-and-graphics.rst:203 8166cbf0fbaf40bb8343e4d7155fc0ce msgid "" "Page definitions can be complex and include instructions for not showing " "/ hiding certain areas to keep them invisible. Things like this are " "ignored by :meth:`Page.get_drawings` - it will always return all paths." msgstr "" "ページの定義は複雑になる可能性があり、特定の領域を表示しない/非表示にするための指示を含むことがあります。こうしたことは、 " ":meth:`Page.get_drawings` によって無視されます – このメソッドは常にすべてのパスを返します。" #: ../../recipes-drawing-and-graphics.rst:205 fd360aa336ff48d2b72658c63221a561 msgid "" "You can use the path list to make your own lists of e.g. all lines or all" " rectangles on the page and subselect them by criteria, like color or " "position on the page etc." msgstr "パスのリストを使用して、ページ上のすべての線またはすべての四角形などのリストを作成し、色やページ上の位置などの基準でサブセレクトすることができます。" #: ../../recipes-drawing-and-graphics.rst:210 93b3944bb9e543f48ca901f90fb021e4 msgid "How to Delete Drawings" msgstr "描画の削除方法" #: ../../recipes-drawing-and-graphics.rst:212 094bb3cfc57b4461b8e1fea1652d63a5 msgid "" "To delete drawings/vector graphics we must use a :ref:`Redaction " "Annotation ` with the bounding box of the drawing " "and then **add and apply** a redaction to it to delete it." msgstr "" "描画やベクトルグラフィックスを削除するには、その描画の境界ボックスを持つ " ":ref:`赤字アノテーション` を使用し、それに赤字を **追加して適用する** 必要があります。" #: ../../recipes-drawing-and-graphics.rst:215 2f4f8d0e3e694181a5ce64ea3ccbe672 msgid "" "The following code shows an example of deleting the first drawing found " "on the page::" msgstr "以下のコードは、ページ上で最初に見つかった描画を削除する例を示しています：" #: ../../recipes-drawing-and-graphics.rst:225 edf0ff01d38248c8b9f6608213f47b52 msgid "" "See :meth:`Page.apply_redactions` for the parameter options which can be " "sent - you are able to apply deletion options to image, drawing and text " "objects which are bound by the annotation area." msgstr "" ":meth:`Page.apply_redactions` " "には送信できるパラメータオプションがあります。アノテーション領域によって境界付けられたイメージ、描画、テキストオブジェクトに削除オプションを適用できます。" #: ../../recipes-drawing-and-graphics.rst:229 ada7ddfefd1344ee94d178c3df118ae1 msgid "How to Draw Graphics" msgstr "グラフィックスを描画する方法" #: ../../recipes-drawing-and-graphics.rst:231 4606dbe6b222488fac1f4948be78ee37 msgid "" "Drawing graphics is as simple as calling the type of :meth:`Drawing " "Method ` you may want. You can draw graphics directly on " "pages or within shape objects." msgstr "" "グラフィックスを描画することは、必要な :meth:`描画方法 ` " "の種類を呼び出すだけです。グラフィックスは、ページ上または形状オブジェクト内に直接描画できます。" #: ../../recipes-drawing-and-graphics.rst:234 55d0693f8fc14f2e8744839a6f7afe99 msgid "For example, to draw a circle::" msgstr "例えば、円を描画するには：" #: ../../recipes-drawing-and-graphics.rst:245 1426496584b041f18b185bc3ee064f75 msgid "" "The :ref:`Shape` object can be used to combine multiple drawings that " "should receive common properties as specified by :meth:`Shape.finish`." msgstr "" ":ref:`Shape` オブジェクトは、:meth:`Shape.finish` " "で指定された共通のプロパティを受け取る必要がある複数の描画を組み合わせるために使用できます。" #: ../../footer.rst:60 15d9c97491bd46d9806555b60b5da2ed msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-images.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 e08ff8c04b304218ac81d35f41292ac6 msgid "Artifex" msgstr "" #: ../../header.rst:-1 a1f1910f4f4b427c872afb309d8717ae msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 067d19d0feee4d3ea790680243bcadde msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-images.rst:7 57931bcbe871420b8981b5294574c1f6 msgid "Images" msgstr "画像" #: ../../recipes-images.rst:14 c30d7e40298f4ae28b6931514dcdda2d msgid "How to Make Images from Document Pages" msgstr "ドキュメントページから画像を作成する方法" #: ../../recipes-images.rst:16 a5b0953e89e6485ea0cc82a8785e31cf msgid "" "This little script will take a document filename and generate a PNG file " "from each of its pages." msgstr "この小さなスクリプトは、文書のファイル名を取得し、各ページからPNGファイルを生成します。" #: ../../recipes-images.rst:18 f1183a990e834decbf12969a97c76cf8 msgid "The document can be any :ref:`supported type`." msgstr "文書の種類は、:ref:`サポートされている ` どんな形式でも構いません。" #: ../../recipes-images.rst:20 86fd95ad8dba47ed87f53ab293cc7058 msgid "" "The script works as a command line tool which expects the filename being " "supplied as a parameter. The generated image files (1 per page) are " "stored in the directory of the script::" msgstr "このスクリプトはコマンドラインツールとして動作し、ファイル名をパラメータとして指定することを期待しています。生成された画像ファイル（1ページごとに1つ）は、スクリプトが格納されているディレクトリに保存されます。::" #: ../../recipes-images.rst:29 3e69a1bf5a8d49978cfc9c8dabfc3648 msgid "" "The script directory will now contain PNG image files named *page-0.png*," " *page-1.png*, etc. Pictures have the dimension of their pages with width" " and height rounded to integers, e.g. 595 x 842 pixels for an A4 portrait" " sized page. They will have a resolution of 96 dpi in x and y dimension " "and have no transparency. You can change all that -- for how to do this, " "read the next sections." msgstr "" "スクリプトのディレクトリには、これから *page-0.png* 、 *page-1.png* " "などという名前のPNG画像ファイルが含まれるようになります。画像は各ページの寸法に合わせて整数に丸められた幅と高さを持ちます。例えば、A4縦向きのページであれば595" " x 842ピクセルとなります。これらの画像は水平方向と垂直方向の解像度が96 " "dpiで、透明度はありません。これらの設定を変更することもできます。詳細については、次のセクションをお読みください。" #: ../../recipes-images.rst:37 338b2dd52c564f7d9850839bb2b6e0c9 msgid "How to Increase :index:`Image Resolution `" msgstr "画像の解像度を上げる方法" #: ../../recipes-images.rst:39 4770c88fce1d4a0782d7b461b2a4c8b6 msgid "" "The image of a document page is represented by a :ref:`Pixmap`, and the " "simplest way to create a pixmap is via method :meth:`Page.get_pixmap`." msgstr "" "文書ページの画像はPixmapによって表されます。 :ref:`Pixmap` を作成するもっとも簡単な方法は、メソッド " ":meth:`Page.get_pixmap` を使うことです。" #: ../../recipes-images.rst:41 fe71e979e90a4e36ab7e012b4e4cfbaf msgid "" "This method has many options to influence the result. The most important " "among them is the :ref:`Matrix`, which lets you :index:`zoom`, rotate, " "distort or mirror the outcome." msgstr "このメソッドには結果に影響を与える多くのオプションがあります。その中でも最も重要なのは行列（Matrix）であり、これによって結果を拡大、回転、歪ませる、または反転することができます。" #: ../../recipes-images.rst:43 879c14c6b55746e184a6a3659ddb8624 msgid "" ":meth:`Page.get_pixmap` by default will use the :ref:`Identity` matrix, " "which does nothing." msgstr ":meth:`Page.get_pixmap` はデフォルトで :ref:`Identity` 行列を使用しますが、これは何も行いません。" #: ../../recipes-images.rst:45 7ae61bca1b914ef58650814764c86556 msgid "" "In the following, we apply a :index:`zoom factor `" " of 2 to each dimension, which will generate an image with a four times " "better resolution for us (and also about 4 times the size)::" msgstr "以下では、各次元に2倍のズームを適用し、結果として解像度が4倍向上した画像を生成します（そしてサイズも約4倍になります）。::" #: ../../recipes-images.rst:53 a015d3083e624dd0bb52595296bcda69 msgid "" "Since version 1.19.2 there is a more direct way to set the resolution: " "Parameter `\"dpi\"` (dots per inch) can be used in place of `\"matrix\"`." " To create a 300 dpi image of a page specify `pix = " "page.get_pixmap(dpi=300)`. Apart from notation brevity, this approach has" " the additional advantage that the **dpi value is saved with the image** " "file -- which does not happen automatically when using the Matrix " "notation." msgstr "" "バージョン1.19.2以降では、解像度を設定するより直接的な方法があります。 `\"dpi\"` （インチあたりのドット数）というパラメータを " "`\"matrix\"` の代わりに使用することができます。ページの300 dpiの画像を作成するには、 `pix = " "page.get_pixmap(dpi=300)` " "と指定します。略記法の利便性に加えて、この方法の追加の利点は、dpiの値が画像ファイルとともに保存されることです。これはMatrixの記法を使用する場合に自動的に行われることはありません。" #: ../../recipes-images.rst:61 8e820a068673426d8b07c503b4b9b1eb msgid "How to Create :index:`Partial Pixmaps` (Clips)" msgstr "部分的なPixmap（クリップ）の作成方法" #: ../../recipes-images.rst:62 3575f660d7f34fcf8740261d5cc13939 msgid "" "You do not always need or want the full image of a page. This is the case" " e.g. when you display the image in a GUI and would like to fill the " "respective window with a zoomed part of the page." msgstr "常にページの完全な画像が必要なわけではありませんし、必要ともしない場合があります。例えば、GUIで画像を表示し、ページのズームされた部分でウィンドウを埋めたい場合などが該当します。" #: ../../recipes-images.rst:64 91a6b74e53dc47bba254ef54f6903677 msgid "" "Let's assume your GUI window has room to display a full document page, " "but you now want to fill this room with the bottom right quarter of your " "page, thus using a four times better resolution." msgstr "GUIウィンドウにフルの文書ページを表示するスペースがあると仮定しましょうが、現在はページの右下の四分の一でこのスペースを埋めたいとします。これにより、解像度が4倍向上します。" #: ../../recipes-images.rst:66 0c121baa24eb407eb7c91b5f481189c8 msgid "" "To achieve this, define a rectangle equal to the area you want to appear " "in the GUI and call it \"clip\". One way of constructing rectangles in " "PyMuPDF is by providing two diagonally opposite corners, which is what we" " are doing here." msgstr "これを実現するために、GUIに表示したい領域に等しい矩形を定義し、「クリップ」と呼びます。PyMuPDFでは、矩形を構築する方法の1つは、対角線上にある2つの角を指定することです。これがここで行っていることです。" #: ../../recipes-images.rst:79 355e4acbef614ba299f86cec24da6c88 msgid "" "In the above we construct *clip* by specifying two diagonally opposite " "points: the middle point *mp* of the page rectangle, and its bottom " "right, *rect.br*." msgstr "" "上記では、 `clip` を構築するために、2つの対角線上の点を指定しています：ページ矩形の中心点である `mp` と、その右下の点である " "`rect.br` です。" #: ../../recipes-images.rst:87 39c83e942ce74cb9baddcc259d24777e msgid "How to Zoom a Clip to a GUI Window" msgstr "GUIウィンドウにクリップをズームする方法" #: ../../recipes-images.rst:88 5ffea1d8340c4a08939f161390fd42ae msgid "" "Please also read the previous section. This time we want to **compute the" " zoom factor** for a clip, such that its image best fits a given GUI " "window. This means, that the image's width or height (or both) will equal" " the window dimension. For the following code snippet you need to provide" " the WIDTH and HEIGHT of your GUI's window that should receive the page's" " clip rectangle." msgstr "前のセクションもお読みください。今回は、クリップのズームファクターを計算して、その画像が指定されたGUIウィンドウに最適にフィットするようにします。つまり、画像の幅または高さ（または両方）がウィンドウの寸法と等しくなります。次のコードスニペットでは、GUIウィンドウのWIDTHとHEIGHTを提供する必要があります。それらはページのクリップ矩形を受け取る必要があります。" #: ../../recipes-images.rst:105 61635a6d0bae4040986c0bd5b66441a2 msgid "" "For the other way round, now assume you **have** the zoom factor and need" " to **compute the fitting clip**." msgstr "逆の場合は、ズームファクターがあると仮定し、フィッティングクリップを計算する必要があります。" #: ../../recipes-images.rst:107 2903b44af458484da6825578d79b1da4 msgid "" "In this case we have `zoom = HEIGHT/clip.height = WIDTH/clip.width`, so " "we must set `clip.height = HEIGHT/zoom` and, `clip.width = WIDTH/zoom`. " "Choose the top-left point `tl` of the clip on the page to compute the " "right pixmap::" msgstr "" "この場合、 `zoom = HEIGHT/clip.height = WIDTH/clip.width` となるので、 `clip.height" " = HEIGHT/zoom` および `clip.width = WIDTH/zoom` " "と設定する必要があります。クリップ内のページ上の左上の点 tl を選択して、適切なピクマップを計算します。" #: ../../recipes-images.rst:124 956b4a0c798e4b199a96b3f962fadf70 msgid "How to Create or Suppress Annotation Images" msgstr "注釈画像の作成または抑制方法" #: ../../recipes-images.rst:125 88238495026f4e289613d5e50b81a474 msgid "" "Normally, the pixmap of a page also shows the page's annotations. " "Occasionally, this may not be desirable." msgstr "通常、ページのピクマップにはページの注釈も表示されます。しかし、時にはこれが望ましくない場合があります。" #: ../../recipes-images.rst:127 7cec58430afd46ed9e720d3b6fa029db msgid "" "To suppress the annotation images on a rendered page, just specify " "`annots=False` in :meth:`Page.get_pixmap`." msgstr "描画されたページから注釈画像を抑制するには、 :meth:`Page.get_pixmap` で `annots=False` を指定します。" #: ../../recipes-images.rst:129 f75aaef8eaa54984a2d2fe045e60d421 msgid "" "You can also render annotations separately: they have their own " ":meth:`Annot.get_pixmap` method. The resulting pixmap has the same " "dimensions as the annotation rectangle." msgstr "" "注釈を個別にレンダリングすることもできます。注釈には独自の :meth:`Annot.get_pixmap` " "メソッドがあります。結果のピクマップは注釈の矩形と同じ寸法です。" #: ../../recipes-images.rst:141 9ff376603198474f97ccc539fa162925 msgid "How to Extract Images: Non-PDF Documents" msgstr "画像の抽出方法：非PDFドキュメント" #: ../../recipes-images.rst:143 e1ee913277e849ab932b9b97874133c3 msgid "" "In contrast to the previous sections, this section deals with " "**extracting** images **contained** in documents, so they can be " "displayed as part of one or more pages." msgstr "前のセクションとは対照的に、このセクションではドキュメントに含まれる画像の抽出に取り組みます。これにより、これらの画像を1つ以上のページの一部として表示することができます。" #: ../../recipes-images.rst:145 a1a829c4fe444807b6db244124c9137d msgid "" "If you want to recreate the original image in file form or as a memory " "area, you have basically two options:" msgstr "元の画像をファイル形式またはメモリ領域として再作成したい場合、基本的に2つのオプションがあります：" #: ../../recipes-images.rst:147 773185000e944e7daeaf940ca6fda472 msgid "" "Convert your document to a PDF, and then use one of the PDF-only " "extraction methods. This snippet will convert a document to PDF::" msgstr "ドキュメントをPDFに変換し、その後PDF専用の抽出方法のいずれかを使用します。以下のスニペットはドキュメントをPDFに変換します::" #: ../../recipes-images.rst:153 6416afce3c7447f98cbcd8b2d98214dd msgid "" "Use :meth:`Page.get_text` with the \"dict\" parameter. This works for all" " document types. It will extract all text and images shown on the page, " "formatted as a Python dictionary. Every image will occur in an image " "block, containing meta information and **the binary image data**. For " "details of the dictionary's structure, see :ref:`TextPage`. The method " "works equally well for PDF files. This creates a list of all images shown" " on a page::" msgstr "" "「dict」パラメータを使って :meth:`Page.get_text` " "を使用します。これはすべてのドキュメントタイプに対して機能します。これにより、ページに表示されているすべてのテキストと画像がPythonの辞書としてフォーマットされて抽出されます。各画像は、メタ情報とバイナリ画像データを含む画像ブロックに含まれます。辞書の構造の詳細については、" " :ref:`TextPage` " "を参照してください。この方法はPDFファイルにも同じくうまく機能します。これにより、ページに表示されているすべての画像のリストが作成されます::" #: ../../recipes-images.rst:182 28308796e3ad4f7abf4d6c2b939aca48 msgid "How to Extract Images: PDF Documents" msgstr "画像の抽出方法：PDFドキュメント" #: ../../recipes-images.rst:184 0fc3745f79b8438d9b922c7957f09651 msgid "" "Like any other \"object\" in a PDF, images are identified by a cross " "reference number (:data:`xref`, an integer). If you know this number, you" " have two ways to access the image's data:" msgstr "" "PDF内の他のオブジェクトと同様に、画像は交差参照番号（ :data:`xref` " "、整数）によって識別されます。この番号を知っていれば、画像のデータにアクセスする方法が2つあります：" #: ../../recipes-images.rst:186 f2a6f39609bb4bcb838f8d7a34a28da5 msgid "" "**Create** a :ref:`Pixmap` of the image with instruction *pix = " "pymupdf.Pixmap(doc, xref)*. This method is **very** fast (single digit " "micro-seconds). The pixmap's properties (width, height, ...) will reflect" " the ones of the image. In this case there is no way to tell which image " "format the embedded original has." msgstr "" "**画像の** :ref:`Pixmap` を作成します。指示： `pix = pymupdf.Pixmap(doc, xref)` " "。この方法は非常に高速です（単桁のマイクロ秒）。 :ref:`Pixmap` " "のプロパティ（幅、高さなど）は、画像のものと同じになります。この場合、埋め込まれたオリジナルの画像形式を判別する方法はありません。" #: ../../recipes-images.rst:188 903b6e9628bb4a0ea1ad4d2ff2f35557 msgid "" "**Extract** the image with *img = doc.extract_image(xref)*. This is a " "dictionary containing the binary image data as *img[\"image\"]*. A number" " of meta data are also provided -- mostly the same as you would find in " "the pixmap of the image. The major difference is string *img[\"ext\"]*, " "which specifies the image format: apart from \"png\", strings like " "\"jpeg\", \"bmp\", \"tiff\", etc. can also occur. Use this string as the " "file extension if you want to store to disk. The execution speed of this " "method should be compared to the combined speed of the statements *pix = " "pymupdf.Pixmap(doc, xref);pix.tobytes()*. If the embedded image is in PNG" " format, the speed of :meth:`Document.extract_image` is about the same " "(and the binary image data are identical). Otherwise, this method is " "**thousands of times faster**, and the **image data is much smaller**." msgstr "" "**画像を抽出します。指示**： `img = doc.extract_image(xref)` " "。これはバイナリ画像データを含む辞書です。多くのメタデータも提供されますが、主に画像の :ref:`Pixmap` " "で見つけることができるものとほぼ同じです。主な違いは、文字列 img[\"ext\"] であり、画像形式を指定します。\"png\" 以外にも " "\"jpeg\" 、 \"bmp\"、 \"tiff\" " "などの文字列が出現することがあります。ディスクに保存する場合は、この文字列をファイル拡張子として使用します。このメソッドの実行速度は、以下のステートメントの組み合わせ速度" " `pix = pymupdf.Pixmap(doc, xref);pix.tobytes()` " "と比較する必要があります。埋め込まれた画像がPNG形式の場合、 :meth:`Document.extract_image` " "の速度はほぼ同じで（バイナリ画像データも同じです）、それ以外の場合は、このメソッドは数千倍高速であり、画像データも小さくなります" #: ../../recipes-images.rst:190 110186a162f04f83955d7d59285d446b msgid "" "The question remains: **\"How do I know those 'xref' numbers of " "images?\"**. There are two answers to this:" msgstr "**「どのようにして画像の'xref'番号を知るのか？」** これには2つの答えがあります：" #: ../../recipes-images.rst:192 ad8338028ef944a19307f2547e05528f msgid "" "**\"Inspect the page objects:\"** Loop through the items of " ":meth:`Page.get_images`. It is a list of list, and its items look like " "*[xref, smask, ...]*, containing the :data:`xref` of an image. This " ":data:`xref` can then be used with one of the above methods. Use this " "method for **valid (undamaged)** documents. Be wary however, that the " "same image may be referenced multiple times (by different pages), so you " "might want to provide a mechanism avoiding multiple extracts." msgstr "" "**「ページオブジェクトを検査する」** ： :meth:`Page.get_images` " "の項目をループ処理します。これはリストのリストであり、項目は `[xref、smask、...]` のようになっており、画像の " ":data:`xref` を含んでいます。この :data:`xref` " "を上記の方法の1つで使用できます。これは有効（損傷していない）なドキュメントに使用しますが、同じ画像が複数回（異なるページで）参照されることがあるため、複数回の抽出を避けるメカニズムを提供することが望ましいかもしれません。" #: ../../recipes-images.rst:193 afeb949615fb470d958fdfc35b1fe9dd msgid "" "**\"No need to know:\"** Loop through the list of **all xrefs** of the " "document and perform a :meth:`Document.extract_image` for each one. If " "the returned dictionary is empty, then continue -- this :data:`xref` is " "no image. Use this method if the PDF is **damaged (unusable pages)**. " "Note that a PDF often contains \"pseudo-images\" (\"stencil masks\") with" " the special purpose of defining the transparency of some other image. " "You may want to provide logic to exclude those from extraction. Also have" " a look at the next section." msgstr "" "**「知る必要はありません」**：ドキュメントのすべての :data:`xref` のリストをループ処理し、各 :data:`xref` に対して" " :meth:`Document.extract_image` を実行します。返される辞書が空であれば、続けて次の :data:`xref` " "を処理します。この :data:`xref` " "は画像ではありません。これはPDFが損傷している（使用できないページがある）場合に使用します。PDFにはしばしば他の画像の透明度を定義する特別な目的の「擬似画像」（ステンシルマスク）が含まれていることに注意してください。これらを抽出から除外するためのロジックを提供することがあるかもしれません。次のセクションも参照してください。" #: ../../recipes-images.rst:195 6d656f35aa69461f8e47b7f4bf499261 msgid "" "For both extraction approaches, there exist ready-to-use general purpose " "scripts:" msgstr "これらの抽出方法の両方に対して、一般的な用途のスクリプトが存在します。" #: ../../recipes-images.rst:197 490e93536036437fab679b20daac6f6a msgid "" "`extract-from-pages.py `_ " "extracts images page by page:" msgstr "" "`extract-from-pages.py `_ " "はページごとに画像を抽出します。" #: ../../recipes-images.rst:202 87adba5350a8467e87dc3f0e80cae1e4 msgid "" "and `extract-from-xref.py `_ " "extracts images by xref table:" msgstr "" "`extract-from-xref.py `_ " "はxrefテーブルによって画像を抽出します。" #: ../../recipes-images.rst:213 b53c02001e2f4f7391e6e9e880b0631f msgid "How to Handle Image Masks" msgstr "画像マスクの処理方法" #: ../../recipes-images.rst:214 32034dc3accf4622b51ead4c06f67509 msgid "" "Some images in PDFs are accompanied by **image masks**. In their simplest" " form, masks represent alpha (transparency) bytes stored as separate " "images. In order to reconstruct the original of an image, which has a " "mask, it must be \"enriched\" with transparency bytes taken from its " "mask." msgstr "PDF内の一部の画像には画像マスクが付属しています。最も単純な形式では、マスクは別の画像として格納されたアルファ（透明度）バイトを表します。画像の元の形を復元するには、そのマスクから取得した透明度バイトを使用して画像を「補完」する必要があります。" #: ../../recipes-images.rst:216 e0828025961548d4a2ed0f2e5b9cedf6 msgid "" "Whether an image does have such a mask can be recognized in one of two " "ways in PyMuPDF:" msgstr "PyMuPDFでは、画像にそのようなマスクがあるかどうかは次の2つの方法で認識できます：" #: ../../recipes-images.rst:218 4c26a844692448d6818018bc8e19f652 msgid "" "An item of :meth:`Document.get_page_images` has the general format " "`(xref, smask, ...)`, where :data:`xref` is the image's :data:`xref` and " "*smask*, if positive, then it is the :data:`xref` of a mask." msgstr "" ":meth:`Document.get_page_images` の項目は一般的な形式 `（xref、smask、...）` " "を持ちます。ここで、xrefは画像の :data:`xref` であり、 「smask」 が正の場合、それはマスクの :data:`xref` " "です。" #: ../../recipes-images.rst:219 8011ba0428cc4b87a64b8031ea34ea90 msgid "" "The (dictionary) results of :meth:`Document.extract_image` have a key " "*\"smask\"*, which also contains any mask's :data:`xref` if positive." msgstr "" ":meth:`Document.extract_image` の結果（辞書）には、キー「smask」があります。このキーには、マスクの " ":data:`xref` が含まれています。" #: ../../recipes-images.rst:221 65aadf1969e44334a7c86d7524a50702 msgid "" "If *smask == 0* then the image encountered via :data:`xref` can be " "processed as it is." msgstr "`smask == 0` の場合、 :data:`xref` を介して遭遇した画像はそのまま処理できます。" #: ../../recipes-images.rst:223 302ce99937d44ca995fcedb51c11aaae msgid "" "To recover the original image using PyMuPDF, the procedure depicted as " "follows must be executed:" msgstr "PyMuPDFを使用して元の画像を復元するためには、以下に示す手順を実行する必要があります：" #: ../../recipes-images.rst:232 df80dda6fd5a4c4db985e0cfa929ee0a msgid "" "Step (1) creates a pixmap of the basic image. Step (2) does the same with" " the image mask. Step (3) adds an alpha channel and fills it with " "transparency information." msgstr "ステップ（1）では、基本画像のピクマップを作成します。ステップ（2）では、同じことを画像マスクで行います。ステップ（3）では、アルファチャンネルを追加し、透明情報で埋めます。" #: ../../recipes-images.rst:234 4a160a9c64ac45caa88c66099e2af1b1 msgid "" "The scripts `extract-from-pages.py `_, " "and `extract-from-xref.py `_ " "above also contain this logic." msgstr "" "また、上記の `extract-from-pages.py `_ " "および `extract-from-xref.py `_ " "というスクリプトにもこのロジックが含まれています。" #: ../../recipes-images.rst:250 0f2b285905974f1b99efded1652e0905 msgid "How to Make one PDF of all your Pictures (or Files)" msgstr "すべての写真（またはファイル）を1つのPDFにする方法" #: ../../recipes-images.rst:251 8d8107e9ab0942c88a4abccc8f7092dc msgid "" "We show here **three scripts** that take a list of (image and other) " "files and put them all in one PDF." msgstr "以下に、（画像およびその他の）ファイルのリストを受け取り、それらをすべて1つのPDFに結合する3つのスクリプトを示します。" #: ../../recipes-images.rst:253 3df4d9f329c4453f9ca02d580bd2b3ba msgid "**Method 1: Inserting Images as Pages**" msgstr "**方法1：画像をページとして挿入する方法**" #: ../../recipes-images.rst:255 0bbd32458c89450b9f8adc7638530473 msgid "" "The first one converts each image to a PDF page with the same dimensions." " The result will be a PDF with one page per image. It will only work for " ":ref:`supported image` file formats::" msgstr "" "最初の方法では、各画像を同じ寸法のPDFページに変換します。結果は、1つの画像に1ページのPDFとなります。ただし、 " ":ref:`サポートされている ` 画像ファイル形式のみで動作します。::" #: ../../recipes-images.rst:278 959fd3ad51dc45daa6b1f1310ad95124 msgid "" "This will generate a PDF only marginally larger than the combined " "pictures' size. Some numbers on performance:" msgstr "これにより、結合された画像のサイズとほとんど変わらないPDFが生成されます。パフォーマンスに関するいくつかの数値：" #: ../../recipes-images.rst:280 4996fb148b334e01b2a6baaedf636b52 msgid "" "The above script needed about 1 minute on my machine for 149 pictures " "with a total size of 514 MB (and about the same resulting PDF size)." msgstr "上記のスクリプトは、149枚の画像で合計サイズが514 MBの場合、私のマシン上で約1分かかりました（生成されたPDFのサイズもほぼ同じです）。" #: ../../recipes-images.rst:285 b684aa875c574e47bc3fc5f6c15767d1 msgid "" "Look `here `_ for a more " "complete source code: it offers a directory selection dialog and skips " "unsupported files and non-file entries." msgstr "" "より完全なソースコードは `こちら `_ " "をご覧ください：ディレクトリ選択ダイアログを提供し、サポートされていないファイルやファイルでないエントリをスキップします。" #: ../../recipes-images.rst:287 03c855c845f74ac1bcf9ce3a7ee420c1 msgid "" "We might have used :meth:`Page.insert_image` instead of " ":meth:`Page.show_pdf_page`, and the result would have been a similar " "looking file. However, depending on the image type, it may store **images" " uncompressed**. Therefore, the save option *deflate = True* must be used" " to achieve a reasonable file size, which hugely increases the runtime " "for large numbers of images. So this alternative **cannot be " "recommended** here." msgstr "" ":meth:`Page.insert_image` の代わりに :meth:`Page.show_pdf_page` " "を使用することもできましたが、結果として似たような外観のファイルになります。ただし、画像の種類によっては、非圧縮で画像を保存する場合があります。そのため、適切なファイルサイズを得るためには、保存オプションとして" " `deflate = True` " "を使用する必要がありますが、これにより大量の画像の場合、実行時間が大幅に増加します。そのため、この代替方法はお勧めできません。" #: ../../recipes-images.rst:289 41c532d33e8f42a39bb7560b25d00787 msgid "**Method 2: Embedding Files**" msgstr "**方法2：ファイルの埋め込み**" #: ../../recipes-images.rst:291 490c3dd2b7d64db682e9ea9f27e723df msgid "" "The second script **embeds** arbitrary files -- not only images. The " "resulting PDF will have just one (empty) page, required for technical " "reasons. To later access the embedded files again, you would need a " "suitable PDF viewer that can display and / or extract embedded files::" msgstr "2つ目のスクリプトは、画像だけでなく、任意のファイルを埋め込みます。技術的な理由で必要なので、結果として得られるPDFには1つだけ（空の）ページがあります。埋め込まれたファイルに後でアクセスするためには、埋め込まれたファイルを表示または抽出できる適切なPDFビューアが必要です::" #: ../../recipes-images.rst:316 aa85ab6a4d7f4c068e437bc62ecde2f7 msgid "" "This is by far the fastest method, and it also produces the smallest " "possible output file size. The above pictures needed 20 seconds on my " "machine and yielded a PDF size of 510 MB. Look `here " "`_ for a more complete source code: it offers a directory" " selection dialog and skips non-file entries." msgstr "" "これは断然最も高速な方法であり、可能な限り最小の出力ファイルサイズを生成します。上記の画像は私のマシンで20秒かかり、PDFのサイズは510 " "MBになりました。より完全なソースコードは `こちら `_ " "をご覧ください：ディレクトリ選択ダイアログを提供し、ファイルでないエントリをスキップします。" #: ../../recipes-images.rst:318 a5e66a78eac4476db9b235257835f444 msgid "**Method 3: Attaching Files**" msgstr "**方法3：ファイルの添付**" #: ../../recipes-images.rst:320 25dd45dc2fc5483686500405d2daa76a msgid "" "A third way to achieve this task is **attaching files** via page " "annotations see `here `_ for the " "complete source code." msgstr "" "このタスクを達成する第3の方法は、ページの注釈を介してファイルを添付する方法です。完全なソースコードについては `こちら " "`_ をご覧ください。" #: ../../recipes-images.rst:322 fde0ae6309414feb89541d4ee22f054a msgid "" "This has a similar performance as the previous script and it also " "produces a similar file size. It will produce PDF pages which show a " "'FileAttachment' icon for each attached file." msgstr "これは前のスクリプトと同様のパフォーマンスを持ち、似たようなファイルサイズも生成します。それぞれの添付ファイルに対して「FileAttachment」アイコンが表示されるPDFページを生成します。" #: ../../recipes-images.rst:326 807309e9b6e0443c892b7a6d9f92f145 msgid "" "Both, the **embed** and the **attach** methods can be used for " "**arbitrary files** -- not just images." msgstr "埋め込みと添付の両方の方法は、画像だけでなく任意のファイルにも使用できます。" #: ../../recipes-images.rst:328 26ac29237c8d43398109384507fd51a8 msgid "" "We strongly recommend using the awesome package `PySimpleGUI " "`_ to display a progress meter for" " tasks that may run for an extended time span. It's pure Python, uses " "Tkinter (no additional GUI package) and requires just one more line of " "code!" msgstr "" "長時間にわたるタスクに対して進捗メーターを表示するために、素晴らしいパッケージ `PySimpleGUI " "`_ " "の使用を強くお勧めします。これは純粋なPythonであり、Tkinter（追加のGUIパッケージは不要）を使用し、たった1行のコードを追加するだけで使えます！" #: ../../recipes-images.rst:342 ebad9685f21841c2b8ee9ac84740ecf2 msgid "How to Create Vector Images" msgstr "ベクター画像の作成方法" #: ../../recipes-images.rst:343 40ce7c0f9b0044e3939ba507d3f936fd msgid "" "The usual way to create an image from a document page is " ":meth:`Page.get_pixmap`. A pixmap represents a raster image, so you must " "decide on its quality (i.e. resolution) at creation time. It cannot be " "changed later." msgstr "" "ドキュメントページから画像を作成する通常の方法は、 :meth:`Page.get_pixmap` " "を使用することです。ピクマップはラスター画像を表しますので、作成時にその品質（つまり解像度）を決定する必要があります。後から変更することはできません。" #: ../../recipes-images.rst:345 35c05b06ad73440aa94313c3f527dc97 msgid "" "PyMuPDF also offers a way to create a **vector image** of a page in SVG " "format (scalable vector graphics, defined in XML syntax). SVG images " "remain precise across zooming levels (of course with the exception of any" " raster graphic elements embedded therein)." msgstr "PyMuPDFはまた、SVG形式（XML構文で定義されたスケーラブルベクターグラフィックス）でページのベクター画像を作成する方法を提供しています。SVG画像はズームレベルで正確性を保持します（もちろん、埋め込まれたラスターグラフィックス要素を除く）。" #: ../../recipes-images.rst:347 3664556134d441ee8ca7d943fe0e97b5 msgid "" "Instruction *svg = page.get_svg_image(matrix=pymupdf.Identity)* delivers " "a UTF-8 string *svg* which can be stored with extension \".svg\"." msgstr "" "指示 `svg = page.get_svg_image(matrix=pymupdf.Identity)` はUTF-8文字列 *svg* " "を提供します。これは \".svg\" の拡張子で保存できます。" #: ../../recipes-images.rst:363 2e788e908541456db558a6d1e638447c msgid "How to Convert Images" msgstr "画像の変換方法" #: ../../recipes-images.rst:364 eaecfbf3be504291831504c4b64f18ba msgid "" "Just as a feature among others, PyMuPDF's image conversion is easy. It " "may avoid using other graphics packages like PIL/Pillow in many cases." msgstr "PyMuPDFの画像変換も他の機能と同様に簡単です。多くの場合、PIL/Pillowなどの他のグラフィックスパッケージを使用する必要がないかもしれません。" #: ../../recipes-images.rst:366 c3f0f2ee44ad425e8ec5c957c779fbd5 msgid "Notwithstanding that interfacing with Pillow is almost trivial." msgstr "ただし、Pillowとの連携はほとんど自明です。" #: ../../recipes-images.rst:369 6b90048732484c0bb7bfd07609cd24ce msgid "**Input Formats**" msgstr "**入力フォーマット**" #: ../../recipes-images.rst:369 07a5c9395a4c45299d51e3bd83222984 msgid "**Output Formats**" msgstr "**出力フォーマット**" #: ../../recipes-images.rst:369 8350dc457b254b8291594699ce54839d msgid "**Description**" msgstr "**説明**" #: ../../recipes-images.rst:371 0979a1ef86ea4e20a05e557a7442a3b2 msgid "BMP" msgstr "" #: ../../recipes-images.rst:371 ../../recipes-images.rst:373 #: ../../recipes-images.rst:374 ../../recipes-images.rst:375 #: ../../recipes-images.rst:376 ../../recipes-images.rst:383 #: ../../recipes-images.rst:384 0bacf30757bb4f319e65010549478182 #: 3ad593408aa445ce99d7f7d9479bca6d 55dc892386e3401f95cd320419c8edc9 #: 7df71f3343174cfb84397536f4af3a84 84d138cd65ae497681d5c605ce8f2af7 #: 95f327688bc1431c9523ec2101e353b0 c96232bb6e7340e2a5eb85364348a2a0 msgid "." msgstr "" #: ../../recipes-images.rst:371 5897545255814fd5ba5a65241d15eced msgid "Windows Bitmap" msgstr "" #: ../../recipes-images.rst:372 41f6b3399986413abe65e2869c4053ea #: d00191a3adf74e71b0459460b1c2e159 msgid "JPEG" msgstr "" #: ../../recipes-images.rst:372 d3b57018b2e3452080901854b19d1342 msgid "Joint Photographic Experts Group" msgstr "" #: ../../recipes-images.rst:373 a3bdd964789b43cbad6247e119a6c54a msgid "JXR" msgstr "" #: ../../recipes-images.rst:373 bbea31de8177475b8158cf220a94abcb msgid "JPEG Extended Range" msgstr "" #: ../../recipes-images.rst:374 809526ac7ac74d2fb28e089e82a225d7 msgid "JPX/JP2" msgstr "" #: ../../recipes-images.rst:374 9bf0ef68929647cd85f92ab8f862d849 msgid "JPEG 2000" msgstr "" #: ../../recipes-images.rst:375 c791169bcfe4452e80b2573539c06ef1 msgid "GIF" msgstr "" #: ../../recipes-images.rst:375 4a2960cefc3b47e496db085a39846137 msgid "Graphics Interchange Format" msgstr "" #: ../../recipes-images.rst:376 4dcf6574e1574eaf922b9851c56ab035 msgid "TIFF" msgstr "" #: ../../recipes-images.rst:376 df65730301314c1f95cb3c5315179281 msgid "Tagged Image File Format" msgstr "" #: ../../recipes-images.rst:377 492608579f5a466e93c3441942845056 #: 671fbf03f46c46f6a82cc000cfea3b33 msgid "PNG" msgstr "" #: ../../recipes-images.rst:377 6800194509e449b699a2f117857a1789 msgid "Portable Network Graphics" msgstr "" #: ../../recipes-images.rst:378 12727b15f7504523b43a9f77cc9a9923 #: 221349ddd94740f18dc2a986e2f63e53 msgid "PNM" msgstr "" #: ../../recipes-images.rst:378 7b091d14802241e4bba073bd5e0dc0d6 msgid "Portable Anymap" msgstr "" #: ../../recipes-images.rst:379 bf3bacb00fbe43da9d560e7fbe4f78f4 #: ed77816ad90043ff838934fe85431860 msgid "PGM" msgstr "" #: ../../recipes-images.rst:379 37c68be55f8c46a3a92da90ed0894ded msgid "Portable Graymap" msgstr "" #: ../../recipes-images.rst:380 6f4d332905c643b9899a52fd96de577c #: 8530d6f66aaf4ed8b8e74e8de3aaf662 msgid "PBM" msgstr "" #: ../../recipes-images.rst:380 78f4ada30b5940558d7575226b665930 msgid "Portable Bitmap" msgstr "" #: ../../recipes-images.rst:381 18ad666221cb4e268aac5b2adcb051bc #: e4ac66013a6b40ef8f5f8dbcc44cbf3d msgid "PPM" msgstr "" #: ../../recipes-images.rst:381 46c1b8ed50c14c30b04706c0bcee355d msgid "Portable Pixmap" msgstr "" #: ../../recipes-images.rst:382 4eee3125b6b24045bf368e25ea1ccfe7 #: 65190b879c2b49ce893b4dd5d72947a4 msgid "PAM" msgstr "" #: ../../recipes-images.rst:382 9cb3d8054e01459bad986a5ff4b72d76 msgid "Portable Arbitrary Map" msgstr "" #: ../../recipes-images.rst:383 172c0b24c3c74558b48cecb435b62a71 msgid "PSD" msgstr "" #: ../../recipes-images.rst:383 d957051043af4e16a05d1bab3b7846e0 msgid "Adobe Photoshop Document" msgstr "" #: ../../recipes-images.rst:384 61adad659533407383e3030a6a26682a msgid "PS" msgstr "" #: ../../recipes-images.rst:384 bd96837df2984e15953ba98f2ce8e7ca msgid "Adobe Postscript" msgstr "" #: ../../recipes-images.rst:387 2e9599f2f28e412f95d48fc8a90716c0 msgid "The general scheme is just the following two lines::" msgstr "一般的なスキームは以下の2行です::" #: ../../recipes-images.rst:392 6a1955099311437ea3d6c722779fe787 msgid "**Remarks**" msgstr "**コメント**" #: ../../recipes-images.rst:394 5e7c8ed9975341bb9b398e94977a1c35 msgid "" "The **input** argument of *pymupdf.Pixmap(arg)* can be a file or a bytes " "/ io.BytesIO object containing an image." msgstr "`pymupdf.Pixmap(arg)` の入力引数は、画像を含むファイルまたはbytes/io.BytesIOオブジェクトを指定できます。" #: ../../recipes-images.rst:395 29c03f633e3c4f85905a883594780a1a msgid "" "Instead of an output **file**, you can also create a bytes object via " "*pix.tobytes(\"yyy\")* and pass this around." msgstr "出力ファイルの代わりに、 `pix.tobytes(\"yyy\")` を使用してbytesオブジェクトを作成し、それを渡すこともできます。" #: ../../recipes-images.rst:396 08d941cbdcde49e7894c7cd54dceeb12 msgid "" "As a matter of course, input and output formats must be compatible in " "terms of colorspace and transparency. The ``Pixmap`` class has batteries " "included if adjustments are needed." msgstr "" "もちろん、入力と出力のフォーマットは、色空間と透過性の面で互換性が必要です。 :ref:`Pixmap` " "クラスには、必要に応じて調整を行うための組み込みの機能が備わっています。" #: ../../recipes-images.rst:399 3264d7f4236e472d9acb18b03a6c378f msgid "**Convert JPEG to Photoshop**::" msgstr "**JPEGをPhotoshopに変換する**::" #: ../../recipes-images.rst:405 03352131b8ff486f8481486724d51437 msgid "" "Convert **JPEG to Tkinter PhotoImage**. Any **RGB / no-alpha** image " "works exactly the same. Conversion to one of the **Portable Anymap** " "formats (PPM, PGM, etc.) does the trick, because they are supported by " "all Tkinter versions::" msgstr "アルファ付きのPNGをTkinterのPhotoImageに変換してください。これには、PPMへの変換を行う前にアルファバイトを削除する必要があります。" #: ../../recipes-images.rst:412 1d8ba60c17ef4537a879f8880ddf842e msgid "" "Convert **PNG with alpha** to Tkinter PhotoImage. This requires " "**removing the alpha bytes**, before we can do the PPM conversion::" msgstr "アルファ付きのPNGをTkinterのPhotoImageに変換します。このためには、PPMへの変換を行う前にアルファバイトを取り除く必要があります。" #: ../../recipes-images.rst:429 e998a366000347d1b54bed12c09423fd msgid "How to Use Pixmaps: Gluing Images" msgstr "ピクスマップの使用方法：画像の結合" #: ../../recipes-images.rst:431 f97460e4da964505a4f7c1625d462e07 msgid "" "This shows how pixmaps can be used for purely graphical, non-document " "purposes. The script reads an image file and creates a new image which " "consist of 3 * 4 tiles of the original::" msgstr "" "これは、ピクスマップを純粋にグラフィカルで、文書ではない目的で使用する方法を示しています。スクリプトは画像ファイルを読み込み、元の画像の3 * " "4タイルからなる新しい画像を作成します。" #: ../../recipes-images.rst:451 4e2ddaf362f641b79cccb12467620742 msgid "This is the input picture:" msgstr "これが入力画像です。" #: ../../recipes-images.rst:456 517480af4baf43568e79bdb13b6ab85c msgid "Here is the output:" msgstr "こちらが出力結果です。" #: ../../recipes-images.rst:473 172a0fbba4984e9cb6d93f6ed02742fa msgid "How to Use Pixmaps: Making a Fractal" msgstr "ピクスマップの使用方法：フラクタルの作成" #: ../../recipes-images.rst:475 18c71aef80304611bec96e98bcd38669 msgid "" "Here is another Pixmap example that creates **Sierpinski's Carpet** -- a " "fractal generalizing the **Cantor Set** to two dimensions. Given a square" " carpet, mark its 9 sub-suqares (3 times 3) and cut out the one in the " "center. Treat each of the remaining eight sub-squares in the same way, " "and continue *ad infinitum*. The end result is a set with area zero and " "fractal dimension 1.8928..." msgstr "" "ここでは、もう一つのピクスマップの例を紹介します。シェルピンスキーのカーペット（Sierpinski's " "Carpet）と呼ばれるフラクタルで、カントール集合を2次元に一般化したものです。正方形のカーペットにおいて、9つの部分正方形（3行3列）をマークし、中央の正方形を切り抜きます。残りの8つの部分正方形に対しても同じ操作を行い、無限に続けます。その結果、面積がゼロであり、フラクタル次元は1.8928...となります。" #: ../../recipes-images.rst:477 53c09705945d4ed3bec2d17b7c9f1581 msgid "" "This script creates an approximate image of it as a PNG, by going down to" " one-pixel granularity. To increase the image precision, change the value" " of n (precision)::" msgstr "このスクリプトは、1ピクセルの精度にまで細かくなったPNGの近似画像を作成します。画像の精度を高めるには、n（精度）の値を変更してください::" #: ../../recipes-images.rst:531 68789bca8b624ff491e93d5a400ff3ac msgid "The result should look something like this:" msgstr "結果は以下のようになるはずです：" #: ../../recipes-images.rst:541 93a642a1f6fb4a578a82d7b7baf97ad3 msgid "How to Interface with NumPy" msgstr "NumPyとのインターフェース方法" #: ../../recipes-images.rst:543 8f95a3058d5348dfa20391d4596a676e msgid "" "This shows how to create a PNG file from a numpy array (several times " "faster than most other methods)::" msgstr "これは、NumPy配列からPNGファイルを作成する方法を示しています（他の方法よりも数倍高速です）。" #: ../../recipes-images.rst:570 fe1a53c3297d463785209cfc2a811f98 msgid "How to Add Images to a PDF Page" msgstr "PDFページに画像を追加する方法" #: ../../recipes-images.rst:572 c4977664b53940488eefb7c79db6760f msgid "" "There are two methods to add images to a PDF page: " ":meth:`Page.insert_image` and :meth:`Page.show_pdf_page`. Both methods " "have things in common, but there are also differences." msgstr "" "PDFページに画像を追加するには、2つの方法があります： :meth:`Page.insert_image` と " ":meth:`Page.show_pdf_page` です。両方の方法には共通点がありますが、違いもあります。" #: ../../recipes-images.rst:575 05867b3cbf1e4cfbb8b56cd82480ca49 msgid "**Criterion**" msgstr "**基準**" #: ../../recipes-images.rst:575 1a4fb4ba40034ec697f3f519a1472c05 msgid ":meth:`Page.insert_image`" msgstr "" #: ../../recipes-images.rst:575 c77d016df1554917b7a351e1213d6d30 msgid ":meth:`Page.show_pdf_page`" msgstr "" #: ../../recipes-images.rst:577 adaf610a08404152879eecde101b3358 msgid "displayable content" msgstr "表示可能なコンテンツ" #: ../../recipes-images.rst:577 be7f0aa395a84ea0967b19ea32e118ad msgid "image file, image in memory, pixmap" msgstr "画像ファイル、メモリ内の画像、ピクスマップ " #: ../../recipes-images.rst:577 5dcf084c5bf14f44b42f33e83b39ffb0 msgid "PDF page" msgstr "PDFページ" #: ../../recipes-images.rst:578 b21f95bfb2da4d1da8dc1a8de8fcd793 msgid "display resolution" msgstr "表示解像度 " #: ../../recipes-images.rst:578 e5fb57d9b06e415496d5fdd4ad9d2860 msgid "image resolution" msgstr "画像の解像度 " #: ../../recipes-images.rst:578 f162cd0a2ec54a14bc65d19390efb3ab msgid "vectorized (except raster page content)" msgstr "ベクトル化（ラスターページコンテンツを除く）" #: ../../recipes-images.rst:579 8f71139fa4184451a269095eaf3b024d msgid "rotation" msgstr "回転" #: ../../recipes-images.rst:579 e07ae649fe5a43b98128e34d2b7295f4 msgid "0, 90, 180 or 270 degrees" msgstr "0度、90度、180度または270度" #: ../../recipes-images.rst:579 6f5358e1760c4bfca5a3a418b8c268ff msgid "any angle" msgstr "任意の角度" #: ../../recipes-images.rst:580 fd811b11808e4d7fa0b6e434c51cc9de msgid "clipping" msgstr "クリッピング" #: ../../recipes-images.rst:580 c2558fbbf1774081b28e0116ee882210 msgid "no (full image only)" msgstr "いいえ（全体の画像のみ）" #: ../../recipes-images.rst:580 ../../recipes-images.rst:585 #: a907ff72bff14ccab44936c7756bc1a0 dc5568a67d5546399d10903c2198e7b1 msgid "yes" msgstr "はい" #: ../../recipes-images.rst:581 9be3b939efd74eb9b064149922973fd7 msgid "keep aspect ratio" msgstr "アスペクト比を保持" #: ../../recipes-images.rst:581 90e967a63c944ad2a4d5d5e1a1e1f586 #: ae736e0e2d874c22a9ff0e8ec0eafd07 msgid "yes (default option)" msgstr "はい（デフォルトオプション）" #: ../../recipes-images.rst:582 149cd46d36314fd9983779124a4b00a5 msgid "transparency (water marking)" msgstr "透明性（ウォーターマーキング）" #: ../../recipes-images.rst:582 f5ee92e1f762447294b068b3151cf8ba msgid "depends on the image" msgstr "画像による" #: ../../recipes-images.rst:582 48bce5fbaea9451c8a0205e90189408b msgid "depends on the page" msgstr "ページによる" #: ../../recipes-images.rst:583 b0cc7970f86848258e39444054ac610b msgid "location / placement" msgstr "位置/配置 " #: ../../recipes-images.rst:583 3d965dc24e154178970ddf5ed7662f16 #: 5a690d8091e446ac921b5a5e97de9884 msgid "scaled to fit target rectangle" msgstr "ターゲットの矩形にフィットするようにスケーリング" #: ../../recipes-images.rst:584 78fa2e33851d443584542c9de0f6ea73 msgid "performance" msgstr "パフォーマンス" #: ../../recipes-images.rst:584 07bc6beb376d4561bf3ed4427bfeada8 #: 883bd897a4de4ed2a0f2af42a61dd792 msgid "automatic prevention of duplicates;" msgstr "重複の自動防止" #: ../../recipes-images.rst:585 7ef2987d846a48a9a38bb80ba9ee36be msgid "multi-page image support" msgstr "マルチページ画像のサポート" #: ../../recipes-images.rst:585 02be9acec59f4fa3adf501ba7f63438f msgid "no" msgstr "いいえ" #: ../../recipes-images.rst:586 018cb20575654c4aa10c951f189464f3 msgid "ease of use" msgstr "使いやすさ" #: ../../recipes-images.rst:586 c28d925902ab48b389c171a05aca19c6 msgid "simple, intuitive;" msgstr "シンプルで直感的" #: ../../recipes-images.rst:586 afc67eb6d74a495c9dc4e53eb661ae08 msgid "" "simple, intuitive; **usable for all document types** (including images!) " "after conversion to PDF via :meth:`Document.convert_to_pdf`" msgstr "" "シンプルで直感的; :meth:`Document.convert_to_pdf` " "を介してPDFに変換後、すべてのドキュメントタイプ（画像を含む！）に使用可能" #: ../../recipes-images.rst:592 e4d67c78bd67458c84faeb0c8e6ea5f5 msgid "" "Basic code pattern for :meth:`Page.insert_image`. **Exactly one** of the " "parameters **filename / stream / pixmap** must be given, if not re-" "inserting an existing image::" msgstr "" ":meth:`Page.insert_image` の基本的なコードパターン。 **filename / stream / pixmap** " "のうち、1つだけを指定する必要があります（既存の画像を再挿入しない場合）::" #: ../../recipes-images.rst:607 a7bbf44ff07e494bb6788af779c4f19f msgid "" "Basic code pattern for :meth:`Page.show_pdf_page`. Source and target PDF " "must be different :ref:`Document` objects (but may be opened from the " "same file)::" msgstr "" ":meth:`Page.show_pdf_page` の基本的なコードパターン。ソースとターゲットのPDFは異なる :ref:`Document`" " オブジェクトである必要があります（ただし、同じファイルから開くこともできます）::" #: ../../recipes-images.rst:623 247c3cb945de42e3977137d8975573b2 msgid "How to Use Pixmaps: Checking Text Visibility" msgstr "ピクスマップの使用方法：テキストの表示可否の確認" #: ../../recipes-images.rst:625 265feb286a04491a9466ccd75f125d7a msgid "" "Whether or not a given piece of text is actually visible on a page " "depends on a number of factors:" msgstr "特定のテキストが実際にページ上で表示されるかどうかは、いくつかの要因に依存します：" #: ../../recipes-images.rst:627 cb95f70cf5474c549b283bb06a5b637d msgid "" "Text is not covered by another object but may have the same color as the " "background i.e., white-on-white etc." msgstr "テキストは他のオブジェクトによって隠されていないが、背景と同じ色を持っている場合があります。例えば、白文字が白地になっているなどです。" #: ../../recipes-images.rst:628 d8c9eec28274456bbae7dfd39049394b msgid "" "Text may be covered by an image or vector graphics. Detecting this is an " "important capability, for example to uncover badly anonymized legal " "documents." msgstr "テキストは画像やベクトルグラフィックスによって隠されている場合があります。これを検出することは重要な機能であり、例えば不適切に匿名化された法的文書を解明するために使用されます。" #: ../../recipes-images.rst:629 54573a8eea4e421ca5e82c476f55b0e9 msgid "" "Text is created hidden. This technique is usually used by OCR tools to " "store the recognized text in an invisible layer on the page." msgstr "テキストが非表示に作成される場合があります。これは通常、OCRツールが認識されたテキストをページ上の非表示レイヤーに保存するために使用されます。" #: ../../recipes-images.rst:631 421ec6799ba94504a184bb6003eeeac8 msgid "" "The following shows how to detect situation 1. above, or situation 2. if " "the covering object is unicolor::" msgstr "以下では、1.の状況を検出する方法、または2.の状況を検出する方法（カバーしているオブジェクトが単色である場合）を示します::" #: ../../recipes-images.rst:645 a958215274f14ffc9a1039c6445e57ec msgid "" "Method :meth:`Pixmap.color_topusage` returns a tuple `(ratio, pixel)` " "where 0 < ratio <= 1 and *pixel* is the pixel value of the color. Please " "note that we create a **pixmap only once**. This can save a lot of " "processing time if there are multiple hit rectangles." msgstr "" "メソッド :meth:`Pixmap.color_topusage` は、タプル `(ratio, pixel)` " "（比率、ピクセル）を返します。ここで、0 < ratio <= " "1であり、pixelは色のピクセル値です。複数のヒット矩形がある場合、ピクスマップを1回だけ作成することに注意してください。これにより、処理時間を大幅に節約できます。" #: ../../recipes-images.rst:647 675626a41d9f4ee49cee5bb637261c3f msgid "" "The logic of the above code is: If the needle's rectangle is (\"almost\":" " > 95%) unicolor, then the text cannot be visible. A typical result for " "visible text returns the color of the background (mostly white) and a " "ratio around 0.7 to 0.8, for example `(0.685, b'\\xff\\xff\\xff')`." msgstr "" "上記のコードのロジックは次の通りです：もしニードルの矩形が「ほぼ」（95％以上）単色であれば、テキストは表示されないと判断します。テキストが表示される場合の典型的な結果は、背景の色（主に白）と比率が0.7から0.8程度で返されることがあります。例えば、`(0.685," " b'xffxffxff')` のような結果が得られます。" #: ../../footer.rst:60 20230f8c88394d47a41e985bb5942765 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-journalling.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 1dec65ff7f144a209a6670156424f1bd msgid "Artifex" msgstr "" #: ../../header.rst:-1 a2496778c1824e0d8507743948d5699d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 d11779a821a640a9b5f1a505bdf860e4 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-journalling.rst:7 71340aa0c4f8460eb610827b5dd6a0e2 msgid "Journalling" msgstr "ジャーナリング" #: ../../recipes-journalling.rst:10 982db193623640f18388d6961fe5fc64 msgid "" "Starting with version 1.19.0, journalling is possible when updating PDF " "documents." msgstr "バージョン1.19.0から、PDFドキュメントの更新時にジャーナリングが可能になりました。" #: ../../recipes-journalling.rst:12 239c97bb5a8f4f329aa3e2fcd8a01db7 msgid "" "Journalling is a logging mechanism which permits either **reverting** or " "**re-applying** changes to a PDF. Similar to LUWs \"Logical Units of " "Work\" in modern database systems, one can group a set of updates into an" " \"operation\". In MuPDF journalling, an operation plays the role of a " "LUW." msgstr "ジャーナリングは、PDFへの変更を元に戻したり再適用したりするためのログ記録メカニズムです。近代的なデータベースシステムにおける「論理ユニット・オブ・ワーク（LUW）」のように、一連の更新を「操作」としてグループ化することができます。MuPDFジャーナリングでは、操作がLUWの役割を果たします。" #: ../../recipes-journalling.rst:14 2e4f6dca544a400cb7dc16a559d9e182 msgid "" "In contrast to LUW implementations found in database systems, MuPDF " "journalling happens on a **per document level**. There is no support for " "simultaneous updates across multiple PDFs: one would have to establish " "one's own logic here." msgstr "データベースシステムで見られるLUWの実装とは異なり、MuPDFジャーナリングはドキュメント単位で行われます。複数のPDFで同時に更新するためのサポートはありません。それぞれのPDFに対して独自のロジックを確立する必要があります。" #: ../../recipes-journalling.rst:16 001589c65f8641d5a1bc838871c82e35 msgid "" "Journalling must be *enabled* via a document method. Journalling is " "possible for existing or new documents. Journalling **can be disabled " "only** by closing the file." msgstr "ジャーナリングは、ドキュメントメソッドを介して有効にする必要があります。既存のドキュメントまたは新規ドキュメントのジャーナリングが可能です。ファイルを閉じることでのみジャーナリングを無効にすることができます。" #: ../../recipes-journalling.rst:17 a4f5223ab97d41c0a62d52cebe7f3f76 msgid "" "Once enabled, every change must happen inside an *operation* -- otherwise" " an exception is raised. An operation is started and stopped via document" " methods. Updates happening between these two calls form an LUW and can " "thus collectively be rolled back or re-applied, or, in MuPDF terminology " "\"undone\" resp. \"redone\"." msgstr "有効になると、すべての変更は操作の内部で行われる必要があります。そうでない場合、例外が発生します。操作はドキュメントメソッドを介して開始および停止されます。これらの呼び出し間で行われる更新はLUWを形成し、集合的に元に戻すか再適用するために使用できます。MuPDFの用語で言えば、「元に戻す」または「やり直す」ことができます。" #: ../../recipes-journalling.rst:18 25ef245260a64a689f1ba395d0478ac2 msgid "" "At any point, the journalling status can be queried: whether journalling " "is active, how many operations have been recorded, whether \"undo\" or " "\"redo\" is possible, the current position inside the journal, etc." msgstr "いつでも、ジャーナリングの状態をクエリできます。ジャーナリングがアクティブかどうか、いくつの操作が記録されたか、元に戻すかやり直すかが可能か、ジャーナル内の現在位置などがわかります。" #: ../../recipes-journalling.rst:19 892e3b69463b47138a6b723746d7696b msgid "" "The journal can be **saved to** or **loaded from** a file. These are " "document methods." msgstr "ジャーナルはファイルに保存またはロードできます。これらはドキュメントメソッドです。" #: ../../recipes-journalling.rst:20 cdc871b87c994a95b38a0893539bf950 msgid "" "When loading a journal file, compatibility with the document is checked " "and journalling is automatically enabled upon success." msgstr "ジャーナルファイルをロードする際には、ドキュメントとの互換性がチェックされ、成功した場合に自動的にジャーナリングが有効になります。" #: ../../recipes-journalling.rst:21 1196a86518ec42bca06599556dfdd95a msgid "" "For an **existing** PDF being journalled, a special new save method is " "available: :meth:`Document.save_snapshot`. This performs a special " "incremental save that includes all journalled updates so far. If its " "journal is saved at the same time (immediately after the document " "snapshot), then document and journal are in sync and can later on be used" " together to undo or redo operations or to continue journalled updates --" " just as if there had been no interruption." msgstr "" "ジャーナリングされている既存のPDFに対しては、特別な新しい保存メソッドが利用可能です。:meth:`Document.save_snapshot`" " " "これにより、これまでにジャーナリングされたすべての更新を含む特別なインクリメンタル保存が行われます。そのジャーナルも同時に保存される場合（ドキュメントスナップショットの直後に保存）、ドキュメントとジャーナルは同期され、後で操作を元に戻したりやり直したりするために一緒に使用できるようになります。まるで中断がなかったかのように。" #: ../../recipes-journalling.rst:22 9d858c95d29142a3a507fa019d4e9d37 msgid "" "The snapshot PDF is a valid PDF in every aspect and fully usable. If the " "document is however changed in any way without using its journal file, " "then a desynchronization will take place and the journal is rendered " "unusable." msgstr "スナップショットPDFは、あらゆる側面で有効なPDFであり、完全に使用可能です。ただし、ジャーナルファイルを使用せずにドキュメントが変更された場合、同期が取れなくなり、ジャーナルは利用できなくなります。" #: ../../recipes-journalling.rst:23 4e9981f3904e441abb451168eda31059 msgid "" "Snapshot files are structured like incremental updates. Nevertheless, the" " internal journalling logic requires, that saving **must happen to a new " "file**. So the user should develop a file naming convention to support " "recognizable relationships between an original PDF, like `original.pdf` " "and its snapshot sets, like `original-snap1.pdf` / `original-snap1.log`, " "`original-snap2.pdf` / `original-snap2.log`, etc." msgstr "" "スナップショットファイルはインクリメンタルな更新のように構造化されています。ただし、内部のジャーナリングロジックでは、新しいファイルに保存する必要があります。したがって、ユーザーはオリジナルのPDF（例：" " `original.pdf` ）とそのスナップショットセット（例： `original-snap1.pdf` / `original-" "snap1.log` 、 `original-snap2.pdf` / `original-snap2.log` " "など）の間に認識可能な関係をサポートするためのファイル命名規則を開発する必要があります。" #: ../../recipes-journalling.rst:26 264672a5144c439aa2688cf062e5a892 msgid "Example Session 1" msgstr "例セッション1" #: ../../recipes-journalling.rst:27 ../../recipes-journalling.rst:98 #: 8fc51b450a4641898c023ca78938b76c b070a7f183aa43c1952ff72bd0f73150 msgid "Description:" msgstr "説明：" #: ../../recipes-journalling.rst:29 47b36e04f5904ef6b8e643c6c2931dc9 msgid "" "Make a new PDF and enable journalling. Then add a page and some text " "lines -- each as a separate operation." msgstr "新しいPDFを作成し、ジャーナリングを有効にします。次に、ページを追加し、いくつかのテキスト行を別々の操作として追加します。" #: ../../recipes-journalling.rst:30 d39c4b27b3da4f7d87244024fe21133e msgid "" "Navigate within the journal, undoing and redoing these updates and " "displaying status and file results::" msgstr "ジャーナル内を移動し、これらの更新を元に戻したりやり直したりし、状態やファイルの結果を表示します::" #: ../../recipes-journalling.rst:97 7f4dff6cd221460f9f0864bb65418846 msgid "Example Session 2" msgstr "例セッション2" #: ../../recipes-journalling.rst:100 739153cf7c154739af31ab2abb5d842f msgid "" "Similar to previous, but after undoing some operations, we now add a " "different update. This will cause:" msgstr "前回と同様ですが、いくつかの操作を元に戻した後、異なる更新を追加します。これにより、次のことが起こります：" #: ../../recipes-journalling.rst:102 d1dfb6a4d5d948b6981dc9765882191b msgid "permanent removal of the undone journal entries" msgstr "元に戻されたジャーナルエントリが永久に削除されます。" #: ../../recipes-journalling.rst:103 19eab643d86a4d72b86f188ae3dd2592 msgid "the new update operation will become the new last entry." msgstr "新しい更新操作は新しい最後のエントリになります。" #: ../../footer.rst:60 187a959e74914bfe8f8d8164226852bd msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-low-level-interfaces.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7f129fba564145f8954ab3f7e226f0ec msgid "Artifex" msgstr "" #: ../../header.rst:-1 c67d240759fd40d187a0308599adeca9 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 076a135f5e7c4cc5bd9192d710ce8cdb msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-low-level-interfaces.rst:7 4f7ca622e5254dcb820080c8ec29fe16 msgid "Low-Level Interfaces" msgstr "低レベルインターフェース" #: ../../recipes-low-level-interfaces.rst:10 1fea1e3b7f2f4f31a3c902bf61e962c9 msgid "" "Numerous methods are available to access and manipulate PDF files on a " "fairly low level. Admittedly, a clear distinction between \"low level\" " "and \"normal\" functionality is not always possible or subject to " "personal taste." msgstr "PDFファイルにアクセスして操作するための多くのメソッドが低レベルで利用可能です。正直なところ、「低レベル」機能と「通常」機能の明確な区別は常にできるわけではなく、個人の好みによるところもあります。" #: ../../recipes-low-level-interfaces.rst:12 1de25fa4e10d4576a94ca8b7096618bd msgid "" "It also may happen, that functionality previously deemed low-level is " "later on assessed as being part of the normal interface. This has " "happened in v1.14.0 for the class :ref:`Tools` - you now find it as an " "item in the Classes chapter." msgstr "" "また、以前は低レベルと考えられていた機能が後に通常のインターフェースの一部として評価されることもあります。例えば、バージョン1.14.0ではクラス" " :ref:`Tools` についてそのようなことが起きており、現在では「Classes」のセクションで見つけることができます。" #: ../../recipes-low-level-interfaces.rst:14 1007d8a4ff5c4147805c1dc892b9b29c msgid "" "It is a matter of documentation only in which chapter of the " "documentation you find what you are looking for. Everything is available " "and always via the same interface." msgstr "何を探しているかに関しては、ドキュメントのどのセクションにあるかはドキュメンテーションのみの問題です。すべての情報は同じインターフェースを介して常に利用可能です。" #: ../../recipes-low-level-interfaces.rst:19 f087f3a96eec4b1a9dd86d6e8a3cffd7 msgid "How to Iterate through the :data:`xref` Table" msgstr ":data:`xref` テーブルのイテレーション方法" #: ../../recipes-low-level-interfaces.rst:20 0027f20fcd894b3f921d205dbf3c6fbb msgid "" "A PDF's :data:`xref` table is a list of all objects defined in the file. " "This table may easily contain many thousands of entries -- the manual " ":ref:`AdobeManual` for example has 127,000 objects. Table entry \"0\" is " "reserved and must not be touched. The following script loops through the " ":data:`xref` table and prints each object's definition::" msgstr "" "PDFの :data:`xref` " "テーブルはファイル内で定義されているすべてのオブジェクトのリストです。このテーブルには非常に多くのエントリが含まれることがあります - 例えば " ":ref:`AdobeManual` " "マニュアルには127,000のオブジェクトが含まれています。テーブルのエントリ「0」は予約されており、触れてはいけません" #: ../../recipes-low-level-interfaces.rst:32 bf35a4cef5db4592ba20e8879d737aff msgid "This produces the following output::" msgstr "これにより、以下の出力が生成されます::" #: ../../recipes-low-level-interfaces.rst:72 b83975ea49a84c1a8993fd6918a32c64 msgid "A PDF object definition is an ordinary ASCII string." msgstr "PDFオブジェクトの定義は通常のASCII文字列です。" #: ../../recipes-low-level-interfaces.rst:77 2cab525052174e5889a8b5eeea539330 msgid "How to Handle Object Streams" msgstr "オブジェクトストリームの処理方法" #: ../../recipes-low-level-interfaces.rst:78 658c13e1cc6947b09fc237301c2bc678 msgid "" "Some object types contain additional data apart from their object " "definition. Examples are images, fonts, embedded files or commands " "describing the appearance of a page." msgstr "オブジェクトストリームの処理方法一部のオブジェクトタイプには、オブジェクト定義以外に追加のデータが含まれています。例として、画像、フォント、埋め込みファイル、またはページの外観を記述するコマンドが挙げられます。" #: ../../recipes-low-level-interfaces.rst:80 2796bcc0f1ed4c599541dd675171586e msgid "" "Objects of these types are called \"stream objects\". PyMuPDF allows " "reading an object's stream via method :meth:`Document.xref_stream` with " "the object's :data:`xref` as an argument. It is also possible to write " "back a modified version of a stream using :meth:`Document.update_stream`." msgstr "" "これらのタイプのオブジェクトは「ストリームオブジェクト」と呼ばれます。PyMuPDFでは、メソッド " ":meth:`Document.xref_stream` を使用して、オブジェクトの :data:`xref` " "を引数としてオブジェクトのストリームを読み取ることができます。また、:meth:`Document.update_stream` " "を使用して、ストリームの変更されたバージョンを書き戻すことも可能です。" #: ../../recipes-low-level-interfaces.rst:82 3771d4779f8f40dba59160b01c9ee9cf msgid "" "Assume that the following snippet wants to read all streams of a PDF for " "whatever reason::" msgstr "次のスニペットが、PDFのすべてのストリームを読み取るためのものであると仮定します::" #: ../../recipes-low-level-interfaces.rst:91 9c27d6d70d6b40fba9999600e789863f msgid "" ":meth:`Document.xref_stream` automatically returns a stream decompressed " "as a bytes object -- and :meth:`Document.update_stream` automatically " "compresses it if beneficial." msgstr "" ":meth:`Document.xref_stream` " "は自動的にバイトオブジェクトとして展開されたストリームを返し、:meth:`Document.update_stream` " "は必要に応じて自動的に圧縮されます。" #: ../../recipes-low-level-interfaces.rst:96 8090153b26c14df4a507877668bc7624 msgid "How to Handle Page Contents" msgstr "ページ内容の処理方法" #: ../../recipes-low-level-interfaces.rst:97 848d7acefeb245dc8af34902fe0aff24 msgid "" "A PDF page can have zero or multiple :data:`contents` objects. These are " "stream objects describing **what** appears **where** and **how** on a " "page (like text and images). They are written in a special mini-language " "described e.g. in chapter \"APPENDIX A - Operator Summary\" on page 643 " "of the :ref:`AdobeManual`." msgstr "" "PDFページにはゼロまたは複数の :data:`contents` " "オブジェクトが存在できます。これらは、ページ上に何がどこにどのように表示されるかを記述するストリームオブジェクト（テキストや画像など）です。これらは、:ref:`AdobeManual`" " のページ643の「付録A - オペレーターサマリー」などで説明されている特別なミニ言語で記述されています。" #: ../../recipes-low-level-interfaces.rst:99 4188f5c77de44ced870411c31528cec5 msgid "" "Every PDF reader application must be able to interpret the contents " "syntax to reproduce the intended appearance of the page." msgstr "すべてのPDFリーダーアプリケーションは、コンテンツの構文を解釈してページの意図した表示を再現できる必要があります。" #: ../../recipes-low-level-interfaces.rst:101 1f87bc0453d24082b53750397e2d3f74 msgid "" "If multiple :data:`contents` objects are provided, they must be " "interpreted in the specified sequence in exactly the same way as if they " "were provided as a concatenation of the several." msgstr "" "複数の :data:`contents` " "オブジェクトが提供される場合、それらは複数のコンテンツを連結した場合とまったく同じ方法で、指定された順序で解釈される必要があります。" #: ../../recipes-low-level-interfaces.rst:103 c8df9beb4ec84255a6972a53be5fca52 msgid "" "There are good technical arguments for having multiple :data:`contents` " "objects:" msgstr "複数の :data:`contents` オブジェクトを持つメリットには、次のような良い技術的理由があります：" #: ../../recipes-low-level-interfaces.rst:105 98cc88c334df4c1ebefdc905e195d627 msgid "" "It is a lot easier and faster to just add new :data:`contents` objects " "than maintaining a single big one (which entails reading, decompressing, " "modifying, recompressing, and rewriting it for each change)." msgstr "" "新しい :data:`contents` " "オブジェクトを追加するだけで、単一の大きなコンテンツオブジェクトを維持するよりもはるかに簡単で高速です（各変更のたびに読み取り、展開、変更、再圧縮、書き直しが必要です）。" #: ../../recipes-low-level-interfaces.rst:106 f2458f2703db48d58afa2677cb1a6f0b msgid "" "When working with incremental updates, a modified big :data:`contents` " "object will bloat the update delta and can thus easily negate the " "efficiency of incremental saves." msgstr "" "増分更新を使用する場合、修正された大きな :data:`contents` " "オブジェクトは更新デルタを膨らませ、増分保存の効率を簡単に打ち消す可能性があります。" #: ../../recipes-low-level-interfaces.rst:108 774608ae29314d87af2590cc55b0b96a msgid "" "For example, PyMuPDF adds new, small :data:`contents` objects in methods " ":meth:`Page.insert_image`, :meth:`Page.show_pdf_page` and the " ":ref:`Shape` methods." msgstr "" "例えば、PyMuPDFは :meth:`Page.insert_image` 、 :meth:`Page.show_pdf_page` 、および" " :ref:`Shape` メソッドで新しい小さな :data:`contents` オブジェクトを追加します。" #: ../../recipes-low-level-interfaces.rst:110 5cc4b562e7f643678dec3abbd5c901af msgid "" "However, there are also situations when a **single** :data:`contents` " "object is beneficial: it is easier to interpret and more compressible " "than multiple smaller ones." msgstr "" "ただし、単一の :data:`contents` " "オブジェクトが有益な状況もあります。それは複数の小さなオブジェクトよりも解釈が容易で、圧縮が効果的です。" #: ../../recipes-low-level-interfaces.rst:112 f8d8be1710d74bb9b417dc9948c862c9 msgid "Here are two ways of combining multiple contents of a page::" msgstr "以下は、ページの複数のコンテンツを組み合わせる2つの方法です：" #: ../../recipes-low-level-interfaces.rst:124 0016b0cc7db9493c9b5bfecfdd25e99c msgid "" "The clean function :meth:`Page.clean_contents` does a lot more than just " "glueing :data:`contents` objects: it also corrects and optimizes the PDF " "operator syntax of the page and removes any inconsistencies with the " "page's object definition." msgstr "" ":meth:`Page.clean_contents` は、:data:`contents` " "オブジェクトを結合するだけでなく、ページのPDFオペレータ構文を修正し最適化し、ページのオブジェクト定義との整合性を保つためにも役立ちます。" #: ../../recipes-low-level-interfaces.rst:129 8fd84d6a4af441adb8fcf1c77aa5b0bd msgid "How to Access the PDF Catalog" msgstr "PDFカタログへのアクセス方法" #: ../../recipes-low-level-interfaces.rst:130 2a2e41fa0c34401ea22c6f2ed40a89e7 msgid "" "This is a central (\"root\") object of a PDF. It serves as a starting " "point to reach important other objects and it also contains some global " "options for the PDF::" msgstr "これはPDFの中心的な（\"ルート\"）オブジェクトです。これは重要な他のオブジェクトに到達するための出発点として機能し、PDFのいくつかのグローバルオプションも含まれています::" #: ../../recipes-low-level-interfaces.rst:146 5b118633d9a341a1a95aed016917f5d2 msgid "" "Indentation, line breaks and comments are inserted here for clarification" " purposes only and will not normally appear. For more information on the " "PDF catalog see section 7.7.2 on page 71 of the :ref:`AdobeManual`." msgstr "" "字下げ、改行、コメントは説明のために挿入されており、通常は表示されません。PDFカタログの詳細については、 :ref:`AdobeManual` " "のページ71のセクション7.7.2を参照してください。" #: ../../recipes-low-level-interfaces.rst:151 f6b9f5c2736444a09a44be0af1efd3ef msgid "How to Access the PDF File Trailer" msgstr "PDFファイルトレーラーへのアクセス方法" #: ../../recipes-low-level-interfaces.rst:152 4cb33f7607ff4b7da3a368b706d7f85d msgid "" "The trailer of a PDF file is a :data:`dictionary` located towards the end" " of the file. It contains special objects, and pointers to important " "other information. See :ref:`AdobeManual` p. 42. Here is an overview:" msgstr "" "PDFファイルのトレーラーは、ファイルの終わりに位置する :data:`dictionary` " "です。特別なオブジェクトと、重要な他の情報へのポインタが含まれています。:ref:`AdobeManual` を参照してください（p. " "42）。以下に概要を示します：" #: ../../recipes-low-level-interfaces.rst:155 6a08c29e38b14b4f8780edbf2bbd57ed msgid "**Key**" msgstr "**キー**" #: ../../recipes-low-level-interfaces.rst:155 58913ef5bc0e42449995f9ddc470a9b6 msgid "**Type**" msgstr "**タイプ**" #: ../../recipes-low-level-interfaces.rst:155 6bd41f1c095b4146a4be333408ae4d28 msgid "**Value**" msgstr "" #: ../../recipes-low-level-interfaces.rst:157 4f3f1be3c87948899e54efc916c7ef18 msgid "Size" msgstr "**値**" #: ../../recipes-low-level-interfaces.rst:157 #: ../../recipes-low-level-interfaces.rst:158 #: ../../recipes-low-level-interfaces.rst:163 81a6a91f16444f15bdeeaaf278f1bcd1 #: 8682c7b530344453ade63634c104ed4f f11a36ccb1b94cd3ae600b685375afff msgid "int" msgstr "" #: ../../recipes-low-level-interfaces.rst:157 c285913e7e4943f9867315f2d6712e7f msgid "Number of entries in the cross-reference table + 1." msgstr "クロスリファレンステーブル内のエントリ数 + 1 の数値。" #: ../../recipes-low-level-interfaces.rst:158 c49bb116e66c4fca9cdeb500ae675247 msgid "Prev" msgstr "" #: ../../recipes-low-level-interfaces.rst:158 28fbdab151c14d60acbe435e09d03829 msgid "Offset to previous :data:`xref` section (indicates incremental updates)." msgstr "前の :data:`xref` セクションへのオフセット（増分更新を示す）。" #: ../../recipes-low-level-interfaces.rst:159 96893c3d42a943ffaa753c2af598ddda msgid "Root" msgstr "" #: ../../recipes-low-level-interfaces.rst:159 #: ../../recipes-low-level-interfaces.rst:160 #: ../../recipes-low-level-interfaces.rst:161 17e32472677349bfa94d61bc793d8475 #: 2d049d53c6cd4ae8a2bc07f1cbcf53bb ce33dca31774448c9bdd1e213de5d090 msgid "dictionary" msgstr "" #: ../../recipes-low-level-interfaces.rst:159 fecd0772f75c49fdb36a4962c490461e msgid "(indirect) Pointer to the catalog. See previous section." msgstr "(間接的) カタログへのポインタ。前のセクションを参照してください。" #: ../../recipes-low-level-interfaces.rst:160 b7b167190b0149ce9bdd9ef671d03ae2 msgid "Encrypt" msgstr "" #: ../../recipes-low-level-interfaces.rst:160 aa8f56b6637c4a7ca41846fa1ebf6eca msgid "Pointer to encryption object (encrypted files only)." msgstr "(暗号化されたファイルのみ) 暗号化オブジェクトへのポインタ。" #: ../../recipes-low-level-interfaces.rst:161 d9be1827baa242068f64cd1307f9bd58 msgid "Info" msgstr "" #: ../../recipes-low-level-interfaces.rst:161 597be1c0e13342c694e56f1faf8dcca5 msgid "(indirect) Pointer to information (metadata)." msgstr "(間接的) 情報（メタデータ）へのポインタ。" #: ../../recipes-low-level-interfaces.rst:162 66abcc5c41b044d7ba24bef4374f4cba msgid "ID" msgstr "" #: ../../recipes-low-level-interfaces.rst:162 e6d762fa8f38487992b7f2ddc8737388 msgid "array" msgstr "" #: ../../recipes-low-level-interfaces.rst:162 ae4de832cc2c4e1cb9943cb9a61596da msgid "File identifier consisting of two byte strings." msgstr "2つのバイト文字列からなるファイル識別子。" #: ../../recipes-low-level-interfaces.rst:163 fe39430132414ae0b7367e63724369e0 msgid "XRefStm" msgstr "" #: ../../recipes-low-level-interfaces.rst:163 2f5419e850a744d790f2b70a0e221c5a msgid "Offset of a cross-reference stream. See :ref:`AdobeManual` p. 49." msgstr "クロスリファレンスストリームのオフセット。:ref:`AdobeManual` を参照してください（p. 49）。" #: ../../recipes-low-level-interfaces.rst:166 f658e5b17a384d9c90104cba97aa85ff msgid "" "Access this information via PyMuPDF with :meth:`Document.pdf_trailer` or," " equivalently, via :meth:`Document.xref_object` using -1 instead of a " "valid :data:`xref` number." msgstr "" "これらの情報には、PyMuPDFを使用して :meth:`Document.pdf_trailer` または、同等の " ":meth:`Document.xref_object` を使用して -1 の代わりに有効な :data:`xref` " "番号を指定することでアクセスします。" #: ../../recipes-low-level-interfaces.rst:187 98759bbd8d114604a80fbf742832adba msgid "How to Access XML Metadata" msgstr "XMLメタデータへのアクセス方法" #: ../../recipes-low-level-interfaces.rst:188 a4c560abb05646a6b21fccc292008ea0 msgid "" "A PDF may contain XML metadata in addition to the standard metadata " "format. In fact, most PDF viewer or modification software adds this type " "of information when saving the PDF (Adobe, Nitro PDF, PDF-XChange, etc.)." msgstr "" "PDFには、標準のメタデータ形式に加えてXMLメタデータが含まれている場合があります。実際、ほとんどのPDFビューアや編集ソフトウェアは、PDFを保存する際に（Adobe、Nitro" " PDF、PDF-XChangeなど）この種の情報を追加します。" #: ../../recipes-low-level-interfaces.rst:190 a02f8f95ed834b4386f05f01b7baf217 msgid "" "PyMuPDF has no way to **interpret or change** this information directly, " "because it contains no XML features. XML metadata is however stored as a " ":data:`stream` object, so it can be read, modified with appropriate " "software and written back." msgstr "" "しかし、PyMuPDFはXMLの機能を持たないため、この情報を直接解釈または変更する方法はありません。ただし、XMLメタデータは " ":data:`stream` オブジェクトとして格納されているため、適切なソフトウェアで読み取り、変更し、書き戻すことができます。" #: ../../recipes-low-level-interfaces.rst:202 763734a1837d4847a3c820225381f4cb msgid "" "Using some XML package, the XML data can be interpreted and / or modified" " and then stored back. The following also works, if the PDF previously " "had no XML metadata::" msgstr "あるXMLパッケージを使用して、XMLデータを解釈および/または変更し、それを保存し直すことができます。次の方法もPDFに以前にXMLメタデータがない場合にも機能します::" #: ../../recipes-low-level-interfaces.rst:213 b484e4babb6b4821a2d4ca50b936f40b msgid "How to Extend PDF Metadata" msgstr "PDFメタデータの拡張方法" #: ../../recipes-low-level-interfaces.rst:214 bd8ade0701494f0aa8d64389ba8c01db msgid "" "Attribute :attr:`Document.metadata` is designed so it works for all " ":ref:`supported document types` in the same way: it" " is a Python dictionary with a **fixed set of key-value pairs**. " "Correspondingly, :meth:`Document.set_metadata` only accepts standard " "keys." msgstr "" "属性 :attr:`Document.metadata` は、すべての :ref:`サポートされている " "` " "ドキュメントタイプで同じ方法で機能するように設計されています。これは、固定されたキーと値のセットを持つPython辞書です。同様に、:meth:`Document.set_metadata`" " は標準のキーのみを受け入れます。" #: ../../recipes-low-level-interfaces.rst:216 2ed9e5740749448898a94bedd85fa94f msgid "" "However, PDFs may contain items not accessible like this. Also, there may" " be reasons to store additional information, like copyrights. Here is a " "way to handle **arbitrary metadata items** by using PyMuPDF low-level " "functions." msgstr "しかし、PDFにはこのようにアクセスできない項目が含まれている場合があります。また、著作権などの追加情報を保存する理由もあるかもしれません。以下は、PyMuPDFの低レベル関数を使用して任意のメタデータ項目を処理する方法です。" #: ../../recipes-low-level-interfaces.rst:218 f2e1b634d30a481da6cb600b52f2dccc msgid "As an example, look at this standard metadata output of some PDF::" msgstr "例として、次のPDFの標準メタデータ出力をご覧ください::" #: ../../recipes-low-level-interfaces.rst:237 ae127729cd53409cb04f9ebc390699c4 msgid "" "Use the following code to see **all items** stored in the metadata " "object::" msgstr "以下のコードを使用して、メタデータオブジェクトに保存されているすべてのアイテムを表示します::" #: ../../recipes-low-level-interfaces.rst:265 f219d010f8094f62934815b489d0dc25 msgid "" "*Vice versa*, you can also **store private metadata items** in a PDF. It " "is your responsibility to make sure that these items conform to PDF " "specifications - especially they must be (unicode) strings. Consult " "section 14.3 (p. 548) of the :ref:`AdobeManual` for details and caveats::" msgstr "" "逆に、PDFにはプライベートなメタデータアイテムを保存することもできます。これらのアイテムがPDF仕様に準拠していることを確認する責任はあなたにあります。特に、これらは（Unicode）文字列である必要があります。詳細や注意事項については、Adobe" " PDFリファレンスのセクション14.3（p. 548）を参照してください::" #: ../../recipes-low-level-interfaces.rst:287 2dc3761486a541f6821711dfd609da05 msgid "" "To delete selected keys, use `doc.xref_set_key(xref, \"mykey\", " "\"null\")`. As explained in the next section, string \"null\" is the PDF " "equivalent to Python's `None`. A key with that value will be treated as " "not being specified -- and physically removed in garbage collections." msgstr "" "選択したキーを削除するには、`doc.xref_set_key(xref, \"mykey\", \"null\")` " "を使用します。次のセクションで説明されているように、文字列 `\"null\"` はPDFのバージョンでPythonの `None` " "に相当します。その値のキーは指定されていないものとして扱われ、ガベージコレクションで物理的に削除されます。" #: ../../recipes-low-level-interfaces.rst:292 b8e1f01138dd4a638ffd1e3689508d1c msgid "How to Read and Update PDF Objects" msgstr "PDFオブジェクトの読み取りと更新方法" #: ../../recipes-low-level-interfaces.rst:297 c7c33727bafc478ca88a1cdae0ec859b msgid "" "There also exist granular, elegant ways to access and manipulate selected" " PDF :data:`dictionary` keys." msgstr "選択したPDF :data:`dictionary` キーにアクセスし、操作するための粒状で洗練された方法も存在します。" #: ../../recipes-low-level-interfaces.rst:299 04aa0e1d70b944b3a904ea382f4f0c30 msgid "" ":meth:`Document.xref_get_keys` returns the PDF keys of the object at " ":data:`xref`::" msgstr ":meth:`Document.xref_get_keys` は、:data:`xref` のオブジェクトのPDFキーを返します::" #: ../../recipes-low-level-interfaces.rst:308 ec3415a9ffc54434860c48bc58bd55d9 msgid "Compare with the full object definition::" msgstr "完全なオブジェクト定義と比較してください::" #: ../../recipes-low-level-interfaces.rst:319 4ee823aae30f4627b0f7c02f4267bfdc msgid "" "Single keys can also be accessed directly via " ":meth:`Document.xref_get_key`. The value **always is a string** together " "with type information, that helps with interpreting it::" msgstr "" "単一のキーは、 :meth:`Document.xref_get_key` " "を介して直接アクセスすることもできます。値は常に文字列であり、それを解釈するのに役立つタイプ情報が含まれています::" #: ../../recipes-low-level-interfaces.rst:324 5b603693f93c4e03a5111618579b46ce msgid "Here is a full listing of the above page keys::" msgstr "以下は、上記のページキーの完全な一覧です::" #: ../../recipes-low-level-interfaces.rst:335 f13dcde484e24d32bc88ea9b8cf371dd msgid "" "An undefined key inquiry returns `('null', 'null')` -- PDF object type " "`null` corresponds to `None` in Python. Similar for the booleans `true` " "and `false`." msgstr "" "未定義のキーの問い合わせは、`('null', 'null')` を返します - PDFオブジェクトタイプ `null` はPythonの " "`None` に対応します。 `true` および `false` も同様です。" #: ../../recipes-low-level-interfaces.rst:336 14eee493b6bb4c06b2afcbdade3ca9e7 msgid "" "Let us add a new key to the page definition that sets its rotation to 90 " "degrees (you are aware that there actually exists " ":meth:`Page.set_rotation` for this?)::" msgstr "" "ページ定義に新しいキーを追加して、その回転角を90度に設定しましょう（実際には :meth:`Page.set_rotation` " "が存在することを知っているかと思いますが、そうですか？）::" #: ../../recipes-low-level-interfaces.rst:351 b9ecea1e87e7421faea4ae09003de94f msgid "" "This method can also be used to remove a key from the :data:`xref` " "dictionary by setting its value to `null`: The following will remove the " "rotation specification from the page: `doc.xref_set_key(page.xref, " "\"Rotate\", \"null\")`. Similarly, to remove all links, annotations and " "fields from a page, use `doc.xref_set_key(page.xref, \"Annots\", " "\"null\")`. Because `Annots` by definition is an array, setting en empty " "array with the statement `doc.xref_set_key(page.xref, \"Annots\", " "\"[]\")` would do the same job in this case." msgstr "" "このメソッドは、値を `null` に設定することで :data:`xref` " "辞書からキーを削除するためにも使用できます：次の方法は、ページから回転指定を削除します： `doc.xref_set_key(page.xref," " \"Rotate\", \"null\")` 。同様に、ページからすべてのリンク、注釈、およびフィールドを削除するには、 " "`doc.xref_set_key(page.xref, \"Annots\", \"null\")` を使用します。`Annots` " "は定義上配列であるため、`doc.xref_set_key(page.xref, \"Annots\", \"[]\")` " "という文で空の配列を設定すると、同じ操作が実行されます。" #: ../../recipes-low-level-interfaces.rst:353 25ee5ad120ca43a7af7fb238b8ee91cd msgid "" "PDF dictionaries can be hierarchically nested. In the following page " "object definition both, `Font` and `XObject` are subdictionaries of " "`Resources`::" msgstr "" "PDF辞書は階層的に入れ子にすることができます。次のページオブジェクト定義では、`Font` と `XObject` は両方とも " "`Resources` のサブディクショナリです::" #: ../../recipes-low-level-interfaces.rst:373 166311ecb59d42579d5324506515d2e5 msgid "" "The above situation **is supported** by methods " ":meth:`Document.xref_set_key` and :meth:`Document.xref_get_key`: use a " "path-like notation to point at the required key. For example, to retrieve" " the value of key `Im1` above, specify the complete chain of dictionaries" " \"above\" it in the key argument: `\"Resources/XObject/Im1\"`::" msgstr "" "上記の状況は、メソッド :meth:`Document.xref_set_key` と :meth:`Document.xref_get_key`" " によってサポートされています。必要なキーを指すために、パスのような表記法を使用します。たとえば、上記の `Im1` " "キーの値を取得するには、キー引数にその上位の辞書の完全なチェーン `\"Resources/XObject/Im1\"` を指定します::" #: ../../recipes-low-level-interfaces.rst:378 decc969788824b2f905d28ed9ea37c97 msgid "" "The path notation can also be used to **directly set a value**: use the " "following to let `Im1` point to a different object::" msgstr "パス表記法は、値を直接設定するためにも使用できます。以下を使用して、`Im1` を異なるオブジェクトを指すように設定します::" #: ../../recipes-low-level-interfaces.rst:399 8134074039144ebca0e928b428cf7ad4 msgid "" "Be aware, that **no semantic checks** whatsoever will take place here: if" " the PDF has no xref 9999, it won't be detected at this point." msgstr "ここでは、何の意味的なチェックも行われないことに注意してください。PDFにxref 9999が存在しない場合、この段階では検出されません。" #: ../../recipes-low-level-interfaces.rst:401 d717c7f21a174300a90bb992653ab939 msgid "" "If a key does not exist, it will be created by setting its value. " "Moreover, if any intermediate keys do not exist either, they will also be" " created as necessary. The following creates an array `D` several levels " "below the existing dictionary `A`. Intermediate dictionaries `B` and `C` " "are automatically created::" msgstr "" "キーが存在しない場合、その値を設定することで新しく作成されます。さらに、中間のキーが存在しない場合も、必要に応じて自動的に作成されます。次の例では、既存の辞書" " `A` の下にいくつかの階層下に配列 `D` を作成しています。中間の辞書 `B` と `C` も自動的に作成されます::" #: ../../recipes-low-level-interfaces.rst:421 79d1fc2866c6405e852e7bc1d59c5f72 msgid "" "When setting key values, basic **PDF syntax checking** will be done by " "MuPDF. For example, new keys can only be created **below a dictionary**. " "The following tries to create some new string item `E` below the " "previously created array `D`::" msgstr "" "キーの値を設定する際には、MuPDFによって基本的なPDF構文のチェックが行われます。たとえば、新しいキーは辞書の下にのみ作成できます。次の例では、以前に作成された配列" " `D` の下に新しい文字列アイテム `E` を作成しようとしています：" #: ../../recipes-low-level-interfaces.rst:429 891aef9e0fe9425881312a1752d59e9f msgid "" "It is also **not possible**, to create a key if some higher level key is " "an **\"indirect\"** object, i.e. an xref. In other words, xrefs can only " "be modified directly and not implicitly via other objects referencing " "them::" msgstr "同様に、上位のキーが「間接」オブジェクト、つまりxrefである場合、キーを作成することはできません。言い換えれば、xrefは直接的に変更できるが、それを参照する他のオブジェクトを通じて暗黙的に変更することはできません::" #: ../../recipes-low-level-interfaces.rst:442 cb6c84fd491f4c3eaab967eb4ab22326 msgid "" "These are expert functions! There are no validations as to whether valid " "PDF objects, xrefs, etc. are specified. As with other low-level methods " "there is the risk to render the PDF, or parts of it unusable." msgstr "これらは専門家向けの機能です！有効なPDFオブジェクトやxrefなどが指定されているかどうかの検証はありません。他の低レベルメソッドと同様に、PDF全体またはその一部を利用不能にする可能性があるため注意が必要です。" #: ../../footer.rst:60 4695c17edec440ea85382cf6f78ad072 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 05b9195b227d4fbc825fc852831e4554 msgid "Artifex" msgstr "" #: ../../header.rst:-1 d1146968098a44928b810551252f816f msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 0072b638d978499db19c4b4f4f7a3707 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-multiprocessing.rst:17 0f0b2d7d9f684b409ff0e5784ca866ac msgid "Multiprocessing" msgstr "マルチプロセッシング" #: ../../recipes-multiprocessing.rst:19 3062a6b9aec34db2aec0a9bb17a0ef61 msgid "" "|PyMuPDF| does not support running on multiple threads - doing so may " "cause incorrect behaviour or even crash Python itself." msgstr "" #: ../../recipes-multiprocessing.rst:21 74aa37e95d05468c982d841a2f5e2366 msgid "" "However, there is the option to use :title:`Python's` *multiprocessing* " "module in a variety of ways." msgstr "ただし、Pythonのmultiprocessingモジュールをさまざまな方法で使用するオプションがあります。" #: ../../recipes-multiprocessing.rst:23 83777a97e9db4e779e16756b9eb3ee39 msgid "" "If you are looking to speed up page-oriented processing for a large " "document, use this script as a starting point. It should be at least " "twice as fast as the corresponding sequential processing." msgstr "大きなドキュメントのページ指向処理を高速化することを検討している場合は、このスクリプトを出発点として使用してください。対応する順次処理よりも少なくとも2倍の速さで動作するはずです。" #: ../../recipes-multiprocessing.rst:26 ../../recipes-multiprocessing.rst:37 #: 2098918775344f8e9c7de44ba8423fb1 824c4f30793e4c428daf4a27269debd1 msgid "|toggleStart|" msgstr "" #: ../../recipes-multiprocessing.rst:31 ../../recipes-multiprocessing.rst:42 #: dd13074c598d44c4b568775518218436 ea94b563d305488a93bcc8650477d412 msgid "|toggleEnd|" msgstr "" #: ../../recipes-multiprocessing.rst:34 9ad6e6b758c14434a47e7b271aebc806 msgid "" "Here is a more complex example involving inter-process communication " "between a main process (showing a GUI) and a child process doing " "|PyMuPDF| access to a document." msgstr "以下は、メインプロセス（GUIを表示）とドキュメントへのPyMuPDFアクセスを行う子プロセスとの間のプロセス間通信を含む、より複雑な例です。" #: ../../footer.rst:60 fbfd1487311a41a4acc53de3122dc430 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ ":title:`MuPDF` has no integrated support " #~ "for threading - calling itself " #~ "\"thread-agnostic\". While there do exist" #~ " tricky possibilities to still use " #~ "threading with :title:`MuPDF`, the baseline" #~ " consequence for |PyMuPDF| is:" #~ msgstr "" #~ ":title:`MuPDF` はスレッディングに対する統合サポートを持っておらず、「スレッドに対して無関心（thread-" #~ "agnostic）」と呼ばれています。MuPDFとスレッディングを組み合わせて使用するトリッキーな可能性は存在しますが、PyMuPDFの基本的な影響は次のとおりです：" #~ msgid "**No Python threading support**." #~ msgstr "**Pythonスレッディングのサポートはありません。**." #~ msgid "" #~ "Using |PyMuPDF| in a :title:`Python` " #~ "threading environment will lead to " #~ "blocking effects for the main thread." #~ msgstr "|PyMuPDF| を :title:`Python` スレッディング環境で使用すると、メインスレッドでのブロッキング効果が発生します。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-ocr.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 8c06718aa6d94a588549b1b5d04439ff msgid "Artifex" msgstr "" #: ../../header.rst:-1 53d78f25612a42cea99758721dc13394 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDFは、PDF（およびその他）ドキュメントのデータ抽出、分析、変換、および操作のための高性能なPythonライブラリです。" #: ../../header.rst:-1 bffa3c55f0b648508f7e9ef104450bca msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキストの抽出、PDF画像の抽出、PDF変換、PDFテーブル、PDF分割、PDF作成、Pyodide、PyScript" #: ../../recipes-ocr.rst:17 c241da654a734566aa9837f159d775f0 msgid "OCR - Optical Character Recognition" msgstr "OCR - 光学文字認識" #: ../../recipes-ocr.rst:19 0aa275f26c85470caecaed5eecb9df0b msgid "" "|PyMuPDF| has integrated support for OCR (Optical Character Recognition)." " It is possible to use OCR for both, images (via the :ref:`Pixmap` class)" " and for document pages." msgstr "" "|PyMuPDF| にはOCR（光学文字認識）の統合サポートがあります。OCRは、画像（ :ref:`Pixmap` " "クラスを介して）および文書ページの両方に使用できます。" #: ../../recipes-ocr.rst:21 51aed55192864e8e92dfdbae828d1b05 msgid "" "The feature is currently based on Tesseract-OCR which must be installed " "as a separate application -- see the :ref:`installation_ocr`." msgstr "" "この機能は現在、 :ref:`installation_ocr` に基づいており、別途アプリケーションとしてインストールする必要があります。インストール手順は、インストールチャプターを参照してください。" #: ../../recipes-ocr.rst:24 b1216080a3f54b3c8f76397e1abb6bfb msgid "How to OCR an Image" msgstr "画像のOCR方法" #: ../../recipes-ocr.rst:25 3246894b688c4472b993c9cb737b849b msgid "" "A supported image must first be converted to a :ref:`Pixmap`. The Pixmap " "can then be saved to a 1-page PDF. This page will look like the original " "image with the same width and height. It will contain a layer of text as " "recognized by Tesseract." msgstr "" "サポートされている画像はまず :ref:`Pixmap` " "に変換される必要があります。次に、Pixmapを1ページのPDFに保存できます。このページは、元の画像と同じ幅と高さを持つように見えます。それには、Tesseractによって認識されたテキストのレイヤーが含まれています。" #: ../../recipes-ocr.rst:27 d4515bb735c54591a730fae2a142b782 msgid "" "The PDF can be generated via one of the methods " ":meth:`Pixmap.pdfocr_save` or :meth:`Pixmap.pdfocr_tobytes`, as a file on" " disk or as a PDF in memory." msgstr "" "PDFは、次のいずれかの方法、つまり :meth:`Pixmap.pdfocr_save` または " ":meth:`Pixmap.pdfocr_tobytes` を使用して、ディスク上のファイルとして、またはメモリ内のPDFとして生成できます。" #: ../../recipes-ocr.rst:29 487a184cd0104d00b896c90725d548eb msgid "" "The text can be extracted and searched with the usual text extraction and" " search methods (:meth:`Page.get_text`, :meth:`Page.search_for`, etc.). " "Please also note the following important facts and prerequisites:" msgstr "" "通常のテキスト抽出および検索方法（ :meth:`Page.get_text` 、 :meth:`Page.search_for` " "など）を使用して、テキストを抽出および検索することができます。また、次の重要な事実と前提条件にも注意してください：" #: ../../recipes-ocr.rst:31 fea2a323626648cf8e2f358bf60c9790 msgid "" "When converting the image to a Pixmap, please confirm that the color " "space is RGB and alpha is `False` (no transparency). Convert the original" " Pixmap if necessary." msgstr "" "画像をPixmapに変換する際に、カラースペースがRGBであり、alphaが `False` " "（透明度なし）であることを確認してください。必要に応じて元のPixmapを変換してください。" #: ../../recipes-ocr.rst:32 602c256e951449f1a5d1de19052b4e81 msgid "" "All text is written as \"hidden\" with Tesseract's own `GlyphLessFont`, a" " mono-spaced font with metrics comparable to Courier." msgstr "" "すべてのテキストは、Tesseractの独自の `GlyphLessFont` " "で「非表示」として書かれています。これは、Courierに類似したメトリクスを持つ等幅フォントです。" #: ../../recipes-ocr.rst:33 cec1c1656b124ccb8c05d4e5faabe5fe msgid "" "All text has the properties regular and black (i.e. no bold, no italic, " "no information about the original fonts)." msgstr "すべてのテキストは、regularとblackのプロパティを持ちます（太字や斜体はなく、元のフォントに関する情報はありません）。" #: ../../recipes-ocr.rst:34 40decd5ed0f641c5a1a1df6f0e46b543 msgid "" "Tesseract does not recognize vector graphics (i.e. no drawings / line-" "art)." msgstr "Tesseractはベクトルグラフィックスを認識しません（つまり、図面や線画はありません）。" #: ../../recipes-ocr.rst:36 92a869d875f440a1823e69cb418dd13c msgid "This approach is also recommended to OCR a complete scanned PDF:" msgstr "スキャンされた完全なPDFをOCRするためにも、この手法が推奨されています：" #: ../../recipes-ocr.rst:38 66094238af8143488b9393b6174ad73b msgid "Render each page to a :ref:`Pixmap` with desired resolution" msgstr "各ページを所望の解像度で :ref:`Pixmap` にレンダリングします" #: ../../recipes-ocr.rst:39 117254e7b2ba43c181367c88db16205e msgid "Append the resulting 1-page PDF to the output PDF" msgstr "得られた1ページのPDFを出力PDFに追加します" #: ../../recipes-ocr.rst:42 d7dece4adeb4437b99e1820d71befa7c msgid "How to OCR a Document Page" msgstr "ドキュメントページのOCR方法" #: ../../recipes-ocr.rst:43 7c3e4697da8f4603b29acd1ad05093d5 msgid "" "Any supported document page can be OCR-ed -- either the complete page or " "only the image areas on it." msgstr "サポートされているどのドキュメントページでもOCR処理が可能です。ページ全体、またはその上の画像領域のみを対象にすることができます。" #: ../../recipes-ocr.rst:45 ba6c9f5cda8043bf858b00e93aa23ded msgid "" "Because optical character recognition is about one thousand times slower " "than standard text extraction, we make sure to do OCR only once per page " "and store the result in a :ref:`TextPage`. Using this TextPage for all " "subsequent extractions and text searches will then happen with " "|PyMuPDF|'s usual top speed." msgstr "" "光学文字認識は通常のテキスト抽出よりも約1000倍遅いため、1ページにつき1回だけOCR処理を行い、その結果をTextPageに保存します。この " ":ref:`TextPage` をすべての後続の抽出とテキスト検索に使用することで、PyMuPDFの通常の高速性で処理が行われます。" #: ../../recipes-ocr.rst:47 30ced681346a45b69d752411d4546ef8 msgid "To OCR a document page, follow this approach:" msgstr "ドキュメントページをOCRするには、この手順に従ってください：" #: ../../recipes-ocr.rst:49 d100d50f78564e60a3c001137881dbe0 msgid "" "Determine whether OCR is needed / beneficial at all. A number of criteria" " can be used for this decision, like:" msgstr "まず、OCRが全く必要であるか、または有益かどうかを判断します。この決定には、次のような基準を使用できます：" #: ../../recipes-ocr.rst:51 d822f6b5f27e4ec8985dabafd5355ded msgid "page is completely covered by an image" msgstr "ページが画像で完全にカバーされている" #: ../../recipes-ocr.rst:52 e2b83dfda8654688ace9b92549d12d49 msgid "no text exists on the page" msgstr "ページにテキストが存在しない" #: ../../recipes-ocr.rst:53 92db54fd9afa4d38a9032f18d836b8cf msgid "thousands of small vector graphics (indicating *simulated* text)" msgstr "数千の小さなベクトルグラフィックス（ *模擬* テキストを示す）" #: ../../recipes-ocr.rst:55 83ba5b35db48464f8945a3dabc2e53f0 msgid "" "OCR the page and store result in a :ref:`TextPage` object using an " "instruction like `tp = page.get_textpage_ocr(...)`." msgstr "" "ページをOCR処理し、結果を :ref:`TextPage` オブジェクトに保存します。この操作は、 `tp = " "page.get_textpage_ocr(...)` のような命令を使用して行います。" #: ../../recipes-ocr.rst:57 58b836a92fe443749da93c2ff3c9a23e msgid "" "Refer to the produced :ref:`TextPage` in all subsequent text extractions " "and searches via the `textpage=tp` parameter." msgstr "" "以降のすべてのテキスト抽出と検索では、 `textpage=tp` パラメータを使用して生成された :ref:`TextPage` " "を参照してください。" #: ../../footer.rst:60 3baf39a2c3104ca786b8b27e9c52e1a8 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは、|version| までのすべてのバージョンをカバーしています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-optional-content.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b9adf564010b470a971c6291f3680a9f msgid "Artifex" msgstr "" #: ../../header.rst:-1 4f641f2c45c0425a8a232bd594ce5a8e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 9aa457bbf5a14960b09296e9b2e285cc msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-optional-content.rst:7 f386f73d902d4f638a7820107f09b953 msgid "Optional Content Support" msgstr "オプションコンテンツのサポート" #: ../../recipes-optional-content.rst:9 fcfec01c6f83417597feed152e9cf82e msgid "" "This document explains PyMuPDF's support of the PDF concept **\"Optional " "Content\"**." msgstr "この文書では、PyMuPDFにおけるPDFコンセプト **「オプションコンテンツ」** のサポートについて説明します。" #: ../../recipes-optional-content.rst:12 3f7db4b17b0c4708ba190ca50f3cf65f msgid "Introduction: The Optional Content Concept" msgstr "はじめに：オプションコンテンツのコンセプト" #: ../../recipes-optional-content.rst:13 1a20a0429dbd4d22b3e438897b87f6ec msgid "" "*Optional Content* in PDF is a way to show or hide parts of a document " "based on certain conditions: Parameters that can be set to ON or to OFF " "when using a supporting PDF consumer (viewer), or programmatically." msgstr "PDFのオプションコンテンツは、特定の条件に基づいてドキュメントの一部を表示または非表示にする方法です。これは、サポートするPDFコンシューマ（ビューア）を使用する際にONまたはOFFに設定できるパラメータ、またはプログラムを使用して行います。" #: ../../recipes-optional-content.rst:15 aaecb435f0b74040bb7788f47b75ef27 msgid "" "This capability is useful in items such as CAD drawings, layered artwork," " maps, and multi-language documents. Typical uses include showing or " "hiding details of complex vector graphics like geographical maps, " "technical devices, architectural designs and similar, including " "automatically switching between different zooming levels. Other use cases" " may be to automatically show different detail levels when displaying a " "document on screen as opposed to printing it." msgstr "この機能は、CAD図面、レイヤー化されたアートワーク、地図、多言語ドキュメントなどのアイテムで有用です。一般的な用途には、地理的な地図、技術デバイス、建築設計などの複雑なベクトルグラフィックの詳細の表示または非表示、異なるズームレベル間の自動切り替えなどが含まれます。他の用途としては、画面上でドキュメントを表示する際と印刷する際で自動的に異なる詳細レベルを表示することが考えられます。" #: ../../recipes-optional-content.rst:17 f07e3ad64d7846e98be13b841e104284 msgid "" "Special PDF objects, so-called **Optional Content Groups** (OCGs) are " "used to define these different *layers* of content." msgstr "特別なPDFオブジェクトである「オプションコンテンツグループ（OCG）」を使用して、これらの異なるコンテンツのレイヤーを定義します。" #: ../../recipes-optional-content.rst:19 8e40a4dd32264311b329d5ef6d1b3feb msgid "" "Assigning an OCG to a \"normal\" PDF object (like a text or an image) " "causes that object to be visible or hidden, depending on the current " "state of the assigned OCG." msgstr "「通常の」PDFオブジェクト（テキストや画像など）にOCGを割り当てると、そのオブジェクトは割り当てられたOCGの現在の状態に応じて表示または非表示になります。" #: ../../recipes-optional-content.rst:21 55f0e10ade9d4f99abf06a67d6897563 msgid "" "To ease definition of the overall configuration of a PDF's Optional " "Content, OCGs can be organized in higher level groupings, called **OC " "Configurations**. Each configuration being a collection of OCGs, together" " with each OCG's desired initial visibility state. Selecting one of these" " configurations (via the PDF viewer or programmatically) causes a " "corresponding visibility change of all affected PDF objects throughout " "the document." msgstr "PDFのオプションコンテンツの全体的な構成を簡単に定義するために、OCGは高レベルのグループ化である「OC構成」に組織化できます。各構成は、OCGの望ましい初期表示状態とともに、OCGのコレクションです。これらの構成のいずれかを選択する（PDFビューアまたはプログラムを介して）と、ドキュメント全体で影響を受けるすべてのPDFオブジェクトの表示状態が対応するように変更されます。" #: ../../recipes-optional-content.rst:23 335985a556c34d438df38487d6cae48b msgid "Except for the default one, OC Configurations are optional." msgstr "デフォルト以外のOC構成はオプションです。" #: ../../recipes-optional-content.rst:25 fccc4cf720904ea79e6efd0b6034ca87 msgid "" "For more explanations and additional background please refer to PDF " "specification manuals." msgstr "詳細な説明や追加の背景情報については、PDF仕様マニュアルを参照してください。" #: ../../recipes-optional-content.rst:28 c00fd4817a4b47efbf6a64bfa9134f7e msgid "PyMuPDF Support for PDF Optional Content" msgstr "PDFオプショナルコンテンツのPyMuPDFサポート" #: ../../recipes-optional-content.rst:29 58da3cf082224fbab5a10febc9e9918c msgid "" "PyMuPDF offers full support for viewing, defining, changing and deleting " "Option Content Groups, Configurations, maintaining the assignment of OCGs" " to PDF objects and programmatically switching between OC Configurations " "and the visibility states of each single OCG." msgstr "PyMuPDFは、オプショナルコンテンツグループや構成の表示、定義、変更、削除、OCGのPDFオブジェクトへの割り当ての維持、OC構成間のプログラムによる切り替えや各単一OCGの可視性状態のサポートを完全に提供します。" #: ../../recipes-optional-content.rst:32 150d36f9de0441a599f6371982441f3d msgid "How to Add Optional Content" msgstr "オプショナルコンテンツの追加方法" #: ../../recipes-optional-content.rst:33 73887253f5d24ae7ba64f723a91eaf07 msgid "" "This is as simple as adding an Optional Content Group, OCG, to a PDF: " ":meth:`Document.add_ocg`." msgstr "これは、PDFにオプショナルコンテンツグループ（OCG）を追加するだけの簡単な手順です：:meth:`Document.add_ocg`。" #: ../../recipes-optional-content.rst:35 bc0c989ada934a9a9e91392eed44e3c6 msgid "" "If previously the PDF had no OC support at all, the required setup (like " "defining the default OC Configuration) will be done at this point " "automatically." msgstr "以前にPDFがまったくOCサポートを持っていなかった場合、必要なセットアップ（デフォルトのOC構成の定義など）は自動的に行われます。" #: ../../recipes-optional-content.rst:37 cdfece8bcb5842e8a95237834b218484 msgid "" "The method returns an :data:`xref` of the created OCG. Use this xref to " "associate (mark) any PDF object with it, that you want to make dependent " "on this OCG's state. For example, you can insert an image on a page and " "refer to the xref like this::" msgstr "" "このメソッドは、作成されたOCGの :data:`xref` " "を返します。このxrefを使用して、このOCGの状態に依存するようにする任意のPDFオブジェクトを関連付け（マーク）します。例えば、ページに画像を挿入し、次のようにxrefを参照できます::" #: ../../recipes-optional-content.rst:41 6ffb9b4bd14d4579967827abb6fab656 msgid "" "If you want to put an **existing** image under the control of an OCG, you" " must first find out the image's xref number (called `img_xref` here) and" " then do `doc.set_oc(img_xref, xref)`. After this, the image will be " "(in-) visible everywhere throughout the document if the OCG's state is " "\"ON\", respectively \"OFF\". You can also assign a different OCG with " "this method." msgstr "" "既存の画像をOCGの制御下に配置したい場合、まず画像のxref番号（ここでは `img_xref` と呼びます）を調べ、その後 " "`doc.set_oc(img_xref, xref)` " "を行う必要があります。これにより、OCGの状態が「ON」または「OFF」の場合、画像はドキュメント全体で（非）表示になります。また、このメソッドで異なるOCGを割り当てることもできます。" #: ../../recipes-optional-content.rst:43 57ddbd4662c64c7da80144e82353dd65 msgid "To **remove** an OCG from an image, do `doc.set_oc(img_xref, 0)`." msgstr "画像からOCGを削除するには、 `doc.set_oc(img_xref, 0)` を行います。" #: ../../recipes-optional-content.rst:45 7cf89450ea9246beaa5cc79c376ec93c msgid "" "One single OCG can be assigned to multiple PDF objects to control their " "visibility." msgstr "1つのOCGは複数のPDFオブジェクトに割り当てて、それらの可視性を制御することができます。" #: ../../recipes-optional-content.rst:48 7410b55143ef4843a28d68ebad34fd9a msgid "How to Define Complex Optional Content Conditions" msgstr "複雑なオプショナルコンテンツ条件の定義方法" #: ../../recipes-optional-content.rst:50 896d39eb29204989ade197882ff6a5ce msgid "" "Sophisticated logical conditions can be established to address complex " "visibility needs." msgstr "複雑な可視性のニーズに対応するために、洗練された論理条件を設定することができます。" #: ../../recipes-optional-content.rst:52 a5c986cc1555410ebbc392e3476e93fe msgid "" "For example, you might want to create a multi-language document, so the " "user may switch between languages as required." msgstr "例えば、ユーザーが必要に応じて言語を切り替えることができるような多言語ドキュメントを作成したいかもしれません。" #: ../../recipes-optional-content.rst:54 48cadb3f29334ff5aa265acd08dfdc06 msgid "Please have a look at `this Jupyter Notebook`_ and execute it as desired." msgstr "" "`この Jupyter Notebook `_ " "をご覧いただき、必要に応じて実行してみてください。" #: ../../recipes-optional-content.rst:56 49114e4ceda7440399518471d7dc8eb7 msgid "" "Certainly, your requirements may even be more complex and involve " "multiple OCGs with ON/OFF states that are connected by some kind of " "logical relationship -- but it should give you an impression of what is " "possible and how to plan your next steps." msgstr "もちろん、あなたの要件はさらに複雑で、論理的な関係で接続された複数のON/OFF状態を持つ複数のOCGが関与する可能性がありますが、これは可能なことと次のステップを計画する方法を示すものとなるでしょう。" #: ../../footer.rst:60 067fc234c31f4747987f53713303219a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-stories.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 c1cb378bf8d4476fb2cf4501913fbf5e msgid "Artifex" msgstr "" #: ../../header.rst:-1 3c891d0a0fb04d97936ca58bbdece2de msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 f644d1bc2e234382901d316b4c0cb553 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-stories.rst:18 c45a9555e4e144b9af3b42d2801ac42d msgid "Stories" msgstr "ストーリーズ" #: ../../recipes-stories.rst:20 61fc6f658db84ae4ac5c035a17aaebab msgid "" "This document showcases some typical use cases for " ":ref:`Stories`." msgstr "このドキュメントは、 :ref:`ストーリーズ` の典型的な使用例を示しています。" #: ../../recipes-stories.rst:22 8153b8f5ad474b97857309ad103d02ba msgid "" "As mentioned in the :ref:`tutorial`, stories may be " "created using up to three input sources: HTML, CSS and Archives -- all of" " which are optional and which, respectively, can be provided " "programmatically." msgstr "" ":ref:`チュートリアル` " "で説明されているように、ストーリーズは最大3つの入力ソース（HTML、CSS、アーカイブ）を使用して作成できます。これらのソースはすべてオプションであり、それぞれプログラムで提供することができます。" #: ../../recipes-stories.rst:24 d57ad4f561994730aebf4f597f37bad9 msgid "The following examples will showcase combinations for using these inputs." msgstr "以下の例では、これらの入力を使用した組み合わせを示します。" #: ../../recipes-stories.rst:28 ac8b802e808e4084b58d55ce03509ad8 msgid "" "Many of these recipe's source code are included as examples in the `docs`" " folder." msgstr "これらのレシピのソースコードの多くは、ドキュメントフォルダ内の例として含まれています。" #: ../../recipes-stories.rst:34 f07dc61a03bf4989b1e6604b220aef91 msgid "How to Add a Line of Text with Some Formatting" msgstr "テキストの行をいくつかの書式で追加する方法" #: ../../recipes-stories.rst:36 89f52f47ec32483480e0cf60bd8494fb msgid "Here is the inevitable \"Hello World\" example. We will show two variants:" msgstr "以下は、避けられない「Hello World」の例です。2つのバリアントを示します：" #: ../../recipes-stories.rst:38 0f4aae8b064d445d907c6ca0008c498d msgid "Create using existing HTML source [#f1]_, that may come from anywhere." msgstr "どこからでも取得できる既存のHTMLソース [#f1]_ を使用して作成します。" #: ../../recipes-stories.rst:39 5cb05c255e5b48348d3ab83f3bd57f28 msgid "Create using the Python API." msgstr "Python APIを使用して作成します。" #: ../../recipes-stories.rst:43 e8ff5379e66c49ce8776461b904793ef msgid "" "Variant using an existing HTML source [#f1]_ -- which in this case is " "defined as a constant in the script::" msgstr "既存のHTMLソース [#f1]_ を使用したバリアント – この場合、スクリプト内で定数として定義されています::" #: ../../recipes-stories.rst:69 fa5eb25963534e29b44ef593d2a08afd msgid "" "The above effect (sans-serif and blue text) could have been achieved by " "using a separate CSS source like so::" msgstr "上記の効果（サンセリフ体および青いテキスト）は、次のように別のCSSソースを使用することで達成できます::" #: ../../recipes-stories.rst:90 f582657322b343a4a158ef19912473f1 msgid "The Python API variant -- everything is created programmatically::" msgstr "Python APIのバリアント - すべてがプログラムで作成されます::" #: ../../recipes-stories.rst:114 a47a4f8569b14eb893a5ce9aeb3db643 msgid "Both variants will produce the same output PDF." msgstr "どちらのバリアントも同じ出力のPDFを生成します。" #: ../../recipes-stories.rst:122 2748abc7a81f48868dc86feadeed7cdc msgid "How to use Images" msgstr "画像の使用方法" #: ../../recipes-stories.rst:124 ecce5ae8803442768c9c0c9dcbaa0b91 msgid "" "Images can be referenced in the provided HTML source, or the reference to" " a desired image can also be stored via the Python API. In any case, this" " requires using an :ref:`Archive`, which refers to the place where the " "image can be found." msgstr "" "画像は提供されたHTMLソース内で参照することができます。また、Python " "APIを介して必要な画像への参照も保存することができます。どちらの場合も、画像が見つかる場所を指す :ref:`Archive` " "を使用する必要があります。" #: ../../recipes-stories.rst:126 db9731d3f4a84908b18bd2c0bac15515 msgid "" "Images with the binary content embedded in the HTML source are **not " "supported** by stories." msgstr "HTMLソースにバイナリコンテンツが埋め込まれた画像は、ストーリーズではサポートされていません。" #: ../../recipes-stories.rst:128 621a5032b00c42b780871bc2b317708f msgid "" "We extend our \"Hello World\" example from above and display an image of " "our planet right after the text. Assuming the image has the name " "\"world.jpg\" and is present in the script's folder, then this is the " "modified version of the above Python API variant::" msgstr "" "前述の「Hello " "World」の例を拡張し、テキストの直後に地球の画像を表示します。画像の名前が「world.jpg」であり、スクリプトのフォルダに存在すると仮定すると、次に示すようにPython" " APIバリアントを修正したものとなります::" #: ../../recipes-stories.rst:168 0bd066e55e8d42828fb2a8874920b48f msgid "How to Read External HTML and CSS for a Story" msgstr "外部のHTMLとCSSをストーリーに読み込む方法" #: ../../recipes-stories.rst:170 1dd80d2a8aa54fb7b10356e199ee9a9b msgid "These cases are fairly straightforward." msgstr "これらのケースはかなり直接的です。" #: ../../recipes-stories.rst:172 9e74fe2a5497459c880103c0b8c72e49 msgid "" "As a general recommendation, HTML and CSS sources should be **read as " "binary files** and decoded before using them in a story. The Python " "`pathlib.Path` provides convenient ways to do this::" msgstr "" "一般的な推奨事項として、HTMLとCSSのソースはバイナリファイルとして読み込まれ、ストーリーで使用する前にデコードされるべきです。Pythonの" " `pathlib.Path` は、これを便利に行うための方法を提供しています。::" #: ../../recipes-stories.rst:193 b15949b2628f4e559db2166cab03e684 msgid "How to Output Database Content with Story Templates" msgstr "データベースの内容をストーリーテンプレートで出力する方法" #: ../../recipes-stories.rst:195 ee70b3e26cb24cd281fd481f24b0f1f0 msgid "" "This script demonstrates how to report SQL database content using an " "**HTML template**." msgstr "このスクリプトは**HTMLテンプレート**を使用してSQLデータベースの内容を報告する方法を示しています。" #: ../../recipes-stories.rst:199 b38843035c074c12875aa488d121d745 msgid "The example SQL database contains two tables:" msgstr "この例のSQLデータベースには2つのテーブルが含まれています：" #: ../../recipes-stories.rst:201 2a5e075abb974afb8fabb4bc379b46cc msgid "" "Table \"films\" contains one row per film with the fields **\"title\"**, " "**\"director\"** and (release) **\"year\"**." msgstr "テーブル「films」には、フィールド「title」、「director」、および（公開）「year」を持つ1つの映画ごとの行が含まれています。" #: ../../recipes-stories.rst:202 3ca9978ff3384e669316aec51f82f4e3 msgid "" "Table \"actors\" contains one row per actor and film title (fields " "(actor) **\"name\"** and (film) **\"title\"**)." msgstr "テーブル「actors」には、1つの行に1人の俳優と映画のタイトルが含まれています（フィールド（actor）「name」と（film）「title」）。" #: ../../recipes-stories.rst:204 bcb64849fff74c60903737949f68225d msgid "" "The story DOM consists of a template for one film, which reports film " "data together with a list of casted actors." msgstr "ストーリーDOMは、映画の1つのテンプレートから成り、映画のデータと出演俳優のリストを報告します。" #: ../../recipes-stories.rst:206 ../../recipes-stories.rst:231 #: ../../recipes-stories.rst:257 ../../recipes-stories.rst:309 #: ../../recipes-stories.rst:343 ../../recipes-stories.rst:377 #: ../../recipes-stories.rst:398 ../../recipes-stories.rst:433 #: ../../recipes-stories.rst:467 ../../recipes-stories.rst:497 #: ../../recipes-stories.rst:531 2b3dd500f0434c64b97cf8b801ea18e2 #: 64fc1d7aed8a43cd92ff2d020bf13ec8 7eb60a8b9a42446594e53b2bf3c68871 #: a16e34a298a6425880ddf4fb4371e66e a22398fc103f4437ac647a31dd0d5fbf #: b70a18528557465e8f61dc1122eca0ed c000544d4c274bbb9db7672b53850bc0 #: d1607e50f7864da5afac7f3a5c6cfb74 d7f83da6ed26402bbc3b8fe0bc8c3e6c #: daf59f85090b4c6dac31f2a2498b1d40 f3388231edfd4b7a869bc003cbfe749a msgid "**Files:**" msgstr "**ファイル：**" #: ../../recipes-stories.rst:208 54585f66fd3d47c8b7fa6a18c5e6d437 msgid "`docs/samples/filmfestival-sql.py`" msgstr "" #: ../../recipes-stories.rst:209 a25f79113d4845688acf7e96fc25d405 msgid "`docs/samples/filmfestival-sql.db`" msgstr "" #: ../../recipes-stories.rst:212 ../../recipes-stories.rst:235 #: ../../recipes-stories.rst:263 ../../recipes-stories.rst:316 #: ../../recipes-stories.rst:347 ../../recipes-stories.rst:360 #: ../../recipes-stories.rst:381 ../../recipes-stories.rst:402 #: ../../recipes-stories.rst:437 ../../recipes-stories.rst:471 #: ../../recipes-stories.rst:501 ../../recipes-stories.rst:535 #: 0db5e50af58744b9a3fb1c616e67a684 28fc170e69fd4a44b4fa959ea9b3e32e #: 33679f3b5997465888776dda77506957 36f0be1fd15b4a8c84694c64491bd2c7 #: 37527330942949a0bd3be5dba9e785c4 5485b7bba46c4eda83ec8b43ca3d2ecf #: 7e7b5ee4ed9b4cf090a10dcda115473d addec11282d24d079e19186339ab1b65 #: c2ad827c824c44718c01801f503eb406 d8b52254ec3547f19f86eaca688e79bd #: de7617178b054648a843a36e24659eab fd40019209fb42f487a8b1836bcd3638 msgid "|toggleStart|" msgstr "" #: ../../recipes-stories.rst:216 ../../recipes-stories.rst:239 #: ../../recipes-stories.rst:267 ../../recipes-stories.rst:320 #: ../../recipes-stories.rst:351 ../../recipes-stories.rst:364 #: ../../recipes-stories.rst:385 ../../recipes-stories.rst:406 #: ../../recipes-stories.rst:441 ../../recipes-stories.rst:475 #: ../../recipes-stories.rst:505 ../../recipes-stories.rst:539 #: 1f64c481b7224504a02af891e0682cb3 266ea01fca494309b1cd1c30895d31bc #: 27da42d77a6b435bb286157e8930f759 52efc716cc3147a6a6486dfc0795eb8e #: 532a65455e3d4cc5acae0770c9f6847d 5e487c5fb8fa43078450b2f3e6e90793 #: 78f9acaef114448fb9edcb0e9b8ad611 918069a403554628bffb1412599598c8 #: 92734f09b2ab4e3c80847c556c5ede0f 9d3b034ebb21493683dc0e7e2bb7f19b #: a4115389a45c49f79c5235d1cab2feba f46a83317e2744c6979346649f812fde msgid "|toggleEnd|" msgstr "" #: ../../recipes-stories.rst:225 50ac8bd58ac94ca9bad75235813275b8 msgid "How to Integrate with Existing PDFs" msgstr "既存のPDFと統合する方法" #: ../../recipes-stories.rst:227 30768c0ff00d46c8acc3718442620f18 msgid "" "Because a :ref:`DocumentWriter` can only write to a new file, stories " "cannot be placed on existing pages. This script demonstrates a " "circumvention of this restriction." msgstr "" ":ref:`DocumentWriter` " "は新しいファイルにのみ書き込むことができるため、ストーリーは既存のページに配置することはできません。このスクリプトは、この制限を回避する方法を示しています。" #: ../../recipes-stories.rst:229 c4b4b44242604021bc2168807cae604d msgid "" "The basic idea is letting :ref:`DocumentWriter` output to a PDF in " "memory. Once the story has finished, we re-open this memory PDF and put " "its pages to desired locations on **existing** pages via method " ":meth:`Page.show_pdf_page`." msgstr "" "基本的な考え方は、 :ref:`DocumentWriter` " "がメモリ内のPDFに出力することです。ストーリーが完了したら、このメモリPDFを再度開き、メソッド " ":meth:`Page.show_pdf_page` を使用してそのページを既存のページに必要な位置に配置します。" #: ../../recipes-stories.rst:233 0ee71e800fb14b2ea803f1438f5379e4 msgid "`docs/samples/showpdf-page.py`" msgstr "" #: ../../recipes-stories.rst:248 2464de777541472497c10c81706a8467 msgid "" "How to Make Multi-Columned Layouts and Access Fonts from Package " "`pymupdf-fonts`_" msgstr "多段組のレイアウトを作成し、パッケージ `pymupdf-fonts`_ からフォントにアクセスする方法" #: ../../recipes-stories.rst:250 8dfd6dd8ca784d958d2a901ee4009a15 msgid "" "This script outputs an article (taken from Wikipedia) that contains text " "and multiple images and uses a 2-column page layout." msgstr "このスクリプトは、テキストと複数の画像を含む記事（Wikipediaから取得）を出力し、2列のページレイアウトを使用します。" #: ../../recipes-stories.rst:252 96f19cd490e0468983187394fd4f755d msgid "" "In addition, two \"Ubuntu\" font families from package `pymupdf-fonts`_ " "are used instead of defaulting to Base-14 fonts." msgstr "" "さらに、デフォルトではBase-14フォントにデフォルトでなく、パッケージpymupdf-" "fontsから2つの「Ubuntu」フォントファミリが使用されています。" #: ../../recipes-stories.rst:254 d104d23aa09e4c20a51bd1765f6ec72d msgid "" "Yet another feature used here is that all data -- the images and the " "article HTML -- are jointly stored in a ZIP file." msgstr "ここで使用される別の機能は、すべてのデータ – 画像と記事のHTML – が共にZIPファイルに格納されていることです。" #: ../../recipes-stories.rst:259 aabca9ed8f1545efa8e6c35a8fa570ed msgid "`docs/samples/quickfox.py`" msgstr "" #: ../../recipes-stories.rst:260 ../../recipes-stories.rst:313 #: 56254f7b3a3f48038ba0fec7307956e4 d0d48278d419432ea98f56ca84a85f66 msgid "`docs/samples/quickfox.zip`" msgstr "" #: ../../recipes-stories.rst:276 c5b48fe9ccc34243a9cafef7d92058ac msgid "How to Make a Layout which Wraps Around a Predefined \"no go area\" Layout" msgstr "あらかじめ定義された「禁止エリア」レイアウトに囲まれたレイアウトの作成方法" #: ../../recipes-stories.rst:279 9aeb4c6c24cf45918fc271c1bb22d655 msgid "" "This is a demo script using PyMuPDF's Story class to output text as a PDF" " with a two-column page layout." msgstr "これは、PyMuPDFのStoryクラスを使用してテキストを2列のページレイアウトでPDFとして出力するデモスクリプトです。" #: ../../recipes-stories.rst:282 9a9deed471b545109ffbf69ae0a63c13 msgid "The script demonstrates the following features:" msgstr "このスクリプトは、以下の機能を示しています：" #: ../../recipes-stories.rst:284 8325013303e24647a592be6d38854cfa msgid "Layout text around images of an existing (\"target\") PDF." msgstr "既存の（「ターゲット」）PDFの画像の周りにテキストをレイアウトします。" #: ../../recipes-stories.rst:285 12cd3a4970c942d28bc420575afefa73 msgid "" "Based on a few global parameters, areas on each page are identified, that" " can be used to receive text layouted by a Story." msgstr "各ページの特定の領域が、Storyによってレイアウトされたテキストを受け入れるために使用できるように、いくつかのグローバルパラメータに基づいて識別されます。" #: ../../recipes-stories.rst:287 5fb1ec0a189e438fbbb5d287d889152d msgid "" "These global parameters are not stored anywhere in the target PDF and " "must therefore be provided in some way:" msgstr "これらのグローバルパラメータは、ターゲットPDF内のどこにも保存されず、したがってどのような方法で提供される必要があります：" #: ../../recipes-stories.rst:290 2939a7b2c8ff40199db1fb38e01d1c41 msgid "The width of the border(s) on each page." msgstr "各ページのボーダーの幅。" #: ../../recipes-stories.rst:291 07ff55f6cd4b4ea3ada2d0100b667d23 msgid "" "The fontsize to use for text. This value determines whether the provided " "text will fit in the empty spaces of the (fixed) pages of target PDF. It " "cannot be predicted in any way. The script ends with an exception if " "target PDF has not enough pages, and prints a warning message if not all " "pages receive at least some text. In both cases, the FONTSIZE value can " "be changed (a float value)." msgstr "テキストに使用するフォントサイズ。この値は、提供されたテキストがターゲットPDFの（固定された）ページの空白スペースに収まるかどうかを決定します。これはどのように予測することもできません。ターゲットPDFに十分なページがない場合、スクリプトは例外をスローし、すべてのページが少なくとも一部のテキストを受け取らない場合は警告メッセージが表示されます。どちらの場合も、FONTSIZEの値を変更できます（浮動小数点数）。" #: ../../recipes-stories.rst:297 7f2693aa52f8413c957e3697cd159a39 msgid "Use of a 2-column page layout for the text." msgstr "テキストのための2列のページレイアウトの使用。" #: ../../recipes-stories.rst:298 74329206c6d84722884bd5ba5f248027 msgid "" "The layout creates a temporary (memory) PDF. Its produced page content " "(the text) is used to overlay the corresponding target page. If text " "requires more pages than are available in target PDF, an exception is " "raised. If not all target pages receive at least some text, a warning is " "printed." msgstr "レイアウトは一時的な（メモリ）PDFを作成します。その生成されたページのコンテンツ（テキスト）は、対応するターゲットページに重ねて配置されます。テキストがターゲットPDFの利用可能なページよりも多くのページを必要とする場合、例外が発生します。すべてのターゲットページが少なくとも一部のテキストを受け取らない場合、警告が表示されます。" #: ../../recipes-stories.rst:302 d18a70eaed5c44b98873dc74a92721a1 msgid "" "The script reads \"image-no-go.pdf\" in its own folder. This is the " "\"target\" PDF. It contains 2 pages with each 2 images (from the original" " article), which are positioned at places that create a broad overall " "test coverage. Otherwise the pages are empty." msgstr "" "スクリプトは、自分自身のフォルダ内の「image-no-" "go.pdf」を読み込みます。これが「ターゲット」PDFです。オリジナルの記事から2つの画像（各2ページ）を含み、それらは広範なテストカバレッジを作成する場所に配置されています。それ以外の場合、ページは空です。" #: ../../recipes-stories.rst:306 f46ddb852a574bd5a7bac7520a202c10 msgid "" "The script produces \"quickfox-image-no-go.pdf\" which contains the " "original pages and image positions, but with the original article text " "laid out around them." msgstr "" "スクリプトは「quickfox-image-no-" "go.pdf」を生成し、元のページと画像の位置を含みますが、元の記事のテキストがその周りにレイアウトされます。" #: ../../recipes-stories.rst:311 7df54784e06541489011541c3865adce msgid "`docs/samples/quickfox-image-no-go.py`" msgstr "" #: ../../recipes-stories.rst:312 06568562593e4d99b28e5de2e3b0939a msgid "`docs/samples/quickfox-image-no-go.pdf`" msgstr "" #: ../../recipes-stories.rst:329 71c7aa076de44ec38e26d2fb754afc9b msgid "How to Output an HTML Table" msgstr "HTMLテーブルの出力方法" #: ../../recipes-stories.rst:331 3301f44c71164017b224858b8757665b msgid "Outputting HTML tables is supported as follows:" msgstr "HTMLテーブルの出力は次のようにサポートされています：" #: ../../recipes-stories.rst:333 41e583af9b0542cdb2079c8ff6906052 msgid "" "Flat table layouts are supported (\"rows x columns\"), no support of the " "\"colspan\" / \"rowspan\" attributes." msgstr "フラットなテーブルレイアウト（「行 × 列」）がサポートされており、「colspan」/「rowspan」属性はサポートされていません。" #: ../../recipes-stories.rst:334 47d7baea9d4e4285881ba226de5af09d msgid "" "Table header tag :htmlTag:`th` supports attribute \"scope\" with values " "\"row\" or \"col\". Applicable text will be bold by default." msgstr "" "テーブルヘッダータグ :htmlTag:`th` は、属性 “scope” をサポートし、値として “row” または “col” " "を持ちます。適用されるテキストはデフォルトで太字になります。" #: ../../recipes-stories.rst:335 74d5008eb5a141a3a1cfc8a54b018574 msgid "" "Column widths are computed automatically based on column content. They " "cannot be directly set." msgstr "列の幅は、列のコンテンツに基づいて自動的に計算されます。直接設定することはできません。" #: ../../recipes-stories.rst:336 eced7f475d8d4d39b1c9a6daa98cb9e3 msgid "" "Table **cells may contain images** which will be considered in the column" " width calculation magic." msgstr "テーブルのセルには画像を含めることができ、これは列幅計算の際に考慮されます。" #: ../../recipes-stories.rst:337 2d09432449124bd29ad88bb9203b3eb7 msgid "" "Row heights are computed automatically based on row content - leading to " "multi-line rows where needed." msgstr "行の高さは、行のコンテンツに基づいて自動的に計算され、必要に応じて複数行の行が生成されます。" #: ../../recipes-stories.rst:338 99cd09b56b7a4038b94e8cc59054e98e msgid "" "The potentially multiple lines of a table row will always be kept " "together on one page (respectively \"where\" rectangle) and not be split." msgstr "テーブルの行の潜在的に複数行は、常に1つのページ（または “where” 矩形）にまとめて表示され、分割されることはありません。" #: ../../recipes-stories.rst:339 2b0dd155fb9b46abb1a3a34b5165e5cb msgid "" "Table header rows are only **shown on the first page / \"where\" " "rectangle.**" msgstr "テーブルのヘッダー行は、最初のページ / \"where\" 矩形のみに表示されます。" #: ../../recipes-stories.rst:340 9c971454188c471695037fe19b0b291f msgid "" "The \"style\" attribute is ignored when given directly in HTML table " "elements. Styling for a table and its elements must happen separately, in" " CSS source or within the :htmlTag:`style` tag." msgstr "" "直接HTMLテーブル要素に \"style\" 属性が与えられた場合、無視されます。テーブルとその要素のスタイリングは、CSSソース内または" " :htmlTag:`style` タグ内で別途行う必要があります。" #: ../../recipes-stories.rst:341 b6be54c8961a40fca5e5624606c40804 msgid "" "Styling for :htmlTag:`tr` elements is not supported and ignored. " "Therefore, a table-wide grid or alternating row background colors are not" " supported. One of the following example scripts however shows an easy " "way to deal with this limitation." msgstr "" ":htmlTag:`tr` " "要素のスタイリングはサポートされておらず、無視されます。したがって、テーブル全体のグリッドや交互の行の背景色はサポートされていません。ただし、以下の例スクリプトのいずれかは、この制限に対処する簡単な方法を示しています。" #: ../../recipes-stories.rst:345 3250a44850a04ea2b556eaa99626d432 msgid "`docs/samples/table01.py` This script reflects basic features." msgstr "`docs/samples/table01.py` このスクリプトは基本的な機能を反映しています。" #: ../../recipes-stories.rst:353 338c9d76f79b41df86b53304991fa447 msgid "" "`docs/samples/national-capitals.py` Advanced script extending table " "output options using simple additional code:" msgstr "" "`docs/samples/national-capitals.py` " "シンプルな追加コードを使用してテーブル出力オプションを拡張する高度なスクリプト:" #: ../../recipes-stories.rst:355 90d13dbe2506480f9d05c17929eb6886 msgid "Multi-page output simulating **repeating header rows**" msgstr "繰り返しヘッダー行をシミュレートするマルチページ出力" #: ../../recipes-stories.rst:356 cbf54ca5c2024e268d1186a280b3aa24 msgid "Alternating table row background colors" msgstr "交互のテーブル行の背景色" #: ../../recipes-stories.rst:357 2f63b307cf484d58a093efeda123e5fd msgid "Table rows and columns delimited by gridlines" msgstr "グリッドラインで区切られたテーブル行と列" #: ../../recipes-stories.rst:358 e5f6f8efbb6f4165b34f336502bd9f1c msgid "Table rows dynamically generated / filled with data from an SQL database" msgstr "SQLデータベースからデータを動的に生成/埋めるテーブル行" #: ../../recipes-stories.rst:373 fe9ae949732f4a8aa60268158ee88be6 msgid "How to Create a Simple Grid Layout" msgstr "シンプルなグリッドレイアウトの作成方法" #: ../../recipes-stories.rst:375 715590c3c78d4629ad6c5345990d29e2 msgid "" "By creating a sequence of :ref:`Story` objects within a grid created via " "the :ref:`make_table` function a developer can " "create grid layouts as required." msgstr "" ":ref:`make_table` 関数を使用して作成されたグリッド内で :ref:`Story` " "オブジェクトのシーケンスを作成することで、開発者は必要なグリッドレイアウトを作成できます。" #: ../../recipes-stories.rst:379 dd275a6adf8f4b8ea21b21fe0f4be667 msgid "`docs/samples/simple-grid.py`" msgstr "" #: ../../recipes-stories.rst:394 5e3cbf68e72d48f9a4d031caea74efe1 msgid "How to Generate a Table of Contents" msgstr "目次の生成方法" #: ../../recipes-stories.rst:396 eef825fca149402fa59fd4d03097fbcc msgid "" "This script lists the source code of all Python scripts that live in the " "script's directory." msgstr "このスクリプトは、スクリプトのディレクトリに存在するすべてのPythonスクリプトのソースコードをリスト表示します。" #: ../../recipes-stories.rst:400 f90b481f29e84be197d7b43765469464 msgid "`docs/samples/code-printer.py`" msgstr "" #: ../../recipes-stories.rst:409 c06dd956b971493bb3b3cbb5ad0a3e22 msgid "It features the following capabilities:" msgstr "次の機能が備わっています：" #: ../../recipes-stories.rst:411 b4d75405cd1b4d2bb534b59fb384119e msgid "" "Automatic generation of a Table of Contents (TOC) on separately numbered " "pages at the start of the document - using a specialized :ref:`Story`." msgstr "専用の :ref:`Story` を使用して、文書の冒頭に独立したページごとに自動的に目次（TOC）を生成します。" #: ../../recipes-stories.rst:413 6337def52daa43f9abdd769a10a39184 msgid "" "Use of 3 separate :ref:`Story` objects per page: header story, footer " "story and the story for printing the Python sources." msgstr "" "ページごとに3つの別個の :ref:`Story` " "オブジェクトを使用：ヘッダーストーリー、フッターストーリー、Pythonソースの印刷用ストーリー。" #: ../../recipes-stories.rst:415 4f7e17024ef64638a584ff82424ee1e1 msgid "" "The page **footer is automatically changed** to show the name of the " "current Python file." msgstr "ページフッターは自動的に変更され、現在のPythonファイル名が表示されます。" #: ../../recipes-stories.rst:417 13b96aa9ead945c698966dcda2ef5de1 msgid "" "Use of :meth:`Story.element_positions` to collect the data for the TOC " "and for the dynamic adjustment of page footers. This is an example of a " "**bidirectional communication** between the story output process and the " "script." msgstr "" ":meth:`Story.element_positions` " "の使用により、TOCのデータの収集とページフッターの動的調整に使用されます。これは、ストーリー出力プロセスとスクリプト間の双方向コミュニケーションの例です。" #: ../../recipes-stories.rst:419 a1b7b48737734821b3d4cee8cb99deb6 msgid "" "The main PDF with the Python sources is being written to memory by its " ":ref:`DocumentWriter`. Another :ref:`Story` / :ref:`DocumentWriter` pair " "is then used to create a (memory) PDF for the TOC pages. Finally, both " "these PDFs are joined and the result stored to disk." msgstr "" "主なPythonソースをその :ref:`DocumentWriter` によってメモリに書き込みます。その後、もう一つの " ":ref:`Story` / :ref:`DocumentWriter` " "のペアを使用して（メモリ）PDFをTOCページのために作成します。最後に、これらのPDFは結合されて結果がディスクに保存されます。" #: ../../recipes-stories.rst:428 99dd73162add4ea0afbb0634cf53dcf6 msgid "How to Display a List from JSON Data" msgstr "JSONデータからリストを表示する方法" #: ../../recipes-stories.rst:430 6fdc8240537845b5b007826459e137e2 msgid "" "This example takes some JSON data input which it uses to populate a " ":ref:`Story`. It also contains some visual text formatting and shows how " "to add links." msgstr "" "この例では、JSONデータ入力を使用して :ref:`Story` " "を生成し、いくつかの視覚的なテキスト書式設定を行い、リンクを追加する方法を示しています。" #: ../../recipes-stories.rst:435 af211242fc1e45d4935f0534d472ea83 msgid "`docs/samples/json-example.py`" msgstr "" #: ../../recipes-stories.rst:451 d1800a418d944e7bbe3af548c292e262 msgid "Using the Alternative :meth:`Story.write*()` functions" msgstr ":meth:`Story.write*()` 関数の使用方法" #: ../../recipes-stories.rst:453 a6aa8d8c6606441b896c25ed8b547c36 msgid "" "The :meth:`Story.write*()` functions provide a different way to use the " ":ref:`Story` functionality, removing the need for calling code to " "implement a loop that calls :meth:`Story.place()` and " ":meth:`Story.draw()` etc, at the expense of having to provide at least a " "`rectfn()` callback." msgstr "" ":meth:`Story.write*()` 関数は、 :ref:`Story` " "機能を異なる方法で使用するための方法を提供します。これにより、呼び出しコードが :meth:`Story.place()` や " ":meth:`Story.draw()` などを呼び出すループを実装する必要がなくなりますが、少なくとも `rectfn()` " "コールバックを提供する必要があります。" #: ../../recipes-stories.rst:462 0b9c207cf6c34028bd59a17ba745a06b msgid "How to do Basic Layout with :meth:`Story.write()`" msgstr ":meth:`Story.write()` を使用した基本的なレイアウトの方法" #: ../../recipes-stories.rst:464 3afb41fae5c04c80bb274a6695783cf8 msgid "" "This script lays out multiple copies of its own source code, into four " "rectangles per page." msgstr "このスクリプトは、自身のソースコードの複数のコピーを1ページあたり4つの四角形にレイアウトします。" #: ../../recipes-stories.rst:469 eaa7c3914c6e4d10b06fc5e83aef6ef9 msgid "`docs/samples/story-write.py`" msgstr "" #: ../../recipes-stories.rst:484 254625a2c4634deb8a6e5fed8ffd181e msgid "" "How to do Iterative Layout for a Table of Contents with " ":meth:`Story.write_stabilized()`" msgstr ":meth:`Story.write_stabilized()` を使用した目次付きの繰り返しレイアウトの方法" #: ../../recipes-stories.rst:486 f99a682ccb04406c9c3fb8d6add61ab6 msgid "" "This script creates html content dynamically, adding a contents section " "based on :ref:`ElementPosition` items that have non-zero `.heading` " "values." msgstr "" "このスクリプトは、要素の位置情報（:ref:`ElementPosition` アイテム）を基にコンテンツを動的に作成し、`.heading` " "値がゼロでない要素に基づいて目次セクションを追加します。" #: ../../recipes-stories.rst:489 f707d1092f04401f906070fe2e82c373 msgid "" "The contents section is at the start of the document, so modifications to" " the contents can change page numbers in the rest of the document, which " "in turn can cause page numbers in the contents section to be incorrect." msgstr "目次セクションは文書の先頭に配置されているため、目次への変更によって文書の他の部分のページ番号が変更され、それに伴い目次セクションのページ番号が正しくなくなる可能性があります。" #: ../../recipes-stories.rst:493 0fee61fd78ed4f9ab50188a4fd67cce7 msgid "" "So the script uses :meth:`Story.write_stabilized()` to repeatedly lay " "things out until things are stable." msgstr "したがって、スクリプトは :meth:`Story.write_stabilized()` を使用して、安定するまで繰り返しレイアウトを行います。" #: ../../recipes-stories.rst:499 42fb0df4e27948abb714018fac0417f5 msgid "`docs/samples/story-write-stabilized.py`" msgstr "" #: ../../recipes-stories.rst:514 17025d9951f14511b6e562a16ce16843 msgid "" "How to do Iterative Layout and Create PDF Links with " ":meth:`Story.write_stabilized_links()`" msgstr "繰り返しレイアウトと PDF リンクの作成方法：:meth:`Story.write_stabilized_links()` の使用" #: ../../recipes-stories.rst:516 fb00dcb0ee8d442495b1e4dff18aa8bc msgid "" "This script is similar to the one described in \"How to use " ":meth:`Story.write_stabilized()`\" above, except that the generated PDF " "also contains links that correspond to the internal links in the original" " html." msgstr "" "このスクリプトは、「:meth:`Story.write_stabilized()` " "の使用方法」で説明されているものと類似していますが、生成される PDF には、元の HTML 内の内部リンクに対応するリンクも含まれています。" #: ../../recipes-stories.rst:520 6dc7e0e7857b4aa5a713ffcb6869f11c msgid "" "This is done by using :meth:`Story.write_stabilized_links()`; this is " "slightly different from :meth:`Story.write_stabilized()`:" msgstr "" "これは、:meth:`Story.write_stabilized_links()` を使用して行われます。これは " ":meth:`Story.write_stabilized()` とわずかに異なります：" #: ../../recipes-stories.rst:523 77950ef72ea147ec8060ff1ce1609032 msgid "It does not take a :ref:`DocumentWriter` `writer` arg." msgstr ":ref:`DocumentWriter` の `writer` 引数は必要ありません。" #: ../../recipes-stories.rst:524 f61073b1496a472eb4ffa2abdafdbcdd msgid "It returns a PDF :ref:`Document` instance." msgstr "PDF :ref:`Document` のインスタンスを返します。" #: ../../recipes-stories.rst:526 8200eb3c7ddb4141beb9fd18576a6795 msgid "" "[The reasons for this are a little involved; for example a " ":ref:`DocumentWriter` is not necessarily a PDF writer, so doesn't really " "work in a PDF-specific API.]" msgstr "" "[これに関する理由は少し複雑です。例えば、 :ref:`DocumentWriter` が必ずしも PDF ライターであるとは限らず、PDF " "特有の API ではあまりうまく動作しないためです。]" #: ../../recipes-stories.rst:533 6cb38487f6e444d1a3092633504e9b1e msgid "`docs/samples/story-write-stabilized-links.py`" msgstr "" #: ../../recipes-stories.rst:547 7ab6a39468b647919043a79fb3f1c46b msgid "Footnotes" msgstr "脚注" #: ../../recipes-stories.rst:548 6b3a6c4d3e5341b0b7eb4ef2b8a275a9 msgid "HTML & CSS support" msgstr "" #: ../../recipes-stories.rst:552 a2b43d5c16a449989cd09987682f3446 msgid "" "At the time of writing the HTML engine for Stories is fairly basic and " "supports a subset of CSS2 attributes." msgstr "執筆時点では、ストーリーのHTMLエンジンはかなり基本的であり、一部のCSS2属性をサポートしています。" #: ../../recipes-stories.rst:554 97098e31431e469cb54b616f0cdfed52 msgid "Some important CSS support to consider:" msgstr "考慮すべき重要なCSSサポート:" #: ../../recipes-stories.rst:556 6aea20cf470f4b5b85843b4657ecc2c2 msgid "The only available layout is relative layout." msgstr "唯一利用可能なレイアウトは相対レイアウトです。" #: ../../recipes-stories.rst:557 569101dce0664d508b481c1cce2d5b73 msgid "`background` is unavailable, use `background-color` instead." msgstr "`background` は利用できませんが、代わりに `background-color` を使用してください。" #: ../../recipes-stories.rst:558 6d32b59649cf4d4ea1b9b964f070004f msgid "`float` is unavailable." msgstr "`float` は利用できません。" #: ../../footer.rst:60 bf323a0643e14a8fbf2f882c9ed3db27 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes-text.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 db5f378b70004af590010a41f0163be1 msgid "Artifex" msgstr "" #: ../../header.rst:-1 148acec04cbf474bb41f5d5e3c1ec508 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 e6b3ab82dcbf41f687b68d59732a00a5 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../recipes-text.rst:7 70700f14953047898a918c1a07026ce4 msgid "Text" msgstr "テキスト" #: ../../recipes-text.rst:13 83030b51505549bba2596e8da94111a2 msgid "How to Extract all Document Text" msgstr "すべてのドキュメントテキストを抽出する方法" #: ../../recipes-text.rst:15 d8d7d26a27a346a5b03d28e400fed598 msgid "" "This script will take a document filename and generate a text file from " "all of its text." msgstr "このスクリプトは、ドキュメントのファイル名を受け取り、そのテキストからテキストファイルを生成します。" #: ../../recipes-text.rst:17 c4c73613ac86439c93304a2549dbad7f msgid "The document can be any :ref:`supported type`." msgstr "ドキュメントは、:ref:`サポートされている ` 任意のタイプのものが使用できます。" #: ../../recipes-text.rst:19 8a339400b648449eab4a10cf290842dc msgid "" "The script works as a command line tool which expects the document " "filename supplied as a parameter. It generates one text file named " "\"filename.txt\" in the script directory. Text of pages is separated by a" " form feed character::" msgstr "このスクリプトはコマンドラインツールとして機能し、ドキュメントのファイル名をパラメータとして受け取ります。スクリプトのディレクトリに「filename.txt」という名前のテキストファイルが生成されます。ページのテキストはフォームフィード文字で区切られます。" #: ../../recipes-text.rst:28 8a4f5ec777ce40e8a27b5ef06541f000 msgid "" "The output will be plain text as it is coded in the document. No effort " "is made to prettify in any way. Specifically for PDF, this may mean " "output not in usual reading order, unexpected line breaks and so forth." msgstr "出力はドキュメント内でコード化された通りのプレーンテキストになるため、見栄えの調整は行いません。特にPDFの場合、通常の読み順にならない出力や予期せぬ改行などが発生するかもしれません。" #: ../../recipes-text.rst:30 fa3eea374680406b9a9fba35f66055ca msgid "" "You have many options to rectify this -- see chapter :ref:`Appendix2`. " "Among them are:" msgstr "" "これを修正するための多くのオプションがあります。詳細は :ref:`Appendix2` " "章「埋め込みファイルに関する考慮事項」を参照してください。以下の方法があります：" #: ../../recipes-text.rst:32 93321f1d110c45879711cddd65ff7248 msgid "" "Extract text in HTML format and store it as a HTML document, so it can be" " viewed in any browser." msgstr "テキストをHTML形式で抽出し、HTMLドキュメントとして保存することで、任意のブラウザで表示できるようにします。" #: ../../recipes-text.rst:33 d31ce8ccb61f4333b9485c37ae95f7a1 msgid "" "Extract text as a list of text blocks via *Page.get_text(\"blocks\")*. " "Each item of this list contains position information for its text, which " "can be used to establish a convenient reading order." msgstr "Page.get_text(\"blocks\")を使ってテキストブロックのリストとして抽出します。リストの各アイテムにはテキストの位置情報が含まれており、便利な読み順を確立するのに使用できます。" #: ../../recipes-text.rst:34 97d77e0ecd494eb89e58bf1dfd6f89b0 msgid "" "Extract a list of single words via *Page.get_text(\"words\")*. Its items " "are words with position information. Use it to determine text contained " "in a given rectangle -- see next section." msgstr "Page.get_text(\"words\")を使って単語のリストを抽出します。各アイテムには位置情報が含まれています。これを使用して特定の四角形に含まれるテキストを決定します。" #: ../../recipes-text.rst:36 f695a7c93e504149bb7de0f587892b2a msgid "See the following two sections for examples and further explanations." msgstr "以下の2つのセクションを見て、例と詳細な説明をご覧ください。" #: ../../recipes-text.rst:44 37809012042b408fab85b6b39de8e823 msgid "How to Extract Text as Markdown" msgstr "テキストをMarkdown形式で抽出する方法" #: ../../recipes-text.rst:46 5c0dcdf0ae704f9aa9fd1bc738b0c185 msgid "" "This is especially useful for :title:`RAG/LLM` environments - please see " ":ref:`Outputting as Markdown `." msgstr "" "これは、特に :title:`RAG/LLM` 環境にとって便利です - :ref:`Outputting as Markdown " "` を参照してください。" #: ../../recipes-text.rst:52 442230f4e860484f83323c6a20d08e08 msgid "How to Extract Key-Value Pairs from a Page" msgstr "ページからキーと値のペアを抽出する方法" #: ../../recipes-text.rst:53 9555400172a34d69bae562156d51b80c msgid "" "If the layout of a page is *\"predictable\"* in some sense, then there is" " a simple way to find the values for a given set of keywords fast and " "easily -- without using regular expressions. Please see `this example " "script `_." msgstr "" "もしページのレイアウトがある程度予測可能であれば、正規表現を使用せずに、特定のキーワードに対する値を迅速かつ簡単に見つける方法があります。 " "`以下の例のスクリプト `_ を参照してください。" #: ../../recipes-text.rst:55 f8548ec2c56441c0aa02ed28f3607350 msgid "\"Predictable\" in this context means:" msgstr "ここでの「予測可能」とは、次のような意味です：" #: ../../recipes-text.rst:57 0e297df5b4ed4548956122fabdd7e963 msgid "" "Every keyword is followed by its value -- no other text is present in " "between them." msgstr "各キーワードの後にはその値が続きます。それらの間に他のテキストはありません。" #: ../../recipes-text.rst:58 f9375ed8400040619728b9f1d3031882 msgid "" "The bottom of the value's boundary box is **not above** the one of the " "keyword." msgstr "値の境界ボックスの下端は、キーワードの境界ボックスよりも上にありません。" #: ../../recipes-text.rst:59 be1d806d61424c179b103fbdfef14d11 msgid "" "There are **no other restrictions**: the page layout may or may not be " "fixed, and the text may also have been stored as one string. Key and " "value may have any distance from each other." msgstr "他の制約はありません：ページのレイアウトが固定されているかどうかは問いませんし、テキストは1つの文字列として保存されている可能性もあります。キーと値はお互いに任意の距離を持つかもしれません。" #: ../../recipes-text.rst:61 05731f2a8f5b4e72a99dbd3afb4628ff msgid "" "For example, the following five key-value pairs will be correctly " "identified::" msgstr "例として、以下の5つのキーと値のペアが正しく識別されます::" #: ../../recipes-text.rst:77 635adbc1c75c4e019220ca2fafd16863 msgid "How to Extract Text from within a Rectangle" msgstr "四角形内のテキストを抽出する方法" #: ../../recipes-text.rst:78 c66f827c3b4e4d40937891f31bca0ed8 msgid "" "There is now (v1.18.0) more than one way to achieve this. We therefore " "have created a `folder `_ in the PyMuPDF-Utilities " "repository specifically dealing with this topic." msgstr "" "現在（v1.18.0）では、これを実現するための複数の方法があります。そのため、私たちは `PyMuPDF-Utilities " "`_ リポジトリに、この特定のトピックに対応するフォルダを作成しました。" #: ../../recipes-text.rst:88 d80121123daf4bf2a3e069027d837c3f msgid "How to Extract Text in Natural Reading Order" msgstr "自然な読み順でテキストを抽出する方法" #: ../../recipes-text.rst:90 c1cc039bb3804acebad6d1f03565e6be msgid "" "One of the common issues with PDF text extraction is, that text may not " "appear in any particular reading order." msgstr "PDFのテキスト抽出によくある問題の1つは、テキストが特定の読み順に表示されないことです。" #: ../../recipes-text.rst:92 16fbf3e452294bcd88f4d82c83bc87d6 msgid "" "This is the responsibility of the PDF creator (software or a human). For " "example, page headers may have been inserted in a separate step -- after " "the document had been produced. In such a case, the header text will " "appear at the end of a page text extraction (although it will be " "correctly shown by PDF viewer software). For example, the following " "snippet will add some header and footer lines to an existing PDF::" msgstr "これはPDFの作成者（ソフトウェアまたは人間）の責任です。たとえば、ページヘッダーはドキュメントが作成された後の別のステップで挿入された可能性があります。そのような場合、ヘッダーテキストはページテキストの抽出の最後に表示されることがあります（ただし、PDFビューアソフトウェアでは正しく表示されます）。以下のスニペットは、既存のPDFにいくつかのヘッダーとフッターの行を追加します::" #: ../../recipes-text.rst:104 978688d53bd949cc898416980acbc003 msgid "" "The text sequence extracted from a page modified in this way will look " "like this:" msgstr "このように変更されたページから抽出されたテキストのシーケンスは次のようになります：" #: ../../recipes-text.rst:106 ef048f5a008646e991b0568de7841cb2 msgid "original text" msgstr "元のテキスト" #: ../../recipes-text.rst:107 dc14bb8d05724f89a619b2d3cceb4926 msgid "header line" msgstr "ヘッダーライン" #: ../../recipes-text.rst:108 babbbbad94c4402ea4effe7f7adbca5d msgid "footer line" msgstr "フッターライン" #: ../../recipes-text.rst:110 e694010b792d4eb0855e2f6564a46a67 msgid "" "PyMuPDF has several means to re-establish some reading sequence or even " "to re-generate a layout close to the original:" msgstr "PyMuPDFには、いくつかの方法で読み順を再確立したり、元のレイアウトに近い形で再生成する手段があります：" #: ../../recipes-text.rst:112 716e99c2ff9344fe81fafd78de2007c3 msgid "" "Use `sort` parameter of :meth:`Page.get_text`. It will sort the output " "from top-left to bottom-right (ignored for XHTML, HTML and XML output)." msgstr "" ":meth:`Page.get_text` の `sort` " "パラメーターを使用します。これにより、出力が左上から右下に向かってソートされます（XHTML、HTML、XML出力には無効です）。" #: ../../recipes-text.rst:113 bcd2685affe8476281c9b4f6df0f6ff9 msgid "" "Use the `pymupdf` module in CLI: `python -m pymupdf gettext ...`, which " "produces a text file where text has been re-arranged in layout-preserving" " mode. Many options are available to control the output." msgstr "" "CLIで `pymupdf` モジュールを使用します： `python -m pymupdf gettext ...` " "。これにより、テキストがレイアウトを保持するモードで再配置されたテキストファイルが生成されます。出力を制御するための多くのオプションが利用可能です。" #: ../../recipes-text.rst:115 b14412bcce2e4fabab0f9c2421c08934 msgid "" "You can also use the above mentioned `script " "`_ with your modifications." msgstr "" "また、上記の `スクリプト `_ を自分の変更とともに使用することもできます。" #: ../../recipes-text.rst:122 6fb4548c9a0a42da9939b9ba59fee62a msgid "" "How to :index:`Extract Table Content ` from " "Documents" msgstr "ドキュメントから表の内容を抽出する方法" #: ../../recipes-text.rst:123 b9aeb958d874414a8dfbe817d7e491be msgid "" "If you see a table in a document, you are normally not looking at " "something like an embedded Excel or other identifiable object. It usually" " is just normal, standard text, formatted to appear as tabular data." msgstr "文書で表を見る場合、通常は埋め込まれたExcelなどの識別可能なオブジェクトのようなものではありません。通常、単なる通常の標準テキストで、表のデータとして表示されるようにフォーマットされています。" #: ../../recipes-text.rst:125 48f2b8ac5dc54b469a4fac3b57e95083 msgid "" "Extracting tabular data from such a page area therefore means that you " "must find a way to **identify** the table area (i.e. its boundary box), " "then **(1)** graphically indicate table and column borders, and **(2)** " "then extract text based on this information." msgstr "したがって、そのようなページ領域から表のデータを抽出するには、まず表の領域（つまり、その境界ボックス）を特定する方法を見つける必要があり、その後（1）グラフィカルに表と列の境界を示し、（2）この情報に基づいてテキストを抽出する必要があります。" #: ../../recipes-text.rst:127 b55a6db346bb4df3adb269cd4da2d2a1 msgid "" "This can be a very complex task, depending on details like the presence " "or absence of lines, rectangles or other supporting vector graphics." msgstr "これは、線、四角形、またはその他のサポートベクトルグラフィックの存在または不在などの詳細に依存するため、非常に複雑なタスクになる可能性があります。" #: ../../recipes-text.rst:129 2ab382191b1e4c8dbcb05ab17b9a6f16 msgid "" "Method :meth:`Page.find_tables` does all that for you, with a high table " "detection precision. Its great advantage is that there are no external " "library dependencies, nor the need to employ artificial intelligence or " "machine learning technologies. It also provides an integrated interface " "to the well-known Python package for data analysis `pandas " "`_." msgstr "" "Method :meth:`Page.find_tables` " "は、高い表検出精度を備えて、すべてをあなたのために行います。その大きな利点は、外部ライブラリの依存関係がないこと、人工知能や機械学習技術を使用する必要がないことです。また、データ分析のためのPythonパッケージである" " `pandas `_ のための統合されたインターフェースも提供します。" #: ../../recipes-text.rst:131 b620d2150671401698d7a280f56ee3cc msgid "" "Please have a look at example `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages." msgstr "" "標準的な状況をカバーする例の `Jupyter `_ " "ノートブックをご覧いただければ幸いです。これには、1つのページに複数の表や複数のページにまたがる表の断片を結合するなどの状況が含まれています。" #: ../../recipes-text.rst:138 259587f74c604a45bd83bdba19dbfdd9 msgid "How to Mark Extracted Text" msgstr "抽出したテキストをマークする方法" #: ../../recipes-text.rst:139 b7f64cd47ccb4f889b2a09f74c66564f msgid "" "There is a standard search function to search for arbitrary text on a " "page: :meth:`Page.search_for`. It returns a list of :ref:`Rect` objects " "which surround a found occurrence. These rectangles can for example be " "used to automatically insert annotations which visibly mark the found " "text." msgstr "" "ページ上で任意のテキストを検索するための標準的な検索機能があります: :meth:`Page.search_for` " "です。これは、見つかったテキストを囲む :ref:`Rect` " "オブジェクトのリストを返します。これらの四角形は、見つかったテキストを目に見えるようにマークするために自動的に注釈を挿入するのに使用できます。" #: ../../recipes-text.rst:141 febfc5dbb25f420dbf6c3ef3e88b24c4 msgid "This method has advantages and drawbacks. Pros are:" msgstr "この方法には利点と欠点があります。利点は次のとおりです：" #: ../../recipes-text.rst:143 101f473976a74f1c9ab424859e8862dd msgid "The search string can contain blanks and wrap across lines" msgstr "検索文字列には空白を含めることができ、行をまたぐことができます。" #: ../../recipes-text.rst:144 6ad25d7b6043421a8142042b3b9a3ec9 msgid "Upper or lower case characters are treated equal" msgstr "大文字と小文字は同じように扱われます。" #: ../../recipes-text.rst:145 b3efeff8f1c9463ab435a4742bc0c5bd msgid "Word hyphenation at line ends is detected and resolved" msgstr "行末での単語のハイフネーションが検出され、解決されます。" #: ../../recipes-text.rst:146 7a50b0a1eba54da5a0cbd913bde35367 msgid "" "Return may also be a list of :ref:`Quad` objects to precisely locate text" " that is **not parallel** to either axis -- using :ref:`Quad` output is " "also recommended, when page rotation is not zero." msgstr "" "返り値は :ref:`Quad` " "オブジェクトのリストになる場合もあり、これにより軸に対して平行でないテキストを正確に位置付けることができます。ページの回転がゼロでない場合には、 " ":ref:`Quad` の出力を使用することも推奨されます。" #: ../../recipes-text.rst:148 9f60ccd5aee74a1bb2f791ed857906ac msgid "But you also have other options::" msgstr "ただし、他にも選択肢があります::" #: ../../recipes-text.rst:182 324f957419b2409787a7496e75b13dee msgid "" "This script uses `Page.get_text(\"words\")` to look for a string, handed " "in via cli parameter. This method separates a page's text into \"words\" " "using white spaces as delimiters. Further remarks:" msgstr "このスクリプトは、cliパラメーターを介して渡された文字列を検索するためにPage.get_text(\"words\")を使用します。この方法では、ページのテキストがスペースと改行を区切りとして「単語」に分割されます。さらなる注釈：" #: ../../recipes-text.rst:184 e11b43b6869e46b89ed4021f9ca781ea msgid "" "If found, the **complete word containing the string** is marked " "(underlined) -- not only the search string." msgstr "文字列が見つかった場合、検索文字列だけでなく、その文字列を含む完全な単語がマークされます（アンダーラインが引かれます）。" #: ../../recipes-text.rst:185 04e60745b3b34c6b91dcf325e659bc11 msgid "" "The search string may **not contain word delimiters**. By default, word " "delimiters are white spaces and the non-breaking space `chr(0xA0)`. If " "you use extra delimiting characters like `page.get_text(\"words\", " "delimiters=\"./,\")` then none of these characters should be included in " "your search string either." msgstr "" "検索文字列には単語の区切り文字を含めることはできません。デフォルトでは、単語の区切り文字は空白と非改行空白 `chr(0xA0)` です。もし、 " "`page.get_text(\"words\", delimiters=\"./,\")` " "のような追加の区切り文字を使用する場合は、これらの文字を検索文字列に含めてはいけません。" #: ../../recipes-text.rst:186 d2efc0fb67834d26a4980492e4ba653b msgid "" "As shown here, upper / lower cases are **respected**. But this can be " "changed by using the string method *lower()* (or even regular " "expressions) in function *mark_word*." msgstr "" "ここで示したように、大文字と小文字は区別されますが、`mark_word` 関数で `lower()` " "メソッド（または正規表現）を使用することで変更できます。" #: ../../recipes-text.rst:187 f1f92985f2ae49809306e7b57ba6c5b1 msgid "There is **no upper limit**: all occurrences will be detected." msgstr "上限はありません。すべての出現を検出します。" #: ../../recipes-text.rst:188 6639bc0b294042f3b7da287582d935d1 msgid "" "You can use **anything** to mark the word: 'Underline', 'Highlight', " "'StrikeThrough' or 'Square' annotations, etc." msgstr "単語をマークするために何を使用しても構いません：「アンダーライン」、「ハイライト」、「取り消し線」、「四角」の注釈などがあります。" #: ../../recipes-text.rst:189 f003fe97efd4436285d6bc3016b36180 msgid "" "Here is an example snippet of a page of this manual, where \"MuPDF\" has " "been used as the search string. Note that all strings **containing " "\"MuPDF\"** have been completely underlined (not just the search string)." msgstr "以下は、このマニュアルのページの一部の例スニペットで、「MuPDF」が検索文字列として使用されています。注意：「MuPDF」を含むすべての文字列が完全にアンダーラインで引かれていることに注意してください（検索文字列だけでなく）。" #: ../../recipes-text.rst:200 07364170c89f43d7a469ec584d3f4f06 msgid "How to Mark Searched Text" msgstr "検索したテキストをマークする方法" #: ../../recipes-text.rst:204 11638cbd201f4578b319a8b04e773026 msgid "This script searches for text and marks it::" msgstr "このスクリプトはテキストを検索してマークします::" #: ../../recipes-text.rst:230 15b785bdfebf418aba157f4f78a77e4b msgid "The result looks like this:" msgstr "結果は以下のようになります：" #: ../../recipes-text.rst:241 080eb1dc215a426e9e7a03e134dc4fa2 msgid "How to Mark Non-horizontal Text" msgstr "非水平テキストをマークする方法" #: ../../recipes-text.rst:242 6fe2ff76b1d0421d8ab98c926c234cb0 msgid "" "The previous section already shows an example for marking non-horizontal " "text, that was detected by text **searching**." msgstr "前のセクションでは、テキスト検索によって検出された非水平テキストのマークの例が既に示されています。" #: ../../recipes-text.rst:244 9f3587b3ee80418e80f13b3ad91233ec msgid "" "But text **extraction** with the \"dict\" / \"rawdict\" options of " ":meth:`Page.get_text` may also return text with a non-zero angle to the " "x-axis. This is indicated by the value of the line dictionary's `\"dir\"`" " key: it is the tuple `(cosine, sine)` for that angle. If `line[\"dir\"] " "!= (1, 0)`, then the text of all its spans is rotated by (the same) angle" " != 0." msgstr "" "しかし、 :meth:`Page.get_text` " "の「dict」/「rawdict」オプションを使用したテキスト抽出では、x軸に対してゼロでない角度のテキストも返される場合があります。これは、行の辞書の" " \"dir\" キーの値によって示されます：それはその角度に対する `(cosine, sine)` のタプルです。 " "`line[\"dir\"] != (1, 0)` であれば、すべてのスパンのテキストは (同じ) 角度 != 0 によって回転しています。" #: ../../recipes-text.rst:246 b5ac4e18122a4f8985e80cf88f3152b4 msgid "" "The \"bboxes\" returned by the method however are rectangles only -- not " "quads. So, to mark span text correctly, its quad must be recovered from " "the data contained in the line and span dictionary. Do this with the " "following utility function (new in v1.18.9)::" msgstr "ただし、このメソッドによって返される「bboxes」は四角形のみであり、クワッドではありません。したがって、スパンテキストを正しくマークするには、行とスパンの辞書に含まれるデータからクワッドを回復する必要があります。以下のユーティリティ関数を使用してください（v1.18.9で新しく追加されました）::" #: ../../recipes-text.rst:251 220c8fb8fa4b46c781ff32905bc0a24e msgid "" "If you want to **mark the complete line** or a subset of its spans in one" " go, use the following snippet (works for v1.18.10 or later)::" msgstr "一度に完全な行またはその一部のスパンをマークしたい場合は、以下のスニペットを使用してください（v1.18.10以降で動作します）" #: ../../recipes-text.rst:258 85d1dfa0969b4848b83f9b2f117d981c msgid "" "The `spans` argument above may specify any sub-list of `line[\"spans\"]`." " In the example above, the second to second-to-last span are marked. If " "omitted, the complete line is taken." msgstr "" "上記の `spans` 引数は、`line[\"spans\"]` " "の任意の部分リストを指定できます。上記の例では、2番目から最後から2番目のスパンがマークされます。省略すると、完全な行が取得されます" #: ../../recipes-text.rst:265 b4aaece1bac342df88b2588a53b1488f msgid "How to Analyze Font Characteristics" msgstr "フォントの特性を分析する方法" #: ../../recipes-text.rst:266 3d03a051124b43d1bae8d901b0aecd28 msgid "" "To analyze the characteristics of text in a PDF use this elementary " "script as a starting point:" msgstr "PDF内のテキストの特性を分析するには、以下の初歩的なスクリプトを出発点として使用します::" #: ../../recipes-text.rst:271 f055a412baca41b5a95b0ecadafe2e3e msgid "Here is the PDF page and the script output:" msgstr "以下はPDFページとスクリプトの出力です。" #: ../../recipes-text.rst:282 66219ea8cab542688f83c1bd81f081c1 msgid "How to Insert Text" msgstr "テキストの挿入方法" #: ../../recipes-text.rst:283 4e0c636dd4ac4eb387bcde62a6a2a175 msgid "" "PyMuPDF provides ways to insert text on new or existing PDF pages with " "the following features:" msgstr "PyMuPDFは、以下の機能を備えて新しいまたは既存のPDFページにテキストを挿入する方法を提供しています：" #: ../../recipes-text.rst:285 155bbc5aa1454c93b980b30ac316c0b0 msgid "" "choose the font, including built-in fonts and fonts that are available as" " files" msgstr "フォントの選択：組み込みのフォントやファイルとして利用可能なフォントを選択できます。" #: ../../recipes-text.rst:286 b9dd50f8a43d417ea405cd07b235088d msgid "choose text characteristics like bold, italic, font size, font color, etc." msgstr "テキストの特性の選択：太字、斜体、フォントサイズ、フォントカラーなど、テキストの特性を選択できます。" #: ../../recipes-text.rst:287 f938ab7b656c436297d8120a887e4fcc msgid "position the text in multiple ways:" msgstr "テキストの配置方法：" #: ../../recipes-text.rst:289 96ff2b06077841bf82fb23104230f9ed msgid "either as simple line-oriented output starting at a certain point," msgstr "特定のポイントを起点として単純な行指向の出力として配置することができます。 " #: ../../recipes-text.rst:290 dcf40c10ea294dc8a656732166297259 msgid "" "or fitting text in a box provided as a rectangle, in which case text " "alignment choices are also available," msgstr "ボックスにテキストをフィットさせる場合は、テキストの配置を選択することもできます。この場合、テキストの整列オプションも利用できます。" #: ../../recipes-text.rst:291 056f2e92f23f4d41beb702386a246a80 msgid "" "choose whether text should be put in foreground (overlay existing " "content)," msgstr "テキストを前面に配置するか選択できます（既存のコンテンツをオーバーレイします）。" #: ../../recipes-text.rst:292 5999867be03a4be495cbfd225913c3d4 msgid "" "all text can be arbitrarily \"morphed\", i.e. its appearance can be " "changed via a :ref:`Matrix`, to achieve effects like scaling, shearing or" " mirroring," msgstr "テキストは任意に「変形」されることができます。つまり、行列を使用して拡大、せん断、反転などの効果を得ることができます。" #: ../../recipes-text.rst:293 25c6fa1fb2344a02a3a693135a7b5ad4 msgid "" "independently from morphing and in addition to that, text can be rotated " "by integer multiples of 90 degrees." msgstr "変形とは別に、テキストを90度の整数倍で回転させることもできます。" #: ../../recipes-text.rst:295 2190abc125234360a3e1fab88ef34947 msgid "" "All of the above is provided by three basic :ref:`Page`, resp. " ":ref:`Shape` methods:" msgstr "以上のすべては、それぞれの基本的な :ref:`Page` 、:ref:`Shape` メソッドによって提供されています。" #: ../../recipes-text.rst:297 4fb036ddb792472197216092b9eefddb msgid "" ":meth:`Page.insert_font` -- install a font for the page for later " "reference. The result is reflected in the output of " ":meth:`Document.get_page_fonts`. The font can be:" msgstr "" ":meth:`Page.insert_font` - ページにフォントをインストールして後で参照できるようにします。その結果は、 " ":meth:`Document.get_page_fonts` の出力に反映されます。フォントは以下の方法で提供できます：" #: ../../recipes-text.rst:299 3c7f3dadc700412b9396227e3e8b9ff6 msgid "provided as a file," msgstr "ファイルとして提供する。" #: ../../recipes-text.rst:300 40d5ff2c32c44c6584f3112ed978abef msgid "via :ref:`Font` (then use :attr:`Font.buffer`)" msgstr ":ref:`Font` を使用して提供する（その場合、 :attr:`Font.buffer` を使用します）。" #: ../../recipes-text.rst:301 6267fd1e928e41658810a84d52de31c7 msgid "already present somewhere in **this or another** PDF, or" msgstr "既にこのPDFまたは別のPDFのどこかに存在する。" #: ../../recipes-text.rst:302 2ebf7edb3c7e4c4482334300df5af372 msgid "be a **built-in** font." msgstr "組み込みフォントである。" #: ../../recipes-text.rst:304 e6a884a850ad4cb49e2a74eeb2f5bc61 msgid "" ":meth:`Page.insert_text` -- write some lines of text. Internally, this " "uses :meth:`Shape.insert_text`." msgstr "" ":meth:`Page.insert_text` - テキストの行を書き込みます。内部的には :meth:`Shape.insert_text`" " を使用します。" #: ../../recipes-text.rst:306 5252e3a0b80e49a4af1e7a62b8a2cc00 msgid "" ":meth:`Page.insert_textbox` -- fit text in a given rectangle. Here you " "can choose text alignment features (left, right, centered, justified) and" " you keep control as to whether text actually fits. Internally, this uses" " :meth:`Shape.insert_textbox`." msgstr "" ":meth:`Page.insert_textbox` - " "指定された矩形にテキストをフィットさせます。ここでは、テキストの整列機能（左揃え、右揃え、中央揃え、両端揃え）を選択できます。また、テキストが実際にフィットするかどうかの制御もできます。内部的には" " :meth:`Shape.insert_textbox` を使用します。" #: ../../recipes-text.rst:308 0d6285e91b3c45608b972b2de7612705 msgid "Both text insertion methods automatically install the font as necessary." msgstr "テキスト挿入の両方の方法は、必要に応じてフォントを自動的にインストールします。" #: ../../recipes-text.rst:314 4615115cc7ec417e9025309e87d5c912 msgid "How to Write Text Lines" msgstr "テキスト行を書く方法" #: ../../recipes-text.rst:315 c5ec955ab13243b49f36ee01f5a5e363 msgid "Output some text lines on a page::" msgstr "ページにいくつかのテキスト行を出力する方法::" #: ../../recipes-text.rst:336 8385d05c2aaf4baf89657017938f1841 msgid "" "With this method, only the **number of lines** will be controlled to not " "go beyond page height. Surplus lines will not be written and the number " "of actual lines will be returned. The calculation uses a line height " "calculated from the :data:`fontsize` and 36 points (0.5 inches) as bottom" " margin." msgstr "" "この方法では、ページの高さを超えないように行の数だけを制御します。余剰の行は書き込まれず、実際の行数が返されます。計算には、:data:`fontsize`" " と36ポイント（0.5インチ）のボトムマージンから計算された行の高さが使用されます。" #: ../../recipes-text.rst:338 86eb433806094945b5d70882c088708a msgid "" "Line **width is ignored**. The surplus part of a line will simply be " "invisible." msgstr "行の幅は無視されます。行の余剰部分は単に見えなくなります。" #: ../../recipes-text.rst:340 a76488ed16d54e53b404c6f7a09d9313 msgid "" "However, for built-in fonts there are ways to calculate the line width " "beforehand - see :meth:`get_text_length`." msgstr "ただし、組み込みのフォントには、行の幅を事前に計算する方法があります。 :meth:`get_text_length` を参照してください。" #: ../../recipes-text.rst:342 b366c349b7114db78ed6f108144468f9 msgid "" "Here is another example. It inserts 4 text strings using the four " "different rotation options, and thereby explains, how the text insertion " "point must be chosen to achieve the desired result::" msgstr "以下は別の例です。4つの異なる回転オプションを使用してテキスト文字列を挿入し、それにより、望む結果を得るためにどのようにテキスト挿入ポイントを選択すべきかを説明しています::" #: ../../recipes-text.rst:378 fb820c64521f4522a238d2ce77dcaf18 msgid "This is the result:" msgstr "これが結果です。" #: ../../recipes-text.rst:390 541c84709e8840f99fe3aba0b40495a5 msgid "How to Fill a Text Box" msgstr "テキストボックスの塗りつぶし方" #: ../../recipes-text.rst:391 c6dcf5cccb0044f8b35d759a5221dfae msgid "" "This script fills 4 different rectangles with text, each time choosing a " "different rotation value::" msgstr "このスクリプトは、異なる回転値を選択して、4つの異なる長方形にテキストを塗りつぶします。" #: ../../recipes-text.rst:428 2e957f827c5b40aaa4e166eb9499bfbb msgid "" "Some default values were used above: font size 11 and text alignment " "\"left\". The result will look like this:" msgstr "上記ではいくつかのデフォルト値が使用されました：フォント「Helvetica」、フォントサイズ11、テキストの配置は「左寄せ」です。結果は以下のようになります。" #: ../../recipes-text.rst:438 c7e2172b7c074d11b35164dc32c22e23 msgid "How to Fill a Box with HTML Text" msgstr "HTMLテキストでボックスを埋める方法" #: ../../recipes-text.rst:439 42df2d56d1f34d98823882e630fe1cf7 msgid "" "Method :meth:`Page.insert_htmlbox` offers a **much more powerful** way to" " insert text in a rectangle." msgstr "メソッド :meth:`Page.insert_htmlbox` は、矩形にテキストを挿入するための **より強力な** 方法を提供します。" #: ../../recipes-text.rst:441 d5759271e33d478eae11f568d17338fc msgid "" "Instead of simple, plain text, this method accepts HTML source, which may" " not only contain HTML tags but also styling instructions to influence " "things like font, font weight (bold) and style (italic), color and much " "more." msgstr "このメソッドは、単純なプレーンテキストではなく、HTMLソースを受け入れます。HTMLタグのみならず、フォント、フォントの太さ（太字）、スタイル（イタリック）、色などを含むスタイル指示も含まれます。" #: ../../recipes-text.rst:443 ba663f954c914a1a8d20788c385f392c msgid "" "It is also possible to mix multiple fonts and languages, to output HTML " "tables and to insert images and URI links." msgstr "複数のフォントや言語を混在させ、HTMLテーブルを出力し、画像やURIリンクを挿入することも可能です。" #: ../../recipes-text.rst:445 e592608d0a5348499aff8a592bb61837 msgid "" "For even more styling flexibility, an additional CSS source may also be " "given." msgstr "さらなるスタイリングの柔軟性を求める場合、追加のCSSソースを指定することもできます。" #: ../../recipes-text.rst:447 11d3134828ab455a9beb1bd08b3eedc9 msgid "" "The method is based on the :ref:`Story` class. Therefore, complex script " "systems like Devanagari, Nepali, Tamil and many are supported and written" " correctly thanks to using the HarfBuzz library - which provides this so-" "called **\"text shaping\"** feature." msgstr "" "このメソッドは、 :ref:`Story` " "（ストーリー）クラスに基づいています。そのため、デーヴァナーガリ、ネパール語、タミル語などの複雑な文字体系がサポートされ、HarfBuzzライブラリを使用して正しく書き込まれています" " - これがいわゆる **「テキストの形成」** 機能を提供します。" #: ../../recipes-text.rst:449 702e632bbb1846448ff097d413da8fb7 msgid "" "Any required fonts to output characters are automatically pulled in from " "the Google NOTO font library - as a fallback (when the -- optionally " "supplied -- user font(s) do not contain some glyphs)." msgstr "" "文字を出力するために必要なフォントは、--オプションで提供される--" "ユーザーフォントが一部のグリフを含んでいない場合のフォールバックとして、Google NOTOフォントライブラリから自動的に取得されます。" #: ../../recipes-text.rst:451 6c11c27cd47042e2974d9dad0680a2a9 msgid "" "As a small glimpse into the features offered here, we will output the " "following HTML-enriched text::" msgstr "ここで提供される機能の一端をご覧いただくために、以下のHTMLエンリッチされたテキストを出力します：" #: ../../recipes-text.rst:476 2ad55055659d456fabde0186e22d4e26 msgid "" "Please note how the \"css\" parameter is used to globally select the " "default \"sans-serif\" font and a font size of 14." msgstr "「css」パラメータが、デフォルトの「sans-serif」フォントとフォントサイズ14をグローバルに選択する方法に注意してください。" #: ../../recipes-text.rst:478 ../../recipes-text.rst:546 #: 3c4cca1121d6405eb83e0cb2871b7570 8e7f4fe263f24763bbf69efa19489d99 msgid "The result will look like this:" msgstr "結果は以下のようになります：" #: ../../recipes-text.rst:483 b7f446683eca4524b8fc2bd988191712 msgid "How to output HTML tables and images" msgstr "HTMLテーブルや画像を出力する方法" #: ../../recipes-text.rst:485 ed6bb1a3fe524fbda24f9c97da319399 msgid "" "Here is another example that outputs a table with this method. This time," " we are including all the styling in the HTML source itself. Please also " "note, how it works to include an image - even within a table cell::" msgstr "以下は、このメソッドを使用してテーブルを出力する別の例です。今回は、すべてのスタイリングをHTMLソース自体に含めています。また、テーブルセル内に画像を含める方法についても、ご注意ください::" #: ../../recipes-text.rst:552 4cd24c13bbba4d8d8b0887c53d530e7e msgid "How to Output Languages of the World" msgstr "世界の言語を出力する方法" #: ../../recipes-text.rst:554 5e1849ae29cd4ee787b3105c593def1a msgid "" "Our third example will demonstrate the automatic multi-language support. " "It includes automatic **text shaping** for complex scripting systems like" " Devanagari and right-to-left languages::" msgstr "" "3つ目の例では、自動多言語サポートを示します。これには、デーヴァナーガリや右から左への言語などの複雑なスクリプトシステムに対する自動 " "**テキスト整形** も含まれます：" #: ../../recipes-text.rst:584 7f93ecf38f45410098070b9c478823f0 msgid "And this is the output:" msgstr "これが結果です。" #: ../../recipes-text.rst:589 0fc8a571f2164e8b8fa47da93210cc9b msgid "How to Specify your Own Fonts" msgstr "独自のフォントを指定する方法" #: ../../recipes-text.rst:591 f4ddad35adde440a9851a6e69fcfcf35 msgid "" "Define your font files in CSS syntax using the `@font-face` statement. " "You need a separate `@font-face` for every combination of font weight and" " font style (e.g. bold or italic) you want to be supported. The following" " example uses the famous MS Comic Sans font in its four variants regular," " bold, italic and bold-italic." msgstr "" "`@font-face` " "ステートメントを使用して、CSS構文でフォントファイルを定義します。サポートされるフォントのウェイトとスタイル（太字や斜体など）の組み合わせごとに、個別の" " `@font-face` が必要です。以下の例では、有名な MS Comic Sans フォントの 4 " "つのバリアント（通常、太字、斜体、太字斜体）を使用しています。" #: ../../recipes-text.rst:593 f8779468c07c47ef9000fb2979f5214c msgid "" "As these four font files are located in the system's folder " "`C:/Windows/Fonts` the method needs an :ref:`Archive` definition that " "points to that folder::" msgstr "" "これらの 4 つのフォントファイルがシステムのフォルダ `C:/Windows/Fonts` にあるため、このメソッドには、そのフォルダを指す " ":ref:`Archive` （アーカイブ）の定義が必要です。" #: ../../recipes-text.rst:642 06ab66e236cc4a2ea7d4c5a99612f4dd msgid "How to Request Text Alignment" msgstr "テキストの配置をリクエストする方法" #: ../../recipes-text.rst:644 7795bb870b4f42f187a0efe85b6c761d msgid "This example combines multiple requirements:" msgstr "この例では、複数の要件を組み合わせています" #: ../../recipes-text.rst:646 ff142aa60660494db8d4272e60183ff1 msgid "Rotate the text by 90 degrees anti-clockwise." msgstr "テキストを90度反時計回りに回転させます。" #: ../../recipes-text.rst:647 c1627013d8474a4f82eb9fcc874f012c msgid "" "Use a font from package `pymupdf-fonts `_. You will see that the respective CSS definitions are a lot " "easier in this case." msgstr "" "`pymupdf-fonts `_ " "パッケージからフォントを使用します。この場合、該当するCSS定義がはるかに簡単であることに気付くでしょう。" #: ../../recipes-text.rst:648 827ab2e55bb64443b6dcbb706662051a msgid "Align the text with the \"justify\" option." msgstr "テキストを \"justify\" オプションで配置します。" #: ../../recipes-text.rst:698 424d197ff94d4b4f9c4c0cc4513a960d msgid "How to Extract Text with Color" msgstr "色付きのテキストを抽出する方法" #: ../../recipes-text.rst:700 a842d1070655423986ddbb7afdbb289b msgid "" "Iterate through your text blocks and find the spans of text you need for " "this information." msgstr "テキストブロックを繰り返し処理し、必要な情報のテキストスパンを見つけます。" #: ../../footer.rst:60 b02445d3686f4215969d2dff8b922af2 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "The search string may **not contain spaces** or other white space." #~ msgstr "検索文字列にはスペースや他の空白文字を含めることはできません。" #~ msgid "How to Use Non-Standard Encoding" #~ msgstr "非標準エンコーディングの使用方法" #~ msgid "" #~ "Since v1.14, MuPDF allows Greek and " #~ "Russian encoding variants for the " #~ ":data:`Base14_Fonts`. In PyMuPDF this is " #~ "supported via an additional *encoding* " #~ "argument. Effectively, this is relevant " #~ "for Helvetica, Times-Roman and Courier" #~ " (and their bold / italic forms) " #~ "and characters outside the ASCII code" #~ " range only. Elsewhere, the argument " #~ "is ignored. Here is how to request" #~ " Russian encoding with the standard " #~ "font Helvetica::" #~ msgstr "" #~ "v1.14以降、MuPDFでは :data:`Base14_Fonts` " #~ "のギリシャ語およびロシア語のエンコーディングバリアントが許可されています。PyMuPDFでは、これは追加のエンコーディング引数を介してサポートされています。これは実際にはHelvetica" #~ "、Times-" #~ "Roman、Courier（およびそれらの太字/斜体形式）およびASCIIコード範囲外の文字にのみ影響します。他の場所では、この引数は無視されます。以下は、標準フォントHelveticaでロシア語のエンコーディングを要求する方法です::" #~ msgid "" #~ "The valid encoding values are " #~ "TEXT_ENCODING_LATIN (0), TEXT_ENCODING_GREEK (1)," #~ " and TEXT_ENCODING_CYRILLIC (2, Russian) " #~ "with Latin being the default. Encoding" #~ " can be specified by all relevant " #~ "font and text insertion methods." #~ msgstr "有効なエンコーディング値は、TEXT_ENCODING_LATIN（0）、TEXT_ENCODING_GREEK（1）、TEXT_ENCODING_CYRILLIC（2、ロシア語）であり、デフォルトはLatinです。エンコーディングは、すべての関連するフォントおよびテキスト挿入メソッドで指定できます。" #~ msgid "" #~ "By the above statement, the fontname " #~ "*helv* is automatically connected to the" #~ " Russian font variant of Helvetica. " #~ "Any subsequent text insertion with " #~ "**this fontname** will use the Russian" #~ " Helvetica encoding." #~ msgstr "上記の記述により、フォント名「helv」は自動的にHelveticaのロシア語バリアントに接続されます。このフォント名を使用して以降のテキスト挿入では、ロシア語のHelveticaエンコーディングが使用されます。" #~ msgid "" #~ "If you change the fontname just " #~ "slightly, you can also achieve an " #~ "**encoding \"mixture\"** for the **same " #~ "base font** on the same page::" #~ msgstr "フォント名をわずかに変更することで、同じベースフォントの同じページ上でエンコーディングの「混合」を実現することもできます。" #~ msgid "The result:" #~ msgstr "結果は以下の通りです。" #~ msgid "" #~ "The snippet above indeed leads to " #~ "three different copies of the Helvetica" #~ " font in the PDF. Each copy is" #~ " uniquely identified (and referenceable) by" #~ " using the correct upper-lower case" #~ " spelling of the reserved word " #~ "\"helv\"::" #~ msgstr "上記のスニペットは実際にPDF内にHelveticaフォントの3つの異なるコピーを生成します。各コピーは正しい大文字小文字のスペル（\"helv\"）を使用して一意に識別され、参照が可能です。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/recipes.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4009185189884afa815f06437219b17a msgid "Artifex" msgstr "" #: ../../header.rst:-1 0945b3eedd774aa1bf2ed67c92baa34e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 5438d71f4a5f445c9c4929c4169009b8 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../footer.rst:60 8482813d3d6a47a39130184e645552b4 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/rect.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 3c227dada5ad4b709a49770ee170baa6 msgid "Artifex" msgstr "" #: ../../header.rst:-1 8f56716e037546c8b467b98c68c725a0 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 dfa0342751984e2f98c9f67f7362520d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../rect.rst:7 ad45c59577c04e0d97cd0d7904581921 msgid "Rect" msgstr "Rect (矩形)" #: ../../rect.rst:9 7f5d586f3c114edaa7ba458bfd6acb19 msgid "" "*Rect* represents a rectangle defined by four floating point numbers x0, " "y0, x1, y1. They are treated as being coordinates of two diagonally " "opposite points. The first two numbers are regarded as the \"top left\" " "corner P\\ :sub:`(x0,y0)` and P\\ :sub:`(x1,y1)` as the \"bottom right\" " "one. However, these two properties need not coincide with their intuitive" " meanings -- read on." msgstr "" "*Rect* " "は、4つの浮動小数点数x0、y0、x1、y1によって定義される矩形を表します。これらは対角線上の2つの点の座標と見なされます。最初の2つの数は「左上」のコーナー" " P\\ :sub:`(x0,y0)` とし、 P\\ :sub:`(x1,y1)` " "は「右下」のコーナーとします。ただし、これら2つのプロパティは直感的な意味と一致する必要はありません。以下を読んでください。" #: ../../rect.rst:11 dafcd3bc742b4bf98df8a2d355642314 msgid "The following remarks are also valid for :ref:`IRect` objects:" msgstr ":ref:`IRect` オブジェクトにも以下の注釈は有効です。" #: ../../rect.rst:13 be324158236b4de8923841e0b42e8290 msgid "" "A rectangle in the sense of (Py-) MuPDF **(and PDF)** always has " "**borders parallel to the x- resp. y-axis**. A general orthogonal " "tetragon **is not a rectangle** -- in contrast to the mathematical " "definition." msgstr "" "(Py-)MuPDF **（およびPDF）** の意味での矩形は常に **x-またはy軸に平行な境界** を持ちます。一般的な直交四角形は " "**矩形ではなく** 、数学的な定義とは対照的です。" #: ../../rect.rst:14 03d260254e054fa0874151431af0b147 msgid "" "The constructing points can be (almost! -- see below) anywhere in the " "plane -- they need not even be different, and e.g. \"top left\" need not " "be the geometrical \"north-western\" point." msgstr "構築ポイントは平面上のどこにでも配置できます。異なる必要すらなく、たとえば「左上」が幾何学的に「北西」の点である必要はありません。" #: ../../rect.rst:15 fe6fa15cf8b7439aa597e5fcf5b13134 msgid "Units are in points, where 72 points is 1 inch." msgstr "単位はポイントで、72ポイントが1インチです。" #: ../../rect.rst:20 130a99f1057240a98f97beb4238fadbc msgid "" "For any given quadruple of numbers, the geometrically \"same\" rectangle " "can be defined in four different ways:" msgstr "与えられた4つの数値に対して、幾何学的に「同じ」矩形は4つの異なる方法で定義できます。" #: ../../rect.rst:17 03ee461b9fd7463e92b92b0999c2952b msgid "Rect(P\\ :sub:`(x0,y0)`, P\\ :sub:`(x1,y1)`\\ )" msgstr "" #: ../../rect.rst:18 4e4f6956c7774df98b15fe8f1f149cef msgid "Rect(P\\ :sub:`(x1,y1)`, P\\ :sub:`(x0,y0)`\\ )" msgstr "" #: ../../rect.rst:19 7b63166e1f914252a70101cc5e25c590 msgid "Rect(P\\ :sub:`(x0,y1)`, P\\ :sub:`(x1,y0)`\\ )" msgstr "" #: ../../rect.rst:20 baae5ac330ae44adb90f80708b977873 msgid "Rect(P\\ :sub:`(x1,y0)`, P\\ :sub:`(x0,y1)`\\ )" msgstr "" #: ../../rect.rst:22 3775def55ff3492ea62cba278b2ff00e msgid "**(Changed in v1.19.0)** Hence some classification:" msgstr "**(v1.19.0で変更)** したがって、いくつかの分類があります。" #: ../../rect.rst:24 005b82343a4c4d4282a0fc3d8a056830 msgid "" "A rectangle is called **valid** if `x0 <= x1` and `y0 <= y1` (i.e. the " "bottom right point is \"south-eastern\" to the top left one), otherwise " "**invalid**. Of the four alternatives above, **only the first** is valid." " Please take into account, that in MuPDF's coordinate system, the y-axis " "is oriented from **top to bottom**. Invalid rectangles have been called " "infinite in earlier versions." msgstr "" "矩形は、 `x0 <= x1` および `y0 <= y1` （つまり、右下の点が左上の点の「南東」にある）の場合にのみ **有効** " "と呼ばれます。したがって、上記の4つの代替案のうち、**最初のものだけ** が有効です。MuPDFの座標系では、y軸は **上から下** " "に向かっていますので、注意してください。無効な矩形は以前のバージョンでは 無限と呼ばれていました。" #: ../../rect.rst:26 50cc1e1a23b7410e9b40d9e4a22e2552 msgid "" "A rectangle is called **empty** if `x0 >= x1` or `y0 >= y1`. This " "implies, that **invalid rectangles are also always empty.** And `width` " "(resp. `height`) is **set to zero** if `x0 > x1` (resp. `y0 > y1`). In " "previous versions, a rectangle was empty only if one of width or height " "was zero." msgstr "" "矩形は、 `x0 >= x1` または `y0 >= y1` の場合に **空** と呼ばれます。これは、**無効な矩形** " "も常に空であることを意味します。また、 `x0 > x1` （または `y0 > y1` ）の場合、幅（または高さ）は **ゼロに設定** " "されます。以前のバージョンでは、矩形が空であるのは幅または高さのいずれかがゼロの場合に限られていました。" #: ../../rect.rst:28 6b8c92c5c94146e38742390553f50ad5 msgid "" "Rectangle coordinates **cannot be outside** the number range from " "`FZ_MIN_INF_RECT = -2147483648` to `FZ_MAX_INF_RECT = 2147483520`. Both " "values have been chosen, because they are the smallest / largest 32bit " "integers that survive C float conversion roundtrips. In previous versions" " there was no limit for coordinate values." msgstr "" "矩形の座標は、`FZ_MIN_INF_RECT = -2147483648` から `FZ_MAX_INF_RECT = 2147483520`" " " "までの数値範囲内にある必要があります。これらの値は、C浮動小数点変換のラウンドトリップを生き残る最小/最大の32ビット整数であるため選ばれました。以前のバージョンでは、座標値の制限はありませんでした。" #: ../../rect.rst:30 f7c36d56736842c7b5057e7ce77215f1 msgid "" "There is **exactly one \"infinite\" rectangle**, defined by `x0 = y0 = " "FZ_MIN_INF_RECT` and `x1 = y1 = FZ_MAX_INF_RECT`. It contains every other" " rectangle. It is mainly used for technical purposes -- e.g. when a " "function call should ignore a formally required rectangle argument. This " "rectangle is not empty." msgstr "" "**「無限」の矩形は** 、`x0 = y0 = FZ_MIN_INF_RECT` および `x1 = y1 = FZ_MAX_INF_RECT`" " " "で定義され、他のすべての矩形を含みます。これは主に技術的な目的で使用されます。たとえば、関数呼び出しで形式的に必要な矩形引数を無視する必要がある場合などです。この矩形は空ではありません。" #: ../../rect.rst:32 3fd9c878f8a345649eececf661fa6d0d msgid "" "**Rectangles are (semi-) open:** The right and the bottom edges " "(including the resp. corners) are not considered part of the rectangle. " "This implies, that only the top-left corner `(x0, y0)` can ever belong to" " the rectangle - the other three corners never do. An empty rectangle " "contains no corners at all." msgstr "" "**矩形は（半）開いています**。右側と下側のエッジ（およびそれに含まれるコーナー）は矩形の一部とは見なされません。したがって、矩形に属することができるのは左上のコーナー" " `(x0, y0)` のみです。他の3つのコーナーは常に含まれません。空の矩形にはまったくコーナーが含まれていません。" #: ../../rect.rst:38 e57daedf444e46e1b812656ca7832537 msgid "Here is an overview of the changes." msgstr "以下は変更の概要です。" #: ../../rect.rst:41 d393f3a6d9de4c8fa2e06182c5f78760 msgid "Notion" msgstr "概要" #: ../../rect.rst:41 d97438c124b14f35aa198e1ddfb8cfd0 msgid "Versions < 1.19.0" msgstr "バージョン < 1.19.0" #: ../../rect.rst:41 7af7abdfb7bc4aa4b28ed21073d90bea msgid "Versions 1.19.*" msgstr "バージョン 1.19.*" #: ../../rect.rst:43 e4224c064e3f4f68bbb16f57e9a1c844 msgid "empty" msgstr "空" #: ../../rect.rst:43 48dde36927434fceacc3a177956672c7 msgid "x0 = x1 or y0 = y1" msgstr "x0 = x1 または y0 = y1" #: ../../rect.rst:43 3835fcc0738d40929f1271a1c05290b9 msgid "x0 >= x1 or y0 >= y1 -- includes invalid rects" msgstr "x0 >= x1 または y0 >= y1 – 無効な矩形も含む" #: ../../rect.rst:44 f6c28fec698849cf9309e6c849791287 msgid "valid" msgstr "有効" #: ../../rect.rst:44 754108a5de3646168f6a70e07a111bd9 msgid "n/a" msgstr "なし" #: ../../rect.rst:44 e09f640fd0134a039d61766e33a9c329 msgid "x0 <= x1 and y0 <= y1" msgstr "x0 <= x1 かつ y0 <= y1" #: ../../rect.rst:45 17a59c383cd546c8adfe6a7d8ef48da9 msgid "infinite" msgstr "無限" #: ../../rect.rst:45 65113a7b423f4f98b9ce9fcada710d50 msgid "all rects where x0 > x1 or y1 > y0" msgstr "x0 > x1 または y1 > y0 のすべての矩形" #: ../../rect.rst:45 41c40bda2ada47e085b2f7f2004a8b76 msgid "**exactly one infinite rect / irect!**" msgstr "**無限の矩形 / irectは1つだけです！**" #: ../../rect.rst:46 4f4ac3d83ad64ebba6176c33b68c4cb3 msgid "coordinate values" msgstr "座標値" #: ../../rect.rst:46 453a3c51c1434dc5b1579f747187deb0 msgid "all numbers" msgstr "すべての数値" #: ../../rect.rst:46 4ca5d71efdb04d8693a83e57697d9d37 msgid "`FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT`" msgstr "FZ_MIN_INF_RECT <= 数値 <= FZ_MAX_INF_RECT" #: ../../rect.rst:47 2209987532a249858e55c63d07e52b9c msgid "borders, corners" msgstr "境界、コーナー" #: ../../rect.rst:47 b6ae01c480064de9b11987d6892db4ca msgid "are parts of the rectangle" msgstr "矩形の一部です" #: ../../rect.rst:47 8ef673ab0bbc4257baaeffbe19220f28 msgid "right and bottom corners and edges **are outside**" msgstr "右下の角とエッジは **外側にあります**" #: ../../rect.rst:50 e3e932700fd949daa0353b543c8a1a4c msgid "" "There are new top level functions defining infinite and standard empty " "rectangles and quads, see :meth:`INFINITE_RECT` and friends." msgstr "" "新しいトップレベルの関数が追加され、無限と標準の空の四角形および四角形を定義します。:meth:`INFINITE_RECT` " "などを参照してください。" #: ../../rect.rst:54 81a610b0aa1f472b8ae9fea35a2a2c01 msgid "**Methods / Attributes**" msgstr "**メソッド / 属性**" #: ../../rect.rst:54 4ed08c7116224212b88dc25acd42d0b0 msgid "**Short Description**" msgstr "**短い説明**" #: ../../rect.rst:56 5981a119a05e4daa876289ac03fc5a13 msgid ":meth:`Rect.contains`" msgstr "" #: ../../rect.rst:56 3b511deb4033483dbea1c5c304c2ec6f msgid "checks containment of point_likes and rect_likes" msgstr "point_likesおよびrect_likesの包含をチェックします。" #: ../../rect.rst:57 9f5f335e79444316a8a3c6dea665cf95 msgid ":meth:`Rect.get_area`" msgstr "" #: ../../rect.rst:57 1de8d41280804dcf9822b29195cfe5fe msgid "calculate rectangle area" msgstr "四角形の面積を計算します。" #: ../../rect.rst:58 7a22090e4a0d467a8ad2400c55ed9f2f msgid ":meth:`Rect.include_point`" msgstr "" #: ../../rect.rst:58 0526b2070f7e45feab7a311c9ee31128 msgid "enlarge rectangle to also contain a point" msgstr "点も含むように四角形を拡大します。" #: ../../rect.rst:59 5d2792546865489e8ac28d97886676fb msgid ":meth:`Rect.include_rect`" msgstr "" #: ../../rect.rst:59 d9b74ad40df64c1da33f10578102b172 msgid "enlarge rectangle to also contain another one" msgstr "別の四角形も含むように四角形を拡大します。" #: ../../rect.rst:60 a084869227454408971a27d515578280 msgid ":meth:`Rect.intersect`" msgstr "" #: ../../rect.rst:60 fc0d24eaf262443a9767ab3a639a91cf msgid "common part with another rectangle" msgstr "別の四角形との共通部分です。" #: ../../rect.rst:61 783c6bb9f98a4c9a9173a33426e15261 msgid ":meth:`Rect.intersects`" msgstr "" #: ../../rect.rst:61 48c32f08f9bd4fcaba35388fa46ffb7d msgid "checks for non-empty intersections" msgstr "非空の交差をチェックします。" #: ../../rect.rst:62 54b41e15307745659f567a94fe69654b msgid ":meth:`Rect.morph`" msgstr "" #: ../../rect.rst:62 2724138758314afea0cd2a6f82c22cdd msgid "transform with a point and a matrix" msgstr "点と行列を使用して四角形を変形します。" #: ../../rect.rst:63 fa29117650a04cf992bfbf167039b34d msgid ":meth:`Rect.torect`" msgstr "" #: ../../rect.rst:63 a1b856036d3a4a869c4bfef61e84bc7d msgid "the matrix that transforms to another rectangle" msgstr "別の四角形に変換する行列です。" #: ../../rect.rst:64 eb541dbc3c38455b94ddf221f6366d80 msgid ":meth:`Rect.norm`" msgstr "" #: ../../rect.rst:64 61a0e738f2784973be15065b6e9b3bf2 msgid "the Euclidean norm" msgstr "ユークリッドノルム" #: ../../rect.rst:65 e9cec2f1207b4e358bcb22df6331bb76 msgid ":meth:`Rect.normalize`" msgstr "" #: ../../rect.rst:65 8ba545c6dd824fd08fd072a2c568c6db msgid "makes a rectangle valid" msgstr "四角形を有効にします" #: ../../rect.rst:66 ebfc99cce7a74afabc7adf051e9804cc msgid ":meth:`Rect.round`" msgstr "" #: ../../rect.rst:66 a5ff1b1dfaf54324b20c6908d06f2c7e msgid "create smallest :ref:`Irect` containing rectangle" msgstr "最小の :ref:`Irect` を含む四角形を作成します。" #: ../../rect.rst:67 9c630cfbce96430dbd549ce3edbf5de2 msgid ":meth:`Rect.transform`" msgstr "" #: ../../rect.rst:67 3294ada857004ea2801a93dcdcae9cbb msgid "transform rectangle with a matrix" msgstr "行列で四角形を変形します。" #: ../../rect.rst:68 00f6aca11ba74d9290a39ae6e4d9abdb msgid ":attr:`Rect.bottom_left`" msgstr "" #: ../../rect.rst:68 d8d4c9d808554a389d40caa0c16d5a69 msgid "bottom left point, synonym *bl*" msgstr "左下の点、シノニム *bl*" #: ../../rect.rst:69 82732f58f72f413b869e3dbe3fc017dd msgid ":attr:`Rect.bottom_right`" msgstr "" #: ../../rect.rst:69 25213177c72349529fffc2b8650278c6 msgid "bottom right point, synonym *br*" msgstr "右下の点、シノニム *br*" #: ../../rect.rst:70 dee76b0bf2084300ae141c9fc27008bb msgid ":attr:`Rect.height`" msgstr "" #: ../../rect.rst:70 7fec492b654e4a6c8f203435ebdcb0e3 msgid "rectangle height" msgstr "四角形の高さ" #: ../../rect.rst:71 948cec288c54453aa28f00e584acce0b msgid ":attr:`Rect.irect`" msgstr "" #: ../../rect.rst:71 a1899a79673d49c5a4273f091b474322 msgid "equals result of method *round()*" msgstr "*round()* メソッドの結果と等しい" #: ../../rect.rst:72 d60c028c8e234efe9a338e184bb6bc55 msgid ":attr:`Rect.is_empty`" msgstr "" #: ../../rect.rst:72 95f758bc9cc644d6a61e703bee39b954 msgid "whether rectangle is empty" msgstr "四角形が空かどうか" #: ../../rect.rst:73 3d96f5aae5a54e4eac8a41dc8027ebe2 msgid ":attr:`Rect.is_valid`" msgstr "" #: ../../rect.rst:73 0d07626ab6d5457c93ed36d852fe9dc5 msgid "whether rectangle is valid" msgstr "四角形が有効かどうか" #: ../../rect.rst:74 ec6784767db149e1af2d3bed517a3154 msgid ":attr:`Rect.is_infinite`" msgstr "" #: ../../rect.rst:74 e2775e5155c94511a9a0b4351aa5aeed msgid "whether rectangle is infinite" msgstr "四角形が無限かどうか" #: ../../rect.rst:75 27198e6de32c47129ff1d90e9bcd052b msgid ":attr:`Rect.top_left`" msgstr "" #: ../../rect.rst:75 991fbeb519074c779da08190535db4a5 msgid "top left point, synonym *tl*" msgstr "左上の点、シノニム *tl*" #: ../../rect.rst:76 ee1026c3112e4ce5ace785e6dbd51983 msgid ":attr:`Rect.top_right`" msgstr "" #: ../../rect.rst:76 a429e926fb354c3eacca067673ad17f3 msgid "top_right point, synonym *tr*" msgstr "右上の点、シノニム *tr*" #: ../../rect.rst:77 5a5eef69cfdd4fc1b267e64d1899c83d msgid ":attr:`Rect.quad`" msgstr "" #: ../../rect.rst:77 39bf27b7ec18496996041d704db52fa2 msgid ":ref:`Quad` made from rectangle corners" msgstr "四角形の角から作成される :ref:`Quad`" #: ../../rect.rst:78 b77feb74e6d84afe86da1aa9ffd1d688 msgid ":attr:`Rect.width`" msgstr "" #: ../../rect.rst:78 ba35625a52bb44278539861d0133f079 msgid "rectangle width" msgstr "四角形の幅" #: ../../rect.rst:79 38859d042e6f49b88c35544ec6e4ed3c msgid ":attr:`Rect.x0`" msgstr "" #: ../../rect.rst:79 7e53ad8c6a824feca26905c64f3e0ea3 msgid "left corners' x coordinate" msgstr "左上のx座標" #: ../../rect.rst:80 f4f68e6053a840c2a566cf242d7f05b1 msgid ":attr:`Rect.x1`" msgstr "" #: ../../rect.rst:80 b53b5091498c454d88765a544d585de5 msgid "right corners' x -coordinate" msgstr "右上のx座標" #: ../../rect.rst:81 91c7514c010f464098de9b6e9007f4a8 msgid ":attr:`Rect.y0`" msgstr "" #: ../../rect.rst:81 119b6bb77d59497fa78ea76552d86acd msgid "top corners' y coordinate" msgstr "上部のy座標" #: ../../rect.rst:82 45436c8c00564776b422a0208c48ae3d msgid ":attr:`Rect.y1`" msgstr "" #: ../../rect.rst:82 251741ae294247ddadf61d053276d89f msgid "bottom corners' y coordinate" msgstr "下部のy座標" #: ../../rect.rst:85 d211a7b97cc54d93b48553a9425130b9 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../rect.rst:103 01827e33142142419f360c9f35834288 msgid "" "Overloaded constructors: *top_left*, *bottom_right* stand for " ":data:`point_like` objects, \"sequence\" is a Python sequence type of 4 " "numbers (see :ref:`SequenceTypes`), \"rect\" means another " ":data:`rect_like`, while the other parameters mean coordinates." msgstr "" "オーバーロードされたコンストラクター：*top_left*、*bottom_right* は :data:`point_like` " "オブジェクトを表し、「sequence」は4つの数値からなるPythonシーケンス型です（:ref:`SequenceTypes` " "を参照）、rectは別の :data:`rect_like` を意味し、他のパラメーターは座標を意味します。" #: ../../rect.rst:105 e075a06a3e264a5fbf6aea37d81f20d9 msgid "If \"rect\" is specified, the constructor creates a **new copy** of it." msgstr "\"rect\" が指定されている場合、コンストラクターはそれの **新しいコピー** を作成します。" #: ../../rect.rst:107 1f9d77ad703345a2a3964ae75caea048 #, fuzzy msgid "" "Without parameters, the empty rectangle ``Rect(0.0, 0.0, 0.0, 0.0)`` is " "created." msgstr "パラメーターなしで、空の長方形 *Rect(0.0, 0.0, 0.0, 0.0)* が作成されます。" #: ../../rect.rst:111 f10e380576a7412d80886a3b8a51700e #, fuzzy msgid "" "Creates the smallest containing :ref:`IRect`. This is **not the same** as" " simply rounding the rectangle's edges: The top left corner is rounded " "upwards and to the left while the bottom right corner is rounded " "downwards and to the right." msgstr "" "最小の :ref:`IRect` を作成します。これは単に長方形のエッジを四捨五入することとは " "**異なります**。左上のコーナーは上方向および左方向に丸められ、右下のコーナーは下方向および右方向に丸められます。" #: ../../rect.rst:116 552d25bc341a48aba138b957a55b9e83 msgid "If the rectangle is **empty**, the result is also empty." msgstr "もし矩形が空の場合、結果も **空** です。" #: ../../rect.rst:117 df26f93d58284c6a970ae3863ef681bb msgid "" "**Possible paradox:** The result may be empty, **even if** the rectangle " "is **not** empty! In such cases, the result obviously does **not** " "contain the rectangle. This is because MuPDF's algorithm allows for a " "small tolerance (1e-3). Example:" msgstr "" "**可能性のある逆説:** 矩形が空で **ない** 場合 **でも** 、結果が空になることがあります！このような場合、結果は明らかに矩形を " "**含みません**。これは、MuPDFのアルゴリズムがわずかな許容差（1e-3）を許容しているためです。例：" #: ../../rect.rst 223b51190466453684b2185f3dfc69c0 #: 297e474bcf4f49858a23f80dd7128c65 388342f8d94e4d26b238b48872bd5511 #: 4f188f0a74b347a8ba82283a386abbde 6c7f84d51c1c4b3b9dcf69c73a6d6715 #: 6f729bc4a8b948998da46a928feb54e6 96b897da73d141458d7b0fa47bb6846a #: f8ae67a6da5847d7838f6d57ffbba97e msgid "Return type" msgstr "" #: ../../rect.rst:127 31c287fef6e3445cafe94d866b5e73bf msgid ":ref:`IRect`" msgstr "" #: ../../rect.rst:131 c8c2cfc194a8468fa9550492f440f872 msgid "" "Transforms the rectangle with a matrix and **replaces the original**. If " "the rectangle is empty or infinite, this is a no-operation." msgstr "次の条件を満たす場合、行列を使用して長方形を変換し、**元の長方形を置き換えます** ：長方形が空であるか無限である場合、これは操作が行われません。" #: ../../rect.rst 1769e651f3b64df78e388f49683edfc2 #: 312414a60f5241d7abaee3b012e0c7f4 54d06860552f4fa4bf1e92782d2b517a #: aecbea35a63240b7bb02c03f083daacf d9b739a44f4b427b9772f8da4198b7b3 #: dca5e2461b874ed6ac599ed5bf67591e dd42b3800611490e9091e6942a813e85 #: e64ab107750d4908974794940a14b516 f9eb8fc37f314b86bb12b6037ad64aca msgid "Parameters" msgstr "" #: ../../rect.rst:133 17bbbee58ca246578928bb7c3f404ef5 msgid "The matrix for the transformation." msgstr "m（行列）–変換用の行列。" #: ../../rect.rst:136 5b54b6fd35e047b9b19b8e92d649c886 msgid "``Rect``" msgstr "" #: ../../rect.rst ad2d6666f58d4edab133c0b63812dad1 #: ee287750d1ff4757a1f4aab28350cc3f f617b587a6e84a1d879ad6eb2a4b8163 msgid "Returns" msgstr "" #: ../../rect.rst:137 9310c42c457243d2adf6a8ef7e65abb4 msgid "the smallest rectangle that contains the transformed original." msgstr "変換された元の長方形を含む最小の長方形。" #: ../../rect.rst:141 515fef48ca8a47adbebb14b402eb85f4 msgid "" "The intersection (common rectangular area, largest rectangle contained in" " both) of the current rectangle and *r* is calculated and **replaces the " "current** rectangle. If either rectangle is empty, the result is also " "empty. If *r* is infinite, this is a no-operation. If the rectangles are " "(mathematically) disjoint sets, then the result is invalid. If the result" " is valid but empty, then the rectangles touch each other in a corner or " "(part of) a side." msgstr "" "現在の長方形とrの共通の長方形エリア（両方に含まれる最大の長方形）を計算し、**現在の長方形を置き換えます**。どちらかの長方形が空の場合、結果も空になります。*r*" " " "が無限である場合、これは操作が行われません。長方形が（数学的に）交差していない場合、結果は無効になります。結果が有効でも空の場合、長方形は互いに角または一部の側面に接触しています。" #: ../../rect.rst:143 ../../rect.rst:150 5ae4d4eaacb44add974c0aa6cf33f6f8 #: cb94768c038d40d6be30db81f8988f9e msgid "Second rectangle" msgstr "第二の長方形" #: ../../rect.rst:148 db7d498e829c4302919da10e026d8ac5 msgid "" "The smallest rectangle containing the current one and ``r`` is calculated" " and **replaces the current** one. If either rectangle is infinite, the " "result is also infinite. If ``r`` is empty, the current rectangle remains" " unchanged. Else if the current rectangle is empty, it is replaced by " "``r``." msgstr "" #: ../../rect.rst:155 d539db24271d4c00bd98e51fb2c3f2ab msgid "" "The smallest rectangle containing the current one and :data:`point_like` " "``p`` is calculated and **replaces the current** one. **The infinite " "rectangle remains unchanged.** To create the rectangle that wraps a " "sequence of points, start with :meth:`EMPTY_RECT` and successively " "include the members of the sequence." msgstr "" #: ../../rect.rst:157 6a72290dd49345a0a63b3757d59663ca msgid "Point to include." msgstr "含めるポイント。" #: ../../rect.rst:163 ba33391fc40040a4a994136d913ee366 msgid "" "Calculate the area of the rectangle and, with no parameter, equals " "*abs(rect)*. Like an empty rectangle, the area of an infinite rectangle " "is also zero. So, at least one of *pymupdf.Rect(p1, p2)* and " "*pymupdf.Rect(p2, p1)* has a zero area." msgstr "" "長方形の面積を計算し、パラメーターなしで *abs（rect）* と同じです。空の長方形の面積はゼロであるため、少なくとも " "*pymupdf.Rect（p1、p2）* と *pymupdf.Rect（p2、p1）* のいずれかがゼロの面積を持っている必要があります。" #: ../../rect.rst:165 6f367ec895b04a5282f232e658390010 msgid "" "Specify required unit: respective squares of *px* (pixels, default), *in*" " (inches), *cm* (centimeters), or *mm* (millimeters)." msgstr "" "必要な単位を指定します： *px* （ピクセル、デフォルト）の平方、*in* （インチ）、*cm* （センチメートル）、または *mm* " "（ミリメートル）の平方。" #: ../../rect.rst:170 f1fdbdae13644bca9624eea1bed293ba msgid "" "Checks whether *x* is contained in the rectangle. It may be an *IRect*, " "*Rect*, *Point* or number. If *x* is an empty rectangle, this is always " "true. If the rectangle is empty this is always ``False`` for all non-" "empty rectangles and for all points. `x in rect` and `rect.contains(x)` " "are equivalent." msgstr "" "*x* が四角形内に含まれているかどうかをチェックします。xは *IRect*、*Rect*、*Point*、または数値のいずれかです。もし " "*x* " "が空の四角形である場合、これは常にtrueです。四角形が空である場合、これはすべての空でない四角形とすべてのポイントに対して常にfalseです。`x" " in rect` および `rect.contains(x)` は同等です。" #: ../../rect.rst:172 ca3270a90eac40a4bbb2ec88e8547446 msgid "the object to check." msgstr "チェックするオブジェクト。" #: ../../rect.rst:179 a2c14b05b36d4decbe4367b3aa764e2f msgid "" "Checks whether the rectangle and a :data:`rect_like` \"r\" contain a " "common non-empty :ref:`Rect`. This will always be ``False`` if either is " "infinite or empty." msgstr "" "長方形と :data:`rect_like` \"r\" " "が共通の非空のRectを含むかどうかをチェックします。どちらかが無限または空の場合、これは常に ``False`` になります。" #: ../../rect.rst:181 fd7c3c60afa7402f98f4d782416f106d msgid "the rectangle to check." msgstr "チェックする長方形。" #: ../../rect.rst:187 a9fe2a547ab44768a39b47d8d9ef868e msgid "New in version 1.19.3" msgstr "新機能（バージョン1.19.3）" #: ../../rect.rst:189 d15a89c433be470288ee2017503a040f msgid "Compute the matrix which transforms this rectangle to a given one." msgstr "この長方形を指定した長方形に変換する行列を計算します。" #: ../../rect.rst:191 7492eabbe7d24bdba52f9f8ead663bcd msgid "the target rectangle. Must not be empty or infinite." msgstr "ターゲットの長方形。空または無限であってはいけません。" #: ../../rect.rst:192 1d5dde507c8b434e94689248050663f0 msgid ":ref:`Matrix`" msgstr "" #: ../../rect.rst:193 fc8cb54b6f794b9ca05b2b2fb57c5290 msgid "" "a matrix `mat` such that `self * mat = rect`. Can for example be used to " "transform between the page and the pixmap coordinates. See an example use" " here :ref:`RecipesImages_P`." msgstr "" "`self * mat = rect` となるような行列 `mat` です。たとえば、ページとピクスマップの座標間を変換するのに使用できます。 " "使用例はこちらを参照してください :ref:`RecipesImages_P` " #: ../../rect.rst:197 6bfb5ec48e4742898de3cb22ba429c99 msgid "New in version 1.17.0" msgstr "新機能バージョン1.17.0" #: ../../rect.rst:199 33c676862f1241db9159e7a0b76a9f67 msgid "" "Return a new quad after applying a matrix to the rectangle using the " "fixed point `fixpoint`." msgstr "固定点 `fixpoint` を使用して、行列を長方形に適用した後の新しい四角形を返します。" #: ../../rect.rst:201 c4251e2f175d41d48a4e66ee81b8a2a0 msgid "the fixed point." msgstr "固定ポイント。" #: ../../rect.rst:202 3597e1c1f5d84296b016ca74793b5554 msgid "the matrix." msgstr "行列。" #: ../../rect.rst:203 e7dca746738f46ff95c1c3f83513868b msgid "" "a new :ref:`Quad`. This a wrapper for the same-named quad method. If " "infinite, the infinite quad is returned." msgstr "新しい :ref:`Quad` 。これは同じ名前の四角形メソッドのラッパーです。無限の場合、無限の四角形が返されます。" #: ../../rect.rst:207 f0e8c79473044506bfc164d658cd0559 msgid "New in version 1.16.0" msgstr "新機能バージョン1.16.0" #: ../../rect.rst:209 5675696559db481c8264784ff3dc7467 msgid "" "Return the Euclidean norm of the rectangle treated as a vector of four " "numbers." msgstr "四角形を4つの数値のベクトルとして扱った場合のユークリッドノルムを返します。" #: ../../rect.rst:213 d5b4c7b243b04370ad7717618f6af173 msgid "" "**Replace** the rectangle with its valid version. This is done by " "shuffling the rectangle corners. After completion of this method, the " "bottom right corner will indeed be south-eastern to the top left one (but" " may still be empty)." msgstr "" "長方形をその有効なバージョンで " "**置き換えます**。これは長方形のコーナーをシャッフルして行います。このメソッドの完了後、右下のコーナーは確かに左上のコーナーの南東になります（ただし、空である可能性があります）。" #: ../../rect.rst:217 55f5202f243c431cb4a6aae82d228176 msgid "Equals result of method *round()*." msgstr "*round()* メソッドの結果と同じです。" #: ../../rect.rst:223 8ce16ab6c7df44f5abb8f92883c8d5c5 msgid "Equals *Point(x0, y0)*." msgstr "*Point(x0, y0)* と等しい。" #: ../../rect.rst 140ba1c8d224453686c608739d150b66 #: 17b10802a6f2405c86d6e263e499d22f 5444bac90c254f1c84d6fe7c0e28890d #: 5bacf55f6fdc41e0a4eaecf91679d95d 5e0076fec68344b9b5094a29a7778e51 #: 6362dacd20114c8e8d8beda49463e502 7bdb41b9074b4fe8b70f89b3feb982f8 #: 8b32b0a8f85c488f8622250501ee942a 9ebaad019109481ebcf4ddd743d67f01 #: d8d182de61d74096abf1ed76f13825b2 dd68eb47fe4f425fb08826a909877002 #: f6c692b144934eb0ba0bbce5f99825bf msgid "type" msgstr "" #: ../../rect.rst:225 ../../rect.rst:233 ../../rect.rst:241 ../../rect.rst:249 #: 3bb0a2aad0b34e11b52697850a333f20 403eb084f6f64eb590a9e0627f324bc1 #: 8690457d8ba940b09ec2249670a3ef5b 93767b206e804fd582e4db28c1eb3219 msgid ":ref:`Point`" msgstr "" #: ../../rect.rst:231 62f995500f554a04a83c5d7392c75231 msgid "Equals `Point(x1, y0)`." msgstr "`Point(x1, y0)` と等しい。" #: ../../rect.rst:239 4b524e88114c4a3d9795ac77e101aac6 msgid "Equals `Point(x0, y1)`." msgstr "`Point(x0, y1)` と等しい。" #: ../../rect.rst:247 c781f4a98d33484a8fd5eeb72de6719e msgid "Equals `Point(x1, y1)`." msgstr "" #: ../../rect.rst:253 4fdbb1259b894b85abf811e41bf30f7f msgid "The quadrilateral `Quad(rect.tl, rect.tr, rect.bl, rect.br)`." msgstr "四角形 `Quad(rect.tl, rect.tr, rect.bl, rect.br)`。" #: ../../rect.rst:255 a29713ba4e8a43c290093038d033627b msgid ":ref:`Quad`" msgstr "" #: ../../rect.rst:259 a19815eed800437580d69960abffb442 msgid "Width of the rectangle. Equals `max(x1 - x0, 0)`." msgstr "長方形の幅。`max(x1 - x0, 0)` と等しい。" #: ../../rect.rst:265 19c9fc7532244739bb242fc281fe9ab4 msgid "Height of the rectangle. Equals `max(y1 - y0, 0)`." msgstr "長方形の高さ。`max(y1 - y0, 0)` と等しい。" #: ../../rect.rst:271 e9d9d68a615844588179b0a9c4ddb63d msgid "X-coordinate of the left corners." msgstr "左上の x 座標。" #: ../../rect.rst:273 ../../rect.rst:279 ../../rect.rst:285 ../../rect.rst:291 #: 3159fff4ace944f5b28b66c85c40a391 595d30cddc2441798812da3e6aa60405 #: 7d4d519c37524ecd93c59a92f14a52ee c3f30ece20574d289dd0729b1555cb67 msgid "float" msgstr "" #: ../../rect.rst:277 ef85ef105e694e3faab5ca56c0e0eecb msgid "Y-coordinate of the top corners." msgstr "左上の y 座標。" #: ../../rect.rst:283 01de9b8a52134ea9893026eb6219e2ed msgid "X-coordinate of the right corners." msgstr "右下の x 座標。" #: ../../rect.rst:289 0324e83243014e8facb3691297c10edd msgid "Y-coordinate of the bottom corners." msgstr "右下の y 座標。" #: ../../rect.rst:295 63c3980c456449ab98ca919497d7ee18 msgid "`True` if this is the infinite rectangle." msgstr "これが無限の長方形の場合は `True`。" #: ../../rect.rst:297 ../../rect.rst:303 ../../rect.rst:309 #: 84e580180c7c4388939f1b2876f6eb67 9aaf58f7198848dc9acfe4b42c84ad6f #: b9b7f26129e94195801107367cb7fbcc msgid "bool" msgstr "" #: ../../rect.rst:301 18ecd70d16ed40779b23464233b589ed msgid "`True` if rectangle is empty." msgstr "これが無限の長方形である場合は `True`。" #: ../../rect.rst:307 472d89b6e5324c3487cd59bb9818711c msgid "`True` if rectangle is valid." msgstr "長方形が空である場合は `True`。" #: ../../rect.rst:313 9531f9684b3d4fe5add3912c57ef0e6a msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "" "このクラスはPythonのシーケンスプロトコルに従っており、要素にはインデックスを使用できます。Using Python Sequences as" " Arguments in PyMuPDFも参照してください" #: ../../rect.rst:314 a8f439886c4540a88cfb3aa32cee5363 msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "四角形は算術演算子と組み合わせて使用できます - :ref:`Algebra` の演算子代数の章を参照してください。" #: ../../footer.rst:46 7bc9c45a377e4124a0eb39872343423a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "The smallest rectangle containing the " #~ "current one and *r* is calculated " #~ "and **replaces the current** one. If " #~ "either rectangle is infinite, the result" #~ " is also infinite. If one is " #~ "empty, the other one will be taken" #~ " as the result." #~ msgstr "" #~ "現在の長方形と *r* " #~ "を含む最小の長方形を計算し、**現在の長方形を置き換えます**。どちらかの長方形が無限の場合、結果も無限になります。1つが空である場合、もう1つが結果として取られます。" #~ msgid "" #~ "The smallest rectangle containing the " #~ "current one and point *p* is " #~ "calculated and **replaces the current** " #~ "one. **The infinite rectangle remains " #~ "unchanged.** To create a rectangle " #~ "containing a series of points, start " #~ "with (the empty) *pymupdf.Rect(p1, p1)* " #~ "and successively include the remaining " #~ "points." #~ msgstr "" #~ "現在の長方形と点 *p* " #~ "を含む最小の長方形を計算し、**現在の長方形を置き換えます**。無限の長方形は変更されません。一連の点を含む長方形を作成するには、（空の）" #~ " *pymupdf.Rect(p1, p1)* から始め、残りの点を順次含めてください。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "*Rect*" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/resources.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.2\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 32a5d41df1df459eb1e9d04ab26ae6e9 msgid "Artifex" msgstr "" #: ../../header.rst:-1 f853d94bef1043f19d324049bb6fc247 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDFは、PDF（およびその他）ドキュメントのデータ抽出、分析、変換、および操作のための高性能なPythonライブラリです。" #: ../../header.rst:-1 ee9fba5239104891a698642d810eda59 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFのテキスト抽出、PDFの画像抽出、PDFの変換、PDFのテーブル、PDFの分割、PDFの作成、Pyodide、PyScript" #: ../../resources.rst:6 50c78b642e87465bab2c3916355a95a0 msgid "Resources" msgstr "リソース" #: ../../resources.rst:9 4ff3e7104cb64db5af2a616677e85c6e msgid "**PyMuPDF Pro**" msgstr "" #: ../../resources.rst:12 08c45bb03e394054bea50f41ce8a06d0 msgid "For **Office** file support `try PyMuPDF Pro `." msgstr "**Office** ファイルのサポートには、`PyMuPDF Pro ` をお試しください。" #: ../../resources.rst:20 5af5e4a006674fbf9c2bb32995565bc2 msgid "Find out about **PyMuPDF Utilities**" msgstr "**PyMuPDFユーティリティ** について調べる" #: ../../resources.rst:22 9107d5d9ff12463c8aaa340fe660b894 msgid "" "The :title:`GitHub` repository `PyMuPDF-Utilities " "`_ contains a full range of" " examples, demonstrations and use cases." msgstr "" ":title:`GitHub` リポジトリ `PyMuPDF-Utilities `_ には、豊富な例、デモ、およびユースケースが含まれています。" #: ../../resources.rst:31 661997d9b5904871afc832b5d106ec7e msgid "Do you need |PDF| to **DOCX** conversion?" msgstr "|PDF| を **DOCX** に変換する必要がありますか？" #: ../../resources.rst:33 4d1c4a0b38be4825a6719886af0641bf msgid "" "We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-" "docx** library to provide simple document conversion from |PDF| to " "**DOCX** format." msgstr "" "pdf2docx_ ライブラリをお勧めします。これは、|PDF| から **DOCX** 形式への簡単なドキュメント変換を提供するために " "|PyMuPDF| と **python-docx** ライブラリを使用しています。" #: ../../footer.rst:60 bd4e8b3283ae4bb3b28a33df47889855 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは、|version| までのすべてのバージョンをカバーしています" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/shape.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7909b1fec71a4bb1918715ca5918f604 msgid "Artifex" msgstr "" #: ../../header.rst:-1 87466d36d4244b14b06775988b5a86da msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 c4e019a1ef45475794222706f39fa6bd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../shape.rst:6 a9435293f59542b2850588abf5b6a5c0 msgid "Shape" msgstr "Shape（シェイプ）" #: ../../shape.rst:8 c22618002fb44404a4ac660d7663c2a9 msgid "|pdf_only_class|" msgstr "" #: ../../shape.rst:10 83f7ae44343b4e29b36be26c67c582a7 msgid "" "This class allows creating interconnected graphical elements on a PDF " "page. Its methods have the same meaning and name as the corresponding " ":ref:`Page` methods." msgstr "" "このクラスは、PDFページ上で相互に接続されたグラフィカル要素を作成できるようにします。このクラスのメソッドは、対応する :ref:`Page` " "クラスのメソッドと同じ意味と名前を持っています。" #: ../../shape.rst:12 1687c125d94c4a889d4123d18b33a654 msgid "" "In fact, each :ref:`Page` draw method is just a convenience wrapper for " "(1) one shape draw method, (2) the :meth:`Shape.finish` method, and (3) " "the :meth:`Shape.commit` method. For page text insertion, only the " ":meth:`Shape.commit` method is invoked. If many draw and text operations " "are executed for a page, you should always consider using a Shape object." msgstr "" "実際には、各 :ref:`Page` クラスの描画メソッドは、（1）シェイプの描画メソッド、（2） :meth:`Shape.finish` " "メソッド、（3） :meth:`Shape.commit` " "メソッドの3つの要素の便利なラッパーです。ページテキストの挿入に関しては、:meth:`Shape.commit` " "メソッドのみが呼び出されます。ページで多くの描画およびテキスト操作を実行する場合、常にShapeオブジェクトの使用を検討することをお勧めします。" #: ../../shape.rst:14 61eb314053054e4e9a36e36845c74ae6 msgid "" "Several draw methods can be executed in a row and each one of them will " "contribute to one drawing. Once the drawing is complete, the " ":meth:`Shape.finish` method must be invoked to apply color, dashing, " "width, morphing and other attributes." msgstr "" "このクラスのいくつかの描画メソッドは、連続して実行でき、それぞれが1つの描画に貢献します。描画が完了したら、:meth:`Shape.finish`" " メソッドを呼び出して色、破線、幅、変形などの属性を適用する必要があります。" #: ../../shape.rst:16 f3481ff5d87c41998cb0f7de7874cbee msgid "" "**Draw** methods of this class (and :meth:`Shape.insert_textbox`) are " "logging the area they are covering in a rectangle (:attr:`Shape.rect`). " "This property can for instance be used to set " ":attr:`Page.cropbox_position`." msgstr "" "このクラスの **描画** メソッド（および :meth:`Shape.insert_textbox` ）は、カバーしている領域を矩形 " "(:attr:`Shape.rect`)で記録します。このプロパティは、:attr:`Page.cropbox_position` " "を設定するために使用できます。" #: ../../shape.rst:18 93fc8032a8144e439538867e5d7d9ff1 msgid "" "**Text insertions** :meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox` implicitly execute a \"finish\" and " "therefore only require :meth:`Shape.commit` to become effective. As a " "consequence, both include parameters for controlling properties like " "colors, etc." msgstr "" "**テキストの挿入** 操作である :meth:`Shape.insert_text` および " ":meth:`Shape.insert_textbox` は、暗黙的に「finish」を実行し、効果を発揮するために " ":meth:`Shape.commit` " "のみが必要です。その結果、両方のメソッドには色などのプロパティを制御するためのパラメータが含まれています。" #: ../../shape.rst:21 7753ef6a86874229bc626bf090e7fd68 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../shape.rst:21 21306cc0a07a4be8b729f6d593a2a25e msgid "**Description**" msgstr "**説明**" #: ../../shape.rst:23 76875c2923b44844919d4f7dbc4ff2ae msgid ":meth:`Shape.commit`" msgstr "" #: ../../shape.rst:23 b6e101dde14a4c0399c2d1e32dfae0e3 msgid "update the page's contents" msgstr "ページの内容を更新します" #: ../../shape.rst:24 68e32b027b2a42519c263a5d79f0aca5 msgid ":meth:`Shape.draw_bezier`" msgstr "" #: ../../shape.rst:24 cfd73fa2818546d897d3cc7dbf43cb7f msgid "draw a cubic Bezier curve" msgstr "キュービックベジエ曲線を描画します" #: ../../shape.rst:25 4f7b9a227586442b8c80cfc50bb5d2f6 msgid ":meth:`Shape.draw_circle`" msgstr "" #: ../../shape.rst:25 9f885ddec57646dc9618b9b296ef806e msgid "draw a circle around a point" msgstr "指定した点を中心に円を描画します" #: ../../shape.rst:26 aa0ac0a299bb4cacbdb189b821d1057f msgid ":meth:`Shape.draw_curve`" msgstr "" #: ../../shape.rst:26 444333668308404a995780c7c2ffd1e8 msgid "draw a cubic Bezier using one helper point" msgstr "ヘルパーポイントを使用してキュービックベジエ曲線を描画します" #: ../../shape.rst:27 1b7d6cc35258460398a82cc2ea5f5017 msgid ":meth:`Shape.draw_line`" msgstr "" #: ../../shape.rst:27 0a76a1b23d26472bb46eaef1b0b11d37 msgid "draw a line" msgstr "直線を描画します" #: ../../shape.rst:28 eea95a7b69df4cc6a775a0d4015d87f5 msgid ":meth:`Shape.draw_oval`" msgstr "" #: ../../shape.rst:28 34529e37e99440538218de68e175f373 msgid "draw an ellipse" msgstr "楕円を描画します" #: ../../shape.rst:29 8817f8a373594a85a5b96f2658e31d98 msgid ":meth:`Shape.draw_polyline`" msgstr "" #: ../../shape.rst:29 3b98bc2fd12c456c8a2410d43daa8912 msgid "connect a sequence of points" msgstr "一連の点を接続します" #: ../../shape.rst:30 4022cf63cc3a496696d3f62c0a2805ab msgid ":meth:`Shape.draw_quad`" msgstr "" #: ../../shape.rst:30 bde0f7baa3e145cda4e9d029099dda80 msgid "draw a quadrilateral" msgstr "四角形を描画します" #: ../../shape.rst:31 c4addcda29c140a6b1975890737ead18 msgid ":meth:`Shape.draw_rect`" msgstr "" #: ../../shape.rst:31 2b173978a5c64357ac1aabcc6e976c73 msgid "draw a rectangle" msgstr "長方形を描画します" #: ../../shape.rst:32 7f7f34efc2e944109b6c07df81c75430 msgid ":meth:`Shape.draw_sector`" msgstr "" #: ../../shape.rst:32 d5d4937a74fb42b7b20852638b500044 msgid "draw a circular sector or piece of pie" msgstr "円形セクターまたはパイの一部を描画します" #: ../../shape.rst:33 880b0c8a153e48fdaa1029e9be76e520 msgid ":meth:`Shape.draw_squiggle`" msgstr "" #: ../../shape.rst:33 da68180d030a4b1fb309de94d47743b1 msgid "draw a squiggly line" msgstr "波線を描画します" #: ../../shape.rst:34 9fe45650af3d4e0ca97f2b9d25d87789 msgid ":meth:`Shape.draw_zigzag`" msgstr "" #: ../../shape.rst:34 63c2fdb3045d4b81ae22677572e74fbe msgid "draw a zigzag line" msgstr "ジグザグ線を描画します" #: ../../shape.rst:35 c22ba5f6783649118106601684861498 msgid ":meth:`Shape.finish`" msgstr "" #: ../../shape.rst:35 7c247cc071c04f4383953864f5d543ee msgid "finish a set of draw commands" msgstr "描画コマンドのセットを完了します" #: ../../shape.rst:36 0ba068100e264e0b9e9ec1f368662d1d msgid ":meth:`Shape.insert_text`" msgstr "" #: ../../shape.rst:36 5dd5770c7a054a66ab3b70a9d530c6f3 msgid "insert text lines" msgstr "テキスト行を挿入します" #: ../../shape.rst:37 fa4216d497f9485cb9c79fc192a851bf msgid ":meth:`Shape.insert_textbox`" msgstr "" #: ../../shape.rst:37 47ec8b14ef6c4a6d97b355006a0b0b62 msgid "fit text into a rectangle" msgstr "テキストを長方形に合わせて挿入します" #: ../../shape.rst:38 f1252e5521e147f5bb1c776091ef3328 msgid ":attr:`Shape.doc`" msgstr "" #: ../../shape.rst:38 7f05739c6d0d459aa0631c532353654e msgid "stores the page's document" msgstr "ページのドキュメントを格納します" #: ../../shape.rst:39 61f46d3f420545e684f380815c9730f3 msgid ":attr:`Shape.draw_cont`" msgstr "" #: ../../shape.rst:39 8a19e4b60bd145ceaa799130f96ab50f msgid "draw commands since last :meth:`Shape.finish`" msgstr ":meth:`Shape.finish` 以降の描画コマンドを格納します" #: ../../shape.rst:40 dbc1fe5e22804f4291fdc27abafe492f msgid ":attr:`Shape.height`" msgstr "" #: ../../shape.rst:40 a1b344bfa62b474dbecc168b7566abfd msgid "stores the page's height" msgstr "ページの高さを格納します" #: ../../shape.rst:41 98c50cf9d34b4f1fac07407191336a46 msgid ":attr:`Shape.lastPoint`" msgstr "" #: ../../shape.rst:41 d744e08ab64c4be89b54b91da06292ad msgid "stores the current point" msgstr "現在のポイントを格納します" #: ../../shape.rst:42 3c7b42195cfb495cba0b78bee8af7989 msgid ":attr:`Shape.page`" msgstr "" #: ../../shape.rst:42 94b8094277504a3e865c3fc7a2fbadcf msgid "stores the owning page" msgstr "所有するページを格納します" #: ../../shape.rst:43 74e41af07b7e49dfb9e8897106da6072 msgid ":attr:`Shape.rect`" msgstr "" #: ../../shape.rst:43 2fd72b972ba64904b71bf6a28bf4aa69 msgid "rectangle surrounding drawings" msgstr "描画を囲む長方形を格納します" #: ../../shape.rst:44 d662c10c7b284e1a9e8fb0cfacc0af7e msgid ":attr:`Shape.text_cont`" msgstr "" #: ../../shape.rst:44 260872b329274794a91fbe27de9d0fd7 msgid "accumulated text insertions" msgstr "累積テキスト挿入を格納します" #: ../../shape.rst:45 260f168374084a0389735532a415f968 msgid ":attr:`Shape.totalcont`" msgstr "" #: ../../shape.rst:45 cca60781247448a6bef1b019d5b03005 msgid "accumulated string to be stored in :data:`contents`" msgstr ":data:`contents` に格納する累積文字列を格納します" #: ../../shape.rst:46 bf5489e997644d1b86ef1a304a20a630 msgid ":attr:`Shape.width`" msgstr "" #: ../../shape.rst:46 320f315bc7e34fb9a224c8104c0490ba msgid "stores the page's width" msgstr "ページの幅を格納します" #: ../../shape.rst:49 bb77ff1beb1643f1a32fbeb881764556 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../shape.rst:55 f849eb8fe4ea4d84ae176a3bfaddbc5d msgid "" "Create a new drawing. During importing PyMuPDF, the *pymupdf.Page* object" " is being given the convenience method *new_shape()* to construct a " "*Shape* object. During instantiation, a check will be made whether we do " "have a PDF page. An exception is otherwise raised." msgstr "" "新しい描画を作成します。PyMuPDFをインポートする際、*pymupdf.Page* オブジェクトには *Shape* " "オブジェクトを構築するための便利なメソッド *new_shape()* " "が提供されます。インスタンス化中に、PDFページが存在するかどうかのチェックが行われます。それ以外の場合は例外が発生します。" #: ../../shape.rst 1c33018ebf664e5c82016942d1b106b9 #: 1ffb902ffb054dea81b4421598d73d3b 2c7222c93878455593e199cee35f9bc0 #: 526e0601602e4ad294c77828899ee151 652ecb786383456887f3e684eb50a16f #: 8351d111f6ba44c5a48d07b45ecd69ec 8512993c092848e68b405672b0329a5f #: 97750b106384485e9da4b3a178fc8b8a bdcf123cefb04a72ac000f1e6d213cab #: d33f1cb5159441b288aacd2ccae007dd d522a8dc82fa46aaa1bf98571addfab6 #: ec2e6f2b47e543f780ac5d88287a15e3 f4f238ef2bbb4c60a0db78dc6ba48ae3 #: fc6fd8d86630442eac29f0ee69909dd3 msgid "Parameters" msgstr "パラメータ" #: ../../shape.rst:57 7af1e6f9a6c54700a96a634680458cf7 msgid "an existing page of a PDF document." msgstr "PDFドキュメントの既存のページ。" #: ../../shape.rst:62 76f377d8f0084511ba9e8ab03be15272 msgid "Draw a line from :data:`point_like` objects *p1* to *p2*." msgstr ":data:`point_like` オブジェクト *p1* から *p2* への直線を描画します。" #: ../../shape.rst:64 ../../shape.rst:78 ../../shape.rst:114 #: 0bd9ca4fa2034c02bba75a1ed84436e8 67a3775d53744800bce979bd9509dae4 #: 6fdeeec1ae7344738df476d7c0995efd msgid "starting point" msgstr "開始点" #: ../../shape.rst:66 ../../shape.rst:80 ../../shape.rst:116 #: 233bc3b5db494f95bd617855177b0ba3 b9a33dfd5ad0434bb5d1681c4ef5477f #: d7a11d5e2d0843bf98b67ccb4c5a1b5c msgid "end point" msgstr "終了点" #: ../../shape.rst 00c99cce86684724a7484f034aead4b9 #: 11b2ce9eb7ac446288dfe432b6af2d66 37b1db5fc557483698f96296fca977a1 #: 398f16080c7c485daf19f594085b75e3 4fb89ac12ab341e98fd2fbfde502762f #: 79c3be157132461c91fbd43f577c6960 7f449ff12a28486c9377d3eae5881abe #: 86a6ff3345b34b99a0b2846ce9b63f97 87752e32bcb84c439a39262387ed43ad #: 8ce97810f50346f1963cb9045d0e3bc9 9a9e08e465d642609b4034f0ac585738 #: e06a173ede194c2499189e3f4ea96d22 f8c5c0c193bf4857a6d61a7fe76a58a0 msgid "Return type" msgstr "戻り値の型" #: ../../shape.rst:68 ../../shape.rst:84 ../../shape.rst:120 #: ../../shape.rst:129 ../../shape.rst:138 ../../shape.rst:157 #: ../../shape.rst:173 ../../shape.rst:185 ../../shape.rst:207 #: ../../shape.rst:224 ../../shape.rst:233 ../../shape.rst:448 #: 02178d1d64304122974cdd7d2eda4e9a 04e3fd71585f46408e34e1b5d2918e9d #: 1b90b951d85a446a9b18d2751aa79908 258641b6956c4c2ebb65129fbc72ae92 #: 2c6a3892b51541d9b2bc4f6aa0613353 318dc522d9764a2e9e4ad48a39be4ebb #: 60c74e5979e14e0e8d70ebeb78df14b9 6b818606a66c4dc494a2fe410d34be22 #: 6f503a8ab6474890be0934600cf2de3b 881f284fe0a54cc180a7ff765822eb7e #: 8b84d3286ddb4519bb3afc99075e83fb f570f468b63940e4b0b9f5890f13db63 msgid ":ref:`Point`" msgstr "" #: ../../shape.rst 19bca25aa417451a9d8eb8425f4d7fe5 #: 2d7984c3e8b24f9cacf4f90e2f10a7e0 42bcff3c5d7c4b3ea0f0cff8b94a1936 #: 5725a8009d724bfda07948d7fdd6a975 5ab553dbd9a245ef85863361d3458c06 #: 5baa94cd077f42439269059c4560779d a0d4f65446c742a5b9f88f747fecf574 #: a8b9ec9227c447c7b5b7e475f0ad137b b93d921a09e2475eb2dfecc00159859c #: c9221ebfa6724c35be3fe1b3043dcc84 edda77c9978d4bdc8e49a11220f628de #: fda0a5dbf3e44f70993141cd223cda9f ffd43af87088494c8ab238422d4affeb msgid "Returns" msgstr "戻り値" #: ../../shape.rst:69 ../../shape.rst:85 ../../shape.rst:121 #: 03c2703f4c2c4c488c6e1dd5a8bde13f 54fc79ebcc5547368af108398f088aa1 #: d5a893ea1f9f4e6cb959502504cda257 msgid "the end point, *p2*." msgstr "終了点 *p2*。" #: ../../shape.rst:76 eed928e2a53b4d0db6454fc9a3031e88 msgid "" "Draw a squiggly (wavy, undulated) line from :data:`point_like` objects " "*p1* to *p2*. An integer number of full wave periods will always be " "drawn, one period having a length of *4 * breadth*. The breadth parameter" " will be adjusted as necessary to meet this condition. The drawn line " "will always turn \"left\" when leaving *p1* and always join *p2* from the" " \"right\"." msgstr "" ":data:`point_like` オブジェクト *p1* から *p2* " "への波線（うねり、曲線）を描画します。常に整数回の完全な波の周期が描画され、1つの周期の長さは4 * " "breadthです。必要に応じて幅パラメータが調整され、この条件を満たします。描かれる線は常に *p1* を離れる際に「左」に曲がり、*p2* " "には常に「右」から接続します。" #: ../../shape.rst:82 cbee403daaee4a56b9b2f131ff95afb9 msgid "" "the amplitude of each wave. The condition *2 * breadth < abs(p2 - p1)* " "must be true to fit in at least one wave. See the following picture, " "which shows two points connected by one full period." msgstr "" "各波の振幅。条件 *2 * breadth < abs(p2 - p1)* " "が少なくとも1つの波に収まる必要があります。次の図は、1つの完全な周期で接続された2つの点を示しています。" #: ../../shape.rst:89 c61f3a8ac2e84d7e88c065f6a80328ac msgid "" "Here is an example of three connected lines, forming a closed, filled " "triangle. Little arrows indicate the stroking direction." msgstr "以下は、閉じた塗りつぶされた三角形を形成する三つの連結した線の例です。小さな矢印はストロークの方向を示しています。" #: ../../shape.rst:105 3b09c6c0299043ad9e407b82096dc07f msgid "" "Waves drawn are **not** trigonometric (sine / cosine). If you need that, " "have a look at `draw.py `_." msgstr "" "描かれる波は三角関数（正弦/余弦）**ではありません**。それが必要な場合は `draw.py " "`_ を参照してください。" #: ../../shape.rst:112 e6d38796d27441ac9eb554ae3567f070 msgid "" "Draw a zigzag line from :data:`point_like` objects *p1* to *p2*. " "Otherwise works exactly like :meth:`Shape.draw_squiggle`." msgstr "" ":data:`point_like` オブジェクト *p1* から *p2* へジグザグのラインを描画します。それ以外は " ":meth:`Shape.draw_squiggle` とまったく同じです。" #: ../../shape.rst:118 2686f76e3e56495ca08bdd2711d1c28e msgid "" "the amplitude of the movement. The condition *2 * breadth < abs(p2 - p1)*" " must be true to fit in at least one period." msgstr "動きの振幅。1つの周期に収まるように振幅を調整します。条件は *2 * breadth < abs(p2 - p1)* である必要があります。" #: ../../shape.rst:125 bfb5a00ac07547bf822e4b2d95c0f3d7 msgid "" "Draw several connected lines between points contained in the sequence " "*points*. This can be used for creating arbitrary polygons by setting the" " last item equal to the first one." msgstr "" "シーケンス *points* " "に含まれるポイント間にいくつかの接続されたラインを描画します。これを使用して、最後のアイテムを最初のアイテムと等しく設定することで、任意の多角形を作成できます。" #: ../../shape.rst:127 9afa3278382745228b82849acc3d1db1 msgid "" "a sequence of :data:`point_like` objects. Its length must at least be 2 " "(in which case it is equivalent to *draw_line()*)." msgstr "" ":data:`point_like` オブジェクトのシーケンス。その長さは少なくとも2である必要があります（この場合、*draw_line()* " "と同等です）。" #: ../../shape.rst:130 b0f8276e3be04c6996c165c83ed3fdbd msgid "*points[-1]* -- the last point in the argument sequence." msgstr "引数シーケンスの最後のポイント、*points[-1]*。" #: ../../shape.rst:134 bf9fc4f7ee704353953bbb497b85a344 msgid "" "Draw a standard cubic Bézier curve from *p1* to *p4*, using *p2* and *p3*" " as control points." msgstr "*p1* から *p4* への標準的な立方ベジエ曲線を *p2*と *p3* を制御ポイントとして描画します。" #: ../../shape.rst:136 65ae6d8fa1ca4696b5ceec6e6a33a484 #, fuzzy msgid "All arguments are :data:`point_like` objects." msgstr "すべての引数は :data:`point_like` です。" #: ../../shape.rst:139 c3bc7d17a1564a259bbccff931fbceb4 msgid "the end point, *p4*." msgstr "終了点 *p4*。" #: ../../shape.rst:141 540f633870214c57b214a2d3dc6fad47 msgid "" "The points do not need to be different -- experiment a bit with some of " "them being equal!" msgstr "ポイントは異なる必要はありません。一部のポイントが等しい場合も試してみてください！" #: ../../shape.rst:143 cc32f6b9b719471e990541995cb91d8a msgid "Example:" msgstr "例：" #: ../../shape.rst:149 3cd13feab216456fb40eabb0f87476f2 msgid "" "Draw an \"ellipse\" inside the given tetragon (quadrilateral). If it is a" " square, a regular circle is drawn, a general rectangle will result in an" " ellipse. If a quadrilateral is used instead, a plethora of shapes can be" " the result." msgstr "指定された四角形（四辺形）内に「楕円」を描画します。正方形の場合、正円が描かれ、一般的な長方形は楕円になります。四角形が使用される場合、さまざまな形状が結果として得られる可能性があります。" #: ../../shape.rst:151 3beef81862054f6c9dcfb27abe73062b msgid "" "The drawing starts and ends at the middle point of the line `bottom-left " "-> top-left` corners in an anti-clockwise movement." msgstr "描画は、反時計回りの動きで、左下隅 -> 左上隅の中間点で開始し、終了します。" #: ../../shape.rst:153 dbc5cddf46e74369a4ec90c4aba4a510 msgid "" ":data:`rect_like` or :data:`quad_like`. *Changed in version 1.14.5:* " "Quads are now also supported." msgstr "" #: ../../shape.rst:153 0704abfebefe4fe78ed8116b1a8491c3 msgid ":data:`rect_like` or :data:`quad_like`." msgstr ":data:`rect_like` または :data:`quad_like`。" #: ../../shape.rst:155 b5056fbc16ad42e4b786c5a89beddb09 msgid "*Changed in version 1.14.5:* Quads are now also supported." msgstr "*バージョン1.14.5で変更：* 四角形もサポートされるようになりました。" #: ../../shape.rst:158 913c4e5f92e8407f8da84ba1fbe6cb29 msgid "" "the middle point of line `rect.bl -> rect.tl`, or resp. `quad.ll -> " "quad.ul`. Look at just a few examples here, or at the *quad-show?.py* " "scripts in the PyMuPDF-Utilities repository." msgstr "" "`rect.bl -> rect.tl` 、または `quad.ll -> quad.ul` の線の中間点。いくつかの例はこちら" "、またはPyMuPDF-Utilitiesリポジトリの *quad-show?.py* スクリプトをご覧ください。" #: ../../shape.rst:165 e10d02b00d77481699e5ed1c3824246d msgid "" "Draw a circle given its center and radius. The drawing starts and ends at" " point `center - (radius, 0)` in an **anti-clockwise** movement. This " "point is the middle of the enclosing square's left side." msgstr "" "指定された中心と半径で円を描きます。描画は、**反時計回り** の動きで、ポイント `center - (radius, 0)` " "で始まり、終了します。このポイントは、包括的な正方形の左側の中央です。" #: ../../shape.rst:167 ab7929d6c83247179ab99962d0e45182 msgid "" "This is a shortcut for `draw_sector(center, start, 360, " "fullSector=False)`. To draw the same circle in a **clockwise** movement, " "use `-360` as degrees." msgstr "" "これは `draw_sector(center, start, 360, fullSector=False)` " "のショートカットです。**時計回り** に同じ円を描画するには、度数として -360 を使用してください。" #: ../../shape.rst:169 ../../shape.rst:199 6f2705ad71a74c2b917e39246bc2698d #: bd872730dfb6401aa65d5bf0dcfa4a1d msgid "the center of the circle." msgstr "円の中心。" #: ../../shape.rst:171 5b6ab9084a254ee998a1d680ac1e0240 msgid "the radius of the circle. Must be positive." msgstr "円の半径。正である必要があります。" #: ../../shape.rst:174 7c4ce467661b468b8439dadac7926f6a msgid "" "`Point(center.x - radius, center.y)`. .. image:: images/img-drawcircle.*" " :scale: 60" msgstr "" #: ../../shape.rst:174 2debffa3cd414df1912ce3b384b1301c msgid "`Point(center.x - radius, center.y)`." msgstr "" #: ../../shape.rst:181 ee66694536bb4ca4a6a74521eab10648 msgid "" "A special case of *draw_bezier()*: Draw a cubic Bezier curve from *p1* to" " *p3*. On each of the two lines `p1 -> p2` and `p3 -> p2` one control " "point is generated. Both control points will therefore be on the same " "side of the line `p1 -> p3`. This guaranties that the curve's curvature " "does not change its sign. If the lines to p2 intersect with an angle of " "90 degrees, then the resulting curve is a quarter ellipse (resp. quarter " "circle, if of same length)." msgstr "" "*draw_bezier()* の特殊なケース: *p1* から *p3* までの三次ベジエ曲線を描きます。各ライン `p1 -> p2` および" " `p3 -> p2` に制御点が生成されます。したがって、両方の制御点はライン `p1 -> p3` " "の同じ側にあります。これにより、曲線の曲率が符号を変更しないことが保証されます。p2 " "へのラインが90度で交差する場合、結果の曲線は四分の楕円（同じ長さの場合は四半期の円）です。" #: ../../shape.rst:183 b9aa05d9515a4765ba0ed43ffaf7fdc8 msgid "All arguments are :data:`point_like`." msgstr "すべての引数は :data:`point_like` です。" #: ../../shape.rst:186 17f64971541f45cd813e80d02b9a38f9 msgid "" "the end point, *p3*. The following is a filled quarter ellipse segment. " "The yellow area is oriented **clockwise:** .. image:: images/img-" "drawCurve.png :align: center" msgstr "" #: ../../shape.rst:186 13f26770deb8487da263851084fcf4e9 msgid "" "the end point, *p3*. The following is a filled quarter ellipse segment. " "The yellow area is oriented **clockwise:**" msgstr "終点、p3。以下は塗りつぶされた四分の楕円セグメントです。黄色の領域は **時計回り** に向いています：" #: ../../shape.rst:197 e52f58c73f024ab492a6b26bf05ef6d1 msgid "" "Draw a circular sector, optionally connecting the arc to the circle's " "center (like a piece of pie)." msgstr "円のセクタを描き、必要に応じて円の中心に弧を接続します（パイの一片のように）。" #: ../../shape.rst:201 4a4f8fd9d4ae4e9f9d879279d68a23eb msgid "" "one of the two end points of the pie's arc segment. The other one is " "calculated from the *angle*." msgstr "パイの弧セグメントの2つの端点のうちの1つ。*角度* から他の端点が計算されます。" #: ../../shape.rst:203 cde4d3b5b77e4714a1e8229d3a7d5901 msgid "" "the angle of the sector in degrees. Used to calculate the other end point" " of the arc. Depending on its sign, the arc is drawn anti-clockwise " "(positive) or clockwise." msgstr "その符号に応じて、弧は反時計回り（正の値）または時計回りに描かれます。" #: ../../shape.rst:205 240361925857465eae04d2b1fb29fe7f msgid "" "whether to draw connecting lines from the ends of the arc to the circle " "center. If a fill color is specified, the full \"pie\" is colored, " "otherwise just the sector." msgstr "弧の端点から円の中心に接続線を描くかどうか。塗りつぶし色が指定されている場合、完全な「パイ」が色付けされ、それ以外の場合はセクタのみが色付けされます。" #: ../../shape.rst:208 be7cd89a7589439eb4d78244412304ad msgid "" "the other end point of the arc. Can be used as starting point for a " "following invocation to create logically connected pies charts. Examples:" " .. image:: images/img-drawSector1.* .. image:: images/img-" "drawSector2.*" msgstr "" #: ../../shape.rst:208 0043e2c7a86744b4a2bc4d7f0bce8a4b msgid "" "the other end point of the arc. Can be used as starting point for a " "following invocation to create logically connected pies charts. Examples:" msgstr "弧のもう一方の端点。論理的に接続されたパイチャートを作成するための次の呼び出しの開始点として使用できます。以下は例です：" #: ../../shape.rst:217 5fb3a670ab80402c9dcadb97fd8823f0 msgid "Changed in v1.22.0: Added parameter *radius*." msgstr "変更された v1.22.0 で：パラメーター *radius* が追加されました。" #: ../../shape.rst:219 d0e527f29d634bf6a4487b2594b804af msgid "" "Draw a rectangle. The drawing starts and ends at the top-left corner in " "an anti-clockwise movement." msgstr "長方形を描画します。描画は、上部左隅から反時計回りの動きで始まり、終了します。" #: ../../shape.rst:221 9f2b7555b1844871bbf67f60773f3566 msgid "where to put the rectangle on the page." msgstr "ページ上の長方形の配置先。" #: ../../shape.rst:222 67f101fa3c674ce7b113450e58af1ac1 #, python-format msgid "" "draw rounded rectangle corners. If not `None`, specifies the radius of " "the curvature as a percentage of a rectangle side length. This must one " "or (a tuple of) two floats `0 < radius <= 0.5`, where 0.5 corresponds to " "50% of the respective side. If a float, the radius of the curvature is " "computed as `radius * min(width, height)`, drawing the corner's perimeter" " as a quarter circle. If a tuple `(rx, ry)` is given, then the curvature " "is asymmetric with respect to the horizontal and vertical directions. A " "value of `radius=(0.5, 0.5)` draws an ellipse." msgstr "" "角の丸みを付けた長方形を描画します。`None` でない場合、曲線の半径を長方形の辺の長さのパーセンテージとして指定します。これは 1 つまたは " "2 つの浮動小数点数、`0 < radius <= 0.5` でなければなりません。0.5 は、対応する辺の 50% " "に相当します。浮動小数点数の場合、曲線の半径は `radius * min(width, height)` として計算され、角の周囲を 1/4 " "円で描画します。タプル `(rx, ry)` が指定された場合、曲線は水平および垂直方向に対して非対称です。`radius=(0.5, 0.5)`" " は楕円を描画します。" #: ../../shape.rst:225 6c3047af9341428fb1852d642a8d8fb3 msgid "top-left corner of the rectangle." msgstr "長方形の上部左隅。" #: ../../shape.rst:229 654bd0a3b7ce4bf78f0d2d85b1d37414 msgid "" "Draw a quadrilateral. The drawing starts and ends at the top-left corner " "(:attr:`Quad.ul`) in an anti-clockwise movement. It is a shortcut of " ":meth:`Shape.draw_polyline` with the argument `(ul, ll, lr, ur, ul)`." msgstr "" "四角形を描画します。描画は、上部左隅 (:attr:`Quad.ul`) から反時計回りの動きで始まり、終了します。これは " ":meth:`Shape.draw_polyline` の引数 `(ul, ll, lr, ur, ul)` を使用したショートカットです。" #: ../../shape.rst:231 046262682daf47c8be64f00f93f9acba msgid "where to put the tetragon on the page." msgstr "ページ上の四角形の配置先。" #: ../../shape.rst:234 3fe224acf6924b1085f1052564c9423f msgid ":attr:`Quad.ul`." msgstr "" #: ../../shape.rst:253 0de6d95816a442d3b9408559071e8954 msgid "" "Finish a set of *draw*()* methods by applying :ref:`CommonParms` to all " "of them." msgstr "次の *draw*()* メソッドの一連の描画を、:ref:`CommonParms` をそれらすべてに適用して終了します。" #: ../../shape.rst:255 56332b3691544dfbaf0fd9e731231bc5 msgid "" "It has **no effect on** :meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox`." msgstr "" ":meth:`Shape.insert_text` および :meth:`Shape.insert_textbox` には " "**影響を与えません**。" #: ../../shape.rst:257 549c8c7eeb8344aaa7576d3e8a534e9c msgid "" "The method also supports **morphing the compound drawing** using " ":ref:`Point` *fixpoint* and :ref:`matrix` *matrix*." msgstr "" "このメソッドは、:ref:`Point` *fixpoint* と :ref:`matrix` *matrix* を使用して、テキストまたは " "**複合描画を変形させること** もサポートしています。" #: ../../shape.rst:259 dba0c80e395c4f9992d5e84ad7225ffd msgid "" "morph the text or the compound drawing around some arbitrary :ref:`Point`" " *fixpoint* by applying :ref:`Matrix` *matrix* to it. This implies that " "*fixpoint* is a **fixed point** of this operation: it will not change its" " position. Default is no morphing (``None``). The matrix can contain any " "values in its first 4 components, *matrix.e == matrix.f == 0* must be " "true, however. This means that any combination of scaling, shearing, " "rotating, flipping, etc. is possible, but translations are not." msgstr "" "テキストまたは複合描画を、任意の :ref:`Point` *fixpoint* に :ref:`Matrix` *matrix* " "を適用して変形します。これにより、*fixpoint* はこの操作の **固定ポイント** " "であることを意味します。その位置は変わりません。デフォルトは変形なし（``None``）です。ただし、matrixの最初の4つの成分には任意の値を含めることができ、*matrix.e" " == matrix.f == 0* " "である必要があります。これは、スケーリング、シアリング、回転、反転など、移動以外の組み合わせが可能であることを意味しますが、移動はできません。" #: ../../shape.rst:261 5dafa22688dd4869b353c3ba9d3b07f7 msgid "" "*(new in v1.18.1)* set transparency for stroke colors. Value < 0 or > 1 " "will be ignored. Default is 1 (intransparent)." msgstr "*（v1.18.1で新規追加）* ストロークの透明度を設定します。値が0未満または1を超える場合は無視されます。デフォルトは1（不透明）です。" #: ../../shape.rst:262 ccec6b24043c40a28e9532eddd90bdce msgid "" "*(new in v1.18.1)* set transparency for fill colors. Default is 1 " "(intransparent)." msgstr "*（v1.18.1で新規追加）* 塗りつぶしの色の透明度を設定します。デフォルトは1（不透明）です。" #: ../../shape.rst:264 df15c1363a6a46538ab6875019646cbd msgid "" "request the **\"even-odd rule\"** for filling operations. Default is " "``False``, so that the **\"nonzero winding number rule\"** is used. These" " rules are alternative methods to apply the fill color where areas " "overlap. Only with fairly complex shapes a different behavior is to be " "expected with these rules. For an in-depth explanation, see " ":ref:`AdobeManual`, pp. 137 ff. Here is an example to demonstrate the " "difference." msgstr "" "塗りつぶし操作に対して **「even-oddルール」** を要求します。デフォルトは ``False`` で、したがって " "**「非ゼロのワインディング数ルール」** " "が使用されます。これらのルールは、領域が重なる場所で塗りつぶし色を適用するための代替メソッドです。複雑な形状では、これらのルールに異なる振る舞いが期待されることはほとんどありません。詳細な説明については、:ref:`AdobeManual`" " の137ページ以降を参照してください。以下はその違いを示す例です。" #: ../../shape.rst:266 c674e567b1e5433eaf84acd80acc23dc msgid "" "*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " ":data:`OCMD` to make this drawing conditionally displayable." msgstr "" "*（v1.18.4で新規追加）* この描画を条件付きで表示可能にする :data:`OCG` または :data:`OCMD` の " ":data:`xref` 番号。" #: ../../shape.rst:270 63c92f36394847c489986e7f2afbb97a msgid "For each pixel in a shape, the following will happen:" msgstr "各ピクセルの場合、以下のことが起こります：" #: ../../shape.rst:272 36c14ed50f0445be999e611bc169aa24 msgid "" "Rule **\"even-odd\"** counts, how many areas contain the pixel. If this " "count is **odd,** the pixel is regarded **inside** the shape, if it is " "**even**, the pixel is **outside**." msgstr "" "ルール **「even-odd」** は、ピクセルを含むエリアの数をカウントします。このカウントが **奇数** の場合、ピクセルは形状の " "**内部** と見なされ、偶数の場合は **外部** と見なされます。" #: ../../shape.rst:274 3effcfe2b7fe4980b3622d1cc2555db9 msgid "" "The default rule **\"nonzero winding\"** in addition looks at the " "*\"orientation\"* of each area containing the pixel: it **adds 1** if an " "area is drawn anti-clockwise and it **subtracts 1** for clockwise areas. " "If the result is zero, the pixel is regarded **outside,** pixels with a " "non-zero count are **inside** the shape." msgstr "" "デフォルトのルール **「nonzero winding」** では、ピクセルを含む各エリアの *「方向」* " "も考慮されます。エリアが反時計回りに描かれている場合は **1を追加し** 、時計回りのエリアは **1を引きます** " "。結果がゼロの場合、ピクセルは **外部** と見なされ、非ゼロのカウントを持つピクセルは形状の **内部** と見なされます。" #: ../../shape.rst:276 b72f9a0a9d6a42fba11e06941aaae289 msgid "" "Of the four shapes in above image, the top two each show three circles " "drawn in standard manner (anti-clockwise, look at the arrows). The lower " "two shapes contain one (the top-left) circle drawn clockwise. As can be " "seen, area orientation is irrelevant for the right column (even-odd " "rule)." msgstr "" "上記の画像の4つの形状のうち、上の2つはそれぞれ標準的な方法で描かれた3つの円を示しています（反時計回り、矢印を参照）。下の2つの形状には時計回りに描かれた1つ（左上）の円が含まれています。右の列では、エリアの方向は無視されることがわかります" "（even-oddルール）。" #: ../../shape.rst:297 a50a3db9c4f74b3aaed7c91f010f050f #, fuzzy msgid "Insert text lines starting at ``point``." msgstr "テキスト行を *point* で開始します。" #: ../../shape.rst:299 d60ae29ad0ca4e709ff2c72d7bf5c264 msgid "" "the bottom-left position of the first character of *text* in pixels. It " "is important to understand, how this works in conjunction with the " "*rotate* parameter. Please have a look at the following picture. The " "small red dots indicate the positions of *point* in each of the four " "possible cases. .. image:: images/img-inserttext.* :scale: 33" msgstr "" #: ../../shape.rst:299 1521f8f6fbea43a0be0deb7904e4623c msgid "" "the bottom-left position of the first character of *text* in pixels. It " "is important to understand, how this works in conjunction with the " "*rotate* parameter. Please have a look at the following picture. The " "small red dots indicate the positions of *point* in each of the four " "possible cases." msgstr "" "テキストの最初の文字の下部左位置（ピクセル単位）。*rotate* " "パラメータとの連携方法を理解することが重要です。以下の画像をご覧ください。小さな赤い点は、各ケースでの *point* の位置を示しています。" #: ../../shape.rst:304 c50197a3ee954fc4b17e16da50350320 #, fuzzy msgid "" "the text to be inserted. May be specified as either a string type or as a" " sequence type. For sequences, or strings containing line breaks ``\\n``," " several lines will be inserted. No care will be taken if lines are too " "wide, but the number of inserted lines will be limited by \"vertical\" " "space on the page (in the sense of reading direction as established by " "the *rotate* parameter). Any rest of *text* is discarded -- the return " "code however contains the number of inserted lines." msgstr "" "挿入するテキスト。文字列型または文字列のシーケンス型として指定できます。シーケンスの場合、または改行文字 *\\n* " "を含む文字列の場合、複数の行が挿入されます。ただし、行があまりにも幅が広い場合、挿入される行数はページ上の「垂直」スペース（*回転* " "パラメータによって確立される読み取り方向の意味で）によって制限されます。*テキスト* " "の残り部分は破棄されますが、戻りコードには挿入された行数が含まれます。" #: ../../shape.rst:306 ../../shape.rst:346 a2bce94fcad44fc08799f6d16a27e19d #: f75a16cbc40142c5a8ce2199eb87b25c msgid "" "a factor to override the line height calculated from font properties. If " "not `None`, a line height of `fontsize * lineheight` will be used." msgstr "" "フォントのプロパティから計算された行の高さをオーバーライドするためのファクター。``None`` でない場合、`fontsize * " "lineheight` の行の高さが使用されます。" #: ../../shape.rst:307 1ecd328d935546d38c4621a762982871 msgid "" "*(new in v1.18.1)* set transparency for stroke colors (the **border " "line** of a character). Only `0 <= value <= 1` will be considered. " "Default is 1 (intransparent)." msgstr "*（v1.18.1で新規追加）* ストロークの透明度を設定します。値が0未満または1を超える場合は無視されます。デフォルトは1（不透明）です。" #: ../../shape.rst:308 ../../shape.rst:351 168d47f1a50e45efbddb4be1a0a28d1c #: 7029b8b04590494a850f9bf97c737317 msgid "" "*(new in v1.18.1)* set transparency for fill colors. Default is 1 " "(intransparent). Use this value to control transparency of the text " "color. Stroke opacity **only** affects the border line of characters." msgstr "" "*（v1.18.1で新たに追加）* " "塗りつぶしカラーの透明度を設定します。デフォルトは1（不透明）です。テキストカラーの透明度を制御するためにこの値を使用します。ストロークの透明度は文字の境界線に" " **のみ** 影響します。" #: ../../shape.rst:310 bc253669783d43fbbcea827f904f8df7 msgid "" "determines whether to rotate the text. Acceptable values are multiples of" " 90 degrees. Default is 0 (no rotation), meaning horizontal text lines " "oriented from left to right. 180 means text is shown upside down from " "**right to left**. 90 means anti-clockwise rotation, text running " "**upwards**. 270 (or -90) means clockwise rotation, text running " "**downwards**. In any case, *point* specifies the bottom-left coordinates" " of the first character's rectangle. Multiple lines, if present, always " "follow the reading direction established by this parameter. So line 2 is " "located **above** line 1 in case of `rotate = 180`, etc." msgstr "" "テキストを回転させるかどうかを決定します。許容される値は90度の倍数です。デフォルトは0（回転なし）で、左から右への水平テキストが表示されます。180は、**右から左**" " への上下逆さテキストを意味し、90は反時計回りの回転で、テキストが **上向き** " "に表示されます。270（または-90）は時計回りの回転で、テキストが **下向き** " "に表示されます。いずれの場合も、pointは最初の文字の矩形の左下の座標を指定します。存在する場合、複数行は常にこのパラメータによって確立された読み取り方向に従います。したがって、" " *rotate = 180* の場合、行2は行1の **上に** 配置されます。" #: ../../shape.rst:312 ../../shape.rst:355 68906f83108042f0b104b462a3b39709 #: 9759f8b8a55448eb88645d85395ee4e8 msgid "" "*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " ":data:`OCMD` to make this text conditionally displayable." msgstr "" "*(v1.18.4 新機能)* :data:`OCG` または :data:`OCMD` の :data:`xref` " "番号、テキストを条件付きで表示可能にするためのものです。" #: ../../shape.rst:315 ed86c6cd4572455ba92ae3ff42b41fdf msgid "number of lines inserted." msgstr "挿入された行数。" #: ../../shape.rst:317 ../../shape.rst:367 4a40110f016f4c7bb3e919ac462d14e3 #: 785b22c9fbc5484186666fbe76c0f207 msgid "For a description of the other parameters see :ref:`CommonParms`." msgstr "他のパラメータの説明については :ref:`CommonParms` を参照してください。" #: ../../shape.rst:338 32569db0897946de8f8338dcc82e3dd3 msgid "" "PDF only: Insert text into the specified rectangle. The text will be " "split into lines and words and then filled into the available space, " "starting from one of the four rectangle corners, which depends on " "`rotate`. Line feeds and multiple space will be respected." msgstr "" "PDFのみ：指定された矩形にテキストを挿入します。テキストは行と単語に分割され、*回転* " "に応じて異なる矩形の角から始まり、利用可能なスペースに挿入されます。行送りと複数のスペースは尊重されます。" #: ../../shape.rst:340 c50da8ee249d416084e826f0a8a2efd6 msgid "the area to use. It must be finite and not empty." msgstr "使用する領域。有限でかつ空でなければなりません。" #: ../../shape.rst:342 7990001f1d8a482696c3ea94ee3b11c5 msgid "" "the text to be inserted. Must be specified as a string or a sequence of " "strings. Line breaks are respected also when occurring in a sequence " "entry." msgstr "挿入するテキスト。文字列または文字列のシーケンスとして指定する必要があります。シーケンスエントリ内の行送りも尊重されます。" #: ../../shape.rst:344 8bfa2ed038884962a70ceb3e0459dc06 msgid "" "align each text line. Default is 0 (left). Centered, right and justified " "are the other supported options, see :ref:`TextAlign`. Please note that " "the effect of parameter value *TEXT_ALIGN_JUSTIFY* is only achievable " "with \"simple\" (single-byte) fonts (including the :ref:`Base-14-Fonts`)." msgstr "" "各テキスト行を整列させます。デフォルトは0（左揃え）。センタリング、右揃え、ジャスティファイドがサポートされている他のオプションです。詳細は " ":ref:`TextAlign` を参照してください。なお、パラメータ値 *TEXT_ALIGN_JUSTIFY* " "の効果は、「シンプル」（単一バイト）フォント（:ref:`Base-14-Fonts` を含む）でのみ達成できます。" #: ../../shape.rst:348 9adb4b3bbe094da8a624bd552fc13f21 msgid "" "controls handling of tab characters ``\\t`` using the " "`string.expandtabs()` method **per each line**." msgstr "タブ文字 *\\t* の処理を **行ごとに** *string.expandtabs()* メソッドを使用して制御します。" #: ../../shape.rst:350 67177b4ade6c4da5a4523395d6bd4bf4 msgid "" "*(new in v1.18.1)* set transparency for stroke colors. Negative values " "and values > 1 will be ignored. Default is 1 (intransparent)." msgstr "*（v1.18.1で新たに追加）* ストロークカラーの透明度を設定します。負の値や1より大きい値は無視されます。デフォルトは1（不透明）です。" #: ../../shape.rst:353 d5edb13ac13b4ab4ba9d26fa3d3a6d82 msgid "" "requests text to be rotated in the rectangle. This value must be a " "multiple of 90 degrees. Default is 0 (no rotation). Effectively, the four" " values `0`, `90`, `180` and `270` (= `-90`) are processed, each causing " "the text to start in a different rectangle corner. Bottom-left is `90`, " "bottom-right is `180`, and `-90 / 270` is top-right. See the example how " "text is filled in a rectangle. This argument takes precedence over " "morphing. See the second example, which shows text first rotated left by " "`90` degrees and then the whole rectangle rotated clockwise around is " "lower left corner." msgstr "" "テキストを矩形内で回転させるように要求します。受け入れ可能な値は90度の倍数です。デフォルトは0（回転なし）、つまり左から右への水平なテキスト行です。180は、右から左に逆さまに表示されることを意味します。90は反時計回りの回転で、テキストは上に向かって表示されます。270（または-90）は時計回りの回転で、テキストは下に向かって表示されます。いずれの場合も、pointは最初の文字の矩形の左下の座標を指定します。複数行がある場合は、常にこのパラメータで確立された読み取り方向に従います。したがって、rotate" " = 180の場合、行2は行1の上に配置されますなど。" #: ../../shape.rst:358 c9924f296b104dcb885e423a8329287a msgid "" "**If positive or zero**: successful execution. The value returned is the " "unused rectangle line space in pixels. This may safely be ignored -- or " "be used to optimize the rectangle, position subsequent items, etc. **If " "negative**: no execution. The value returned is the space deficit to " "store text lines. Enlarge rectangle, decrease *fontsize*, decrease text " "amount, etc." msgstr "" #: ../../shape.rst:359 ff434ea0b01748d3a22351b8914d1de9 msgid "" "**If positive or zero**: successful execution. The value returned is the " "unused rectangle line space in pixels. This may safely be ignored -- or " "be used to optimize the rectangle, position subsequent items, etc." msgstr "" "**正またはゼロの場合** " "：正常な実行。返される値は使用されていない矩形行のスペース（ピクセル単位）です。これを安全に無視するか、矩形を最適化したり、後続のアイテムの位置を調整したりするために使用できます。" #: ../../shape.rst:361 2d7f62a0c5ec468eb58daea2b7b74842 msgid "" "**If negative**: no execution. The value returned is the space deficit to" " store text lines. Enlarge rectangle, decrease *fontsize*, decrease text " "amount, etc." msgstr "" "**負の場合**： " "実行なし。返される値はテキスト行を格納するためのスペース不足です。矩形を拡大したり、フォントサイズを減少させたり、テキストの量を減少させたりする必要があります。" #: ../../shape.rst:375 f65e40d3ebec4535af01faa79e3c04db msgid "" "Update the page's :data:`contents` with the accumulated drawings, " "followed by any text insertions. If text overlaps drawings, it will be " "written on top of the drawings." msgstr "" "ページの :data:`contents` " "を蓄積された描画に更新し、その後テキスト挿入が続きます。テキストが描画と重なる場合、テキストは描画の上に書き込まれます。" #: ../../shape.rst:377 3cc36436278147c4bf9af8031f1046a3 msgid "**Do not forget to execute this method:**" msgstr "**このメソッドを実行しないことは忘れないでください：**" #: ../../shape.rst:379 44ccc171888e476f88b7c3ce68d54ad9 msgid "" "If a shape is **not committed, it will be ignored and the page will not " "be changed!**" msgstr "シェイプが **確定されていない** 場合、無視され、ページは変更されません！" #: ../../shape.rst:381 8911998982cf45e6b4d61df722ae0084 msgid "" "The method will reset attributes :attr:`Shape.rect`, :attr:`lastPoint`, " ":attr:`draw_cont`, :attr:`text_cont` and :attr:`totalcont`. Afterwards, " "the shape object can be reused for the **same page**." msgstr "" "このメソッドは、属性 :attr:`Shape.rect`、:attr:`lastPoint` 、:attr:`draw_cont` " "、:attr:`text_cont` 、および :attr:`totalcont` をリセットします。その後、シェイプオブジェクトは " "**同じページ** で再利用できます。" #: ../../shape.rst:383 90b57d6cc3344abaa5ae796d17518c78 msgid "" "determine whether to put content in foreground (default) or background. " "Relevant only, if the page already has a non-empty :data:`contents` " "object." msgstr "" "コンテンツを前面（デフォルト）または背面に配置するかどうかを決定します。ページに既存の非空の :data:`contents` " "オブジェクトがある場合のみ関連します。" #: ../../shape.rst:385 555f29f07330465799e60c983380d945 msgid "**---------- Attributes ----------**" msgstr "**属性**" #: ../../shape.rst:389 bcd84d9d71fe4ab7a75882c2f6ea55ee msgid "For reference only: the page's document." msgstr "参照専用：ページの文書。" #: ../../shape.rst 4bc5f78dcd47499499d993fc76937923 #: 51e0e906798c404999816e887c14725e 583eb30bb6764d82886dcee5ecc5ef23 #: 7da907572dab4cdd850b1f99866f1208 84fee03ff02a47de895a2e76a85339b0 #: 8ad67482ac084e4e8acd77c771ac9813 bd1c39ed922a4dba9f34104a29bd9bd6 #: dc8385568c9641d9bb717e0218bc356a f04ca533ba0f465e9baafc622227ff3a msgid "type" msgstr "" #: ../../shape.rst:391 d4a7179efc87417687ed54512b5fd372 msgid ":ref:`Document`" msgstr "" #: ../../shape.rst:395 e50d0793a5eb432bb3c2ca8ea196f4c2 msgid "For reference only: the owning page." msgstr "参照専用：所属するページ。" #: ../../shape.rst:397 a88ee833273045f299c35dd3ead948a4 msgid ":ref:`Page`" msgstr "" #: ../../shape.rst:401 2bad01b347624c13a0c42fc3970fc1b5 msgid "Copy of the page's height" msgstr "ページの高さのコピー" #: ../../shape.rst:403 ../../shape.rst:409 a1d7f49541cb48ab8a1087635dffe627 #: ee0e76b01d494167bc804a4bcb20168e msgid "float" msgstr "" #: ../../shape.rst:407 ae4a0df9e57c45dd99dc05694d71194d msgid "Copy of the page's width." msgstr "ページの幅のコピー。" #: ../../shape.rst:413 36e04a92b85b455f986d86cf86a84b9d msgid "" "Accumulated command buffer for **draw methods** since last finish. Every " "finish method will append its commands to :attr:`Shape.totalcont`." msgstr "" "最後のfinish以降の **描画メソッド** の蓄積コマンドバッファ。各finishメソッドはそのコマンドを " ":attr:`Shape.totalcont` に追加します。" #: ../../shape.rst:415 ../../shape.rst:421 ../../shape.rst:442 #: 0e691c52a692459fb3651063bbd96fa1 3bd5e87273ea409ba3861ff7a5df3fba #: 6131e3edacf44d948d0f06ae76196fb4 msgid "str" msgstr "" #: ../../shape.rst:419 1c7cc423d0b647cc8b976e70594d7e5a msgid "" "Accumulated text buffer. All **text insertions** go here. This buffer " "will be appended to :attr:`totalcont` :meth:`Shape.commit`, so that text " "will never be covered by drawings in the same Shape." msgstr "" "蓄積されたテキストバッファ。すべての **テキスト挿入** はここに行われます。このバッファは :attr:`totalcont` " ":meth:`Shape.commit` に追加されるため、テキストは同じShape内の描画に覆われることはありません。" #: ../../shape.rst:425 31e0348adf3949dea03c7e108eec0e9a msgid "" "Rectangle surrounding drawings. This attribute is at your disposal and " "may be changed at any time. Its value is set to ``None`` when a shape is " "created or committed. Every *draw** method, and " ":meth:`Shape.insert_textbox` update this property (i.e. **enlarge** the " "rectangle as needed). **Morphing** operations, however " "(:meth:`Shape.finish`, :meth:`Shape.insert_textbox`) are ignored." msgstr "" "描画を囲む矩形。この属性はあなたの自由に使用でき、いつでも変更できます。シェイプが作成または確定されたとき、その値は ``None`` " "に設定されます。すべての *draw** メソッド、および :meth:`Shape.insert_textbox` " "はこのプロパティを更新します（必要に応じて矩形を **拡大します** ）。ただし、**変形** 操作（:meth:`Shape.finish` " "、:meth:`Shape.insert_textbox` ）は無視されます。" #: ../../shape.rst:427 58e3a175f61343beb779d52d6f9a968a msgid "" "A typical use of this attribute would be setting " ":attr:`Page.cropbox_position` to this value, when you are creating shapes" " for later or external use. If you have not manipulated the attribute " "yourself, it should reflect a rectangle that contains all drawings so " "far." msgstr "" "この属性の典型的な使用法は、後でまたは外部で使用するためにシェイプを作成する場合、:attr:`Page.cropbox_position` " "をこの値に設定することです。自分で属性を操作していない場合、これはこれまでのすべての描画を含む矩形を反映するはずです。" #: ../../shape.rst:429 bde3111f6fcb4fde8ae6d94e2b784878 msgid "" "If you have used morphing and need a rectangle containing the morphed " "objects, use the following code::" msgstr "変形を使用し、変形されたオブジェクトを含む矩形が必要な場合、次のコードを使用します::" #: ../../shape.rst:436 8b59162d4cdc4453a1a62c884c29d8c5 msgid ":ref:`Rect`" msgstr "" #: ../../shape.rst:440 70f79c2bf0624368be25e43a4b7a3c3f msgid "" "Total accumulated command buffer for draws and text insertions. This will" " be used by :meth:`Shape.commit`." msgstr "描画およびテキスト挿入のための累積コマンドバッファです。これは :meth:`Shape.commit` で使用されます。" #: ../../shape.rst:446 2a512a35544e4ff4bc0908226c3f1474 msgid "" "For reference only: the current point of the drawing path. It is ``None``" " at *Shape* creation and after each *finish()* and *commit()*." msgstr "" "参照用: 描画パスの現在のポイントです。*Shape* の作成時、および各 *finish()* および *commit()* の後には " "``None`` です。" #: ../../shape.rst:451 5f43e7fa99ee464a8f4e310b6073e35b msgid "Usage" msgstr "使用法" #: ../../shape.rst:452 a35b85f2df424fe5a8123cbd236b49c9 msgid "" "A drawing object is constructed by *shape = page.new_shape()*. After " "this, as many draw, finish and text insertions methods as required may " "follow. Each sequence of draws must be finished before the drawing is " "committed. The overall coding pattern looks like this::" msgstr "" "drawingオブジェクトは `shape = page.new_shape()` " "によって構築されます。その後、必要なだけ多くのdraw、finish、およびテキスト挿入メソッドが続きます。描画をコミットする前に、各描画シーケンスを終了する必要があります。全体のコーディングパターンは次のようになります::" #: ../../shape.rst:471 7d0392c130464a54a962cc95cad3ce9d msgid "" "Each *finish()* combines the preceding draws into one logical shape, " "giving it common colors, line width, morphing, etc. If *closePath* is " "specified, it will also connect the end point of the last draw with the " "starting point of the first one." msgstr "" "各 *finish()* メソッドは、前の描画を1つの論理的なシェイプに結合し、共通の色、線の幅、変形などを設定します。*closePath* " "が指定されている場合、最後の描画のエンドポイントを最初の描画のスタートポイントと接続します。" #: ../../shape.rst:473 d909c60fe1834c8eb1936c81f4fe8a7c msgid "" "To successfully create compound graphics, let each draw method use the " "end point of the previous one as its starting point. In the above pseudo " "code, *draw2* should hence use the returned :ref:`Point` of *draw1* as " "its starting point. Failing to do so, would automatically start a new " "path and *finish()* may not work as expected (but it won't complain " "either)." msgstr "" "複合グラフィックを正常に作成するには、各 draw " "メソッドが前の描画のエンドポイントを次の描画のスタートポイントとして使用してください。上記の疑似コードでは、*draw2* は *draw1* " "の戻り値である :ref:`Point` " "を次の描画のスタートポイントとして使用すべきです。そうしないと、自動的に新しいパスが開始され、*finish()* " "が期待どおりに動作しないかもしれません（ただし、エラーは発生しません）。" #: ../../shape.rst:475 fb42b4b00cfd4c8f9bc125398e78d941 msgid "" "Text insertions may occur anywhere before the commit (they neither touch " ":attr:`Shape.draw_cont` nor :attr:`Shape.lastPoint`). They are appended " "to *Shape.totalcont* directly, whereas draws will be appended by " "*Shape.finish*." msgstr "" "テキストの挿入は、コミット（commit）の前にどこでも発生できます :attr:`Shape.draw_cont` または " ":attr:`Shape.lastPoint` に触れません）。テキストは直接 *Shape.totalcont* に追加されますが、描画は " "*Shape.finish* によって追加されます。" #: ../../shape.rst:477 f1ba4537b82747479d0306c9e87f4f4c msgid "" "Each *commit* takes all text insertions and shapes and places them in " "foreground or background on the page -- thus providing a way to control " "graphical layers." msgstr "各 *コミット* は、すべてのテキスト挿入とシェイプをページの前面または背面に配置し、グラフィックのレイヤーを制御する方法を提供します。" #: ../../shape.rst:479 f54933082b2d4eff99e12a13fc1482a9 msgid "" "**Only** *commit* **will update** the page's contents, the other methods " "are basically string manipulations." msgstr "*コミット* **のみ** がページのコンテンツを **更新します**。他のメソッドは基本的に文字列の操作です。" #: ../../shape.rst:482 278641dcb46d4baf936c58e97dcd5458 msgid "Examples" msgstr "例" #: ../../shape.rst:483 eb1041462daa4eaea29f2c68f9820833 msgid "Create a full circle of pieces of pie in different colors::" msgstr "異なる色のピースを使用して円形のパイを作成します::" #: ../../shape.rst:498 eaebaebe3baa4f09947553ff9e26c2a1 msgid "Here is an example for 5 colors:" msgstr "以下は5つの色の例です。" #: ../../shape.rst:502 3cf653254d684532a9c3aba1c78bfd12 msgid "" "Create a regular n-edged polygon (fill yellow, red border). We use " "*draw_sector()* only to calculate the points on the circumference, and " "empty the draw command buffer again before drawing the polygon::" msgstr "" "正則なn角形を作成します（塗りつぶしは黄色、赤い境界線）。周囲の点を計算するために *draw_sector（）* " "を使用し、多角形を描く前に描画コマンドバッファを空にします::" #: ../../shape.rst:517 e093071b33a14f6ca8a50b7e9ef6d3b1 msgid "Here is the polygon for n = 7:" msgstr "n = 7の場合の多角形は次のとおりです：" #: ../../shape.rst:524 32cfdbeb116244d09f20318c9cbaa2ac msgid "Common Parameters" msgstr "共通パラメータ" #: ../../shape.rst:526 e8e32aa90b154bf9b1f9186f60ab584a msgid "**fontname** (*str*)" msgstr "" #: ../../shape.rst:528 77ba86666bd24c11b1d1d22120f706a7 msgid "In general, there are three options:" msgstr "一般的に、3つのオプションがあります：" #: ../../shape.rst:530 02905b80e6194c4eacf48669a2b4862d msgid "" "Use one of the standard :ref:`Base-14-Fonts`. In this case, *fontfile* " "**must not** be specified and *\"Helvetica\"* is used if this parameter " "is omitted, too." msgstr "" "標準の :ref:`Base-14-Fonts` のいずれかを使用します。この場合、*fontfile* を指定 " "**してはいけず**、このパラメータを省略した場合は *「Helvetica」* が使用されます。" #: ../../shape.rst:531 e643b83ac7934c6a8daf143d5e6ea969 msgid "" "Choose a font already in use by the page. Then specify its **reference** " "name prefixed with a slash \"/\", see example below." msgstr "既にページで使用されているフォントを選択します。その場合、スラッシュ「/」で前置された **参照** 名を指定します。以下の例を参照してください。" #: ../../shape.rst:532 1aa96eb291154994b5334cb249b357b8 msgid "" "Specify a font file present on your system. In this case choose an " "arbitrary, but new name for this parameter (without \"/\" prefix)." msgstr "システムに存在するフォントファイルを指定します。この場合、任意の新しい名前をこのパラメータに選択します（「/」接頭辞なし）。" #: ../../shape.rst:534 42e52261eb524d2984f6a0c4332a2f24 msgid "" "If inserted text should re-use one of the page's fonts, use its reference" " name appearing in :meth:`Page.get_fonts` like so:" msgstr "" "挿入されるテキストがページのフォントの1つを再利用する場合は、:meth:`Page.get_fonts` " "に表示される参照名を次のように使用します：" #: ../../shape.rst:536 17c14b3525c343518ae06671819af5b8 msgid "" "Suppose the font list has the item *[1024, 0, 'Type1', 'NimbusMonL-Bold'," " 'R366']*, then specify *fontname = \"/R366\", fontfile = None* to use " "font *NimbusMonL-Bold*." msgstr "" "フォントリストに項目 *[1024, 0, 'Type1', 'NimbusMonL-Bold', 'R366']* がある場合、フォント " "*NimbusMonL-Bold* を使用するには、*fontname = \"/R366\"、fontfile = None* と指定します。" #: ../../shape.rst:540 30272688bae040099e4f10745899bb73 msgid "**fontfile** (*str*)" msgstr "" #: ../../shape.rst:542 c86a2afe0b8040a3841ecc108e5f0c2a msgid "" "File path of a font existing on your computer. If you specify *fontfile*," " make sure you use a *fontname* **not occurring** in the above list. This" " new font will be embedded in the PDF upon *doc.save()*. Similar to new " "images, a font file will be embedded only once. A table of MD5 codes for " "the binary font contents is used to ensure this." msgstr "" "コンピューターに存在するフォントのファイルパス。*fontfile* を指定する場合、上記のリストに **存在しない** *フォント名* " "を使用してください。この新しいフォントは、*doc.save()* " "時にPDFに埋め込まれます。画像と同様に、フォントファイルは1度だけ埋め込まれます。バイナリフォントコンテンツのMD5コードのテーブルが使用され、これを確実にします。" #: ../../shape.rst:546 de497e62ab204c48ae01fa7ac3ed1c32 msgid "**set_simple** (*bool*)" msgstr "" #: ../../shape.rst:548 8620026ea526446e8ef1ca19f9760737 msgid "" "Fonts installed from files are installed as **Type0** fonts by default. " "If you want to use 1-byte characters only, set this to true. This setting" " cannot be reverted. Subsequent changes are ignored." msgstr "" "ファイルからインストールされたフォントは、デフォルトで **Type0** " "フォントとしてインストールされます。1バイト文字のみを使用する場合は、これをtrueに設定します。この設定は元に戻すことはできません。後続の変更は無視されます。" #: ../../shape.rst:552 3981f48a75204dc09ff6f422f689ffa4 msgid "**fontsize** (*float*)" msgstr "" #: ../../shape.rst:554 30ac30c13b44417bbeb1b66ed6d98114 msgid "Font size of text, see: :data:`fontsize`." msgstr "テキストのフォントサイズ、参照： :data:`fontsize`。" #: ../../shape.rst:558 4d0dc80686d94b4c88776c39286aa523 msgid "**dashes** (*str*)" msgstr "" #: ../../shape.rst:560 47655eea2c2e46188c15bd1c75c4117a #, fuzzy msgid "" "Causes lines to be drawn dashed. The general format is `\"[n m] p\"` of " "(up to) 3 floats denoting pixel lengths. ``n`` is the dash length, ``m`` " "(optional) is the subsequent gap length, and ``p`` (the \"phase\" - " "**required**, even if 0!) specifies how many pixels should be skipped " "before the dashing starts. If ``m`` is omitted, it defaults to ``n``." msgstr "" "線を破線で描画するようにします。一般的なフォーマットは、ピクセル長を示す（最大）3つの浮動小数点数の `\"[n m] p\"` です。``n``" " は破線の長さ、``m`` （オプション）はその後のギャップの長さ、 ``p`` （「位相」 - 0であっても " "**必須**！）は、破線が開始される前にスキップするべきピクセルの数を指定します。``m`` が省略された場合、``n`` " "にデフォルト値が設定されます。" #: ../../shape.rst:562 c003ae76596a4f938a7fd5de9cb061a3 msgid "" "A continuous line (no dashes) is drawn with `\"[] 0\"` or ``None`` or " "`\"\"`. Examples:" msgstr "連続線（破線なし）は `\"[] 0\"` または ``None`` または `\"\"` で描画されます。例：" #: ../../shape.rst:564 e6cbda6711694eb8b100b5a9792385ef msgid "" "Specifying `\"[3 4] 0\"` means dashes of 3 and gaps of 4 pixels following" " each other." msgstr "`\"[3 4] 0\"` を指定すると、3ピクセルの破線と4ピクセルのギャップが交互に続きます。" #: ../../shape.rst:565 3391c97c4550433782ec215117a6557d msgid "`\"[3 3] 0\"` and `\"[3] 0\"` do the same thing." msgstr "`\"[3 3] 0\"` と `\"[3] 0\"` は同じことをします。" #: ../../shape.rst:567 f068a3fa466545ecaf2d248a20fc2739 msgid "" "For (the rather complex) details on how to achieve sophisticated dashing " "effects, see :ref:`AdobeManual`, page 217." msgstr "洗練された破線効果を実現する詳細な詳細については、:ref:`AdobeManual` の217ページを参照してください。" #: ../../shape.rst:571 82aa9894181a4fe3b697261487bbfe7e msgid "**color / fill** (*list, tuple*)" msgstr "**色/塗りつぶし** （*リスト、タプル*）" #: ../../shape.rst:573 3ed2643ec6df4cc28a73683cb286285e msgid "" "Stroke and fill colors can be specified as tuples or list of of floats " "from 0 to 1. These sequences must have a length of 1 (GRAY), 3 (RGB) or 4" " (CMYK). For GRAY colorspace, a single float instead of the unwieldy " "*(float,)* or *[float]* is also accepted. Accept (default) or use `None` " "to not use the parameter." msgstr "" "線の色と塗りつぶしの色は、0から1までの浮動小数点数からなるリストまたはタプルとして指定できます。これらのシーケンスの長さは、1（GRAY）、3（RGB）、または4（CMYK）でなければなりません。GRAYカラースペースの場合、*[float]*" " や*(float,)* " "の代わりに単一の浮動小数点数を使用することもできます。このパラメータを受け入れるには、（デフォルト）を受け入れるか、または使用しないようにするには" " `None` を使用します。" #: ../../shape.rst:575 06bd406c862d430d8527a7a38b17df9b msgid "" "To simplify color specification, method *getColor()* in *pymupdf.utils* " "may be used to get predefined RGB color triples by name. It accepts a " "string as the name of the color and returns the corresponding triple. The" " method knows over 540 color names -- see section :ref:`ColorDatabase`." msgstr "" "色の指定を簡略化するために、*pymupdf.utils* の *getColor()* " "メソッドを使用して、名前に対応するRGBカラートリプルを取得することができます。これは色の名前を指定する文字列を受け入れ、対応するトリプルを返します。このメソッドは540以上のカラー名を認識します。:ref:`ColorDatabase`" " のセクションを参照してください。" #: ../../shape.rst:577 3313c7d4006745a8b2fc466404404f63 msgid "" "Please note that the term *color* usually means \"stroke\" color when " "used in conjunction with fill color." msgstr "ご注意ください。*色* という用語は、通常、塗りつぶし色と組み合わせて使用される場合に「線の」色を意味します" #: ../../shape.rst:579 0a6d8ba9500941c4bc6aa00352d41451 msgid "" "If letting default a color parameter to `None`, then no resp. color " "selection command will be generated. If *fill* and *color* are both " "`None`, then the drawing will contain no color specification. But it will" " still be \"stroked\", which causes PDF's default color \"black\" be used" " by Adobe Acrobat and all other viewers." msgstr "" "色パラメータのデフォルト値を `None` にする場合、対応する色の選択コマンドは生成されません。*fill* と *color* がどちらも " "`None` の場合、描画には色の指定が含まれません。ただし、まだ「ストローク」されているため、Adobe " "Acrobatや他のビューアではPDFのデフォルトカラー「ブラック」が使用されます。" #: ../../shape.rst:583 2e5246304d274dfaa37af742928af0ea #, fuzzy msgid "**width** (*float*)" msgstr "**border_width** （*浮動小数点数*）" #: ../../shape.rst:585 77b8db9870114d7f91f971f5aaa99512 msgid "" "The stroke (\"border\") width of the elements in a shape (if applicable)." " The default value is 1. The values width, color and fill have the " "following relationship / dependency:" msgstr "図形内の要素のストローク（\"枠線\"）の幅（適用可能な場合）。デフォルト値は1です。幅、色、塗りつぶしの値は、以下の関係/依存関係を持ちます：" #: ../../shape.rst:587 bd3f3d47979d4ba6967fc689176d7873 msgid "" "If `fill=None` shape elements will always be drawn with a border - even " "if `color=None` (in which case black is taken) or `width=0` (in which " "case 1 is taken)." msgstr "" "`fill=None` の場合、shape要素は常に枠線で描画されます - `color=None` " "の場合（その場合、黒が使用されます）、または `width=0` の場合（その場合、1が使用されます）でもです。" #: ../../shape.rst:588 50e316e85bee43f3ae23b6e8bf36459e #, fuzzy msgid "" "Shapes without border can only be achieved if a fill color is specified " "(which may be white of course). To achieve this, specify `width=0`. In " "this case, the ``color`` parameter is ignored." msgstr "" "枠線のない図形は、塗りつぶしの色が指定されている場合のみ実現できます（もちろん白色であっても構いません）。これを実現するには、 `width=0`" " を指定します。この場合、 `color` パラメータは無視されます。" #: ../../shape.rst:592 dbf0b7aa242944fd9c3dba05b0a5476c msgid "**stroke_opacity / fill_opacity** (*floats*)" msgstr "**stroke_opacity / fill_opacity** （*浮動小数点数*）" #: ../../shape.rst:594 f10fd732b18e4d06882b251b866820ed msgid "" "Both values are floats in range [0, 1]. Negative values or values > 1 " "will ignored (in most cases). Both set the transparency such that a value" " 0.5 corresponds to 50% transparency, 0 means invisible and 1 means " "intransparent. For e.g. a rectangle the stroke opacity applies to its " "border and fill opacity to its interior." msgstr "両方の値は[0、1]の範囲の浮動小数点数です。負の値または1を超える値は（ほとんどの場合）無視されます。両方の値は、透明度を設定し、たとえば値0.5は50％の透明度を示し、0は不可視を意味し、1は不透明を意味します。たとえば四角形の場合、stroke_opacityはその境界に、fill_opacityはその内部に適用されます。" #: ../../shape.rst:596 908ef08674a94047bf811e5db7824042 #, fuzzy msgid "" "For text insertions (:meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox`), use *fill_opacity* for the text. At first " "sight this seems surprising, but it becomes obvious when you look further" " down to `render_mode`: `fill_opacity` applies to the yellow and " "`stroke_opacity` applies to the blue color." msgstr "" "テキストの挿入（:meth:`Shape.insert_text` および :meth:`Shape.insert_textbox` " "）の場合、テキストには *fill_opacity* を使用してください。最初は驚くかもしれませんが、*render_mode* " "の詳細を見ると明らかになります。*fill_opacity* は黄色に適用され、*stroke_opacity* は青色に適用されます。" #: ../../shape.rst:600 807dedb850524343a44713165dc92d74 msgid "**border_width** (*float*)" msgstr "**border_width** （*浮動小数点数*）" #: ../../shape.rst:602 7c05f5b49a074002a9a8e24fa16e09c0 msgid "" "Set the border width for text insertions. New in v1.14.9. Relevant only " "if the render mode argument is used with a value greater zero." msgstr "テキスト挿入の境界線の幅を設定します。v1.14.9で新しく追加されました。render_mode引数がゼロより大きい値で使用されている場合にのみ関連します。" #: ../../shape.rst:606 e8f74369b5414cf39c02c7bdc84d0278 msgid "**render_mode** (*int*)" msgstr "**render_mode** (*整数*)" #: ../../shape.rst:608 07e11204dc2b4479bd2e65c3e33aad8d msgid "" "*New in version 1.14.9:* Integer in `range(8)` which controls the text " "appearance (:meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`). " "See page 246 in :ref:`AdobeManual`. New in v1.14.9. These methods now " "also differentiate between fill and stroke colors." msgstr "" "*バージョン1.14.9で新たに導入された* `range(8)` " "内の整数。これはテキストの外観（:meth:`Shape.insert_text` および " ":meth:`Shape.insert_textbox` ）を制御します。:ref:`AdobeManual` " "のページ246を参照してください。バージョン1.14.9での新機能です。これらのメソッドは、塗りつぶしの色とストロークの色を区別するようになりました。" #: ../../shape.rst:610 69a9ed429520483291966e04bc134827 msgid "" "For default 0, only the text fill color is used to paint the text. For " "backward compatibility, using the *color* parameter instead also works." msgstr "" "デフォルト値0では、テキストの塗りつぶし色のみがテキストを塗りつぶすために使用されます。*color* " "パラメーターを代わりに使用することも、後方互換性のために機能します。" #: ../../shape.rst:611 92f8238398a445de9ac634455065140b msgid "" "For render mode 1, only the border of each glyph (i.e. text character) is" " drawn with a thickness as set in argument *border_width*. The color " "chosen in the *color* argument is taken for this, the *fill* parameter is" " ignored." msgstr "" "render_mode 1では、各グリフ（つまりテキスト文字）の境界線のみが指定された *border_width* " "で描画されます。この際、*color* 引数で選択した色が使用され、*fill* パラメーターは無視されます。" #: ../../shape.rst:612 6dd3e1055d934657ae6fbe17f98f1b7b msgid "" "For render mode 2, the glyphs are filled and stroked, using both color " "parameters and the specified border width. You can use this value to " "simulate **bold text** without using another font: choose the same value " "for *fill* and *color* and an appropriate value for *border_width*." msgstr "" "render_mode " "2では、グリフは塗りつぶされ、ストロークされ、両方の色パラメーターと指定された境界幅が使用されます。別のフォントを使用せずに " "**太字のテキスト** をシミュレートするためにこの値を使用できます。*fill* と *color* " "に同じ値を選択し、*border_width* に適切な値を選択します。" #: ../../shape.rst:613 44ab50cc9488478cbafcd5e8d9859763 msgid "" "For render mode 3, the glyphs are neither stroked nor filled: the text " "becomes invisible." msgstr "render_mode 3では、グリフはストロークも塗りつぶしもされません。テキストは見えなくなります。" #: ../../shape.rst:615 e59e76826913438ea50a2cc075ab7cd2 msgid "" "The following examples use border_width=0.3, together with a fontsize of " "15. Stroke color is blue and fill color is some yellow." msgstr "以下の例では、border_width=0.3を使用し、フォントサイズは15です。ストロークの色は青で、塗りつぶしの色は黄色です。" #: ../../shape.rst:621 082047ee68a54ee3ae920d7817052247 #, fuzzy msgid "**miter_limit** (*float*)" msgstr "**border_width** （*浮動小数点数*）" #: ../../shape.rst:623 5df811fb349949d38e4160fbc8097077 msgid "" "A float specifying the maximum acceptable value of the quotient `miter-" "length / line-width` (\"miter quotient\"). Used in text output methods. " "This is only relevant for non-zero render mode values -- then, characters" " are written with border lines (i.e. \"stroked\")." msgstr "" #: ../../shape.rst:625 fcdf5a0b4b05400fabcc68e71bbfe4a3 msgid "" "If two lines stroking some character meet at a sharp (<= 90°) angle and " "the line width is large enough, then \"spikes\" may become visible -- " "causing an ugly appearance as shown below. For more background, see page " "126 of the :ref:`AdobeManual`." msgstr "" #: ../../shape.rst:627 61ef12d76d4c44a5971fbe5f377e42cd msgid "" "For instance, when joins meet at 90°, then the miter length is ``sqrt(2) " "* line-width``, so the miter quotient is ``sqrt(2)``." msgstr "" #: ../../shape.rst:629 6e57edd425af46cab1f0544ea9fb09d6 msgid "" "If ``miter_limit`` is exceeded, then all joins with a larger qotient will" " appear as beveled (\"butt\" appearance)." msgstr "" #: ../../shape.rst:631 1b9c88426fad4881993b42f8df4e29ba msgid "" "The default value 1 (and any smaller value) will ensure that all joins " "are rendered as a butt. A value of ``None`` will use the PDF default " "value." msgstr "" #: ../../shape.rst:633 6c5240d22b91424eb8a99f3f6cdd9e61 msgid "Example text showing spikes (``miter_limit=None``):" msgstr "" #: ../../shape.rst:637 22b2f2ab87704749865bf8654f86f486 msgid "Example text suppressing spikes (``miter_limit=1``):" msgstr "" #: ../../shape.rst:643 ef72de748a3241f494828889b778a5c3 msgid "**overlay** (*bool*)" msgstr "**オーバーレイ** （*bool*）" #: ../../shape.rst:645 1a50148614e94b0f9e09a72b981ba540 msgid "Causes the item to appear in foreground (default) or background." msgstr "アイテムを前景（ デフォルト）または背景に表示させます。" #: ../../shape.rst:649 f9c30f5c9a0245e5acbf5d0126b40609 msgid "**morph** (*sequence*)" msgstr "**morph** （*シーケンス*）" #: ../../shape.rst:651 5029b952e1be402ea4aea727b6c5334a msgid "" "Causes \"morphing\" of either a shape, created by the *draw*()* methods, " "or the text inserted by page methods *insert_textbox()* / " "*insert_text()*. If not ``None``, it must be a pair *(fixpoint, matrix)*," " where *fixpoint* is a :ref:`Point` and *matrix* is a :ref:`Matrix`. The " "matrix can be anything except translations, i.e. *matrix.e == matrix.f ==" " 0* must be true. The point is used as a fixed point for the matrix " "operation. For example, if *matrix* is a rotation or scaling, then " "*fixpoint* is its center. Similarly, if *matrix* is a left-right or up-" "down flip, then the mirroring axis will be the vertical, respectively " "horizontal line going through *fixpoint*, etc." msgstr "" "*draw*()* メソッドによって作成されたシェイプまたはページメソッド *insert_textbox（）*/ *insert_text（）*" " によって挿入されたテキストのいずれかの「変形」を引き起こします。 ``None`` でない場合、*（fixpoint、matrix）* " "のペアでなければなりません。ここで、*fixpoint* は :ref:`Point` であり、*matrix* は :ref:`Matrix` " "です。行列は、*matrix.e == matrix.f == 0* " "でない限り、移動以外の任意のものにすることができます。ポイントは、行列操作の固定ポイントとして使用されます。たとえば、*行列* " "が回転またはスケーリングである場合、*fixpoint* はその中心です。同様に、*行列* が左右または上下の反転である場合、鏡像化される軸は " "*fixpoint* を介して通る垂直、または水平の線です。" #: ../../shape.rst:653 b02e3c71c8f64fc68a15b90bf3c129ea msgid "" "Several methods contain checks whether the to be inserted items will " "actually fit into the page (like :meth:`Shape.insert_text`, or " ":meth:`Shape.draw_rect`). For the result of a morphing operation there is" " however no such guaranty: this is entirely the programmer's " "responsibility." msgstr "" "いくつかのメソッドには、ページに挿入されるアイテムが実際に適合するかどうかをチェックする検証が含まれています（:meth:`Shape.insert_text`" " 、または :meth:`Shape.draw_rect` " "など）。変形操作の結果にはそのような保証はありません。これは完全にプログラマーの責任です。" #: ../../shape.rst:657 62281c77ca8f47188d63f20f3712a5b0 msgid "**lineCap (deprecated: \"roundCap\")** (*int*)" msgstr "**lineCap（非推奨：「roundCap」**）（*int*）" #: ../../shape.rst:659 cd5b630baa744b1189ae847e6e8286fd msgid "" "Controls the look of line ends. The default value 0 lets each line end at" " exactly the given coordinate in a sharp edge. A value of 1 adds a semi-" "circle to the ends, whose center is the end point and whose diameter is " "the line width. Value 2 adds a semi-square with an edge length of line " "width and a center of the line end." msgstr "線の末端の外観を制御します。デフォルト値0は、各線の末端が鋭いエッジで正確な座標で終了することを許可します。値1は、末端に直径が線の幅で中心が末端ポイントである半円を追加します。値2は、線の幅と線の末端を中心とする辺の長さがある半正方形を追加します。" #: ../../shape.rst:661 6026a44a326145afa3e7a6f376a1bbf6 msgid "*Changed in version 1.14.15*" msgstr "" #: ../../shape.rst:665 2e6dced4dc3b49d0bfc6d15aba362eba msgid "**lineJoin** (*int*)" msgstr "" #: ../../shape.rst:667 66fbb0a47a7648efa567adac178985a1 msgid "" "*New in version 1.14.15:* Controls the way how line connections look " "like. This may be either as a sharp edge (0), a rounded join (1), or a " "cut-off edge (2, \"butt\")." msgstr "" "*バージョン1.14.15で新規追加：* " "ラインの接続方法を制御します。これは、鋭いエッジ（0）、丸い接続（1）、または切り取られたエッジ（2、「butt」）のいずれかです。" #: ../../shape.rst:671 82bab1c6af0a4d169a36b68529a2ab41 msgid "**closePath** (*bool*)" msgstr "" #: ../../shape.rst:673 991347c321464275b6f78b81a2f89e09 msgid "" "Causes the end point of a drawing to be automatically connected with the " "starting point (by a straight line)." msgstr "描画の終点を自動的に始点に直線で接続させる原因となります。" #: ../../footer.rst:46 703f5e6cdc364cd898823615d897ea50 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "" #~ "a factor to override the line " #~ "height calculated from font properties. " #~ "If not `None`, a line height of" #~ " `fontsize * lineheight` will be " #~ "used. :arg int expandtabs: controls " #~ "handling of tab characters ``\\t`` using" #~ " the `string.expandtabs()` method **per " #~ "each line**." #~ msgstr "" #~ "フォントのプロパティから計算された行の高さをオーバーライドするためのファクター。``None`` でない場合、`fontsize" #~ " * lineheight` の行の高さが使用されます。" #~ msgid "arg int expandtabs" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/story-class.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 5a64c03ac3304767805a34e5519dc643 msgid "Artifex" msgstr "" #: ../../header.rst:-1 987f101ad8fa44c9a85292f456737790 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 937bf2fcb1964c3f97071eb2764745fd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../story-class.rst:7 b33db4381f96455f881c4cb8b48a9239 msgid "Story" msgstr "Story (ストーリー)" #: ../../story-class.rst:11 96383b7b49df4dc69e7545f0a3d37164 msgid "New in v1.21.0" msgstr "バージョン1.21.0で新規追加" #: ../../story-class.rst:14 7d3756e920e1487eb3e1b3bf28ed6f9b msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../story-class.rst:14 51a2ed231a8d4b16a5606ce08ce54e8b msgid "**Short Description**" msgstr "**簡単な説明**" #: ../../story-class.rst:16 65726e39b3794bb9a492d8c5ba15990f msgid ":meth:`Story.reset`" msgstr "" #: ../../story-class.rst:16 d9f0619b632e4bb582c9bbc227d889b5 msgid "\"rewind\" story output to its beginning" msgstr "ストーリーの出力を先頭に巻き戻す" #: ../../story-class.rst:17 7c94ba99f15b4f4d847c8263ca0b5132 msgid ":meth:`Story.place`" msgstr "" #: ../../story-class.rst:17 5ef6af8dda1c4704b193cb14b0e43f33 msgid "compute story content to fit in provided rectangle" msgstr "指定された長方形に収まるストーリーのコンテンツを計算" #: ../../story-class.rst:18 bb0b48f6450441f5a3dd54b788dee19a msgid ":meth:`Story.draw`" msgstr "" #: ../../story-class.rst:18 8570b10f54d345139cfe978f97d8c9b3 msgid "write the computed content to current page" msgstr "計算されたコンテンツを現在のページに書き込む" #: ../../story-class.rst:19 f57f0a347b814e60b8da011ae533e111 msgid ":meth:`Story.element_positions`" msgstr "" #: ../../story-class.rst:19 2e5a11cc2c1c430a878377cd43dbd28c msgid "callback function logging currently processed story content" msgstr "現在処理中のストーリーコンテンツを記録するコールバック関数" #: ../../story-class.rst:20 7d3e1c7cf395410d9a7653dac537daad msgid ":attr:`Story.body`" msgstr "" #: ../../story-class.rst:20 1979b2f75d824d3588dc32499dace02a msgid "the story's underlying :htmlTag:`body`" msgstr "ストーリーの基本となる :htmlTag:`body`" #: ../../story-class.rst:21 7ba33a6d21124637b218ce0b7f3d3ec1 msgid ":meth:`Story.write`" msgstr "" #: ../../story-class.rst:21 757b24965dee4f998578cefcb1a94b35 msgid "places and draws Story to a DocumentWriter" msgstr "ストーリーを :ref:`DocumentWriter` に配置して描画します" #: ../../story-class.rst:22 5005e48c2d114342997d30259781a86d msgid ":meth:`Story.write_stabilized`" msgstr "" #: ../../story-class.rst:22 12712f5deea24c88b77364960c58dbdb msgid "iterative layout of html content to a DocumentWriter" msgstr "HTMLコンテンツを :ref:`DocumentWriter` に反復的にレイアウトします" #: ../../story-class.rst:23 16d33507e0554249ba750773fb5cb53d msgid ":meth:`Story.write_with_links`" msgstr "" #: ../../story-class.rst:23 93c333b6d5f843cf8258a5274dfa22f0 msgid "like `write()` but also creates PDF links" msgstr "`write()` と同様ですが、PDFリンクも作成します" #: ../../story-class.rst:24 25e70986951c4b668e0a1704e2984855 msgid ":meth:`Story.write_stabilized_with_links`" msgstr "" #: ../../story-class.rst:24 2b185135aa8348fb825dded5295a7474 msgid "like `write_stabilized()` but also creates PDF links" msgstr "`write_stabilized()` と同様ですが、PDFリンクも作成します" #: ../../story-class.rst:25 f7ca87bbd93e492587ff63f31dc3d7d5 msgid ":meth:`Story.fit`" msgstr "" #: ../../story-class.rst:25 ../../story-class.rst:252 #: 945d31669d104a67b4251a8a2ed5b133 c2cb9dc7bf694149806fb89443a430ba msgid "Finds optimal rect that contains the story `self`." msgstr "" #: ../../story-class.rst:26 57ee0022377e4fbbaf74f70142af7217 msgid ":meth:`Story.fit_scale`" msgstr "" #: ../../story-class.rst:27 f73eb5fd926e4dc5b66afcbd819851d6 msgid ":meth:`Story.fit_height`" msgstr "" #: ../../story-class.rst:28 c5a858a25f3c4e45adf3c65f77eb35b4 msgid ":meth:`Story.fit_width`" msgstr "" #: ../../story-class.rst:31 555f8dfcf2c6423696e0a8111f5a202f msgid "**Class API**" msgstr "**クラスAPI**" #: ../../story-class.rst:37 834595e0caee413fb07ac0888c96cf9c msgid "" "Create a **story**, optionally providing HTML and CSS source. The HTML is" " parsed, and held within the Story as a DOM (Document Object Model)." msgstr "" "**ストーリー** " "を作成します。オプションでHTMLとCSSのソースを提供できます。HTMLは解析され、ストーリー内でDOM（ドキュメントオブジェクトモデル）として保持されます。" #: ../../story-class.rst:40 d9a1893bb0f14ccf9425ee58f9e72dfc msgid "" "This structure may be modified: content (text, images) may be added, " "copied, modified or removed by using methods of the :ref:`Xml` class." msgstr "この構造は変更できます。テキスト、画像などのコンテンツは、:ref:`Xml` クラスのメソッドを使用して追加、コピー、変更、または削除できます。" #: ../../story-class.rst:43 f0a727b22fb84079ae4095e10e3c2373 msgid "" "When finished, the **story** can be written to any device; in typical " "usage the device may be provided by a :ref:`DocumentWriter` to make new " "pages." msgstr "" "完了したら、**ストーリー** を任意のデバイスに書き込むことができます。通常の使用法では、デバイスは新しいページを生成するために " ":ref:`DocumentWriter` によって提供されます。" #: ../../story-class.rst:46 8bd0a736bc6749f68af7bee1912f8244 msgid "Here are some general remarks:" msgstr "以下は一般的な注意事項です：" #: ../../story-class.rst:48 0f8c24eeaf79495db53a2614e831f91a msgid "" "The :ref:`Story` constructor parses and validates the provided HTML to " "create the DOM." msgstr ":ref:`Story` コンストラクタは提供されたHTMLを解析し、検証してDOMを作成します。" #: ../../story-class.rst:49 a8c9195a3cdf4ea9bc8acd4c4bc70ff2 msgid "" "PyMuPDF provides a number of ways to manipulate the HTML source by " "providing access to the *nodes* of the underlying DOM. Documents can be " "completely built from ground up programmatically, or the existing DOM can" " be modified pretty arbitrarily. For details of this interface, please " "see the :ref:`Xml` class." msgstr "" "PyMuPDFは、基本的なDOMのノードへのアクセスを提供することでHTMLソースを操作する方法をいくつか提供しています。文書は完全にプログラム的に構築することも、既存のDOMをかなり任意に変更することもできます。このインターフェースの詳細については、:ref:`Xml`" " クラスをご覧ください。" #: ../../story-class.rst:54 9a32acd1613e44cd87d2f73e6e3790e4 msgid "" "If no (or no more) changes to the DOM are required, the story is ready to" " be laid out and to be fed to a series of devices (typically devices " "provided by a :ref:`DocumentWriter` to produce new pages)." msgstr "" "DOMへの変更が必要ない（またはもう必要ない）場合、ストーリーはレイアウトが可能であり、新しいページを生成するために通常は " ":ref:`DocumentWriter` によって提供されるデバイスに供給する準備ができています。" #: ../../story-class.rst:57 de9ba211086b47eca447de9b6b5356c1 msgid "" "The next step is to place the story and write it out. This can either be " "done directly, by looping around calling `place()` and `draw()`, or " "alternatively, the looping can handled for you using the `write()` or " "`write_stabilised()` methods. Which method you choose is largely a matter" " of taste." msgstr "" "次のステップは、ストーリーを配置して書き出すことです。これは、直接行うこともできます（`place()` と `draw()` " "を呼び出すことでループ処理することで）、または代替として `write()` または `write_stabilised()` " "メソッドを使用しても、ループ処理を自動化できます。どの方法を選択するかは主に好みの問題です。" #: ../../story-class.rst:63 9615fc9723fb4897a2817bb454bf3149 msgid "To work in the first of these styles, the following loop should be used:" msgstr "最初のスタイルで作業するには、次のループを使用する必要があります：" #: ../../story-class.rst:65 41867b8cd7bb4533b097c4aa2dd1a08e msgid "" "Obtain a suitable device to write to; typically by requesting a new, " "empty page from a :ref:`DocumentWriter`." msgstr "適切なデバイスを取得します。通常、:ref:`DocumentWriter` から新しい空のページを要求することで取得します。" #: ../../story-class.rst:68 6e11ba83740c42a0814219e6c7bb4f2f msgid "" "Determine one or more rectangles on the page, that should receive " "**story** data. Note that not every page needs to have the same set of " "rectangles." msgstr "" "ページ上に **ストーリー** " "データを受け取る必要がある1つまたは複数の長方形を決定します。すべてのページが同じ長方形セットを持つ必要はないことに注意してください。" #: ../../story-class.rst:71 27521b4c124e42ad873a6b98785cc18d msgid "" "Pass each rectangle to the **story** to place it, learning what part of " "that rectangle has been filled, and whether there is more story data that" " did not fit. This step can be repeated several times with adjusted " "rectangles until the caller is happy with the results." msgstr "" "各長方形を **ストーリー** " "に渡して配置し、その長方形のどの部分が埋まったか、また収まらなかったストーリーデータがあるかを学びます。このステップは、調整された長方形で何度も繰り返すことができ、呼び出し元が結果に満足するまで続けることができます。" #: ../../story-class.rst:76 05e07028c7d3438d8b4564f851c3f6dd msgid "" "Optionally, at this point, we can request details of where interesting " "items have been placed, by calling the `element_positions()` method. " "Items are deemed to be interesting if their integer `heading` attribute " "is a non-zero (corresponding to HTML tags :htmlTag:`h1` - :htmlTag:`h6`)," " if their `id` attribute is not `None` (corresponding to HTML tag " ":htmlTag:`id`), or if their `href` attribute is not `None` (responding to" " HTML tag :htmlTag:`href`). This can conveniently be used for automatic " "generation of a Table of Contents, an index of images or the like." msgstr "" "任意で、この段階で `element_positions()` " "メソッドを呼び出して、興味深いアイテムが配置された場所の詳細をリクエストすることができます。アイテムは、整数の `heading` " "属性がゼロでない場合（:htmlTag:`h1` - :htmlTag:`h6`）、id属性がNoneでない場合（:htmlTag:`id` " "に対応）、またはhref属性がNoneでない場合（:htmlTag:`href` " "に対応）に興味深いと見なされます。これは、目次、画像の索引などの自動生成に便利に使用できます。" #: ../../story-class.rst:85 921092efac384debac3b3b54e0888f7f msgid "Next, draw that rectangle out to the device with the `draw()` method." msgstr "次に、`draw()` メソッドを使用してその長方形をデバイスに描画します。" #: ../../story-class.rst:86 d36b5912ed30437198b3cf8b6a589d81 msgid "" "If the most recent call to `place()` indicated that all the story data " "had fitted, stop now." msgstr "最も最近の `place()` の呼び出しが、すべてのストーリーデータが収まったことを示した場合、ここで停止します。" #: ../../story-class.rst:88 c97e2fc9a4d7461f87a1b0a14181de80 msgid "" "Otherwise, we can loop back. If there are more rectangles to be placed on" " the current device (page), we jump back to step 3 - if not, we jump back" " to step 1 to get a new device." msgstr "それ以外の場合、ループを戻すことができます。現在のデバイス（ページ）に配置するためにさらに長方形がある場合は、ステップ3に戻ります。長方形がない場合は、新しいデバイスを取得するためにステップ1に戻ります。" #: ../../story-class.rst:91 58ca39dc2e03443689141076908acc02 msgid "" "Alternatively, in the case where you are using a :ref:`DocumentWriter`, " "the `write()` or `write_stabilized()` methods can be used. These handle " "all the looping for you, in exchange for being provided with callbacks " "that control the behaviour (notably a callback that enumerates the " "rectangles/pages to use)." msgstr "" "代わりに、:ref:`DocumentWriter` を使用している場合、`write()` または `write_stabilized()` " "メソッドを使用できます。これらは、動作を制御するコールバックが提供される代わりに、すべてのループ処理を処理します（特に使用する長方形/ページを列挙するコールバックが含まれます）。" #: ../../story-class.rst:96 d2f8dc8f478942b69038e2d6d08a91fe msgid "" "Which part of the **story** will land on which rectangle / which page, is" " fully under control of the :ref:`Story` object and cannot be predicted." msgstr "" "**ストーリー** オブジェクトがどの部分がどの長方形/ページに配置されるかは、完全に :ref:`Story` " "オブジェクトの制御下にあり、予測することはできません。" #: ../../story-class.rst:98 a231e6de936e448a93e21ff261ff8b39 msgid "" "Images may be part of a **story**. They will be placed together with any " "surrounding text." msgstr "画像は **ストーリー** の一部となる可能性があります。画像は周囲のテキストと一緒に配置されます。" #: ../../story-class.rst:99 10d7d8aa6a1c47998853f3879c904e3a msgid "" "Multiple stories may - independently from each other - write to the same " "page. For example, one may have separate stories for page header, page " "footer, regular text, comment boxes, etc." msgstr "複数のストーリーは、互いに独立して同じページに書き込むことができます。たとえば、ページヘッダー、ページフッター、通常のテキスト、コメントボックスなどの異なるストーリーを持つことができます。" #: ../../story-class.rst 0c16913df99f4028a3870cbbbd910379 #: 104010970e1342a5a900ab45a655ed39 1d65623102054847865dc9b04f9af565 #: 456fb972dc3a4159952dd56ac1654590 47b053df5e8a436b92de3d583ae08f39 #: 4c8c1511d6ca4de3b1ff6c538979f186 6cb09318829e49438c6c48b4681dfc29 #: b0223ffe432744529572c26fc11dab80 c448f77784b245c2b24ce441b2722ea0 #: fe317c7a33064ffea7eca66586243546 msgid "Parameters" msgstr "パラメーター:" #: ../../story-class.rst:103 287c70d5ad0647e88290a1333ac631e0 msgid "" "HTML source code. If omitted, a basic minimum is generated (see below). " "If provided, not a complete HTML document is needed. The in-built source " "parser will forgive (many / most) HTML syntax errors and also accepts " "HTML fragments like `\"Hello, World!\"`." msgstr "" "HTMLソースコード。省略した場合、基本的な最小限のHTMLが生成されます（以下参照）。指定した場合、完全なHTML文書は必要ありません。組み込みのソースパーサは（多くの）HTML構文エラーを許容し、また" " `\"Hello, World!\"` のようなHTMLフラグメントも受け入れます。" #: ../../story-class.rst:108 63178e97fc4246158cbc7062597c4b93 msgid "CSS source code. If provided, must contain valid CSS specifications." msgstr "CSSソースコード。指定する場合、有効なCSS仕様を含む必要があります。" #: ../../story-class.rst:109 0cf5afcd55e544ad8724adfc4be7f3bb msgid "the default text font size." msgstr "デフォルトのテキストフォントサイズ。" #: ../../story-class.rst:110 049536668785410f8df0dbcb3a1feddc msgid "" "an :ref:`Archive` from which to load resources for rendering. Currently " "supported resource types are images and text fonts. If omitted, the story" " will not try to look up any such data and may thus produce incomplete " "output. .. note:: Instead of an actual archive, valid arguments for " "**creating** an :ref:`Archive` can also be provided -- in which case an " "archive will temporarily be constructed. So, instead of `story = " "pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))`, one can also " "shorter write `story = pymupdf.Story(archive=\"myfolder\")`." msgstr "" #: ../../story-class.rst:110 51aa7bb6ca3c42a58819b3c524960306 msgid "" "an :ref:`Archive` from which to load resources for rendering. Currently " "supported resource types are images and text fonts. If omitted, the story" " will not try to look up any such data and may thus produce incomplete " "output." msgstr "" "レンダリングのためのリソースをロードするための :ref:`Archive` " "。現在サポートされているリソースタイプは画像とテキストフォントです。省略した場合、ストーリーはそのようなデータを検索しようとはせず、不完全な出力を生成する可能性があります。" #: ../../story-class.rst:112 a1bdde42988b468c929fe9fb82452451 msgid "" "Instead of an actual archive, valid arguments for **creating** an " ":ref:`Archive` can also be provided -- in which case an archive will " "temporarily be constructed. So, instead of `story = " "pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))`, one can also " "shorter write `story = pymupdf.Story(archive=\"myfolder\")`." msgstr "" "アーカイブの代わりに、:ref:`Archive` を一時的に **構築する** ための有効な引数も提供できます。したがって、`story = " "pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))` の代わりに、`story = " "pymupdf.Story(archive=\"myfolder\")` と短縮して記述することもできます。 " #: ../../story-class.rst:116 e956d2bfd28841d7a04df00b07957e4f msgid "" "Calculate that part of the story's content, that will fit in the provided" " rectangle. The method maintains a pointer which part of the story's " "content has already been written and upon the next invocation resumes " "from that pointer's position." msgstr "ストーリーのコンテンツのうち、指定された長方形に収まる部分を計算します。このメソッドは、ストーリーのコンテンツのどの部分が既に書き込まれたかを示すポインタを維持し、次回の呼び出し時にそのポインタの位置から再開します。" #: ../../story-class.rst:118 dc9976ea8ccc4d79bc216fce83ed6c9d msgid "" "layout the current part of the content to fit into this rectangle. This " "must be a sub-rectangle of the page's :ref:`MediaBox`." msgstr "" "現在のコンテンツをこの長方形に収めるためのレイアウト。これはページの :ref:`MediaBox` " "のサブ長方形でなければなりません。" #: ../../story-class.rst daaea6c19d22421da33214020526af4d msgid "Return type" msgstr "戻り値の型:" #: ../../story-class.rst 954873df303d499d861dc708a54e6c20 msgid "Returns" msgstr "戻り値:" #: ../../story-class.rst:121 4d9be8b010ca4b4b8dcc983949132f37 msgid "" "a bool (int) `more` and a rectangle `filled`. If `more == 0`, all content" " of the story has been written, otherwise more is waiting to be written " "to subsequent rectangles / pages. Rectangle `filled` is the part of " "`where` that has actually been filled." msgstr "" "bool (int) `more` と、実際に `filled` 長方形を返します。`more == 0` " "の場合、ストーリーのすべてのコンテンツが書き込まれたことを意味し、それ以外の場合、`more` " "は次の長方形/ページに書き込むために待機しています。埋められた長方形は実際に埋められた `where` の一部です。" #: ../../story-class.rst:125 a836145f2a5a4a75b589eefba9b24211 msgid "Write the content part prepared by :meth:`Story.place` to the page." msgstr ":meth:`Story.place` によって準備されたコンテンツの一部をページに書き込みます。" #: ../../story-class.rst:127 152149a28a8b49acaaf7bfeadead892c msgid "" "the :ref:`Device` created by `dev = writer.begin_page(mediabox)`. The " "device knows how to call all MuPDF functions needed to write the content." msgstr "" "`dev = writer.begin_page(mediabox)` で作成された " ":ref:`Device`。このデバイスは、コンテンツを書き込むために必要なすべてのMuPDF関数を呼び出す方法を知っています。" #: ../../story-class.rst:128 35b2e7568db140c9abf31a7ee3ef7f54 msgid "" "a matrix for transforming content when writing to the page. An example " "may be writing rotated text. The default means no transformation (i.e. " "the :ref:`Identity` matrix)." msgstr "" "ページに書き込む際にコンテンツを変形させるための行列。テキストを回転させるなどの例が考えられます。デフォルトでは変換は行われず（つまり " ":ref:`Identity` 行列）、コンテンツはそのまま書き込まれます。" #: ../../story-class.rst:132 e9b8bfcac05244199692b5afb6d90ed0 msgid "" "Let the Story provide positioning information about certain HTML elements" " once their place on the current page has been computed - i.e. invoke " "this method **directly after** :meth:`Story.place`." msgstr "" "ストーリーが現在のページ上で特定のHTML要素の配置情報を提供するようにします。つまり、:meth:`Story.place` の **直後に**" " このメソッドを呼び出します。" #: ../../story-class.rst:134 e0021c2f17db417c8976fce48469b736 msgid "" "*Story* will pass position information to *function*. This information " "can for example be used to generate a Table of Contents." msgstr "*Story* は位置情報を *関数* に渡します。この情報は、目次の生成などに便利に使用できます。" #: ../../story-class.rst:136 27a5d6e27ace4870892e746111d4365b msgid "" "a Python function accepting an :class:`ElementPosition` object. It will " "be invoked by the Story object to process positioning information. The " "function **must** be a callable accepting exactly one argument." msgstr "" ":class:`ElementPosition` " "オブジェクトを受け入れるPython関数。この関数は、位置情報を処理するためにStoryオブジェクトによって呼び出されます。**関数** " "は正確に1つの引数を受け入れるcallableである必要があります。" #: ../../story-class.rst:137 08bda4472e0b457faada19c08c19734e msgid "" "an optional dictionary with any **additional** information that should be" " added to the :class:`ElementPosition` instance passed to `function`. " "Like for example the current output page number. Every key in this " "dictionary must be a string that conforms to the rules for a valid Python" " identifier. The complete set of information is explained below." msgstr "" "`function` に渡される :class:`ElementPosition` インスタンスに **追加** " "情報を追加するためのオプションの辞書。たとえば、現在の出力ページ番号などが含まれることがあります。この辞書のすべてのキーは、有効なPython識別子の規則に従う文字列である必要があります。情報の完全なセットは以下で説明されています。" #: ../../story-class.rst:146 98941c7d778c4d34a3d76bb76b5739dc msgid "Rewind the story's document to the beginning for starting over its output." msgstr "ストーリーのドキュメントを最初に戻して、出力を再開します。" #: ../../story-class.rst:150 2eaf3e53d3c34b20bd6b65526619e383 msgid "" "The :htmlTag:`body` part of the story's DOM. This attribute contains the " ":ref:`Xml` node of :htmlTag:`body`. All relevant content for PDF " "production is contained between \"\" and \"\"." msgstr "" "ストーリーのDOMの :htmlTag:`body` 部分。この属性には :htmlTag:`body` の :ref:`Xml` " "ノードが含まれています。PDFの制作に関連するすべてのコンテンツは、「」と「」の間に含まれています。" #: ../../story-class.rst:154 09a8579966ad4dd69d832b7cff35811b msgid "" "Places and draws Story to a `DocumentWriter`. Avoids the need for calling" " code to implement a loop that calls `Story.place()` and `Story.draw()` " "etc, at the expense of having to provide at least the `rectfn()` " "callback." msgstr "" "Storyを :ref:`DocumentWriter` に配置し、描画します。これにより、`Story.place()` および " "`Story.draw()` などを呼び出すループの実装が不要になりますが、`rectfn()` コールバックを少なくとも提供する必要があります。" #: ../../story-class.rst:159 5194586e662141618935bdf29a379921 msgid "a `DocumentWriter` or None." msgstr ":ref:`DocumentWriter` または `None`。" #: ../../story-class.rst:160 d62e010560f14bf1b7cd210ebf78b20c #, fuzzy msgid "" "a callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: " "The next rect into which content should be placed. * ctm: None or a " "`Matrix`." msgstr "" "`(rect_num: int, filled: Rect)` を取り、`(mediabox, rect, ctm)` " "を返すcallable：mediabox" #: ../../story-class.rst:160 ae5c5dc080b540f09ad256f10c2cf83d msgid "" "a callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`:" msgstr "`(rect_num: int, filled: Rect)` を取り、`(mediabox, rect, ctm)` を返すcallable：" #: ../../story-class.rst:163 ../../story-class.rst:204 #: 193ce6bab9f74a3a9cf1bbeaf3b2dc88 991faab1db1a4e479714af5b2e511e0e #, fuzzy msgid "mediabox: None or rect for new page." msgstr "新しいページ用の `None` またはrect。" #: ../../story-class.rst:164 ../../story-class.rst:205 #: 2c523120813f4975b82ffb2efb008126 cbe16d25e8e24253b41d04316f0700a3 #, fuzzy msgid "rect: The next rect into which content should be placed." msgstr "コンテンツを配置する次の矩形。" #: ../../story-class.rst:165 6068e757476744c2a2008edf19b650a1 #, fuzzy msgid "ctm: None or a `Matrix`." msgstr "`None` または `Matrix`。" #: ../../story-class.rst:166 54470f3ad61e4531aca719c848ecebb4 msgid "" "None, or a callable taking `(position: ElementPosition)`: * position:" " An `ElementPosition` with an extra `.page_num` member. Typically " "called multiple times as we generate elements that are headings or have " "an id." msgstr "" #: ../../story-class.rst:166 0c1e37384309449d8a3f1aa31612af12 #, fuzzy msgid "None, or a callable taking `(position: ElementPosition)`:" msgstr "" "`None` または(ElementPosition)を取り、`(position: ElementPosition)`: " "positionを返すcallable：" #: ../../story-class.rst:168 78f15911e52b455d87f6517e46edf76d msgid "position:" msgstr "" #: ../../story-class.rst:169 8ba40e35c2734c1d8c5eb72cc71c82f4 msgid "An `ElementPosition` with an extra `.page_num` member." msgstr "`.page_num` メンバーを持つ `ElementPosition`。" #: ../../story-class.rst:170 9d3b6f846744442c8f1ebd5c03e1a944 msgid "" "Typically called multiple times as we generate elements that are headings" " or have an id." msgstr "通常、見出しやIDを持つ要素を生成する際に複数回呼び出されます。" #: ../../story-class.rst:172 0d6deb6dd4d9405ab38dff88ad1fc98f msgid "" "None, or a callable taking `(page_num, mediabox, dev, after)`; called at " "start (`after=0`) and end (`after=1`) of each page." msgstr "" "`None` または `(page_num, mediabox, dev, after)` " "を取り、各ページの開始(`after=0`)および終了（`after=1`）時に呼び出されます。" #: ../../story-class.rst:178 a79665d597fb416d960734c83cfd6657 msgid "" "Static method that does iterative layout of html content to a " "`DocumentWriter`." msgstr "htmlコンテンツを :ref:`DocumentWriter` に対して反復的にレイアウトするための静的メソッド。" #: ../../story-class.rst:181 6fc706ddf1b648e68d59f87ae642ba3d msgid "" "For example this allows one to add a table of contents section while " "ensuring that page numbers are patched up until stable." msgstr "これにより、ページ番号が安定するまで目次セクションを追加したりすることができます。" #: ../../story-class.rst:184 624160a14d984361bd0974171f55c924 msgid "" "Repeatedly creates a new `Story` from `(contentfn(), user_css, em, " "archive)` and lays it out with internal call to `Story.write()`; uses a " "None writer and extracts the list of `ElementPosition`'s which is passed " "to the next call of `contentfn()`." msgstr "" "`(contentfn()、user_css、em、archive)` から新しい `Story` " "を繰り返し作成し、`Story.write()` への内部呼び出しでそれをレイアウトします。 `None` " "のライターを使用し、`ElementPosition` のリストを次回の `contentfn()` 呼び出しに渡します。" #: ../../story-class.rst:190 4b831cab0cb845b08bcd23293dfacaff msgid "" "When the html from `contentfn()` becomes unchanged, we do a final " "iteration using `writer`." msgstr "`contentfn()` からのhtmlが変更されなくなると、`writer` を使用して最終的な反復処理を行います。" #: ../../story-class.rst:193 fc2b4f5717ce43d49be5f534a63440f9 msgid "A `DocumentWriter`." msgstr ":ref:`DocumentWriter`。" #: ../../story-class.rst:195 8156be2fda8e4081b5e9447ab8e0e84f msgid "" "A function taking a list of `ElementPositions` and returning a string " "containing html. The returned html can depend on the list of positions, " "for example with a table of contents near the start." msgstr "" "`ElementPositions` " "のリストを取り、htmlを含む文字列を返す関数。返されるhtmlは、位置のリストに依存する場合があります。たとえば、最初の近くに目次がある場合です。" #: ../../story-class.rst:200 f67b52fd424e4dc68961c8310fcaa746 #, fuzzy msgid "" "A callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: " "The next rect into which content should be placed. * ctm: A `Matrix`." msgstr "" "`(rect_num: int, filled: Rect)` を取り、`(mediabox, rect, ctm)` " "を返すcallable：mediabox" #: ../../story-class.rst:201 2619bfc1a11c4ae089bce95a0a0b388f msgid "" "A callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`:" msgstr "" #: ../../story-class.rst:206 893cb8063b414afaaced0a0058f0d3ab #, fuzzy msgid "ctm: A `Matrix`." msgstr ":ref:`Matrix`。" #: ../../story-class.rst:207 fa079791f265424f89482cae4560278b msgid "" "None, or a callable taking `(page_num, medibox, dev, after)`; called at " "start (`after=0`) and end (`after=1`) of each page." msgstr "" "`None` または `(page_num、medibox、dev、after)` " "を取り、各ページの開始（`after=0`）および終了（`after=1`）時に呼び出されます。" #: ../../story-class.rst:212 1f50bce4bc934df3b5d624e1b672e8a7 msgid "" "If true, we add unique ids to all header tags that don't already have an " "id. This can help automatic generation of tables of contents." msgstr "Trueの場合、idを持たないすべての見出しタグに一意のidを追加します。これは目次の自動生成に役立ちます" #: ../../story-class.rst:216 4d3d89f8a84e4ddca5b6f49a19e7360f msgid "Returns:" msgstr "" #: ../../story-class.rst:217 67ed7ea6343840ce8ca2af472e723907 msgid "None." msgstr "" #: ../../story-class.rst:221 dc5ef0f369b64b56a861bebe37e7d740 msgid "" "Similar to `write()` except that we don't have a `writer` arg and we " "return a PDF `Document` in which links have been created for each " "internal html link." msgstr "" "`write()` に類似していますが、`writer` 引数がなく、内部のHTMLリンクごとにリンクが作成されたPDF `Document` " "が返されます。" #: ../../story-class.rst:227 f60fb57103404e4487a18f27456b9ac5 msgid "" "Similar to `write_stabilized()` except that we don't have a `writer` arg " "and instead return a PDF `Document` in which links have been created for " "each internal html link." msgstr "" "`write_stabilized()` に類似していますが、`writer` " "引数がなく、代わりに各内部のHTMLリンクにリンクが作成されたPDF `Document` が返されます。" #: ../../story-class.rst:233 06abc8ee0cef4e4998719c4d3848c318 msgid "The result from a `Story.fit*()` method." msgstr "" #: ../../story-class.rst:235 f882cf97ed5e42b69f1212bd5c0d3b3e msgid "Members:" msgstr "" #: ../../story-class.rst:237 05afdcff48b54e87a70244ac485320f6 msgid "`big_enough`:" msgstr "" #: ../../story-class.rst:238 296c3d062bc34a2f9826b3fe722423ed msgid "`True` if the fit succeeded." msgstr "" #: ../../story-class.rst:239 910160ef882e49209e123946968ad89d msgid "`filled`:" msgstr "" #: ../../story-class.rst:240 2be02fcee76042b3b1e67242108c02d8 msgid "From the last call to `Story.place()`." msgstr "" #: ../../story-class.rst:241 7f3007c064224426bdeffe2f30577d5a msgid "`more`:" msgstr "" #: ../../story-class.rst:242 14d98da06ba44fadacc3c05f8c88d916 msgid "`False` if the fit succeeded." msgstr "" #: ../../story-class.rst:243 bea5727ffc6f4a0f9b4816919098061b msgid "`numcalls`:" msgstr "" #: ../../story-class.rst:244 508bd595de3a4b6a87cf8cece9b67d36 msgid "Number of calls made to `self.place()`." msgstr "" #: ../../story-class.rst:245 0c4225d297644946b97fffd257cb3149 #, fuzzy msgid "`parameter`:" msgstr "パラメーター:" #: ../../story-class.rst:246 a38a79d488cc413583a588ace44bad64 msgid "The successful parameter value, or the largest failing value." msgstr "" #: ../../story-class.rst:247 e5e7d478999f4d3aa75cc2e4a0bf8ed2 msgid "`rect`:" msgstr "" #: ../../story-class.rst:248 865655b3648b49e19a5b3683d5ac952c msgid "The rect created from `parameter`." msgstr "" #: ../../story-class.rst:254 ../../story-class.rst:282 #: ../../story-class.rst:304 ../../story-class.rst:325 #: 13889911bf6e4b4099ac3db022c63ba7 181f41eeee2248529bcc9f4180a0fd2f #: 2a70154984d84fde9207702c6951f227 833e95a45bf24525a22b1bf7caedcfd7 msgid "Returns a `Story.FitResult` instance." msgstr "" #: ../../story-class.rst:256 9f2d407c6f7447a384ccc54acb6bbb6d msgid "" "On success, the last call to `self.place()` will have been with the " "returned rectangle, so `self.draw()` can be used directly." msgstr "" #: ../../story-class.rst:259 723d3c893ffb40979529d0c13998947c msgid "" "A callable taking a floating point `parameter` and returning a " "`pymupdf.Rect()`. If the rect is empty, we assume the story will not fit " "and do not call `self.place()`. Must guarantee that `self.place()` " "behaves monotonically when given rect `fn(parameter`) as `parameter` " "increases. This usually means that both width and height increase or stay" " unchanged as `parameter` increases." msgstr "" #: ../../story-class.rst:260 9507ed4935a0463eb2d74e2300c6e45c msgid "" "A callable taking a floating point `parameter` and returning a " "`pymupdf.Rect()`. If the rect is empty, we assume the story will not fit " "and do not call `self.place()`." msgstr "" #: ../../story-class.rst:264 b8b210f2827f4137a23a52bb43be5a7d msgid "" "Must guarantee that `self.place()` behaves monotonically when given rect " "`fn(parameter`) as `parameter` increases. This usually means that both " "width and height increase or stay unchanged as `parameter` increases." msgstr "" #: ../../story-class.rst:268 a4dba85757184a2f88067b0d0bc2a5ac msgid "Minimum parameter to consider; `None` for -infinity." msgstr "" #: ../../story-class.rst:270 c3041af96355455e9dd9c1d8b9001d02 msgid "Maximum parameter to consider; `None` for +infinity." msgstr "" #: ../../story-class.rst:272 50ba04ced3904450bbb765d580667a8a msgid "Maximum error in returned `parameter`." msgstr "" #: ../../story-class.rst:274 ../../story-class.rst:295 #: ../../story-class.rst:317 ../../story-class.rst:338 #: 4560cdaee7304e68af9c9515d9baeeab 853d4b4eccc64445b4dadae224277597 #: 9a97ca12c0fd4e4cad25cd646c9fd3a1 c27eb2778a574ddd9cdbb5da9e952da1 msgid "If true we output diagnostics." msgstr "" #: ../../story-class.rst:279 4dca0fa3d9dc4d74a72be9a25b3042f5 msgid "" "Finds smallest value `scale` in range `scale_min..scale_max` where `scale" " * rect` is large enough to contain the story `self`." msgstr "" #: ../../story-class.rst:284 ../../story-class.rst:306 #: 3e56c24499df4c63acde4cd29372549c c1836f4303104884b7f75d1c7d7f4c18 msgid "width of rect." msgstr "" #: ../../story-class.rst:286 ../../story-class.rst:327 #: 599c4470f82444f093e40776f0fc3088 d107736639a3470a838f7ae926a0c493 msgid "height of rect." msgstr "" #: ../../story-class.rst:288 192ebb0b7d2c4255ae07cda187e1c04a msgid "Minimum scale to consider; must be >= 0." msgstr "" #: ../../story-class.rst:290 9becc562a2894913ac6b78b33fa618a8 msgid "Maximum scale to consider, must be >= scale_min or `None` for infinite." msgstr "" #: ../../story-class.rst:293 b80e9c9c5a024ab9b415c43f695db382 msgid "Maximum error in returned scale." msgstr "" #: ../../story-class.rst:300 20b042fb975b4ef38c6a275f58290800 msgid "" "Finds smallest height in range `height_min..height_max` where a rect with" " size `(width, height)` is large enough to contain the story `self`." msgstr "" #: ../../story-class.rst:308 de3278b094bd4069a6ade29bab864b2e msgid "Minimum height to consider; must be >= 0." msgstr "" #: ../../story-class.rst:310 d890a80ccfbc4767b155bf963080574b msgid "Maximum height to consider, must be >= height_min or `None` for infinite." msgstr "" #: ../../story-class.rst:313 ../../story-class.rst:334 #: 345fc763c90942b3af9314cb53d3635c fb1f9d71eaf340dfb2d14dff3ccbaf8d msgid "`(x0, y0)` of rect." msgstr "" #: ../../story-class.rst:315 05ba2969245642aa9c5df4b5faa1c1c7 msgid "Maximum error in returned height." msgstr "" #: ../../story-class.rst:322 2c063f96e3d24728acc052323d414f48 msgid "" "Finds smallest width in range `width_min..width_max` where a rect with " "size `(width, height)` is large enough to contain the story `self`." msgstr "" #: ../../story-class.rst:329 755a76f8bcad4f9c9b17627fb2dd2b92 msgid "Minimum width to consider; must be >= 0." msgstr "" #: ../../story-class.rst:331 4a9bc91b4df64e0aae622c2fc204c366 msgid "Maximum width to consider, must be >= width_min or `None` for infinite." msgstr "" #: ../../story-class.rst:336 a4d66b18a35f42759e36401ac18b5919 msgid "Maximum error in returned width." msgstr "" #: ../../story-class.rst:343 d2d8c9c232984e92ab30e2dc905f7f7a msgid "Element Positioning CallBack function" msgstr "要素位置コールバック関数" #: ../../story-class.rst:345 a81639ecc64041979b5a57ccef510f75 msgid "" "The callback function can be used to log information about story output. " "The function's access to the information is read-only: it has no way to " "influence the story's output." msgstr "コールバック関数は、ストーリーの出力に関する情報を記録するために使用できます。この関数は情報への読み取り専用アクセスを持ち、ストーリーの出力に影響を与える方法はありません。" #: ../../story-class.rst:347 d63a34b1197048c0a8e7128565d99b11 msgid "" "A typical loop for executing a story with using this method would look " "like this::" msgstr "このメソッドを使用してストーリーを実行する典型的なループは次のようになります:" #: ../../story-class.rst:379 022c24b9ecb142e4b995435e43d0abba msgid "Attributes of the ElementPosition class" msgstr "ElementPosition クラスの属性" #: ../../story-class.rst:380 eb9fd926dd144458ad966437c52bc9b3 msgid "" "Exactly one parameter must be passed to the function provided by " ":meth:`Story.element_positions`. It is an object with the following " "attributes:" msgstr ":meth:`Story.element_positions` で提供される関数に渡すパラメータは、次の属性を持つオブジェクトである必要があります。" #: ../../story-class.rst:382 51f35390ddf549c49309c8e41b08fc0d msgid "" "The parameter passed to the `recorder` function is an object with the " "following attributes:" msgstr "`recorder` 関数に渡されるパラメータは、次の属性を持つオブジェクトです。" #: ../../story-class.rst:384 ea7a7e801d004da2946b291daf693c79 msgid "`elpos.depth` (int) -- depth of this element in the box structure." msgstr "`elpos.depth` （int）– ボックス構造内でのこの要素の深さ。" #: ../../story-class.rst:386 eedd651708ad4d08ab6358db8492fe86 msgid "" "`elpos.heading` (int) -- the header level, 0 if no header, 1-6 for " ":htmlTag:`h1` - :htmlTag:`h6`." msgstr "" "`elpos.heading` （int）– ヘッダーレベル、ヘッダーがない場合は0、 :htmlTag:`h1` - :htmlTag:`h6`" " に対して1-6。" #: ../../story-class.rst:388 58c1d6c18dbc4defa9fdccf70fb9f5a1 #, fuzzy msgid "" "`elpos.href` (str) -- value of the `href` attribute, or None if not " "defined." msgstr "`elpos.href` （str）– `href` 属性の値、または未定義の場合は `None`。" #: ../../story-class.rst:390 085ae77bd6a0482e9bfed8909e66cc63 msgid "`elpos.id` (str) -- value of the `id` attribute, or None if not defined." msgstr "`elpos.id` （str）– `id` 属性の値、または未定義の場合は `None`。" #: ../../story-class.rst:392 6148773811f84de3837f6e84482b5a6f msgid "`elpos.rect` (tuple) -- element position on page." msgstr "`elpos.rect` （tuple）– ページ上の要素の位置。" #: ../../story-class.rst:394 e46b041d8944429f8ec58070b71170c3 msgid "`elpos.text` (str) -- immediate text of the element." msgstr "`elpos.text` （str）– 要素の直接のテキスト。" #: ../../story-class.rst:396 10ae79dfd5114378b05c394821db2139 msgid "" "`elpos.open_close` (int bit field) -- bit 0 set: opens element, bit 1 " "set: closes element. Relevant for elements that may contain other " "elements and thus may not immediately be closed after being created / " "opened." msgstr "" "`elpos.open_close` （int ビットフィールド）– " "ビット0がセットされている場合、要素を開く。ビット1がセットされている場合、要素を閉じる。他の要素を含む可能性がある要素に対して、即座に作成/開始された後にすぐに閉じられない要素に関連します。" #: ../../story-class.rst:398 d06166cffa24405cbbc118345b121dc7 msgid "`elpos.rect_num` (int) -- count of rectangles filled by the story so far." msgstr "`elpos.rect_num` （int）– これまでにストーリーで埋められた長方形の数。" #: ../../story-class.rst:400 1559da9c2ea247b99415efc378836399 msgid "" "`elpos.page_num` (int) -- page number; only present when using " "`pymupdf.Story.write*()` functions." msgstr "`elpos.page_num` （int）– ページ番号。`pymupdf.Story.write*()` 関数を使用する場合にのみ存在します。" #: ../../footer.rst:60 c25ec66bf75249a58ca8ecc2e8d0184a msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "a callable taking `(rect_num: int, " #~ "filled: Rect)` and returning `(mediabox, " #~ "rect, ctm)`: mediabox: None or " #~ "rect for new page. rect: The" #~ " next rect into which content should" #~ " be placed. ctm: None or " #~ "a `Matrix`." #~ msgstr "" #~ msgid "mediabox:" #~ msgstr "" #~ msgid "rect:" #~ msgstr "" #~ msgid "ctm:" #~ msgstr "" #~ msgid "" #~ "None, or a callable taking `(position:" #~ " ElementPosition)`: position: An " #~ "`ElementPosition` with an extra `.page_num`" #~ " member. Typically called multiple times" #~ " as we generate elements that are " #~ "headings or have an id." #~ msgstr "" #~ msgid "." #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/supported-files-table.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-12-21 13:53+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ja/LC_MESSAGES/textpage.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a689d6f014ae4b3e996f4ea1430fd7e2 msgid "Artifex" msgstr "" #: ../../header.rst:-1 fcaf663acdd64264ba54a9b09a7a053d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 2384969b3a1a48ecb481ced21413e4ab msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../textpage.rst:7 b50883dcbbd2424db737f428b4204dc7 msgid "TextPage" msgstr "TextPage (テキストページ)" #: ../../textpage.rst:9 6e81bba1ccf7481d8fc21ba0651cd715 msgid "" "This class represents text and images shown on a document page. All " ":ref:`MuPDF document types` are supported." msgstr "" "このクラスは、文書ページに表示されるテキストと画像を表します。すべての :ref:`MuPDF document " "types` がサポートされています。" #: ../../textpage.rst:11 214a6f0b55b94183bb1a4fee5b003e96 msgid "" "The usual ways to create a textpage are :meth:`DisplayList.get_textpage` " "and :meth:`Page.get_textpage`. Because there is a limited set of methods " "in this class, there exist wrappers in :ref:`Page` which are handier to " "use. The last column of this table shows these corresponding :ref:`Page` " "methods." msgstr "" "テキストページを作成する通常の方法は、:meth:`DisplayList.get_textpage` および " ":meth:`Page.get_textpage` です。このクラスにはメソッドのセットが制限されているため、:ref:`Page` " "内にはより使いやすいラッパーが存在します。この表の最後の列には、対応する :ref:`Page` メソッドが示されています。" #: ../../textpage.rst:13 8974c23cb16b4aa1b56189eff275c6fe msgid "For a description of what this class is all about, see Appendix 2." msgstr "このクラスに関する詳細な説明については、付録2を参照してください。" #: ../../textpage.rst:16 a2ef271a41f24f089f82cb6c12de5544 msgid "**Method**" msgstr "**メソッド**" #: ../../textpage.rst:16 5b00ef707e3f4637b40a48d5d422e544 msgid "**Description**" msgstr "**説明**" #: ../../textpage.rst:16 c508a7963cbb4c77ab691615841f72fb msgid "page get_text or search method" msgstr "page get_textまたはsearchメソッド" #: ../../textpage.rst:18 24790f911d6d4af491f3f0d4a90c5e4e msgid ":meth:`~.extractText`" msgstr "" #: ../../textpage.rst:18 56f3e18347124df290f5bb60a9c6ab6f msgid "extract plain text" msgstr "プレーンテキストを抽出します" #: ../../textpage.rst:18 ../../textpage.rst:19 292888a082e041b8820ab5b47243fa82 #: 587fc832f8b941329c209fc49dd67b0b msgid "\"text\"" msgstr "" #: ../../textpage.rst:19 062786889a8a4ad586cea1bcbfa2bb0d msgid ":meth:`~.extractTEXT`" msgstr "" #: ../../textpage.rst:19 e0b7b72c38c746a4b7c512c66b738f1c msgid "synonym of previous" msgstr "前述の同義語" #: ../../textpage.rst:20 98ed5aa1b9884de7858b147ee2bd2f0c msgid ":meth:`~.extractBLOCKS`" msgstr "" #: ../../textpage.rst:20 35f208a1af3c4c5c8f17069788e702ca msgid "plain text grouped in blocks" msgstr "ブロックにグループ化されたプレーンテキスト" #: ../../textpage.rst:20 6318f67c8f964981b4a354142092e102 msgid "\"blocks\"" msgstr "" #: ../../textpage.rst:21 07a1408ddaf24b158ac6dc5d9fcc8115 msgid ":meth:`~.extractWORDS`" msgstr "" #: ../../textpage.rst:21 52e0458f76ee4231a07829bb051b29ac msgid "all words with their bbox" msgstr "すべての単語とそのバウンディングボックス" #: ../../textpage.rst:21 2efe7bf211e74dc4a731d81393a6e10c msgid "\"words\"" msgstr "" #: ../../textpage.rst:22 7c9da76988c243e0b79a0f2a5c23cee7 msgid ":meth:`~.extractHTML`" msgstr "" #: ../../textpage.rst:22 269dcb92057443e096b0cd366dd7ba29 msgid "page content in HTML format" msgstr "HTML形式のページコンテンツ" #: ../../textpage.rst:22 d24ee0e44d5c45e59f125aacaccf3465 msgid "\"html\"" msgstr "" #: ../../textpage.rst:23 388abf5016ba455c959cdd56009a4499 msgid ":meth:`~.extractXHTML`" msgstr "" #: ../../textpage.rst:23 b09f5acedceb4611bc7ea51121eb9bb2 msgid "page content in XHTML format" msgstr "XHTML形式のページコンテンツ" #: ../../textpage.rst:23 416a7019408e492da02693ffd6949a7a msgid "\"xhtml\"" msgstr "" #: ../../textpage.rst:24 ee85d9810eff41caa760d9ffb2a4fed2 msgid ":meth:`~.extractXML`" msgstr "" #: ../../textpage.rst:24 8ab1b023d2cc42b6ae74cb3b92b8d797 msgid "page text in XML format" msgstr "XML形式のページテキスト" #: ../../textpage.rst:24 fd3d4026c2c045b6a5dc724cd3c1cd16 msgid "\"xml\"" msgstr "" #: ../../textpage.rst:25 a0d67d42d20d483ba2dc7c60232c4262 msgid ":meth:`~.extractDICT`" msgstr "" #: ../../textpage.rst:25 ../../textpage.rst:27 1867105a7ef841cd809711e47e335c93 #: 8cfc8dba8d384e489e2948bcbd7adaca msgid "page content in *dict* format" msgstr "*辞書* 形式のページコンテンツ" #: ../../textpage.rst:25 8159466e656146a38f47f43f6bdcb810 msgid "\"dict\"" msgstr "" #: ../../textpage.rst:26 1d75b88f1edb442898ea8017de3492d7 msgid ":meth:`~.extractJSON`" msgstr "" #: ../../textpage.rst:26 ../../textpage.rst:28 7480fba67d534ecc8956acf7902d5aed #: 82d01a9dbb1d488198ecd836fed442ff msgid "page content in JSON format" msgstr "JSON形式のページコンテンツ" #: ../../textpage.rst:26 78d2d0b851b240db8420aa1f8c823676 msgid "\"json\"" msgstr "" #: ../../textpage.rst:27 1ade4b09c9674544bb58977574f5d593 msgid ":meth:`~.extractRAWDICT`" msgstr "" #: ../../textpage.rst:27 3155e2902bcd4713aa47e4919ec46081 msgid "\"rawdict\"" msgstr "" #: ../../textpage.rst:28 b5f0e031790f497694abb5caa6eee204 msgid ":meth:`~.extractRAWJSON`" msgstr "" #: ../../textpage.rst:28 9b7e2e49823242bf83ea6a25986488d0 msgid "\"rawjson\"" msgstr "" #: ../../textpage.rst:29 c2c9458e9c4a490087a519b61ecc5b19 msgid ":meth:`~.search`" msgstr "" #: ../../textpage.rst:29 ee8c8a71aa524335969fbb8af60b211e msgid "Search for a string in the page" msgstr "ページ内の文字列を検索します" #: ../../textpage.rst:29 f79465ca7ff14a0a80fc365911c70bf6 msgid ":meth:`Page.search_for`" msgstr "" #: ../../textpage.rst:32 083eef252c154937ae0bc85aa81aff68 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../textpage.rst:40 f33111b086ad4d72980c782edd305dd0 msgid "" "Return a string of the page's complete text. The text is UTF-8 unicode " "and in the same sequence as specified at the time of document creation." msgstr "ページの完全なテキストの文字列を返します。テキストはUTF-8ユニコードで、文書作成時に指定された順序と同じです。" #: ../../textpage.rst 3e9d1669f2fe4f15ab3177563f0420e3 #: 4bd4b9fa21ed426188fe213d2241f4ac 720def9977a743fdb77d7caeb93f8e63 #: aea747bd7d624e70bc7def00d62df838 ca24753a6b21474daba199227cbdb7cd #: d0072bc05d7144aca56767bfde82c6a9 e1647eb182054d70be24b2cc9c6381ca msgid "Parameters" msgstr "" #: ../../textpage.rst:42 ../../textpage.rst:85 ../../textpage.rst:93 #: ../../textpage.rst:113 ../../textpage.rst:121 #: 053cd209c0cd44b08367efe95d323dcb 2e3408186db64af29672df98a2541c3a #: 88f4b7d0b3014f8ab6a88c7157c764d9 eafc202f0101431bbd82bb8f066f24c2 #: f7da0622405347bcb10099abdba152a3 msgid "" "(new in v1.19.1) sort the output by vertical, then horizontal " "coordinates. In many cases, this should suffice to generate a \"natural\"" " reading order." msgstr "" #: ../../textpage.rst 07f5f0a7fa5f4efbb1093cd496e1425a #: 0f27872a10dd46fda6c8e7ecaf77c92b 34621dc4778249c49fbd4c5f8fd2fd39 #: 4c8745e920b8430fadff84a8e977a147 5081234f6b32451d915cc94583c1d60e #: 9a9a5268dcfc421cb4ca9b69e5030ee1 9f3241fa28914e49a481723379042cd8 #: c0b2e445162446e1b4a2e0eb834ac7ca f3b8d685f26e44edbe5e23bac745020d #: f63537f76faf47c884089748bdcbcd8b f8803c61a6fc41fe89a08237112d6d49 msgid "Return type" msgstr "" #: ../../textpage.rst:49 63307d556a584ea19173a54596c7f880 msgid "" "Textpage content as a list of text lines grouped by block. Each list " "items looks like this::" msgstr "テキストページの内容を、ブロックごとにグループ化されたテキスト行のリストとして返します。各リストアイテムは次のようになります::" #: ../../textpage.rst:53 78718be495234f9dbfa93e48e16d1e13 msgid "" "The first four entries are the block's bbox coordinates, *block_type* is " "1 for an image block, 0 for text. *block_no* is the block sequence " "number. Multiple text lines are joined via line breaks." msgstr "" "最初の4つのエントリはブロックのbbox座標で、*ブblock_type* は画像ブロックの場合は1、テキストの場合は0です。*block_no*" " はブロックのシーケンス番号です。複数のテキスト行は改行で結合されます。" #: ../../textpage.rst:55 12f402e2e12346f8b7dd871f590f3197 msgid "" "For an image block, its bbox and a text line with some image meta " "information is included -- **not the image content**." msgstr "画像ブロックの場合、そのbboxと画像メタ情報を含むテキスト行が含まれますが、**画像の内容は含まれません**。" #: ../../textpage.rst:57 fb2f6c324124423bb74dbd2e4b974806 msgid "" "This is a high-speed method with just enough information to output plain " "text in desired reading sequence." msgstr "これは、必要な読み取り順序でプレーンテキストを出力するのに十分な情報を持つ高速なメソッドです。" #: ../../textpage.rst:63 cfb05f044359435fb061d158cb6ef21e msgid "Changed in v1.23.5: added `delimiters` parameter" msgstr "" #: ../../textpage.rst:65 e3116b1baa374ce2b67b6002aaae107d msgid "" "Textpage content as a list of single words with bbox information. An item" " of this list looks like this::" msgstr "テキストページの内容を、bbox情報を持つ単語のリストとして返します。このリストのアイテムは次のようになります::" #: ../../textpage.rst:69 6f56fac0469e45afa313a96110815e53 msgid "" "(new in v1.23.5) use these characters as *additional* word separators. By" " default, all white spaces (including the non-breaking space `0xA0`) " "indicate start and end of a word. Now you can specify more characters " "causing this. For instance, the default will return " "`\"john.doe@outlook.com\"` as **one** word. If you specify " "`delimiters=\"@.\"` then the **four** words `\"john\"`, `\"doe\"`, " "`\"outlook\"`, `\"com\"` will be returned. Other possible uses include " "ignoring punctuation characters `delimiters=string.punctuation`. The " "\"word\" strings will not contain any delimiting character." msgstr "" #: ../../textpage.rst:71 f122cb9dbcfb43fb8cd911d4aabb4817 #, fuzzy msgid "" "This is a high-speed method which e.g. allows extracting text from within" " given areas or recovering the text reading sequence." msgstr "" "スペースで区切られたすべてが *「単語」* " "として扱われます。これは、指定された領域内からテキストを抽出したり、テキストの読み取り順序を復元したりするのに適した高速なメソッドです。" #: ../../textpage.rst:77 9fd59d1b4ce240e7ab72d24d4bfe0b1d msgid "" "Textpage content as a string in HTML format. This version contains " "complete formatting and positioning information. Images are included " "(encoded as base64 strings). You need an HTML package to interpret the " "output in Python. Your internet browser should be able to adequately " "display this information, but see :ref:`HTMLQuality`." msgstr "" "HTML形式の文字列としてのテキストページの内容を返します。このバージョンには完全なフォーマットと位置情報が含まれています。画像も含まれており（base64文字列としてエンコードされています）、Pythonで出力を解釈するためにはHTMLパッケージが必要です。インターネットブラウザはこの情報を適切に表示できるはずですが、:ref:`HTMLQuality`" " を参照してください。" #: ../../textpage.rst:83 a07e225c4bf3412585128a2fb86b8200 msgid "" "Textpage content as a Python dictionary. Provides same information detail" " as HTML. See below for the structure." msgstr "TextPageの内容をPythonの辞書として取得します。HTMLと同じ情報の詳細を提供します。構造については以下を参照してください。" #: ../../textpage.rst:91 3c7dcaacfe924c9ab076958b43f75600 msgid "" "Textpage content as a JSON string. Created by " "`json.dumps(TextPage.extractDICT())`. It is included for backlevel " "compatibility. You will probably use this method ever only for outputting" " the result to some file. The method detects binary image data and " "converts them to base64 encoded strings." msgstr "" "TextPageの内容をJSON形式の文字列として取得します。`json.dumps(TextPage.extractDICT())` " "によって作成されます。これは過去の互換性のために含まれています。おそらく、結果をファイルに出力する際にのみこのメソッドを使用するでしょう。このメソッドはバイナリ画像データを検出し、それらをBase64エンコードされた文字列に変換します。" #: ../../textpage.rst:99 87f36a88ced6410383dcdafa2979eae5 msgid "" "Textpage content as a string in XHTML format. Text information detail is " "comparable with :meth:`extractTEXT`, but also contains images (base64 " "encoded). This method makes no attempt to re-create the original visual " "appearance." msgstr "" "TextPageの内容をXHTML形式の文字列として取得します。テキスト情報の詳細は :meth:`extractTEXT` " "と比較できますが、画像も含まれます（Base64エンコードされています）。このメソッドは元の視覚的な外観を再作成しようとしません。" #: ../../textpage.rst:105 ce4a584473674c4e91533c25a532fe15 msgid "" "Textpage content as a string in XML format. This contains complete " "formatting information about every single character on the page: font, " "size, line, paragraph, location, color, etc. Contains no images. You need" " an XML package to interpret the output in Python." msgstr "TextPageの内容をXML形式の文字列として取得します。これにはページ上の各文字に関する完全なフォーマット情報が含まれています：フォント、サイズ、行、段落、位置、色など。画像は含まれていません。Pythonで出力を解釈するにはXMLパッケージが必要です。" #: ../../textpage.rst:111 53dc5f5e5cc04c54a952877ba4755541 msgid "" "Textpage content as a Python dictionary -- technically similar to " ":meth:`extractDICT`, and it contains that information as a subset " "(including any images). It provides additional detail down to each " "character, which makes using XML obsolete in many cases. See below for " "the structure." msgstr "" "TextPageの内容をPythonの辞書として取得します。技術的には :meth:`extractDICT` " "と類似しており、その情報をサブセットとして含みます（画像も含まれます）。詳細については以下を参照してください。" #: ../../textpage.rst:119 33863035deb9499b8feb6d00b3064acb msgid "" "Textpage content as a JSON string. Created by " "`json.dumps(TextPage.extractRAWDICT())`. You will probably use this " "method ever only for outputting the result to some file. The method " "detects binary image data and converts them to base64 encoded strings." msgstr "" "TextPageの内容をJSON形式の文字列として取得します。`json.dumps(TextPage.extractRAWDICT())` " "によって作成されます。おそらく、結果をファイルに出力する際にのみこのメソッドを使用するでしょう。このメソッドはバイナリ画像データを検出し、それらをBase64エンコードされた文字列に変換します。" #: ../../textpage.rst:127 209053b84b6545e3994a163287facefa msgid "Changed in v1.18.2" msgstr "変更内容 v1.18.2" #: ../../textpage.rst:129 05ffbacb61c7489882f082b48886e8d5 msgid "Search for *string* and return a list of found locations." msgstr "*文字列* を検索し、見つかった位置のリストを返します。" #: ../../textpage.rst:131 c71683b946f54d84aff575da2005613b msgid "" "the string to search for. Upper and lower cases will all match if needle " "consists of ASCII letters only -- it does not yet work for \"Ä\" versus " "\"ä\", etc." msgstr "" "検索対象の文字列。ASCII文字だけで構成されている場合、大文字と小文字はすべて一致します。これはまだ、例えば \"Ä\" と \"ä\" " "のような場合には機能しません。" #: ../../textpage.rst:132 0f1af98486ec43429066d8c48e3dc958 msgid "return quadrilaterals instead of rectangles." msgstr "長方形の代わりに四辺形を返すかどうか。" #: ../../textpage.rst 943e3f54b51f470ba6d34411ccdabcd3 msgid "Returns" msgstr "" #: ../../textpage.rst:134 89e19eb80ccd4b318611f268b0f75d7e msgid "" "a list of :ref:`Rect` or :ref:`Quad` objects, each surrounding a found " "*needle* occurrence. As the search string may contain spaces, its parts " "may be found on different lines. In this case, more than one rectangle " "(resp. quadrilateral) are returned. **(Changed in v1.18.2)** The method " "**now supports dehyphenation**, so it will find e.g. \"method\", even if " "it was hyphenated in two parts \"meth-\" and \"od\" across two lines. The" " two returned rectangles will contain \"meth\" (no hyphen) and \"od\"." msgstr "" "見つかった *needle* の出現箇所を囲む :ref:`Rect` または :ref:`Quad` " "オブジェクトのリスト。検索文字列にはスペースが含まれる可能性があるため、その部分が異なる行に存在することがあります。この場合、複数の長方形（または四辺形）が返されます" " **（v1.18.2 で変更）** 。このメソッドは **今ではハイフネーションに対応しており** 、例えば \"method\" が " "\"meth-\" と \"od\" という2つの部分に分かれている場合でも、\"meth\"（ハイフンなし）と \"od\" " "の2つの長方形が含まれます。" #: ../../textpage.rst:136 c134a9fb178648ae8bab433d54e37e2b msgid "**Overview of changes in v1.18.2:**" msgstr "**v1.18.2 での変更内容の概要：**" #: ../../textpage.rst:138 d9a3438955224e5685de548903667d74 msgid "The `hit_max` parameter has been removed: all hits are always returned." msgstr "`hit_max` パラメータが削除され、すべてのヒットが常に返されます。" #: ../../textpage.rst:139 c687c9305d954f6eaea257e2fe5bbe58 msgid "" "The `rect` parameter of the :ref:`TextPage` is now respected: only text " "inside this area is examined. Only characters with fully contained bboxes" " are considered. The wrapper method :meth:`Page.search_for` " "correspondingly supports a *clip* parameter." msgstr "" ":ref:`TextPage` の `rect` パラメータが尊重され、この領域内のテキストのみが検査されます。完全に含まれる bboxes " "を持つ文字のみが考慮されます。:meth:`Page.search_for` のラッパーメソッドも対応するクリップパラメータをサポートしています。" #: ../../textpage.rst:140 ec9e270e430341a88939c174a0e838a3 msgid "**Hyphenated words** are now found." msgstr "**ハイフネーションされた単語** も見つかります。" #: ../../textpage.rst:141 595b14cd29774ef49fd1666b1d37dbb7 msgid "" "**Overlapping rectangles** in the same line are now automatically joined." " We assume that such separations are an artifact created by multiple " "marked content groups, containing parts of the same search needle." msgstr "" "同じ行内の **重複する長方形** " "は自動的に結合されます。このような分割は、同じ検索対象の一部を含む複数のマークコンテンツグループによって作成されたアーティファクトと仮定されます。" #: ../../textpage.rst:143 7b283f04f24544e18dc95d6f698f1a39 msgid "" "Example Quad versus Rect: when searching for needle \"pymupdf\", then the" " corresponding entry will either be the blue rectangle, or, if *quads* " "was specified, the quad *Quad(ul, ur, ll, lr)*." msgstr "" "例：Quad 対 Rect：needle \"pymupdf\" を検索する場合、対応するエントリは青い長方形であるか、*quads* " "が指定された場合は四辺形 *Quad(ul, ur, ll, lr)* になります。" #: ../../textpage.rst:149 22015cb6553240db9caee4c5d4d0a06b msgid "" "The rectangle associated with the text page. This either equals the " "rectangle of the creating page or the `clip` parameter of " ":meth:`Page.get_textpage` and text extraction / searching methods." msgstr "" "テキストページに関連付けられた矩形。これは、作成ページの矩形または :meth:`Page.get_textpage` " "およびテキスト抽出/検索メソッドの `clip` パラメーターと一致する場合があります。" #: ../../textpage.rst:151 e4d7797e393d49f38a2ad6066b720a21 msgid "" "The output of text searching and most text extractions **is restricted to" " this rectangle**. (X)HTML and XML output will however always extract the" " full page." msgstr "" "テキスト検索およびほとんどのテキスト抽出の出力は " "**この矩形に制限されます**。ただし、(X)HTMLおよびXMLの出力は常にフルページを抽出します。" #: ../../textpage.rst:156 746d4f0331d74f5eb4b706ab194b8b02 msgid "Structure of Dictionary Outputs" msgstr "辞書出力の構造" #: ../../textpage.rst:157 ae8559712aa84a3b8f3abc14fba42605 msgid "" "Methods :meth:`TextPage.extractDICT`, :meth:`TextPage.extractJSON`, " ":meth:`TextPage.extractRAWDICT`, and :meth:`TextPage.extractRAWJSON` " "return dictionaries, containing the page's text and image content. The " "dictionary structures of all four methods are almost equal. They strive " "to map the text page's information hierarchy of blocks, lines, spans and " "characters as precisely as possible, by representing each of these by its" " own sub-dictionary:" msgstr "" ":meth:`TextPage.extractDICT`、:meth:`TextPage.extractJSON` " "、:meth:`TextPage.extractRAWDICT` 、:meth:`TextPage.extractRAWJSON` " "は、ページのテキストおよび画像コンテンツを含む辞書を返します。これらの4つのメソッドの辞書構造はほぼ同じです。これらは、ブロック、行、スパン、文字の情報階層をテキストページにできるだけ正確にマップし、各要素を独自のサブ辞書で表現することを目指しています。" #: ../../textpage.rst:159 1fc549b40ec54504aba36b49e614c7cc msgid "A **page** consists of a list of **block dictionaries**." msgstr "**ページ** は **ブロック辞書** のリストから構成されます。" #: ../../textpage.rst:160 531deb445eda49c78ee0170f577f2f93 msgid "A (text) **block** consists of a list of **line dictionaries**." msgstr "(テキスト) **ブロック** は、**行辞書** のリストから構成されます。" #: ../../textpage.rst:161 5d0d26a55df64fb0bc4619f73f865415 msgid "A **line** consists of a list of **span dictionaries**." msgstr "**行** は、**スパン辞書** のリストから構成されます。" #: ../../textpage.rst:162 d297bff2aae540828c971d533f6fe3bb msgid "" "A **span** either consists of the text itself or, for the RAW variants, a" " list of **character dictionaries**." msgstr "**スパン** は、テキスト自体またはRAWバリアントの場合、**文字辞書** のリストから構成されます。" #: ../../textpage.rst:163 37000c1f71684c77a812407e7849a0e0 msgid "" "RAW variants: a **character** is a dictionary of its origin, bbox and " "unicode." msgstr "RAWバリアント：**文字** はその起源、bbox、およびUnicodeの辞書です。" #: ../../textpage.rst:165 192df2422b5e482bbb29f7afc93e8cdc msgid "" "All PyMuPDF geometry objects herein (points, rectangles, matrices) are " "represented by there **\"like\"** formats: a :data:`rect_like` *tuple* is" " used instead of a :ref:`Rect`, etc. The reasons for this are performance" " and memory considerations:" msgstr "" "ここでのすべてのPyMuPDFジオメトリオブジェクト（ポイント、矩形、行列）は、:data:`rect_like` *タプル* の形式で " ":ref:`Rect` などの代わりに使用されます。これは、パフォーマンスとメモリの考慮事項からです。" #: ../../textpage.rst:167 517e734e4772478cb6b1bc32cab2ab16 msgid "" "This code is written in C, where Python tuples can easily be generated. " "The geometry objects on the other hand are defined in Python source only." " A conversion of each Python tuple into its corresponding geometry object" " would add significant -- and largely unnecessary -- execution time." msgstr "" "このコードはCで書かれており、Pythonタプルは簡単に生成できます。一方、ジオメトリオブジェクトはPythonソースでのみ定義されています。 " "各Pythonタプルを対応するジオメトリオブジェクトに変換することは、実行時間を大幅に（かつ不必要に）増加させるでしょう。" #: ../../textpage.rst:168 a7f4b55b2bb84753bc138ab3a04c2f8a msgid "" "A 4-tuple needs about 168 bytes, the corresponding :ref:`Rect` 472 bytes " "- almost three times the size. A \"dict\" dictionary for a text-heavy " "page contains 300+ bbox objects -- which thus require about 50 KB storage" " as 4-tuples versus 140 KB as :ref:`Rect` objects. A \"rawdict\" output " "for such a page will however contain **4 to 5 thousand** bboxes, so in " "this case we talk about 750 KB versus 2 MB." msgstr "" "4つのタプルは約168バイト、対応する :ref:`Rect` は472バイトです - " "サイズのほぼ3倍です。テキストが豊富なページの「dict」辞書には300以上のbboxオブジェクトが含まれているため、これらは4タプルとして約50" " KBのストレージを必要としますが、:ref:`Rect` オブジェクトでは約140 " "KBです。このようなページの「rawdict」出力は、**4,000から5,000** のbboxを含む場合がありますので、この場合は750 " "KB対2 MBとなります。" #: ../../textpage.rst:170 bbdd6aa883a447c5b6bbb24a389b7944 msgid "" "Please also note, that only **bboxes** (= :data:`rect_like` 4-tuples) are" " returned, whereas a :ref:`TextPage` actually has the **full position " "information** -- in :ref:`Quad` format. The reason for this decision is " "again a memory consideration: a :data:`quad_like` needs 488 bytes (3 " "times the size of a :data:`rect_like`). Given the mentioned amounts of " "generated bboxes, returning :data:`quad_like` information would have a " "significant impact." msgstr "" "また、注意してください。 **bboxes** （rect_like 4タプル）のみが返され、:ref:`TextPage` には " "**完全な位置情報** が含まれていることです - Quad形式で。これはメモリの考慮事項です。:data:`quad_like` " "には488バイト（:data:`rect_like` " "の3倍のサイズ）が必要です。言及した数の生成されたbboxを考えると、:data:`quad_like` " "情報を返すことは重大な影響を与えるでしょう。" #: ../../textpage.rst:172 d2d5ce2b47bc4940b491f08fbbaa0027 msgid "" "In the vast majority of cases, we are dealing with **horizontal text " "only**, where bboxes provide entirely sufficient information." msgstr "ほとんどの場合、**水平テキストのみ** を扱っており、bboxは十分な情報を提供します。" #: ../../textpage.rst:174 feb1b497d7a04358ac4fc4f59750eb21 msgid "" "In addition, **the full quad information is not lost**: it can be " "recovered as needed for lines, spans, and characters by using the " "appropriate function from the following list:" msgstr "さらに、**フルクワッド情報は失われていません**。必要に応じて、以下のリストから適切な関数を使用して行、スパン、および文字のクワッド情報を回復できます：" #: ../../textpage.rst:176 e89548afd6dc44168e0b77628a3cba31 msgid ":meth:`recover_quad` -- the quad of a complete span" msgstr ":meth:`recover_quad` – 完全なスパンのクワッド" #: ../../textpage.rst:177 27d71bee525843278a01adf552fa7a36 msgid ":meth:`recover_span_quad` -- the quad of a character subset of a span" msgstr ":meth:`recover_span_quad` – スパンの一部の文字のクワッド" #: ../../textpage.rst:178 041a2862fe3d48ac95055a9328f85989 msgid ":meth:`recover_line_quad` -- the quad of a line" msgstr ":meth:`recover_line_quad` – 行のクワッド" #: ../../textpage.rst:179 66ae40921c104d34aba6daaf7127f04f msgid ":meth:`recover_char_quad` -- the quad of a character" msgstr ":meth:`recover_char_quad` – 文字のクワッド" #: ../../textpage.rst:181 727a2901b16c4ddd96ae14b244c5424a msgid "" "As mentioned, using these functions is ever only needed, if the text is " "**not written horizontally** -- `line[\"dir\"] != (1, 0)` -- and you need" " the quad for text marker annotations (:meth:`Page.add_highlight_annot` " "and friends)." msgstr "" "前述のように、これらの関数を使用する必要があるのは、テキストが **水平に書かれていない** 場合 - `line[\"dir\"] != (1," " 0)` - およびテキストマーカーアノテーション（:meth:`Page.add_highlight_annot` " "など）でクワッドが必要な場合のみです。" #: ../../textpage.rst:191 7805ac6076c748d18288314bba88341d msgid "Page Dictionary" msgstr "ページ辞書" #: ../../textpage.rst:194 ../../textpage.rst:208 ../../textpage.rst:251 #: ../../textpage.rst:263 ../../textpage.rst:285 ../../textpage.rst:369 #: 29f9782130d642a8b2fddc4dfd20716c 70f3d2461fad4b3fadb0fc3afaea9f2e #: 975906fdd1184ad3ad3fd3d27e4993b0 baf341562d684245aa92ddd993c2dd48 #: bf7900e8b9b5405a8f0d4d83a8bf0411 c6778ca210f143f38e1b9841a02401e9 msgid "**Key**" msgstr "**キー**" #: ../../textpage.rst:194 ../../textpage.rst:208 ../../textpage.rst:251 #: ../../textpage.rst:263 ../../textpage.rst:285 ../../textpage.rst:369 #: 264a4f1acc10474eb5e78fe3b5e5823b b4b639c47a4a414db8f8f3bb50ee8dc9 #: cc9c466c5ba84957921e1ff86a57d116 d94353036c5b40c1846dd829e554f27f #: f0dc2d1c0f2f41dea26d6f56aa6b3a26 fe805e2ac2f84c418cdee9f01871d787 msgid "**Value**" msgstr "**値**" #: ../../textpage.rst:196 ../../textpage.rst:214 #: 07aa10194d0d48eb97c6202f508f7705 8f326282fbe8407aa66c61b1d8bcd062 msgid "width" msgstr "" #: ../../textpage.rst:196 f244c49149a243688a1885d014c7a1bb msgid "width of the `clip` rectangle *(float)*" msgstr "`clip` 矩形の幅 *(float)*" #: ../../textpage.rst:197 ../../textpage.rst:215 #: b8882d43fa804c8a9c251b3ec47cef6d bcccca2b99b94b7ea01f4de3b4b7c85a msgid "height" msgstr "" #: ../../textpage.rst:197 3100ead6fa2e45f5b61d6969928e4877 msgid "height of the `clip` rectangle *(float)*" msgstr "`clip` 矩形の高さ *(float)*" #: ../../textpage.rst:198 c5935e75747b42e799fe04c7f318b0da msgid "blocks" msgstr "" #: ../../textpage.rst:198 30ab779a07894b089542bb81604f9b47 msgid "*list* of block dictionaries" msgstr "ブロック辞書の *list* " #: ../../textpage.rst:202 db462c15f35c46f5b52a233a3beed4d0 msgid "Block Dictionaries" msgstr "ブロック辞書" #: ../../textpage.rst:203 952d964d7a5e43c2848616b970e2716c msgid "" "Block dictionaries come in two different formats for **image blocks** and" " for **text blocks**." msgstr "ブロック辞書は、**画像ブロック** と **テキストブロック** の2つの異なるフォーマットで提供されます。" #: ../../textpage.rst:205 238f68f9676441f1bdcff950557a856e msgid "**Image block:**" msgstr "**画像ブロック：**" #: ../../textpage.rst:210 ../../textpage.rst:253 #: 800a3c27effc460f9480726ec3a5c729 d35d41a494c04f6285bda0eace697528 msgid "type" msgstr "" #: ../../textpage.rst:210 6328d3cec703451097bfaa7cf7f6c65f #, fuzzy msgid "1 = image (``int``)" msgstr "1 = 画像 *(int)*" #: ../../textpage.rst:211 ../../textpage.rst:254 ../../textpage.rst:265 #: ../../textpage.rst:287 ../../textpage.rst:372 #: 13e6c3dfe54549b9b050cea92d99d01a 322f2d6f5b2b44ed9706ad2f98ad459c #: 4f766fcb9538433a8d4db8a39a80ff3c bc56648f4c414b1eb1faa55dba01ab98 #: db0fdf56b2254240a588914bece3c707 msgid "bbox" msgstr "" #: ../../textpage.rst:211 ff4d18f9a8d24d16a31d552e95f6e589 msgid "image bbox on page (:data:`rect_like`)" msgstr "ページ上の画像の境界ボックス（:data:`rect_like`）" #: ../../textpage.rst:212 ../../textpage.rst:255 #: 4c56479091544270885701e21d3794c0 5d311b7030c74d77b291641b825cabc0 msgid "number" msgstr "" #: ../../textpage.rst:212 044f427c89414858935273b873628617 #, fuzzy msgid "block count (``int``)" msgstr "ブロック数 *(int)*" #: ../../textpage.rst:213 d457db3dffd648f5b421b9dabda513e8 msgid "ext" msgstr "" #: ../../textpage.rst:213 9a1b2497c15747ccae408e2908b03716 #, fuzzy msgid "image type (``str``), as file extension, see below" msgstr "画像の種類 *(str)*、ファイル拡張子として、以下参照" #: ../../textpage.rst:214 65917d8aff0a47ae97e1c880700ae5b9 #, fuzzy msgid "original image width (``int``)" msgstr "元の画像の幅 *(int)*" #: ../../textpage.rst:215 ef1b2983b8484b67aea4e7c52ec94c5e #, fuzzy msgid "original image height (``int``)" msgstr "元の画像の高さ *(int)*" #: ../../textpage.rst:216 cdbc1a0fe83a45878f7d57c8195c2541 msgid "colorspace" msgstr "" #: ../../textpage.rst:216 0768d9dd62e74b518365212bb8f2d509 #, fuzzy msgid "colorspace component count (``int``)" msgstr "カラースペースのコンポーネント数 *(int)*" #: ../../textpage.rst:217 c72ef151fd0843acbf96ee02c0b50384 msgid "xres" msgstr "" #: ../../textpage.rst:217 2b798798946e43259c410f01235ab8cf #, fuzzy msgid "resolution in x-direction (``int``) [#f3]_" msgstr "x方向の解像度 *(int)*" #: ../../textpage.rst:218 711945f5b34049a1b07317557513f490 msgid "yres" msgstr "" #: ../../textpage.rst:218 91a31d61290640b8988418d1a9ebb3ba #, fuzzy msgid "resolution in y-direction (``int``) [#f3]_" msgstr "y方向の解像度 *(int)*" #: ../../textpage.rst:219 c247c45f267c4a6281d20687be8c99af msgid "bpc" msgstr "" #: ../../textpage.rst:219 8934e38405664f3fa8f78d65d3a6dba5 #, fuzzy msgid "bits per component (``int``)" msgstr "コンポーネントごとのビット数 *(int)*" #: ../../textpage.rst:220 2db498cd52714dd8b5097aa444b17ac0 msgid "transform" msgstr "" #: ../../textpage.rst:220 c07a01fdd4744863a7e7b665d9066376 msgid "matrix transforming image rect to bbox (:data:`matrix_like`)" msgstr "画像矩形を境界ボックスに変換する行列（:data:`matrix_like`）" #: ../../textpage.rst:221 ../../textpage.rst:292 #: 416da7dc62f34728a5e65a5b6eccec10 e5bfbe8873ce4531a1a93eea31b542ab msgid "size" msgstr "" #: ../../textpage.rst:221 ef114c513c0140809c273a1fca277935 #, fuzzy msgid "size of the image in bytes (``int``)" msgstr "画像のサイズ（バイト単位）*(int)*" #: ../../textpage.rst:222 b4442e7378f340ad9bbc40a5bda85f94 msgid "image" msgstr "" #: ../../textpage.rst:222 44de8974cd434bbca7c4dea100e9987f #, fuzzy msgid "image content (``bytes``)" msgstr "画像コンテンツ *(bytes)*" #: ../../textpage.rst:223 ce697bda1a494d35a92a1a9b886f4a53 msgid "mask" msgstr "" #: ../../textpage.rst:223 203d79f1d981499da21d8cae601cef42 msgid "image mask content (``bytes``) for transparent images" msgstr "" #: ../../textpage.rst:226 7b2748f1df1342538dd7b750dd6db1db msgid "" "Possible values of the \"ext\" key are \"bmp\", \"gif\", \"jpeg\", " "\"jpx\" (JPEG 2000), \"jxr\" (JPEG XR), \"png\", \"pnm\", and \"tiff\"." msgstr "" "\"ext\"キーの可能な値は、\"bmp\"、\"gif\"、\"jpeg\"、\"jpx\"（JPEG 2000）、\"jxr\"（JPEG " "XR）、\"png\"、\"pnm\"、および \"tiff\" です。" #: ../../textpage.rst:230 f165771e95ce4de587ef46d0281ce182 msgid "" "An image block is generated for **all and every image occurrence** on the" " page. Hence there may be duplicates, if an image is shown at different " "locations." msgstr "ページ上の **すべての画像** が画像ブロックとして生成されます。したがって、画像が異なる場所で表示される場合、重複が発生する可能性があります。" #: ../../textpage.rst:232 34122c8c572a45d7a4acfd1f2cbbbe55 msgid "" ":ref:`TextPage` and corresponding method :meth:`Page.get_text` are " "**available for all document types**. Only for PDF documents, methods " ":meth:`Document.get_page_images` / :meth:`Page.get_images` offer some " "overlapping functionality as far as image lists are concerned. But both " "lists **may or may not** contain the same items. Any differences are most" " probably caused by one of the following:" msgstr "" ":ref:`TextPage` および対応するメソッド :meth:`Page.get_text` は **すべてのドキュメントタイプ** " "で利用可能です。PDFドキュメントの場合、:meth:`Document.get_page_images` / " ":meth:`Page.get_images` は画像リストに関する機能が一部重複しています。ただし、これらのリストは同じアイテムを " "**含むかどうかは必ずしも保証されません**。違いがある場合、その原因はおそらく次のいずれかです。" #: ../../textpage.rst:234 87715f6d6a82452b8ef41b7cbb3b917c msgid "" "\"Inline\" images (see page 214 of the :ref:`AdobeManual`) of a PDF page " "are contained in a textpage, but **do not appear** in " ":meth:`Page.get_images`." msgstr "" "PDFページの「インライン」画像（:ref:`AdobeManual` " "のページ214を参照）はテキストページに含まれていますが、:meth:`Page.get_images` には **表示されません**。" #: ../../textpage.rst:235 7671c8c4e14e4452a9de51d3be9f9a57 msgid "" "Annotations may also contain images -- these will **not appear** in " ":meth:`Page.get_images`." msgstr "アノテーションにも画像が含まれることがあります。これらは :meth:`Page.get_images` には **表示されません**。" #: ../../textpage.rst:236 528e4366c2844284b6b3e06d85663c2c msgid "" "Image blocks in a textpage are generated for **every** image location -- " "whether or not there are any duplicates. This is in contrast to " ":meth:`Page.get_images`, which will list each image only once (per " "reference name)." msgstr "" "テキストページの画像ブロックは、画像の場所 **ごとに** " "生成されます。重複があるかどうかに関係なくです。これは、:meth:`Page.get_images` " "では各画像が1回だけリストされる（参照名ごとに）のとは対照的です。" #: ../../textpage.rst:237 6ba5259a29524a72bae31a85c368deb0 msgid "" "Images mentioned in the page's :data:`object` definition will **always** " "appear in :meth:`Page.get_images` [#f1]_. But it may happen, that there " "is no \"display\" command in the page's :data:`contents` (erroneously or " "on purpose). In this case the image will **not appear** in the textpage." msgstr "" "ページの :data:`object` 定義で言及されている画像は、常に :meth:`Page.get_images` に表示されます " "[#f1]_。ただし、ページの :data:`contents` に「表示」コマンドがない場合、画像はテキストページに表示されません。" #: ../../textpage.rst:239 e7f81738e67441429325db9963571f7d msgid "" "The image's \"transformation matrix\" is defined as the matrix, for which" " the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, " "lookup details here: :ref:`ImageTransformation`." msgstr "" "画像の「変換行列」は、`bbox / transform == pymupdf.Rect(0, 0, 1, 1)` " "という式が真である場合の行列です。詳細はこちらを参照してください： :ref:`ImageTransformation`。" #: ../../textpage.rst:241 57bed7561cd444e0b640b95c35da2f85 msgid "" "A transparent image may be accompanied by a mask image. This is stored " "under key `\"mask\"` and has the format of a `DeviceGray` PNG image. " "Otherwise the value of this key is ``None``. If present, you may be able " "to recover (an equivalent of) the original image -- i.e. with " "transparency -- by creating :ref:`Pixmap` objects from the \"image\", " "respectively \"mask\" values and overlay them. This is not guaranteed to " "always work because mask images come in multiple formats, of which not " "all qualify for the conditions under which overlaying Pixmaps are " "supported. Here is a code snippet:" msgstr "" #: ../../textpage.rst:248 4615f23b245b4db39e8ea23b4d176464 msgid "**Text block:**" msgstr "**テキストブロック：**" #: ../../textpage.rst:253 db5d3f31fc8d4153b8fafecfdf3d1727 msgid "0 = text *(int)*" msgstr "0 = テキスト *(int)*" #: ../../textpage.rst:254 6964cf3c7ba24458aae29d347f3f603a msgid "block rectangle, :data:`rect_like`" msgstr "ブロックの矩形、:data:`rect_like`" #: ../../textpage.rst:255 731cf949720a4619b5ea681f7764d295 msgid "block count *(int)*" msgstr "ブロック数 *(int)*" #: ../../textpage.rst:256 3a23e4510e7949e29bf987d16327eb49 msgid "lines" msgstr "" #: ../../textpage.rst:256 ede4e782ec014752989f15767a43462d msgid "*list* of text line dictionaries" msgstr "テキスト行の辞書の *list*" #: ../../textpage.rst:260 647d1430aba549968a23caa9bd2bf178 msgid "Line Dictionary" msgstr "" #: ../../textpage.rst:265 88d566f6551a42a29f62a0819ecbed64 msgid "line rectangle, :data:`rect_like`" msgstr "行の矩形、:data:`rect_like`" #: ../../textpage.rst:266 bc961e945f144c85a9e1a2193c3a4443 msgid "wmode" msgstr "" #: ../../textpage.rst:266 220a8c26dda34ae4b15fb120791f0296 msgid "writing mode *(int)*: 0 = horizontal, 1 = vertical" msgstr "書き込みモード *(int)*：0 = 水平、1 = 垂直" #: ../../textpage.rst:267 b23571753e8641b391f1c7bd3d666faf msgid "dir" msgstr "" #: ../../textpage.rst:267 f040c814bf3643e0b50bb1889d157bc2 msgid "writing direction, :data:`point_like`" msgstr "書き込み方向、:data:`point_like`" #: ../../textpage.rst:268 f4df6d31bea14f7d9133d10fe217a237 msgid "spans" msgstr "" #: ../../textpage.rst:268 d2626131157f45bda11a0a0240ae20e0 msgid "*list* of span dictionaries" msgstr "スパン辞書の *list*" #: ../../textpage.rst:271 827a258f7a314424b22d7d3077bc4795 #, fuzzy msgid "" "The value of key *\"dir\"* is the **unit vector** `dir = (cosine, -sine)`" " of the angle, which the text has relative to the x-axis [#f2]_. See the " "following picture: The word in each quadrant (counter-clockwise from top-" "right to bottom-right) is rotated by 30, 120, 210 and 300 degrees " "respectively." msgstr "" "キー *\"dir\"* の値は、テキストが x 軸に対してどの角度であるかを示す **ユニットベクトル** `dir = (cosine, " "sine)` " "です。次の図を参照してください：各象限内の単語（右上から反時計回りに、上から下まで）は、それぞれ30、120、210、300度回転しています。" #: ../../textpage.rst:277 76e3be33b8eb4d20a040a290a7493044 msgid "Span Dictionary" msgstr "" #: ../../textpage.rst:279 44e867372fca4010ae8c117e6f57244a msgid "" "Spans contain the actual text. A line contains **more than one span " "only**, if it contains text with different font properties." msgstr "スパンには実際のテキストが含まれています。フォントのプロパティが異なるテキストを含む場合を除き、1行には複数のスパンが含まれます。" #: ../../textpage.rst:281 2484e6f332594c488b1ab6e8e45e8358 msgid "Changed in version 1.14.17 Spans now also have a *bbox* key (again)." msgstr "バージョン1.14.17で変更されました：スパンには *bbox* キーが含まれています（再び）。" #: ../../textpage.rst:282 fe2deeccb3484496b06cee9c45979177 msgid "Changed in version 1.17.6 Spans now also have an *origin* key." msgstr "バージョン1.17.6で変更されました：スパンには *origin* キーも含まれています。" #: ../../textpage.rst:287 24917424394140498d62e12db012d491 msgid "span rectangle, :data:`rect_like`" msgstr "スパンの矩形、:data:`rect_like`" #: ../../textpage.rst:288 ../../textpage.rst:371 #: d062895875c246f08ce11e156a46fe6c e4eadb2bf3fd4656a1dcaea2aa762fb2 msgid "origin" msgstr "" #: ../../textpage.rst:288 49dcac4791f7495283b181cd85e5cb96 msgid "the first character's origin, :data:`point_like`" msgstr "最初の文字の原点、:data:`point_like`" #: ../../textpage.rst:289 a039c803b12f44f2b903bfd72ff968f0 msgid "font" msgstr "" #: ../../textpage.rst:289 e59d2678453347c3b2290c87101bee41 msgid "font name *(str)*" msgstr "フォント名 *（str）*" #: ../../textpage.rst:290 9789271ef0d44ca8b8b7753a47109329 msgid "ascender" msgstr "" #: ../../textpage.rst:290 bae202ea90f340c08117616fba695605 msgid "ascender of the font *(float)*" msgstr "フォントのアセンダー *（float）*" #: ../../textpage.rst:291 f04de1e03bc64ecb932178642bbf28a2 msgid "descender" msgstr "" #: ../../textpage.rst:291 cab39571402145599cd516740c2cd5e3 msgid "descender of the font *(float)*" msgstr "フォントのディセンダー *（float）*" #: ../../textpage.rst:292 7bb34b245d0e4a7a807d37f771540973 msgid "font size *(float)*" msgstr "フォントサイズ *（float）*" #: ../../textpage.rst:293 728b3550893a43df91864ece6b6a6c75 msgid "flags" msgstr "" #: ../../textpage.rst:293 d4144f5c31e240ca8a9bc6a9902c4b40 msgid "font characteristics *(int)*" msgstr "フォントの特性 *（int）*" #: ../../textpage.rst:294 4ab488b7a402495f924066ec5fa0901d msgid "char_flags" msgstr "" #: ../../textpage.rst:294 ac689e1eb3bd44c196f5a43696910e9c #, fuzzy msgid "char characteristics *(int)*" msgstr "フォントの特性 *（int）*" #: ../../textpage.rst:295 70dfc6783fdb4c5a8a1e0ad9b92b44fc msgid "color" msgstr "" #: ../../textpage.rst:295 0c21ca835d2f477e934a8f5cec1f8a4c #, fuzzy msgid "text color in sRGB format 0xRRGGBB *(int)*." msgstr "sRGB形式のテキストカラー *（int）*" #: ../../textpage.rst:296 8e921b08a2ba477497897d70a87f4977 msgid "alpha" msgstr "" #: ../../textpage.rst:296 ec794a253afb48ea90cf9d7494caa03b msgid "text opacity 0..255 *(int)*." msgstr "" #: ../../textpage.rst:297 72dbc8f290b94f6c88700e6a5df12717 msgid "text" msgstr "" #: ../../textpage.rst:297 42bc9c7faaed433c9e3868ab04254f3f msgid "(only for :meth:`extractDICT`) text *(str)*" msgstr "（:meth:`extractDICT` のみ）テキスト *（str）* " #: ../../textpage.rst:298 6c4e864e58554766a1c930bd0e32e581 msgid "chars" msgstr "" #: ../../textpage.rst:298 287db5214934490ba0764caaa9ee699d msgid "(only for :meth:`extractRAWDICT`) *list* of character dictionaries" msgstr "（:meth:`extractRAWDICT` のみ）文字の辞書の*list*" #: ../../textpage.rst:301 6a3a9323a60541ca97db64597a2a451a msgid "|history_begin|" msgstr "" #: ../../textpage.rst:303 e0b8ee67e36546b0b5b8b155e00eeb45 msgid "*(New in version 1.25.3.0):* Added *\"alpha\"* item." msgstr "" #: ../../textpage.rst:305 04010301eebf4c2dbf6989108e207ae9 msgid "" "*(New in version 1.16.0):* *\"color\"* is the text color encoded in sRGB " "(int) format, e.g. 0xFF0000 for red. There are functions for converting " "this integer back to formats (r, g, b) (PDF with float values from 0 to " "1) :meth:`sRGB_to_pdf`, or (R, G, B), :meth:`sRGB_to_rgb` (with integer " "values from 0 to 255)." msgstr "" "*バージョン1.16.0で新しく追加された項目：*. *「color」* " "はsRGB（int）形式でエンコードされたテキストカラーで、例えば赤の場合は0xFF0000です。この整数をフォーマット（r、g、b）（PDFでは0から1の範囲の浮動小数点値）" " :meth:`sRGB_to_pdf` または（R、G、B）、:meth:`sRGB_to_rgb` " "（整数値で0から255の範囲）に変換するための関数があります。" #: ../../textpage.rst:307 744bef29da2f4dbc90404a35ef0fd253 msgid "" "*(New in v1.18.5):* *\"ascender\"* and *\"descender\"* are font " "properties, provided relative to :data:`fontsize` 1. Note that descender " "is a negative value. The following picture shows the relationship to " "other values and properties." msgstr "" "*バージョン1.18.5で新しく追加された項目：* *「ascender」* と *「descender」* は、フォントのプロパティで、 " ":data:`fontsize` " "1に対して提供されます。ディセンダーは負の値であることに注意してください。以下の画像は、他の値やプロパティとの関係を示しています。" #: ../../textpage.rst:309 e0a8a997405247f6bb89749ab0b624b7 msgid "|history_end|" msgstr "" #: ../../textpage.rst:314 9b180b7db6ac43e489b8d8e9ccb31622 msgid "" "These numbers may be used to compute the minimum height of a character " "(or span) -- as opposed to the standard height provided in the \"bbox\" " "values (which actually represents the **line height**). The following " "code recalculates the span bbox to have a height of **fontsize** exactly " "fitting the text inside:" msgstr "" "これらの数字は、文字（またはスパン）の最小の高さを計算するために使用できます。これは、実際には行の高さを表す「bbox」値ではなく、フォントサイズに完全に合わせるための高さを表します。次のコードは、スパンのbboxを、内部のテキストに完全に合わせる高さが" " **フォントサイズ** となるように再計算します：" #: ../../textpage.rst:324 91c353d85b0a45d7bde9987e275b50b5 msgid "" "The above calculation may deliver a **larger** height! This may e.g. " "happen for OCRed documents, where the risk of all sorts of text artifacts" " is high. MuPDF tries to come up with a reasonable bbox height, " "independently from the :data:`fontsize` found in the PDF. So please " "ensure that the height of `span[\"bbox\"]` is **larger** than " "`span[\"size\"]`." msgstr "" "上記の計算は、**より大きな** " "高さをもたらす可能性があります。これは、OCRedドキュメントなどで発生する可能性があります。MuPDFは、PDFに存在する " ":data:`fontsize` から独立して、適切なbboxの高さを見つけ出そうとします。したがって、`span[\"bbox\"]` の高さが" " `span[\"size\"]` よりも大きいことを確認してください。" #: ../../textpage.rst:326 cfa2fe9816d741889a16e7a98228f45f msgid "" "You may request PyMuPDF to do all of the above automatically by executing" " `pymupdf.TOOLS.set_small_glyph_heights(True)`. This sets a global " "parameter so that all subsequent text searches and text extractions are " "based on reduced glyph heights, where meaningful." msgstr "" "PyMuPDFに対して、`pymupdf.TOOLS.set_small_glyph_heights(True)` " "を実行して、上記のすべてを自動的に実行するように依頼することができます。これは、すべての後続のテキスト検索とテキスト抽出が、縮小されたグリフの高さを基に行われるようにするためのグローバルパラメータを設定します。" #: ../../textpage.rst:328 dcd3f3103b3a404ea59ed88e1020efbe msgid "" "The following shows the original span rectangle in red and the rectangle " "with re-computed height in blue." msgstr "以下は、元のspanの矩形を赤で、再計算された高さを持つ矩形を青で示しています。" #: ../../textpage.rst:334 c4897a84054b4b60ab66d79b8388e431 msgid "" "*\"flags\"* is an integer, which represents font properties except for " "the first bit 0. They are to be interpreted like this:" msgstr "*\"flags\"* は、フォントのプロパティを表す整数で、最初のビット 0 を除いて次のように解釈されます：" #: ../../textpage.rst:336 817f541495b84011b646fb0f5a0c1eff #, fuzzy msgid "" "bit 0: superscripted (:data:`TEXT_FONT_SUPERSCRIPT`) -- not a font " "property, detected by MuPDF code." msgstr "bit 0: superscripted (2\\ :sup:`0`) - フォントのプロパティではなく、MuPDFコードによって検出されます。" #: ../../textpage.rst:337 4966d75813f448898822b04faffbe380 msgid "bit 1: italic (:data:`TEXT_FONT_ITALIC`)" msgstr "" #: ../../textpage.rst:338 31205a9cd37941e0ac7c7fbbfb19ffc1 #, fuzzy msgid "bit 2: serifed (:data:`TEXT_FONT_SERIFED`)" msgstr "ビット 2: セリフ付き (2\\ :sup:`2`)" #: ../../textpage.rst:339 f887f5fcd078467cbd8ea212d8133aa3 #, fuzzy msgid "bit 3: monospaced (:data:`TEXT_FONT_MONOSPACED`)" msgstr "ビット 3: モノスペース (2\\ :sup:`3`)" #: ../../textpage.rst:340 075ed56b276245c096a3204cc111339a msgid "bit 4: bold (:data:`TEXT_FONT_BOLD`)" msgstr "" #: ../../textpage.rst:342 fafa4c4a530a43fa8278e455dd07640f msgid "Test these characteristics like so:" msgstr "これらの特性は、次のようにテストできます：" #: ../../textpage.rst:348 ffbc346b79aa4a6189253e08eeb6280f msgid "" "Bits 1 thru 4 are font properties, i.e. encoded in the font program. " "Please note, that this information is not necessarily correct or " "complete: fonts quite often contain wrong data here." msgstr "" "ビット1からビット4までがフォントのプロパティであり、つまりフォントプログラムにエンコードされています。 " "ただし、この情報は必ずしも正確または完全ではないことに注意してください。フォントにはしばしば誤ったデータが含まれていることがあります。" #: ../../textpage.rst:350 67a56b648e48459abc86b3d71dded7d7 msgid "" "*\"char_flags\"* is an integer, which represents extra character " "properties:" msgstr "" #: ../../textpage.rst:352 16e54aeb7318448cb0edbbce096027cc msgid "bit 0: strikeout." msgstr "" #: ../../textpage.rst:353 f36bc128a5084f419c7b735cc7a5caeb msgid "bit 1: underline." msgstr "" #: ../../textpage.rst:354 05f6a81ee7234929b145f42b0eaeb4ee msgid "bit 2: synthetic (always 0, see char dictionary)." msgstr "" #: ../../textpage.rst:355 2d7d278b9b7b46479144808b701ed7da msgid "bit 3: filled." msgstr "" #: ../../textpage.rst:356 a0b8d460dd8a42e69537652330a1f9ee msgid "bit 4: stroked." msgstr "" #: ../../textpage.rst:357 430da53ed561403d90a8c2c28cc01a90 msgid "bit 5: clipped." msgstr "" #: ../../textpage.rst:359 26fc27f279ca42fba75113be40e54d40 msgid "" "For example if not filled and not stroked (`if not (char_flags & 2**3 & " "2**4): ...`) then the text will be invisible." msgstr "" #: ../../textpage.rst:362 f68e611505354310ab256d5f4ac755f3 msgid "(`char_flags` is new in v1.25.2.)" msgstr "" #: ../../textpage.rst:366 2b6029a504d149d0b74200b8dd10b461 msgid "Character Dictionary for :meth:`extractRAWDICT`" msgstr "文字のディクショナリ、:meth:`extractRAWDICT`" #: ../../textpage.rst:371 e3322f02de66484cb59d9ddf2e914bcb msgid "character's left baseline point, :data:`point_like`" msgstr "文字の左ベースラインポイント、:data:`point_like`" #: ../../textpage.rst:372 3a206190a9b4495299d14480848ee306 msgid "character rectangle, :data:`rect_like`" msgstr "文字の矩形、:data:`rect_like`" #: ../../textpage.rst:373 7925e02a5e07443895c900f6450205fa msgid "synthetic" msgstr "" #: ../../textpage.rst:373 d557f7b009724b00a3418fb77e4943ce msgid "bool." msgstr "" #: ../../textpage.rst:374 fb692a970116495a977cac2daff0d94b msgid "c" msgstr "" #: ../../textpage.rst:374 30e9a39551314a14a169ee11d34c575f msgid "the character (unicode)" msgstr "文字（ユニコード）" #: ../../textpage.rst:377 504a88fbf1324f19a3ed16c3f2c0c942 msgid "(`synthetic` is new in v1.25.3.)" msgstr "" #: ../../textpage.rst:379 9d820af6f3ac446a912245d16d5e7bdd msgid "" "This image shows the relationship between a character's bbox and its " "quad: |textpagechar|" msgstr "この画像は、文字のbboxとそのquadの関係を示しています：|textpagechar|" #: ../../textpage.rst:381 64023f700298486f98b566eac340e37b #: 7901af22526f478cb0ba76a7cc56288e msgid "textpagechar" msgstr "" #: ../../textpage.rst:386 ab41f5e333004a04a46c0505e9d7bebf msgid "Footnotes" msgstr "脚注" #: ../../textpage.rst:387 9c3377a336cd4477b8afbd4528d4dee0 msgid "" "Image specifications for a PDF page are done in a page's (sub-) " ":data:`dictionary`, called `/Resources`. Resource dictionaries can be " "**inherited** from any of the page's parent objects (usually the " ":data:`catalog` -- the top-level parent). The PDF creator may e.g. define" " one `/Resources` on file level, naming all images and / or all fonts " "ever used by any page. In these cases, :meth:`Page.get_images` and " ":meth:`Page.get_fonts` will consequently return the same lists for all " "pages. If desired, this situation can be reverted using " ":meth:`Page.clean_contents`. After execution, the page's object " "definition will show fonts and images that are actually used." msgstr "" #: ../../textpage.rst:389 8ebe9e78accc4c87b80eb50757ed695f msgid "" "The coordinate systems of MuPDF and PDF are different in that MuPDF uses " "the page's top-left point as `(0, 0)`. In PDF, this is the bottom-left " "point. Therefore, the positive direction for MuPDF's y-axis is **from top" " to bottom**. This causes the sign change for the sine value here: a " "**negative** value indicates anti-clockwise rotation of the text." msgstr "" #: ../../textpage.rst:391 9bfe3c4bcdac45eb9b746197c51d2a7a msgid "" "This value is always 96, the default of the PDF interpreter. It **does " "not reflect** the resolution of the image itself. If you need the image's" " resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` " "attributes of the :ref:`Pixmap` created from the returned image binary." msgstr "" #: ../../footer.rst:46 909bafb54f4646cd8842c5ccd34ceeef msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "Image specifications for a PDF page " #~ "are done in a page's (sub-) " #~ ":data:`dictionary`, called *\"/Resources\"*. " #~ "Resource dictionaries can be **inherited** " #~ "from the page's parent object (usually" #~ " the :data:`catalog`). The PDF creator " #~ "may e.g. define one */Resources* on " #~ "file level, naming all images and " #~ "all fonts ever used by any page." #~ " In these cases, :meth:`Page.get_images` " #~ "and :meth:`Page.get_fonts` will return the " #~ "same lists for all pages." #~ msgstr "" #~ "PDFページの画像仕様は、ページの（サブ） :data:`dictionary` *「/Resources」*" #~ " として行われます。リソースディクショナリは、通常 :data:`catalog` " #~ "のページ親オブジェクトから継承されます。PDFの作成者は、ファイル全体で1つの/ */Resources* " #~ "を定義し、すべてのページで使用されるすべての画像とフォントを名前で指定する場合があります。これらの場合、:meth:`Page.get_images`" #~ " と :meth:`Page.get_fonts` はすべてのページに対して同じリストを返します。" #~ msgid "*(Changed in v1.18.0)* -- new dict key *number*, the block number." #~ msgstr "*(v1.18.0で変更)* - 新しいdictキー *number* 、ブロック番号。" #~ msgid "" #~ "*(Changed in v1.18.11)* -- new dict " #~ "key *transform*, the image transformation " #~ "matrix for image blocks." #~ msgstr "*(v1.18.11で変更)* - 新しいdictキー *transform* 、画像ブロックの画像変換行列。" #~ msgid "" #~ "*(Changed in v1.18.11)* -- new dict " #~ "key *size*, the size of the image" #~ " in bytes for image blocks." #~ msgstr "*(v1.18.11で変更)* - 新しいdictキー *size* 、画像ブロックのバイト単位の画像サイズ。" #~ msgid "bit 1: italic (2\\ :sup:`1`)" #~ msgstr "ビット 1: イタリック(2\\ :sup:`1`)" #~ msgid "bit 4: bold (2\\ :sup:`4`)" #~ msgstr "ビット 4: ボールド (2\\ :sup:`4`)" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/textwriter.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 95c1ee7365714a268b45d71ca863b7ee msgid "Artifex" msgstr "" #: ../../header.rst:-1 8dbea99845b74a23bde58d46198a17ac msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 cf3d095401604af48e44cc3a35d66bff msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../textwriter.rst:7 e9730367b10a49359e1d45817a7f7880 msgid "TextWriter" msgstr "TextWriter (テキストライター)" #: ../../textwriter.rst:9 cda3eb15a6fe4186b26bf8276092c97f msgid "|pdf_only_class|" msgstr "PDFのみ。" #: ../../textwriter.rst:11 db627f8740eb4561a5527a9d4ca4e25f msgid "New in v1.16.18" msgstr "v1.16.18で新たに追加" #: ../../textwriter.rst:13 67e48f18fa9440238b3a1969be763ace msgid "" "This class represents a MuPDF *text* object. The basic idea is to " "**decouple (1) text preparation, and (2) text output** to PDF pages." msgstr "" "このクラスはMuPDFの *text* " "オブジェクトを表します。**基本的なアイデアは、（1）テキストの準備と（2）PDFページへのテキストの出力を切り離すことです** 。" #: ../../textwriter.rst:15 5a301b5eac7846a6a95cae297b7806a2 msgid "" "During **preparation**, a text writer stores any number of text pieces " "(\"spans\") together with their positions and individual font " "information. The **output** of the writer's prepared content may happen " "multiple times to any PDF page with a compatible page size." msgstr "" "**準備**中、テキストライターはテキストピース（「スパン」）を任意の数保存し、それぞれの位置と個別のフォント情報とともに保存します。ライターの準備されたコンテンツの" " **出力** は、互換性のあるページサイズを持つ任意のPDFページに複数回行われる可能性があります。" #: ../../textwriter.rst:17 7cf591fcc0cf40af9d587a72b702b960 msgid "" "A text writer is an elegant alternative to methods " ":meth:`Page.insert_text` and friends:" msgstr "テキストライターは、:meth:`Page.insert_text` などと比較して、次の点で優れた代替手段です：" #: ../../textwriter.rst:19 8d88b6d0545142bc9885b1dcbb44a4ea msgid "" "**Improved text positioning:** Choose any point where insertion of text " "should start. Storing text returns the \"cursor position\" after the " "*last character* of the span." msgstr "" "**改良されたテキスト配置：** テキストを挿入する開始点を任意に選択できます。テキストの保存はスパンの *最後の文字の後* " "の「カーソル位置」を返します。" #: ../../textwriter.rst:20 4014fff4490f449991524305bfef1c4b msgid "" "**Free font choice:** Each text span has its own font and " ":data:`fontsize`. This lets you easily switch when composing a larger " "text." msgstr "" "**自由なフォントの選択：** 各テキストスパンには独自のフォントと :data:`fontsize` " "があります。大きなテキストを作成する際に簡単に切り替えることができます。" #: ../../textwriter.rst:21 96e0cdf2386340edafe0ed3b9aa2a211 msgid "" "**Automatic fallback fonts:** If a character is not supported by the " "chosen font, alternative fonts are automatically searched. This " "significantly reduces the risk of seeing unprintable symbols in the " "output (\"TOFUs\" -- looking like a small rectangle). PyMuPDF now also " "comes with the **universal font \"Droid Sans Fallback Regular\"**, which " "supports **all Latin** characters (including Cyrillic and Greek), and " "**all CJK** characters (Chinese, Japanese, Korean)." msgstr "" "**自動フォントのフォールバック：** " "選択したフォントが文字をサポートしていない場合、代替フォントが自動的に検索されます。これにより、出力で印刷できない記号を見るリスク（「TOFUs」" " - 小さな四角形に見える）が大幅に減少します。PyMuPDFはまた、**すべてのラテン**文字（キリル文字とギリシャ文字を含む）および " "**すべてのCJK**文字（中国語、日本語、韓国語）をサポートする **ユニバーサルフォント「Droid Sans Fallback " "Regular」** を提供します。" #: ../../textwriter.rst:22 89a8833cb85e46909d178dc372f5aaac msgid "" "**Cyrillic and Greek Support:** The :ref:`Base-14-fonts` have integrated " "support of Cyrillic and Greek characters **without specifying encoding.**" " Your text may be a mixture of Latin, Greek and Cyrillic." msgstr "キリル文字とギリシャ文字のサポート：PDFベース14フォントには、エンコーディングを指定せずにキリル文字とギリシャ文字の統合サポートがあります。テキストはラテン文字、ギリシャ文字、キリル文字の混合である可能性があります。" #: ../../textwriter.rst:23 939bfd358cb14ee1ac3d682b4310030f msgid "" "**Transparency support:** Parameter *opacity* is supported. This offers a" " handy way to create watermark-style text." msgstr "" "**透明度のサポート：** パラメータの *透明度* " "がサポートされています。これはウォーターマークスタイルのテキストを作成する便利な方法を提供します。" #: ../../textwriter.rst:24 36106b9c863b43c39d4d348af9680b3e msgid "" "**Justified text:** Supported for any font -- not just simple fonts as in" " :meth:`Page.insert_textbox`." msgstr "" "**両端揃えのテキスト**： :meth:`Page.insert_textbox` " "のような単純なフォントだけでなく、すべてのフォントでサポートされています。" #: ../../textwriter.rst:25 88d0bcdd76b94defb985b51bd7050a50 msgid "" "**Reusability:** A TextWriter object exists independent from PDF pages. " "It can be written multiple times, either to the same or to other pages, " "in the same or in different PDFs, choosing different colors or " "transparency." msgstr "" "**再利用性：** " "テキストライターオブジェクトはPDFページとは独立して存在します。同じページまたは異なるページ、同じPDFまたは異なるPDFに、異なる色や透明度を選択して複数回書き込むことができます。" #: ../../textwriter.rst:27 6ef8000439b141009aae765ba8c24479 msgid "Using this object entails three steps:" msgstr "このオブジェクトを使用するには、次の3つのステップが必要です：" #: ../../textwriter.rst:29 55dea84332984f3ca477041ec762edcf msgid "" "When **created**, a TextWriter requires a fixed **page rectangle** in " "relation to which it calculates text positions. A text writer can write " "to pages of this size only." msgstr "" "**作成** 時に、テキストライターはテキストの位置を計算するために関連する固定 **ページの矩形** " "を必要とします。テキストライターは、このサイズのページにのみ書き込むことができます。" #: ../../textwriter.rst:30 57f72fe6a49d41c7be7ed160f47f3019 msgid "" "Store text in the TextWriter using methods :meth:`TextWriter.append`, " ":meth:`TextWriter.appendv` and :meth:`TextWriter.fill_textbox` as often " "as is desired." msgstr "" "テキストライターを使用してテキストを " ":meth:`TextWriter.append`、:meth:`TextWriter.appendv`、および " ":meth:`TextWriter.fill_textbox` メソッドで必要な回数だけ保存します。" #: ../../textwriter.rst:31 ac5cfe5c0bf548bf8358a2cc4efa279b msgid "Output the TextWriter object on some PDF page(s)." msgstr "TextWriter オブジェクトをいくつかのPDFページに出力します。" #: ../../textwriter.rst:35 a70f239f39dc44bcbbcc7f367f4f04e8 msgid "" "Starting with version 1.17.0, TextWriters **do support** text rotation " "via the *morph* parameter of :meth:`TextWriter.write_text`." msgstr "" "バージョン1.17.0から、TextWriterは :meth:`TextWriter.write_text` の *morph* " "パラメータを介したテキストの回転を **サポートしています** 。" #: ../../textwriter.rst:37 39efcbe7af8242d59a6e61a1577bd093 msgid "" "There also exists :meth:`Page.write_text` which combines one or more " "TextWriters and jointly writes them to a given rectangle and with a given" " rotation angle -- much like :meth:`Page.show_pdf_page`." msgstr "" "また、 :meth:`Page.write_text` " "も存在し、1つ以上のTextWriterを組み合わせて、指定された矩形と回転角に共同で書き込みます - " ":meth:`Page.show_pdf_page` のように。" #: ../../textwriter.rst:41 58759c7fac7b4e859398a94c56641cf5 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../textwriter.rst:41 f8b99b262c4e479daa04854b10a8ca62 msgid "**Short Description**" msgstr "**短い説明**" #: ../../textwriter.rst:43 5aef1526d3ed401ebe84391dae14eb4e msgid ":meth:`~TextWriter.append`" msgstr "" #: ../../textwriter.rst:43 8a1f849d010e4a069dd84d412203d33f msgid "Add text in horizontal write mode" msgstr "水平書き込みモードでテキストを追加します。" #: ../../textwriter.rst:44 a3aab120ca1545a79fce7af51ccd1964 msgid ":meth:`~TextWriter.appendv`" msgstr "" #: ../../textwriter.rst:44 30601ff66d064e7bbc6b0711078114c1 msgid "Add text in vertical write mode" msgstr "垂直書き込みモードでテキストを追加します。" #: ../../textwriter.rst:45 665726b1a2f74150b2cf20b54f5d3864 msgid ":meth:`~TextWriter.fill_textbox`" msgstr "" #: ../../textwriter.rst:45 79bdf8fe196e481f9e0f7e6b6d83fa39 msgid "Fill rectangle (horizontal write mode)" msgstr "矩形を埋めます（水平書き込みモード）。" #: ../../textwriter.rst:46 50d2cf2d0f664964ad637397d702ba01 msgid ":meth:`~TextWriter.write_text`" msgstr "" #: ../../textwriter.rst:46 e17f4b99e3a3451090107da06c63083d msgid "Output TextWriter to a PDF page" msgstr "TextWriterをPDFページに出力します。" #: ../../textwriter.rst:47 b1dd0ce95c524931a45226c559b5fc7f msgid ":attr:`~TextWriter.color`" msgstr "" #: ../../textwriter.rst:47 977d247f29344daebbc7eb2edad63dda msgid "Text color (can be changed)" msgstr "テキストの色（変更可能です）。" #: ../../textwriter.rst:48 a702a69b27f04a1a8bf416872181b83c msgid ":attr:`~TextWriter.last_point`" msgstr "" #: ../../textwriter.rst:48 9c6a85c298f542b0ad83608987c80d7c msgid "Last written character ends here" msgstr "最後に書かれた文字がここで終了します。" #: ../../textwriter.rst:49 85bb365488064af39728ae2cff15a95e msgid ":attr:`~TextWriter.opacity`" msgstr "" #: ../../textwriter.rst:49 360143b334e144b188b4fc4606f37cd1 msgid "Text opacity (can be changed)" msgstr "テキストの透明度（変更可能です）。" #: ../../textwriter.rst:50 44cf6996b53b4136925af2dd23e6d3c3 msgid ":attr:`~TextWriter.rect`" msgstr "" #: ../../textwriter.rst:50 a79f2dca7b614eaaa5682eae3f4fa368 msgid "Page rectangle used by this TextWriter" msgstr "このTextWriterが使用するページの矩形。" #: ../../textwriter.rst:51 86888b68bbf045c8a8e10712005c4259 msgid ":attr:`~TextWriter.text_rect`" msgstr "" #: ../../textwriter.rst:51 cd277f06068040caa6fda7759192bbd3 msgid "Area occupied so far" msgstr "現在までに占有された領域。" #: ../../textwriter.rst:55 07466a577be94bd3ab53ccdfc689e759 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../textwriter.rst 0671bfe1c02041f88c29cf3ea4be264b #: 7841a29906a944f189e7e759b6592a97 7cb374b81c074ac69a19656e5756ce8c #: 800737d8455c4751bf6f9476b3e4a8df ffbf23da457b4c1fbab7452f6745e439 msgid "Parameters" msgstr "" #: ../../textwriter.rst:61 1156a360315c4f6cab4971ea0b50224f msgid "rectangle internally used for text positioning computations." msgstr "テキストの配置計算に内部的に使用される矩形。" #: ../../textwriter.rst:62 51fad4a4f8034a198c2666a029ac959b msgid "" "sets the transparency for the text to store here. Values outside the " "interval `[0, 1)` will be ignored. A value of e.g. 0.5 means 50% " "transparency." msgstr "ここに保存されるテキストの透明度を設定します。区間 `[0, 1)` 外の値は無視されます。例：0.5の場合、50％の透明度を意味します。" #: ../../textwriter.rst:63 6b628abb5ffe4a5585ddb2b56255b5dd msgid "" "the color of the text. All colors are specified as floats *0 <= color <= " "1*. A single float represents some gray level, a sequence implies the " "colorspace via its length." msgstr "" "テキストの色。すべての色は浮動小数点数 *0 <= color <= 1* " "として指定されます。単一の浮動小数点数は一定の灰色レベルを表し、シーケンスはその長さを介して色空間を示します。" #: ../../textwriter.rst:68 0fa13673da764fdaab29ebfad67bf44c msgid "*Changed in v1.18.9*" msgstr "*バージョン1.18.9で変更*" #: ../../textwriter.rst:69 ../../textwriter.rst:100 #: 08713255cee94718b3bc26b0dda8f233 be3763dd7a294137b65bf5a1770830d3 msgid "*Changed in v1.18.15*" msgstr "*バージョン1.18.15で変更*" #: ../../textwriter.rst:71 6f8eddc35363416184aad7c44e5d01ef msgid "Add some new text in horizontal writing." msgstr "水平書き込みで新しいテキストを追加します。" #: ../../textwriter.rst:73 ../../textwriter.rst:104 #: 31e8d87141cf44c5890e5151a73047f4 f7e1346516c8429f9cafb3010a03a215 msgid "start position of the text, the bottom left point of the first character." msgstr "テキストの開始位置、最初の文字の左下の点です。" #: ../../textwriter.rst:74 3b2200db94814c6b84f09e2a67431714 msgid "" "a string of arbitrary length. It will be written starting at position " "\"pos\"." msgstr "任意の長さの文字列。位置「pos」から書き始められます。" #: ../../textwriter.rst:75 ../../textwriter.rst:106 #: 6080d699b79c4e7cabc81e6632904644 8f2fdb3f4ec442f4b7703714fb642f4c msgid "a :ref:`Font`. If omitted, `pymupdf.Font(\"helv\")` will be used." msgstr ":ref:`Font`。省略された場合、`pymupdf.Font(\"helv\")` が使用されます。" #: ../../textwriter.rst:76 09fbce8fe4ee46b0a95710e2b4761014 msgid "the :data:`fontsize`, a positive number, default 11." msgstr ":data:`fontsize`、正の数、デフォルトは11です。" #: ../../textwriter.rst:77 ../../textwriter.rst:108 #: 4483c3fec8c3452cac52b7d831f281c1 87ccb28c8f1b4453af79b92ad4c5aabd msgid "" "the language to use, e.g. \"en\" for English. Meaningful values should be" " compliant with the ISO 639 standards 1, 2, 3 or 5. Reserved for future " "use: currently has no effect as far as we know." msgstr "" "使用する言語、例：英語の場合は \"en\"。意味のある値はISO " "639規格1、2、3、または5に準拠している必要があります。将来の使用を予約しています：現在はわかる限りでは何の効果もありません。" #: ../../textwriter.rst:78 d8bd68ad24da40269a51cc710d5053e8 msgid "" "*(New in v1.18.9)* whether the text should be written from right to left." " Applicable for languages like Arabian or Hebrew. Default is ``False``. " "If ``True``, any Latin parts within the text will automatically " "converted. There are no other consequences, i.e. " ":attr:`TextWriter.last_point` will still be the rightmost character, and " "there neither is any alignment taking place. Hence you may want to use " ":meth:`TextWriter.fill_textbox` instead." msgstr "" "*（バージョン1.18.9で新機能）* テキストを右から左に書くかどうか。アラビア語やヘブライ語などの言語に適用されます。デフォルトは " "``False`` です。``True`` " "の場合、テキスト内のラテン語部分は自動的に変換されます。他に何の影響もないため、:attr:`TextWriter.last_point` " "は依然として最右の文字ですし、配置も行われません。そのため、代わりに :meth:`TextWriter.fill_textbox` " "を使用することがあります。" #: ../../textwriter.rst:79 75daea05a2a449aa9e600dc6f54efa72 msgid "" "*(New in v1.18.15)* look for the character's Small Capital version in the" " font. If present, take that value instead. Otherwise the original " "character (this font or the fallback font) will be taken. The fallback " "font will never return small caps. For example, this snippet:: >>> doc =" " pymupdf.open() >>> page = doc.new_page() >>> text = \"PyMuPDF: the " "Python bindings for MuPDF\" >>> font = pymupdf.Font(\"figo\") # choose a" " font with small caps >>> tw = pymupdf.TextWriter(page.rect) >>> " "tw.append((50,100), text, font=font, small_caps=True) >>> " "tw.write_text(page) >>> doc.ez_save(\"x.pdf\") will produce this PDF " "text: .. image:: images/img-smallcaps.*" msgstr "" #: ../../textwriter.rst:79 46eb184e73ae4219ac1e4bed06322f56 msgid "" "*(New in v1.18.15)* look for the character's Small Capital version in the" " font. If present, take that value instead. Otherwise the original " "character (this font or the fallback font) will be taken. The fallback " "font will never return small caps. For example, this snippet::" msgstr "" "*（バージョン1.18.15で新機能）* " "フォント内の文字の小文字バージョンを探します。存在する場合、その値が使用されます。それ以外の場合、元の文字（このフォントまたはフォールバックフォント）が使用されます。フォールバックフォントは小文字バージョンを返しません。たとえば、次のスニペット::" #: ../../textwriter.rst:90 973003c33fe84aa69d42e2c43c861a09 msgid "will produce this PDF text:" msgstr "これにより、このPDFテキストが生成されます：" #: ../../textwriter.rst 031973dcb92c46dfb30974b0b0277dbb #: 56067c1753344901a2a112d292086782 6fe2f7cc1d5b405588798ce1725db0d6 msgid "Returns" msgstr "返り値：" #: ../../textwriter.rst:95 ../../textwriter.rst:111 #: 2916a5791a9446a1be47d9bdde016b5b 2d57d9c3e3404a1b8aaedf35dc4f6d7d msgid "" ":attr:`text_rect` and :attr:`last_point`. *(Changed in v1.18.0:)* Raises " "an exception for an unsupported font -- checked via " ":attr:`Font.is_writable`." msgstr "" ":attr:`text_rect` および :attr:`last_point`。 *（v1.18.0 " "で変更）*：サポートされていないフォントの場合、:attr:`Font.is_writable` を介してチェックされた例外が発生します。" #: ../../textwriter.rst:102 53cbfa2552fa46b2837c5848f6ae7eed msgid "Add some new text in vertical, top-to-bottom writing." msgstr "縦書きの新しいテキストを追加します。" #: ../../textwriter.rst:105 77e2561d4b4a448caf4a7b3ecbc624ce msgid "a string. It will be written starting at position \"pos\"." msgstr "文字列。 \"pos\" から開始して書き込まれます。" #: ../../textwriter.rst:107 1195a41741cd44ca8653fce3a3c8b23f msgid "the :data:`fontsize`, a positive float, default 11." msgstr ":data:`fontsize`、正の浮動小数点数、デフォルトは 11 です。" #: ../../textwriter.rst:109 ../../textwriter.rst:133 #: 48cdfcdb373b4a939b9ac2491aaf9f76 a007fa3bc26e4925bac3b3884fa1d6f4 msgid "*(New in v1.18.15)* see :meth:`append`." msgstr "*（v1.18.15 で新しい）* 詳細は :meth:`append` を参照してください。" #: ../../textwriter.rst:115 131d2ddda39f47e5b8750ce4e02aacf1 msgid "" "Changed in 1.17.3: New parameter `pos` to specify where to start writing " "within rectangle." msgstr "1.17.3で変更：新しいパラメーター `pos` を追加して、矩形内での書き込みを開始する位置を指定できるようにしました。" #: ../../textwriter.rst:116 29062b4cba8b458c9715b63563932eea msgid "" "Changed in v1.18.9: Return list of lines which do not fit in rectangle. " "Support writing right-to-left (e.g. Arabian, Hebrew)." msgstr "v1.18.9で変更：矩形に収まらない行のリストを返すようにしました。右から左に書くサポートを追加（アラビア語、ヘブライ語など）。" #: ../../textwriter.rst:117 1af15893d8c0406eaba47e8cbc605623 msgid "Changed in v1.18.15: Prefer small caps if supported by the font." msgstr "v1.18.15で変更：フォントがサポートしている場合、小文字のテキストを優先します。" #: ../../textwriter.rst:119 557382b2514d472bbe73f5017c792395 msgid "" "Fill a given rectangle with text in horizontal writing mode. This is a " "convenience method to use as an alternative for :meth:`append`." msgstr "指定された矩形を水平書きモードでテキストで埋めます。これは、:meth:`append` の代替手段として使用する便利な方法です。" #: ../../textwriter.rst:121 cef4e997c224414e95918704fa70b178 msgid "the area to fill. No part of the text will appear outside of this." msgstr "埋める領域。テキストのいずれの部分もこれの外には表示されません。" #: ../../textwriter.rst:122 eb9a1f87715c476190b440d505b21385 msgid "" "the text. Can be specified as a (UTF-8) string or a list / tuple of " "strings. A string will first be converted to a list using *splitlines()*." " Every list item will begin on a new line (forced line breaks)." msgstr "" "テキスト。UTF-8文字列または文字列のリスト/タプルとして指定できます。文字列は最初に *splitlines()* " "を使用してリストに変換されます。各リストアイテムは新しい行で始まります（強制的な改行が行われます）。" #: ../../textwriter.rst:123 adaa607ca4b34119b1413a21aa5d5703 msgid "" "*(new in v1.17.3)* start storing at this point. Default is a point near " "rectangle top-left." msgstr "*（v1.17.3で新規）* このポイントから記憶を開始します。デフォルトは矩形の左上近くのポイントです。" #: ../../textwriter.rst:124 093d30283065429a8003316402078989 msgid "the :ref:`Font`, default `pymupdf.Font(\"helv\")`." msgstr ":ref:`Font`、デフォルトは `pymupdf.Font(\"helv\")`。" #: ../../textwriter.rst:125 fa67844b1bdc4fd5b33c77ea89ae7619 msgid "the :data:`fontsize`." msgstr ":data:`fontsize`" #: ../../textwriter.rst:126 a3f0cf660cc34b2aa6461b460ccc9fd7 msgid "" "text alignment. Use one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " "TEXT_ALIGN_RIGHT or TEXT_ALIGN_JUSTIFY." msgstr "テキストの配置。TEXT_ALIGN_LEFT、TEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHT、またはTEXT_ALIGN_JUSTIFYのいずれかを使用します。" #: ../../textwriter.rst:127 fab2e37b003c4547a135db4871ab87f9 msgid "" "*(New in v1.18.9)* whether the text should be written from right to left." " Applicable for languages like Arabian or Hebrew. Default is ``False``. " "If ``True``, any Latin parts are automatically reverted. You must still " "set the alignment (if you want right alignment), it does not happen " "automatically -- the other alignment options remain available as well." msgstr "" "*(v1.18.9で新規）* テキストを右から左に書くかどうか。アラビア語やヘブライ語などの言語に適用可能です。デフォルトは ``False`` " "です。``True`` " "の場合、ラテン文字部分は自動的に反転されます。右寄せを希望する場合、引き続き配置を設定する必要があります（他の配置オプションも利用可能）。" #: ../../textwriter.rst:128 fbd4a0182852411d9c83784e6421be47 msgid "" "on text overflow do nothing, warn, or raise an exception. Overflow text " "will never be written. **Changed in v1.18.9:** * Default is ``None``. * " "The list of overflow lines will be returned." msgstr "" #: ../../textwriter.rst:128 0e6db582f2eb4eb28e4c2efbd9fb40e1 msgid "" "on text overflow do nothing, warn, or raise an exception. Overflow text " "will never be written. **Changed in v1.18.9:**" msgstr "テキストのオーバーフローがある場合、何もしない、警告する、または例外を発生させるかどうか。オーバーフローテキストは書き込まれません。**v1.18.9で変更：**" #: ../../textwriter.rst:130 cdae6e2706854c9e826f849d936c11ee msgid "Default is ``None``." msgstr "デフォルトは ``None`` です。" #: ../../textwriter.rst:131 1bda032411484b10b23479232b916047 msgid "The list of overflow lines will be returned." msgstr "オーバーフローラインのリストが返されます。" #: ../../textwriter.rst 035f3f34d091461bbe3cc1d030bfe153 #: 1871d0ab981b44759c8973a335232ef3 6459020d5302480fb99a57af3fd39d02 #: 92e14712db2944b694cdf765796b471d d0a0b9758d76412fb2a1f68276a1f782 #: f3e6dee2f74245bfa95d18620e9bd73d msgid "Return type" msgstr "" #: ../../textwriter.rst:136 396c812b4c0346d69cbc578eaae29744 msgid "" "*New in v1.18.9* -- List of lines that did not fit in the rectangle. Each" " item is a tuple `(text, length)` containing a string and its length (on " "the page)." msgstr "" "*v1.18.9で新規* -矩形に収まらなかった行のリスト。各アイテムは、文字列とそのページ上の長さ（長さ）を含むタプル `(text, " "length)` です。" #: ../../textwriter.rst:138 cd3a09fa82ee40e399e27a6aa0c1235d msgid "" "Use these methods as often as is required -- there is no technical limit " "(except memory constraints of your system). You can also mix " ":meth:`append` and text boxes and have multiple of both. Text positioning" " is exclusively controlled by the insertion point. Therefore there is no " "need to adhere to any order. *(Changed in v1.18.0:)* Raise an exception " "for an unsupported font -- checked via :attr:`Font.is_writable`." msgstr "" "これらのメソッドは必要な回数だけ使用できます。技術的な制限はありません（システムのメモリ制約を除く）。また、:meth:`append` " "とテキストボックスを混在させ、それぞれ複数持つこともできます。テキストの配置は挿入ポイントによってのみ制御されます。したがって、特定の順序に従う必要はありません。*（v1.18.0で変更）*" " ：サポートされていないフォントに対して例外を発生させます - :attr:`Font.is_writable` をチェックします。" #: ../../textwriter.rst:143 54709b98b30a47ac89166f31faf2772a msgid "" "Write the TextWriter text to a page, which is the only mandatory " "parameter. The other parameters can be used to temporarily override the " "values used when the TextWriter was created." msgstr "TextWriterのテキストをページに書き込みます。これは唯一の必須パラメータで、TextWriterが作成されたときに使用される値を一時的にオーバーライドするために、他のパラメータを使用できます。" #: ../../textwriter.rst:145 59f4fdcbbc44452680ba4c0c95aa5cff msgid "write to this :ref:`Page`." msgstr "この :ref:`Page` に書き込みます。" #: ../../textwriter.rst:146 ../../textwriter.rst:147 #: 376b4dcec8264f3db2f6be76d778904b d45c4d5a07474ef4a0cd683fdd04bcdc msgid "override the value of the TextWriter for this output." msgstr "この出力のためにTextWriterの値をオーバーライドします。" #: ../../textwriter.rst:148 ee07ac03480b41539d94053d359dd9d3 msgid "" "modify the text appearance by applying a matrix to it. If provided, this " "must be a sequence *(fixpoint, matrix)* with a point-like *fixpoint* and " "a matrix-like *matrix*. A typical example is rotating the text around " "*fixpoint*." msgstr "" "テキストの外観を変更するために、それに行列を適用して修正します。提供される場合、これは *（fixpoint、matrix）* " "としてシーケンスでなければなりません。point-like *fixpoint* とmatrix-like *matrix* " "を持っています。典型的な例は、テキストを *fixpoint* の周りで回転させることです。" #: ../../textwriter.rst:149 b45dc013b8e740f9bef33593ed5c8711 msgid "put in foreground (default) or background." msgstr "前景（デフォルト）または背景に配置します。" #: ../../textwriter.rst:150 ba9cfbd9695340699d7179b74412ef18 msgid "*(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`." msgstr "*（v1.18.4で新規）* :data:`OCG` または :data:`OCMD` の :data:`xref`。" #: ../../textwriter.rst:151 9523549f48f246a3ae03b7bc5f901456 msgid "" "The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible). " ".. image:: images/img-rendermode.*" msgstr "" #: ../../textwriter.rst:151 78528b40a6544fe0a046dee8ae6857ef msgid "The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible)." msgstr "PDF `Tr` 演算子の値。値：0（デフォルト）、1、2、3（不可視）。" #: ../../textwriter.rst:158 525f73853e924927ad796c65943a368d msgid "The area currently occupied." msgstr "現在占有されている領域。" #: ../../textwriter.rst:160 ../../textwriter.rst:184 #: ba565ed25cdd42f7862fcb93e757cf70 be5a7d304fd0479ea3d522fa0b628537 msgid ":ref:`Rect`" msgstr "" #: ../../textwriter.rst:164 87ebb8ff55c24240abc1589af86e4a9a msgid "" "The \"cursor position\" -- a :ref:`Point` -- after the last written " "character (its bottom-right)." msgstr "最後に書かれた文字の後にある「カーソル位置」 - :ref:`Point` 形式。" #: ../../textwriter.rst:166 ac55d30024ef4851bc1e890d44698e93 msgid ":ref:`Point`" msgstr "" #: ../../textwriter.rst:170 3f90c9a1dc4c4511a85d2dd1d614e275 msgid "The text opacity (modifiable)." msgstr "テキストの不透明度（変更可能）。" #: ../../textwriter.rst:176 40b6c71ad92443f69b941e2ae68ef65d msgid "The text color (modifiable)." msgstr "テキストの色（変更可能）。" #: ../../textwriter.rst:182 c8c0cc26dcc643b4b7a36449cc37508b msgid "" "The page rectangle for which this TextWriter was created. Must not be " "modified." msgstr "このTextWriterが作成されたページの長方形。変更しないでください。" #: ../../textwriter.rst:187 96d56c1eedc9403da49260989a4dc7c5 #, fuzzy msgid "" "To see some demo scripts dealing with TextWriter, have a look at `the " "TextWriter demo scripts `_." msgstr "" "TextWriterを扱うデモスクリプトを見るには、`この `_ リポジトリをご覧ください。" #: ../../textwriter.rst:189 86f5ad85ef9f430798003667a5d4bba8 msgid "Opacity and color apply to **all the text** in this object." msgstr "不透明度と色は、このオブジェクト内の **すべてのテキスト** に適用されます。" #: ../../textwriter.rst:190 3fd56e7645674dd592624498a3b40033 msgid "" "If you need different colors / transparency, you must create a separate " "TextWriter. Whenever you determine the color should change, simply append" " the text to the respective TextWriter using the previously returned " ":attr:`last_point` as position for the new text span." msgstr "" "異なる色/透明度が必要な場合、別々のTextWriterを作成する必要があります。色が変更されるべきと判断した場合、新しいテキストスパンの位置として前回返された" " :attr:`last_point` を使用して、対応するTextWriterにテキストを追加するだけです。" #: ../../textwriter.rst:191 473cca9e82e445e7a947ffeaead9f1d6 msgid "" "Appending items or text boxes can occur in arbitrary order: only the " "position parameter controls where text appears." msgstr "アイテムまたはテキストボックスの追加は任意の順序で発生できます：テキストが表示される位置を制御するのは、位置パラメータのみです。" #: ../../textwriter.rst:192 e86c99a3e580410c80b33c1b9273d1e5 msgid "" "Font and :data:`fontsize` can freely vary within the same TextWriter. " "This can be used to let text with different properties appear on the same" " displayed line: just specify *pos* accordingly, and e.g. set it to " ":attr:`last_point` of the previously added item." msgstr "" "同じTextWriter内でフォントと :data:`fontsize` " "を自由に変更できます。これは、異なるプロパティを持つテキストが同じ表示される行に表示されるようにするために使用できます。posを適切に指定し、前に追加したアイテムの" " :attr:`last_point` に設定してください。" #: ../../textwriter.rst:193 0dd912f04fa84ab7832bd944567f6dc1 msgid "" "You can use the *pos* argument of :meth:`TextWriter.fill_textbox` to set " "the position of the first text character. This allows filling the same " "textbox with contents from different :ref:`TextWriter` objects, thus " "allowing for multiple colors, opacities, etc." msgstr "" ":meth:`TextWriter.fill_textbox` の *pos* " "引数を使用して、最初のテキスト文字の位置を設定できます。これにより、異なる :ref:`TextWriter` " "オブジェクトからのコンテンツを含む同じテキストボックスを埋めることができ、複数の色、不透明度などが可能になります。" #: ../../textwriter.rst:194 46ddcc45b9594214860870dcb571f619 msgid "" "MuPDF does not support all fonts with this feature, e.g. no Type3 fonts. " "Starting with v1.18.0 this can be checked via the font attribute " ":attr:`Font.is_writable`. This attribute is also checked when using " ":ref:`TextWriter` methods." msgstr "" "MuPDFは、この機能を持つすべてのフォントをサポートしているわけではありません。たとえば、Type3フォントはサポートされていません。v1.18.0以降、:attr:`Font.is_writable`" " 属性を使用して、これを確認できます。この属性は、:ref:`TextWriter` メソッドを使用する際にもチェックされます。" #: ../../footer.rst:46 b6d5682a116d45b9b5a6850c9cfd6f9e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "" #~ "**Free font choice:** Each text span " #~ "has its own font and fontsize. " #~ "This lets you easily switch when " #~ "composing a larger text." #~ msgstr "" #~ msgid "the fontsize, a positive number, default 11." #~ msgstr "" #~ msgid "the fontsize, a positive float, default 11." #~ msgstr "" #~ msgid "the fontsize." #~ msgstr "" #~ msgid "" #~ "Font and fontsize can freely vary " #~ "within the same TextWriter. This can " #~ "be used to let text with different" #~ " properties appear on the same " #~ "displayed line: just specify *pos* " #~ "accordingly, and e.g. set it to " #~ ":attr:`last_point` of the previously added " #~ "item." #~ msgstr "" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/the-basics.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ebd72ea23c554adea55b860ac32cfd10 msgid "Artifex" msgstr "" #: ../../header.rst:-1 d808fab239944edbb4a07604487c3d4d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 32d34325b50d49718d4ae087152d121b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../the-basics.rst:8 3ef401bbe47d4d928056b1ad88406df4 msgid "The Basics" msgstr "基本" #: ../../the-basics.rst:13 7ad7d2aeeb0949939d1edf110e9cde48 msgid "Opening a File" msgstr "ファイルを開く" #: ../../the-basics.rst:16 b3977994add44c128857ebe6778dbce8 msgid "To open a file, do the following:" msgstr "ファイルを開くには、以下の手順を実行してください：" #: ../../the-basics.rst:27 ../../the-basics.rst:58 ../../the-basics.rst:119 #: ../../the-basics.rst:149 ../../the-basics.rst:199 ../../the-basics.rst:249 #: ../../the-basics.rst:287 ../../the-basics.rst:377 ../../the-basics.rst:416 #: ../../the-basics.rst:467 ../../the-basics.rst:553 ../../the-basics.rst:638 #: ../../the-basics.rst:694 ../../the-basics.rst:886 ../../the-basics.rst:1070 #: 2739866db7be4d6fbd854a42404c20bb 279266de676f42ee8ca372b72f1b50d3 #: 42d583c1c82e4c1c9c61e4221d22858b 4bbc83d3c8014f94bca9c10402d0772f #: 6eb5cd518be24829a8fea50dc936924e 6f01de37c57b45dd826d3e9df5dd3352 #: 72e59350df88431bb0d56787d262e6f3 76f22999a4234db0a736d9b66557dd9a #: 9aa232f9bff64aec84bc0061ae859fde a56f4151e39f4227823677221a30af73 #: cb848559a7ed4bceb96742c75b6a8a26 d2d7c31ddd6a4481afad882faa434f0c #: d8991f84c3e6479fa2c6050dd8b27e28 e70c606f8abd4024a11d97fb8f7cd006 #: fabe4bd1a2d042da9318fbae362a32ad msgid "**Taking it further**" msgstr "**さらに進む**" #: ../../the-basics.rst:29 1ec0b9c37a314b2cb8dde60de149c32e msgid "" "See the :ref:`list of supported file types` and " ":ref:`The How to Guide on Opening Files ` for more " "advanced options." msgstr "" "より高度なオプションについては、:ref:`サポートされている ` と " ":ref:`ファイルを開く方法ガイド` のリストを参照してください。" #: ../../the-basics.rst:38 cb07704fb73043b2827ddfe5306bb8eb msgid "Extract text from a |PDF|" msgstr "|PDF| からテキストを抽出する" #: ../../the-basics.rst:40 63223b54f3cc495aa83fddc584a650c9 msgid "To extract all the text from a |PDF| file, do the following:" msgstr "|PDF| ファイルからすべてのテキストを抽出するには、以下の手順を実行してください：" #: ../../the-basics.rst:54 82cde87ae4a8477cb30daea5d72f5f54 msgid "" "Of course it is not just |PDF| which can have text extracted - all the " ":ref:`supported document file formats ` such as " ":title:`MOBI`, :title:`EPUB`, :title:`TXT` can have their text extracted." msgstr "" "もちろん、PDFだけでなく、MOBI、EPUB、TXTなどの :ref:`サポートされているドキュメントファイル形式 " "` でもテキストを抽出できます。" #: ../../the-basics.rst:60 68a8a1314b8a474a9636d7ff5ebf2245 msgid "" "If your document contains image based text content the use OCR on the " "page for subsequent text extraction:" msgstr "もし文書に画像ベースのテキストコンテンツが含まれている場合は、後続のテキスト抽出のためにそのページでOCRを使用してください。" #: ../../the-basics.rst:67 ../../the-basics.rst:121 #: 009d24e7339b46f7afe03c6afa62fbd2 b502b55793844906a001df204caff15f msgid "" "There are many more examples which explain how to extract text from " "specific areas or how to extract tables from documents. Please refer to " "the :ref:`How to Guide for Text`." msgstr "特定の領域からテキストを抽出する方法や、文書から表を抽出する方法など、さらに多くの例があります。テキストの方法ガイドを参照してください。" #: ../../the-basics.rst:69 58a9cf1efe6a40b5ada05038e2d55412 msgid "" "You can now also :ref:`extract text in Markdown " "format`." msgstr ":ref:`Markdown形式でテキストを抽出 ` することもできます。" #: ../../the-basics.rst:71 ../../the-basics.rst:123 ../../the-basics.rst:153 #: ../../the-basics.rst:208 ../../the-basics.rst:255 ../../the-basics.rst:291 #: ../../the-basics.rst:318 ../../the-basics.rst:343 ../../the-basics.rst:383 #: ../../the-basics.rst:420 ../../the-basics.rst:474 ../../the-basics.rst:500 #: ../../the-basics.rst:527 ../../the-basics.rst:608 ../../the-basics.rst:659 #: ../../the-basics.rst:698 ../../the-basics.rst:762 ../../the-basics.rst:821 #: ../../the-basics.rst:898 ../../the-basics.rst:928 ../../the-basics.rst:964 #: ../../the-basics.rst:990 ../../the-basics.rst:1074 #: 06196b3b11364bd8ba72a68806270fbc 28f136db73ea4ff8b27a322e19a05299 #: 2a2f674929bc4956b9fa645ec55231da 2a42d66f67ea469da857b3aefcefb111 #: 34dfbca2e1ef487085d769c401e479da 4b5819a0804e42669c6c95bd78540195 #: 57551550d33b446da752ec01b2d38be1 58193e34f85e4f3286969bb715d2ed1b #: 758afc8b33924ed7afa93712789855ff 7c7a34a487ba49719ca245b940618040 #: 926638700d944932adaab0f81e219328 99f090981eab4af2adb7c096da2ae2e3 #: 9f4be351ab174a7fbfd5426ee671e7f8 ac69cd30aed24f97aa9c7c5eff88d4b3 #: adf8863e8d274a1e9e4cd774f4b6c024 b6dfec45d83b42e68fc997fcb0213e92 #: c34132ed22984098ac5b8bd1e9a4806b c8f4c6c1d0ee4228977d9294144fbc0e #: cb4e3c70daa14279926090c987c7a950 e547959996fc49f483ba7574079782d7 #: f8047ddd3ad0454c8c7eb0d0258590f1 fca50bef410a492eb5e9db5cd98453f0 #: fd039b9c5e9e49b2a72044dabcf4d52c msgid "**API reference**" msgstr "**APIリファレンス**" #: ../../the-basics.rst:73 099a4007de224f26813b7e0c6086aba5 msgid ":meth:`Page.get_text`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:85 3478a0ef399a4f90bdf04e54b4b848f8 msgid "Extract images from a |PDF|" msgstr "|PDF| から画像を抽出する" #: ../../the-basics.rst:87 2c137c284bae4ff3bd22402af36ebe06 msgid "To extract all the images from a |PDF| file, do the following:" msgstr "|PDF| すべての画像を抽出するには、以下の手順を実行してください：" #: ../../the-basics.rst:125 58022a36615f4658a70db9b3d3cb08c0 msgid ":meth:`Page.get_images`" msgstr "" #: ../../the-basics.rst:126 887f2573340f469a8f4bb2e328eaf5a3 msgid ":ref:`Pixmap`" msgstr "" #: ../../the-basics.rst:133 734558bdb8694762a5d412b1e2faa7e9 msgid "Extract vector graphics" msgstr "ベクトルグラフィックスを抽出" #: ../../the-basics.rst:135 0377de0bb75a443c8d1266b4d5b21c9a msgid "To extract all the vector graphics from a document page, do the following:" msgstr "ドキュメントのページからすべてのベクトルグラフィックスを抽出するには、以下の手順に従います：" #: ../../the-basics.rst:145 495a59882911438aae6c87d4c09cc096 msgid "" "This will return a dictionary of paths for any vector drawings found on " "the page." msgstr "これにより、ページ上で見つかったすべてのベクター図形のパスの辞書が返されます。" #: ../../the-basics.rst:151 edb401df140347688dfb686967959746 msgid "" "Please refer to: :ref:`How to Extract " "Drawings`." msgstr "" "次のページを参照してください： :ref:`「描画の抽出方法」 " "`。" #: ../../the-basics.rst:155 99278f5d80fa49a1b1b55bb0d070fe0a #, fuzzy msgid ":meth:`Page.get_drawings`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:166 3f2a04b771b4465fba3841d4145c94eb msgid "Merging |PDF| files" msgstr "|PDF| ファイルの結合" #: ../../the-basics.rst:168 00fbed70866b44078ae8b3f72592c767 msgid "To merge |PDF| files, do the following:" msgstr "|PDF| ファイルを結合するには、以下の手順を実行してください：" #: ../../the-basics.rst:182 2c3a5d3d3d264086993c70ed0f9610ad msgid "Merging |PDF| files with other types of file" msgstr "|PDF| ァイルと他の種類のファイルを結合する" #: ../../the-basics.rst:184 2a56bc4e77b14621bdc02e63f9456750 msgid "" "With :meth:`Document.insert_file` you can invoke the method to merge " ":ref:`supported files` with |PDF|. For example:" msgstr "" ":meth:`Document.insert_file` " "を使用すると、サポートされているファイルをPDFと結合するメソッドを呼び出すことができます。例えば：" #: ../../the-basics.rst:201 f2e00ac506914ac4b90cf6ba9b933452 #, fuzzy msgid "" "It is easy to join PDFs with :meth:`Document.insert_pdf` & " ":meth:`Document.insert_file`. Given open |PDF| documents, you can copy " "page ranges from one to the other. You can select the point where the " "copied pages should be placed, you can revert the page sequence and also " "change page rotation." msgstr "" ":meth:`Document.insert_pdf` と :meth:`Document.insert_file` " "を使用すれば、PDFを簡単に結合できます。開かれたPDF文書がある場合、片方のPDFから別のPDFへページの範囲をコピーすることができます。コピーされたページが配置される位置を選択することができ、ページの順序を元に戻すこともできます。さらに、ページの回転も変更することができます。詳細な説明はこの" " `Wiki `_ の記事に記載されています。" #: ../../the-basics.rst:203 097d528e7b89483887fe9b103286246d msgid "" "The GUI script `join.py `_ uses this method" " to join a list of files while also joining the respective table of " "contents segments. It looks like this:" msgstr "" "GUIスクリプト `join.py `_ " "では、この方法を使用してファイルのリストを結合し、それぞれの目次セグメントも結合します。スクリプトの見た目は以下のようになっています:" #: ../../the-basics.rst:210 1fbf6ae246834c7daa68bb87e30c563d msgid ":meth:`Document.insert_pdf`" msgstr "" #: ../../the-basics.rst:211 eb458481793c4cb1b1e232362c454d05 msgid ":meth:`Document.insert_file`" msgstr "" #: ../../the-basics.rst:218 b75e34a3e76543769aa5c7b08099b88e msgid "Working with Coordinates" msgstr "座標を扱う" #: ../../the-basics.rst:220 ba6915f5f3614cfc866c5d6a96dd7561 msgid "" "There is one *mathematical term* that you should feel comfortable with " "when using |PyMuPDF| - **\"coordinates\"**. Please have a quick look at " "the :ref:`Coordinates` section to understand the coordinate system to " "help you with positioning objects and understand your document space." msgstr "" "|PyMuPDF| を使用する際に快適に感じるべき *数学用語* が1つあります - **「座標」** " "です。オブジェクトの配置や文書空間の理解に役立つ座標系を理解するために、:ref:`Coordinates` セクションを簡単にご覧ください。" #: ../../the-basics.rst:229 1a7cee38451a4ac49f536db1c8867f23 msgid "Adding a watermark to a |PDF|" msgstr "|PDF| ファイルにウォータマークを追加する方法" #: ../../the-basics.rst:231 7a831a320dcb4d03b66a33b5656a1592 msgid "To add a watermark to a |PDF| file, do the following:" msgstr "|PDF| ファイルにウォータマークを追加するには、以下の手順を実行してください:" #: ../../the-basics.rst:251 32163f8855f94b3da489e46235d0f84f msgid "" "Adding watermarks is essentially as simple as adding an image at the base" " of each |PDF| page. You should ensure that the image has the required " "opacity and aspect ratio to make it look the way you need it to." msgstr "ウォータマークを追加することは、基本的には各PDFページの底辺に画像を追加するだけです。画像が必要な透明度とアスペクト比を持っていることを確認して、必要な見た目になるようにします。" #: ../../the-basics.rst:253 8b5f52f2d540405f8e19f3ff6efd6007 msgid "" "In the example above a new image is created from each file reference, but" " to be more performant (by saving memory and file size) this image data " "should be referenced only once - see the code example and explanation on " ":meth:`Page.insert_image` for the implementation." msgstr "" "前述の例では、各ファイル参照から新しい画像が作成されていますが、メモリとファイルサイズを節約するために、この画像データは1回だけ参照されるようにすると、パフォーマンスが向上します" " - Page.insert_image()のコード例と説明を参照してください。" #: ../../the-basics.rst:257 fcfe127ad9414e8a9a9f6fe506eca749 msgid ":meth:`Page.bound`" msgstr "" #: ../../the-basics.rst:258 ../../the-basics.rst:294 #: 2122203304f24c7e86364c4e44d8c515 5bd4a37b290b484ab12ffef1d743e039 msgid ":meth:`Page.insert_image`" msgstr "" #: ../../the-basics.rst:267 74156cf07c4c44abb86f01275234c22c msgid "Adding an image to a |PDF|" msgstr "|PDF| に画像を追加する" #: ../../the-basics.rst:269 e4ad47cff3e149b09cfcee436ce71ec0 msgid "To add an image to a |PDF| file, for example a logo, do the following:" msgstr "PDFファイルに画像を追加するためには、例えばロゴを追加する場合、以下の手順を実行してください：" #: ../../the-basics.rst:289 ef303cbd63ea4d6cae44d744a77253f8 msgid "" "As with the watermark example you should ensure to be more performant by " "only referencing the image once if possible - see the code example and " "explanation on :meth:`Page.insert_image`." msgstr "" "ウォータマークの例と同様に、できる限り画像を1回だけ参照することで、より効率的な処理を行うようにしてください。詳細は " ":meth:`Page.insert_image` のコード例と説明を参照してください。" #: ../../the-basics.rst:293 0a5e74d57a334f90b301d4f7266ae6a7 msgid ":ref:`Rect`" msgstr "" #: ../../the-basics.rst:303 97f7c41b4fcc40d297f51e89344ec00e msgid "Rotating a |PDF|" msgstr "|PDF| を回転させる" #: ../../the-basics.rst:305 a6bb30db140947ee94661859e458334a msgid "To add a rotation to a page, do the following:" msgstr "ページに回転を追加するには、以下の手順を実行してください：" #: ../../the-basics.rst:320 5b2ac1a6f5284ffdbcf63f04a5bb87e3 msgid ":meth:`Page.set_rotation`" msgstr "" #: ../../the-basics.rst:328 5d0f43e3da814e9195c2500beb9b2aae msgid "Cropping a |PDF|" msgstr "|PDF| のトリミング" #: ../../the-basics.rst:330 ebcd5ad854a344fb8fdb76e0f157f822 msgid "To crop a page to a defined :ref:`Rect`, do the following:" msgstr "定義された矩形 :ref:`Rect` にページをトリミングするには、以下の手順を実行してください：" #: ../../the-basics.rst:345 10f26d2a0e9f428c877fe76eca3149b4 msgid ":meth:`Page.set_cropbox`" msgstr "" #: ../../the-basics.rst:354 37f2015ccbe843179609bdd2ce54ce25 msgid ":index:`Attaching Files `" msgstr ":index:`ファイルの添付 `" #: ../../the-basics.rst:356 73fa4a36d3114266a5b8c37898cdd520 msgid "To attach another file to a page, do the following:" msgstr "別のファイルをページに添付するには、以下の手順を実行してください：" #: ../../the-basics.rst:379 fef41696e0104638bfa7e9e46f94d5da msgid "" "When adding the file with :meth:`Page.add_file_annot` note that the third" " parameter for the `filename` should include the actual file extension. " "Without this the attachment possibly will not be able to be recognized as" " being something which can be opened. For example, if the `filename` is " "just *\"attachment\"* when view the resulting PDF and attempting to open " "the attachment you may well get an error. However, with " "*\"attachment.pdf\"* this can be recognized and opened by PDF viewers as " "a valid file type." msgstr "" ":meth:`Page.add_file_annot` " "でファイルを追加する際には、ファイル名を指定する第三引数には実際のファイルの拡張子を含める必要があります。これがないと、添付ファイルが開けるものとして認識されない可能性があります。例えば、ファイル名が単に「attachment」とだけ指定されている場合、生成されたPDFを見て添付ファイルを開こうとするとエラーが発生するかもしれません。しかし、「attachment.pdf」と指定されている場合、PDFビューアーで有効なファイルタイプとして認識され、開くことができます。" #: ../../the-basics.rst:381 2eb971ca49044acfb758808877174159 msgid "" "The default icon for the attachment is by default a \"push pin\", however" " you can change this by setting the `icon` parameter." msgstr "添付ファイルのデフォルトアイコンは「押しピン」ですが、 `icon` パラメータを設定することでこれを変更することができます。" #: ../../the-basics.rst:385 472cb94f410f45d389386b479f752c7d msgid ":ref:`Point`" msgstr "" #: ../../the-basics.rst:386 ../../the-basics.rst:422 #: bc83ca635d004bbea323fc12889c3475 e3b71ff6dabe4e7092a149500b391650 msgid ":meth:`Document.tobytes`" msgstr "" #: ../../the-basics.rst:387 861dcb9381e943f982a5ff2233584d56 msgid ":meth:`Page.add_file_annot`" msgstr "" #: ../../the-basics.rst:396 36ca0a3374d84c2d914b97f4600f49bc msgid ":index:`Embedding Files `" msgstr ":index:`ファイルを埋め込む `" #: ../../the-basics.rst:398 3d3da8f629564876915a4356adb5a4c5 msgid "To embed a file to a document, do the following:" msgstr "ファイルを文書に埋め込むには、以下の手順を実行してください：" #: ../../the-basics.rst:418 522ee31eaa5c4be29e943f9e031733ce msgid "" "As with :ref:`attaching files`, when adding " "the file with :meth:`Document.embfile_add` note that the first parameter " "for the `filename` should include the actual file extension." msgstr "" "ファイルを添付する場合と同様に、 :meth:`Document.embfile_add` " "でファイルを追加する際には、ファイル名を指定する第一引数には実際のファイルの拡張子を含める必要があります" #: ../../the-basics.rst:423 d105ed0d5499461a9a468719a7df3543 msgid ":meth:`Document.embfile_add`" msgstr "" #: ../../the-basics.rst:433 2182d5b6f29e40d39aab4f677fedfa2b msgid "Deleting Pages" msgstr "ページを削除する" #: ../../the-basics.rst:435 634d1c5913ad422281859654914d1268 msgid "To delete a page from a document, do the following:" msgstr "文書からページを削除するには、以下の手順を実行してください：" #: ../../the-basics.rst:445 437764ad7c2747118b3feb3fa4f1367b msgid "To delete a multiple pages from a document, do the following:" msgstr "複数のページを文書から削除するには、以下の手順を実行してください：" #: ../../the-basics.rst:459 7ffda49506894b2ca02ad9e6bc7e975a msgid "What happens if I delete a page referred to by bookmarks or hyperlinks?" msgstr "ブックマークやハイパーリンクで参照されているページを削除した場合、どうなりますか？" #: ../../the-basics.rst:461 9ccef7fc01e34b1f890333f741269c36 msgid "" "A bookmark (entry in the Table of Contents) will become inactive and will" " no longer navigate to any page." msgstr "ブックマーク（目次のエントリー）は無効になり、もはやどのページにもナビゲートしません" #: ../../the-basics.rst:463 2db9a64894ac4cc5926029b386cc8dbc msgid "" "A hyperlink will be removed from the page that contains it. The visible " "content on that page will not otherwise be changed in any way." msgstr "ハイパーリンクは、それを含むページから削除されます。そのページの可視コンテンツは、他の方法で変更されることはありません。" #: ../../the-basics.rst:469 a64aa50abd5848b8a15b0f27de5f2595 msgid "" "The page index is zero-based, so to delete page 10 of a document you " "would do the following `doc.delete_page(9)`." msgstr "ページのインデックスは0から始まるため、文書の10ページ目を削除するには、以下のようにします: `doc.delete_page(9)`。" #: ../../the-basics.rst:471 fb3cae6bf2b54a59b81ff59a5bb7563e msgid "" "Similarly, `doc.delete_pages(from_page=9, to_page=14)` will delete pages " "10 - 15 inclusive." msgstr "" "同様に、 `doc.delete_pages(from_page=9, to_page=14)` " "は、ページ10からページ15までを含む範囲のページを削除します。" #: ../../the-basics.rst:476 ed756abf6b3e413c9ffbb5a6caf6b88b msgid ":meth:`Document.delete_page`" msgstr "" #: ../../the-basics.rst:477 65198e829eef4bb381f47ddf30cc7e4f msgid ":meth:`Document.delete_pages`" msgstr "" #: ../../the-basics.rst:485 7bbd41be5ecb4d2e9c76a3a244cca14d msgid "Re-Arranging Pages" msgstr "ページを再配置する" #: ../../the-basics.rst:487 a1f98aa6a7714dab99cef5e054cfb3bd msgid "To change the sequence of pages, i.e. re-arrange pages, do the following:" msgstr "ページを再配置するには、以下の手順を実行してください：" #: ../../the-basics.rst:502 f179f7f7f5794947ac4541278ba55b6e msgid ":meth:`Document.move_page`" msgstr "" #: ../../the-basics.rst:511 d21575e2370d4ad4ab02f2ab07dd150c msgid "Copying Pages" msgstr "ページをコピーする" #: ../../the-basics.rst:514 57a67ecb95784254803c922f7d08f6c6 msgid "To copy pages, do the following:" msgstr "ページをコピーするには、以下の手順を実行してください：" #: ../../the-basics.rst:529 5a496f287a5b41fbb7d2b54cb5c697c8 msgid ":meth:`Document.copy_page`" msgstr "" #: ../../the-basics.rst:537 892cc58284e0408d8b96e992e24544cb msgid "Selecting Pages" msgstr "ページを選択する" #: ../../the-basics.rst:540 3db8f868455c4422a22a8739d7651725 msgid "To select pages, do the following:" msgstr "ページを選択するには、以下の手順を実行してください：" #: ../../the-basics.rst:555 09491c46d0124346a4620dc928ac2a9e msgid "" "With |PyMuPDF| you have all options to copy, move, delete or re-arrange " "the pages of a |PDF|. Intuitive methods exist that allow you to do this " "on a page-by-page level, like the :meth:`Document.copy_page` method." msgstr "" "|PyMuPDF| を使用すると、 |PDF| のページをコピー、移動、削除、または再配置するためのオプションがすべて揃っています。 " ":meth:`Document.copy_page` メソッドのように、ページ単位で直感的なメソッドを使用してこれらの操作を行うことができます。" #: ../../the-basics.rst:557 f38fd21a8beb4136bb4eda2f7ed52873 msgid "" "Or you alternatively prepare a complete new page layout in form of a " ":title:`Python` sequence, that contains the page numbers you want, in the" " sequence you want, and as many times as you want each page. The " "following may illustrate what can be done with :meth:`Document.select`" msgstr "" "または、 :title:`Python` " "のシーケンスとして完全な新しいページレイアウトを準備し、希望するページ番号を希望する順序で含め、必要なページ数だけ繰り返すこともできます。次の例は、" " :meth:`Document.select` を使用した可能性を示しています。" #: ../../the-basics.rst:564 88e421ecb4fc4d56adaf214dccae4daa msgid "" "Now let's prepare a PDF for double-sided printing (on a printer not " "directly supporting this):" msgstr "以下のように、両面印刷用にPDFを準備しましょう（直接これをサポートしていないプリンターで）：" #: ../../the-basics.rst:566 74d3cda3847c46b7af864e6bc7c19cf8 msgid "" "The number of pages is given by `len(doc)` (equal to `doc.page_count`). " "The following lists represent the even and the odd page numbers, " "respectively:" msgstr "" "ページ数は `len(doc)`（ `doc.page_count` " "と同じ）で与えられます。以下のリストは、それぞれ偶数ページと奇数ページの番号を表しています：" #: ../../the-basics.rst:573 2e020acac7f14b078d00def4cebc4fec msgid "" "This snippet creates the respective sub documents which can then be used " "to print the document:" msgstr "このスニペットは、それぞれのサブドキュメントを作成し、それらを使用してドキュメントを印刷することができます：" #: ../../the-basics.rst:585 a77fc70595bb4766ad8a0d5ffca2b8cf msgid "" "For more information also have a look at this Wiki `article " "`_." msgstr "" "詳細については、この `ウィキの記事 `_ もご覧ください。" #: ../../the-basics.rst:588 6c87cc6c645e4408a02889aca746f748 msgid "" "The following example will reverse the order of all pages (**extremely " "fast:** sub-second time for the 756 pages of the :ref:`AdobeManual`):" msgstr "" "次の例は、すべてのページの順序を逆にするものです（非常に高速: :ref:`AdobeManual` " "リファレンスの756ページをサブセカンドの時間で処理します）。" #: ../../the-basics.rst:598 b9eda6c35a9b4b569375594839df0a97 msgid "" "This snippet duplicates the PDF with itself so that it will contain the " "pages *0, 1, ..., n, 0, 1, ..., n* **(extremely fast and without " "noticeably increasing the file size!)**:" msgstr "このスニペットは、PDFを自身と重複させることで、ページ0、1、…、n、0、1、…、nを含むようにします（非常に高速で、ファイルサイズをほとんど増やさずに実現します！）：" #: ../../the-basics.rst:610 db170cb4731c4d9fb983242366f6e186 msgid ":meth:`Document.select`" msgstr "" #: ../../the-basics.rst:621 11bf1fc8a6144c888028b25e240c5514 msgid "Adding Blank Pages" msgstr "空白のページを追加する" #: ../../the-basics.rst:623 e6ba26e2fe264930b67c0e9ff511017c msgid "To add a blank page, do the following:" msgstr "空白のページを追加するには、以下の手順を行います：" #: ../../the-basics.rst:640 c73c566766104c198225c46f3fa4b332 msgid "Use this to create the page with another pre-defined paper format:" msgstr "以下の方法を使用して、別の事前定義された用紙フォーマットを使ってページを作成します：" #: ../../the-basics.rst:648 fa99380598a74f60a839a06cb2b9f706 msgid "" "The convenience function :meth:`paper_size` knows over 40 industry " "standard paper formats to choose from. To see them, inspect dictionary " ":attr:`paperSizes`. Pass the desired dictionary key to :meth:`paper_size`" " to retrieve the paper dimensions. Upper and lower case is supported. If " "you append \"-L\" to the format name, the landscape version is returned." msgstr "" "便利な関数 :meth:`paper_size` は、40以上の業界標準の用紙フォーマットを選択できます。それらを確認するには、辞書 " "attr:`paperSizes` を調べてください。用紙の寸法を取得するために、希望する辞書キーを :meth:`paper_size` " "に渡します。大文字と小文字の両方がサポートされています。フォーマット名に「-L」を追加すると、横長バージョンが返されます。" #: ../../the-basics.rst:650 7bb204302fe64b9c8102ce9b60e306f1 msgid "" "Here is a 3-liner that creates a |PDF|: with one empty page. Its file " "size is 460 bytes:" msgstr "以下は、1ページの空白の |PDF|: を作成するための3行のコードです。ファイルサイズは460バイトです。" #: ../../the-basics.rst:661 16708fa927574853b07cfbe391fa574a msgid ":meth:`Document.new_page`" msgstr "" #: ../../the-basics.rst:662 555dd6a7a4ca428ca05ffe585eb7dd98 msgid ":attr:`paperSizes`" msgstr "" #: ../../the-basics.rst:671 0c9d0f6b0af141bc92c8094e7d5d0fee msgid "Inserting Pages with Text Content" msgstr "ページにテキストコンテンツを挿入する" #: ../../the-basics.rst:673 8801a769c6764d358d2334b4dd80e5d6 msgid "" "Using the :meth:`Document.insert_page` method also inserts a new page and" " accepts the same `width` and `height` parameters. But it lets you also " "insert arbitrary text into the new page and returns the number of " "inserted lines." msgstr "" ":meth:`Document.insert_page` " "メソッドを使用すると、新しいページが挿入され、同じ幅と高さのパラメーターが受け入れられます。しかし、このメソッドでは新しいページに任意のテキストを挿入することができ、挿入された行数が返されます。" #: ../../the-basics.rst:696 1f709a1e688c4c64ad9835a43df6b7e5 msgid "" "The text parameter can be a (sequence of) string (assuming UTF-8 " "encoding). Insertion will start at :ref:`Point` (50, 72), which is one " "inch below top of page and 50 points from the left. The number of " "inserted text lines is returned." msgstr "" "テキストパラメーターは、UTF-8エンコーディングを想定している（シーケンスの）文字列です。挿入はページの上端から1インチ下であるポイント " ":ref:`Point` (50, 72) から始まり、左から50ポイントの位置です。挿入されたテキストの行数が返されます。" #: ../../the-basics.rst:700 5503e405b8a74c46ac510d142a942f92 msgid ":meth:`Document.insert_page`" msgstr "" #: ../../the-basics.rst:711 28cd42d51f99409a89dd644e5a331e95 msgid "Splitting Single Pages" msgstr "単一のページを分割する" #: ../../the-basics.rst:713 7caccc9bbcaa4fa2941b493e69be1447 msgid "" "This deals with splitting up pages of a |PDF| in arbitrary pieces. For " "example, you may have a |PDF| with *Letter* format pages which you want " "to print with a magnification factor of four: each page is split up in 4 " "pieces which each going to a separate |PDF| page in *Letter* format " "again." msgstr "" "この方法は、 |PDF| のページを任意の部分に分割することに関連しています。例えば、Letterフォーマットのページを含む |PDF| " "を、4倍の拡大率で印刷したい場合を考えてみましょう。各ページは4つの部分に分割され、それぞれが再びLetterフォーマットの個別の |PDF| " "ページになります。" #: ../../the-basics.rst:756 ../../the-basics.rst:814 #: 3ad50277922f4b4c9ce6e2eb2d3b4350 650a82fa6a3444c7b4f1119637692c77 msgid "Example:" msgstr "例:" #: ../../the-basics.rst:764 ../../the-basics.rst:823 #: 7f62edf5aa794474925340a623c05d4b a9ff4ea823fa4eaf80c415c485663e6b msgid ":meth:`Page.cropbox_position`" msgstr "" #: ../../the-basics.rst:765 ../../the-basics.rst:824 #: 86564b77e5c3440dba3f909f25fed95e ffceed2bb2ac4e738336a3eb438cb502 msgid ":meth:`Page.show_pdf_page`" msgstr "" #: ../../the-basics.rst:775 02e8677a9ee44d47acfb3845cbeb17f3 msgid "Combining Single Pages" msgstr "単一のページを結合する" #: ../../the-basics.rst:777 2f61c36415a847069ab18578a22a28b3 msgid "" "This deals with joining |PDF| pages to form a new |PDF| with pages each " "combining two or four original ones (also called \"2-up\", \"4-up\", " "etc.). This could be used to create booklets or thumbnail-like overviews." msgstr "" "これは、2つまたは4つの元のページを組み合わせた新しい |PDF| " "を作成することを意味します（または「2-up」、「4-up」などとも呼ばれます）。これは、ブックレットやサムネイルのような概要を作成するために使用できます。" #: ../../the-basics.rst:833 8a7f8d78c24e4f378fee6b2230783c26 msgid "|PDF| Encryption & Decryption" msgstr "|PDF| の暗号化と復号化" #: ../../the-basics.rst:836 71dc729191e040fd8118fee77ba6a2a8 msgid "" "Starting with version 1.16.0, |PDF| decryption and encryption (using " "passwords) are fully supported. You can do the following:" msgstr "バージョン1.16.0から、PDFの暗号化と復号化（パスワードを使用）が完全にサポートされています。以下のことができます：" #: ../../the-basics.rst:838 dd359c928f974ab5947e47392afdc2a9 msgid "" "Check whether a document is password protected / (still) encrypted " "(:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`)." msgstr "" "ドキュメントがパスワード保護されているか、（まだ）暗号化されているかを確認する（:attr:`Document.needs_pass`, " ":attr:`Document.is_encrypted`）。" #: ../../the-basics.rst:839 f16ee2a615fe4984bb226ff54db0fe8f msgid "Gain access authorization to a document (:meth:`Document.authenticate`)." msgstr "ドキュメントへのアクセス権を取得する（:meth:`Document.authenticate`）。" #: ../../the-basics.rst:840 6a05b415f16d40768f4e1564236d6231 msgid "" "Set encryption details for PDF files using :meth:`Document.save` or " ":meth:`Document.write` and" msgstr ":meth:`Document.save` または :meth:`Document.write` を使用して、PDFファイルの暗号化詳細を設定する。" #: ../../the-basics.rst:842 a28670df924945ff88d6be01321e1a30 msgid "decrypt or encrypt the content" msgstr "内容の復号化または暗号化" #: ../../the-basics.rst:843 d73094fe4cc9466a9bf3378d56401b78 msgid "set password(s)" msgstr "パスワードの設定" #: ../../the-basics.rst:844 5aed08cd9fcc43ab8d5b06fb650a0ca6 msgid "set the encryption method" msgstr "暗号化方式の設定" #: ../../the-basics.rst:845 76a02a01b3e04059b3deb41a2a8ffb73 msgid "set permission details" msgstr "権限の詳細設定" #: ../../the-basics.rst:847 7fca3b11f52b4b0ca3876005bd500c57 msgid "A PDF document may have two different passwords:" msgstr "PDF文書には2つの異なるパスワードが存在する場合があります：" #: ../../the-basics.rst:849 73c3a5f74efb4167905a89f8f1383c0a msgid "" "The **owner password** provides full access rights, including changing " "passwords, encryption method, or permission detail." msgstr "オーナーパスワード：パスワードを変更したり、暗号化方法を変更したり、権限の詳細を含む完全なアクセス権を提供します。" #: ../../the-basics.rst:850 e2fb43f6fcdb49739207db257e3f97bb msgid "" "The **user password** provides access to document content according to " "the established permission details. If present, opening the |PDF| in a " "viewer will require providing it." msgstr "ユーザーパスワード：文書の内容にアクセスするための権限詳細に基づいてアクセスを提供します。存在する場合、ビューアでPDFを開く際にユーザーパスワードを入力する必要があります。" #: ../../the-basics.rst:852 c66bf0cbf4934d79a253d8f6b43d51f4 msgid "" "Method :meth:`Document.authenticate` will automatically establish access " "rights according to the password used." msgstr "メソッド :meth:`Document.authenticate` は、使用されるパスワードに基づいて自動的にアクセス権を確立します。" #: ../../the-basics.rst:854 8d09fb5167d443ef9ee672510c3def18 msgid "" "The following snippet creates a new |PDF| and encrypts it with separate " "user and owner passwords. Permissions are granted to print, copy and " "annotate, but no changes are allowed to someone authenticating with the " "user password." msgstr "" "以下のスニペットは新しい |PDF| " "を作成し、別々のユーザーパスワードとオーナーパスワードで暗号化します。印刷、コピー、注釈付けの権限が与えられますが、ユーザーパスワードで認証するユーザーに対しては変更は許可されません" #: ../../the-basics.rst:888 10c5018907dd4496be681ebd8e664fd6 msgid "" "Opening this document with some viewer (Nitro Reader 5) reflects these " "settings:" msgstr "このドキュメントをいくつかのビューア（Nitro Reader 5など）で開くと、これらの設定が反映されます：" #: ../../the-basics.rst:892 03d88819ea404f0aaf81ffe5d60d7425 msgid "" "**Decrypting** will automatically happen on save as before when no " "encryption parameters are provided." msgstr "暗号化パラメータが提供されていない場合、保存時に自動的に復号化されます。" #: ../../the-basics.rst:894 f367fcac22c6414ab97981825f130856 msgid "" "To **keep the encryption method** of a PDF save it using " "`encryption=pymupdf.PDF_ENCRYPT_KEEP`. If `doc.can_save_incrementally() " "== True`, an incremental save is also possible." msgstr "" "PDFの暗号化方法を保持するには、`encryption=pymupdf.PDF_ENCRYPT_KEEP` を使用して保存します。また、 " "`doc.can_save_incrementally() == True` であれば、増分保存も可能です" #: ../../the-basics.rst:896 beec27387fd7422bb3e063049ff22429 msgid "" "To **change the encryption method** specify the full range of options " "above (`encryption`, `owner_pw`, `user_pw`, `permissions`). An " "incremental save is **not possible** in this case." msgstr "暗号化方法を変更する場合は、上記のすべてのオプション（`encryption`、`owner_pw`、`user_pw`、`permissions`）を指定します。この場合、増分保存はできません。" #: ../../the-basics.rst:900 20699b9f6451443d8b941958c154d7a7 msgid ":meth:`Document.save`" msgstr "" #: ../../the-basics.rst:909 d798da65fa514bd0aebc4068c084a7ca msgid "Extracting Tables from a :title:`Page`" msgstr "ページからのテーブルの抽出" #: ../../the-basics.rst:911 e4ef14dd9323461295fcdab920a24b7e msgid "Tables can be found and extracted from any document :ref:`Page`." msgstr "表はどのドキュメントの :ref:`Page` からも見つけて抽出できます。" #: ../../the-basics.rst:930 fc83ee37b6f443bc9104c718aa70c0ec #, fuzzy msgid ":meth:`Page.find_tables`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:935 ae116fead03d40f4ae9e9e1fa4dd5657 msgid "" "There is also the `pdf2docx extract tables method`_ which is capable of " "table extraction if you prefer." msgstr "お好みの場合、テーブル抽出が `可能なpdf2docxのextract tablesメソッド`_ もあります。" #: ../../the-basics.rst:944 09cbe8ebd73f4fdbae255f4eb4ac88d9 msgid "Getting Page Links" msgstr "ページリンクの取得" #: ../../the-basics.rst:946 8f8e76066ac34e6288f125de53c52324 msgid "Links can be extracted from a :ref:`Page` to return :ref:`Link` objects." msgstr ":ref:`Page` からリンクを抽出して :ref:`Link` オブジェクトを返すことができます。" #: ../../the-basics.rst:966 4b1b5f7afbde4704808ac3807d07675a #, fuzzy msgid ":meth:`Page.first_link`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:975 b3aade8e69434effb9c03ef1b44c1f10 msgid "Getting All Annotations from a Document" msgstr "ドキュメントからすべての注釈を取得する" #: ../../the-basics.rst:977 6801cadfb5354b0ab04f7979d5a356ba msgid "" "Annotations (:ref:`Annot`) on pages can be retrieved with the " "`page.annots()` method." msgstr "ページ上の注釈 (:ref:`Annot`) は、`page.annots()` メソッドを使用して取得できます。" #: ../../the-basics.rst:992 bf4d519f3c994f33b280f0de93018463 #, fuzzy msgid ":meth:`Page.annots`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:1002 c5273dfabc3043a8b9607b2a9d28ce43 msgid "Redacting content from a |PDF|" msgstr "|PDF| からコンテンツを塗りつぶす" #: ../../the-basics.rst:1004 e030189f77db4e8983c5a6528654fd34 msgid "" "Redactions are special types of annotations which can be marked onto a " "document page to denote an area on the page which should be securely " "removed. After marking an area with a rectangle then this area will be " "marked for *redaction*, once the redaction is *applied* then the content " "is securely removed." msgstr "マーキングされた領域に矩形を使用して、ページ上の削除されるべき領域を示すために、赤字が付けられる特別なアノテーションです。領域に矩形をマークした後、その領域は赤字としてマークされ、赤字が適用されると、そのコンテンツは安全に削除されます。" #: ../../the-basics.rst:1006 576dffbcb6454f419fb44e03a6766f97 msgid "" "For example if we wanted to redact all instances of the name \"Jane Doe\"" " from a document we could do the following:" msgstr "たとえば、ドキュメントから名前「ジェーン・ドー」のすべてのインスタンスを塗りつぶしたい場合は、次のようにします：" #: ../../the-basics.rst:1034 512a331e2f6a4420af87d029a290261c msgid "" "Another example could be redacting an area of a page, but not to redact " "any line art (i.e. vector graphics) within the defined area, by setting a" " parameter flag as follows:" msgstr "別の例として、ページの領域を塗りつぶすが、定義された領域内の線画（ベクトルグラフィックス）を塗りつぶさないように、パラメータフラグを設定することができます。" #: ../../the-basics.rst:1065 eed2e214f7454d77b9f11502e75e71b6 msgid "" "Once a redacted version of a document is saved then the redacted content " "in the |PDF| is *irretrievable*. Thus, a redacted area in a document " "removes text and graphics completely from that area." msgstr "" "文書の塗りつぶし済みバージョンを保存すると、|PDF| 内の塗りつぶされたコンテンツは *取り戻すことができなくなります* " "。したがって、文書内の塗りつぶされた領域は、その領域からテキストとグラフィックスを完全に削除します。" #: ../../the-basics.rst:1072 24199c7a643e40f981bc9a2d6b9a76f5 msgid "" "The are a few options for creating and applying redactions to a page, for" " the full API details to understand the parameters to control these " "options refer to the API reference." msgstr "ページに赤字を作成して適用するためのいくつかのオプションがあります。これらのオプションを制御するためのパラメータを理解するためには、完全なAPI詳細についてAPIリファレンスを参照してください。" #: ../../the-basics.rst:1076 5620f79d90484e0c84d9f1e6cf483ef2 #, fuzzy msgid ":meth:`Page.add_redact_annot`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:1078 2238e86dba64405e99bc6de9a1e29266 #, fuzzy msgid ":meth:`Page.apply_redactions`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:1088 64e88b96ce2b4df99e9d8c97cae10c8f msgid "Converting PDF Documents" msgstr "PDF ドキュメントの変換" #: ../../the-basics.rst:1090 c9b689d1ca1242deaf0ecf74d670aa7b msgid "" "We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-" "docx** library to provide simple document conversion from |PDF| to " "**DOCX** format." msgstr "" "PyMuPDF を使用する pdf2docx_ ライブラリと、|PDF| から **DOCX** 形式への簡単なドキュメント変換を提供する " "**python-docx** ライブラリをお勧めします。" #: ../../footer.rst:60 3aa3d5fcda7349e5a5c5339a71002610 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "Supported File Types" #~ msgstr "サポートされているファイルタイプ" #~ msgid "|PyMuPDF| supports the following file types:" #~ msgstr "|PyMuPDF| は以下のファイルタイプをサポートしています：" #~ msgid "" #~ "Opening with :index:`a Wrong File " #~ "Extension `" #~ msgstr "間違ったファイル拡張子でファイルを開く" #~ msgid "" #~ "If you have a document with a " #~ "wrong file extension for its type, " #~ "you can still correctly open it." #~ msgstr "もしドキュメントのファイル拡張子がその種類に対して間違っていても、正しく開くことができます。" #~ msgid "Assume that *\"some.file\"* is actually an XPS. Open it like so:" #~ msgstr "*\"some.file\"* が実際にXPSファイルだと仮定して、以下のようにして開いてください：" #~ msgid "" #~ "There are many file types beyond " #~ "|PDF| which can be opened by " #~ "|PyMuPDF|, for more details see the " #~ "list of :ref:`supported file " #~ "types`." #~ msgstr "" #~ "「PyMuPDF」で開くことができるのは、|PDF| " #~ "に限らず、多くのファイルタイプがあります。詳細については、:ref:`サポートされているファイルタイプのリスト`" #~ " をご覧ください。" #~ msgid "" #~ "|PyMuPDF| itself does not try to " #~ "determine the file type from the " #~ "file contents. **You** are responsible " #~ "for supplying the filetype info in " #~ "some way -- either implicitly via " #~ "the file extension, or explicitly as " #~ "shown. There are pure :title:`Python` " #~ "packages like `filetype " #~ "`_ that help you" #~ " doing this. Also consult the " #~ ":ref:`Document` chapter for a full " #~ "description." #~ msgstr "" #~ "PyMuPDF自体は、ファイルの内容からファイルタイプを判断しようとはしません。ファイルの拡張子などを通じて暗黙的に、または明示的にファイルタイプ情報を提供する責任があります。`filetype" #~ " `_ " #~ "などの純粋なPythonパッケージがこのような操作をサポートしています。また、詳細な説明についてはドキュメントの章を参照してください。" #~ msgid "" #~ "If |PyMuPDF| encounters a file with " #~ "an unknown / missing extension, it " #~ "will try to open it as a " #~ "|PDF|. So in these cases there is" #~ " no need for additional precautions. " #~ "Similarly, for memory documents, you can" #~ " just specify `doc=pymupdf.open(stream=mem_area)` " #~ "to open it as a |PDF| document." #~ msgstr "" #~ "|PyMuPDF| " #~ "が不明な/欠落している拡張子のファイルに遭遇した場合、それをPDFとして開こうと試みます。したがって、これらの場合は追加の注意が必要ありません。同様に、メモリ上のドキュメントの場合は、`doc=pymupdf.open(stream=mem_area)`" #~ " と指定するだけでPDFドキュメントとして開くことができます" #~ msgid "" #~ "If you attempt to open an " #~ "unsupported file then |PyMuPDF| will " #~ "throw a file data error." #~ msgstr "サポートされていないファイルを開こうとした場合、PyMuPDFはファイルデータエラーをスローします。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/tools.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 fa4cb1c40839408c9c8cd07e9e01bb93 msgid "Artifex" msgstr "" #: ../../header.rst:-1 0eadbcdf62a345f492e6c5df071271b8 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 ac94c9f7137942e6a95a87c8a8567dd6 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../tools.rst:6 630133a66584427d8841e6ac73cd74b2 msgid "Tools" msgstr "Tools (ツール)" #: ../../tools.rst:8 9874cd63550144bdb2077af42f68c67f msgid "" "This class is a collection of utility methods and attributes, mainly " "around memory management. To simplify and speed up its use, it is " "automatically instantiated under the name *TOOLS* when PyMuPDF is " "imported." msgstr "" "このクラスは、メモリ管理を中心としたユーティリティメソッドと属性のコレクションです。使用を簡素化し、高速化するために、PyMuPDFがインポートされると、自動的に" " *TOOLS* という名前でインスタンス化されます。" #: ../../tools.rst:11 99d510145a8d481b814d6864371fd664 msgid "**Method / Attribute**" msgstr "**メソッド/属性**" #: ../../tools.rst:11 5a58a92212e44a278c9d89c56b3e1210 msgid "**Description**" msgstr "**説明**" #: ../../tools.rst:13 2b964d526bc34dbca89696e9a7f8a649 msgid ":meth:`Tools.gen_id`" msgstr "" #: ../../tools.rst:13 2e23b218a694403f803ca3d4641d1e46 msgid "generate a unique identifier" msgstr "一意の識別子を生成します。" #: ../../tools.rst:14 24f42327e36744579573d798b230bef0 msgid ":meth:`Tools.store_shrink`" msgstr "" #: ../../tools.rst:14 b4c3bfa744874fc3a556cbd6b8e9b6b8 msgid "shrink the storables cache [#f1]_" msgstr "格納可能キャッシュを縮小します [#f1]_。" #: ../../tools.rst:15 bad8f3d46e5b4afdb102c4e7bf50d072 msgid ":meth:`Tools.mupdf_warnings`" msgstr "" #: ../../tools.rst:15 a2b9a9e372e04cecb473e320064f1301 msgid "return the accumulated MuPDF warnings" msgstr "蓄積されたMuPDFの警告を返します。" #: ../../tools.rst:16 965bf5733d4a437c9bf6499bb67ce938 msgid ":meth:`Tools.mupdf_display_errors`" msgstr "" #: ../../tools.rst:16 95fb9fea93424795be84f9bccfc5a2c6 msgid "control whether MuPDF errors are displayed as messages." msgstr "" #: ../../tools.rst:17 aae25f7b27504eacb2dcb5df61f4be65 msgid ":meth:`Tools.mupdf_display_warnings`" msgstr "" #: ../../tools.rst:17 0ec8dcf6c973477abe4aa02ed3c8b605 msgid "control whether MuPDF warnings are displayed as messages." msgstr "" #: ../../tools.rst:18 53a94e9b9d1044b394e412402f3dcf71 msgid ":meth:`Tools.reset_mupdf_warnings`" msgstr "" #: ../../tools.rst:18 39ad9b132aad445c8698e388b85423ed #, fuzzy msgid "empty MuPDF warnings/errors message buffer." msgstr "MuPDFの警告メッセージバッファを空にします。" #: ../../tools.rst:19 6719fb8425af4227a2a2717806cd2872 msgid ":meth:`Tools.set_aa_level`" msgstr "" #: ../../tools.rst:19 084c6bfe822c4d048572d1bb4db01b5d msgid "set the anti-aliasing values" msgstr "アンチエイリアシングの値を設定します。" #: ../../tools.rst:20 30023363ff6e4e8aa20333cd744dab27 msgid ":meth:`Tools.set_annot_stem`" msgstr "" #: ../../tools.rst:20 104ce28d382346ac85d8db2cfcb5da80 msgid "set the prefix of new annotation / link ids" msgstr "新しい注釈/リンクIDのプレフィックスを設定します。" #: ../../tools.rst:21 de68f470119b4a60b48b7054e2f46a0c msgid ":meth:`Tools.set_small_glyph_heights`" msgstr "" #: ../../tools.rst:21 f69f8f062c094ffcac57dd21b3725054 msgid "search and extract using small bbox heights" msgstr "小さなbbox高さを使用して検索および抽出します。" #: ../../tools.rst:22 a5f65f4e49c744f2b64fd47f8f963187 msgid ":meth:`Tools.set_subset_fontnames`" msgstr "" #: ../../tools.rst:22 d7a4ef524baa414c934afd124e2039c8 msgid "control suppression of subset fontname tags" msgstr "サブセットフォント名タグの抑制を制御します。" #: ../../tools.rst:23 f7f424f91b824b6fbc8d16f177210157 msgid ":meth:`Tools.show_aa_level`" msgstr "" #: ../../tools.rst:23 de220ac6db8f43b590219bfc76ada785 msgid "return the anti-aliasing values" msgstr "アンチエイリアシングの値を返します。" #: ../../tools.rst:24 9822bd4c433c4e73a4a62e8e2fd8d55d msgid ":meth:`Tools.unset_quad_corrections`" msgstr "" #: ../../tools.rst:24 1ebfd2086c444331b2bf1d386b71dc90 msgid "disable PyMuPDF-specific code" msgstr "PyMuPDF固有のコードを無効にします。" #: ../../tools.rst:25 b93af0b1adae41ab8ef6adfe0264b3d7 msgid ":attr:`Tools.fitz_config`" msgstr "" #: ../../tools.rst:25 4aabf943204d404e9bcd0659b004b61a msgid "configuration settings of PyMuPDF" msgstr "PyMuPDFの設定設定" #: ../../tools.rst:26 bda50dea0b1b426db8d540c41f8e225d msgid ":attr:`Tools.store_maxsize`" msgstr "" #: ../../tools.rst:26 d98d3a57e7f648caac4f8c85c2aa73dc msgid "maximum storables cache size" msgstr "最大格納可能キャッシュサイズ" #: ../../tools.rst:27 832df81af8a44bf994b2927588b125b4 msgid ":attr:`Tools.store_size`" msgstr "" #: ../../tools.rst:27 1e9ca667256f4ce88906ba326e637a59 msgid "current storables cache size" msgstr "現在の格納可能キャッシュサイズ" #: ../../tools.rst:30 876332768bb84673a877ceb4dece1450 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../tools.rst:36 65fde22db17c4647b856922e599073a4 msgid "" "A convenience method returning a unique positive integer which will " "increase by 1 on every invocation. Example usages include creating unique" " keys in databases - its creation should be faster than using timestamps " "by an order of magnitude." msgstr "1回の呼び出しごとに1ずつ増加する一意の正の整数を返す便利なメソッドです。使用例には、データベース内で一意のキーを作成することが含まれます。タイムスタンプを使用するよりも作成が10倍高速であるべきです。" #: ../../tools.rst:38 ab15f82a042e4ed3b078c757f4e63b86 msgid "" "MuPDF has dropped support for this in v1.14.0, so we have re-implemented " "a similar function with the following differences:" msgstr "MuPDFはv1.14.0でこれをサポートを中止したため、次の違いを持つ類似の関数を再実装しました。" #: ../../tools.rst:40 84cae01ccf524246ac7b4d9427698005 msgid "" "It is not part of MuPDF's global context and not threadsafe (not an issue" " because we do not support threads in PyMuPDF anyway)." msgstr "これはMuPDFのグローバルコンテキストの一部ではなく、スレッドセーフではありません（とにかくPyMuPDFではスレッドをサポートしていないため、これは問題ではありません）。" #: ../../tools.rst:41 f05a3f0eec6c47eaab32b3d7dbadfa32 msgid "" "It is implemented as *int*. This means that the maximum number is " "*sys.maxsize*. Should this number ever be exceeded, the counter starts " "over again at 1." msgstr "" "これはintとして実装されています。つまり、最大値は *sys.maxsize* " "です。この数値がいつか超過される場合、カウンターは1から再開します。" #: ../../tools.rst 17bbc4e0e9b1480aab24e4c8d6b901fd #: 2c7d5afc0c614f2e947541283319a8aa 3f0e5e23a1b3401fab7534a9ffddfb6f #: 4bceb68ff0cf4c4db44a34b626d14422 4bfaf26ceea2422398c767ec7da4f944 #: 656f7c4b2db04ef1928e253ee58fbda8 783c6110b0e84fa69ec1e999f0763115 #: 886de849a3b644a3b7483f4f34d47ab1 9956690247394b5abfa7987d9cb2942f #: ae9fe9f8edaa4afa9830772bb949887b msgid "Return type" msgstr "戻り値:" #: ../../tools.rst 05be31d115d84df1af6eec3998b6c813 #: 1b38a72665554ad2b7b31cd24642d09f 322b991feded4473a556bdb214b03b1d #: 47b093107003487e9ca47b7610cc6159 63fec7ceb4ea496eba269d589582ac36 #: a18d16ae4a364a9d863acd8c74a5fa94 b4f07341f4ad48e897984538401987b3 #: c6c09e9c896c4a13b41f9be7c7bd6ff6 db36bae168a54d46838b57f99adb8f1d msgid "Returns" msgstr "返り値:" #: ../../tools.rst:44 d04c5dc089994e268783aceaffad24d8 msgid "a unique positive integer." msgstr "一意の正の整数。" #: ../../tools.rst:49 5ebeca1825d746f39692eebb86cb9f42 msgid "New in v1.18.6" msgstr "v1.18.6で新登場" #: ../../tools.rst:51 8b6fd71202b24c318c21b52e9aabae8c msgid "Set or inquire the prefix for the id of new annotations, fields or links." msgstr "新しい注釈、フィールド、またはリンクのIDのプレフィックスを設定または問い合わせます。" #: ../../tools.rst 1ecb667b90fb4a4baa562619c4cf215f #: 658ec43b52b04330bf7a40f38e909bbc 95eef4039ef94ba79c670022599c654c #: b3ae48d8f1a449ddbe4b6a9ae98cf4d9 c299a5cad9db4f4c84dde48c1ef4fc58 #: c4311092aae34e4691fb6e3995c50792 c79cc99a8ac340c2a6a9adc2b3fe239a #: ca6497050d944cf788e55eb72bc9f7d1 f54117de12074455b85ab6c94ff7dd5b msgid "Parameters" msgstr "パラメータ" #: ../../tools.rst:53 3501d21aa8734541bc1aa99a8ed5190c msgid "" "if omitted, the current value is returned, default is \"fitz\". " "Annotations, fields / widgets and links technically are subtypes of the " "same type of object (`/Annot`) in PDF documents. An `/Annot` object may " "be given a unique identifier within a page. For each of the applicable " "subtypes, PyMuPDF generates identifiers \"stem-Annn\", \"stem-Wnnn\" or " "\"stem-Lnnn\" respectively. The number \"nnn\" is used to enforce the " "required uniqueness." msgstr "" "省略された場合、現在の値が返され、デフォルトは \"fitz\" " "です。注釈、フィールド/ウィジェット、およびリンクは技術的にはPDF文書内の同じ種類のオブジェクト（`/Annot`）のサブタイプです。`/Annot`" " オブジェクトは、ページ内で一意の識別子を持つことができます。適用可能なサブタイプごとに、PyMuPDFはそれぞれ \"stem-Annn" "\"、\"stem-Wnnn\"、または \"stem-Lnnn\" の識別子を生成します。番号 \"nnn\" " "は必要な一意性を強制するために使用されます。" #: ../../tools.rst:56 b611d59a32fa4723ae6eea8e46c1e4fc msgid "the current value." msgstr "現在の値。" #: ../../tools.rst:61 ed4a7b571b5840db82e999c073d641bb msgid "New in v1.18.5" msgstr "v1.18.5で新登場" #: ../../tools.rst:63 d110db042c104cd9a70ee2ba0ea17274 msgid "" "Set or inquire reduced bbox heights in text extract and text search " "methods." msgstr "テキスト抽出およびテキスト検索メソッドでのbboxの高さを縮小するかどうかを設定または問い合わせます。" #: ../../tools.rst:65 9dacdc2684a04823aaf2faa1c6a84582 msgid "" "if omitted or `None`, the current setting is returned. For other values " "the *bool()* function is applied to set a global variable. If `True`, " ":meth:`Page.search_for` and :meth:`Page.get_text` methods return " "character, span, line or block bboxes that have a height of *font size*. " "If `False` (standard setting when PyMuPDF is imported), bbox height will " "be based on font properties and normally equal *line height*." msgstr "" "省略された場合または `None` の場合、現在の設定が返されます。他の値の場合、*bool()* " "関数が適用され、グローバル変数を設定します。`True` の場合、:meth:`Page.search_for` および " ":meth:`Page.get_text` メソッドは *フォントサイズ* " "の高さを持つ文字、スパン、行、またはブロックのbboxを返します。`False` " "の場合（PyMuPDFがインポートされたときの標準設定）、bboxの高さはフォントのプロパティに基づき、通常は *行の高さ* と同じです。" #: ../../tools.rst:68 ../../tools.rst:81 ../../tools.rst:95 #: 3d9f991f869c4e3687694b4b5d83e20f 8fa94c128ef84d4db600a970cc431f03 #: fb141d29fa904b54ac786f25cee529a0 msgid "``True`` or ``False``." msgstr "``True`` または ``False``。" #: ../../tools.rst:70 6ff2af93fffb41d1952b1726635074e7 msgid "" "Text extraction options \"xml\", \"xhtml\" and \"html\", which directly " "wrap MuPDF code, are not influenced by this." msgstr "直接MuPDFコードをラップするテキスト抽出オプション「xml」、「xhtml」、「html」は、これに影響を受けません。" #: ../../tools.rst:74 3e2f146855c24da3bc5620a6dbf0fe16 msgid "New in v1.18.9" msgstr "バージョン1.18.9で追加されました" #: ../../tools.rst:76 a47cf06efd8f42ed94738ff03d3423d2 msgid "Control suppression of subset fontname tags in text extractions." msgstr "テキスト抽出におけるサブセットフォント名のタグを抑制する制御を行います。" #: ../../tools.rst:78 c87edd954d4c42e6b4fdd9829d79cd37 msgid "" "if omitted / `None`, the current setting is returned. Arguments " "evaluating to `True` or `False` set a global variable. If `True`, options" " \"dict\", \"json\", \"rawdict\" and \"rawjson\" will return e.g. " "`\"NOHSJV+Calibri-Light\"`, otherwise only `\"Calibri-Light\"` (the " "default). The setting remains in effect until changed again." msgstr "" "省略された場合 `None`、現在の設定が返されます。`True` または `False` " "の値を評価して、グローバル変数を設定します。`True` の場合、オプション " "\"dict\"、\"json\"、\"rawdict\"、\"rawjson\" は例えば `\"NOHSJV+Calibri-Light\"`" " のように返され、それ以外の場合はデフォルトの `\"Calibri-Light\"` のみが返されます。設定は再度変更されるまで有効です。" #: ../../tools.rst:83 82a85fb54bd7436c925ba3b349ae06ef msgid "" "Except mentioned above, no other text extraction variants are influenced " "by this. This is especially true for the options \"xml\", \"xhtml\" and " "\"html\", which are based on MuPDF code. They extract the font name " "`\"Calibri-Light\"`, or even just the **family** name -- `Calibri` in " "this example." msgstr "" "上記に記載されている以外のテキスト抽出バリアントには影響しません。特に、MuPDFコードに基づくオプション " "\"xml\"、\"xhtml\"、\"html\" には影響しません。これらはフォント名 `\"Calibri-" "Light\"`、またはこの例の場合はファミリー名 `Calibri` のみを抽出します。" #: ../../tools.rst:88 149b8e463c8f481c96e3b70333a749dc msgid "New in v1.18.10" msgstr "バージョン1.18.10で追加されました" #: ../../tools.rst:90 159ffb24af174c1f8c260dc38669bafc msgid "" "Enable / disable PyMuPDF-specific code, that tries to rebuild valid " "character quads when encountering nonsense in :meth:`Page.get_text` text " "extractions. This code depends on certain font properties (ascender and " "descender), which do not exist in rare situations and cause segmentation " "faults when trying to access them. This method sets a global parameter in" " PyMuPDF, which suppresses execution of this code." msgstr "" ":meth:`Page.get_text` " "テキスト抽出で無意味なものを検出した際に、有効な文字の四角形を再構築しようとするPyMuPDF固有のコードの有効化/無効化を行います。このコードは、存在しない場合があるフォントの特性（ascenderおよびdescender）に依存しており、これらの特性にアクセスしようとするとセグメンテーション違反が発生します。このメソッドはPyMuPDF内のグローバルパラメータを設定し、このコードの実行を抑制します。" #: ../../tools.rst:92 e6745e3e0ce7442b9f04193751691b0a msgid "" "if omitted or `None`, the current setting is returned. For other values " "the *bool()* function is applied to set a global variable. If `True`, " "PyMuPDF will not try to access the resp. font properties and use values " "`ascender=0.8` and `descender=-0.2` instead." msgstr "" "省略された場合、または `None` 、現在の設定が返されます。他の値の場合、*bool()* " "関数が適用され、グローバル変数を設定します。`True` の場合、PyMuPDFは該当するフォントの特性にアクセスしようとせず、代わりに " "`ascender=0.8` および `descender=-0.2` の値を使用します。" #: ../../tools.rst:100 4c85e3216c354121a73b16cd1b293077 msgid "Reduce the storables cache by a percentage of its current size." msgstr "現在のサイズを基準に、ストレージキャッシュのサイズを指定した割合で減少させます。" #: ../../tools.rst:102 7618f829b73f402e918ae962dfb6a9f0 msgid "" "the percentage of current size to free. If 100+ the store will be " "emptied, if zero, nothing will happen. MuPDF's caching strategy is " "\"least recently used\", so low-usage elements get deleted first." msgstr "現在のサイズの何パーセントを解放するかを指定します。100以上の場合、ストアは空になります。むしろ、何も変更されません。MuPDFのキャッシング戦略は「最後に使用されたもの」なので、使用頻度の低い要素が最初に削除されます。" #: ../../tools.rst:105 b452872341864da4b7fbb34a1df97034 msgid "" "the new current store size. Depending on the situation, the size " "reduction may be larger than the requested percentage." msgstr "新しい現在のストアサイズ。状況に応じて、要求された割合よりもサイズが大幅に削減される場合があります。" #: ../../tools.rst:109 ../../tools.rst:119 b2c6c42229034879a13c08954bd588f3 #: b6ae51cffc9c4a38a66643a43141bf46 msgid "New in version 1.16.14" msgstr "バージョン1.16.14で新たに追加" #: ../../tools.rst:111 e883965495954aed98f30f83e9079e4f msgid "" "Return the current anti-aliasing values. These values control the " "rendering quality of graphics and text elements." msgstr "現在のアンチエイリアシング値を返します。これらの値は、グラフィックスとテキスト要素のレンダリング品質を制御します。" #: ../../tools.rst:114 d4f138c5562e4a23a0da982a9c981f64 msgid "" "A dictionary with the following initial content: `{'graphics': 8, 'text':" " 8, 'graphics_min_line_width': 0.0}`." msgstr "" "以下の初期内容を持つ辞書： `{'graphics': 8, 'text': 8, 'graphics_min_line_width': " "0.0}`。" #: ../../tools.rst:121 debfdfadcaeb4efd8e0c271b9fdc0a06 msgid "" "Set the new number of bits to use for anti-aliasing. The same value is " "taken currently for graphics and text rendering. This might change in a " "future MuPDF release." msgstr "アンチエイリアシングに使用するビット数を設定します。現在はグラフィックスとテキストのレンダリングに同じ値が使用されます。将来のMuPDFリリースで変更されるかもしれません。" #: ../../tools.rst:123 3afd6a391b304cf9a27f036dd2a8eaea msgid "" "an integer ranging between 0 and 8. Value outside this range will be " "silently changed to valid values. The value will remain in effect " "throughout the current session or until changed again." msgstr "0から8までの範囲の整数。この範囲外の値は静かに有効な値に変更されます。この値は、現在のセッション全体または再度変更されるまで有効です。" #: ../../tools.rst:128 ../../tools.rst:167 6647accef2ce43b5b05bcd3953c5d30a #: e0edaaaf95744a8f9baf9b72c5df725a msgid "New in version 1.16.0" msgstr "バージョン1.16.0で新たに追加" #: ../../tools.rst:130 1c026c1906724ca1b13646c1e61293e9 msgid "Empty MuPDF warnings message buffer." msgstr "MuPDFの警告メッセージバッファを空にします。" #: ../../tools.rst:135 df4c55d8bc2a4f6ca7f828393cd543b2 #, fuzzy msgid "Control whether MuPDF errors should be displayed as |PyMuPDF| messages." msgstr "MuPDFのエラーを表示するかどうかを表示または設定します。" #: ../../tools.rst:138 ../../tools.rst:154 73102cae996e4e1ca4fda07841b0a537 #: c281bd2c631d4437a13966f361de0044 msgid "If `None`, the current setting is left unchanged." msgstr "" #: ../../tools.rst:139 4465af6643354c54be13db87f1577e1c msgid "" "Otherwise changes the current setting to `bool(value)`; if ``True``, " "future MuPDF errors will be shown as :ref:`Messages`." msgstr "" #: ../../tools.rst:141 014bd4cfe67c4bb3bcc80ada14574ac7 msgid "" "Regardless of this setting, MuPDF errors will always be stored in the " "warnings store." msgstr "" #: ../../tools.rst:142 ../../tools.rst:158 8670777bc54b406d9b8d60d6f5053a03 #: 8d3b08113ac444d1b78d9668a9fc41e5 msgid "Upon import of |PyMuPDF| this value is ``True``." msgstr "" #: ../../tools.rst:144 ../../tools.rst:160 83494dc367d6491db6461f478975266d #: a414e7de4bda4732bfea1df4dd2a1c93 msgid "The current setting as ``True`` or ``False``." msgstr "" #: ../../tools.rst:146 ../../tools.rst:162 80a5617a5563495a9a4817dcf619cea1 #: dddb4d52d6d14c31b7f962bd3d1b949d msgid "New in version 1.16.8" msgstr "バージョン1.16.8で新たに追加" #: ../../tools.rst:151 af5f9e3136c24a14964064e6626325cf msgid "Control whether MuPDF warnings should be displayed as |PyMuPDF| messages." msgstr "" #: ../../tools.rst:155 ac6aeba8d7af46f58aaa48643288ede1 msgid "" "Otherwise changes the current setting to `bool(value)`; if ``True``, " "future MuPDF warnings will be shown as :ref:`Messages`." msgstr "" #: ../../tools.rst:157 634e03217c9946ba97edc0b2a56d297f msgid "" "Regardless of this setting, MuPDF warnings will always be stored in the " "warnings store." msgstr "" #: ../../tools.rst:169 ef0995c7931b4d9c8a892c119669e82d msgid "" "Return all stored MuPDF messages as a string with interspersed line-" "breaks." msgstr "すべての保存されたMuPDFメッセージを、改行が挿入された文字列として返します。" #: ../../tools.rst:171 d3fae7bc59084382bd08ee62f17f5669 msgid "*(new in version 1.16.7)* whether to automatically empty the store." msgstr "*（バージョン1.16.7で新たに追加）* ストアを自動的に空にするかどうか。" #: ../../tools.rst:176 ed88482c9c404c6eb13f4e44e68a6402 msgid "" "A dictionary containing the actual values used for configuring PyMuPDF " "and MuPDF. Also refer to the installation chapter. This is an overview of" " the keys, each of which describes the status of a support aspect." msgstr "PyMuPDFとMuPDFを設定するために使用される実際の値を含む辞書です。インストールの章も参照してください。これは各キーを概説したもので、それぞれがサポートの側面のステータスを記述しています。" #: ../../tools.rst:179 983aafaaf72f47258fa885a81ffc31de msgid "**Key**" msgstr "**キー**" #: ../../tools.rst:179 2f18cc5c3f894e9e8c20b1cf745c4d35 msgid "**Support included for ...**" msgstr "**サポートが含まれているのは...**" #: ../../tools.rst:181 67e338ca234a4c2aa997416d0d1c5e17 msgid "plotter-g" msgstr "" #: ../../tools.rst:181 84bd5e00e5604b07b62a4f670c9ce45f msgid "Gray colorspace rendering" msgstr "グレーカラースペースのレンダリング" #: ../../tools.rst:182 76b2f02c816740679adf790799635016 msgid "plotter-rgb" msgstr "" #: ../../tools.rst:182 79231c9485fd412994543d8f4d42c1fa msgid "RGB colorspace rendering" msgstr "RGBカラースペースのレンダリング" #: ../../tools.rst:183 91d85a25304d4436bfeed78b823f708d msgid "plotter-cmyk" msgstr "" #: ../../tools.rst:183 924491f03aaf43d8a889798e8268c631 msgid "CMYK colorspcae rendering" msgstr "CMYKカラースペースのレンダリング" #: ../../tools.rst:184 b0fe29a8de9a4503a0c5bd27e7fc2b1e msgid "plotter-n" msgstr "" #: ../../tools.rst:184 e2367e803bd544e0a704fa3f6f4a377f msgid "overprint rendering" msgstr "オーバープリントのレンダリング" #: ../../tools.rst:185 40de005f09c64d48a68030bc62f04a7a msgid "pdf" msgstr "" #: ../../tools.rst:185 017318bcef5043d3a24dc1ac259bd96d msgid "PDF documents" msgstr "PDFドキュメント" #: ../../tools.rst:186 7879df7588cf4b4881667d16ef9b4044 msgid "xps" msgstr "" #: ../../tools.rst:186 554de734100a44889b05ea16bbbb4801 msgid "XPS documents" msgstr "XPSドキュメント" #: ../../tools.rst:187 e899c76673eb4de781ea52b20f05d668 msgid "svg" msgstr "" #: ../../tools.rst:187 2dfe37a142164ae3acbc5c646b670f4f msgid "SVG documents" msgstr "SVGドキュメント" #: ../../tools.rst:188 5f181d975a094cc29464ac24fe074950 msgid "cbz" msgstr "" #: ../../tools.rst:188 0bc4106af7494ee88794d1ae4bb7ff79 msgid "CBZ documents" msgstr "CBZドキュメント" #: ../../tools.rst:189 61552041ec884b1bbe274dbbda088bd1 msgid "img" msgstr "" #: ../../tools.rst:189 d12314e92993424f83174027a6ec725b msgid "IMG documents" msgstr "IMGドキュメント" #: ../../tools.rst:190 dd29953e1c66455a9923bf816e2a3282 msgid "html" msgstr "" #: ../../tools.rst:190 127d85fe33354ac7971afa414123d63a msgid "HTML documents" msgstr "HTMLドキュメント" #: ../../tools.rst:191 10cbf4f7a1cd41b9a80e083b7c002bed msgid "epub" msgstr "" #: ../../tools.rst:191 9ec403b9146f43eea9153809fffae100 msgid "EPUB documents" msgstr "EPUBドキュメント" #: ../../tools.rst:192 481a896d6b84460e8c1282ef91422469 msgid "jpx" msgstr "" #: ../../tools.rst:192 22765c91abce4d04836e6ff2519678ef msgid "JPEG2000 images" msgstr "JPEG2000画像" #: ../../tools.rst:193 d46c0035bc044897ada86595b3d04bda msgid "js" msgstr "" #: ../../tools.rst:193 dfe437b8979a42939b5938fb1f481ed3 msgid "JavaScript" msgstr "" #: ../../tools.rst:194 8ddda388461a473c9736d53993c96bcf msgid "tofu" msgstr "" #: ../../tools.rst:194 7c1d3ad770de460f824862a33e06e231 msgid "all TOFU fonts" msgstr "すべてのTOFUフォント" #: ../../tools.rst:195 ac7fb6b9c8e445aeb8f522c60057cf2b msgid "tofu-cjk" msgstr "" #: ../../tools.rst:195 6285e0aecced48a88277034654e7e42d msgid "CJK font subset (China, Japan, Korea)" msgstr "CJKフォントのサブセット（中国、日本、韓国）" #: ../../tools.rst:196 2a0c3f09e54c410a975730ce5aaa00de msgid "tofu-cjk-ext" msgstr "" #: ../../tools.rst:196 32e4ef23a02f4c36a24fd31d49a5607e msgid "CJK font extensions" msgstr "CJKフォント拡張" #: ../../tools.rst:197 8cf92f3f79df450ebefd0fbca0b7d825 msgid "tofu-cjk-lang" msgstr "" #: ../../tools.rst:197 b7426777724d4f16b655a5c11d77f9dd msgid "CJK font language extensions" msgstr "CJKフォントの言語拡張" #: ../../tools.rst:198 703a769d7b434dcaa4cfa08f972492b2 msgid "tofu-emoji" msgstr "" #: ../../tools.rst:198 846d00d7a0a249ea87e0c1029b8e395c msgid "TOFU emoji fonts" msgstr "TOFU絵文字フォント" #: ../../tools.rst:199 66b289107a8e4e8abd1bd9d88d481d42 msgid "tofu-historic" msgstr "" #: ../../tools.rst:199 6f259e97e9bd497d9e9a1e025bcf9982 msgid "TOFU historic fonts" msgstr "TOFU歴史的フォント" #: ../../tools.rst:200 14977ce1ee544b9abfc8db96b0cbb68c msgid "tofu-symbol" msgstr "" #: ../../tools.rst:200 dd5d0777ea504428b2029606f420e098 msgid "TOFU symbol fonts" msgstr "TOFUシンボルフォント" #: ../../tools.rst:201 629d3ba30efd4345bbc69f56a1d9810c msgid "tofu-sil" msgstr "" #: ../../tools.rst:201 bfbb2fb374b64c6082355e8e493b429f msgid "TOFU SIL fonts" msgstr "TOFU SILフォント" #: ../../tools.rst:202 4f7a65512f0844ef818c1d9624c5c335 msgid "icc" msgstr "" #: ../../tools.rst:202 7fc4ac21a5104fac97ffb3afa1c5980d msgid "ICC profiles" msgstr "ICCプロファイル" #: ../../tools.rst:203 c40e5ca7f3024ac2b2434d42fd91fc52 msgid "py-memory" msgstr "" #: ../../tools.rst:203 9b71c6d69b014bf2b7b0c8fe41ce6e22 msgid "using Python memory management [#f2]_" msgstr "Pythonメモリ管理を使用 [#f2]_" #: ../../tools.rst:204 ab89c03d6ab44abfb553acb0f1bf378b msgid "base14" msgstr "" #: ../../tools.rst:204 002400f1661d403bb8cd28b30acbd9b1 msgid "Base-14 fonts (should always be true)" msgstr "Base-14フォント（常にtrueである必要があります）" #: ../../tools.rst:207 a7392b4d969e4c53a89f24a17bedd641 #, fuzzy msgid "" "For an explanation of the term \"TOFU\" see `this Wikipedia article " "`_::" msgstr "" "「TOFU」の用語の説明については、 `このウィキペディアの記事 " "`_ を参照してください。::" #: ../../tools.rst:241 f0ca1b8827e0409b8d193598bd42bbb6 msgid "" "Maximum storables cache size in bytes. |PyMuPDF| is generated with a " "value of 268'435'456 (256 MB, the default value), which you should " "therefore always see here. If this value is zero, then an \"unlimited\" " "growth is permitted." msgstr "" "ストアブルキャッシュの最大サイズ（バイト単位）。 |PyMuPDF| は、デフォルト値である268'435'456（256 " "MB）で生成されており、したがって常にここで見るはずです。この値がゼロの場合、増加の「制限なし」が許可されています。" #: ../../tools.rst:247 c4a141a4e2f54f6c821d474393efda1b msgid "" "Current storables cache size in bytes. This value may change (and will " "usually increase) with every use of a |PyMuPDF| function. It will " "(automatically) decrease only when :attr:`Tools.store_maxsize` is going " "to be exceeded: in this case, |MuPDF| will evict low-usage objects until " "the value is again in range." msgstr "" "現在のストアブルキャッシュのサイズ（バイト単位）。この値は、 |PyMuPDF| " "の関数を使用するたびに変更される可能性があります（通常は増加します）。この値は、:attr:`Tools.store_maxsize` " "が超過される場合にのみ（自動的に）減少し、その場合、MuPDFは使用率の低いオブジェクトを削除して、値が再び範囲内に収まるようにします。" #: ../../tools.rst:252 081f0727dfcf40879ab8811e1fa325d3 msgid "Example Session" msgstr "セッションの例" #: ../../tools.rst:288 99b53db972bc49c58f0d4592323bf6c1 msgid "Footnotes" msgstr "脚注" #: ../../tools.rst:289 df2b4099a10547688c103f8b5777ecc7 msgid "" "This memory area is internally used by MuPDF, and it serves as a cache " "for objects that have already been read and interpreted, thus improving " "performance. The most bulky object types are images and also fonts. When " "an application starts up the MuPDF library (in our case this happens as " "part of *import pymupdf*), it must specify a maximum size for this area. " "PyMuPDF's uses the default value (256 MB) to limit memory consumption. " "Use the methods here to control or investigate store usage. For example: " "even after a document has been closed and all related objects have been " "deleted, the store usage may still not drop down to zero. So you might " "want to enforce that before opening another document." msgstr "" "このメモリ領域はMuPDF内部で使用され、既に読み取られ解釈されたオブジェクトのキャッシュとして機能し、パフォーマンスを向上させます。最も重いオブジェクトのタイプは画像およびフォントです。アプリケーションがMuPDFライブラリを起動するとき（私たちの場合、これは" " *import pymupdf* の一部として発生します）、この領域の最大サイズを指定する必要があります。 " "PyMuPDFはメモリ消費を制限するためにデフォルト値（256 " "MB）を使用します。ここで提供されているメソッドを使用してストアの使用状況を制御または調査できます。たとえば、文書が閉じられ、関連するすべてのオブジェクトが削除された後でも、ストアの使用状況がゼロにならないことがあります。したがって、別の文書を開く前にこれを強制したいかもしれません。" #: ../../tools.rst:291 cff1cb203bfb4dd0a6e7c5c76c91e337 msgid "" "By default PyMuPDF and MuPDF use `malloc()`/`free()` for dynamic memory " "management. One can instead force them to use the Python allocation " "functions `PyMem_New()`/`PyMem_Del()`, by modifying *fitz/fitz.i* to do " "`#define JM_MEMORY 1` and rebuilding PyMuPDF." msgstr "" "デフォルトでは、PyMuPDFおよびMuPDFは動的メモリ管理に `malloc()`/`free()` " "を使用します。代わりに、*fitz/fitz.i* を変更して `#define JM_MEMORY 1` " "を行い、PyMuPDFを再構築することで、Pythonの割り当て関数 `PyMem_New()`/`PyMem_Del()` " "を使用するように強制することができます。" #: ../../footer.rst:60 03615545ca9c49a09aa7623e8edafff5 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "::" #~ msgstr "" #~ msgid "empty MuPDF messages on STDOUT" #~ msgstr "STDOUTのMuPDFメッセージを空にします。" #~ msgid "" #~ "if not a bool, the current setting" #~ " is returned. If true, MuPDF errors" #~ " will be shown on *sys.stderr*, " #~ "otherwise suppressed. In any case, " #~ "messages continue to be stored in " #~ "the warnings store. Upon import of " #~ "PyMuPDF this value is ``True``." #~ msgstr "" #~ "boolでない場合、現在の設定が返されます。Trueの場合、MuPDFのエラーは *sys.stderr* " #~ "に表示され、それ以外の場合は抑制されます。いずれの場合も、メッセージは警告ストアに引き続き保存されます。PyMuPDFのインポート時にこの値は" #~ " ``True`` です。" #~ msgid "``True`` or ``False``" #~ msgstr "``True`` または ``False``" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/tutorial.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 af1c872c0c8149488a828ec57db0d05a msgid "Artifex" msgstr "" #: ../../header.rst:-1 5f296e40a5a84c7db71c20c23cf034c9 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 6ce8107c629e456a909666cce87fe6bd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../tutorial.rst:8 939af6d1c28b485eb4ff9f7d7027d32c msgid "Tutorial" msgstr "チュートリアル" #: ../../tutorial.rst:12 4f39e913a37d45aaaae25d581b6b21a5 msgid "" "This tutorial will show you the use of |PyMuPDF|, |MuPDF| in Python, step" " by step." msgstr "このチュートリアルでは、PythonでのPyMuPDF、MuPDFのステップバイステップの使用方法を紹介します。" #: ../../tutorial.rst:14 5a427c507e6b44479862e8eb2c0a69ba msgid "" "Because |MuPDF| supports not only PDF, but also XPS, OpenXPS, CBZ, CBR, " "FB2 and EPUB formats, so does |PyMuPDF| [#f1]_. Nevertheless, for the " "sake of brevity we will only talk about PDF files. At places where indeed" " only PDF files are supported, this will be mentioned explicitly." msgstr "MuPDFはPDFだけでなく、XPS、OpenXPS、CBZ、CBR、FB2、EPUB形式もサポートしており、PyMuPDFも同様です[1]。ただし、簡潔さのために、ここではPDFファイルについてのみ話を進めます。本当にPDFファイルのみがサポートされている場所では、明示的にその旨を記述します。" #: ../../tutorial.rst:16 b2c324e1eda6484681a5b98002f9f022 msgid "" "In addition to this introduction, please do visit PyMuPDF's `YouTube " "Channel `_ which covers most of the " "following in the form of YouTube \"Shorts\" and longer videos." msgstr "" "このイントロダクションに加えて、ぜひ `PyMuPDF の YouTube " "`_ チャンネル " "もご覧ください。以下の内容の多くが、YouTubeの「ショート動画」や長編動画の形式で紹介されています。" #: ../../tutorial.rst:19 c23da3317c5d43fdadba3fa7c99c3afc msgid "Importing the Bindings" msgstr "バインディングのインポート" #: ../../tutorial.rst:20 a04dcd4a09c3420f950b46d664276cd8 msgid "" "The Python bindings to MuPDF are made available by this import statement." " We also show here how your version can be checked::" msgstr "MuPDFへのPythonバインディングは、このインポート文によって利用可能になります。また、ここではあなたのバージョンを確認する方法も示します::" #: ../../tutorial.rst:30 56adbb5b22484758912815cc290316d8 msgid "Note on the Name *fitz*" msgstr "*fitz* という名前についての注意事項" #: ../../tutorial.rst:32 3b2a413d1d2040d38bbc841d83f98d16 msgid "" "Old versions of |PyMuPDF| had their **Python** import name as `fitz`. " "Newer versions use `pymupdf` instead, and offer `fitz` as a fallback so " "that old code will still work." msgstr "このライブラリのPythonのトップレベルインポート名は **\"fitz\"** です。 これには歴史的な理由があります：" #: ../../tutorial.rst:34 e7ad072736bc434da33243355f43a143 msgid "The reason for the name `fitz` is a historical curiosity:" msgstr "これには歴史的な理由があります：" #: ../../tutorial.rst:36 0a1388985e214bc8803f67a3cdc99664 msgid "The original rendering library for MuPDF was called *Libart*." msgstr "MuPDFの元々のレンダリングライブラリは *Libart* と呼ばれていました。" #: ../../tutorial.rst:38 6bb98d1d5fd843a9a823b5a023f389e8 msgid "" "*\"After Artifex Software acquired the MuPDF project, the development " "focus shifted on writing a new modern graphics library called \"Fitz\". " "Fitz was originally intended as an R&D project to replace the aging " "Ghostscript graphics library, but has instead become the rendering engine" " powering MuPDF.\"* (Quoted from `Wikipedia " "`_)." msgstr "" "「 Artifex SoftwareがMuPDFプロジェクトを取得した後、開発の焦点は新しいモダンなグラフィックスライブラリ " "\"Fitz\"の開発に移りました。 " "Fitzの開発に移りました。Fitzは元々古くなったGhostscriptグラフィックスライブラリを置き換えるためのR＆Dプロジェクトとして意図されていましたが、代わりにMuPDFを駆動するレンダリングエンジンになりました。」*" " ( `Wikipedia `_ より引用 ) 。" #: ../../tutorial.rst:42 f0b608072e0948f0a8d5019e86f78ae4 msgid "" "Use of legacy name `fitz` can fail if defunct pypi.org package `fitz` is " "installed; see :ref:`problems-after-installation`." msgstr "" #: ../../tutorial.rst:48 5b6f4f47d3d14b3dabbafb6419e1bfd3 msgid "Opening a Document" msgstr "ドキュメントの開く" #: ../../tutorial.rst:50 bad87b705ed349689aeb233740a2a4dd msgid "" "To access a :ref:`supported document`, it must be " "opened with the following statement::" msgstr ":ref:`サポートされているドキュメント ` にアクセスするには、次の文で開く必要があります::" #: ../../tutorial.rst:54 8ee29d11c6664eaba2d74e39fe256992 msgid "" "This creates the :ref:`Document` object *doc*. *filename* must be a " "Python string (or a `pathlib.Path`) specifying the name of an existing " "file." msgstr "" "これにより、 :ref:`Document` " "オブジェクトdocが作成されます。filenameは、既存のファイルの名前を指定するPythonの文字列（または `pathlib.Path` " "）である必要があります。" #: ../../tutorial.rst:56 fd7dc22114c4467ea703f11c5e4ddad9 msgid "" "It is also possible to open a document from memory data, or to create a " "new, empty PDF. See :ref:`Document` for details. You can also use " ":ref:`Document` as a *context manager*." msgstr "" "また、メモリデータからドキュメントを開くことや、新しい空のPDFを作成することも可能です。詳細については、 :ref:`Document` " "を参照してください。 :ref:`Document` はコンテキストマネージャとしても使用できます。" #: ../../tutorial.rst:58 e53b2ee3b09744bba7d0a597e3110a06 msgid "" "A document contains many attributes and functions. Among them are meta " "information (like \"author\" or \"subject\"), number of total pages, " "outline and encryption information." msgstr "ドキュメントには多くの属性と関数が含まれています。その中には、メタ情報（「author」や「subject」など）、総ページ数、アウトライン、暗号化情報などがあります。" #: ../../tutorial.rst:61 ed2d7a85b35c446faacb3600235eef21 msgid "Some :ref:`Document` Methods and Attributes" msgstr "いくつかの :ref:`Document` メソッドと属" #: ../../tutorial.rst:64 3b4470725538483087f6877a0b238a75 msgid "**Method / Attribute**" msgstr "**メソッド / 属性**" #: ../../tutorial.rst:64 348a919c08be4e7bacbcbdebf6aadceb msgid "**Description**" msgstr "説明" #: ../../tutorial.rst:66 3c58bb5e0cfd4357bf595f5730c490f5 msgid ":attr:`Document.page_count`" msgstr "" #: ../../tutorial.rst:66 71bcf48456184a0a864819c5c6c6b639 msgid "the number of pages (*int*)" msgstr "ページ数 (*int*)" #: ../../tutorial.rst:67 a9ca3bea8587466696f8c3a412c51474 msgid ":attr:`Document.metadata`" msgstr "" #: ../../tutorial.rst:67 5d63c2f5c2bf442da412566cddc8f0da msgid "the metadata (*dict*)" msgstr "メタデータ (*dict*)" #: ../../tutorial.rst:68 3a230f9d11cf49c8abaabfc21332281a msgid ":meth:`Document.get_toc`" msgstr "" #: ../../tutorial.rst:68 670c25d439184b3d864535494e4bc345 msgid "get the table of contents (*list*)" msgstr "目次を取得する (*list*)" #: ../../tutorial.rst:69 4dbf36bdcc774cfe94f6fe488e23ab70 msgid ":meth:`Document.load_page`" msgstr "" #: ../../tutorial.rst:69 6a5260a61382415882e9d006c179fe90 msgid "read a :ref:`Page`" msgstr ":ref:`Page` を読む" #: ../../tutorial.rst:73 d6bc5b209b1c4e7aa5b367e616992438 msgid "Accessing Meta Data" msgstr "メタデータへのアクセス" #: ../../tutorial.rst:74 5eeb7a67a3834701bda60567079af358 msgid "" "PyMuPDF fully supports standard metadata. :attr:`Document.metadata` is a " "Python dictionary with the following keys. It is available for **all " "document types**, though not all entries may always contain data. For " "details of their meanings and formats consult the respective manuals, " "e.g. :ref:`AdobeManual` for PDF. Further information can also be found in" " chapter :ref:`Document`. The meta data fields are strings or ``None`` if" " not otherwise indicated. Also be aware that not all of them always " "contain meaningful data -- even if they are not ``None``." msgstr "" "PyMuPDFは標準的なメタデータを完全にサポートしています。 :attr:`Document.metadata` " "はPythonの辞書で、次のキーが含まれています。これはすべてのドキュメントタイプで利用可能ですが、すべてのエントリが常にデータを含むわけではありません。それらの意味や形式の詳細については、対応するマニュアルを参照してください。例えば、PDFの場合は" " :ref:`AdobeManual` を参照してください。さらなる情報は :ref:`Document` " "の章でも見つけることができます。メタデータのフィールドは文字列または ``None`` " "です（特に指定がない場合）。また、それらのすべてが常に意味のあるデータを含んでいるわけではないことにも注意してください。" #: ../../tutorial.rst:77 6c9a21d704a241029ce9b7f001b7bac5 msgid "Key" msgstr "キー" #: ../../tutorial.rst:77 8400973337594bcf8e3da33817744ccf msgid "Value" msgstr "値" #: ../../tutorial.rst:79 6aa5ce470f8642c4af491e28af8bc999 msgid "producer" msgstr "" #: ../../tutorial.rst:79 52ee9d5cf1d94e4e824f1486804c0a49 msgid "producer (producing software)" msgstr "プロデューサー（生成ソフトウェア）" #: ../../tutorial.rst:80 85a0fa96090940f499052abc68aac361 msgid "format" msgstr "" #: ../../tutorial.rst:80 cd1a7dc5cfca479ca59b0e5e2b00f5bb msgid "format: 'PDF-1.4', 'EPUB', etc." msgstr "形式：'PDF-1.4'、'EPUB'など" #: ../../tutorial.rst:81 96773e4fde41492a8fbc9d8e0dfffe01 msgid "encryption" msgstr "" #: ../../tutorial.rst:81 4b242b9f88fb40e4847a8ad0358789ec msgid "encryption method used if any" msgstr "暗号化方法（適用されている場合）" #: ../../tutorial.rst:82 520e1f5cffc3419faccbecacb778ad88 #: adc5542c41534ce68fe9d02192b1f9e0 msgid "author" msgstr "" #: ../../tutorial.rst:83 d593bfa2f3f1464ca98020a5d8cc2d74 msgid "modDate" msgstr "" #: ../../tutorial.rst:83 49db626a877e41699ba02058512b97d9 msgid "date of last modification" msgstr "最終更新日" #: ../../tutorial.rst:84 ac0f4c311d9d4f91b366556afa0eac07 #: cad667882e9247ed9a8465e9e8f6f30e msgid "keywords" msgstr "" #: ../../tutorial.rst:85 4a12c1d082794891871985009346217e #: 9afee53342a24f749bd6b1695ceba4ca msgid "title" msgstr "" #: ../../tutorial.rst:86 0659f2376ae84f0694559432c6acc6ab msgid "creationDate" msgstr "" #: ../../tutorial.rst:86 c3e9c7f2af964de1a4ea55d6dfc87ae7 msgid "date of creation" msgstr "作成日" #: ../../tutorial.rst:87 f7336bfddb6c47da8c979a965fd0e200 msgid "creator" msgstr "" #: ../../tutorial.rst:87 cde7dc3a8d604edeb4df81869876cc12 msgid "creating application" msgstr "作成アプリケーション" #: ../../tutorial.rst:88 59f646e95f21440aab80a6d9eaee2cb5 #: dfcc9986b7404e3ea4869973f3300afb msgid "subject" msgstr "" #: ../../tutorial.rst:91 e212f47f482f4ba086c347c1ee602818 msgid "" "Apart from these standard metadata, **PDF documents** starting from PDF " "version 1.4 may also contain so-called *\"metadata streams\"* (see also " ":data:`stream`). Information in such streams is coded in XML. PyMuPDF " "deliberately contains no XML components for this purpose (the " ":ref:`PyMuPDF Xml class` is a helper class intended to access the " "DOM content of a :ref:`Story` object), so we do not directly support " "access to information contained therein. But you can extract the stream " "as a whole, inspect or modify it using a package like `lxml`_ and then " "store the result back into the PDF. If you want, you can also delete this" " data altogether." msgstr "" "PDFバージョン1.4以降のPDFドキュメントには、これらの標準的なメタデータに加えて、いわゆる「メタデータストリーム」（streamも参照）が含まれていることがあります。このようなストリームに含まれる情報はXMLでコード化されています。PyMuPDFは意図的にこの目的のためにXMLコンポーネントを含んでいないため（" " :ref:`PyMuPDF Xml class` クラスは :ref:`Story` " "オブジェクトのDOMコンテンツにアクセスするためのヘルパークラスです）、その情報への直接的なアクセスをサポートしていません。しかし、 " "`lxml`_ " "などのパッケージを使用してストリーム全体を抽出し、検査または変更し、その結果をPDFに再格納することはできます。必要な場合は、このデータを完全に削除することもできます。" #: ../../tutorial.rst:93 5ec202ac5c494be3bf62e68bf5ba28b1 msgid "" "There are two utility scripts in the repository that `metadata import " "(PDF only)`_ resp. `metadata export`_ metadata from resp. to CSV files." msgstr "" "リポジトリには、`metadata import(PDF only)`_ および `metadata export`_ " "をCSVファイルに行うための2つのユーティリティスクリプトがあります" #: ../../tutorial.rst:96 1d31369f6b884d08a61b700b01e9e7b1 msgid "Working with Outlines" msgstr "アウトラインと一緒に作業する" #: ../../tutorial.rst:97 fe8e22242a324f349fca363f8d0f6348 msgid "" "The easiest way to get all outlines (also called \"bookmarks\") of a " "document, is by loading its *table of contents*::" msgstr "アウトライン（または「ブックマーク」とも呼ばれる）を取得する最も簡単な方法は、そのドキュメントの目次を読み込むことです::" #: ../../tutorial.rst:101 4fe54a9ca0244cd9871ba72a155cbe95 msgid "" "This will return a Python list of lists *[[lvl, title, page, ...], ...]* " "which looks much like a conventional table of contents found in books." msgstr "" "これにより、Pythonのリストであるリスト [[lvl, title, page, ...], ...] " "が返されます。これは、本に見られる伝統的な目次に非常によく似たものです。" #: ../../tutorial.rst:103 a0df1526a42e4d88bf1fb24bf14c2392 msgid "" "*lvl* is the hierarchy level of the entry (starting from 1), *title* is " "the entry's title, and *page* the page number (1-based!). Other " "parameters describe details of the bookmark target." msgstr "" "lvl はエントリーの階層レベル（1から開始）を示し、title はエントリーのタイトル、page " "はページ番号（1から始まる）を示します。その他のパラメータはブックマークのターゲットの詳細を説明します。" #: ../../tutorial.rst:105 f60efb5302364edfb64c7775c185929b msgid "" "There are two utility scripts in the repository that `toc import (PDF " "only)`_ resp. `toc export`_ table of contents from resp. to CSV files." msgstr "" "リポジトリ内には、CSVファイルから目次をインポートおよびエクスポートするためのユーティリティスクリプトが2つあります。詳細は、 `toc " "import (PDF only)`_ および `toc export`_ をご覧ください。" #: ../../tutorial.rst:108 f7e0d8ac5cd64bbfb19d5a7680f37840 msgid "Working with Pages" msgstr "ページの操作" #: ../../tutorial.rst:109 bea68ab57a6a4ec49fa98a57625daec3 msgid ":ref:`Page` handling is at the core of MuPDF's functionality." msgstr ":ref:`Page` の処理はMuPDFの機能の中核です。" #: ../../tutorial.rst:111 705fbd37cfd04f5eb2725ee74973716c msgid "" "You can render a page into a raster or vector (SVG) image, optionally " "zooming, rotating, shifting or shearing it." msgstr "ページをラスターまたはベクター（SVG）イメージにレンダリングすることができます。オプションでズーム、回転、シフト、またはシアーを行うこともできます" #: ../../tutorial.rst:112 07346e73ca2f4851bcb7243ed707f0c5 msgid "" "You can extract a page's text and images in many formats and search for " "text strings." msgstr "テキストと画像を多くの形式で抽出し、テキスト文字列を検索することができます。" #: ../../tutorial.rst:113 b10390460b7e469d933d4b0bca64cbd8 msgid "" "For PDF documents many more methods are available to add text or images " "to pages." msgstr "PDFドキュメントの場合、さらに多くのメソッドが利用可能で、テキストや画像をページに追加することができます" #: ../../tutorial.rst:115 634af7e840c34aba910ebc8b50aac6b1 msgid "" "First, a :ref:`Page` must be created. This is a method of " ":ref:`Document`::" msgstr "最初に :ref:`Page` を作成する必要があります。これは :ref:`Document` のメソッドです::" #: ../../tutorial.rst:120 e13781020ec34c48a1d29405c5d4063b msgid "" "Any integer `-∞ < pno < page_count` is possible here. Negative numbers " "count backwards from the end, so *doc[-1]* is the last page, like with " "Python sequences." msgstr "" "ここでは、どんな整数 `-∞ < pno < page_count` でも可能です。負の数は末尾から逆に数えますので、doc[-1] " "はPythonのシーケンスと同様に最後のページになります" #: ../../tutorial.rst:122 4e28316907e444489cfbf10a12e27bba msgid "" "Some more advanced way would be using the document as an **iterator** " "over its pages::" msgstr "より高度な方法として、ドキュメントをそのページの **イテレータ** として使用することもできます::" #: ../../tutorial.rst:136 84e73234fd424852a2b36c0bc15b2d9d msgid "Once you have your page, here is what you would typically do with it:" msgstr "ページを取得したら、通常は次のようなことを行います：" #: ../../tutorial.rst:139 088737b71af34948b17fbe30a60a9dc4 msgid "Inspecting the Links, Annotations or Form Fields of a Page" msgstr "リンク、注釈、またはフォームフィールドをページで調査する" #: ../../tutorial.rst:140 80600b8ed5664159a8aad4e5b6706037 msgid "" "Links are shown as \"hot areas\" when a document is displayed with some " "viewer software. If you click while your cursor shows a hand symbol, you " "will usually be taken to the target that is encoded in that hot area. " "Here is how to get all links::" msgstr "リンクは、ドキュメントがビューアソフトウェアで表示されるときに「ホットエリア」として表示されます。カーソルが手のシンボルを示すときにクリックすると、通常、そのホットエリアにエンコードされたターゲットに移動します。以下はすべてのリンクを取得する方法です::" #: ../../tutorial.rst:145 5b90391005b24d46b953ffde747dbd80 msgid "" "*links* is a Python list of dictionaries. For details see " ":meth:`Page.get_links`." msgstr "`links` はPythonの辞書のリストです。詳細は :meth:`Page.get_links` を参照してください。" #: ../../tutorial.rst:147 19b388140fd44ace88779d4d2f85e3f5 msgid "You can also use an iterator which emits one link at a time::" msgstr "また、一度に1つのリンクを生成するイテレータを使用することもできます::" #: ../../tutorial.rst:152 972adb409c6b4d1781d1976cb040f944 msgid "" "If dealing with a PDF document page, there may also exist annotations " "(:ref:`Annot`) or form fields (:ref:`Widget`), each of which have their " "own iterators::" msgstr "PDFドキュメントのページを扱う場合、注釈（:ref:`Annot`）やフォームフィールド（:ref:`Widget`）も存在する場合があります。それぞれに独自のイテレータがあります::" #: ../../tutorial.rst:162 354960511fbd4e299b3561f27464ffa6 msgid "Rendering a Page" msgstr "ページのレンダリング" #: ../../tutorial.rst:163 4b29e0e4b9f04b54a4b12db45462cebe msgid "This example creates a **raster** image of a page's content::" msgstr "以下の例は、ページの内容をラスター画像として作成します::" #: ../../tutorial.rst:167 b23c4b5d3b5345f0add5cb0dffaa6255 msgid "" "``pix`` is a :ref:`Pixmap` object which (in this case) contains an " "**RGB** image of the page, ready to be used for many purposes. Method " ":meth:`Page.get_pixmap` offers lots of variations for controlling the " "image: resolution / DPI, colorspace (e.g. to produce a grayscale image or" " an image with a subtractive color scheme), transparency, rotation, " "mirroring, shifting, shearing, etc. For example: to create an **RGBA** " "image (i.e. containing an alpha channel), specify *pix = " "page.get_pixmap(alpha=True)*." msgstr "" "`pix` はページのRGBイメージを含む :ref:`Pixmap` " "オブジェクトです。このイメージは多くの目的に使用する準備ができています。:meth:`Page.get_pixmap` " "メソッドには、画像を制御するためのさまざまなオプションが用意されています：解像度/DPI、カラースペース（例えば、グレースケールイメージや減色カラースキームのイメージを作成するために）、透明度、回転、ミラーリング、シフト、シアーなどがあります。例えば、RGBAイメージ（アルファチャネルを含むイメージ）を作成する場合は、`pix" " = page.get_pixmap(alpha=True)` と指定します。" #: ../../tutorial.rst:169 e2331fb68ff848cab6245b27ba5f4079 msgid "" "A :ref:`Pixmap` contains a number of methods and attributes which are " "referenced below. Among them are the integers ``width``, ``height`` (each" " in pixels) and ``stride`` (number of bytes of one horizontal image " "line). Attribute ``samples`` represents a rectangular area of bytes " "representing the image data (a Python ``bytes`` object)." msgstr "" ":ref:`Pixmap` " "には、以下で参照されるいくつかのメソッドと属性が含まれています。その中には、ピクセル単位の整数である幅、高さ（それぞれピクセル単位）および " "`stride` （1つの水平イメージラインのバイト数）があります。属性 `samples` " "は、イメージデータを表すバイトの長方形領域（Pythonの `bytes` オブジェクト）を表します。" #: ../../tutorial.rst:171 03e8c67cd34a4299bbacfe8abd40de63 msgid "" "You can also create a **vector** image of a page by using " ":meth:`Page.get_svg_image`. Refer to this `Vector Image Support page`_ " "for details." msgstr "" ":meth:`Page.get_svg_image` " "を使用することで、ページのベクターイメージを作成することもできます。詳細については、`Vector Image Support page`_ " "ページを参照してください。" #: ../../tutorial.rst:174 c887d409be174ceca947d6b32e881d03 msgid "Saving the Page Image in a File" msgstr "ページのイメージをファイルに保存する" #: ../../tutorial.rst:175 5e39659faf42451083abd892ba3bdb4e msgid "We can simply store the image in a PNG file::" msgstr "簡単にページのイメージをPNGファイルに保存できます::" #: ../../tutorial.rst:180 7ef7b19218354906a6c5d511a0672a1f msgid "Displaying the Image in GUIs" msgstr "GUIでイメージを表示する" #: ../../tutorial.rst:181 f6651c84f3d54689abdaff0d00a3095e msgid "" "We can also use it in GUI dialog managers. :attr:`Pixmap.samples` " "represents an area of bytes of all the pixels as a Python bytes object. " "Here are some examples, find more in the `examples`_ directory." msgstr "" "GUIダイアログマネージャーでも使用できます。 :attr:`Pixmap.samples` " "は、すべてのピクセルのバイトの領域をPythonのbytesオブジェクトとして表します。以下はいくつかの例ですが、さらに多くの例は " "`examples`_ ディレクトリで見つけることができます。" #: ../../tutorial.rst:184 93b0ff029516467ca4a36bb526aeb687 msgid "wxPython" msgstr "" #: ../../tutorial.rst:185 6f03843027834dda8394ee85d04238d5 msgid "" "Consult their documentation for adjustments to RGB(A) pixmaps and, " "potentially, specifics for your wxPython release::" msgstr "RGB(A)のピクセルマップに対する調整や、可能な場合はwxPythonのリリースに特有の詳細については、関連するドキュメントを参照してください。" #: ../../tutorial.rst:193 b6f1e9b15675411e9bd7023777e4b99a msgid "Tkinter" msgstr "" #: ../../tutorial.rst:194 c11e72b65c0e4368a0fe00c748909105 msgid "Please also see section 3.19 of the `Pillow documentation`_::" msgstr "`Pillow documentation`_ ドキュメントのセクション3.19も参照してください。" #: ../../tutorial.rst:203 41e53493133b4606b75fc48aa4b02d6b msgid "The following **avoids using Pillow**::" msgstr "以下の方法では、Pillowを使用しないようにしています。" #: ../../tutorial.rst:210 2d36aa26bccf4e5ba49ede95aef20a49 msgid "" "If you are looking for a complete Tkinter script paging through **any " "supported** document, `here it is!`_. It can also zoom into pages, and it" " runs under Python 2 or 3. It requires the extremely handy `PySimpleGUI`_" " pure Python package." msgstr "" "もし、サポートされている任意のドキュメントをページ送りで表示する完全なTkinterスクリプトをお探しでしたら、`こちらがあります！ " "`_ また、このスクリプトではページをズームインすることもでき、Python " "2または3で動作します。非常に便利な純粋なPythonパッケージである `PySimpleGUI`_ が必要です。" #: ../../tutorial.rst:213 9a88cb97b2d9452ab197250569501e5f msgid "PyQt4, PyQt5, PySide" msgstr "" #: ../../tutorial.rst:214 daeac83261ba4066a7dc604d3aa562f2 msgid "Please also see section 3.16 of the `Pillow documentation`_::" msgstr "Pillowドキュメントのセクション3.16も参照してください。" #: ../../tutorial.rst:223 b85add3e93e4499b89e82f1646430a26 msgid "" "Again, you also can get along **without using Pillow.** Qt's `QImage` " "luckily supports native Python pointers, so the following is the " "recommended way to create Qt images::" msgstr "Pillowを使用せずに進めることもできます。幸運なことに、QtのQImageはネイティブなPythonポインタをサポートしているので、以下はQtイメージを作成する推奨される方法です。" #: ../../tutorial.rst:233 0fcb7bc54009424fa20575e22fb06d0e msgid "Extracting Text and Images" msgstr "テキストや画像を抽出する" #: ../../tutorial.rst:234 f5900cc6c4924334a0f4bf4d1bdae4ae msgid "" "We can also extract all text, images and other information of a page in " "many different forms, and levels of detail::" msgstr "ページのすべてのテキスト、画像、およびその他の情報を、さまざまな形式や詳細レベルで抽出することもできます。::" #: ../../tutorial.rst:238 48bff694040b45549010d3b53435733b msgid "" "Use one of the following strings for *opt* to obtain different formats " "[#f2]_:" msgstr "異なるフォーマットを得るために、以下の文字列のうち1つをoptに使用できます [#f2]_:" #: ../../tutorial.rst:240 3c9203fe338a46629695295936dc44a4 msgid "" "**\"text\"**: (default) plain text with line breaks. No formatting, no " "text position details, no images." msgstr "**\"text\"**: (デフォルト) 行送りのプレーンテキスト。書式設定やテキストの位置の詳細、画像は含まれません。" #: ../../tutorial.rst:242 ef523faacbb4433e9599b78451f9a623 msgid "**\"blocks\"**: generate a list of text blocks (= paragraphs)." msgstr "**\"blocks\"**: テキストブロック（段落）のリストを生成します。" #: ../../tutorial.rst:244 494f2cbaf4dc4d3595b54a18d8165a4f msgid "**\"words\"**: generate a list of words (strings not containing spaces)." msgstr "**\"words\"**: 単語（スペースを含まない文字列）のリストを生成します。" #: ../../tutorial.rst:246 f95d696f7efa4e48a4fe4018638ee139 msgid "" "**\"html\"**: creates a full visual version of the page including any " "images. This can be displayed with your internet browser." msgstr "**\"html\"**: 画像を含むページの完全な視覚的バージョンを作成します。これはインターネットブラウザで表示できます。" #: ../../tutorial.rst:248 8f24748d78b04cc6b92c29fcae8ff8ca msgid "" "**\"dict\"** / **\"json\"**: same information level as HTML, but provided" " as a Python dictionary or resp. JSON string. See " ":meth:`TextPage.extractDICT` for details of its structure." msgstr "" "**\"dict\"** / **\"json\"**: " "HTMLと同じ情報レベルですが、Pythonの辞書またはJSON文字列として提供されます。その構造の詳細については、:meth:`TextPage.extractDICT`" " を参照してください。" #: ../../tutorial.rst:250 266283a205584bb98dd88e0282b81b8a msgid "" "**\"rawdict\"** / **\"rawjson\"**: a super-set of **\"dict\"** / " "**\"json\"**. It additionally provides character detail information like " "XML. See :meth:`TextPage.extractRAWDICT` for details of its structure." msgstr "" "**\"rawdict\"** / **\"rawjson\"**: \"dict\" / " "\"json\"のスーパーセットです。これにはXMLのような文字の詳細情報も含まれます。その構造の詳細については、:meth:`TextPage.extractRAWDICT`" " を参照してください。" #: ../../tutorial.rst:252 be5015a7daf84be89659b718295dcaf6 msgid "" "**\"xhtml\"**: text information level as the TEXT version but includes " "images. Can also be displayed by internet browsers." msgstr "**\"xhtml\"**: TEXTバージョンのテキスト情報レベルを含み、画像も含まれます。インターネットブラウザでも表示できます。" #: ../../tutorial.rst:254 6a9fccccc2af470dbe418b64d95196fb msgid "" "**\"xml\"**: contains no images, but full position and font information " "down to each single text character. Use an XML module to interpret." msgstr "" "**\"xml\"**: " "画像は含まれませんが、各テキスト文字までの完全な位置とフォント情報を含みます。XMLモジュールを使用して解釈することができます。" #: ../../tutorial.rst:256 c2fb29629d574544ba6240118706a993 msgid "" "To give you an idea about the output of these alternatives, we did text " "example extracts. See :ref:`Appendix1`." msgstr "これらの代替方法の出力のイメージを示すために、テキストの例抽出を行いました。:ref:`Appendix1` を参照してください" #: ../../tutorial.rst:259 6fcbe8fa549f4672940aa6a7baa43298 msgid "Searching for Text" msgstr "テキストを検索す" #: ../../tutorial.rst:260 055f0da706d34efba1868870cc7ac25e msgid "You can find out, exactly where on a page a certain text string appears::" msgstr "特定のテキスト文字列がページのどこに現れるかを正確に調べることができます。::" #: ../../tutorial.rst:264 fa6460b021d44b8aba602b1940777f99 msgid "" "This delivers a list of rectangles (see :ref:`Rect`), each of which " "surrounds one occurrence of the string \"mupdf\" (case insensitive). You " "could use this information to e.g. highlight those areas (PDF only) or " "create a cross reference of the document." msgstr "" "このコードは、\"mupdf\"（大文字と小文字を区別しない）という文字列が含まれる各領域を囲む長方形（ :ref:`Rect` " "参照）のリストを生成します。この情報を使って、それらの領域を強調表示したり（PDFのみ）、文書のクロスリファレンスを作成したりすることができます。" #: ../../tutorial.rst:266 9602ff0fbee54febb5a9bce0eb7643a8 msgid "" "Please also do have a look at chapter :ref:`cooperation` and at demo " "programs `demo.py`_ and `demo-lowlevel.py`_. Among other things they " "contain details on how the :ref:`TextPage`, :ref:`Device` and " ":ref:`DisplayList` classes can be used for a more direct control, e.g. " "when performance considerations suggest it." msgstr "" "また、:ref:`cooperation` という章、およびデモプログラム `demo.py`_ と `demo-lowlevel.py`_ " "も参照してください。これらには、:ref:`TextPage` 、 :ref:`Device` 、:ref:`DisplayList` " "クラスをより直接的に制御する方法に関する詳細な情報が含まれています。例えば、パフォーマンスを考慮する必要がある場合などに役立ちます" #: ../../tutorial.rst:273 d532b1e3d0b249d5863b7d1af292f56f msgid "Stories: Generating PDF from HTML Source" msgstr "ストーリー: HTMLソースからPDFを生成する" #: ../../tutorial.rst:275 416352710d134781921a3400fd5b5ef0 msgid "" "The :ref:`Story` class is a new feature of PyMuPDF version 1.21.0. It " "represents support for MuPDF's **\"story\"** interface." msgstr "" "ストーリークラスはPyMuPDFバージョン1.21.0の新機能です。これはMuPDFの :ref:`Story` " "インターフェースに対するサポートを表しています。" #: ../../tutorial.rst:277 accd3e3fc6d547b78b274237642033d6 msgid "" "The following is a quote from the book `\"MuPDF Explored\"`_ by Robin " "Watts from `Artifex`_:" msgstr "以下はArtifexのRobin Wattsによる書籍「MuPDF Explored」からの引用です。" #: ../../tutorial.rst:281 47e500970eb842949a968db6adee0910 msgid "" "*Stories provide a way to easily layout styled content for use with " "devices, such as those offered by Document Writers (...). The concept of " "a story comes from desktop publishing, which in turn (...) gets it from " "newspapers. If you consider a traditional newspaper layout, it will " "consist of various news articles (stories) that are laid out into " "multiple columns, possibly across multiple pages.*" msgstr "*ストーリーは、ドキュメントライターなどのデバイスで使用するためのスタイル付きコンテンツを簡単にレイアウトする方法を提供します。ストーリーという概念は、デスクトップパブリッシングから来ており、それ自体が新聞から取り入れられています。伝統的な新聞のレイアウトを考えると、複数の列や複数のページにわたって配置されたさまざまなニュース記事（ストーリー）で構成されています。*" #: ../../tutorial.rst:283 27ebf650cfb746b6ae9e42bdde508478 msgid "" "*Accordingly, MuPDF uses a story to represent a flow of text with styling" " information. The user of the story can then supply a sequence of " "rectangles into which the story will be laid out, and the positioned text" " can then be drawn to an output device. This keeps the concept of the " "text itself (the story) to be separated from the areas into which the " "text should be flowed (the layout).*" msgstr "*それに応じて、MuPDFでは、テキストのフローとスタイリング情報を表すためにストーリーを使用しています。ストーリーのユーザーは、ストーリーをレイアウトするための矩形のシーケンスを提供し、配置されたテキストを出力デバイスに描画できます。これにより、テキスト自体（ストーリー）がテキストを配置する領域（レイアウト）から分離されるという概念が保持されます*" #: ../../tutorial.rst:287 7da64d937fe84390a33b56158c76d219 msgid "" "A Story works somewhat similar to an internet browser: It faithfully " "parses and renders HTML hypertext and also optional stylesheets (CSS). " "But its **output is a PDF** -- not web pages." msgstr "ストーリーは、インターネットブラウザといくつかの点で似ています。それは忠実にHTMLハイパーテキストとオプションのスタイルシート（CSS）を解析してレンダリングします。ただし、出力されるのはPDFであり、ウェブページではありません。" #: ../../tutorial.rst:290 290d5414b6754a0a8cec4ef553811e70 msgid "" "When creating a :ref:`Story`, the input from up to three different " "information sources is taken into account. All these items are optional." msgstr "ストーリーを作成する際には、最大3つの異なる情報源からの入力が考慮されます。これらのすべてのアイテムはオプションです。" #: ../../tutorial.rst:292 b76811f3a6e94ca48849af027b1e4aa7 msgid "" "HTML source code, either a Python string or **created by the script** " "using methods of :ref:`Xml`." msgstr "HTMLソースコード：Pythonの文字列として提供されるか、 :ref:`Xml` のメソッドを使用してスクリプトによって作成されます。" #: ../../tutorial.rst:294 631005d36d9d478eb1222c6746a62f78 msgid "" "CSS (Cascaded Style Sheet) source code, provided as a Python string. CSS " "can be used to provide styling information (text font size, color, etc.) " "like it would happen for web pages. Obviously, this string may also be " "read from a file." msgstr "CSS（カスケーディングスタイルシート）ソースコード：Pythonの文字列として提供されます。CSSは、ウェブページにおけるように、スタイリング情報（テキストフォントサイズ、色など）を提供するために使用できます。もちろん、この文字列はファイルから読み込むこともできます。" #: ../../tutorial.rst:296 b555903aaf064df4ac02bf4379ecd84b msgid "" "An :ref:`Archive` **must be used** whenever the DOM references images, or" " uses text fonts except the standard :ref:`Base-14-Fonts`, CJK fonts and " "the NOTO fonts generated into the PyMuPDF binary." msgstr "" "DOMが画像を参照する場合や、標準の :ref:`Base-14-Fonts` " "、CJKフォント、およびPyMuPDFバイナリに生成されたNOTOフォント以外のテキストフォントを使用する場合、 :ref:`Archive` " "を使用する必要があります。" #: ../../tutorial.rst:299 5a5a7775caf44157ab99d4fb18a08da0 msgid "" "The :ref:`API` allows creating DOMs completely from scratch, " "including desired styling information. It can also be used to modify or " "extend **provided** HTML: text can be deleted or replaced, or its styling" " can be changed. Text -- for example extracted from databases -- can also" " be added and fill template-like HTML documents." msgstr "" "この :ref:`API` " "では、望むスタイル情報を含めて、DOMを完全にゼロから作成することができます。また、提供されたHTMLを変更したり拡張したりするためにも使用できます。テキストは削除や置換ができ、スタイルも変更できます。データベースから抽出されたテキストを追加して、テンプレートのようなHTMLドキュメントを作成することもできます。" #: ../../tutorial.rst:301 eff1f356f57a4a5baa32893df82ccc7f msgid "" "It is **not required** to provide syntactically complete HTML documents: " "snippets like `Hello World!` are fully accepted, and many /" " most syntax errors are automatically corrected." msgstr "" "文法的に完全なHTMLドキュメントを提供する必要はありません。例えば ``HelloWorld!`` " "のような断片も完全に受け入れられ、多くの場合、構文エラーは自動的に修正されます。" #: ../../tutorial.rst:303 365fa2cc06434ed8ad7429aaf3a63265 msgid "" "After the HTML is considered complete, it can be used to create a PDF " "document. This happens via the new :ref:`DocumentWriter` class. The " "programmer calls its methods to create a new empty page, and passes " "rectangles to the Story to fill them." msgstr "" "HTMLが完成したと見なされた後、それを使用してPDF文書を作成できます。これは新しい :ref:`DocumentWriter` " "クラスを介して行われます。プログラマーはそのメソッドを呼び出して新しい空のページを作成し、:ref:`Story` " "に矩形を渡してそれらを埋めることができます。" #: ../../tutorial.rst:305 3291ca47108e47b19f4b0bc0a5a4027b msgid "" "The story in turn will return completion codes indicating whether or not " "more content is waiting to be written. Which part of the content will " "land in which rectangle or on which page is automatically determined by " "the story itself -- it cannot be influenced other than by providing the " "rectangles." msgstr "" ":ref:`Story` " "は、書き込まれる待機中のコンテンツがあるかどうかを示す完了コードを返します。コンテンツのどの部分がどの矩形またはどのページに配置されるかは、:ref:`Story`" " 自体によって自動的に決定されます。矩形を提供すること以外では影響を与えることはできません。" #: ../../tutorial.rst:307 bd9d9dd769be42d4b2431ad4fac946e4 msgid "" "Please see the :ref:`Stories recipes` for a number of " "typical use cases." msgstr "典型的な使用例については、 :ref:`Stories recipes` レシピをご覧ください。" #: ../../tutorial.rst:311 b4514f2b40064533bbf026420a0260d7 msgid "PDF Maintenance" msgstr "PDFメンテナンス" #: ../../tutorial.rst:312 76f8cae636954def812f6bd6aa4d9077 msgid "" "PDFs are the only document type that can be **modified** using PyMuPDF. " "Other file types are read-only." msgstr "PDFはPyMuPDFを使用して変更できる唯一のドキュメントタイプです。他のファイルタイプは読み取り専用です。" #: ../../tutorial.rst:314 6d192d43c9e24232be29c65e1e0c1018 msgid "" "However, you can convert **any document** (including images) to a PDF and" " then apply all PyMuPDF features to the conversion result. Find out more " "here :meth:`Document.convert_to_pdf`, and also look at the demo script " "`pdf-converter.py`_ which can convert any :ref:`supported " "document` to PDF." msgstr "" "ただし、任意のドキュメント（画像を含む）をPDFに変換し、変換結果にすべてのPyMuPDF機能を適用することができます。 " ":meth:`Document.convert_to_pdf` " "で詳細を確認できます。また、任意のサポートされているドキュメントをPDFに変換できるデモスクリプト `pdf-converter.py`_ " "も確認してください。" #: ../../tutorial.rst:316 05d7bbe4027a4e9b98372c4707c22cd4 msgid "" ":meth:`Document.save()` always stores a PDF in its current (potentially " "modified) state on disk." msgstr ":meth:`Document.save()` は常に現在の（変更された可能性のある）PDFをディスクに保存します。" #: ../../tutorial.rst:318 400c516b51f0441a9c6ac7d433101329 msgid "" "You normally can choose whether to save to a new file, or just append " "your modifications to the existing one (\"incremental save\"), which " "often is very much faster." msgstr "通常、新しいファイルに保存するか、既存のファイルに変更内容を追加するか（「増分保存」）を選択できます。増分保存は非常に高速な場合があります。" #: ../../tutorial.rst:320 57fdfcd11a1245249d7e837f37b43094 msgid "" "The following describes ways how you can manipulate PDF documents. This " "description is by no means complete: much more can be found in the " "following chapters." msgstr "以下にPDFドキュメントを操作する方法を示しますが、これに限らず、詳細は次の章でさらに見つけることができます。" #: ../../tutorial.rst:323 ec4c85ec57124203b67f52652f082b88 msgid "Modifying, Creating, Re-arranging and Deleting Pages" msgstr "ページの修正、作成、再配置、および削" #: ../../tutorial.rst:324 625ab390c172404fbdc7aa9520874495 msgid "" "There are several ways to manipulate the so-called **page tree** (a " "structure describing all the pages) of a PDF:" msgstr "PDFの**ページツリー** （すべてのページを記述する構造）を操作するためには、いくつかの方法があります。" #: ../../tutorial.rst:326 159259eb9e4145daa6c13b2ad767f12e msgid "" ":meth:`Document.delete_page` and :meth:`Document.delete_pages` delete " "pages." msgstr ":meth:`Document.delete_page` と :meth:`Document.delete_pages` はページを削除します。" #: ../../tutorial.rst:328 473d5897fff649019f539d6232e91f44 msgid "" ":meth:`Document.copy_page`, :meth:`Document.fullcopy_page` and " ":meth:`Document.move_page` copy or move a page to other locations within " "the same document." msgstr "" ":meth:`Document.copy_page` 、 :meth:`Document.fullcopy_page` 、 " ":meth:`Document.move_page` は、ページを同じドキュメント内の他の場所にコピーしたり移動したりします。" #: ../../tutorial.rst:330 1e6c19e64c734426bec58da4dfbe7e0b msgid "" ":meth:`Document.select` shrinks a PDF down to selected pages. Parameter " "is a sequence [#f3]_ of the page numbers that you want to keep. These " "integers must all be in range *0 <= i < page_count*. When executed, all " "pages **missing** in this list will be deleted. Remaining pages will " "occur **in the sequence and as many times (!) as you specify them**." msgstr "" ":meth:`Document.select` " "はPDFを選択したページに縮小します。パラメータは[3]のページ番号のシーケンスで、保持したいページの番号を指定します。これらの整数はすべて範囲 " "`0 <= i < page_count` " "にある必要があります。実行されると、このリストに含まれていないすべてのページが削除されます。残ったページは指定した順序通りに（指定回数分！）現れます。" #: ../../tutorial.rst:332 1032d54636274cfab2c769409afa76e0 msgid "So you can easily create new PDFs with" msgstr "したがって、次のような簡単な方法で新しいPDFを作成できます:" #: ../../tutorial.rst:334 e8415caf00594110bef2b948c89abcbd msgid "the first or last 10 pages," msgstr "最初または最後の10ページ" #: ../../tutorial.rst:335 fc336f721207413b95dce987329adfad msgid "only the odd or only the even pages (for doing double-sided printing)," msgstr "奇数ページのみまたは偶数ページのみ（両面印刷用）" #: ../../tutorial.rst:336 3a6929bd1e7d4e178ef1549c9c67d87a msgid "pages that **do** or **don't** contain a given text," msgstr "特定のテキストを含むまたは含まないページ" #: ../../tutorial.rst:337 968ba746356447208207a1cee391ea52 msgid "reverse the page sequence, ..." msgstr "ページの順序を逆にする" #: ../../tutorial.rst:339 1c2ed724e9564be1a8841011462e53a1 msgid "... whatever you can think of." msgstr "... など、思いつく限りのことができます。" #: ../../tutorial.rst:341 3a7dc1aa206e4858a930d0cc0ce437cf msgid "" "The saved new document will contain links, annotations and bookmarks that" " are still valid (i.a.w. either pointing to a selected page or to some " "external resource)." msgstr "保存された新しいドキュメントには、まだ有効なリンク、注釈、およびブックマークが含まれています（選択したページを指すか、あるいは外部リソースを指すかを問わず）。" #: ../../tutorial.rst:343 62273df02f3a43edaca93b7b9899b551 msgid "" ":meth:`Document.insert_page` and :meth:`Document.new_page` insert new " "pages." msgstr ":meth:`Document.insert_page` および :meth:`Document.new_page` は新しいページを挿入します。" #: ../../tutorial.rst:345 62ec5bdcc4854cc0ab7b5a9c5de8295e msgid "" "Pages themselves can moreover be modified by a range of methods (e.g. " "page rotation, annotation and link maintenance, text and image " "insertion)." msgstr "さらに、ページ自体はさまざまな方法で変更できます（ページの回転、注釈とリンクの維持、テキストと画像の挿入など）" #: ../../tutorial.rst:348 f481a1f85523458ba716bfffa017ecc2 msgid "Joining and Splitting PDF Documents" msgstr "PDF文書の結合と分割" #: ../../tutorial.rst:350 5c4f9e715c364f99ab85e02a35390a54 msgid "" "Method :meth:`Document.insert_pdf` copies pages **between different** PDF" " documents. Here is a simple **joiner** example (*doc1* and *doc2* being " "opened PDFs)::" msgstr "" "メソッド :meth:`Document.insert_pdf` は異なるPDF文書間でページをコピーします。以下は簡単な結合の例です（ " "`doc1` と `doc2` は開かれたPDF文書です）::" #: ../../tutorial.rst:355 76e1ca6378be4c7780b008c6aa0147b1 msgid "" "Here is a snippet that **splits** *doc1*. It creates a new document of " "its first and its last 10 pages::" msgstr "以下は、 `doc1` を分割するスニペットです。最初の10ページと最後の10ページを含む新しいドキュメントを作成します。" #: ../../tutorial.rst:362 425d928677684aaebd2c13acc306cc3a msgid "" "More can be found in the :ref:`Document` chapter. Also have a look at " "`PDFjoiner.py`_." msgstr ":ref:`Document` の章にはさらに詳細が記載されています。また、 `PDFjoiner.py`_ も確認してください。" #: ../../tutorial.rst:365 3a32f81f55af4ff2942e6a5bda5351e4 msgid "Embedding Data" msgstr "データの埋め込み" #: ../../tutorial.rst:367 e8c1a07274464e69b5716d2cfcd333a2 msgid "" "PDFs can be used as containers for arbitrary data (executables, other " "PDFs, text or binary files, etc.) much like ZIP archives." msgstr "PDFはZIPアーカイブのように、任意のデータ（実行可能ファイル、他のPDF、テキストファイル、バイナリファイルなど）をコンテナとして使用できます。" #: ../../tutorial.rst:369 e53116859c304e5d8cae52bca7615d49 #, fuzzy msgid "" "PyMuPDF fully supports this feature via :ref:`Document` ``embfile_*`` " "methods and attributes. For some detail read :ref:`Appendix 3`, consult " "the Wiki on `dealing with embedding files`_, or the example scripts " "`embedded-copy.py`_, `embedded-export.py`_, `embedded-import.py`_, and " "`embedded-list.py`_." msgstr "" "PyMuPDFは :ref:`Document` *embfile_** " "メソッドと属性を介して、この機能を完全にサポートしています。詳細については、 :ref:`Appendix3` " "を読むか、ファイルの埋め込みに対処するためのウィキを参照してください。また、exampleスクリプトの `embedded-copy.py`_ " "、`embedded-export.py`_ 、`embedded-import.py`_ 、および `embedded-list.py`_ " "も参考になるでしょう。" #: ../../tutorial.rst:373 7e063cc85bf74b67af328699883eabcd msgid "Saving" msgstr "保存" #: ../../tutorial.rst:375 ddc980f323444d9a888df621e5e4413a msgid "" "As mentioned above, :meth:`Document.save` will **always** save the " "document in its current state." msgstr "前述のように、 :meth:`Document.save` は常にドキュメントを現在の状態で保存します。" #: ../../tutorial.rst:377 938eb4bca93d44e7ad9d9db6a21b0197 msgid "" "You can write changes back to the **original PDF** by specifying option " "``incremental=True``. This process is (usually) **extremely fast**, since" " changes are **appended to the original file** without completely " "rewriting it." msgstr "" "オプション `incremental=True` " "を指定することで、変更を元のPDFに書き戻すことができます。このプロセスは（通常）非常に高速です。変更は元のファイルに追加されるため、完全に書き直す必要がありません。" #: ../../tutorial.rst:379 34a90e8b41204457b27c7bf4c896ed07 msgid "" ":meth:`Document.save` options correspond to options of MuPDF's command " "line utility *mutool clean*, see the following table." msgstr "" ":meth:`Document.save` のオプションは、MuPDFのコマンドラインユーティリティmutool " "cleanのオプションと対応しています。以下の表を参照してください。" #: ../../tutorial.rst:382 1163070c3e2e478c9edfeeef99960201 msgid "**Save Option**" msgstr "**保存オプション**" #: ../../tutorial.rst:382 94311b1ebca3478a8d7bf6f6d522fd8b msgid "**mutool**" msgstr "" #: ../../tutorial.rst:382 962d3ef8846c431c8e9dfdf9d487bfb1 msgid "**Effect**" msgstr "**効果**" #: ../../tutorial.rst:384 b65cf8acc8bc476f8334931a4c8a17b8 msgid "garbage=1" msgstr "" #: ../../tutorial.rst:384 6b4221531c1b4915975145d5a46840f9 msgid "g" msgstr "" #: ../../tutorial.rst:384 b773213735d5433a912d7d50de094b58 msgid "garbage collect unused objects" msgstr "未使用のオブジェクトをガベージコレクションします" #: ../../tutorial.rst:385 9bb3557107484b32b9d48ee883975e41 msgid "garbage=2" msgstr "" #: ../../tutorial.rst:385 e5d8266ec4434156843ae8d329cb1234 msgid "gg" msgstr "" #: ../../tutorial.rst:385 5d1cd64ee4a44495b52e5808a4c51ebf msgid "in addition to 1, compact :data:`xref` tables" msgstr "1に加えて、xrefテーブルをコンパクトにします" #: ../../tutorial.rst:386 5846a30c454d494b9cb77c2612b7e3ba msgid "garbage=3" msgstr "" #: ../../tutorial.rst:386 8499a2c0b7254ddfbc44cba627532452 msgid "ggg" msgstr "" #: ../../tutorial.rst:386 349d1afd120c468c8663d3467baf0a1d msgid "in addition to 2, merge duplicate objects" msgstr "2に加えて、重複したオブジェクトをマージします" #: ../../tutorial.rst:387 f97513200d184db2818ef3272e06659d msgid "garbage=4" msgstr "" #: ../../tutorial.rst:387 8818b59f9bf3464e8ff2acae77c152f2 msgid "gggg" msgstr "" #: ../../tutorial.rst:387 c284ddf0b0794e979bfa728c57373d83 msgid "in addition to 3, merge duplicate stream content" msgstr "3に加えて、重複したストリームの内容をマージします" #: ../../tutorial.rst:388 7874a21a2a374610abddf1cbd7efb717 msgid "clean=True" msgstr "" #: ../../tutorial.rst:388 c1e6bac1097a452a8399150c1e9c8279 msgid "cs" msgstr "" #: ../../tutorial.rst:388 9ddc64830c9040ed8451f02ed2741816 msgid "clean and sanitize content streams" msgstr "コンテンツストリームをクリーンアップしてサニタイズします" #: ../../tutorial.rst:389 c2f486c396c84db0ba07db1c9ee5a7ae msgid "deflate=True" msgstr "" #: ../../tutorial.rst:389 49a98a67d15747c98e6ca70bb53f3c51 msgid "z" msgstr "" #: ../../tutorial.rst:389 37e910e46f2247d3a69e36dbd0748d94 msgid "deflate uncompressed streams" msgstr "非圧縮のストリームをdeflate圧縮します" #: ../../tutorial.rst:390 7ffbd7aa96264ff1902b58f73b4fd092 msgid "deflate_images=True" msgstr "" #: ../../tutorial.rst:390 83ea4c4b317d488092885540eb84f939 msgid "i" msgstr "" #: ../../tutorial.rst:390 4e719956c06a4d49bb8d10a19576ee42 msgid "deflate image streams" msgstr "画像ストリームをdeflate圧縮します" #: ../../tutorial.rst:391 c33f6052e9494538ae7f4e1191c64fd2 msgid "deflate_fonts=True" msgstr "" #: ../../tutorial.rst:391 9786f972e1be4a16b85ffee8b754ec19 msgid "f" msgstr "" #: ../../tutorial.rst:391 79fefb0533874ecb8a096e7db7f10332 msgid "deflate fontfile streams" msgstr "フォントファイルストリームをdeflate圧縮します" #: ../../tutorial.rst:392 423d166f2fc54b4498a9377a2dd30960 msgid "ascii=True" msgstr "" #: ../../tutorial.rst:392 a67143a6cbe040c590ae0a63a0fe9234 msgid "a" msgstr "" #: ../../tutorial.rst:392 59590f861522439b8f81250d3941e06c msgid "convert binary data to ASCII format" msgstr "バイナリデータをASCII形式に変換します" #: ../../tutorial.rst:393 86236a9e66cf4150970d92080d6e1583 msgid "linear=True" msgstr "" #: ../../tutorial.rst:393 5893e24f2faa4060ba0c43aa63dbd263 msgid "l" msgstr "" #: ../../tutorial.rst:393 0dec5675398e49978e78651893a99395 msgid "create a linearized version" msgstr "線形化バージョンを作成します" #: ../../tutorial.rst:394 febbe58d4b104f8bbe950ccccccb1859 msgid "expand=True" msgstr "" #: ../../tutorial.rst:394 ef0e028a01314e21a0d744ca0d2ad01f msgid "d" msgstr "" #: ../../tutorial.rst:394 09ec7a0736e34a67aa68a9542195d17e msgid "decompress all streams" msgstr "すべてのストリームを解凍します" #: ../../tutorial.rst:397 e917b060c085407fb80a474e3bec75e9 #, fuzzy msgid "" "For an explanation of terms like ``object``, ``stream``, ``xref`` consult" " the :ref:`Glossary` chapter." msgstr "オブジェクト、ストリーム、xrefなどの用語の詳細については、 :ref:`Glossary` の章を参照してください。" #: ../../tutorial.rst:399 dcb5dc3e6c3a41349a7db5e5052ed2e0 msgid "" "For example, ``mutool clean -ggggz file.pdf`` yields excellent " "compression results. It corresponds to ``doc.save(filename, garbage=4, " "deflate=True)``." msgstr "" "例えば、 `mutool clean -ggggz file.pdf` は優れた圧縮結果をもたらします。これは " "`doc.save(filename, garbage=4, deflate=True)` に対応しています。" #: ../../tutorial.rst:402 c79ea0512d3b44e78f142255268af6ac msgid "Closing" msgstr "クローズ" #: ../../tutorial.rst:403 f745b8b8cfd64cd0955b6d9c72baa5f3 msgid "" "It is often desirable to \"close\" a document to relinquish control of " "the underlying file to the OS, while your program continues." msgstr "プログラムが継続する間に、基になるファイルの制御をOSに戻すために、ドキュメントを「クローズ」することがしばしば望まれます。" #: ../../tutorial.rst:405 6ec44b753b01413a9bcbd6b21a1310d7 msgid "" "This can be achieved by the :meth:`Document.close` method. Apart from " "closing the underlying file, buffer areas associated with the document " "will be freed." msgstr "" "これは :meth:`Document.close` " "メソッドによって実現できます。基になるファイルをクローズするだけでなく、ドキュメントに関連するバッファ領域も解放されます。" #: ../../tutorial.rst:408 88cb960755d5457da5441939ff0c836d msgid "Further Reading" msgstr "さらなる情報" #: ../../tutorial.rst:409 079337447add4588b00679495c0756c6 msgid "" "Also have a look at PyMuPDF's `Wiki`_ pages. Especially those named in " "the sidebar under title **\"Recipes\"** cover over 15 topics written in " "\"How-To\" style." msgstr "" "また、PyMuPDFの `Wiki`_ " "ページもご覧ください。特に、サイドバーのタイトル「Recipes」の下に名前が挙げられているものは、15以上のトピックが「How-" "To」スタイルで書かれています。" #: ../../tutorial.rst:411 4ff206365d3c46319f8786732294335f msgid "" "This document also contains a :ref:`FAQ`. This chapter has close " "connection to the aforementioned recipes, and it will be extended with " "more content over time." msgstr ":ref:`Recipes: Table of Contents` をご覧ください。" #: ../../tutorial.rst:418 8469cb98a4bc46da95e015537403452d msgid "Footnotes" msgstr "脚注" #: ../../tutorial.rst:419 7abfecf3e58542b0859cd575498948f7 msgid "" "PyMuPDF lets you also open several image file types just like normal " "documents. See section :ref:`ImageFiles` in chapter :ref:`Pixmap` for " "more comments." msgstr "" "PyMuPDFは通常のドキュメントと同様に、いくつかの画像ファイル形式も開くことができます。詳細は、章 :ref:`Pixmap` のセクション " ":ref:`ImageFiles` を参照してください。" #: ../../tutorial.rst:421 70b740aad28644b395c85b6a12f20f0e msgid "" ":meth:`Page.get_text` is a convenience wrapper for several methods of " "another PyMuPDF class, :ref:`TextPage`. The names of these methods " "correspond to the argument string passed to :meth:`Page.get_text` \\: " "*Page.get_text(\"dict\")* is equivalent to *TextPage.extractDICT()* \\." msgstr "" ":meth:`Page.get_text` は、別のPyMuPDFクラス、:ref:`TextPage` " "のいくつかのメソッドの便利なラッパーです。これらのメソッドの名前は、 :meth:`Page.get_text` " "に渡された引数文字列に対応しています。例えば、 `Page.get_text(“dict”)` は " "`TextPage.extractDICT()` と同等です。" #: ../../tutorial.rst:423 13eddbfd7bd64cd49e523d76972c7368 msgid "" "\"Sequences\" are Python objects conforming to the sequence protocol. " "These objects implement a method named *__getitem__()*. Best known " "examples are Python tuples and lists. But *array.array*, *numpy.array* " "and PyMuPDF's \"geometry\" objects (:ref:`Algebra`) are sequences, too. " "Refer to :ref:`SequenceTypes` for details." msgstr "\"シーケンス\"とは、シーケンスプロトコルに準拠したPythonオブジェクトのことを指します。これらのオブジェクトは、getitem()という名前のメソッドを実装しています。よく知られた例としては、Pythonのタプルやリストがあります。しかし、array.array、numpy.array、およびPyMuPDFの「geometry」オブジェクト（幾何オブジェクトのためのオペレーター代数）もシーケンスです。詳細については、「PyMuPDFにおけるPythonシーケンスの引数の使用」を参照してください" #: ../../footer.rst:46 34f591e7f8ab491b884b15a32b4f508e msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "Importing |PyMuPDF| as `fitz` still " #~ "works however |PyMuPDF| **cannot coexist** " #~ "with other packages named \"fitz\" in" #~ " the same Python environment." #~ msgstr "したがって、PyMuPDFは同じPython環境で「fitz」という名前のパッケージと共存することはできません" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/vars.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b5ad9d8dc172425eb69cab3f7d6af3f1 msgid "Artifex" msgstr "" #: ../../header.rst:-1 469b53fb216c416cab35e3785cb83220 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 3fc4b25efb434bdd9a36d5ea7c1bb7e4 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../vars.rst:5 f49c06cd5a6f4032b8cd339c64a77df1 msgid "Constants and Enumerations" msgstr "定数と列挙型" #: ../../vars.rst:6 49759909465a4d1794c2b500ea92ef1d #, fuzzy msgid "" "Constants and enumerations of :title:`MuPDF` as implemented by |PyMuPDF|." " Each of the following values is accessible as `pymupdf.value`." msgstr "PyMuPDFによって実装されたMuPDFの定数と列挙型。以下の各変数は、 *pymupdf.variable* としてアクセスできます。" #: ../../vars.rst:10 32fc3323ad3f4cdfb477267318e012bc msgid "Constants" msgstr "定数" #: ../../vars.rst:14 5b27640ef1ee4e98bea1cf03003160a1 msgid "Predefined Python list of valid :ref:`Base-14-Fonts`." msgstr "PDFベース14フォントの事前定義されたPythonリスト。" #: ../../vars.rst 03741e7ad1a44d5299f6572dedaca7b4 #: 049f7b4ff1974e208b3a904e6026a510 05d7b5730e6142eb96888bc1f1fbcc93 #: 0651bf5144c1497e884e5c0cc6076c5a 0d7a04755856497fa83f67a8849b2425 #: 26435fd0d5d24581abb8057002bce4cc 340ebf4c39ec45d4bfe3a768d8345ba6 #: 4305209c628b41b484db244a821e36a6 441240ad284b456d8fe847ecb191b0f1 #: 5ba5705e35594ba28d545462f311e0f9 61aa981fd8a346deaaf51a3d4c08d34a #: 6ca990f8a13b4358bbabc20892811cc3 771ae51b4e044a81ae255f6c908697fb #: 84cd0a4cb52c4fec9fe883c2ad4ace9d 850da1d028064e8191dfa082a3f82827 #: 8792cce457a84f11b18d64b74d8debc3 8a25036eb68c414abfb7ad4fa62d7229 #: 92c64e0683614c6c9deb6668c7f4b761 a2004991370a40408515cf83163b6ffb #: cdbf08fc2b5b4750b45132b7ec6c2616 d06dea99fa0a4e3cbee4b2b714c43296 #: f03ecc8098ca4cc181b8356bd7a2bb91 f3646d6d4cee48e0b1af3350ce178eec #: f7af32255ccb4f66a37175278b7b7087 fddcade3afa241b8a81b00e45d91f2a4 msgid "type" msgstr "" #: ../../vars.rst:16 669fb77a7bdd4fbcb224507f1b8d7932 msgid "list" msgstr "" #: ../../vars.rst:20 b3ae8b9f4f43444aa8fdc74de25f17f0 msgid "Predefined RGB colorspace *pymupdf.Colorspace(pymupdf.CS_RGB)*." msgstr "事前定義されたRGBカラースペース *pymupdf.Colorspace(pymupdf.CS_RGB)*。" #: ../../vars.rst:22 ../../vars.rst:28 ../../vars.rst:34 #: 19f89992935a4f8e839adc1511263368 204d25d273a7452cb5ba5e71b6869076 #: 79e2265294cd409f800e1e4a446e2ccf msgid ":ref:`Colorspace`" msgstr ":ref:`Colorspace`" #: ../../vars.rst:26 6a13d5103eb54565bf88415ab0ddc8c5 msgid "Predefined GRAY colorspace *pymupdf.Colorspace(pymupdf.CS_GRAY)*." msgstr "事前定義されたGRAYカラースペース *pymupdf.Colorspace(pymupdf.CS_GRAY)*。" #: ../../vars.rst:32 7321e72d393e42a3b735759e78d1800e msgid "Predefined CMYK colorspace *pymupdf.Colorspace(pymupdf.CS_CMYK)*." msgstr "事前定義されたCMYKカラースペース *pymupdf.Colorspace(pymupdf.CS_CMYK)*。" #: ../../vars.rst:38 69ab2345dd374ad1873f76d16292717c msgid "1 -- Type of :ref:`Colorspace` is RGBA" msgstr "1 – :ref:`Colorspace` のタイプはRGBA" #: ../../vars.rst:40 ../../vars.rst:46 ../../vars.rst:52 ../../vars.rst:324 #: ../../vars.rst:330 ../../vars.rst:339 ../../vars.rst:348 ../../vars.rst:354 #: ../../vars.rst:360 015aafcf193f4fd986c01b2543bb2157 #: 0a5dae970bce40d4a3ef066a7b52120d 648ca70552324683a3f2d83756f7f850 #: 9b976dcffb04497a9119e83b6b78aab2 ab0b93519cea4419af8c90b1cc9d3a36 #: b6975d022fb6464bb4f18e4ee6bd73fa c2c115fb5ad14e8da9970160f490f151 #: c3202da1e321403b976247fc2a19756a d3d462436758488a8dab6f328e27425e msgid "int" msgstr "" #: ../../vars.rst:44 23b50446130242d885968a5027985060 msgid "2 -- Type of :ref:`Colorspace` is GRAY" msgstr "2 – :ref:`Colorspace` のタイプはGRAY" #: ../../vars.rst:50 9cf5e34e2e83453799d96f7be872aa7b msgid "3 -- Type of :ref:`Colorspace` is CMYK" msgstr "3 – :ref:`Colorspace` のタイプはCMYK" #: ../../vars.rst:56 22d14edcfed74d6ba68f180a5162d3bc msgid "'x.xx.x' -- MuPDF version that is being used by PyMuPDF." msgstr "" #: ../../vars.rst:58 ../../vars.rst:70 24ffecb2a7de45fbbce9cac71b9ad2c2 #: 4162b0bbb82145f5863294fee9b84fcb msgid "string" msgstr "" #: ../../vars.rst:62 22fa0f6343d143a783918bf5d77c0101 msgid "MuPDF version as a tuple of integers, `(major, minor, patch)`." msgstr "" #: ../../vars.rst:64 ../../vars.rst:76 ../../vars.rst:86 #: 2f0bacf105574469a7a2f46854047382 ad5b78a4130443e0b9cb7a3e7209521d #: d8a2a6e3dcc44d9a96a1324281332fc4 msgid "tuple" msgstr "" #: ../../vars.rst:68 44158f3deff845c6a420df354f39c1ae #, fuzzy msgid "'x.xx.x' -- PyMuPDF version." msgstr "‘x.xxx’ – MuPDFのバージョン" #: ../../vars.rst:74 503076c6013f48dea2d5aff3c0bfffe3 msgid "PyMuPDF version as a tuple of integers, `(major, minor, patch)`." msgstr "" #: ../../vars.rst:80 ../../vars.rst:98 60b862b7a373462c8b0819e549788e84 #: c79955e7841e4b48a637775a61cfbd69 msgid "Disabled (set to None) in 1.26.1." msgstr "" #: ../../vars.rst:84 fff27c04ee62442897c643c5bfb60fd8 #, fuzzy msgid "" "(pymupdf_version, mupdf_version, timestamp) -- combined version " "information where `timestamp` is the generation point in time formatted " "as \"YYYYMMDDhhmmss\"." msgstr "" "(VersionBind、VersionFitz、タイムスタンプ) – " "タイムスタンプは「YYYYMMDDhhmmss」という形式で表される、生成時点の時間情報を結合したバージョン情報。" #: ../../vars.rst:90 4fbbccb8f9024a63a332534e6a7d0d2e msgid "Legacy equivalent to `mupdf_version`." msgstr "" #: ../../vars.rst:94 24f0ff9e8cf44c5fba17fe9c4bd63d7f msgid "Legacy equivalent to `pymupdf_version`." msgstr "" #: ../../vars.rst:104 4dce9933f18a45198a4633f8fefe9d07 msgid "Document Permissions" msgstr "ドキュメントの許可" #: ../../vars.rst:107 ../../vars.rst:125 ../../vars.rst:138 #: 69c0225036764f13b91eaa9dd3d4b5a1 8e2f223c79664413ba8ac6afd092c3fa #: a0a9b218a32347e18401eec3e71b51c6 msgid "Code" msgstr "コード" #: ../../vars.rst:107 c680e8bb0a64489fbe38ff0350dae277 msgid "Permitted Action" msgstr "許可されたアクション" #: ../../vars.rst:109 a79221d078824de999e2f0ccf27939da msgid "PDF_PERM_PRINT" msgstr "" #: ../../vars.rst:109 634b2c786f6946a99a89687ae863c63d msgid "Print the document" msgstr "文書を印刷する" #: ../../vars.rst:110 488e117f6ad841e4b5ebe9ca302ecd70 msgid "PDF_PERM_MODIFY" msgstr "" #: ../../vars.rst:110 a868ac82b5084146a37a1633ab518c6c msgid "Modify the document's contents" msgstr "文書の内容を変更する" #: ../../vars.rst:111 18ef7dd19b374b5ebfdb3cec757c73ac msgid "PDF_PERM_COPY" msgstr "" #: ../../vars.rst:111 8f52d72b641b40d285393c8d0bdf12b3 msgid "Copy or otherwise extract text and graphics" msgstr "テキストやグラフィックスをコピーしたりその他の抽出を行う" #: ../../vars.rst:112 9e025ab3d4f741e2a325152bc6f8a701 msgid "PDF_PERM_ANNOTATE" msgstr "" #: ../../vars.rst:112 cb0beab224b94270bdabfc3bd1ceacc6 msgid "Add or modify text annotations and interactive form fields" msgstr "テキスト注釈やインタラクティブなフォームフィールドを追加または変更する" #: ../../vars.rst:113 65f9a8539a38426e9d9edea861734d4d msgid "PDF_PERM_FORM" msgstr "" #: ../../vars.rst:113 9880c191956741d1ada6315e712e1df3 msgid "Fill in forms and sign the document" msgstr "フォームに記入し、文書に署名する" #: ../../vars.rst:114 419137e25c424c91876fed826c5a5bb0 msgid "PDF_PERM_ACCESSIBILITY" msgstr "" #: ../../vars.rst:114 c90f5be96ba842199ff198fe845a93a8 msgid "Obsolete, always permitted" msgstr "廃止されましたが、常に許可されています" #: ../../vars.rst:115 2ac0ea137a68490a808035fe357a1eb5 msgid "PDF_PERM_ASSEMBLE" msgstr "" #: ../../vars.rst:115 ee21ef3d77b543aa83b85d5966fa800c msgid "Insert, rotate, or delete pages, bookmarks, thumbnail images" msgstr "ページの挿入、回転、削除、ブックマーク、サムネイル画像の操作" #: ../../vars.rst:116 12f225fa0c204cecae58e07d185ee517 msgid "PDF_PERM_PRINT_HQ" msgstr "" #: ../../vars.rst:116 40cb4480233843f686a1bb405c551ad8 msgid "High quality printing" msgstr "高品質印刷" #: ../../vars.rst:122 c7730f8c05a4440dabe25baa7a267683 msgid "PDF Optional Content Codes" msgstr "PDFオプショナルコンテンツコード" #: ../../vars.rst:125 ../../vars.rst:138 063e2ffd14154f0ebe27a414e68d96c6 #: fe257d4a0ce0417dba5855c9020e0ca1 msgid "Meaning" msgstr "意味" #: ../../vars.rst:127 fe2012971224466ea97a0fb2a812c5d5 msgid "PDF_OC_ON" msgstr "" #: ../../vars.rst:127 420c6f19787341418e8a584a6befd890 msgid "Set an OCG to ON temporarily" msgstr "一時的にOCGをONに設定します" #: ../../vars.rst:128 2c29aec5886a45cfae0e991402caad13 msgid "PDF_OC_TOGGLE" msgstr "" #: ../../vars.rst:128 a7ebc40cd09c47a3867c2d73be2fdc36 msgid "Toggle OCG status temporarily" msgstr "OCGステータスを一時的に切り替えます" #: ../../vars.rst:129 4b06b1f6475a41cb8d448d28fbf5dd24 msgid "PDF_OC_OFF" msgstr "" #: ../../vars.rst:129 8a6a1199c65a44ba85224f9de436969f msgid "Set an OCG to OFF temporarily" msgstr "一時的にOCGをOFFに設定します" #: ../../vars.rst:135 2b7b50430a24457fafc7cd3943e62be7 msgid "PDF encryption method codes" msgstr "PDF暗号化方式コード" #: ../../vars.rst:140 a3c958105b9a4e8db59f50cb6ab72b3f msgid "PDF_ENCRYPT_KEEP" msgstr "" #: ../../vars.rst:140 30102a9f273a4422a20bf1aa06b451e6 msgid "do not change" msgstr "変更しない" #: ../../vars.rst:141 57fd2541dc9c472e9d50b26ef7cd6daf msgid "PDF_ENCRYPT_NONE" msgstr "" #: ../../vars.rst:141 49f9186cb5ae45cd9064cb575b6d5385 msgid "remove any encryption" msgstr "暗号化を解除する" #: ../../vars.rst:142 49fe127596b048f4a7ea339156fdf19d msgid "PDF_ENCRYPT_RC4_40" msgstr "" #: ../../vars.rst:142 5e3374e98bdc43a199f2fd85dcc18580 msgid "RC4 40 bit" msgstr "RC4 40ビット" #: ../../vars.rst:143 178727ee434846ad808cce5a8aaad74f msgid "PDF_ENCRYPT_RC4_128" msgstr "" #: ../../vars.rst:143 a3c8b50a7af8456a966bcd7de122f754 msgid "RC4 128 bit" msgstr "RC4 128ビット" #: ../../vars.rst:144 1ccff559acbb47a8a81bae717b32c4c8 msgid "PDF_ENCRYPT_AES_128" msgstr "" #: ../../vars.rst:144 d1fdccc17e4348788f55154c73a66ddd msgid "*Advanced Encryption Standard* 128 bit" msgstr "*Advanced Encryption Standard* 128ビット" #: ../../vars.rst:145 6052a9f31b7f4ec0b078312655adc0d5 msgid "PDF_ENCRYPT_AES_256" msgstr "" #: ../../vars.rst:145 14eb7ccec2184fbbb74c67eb54aeaa93 msgid "*Advanced Encryption Standard* 256 bit" msgstr "*Advanced Encryption Standard* 256ビット" #: ../../vars.rst:146 0e8a697210064a68a4acb78e4798c066 msgid "PDF_ENCRYPT_UNKNOWN" msgstr "" #: ../../vars.rst:146 c4ff9f33d8bf406baac59afdedce3393 msgid "unknown" msgstr "不明" #: ../../vars.rst:152 41ce5d42a96641298f59e62ca328c3ad msgid "Font File Extensions" msgstr "フォントファイルの拡張子" #: ../../vars.rst:153 a5aa4b1442b84096a3364986edc00478 msgid "" "The table show file extensions you should use when saving fontfile " "buffers extracted from a PDF. This string is returned by " ":meth:`Document.get_page_fonts`, :meth:`Page.get_fonts` and " ":meth:`Document.extract_font`." msgstr "" "このテーブルは、PDFから抽出されたフォントファイルバッファを保存する際に使用すべきファイル拡張子を示しています。この文字列は、:meth:`Document.get_page_fonts`、:meth:`Page.get_fonts`、および" " :meth:`Document.extract_font` によって返されます。" #: ../../vars.rst:156 0052347b09ef46dd84c581597bacb35f msgid "Ext" msgstr "拡張子" #: ../../vars.rst:156 2d2cd27d463f4ff0997dae7caa6b83b6 msgid "Description" msgstr "説明" #: ../../vars.rst:158 112b17f0de1840a08e0864ed1e9fad0c msgid "ttf" msgstr "" #: ../../vars.rst:158 0cb8088360d7427baefcf5281b49766b msgid "TrueType font" msgstr "TrueTypeフォント" #: ../../vars.rst:159 c2a6b6d61d0e40d583db103da173e32f msgid "pfa" msgstr "" #: ../../vars.rst:159 5a1d03107af64f5981ab318e0360c9af msgid "Postscript for ASCII font (various subtypes)" msgstr "ASCII用のPostscriptフォント（さまざまなサブタイプ）" #: ../../vars.rst:160 86be9bafc4174236b68e13a9dac7e5c8 msgid "cff" msgstr "" #: ../../vars.rst:160 8675d363e0c9499ab403a49e9cda22a1 msgid "Type1C font (compressed font equivalent to Type1)" msgstr "Type1Cフォント（Type1と同等の圧縮フォント）" #: ../../vars.rst:161 4c60a1421ea7458e81092448bae7a1d8 msgid "cid" msgstr "" #: ../../vars.rst:161 cf49f17f14d346f89b4ace2ba62a022f msgid "character identifier font (postscript format)" msgstr "文字識別子フォント（Postscript形式）" #: ../../vars.rst:162 fc39dc6369a74d13baa2932ca54039b7 msgid "otf" msgstr "" #: ../../vars.rst:162 e6d68a78565e4efdbdabf3ad08977b53 msgid "OpenType font" msgstr "OpenTypeフォント" #: ../../vars.rst:163 b7864b379d2a4c898a5538edf898a0a6 msgid "n/a" msgstr "" #: ../../vars.rst:163 d276c42e480048c98e84446e521418fb msgid "not extractable, e.g. :ref:`Base-14-Fonts`, Type 3 fonts and others" msgstr "抽出できない、 :ref:`PDFベース14フォント ` 、Type 3フォント、その他" #: ../../vars.rst:169 30a554d8b43e4399ac3db70eb4861a79 msgid "Text Alignment" msgstr "テキストの配置" #: ../../vars.rst:172 c285bb937c45411c9e8428e8cbc6d5ce msgid "0 -- align left." msgstr "0 – 左揃え。" #: ../../vars.rst:176 f6c2ead9ebb844e2a50572a57dbf9a86 msgid "1 -- align center." msgstr "1 – 中央揃え。" #: ../../vars.rst:180 8e82db4889224a20909e002199177be8 msgid "2 -- align right." msgstr "2 – 右揃え。" #: ../../vars.rst:184 75af6aadfef54289894f0d114de9eeae msgid "3 -- align justify." msgstr "3 – 両端揃え。" #: ../../vars.rst:191 cf47b8894ae04d868274979275d334ee msgid "Font Properties" msgstr "" #: ../../vars.rst:192 5c56a8ed6d794191b089c5b738da3cf9 msgid "" "Please note that the following bits are derived from what a font has to " "say about its properties. It may not be (and quite often is not) correct." msgstr "" #: ../../vars.rst:196 d8f06c39601c4b96bd13ea9e078c40ce msgid "" "1 -- the character or span is a superscript. This property is computed by" " MuPDF and not part of any font information." msgstr "" #: ../../vars.rst:200 d21771d5f06e4862a5dc0a350e8a4def msgid "2 -- the font is italic." msgstr "" #: ../../vars.rst:204 c25bebd41297409da31265769924b7c0 msgid "4 -- the font is serifed." msgstr "" #: ../../vars.rst:208 b4a15a033d644c66b6b71cd52bef75b0 msgid "8 -- the font is mono-spaced." msgstr "" #: ../../vars.rst:212 fd8f231700104de8a26b9fa17f57dca6 msgid "16 -- the font is bold." msgstr "" #: ../../vars.rst:215 ae7fc7375fe24bcab9635e7ecaf45788 msgid "Text Extraction Flags" msgstr "テキスト抽出フラグ" #: ../../vars.rst:216 b53381821bdc40c69b532bc7e53092be #, fuzzy msgid "" "Option bits controlling the amount of data, that are parsed into a " ":ref:`TextPage`." msgstr ":ref:`TextPage` に解析されるデータの量を制御するオプションビット - このクラスは、主にPyMuPDF内部でのみ使用されます。" #: ../../vars.rst:218 4e0693fb1e8f4c7e991b270de3d35b6c #, fuzzy msgid "" "For the PyMuPDF programmer, some combination (using Python's `|` " "operator, or simply use `+`) of these values are aggregated in the " "``flags`` integer, a parameter of all text search and text extraction " "methods. Depending on the individual method, different default " "combinations of the values are used. Please use a value that meets your " "situation. Especially make sure to switch off image extraction unless you" " really need them. The impact on performance and memory is significant!" msgstr "" "PyMuPDFプログラマーにとって、これらの値のいくつかの組み合わせ（Pythonの`|`演算子を使用するか、単純に`+`を使用する）が、すべてのテキスト検索およびテキスト抽出メソッドのパラメータである" " `flags` " "整数に集約されます。個々のメソッドによっては、異なる値のデフォルトの組み合わせが使用されます。ご自身の状況に合った値を使用してください。特に、必要がない限り画像抽出をオフにしてください。パフォーマンスとメモリに対する影響が大きいです！" #: ../../vars.rst:222 e2a36dbf69d04d888507fc509ee2b720 msgid "" "1 -- If set, ligatures are passed through to the application in their " "original form. Otherwise ligatures are expanded into their constituent " "parts, e.g. the ligature \"ffi\" is expanded into three eparate " "characters f, f and i. Default is \"on\" in PyMuPDF. MuPDF supports the " "following 7 ligatures: \"ff\", \"fi\", \"fl\", \"ffi\", \"ffl\", , " "\"ft\", \"st\"." msgstr "" "1 – " "設定されている場合、リガチャは元の形式のままアプリケーションに渡されます。それ以外の場合、リガチャは構成要素に展開されます。例：リガチャ「ffi」は、3つの個別の文字" " f、f、および i " "に展開されます。デフォルトはPyMuPDFで「オン」です。MuPDFは以下の7つのリガチャに対応しています：\"ff\"、\"fi\"、\"fl\"、\"ffi\"、\"ffl\"、\"ft\"、\"st\"。" #: ../../vars.rst:226 03ceff6db720488f91e124b08d5a1e41 msgid "" "2 -- If set, whitespace is passed through. Otherwise any type of " "horizontal whitespace (including horizontal tabs) will be replaced with " "space characters of variable width. Default is \"on\" in PyMuPDF." msgstr "" "2 – " "設定されている場合、空白はそのまま渡されます。それ以外の場合、水平空白（水平タブを含む）のいずれかのタイプは可変幅のスペース文字に置き換えられます。デフォルトはPyMuPDFで「オン」です。" #: ../../vars.rst:230 cf99390225b04a8996e5580bd96fe830 msgid "" "4 -- If set, then images will be stored in the :ref:`TextPage`. This " "causes the presence of (usually large!) binary image content in the " "output of text extractions of types \"blocks\", \"dict\", \"json\", " "\"rawdict\", \"rawjson\", \"html\", and \"xhtml\" and is the default " "there. If used with \"blocks\" however, only image metadata will be " "returned, not the image itself." msgstr "" "4 – 設定されている場合、画像は :ref:`TextPage` " "に保存されます。これにより、テキスト抽出の出力に（通常は大きな）バイナリ画像コンテンツが含まれることになります。ただし、これはタイプ「blocks」、「dict」、「json」、「rawdict」、「rawjson」、「html」、および「xhtml」のテキスト抽出にのみ適用され、デフォルトです。ただし、「blocks」とともに使用される場合、画像メタデータのみが返され、画像自体は返されません。" #: ../../vars.rst:234 2681e56367fe46aa936b2b5870294639 msgid "" "8 -- If set, Mupdf will not try to add missing space characters where " "there are large gaps between characters. In PDF, the creator often does " "not insert spaces to point to the next character's position, but will " "provide the direct location address. The default in PyMuPDF is \"off\" --" " so spaces **will be generated**." msgstr "" "8 – " "設定されている場合、Mupdfは文字間の大きな間隔に欠落したスペース文字を追加しようとしません。PDFでは、作成者はしばしば次の文字の位置を指し示すためにスペースを挿入しませんが、直接の場所のアドレスを提供します。PyMuPDFのデフォルトは「オフ」です" " - したがって、スペースが生成されます。" #: ../../vars.rst:238 cb25cbf3acb74d84824fa410aed54abd msgid "" "16 -- Ignore hyphens at line ends and join with next line. Used " "internally with the text search functions. However, it is generally " "available: if on, text extractions will return joined text lines (or " "spans) with the ending hyphen of the first line eliminated. So two " "separate spans **\"first meth-\"** and **\"od leads to wrong results\"** " "on different lines will be joined to one span **\"first method leads to " "wrong results\"** and correspondingly updated bboxes: the characters of " "the resulting span will no longer have identical y-coordinates." msgstr "" "16 – " "行末のハイフンを無視し、次の行に結合します。テキスト検索関数と内部で使用されます。ただし、一般的に使用できます。ONの場合、テキスト抽出は結合されたテキスト行（またはスパン）を返します。最初の行のハイフンが除去されます。異なる行にある「first" " meth-」と「od leads to wrong results」の2つの個別のスパンが「first method leads to " "wrong " "results」として結合され、それに応じて更新されたバウンディングボックス（bbox）：結果のスパンの文字はもはや同じy座標を持ちません。" #: ../../vars.rst:242 19c2601d343547ba88a56aac0f0c8ff5 msgid "" "32 -- Generate a new line for every span. Not used (\"off\") in PyMuPDF, " "but available for your use. Every line in \"dict\", \"json\", " "\"rawdict\", \"rawjson\" will contain exactly one span." msgstr "" "32 – " "各スパンに対して新しい行を生成します。PyMuPDFでは使用されませんが（オフです）、使用可能です。\"dict\"、\"json\"、\"rawdict\"、\"rawjson\"の各行には正確に1つのスパンが含まれます。" #: ../../vars.rst:246 87e941b789f8436e998a2f3801575756 #, fuzzy msgid "" "64 -- Characters entirely outside a page's **mediabox** or contained in " "other \"clipped\" areas will be ignored. This is default in PyMuPDF." msgstr "64 – ページのメディアボックス外にある文字は無視されます。これはPyMuPDFのデフォルトです。" #: ../../vars.rst:250 befbc341b1674e348a9396c99be1ac8a msgid "" "128 -- Use raw character codes instead of U+FFFD. This is the default for" " **text extraction** in PyMuPDF. If you **want to detect** when encoding " "information is missing or uncertain, toggle this flag and scan for the " "presence of U+FFFD (= `chr(0xfffd)`) code points in the resulting text." msgstr "" #: ../../vars.rst:254 328eded5e21c495986514848f3acd090 msgid "256 -- Not supported." msgstr "" #: ../../vars.rst:258 c2468f6ee1364a9aacd5178c2e2e1f03 msgid "" "512 -- Ignore metric values of all fonts when computing character " "boundary boxes -- most prominently the `ascender " "`_ and `descender " "`_ values. Instead, follow the " "drawing commands of each character's glyph and compute its rectangle " "hull. This is the smallest rectangle wrapping all points used for drawing" " the visual appearance - see the :ref:`Shape` class for understanding the" " background. This will especially result in individual character heights." " For instance a (white) space will have a **bbox of height 0** (because " "nothing is drawn) -- in contrast to the non-zero boundary box generated " "when using font metrics. This option may be useful to cope with getting " "meaningful boundary boxes even for fonts containing errors. Its use will " "slow down text extraction somewhat because of the incurred computational " "effort." msgstr "" #: ../../vars.rst:260 0d005cfd39294c549dcb076c7db6a438 msgid "" "Note that this has no effect by default - one must also disable the " "global quad corrections setting with " "`pymupdf.TOOLS.unset_quad_corrections(True)`." msgstr "" #: ../../vars.rst:265 26addbea02e84233b6230ff416c3f839 msgid "1024 -- Not supported." msgstr "" #: ../../vars.rst:269 71ca80b7b9a0453f96fbe2509cc882f8 msgid "" "2048 -- Ignore built-in differences between text appearing in e.g. PDF " "viewers versus text stored in the PDF. See :ref:`AdobeManual`, page 615 " "for background. If set, the **stored** (\"replacement\" text) is ignored " "in favor of the displayed text." msgstr "" #: ../../vars.rst:273 a2280aa3922d45a0b01eec12d3b1828e msgid "4096 -- Attempt to segment page into different regions." msgstr "" #: ../../vars.rst:275 6055e0ec2f2640a4a69c769d60051dd1 msgid "" "The following constants represent the default combinations of the above " "for text extraction and searching:" msgstr "以下の定数は、テキスト抽出と検索のための上記のデフォルトの組み合わせを表します：" #: ../../vars.rst:279 ../../vars.rst:283 ../../vars.rst:287 ../../vars.rst:307 #: 18445061c2274e3094f8e223b2f97d8b 4848e850ecdd4b71ae9e0fe4bd1bd2ab #: 7e1253a470a94b4bad14d5086ec64c03 b78142b94eed4f5ca84f11c2fef8b074 msgid "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" msgstr "" #: ../../vars.rst:291 ../../vars.rst:295 ../../vars.rst:299 ../../vars.rst:303 #: 1cef0274d54745cead1031d1bca2799f 2fbf2a5e26ee49eb868428bcbb529499 #: 9fdd1b123b4e4f2fa9c013d23a2b966c ffe8940542984cda9c70ce1c925581dc msgid "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" msgstr "" #: ../../vars.rst:311 bb90ee72173049c7a370c67ba9105b23 msgid "`TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE`" msgstr "" #: ../../vars.rst:317 f588bfe5d7214e09848d2ea66fc226e0 msgid "Link Destination Kinds" msgstr "リンクの目的の種類" #: ../../vars.rst:318 25e6f87b871146ab8c9d29979584f4b3 msgid "Possible values of :attr:`linkDest.kind` (link destination kind)." msgstr ":attr:`linkDest.kind` （リンクの目的の種類）の可能な値。" #: ../../vars.rst:322 93386ed82cc246f889866c47a3647e09 msgid "0 -- No destination. Indicates a dummy link." msgstr "0 – 目的地なし。ダミーリンクを示します。" #: ../../vars.rst:328 55d8c4d1bc6e4ff7896e13f3fcbbfa74 msgid "1 -- Points to a place in this document." msgstr "1 – このドキュメント内の場所を指します。" #: ../../vars.rst:334 17fd7d0b788140929657b02c096290f0 msgid "" "2 -- Points to a URI -- typically a resource specified with internet " "syntax." msgstr "2 – URIを指します。通常はインターネット構文で指定されたリソースです。" #: ../../vars.rst:336 c2c977e93a6b466686c3ec774112b806 msgid "" "PyMuPDF treats any external link that contains a colon and does not start" " with `file:`, as `LINK_URI`." msgstr "PyMuPDFは、コロンを含み、`file:` で始まらない任意の外部リンクを `LINK_URI` として扱います。" #: ../../vars.rst:343 f2f74244f1ff419e9d052ead3e767a51 msgid "3 -- Launch (open) another file (of any \"executable\" type)." msgstr "3 – 別のファイル（任意の「実行可能」タイプ）を開きます。" #: ../../vars.rst:345 80fd06d08b3a4bbd91c5550c158e44a4 msgid "" "|PyMuPDF| treats any external link that starts with `file:` or doesn't " "contain a colon, as `LINK_LAUNCH`." msgstr "PyMuPDFは、 `file:` で始まるかコロンを含まない外部リンクを `LINK_LAUNCH` として扱います。" #: ../../vars.rst:352 953c280a5a2c4081b49b4428360d0b70 msgid "4 -- points to a named location." msgstr "4 – 名前付きの場所を指します。" #: ../../vars.rst:358 c2dd6d723df94a729c602ab39198e6e3 msgid "5 -- Points to a place in another PDF document." msgstr "5 – 別のPDFドキュメント内の場所を指します。" #: ../../vars.rst:365 13d9db49dc764ad2943a0bd89bf1eccd msgid "Link Destination Flags" msgstr "リンクの目的地フラグ" #: ../../vars.rst:367 d3b19de8c19a4cca93ae0614069136aa msgid "" "The rightmost byte of this integer is a bit field, so test the truth of " "these bits with the *&* operator." msgstr "この整数の最も右側のバイトはビットフィールドです。したがって、これらのビットの真偽を *＆* 演算子でテストします。" #: ../../vars.rst:371 adfb385a3f204afa96eae840376cfaaf msgid "1 (bit 0) Top left x value is valid" msgstr "1 (ビット 0) 左上の x 値が有効です" #: ../../vars.rst:373 ../../vars.rst:379 ../../vars.rst:385 ../../vars.rst:391 #: ../../vars.rst:397 ../../vars.rst:403 ../../vars.rst:409 #: 45d5d66079ad4119a37daf32345170ea 68ec9fd7a3194726abc3dd123922506c #: 802dc57d84e340dda07eb08e1fa533ea a78880c24f194e0183ba7acb53112b5c #: b54e07447ebd48d08adcaa6c2330efd7 cc044f3983144e34b9ec5e221c661f84 #: de33e1ca908e4329acf8e771d8062395 msgid "bool" msgstr "" #: ../../vars.rst:377 f6bb945288e84c2ea7af6535127f5686 msgid "2 (bit 1) Top left y value is valid" msgstr "2 (ビット 1) 左上の y 値が有効です" #: ../../vars.rst:383 1429f391f08e4098bf3648e649655ce7 msgid "4 (bit 2) Bottom right x value is valid" msgstr "4 (ビット 2) 右下の x 値が有効です" #: ../../vars.rst:389 dd2f2b2b41774030b5c2a8b95d745273 msgid "8 (bit 3) Bottom right y value is valid" msgstr "8 (ビット 3) 右下の y 値が有効です" #: ../../vars.rst:395 62df816d97ee45ccab57344fe8d25a10 msgid "16 (bit 4) Horizontal fit" msgstr "16 (ビット 4) 水平フィット" #: ../../vars.rst:401 78e6492677c146c4a8d9bf5ea9d48be1 msgid "32 (bit 5) Vertical fit" msgstr "32 (ビット 5) 垂直フィット" #: ../../vars.rst:407 40d05c050d174b918e1b5d3b4e8d4671 msgid "64 (bit 6) Bottom right x is a zoom figure" msgstr "64 (ビット 6) 右下の x はズーム値です" #: ../../vars.rst:413 136d76a8f9eb46c88e7d3a181650da73 msgid "Annotation Related Constants" msgstr "注釈関連の定数" #: ../../vars.rst:414 0afb6c758143449fb56a0b04ab704888 msgid "See chapter 8.4.5, pp. 615 of the :ref:`AdobeManual` for details." msgstr "詳細については、:ref:`Adobe PDFリファレンス ` の第8.4.5章、615ページをご覧ください。" #: ../../vars.rst:419 c080cb77d13c409a8faecbcbd760910c msgid "Annotation Types" msgstr "アノテーションタイプ" #: ../../vars.rst:420 d20a798f8f554b5d8529e31b8816197f msgid "" "These identifiers also cover **links** and **widgets**: the PDF " "specification technically handles them all in the same way, whereas " "|MuPDF| (and PyMuPDF) treats them as three basically different types of " "objects." msgstr "" "これらの識別子は **リンク** と **ウィジェット** " "も含みます。PDF仕様では、技術的にはこれらをすべて同じ方法で処理しますが、|MuPDF| " "（およびPyMuPDF）では、基本的には異なる3つのオブジェクトタイプとして扱われます。" #: ../../vars.rst:457 713c32c363bd480cba99fcadd3fa3555 msgid "Annotation Flag Bits" msgstr "注釈フラグビット" #: ../../vars.rst:474 9fdaae6162c54afea314aa849239b470 msgid "Annotation Line Ending Styles" msgstr "注釈の線の終端スタイル" #: ../../vars.rst:490 3e407ea8c72444ebba3331d472a6a25a msgid "Widget Constants" msgstr "ウィジェットの定数" #: ../../vars.rst:495 96ec99e51a7e4985a737ba02c17541ac msgid "Widget Types (*field_type*)" msgstr "ウィジェットのタイプ（*field_type*）" #: ../../vars.rst:508 755546e537074e1aaa1b792a365b879a msgid "Text Widget Subtypes (*text_format*)" msgstr "テキストウィジェットのサブタイプ（*text_format*）" #: ../../vars.rst:519 2d435f5842544cc5ad764fc27d6e30db msgid "Widget flags (*field_flags*)" msgstr "ウィジェットフラグ（*field_flags*）" #: ../../vars.rst:520 1be2e082d5f24d78b93633d42c3ab6b3 msgid "**Common to all field types**::" msgstr "**すべてのフィールドタイプに共通**：" #: ../../vars.rst:526 9a70d77fe1724d00a6baf6703369f739 msgid "**Text widgets**::" msgstr "**テキストウィジェット**：" #: ../../vars.rst:536 a70d3da20a7a4996843ce3b94a65f844 msgid "**Button widgets**::" msgstr "**ボタンウィジェット**：" #: ../../vars.rst:543 33f39c42d34a4fa49140b193aec55d00 msgid "**Choice widgets**::" msgstr "**チョイスウィジェット**：" #: ../../vars.rst:556 05602853929445cfb71dfca4dc7fb284 msgid "PDF Standard Blend Modes" msgstr "PDF標準ブレンドモード" #: ../../vars.rst:558 d1da99abe9c4449e9af156616a68a1c3 msgid "For an explanation see :ref:`AdobeManual`, page 324::" msgstr "詳細については、Adobe PDFリファレンスのページ324をご覧ください：" #: ../../vars.rst:581 72834b1fb7fb47c6982ed3593f7600d3 msgid "Stamp Annotation Icons" msgstr "スタンプ注釈アイコン" #: ../../vars.rst:582 71aa56b7b0644cef8475af050d9bccf3 msgid "MuPDF has defined the following icons for **rubber stamp** annotations::" msgstr "MuPDFは、ラバースタンプ注釈に次のアイコンを定義しています：" #: ../../footer.rst:46 7b627849860f4ae7a235d36a44c7c566 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE " #~ "| TEXT_MEDIABOX_CLIP`" #~ msgstr "" #~ msgid "" #~ "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE " #~ "| TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES`" #~ msgstr "" #~ msgid "Return type" #~ msgstr "戻り値の型" #~ msgid "'x.xx.x' -- version of PyMuPDF (these bindings)" #~ msgstr "‘x.xx.x’ – PyMuPDF（これらのバインディング）のバージョン" #~ msgid "" #~ "The docstring of *fitz* contains " #~ "information of the above which can " #~ "be retrieved like so: *print(fitz.__doc__)*," #~ " and should look like: *PyMuPDF " #~ "1.10.0: Python bindings for the MuPDF" #~ " 1.10 library, built on 2016-11-30 " #~ "13:09:13*." #~ msgstr "" #~ "fitzのドキュストリングには、上記の情報が含まれており、次のようにして取得できます： " #~ "print(fitz.__doc__)。以下のように表示されるべきです：PyMuPDF 1.10.0：MuPDF " #~ "1.10ライブラリ用のPythonバインディング、ビルド日時2016-11-30 13:09:13。" #~ msgid "" #~ "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE " #~ "| TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE`" #~ msgstr "" #~ msgid "" #~ "128 -- If set, use raw character" #~ " codes instead of U+FFFD. This is " #~ "the default for **text extraction** in" #~ " PyMuPDF. If you **want to detect**" #~ " when encoding information is missing " #~ "or uncertain, toggle this flag and " #~ "scan for the presence of U+FFFD (=" #~ " `chr(0xfffd)`) code points in the " #~ "resulting text." #~ msgstr "" #~ "128 -- 設定されている場合、U+FFFDの代わりに生の文字コードを使用します。これは、PyMuPDFにおける" #~ " **テキスト抽出** " #~ "のデフォルトです。エンコーディング情報が不足しているか不確かな場合に**検出したい**場合は、このフラグを切り替えて、結果のテキストにU+FFFD" #~ " (= `chr(0xfffd)`)コードポイントが存在するかどうかをスキャンします。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "ISO timestamp *YYYY-MM-DD HH:MM:SS* when these bindings were built." #~ msgstr "これらのバインディングがビルドされたISOタイムスタンプ YYYY-MM-DD HH:MM:SS。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/version.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../version.rst:1 d1fbe6ff1d5549fb8be875f6d37c584b msgid "This documentation covers PyMuPDF |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #: ../../version.rst:3 133bf913bb004c8ca82964184ed7628c msgid "" "The major and minor versions of PyMuPDF and MuPDF will always be the same. Only the third qualifier (patch level) may deviate from that of MuPDF." msgstr "PyMuPDF と MuPDF のメジャーおよびマイナーバージョンは常に同じになります。第三の修飾子（パッチレベル）のみが MuPDF のものと異なる場合があります。" #: ../../version.rst:5 994720d99f72419ebd711b2cf71dcefb msgid "" "Typically PyMuPDF is released more frequently than MuPDF so it will often" " be the case that the patch level of PyMuPDF will be greater than the " "embedded MuPDF." msgstr "通常、PyMuPDFはMuPDFよりも頻繁にリリースされるため、PyMuPDFのパッチレベルが組み込まれたMuPDFのパッチレベルよりも大きくなることがよくあります。" #: ../../version.rst:9 371aa251e8314b9aad7c870f54636f80 msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2." msgstr "例えば、PyMuPDF-1.24.5にはMuPDF-1.24.2が含まれています。" #: ../../version.rst:11 7c7d7d87d7e14441959c236fee7d2ee5 msgid "Also see `pymupdf_version` and `mupdf_version`." msgstr "pymupdf_versionとmupdf_versionも参照してください。" #~ msgid "" #~ "This documentation covers **PyMuPDF " #~ "v1.23.0rc1** features as of **2023-08-10 " #~ "00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.4**" #~ " features as of **2023-09-26 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.5**" #~ " features as of **2023-10-11 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.23.8**" #~ " features as of **2023-12-19 00:00:01**." #~ msgstr "" #~ msgid "" #~ "This documentation covers **PyMuPDF v1.25.5**" #~ " features as of **2025-03-31 00:00:01**." #~ msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/widget.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9be7fe8ece684722b20723502ba6e81a msgid "Artifex" msgstr "" #: ../../header.rst:-1 4fd0b4c61f30429d928c92ebb1081bc3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 8395c05a667445b68d678e31a6c9296f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../widget.rst:7 b5bf7834aa6d4acc80837502b85e97c1 msgid "Widget" msgstr "Widget (ウィジェット)" #: ../../widget.rst:9 db658752009445c5a3459712f6b25c8f msgid "|pdf_only_class|" msgstr "PDFのみ。" #: ../../widget.rst:11 d1312e8bf60148598975d49439011b6c msgid "" "This class represents a PDF Form field, also called a \"widget\". " "Throughout this documentation, we are using these terms synonymously. " "Fields technically are a special case of PDF annotations, which allow " "users with limited permissions to enter information in a PDF. This is " "primarily used for filling out forms." msgstr "このクラスは、PDFフォームフィールド、または「ウィジェット」とも呼ばれるものを表します。このドキュメンテーション全体で、これらの用語を同義語として使用しています。フィールドは技術的にはPDF注釈の特殊なケースであり、制限付きの権限を持つユーザーがPDFに情報を入力することを可能にします。これは主にフォームの記入に使用されます。" #: ../../widget.rst:13 6befe4905ed146a2ab8cfd92d1d923bc msgid "" "Like annotations, widgets live on PDF pages. Similar to annotations, the " "first widget on a page is accessible via :attr:`Page.first_widget` and " "subsequent widgets can be accessed via the :attr:`Widget.next` property." msgstr "" "アノテーションと同様に、ウィジェットもPDFページ上に存在します。注釈と同様に、ページ上の最初のウィジェットは " ":attr:`Page.first_widget` 経由でアクセスでき、その後のウィジェットは :attr:`Widget.next` " "プロパティ経由でアクセスできます。" #: ../../widget.rst:15 f5dcbec91e9446b1bc886ab894d9b27c msgid "" "Like annotations, widgets also lose connection to their page when the " "page becomes unavailable, please see `here " "`_ for details. This is relevant " "especially when updating the widget: this will fail if the original page " "object is no longer available." msgstr "" #: ../../widget.rst:17 23ea64f7e0164b6788a0c02783469bef msgid "" "*(Changed in version 1.16.0)* MuPDF no longer treats widgets as a subset " "of general annotations. Consequently, :attr:`Page.first_annot` and " ":meth:`Annot.next` will deliver **non-widget annotations exclusively**, " "and be ``None`` if only form fields exist on a page. Vice versa, " ":attr:`Page.first_widget` and :meth:`Widget.next` will only show widgets." " This design decision is purely internal to MuPDF; technically, links, " "annotations and fields have a lot in common and also continue to share " "the better part of their code within (Py-) MuPDF." msgstr "" "*（バージョン1.16.0で変更）* " "MuPDFはウィジェットを一般的な注釈のサブセットとして扱わなくなりました。したがって、:attr:`Page.first_annot` および " ":meth:`Annot.next` " "は非ウィジェット注釈のみを返し、ページにフォームフィールドのみが存在する場合はNoneを返します。逆に、:attr:`Page.first_widget`" " および :meth:`Widget.next` " "はウィジェットのみを表示します。この設計の決定はMuPDF内部におけるものであり、技術的にはリンク、注釈、およびフィールドは多くの共通点を持ち、また（Py-）MuPDF内でコードの大部分を共有し続けています。" #: ../../widget.rst:20 4c382afc381347e990494e4d0e1c78f7 msgid "**Class API**" msgstr "クラスAPI" #: ../../widget.rst:26 f56bf175166444f7920a252639d09199 msgid "*New in version 1.18.15*" msgstr "*バージョン1.18.15で新しく追加*" #: ../../widget.rst:28 00cee4b5b9734e0484ff17718afb7614 msgid "" "Return the names of On / Off (i.e. selected / clicked or not) states a " "button field may have. While the 'Off' state usually is also named like " "so, the 'On' state is often given a name relating to the functional " "context, for example 'Yes', 'Female', etc." msgstr "" "ボタンフィールドが持つOn / Off（選択/クリックしたかどうか）状態の名前を返します。通常、 'Off'状態も同様に名前が付けられていますが、" " 'On'状態は機能的なコンテキストに関連する名前がよく付けられます。たとえば、「Yes」、「Female」などです。" #: ../../widget.rst:30 7d6a3ae94e2742d5a84bf396789e24e1 msgid "" "This method helps finding out the possible values of :attr:`field_value` " "in these cases." msgstr "このメソッドは、これらのケースで :attr:`field_value` の可能な値を調べるのに役立ちます。" #: ../../widget.rst 3ba59739b0504accbfb45a04c8b24a7f #: ac61f1c8af7547ca9e4696981cd7c001 msgid "returns" msgstr "戻り値：" #: ../../widget.rst:32 dc0ef726c74e4a249337ee6f20cdd308 msgid "" "a dictionary with the names of 'On' and 'Off' for the *normal* and the " "*pressed-down* appearance of button widgets. The following example shows " "that the \"selected\" value is \"Male\":" msgstr "" "*normal* の 状態と *pressed-down* 状態のボタンウィジェットの 'On'と " "'Off'の名前を持つ辞書。次の例では、「選択された」値は「Male」であることが示されています：" #: ../../widget.rst:40 dca66819e96f4f19a12d511c1409a188 msgid "New in version 1.22.2" msgstr "新機能（バージョン1.22.2で追加）" #: ../../widget.rst:42 72cfa1c4a4794fdebcf176d87534ed11 msgid "" "Return the value of the \"ON\" state of check boxes and radio buttons. " "For check boxes this is always the value \"Yes\". For radio buttons, this" " is the value to select / activate the button." msgstr "チェックボックスとラジオボタンの「ON」状態の値を返します。チェックボックスの場合、これは常に「Yes」という値です。ラジオボタンの場合、これはボタンを選択/アクティブ化する値です。" #: ../../widget.rst:44 ef6612006aa6463b9f062200357220e8 msgid "" "the value that sets the button to \"selected\". For non-checkbox, non-" "radiobutton fields, always `None` is returned. For check boxes the return" " is `True`. For radio buttons this is the value \"Male\" in the following" " example:" msgstr "" "ボタンを「選択」に設定する値が返されます。非チェックボックス、非ラジオボタンフィールドの場合、常に `None` " "が返されます。チェックボックスの場合、戻り値は `True` です。ラジオボタンの場合、次の例では値が「Male」です。" #: ../../widget.rst:51 149007e65bf84de18e2eb1c2afe8bf71 msgid "" "So for check boxes and radio buttons, the recommended method to set them " "to \"selected\", or to check the state is the following:" msgstr "したがって、チェックボックスとラジオボタンの場合、それらを「選択」または状態を確認するための推奨される方法は次のとおりです。" #: ../../widget.rst:60 9b42ee70ae144a8b92f71cf466956b05 #, fuzzy msgid "" "After any changes to a widget, this **method must be used** to reflect " "changes in the PDF [#f1]_." msgstr "ウィジェットに変更が加えられた後、これらの変更をPDFに保存するためにこのメソッドを **使用する必要があります** [#f1]_。" #: ../../widget.rst f9afde507f67494fbafed9da093edc2c msgid "Parameters" msgstr "" #: ../../widget.rst:62 4a0049c3506c40d99e4aba3b7c10c027 msgid "" "if ``True``, the widget's :attr:`Widget.field_flags` are copied to the " "``Parent`` object (if present) and all widgets named in its ``Kids`` " "array. This provides a convenient way to -- for example -- set all " "instances of the widget to read-only, no matter on which page they may " "occur [#f2]_." msgstr "" #: ../../widget.rst:66 ad4e8312e49447b68aa62039c7138968 msgid "" "Reset the field's value to its default -- if defined -- or remove it. Do " "not forget to issue :meth:`update` afterwards." msgstr "" "フィールドの値をデフォルト値にリセットします。デフォルトが定義されている場合、それを削除します。その後、:meth:`update` " "を実行するのを忘れないでください。" #: ../../widget.rst:70 ac472167a7e14f4290ac8a193c79160c msgid "" "Point to the next form field on the page. The last widget returns " "``None``." msgstr "ページ上の次のフォームフィールドを指します。最後のウィジェットは ``None`` を返します。" #: ../../widget.rst:74 1f2d580b4eca4c468f4a0e6592281c85 msgid "" "A list of up to 4 floats defining the field's border color. Default value" " is ``None`` which causes border style and border width to be ignored." msgstr "" "フィールドの境界線の色を定義する最大4つの浮動小数点数のリストです。デフォルト値は ``None`` " "で、これにより境界線スタイルと境界線の幅が無視されます。" #: ../../widget.rst:78 4d75daab990241b7a3b26a0e4ab3a3f3 msgid "" "A string defining the line style of the field's border. See " ":attr:`Annot.border`. Default is \"s\" (\"Solid\") -- a continuous line. " "Only the first character (upper or lower case) will be regarded when " "creating a widget." msgstr "" "フィールドの境界線の線スタイルを定義する文字列です。:attr:`Annot.border` を参照してください。デフォルトは \"s\" " "(\"Solid\") で、連続線です。ウィジェットを作成する際、最初の文字（大文字または小文字）のみが考慮されます。" #: ../../widget.rst:82 a3b4c3bbfb544efd99ac42ab92c5d596 msgid "A float defining the width of the border line. Default is 1." msgstr "境界線の幅を定義する浮動小数点数です。デフォルトは1です。" #: ../../widget.rst:86 8abf38d7b6a540acb99b929363d614c3 msgid "" "A list/tuple of integers defining the dash properties of the border line." " This is only meaningful if *border_style == \"D\"* and " ":attr:`border_color` is provided." msgstr "" "*border_style == \"D\"* であり、:attr:`border_color` " "が指定されている場合にのみ意味があります。これは、境界線のダッシュプロパティを定義する整数のリスト/タプルです。" #: ../../widget.rst:90 89fa9c260a8c49f0b07ea1b251cece4e msgid "" "Python sequence of strings defining the valid choices of list boxes and " "combo boxes. For these widget types, this property is mandatory and must " "contain at least two items. Ignored for other types." msgstr "リストボックスとコンボボックスの有効な選択肢を定義するPythonシーケンスの文字列です。これらのウィジェットタイプでは、このプロパティが必須で、少なくとも2つのアイテムを含める必要があります。他のタイプでは無視されます。" #: ../../widget.rst:94 d429d2ef1dd644d79f98b280f55ad276 msgid "" "A mandatory string defining the field's name. No checking for duplicates " "takes place." msgstr "フィールドの名前を定義する必須の文字列です。重複をチェックしません。" #: ../../widget.rst:98 3e1f3a12889b40cdb2687c5e1e275082 msgid "" "An optional string containing an \"alternate\" field name. Typically used" " for any notes, help on field usage, etc. Default is the field name." msgstr "「代替」フィールド名を含むオプションの文字列です。通常、フィールドの使用方法に関するメモ、ヘルプなどに使用されます。デフォルトはフィールド名です。" #: ../../widget.rst:102 02bb3f5a570947e98e225720d915a4b5 msgid "The value of the field." msgstr "フィールドの値です。" #: ../../widget.rst:106 159866e898664171a44d8b61241d2731 msgid "" "An integer defining a large amount of properties of a field. Be careful " "when changing this attribute as this may change the field type." msgstr "フィールドの多くのプロパティを定義する整数です。この属性を変更する際は注意してください。これはフィールドのタイプを変更する可能性があります。" #: ../../widget.rst:110 62966a5f68404db5822a72647d202b90 msgid "" "A mandatory integer defining the field type. This is a value in the range" " of 0 to 6. It cannot be changed when updating the widget." msgstr "フィールドタイプを定義する必須の整数です。これは0から6の範囲の値です。ウィジェットを更新する際に変更できません。" #: ../../widget.rst:114 a9fbed37d8be4f51b900e87522083cb4 msgid "A string describing (and derived from) the field type." msgstr "フィールドタイプを説明する文字列（フィールドタイプから派生）。" #: ../../widget.rst:118 0893214230bb4b998907cfb864bf8047 msgid "A list of up to 4 floats defining the field's background color." msgstr "フィールドの背景色を定義する、最大4つの浮動小数点数のリスト。" #: ../../widget.rst:122 864cf589b08549bca7920c38f91caa48 msgid "The caption string of a button-type field." msgstr "ボタンタイプのフィールドのキャプション文字列。" #: ../../widget.rst:126 d1ed58b8e9784d0f9f5368aa781d8db2 msgid "A bool indicating the signing status of a signature field, else ``None``." msgstr "署名フィールドの署名ステータスを示すブール値。それ以外の場合は ``None``。" #: ../../widget.rst:130 fd9f9f5619ec4ae69d780dcfdcaf1cf5 msgid "The rectangle containing the field." msgstr "フィールドを含む矩形。" #: ../../widget.rst:134 32a4055906494c169f91575f408fd75e msgid "" "A list of **1, 3 or 4 floats** defining the text color. Default value is " "black (`[0, 0, 0]`)." msgstr "テキストの色を定義する、**1、3、または4つの浮動小数点数** のリスト。デフォルト値は黒 (`[0, 0, 0]`)です。" #: ../../widget.rst:138 f951f27a175047e6ad58a7ee9d45d202 msgid "" "A string defining the font to be used. Default and replacement for " "invalid values is *\"Helv\"*. For valid font reference names see the " "table below." msgstr "" "使用するフォントを定義する文字列。デフォルトおよび無効な値の置換は *「Helv」* " "です。有効なフォント参照名については以下の表を参照してください。" #: ../../widget.rst:142 93d6bab5e8ed4964b445aaff3f5a666e msgid "" "A float defining the text :data:`fontsize`. Default value is zero, which " "causes PDF viewer software to dynamically choose a size suitable for the " "annotation's rectangle and text amount." msgstr "" "テキストの :data:`fontsize` " "を定義する浮動小数点数。デフォルト値はゼロで、PDFビューアソフトウェアが注釈の矩形とテキストの量に適したサイズを動的に選択します。" #: ../../widget.rst:146 a1ded660efa640cd9b872d5a1fffdb1f msgid "" "An integer defining the maximum number of text characters. PDF viewers " "will (should) not accept a longer text." msgstr "テキストの最大文字数を定義する整数。PDFビューアは（するはずです）より長いテキストを受け入れません。" #: ../../widget.rst:150 68eac259cd954e619832866bde7c37e3 msgid "" "An integer defining acceptable text types (e.g. numeric, date, time, " "etc.). For reference only for the time being -- will be ignored when " "creating or updating widgets." msgstr "許容可能なテキストタイプを定義する整数（例：数値、日付、時刻など）。現時点では参考用のみで、ウィジェットを作成または更新する際には無視されます。" #: ../../widget.rst:154 9df210c84ecd4845b952f6d3cc9195cc msgid "The PDF :data:`xref` of the widget." msgstr "ウィジェットのPDF :data:`xref`。" #: ../../widget.rst:158 ../../widget.rst:164 ../../widget.rst:170 #: ../../widget.rst:176 ../../widget.rst:182 6ac3abf289404eeaafe2d71129cccf4f #: 8034826ba5bf458fa878c3dfe0dcb46e 8155dfc13cad413eb75cd134942ce80a #: b8eb6a539c4941e6b3212dc4474dfd75 c5b33ed64c7043db966de5404c881830 msgid "New in version 1.16.12" msgstr "バージョン1.16.12で新登場" #: ../../widget.rst:160 27f8421d8a374cd587fc385b05348e06 msgid "" "JavaScript text (unicode) for an action associated with the widget, or " "``None``. This is the only script action supported for **button type** " "widgets." msgstr "" "ウィジェットに関連付けられたアクション用のJavaScriptテキスト（Unicode）、または ``None``。これは **ボタンタイプ** " "のウィジェットに対してサポートされる唯一のスクリプトアクションです。" #: ../../widget.rst:166 bbc99abeab574327895dbdfadb016871 msgid "" "JavaScript text (unicode) to be performed when the user types a key-" "stroke into a text field or combo box or modifies the selection in a " "scrollable list box. This action can check the keystroke for validity and" " reject or modify it. ``None`` if not present." msgstr "" "JavaScriptテキスト（Unicode）は、ユーザーがテキストフィールドまたはコンボボックスにキーストロークを入力するか、スクロール可能なリストボックスの選択を変更するときに実行されるアクションです。このアクションはキーストロークの妥当性をチェックし、拒否または変更することができます。存在しない場合は" " ``None`` です。" #: ../../widget.rst:172 49c953662fc846e4ab3a5754771075d5 msgid "" "JavaScript text (unicode) to be performed before the field is formatted " "to display its current value. This action can modify the field’s value " "before formatting. ``None`` if not present." msgstr "" "このアクションは、フィールドが現在の値を表示するためにフォーマットされる前に、フィールドの値を変更するために実行されるJavaScriptテキスト（Unicode）です。存在しない場合は" " ``None`` です。" #: ../../widget.rst:178 f099a7380085444088d138037fc88009 msgid "" "JavaScript text (unicode) to be performed when the field’s value is " "changed. This action can check the new value for validity. ``None`` if " "not present." msgstr "" "このアクションは、フィールドの値が変更されたときに実行されるJavaScriptテキスト（Unicode）です。このアクションは新しい値の妥当性をチェックすることができます。存在しない場合は" " ``None`` です。" #: ../../widget.rst:184 195412bc8f7645c7af94839cbeef56c7 msgid "" "JavaScript text (unicode) to be performed to recalculate the value of " "this field when that of another field changes. ``None`` if not present." msgstr "バージョン1.16.12で新規追" #: ../../widget.rst:188 ../../widget.rst:194 be53028b2eeb496e91e645ddedbecf73 #: caaac82450ae43fd84f1684ee16cc1aa msgid "New in version 1.22.6" msgstr "バージョン1.22.6で新規追加" #: ../../widget.rst:190 66757bee21264b4591997469672bf407 msgid "" "JavaScript text (unicode) to be performed on losing the focus of this " "field. ``None`` if not present." msgstr "このフィールドからフォーカスを失ったときに実行されるJavaScriptテキスト（Unicode）です。存在しない場合は ``None`` です。" #: ../../widget.rst:196 6d86df2f110242b9b322d96488384f39 msgid "" "JavaScript text (unicode) to be performed on focusing this field. " "``None`` if not present." msgstr "このフィールドにフォーカスが当たったときに実行されるJavaScriptテキスト（Unicode）です。存在しない場合は ``None`` です。" #: ../../widget.rst:200 31230d72253b4583a09b8159f40329f4 msgid "For **adding** or **changing** one of the above scripts," msgstr "上記のいずれかのスクリプトを **追加** または **変更** するには、" #: ../../widget.rst:201 3d2a3d82396442afb52dfc4cdd423495 msgid "" "just put the appropriate JavaScript source code in the widget attribute. " "To **remove** a script, set the respective attribute to ``None``." msgstr "" "適切なJavaScriptソースコードをウィジェット属性に配置するだけです。スクリプトを **削除する** には、該当する属性を ``None``" " に設定します。" #: ../../widget.rst:204 8ae6388eebe44c248ddac814e91ade75 msgid "Button fields only support :attr:`script`." msgstr "ボタンフィールドは :attr:`script` をサポートしています" #: ../../widget.rst:205 eaf4aaf730aa470bac28fa589c1d9a75 msgid "Other script entries will automatically be set to ``None``." msgstr "他のスクリプトエントリは自動的に ``None`` に設定されます。" #: ../../widget.rst:207 1574012d10e54a92850485e41d1ffedf msgid "" "It is worthwhile to look at `this " "`_ manual with lots of " "information about Adobe's standard scripts for various field types. For " "example, if you want to add a text field representing a date, you may " "want to store the following scripts. They will ensure pattern-compatible " "date formats and display date pickers in supporting viewers::" msgstr "" "Adobeの標準スクリプトに関する多くの情報が含まれている `この " "`_ " "マニュアルを確認する価値があります。たとえば、日付を表すテキストフィールドを追加する場合、次のスクリプトを保存することができます。これにより、パターン互換の日付形式が確保され、サポートされているビューアで日付ピッカーが表示されます。" #: ../../widget.rst:219 c65b215c2ad34e7488b15662ebd4d3bb msgid "Standard Fonts for Widgets" msgstr "ウィジェット用の標準フォント" #: ../../widget.rst:220 cdad1a06914d4e0096cf6f84a03b0434 #, fuzzy msgid "" "Widgets use their own resources object ``/DR``. A widget resources object" " must at least contain a ``/Font`` object. Widget fonts are independent " "from page fonts. We currently support the 14 PDF base fonts using the " "following fixed reference names, or any name of an already existing field" " font. When specifying a text font for new or changed widgets, **either**" " choose one in the first table column (upper and lower case supported), " "**or** one of the already existing form fonts. In the latter case, " "spelling must exactly match." msgstr "" "ウィジェットは独自のリソースオブジェクト */DR* を使用します。ウィジェットのリソースオブジェクトには、少なくとも */Font* " "オブジェクトを含める必要があります。ウィジェットフォントはページフォントとは独立しています。現在、以下の固定参照名を使用して、14のPDFベースフォントをサポートしています。また、既存のフィールドフォントの名前でもかまいません。新しいウィジェットまたは変更されたウィジェットのテキストフォントを指定する際には、最初の表の列（大文字と小文字がサポートされています）から1つを選択するか、既存のフォームフォントの1つを選択してください。後者の場合、スペルは厳密に一致する必要があります。" #: ../../widget.rst:222 7fd5734a55b445cc854e109cbc203e17 msgid "" "To find out already existing field fonts, inspect the list " ":attr:`Document.FormFonts`." msgstr "既存のフィールドフォントを見つけるには、リスト :attr:`Document.FormFonts` を調べてください。" #: ../../widget.rst:225 989af4e78c0847918dbff49079157c49 msgid "**Reference**" msgstr "**参照**" #: ../../widget.rst:225 2a3d30a6f94b40939fd222ac5505a0c3 msgid "**Base14 Fontname**" msgstr "**Base14フォント名**" #: ../../widget.rst:227 352a551d7b7d4200932f4f74ab639993 msgid "CoBI" msgstr "" #: ../../widget.rst:227 97b97d88ac2049608397f18450ce94f9 msgid "Courier-BoldOblique" msgstr "" #: ../../widget.rst:228 5784d31036e8451ea00333ebfc861db7 msgid "CoBo" msgstr "" #: ../../widget.rst:228 f62fddbdd0ec4ca5a7de461de53b6f58 msgid "Courier-Bold" msgstr "" #: ../../widget.rst:229 7b2ab33a398843e2b2becf0f64045392 msgid "CoIt" msgstr "" #: ../../widget.rst:229 053e2cadb71446e3938febe4ef984f31 msgid "Courier-Oblique" msgstr "" #: ../../widget.rst:230 4f7d11706d4b41ec968dff1ac8fb677f msgid "Cour" msgstr "" #: ../../widget.rst:230 bc034dde385b406280bef75f575a2672 msgid "Courier" msgstr "" #: ../../widget.rst:231 ff774f899f274ee5a81ee1e6d1959b8c msgid "HeBI" msgstr "" #: ../../widget.rst:231 172ee9521a2348cd9f506babd8af5f10 msgid "Helvetica-BoldOblique" msgstr "" #: ../../widget.rst:232 79d0f51c58f54f67a759e45d17d9ffc6 msgid "HeBo" msgstr "" #: ../../widget.rst:232 467053b50fdf4b6a970d48f6d4cc2e1a msgid "Helvetica-Bold" msgstr "" #: ../../widget.rst:233 5abb199e534a4b2985760322156b7819 msgid "HeIt" msgstr "" #: ../../widget.rst:233 8d472db0bc5a44caa9de71c566f7cb7e msgid "Helvetica-Oblique" msgstr "" #: ../../widget.rst:234 d03174f7c84045ea9ef98507a09fa344 msgid "Helv" msgstr "" #: ../../widget.rst:234 bbec46b6db884fb29167ffc50a0c7dcb msgid "Helvetica **(default)**" msgstr "Helvetica **(デフォルト)**" #: ../../widget.rst:235 cd1c089129784daeb903d5ef116ea70b msgid "Symb" msgstr "" #: ../../widget.rst:235 81ad28b580f44ba78513b1abebbc40bc msgid "Symbol" msgstr "" #: ../../widget.rst:236 de4c92826dc94244b1b8ef026ab90a2e msgid "TiBI" msgstr "" #: ../../widget.rst:236 3dc417d13f2d4a6cbb1233643dc93f65 msgid "Times-BoldItalic" msgstr "" #: ../../widget.rst:237 43969ece08334ca685bd92f021cd1884 msgid "TiBo" msgstr "" #: ../../widget.rst:237 32b0cc34477144ffb88eb7565f2a0533 msgid "Times-Bold" msgstr "" #: ../../widget.rst:238 a1252968a11c4601b7341a5c9ad95394 msgid "TiIt" msgstr "" #: ../../widget.rst:238 8cdd804d025940c8b5d05a9397419bdc msgid "Times-Italic" msgstr "" #: ../../widget.rst:239 4d07f298c6d14909b518fad20ea5e681 msgid "TiRo" msgstr "" #: ../../widget.rst:239 b7c540028a3d4cedb72159dba9849432 msgid "Times-Roman" msgstr "" #: ../../widget.rst:240 58ea0b46026f4588b999a9ca93163980 msgid "ZaDb" msgstr "" #: ../../widget.rst:240 2e0483edf38749a1928b25d20ab9055a msgid "ZapfDingbats" msgstr "" #: ../../widget.rst:243 a31f0eb06f284c738ae3404fb14e5e42 #, fuzzy msgid "" "You are generally free to use any font for every widget. However, we " "recommend using ``ZaDb`` (\"ZapfDingbats\") and :data:`fontsize` 0 for " "check boxes: typical viewers will put a correctly sized tickmark in the " "field's rectangle, when it is clicked." msgstr "" "一般的に、すべてのウィジェットに任意のフォントを使用することができます。ただし、チェックボックスには *ZaDb* " "（「ZapfDingbats」）フォントと :data:`fontsize` " "0を使用することをお勧めします。典型的なビューアは、フィールドの四角形をクリックすると正しくサイズ調整されたチェックマークを配置します。" #: ../../widget.rst:246 25ed10dbd2a14216bbd4ed04f57c98cd msgid "Supported Widget Types" msgstr "対応ウィジェットの種類" #: ../../widget.rst:247 8cb59d1d5bd14f098f5fc408b8849853 msgid "" "PyMuPDF supports the creation and update of many, but not all widget " "types." msgstr "PyMuPDFは、多くのウィジェットタイプの作成および更新をサポートしていますが、すべてのウィジェットタイプには対応していません。" #: ../../widget.rst:249 8461bca05ec547fabc82884dedd125bb msgid "text (`PDF_WIDGET_TYPE_TEXT`)" msgstr "テキスト（`PDF_WIDGET_TYPE_TEXT`）" #: ../../widget.rst:250 4c1a2929bc174c79bd4b539f47d803f2 msgid "push button (`PDF_WIDGET_TYPE_BUTTON`)" msgstr "プッシュボタン（`PDF_WIDGET_TYPE_BUTTON`）" #: ../../widget.rst:251 c8546d5d5e834b6bb9bf78579650d52d msgid "check box (`PDF_WIDGET_TYPE_CHECKBOX`)" msgstr "チェックボックス（`PDF_WIDGET_TYPE_CHECKBOX`）" #: ../../widget.rst:252 90c82cab0fe4443ab3b6c96bde056ab8 msgid "combo box (`PDF_WIDGET_TYPE_COMBOBOX`)" msgstr "コンボボックス（`PDF_WIDGET_TYPE_COMBOBOX`）" #: ../../widget.rst:253 466344d91d064ed5a8d839e9b95d1988 msgid "list box (`PDF_WIDGET_TYPE_LISTBOX`)" msgstr "リストボックス（`PDF_WIDGET_TYPE_LISTBOX`）" #: ../../widget.rst:254 315046b3a75448dd80a03dc3287c68fe #, fuzzy msgid "" "radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF does not currently " "support the **creation** of groups of (interconnected) radio buttons, " "where setting one button automatically unsets the other buttons in the " "group. The widget object also does not reflect the presence of a button " "group. However: consistently selecting (or unselecting) a radio button is" " supported. This includes correctly setting the value maintained in the " "owning button group. Selecting a radio button may be done by either " "assigning `True` or `field.on_state()` to the field value. **De-" "selecting** the button should be done assigning `False`." msgstr "" "ラジオボタン（`PDF_WIDGET_TYPE_RADIOBUTTON`）：PyMuPDFは現在、ラジオボタンのグループ（相互に接続された）の " "**作成** " "をサポートしていません。つまり、1つを設定すると、グループ内の他のボタンが自動的に設定解除されるような状態を作成することはできません。また、ウィジェットオブジェクトはボタングループの存在を反映しません。ただし、ラジオボタンを一貫して選択（または選択解除）することはサポートされています。これには、所属するボタングループで維持される値を正しく設定することも含まれます。ラジオボタンを選択するには、フィールドの値に" " `True` または `field.on_state()` を割り当てることができます。ボタンの選択解除は、`False` " "を割り当てることによって行う必要があります。" #: ../../widget.rst:255 b7ca95506bb743bf8bc9d51686c700fc msgid "" "signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only** -- no update or " "creation of signatures." msgstr "" #: ../../widget.rst:258 b53b3f3d840749208db6e32b83f6d04d msgid "Footnotes" msgstr "脚注" #: ../../widget.rst:259 3eaba62dde8347e2a386454b987a2ed7 msgid "" "If you intend to re-access a new or updated field (e.g. for making a " "pixmap), make sure to reload the page first. Either close and re-open the" " document, or load another page first, or simply do `page = " "doc.reload_page(page)`." msgstr "" "新しいまたは更新されたフィールドに再アクセスする意図がある場合（たとえば、ピクセルマップを作成する場合）、まずページを再読み込むことを確認してください。文書を閉じて再度開くか、別のページを読み込むか、または単に" " `page = doc.reload_page(page)` を実行してください" #: ../../widget.rst:261 148f6fb2b3f74450a3f794e012c04772 msgid "" "Among other purposes, ``Parent`` objects are also used to facilitate " "multiple occurrences of a field (on the same or on different pages). The " "``Kids`` array in this ``Parent`` object contains the cross references of" " all widgets that are \"copies\" of the same field. Whenever the field " "value of any \"kid\" widget is changed, all the other kids are " "immediately updated too. This is a very efficient way to handle multiple " "copies of the same field, e.g. for filling out forms. This simultaneous " "update only happens for :attr:`Widget.field value`. The new parameter " "``sync_flags`` extends this to :attr:`Widget.field_flags`. This cannot be" " automated in the same way as for the field value to allow for more " "flexibility." msgstr "" #: ../../footer.rst:46 00e495d1b07b4fb7afe8b0b3fc2b91b4 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" #~ msgid "signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only**." #~ msgstr "署名（`PDF_WIDGET_TYPE_SIGNATURE`）は **読み取り専用です** 。" ================================================ FILE: docs/locales/ja/LC_MESSAGES/xml-class.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 35b2e14fdbf9456f870ea5e07c6a1abe msgid "Artifex" msgstr "" #: ../../header.rst:-1 9c383ee007cb459a8f5ce0a78b556be8 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 7207641edba74fb79cd09bd543f88a77 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../xml-class.rst:7 5a1acd7449794938872c81139fa8acd0 msgid "Xml" msgstr "" #: ../../xml-class.rst:11 4ee590d80c2745afaad733bc8ba82e1d msgid "New in v1.21.0" msgstr "v1.21.0で新たに追加" #: ../../xml-class.rst:13 8fa4f25d9d5d4b7ea94cc3b663b67d4c msgid "" "This represents an HTML or an XML node. It is a helper class intended to " "access the DOM (Document Object Model) content of a :ref:`Story` object." msgstr "" "Xmlクラスは、HTMLまたはXMLノードを表します。これは、:ref:`Story` オブジェクトのDOM（Document Object " "Model）コンテンツにアクセスするためのヘルパークラスです。" #: ../../xml-class.rst:15 e5105e52125246098e3b455ef2776456 msgid "" "There is no need to ever directly construct an :ref:`Xml` object: after " "creating a :ref:`Story`, simply take :attr:`Story.body` -- which is an " "Xml node -- and use it to navigate your way through the story's DOM." msgstr "" ":ref:`Xml` オブジェクトを直接構築する必要はありません。:ref:`Story` を作成した後、単に " ":attr:`Story.body` を取得し（これはXmlノードです）、それを使用してストーリーのDOMを操作できます。" #: ../../xml-class.rst:19 086ba76b6eaa4206b74c6b525b2ae70b msgid "**Method / Attribute**" msgstr "**メソッド/属性**" #: ../../xml-class.rst:19 9b744e4fa0694c9986e2250f2278784d msgid "**Description**" msgstr "**説明**" #: ../../xml-class.rst:21 f46174ffaec14c09984d82014f3fc9a4 msgid ":meth:`~.add_bullet_list`" msgstr "" #: ../../xml-class.rst:21 eefa1933e3b5485eb89f2e53127bcbf1 msgid "Add a :htmlTag:`ul` tag - bulleted list, context manager." msgstr ":htmlTag:`ul` タグを追加します - 箇条書きリスト、コンテキストマネージャ。" #: ../../xml-class.rst:22 16936bcd25534da28940c85397594734 msgid ":meth:`~.add_codeblock`" msgstr "" #: ../../xml-class.rst:22 fcf17dab1d8645fe9307bbaad85e9a78 msgid "Add a :htmlTag:`pre` tag, context manager." msgstr ":htmlTag:`pre` タグを追加します、コンテキストマネージャ。" #: ../../xml-class.rst:23 103a3a5af0f14cd1924448b542f62b6b msgid ":meth:`~.add_description_list`" msgstr "" #: ../../xml-class.rst:23 e2f66dd80053480e97b4eeeb1ff42a9c msgid "Add a :htmlTag:`dl` tag, context manager." msgstr ":htmlTag:`dl` タグを追加します、コンテキストマネージャ。" #: ../../xml-class.rst:24 b041d519f2b64e188188cddb8b2f4e9b msgid ":meth:`~.add_division`" msgstr "" #: ../../xml-class.rst:24 31129830737949a8bb370681ecfd4d06 msgid "add a :htmlTag:`div` tag (renamed from “section”), context manager." msgstr ":htmlTag:`div` タグを追加します（「section」と名前変更）、コンテキストマネージャ。" #: ../../xml-class.rst:25 da7da028486141f58cf9c5a7952e1ba0 msgid ":meth:`~.add_header`" msgstr "" #: ../../xml-class.rst:25 228124168ce64130ad9d0ff5b13646e0 msgid "Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context manager." msgstr "headerタグ（:htmlTag:`h1` から :htmlTag:`h6` のいずれか）を追加します、コンテキストマネージャ。" #: ../../xml-class.rst:26 806d8bfb5b3b4ce397764e9d4a0dc1d8 msgid ":meth:`~.add_horizontal_line`" msgstr "" #: ../../xml-class.rst:26 c07169b784924633a5e1fd68c8af798c msgid "Add a :htmlTag:`hr` tag." msgstr ":htmlTag:`hr` タグを追加します。" #: ../../xml-class.rst:27 5a73b0a8f50a496691126bd9d77a5637 msgid ":meth:`~.add_image`" msgstr "" #: ../../xml-class.rst:27 340cf98f4f3f4e4a84c228fd7be2e4d6 msgid "Add a :htmlTag:`img` tag." msgstr ":htmlTag:`img` タグを追加します。" #: ../../xml-class.rst:28 d158603be675421a8b7f39bb5ff0a586 msgid ":meth:`~.add_link`" msgstr "" #: ../../xml-class.rst:28 339c28e41d7e44558a1e9b671ba9ef54 msgid "Add a :htmlTag:`a` tag." msgstr ":htmlTag:`a` タグを追加します。" #: ../../xml-class.rst:29 7f6b79bf740d49b1932cf6a6a6576758 msgid ":meth:`~.add_number_list`" msgstr "" #: ../../xml-class.rst:29 0c01f30a42cf4468b8213216a1b3297c msgid "Add a :htmlTag:`ol` tag, context manager." msgstr ":htmlTag:`ol` タグを追加します、コンテキストマネージャ。" #: ../../xml-class.rst:30 8f9f02ea8c414d29a83d318465a0ff48 msgid ":meth:`~.add_paragraph`" msgstr "" #: ../../xml-class.rst:30 253c26552e274fbeb3da81a3470eec14 msgid "Add a :htmlTag:`p` tag." msgstr ":htmlTag:`p` タグを追加します。" #: ../../xml-class.rst:31 b2d6acd206bb4cb2a8f6be0b5197c0d8 msgid ":meth:`~.add_span`" msgstr "" #: ../../xml-class.rst:31 98fe31d20e7a4ae8af4eba0928d53dd1 msgid "Add a :htmlTag:`span` tag, context manager." msgstr ":htmlTag:`span` タグを追加します。コンテキストマネージャーです。" #: ../../xml-class.rst:32 50600afc53a74e6c80d8b4eef6b2304e msgid ":meth:`~.add_subscript`" msgstr "" #: ../../xml-class.rst:32 c9cb764e916a4b27afb3c18ae5983896 msgid "" "Add subscript text(:htmlTag:`sub` tag) - inline element, treated like " "text." msgstr "添字テキスト（:htmlTag:`sub` タグ）を追加します。行内要素で、テキストのように扱われます。" #: ../../xml-class.rst:33 b72843ab592f40e8877c99fe4c941dcb msgid ":meth:`~.add_superscript`" msgstr "" #: ../../xml-class.rst:33 3630b21203814ea190918432f1ca2417 msgid "" "Add subscript text (:htmlTag:`sup` tag) - inline element, treated like " "text." msgstr "上付きテキスト（:htmlTag:`sup` タグ）を追加します。行内要素で、テキストのように扱われます。" #: ../../xml-class.rst:34 69e9ce07a81841c280b49fa28bd70c97 msgid ":meth:`~.add_code`" msgstr "" #: ../../xml-class.rst:34 ../../xml-class.rst:35 ../../xml-class.rst:36 #: ../../xml-class.rst:37 5c6747963ef74d38b09f3a6fbd934145 #: 8cd903b064c74812942fc2b54fcb182d aa212076d95d4d34aca0fedfba075d7c #: bbf8c37a914547df93d38bbff33c7496 msgid "Add code text (:htmlTag:`code` tag) - inline element, treated like text." msgstr "コードテキスト（:htmlTag:`code` タグ）を追加します。行内要素で、テキストのように扱われます。" #: ../../xml-class.rst:35 ed457783f87b4432965ba520310e2912 msgid ":meth:`~.add_var`" msgstr "" #: ../../xml-class.rst:36 baa6b54b7dec48428d61ef058714e1c8 msgid ":meth:`~.add_samp`" msgstr "" #: ../../xml-class.rst:37 2e681286c7934f9e98e30aeed8f1e058 msgid ":meth:`~.add_kbd`" msgstr "" #: ../../xml-class.rst:38 c90afbfd1f2a4432aa57f469ce1aa9c3 msgid ":meth:`~.add_text`" msgstr "" #: ../../xml-class.rst:38 ../../xml-class.rst:162 #: e05cf6e5226b4f768bfb698de671c8db fdddcc02af0b4c43a986178f7ab86439 #, fuzzy msgid "Add a text string. Line breaks ``\\n`` are honored as :htmlTag:`br` tags." msgstr "テキスト文字列を追加します。改行 ``\\n`` は :htmlTag:`br` タグとして認識されます。" #: ../../xml-class.rst:39 5ae611e247354be1a46cad16dd7fdf40 msgid ":meth:`~.append_child`" msgstr "" #: ../../xml-class.rst:39 f501e0b055984ba48721852e2de6968d msgid "Append a child node." msgstr "子ノードを追加します。" #: ../../xml-class.rst:40 25340d7a99fc4ccf860933df50d0ebec msgid ":meth:`~.clone`" msgstr "" #: ../../xml-class.rst:40 c331f277124c4ee3b8a1e9037493a3db msgid "Make a copy if this node." msgstr "このノードのコピーを作成します。" #: ../../xml-class.rst:41 89bd772f48204020b60419c2db9d5bff msgid ":meth:`~.create_element`" msgstr "" #: ../../xml-class.rst:41 405cddf85d9c49dd8e5b9cd0fcfa855d msgid "Make a new node with a given tag name." msgstr "指定されたタグ名で新しいノードを作成します。" #: ../../xml-class.rst:42 b521f73a8f764b0f87ea954af8981b37 msgid ":meth:`~.create_text_node`" msgstr "" #: ../../xml-class.rst:42 ../../xml-class.rst:306 #: 36b72c94c0534f59897e7d90525f00ab dfd89d799b2a49de8a00c1c68015628f msgid "Create direct text for the current node." msgstr "現在のノードに直接テキストを作成します。" #: ../../xml-class.rst:43 fe2c4c6a496e4c30a74892bf305be0bf msgid ":meth:`~.find`" msgstr "" #: ../../xml-class.rst:43 318cef4b3a694140908577091226c3e3 msgid "Find a sub-node with given properties." msgstr "指定されたプロパティを持つサブノードを検索します。" #: ../../xml-class.rst:44 a453fbff3b22420db8f0c51be152f8d6 msgid ":meth:`~.find_next`" msgstr "" #: ../../xml-class.rst:44 8a60922fc34041dfa5e21d0caa6fac06 msgid "Repeat previous \"find\" with the same criteria." msgstr "前回の「find」と同じ条件で繰り返します。" #: ../../xml-class.rst:45 e198f0bc22b944d48e40dc5c38223e9b msgid ":meth:`~.insert_after`" msgstr "" #: ../../xml-class.rst:45 8f66fccc674d4dd8ab65c02ac8ba24fc msgid "Insert an element after current node." msgstr "現在のノードの後に要素を挿入します。" #: ../../xml-class.rst:46 9d6b713c56884ee1b369e276ec5102a7 msgid ":meth:`~.insert_before`" msgstr "" #: ../../xml-class.rst:46 ae54a30b8bcf44daa6da5370718a075b msgid "Insert an element before current node." msgstr "現在のノードの前に要素を挿入します。" #: ../../xml-class.rst:47 e9116568aee3452182bda7d5810abf1e msgid ":meth:`~.remove`" msgstr "" #: ../../xml-class.rst:47 64bec43c81d140e9bb69363bbdaa051c msgid "Remove this node." msgstr "このノードを削除します。" #: ../../xml-class.rst:48 1ac7caa0aab541d2b460ac445585c6c7 msgid ":meth:`~.set_align`" msgstr "" #: ../../xml-class.rst:48 ac6a6fbe13044fd787cd15a2670459ef msgid "Set the alignment using a CSS style spec. Only works for block-level tags." msgstr "CSS スタイル仕様を使用して配置を設定します。ブロックレベルのタグにのみ適用されます。" #: ../../xml-class.rst:49 2c4b7b6457d4484a92058c1de4270fe9 msgid ":meth:`~.set_attribute`" msgstr "" #: ../../xml-class.rst:49 ../../xml-class.rst:172 #: 804a76ddd5074a59b8d94661b6941469 e0a54f2af7784bddb2c2e0baf1536f26 msgid "Set an arbitrary key to some value (which may be empty)." msgstr "任意のキーに値（空である可能性があります）を設定します。" #: ../../xml-class.rst:50 fa0b42cca1304379b0bcfebdc442dd15 msgid ":meth:`~.set_bgcolor`" msgstr "" #: ../../xml-class.rst:50 ../../xml-class.rst:199 #: 63b3f2fe208b457ab9f31e92c5353ce8 bdaa46d0f4da43fca01a888db16337c7 msgid "Set the background color. Only works for block-level tags." msgstr "背景色を設定します。ブロックレベルのタグにのみ適用されます。" #: ../../xml-class.rst:51 ec6d2db5fec44f689ad6be9b934f0a82 msgid ":meth:`~.set_bold`" msgstr "" #: ../../xml-class.rst:51 ../../xml-class.rst:205 #: 9e58087d6ecb42dab3894c28babdec5b bdc6a779999c4686ac0ffe57b93a8bd7 msgid "Set bold on or off or to some string value." msgstr "太字をオンまたはオフに設定するか、ある文字列の値に設定します。" #: ../../xml-class.rst:52 de15508d8d384d9da5d0b8cd2b1b780c msgid ":meth:`~.set_color`" msgstr "" #: ../../xml-class.rst:52 9189331756f9457b9a92c047923b268d msgid "Set text color." msgstr "テキストの色を設定します。" #: ../../xml-class.rst:53 9ac5e040ad994771a04fa353c7930b81 msgid ":meth:`~.set_columns`" msgstr "" #: ../../xml-class.rst:53 5e49161f1d2d43c889352cd9ff8edfc8 msgid "Set the number of columns. Argument may be any valid number or string." msgstr "列数を設定します。引数は任意の有効な数値または文字列である必要があります。" #: ../../xml-class.rst:54 09f99796e853445c8dcf98822e1ac0f7 msgid ":meth:`~.set_font`" msgstr "" #: ../../xml-class.rst:54 cf00809415f04821b5afcfb274bc466e msgid "Set the font-family, e.g. “sans-serif”." msgstr "フォントファミリーを設定します。例: \"sans-serif\"。" #: ../../xml-class.rst:55 b6ea49c8641c4332b9398bef1a6359a3 msgid ":meth:`~.set_fontsize`" msgstr "" #: ../../xml-class.rst:55 9fe5840d1b4e4891aa77b55e25a5b1e2 msgid "Set the font size. Either a float or a valid HTML/CSS string." msgstr "フォントサイズを設定します。浮動小数点数または有効なHTML/CSS文字列のいずれかです。" #: ../../xml-class.rst:56 893eb791a848403381a5172bc82ba8a2 msgid ":meth:`~.set_id`" msgstr "" #: ../../xml-class.rst:56 f2aa328fbed64085b476f3b70fdf3881 msgid "Set a :htmlTag:`id`. A check for uniqueness is performed." msgstr ":htmlTag:`id` を設定します。一意性のチェックが実行されます。" #: ../../xml-class.rst:57 783861b6af6e44bc8733b76733ec5da5 msgid ":meth:`~.set_italic`" msgstr "" #: ../../xml-class.rst:57 0701120232e24ab7a942c75085ee4917 msgid "Set italic on or off or to some string value." msgstr "イタリック体をオンまたはオフ、または一部の文字列値に設定します。" #: ../../xml-class.rst:58 309c49d3870449faa199927e29c64b96 msgid ":meth:`~.set_leading`" msgstr "" #: ../../xml-class.rst:58 ../../xml-class.rst:249 #: 040c50bebd594591ae1e863aa20683a6 dd67658b9d3349cc89ede4628205f1df msgid "" "Set inter-block text distance (`-mupdf-leading`), only works on block-" "level nodes." msgstr "インターブロックテキスト間の距離（`-mupdf-leading`）を設定します。ブロックレベルのノードでのみ機能します。" #: ../../xml-class.rst:59 2281f01a10cb44209c22340d5f31c661 msgid ":meth:`~.set_lineheight`" msgstr "" #: ../../xml-class.rst:59 5fd19f3c7efd41d6be0dd0d482afa714 msgid "Set height of a line. Float like 1.5, which sets to `1.5 * fontsize`." msgstr "行の高さを設定します。1.5のような浮動小数点数は、`1.5 * fontsize` に設定します。" #: ../../xml-class.rst:60 da10321480c547bd877d788cbbc17d19 msgid ":meth:`~.set_margins`" msgstr "" #: ../../xml-class.rst:60 562e9cf200d04d618d6ce2d9d0199a52 msgid "Set the margin(s), float or string with up to 4 values." msgstr "マージンを設定します。浮動小数点数または最大4つの値を持つ文字列です。" #: ../../xml-class.rst:61 7a9720be94704744b9ffc66d54860d47 msgid ":meth:`~.set_pagebreak_after`" msgstr "" #: ../../xml-class.rst:61 ../../xml-class.rst:267 #: 2e26773bf354417d9a1e518e237918a0 b15db1fb04a94a9db2c92c13e5185080 msgid "Insert a page break after this node." msgstr "このノードの後に改ページを挿入します。" #: ../../xml-class.rst:62 6f6e3d153b3b4739bb09a561522007a6 msgid ":meth:`~.set_pagebreak_before`" msgstr "" #: ../../xml-class.rst:62 ../../xml-class.rst:271 #: 7136cfd22a9d457a97a7e2513a45846f c2118e0dbcda4f5da4addfd12c35aa83 msgid "Insert a page break before this node." msgstr "このノードの前に改ページを挿入します。" #: ../../xml-class.rst:63 1bbac025080541ae80e078311ca65702 msgid ":meth:`~.set_properties`" msgstr "" #: ../../xml-class.rst:63 1b2e863de6b347dd9e0815f739335444 msgid "Set any or all desired properties in one call." msgstr "1つの呼び出しで任意またはすべての所望のプロパティを設定します。" #: ../../xml-class.rst:64 5b7ad8cc67534183884e12223b204bfb msgid ":meth:`~.add_style`" msgstr "" #: ../../xml-class.rst:64 b48568e9492448fea987302ce3977624 msgid "Set (add) a “style” that is not supported by its own `set_` method." msgstr "独自の `set_` メソッドでサポートされていない \"スタイル\" を設定（追加）します。" #: ../../xml-class.rst:65 eeab444cf1874576b113c84b0127b3e9 msgid ":meth:`~.add_class`" msgstr "" #: ../../xml-class.rst:65 c6c3f6a173aa4093ad84ff360356b54b msgid "Set (add) a “class” attribute." msgstr "\"クラス\" 属性を設定（追加）します。" #: ../../xml-class.rst:66 dacd474bcc8e488ab2843c5b8e98be3a msgid ":meth:`~.set_text_indent`" msgstr "" #: ../../xml-class.rst:66 2a9fa4287d5043b38c543cccd188d907 msgid "" "Set indentation for first textblock line. Only works for block-level " "nodes." msgstr "最初のテキストブロック行のインデントを設定します。ブロックレベルのノードでのみ機能します。" #: ../../xml-class.rst:67 42123ce0b6f24506853dac4a1af569fa msgid ":attr:`~.tagname`" msgstr "" #: ../../xml-class.rst:67 ../../xml-class.rst:370 #: 36166f24a5d84c408d14f9f1a2dc2468 b8920a310a044b1987fdc6fed230bf95 msgid "Either the HTML tag name like :htmlTag:`p` or `None` if a text node." msgstr "HTMLタグ名（例: :htmlTag:`p`）またはテキストノードの場合は `None`。" #: ../../xml-class.rst:68 66c56dbdcc064ee483ccc6e18e6d9785 msgid ":attr:`~.text`" msgstr "" #: ../../xml-class.rst:68 ../../xml-class.rst:374 #: 28401b8b52b2423a8c4aa49d5fc3591b e4b6e887c7244003973e168bacadf31e msgid "Either the node's text or `None` if a tag node." msgstr "ノードのテキストまたはテキストノードの場合は `None`。" #: ../../xml-class.rst:69 4a66c8e044cb475fa6fb2613a94f66e3 msgid ":attr:`~.is_text`" msgstr "" #: ../../xml-class.rst:69 ca0266179d7442349348788c2abfc7fa msgid "Check if the node is a text." msgstr "ノードがテキストかどうかを確認します。" #: ../../xml-class.rst:70 e5f96a9fc17b4e368cfce3ef779be88c msgid ":attr:`~.first_child`" msgstr "" #: ../../xml-class.rst:70 ../../xml-class.rst:382 #: 2f21de8ea3a74f8e8afccd49d6b046bc 42e3ed28baa943f6a3b5b61eebe41952 msgid "Contains the first node one level below this one (or `None`)." msgstr "このノードの1レベル下の最初のノードを含みます（または `None`）。" #: ../../xml-class.rst:71 84b9f06f42b04e4782acf1d68068c5b4 msgid ":attr:`~.last_child`" msgstr "" #: ../../xml-class.rst:71 ../../xml-class.rst:386 #: 2c94509d8b3b40b4b94c1944dca9f128 676901a092fc4735b224b379bb0c3f9f msgid "Contains the last node one level below this one (or `None`)." msgstr "このノードの1レベル下の最後のノードを含みます（または `None`）。" #: ../../xml-class.rst:72 3dd91ae4326f41568dfd754dde88c7a4 msgid ":attr:`~.next`" msgstr "" #: ../../xml-class.rst:72 ../../xml-class.rst:390 #: cbabeaa3eefd40249b4dd37b701d59cc d36f34064bfa40a0a40827e73a241423 msgid "The next node at the same level (or `None`)." msgstr "同じレベルの次のノード（または `None`）。" #: ../../xml-class.rst:73 7a0463bd4ac7449dabbfab5a78bbbdd0 msgid ":attr:`~.previous`" msgstr "" #: ../../xml-class.rst:73 ../../xml-class.rst:394 #: 21ccb8eec1544ac69539f5504e1c2572 3bc7b50ddc0d48a1b11a3a42ff6bf3ff msgid "The previous node at the same level." msgstr "同じレベルの前のノード。" #: ../../xml-class.rst:74 d61cc5bbd1f146c7972c2ebfc6200683 msgid ":attr:`~.root`" msgstr "" #: ../../xml-class.rst:74 ../../xml-class.rst:398 #: a71d233f5e2e429eb0443f3879620f09 cd5e5bf55358464abc8f27b0b2c4c712 msgid "The top node of the DOM, which hence has the tagname :htmlTag:`html`." msgstr "DOMのトップノードで、したがって :htmlTag:`html` というタグ名を持っています。" #: ../../xml-class.rst:79 7b4df043605440d3bb688f84d119f814 msgid "**Class API**" msgstr "**クラスAPI**" #: ../../xml-class.rst:85 15f567e4f1754a959a432aa258e0d91d msgid "" "Add an :htmlTag:`ul` tag - bulleted list, context manager. See `ul " "`_." msgstr "" ":htmlTag:`ul` タグ（箇条書きリスト）を追加します。コンテキスト マネージャーです。詳細は `ul " "`_ " "を参照してください。" #: ../../xml-class.rst:89 3c04822b8860402a8b9573c54e5194e3 msgid "" "Add a :htmlTag:`pre` tag, context manager. See `pre " "`_." msgstr "" ":htmlTag:`pre` タグ（コードブロック）を追加します。コンテキスト マネージャーです。詳細は `pre " "`_ " "を参照してください。" #: ../../xml-class.rst:93 0ed1cc73e1274f0a9666e87961987c78 msgid "" "Add a :htmlTag:`dl` tag, context manager. See `dl " "`_." msgstr "" ":htmlTag:`dl` タグ（説明リスト）を追加します。コンテキスト マネージャーです。詳細は `dl " "`_ " "を参照してください。" #: ../../xml-class.rst:97 0b0a1eaefbc1441fbd61bce939f12692 msgid "" "Add a :htmlTag:`div` tag, context manager. See `div " "`_." msgstr "" ":htmlTag:`div` タグを追加します。コンテキスト マネージャーです。詳細は `div " "`_ " "を参照してください。" #: ../../xml-class.rst:101 8be2c66a14014d738a580d04d0c21248 msgid "" "Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context " "manager. See `headings `_." msgstr "" "ヘッダータグ（:htmlTag:`h1` から :htmlTag:`h6` のいずれか）を追加します。コンテキスト マネージャーです。詳細は " "`見出し `_ を参照してください。" #: ../../xml-class.rst 06667ae7d009417a97c1ecf590b1a67f #: 0aaa5b3f295942ebbbccb8d389cd898a 1aa126b038ed4ce781aecf808c57cdec #: 1d2b1dade7d6423bb8e41f0972a59fb3 1d556e1aced24a5a8be36537a9f59e1b #: 1e0cf1d1d2054403831bfb69810ee742 255c1340c66245b48f2a3cdf80e4214c #: 2c0eea03634e486dabab3f54b424fad2 46aa4928a5604814a92adf164d7fa247 #: 49455d15a82740859665ec07012100a3 61e61452d3f94579997370f901426bce #: 67c4ccac4676478495f011032187051d 6e85e6b82e584e458e9f10f45aeaf176 #: 9079b60e1ede4c158bdcc07baa224b19 a1450c78b0a74e7a9a133091ddb6e387 #: a90aa7ae4f834d88b627c22105ee12ce cc4f042b90394b9eb95de870938d8c43 #: d0e84706994a47c4aad671254c7a85e2 d1095b66b77e4a72a9793960df3fa674 #: d23494315ac041c791e01f27f2af929e d96c7bfed45740ec810afcba0125a60a #: dd18489673354a54a1e8b0d472e4d131 e1d5789d094643a8b45b8b3c59f908b1 #: e6d0fce46e4a49ef89c56b78e0914a3f edfbbc1dbdd840519996cc595579ac32 #: f5a2500942f844c3ba7e25042d206f66 f9e99192da7d40888802688752c7595e msgid "Parameters" msgstr "" #: ../../xml-class.rst:103 05de048c66ba4b459eb9539250326096 msgid "a value 1 - 6." msgstr "値（1 - 6）。" #: ../../xml-class.rst:107 2c297e02768c469799efc10e37822f0e msgid "" "Add a :htmlTag:`hr` tag. See `hr `_." msgstr "" ":htmlTag:`hr` タグを追加します。詳細は `hr `_ を参照してください。" #: ../../xml-class.rst:111 b970bd7ba2b14e329f30ab7f38392367 msgid "" "Add an :htmlTag:`img` tag. This causes the inclusion of the named image " "in the DOM." msgstr ":htmlTag:`img` タグを追加します。これにより、指定された名前の画像が DOM に含まれます。" #: ../../xml-class.rst:113 9fae2f8598bf4a7b873ba77fe44e109d msgid "" "the filename of the image. This **must be the member name** of some entry" " of the :ref:`Archive` parameter of the :ref:`Story` constructor." msgstr "" "画像のファイル名。これは :ref:`Story` コンストラクタの :ref:`Archive` パラメータのエントリの " "**メンバー名である必要があります** 。" #: ../../xml-class.rst:114 f86a37a277f94897a82aefd1205cbb77 msgid "" "if provided, either an absolute (int) value, or a percentage string like " "\"30%\". A percentage value refers to the width of the specified `where` " "rectangle in :meth:`Story.place`. If this value is provided and `height` " "is omitted, the image will be included keeping its aspect ratio." msgstr "" "提供された場合、絶対値（int）または「30%」などのパーセンテージ文字列。パーセンテージ値は :meth:`Story.place` " "で指定された `where` の長方形の幅を指します。この値が提供され、`height` " "が省略された場合、画像はアスペクト比を保持したまま含まれます。" #: ../../xml-class.rst:115 fb3d1d9e2800433b822fc09a4d7e5b38 msgid "" "if provided, either an absolute (int) value, or a percentage string like " "\"30%\". A percentage value refers to the height of the specified `where`" " rectangle in :meth:`Story.place`. If this value is provided and `width` " "is omitted, the image's aspect ratio will be honored." msgstr "" "提供された場合、絶対値（int）または「30%」などのパーセンテージ文字列。パーセンテージ値は :meth:`Story.place` " "で指定された `where` 長方形の高さを指します。この値が提供され、`width` が省略された場合、画像のアスペクト比が維持されます。" #: ../../xml-class.rst:119 7dc5d5cd96ba453683175419ccf0139d msgid "Add an :htmlTag:`a` tag - inline element, treated like text." msgstr ":htmlTag:`a` タグを追加します - インライン要素で、テキストのように扱われます。" #: ../../xml-class.rst:121 0e78457bb88a440b916bc48c1587500a msgid "the URL target." msgstr "URL の対象。" #: ../../xml-class.rst:122 29694751dcf94583ab50b52f45eac3c5 msgid "the text to display. If omitted, the `href` text is shown instead." msgstr "表示するテキスト。省略した場合、`href` のテキストが代わりに表示されます。" #: ../../xml-class.rst:126 b5e405fe3b834289ba24aee22e844046 msgid "Add an :htmlTag:`ol` tag, context manager." msgstr ":htmlTag:`ol` タグを追加します。コンテキストマネージャーです。" #: ../../xml-class.rst:130 76fa57288ce94e5f83f0c2179b72bfe6 msgid "Add a :htmlTag:`p` tag, context manager." msgstr ":htmlTag:`p` タグを追加します。コンテキストマネージャーです。" #: ../../xml-class.rst:134 ab34ee2cc1fd4256ad7020de606ebc05 msgid "Add a :htmlTag:`span` tag, context manager. See `span`_" msgstr ":htmlTag:`span` タグを追加します。コンテキストマネージャーです。span タグについては `span`_ を参照してください。" #: ../../xml-class.rst:138 07628e22868f42ffbcf7ddd9c0ac35d5 msgid "" "Add \"subscript\" text(:htmlTag:`sub` tag) - inline element, treated like" " text." msgstr "\"subscript\" テキスト（:htmlTag:`sub` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:142 dd9903a2ecf4404a9d6accc1e0749f79 msgid "" "Add \"superscript\" text (:htmlTag:`sup` tag) - inline element, treated " "like text." msgstr "\"superscript\" テキスト（:htmlTag:`sup` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:146 ed86a64559ee476a87e5777052bb75fe msgid "" "Add \"code\" text (:htmlTag:`code` tag) - inline element, treated like " "text." msgstr "\"code\" テキスト（:htmlTag:`code` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:150 23a0e0f64af1407a8d78e8b1fc6eba45 msgid "" "Add \"variable\" text (:htmlTag:`var` tag) - inline element, treated like" " text." msgstr "\"variable\" テキスト（:htmlTag:`var` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:154 16840c2eee994250a111a670c1982c07 msgid "" "Add \"sample output\" text (:htmlTag:`samp` tag) - inline element, " "treated like text." msgstr "\"sample output\" テキスト（:htmlTag:`samp` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:158 c12b71425d2847eb8bde80f536c4c5ca msgid "" "Add \"keyboard input\" text (:htmlTag:`kbd` tag) - inline element, " "treated like text." msgstr "\"keyboard input\" テキスト（:htmlTag:`kbd` タグ）を追加します。テキストと同様に扱われるインライン要素です。" #: ../../xml-class.rst:166 a0c1e8813cc34b0b905e64b8843960a1 msgid "Set the text alignment. Only works for block-level tags." msgstr "テキストの配置を設定します。ブロックレベルのタグにのみ対応しています。" #: ../../xml-class.rst:168 5c1f833338ba45238483066cd6ee050f msgid "" "either one of the :ref:`TextAlign` or the `text-align " "`_ values." msgstr "" ":ref:`TextAlign` または `text-align `_ のいずれかの値です。" #: ../../xml-class.rst:174 ../../xml-class.rst:187 ../../xml-class.rst:195 #: 2fe24dbf6c8e491da8d3a7aca96d7db7 a41e1f3d0e3646c4848ce0ef0df0f734 #: e6ab290bc6c6427aa52cd824b5abcf95 msgid "the name of the attribute." msgstr "属性の名前。" #: ../../xml-class.rst:175 d389ba2ac4a34151a91a26102e2b6460 msgid "the (optional) value of the attribute." msgstr "(オプションの) 属性の値。" #: ../../xml-class.rst:179 07c3f60cb5574e45abb857f481b45d17 msgid "Retrieve all attributes of the current nodes as a dictionary." msgstr "現在のノードのすべての属性を辞書として取得します。" #: ../../xml-class.rst 17192c246086475781cbc2a532fe77f7 #: 316b287ac38d47998654b66e17120d3c 33b69c8e0c214f7e94b9e785d1d5acb0 #: 397c2d06aeac40b0a74e6504b51ad4da e796210aabb44877bdc47c5faba1888b #: f45ca78bcbb745fd8bf01620b26911ca f470a993feb34859b12a4343388d8e3d msgid "Returns" msgstr "戻り値:" #: ../../xml-class.rst:181 9a860899e73444138923297266a09e92 msgid "a dictionary with the attributes and their values of the node." msgstr "ノードの属性とその値を含む辞書。" #: ../../xml-class.rst:185 367b3d6b05fe484c8692a5b9fdf0888d msgid "Get the attribute value of `key`." msgstr "`key` ーの属性値を取得します。" #: ../../xml-class.rst:189 0c606e3db4aa43e4b82e63059d8b9056 msgid "a string with the value of `key`." msgstr "`key` ーの値を含む文字列。" #: ../../xml-class.rst:193 7ab7a2c9a37a49528c76d65040e92e55 msgid "Remove the attribute `key` from the node." msgstr "ノードから属性 `key` を削除します。" #: ../../xml-class.rst:201 4a286ef8c13b4a818402696f63abbbda msgid "" "either an RGB value like (255, 0, 0) (for \"red\") or a valid " "`background-color `_ value." msgstr "" "RGB値（例：(255, 0, 0)、\"red\"の場合）または有効な `background-color " "`_ 値。" #: ../../xml-class.rst:207 0c4471f9c34f45e3b376695ecd25ae47 msgid "" "`True`, `False` or a valid `font-weight `_ value." msgstr "" "`True`、`False`、または有効な `font-weight `_ 値。" #: ../../xml-class.rst:211 377d0e10d7b548c88d42311255d9ff02 msgid "Set the color of the text following." msgstr "後続するテキストの色を設定します。" #: ../../xml-class.rst:213 0596f8f1cc684e51ac8e6a2e58d3f646 msgid "" "either an RGB value like (255, 0, 0) (for \"red\") or a valid `color " "`_ value." msgstr "" "RGB値（例：(255, 0, 0)、\"red\"の場合）または有効な `カラー `_ 値。" #: ../../xml-class.rst:217 9de3ba47655e45ea86e95f7806cc1761 msgid "Set the number of columns." msgstr "列の数を設定します。" #: ../../xml-class.rst:219 d767dfd34bba48c2bd824015aedbfce5 msgid "" "a valid `columns `_ value." msgstr "" "有効な `columns `_" " 値。" #: ../../xml-class.rst:221 c5ee8d67ed604a779b356ad7a3beb3b6 msgid "Currently ignored - supported in a future MuPDF version." msgstr "現在は無視されており、将来のMuPDFバージョンでサポートされます。" #: ../../xml-class.rst:225 a3e16b087cf149fbbf6f316ad7d79880 msgid "Set the font-family." msgstr "フォントファミリーを設定します。" #: ../../xml-class.rst:227 56592161ded1480aa5c21631ec00e5ac msgid "e.g. \"sans-serif\"." msgstr "例：\"sans-serif\"など。" #: ../../xml-class.rst:231 e716de072f9544618374c016b382f40a msgid "Set the font size for text following." msgstr "後続するテキストのフォントサイズを設定します。" #: ../../xml-class.rst:233 4699b76ad7694bccbd943643ee021862 msgid "" "a float or a valid `font-size `_ value." msgstr "" "floatまたは有効な `font-size `_ 値。" #: ../../xml-class.rst:237 8cfd620b051940348ac0556e9ae65033 msgid "" "Set a :htmlTag:`id`. This serves as a unique identification of the node " "within the DOM. Use it to easily locate the node to inspect or modify it." " A check for uniqueness is performed." msgstr "" ":htmlTag:`id` " "を設定します。これはDOM内でノードを一意に識別するためのもので、ノードを簡単に見つけて調査または変更するために使用します。一意性のチェックが実行されます。" #: ../../xml-class.rst:239 b6042d6da5b14d338da93ff2ac9afdc3 msgid "id string of the node." msgstr "ノードのID文字列。" #: ../../xml-class.rst:243 83dcfa78795e4c169619f1b4203a95f7 msgid "Set italic on or off or to some string value for the text following it." msgstr "後続するテキストのイタリックをオンまたはオフ、または一部の有効なフォントスタイル値に設定します。" #: ../../xml-class.rst:245 e74b3e4a56714306840b8bd5cdcfb8b6 msgid "" "`True`, `False` or some valid `font-style `_ value." msgstr "" "`True`、`False`、または有効な `font-style `_ 値。" #: ../../xml-class.rst:251 b9a0bdede6124f1fbbde6722313e5c2c msgid "the distance in points to the previous block." msgstr "前のブロックからの距離（ポイント単位）。" #: ../../xml-class.rst:255 f13883ee98f146ca9a924b575b3cc51a msgid "Set height of a line." msgstr "行の高さを設定します。" #: ../../xml-class.rst:257 74dc61a744d94742a7eb18faf8251006 msgid "" "a float like 1.5 (which sets to `1.5 * fontsize`), or some valid `line-" "height `_ " "value." msgstr "value – 1.5のような浮動小数点数（これは `1.5 * fontsize`に設定されます）または有効な行の高さの値。" #: ../../xml-class.rst:261 f4aeb6cd082e4b039f2ef1c241cffc4a msgid "Set the margin(s)." msgstr "マージン（マージン）を設定します。" #: ../../xml-class.rst:263 754876b7c7b84370b81e5f3f15bbae21 msgid "" "float or string with up to 4 values. See `CSS documentation " "`_." msgstr "" "floatまたは最大4つの値を含む文字列。`CSSのドキュメンテーション `_ を参照してください。" #: ../../xml-class.rst:275 f2da4761cba1404d8c850cf58d8ba28c msgid "" "Set any or all desired properties in one call. The meaning of argument " "values equal the values of the corresponding `set_` methods." msgstr "一度の呼び出しで任意またはすべての所望のプロパティを設定します。引数の値の意味は、対応する `set_` メソッドの値と同じです。" #: ../../xml-class.rst:277 c1f136b0c23e4147aef9acbc054decd4 msgid "" "The properties set by this method are directly attached to the node, " "whereas every `set_` method generates a new :htmlTag:`span` below the " "current node that has the respective property. So to e.g. \"globally\" " "set some property for the :htmlTag:`body`, this method must be used." msgstr "" "このメソッドで設定されるプロパティは、直接ノードにアタッチされますが、`set_` メソッドごとに現在のノードの下に対応するプロパティを持つ新しい" " :htmlTag:`span` " "が生成されます。したがって、本文のいくつかのプロパティを「グローバルに」設定するには、このメソッドを使用する必要があります。" #: ../../xml-class.rst:281 0b00e9cdb0ed42819aad271da3e10621 msgid "Set (add) some style attribute not supported by its own `set_` method." msgstr "独自の `set_` メソッドでサポートされていないスタイル属性を設定（追加）します。" #: ../../xml-class.rst:283 457e6d62d41841ee8741782c6bfd201f msgid "any valid CSS style value." msgstr "有効なCSSスタイル値。" #: ../../xml-class.rst:287 996f4ece67a841e59d001f1d260f6571 msgid "Set (add) some \"class\" attribute." msgstr "いくつかの「class」属性を設定（追加）します。" #: ../../xml-class.rst:289 0cd9ff6d9c4640ab90612ca481fb1692 msgid "" "the name of the class. Must have been defined in either the HTML or the " "CSS source of the DOM." msgstr "クラスの名前。DOMのHTMLまたはCSSソースで定義されている必要があります。" #: ../../xml-class.rst:293 d40d57c4852c46539d9bdf515833a465 msgid "" "Set indentation for the first textblock line. Only works for block-level " "nodes." msgstr "最初のテキストブロックの行のインデントを設定します。ブロックレベルのノードでのみ機能します。" #: ../../xml-class.rst:295 0d6bee0b55f24569a45c44d5e814b140 msgid "" "a valid `text-indent `_ value. Please note that negative values do not work." msgstr "" "有効な `text-indent `_ 値。負の値は機能しないことに注意してください。" #: ../../xml-class.rst:300 762e7d8fde1d4ad3ba5ae1bf4fa34033 msgid "" "Append a child node. This is a low-level method used by other methods " "like :meth:`Xml.add_paragraph`." msgstr "子ノードを追加します。これは、:meth:`Xml.add_paragraph` などの他のメソッドで使用される低レベルのメソッドです。" #: ../../xml-class.rst:302 8fe5eebdd2b1421fb687a21dfcea9fae msgid "the :ref:`Xml` node to append." msgstr "追加する :ref:`Xml` ノード。" #: ../../xml-class.rst:308 bb3c5252dd3542cc8f263ab35551dedd msgid "the text to append." msgstr "追加するテキスト。" #: ../../xml-class.rst 022bf50af61d4a8a854203e9ba18a1ce #: 70b34bf9aef34db599ca63934a722c36 87a8f73cb5e84da286de4cacee92e249 #: c5fc1a77039842b2a10f66a29dbdb38e msgid "Return type" msgstr "" #: ../../xml-class.rst:310 ../../xml-class.rst:319 #: 14d3d45c8f9f4c94b76c6b34f9156283 e219f8801a92456dacd23c1bab7c5fa4 msgid ":ref:`Xml`" msgstr "" #: ../../xml-class.rst:311 0ed716b5c85d4de4a0457c85b58e194f msgid "the created element." msgstr "作成された要素。" #: ../../xml-class.rst:315 d82360adfca04cbeac23160c0a0c3afa msgid "" "Create a new node with a given tag. This a low-level method used by other" " methods like :meth:`Xml.add_paragraph`." msgstr "" "指定されたタグで新しいノードを作成します。これは、:meth:`Xml.add_paragraph` " "などの他のメソッドで使用される低レベルなメソッドです。" #: ../../xml-class.rst:317 9d7b1665fb704f00a0416ea1627c3c3a msgid "the element tag." msgstr "要素のタグ。" #: ../../xml-class.rst:320 ea5c614b041341e1be82c8015fbed2ef msgid "" "the created element. To actually bind it to the DOM, use " ":meth:`Xml.append_child`." msgstr "作成された要素。実際にDOMにバインドするには、:meth:`Xml.append_child` を使用します。" #: ../../xml-class.rst:324 20a9a38c30524aa7bc65ec6cbe680c47 msgid "Insert the given element `elem` before this node." msgstr "指定された要素 `elem` をこのノードの前に挿入します。" #: ../../xml-class.rst:326 ../../xml-class.rst:332 #: 44a6c046ddfd4baa968b358f7db78b0a 848c5fe3c4bb49ffbb4f55cf1fcd0d94 msgid "some :ref:`Xml` element." msgstr "いくつかの :ref:`Xml` 要素。" #: ../../xml-class.rst:330 31950c02ed55490db0883f1568fc5528 msgid "Insert the given element `elem` after this node." msgstr "指定された要素 `elem` をこのノードの後に挿入します。" #: ../../xml-class.rst:336 9b8dcc0c94654a25a10773d34514557e msgid "" "Make a copy of this node, which then may be appended (using " ":meth:`Xml.append_child`) or inserted (using one of " ":meth:`Xml.insert_before`, :meth:`Xml.insert_after`) in this DOM." msgstr "" "このノードのコピーを作成し、それをこのDOMに追加（:meth:`Xml.append_child` " "を使用）または挿入（:meth:`Xml.insert_before` 、:meth:`Xml.insert_after` " "のいずれかを使用）できるようにします。" #: ../../xml-class.rst:338 4f1ca41be752476f906e73d07f12fa64 msgid "the clone (:ref:`Xml`) of the current node." msgstr "現在のノードのクローン（:ref:`Xml`）。" #: ../../xml-class.rst:342 0cbed49f156d4211b12cb5bbe7060543 msgid "Remove this node from the DOM." msgstr "このノードをDOMから削除します。" #: ../../xml-class.rst:347 ef3d6f9aa85c47ca9abe630e29080e81 msgid "For debugging purposes, print this node's structure in a simplified form." msgstr "デバッグ目的で、このノードの構造を簡略化された形式で表示します。" #: ../../xml-class.rst:351 b77052465aff4e6c8134c42867815823 msgid "" "Under the current node, find the first node with the given `tag`, " "attribute `att` and value `match`." msgstr "現在のノードの下で、指定された `tag` 、属性 `att`、値 `match` を持つ最初のノードを検索します。" #: ../../xml-class.rst:353 c3b5cf81b4a8466aaf9a51d9aa91aed8 msgid "restrict search to this tag. May be `None` for unrestricted searches." msgstr "このタグに制限して検索します。無制限の検索の場合は `None` にできます。" #: ../../xml-class.rst:354 b3e60cf5c1694489b76c6b061502d815 msgid "check this attribute. May be `None`." msgstr "この属性を確認します。`None` にできます。" #: ../../xml-class.rst:355 445027aad8f349d5870b74bc71484e02 msgid "the desired attribute value to match. May be `None`." msgstr "致する属性値を指定します。`None` にできます。" #: ../../xml-class.rst:357 ../../xml-class.rst:364 #: 458a0f17635a4ee3beaeda11ffc6cf06 d2fbb5102700450a865b3f902ceac384 msgid ":ref:`Xml`." msgstr "" #: ../../xml-class.rst:358 b5de014d478e4703b88e1c98ad4dd9dd msgid "`None` if nothing found, otherwise the first matching node." msgstr "何も見つからない場合は `None`、それ以外の場合は最初の一致するノード。" #: ../../xml-class.rst:362 bfac5489d037476889d72ff8311df153 #, fuzzy msgid "" "Continue a previous :meth:`Xml.find` (or :meth:`find_next`) with the same" " values." msgstr "以前の :meth:`Xml.find`（または :meth:`find_next` ）を同じ値で継続します。" #: ../../xml-class.rst:365 6e37f5e14b8849b1abe7bf97c7015bc2 msgid "`None` if none more found, otherwise the next matching node." msgstr "それ以上見つからない場合は `None`、それ以外の場合は次の一致するノード。" #: ../../xml-class.rst:378 b1a7309c8f0f4aebb4c722ef9ac56d8f msgid "Check if a text node." msgstr "テキストノードであるかどうかを確認します。" #: ../../xml-class.rst:402 277f48d6971041c6949eb351109c59a6 msgid "Setting Text properties" msgstr "テキストのプロパティを設定する" #: ../../xml-class.rst:404 e4aa8bc7dde5406984bba698ad774b6a msgid "" "In HTML tags can be nested such that innermost text **inherits " "properties** from the tag enveloping its parent tag. For example " "`

some bold textthis is bold and italicregular text

`." msgstr "" "HTMLでは、タグはネストされることがあり、最も内側のテキストは親タグに囲まれたタグから **プロパティを継承します** " "。たとえば、`

some bold textthis is bold and italicregular " "text

`。" #: ../../xml-class.rst:406 231ae74dcdca47a1af2c04684d880e45 msgid "" "To achieve the same effect, methods like :meth:`Xml.set_bold` and " ":meth:`Xml.set_italic` each open a temporary :htmlTag:`span` with the " "desired property underneath the current node." msgstr "" "同じ効果を得るために、:meth:`Xml.set_bold` や :meth:`Xml.set_italic` " "などのメソッドは、各々所望のプロパティを持つ一時的な :htmlTag:`span` を現在のノードの下に追加します。" #: ../../xml-class.rst:408 703c755313884c3e8e069b836f756d47 msgid "" "In addition, these methods return there parent node, so they can be " "concatenated with each other." msgstr "さらに、これらのメソッドは親ノードを返すため、それらを連結することができます。" #: ../../xml-class.rst:413 1317fdaa53304e249c7283355ae5ebb4 msgid "Context Manager support" msgstr "コンテキストマネージャのサポート" #: ../../xml-class.rst:414 66b960c3bdd444e0a671fd3e9b81e5a1 msgid "The standard way to add nodes to a DOM is this::" msgstr "DOMにノードを追加する標準的な方法は次のとおりです::" #: ../../xml-class.rst:427 945235d10eaf46368506481d321761b5 msgid "" "Methods that are flagged as \"context managers\" can conveniently be used" " in this way::" msgstr "コンテキストマネージャとしてフラグが付いているメソッドは、次のように便利に使用できます::" #: ../../footer.rst:60 1b8fa4a6d5c14ec9becef06082bce778 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ja/LC_MESSAGES/znames.po ================================================ # PyMuPDF Japanese documentation # Copyright (C) 2015-2023, Artifex # This file is distributed under the same license as the PyMuPDF package. # Jamie Lemon , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.23.0rc1\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-04-17 15:00+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Suzan Sanver \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 0f9441fa95204b209542b6195fa33e94 msgid "Artifex" msgstr "" #: ../../header.rst:-1 b494c998c5e441c78282bc408dffff8c msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #: ../../header.rst:-1 6067a6dd9e5242e4b0ce1d3b3ce3b293 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../znames.rst:7 873beb2a37544c07b1a5e70eca5650fe msgid "Deprecated Names" msgstr "非推奨の名前" #: ../../znames.rst:9 78ca6b2b094c43dab0f3efb7a1340a0f msgid "" "The original naming convention for methods and properties has been " "\"camelCase\". Since its creation around 2013, a tremendous increase of " "functionality has happened in PyMuPDF -- and with it a corresponding " "increase in classes, methods and properties. In too many cases, this has " "led to non-intuitive, illogical and ugly names, difficult to memorize or " "guess." msgstr "メソッドやプロパティの元々の命名規則は「camelCase」でした。その創造以来、PyMuPDFでの機能の著しい増加がありました。それに伴い、クラス、メソッド、プロパティも対応するように増加しました。多くの場合、これにより直感に反した、論理的でなく見栄えのしない名前が生まれ、覚えたり推測したりが難しくなりました。" #: ../../znames.rst:11 96fde94d6cb6460bb374c4c18ab3c5f2 msgid "" "A few versions ago, I therefore decided to shift gears and switch to a " "\"snake_cased\" naming standard. This was a major effort, which needed a " "step-wise approach. I think am done with it now (version 1.18.14)." msgstr "数バージョン前、私はゆえに、段階的なアプローチが必要な大規模な取り組みであったにもかかわらず、「snake_cased」の命名規則に切り替えることを決定しました。これは大きな努力が必要でした。今はそれが完了したと思っています（バージョン1.18.14）。" #: ../../znames.rst:14 f1aba321b49d4a50b23fd84d5435c403 msgid "" "The following list maps deprecated names to their new versions. For " "example, property `pageCount` became `page_count` in the :ref:`Document` " "class. There also are less obvious name changes, e.g. method `getPNGdata`" " was renamed to `tobytes` in the :ref:`Pixmap` class." msgstr "" "以下のリストは、非推奨の名前とそれらの新しいバージョンを対応付けたものです。例えば、プロパティである `pageCount` は、 " ":ref:`Document` クラス内では `page_count` " "となりました。また、より明らかでない名前の変更もあります。例えば、メソッドである `getPNGdata` は :ref:`Pixmap` " "クラス内で `tobytes` という名前に変更されました。" #: ../../znames.rst:16 da72cacf26b1418ebcdd799307695e7f msgid "" "Names of classes (camel case) and package-wide constants (the majority is" " upper case) remain untouched." msgstr "クラスの名前（キャメルケース）やパッケージ全体の定数（大部分は大文字）については、触れずに残ります。" #: ../../znames.rst:18 8caf5f400d46465da41396c978125459 msgid "" "Old names will remain available as deprecated aliases through MuPDF " "version 1.19.0 and **be removed** in the version that follows it - " "probably version 1.20.0, but this depends on upstream decisions (MuPDF)." msgstr "" "古い名前は、MuPDFバージョン1.19.0まで非推奨のエイリアスとして利用可能であり、その後のバージョン（おそらくバージョン1.20.0ですが、これは上流の決定（MuPDF）に依存します）で" " **削除されます** 。" #: ../../znames.rst:20 196848a51a5e49d58753a2b5715c07b8 msgid "" "Starting with version 1.19.0, we will issue deprecation warnings on " "`sys.stderr` like `Deprecation: 'newPage' removed from class 'Document' " "after v1.19.0 - use 'new_page'.` when aliased methods are being used. " "Using a deprecated property will not cause this type of warning." msgstr "" "バージョン1.19.0以降、エイリアス化されたメソッドが使用されている場合、 `sys.stderr` に非推奨の警告が表示されます。例 " "`Deprecation: 'newPage'はクラス 'Document'からv1.19.0以降で削除されました - 'new_page'` " "を使用してください。非推奨のプロパティを使用した場合、このタイプの警告は発生しません。" #: ../../znames.rst:22 fd326a4ad3c94bfb8d5f9569d40f630d msgid "" "Starting immediately, all deprecated objects (methods and properties) " "will show a copy of the original's docstring, **prefixed** with the " "deprecation message, for example::" msgstr "" "直ちに、すべての非推奨のオブジェクト（メソッドとプロパティ）は、元のドキュメント文字列のコピーが表示され、その前に非推奨のメッセージが " "**付加されます** 。例：" #: ../../znames.rst:39 7ba1507fe4c94e149d0b1642bd1f770f msgid "" "There is a utility script `alias-changer.py `_ which can be used to " "do mass-renames in your scripts. It accepts either a single file or a " "folder as argument. If a folder is supplied, all its Python files and " "those of its subfolders are changed. Optionally, backups of the scripts " "can be taken." msgstr "" "スクリプト `alias-changer.py ` " "があり、スクリプト内で大量の名前変更を行うために使用できます。単一のファイルまたはフォルダを引数として受け入れます。フォルダが指定された場合、そのフォルダ内のすべてのPythonファイルおよびそのサブフォルダのファイルが変更されます。必要に応じて、スクリプトのバックアップを取ることもできます。" #: ../../footer.rst:60 317892866ae648e99963bb6a51525df6 msgid "This documentation covers all versions up to |version|." msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。" #~ msgid "PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。" #~ msgstr "" #~ msgid "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #~ msgstr "" #~ msgid "" #~ "Deprecated names are not separately " #~ "documented. The following list will help" #~ " you find the documentation of the" #~ " original." #~ msgstr "非推奨の名前は別途文書化されていません。以下のリストは、元のドキュメントの検索に役立ちます。" #~ msgid "" #~ "This is automatically generated. One or" #~ " two items refer to yet undocumented" #~ " methods - please simply ignore them." #~ msgstr "これは自動的に生成されたものです。1または2のアイテムはまだ文書化されていないメソッドを参照していますが、無視してください。" #~ msgid ":index:`_isWrapped` -- :attr:`Page.is_wrapped`" #~ msgstr "" #~ msgid ":index:`addCaretAnnot` -- :meth:`Page.add_caret_annot`" #~ msgstr "" #~ msgid ":index:`addCircleAnnot` -- :meth:`Page.add_circle_annot`" #~ msgstr "" #~ msgid ":index:`addFileAnnot` -- :meth:`Page.add_file_annot`" #~ msgstr "" #~ msgid ":index:`addFreetextAnnot` -- :meth:`Page.add_freetext_annot`" #~ msgstr "" #~ msgid ":index:`addHighlightAnnot` -- :meth:`Page.add_highlight_annot`" #~ msgstr "" #~ msgid ":index:`addInkAnnot` -- :meth:`Page.add_ink_annot`" #~ msgstr "" #~ msgid ":index:`addLineAnnot` -- :meth:`Page.add_line_annot`" #~ msgstr "" #~ msgid ":index:`addPolygonAnnot` -- :meth:`Page.add_polygon_annot`" #~ msgstr "" #~ msgid ":index:`addPolylineAnnot` -- :meth:`Page.add_polyline_annot`" #~ msgstr "" #~ msgid ":index:`addRectAnnot` -- :meth:`Page.add_rect_annot`" #~ msgstr "" #~ msgid ":index:`addRedactAnnot` -- :meth:`Page.add_redact_annot`" #~ msgstr "" #~ msgid ":index:`addSquigglyAnnot` -- :meth:`Page.add_squiggly_annot`" #~ msgstr "" #~ msgid ":index:`addStampAnnot` -- :meth:`Page.add_stamp_annot`" #~ msgstr "" #~ msgid ":index:`addStrikeoutAnnot` -- :meth:`Page.add_strikeout_annot`" #~ msgstr "" #~ msgid ":index:`addTextAnnot` -- :meth:`Page.add_text_annot`" #~ msgstr "" #~ msgid ":index:`addUnderlineAnnot` -- :meth:`Page.add_underline_annot`" #~ msgstr "" #~ msgid ":index:`addWidget` -- :meth:`Page.add_widget`" #~ msgstr "" #~ msgid ":index:`chapterCount` -- :attr:`Document.chapter_count`" #~ msgstr "" #~ msgid ":index:`chapterPageCount` -- :meth:`Document.chapter_page_count`" #~ msgstr "" #~ msgid ":index:`cleanContents` -- :meth:`Page.clean_contents`" #~ msgstr "" #~ msgid ":index:`clearWith` -- :meth:`Pixmap.clear_with`" #~ msgstr "" #~ msgid ":index:`convertToPDF` -- :meth:`Document.convert_to_pdf`" #~ msgstr "" #~ msgid ":index:`copyPage` -- :meth:`Document.copy_page`" #~ msgstr "" #~ msgid ":index:`copyPixmap` -- :meth:`Pixmap.copy`" #~ msgstr "" #~ msgid ":index:`CropBox` -- :attr:`Page.cropbox`" #~ msgstr "" #~ msgid ":index:`CropBoxPosition` -- :attr:`Page.cropbox_position`" #~ msgstr "" #~ msgid ":index:`deleteAnnot` -- :meth:`Page.delete_annot`" #~ msgstr "" #~ msgid ":index:`deleteLink` -- :meth:`Page.delete_link`" #~ msgstr "" #~ msgid ":index:`deletePage` -- :meth:`Document.delete_page`" #~ msgstr "" #~ msgid ":index:`deletePageRange` -- :meth:`Document.delete_pages`" #~ msgstr "" #~ msgid ":index:`deleteWidget` -- :meth:`Page.delete_widget`" #~ msgstr "" #~ msgid ":index:`derotationMatrix` -- :attr:`Page.derotation_matrix`" #~ msgstr "" #~ msgid ":index:`drawBezier` -- :meth:`Page.draw_bezier`" #~ msgstr "" #~ msgid ":index:`drawBezier` -- :meth:`Shape.draw_bezier`" #~ msgstr "" #~ msgid ":index:`drawCircle` -- :meth:`Page.draw_circle`" #~ msgstr "" #~ msgid ":index:`drawCircle` -- :meth:`Shape.draw_circle`" #~ msgstr "" #~ msgid ":index:`drawCurve` -- :meth:`Page.draw_curve`" #~ msgstr "" #~ msgid ":index:`drawCurve` -- :meth:`Shape.draw_curve`" #~ msgstr "" #~ msgid ":index:`drawLine` -- :meth:`Page.draw_line`" #~ msgstr "" #~ msgid ":index:`drawLine` -- :meth:`Shape.draw_line`" #~ msgstr "" #~ msgid ":index:`drawOval` -- :meth:`Page.draw_oval`" #~ msgstr "" #~ msgid ":index:`drawOval` -- :meth:`Shape.draw_oval`" #~ msgstr "" #~ msgid ":index:`drawPolyline` -- :meth:`Page.draw_polyline`" #~ msgstr "" #~ msgid ":index:`drawPolyline` -- :meth:`Shape.draw_polyline`" #~ msgstr "" #~ msgid ":index:`drawQuad` -- :meth:`Page.draw_quad`" #~ msgstr "" #~ msgid ":index:`drawQuad` -- :meth:`Shape.draw_quad`" #~ msgstr "" #~ msgid ":index:`drawRect` -- :meth:`Page.draw_rect`" #~ msgstr "" #~ msgid ":index:`drawRect` -- :meth:`Shape.draw_rect`" #~ msgstr "" #~ msgid ":index:`drawSector` -- :meth:`Page.draw_sector`" #~ msgstr "" #~ msgid ":index:`drawSector` -- :meth:`Shape.draw_sector`" #~ msgstr "" #~ msgid ":index:`drawSquiggle` -- :meth:`Page.draw_squiggle`" #~ msgstr "" #~ msgid ":index:`drawSquiggle` -- :meth:`Shape.draw_squiggle`" #~ msgstr "" #~ msgid ":index:`drawZigzag` -- :meth:`Page.draw_zigzag`" #~ msgstr "" #~ msgid ":index:`drawZigzag` -- :meth:`Shape.draw_zigzag`" #~ msgstr "" #~ msgid ":index:`embeddedFileAdd` -- :meth:`Document.embfile_add`" #~ msgstr "" #~ msgid ":index:`embeddedFileCount` -- :meth:`Document.embfile_count`" #~ msgstr "" #~ msgid ":index:`embeddedFileDel` -- :meth:`Document.embfile_del`" #~ msgstr "" #~ msgid ":index:`embeddedFileGet` -- :meth:`Document.embfile_get`" #~ msgstr "" #~ msgid ":index:`embeddedFileInfo` -- :meth:`Document.embfile_info`" #~ msgstr "" #~ msgid ":index:`embeddedFileNames` -- :meth:`Document.embfile_names`" #~ msgstr "" #~ msgid ":index:`embeddedFileUpd` -- :meth:`Document.embfile_upd`" #~ msgstr "" #~ msgid ":index:`extractFont` -- :meth:`Document.extract_font`" #~ msgstr "" #~ msgid ":index:`extractImage` -- :meth:`Document.extract_image`" #~ msgstr "" #~ msgid ":index:`fileGet` -- :meth:`Annot.get_file`" #~ msgstr "" #~ msgid ":index:`fileUpd` -- :meth:`Annot.update_file`" #~ msgstr "" #~ msgid ":index:`fillTextbox` -- :meth:`TextWriter.fill_textbox`" #~ msgstr "" #~ msgid ":index:`findBookmark` -- :meth:`Document.find_bookmark`" #~ msgstr "" #~ msgid ":index:`firstAnnot` -- :attr:`Page.first_annot`" #~ msgstr "" #~ msgid ":index:`firstLink` -- :attr:`Page.first_link`" #~ msgstr "" #~ msgid ":index:`firstWidget` -- :attr:`Page.first_widget`" #~ msgstr "" #~ msgid ":index:`fullcopyPage` -- :meth:`Document.fullcopy_page`" #~ msgstr "" #~ msgid ":index:`gammaWith` -- :meth:`Pixmap.gamma_with`" #~ msgstr "" #~ msgid ":index:`getArea` -- :meth:`Rect.get_area`" #~ msgstr "" #~ msgid ":index:`getArea` -- :meth:`IRect.get_area`" #~ msgstr "" #~ msgid ":index:`getCharWidths` -- :meth:`Document.get_char_widths`" #~ msgstr "" #~ msgid ":index:`getContents` -- :meth:`Page.get_contents`" #~ msgstr "" #~ msgid ":index:`getDisplayList` -- :meth:`Page.get_displaylist`" #~ msgstr "" #~ msgid ":index:`getDrawings` -- :meth:`Page.get_drawings`" #~ msgstr "" #~ msgid ":index:`getFontList` -- :meth:`Page.get_fonts`" #~ msgstr "" #~ msgid ":index:`getImageBbox` -- :meth:`Page.get_image_bbox`" #~ msgstr "" #~ msgid ":index:`getImageData` -- :meth:`Pixmap.tobytes`" #~ msgstr "" #~ msgid ":index:`getImageList` -- :meth:`Page.get_images`" #~ msgstr "" #~ msgid ":index:`getLinks` -- :meth:`Page.get_links`" #~ msgstr "" #~ msgid ":index:`getOCGs` -- :meth:`Document.get_ocgs`" #~ msgstr "" #~ msgid ":index:`getPageFontList` -- :meth:`Document.get_page_fonts`" #~ msgstr "" #~ msgid ":index:`getPageImageList` -- :meth:`Document.get_page_images`" #~ msgstr "" #~ msgid ":index:`getPagePixmap` -- :meth:`Document.get_page_pixmap`" #~ msgstr "" #~ msgid ":index:`getPageText` -- :meth:`Document.get_page_text`" #~ msgstr "" #~ msgid ":index:`getPageXObjectList` -- :meth:`Document.get_page_xobjects`" #~ msgstr "" #~ msgid ":index:`getPDFnow` -- :meth:`get_pdf_now`" #~ msgstr "" #~ msgid ":index:`getPDFstr` -- :meth:`get_pdf_str`" #~ msgstr "" #~ msgid ":index:`getPixmap` -- :meth:`Page.get_pixmap`" #~ msgstr "" #~ msgid ":index:`getPixmap` -- :meth:`Annot.get_pixmap`" #~ msgstr "" #~ msgid ":index:`getPixmap` -- :meth:`DisplayList.get_pixmap`" #~ msgstr "" #~ msgid ":index:`getPNGData` -- :meth:`Pixmap.tobytes`" #~ msgstr "" #~ msgid ":index:`getPNGdata` -- :meth:`Pixmap.tobytes`" #~ msgstr "" #~ msgid ":index:`getRectArea` -- :meth:`Rect.get_area`" #~ msgstr "" #~ msgid ":index:`getRectArea` -- :meth:`IRect.get_area`" #~ msgstr "" #~ msgid ":index:`getSigFlags` -- :meth:`Document.get_sigflags`" #~ msgstr "" #~ msgid ":index:`getSVGimage` -- :meth:`Page.get_svg_image`" #~ msgstr "" #~ msgid ":index:`getText` -- :meth:`Page.get_text`" #~ msgstr "" #~ msgid ":index:`getText` -- :meth:`Annot.get_text`" #~ msgstr "" #~ msgid ":index:`getTextBlocks` -- :meth:`Page.get_text_blocks`" #~ msgstr "" #~ msgid ":index:`getTextbox` -- :meth:`Page.get_textbox`" #~ msgstr "" #~ msgid ":index:`getTextbox` -- :meth:`Annot.get_textbox`" #~ msgstr "" #~ msgid ":index:`getTextLength` -- :meth:`get_text_length`" #~ msgstr "" #~ msgid ":index:`getTextPage` -- :meth:`Page.get_textpage`" #~ msgstr "" #~ msgid ":index:`getTextPage` -- :meth:`Annot.get_textpage`" #~ msgstr "" #~ msgid ":index:`getTextPage` -- :meth:`DisplayList.get_textpage`" #~ msgstr "" #~ msgid ":index:`getTextWords` -- :meth:`Page.get_text_words`" #~ msgstr "" #~ msgid ":index:`getToC` -- :meth:`Document.get_toc`" #~ msgstr "" #~ msgid ":index:`getXmlMetadata` -- :meth:`Document.get_xml_metadata`" #~ msgstr "" #~ msgid ":index:`ImageProperties` -- :meth:`image_properties`" #~ msgstr "" #~ msgid ":index:`includePoint` -- :meth:`Rect.include_point`" #~ msgstr "" #~ msgid ":index:`includePoint` -- :meth:`IRect.include_point`" #~ msgstr "" #~ msgid ":index:`includeRect` -- :meth:`Rect.include_rect`" #~ msgstr "" #~ msgid ":index:`includeRect` -- :meth:`IRect.include_rect`" #~ msgstr "" #~ msgid ":index:`insertFont` -- :meth:`Page.insert_font`" #~ msgstr "" #~ msgid ":index:`insertImage` -- :meth:`Page.insert_image`" #~ msgstr "" #~ msgid ":index:`insertLink` -- :meth:`Page.insert_link`" #~ msgstr "" #~ msgid ":index:`insertPage` -- :meth:`Document.insert_page`" #~ msgstr "" #~ msgid ":index:`insertPDF` -- :meth:`Document.insert_pdf`" #~ msgstr "" #~ msgid ":index:`insertText` -- :meth:`Page.insert_text`" #~ msgstr "" #~ msgid ":index:`insertText` -- :meth:`Shape.insert_text`" #~ msgstr "" #~ msgid ":index:`insertTextbox` -- :meth:`Page.insert_textbox`" #~ msgstr "" #~ msgid ":index:`insertTextbox` -- :meth:`Shape.insert_textbox`" #~ msgstr "" #~ msgid ":index:`invertIRect` -- :meth:`Pixmap.invert_irect`" #~ msgstr "" #~ msgid ":index:`isConvex` -- :attr:`Quad.is_convex`" #~ msgstr "" #~ msgid ":index:`isDirty` -- :attr:`Document.is_dirty`" #~ msgstr "" #~ msgid ":index:`isEmpty` -- :attr:`Rect.is_empty`" #~ msgstr "" #~ msgid ":index:`isEmpty` -- :attr:`IRect.is_empty`" #~ msgstr "" #~ msgid ":index:`isEmpty` -- :attr:`Quad.is_empty`" #~ msgstr "" #~ msgid ":index:`isFormPDF` -- :attr:`Document.is_form_pdf`" #~ msgstr "" #~ msgid ":index:`isInfinite` -- :attr:`Rect.is_infinite`" #~ msgstr "" #~ msgid ":index:`isInfinite` -- :attr:`IRect.is_infinite`" #~ msgstr "" #~ msgid ":index:`isPDF` -- :attr:`Document.is_pdf`" #~ msgstr "" #~ msgid ":index:`isRectangular` -- :attr:`Quad.is_rectangular`" #~ msgstr "" #~ msgid ":index:`isRectilinear` -- :attr:`Matrix.is_rectilinear`" #~ msgstr "" #~ msgid ":index:`isReflowable` -- :attr:`Document.is_reflowable`" #~ msgstr "" #~ msgid ":index:`isRepaired` -- :attr:`Document.is_repaired`" #~ msgstr "" #~ msgid ":index:`isStream` -- :meth:`Document.is_stream`" #~ msgstr "" #~ msgid ":index:`lastLocation` -- :attr:`Document.last_location`" #~ msgstr "" #~ msgid ":index:`lineEnds` -- :attr:`Annot.line_ends`" #~ msgstr "" #~ msgid ":index:`loadAnnot` -- :meth:`Page.load_annot`" #~ msgstr "" #~ msgid ":index:`loadLinks` -- :meth:`Page.load_links`" #~ msgstr "" #~ msgid ":index:`loadPage` -- :meth:`Document.load_page`" #~ msgstr "" #~ msgid ":index:`makeBookmark` -- :meth:`Document.make_bookmark`" #~ msgstr "" #~ msgid ":index:`MediaBox` -- :attr:`Page.mediabox`" #~ msgstr "" #~ msgid ":index:`MediaBoxSize` -- :attr:`Page.mediabox_size`" #~ msgstr "" #~ msgid ":index:`metadataXML` -- :meth:`Document.xref_xml_metadata`" #~ msgstr "" #~ msgid ":index:`movePage` -- :meth:`Document.move_page`" #~ msgstr "" #~ msgid ":index:`needsPass` -- :attr:`Document.needs_pass`" #~ msgstr "" #~ msgid ":index:`newPage` -- :meth:`Document.new_page`" #~ msgstr "" #~ msgid ":index:`newShape` -- :meth:`Page.new_shape`" #~ msgstr "" #~ msgid ":index:`nextLocation` -- :meth:`Document.next_location`" #~ msgstr "" #~ msgid ":index:`pageCount` -- :attr:`Document.page_count`" #~ msgstr "" #~ msgid ":index:`pageCropBox` -- :meth:`Document.page_cropbox`" #~ msgstr "" #~ msgid ":index:`pageXref` -- :meth:`Document.page_xref`" #~ msgstr "" #~ msgid ":index:`PaperRect` -- :meth:`paper_rect`" #~ msgstr "" #~ msgid ":index:`PaperSize` -- :meth:`paper_size`" #~ msgstr "" #~ msgid ":index:`paperSizes` -- :attr:`paper_sizes`" #~ msgstr "" #~ msgid ":index:`PDFCatalog` -- :meth:`Document.pdf_catalog`" #~ msgstr "" #~ msgid ":index:`PDFTrailer` -- :meth:`Document.pdf_trailer`" #~ msgstr "" #~ msgid ":index:`pillowData` -- :meth:`Pixmap.pil_tobytes`" #~ msgstr "" #~ msgid ":index:`pillowWrite` -- :meth:`Pixmap.pil_save`" #~ msgstr "" #~ msgid ":index:`planishLine` -- :meth:`planish_line`" #~ msgstr "" #~ msgid ":index:`preRotate` -- :meth:`Matrix.prerotate`" #~ msgstr "" #~ msgid ":index:`preScale` -- :meth:`Matrix.prescale`" #~ msgstr "" #~ msgid ":index:`preShear` -- :meth:`Matrix.preshear`" #~ msgstr "" #~ msgid ":index:`preTranslate` -- :meth:`Matrix.pretranslate`" #~ msgstr "" #~ msgid ":index:`previousLocation` -- :meth:`Document.prev_location`" #~ msgstr "" #~ msgid ":index:`readContents` -- :meth:`Page.read_contents`" #~ msgstr "" #~ msgid ":index:`resolveLink` -- :meth:`Document.resolve_link`" #~ msgstr "" #~ msgid ":index:`rotationMatrix` -- :attr:`Page.rotation_matrix`" #~ msgstr "" #~ msgid ":index:`searchFor` -- :meth:`Page.search_for`" #~ msgstr "" #~ msgid ":index:`searchPageFor` -- :meth:`Document.search_page_for`" #~ msgstr "" #~ msgid ":index:`setAlpha` -- :meth:`Pixmap.set_alpha`" #~ msgstr "" #~ msgid ":index:`setBlendMode` -- :meth:`Annot.set_blendmode`" #~ msgstr "" #~ msgid ":index:`setBorder` -- :meth:`Annot.set_border`" #~ msgstr "" #~ msgid ":index:`setColors` -- :meth:`Annot.set_colors`" #~ msgstr "" #~ msgid ":index:`setCropBox` -- :meth:`Page.set_cropbox`" #~ msgstr "" #~ msgid ":index:`setFlags` -- :meth:`Annot.set_flags`" #~ msgstr "" #~ msgid ":index:`setInfo` -- :meth:`Annot.set_info`" #~ msgstr "" #~ msgid ":index:`setLanguage` -- :meth:`Document.set_language`" #~ msgstr "" #~ msgid ":index:`setLineEnds` -- :meth:`Annot.set_line_ends`" #~ msgstr "" #~ msgid ":index:`setMediaBox` -- :meth:`Page.set_mediabox`" #~ msgstr "" #~ msgid ":index:`setMetadata` -- :meth:`Document.set_metadata`" #~ msgstr "" #~ msgid ":index:`setName` -- :meth:`Annot.set_name`" #~ msgstr "" #~ msgid ":index:`setOC` -- :meth:`Annot.set_oc`" #~ msgstr "" #~ msgid ":index:`setOpacity` -- :meth:`Annot.set_opacity`" #~ msgstr "" #~ msgid ":index:`setOrigin` -- :meth:`Pixmap.set_origin`" #~ msgstr "" #~ msgid ":index:`setPixel` -- :meth:`Pixmap.set_pixel`" #~ msgstr "" #~ msgid ":index:`setRect` -- :meth:`Annot.set_rect`" #~ msgstr "" #~ msgid ":index:`setRect` -- :meth:`Pixmap.set_rect`" #~ msgstr "" #~ msgid ":index:`setResolution` -- :meth:`Pixmap.set_dpi`" #~ msgstr "" #~ msgid ":index:`setRotation` -- :meth:`Page.set_rotation`" #~ msgstr "" #~ msgid ":index:`setToC` -- :meth:`Document.set_toc`" #~ msgstr "" #~ msgid ":index:`setXmlMetadata` -- :meth:`Document.set_xml_metadata`" #~ msgstr "" #~ msgid ":index:`showPDFpage` -- :meth:`Page.show_pdf_page`" #~ msgstr "" #~ msgid ":index:`soundGet` -- :meth:`Annot.get_sound`" #~ msgstr "" #~ msgid ":index:`tintWith` -- :meth:`Pixmap.tint_with`" #~ msgstr "" #~ msgid ":index:`transformationMatrix` -- :attr:`Page.transformation_matrix`" #~ msgstr "" #~ msgid ":index:`updateLink` -- :meth:`Page.update_link`" #~ msgstr "" #~ msgid ":index:`updateObject` -- :meth:`Document.update_object`" #~ msgstr "" #~ msgid ":index:`updateStream` -- :meth:`Document.update_stream`" #~ msgstr "" #~ msgid ":index:`wrapContents` -- :meth:`Page.wrap_contents`" #~ msgstr "" #~ msgid ":index:`writeImage` -- :meth:`Pixmap.save`" #~ msgstr "" #~ msgid ":index:`writePNG` -- :meth:`Pixmap.save`" #~ msgstr "" #~ msgid ":index:`writeText` -- :meth:`Page.write_text`" #~ msgstr "" #~ msgid ":index:`writeText` -- :meth:`TextWriter.write_text`" #~ msgstr "" #~ msgid ":index:`xrefLength` -- :meth:`Document.xref_length`" #~ msgstr "" #~ msgid ":index:`xrefObject` -- :meth:`Document.xref_object`" #~ msgstr "" #~ msgid ":index:`xrefStream` -- :meth:`Document.xref_stream`" #~ msgstr "" #~ msgid ":index:`xrefStreamRaw` -- :meth:`Document.xref_stream_raw`" #~ msgstr "" #~ msgid "Discord logo" #~ msgstr "" ================================================ FILE: docs/locales/ko/.readthedocs.yaml ================================================ # .readthedocs.yaml # Note: We use this dedicated yaml inside the locales/ko folder as RTD was having problems building a PDF # This yaml is the same as the main one - it just removes the PDF build option # Required version: 2 # Set the version of Python and other tools you might need build: os: ubuntu-20.04 tools: python: "3.9" # You can also specify other tool versions: # nodejs: "16" # rust: "1.55" # golang: "1.17" # Build documentation in the docs/ directory with Sphinx sphinx: configuration: docs/conf.py # Optionally declare the Python requirements required to build your docs python: install: - requirements: docs/requirements.txt ================================================ FILE: docs/locales/ko/LC_MESSAGES/404.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header-404.rst:-1 a1916335a5274785a49dd5e339d92fe7 msgid "Artifex" msgstr "Artifex" #: ../../header-404.rst:-1 5d84ec96284f4e3f94e9c1b238269f04 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header-404.rst:-1 4576f08a21cd47f79352fb20f6583d87 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../404.rst:4 924f32c8351f4a62978ec14c16c351b5 msgid "404!" msgstr "404!" #: ../../404.rst:7 6d3e16ada64f4502aa193e221a595c34 msgid "**This page is not available.**" msgstr "**이 페이지를 사용할 수 없습니다.**" #: ../../404.rst:10 dbddaa0e43f144ebbea819e2466410b9 msgid "Please use the menu or search to find what you are looking for." msgstr "메뉴 또는 검색을 사용하여 찾고 있는 내용을 검색해 주세요." #: ../../footer.rst:46 a4c037a234b44cbe8461dba8e47036a1 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/about-feature-matrix.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ko/LC_MESSAGES/about-performance.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ko/LC_MESSAGES/about.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f19dada9348f4b02a8e7f37161295aed msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 3a2fd52dfdbe4ef0ba2277d3dc5ce9cd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 6457f182efd342f9971c29ded21b19cd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../about.rst:10 6bf350a1548242f08f4231816b75ae9e msgid "Features Comparison" msgstr "기능 비교" #: ../../about.rst:16 e6e0680f36684a24b35c48e7756b8ee2 msgid "Feature Matrix" msgstr "기능 비교표" #: ../../about.rst:18 fdad9ebd21e342da9d1b6b35ca5ad4e9 msgid "" "The following table illustrates how |PyMuPDF| compares with other typical" " solutions." msgstr "다음 표는 |PyMuPDF| 가 다른 일반적인 솔루션과 어떻게 비교되는지 보여줍니다." #: ../../about.rst:47 5f1d6f3b09ac43e1ae7043dc7a879c02 msgid "" "A note about **Office** document types (DOCX, XLXS, PPTX) and **Hangul** " "documents (HWPX). These documents can be loaded into |PyMuPDF| and you " "will receive a :ref:`Document ` object." msgstr "**Office** 문서 유형(DOCX, XLXS, PPTX) 및 **한글** 문서(HWPX)에 대한 참고사항입니다. 이러한 문서는 |PyMuPDF| 에 로드할 수 있으며 :ref:`Document ` 객체를 받게 됩니다." #: ../../about.rst:49 9add749bf1d7451aabfcb79190677ddb msgid "There are some caveats:" msgstr "다음과 같은 주의사항이 있습니다:" #: ../../about.rst:52 a610a8b3f5cf4333938a9e7a75157f1d msgid "we convert the input to **HTML** to layout the content." msgstr "내용을 배치하기 위해 입력을 **HTML** 로 변환합니다." #: ../../about.rst:53 a71abef4bb604e3b8f1065200afb7907 msgid "because of this the original page separation has gone." msgstr "이로 인해 원본 페이지 구분이 사라집니다." #: ../../about.rst:55 255d6618e34f4f11ae7a1a0f54f57322 msgid "" "When saving out the result any faithful representation of the original " "layout cannot be expected." msgstr "결과를 저장할 때 원본 레이아웃의 정확한 표현을 기대할 수 없습니다." #: ../../about.rst:57 59954cbab9914471b64ad43b7eb7a58b msgid "" "Therefore input files are mostly in a form that's useful for text " "extraction." msgstr "따라서 입력 파일은 주로 텍스트 추출에 유용한 형태입니다." #: ../../about.rst:65 f3ad21fdc6c841f090824af510994edb msgid "Performance" msgstr "성능" #: ../../about.rst:69 482ba1a4696f429da50d900517f9001b msgid "" "To benchmark |PyMuPDF| performance against a range of tasks a test suite " "with a fixed set of :ref:`8 PDFs with a total of 7,031 " "pages` containing text & images is used to obtain " "performance timings." msgstr "다양한 작업에 대해 |PyMuPDF| 성능을 벤치마크하기 위해 텍스트와 이미지가 포함된 :ref:`총 7,031페이지의 8개 PDF 파일` 로 구성된 고정된 테스트 스위트를 사용하여 성능 타이밍을 측정합니다." #: ../../about.rst:72 11c5e7e482204c7682f05223297c6488 msgid "Here are current results, grouped by task:" msgstr "다음은 작업별로 그룹화된 현재 결과입니다:" #: ../../about.rst:81 9f36f4db74ab492ba26cc4fb9946f818 msgid "" "For more detail regarding the methodology for these performance timings " "see: :ref:`Performance Comparison Methodology`." msgstr "이러한 성능 타이밍 방법론에 대한 자세한 내용은 :ref:`성능 비교 방법론` 을 참조하세요." #: ../../about.rst:89 e86ca33131a544e8a4cc0821737a9a86 msgid "License and Copyright" msgstr "라이선스 및 저작권" #: ../../about.rst:93 061c6a01a19c40198fd34033af39cc6d msgid "" "|PyMuPDF| and |MuPDF| are now available under both, open-source |AGPL| " "and commercial license agreements. Please read the full text of the " "|AGPL| license agreement, available in the distribution material (file " "COPYING) and `on the GNU license page " "`_, to ensure that your use " "case complies with the guidelines of the license. If you determine you " "cannot meet the requirements of the |AGPL|, please contact `Artifex " "`_ for more information " "regarding a commercial license." msgstr "|PyMuPDF| 와 |MuPDF| 는 이제 오픈소스 |AGPL| 및 상용 라이선스 계약 모두에서 사용할 수 있습니다. 사용 사례가 라이선스 지침을 준수하는지 확인하려면 배포 자료(COPYING 파일) 및 `GNU 라이선스 페이지 `_ 에서 제공되는 |AGPL| 라이선스 계약 전문을 읽어보세요. |AGPL| 의 요구사항을 충족할 수 없다고 판단되는 경우, 상용 라이선스에 대한 자세한 정보는 `Artifex `_ 에 문의하세요." #: ../../about.rst:111 0cf7adfbbbe6404aae5016ba8cf4ca79 msgid "" ":title:`Artifex` is the exclusive commercial licensing agent for " ":title:`MuPDF`." msgstr ":title:`Artifex` 는 :title:`MuPDF` 의 독점 상용 라이선스 대리인입니다." #: ../../about.rst:113 1206bde366264e91900de44a990e7b13 msgid "" ":title:`Artifex`, the :title:`Artifex` logo, :title:`MuPDF`, and the " ":title:`MuPDF` logo are registered trademarks of :title:`Artifex Software" " Inc.`" msgstr ":title:`Artifex`, :title:`Artifex` 로고, :title:`MuPDF`, :title:`MuPDF` 로고는 :title:`Artifex Software Inc.` 의 등록 상표입니다." #: ../../version.rst:1 b23f02d66d164eb195ed6512c8e9ff6c msgid "This documentation covers PyMuPDF |version|." msgstr "이 문서는 PyMuPDF |version| 을 다룹니다." #: ../../version.rst:3 ca881a8c265b46618c644701ea14c695 msgid "" "The major and minor versions of PyMuPDF and MuPDF will always be the " "same. Only the third qualifier (patch level) may deviate from that of " "MuPDF." msgstr "PyMuPDF와 MuPDF의 주 버전과 부 버전은 항상 동일합니다. 세 번째 한정자(패치 레벨)만 |MuPDF| 와 다를 수 있습니다." #: ../../version.rst:5 a91d12805e42498fb4eebcb3f7923eb8 msgid "" "Typically PyMuPDF is released more frequently than MuPDF so it will often" " be the case that the patch level of PyMuPDF will be greater than the " "embedded MuPDF." msgstr "일반적으로 PyMuPDF는 MuPDF보다 더 자주 릴리스되므로, PyMuPDF의 패치 레벨이 내장된 MuPDF보다 높은 경우가 많습니다." #: ../../version.rst:9 2e3b5e5955fc4cba8aafc25d3d650e7a msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2." msgstr "예를 들어 PyMuPDF-1.24.5는 MuPDF-1.24.2를 포함합니다." #: ../../version.rst:11 a60af2aa03494194b19ecf8e3bc095fc msgid "Also see `pymupdf_version` and `mupdf_version`." msgstr "`pymupdf_version` 및 `mupdf_version` 도 참조하세요." #: ../../footer.rst:48 ea2d1136af82416baa3286db6ed38f96 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." #~ msgid "" #~ "The major and minor versions of " #~ "|PyMuPDF| and |MuPDF| will always be " #~ "the same. Only the third qualifier " #~ "(patch level) may deviate from that " #~ "of |MuPDF|." #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/algebra.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 1f5ba5d56ddc4a2fa55079bc44f7d2c1 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 03f8222493784e3ca314d8d7abdaff0a msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 e6cbb920023f4b0992f996b108924b94 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../algebra.rst:6 920754cf16444314b9c46d86f31b0f00 msgid "Operator Algebra for Geometry Objects" msgstr "기하 객체를 위한 연산자 대수" #: ../../algebra.rst:10 dec854bb55b9478eb8cc515d6eaca329 msgid "" "Instances of classes :ref:`Point`, :ref:`IRect`, :ref:`Rect`, :ref:`Quad`" " and :ref:`Matrix` are collectively also called \"geometry\" objects." msgstr ":ref:`Point`, :ref:`IRect`, :ref:`Rect`, :ref:`Quad`, :ref:`Matrix` 클래스의 인스턴스는 집합적으로 \"geometry\" 객체라고도 합니다." #: ../../algebra.rst:12 d199f8882c174dcea71374e8d9993b56 msgid "" "They all are special cases of Python sequences, see :ref:`SequenceTypes` " "for more background." msgstr "모두 Python 시퀀스의 특수한 경우입니다. 자세한 내용은 :ref:`SequenceTypes` 를 참조하세요." #: ../../algebra.rst:14 122aaf19e93244b3a259c46eacf945b1 msgid "" "We have defined operators for these classes that allow dealing with them " "(almost) like ordinary numbers in terms of addition, subtraction, " "multiplication, division, and some others." msgstr "이 클래스들에 대해 덧셈, 뺄셈, 곱셈, 나눗셈 및 기타 연산에서 일반 숫자처럼(거의) 다룰 수 있도록 연산자를 정의했습니다." #: ../../algebra.rst:16 84183cdd392441e182408f158d85ab50 msgid "This chapter is a synopsis of what is possible." msgstr "이 장은 가능한 작업의 요약입니다." #: ../../algebra.rst:19 e8894b34cabf472ea53483bffb05e53d msgid "General Remarks" msgstr "일반적인 설명" #: ../../algebra.rst:20 0934454c0329461698c27169858d0afb msgid "" "Operators can be either **binary** (i.e. involving two objects) or " "**unary**." msgstr "연산자는 **이항** (즉, 두 객체를 포함) 또는 **단항** 일 수 있습니다." #: ../../algebra.rst:22 68b04e12599f4ce6a527b3d5f4d358aa msgid "" "The resulting type of **binary** operations is either a **new object of " "the left operand's class,** a bool or (for dot products) a float." msgstr "**이항** 연산의 결과 유형은 **왼쪽 피연산자 클래스의 새 객체**, bool 또는(내적의 경우) float입니다." #: ../../algebra.rst:24 b5bdf8532fed412092362d18eeb3dbcd msgid "" "The result of **unary** operations is either a **new object** of the same" " class, a bool or a float." msgstr "**단항** 연산의 결과는 동일한 클래스의 **새 객체**, bool 또는 float입니다." #: ../../algebra.rst:26 c6550b01d863415293570f3c92bcab4f msgid "" "The binary operators `+, -, *, /` are defined for all classes. They " "*roughly* do what you would expect -- **except, that the second operand " "...**" msgstr "이항 연산자 `+, -, *, /` 는 모든 클래스에 대해 정의됩니다. 대략 예상대로 동작합니다 -- **단, 두 번째 피연산자는 ...**" #: ../../algebra.rst:28 55195cd58e234294875781acefaa545e msgid "" "may always be a number which then performs the operation on every " "component of the first one," msgstr "항상 숫자일 수 있으며, 그러면 첫 번째 피연산자의 모든 구성 요소에 대해 연산을 수행합니다," #: ../../algebra.rst:29 128012698aa343409977ea7e41b35276 msgid "" "may always be a numeric sequence of the same length (2, 4 or 6) -- we " "call such sequences :data:`point_like`, :data:`rect_like`, " ":data:`quad_like` or :data:`matrix_like`, respectively." msgstr "항상 동일한 길이(2, 4 또는 6)의 숫자 시퀀스일 수 있습니다 -- 이러한 시퀀스를 각각 :data:`point_like`, :data:`rect_like`, :data:`quad_like` 또는 :data:`matrix_like` 라고 합니다." #: ../../algebra.rst:31 c34b1b77d5ad43c7adc65443468f835d msgid "" "Rectangles support **additional binary** operations: **intersection** " "(operator `\"&\"`), **union** (operator `\"|\"`) and **containment** " "checking." msgstr "사각형은 **추가 이항** 연산을 지원합니다: **교집합** (연산자 `\"&\"`), **합집합** (연산자 `\"|\"`) 및 **포함** 확인." #: ../../algebra.rst:33 25ac1658fe1042febe1cabd928b67c0c msgid "" "Binary operators fully support in-place operations. So if \"°\" is a " "binary operator then the expression `a °= b` is always valid and the same" " as `a = a ° b`. Therefore, be careful and do **not** do `p1 *= p2` for " "two points, because thereafter \"p1\" is a **float**." msgstr "이항 연산자는 제자리 연산을 완전히 지원합니다. 따라서 \"°\"가 이항 연산자이면 표현식 `a °= b` 는 항상 유효하며 `a = a ° b` 와 동일합니다. 따라서 두 점에 대해 `p1 *= p2` 를 **하지 마세요**. 그 후 \"p1\"은 **float** 가 됩니다." #: ../../algebra.rst:37 a3178a19dae843a2a0d880ab3d29b924 msgid "Unary Operations" msgstr "단항 연산" #: ../../algebra.rst:40 ../../algebra.rst:59 49cce5653ff84ecd9e947c39e0d07c87 #: c3820b716a6d44b1be18f6133e3b4589 msgid "Oper." msgstr "연산" #: ../../algebra.rst:40 ../../algebra.rst:59 69b612ab28c5403698b26e70c7342e08 #: a4d6a4f7e8074daf86d9c71f76c15e3c msgid "Result" msgstr "결과" #: ../../algebra.rst:42 bd8aa928700f4d6da33517c5c44f92d1 msgid "bool(OBJ)" msgstr "bool(OBJ)" #: ../../algebra.rst:42 3944ae985d32466ba96b36a9d164d059 msgid "is false exactly if all components of OBJ are zero" msgstr "OBJ의 모든 구성 요소가 0인 경우에만 false" #: ../../algebra.rst:43 77ef179dc26548b3afe5aab5973b1ad3 msgid "abs(OBJ)" msgstr "abs(OBJ)" #: ../../algebra.rst:43 c040cb90c08c4c24ab34fca940e7a5d3 msgid "the rectangle area -- equal to norm(OBJ) for the other types" msgstr "사각형 영역 -- 다른 유형의 경우 norm(OBJ)와 동일" #: ../../algebra.rst:44 8e3b6dc21657411cb9b9aec339f7b58b msgid "norm(OBJ)" msgstr "norm(OBJ)" #: ../../algebra.rst:44 101cabdb07cc4340a520f882a1412565 msgid "square root of the component squares (Euclidean norm)" msgstr "구성 요소 제곱의 제곱근(유클리드 노름)" #: ../../algebra.rst:45 7dcf68ad8af544e4ab89a8fb9b2e127f msgid "+OBJ" msgstr "+OBJ" #: ../../algebra.rst:45 bb51eef23c134b9abcde315903ab5fa9 msgid "new copy of OBJ" msgstr "OBJ의 새 복사본" #: ../../algebra.rst:46 fbe1c96a611b41cdbdd3c8fd57b6cffd msgid "-OBJ" msgstr "-OBJ" #: ../../algebra.rst:46 bf0e072e4b3b4682b53d14c5d564d191 msgid "new copy of OBJ with negated components" msgstr "부정된 구성 요소를 가진 OBJ의 새 복사본" #: ../../algebra.rst:47 41d625338bff4d5bba38dc17591c1cd4 msgid "~m" msgstr "~m" #: ../../algebra.rst:47 e461d45306e940efa0e6c12f0b3a0001 msgid "inverse of matrix \"m\", or the null matrix if not invertible" msgstr "행렬 \"m\"의 역행렬, 또는 역행렬이 없으면 null 행렬" #: ../../algebra.rst:52 6dee1ec3dcbd4abfb2a10eb496fd0db8 msgid "Binary Operations" msgstr "이항 연산" #: ../../algebra.rst:53 77bb8041546c4d36b40997f8dc509039 msgid "" "These are expressions like `a ° b` where \"°\" is any of the operators " "`+, -, *, /`. Also binary operations are expressions of the form `a == b`" " and `b in a`." msgstr "이것들은 \"°\"가 연산자 `+, -, *, /` 중 하나인 `a ° b` 와 같은 표현식입니다. 또한 이항 연산은 `a == b` 및 `b in a` 형식의 표현식입니다." #: ../../algebra.rst:55 665cd59a262c4131b350a1640ca2f42c msgid "" "If \"b\" is a number, then the respective operation is executed for each " "component of \"a\". Otherwise, if \"b\" is **not a number,** then the " "following happens:" msgstr "\"b\"가 숫자이면 각 구성 요소에 대해 해당 연산이 실행됩니다. 그렇지 않고 \"b\"가 **숫자가 아니면** 다음이 발생합니다:" #: ../../algebra.rst:61 b25c4a3c6bc2413ea4202520e62172d8 msgid "a+b, a-b" msgstr "a+b, a-b" #: ../../algebra.rst:61 bf714007cfab424dbe07b769f64b1915 msgid "component-wise execution, \"b\" must be \"a-like\"." msgstr "구성 요소별 실행, \"b\"는 \"a-like\"여야 합니다." #: ../../algebra.rst:62 80c4437403a149669f5a019a372b05a9 msgid "a*m, a/m" msgstr "a*m, a/m" #: ../../algebra.rst:62 9c7dff332f5a488587e7031c72f8a13a msgid "" "\"a\" can be a point, rectangle or matrix and \"m\" is a " ":data:`matrix_like`. *\"a/m\"* is treated as *\"a*~m\"* (see note below " "for non-invertible matrices). If \"a\" is a **point** or a **rectangle**," " then *\"a.transform(m)\"* is executed. If \"a\" is a matrix, then matrix" " concatenation takes place." msgstr "\"a\"는 점, 사각형 또는 행렬일 수 있으며 \"m\"은 :data:`matrix_like` 입니다. *\"a/m\"* 은 *\"a*~m\"* 로 처리됩니다(역행렬이 없는 행렬에 대한 참고 사항은 아래 참조). \"a\"가 **점** 또는 **사각형** 이면 *\"a.transform(m)\"* 이 실행됩니다. \"a\"가 행렬이면 행렬 연결이 수행됩니다." #: ../../algebra.rst:67 d01766d058d54714bc45e5e76968d4ea msgid "a*b" msgstr "a*b" #: ../../algebra.rst:67 d18a927d83d845ddbd20845807b09e1f msgid "returns the **vector dot product** for a point \"a\" and point-like \"b\"." msgstr "점 \"a\"와 점과 유사한 \"b\"에 대한 **벡터 내적** 을 반환합니다." #: ../../algebra.rst:68 a49b407604184c13b57152c45ddb58ae msgid "a&b" msgstr "a&b" #: ../../algebra.rst:68 7550c08ef54244859c5a00ebed58448c msgid "" "**intersection rectangle:** \"a\" must be a rectangle and \"b\" " ":data:`rect_like`. Delivers the **largest rectangle** contained in both " "operands." msgstr "**교집합 사각형:** \"a\"는 사각형이어야 하며 \"b\"는 :data:`rect_like` 여야 합니다. 두 피연산자에 모두 포함된 **가장 큰 사각형** 을 제공합니다." #: ../../algebra.rst:71 a60662c06b0643b0a08f75afa24efb29 msgid "a|b" msgstr "a|b" #: ../../algebra.rst:71 79243f4be19046db9091a2f54eb4b815 msgid "" "**union rectangle:** \"a\" must be a rectangle, and \"b\" may be " ":data:`point_like` or :data:`rect_like`. Delivers the **smallest " "rectangle** containing both operands." msgstr "**합집합 사각형:** \"a\"는 사각형이어야 하며 \"b\"는 :data:`point_like` 또는 :data:`rect_like` 일 수 있습니다. 두 피연산자를 모두 포함하는 **가장 작은 사각형** 을 제공합니다." #: ../../algebra.rst:74 f48f56c4ee6547259acb882e87de433c msgid "b in a" msgstr "b in a" #: ../../algebra.rst:74 8f22ca12cfa44a898823836324a3ed99 msgid "" "if \"b\" is a number, then `b in tuple(a)` is returned. If \"b\" is " ":data:`point_like`, :data:`rect_like` or :data:`quad_like`, then \"a\" " "must be a rectangle, and `a.contains(b)` is returned." msgstr "\"b\"가 숫자이면 `b in tuple(a)` 가 반환됩니다. \"b\"가 :data:`point_like`, :data:`rect_like` 또는 :data:`quad_like` 이면 \"a\"는 사각형이어야 하며 `a.contains(b)` 가 반환됩니다." #: ../../algebra.rst:77 686725c716014188a79169f7cf3fd1e6 msgid "a == b" msgstr "a == b" #: ../../algebra.rst:77 634c54d1d21d471fabf558849def45e4 msgid "``True`` if *bool(a-b)* is ``False`` (\"b\" may be \"a-like\")." msgstr "*bool(a-b)* 가 ``False`` 이면 ``True`` (\"b\"는 \"a-like\"일 수 있음)." #: ../../algebra.rst:81 d34c2f644c4b4e6090e0e70255dd2ac5 msgid "Please note an important difference to usual arithmetic:" msgstr "일반적인 산술과의 중요한 차이점을 참고하세요:" #: ../../algebra.rst:83 ed3c97cc627d48b394819eb13306021a msgid "" "Matrix multiplication is **not commutative**, i.e. in general we have " "`m*n != n*m` for two matrices. Also, there are non-zero matrices which " "have no inverse, for example `m = Matrix(1, 0, 1, 0, 1, 0)`. If you try " "to divide by any of these, you will receive a `ZeroDivisionError` " "exception using operator *\"/\"*, e.g. for the expression " "`pymupdf.Identity / m`. But if you formulate `pymupdf.Identity * ~m`, the" " result will be `pymupdf.Matrix()` (the null matrix)." msgstr "행렬 곱셈은 **가환적이지 않습니다**. 즉, 일반적으로 두 행렬에 대해 `m*n != n*m` 입니다. 또한 역행렬이 없는 0이 아닌 행렬도 있습니다. 예를 들어 `m = Matrix(1, 0, 1, 0, 1, 0)` 입니다. 이것들 중 하나로 나누려고 하면 연산자 *\"/\"* 를 사용하여 `ZeroDivisionError` 예외를 받게 됩니다. 예를 들어 표현식 `pymupdf.Identity / m` 의 경우입니다. 하지만 `pymupdf.Identity * ~m` 으로 작성하면 결과는 `pymupdf.Matrix()` (null 행렬)가 됩니다." #: ../../algebra.rst:85 34a95a9718a64ff1a3bea139455bb7f8 msgid "" "Admittedly, this represents an inconsistency, and we are considering to " "remove it. For the time being, you can choose to avoid an exception and " "check whether ~m is the null matrix, or accept a potential " "*ZeroDivisionError* by using `pymupdf.Identity / m`." msgstr "인정하건대, 이것은 불일치를 나타내며, 우리는 이를 제거하는 것을 고려하고 있습니다. 당분간 예외를 피하고 ~m이 null 행렬인지 확인하거나, `pymupdf.Identity / m` 을 사용하여 잠재적인 *ZeroDivisionError* 를 받아들일 수 있습니다." #: ../../algebra.rst:89 be97480da28d4d4190b9207839fe11f4 msgid "" "With these conventions, all the usual algebra rules apply. For example, " "arbitrarily using brackets **(among objects of the same class!)** is " "possible: if r1, r2 are rectangles and m1, m2 are matrices, you can do " "this `(r1 + r2) * m1 * m2`." msgstr "이러한 규칙으로 모든 일반적인 대수 규칙이 적용됩니다. 예를 들어, 괄호를 임의로 사용하는 것**(동일한 클래스의 객체 중에서!)** 이 가능합니다: r1, r2가 사각형이고 m1, m2가 행렬이면 `(r1 + r2) * m1 * m2` 를 수행할 수 있습니다." #: ../../algebra.rst:90 511b54d905464bb8ad95bc07423f1ac2 msgid "" "For all objects of the same class, `a + b + c == (a + b) + c == a + (b + " "c)` is true." msgstr "동일한 클래스의 모든 객체에 대해 `a + b + c == (a + b) + c == a + (b + c)` 가 참입니다." #: ../../algebra.rst:91 c33b3f88dde84396a57cd45693269bce msgid "" "For matrices in addition the following is true: `(m1 + m2) * m3 == m1 * " "m3 + m2 * m3` (distributivity property)." msgstr "행렬의 경우 다음이 참입니다: `(m1 + m2) * m3 == m1 * m3 + m2 * m3` (분배 법칙)." #: ../../algebra.rst:92 78e8741acecb42b284d4923e4453fb4d msgid "" "**But the sequence of applying matrices is important:** If r is a " "rectangle and m1, m2 are matrices, then -- **caution!:**" msgstr "**하지만 행렬을 적용하는 순서가 중요합니다:** r이 사각형이고 m1, m2가 행렬이면 -- **주의!:**" #: ../../algebra.rst:93 f0abf06e26414aa19a371baa59b462f2 msgid "`r * m1 * m2 == (r * m1) * m2 != r * (m1 * m2)`" msgstr "`r * m1 * m2 == (r * m1) * m2 != r * (m1 * m2)`" #: ../../algebra.rst:96 f4a7e127cb3b40d6bfb3847510e2f35c msgid "Some Examples" msgstr "일부 예제" #: ../../algebra.rst:99 15d4cd12242a495384b94b9fc6c95502 msgid "Manipulation with numbers" msgstr "숫자로 조작" #: ../../algebra.rst:100 fcede45c56364a49abff9441c752c928 msgid "" "For the usual arithmetic operations, numbers are always allowed as second" " operand. In addition, you can formulate `\"x in OBJ\"`, where x is a " "number. It is implemented as `\"x in tuple(OBJ)\"`::" msgstr "일반적인 산술 연산의 경우 숫자는 항상 두 번째 피연산자로 허용됩니다. 또한 x가 숫자인 경우 `\"x in OBJ\"` 를 작성할 수 있습니다. 이것은 `\"x in tuple(OBJ)\"` 로 구현됩니다::" #: ../../algebra.rst:108 45094f3eda93464f8d0c9fa9f96154a4 msgid "" "The following will create the upper left quarter of a document page " "rectangle::" msgstr "다음은 문서 페이지 사각형의 왼쪽 위 사분면을 생성합니다::" #: ../../algebra.rst:116 fccb6e938aa14f8c823d2a27fb71bb4e msgid "" "The following will deliver the **middle point of a line** that connects " "two points **p1** and **p2**::" msgstr "다음은 두 점 **p1** 과 **p2** 를 연결하는 **선의 중점** 을 제공합니다::" #: ../../algebra.rst:125 0c7572c7661544739337b8dcd633678e msgid "" "Compute the **vector dot product** of two points. You can compute the " "**cosine of angles** and check orthogonality." msgstr "두 점의 **벡터 내적** 을 계산합니다. **각도의 코사인** 을 계산하고 직교성을 확인할 수 있습니다." #: ../../algebra.rst:149 9659faf69acb47fd94f2c4d7dbcfd358 msgid "Manipulation with \"like\" Objects" msgstr "\"like\" 객체로 조작" #: ../../algebra.rst:151 f7a23c3a7065470aa9f9ae634cfa4521 msgid "" "The second operand of a binary operation can always be \"like\" the left " "operand. \"Like\" in this context means \"a sequence of numbers of the " "same length\". With the above examples::" msgstr "이항 연산의 두 번째 피연산자는 항상 왼쪽 피연산자와 \"like\"일 수 있습니다. 이 맥락에서 \"Like\"는 \"동일한 길이의 숫자 시퀀스\"를 의미합니다. 위의 예제와 함께::" #: ../../algebra.rst:162 d40766627f0645a4a9b0f043c79f8df5 msgid "To shift a rectangle for 5 pixels to the right, do this::" msgstr "사각형을 오른쪽으로 5픽셀 이동하려면 다음을 수행하세요::" #: ../../algebra.rst:168 40356e8f087b4678a490620822d72405 msgid "" "Points, rectangles and matrices can be *transformed* with matrices. In " "PyMuPDF, we treat this like a **\"multiplication\"** (or resp. " "**\"division\"**), where the second operand may be \"like\" a matrix. " "Division in this context means \"multiplication with the inverted " "matrix\"::" msgstr "점, 사각형 및 행렬은 행렬로 *변환* 될 수 있습니다. PyMuPDF에서는 이를 **\"곱셈\"** (또는 각각 **\"나눗셈\"** )처럼 취급하며, 두 번째 피연산자는 행렬과 \"like\"일 수 있습니다. 이 맥락에서 나눗셈은 \"역행렬과의 곱셈\"을 의미합니다::" #: ../../algebra.rst:208 ca50582bfe28428c82f4ac0277e2d5be msgid "As a specialty, rectangles support additional binary operations:" msgstr "특수 기능으로, 사각형은 추가 이항 연산을 지원합니다:" #: ../../algebra.rst:210 59df6332d27249a28c44c9d4c7278be7 msgid "**intersection** -- the common area of rectangle-likes, operator *\"&\"*" msgstr "**교집합** -- 사각형과 유사한 것들의 공통 영역, 연산자 *\"&\"*" #: ../../algebra.rst:211 de5939af58234aa2be504334193d66d4 msgid "" "**inclusion** -- enlarge to include a point-like or rect-like, operator " "*\"|\"*" msgstr "**포함** -- 점과 유사하거나 사각형과 유사한 것을 포함하도록 확대, 연산자 *\"|\"*" #: ../../algebra.rst:212 7c511b27c11240cf9d09ca3e172cf9d2 msgid "**containment** check -- whether a point-like or rect-like is inside" msgstr "**포함** 확인 -- 점과 유사하거나 사각형과 유사한 것이 내부에 있는지 여부" #: ../../algebra.rst:214 901c1c4b81ce485fa4de1ef6f505e7e3 msgid "" "Here is an example for creating the smallest rectangle enclosing given " "points::" msgstr "주어진 점을 둘러싸는 가장 작은 사각형을 만드는 예제입니다::" #: ../../footer.rst:46 d8841960d4f44b93825542b2759973e3 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/annot.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4ac2fe405aa74919af4d4a1801389523 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 aee68aa3a3cc4589bddde105fa520c68 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 60584b8003094a8b9570ee372d8eab4b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../annot.rst:7 f0fb0074a9b6446f8124c5e84ab64978 msgid "Annot" msgstr "Annot (주석)" #: ../../annot.rst:9 fafaf69d450d48c5b26a1a93cb2eaa69 msgid "|pdf_only_class|" msgstr "PDF 전용 클래스." #: ../../annot.rst:11 4869b122c6834f279f19045fee171ca8 msgid "Quote from the :ref:`AdobeManual`:" msgstr ":ref:`AdobeManual` 에서 인용:" #: ../../annot.rst:13 e7b3050079714378a72611a6fde2125b msgid "" "*\"An annotation associates an object such as a note, sound, or movie " "with a location on a page of a PDF document, or provides a way to " "interact with the user by means of the mouse and keyboard.\"*" msgstr "*\"주석은 노트, 사운드 또는 동영상과 같은 객체를 PDF 문서 페이지의 위치와 연결하거나 마우스와 키보드를 통해 사용자와 상호 작용하는 방법을 제공합니다.\"*" #: ../../annot.rst:15 5c314b35139f446694f6aca06c7824f1 msgid "" "There is a parent-child relationship between an annotation and its page. " "If the page object becomes unusable (closed document, any document " "structure change, etc.), then so does every of its existing annotation " "objects -- an exception is raised saying that the object is \"orphaned\"," " whenever an annotation property or method is accessed." msgstr "주석과 페이지 사이에는 부모-자식 관계가 있습니다. 페이지 객체가 사용할 수 없게 되면(문서 닫기, 문서 구조 변경 등), 기존의 모든 주석 객체도 사용할 수 없게 됩니다 -- 주석 속성 또는 메서드에 액세스할 때마다 객체가 \"고아\"라는 예외가 발생합니다." #: ../../annot.rst:18 ce89c615b0d9400e96011970b5b97556 msgid "**Attribute**" msgstr "**속성**" #: ../../annot.rst:18 715a7d9d0eca46759c21efd06dcef6ad msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../annot.rst:20 46ba2c1aef7f47fb8cf735ab0ab8ca51 msgid ":meth:`Annot.delete_responses`" msgstr "" #: ../../annot.rst:20 542edab529f14f8a90c247c58f61d0e4 msgid "delete all responding annotations" msgstr "모든 응답 주석 삭제" #: ../../annot.rst:21 d6f4ad7997854c15ba7ef55c7c2df885 msgid ":meth:`Annot.get_file`" msgstr "" #: ../../annot.rst:21 df78c21ef62f4d29b9892ced6ce30eab msgid "get attached file content" msgstr "첨부 파일 내용 가져오기" #: ../../annot.rst:22 aaa2f1576e2940d187b785f39fd5d297 msgid ":meth:`Annot.get_oc`" msgstr "" #: ../../annot.rst:22 52de51aa8f364679a043608a648fdb6d msgid "get :data:`xref` of an :data:`OCG` / :data:`OCMD`" msgstr ":data:`OCG` / :data:`OCMD` 의 :data:`xref` 가져오기" #: ../../annot.rst:23 ba830719161c41318892442d95b2cb34 msgid ":meth:`Annot.get_pixmap`" msgstr "" #: ../../annot.rst:23 558b79769da645e1be5e25ee89f039ab msgid "image of the annotation as a pixmap" msgstr "주석의 이미지를 pixmap으로 가져오기" #: ../../annot.rst:24 a7049ccda64e4dd6890da7abe84fabf6 msgid ":meth:`Annot.get_sound`" msgstr "" #: ../../annot.rst:24 374a09b731894e87b56c7e841b17d330 msgid "get the sound of an audio annotation" msgstr "오디오 주석의 사운드 가져오기" #: ../../annot.rst:25 35a90d1b5a004ad387963f3d9607d749 msgid ":meth:`Annot.get_text`" msgstr "" #: ../../annot.rst:25 ../../annot.rst:26 6131792a9d994335b4444e4823388a9a #: f86eecd4858f4cb89a366a146014aee5 msgid "extract annotation text" msgstr "주석 텍스트 추출" #: ../../annot.rst:26 04cf9bb3fb1442709930c64bc5f6b0bb msgid ":meth:`Annot.get_textbox`" msgstr "" #: ../../annot.rst:27 19db3425545544fcbcd820ce607ec897 msgid ":meth:`Annot.get_textpage`" msgstr "" #: ../../annot.rst:27 c85fb9dd00d64ff99bd74482953c24bf msgid "create a TextPage for the annotation" msgstr "주석에 대한 TextPage 생성" #: ../../annot.rst:28 802ef16921bd4a60800fbad10cc481fd msgid ":meth:`Annot.set_border`" msgstr "" #: ../../annot.rst:28 2237d589cf4b43f8accb31706b0ac2e1 msgid "set annotation's border properties" msgstr "주석의 테두리 속성 설정" #: ../../annot.rst:29 d6e3ab0ff8c247faa2df18a3dbd4fb5f msgid ":meth:`Annot.set_blendmode`" msgstr "" #: ../../annot.rst:29 8ff755a8802d4e4bb4f4c6466fd93439 msgid "set annotation's blend mode" msgstr "주석의 블렌드 모드 설정" #: ../../annot.rst:30 ff206dc2f63444dfae9fbe12712ba514 msgid ":meth:`Annot.set_colors`" msgstr "" #: ../../annot.rst:30 3a8dce63eadd4ffe82a27bc21a526045 msgid "set annotation's colors" msgstr "주석의 색상 설정" #: ../../annot.rst:31 ../../annot.rst:341 7c620a1bbb3d466d8c82b9c8817c33ee #: a00f8a2d06fa46afb1028c82837e4185 msgid ":meth:`Annot.set_flags`" msgstr "" #: ../../annot.rst:31 37269417aa5845e78bc95975097fddad msgid "set annotation's flags field" msgstr "주석의 플래그 필드 설정" #: ../../annot.rst:32 60f6edb527ee49f1935786a1f19697cb msgid ":meth:`Annot.set_irt_xref`" msgstr "" #: ../../annot.rst:32 fe64d8f927974fa7be28efe034d209b8 msgid "define the annotation to being \"In Response To\"" msgstr "주석을 \"답변 대상\"으로 정의" #: ../../annot.rst:33 efcba97648754ee0b6f2bf66c5fb7b3b msgid ":meth:`Annot.set_name`" msgstr "" #: ../../annot.rst:33 f1f066d0c2da4d5f93f7b21c9e06512b msgid "set annotation's name field" msgstr "주석의 이름 필드 설정" #: ../../annot.rst:34 ../../annot.rst:342 068e0ee638a844e4b73d54c8713fd9bb #: 444417b076ed4a7f9938de802c9c8687 msgid ":meth:`Annot.set_oc`" msgstr "" #: ../../annot.rst:34 2afdd097e4904b54a8f1ea48f5b61be3 msgid "set :data:`xref` to an :data:`OCG` / :data:`OCMD`" msgstr ":data:`OCG` / :data:`OCMD` 로 :data:`xref` 설정" #: ../../annot.rst:35 c399de4849964e058e1637e53fdef2f9 msgid ":meth:`Annot.set_opacity`" msgstr "" #: ../../annot.rst:35 fff897c6b9cd4cf7bfd2472ea748ca06 msgid "change transparency" msgstr "투명도 변경" #: ../../annot.rst:36 d97cf692893c4fe7a6b799f4897c0aef msgid ":meth:`Annot.set_open`" msgstr "" #: ../../annot.rst:36 75aaff0f9c3c458ab962d5b77a5d79d3 msgid "open / close annotation or its Popup" msgstr "주석 또는 팝업 열기 / 닫기" #: ../../annot.rst:37 39f62e91ffef48ce9321e816caa20faa msgid ":meth:`Annot.set_popup`" msgstr "" #: ../../annot.rst:37 a674eec367f341508c884d315088746a msgid "create a Popup for the annotation" msgstr "주석에 대한 팝업 생성" #: ../../annot.rst:38 ../../annot.rst:340 305b0c54c12a450e8f06569799bb8a9f #: f592c57486d9486c86df308aa89526da msgid ":meth:`Annot.set_rect`" msgstr "" #: ../../annot.rst:38 26f28928df154a75b841a456bdfdbf0d msgid "change annotation rectangle" msgstr "주석 사각형 변경" #: ../../annot.rst:39 de6a1b1b820b471b86603c34dea03532 msgid ":meth:`Annot.set_rotation`" msgstr "" #: ../../annot.rst:39 9acc32b08f1d4f599b3735e31324426f msgid "change rotation" msgstr "회전 변경" #: ../../annot.rst:40 ../../annot.rst:343 18be6c4fae4e4cccb293fd8e12521dae #: 5200f1161df84772b72d390ec55d63cc msgid ":meth:`Annot.update_file`" msgstr "" #: ../../annot.rst:40 c1b5d04cd03e4575a6d8bc9e47a2ac7f msgid "update attached file content" msgstr "첨부 파일 내용 업데이트" #: ../../annot.rst:41 736a77ca795b4bffab978f162c15c221 msgid ":meth:`Annot.update`" msgstr "" #: ../../annot.rst:41 53fe58b99d874419bf45e91f443bea49 msgid "apply accumulated annot changes" msgstr "누적된 주석 변경 사항 적용" #: ../../annot.rst:42 076fef78de8747f98f8de5614822a3a3 msgid ":attr:`Annot.blendmode`" msgstr "" #: ../../annot.rst:42 3663d5144b7e4772a20a3ab76b0b7378 msgid "annotation BlendMode" msgstr "주석 BlendMode" #: ../../annot.rst:43 209656247f2147b79d61220568d6e982 msgid ":attr:`Annot.border`" msgstr "" #: ../../annot.rst:43 cd995c15bfff4706a84f1d0deeef716c msgid "border details" msgstr "테두리 세부 사항" #: ../../annot.rst:44 a5a847e7aa1e4a66a59312e3ad69222e msgid ":attr:`Annot.colors`" msgstr "" #: ../../annot.rst:44 7b16476edb2c47ee929046394941f61e msgid "border / background and fill colors" msgstr "테두리 / 배경 및 채우기 색상" #: ../../annot.rst:45 c79db9da10a34adf8724954ae760d148 msgid ":attr:`Annot.file_info`" msgstr "" #: ../../annot.rst:45 5e6d650320a44ec89edde9ad8443d028 msgid "get attached file information" msgstr "첨부 파일 정보 가져오기" #: ../../annot.rst:46 830bf8e01251454db4eff541902734e7 msgid ":attr:`Annot.flags`" msgstr "" #: ../../annot.rst:46 d8e2f38116e34d6b8bcc0e11a02f64c4 msgid "annotation flags" msgstr "주석 플래그" #: ../../annot.rst:47 427dbbb309334a4e938d8526af8aedd7 msgid ":attr:`Annot.has_popup`" msgstr "" #: ../../annot.rst:47 60549aa88002459b888f805a2649e95e msgid "whether annotation has a Popup" msgstr "주석에 팝업이 있는지 여부" #: ../../annot.rst:48 91cb2647177c40108aa8a389fbe4baba msgid ":attr:`Annot.irt_xref`" msgstr "" #: ../../annot.rst:48 4b1a08935c844e1b94fd19e67c73c4bf msgid "annotation to which this one responds" msgstr "이 주석이 응답하는 주석" #: ../../annot.rst:49 c80c1d9523e54c13bf015a7802006f46 msgid ":attr:`Annot.info`" msgstr "" #: ../../annot.rst:49 e24c29731fb9426296860ef9e14c70f4 msgid "various information" msgstr "다양한 정보" #: ../../annot.rst:50 9b1bc0b4f5604360a0fb530ee5571f6f msgid ":attr:`Annot.is_open`" msgstr "" #: ../../annot.rst:50 76000b5c78d64a51b15f2dfb48416053 msgid "whether annotation or its Popup is open" msgstr "주석 또는 팝업이 열려 있는지 여부" #: ../../annot.rst:51 c908f9af6c5e4097b190ab575189cc0e msgid ":attr:`Annot.line_ends`" msgstr "" #: ../../annot.rst:51 5b4b1ee3f3ae4f66af35ac09445805c4 msgid "start / end appearance of line-type annotations" msgstr "라인 타입 주석의 시작 / 끝 모양" #: ../../annot.rst:52 270077d780344f6c94f61715f13de4c2 msgid ":attr:`Annot.next`" msgstr "" #: ../../annot.rst:52 0dd927ea19014ab0ab931ee426aa46a2 msgid "link to the next annotation" msgstr "다음 주석에 대한 링크" #: ../../annot.rst:53 0642e6954b8f41758e18c9fec902315c msgid ":attr:`Annot.opacity`" msgstr "" #: ../../annot.rst:53 55103257955240a6b3c311e8e1f97f3c msgid "the annot's transparency" msgstr "주석의 투명도" #: ../../annot.rst:54 7528c54e1c664627851d592e77e4359b msgid ":attr:`Annot.parent`" msgstr "" #: ../../annot.rst:54 d12a83a84aea44868a11feca2fd75f9e msgid "page object of the annotation" msgstr "주석의 페이지 객체" #: ../../annot.rst:55 17d31eb890f346608a29bac66b130ede msgid ":attr:`Annot.popup_rect`" msgstr "" #: ../../annot.rst:55 e67d5b1efe1a49f8824bf40d6af292e8 msgid "rectangle of the annotation's Popup" msgstr "주석 팝업의 사각형" #: ../../annot.rst:56 f5012088621c45f4a0cfa4ff69b400c8 msgid ":attr:`Annot.popup_xref`" msgstr "" #: ../../annot.rst:56 3c9f31c943c04997b05236036e58e2a7 msgid "the PDF :data:`xref` number of the annotation's Popup" msgstr "주석 팝업의 PDF :data:`xref` 번호" #: ../../annot.rst:57 b0aaf4fc5d1d46a69cbca9c8576c4dff msgid ":attr:`Annot.rect`" msgstr "" #: ../../annot.rst:57 a3afa859fcc54f03b9928dd3e3b37411 msgid "rectangle containing the annotation" msgstr "주석을 포함하는 사각형" #: ../../annot.rst:58 e5405a3d8d6c48e3b0ba2375b00d54fc msgid ":attr:`Annot.type`" msgstr "" #: ../../annot.rst:58 49ea84134cbd4fcfa71613fdc7c994d4 msgid "type of the annotation" msgstr "주석 타입" #: ../../annot.rst:59 aedf999133ed4add859f5f25fcfd9c0a msgid ":attr:`Annot.vertices`" msgstr "" #: ../../annot.rst:59 0328a5222a444a84b329ee20a13d1815 msgid "point coordinates of Polygons, PolyLines, etc." msgstr "폴리곤, 폴리라인 등의 포인트 좌표" #: ../../annot.rst:60 593f8d9df1724b5abbabd4b0fb42cb5f msgid ":attr:`Annot.xref`" msgstr "" #: ../../annot.rst:60 73d760603078437db968d81892fe5450 msgid "the PDF :data:`xref` number" msgstr "PDF :data:`xref` 번호" #: ../../annot.rst:63 df3b29896fc84aa687b9b3d812b47830 msgid "**Class API**" msgstr "**클래스 API**" #: ../../annot.rst:75 b763b56670344531ae43994d27d0e054 msgid "Changed in v1.19.2: added support of dpi parameter." msgstr "v1.19.2에서 변경됨: dpi 매개변수 지원 추가." #: ../../annot.rst:77 571f3475af9d4fd8af0faef1dae8b761 msgid "" "Creates a pixmap from the annotation as it appears on the page in " "untransformed coordinates. The pixmap's :ref:`IRect` equals " "*Annot.rect.irect* (see below). **All parameters are keyword only.**" msgstr "" "변환되지 않은 좌표에서 페이지에 표시되는 대로 주석에서 pixmap을 생성합니다. pixmap의 :ref:`IRect` 는 " "*Annot.rect.irect* 와 같습니다(아래 참조). **모든 매개변수는 키워드 전용입니다.**" #: ../../annot.rst 038416b4a91041e89e078df4fe4f5636 #: 046b68e35745422e8e27b6ad4743720b 0ef49f86e0bd43f78e79e32e94eeea45 #: 176c3a7acc6e46d38ef37bbfe97eabda 1795f42bf0b242078204d40d7a212c9a #: 2ab60eb3db5f4b3594f30a2bb7fd5444 388ae783a9ec418581e0f622c2641963 #: 43c0bbc7ec774e96973a8f08c6370ebf 4e661fceb8be4c56850376cc43c38594 #: 5327b6738ac2466a95ae4ef2989536c3 7698812a2a694b63b8da213e56c66c7e #: a57f1370f9ac44c2b28c69413752355b a97c7424f15243ca9fa1102ea36941f0 #: bff13711337448f7809f30648c7765cd c8747aff1faa43f59b605c163d80ed7a #: d304c87c1b314f8f8d8449beb2cb9f43 e366806d4cdc4805a5cf6e6605d4c7ab #: e6d90ec622494f2cad21e1c4990e3a26 f73c89ed9881402ba2bd06564113f2e8 #: fe526c08b06a4286849cdeea133c925d msgid "Parameters" msgstr "매개변수" #: ../../annot.rst:79 4ea40779573a4cd48d2f0ca41a27b6cb msgid "a matrix to be used for image creation. Default is :ref:`Identity`." msgstr "이미지 생성에 사용할 행렬. 기본값은 :ref:`Identity` 입니다." #: ../../annot.rst:81 1ceeea87c25445779a772f81c247bf10 msgid "" "(new in v1.19.2) desired resolution in dots per inch. If not `None`, the " "matrix parameter is ignored." msgstr "(v1.19.2의 새로운 기능) 인치당 도트 단위의 원하는 해상도. `None` 이 아니면 matrix 매개변수는 무시됩니다." #: ../../annot.rst:83 17577d5328264f3c8b2c93127b76cb6c msgid "a colorspace to be used for image creation. Default is ``pymupdf.csRGB``." msgstr "이미지 생성에 사용할 색상 공간. 기본값은 ``pymupdf.csRGB`` 입니다." #: ../../annot.rst:86 93850b04eff54b39a748a09ca5d3e6bd msgid "whether to include transparency information. Default is ``False``." msgstr "투명도 정보를 포함할지 여부. 기본값은 ``False`` 입니다." #: ../../annot.rst 089309c51cd74976a42c4fcddda08a0a #: 09996d0975d243b1bc59b758b7d44173 1b331e1086824733a78f979f849d4845 #: 4817d4a35c28463eadae53476e0fd0d5 4b59e1c18c4147e69674c7d1e86501d1 #: 4c64d5922d9847968b2eeaee6487d0d0 4df6734c085c4a6ba495179996cfe92c #: 6347f866f7334ddda019820946166705 67048e418fbe44a79f9f63c0d53cb3a5 #: 7da6735c6b7f428e9eef30245825960b 7e4ad8f3110c429ea89f047da218ee26 #: 7f141e9ca331471ba531fcb59d32b10d 90d37be980f143b8aa9b4c16f83f6c90 #: a74cb6e028054b5abf3bcf4af3e18ad5 a838020417bb45188717e971f12c4b8f #: a8439c00be7b4164a1bbeae31ecffb57 a88e7e1341604dbf90a4215903761bf1 #: b193bdba031541f882f6d4d77564f78c bad1047750b244bca5505f7e797508bc #: d5d3fd4c788c48d6a3ad00aa4327e554 dc6f3b8d0e814a898c59d6e18c7b6fac #: ddc5fc79a0cd4e73a90a35b7de615f40 e556cbfd31a6417f8e4aab208b84c15a #: f867cc47820b4df6923b1b5b90969f1b msgid "Return type" msgstr "반환 타입" #: ../../annot.rst:88 4081b82925b34d7aa9202a29b34e6645 msgid ":ref:`Pixmap`" msgstr "" #: ../../annot.rst:92 b9b41dd1363b465fb91e965b05c005a3 msgid "" "If the annotation has just been created or modified, you should " ":meth:`Document.reload_page` the page first via `page = " "doc.reload_page(page)`." msgstr "주석이 방금 생성되었거나 수정된 경우 `page = doc.reload_page(page)` 를 통해 먼저 :meth:`Document.reload_page` 를 사용해야 합니다." #: ../../annot.rst:94 968363fd034a4b84834bfe008fd58160 msgid "" "The pixmap will have *\"premultiplied\"* pixels if `alpha=True`. To learn" " about some background, e.g. look for \"Premultiplied alpha\" `in this " "online glossary " "`_." msgstr "`alpha=True` 인 경우 픽스맵은 *\"premultiplied\"* 픽셀을 가집니다. 배경에 대해 알아보려면 예를 들어 `이 온라인 용어집 `_ 에서 \"Premultiplied alpha\"를 찾아보세요." #: ../../annot.rst:112 ../../annot.rst:133 059d5413f3154aaa8134479d9629d7da #: 5b109c06581d4245b9034c003ef2e32f msgid "New in 1.18.0" msgstr "*1.18.0의 새로운 기능*" #: ../../annot.rst:114 70fc1c944cd84ce18b5f51c59bbb47f0 msgid "" "Retrieves the content of the annotation in a variety of formats -- much " "like the same method for :ref:`Page`.. This currently only delivers " "relevant data for annotation types 'FreeText' and 'Stamp'. Other types " "return an empty string (or equivalent objects)." msgstr "다양한 형식으로 주석의 콘텐츠를 검색합니다 -- :ref:`Page` 의 동일한 메서드와 매우 유사합니다. 현재는 주석 타입 'FreeText' 및 'Stamp'에 대해서만 관련 데이터를 제공합니다. 다른 타입은 빈 문자열(또는 해당 객체)을 반환합니다." #: ../../annot.rst:116 4f2629a0de0d499f8b80783953ee846e msgid "" "(positional only) the desired format - one of the following values. " "Please note that this method works exactly like the same-named method of " ":ref:`Page`. * \"text\" -- :meth:`TextPage.extractTEXT`, default * " "\"blocks\" -- :meth:`TextPage.extractBLOCKS` * \"words\" -- " ":meth:`TextPage.extractWORDS` * \"html\" -- :meth:`TextPage.extractHTML` " "* \"xhtml\" -- :meth:`TextPage.extractXHTML` * \"xml\" -- " ":meth:`TextPage.extractXML` * \"dict\" -- :meth:`TextPage.extractDICT` * " "\"json\" -- :meth:`TextPage.extractJSON` * \"rawdict\" -- " ":meth:`TextPage.extractRAWDICT`" msgstr "" #: ../../annot.rst:116 f5480fbc3f3f42fba82218a8e4aec39e msgid "" "(positional only) the desired format - one of the following values. " "Please note that this method works exactly like the same-named method of " ":ref:`Page`." msgstr "(위치 전용) 원하는 형식 - 다음 값 중 하나. 이 메서드는 :ref:`Page` 의 동일한 이름의 메서드와 정확히 동일하게 작동합니다." #: ../../annot.rst:118 72a5b0cb198a4de4a1b5bd8012921a2d msgid "\"text\" -- :meth:`TextPage.extractTEXT`, default" msgstr "\"text\" -- :meth:`TextPage.extractTEXT`, 기본값" #: ../../annot.rst:119 a0de89ee87384b559b91cb65e53fd4fe msgid "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" msgstr "\"blocks\" -- :meth:`TextPage.extractBLOCKS`" #: ../../annot.rst:120 abb67ab204e8498a82f39f7786634fa3 msgid "\"words\" -- :meth:`TextPage.extractWORDS`" msgstr "\"words\" -- :meth:`TextPage.extractWORDS`" #: ../../annot.rst:121 2a65cab359de401d84fb6c06d18af7fe msgid "\"html\" -- :meth:`TextPage.extractHTML`" msgstr "\"html\" -- :meth:`TextPage.extractHTML`" #: ../../annot.rst:122 ebb1a0a333b94886a085c62c2910b11b msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`" msgstr "\"xhtml\" -- :meth:`TextPage.extractXHTML`" #: ../../annot.rst:123 039f6bd299a1459984f1378d7506db1d msgid "\"xml\" -- :meth:`TextPage.extractXML`" msgstr "\"xml\" -- :meth:`TextPage.extractXML`" #: ../../annot.rst:124 def0587d2e904e678a48944fd55d8845 msgid "\"dict\" -- :meth:`TextPage.extractDICT`" msgstr "\"dict\" -- :meth:`TextPage.extractDICT`" #: ../../annot.rst:125 9d446d90b12e480186eb0f5d4d6a88ca msgid "\"json\" -- :meth:`TextPage.extractJSON`" msgstr "\"json\" -- :meth:`TextPage.extractJSON`" #: ../../annot.rst:126 ba83222452844c0280bc4ca743ec52d2 msgid "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" msgstr "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`" #: ../../annot.rst:128 fc5b291ff14745a4acd435eba57c0ee4 msgid "" "(keyword only) restrict the extraction to this area. Should hardly ever " "be required, defaults to :attr:`Annot.rect`." msgstr "(키워드 전용) 추출을 이 영역으로 제한합니다. 거의 필요하지 않으며, 기본값은 :attr:`Annot.rect` 입니다." #: ../../annot.rst:129 58a7b13ec10244cab579c577a4a02451 msgid "" "(keyword only) control the amount of data returned. Defaults to simple " "text extraction." msgstr "(키워드 전용) 반환되는 데이터 양을 제어합니다. 기본값은 간단한 텍스트 추출입니다." #: ../../annot.rst:135 abea461b229f40449176733f81fe3e1f msgid "" "Return the annotation text. Mostly (except line breaks) equal to " ":meth:`Annot.get_text` with the \"text\" option." msgstr "주석 텍스트를 반환합니다. 대부분(줄바꿈 제외) \"text\" 옵션을 사용하는 :meth:`Annot.get_text` 와 동일합니다." #: ../../annot.rst:137 7769e9ff53bb477581a82b545145ed52 msgid "the area to consider, defaults to :attr:`Annot.rect`." msgstr "고려할 영역, 기본값은 :attr:`Annot.rect` 입니다." #: ../../annot.rst:142 2e28ab6b2bd740c788a328a8a392b3d3 msgid "Create a :ref:`TextPage` for the annotation." msgstr "주석에 대한 :ref:`TextPage` 생성." #: ../../annot.rst:144 ec86c28fbc9c4ea5a4520e3182ebac54 msgid "" "indicator bits controlling the content available for subsequent text " "extractions and searches -- see the parameter of :meth:`Annot.get_text`." msgstr "후속 텍스트 추출 및 검색에 사용 가능한 콘텐츠를 제어하는 표시기 비트 -- :meth:`Annot.get_text` 의 매개변수 참조." #: ../../annot.rst:146 f524fdc0ad6649eabe0dcea86d45490d msgid "restrict extracted text to this area." msgstr "추출된 텍스트를 이 영역으로 제한합니다." #: ../../annot.rst 00ab1155c33d4b8b909387ee865f0f14 #: 054667c67ee948229ce41dcc4618fb84 70e6a4c25ac54573a0e41c8e5ca39783 #: 75932b217be7487a9362d25abfb1105c a5e875b7000f42ec9309633efaa12429 #: c194084f626c4b5799f1d232a00741a2 ffd675b9852a4f828c4dfe677c57a2bf msgid "Returns" msgstr "반환값" #: ../../annot.rst:148 195337666ae04da792bf99b2e5fc7381 msgid ":ref:`TextPage`" msgstr "" #: ../../annot.rst:150 c08b99010b1b4e45886ecf4295e20ea1 msgid "|history_begin|" msgstr "" #: ../../annot.rst:152 b9da3f595018401c8b8eeb0c1529cca7 msgid "v1.25.5: fixed `clip` arg." msgstr "v1.25.5: `clip` 인수 수정." #: ../../annot.rst:154 0201b53debf84074b8cde915dfcee8f4 msgid "|history_end|" msgstr "" #: ../../annot.rst:158 7980023e59354afead5f160d58e260cb msgid "Changed in version 1.16.10" msgstr "버전 1.16.10에서 변경됨" #: ../../annot.rst:160 0b5d367dc98e4a3a9b3fe1c292ce8cb6 msgid "" "Changes annotation properties. These include dates, contents, subject and" " author (title). Changes for *name* and *id* will be ignored. The update " "happens selectively: To leave a property unchanged, set it to ``None``. " "To delete existing data, use an empty string." msgstr "주석 속성을 변경합니다. 날짜, 내용, 제목 및 작성자(제목)가 포함됩니다. *name* 및 *id* 에 대한 변경은 무시됩니다. 업데이트는 선택적으로 수행됩니다: 속성을 변경하지 않으려면 ``None`` 으로 설정하세요. 기존 데이터를 삭제하려면 빈 문자열을 사용하세요." #: ../../annot.rst:162 82ce1316fe354b898446a0cf7a1713b5 msgid "" "a dictionary compatible with the *info* property (see below). All entries" " must be strings. If this argument is not a dictionary, the other " "arguments are used instead -- else they are ignored." msgstr "*info* 속성과 호환되는 딕셔너리(아래 참조). 모든 항목은 문자열이어야 합니다. 이 인수가 딕셔너리가 아니면 다른 인수가 대신 사용됩니다 -- 그렇지 않으면 무시됩니다." #: ../../annot.rst:163 ../../annot.rst:164 ../../annot.rst:167 #: 83ea81f2fcaf4733afe8ff369d458b6f 86f02eb815724a3a9d24dd57c593a1a3 #: c5a737145dcf4d738178459172d94c07 msgid "*(new in v1.16.10)* see description in :attr:`info`." msgstr "*(v1.16.10의 새로운 기능)* :attr:`info` 의 설명을 참조하세요." #: ../../annot.rst:165 5b9616a7ad9147aa931d66313938ba67 msgid "" "*(new in v1.16.10)* date of annot creation. If given, should be in PDF " "datetime format." msgstr "*(v1.16.10의 새로운 기능)* 주석 생성 날짜. 주어진 경우 PDF 날짜/시간 형식이어야 합니다." #: ../../annot.rst:166 3764dd0b660a48ecba7d241ddd0c78ef msgid "" "*(new in v1.16.10)* date of last modification. If given, should be in PDF" " datetime format." msgstr "*(v1.16.10의 새로운 기능)* 마지막 수정 날짜. 주어진 경우 PDF 날짜/시간 형식이어야 합니다." #: ../../annot.rst:171 e43517d418724f92aa471da27a597d2b msgid "" "Sets an annotation's line ending styles. Each of these annotation types " "is defined by a list of points which are connected by lines. The symbol " "identified by *start* is attached to the first point, and *end* to the " "last point of this list. For unsupported annotation types, a no-operation" " with a warning message results." msgstr "주석의 라인 끝 스타일을 설정합니다. 이러한 주석 타입 각각은 라인으로 연결된 포인트 목록으로 정의됩니다. *start* 로 식별된 심볼은 첫 번째 포인트에 첨부되고, *end* 는 이 목록의 마지막 포인트에 첨부됩니다. 지원되지 않는 주석 타입의 경우 경고 메시지와 함께 작업이 수행되지 않습니다." #: ../../annot.rst:175 c6f37bfe8f864b7aa70a6677d903fbdc msgid "" "Some symbols have an interior area (diamonds, circles, squares, etc.). " "These areas are filled with the fill color or the stroke color, depending" " on the annotation type." msgstr "일부 심볼에는 내부 영역(다이아몬드, 원, 사각형 등)이 있습니다. 이러한 영역은 주석 타입에 따라 채우기 색상 또는 스트로크 색상으로 채워집니다." #: ../../annot.rst:177 35d6ef1a79c74b06ab0a9dcf482f9a65 msgid "The symbol number for the first point." msgstr "첫 번째 포인트의 심볼 번호." #: ../../annot.rst:178 458ad87b80944b07b309331fa16a70a2 msgid "The symbol number for the last point." msgstr "마지막 포인트의 심볼 번호." #: ../../annot.rst:182 4fed90be4a2f4f6eb36e2d7f41f31319 msgid "" "Set the annotation's visibility using PDF optional content mechanisms. " "This visibility is controlled by the user interface of supporting PDF " "viewers. It is independent from other attributes like " ":attr:`Annot.flags`." msgstr "PDF 선택적 콘텐츠 메커니즘을 사용하여 주석의 가시성을 설정합니다. 이 가시성은 지원하는 PDF 뷰어의 사용자 인터페이스에 의해 제어됩니다. :attr:`Annot.flags` 와 같은 다른 속성과는 독립적입니다." #: ../../annot.rst:184 613a0a96a3a548efb40200791489f4fd msgid "" "the :data:`xref` of an optional contents group (OCG or OCMD). Any " "previous xref will be overwritten. If zero, a previous entry will be " "removed. An exception occurs if the xref is not zero and does not point " "to a valid PDF object." msgstr "선택적 콘텐츠 그룹(OCG 또는 OCMD)의 :data:`xref`. 이전 xref는 덮어씌워집니다. 0이면 이전 항목이 제거됩니다. xref가 0이 아니고 유효한 PDF 객체를 가리키지 않으면 예외가 발생합니다." #: ../../annot.rst:186 55d26af3928947678aaeaa3e33027dcc msgid "This does **not require executing** :meth:`Annot.update` to take effect." msgstr "이것은 효과를 적용하기 위해 :meth:`Annot.update` **실행이 필요하지 않습니다**." #: ../../annot.rst:190 7e388a9f2b75447d8394d6d36c4a1bf8 msgid "" "Return the :data:`xref` of an optional content object, or zero if there " "is none." msgstr "선택적 콘텐츠 객체의 :data:`xref` 를 반환하거나, 없으면 0을 반환합니다." #: ../../annot.rst:192 e8ec795f695645628c3efbfd3915cec6 msgid "zero or the xref of an OCG (or OCMD)." msgstr "0 또는 OCG(또는 OCMD)의 xref." #: ../../annot.rst:197 b2f92c06a6294be3bfd5ec01d0e09768 msgid "New in v1.19.3" msgstr "*v1.19.3의 새로운 기능*" #: ../../annot.rst:199 ad11cb50eb7b4800aec2e137d3accb71 msgid "Set annotation to be \"In Response To\" another one." msgstr "주석을 다른 주석에 대한 \"답변 대상\"으로 설정합니다." #: ../../annot.rst:201 7b8bf875b3bc4826aa14c687fb8cd5d0 msgid "" "The :data:`xref` of another annotation. .. note:: Must refer to an " "existing annotation on this page. Setting this property requires no " "subsequent `update()`." msgstr "" #: ../../annot.rst:201 9e9d820407064710884e6a66aa7f7f55 msgid "The :data:`xref` of another annotation." msgstr "다른 주석의 :data:`xref`." #: ../../annot.rst:203 14f320a016824d5198f1d52227d0a926 msgid "" "Must refer to an existing annotation on this page. Setting this property " "requires no subsequent `update()`." msgstr "이 페이지의 기존 주석을 참조해야 합니다. 이 속성을 설정하는 데 후속 `update()` 가 필요하지 않습니다." #: ../../annot.rst:208 ../../annot.rst:217 ../../annot.rst:237 #: 481fa7ca48f54e5598a63178e50438ab a466079f958942378ec240211f031c16 #: f9ec8616d1df4181aa40e2958d601327 msgid "New in v1.18.4" msgstr "*v1.18.4의 새로운 기능*" #: ../../annot.rst:210 67cc9664fad84f49a83ba297112ca110 msgid "" "Set the annotation's Popup annotation to open or closed -- **or** the " "annotation itself, if its type is 'Text' (\"sticky note\")." msgstr "주석의 Popup 주석을 열거나 닫도록 설정합니다 -- **또는** 타입이 'Text'(\"sticky note\")인 경우 주석 자체를 설정합니다." #: ../../annot.rst:212 1504f1da1fda45fea8f19f45ffc20d4f msgid "the desired open state." msgstr "원하는 열림 상태." #: ../../annot.rst:219 c089225b48284823a9b7556a44262d27 msgid "" "Create a Popup annotation for the annotation and specify its rectangle. " "If the Popup already exists, only its rectangle is updated." msgstr "주석에 대한 Popup 주석을 생성하고 사각형을 지정합니다. Popup이 이미 존재하면 사각형만 업데이트됩니다." #: ../../annot.rst:221 c34e5022b5454828b58718e9dcbc45fe msgid "the desired rectangle." msgstr "원하는 사각형." #: ../../annot.rst:227 facb954df51640a7ae7fd3710883dc98 msgid "" "Set the annotation's transparency. Opacity can also be set in " ":meth:`Annot.update`." msgstr "주석의 투명도를 설정합니다. 불투명도는 :meth:`Annot.update` 에서도 설정할 수 있습니다." #: ../../annot.rst:229 d7989596080e46c987557189dc9c25ff msgid "" "a float in range *[0, 1]*. Any value outside is assumed to be 1. E.g. a " "value of 0.5 sets the transparency to 50%." msgstr "*[0, 1]* 범위의 float. 범위 밖의 값은 1로 간주됩니다. 예를 들어 0.5 값은 투명도를 50%로 설정합니다." #: ../../annot.rst:231 8cd9cbde74a9498aa0f39f1aceeb59c0 msgid "Three overlapping 'Circle' annotations with each opacity set to 0.5:" msgstr "각 불투명도가 0.5로 설정된 세 개의 겹치는 'Circle' 주석:" #: ../../annot.rst:239 78ea45fdfd8c457285f97ad98ced56cb msgid "" "The annotation's blend mode. See :ref:`AdobeManual`, page 324 for " "explanations." msgstr "주석의 블렌드 모드. 설명은 :ref:`AdobeManual`, 324페이지를 참조하세요." #: ../../annot.rst:242 30d06915799b4a4d993a5b5fca1059fe msgid "the blend mode or ``None``." msgstr "블렌드 모드 또는 ``None``." #: ../../annot.rst:247 9dce9ac76ca040e1a31d5585a57839f6 msgid "New in v1.16.14" msgstr "*v1.16.14의 새로운 기능*" #: ../../annot.rst:249 dc743497d0c04f36b92127b326b52323 msgid "" "Set the annotation's blend mode. See :ref:`AdobeManual`, page 324 for " "explanations. The blend mode can also be set in :meth:`Annot.update`." msgstr "주석의 블렌드 모드를 설정합니다. 설명은 :ref:`AdobeManual`, 324페이지를 참조하세요. 블렌드 모드는 :meth:`Annot.update` 에서도 설정할 수 있습니다." #: ../../annot.rst:251 4cc8588ee3a54e0ea07306202519e692 msgid "" "set the blend mode. Use :meth:`Annot.update` to reflect this in the " "visual appearance. For predefined values see :ref:`BlendModes`. Use " "`PDF_BM_Normal` to **remove** a blend mode." msgstr "블렌드 모드를 설정합니다. 시각적 모양에 반영하려면 :meth:`Annot.update` 를 사용하세요. 미리 정의된 값은 :ref:`BlendModes` 를 참조하세요. 블렌드 모드를 **제거** 하려면 `PDF_BM_Normal` 을 사용하세요." #: ../../annot.rst:256 f91715c6f8dd45839dff56adcd90fe40 msgid "New in version 1.16.0" msgstr "*버전 1.16.0의 새로운 기능*" #: ../../annot.rst:258 63628e30584640f485f9216a26cc976e msgid "" "Change the name field of any annotation type. For 'FileAttachment' and " "'Text' annotations, this is the icon name, for 'Stamp' annotations the " "text in the stamp. The visual result (if any) depends on your PDF viewer." " See also :ref:`mupdficons`." msgstr "모든 주석 타입의 이름 필드를 변경합니다. 'FileAttachment' 및 'Text' 주석의 경우 이것은 아이콘 이름이고, 'Stamp' 주석의 경우 스탬프의 텍스트입니다. 시각적 결과(있는 경우)는 PDF 뷰어에 따라 다릅니다. :ref:`mupdficons` 도 참조하세요." #: ../../annot.rst:260 c9956808cf6344fe93a68e352c078f3b msgid "the new name." msgstr "새 이름." #: ../../annot.rst:262 77d72775e0d649e0aee5cd748dcf35c5 msgid "" "If you set the name of a 'Stamp' annotation, then this will **not " "change** the rectangle, nor will the text be layouted in any way. If you " "choose a standard text from :ref:`StampIcons` (the **exact** name piece " "after `\"STAMP_\"`), you should receive the original layout. An " "**arbitrary text** will not be changed to upper case, but be written in " "font \"Times-Bold\" as is, horizontally centered in **one line** and be " "shortened to fit. To get your text fully displayed, its length using " ":data:`fontsize` 20 must not exceed 190 points. So please make sure that " "the following inequality is true: `pymupdf.get_text_length(text, " "fontname=\"tibo\", fontsize=20) <= 190`." msgstr "'Stamp' 주석의 이름을 설정하면 사각형이 **변경되지 않으며**, 텍스트도 어떤 방식으로도 레이아웃되지 않습니다. :ref:`StampIcons` 에서 표준 텍스트를 선택하는 경우(`\"STAMP_\"` 뒤의 **정확한** 이름 부분), 원래 레이아웃을 받아야 합니다. **임의의 텍스트** 는 대문자로 변경되지 않지만, 그대로 \"Times-Bold\" 글꼴로 작성되며 **한 줄** 에 가로로 중앙 정렬되고 맞추기 위해 단축됩니다. 텍스트가 완전히 표시되도록 하려면 :data:`fontsize` 20을 사용한 길이가 190포인트를 초과하지 않아야 합니다. 따라서 다음 부등식이 참인지 확인하세요: `pymupdf.get_text_length(text, fontname=\"tibo\", fontsize=20) <= 190`." #: ../../annot.rst:266 215783824e424078a9c68252ef072b76 msgid "" "Change the rectangle of an annotation. The annotation can be moved around" " and both sides of the rectangle can be independently scaled. However, " "the annotation appearance will never get rotated, flipped or sheared. " "This method only affects certain annotation types [#f2]_ and will lead to" " a message on Python's `sys.stderr` in other cases. No exception will be " "raised, but `False` will be returned." msgstr "주석의 사각형을 변경합니다. 주석을 이동할 수 있고 사각형의 양쪽을 독립적으로 확장할 수 있습니다. 그러나 주석 모양은 회전, 뒤집기 또는 기울임이 되지 않습니다. 이 메서드는 특정 주석 타입 [#f2]_에만 영향을 미치며 다른 경우에는 Python의 `sys.stderr` 에 메시지가 표시됩니다. 예외는 발생하지 않지만 `False` 가 반환됩니다." #: ../../annot.rst:268 a55821d5ebaa43a79524ea735d7fce30 msgid "" "the new rectangle of the annotation (finite and not empty). E.g. using a " "value of *annot.rect + (5, 5, 5, 5)* will shift the annot position 5 " "pixels to the right and downwards." msgstr "주석의 새 사각형(유한하고 비어 있지 않음). 예를 들어 *annot.rect + (5, 5, 5, 5)* 값을 사용하면 주석 위치가 오른쪽과 아래로 5픽셀 이동합니다." #: ../../annot.rst:270 58ba9ae624c649f59c822a951c81b8d9 msgid "You **need not** invoke :meth:`Annot.update` for activation of the effect." msgstr "효과를 활성화하기 위해 :meth:`Annot.update` 를 **호출할 필요가 없습니다**." #: ../../annot.rst:275 4182447a9b644af7b8fdaadfb8a05d32 msgid "" "Set the rotation of an annotation. This rotates the annotation rectangle " "around its center point. Then a **new annotation rectangle** is " "calculated from the resulting quad." msgstr "주석의 회전을 설정합니다. 이것은 중심점을 중심으로 주석 사각형을 회전시킵니다. 그런 다음 결과 쿼드에서 **새 주석 사각형** 이 계산됩니다." #: ../../annot.rst:277 6fc24fed55494f8fb4a955d4d8a13eba msgid "" "rotation angle in degrees. Arbitrary values are possible, but will be " "clamped to the interval `[0, 360)`." msgstr "도 단위의 회전 각도. 임의의 값이 가능하지만 `[0, 360)` 구간으로 제한됩니다." #: ../../annot.rst:280 e4f887994fc5422f95d07305f9ce1cd5 msgid "You **must invoke** :meth:`Annot.update` to activate the effect." msgstr "효과를 활성화하려면 :meth:`Annot.update` 를 **호출해야 합니다**." #: ../../annot.rst:281 708375ceb35c401f93a653d662ffa946 msgid "" "For PDF_ANNOT_FREE_TEXT, only one of the values 0, 90, 180 and 270 is " "possible and will **rotate the text** inside the current rectangle (which" " remains unchanged). Other values are silently ignored and replaced by 0." msgstr "PDF_ANNOT_FREE_TEXT의 경우 0, 90, 180, 270 값 중 하나만 가능하며 현재 사각형 내에서 **텍스트를 회전** 시킵니다(사각형은 변경되지 않음). 다른 값은 조용히 무시되고 0으로 대체됩니다." #: ../../annot.rst:282 9916c3c0474d42789055dd9fb27df6d5 msgid "" "Otherwise, only the following :ref:`AnnotationTypes` can be rotated: " "'Square', 'Circle', 'Caret', 'Text', 'FileAttachment', 'Ink', 'Line', " "'Polyline', 'Polygon', and 'Stamp'. For all others the method is a no-op." msgstr "그렇지 않으면 다음 :ref:`AnnotationTypes` 만 회전할 수 있습니다: 'Square', 'Circle', 'Caret', 'Text', 'FileAttachment', 'Ink', 'Line', 'Polyline', 'Polygon', 'Stamp'. 다른 모든 경우 메서드는 작업을 수행하지 않습니다." #: ../../annot.rst:287 21f87eefce9f42cd84347e0b9f4c9750 msgid "" "Changed in version 1.16.9: Allow specification without using a " "dictionary. The direct parameters are used if *border* is not a " "dictionary." msgstr "버전 1.16.9에서 변경됨: 딕셔너리를 사용하지 않고 지정할 수 있습니다. *border* 가 딕셔너리가 아니면 직접 매개변수가 사용됩니다." #: ../../annot.rst:289 a5d1d0e5012145d88adb8f0b58ec843d msgid "Changed in version 1.22.5: Support of the \"cloudy\" border effect." msgstr "버전 1.22.5에서 변경됨: \"cloudy\" 테두리 효과 지원." #: ../../annot.rst:291 c189c32c136c4970affbad53b8a4962c msgid "" "PDF only: Change border width, dashing, style and cloud effect. See the " ":attr:`Annot.border` attribute for more details." msgstr "PDF 전용: 테두리 너비, 파선, 스타일 및 클라우드 효과를 변경합니다. 자세한 내용은 :attr:`Annot.border` 속성을 참조하세요." #: ../../annot.rst:294 cd430c709f2743de8acc763ed90aa387 msgid "" "a dictionary as returned by the :attr:`border` property, with keys " "*\"width\"* (*float*), *\"style\"* (*str*), *\"dashes\"* (*sequence*) " "and *clouds* (*int*). Omitted keys will leave the resp. property " "unchanged. Set the border argument to `None` (the default) to use the " "other arguments." msgstr ":attr:`border` 속성에서 반환된 딕셔너리, 키는 *\"width\"* (*float*), *\"style\"* (*str*), *\"dashes\"* (*sequence*), *clouds* (*int*). 생략된 키는 해당 속성을 변경하지 않습니다. 다른 인수를 사용하려면 border 인수를 `None` (기본값)으로 설정하세요." #: ../../annot.rst:296 39acc9934225448197fcfd592c9d832f msgid "A non-negative value will change the border line width." msgstr "음수가 아닌 값은 테두리 선 너비를 변경합니다." #: ../../annot.rst:297 a68a775771684101adfaada1b555645a msgid "A value other than `None` will change this border property." msgstr "`None` 이 아닌 값은 이 테두리 속성을 변경합니다." #: ../../annot.rst:298 6abbfe1e60884753b2f408c6140c1522 msgid "" "All items of the sequence must be integers, otherwise the parameter is " "ignored. To remove dashing use: `dashes=[]`. If dashes is a non-empty " "sequence, \"style\" will automatically be set to \"D\" (dashed)." msgstr "시퀀스의 모든 항목은 정수여야 하며, 그렇지 않으면 매개변수가 무시됩니다. 파선을 제거하려면 `dashes=[]` 를 사용하세요. dashes가 비어 있지 않은 시퀀스인 경우 \"style\"이 자동으로 \"D\"(파선)로 설정됩니다." #: ../../annot.rst:299 a14bf775a9aa4b5690dfa5d75ad9a268 msgid "" "A value >= 0 will change this property. Use `clouds=0` to remove the " "cloudy appearance completely. Only annotation types 'Square', 'Circle', " "and 'Polygon' are supported with this property." msgstr ">= 0 값은 이 속성을 변경합니다. 클라우드 모양을 완전히 제거하려면 `clouds=0` 을 사용하세요. 이 속성은 주석 타입 'Square', 'Circle', 'Polygon'에서만 지원됩니다." #: ../../annot.rst:303 ef79e54d0a714869a014c9d730425b72 msgid "Changes the annotation flags. Use the `|` operator to combine several." msgstr "주석 플래그를 변경합니다. 여러 개를 결합하려면 `|` 연산자를 사용하세요." #: ../../annot.rst:305 fd0aa1fe5fa54354942159d69033f3dd msgid "an integer specifying the required flags." msgstr "필요한 플래그를 지정하는 정수." #: ../../annot.rst:309 6c045aa7fffe4727b0d500917f834af7 msgid "" "Changes the \"stroke\" and \"fill\" colors for supported annotation types" " -- not all annotation types accept both. **Do not use this method at all" " for FreeText annotations** because it has its special conventions to " "deal with up to three colors (border, fill, text)." msgstr "지원되는 주석 타입에 대한 \"stroke\" 및 \"fill\" 색상을 변경합니다 -- 모든 주석 타입이 둘 다 허용하는 것은 아닙니다. **FreeText 주석에는 이 메서드를 전혀 사용하지 마세요** 최대 3개의 색상(테두리, 채우기, 텍스트)을 처리하는 특별한 규칙이 있기 때문입니다." #: ../../annot.rst:311 db7de1cdaf074887b6a5856f6edce371 msgid "" "a dictionary containing color specifications. For accepted dictionary " "keys and values see below. The most practical way should be to first make" " a copy of the *colors* property and then modify this dictionary as " "required." msgstr "색상 지정을 포함하는 딕셔너리. 허용되는 딕셔너리 키와 값은 아래를 참조하세요. 가장 실용적인 방법은 먼저 *colors* 속성의 복사본을 만든 다음 필요에 따라 이 딕셔너리를 수정하는 것입니다." #: ../../annot.rst:312 ../../annot.rst:313 75cff1ffb24c4912bfeb81a9ebd1432d #: ab1efc57d7bc48e98cf5e1bdb658a212 msgid "see above." msgstr "위를 참조하세요." #: ../../annot.rst:315 7c1a94d49e3646c1acf119c6dbd9d5d2 msgid "" "To completely remove a color specification, use an empty sequence like " "`[]`. If you specify `None`, an existing specification will not be " "changed." msgstr "색상 지정을 완전히 제거하려면 `[]` 와 같은 빈 시퀀스를 사용하세요. `None` 을 지정하면 기존 지정이 변경되지 않습니다." #: ../../annot.rst:320 2a6d90dee7ce4d77b26b92943743267a msgid "New in version 1.16.12" msgstr "*버전 1.16.12의 새로운 기능*" #: ../../annot.rst:322 595743ee33354f6db6ea8007f5c683d9 msgid "" "Delete annotations referring to this one. This includes any 'Popup' " "annotations and all annotations responding to it." msgstr "이 주석을 참조하는 주석을 삭제합니다. 여기에는 모든 'Popup' 주석과 이에 응답하는 모든 주석이 포함됩니다." #: ../../annot.rst:336 3dd084b1ebf84cde9a0f1628888a078a msgid "" "Synchronize the appearance of an annotation with its properties after " "relevant changes." msgstr "관련 변경 후 주석의 모양을 속성과 동기화합니다." #: ../../annot.rst:338 7fe415cd7d454f189581594f76164856 msgid "You can safely **omit** this method **only** for the following changes:" msgstr "다음 변경 사항에 대해서만 이 메서드를 안전하게 **생략** 할 수 있습니다:" #: ../../annot.rst:344 fe15053758b14d7199c023e93f5fb1b5 msgid ":meth:`Annot.set_info` (except any changes to *\"content\"*)" msgstr ":meth:`Annot.set_info` (*\"content\"* 에 대한 변경 제외)" #: ../../annot.rst:346 0073d1e84f5d4733b0ed896ad1863ecc msgid "" "All arguments are optional. *(Changed in v1.16.14)* Blend mode and " "opacity are applicable to **all annotation types**. The other arguments " "are mostly special use, as described below." msgstr "모든 인수는 선택 사항입니다. *(v1.16.14에서 변경됨)* 블렌드 모드와 불투명도는 **모든 주석 타입** 에 적용됩니다. 다른 인수는 아래에 설명된 대로 대부분 특수 용도입니다." #: ../../annot.rst:348 f2ba4ab0eec14256874f4795f0809515 msgid "" "Color specifications may be made in the usual format used in PuMuPDF as " "sequences of floats ranging from 0.0 to 1.0 (including both). The " "sequence length must be 1, 3 or 4 (supporting GRAY, RGB and CMYK " "colorspaces respectively). For GRAY, just a float is also acceptable." msgstr "색상 지정은 PyMuPDF에서 사용하는 일반 형식으로 0.0부터 1.0까지(둘 다 포함)의 float 시퀀스로 만들 수 있습니다. 시퀀스 길이는 1, 3 또는 4여야 합니다(각각 GRAY, RGB 및 CMYK 색상 공간 지원). GRAY의 경우 단일 float도 허용됩니다." #: ../../annot.rst:350 f3ccad414cfa4feea70d7d6d4ee37f20 msgid "" "*(new in v1.16.14)* **valid for all annotation types:** change or set the" " annotation's transparency. Valid values are *0 <= opacity < 1*." msgstr "*(v1.16.14의 새로운 기능)* **모든 주석 타입에 유효:** 주석의 투명도를 변경하거나 설정합니다. 유효한 값은 *0 <= opacity < 1* 입니다." #: ../../annot.rst:352 04465250dcde4c4c860e257ac3e888cc msgid "" "*(new in v1.16.14)* **valid for all annotation types:** change or set the" " annotation's blend mode. For valid values see :ref:`BlendModes`." msgstr "*(v1.16.14의 새로운 기능)* **모든 주석 타입에 유효:** 주석의 블렌드 모드를 변경하거나 설정합니다. 유효한 값은 :ref:`BlendModes` 를 참조하세요." #: ../../annot.rst:354 9bc27aa105ae42cd82a2451d40ee6e6e msgid "change :data:`fontsize` of the text. 'FreeText' annotations only." msgstr "텍스트의 :data:`fontsize` 변경. 'FreeText' 주석만 해당." #: ../../annot.rst:356 cf2b46ce81194d3889beefcdf7c9b7bc msgid "" "change the text color. 'FreeText' annotations only. This has the same " "effect as ``border_color``. Note that the text color of rich-text " "annotations cannot be changed at all because it is set by HTML / CSS " "syntax and part of the text itself." msgstr "텍스트 색상 변경. 'FreeText' 주석만 해당. 이것은 ``border_color`` 와 동일한 효과를 가집니다. 리치 텍스트 주석의 텍스트 색상은 HTML / CSS 구문에 의해 설정되고 텍스트 자체의 일부이기 때문에 전혀 변경할 수 없습니다." #: ../../annot.rst:358 9573860e39914131a2e6b21985df1d0a msgid "" "change the border color. 'FreeText' annotations only. This has the same " "effect as ``text_color``." msgstr "테두리 색상 변경. 'FreeText' 주석만 해당. 이것은 ``text_color`` 와 동일한 효과를 가집니다." #: ../../annot.rst:360 f201d820422e410380867aef925e12c6 msgid "the fill color." msgstr "채우기 색상." #: ../../annot.rst:362 51b7ae492b9d439ea63ad6e688461680 msgid "" "*(new in v1.17.2)* add two diagonal lines to the annotation rectangle. " "'Redact' annotations only. If not desired, ``False`` must be specified " "even if the annotation was created with ``False``." msgstr "*(v1.17.2의 새로운 기능)* 주석 사각형에 두 개의 대각선을 추가합니다. 'Redact' 주석만 해당. 원하지 않는 경우 주석이 ``False`` 로 생성되었더라도 ``False`` 를 지정해야 합니다." #: ../../annot.rst:364 ca681b7d888b4269b353a917a0251fcc msgid "" "new rotation value. Default (-1) means no change. Supports 'FreeText' and" " several other annotation types (see :meth:`Annot.set_rotation`), [#f1]_." " Only choose 0, 90, 180, or 270 degrees for 'FreeText'. Otherwise any " "integer is acceptable." msgstr "새 회전 값. 기본값(-1)은 변경 없음을 의미합니다. 'FreeText' 및 여러 다른 주석 타입을 지원합니다(:meth:`Annot.set_rotation` 참조), [#f1]_. 'FreeText'의 경우 0, 90, 180 또는 270도만 선택하세요. 그렇지 않으면 모든 정수가 허용됩니다." #: ../../annot.rst:368 60ab5d4e01554e09aa2155cfcf1bd6a4 msgid "" "This method is the only way to change the colors of a FreeText " "annotation. You cannot use :meth:`Annot.set_colors` for this purpose. But" " be aware that for rich-text annotations, the text color is never " "changed. The text color is set by the ``text_color`` entry of the " "``info`` dictionary. This is a limitation of |MuPDF| and not a bug." msgstr "이 메서드는 FreeText 주석의 색상을 변경하는 유일한 방법입니다. 이 목적을 위해 :meth:`Annot.set_colors` 를 사용할 수 없습니다. 그러나 리치 텍스트 주석의 경우 텍스트 색상은 절대 변경되지 않습니다. 텍스트 색상은 ``info`` 딕셔너리의 ``text_color`` 항목에 의해 설정됩니다. 이것은 |MuPDF| 의 제한 사항이며 버그가 아닙니다." #: ../../annot.rst:370 1112033b5d6844729cb062a449ec85b1 msgid "" "Using this method inside a :meth:`Page.annots` loop is **not " "recommended!** This is because most annotation updates require the owning" " page to be reloaded -- which cannot be done inside this loop. Please use" " the example coding pattern given in the documentation of this generator." msgstr ":meth:`Page.annots` 루프 내에서 이 메서드를 사용하는 것은 **권장되지 않습니다!** 대부분의 주석 업데이트는 소유 페이지를 다시 로드해야 하기 때문입니다 -- 이 루프 내에서는 수행할 수 없습니다. 이 생성자의 문서에 제공된 예제 코딩 패턴을 사용하세요." #: ../../annot.rst:375 4a926753fff744ec9116dd6ed7183650 msgid "Basic information of the annot's attached file." msgstr "주석의 첨부 파일에 대한 기본 정보." #: ../../annot.rst:378 dff1e3b1a640429fb53eddd0fa92ce69 msgid "" "a dictionary with keys *filename*, *ufilename*, *desc* (description), " "*size* (uncompressed file size), *length* (compressed length) for " "FileAttachment annot types, else ``None``." msgstr "FileAttachment 주석 타입의 경우 *filename*, *ufilename*, *desc* (설명), *size* (압축되지 않은 파일 크기), *length* (압축된 길이) 키를 가진 딕셔너리, 그렇지 않으면 ``None``." #: ../../annot.rst:382 fff1e94235db41658c4a47630907af7b msgid "Returns attached file content." msgstr "첨부 파일 내용을 반환합니다." #: ../../annot.rst:385 e7858d0b8f274619a0e53226e2ad2558 msgid "the content of the attached file." msgstr "첨부 파일의 내용." #: ../../annot.rst:395 0a6f0f824993411db432fbc73cedbf48 msgid "" "Updates the content of an attached file. All arguments are optional. No " "arguments lead to a no-op." msgstr "첨부 파일의 내용을 업데이트합니다. 모든 인수는 선택 사항입니다. 인수가 없으면 작업이 수행되지 않습니다." #: ../../annot.rst:397 14cfd5ce68c443c4b5706490bf7ce62c msgid "" "the new file content. Omit to only change meta-information. *(Changed in" " version 1.14.13)* *io.BytesIO* is now also supported." msgstr "" #: ../../annot.rst:397 13e705e69a1d425184d4be574725693d msgid "the new file content. Omit to only change meta-information." msgstr "새 파일 내용. 메타 정보만 변경하려면 생략하세요." #: ../../annot.rst:399 a1e92b5db60e4c4599063b1893fd8eed msgid "*(Changed in version 1.14.13)* *io.BytesIO* is now also supported." msgstr "*(버전 1.14.13에서 변경됨)* *io.BytesIO* 도 이제 지원됩니다." #: ../../annot.rst:401 16d4a6c7354947dc9ed4a1af1e661951 msgid "new filename to associate with the file." msgstr "파일과 연결할 새 파일 이름." #: ../../annot.rst:403 f71c9be54bb649adbc2100b1cf7793e5 msgid "new unicode filename to associate with the file." msgstr "파일과 연결할 새 유니코드 파일 이름." #: ../../annot.rst:405 70d2cec5d76d4b4ca6ac53eb58acf503 msgid "new description of the file content." msgstr "파일 내용에 대한 새 설명." #: ../../annot.rst:409 dfdaec12a2274c30a1f374a77b655ee8 msgid "Return the embedded sound of an audio annotation." msgstr "오디오 주석의 포함된 사운드를 반환합니다." #: ../../annot.rst:412 c7fa04ae49d54d39a39b5d2245c490f0 msgid "" "the sound audio file and accompanying properties. These are the possible " "dictionary keys, of which only \"rate\" and \"stream\" are always " "present. =========== " "======================================================= Key " "Description =========== " "======================================================= rate " "(float, requ.) samples per second channels (int, opt.) number of sound" " channels bps (int, opt.) bits per sample value per channel " "encoding (str, opt.) encoding format: Raw, Signed, muLaw, ALaw " "compression (str, opt.) name of compression filter stream (bytes, " "requ.) the sound file content =========== " "=======================================================" msgstr "" #: ../../annot.rst:412 df0e243fcf034592a8492436e6e1659a msgid "" "the sound audio file and accompanying properties. These are the possible " "dictionary keys, of which only \"rate\" and \"stream\" are always " "present." msgstr "사운드 오디오 파일 및 관련 속성. 가능한 딕셔너리 키는 다음과 같으며, \"rate\"와 \"stream\"만 항상 존재합니다." #: ../../annot.rst:415 12be1c52c4314285af838a6ce29fba9e msgid "Key" msgstr "키" #: ../../annot.rst:415 2bdf4ba35cce4815a2a492cf817897c8 msgid "Description" msgstr "설명" #: ../../annot.rst:417 0d66d09f790c4ff3bc6c27ba0d9b632a msgid "rate" msgstr "rate" #: ../../annot.rst:417 c1045c0883214be39172475f75e7f5d0 msgid "(float, requ.) samples per second" msgstr "(float, 필수) 초당 샘플 수" #: ../../annot.rst:418 8abdaaa9d7fe44dfa74cc67416d30c2b msgid "channels" msgstr "channels" #: ../../annot.rst:418 f74b4b35e92846e28327d70e75e25b02 msgid "(int, opt.) number of sound channels" msgstr "(int, 선택) 사운드 채널 수" #: ../../annot.rst:419 942b2b733eed481b9491bc82bc570e1c msgid "bps" msgstr "bps" #: ../../annot.rst:419 7be514225767447a8a8095e8df1f2bc4 msgid "(int, opt.) bits per sample value per channel" msgstr "(int, 선택) 채널당 샘플 값당 비트 수" #: ../../annot.rst:420 b38f02b791694df2ae7e91f5e18e4b63 msgid "encoding" msgstr "encoding" #: ../../annot.rst:420 73e6b25cf0da41518e6a2a8c8342f9b9 msgid "(str, opt.) encoding format: Raw, Signed, muLaw, ALaw" msgstr "(str, 선택) 인코딩 형식: Raw, Signed, muLaw, ALaw" #: ../../annot.rst:421 1969b7bd898244968ec9e8b0ccb1bde7 msgid "compression" msgstr "compression" #: ../../annot.rst:421 a89ee4a1e5ae438bb9abdf27689f1840 msgid "(str, opt.) name of compression filter" msgstr "(str, 선택) 압축 필터 이름" #: ../../annot.rst:422 8ae646c528504b2c930d6aeefa18e74b msgid "stream" msgstr "stream" #: ../../annot.rst:422 379f471934fe4d5fab7732b175a2bce2 msgid "(bytes, requ.) the sound file content" msgstr "(bytes, 필수) 사운드 파일 내용" #: ../../annot.rst:428 04846fc70fde4de09324de235eedf132 msgid "" "The annotation's transparency. If set, it is a value in range *[0, 1]*. " "The PDF default is 1. However, in an effort to tell the difference, we " "return *-1.0* if not set." msgstr "주석의 투명도. 설정된 경우 *[0, 1]* 범위의 값입니다. PDF 기본값은 1입니다. 그러나 차이를 구분하기 위해 설정되지 않은 경우 *-1.0* 을 반환합니다." #: ../../annot.rst:434 38341cb4267e49eea899f48c336adc57 msgid "The owning page object of the annotation." msgstr "주석의 소유 페이지 객체." #: ../../annot.rst:436 b69e2ef1768c4682aeceb59e231073e6 msgid ":ref:`Page`" msgstr "" #: ../../annot.rst:440 d8c838f369404f76b51db3fa29590aaf msgid "The annot rotation." msgstr "주석 회전." #: ../../annot.rst:443 0e4000b23bd0487692990ba93841e11b msgid "" "a value [-1, 359]. If rotation is not at all, -1 is returned (and implies" " a rotation angle of 0). Other possible values are normalized to some " "value value 0 <= angle < 360." msgstr "[-1, 359] 값. 회전이 전혀 없는 경우 -1이 반환됩니다(회전 각도 0을 의미). 다른 가능한 값은 0 <= angle < 360 값으로 정규화됩니다." #: ../../annot.rst:447 675380b4c5e64bf7bff950dcc720a751 msgid "The rectangle containing the annotation." msgstr "주석을 포함하는 사각형." #: ../../annot.rst:449 ../../annot.rst:549 aebdf20a1fda46b7abc7b4c3e0493882 #: ec14799005724be998a1275792677a12 msgid ":ref:`Rect`" msgstr "" #: ../../annot.rst:453 c70b9c19d6d84a359b2b1a7396054162 msgid "The next annotation on this page or None." msgstr "이 페이지의 다음 주석 또는 None." #: ../../annot.rst:455 e2f9dcc59c714b54a43f67ec7b62cff8 msgid "*Annot*" msgstr "" #: ../../annot.rst:459 606bb69f415d48c0a7aad4dac9c69fc3 msgid "" "A number and one or two strings describing the annotation type, like " "**[2, 'FreeText', 'FreeTextCallout']**. The second string entry is " "optional and may be empty. See the appendix :ref:`AnnotationTypes` for a " "list of possible values and their meanings." msgstr "주석 타입을 설명하는 숫자와 하나 또는 두 개의 문자열, 예: **[2, 'FreeText', 'FreeTextCallout']**. 두 번째 문자열 항목은 선택 사항이며 비어 있을 수 있습니다. 가능한 값과 의미 목록은 부록 :ref:`AnnotationTypes` 를 참조하세요." #: ../../annot.rst:465 814b528ad1594607875ed97510496fe2 msgid "" "A dictionary containing various information. All fields are optional " "strings. For information items not provided, an empty string is returned." msgstr "다양한 정보를 포함하는 딕셔너리. 모든 필드는 선택적 문자열입니다. 제공되지 않은 정보 항목의 경우 빈 문자열이 반환됩니다." #: ../../annot.rst:467 132313a5fcff4d5b98ca42e3a4bf5fda msgid "" "*name* -- e.g. for 'Stamp' annotations it will contain the stamp text " "like \"Sold\" or \"Experimental\", for other annot types you will see the" " name of the annot's icon here (\"PushPin\" for FileAttachment)." msgstr "*name* -- 예를 들어 'Stamp' 주석의 경우 \"Sold\" 또는 \"Experimental\"와 같은 스탬프 텍스트를 포함하고, 다른 주석 타입의 경우 여기에서 주석 아이콘의 이름을 볼 수 있습니다(FileAttachment의 경우 \"PushPin\")." #: ../../annot.rst:469 bc6c85b50da94924bc357226258bd3fc msgid "" "*content* -- a string containing the text for type *Text* and *FreeText* " "annotations. Commonly used for filling the text field of annotation pop-" "up windows." msgstr "*content* -- *Text* 및 *FreeText* 주석에 대한 텍스트를 포함하는 문자열. 주석 팝업 창의 텍스트 필드를 채우는 데 일반적으로 사용됩니다." #: ../../annot.rst:471 d7645d31cbb64e3cb699a731902ecb75 msgid "" "*title* -- a string containing the title of the annotation pop-up window." " By convention, this is used for the **annotation author**." msgstr "*title* -- 주석 팝업 창의 제목을 포함하는 문자열. 규칙에 따라 이것은 **주석 작성자** 에 사용됩니다." #: ../../annot.rst:473 ba6e837b12eb4a59b39297c6410293cb msgid "*creationDate* -- creation timestamp." msgstr "*creationDate* -- 생성 타임스탬프." #: ../../annot.rst:474 dea7337d10874b83bd25f6be18463264 msgid "*modDate* -- last modified timestamp." msgstr "*modDate* -- 마지막 수정 타임스탬프." #: ../../annot.rst:475 affe5f09ffd3424b9ff3466bd9fa10e4 msgid "*subject* -- subject." msgstr "*subject* -- 제목." #: ../../annot.rst:476 2839aeb340104f42b830df272fca2fb6 msgid "" "*id* -- *(new in version 1.16.10)* a unique identification of the " "annotation. This is taken from PDF key */NM*. Annotations added by " "PyMuPDF will have a unique name, which appears here." msgstr "*id* -- *(버전 1.16.10의 새로운 기능)* 주석의 고유 식별자. 이것은 PDF 키 */NM* 에서 가져옵니다. PyMuPDF로 추가된 주석은 여기에 나타나는 고유한 이름을 가집니다." #: ../../annot.rst:483 16616c415f6e46b7a3677cfdd3112ce3 msgid "" "An integer whose low order bits contain flags for how the annotation " "should be presented." msgstr "하위 비트에 주석을 표시하는 방법에 대한 플래그를 포함하는 정수." #: ../../annot.rst:489 8339de6110f3442eae85a3e339d2b60f msgid "" "A pair of integers specifying start and end symbol of annotations types " "'FreeText', 'Line', 'PolyLine', and 'Polygon'. ``None`` if not " "applicable. For possible values and descriptions in this list, see the " ":ref:`AdobeManual`, table 1.76 on page 400." msgstr "'FreeText', 'Line', 'PolyLine', 'Polygon' 주석 타입의 시작 및 끝 심볼을 지정하는 정수 쌍. 적용되지 않는 경우 ``None``. 이 목록의 가능한 값과 설명은 :ref:`AdobeManual`, 400페이지의 표 1.76을 참조하세요." #: ../../annot.rst:495 8bf05b20e751463eae59e5c917d94466 msgid "" "A list containing a variable number of point (\"vertices\") coordinates " "(each given by a pair of floats) for various types of annotations:" msgstr "다양한 타입의 주석에 대한 가변 개수의 포인트(\"vertices\") 좌표(각각 float 쌍으로 제공)를 포함하는 목록:" #: ../../annot.rst:497 8912d31ff3344e5e8152219991bcb863 msgid "'Line' -- the starting and ending coordinates (2 float pairs)." msgstr "'Line' -- 시작 및 종료 좌표(2개의 float 쌍)." #: ../../annot.rst:498 a5b0fa3b850f4856bd236c668f63f1eb msgid "" "'FreeText' -- 2 or 3 float pairs designating the starting, the (optional)" " knee point, and the ending coordinates." msgstr "'FreeText' -- 시작, (선택적) 무릎 포인트, 종료 좌표를 지정하는 2개 또는 3개의 float 쌍." #: ../../annot.rst:499 b0ee60812ba343fea5fc2d15019955f2 msgid "" "'PolyLine' / 'Polygon' -- the coordinates of the edges connected by line " "pieces (n float pairs for n points)." msgstr "'PolyLine' / 'Polygon' -- 라인 조각으로 연결된 가장자리의 좌표(n개 포인트에 대해 n개의 float 쌍)." #: ../../annot.rst:500 8fbc31fb944e4da2868503b7613244d0 msgid "" "text markup annotations -- 4 float pairs specifying the *QuadPoints* of " "the marked text span (see :ref:`AdobeManual`, page 403)." msgstr "텍스트 마크업 주석 -- 표시된 텍스트 스팬의 *QuadPoints* 를 지정하는 4개의 float 쌍(:ref:`AdobeManual`, 403페이지 참조)." #: ../../annot.rst:501 09ceddfd7c4642e187b77e4fe278f331 msgid "" "'Ink' -- list of one to many sublists of vertex coordinates. Each such " "sublist represents a separate line in the drawing." msgstr "'Ink' -- 하나에서 많은 개수의 정점 좌표 하위 목록 목록. 각 하위 목록은 그리기의 별도 라인을 나타냅니다." #: ../../annot.rst:508 e363318aa7cb46ff97b34487bc567275 msgid "" "dictionary of two lists of floats in range *0 <= float <= 1* specifying " "the \"stroke\" and the interior (\"fill\") colors. The stroke color is " "used for borders and everything that is actively painted or written " "(\"stroked\"). The fill color is used for the interior of objects like " "line ends, circles and squares. The lengths of these lists implicitly " "determine the colorspaces used: 1 = GRAY, 3 = RGB, 4 = CMYK. So \"[1.0, " "0.0, 0.0]\" stands for RGB color red. Both lists can be empty if no color" " is specified. Be aware about some potentially unexpected cases:" msgstr "*0 <= float <= 1* 범위의 float 두 목록으로 \"stroke\" 및 내부(\"fill\") 색상을 지정하는 딕셔너리. 스트로크 색상은 테두리와 활성적으로 그려지거나 작성된 모든 것(\"stroked\")에 사용됩니다. 채우기 색상은 라인 끝, 원 및 사각형과 같은 객체의 내부에 사용됩니다. 이러한 목록의 길이는 암묵적으로 사용되는 색상 공간을 결정합니다: 1 = GRAY, 3 = RGB, 4 = CMYK. 따라서 \"[1.0, 0.0, 0.0]\"은 RGB 색상 빨강을 나타냅니다. 색상이 지정되지 않은 경우 두 목록 모두 비어 있을 수 있습니다. 잠재적으로 예상치 못한 경우에 유의하세요:" #: ../../annot.rst:510 c98f3742209a4834b74c3d4385888358 msgid "" "The color of Highlight annotations is a **stroke** color, contrary to " "intuition." msgstr "Highlight 주석의 색상은 직관과 반대로 **stroke** 색상입니다." #: ../../annot.rst:511 2d1b77af92f94df2901498dee3ecf512 msgid "" "The color if FreeText annotations is a **stroke** color, but appears as " "the color that fills the rectangle and any applicable line end symbols. " "Text color and border color cannot be accessed at all." msgstr "FreeText 주석의 색상은 **stroke** 색상이지만, 사각형과 모든 적용 가능한 라인 끝 심볼을 채우는 색상으로 나타납니다. 텍스트 색상과 테두리 색상은 전혀 액세스할 수 없습니다." #: ../../annot.rst:517 5673a83fdd3046e1a25a02e890bf9503 msgid "The PDF :data:`xref`." msgstr "PDF :data:`xref`." #: ../../annot.rst:523 80d30458b0ae4d81a75fccb23e4560df msgid "" "The PDF :data:`xref` of an annotation to which this one responds. Return " "zero if this is no response annotation." msgstr "이 주석이 응답하는 주석의 PDF :data:`xref`. 응답 주석이 아니면 0을 반환합니다." #: ../../annot.rst:529 adc968b773a6471aba76a7111c2340a5 msgid "" "The PDF :data:`xref` of the associated Popup annotation. Zero if non-" "existent." msgstr "연결된 Popup 주석의 PDF :data:`xref`. 존재하지 않으면 0." #: ../../annot.rst:535 87e7894e6b484ea3b6e9b676e28d88b3 msgid "Whether the annotation has a Popup annotation." msgstr "주석에 Popup 주석이 있는지 여부." #: ../../annot.rst:541 a5edaf80b163482b844afac753dce499 msgid "" "Whether the annotation's Popup is open -- **or** the annotation itself " "('Text' annotations only)." msgstr "주석의 Popup이 열려 있는지 여부 -- **또는** 주석 자체('Text' 주석만 해당)." #: ../../annot.rst:547 600f5a64e8a4400da0c1ae35c135efd1 msgid "" "The rectangle of the associated Popup annotation. Infinite rectangle if " "non-existent." msgstr "연결된 Popup 주석의 사각형. 존재하지 않으면 무한 사각형." #: ../../annot.rst:553 9fd4e2374ea64a4f895272c2450db57b msgid "" "A tuple of four floats representing the `/RD` entry of the annotation. " "The four numbers describe the numerical differences (left, top, -right, " "-bottom) between two rectangles: the :attr:`rect` of the annotation and a" " rectangle contained within that rectangle. If the entry is missing, this" " property is `(0, 0, 0, 0)`. If the annotation border is a normal, " "straight line, these numbers are typically border width divided by 2. If " "the annotation has a \"cloudy\" border, you will see the breadth of the " "cloud semi-circles here. In general, the numbers need not be identical. " "To compute the inner rectangle do `a.rect + a.rect_delta`." msgstr "주석의 `/RD` 항목을 나타내는 4개의 float 튜플. 네 숫자는 두 사각형(주석의 :attr:`rect` 와 그 사각형 내에 포함된 사각형) 사이의 수치 차이(왼쪽, 위쪽, -오른쪽, -아래쪽)를 설명합니다. 항목이 없으면 이 속성은 `(0, 0, 0, 0)` 입니다. 주석 테두리가 일반적인 직선인 경우, 이러한 숫자는 일반적으로 테두리 너비를 2로 나눈 값입니다. 주석에 \"cloudy\" 테두리가 있으면 여기에서 클라우드 반원의 폭을 볼 수 있습니다. 일반적으로 숫자가 동일할 필요는 없습니다. 내부 사각형을 계산하려면 `a.rect + a.rect_delta` 를 수행하세요." #: ../../annot.rst:557 76373f31dcbe446392d079eb34532b34 msgid "" "A dictionary containing border characteristics. Empty if no border " "information exists. The following keys may be present:" msgstr "테두리 특성을 포함하는 딕셔너리. 테두리 정보가 없으면 비어 있습니다. 다음 키가 있을 수 있습니다:" #: ../../annot.rst:559 2a2fab2fdf524b6184a1f5b62304135a msgid "" "*width* -- a float indicating the border thickness in points. The value " "is -1.0 if no width is specified." msgstr "*width* -- 포인트 단위의 테두리 두께를 나타내는 float. 너비가 지정되지 않으면 값은 -1.0입니다." #: ../../annot.rst:561 ee7176832c7e4740b78bb806706a9d04 msgid "" "*dashes* -- a sequence of integers specifying a line dashing pattern. " "*[]* means no dashes, *[n]* means equal on-off lengths of *n* points, " "longer lists will be interpreted as specifying alternating on-off length " "values. See the :ref:`AdobeManual` page 126 for more details." msgstr "*dashes* -- 라인 파선 패턴을 지정하는 정수 시퀀스. *[]* 는 파선 없음을 의미하고, *[n]* 는 *n* 포인트의 동일한 on-off 길이를 의미하며, 더 긴 목록은 교대 on-off 길이 값을 지정하는 것으로 해석됩니다. 자세한 내용은 :ref:`AdobeManual` 126페이지를 참조하세요." #: ../../annot.rst:563 994ba35808ba4456b6568752b410a28e msgid "" "*style* -- 1-byte border style: **\"S\"** (Solid) = solid line " "surrounding the annotation, **\"D\"** (Dashed) = dashed line surrounding " "the annotation, the dash pattern is specified by the *dashes* entry, " "**\"B\"** (Beveled) = a simulated embossed rectangle that appears to be " "raised above the surface of the page, **\"I\"** (Inset) = a simulated " "engraved rectangle that appears to be recessed below the surface of the " "page, **\"U\"** (Underline) = a single line along the bottom of the " "annotation rectangle." msgstr "*style* -- 1바이트 테두리 스타일: **\"S\"** (Solid) = 주석을 둘러싸는 실선, **\"D\"** (Dashed) = 주석을 둘러싸는 파선, 파선 패턴은 *dashes* 항목으로 지정됨, **\"B\"** (Beveled) = 페이지 표면 위에 올라간 것처럼 보이는 시뮬레이션된 볼록 사각형, **\"I\"** (Inset) = 페이지 표면 아래로 움푹 들어간 것처럼 보이는 시뮬레이션된 조각 사각형, **\"U\"** (Underline) = 주석 사각형의 하단을 따른 단일 라인." #: ../../annot.rst:565 7700bc48fde44a268bcd7c4a8afa5304 msgid "" "*clouds* -- an integer indicating a \"cloudy\" border, where ``n`` is an " "integer `-1 <= n <= 2`. A value `n = 0` indicates a straight line (no " "clouds), 1 means small and 2 means large semi-circles, mimicking the " "cloudy appearance. If -1, then no specification is present." msgstr "*clouds* -- \"cloudy\" 테두리를 나타내는 정수, 여기서 ``n`` 은 정수 `-1 <= n <= 2`. 값 `n = 0` 은 직선(클라우드 없음)을 나타내고, 1은 작은 반원을, 2는 큰 반원을 의미하여 클라우드 모양을 모방합니다. -1이면 지정이 없습니다." #: ../../annot.rst:573 332ac742d76d48529ceb6b4e40f7295a msgid "Annotation Icons in MuPDF" msgstr "MuPDF의 주석 아이콘" #: ../../annot.rst:574 21859a0e63974afa950419ab98ff55e6 msgid "" "This is a list of icons referenceable by name for annotation types 'Text'" " and 'FileAttachment'. You can use them via the *icon* parameter when " "adding an annotation, or use the as argument in :meth:`Annot.set_name`. " "It is left to your discretion which item to choose when -- no mechanism " "will keep you from using e.g. the \"Speaker\" icon for a " "'FileAttachment'." msgstr "이것은 'Text' 및 'FileAttachment' 주석 타입에 대해 이름으로 참조할 수 있는 아이콘 목록입니다. 주석을 추가할 때 *icon* 매개변수를 통해 사용하거나 :meth:`Annot.set_name` 의 인수로 사용할 수 있습니다. 어떤 항목을 선택할지는 사용자의 재량에 맡겨집니다 -- 예를 들어 'FileAttachment'에 \"Speaker\" 아이콘을 사용하는 것을 막는 메커니즘은 없습니다." #: ../../annot.rst:580 cb12c1793cdb4341b24fbf6538c60d1c msgid "Example" msgstr "예제" #: ../../annot.rst:581 a2296e47889a4fec983f5aa41e485291 msgid "" "Change the graphical image of an annotation. Also update the \"author\" " "and the text to be shown in the popup window::" msgstr "주석의 그래픽 이미지를 변경합니다. 또한 팝업 창에 표시될 \"author\" 및 텍스트를 업데이트합니다::" #: ../../annot.rst:604 7bff751c7d604fe38047b43fdeb95933 msgid "" "This is how the circle annotation looks like before and after the change " "(pop-up windows displayed using Nitro PDF viewer):" msgstr "변경 전후의 원 주석 모습입니다(Nitro PDF 뷰어를 사용하여 표시된 팝업 창):" #: ../../annot.rst:606 479b5bc5389b486e92aaf64c6226c673 msgid "|circle|" msgstr "" #: ../../annot.rst:608 031e9835b5ea4674bd3bcd678ae780a5 #: 8bea81da58c844a9abeb9a5253d1a9b6 msgid "circle" msgstr "circle" #: ../../annot.rst:612 a8717fc2c8cd4706b95166aae42c2f9b msgid "Footnotes" msgstr "각주" #: ../../annot.rst:613 6d03771b774345a5b005846ee4002288 msgid "" "Rotating an annotation also changes its rectangle. Depending on how the " "annotation was defined, the original rectangle is **cannot be " "reconstructed** by setting the rotation value to zero again and will be " "lost." msgstr "주석을 회전시키면 사각형도 변경됩니다. 주석이 정의된 방식에 따라 원래 사각형은 회전 값을 다시 0으로 설정해도 **재구성할 수 없으며** 손실됩니다." #: ../../annot.rst:615 c6c9d602fa054b6fac8c6ec2c52ad078 msgid "" "Only the following annotation types support method " ":meth:`Annot.set_rect`: Text, FreeText, Square, Circle, Redact, Stamp, " "Caret, FileAttachment, Sound, and Movie." msgstr "다음 주석 타입만 :meth:`Annot.set_rect` 메서드를 지원합니다: Text, FreeText, Square, Circle, Redact, Stamp, Caret, FileAttachment, Sound, Movie." #: ../../footer.rst:46 bc670bbcee16481398498b6cc9d3f828 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/app1.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b63e36b67e8a44e789752decae758e83 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 e0da5e0d85184ed69a42ef8e32e4ed85 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 e06822680b004870af6da375e9614933 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../app1.rst:7 4aa59227e1bc4902938be155b3c846ab msgid "Appendix 1: Details on Text Extraction" msgstr "부록 1: 텍스트 추출에 대한 세부사항" #: ../../app1.rst:8 c4a15e5247104a09bb9b36ac199c0a28 msgid "" "This chapter provides background on the text extraction methods of " "PyMuPDF." msgstr "이 장은 |PyMuPDF| 의 텍스트 추출 메서드에 대한 배경 정보를 제공합니다." #: ../../app1.rst:10 2e9bc8cf9b71428b8520ed5b6afad430 msgid "Information of interest are" msgstr "관심 있는 정보는 다음과 같습니다" #: ../../app1.rst:12 0deb2f883f5f4387bde429329f1bae7b msgid "what do they provide?" msgstr "그들이 무엇을 제공하는가?" #: ../../app1.rst:13 45c9c32702024484bdb3305c7e87faf7 msgid "what do they imply (processing time / data sizes)?" msgstr "그들이 무엇을 의미하는가(처리 시간 / 데이터 크기)?" #: ../../app1.rst:16 fde4b48bf0784a33849cd72c5d22218c msgid "General structure of a TextPage" msgstr "TextPage의 일반적인 구조" #: ../../app1.rst:17 7fc02c7d51cd42079849d6836d102acc msgid "" ":ref:`TextPage` is one of (Py-) MuPDF's classes. It is normally created " "(and destroyed again) behind the curtain, when :ref:`Page` text " "extraction methods are used, but it is also available directly and can be" " used as a persistent object. Other than its name suggests, images may " "optionally also be part of a text page::" msgstr ":ref:`TextPage` 는 (Py-) |MuPDF| 의 클래스 중 하나입니다. 일반적으로 :ref:`Page` 텍스트 추출 메서드가 사용될 때 배후에서 생성(그리고 다시 파괴)되지만, 직접 사용할 수도 있으며 영구 객체로 사용할 수 있습니다. 이름이 시사하는 것과 달리, 이미지는 선택적으로 텍스트 페이지의 일부일 수도 있습니다::" #: ../../app1.rst:27 66fcac07e660407fa94a50c99aacdd57 msgid "A **text page** consists of blocks (= roughly paragraphs)." msgstr "**텍스트 페이지** 는 블록(= 대략 단락)으로 구성됩니다." #: ../../app1.rst:29 0be706ea23474e148d6ac4453252bd47 msgid "A **block** consists of either lines and their characters, or an image." msgstr "**블록** 은 행과 그 문자, 또는 이미지로 구성됩니다." #: ../../app1.rst:31 c0a517869bb34a7d97003a5aef98fd51 msgid "A **line** consists of spans." msgstr "**행** 은 스팬으로 구성됩니다." #: ../../app1.rst:33 517dd3b2b07645b8b02c39add65933dd msgid "" "A **span** consists of adjacent characters with identical font " "properties: name, size, flags and color." msgstr "**스팬** 은 동일한 글꼴 속성(이름, 크기, 플래그 및 색상)을 가진 인접한 문자로 구성됩니다." #: ../../app1.rst:36 275e9dfe8a8c43eaac52d976da135915 msgid "Plain Text" msgstr "일반 텍스트" #: ../../app1.rst:38 9d36b5923a304f7a9edbb308a34e087e msgid "" "Function :meth:`TextPage.extractText` (or *Page.get_text(\"text\")*) " "extracts a page's plain **text in original order** as specified by the " "creator of the document." msgstr "함수 :meth:`TextPage.extractText` (또는 *Page.get_text(\"text\")*) 는 문서 작성자가 지정한 대로 페이지의 일반 **텍스트를 원래 순서대로** 추출합니다." #: ../../app1.rst:40 a844cfb991fb44ba922960d023c28deb msgid "An example output::" msgstr "예제 출력::" #: ../../app1.rst:45 83c6c339e3924476b41ff9b80c5e50d9 msgid "" "The output may not equal an accustomed \"natural\" reading order. " "However, you can request a reordering following the scheme \"top-left to " "bottom-right\" by executing `page.get_text(\"text\", sort=True)`." msgstr "출력이 익숙한 \"자연스러운\" 읽기 순서와 같지 않을 수 있습니다. 그러나 `page.get_text(\"text\", sort=True)` 를 실행하여 \"왼쪽 위에서 오른쪽 아래로\" 체계에 따라 재정렬을 요청할 수 있습니다." #: ../../app1.rst:49 ../../app1.rst:337 19e4af19f3d74a33909a5898279c5eab #: 4eb48dd8cc9e4ac88b8890d5ed10f9a7 msgid "BLOCKS" msgstr "BLOCKS" #: ../../app1.rst:51 686c7ad1dcf54c52be5a45853aad1f78 msgid "" "Function :meth:`TextPage.extractBLOCKS` (or *Page.get_text(\"blocks\")*) " "extracts a page's text blocks as a list of items like::" msgstr "함수 :meth:`TextPage.extractBLOCKS` (또는 *Page.get_text(\"blocks\")*) 는 페이지의 텍스트 블록을 다음과 같은 항목 목록으로 추출합니다::" #: ../../app1.rst:55 c216dd1a83d846b19dfbfc40fbbb3a86 msgid "" "Where the first 4 items are the float coordinates of the block's bbox. " "The lines within each block are concatenated by a new-line character." msgstr "여기서 처음 4개 항목은 블록의 bbox의 부동 소수점 좌표입니다. 각 블록 내의 행은 줄바꿈 문자로 연결됩니다." #: ../../app1.rst:57 ac5e7636040b407abf4b4c74f54734e6 msgid "" "This is a high-speed method, which by default also extracts image meta " "information: Each image appears as a block with one text line, which " "contains meta information. The image itself is not shown." msgstr "이것은 고속 메서드이며, 기본적으로 이미지 메타 정보도 추출합니다: 각 이미지는 메타 정보를 포함하는 하나의 텍스트 행이 있는 블록으로 나타납니다. 이미지 자체는 표시되지 않습니다." #: ../../app1.rst:59 493c35f505154b66a5413eb8aae3f20b msgid "" "As with simple text output above, the `sort` argument can be used as well" " to obtain a reading order." msgstr "위의 간단한 텍스트 출력과 마찬가지로 `sort` 인수를 사용하여 읽기 순서를 얻을 수 있습니다." #: ../../app1.rst:61 ../../app1.rst:79 3b27a871707241fab31e8b57d54a181b #: 72a6a0bd50b84a369ab338f015c7c0c5 msgid "Example output::" msgstr "예제 출력::" #: ../../app1.rst:69 ../../app1.rst:338 2b7c8cb324cd43a5935bad475501fbba #: ac2182e6a5334397ba4cba52f6a0ecbb msgid "WORDS" msgstr "WORDS" #: ../../app1.rst:71 bd891cd06d344be6a34c3533eef6b2b1 msgid "" "Function :meth:`TextPage.extractWORDS` (or *Page.get_text(\"words\")*) " "extracts a page's text **words** as a list of items like::" msgstr "함수 :meth:`TextPage.extractWORDS` (또는 *Page.get_text(\"words\")*) 는 페이지의 텍스트 **단어** 를 다음과 같은 항목 목록으로 추출합니다::" #: ../../app1.rst:75 7b33ff6ba92d470f8bab020fcd37037d msgid "" "Where the first 4 items are the float coordinates of the words's bbox. " "The last three integers provide some more information on the word's " "whereabouts." msgstr "여기서 처음 4개 항목은 단어의 bbox의 부동 소수점 좌표입니다. 마지막 세 정수는 단어의 위치에 대한 추가 정보를 제공합니다." #: ../../app1.rst:77 d553fb9cb8484714ba2faab69dc0c761 msgid "" "This is a high-speed method. As with the previous methods, argument " "`sort=True` will reorder the words." msgstr "이것은 고속 메서드입니다. 이전 메서드와 마찬가지로 인수 `sort=True` 는 단어를 재정렬합니다." #: ../../app1.rst:95 ../../app1.rst:341 4c71524cc80240d8a4a615692160ee42 #: 6e202dc149ab40d4a04fbf729bde5724 msgid "HTML" msgstr "HTML" #: ../../app1.rst:97 279a64262cf0486490e50a36ebcb9fc4 msgid "" ":meth:`TextPage.extractHTML` (or *Page.get_text(\"html\")* output fully " "reflects the structure of the page's ``TextPage`` -- much like DICT / " "JSON below. This includes images, font information and text positions. If" " wrapped in HTML header and trailer code, it can readily be displayed by " "an internet browser. Our above example::" msgstr ":meth:`TextPage.extractHTML` (또는 *Page.get_text(\"html\")* 출력은 페이지의 ``TextPage`` 구조를 완전히 반영합니다 -- 아래의 DICT / JSON과 매우 유사합니다. 이것은 이미지, 글꼴 정보 및 텍스트 위치를 포함합니다. HTML 헤더 및 트레일러 코드로 감싸면 인터넷 브라우저에서 쉽게 표시할 수 있습니다. 위의 예제::" #: ../../app1.rst:113 a754b6fee5f44c9e9763dd071ea484d3 msgid "Controlling Quality of HTML Output" msgstr "HTML 출력 품질 제어" #: ../../app1.rst:114 9d69d29a89e34b598cab8061b0df6acb msgid "" "While HTML output has improved a lot in MuPDF v1.12.0, it is not yet bug-" "free: we have found problems in the areas **font support** and **image " "positioning**." msgstr "|MuPDF| v1.12.0에서 HTML 출력이 많이 개선되었지만, 아직 버그가 없지는 않습니다: **글꼴 지원** 및 **이미지 위치 지정** 영역에서 문제를 발견했습니다." #: ../../app1.rst:116 e323aee6a8184c43b04054264f0ad164 msgid "" "HTML text contains references to the fonts used of the original document." " If these are not known to the browser (a fat chance!), it will replace " "them with others; the results will probably look awkward. This issue " "varies greatly by browser -- on my Windows machine, MS Edge worked just " "fine, whereas Firefox looked horrible." msgstr "HTML 텍스트에는 원본 문서에서 사용된 글꼴에 대한 참조가 포함되어 있습니다. 브라우저가 이를 알지 못하면(가능성은 낮지만!) 다른 것으로 대체할 수 있으며, 결과가 어색해 보일 수 있습니다. 이 문제는 브라우저에 따라 크게 다릅니다 -- Windows 머신에서 MS Edge는 잘 작동했지만 Firefox는 형편없이 보였습니다." #: ../../app1.rst:118 a3e819ae14b54c27a9a077e7e935cb86 msgid "" "For PDFs with a complex structure, images may not be positioned and / or " "sized correctly. This seems to be the case for rotated pages and pages, " "where the various possible page bbox variants do not coincide (e.g. " "*MediaBox != CropBox*). We do not know yet, how to address this -- we " "filed a bug at MuPDF's site." msgstr "복잡한 구조를 가진 PDF의 경우 이미지가 올바르게 위치 지정되거나 크기 조정되지 않을 수 있습니다. 이것은 회전된 페이지와 다양한 가능한 페이지 bbox 변형이 일치하지 않는 페이지(예: *MediaBox != CropBox*)의 경우인 것 같습니다. 이것을 해결하는 방법은 아직 알지 못합니다 -- |MuPDF| 사이트에 버그를 제출했습니다." #: ../../app1.rst:120 eb269d37c6994ea68a4d82c390bd674f msgid "" "To address the font issue, you can use a simple utility script to scan " "through the HTML file and replace font references. Here is a little " "example that replaces all fonts with one of the :ref:`Base-14-Fonts`: " "serifed fonts will become \"Times\", non-serifed \"Helvetica\" and " "monospaced will become \"Courier\". Their respective variations for " "\"bold\", \"italic\", etc. are hopefully done correctly by your browser::" msgstr "글꼴 문제를 해결하기 위해 HTML 파일을 스캔하고 글꼴 참조를 교체하는 간단한 유틸리티 스크립트를 사용할 수 있습니다. 다음은 모든 글꼴을 :ref:`Base-14-Fonts` 중 하나로 교체하는 작은 예제입니다: 세리프 글꼴은 \"Times\"가 되고, 비세리프 글꼴은 \"Helvetica\"가 되며, 고정폭 글꼴은 \"Courier\"가 됩니다. \"bold\", \"italic\" 등에 대한 각각의 변형은 브라우저에서 올바르게 처리되기를 바랍니다::" #: ../../app1.rst:160 9a01edbae3494fb6bcfa415551ffe12d msgid "DICT (or JSON)" msgstr "DICT (또는 JSON)" #: ../../app1.rst:162 dc5943b2ac244ae3bd4c1c3cced27b9a msgid "" ":meth:`TextPage.extractDICT` (or *Page.get_text(\"dict\", sort=False)*) " "output fully reflects the structure of a ``TextPage`` and provides image " "content and position detail (*bbox* -- boundary boxes in pixel units) for" " every block, line and span. Images are stored as *bytes* for DICT output" " and base64 encoded strings for JSON output." msgstr ":meth:`TextPage.extractDICT` (또는 *Page.get_text(\"dict\", sort=False)*) 출력은 ``TextPage`` 구조를 완전히 반영하며 모든 블록, 행 및 스팬에 대한 이미지 콘텐츠 및 위치 세부 정보(*bbox* -- 픽셀 단위의 경계 상자)를 제공합니다. 이미지는 DICT 출력의 경우 *bytes* 로 저장되고 JSON 출력의 경우 base64 인코딩된 문자열로 저장됩니다." #: ../../app1.rst:164 c83998d97cb54af2a6c9e8ee068e02d3 msgid "" "For a visualization of the dictionary structure have a look at " ":ref:`textpagedict`." msgstr "딕셔너리 구조의 시각화는 :ref:`textpagedict` 를 참조하세요." #: ../../app1.rst:166 dd7c1a96c694470682bfdfceee248a97 msgid "Here is how this looks like::" msgstr "다음은 이것이 어떻게 보이는지입니다::" #: ../../app1.rst:192 c2fb2cd52f07453b86d0afd6278fef62 msgid "RAWDICT (or RAWJSON)" msgstr "RAWDICT (또는 RAWJSON)" #: ../../app1.rst:193 7d7646fe8d554083af47f4d372febdde msgid "" ":meth:`TextPage.extractRAWDICT` (or *Page.get_text(\"rawdict\", " "sort=False)*) is an **information superset of DICT** and takes the detail" " level one step deeper. It looks exactly like the above, except that the " "*\"text\"* items (*string*) in the spans are replaced by the list " "*\"chars\"*. Each *\"chars\"* entry is a character *dict*. For example, " "here is what you would see in place of item *\"text\": \"Text in black " "color.\"* above::" msgstr ":meth:`TextPage.extractRAWDICT` (또는 *Page.get_text(\"rawdict\", sort=False)*) 는 **DICT의 정보 상위 집합** 이며 세부 수준을 한 단계 더 깊게 가져갑니다. 위와 정확히 같아 보이지만, 스팬의 *\"text\"* 항목(*string*)이 *\"chars\"* 목록으로 대체됩니다. 각 *\"chars\"* 항목은 문자 *dict* 입니다. 예를 들어, 위의 *\"text\": \"Text in black color.\"* 항목 대신 다음과 같은 것을 볼 수 있습니다::" #: ../../app1.rst:224 ../../app1.rst:339 2400046f9c4f49858da21224a19d4b15 #: 2d3722af4f584209bd8eaab07e032c6d msgid "XML" msgstr "XML" #: ../../app1.rst:226 c5a5b0c5667b42278fbebec3ebb83fab msgid "" "The :meth:`TextPage.extractXML` (or *Page.get_text(\"xml\")*) version " "extracts text (no images) with the detail level of RAWDICT::" msgstr ":meth:`TextPage.extractXML` (또는 *Page.get_text(\"xml\")*) 버전은 RAWDICT의 세부 수준으로 텍스트(이미지 없음)를 추출합니다::" #: ../../app1.rst:255 76940447ff984e9f8267433f30622b18 msgid "" "We have successfully tested `lxml `_ to " "interpret this output." msgstr "이 출력을 해석하기 위해 `lxml `_ 를 성공적으로 테스트했습니다." #: ../../app1.rst:258 ../../app1.rst:340 a405be8a4b8c4148920284c0af5d2a21 #: def99570eabf40eb9a2296563cf87c89 msgid "XHTML" msgstr "XHTML" #: ../../app1.rst:259 f860ba05b7b84b0cbbd677dfb53ba52c msgid "" ":meth:`TextPage.extractXHTML` (or *Page.get_text(\"xhtml\")*) is a " "variation of TEXT but in HTML format, containing the bare text and images" " (\"semantic\" output)::" msgstr ":meth:`TextPage.extractXHTML` (또는 *Page.get_text(\"xhtml\")*) 는 TEXT의 변형이지만 HTML 형식이며, 일반 텍스트와 이미지를 포함합니다(\"의미론적\" 출력)::" #: ../../app1.rst:268 0f8064883834458ab08418752216e011 msgid "Text Extraction Flags Defaults" msgstr "텍스트 추출 플래그 기본값" #: ../../app1.rst:269 8ba849c311aa457d85362ff7f4f1819e msgid "" "New in version 1.16.2: Method :meth:`Page.get_text` supports a keyword " "parameter *flags* *(int)* to control the amount and the quality of " "extracted data. The following table shows the defaults settings (flags " "parameter omitted or None) for each extraction variant. If you specify " "flags with a value other than ``None``, be aware that you must set **all " "desired** options. A description of the respective bit settings can be " "found in :ref:`TextPreserve`." msgstr "버전 1.16.2의 새로운 기능: 메서드 :meth:`Page.get_text` 는 추출된 데이터의 양과 품질을 제어하는 키워드 매개변수 *flags* *(int)* 를 지원합니다. 다음 표는 각 추출 변형에 대한 기본 설정(플래그 매개변수 생략 또는 None)을 보여줍니다. ``None`` 이 아닌 값으로 플래그를 지정하는 경우 **모든 원하는** 옵션을 설정해야 합니다. 각 비트 설정에 대한 설명은 :ref:`TextPreserve` 에서 찾을 수 있습니다." #: ../../app1.rst:271 d40d16d07939413e8c75c3dc13b1127c msgid "" "New in v1.19.6: The default combinations in the following table are now " "available as Python constants: :data:`TEXTFLAGS_TEXT`, " ":data:`TEXTFLAGS_WORDS`, :data:`TEXTFLAGS_BLOCKS`, " ":data:`TEXTFLAGS_DICT`, :data:`TEXTFLAGS_RAWDICT`, " ":data:`TEXTFLAGS_HTML`, :data:`TEXTFLAGS_XHTML`, :data:`TEXTFLAGS_XML`, " "and :data:`TEXTFLAGS_SEARCH`. You can now easily modify a default flag, " "e.g." msgstr "v1.19.6의 새로운 기능: 다음 표의 기본 조합은 이제 Python 상수로 사용할 수 있습니다: :data:`TEXTFLAGS_TEXT`, :data:`TEXTFLAGS_WORDS`, :data:`TEXTFLAGS_BLOCKS`, :data:`TEXTFLAGS_DICT`, :data:`TEXTFLAGS_RAWDICT`, :data:`TEXTFLAGS_HTML`, :data:`TEXTFLAGS_XHTML`, :data:`TEXTFLAGS_XML`, 및 :data:`TEXTFLAGS_SEARCH`. 이제 기본 플래그를 쉽게 수정할 수 있습니다. 예를 들어:" #: ../../app1.rst:273 dc924700aa9b4042894cae14679d63f2 msgid "**include** images in a \"blocks\" output:" msgstr "\"blocks\" 출력에 이미지를 **포함**:" #: ../../app1.rst:275 3d7561abbff8475c825b8d983783bf39 msgid "`flags = TEXTFLAGS_BLOCKS | TEXT_PRESERVE_IMAGES`" msgstr "`flags = TEXTFLAGS_BLOCKS | TEXT_PRESERVE_IMAGES`" #: ../../app1.rst:277 4ca8d0166e4646bd80fcc1d69f340a95 msgid "**exclude** images from a \"dict\" output:" msgstr "\"dict\" 출력에서 이미지를 **제외**:" #: ../../app1.rst:279 1a2e1663435b4abaa1b188e5d6bd9338 msgid "`flags = TEXTFLAGS_DICT & ~TEXT_PRESERVE_IMAGES`" msgstr "`flags = TEXTFLAGS_DICT & ~TEXT_PRESERVE_IMAGES`" #: ../../app1.rst:281 d3769cd425ff4854b0e4292af9c3a0e1 msgid "set **dehyphenation off** in text searches:" msgstr "텍스트 검색에서 **하이픈 제거를 끔**:" #: ../../app1.rst:283 2365979a4e104875a8c468496909f03d msgid "`flags = TEXTFLAGS_SEARCH & ~TEXT_DEHYPHENATE`" msgstr "`flags = TEXTFLAGS_SEARCH & ~TEXT_DEHYPHENATE`" #: ../../app1.rst:287 6f7f786332d34c359591ddf8d17a374b msgid "Indicator" msgstr "표시기" #: ../../app1.rst:287 5f2792809a9645ccaa7c3103a8c35f60 msgid "text" msgstr "text" #: ../../app1.rst:287 9330883adb104a8b880b90565531cf78 msgid "html" msgstr "html" #: ../../app1.rst:287 ead5e0f63b1849fcad0e1d2b7e718887 msgid "xhtml" msgstr "xhtml" #: ../../app1.rst:287 6c6f9476a4614058833f45708bdc20be msgid "xml" msgstr "xml" #: ../../app1.rst:287 0248ca12579948d7a86695462a79fdcb msgid "dict" msgstr "dict" #: ../../app1.rst:287 e7d633c232874f17bede991cf837d6c3 msgid "rawdict" msgstr "rawdict" #: ../../app1.rst:287 7fa4130e9ccf41c4a89237b146f501ef msgid "words" msgstr "words" #: ../../app1.rst:287 34941a4200304d7492e796f779d70af9 msgid "blocks" msgstr "blocks" #: ../../app1.rst:287 29648526b349495e89efdba8501f7d58 msgid "search" msgstr "search" #: ../../app1.rst:289 a7ced22ad3514aee9d5860e7a63e2585 msgid "preserve ligatures" msgstr "합자 유지" #: ../../app1.rst:289 ../../app1.rst:290 ../../app1.rst:291 ../../app1.rst:293 #: ../../app1.rst:294 ../../app1.rst:295 0cb4cd763ef542608c195c6460b399dc #: 0f43651d2736498e96beed8c24af63e9 20bddcebf4b543228091164700c68887 #: 25d6766e4acb4fc49ec8e4fc1eb66529 2bc4aa25150c4d8c9902fd0ce38a2999 #: 2bd684139d2e454d819cd76bed2bd102 2e7049fda6e14a2ca9a522be96770d00 #: 2ea03f7b7fb14b7a976160f27232430c 48e9b5e2fdf046c8a01ae4b5cf3d92b7 #: 51fcf587aa804e63a7afdca232a5123e 530e59a3a9bd4518859c2074f4a8fb16 #: 5650d9d0ff634f79a775ea6061792d1e 57fc8ce1840144cfac20f2ad74fc2830 #: 58b687804f9f44f78d42f22ec402f444 592dbaf3091e4acebbebdacbc132c557 #: 5fe9aa6f8b084af9b13c0b18aabd3924 6a11a4e3a9ea4e17b2f62dac6565c592 #: 7e477874caf041e4bfdb2b9715ca466b 8558f363af2e463c86807ec68536a6fe #: 856d9f908ce4492d9d6e4d9942aeaf71 a030d647ca2549b28cd1f8423e3250ab #: a0b1d47cb17f47bf8e80bb4647de9186 a1764775c19e4c57936ebdd4291fc8bb #: ad1ab38b1e5448a784ec98ef8c12df3a b06d0e59e44649a28ad4fc081b0cee19 #: b4f9c2410ff243ecab4fc54dc7d849e9 bfcb17e586004c2886905b1b94eeed1d #: c0f6469d6bc44f709be506a3cdd9a339 c96eb459feb14f60ad45b43c108367f9 #: d53f99316ae94e71b4d4480f84277945 d5838173cacf47a2b9d2d7ab0f3cbab0 #: d5b75f9369ea4ceba86c82894b7cad40 d87075ec3a7d4392aed8b7b4266e41a4 #: e13a6d7235c14b3fb15384adaba80ce9 e2ded0a0075c4d9e931b78360a6cef6b #: e93caf9105d0420c9d8bb40bbf2cdf90 eab3ab57cb1548baaf7011b0604ed429 #: f0220244eb534ddda9c6a22290717a50 f7971b72219d4d95b439b84693a28f73 msgid "1" msgstr "" #: ../../app1.rst:289 ../../app1.rst:291 ../../app1.rst:292 ../../app1.rst:293 #: ../../app1.rst:295 011c44af019c41c298922bebee1b1c11 #: 12c4cb08b28542d49005e9339fe0834c 1c35e49b6df44d79bff74df1b4d78b83 #: 21f7a63996d64dcb83a41b385bdfe468 31af0f63c4434ef3b9b3bf48be4f77a8 #: 3b439777a243470cbeaa2171bb389696 428e7a5d17e14bd2823284322ebe8792 #: 43fd32ccc6b84942abf31f7c7066b718 46be00d2353b4350993b3ade6d4555e5 #: 517834e9ea544ee48a80774f32298485 594207767efc47ac9b5174f8d44bc078 #: 5fad2f44f76842fdae75090a3d39fe7a 6273d3b284c94893ae7f4cee674e31bf #: 9e452b6cb65f4c7ea9fe05f5e312a3e8 a577f5deaa234a9a8a05f26b7c1b7368 #: b28c3e3b6015418c983c625e5bc7f5b5 b4566a369cf745989dcdde6fb5650bb8 #: bf6d2bf8b3bf4c26b4f6c86f2dd651a6 c984d40f754d445c9df1e4477d112414 #: dab827d3d3944e789a78bf1474d0f410 ded8f8ccfe914788a0b031d4fa55fb21 msgid "0" msgstr "" #: ../../app1.rst:290 d4a8b0082348457c9b3a7f0c83dde31d msgid "preserve whitespace" msgstr "공백 유지" #: ../../app1.rst:291 7cff9f000b1f41abbca9effe3a08af35 msgid "preserve images" msgstr "이미지 유지" #: ../../app1.rst:291 2dbd9b27a6ad426cb7dcc9be3911020b #: c63946a2a43041a995ca0fbeb23153ef d209151eb3624d868e0ce8d60b9347b8 msgid "n/a" msgstr "해당 없음" #: ../../app1.rst:292 5a4bb22be2824af98d9db38f003324d8 msgid "inhibit spaces" msgstr "공백 억제" #: ../../app1.rst:293 cb5ae3cd443344048f5ddc1e916152df msgid "dehyphenate" msgstr "하이픈 제거" #: ../../app1.rst:294 ac1c83a387304202a50381f999e13a9b msgid "clip to mediabox" msgstr "미디어박스로 자르기" #: ../../app1.rst:295 0fec3cdc767c4ecc80645956dbdaa050 msgid "use CID instead of U+FFFD" msgstr "U+FFFD 대신 CID 사용" #: ../../app1.rst:298 3e0abf5ee8404c7c85743a6d0c348e5f msgid "**search** refers to the text search function." msgstr "**search** 는 텍스트 검색 함수를 나타냅니다." #: ../../app1.rst:299 2063c0aa9e6746fca18404258dea465f msgid "**\"json\"** is handled exactly like **\"dict\"** and is hence left out." msgstr "**\"json\"** 은 **\"dict\"** 와 정확히 동일하게 처리되므로 생략되었습니다." #: ../../app1.rst:300 4a5e41e47c864b39a729542c7bb2ae23 msgid "" "**\"rawjson\"** is handled exactly like **\"rawdict\"** and is hence left" " out." msgstr "**\"rawjson\"** 은 **\"rawdict\"** 와 정확히 동일하게 처리되므로 생략되었습니다." #: ../../app1.rst:301 5783eaf8a223417bbb6edf7595657706 msgid "" "An \"n/a\" specification means a value of 0 and setting this bit never " "has any effect on the output (but an adverse effect on performance)." msgstr "\"n/a\" 지정은 값이 0임을 의미하며 이 비트를 설정해도 출력에 영향을 주지 않습니다(하지만 성능에 부정적인 영향을 미칩니다)." #: ../../app1.rst:302 b5dddb0dc411425db6bc1a169ff2a8d4 msgid "" "If you are not interested in images when using an output variant which " "includes them by default, then by all means set the respective bit off: " "You will experience a better performance and much lower space " "requirements." msgstr "기본적으로 이미지를 포함하는 출력 변형을 사용할 때 이미지에 관심이 없다면, 반드시 해당 비트를 끄세요: 더 나은 성능과 훨씬 낮은 공간 요구 사항을 경험할 수 있습니다." #: ../../app1.rst:304 608cc56e35e24516bf555cbdb28b782e msgid "To show the effect of `TEXT_INHIBIT_SPACES` have a look at this example::" msgstr "`TEXT_INHIBIT_SPACES` 의 효과를 보려면 이 예제를 참조하세요::" #: ../../app1.rst:324 73de41a5c50b4025bbb2c6a93243d3b7 msgid "Performance" msgstr "성능" #: ../../app1.rst:325 008bf5834d9c43878d55c1f182c383ad msgid "" "The text extraction methods differ significantly both: in terms of " "information they supply, and in terms of resource requirements and " "runtimes. Generally, more information of course means, that more " "processing is required and a higher data volume is generated." msgstr "텍스트 추출 메서드는 제공하는 정보와 리소스 요구 사항 및 실행 시간 측면에서 모두 크게 다릅니다. 일반적으로 더 많은 정보는 더 많은 처리가 필요하고 더 높은 데이터 볼륨이 생성됨을 의미합니다." #: ../../app1.rst:327 aa82ec64134a4f3bbbea8037e3f3835d #, python-format msgid "" "Especially images have a **very significant** impact. Make sure to " "exclude them (via the *flags* parameter) whenever you do not need them. " "To process the below mentioned 2'700 total pages with default flags " "settings required 160 seconds across all extraction methods. When all " "images where excluded, less than 50% of that time (77 seconds) were " "needed." msgstr "특히 이미지는 **매우 큰** 영향을 미칩니다. 필요하지 않을 때는 반드시 제외하세요(*flags* 매개변수를 통해). 기본 플래그 설정으로 아래에 언급된 총 2,700페이지를 처리하는 데 모든 추출 메서드에서 160초가 필요했습니다. 모든 이미지가 제외되면 그 시간의 50% 미만(77초)이 필요했습니다." #: ../../app1.rst:329 74982287fc904cbe9d5f67869c717cff msgid "" "To begin with, all methods are **very fast** in relation to other " "products out there in the market. In terms of processing speed, we are " "not aware of a faster (free) tool. Even the most detailed method, " "RAWDICT, processes all 1'310 pages of the :ref:`AdobeManual` in less than" " 5 seconds (simple text needs less than 2 seconds here)." msgstr "우선, 모든 메서드는 시장의 다른 제품과 비교하여 **매우 빠릅니다**. 처리 속도 측면에서 더 빠른(무료) 도구는 알지 못합니다. 가장 상세한 메서드인 RAWDICT조차 :ref:`AdobeManual` 의 모든 1,310페이지를 5초 미만으로 처리합니다(여기서는 간단한 텍스트가 2초 미만이 필요합니다)." #: ../../app1.rst:331 83629ccfb7c9414089033b0147642f2e msgid "" "The following table shows average relative speeds (\"RSpeed\", baseline " "1.00 is TEXT), taken across ca. 1400 text-heavy and 1300 image-heavy " "pages." msgstr "다음 표는 약 1400페이지의 텍스트 중심 페이지와 1300페이지의 이미지 중심 페이지에서 가져온 평균 상대 속도(\"RSpeed\", 기준선 1.00은 TEXT)를 보여줍니다." #: ../../app1.rst:334 bc84a1d73aa545a3aca4437e5017ed0e msgid "Method" msgstr "메서드" #: ../../app1.rst:334 9368181159ab4fd6a75aae6bdaa5d189 msgid "RSpeed" msgstr "RSpeed" #: ../../app1.rst:334 7110ef6f2a7c4849a31df08c1bbf7f95 msgid "Comments" msgstr "설명" #: ../../app1.rst:334 e1c0047fd9194edba834839b48102df9 msgid "no images" msgstr "이미지 없음" #: ../../app1.rst:336 4b7a66b4248d47dc9f0ac0139eea5321 msgid "TEXT" msgstr "TEXT" #: ../../app1.rst:336 ../../app1.rst:337 ../../app1.rst:340 #: 25343a3526d44c7e9147a4b83482b458 5c3d7bcdd77648fea697a40e67bab8fc #: 6669d2767e5c49eeb1606eef0ef897e0 e55d755ae5ee4a62bd2e705a1b4974a4 #: f0dcc7f23fa74accb9461d0e6ad00b34 msgid "1.00" msgstr "1.00" #: ../../app1.rst:336 74b3bb1df5a74fe7965c9a036c43b0b6 msgid "no images, **plain** text, line breaks" msgstr "이미지 없음, **일반** 텍스트, 줄바꿈" #: ../../app1.rst:337 db8f0e8c5f874c7bbbc6d938ebde2e18 msgid "image bboxes (only), **block** level text with bboxes, line breaks" msgstr "이미지 bbox(만), **블록** 수준 텍스트와 bbox, 줄바꿈" #: ../../app1.rst:338 075075d180484d1e9a104abafa5c7123 #: 18d11064908b48228b89fe3c8c0d242c msgid "1.02" msgstr "1.02" #: ../../app1.rst:338 b3d7c61c84a84af98ad596efb0959503 msgid "no images, **word** level text with bboxes" msgstr "이미지 없음, **단어** 수준 텍스트와 bbox" #: ../../app1.rst:339 0c5c60a2ef4342038c3a2c60d07bd072 #: ab025008beb540c3af6517c25c3731c8 msgid "2.72" msgstr "2.72" #: ../../app1.rst:339 233b3e8abb32457bb01d804468cd86e2 msgid "no images, **char** level text, layout and font details" msgstr "이미지 없음, **문자** 수준 텍스트, 레이아웃 및 글꼴 세부 정보" #: ../../app1.rst:340 495e91c0090643cd9239576c13e8f216 msgid "3.32" msgstr "3.32" #: ../../app1.rst:340 b4c7e848e2814720ab1d9fbeb303c9f9 msgid "**base64** images, **span** level text, no layout info" msgstr "**base64** 이미지, **스팬** 수준 텍스트, 레이아웃 정보 없음" #: ../../app1.rst:341 e1c73c9152e644efbed95fc738d1ae9d msgid "3.54" msgstr "3.54" #: ../../app1.rst:341 61d71ce102d24fbbb30ff945dc28f207 msgid "**base64** images, **span** level text, layout and font details" msgstr "**base64** 이미지, **스팬** 수준 텍스트, 레이아웃 및 글꼴 세부 정보" #: ../../app1.rst:341 892ba5e6677e4561bfe9a5dc406e3852 msgid "1.01" msgstr "1.01" #: ../../app1.rst:342 5b44d6bc99504bb4bc7e4d457aa5509f msgid "DICT" msgstr "DICT" #: ../../app1.rst:342 bb46e12ef905445f84a825d968043de6 msgid "3.93" msgstr "3.93" #: ../../app1.rst:342 426e28067c23452bb6edeb57689a7855 msgid "**binary** images, **span** level text, layout and font details" msgstr "**바이너리** 이미지, **스팬** 수준 텍스트, 레이아웃 및 글꼴 세부 정보" #: ../../app1.rst:342 16da06be2e1a492c94b26bb12c8c4022 msgid "1.04" msgstr "1.04" #: ../../app1.rst:343 02cf93b26e5f449e95976162924b980c msgid "RAWDICT" msgstr "RAWDICT" #: ../../app1.rst:343 0eddcb199db847968d5f20c520727971 msgid "4.50" msgstr "4.50" #: ../../app1.rst:343 7ae92e67a9f34967b697139a85969bff msgid "**binary** images, **char** level text, layout and font details" msgstr "**바이너리** 이미지, **문자** 수준 텍스트, 레이아웃 및 글꼴 세부 정보" #: ../../app1.rst:343 b31064906dbc405e9e886eab7a219b5f msgid "1.68" msgstr "1.68" #: ../../app1.rst:346 bbe02a1a6ecb4053aea6eac932438250 #, python-format msgid "" "As mentioned: when excluding image extraction (last column), the relative" " speeds are changing drastically: except RAWDICT and XML, the other " "methods are almost equally fast, and RAWDICT requires 40% less execution " "time than the **now slowest XML**." msgstr "언급한 대로: 이미지 추출을 제외하면(마지막 열) 상대 속도가 크게 변합니다: RAWDICT와 XML을 제외하고 다른 메서드는 거의 동일하게 빠르며, RAWDICT는 **이제 가장 느린 XML** 보다 40% 적은 실행 시간이 필요합니다." #: ../../app1.rst:348 c9763e96efa94f389c83973e6830f9cc msgid "Look at chapter **Appendix 1** for more performance information." msgstr "더 많은 성능 정보는 **부록 1** 장을 참조하세요." #: ../../footer.rst:46 ee2a605b55f548d69f51e5e9c010b812 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/app2.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 91d1a3926cf04b7f86982004576a7dac msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 079f5f8f8d67400f8dff2c457815bc6e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 f3ec318cd565440481d5fc24ebd6dd9d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../app2.rst:7 df962b6f73f94a62944d489a625e02f6 msgid "Appendix 2: Considerations on Embedded Files" msgstr "부록 2: 임베디드 파일에 대한 고려사항" #: ../../app2.rst:8 fea3691f2b5d49e3be0cdd79daecdb75 msgid "" "This chapter provides some background on embedded files support in " "PyMuPDF." msgstr "이 장은 |PyMuPDF| 에서 임베디드 파일 지원에 대한 배경 정보를 제공합니다." #: ../../app2.rst:11 e6abfba16abf44f5b53d5c259c06168e msgid "General" msgstr "일반" #: ../../app2.rst:12 2e9ff1e795ec4a80886665b6d98570d1 msgid "" "Starting with version 1.4, PDF supports embedding arbitrary files as part" " (\"Embedded File Streams\") of a PDF document file (see chapter \"7.11.4" " Embedded File Streams\", pp. 103 of the :ref:`AdobeManual`)." msgstr "버전 1.4부터 PDF는 PDF 문서 파일의 일부로 임의의 파일을 임베딩하는 것을 지원합니다(\"Embedded File Streams\" 참조, :ref:`AdobeManual` 의 103페이지 \"7.11.4 Embedded File Streams\" 장 참조)." #: ../../app2.rst:15 3740cf26355f419488a18d5c5bf691e2 msgid "" "In many aspects, this is comparable to concepts also found in ZIP files " "or the OLE technique in MS Windows. PDF embedded files do, however, *not*" " support directory structures as does the ZIP format. An embedded file " "can in turn contain embedded files itself." msgstr "많은 측면에서 이것은 ZIP 파일이나 MS Windows의 OLE 기술에서도 볼 수 있는 개념과 유사합니다. 그러나 PDF 임베디드 파일은 ZIP 형식과 달리 디렉터리 구조를 *지원하지 않습니다*. 임베디드 파일은 차례로 자체적으로 임베디드 파일을 포함할 수 있습니다." #: ../../app2.rst:17 cf0b0ce27ac343a7989b881239cb446f msgid "" "Advantages of this concept are that embedded files are under the PDF " "umbrella, benefitting from its permissions / password protection and " "integrity aspects: all data, which a PDF may reference or even may be " "dependent on, can be bundled into it and so form a single, consistent " "unit of information." msgstr "이 개념의 장점은 임베디드 파일이 PDF의 보호 아래에 있어 권한/비밀번호 보호 및 무결성 측면의 이점을 받는다는 것입니다: PDF가 참조하거나 의존할 수 있는 모든 데이터를 하나로 묶어 단일하고 일관된 정보 단위를 형성할 수 있습니다." #: ../../app2.rst:19 7979fde2425b48d89516fd519a799cb9 msgid "" "In addition to embedded files, PDF 1.7 adds *collections* to its support " "range. This is an advanced way of storing and presenting meta information" " (i.e. arbitrary and extensible properties) of embedded files." msgstr "임베디드 파일 외에도 PDF 1.7은 지원 범위에 *collections* 를 추가합니다. 이것은 임베디드 파일의 메타 정보(즉, 임의의 확장 가능한 속성)를 저장하고 표시하는 고급 방법입니다." #: ../../app2.rst:22 96f7716c2f354c4e9734c53ec68da72d msgid "MuPDF Support" msgstr "|MuPDF| 지원" #: ../../app2.rst:23 c829491b2aaa4844aa1c48047af82974 msgid "" "After adding initial support for collections (portfolios) and " "*/EmbeddedFiles* in MuPDF version 1.11, this support was dropped again in" " version 1.15." msgstr "|MuPDF| 버전 1.11에서 컬렉션(포트폴리오) 및 */EmbeddedFiles* 에 대한 초기 지원을 추가한 후, 이 지원은 버전 1.15에서 다시 제거되었습니다." #: ../../app2.rst:25 f683f1fd707f420b90cc13279f35ebc0 msgid "" "As a consequence, the cli utility *mutool* no longer offers access to " "embedded files." msgstr "결과적으로 CLI 유틸리티 *mutool* 은 더 이상 임베디드 파일에 대한 액세스를 제공하지 않습니다." #: ../../app2.rst:27 de207c079b314eaea490841b284ea876 msgid "" "PyMuPDF -- having implemented an */EmbeddedFiles* API in response in its " "version 1.11.0 -- was therefore forced to change gears starting with its " "version 1.16.0 (we never published a MuPDF v1.15.x compatible PyMuPDF)." msgstr "|PyMuPDF| 는 버전 1.11.0에서 */EmbeddedFiles* API를 구현했기 때문에 버전 1.16.0부터 방향을 전환해야 했습니다(|MuPDF| v1.15.x와 호환되는 |PyMuPDF| 는 발행하지 않았습니다)." #: ../../app2.rst:29 73bd7a0c6aef40dea2819f6f52a55ff6 msgid "" "We are now maintaining our own code basis supporting embedded files. This" " code makes use of basic MuPDF dictionary and array functions only." msgstr "이제 임베디드 파일을 지원하는 자체 코드 기반을 유지 관리하고 있습니다. 이 코드는 기본 |MuPDF| 딕셔너리 및 배열 함수만 사용합니다." #: ../../app2.rst:32 de313e6dfe7e40e781939fab264fd4e5 msgid "PyMuPDF Support" msgstr "|PyMuPDF| 지원" #: ../../app2.rst:33 420a4c9141134c469dfb6d107c9bcd58 msgid "" "We continue to support the full old API with respect to embedded files --" " with only minor, cosmetic changes." msgstr "임베디드 파일과 관련하여 전체 이전 API를 계속 지원합니다 -- 단지 사소한 외관상의 변경만 있습니다." #: ../../app2.rst:35 66a7d51f81c6402caf1d00e67bd1bfd2 msgid "" "There even also is a new function, which delivers a list of all names " "under which embedded data are registered in a PDF, " ":meth:`Document.embfile_names`." msgstr "PDF에 임베디드 데이터가 등록된 모든 이름의 목록을 제공하는 새로운 함수도 있습니다: :meth:`Document.embfile_names`." #: ../../footer.rst:46 c600b715098140b3b7f197c61eb560ac msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/app3.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 e9b57a556ade45ada6ce4d2157d0a4fb msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 63a9ec4fe01846b68264a6fceec4b355 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 116badf6cf724a168451fdd57616c081 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../app3.rst:7 28fa836c45cd4132be1daf6ef45c58b2 msgid "Appendix 3: Assorted Technical Information" msgstr "부록 3: 기타 기술 정보" #: ../../app3.rst:8 987ce4249079447cbdd011e22851e60d msgid "" "This section deals with various technical topics, that are not " "necessarily related to each other." msgstr "이 섹션은 서로 관련이 없을 수 있는 다양한 기술 주제를 다룹니다." #: ../../app3.rst:15 df054d36d114464baf858b0b6d6fd5e9 msgid "Image Transformation Matrix" msgstr "이미지 변환 행렬" #: ../../app3.rst:16 d08d81fa70c1456e8da48b9f7c45564a msgid "" "Starting with version 1.18.11, the image transformation matrix is " "returned by some methods for text and image extraction: " ":meth:`Page.get_text` and :meth:`Page.get_image_bbox`." msgstr "" "버전 1.18.11부터 이미지 변환 행렬은 텍스트 및 이미지 추출을 위한 일부 메서드에서 반환됩니다: " ":meth:`Page.get_text` 및 :meth:`Page.get_image_bbox`." #: ../../app3.rst:18 9cc212e2752f49e78b3b1ae4b68f754f msgid "" "The transformation matrix contains information about how an image was " "transformed to fit into the rectangle (its \"boundary box\" = \"bbox\") " "on some document page. By inspecting the image's bbox on the page and " "this matrix, one can determine for example, whether and how the image is " "displayed scaled or rotated on a page." msgstr "" "변환 행렬은 이미지가 문서 페이지의 사각형(그 \"경계 상자\" = \"bbox\")에 맞도록 변환된 방법에 대한 정보를 " "포함합니다. 페이지의 이미지 bbox와 이 행렬을 검사하면 예를 들어 이미지가 페이지에서 확대/축소되거나 회전되어 표시되는지 여부와" " 방법을 결정할 수 있습니다." #: ../../app3.rst:20 5ff3fcc91d01440280b60dba6a823b73 msgid "" "The relationship between image dimension and its bbox on a page is the " "following:" msgstr "이미지 크기와 페이지의 bbox 간의 관계는 다음과 같습니다:" #: ../../app3.rst:24 38387aac6c4648878635157b4d9ac7ad msgid "Using the original image's width and height," msgstr "원본 이미지의 너비와 높이를 사용하여," #: ../../app3.rst:23 0658960617334ff1bb152cc26322575b msgid "define the image rectangle `imgrect = pymupdf.Rect(0, 0, width, height)`" msgstr "이미지 사각형을 정의합니다 `imgrect = pymupdf.Rect(0, 0, width, height)`" #: ../../app3.rst:24 e018e20b0f5b47c98051fb8fd2bf4309 msgid "" "define the \"shrink matrix\" `shrink = pymupdf.Matrix(1/width, 0, 0, " "1/height, 0, 0)`." msgstr "\"축소 행렬\"을 정의합니다 `shrink = pymupdf.Matrix(1/width, 0, 0, 1/height, 0, 0)`." #: ../../app3.rst:26 1e5bedf568fb4f28b0c289eba114264e msgid "" "Transforming the image rectangle with its shrink matrix, will result in " "the unit rectangle: `imgrect * shrink = pymupdf.Rect(0, 0, 1, 1)`." msgstr "" "이미지 사각형을 축소 행렬로 변환하면 단위 사각형이 됩니다: `imgrect * shrink = pymupdf.Rect(0, 0, " "1, 1)`." #: ../../app3.rst:28 87764bec92d3484da3cb5c4856fa0efe msgid "" "Using the image **transformation matrix** \"transform\", the following " "steps will compute the bbox::" msgstr "이미지 **변환 행렬** \"transform\"을 사용하면 다음 단계로 bbox를 계산합니다::" #: ../../app3.rst:34 eb03509b0e7b443b8123601dca26cd51 msgid "" "Inspecting the matrix product `shrink * transform` will reveal all " "information about what happened to the image rectangle to make it fit " "into the bbox on the page: rotation, scaling of its sides and translation" " of its origin. Let us look at an example:" msgstr "" "행렬 곱 `shrink * transform` 을 검사하면 이미지 사각형이 페이지의 bbox에 맞도록 변환된 방법에 대한 모든 " "정보(회전, 변의 크기 조정 및 원점 이동)를 알 수 있습니다. 예제를 살펴보겠습니다:" #: ../../app3.rst:71 52e5d34ae16540878399966cea671288 msgid "PDF Base 14 Fonts" msgstr "PDF Base 14 글꼴" #: ../../app3.rst:72 b1b6cb8420b845c3924bbaccd6738258 msgid "" "The following 14 builtin font names **must be supported by every PDF " "viewer** application. They are available as a dictionary, which maps " "their full names amd their abbreviations in lower case to the full font " "basename. Wherever a **fontname** must be provided in PyMuPDF, any **key " "or value** from the dictionary may be used::" msgstr "" "다음 14개의 내장 글꼴 이름은 **모든 PDF 뷰어** 애플리케이션에서 지원되어야 합니다. 이들은 딕셔너리로 제공되며, 전체 " "이름과 소문자 약어를 전체 글꼴 기본 이름에 매핑합니다. |PyMuPDF| 에서 **fontname** 을 제공해야 하는 곳에서는 " "딕셔너리의 **키 또는 값** 을 사용할 수 있습니다::" #: ../../app3.rst:105 11906948a25d421f9fc5dde554e86b3a msgid "" "In contrast to their obligation, not all PDF viewers support these fonts " "correctly and completely -- this is especially true for Symbol and " "ZapfDingbats. Also, the glyph (visual) images will be specific to every " "reader." msgstr "" "의무와 달리 모든 PDF 뷰어가 이러한 글꼴을 올바르고 완전하게 지원하는 것은 아닙니다 -- 이것은 특히 Symbol과 " "ZapfDingbats에 해당합니다. 또한 글리프(시각적) 이미지는 각 리더에 따라 다를 수 있습니다." #: ../../app3.rst:107 295160fa982d4747a5187ac69e7c5091 msgid "" "To see how these fonts can be used -- including the **CJK built-in** " "fonts -- look at the table in :meth:`Page.insert_font`." msgstr "" "이러한 글꼴을 사용하는 방법을 보려면 -- **CJK 내장** 글꼴을 포함하여 -- :meth:`Page.insert_font` 의" " 표를 참조하세요." #: ../../app3.rst:114 08bfb2d1eb8248a59eec7a4cf8c82af6 msgid "Adobe PDF References" msgstr "Adobe PDF 참조" #: ../../app3.rst:116 f91f72e7328b424584ef9343eb9274ff msgid "" "This PDF Reference manual published by Adobe is frequently quoted " "throughout this documentation. It can be viewed and downloaded from " "`opensource.adobe.com `_." msgstr "" "Adobe에서 발행한 이 PDF Reference 매뉴얼은 이 문서 전반에 걸쳐 자주 인용됩니다. " "`opensource.adobe.com `_ 에서 볼 수 있고 다운로드할 수 " "있습니다." #: ../../app3.rst:125 aa1776d20bbe4cfd8afaa0a73e420204 msgid "Using Python Sequences as Arguments in PyMuPDF" msgstr "|PyMuPDF| 에서 Python 시퀀스를 인수로 사용하기" #: ../../app3.rst:126 c5f3a5e6759b4dfbb449d4d691a10798 msgid "" "When PyMuPDF objects and methods require a Python **list** of numerical " "values, other Python **sequence types** are also allowed. Python classes " "are said to implement the **sequence protocol**, if they have a " "`__getitem__()` method." msgstr "" "|PyMuPDF| 객체와 메서드가 숫자 값의 Python **list** 를 요구할 때, 다른 Python **시퀀스 타입** 도 " "허용됩니다. Python 클래스는 `__getitem__()` 메서드를 가지고 있으면 **시퀀스 프로토콜** 을 구현한다고 합니다." #: ../../app3.rst:128 a2f4065016074783a3e692a5b44a9e6a msgid "" "This basically means, you can interchangeably use Python *list* or " "*tuple* or even *array.array*, *numpy.array* and *bytearray* types in " "these cases." msgstr "" "기본적으로 이것은 이러한 경우에 Python *list* 또는 *tuple* 또는 *array.array*, " "*numpy.array* 및 *bytearray* 타입을 상호 교환하여 사용할 수 있음을 의미합니다." #: ../../app3.rst:130 5eb2ec1d221246a191dd8246f9602573 msgid "For example, specifying a sequence `\"s\"` in any of the following ways" msgstr "예를 들어, 다음 방법 중 하나로 시퀀스 `\"s\"` 를 지정하면" #: ../../app3.rst:132 9eb6b1a57a034a3d939841b3ccd8eb41 msgid "`s = [1, 2]` -- a list" msgstr "`s = [1, 2]` -- 리스트" #: ../../app3.rst:133 8c499f04e376417882319277967497e2 msgid "`s = (1, 2)` -- a tuple" msgstr "`s = (1, 2)` -- 튜플" #: ../../app3.rst:134 24338a6cbce547bfa3d4f9cb90ef10ea msgid "`s = array.array(\"i\", (1, 2))` -- an array.array" msgstr "`s = array.array(\"i\", (1, 2))` -- array.array" #: ../../app3.rst:135 36400eb511c94e05909f03f043285723 msgid "`s = numpy.array((1, 2))` -- a numpy array" msgstr "`s = numpy.array((1, 2))` -- numpy 배열" #: ../../app3.rst:136 caec64c89cc041fdbd1aa4c558b74a1b msgid "`s = bytearray((1, 2))` -- a bytearray" msgstr "`s = bytearray((1, 2))` -- bytearray" #: ../../app3.rst:138 e81f583d516a4bdfa3f77751e81a03d9 msgid "will make it usable in the following example expressions:" msgstr "다음 예제 표현식에서 사용할 수 있습니다:" #: ../../app3.rst:140 048fdce412374742b5e6d5861df9427c msgid "`pymupdf.Point(s)`" msgstr "`pymupdf.Point(s)`" #: ../../app3.rst:141 2a1345de7505441da80ff27558b70357 msgid "`pymupdf.Point(x, y) + s`" msgstr "`pymupdf.Point(x, y) + s`" #: ../../app3.rst:142 65b15752bc024e088940595dae3215da msgid "`doc.select(s)`" msgstr "`doc.select(s)`" #: ../../app3.rst:144 d524e2c9577144908a75e0987c81899f msgid "" "Similarly with all geometry objects :ref:`Rect`, :ref:`IRect`, " ":ref:`Matrix` and :ref:`Point`." msgstr "" "모든 기하 객체 :ref:`Rect`, :ref:`IRect`, :ref:`Matrix` 및 :ref:`Point` 에도 " "마찬가지입니다." #: ../../app3.rst:146 46b031e6dd8e40808429c33e2729e35d msgid "" "Because all PyMuPDF geometry classes themselves are special cases of " "sequences, they (with the exception of :ref:`Quad` -- see below) can be " "freely used where numerical sequences can be used, e.g. as arguments for " "functions like *list()*, *tuple()*, *array.array()* or *numpy.array()*. " "Look at the following snippet to see this work." msgstr "" "모든 |PyMuPDF| 기하 클래스 자체가 시퀀스의 특수한 경우이므로, 이들은(:ref:`Quad` 제외 -- 아래 참조) 숫자 " "시퀀스를 사용할 수 있는 곳에서 자유롭게 사용할 수 있습니다. 예를 들어 *list()*, *tuple()*, " "*array.array()* 또는 *numpy.array()* 와 같은 함수의 인수로 사용할 수 있습니다. 이것이 작동하는 것을 " "보려면 다음 코드 조각을 참조하세요." #: ../../app3.rst:163 8c531fc2e99a4086bce80bae4dbeeac7 msgid "" ":ref:`Quad` is a Python sequence object as well and has a length of 4. " "Its items however are :data:`point_like` -- not numbers. Therefore, the " "above remarks do not apply." msgstr "" ":ref:`Quad` 도 Python 시퀀스 객체이며 길이가 4입니다. 그러나 항목은 :data:`point_like` 입니다 --" " 숫자가 아닙니다. 따라서 위의 설명은 적용되지 않습니다." #: ../../app3.rst:170 c359d43e960248c39a6485317dc894d9 msgid "Ensuring Consistency of Important Objects in PyMuPDF" msgstr "|PyMuPDF| 에서 중요한 객체의 일관성 보장" #: ../../app3.rst:171 57dc6323642f4ed1a681c418dc32446e msgid "" "PyMuPDF is a Python binding for the C library MuPDF. While a lot of " "effort has been invested by MuPDF's creators to approximate some sort of " "an object-oriented behavior, they certainly could not overcome basic " "shortcomings of the C language in that respect." msgstr "" "|PyMuPDF| 는 C 라이브러리 |MuPDF| 에 대한 Python 바인딩입니다. |MuPDF| 의 제작자들이 객체 지향적 " "동작을 근사하기 위해 많은 노력을 기울였지만, C 언어의 기본적인 한계를 극복할 수는 없었습니다." #: ../../app3.rst:173 4c061032544f42d3b1cbac6ca2994790 msgid "" "Python on the other hand implements the OO-model in a very clean way. The" " interface code between PyMuPDF and MuPDF consists of two basic files: " "*pymupdf.py* and *fitz_wrap.c*. They are created by the excellent SWIG " "tool for each new version." msgstr "" "반면 Python은 OO 모델을 매우 깔끔하게 구현합니다. |PyMuPDF| 와 |MuPDF| 사이의 인터페이스 코드는 두 개의 " "기본 파일로 구성됩니다: *pymupdf.py* 와 *fitz_wrap.c*. 이들은 각 새 버전에 대해 우수한 SWIG 도구로 " "생성됩니다." #: ../../app3.rst:175 4fb5955ef3f34ff5b12fe9147956933b msgid "" "When you use one of PyMuPDF's objects or methods, this will result in " "execution of some code in *pymupdf.py*, which in turn will call some C " "code compiled with *fitz_wrap.c*." msgstr "" "|PyMuPDF| 의 객체나 메서드 중 하나를 사용하면 *pymupdf.py* 의 일부 코드가 실행되고, 이것은 차례로 " "*fitz_wrap.c* 로 컴파일된 일부 C 코드를 호출합니다." #: ../../app3.rst:177 3846f21a4bb648bd8c4416539fe28a36 msgid "" "Because SWIG goes a long way to keep the Python and the C level in sync, " "everything works fine, if a certain set of rules is being strictly " "followed. For example: **never access** a :ref:`Page` object, after you " "have closed (or deleted or set to ``None``) the owning :ref:`Document`. " "Or, less obvious: **never access** a page or any of its children (links " "or annotations) after you have executed one of the document methods " "*select()*, *delete_page()*, *insert_page()* ... and more." msgstr "" "SWIG가 Python과 C 레벨을 동기화하기 위해 많은 노력을 기울이기 때문에, 특정 규칙 집합을 엄격히 따르면 모든 것이 잘 " "작동합니다. 예를 들어: 소유 :ref:`Document` 를 닫았거나(또는 삭제하거나 ``None`` 으로 설정한 후) " ":ref:`Page` 객체에 **절대 액세스하지 마세요**. 또는 덜 명확한 경우: 문서 메서드 *select()*, " "*delete_page()*, *insert_page()* 등을 실행한 후 페이지나 그 자식(링크 또는 주석)에 **절대 액세스하지" " 마세요**." #: ../../app3.rst:179 cd2f0e9f6925457b95a8972e5220b65c msgid "" "But just no longer accessing invalidated objects is actually not enough: " "They should rather be actively deleted entirely, to also free C-level " "resources (meaning allocated memory)." msgstr "" "그러나 무효화된 객체에 더 이상 액세스하지 않는 것만으로는 충분하지 않습니다: C 레벨 리소스(할당된 메모리)도 해제하기 위해 " "완전히 삭제해야 합니다." #: ../../app3.rst:181 7bb8910cf6284c37a4acf09d60be5730 msgid "" "The reason for these rules lies in the fact that there is a hierarchical " "2-level one-to-many relationship between a document and its pages and " "also between a page and its links / annotations. To maintain a consistent" " situation, any of the above actions must lead to a complete reset -- in " "**Python and, synchronously, in C**." msgstr "" "이러한 규칙의 이유는 문서와 그 페이지 사이, 그리고 페이지와 그 링크/주석 사이에 계층적 2단계 일대다 관계가 있다는 사실에 " "있습니다. 일관된 상황을 유지하기 위해 위의 작업 중 하나라도 완전한 재설정으로 이어져야 합니다 -- **Python과 동기적으로 " "C에서**." #: ../../app3.rst:183 f28fc2db36084f948eed30968297dab5 msgid "SWIG cannot know about this and consequently does not do it." msgstr "SWIG는 이것을 알 수 없으므로 결과적으로 이를 수행하지 않습니다." #: ../../app3.rst:185 9b81f1fa67e34514b59f9bfc0a61a978 msgid "" "The required logic has therefore been built into PyMuPDF itself in the " "following way." msgstr "따라서 필요한 로직이 다음과 같은 방식으로 |PyMuPDF| 자체에 내장되었습니다." #: ../../app3.rst:187 2610c09be6134825b39d838bd001108c msgid "" "If a page \"loses\" its owning document or is being deleted itself, all " "of its currently existing annotations and links will be made unusable in " "Python, and their C-level counterparts will be deleted and deallocated." msgstr "" "페이지가 소유 문서를 \"잃거나\" 자체적으로 삭제되면, 현재 존재하는 모든 주석과 링크가 Python에서 사용할 수 없게 되고, " "C 레벨의 대응 항목이 삭제되고 할당 해제됩니다." #: ../../app3.rst:189 d188cde23fd047f7a60e9267515903d6 msgid "" "If a document is closed (or deleted or set to ``None``) or if its " "structure has changed, then similarly all currently existing pages and " "their children will be made unusable, and corresponding C-level deletions" " will take place. \"Structure changes\" include methods like *select()*, " "*delePage()*, *insert_page()*, *insert_pdf()* and so on: all of these " "will result in a cascade of object deletions." msgstr "" "문서가 닫히거나(또는 삭제되거나 ``None`` 으로 설정되거나) 구조가 변경되면, 마찬가지로 현재 존재하는 모든 페이지와 그 " "자식이 사용할 수 없게 되고, 해당 C 레벨 삭제가 발생합니다. \"구조 변경\"에는 *select()*, " "*delete_page()*, *insert_page()*, *insert_pdf()* 등의 메서드가 포함됩니다: 이들 모두 객체 " "삭제의 연쇄를 초래합니다." #: ../../app3.rst:191 d57b1ed5501b417391bd09cc0fdcfd39 msgid "" "The programmer will normally not realize any of this. If he, however, " "tries to access invalidated objects, exceptions will be raised." msgstr "프로그래머는 일반적으로 이것을 인식하지 못합니다. 그러나 무효화된 객체에 액세스하려고 하면 예외가 발생합니다." #: ../../app3.rst:193 e42075fe1f1f4884a8525e23d50ec80a msgid "" "Invalidated objects cannot be directly deleted as with Python statements " "like *del page* or *page = None*, etc. Instead, their *__del__* method " "must be invoked." msgstr "" "무효화된 객체는 *del page* 또는 *page = None* 등의 Python 문으로 직접 삭제할 수 없습니다. 대신 " "*__del__* 메서드를 호출해야 합니다." #: ../../app3.rst:195 65129ee8ed6347389a03f5c4a0e27118 msgid "" "All pages, links and annotations have the property *parent*, which points" " to the owning object. This is the property that can be checked on the " "application level: if *obj.parent == None* then the object's parent is " "gone, and any reference to its properties or methods will raise an " "exception informing about this \"orphaned\" state." msgstr "" "모든 페이지, 링크 및 주석은 소유 객체를 가리키는 *parent* 속성을 가집니다. 이것은 애플리케이션 레벨에서 확인할 수 있는 " "속성입니다: *obj.parent == None* 이면 객체의 부모가 사라진 것이며, 속성이나 메서드에 대한 참조는 이 \"고아\"" " 상태에 대해 알리는 예외를 발생시킵니다." #: ../../app3.rst:197 8dd4acfe98f34511830f7c57c6d629ce msgid "A sample session:" msgstr "샘플 세션:" #: ../../app3.rst:214 9e147448615c4415832f3e2acb045cfd msgid "This shows the cascading effect:" msgstr "이것은 연쇄 효과를 보여줍니다:" #: ../../app3.rst:231 442c30826bf4423aacbb2a4864ce9a88 msgid "" "Objects outside the above relationship are not included in this " "mechanism. If you e.g. created a table of contents by *toc = " "doc.get_toc()*, and later close or change the document, then this cannot " "and does not change variable *toc* in any way. It is your responsibility " "to refresh such variables as required." msgstr "" "위의 관계 외부의 객체는 이 메커니즘에 포함되지 않습니다. 예를 들어 *toc = doc.get_toc()* 로 목차를 만든 후 " "문서를 닫거나 변경하면, 이것은 변수 *toc* 를 어떤 방식으로도 변경할 수 없고 변경하지 않습니다. 필요에 따라 이러한 변수를 " "새로 고치는 것은 사용자의 책임입니다." #: ../../app3.rst:238 64b3f76253e64bdcba362aad09efb8f9 msgid "Design of Method :meth:`Page.show_pdf_page`" msgstr "메서드 :meth:`Page.show_pdf_page` 의 설계" #: ../../app3.rst:241 128d4a5b179f4f858c59282d02e2992d msgid "Purpose and Capabilities" msgstr "목적 및 기능" #: ../../app3.rst:243 36e16573a42045a2bf1afeda5ba8b66e msgid "" "The method displays an image of a (\"source\") page of another PDF " "document within a specified rectangle of the current (\"containing\", " "\"target\") page." msgstr "" "이 메서드는 다른 PDF 문서의 (\"소스\") 페이지 이미지를 현재 (\"포함\", \"대상\") 페이지의 지정된 사각형 내에 " "표시합니다." #: ../../app3.rst:245 11b56c7a4353448faba91c8944469b13 msgid "" "**In contrast** to :meth:`Page.insert_image`, this display is vector-" "based and hence remains accurate across zooming levels." msgstr "" ":meth:`Page.insert_image` 와 **대조적으로**, 이 표시는 벡터 기반이므로 확대/축소 수준에서도 정확하게 " "유지됩니다." #: ../../app3.rst:246 b9f69720d39443449a9d85059af697e2 msgid "" "**Just like** :meth:`Page.insert_image`, the size of the display is " "adjusted to the given rectangle." msgstr ":meth:`Page.insert_image` 와 **마찬가지로**, 표시 크기는 주어진 사각형에 맞게 조정됩니다." #: ../../app3.rst:248 c503b182fc14483589a8e70354d7013d msgid "The following variations of the display are currently supported:" msgstr "다음과 같은 표시 변형이 현재 지원됩니다:" #: ../../app3.rst:250 97d286a4d5f74472a14b8d008c4a6e14 msgid "" "Bool parameter `\"keep_proportion\"` controls whether to maintain the " "aspect ratio (default) or not." msgstr "Bool 매개변수 `\"keep_proportion\"` 은 종횡비를 유지할지 여부를 제어합니다(기본값)." #: ../../app3.rst:251 b3ca7e9050f84361a916dd947a4aee68 msgid "" "Rectangle parameter `\"clip\"` restricts the visible part of the source " "page rectangle. Default is the full page." msgstr "사각형 매개변수 `\"clip\"` 은 소스 페이지 사각형의 보이는 부분을 제한합니다. 기본값은 전체 페이지입니다." #: ../../app3.rst:252 994ff62c446f4ec48980737cb9847a1b msgid "" "float `\"rotation\"` rotates the display by an arbitrary angle (degrees)." " If the angle is not an integer multiple of 90, only 2 of the 4 corners " "may be positioned on the target border if also `\"keep_proportion\"` is " "true." msgstr "" "float `\"rotation\"` 은 표시를 임의의 각도(도)로 회전시킵니다. 각도가 90의 정수 배가 아니고 " "`\"keep_proportion\"` 도 true인 경우, 4개 모서리 중 2개만 대상 경계에 위치할 수 있습니다." #: ../../app3.rst:253 df91bedf8d2448b9b6e1d9b0e146b290 msgid "" "Bool parameter `\"overlay\"` controls whether to put the image on top " "(foreground, default) of current page content or not (background)." msgstr "Bool 매개변수 `\"overlay\"` 는 이미지를 현재 페이지 콘텐츠 위(전경, 기본값)에 배치할지 여부를 제어합니다(배경)." #: ../../app3.rst:255 7f1ad38d9991450f8326a9f7891e02ed msgid "Use cases include (but are not limited to) the following:" msgstr "사용 사례에는 다음이 포함됩니다(이에 국한되지 않음):" #: ../../app3.rst:257 68f2f629805445a3888fea51dad910ae msgid "" "\"Stamp\" a series of pages of the current document with the same image, " "like a company logo or a watermark." msgstr "회사 로고나 워터마크와 같은 동일한 이미지로 현재 문서의 일련의 페이지에 \"스탬프\"를 찍습니다." #: ../../app3.rst:258 31e6350216514a078362663c9f252a2f msgid "" "Combine arbitrary input pages into one output page to support “booklet” " "or double-sided printing (known as \"4-up\", \"n-up\")." msgstr "" "임의의 입력 페이지를 하나의 출력 페이지로 결합하여 “북렛” 또는 양면 인쇄( \"4-up\", \"n-up\" 으로 알려짐)를 " "지원합니다." #: ../../app3.rst:259 9c80023be1d94d0cbbca8f1314af6a46 msgid "" "Split up (large) input pages into several arbitrary pieces. This is also " "called “posterization”, because you e.g. can split an A4 page " "horizontally and vertically, print the 4 pieces enlarged to separate A4 " "pages, and end up with an A2 version of your original page." msgstr "" "(큰) 입력 페이지를 여러 임의의 조각으로 분할합니다. 이것은 “포스터화”라고도 하며, 예를 들어 A4 페이지를 가로와 세로로 " "분할하고, 4개 조각을 확대하여 별도의 A4 페이지로 인쇄한 다음 원본 페이지의 A2 버전을 얻을 수 있기 때문입니다." #: ../../app3.rst:262 62098c390f3043009fc377ea8e54100a msgid "Technical Implementation" msgstr "기술적 구현" #: ../../app3.rst:264 3dfab80881604fef89ec3850557c91ff msgid "" "This is done using PDF **\"Form XObjects\"**, see section 8.10 on page " "217 of :ref:`AdobeManual`. On execution of a :meth:`Page.show_pdf_page`, " "the following things happen:" msgstr "" "이것은 PDF **\"Form XObjects\"** 를 사용하여 수행됩니다. :ref:`AdobeManual` 의 217페이지 " "섹션 8.10을 참조하세요. :meth:`Page.show_pdf_page` 를 실행하면 다음이 발생합니다:" #: ../../app3.rst:266 9d2548f8045f487c895825c9f1f0e965 msgid "" "The :data:`resources` and :data:`contents` objects of source page in " "source document are copied over to the target document, jointly creating " "a new **Form XObject** with the following properties. The PDF " ":data:`xref` number of this object is returned by the method." msgstr "" "소스 문서의 소스 페이지의 :data:`resources` 및 :data:`contents` 객체가 대상 문서로 복사되어 다음 " "속성을 가진 새로운 **Form XObject** 를 공동으로 생성합니다. 이 객체의 PDF :data:`xref` 번호는 메서드에" " 의해 반환됩니다." #: ../../app3.rst:268 bb76e425ccb64473b57788e768f4ec73 msgid "`/BBox` equals `/Mediabox` of the source page" msgstr "`/BBox` 는 소스 페이지의 `/Mediabox` 와 같습니다" #: ../../app3.rst:269 c31f893de0fc41298d55e90ccf4fe8f8 msgid "`/Matrix` equals the identity matrix." msgstr "`/Matrix` 는 항등 행렬과 같습니다." #: ../../app3.rst:270 b88a10668d6143c8896ff880d6b0a465 msgid "" "`/Resources` equals that of the source page. This involves a “deep-copy” " "of hierarchically nested other objects (including fonts, images, etc.). " "The complexity involved here is covered by MuPDF's grafting [#f1]_ " "technique functions." msgstr "" "`/Resources` 는 소스 페이지의 것과 같습니다. 이것은 계층적으로 중첩된 다른 객체(글꼴, 이미지 등 포함)의 " "deep-copy” 를 포함합니다. 여기에 관련된 복잡성은 |MuPDF| 의 grafting [#f1]_ 기술 함수로 " "처리됩니다." #: ../../app3.rst:271 012404bf546e41f0a21925ebb840eb7d msgid "" "This is a stream object type, and its stream is an exact copy of the " "combined data of the source page's :data:`contents` objects." msgstr "이것은 스트림 객체 타입이며, 그 스트림은 소스 페이지의 :data:`contents` 객체의 결합된 데이터의 정확한 복사본입니다." #: ../../app3.rst:273 134d89c3ee7d414281d9d706d3f7fca3 msgid "" "This Form XObject is only executed once per shown source page. Subsequent" " displays of the same source page will skip this step and only create " "\"pointer\" Form XObjects (done in next step) to this object." msgstr "" "이 Form XObject는 표시된 소스 페이지당 한 번만 실행됩니다. 동일한 소스 페이지의 후속 표시는 이 단계를 건너뛰고 이 " "객체에 대한 \"포인터\" Form XObjects만 생성합니다(다음 단계에서 수행)." #: ../../app3.rst:275 50987890b05b44a0ab6dce288ad5ab0a msgid "" "A second **Form XObject** is then created which the target page uses to " "invoke the display. This object has the following properties:" msgstr "" "그런 다음 대상 페이지가 표시를 호출하는 데 사용하는 두 번째 **Form XObject** 가 생성됩니다. 이 객체는 다음 속성을" " 가집니다:" #: ../../app3.rst:277 33bd465dbdd047c7816f59b343c2d780 msgid "`/BBox` equals the `/CropBox` of the source page (or `\"clip\"`)." msgstr "`/BBox` 는 소스 페이지의 `/CropBox` (또는 `\"clip\"`)와 같습니다." #: ../../app3.rst:278 ecaa890ab1e94d268751da3df22cf421 msgid "`/Matrix` represents the mapping of `/BBox` to the target rectangle." msgstr "`/Matrix` 는 `/BBox` 를 대상 사각형으로 매핑하는 것을 나타냅니다." #: ../../app3.rst:279 b7950a1195e54793b9b3b5b911fc150c msgid "" "`/XObject` references the previous Form XObject via the fixed name " "`fullpage`." msgstr "`/XObject` 는 고정된 이름 `fullpage` 를 통해 이전 Form XObject를 참조합니다." #: ../../app3.rst:280 8a89d2b17c624ea39d9d9414c18fceee msgid "" "The stream of this object contains exactly one fixed statement: " "`/fullpage Do`." msgstr "이 객체의 스트림은 정확히 하나의 고정된 문을 포함합니다: `/fullpage Do`." #: ../../app3.rst:281 8071f5c0c01b40ed8d0b3c8e0caea1d5 msgid "" "If the method's `\"oc\"` argument is given, its value is assigned to this" " Form XObject as `/OC`." msgstr "메서드의 `\"oc\"` 인수가 주어지면, 그 값이 이 Form XObject에 `/OC` 로 할당됩니다." #: ../../app3.rst:283 d0dcf58ed13a453a834e115f4ea0c511 msgid "" "The :data:`resources` and :data:`contents` objects of the target page are" " now modified as follows." msgstr "대상 페이지의 :data:`resources` 및 :data:`contents` 객체는 다음과 같이 수정됩니다." #: ../../app3.rst:285 77b2331ffaee4e7b8feca779154bca43 msgid "" "Add an entry to the `/XObject` dictionary of `/Resources` with the name " "`fzFrm` (with n chosen such that this entry is unique on the page)." msgstr "" "`/Resources` 의 `/XObject` 딕셔너리에 `fzFrm` 이라는 이름으로 항목을 추가합니다(n은 이 항목이 " "페이지에서 고유하도록 선택됨)." #: ../../app3.rst:286 71da2b0e5eea427e8ef41d4ee9facaf2 msgid "" "Depending on `\"overlay\"`, prepend or append a new object to the page's " "`/Contents` array, containing the statement `q /fzFrm Do Q`." msgstr "" "`\"overlay\"` 에 따라 페이지의 `/Contents` 배열에 `q /fzFrm Do Q` 문을 포함하는 새 객체를 " "앞에 추가하거나 뒤에 추가합니다." #: ../../app3.rst:288 ce7e0186bef54c97a9b29d12c1e6f3a6 msgid "This design approach ensures that:" msgstr "이 설계 접근 방식은 다음을 보장합니다:" #: ../../app3.rst:290 eb54e5bd84bb498abb3763ee5407a28e msgid "" "The (potentially large) source page is only copied once to the target " "PDF. Only small \"pointer\" Form XObjects objects are created per each " "target page to show the source page." msgstr "" "(잠재적으로 큰) 소스 페이지는 대상 PDF에 한 번만 복사됩니다. 소스 페이지를 표시하기 위해 각 대상 페이지당 작은 " "\"포인터\" Form XObjects 객체만 생성됩니다." #: ../../app3.rst:291 9bdd7aac08c848b896a77921ae741fc8 msgid "" "Each referring target page can have its own `\"oc\"` parameter to control" " the source page's visibility individually." msgstr "각 참조 대상 페이지는 소스 페이지의 가시성을 개별적으로 제어하기 위해 자체 `\"oc\"` 매개변수를 가질 수 있습니다." #: ../../app3.rst:298 38192e7d264e49b9b11f8bff65d9f574 msgid "Diagnostics" msgstr "진단" #: ../../app3.rst:303 678e61f215bb4b728ec825f020a47ade msgid "|PyMuPDF| messages" msgstr "|PyMuPDF| 메시지" #: ../../app3.rst:305 b0163c7491294ddc8e19c68b4a236621 msgid "|PyMuPDF| has a Message system for showing text diagnostics." msgstr "|PyMuPDF| 는 텍스트 진단을 표시하기 위한 메시지 시스템을 가지고 있습니다." #: ../../app3.rst:307 ae5fa773d042458bba579ef11b18c5f1 msgid "" "By default messages are written to `sys.stdout`. This can be controlled " "in two ways:" msgstr "기본적으로 메시지는 `sys.stdout` 에 기록됩니다. 이것은 두 가지 방법으로 제어할 수 있습니다:" #: ../../app3.rst:311 e9874754031f42d2977701bc48a0202a msgid "Set environment variable `PYMUPDF_MESSAGE` before |PyMuPDF| is imported." msgstr "|PyMuPDF| 를 가져오기 전에 환경 변수 `PYMUPDF_MESSAGE` 를 설정합니다." #: ../../app3.rst:314 752d0f8c25c3400ab0fd25a0bd727e90 msgid "Call `set_messages()`:" msgstr "`set_messages()` 를 호출합니다:" #: ../../app3.rst:318 c98f984f976c49d7bf561a0bd2ec9dc5 msgid "|MuPDF| errors and warnings" msgstr "|MuPDF| 오류 및 경고" #: ../../app3.rst:320 ff1b806727194154b4b239fd45add954 msgid "|MuPDF| generates text errors and warnings." msgstr "|MuPDF| 는 텍스트 오류 및 경고를 생성합니다." #: ../../app3.rst:323 0f276711268e409fb82df4ba73696ece msgid "" "These errors and warnings are appended to an internal list, accessible " "with `Tools.mupdf_warnings()`. Also see `Tools.reset_mupdf_warnings()`." msgstr "" "이러한 오류 및 경고는 내부 목록에 추가되며, `Tools.mupdf_warnings()` 로 액세스할 수 있습니다. " "`Tools.reset_mupdf_warnings()` 도 참조하세요." #: ../../app3.rst:327 073e0bdb4e0d4e36bb6759931da9f080 msgid "" "By default these errors and warnings are also sent to the |PyMuPDF| " "message system." msgstr "기본적으로 이러한 오류 및 경고는 |PyMuPDF| 메시지 시스템에도 전송됩니다." #: ../../app3.rst:330 c438af959e7d416a8bdd12d4a262666f msgid "" "This can be controlled with `mupdf_display_errors()` and " "`mupdf_display_warnings()`." msgstr "이것은 `mupdf_display_errors()` 및 `mupdf_display_warnings()` 로 제어할 수 있습니다." #: ../../app3.rst:334 751a2f790c0c436ba72274b9a9cd2841 msgid "" "These messages are prefixed with `MuPDF error:` and `MuPDF warning:` " "respectively." msgstr "이러한 메시지는 각각 `MuPDF error:` 및 `MuPDF warning:` 접두사가 붙습니다." #: ../../app3.rst:337 9d9fa818d46c40c4abd7e99971db02f1 msgid "Some |MuPDF| errors may lead to Python exceptions." msgstr "일부 |MuPDF| 오류는 Python 예외를 유발할 수 있습니다." #: ../../app3.rst:339 305562c6d9974f98a9b2d09d489e294c msgid "" "Example output for a **recoverable error**. We are opening a damaged PDF," " but MuPDF is able to repair it and gives us a little information on what" " happened. Then we illustrate how to find out whether the document can " "later be saved incrementally. Checking the :attr:`Document.is_dirty` " "attribute at this point also indicates that during `pymupdf.open` the " "document had to be repaired:" msgstr "" "**복구 가능한 오류** 에 대한 예제 출력입니다. 손상된 PDF를 열고 있지만 |MuPDF| 는 이를 복구할 수 있고 발생한 일에" " 대한 약간의 정보를 제공합니다. 그런 다음 문서를 나중에 증분 저장할 수 있는지 확인하는 방법을 설명합니다. 이 시점에서 " ":attr:`Document.is_dirty` 속성을 확인하면 `pymupdf.open` 중에 문서를 복구해야 했음을 나타냅니다:" #: ../../app3.rst:360 10e13c5dbba64ba7a6bed125229ffea8 msgid "Example output for an **unrecoverable error**:" msgstr "**복구 불가능한 오류** 에 대한 예제 출력:" #: ../../app3.rst:378 55ce8adbca56443192458ad1412c6eb6 msgid "Coordinates" msgstr "좌표" #: ../../app3.rst:381 25b2587ee67742f8aab4274ba33aaed0 msgid "" "This is one of the most frequently used terms in this documentation. A " "**coordinate** generally means a pair of numbers `(x, y)` referring to " "some location, like a corner of a rectangle (:ref:`Rect`), a :ref:`Point`" " and so forth. The two values usually are floats, but there a objects " "like images which only allow them to be integers." msgstr "" "이것은 이 문서에서 가장 자주 사용되는 용어 중 하나입니다. **좌표** 는 일반적으로 사각형의 모서리(:ref:`Rect`), " ":ref:`Point` 등과 같은 위치를 나타내는 숫자 쌍 `(x, y)` 를 의미합니다. 두 값은 일반적으로 float이지만, " "정수만 허용하는 이미지와 같은 객체도 있습니다." #: ../../app3.rst:383 07fa97393cb64575ba7ca3c72e92d3e0 msgid "" "To actually *find* a coordinate's location, we also need to know the " "*reference* point for ``x`` and ``y`` - in other words, we must know " "where location `(0, 0)` is positioned. Once `(0, 0)` (the \"origin\") is " "known, we speak of a \"coordinate system\"." msgstr "" "실제로 좌표의 위치를 *찾으려면*, ``x`` 와 ``y`` 의 *참조* 점도 알아야 합니다 -- 즉, 위치 `(0, 0)` 이 " "어디에 있는지 알아야 합니다. `(0, 0)` (\"원점\")이 알려지면 \"좌표계\"라고 말합니다." #: ../../app3.rst:385 f03d3158dc424965ad72da81750b12cc msgid "" "Several coordinate systems exist in document processing. For instance, " "the coordinate systems of a PDF page and the image created from it are " "**different**. We therefore need ways to *transform* coordinates from one" " system to another (and also back occasionally). This is the task of a " ":ref:`Matrix`. It is a mathematical function which works much like a " "factor that can be \"multiplied\" with a point or rectangle to give us " "the corresponding point / rectangle in another coordinate system. The " "inverse of a transformation matrix can be used to revert the " "transformation. Much like multiplying by some factor, say 3, can be " "reverted by dividing the result by 3 (or multiplying it with 1/3)." msgstr "" "문서 처리에는 여러 좌표계가 존재합니다. 예를 들어, PDF 페이지와 그것으로부터 생성된 이미지의 좌표계는 **다릅니다**. 따라서" " 한 시스템에서 다른 시스템으로 좌표를 *변환* 하는 방법이 필요합니다(때로는 역으로도). 이것이 :ref:`Matrix` 의 " "작업입니다. 이것은 점이나 사각형과 \"곱할\" 수 있는 인수처럼 작동하여 다른 좌표계에서 해당 점/사각형을 제공하는 수학 " "함수입니다. 변환 행렬의 역행렬을 사용하여 변환을 되돌릴 수 있습니다. 예를 들어 3을 곱하는 것을 결과를 3으로 나누거나(또는 " "1/3을 곱함)하여 되돌릴 수 있는 것과 매우 유사합니다." #: ../../app3.rst:388 2861d34531e741f2899ff1dc71d8b465 msgid "Coordinates and Images" msgstr "좌표 및 이미지" #: ../../app3.rst:390 2a2c6ebc18e84f02aebc26d7a8e9905d msgid "" "Images have a coordinate system with integer coordinates. Origin `(0, 0)`" " is the top-left point. ``x`` values must be in `range(width)`, and ``y``" " values in `range(height)`. Therefore, ``y`` values *increase* if we go " "*downwards*. For every image, there is only a **finite number** of " "coordinates, namely `width * height`. A location in an image is also " "called a \"pixel\"." msgstr "" "이미지는 정수 좌표를 가진 좌표계를 가집니다. 원점 `(0, 0)` 은 왼쪽 위 점입니다. ``x`` 값은 " "`range(width)` 에 있어야 하고, ``y`` 값은 `range(height)` 에 있어야 합니다. 따라서 *아래로* 가면" " ``y`` 값이 *증가* 합니다. 모든 이미지에 대해 **유한한 수** 의 좌표만 있습니다. 즉, `width * height` " "입니다. 이미지의 위치는 \"픽셀\"이라고도 합니다." #: ../../app3.rst:392 2d1ab7caafc4475bb1e0bb937bd193f5 msgid "" "How **large** an image will be (in centimeters or inches) when e.g. " "printed, depends on additional information: the \"resolution\". This is " "measured in **DPI** (dots per inch, or pixels per inch). To find the " "printed size of some image, we therefore must divide its width and its " "height by the corresponding DPI values (there may separate ones for width" " and for height) and will get the respective number of inches." msgstr "" "예를 들어 인쇄할 때 이미지가 **얼마나 큰지** (센티미터 또는 인치)는 추가 정보인 \"해상도\"에 따라 다릅니다. 이것은 " "**DPI** (인치당 도트 또는 인치당 픽셀)로 측정됩니다. 따라서 이미지의 인쇄 크기를 찾으려면 너비와 높이를 해당 DPI " "값으로 나누어야 하며(너비와 높이에 대해 별도의 값이 있을 수 있음) 각각의 인치 수를 얻을 수 있습니다." #: ../../app3.rst:396 861cbf0fef9b49cd9a4c66166b84a606 msgid "Origin Point, Point Size and Y-Axis" msgstr "원점, 포인트 크기 및 Y축" #: ../../app3.rst:398 40053762c0d549a589c0738ef25485e0 msgid "" "In |PDF|, the origin `(0, 0)` of a page is located at its **bottom-left " "point**. In |MuPDF|, the origin `(0, 0)` of a page is located at its " "**top-left point**." msgstr "" "|PDF| 에서 페이지의 원점 `(0, 0)` 은 **왼쪽 아래 점** 에 있습니다. |MuPDF| 에서 페이지의 원점 `(0, " "0)` 은 **왼쪽 위 점** 에 있습니다." #: ../../app3.rst:403 006e004df7614a4e951f99ba46acb439 msgid "Coordinates are float numbers and measured in **points**, where:" msgstr "좌표는 float 숫자이며 **포인트** 단위로 측정됩니다. 여기서:" #: ../../app3.rst:405 060972242c9c45a399b754799bda2112 msgid "**one point equals 1/72 inches**." msgstr "**1포인트는 1/72인치** 와 같습니다." #: ../../app3.rst:407 32f04e20ba5e41f09c447ba3a79e54c8 msgid "" "Typical document page sizes are **ISO A4** and **Letter**. A **Letter** " "page has a size of **8.5 x 11 inches**, corresponding to **612 x 792 " "points**. In the |PDF| coordinate system, the top-left point of a " "**Letter** page hence has the coordinate `(0, 792)` as **the y-axis " "points upwards**. Now we know our document size the |MuPDF| coordinate " "system for the bottom right would be coordinate `(612, 792)` (and for " "|PDF| this coordinate would then be `(612,0)`)." msgstr "" "일반적인 문서 페이지 크기는 **ISO A4** 및 **Letter** 입니다. **Letter** 페이지는 **8.5 x " "11인치** 크기를 가지며, 이는 **612 x 792 포인트** 에 해당합니다. |PDF| 좌표계에서 **Letter** 페이지의" " 왼쪽 위 점은 **y축이 위를 가리키므로** 좌표 `(0, 792)` 를 가집니다. 이제 문서 크기를 알았으므로 |MuPDF| " "좌표계에서 오른쪽 아래는 좌표 `(612, 792)` 가 됩니다(|PDF| 에서는 이 좌표가 `(612,0)` 이 됩니다)." #: ../../app3.rst:409 1ff227ed19b04762886cbcbc4e4922ad msgid "" "Theoretically, there are **infinitely many** coordinate positions on a " "|PDF| page. In practice however, at most the first 5 decimal places are " "sufficient for a reasonable precision." msgstr "" "이론적으로 |PDF| 페이지에는 **무한히 많은** 좌표 위치가 있습니다. 그러나 실제로는 합리적인 정밀도를 위해 최대 처음 5자리" " 소수점이면 충분합니다." #: ../../app3.rst:412 ccd57b81247849d887f21f917dcf79e1 msgid "" "In |MuPDF|, multiple document formats are supported - |PDF| just being " "one among **over a dozen others**. Images are also supported as documents" " in |MuPDF| (therefore having one page usually). This is one of the " "reasons why |MuPDF| uses a coordinate system with the origin `(0, 0)` " "being the **top-left** point of any document page. **The y-axis points " "downwards**, like with images. Coordinates in |MuPDF| in any case are " "floats, like in |PDF|." msgstr "" "|MuPDF| 에서는 여러 문서 형식이 지원됩니다 -- |PDF| 는 **12개 이상의 다른 형식** 중 하나일 뿐입니다. 이미지도" " |MuPDF| 에서 문서로 지원됩니다(따라서 일반적으로 한 페이지를 가짐). 이것이 |MuPDF| 가 원점 `(0, 0)` 이 " "모든 문서 페이지의 **왼쪽 위** 점인 좌표계를 사용하는 이유 중 하나입니다. **y축은 아래를 가리킵니다**, 이미지와 " "마찬가지입니다. |MuPDF| 의 좌표는 어떤 경우든 |PDF| 와 마찬가지로 float입니다." #: ../../app3.rst:414 9657e0b219bd4d518cdcf40a8a6ccc21 msgid "" "A rectangle `Rect(0, 0, 100, 100)` for instance in |MuPDF| (and thus " "|PyMuPDF|) therefore is a square with edges of length 100 points (= 1.39 " "inches or 3.53 centimeters). Its top-left corner is the origin. To switch" " between the two coordinate systems |PDF| to |MuPDF|, every :ref:`Page` " "object has a :attr:`Page.transformation_matrix`. Its inverse can be used " "to compute a rectangle's PDF coordinates. In this way we can conveniently" " find that `Rect(0, 0, 100, 100)` in |MuPDF| is the same as `Rect(0, 692," " 100, 792)` in |PDF|. See this code snippet::" msgstr "" "예를 들어 |MuPDF| (따라서 |PyMuPDF| )에서 `Rect(0, 0, 100, 100)` 사각형은 길이가 100포인트(=" " 1.39인치 또는 3.53센티미터)인 변을 가진 정사각형입니다. 왼쪽 위 모서리가 원점입니다. 두 좌표계 |PDF| 와 " "|MuPDF| 사이를 전환하려면 모든 :ref:`Page` 객체는 :attr:`Page.transformation_matrix` 를" " 가집니다. 그 역행렬을 사용하여 사각형의 PDF 좌표를 계산할 수 있습니다. 이렇게 하면 |MuPDF| 의 `Rect(0, 0, " "100, 100)` 이 |PDF| 의 `Rect(0, 692, 100, 792)` 와 같다는 것을 편리하게 찾을 수 있습니다. 이 " "코드 조각을 참조하세요::" #: ../../app3.rst:425 59083fb45b414470920471c730d07179 msgid "Footnotes" msgstr "각주" #: ../../app3.rst:426 0164e8d6d2cb4cf98c0101507e790e14 msgid "" "MuPDF supports \"deep-copying\" objects between PDF documents. To avoid " "duplicate data in the target, it uses so-called \"graftmaps\", like a " "form of scratchpad: for each object to be copied, its :data:`xref` number" " is looked up in the graftmap. If found, copying is skipped. Otherwise, " "the new :data:`xref` is recorded and the copy takes place. PyMuPDF makes " "use of this technique in two places so far: :meth:`Document.insert_pdf` " "and :meth:`Page.show_pdf_page`. This process is fast and very efficient, " "because it prevents multiple copies of typically large and frequently " "referenced data, like images and fonts. However, you may still want to " "consider using garbage collection (option 4) in any of the following " "cases:" msgstr "" "|MuPDF| 는 PDF 문서 간에 객체를 \"deep-copying\" 하는 것을 지원합니다. 대상에서 중복 데이터를 피하기 위해" " 스크래치패드 형태의 소위 \"graftmaps\" 를 사용합니다: 복사할 각 객체에 대해 그 :data:`xref` 번호가 " "graftmap에서 조회됩니다. 발견되면 복사가 건너뜁니다. 그렇지 않으면 새로운 :data:`xref` 가 기록되고 복사가 " "수행됩니다. |PyMuPDF| 는 지금까지 두 곳에서 이 기술을 사용합니다: :meth:`Document.insert_pdf` 및 " ":meth:`Page.show_pdf_page`. 이 프로세스는 빠르고 매우 효율적입니다. 왜냐하면 이미지와 글꼴과 같은 일반적으로" " 크고 자주 참조되는 데이터의 여러 복사본을 방지하기 때문입니다. 그러나 다음 경우 중 하나에서 가비지 수집(옵션 4)을 사용하는 " "것을 고려할 수 있습니다:" #: ../../app3.rst:428 ff64eb6459dd48aab243823d1e5a8733 msgid "" "The target PDF is not new / empty: grafting does not check for resources " "that already existed (e.g. images, fonts) in the target document before " "opening it." msgstr "" "대상 PDF가 새 것이 아니거나 비어 있지 않음: grafting은 문서를 열기 전에 대상 문서에 이미 존재했던 리소스(예: " "이미지, 글꼴)를 확인하지 않습니다." #: ../../app3.rst:429 f6431e1f385d4ed89c60d314577c3b72 msgid "" "Using :meth:`Page.show_pdf_page` for more than one source document: each " "grafting occurs **within one source** PDF only, not across multiple. So " "if e.g. the same image exists in pages from different source PDFs, then " "this will not be detected until garbage collection." msgstr "" "하나 이상의 소스 문서에 대해 :meth:`Page.show_pdf_page` 사용: 각 grafting은 여러 문서에 걸쳐서가 " "아니라 **하나의 소스** PDF 내에서만 발생합니다. 따라서 예를 들어 다른 소스 PDF의 페이지에 동일한 이미지가 존재하면, " "가비지 수집까지 이것이 감지되지 않습니다." #: ../../footer.rst:57 0e66288fd8404701a02732244ee2b635 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/app4.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 613ca8dee3af4e18aee8824f32d62bd7 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 3fb1879bb92640d0b871ed41914b2b0d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 5800ad4c0c8f4aea8589a92458f2afe9 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../app4.rst:14 452ac8cb00694e9abeae5f9e25ddebf6 msgid "Appendix 4: Performance Comparison Methodology" msgstr "부록 4: 성능 비교 방법론" #: ../../app4.rst:16 14ceae9e1c7f4b8f8a0319fbb991a23c msgid "" "This article documents the approach to measure :title:`PyMuPDF's` " "performance and the tools and example files used to do comparisons." msgstr "이 문서는 :title:`PyMuPDF's` 성능을 측정하는 접근 방식과 비교에 사용된 도구 및 예제 파일을 설명합니다." #: ../../app4.rst:18 707cf837e27a4490be01f4ff59f3d6e7 msgid "The following three sections deal with different performance aspects:" msgstr "다음 세 섹션은 다양한 성능 측면을 다룹니다:" #: ../../app4.rst:20 19bf7499dda54ae094b5f694a8ea950f msgid "" ":ref:`Document Copying` - This includes opening and parsing" " :title:`PDFs`, then writing them to an output file. Because the same " "basic activities are also used for joining (merging) :title:`PDFs`, the " "results also apply to these use cases." msgstr ":ref:`Document Copying` - 이것은 :title:`PDFs` 를 열고 파싱한 다음 출력 파일에 쓰는 것을 포함합니다. 동일한 기본 활동이 :title:`PDFs` 를 결합(병합)하는 데도 사용되므로, 결과는 이러한 사용 사례에도 적용됩니다." #: ../../app4.rst:21 8902b7d3bdf44cdeb0a02ebaeb788364 msgid "" ":ref:`Text Extraction` - This extracts plain text " "from :title:`PDFs` and writes it to an output text file." msgstr ":ref:`Text Extraction` - 이것은 :title:`PDFs` 에서 일반 텍스트를 추출하고 출력 텍스트 파일에 씁니다." #: ../../app4.rst:22 c9e28e548b684c15b6fc6c839fb268d0 msgid "" ":ref:`Page Rendering` - This converts |PDF| pages to" " image files looking identical to the pages. This ability is the basic " "prerequisite for using a tool in :title:`Python GUI` scripts to scroll " "through documents. We have chosen a medium-quality (resolution 150 DPI) " "version." msgstr ":ref:`Page Rendering` - 이것은 |PDF| 페이지를 페이지와 동일하게 보이는 이미지 파일로 변환합니다. 이 기능은 :title:`Python GUI` 스크립트에서 문서를 스크롤하기 위해 도구를 사용하는 기본 전제 조건입니다. 중간 품질(해상도 150 DPI) 버전을 선택했습니다." #: ../../app4.rst:24 d8c56f0cbbb4415497587ade558105c9 msgid "" "Please note that in all cases the actual speed in dealing with |PDF| " "structures is not directly measured: instead, the timings also include " "the durations of writing files to the operating system's file system. " "This cannot be avoided because tools other than |PyMuPDF| do not offer " "the option to e.g., separate the image **creation** step from the " "following step, which **writes** the image into a file." msgstr "모든 경우에 |PDF| 구조를 처리하는 실제 속도가 직접 측정되지 않는다는 점에 유의하세요: 대신 타이밍에는 운영 체제의 파일 시스템에 파일을 쓰는 데 걸리는 시간도 포함됩니다. |PyMuPDF| 이외의 도구는 예를 들어 이미지 **생성** 단계를 이미지를 파일에 **쓰는** 다음 단계와 분리하는 옵션을 제공하지 않기 때문에 이것을 피할 수 없습니다." #: ../../app4.rst:26 c95dca0ce6a24b9cbb4e54005da736be msgid "" "So all timings documented include a common, OS-oriented base effort. " "Therefore, performance **differences per tool are actually larger** than " "the numbers suggest." msgstr "따라서 문서화된 모든 타이밍에는 공통 OS 지향 기본 작업이 포함됩니다. 따라서 도구별 성능 **차이는 실제로 숫자가 시사하는 것보다 큽니다**." #: ../../app4.rst:33 5c8d1822086844e0b5b6e63e24468509 msgid "Files used" msgstr "사용된 파일" #: ../../app4.rst:35 2439752153d84180a23a0e99527d8073 msgid "" "A set of eight files is used for the performance testing. With each file " "we have the following information:" msgstr "성능 테스트에 8개의 파일 세트가 사용됩니다. 각 파일에 대해 다음 정보가 있습니다:" #: ../../app4.rst:37 b31835ad665241aebc8bce9496462a0b msgid "**Name** of the file and download **link**." msgstr "파일의 **이름** 및 다운로드 **링크**." #: ../../app4.rst:38 01b0b7ddaf6342b6acea40fc10548232 msgid "**Size** in bytes." msgstr "바이트 단위의 **크기**." #: ../../app4.rst:39 5cefe438dda843c68dd254d3911dbf09 msgid "Total number of **pages** in file." msgstr "파일의 총 **페이지** 수." #: ../../app4.rst:40 245d148da06d4becad20aec51e1fd3bf msgid "Total number of bookmarks (**Table of Contents** entries)." msgstr "책갈피(**목차** 항목)의 총 수." #: ../../app4.rst:41 ff1a2993e3254f7686a848f577c48582 msgid "Total number of **links**." msgstr "**링크** 의 총 수." #: ../../app4.rst:42 fb20f6986d82495e9890d8753eb1f276 msgid "**KB size** per page." msgstr "페이지당 **KB 크기**." #: ../../app4.rst:43 1224aaf0dfde40e1a5c3bc91ef4011ff msgid "" "**Textsize per page** is the amount text in the whole file in KB, divided" " by the number of pages." msgstr "**페이지당 텍스트 크기** 는 전체 파일의 텍스트 양(KB)을 페이지 수로 나눈 값입니다." #: ../../app4.rst:44 8ceb2129883142a09c9d4d383789ed99 msgid "Any **notes** to generally describe the type of file." msgstr "파일 유형을 일반적으로 설명하는 **참고 사항**." #: ../../app4.rst:50 ../../app4.rst:217 ../../app4.rst:295 ../../app4.rst:407 #: 1b162242a4a54f7dafcae32349b4ed33 930f7531af8b4c2db858b7c3c63f1c57 #: b459ef8255c34d8bb8f10527b5b13ae0 dd23f2e000014a6ebfbb0df71f4f4550 msgid "**Name**" msgstr "**이름**" #: ../../app4.rst:51 651fc5cd40134ce993378901eaed782d msgid "**Size (bytes)**" msgstr "**크기 (바이트)**" #: ../../app4.rst:52 830651a701b543dd92495f528872e442 msgid "**Pages**" msgstr "**페이지**" #: ../../app4.rst:53 ad04afd00ac744a8b7c099d48dcdc0c3 msgid "**TOC size**" msgstr "**목차 크기**" #: ../../app4.rst:54 4286cb4118494c3c97aa7190ce52bbe1 msgid "**Links**" msgstr "**링크**" #: ../../app4.rst:55 dfccc56073594677aaaf87774c57e911 msgid "**KB/page**" msgstr "**KB/페이지**" #: ../../app4.rst:56 85615f3120044a3d8f55f0e03fbe8400 msgid "**Textsize/page**" msgstr "**텍스트 크기/페이지**" #: ../../app4.rst:57 2ed30a8ee08e4381913a180905dc4905 msgid "**Notes**" msgstr "**참고 사항**" #: ../../app4.rst:58 81403b323ce2471990b6addcb9d327ed msgid "`adobe.pdf`" msgstr "" #: ../../app4.rst:59 6dfced8745d04f139c2262964b78cc6c msgid "32,472,771" msgstr "" #: ../../app4.rst:60 fe260ad1414a49ad820440768eed3e3d msgid "1,310" msgstr "" #: ../../app4.rst:61 aecc68ede79f49e7a2f4965c4d6d21fb msgid "794" msgstr "" #: ../../app4.rst:62 19f68930d6b342c8b63282aacdda31ba msgid "32,096" msgstr "" #: ../../app4.rst:63 3db3ea234e5e4dbfb2cb18370be6526b msgid "24" msgstr "" #: ../../app4.rst:64 df9644ba42384b7f8df8f1a7f9ac9ca6 msgid "1,942" msgstr "" #: ../../app4.rst:65 9a0b2a88e8d14cbbaa5e220051bc2cbc msgid "linearized, many links / bookmarks" msgstr "" #: ../../app4.rst:66 b450a19150554327a540a48702926bd8 msgid "`artifex-website.pdf`" msgstr "" #: ../../app4.rst:67 f76c22107d8e466e9e9b938d6d2a0c78 msgid "31,570,732" msgstr "" #: ../../app4.rst:68 121ca9cb77a44f18ae707dc1f62b6828 msgid "47" msgstr "" #: ../../app4.rst:69 74407cbb0f3b41c8b248f809abe4cf58 msgid "46" msgstr "" #: ../../app4.rst:70 5a5a12aa804e4285b2c10f71c7b91631 msgid "2,035" msgstr "" #: ../../app4.rst:71 24d74ed3a9814878b5faa590d81e830c msgid "656" msgstr "" #: ../../app4.rst:72 7f66bf0a79ca4e199dd2d27aea8b4e85 msgid "3,538" msgstr "" #: ../../app4.rst:73 d9c710117eb44abca3a888f45c5f6927 msgid "graphics oriented" msgstr "" #: ../../app4.rst:74 49bc871f44cb4ddbb8d76e2d42b3155b msgid "`db-systems.pdf`" msgstr "" #: ../../app4.rst:75 1a5f0c78435c4c6389a2acd6bd91cd28 msgid "29,326,355" msgstr "" #: ../../app4.rst:76 f88d9c860ac246f49fdafd12ed4cc62e msgid "1,241" msgstr "" #: ../../app4.rst:77 ../../app4.rst:78 ../../app4.rst:117 ../../app4.rst:118 #: 35384af101fd403ca7b83c7bf3616f8c 48b4936078bd42bab97c666b770093d6 #: 95853467cdac44e5905fa2aa5f876d2d d6739a13778847ea9c11a2c7b08bc8e0 msgid "0" msgstr "" #: ../../app4.rst:79 d215b500b52e41cc99c84f24fe3890ec msgid "23" msgstr "" #: ../../app4.rst:80 a267452974d549de8748e729075a7ac7 msgid "2,142" msgstr "" #: ../../app4.rst:82 739b78ec9dc84e99917248ee3622b3b2 msgid "`fontforge.pdf`" msgstr "" #: ../../app4.rst:83 25bd9632f03d4b2293dc4c8a076d05fa msgid "8,222,384" msgstr "" #: ../../app4.rst:84 b567e447fe8f4e0490f62422a2d9d569 msgid "214" msgstr "" #: ../../app4.rst:85 75588fdd5beb42a78773ef5340ecc1b6 msgid "31" msgstr "" #: ../../app4.rst:86 0c2001d30c0f4f07963b9f2e38b0f614 msgid "242" msgstr "" #: ../../app4.rst:87 d6c479c026b5484881aa9197ffc88c6a msgid "38" msgstr "" #: ../../app4.rst:88 b9139930537345d284aa9a31220d74c6 msgid "1,058" msgstr "" #: ../../app4.rst:89 710514866ee04905bf3be46a44b683bf msgid "mix of text & graphics" msgstr "" #: ../../app4.rst:90 c8a1f504fd3746ba9397d4e3d6b274a6 msgid "`pandas.pdf`" msgstr "" #: ../../app4.rst:91 8642835dbf5d4db99a8c4fbca766a571 msgid "10,585,962" msgstr "" #: ../../app4.rst:92 7b996090e65044c584d83ea7acda42f0 msgid "3,071" msgstr "" #: ../../app4.rst:93 ff6fdff8d91a417583e2686c79665e97 msgid "536" msgstr "" #: ../../app4.rst:94 6916626a7d824adfb4b1475a9d0f3eff msgid "16,554" msgstr "" #: ../../app4.rst:95 bc0f680837344f68abbb708440827a84 msgid "3" msgstr "" #: ../../app4.rst:96 bba11b24685d4d8c94deaa5e074e4bcb msgid "1,539" msgstr "" #: ../../app4.rst:97 40e65f53ef05490796b7a4aec9577410 msgid "many pages" msgstr "" #: ../../app4.rst:98 e798c081493c4df095c56e07a50ca1b9 msgid "`pymupdf.pdf`" msgstr "" #: ../../app4.rst:99 9648e1df46804af395045a08a83de9fe msgid "6,805,176" msgstr "" #: ../../app4.rst:100 7f91a57f8a7847b4bd037094e00faa9a msgid "478" msgstr "" #: ../../app4.rst:101 226cdbfe630949eab54a52805869a6e7 msgid "276" msgstr "" #: ../../app4.rst:102 f30b492e535c41748786f54e00e90cb8 msgid "5,277" msgstr "" #: ../../app4.rst:103 2701b877b410466cb1ae77dd1a2a1e90 msgid "14" msgstr "" #: ../../app4.rst:104 bcc9d1ef612c4e95b015b553232ad25a msgid "1,937" msgstr "" #: ../../app4.rst:105 befe3de8428943f2b55fa3759ae8cbd0 msgid "text oriented" msgstr "" #: ../../app4.rst:106 1fde26c15a56401eb49e5db71f99cc25 msgid "`pythonbook.pdf`" msgstr "" #: ../../app4.rst:107 abde300eb8244d23875981f20afdf6ce msgid "9,983,856" msgstr "" #: ../../app4.rst:108 f236fb08a1834afeae13579d512733ba msgid "669" msgstr "" #: ../../app4.rst:109 d7c1691699514ea893a728c74016301d msgid "198" msgstr "" #: ../../app4.rst:110 4af5202a95164d698a13772fb60448a8 msgid "1,953" msgstr "" #: ../../app4.rst:111 b4141c07d695403e87cedbe5de5863dd msgid "15" msgstr "" #: ../../app4.rst:112 72ae61bf2a1b4a52904b806afc0ff6f5 msgid "1,929" msgstr "" #: ../../app4.rst:114 bb501706366848629a8491cb70e58ec9 msgid "`sample-50-MB-pdf-file.pdf`" msgstr "" #: ../../app4.rst:115 542f200f9bbd48719bb31d4cf6850f3b msgid "52,521,850" msgstr "" #: ../../app4.rst:116 d0db6531af4e488ca48300bebf47246e msgid "1" msgstr "" #: ../../app4.rst:119 b80b76ee70584a34977f50acbea06df8 msgid "51,291" msgstr "" #: ../../app4.rst:120 52119106cfb04a489c5842fab93cd2c5 msgid "23,860" msgstr "" #: ../../app4.rst:121 513e58b0ccf547edaf2e1b8d4fc09391 msgid "single page, graphics oriented, large file size" msgstr "단일 페이지, 그래픽 지향, 큰 파일 크기" #: ../../app4.rst:127 b1d1466a4d4f46ee97f9c0c14866930d msgid "" "**adobe.pdf** and **pymupdf.pdf** are clearly text oriented, **artifex-" "website.pdf** and **sample-50-MB-pdf-file.pdf** are graphics oriented. " "Other files are a mix of both." msgstr "**adobe.pdf** 와 **pymupdf.pdf** 는 명확히 텍스트 지향적이며, **artifex-website.pdf** 와 **sample-50-MB-pdf-file.pdf** 는 그래픽 지향적입니다. 다른 파일들은 둘 다의 혼합입니다." #: ../../app4.rst:131 a46db6b46cbd476c9aa08e828b1899a9 msgid "Tools used" msgstr "사용된 도구" #: ../../app4.rst:133 eff071706abe45db98dc970ba599955e msgid "" "In each section, the same fixed set of |PDF| files is being processed by " "a set of tools. The set of tools used per performance aspect however " "varies, depending on the supported tool features." msgstr "각 섹션에서 동일한 고정된 |PDF| 파일 세트가 도구 세트에 의해 처리됩니다. 그러나 성능 측면별로 사용되는 도구 세트는 지원되는 도구 기능에 따라 다릅니다." #: ../../app4.rst:135 e7ff37e32cbd4cdc993c645e7658d227 msgid "" "All tools are either platform independent, or at least can run on both, " ":title:`Windows` and :title:`Unix` / :title:`Linux`." msgstr "모든 도구는 플랫폼 독립적이거나 최소한 :title:`Windows` 와 :title:`Unix` / :title:`Linux` 모두에서 실행할 수 있습니다." #: ../../app4.rst:141 7507beef7859479e94a8fa9cce614373 msgid "**Tool**" msgstr "**도구**" #: ../../app4.rst:142 7e5c5082ee244cc1850b389fa76d162b msgid "**Description**" msgstr "**설명**" #: ../../app4.rst:143 ../../app4.rst:172 ../../app4.rst:218 ../../app4.rst:296 #: ../../app4.rst:368 ../../app4.rst:408 51f2639233354454a2be6c8cf943caae #: 75b83e125f444081ac46f5b513ffb434 78511b7a3ae24d7ba242cb9f012c945c #: cf82339face445409b1cb2230b1cf737 e2f4e337aa6f46ff9d1a57a84bd40231 #: ea0496359fd4419f88ac295b9d5a7c35 msgid "|PyMuPDF|" msgstr "|PyMuPDF|" #: ../../app4.rst:144 265dd2b9a51a4748ae710d0a7781b16c msgid "The tool of this manual." msgstr "이 매뉴얼의 도구." #: ../../app4.rst:145 0d7018f04c2d4b8b91e09d879a94c489 msgid "PDFrw_" msgstr "PDFrw_" #: ../../app4.rst:146 1871dfbb59ed44559c1143b8f664ab3b msgid "" "A pure :title:`Python` tool, being used by :title:`rst2pdf`, has " "interface to :title:`ReportLab`." msgstr ":title:`rst2pdf` 에서 사용되는 순수 :title:`Python` 도구로, :title:`ReportLab` 에 대한 인터페이스를 가집니다." #: ../../app4.rst:147 db3dc67db0384a4caf25ec3159cc9e8c msgid "PyPDF2_" msgstr "PyPDF2_" #: ../../app4.rst:148 f00f0472c11846dd8a6d1cb0ac0237bf msgid "A pure :title:`Python` tool with a large function set." msgstr "큰 함수 집합을 가진 순수 :title:`Python` 도구." #: ../../app4.rst:149 719bb221eb5b4d34a21a977bfddfa966 msgid "PDFMiner_" msgstr "PDFMiner_" #: ../../app4.rst:150 7c679bd2a294494c86c754ffaddb5cf3 msgid "A pure :title:`Python` to extract text and other data from |PDF|." msgstr "|PDF| 에서 텍스트 및 기타 데이터를 추출하는 순수 :title:`Python`." #: ../../app4.rst:151 ef3100ff8d5049009f9896ca197346c5 msgid "XPDF_" msgstr "XPDF_" #: ../../app4.rst:152 89c9c95eccee414e90d74c494ef8fa0c msgid "A command line utility with multiple functions." msgstr "여러 기능을 가진 명령줄 유틸리티." #: ../../app4.rst:153 3ac8573211c94c1996a3f39372a5c365 msgid "PikePDF_" msgstr "PikePDF_" #: ../../app4.rst:154 ad269cc30d2f43dbbd44e72f1cfa24e9 msgid "" "A :title:`Python` package similar to :title:`PDFrw`, but based on " ":title:`C++` library :title:`QPDF`." msgstr ":title:`PDFrw` 와 유사한 :title:`Python` 패키지이지만, :title:`C++` 라이브러리 :title:`QPDF` 를 기반으로 합니다." #: ../../app4.rst:155 f7a4dbe832784e9c80a9bec19efd26e4 msgid "PDF2JPG_" msgstr "PDF2JPG_" #: ../../app4.rst:156 2354f030ddfb48028e2dc5dcdca588bf msgid "" "A :title:`Python` package specialized on rendering |PDF| pages to " ":title:`JPG` images." msgstr "|PDF| 페이지를 :title:`JPG` 이미지로 렌더링하는 데 특화된 :title:`Python` 패키지." #: ../../app4.rst:164 20ec5781714e43979415d31bca6e4d91 msgid "Copying / Joining / Merging" msgstr "복사 / 결합 / 병합" #: ../../app4.rst:166 24e5ae35daf74ce5af40e0c2fc945067 msgid "" "How fast is a |PDF| file read and its content parsed for further " "processing? The sheer parsing performance cannot directly be compared, " "because batch utilities always execute a requested task completely, in " "one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for " "parsing, meaning it only parses those parts of a document that are " "required in any moment." msgstr "|PDF| 파일을 읽고 내용을 추가 처리하기 위해 파싱하는 속도는 얼마나 빠른가? 순수 파싱 성능은 직접 비교할 수 없습니다. 왜냐하면 배치 유틸리티는 항상 요청된 작업을 처음부터 끝까지 한 번에 완전히 실행하기 때문입니다. :title:`PDFrw` 도 *지연* 파싱 전략을 가지며, 이는 언제든지 필요한 문서 부분만 파싱한다는 의미입니다." #: ../../app4.rst:168 9030ee0b64da48c4b6ba3563a6fe7da8 msgid "" "To find an answer to the question, we therefore measure the time to copy " "a |PDF| file to an output file with each tool, and do nothing else." msgstr "이 질문에 대한 답을 찾기 위해, 각 도구로 |PDF| 파일을 출력 파일에 복사하는 데 걸리는 시간을 측정하고 다른 작업은 수행하지 않습니다." #: ../../app4.rst:170 ../../app4.rst:365 75c4e9d6b0f94276ad4a46e7ca064b4c #: d29245da53b44d4c931cdfd53a686bcb msgid "These are the :title:`Python` commands for how each tool is used:" msgstr "각 도구를 사용하는 방법에 대한 :title:`Python` 명령은 다음과 같습니다:" #: ../../app4.rst:180 40554a7aac2c4529a5cea2cb201adc33 msgid ":title:`PDFrw`" msgstr ":title:`PDFrw`" #: ../../app4.rst:190 2027a14c030c4dafa9b213b842921038 msgid ":title:`PikePDF`" msgstr ":title:`PikePDF`" #: ../../app4.rst:198 0554b1918f0442929d092d7d1aa8c6db msgid ":title:`PyPDF2`" msgstr ":title:`PyPDF2`" #: ../../app4.rst:210 ../../app4.rst:288 ../../app4.rst:399 #: 0cc77d5085aa42b092a9d28c9f9b93d1 2151ed94f39e42489d9407b0a8ac0ccb #: 8e952a6e6d1d46499282ea93f770529c msgid "**Observations**" msgstr "**관찰 결과**" #: ../../app4.rst:212 ../../app4.rst:290 ../../app4.rst:401 #: 190b33a2a1264d58900d557c11876da4 2995f439d6cb495da4b80e31d49c47a7 #: 536ccc62e0b8415f92d295558b4e0e5b msgid "" "These are our run time findings in **seconds** along with a base rate " "summary compared to |PyMuPDF|:" msgstr "다음은 **초** 단위의 실행 시간 결과와 |PyMuPDF| 와 비교한 기준 비율 요약입니다:" #: ../../app4.rst:219 a51de26a6852481a8e70a53e96187379 msgid "**PDFrw**" msgstr "**PDFrw**" #: ../../app4.rst:220 933434ca403749c0a4f630ffec63fbf0 msgid "**PikePDF**" msgstr "**PikePDF**" #: ../../app4.rst:221 ../../app4.rst:298 93a77920ab2f426481a1d5037c17135f #: a5fda08d4d34464ba81569732331f63c msgid "**PyPDF2**" msgstr "**PyPDF2**" #: ../../app4.rst:222 ../../app4.rst:300 ../../app4.rst:411 #: 5544726c03fb43a2afaa6c61866bba6a 5ade818fb72c4831ad8691c9cf811c78 #: af7a989e3b5144c1a3f9d080bc5aea03 msgid "adobe.pdf" msgstr "" #: ../../app4.rst:223 aea85b36f9074c44ac0e480e9feedf9a msgid "1.75" msgstr "" #: ../../app4.rst:224 1d5d21531c014823b5bd62db7bc0135e msgid "5.15" msgstr "" #: ../../app4.rst:225 29285cb95fbc41c7b91b01dda4181c2d msgid "22.37" msgstr "" #: ../../app4.rst:226 68b490eb621f4f4eb992f5e5eb9baff5 msgid "374.05" msgstr "" #: ../../app4.rst:227 ../../app4.rst:305 ../../app4.rst:415 #: 00246b4fa6bb413aaecfac538ed32b19 20452d17f0ed4d98ab1d92047ddb55a7 #: dc633929adc3417d9c90d8be2bf90613 msgid "artifex-website.pdf" msgstr "" #: ../../app4.rst:228 3e3d60bb5a06431f8423b7fa72008e45 msgid "0.26" msgstr "" #: ../../app4.rst:229 ../../app4.rst:243 2ce822ddafa04eacb665dcdd8bb34f25 #: a0ca8a854b9c428a9257c8dbf52b4590 msgid "0.38" msgstr "" #: ../../app4.rst:230 63e990f7145f451dac1615b7274b980f msgid "1.41" msgstr "" #: ../../app4.rst:231 e5e9ce25649c4a7e87d9cfed1d4c1f0a msgid "2.81" msgstr "" #: ../../app4.rst:232 ../../app4.rst:310 ../../app4.rst:419 #: 1abbb91fd2804bff9cc59d244e834dbe 25ef69a136294635ad82241de488155a #: 5c166f9365fb4824bbe295d262a4c695 msgid "db-systems.pdf" msgstr "" #: ../../app4.rst:233 dfa580f9d5494073b720002293a6fa82 msgid "0.15" msgstr "" #: ../../app4.rst:234 0cabf0e69a2e40a8920e44b780f064b6 msgid "0.8" msgstr "" #: ../../app4.rst:235 1b45bb6fb5384d11863727a44bc772d5 msgid "1.68" msgstr "" #: ../../app4.rst:236 482704feedf44b168160d5c6bf430e89 msgid "2.46" msgstr "" #: ../../app4.rst:237 ../../app4.rst:315 ../../app4.rst:423 #: 28cf3f5a2e644968b1b497d836968533 619f6293468e4a5b9414def4ae968f6a #: a54e51785c104643876df4110d7f60fb msgid "fontforge.pdf" msgstr "" #: ../../app4.rst:238 80142473274946b2b76110266168f6d2 msgid "0.09" msgstr "" #: ../../app4.rst:239 fdeb0d08542549ad94e6f5ff68f639e1 msgid "0.14" msgstr "" #: ../../app4.rst:240 fa056a25dbc24ce8bbb7206ac25c05ae msgid "0.28" msgstr "" #: ../../app4.rst:241 ../../app4.rst:308 4bafecabe76b409d8db8ac377d7f7ea9 #: 5206ddcbea3c43ab869b569ff3172038 msgid "1.1" msgstr "" #: ../../app4.rst:242 ../../app4.rst:320 ../../app4.rst:427 #: 283144343a0949668598a967aab1deef 2bf82f9384f34930a1debf451276e32e #: f64eb5e532a04104b1c1491cdd231638 msgid "pandas.pdf" msgstr "" #: ../../app4.rst:244 c0f38df2b0cd4082acfb9b25f340902a msgid "2.21" msgstr "" #: ../../app4.rst:245 9594837d5d2848c6bd8fc40d23f432db msgid "2.73" msgstr "" #: ../../app4.rst:246 d52e2689ad7047df8dcab08a5b7c5417 msgid "70.3" msgstr "" #: ../../app4.rst:247 ../../app4.rst:325 ../../app4.rst:431 #: 6adf778936ea4b1bac0e0112c0f3d53a ca7e5c0d37d843a5a058022264ef4838 #: df12e19f983a4715a95aa5e1c4259037 msgid "pymupdf.pdf" msgstr "" #: ../../app4.rst:248 50c706b1c6eb4ba783605c298016ffd9 msgid "0.11" msgstr "" #: ../../app4.rst:249 e6316c498d704c12a367a5598ce1dfa4 msgid "0.56" msgstr "" #: ../../app4.rst:250 c9b02d42498945f39b746d182ceef93f msgid "0.83" msgstr "" #: ../../app4.rst:251 a866f67188d54c70912cd3e19c35d760 msgid "6.05" msgstr "" #: ../../app4.rst:252 ../../app4.rst:330 ../../app4.rst:435 #: 2d6911f21f034fdb99236c6da0e5c8fc ca646d19848a4024b113f84e29e5f016 #: ddf7610dcd7d4c2085d801cc70dfa46b msgid "pythonbook.pdf" msgstr "" #: ../../app4.rst:253 6f0fe33ac23b4d0baf5009363bc75c5b msgid "0.19" msgstr "" #: ../../app4.rst:254 680b3cbd12934d07830711fdf35d8c00 msgid "1.2" msgstr "" #: ../../app4.rst:255 fbbf220c922f4a53ab16e06f0c5042ee msgid "1.34" msgstr "" #: ../../app4.rst:256 e94988b7dbc347c09260a2b8a03dd461 msgid "37.19" msgstr "" #: ../../app4.rst:257 ../../app4.rst:335 ../../app4.rst:439 #: a9d4ceb80d2c42e0b7bf4c22de480e63 aa346b20c8c14103ad508c92238ca1a8 #: b0d041755ac04554a0acc858c79f4516 msgid "sample-50-MB-pdf-file.pdf" msgstr "" #: ../../app4.rst:258 bcc275d36bf04161834713d6d786e356 msgid "0.12" msgstr "" #: ../../app4.rst:259 cb526a85171a4e5c924b02fae9f5cff1 msgid "0.1" msgstr "" #: ../../app4.rst:260 57e608621ccb4404a586b7361b537020 msgid "2.93" msgstr "" #: ../../app4.rst:261 e280682fa0f048f7bf4a842026ed388c msgid "0.08" msgstr "" #: ../../app4.rst:262 ../../app4.rst:340 ../../app4.rst:443 #: 147889494a0342d39c8d7bc589e777a1 9dde60202b154d62bb5dc5da1b8f3eb4 #: dcdc53ddede34633afbb78b8cb474780 msgid "**Total**" msgstr "**총계**" #: ../../app4.rst:263 482ff9ef77514db0a3105d43540c6a79 msgid "**3.05**" msgstr "" #: ../../app4.rst:264 2f728a892b10493f83a211bbe00dc8c2 msgid "**10.54**" msgstr "" #: ../../app4.rst:265 8a1310321389468b8eeb7302181de22f msgid "**33.57**" msgstr "" #: ../../app4.rst:266 8979d1c755ab4d5480e0e543908439ab msgid "**494.04**" msgstr "" #: ../../app4.rst:272 ../../app4.rst:350 ../../app4.rst:451 #: 39d408ac310b429a9f4630de549c0218 b1cedcb976d7467cb64b4a03e059059f #: d60f7ab07be042e9ac4f315656e9d80e msgid "**Rate compared to PyMuPDF**" msgstr "**PyMuPDF 와 비교한 비율**" #: ../../app4.rst:273 ../../app4.rst:351 ../../app4.rst:452 #: 5fe241f7da6f4f1287b2ef598e77e63a a1eabf390faf4118b9fbf1c23bcaa970 #: ca4532068a8749cebe70ecd680077cff msgid ":green-color:`1.0`" msgstr "" #: ../../app4.rst:274 4bebef049b2147ec9412439a06413b0c msgid ":orange-color:`3.5`" msgstr "" #: ../../app4.rst:275 bd4c733cfe544784bfac89860db9068e msgid ":orange-color:`11.0`" msgstr "" #: ../../app4.rst:276 65a3d5ea7ac842238d61067451bc62b9 msgid ":red-color:`162`" msgstr "" #: ../../app4.rst:283 1cd4fd60fed8493aa0180e6aced6f887 msgid "Text Extraction" msgstr "텍스트 추출" #: ../../app4.rst:285 43ec059052ef49239504e79c59d48792 msgid "" "The following table shows plain text extraction durations. All tools have" " been used with their most basic functionality - i.e. no layout re-" "arrangements, etc." msgstr "다음 표는 일반 텍스트 추출 기간을 보여줍니다. 모든 도구는 가장 기본적인 기능으로 사용되었습니다 -- 즉, 레이아웃 재배치 등이 없습니다." #: ../../app4.rst:297 ../../app4.rst:409 493d81649a04476aa7e157c8155e8816 #: c7a4bc884d3e4b39ab49157d277af5e6 msgid "**XPDF**" msgstr "**XPDF**" #: ../../app4.rst:299 55447e13f7cc43598fde158caf1adfbf msgid "**PDFMiner**" msgstr "**PDFMiner**" #: ../../app4.rst:301 71ff39c17b764e46a725f342a082f147 msgid "2.01" msgstr "" #: ../../app4.rst:302 fce895fddd9544e4b84bbc464bc5d54a msgid "6.19" msgstr "" #: ../../app4.rst:303 11d7da5f489c4d5c8f08904e64d58b85 msgid "22.2" msgstr "" #: ../../app4.rst:304 7a43720209f2409891b79edcb6feebc8 msgid "49.15" msgstr "" #: ../../app4.rst:306 86da45bd435e4e2fac8f537ac4dc33c6 msgid "0.18" msgstr "" #: ../../app4.rst:307 9f329e56a13e4944887ba215aadd1c50 msgid "0.3" msgstr "" #: ../../app4.rst:309 412c97e97e644221bec455efaa9ee865 msgid "4.06" msgstr "" #: ../../app4.rst:311 3211848a2c7541c4b98431190bc82a51 msgid "1.57" msgstr "" #: ../../app4.rst:312 7888933412524d77b9710d7c349a6ad8 msgid "4.26" msgstr "" #: ../../app4.rst:313 78ac7fd7df42471aa6a3ac3bb3b13b4f msgid "25.75" msgstr "" #: ../../app4.rst:314 fbda6230814e4005b8c47d862c0364c4 msgid "42.19" msgstr "" #: ../../app4.rst:316 05c924d4dc1e4feb955b06be14c5e7e7 msgid "0.24" msgstr "" #: ../../app4.rst:317 eff929019a05485ab7d424571a631738 msgid "0.47" msgstr "" #: ../../app4.rst:318 d732cff1f2af4741b0cf005af6150933 msgid "2.69" msgstr "" #: ../../app4.rst:319 d717cab56bbc403fa2d497180e09afac msgid "4.2" msgstr "" #: ../../app4.rst:321 6f2bb2d646834a28b637393c83fbe756 msgid "2.41" msgstr "" #: ../../app4.rst:322 297e3c2d5f354ca6a5f331312ada2eb9 msgid "10.54" msgstr "" #: ../../app4.rst:323 e7aaee8a7d6d46738acd6d36fd3a1a2b msgid "25.38" msgstr "" #: ../../app4.rst:324 22691134bd124353bac936a15dc23c7d msgid "76.56" msgstr "" #: ../../app4.rst:326 beb7e60f87f44b00941524176f83234b msgid "0.49" msgstr "" #: ../../app4.rst:327 f1987f898ec44e2eae7731378a36d310 msgid "2.34" msgstr "" #: ../../app4.rst:328 ef61cf5a5cb042fdbb4db7ffb338d866 msgid "6.44" msgstr "" #: ../../app4.rst:329 22b1b07b84d542088f18ea5fb77ba24f msgid "13.55" msgstr "" #: ../../app4.rst:331 0832e852468f492a9ecffee3998af4f2 msgid "0.84" msgstr "" #: ../../app4.rst:332 3a29ccef7ff44af0bbc12374a5983e38 msgid "2.88" msgstr "" #: ../../app4.rst:333 be833e3e8322409ba592cc7891bfd260 msgid "9.28" msgstr "" #: ../../app4.rst:334 fb41a43110744ce98af7eee58740fb05 msgid "24.27" msgstr "" #: ../../app4.rst:336 81ca0ec15e384df3998d921f54470058 msgid "0.27" msgstr "" #: ../../app4.rst:337 fe5e6af169c04db999c3003913c8ad6e msgid "0.44" msgstr "" #: ../../app4.rst:338 9220f3fa950e47009211a9f69d405117 msgid "8.8" msgstr "" #: ../../app4.rst:339 a9338bdb413148689255f70fbeead632 msgid "13.29" msgstr "" #: ../../app4.rst:341 978aa50a4e73446ca6444f7911b99137 msgid "**8.01**" msgstr "" #: ../../app4.rst:342 c80a0bb069c644938e92b9da92483efa msgid "**27.42**" msgstr "" #: ../../app4.rst:343 3aff3e7279a74a2b90e22e23593c2795 msgid "**101.64**" msgstr "" #: ../../app4.rst:344 4fe0e88c92fd44c7af9bc827ce45422c msgid "**227.27**" msgstr "" #: ../../app4.rst:352 63cc33b2658d4c45b2ba8cbe943bd222 msgid ":orange-color:`3.42`" msgstr "" #: ../../app4.rst:353 0533ece4f3e14f7c96cb711e9d3b3fbf msgid ":orange-color:`12.69`" msgstr "" #: ../../app4.rst:354 1a614a3651e448a9911ab3eedaac4d42 msgid ":red-color:`28.37`" msgstr "" #: ../../app4.rst:360 00b592ac57f64130a8654c00830f154e msgid "Page Rendering" msgstr "페이지 렌더링" #: ../../app4.rst:362 f5119aaf183e4f4eb483e9c337c88488 msgid "" "We have tested rendering speed of |PyMuPDF| against :title:`pdf2jpg` and " ":title:`XPDF` at a resolution of 150 DPI," msgstr "150 DPI 해상도에서 :title:`pdf2jpg` 및 :title:`XPDF` 와 비교하여 |PyMuPDF| 의 렌더링 속도를 테스트했습니다," #: ../../app4.rst:382 02cf04dabcd44b9998f6e4e25bbca5ee msgid ":title:`XPDF`" msgstr ":title:`XPDF`" #: ../../app4.rst:389 90770272b10c416e84826a42e1c212cc msgid ":title:`PDF2JPG`" msgstr ":title:`PDF2JPG`" #: ../../app4.rst:410 c717d43cc70e48e98e87edcf403d8b03 msgid "**PDF2JPG**" msgstr "**PDF2JPG**" #: ../../app4.rst:412 da606418caee4a099a285d88fdee4bcb msgid "51.33" msgstr "" #: ../../app4.rst:413 d42b2bb121b54a939a97fd7c82e60632 msgid "98.16" msgstr "" #: ../../app4.rst:414 97e1e5c516654f909a445d6158df2fef msgid "75.71" msgstr "" #: ../../app4.rst:416 c1a00e6812494e27a1e5513c5dcb6515 msgid "26.35" msgstr "" #: ../../app4.rst:417 525f071275c846daaccf5b9ad9472c35 msgid "51.28" msgstr "" #: ../../app4.rst:418 dab5c30a6ab14679837b7c79be1baef5 msgid "54.11" msgstr "" #: ../../app4.rst:420 6347c08651eb4dfc963827edfe3c2dfa msgid "84.59" msgstr "" #: ../../app4.rst:421 9ff9e6ea2bff413e96b7948a6cdd6c2d msgid "143.16" msgstr "" #: ../../app4.rst:422 088e57b2eec94b3bbbf1258987f8c664 msgid "405.22" msgstr "" #: ../../app4.rst:424 b3cf9ee794b34bad8b6dbfe411512b74 msgid "12.23" msgstr "" #: ../../app4.rst:425 d51b92890c7442579c00adf23e97f279 msgid "22.18" msgstr "" #: ../../app4.rst:426 3f7b41851cdf4ca493af2c869d25b055 msgid "20.14" msgstr "" #: ../../app4.rst:428 226831c9dbf7408f9116226b0776dff5 msgid "138.74" msgstr "" #: ../../app4.rst:429 c0ff7f066efe4586859fcd60916d8201 msgid "241.67" msgstr "" #: ../../app4.rst:430 c348dd9ee91b448aad5e075ccac79cbc msgid "202.06" msgstr "" #: ../../app4.rst:432 5ac66403bf9a49aead460327d7c44f45 msgid "22.35" msgstr "" #: ../../app4.rst:433 9173e53f1f69448a83d553ded32bb807 msgid "39.11" msgstr "" #: ../../app4.rst:434 89611809173d45ae8ac3a4f7089ee725 msgid "33.38" msgstr "" #: ../../app4.rst:436 533943d891b74af491898743b80b7be3 msgid "30.44" msgstr "" #: ../../app4.rst:437 940113c92ada4f3fabf8932a0ec143e4 msgid "49.12" msgstr "" #: ../../app4.rst:438 0698ab345b994705a75ccfaddd9670fa msgid "55.68" msgstr "" #: ../../app4.rst:440 022d36dd2a304fca9d994fd8aebb4229 msgid "1.01" msgstr "" #: ../../app4.rst:441 fb7736a3bc7c4ca29f4fce61faf4b788 msgid "1.32" msgstr "" #: ../../app4.rst:442 dabe4ab239f1407f95b68ad8269a33af msgid "5.22" msgstr "" #: ../../app4.rst:444 23819f93562342a8b546fc017760f1c2 msgid "**367.04**" msgstr "" #: ../../app4.rst:445 1616c1fe2bca4ff2a048b9308c0f246e msgid "**646**" msgstr "" #: ../../app4.rst:446 5bdba98414414ff8ac81e89e0e221e71 msgid "**851.52**" msgstr "" #: ../../app4.rst:453 d581d4e1ac754c2b9e0172b86aeb3edf msgid ":orange-color:`1.76`" msgstr "" #: ../../app4.rst:454 5a2a9f45f5b14d398c5c1891f3ed968c msgid ":red-color:`2.32`" msgstr "" #: ../../footer.rst:46 6f6b539ff34a4640ab8af9e5deaeacb0 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/archive-class.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7172941a6af740c8a8c939eeb12aab6f msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 7f24f6f0cd5c48f7b5ef12886e7d3dc2 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 2ce7ac460eea4d7fa274674358f58cb3 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../archive-class.rst:7 4da66911f34043f4b535f63a47cba447 msgid "Archive" msgstr "Archive (아카이브)" #: ../../archive-class.rst:9 1dbbb103178b492a8c9bf5b05d021272 msgid "New in v1.21.0" msgstr "v1.21.0에서 새로 추가됨" #: ../../archive-class.rst:11 1e7ee6091313470abe0dcc5c8168a504 msgid "" "This class represents a generalization of file folders and container " "files like ZIP and TAR archives. Archives allow accessing arbitrary " "collections of file folders, ZIP / TAR files and single binary data " "elements as if they all were part of one hierarchical tree of folders." msgstr "이 클래스는 ZIP 및 TAR 아카이브와 같은 파일 폴더 및 컨테이너 파일의 일반화를 나타냅니다. 아카이브는 파일 폴더, ZIP/TAR 파일 및 단일 바이너리 데이터 요소의 임의 컬렉션에 접근할 수 있게 하며, 모두 하나의 계층적 폴더 트리의 일부인 것처럼 처리합니다." #: ../../archive-class.rst:13 bc799244f4a54577b1ab6043ddcef969 msgid "" "In PyMuPDF, archives are currently only used by :ref:`Story` objects to " "specify where to look for fonts, images and other resources." msgstr "|PyMuPDF| 에서 아카이브는 현재 :ref:`Story` 객체에서만 사용되며, 글꼴, 이미지 및 기타 리소스를 찾을 위치를 지정합니다." #: ../../archive-class.rst:16 733307d2ac0c48d5943722db88b66ca3 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../archive-class.rst:16 067a02c3d0eb402e87db2ab8a79cec6a msgid "**Short Description**" msgstr "**간략 설명**" #: ../../archive-class.rst:18 917e00b33c264053b763260480ae3cb0 msgid ":meth:`Archive.add`" msgstr ":meth:`Archive.add`" #: ../../archive-class.rst:18 5758685d282946d0b76452d8a3d35bf1 msgid "add new data to the archive" msgstr "아카이브에 새 데이터 추가" #: ../../archive-class.rst:19 96e83a97ca3a4e0d99f2eba9b8dd862c msgid ":meth:`Archive.has_entry`" msgstr ":meth:`Archive.has_entry`" #: ../../archive-class.rst:19 e29b1efc996f43298b3e2c9fd91522a4 msgid "check if given name is a member" msgstr "주어진 이름이 멤버인지 확인" #: ../../archive-class.rst:20 7e3fbbcec68b4db0b0e06433c33177c1 msgid ":meth:`Archive.read_entry`" msgstr ":meth:`Archive.read_entry`" #: ../../archive-class.rst:20 4cbe9ceb4c8744f69ad9da999cf33862 msgid "read the data given by the name" msgstr "이름으로 지정된 데이터 읽기" #: ../../archive-class.rst:21 40716b5223004d5ba100ffb57f39be5a msgid ":attr:`Archive.entry_list`" msgstr ":attr:`Archive.entry_list`" #: ../../archive-class.rst:21 c6a15b6d228b4c37a9d06697f7992694 msgid "list[dict] of archive items" msgstr "아카이브 항목의 list[dict]" #: ../../archive-class.rst:24 d96c6d9573704987968f177a3bf7a3ad msgid "**Class API**" msgstr "**클래스 API**" #: ../../archive-class.rst:30 d4ac6bed829f43429a56efde53217fce msgid "Creates a new archive. Without parameters, an empty archive is created." msgstr "새 아카이브를 생성합니다. 매개변수가 없으면 빈 아카이브가 생성됩니다." #: ../../archive-class.rst:32 ce56c558cdfd467bb88c2e5a14edbc06 msgid "If provided, `content` may be one of the following:" msgstr "제공되는 경우 `content` 는 다음 중 하나일 수 있습니다:" #: ../../archive-class.rst:34 b4730a481ea84967b6cb58ae9fe5ba6e msgid "another Archive: the archive is being made a sub-archive of the new one." msgstr "다른 Archive: 아카이브가 새 아카이브의 하위 아카이브가 됩니다." #: ../../archive-class.rst:36 5b42f6018b314dbca0ec8d6039baf4d7 msgid "" "a string: this must be the name of a local folder or file. `pathlib.Path`" " objects are also supported." msgstr "문자열: 로컬 폴더 또는 파일의 이름이어야 합니다. `pathlib.Path` 객체도 지원됩니다." #: ../../archive-class.rst:38 619d605a712947c2a548c8e110f21c7d msgid "" "A **folder** will be converted to a sub-archive, so its files (and any " "sub-folders) can be accessed by their names." msgstr "**폴더** 는 하위 아카이브로 변환되므로 파일(및 모든 하위 폴더)을 이름으로 접근할 수 있습니다." #: ../../archive-class.rst:39 4cd647737643458d9e392abbb2da302c msgid "" "A **file** will be read with mode `\"rb\"` and these binary data (a " "`bytes` object) be treated as a single-member sub-archive. In this case, " "the `path` parameter is **mandatory** and should be the member name under" " which this item can be found / retrieved." msgstr "**파일** 은 `\"rb\"` 모드로 읽히며 이 바이너리 데이터(`bytes` 객체)는 단일 멤버 하위 아카이브로 처리됩니다. 이 경우 `path` 매개변수는 **필수** 이며 이 항목을 찾거나 검색할 수 있는 멤버 이름이어야 합니다." #: ../../archive-class.rst:41 6b1e54d53ee048bebe0aa7b13aa24963 msgid "" "a `zipfile.ZipFile` or `tarfile.TarFile` object: Will be added as a sub-" "archive." msgstr "`zipfile.ZipFile` 또는 `tarfile.TarFile` 객체: 하위 아카이브로 추가됩니다." #: ../../archive-class.rst:43 3e15f440e05843dc80023b21dca6c101 msgid "" "a Python binary object (`bytes`, `bytearray`, `io.BytesIO`): this will " "add a single-member sub-archive. In this case, the `path` parameter is " "**mandatory** and should be the member name under which this item can be " "found / retrieved." msgstr "Python 바이너리 객체(`bytes`, `bytearray`, `io.BytesIO`): 단일 멤버 하위 아카이브를 추가합니다. 이 경우 `path` 매개변수는 **필수** 이며 이 항목을 찾거나 검색할 수 있는 멤버 이름이어야 합니다." #: ../../archive-class.rst:45 0d17f917bfaf4703827752f14540c1b0 msgid "" "a tuple `(data, name)`: This will add a single-member sub-archive with " "the member name ``name``. ``data`` may be a Python binary object or a " "local file name (in which case its binary file content is used). Use this" " format if you need to specify `path`." msgstr "튜플 `(data, name)`: 멤버 이름 ``name`` 을 가진 단일 멤버 하위 아카이브를 추가합니다. ``data`` 는 Python 바이너리 객체이거나 로컬 파일 이름일 수 있습니다(이 경우 바이너리 파일 내용이 사용됨). `path` 를 지정해야 하는 경우 이 형식을 사용하세요." #: ../../archive-class.rst:47 1597cdc3f8254638bf2cdf9bc2309574 msgid "" "a Python sequence: This is a convenience format to specify any " "combination of the above." msgstr "Python 시퀀스: 위 항목의 임의 조합을 지정하는 편의 형식입니다." #: ../../archive-class.rst:49 4988de212ed54833a49be91d2d82d21d msgid "If provided, `path` must be a string." msgstr "제공되는 경우 `path` 는 문자열이어야 합니다." #: ../../archive-class.rst:51 f90f1ba75dbd4b94be663d3d1a03ce47 msgid "" "If `content` is either binary data or a file name, this parameter is " "mandatory and must be the name under which the data can be found." msgstr "`content` 가 바이너리 데이터이거나 파일 이름인 경우 이 매개변수는 필수이며 데이터를 찾을 수 있는 이름이어야 합니다." #: ../../archive-class.rst:53 2b3e0332d6b34ab1ad0dd16b095eadfe msgid "" "Otherwise this parameter is optional. It can be used to simulate a folder" " name or a mount point, under which this sub-archive's elements can be " "found. For example this specification `Archive((data, \"name\"), " "\"path\")` means that `data` will be found using the element name " "`\"path/name\"`. Similar is true for other sub-archives: to retrieve " "members of a ZIP sub-archive, their names must be prefixed with " "`\"path/\"`. The main purpose of this parameter probably is to " "differentiate between duplicate names." msgstr "그렇지 않으면 이 매개변수는 선택 사항입니다. 폴더 이름이나 마운트 포인트를 시뮬레이션하는 데 사용할 수 있으며, 이 하위 아카이브의 요소를 찾을 수 있습니다. 예를 들어 이 사양 `Archive((data, \"name\"), \"path\")` 는 `data` 가 요소 이름 `\"path/name\"` 을 사용하여 찾을 수 있음을 의미합니다. 다른 하위 아카이브도 마찬가지입니다: ZIP 하위 아카이브의 멤버를 검색하려면 이름에 `\"path/\"` 접두사가 있어야 합니다. 이 매개변수의 주요 목적은 아마도 중복 이름을 구분하는 것입니다." #: ../../archive-class.rst:55 5faa270a9a8e4b1e9cb54ca0b81bec9e msgid "" "If duplicate entry names exist in the archive, always the last entry with" " that name will be found / retrieved. During archive creation, or " "appending more data to an archive (see :meth:`Archive.add`) no check for " "duplicates will be made. Use the `path` parameter to prevent this from " "happening." msgstr "아카이브에 중복 항목 이름이 존재하는 경우 항상 해당 이름의 마지막 항목이 찾아지거나 검색됩니다. 아카이브 생성 중 또는 아카이브에 더 많은 데이터를 추가하는 동안(:meth:`Archive.add` 참조) 중복 확인이 수행되지 않습니다. 이를 방지하려면 `path` 매개변수를 사용하세요." #: ../../archive-class.rst:59 8f8691f33cb24edf8cf015488e88618a msgid "" "Append a sub-archive. The meaning of the parameters are exactly the same " "as explained above. Of course, parameter `content` is not optional here." msgstr "하위 아카이브를 추가합니다. 매개변수의 의미는 위에서 설명한 것과 정확히 같습니다. 물론 여기서는 `content` 매개변수가 선택 사항이 아닙니다." #: ../../archive-class.rst:63 d7d9c4ee5eb44c0b95fe42f32102c97a msgid "Checks whether an entry exists in any of the sub-archives." msgstr "항목이 하위 아카이브 중 하나에 존재하는지 확인합니다." #: ../../archive-class.rst 5f8828ec2f374296878d56b8bda07845 #: 8a109a840a9f48f69f8ad6d589cd57ea msgid "Parameters" msgstr "매개변수" #: ../../archive-class.rst:65 ../../archive-class.rst:73 #: 9a6f2dbd567f43d2bfe08e06091dcabb ed415071f9ec4041bffb1dcf6075f18d msgid "" "The fully qualified name of the entry. So must include any `path` prefix " "under which the entry's sub-archive has been added." msgstr "항목의 정규화된 이름. 항목의 하위 아카이브가 추가된 `path` 접두사를 포함해야 합니다." #: ../../archive-class.rst 77dc263426c34dc88d2d354f2137f0bd #: d7ec8d61f7784b09a3583b2731f89a03 msgid "Returns" msgstr "반환값" #: ../../archive-class.rst:67 82d8554eda284d14be8c15dcd79fb3ca msgid "`True` or `False`." msgstr "`True` 또는 `False`." #: ../../archive-class.rst:71 a873f11522bd47f09f770c162ec439ca msgid "Retrieve the data of an entry." msgstr "항목의 데이터를 검색합니다." #: ../../archive-class.rst:75 1dcd801a861448d2bc31a0ae9ab2b9ca msgid "" "The binary data (`bytes`) of the entry. If not found, an exception is " "raised." msgstr "항목의 바이너리 데이터(`bytes`). 찾을 수 없으면 예외가 발생합니다." #: ../../archive-class.rst:79 7e31c0d4b2874e7aa8dd5ae7daa91341 msgid "" "A list of the archive's sub-archives. Each list item is a dictionary with" " the following keys:" msgstr "아카이브의 하위 아카이브 목록. 각 목록 항목은 다음 키를 가진 딕셔너리입니다:" #: ../../archive-class.rst:81 dc6567d9e6a4485690cf0a5f6fb09b30 msgid "`entries` -- a list of (top-level) entry names in this sub-archive." msgstr "`entries` -- 이 하위 아카이브의 (최상위) 항목 이름 목록." #: ../../archive-class.rst:82 78d2dbe9caeb4e6b9ae6de4d14d95e52 msgid "" "`fmt` -- the format of the sub-archive. This is one of the strings " "\"dir\" (file folder), \"zip\" (ZIP archive), \"tar\" (TAR archive), or " "\"tree\" for single binary entries or file content." msgstr "`fmt` -- 하위 아카이브의 형식. 문자열 \"dir\"(파일 폴더), \"zip\"(ZIP 아카이브), \"tar\"(TAR 아카이브) 또는 단일 바이너리 항목이나 파일 내용의 경우 \"tree\" 중 하나입니다." #: ../../archive-class.rst:83 8934885694024d44ac1f04c95acb8fae msgid "" "`path` -- the value of the `path` parameter under which this sub-archive " "was added." msgstr "`path` -- 이 하위 아카이브가 추가된 `path` 매개변수의 값." #: ../../archive-class.rst:85 9bd80fbd40594e6da4b7541250d79442 msgid "**Example:**" msgstr "**예제:**" #: ../../footer.rst:46 23b6293c2dc24cbd87c6de2cd2f05c0c msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/changes.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 22:25+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9ffb1f48b2494df7b48540af9ba555e5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 f4528acfe03f4323a54be4f8f1c27047 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| (및 기타) 문서의 데이터 추출, 분석, 변환 및 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 f2a88f7cde9b4e52a457ae00f4060abc msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../../changes.txt:2 4cd69e5be9794686a140129e41fc4b95 msgid "Change Log" msgstr "" #: ../../../changes.txt:5 1505d60909e543b7809db6369fa0db8f msgid "**Changes in version 1.26.7**" msgstr "" #: ../../../changes.txt:7 ../../../changes.txt:43 ../../../changes.txt:73 #: ../../../changes.txt:95 ../../../changes.txt:117 ../../../changes.txt:146 #: ../../../changes.txt:171 ../../../changes.txt:192 ../../../changes.txt:212 #: ../../../changes.txt:236 ../../../changes.txt:285 ../../../changes.txt:335 #: ../../../changes.txt:366 ../../../changes.txt:387 ../../../changes.txt:423 #: ../../../changes.txt:443 ../../../changes.txt:457 ../../../changes.txt:485 #: ../../../changes.txt:507 ../../../changes.txt:530 ../../../changes.txt:556 #: ../../../changes.txt:589 ../../../changes.txt:611 ../../../changes.txt:625 #: ../../../changes.txt:642 ../../../changes.txt:664 ../../../changes.txt:673 #: ../../../changes.txt:686 ../../../changes.txt:698 ../../../changes.txt:715 #: ../../../changes.txt:728 ../../../changes.txt:741 ../../../changes.txt:754 #: ../../../changes.txt:766 ../../../changes.txt:778 ../../../changes.txt:801 #: ../../../changes.txt:833 ../../../changes.txt:859 ../../../changes.txt:899 #: ../../../changes.txt:926 ../../../changes.txt:948 ../../../changes.txt:1200 #: ../../../changes.txt:1334 049a26e13bb94229a79a69f81f7b5fbe #: 1f22271ed0b840efae8df95b0ee00fae 223eca2249444ff9ab2190c5225660fc #: 287da62560f74d3dab59fced5784a79f 289b8aaf54c746ecad54ca30175d6572 #: 2a7d7c2ae08a4078a26a35d98478462f 2d7b554ad4614d72aa34334544b1ad84 #: 3b0c2a7d2f02465d8a435c84b848e950 41d0c2d1b9dc4b92aaee342c76e8f6aa #: 4347b8c87fab492bb324cd690a0a5039 45a493f9bbb34d5d86014fc796fc7e5f #: 4ac9e175442d4fed9094777114001d05 5294b3baa70340d4b0683ea893cb8227 #: 55180f0a4ad14d779385728b45523412 56b9abeb67244e568154b0999908dc54 #: 590720763c4f4b6e944a5b6e9261c46a 5b96e63e430649e09364197f6640d348 #: 66a4fb9f871646b39fd2935322ff2bd7 681b44b2d00a428f95bec75570a9bd96 #: 6d3500e7906d4b5b9d5a852686c41f03 77caed4c8cf543c284393db2214dc425 #: 7930c830c16148e18e377994a974f7f6 8020c55d92a04b68b29f9b5c839563d9 #: 8dd9e915003d41dbbf42283bf55adefe 959e7f541c2147928cc800dcf3f54fa8 #: 980c2a259af24fc599c154fab471a6d4 9eeadae797794ba39efcdfe7dd30ea96 #: a1f33ce2da084e65927b1037ec5431c9 a5748cc98e13464f8d5833fb09a584c6 #: b003035ab22a486d8191c52df2f18d51 b1ac215bbe134f3e83fc2c3f1315274d #: b322fd43be9f42fcb134129f551f03d7 b8505854ea4346dca195196c3c729c8e #: baa47c681a164ab190fd710ab752c1e5 be5cdf51439747e9856bf7da70502394 #: c18708d565ec49bb9b6597c6e4746708 cbe526883f0a481b9e4b1e4727d250df #: d23ff8de34d7483c8f2da67985f1837a e53406c760874e3fba6776cc13ce71c4 #: ea5c09729ad243d1b44e29edb73a3242 f176ccdd28d44b75bfd267fa28648397 #: f325e778302b4997b940c6c03dc96ae8 fab1e85d6fcb480fba201316c8c6be02 msgid "Other:" msgstr "" #: ../../../changes.txt:9 eef8efb3b6884f43ada21c5e779231cb msgid "" "Retrospectively mark `4756 " "`_ as fixed in 1.26.6." msgstr "" #: ../../../changes.txt:10 64ed70e9271b4853b276b73970b50572 msgid "" "Improved safety of `pymupdf embed-extract`. This now refuses to write to " "an existing file or outside current directory, unless `-output` or new " "flag `-unsafe` is specified." msgstr "" #: ../../../changes.txt:15 f3d0c45b85df4b2e8952e6a2da3389b7 msgid "**Changes in version 1.26.6** (2025-11-05)" msgstr "" #: ../../../changes.txt:17 f42bfa1ba64243c3bbb367df56f3ac08 msgid "Use MuPDF-1.26.11." msgstr "" #: ../../../changes.txt:19 50c8518a04f0461d92243888e708323a msgid "Supported Python versions are now 3.10-3.14." msgstr "" #: ../../../changes.txt:21 ../../../changes.txt:35 ../../../changes.txt:59 #: ../../../changes.txt:87 ../../../changes.txt:110 ../../../changes.txt:132 #: ../../../changes.txt:164 ../../../changes.txt:183 ../../../changes.txt:203 #: ../../../changes.txt:226 ../../../changes.txt:249 ../../../changes.txt:259 #: ../../../changes.txt:274 ../../../changes.txt:294 ../../../changes.txt:304 #: ../../../changes.txt:321 ../../../changes.txt:347 ../../../changes.txt:380 #: ../../../changes.txt:396 ../../../changes.txt:406 ../../../changes.txt:438 #: ../../../changes.txt:475 ../../../changes.txt:502 ../../../changes.txt:524 #: ../../../changes.txt:541 ../../../changes.txt:584 ../../../changes.txt:605 #: ../../../changes.txt:619 ../../../changes.txt:632 ../../../changes.txt:658 #: ../../../changes.txt:671 07987b0a21a147d98b3290a64ffa8043 #: 1f57395ac4ea4c218653cd455c477ae4 21d647e365934565aea69ef24f0cd8f9 #: 262f48050967468c829ffe26a450be4b 4cef11a8719641dbb922f8aa1573a9c6 #: 4e96e411a9d04f3394926ff7a164019f 4f462e8fc6bf487c991f26164fb54c0f #: 502470bd29ee4a5f910f9b6c271e6371 5fac41e37738489fa8375e221307b3be #: 7d9274f30a6d48e080212ec423122787 7fb6e1f0f0a04c768954b3b7aa03e2f1 #: 8b358fae935541dd89ec020f9bdb1b41 8dbc5997591e480a88aef01fc75581db #: 94c9d89ad8d543cb833db162ba31fde4 9b23f29736354e1d8ed1668fd1f388bf #: 9e14b9596afa45b3a83e357fbda360af a2ea1d3f01d945e0b1771aa1b29caa0c #: a53b73a9f82648878f41f1760093e351 ad004edc4dba484fadde2289418127fe #: b70bd970a9944857a416f7ca0c9b1c6b bbd89b8b6e3544ab875a3a6e44ebe68d #: c08f485ce1c34a11ba134e40626b051f d727b39943064157a040eb5ba843fe41 #: d855c86985754c219d04723faa8e0b48 db0403d789674d7aae95b0d2af2dd802 #: e0509078460b456b924d980a899d39ea e182efb4eac34ad8bac7dece1504bf23 #: e2459e41e6d84b248942175137234803 e9129fdd854d4510beb02b78caf662e2 #: f752594e63ac42a1bc09a307033985cb f9a85782009445d9b72155a12a8ec8ed msgid "Fixed issues:" msgstr "" #: ../../../changes.txt:23 ae92f1fe5caf4bf1b49a2d9b55379d9c msgid "" "**Fixed** `4699 `_: " "cannot find ExtGState resource" msgstr "" #: ../../../changes.txt:24 22f8d06dd888459aa4f9fe1120d92dc8 msgid "" "**Fixed** `4712 `_: Crash" " with \"corrupted double-linked list\"" msgstr "" #: ../../../changes.txt:25 ccf146dfc96a47d3bab7d6102699c73d msgid "" "**Fixed** `4720 `_: " "Memory leaking in rewrite_images?" msgstr "" #: ../../../changes.txt:26 0f08a4cb18fe493ca72344c67c165f1d msgid "" "**Fixed** `4742 `_: " "'Rect' object has no attribute 'get_area'" msgstr "" #: ../../../changes.txt:27 e4563a3e5c574da8970663d208888aa7 msgid "" "**Fixed** `4746 `_: " "Document.__init__() got an unexpected keyword argument 'encoding'" msgstr "" #: ../../../changes.txt:28 2b1ad6590a63426bb7c3dc1b135aaf86 msgid "" "**Fixed** `4756 `_: swig " "--version doesn't work in all versions of swig; -version should be used " "instead" msgstr "" #: ../../../changes.txt:31 f4b0a46bedf54bc695a3074e319c3da7 msgid "**Changes in version 1.26.5** (2025-10-10)" msgstr "" #: ../../../changes.txt:33 25fffdf714bf48d695db8e6ab1a28c67 msgid "Use MuPDF-1.26.10." msgstr "" #: ../../../changes.txt:37 c88a8d28e397405f93d8379d00535d27 msgid "" "**Fixed** `2883 `_: " "Improve the Python type annotations for fitz_new" msgstr "" #: ../../../changes.txt:38 df91056120a24c1caa9c0b77f3fb1984 msgid "" "**Fixed** `4507 `_: Bugs " "in pyodide" msgstr "" #: ../../../changes.txt:39 70703777c2fa401bbc683f91ad94d06f msgid "" "**Fixed** `4613 `_: Thai " "and number blocks are not auto-scaled and get wrong hyphen when using in " "insert_htmlbox" msgstr "" #: ../../../changes.txt:40 c88bc69f0f244a52ad6f890499799047 msgid "" "**Fixed** `4700 `_: " "pymupdf.open() processes .zip file without raising" msgstr "" #: ../../../changes.txt:41 e323399440274525b34c54f4dec39093 msgid "" "**Fixed** `4716 `_: " "Problems with unreadable characters" msgstr "" #: ../../../changes.txt:45 3abefa34a28e4adf8e2457613ce56b45 msgid "Supported Python versions are now 3.9-3.14." msgstr "" #: ../../../changes.txt:46 16783112fa05425cb0e149b83c62e932 msgid "" "We now define all class methods explicitly instead of with dynamic " "assignment; this improves type hints." msgstr "" #: ../../../changes.txt:47 26f54231a095480aa0f42247a5a89ef4 msgid "Removed `pymupdf.utils.Shape` class, was duplicate of `pymupdf.Shape`." msgstr "" #: ../../../changes.txt:48 7ecda4cd98c54e6a9b9bf91163eff14b msgid "Allow use of cibuildwheel to build and test on Pyodide." msgstr "" #: ../../../changes.txt:49 93135916c58248c283baf01e7d053cd0 msgid "Fixed various Pyodide bugs." msgstr "" #: ../../../changes.txt:50 7ecc6290f1054757b942bc4fb105d1eb msgid "" "In documentation, added section about Linux wheels and glibc " "compatibility." msgstr "" #: ../../../changes.txt:51 92f2c3d79a944460985276d312eca3e4 msgid "Improved documentation of pymupdf.open()'s arg." msgstr "" #: ../../../changes.txt:52 562bb006d36840cdb5aadf8ddd466486 msgid "" "Retrospectively mark `4544 " "`_ as fixed in 1.26.4." msgstr "" #: ../../../changes.txt:55 b67d98ad96244427984fe137baacd5a1 msgid "**Changes in version 1.26.4 (2025-08-25)**" msgstr "" #: ../../../changes.txt:57 6d0728e9c0d245e69d0197ef60d55ff6 msgid "Use MuPDF-1.26.7." msgstr "" #: ../../../changes.txt:61 dae25b5e67ed40678841767ca82960df msgid "" "**Fixed** `3806 `_: pdf " "to image rendering ignore optional content offs" msgstr "" #: ../../../changes.txt:62 d27cf6acd0904ba3854fc86e793e1b0e msgid "" "**Fixed** `4388 `_: " "Incorrect PixMap from page due to cached data from other PDF" msgstr "" #: ../../../changes.txt:63 2485533a6f1c4ceeab94a3a74ea0040a msgid "" "**Fixed** `4457 `_: Wrong" " characters displayed after font subsetting (w/ native method)" msgstr "" #: ../../../changes.txt:64 ../../../changes.txt:89 #: 48034320908941b78280338d69474453 582145c0201942e4a97e4a6715f82496 msgid "" "**Fixed** `4462 `_: " "delete_pages() does not accept a single int" msgstr "" #: ../../../changes.txt:65 ee57c3dd80db447388f6e8ac0d049adb msgid "" "**Fixed** `4533 `_: Open " "PDF error segmentation fault" msgstr "" #: ../../../changes.txt:66 96cc9c5c43084b5e9cf0162eb38b2dbf msgid "" "**Fixed** `4544 `_: About" " pdf_clip_page" msgstr "" #: ../../../changes.txt:67 ed6dabd36ac34857a630542ffd191c57 msgid "" "**Fixed** `4565 `_: MacOS" " uses Tesseract and not Tesseract-OCR" msgstr "" #: ../../../changes.txt:68 fb88b0c8cbc84095bf2500c9a32f50ec msgid "" "**Fixed** `4571 `_: " "Broken merged pdfs." msgstr "" #: ../../../changes.txt:69 ef751fe8798b41eaaf64e166e23768fa msgid "" "**Fixed** `4590 `_: " "TypeError in utils.py scrub(): annot.update_file(buffer=...) is invalid" msgstr "" #: ../../../changes.txt:70 3b8c0e208f554eaebac0ea6abcd8b46d msgid "" "**Fixed** `4614 `_: " "Intercept bad widgets when inserting to another PDF" msgstr "" #: ../../../changes.txt:71 02cfdc76ab714494bf079b968391320e msgid "" "**Fixed** `4639 `_: " "pymupdf.mupdf.FzErrorGeneric: code=1: Director error: : 'JM_new_bbox_device_Device' object has no attribute " "'layer_name'" msgstr "" #: ../../../changes.txt:75 38712224dd5544e7a462aaeb1e2e304b msgid "" "Check that #4392 `Segfault when running with pytest and -Werror` is fixed" " if PyMuPDF is built with swig>=4.4." msgstr "" #: ../../../changes.txt:76 57972c515886453a932d8eac12c3b328 msgid "Add `Page.clip_to_rect()`." msgstr "" #: ../../../changes.txt:77 586a552aa4af4245b5e12d417ae1f42d msgid "Improved search for Tesseract data." msgstr "" #: ../../../changes.txt:78 9f280d1da9b04eedae2eb7fa58bf1973 msgid "Retrospectively mark #4496 as fixed in 1.26.1." msgstr "" #: ../../../changes.txt:79 3fde7874083c4911a6dd9d05ee3f3e7c msgid "Retrospectively mark #4503 as fixed in 1.26.3." msgstr "" #: ../../../changes.txt:80 e25d10cd0c8b485b998c07889f2c2b02 msgid "Added experimental support for Graal." msgstr "" #: ../../../changes.txt:83 a4c9e90997aa40e39b6e88a47283df1f msgid "**Changes in version 1.26.3 (2025-07-02)**" msgstr "" #: ../../../changes.txt:85 f2e0c9ebfbc8436a90fbc5210c2d61c5 msgid "Use MuPDF-1.26.3." msgstr "" #: ../../../changes.txt:90 88b28524dc38400e86ede8dfd69bda83 msgid "" "**Fixed** `4503 `_: " "Undetected character styles" msgstr "" #: ../../../changes.txt:91 82e1019dfacf4e889e4e2708d5c2ab67 msgid "" "**Fixed** `4527 `_: " "Rect.intersects() is much slower than necessary" msgstr "" #: ../../../changes.txt:92 3195a73537bc44b6be38e2643857a820 msgid "" "**Fixed** `4564 `_: " "Possible encoding issue in PDF metadata" msgstr "" #: ../../../changes.txt:93 ed811f813c204c15a71a72b02b3fc7f7 msgid "" "**Fixed** `4575 `_: Bug " "with IRect contains method" msgstr "" #: ../../../changes.txt:97 80940db1fc98463084fb0536e2a74c75 msgid "Class Shape is now available as pymupdf.Shape." msgstr "" #: ../../../changes.txt:98 8d3cbad84fc7406db910769a9e0c49cd msgid "Added table cell markdown support." msgstr "" #: ../../../changes.txt:101 979c685df84c433a99b2ce9a6192393e msgid "**Changes in version 1.26.2**" msgstr "" #: ../../../changes.txt:103 6253d76480234ecb99ef69856e2e4d7c msgid "[Skipped.]" msgstr "" #: ../../../changes.txt:106 696d62b448d042d7ac4c9ae344c9357e msgid "**Changes in version 1.26.1 (2025-06-11)**" msgstr "" #: ../../../changes.txt:108 97fd68cacc0d460ea6453d0f75969b06 msgid "Use MuPDF-1.26.2." msgstr "" #: ../../../changes.txt:112 f027534ba7294a6e8c8c22e759448323 msgid "" "**Fixed** `4520 `_: " "show_pdf_page does not like empty pages created by new_page" msgstr "" #: ../../../changes.txt:113 065f392247ae490ab226f1104d666ddc msgid "" "**Fixed** `4524 `_: " "fitz.get_text ignores 'pages' kwarg" msgstr "" #: ../../../changes.txt:114 ../../../changes.txt:137 #: 1c6997f9c6d7494ba9b55c63784e99cf c6a83f4370734e42a4528f25014f39ab msgid "" "**Fixed** `4412 `_: " "Regression? Spurious error? in insert_pdf in v1.25.4" msgstr "" #: ../../../changes.txt:115 bb0e76951378470a8d36dd42e908266d msgid "" "**Fixed** `4496 `_: " "pymupdf4llm with pymupdfpro" msgstr "" #: ../../../changes.txt:119 87089d7b25b9490a95ea7686681487c8 msgid "" "Partial fix for `4503 `_:" " Undetected character styles" msgstr "" #: ../../../changes.txt:120 ce6c18a243de4e81b72c53d4fefd499e msgid "" "New method `Document.rewrite_images()`, useful for reducing file size, " "changing image formats, or converting color spaces." msgstr "" #: ../../../changes.txt:121 0a3a89d09fd3461ca2a27fcca8f185ed msgid "`Page.get_text()`: restrict positional args to match docs." msgstr "" #: ../../../changes.txt:122 1a528cc8a62e43639f658f1f709590c9 msgid "Removed bogus definition of class `Shape`." msgstr "" #: ../../../changes.txt:123 552b40dd8819435dad4a76eae858df20 msgid "" "Removed release date from module, docs and changelog. * " "`pymupdf.pymupdf_date` and `pymupdf.VersionDate` are now both None. * " "They will be removed in a future release." msgstr "" #: ../../../changes.txt:128 158c863781294c5c93e9b0a8c8e1f847 msgid "**Changes in version 1.26.0 (2025-05-22)**" msgstr "" #: ../../../changes.txt:130 18567733eef64ab68965ed498958d670 msgid "Use MuPDF-1.26.1." msgstr "" #: ../../../changes.txt:134 4ea8e6ad2e414e978386c33aad8021d5 msgid "" "**Fixed** `4324 `_: " "cluster_drawings() fails to cluster horizontal and vertical thin lines" msgstr "" #: ../../../changes.txt:135 17554e87f7084cacb19d789d4694754f msgid "" "**Fixed** `4363 `_: " "Trouble with searching" msgstr "" #: ../../../changes.txt:136 2cb8333bfa3948d0a1e1df290b275159 msgid "" "**Fixed** `4404 `_: " "IndexError in page.get_links()" msgstr "" #: ../../../changes.txt:138 3fb86dc38b76431f8fa289ed24574576 msgid "" "**Fixed** `4423 `_: " "pymupdf.mupdf.FzErrorFormat: code=7: cannot find object in xref error " "encountered after version 1.25.3" msgstr "" #: ../../../changes.txt:139 e4d0ca8ddf164f08b449dac3a6fa04fa msgid "" "**Fixed** `4435 `_: " "get_pixmap method stuck on one page" msgstr "" #: ../../../changes.txt:140 73d115f25755496680f56c79674a6351 msgid "" "**Fixed** `4439 `_: New " "Xml class from data does not work - bug in code" msgstr "" #: ../../../changes.txt:141 b25d62127fea4feaa5d944e835c2a666 msgid "" "**Fixed** `4445 `_: " "Broken XREF table incorrectly repaired" msgstr "" #: ../../../changes.txt:142 a0a2ed6ac1354febb9da6afd02bc9b42 msgid "" "**Fixed** `4447 `_: " "Stroke color of annotations cannot be correctly set" msgstr "" #: ../../../changes.txt:143 616298c000ad48cdbc628ef4cdd172d8 msgid "" "**Fixed** `4479 `_: " "set_layer_ui_config() toggles all layers rather than just one" msgstr "" #: ../../../changes.txt:144 b15ec1ffa6f0419c8b5503c50587840c msgid "" "**Fixed** `4505 `_: " "Follow Widget flag values up its parent structure" msgstr "" #: ../../../changes.txt:148 7b7ea93f30ca49f88b45b05c08ecf10f msgid "" "Partial fixed for `4457 " "`_: Wrong characters " "displayed after font subsetting (w/ native method)" msgstr "" #: ../../../changes.txt:149 b0ae6f4b0bc24e12bd0071f22e599e11 msgid "Support image stamp annotations." msgstr "" #: ../../../changes.txt:150 f5f7682cfc6c4abba06ebd809edf0795 msgid "Support recoloring pages." msgstr "" #: ../../../changes.txt:151 01a95f3b08944431b06a9d2e99e50bdf msgid "" "Added example of using Django's file storage API to open files with " "pymupdf." msgstr "" #: ../../../changes.txt:152 1ea4d799a2714c90a3ad74a4f03f1ed8 msgid "" "Clarified FreeText annotation color options. We now raise an exception if" " an attempt is made to set attributes that can not be supported." msgstr "" #: ../../../changes.txt:154 856acd8f3343442bb8ee7254e8b8d062 msgid "Fixed potential segv in Pixmap.is_unicolor()." msgstr "" #: ../../../changes.txt:155 90dbf6ef976a4d76a799854a5aa774dc msgid "" "Added runtime assert that that PyMuPDF and MuPDF were built with " "compatible NDEBUG settings (related to `4390 " "`_)." msgstr "" #: ../../../changes.txt:157 0862256c36d142c48444aab07763f645 msgid "Simplified handling of filename/filetype when opening documents." msgstr "" #: ../../../changes.txt:158 5e85ed11581b46daaf1a09b8a22dcccb msgid "" "Removed PDF linearization support. * Calls to `Document.save()` with " "`linear` set to true will now raise an exception. * See " "https://artifex.com/blog/mupdf-removes-linearisation for more " "information." msgstr "" #: ../../../changes.txt:162 c7ce1a9bb27545978d6d1d9fed1a4524 msgid "**Changes in version 1.25.5 (2025-03-31)**" msgstr "" #: ../../../changes.txt:166 9548bbf70ba9469e8b935a45f29643ed msgid "" "**Fixed** `4372 `_: Text " "insertion fails due to missing /Resources object" msgstr "" #: ../../../changes.txt:167 f76e7622a9d7433db1b7b82bc7156145 msgid "" "**Fixed** `4400 `_: " "Infinite loop in fill_textbox" msgstr "" #: ../../../changes.txt:168 82f33cb8a6d34f62b854eca17a8c4254 msgid "" "**Fixed** `4403 `_: " "Unable to get_text() - layer/clip nesting too deep" msgstr "" #: ../../../changes.txt:169 84b7b13060424773820d4994525080dc msgid "" "**Fixed** `4415 `_: PDF " "page is mirrored, origin is at bottom-left" msgstr "" #: ../../../changes.txt:173 74a4792d6a8244eb9dcae4beb4bfe0ee msgid "Use MuPDF-1.25.6." msgstr "" #: ../../../changes.txt:174 d248e14b8c1a4e3fab6235c3cf5c614c msgid "Fixed MuPDF SEGV on MacOS with particular fonts." msgstr "" #: ../../../changes.txt:175 82ea9eb171144077a7870ae7a0b9eeb7 msgid "Fixed `Annot.get_textpage()`'s `clip` arg." msgstr "" #: ../../../changes.txt:176 2fccc9761609452e9d10dac746b11059 msgid "Fixed Python-3.14 (pre-release) build error." msgstr "" #: ../../../changes.txt:179 2fbd0061abcd475fafe6ef6a570e0d7a msgid "**Changes in version 1.25.4 (2025-03-14)**" msgstr "" #: ../../../changes.txt:181 9fa9e7eec7694807a4577e93e3fdb54e msgid "Use MuPDF-1.25.5." msgstr "" #: ../../../changes.txt:185 8f7a4be455684495af9c8e17de5ad09d msgid "" "**Fixed** `4079 `_: " "Unexpected result for apply_redactions()" msgstr "" #: ../../../changes.txt:186 6d876027b2104b01830654bbbae308e9 msgid "" "**Fixed** `4224 `_: MuPDF" " error: format error: negative code in 1d faxd" msgstr "" #: ../../../changes.txt:187 b7b89a62c35d4608987e21ec0f356173 msgid "" "**Fixed** `4303 `_: " "page.get_image_info() returns outdated cached results after replacing " "image" msgstr "" #: ../../../changes.txt:188 8b5c375bcfc24c81a1ab34fdfe2e3f87 msgid "" "**Fixed** `4309 `_: " "FzErrorFormat Error When Deleting First Page" msgstr "" #: ../../../changes.txt:189 33ebf7622662470e98f52b0e0681e4b1 msgid "" "**Fixed** `4336 `_: Major" " Performance Regression: pix.color_count is 150x slower in version 1.25.3" " compared to 1.23.8" msgstr "" #: ../../../changes.txt:190 159061230d824914a6d19ad6d73eeb7c msgid "" "**Fixed** `4341 `_: " "Invalid label retrieval when /Kids is an array of multiple /Nums" msgstr "" #: ../../../changes.txt:194 37e49743f93f41d9bf5880142941c864 msgid "Fixed handling of duplicate widget names when joining PDFs (PR #4347)." msgstr "" #: ../../../changes.txt:195 0cac0025172c4dd5baf122fc076da58e msgid "Improved Pyodide build." msgstr "" #: ../../../changes.txt:196 638ca0a27dd548cfa15a4095bd238671 msgid "" "Avoid SWIG-related build errors with Python-3.13 by disabling " "PY_LIMITED_API." msgstr "" #: ../../../changes.txt:199 24df824cc0ed4dcaa55266a462308f72 msgid "**Changes in version 1.25.3 (2025-02-06)**" msgstr "" #: ../../../changes.txt:201 86fbdb38e3ab475cb35bce8474a0517d msgid "Use MuPDF-1.25.4." msgstr "" #: ../../../changes.txt:205 11404e9f065f46d48c17de3eb0a56b4c msgid "" "**Fixed** `4139 `_: Text " "color numbers change between 1.24.14 and 1.25.0" msgstr "" #: ../../../changes.txt:206 f54ac127378c40efbea689f95f729a3d msgid "" "**Fixed** `4141 `_: Some " "insertion methods fails for pages without a /Resources object" msgstr "" #: ../../../changes.txt:207 1debce8303bb430aaf3c754c31d4e54a msgid "" "**Fixed** `4180 `_: " "Search problems" msgstr "" #: ../../../changes.txt:208 a43078709b894315ab60ab8c8077d919 msgid "" "**Fixed** `4182 `_: Text " "coordinate extraction error" msgstr "" #: ../../../changes.txt:209 2aa654ea699a4754864254e38097fcf4 msgid "" "**Fixed** `4245 `_: " "Highlighting issue distorted on recent versions" msgstr "" #: ../../../changes.txt:210 568c972326294ecab31a4378aee8aef3 msgid "" "**Fixed** `4254 `_: " "add_freetext_annot is drawing text outside the annotation box" msgstr "" #: ../../../changes.txt:214 3b1e13a8a53f41568994b6b10d784dd4 msgid "" "In annotations: * Added support for subtype FreeTextCallout. * Added " "support for rich text." msgstr "" #: ../../../changes.txt:217 20ad825019bc421aa9fa359d4c2cf2b9 msgid "" "Added miter_limit arg to insert_text*() to allow suppression of spikes " "caused by long miters." msgstr "" #: ../../../changes.txt:218 d8f3a5bd962d420482fbab442a82a337 msgid "Add Widget Support to `Document.insert_pdf()`." msgstr "" #: ../../../changes.txt:219 b25922bccda743b4a462eff61aa2da32 msgid "Add `bibi` to span dicts." msgstr "" #: ../../../changes.txt:220 16e4de5888954261941fe67d4f618949 msgid "Add `synthetic' to char dict." msgstr "" #: ../../../changes.txt:221 ../../../changes.txt:963 #: 2b958160bd134274b90ba5bd456e66c5 43a26b5aad0e4fe485acf6a41282f421 msgid "Fixed Pyodide builds." msgstr "" #: ../../../changes.txt:224 f65069a7584b4f128fa5b7cc86d526ab msgid "**Changes in version 1.25.2 (2025-01-17)**" msgstr "" #: ../../../changes.txt:228 af70ce0fc1a74152b86dbd49d309fdb9 msgid "" "**Fixed** `4055 `_: " "\"Yes\" for all checkboxes does not work for all PDF rendering engines." msgstr "" #: ../../../changes.txt:229 4410d36a900d450c97588b75ccb21628 msgid "" "**Fixed** `4155 `_: " "samples_mv is unsafe" msgstr "" #: ../../../changes.txt:230 61173d64746b46848303884ad4f7c6c2 msgid "" "**Fixed** `4162 `_: Got " "AttributeError, when tried to add Signature field" msgstr "" #: ../../../changes.txt:231 ade3c33dc1bc4fe5a6c9c79ad335b6ca msgid "" "**Fixed** `4186 `_: " "Incorrect handling of JPEG with color space CMYK image extraction" msgstr "" #: ../../../changes.txt:232 b0f948dd2aec4196879b796a7083ce66 msgid "" "**Fixed** `4195 `_: " "Pixmaps that are inverted and have an alpha channel are not rendered " "properly" msgstr "" #: ../../../changes.txt:233 f983aaf8e72b40329ef333edb032482d msgid "" "**Fixed** `4225 `_: " "pixmap.pil_save() fails due to colorspace definition" msgstr "" #: ../../../changes.txt:234 b9f784c7a8e347f0839af27a4aee0957 msgid "" "**Fixed** `4232 `_: " "Incorrect Font style and Size" msgstr "" #: ../../../changes.txt:238 46a2de9de8a84001a08386537fad1cb6 msgid "Use Python's built-in glyphname <> unicode conversion." msgstr "" #: ../../../changes.txt:239 98aaf3100ca44c3eb46b239c085990ce msgid "Improve speed of pixmap color inversion." msgstr "" #: ../../../changes.txt:240 761c1030615e4b9f8837990276cdd4aa msgid "" "Add new `char_flags` member to span dictionary, for example allows " "detection of invisible text." msgstr "" #: ../../../changes.txt:241 26863d989def4dd6b375f90f90ac816a msgid "Detect image masks in TextPage output." msgstr "" #: ../../../changes.txt:242 c106eb1531f34065ac0918f8967d868c msgid "Added `Pixmap.pil_image()`." msgstr "" #: ../../../changes.txt:245 f2917761f4f342b2b20eb583e456ac86 msgid "**Changes in version 1.25.1 (2024-12-11)**" msgstr "" #: ../../../changes.txt:247 5d2a2817fc15439e8cff5b48d2993934 msgid "Use MuPDF-1.25.2." msgstr "" #: ../../../changes.txt:251 1aa29c8b332c4f06b69b0f5c16618fed msgid "" "**Fixed** `4125 `_: " "memory leak while convert Pixmap's colorspace" msgstr "" #: ../../../changes.txt:252 6619cbba93b64266b96af9f2fb26333c msgid "" "**Fixed** `4034 `_: " "Possible regression in pdf cleaning during save." msgstr "" #: ../../../changes.txt:255 54ab8ad1ec3246298a9019b2227a46d8 msgid "**Changes in version 1.25.0 (2024-12-05)**" msgstr "" #: ../../../changes.txt:257 0a8714b7f18e45878f7b252f8af10ade msgid "Use MuPDF-1.25.1." msgstr "" #: ../../../changes.txt:261 686ebe75128d4be9b77bba0ddb563a43 msgid "" "**Fixed** `4026 `_: " "page.get_text('blocks') output two piece of very similar text with " "different bbox" msgstr "" #: ../../../changes.txt:262 efd9decd0d2a4a319ebd830a2c8531bd msgid "" "**Fixed** `4004 `_: " "Segmentation Fault When Updating PDF Form Field Value" msgstr "" #: ../../../changes.txt:263 ebdb384bd8e4477d80b10127b014145b msgid "" "**Fixed** `3887 `_: " "Subset Fonts problem using Fallback Font" msgstr "" #: ../../../changes.txt:264 e63e1845d9fb45198345afaff67f30e1 msgid "" "**Fixed** `3886 `_: " "Another issue with destroying PDF when inserting html" msgstr "" #: ../../../changes.txt:265 50adbcf9a18043e68b84aa9286698361 msgid "" "**Fixed** `3751 `_: " "apply_redactions causes part of the page content to be hidden / " "transparent" msgstr "" #: ../../../changes.txt:270 09e722df03fa4db18c4e0da832e997f7 msgid "**Changes in version 1.24.14 (2024-11-19)**" msgstr "" #: ../../../changes.txt:272 cb8ebd6072bd4e11919080375887f166 msgid "Use MuPDF-1.24.11." msgstr "" #: ../../../changes.txt:276 50b663786ee641cb9687580189342f8d msgid "" "**Fixed** `3448 `_: " "get_pixmap function removes the table and leaves just the content behind" msgstr "" #: ../../../changes.txt:277 54321b37a7f9420b8567fbb6d1e426a4 msgid "" "**Fixed** `3758 `_: Got " "\"malloc(): unaligned tcache chunk detected Aborted (core dumped)\" while" " using add_redact_annot/apply_redactions" msgstr "" #: ../../../changes.txt:278 296dc7d294134423a31f7b6d74f2aeaf msgid "" "**Fixed** `3813 `_: " "Stories: Ordered list count broken with nested unordered list" msgstr "" #: ../../../changes.txt:279 2215310351ca46c1a25a514468a905a8 msgid "" "**Fixed** `3933 `_: " "font.valid_codepoints() - malfunction" msgstr "" #: ../../../changes.txt:280 ff0631f5b7054df4b90b9fa8739b4ec1 msgid "" "**Fixed** `4018 `_: " "PyMuPDF hangs when iterating over zero page PDF pages backwards" msgstr "" #: ../../../changes.txt:281 a2a87af3e4c84a6abc63ea9d9e914391 msgid "" "**Fixed** `4043 `_: " "fullcopypage bug" msgstr "" #: ../../../changes.txt:282 55686d0fa4674d4299310ada01d1735d msgid "" "**Fixed** `4047 `_: " "Segmentation Fault in add_redact_annot" msgstr "" #: ../../../changes.txt:283 0c2e617044914d04b642de2fa1587abb msgid "" "**Fixed** `4050 `_: " "Content of dict returned by doc.embfile_info() does not fit to " "documentation" msgstr "" #: ../../../changes.txt:287 1bb6617fc61d474c946dbf47c807e5d8 msgid "" "Ensure that words from `Page.get_text()` never contain RTL/LTR char " "mixtures." msgstr "" #: ../../../changes.txt:288 2171b4b55a384da393be21b8cef7cd46 msgid "Fix building with system MuPDF." msgstr "" #: ../../../changes.txt:289 1b697fc68ecb486aa3b482711dd06c98 msgid "Add dot product for points and vectors." msgstr "" #: ../../../changes.txt:292 b3aa2aa2bfbc4c9ba5c5d2c84a823910 msgid "**Changes in version 1.24.13 (2024-10-29)**" msgstr "" #: ../../../changes.txt:296 532324021bbe48718cffa19ecedb034c msgid "" "**Fixed** `3848 `_: " "Piximap program crash" msgstr "" #: ../../../changes.txt:297 ../../../changes.txt:308 #: 2387d394753a42ad872fa2268d7e9a29 cb2a797b491348f58ab3ce4ba98b73d9 msgid "" "**Fixed** `3950 `_: " "Unable to consistently extract field labels from PDFs" msgstr "" #: ../../../changes.txt:298 51536c1106ea45ac9444978b1684c0c1 msgid "" "**Fixed** `3981 `_: " "PyMuPDF 1.24.12 with pyinstaller throws error." msgstr "" #: ../../../changes.txt:299 f44e8a92c6004f9f8c5c59b80ddbf558 msgid "" "**Fixed** `3994 `_: " "pix.color_topusage raise Segmentation fault (core dumped)" msgstr "" #: ../../../changes.txt:302 6bd1fa6f738340babc3df986bdc5a0a5 msgid "**Changes in version 1.24.12 (2024-10-21)**" msgstr "" #: ../../../changes.txt:306 5174733bb6794f2b8c431f53170d0267 msgid "" "**Fixed** `3914 `_: " "Ability to print MuPDF errors to logging instead of stdout" msgstr "" #: ../../../changes.txt:307 78495d3820584622819a2d243eabe922 msgid "" "**Fixed** `3916 `_: " "insert_htmlbox error: int too large to convert to float" msgstr "" #: ../../../changes.txt:310 dc5a73b307bb45128375b3e45f21f804 msgid "Supported Python versions are now 3.9-3.13." msgstr "" #: ../../../changes.txt:312 7fa696ad2ff84d4fb6204d9eeaa72eec msgid "Dropped support for Python-3.8 because end-of-life." msgstr "" #: ../../../changes.txt:313 2be21c1bbf164eb88dd5059514d52c40 msgid "Added support for Python-3.13 because now released." msgstr "" #: ../../../changes.txt:314 a07d59ffaf6a48c8827e65b703ee0856 msgid "See: https://devguide.python.org/versions/" msgstr "" #: ../../../changes.txt:317 d5600d2cd45b4009ba4eb42289cee550 msgid "**Changes in version 1.24.11 (2024-10-03)**" msgstr "" #: ../../../changes.txt:319 9d700953907b44fe86d10f2023bda708 msgid "Use MuPDF-1.24.10." msgstr "" #: ../../../changes.txt:323 808cd9169aeb4de68aaf51afd0fbff17 msgid "" "**Fixed** `3624 `_: Pdf " "file transform to image have a black block" msgstr "" #: ../../../changes.txt:324 8f414ff010194b2abb249bd69290b7a1 msgid "" "**Fixed** `3859 `_: " "doc.need_appearances() fails with \"AttributeError: module " "'pymupdf.mupdf' has no attribute 'PDF_TRUE' \"" msgstr "" #: ../../../changes.txt:325 144003ab4e5743f1a5a6728e0d572424 msgid "" "**Fixed** `3863 `_: " "apply_redactions() does not work as expected" msgstr "" #: ../../../changes.txt:326 dd7478f2b06449c48d6b3c1bda073aa9 msgid "" "**Fixed** `3905 `_: open " "stream can raise a FzErrorFormat error instead of FileDataError" msgstr "" #: ../../../changes.txt:328 bf8693cc8c1349408cbd9fc992ea196e msgid "Wheels now use the Python Stable ABI:" msgstr "" #: ../../../changes.txt:330 efc06a4c0fd84a09a008423f67eee13e msgid "There is one PyMuPDF wheel for each platform." msgstr "" #: ../../../changes.txt:331 4c8dea397efc48d68f2a64b021c76ed0 msgid "Each wheel works with all supported Python versions." msgstr "" #: ../../../changes.txt:332 1c41329749a64d22b3f9e3b61036f38c msgid "" "Each wheel is built using the oldest supported Python version (currently " "3.8)." msgstr "" #: ../../../changes.txt:333 2e864bd74a2f4ef98e175a1e44fec4df msgid "There is no PyMuPDFb wheel." msgstr "" #: ../../../changes.txt:337 aa491896b5e04bd582e529c840ead400 msgid "Improvements to get_text_words() with sort=True." msgstr "" #: ../../../changes.txt:338 283df97df8874c3fa38c6c9a57f6af06 msgid "Tests now always get the latest versions of required Python packages." msgstr "" #: ../../../changes.txt:339 f6a1523241f54a9ba84dfed4f6dde3b2 msgid "Removed dependency on setuptools." msgstr "" #: ../../../changes.txt:340 1596796af81b476e80835455e0a27a29 msgid "Added item to PyMuPDF-1.24.10 changes below - fix of #3630." msgstr "" #: ../../../changes.txt:343 0d1ea2fa95e1430a91731b5c309c154f msgid "**Changes in version 1.24.10 (2024-09-02)**" msgstr "" #: ../../../changes.txt:345 0fdb57593f1f47f78b61e459d90c4fd0 msgid "Use MuPDF-1.24.9." msgstr "" #: ../../../changes.txt:349 4c1b818189074d939767d48fa6ba40e6 msgid "" "**Fixed** `3450 `_: " "get_pixmap function takes too long to process" msgstr "" #: ../../../changes.txt:350 03bc289e1528407b8433671ea3e5587e msgid "" "**Fixed** `3569 `_: " "Invalid OCGs not ignored by SVG image creation" msgstr "" #: ../../../changes.txt:351 3e64094a0a16437ab1fceb4fd8904883 msgid "" "**Fixed** `3603 `_: " "ObjStm compression and PDF linearization doesn't work together" msgstr "" #: ../../../changes.txt:352 4a6c4d95199b49919c2ec7b76da32a3a msgid "" "**Fixed** `3650 `_: " "Linebreak inserted between each letter" msgstr "" #: ../../../changes.txt:353 a5fb10f857014368871b0ee0628a1ef1 msgid "" "**Fixed** `3661 `_: " "Update Document to check the /XYZ len" msgstr "" #: ../../../changes.txt:354 77892cd87ca346d381b0b249574312b4 msgid "" "**Fixed** `3698 `_: " "documentation issue - old code in the annotations documentation" msgstr "" #: ../../../changes.txt:355 8a4df3770f95440c870288e5f497cf93 msgid "" "**Fixed** `3705 `_: " "Document.select() behaves weirdly in some particular kind of pdf files" msgstr "" #: ../../../changes.txt:356 575c721454394ef5954021b2e3910c5a msgid "" "**Fixed** `3706 `_: " "extend Document.__getitem__ type annotation to reflect that the method " "also accepts slices" msgstr "" #: ../../../changes.txt:357 b4081c4845a3495cab35195cfcbd4e5f msgid "" "**Fixed** `3727 `_: " "Method get_pixmap() make the program exit without any exceptions or " "messages" msgstr "" #: ../../../changes.txt:358 4a582d7cc3ca40cfba3314faa5800f56 msgid "" "**Fixed** `3767 `_: " "Cannot get Tessdata with Tesseract-OCR 5" msgstr "" #: ../../../changes.txt:359 9a3c4b91a07e4c118de884a8c386dcfb msgid "" "**Fixed** `3773 `_: " "Link.set_border gives TypeError: '<' not supported between instances of " "'NoneType' and 'int'" msgstr "" #: ../../../changes.txt:360 d3028f61318447b68e56290fbd6732cc msgid "" "**Fixed** `3774 `_: " "fitz.__version__` does not work anymore" msgstr "" #: ../../../changes.txt:361 596c2f50505948db9e84f139ffaea8fa msgid "" "**Fixed** `3789 `_: " "ValueError: not enough values to unpack (expected 3, got 2) is thrown " "when call insert_pdf" msgstr "" #: ../../../changes.txt:362 e99c3b3c69d1484f8ea0b97279da22e4 msgid "" "**Fixed** `3820 `_: class" " improves namedDest handling" msgstr "" #: ../../../changes.txt:364 9c63afe342914710a2f4b27172881a97 msgid "" "**Fixed** `3630 `_: " "page.apply_redactions gives unwanted black rectangle" msgstr "" #: ../../../changes.txt:368 a69ca8bf39fc49c78509e477fc16ec48 msgid "" "Object streams and linearization cannot be used together; attempting to " "do so will raise an exception. (#3603)" msgstr "" #: ../../../changes.txt:370 d667244f9aa14f1d8b25176a013989e0 msgid "Fixed handling of non-existing /Contents object." msgstr "" #: ../../../changes.txt:373 007020c8bc19452da4cd657fdcba20c0 msgid "**Changes in version 1.24.9 (2024-07-24)**" msgstr "" #: ../../../changes.txt:375 3025163fadb648e88e840b5f088e6d56 msgid "Use MuPDF-1.24.8." msgstr "" #: ../../../changes.txt:378 259a038beea8413baaac6ee36c977d21 msgid "**Changes in version 1.24.8 (2024-07-22)**" msgstr "" #: ../../../changes.txt:382 a3d2403d008e4902bda8c294e7d5b193 msgid "" "**Fixed** `3636 `_: API " "documentation for the open function is not obvious to find." msgstr "" #: ../../../changes.txt:383 eb0f33456dca477bb49123d26150dbd5 msgid "" "**Fixed** `3654 `_: docx " "parsing was broken in 1.24.7" msgstr "" #: ../../../changes.txt:384 6c8df8e668094aef8d31035e9dc0e65d msgid "" "**Fixed** `3677 `_: " "Unable to extract subset font name using the newer versions of PyMuPDF : " "1.24.6 and 1.24.7." msgstr "" #: ../../../changes.txt:385 c5b0babed39f440d99efdd7a90d63f4b msgid "" "**Fixed** `3687 `_: " "Page.get_text results in AssertionError for epub files" msgstr "" #: ../../../changes.txt:389 e245fedf7bb24e8d92d8116cb00ad30e msgid "Fixed various spelling mistakes spotted by codespell." msgstr "" #: ../../../changes.txt:390 764d9b752f59499e856f560908cee6d9 msgid "Improved how we modify MuPDF's default configuration on Windows." msgstr "" #: ../../../changes.txt:391 6e8cb04f867c4ad59e8be783e217fc4d msgid "Make text search to work with ligatures." msgstr "" #: ../../../changes.txt:394 25efadfa996341b38552789392dbaf74 msgid "**Changes in version 1.24.7 (2024-06-26)**" msgstr "" #: ../../../changes.txt:398 fa9eea5710484750bedce90cc64b9daf msgid "" "**Fixed** `3615 `_: " "Document.pagemode or Document.pagelayout crashes for epub files" msgstr "" #: ../../../changes.txt:399 795aad875dfc458eb4a6c99bccde0cec msgid "" "**Fixed** `3616 `_: not " "last version reported" msgstr "" #: ../../../changes.txt:402 b75b54baeb764ed5bfca7d9290d654f6 msgid "**Changes in version 1.24.6 (2024-06-25)**" msgstr "" #: ../../../changes.txt:404 ce8d669017974969859f4cf2c64c5c09 msgid "Use MuPDF-1.24.4" msgstr "" #: ../../../changes.txt:408 f726a1ab74364bca9e9f707167e9d0af msgid "" "**Fixed** `3599 `_: " "Story.fit_width() has a weird line" msgstr "" #: ../../../changes.txt:409 8e99b98271ea423bb26bb068ec39ea52 msgid "" "**Fixed** `3594 `_: " "Garbled extraction for Amazon Sustainability Report" msgstr "" #: ../../../changes.txt:410 651a15f12d5043b6b328618180353f68 msgid "" "**Fixed** `3591 `_: " "'width' in Page.get_drawings() returns width equal as 0" msgstr "" #: ../../../changes.txt:411 02fe36631c264c87895576864dc44e43 msgid "" "**Fixed** `3561 `_: " "ZeroDivisionError: float division by zero with page.apply_redactions()" msgstr "" #: ../../../changes.txt:412 99db39151ed74f9d97810a41633d73e2 msgid "" "**Fixed** `3559 `_: " "SegFault 11 when empty H1 H2 H3 H4 etc element is used in insert_htmlbox" msgstr "" #: ../../../changes.txt:413 5e95ed936be0415c95c278cf1d1a9999 msgid "" "**Fixed** `3539 `_: Add " "dotted gridline detection to table recognition" msgstr "" #: ../../../changes.txt:414 75ffb0d518004dc2a74244b12b6c97bd msgid "" "**Fixed** `3519 `_: " "get_toc(simple=False) AttributeError: 'Outline' object has no attribute " "'rect'" msgstr "" #: ../../../changes.txt:415 495d1b01dfb7457ebb231eca62c7c539 msgid "" "**Fixed** `3510 `_: " "page.get_label() gets wrong label on the first page of doc" msgstr "" #: ../../../changes.txt:416 60f43a90ceb845b2adf2947634af64ac msgid "" "**Fixed** `3494 `_: " "1.24.2/1.24.3: spurious characters introduced when using subset_fonts and" " insert_pdf" msgstr "" #: ../../../changes.txt:417 a4e0010c0d8f45beaae70809abc81039 msgid "" "**Fixed** `3470 `_: " "subset_fonts error exit without exception/warning" msgstr "" #: ../../../changes.txt:418 99fd9bbe5dba43aa9c040b3a77aee77c msgid "" "**Fixed** `3400 `_: " "set_toc alters link coordinates for some rotated pages on pymupdf 1.24.2" msgstr "" #: ../../../changes.txt:419 82687af929194a6dbf9c19ea545b5e0b msgid "" "**Fixed** `3347 `_: " "Incorrect links to points on pages having different heights" msgstr "" #: ../../../changes.txt:420 340ce003832a4bf4a832ae0623c2ac19 msgid "" "**Fixed** `3237 `_: " "Set_metadata() does not work" msgstr "" #: ../../../changes.txt:421 ce983433667f4f27a675ad0f4ab90de8 msgid "" "**Fixed** `3493 `_: " "Isolate PyMuPDF from other libraries; issues when PyMuPDF is loaded with " "other libraries like GdkPixbuf" msgstr "" #: ../../../changes.txt:425 85db5876f5884fdb94a243fa8cea3bb5 msgid "" "Fixed concurrent use of PyMuPDF caused by use of constant temporary " "filenames." msgstr "" #: ../../../changes.txt:427 7bc8d5be62d24850bd1a2d0b042c5dc7 msgid "Add musllinux x86_64 wheels to release." msgstr "" #: ../../../changes.txt:429 8442053275014be3a2961c23d5c1e875 msgid "Added clearer version information:" msgstr "" #: ../../../changes.txt:431 898d54fe7f294059a365ce4df283fa8e msgid "`pymupdf.pymupdf_version`." msgstr "" #: ../../../changes.txt:432 e17b0b91f04f41c49b685ec88163c914 msgid "`pymupdf.mupdf_version`." msgstr "" #: ../../../changes.txt:433 b2b4d699826c44f3b82cbbffd7b8134e msgid "`pymupdf.pymupdf_date`." msgstr "" #: ../../../changes.txt:436 0641d353405748829b979a38171a2825 msgid "**Changes in version 1.24.5 (2024-05-30)**" msgstr "" #: ../../../changes.txt:440 d9b804a172e24fa782e586380589a791 msgid "" "**Fixed** `3479 `_: " "regression: fill_textbox: IndexError: pop from empty list" msgstr "" #: ../../../changes.txt:441 d00ec180a30548e7bd1094a5ff22289b msgid "" "**Fixed** `3488 `_: " "set_toc method error" msgstr "" #: ../../../changes.txt:445 53a42d7778c84e85ab793f4fc54ce4e8 msgid "Some more fixes to use MuPDF floating formatting." msgstr "" #: ../../../changes.txt:446 8feda6eedae84994a727c20e7a2336be msgid "Removed/disabled some unnecessary diagnostics." msgstr "" #: ../../../changes.txt:447 e96bd409e11d432aa398f8aeedd58c7a msgid "Fixed utils.do_links() crash." msgstr "" #: ../../../changes.txt:448 24e4d4aed05840ea9abe1c2c2805be34 msgid "" "Experimental new functions `pymupdf.apply_pages()` and " "`pymupdf.get_text()`." msgstr "" #: ../../../changes.txt:449 b8a6f1cfb64748d79bc0b69465631b51 msgid "Addresses wrong label generation for label styles \"a\" and \"A\"." msgstr "" #: ../../../changes.txt:452 0ba74ae644a1428d89fe14ef6b0babee msgid "**Changes in version 1.24.4 (2024-05-16)**" msgstr "" #: ../../../changes.txt:454 8347374b5a5e45b28a7f8f4afb292726 msgid "" "**Fixed** `3418 `_: Re-" "introduced bug, text align add_redact_annot" msgstr "" #: ../../../changes.txt:455 cb6d95a9123f4086b6ac158e88717571 msgid "" "**Fixed** `3472 `_: " "insert_pdf gives SystemError" msgstr "" #: ../../../changes.txt:459 c0361428884345bf8531a84f4780ea38 msgid "" "Fixed sysinstall test failing to remove all of prior installation before " "new install." msgstr "" #: ../../../changes.txt:461 5889a769a9d6497db5651e5de06b452c msgid "Fixed `utils.do_links()` crash." msgstr "" #: ../../../changes.txt:462 18689db9f7b34a0aada6aabae6348c36 msgid "Correct `TextPage` creation Code." msgstr "" #: ../../../changes.txt:463 47ec7c100c6c4cb89c0c9032e653d85d msgid "Unified various diagnostics." msgstr "" #: ../../../changes.txt:464 0ad11e95e8244ebab3b4e28a268c3b58 msgid "Fix bug in `page_merge()`." msgstr "" #: ../../../changes.txt:467 b8f39f2e163741529a0c07525b38ee4e msgid "**Changes in version 1.24.3 (2024-05-09)**" msgstr "" #: ../../../changes.txt:470 cad11f9fca1541eda51c5b1ddc360907 msgid "" "The Python module is now called `pymupdf`. `fitz` is still supported for " "backwards compatibility." msgstr "" #: ../../../changes.txt:473 26ab1d955ad94d82a842066be61b2b45 msgid "Use MuPDF-1.24.2." msgstr "" #: ../../../changes.txt:477 d78b4e742a1540d795b9023df668616a msgid "" "**Fixed** `3357 `_: " "PyMuPDF==1.24.0 will hanging when using page.get_text(\"text\")" msgstr "" #: ../../../changes.txt:478 d3a781ba5c1b4e4ea729e32165591767 msgid "" "**Fixed** `3376 `_: " "Redacting results are not as expected in 1.24.x." msgstr "" #: ../../../changes.txt:479 9d45832a290b4dec88aff88537dbbde6 msgid "" "**Fixed** `3379 `_: " "Documentation mismatch for get_text_blocks return value order." msgstr "" #: ../../../changes.txt:480 fb62ce84c5d24c1b802be0a91c9592fc msgid "" "**Fixed** `3381 `_: " "Contents stream contains floats in scientific notation" msgstr "" #: ../../../changes.txt:481 0862ddcf8e644d3ea7ac0a7c60de28d1 msgid "" "**Fixed** `3402 `_: " "Cannot add Widgets containing inter-field-calculation JavaScript" msgstr "" #: ../../../changes.txt:482 3d4f814eb5ec4e72a5adea1bd245b32f msgid "" "**Fixed** `3414 `_: " "missing attribute set_dpi()" msgstr "" #: ../../../changes.txt:483 cdcbe4b8d58544f0948c1b3c28f9b3d9 msgid "" "**Fixed** `3430 `_: " "page.get_text() cause process freeze with certain pdf on v1.24.2" msgstr "" #: ../../../changes.txt:487 ../../../changes.txt:509 #: 1034de3f71fc4bd187b3f046c83bedbe 8863ca296ccc4716b6f80e99291be2e5 msgid "New/modified methods:" msgstr "" #: ../../../changes.txt:489 8cea70e9366142759f75487402e703b3 msgid "" "`Page.remove_rotation()`: new, set page rotation to zero while keeping " "appearance." msgstr "" #: ../../../changes.txt:491 f1014ad8f9ec4d87968c7de24b7e7f70 msgid "Fixed some problems when checking for PDF properties." msgstr "" #: ../../../changes.txt:492 64cfa246e9094b0ebd62758e2eb3598f msgid "" "Fixed pip builds from sdist (see discussion `3360 " "`_: Alpine linux " "docker build failing \"No matching distribution found for " "pymupdfb==1.24.1\")." msgstr "" #: ../../../changes.txt:497 f8ef0c76081a402dbac0efa8b7644241 msgid "**Changes in version 1.24.2 (2024-04-17)**" msgstr "" #: ../../../changes.txt:499 bf95d9b1e5994a2091c8f66685f22854 msgid "" "Removed obsolete classic implementation from releases (previously " "available as module `fitz_old`)." msgstr "" #: ../../../changes.txt:504 4a87d3564d3d4cedae93e2b51349aaa2 msgid "" "**Fixed** `3331 `_: " "Document.pages() is incorrectly type-hinted" msgstr "" #: ../../../changes.txt:505 84e9e429e5af4263a7fd5db405b5842a msgid "" "**Fixed** `3354 `_: " "PyMuPDF==1.24.1: AttributeError: property 'metadata' of 'Document' object" " has no setter" msgstr "" #: ../../../changes.txt:511 818e26cf4c0f4ce08f1bf68e48eab8b0 msgid "`Document.bake()`: new, make annotations / fields permanent content." msgstr "" #: ../../../changes.txt:512 6a0b794fe12f4bb4a005a8f1bdc5c188 msgid "" "`Page.cluster_drawings()`: new, identifies drawing items (i.e. vector " "graphics or line-art) that belong together based on their geometrical " "vicinity." msgstr "" #: ../../../changes.txt:515 f1fb556a239a49e6b90a938b0360868a msgid "`Page.apply_redactions()`: added new parameter `text`." msgstr "" #: ../../../changes.txt:516 c47d84ec4dd34a6687719bcfafebdb25 msgid "" "`Document.subset_fonts()`: use MuPDF's `pdf_subset_fonts()` instead of " "PyMuPDF code." msgstr "" #: ../../../changes.txt:518 b56ff5e11e894337b35ae03c405c4666 msgid "The `Document` class now supports page numbers specified as slices." msgstr "" #: ../../../changes.txt:519 68a2d9fa6804400dbecc0e1d60d85280 msgid "Avoid causing MuPDF warnings." msgstr "" #: ../../../changes.txt:522 167f53146b304aaf9812103ca9c4e29c msgid "**Changes in version 1.24.1 (2024-04-02)**" msgstr "" #: ../../../changes.txt:526 9dcf0965da0a489cabf3d2ab88226762 msgid "" "**Fixed** `3278 `_: " "apply_redactions moves some unredacted text" msgstr "" #: ../../../changes.txt:527 c23c377d35194a0094bd6e4beab89d9d msgid "" "**Fixed** `3301 `_: Be " "more permissive when classifying links as kind LINK_URI" msgstr "" #: ../../../changes.txt:528 c6e16db559364535a9c002bd61adb627 msgid "" "**Fixed** `3306 `_: Text " "containing capital 'ET' not appearing as annotation" msgstr "" #: ../../../changes.txt:532 ae65e5dcbdbb47e7b6182ae2f1e35080 msgid "Use MuPDF-1.24.1." msgstr "" #: ../../../changes.txt:533 606e5f2a82694796b16017c9e6988751 msgid "" "Support ObjStm Compression. Methods `Document.save()`, " "`Document.ez_save()` and `Document.write()` now support new parameters " "`use_objstm`, compression_effort` and `preserve_metadata`." msgstr "" #: ../../../changes.txt:539 e0d826430dab4605843b857d55556f31 msgid "**Changes in version 1.24.0 (2024-03-21)**" msgstr "" #: ../../../changes.txt:543 56ae3cb3eae74794bf8c66f9478e1eaa msgid "" "**Fixed** `3281 `_: " "Preparing metadata (pyproject.toml) did not run successfully" msgstr "" #: ../../../changes.txt:544 c2af0005171741dfa062c48305fdff68 msgid "" "**Fixed** `3279 `_: " "PyMuPDF no longer builds in Alpine Linux" msgstr "" #: ../../../changes.txt:545 d9b6c05ed6004aca8f3189adad180c42 msgid "" "**Fixed** `3257 `_: " "apply_redactions() deleting text outside of annotated box" msgstr "" #: ../../../changes.txt:546 8baeb884a8f84d2fbf0d5b17af55639c msgid "" "**Fixed** `3216 `_: " "AttributeError: 'Annot' object has no attribute '__del__'" msgstr "" #: ../../../changes.txt:547 37068b47c21542ccbcc5d6326e7046f1 msgid "" "**Fixed** `3207 `_: " "get_drawings's items is missing line from h path operator" msgstr "" #: ../../../changes.txt:548 a4e36666ffbc4aca8006de811d305b60 msgid "" "**Fixed** `3201 `_: " "Memory leaks when merging PDFs" msgstr "" #: ../../../changes.txt:549 72cdc09b51ef425ab50c8aae8a380ce6 msgid "" "**Fixed** `3197 `_: " "page.get_text() returns hexadecimal text for some characters" msgstr "" #: ../../../changes.txt:550 055ea678a07b4991b05894009ada4484 msgid "" "**Fixed** `3196 `_: " "Remove text not working in 1.23.25 version vs 1.20.2" msgstr "" #: ../../../changes.txt:551 eebdd0d853a04d7890db0116aeda3b84 msgid "" "**Fixed** `3172 `_: PDF's" " 45º lines disappearing in png conversion" msgstr "" #: ../../../changes.txt:552 fd48b5fe2cf74dbb8772e3ffda26cc5b msgid "" "**Fixed** `3135 `_: Do " "not log warnings to stdout" msgstr "" #: ../../../changes.txt:553 5a2c034748ca435d97157e0e01631edc msgid "" "**Fixed** `3125 `_: " "get_pixmap method stuck on one page and runs forever" msgstr "" #: ../../../changes.txt:554 2b0bc004e652473d8424fbaf44acc132 msgid "" "**Fixed** `2964 `_: There" " is an issue with the image generated by the page.get_pixmap() function" msgstr "" #: ../../../changes.txt:558 7489ffec843d457ca500cfb476753615 msgid "Use MuPDF-1.24.0." msgstr "" #: ../../../changes.txt:559 7c55068e2bc44f7a90942db48624c211 msgid "Add support for redacting vector graphics." msgstr "" #: ../../../changes.txt:560 994636840ff242bb90c2538f8b313764 msgid "Several fixes for table module" msgstr "" #: ../../../changes.txt:562 1cde4b0108a34c66bcf26a1e69169d92 msgid "Add new method for outputting the table as a markdown string." msgstr "" #: ../../../changes.txt:564 9fcf8beb4cbf4808b3636964252fb397 msgid "Address errors in computing the table header object:" msgstr "" #: ../../../changes.txt:566 466f446d303f45039a8d621fa72be582 msgid "" "We now allow None as the cell value, because this will be resolved where " "needed (e.g. in the pandas DataFrame)." msgstr "" #: ../../../changes.txt:569 b1456724d60f446b99497879dec77edc msgid "" "We previously tried to enforce rect-like tuples in all header cell " "bboxes, however this fails for tables with all-None columns. This fix " "enables this and constructs an empty string in the corresponding cell " "string." msgstr "" #: ../../../changes.txt:574 bd966cd782ae48e6bf574d6aa1e75969 msgid "" "We now correctly include start / stop points of lines in the bbox of the " "clustered graphic. We previously joined the line's rectangle - which had" " no effect because this is always empty." msgstr "" #: ../../../changes.txt:578 8b34024dc26b46d6bb00721aee57b203 msgid "Improved exception text if we fail to open document." msgstr "" #: ../../../changes.txt:579 2ad46d306493434ba2f21cbc55598c4e msgid "Fixed build with new libclang 18." msgstr "" #: ../../../changes.txt:582 e0f45c4d68334077bde30abcb37f442c msgid "**Changes in version 1.23.26 (2024-02-29)**" msgstr "" #: ../../../changes.txt:586 2f2ec05926254e2f9d6790002f8f0dbb msgid "" "**Fixed** `3199 `_: Add " "entry_points to setuptools configuration to provide command-line console " "scripts" msgstr "" #: ../../../changes.txt:587 254166b6829a47ebae52f0d1befd4f8c msgid "" "**Fixed** `3209 `_: Empty" " vertices in ink annotation" msgstr "" #: ../../../changes.txt:591 72a0f38fcb3f4fadae2a9750a83ecf70 msgid "Improvements to table detection:" msgstr "" #: ../../../changes.txt:593 70ae893cd45741a59c2a753e1efe9d04 msgid "" "Improved check for empty tables, fixes bugs when determining table " "headers." msgstr "" #: ../../../changes.txt:594 db5ad6c22fa8479fb66f6ada59044c7e msgid "Improved computation of enveloping vector graphic rectangles." msgstr "" #: ../../../changes.txt:595 7f5ea75a3d2b47809b85588c78b70318 msgid "Ignore more meaningless \"pseudo\" tables" msgstr "" #: ../../../changes.txt:597 6cd939d409f341f6a264ff3b4624cca6 msgid "Install command-line 'pymupdf' command that runs fitz/__main__.py." msgstr "" #: ../../../changes.txt:598 6afb7824085740ccaf2fc01c782dffcb msgid "Don't overwrite MuPDF's config.h when building on non-Windows." msgstr "" #: ../../../changes.txt:599 86e24a39bb0541a4ac1e71e88541c698 msgid "" "Fix `Story` constructor's `archive` arg to match docs - now accepts a " "single `Archive` constructor arg." msgstr "" #: ../../../changes.txt:600 a3ea96e9f72f483bbf461ca1d128b1e4 msgid "" "Do not include MuPDF source in sdist; will be downloaded automatically " "when building." msgstr "" #: ../../../changes.txt:603 b80b43ad742c43ab9880dd54056a9973 msgid "**Changes in version 1.23.25 (2024-02-20)**" msgstr "" #: ../../../changes.txt:607 ea65b6e10b4443fd98d4487f8a6227ce msgid "" "**Fixed** `3182 `_: " "Pixmap.invert_irect argument type error" msgstr "" #: ../../../changes.txt:608 420d27a70b34444aba118e43db9e4802 msgid "" "**Fixed** `3186 `_: " "extractText() extracts broken text from pdf" msgstr "" #: ../../../changes.txt:609 90aadcf4b788454abbf2665a0b7b8f22 msgid "" "**Fixed** `3191 `_: Error" " on .find_tables()" msgstr "" #: ../../../changes.txt:613 0a5a831494a04b18b50fdfc5d3833038 msgid "" "When building, be able to specify python-config directly, with " "environment variable `PIPCL_PYTHON_CONFIG`." msgstr "" #: ../../../changes.txt:617 93b9bfcd66aa426eaacb92d54e23c667 msgid "**Changes in version 1.23.24 (2024-02-19)**" msgstr "" #: ../../../changes.txt:621 3748e8d370624cd1889b240a694cc72e msgid "" "**Fixed** `3148 `_: Table" " extraction - vertical text not handled correctly" msgstr "" #: ../../../changes.txt:622 0017cea29f1247be99c102c56a8fabd1 msgid "" "**Fixed** `3179 `_: Table" " Detection: Incorrect Separation of Vector Graphics Clusters" msgstr "" #: ../../../changes.txt:623 dde9c50cb60147428936ac9e5bdacc81 msgid "" "**Fixed** `3180 `_: " "Cannot show optional content group: AttributeError: module 'fitz.mupdf' " "has no attribute 'pdf_array_push_drop'" msgstr "" #: ../../../changes.txt:627 838816f12e394f49b9e2ef7b4559fd71 msgid "Be able to test system install using `sudo pip install` instead of a venv." msgstr "" #: ../../../changes.txt:630 0b4ca8027622493090312b1e74a4839a msgid "**Changes in version 1.23.23 (2024-02-18)**" msgstr "" #: ../../../changes.txt:634 5c5c4b53219b4e8492fec8aafaa14b7e msgid "" "**Fixed** `3126 `_: " "Initialising Archive with a pathlib.Path fails." msgstr "" #: ../../../changes.txt:635 e5745b8508084965a56f4151794f8378 msgid "" "**Fixed** `3131 `_: " "Calling the next attribute of an Annot raises a \"No attribute .parent\" " "warning" msgstr "" #: ../../../changes.txt:636 59d2c178ba9c4d47977704a9feccc1ea msgid "" "**Fixed** `3134 `_: Using" " an IRect as clip parameter in Page.get_pixmap no longer works since " "1.23.9" msgstr "" #: ../../../changes.txt:637 43be27e8f82c45ef90522a9da30a0a72 msgid "" "**Fixed** `3140 `_: PDF " "document stays in use after closing" msgstr "" #: ../../../changes.txt:638 cbe3a25490474db9973829ac9e661e5b msgid "" "**Fixed** `3150 `_: " "doc.select() hangs on this doc." msgstr "" #: ../../../changes.txt:639 b40c96dbbba64f6f82a0dbc3fb5570db msgid "" "**Fixed** `3163 `_: " "AssertionError on using fitz.IRect" msgstr "" #: ../../../changes.txt:640 5b0e909d8b1c42c4815f57178c08f1d0 msgid "" "**Fixed** `3177 `_: " "fitz.Pixmap(None, pix) Unrecognised args for constructing Pixmap" msgstr "" #: ../../../changes.txt:645 bcff5266d81d44828538dd318c25c548 msgid "" "Improved `Document.select() by using new MuPDF function " "`pdf_rearrange_pages()`. This is a more complete (and faster) " "implementation of what needs to be done here in that not only pages will " "be rearranged, but also consequential changes will be made to the table " "of contents, links to removed pages and affected entries in the Optional " "Content definitions." msgstr "" #: ../../../changes.txt:651 7e5e70f9786348e485e9f480c4c5f649 msgid "`TextWriter.appendv()`: added `small_caps` arg." msgstr "" #: ../../../changes.txt:652 511da4bdc4cb4d488b5540f7118d05c6 msgid "Fixed some valgrind errors with MuPDF master." msgstr "" #: ../../../changes.txt:653 9fa27b2a0f6542779698b58b6ef2797f msgid "Fixed `Document.insert_image()` when build with MuPDF master." msgstr "" #: ../../../changes.txt:656 8215b8e723014b82adeefa3d490e76cf msgid "**Changes in version 1.23.22 (2024-02-12)**" msgstr "" #: ../../../changes.txt:660 9499acfbd68c4038bf82444da1a07c47 msgid "" "**Fixed** `3143 `_: " "Difference in decoding of OCGs names between doc.get_ocgs() and " "page.get_drawings()" msgstr "" #: ../../../changes.txt:662 6a05eddb0f5846589fe4c0086fc9e146 msgid "" "**Fixed** `3139 `_: " "Pixmap resizing needs positional arg \"clip\" - even if None." msgstr "" #: ../../../changes.txt:666 9a6bd516b5734957b5d8700fec418b18 msgid "Removed the use of MuPDF function `fz_image_size()` from PyMuPDF." msgstr "" #: ../../../changes.txt:669 32b339e622b6447890c25a4ab191fd39 msgid "**Changes in version 1.23.21 (2024-02-01)**" msgstr "" #: ../../../changes.txt:675 fab60867577a487b9c3f486166614839 msgid "" "Fixed bug in set_xml_metadata(), PR `3112 " "`_: Fix pdf_add_stream " "metadata error" msgstr "" #: ../../../changes.txt:676 5db3c0df43d7466bb49c93da76eb7ded msgid "Fixed lack of `.parent` member in `TextPage` from `Annot.get_textpage()`." msgstr "" #: ../../../changes.txt:677 6886cfc95dcf48449baf3597f9ed5a5b msgid "Fixed bug in `Page.add_widget()`." msgstr "" #: ../../../changes.txt:680 466b6a96778a400fa703f8a164dc6006 msgid "**Changes in version 1.23.20 (2024-01-29)**" msgstr "" #: ../../../changes.txt:682 ../../../changes.txt:693 ../../../changes.txt:711 #: ../../../changes.txt:723 ../../../changes.txt:737 ../../../changes.txt:750 #: ../../../changes.txt:761 ../../../changes.txt:773 ../../../changes.txt:797 #: ../../../changes.txt:917 ../../../changes.txt:934 ../../../changes.txt:966 #: ../../../changes.txt:1023 ../../../changes.txt:1099 #: ../../../changes.txt:1133 ../../../changes.txt:1142 #: ../../../changes.txt:1151 ../../../changes.txt:1169 #: ../../../changes.txt:1269 ../../../changes.txt:1308 #: 10bae71e3a574059884b4f1d5baea65c 11746df9cf7b4144bc9cabc8e95b78a9 #: 35c5e4be6606427a95322276ca783f0e 4bbb30be5f60421a87e36a340ddbe65f #: 524f6c6556b5468c90bac3e6f81b279d 5a44d84debe5475da967de80ba53914b #: 5ed487b98bc84f92a08fdb4934e8535b 74166ebee93f4e9e999f1cd22be78aaf #: 780c7d9984234abebe430e3254afc4e8 a47d1d46827b45bebe969ac04f21dc0f #: a6ae2f8c435749c4a8dc5fbe5c95dff6 a776aae290f74bdfaa636b31d9b933e0 #: bb6b3124820a4512a56446f360c94404 c7fa8793bb6d44aca1771c6152ac83d8 #: d22de0587ab24d4ab437626e883261d4 dd73709cf4c74a6e9d9a8eba46753cd2 #: e4a33a6c03dd49d0a338e5b67900cac8 f7e8261277e44b8abe33e6e0f05bcde7 #: f98503e4ea7c425391e56ac00fbae870 fc10345ba347482ba6bf7042461f8232 msgid "Bug fixes:" msgstr "" #: ../../../changes.txt:684 e101eae15b004da2849ab4be087a4010 msgid "" "**Fixed** `3100 `_: Wrong" " internal property accessed in get_xml_metadata" msgstr "" #: ../../../changes.txt:688 30795d0573e140c88dd4cf9e6887fbe0 msgid "Significantly improved speed of `Document.get_toc()`." msgstr "" #: ../../../changes.txt:691 f23cca9b1fc84d0ea474332f2e1c6c2c msgid "**Changes in version 1.23.19 (2024-01-25)**" msgstr "" #: ../../../changes.txt:695 36758073da3a48f5bc485fd6a9fc328e msgid "" "**Fixed** `3087 `_: " "Exception in insert_image with mask specified" msgstr "" #: ../../../changes.txt:696 202f997680f84ed9b7bf363b2b348028 msgid "" "**Fixed** `3094 `_: " "TypeError: '<' not supported between instances of 'FzLocation' and 'int' " "in doc.delete_pages" msgstr "" #: ../../../changes.txt:700 b8dceb00014f42ccb7877fe431320209 msgid "When finding tables:" msgstr "" #: ../../../changes.txt:702 311dca44e7df40e0a0c2ece5cca045f3 msgid "" "Allow addition of user-defined \"virtual\" vector graphics when finding " "tables." msgstr "" #: ../../../changes.txt:703 743195d5487f4c79b7dea4defa19efdb msgid "" "Confirm that the enveloping bboxes of vector graphics are inside the clip" " rectangle." msgstr "" #: ../../../changes.txt:704 91bcfe988eab4abe82d29ec6a73c24ac msgid "Avoid slow finding of rectangle intersections." msgstr "" #: ../../../changes.txt:706 6fbf98c2146642699598279e74ace969 msgid "Added `Font.bbox` property." msgstr "" #: ../../../changes.txt:709 02dd1c5dc69346c3aa052addbe84f62d msgid "**Changes in version 1.23.18 (2024-01-23)**" msgstr "" #: ../../../changes.txt:713 e98e1fa4a6be43e19c1235f235206973 msgid "" "**Fixed** `3081 `_: " "doc.close() not closing the document" msgstr "" #: ../../../changes.txt:717 da8086b4179148e78eef2c50eb3cd527 msgid "" "Reduced size of sdist to fit on pypi.org (by reducing size of two test " "files)." msgstr "" #: ../../../changes.txt:718 0b7e1df1d1024f52810b0f1778d8d2de msgid "Fix `Annot.file_info()` if no `Desc` item." msgstr "" #: ../../../changes.txt:721 df117a0a6648402e8810ca3b417979b4 msgid "**Changes in version 1.23.17 (2024-01-22)**" msgstr "" #: ../../../changes.txt:725 37f262e5ed6b4d118a5a82e4beb2b4ad msgid "" "**Fixed** `3062 `_: " "page_rotation_reset does not return page to original rotation" msgstr "" #: ../../../changes.txt:726 f86ef7904604429884e4c81fcf5ae787 msgid "" "**Fixed** `3070 `_: " "update_link(): AttributeError: 'Page' object has no attribute 'super'" msgstr "" #: ../../../changes.txt:730 6c6a0371126c46b0bcc8ebc5df7be344 msgid "Fixed bug in `Page.links()` (PR #3075)." msgstr "" #: ../../../changes.txt:731 a9475e5785414f199b597f416d8e1f8d msgid "Fixed bug in `Page.get_bboxlog()` with layers." msgstr "" #: ../../../changes.txt:732 8867fda0c26e4548b930e7d40da999bc msgid "Add support for timeouts in scripts/ and tests/run_compound.py." msgstr "" #: ../../../changes.txt:735 50f7599b93df4914acc301398f9fb589 msgid "**Changes in version 1.23.16 (2024-01-18)**" msgstr "" #: ../../../changes.txt:739 98d0c677086e45b8aefb2561c344d108 msgid "" "**Fixed** `3058 `_: " "Pixmap created from CMYK JPEG delivers RGB format" msgstr "" #: ../../../changes.txt:743 6280e0fb16044307be72a98e78055199 msgid "" "In table detection strategy \"lines_strict\", exclude fill-only vector " "graphics." msgstr "" #: ../../../changes.txt:744 7b87c57e26184d6fab0bf49037ae0ee0 msgid "Fixed sysinstall test failure." msgstr "" #: ../../../changes.txt:745 479fcf54b5cc40719b42543c6b8eb8d7 msgid "In documentation, update feature matrix with item about text writing." msgstr "" #: ../../../changes.txt:748 a58ed680108b456f811bd161fcda9c91 msgid "**Changes in version 1.23.15 (2024-01-16)**" msgstr "" #: ../../../changes.txt:752 db43cbaa428745bbbc155e1449a46274 msgid "" "**Fixed** `3050 `_: " "python3.9 pix.set_pixel has something wrong in c.append( ord(i))" msgstr "" #: ../../../changes.txt:756 85116010a87b4782a3c2cf37d6d3c233 msgid "Improved docs for Page.find_tables()." msgstr "" #: ../../../changes.txt:759 a0e9d51dec614dd5aad7a32d5195c117 msgid "**Changes in version 1.23.14 (2024-01-15)**" msgstr "" #: ../../../changes.txt:763 a147e66fe72c47f7ab10b2211f76dd3f msgid "" "**Fixed** `3038 `_: " "JM_pixmap_from_display_list > Assertion Error : Checking for wrong type" msgstr "" #: ../../../changes.txt:764 8e99271499a243a0ad21780cd0aa3b4f msgid "" "**Fixed** `3039 `_: Issue" " with doc.close() not closing the document in PyMuPDF" msgstr "" #: ../../../changes.txt:768 3976a531e434472590b8052395aea031 msgid "" "Ensure valid \"re\" rectangles in `Page.get_drawings()` with derotated " "pages." msgstr "" #: ../../../changes.txt:771 082bdc523e1f473f85543e64d3853ad8 msgid "**Changes in version 1.23.13 (2024-01-15)**" msgstr "" #: ../../../changes.txt:775 797a7ea0082844de9aa334285db2046a msgid "" "**Fixed** `2979 `_: list " "index out of range in to_pandas()" msgstr "" #: ../../../changes.txt:776 95667931dbcb4237bae8f4c9af83594b msgid "" "**Fixed** `3001 `_: " "Calling find_tables() on one document alters the bounding boxes of a " "subsequent document" msgstr "" #: ../../../changes.txt:780 186cd9d07f9b4a58beb7e8e41f3bc17d msgid "Fixed `Rect.height` and `Rect.width` to never return negative values." msgstr "" #: ../../../changes.txt:781 27c5d3626f094ec5863b809e2a812c25 msgid "Fixed `TextPage.extractIMGINFO()`'s returned `dictkey_yres` value." msgstr "" #: ../../../changes.txt:784 8255dfd1b9d149ba8ce261e1ceaff664 msgid "**Changes in version 1.23.12 (2024-01-12)**" msgstr "" #: ../../../changes.txt:786 5bb9f57d3682407b99532c75233dba1f msgid "" "**Fixed** `3027 `_: " "Page.get_text throws Attribute Error for 'parent'" msgstr "" #: ../../../changes.txt:789 2dae2447cbb74e1fb8e1a42264ec7e70 msgid "**Changes in version 1.23.11 (2024-01-12)**" msgstr "" #: ../../../changes.txt:791 cd671647a36347d9b8adbfb7ee2447a9 msgid "Fixed some Pixmap construction bugs." msgstr "" #: ../../../changes.txt:792 e891dfad684a4752b4e5805a6293dfcf msgid "Fixed Pixmap.yres()." msgstr "" #: ../../../changes.txt:795 f131f3b1f3b641e989cfeab5425a3e9c msgid "**Changes in version 1.23.10 (2024-01-12)**" msgstr "" #: ../../../changes.txt:799 ac50349144d841ab902a3ae407ef8714 msgid "" "**Fixed** `3020 `_: Can't" " resize a PixMap" msgstr "" #: ../../../changes.txt:803 3f395fa335f948a6bf2ec8e7dca4ea01 msgid "Fixed Page.delete_image()." msgstr "" #: ../../../changes.txt:806 c60fab8d493747628cff1c624cb39043 msgid "**Changes in version 1.23.9 (2024-01-11)**" msgstr "" #: ../../../changes.txt:808 1fa84ae4248d423485aa5cb183570533 msgid "Default to new \"rebased\" implementation." msgstr "" #: ../../../changes.txt:810 950a6848918d4d6b80203a0558ed5266 msgid "" "The old \"classic\" implementation is available with `import fitz_old as " "fitz`." msgstr "" #: ../../../changes.txt:811 bebd4b40a6314a9b99d384b13f921a74 msgid "" "For more information about why we are changing to the rebased " "implementation, see: https://github.com/pymupdf/PyMuPDF/discussions/2680" msgstr "" #: ../../../changes.txt:814 0a613f5215304e7b922f3fbb0c54ad9c msgid "Use MuPDF-1.23.9." msgstr "" #: ../../../changes.txt:816 ../../../changes.txt:848 #: 79b8f33e4c684085bbd12543c914a92c ed73712d903c42daa048538222480c72 msgid "Bug fixes (rebased implementation only):" msgstr "" #: ../../../changes.txt:818 f0a68870dc7e4101b40fb65d25d18b5a msgid "" "**Fixed** `2911 `_: " "Page.derotation_matrix returns a tuple instead of a Matrix with rebased " "implementation" msgstr "" #: ../../../changes.txt:819 b056b928a27c4740bfc45a1e268ab0d2 msgid "" "**Fixed** `2919 `_: " "Rebased version: KeyError in resolve_names when merging pdfs" msgstr "" #: ../../../changes.txt:820 736154fa84784e259b795c962116ed21 msgid "" "**Fixed** `2922 `_: New " "feature that allows inserting named-destination links doesn't work" msgstr "" #: ../../../changes.txt:821 bfe6879a0e3449928a0e143e35d1973d msgid "" "**Fixed** `2943 `_: " "ZeroDivisionError: float division by zero when use apply_redactions()" msgstr "" #: ../../../changes.txt:822 3aea2bcd6a984d8f8e814d25a05ea0cd msgid "" "**Fixed** `2950 `_: " "Shelling out to pip during tests is problematic" msgstr "" #: ../../../changes.txt:823 64a074a99c094bf2b64bf0a1175cfd6e msgid "" "**Fixed** `2954 `_: " "Replacement unicode character in text extraction" msgstr "" #: ../../../changes.txt:824 f1ab1e9632c440a1ad3ddceab5970793 msgid "" "**Fixed** `2957 `_: " "apply_redactions() moving text" msgstr "" #: ../../../changes.txt:825 be824c3a45bd4be0b2bc52d892f31652 msgid "" "**Fixed** `2961 `_: " "Passing a string as a page number raises IndexError instead of TypeError." msgstr "" #: ../../../changes.txt:826 e776dd1532cf4e4b930371d30841afe9 msgid "" "**Fixed** `2969 `_: " "annot.next throws AttributeError" msgstr "" #: ../../../changes.txt:827 ac77c79a100942f8a6159beb24f4e67a msgid "" "**Fixed** `2978 `_: " "1.23.9rc1: module 'fitz.mupdf' has no attribute 'fz_copy_pixmap_rect'" msgstr "" #: ../../../changes.txt:829 362af45c412f45c39a1d822fab1286b1 msgid "" "**Fixed** `2907 `_: " "segfault trying to call clean_contents on certain pdfs with python 3.12" msgstr "" #: ../../../changes.txt:830 c1135c0939ef4daab6a8385631c53704 msgid "" "**Fixed** `2905 `_: " "SystemError: returned a " "result with an exception set" msgstr "" #: ../../../changes.txt:831 a9d0e8515e0c4113af2e60251120838a msgid "" "**Fixed** `2742 `_: " "Segmentation Fault when inserting three (but not two) copies of the same " "source page into one destination page" msgstr "" #: ../../../changes.txt:835 bdbbaa0c597e4d8690d2acc01a05a511 msgid "Add optional setting of opacity to `Page.insert_htmlbox()`." msgstr "" #: ../../../changes.txt:836 ec4580cff71a44b881bd2289b03e1e76 msgid "Fixed issue with add_redact_annot() mentioned in #2934." msgstr "" #: ../../../changes.txt:837 37a7489f60b24988aabf68ab765c53aa msgid "" "Fixed `Page.rotation()` to return 0 for non-PDF documents instead of " "raising an exception." msgstr "" #: ../../../changes.txt:838 c15327390f2c412599adc9f6c2cd41eb msgid "Fixed internal quad detection to cope with any Python sequence." msgstr "" #: ../../../changes.txt:839 b5b25dcbb0e04533b6f266160078d7ac msgid "" "Fixed rebased `fitz.pymupdf_version_tuple` - was previously set to mupdf " "version." msgstr "" #: ../../../changes.txt:840 417b49c5b97a43b2884451f91a6ccd72 msgid "" "Improved support for Linux system installs, including adding regular " "testing on Github." msgstr "" #: ../../../changes.txt:841 dc9b6649df764b6d8bdd0aeb241c8116 msgid "Add missing `flake8` to `scripts/gh_release.py:test_packages`." msgstr "" #: ../../../changes.txt:842 526255ea77784aa5a86322e409396fbf msgid "Use newly public functions in MuPDF-1.23.8." msgstr "" #: ../../../changes.txt:843 78af7dcf823d4333b745e1411e2535c0 msgid "Improved `scripts/test.py` to help investigation of MuPDF issues." msgstr "" #: ../../../changes.txt:846 c4377b33474d4f08b8bb6ea1785e8cae msgid "**Changes in version 1.23.8 (2023-12-19)**" msgstr "" #: ../../../changes.txt:850 06bc7d28ba624f879fc3f4225f042ebd msgid "" "**Fixed** `2634 `_: " "get_toc and set_toc do not behave consistently for rotated pages" msgstr "" #: ../../../changes.txt:851 eaabee50b85a41f5a1eee3082375a7d5 msgid "" "**Fixed** `2861 `_: " "AttributeError in getLinkDict during PDF Merge" msgstr "" #: ../../../changes.txt:852 11a45b3c36814980abef6db057685eef msgid "" "**Fixed** `2871 `_: " "KeyError in getLinkDict during PDF merge" msgstr "" #: ../../../changes.txt:853 f6127a8b2c46475da27184f59e39e7ef msgid "" "**Fixed** `2886 `_: Error" " in Skeleton for Named Link Destinations" msgstr "" #: ../../../changes.txt:855 ../../../changes.txt:888 #: 586f106b986842b08028b0f5f627f7ca d8af7ffde72c450d915b0463309a4314 msgid "Bug fixes (rebased and classic implementations):" msgstr "" #: ../../../changes.txt:857 b33ad6378a46458cb75ad39284db9641 msgid "" "**Fixed** `2885 `_: " "pymupdf find tables too slow" msgstr "" #: ../../../changes.txt:861 ../../../changes.txt:901 #: 4728a8ecae8e40aa81aac714354f5cd8 dfafbc41ed064d4e9417228eef3b8869 msgid "Rebased implementation:" msgstr "" #: ../../../changes.txt:863 d5e148c0135c420faee01c379333d863 msgid "" "`Page.insert_htmlbox()`: new, much more powerful alternative to " "`Page.insert_textbox()` or `TextWriter.fill_textbox()`, using `Story`." msgstr "" #: ../../../changes.txt:864 61b9573e3d5140e89cab3a5f2306ae99 msgid "`Story.fit*()`: new methods for fitting a Story into an expanded rect." msgstr "" #: ../../../changes.txt:865 2c6161c5bc974598a30735ae4181b27c msgid "`Story.write_with_links()`: add support for external links." msgstr "" #: ../../../changes.txt:866 98b4230a54804ef4acb0b180f44e9ae5 msgid "" "`Document.language()`: fixed to use MuPDF's new " "`mupdf.fz_string_from_text_language2()`." msgstr "" #: ../../../changes.txt:867 40995750950149ef83a0d8f6ddad76ef msgid "`Document.subset_fonts()` - fixed." msgstr "" #: ../../../changes.txt:868 8f0552b58651471a97e511567a32e0c2 msgid "Fixed internal `Archive._add_treeitem()` method." msgstr "" #: ../../../changes.txt:869 87b1222b024441dea38cf29daba33184 msgid "" "Fixed `fitz_new.__doc__` to contain PyMuPDF and Python version " "information, and OS name." msgstr "" #: ../../../changes.txt:870 386cb55b9f0c4087ae1996bb06b51a33 msgid "" "Removed use of `(*args, **kwargs)` in API, we now specify keyword args " "explicitly." msgstr "" #: ../../../changes.txt:871 c59b0cc5fecc4bdd9562cd2ce75075d3 msgid "Work with new MuPDF Python exception classes." msgstr "" #: ../../../changes.txt:873 e3e5a541241440ed9d367ef19430a835 msgid "" "Fixed bug where `button_states()` returns None when `/AP` points to an " "indirect object." msgstr "" #: ../../../changes.txt:874 5af1990cff754cd89a3aa438eb9d383b msgid "" "Fixed pillow test to not ignore all errors, and install pillow when " "testing." msgstr "" #: ../../../changes.txt:875 1f1299ee32f346b6b3729cf40091e92c msgid "" "Added test for `fitz.css_for_pymupdf_font()` (uses package `pymupdf-" "fonts`)." msgstr "" #: ../../../changes.txt:876 8a8e3b21e7fe474598e60c7c3d327f5b msgid "Simplified Github Actions test specifications." msgstr "" #: ../../../changes.txt:877 285e6db854b84f7fab4a2c650152d2a2 msgid "Updated `tests/README.md`." msgstr "" #: ../../../changes.txt:880 25533a44e1824331b867fb200db45187 msgid "**Changes in version 1.23.7 (2023-11-30)**" msgstr "" #: ../../../changes.txt:882 583b1de242bb4157b4445d6446ee6bbb msgid "Bug fixes in rebased implementation, not fixed in classic implementation:" msgstr "" #: ../../../changes.txt:884 235fe8226daa4b0abbac192cae7fd37a msgid "" "**Fixed** `2232 `_: " "Geometry helper classes should support keyword arguments" msgstr "" #: ../../../changes.txt:885 e575834fcd73477b81b61829f22f495d msgid "" "**Fixed** `2788 `_: " "Problem with get_toc in pymupdf 1.23.6" msgstr "" #: ../../../changes.txt:886 48886ca53b3d4f75bb21c99311bdb5f3 msgid "" "**Fixed** `2791 `_: " "Experiencing small memory leak in save()" msgstr "" #: ../../../changes.txt:890 10a6b50400ed447497a29b25510f48e4 msgid "" "**Fixed** `2736 `_: " "Failure when set cropbox with mediabox negative value" msgstr "" #: ../../../changes.txt:891 2a0b37db8390439fbb646a9c37103f52 msgid "" "**Fixed** `2749 `_: " "RuntimeError: cycle in structure tree" msgstr "" #: ../../../changes.txt:892 3d06cf904a104c3d90b146fa78bf69ef msgid "" "**Fixed** `2753 `_: " "Story.write_with_links will ignore everything after the first \"page " "break\" in the HTML." msgstr "" #: ../../../changes.txt:893 8a53b50ea2524665955b3157294a2b2d msgid "" "**Fixed** `2812 `_: " "find_tables on landscape page generates reversed text" msgstr "" #: ../../../changes.txt:894 888fb15372974a36b1fe3d66ef22e391 msgid "" "**Fixed** `2829 `_: " "[cannot create /Annot for kind] is still printed despite #2345 is closed." msgstr "" #: ../../../changes.txt:895 4bddd57842e24f349a1d201577c84f44 msgid "" "**Fixed** `2841 `_: " "Unexpected KeyError when using scrub with fitz_new" msgstr "" #: ../../../changes.txt:897 94aee473c47b4b39a4c3c4cb53567f41 msgid "Use MuPDF-1.23.7." msgstr "" #: ../../../changes.txt:903 bec49d14f00548e4b548e3392c71e4f9 msgid "Added flake8 code checking to test suite, and made various fixes." msgstr "" #: ../../../changes.txt:904 5c2f03ef2da94a85b04bdcaa6b4452b2 msgid "" "Disable diagnostics during Document constructor to match classic " "implementation." msgstr "" #: ../../../changes.txt:906 614caa01606b4df1a5f36c79ba7597dc msgid "" "Additional fix to `2553 " "`_: Invalid characters in" " versions >= 1.22" msgstr "" #: ../../../changes.txt:907 249c2e20b6584ff5bde073c96d14cef8 msgid "" "Fixed `MuPDF Bug 707324 " "`_: Story: HTML " "table row background color repeated incorrectly" msgstr "" #: ../../../changes.txt:908 40274b78dadb4924955e4fcee62c82e9 msgid "Added `scripts/test.py`, for simple build+test of PyMuPDF git checkout." msgstr "" #: ../../../changes.txt:909 f4348c71af1f40479d9eb7d08fdba3aa msgid "Added `fitz.pymupdf_version_tuple`, e.g. `(1, 23, 6)`." msgstr "" #: ../../../changes.txt:910 0125831c6ca04067b9605b86aefa7ebb msgid "" "Restored mistakenly-reverted fix for `2345 " "`_: Turn off print " "statements in utils.py" msgstr "" #: ../../../changes.txt:911 ecf3f5029df1424ca67fedcd1eac52e1 msgid "" "Include any trailing `... repeated times...` text in warnings " "returned by `mupdf_warnings()` (rebased only)." msgstr "" #: ../../../changes.txt:915 dae1fc58258f4a368eb9b9e73fdc3418 msgid "**Changes in version 1.23.6 (2023-11-06)**" msgstr "" #: ../../../changes.txt:919 4b44a7b92e344051be42fcb7b2fd86ca msgid "" "**Fixed** `2553 `_: " "Invalid characters in versions >= 1.22" msgstr "" #: ../../../changes.txt:920 c22c67eda878468e84fdce9860d9470e msgid "" "**Fixed** `2608 `_: " "Incorrect utf32 text extraction (high & low surrogates are split)" msgstr "" #: ../../../changes.txt:921 ../../../changes.txt:944 #: 6e09bf78b2e8482189006eea2acba2bb 9836ec3981e942eab17d9cf2073f8760 msgid "" "**Fixed** `2710 `_: " "page.rect and text location wrong / differing from older version" msgstr "" #: ../../../changes.txt:922 cf4d2d380bbc48eb852fc95710f97677 msgid "" "**Fixed** `2774 `_: wrong" " encoding for \"\\?\" character when sort=True" msgstr "" #: ../../../changes.txt:923 1f6c84f41d254543a72dc62354b851c3 msgid "" "**Fixed** `2775 `_: " "fitz_new does not work with python3.10 or earlier" msgstr "" #: ../../../changes.txt:924 87951ce6577046f9b2d94ccd7a8d15cf msgid "" "**Fixed** `2777 `_: With " "fitz_new, wrong type for Page.mediabox" msgstr "" #: ../../../changes.txt:928 8d946635456d4d35be553ed4ef5c4c20 msgid "Use MuPDF-1.23.5." msgstr "" #: ../../../changes.txt:929 f7013808115244fc929c4e70b737e840 msgid "Added Document.resolve_names() (rebased implementation only)." msgstr "" #: ../../../changes.txt:932 fc23c2f02e0f4d6eaaf921039e93a96f msgid "**Changes in version 1.23.5 (2023-10-11)**" msgstr "" #: ../../../changes.txt:936 6009b9edb3184a869f2ce12fd73c20bd msgid "" "**Fixed** `2341 `_: " "Handling negative values in the zoom section for LINK_GOTO in linkDest" msgstr "" #: ../../../changes.txt:937 0dd0674d2f134d99b73659b6f62b19a1 msgid "" "**Fixed** `2522 `_: Typo " "in set_layer() - NameError: name 'f' is not defined" msgstr "" #: ../../../changes.txt:938 c5288d50055d4c5da1a7e0df44a0ac43 msgid "" "**Fixed** `2548 `_: Fitz " "freezes on some PDFs when calling the fitz.Page.get_text_blocks method." msgstr "" #: ../../../changes.txt:939 5ff84b8fb6be4feb8cdbf5edbbb0abaa msgid "" "**Fixed** `2596 `_: " "save(garbage=3) breaks get_pixmap() with side effect" msgstr "" #: ../../../changes.txt:940 123cb55d916f49108937ed096e7ddb25 msgid "" "**Fixed** `2635 `_: " "\"clean=True\" makes objects invisible in the pdf" msgstr "" #: ../../../changes.txt:941 ../../../changes.txt:969 #: 7654b31ea4c84890bf69fa4688837d78 8eef4b86cdec4085ae3f96a960c2ce20 msgid "" "**Fixed** `2637 `_: " "Page.insert_textbox incorrectly handles the last word if it starts a new " "line" msgstr "" #: ../../../changes.txt:942 bcc1d82ed2934ae49084a16db226ddf1 msgid "" "**Fixed** `2699 `_: " "extract paragraph with below table" msgstr "" #: ../../../changes.txt:943 75014a04729c49dd8bc091fb9ba66444 msgid "" "**Fixed** `2703 `_: Wrong" " fontsize calculation in corner cases (\"page.get_texttrace()\")" msgstr "" #: ../../../changes.txt:945 f469c85d192646e5aab002778053d0a5 msgid "" "**Fixed** `2723 `_: When " "will a Python 3.12 wheel be available?" msgstr "" #: ../../../changes.txt:946 0fa82c24bbeb42d2be8390fbba927f0d msgid "" "**Fixed** `2730 `_: " "persistent get_text() formatting" msgstr "" #: ../../../changes.txt:950 72690f1bf41e43bda38ccd424aacca3c msgid "Use MuPDF-1.23.4." msgstr "" #: ../../../changes.txt:951 30ff227bd04646bdb17474afeccd9981 msgid "Fix optimisation flags with system installs." msgstr "" #: ../../../changes.txt:952 6906912e05f34a26b46e5f8c0b9dd6e0 msgid "" "Fixed the problem that the clip parameter does not take effect during " "table recognition" msgstr "" #: ../../../changes.txt:953 70a6a8cd8dcc4c90acf6957467999a4f msgid "Support Pillow mode \"RGBa\"" msgstr "" #: ../../../changes.txt:954 500cf538fcc84a5d88b63e846009e940 msgid "Support extra word delimiters" msgstr "" #: ../../../changes.txt:955 c5a98d3b81ca4f3b92ee9b55641041eb msgid "Support checking valid PDF name objects" msgstr "" #: ../../../changes.txt:958 9780d5d181924c1f98f6e987dee32f09 msgid "**Changes in version 1.23.4 (2023-09-26)**" msgstr "" #: ../../../changes.txt:960 89f0cd5d2bdb4c2a86b8130279eaafbd msgid "Improved build instructions." msgstr "" #: ../../../changes.txt:961 ba599b28412843c2b4970a1f78cfe599 msgid "Fixed Tesseract in rebased implementation." msgstr "" #: ../../../changes.txt:962 ad9696206b1147e8a6e75796ad68f204 msgid "Improvements to build/install with system MuPDF." msgstr "" #: ../../../changes.txt:964 0b8845dfb30c4a3ebf1bab255c2231f3 msgid "Fixed rebased bug in _insert_image()." msgstr "" #: ../../../changes.txt:968 0c9e490c29db4714af654a120396b8e6 msgid "" "**Fixed** `2556 `_: " "Segmentation fault at calling get_cdrawings(extended=True)" msgstr "" #: ../../../changes.txt:970 b47698c2a99a4d67be8d09ea95ac3f34 msgid "" "**Fixed** `2683 `_: " "Windows sdist build failure - non-quoting of path and using UNIX which " "command" msgstr "" #: ../../../changes.txt:971 2e8eaa9c953340e3b7f9cab5aa9c144a msgid "" "**Fixed** `2691 `_: " "Page.get_textpage_ocr() bug in rebased fitz_new version" msgstr "" #: ../../../changes.txt:972 01bf199cda4f40eb80f58292500d052e msgid "" "**Fixed** `2692 `_: " "Page.get_pixmap(clip=Rect()) bug in rebased fitz_new version" msgstr "" #: ../../../changes.txt:975 e635ca7f3a7144c7b155a0d53f366bc4 msgid "**Changes in version 1.23.3 (2023-08-31)**" msgstr "" #: ../../../changes.txt:977 b622f722651945db8c9065920951a027 msgid "Fixed use of Tesseract for OCR." msgstr "" #: ../../../changes.txt:980 0b6d628f664246e1af3613f80ef88e31 msgid "**Changes in version 1.23.2 (2023-08-28)**" msgstr "" #: ../../../changes.txt:982 5b021aef8d8846649ea00de593b61159 msgid "" "**Fixed** `#2613 `_: " "release 1.23.0 not MacOS-arm64 compatible" msgstr "" #: ../../../changes.txt:985 18a26e38b78544d8bed38a8639d031b2 msgid "**Changes in version 1.23.1 (2023-08-24)**" msgstr "" #: ../../../changes.txt:987 e62a756953074ab996467e70681646a5 msgid "Updated README and package summary description." msgstr "" #: ../../../changes.txt:990 a21901dee64f4a1899288f13aaebfd95 msgid "" "Fixed a problem on some Linux installations with Python-3.10 (and " "possibly earlier versions) where `import fitz` failed with `ImportError: " "libcrypt.so.2: cannot open shared object file: No such file or " "directory`." msgstr "" #: ../../../changes.txt:996 57b658dc047548bbbf4b37367da3eb2a msgid "Fixed `incompatible architecture` error on MacOS arm64." msgstr "" #: ../../../changes.txt:999 d42dcb0953b54804aee03e472206b6ee msgid "" "Fixed installation warning from Poetry about missing entry in wheels' " "RECORD files." msgstr "" #: ../../../changes.txt:1003 d3a8e8bb4f464faf90ac4e4f2d3d4257 msgid "**Changes in version 1.23.0 (2023-08-22)**" msgstr "" #: ../../../changes.txt:1005 73d894b0d405493fa197c028fc016e16 msgid "Add method `find_tables()` to the `Page` object." msgstr "" #: ../../../changes.txt:1007 0381413ce0b8400e912c1027cc2af4d5 msgid "" "This allows locating tables on any supported document page, and " "extracting table content by cell." msgstr "" #: ../../../changes.txt:1010 7e8f7d58a9bc4339b09e0b5f9ac4ee2d msgid "New \"rebased\" implementation of PyMuPDF." msgstr "" #: ../../../changes.txt:1012 9fc6a3029b014900b58e9338c2babb18 msgid "" "The rebased implementation is available as Python module `fitz_new`. It " "can be used as a drop-in replacement with `import fitz_new as fitz`." msgstr "" #: ../../../changes.txt:1017 738d34d7aebd43ff89c69b82aa7d46e8 msgid "" "Python-independent MuPDF libraries are now in a second wheel called " "`PyMuPDFb` that will be automatically installed by pip." msgstr "" #: ../../../changes.txt:1020 bca75d93dfe54dd0b930fe20a80af757 msgid "" "This is to save space on pypi.org - a full release only needs one " "`PyMuPDFb` wheel for each OS." msgstr "" #: ../../../changes.txt:1025 5ea8868d14804747b7a032703ca8e9b5 msgid "" "**Fixed** `#2542 `_: " "fitz.utils.scrub AttributeError Annot object has no attribute fileUpd " "inside" msgstr "" #: ../../../changes.txt:1026 d834522e9a47458f8df14e8f629b6a80 msgid "" "**Fixed** `#2533 `_: " "get_texttrace returned a incorrect character bbox" msgstr "" #: ../../../changes.txt:1027 fa9e61cc88804262a37529823e6ae230 msgid "" "**Fixed** `#2537 `_: " "Validation when setting a grouped RadioButton throws a RuntimeError: path" " to 'V' has indirects" msgstr "" #: ../../../changes.txt:1029 ../../../changes.txt:1829 #: ../../../changes.txt:1993 8bbac0324fdd4e349f9a5fa96e73089b #: eaf8cd2128cd4c5c877473f9bd315793 ec5d869f0874493ea625e47c43bf59f8 msgid "Other changes:" msgstr "" #: ../../../changes.txt:1031 038268fa0e3d4530b127e02b008b0de5 msgid "Dropped support for Python-3.7." msgstr "" #: ../../../changes.txt:1033 2f238ba63e474abd882d994c5d8a6c7d msgid "Fix for wrong page / annot `/Contents` cleaning." msgstr "" #: ../../../changes.txt:1035 8de4c1abb94c4af0ae76a8bc208f2498 msgid "We need to set `pdf_filter_options::no_update` to zero." msgstr "" #: ../../../changes.txt:1037 3be90380c41041df9c0e8a4b1514f49a msgid "Added new function get_tessdata()." msgstr "" #: ../../../changes.txt:1039 e2dd7eb60faf45958693b36439454d65 msgid "Cope with problem `/Annot` arrays." msgstr "" #: ../../../changes.txt:1041 f3a9365058d14581b262aefd3dc3f5cd msgid "" "When copying page annotations in method Document.insert_pdf we previously" " did not check the validity of members of the `/Annots` array. For " "faulty members (like null or non-dictionary items) this could cause " "unnecessary exceptions. This fix implements more checks and skips such " "array items." msgstr "" #: ../../../changes.txt:1047 15b514dde25a435db2d8761712b2b511 msgid "Additional annotation type checks." msgstr "" #: ../../../changes.txt:1049 3d28a76d5772428ca847e78115435df5 msgid "" "We did not previously check for annotation type when getting / setting " "annotation border properties. This is now checked in accordance with " "MuPDF." msgstr "" #: ../../../changes.txt:1053 1db4c46ee27f4603907a8be59ce434bd msgid "Increase fault tolerance." msgstr "" #: ../../../changes.txt:1055 cfeadbde1d1a4bd28e4394f298039395 msgid "" "Avoid exceptions in method `insert_pdf()` when source pages contains " "invalid items in the `/Annots` array." msgstr "" #: ../../../changes.txt:1058 e95424ad171f4befacebac209026dccf msgid "Return empty border dict for applicable annots." msgstr "" #: ../../../changes.txt:1060 d32e47da50ad4e1bbec4315e5deb475a msgid "" "We previously were returning a non-empty border dictionary even for non-" "applicable annotation types. We now return the empty dictionary `{}` in " "these cases. This requires some corresponding changes in the annotation " "`.update()` method, namely for dashes and border width." msgstr "" #: ../../../changes.txt:1065 a743fc735f8e4751aa4c9fb35972a0e6 msgid "Restrict `set_rect` to applicable annot types." msgstr "" #: ../../../changes.txt:1067 33dd0a503f44425489708bfc1eba3781 msgid "" "We were insufficiently excluding non-applicable annotation types from " "`set_rect()` method. We now let MuPDF catch unsupported annotations and " "return `False` in these cases." msgstr "" #: ../../../changes.txt:1071 3c981f3c14264a87a5e5864716eb590f msgid "Wrong fontsize computation in `page.get_texttrace()`." msgstr "" #: ../../../changes.txt:1073 d2bca3e2d5044d88b32f20c0e92bf049 msgid "" "When computing the font size we were using the final text transformation " "matrix, where we should have taken `span->trm` instead. This is " "corrected here." msgstr "" #: ../../../changes.txt:1077 4e4387c698a9431c875e14e61bfe5993 msgid "Updates to cope with changes to latest MuPDF." msgstr "" #: ../../../changes.txt:1079 68949888709c441996bba638e370acdd msgid "`pdf_lookup_anchor()` has been removed." msgstr "" #: ../../../changes.txt:1081 8e5efc45233c429083dbb2e7710b8e46 msgid "Update fill_textbox to better respect rect.width" msgstr "" #: ../../../changes.txt:1083 193ee81062494935a4b6e5f7a2d5d470 msgid "" "The function norm_words in fill_textbox had a bug in its last loop, " "appending n+1 characters when actually measuring width of n characters. " "It led to a bug in fill_texbox when you tried to write a single word " "mostly composed of \"wide\" letters (M,m, W, w...), causing the written " "text to exceed the given rect." msgstr "" #: ../../../changes.txt:1089 6719947ef5ad4b44b30317c8cd0d27f0 msgid "The fix was just to replace n+1 by n." msgstr "" #: ../../../changes.txt:1091 a7647cf90c074ee7bf1e22c92b11aad2 msgid "Add `script_focus` and `script_blur` options to widget." msgstr "" #: ../../../changes.txt:1095 e7f3a5c65c2a4b4095652b5ee87ecf26 msgid "**Changes in version 1.22.5 (2023-06-21)**" msgstr "" #: ../../../changes.txt:1097 e0f897c4559d4185828a667deab0b5e1 msgid "This release uses ``MuPDF-1.22.2``." msgstr "" #: ../../../changes.txt:1101 d01a2996634d4afd910a1b19f88fe54d msgid "" "**Fixed** `#2365 `_: " "Incorrect dictionary values for type \"fs\" drawings." msgstr "" #: ../../../changes.txt:1102 37372904c5fc4a288d1bcfae3658be44 msgid "" "**Fixed** `#2391 `_: " "Check box automatically uncheck when we update same checkbox more than 1 " "times." msgstr "" #: ../../../changes.txt:1103 da93bf73beab4c7394a870d6ef00aa74 msgid "" "**Fixed** `#2400 `_: Gaps" " within text of same line not filled with spaces." msgstr "" #: ../../../changes.txt:1104 c7bbdcecf83d4af18820e8854d6ed2f7 msgid "" "**Fixed** `#2404 `_: " "Blacklining an image in PDF won't remove underlying content in version " "1.22.X." msgstr "" #: ../../../changes.txt:1105 5dab0dae25104c5fac71c4bea81bd2ab msgid "" "**Fixed** `#2430 `_: " "Incorrectly reducing ref count of Py_None." msgstr "" #: ../../../changes.txt:1106 28dd826ad25d4fe989f269746f3f3beb msgid "" "**Fixed** `#2450 `_: " "Empty fill color and fill opacity for paths with fill and stroke " "operations with 1.22.*" msgstr "" #: ../../../changes.txt:1107 6eeb2a8ef825424fad2bdbac330da13d msgid "" "**Fixed** `#2462 `_: " "Error at \"get_drawing(extended=True )\"" msgstr "" #: ../../../changes.txt:1108 d83cacb33bfb43289ba1cac19694532b msgid "" "**Fixed** `#2468 `_: " "Decode error when trying to get drawings" msgstr "" #: ../../../changes.txt:1109 6816013f54d4446bb7b60530a6e49ad6 msgid "" "**Fixed** `#2710 `_: " "page.rect and text location wrong / differing from older version" msgstr "" #: ../../../changes.txt:1110 2a55b8aad74742ba905c8261e774e40e msgid "" "**Fixed** `#2723 `_: When" " will a Python 3.12 wheel be available?" msgstr "" #: ../../../changes.txt:1112 89917a32f35f46348baa0a3c330b174e msgid "New features:" msgstr "" #: ../../../changes.txt:1114 84e05da539e34fb1b20339210c836492 msgid "" "**Changed** Annotations now support \"cloudy\" borders. The " ":attr:`Annot.border` property has the new item `clouds`, and method " ":meth:`Annot.set_border` supports the corresponding `clouds` argument." msgstr "" #: ../../../changes.txt:1118 bce76d38c410446ba81647f0896ef355 msgid "" "**Changed** Radio button widgets in the same RB group are now " "consistently updated **if the group is defined in the standard way**." msgstr "" #: ../../../changes.txt:1121 f53cb26ab76e43dfbbd2f4c2efc5a821 msgid "" "**Added** Support for the `/Locked` key in PDF Optional Content. This " "array inside the catalog entry `/OCProperties` can now be extracted and " "set." msgstr "" #: ../../../changes.txt:1124 def96ff824944143acfaffad2e689880 msgid "" "**Added** Support for new parameter `tessdata` in OCR functions. New " "function :meth:`get_tessdata` locates the language support folder if " "Tesseract is installed." msgstr "" #: ../../../changes.txt:1129 ab43957ddc794c8a9b04c475426c4984 msgid "**Changes in version 1.22.3 (2023-05-10)**" msgstr "" #: ../../../changes.txt:1131 ../../../changes.txt:1140 #: ../../../changes.txt:1149 ../../../changes.txt:1161 #: 03ca33346d3944328c25a5c144420613 07f4c427f5f544f5bd7d767983484060 #: 0fb05318e4944beeb5124143ee76589f d7e781b29559409897126ce3786cd3e7 msgid "This release uses ``MuPDF-1.22.0``." msgstr "" #: ../../../changes.txt:1135 91c90d81ef504a9d8aeaffb101145d25 msgid "" "**Fixed** `#2333 `_: " "Unable to set any of button radio group in form" msgstr "" #: ../../../changes.txt:1138 016b5d8017ec4b46aa0db0ca2575d91b msgid "**Changes in version 1.22.2 (2023-04-26)**" msgstr "" #: ../../../changes.txt:1144 2a883f3384d24cb4b50c413be7b7248d msgid "" "**Fixed** `#2369 `_: " "Image extraction bugs with newer versions" msgstr "" #: ../../../changes.txt:1147 558df7978ec349b98ce43b9afb00b02e msgid "**Changes in version 1.22.1 (2023-04-18)**" msgstr "" #: ../../../changes.txt:1153 2f26d737893143a0b598c60bbf17e7c1 msgid "" "**Fixed** `#2345 `_: Turn" " off print statements in utils.py" msgstr "" #: ../../../changes.txt:1154 88393d4c4b1c4de88301c4a0c889142a msgid "" "**Fixed** `#2348 `_: " "extract_image returns an extension \"flate\" instead of \"png\"" msgstr "" #: ../../../changes.txt:1155 a669f7b9c4be4a208b4f533e8f283873 msgid "" "**Fixed** `#2350 `_: Can " "not make widget (checkbox) to read-only by adding flags " "PDF_FIELD_IS_READ_ONLY" msgstr "" #: ../../../changes.txt:1156 2b3bdc6748004a1aa84e2d6b31562785 msgid "" "**Fixed** `#2355 `_: " "1.22.0 error when using get_toc (AttributeError: 'SwigPyObject' object " "has no attribute)" msgstr "" #: ../../../changes.txt:1159 350bcb28a30944fdacb28843123738f2 msgid "**Changes in version 1.22.0 (2023-04-14)**" msgstr "" #: ../../../changes.txt:1163 44f570ec1df54e41a946bffb631b53c9 msgid "Behavioural changes:" msgstr "" #: ../../../changes.txt:1165 3826a16556c6458d8e1e603e51ffd973 msgid "" "Text extraction now includes glyphs that overlap with clip rect; " "previously they were included only if they were entirely contained within" " the clip rect." msgstr "" #: ../../../changes.txt:1171 3c30c3109974444198cf37e90e8ecabb msgid "" "**Fixed** `#1763 `_: " "Interactive(smartform) form PDF calculation not working in pymupdf" msgstr "" #: ../../../changes.txt:1172 af42fd504f0640239d81c483794b7e87 msgid "" "**Fixed** `#1995 `_: " "RuntimeError: image is too high for a long paged pdf file when trying" msgstr "" #: ../../../changes.txt:1173 c1d1a1930cec45f3aeb64999517485da msgid "" "**Fixed** `#2093 `_: " "Image in pdf changes color after applying redactions" msgstr "" #: ../../../changes.txt:1174 44f1654607db4a3a8bea70e0742f243f msgid "" "**Fixed** `#2108 `_: " "Redaction removing more text than expected" msgstr "" #: ../../../changes.txt:1175 13a17730caa849b68c2ae08ecb2ca4d8 msgid "" "**Fixed** `#2141 `_: " "Failed to read JPX header when trying to get blocks" msgstr "" #: ../../../changes.txt:1176 59f63490e3084544a37ad382c51db86f msgid "" "**Fixed** `#2144 `_: " "Replace image throws an error" msgstr "" #: ../../../changes.txt:1177 126c1e66cfb94388a6f083d43390e614 msgid "" "**Fixed** `#2146 `_: " "Wrong Handling of Reference Count of \"None\" Object" msgstr "" #: ../../../changes.txt:1178 c2df8c498e4c4870b10129059c78dc55 msgid "" "**Fixed** `#2161 `_: " "Support adding images as pages directly" msgstr "" #: ../../../changes.txt:1179 fa791f2adef34202b8f713657d47816f msgid "" "**Fixed** `#2168 `_: " "``page.add_highlight_annot(start=pointa, stop=pointb)`` not working" msgstr "" #: ../../../changes.txt:1180 e34fc762c8864c6db478c2a49d9e26ef msgid "" "**Fixed** `#2173 `_: " "Double free of ``Colorspace`` used in ``Pixmap``" msgstr "" #: ../../../changes.txt:1181 18b7a0bf38a14b94a56b1ba2feea09b9 msgid "" "**Fixed** `#2179 `_: " "Incorrect documentation for ``pixmap.tint_with()``" msgstr "" #: ../../../changes.txt:1182 30fdc624e4da4b0da0d438177b35bb4d msgid "" "**Fixed** `#2208 `_: " "Pushbutton widget appears as check box" msgstr "" #: ../../../changes.txt:1183 4d209898906843229670a95f12041360 msgid "" "**Fixed** `#2210 `_: " "``apply_redactions()`` move pdf text to right after redaction" msgstr "" #: ../../../changes.txt:1184 e6423ce2ee3e42cd842814a3ea98cae3 msgid "" "**Fixed** `#2220 `_: " "``Page.delete_image()`` | object has no attribute ``is_image``" msgstr "" #: ../../../changes.txt:1185 c6210c2a77804a929b68c35607fa6823 msgid "" "**Fixed** `#2228 `_: open" " some pdf cost too much time" msgstr "" #: ../../../changes.txt:1186 b599a24386c74a8c913ae912d614557a msgid "" "**Fixed** `#2238 `_: Bug " "- can not extract data from file in the newest version 1.21.1" msgstr "" #: ../../../changes.txt:1187 b350fda19a5149f5848f62509b82c19a msgid "" "**Fixed** `#2242 `_: " "Python quits silently in ``Story.element_positions()`` if callback " "function prototype is wrong" msgstr "" #: ../../../changes.txt:1188 e6dc566181194da487883bc82530e4c5 msgid "" "**Fixed** `#2246 `_: " "TextWriter write text in a wrong position" msgstr "" #: ../../../changes.txt:1189 3a1d2b5a77714081819e4147e4876ed9 msgid "" "**Fixed** `#2248 `_: " "After redacting the content, the position of the remaining text changes" msgstr "" #: ../../../changes.txt:1190 be48ed21d0f44f6dba17fab6201c8b78 msgid "" "**Fixed** `#2250 `_: " "docs: unclear or broken link in page.rst" msgstr "" #: ../../../changes.txt:1191 1f64252d8b684958a8360570bc1b540a msgid "" "**Fixed** `#2251 `_: " "mupdf_display_errors does not apply to Pixmap when loading broken image" msgstr "" #: ../../../changes.txt:1192 e8ac54952809456694e4b366c0992b6d msgid "" "**Fixed** `#2270 `_: " "``Annot.get_text(\"words\")`` - doesn't return the first line of words" msgstr "" #: ../../../changes.txt:1193 982ad8c99b6f4f739e357ee11cd3b514 msgid "" "**Fixed** `#2275 `_: " "insert_image: document that rotations are counterclockwise" msgstr "" #: ../../../changes.txt:1194 eb8b181a15924a07abee72fea8a50ce9 msgid "" "**Fixed** `#2278 `_: Can " "not make widget (checkbox) to read-only by adding flags " "PDF_FIELD_IS_READ_ONLY" msgstr "" #: ../../../changes.txt:1195 2dd5e761dcb94cde9a62d9e95e521f8a msgid "" "**Fixed** `#2290 `_: " "Different image format/data from Page.get_text(\"dict\") and " "Fitz.get_page_images()" msgstr "" #: ../../../changes.txt:1196 b626d2a058c1457bb8fc7b175049d787 msgid "" "**Fixed** `#2293 `_: 68 " "failed tests when installing from sdist on my box" msgstr "" #: ../../../changes.txt:1197 c7c26b4cf78644b98a99810e21c743c5 msgid "" "**Fixed** `#2300 `_: Too " "much recursion in tree (parents), makes program terminate" msgstr "" #: ../../../changes.txt:1198 53cf50d333db4541900b708daa262c2d msgid "" "**Fixed** `#2322 `_: " "add_highlight_annot using clip generates \"A Number is Out of Range\" " "error in PDF" msgstr "" #: ../../../changes.txt:1202 dc34fa0179bf4c0097c613d4e4d7cd5d msgid "" "Add key \"/AS (Yes)\" to the underlying annot object of a selected button" " form field." msgstr "" #: ../../../changes.txt:1204 851dc87410c04af3811c1fce6e46d473 msgid "" "Remove unused ``Document`` methods ``has_xref_streams()`` and " "``has_old_style_xrefs()`` as MuPDF equivalents have been removed." msgstr "" #: ../../../changes.txt:1207 85d63fb357cc4ae6843661251e81671d msgid "" "Add new ``Document`` methods and properties for getting/setting " "``/PageMode``, ``/PageLayout`` and ``/MarkInfo``." msgstr "" #: ../../../changes.txt:1210 4692f2e3d07246f4b715a11b16c41826 msgid "" "New ``Document`` property ``version_count``, which contains the number of" " incremental saves plus one." msgstr "" #: ../../../changes.txt:1213 35dcac5f24064e0aa4e37ed607d7ee66 msgid "" "New ``Document`` property ``is_fast_webaccess`` which tells whether the " "document is linearized." msgstr "" #: ../../../changes.txt:1216 123a5e07f4e14c818cdcd4df6eb3afee msgid "``DocumentWriter`` is now a context manager." msgstr "" #: ../../../changes.txt:1218 78db04ba2a9c48b7ad95cf5a7935dbd9 msgid "Add support for ``Pixmap`` JPEG output." msgstr "" #: ../../../changes.txt:1220 75aea400570e4b6e9fec59457f4f883e msgid "Add support for drawing rectangles with rounded corners." msgstr "" #: ../../../changes.txt:1222 8f7ef5836f6341ec93a07f437355992f msgid "``get_drawings()``: added optional ``extended`` arg." msgstr "" #: ../../../changes.txt:1224 e60534dd491e4153a778b53b862c3666 msgid "" "Fixed issue where trace devices' state was not being initialised " "correctly; data returned from things like ``fitz.Page.get_texttrace()`` " "might be slightly altered, e.g. ``linewidth`` values." msgstr "" #: ../../../changes.txt:1228 5ce1cdb70dd7438d9abe42cb5886dddc msgid "" "Output warning to ``stderr`` if it looks like we are being used with " "current directory containing an invalid ``fitz/`` directory, because this" " can break import of ``fitz`` module. For example this happens if one " "attempts to use ``fitz`` when current directory is a PyMuPDF checkout." msgstr "" #: ../../../changes.txt:1234 ../../../changes.txt:1289 #: 349693fd237b4cbc8a22aa6cf3da10f1 8656870c12324ba69e9770b2a5f4fad6 msgid "Documentation:" msgstr "" #: ../../../changes.txt:1236 d223e4e942aa4b40ae6748f3f806de5d msgid "General rework:" msgstr "" #: ../../../changes.txt:1238 f085940fb9eb4248aa37862aa5ee511f msgid "Introduces a new home page and new table of contents." msgstr "" #: ../../../changes.txt:1239 7d45f07d7c9f45d085714f462f775464 msgid "Structural update to include new About section." msgstr "" #: ../../../changes.txt:1240 fbd4e460a3094b4e9f3cbe8bdb120960 msgid "Comparison & performance graphing." msgstr "" #: ../../../changes.txt:1241 42f77bb0503d48488766f5fdb4d19c15 msgid "Includes performance methodology in appendix." msgstr "" #: ../../../changes.txt:1242 3bc9a3e24e0249a7a103014e58b0cfe0 msgid "Updates conf.py to understand single back-ticks as code." msgstr "" #: ../../../changes.txt:1243 a3e9a116b3fb453fa81fe3081ca9ac28 msgid "Converts double back-ticks to single back-ticks." msgstr "" #: ../../../changes.txt:1244 dc12d40a4c6148f6b2c2740f969fe028 msgid "Removes redundant files." msgstr "" #: ../../../changes.txt:1246 4b1314b91c0c4a57afc180019e7fcf7f msgid "Improve ``insert_file()`` documentation." msgstr "" #: ../../../changes.txt:1248 d4504863060147358071d6130ed1d42c msgid "``get_bboxlog()``: added optional ``layers`` to ``get_bboxlog()``." msgstr "" #: ../../../changes.txt:1249 c11f7f0d2dab4b70968cca0abf587247 msgid "" "``Page.get_texttrace()``: add new dictionary key ``layer``, name of " "Optional Content Group." msgstr "" #: ../../../changes.txt:1251 202373f80f8d415a95fc9f1ab5c7f3c6 msgid "Mention use of Python venv in installation documentation." msgstr "" #: ../../../changes.txt:1253 b7d408d9e1624b44b165a77a64070262 msgid "Added missing fix for #2057 to release 1.21.1's changelog." msgstr "" #: ../../../changes.txt:1255 e6cde05edeef4042a0657f838649a63c msgid "Fixes many links to the PyMuPDF-Utilities repo scripts." msgstr "" #: ../../../changes.txt:1257 038857900256474c9fded24cb273f8b5 msgid "Avoid duplication of ``changes.txt`` and ``docs/changes.rst``." msgstr "" #: ../../../changes.txt:1259 e343ebb10ae64a2baebc475af2998387 msgid "Build" msgstr "" #: ../../../changes.txt:1261 70564fcedaa2459bbccc68bc3d893e47 msgid "Added ``pyproject.toml`` file to improve builds using pip etc." msgstr "" #: ../../../changes.txt:1265 b1ea3fa1f44849439039e1a63d88a6e4 msgid "**Changes in Version 1.21.1 (2022-12-13)**" msgstr "" #: ../../../changes.txt:1267 92d79ae3bac04eae98a0a5093fe8273d msgid "This release uses ``MuPDF-1.21.1``." msgstr "" #: ../../../changes.txt:1271 3276e784b07a47648e6c6390b6cd3266 msgid "" "**Fixed** `#2110 `_: " "Fully embedded font is extracted only partially if it occupies more than " "one object" msgstr "" #: ../../../changes.txt:1272 950a39d02c9a4c8b8fa42d3ac1ac9e37 msgid "" "**Fixed** `#2094 `_: " "Rectangle Detection Logic" msgstr "" #: ../../../changes.txt:1273 2f5a46c0803d4b5a9cbbacd71100b204 msgid "" "**Fixed** `#2088 `_: " "Destination point not set for named links in toc" msgstr "" #: ../../../changes.txt:1274 97e2df4608364a7782f5c3a2e5b51f8d msgid "" "**Fixed** `#2087 `_: " "Image with Filter \"[/FlateDecode/JPXDecode]\" not extracted" msgstr "" #: ../../../changes.txt:1275 2168171e471542ada426f030b803e71d msgid "" "**Fixed** `#2086 `_: " "Document.save() owner_pw & user_pw has buffer overflow bug" msgstr "" #: ../../../changes.txt:1276 a23066f8e8654302b8b78db3816529c8 msgid "" "**Fixed** `#2076 `_: " "Segfault in fitz.py" msgstr "" #: ../../../changes.txt:1277 13898161176b4a65990185478cb80a77 msgid "" "**Fixed** `#2057 `_: " "Document.save garbage parameter not working in PyMuPDF 1.21.0" msgstr "" #: ../../../changes.txt:1278 9d7d27f10c4946fd8036c536b9c192e1 msgid "" "**Fixed** `#2051 `_: " "Missing DPI Parameter" msgstr "" #: ../../../changes.txt:1279 f53e894aea1048b0b6ea80c4ea26c7c5 msgid "" "**Fixed** `#2048 `_: " "Invalid size of TextPage and bbox with newest version 1.21.0" msgstr "" #: ../../../changes.txt:1280 f969ab18933245a593f97d97ee9ecbf6 msgid "" "**Fixed** `#2045 `_: " "SystemError: returned a result " "with an error set" msgstr "" #: ../../../changes.txt:1281 1f16bd21e2a8445d9592684ec7ecca51 msgid "" "**Fixed** `#2039 `_: " "1.21.0 fails to build against system libmupdf" msgstr "" #: ../../../changes.txt:1282 3c45097d33ee470a9481317257d311f7 msgid "" "**Fixed** `#2036 `_: " "Archive::Archive defined twice" msgstr "" #: ../../../changes.txt:1284 6533ecdf4d754fe7a4443b4a1b02bb72 msgid "Other" msgstr "" #: ../../../changes.txt:1286 9b576f8a8de143e3b3b9de9b6368ca18 msgid "Swallow \"&zoom=nan\" in link uri strings." msgstr "" #: ../../../changes.txt:1287 f70b7dad981d4d249124939b4f1aaaee msgid "" "Add new Page utility methods ``Page.replace_image()`` and " "``Page.delete_image()``." msgstr "" #: ../../../changes.txt:1291 4f89ab38e60b43ea987d07e27961bb7d msgid "" "`#2040 `_: Added note " "about test failure with non-default build of MuPDF, to " "``tests/README.md``." msgstr "" #: ../../../changes.txt:1292 558ff70ae6224480af3e735540cac2e3 msgid "" "`#2037 `_: In " "``docs/installation.rst``, mention incompatibility with chocolatey.org on" " Windows." msgstr "" #: ../../../changes.txt:1293 397d721cec884107af23df22baffdcb0 msgid "" "`#2061 `_: Fixed " "description of ``Annot.file_info``." msgstr "" #: ../../../changes.txt:1294 c6511b374b8b434caf2413b84c80813d msgid "" "`#2065 `_: Show how to " "insert internal PDF link." msgstr "" #: ../../../changes.txt:1295 6a5f0c4f501b4afd92cfe917137a0758 msgid "Improved description of building from source without an sdist." msgstr "" #: ../../../changes.txt:1296 67690117d7be41879e6fa66746eefeb1 msgid "Added information about running tests." msgstr "" #: ../../../changes.txt:1297 49b3f25fb63147c3b4c90a255b9ef648 msgid "" "`#2084 `_: Fixed broken " "link to PyMuPDF-Utilities." msgstr "" #: ../../../changes.txt:1300 575f368bd94e401b9952c6d42b41700d msgid "**Changes in Version 1.21.0 (2022-11-8)**" msgstr "" #: ../../../changes.txt:1302 673df835349745e7865e5b7f56344a60 msgid "This release uses ``MuPDF-1.21.0``." msgstr "" #: ../../../changes.txt:1304 17bf58b166d24d168b6139c6e77d3a91 msgid "New feature: Stories." msgstr "" #: ../../../changes.txt:1306 a17fc35b1e5e48ab82510fb0a263af42 msgid "Added wheels for Python-3.11." msgstr "" #: ../../../changes.txt:1310 15df913e178e4f6781add4fa251aec7f msgid "" "**Fixed** `#1701 `_: " "Broken custom image insertion." msgstr "" #: ../../../changes.txt:1311 2e7ca2e90f944214af8d8a773028ae37 msgid "" "**Fixed** `#1854 `_: " "`Document.delete_pages()` declines keyword arguments." msgstr "" #: ../../../changes.txt:1312 346bb412bfad447b83a0e599f7336a01 msgid "" "**Fixed** `#1868 `_: " "Access Violation Error at `page.apply_redactions()`." msgstr "" #: ../../../changes.txt:1313 9284226d16f4445cb9f22941a7e04dab msgid "" "**Fixed** `#1909 `_: " "Adding text with `fontname=\"Helvetica\"` can silently fail." msgstr "" #: ../../../changes.txt:1314 c11ff004104f4de1b6e767abc09ba8c4 msgid "" "**Fixed** `#1913 `_: " "`draw_rect()`: does not respect width if color is not specified." msgstr "" #: ../../../changes.txt:1315 0f7b31ba423c48a185bae37f8c31c421 msgid "" "**Fixed** `#1917 `_: " "`subset_fonts()`: make it possible to silence the stdout." msgstr "" #: ../../../changes.txt:1316 a785e9b369404f42b2a872e50d17133b msgid "" "**Fixed** `#1936 `_: " "Rectangle detection can be incorrect producing wrong output." msgstr "" #: ../../../changes.txt:1317 08fa2dec869748e4aa0d6b44cb796106 msgid "" "**Fixed** `#1945 `_: " "Segmentation fault when saving with `clean=True`." msgstr "" #: ../../../changes.txt:1318 3f1f9499ba9540f090c963df0a8cf1c2 msgid "" "**Fixed** `#1965 `_: " "`pdfocr_save()` Hard Crash." msgstr "" #: ../../../changes.txt:1319 e675868f950a47b89b02bdec849ddfaf msgid "" "**Fixed** `#1971 `_: " "Segmentation fault when using `get_drawings()`." msgstr "" #: ../../../changes.txt:1320 9af37195cb0a40ef94d54604e449326c msgid "" "**Fixed** `#1946 `_: " "`block_no` and `block_type` switched in `get_text()` docs." msgstr "" #: ../../../changes.txt:1321 cad632bb6e5347fdb160df1d5e205e7f msgid "" "**Fixed** `#2013 `_: " "AttributeError: 'Widget' object has no attribute '_annot' in delete " "widget." msgstr "" #: ../../../changes.txt:1323 c6abbf7c5af64afe8a6d1294f4458a5b msgid "Misc changes to core code:" msgstr "" #: ../../../changes.txt:1325 bcadf404caaf42199adda95adecf0183 msgid "Fixed various compiler warnings and a sequence-point bug." msgstr "" #: ../../../changes.txt:1326 1e7ac8c3fc184879954a671e241386ce msgid "Added support for Memento builds." msgstr "" #: ../../../changes.txt:1327 2d4b0ca48cff409ab625548ad136c9dd msgid "Fixed leaks detected by Memento in test suite." msgstr "" #: ../../../changes.txt:1328 eb361878f2a34aba8443b994d71d171a msgid "Fixed handling of exceptions in set_name() and set_rect()." msgstr "" #: ../../../changes.txt:1329 a57b2a7cb8ee4135a049aa057aa122ab msgid "Allow build with latest MuPDF, for regular testing of PyMuPDF master." msgstr "" #: ../../../changes.txt:1330 94ed6dc32d87489980b579f7731e909a msgid "Cope with new MuPDF exceptions when setting rect for some Annot types." msgstr "" #: ../../../changes.txt:1331 0ddc8291d7994c71af6956edb68bd61f msgid "" "Reduced cosmetic differences between MuPDF's config.h and PyMuPDF's " "_config.h." msgstr "" #: ../../../changes.txt:1332 ca97b466331943fbaf5357ca77d105ff msgid "Cope with various changes to MuPDF API." msgstr "" #: ../../../changes.txt:1336 ebefa94d051a413c87fa9a3656dcceda msgid "Fixed various broken links and typos in docs." msgstr "" #: ../../../changes.txt:1337 425cc8bc1fcf4fdaac66e442ee2e5513 msgid "Mention install of `swig-python` on MacOS for #875." msgstr "" #: ../../../changes.txt:1338 7073906d3d64408c836b7d3de96519aa msgid "Added (untested) wheels for macos-arm64." msgstr "" #: ../../../changes.txt:1343 30436208e7954516bb195ab1ea1ed488 msgid "**Changes in Version 1.20.2**" msgstr "" #: ../../../changes.txt:1345 ccf93339cf7245b2820d527e6e093f20 msgid "This release uses ``MuPDF-1.20.3``." msgstr "" #: ../../../changes.txt:1347 e392d8912dbc4a8596ade19a8161d639 msgid "" "**Fixed** `#1787 `_. Fix " "linking issues on Unix systems." msgstr "" #: ../../../changes.txt:1350 4d180eaf011b4a9fbb8c216aa4a505ec msgid "" "**Fixed** `#1824 `_. " "SegFault when applying redactions overlapping a transparent image. (Fixed" " in ``MuPDF-1.20.3``.)" msgstr "" #: ../../../changes.txt:1354 6cb696c83bfc47bbb07c549f1a1f0267 msgid "Improvements to documentation:" msgstr "" #: ../../../changes.txt:1356 0ad4a7a79fe54f24869d872723b404e8 msgid "" "Improved information about building from source in " "``docs/installation.rst``." msgstr "" #: ../../../changes.txt:1357 81117814315f48efbc87955f9a7ef58d msgid "Clarified memory allocation setting ``JM_MEMORY` in ``docs/tools.rst``." msgstr "" #: ../../../changes.txt:1358 b488d65744d743c4b1333dacf311664c msgid "Fixed link to PDF Reference manual in ``docs/app3.rst``." msgstr "" #: ../../../changes.txt:1359 472c19e0e68c4c109bde0bb001020dac msgid "Fixed building of html documentation on OpenBSD." msgstr "" #: ../../../changes.txt:1360 c99ee292bc6c46c686c3cad285701923 msgid "Moved old ``docs/faq.rst`` into separate ``docs/recipes-*`` files." msgstr "" #: ../../../changes.txt:1362 5fed1f452c8f47549032bcab7853bdde msgid "Removed some unused files and directories:" msgstr "" #: ../../../changes.txt:1364 7c310414b4384898a324f2841f54decd msgid "``installation/``" msgstr "" #: ../../../changes.txt:1365 5e5ae4637cb640d19cd1b1a5305c90d8 msgid "``docs/wheelnames.txt``" msgstr "" #: ../../../changes.txt:1368 f4d58a60a4f946a69ea863d1d7d30c62 msgid "**Changes in Version 1.20.1**" msgstr "" #: ../../../changes.txt:1370 23e14128203842beadfff33baa6792ae msgid "" "**Fixed** `#1724 `_. Fix " "for building on FreeBSD." msgstr "" #: ../../../changes.txt:1373 ca0919e2a72b45eca23b6ffabb073f2d msgid "" "**Fixed** `#1771 `_. " "`linkDest()` had a broken call to `re.match()`, introduced in 1.20.0." msgstr "" #: ../../../changes.txt:1376 1acfe9e0464545878372d78884eac896 msgid "" "**Fixed** `#1751 `_. " "`get_drawings()` and `get_cdrawings()` previously always returned with " "`closePath=False`." msgstr "" #: ../../../changes.txt:1379 b1c751d4d6b249f7b1603c75f54e6948 msgid "" "**Fixed** `#1645 `_. " "Default FreeText annotation text color is now black." msgstr "" #: ../../../changes.txt:1382 f7bb3767b4b546a8921290a547e0cf50 msgid "Improvements to sphinx-generated documentation:" msgstr "" #: ../../../changes.txt:1384 a5a5cb7bebe241279daf65c0700e6d10 msgid "Use readthedocs theme with enhancements." msgstr "" #: ../../../changes.txt:1385 d06c9bab26ef40449327e0f849c88152 msgid "Renamed the `.txt` files to have `.rst` suffixes." msgstr "" #: ../../../changes.txt:1389 7af006a5c3a84b03914bc4dcb23055ef msgid "**Changes in Version 1.20.0**" msgstr "" #: ../../../changes.txt:1391 c5bccf72f35e4edf807800d879e696ff msgid "This release uses ``MuPDF-1.20.0``, released 2022-06-15." msgstr "" #: ../../../changes.txt:1393 68d1b02687f849fab3365ec98f0308d4 msgid "" "Cope with new MuPDF link uri format, changed from ``#,,`` " "to ``#page=&zoom=,,``." msgstr "" #: ../../../changes.txt:1395 d17d731c792044cfa0b4bc0486f4c5a8 msgid "" "In ``tests/test_insertpdf.py``, use new reference output " "``joined-1.20.pdf``. We also check that new output values are " "approximately the same as the old ones." msgstr "" #: ../../../changes.txt:1397 96cbfad0c6cb404db15d7aa8d13c5f65 msgid "" "**Fixed** `#1738 `_. Leak" " of `pdf_graft_map`. Also fixed a SEGV issue that this seemed to expose, " "caused by incorrect freeing of underlying fz_document." msgstr "" #: ../../../changes.txt:1400 a1460a0ec164432ebbe35656a0272c02 msgid "" "**Fixed** `#1733 `_. " "Fixed ownership of `Annotation.get_pixmap()`." msgstr "" #: ../../../changes.txt:1402 1fb8672935f346f18177065d4a876d9b msgid "Changes to build/release process:" msgstr "" #: ../../../changes.txt:1404 d1f37ff28e754e3891af3658a6d2c4f7 msgid "" "If pip builds from source because an appropriate wheel is not available, " "we no longer require MuPDF to be pre-installed. Instead the required " "MuPDF source is embedded in the sdist and automatically built into " "PyMuPDF." msgstr "" #: ../../../changes.txt:1406 c6743d7a837547bfbd14121f922f188b msgid "" "Various changes to ``setup.py`` to download the required MuPDF release as" " required. See comments at start of setup.py for details." msgstr "" #: ../../../changes.txt:1408 2deed3b348e44634a95976500ca61ff1 msgid "" "Added ``.github/workflows/build_wheels.yml`` to control building of " "wheels on Github." msgstr "" #: ../../../changes.txt:1412 bfd2558d12c24e4ba3c0aee0edff3507 msgid "**Changes in Version 1.19.6**" msgstr "" #: ../../../changes.txt:1414 e9b569d9e70b42518f53a71536bd4f28 msgid "" "**Fixed** `#1620 `_. The " ":ref:`TextPage` created by :meth:`Page.get_textpage` will now be freed " "correctly (removed memory leak)." msgstr "" #: ../../../changes.txt:1415 058f760c8ce740e48a627eb2aee78a56 msgid "" "**Fixed** `#1601 `_. " "Document open errors should now be more concise and easier to interpret. " "In the course of this, two PyMuPDF-specific Python exceptions have been " "**added:**" msgstr "" #: ../../../changes.txt:1417 15ef5b12f13b4750a9571bf258d1dd43 msgid "" "``EmptyFileError`` -- raised when trying to create a :ref:`Document` " "(``fitz.open()``) from an empty file or zero-length memory." msgstr "" #: ../../../changes.txt:1418 f1c391fa54a1405ba4a28d352d108404 msgid "" "``FileDataError`` -- raised when MuPDF encounters irrecoverable document " "structure issues." msgstr "" #: ../../../changes.txt:1420 56b2878654114138ac79fad54cecad1b msgid "**Added** :meth:`Page.load_widget` given a PDF field's xref." msgstr "" #: ../../../changes.txt:1422 c0ece2db951a48efac1849cd7074f28e msgid "" "**Added** Dictionary :attr:`pdfcolor` which provide the about 500 colors " "defined as PDF color values with the lower case color name as key." msgstr "" #: ../../../changes.txt:1424 f9628cc364244bf3a41e4b3a8c2d40c6 msgid "" "**Added** algebra functionality to the :ref:`Quad` class. These objects " "can now also be added and subtracted among themselves, and be multiplied " "by numbers and matrices." msgstr "" #: ../../../changes.txt:1426 b66574a55e8d41d7accf7dd33f070642 msgid "" "**Added** new constants defining the default text extraction flags for " "more comfortable handling. Their naming convention is like " ":data:`TEXTFLAGS_WORDS` for ``page.get_text(\"words\")``. See " ":ref:`text_extraction_flags`." msgstr "" #: ../../../changes.txt:1428 8f6f15bc876b4df68cda93624b20a4ea msgid "" "**Changed** :meth:`Page.annots` and :meth:`Page.widgets` to detect and " "prevent reloading the page (illegally) inside the iterator loops via " ":meth:`Document.reload_page`. Doing this brings down the interpreter. " "Documented clean ways to do annotation and widget mass updates within " "properly designed loops." msgstr "" #: ../../../changes.txt:1430 287feb6044a2402d9651e9690ee78512 msgid "" "**Changed** several internal utility functions to become standalone " "(\"SWIG inline\") as opposed to be part of the :ref:`Tools` class. This, " "among other things, increases the performance of geometry object " "creation." msgstr "" #: ../../../changes.txt:1432 ec2b054b07e449debcbc15b510c35e5e msgid "" "**Changed** :meth:`Document.update_stream` to always accept stream " "updates - whether or not the dictionary object behind the xref already is" " a stream. Thus the former ``new`` parameter is now ignored and will be " "removed in v1.20.0." msgstr "" #: ../../../changes.txt:1437 89534acd0d50489793f84d93defb75d9 msgid "**Changes in Version 1.19.5**" msgstr "" #: ../../../changes.txt:1439 15c312e55ff84d4990200b73b5ab7088 msgid "" "**Fixed** `#1518 `_. A " "limited \"fix\": in some cases, rectangles and quadrupels were not " "correctly encoded to support re-drawing by :ref:`Shape`." msgstr "" #: ../../../changes.txt:1441 4ba09954c0b641a2926f1026d979da09 msgid "" "**Fixed** `#1521 `_. This" " had the same ultimate reason behind issue #1510." msgstr "" #: ../../../changes.txt:1443 dde5fa3810eb4a82b0aa2e61d8cf863b msgid "" "**Fixed** `#1513 `_. Some" " Optional Content functions did not support non-ASCII characters." msgstr "" #: ../../../changes.txt:1445 3d2e4740ec0b41b4aaad51d97655f8e9 msgid "" "**Fixed** `#1510 `_. " "Support more soft-mask image subtypes." msgstr "" #: ../../../changes.txt:1447 e79ebb09f5ea405a8ed23fbed6aa913a msgid "" "**Fixed** `#1507 `_. " "Immunize against items in the outlines chain, that are ``\"null\"`` " "objects." msgstr "" #: ../../../changes.txt:1449 cd737a2d921f4ee6929d54d756b3ca78 msgid "" "**Fixed** re-opened `#1417 " "`_. (\"too many open " "files\"). This was due to insufficient calls to MuPDF's " "``fz_drop_document()``. This also fixes `#1550 " "`_." msgstr "" #: ../../../changes.txt:1451 10995303e588406895c48eaa98334bdd msgid "" "**Fixed** several undocumented issues in relation to incorrectly setting " "the text span origin :data:`point_like`." msgstr "" #: ../../../changes.txt:1453 c395df4c98a441958d507eaf1a55d6de msgid "" "**Fixed** undocumented error computing the character bbox in method " ":meth:`Page.get_texttrace` when text is **flipped** (as opposed to just " "rotated)." msgstr "" #: ../../../changes.txt:1455 d82b9d2a17b64ddb90e236a9e42f1420 msgid "" "**Added** items to the dictionary returned by :meth:`image_properties`: " "``orientation`` and ``transform`` report the natural image orientation " "(EXIF data)." msgstr "" #: ../../../changes.txt:1457 30117ed837094556807bb67193004816 msgid "" "**Added** method :meth:`Document.xref_copy`. It will make a given target " "PDF object an exact copy of a source object." msgstr "" #: ../../../changes.txt:1462 c6cda05060f04f1080faf3f5125286a2 msgid "**Changes in Version 1.19.4**" msgstr "" #: ../../../changes.txt:1465 b2517533bd4f4096af88ca08d40edf65 msgid "" "**Fixed** `#1505 `_. " "Immunize against circular outline items." msgstr "" #: ../../../changes.txt:1467 a0d1479b30084068bad49749240fac45 msgid "" "**Fixed** `#1484 `_. " "Correct CropBox coordinates are now returned in all situations." msgstr "" #: ../../../changes.txt:1469 cf4a7ec57222449f974ef9027151cf36 msgid "**Fixed** `#1479 `_." msgstr "" #: ../../../changes.txt:1471 89d3111a652d4fe8809050d5c921e6ea msgid "" "**Fixed** `#1474 `_. " "TextPage objects are now properly deleted again." msgstr "" #: ../../../changes.txt:1473 ae6c28903fab4ede991daa53cbb1c7b1 msgid "" "**Added** :ref:`Page` methods and attributes for PDF ``/ArtBox``, " "``/BleedBox``, ``/TrimBox``." msgstr "" #: ../../../changes.txt:1475 d88880cbc50841bfa7c2c78158e9dd46 msgid "" "**Added** global attribute :attr:`TESSDATA_PREFIX` for easy checking of " "OCR support." msgstr "" #: ../../../changes.txt:1477 2be427b5e13c407995bd4f89c694dada msgid "" "**Changed** :meth:`Document.xref_set_key` such that dictionary keys will " "physically be removed if set to value ``\"null\"``." msgstr "" #: ../../../changes.txt:1479 2a9573afceb049e6b671e0432bd529be msgid "" "**Changed** :meth:`Document.extract_font` to optionally return a " "dictionary (instead of a tuple)." msgstr "" #: ../../../changes.txt:1483 4f57093fd45345639ada517bdde872fb msgid "**Changes in Version 1.19.3**" msgstr "" #: ../../../changes.txt:1485 18dfed128cbf40c38cad3ea42fd28a79 msgid "" "This patch version implements minor improvements for :ref:`Pixmap` and " "also some important fixes." msgstr "" #: ../../../changes.txt:1487 1296ee8815a942b6b05e865c50765b3b msgid "" "**Fixed** `#1351 `_." " Reverted code that introduced the memory growth in v1.18.15." msgstr "" #: ../../../changes.txt:1489 3fb4097c0d9c45d884b47f003b15344b msgid "" "**Fixed** `#1417 `_." " Developed circumvention for growth of open file handles using " ":meth:`Document.insert_pdf`." msgstr "" #: ../../../changes.txt:1491 770e6646f6e74afcb2d4d3dcf9c81366 msgid "" "**Fixed** `#1418 `_." " Developed circumvention for memory growth using " ":meth:`Document.insert_pdf`." msgstr "" #: ../../../changes.txt:1493 9689f4e9544c4246b896448b2322a17e msgid "" "**Fixed** `#1430 `_." " Developed circumvention for mass pixmap generations of document pages." msgstr "" #: ../../../changes.txt:1495 056b81d61e89402fb676e8fa87a24efc msgid "" "**Fixed** `#1433 `_." " Solves a bbox error for some Type 3 font in PyMuPDF text processing." msgstr "" #: ../../../changes.txt:1497 d99a708337c94a539ed17294cc959f0d msgid "" "**Added** :meth:`Pixmap.color_topusage` to determine the share of the " "most frequently used color. Solves `#1397 " "`_." msgstr "" #: ../../../changes.txt:1499 72e87358c82b4604b24eac87ac4b4a0f msgid "" "**Added** :meth:`Pixmap.warp` which makes a new pixmap from a given " "arbitrary convex quad inside the pixmap." msgstr "" #: ../../../changes.txt:1501 82fcb8b930d84658abdd8396247c78de msgid "" "**Added** :attr:`Annot.irt_xref` and :meth:`Annot.set_irt_xref` to " "inquire or set the `/IRT` (\"In Response To\") property of an annotation." " Implements `#1450 " "`_." msgstr "" #: ../../../changes.txt:1503 9d4d189ab5d14fb799a720844599254d msgid "" "**Added** :meth:`Rect.torect` and :meth:`IRect.torect` which compute a " "matrix that transforms to a given other rectangle." msgstr "" #: ../../../changes.txt:1505 4efbe89603de46a59e1fac42a1a66f6a msgid "" "**Changed** :meth:`Pixmap.color_count` to also return the count of each " "color." msgstr "" #: ../../../changes.txt:1506 d98f12929cce4021be5db663b7606192 msgid "" "**Changed** :meth:`Page.get_texttrace` to also return correct span and " "character bboxes if ``span[\"dir\"] != (1, 0)``." msgstr "" #: ../../../changes.txt:1510 d093ad5f399047259588e551285fd994 msgid "**Changes in Version 1.19.2**" msgstr "" #: ../../../changes.txt:1512 2de7c1c23ba441aa92a089ee02a4635b msgid "" "This patch version implements minor improvements for " ":meth:`Page.get_drawings` and also some important fixes." msgstr "" #: ../../../changes.txt:1514 79ddabf469564139b54099c248dbd2b3 msgid "" "**Fixed** `#1388 `_." " Fixed intermittent memory corruption when insert or updating " "annotations." msgstr "" #: ../../../changes.txt:1516 3f76bb3657c5462ba1ebcdd58bdd3116 msgid "" "**Fixed** `#1375 `_." " Inconsistencies between line numbers as returned by the \"words\" and " "the \"dict\" options of :meth:`Page.get_text` have been corrected." msgstr "" #: ../../../changes.txt:1518 da3c5e5c691b4bf89bac0ae41797880b msgid "" "**Fixed** `#1364 `_. The " "check for being a ``\"rawdict\"`` span in :meth:`recover_span_quad` now " "works correctly." msgstr "" #: ../../../changes.txt:1520 63807063fb894a7e983829cafe298fe5 msgid "" "**Fixed** `#1342 `_. " "Corrected the check for rectangle infiniteness in " ":meth:`Page.show_pdf_page`." msgstr "" #: ../../../changes.txt:1522 517a112dc4114acab7f4f5c1b91d6fa8 msgid "" "**Changed** :meth:`Page.get_drawings`, :meth:`Page.get_cdrawings` to " "return an indicator on the area orientation covered by a rectangle. This " "implements `#1355 `_. " "Also, the recognition rate for rectangles and quads has been " "significantly improved." msgstr "" #: ../../../changes.txt:1524 dcddfb46c54741fd8eda15a642648605 msgid "" "**Changed** all text search and extraction methods to set the new " "``flags`` option ``TEXT_MEDIABOX_CLIP`` to ON by default. That bit causes" " the automatic suppression of all characters that are completely outside " "a page's mediabox (in as far as that notion is supported for a document " "type). This eliminates the need for using ``clip=page.rect`` or similar " "for omitting text outside the visible area." msgstr "" #: ../../../changes.txt:1526 f1b34d7957c44c178eece4e7a6585117 msgid "" "**Added** parameter ``\"dpi\"`` to :meth:`Page.get_pixmap` and " ":meth:`Annot.get_pixmap`. When given, parameter ``\"matrix\"`` is " "ignored, and a :ref:`Pixmap` with the desired dots per inch is created." msgstr "" #: ../../../changes.txt:1528 1317c20bf9004475b5d9e6eff7531e6d msgid "" "**Added** attributes :attr:`Pixmap.is_monochrome` and " ":attr:`Pixmap.is_unicolor` allowing fast checks of pixmap properties. " "Addresses `#1397 `_." msgstr "" #: ../../../changes.txt:1530 2f34d297248a424d9e4bd6390d4abd59 msgid "" "**Added** method :meth:`Pixmap.color_count` to determine the unique " "colors in the pixmap." msgstr "" #: ../../../changes.txt:1532 0eb08456d2ad4e70b01c79a2c2394012 msgid "" "**Added** boolean parameter ``\"compress\"`` to PDF document method " ":meth:`Document.update_stream`. Addresses / enables solution for `#1408 " "`_." msgstr "" #: ../../../changes.txt:1536 e801177ed48145dda1d2c1383f2b0ffc msgid "**Changes in Version 1.19.1**" msgstr "" #: ../../../changes.txt:1538 57c5fb9887f847ba933543ad12d8a479 msgid "" "This is the first patch version to support MuPDF v1.19.0. Apart from one " "bug fix, it includes important improvements for OCR support and the " "option to **sort extracted text** to the standard reading order \"from " "top-left to bottom-right\"." msgstr "" #: ../../../changes.txt:1540 650b810759ce426fb04200ced720f29f msgid "" "**Fixed** `#1328 `_. " "\"words\" text extraction again returns correct ``(x0, y0)`` coordinates." msgstr "" #: ../../../changes.txt:1542 3ba1314a889d44d78998ee7e4000e490 msgid "" "**Changed** :meth:`Page.get_textpage_ocr`: it now supports parameter " "``dpi`` to control OCR quality. It is also possible to choose whether the" " **full page** should be OCRed or **only the images displayed** by the " "page." msgstr "" #: ../../../changes.txt:1544 e63faaa903ec48a596466ba7c81be36a msgid "" "**Changed** :meth:`Page.get_drawings` and :meth:`Page.get_cdrawings` to " "automatically convert colors to RGB color tuples. Implements `#1332 " "`_. Similar change " "was applied to :meth:`Page.get_texttrace`." msgstr "" #: ../../../changes.txt:1546 478ae75188fb496dbd68e612249a93be msgid "" "**Changed** :meth:`Page.get_text` to support a parameter ``sort``. If set" " to ``True`` the output is conveniently sorted." msgstr "" #: ../../../changes.txt:1551 1fcee4618b1a4606bc1bb1cb00a3c04c msgid "**Changes in Version 1.19.0**" msgstr "" #: ../../../changes.txt:1553 ddc73ab2354e49519073ae9c706da26e msgid "" "This is the first version supporting MuPDF 1.19.*, published 2021-10-05. " "It introduces many new features compared to the previous version 1.18.*." msgstr "" #: ../../../changes.txt:1555 b350897b3a7d4af6a0a1184d0161e9f5 msgid "" "PyMuPDF has now picked up integrated Tesseract OCR support, which was " "already present in MuPDF v1.18.0." msgstr "" #: ../../../changes.txt:1557 35dd462d0329459bb8788ee6118ce5b5 msgid "" "Supported images can be OCRed via their :ref:`Pixmap` which results in a " "1-page PDF with a text layer." msgstr "" #: ../../../changes.txt:1558 40eb6a6a0deb477f802cfaa332cd816d msgid "" "All supported document pages (i.e. not only PDFs), can be OCRed using " "specialized text extraction methods. The result is a mixture of standard " "and OCR text (depending on which part of the page was deemed to require " "OCRing) that can be searched and extracted without restrictions." msgstr "" #: ../../../changes.txt:1559 734f1859407e4513b2cad5b0b02ac6f4 msgid "" "All this requires an independent installation of Tesseract. MuPDF " "actually (only) needs the location of Tesseract's ``\"tessdata\"`` " "folder, where its language support data are stored. This location must be" " available as environment variable ``TESSDATA_PREFIX``." msgstr "" #: ../../../changes.txt:1561 b0bd5ab69f33429697fd89f94ea87403 msgid "" "A new MuPDF feature is **journalling PDF updates**, which is also " "supported by this PyMuPDF version. Changes may be logged, rolled back or " "replayed, allowing to implement a whole new level of control over PDF " "document integrity -- similar to functions present in modern database " "systems." msgstr "" #: ../../../changes.txt:1563 c3bc9664f319416cbfbd764f183ecaf1 msgid "" "A third feature (unrelated to the new MuPDF version) includes the ability" " to detect when page **objects cover or hide each other**. It is now e.g." " possible to see that text is covered by a drawing or an image." msgstr "" #: ../../../changes.txt:1565 368ec08cb31e489e94e2d8a7e4ee86e4 msgid "" "**Changed** terminology and meaning of important geometry concepts: " "Rectangles are now characterized as *finite*, *valid* or *empty*, while " "the definitions of these terms have also changed. Rectangles specifically" " are now thought of being \"open\": not all corners and sides are " "considered part of the rectangle. Please do read the :ref:`Rect` section " "for details." msgstr "" #: ../../../changes.txt:1567 6dd7d23a06ad4f14b2021126e1286e49 msgid "" "**Added** new parameter `\"no_new_id\"` to :meth:`Document.save` / " ":meth:`Document.tobytes` methods. Use it to suppress updating the second " "item of the document ``/ID`` which in PDF indicates that the original " "file has been updated. If the PDF has no ``/ID`` at all yet, then no new " "one will be created either." msgstr "" #: ../../../changes.txt:1569 de9906d677934e3c8dbe4a106dce7c74 msgid "" "**Added** a **journalling facility** for PDF updates. This allows logging" " changes, undoing or redoing them, or saving the journal for later use. " "Refer to :meth:`Document.journal_enable` and friends." msgstr "" #: ../../../changes.txt:1571 c4160924dc184c4b927a1b6297223458 msgid "" "**Added** new :ref:`Pixmap` methods :meth:`Pixmap.pdfocr_save` and " ":meth:`Pixmap.pdfocr_tobytes`, which generate a 1-page PDF containing the" " pixmap as PNG image with OCR text layer." msgstr "" #: ../../../changes.txt:1573 0e3c62d627264d9f8ffce673e0023b81 msgid "" "**Added** :meth:`Page.get_textpage_ocr` which executes optical character " "recognition for the page, then extracts the results and stores them " "together with \"normal\" page content in a :ref:`TextPage`. Use or reuse " "this object in subsequent text extractions and text searches to avoid " "multiple efforts. The existing text search and text extraction methods " "have been extended to support a separately created textpage -- see next " "item." msgstr "" #: ../../../changes.txt:1575 04ef1d300161437ba5b4e28ffed12386 msgid "" "**Added** a new parameter ``textpage`` to text extraction and text search" " methods. This allows reuse of a previously created :ref:`TextPage` and " "thus achieves significant runtime benefits -- which is especially " "important for the new OCR features. But \"normal\" text extractions can " "definitely also benefit." msgstr "" #: ../../../changes.txt:1577 a6d0664ee9d14b07908e08d426ef50e7 msgid "" "**Added** :meth:`Page.get_texttrace`, a technical method delivering low-" "level text character properties. It was present before as a private " "method, but the author felt it now is mature enough to be officially " "available. It specifically includes a \"sequence number\" which indicates" " the page appearance build operation that painted the text." msgstr "" #: ../../../changes.txt:1579 ccb6adfad05549ff96a7d75a2f08de75 msgid "" "**Added** :meth:`Page.get_bboxlog` which delivers the list of rectangles " "of page objects like text, images or drawings. Its significance lies in " "its sequence: rectangles intersecting areas with a lower index are " "covering or hiding them." msgstr "" #: ../../../changes.txt:1581 3edfcd55b842410ab082ab50b80e132f msgid "" "**Changed** methods :meth:`Page.get_drawings` and " ":meth:`Page.get_cdrawings` to include a \"sequence number\" indicating " "the page appearance build operation that created the drawing." msgstr "" #: ../../../changes.txt:1583 d4fd7415a1f44eb0b738d6f5df0af7cb msgid "" "**Fixed** `#1311 `_. " "Field values in comboboxes should now be handled correctly." msgstr "" #: ../../../changes.txt:1584 7733dd257974437aa148b45f6ada6568 msgid "" "**Fixed** `#1290 `_. " "Error was caused by incorrect rectangle emptiness check, which is fixed " "due to new geometry logic of this version." msgstr "" #: ../../../changes.txt:1585 f61c1c44cead4da28d5a0d498a515a7c msgid "" "**Fixed** `#1286 `_. Text" " alignment for redact annotations is working again." msgstr "" #: ../../../changes.txt:1586 bba07d14226e43b498663a99b03b7eb5 msgid "" "**Fixed** `#1287 `_. " "Infinite loop issue for non-Windows systems when applying some redactions" " has been resolved." msgstr "" #: ../../../changes.txt:1587 5324927b491340e983434647e41ce37e msgid "" "**Fixed** `#1284 `_. Text" " layout destruction after applying redactions in some cases has been " "resolved." msgstr "" #: ../../../changes.txt:1591 29ec5f63fdcc4f7b857449ced614ae34 msgid "**Changes in Version 1.18.18 / 1.18.19**" msgstr "" #: ../../../changes.txt:1593 629737c065e9445f96330c435e44d4dc msgid "" "**Fixed** issue `#1266 " "`_. Failure to set " ":attr:`Pixmap.samples` in important cases, was hotfixed in a new version " "1.18.19." msgstr "" #: ../../../changes.txt:1595 0abe968e8c8349d6991a7e4002c7cc03 msgid "" "**Fixed** issue `#1257 " "`_. Removing the read-" "only flag from PDF fields is now possible." msgstr "" #: ../../../changes.txt:1597 d5ee064120c44b55a574eb82a9b65093 msgid "" "**Fixed** issue `#1252 " "`_. Now correctly " "specifying the ``zoom`` value for PDF link annotations." msgstr "" #: ../../../changes.txt:1599 a7183e1808424b69a1a92a0c6c19251d msgid "" "**Fixed** issue `#1244 " "`_. Now correctly " "computing the transform matrix in :meth:`Page.get_image__bbox`." msgstr "" #: ../../../changes.txt:1601 5b909b03e5e84a92b114914838261915 msgid "" "**Fixed** issue `#1241 " "`_. Prevent returning " "artifact characters in :meth:`Page.get_textbox`, which happened in " "certain constellations." msgstr "" #: ../../../changes.txt:1603 76b7202d83754586a167674467627ca6 msgid "" "**Fixed** issue `#1234 " "`_. Avoid creating " "infinite rectangles in corner cases -- :meth:`Page.get_drawings`, " ":meth:`Page.get_cdrawings`." msgstr "" #: ../../../changes.txt:1605 11277e7c50c84168b89d7c869c0aeb1e msgid "" "**Added** test data and test scripts to the source PyPI source " "distribution." msgstr "" #: ../../../changes.txt:1609 490bf1a121f24135b3e3256666187363 msgid "**Changes in Version 1.18.17**" msgstr "" #: ../../../changes.txt:1611 d1e131b0d646485daf1c919e31b766d3 msgid "" "Focus of this version are major performance improvements of selected " "functions." msgstr "" #: ../../../changes.txt:1613 03ea6bb0f78c4d679bd6c08b450d9c4e msgid "" "**Fixed** issue `#1199 " "`_. Using a non-existing " "page number in :meth:`Document.get_page_images` and friends will no " "longer lead to segfaults." msgstr "" #: ../../../changes.txt:1615 0316ddf4a6a14b918ae314d88765508c msgid "" "**Changed** :meth:`Page.get_drawings` to now differentiate between " "\"stroke\", \"fill\" and combined paths. Paths containing more than one " "rectangle (i.e. \"re\" items) are now supported. Extracting \"clipped\" " "paths is now available as an option." msgstr "" #: ../../../changes.txt:1617 68269b90e4374ece9bcc4beae2a5d8ab msgid "" "**Added** :meth:`Page.get_cdrawings`, performance-optimized version of " ":meth:`Page.get_drawings`." msgstr "" #: ../../../changes.txt:1619 b9fdb8798cef43d6af0ab313e6117152 msgid "" "**Added** :attr:`Pixmap.samples_mv`, *memoryview* of a pixmap's pixel " "area. Does not copy and thus always accesses the current state of that " "area." msgstr "" #: ../../../changes.txt:1621 b4530586fbcc46de94110b7f601c43dd msgid "" "**Added** :attr:`Pixmap.samples_ptr`, Python \"pointer\" to a pixmap's " "pixel area. Allows much faster creation (factor 800+) of Qt images." msgstr "" #: ../../../changes.txt:1627 494c735b3a214b2bb172c9afb76b92b1 msgid "**Changes in Version 1.18.16**" msgstr "" #: ../../../changes.txt:1629 9320ef32a6ec458db091ec9991261f2f msgid "" "**Fixed** issue `#1184 " "`_. Existing PDF widget " "fonts in a PDF are now accepted (i.e. not forcedly changed to a Base-14 " "font)." msgstr "" #: ../../../changes.txt:1631 159b6408c2ea4b86a063f21fcce0b7de msgid "" "**Fixed** issue `#1154 " "`_. Text search hits " "should now be correct when ``clip`` is specified." msgstr "" #: ../../../changes.txt:1633 e98ab6e601d143ab99e23ce8ac756e25 msgid "**Fixed** issue `#1152 `_." msgstr "" #: ../../../changes.txt:1635 0793a7276f6a47c7833dc4f02c69c59c msgid "**Fixed** issue `#1146 `_." msgstr "" #: ../../../changes.txt:1637 634669f89d54425fabf3395cef374ae3 msgid "" "**Added** :attr:`Link.flags` and :meth:`Link.set_flags` to the " ":ref:`Link` class. Implements enhancement requests `#1187 " "`_." msgstr "" #: ../../../changes.txt:1639 f0c43b248f16409a8f0905afee41db5d msgid "" "**Added** option to *simulate* :meth:`TextWriter.fill_textbox` output for" " predicting the number of lines, that a given text would occupy in the " "textbox." msgstr "" #: ../../../changes.txt:1641 7ed434aeca7e4c8283c2ce9ac764e204 msgid "" "**Added** text output support as subcommand `gettext` to the ``fitz`` CLI" " module. Most importantly, original **physical text layout** reproduction" " is now supported." msgstr "" #: ../../../changes.txt:1646 7a61839613704cb6ba89df11cfd8e0c5 msgid "**Changes in Version 1.18.15**" msgstr "" #: ../../../changes.txt:1648 76b9d70df76946379cb92b397413d1b1 msgid "" "**Fixed** issue `#1088 " "`_. Removing an " "annotation's fill color should now work again both ways, using the " "``fill_color=[]`` argument in :meth:`Annot.update` as well as ``fill=[]``" " in :meth:`Annot.set_colors`." msgstr "" #: ../../../changes.txt:1650 be8edc4369ba4c6d92c42fd279c10a37 msgid "" "**Fixed** issue `#1081 " "`_. " ":meth:`Document.subset_fonts`: fixed an error which created wrong " "character widths for some fonts." msgstr "" #: ../../../changes.txt:1652 c86ec8d5f336461a9a82cf58dab23bca msgid "" "**Fixed** issue `#1078 " "`_. :meth:`Page.get_text`" " and other methods related to text extraction: changed the default value " "of the :ref:`TextPage` ``flags`` parameter. All whitespace and " ":data:`ligatures` are now preserved." msgstr "" #: ../../../changes.txt:1654 6bf853d1b4f24ed3b493acbbaf102307 msgid "" "**Fixed** issue `#1085 " "`_. The old *snake_cased*" " alias of ``fitz.detTextlength`` is now defined correctly." msgstr "" #: ../../../changes.txt:1656 0974e8722a4445e0894e2188d5074069 msgid "" "**Changed** :meth:`Document.subset_fonts` will now correctly prefix font " "subsets with an appropriate six letter uppercase tag, complying with the " "PDF specification." msgstr "" #: ../../../changes.txt:1658 437884a2beb34834be5a5813ff146205 msgid "" "**Added** new method :meth:`Widget.button_states` which returns the " "possible values that a button-type field can have when being set to " "\"on\" or \"off\"." msgstr "" #: ../../../changes.txt:1660 e165a6b51c0c42f6ac55bb2164ed36ce msgid "" "**Added** support of text with **Small Capital** letters to the " ":ref:`Font` and :ref:`TextWriter` classes. This is reflected by an " "additional bool parameter ``small_caps`` in various of their methods." msgstr "" #: ../../../changes.txt:1665 5fa6df6719ec4a30bc5737a2250ddf26 msgid "**Changes in Version 1.18.14**" msgstr "" #: ../../../changes.txt:1667 246831ba1ef247c09cc05eb90a12135b msgid "" "**Finished** implementing new, \"snake_cased\" names for methods and " "properties, that were \"camelCased\" and awkward in many aspects. At the " "end of this documentation, there is section :ref:`Deprecated` with more " "background and a mapping of old to new names." msgstr "" #: ../../../changes.txt:1669 e9896e6c30074ac28de21b72e13344fd msgid "" "**Fixed** issue `#1053 " "`_. " ":meth:`Page.insert_image`: when given, include image mask in the hash " "computation." msgstr "" #: ../../../changes.txt:1671 856342d7e04c4c05ad362a20f30a00c5 msgid "" "**Fixed** issue `#1043 " "`_. Added " "``Pixmap.getPNGdata`` to the aliases of :meth:`Pixmap.tobytes`." msgstr "" #: ../../../changes.txt:1673 a40ac7bfdd1d4c329450f6a5ba99872e msgid "" "**Fixed** an internal error when computing the enveloping rectangle of " "drawn paths as returned by :meth:`Page.get_drawings`." msgstr "" #: ../../../changes.txt:1675 dae13ebf211f48aaa0f6305a01c8c616 msgid "" "**Fixed** an internal error occasionally causing loops when outputting " "text via :meth:`TextWriter.fill_textbox`." msgstr "" #: ../../../changes.txt:1677 944833cd11d14508b1e6e8fa1a487586 msgid "" "**Added** :meth:`Font.char_lengths`, which returns a tuple of character " "widths of a string." msgstr "" #: ../../../changes.txt:1679 4c127faaaa4542d68be1974e72156cdb msgid "" "**Added** more ways to specify pages in :meth:`Document.delete_pages`. " "Now a sequence (list, tuple or range) can be specified, and the Python " "``del`` statement can be used. In the latter case, Python ``slices`` are " "also accepted." msgstr "" #: ../../../changes.txt:1681 06fd838ceb61465d9f689dfd3aebbab2 msgid "" "**Changed** :meth:`Document.del_toc_item`, which disables a single item " "of the TOC: previously, the title text was removed. Instead, now the " "complete item will be shown grayed-out by supporting viewers." msgstr "" #: ../../../changes.txt:1686 7a4fd8bb15ab4fbcaaa183993d721089 msgid "**Changes in Version 1.18.13**" msgstr "" #: ../../../changes.txt:1688 aeb68fdb27db43d68f6b5362aa749391 msgid "**Fixed** issue `#1014 `_." msgstr "" #: ../../../changes.txt:1689 8ee7d51d2b5941f8b64a7092fe06f789 msgid "" "**Fixed** an internal memory leak when computing image bboxes -- " ":meth:`Page.get_image_bbox`." msgstr "" #: ../../../changes.txt:1690 6e3c2aaf0d0b4752b02aa8c91326937e msgid "" "**Added** support for low-level access and modification of the PDF " "trailer. Applies to :meth:`Document.xref_get_keys`, " ":meth:`Document.xref_get_key`, and :meth:`Document.xref_set_key`." msgstr "" #: ../../../changes.txt:1691 d26b610465374b1a95f57d151f841d2e msgid "**Added** documentation for maintaining private entries in PDF metadata." msgstr "" #: ../../../changes.txt:1692 49f75a7ada254386acc0d8b341ed91c6 msgid "" "**Added** documentation for handling transparent image insertions, " ":meth:`Page.insert_image`." msgstr "" #: ../../../changes.txt:1693 457c2b1325b24f60ab107fe02a4e0085 msgid "" "**Added** :meth:`Page.get_image_rects`, an improved version of " ":meth:`Page.get_image_bbox`." msgstr "" #: ../../../changes.txt:1694 a7471bfaf29b46c0bf1baba965058c8b msgid "" "**Changed** :meth:`Document.delete_pages` to support various ways of " "specifying pages to delete. Implements `#1042 " "`_." msgstr "" #: ../../../changes.txt:1695 3f2e525e5db5466cbf2b21ae6e3e9c36 msgid "" "**Changed** :meth:`Page.insert_image` to also accept the xref of an " "existing image in the file. This allows \"copying\" images between pages," " and extremely fast multiple insertions." msgstr "" #: ../../../changes.txt:1696 819681238cbc4a129e57b370dfb026fc msgid "" "**Changed** :meth:`Page.insert_image` to also accept the integer " "parameter ``alpha``. To be used for performance improvements." msgstr "" #: ../../../changes.txt:1697 43b014e80e8041ce88847b0848cd3523 msgid "" "**Changed** :meth:`Pixmap.set_alpha` to support new parameters for pre-" "multiplying colors with their alpha values and setting a specific color " "to fully transparent (e.g. white)." msgstr "" #: ../../../changes.txt:1698 d00c4f08df31471e976b37826d70cb1c msgid "" "**Changed** :meth:`Document.embfile_add` to automatically set creation " "and modification date-time. Correspondingly, :meth:`Document.embfile_upd`" " automatically maintains modification date-time (``/ModDate`` PDF key), " "and :meth:`Document.embfile_info` correspondingly reports these data. In " "addition, the embedded file's associated \"collection item\" is included " "via its :data:`xref`. This supports the development of PDF portfolio " "applications." msgstr "" #: ../../../changes.txt:1702 d6c3f0ac21134173a004ebfa78fe2315 msgid "**Changes in Version 1.18.11 / 1.18.12**" msgstr "" #: ../../../changes.txt:1704 5c6ecd8a73da4cd6a54e60917ddff07a msgid "" "**Fixed** issue `#972 `_. " "Improved layout of source distribution material." msgstr "" #: ../../../changes.txt:1705 086168881dcc4f639364df509a6877b1 msgid "" "**Fixed** issue `#962 `_. " "Stabilized Linux distribution detection for generating PyMuPDF from " "sources." msgstr "" #: ../../../changes.txt:1706 3a60973423d2463aa5423dc31856ba76 msgid "" "**Added:** :meth:`Page.get_xobjects` delivers the result of " ":meth:`Document.get_page_xobjects`." msgstr "" #: ../../../changes.txt:1707 a0b89ac75a28458fb93356628c87d9ab msgid "" "**Added:** :meth:`Page.get_image_info` delivers meta information for all " "images shown on the page." msgstr "" #: ../../../changes.txt:1708 9e865b21aa37414dbfea24ec37e19b67 msgid "" "**Added:** :meth:`Tools.mupdf_display_warnings` allows setting on / off " "the display of MuPDF-generated warnings. The default is off." msgstr "" #: ../../../changes.txt:1709 e3d2420ee8c24d1aa43455c800972e3c msgid "" "**Added:** :meth:`Document.ez_save` convenience alias of " ":meth:`Document.save` with some different defaults." msgstr "" #: ../../../changes.txt:1710 7007006565b94595b23bf039c3e09338 msgid "" "**Changed:** Image extractions of document pages now also contain the " "image's **transformation matrix**. This concerns " ":meth:`Page.get_image_bbox` and the DICT, JSON, RAWDICT, and RAWJSON " "variants of :meth:`Page.get_text`." msgstr "" #: ../../../changes.txt:1715 62af1c5f6b62467897742422e1590f7d msgid "**Changes in Version 1.18.10**" msgstr "" #: ../../../changes.txt:1717 922707d45703479bbd67527180a768ec msgid "" "**Fixed** issue `#941 `_. " "Added old aliases for :meth:`DisplayList.get_pixmap` and " ":meth:`DisplayList.get_textpage`." msgstr "" #: ../../../changes.txt:1718 5f5903a43c1f44a3bf154f3b1530d64a msgid "" "**Fixed** issue `#929 `_. " "Stabilized removal of JavaScript objects with :meth:`Document.scrub`." msgstr "" #: ../../../changes.txt:1719 0972fadf04e741629d46a18515526a9d msgid "" "**Fixed** issue `#927 `_. " "Removed a loop in the reworked :meth:`TextWriter.fill_textbox`." msgstr "" #: ../../../changes.txt:1720 033e96b4eceb4014bd5620c1e986198d msgid "" "**Changed** :meth:`Document.xref_get_keys` and " ":meth:`Document.xref_get_key` to also allow accessing the PDF trailer " "dictionary. This can be done by using `-1` as the xref number argument." msgstr "" #: ../../../changes.txt:1721 74ff56e5727c43138b496604bbfe57f9 msgid "" "**Added** a number of functions for reconstructing the quads for text " "lines, spans and characters extracted by :meth:`Page.get_text` options " "\"dict\" and \"rawdict\". See :meth:`recover_quad` and friends." msgstr "" #: ../../../changes.txt:1722 29aa32686d874d42b22bfa8a3901aa14 msgid "" "**Added** :meth:`Tools.unset_quad_corrections` to suppress character quad" " corrections (occasionally required for erroneous fonts)." msgstr "" #: ../../../changes.txt:1726 3a7453ab65404c52984aee45364e6724 msgid "**Changes in Version 1.18.9**" msgstr "" #: ../../../changes.txt:1729 e1b22c2f9fe54eb993a50fcd6112601f msgid "" "**Fixed** issue `#888 `_. " "Removed ambiguous statements concerning PyMuPDF's license, which is now " "clearly stated to be GNU AGPL V3." msgstr "" #: ../../../changes.txt:1730 f4d998abf2364f48a156cb6de76c69b7 msgid "**Fixed** issue `#895 `_." msgstr "" #: ../../../changes.txt:1731 69b074661fb04a1c9748f0ae259d8153 msgid "" "**Fixed** issue `#896 `_. " "Since v1.17.6 PyMuPDF suppresses the font subset tags and only reports " "the base fontname in text extraction outputs \"dict\" / \"json\" / " "\"rawdict\" / \"rawjson\". Now a new global parameter can request the old" " behaviour, :meth:`Tools.set_subset_fontnames`." msgstr "" #: ../../../changes.txt:1732 0e51b11e295245bdb5143f3055f5f4c6 msgid "" "**Fixed** issue `#885 `_. " "Pixmap creation now also works with filenames given as ``pathlib.Paths``." msgstr "" #: ../../../changes.txt:1733 3bfe043f395249f2ad66c8714a4dcd24 msgid "" "**Changed** :meth:`Document.subset_fonts`: Text is **not rewritten** any " "more and should therefore **retain all its original properties** -- like " "being hidden or being controlled by Optional Content mechanisms." msgstr "" #: ../../../changes.txt:1734 23ad1d2d69494a61b31f3bf6e0d688e0 msgid "" "**Changed** :ref:`TextWriter` output to also accept text in right to left" " mode (Arabian, Hebrew): :meth:`TextWriter.fill_textbox`, " ":meth:`TextWriter.append`. These methods now accept a new boolean " "parameter `right_to_left`, which is *False* by default. Implements `#897 " "`_." msgstr "" #: ../../../changes.txt:1735 27997725f8e4450c87939082e366439e msgid "" "**Changed** :meth:`TextWriter.fill_textbox` to return all lines of text, " "that did not fit in the given rectangle. Also changed the default of the " "``warn`` parameter to no longer print a warning message in overflow " "situations." msgstr "" #: ../../../changes.txt:1736 66e2fd480ef348c094149914650471d0 msgid "" "**Added** a utility function :meth:`recover_quad`, which computes the " "quadrilateral of a span. This function can be used for correctly marking " "text extracted with the \"dict\" or \"rawdict\" options of " ":meth:`Page.get_text`." msgstr "" #: ../../../changes.txt:1740 dce8476d6a3749f89835fc274cdabd84 msgid "**Changes in Version 1.18.8**" msgstr "" #: ../../../changes.txt:1743 fa20b571b5c14e288bfcba7b82655bee msgid "" "This is a bug fix version only. We are publishing early because of the " "potentially widely used functions." msgstr "" #: ../../../changes.txt:1745 21142c13d0cd44bea29198c954e7f0e6 msgid "" "**Fixed** issue `#881 `_. " "Fixed a memory leak in :meth:`Page.insert_image` when inserting images " "from files or memory." msgstr "" #: ../../../changes.txt:1746 5f457acfd5954696ae76970b611ac49a msgid "" "**Fixed** issue `#878 `_. " "``pathlib.Path`` objects should now correctly handle file path " "hierarchies." msgstr "" #: ../../../changes.txt:1751 85971c3fb54e449190448842ef48209a msgid "**Changes in Version 1.18.7**" msgstr "" #: ../../../changes.txt:1754 fbe2287c70d74d55bfa1dd7a61d1a827 msgid "" "**Added** an experimental :meth:`Document.subset_fonts` which reduces the" " size of eligible fonts based on their use by text in the PDF. Implements" " `#855 `_." msgstr "" #: ../../../changes.txt:1755 e300f81c0c2a414a95786dc2a5b922be msgid "" "**Implemented** request `#870 " "`_: " ":meth:`Document.convert_to_pdf` now also supports PDF documents." msgstr "" #: ../../../changes.txt:1756 8b39542efeb8486782751bc4045f8c45 msgid "" "**Renamed** ``Document.write`` to :meth:`Document.tobytes` for greater " "clarity. But the deprecated name remains available for some time." msgstr "" #: ../../../changes.txt:1757 6717eb5a2cfb422a8b239e698e9d1a4e msgid "" "**Implemented** request `#843 " "`_: " ":meth:`Document.tobytes` now supports linearized PDF output. " ":meth:`Document.save` now also supports writing to Python **file " "objects**. In addition, the open function now also supports Python file " "objects." msgstr "" #: ../../../changes.txt:1758 318196b9b9f24559b099a5a3b86b61a3 msgid "**Fixed** issue `#844 `_." msgstr "" #: ../../../changes.txt:1759 22303a902c214152a94cf6908eaada79 msgid "**Fixed** issue `#838 `_." msgstr "" #: ../../../changes.txt:1760 8d1575cb41f944d1ab091d1f15fdfe3f msgid "" "**Fixed** issue `#823 `_. " "More logic for better support of OCRed text output (Tesseract, ABBYY)." msgstr "" #: ../../../changes.txt:1761 938fa234a4d64b4998e755f30a353917 msgid "**Fixed** issue `#818 `_." msgstr "" #: ../../../changes.txt:1762 5b25601056b641bebbe1fdbe9fbf59fc msgid "**Fixed** issue `#814 `_." msgstr "" #: ../../../changes.txt:1763 b4352fd5bf734216a09bc2b65068a9a1 msgid "" "**Added** :meth:`Document.get_page_labels` which returns a list of page " "label definitions of a PDF." msgstr "" #: ../../../changes.txt:1764 d10d74d2add045f19432215b68dc5965 msgid "" "**Added** :meth:`Document.has_annots` and :meth:`Document.has_links` to " "check whether these object types are present anywhere in a PDF." msgstr "" #: ../../../changes.txt:1765 344e56b009634edaa8a7654870785c6a msgid "" "**Added** expert low-level functions to simplify inquiry and modification" " of PDF object sources: :meth:`Document.xref_get_keys` lists the keys of " "object :data:`xref`, :meth:`Document.xref_get_key` returns type and " "content of a key, and :meth:`Document.xref_set_key` modifies the key's " "value." msgstr "" #: ../../../changes.txt:1766 97ffd95b565242c8a475c6f2123f9b83 msgid "" "**Added** parameter ``thumbnails`` to :meth:`Document.scrub` to also " "allow removing page thumbnail images." msgstr "" #: ../../../changes.txt:1767 be54a84b631a4f539269cea4d2530c10 msgid "" "**Improved** documentation for how to add valid text marker annotations " "for non-horizontal text." msgstr "" #: ../../../changes.txt:1769 7ec7306e128341c2a63a9daaf99494bb msgid "" "We continued the process of renaming methods and properties from " "*\"mixedCase\"* to *\"snake_case\"*. Documentation usually mentions the " "new names only, but old, deprecated names remain available for some time." msgstr "" #: ../../../changes.txt:1775 40b8c78ac8154766b3f786804b70d764 msgid "**Changes in Version 1.18.6**" msgstr "" #: ../../../changes.txt:1777 099ac66b71ab437b8f793444fbf3c368 msgid "**Fixed** issue `#812 `_." msgstr "" #: ../../../changes.txt:1778 8d754c7625ba4e16b8b1d2da2931571c msgid "" "**Fixed** issue `#793 `_. " "Invalid document metadata previously prevented opening some documents at " "all. This error has been removed." msgstr "" #: ../../../changes.txt:1779 b6756d8e13654194ae64028173969354 msgid "" "**Fixed** issue `#792 `_. " "Text search and text extraction will make no rectangle containment checks" " at all if the default ``clip=None`` is used." msgstr "" #: ../../../changes.txt:1780 f3374a74399e41139ae1b0fd15053232 msgid "**Fixed** issue `#785 `_." msgstr "" #: ../../../changes.txt:1781 6f0ad41d3e0845679fc1b7f630d9350e msgid "" "**Fixed** issue `#780 `_. " "Corrected a parameter check error." msgstr "" #: ../../../changes.txt:1782 a9af2b2f5b024f1d90aca0eed1eff596 msgid "" "**Fixed** issue `#779 `_. " "Fixed typo" msgstr "" #: ../../../changes.txt:1783 52e2c5d1e3734d0b9c1eafeea70502c0 msgid "" "**Added** an option to set the desired line height for text boxes. " "Implements `#804 `_." msgstr "" #: ../../../changes.txt:1784 8a89dd2499fa4288aa2e4376409bc950 msgid "" "**Changed** text position retrieval to better cope with Tesseract's " "glyphless font. Implements `#803 " "`_." msgstr "" #: ../../../changes.txt:1785 1c3abaa13d464f07839341b87f7b065c msgid "" "**Added** an option to choose the prefix of new annotations, fields and " "links for providing unique annotation ids. Implements request `#807 " "`_." msgstr "" #: ../../../changes.txt:1786 705f241926b94e4faed825b90187d9a8 msgid "" "**Added** getting and setting color and text properties for Table of " "Contents items for PDFs. Implements `#779 " "`_." msgstr "" #: ../../../changes.txt:1787 f290b3e394a643ef92eb166d6ac700ba msgid "" "**Added** PDF page label handling: :meth:`Page.get_label()` returns the " "page label, :meth:`Document.get_page_numbers` return all page numbers " "having a specified label, and :meth:`Document.set_page_labels` adds or " "updates a PDF's page label definition." msgstr "" #: ../../../changes.txt:1792 204e52071aeb4560ad583594170382fc msgid "" "This version introduces **Python type hinting**. The goal is to provide " "each parameter and the return value of all functions and methods with " "type information. This still is work in progress although the majority of" " functions has already been handled." msgstr "" #: ../../../changes.txt:1797 ff861662db5c4fe985c61a23a602d0ab msgid "**Changes in Version 1.18.5**" msgstr "" #: ../../../changes.txt:1799 8972338cdcc14af3a7644a3dcddf69e2 msgid "" "Apart from several fixes, this version also focusses on several minor, " "but important feature improvements. Among the latter is a more precise " "computation of proper line heights and insertion points for writing / " "inserting text. As opposed to using font-agnostic constants, these values" " are now taken from the font's properties." msgstr "" #: ../../../changes.txt:1801 f9a9d31367f946218578af60d466b702 msgid "" "Also note that this is the first version which does no longer provide " "pregenerated wheels for Python versions older than 3.6. PIP also " "discontinues support for these by end of this year 2020." msgstr "" #: ../../../changes.txt:1803 93396822ddee484c904221f0e650bb40 msgid "" "**Fixed** issue `#771 `_. " "By using \"small glyph heights\" option, the full page text can be " "extracted." msgstr "" #: ../../../changes.txt:1804 4283660ecb4e497a8d5f66c223269138 msgid "**Fixed** issue `#768 `_." msgstr "" #: ../../../changes.txt:1805 cb94c9971f18482b8a6116bac1e91eda msgid "**Fixed** issue `#750 `_." msgstr "" #: ../../../changes.txt:1806 0f4ccdc52d33496780a6883b3eac2040 msgid "" "**Fixed** issue `#739 `_. " "The \"dict\", \"rawdict\" and corresponding JSON output variants now have" " two new *span* keys: ``\"ascender\"`` and ``\"descender\"``. These " "floats represent special font properties which can be used to compute " "bboxes of spans or characters of **exactly fontsize height** (as opposed " "to the default line height). An example algorithm is shown in section " "\"Span Dictionary\" `here " "`_. Also improved the " "detection and correction of ill-specified ascender / descender values " "encountered in some fonts." msgstr "" #: ../../../changes.txt:1807 46d09243233b47bfabfb624aabe62a7f msgid "" "**Added** a new, experimental :meth:`Tools.set_small_glyph_heights` -- " "also in response to issue `#739 " "`_. This method sets or " "unsets a global parameter to **always compute bboxes with fontsize " "height**. If \"on\", text searching and all text extractions will " "returned rectangles, bboxes and quads with a smaller height." msgstr "" #: ../../../changes.txt:1808 2348f09c087f4e77a9552300a273b2f9 msgid "**Fixed** issue `#728 `_." msgstr "" #: ../../../changes.txt:1809 24ffb89f8a2847978a993810a34d9d8e msgid "" "**Changed** fill color logic of 'Polyline' annotations: this parameter " "now only pertains to line end symbols -- the annotation itself can no " "longer have a fill color. Also addresses issue `#727 " "`_." msgstr "" #: ../../../changes.txt:1810 d11988b7d91c474394a305026cbdac36 msgid "" "**Changed** :meth:`Page.getImageBbox` to also compute the bbox if the " "image is contained in an XObject." msgstr "" #: ../../../changes.txt:1811 92be2318a74e44bcbfe6d9d124cc6944 msgid "" "**Changed** :meth:`Shape.insertTextbox`, resp. " ":meth:`Page.insertTextbox`, resp. :meth:`TextWriter.fillTextbox` to " "respect font's properties \"ascender\" / \"descender\" when computing " "line height and insertion point. This should no longer lead to line " "overlaps for multi-line output. These methods used to ignore font " "specifics and used constant values instead." msgstr "" #: ../../../changes.txt:1816 726b3c851a2742a08174e040daa6b3fc msgid "**Changes in Version 1.18.4**" msgstr "" #: ../../../changes.txt:1818 0669695e181f46b8b1d1c44f84c7cc1e msgid "" "This version adds several features to support PDF Optional Content. Among" " other things, this includes OCMDs (Optional Content Membership " "Dictionaries) with the full scope of *\"visibility expressions\"* (PDF " "key ``/VE``), text insertions (including the :ref:`TextWriter` class) and" " drawings." msgstr "" #: ../../../changes.txt:1820 298b682a9c8e4b17b5d9c2763ce13305 msgid "" "**Fixed** issue `#727 `_. " "Freetext annotations now support an uncolored rectangle when " "``fill_color=None``." msgstr "" #: ../../../changes.txt:1821 2e4c66207d0441dd87fc8dee4d8db80f msgid "" "**Fixed** issue `#726 `_. " "UTF-8 encoding errors are now handled for HTML / XML :meth:`Page.getText`" " output." msgstr "" #: ../../../changes.txt:1822 e3ea52520ca74100aa5db3c1a47bcb22 msgid "" "**Fixed** issue `#724 `_. " "Empty values are no longer stored in the PDF /Info metadata dictionary." msgstr "" #: ../../../changes.txt:1823 a76c87f209e9404ea2a27260f984c079 msgid "" "**Added** new methods :meth:`Document.set_oc` and :meth:`Document.get_oc`" " to set or get optional content references for **existing** image and " "form XObjects. These methods are similar to the same-named methods of " ":ref:`Annot`." msgstr "" #: ../../../changes.txt:1824 6ae1cf58b5734e2db334370bae53194f msgid "" "**Added** :meth:`Document.set_ocmd`, :meth:`Document.get_ocmd` for " "handling OCMDs." msgstr "" #: ../../../changes.txt:1825 02c47a051f444e57a07a5c2cc00d8ece msgid "**Added** **Optional Content** support for text insertion and drawing." msgstr "" #: ../../../changes.txt:1826 033f5fd3092446d89a8b4be25eaf8fa5 msgid "" "**Added** new method :meth:`Page.deleteWidget`, which deletes a form " "field from a page. This is analogous to deleting annotations." msgstr "" #: ../../../changes.txt:1827 f3f7aabfa367473eb2a71dd0d3b0c8ef msgid "" "**Added** support for Popup annotations. This includes defining the Popup" " rectangle and setting the Popup to open or closed. Methods / attributes " ":meth:`Annot.set_popup`, :meth:`Annot.set_open`, :attr:`Annot.has_popup`," " :attr:`Annot.is_open`, :attr:`Annot.popup_rect`, " ":attr:`Annot.popup_xref`." msgstr "" #: ../../../changes.txt:1831 fff305ae1bfa4fa7a3b33de7de989103 msgid "" "The **naming of methods and attributes** in PyMuPDF is far from being " "satisfactory: we have *CamelCases*, *mixedCases* and " "*lower_case_with_underscores* all over the place. With the :ref:`Annot` " "as the first candidate, we have started an activity to clean this up step" " by step, converting to lower case with underscores for methods and " "attributes while keeping UPPERCASE for the constants." msgstr "" #: ../../../changes.txt:1833 5a5df8a85edd445a9168a3050257beb0 msgid "" "Old names will remain available to prevent code breaks, but they will no " "longer be mentioned in the documentation." msgstr "" #: ../../../changes.txt:1834 d9dd3ce555be40288946b5c7b8684d7d msgid "" "New methods and attributes of all classes will be named according to the " "new standard." msgstr "" #: ../../../changes.txt:1838 8d1aa669d43242329cb1e644baaea966 msgid "**Changes in Version 1.18.3**" msgstr "" #: ../../../changes.txt:1840 0cc7942ae4f54d4698a56df9bcfc4df1 msgid "" "As a major new feature, this version introduces support for PDF's " "**Optional Content** concept." msgstr "" #: ../../../changes.txt:1842 eba5a3b05af340fd8d30d56d8053156a msgid "**Fixed** issue `#714 `_." msgstr "" #: ../../../changes.txt:1843 e0d1304eda394d6a88565ba84484d6fe msgid "**Fixed** issue `#711 `_." msgstr "" #: ../../../changes.txt:1844 bc199ec49e1945f1947218cd0c858828 msgid "" "**Fixed** issue `#707 `_: " "if a PDF user password, but no owner password is supplied nor present, " "then the user password is also used as the owner password." msgstr "" #: ../../../changes.txt:1845 1e99eff725e24f2f91fffda242611187 msgid "" "**Fixed** ``expand`` and ``deflate`` parameters of methods " ":meth:`Document.save` and :meth:`Document.write`. Individual image and " "font compression should now finally work. Addresses issue `#713 " "`_." msgstr "" #: ../../../changes.txt:1846 c7dbcce5af3f4805bc0bff4a3aa999c8 msgid "" "**Added** a support of PDF optional content. This includes several new " ":ref:`Document` methods for inquiring and setting optional content status" " and adding optional content configurations and groups. In addition, " "images, form XObjects and annotations now can be bound to optional " "content specifications. **Resolved** issue `#709 " "`_." msgstr "" #: ../../../changes.txt:1852 7005feac30d44416a7ae56c3c62aa421 msgid "**Changes in Version 1.18.2**" msgstr "" #: ../../../changes.txt:1854 2557dd6711e74c5687da189106d7b072 msgid "" "This version contains some interesting improvements for text searching: " "any number of search hits is now returned and the **hit_max** parameter " "was removed. The new **clip** parameter in addition allows to restrict " "the search area. Searching now detects hyphenations at line breaks and " "accordingly finds hyphenated words." msgstr "" #: ../../../changes.txt:1856 f5a9d7fa7c5b434388c99b444417932e msgid "" "**Fixed** issue `#575 `_: " "if using ``quads=False`` in text searching, then overlapping rectangles " "on the same line are joined. Previously, parts of the search string, " "which belonged to different \"marked content\" items, each generated " "their own rectangle -- just as if occurring on separate lines." msgstr "" #: ../../../changes.txt:1857 fa0f315fcdbb4aa7a85ebd875b0542b2 msgid "" "**Added** :attr:`Document.isRepaired`, which is true if the PDF was " "repaired on open." msgstr "" #: ../../../changes.txt:1858 29939ef23137444db25656ddb5c2a50b msgid "" "**Added** :meth:`Document.setXmlMetadata` which either updates or creates" " PDF XML metadata. Implements issue `#691 " "`_." msgstr "" #: ../../../changes.txt:1859 be99f9d509a84865a76d789e59d88508 msgid "**Added** :meth:`Document.getXmlMetadata` returns PDF XML metadata." msgstr "" #: ../../../changes.txt:1860 b5792e748a424e2f81526972850dbdf9 msgid "" "**Changed** creation of PDF documents: they will now always carry a PDF " "identification (``/ID`` field) in the document trailer. Implements issue " "`#691 `_." msgstr "" #: ../../../changes.txt:1861 66eda59a33aa45ee88d7c201c85dfd3a msgid "" "**Changed** :meth:`Page.searchFor`: a new parameter ``clip`` is accepted " "to restrict the search to this rectangle. Correspondingly, the attribute " ":attr:`TextPage.rect` is now respected by :meth:`TextPage.search`." msgstr "" #: ../../../changes.txt:1862 40efc3861a01468ba0b65c1950845cde msgid "" "**Changed** parameter ``hit_max`` in :meth:`Page.searchFor` and " ":meth:`TextPage.search` is now obsolete: methods will return all hits." msgstr "" #: ../../../changes.txt:1863 52c4e18a02684b35894a335001e4b449 msgid "" "**Changed** character **selection criteria** in :meth:`Page.getText`: a " "character is now considered to be part of a ``clip`` if its bbox is fully" " contained. Before this, a non-empty intersection was sufficient." msgstr "" #: ../../../changes.txt:1864 b05dff665c9644849dfb39e3b881dc36 msgid "" "**Changed** :meth:`Document.scrub` to support a new option " "`redact_images`. This addresses issue `#697 " "`_." msgstr "" #: ../../../changes.txt:1869 dcb97ced9507410d944ce850f20740d7 msgid "**Changes in Version 1.18.1**" msgstr "" #: ../../../changes.txt:1871 ba246f3cc40a4c189c06444a474f03c8 msgid "" "**Fixed** issue `#692 `_. " "PyMuPDF now detects and recovers from more cyclic resource dependencies " "in PDF pages and for the first time reports them in the MuPDF warnings " "store." msgstr "" #: ../../../changes.txt:1872 5ea166e77dfd422487491dc7989ac87b msgid "**Fixed** issue `#686 `_." msgstr "" #: ../../../changes.txt:1873 24c8bae3003740b3b7ef2f1245674d54 msgid "" "**Added** opacity options for the :ref:`Shape` class: Stroke and fill " "colors can now be set to some transparency value. This means that all " ":ref:`Page` draw methods, methods :meth:`Page.insertText`, " ":meth:`Page.insertTextbox`, :meth:`Shape.finish`, " ":meth:`Shape.insertText`, and :meth:`Shape.insertTextbox` support two new" " parameters: *stroke_opacity* and *fill_opacity*." msgstr "" #: ../../../changes.txt:1874 0eab763d4bde434c99750d05c7744be8 msgid "" "**Added** new parameter ``mask`` to :meth:`Page.insertImage` for " "optionally providing an external image mask. Resolves issue `#685 " "`_." msgstr "" #: ../../../changes.txt:1875 d7eb84e2b45346e9805c75ed708951db msgid "" "**Added** :meth:`Annot.soundGet` for extracting the sound of an audio " "annotation." msgstr "" #: ../../../changes.txt:1879 8a1eef562c944225a15aca32aa0a68d0 msgid "**Changes in Version 1.18.0**" msgstr "" #: ../../../changes.txt:1881 f828b2f6db734312b557796ab1a48396 msgid "" "This is the first PyMuPDF version supporting MuPDF v1.18. The focus here " "is on extending PyMuPDF's own functionality -- apart from bug fixing. " "Subsequent PyMuPDF patches may address features new in MuPDF." msgstr "" #: ../../../changes.txt:1883 a9a5a178f719434b9bd31e65ea52f799 msgid "" "**Fixed** issue `#519 `_. " "This upstream bug occurred occasionally for some pages only and seems to " "be fixed now: page layout should no longer be ruined in these cases." msgstr "" #: ../../../changes.txt:1885 532d4ce5429a41979de31fd798876926 msgid "**Fixed** issue `#675 `_." msgstr "" #: ../../../changes.txt:1887 4afda8086e88434b991c90a40f6b3c63 msgid "" "Unsuccessful storage allocations should now always lead to exceptions " "(circumvention of an upstream bug intermittently crashing the " "interpreter)." msgstr "" #: ../../../changes.txt:1888 9b95a7d89275404592c843e6e1a69d20 msgid "" ":ref:`Pixmap` size is now based on ``size_t`` instead of ``int`` in C and" " should be correct even for extremely large pixmaps." msgstr "" #: ../../../changes.txt:1890 50d1e348ab4a420e82ff6163e457c791 msgid "" "**Fixed** issue `#668 `_. " "Specification of dashes for PDF drawing insertion should now correctly " "reflect the PDF spec." msgstr "" #: ../../../changes.txt:1891 e2c585c3927446b58b695299aacefa37 msgid "" "**Fixed** issue `#669 `_. " "A major source of memory leakage in :meth:`Page.insert_pdf` has been " "removed." msgstr "" #: ../../../changes.txt:1892 21f99d039e0b406ba748fa27b51b61ab msgid "" "**Added** keyword *\"images\"* to :meth:`Page.apply_redactions` for fine-" "controlling the handling of images." msgstr "" #: ../../../changes.txt:1893 06f2d99671fb4a4693ac550bbe174f39 msgid "" "**Added** :meth:`Annot.getText` and :meth:`Annot.getTextbox`, which offer" " the same functionality as the :ref:`Page` versions." msgstr "" #: ../../../changes.txt:1894 cc38d6a9295a4baabbe0fa91a8729818 msgid "" "**Added** key *\"number\"* to the block dictionaries of " ":meth:`Page.getText` / :meth:`Annot.getText` for options \"dict\" and " "\"rawdict\"." msgstr "" #: ../../../changes.txt:1895 95b81b00ad5f4f67abab2d83e62fa830 msgid "" "**Added** :meth:`glyph_name_to_unicode` and " ":meth:`unicode_to_glyph_name`. Both functions do not really connect to a " "specific font and are now independently available, too. The data are now " "based on the `Adobe Glyph List `_." msgstr "" #: ../../../changes.txt:1896 3435f8b2d002434ea2961e3bfa9e9ef5 msgid "" "**Added** convenience functions :meth:`adobe_glyph_names` and " ":meth:`adobe_glyph_unicodes` which return the respective available data." msgstr "" #: ../../../changes.txt:1897 46734bcd601a4c10b224d8af13288ece msgid "" "**Added** :meth:`Page.getDrawings` which returns details of drawing " "operations on a document page. Works for all document types." msgstr "" #: ../../../changes.txt:1898 0a520f7de35d43a992a69aaff5c5b428 msgid "" "Improved performance of :meth:`Document.insert_pdf`. Multiple object " "copies are now also suppressed across multiple separate insertions from " "the same source. This saves time, memory and target file size. Previously" " this mechanism was only active within each single method execution. The " "feature can also be suppressed with the new method bool parameter " "*final=1*, which is the default." msgstr "" #: ../../../changes.txt:1899 61af4c935234421da5ee00ff3ad32977 msgid "" "For PNG images created from pixmaps, the resolution (dpi) is now " "automatically set from the respective :attr:`Pixmap.xres` and " ":attr:`Pixmap.yres` values." msgstr "" #: ../../../changes.txt:1904 5787bf266f7743eba6c3ad62840101c8 msgid "**Changes in Version 1.17.7**" msgstr "" #: ../../../changes.txt:1906 fe5734ffddc1440683824cf9eaeb5f6e msgid "" "**Fixed** issue `#651 `_. " "An upstream bug causing interpreter crashes in corner case redaction " "processings was fixed by backporting MuPDF changes from their development" " repo." msgstr "" #: ../../../changes.txt:1907 ebc978213c4446bba6ca783ac6fc99e5 msgid "" "**Fixed** issue `#645 `_. " "Pixmap top-left coordinates can be set (again) by their own method, " ":meth:`Pixmap.set_origin`." msgstr "" #: ../../../changes.txt:1908 28e1c70a439943fb93756b8877d3f067 msgid "" "**Fixed** issue `#622 `_. " ":meth:`Page.insertImage` again accepts a :data:`rect_like` parameter." msgstr "" #: ../../../changes.txt:1909 878ea74492ff47559c0f731484ecd4c7 msgid "" "**Added** several new methods to improve and speed-up table of contents " "(TOC) handling. Among other things, TOC items can now changed or deleted " "individually -- without always replacing the complete TOC. Furthermore, " "access to some PDF page attributes is now possible without first " "**loading** the page. This has a very significant impact on the " "performance of TOC manipulation." msgstr "" #: ../../../changes.txt:1910 4808333e353f4b9d9eb4c65d42a50c6d msgid "" "**Added** an option to :meth:`Document.insert_pdf` which allows " "displaying progress messages. Addresses `#640 " "`_." msgstr "" #: ../../../changes.txt:1911 16de294b58a64f549ba7bd27e208d30b msgid "" "**Added** :meth:`Page.getTextbox` which extracts text contained in a " "rectangle. In many cases, this should obsolete writing your own script " "for this type of thing." msgstr "" #: ../../../changes.txt:1912 9711b2846e2c49f3bb6c283d0b1d9d67 msgid "" "**Added** new ``clip`` parameter to :meth:`Page.getText` to simplify and " "speed up text extraction of page sub areas." msgstr "" #: ../../../changes.txt:1913 8376ab0f05934f11b21f7fe154f09584 msgid "" "**Added** :meth:`TextWriter.appendv` to add text in **vertical write " "mode**. Addresses issue `#653 " "`_" msgstr "" #: ../../../changes.txt:1918 bd8548ec9f5e41a8ad54094881be2323 msgid "**Changes in Version 1.17.6**" msgstr "" #: ../../../changes.txt:1920 d2312ab353dc4344a3ef174e63c10207 msgid "**Fixed** issue `#605 `_" msgstr "" #: ../../../changes.txt:1921 d52cabcacf8e4c7b8f280b8bb95e5d14 msgid "" "**Fixed** issue `#600 `_ " "-- text should now be correctly positioned also for pages with a CropBox " "smaller than MediaBox." msgstr "" #: ../../../changes.txt:1922 84afef0f9451476d83841dc61e1ae4d6 msgid "" "**Added** text span dictionary key ``origin`` which contains the lower " "left coordinate of the first character in that span." msgstr "" #: ../../../changes.txt:1923 c2104decab38443f85a9f4afbcf59e5f msgid "**Added** attribute :attr:`Font.buffer`, a *bytes* copy of the font file." msgstr "" #: ../../../changes.txt:1924 3b8f869df37e4187b691a5636fabbcc4 msgid "" "**Added** parameter *sanitize* to :meth:`Page.cleanContents`. Allows " "switching of sanitization, so only syntax cleaning will be done." msgstr "" #: ../../../changes.txt:1928 79b5769975fc461580fc75e187439f1a msgid "**Changes in Version 1.17.5**" msgstr "" #: ../../../changes.txt:1930 c3dee94cf9eb4f8c9c29a712da46feee msgid "" "**Fixed** issue `#561 `_ " "-- second go: certain :ref:`TextWriter` usages with many alternating " "fonts did not work correctly." msgstr "" #: ../../../changes.txt:1931 b1cd45be4c3e414b9a31943b87ffa257 msgid "**Fixed** issue `#566 `_." msgstr "" #: ../../../changes.txt:1932 c4be58f459d54570a15caabfa48b2fea msgid "**Fixed** issue `#568 `_." msgstr "" #: ../../../changes.txt:1933 a3a69f69f7e446d190a422fd95946055 msgid "" "**Fixed** -- opacity is now correctly taken from the :ref:`TextWriter` " "object, if not given in :meth:`TextWriter.writeText`." msgstr "" #: ../../../changes.txt:1934 60e36a0e76204fc39ca63f66c0e017f0 msgid "" "**Added** a new global attribute :attr:`fitz_fontdescriptors`. Contains " "information about usable fonts from repository `pymupdf-fonts " "`_." msgstr "" #: ../../../changes.txt:1935 c5bbfe6d1dfc44bea3cf4c3d67f6d27d msgid "" "**Added** :meth:`Font.valid_codepoints` which returns an array of unicode" " codepoints for which the font has a glyph." msgstr "" #: ../../../changes.txt:1936 d2abd73772384a31a507c1e1d6f4988b msgid "" "**Added** option ``text_as_path`` to :meth:`Page.getSVGimage`. this " "implements `#580 `_. " "Generates much smaller SVG files with parseable text if set to *False*." msgstr "" #: ../../../changes.txt:1941 0214e36149a247f698e38dfd899ff4fb msgid "**Changes in Version 1.17.4**" msgstr "" #: ../../../changes.txt:1943 e333e2461114401ea23d111aa11cbe48 msgid "" "**Fixed** issue `#561 `_. " "Handling of more than 10 :ref:`Font` objects on one page should now work " "correctly." msgstr "" #: ../../../changes.txt:1944 3dc7e6c23bdb4fa2af06fa690d6c50e1 msgid "" "**Fixed** issue `#562 `_. " "Annotation pixmaps are no longer derived from the page pixmap, thus " "avoiding unintended inclusion of page content." msgstr "" #: ../../../changes.txt:1945 598609fee1c2419f8f22dd734d9e4621 msgid "" "**Fixed** issue `#559 `_. " "This **MuPDF** bug is being temporarily fixed with a pre-version of " "MuPDF's next release." msgstr "" #: ../../../changes.txt:1946 2b01a159631746d0b9e27d2f4ee7f2f3 msgid "" "**Added** utility function :meth:`repair_mono_font` for correcting " "displayed character spacing for some mono-spaced fonts." msgstr "" #: ../../../changes.txt:1947 d63409b0745449c5b326f78fcbdb243d msgid "" "**Added** utility method :meth:`Document.need_appearances` for fine-" "controlling Form PDF behavior. Addresses issue `#563 " "`_." msgstr "" #: ../../../changes.txt:1948 261813b8c1164f85bd099615986583b1 msgid "" "**Added** utility function :meth:`sRGB_to_pdf` to recover the PDF color " "triple for a given color integer in sRGB format." msgstr "" #: ../../../changes.txt:1949 087525d5979d4e88b699951008f083cd msgid "" "**Added** utility function :meth:`sRGB_to_rgb` to recover the (R, G, B) " "color triple for a given color integer in sRGB format." msgstr "" #: ../../../changes.txt:1950 dfce06d94de945d298f54486d626b557 msgid "" "**Added** utility function :meth:`make_table` which delivers table cells " "for a given rectangle and desired numbers of columns and rows." msgstr "" #: ../../../changes.txt:1951 a5085ba0096648a5abdb1bac873f8a91 msgid "" "**Added** support for optional fonts in repository `pymupdf-fonts " "`_." msgstr "" #: ../../../changes.txt:1955 6035ab0f4f8f4c22b602c2975ca7a9bb msgid "**Changes in Version 1.17.3**" msgstr "" #: ../../../changes.txt:1957 dd9eec4fdfa74a648a0ddfffafa83372 msgid "" "**Fixed** an undocumented issue, which prevented fully cleaning a PDF " "page when using :meth:`Page.cleanContents`." msgstr "" #: ../../../changes.txt:1958 0847e901e54e42ab97132b411ad8703a msgid "" "**Fixed** issue `#540 `_. " "Text extraction for EPUB should again work correctly." msgstr "" #: ../../../changes.txt:1959 14b815222173483085dcc120dceb9f9b msgid "" "**Fixed** issue `#548 `_. " "Documentation now includes ``LINK_NAMED``." msgstr "" #: ../../../changes.txt:1960 f5eb1a9ec46e48479fef6e71d0ce3f21 msgid "" "**Added** new parameter to control start of text in " ":meth:`TextWriter.fillTextbox`. Implements `#549 " "`_." msgstr "" #: ../../../changes.txt:1961 67cf556f751344f683f697a61d518948 msgid "" "**Changed** documentation of :meth:`Page.add_redact_annot` to explain the" " usage of non-builtin fonts." msgstr "" #: ../../../changes.txt:1965 cc0c58ad8b0b41eda4f8e5716f2b16a8 msgid "**Changes in Version 1.17.2**" msgstr "" #: ../../../changes.txt:1967 c27ffc8eec8040018fa36d5790749cec msgid "**Fixed** issue `#533 `_." msgstr "" #: ../../../changes.txt:1968 27350a32fc7840bb8591f6081f20d94d msgid "" "**Added** options to modify 'Redact' annotation appearance. Implements " "`#535 `_." msgstr "" #: ../../../changes.txt:1973 b8bea379222d4215963ee2eb2ffa9049 msgid "**Changes in Version 1.17.1**" msgstr "" #: ../../../changes.txt:1975 60814804b9f84f3d8b98c3cf2dc5f20c msgid "**Fixed** issue `#520 `_." msgstr "" #: ../../../changes.txt:1976 9c3b1af133ad4aa9a4f08296f7affa70 msgid "" "**Fixed** issue `#525 `_. " "Vertices for 'Ink' annots should now be correct." msgstr "" #: ../../../changes.txt:1977 98b1d51b954b4c56bebe479ae1c44fdb msgid "" "**Fixed** issue `#524 `_. " "It is now possible to query and set rotation for applicable annotation " "types." msgstr "" #: ../../../changes.txt:1979 465b318c922644768dbf6d5a01328404 msgid "" "Also significantly improved inline documentation for better support of " "interactive help." msgstr "" #: ../../../changes.txt:1983 5cd63263f85a4783a6ccfc029201386b msgid "**Changes in Version 1.17.0**" msgstr "" #: ../../../changes.txt:1985 b87f5b93bd9b48eeb6c65b06340048e4 msgid "" "This version is based on MuPDF v1.17. Following are highlights of new and" " changed features:" msgstr "" #: ../../../changes.txt:1987 b2f1ba6ba94140b98e5cc0fe7a3faa3b msgid "" "**Added** extended language support for annotations and widgets: a " "mixture of Latin, Greece, Russian, Chinese, Japanese and Korean " "characters can now be used in 'FreeText' annotations and text widgets. No" " special arrangement is required to use it." msgstr "" #: ../../../changes.txt:1989 e733e136ba8c438db34aca4bb17fc4ef msgid "" "Faster page access is implemented for documents supporting a \"chapter\" " "structure. This applies to EPUB documents currently. This comes with " "several new :ref:`Document` methods and changes for " ":meth:`Document.loadPage` and the \"indexed\" page access *doc[n]*: In " "addition to specifying a page number as before, a tuple *(chapter, pno)* " "can be specified to identify the desired page." msgstr "" #: ../../../changes.txt:1991 971b877040f248cdba6abf69baeef371 msgid "" "**Changed:** Improved support of redaction annotations: images overlapped" " by redactions are **permanently modified** by erasing the overlap areas." " Also links are removed if overlapped by redactions. This is now fully in" " sync with PDF specifications." msgstr "" #: ../../../changes.txt:1995 b49d2e2fb4e447e1b521a7c628189360 msgid "" "**Changed** :meth:`TextWriter.writeText` to support the *\"morph\"* " "parameter." msgstr "" #: ../../../changes.txt:1996 3fc9ed296a4f4010832533bc9a26128c msgid "" "**Added** methods :meth:`Rect.morph`, :meth:`IRect.morph`, and " ":meth:`Quad.morph`, which return a new :ref:`Quad`." msgstr "" #: ../../../changes.txt:1997 b20b08f09a414edaacd286b8f526b6f8 msgid "" "**Changed** :meth:`Page.add_freetext_annot` to support text alignment via" " a new *\"align\"* parameter." msgstr "" #: ../../../changes.txt:1998 2361ff8be9cc46e1b8f08ddefa02efae msgid "" "**Fixed** issue `#508 `_. " "Improved image rectangle calculation to hopefully deliver correct values " "in most if not all cases." msgstr "" #: ../../../changes.txt:1999 236cc95410f34fcc89f66e66388bfb9b msgid "**Fixed** issue `#502 `_." msgstr "" #: ../../../changes.txt:2000 b1667139e4fd40a187d32b0c93485b50 msgid "" "**Fixed** issue `#500 `_. " ":meth:`Document.convertToPDF` should no longer cause memory leaks." msgstr "" #: ../../../changes.txt:2001 08f135a6cd9f48d68424126027bef590 msgid "" "**Fixed** issue `#496 `_. " "Annotations and widgets / fields are now added or modified using the " "coordinates of the **unrotated page**. This behavior is now in sync with " "other methods modifying PDF pages." msgstr "" #: ../../../changes.txt:2002 0129ba9864fa48e3b4ddbc7f32269fc2 msgid "" "**Added** :attr:`Page.rotationMatrix` and :attr:`Page.derotationMatrix` " "to support coordinate transformations between the rotated and the " "original versions of a PDF page." msgstr "" #: ../../../changes.txt:2004 35a97c98b52e49278109e56b99107387 msgid "Potential code breaking changes:" msgstr "" #: ../../../changes.txt:2006 1a3fbe2084e24a759582e9aa05cc4591 msgid "" "The private method ``Page._getTransformation()`` has been removed. Use " "the public :attr:`Page.transformationMattrix` instead." msgstr "" #: ../../../changes.txt:2011 f06ca5ab722a487f87a29410f2bb377a msgid "**Changes in Version 1.16.18**" msgstr "" #: ../../../changes.txt:2013 75fa0dcdb41144b680ec66bfd4a6bd1a msgid "" "This version introduces several new features around PDF text output. The " "motivation is to simplify this task, while at the same time offering " "extending features." msgstr "" #: ../../../changes.txt:2015 13b1f23e60414710b4271079289007c0 msgid "" "One major achievement is using MuPDF's capabilities to dynamically " "choosing fallback fonts whenever a character cannot be found in the " "current one. This seamlessly works for Base-14 fonts in combination with " "CJK fonts (China, Japan, Korea). So a text may contain **any combination " "of characters** from the Latin, Greek, Russian, Chinese, Japanese and " "Korean languages." msgstr "" #: ../../../changes.txt:2017 6ffef279ab3d445ca46586a05c3e8d90 msgid "" "**Fixed** issue `#493 `_. " "``Pixmap(doc, xref)`` should now again correctly resemble the loaded " "image object." msgstr "" #: ../../../changes.txt:2018 afdb0475290145d38834c612bbb45088 msgid "" "**Fixed** issue `#488 `_. " "Widget names are now modifiable." msgstr "" #: ../../../changes.txt:2019 141ce60e1fc44924a6cbdea1662c8a7d msgid "**Added** new class :ref:`Font` which represents a font." msgstr "" #: ../../../changes.txt:2020 819be8edbaf04a2ebe870b12436fdad6 msgid "" "**Added** new class :ref:`TextWriter` which serves as a container for " "text to be written on a page." msgstr "" #: ../../../changes.txt:2021 be45ac51b3d7415e8150584132c49a33 msgid "" "**Added** :meth:`Page.writeText` to write one or more :ref:`TextWriter` " "objects to the page." msgstr "" #: ../../../changes.txt:2026 c355f22137584b4cbab6f6354bd95bda msgid "**Changes in Version 1.16.17**" msgstr "" #: ../../../changes.txt:2029 f3f07b3f33cc44c5984500283eb306e1 msgid "" "**Fixed** issue `#479 `_. " "PyMuPDF should now more correctly report image resolutions. This applies " "to both, images (either from images files or extracted from PDF " "documents) and pixmaps created from images." msgstr "" #: ../../../changes.txt:2030 96daad3b07ac4308a44d307f62c89c50 msgid "" "**Added** :meth:`Pixmap.set_dpi` which sets the image resolution in x and" " y directions." msgstr "" #: ../../../changes.txt:2034 33fc9fed734a4bf4990dd592129e984c msgid "**Changes in Version 1.16.16**" msgstr "" #: ../../../changes.txt:2037 765ca3ee977d42678126cf84057b4e3d msgid "**Fixed** issue `#477 `_." msgstr "" #: ../../../changes.txt:2038 6240d3c9c41c46be9652ecabcbae2fbb msgid "**Fixed** issue `#476 `_." msgstr "" #: ../../../changes.txt:2039 d5cd872ddead486aa29ca5b255ba885e msgid "" "**Changed** annotation line end symbol coloring and fixed an error " "coloring the interior of 'Polyline' /'Polygon' annotations." msgstr "" #: ../../../changes.txt:2043 bb450a98e5e04667aed64c1004529927 msgid "**Changes in Version 1.16.14**" msgstr "" #: ../../../changes.txt:2046 3228fbb9e5b4467498da27f2ad55fe5b msgid "" "**Changed** text marker annotations to accept parameters beyond just " "quadrilaterals such that now **text lines between two given points can be" " marked**." msgstr "" #: ../../../changes.txt:2048 a97e5cc2834a4e96b0ede1ad6db5c900 msgid "" "**Added** :meth:`Document.scrub` which **removes potentially sensitive " "data** from a PDF. Implements `#453 " "`_." msgstr "" #: ../../../changes.txt:2050 2f3c7cef276444c480a491776e3ef6e8 msgid "" "**Added** :meth:`Annot.blendMode` which returns the **blend mode** of " "annotations." msgstr "" #: ../../../changes.txt:2052 866e4a88a77d48a1b7aafb511b41907c msgid "" "**Added** :meth:`Annot.setBlendMode` to set the annotation's blend mode. " "This resolves issue `#416 " "`_." msgstr "" #: ../../../changes.txt:2053 501eb9ee56e84e60be74f5ba75eaecb4 msgid "" "**Changed** :meth:`Annot.update` to accept additional parameters for " "setting blend mode and opacity." msgstr "" #: ../../../changes.txt:2054 85b91d3af2b944e09ffc418872e3540e msgid "" "**Added** advanced graphics features to **control the anti-aliasing " "values**, :meth:`Tools.set_aa_level`. Resolves `#467 " "`_" msgstr "" #: ../../../changes.txt:2056 60b4c208b1c04edc9d0cc75db8e9b3ab msgid "**Fixed** issue `#474 `_." msgstr "" #: ../../../changes.txt:2057 4f4fa5bbd4bb45dc965381d06a2c28e1 msgid "**Fixed** issue `#466 `_." msgstr "" #: ../../../changes.txt:2063 c2150d5e98ed4b29a8d7d0e0e049893a msgid "**Changes in Version 1.16.13**" msgstr "" #: ../../../changes.txt:2066 6ffa2c895b184d7c9579c04c5e72d6cc msgid "" "**Added** :meth:`Document.getPageXObjectList` which returns a list of " "**Form XObjects** of the page." msgstr "" #: ../../../changes.txt:2067 1ad5db1dcf4e406d84fe85e8ac783a34 msgid "" "**Added** :meth:`Page.setMediaBox` for changing the physical PDF page " "size." msgstr "" #: ../../../changes.txt:2068 dc4ffb1b3bba4dd7a2c0b5018278954e msgid "" "**Added** :ref:`Page` methods which have been internal before: " ":meth:`Page.cleanContents` (= :meth:`Page._cleanContents`), " ":meth:`Page.getContents` (= :meth:`Page._getContents`), " ":meth:`Page.getTransformation` (= :meth:`Page._getTransformation`)." msgstr "" #: ../../../changes.txt:2074 0a926e1f6bb64ff4ab4b4fed8ea0ee89 msgid "**Changes in Version 1.16.12**" msgstr "" #: ../../../changes.txt:2076 6f5ea75220774bb684dc3fe1dbf48e9b msgid "**Fixed** issue `#447 `_" msgstr "" #: ../../../changes.txt:2077 71bac266ce3746019c6a08f26d3ec822 msgid "**Fixed** issue `#461 `_." msgstr "" #: ../../../changes.txt:2078 373fc96ec8a54dee8c321088ee944682 msgid "**Fixed** issue `#397 `_." msgstr "" #: ../../../changes.txt:2079 7cf9d00c4d19420abaaf8c58b10147a0 msgid "**Fixed** issue `#463 `_." msgstr "" #: ../../../changes.txt:2080 fe57fdfdfd8d4dbab5eed84540ad2c09 msgid "" "**Added** JavaScript support to PDF form fields, thereby fixing `#454 " "`_." msgstr "" #: ../../../changes.txt:2081 3eb09d62dd6044afa545088e6207f9f5 msgid "" "**Added** a new annotation method :meth:`Annot.delete_responses`, which " "removes 'Popup' and response annotations referring to the current one. " "Mainly serves data protection purposes." msgstr "" #: ../../../changes.txt:2082 5c849834cfb14620809866c9ac0b1f25 msgid "" "**Added** a new form field method :meth:`Widget.reset`, which resets the " "field value to its default." msgstr "" #: ../../../changes.txt:2083 1d43ac4e7dcf4344b0dfdcf700f6d7a5 msgid "" "**Changed** and extended handling of redactions: images and XObjects are " "removed if *contained* in a redaction rectangle. Any partial only " "overlaps will just be covered by the redaction background color. Now an " "*overlay* text can be specified to be inserted in the rectangle area to " "**take the place the deleted original** text. This resolves `#434 " "`_." msgstr "" #: ../../../changes.txt:2087 d41286ba5ebd44c280d5f43f2c164594 msgid "**Changes in Version 1.16.11**" msgstr "" #: ../../../changes.txt:2089 74c14cc395804937832a051835d5fecb msgid "" "**Added** Support for redaction annotations via method " ":meth:`Page.add_redact_annot` and :meth:`Page.apply_redactions`." msgstr "" #: ../../../changes.txt:2090 68b7efcedf5f4d94964ff855c1baaa83 msgid "**Fixed** issue #426 (\"PolygonAnnotation in 1.16.10 version\")." msgstr "" #: ../../../changes.txt:2091 247da6da5b67427fab1dc09bed47037f msgid "" "**Fixed** documentation only issues `#443 " "`_ and `#444 " "`_." msgstr "" #: ../../../changes.txt:2095 ed5a70ba54b5438786c6e36834b30a3d msgid "**Changes in Version 1.16.10**" msgstr "" #: ../../../changes.txt:2097 9147f50e16864bfe9fc59b9c324a45ca msgid "" "**Fixed** issue #421 (\"annot.set_rect(rect) has no effect on text " "Annotation\")" msgstr "" #: ../../../changes.txt:2098 2a0e32d4811546f3a036844d15350182 msgid "" "**Fixed** issue #417 (\"Strange behavior for page.deleteAnnot on 1.16.9 " "compare to 1.13.20\")" msgstr "" #: ../../../changes.txt:2099 85979328a4bc4780a1adf5da1b2e3893 msgid "**Fixed** issue #415 (\"Annot.setOpacity throws mupdf warnings\")" msgstr "" #: ../../../changes.txt:2100 2419b5fdf6bd4e14bf9217b890caa587 msgid "" "**Changed** all \"add annotation / widget\" methods to store a unique " "name in the */NM* PDF key." msgstr "" #: ../../../changes.txt:2101 9d4a65a638864c41800994ff9674b45a msgid "" "**Changed** :meth:`Annot.setInfo` to also accept direct parameters in " "addition to a dictionary." msgstr "" #: ../../../changes.txt:2102 d7c062a9ce2e4526a3f42e875262dd86 msgid "" "**Changed** :attr:`Annot.info` to now also show the annotation's unique " "id (*/NM* PDF key) if present." msgstr "" #: ../../../changes.txt:2103 e8cff5d5c3c8451381b2fbccf05c6ad9 msgid "" "**Added** :meth:`Page.annot_names` which returns a list of all annotation" " names (*/NM* keys)." msgstr "" #: ../../../changes.txt:2104 9e3fa2fe09b54dc29528cfced4d8729f msgid "" "**Added** :meth:`Page.load_annot` which loads an annotation given its " "unique id (*/NM* key)." msgstr "" #: ../../../changes.txt:2105 f5d8b4dd62cf460a9126ea02f116c488 msgid "" "**Added** :meth:`Document.reload_page` which provides a new copy of a " "page after finishing any pending updates to it." msgstr "" #: ../../../changes.txt:2110 072a5e68ce9a45629a888405caa5a5d2 msgid "**Changes in Version 1.16.9**" msgstr "" #: ../../../changes.txt:2112 c18c92f84efa4cfa8b797880e17d8bcb msgid "" "**Fixed** #412 (\"Feature Request: Allow controlling whether TOC entries " "should be collapsed\")" msgstr "" #: ../../../changes.txt:2113 f9a9a45513f74bfa9a4747231296426f msgid "**Fixed** #411 (\"Seg Fault with page.firstWidget\")" msgstr "" #: ../../../changes.txt:2114 cbe0b8f39db641068257179e30232c1f msgid "**Fixed** #407 (\"Annot.setOpacity trouble\")" msgstr "" #: ../../../changes.txt:2115 c4b9b8f9ef874c7f88678471ea871da9 msgid "" "**Changed** methods :meth:`Annot.setBorder`, :meth:`Annot.setColors`, " ":meth:`Link.setBorder`, and :meth:`Link.setColors` to also accept direct " "parameters, and not just cumbersome dictionaries." msgstr "" #: ../../../changes.txt:2119 d0e24eb6d1f34da0aca34159c1e8309c msgid "**Changes in Version 1.16.8**" msgstr "" #: ../../../changes.txt:2121 78fe31bc2d304b78a7a2cec103ad3a86 msgid "" "**Added** several new methods to the :ref:`Document` class, which make " "dealing with PDF low-level structures easier. I also decided to provide " "them as \"normal\" methods (as opposed to private ones starting with an " "underscore \"_\"). These are :meth:`Document.xrefObject`, " ":meth:`Document.xrefStream`, :meth:`Document.xrefStreamRaw`, " ":meth:`Document.PDFTrailer`, :meth:`Document.PDFCatalog`, " ":meth:`Document.metadataXML`, :meth:`Document.updateObject`, " ":meth:`Document.updateStream`." msgstr "" #: ../../../changes.txt:2122 f907ccb57c184be2857e9e13341bcf7f msgid "" "**Added** :meth:`Tools.mupdf_disply_errors` which sets the display of " "mupdf errors on *sys.stderr*." msgstr "" #: ../../../changes.txt:2123 462c8d75060e4a88a09ea596464f5368 msgid "" "**Added** a commandline facility. This a major new feature: you can now " "invoke several utility functions via *\"python -m fitz ...\"*. It should " "obsolete the need for many of the most trivial scripts. Please refer to " ":ref:`Module`." msgstr "" #: ../../../changes.txt:2128 4f1ac7ae88d343e886b0fc8edee75d46 msgid "**Changes in Version 1.16.7**" msgstr "" #: ../../../changes.txt:2130 59ec1afd2e0b4cd3a5dc260bd354751e msgid "" "Minor changes to better synchronize the binary image streams of " ":ref:`TextPage` image blocks and :meth:`Document.extractImage` images." msgstr "" #: ../../../changes.txt:2132 ac25ec6537ba4e92aab44dcf172c4ba8 msgid "" "**Fixed** issue #394 (\"PyMuPDF Segfaults when using " "TOOLS.mupdf_warnings()\")." msgstr "" #: ../../../changes.txt:2133 d9b7bf416f824ce09246787bdda98e63 msgid "" "**Changed** redirection of MuPDF error messages: apart from writing them " "to Python *sys.stderr*, they are now also stored with the MuPDF warnings." msgstr "" #: ../../../changes.txt:2134 f40406dcc3f04e31b7a7a9805de02e42 msgid "" "**Changed** :meth:`Tools.mupdf_warnings` to automatically empty the store" " (if not deactivated via a parameter)." msgstr "" #: ../../../changes.txt:2135 2299c535d3cb4aa6a186707196175500 msgid "" "**Changed** :meth:`Page.getImageBbox` to return an **infinite rectangle**" " if the image could not be located on the page -- instead of raising an " "exception." msgstr "" #: ../../../changes.txt:2140 bfbc4d7dee2442f3b0f015ea21421028 msgid "**Changes in Version 1.16.6**" msgstr "" #: ../../../changes.txt:2142 c28c263feaa6419cb63d73ad8209d28d msgid "**Fixed** issue #390 (\"Incomplete deletion of annotations\")." msgstr "" #: ../../../changes.txt:2143 c5219152f7854dc88d39a7689713a4a8 msgid "" "**Changed** :meth:`Page.searchFor` / :meth:`Document.searchPageFor` to " "also support the *flags* parameter, which controls the data included in a" " :ref:`TextPage`." msgstr "" #: ../../../changes.txt:2144 21ea396db0a04f04ac4bf6146ab72b59 msgid "" "**Changed** :meth:`Document.getPageImageList`, " ":meth:`Document.getPageFontList` and their :ref:`Page` counterparts to " "support a new parameter *full*. If true, the returned items will contain " "the :data:`xref` of the *Form XObject* where the font or image is " "referenced." msgstr "" #: ../../../changes.txt:2148 69f333b42ed44c918c9378c6632bd3e2 msgid "**Changes in Version 1.16.5**" msgstr "" #: ../../../changes.txt:2150 9f2ab73d9d874b4784539e77ddee4f5b msgid "More performance improvements for text extraction." msgstr "" #: ../../../changes.txt:2152 fb2a1a0548f3424b8d89927d5f5047ee msgid "**Fixed** second part of issue #381 (see item in v1.16.4)." msgstr "" #: ../../../changes.txt:2153 3f0ac5e4286c4997836ff33e123dbaf4 msgid "" "**Added** :meth:`Page.getTextPage`, so it is no longer required to create" " an intermediate display list for text extractions. Page level wrappers " "for text extraction and text searching are now based on this, which " "should improve performance by ca. 5%." msgstr "" #: ../../../changes.txt:2157 9e9865f910ed4d4399d4dfbe3c3d0597 msgid "**Changes in Version 1.16.4**" msgstr "" #: ../../../changes.txt:2160 e7d84df2ad7448e1880d04a6a7858521 msgid "" "**Fixed** issue #381 (\"TextPage.extractDICT ... failed ... after " "upgrading ... to 1.16.3\")" msgstr "" #: ../../../changes.txt:2161 17ca6aae522d4d84a5b1c510ca445cc6 msgid "" "**Added** method :meth:`Document.pages` which delivers a generator " "iterator over a page range." msgstr "" #: ../../../changes.txt:2162 b2b7308c362b461bb878fcc1538a0c92 msgid "" "**Added** method :meth:`Page.links` which delivers a generator iterator " "over the links of a page." msgstr "" #: ../../../changes.txt:2163 765160822cdc4aa9b4b723db791c91b6 msgid "" "**Added** method :meth:`Page.annots` which delivers a generator iterator " "over the annotations of a page." msgstr "" #: ../../../changes.txt:2164 3eb7fc95d4214c22a621ccb900d1e490 msgid "" "**Added** method :meth:`Page.widgets` which delivers a generator iterator" " over the form fields of a page." msgstr "" #: ../../../changes.txt:2165 d91d637897d54651a998f7dc0d19dc08 msgid "" "**Changed** :attr:`Document.is_form_pdf` to now contain the number of " "widgets, and *False* if not a PDF or this number is zero." msgstr "" #: ../../../changes.txt:2170 c01be0ed23784665aa2ce10d9ee9e605 msgid "**Changes in Version 1.16.3**" msgstr "" #: ../../../changes.txt:2172 112fd892e91d4394b0bbd52b9a508533 msgid "" "Minor changes compared to version 1.16.2. The code of the \"dict\" and " "\"rawdict\" variants of :meth:`Page.getText` has been ported to C which " "has greatly improved their performance. This improvement is mostly " "noticeable with text-oriented documents, where they now should execute " "almost two times faster." msgstr "" #: ../../../changes.txt:2174 529a6e2ef3a44e7496d36d3b262a6697 msgid "" "**Fixed** issue #369 (\"mupdf: cmsCreateTransform failed\") by removing " "ICC colorspace support." msgstr "" #: ../../../changes.txt:2175 d2e2ed462d9a420181f57a3bf178f0c7 msgid "" "**Changed** :meth:`Page.getText` to accept additional keywords \"blocks\"" " and \"words\". These will deliver the results of " ":meth:`Page.getTextBlocks` and :meth:`Page.getTextWords`, respectively. " "So all text extraction methods are now available via a uniform API. " "Correspondingly, there are now new methods :meth:`TextPage.extractBLOCKS`" " and :meth:`TextPage.extractWords`." msgstr "" #: ../../../changes.txt:2176 1c333634e45449ce9b326aff470a6f28 msgid "" "**Changed** :meth:`Page.getText` to default bit indicator " "*TEXT_INHIBIT_SPACES* to **off**. Insertion of additional spaces is **not" " suppressed** by default." msgstr "" #: ../../../changes.txt:2180 12e20189c1f143da88f1568d186c2402 msgid "**Changes in Version 1.16.2**" msgstr "" #: ../../../changes.txt:2182 5b0a0190d48d45a79172681a52191e85 msgid "" "**Changed** text extraction methods of :ref:`Page` to allow detail " "control of the amount of extracted data." msgstr "" #: ../../../changes.txt:2183 26cc0a7bee624a97a6c6ee19ee703703 msgid "" "**Added** :meth:`planish_line` which maps a given line (defined as a pair" " of points) to the x-axis." msgstr "" #: ../../../changes.txt:2184 b3df1c1be11846f9993b323a07181579 msgid "" "**Fixed** an issue (w/o Github number) which brought down the interpreter" " when encountering certain non-UTF-8 encodable characters while using " ":meth:`Page.getText` with the \"dict\" option." msgstr "" #: ../../../changes.txt:2185 e6ba0bd1a32e4b12891ded9326249a81 msgid "**Fixed** issue #362 (\"Memory Leak with getText('rawDICT')\")." msgstr "" #: ../../../changes.txt:2189 e9569fdba664447da20f33096718b92f msgid "**Changes in Version 1.16.1**" msgstr "" #: ../../../changes.txt:2191 dcc8cf6fc2384f3bb994e03b3a87c729 msgid "" "**Added** property :attr:`Quad.is_convex` which checks whether a line is " "contained in the quad if it connects two points of it." msgstr "" #: ../../../changes.txt:2192 cc61e8f19f5e488b8316b4e8235659f5 msgid "" "**Changed** :meth:`Document.insert_pdf` to now allow dropping or " "including links and annotations independently during the copy. Fixes " "issue #352 (\"Corrupt PDF data and ...\"), which seemed to intermittently" " occur when using the method for some problematic PDF files." msgstr "" #: ../../../changes.txt:2193 d407b04268d44237912c00860184f190 msgid "" "**Fixed** a bug which, in matrix division using the syntax *\"m1/m2\"*, " "caused matrix *\"m1\"* to be **replaced** by the result instead of " "delivering a new matrix." msgstr "" #: ../../../changes.txt:2194 7817d3234a47487b971b3830ef28ec19 msgid "" "**Fixed** issue #354 (\"SyntaxWarning with Python 3.8\"). We now always " "use *\"==\"* for literals (instead of the *\"is\"* Python keyword)." msgstr "" #: ../../../changes.txt:2195 ec50e4c219bd4062ad4ed5c0dddaac86 msgid "" "**Fixed** issue #353 (\"mupdf version check\"), to no longer refuse the " "import when there are only patch level deviations from MuPDF." msgstr "" #: ../../../changes.txt:2201 97813723c7e74febb3697d506c0094da msgid "**Changes in Version 1.16.0**" msgstr "" #: ../../../changes.txt:2203 2c7908f042184d21a92a433a0dace8f2 msgid "" "This major new version of MuPDF comes with several nice new or changed " "features. Some of them imply programming API changes, however. This is a " "synopsis of what has changed:" msgstr "" #: ../../../changes.txt:2205 a005bf6b6c26445f8a8e708efa7b1e6d msgid "" "PDF document encryption and decryption is now **fully supported**. This " "includes setting **permissions**, **passwords** (user and owner " "passwords) and the desired encryption method." msgstr "" #: ../../../changes.txt:2206 f64056f6bc3f4c5c9e5716fd5b547a3b msgid "" "In response to the new encryption features, PyMuPDF returns an integer " "(ie. a combination of bits) for document permissions, and no longer a " "dictionary." msgstr "" #: ../../../changes.txt:2207 12c5b87d97b548be96df9490e4a9b1f8 msgid "" "Redirection of MuPDF errors and warnings is now natively supported. " "PyMuPDF redirects error messages from MuPDF to *sys.stderr* and no longer" " buffers them. Warnings continue to be buffered and will not be " "displayed. Functions exist to access and reset the warnings buffer." msgstr "" #: ../../../changes.txt:2208 9ee23cc47bf54e33ac5b25ec8bd3a5b0 msgid "Annotations are now **only supported for PDF**." msgstr "" #: ../../../changes.txt:2209 043f8a35721a45789fc958c22ae0db05 msgid "" "Annotations and widgets (form fields) are now **separate object chains** " "on a page (although widgets technically still **are** PDF annotations). " "This means, that you will **never encounter widgets** when using " ":attr:`Page.firstAnnot` or :meth:`Annot.next`. You must use " ":attr:`Page.firstWidget` and :meth:`Widget.next` to access form fields." msgstr "" #: ../../../changes.txt:2210 98ff046f99264c3aadf74240a8bc473d msgid "" "As part of MuPDF's changes regarding widgets, only the following four " "fonts are supported, when **adding** or **changing** form fields: " "**Courier, Helvetica, Times-Roman** and **ZapfDingBats**." msgstr "" #: ../../../changes.txt:2212 c153729a2d494ff0ae2def2ff637078a msgid "List of change details:" msgstr "" #: ../../../changes.txt:2214 b23f45be6d7741b295688a68df3dab61 msgid "" "**Added** :meth:`Document.can_save_incrementally` which checks conditions" " that are preventing use of option *incremental=True* of " ":meth:`Document.save`." msgstr "" #: ../../../changes.txt:2215 f4ec8c96484849b498b2ccf6668ed972 msgid "" "**Added** :attr:`Page.firstWidget` which points to the first field on a " "page." msgstr "" #: ../../../changes.txt:2216 bcff0ac6bdc749b7b1bdca9295590789 msgid "" "**Added** :meth:`Page.getImageBbox` which returns the rectangle occupied " "by an image shown on the page." msgstr "" #: ../../../changes.txt:2217 027854d96da7483d84939b2e60db8b94 msgid "" "**Added** :meth:`Annot.setName` which lets you change the (icon) name " "field." msgstr "" #: ../../../changes.txt:2218 bcc01e342bb8486ca3ef80ba6e2007f8 msgid "" "**Added** outputting the text color in :meth:`Page.getText`: the " "*\"dict\"*, *\"rawdict\"* and *\"xml\"* options now also show the color " "in sRGB format." msgstr "" #: ../../../changes.txt:2219 bc0cbfa3b0484956b6eaea0bdb98a8fc msgid "" "**Changed** :attr:`Document.permissions` to now contain an integer of " "bool indicators -- was a dictionary before." msgstr "" #: ../../../changes.txt:2220 820b45730e5f4cd09d1a94837ecb4e08 msgid "" "**Changed** :meth:`Document.save`, :meth:`Document.write`, which now " "fully support password-based decryption and encryption of PDF files." msgstr "" #: ../../../changes.txt:2221 4731ba6ffeda46a2a2d03259b480522f msgid "" "**Changed the names of all Python constants** related to annotations and " "widgets. Please make sure to consult the **Constants and Enumerations** " "chapter if your script is dealing with these two classes. This decision " "goes back to the dropped support for non-PDF annotations. The **old " "names** (starting with \"ANNOT_*\" or \"WIDGET_*\") will be available as " "deprecated synonyms." msgstr "" #: ../../../changes.txt:2222 238de30d8f3c49d48c79ee5b21a0e5f6 msgid "" "**Changed** font support for widgets: only *Cour* (Courier), *Helv* " "(Helvetica, default), *TiRo* (Times-Roman) and *ZaDb* (ZapfDingBats) are " "accepted when **adding or changing** form fields. Only the plain versions" " are possible -- not their italic or bold variations. **Reading** " "widgets, however will show its original font." msgstr "" #: ../../../changes.txt:2223 e763e7235e744348bb116c13b8db7bfa msgid "" "**Changed** the name of the warnings buffer to " ":meth:`Tools.mupdf_warnings` and the function to empty this buffer is now" " called :meth:`Tools.reset_mupdf_warnings`." msgstr "" #: ../../../changes.txt:2224 e51bbdba4a7f47c99ae6f3828cb8299d msgid "" "**Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap`: a " "new bool argument *annots* can now be used to **suppress the rendering of" " annotations** on the page." msgstr "" #: ../../../changes.txt:2225 caaa515792364bf3902f0f1c3f484995 msgid "" "**Changed** :meth:`Page.add_file_annot` and :meth:`Page.add_text_annot` " "to enable setting an icon." msgstr "" #: ../../../changes.txt:2226 0086e4a6b881460f8c71102f2729bc2d msgid "" "**Removed** widget-related methods and attributes from the :ref:`Annot` " "object." msgstr "" #: ../../../changes.txt:2227 f50931d062644b8f880b652ea90f83f5 msgid "" "**Removed** :ref:`Document` attributes *openErrCode*, *openErrMsg*, and " ":ref:`Tools` attributes / methods *stderr*, *reset_stderr*, *stdout*, and" " *reset_stdout*." msgstr "" #: ../../../changes.txt:2228 a67f4a89f4f64dd68267c94b2d73ce86 msgid "" "**Removed** **thirdparty zlib** dependency in PyMuPDF: there are now " "compression functions available in MuPDF. Source installers of PyMuPDF " "may now omit this extra installation step." msgstr "" #: ../../../changes.txt:2230 42c8303233d940a8bb202082575e9d67 msgid "**No version published for MuPDF v1.15.0**" msgstr "" #: ../../../changes.txt:2235 0e262b2012e24e66bcbb16697b9750e3 msgid "**Changes in Version 1.14.20 / 1.14.21**" msgstr "" #: ../../../changes.txt:2237 cf8c37c3fab846c3bfc824d30a64fe50 msgid "" "**Changed** text marker annotations to support multiple rectangles / " "quadrilaterals. This fixes issue #341 (\"Question : How to addhighlight " "so that a string spread across more than a line is covered by one " "highlight?\") and similar (#285)." msgstr "" #: ../../../changes.txt:2238 cea5aecbd9e84d1aa23aa5d28149aa16 msgid "" "**Fixed** issue #331 (\"Importing PyMuPDF changes warning filtering " "behaviour globally\")." msgstr "" #: ../../../changes.txt:2243 97bdc13f89b8480bb31a7a26ed32a594 msgid "**Changes in Version 1.14.19**" msgstr "" #: ../../../changes.txt:2245 6b2efadb462c476c86b64734cc2f0abe msgid "**Fixed** issue #319 (\"InsertText function error when use custom font\")." msgstr "" #: ../../../changes.txt:2246 55649a3c6956439eb948ff4f5d16de35 msgid "" "**Added** new method :meth:`Document.get_sigflags` which returns " "information on whether a PDF is signed. Resolves issue #326 (\"How to " "detect signature in a form pdf?\")." msgstr "" #: ../../../changes.txt:2251 8b00c1d84be44f0e843dcc2f618a054f msgid "**Changes in Version 1.14.17**" msgstr "" #: ../../../changes.txt:2253 bf77aace3abb4d87a3a27f4fde38cdee msgid "" "**Added** :meth:`Document.fullcopyPage` to make full page copies within a" " PDF (not just copied references as :meth:`Document.copyPage` does)." msgstr "" #: ../../../changes.txt:2254 f5f13a70b41041ac94342d177b78283e msgid "" "**Changed** :meth:`Page.getPixmap`, :meth:`Document.get_page_pixmap` now " "use *alpha=False* as default." msgstr "" #: ../../../changes.txt:2255 0b81e0a298f842cfae56289c691fc8af msgid "" "**Changed** text extraction: the span dictionary now (again) contains its" " rectangle under the *bbox* key." msgstr "" #: ../../../changes.txt:2256 80171c31ff824cf5a8796464b7f185bd msgid "" "**Changed** :meth:`Document.movePage` and :meth:`Document.copyPage` to " "use direct functions instead of wrapping :meth:`Document.select` -- " "similar to :meth:`Document.delete_page` in v1.14.16." msgstr "" #: ../../../changes.txt:2260 2102f0e54ede402daf1c78dac1d0ca26 msgid "**Changes in Version 1.14.16**" msgstr "" #: ../../../changes.txt:2262 6703d3f0199a482cadb2d9a376aaa7c6 msgid "" "**Changed** :ref:`Document` methods around PDF */EmbeddedFiles* to no " "longer use MuPDF's \"portfolio\" functions. That support will be dropped " "in MuPDF v1.15 -- therefore another solution was required." msgstr "" #: ../../../changes.txt:2263 6447adac2fa6472d8d443e4326ffe0f4 msgid "" "**Changed** :meth:`Document.embfile_Count` to be a function (was an " "attribute)." msgstr "" #: ../../../changes.txt:2264 0f5ec06d87f74cdc82a5f05fa5beae80 msgid "" "**Added** new method :meth:`Document.embfile_Names` which returns a list " "of names of embedded files." msgstr "" #: ../../../changes.txt:2265 c99e5b42134b48d28118a34b7b00f400 msgid "" "**Changed** :meth:`Document.delete_page` and " ":meth:`Document.delete_pages` to internally no longer use " ":meth:`Document.select`, but instead use functions to perform the " "deletion directly. As it has turned out, the :meth:`Document.select` " "method yields invalid outline trees (tables of content) for very complex " "PDFs and sophisticated use of annotations." msgstr "" #: ../../../changes.txt:2270 d47507f7f3114b71864f6f89dff1d8de msgid "**Changes in Version 1.14.15**" msgstr "" #: ../../../changes.txt:2272 685a47651ab74ab9baa02751bdfeea45 msgid "" "**Fixed** issues #301 (\"Line cap and Line join\"), #300 (\"How to draw a" " shape without outlines\") and #298 (\"utils.updateRect exception\"). " "These bugs pertain to drawing shapes with PyMuPDF. Drawing shapes without" " any border is fully supported. Line cap styles and line line join style " "are now differentiated and support all possible PDF values (0, 1, 2) " "instead of just being a bool. The previous parameter *roundCap* is " "deprecated in favor of *lineCap* and *lineJoin* and will be deleted in " "the next release." msgstr "" #: ../../../changes.txt:2273 69635ffd084f40da8a77aef036ecbc5b msgid "" "**Fixed** issue #290 (\"Memory Leak with getText('rawDICT')\"). This bug " "caused memory not being (completely) freed after invoking the \"dict\", " "\"rawdict\" and \"json\" versions of :meth:`Page.getText`." msgstr "" #: ../../../changes.txt:2278 347daa4b4d614a538c8264a0f7513365 msgid "**Changes in Version 1.14.14**" msgstr "" #: ../../../changes.txt:2280 fd89b8ffed0e45b4becf36770405f0a5 msgid "" "**Added** new low-level function :meth:`ImageProperties` to determine a " "number of characteristics for an image." msgstr "" #: ../../../changes.txt:2281 5b71c3a43a3d4b468a46d3704d1a5fed msgid "" "**Added** new low-level function :meth:`Document.is_stream`, which checks" " whether an object is of stream type." msgstr "" #: ../../../changes.txt:2282 7704e37dc4954c43891ea6905e994602 msgid "" "**Changed** low-level functions :meth:`Document._getXrefString` and " ":meth:`Document._getTrailerString` now by default return object " "definitions in a formatted form which makes parsing easy." msgstr "" #: ../../../changes.txt:2286 60c8b7ae348144f590caa8dd2b6475b4 msgid "**Changes in Version 1.14.13**" msgstr "" #: ../../../changes.txt:2288 409b6e7270844e05986a6af2e04bf234 msgid "" "**Changed** methods working with binary input: while ever supporting " "bytes and bytearray objects, they now also accept *io.BytesIO* input, " "using their *getvalue()* method. This pertains to document creation, " "embedded files, FileAttachment annotations, pixmap creation and others. " "Fixes issue #274 (\"Segfault when using BytesIO as a stream for " "insertImage\")." msgstr "" #: ../../../changes.txt:2289 517a02e2889046a4bf151c5da878dec9 msgid "" "**Fixed** issue #278 (\"Is insertImage(keep_proportion=True) broken?\"). " "Images are now correctly presented when keeping aspect ratio." msgstr "" #: ../../../changes.txt:2294 d22de33a96de48479a5d908ec0ba6cd2 msgid "**Changes in Version 1.14.12**" msgstr "" #: ../../../changes.txt:2296 8e8898b2f62f4ccfabbc4633afa8d524 msgid "" "**Changed** the draw methods of :ref:`Page` and :ref:`Shape` to support " "not only RGB, but also GRAY and CMYK colorspaces. This solves issue #270 " "(\"Is there a way to use CMYK color to draw shapes?\"). This change also " "applies to text insertion methods of :ref:`Shape`, resp. :ref:`Page`." msgstr "" #: ../../../changes.txt:2297 12008f80180643aeb7c59cd9d81f7b17 msgid "" "**Fixed** issue #269 (\"AttributeError in Document.insert_page()\"), " "which occurred when using :meth:`Document.insert_page` with text " "insertion." msgstr "" #: ../../../changes.txt:2302 5926b5208b964e5bb1c6d9aa237e3b25 msgid "**Changes in Version 1.14.11**" msgstr "" #: ../../../changes.txt:2304 7cd2f991658242e0a818633e00e32840 msgid "" "**Changed** :meth:`Page.show_pdf_page` to always position the source " "rectangle centered in the target. This method now also supports " "**rotation by arbitrary angles**. The argument *reuse_xref* has been " "deprecated: prevention of duplicates is now **handled internally**." msgstr "" #: ../../../changes.txt:2305 92cb4e6a37f04f8fbe1fe50f20b4315e msgid "" "**Changed** :meth:`Page.insertImage` to support rotated display of the " "image and keeping the aspect ratio. Only rotations by multiples of 90 " "degrees are supported here." msgstr "" #: ../../../changes.txt:2306 a3321e012bd14420978e83b39fe71692 msgid "" "**Fixed** issue #265 (\"TypeError: insertText() got an unexpected keyword" " argument 'idx'\"). This issue only occurred when using " ":meth:`Document.insert_page` with also inserting text." msgstr "" #: ../../../changes.txt:2310 ce94e552e8634de490994f5a58a88b5a msgid "**Changes in Version 1.14.10**" msgstr "" #: ../../../changes.txt:2312 91400574def7471c9bcf3e3b784293fa msgid "" "**Changed** :meth:`Page.show_pdf_page` to support rotation of the source " "rectangle. Fixes #261 (\"Cannot rotate inserted pages\")." msgstr "" #: ../../../changes.txt:2313 373a473d44604ea0a33bee60a4608003 msgid "" "**Fixed** a bug in :meth:`Page.insertImage` which prevented insertion of " "multiple images provided as streams." msgstr "" #: ../../../changes.txt:2318 a745612de5d944648494f2f4fe5a7367 msgid "**Changes in Version 1.14.9**" msgstr "" #: ../../../changes.txt:2320 786372a66f0346f5b2ebf49918ac01fc msgid "" "**Added** new low-level method :meth:`Document._getTrailerString`, which " "returns the trailer object of a PDF. This is much like " ":meth:`Document._getXrefString` except that the PDF trailer has no / " "needs no :data:`xref` to identify it." msgstr "" #: ../../../changes.txt:2321 166ee0276f23464790afa4aa78d3fb2b msgid "" "**Added** new parameters for text insertion methods. You can now set " "stroke and fill colors of glyphs (text characters) independently, as well" " as the thickness of the glyph border. A new parameter *render_mode* " "controls the use of these colors, and whether the text should be visible " "at all." msgstr "" #: ../../../changes.txt:2322 ec5e00cd07f74051b60872c21459da65 msgid "" "**Fixed** issue #258 (\"Copying image streams to new PDF without size " "increase\"): For JPX images embedded in a PDF, " ":meth:`Document.extractImage` will now return them in their original " "format. Previously, the MuPDF base library was used, which returns them " "in PNG format (entailing a massive size increase)." msgstr "" #: ../../../changes.txt:2323 9c4df9a330534524ae96733260628fa2 msgid "" "**Fixed** issue #259 (\"Morphing text to fit inside rect\"). Clarified " "use of :meth:`get_text_length` and removed extra line breaks for long " "words." msgstr "" #: ../../../changes.txt:2327 40cd0da7bb2c49d28cf036e85d01e73d msgid "**Changes in Version 1.14.8**" msgstr "" #: ../../../changes.txt:2329 c23dc29674cd4476a5d1ce8bdba7c25b msgid "" "**Added** :meth:`Pixmap.set_rect` to change the pixel values in a " "rectangle. This is also an alternative to setting the color of a complete" " pixmap (:meth:`Pixmap.clear_with`)." msgstr "" #: ../../../changes.txt:2330 647ba02e1ad3448b85b1e417300551d5 msgid "" "**Fixed** an image extraction issue with JBIG2 (monochrome) encoded PDF " "images. The issue occurred in :meth:`Page.getText` (parameters \"dict\" " "and \"rawdict\") and in :meth:`Document.extractImage` methods." msgstr "" #: ../../../changes.txt:2331 97187008a30a4a7cad0a589358db47c2 msgid "" "**Fixed** an issue with not correctly clearing a non-alpha :ref:`Pixmap` " "(:meth:`Pixmap.clear_with`)." msgstr "" #: ../../../changes.txt:2332 e8d31f10770246f0a19e29e3fe088dba msgid "" "**Fixed** an issue with not correctly inverting colors of a non-alpha " ":ref:`Pixmap` (:meth:`Pixmap.invert_irect`)." msgstr "" #: ../../../changes.txt:2336 67dff84982fa4c1680c49d7d32e32cd7 msgid "**Changes in Version 1.14.7**" msgstr "" #: ../../../changes.txt:2338 7a13d485e8154810a7af7370e7e9252d msgid "**Added** :meth:`Pixmap.set_pixel` to change one pixel value." msgstr "" #: ../../../changes.txt:2339 4c9debbd3ad14281953bef2ed96535b3 msgid "**Added** documentation for image conversion in the :ref:`FAQ`." msgstr "" #: ../../../changes.txt:2340 78bdc22a5a5e4e64a9d8b4b07bfb1123 msgid "" "**Added** new function :meth:`get_text_length` to determine the string " "length for a given font." msgstr "" #: ../../../changes.txt:2341 a5c814fd37c640aa8a93aa10f85c235c msgid "" "**Added** Postscript image output (changed :meth:`Pixmap.save` and " ":meth:`Pixmap.tobytes`)." msgstr "" #: ../../../changes.txt:2342 f3c2525369734e7089b7c83e8cf9de47 msgid "" "**Changed** :meth:`Pixmap.save` and :meth:`Pixmap.tobytes` to ensure " "valid combinations of colorspace, alpha and output format." msgstr "" #: ../../../changes.txt:2343 b9e74f4416644fccb65daa7e89c723c3 msgid "" "**Changed** :meth:`Pixmap.save`: the desired format is now inferred from " "the filename." msgstr "" #: ../../../changes.txt:2344 2d75602bfe7c4491afe16b74bc43214f msgid "" "**Changed** FreeText annotations can now have a transparent background - " "see :meth:`Annot.update`." msgstr "" #: ../../../changes.txt:2348 6c3551ae311845ee9b99b03931d18295 msgid "**Changes in Version 1.14.5**" msgstr "" #: ../../../changes.txt:2350 bf604455e7bc49078d6f8fad925b9c40 msgid "" "**Changed:** :ref:`Shape` methods now strictly use the transformation " "matrix of the :ref:`Page` -- instead of \"manually\" calculating " "locations." msgstr "" #: ../../../changes.txt:2351 a31dae7889694da7be488d4e185ec9eb msgid "" "**Added** method :meth:`Pixmap.pixel` which returns the pixel value (a " "list) for given pixel coordinates." msgstr "" #: ../../../changes.txt:2352 27fb489fd3c4437dae7d84ea827220f4 msgid "" "**Added** method :meth:`Pixmap.tobytes` which returns a bytes object " "representing the pixmap in a variety of formats. Previously, this could " "be done for PNG outputs only (:meth:`Pixmap.tobytes`)." msgstr "" #: ../../../changes.txt:2353 1c71f20d72344b9d92a9db58d371f81b msgid "" "**Changed:** output of methods :meth:`Pixmap.save` and (the new) " ":meth:`Pixmap.tobytes` may now also be PSD (Adobe Photoshop Document)." msgstr "" #: ../../../changes.txt:2354 fa29ec91aa714c5f907b7366ffb9a3b9 msgid "" "**Added** method :meth:`Shape.drawQuad` which draws a :ref:`Quad`. This " "actually is a shorthand for a :meth:`Shape.drawPolyline` with the edges " "of the quad." msgstr "" #: ../../../changes.txt:2355 91031a98d09349dbb69473db2e7329ec msgid "" "**Changed** method :meth:`Shape.drawOval`: the argument can now be " "**either** a rectangle (:data:`rect_like`) **or** a quadrilateral " "(:data:`quad_like`)." msgstr "" #: ../../../changes.txt:2359 0e8436f8a5324f5c854c6da3891f584a msgid "**Changes in Version 1.14.4**" msgstr "" #: ../../../changes.txt:2361 f161930e41614a59bd8398be1a48b0c9 msgid "**Fixes** issue #239 \"Annotation coordinate consistency\"." msgstr "" #: ../../../changes.txt:2366 f717329397b04912b44b761001662800 msgid "**Changes in Version 1.14.3**" msgstr "" #: ../../../changes.txt:2368 c8623149250744e589dc449330738ae7 msgid "This patch version contains minor bug fixes and CJK font output support." msgstr "" #: ../../../changes.txt:2370 090ca3d9b2344ba888c0876c7b71ace0 msgid "" "**Added** support for the four CJK fonts as PyMuPDF generated text " "output. This pertains to methods :meth:`Page.insertFont`, " ":meth:`Shape.insertText`, :meth:`Shape.insertTextbox`, and corresponding " ":ref:`Page` methods. The new fonts are available under \"reserved\" " "fontnames \"china-t\" (traditional Chinese), \"china-s\" (simplified " "Chinese), \"japan\" (Japanese), and \"korea\" (Korean)." msgstr "" #: ../../../changes.txt:2371 0883c9f987274b41ae7f270c3f497622 msgid "**Added** full support for the built-in fonts 'Symbol' and 'Zapfdingbats'." msgstr "" #: ../../../changes.txt:2372 28cecba376654ea4aabaf41a9a9e76a0 msgid "" "**Changed:** The 14 standard fonts can now each be referenced by a " "4-letter abbreviation." msgstr "" #: ../../../changes.txt:2376 2af6e8674b4443da9ecbfff548ce5a69 msgid "**Changes in Version 1.14.1**" msgstr "" #: ../../../changes.txt:2378 b0f0dfdd4d05439fbb192a2fff012afd msgid "This patch version contains minor performance improvements." msgstr "" #: ../../../changes.txt:2380 d55c7a1c5617427cae944d98885ab488 msgid "" "**Added** support for :ref:`Document` filenames given as *pathlib* object" " by using the Python *str()* function." msgstr "" #: ../../../changes.txt:2385 8408ffdc08bd4b988e1d1d8706e8852d msgid "**Changes in Version 1.14.0**" msgstr "" #: ../../../changes.txt:2387 5e88bed306444855bb7cb18769259f07 msgid "" "To support MuPDF v1.14.0, massive changes were required in PyMuPDF -- " "most of them purely technical, with little visibility to developers. But " "there are also quite a lot of interesting new and improved features. " "Following are the details:" msgstr "" #: ../../../changes.txt:2389 ddc84ec9e77d406180396849960f6fd3 msgid "**Added** \"ink\" annotation." msgstr "" #: ../../../changes.txt:2390 5ef49f9b2028452da946e586194111bd msgid "**Added** \"rubber stamp\" annotation." msgstr "" #: ../../../changes.txt:2391 4a7bb926db894ea39c7f10315f2e825a msgid "**Added** \"squiggly\" text marker annotation." msgstr "" #: ../../../changes.txt:2392 3398303dd33846db9cfde43f06070d2d msgid "" "**Added** new class :ref:`Quad` (quadrilateral or tetragon) -- which " "represents a general four-sided shape in the plane. The special subtype " "of rectangular, non-empty tetragons is used in text marker annotations " "and as returned objects in text search methods." msgstr "" #: ../../../changes.txt:2393 6c56ac281b924d2fb189ede6e9c8be61 msgid "" "**Added** a new option \"decrypt\" to :meth:`Document.save` and " ":meth:`Document.write`. Now you can **keep encryption** when saving a " "password protected PDF." msgstr "" #: ../../../changes.txt:2394 b394b2a1574646c89160273346915f47 msgid "" "**Added** suppression and redirection of unsolicited messages issued by " "the underlying C-library MuPDF. Consult :ref:`RedirectMessages` for " "details." msgstr "" #: ../../../changes.txt:2395 47856295d652463f8184801b60dee8a0 msgid "" "**Changed:** Changes to annotations now **always require** " ":meth:`Annot.update` to become effective." msgstr "" #: ../../../changes.txt:2396 ef1b316a5b024381bc8ab808d69d2891 msgid "" "**Changed** free text annotations to support the full Latin character set" " and range of appearance options." msgstr "" #: ../../../changes.txt:2397 506d4cd601f04e2c83386b5ec8940898 msgid "" "**Changed** text searching, :meth:`Page.searchFor`, to optionally return " ":ref:`Quad` instead :ref:`Rect` objects surrounding each search hit." msgstr "" #: ../../../changes.txt:2398 4fd963295c354372b9e8574e51f097ee msgid "" "**Changed** plain text output: we now add a *\\n* to each line if it does" " not itself end with this character." msgstr "" #: ../../../changes.txt:2399 1db7b0929bbf4596b2a0d22f3ca7b59c msgid "**Fixed** issue 211 (\"Something wrong in the doc\")." msgstr "" #: ../../../changes.txt:2400 f1128c764272467f8fb8a6c3a9b0087e msgid "" "**Fixed** issue 213 (\"Rewritten outline is displayed only by mupdf-based" " applications\")." msgstr "" #: ../../../changes.txt:2401 f7b1e5c7dc7c4676a9bf4838c03b508c msgid "**Fixed** issue 214 (\"PDF decryption GONE!\")." msgstr "" #: ../../../changes.txt:2402 7a1c216e3cf04513bac8a38d46fb777a msgid "**Fixed** issue 215 (\"Formatting of links added with pyMuPDF\")." msgstr "" #: ../../../changes.txt:2403 9c9ae8e5f826442d8888cefae230e64e msgid "**Fixed** issue 217 (\"extraction through json is failing for my pdf\")." msgstr "" #: ../../../changes.txt:2405 5ae51da467b64e26bfb10cf525eb9581 msgid "" "Behind the curtain, we have changed the implementation of geometry " "objects: they now purely exist in Python and no longer have \"shadow\" " "twins on the C-level (in MuPDF). This has improved processing speed in " "that area by more than a factor of two." msgstr "" #: ../../../changes.txt:2407 b5211152c64342a49990467a8d763bd5 msgid "" "Because of the same reason, most methods involving geometry parameters " "now also accept the corresponding Python sequence. For example, in method" " *\"page.show_pdf_page(rect, ...)\"* parameter *rect* may now be any " ":data:`rect_like` sequence." msgstr "" #: ../../../changes.txt:2409 79b7deaba4ec49f58fd8987c7e950e28 msgid "" "We also invested considerable effort to further extend and improve the " ":ref:`FAQ` chapter." msgstr "" #: ../../../changes.txt:2414 fd91322d1a494ed189d8932bb19e425a msgid "**Changes in Version 1.13.19**" msgstr "" #: ../../../changes.txt:2416 c99f01c86e0f418e8ece858b509f575f msgid "" "This version contains some technical / performance improvements and bug " "fixes." msgstr "" #: ../../../changes.txt:2418 f6ca673e1a514b8c88882528546fc938 #, python-format msgid "" "**Changed** memory management: for Python 3 builds, Python memory " "management is exclusively used across all C-level code (i.e. no more " "native *malloc()* in MuPDF code or PyMuPDF interface code). This leads to" " improved memory usage profiles and also some runtime improvements: we " "have seen > 2% shorter runtimes for text extractions and pixmap creations" " (on Windows machines only to date)." msgstr "" #: ../../../changes.txt:2419 5bfccbbb021842b9abb0b04bf9de48c3 msgid "" "**Fixed** an error occurring in Python 2.7, which crashed the interpreter" " when using :meth:`TextPage.extractRAWDICT` (= " "*Page.getText(\"rawdict\")*)." msgstr "" #: ../../../changes.txt:2420 0f2cb31dfbf9466fa8a235d46d2c6e8a msgid "" "**Fixed** an error occurring in Python 2.7, when creating link " "destinations." msgstr "" #: ../../../changes.txt:2421 08e34b265b7e454f94220ea943997f4d msgid "**Extended** the :ref:`FAQ` chapter with more examples." msgstr "" #: ../../../changes.txt:2425 63b7e43da4034c64859e960033709c83 msgid "**Changes in Version 1.13.18**" msgstr "" #: ../../../changes.txt:2427 cf5beb6e03c54affafc84f316858c9aa msgid "" "**Added** method :meth:`TextPage.extractRAWDICT`, and a corresponding new" " string parameter \"rawdict\" to method :meth:`Page.getText`. It extracts" " text and images from a page in Python *dict* form like " ":meth:`TextPage.extractDICT`, but with the detail level of " ":meth:`TextPage.extractXML`, which is position information down to each " "single character." msgstr "" #: ../../../changes.txt:2431 9b563f0c8c3a4d1fb8e8fe127bb76d6c msgid "**Changes in Version 1.13.17**" msgstr "" #: ../../../changes.txt:2433 b3c0162af9db4f608389e2c811c7bc4b msgid "" "**Fixed** an error that intermittently caused an exception in " ":meth:`Page.show_pdf_page`, when pages from many different source PDFs " "were shown." msgstr "" #: ../../../changes.txt:2434 c35c79318b584e5790dbea763351299b msgid "" "**Changed** method :meth:`Document.extractImage` to now return more meta " "information about the extracted image. Also, its performance has been " "greatly improved. Several demo scripts have been changed to make use of " "this method." msgstr "" #: ../../../changes.txt:2435 ef0a501dd401489f8d0796417bf84a65 msgid "" "**Changed** method :meth:`Document._getXrefStream` to now return *None* " "if the object is no stream and no longer raise an exception if otherwise." msgstr "" #: ../../../changes.txt:2436 7032fecda32745aeb0b54febfa6571f7 msgid "" "**Added** method :meth:`Document._deleteObject` which deletes a PDF " "object identified by its :data:`xref`. Only to be used by the experienced" " PDF expert." msgstr "" #: ../../../changes.txt:2437 64f62a994fb742cf84570443580cf6a2 msgid "" "**Added** a method :meth:`paper_rect` which returns a :ref:`Rect` for a " "supplied paper format string. Example: *fitz.paper_rect(\"letter\") = " "fitz.Rect(0.0, 0.0, 612.0, 792.0)*." msgstr "" #: ../../../changes.txt:2438 31e24169fc6849878acc3c4b81c2931b msgid "**Added** a :ref:`FAQ` chapter to this document." msgstr "" #: ../../../changes.txt:2442 43d63ac60a0c46a591e1b79f54377917 msgid "**Changes in Version 1.13.16**" msgstr "" #: ../../../changes.txt:2444 d904d04d3cfb4dcda46139c25fe24c71 msgid "" "**Added** support for correctly setting transparency (opacity) for " "certain annotation types." msgstr "" #: ../../../changes.txt:2445 3b7e735489e94623ac095480bdcbc2a5 msgid "" "**Added** a tool property (:attr:`Tools.fitz_config`) showing the " "configuration of this PyMuPDF version." msgstr "" #: ../../../changes.txt:2446 9c879f61145948b188ee8d93c5efe154 msgid "" "**Fixed** issue #193 ('insertText(overlay=False) gives \"cannot resize a " "buffer with shared storage\" error') by avoiding read-only buffers." msgstr "" #: ../../../changes.txt:2450 5d037ed847b44095be41047f123f2c7d msgid "**Changes in Version 1.13.15**" msgstr "" #: ../../../changes.txt:2452 7b20562ab960458cb2a37834b262bc0a msgid "" "**Fixed** issue #189 (\"cannot find builtin CJK font\"), so we are " "supporting builtin CJK fonts now (CJK = China, Japan, Korea). This should" " lead to correctly generated pixmaps for documents using these languages." " This change has consequences for our binary file size: it will now range" " between 8 and 10 MB, depending on the OS." msgstr "" #: ../../../changes.txt:2453 09714417974d4784bbb8ce28449b0ed4 msgid "" "**Fixed** issue #191 (\"Jupyter notebook kernel dies after ca. 40 " "pages\"), which occurred when modifying the contents of an annotation." msgstr "" #: ../../../changes.txt:2457 5adc29b99ec94005bffd7ef24998e110 msgid "**Changes in Version 1.13.14**" msgstr "" #: ../../../changes.txt:2459 7f38a7f515424bdf958094ead9ab7ef0 msgid "This patch version contains several improvements, mainly for annotations." msgstr "" #: ../../../changes.txt:2461 b1c7424aa4d54a5caefae33e0e5f4f84 msgid "" "**Changed** :attr:`Annot.lineEnds` is now a list of two integers " "representing the line end symbols. Previously was a *dict* of strings." msgstr "" #: ../../../changes.txt:2462 641b3d6d6a8f46359ce78aacec1a00fe msgid "" "**Added** support of line end symbols for applicable annotations. PyMuPDF" " now can generate these annotations including the line end symbols." msgstr "" #: ../../../changes.txt:2463 f00765d5f2434220a9bfa1b43ce083c6 msgid "" "**Added** :meth:`Annot.setLineEnds` adds line end symbols to applicable " "annotation types ('Line', 'PolyLine', 'Polygon')." msgstr "" #: ../../../changes.txt:2464 c43498bf8fbe4da3bbbd2a1b57eb2ade msgid "" "**Changed** technical implementation of :meth:`Page.insertImage` and " ":meth:`Page.show_pdf_page`: they now create there own contents objects, " "thereby avoiding changes of potentially large streams with consequential " "compression / decompression efforts and high change volumes with " "incremental updates." msgstr "" #: ../../../changes.txt:2468 6d6106b5cef0412c859b77efff74d76a msgid "**Changes in Version 1.13.13**" msgstr "" #: ../../../changes.txt:2470 76e178082cef4bbcaf9d02facb74a2a8 msgid "" "This patch version contains several improvements for embedded files and " "file attachment annotations." msgstr "" #: ../../../changes.txt:2472 a3ecffcb691f41e18fa492558ef375d5 msgid "" "**Added** :meth:`Document.embfile_Upd` which allows changing **file " "content and metadata** of an embedded file. It supersedes the old method " ":meth:`Document.embfile_SetInfo` (which will be deleted in a future " "version). Content is automatically compressed and metadata may be " "unicode." msgstr "" #: ../../../changes.txt:2473 8741c8c5503e49c5a9e436d200d0c70c msgid "" "**Changed** :meth:`Document.embfile_Add` to now automatically compress " "file content. Accompanying metadata can now be unicode (had to be ASCII " "in the past)." msgstr "" #: ../../../changes.txt:2474 c8825e3ce49940899586673a8c1ca760 msgid "" "**Changed** :meth:`Document.embfile_Del` to now automatically delete " "**all entries** having the supplied identifying name. The return code is " "now an integer count of the removed entries (was *None* previously)." msgstr "" #: ../../../changes.txt:2475 4958c06f7c0b4eaca87af2482582ca8c msgid "" "**Changed** embedded file methods to now also accept or show the PDF " "unicode filename as additional parameter *ufilename*." msgstr "" #: ../../../changes.txt:2476 0f95f3527f1a489a9a72167a6cee97cf msgid "" "**Added** :meth:`Page.add_file_annot` which adds a new file attachment " "annotation." msgstr "" #: ../../../changes.txt:2477 14f2faf502b74997b3e11958e4ffd5dd msgid "" "**Changed** :meth:`Annot.fileUpd` (file attachment annot) to now also " "accept the PDF unicode *ufilename* parameter. The description parameter " "*desc* correctly works with unicode. Furthermore, **all** parameters are " "optional, so metadata may be changed without also replacing the file " "content." msgstr "" #: ../../../changes.txt:2478 f11e4025175f468fb362dc45b4b459a8 msgid "" "**Changed** :meth:`Annot.fileInfo` (file attachment annot) to now also " "show the PDF unicode filename as parameter *ufilename*." msgstr "" #: ../../../changes.txt:2479 96f083ba329841dc866568603f6bf4e0 msgid "" "**Fixed** issue #180 (\"page.getText(output='dict') return invalid " "bbox\") to now also work for vertical text." msgstr "" #: ../../../changes.txt:2480 b9c17d72bfcd4a87983f018daf4d8fd9 msgid "" "**Fixed** issue #185 (\"Can't render the annotations created by " "PyMuPDF\"). The issue's cause was the minimalistic MuPDF approach when " "creating annotations. Several annotation types have no */AP* " "(\"appearance\") object when created by MuPDF functions. MuPDF, " "SumatraPDF and hence also PyMuPDF cannot render annotations without such " "an object. This fix now ensures, that an appearance object is always " "created together with the annotation itself. We still do not support line" " end styles." msgstr "" #: ../../../changes.txt:2484 17b80da49d874916b1fa04cbc2e8225e msgid "**Changes in Version 1.13.12**" msgstr "" #: ../../../changes.txt:2486 16cf3df1aa764ac99837e6ba6929de3a msgid "" "**Fixed** issue #180 (\"page.getText(output='dict') return invalid " "bbox\"). Note that this is a circumvention of an MuPDF error, which " "generates zero-height character rectangles in some cases. When this " "happens, this fix ensures a bbox height of at least fontsize." msgstr "" #: ../../../changes.txt:2487 61159291a2db420095ce281675ae121e msgid "" "**Changed** for ListBox and ComboBox widgets, the attribute list of " "selectable values has been renamed to :attr:`Widget.choice_values`." msgstr "" #: ../../../changes.txt:2488 bab6778e8c2944089f3b525aa8b0827d msgid "" "**Changed** when adding widgets, any missing of the :ref:`Base-14-Fonts` " "is automatically added to the PDF. Widget text fonts can now also be " "chosen from existing widget fonts. Any specified field values are now " "honored and lead to a field with a preset value." msgstr "" #: ../../../changes.txt:2489 30b1813eb102490a896faa64748c1400 msgid "" "**Added** :meth:`Annot.updateWidget` which allows changing existing form " "fields -- including the field value." msgstr "" #: ../../../changes.txt:2493 9bc92bc23e1a46ab8548886763c96d47 msgid "**Changes in Version 1.13.11**" msgstr "" #: ../../../changes.txt:2495 474a1a3d16e74ac7bcfe223ce5d3daad msgid "" "While the preceding patch subversions only contained various fixes, this " "version again introduces major new features:" msgstr "" #: ../../../changes.txt:2497 5edc44b1ecc84b25be1507861ce353f4 msgid "" "**Added** basic support for PDF widget annotations. You can now add PDF " "form fields of types Text, CheckBox, ListBox and ComboBox. Where " "necessary, the PDF is transformed to a Form PDF with the first added " "widget." msgstr "" #: ../../../changes.txt:2498 1a904dc65fe64ade80e693aa4edb88ae msgid "" "**Fixed** issues #176 (\"wrong file embedding\"), #177 (\"segment fault " "when invoking page.getText()\")and #179 (\"Segmentation fault using " "page.getLinks() on encrypted PDF\")." msgstr "" #: ../../../changes.txt:2503 7b2a31d79daa40d497d99853e692f397 msgid "**Changes in Version 1.13.7**" msgstr "" #: ../../../changes.txt:2505 445d2b1c88854acbb84fecfeeb62cdc1 msgid "" "**Added** support of variable page sizes for reflowable documents " "(e-books, HTML, etc.): new parameters *rect* and *fontsize* in " ":ref:`Document` creation (open), and as a separate method " ":meth:`Document.layout`." msgstr "" #: ../../../changes.txt:2506 b16382d708314b4c9ed3ac5b10f9a517 msgid "" "**Added** :ref:`Annot` creation of many annotations types: sticky notes, " "free text, circle, rectangle, line, polygon, polyline and text markers." msgstr "" #: ../../../changes.txt:2507 1444d852579b4d93837b7fe871afbf81 msgid "" "**Added** support of annotation transparency (:attr:`Annot.opacity`, " ":meth:`Annot.setOpacity`)." msgstr "" #: ../../../changes.txt:2508 d544fe252c1f408785338b846f68eb33 msgid "" "**Changed** :attr:`Annot.vertices`: point coordinates are now grouped as " "pairs of floats (no longer as separate floats)." msgstr "" #: ../../../changes.txt:2509 d7dd102d5d974b77a860d4ee2a960da8 msgid "" "**Changed** annotation colors dictionary: the two keys are now named " "*\"stroke\"* (formerly *\"common\"*) and *\"fill\"*." msgstr "" #: ../../../changes.txt:2510 8ba3ff12895543d4b2b60a1b9a3646d4 msgid "" "**Added** :attr:`Document.isDirty` which is *True* if a PDF has been " "changed in this session. Reset to *False* on each :meth:`Document.save` " "or :meth:`Document.write`." msgstr "" #: ../../../changes.txt:2514 572be3e137d346d1bc831219977e2a47 msgid "**Changes in Version 1.13.6**" msgstr "" #: ../../../changes.txt:2516 32c7a915842343e78b6da4d29061d488 msgid "" "Fix #173: for memory-resident documents, ensure the stream object will " "not be garbage-collected by Python before document is closed." msgstr "" #: ../../../changes.txt:2520 dfb8278835404213b0f3e00e10fa6f44 msgid "**Changes in Version 1.13.5**" msgstr "" #: ../../../changes.txt:2522 d0f227e259ff4badbddfa8bc99f77761 msgid "" "New low-level method :meth:`Page._setContents` defines an object given by" " its :data:`xref` to serve as the :data:`contents` object." msgstr "" #: ../../../changes.txt:2523 f305bdd0987e4a1f95ef94714cb586b7 msgid "" "Changed and extended PDF form field support: the attribute *widget_text* " "has been renamed to :attr:`Annot.widget_value`. Values of all form field " "types (except signatures) are now supported. A new attribute " ":attr:`Annot.widget_choices` contains the selectable values of listboxes " "and comboboxes. All these attributes now contain *None* if no value is " "present." msgstr "" #: ../../../changes.txt:2527 4fd769eb21f048a19b8230f7e72178ca msgid "**Changes in Version 1.13.4**" msgstr "" #: ../../../changes.txt:2529 53ed864ab32f470bb28b858354a50e08 msgid "" ":meth:`Document.convertToPDF` now supports page ranges, reverted page " "sequences and page rotation. If the document already is a PDF, an " "exception is raised." msgstr "" #: ../../../changes.txt:2530 76b57e7db1504c5aba637f3c1da9e11c msgid "" "Fixed a bug (introduced with v1.13.0) that prevented " ":meth:`Page.insertImage` for transparent images." msgstr "" #: ../../../changes.txt:2534 2ee92c34815a4f8fb2c8e58d119f4ea1 msgid "**Changes in Version 1.13.3**" msgstr "" #: ../../../changes.txt:2536 b6964dbe69ac4c14913e804c1db84219 msgid "" "Introduces a way to convert **any MuPDF supported document** to a PDF. If" " you ever wanted PDF versions of your XPS, EPUB, CBZ or FB2 files -- here" " is a way to do this." msgstr "" #: ../../../changes.txt:2538 3b8c44dc6cc2424186ca83fb933f4d4d msgid "" ":meth:`Document.convertToPDF` returns a Python *bytes* object in PDF " "format. Can be opened like normal in PyMuPDF, or be written to disk with " "the *\".pdf\"* extension." msgstr "" #: ../../../changes.txt:2542 a74fa53b1f63473e95f8ae83eadc426f msgid "**Changes in Version 1.13.2**" msgstr "" #: ../../../changes.txt:2544 7ebed477136d45edbc0674eaaa9dff08 msgid "" "The major enhancement is PDF form field support. Form fields are " "annotations of type *(19, 'Widget')*. There is a new document method to " "check whether a PDF is a form. The :ref:`Annot` class has new properties " "describing field details." msgstr "" #: ../../../changes.txt:2546 6224991d69044aed91933c6ef3db8872 msgid "" ":attr:`Document.is_form_pdf` is true if object type */AcroForm* and at " "least one form field exists." msgstr "" #: ../../../changes.txt:2547 3c3eddc4ca6a41179dba2d970ae478cf msgid "" ":attr:`Annot.widget_type`, :attr:`Annot.widget_text` and " ":attr:`Annot.widget_name` contain the details of a form field (i.e. a " "\"Widget\" annotation)." msgstr "" #: ../../../changes.txt:2551 33caa17db3314e8f8ec675dfcc887087 msgid "**Changes in Version 1.13.1**" msgstr "" #: ../../../changes.txt:2553 9344a01be7c64abbbe4577c065593441 msgid "" ":meth:`TextPage.extractDICT` is a new method to extract the contents of a" " document page (text and images). All document types are supported as " "with the other :ref:`TextPage` *extract*()* methods. The returned object " "is a dictionary of nested lists and other dictionaries, and **exactly " "equal** to the JSON-deserialization of the old " ":meth:`TextPage.extractJSON`. The difference is that the result is " "created directly -- no JSON module is used. Because the user needs no " "JSON module to interpret the information, it should be easier to use, and" " also have a better performance, because it contains images in their " "original **binary format** -- they need not be base64-decoded." msgstr "" #: ../../../changes.txt:2554 a0c4ad5a3c484f91ac0a8e10f14f5e12 msgid "" ":meth:`Page.getText` correspondingly supports the new parameter value " "*\"dict\"* to invoke the above method." msgstr "" #: ../../../changes.txt:2555 093f2f8fbd7d47c8a423fd962433aaf6 msgid "" ":meth:`TextPage.extractJSON` (resp. *Page.getText(\"json\")*) is still " "supported for convenience, but its use is expected to decline." msgstr "" #: ../../../changes.txt:2559 0502f4342d864193843c189056a3f649 msgid "**Changes in Version 1.13.0**" msgstr "" #: ../../../changes.txt:2561 a1fd3f8dcf7347f0b02e341033bab447 msgid "" "This version is based on MuPDF v1.13.0. This release is \"primarily a bug" " fix release\"." msgstr "" #: ../../../changes.txt:2563 f6293a0c60534e0aa61af056ce5873ab msgid "" "In PyMuPDF, we are also doing some bug fixes while introducing minor " "enhancements. There only very minimal changes to the user's API." msgstr "" #: ../../../changes.txt:2565 112b9e394ace4296b2004b9cc2566a4c msgid "" ":ref:`Document` construction is more flexible: the new *filetype* " "parameter allows setting the document type. If specified, any extension " "in the filename will be ignored. More completely addresses `issue #156 " "`_. As part of this, the " "documentation has been reworked." msgstr "" #: ../../../changes.txt:2569 1fd37787dc5e4b74860ae968de485c3a msgid "Changes to :ref:`Pixmap` constructors:" msgstr "" #: ../../../changes.txt:2568 b1dfea15e23f480e9294338557073269 msgid "" "Colorspace conversion no longer allows dropping the alpha channel: source" " and target **alpha will now always be the same**. We have seen " "exceptions and even interpreter crashes when using *alpha = 0*." msgstr "" #: ../../../changes.txt:2569 d13b23318d24436a98e726ab0c700090 msgid "As a replacement, the simple pixmap copy lets you choose the target alpha." msgstr "" #: ../../../changes.txt:2571 1245466299bd401c91dede79edbe0761 msgid "" ":meth:`Document.save` again offers the full garbage collection range 0 " "thru 4. Because of a bug in :data:`xref` maintenance, we had to " "temporarily enforce *garbage > 1*. Finally resolves `issue #148 " "`_." msgstr "" #: ../../../changes.txt:2573 5e0acf1f4a8b4284b68c4664d8506094 msgid "" ":meth:`Document.save` now offers to \"prettify\" PDF source via an " "additional argument." msgstr "" #: ../../../changes.txt:2574 696c719c11ba4d4f8436604179238f4f msgid "" ":meth:`Page.insertImage` has the additional *stream* \\-parameter, " "specifying a memory area holding an image." msgstr "" #: ../../../changes.txt:2576 083d9194c33f41068f0776f565c79c87 msgid "" "Issue with garbled PNGs on Linux systems has been resolved (`\"Problem " "writing PNG\" #133) `_." msgstr "" #: ../../../changes.txt:2581 98cc7e1927894f43bd5433b0231b3dcf msgid "**Changes in Version 1.12.4**" msgstr "" #: ../../../changes.txt:2583 7611c52e40a247d499880fc162bf20bb msgid "This is an extension of 1.12.3." msgstr "" #: ../../../changes.txt:2585 55de61bfb5954f95b17921dcd4914391 msgid "" "Fix of `issue #147 `_: " "methods :meth:`Document.getPageFontlist` and " ":meth:`Document.getPageImagelist` now also show fonts and images " "contained in :data:`resources` nested via \"Form XObjects\"." msgstr "" #: ../../../changes.txt:2586 241a50f48e4b403481f23435638646e1 msgid "" "Temporary fix of `issue #148 " "`_: Saving to new PDF " "files will now automatically use *garbage = 2* if a lower value is given." " Final fix is to be expected with MuPDF's next version. At that point we " "will remove this circumvention." msgstr "" #: ../../../changes.txt:2587 d1aeb27a9161455f91a41a0c53d1de52 msgid "" "Preventive fix of illegally using stencil / image mask pixmaps in some " "methods." msgstr "" #: ../../../changes.txt:2588 4d9f3bf7e9db4f75a524f3e201db2d32 msgid "" "Method :meth:`Document.getPageFontlist` now includes the encoding name " "for each font in the list." msgstr "" #: ../../../changes.txt:2589 da72830c7d2c40009f927c37bd604e55 msgid "" "Method :meth:`Document.getPageImagelist` now includes the decode method " "name for each image in the list." msgstr "" #: ../../../changes.txt:2593 b3c6fae68a704c8eb5f4e78304a1d854 msgid "**Changes in Version 1.12.3**" msgstr "" #: ../../../changes.txt:2595 4c52faae63874d45873aa766f417ab6f msgid "This is an extension of 1.12.2." msgstr "" #: ../../../changes.txt:2597 943612aea06749f4962d1ced1418925a msgid "" "Many functions now return *None* instead of *0*, if the result has no " "other meaning than just indicating successful execution " "(:meth:`Document.close`, :meth:`Document.save`, :meth:`Document.select`, " ":meth:`Pixmap.save` and many others)." msgstr "" #: ../../../changes.txt:2601 6f0d4e2bdd41401d94ed4fe0fd9ec7e8 msgid "**Changes in Version 1.12.2**" msgstr "" #: ../../../changes.txt:2603 630bed92f4e34421925b88efe1ba42b6 msgid "This is an extension of 1.12.1." msgstr "" #: ../../../changes.txt:2605 50a351aa4579484893c9094cda2cfeba msgid "" "Method :meth:`Page.show_pdf_page` now accepts the new *clip* argument. " "This specifies an area of the source page to which the display should be " "restricted." msgstr "" #: ../../../changes.txt:2607 80570d982b004e41989292ba7bb4ddb9 msgid "" "New :attr:`Page.CropBox` and :attr:`Page.MediaBox` have been included for" " convenience." msgstr "" #: ../../../changes.txt:2612 54fd6f1c51e04778bac0835de4f0361a msgid "**Changes in Version 1.12.1**" msgstr "" #: ../../../changes.txt:2614 db11fc420c4b4bd59ba30cf2a4f190d3 msgid "This is an extension of version 1.12.0." msgstr "" #: ../../../changes.txt:2616 82affdfbc4bb42ccabe2c77070a11719 msgid "" "New method :meth:`Page.show_pdf_page` displays another's PDF page. This " "is a **vector** image and therefore remains precise across zooming. Both " "involved documents must be PDF." msgstr "" #: ../../../changes.txt:2618 f0e7a4343cf14d058e07063707db7b7e msgid "" "New method :meth:`Page.getSVGimage` creates an SVG image from the page. " "In contrast to the raster image of a pixmap, this is a vector image " "format. The return is a unicode text string, which can be saved in a " "*.svg* file." msgstr "" #: ../../../changes.txt:2620 c81d51dc94f646fda815c43c09bab73d msgid "" "Method :meth:`Page.getTextBlocks` now accepts an additional bool " "parameter \"images\". If set to true (default is false), image blocks " "(metadata only) are included in the produced list and thus allow " "detecting areas with rendered images." msgstr "" #: ../../../changes.txt:2622 5eafe44f47b34527bfff5138b15affd3 msgid "Minor bug fixes." msgstr "" #: ../../../changes.txt:2624 6bf7252d584b4c8e9b97592fc0d934e4 msgid "" "\"text\" result of :meth:`Page.getText` concatenates all lines within a " "block using a single space character. MuPDF's original uses \"\\\\n\" " "instead, producing a rather ragged output." msgstr "" #: ../../../changes.txt:2626 94bf5fb0e50249e78857f02ebaaff525 msgid "" "New properties of :ref:`Page` objects :attr:`Page.MediaBoxSize` and " ":attr:`Page.CropBoxPosition` provide more information about a page's " "dimensions. For non-PDF files (and for most PDF files, too) these will be" " equal to :attr:`Page.rect.bottom_right`, resp. " ":attr:`Page.rect.top_left`. For example, class :ref:`Shape` makes use of " "them to correctly position its items." msgstr "" #: ../../../changes.txt:2630 74d15ecb1b914538a684a22683984be7 msgid "**Changes in Version 1.12.0**" msgstr "" #: ../../../changes.txt:2632 ac50d19ead2044d4afef9637fadb68d5 msgid "" "This version is based on and requires MuPDF v1.12.0. The new MuPDF " "version contains quite a number of changes -- most of them around text " "extraction. Some of the changes impact the programmer's API." msgstr "" #: ../../../changes.txt:2634 1b465153b5814abe8ed0d412684e1e54 msgid "" ":meth:`Outline.saveText` and :meth:`Outline.saveXML` have been deleted " "without replacement. You probably haven't used them much anyway. But if " "you are looking for a replacement: the output of :meth:`Document.get_toc`" " can easily be used to produce something equivalent." msgstr "" #: ../../../changes.txt:2636 b2b48a42c44c4a1dab5f5c66edaf406a msgid "Class *TextSheet* does no longer exist." msgstr "" #: ../../../changes.txt:2638 f6faca5ccc3b4ddab529d2c73f600396 msgid "" "Text \"spans\" (one of the hierarchy levels of :ref:`TextPage`) no longer" " contain positioning information (i.e. no \"bbox\" key). Instead, spans " "now provide the font information for its text. This impacts our JSON " "output variant." msgstr "" #: ../../../changes.txt:2640 cc737a16a9114bea9f2892a3d611d32f msgid "" "HTML output has improved very much: it now creates valid documents which " "can be displayed by browsers to produce a similar view as the original " "document." msgstr "" #: ../../../changes.txt:2642 88630dce5a784283a7c487d4fd39dfe4 msgid "" "There is a new output format XHTML, which provides text and images in a " "browser-readable format. The difference to HTML output is, that no effort" " is made to reproduce the original layout." msgstr "" #: ../../../changes.txt:2644 3af5ba7ff439426696f0f07a23e1d8fa msgid "" "All output formats of :meth:`Page.getText` now support creating complete," " valid documents, by wrapping them with appropriate header and trailer " "information. If you are interested in using the HTML output, please make " "sure to read :ref:`HTMLQuality`." msgstr "" #: ../../../changes.txt:2646 87e42d9c77a54890af57f976c5071ba7 msgid "" "To support finding text positions, we have added special methods that " "don't need detours like :meth:`TextPage.extractJSON` or " ":meth:`TextPage.extractXML`: use :meth:`Page.getTextBlocks` or resp. " ":meth:`Page.getTextWords` to create lists of text blocks or resp. words, " "which are accompanied by their rectangles. This should be much faster " "than the standard text extraction methods and also avoids using " "additional packages for interpreting their output." msgstr "" #: ../../../changes.txt:2651 239ae39492b748df849ea403ef2108f0 msgid "**Changes in Version 1.11.2**" msgstr "" #: ../../../changes.txt:2653 2c6897b2b1734812a1b0c402d1ba8907 msgid "This is an extension of v1.11.1." msgstr "" #: ../../../changes.txt:2655 b024b8bd2f954e69a9f3a58c001cc2d8 msgid "" "New :meth:`Page.insertFont` creates a PDF */Font* object and returns its " "object number." msgstr "" #: ../../../changes.txt:2657 17bf32eed08e4af7a9235c26da714f4c msgid "" "New :meth:`Document.extractFont` extracts the content of an embedded font" " given its object number." msgstr "" #: ../../../changes.txt:2659 8a06bf9858264b8aaddd5dcc4b335cca msgid "" "Methods **FontList(...)** items no longer contain the PDF generation " "number. This value never had any significance. Instead, the font file " "extension is included (e.g. \"pfa\" for a \"PostScript Font for ASCII\")," " which is more valuable information." msgstr "" #: ../../../changes.txt:2661 f45d17bd4282467ca8855a3a25ae091d msgid "Fonts other than \"simple fonts\" (Type1) are now also supported." msgstr "" #: ../../../changes.txt:2663 18c58364a89d48b6aa981d0c901c91ea msgid "New options to change :ref:`Pixmap` size:" msgstr "" #: ../../../changes.txt:2665 399900b7d04b4cda9bdb0645844fa951 msgid "Method :meth:`Pixmap.shrink` reduces the pixmap proportionally in place." msgstr "" #: ../../../changes.txt:2667 3c624215a18b4ee5acf3b3f95f7d3b8f msgid "" "A new :ref:`Pixmap` copy constructor allows scaling via setting target " "width and height." msgstr "" #: ../../../changes.txt:2672 787726e4ea8e4f998d5c45f15750e062 msgid "**Changes in Version 1.11.1**" msgstr "" #: ../../../changes.txt:2674 3f97c63d1ab042b0938270157fe47048 msgid "This is an extension of v1.11.0." msgstr "" #: ../../../changes.txt:2676 51d6f21f07544106b1652c72ebc2ffe2 msgid "" "New class *Shape*. It facilitates and extends the creation of image " "shapes on PDF pages. It contains multiple methods for creating elementary" " shapes like lines, rectangles or circles, which can be combined into " "more complex ones and be given common properties like line width or " "colors. Combined shapes are handled as a unit and e.g. be \"morphed\" " "together. The class can accumulate multiple complex shapes and put them " "all in the page's foreground or background -- thus also reducing the " "number of updates to the page's :data:`contents` object." msgstr "" #: ../../../changes.txt:2678 2d4cfa604e58468ea1577f10209e6280 msgid "All *Page* draw methods now use the new *Shape* class." msgstr "" #: ../../../changes.txt:2680 fc7ba2646c3448c297ae41f9fadeda05 msgid "" "Text insertion methods *insertText()* and *insertTextBox()* now support " "morphing in addition to text rotation. They have become part of the " "*Shape* class and thus allow text to be freely combined with graphics." msgstr "" #: ../../../changes.txt:2682 737fb07ba7c242ff9478cdcd66f9c5ec msgid "" "A new *Pixmap* constructor allows creating pixmap copies with an added " "alpha channel. A new method also allows directly manipulating alpha " "values." msgstr "" #: ../../../changes.txt:2684 8ce597ee78ed4486bbf604c79de4b733 msgid "" "Binary algebraic operations with geometry objects (matrices, rectangles " "and points) now generally also support lists or tuples as the second " "operand. You can add a tuple *(x, y)* of numbers to a :ref:`Point`. In " "this context, such sequences are called \":data:`point_like`\" (resp. " ":data:`matrix_like`, :data:`rect_like`)." msgstr "" #: ../../../changes.txt:2686 5788fb7d7f784ac09ae37611ece715fa msgid "" "Geometry objects now fully support in-place operators. For example, *p /=" " m* replaces point p with *p * 1/m* for a number, or *p * ~m* for a " ":data:`matrix_like` object *m*. Similarly, if *r* is a rectangle, then *r" " |= (3, 4)* is the new rectangle that also includes *fitz.Point(3, 4)*, " "and *r &= (1, 2, 3, 4)* is its intersection with *fitz.Rect(1, 2, 3, 4)*." msgstr "" #: ../../../changes.txt:2690 34897b5e1f8042e392f5a46fcd148809 msgid "**Changes in Version 1.11.0**" msgstr "" #: ../../../changes.txt:2692 d292bd8392b648e4a31cef92ae09f8b5 msgid "This version is based on and requires MuPDF v1.11." msgstr "" #: ../../../changes.txt:2694 6de44e4ec25b476cb9fc163cdece9c5f msgid "" "Though MuPDF has declared it as being mostly a bug fix version, one major" " new feature is indeed contained: support of embedded files -- also " "called portfolios or collections. We have extended PyMuPDF functionality " "to embrace this up to an extent just a little beyond the *mutool* utility" " as follows." msgstr "" #: ../../../changes.txt:2696 3f70b50c029542ff87e1112b28bb11f5 msgid "" "The *Document* class now support embedded files with several new methods " "and one new property:" msgstr "" #: ../../../changes.txt:2698 1922650fdba747cd960cf08984a60150 msgid "" "*embfile_Info()* returns metadata information about an entry in the list " "of embedded files. This is more than *mutool* currently provides: it " "shows all the information that was used to embed the file (not just the " "entry's name)." msgstr "" #: ../../../changes.txt:2699 3a1e2417a0dd47e985c0fd31c45e52fa msgid "" "*embfile_Get()* retrieves the (decompressed) content of an entry into a " "*bytes* buffer." msgstr "" #: ../../../changes.txt:2700 9c68f32b3ab04c2ba2849db67d9b5edc msgid "" "*embfile_Add(...)* inserts new content into the PDF portfolio. We (in " "contrast to *mutool*) **restrict** this to entries with a **new name** " "(no duplicate names allowed)." msgstr "" #: ../../../changes.txt:2701 274f3e1bbceb4acfb7ceb07d7a164afb msgid "" "*embfile_Del(...)* deletes an entry from the portfolio (function not " "offered in MuPDF)." msgstr "" #: ../../../changes.txt:2702 0a75c5b044d54d62b32f6e6a9c1bb143 msgid "" "*embfile_SetInfo()* -- changes filename or description of an embedded " "file." msgstr "" #: ../../../changes.txt:2703 f80bb0230db84d0fb5d130853430ffb0 msgid "*embfile_Count* -- contains the number of embedded files." msgstr "" #: ../../../changes.txt:2705 5474da97a2ee44f59d0e2fd58ad55665 msgid "" "Several enhancements deal with streamlining geometry objects. These are " "not connected to the new MuPDF version and most of them are also " "reflected in PyMuPDF v1.10.0. Among them are new properties to identify " "the corners of rectangles by name (e.g. *Rect.bottom_right*) and new " "methods to deal with set-theoretic questions like *Rect.contains(x)* or " "*IRect.intersects(x)*. Special effort focussed on supporting more " "\"Pythonic\" language constructs: *if x in rect ...* is equivalent to " "*rect.contains(x)*." msgstr "" #: ../../../changes.txt:2707 2a7db4a61ce24c848f83c0863bad09b7 msgid "" "The :ref:`Rect` chapter now has more background on empty amd infinite " "rectangles and how we handle them. The handling itself was also updated " "for more consistency in this area." msgstr "" #: ../../../changes.txt:2709 33aee8dea574413681caf242adf8da6a msgid "We have started basic support for **generation** of PDF content:" msgstr "" #: ../../../changes.txt:2711 deb4a2603a53455cb82d849ad34308aa msgid "" "*Document.insert_page()* adds a new page into a PDF, optionally " "containing some text." msgstr "" #: ../../../changes.txt:2712 f7497c0e1764493a945c64046add98a1 msgid "*Page.insertImage()* places a new image on a PDF page." msgstr "" #: ../../../changes.txt:2713 59797715081c4303a9d023f624eeda19 msgid "*Page.insertText()* puts new text on an existing page" msgstr "" #: ../../../changes.txt:2715 1e1119160b9b47b6838fe3a16078aabc msgid "" "For **FileAttachment** annotations, content and name of the attached file" " can extracted and changed." msgstr "" #: ../../../changes.txt:2719 b6b1a71f6e9c4006ad908aca83e94958 msgid "**Changes in Version 1.10.0**" msgstr "" #: ../../../changes.txt:2721 2d15107ed72748df88b1f193e0590a28 msgid "**MuPDF v1.10 Impact**" msgstr "" #: ../../../changes.txt:2723 bcefb5c4e9884f03a30f600abedbeb81 msgid "" "MuPDF version 1.10 has a significant impact on our bindings. Some of the " "changes also affect the API -- in other words, **you** as a PyMuPDF user." msgstr "" #: ../../../changes.txt:2725 50ef82a6f0904d01b9d131853ef968fe msgid "" "Link destination information has been reduced. Several properties of the " "*linkDest* class no longer contain valuable information. In fact, this " "class as a whole has been deleted from MuPDF's library and we in PyMuPDF " "only maintain it to provide compatibility to existing code." msgstr "" #: ../../../changes.txt:2727 e0f444dd42e048608c890061f2205bab msgid "" "In an effort to minimize memory requirements, several improvements have " "been built into MuPDF v1.10:" msgstr "" #: ../../../changes.txt:2729 dd57640466d6465693ecfa9e6153edb1 msgid "" "A new *config.h* file can be used to de-select unwanted features in the C" " base code. Using this feature we have been able to reduce the size of " "our binary *_fitz.o* / *_fitz.pyd* by about 50% (from 9 MB to 4.5 MB). " "When UPX-ing this, the size goes even further down to a very handy 2.3 " "MB." msgstr "" #: ../../../changes.txt:2731 42d66398d41a44a099a22715ab110b6a msgid "" "The alpha (transparency) channel for pixmaps is now optional. Letting " "alpha default to *False* significantly reduces pixmap sizes (by 20% -- " "CMYK, 25% -- RGB, 50% -- GRAY). Many *Pixmap* constructors therefore now " "accept an *alpha* boolean to control inclusion of this channel. Other " "pixmap constructors (e.g. those for file and image input) create pixmaps " "with no alpha altogether. On the downside, save methods for pixmaps no " "longer accept a *savealpha* option: this channel will always be saved " "when present. To minimize code breaks, we have left this parameter in the" " call patterns -- it will just be ignored." msgstr "" #: ../../../changes.txt:2733 58b3832200ca448a9f2942f1ec5f30d9 msgid "" "*DisplayList* and *TextPage* class constructors now **require the " "mediabox** of the page they are referring to (i.e. the *page.bound()* " "rectangle). There is no way to construct this information from other " "sources, therefore a source code change cannot be avoided in these cases." " We assume however, that not many users are actually employing these " "rather low level classes explicitly. So the impact of that change should " "be minor." msgstr "" #: ../../../changes.txt:2735 01de368016c141b1b2553cd585883f58 msgid "**Other Changes compared to Version 1.9.3**" msgstr "" #: ../../../changes.txt:2737 df26434942574d7da8fc1befaf6d049e msgid "" "The new :ref:`Document` method *write()* writes an opened PDF to memory " "(as opposed to a file, like *save()* does)." msgstr "" #: ../../../changes.txt:2738 5190f090e6f84628be18a2e1c9fd43df msgid "" "An annotation can now be scaled and moved around on its page. This is " "done by modifying its rectangle." msgstr "" #: ../../../changes.txt:2739 0eb2ec9314ee488196226314519b9129 msgid "" "Annotations can now be deleted. :ref:`Page` contains the new method " "*deleteAnnot()*." msgstr "" #: ../../../changes.txt:2740 99724b99bd0548eaa19c8c85f41c3b21 msgid "" "Various annotation attributes can now be modified, e.g. content, dates, " "title (= author), border, colors." msgstr "" #: ../../../changes.txt:2741 d958d6b52dd140669174995b9aa48a2c msgid "" "Method *Document.insert_pdf()* now also copies annotations of source " "pages." msgstr "" #: ../../../changes.txt:2742 a77b60cbc9834c8885e873395b2e5293 msgid "" "The *Pages* class has been deleted. As documents can now be accessed with" " page numbers as indices (like *doc[n] = doc.loadPage(n)*), and document " "object can be used as iterators, the benefit of this class was too low to" " maintain it. See the following comments." msgstr "" #: ../../../changes.txt:2743 8310daf4e1854f8d93f3fccbab7b350f msgid "" "*loadPage(n)* / *doc[n]* now accept arbitrary integers to specify a page " "number, as long as *n < pageCount*. So, e.g. *doc[-500]* is always valid " "and will load page *(-500) % pageCount*." msgstr "" #: ../../../changes.txt:2744 1204cbb1b1c544fb9e21c114bb1d1ba0 msgid "" "A document can now also be used as an iterator like this: *for page in " "doc: ... ...*. This will yield all pages of " "*doc* as *page*." msgstr "" #: ../../../changes.txt:2745 638b89cc45b748c1871ca2d5aead5130 msgid "" "The :ref:`Pixmap` method *getSize()* has been replaced with property " "*size*. As before *Pixmap.size == len(Pixmap)* is true." msgstr "" #: ../../../changes.txt:2746 08362ae590bb4f6d909e17c344eac186 msgid "" "In response to transparency (alpha) being optional, several new " "parameters and properties have been added to :ref:`Pixmap` and " ":ref:`Colorspace` classes to support determining their characteristics." msgstr "" #: ../../../changes.txt:2747 26af3ec444444862b651b0a46668621b msgid "" "The :ref:`Page` class now contains new properties *firstAnnot* and " "*firstLink* to provide starting points to the respective class chains, " "where *firstLink* is just a mnemonic synonym to method *loadLinks()* " "which continues to exist. Similarly, the new property *rect* is a synonym" " for method *bound()*, which also continues to exist." msgstr "" #: ../../../changes.txt:2748 ded24a5038154723bb3341c82e3cbf85 msgid "" ":ref:`Pixmap` methods *samplesRGB()* and *samplesAlpha()* have been " "deleted because pixmaps can now be created without transparency." msgstr "" #: ../../../changes.txt:2749 0f12d21dba014e89b8c28b88440ddf0d msgid "" ":ref:`Rect` now has a property *irect* which is a synonym of method " "*round()*. Likewise, :ref:`IRect` now has property *rect* to deliver a " ":ref:`Rect` which has the same coordinates as floats values." msgstr "" #: ../../../changes.txt:2750 30d1287837f24dc3b01d070c0235a6b3 msgid "" "Document has the new method *searchPageFor()* to search for a text " "string. It works exactly like the corresponding *Page.searchFor()* with " "page number as additional parameter." msgstr "" #: ../../../changes.txt:2755 efde2cd3f108453c92668ab6680d8c22 msgid "**Changes in Version 1.9.3**" msgstr "" #: ../../../changes.txt:2757 0ea28511a44f47cbabd5e1818b9aa8aa msgid "" "This version is also based on MuPDF v1.9a. Changes compared to version " "1.9.2:" msgstr "" #: ../../../changes.txt:2759 4e290039221648db96c98c392772b446 msgid "" "As a major enhancement, annotations are now supported in a similar way as" " links. Annotations can be displayed (as pixmaps) and their properties " "can be accessed." msgstr "" #: ../../../changes.txt:2760 9b2336cd5062432881d29cf06440709d msgid "" "In addition to the document *select()* method, some simpler methods can " "now be used to manipulate a PDF:" msgstr "" #: ../../../changes.txt:2762 8d2322bb4a7d4981a30ae2ec5a2cbdb0 msgid "*copyPage()* copies a page within a document." msgstr "" #: ../../../changes.txt:2763 b7683db8abd54cb09161d5edf19f4bd3 msgid "*movePage()* is similar, but deletes the original." msgstr "" #: ../../../changes.txt:2764 a4c469e758a1452bb9ab330b06d00638 msgid "*delete_page()* deletes a page" msgstr "" #: ../../../changes.txt:2765 edfd6b26956f4fbfbe96ae5f0b82abd1 msgid "*delete_pages()* deletes a page range" msgstr "" #: ../../../changes.txt:2767 39a894ab055d4710b6bd443c6df69890 msgid "" "*rotation* or *setRotation()* access or change a PDF page's rotation, " "respectively." msgstr "" #: ../../../changes.txt:2768 4c32f65b4b694d6bb428aa23ca44e50a msgid "" "Available but undocumented before, :ref:`IRect`, :ref:`Rect`, " ":ref:`Point` and :ref:`Matrix` support the *len()* method and their " "coordinate properties can be accessed via indices, e.g. *IRect.x1 == " "IRect[2]*." msgstr "" #: ../../../changes.txt:2769 f60011476e35442c8866a3831c378b54 msgid "" "For convenience, documents now support simple indexing: *doc.loadPage(n) " "== doc[n]*. The index may however be in range *-pageCount < n < " "pageCount*, such that *doc[-1]* is the last page of the document." msgstr "" #: ../../../changes.txt:2773 b923307f30254e48ba8f3dfb4835b05a msgid "**Changes in Version 1.9.2**" msgstr "" #: ../../../changes.txt:2775 6449dd561a1d46078eff4b1c6983b1ae msgid "" "This version is also based on MuPDF v1.9a. Changes compared to version " "1.9.1:" msgstr "" #: ../../../changes.txt:2777 f9a699d3f70e4d6caed1fb3017bf1f0b msgid "" "*fitz.open()* (no parameters) creates a new empty **PDF** document, i.e. " "if saved afterwards, it must be given a *.pdf* extension." msgstr "" #: ../../../changes.txt:2778 6d6ed72ba57c49cab25dd46b125a7992 msgid "" ":ref:`Document` now accepts all of the following formats (*Document* and " "*open* are synonyms):" msgstr "" #: ../../../changes.txt:2780 a3a89203f10e4adeb3cfe637ceb6fdff msgid "*open()*," msgstr "" #: ../../../changes.txt:2781 adac8cae62784b188b7532c740bb1379 msgid "*open(filename)* (equivalent to *open(filename, None)*)," msgstr "" #: ../../../changes.txt:2782 5d35476e5dcf46248458a566565f6b6f msgid "*open(filetype, area)* (equivalent to *open(filetype, stream = area)*)." msgstr "" #: ../../../changes.txt:2784 2fdc6dd492a14cc68fa4d2de4e051cfc msgid "" "Type of memory area *stream* may be *bytes* or *bytearray*. Thus, e.g. " "*area = open(\"file.pdf\", \"rb\").read()* may be used directly (without " "first converting it to bytearray)." msgstr "" #: ../../../changes.txt:2785 ad12c912ac3247a4a7c774429b01c39b msgid "" "New method *Document.insert_pdf()* (PDFs only) inserts a range of pages " "from another PDF." msgstr "" #: ../../../changes.txt:2786 93f16447ec77443ba90329b70366c78f msgid "" "*Document* objects doc now support the *len()* function: ``len(doc) == " "doc.pageCount``." msgstr "" #: ../../../changes.txt:2787 b9dfdd6106944a0ab643f64882fa6526 msgid "" "New method *Document.getPageImageList()* creates a list of images used on" " a page." msgstr "" #: ../../../changes.txt:2788 f2906fa3f14c4f93bddbe0029d43681f msgid "" "New method *Document.getPageFontList()* creates a list of fonts " "referenced by a page." msgstr "" #: ../../../changes.txt:2789 a053e3c6bd69480aa1a4639e8522af69 msgid "" "New pixmap constructor *fitz.Pixmap(doc, xref)* creates a pixmap based on" " an opened PDF document and an :data:`xref` number of the image." msgstr "" #: ../../../changes.txt:2790 9dfdd7f9d9b14e15963c179646bcbbeb msgid "" "New pixmap constructor *fitz.Pixmap(cspace, spix)* creates a pixmap as a " "copy of another one *spix* with the colorspace converted to *cspace*. " "This works for all colorspace combinations." msgstr "" #: ../../../changes.txt:2791 2a61334e5c304e09a3efe93e1daf2a53 msgid "" "Pixmap constructor *fitz.Pixmap(colorspace, width, height, samples)* now " "allows *samples* to also be *bytes*, not only *bytearray*." msgstr "" #: ../../../changes.txt:2796 b95080e967b24b66ae4b63c42d239889 msgid "**Changes in Version 1.9.1**" msgstr "" #: ../../../changes.txt:2798 9273e10701d143069e9c0424e4b6bded msgid "" "This version of PyMuPDF is based on MuPDF library source code version " "1.9a published on April 21, 2016." msgstr "" #: ../../../changes.txt:2800 517fc4042ed6446e9e7457b0f69e8504 msgid "" "Please have a look at MuPDF's website to see which changes and " "enhancements are contained herein." msgstr "" #: ../../../changes.txt:2802 c70db83bdb1d48d198e4344cae4de7b5 msgid "Changes in version 1.9.1 compared to version 1.8.0 are the following:" msgstr "" #: ../../../changes.txt:2804 0d6385d834804b7d9b0ab1c6ef0d85b8 msgid "New methods *get_area()* for both *fitz.Rect* and *fitz.IRect*" msgstr "" #: ../../../changes.txt:2805 85fda6915f8c488cb6fbe936f1ea49ab msgid "" "Pixmaps can now be created directly from files using the new constructor " "*fitz.Pixmap(filename)*." msgstr "" #: ../../../changes.txt:2806 d92fe0f7f8304a5190d37c53f89f3a24 msgid "The Pixmap constructor *fitz.Pixmap(image)* has been extended accordingly." msgstr "" #: ../../../changes.txt:2807 cdaceee4b768492e9110c3d0cd75e175 msgid "" "*fitz.Rect* can now be created with all possible combinations of points " "and coordinates." msgstr "" #: ../../../changes.txt:2808 03f45a90666540d8b5cb4c257457b006 msgid "" "PyMuPDF classes and methods now all contain __doc__ strings, most of " "them created by SWIG automatically. While the PyMuPDF documentation " "certainly is more detailed, this feature should help a lot when " "programming in Python-aware IDEs." msgstr "" #: ../../../changes.txt:2809 2ddafe376f5e4f4e9ac5c3db523eea26 msgid "" "A new document method of *getPermits()* returns the permissions " "associated with the current access to the document (print, edit, " "annotate, copy), as a Python dictionary." msgstr "" #: ../../../changes.txt:2810 38dbe8d276f348d6b76c6d0a15d0676f msgid "The identity matrix *fitz.Identity* is now **immutable**." msgstr "" #: ../../../changes.txt:2811 fa0425c7b7b04f0bb7c04eec634e2756 msgid "" "The new document method *select(list)* removes all pages from a document " "that are not contained in the list. Pages can also be duplicated and re-" "arranged." msgstr "" #: ../../../changes.txt:2812 3c561ea70df341be88b491b64dc6f313 msgid "" "Various improvements and new members in our demo and examples " "collections. Perhaps most prominently: *PDF_display* now supports " "scrolling with the mouse wheel, and there is a new example program " "*wxTableExtract* which allows to graphically identify and extract table " "data in documents." msgstr "" #: ../../../changes.txt:2813 4d9bea8a8e514d67958c633b66ca31fb msgid "*fitz.open()* is now an alias of *fitz.Document()*." msgstr "" #: ../../../changes.txt:2814 f62c2e04dea346d0a23964798a6150e8 msgid "" "New pixmap method *tobytes()* which will return a bytearray formatted as " "a PNG image of the pixmap." msgstr "" #: ../../../changes.txt:2815 691532d03793437899a4b59421388b4c msgid "" "New pixmap method *samplesRGB()* providing a *samples* version with alpha" " bytes stripped off (RGB colorspaces only)." msgstr "" #: ../../../changes.txt:2816 2780806eef3f43b28a7e9601a270e9f2 msgid "" "New pixmap method *samplesAlpha()* providing the alpha bytes only of the " "*samples* area." msgstr "" #: ../../../changes.txt:2817 21fbef3bc0e64a59a9a9b9f5005063e8 msgid "New iterator *fitz.Pages(doc)* over a document's set of pages." msgstr "" #: ../../../changes.txt:2818 707a5edabf3e4c3cbb66ed5d280d40ae msgid "" "New matrix methods *invert()* (calculate inverted matrix), *concat()* " "(calculate matrix product), *pretranslate()* (perform a shift operation)." msgstr "" #: ../../../changes.txt:2819 cc8cea5eaf77474aa84e90031d6f3318 msgid "" "New *IRect* methods *intersect()* (intersection with another rectangle), " "*translate()* (perform a shift operation)." msgstr "" #: ../../../changes.txt:2820 893b259908084462b3a1a85629a6ee06 msgid "" "New *Rect* methods *intersect()* (intersection with another rectangle), " "*transform()* (transformation with a matrix), *include_point()* (enlarge " "rectangle to also contain a point), *include_rect()* (enlarge rectangle " "to also contain another one)." msgstr "" #: ../../../changes.txt:2821 21838e58f15b4457816e55450382ccb9 msgid "Documented *Point.transform()* (transform a point with a matrix)." msgstr "" #: ../../../changes.txt:2822 3f2842cba4c044eb99d8d250d9f84740 msgid "" "*Matrix*, *IRect*, *Rect* and *Point* classes now support compact, " "algebraic formulations for manipulating such objects." msgstr "" #: ../../../changes.txt:2823 bb13c21e58c14cf59f36e99322166ac4 msgid "" "Incremental saves for changes are possible now using the call pattern " "*doc.save(doc.name, incremental=True)*." msgstr "" #: ../../../changes.txt:2824 34093067a0274622aa66ca0e40f20da0 msgid "" "A PDF's metadata can now be deleted, set or changed by document method " "*set_metadata()*. Supports incremental saves." msgstr "" #: ../../../changes.txt:2825 0e2f9f83f2244178a0772a7f0de76b0d msgid "" "A PDF's bookmarks (or table of contents) can now be deleted, set or " "changed with the entries of a list using document method *set_toc(list)*." " Supports incremental saves." msgstr "" #: ../../footer.rst:48 0555f8605d724eadbe65f9eb27755b4f msgid "This documentation covers all versions up to |version|." msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/classes.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 72d124a4df2940ae91c02b99f3c82423 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 0da5ffd890c841748068ca615eab3107 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 9d0127c5f1f14daa981562792c65c9b5 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../classes.rst:5 fe9040dd12d946768ce0d27a27fdaf3d msgid "Classes" msgstr "클래스" #: ../../footer.rst:46 8ffd075421f949e383a9682ed7ae841d msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/colors.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f7f80c710949468b8bd435236ad8e2c4 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 128dbd8ce067437e9fa9367d9a81490c msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 fc29ad4440c04367a8583f77893f5da0 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../colors.rst:7 904c9bd5c37245ada62e1853d3d3ab41 msgid "Color Database" msgstr "색상 데이터베이스" #: ../../colors.rst:8 3a6a8c4737a04dff80244d2af0ec3eb5 msgid "" "Since the introduction of methods involving colors (like " ":meth:`Page.draw_circle`), a requirement may be to have access to " "predefined colors." msgstr ":meth:`Page.draw_circle` 과 같은 색상을 포함하는 메서드가 도입된 이후, 미리 정의된 색상에 액세스할 필요가 있을 수 있습니다." #: ../../colors.rst:10 413288a3680f4de18bf71a5e9d578ce4 msgid "" "The fabulous GUI package `wxPython `_ has a " "database of over 540 predefined RGB colors, which are given more or less " "memorizable names. Among them are not only standard names like \"green\" " "or \"blue\", but also \"turquoise\", \"skyblue\", and 100 (not only 50 " "...) shades of \"gray\", etc." msgstr "훌륭한 GUI 패키지 `wxPython `_ 는 540개 이상의 미리 정의된 RGB 색상 데이터베이스를 가지고 있으며, 각각 기억하기 쉬운 이름이 부여되어 있습니다. 그 중에는 \"green\"이나 \"blue\"와 같은 표준 이름뿐만 아니라 \"turquoise\", \"skyblue\", 그리고 \"gray\"의 100가지(50가지뿐만 아니라...) 음영 등이 포함되어 있습니다." #: ../../colors.rst:12 14609f03f5aa4aaa8e49243c7e03e485 msgid "" "We have taken the liberty to copy this database (a list of tuples) " "modified into PyMuPDF and make its colors available as PDF compatible " "float triples: for wxPython's *(\"WHITE\", 255, 255, 255)* we return *(1," " 1, 1)*, which can be directly used in *color* and *fill* parameters. We " "also accept any mixed case of \"wHiTe\" to find a color." msgstr "이 데이터베이스(튜플 목록)를 PyMuPDF로 복사하여 수정하고 색상을 PDF 호환 float 삼중값으로 사용할 수 있게 했습니다: wxPython의 *(\"WHITE\", 255, 255, 255)* 에 대해 *(1, 1, 1)* 을 반환하며, 이것은 *color* 및 *fill* 매개변수에서 직접 사용할 수 있습니다. 또한 색상을 찾기 위해 \"wHiTe\"와 같은 대소문자 혼합도 허용합니다." #: ../../colors.rst:15 9ad1f31ffff5428d982d997142d514ed msgid "Function *getColor()*" msgstr "함수 *getColor()*" #: ../../colors.rst:16 a622de02c9de4a36be638603c453810c msgid "" "As the color database may not be needed very often, one additional import" " statement seems acceptable to get access to it::" msgstr "색상 데이터베이스가 자주 필요하지 않을 수 있으므로, 액세스하기 위해 하나의 추가 import 문이 허용되는 것으로 보입니다::" #: ../../colors.rst:41 77d5cf06ffb64791bf093176968e3823 msgid "Printing the Color Database" msgstr "색상 데이터베이스 인쇄" #: ../../colors.rst:42 671f64b3cd454ac79241e57967a08885 msgid "" "If you want to actually see how the many available colors look like, use " "scripts `print by RGB `_ or `print by HSV " "`_ in the examples directory. They create PDFs (already " "existing in the same directory) with all these colors. Their only " "difference is sorting order: one takes the RGB values, the other one the " "Hue-Saturation-Values as sort criteria. This is a screen print of what " "these files look like." msgstr "실제로 사용 가능한 많은 색상이 어떻게 보이는지 확인하려면 examples 디렉토리의 `RGB로 인쇄 `_ 또는 `HSV로 인쇄 `_ 스크립트를 사용하세요. 이들은 이러한 모든 색상이 포함된 PDF를 생성합니다(이미 같은 디렉토리에 존재). 유일한 차이점은 정렬 순서입니다: 하나는 RGB 값을 사용하고 다른 하나는 색상-채도-값을 정렬 기준으로 사용합니다. 이것은 이러한 파일이 어떻게 보이는지에 대한 화면 인쇄입니다." #: ../../footer.rst:46 8a7d56a546234904856ce9f0b72c1614 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/colorspace.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f549435fd225442b88591b9ea748ccf5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 26942a499b7a445b90c295eca24482e7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 af615b1043644e81bbff2aaf9a089159 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../colorspace.rst:7 34c209fdd6e340a2957eb63d18046708 msgid "Colorspace" msgstr "Colorspace (색 공간)" #: ../../colorspace.rst:9 f977d2d374354205a274599236a85e9e msgid "Represents the color space of a :ref:`Pixmap`." msgstr ":ref:`Pixmap` 의 색 공간을 나타냅니다." #: ../../colorspace.rst:12 1b2a1f6f61a04f109833fcd6f2cd89f6 msgid "**Class API**" msgstr "**클래스 API**" #: ../../colorspace.rst:18 e6633c622a404083816fea39291502e0 msgid "Constructor" msgstr "생성자" #: ../../colorspace.rst bb53728a68224c1598e93adba7f88d7b msgid "Parameters" msgstr "매개변수" #: ../../colorspace.rst:20 2f9149a75fe74a3ea8f99ed87ca10a79 msgid "" "A number identifying the colorspace. Possible values are :data:`CS_RGB`, " ":data:`CS_GRAY` and :data:`CS_CMYK`." msgstr "색 공간을 식별하는 숫자. 가능한 값은 :data:`CS_RGB`, :data:`CS_GRAY`, :data:`CS_CMYK` 입니다." #: ../../colorspace.rst:24 68374fc9f8604e2c9f51ccab76cd667f msgid "" "The name identifying the colorspace. Example: *pymupdf.csCMYK.name = " "'DeviceCMYK'*." msgstr "색 공간을 식별하는 이름. 예: *pymupdf.csCMYK.name = 'DeviceCMYK'*." #: ../../colorspace.rst 2b529cfead5f452aa08c4f0889094f2a #: de6bc202909d47c1ac4f59fb0cfd08f4 msgid "type" msgstr "유형" #: ../../colorspace.rst:26 fae8ee7d418c442591c2744e79c8744d msgid "str" msgstr "str" #: ../../colorspace.rst:30 c1510ca299d344e599e43a51f294701f msgid "" "The number of bytes required to define the color of one pixel. Example: " "*pymupdf.csCMYK.n == 4*." msgstr "한 픽셀의 색상을 정의하는 데 필요한 바이트 수. 예: *pymupdf.csCMYK.n == 4*." #: ../../colorspace.rst:32 f102b99da0f947f2ad6e51b936a3be73 msgid "int" msgstr "int" #: ../../colorspace.rst:35 38447c5856904db38a697c5fbbac7a22 msgid "**Predefined Colorspaces**" msgstr "**사전 정의된 색 공간**" #: ../../colorspace.rst:37 050d42a00f5a4101af529f195bc8bb1c msgid "" "For saving some typing effort, there exist predefined colorspace objects " "for the three available cases." msgstr "입력을 간소화하기 위해 세 가지 사용 가능한 경우에 대한 사전 정의된 색 공간 객체가 존재합니다." #: ../../colorspace.rst:39 e4c24c0bade34c0893756619c1ebc542 msgid ":data:`csRGB` = *pymupdf.Colorspace(pymupdf.CS_RGB)*" msgstr ":data:`csRGB` = *pymupdf.Colorspace(pymupdf.CS_RGB)*" #: ../../colorspace.rst:40 2094a63eb7ee45d9ae81e24499dde735 msgid ":data:`csGRAY` = *pymupdf.Colorspace(pymupdf.CS_GRAY)*" msgstr ":data:`csGRAY` = *pymupdf.Colorspace(pymupdf.CS_GRAY)*" #: ../../colorspace.rst:41 055f0bfcd886462d9efd42028ac34cf4 msgid ":data:`csCMYK` = *pymupdf.Colorspace(pymupdf.CS_CMYK)*" msgstr ":data:`csCMYK` = *pymupdf.Colorspace(pymupdf.CS_CMYK)*" #: ../../footer.rst:46 db2d1460e2e34af68d7315f27089b57f msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/converting-files.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f8990f687e0047c89745e6b15ef5f312 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 606c02d809cb449ab8e5df484cb2149f msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 90891c93f09445feb007b8f80d447d93 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../converting-files.rst:7 153e0c6c14bf4b8bac1dcdc565ac0f16 msgid "Converting Files" msgstr "파일 변환" #: ../../converting-files.rst:12 9b1bc6f3061c4fd9a084829ef7554c37 msgid "Files to PDF" msgstr "파일을 PDF로" #: ../../converting-files.rst:14 38d5a093dfc24e72b3627f1a2c952515 msgid "" ":ref:`Document types supported by PyMuPDF` can easily be " "converted to |PDF| by using the :meth:`Document.convert_to_pdf` method. " "This method returns a buffer of data which can then be utilized by " "|PyMuPDF| to create a new |PDF|." msgstr ":ref:`PyMuPDF 가 지원하는 문서 유형` 은 :meth:`Document.convert_to_pdf` 메서드를 사용하여 쉽게 |PDF| 로 변환할 수 있습니다. 이 메서드는 데이터 버퍼를 반환하며, 이를 |PyMuPDF| 에서 사용하여 새로운 |PDF| 를 생성할 수 있습니다." #: ../../converting-files.rst:18 ../../converting-files.rst:38 #: ../../converting-files.rst:62 ../../converting-files.rst:82 #: 2eff8f1c0f704e9d9e23a98078353847 7345723f19864e81be97447aab194cd9 #: c3ae18efff164928b70b884d3a47caac ecdbf8cbbb2d46bc9bf312b716b264af msgid "**Example**" msgstr "**예제**" #: ../../converting-files.rst:32 4e3eda1d4bff4593ae1f0333bcc47a5d msgid "PDF to SVG" msgstr "PDF를 SVG로" #: ../../converting-files.rst:34 d8f0e0e26f99486485d27038482b5558 msgid "" "Technically, as SVG files cannot be multipage, we must export each page " "as an SVG." msgstr "기술적으로 SVG 파일은 다중 페이지를 지원하지 않으므로 각 페이지를 SVG로 내보내야 합니다." #: ../../converting-files.rst:36 45efc8839a1b44e9a877335aa51df1b6 msgid "" "To get an SVG representation of a page use the :meth:`Page.get_svg_image`" " method." msgstr "페이지의 SVG 표현을 얻으려면 :meth:`Page.get_svg_image` 메서드를 사용하세요." #: ../../converting-files.rst:58 9249883d41654d3c8041c561743679c6 msgid "PDF to Markdown" msgstr "PDF를 Markdown으로" #: ../../converting-files.rst:60 9d35a0dc74c742419817cfab8ac5fbb6 msgid "" "By utlilizing the :doc:`PyMuPDF4LLM API ` we are able to" " convert PDF to a Markdown representation." msgstr ":doc:`PyMuPDF4LLM API ` 를 활용하여 PDF를 Markdown 표현으로 변환할 수 있습니다." #: ../../converting-files.rst:76 a8c608159d57471c89e55f3c44adafe2 msgid "PDF to DOCX" msgstr "PDF를 DOCX로" #: ../../converting-files.rst:78 443eb3ec0d3a4ba89f8e4361a7607e16 msgid "" "Use the pdf2docx_ library which uses |PyMuPDF| to provide document " "conversion from |PDF| to **DOCX** format." msgstr "|PyMuPDF| 를 사용하여 |PDF| 에서 **DOCX** 형식으로 문서 변환을 제공하는 pdf2docx_ 라이브러리를 사용하세요." #: ../../footer.rst:46 bf92de7cbdc140fba9255f9a43b9932a msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/coop_low.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 8d754aed1e2740038b917c525f18b9ca msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 48fc1e2d0d4044849ac51203907c3038 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 9455ddb086974d8fbdb10bf9926ee2c2 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../coop_low.rst:7 1424337399114434a5fcad7ec04fb525 msgid "Working together: DisplayList and TextPage" msgstr "함께 작업하기: DisplayList 및 TextPage" #: ../../coop_low.rst:8 a3db195fac9545f6bcdb871b180a3157 msgid "Here are some instructions on how to use these classes together." msgstr "이러한 클래스를 함께 사용하는 방법에 대한 지침입니다." #: ../../coop_low.rst:10 0151aabe7884411ab744c548ff37a84f msgid "" "In some situations, performance improvements may be achievable, when you " "fall back to the detail level explained here." msgstr "일부 상황에서는 여기서 설명하는 세부 수준으로 돌아가면 성능 개선을 달성할 수 있습니다." #: ../../coop_low.rst:13 54d7972a1340441eaea756f718523d0b msgid "Create a DisplayList" msgstr "DisplayList 생성" #: ../../coop_low.rst:14 c98d7572988c49e6a0b6a9e9719d1774 msgid "" "A :ref:`DisplayList` represents an interpreted document page. Methods for" " pixmap creation, text extraction and text search are -- behind the " "curtain -- all using the page's display list to perform their tasks. If a" " page must be rendered several times (e.g. because of changed zoom " "levels), or if text search and text extraction should both be performed, " "overhead can be saved, if the display list is created only once and then " "used for all other tasks." msgstr ":ref:`DisplayList` 는 해석된 문서 페이지를 나타냅니다. 픽스맵 생성, 텍스트 추출 및 텍스트 검색 메서드는 모두 -- 배후에서 -- 페이지의 디스플레이 리스트를 사용하여 작업을 수행합니다. 페이지를 여러 번 렌더링해야 하거나(예: 확대/축소 수준 변경), 텍스트 검색과 텍스트 추출을 모두 수행해야 하는 경우, 디스플레이 리스트를 한 번만 생성한 다음 다른 모든 작업에 사용하면 오버헤드를 절약할 수 있습니다." #: ../../coop_low.rst:18 4e74ccb447ad4e808e44350168bf55d2 msgid "" "You can also create display lists for many pages \"on stack\" (in a " "list), may be during document open, during idling times, or you store it " "when a page is visited for the first time (e.g. in GUI scripts)." msgstr "여러 페이지에 대한 디스플레이 리스트를 \"스택에\"(리스트에) 생성할 수도 있습니다. 문서를 열 때, 유휴 시간 동안, 또는 페이지를 처음 방문할 때(예: GUI 스크립트) 저장할 수 있습니다." #: ../../coop_low.rst:20 12bb2e8c763e4ad3a237fd80266a2543 msgid "" "Note, that for everything what follows, only the display list is needed " "-- the corresponding :ref:`Page` object could have been deleted." msgstr "다음의 모든 작업에는 디스플레이 리스트만 필요합니다. 해당 :ref:`Page` 객체는 삭제되었을 수 있습니다." #: ../../coop_low.rst:23 686688813b8745b284b6d509397757da msgid "Generate Pixmap" msgstr "픽스맵 생성" #: ../../coop_low.rst:24 d5a176c44d9a4202a1247dbea491d65e msgid "" "The following creates a Pixmap from a :ref:`DisplayList`. Parameters are " "the same as for :meth:`Page.get_pixmap`." msgstr "다음은 :ref:`DisplayList` 에서 픽스맵을 생성합니다. 매개변수는 :meth:`Page.get_pixmap` 과 동일합니다." #: ../../coop_low.rst:28 141a5838b45c4b229d3aa4b5d32e29e6 #, python-format msgid "" "The execution time of this statement may be up to 50% shorter than that " "of :meth:`Page.get_pixmap`." msgstr "이 문의 실행 시간은 :meth:`Page.get_pixmap` 보다 최대 50% 짧을 수 있습니다." #: ../../coop_low.rst:31 23be506420454ef7b8ccdcabdadf9684 msgid "Perform Text Search" msgstr "텍스트 검색 수행" #: ../../coop_low.rst:32 304eb217224047588efee4d3a4959ad2 msgid "With the display list from above, we can also search for text." msgstr "위의 디스플레이 리스트를 사용하여 텍스트를 검색할 수도 있습니다." #: ../../coop_low.rst:34 6f3c8ea4c8134e719b9c2c789a52eaf5 msgid "For this we need to create a :ref:`TextPage`." msgstr "이를 위해 :ref:`TextPage` 를 생성해야 합니다." #: ../../coop_low.rst:42 702318fa16304e26a6dbff34f1f56e8c msgid "Extract Text" msgstr "텍스트 추출" #: ../../coop_low.rst:43 50018abeea15456b936054a8e8301808 msgid "" "With the same :ref:`TextPage` object from above, we can now immediately " "use any or all of the 5 text extraction methods." msgstr "위의 동일한 :ref:`TextPage` 객체를 사용하여 이제 5가지 텍스트 추출 메서드 중 하나 또는 모두를 즉시 사용할 수 있습니다." #: ../../coop_low.rst:45 01c692d0961a48d78607d7cdef1b8734 msgid "" "Above, we have created our text page without argument. This leads to a " "default argument of 3 (:data:`ligatures` and white-space are preserved), " "IAW images will **not** be extracted -- see below." msgstr "위에서 인수 없이 텍스트 페이지를 생성했습니다. 이것은 기본 인수 3(:data:`ligatures` 및 공백이 보존됨)으로 이어지며, 즉 이미지는 **추출되지 않습니다** -- 아래를 참조하세요." #: ../../coop_low.rst:54 15150223bde3445b8a3ddc5a334745ce msgid "Further Performance improvements" msgstr "추가 성능 개선" #: ../../coop_low.rst:56 815c6e2e62894b99850c2da374681e5c msgid "Pixmap" msgstr "픽스맵" #: ../../coop_low.rst:57 5fa23435785d41b3aa98150e549e6a24 msgid "As explained in the :ref:`Page` chapter:" msgstr ":ref:`Page` 장에서 설명한 대로:" #: ../../coop_low.rst:59 d7489842cfb34a66b6decf4e2c4626a6 #, python-format msgid "" "If you do not need transparency set *alpha = 0* when creating pixmaps. " "This will save 25% memory (if RGB, the most common case) and possibly 5% " "execution time (depending on the GUI software)." msgstr "투명도가 필요하지 않으면 픽스맵을 생성할 때 *alpha = 0* 을 설정하세요. 이것은 25%의 메모리를 절약하고(RGB인 경우, 가장 일반적인 경우) GUI 소프트웨어에 따라 실행 시간을 약 5% 절약할 수 있습니다." #: ../../coop_low.rst:62 85b6f710f9d440e6a4e7167325c704a1 msgid "TextPage" msgstr "TextPage" #: ../../coop_low.rst:63 eacc58b3ec3b4895b3defc1f4a0cff2b msgid "" "If you do not need images extracted alongside the text of a page, you can" " set the following option:" msgstr "페이지의 텍스트와 함께 이미지를 추출할 필요가 없으면 다음 옵션을 설정할 수 있습니다:" #: ../../coop_low.rst:68 494f5310e02d4bc18d9d3742d80c9a1d #, python-format msgid "" "This will save ca. 25% overall execution time for the HTML, XHTML and " "JSON text extractions and **hugely** reduce the amount of storage (both, " "memory and disk space) if the document is graphics oriented." msgstr "이것은 HTML, XHTML 및 JSON 텍스트 추출의 전체 실행 시간을 약 25% 절약하고, 문서가 그래픽 지향적인 경우 스토리지(메모리 및 디스크 공간 모두)의 양을 **대폭** 줄입니다." #: ../../coop_low.rst:70 c7b5ac2b784947f6a4bd325d1474f9b8 msgid "If you however do need images, use a value of 7 for flags:" msgstr "하지만 이미지가 필요한 경우 플래그에 7 값을 사용하세요:" #: ../../footer.rst:46 74ed18ccd6ca45b28e31f30369c051a8 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/device.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 db41752d7d77475b91dce6987192b03e msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 9d1395b42c0242c2937c063ec31289da msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c674fa9ee73a4fcf888b701a69a14f4a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../device.rst:7 d8f699f2197d4cccb1a32e36349536c8 msgid "Device" msgstr "Device (디바이스)" #: ../../device.rst:9 c03889a987f445ea84d79f3d5abfb84d msgid "" "The different format handlers (pdf, xps, etc.) interpret pages to a " "\"device\". Devices are the basis for everything that can be done with a " "page: rendering, text extraction and searching. The device type is " "determined by the selected construction method." msgstr "다양한 형식 핸들러(pdf, xps 등)는 페이지를 \"디바이스\"로 해석합니다. 디바이스는 페이지로 수행할 수 있는 모든 작업(렌더링, 텍스트 추출, 검색)의 기반입니다. 디바이스 유형은 선택한 생성 방법에 의해 결정됩니다." #: ../../device.rst:11 5997f573701045499919ec1f18ab7518 msgid "**Class API**" msgstr "**클래스 API**" #: ../../device.rst:17 4b9fd079e127474e94506fe9eadb79d7 msgid "Constructor for either a pixel map or a display list device." msgstr "픽셀 맵 또는 디스플레이 리스트 디바이스의 생성자." #: ../../device.rst 3029384c54544ad783072064ea96675d #: ca7a504aacc440719aba0931b7724c60 msgid "Parameters" msgstr "매개변수" #: ../../device.rst:19 9b095106055b4d568344ac7d142034f3 msgid "either a ``Pixmap`` or a ``DisplayList``." msgstr "``Pixmap`` 또는 ``DisplayList`` 중 하나." #: ../../device.rst:22 30003de713004e58977091af11644238 msgid "" "An optional `IRect` for ``Pixmap`` devices to restrict rendering to a " "certain area of the page. If the complete page is required, specify " "``None``. For display list devices, this parameter must be omitted." msgstr "``Pixmap`` 디바이스의 선택적 `IRect` 로, 페이지의 특정 영역으로 렌더링을 제한합니다. 전체 페이지가 필요한 경우 ``None`` 을 지정하세요. 디스플레이 리스트 디바이스의 경우 이 매개변수는 생략해야 합니다." #: ../../device.rst:27 5a3223623124424ba115721d21086469 msgid "Constructor for a text page device." msgstr "텍스트 페이지 디바이스의 생성자." #: ../../device.rst:29 8f77a7687a804d458ddb9a4be4624d77 msgid "``TextPage`` object" msgstr "``TextPage`` 객체" #: ../../device.rst:32 53c8b35c8b0e4e488b05cfbe1c988a0d msgid "" "control the way how text is parsed into the text page. Currently 3 " "options can be coded into this parameter, see :ref:`TextPreserve`. To set" " these options use something like `flags=0 | TEXT_PRESERVE_LIGATURES | " "...`." msgstr "텍스트가 텍스트 페이지로 파싱되는 방식을 제어하는 플래그입니다. 현재 3가지 옵션을 이 매개변수에 코딩할 수 있으며, :ref:`TextPreserve` 를 참조하세요. 이러한 옵션을 설정하려면 `flags=0 | TEXT_PRESERVE_LIGATURES | ...` 와 같은 형식을 사용하세요." #: ../../footer.rst:46 233763b8ff7c42718f2a5b6285c3802f msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/displaylist.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ff003cfb5c0b4ca9ba474a0f6e3841c2 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 c536d6f0052e4f9cbf11534486001461 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 2b6c43a92fad451db1603199ddd7c294 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../displaylist.rst:7 698bbcf656244694aa96f09767a54aa5 msgid "DisplayList" msgstr "DisplayList (디스플레이 리스트)" #: ../../displaylist.rst:9 2b6a249a9e6a46a482202e8b105e8ddc msgid "" "DisplayList is a list containing drawing commands (text, images, etc.). " "The intent is two-fold:" msgstr "DisplayList는 그리기 명령(텍스트, 이미지 등)을 포함하는 리스트입니다. 목적은 두 가지입니다:" #: ../../displaylist.rst:11 01de3b874c654c729617cd5a69c98a06 msgid "as a caching-mechanism to reduce parsing of a page" msgstr "페이지 파싱을 줄이기 위한 캐싱 메커니즘으로" #: ../../displaylist.rst:12 e47cc33899c24e9b8b48607d9cc55aca msgid "" "as a data structure in multi-threading setups, where one thread parses " "the page and another one renders pages. This aspect is currently not " "supported by PyMuPDF." msgstr "멀티스레딩 설정에서 데이터 구조로, 한 스레드는 페이지를 파싱하고 다른 스레드는 페이지를 렌더링합니다. 이 측면은 현재 PyMuPDF에서 지원되지 않습니다." #: ../../displaylist.rst:14 ff6ed96e5e434d9ab8b7c046b2b5b89e msgid "" "A display list is populated with objects from a page, usually by " "executing :meth:`Page.get_displaylist`. There also exists an independent " "constructor." msgstr "디스플레이 리스트는 일반적으로 :meth:`Page.get_displaylist` 를 실행하여 페이지의 객체로 채워집니다. 독립적인 생성자도 존재합니다." #: ../../displaylist.rst:16 66dc12118dd1430c91493428b6adb3ca msgid "" "\"Replay\" the list (once or many times) by invoking one of its methods " ":meth:`~DisplayList.run`, :meth:`~DisplayList.get_pixmap` or " ":meth:`~DisplayList.get_textpage`." msgstr "리스트를 \"재생\"하려면(한 번 또는 여러 번) 메서드 중 하나인 :meth:`~DisplayList.run`, :meth:`~DisplayList.get_pixmap` 또는 :meth:`~DisplayList.get_textpage` 를 호출하세요." #: ../../displaylist.rst:20 c6df8741dd9746c4849b6615f4787387 msgid "**Method**" msgstr "**메서드**" #: ../../displaylist.rst:20 7f551f0499df4df7ad355142c819deef msgid "**Short Description**" msgstr "**간략 설명**" #: ../../displaylist.rst:22 81094ba0fcee4f3dac4c1d13adccd9d9 msgid ":meth:`~DisplayList.run`" msgstr ":meth:`~DisplayList.run`" #: ../../displaylist.rst:22 790d819aba1b4a4e89cf7059456f3be1 msgid "Run a display list through a device." msgstr "디스플레이 리스트를 디바이스를 통해 실행합니다." #: ../../displaylist.rst:23 c12a3766ae42430fadfe30df077ebef7 msgid ":meth:`~DisplayList.get_pixmap`" msgstr ":meth:`~DisplayList.get_pixmap`" #: ../../displaylist.rst:23 a2c2be7f9085440cb858e4a52c0253c3 msgid "generate a pixmap" msgstr "픽스맵 생성" #: ../../displaylist.rst:24 2e841e7218aa459b955f952f63f85c7f msgid ":meth:`~DisplayList.get_textpage`" msgstr ":meth:`~DisplayList.get_textpage`" #: ../../displaylist.rst:24 4b5a1849844142eba8b0e00c4ea85c1b msgid "generate a text page" msgstr "텍스트 페이지 생성" #: ../../displaylist.rst:25 e7f6a71e64b144b2bb150227a7b7183b msgid ":attr:`~DisplayList.rect`" msgstr ":attr:`~DisplayList.rect`" #: ../../displaylist.rst:25 205d05395d674e39a9e4f0e958d3d06f msgid "mediabox of the display list" msgstr "디스플레이 리스트의 mediabox" #: ../../displaylist.rst:29 4a42cea626fe4460b70834ce0af2a4ef msgid "**Class API**" msgstr "**클래스 API**" #: ../../displaylist.rst:35 9e9d57cb314843a081adb93c9240ac5f msgid "Create a new display list." msgstr "새 디스플레이 리스트를 생성합니다." #: ../../displaylist.rst 02a4c577c3194a778a9d75f67212861e #: 27616f064af541208365c4cf3260036b 27eb0863e4044881b0a7ef37d0114e28 #: d4d3d713dc85432f9ebc95eac1f51a09 msgid "Parameters" msgstr "매개변수" #: ../../displaylist.rst:37 06aebf2ce5d941adbb8e7aa50ae0b2b8 msgid "The page's rectangle." msgstr "페이지의 사각형." #: ../../displaylist.rst 3e56029375ab4b639b13a2bd6b5dc316 #: a18c2d343b454f2bb564792a3fc55a17 d0a557e9eef6429c8aa58d2cbac510a6 msgid "Return type" msgstr "반환 유형" #: ../../displaylist.rst:40 b8ad61a1e5a44b7587e9e889a0f7b29a msgid "``DisplayList``" msgstr "``DisplayList``" #: ../../displaylist.rst:44 ce5a41193477481c88976a823b4ad9d6 msgid "" "Run the display list through a device. The device will populate the " "display list with its \"commands\" (i.e. text extraction or image " "creation). The display list can later be used to \"read\" a page many " "times without having to re-interpret it from the document file." msgstr "디스플레이 리스트를 디바이스를 통해 실행합니다. 디바이스는 디스플레이 리스트를 \"명령\"(즉, 텍스트 추출 또는 이미지 생성)으로 채웁니다. 디스플레이 리스트는 나중에 문서 파일에서 다시 해석할 필요 없이 페이지를 여러 번 \"읽는\" 데 사용할 수 있습니다." #: ../../displaylist.rst:46 2dc2aba3d46f4fc4a7820028e1a60253 msgid "" "You will most probably instead use one of the specialized run methods " "below -- :meth:`get_pixmap` or :meth:`get_textpage`." msgstr "아래의 특수화된 실행 메서드 중 하나를 사용하는 것이 좋습니다 -- :meth:`get_pixmap` 또는 :meth:`get_textpage`." #: ../../displaylist.rst:48 6e70c4b85f91448c9a7c98c37c0a0ae4 msgid "Device" msgstr "Device" #: ../../displaylist.rst:51 2f667d2e56bf4e01898f21ff9eb28571 msgid "Transformation matrix to apply to the display list contents." msgstr "디스플레이 리스트 콘텐츠에 적용할 변환 행렬." #: ../../displaylist.rst:54 b64884bb37bd4618a66990bf4733f646 msgid "" "Only the part visible within this area will be considered when the list " "is run through the device." msgstr "리스트가 디바이스를 통해 실행될 때 이 영역 내에서 보이는 부분만 고려됩니다." #: ../../displaylist.rst:65 ab527e51c453471f9f60eedf09b9d087 msgid "Run the display list through a draw device and return a pixmap." msgstr "디스플레이 리스트를 그리기 디바이스를 통해 실행하고 픽스맵을 반환합니다." #: ../../displaylist.rst:67 61769985d519468490018723da292d0a msgid "matrix to use. Default is the identity matrix." msgstr "사용할 행렬. 기본값은 항등 행렬입니다." #: ../../displaylist.rst:70 5932c2f43fdd4b4c8a0f5d2d7c994379 msgid "the desired colorspace. Default is RGB." msgstr "원하는 색 공간. 기본값은 RGB입니다." #: ../../displaylist.rst:73 fbab40e0ab2c491e9dfb956c94981baa msgid "determine whether or not (0, default) to include a transparency channel." msgstr "투명도 채널을 포함할지 여부를 결정합니다(0, 기본값은 포함하지 않음)." #: ../../displaylist.rst:75 466d20a9e3a74fb78536c5cce52c0423 msgid "" "restrict rendering to the intersection of this area with " ":attr:`DisplayList.rect`." msgstr ":attr:`DisplayList.rect` 와 이 영역의 교집합으로 렌더링을 제한합니다." #: ../../displaylist.rst:77 757d1f9a21b041c6ae4ed0b958ce457b msgid ":ref:`Pixmap`" msgstr ":ref:`Pixmap`" #: ../../displaylist.rst 65ed81ab27df4ce49e030837b6f76d44 #: bc2f03674971487f858250a2cbe58732 msgid "Returns" msgstr "반환값" #: ../../displaylist.rst:78 ea8ff1cc1cdf40caa3e75151ca6cb92c msgid "pixmap of the display list." msgstr "디스플레이 리스트의 픽스맵." #: ../../displaylist.rst:82 f854adb186fc469aa47d5bd62e907d4d msgid "Run the display list through a text device and return a text page." msgstr "디스플레이 리스트를 텍스트 디바이스를 통해 실행하고 텍스트 페이지를 반환합니다." #: ../../displaylist.rst:84 a9b235a2d522430c93c09a55cb019b92 msgid "" "control which information is parsed into a text page. Default value in " "PyMuPDF is `3 = TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE`, i.e." " :data:`ligatures` are **passed through**, white spaces are **passed " "through** (not translated to spaces), and images are **not included**. " "See :ref:`TextPreserve`." msgstr "텍스트 페이지로 파싱되는 정보를 제어하는 플래그입니다. PyMuPDF의 기본값은 `3 = TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE` 입니다. 즉, :data:`ligatures` 는 **그대로 전달** 되고, 공백은 **그대로 전달** 되며(공백으로 변환되지 않음), 이미지는 **포함되지 않습니다**. :ref:`TextPreserve` 를 참조하세요." #: ../../displaylist.rst:86 daf0b2be9b6a4376b53e036006a9a7e3 msgid ":ref:`TextPage`" msgstr ":ref:`TextPage`" #: ../../displaylist.rst:87 4d6cd4f91f0e4964b02aad9a3db2ad8a msgid "text page of the display list." msgstr "디스플레이 리스트의 텍스트 페이지." #: ../../displaylist.rst:91 e4d71370db2d4368b08b17d8436d7747 msgid "" "Contains the display list's mediabox. This will equal the page's " "rectangle if it was created via :meth:`Page.get_displaylist`." msgstr "디스플레이 리스트의 mediabox를 포함합니다. :meth:`Page.get_displaylist` 를 통해 생성된 경우 페이지의 사각형과 같습니다." #: ../../displaylist.rst 0b6e65f6961f4c6b9882f9b9dfe93154 msgid "type" msgstr "유형" #: ../../displaylist.rst:93 f277dc21a3714454ae8f4cf4f1e5113d msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../footer.rst:46 e683ef7401754f0d941d78c8c96788e0 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/document-writer-class.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b5b4277baa2f45589bb33213fe28d133 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 99651177bb7e45218e911de8509ad3d7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 bfa8a6eb19134fd5a3ed2f7ff3e5a66b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../document-writer-class.rst:7 9ec19dc1ee5e4333ada6ca4a81b20c76 msgid "DocumentWriter" msgstr "DocumentWriter" #: ../../document-writer-class.rst:9 a8428a7a09fa4d84ba14e57e1cd9933c msgid "|pdf_only_class|" msgstr "|pdf_only_class|" #: ../../document-writer-class.rst:12 fdd84ae0909a4d88bcdceeefa2b39965 msgid "New in v1.21.0" msgstr "v1.21.0의 새로운 기능" #: ../../document-writer-class.rst:14 2d81b86330d54196bb5037872069be5e msgid "" "This class represents a utility which can output various :ref:`document " "types supported by PyMuPDF`." msgstr "이 클래스는 |PyMuPDF| 가 :ref:`지원하는 다양한 문서 유형` 을 출력할 수 있는 유틸리티를 나타냅니다." #: ../../document-writer-class.rst:16 f752c28f5ed14d28b92bcff7e31a12f8 msgid "" "In |PyMuPDF| only used for outputting PDF documents whose pages are " "populated by :ref:`Story` DOMs." msgstr "|PyMuPDF| 에서는 :ref:`Story` DOM으로 페이지가 채워진 PDF 문서를 출력하는 데만 사용됩니다." #: ../../document-writer-class.rst:18 a51f0f40cbb0442f86dc705ad1fa8132 msgid "" "Using DocumentWriter_ also for other document types might happen in the " "future." msgstr "DocumentWriter_ 를 다른 문서 유형에도 사용하는 것은 향후 가능할 수 있습니다." #: ../../document-writer-class.rst:21 8c16e93aa1ce4c6e89c38ba3555943a2 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../document-writer-class.rst:21 078570c061cc494ab88a122d6f975a13 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../document-writer-class.rst:23 e28aaeaab2de42e2be303102f8816b38 msgid ":meth:`DocumentWriter.begin_page`" msgstr ":meth:`DocumentWriter.begin_page`" #: ../../document-writer-class.rst:23 46462fa63c0f497ca2b40e3aa34b103a msgid "start a new output page" msgstr "새 출력 페이지 시작" #: ../../document-writer-class.rst:24 3fb4972774e64633aeb1fa920d332d0b msgid ":meth:`DocumentWriter.end_page`" msgstr ":meth:`DocumentWriter.end_page`" #: ../../document-writer-class.rst:24 deca462b344444baaba815c62c4ccf49 msgid "finish the current output page" msgstr "현재 출력 페이지 완료" #: ../../document-writer-class.rst:25 e80c1d8e184c453bbec00d4725057371 msgid ":meth:`DocumentWriter.close`" msgstr ":meth:`DocumentWriter.close`" #: ../../document-writer-class.rst:25 82b604112a0849018b6017d0b48a269a msgid "flush pending output and close the file" msgstr "대기 중인 출력을 플러시하고 파일 닫기" #: ../../document-writer-class.rst:28 77d9bb485f4345bc9066ac6cbf59d8a9 msgid "**Class API**" msgstr "**클래스 API**" #: ../../document-writer-class.rst:34 ae20c5fbdb154f71a4aa713c0690c587 msgid "" "Create a document writer object, passing a Python file pointer or a file " "path. Options to use when saving the file may also be passed." msgstr "Python 파일 포인터 또는 파일 경로를 전달하여 문서 작성자 객체를 생성합니다. 파일을 저장할 때 사용할 옵션도 전달할 수 있습니다." #: ../../document-writer-class.rst:36 6124d2357c6a4781a34eddaaf0ca7dfa msgid "This class can also be used as a Python context manager." msgstr "이 클래스는 Python 컨텍스트 관리자로도 사용할 수 있습니다." #: ../../document-writer-class.rst d2e1469751bd4c2e8536b3688da9abc9 #: e1457a30002847edb1dba253d238fc76 msgid "Parameters" msgstr "매개변수" #: ../../document-writer-class.rst:38 3fd7620d0e854ab3bc313135cc0b7a22 msgid "" "the output file. This may be a string file name, or any Python file " "pointer. .. note:: By using a `io.BytesIO()` object as file pointer, a " "document writer can create a PDF in memory. Subsequently, this PDF can be" " re-opened for input and be further manipulated. This technique is used " "by several example scripts in :ref:`Stories recipes`." msgstr "" #: ../../document-writer-class.rst:38 8206476585d647538a060a35c0be1961 msgid "" "the output file. This may be a string file name, or any Python file " "pointer." msgstr "출력 파일. 이것은 문자열 파일 이름이거나 모든 Python 파일 포인터일 수 있습니다." #: ../../document-writer-class.rst:40 5cc894a076804ce4bbaf88cd575d9067 msgid "" "By using a `io.BytesIO()` object as file pointer, a document writer can " "create a PDF in memory. Subsequently, this PDF can be re-opened for input" " and be further manipulated. This technique is used by several example " "scripts in :ref:`Stories recipes`." msgstr "`io.BytesIO()` 객체를 파일 포인터로 사용하면 문서 작성자가 메모리에서 PDF를 생성할 수 있습니다. 그런 다음 이 PDF를 입력용으로 다시 열고 추가로 조작할 수 있습니다. 이 기술은 :ref:`Stories recipes` 의 여러 예제 스크립트에서 사용됩니다." #: ../../document-writer-class.rst:42 8e2b505af0b34fec888ef183d42bc55a msgid "" "specify saving options for the output PDF. Typical are \"compress\" or " "\"clean\". More possible values may be taken from help output of the " "`mutool convert` CLI utility." msgstr "출력 PDF의 저장 옵션을 지정합니다. 일반적인 옵션은 \"compress\" 또는 \"clean\"입니다. 더 많은 가능한 값은 `mutool convert` CLI 유틸리티의 도움말 출력에서 가져올 수 있습니다." #: ../../document-writer-class.rst:46 f4aad7b430d043e1af763b51fe58f1be msgid "Start a new output page of a given dimension." msgstr "주어진 크기의 새 출력 페이지를 시작합니다." #: ../../document-writer-class.rst:48 d97df503773b4b5d804d95f381624a79 msgid "" "a rectangle specifying the page size. After this method, output " "operations may write content to the page." msgstr "페이지 크기를 지정하는 사각형. 이 메서드 후에 출력 작업이 페이지에 콘텐츠를 쓸 수 있습니다." #: ../../document-writer-class.rst:52 3357a3e14b5c4681a572cf35f2056a51 msgid "" "Finish a page. This flushes any pending data and appends the page to the " "output document." msgstr "페이지를 완료합니다. 이것은 대기 중인 모든 데이터를 플러시하고 페이지를 출력 문서에 추가합니다." #: ../../document-writer-class.rst:56 b42cc189417341c8939b89cb1ea93a07 msgid "" "Close the output file. This method is required for writing any pending " "data." msgstr "출력 파일을 닫습니다. 대기 중인 데이터를 쓰려면 이 메서드가 필요합니다." #: ../../document-writer-class.rst:58 f5b95d821dfe45629904bb96a9fb09e4 msgid "For usage examples consult the section of :ref:`Story`." msgstr "사용 예제는 :ref:`Story` 섹션을 참조하세요." #: ../../footer.rst:46 de69d88972544cf695683e1f78897d93 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/document.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 44ccd9af706d4fd09cbe79b42e629a20 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 70ca2976f112470bb748e32924a487bd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF(및 기타) 문서의 데이터 추출, 분석, 변환 및 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 81b4037c4ad64026a570bc64aa3b9ddb msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../document.rst:7 6f9364c2520544c89caa6bccb4ace73d msgid "Document" msgstr "Document" #: ../../document.rst:11 b64bcbba58e84c91858551ce23f6e170 msgid "" "This class represents a document. It can be constructed from a file or " "from memory." msgstr "이 클래스는 문서를 나타냅니다. 파일 또는 메모리에서 생성할 수 있습니다." #: ../../document.rst:13 c5a7eb078446487baf15439ed4463a67 msgid "" "There exists the alias *open* for this class, i.e. " "`pymupdf.Document(...)` and `pymupdf.open(...)` do exactly the same " "thing." msgstr "" "이 클래스에는 *open* 별칭이 있습니다. 즉, `pymupdf.Document(...)` 와 `pymupdf.open(...)`" " 는 정확히 동일한 작업을 수행합니다." #: ../../document.rst:15 e66711c1a68c4bcb99c4a34100a14cd1 msgid "For details on **embedded files** refer to Appendix 3." msgstr "**임베디드 파일** 에 대한 자세한 내용은 부록 3을 참조하세요." #: ../../document.rst:19 26f0b72a907b4767b496b9a50b705cb7 msgid "" "Starting with v1.17.0, a new page addressing mechanism for **EPUB files " "only** is supported. This document type is internally organized in " "chapters such that pages can most efficiently be found by their so-called" " \"location\". The location is a tuple *(chapter, pno)* consisting of the" " chapter number and the page number **in that chapter**. Both numbers are" " zero-based." msgstr "" "v1.17.0부터 **EPUB 파일 전용** 새로운 페이지 주소 지정 메커니즘이 지원됩니다. 이 문서 타입은 내부적으로 장으로 " "구성되어 있어 페이지를 소위 \"location\" 으로 가장 효율적으로 찾을 수 있습니다. location은 장 번호와 **해당 " "장의** 페이지 번호로 구성된 튜플 *(chapter, pno)* 입니다. 두 숫자 모두 0부터 시작합니다." #: ../../document.rst:21 178b2c734378413abc91131145d04d44 msgid "" "While it is still possible to locate a page via its (absolute) number, " "doing so may mean that the complete EPUB document must be laid out before" " the page can be addressed. This may have a significant performance " "impact if the document is very large. Using the page's *(chapter, pno)* " "prevents this from happening." msgstr "" "여전히 (절대) 번호로 페이지를 찾을 수 있지만, 이렇게 하면 페이지를 주소 지정하기 전에 전체 EPUB 문서를 레이아웃해야 할 수" " 있습니다. 문서가 매우 큰 경우 성능에 상당한 영향을 줄 수 있습니다. 페이지의 *(chapter, pno)* 를 사용하면 이를 " "방지할 수 있습니다." #: ../../document.rst:23 2159d3254f2042e28d38a6352b880f37 msgid "" "To maintain a consistent API, PyMuPDF supports the page *location* syntax" " for **all file types** -- documents without this feature simply have " "just one chapter. :meth:`Document.load_page` and the equivalent index " "access now also support a *location* argument." msgstr "" "일관된 API를 유지하기 위해 |PyMuPDF| 는 **모든 파일 타입** 에 대해 페이지 *location* 구문을 지원합니다. " "이 기능이 없는 문서는 단순히 하나의 장만 가집니다. :meth:`Document.load_page` 및 동등한 인덱스 액세스는 " "이제 *location* 인수도 지원합니다." #: ../../document.rst:25 df232cf85be34f7694fc6bae4310265f msgid "" "There are a number of methods for converting between page numbers and " "locations, for determining the chapter count, the page count per chapter," " for computing the next and the previous locations, and the last page " "location of a document." msgstr "" "페이지 번호와 location 간 변환, 장 수 결정, 장당 페이지 수, 다음 및 이전 location 계산, 문서의 마지막 페이지" " location을 위한 여러 메서드가 있습니다." #: ../../document.rst:28 46f524c760e44c68ac0212f9fb4848a2 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../document.rst:28 4e9377212f2f4e3082b3e2b410eab114 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../document.rst:30 5b3602e531d94c1db1c6497e9803431f msgid ":meth:`Document.add_layer`" msgstr ":meth:`Document.add_layer`" #: ../../document.rst:30 65d3136ffad541db9619e9893cfdf1f8 msgid "PDF only: make new optional content configuration" msgstr "PDF 전용: 새로운 선택적 콘텐츠 구성 만들기" #: ../../document.rst:31 3c176560d54742a5b24d578c141af482 msgid ":meth:`Document.add_ocg`" msgstr ":meth:`Document.add_ocg`" #: ../../document.rst:31 201b8f9ef3564eb2b643e1d781ba9ebc msgid "PDF only: add new optional content group" msgstr "PDF 전용: 새로운 선택적 콘텐츠 그룹 추가" #: ../../document.rst:32 7ddab358521d4686bd9db4941273693b msgid ":meth:`Document.authenticate`" msgstr ":meth:`Document.authenticate`" #: ../../document.rst:32 6e2b79b1ac224cfbb3fb95f4607c5e08 msgid "gain access to an encrypted document" msgstr "암호화된 문서에 액세스" #: ../../document.rst:33 f23216d1e7344106bf5c998fa4e9fcc1 msgid ":meth:`Document.bake`" msgstr ":meth:`Document.bake`" #: ../../document.rst:33 701834a50a9449449b74ed220600c326 msgid "PDF only: make annotations / fields permanent content" msgstr "PDF 전용: 주석/필드를 영구 콘텐츠로 만들기" #: ../../document.rst:34 1445d611a0f54db29ae05f37b828c0a3 msgid ":meth:`Document.can_save_incrementally`" msgstr ":meth:`Document.can_save_incrementally`" #: ../../document.rst:34 9195cef3b66445fea3244e46c710903a msgid "check if incremental save is possible" msgstr "증분 저장이 가능한지 확인" #: ../../document.rst:35 06fd6aaf02c146c8ae72f3fab40cd5a5 msgid ":meth:`Document.chapter_page_count`" msgstr ":meth:`Document.chapter_page_count`" #: ../../document.rst:35 1b4ca64be4784cfa9d385e411ba4de10 msgid "number of pages in chapter" msgstr "장의 페이지 수" #: ../../document.rst:36 e22fa04e62c34c00946eff36e3cbf8d2 msgid ":meth:`Document.close`" msgstr ":meth:`Document.close`" #: ../../document.rst:36 8dd025a8b44244e2b675ca00ea7467b3 msgid "close the document" msgstr "문서 닫기" #: ../../document.rst:37 2df8c1ec290848699114b13a06ca7702 msgid ":meth:`Document.convert_to_pdf`" msgstr ":meth:`Document.convert_to_pdf`" #: ../../document.rst:37 07ae613bdb784b69adf173fa0bcd3d84 msgid "write a PDF version to memory" msgstr "메모리에 PDF 버전 쓰기" #: ../../document.rst:38 9130926279ca4df19aec8e03217dfd20 msgid ":meth:`Document.copy_page`" msgstr ":meth:`Document.copy_page`" #: ../../document.rst:38 2284f3eeb2104ff5945ac48b6f9dc501 msgid "PDF only: copy a page reference" msgstr "PDF 전용: 페이지 참조 복사" #: ../../document.rst:39 a4a84dbf2abb4f8b87db310b7e5d6f65 msgid ":meth:`Document.del_toc_item`" msgstr ":meth:`Document.del_toc_item`" #: ../../document.rst:39 1d88797ba50244df87c018fbd0a1325c msgid "PDF only: remove a single TOC item" msgstr "PDF 전용: 단일 TOC 항목 제거" #: ../../document.rst:40 4b5b2f2193ee40268e3409b60e9d1993 msgid ":meth:`Document.delete_page`" msgstr ":meth:`Document.delete_page`" #: ../../document.rst:40 3b0577dd9e9d493eb0b8f2d054e76e32 msgid "PDF only: delete a page" msgstr "PDF 전용: 페이지 삭제" #: ../../document.rst:41 98476640118346639145607edd0502bb msgid ":meth:`Document.delete_pages`" msgstr ":meth:`Document.delete_pages`" #: ../../document.rst:41 2538d93965d74c58bbbf5e4596c5f25d msgid "PDF only: delete multiple pages" msgstr "PDF 전용: 여러 페이지 삭제" #: ../../document.rst:42 61345aebdd664464829398e410a5310b msgid ":meth:`Document.embfile_add`" msgstr ":meth:`Document.embfile_add`" #: ../../document.rst:42 5a68f72c35de4d37b228d5f8346c4580 msgid "PDF only: add a new embedded file from buffer" msgstr "PDF 전용: 버퍼에서 새 임베디드 파일 추가" #: ../../document.rst:43 18633aec87e94b9ca718ea6ed390688d msgid ":meth:`Document.embfile_count`" msgstr ":meth:`Document.embfile_count`" #: ../../document.rst:43 f033cc2e882b4095a655c775436b4735 msgid "PDF only: number of embedded files" msgstr "PDF 전용: 임베디드 파일 수" #: ../../document.rst:44 06a7fe3f8efc49909007b9940d51ad20 msgid ":meth:`Document.embfile_del`" msgstr ":meth:`Document.embfile_del`" #: ../../document.rst:44 5b16fd13df354ec08ec0e0f2237988a9 msgid "PDF only: delete an embedded file entry" msgstr "PDF 전용: 임베디드 파일 항목 삭제" #: ../../document.rst:45 60594207c907496aa08c503b3cfe89f6 msgid ":meth:`Document.embfile_get`" msgstr ":meth:`Document.embfile_get`" #: ../../document.rst:45 999f103381d34492a8ba2b37a6086938 msgid "PDF only: extract an embedded file buffer" msgstr "PDF 전용: 임베디드 파일 버퍼 추출" #: ../../document.rst:46 e9bf1793dd2747629395caecc286671a msgid ":meth:`Document.embfile_info`" msgstr ":meth:`Document.embfile_info`" #: ../../document.rst:46 125fea066b3942b08edaad0bc6d3f4a7 msgid "PDF only: metadata of an embedded file" msgstr "PDF 전용: 임베디드 파일의 메타데이터" #: ../../document.rst:47 76e5c528f0c0400a97717a27fa7c782b msgid ":meth:`Document.embfile_names`" msgstr ":meth:`Document.embfile_names`" #: ../../document.rst:47 afb7511107e34829b92c8dd670340f11 msgid "PDF only: list of embedded files" msgstr "PDF 전용: 임베디드 파일 목록" #: ../../document.rst:48 95b76c0413ad4f1dbcccefe6473aaed0 msgid ":meth:`Document.embfile_upd`" msgstr ":meth:`Document.embfile_upd`" #: ../../document.rst:48 8a1ba2aa97ad4d93b72b824b5972f61d msgid "PDF only: change an embedded file" msgstr "PDF 전용: 임베디드 파일 변경" #: ../../document.rst:49 c15752ac19fe4bf3b06f09954bedb276 msgid ":meth:`Document.extract_font`" msgstr ":meth:`Document.extract_font`" #: ../../document.rst:49 16b2ad2113eb4c9486a04750afbeb48e msgid "PDF only: extract a font by :data:`xref`" msgstr "PDF 전용: :data:`xref` 로 글꼴 추출" #: ../../document.rst:50 9a00f7ac64df4bdc972886fe7daef5f5 msgid ":meth:`Document.extract_image`" msgstr ":meth:`Document.extract_image`" #: ../../document.rst:50 231c94516aae4427b026bb5b2d3d9093 msgid "PDF only: extract an embedded image by :data:`xref`" msgstr "PDF 전용: :data:`xref` 로 임베디드 이미지 추출" #: ../../document.rst:51 baebb0fc699c458984b242b7139e1728 msgid ":meth:`Document.ez_save`" msgstr ":meth:`Document.ez_save`" #: ../../document.rst:51 3ce9b54342e7444eaf2b9f3bba3e6f16 msgid "PDF only: :meth:`Document.save` with different defaults" msgstr "PDF 전용: 다른 기본값으로 :meth:`Document.save`" #: ../../document.rst:52 5cec6b3c172f4656a22121134d433007 msgid ":meth:`Document.find_bookmark`" msgstr ":meth:`Document.find_bookmark`" #: ../../document.rst:52 ec569e92de1f4544a945bfaca8347747 msgid "retrieve page location after laid out document" msgstr "레이아웃된 문서 후 페이지 location 검색" #: ../../document.rst:53 934ec46a1ef84942ae7d272bb00b5de3 msgid ":meth:`Document.fullcopy_page`" msgstr ":meth:`Document.fullcopy_page`" #: ../../document.rst:53 af34d7a3cda34a54a4b0722878c745a1 msgid "PDF only: duplicate a page" msgstr "PDF 전용: 페이지 복제" #: ../../document.rst:54 beac81b115604ae688930966a58178bf msgid ":meth:`Document.get_layer`" msgstr ":meth:`Document.get_layer`" #: ../../document.rst:54 b970ece30e74455f872d4a1f28bd88b4 msgid "PDF only: lists of OCGs in ON, OFF, RBGroups" msgstr "PDF 전용: ON, OFF, RBGroups의 OCG 목록" #: ../../document.rst:55 8afcf442694c4348be8b13278c5e8443 msgid ":meth:`Document.get_layers`" msgstr ":meth:`Document.get_layers`" #: ../../document.rst:55 062661b7effe49e684f1e499084b08b7 msgid "PDF only: list of optional content configurations" msgstr "PDF 전용: 선택적 콘텐츠 구성 목록" #: ../../document.rst:56 85e0ac74eca046faa7c0556a44b1a8d0 msgid ":meth:`Document.get_oc`" msgstr ":meth:`Document.get_oc`" #: ../../document.rst:56 b561cdb739f0443facf651a7b7ab8229 msgid "PDF only: get OCG /OCMD xref of image / form xobject" msgstr "PDF 전용: 이미지/폼 xobject의 OCG/OCMD xref 가져오기" #: ../../document.rst:57 b09065ba3930470ebf537f0ddb5a498f msgid ":meth:`Document.get_ocgs`" msgstr ":meth:`Document.get_ocgs`" #: ../../document.rst:57 873364f685fb4875bb78e820afa1e216 msgid "PDF only: info on all optional content groups" msgstr "PDF 전용: 모든 선택적 콘텐츠 그룹 정보" #: ../../document.rst:58 99b8161657d24b2eb4f397ce80f5f36f msgid ":meth:`Document.get_ocmd`" msgstr ":meth:`Document.get_ocmd`" #: ../../document.rst:58 24cde3757ecd4f6683277d7674f33b96 msgid "PDF only: retrieve definition of an :data:`OCMD`" msgstr "PDF 전용: :data:`OCMD` 정의 검색" #: ../../document.rst:59 1e447980e885431990479bbaac18087f msgid ":meth:`Document.get_page_fonts`" msgstr ":meth:`Document.get_page_fonts`" #: ../../document.rst:59 218a049cce39410cb568fcec949a0cb1 msgid "PDF only: list of fonts referenced by a page" msgstr "PDF 전용: 페이지에서 참조하는 글꼴 목록" #: ../../document.rst:60 634e95f27afe40aabed15306e6e5f3a8 msgid ":meth:`Document.get_page_images`" msgstr ":meth:`Document.get_page_images`" #: ../../document.rst:60 c77477a1f9784f0ab264def72a81bb15 msgid "PDF only: list of images referenced by a page" msgstr "PDF 전용: 페이지에서 참조하는 이미지 목록" #: ../../document.rst:61 0727d4b995964e10af190dd7cfb897e5 msgid ":meth:`Document.get_page_labels`" msgstr ":meth:`Document.get_page_labels`" #: ../../document.rst:61 fa0286f2112a4c94a90c75e6175dbbbe msgid "PDF only: list of page label definitions" msgstr "PDF 전용: 페이지 레이블 정의 목록" #: ../../document.rst:62 6221c6245a934039a5818787cf85bee0 msgid ":meth:`Document.get_page_numbers`" msgstr ":meth:`Document.get_page_numbers`" #: ../../document.rst:62 9055b20ef77543ccaa348fd85e287813 msgid "PDF only: get page numbers having a given label" msgstr "PDF 전용: 주어진 레이블을 가진 페이지 번호 가져오기" #: ../../document.rst:63 b890980658c145fc86e2d8453e4dc4bf msgid ":meth:`Document.get_page_pixmap`" msgstr ":meth:`Document.get_page_pixmap`" #: ../../document.rst:63 9bf18031a8264a1195ef48bf05f6ebcd msgid "create a pixmap of a page by page number" msgstr "페이지 번호로 페이지의 pixmap 생성" #: ../../document.rst:64 2c3b6eb10d2c443c9e43f14fcf323679 msgid ":meth:`Document.get_page_text`" msgstr ":meth:`Document.get_page_text`" #: ../../document.rst:64 e50152ab76234bd199393b23c20e5f2b msgid "extract the text of a page by page number" msgstr "페이지 번호로 페이지의 텍스트 추출" #: ../../document.rst:65 6e3dbc70b1af422ba02c5de40db51227 msgid ":meth:`Document.get_page_xobjects`" msgstr ":meth:`Document.get_page_xobjects`" #: ../../document.rst:65 03e1a6c888d6428da83be3d52fcc6dc5 msgid "PDF only: list of XObjects referenced by a page" msgstr "PDF 전용: 페이지에서 참조하는 XObject 목록" #: ../../document.rst:66 d7fed3570628496781e26eea0fb88560 msgid ":meth:`Document.get_sigflags`" msgstr ":meth:`Document.get_sigflags`" #: ../../document.rst:66 57ae0f17dfbf46dfbda2134cd4e08b21 msgid "PDF only: determine signature state" msgstr "PDF 전용: 서명 상태 확인" #: ../../document.rst:67 1b9ec8899eab41e1b6e41764596a29fa msgid ":meth:`Document.get_toc`" msgstr ":meth:`Document.get_toc`" #: ../../document.rst:67 866abb5def4347499ca11de1dbe1a8e1 msgid "extract the table of contents" msgstr "목차 추출" #: ../../document.rst:68 82845c18f95c434790783d3885e3e58c msgid ":meth:`Document.get_xml_metadata`" msgstr ":meth:`Document.get_xml_metadata`" #: ../../document.rst:68 c6779c10381c4226a246aaf0ed325272 msgid "PDF only: read the XML metadata" msgstr "PDF 전용: XML 메타데이터 읽기" #: ../../document.rst:69 2a2d620a34c549f187ea62b6f2994726 msgid ":meth:`Document.has_annots`" msgstr ":meth:`Document.has_annots`" #: ../../document.rst:69 9998561217d44b509743282a54412d14 msgid "PDF only: check if PDF contains any annots" msgstr "PDF 전용: PDF에 주석이 있는지 확인" #: ../../document.rst:70 9bfb1faf1cc045bdae83c0bef14cb87a msgid ":meth:`Document.has_links`" msgstr ":meth:`Document.has_links`" #: ../../document.rst:70 b3b5865766b146cba5209502fbdc7016 msgid "PDF only: check if PDF contains any links" msgstr "PDF 전용: PDF에 링크가 있는지 확인" #: ../../document.rst:71 932fc1b4e64741b0ac7ece1f30469b48 msgid ":meth:`Document.insert_page`" msgstr ":meth:`Document.insert_page`" #: ../../document.rst:71 270cba89f81345efa9dafa53163b187b msgid "PDF only: insert a new page" msgstr "PDF 전용: 새 페이지 삽입" #: ../../document.rst:72 f5a25046b2c3451ea1a3a6a71ecad26d msgid ":meth:`Document.insert_pdf`" msgstr ":meth:`Document.insert_pdf`" #: ../../document.rst:72 2d42116aae5e442a907b006552760768 msgid "PDF only: insert pages from another PDF" msgstr "PDF 전용: 다른 PDF에서 페이지 삽입" #: ../../document.rst:73 5e07d2a848454f8ebc0e60f5c15361da msgid ":meth:`Document.insert_file`" msgstr ":meth:`Document.insert_file`" #: ../../document.rst:73 a13c5a83593743148f171785c25abfbe msgid "PDF only: insert pages from arbitrary document" msgstr "PDF 전용: 임의 문서에서 페이지 삽입" #: ../../document.rst:74 da81e9fba93c4e02bd963939be7fd721 msgid ":meth:`Document.journal_can_do`" msgstr ":meth:`Document.journal_can_do`" #: ../../document.rst:74 f003731191ba400aa315f4d89a7e4496 msgid "PDF only: which journal actions are possible" msgstr "PDF 전용: 어떤 저널 작업이 가능한지" #: ../../document.rst:75 53afd4fad6684cbcbf998d63695219f6 msgid ":meth:`Document.journal_enable`" msgstr ":meth:`Document.journal_enable`" #: ../../document.rst:75 466c85e3cd404f1eb8a1aab4a9eff2ef msgid "PDF only: enables journalling for the document" msgstr "PDF 전용: 문서에 대한 저널링 활성화" #: ../../document.rst:76 8a840e1674cb4a8292514219d5233be5 msgid ":meth:`Document.journal_load`" msgstr ":meth:`Document.journal_load`" #: ../../document.rst:76 be15f80486ba4b5eb417b7536e7a9c1f msgid "PDF only: load journal from a file" msgstr "PDF 전용: 파일에서 저널 로드" #: ../../document.rst:77 c3abfd7dfc684a0eabab17f2154ef1cb msgid ":meth:`Document.journal_op_name`" msgstr ":meth:`Document.journal_op_name`" #: ../../document.rst:77 8f0cf3234beb49a69154166b09198334 msgid "PDF only: return name of a journalling step" msgstr "PDF 전용: 저널링 단계의 이름 반환" #: ../../document.rst:78 3893cf1fdeb9469b9e6e653eaa9e1c44 msgid ":meth:`Document.journal_position`" msgstr ":meth:`Document.journal_position`" #: ../../document.rst:78 0e35098b113747de855c33fde152b50c msgid "PDF only: return journalling status" msgstr "PDF 전용: 저널링 상태 반환" #: ../../document.rst:79 52ff8d29e1ff41b5b7a9f6eed3eca524 msgid ":meth:`Document.journal_redo`" msgstr ":meth:`Document.journal_redo`" #: ../../document.rst:79 5de38e35b20f4c8c9c7669bf4faff487 msgid "PDF only: redo current operation" msgstr "PDF 전용: 현재 작업 다시 실행" #: ../../document.rst:80 cb385893200e4bb1ba7ac9d5ed8f9f52 msgid ":meth:`Document.journal_save`" msgstr ":meth:`Document.journal_save`" #: ../../document.rst:80 c5827a1af6cd46d0b852b6f8d8c5d013 msgid "PDF only: save journal to a file" msgstr "PDF 전용: 파일에 저널 저장" #: ../../document.rst:81 5df7cd504f094a9f957f314d8d835bef msgid ":meth:`Document.journal_start_op`" msgstr ":meth:`Document.journal_start_op`" #: ../../document.rst:81 535142a5dd984152a49fee7de70e3625 msgid "PDF only: start an \"operation\" giving it a name" msgstr "PDF 전용: 이름을 지정하여 \"작업\" 시작" #: ../../document.rst:82 d95c10cd751448148b51128e83d187d1 msgid ":meth:`Document.journal_stop_op`" msgstr ":meth:`Document.journal_stop_op`" #: ../../document.rst:82 76267fa3c43546d3a8433b9483244816 msgid "PDF only: end current operation" msgstr "PDF 전용: 현재 작업 종료" #: ../../document.rst:83 6c06ee831e5d492582f709a89de650da msgid ":meth:`Document.journal_undo`" msgstr ":meth:`Document.journal_undo`" #: ../../document.rst:83 48a3042404bc45da9d5b1aa672c5e5e3 msgid "PDF only: undo current operation" msgstr "PDF 전용: 현재 작업 실행 취소" #: ../../document.rst:84 a7663f4b73274da08256c916f19f008a msgid ":meth:`Document.layer_ui_configs`" msgstr ":meth:`Document.layer_ui_configs`" #: ../../document.rst:84 a5ea77e6f6ec4f50acb131b0cb83fe8e msgid "PDF only: list of optional content intents" msgstr "PDF 전용: 선택적 콘텐츠 의도 목록" #: ../../document.rst:85 e25b0824906149399a490263db250b41 msgid ":meth:`Document.layout`" msgstr ":meth:`Document.layout`" #: ../../document.rst:85 9d414ccd3311467f9526fbcfb70a3cd4 msgid "re-paginate the document (if supported)" msgstr "문서 재페이지화(지원되는 경우)" #: ../../document.rst:86 8e8d6694b6434582a77b4d60c4685594 msgid ":meth:`Document.load_page`" msgstr ":meth:`Document.load_page`" #: ../../document.rst:86 2a290bf3d63347c69c3bfe1ee7d2c3c8 msgid "read a page" msgstr "페이지 읽기" #: ../../document.rst:87 b9f9cb023be64cf2a96f7d065646060d msgid ":meth:`Document.make_bookmark`" msgstr ":meth:`Document.make_bookmark`" #: ../../document.rst:87 345855234e20436e8ed4aaa74ef9351a msgid "create a page pointer in reflowable documents" msgstr "재배치 가능한 문서에서 페이지 포인터 생성" #: ../../document.rst:88 29d4e91b8ab54e0eaf2d20b0a751f624 msgid ":meth:`Document.move_page`" msgstr ":meth:`Document.move_page`" #: ../../document.rst:88 691dccf584bc4853b6e2d5675c80c7d3 msgid "PDF only: move a page to different location in doc" msgstr "PDF 전용: 문서 내 다른 위치로 페이지 이동" #: ../../document.rst:89 67c910fcd5ed41c9991479c54e306404 msgid ":meth:`Document.need_appearances`" msgstr ":meth:`Document.need_appearances`" #: ../../document.rst:89 154d52d4749041489a187968e2b62e29 msgid "PDF only: get/set `/NeedAppearances` property" msgstr "PDF 전용: `/NeedAppearances` 속성 가져오기/설정" #: ../../document.rst:90 67997ce8145242828157b731aeea5309 msgid ":meth:`Document.new_page`" msgstr ":meth:`Document.new_page`" #: ../../document.rst:90 f373235056a94d918bf71a59a4e39fb6 msgid "PDF only: insert a new empty page" msgstr "PDF 전용: 새 빈 페이지 삽입" #: ../../document.rst:91 2ebb59db0b7c46f5b8372676ec664cc2 msgid ":meth:`Document.next_location`" msgstr ":meth:`Document.next_location`" #: ../../document.rst:91 fea286b98cea474ea4dd19ca31d36bf3 msgid "return (chapter, pno) of following page" msgstr "다음 페이지의 (chapter, pno) 반환" #: ../../document.rst:92 4d9ab9b1b05348f3b04acd8b61454fe9 msgid ":meth:`Document.outline_xref`" msgstr ":meth:`Document.outline_xref`" #: ../../document.rst:92 01c12f7a26a74fd5bf9821784d29795e msgid "PDF only: :data:`xref` a TOC item" msgstr "PDF 전용: TOC 항목의 :data:`xref`" #: ../../document.rst:93 9768ffa1299a442caccdf7c671b0bf27 msgid ":meth:`Document.page_cropbox`" msgstr ":meth:`Document.page_cropbox`" #: ../../document.rst:93 dd064dbd65b448cc9042f887cac6617c msgid "PDF only: the unrotated page rectangle" msgstr "PDF 전용: 회전되지 않은 페이지 사각형" #: ../../document.rst:94 b41ff5956b474fa397c37ade86b111ee msgid ":meth:`Document.page_xref`" msgstr ":meth:`Document.page_xref`" #: ../../document.rst:94 0824864d572b403c8674639a069fa531 msgid "PDF only: :data:`xref` of a page number" msgstr "PDF 전용: 페이지 번호의 :data:`xref`" #: ../../document.rst:95 b8928e6f8083487493c9d650c0907cf7 msgid ":meth:`Document.pages`" msgstr ":meth:`Document.pages`" #: ../../document.rst:95 953faf375f4a4467b9cc641f8aa60451 msgid "iterator over a page range" msgstr "페이지 범위에 대한 반복자" #: ../../document.rst:96 ee1c62d129c843e282a7042ed3b6e72a msgid ":meth:`Document.pdf_catalog`" msgstr ":meth:`Document.pdf_catalog`" #: ../../document.rst:96 48452a6b17f64ea6bbfeb6a5f978d17a msgid "PDF only: :data:`xref` of catalog (root)" msgstr "PDF 전용: 카탈로그(루트)의 :data:`xref`" #: ../../document.rst:97 0da14aaa4866451eb1be470696335f35 msgid ":meth:`Document.pdf_trailer`" msgstr ":meth:`Document.pdf_trailer`" #: ../../document.rst:97 8fcead81b4a349a89a593a5f87b1f579 msgid "PDF only: trailer source" msgstr "PDF 전용: 트레일러 소스" #: ../../document.rst:98 52890ca247594e77857e850c264f6bb1 msgid ":meth:`Document.prev_location`" msgstr ":meth:`Document.prev_location`" #: ../../document.rst:98 6b4f422f07a04229a6b0cf9f67ec4fd8 msgid "return (chapter, pno) of preceding page" msgstr "이전 페이지의 (chapter, pno) 반환" #: ../../document.rst:99 d6c679d125c042528e2960090decfc63 msgid ":meth:`Document.rewrite_images`" msgstr ":meth:`Document.rewrite_images`" #: ../../document.rst:99 ad80fd7b1a02452f943efeac7a6fe588 msgid "PDF only: rewrite / extra compression for images" msgstr "PDF 전용: 이미지 재작성/추가 압축" #: ../../document.rst:100 90879d3f9f35492ab438590b55f64080 msgid ":meth:`Document.recolor`" msgstr ":meth:`Document.recolor`" #: ../../document.rst:100 048b7aa969ff482397e0f20f2113e309 msgid "PDF only: execute :meth:`Page.recolor` for all pages" msgstr "PDF 전용: 모든 페이지에 대해 :meth:`Page.recolor` 실행" #: ../../document.rst:101 0420a4b50b874b069c87053bacb087ad msgid ":meth:`Document.reload_page`" msgstr ":meth:`Document.reload_page`" #: ../../document.rst:101 4e23ac1ef56e49d497dd09d1bb07a50a msgid "PDF only: provide a new copy of a page" msgstr "PDF 전용: 페이지의 새 복사본 제공" #: ../../document.rst:102 e6f66d0ad9a241a787373320375cb6ea msgid ":meth:`Document.resolve_names`" msgstr ":meth:`Document.resolve_names`" #: ../../document.rst:102 08c8ce45d9934cf486d9652f5351d823 msgid "PDF only: Convert destination names into a Python dict" msgstr "PDF 전용: 대상 이름을 Python dict로 변환" #: ../../document.rst:103 f53e78a26a26487898548af383ad2b04 msgid ":meth:`Document.save`" msgstr ":meth:`Document.save`" #: ../../document.rst:103 e1666396777c469eaa440b91907b4ba4 msgid "PDF only: save the document" msgstr "PDF 전용: 문서 저장" #: ../../document.rst:104 79410e6cae40486a9e185a468505c1d0 msgid ":meth:`Document.saveIncr`" msgstr ":meth:`Document.saveIncr`" #: ../../document.rst:104 e043fb40d0c14b578d219707f0e5c381 msgid "PDF only: save the document incrementally" msgstr "PDF 전용: 문서 증분 저장" #: ../../document.rst:105 0805ea1a287f460082863449cf526443 msgid ":meth:`Document.scrub`" msgstr ":meth:`Document.scrub`" #: ../../document.rst:105 048424aedefa422d99e89d8b18815b9a msgid "PDF only: remove sensitive data" msgstr "PDF 전용: 민감한 데이터 제거" #: ../../document.rst:106 f5637e670f41414d9c58af3aa5c3919c msgid ":meth:`Document.search_page_for`" msgstr ":meth:`Document.search_page_for`" #: ../../document.rst:106 954d77ecb8cf4cf7b4259b807d255e5f msgid "search for a string on a page" msgstr "페이지에서 문자열 검색" #: ../../document.rst:107 3c98443c81714deaaf66571cdc3aee63 msgid ":meth:`Document.select`" msgstr ":meth:`Document.select`" #: ../../document.rst:107 89f0842e40f244f3b1b2beeb03cf8f79 msgid "PDF only: select a subset of pages" msgstr "PDF 전용: 페이지 하위 집합 선택" #: ../../document.rst:108 ec80d7f1fd6e4ae6bd8fe34235e53d51 msgid ":meth:`Document.set_layer_ui_config`" msgstr ":meth:`Document.set_layer_ui_config`" #: ../../document.rst:108 bc3010d7daee494191971416ac2f27a3 msgid "PDF only: set OCG visibility temporarily" msgstr "PDF 전용: OCG 가시성 임시 설정" #: ../../document.rst:109 0de756b0b7da49cdb45d6ba4d1375de7 msgid ":meth:`Document.set_layer`" msgstr ":meth:`Document.set_layer`" #: ../../document.rst:109 062d5ad83cf1469ca236e2542030877b msgid "PDF only: mass changing OCG states" msgstr "PDF 전용: OCG 상태 대량 변경" #: ../../document.rst:110 6b915bb80b65485fa37649f3e25f9635 msgid ":meth:`Document.set_markinfo`" msgstr ":meth:`Document.set_markinfo`" #: ../../document.rst:110 c9a6ec82888f423897687332e5a6aeb9 msgid "PDF only: set the MarkInfo values" msgstr "PDF 전용: MarkInfo 값 설정" #: ../../document.rst:111 3e2e221f48e74d36aa62a40e05c5dc44 msgid ":meth:`Document.set_metadata`" msgstr ":meth:`Document.set_metadata`" #: ../../document.rst:111 2c0ba8035650467183a0348c174fc768 msgid "PDF only: set the metadata" msgstr "PDF 전용: 메타데이터 설정" #: ../../document.rst:112 23ab87427be240ec946ceeb5a4f558d7 msgid ":meth:`Document.set_oc`" msgstr ":meth:`Document.set_oc`" #: ../../document.rst:112 77f693748ae947f2baba48a8bc881a44 msgid "PDF only: attach OCG/OCMD to image / form xobject" msgstr "PDF 전용: 이미지/폼 xobject에 OCG/OCMD 첨부" #: ../../document.rst:113 cda51f6dbcec472299a7a16c636f0a12 msgid ":meth:`Document.set_ocmd`" msgstr ":meth:`Document.set_ocmd`" #: ../../document.rst:113 20d4b8a0924f4ea29246e027a1f0c007 msgid "PDF only: create or update an :data:`OCMD`" msgstr "PDF 전용: :data:`OCMD` 생성 또는 업데이트" #: ../../document.rst:114 a7e13374f46740c4822c7a5111703736 msgid ":meth:`Document.set_page_labels`" msgstr ":meth:`Document.set_page_labels`" #: ../../document.rst:114 94fe2ff39a9643378567dcb63f367048 msgid "PDF only: add/update page label definitions" msgstr "PDF 전용: 페이지 레이블 정의 추가/업데이트" #: ../../document.rst:115 60f0adf4c1034acd97a115b10f39646f msgid ":meth:`Document.set_pagemode`" msgstr ":meth:`Document.set_pagemode`" #: ../../document.rst:115 2de11d6c970445279a611a51fde70d09 msgid "PDF only: set the PageMode" msgstr "PDF 전용: PageMode 설정" #: ../../document.rst:116 6918b302a70047618b1f366d63f56f87 msgid ":meth:`Document.set_pagelayout`" msgstr ":meth:`Document.set_pagelayout`" #: ../../document.rst:116 ba12021554e24e189c726510b2ebee5f msgid "PDF only: set the PageLayout" msgstr "PDF 전용: PageLayout 설정" #: ../../document.rst:117 1ebdac8147c049f69aa6e0232975466e msgid ":meth:`Document.set_toc_item`" msgstr ":meth:`Document.set_toc_item`" #: ../../document.rst:117 8364d653136141b69b74d53e652719fd msgid "PDF only: change a single TOC item" msgstr "PDF 전용: 단일 TOC 항목 변경" #: ../../document.rst:118 2a317675273941beaad2c9211d911be7 msgid ":meth:`Document.set_toc`" msgstr ":meth:`Document.set_toc`" #: ../../document.rst:118 5f3982dba4914daaa18904ea68caade2 msgid "PDF only: set the table of contents (TOC)" msgstr "PDF 전용: 목차(TOC) 설정" #: ../../document.rst:119 94ee47ccf9a1419691946e271ef887e6 msgid ":meth:`Document.set_xml_metadata`" msgstr ":meth:`Document.set_xml_metadata`" #: ../../document.rst:119 8ebe617a04564a6a81e3729f7bea6248 msgid "PDF only: create or update document XML metadata" msgstr "PDF 전용: 문서 XML 메타데이터 생성 또는 업데이트" #: ../../document.rst:120 afc237479de04f878c80f9ca95546260 msgid ":meth:`Document.subset_fonts`" msgstr ":meth:`Document.subset_fonts`" #: ../../document.rst:120 74c0da056f3d49229285cdc50fc621fa msgid "PDF only: create font subsets" msgstr "PDF 전용: 글꼴 하위 집합 생성" #: ../../document.rst:121 89c3474ebdf8469b8df51d20bf5900fb msgid ":meth:`Document.switch_layer`" msgstr ":meth:`Document.switch_layer`" #: ../../document.rst:121 cd1b6a92de2c4a9cbc956b8cc27d6a0d msgid "PDF only: activate OC configuration" msgstr "PDF 전용: OC 구성 활성화" #: ../../document.rst:122 2c4e7b739b374987a9fae13bfbee26eb msgid ":meth:`Document.tobytes`" msgstr ":meth:`Document.tobytes`" #: ../../document.rst:122 2cbda5bb9d9745e08ce126b505a05ca7 msgid "PDF only: writes document to memory" msgstr "PDF 전용: 메모리에 문서 쓰기" #: ../../document.rst:123 2dff81839c264b1fa86c1b188e9502c1 msgid ":meth:`Document.xref_copy`" msgstr ":meth:`Document.xref_copy`" #: ../../document.rst:123 64a39ef729364a0ea13434f870b0f943 msgid "PDF only: copy a PDF dictionary to another :data:`xref`" msgstr "PDF 전용: PDF 딕셔너리를 다른 :data:`xref` 로 복사" #: ../../document.rst:124 1580d4746a56446d993210e18ea0de6e msgid ":meth:`Document.xref_get_key`" msgstr ":meth:`Document.xref_get_key`" #: ../../document.rst:124 8944519b866243fe8efbe830de8d7255 msgid "PDF only: get the value of a dictionary key" msgstr "PDF 전용: 딕셔너리 키의 값 가져오기" #: ../../document.rst:125 7173a26e0e9543f48763170017fa9e3b msgid ":meth:`Document.xref_get_keys`" msgstr ":meth:`Document.xref_get_keys`" #: ../../document.rst:125 b310a70e04e6405e8d148fcf54152bbb msgid "PDF only: list the keys of object at :data:`xref`" msgstr "PDF 전용: :data:`xref` 의 객체 키 목록" #: ../../document.rst:126 00bdb06b8b5549758da9e1899fb9f342 msgid ":meth:`Document.xref_object`" msgstr ":meth:`Document.xref_object`" #: ../../document.rst:126 f884a66ec00e467fa7e27e13ac4e3698 msgid "PDF only: get the definition source of :data:`xref`" msgstr "PDF 전용: :data:`xref` 의 정의 소스 가져오기" #: ../../document.rst:127 59678d3196fe4a31ae9e8a30b856dd51 msgid ":meth:`Document.xref_set_key`" msgstr ":meth:`Document.xref_set_key`" #: ../../document.rst:127 973aa3316e7543f9933bd6dd2396fdde msgid "PDF only: set the value of a dictionary key" msgstr "PDF 전용: 딕셔너리 키의 값 설정" #: ../../document.rst:128 68e9aab8d5c748e0bdcc0d0f68c75d0d msgid ":meth:`Document.xref_stream_raw`" msgstr ":meth:`Document.xref_stream_raw`" #: ../../document.rst:128 6a98c4bce47b40fb8b4d4b7c65016f3e msgid "PDF only: raw stream source at :data:`xref`" msgstr "PDF 전용: :data:`xref` 의 원시 스트림 소스" #: ../../document.rst:129 90600270debe41fab02700603bd39668 msgid ":meth:`Document.xref_xml_metadata`" msgstr ":meth:`Document.xref_xml_metadata`" #: ../../document.rst:129 fe9104e47feb4cde80ae1d21c7f02527 msgid "PDF only: :data:`xref` of XML metadata" msgstr "PDF 전용: XML 메타데이터의 :data:`xref`" #: ../../document.rst:130 2a38972d01a14963af624e5647cd2437 msgid ":attr:`Document.chapter_count`" msgstr ":attr:`Document.chapter_count`" #: ../../document.rst:130 9cffee9fac6b46f58dbb3f15f57f95f4 msgid "number of chapters" msgstr "장 수" #: ../../document.rst:131 a65efc93b59e40b0919ed0734ea60467 msgid ":attr:`Document.FormFonts`" msgstr ":attr:`Document.FormFonts`" #: ../../document.rst:131 31520e4940ce41adb477abd2bd8c1959 msgid "PDF only: list of global widget fonts" msgstr "PDF 전용: 전역 위젯 글꼴 목록" #: ../../document.rst:132 403f10b0f86247ae9613df5b06ebe74d msgid ":attr:`Document.is_closed`" msgstr ":attr:`Document.is_closed`" #: ../../document.rst:132 56e7e9bcb0b04d82b8e24e904e1d785f msgid "has document been closed?" msgstr "문서가 닫혔나요?" #: ../../document.rst:133 8f07cc755bef4cbdab45a3d3a55ae298 msgid ":attr:`Document.is_dirty`" msgstr ":attr:`Document.is_dirty`" #: ../../document.rst:133 538d5029daa1469090cf8ca7651b6fe2 msgid "PDF only: has document been changed yet?" msgstr "PDF 전용: 문서가 변경되었나요?" #: ../../document.rst:134 10e61f565e024e6e90d25c631e429fb8 msgid ":attr:`Document.is_encrypted`" msgstr ":attr:`Document.is_encrypted`" #: ../../document.rst:134 3d661d7413174d478ef8e8df9faf68d4 msgid "document (still) encrypted?" msgstr "문서가 (여전히) 암호화되어 있나요?" #: ../../document.rst:135 3934359bba084c55ac3861d5a21333ab msgid ":attr:`Document.is_fast_webaccess`" msgstr ":attr:`Document.is_fast_webaccess`" #: ../../document.rst:135 3e6aed8f3b8a444e9371093edc090830 msgid "is PDF linearized?" msgstr "PDF가 선형화되었나요?" #: ../../document.rst:136 db2d0d04655146cab76e2c677c42e6fa msgid ":attr:`Document.is_form_pdf`" msgstr ":attr:`Document.is_form_pdf`" #: ../../document.rst:136 3f8f952ffdf44f89929386cecb8ae090 msgid "is this a Form PDF?" msgstr "이것이 Form PDF인가요?" #: ../../document.rst:137 d93ff3eb5ef04b868a661bcfa04e5789 msgid ":attr:`Document.is_pdf`" msgstr ":attr:`Document.is_pdf`" #: ../../document.rst:137 7091e832546c41e5b2463e8848d6eaff msgid "is this a PDF?" msgstr "이것이 PDF인가요?" #: ../../document.rst:138 bcca823f15c242b783f465d7c49dbc08 msgid ":attr:`Document.is_reflowable`" msgstr ":attr:`Document.is_reflowable`" #: ../../document.rst:138 126b44ccff1d442281f3bb8aae57fdb0 msgid "is this a reflowable document?" msgstr "이것이 재배치 가능한 문서인가요?" #: ../../document.rst:139 3eaeba567fa543048ed9a6b7124708ff msgid ":attr:`Document.is_repaired`" msgstr ":attr:`Document.is_repaired`" #: ../../document.rst:139 6a01b1d2a2c543c4bb0a0af64488840c msgid "PDF only: has this PDF been repaired during open?" msgstr "PDF 전용: 이 PDF가 열리는 동안 수리되었나요?" #: ../../document.rst:140 70c231a16f1e415d92a69f2825540a3a msgid ":attr:`Document.last_location`" msgstr ":attr:`Document.last_location`" #: ../../document.rst:140 deaff42c88544730a696e276f1ee3356 msgid "(chapter, pno) of last page" msgstr "마지막 페이지의 (chapter, pno)" #: ../../document.rst:141 2dfa14e25a6945a3a108582a1841c5f2 msgid ":attr:`Document.metadata`" msgstr ":attr:`Document.metadata`" #: ../../document.rst:141 3c005bee965a4d6983014f54c70c0745 msgid "metadata" msgstr "metadata" #: ../../document.rst:142 e2e76a2e26c84bb7abb2a1cf2c3886eb msgid ":attr:`Document.markinfo`" msgstr ":attr:`Document.markinfo`" #: ../../document.rst:142 adf532837b4946519e3adf5658feda0b msgid "PDF MarkInfo value" msgstr "PDF MarkInfo 값" #: ../../document.rst:143 c9b166961e114d45bae6093d7b289056 msgid ":attr:`Document.name`" msgstr ":attr:`Document.name`" #: ../../document.rst:143 1a00c00be7f545d4b9f8322dac73b7a0 msgid "filename of document" msgstr "문서의 파일 이름" #: ../../document.rst:144 c1d6eb720bf546b69ac234d91b82c81d msgid ":attr:`Document.needs_pass`" msgstr ":attr:`Document.needs_pass`" #: ../../document.rst:144 844e8ad327bb49ecabd4a2014d08633e msgid "require password to access data?" msgstr "데이터 액세스에 비밀번호가 필요한가요?" #: ../../document.rst:145 7a82a24938a444b78c372a8a64c5f6a6 msgid ":attr:`Document.outline`" msgstr ":attr:`Document.outline`" #: ../../document.rst:145 51bb30f14a45459aafee41036779aefd msgid "first `Outline` item" msgstr "첫 번째 `Outline` 항목" #: ../../document.rst:146 035e8573692143248ff800c690d12a14 msgid ":attr:`Document.page_count`" msgstr ":attr:`Document.page_count`" #: ../../document.rst:146 a16b9f3e62be464e99e6e17ee0d89eee msgid "number of pages" msgstr "페이지 수" #: ../../document.rst:147 f870fbb0ac57487d95999b5229a01a2c msgid ":attr:`Document.permissions`" msgstr ":attr:`Document.permissions`" #: ../../document.rst:147 ad91c7a04147452bb800342c2b61fa3e msgid "permissions to access the document" msgstr "문서 액세스 권한" #: ../../document.rst:148 1ab3ec62dcc849a89d1dfdef6c3f9450 msgid ":attr:`Document.pagemode`" msgstr ":attr:`Document.pagemode`" #: ../../document.rst:148 03bd098a7c5b4168a2e597145c81b8b1 msgid "PDF PageMode value" msgstr "PDF PageMode 값" #: ../../document.rst:149 ac546f38c66f4c619203c1e400047866 msgid ":attr:`Document.pagelayout`" msgstr ":attr:`Document.pagelayout`" #: ../../document.rst:149 297c610806504aac9b1439935f9c876c msgid "PDF PageLayout value" msgstr "PDF PageLayout 값" #: ../../document.rst:150 c60c4a19eb464863a364d28d0cd6e111 msgid ":attr:`Document.version_count`" msgstr ":attr:`Document.version_count`" #: ../../document.rst:150 4b3612a523ae45af99c60a18fb4d114b msgid "PDF count of versions" msgstr "PDF 버전 수" #: ../../document.rst:153 d2bdb0fb83164bf0959ae16f5d6dc6dd msgid "**Class API**" msgstr "**클래스 API**" #: ../../document.rst:174 6451d24475784d32a99b011cdfcaa9f8 msgid "Create a ``Document`` object." msgstr "``Document`` 객체를 생성합니다." #: ../../document.rst:176 64a565f2ff36449b87d82c1c99493b67 msgid "With default parameters, a **new empty PDF** document will be created." msgstr "기본 매개변수를 사용하면 **새 빈 PDF** 문서가 생성됩니다." #: ../../document.rst:177 50f2c71dcec24699b5940564f67caf86 msgid "If ``stream`` is given, then the document is created from memory." msgstr "``stream`` 이 제공되면 문서가 메모리에서 생성됩니다." #: ../../document.rst:178 33e92cae18af4d17895e380dd9ed6867 msgid "" "If ``stream`` is `None`, then a document is created from the file given " "by ``filename``." msgstr "``stream`` 이 `None` 이면 ``filename`` 으로 지정된 파일에서 문서가 생성됩니다." #: ../../document.rst 011ee7615c7b431da28ad4a0f34a15ea #: 043e1f7f88294546bb28055113829f3c 05fbe4e150264d8c98845bf991aa451d #: 07ccc6435fc443a0b8b3ace5bde8df5d 0aaa1d00d7724cea8d50b7a0d1175fc5 #: 0dbf133d5966474f80441769534086c9 170025aaca9c4ec8b7d13dec29e5b232 #: 1ad58de6628f45ed85f92e616d5f1b89 1f8c9ef6c8874776abba5754093edb2b #: 1f91d09a2e3a4eb6902e439a24fc85d4 297d42ce6e624bdaab8ccf0148558cea #: 29d92736f06749be8093a4152834704f 2e955653fb8443519d7960d32db26bd2 #: 33feb2dfd464453eb16ec8933f1eac03 3ce32169d9af4e76a0b465264e073258 #: 3d86e3e54d5d4f0f8ac5cbf4cd3949db 3e5ef652ee204a13b2200d2ff5f1e7e5 #: 3f473faa03a649c287642f4ba4d971ba 408b5b208d5b49e88dbaf684542bfbfa #: 409b8fceac504f4abf1ef1ec7d77eb72 49df8a4b95154193b5df2620f0a275a0 #: 4bedcac6800d4ae09f2817f3ed1d0e62 4c32267c73b84f9e97295b8c549bbcc4 #: 4dbed9def0b246b6b317dee344729ac6 4ef2802c907044f692ad144a6b25c4ef #: 5163d8880d6b4688b9e93be572d6162e 58ffcea5f2524ad5bdccc8bf017574e4 #: 63771f4a8438461ea1aa13c8daa905ef 669d28e0f6ac4195bdb67e532d1b819d #: 6e395ebc7d9c4cdb8ebfc086b16d8e71 754278aec73b41d698a40b9364c3fb51 #: 78f440188fe14ece96c38413324756b6 7a359b69c8994a4f9c556dcfbe7a3f3b #: 7c13ff43ff5746f29a5067fee7748cca 7d3c575cf7d8441abeb9e17d24ff5b9c #: 7eacdc9a402a4d2d94e1c4eb1961a772 8e343c1256444dee9aea92a341606973 #: 93411fcbe3c64165a55f34297d058d6a 95500979035e4bc38e1e37be369b6f4a #: 961048fa2e2b4641ab46db1f4b0f7713 962cc6f293284ada9e7b8ac28a1ae338 #: 9960f80414664467b52697561ffb7dda 997d6aa772ea479d8b19880effb45444 #: 9c5ac8955ee944f1a0ab7a60ae6867c3 a00436c513104a7288f6d4cc1f19f5a9 #: a32902bfa30f4d848b38175e545779a5 a3f306f98e844f58a22519da78bdf879 #: a7d283f20a2f47349e35ca0d8cc52cd8 ab338f78ff44446eb34411310099834c #: ad31c573327c469181938b01534aed1a af00f235420648bab28e6d0b79d4a243 #: b6df452370724f7e9e15bb7c78273856 ba89cb4ecf3d423d95414de73be52994 #: bafc21087f4c4e69ad5d5dea423347e9 bbd53cac62e74bec85990b4148d9d8cb #: bec305b9b0af437c9cfabb6a81c4bec5 c0870c34fbca44a5b226b996aaee33fe #: c28037c809d049299e43f1b9b7fb1d9c cc7b4803acfc4b74840a07530bb2412e #: d2a8f4dd5628414db4250530dd010cae d3184e2ca6a34686a5e8c1a90e5b3eb5 #: d8432653099c4ac989efe85ee548a285 dc42b76dbc5f4e19ab4e6f87bb3b29a4 #: dc772479597c49be8700b8a5f272edc5 e0923d8b89424ea384e0f5a178804d1b #: e51810e9ad3f438298fb77f28bcb042c ec89e80f8b434a17941d0bd8ad34e9a7 #: eeda58a336794902b520182212b35979 f18fa2a6b3114ecb8802728c1601bb23 #: f5e02e10e6ac42fbb50930c6df235f8c f758028805654d02a020ffbbad2626f8 #: fa5511f7a1f448479736a410f199e0c4 fcb76ae90bf847dfb50d5b120e8fd97b #: fe71ecaaa4c44a7aaa7b89d0e916ca8f msgid "Parameters" msgstr "매개변수" #: ../../document.rst:180 014acda4567c436291e86a2b00e3fcaa msgid "" "A UTF-8 string or ``pathlib.Path`` object containing a file path. The " "document type is always determined from the file content. The " "``filetype`` parameter is ignored, except when content inspection was " "unsuccessful. This is regularly the case for plain text types like " "\"txt\", \"html\", \"xml\" etc. with a wrong or missing file extension." msgstr "" "파일 경로를 포함하는 UTF-8 문자열 또는 ``pathlib.Path`` 객체. 문서 타입은 항상 파일 콘텐츠에서 결정됩니다. " "``filetype`` 매개변수는 콘텐츠 검사가 실패한 경우를 제외하고 무시됩니다. 잘못되었거나 누락된 파일 확장자를 가진 " "\"txt\", \"html\", \"xml\" 등과 같은 일반 텍스트 타입의 경우가 일반적입니다." #: ../../document.rst:182 97a008f8fbe04599ad4e4ba4d6bdcaf7 msgid "" "A memory area containing file data. The document type is always detected " "from the data content. The ``filetype`` parameter is ignored, except when" " content inspection was unsuccessful. This is regularly the case for " "plain text types like \"txt\", \"html\", \"xml\" etc." msgstr "" "파일 데이터를 포함하는 메모리 영역. 문서 타입은 항상 데이터 콘텐츠에서 감지됩니다. ``filetype`` 매개변수는 콘텐츠 " "검사가 실패한 경우를 제외하고 무시됩니다. \"txt\", \"html\", \"xml\" 등과 같은 일반 텍스트 타입의 경우가 " "일반적입니다." #: ../../document.rst:184 f94f9deed99649d4914149d0f84ee237 msgid "" "A string specifying the type of document. This is only ever needed when " "file content inspection fails. Text types like \"txt\", \"html\", \"xml\"" " etc. cannot be disambiguated by their content. When such files are " "provided in memory or being provided with the wrong file extension, this " "parameter **must** be used." msgstr "" "문서 타입을 지정하는 문자열. 파일 콘텐츠 검사가 실패할 때만 필요합니다. \"txt\", \"html\", \"xml\" 등과 " "같은 텍스트 타입은 콘텐츠로 구분할 수 없습니다. 이러한 파일이 메모리에서 제공되거나 잘못된 파일 확장자로 제공되는 경우 이 " "매개변수를 **반드시** 사용해야 합니다." #: ../../document.rst:186 4fa028bb7c5642588afa6cc6342c5a88 msgid "" "a rectangle specifying the desired page size. This parameter is only " "meaningful for documents with a variable page layout (\"reflowable\" " "documents), like e-books or HTML, and ignored otherwise. If specified, it" " must be a non-empty, finite rectangle with top-left coordinates (0, 0). " "Together with parameter :data:`fontsize`, each page will be accordingly " "laid out and hence also determine the number of pages." msgstr "" "원하는 페이지 크기를 지정하는 사각형. 이 매개변수는 전자책이나 HTML과 같은 가변 페이지 레이아웃(\"재배치 가능한\" 문서)이" " 있는 문서에만 의미가 있으며, 그렇지 않으면 무시됩니다. 지정된 경우 왼쪽 위 좌표가 (0, 0)인 비어 있지 않은 유한 " "사각형이어야 합니다. :data:`fontsize` 매개변수와 함께 각 페이지가 그에 따라 레이아웃되므로 페이지 수도 결정됩니다." #: ../../document.rst:188 0e700acb9750499884fa95729f70533c msgid "" "may used together with ``height`` as an alternative to ``rect`` to " "specify layout information." msgstr "레이아웃 정보를 지정하기 위해 ``height`` 와 함께 ``rect`` 의 대안으로 사용할 수 있습니다." #: ../../document.rst:190 011cb8d1a5e14e1c9362a4977467f8b3 msgid "" "may used together with ``width`` as an alternative to ``rect`` to specify" " layout information." msgstr "레이아웃 정보를 지정하기 위해 ``width`` 와 함께 ``rect`` 의 대안으로 사용할 수 있습니다." #: ../../document.rst:192 4811a6a492ef40a09b407d00f0d2e3b9 msgid "" "the default :data:`fontsize` for reflowable document types. This " "parameter is ignored if none of the parameters ``rect`` or ``width`` and " "``height`` are specified. Will be used to calculate the page layout." msgstr "" "재배치 가능한 문서 타입의 기본 :data:`fontsize`. ``rect`` 또는 ``width`` 및 ``height`` " "매개변수가 지정되지 않은 경우 이 매개변수는 무시됩니다. 페이지 레이아웃을 계산하는 데 사용됩니다." #: ../../document.rst abcb9a746c2b4f62abeed6ccf8efa17d #: f2545763439a4ee594dbd98ad0edf43e msgid "Raises" msgstr "발생" #: ../../document.rst:194 f470cca528b745c9a90831df3e861ea2 msgid "if the *type* of any parameter does not conform." msgstr "매개변수의 *타입* 이 적합하지 않은 경우." #: ../../document.rst:195 8c21a351ef83465497530b3df321b248 msgid "" "if the file / path cannot be found. Re-implemented as subclass of " "`RuntimeError`." msgstr "파일/경로를 찾을 수 없는 경우. `RuntimeError` 의 하위 클래스로 재구현됨." #: ../../document.rst:196 fffb535dd70c40419e33cb85c3478a56 msgid "" "if the file / path is empty or the `bytes` object in memory has zero " "length. A subclass of `FileDataError` and `RuntimeError`." msgstr "" "파일/경로가 비어 있거나 메모리의 `bytes` 객체 길이가 0인 경우. `FileDataError` 및 `RuntimeError`" " 의 하위 클래스." #: ../../document.rst:197 2da86a34dee74be2bfc325592465ca50 msgid "if an unknown file type is explicitly specified." msgstr "알 수 없는 파일 타입이 명시적으로 지정된 경우." #: ../../document.rst:198 72d5fd6fabfb4775b794aad117955ffd msgid "" "if the document has an invalid structure for the given type -- or is no " "file at all (but e.g. a folder). A subclass of `RuntimeError`." msgstr "문서가 주어진 타입에 대해 유효하지 않은 구조를 가지거나 파일이 아닌 경우(예: 폴더). `RuntimeError` 의 하위 클래스." #: ../../document.rst 0b9565acff23447ebd391dc02025defd #: 0d46c89c1dc84ef7a8b2ce78c73fa2f0 0e133b2b68684e80825b5ffd442964a6 #: 1ebf59777711413282c7b813e486b14d 22e92858f96749bd979c8b1d97f53141 #: 2582886835ba484cbc6362bcd0294110 29b3f69d713b4e2baf28c15d8335d4d0 #: 2daf9297b2b947f59c29603028bdc171 2fbd3af7a9dd47bcb918a2afc3d3d2ae #: 333d2ff36ce5424a9a6a9f0ef315e9f6 38e8965bfa884723862a910e35980260 #: 39f9bc12c5d146b98e014503e81bbeab 43dcb947c54d4e5b813016fcd28911fb #: 444b74f48dd74a199f9add5e1f9af762 46303bbfa9d64c1988fe842589733a4b #: 46c1cf4166714992b0f5a1a1ccb20835 4865908155da41849fdb6be46efbab80 #: 5eedd5ec48ec43009b74aa21cb5a4f5e 675da3dffdee4242ad59c756d3d4ec2d #: 689c89e5a32f43e09e3ea270734096d9 7adeeadfb8a84b9e8790609ba5bc7765 #: 7c3cba7c278941deafdcf00e8c3fc7c8 7ff99ed95e934a59b82878c8068a10f8 #: 81fd28a92da849b894299938c7262571 8f2c0027871d4dbfa63523294209dd4d #: 901880de4b364792adbac5aac0281b3b 903ff8cf00ef42a2af64f374cb0cdec3 #: 912cd9c328854abcac39f0139f5e13da 98a3f5b39c0e4eeb9588b83976f1b954 #: ab8d5df67c824ec08658e756765d4bb5 b1c55529a2d64de8993763d1ef44d0dd #: b31f42a8e4fd414ea57fb4d437cf2e73 c2982953c7264eca9b0074df8d337bce #: c762118fd4d842038a9dff91cd1c85cd c77e00acb46640089980b06ee883d005 #: cc8f358941704f05baab8f5e45775fc8 d3a808fe6600422fbd26e1dc8906851b #: d6d5325a2e7f4d798ffd6326d1c898c2 dc36f475c23841168562540b7aa1b81b #: e12cf9fc8351457dae9235c1d8b88e4a e2b42ca22d734917b9217f6ad6021891 #: eac82d309f514f35a8cd27a08ec37d2a efae7f82f4944c26a45f8b40aac6da5a #: f504824956a7474fa92c3133ca3ba45c fc84c379722e4558b9622025890c4170 msgid "Returns" msgstr "반환값" #: ../../document.rst:200 5379105ad1f54307a38807d4a326c24c msgid "" "A document object. If the document cannot be created, an exception is " "raised in the above sequence. Note that PyMuPDF-specific exceptions, " "`FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted" " if you check for `RuntimeError`. In case of problems you can see more " "detail in the internal messages store: " "`print(pymupdf.TOOLS.mupdf_warnings())` (which will be emptied by this " "call, but you can also prevent this -- consult " ":meth:`Tools.mupdf_warnings`)." msgstr "" #: ../../document.rst:200 2b78b15da31c4933938a15d26f37e5a2 msgid "" "A document object. If the document cannot be created, an exception is " "raised in the above sequence. Note that PyMuPDF-specific exceptions, " "`FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted" " if you check for `RuntimeError`." msgstr "" "문서 객체. 문서를 생성할 수 없으면 위 순서에서 예외가 발생합니다. |PyMuPDF| 전용 예외인 " "`FileNotFoundError`, `EmptyFileError` 및 `FileDataError` 는 `RuntimeError` " "를 확인하면 가로채집니다." #: ../../document.rst:202 5cfeca13702a454fa2a279a1c95212cb msgid "" "In case of problems you can see more detail in the internal messages " "store: `print(pymupdf.TOOLS.mupdf_warnings())` (which will be emptied by " "this call, but you can also prevent this -- consult " ":meth:`Tools.mupdf_warnings`)." msgstr "" "문제가 있는 경우 내부 메시지 저장소에서 더 자세한 내용을 볼 수 있습니다: " "`print(pymupdf.TOOLS.mupdf_warnings())` (이 호출로 비워지지만, 이를 방지할 수도 있습니다. " ":meth:`Tools.mupdf_warnings` 참조)." #: ../../document.rst:204 85a57c6989194e89b1b69856a7d9a394 msgid "Overview of possible forms, note: `open` is a synonym of `Document`::" msgstr "가능한 형식 개요, 참고: `open` 은 `Document` 의 동의어입니다::" #: ../../document.rst:221 3e33d53ee5224879a1ea5e05123c6739 msgid "" "Raster images with a wrong (but supported) file extension **are no " "problem**. MuPDF will determine the correct image type when file " "**content** is actually accessed and will process it without complaint." msgstr "" "잘못된(하지만 지원되는) 파일 확장자를 가진 래스터 이미지는 **문제가 되지 않습니다**. |MuPDF| 는 파일 **콘텐츠** 가" " 실제로 액세스될 때 올바른 이미지 타입을 결정하고 불만 없이 처리합니다." #: ../../document.rst:223 065b06239b8d411e91f31a11cf0b763b msgid "" "The Document class can be also be used as a **context manager**. Exiting " "the content manager will close the document automatically." msgstr "" "Document 클래스는 **context manager** 로도 사용할 수 있습니다. 콘텐츠 관리자를 종료하면 문서가 자동으로 " "닫힙니다." #: ../../document.rst:239 ../../document.rst:249 ../../document.rst:309 #: ../../document.rst:355 590a057c4b6b44d6a0918523f52f6f9d #: 8e6e393f5b684e0bafd4caf83d908e86 b5812f621a6c4e63bf0172b3f1d3cc29 #: fc7e417737a44f688ae8d2191b3b7ab9 msgid "New in v1.18.4" msgstr "v1.18.4에서 새로 추가됨" #: ../../document.rst:241 7e3878780e334136b767b9359746ea53 msgid "" "Return the cross reference number of an :data:`OCG` or :data:`OCMD` " "attached to an image or form xobject." msgstr "이미지 또는 폼 xobject에 첨부된 :data:`OCG` 또는 :data:`OCMD` 의 교차 참조 번호를 반환합니다." #: ../../document.rst:243 02a0e1e835614fec97682f8673d2a44a msgid "" "the :data:`xref` of an image or form xobject. Valid such cross reference " "numbers are returned by :meth:`Document.get_page_images`, resp. " ":meth:`Document.get_page_xobjects`. For invalid numbers, an exception is " "raised." msgstr "" "이미지 또는 폼 xobject의 :data:`xref`. 유효한 교차 참조 번호는 " ":meth:`Document.get_page_images` 또는 :meth:`Document.get_page_xobjects` 에 " "의해 반환됩니다. 유효하지 않은 번호의 경우 예외가 발생합니다." #: ../../document.rst 03106ba1def448ee947cabdaf71b64af #: 0323e07d28b34d3db57c8793633c6693 03fa12cfb70346d0a59357cc2fac0b53 #: 1aba81a7b43b479e8b6c20dfc4b285a7 280115f8654a46c19b9605b53ae5cb25 #: 293f411b7cde49c9bdcfd193dcdcdcc3 311a57ac78794e2e90319718b2abee35 #: 3870aff916b940ebae177370b1d79d02 3b8f4617cb6a4273bc5cc5871f6dd926 #: 3d82dbb2f594402b9a35693796ef923b 42758cfc2b43478abb870a4303f08b46 #: 4cc5ae419ec54d569bbe6924027803f8 5236a41b0be944409e172dc5b2e4bf86 #: 5a9aaff08bd04bca832bcab4af64df9c 69766670b3434e69bcd622dc0dc9e27d #: 7a81d4febe394e368e4f731ec0edcbd3 7ae03a444f9b4584adfedd95fb3e1832 #: 7c50040809f54baea13ac5bf14e7b8b5 81e419072a7040609488c69f1a3ee6a9 #: 8262bfce4d2447748d541f718f81d09f 83054de5a1f24a5e9e84a905db0c8a15 #: a3d3a8ca642c4433beeef23cc55ccc0c ae294c0d81814ae680474407dc878475 #: af12de8b069e4c0f89174e9b7b798f8c b591f61bc81144a3be6c8d4ca224d43c #: bae2e3773fea460a9bec117512d86b4e d1aabcba697f4ccca6722d874ddc4b91 #: d1c59ac972354c3bb0e8960dc03143fc d22157f38e4c482b9f059900ceea860e #: d41d99df291f4539a09e041db9a01693 e8696467db1a43938ae8baf7d06fbe94 #: f079281dd45045a98b9fa58f73453901 f165f1911ae248fe8e958ed35a1c95f3 #: f43b1009cbe1438595747275491e5fb3 fa67f21ad4ba4619b33e9d5e01dd956c #: fb20d7ae8e29407a93c1316afa952e4e msgid "Return type" msgstr "반환 타입" #: ../../document.rst:245 54f83b65a1444382948e30d8b439e254 msgid "" "the cross reference number of an optional contents object or zero if " "there is none." msgstr "선택적 콘텐츠 객체의 교차 참조 번호 또는 없는 경우 0." #: ../../document.rst:251 96b8fa378c624f70997c27f227a1cb0c msgid "" "If :data:`xref` represents an image or form xobject, set or remove the " "cross reference number *ocxref* of an optional contents object." msgstr "" ":data:`xref` 가 이미지 또는 form xobject를 나타내는 경우 선택적 콘텐츠 객체의 교차 참조 번호 *ocxref*" " 를 설정하거나 제거합니다." #: ../../document.rst:253 ccd437bf85874e6796fd6bc48db22b17 msgid "" "the :data:`xref` of an image or form xobject [#f5]_. Valid such cross " "reference numbers are returned by :meth:`Document.get_page_images`, resp." " :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is" " raised." msgstr "" "이미지 또는 form xobject의 :data:`xref` [#f5]_. 유효한 이러한 교차 참조 번호는 " ":meth:`Document.get_page_images`, 각각 :meth:`Document.get_page_xobjects` " "에서 반환됩니다. 잘못된 번호의 경우 예외가 발생합니다." #: ../../document.rst:254 01092297808443f49fec83f07bf7c1b1 msgid "" "the :data:`xref` number of an :data:`OCG` / :data:`OCMD`. If not zero, an" " invalid reference raises an exception. If zero, any OC reference is " "removed." msgstr "" ":data:`OCG` / :data:`OCMD` 의 :data:`xref` 번호. 0이 아니면 유효하지 않은 참조가 예외를 " "발생시킵니다. 0이면 모든 OC 참조가 제거됩니다." #: ../../document.rst:259 ../../document.rst:269 ../../document.rst:280 #: ../../document.rst:292 ../../document.rst:366 ../../document.rst:378 #: ../../document.rst:400 ../../document.rst:418 ../../document.rst:434 #: 0cdb3bd2d31b4b66a2c59a426a908115 11d1e22fc75f4c299aaa32ee9660e732 #: 651472cf224d4e7cb1c4607e35070f52 7b127219d8df4b649a052c0a2b97c25e #: 91ec18953623402d83c21367dfbac24b b1c95139441d4a9cae92305b838dc63e #: b3ab1a356e21428fb3c661c2a380695c ed9937dd5d174b9ea28d6f61bcb82e87 #: fca4c990f25d40c091f29bd4f8738a73 msgid "New in v1.18.3" msgstr "v1.18.3에서 새로 추가됨" #: ../../document.rst:261 e496afcef3664b1f81d450a3619e61af msgid "" "Show optional layer configurations. There always is a standard one, which" " is not included in the response." msgstr "선택적 레이어 구성을 표시합니다. 항상 표준 구성이 있으며, 응답에 포함되지 않습니다." #: ../../document.rst:271 f799d02d101b4380aaaf1c4db1b48eb6 msgid "" "Add an optional content configuration. Layers serve as a collection of ON" " / OFF states for optional content groups and allow fast visibility " "switches between different views on the same document." msgstr "" "선택적 콘텐츠 구성을 추가합니다. 레이어는 선택적 콘텐츠 그룹의 ON/OFF 상태 모음 역할을 하며, 동일한 문서의 다른 보기 간 " "빠른 가시성 전환을 허용합니다." #: ../../document.rst:273 08dc8765d1304fd7b44f572a0744f0f1 msgid "arbitrary name." msgstr "임의의 이름." #: ../../document.rst:274 98d7de11d27e443691ea0949884cd849 msgid "(optional) creating software." msgstr "(선택 사항) 생성 소프트웨어." #: ../../document.rst:275 0d34230a987b46f481e1e00efa0aea08 msgid "" "a sequence of OCG :data:`xref` numbers which should be set to ON when " "this layer gets activated. All OCGs not listed here will be set to OFF." msgstr "" "이 레이어가 활성화될 때 ON으로 설정해야 하는 OCG :data:`xref` 번호 시퀀스. 여기에 나열되지 않은 모든 OCG는 " "OFF로 설정됩니다." #: ../../document.rst:282 bf8e78a200584541a6aa40bfe589b2cb msgid "" "Switch to a document view as defined by the optional layer's " "configuration number. This is temporary, except if established as " "default." msgstr "선택적 레이어의 구성 번호로 정의된 문서 보기로 전환합니다. 기본값으로 설정되지 않은 경우 임시입니다." #: ../../document.rst:284 a5c2d8c7581d4bdc8b1aa451802f594f msgid "config number as returned by :meth:`Document.layer_configs`." msgstr ":meth:`Document.layer_configs` 에서 반환된 구성 번호." #: ../../document.rst:285 1bd81b54cedd49f18769be40480ce85d msgid "make this the default configuration." msgstr "이것을 기본 구성으로 만듭니다." #: ../../document.rst:287 90648b40bc2941c9a74ee11db323a3af msgid "" "Activates the ON / OFF states of OCGs as defined in the identified layer." " If ``as_default=True``, then additionally all layers, including the " "standard one, are merged and the result is written back to the standard " "layer, and **all optional layers are deleted**." msgstr "" "식별된 레이어에 정의된 대로 OCG의 ON/OFF 상태를 활성화합니다. ``as_default=True`` 이면 표준 레이어를 " "포함한 모든 레이어가 병합되고 결과가 표준 레이어에 다시 쓰여지며, **모든 선택적 레이어가 삭제됩니다**." #: ../../document.rst:294 64c365c54c204dc9a79d20e140c88f37 msgid "" "Add an optional content group. An OCG is the most important unit of " "information to determine object visibility. For a PDF, in order to be " "regarded as having optional content, at least one OCG must exist." msgstr "" "선택적 콘텐츠 그룹을 추가합니다. OCG는 객체 가시성을 결정하는 가장 중요한 정보 단위입니다. PDF의 경우 선택적 콘텐츠를 가진" " 것으로 간주되려면 최소한 하나의 OCG가 있어야 합니다." #: ../../document.rst:296 582c5907afae46aa9917cffb6bbc7e9d msgid "arbitrary name. Will show up in supporting PDF viewers." msgstr "임의의 이름. 지원하는 PDF 뷰어에 표시됩니다." #: ../../document.rst:297 f3ea3172645446aab9bd34bdaaa95772 msgid "layer configuration number. Default -1 is the standard configuration." msgstr "레이어 구성 번호. 기본값 -1은 표준 구성입니다." #: ../../document.rst:298 17c0cb89e5074470a202a4250ea9f078 msgid "standard visibility status for objects pointing to this OCG." msgstr "이 OCG를 가리키는 객체의 표준 가시성 상태." #: ../../document.rst:299 c62203a85b33422185c8017d9e36af57 msgid "" "a string or list of strings declaring the visibility intents. There are " "two PDF standard values to choose from: \"View\" and \"Design\". Default " "is \"View\". Correct **spelling is important**." msgstr "" "가시성 의도를 선언하는 문자열 또는 문자열 목록. 선택할 수 있는 두 가지 PDF 표준 값이 있습니다: \"View\" 와 " "\"Design\". 기본값은 \"View\" 입니다. 올바른 **철자가 중요합니다**." #: ../../document.rst:300 700ecf059c634c4296e822ca1f324ace msgid "" "another influencer for OCG visibility. This will become part of the OCG's" " `/Usage` key. There are two PDF standard values to choose from: " "\"Artwork\" and \"Technical\". Default is \"Artwork\". Please only change" " when required." msgstr "" "OCG 가시성에 영향을 미치는 또 다른 요소. 이것은 OCG의 `/Usage` 키의 일부가 됩니다. 선택할 수 있는 두 가지 PDF" " 표준 값이 있습니다: \"Artwork\" 와 \"Technical\". 기본값은 \"Artwork\" 입니다. 필요한 경우에만 " "변경하세요." #: ../../document.rst:302 3145601d35874b718a0c6f74a6a309b8 msgid "" ":data:`xref` of the created OCG. Use as entry for `oc` parameter in " "supporting objects." msgstr "생성된 OCG의 :data:`xref`. 지원 객체의 `oc` 매개변수 항목으로 사용합니다." #: ../../document.rst:304 4b1189a56ca745249bc4b28c2436ca85 msgid "" "Multiple OCGs with identical parameters may be created. This will not " "cause problems. Garbage option 3 of :meth:`Document.save` will get rid of" " any duplicates." msgstr "" "동일한 매개변수를 가진 여러 OCG가 생성될 수 있습니다. 이것은 문제를 일으키지 않습니다. :meth:`Document.save`" " 의 Garbage 옵션 3은 모든 중복을 제거합니다." #: ../../document.rst:311 e5f3f34164f14819912a3b03637210d1 msgid "" "Create or update an :data:`OCMD`, **Optional Content Membership " "Dictionary.**" msgstr ":data:`OCMD`, **Optional Content Membership Dictionary** 를 생성하거나 업데이트합니다." #: ../../document.rst:313 cb1088cf2f894416ae66a48c48f1a083 msgid ":data:`xref` of the OCMD to be updated, or 0 for a new OCMD." msgstr "업데이트할 OCMD의 :data:`xref` 또는 새 OCMD의 경우 0." #: ../../document.rst:314 369dd3e1a5934cd1ac9d74315ec46778 msgid "a sequence of :data:`xref` numbers of existing :data:`OCG` PDF objects." msgstr "기존 :data:`OCG` PDF 객체의 :data:`xref` 번호 시퀀스." #: ../../document.rst:315 bf9b40e2e22c4f97953a165672812856 msgid "" "one of \"AnyOn\" (default), \"AnyOff\", \"AllOn\", \"AllOff\" (mixed or " "lower case)." msgstr "\"AnyOn\" (기본값), \"AnyOff\", \"AllOn\", \"AllOff\" 중 하나(대소문자 혼합 또는 소문자)." #: ../../document.rst:316 88174bf787d4486d91457a1003cc8d34 msgid "" "a \"visibility expression\". This is a list of arbitrarily nested other " "lists -- see explanation below. Use as an alternative to the combination " "*ocgs* / *policy* if you need to formulate more complex conditions." msgstr "" "\"가시성 표현식\". 이것은 임의로 중첩된 다른 목록의 목록입니다. 아래 설명을 참조하세요. 더 복잡한 조건을 공식화해야 하는 " "경우 *ocgs* / *policy* 조합의 대안으로 사용합니다." #: ../../document.rst:318 8928d324f6024b2a9bb8500b1ff504f4 msgid "" ":data:`xref` of the OCMD. Use as `oc=xref` parameter in supporting " "objects, and respectively in :meth:`Document.set_oc` or " ":meth:`Annot.set_oc`." msgstr "" "OCMD의 :data:`xref`. 지원 객체에서 `oc=xref` 매개변수로 사용하고, 각각 " ":meth:`Document.set_oc` 또는 :meth:`Annot.set_oc` 에서 사용합니다." #: ../../document.rst:322 77b7cd5933544b45be8e20f83eec5ec1 msgid "" "Like an OCG, an OCMD has a visibility state ON or OFF, and it can be used" " like an OCG. In contrast to an OCG, the OCMD state is determined by " "evaluating the state of one or more OCGs via special forms of **boolean " "expressions.** If the expression evaluates to true, the OCMD state is ON " "and OFF for false." msgstr "" "OCG와 마찬가지로 OCMD는 ON 또는 OFF 가시성 상태를 가지며 OCG처럼 사용할 수 있습니다. OCG와 달리 OCMD 상태는" " **부울 표현식** 의 특수 형식을 통해 하나 이상의 OCG 상태를 평가하여 결정됩니다. 표현식이 true로 평가되면 OCMD " "상태는 ON이고, false이면 OFF입니다." #: ../../document.rst:324 c5c61ce450e24c5e9ea1fa1bad8b6751 msgid "There are two ways to formulate OCMD visibility:" msgstr "OCMD 가시성을 공식화하는 두 가지 방법이 있습니다:" #: ../../document.rst:326 462d8be9d3a5420cbd8cb048c7eeb28b msgid "" "Use the combination of *ocgs* and *policy*: The *policy* value is " "interpreted as follows:" msgstr "*ocgs* 와 *policy* 조합 사용: *policy* 값은 다음과 같이 해석됩니다:" #: ../../document.rst:328 86b63ed8ef38451ebf96d60ec77bce37 msgid "AnyOn -- (default) true if at least one OCG is ON." msgstr "AnyOn -- (기본값) 최소한 하나의 OCG가 ON이면 true." #: ../../document.rst:329 f3f796350ef742cf9d6068183f6bcc38 msgid "AnyOff -- true if at least one OCG is OFF." msgstr "AnyOff -- 최소한 하나의 OCG가 OFF이면 true." #: ../../document.rst:330 adc9429b7f46427dbfb52493bd1c0204 msgid "AllOn -- true if all OCGs are ON." msgstr "AllOn -- 모든 OCG가 ON이면 true." #: ../../document.rst:331 daa610b72ef4437f8457d46428a9a2b1 msgid "AllOff -- true if all OCGs are OFF." msgstr "AllOff -- 모든 OCG가 OFF이면 true." #: ../../document.rst:333 7014ef73277e45d4a51f02398cfaadd8 msgid "" "Suppose you want two PDF objects be displayed exactly one at a time (if " "one is ON, then the other one must be OFF):" msgstr "두 개의 PDF 객체를 한 번에 정확히 하나씩만 표시하려는 경우(하나가 ON이면 다른 하나는 OFF여야 함):" #: ../../document.rst:335 658089c6f0b9489686f71ec565438854 msgid "" "Solution: use an **OCG** for object 1 and an **OCMD** for object 2. " "Create the OCMD via `set_ocmd(ocgs=[xref], policy=\"AllOff\")`, with the " ":data:`xref` of the OCG." msgstr "" "해결책: 객체 1에 **OCG** 를 사용하고 객체 2에 **OCMD** 를 사용합니다. OCG의 :data:`xref` 로 " "`set_ocmd(ocgs=[xref], policy=\"AllOff\")` 를 통해 OCMD를 생성합니다." #: ../../document.rst:337 82ba080d68bb4981b7587f8bab2460c8 msgid "" "Use the **visibility expression** *ve*: This is a list of two or more " "items. The **first item** is a logical keyword: one of the strings " "**\"and\"**, **\"or\"**, or **\"not\"**. The **second** and all " "subsequent items must either be an integer or another list. An integer " "must be the :data:`xref` number of an OCG. A list must again have at " "least two items starting with one of the boolean keywords. This syntax is" " a bit awkward, but quite powerful:" msgstr "" "**가시성 표현식** *ve* 사용: 이것은 두 개 이상의 항목 목록입니다. **첫 번째 항목** 은 논리 키워드입니다: " "**\"and\"**, **\"or\"**, 또는 **\"not\"** 중 하나. **두 번째** 및 모든 후속 항목은 정수 또는 " "다른 목록이어야 합니다. 정수는 OCG의 :data:`xref` 번호여야 합니다. 목록은 부울 키워드 중 하나로 시작하는 최소 두 " "개의 항목을 다시 가져야 합니다. 이 구문은 약간 어색하지만 매우 강력합니다:" #: ../../document.rst:339 8c43a5aff72040a7a6d28e5bb990e66b msgid "Each list must start with a logical keyword." msgstr "각 목록은 논리 키워드로 시작해야 합니다." #: ../../document.rst:340 19d1f313dc9c49d0a6293fc1ad610021 msgid "" "If the keyword is a **\"not\"**, then the list must have exactly two " "items. If it is **\"and\"** or **\"or\"**, any number of other items may " "follow." msgstr "" "키워드가 **\"not\"** 이면 목록은 정확히 두 개의 항목을 가져야 합니다. **\"and\"** 또는 **\"or\"** " "이면 임의의 수의 다른 항목이 올 수 있습니다." #: ../../document.rst:341 bc4958d9848f4d9eb526b661a0948965 msgid "" "Items following the logical keyword may be either integers or again a " "list. An *integer* must be the xref of an OCG. A *list* must conform to " "the previous rules." msgstr "" "논리 키워드 다음의 항목은 정수이거나 다시 목록일 수 있습니다. *정수* 는 OCG의 xref여야 합니다. *목록* 은 이전 규칙을" " 준수해야 합니다." #: ../../document.rst:343 909440e89ac14b0583e1721a3248b452 msgid "**Examples:**" msgstr "**예제:**" #: ../../document.rst:345 39d40410d7484e3e825de23071befbe8 msgid "" "`set_ocmd(ve=[\"or\", 4, [\"not\", 5], [\"and\", 6, 7]])`. This delivers " "ON if the following is true: **\"4 is ON, or 5 is OFF, or 6 and 7 are " "both ON\"**." msgstr "" "`set_ocmd(ve=[\"or\", 4, [\"not\", 5], [\"and\", 6, 7]])`. 다음이 true이면 ON을" " 제공합니다: **\"4가 ON이거나, 5가 OFF이거나, 6과 7이 모두 ON\"**." #: ../../document.rst:346 97dc40557fcc4158b6cb22c3353018db msgid "" "`set_ocmd(ve=[\"not\", xref])`. This has the same effect as the OCMD " "example created under 1." msgstr "`set_ocmd(ve=[\"not\", xref])`. 이것은 1번에서 생성된 OCMD 예제와 동일한 효과를 가집니다." #: ../../document.rst:348 434eb7de1a77405aa34ed1d2e20e1b02 msgid "" "For more details and examples see page 224 of :ref:`AdobeManual`. Also do" " have a look at example scripts `here `_." msgstr "" "자세한 내용과 예제는 :ref:`AdobeManual` 의 224페이지를 참조하세요. 또한 예제 스크립트 `여기 " "`_ 도 확인하세요." #: ../../document.rst:350 7658995b2a4549639c7ace90d07d93b3 msgid "" "Visibility expressions, `/VE`, are part of PDF specification version 1.6." " So not all PDF viewers / readers may already support this feature and " "hence will react in some standard way for those cases." msgstr "" "가시성 표현식 `/VE` 는 PDF 사양 버전 1.6의 일부입니다. 따라서 모든 PDF 뷰어/리더가 이 기능을 지원하지 않을 수 " "있으며, 따라서 이러한 경우 표준 방식으로 반응할 수 있습니다." #: ../../document.rst:357 dcfcc58d11a2462ba2c2f22a728129bb msgid "Retrieve the definition of an :data:`OCMD`." msgstr ":data:`OCMD` 의 정의를 검색합니다." #: ../../document.rst:359 7d1bff0a19054f2db6c4bd89fe1bcc2b msgid "the :data:`xref` of the OCMD." msgstr "OCMD의 :data:`xref`." #: ../../document.rst:361 10a42b8798f54b0280077c1c0449a55e msgid "a dictionary with the keys :data:`xref`, *ocgs*, *policy* and *ve*." msgstr ":data:`xref`, *ocgs*, *policy* 및 *ve* 키를 가진 딕셔너리." #: ../../document.rst:368 a71256dcfa4a4a33b07ae79e240a88e3 msgid "" "List of optional content groups by status in the specified configuration." " This is a dictionary with lists of cross reference numbers for OCGs that" " occur in the arrays `/ON`, `/OFF` or in some radio button group " "(`/RBGroups`)." msgstr "" "지정된 구성에서 상태별 선택적 콘텐츠 그룹 목록. 이것은 `/ON`, `/OFF` 배열 또는 일부 라디오 버튼 " "그룹(`/RBGroups`)에 나타나는 OCG의 교차 참조 번호 목록을 가진 딕셔너리입니다." #: ../../document.rst:370 e1289b8663ed42c88f7aeabecc6d605e msgid "the configuration layer (default is the standard config layer)." msgstr "구성 레이어(기본값은 표준 구성 레이어)." #: ../../document.rst:380 6f7007b493e44fba98c65146eb69d34c msgid "Changed in v1.22.5: Support list of *locked* OCGs." msgstr "v1.22.5에서 변경됨: *잠긴* OCG 목록 지원." #: ../../document.rst:382 ac89d60a2a5f4b48be8c2261db601aa9 msgid "" "Mass status changes of optional content groups. **Permanently** sets the " "status of OCGs." msgstr "선택적 콘텐츠 그룹의 대량 상태 변경. OCG 상태를 **영구적으로** 설정합니다." #: ../../document.rst:384 468388be95424c0d8a9b49b756008f0d msgid "desired configuration layer, choose -1 for the default one." msgstr "원하는 구성 레이어, 기본값의 경우 -1을 선택합니다." #: ../../document.rst:385 ede15b445e8841da94cafafdeb425744 msgid "" "list of :data:`xref` of OCGs to set ON. Replaces previous values. An " "empty list will cause no OCG being set to ON anymore. Should be specified" " if `basestate=\"ON\"` is used." msgstr "" "ON으로 설정할 OCG의 :data:`xref` 목록. 이전 값을 대체합니다. 빈 목록은 더 이상 OCG가 ON으로 설정되지 않도록" " 합니다. `basestate=\"ON\"` 이 사용되는 경우 지정해야 합니다." #: ../../document.rst:386 8ba93f6ec2554e599cb52b9e35a6871e msgid "" "list of :data:`xref` of OCGs to set OFF. Replaces previous values. An " "empty list will cause no OCG being set to OFF anymore. Should be " "specified if `basestate=\"OFF\"` is used." msgstr "" "OFF로 설정할 OCG의 :data:`xref` 목록. 이전 값을 대체합니다. 빈 목록은 더 이상 OCG가 OFF로 설정되지 않도록" " 합니다. `basestate=\"OFF\"` 가 사용되는 경우 지정해야 합니다." #: ../../document.rst:387 85b511fbc799407395e9ee0a53fd3d75 msgid "" "state of OCGs that are not mentioned in *on* or *off*. Possible values " "are \"ON\", \"OFF\" or \"Unchanged\". Upper / lower case possible." msgstr "" "*on* 또는 *off* 에 언급되지 않은 OCG의 상태. 가능한 값은 \"ON\", \"OFF\" 또는 \"Unchanged\" " "입니다. 대소문자 가능." #: ../../document.rst:388 103c3e8b6c5d4ddea0e0693af1420970 msgid "" "a list of lists. Replaces previous values. Each sublist should contain " "two or more OCG xrefs. OCGs in the same sublist are handled like buttons " "in a radio button group: setting one to ON automatically sets all other " "group members to OFF." msgstr "" "목록의 목록. 이전 값을 대체합니다. 각 하위 목록은 두 개 이상의 OCG xref를 포함해야 합니다. 동일한 하위 목록의 OCG는" " 라디오 버튼 그룹의 버튼처럼 처리됩니다: 하나를 ON으로 설정하면 다른 모든 그룹 구성원이 자동으로 OFF로 설정됩니다." #: ../../document.rst:389 dc1e634515e44d1c9a4d4d3fdd70fcd9 msgid "a list of OCG xref number that cannot be changed by the user interface." msgstr "사용자 인터페이스로 변경할 수 없는 OCG xref 번호 목록." #: ../../document.rst:391 0f646eb8554b43a5b6b2525fb77f6a59 msgid "Values `None` will not change the corresponding PDF array." msgstr "`None` 값은 해당 PDF 배열을 변경하지 않습니다." #: ../../document.rst:402 46f83dd2ff484f27982ec01f17716437 msgid "" "Details of all optional content groups. This is a dictionary of " "dictionaries like this (key is the OCG's :data:`xref`):" msgstr "모든 선택적 콘텐츠 그룹의 세부 정보. 이것은 다음과 같은 딕셔너리의 딕셔너리입니다(키는 OCG의 :data:`xref`):" #: ../../document.rst:420 c417700fcc5b4b1eae4fa6465cba21de msgid "" "Show the visibility status of optional content that is modifiable by the " "user interface of supporting PDF viewers." msgstr "지원하는 PDF 뷰어의 사용자 인터페이스로 수정 가능한 선택적 콘텐츠의 가시성 상태를 표시합니다." #: ../../document.rst:422 4aa5dc6d9637420fbaa9715a0f68a0cc msgid "" "Only reports items contained in the currently selected layer " "configuration." msgstr "현재 선택된 레이어 구성에 포함된 항목만 보고합니다." #: ../../document.rst:429 64cd741b0f154a59882f3ecbad6f6c4d msgid "The meaning of the dictionary keys is as follows:" msgstr "딕셔너리 키의 의미는 다음과 같습니다:" #: ../../document.rst:425 a1d441dff29442abbe52ac442fba4857 msgid "*depth:* item's nesting level in the `/Order` array" msgstr "*depth:* `/Order` 배열에서 항목의 중첩 수준" #: ../../document.rst:426 afed949ed9c94f36b9dc60f092483e05 msgid "*locked:* true if cannot be changed via user interfaces" msgstr "*locked:* 사용자 인터페이스를 통해 변경할 수 없으면 true" #: ../../document.rst:427 710278fb91c2494cbd5c46259e9fe457 msgid "*number:* running sequence number" msgstr "*number:* 실행 시퀀스 번호" #: ../../document.rst:428 a2442736222d45c083eb9cad2e3cf565 msgid "*on:* item state" msgstr "*on:* 항목 상태" #: ../../document.rst:429 92dfbeb754404026afaa90073baff793 msgid "*text:* text string or name field of the originating OCG" msgstr "*text:* 원본 OCG의 텍스트 문자열 또는 이름 필드" #: ../../document.rst:430 c8d971a7af4b492bbd1fbc73337424ad msgid "" "*type:* one of \"label\" (set by a text string), \"checkbox\" (set by a " "single OCG) or \"radiobox\" (set by a set of connected OCGs)" msgstr "" "*type:* \"label\" (텍스트 문자열로 설정), \"checkbox\" (단일 OCG로 설정) 또는 " "\"radiobox\" (연결된 OCG 집합으로 설정) 중 하나" #: ../../document.rst:436 ca0c2b9b2d704bf4926d5541ce17576a msgid "" "Modify OC visibility status of content groups. This is analog to what " "supporting PDF viewers would offer." msgstr "콘텐츠 그룹의 OC 가시성 상태를 수정합니다. 이것은 지원하는 PDF 뷰어가 제공하는 것과 유사합니다." #: ../../document.rst:438 2d3943b22c954c3e9f6217dc93f52b4c msgid "" "Please note that visibility is **not** a property stored with the OCG. It" " is not even information necessarily present in the PDF document at all. " "Instead, the current visibility is **temporarily** set using the user " "interface of some supporting PDF consumer software. The same type of " "functionality is offered by this method." msgstr "" "가시성은 OCG와 함께 저장되는 속성이 **아닙니다**. PDF 문서에 반드시 존재하는 정보도 아닙니다. 대신, 현재 가시성은 일부" " 지원하는 PDF 소비자 소프트웨어의 사용자 인터페이스를 사용하여 **임시로** 설정됩니다. 이 메서드는 동일한 유형의 기능을 " "제공합니다." #: ../../document.rst:440 4360a90c60fa4f3090c35c0af96d1a99 msgid "To make **permanent** changes, use :meth:`Document.set_layer`." msgstr "**영구적인** 변경을 하려면 :meth:`Document.set_layer` 를 사용하세요." #: ../../document.rst:442 29750667f90046a896bd2ed12b182314 msgid "" "either the sequence number of the item in list " ":meth:`Document.layer_configs` or the \"text\" of one of these items." msgstr ":meth:`Document.layer_configs` 목록의 항목 시퀀스 번호 또는 이러한 항목 중 하나의 \"text\"." #: ../../document.rst:443 f398780fe9cd4cb9a46fe8eb8c8591f2 msgid "" "`PDF_OC_ON` = set on (default), `PDF_OC_TOGGLE` = toggle on/off, " "`PDF_OC_OFF` = set off." msgstr "`PDF_OC_ON` = 켜기(기본값), `PDF_OC_TOGGLE` = 켜기/끄기 전환, `PDF_OC_OFF` = 끄기." #: ../../document.rst:448 bac35af4cb58496282e3f36f790b2d94 msgid "" "Decrypts the document with the string *password*. If successful, document" " data can be accessed. For PDF documents, the \"owner\" and the \"user\" " "have different privileges, and hence different passwords may exist for " "these authorization levels. The method will automatically establish the " "appropriate (owner or user) access rights for the provided password." msgstr "" "문자열 *password* 로 문서를 복호화합니다. 성공하면 문서 데이터에 액세스할 수 있습니다. PDF 문서의 경우 " "\"owner\" 와 \"user\" 는 다른 권한을 가지므로 이러한 권한 수준에 대해 다른 비밀번호가 존재할 수 있습니다. 이 " "메서드는 제공된 비밀번호에 대해 적절한(owner 또는 user) 액세스 권한을 자동으로 설정합니다." #: ../../document.rst:450 d19b070d8c8c4e07bb85b92d121abe18 msgid "owner or user password." msgstr "owner 또는 user 비밀번호." #: ../../document.rst:453 09c81228f6f144ec9e2812177c48be57 msgid "" "a positive value if successful, zero otherwise (the string does not match" " either password). If positive, the indicator " ":attr:`Document.is_encrypted` is set to ``False``. **Positive** return " "codes carry the following information detail: * 1 => authenticated, but " "the PDF has neither owner nor user passwords. * 2 => authenticated with " "the **user** password. * 4 => authenticated with the **owner** password. " "* 6 => authenticated and both passwords are equal -- probably a rare " "situation. .. note:: The document may be protected by an owner, but " "**not** by a user password. Detect this situation via " "`doc.authenticate(\"\") == 2`. This allows opening and reading the " "document without authentication, but, depending on the " ":attr:`Document.permissions` value, other actions may be prohibited. " "PyMuPDF (like MuPDF) in this case **ignores those restrictions**. So, -- " "in contrast to any PDF viewers -- you can for example extract text and " "add or modify content, even if the respective permission flags " "`PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`, etc. are set " "off! It is your responsibility building a legally compliant application " "where applicable." msgstr "" #: ../../document.rst:453 a27a648e6c744e1c9f93f1717c0ce5e4 msgid "" "a positive value if successful, zero otherwise (the string does not match" " either password). If positive, the indicator " ":attr:`Document.is_encrypted` is set to ``False``. **Positive** return " "codes carry the following information detail:" msgstr "" "성공하면 양수 값, 그렇지 않으면 0(문자열이 두 비밀번호와 일치하지 않음). 양수이면 표시기 " ":attr:`Document.is_encrypted` 가 ``False`` 로 설정됩니다. **양수** 반환 코드는 다음 정보 세부" " 사항을 포함합니다:" #: ../../document.rst:455 ad0771c151124449b3a89661edd657dd msgid "1 => authenticated, but the PDF has neither owner nor user passwords." msgstr "1 => 인증되었지만 PDF에 owner 또는 user 비밀번호가 없습니다." #: ../../document.rst:456 45d3470658684c13b95b87cc78f20822 msgid "2 => authenticated with the **user** password." msgstr "2 => **user** 비밀번호로 인증되었습니다." #: ../../document.rst:457 3d1ac17d43984900a8e2fa5e25f7faa0 msgid "4 => authenticated with the **owner** password." msgstr "4 => **owner** 비밀번호로 인증되었습니다." #: ../../document.rst:458 971a66bb85bc4ab486ae62db4d6615f7 msgid "" "6 => authenticated and both passwords are equal -- probably a rare " "situation." msgstr "6 => 인증되었고 두 비밀번호가 동일합니다. 아마도 드문 상황입니다." #: ../../document.rst:462 b2a20378b0b5427a8d960f26e7b1ecdf msgid "" "The document may be protected by an owner, but **not** by a user " "password. Detect this situation via `doc.authenticate(\"\") == 2`. This " "allows opening and reading the document without authentication, but, " "depending on the :attr:`Document.permissions` value, other actions may be" " prohibited. PyMuPDF (like MuPDF) in this case **ignores those " "restrictions**. So, -- in contrast to any PDF viewers -- you can for " "example extract text and add or modify content, even if the respective " "permission flags `PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`," " etc. are set off! It is your responsibility building a legally compliant" " application where applicable." msgstr "" "문서는 owner로 보호될 수 있지만 user 비밀번호로는 보호되지 **않을** 수 있습니다. " "`doc.authenticate(\"\") == 2` 를 통해 이 상황을 감지합니다. 이것은 인증 없이 문서를 열고 읽을 수 있게 " "하지만, :attr:`Document.permissions` 값에 따라 다른 작업이 금지될 수 있습니다. |PyMuPDF| " "(|MuPDF| 와 마찬가지로) 이 경우 **이러한 제한을 무시합니다**. 따라서 -- 모든 PDF 뷰어와 달리 -- 예를 들어 " "해당 권한 플래그 `PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE` 등이 꺼져 " "있어도 텍스트를 추출하고 콘텐츠를 추가하거나 수정할 수 있습니다! 해당되는 경우 법적으로 준수하는 애플리케이션을 구축하는 것은 " "귀하의 책임입니다." #: ../../document.rst:466 f77a2af6763a4e99aa429f7e98659d79 msgid "New in v 1.18.6" msgstr "v 1.18.6에서 새로 추가됨" #: ../../document.rst:468 f4bbff5e7ed442339312ec3c0ef8a04b msgid "" "PDF only: Return a list of page numbers that have the specified label -- " "note that labels may not be unique in a PDF. This implies a sequential " "search through **all page numbers** to compare their labels." msgstr "" "PDF 전용: 지정된 레이블을 가진 페이지 번호 목록을 반환합니다. 레이블이 PDF에서 고유하지 않을 수 있습니다. 이것은 레이블을" " 비교하기 위해 **모든 페이지 번호** 를 순차적으로 검색하는 것을 의미합니다." #: ../../document.rst:470 284419aaa5c14aaf9838d76305b7e6fd msgid "Implementation detail -- pages are **not loaded** for this purpose." msgstr "구현 세부 사항 -- 이 목적을 위해 페이지는 **로드되지 않습니다**." #: ../../document.rst:472 1fa71ee28df5429f91ab5ed8669e52f8 msgid "the label to look for, e.g. \"vii\" (Roman number 7)." msgstr "찾을 레이블, 예: \"vii\" (로마 숫자 7)." #: ../../document.rst:473 cf505e7ed7bd4f6d90bd2804a9b59277 msgid "" "stop after first hit. Useful e.g. if labelling is known to be unique, or " "there are many pages, etc. The default will check every page number." msgstr "" "첫 번째 일치 후 중지. 레이블링이 고유한 것으로 알려져 있거나 페이지가 많은 경우 등에 유용합니다. 기본값은 모든 페이지 번호를 " "확인합니다." #: ../../document.rst:475 7fcfbfc46bea4a529ec9a179bf248165 msgid "" "list of page numbers that have this label. Empty if none found, no labels" " defined, etc." msgstr "이 레이블을 가진 페이지 번호 목록. 찾을 수 없거나 레이블이 정의되지 않은 경우 비어 있습니다." #: ../../document.rst:480 ../../document.rst:843 ../../document.rst:864 #: ../../document.rst:1897 ../../document.rst:1921 #: 0e9d135c2c694491862abf575442c967 544935bd7d614c9db589293891fdce0f #: 74efba34b38140e980ef5f9591e33759 b1ba150b171340d88337555ba1cd0b2b #: ee0ffb51d237488e9b8a23feb27a244c msgid "New in v1.18.7" msgstr "v1.18.7에서 새로 추가됨" #: ../../document.rst:482 d49573b0569d48a1aa0c91946c9138d9 msgid "" "PDF only: Extract the list of page label definitions. Typically used for " "modifications before feeding it into :meth:`Document.set_page_labels`." msgstr "" "PDF 전용: 페이지 레이블 정의 목록을 추출합니다. 일반적으로 :meth:`Document.set_page_labels` 에 " "전달하기 전에 수정하는 데 사용됩니다." #: ../../document.rst:484 831722188ad841a9947ddd4ed8b6cc3b msgid "a list of dictionaries as defined in :meth:`Document.set_page_labels`." msgstr ":meth:`Document.set_page_labels` 에 정의된 대로 딕셔너리 목록." #: ../../document.rst:488 1ba6ad21168d4d6eb7121d531daa9fe5 msgid "New in v1.18.6" msgstr "v1.18.6에서 새로 추가됨" #: ../../document.rst:490 9a57871c71864eaa8c4df22898b6c3ba msgid "PDF only: Add or update the page label definitions of the PDF." msgstr "PDF 전용: PDF의 페이지 레이블 정의를 추가하거나 업데이트합니다." #: ../../document.rst:492 8023f294ed3e465abd9879124efa0c93 #, python-brace-format msgid "" "a list of dictionaries. Each dictionary defines a label building rule and" " a 0-based \"start\" page number. That start page is the first for which " "the label definition is valid. Each dictionary has up to 4 items and " "looks like `{'startpage': int, 'prefix': str, 'style': str, " "'firstpagenum': int}` and has the following items. - `startpage`: (int) " "the first page number (0-based) to apply the label rule. This key **must " "be present**. The rule is applied to all subsequent pages until either " "end of document or superseded by the rule with the next larger page " "number. - `prefix`: (str) an arbitrary string to start the label with, " "e.g. \"A-\". Default is \"\". - `style`: (str) the numbering style. " "Available are \"D\" (decimal), \"r\"/\"R\" (Roman numbers, lower / upper " "case), and \"a\"/\"A\" (lower / upper case alphabetical numbering: \"a\" " "through \"z\", then \"aa\" through \"zz\", etc.). Default is \"\". If " "\"\", no numbering will take place and the pages in that range will " "receive the same label consisting of the `prefix` value. If prefix is " "also omitted, then the label will be \"\". - `firstpagenum`: (int) start " "numbering with this value. Default is 1, smaller values are ignored." msgstr "" #: ../../document.rst:492 f0236618e0804858971c55deab0fe7fe #, python-brace-format msgid "" "a list of dictionaries. Each dictionary defines a label building rule and" " a 0-based \"start\" page number. That start page is the first for which " "the label definition is valid. Each dictionary has up to 4 items and " "looks like `{'startpage': int, 'prefix': str, 'style': str, " "'firstpagenum': int}` and has the following items." msgstr "" "딕셔너리 목록. 각 딕셔너리는 레이블 빌딩 규칙과 0 기반 \"시작\" 페이지 번호를 정의합니다. 해당 시작 페이지는 레이블 정의가" " 유효한 첫 번째 페이지입니다. 각 딕셔너리는 최대 4개의 항목을 가지며 `{'startpage': int, 'prefix': " "str, 'style': str, 'firstpagenum': int}` 와 같이 보이며 다음 항목을 가집니다." #: ../../document.rst:494 7ada331695bb454facb941b2016338ac msgid "" "`startpage`: (int) the first page number (0-based) to apply the label " "rule. This key **must be present**. The rule is applied to all subsequent" " pages until either end of document or superseded by the rule with the " "next larger page number." msgstr "" "`startpage`: (int) 레이블 규칙을 적용할 첫 번째 페이지 번호(0 기반). 이 키는 **반드시 있어야 합니다**. " "규칙은 문서 끝까지 또는 다음 더 큰 페이지 번호를 가진 규칙으로 대체될 때까지 모든 후속 페이지에 적용됩니다." #: ../../document.rst:495 17d1a6d64dc0414d868aaa9ab7317f23 msgid "" "`prefix`: (str) an arbitrary string to start the label with, e.g. \"A-\"." " Default is \"\"." msgstr "`prefix`: (str) 레이블을 시작하는 임의의 문자열, 예: \"A-\". 기본값은 \"\" 입니다." #: ../../document.rst:496 912d2eb8b5b24751a0f30b902fd6b532 msgid "" "`style`: (str) the numbering style. Available are \"D\" (decimal), " "\"r\"/\"R\" (Roman numbers, lower / upper case), and \"a\"/\"A\" (lower /" " upper case alphabetical numbering: \"a\" through \"z\", then \"aa\" " "through \"zz\", etc.). Default is \"\". If \"\", no numbering will take " "place and the pages in that range will receive the same label consisting " "of the `prefix` value. If prefix is also omitted, then the label will be " "\"\"." msgstr "" "`style`: (str) 번호 매기기 스타일. 사용 가능한 것은 \"D\" (십진수), \"r\"/\"R\" (로마 숫자, " "소문자/대문자), \"a\"/\"A\" (소문자/대문자 알파벳 번호 매기기: \"a\" 부터 \"z\" 까지, 그 다음 \"aa\"" " 부터 \"zz\" 까지 등). 기본값은 \"\" 입니다. \"\" 이면 번호 매기기가 수행되지 않고 해당 범위의 페이지는 " "`prefix` 값으로 구성된 동일한 레이블을 받습니다. prefix도 생략되면 레이블은 \"\" 가 됩니다." #: ../../document.rst:497 63acf88f059441f2bc4e4af1e8d8650a msgid "" "`firstpagenum`: (int) start numbering with this value. Default is 1, " "smaller values are ignored." msgstr "`firstpagenum`: (int) 이 값으로 번호 매기기를 시작합니다. 기본값은 1이며, 더 작은 값은 무시됩니다." #: ../../document.rst:499 384ec1a67413470785f411317701132b msgid "For example::" msgstr "예를 들어::" #: ../../document.rst:504 b8301b8cf19d4e02ac8a0bcd0352c92d msgid "" "will generate the labels \"A-10\", \"A-11\", \"A-12\", \"A-13\", \"1\", " "\"2\", \"3\", ... for pages 6, 7 and so on until end of document. Pages 0" " through 5 will have the label \"\"." msgstr "" "페이지 6, 7 등 문서 끝까지 \"A-10\", \"A-11\", \"A-12\", \"A-13\", \"1\", \"2\", " "\"3\", ... 레이블을 생성합니다. 페이지 0부터 5까지는 레이블이 \"\" 입니다." #: ../../document.rst:509 ../../document.rst:523 #: a2b10c378f7a4169a34c80b25fd3b781 dd39cd38852c4114b99d2bd5eb73b6e2 msgid "New in v.1.17.3" msgstr "v.1.17.3에서 새로 추가됨" #: ../../document.rst:511 6f3e58f86d23447789f879a032a3c941 msgid "" "Return a page pointer in a reflowable document. After re-layouting the " "document, the result of this method can be used to find the new location " "of the page." msgstr "" "재배치 가능한 문서에서 페이지 포인터를 반환합니다. 문서를 다시 레이아웃한 후 이 메서드의 결과를 사용하여 페이지의 새 위치를 찾을" " 수 있습니다." #: ../../document.rst:513 9c43c3c696e44b848e88cb43517118b7 msgid "Do not confuse with items of a table of contents, TOC." msgstr "목차(TOC) 항목과 혼동하지 마세요." #: ../../document.rst:515 cd56f6afe2b64b0c85a5cc6be4cfed1d msgid "page location. Must be a valid *(chapter, pno)*." msgstr "페이지 location. 유효한 *(chapter, pno)* 여야 합니다." #: ../../document.rst:518 de63fa23b9dd457da0f6793091194ee8 msgid "" "a long integer in pointer format. To be used for finding the new location" " of the page after re-layouting the document. Do not touch or re-assign." msgstr "포인터 형식의 긴 정수. 문서를 다시 레이아웃한 후 페이지의 새 위치를 찾는 데 사용됩니다. 건드리거나 재할당하지 마세요." #: ../../document.rst:525 913919f58489450c8f242d2cd3216182 msgid "Return the new page location after re-layouting the document." msgstr "문서를 다시 레이아웃한 후 새 페이지 location을 반환합니다." #: ../../document.rst:527 f2193906ae744c47ba74f5923e5f39ea msgid "created by :meth:`Document.make_bookmark`." msgstr ":meth:`Document.make_bookmark` 에 의해 생성됨." #: ../../document.rst:530 6464a8ee1ffd421286788623fe35387a msgid "the new (chapter, pno) of the page." msgstr "페이지의 새 (chapter, pno)." #: ../../document.rst:535 ../../document.rst:547 ../../document.rst:558 #: 2c2b3d20cfd34f43884f9e342fe74972 432814f8916748ba9f235825511c6890 #: d0dfb3092bfb48daad9187dcf8ab30b1 msgid "New in v.1.17.0" msgstr "v.1.17.0에서 새로 추가됨" #: ../../document.rst:537 c0e2a2bf75c542f1a01355c1c674e527 msgid "Return the number of pages of a chapter." msgstr "장의 페이지 수를 반환합니다." #: ../../document.rst:539 022a532a4be94cd9a0a10cdead619a0e msgid "the 0-based chapter number." msgstr "0 기반 장 번호." #: ../../document.rst:542 9be187716918410591450efaf38f2b01 msgid "" "number of pages in chapter. Relevant only for document types with chapter" " support (EPUB currently)." msgstr "장의 페이지 수. 장 지원이 있는 문서 타입(현재 EPUB)에만 관련됩니다." #: ../../document.rst:549 e533b993f4aa4e748f7fc650a74d28e6 msgid "Return the location of the following page." msgstr "다음 페이지의 location을 반환합니다." #: ../../document.rst:551 ../../document.rst:562 #: 2f8ffb9193c540f49c32191e72b9ae2f 7c0ea3575def40a0841b17016db6f227 msgid "" "the current page id. This must be a tuple *(chapter, pno)* identifying an" " existing page." msgstr "현재 페이지 id. 이것은 기존 페이지를 식별하는 튜플 *(chapter, pno)* 여야 합니다." #: ../../document.rst:553 32dbdc16dbeb4e8c99445020925a3e38 msgid "" "The tuple of the following page, i.e. either *(chapter, pno + 1)* or " "*(chapter + 1, 0)*, **or** the empty tuple *()* if the argument was the " "last page. Relevant only for document types with chapter support (EPUB " "currently)." msgstr "" "다음 페이지의 튜플, 즉 *(chapter, pno + 1)* 또는 *(chapter + 1, 0)*, **또는** 인수가 마지막 " "페이지인 경우 빈 튜플 *()*. 장 지원이 있는 문서 타입(현재 EPUB)에만 관련됩니다." #: ../../document.rst:560 7dae3e783cc443a0a88110bdc72a0cf6 msgid "Return the locator of the preceding page." msgstr "이전 페이지의 위치 지정자를 반환합니다." #: ../../document.rst:564 cb600a2817c449e79741984189d126d4 msgid "" "The tuple of the preceding page, i.e. either *(chapter, pno - 1)* or the " "last page of the preceding chapter, **or** the empty tuple *()* if the " "argument was the first page. Relevant only for document types with " "chapter support (EPUB currently)." msgstr "" "이전 페이지의 튜플, 즉 *(chapter, pno - 1)* 또는 이전 장의 마지막 페이지, **또는** 인수가 첫 번째 페이지인" " 경우 빈 튜플 *()*. 장 지원이 있는 문서 타입(현재 EPUB)에만 관련됩니다." #: ../../document.rst:569 7a0fdbda67e34d958f9dbcb0292e9116 msgid "" "Changed in v1.17.0: For document types supporting a so-called \"chapter " "structure\" (like EPUB), pages can also be loaded via the combination of " "chapter number and relative page number, instead of the absolute page " "number. This should **significantly speed up access** for large " "documents." msgstr "" "v1.17.0에서 변경됨: 소위 \"장 구조\" (EPUB 등)를 지원하는 문서 타입의 경우, 절대 페이지 번호 대신 장 번호와 " "상대 페이지 번호의 조합을 통해 페이지를 로드할 수도 있습니다. 이것은 큰 문서에 대해 **액세스를 크게 향상시켜야** 합니다." #: ../../document.rst:571 b2e8b49a32a4477f86470bc9ed51f929 msgid "" "Create a :ref:`Page` object for further processing (like rendering, text " "searching, etc.)." msgstr "추가 처리(렌더링, 텍스트 검색 등)를 위한 :ref:`Page` 객체를 생성합니다." #: ../../document.rst:573 89dd1233c4cf421f9ff21d9beee9b294 msgid "" "*(Changed in v1.17.0)* Either a 0-based page number, or a tuple " "*(chapter, pno)*. For an **integer**, any `-∞ < page_id < page_count` is " "acceptable. While page_id is negative, :attr:`page_count` will be added " "to it. For example: to load the last page, you can use " "*doc.load_page(-1)*. After this you have page.number = doc.page_count - " "1. For a tuple, *chapter* must be in range " ":attr:`Document.chapter_count`, and *pno* must be in range " ":meth:`Document.chapter_page_count` of that chapter. Both values are " "0-based. Using this notation, :attr:`Page.number` will equal the given " "tuple. Relevant only for document types with chapter support (EPUB " "currently)." msgstr "" #: ../../document.rst:573 e282ccf1b1c343d89ec35cf61d5591b9 msgid "*(Changed in v1.17.0)*" msgstr "*(v1.17.0에서 변경됨)*" #: ../../document.rst:575 9777eceecadf454084f47700b9be0cb6 msgid "" "Either a 0-based page number, or a tuple *(chapter, pno)*. For an " "**integer**, any `-∞ < page_id < page_count` is acceptable. While page_id" " is negative, :attr:`page_count` will be added to it. For example: to " "load the last page, you can use *doc.load_page(-1)*. After this you have " "page.number = doc.page_count - 1." msgstr "" "0 기반 페이지 번호 또는 튜플 *(chapter, pno)*. **정수** 의 경우 `-∞ < page_id < " "page_count` 가 허용됩니다. page_id가 음수이면 :attr:`page_count` 가 추가됩니다. 예를 들어: 마지막" " 페이지를 로드하려면 *doc.load_page(-1)* 를 사용할 수 있습니다. 그 후 page.number = " "doc.page_count - 1 입니다." #: ../../document.rst:577 74810654696e4baf8bcbdc8c746cc775 msgid "" "For a tuple, *chapter* must be in range :attr:`Document.chapter_count`, " "and *pno* must be in range :meth:`Document.chapter_page_count` of that " "chapter. Both values are 0-based. Using this notation, " ":attr:`Page.number` will equal the given tuple. Relevant only for " "document types with chapter support (EPUB currently)." msgstr "" "튜플의 경우 *chapter* 는 :attr:`Document.chapter_count` 범위에 있어야 하고, *pno* 는 해당 " "장의 :meth:`Document.chapter_page_count` 범위에 있어야 합니다. 두 값 모두 0 기반입니다. 이 " "표기법을 사용하면 :attr:`Page.number` 가 주어진 튜플과 같습니다. 장 지원이 있는 문서 타입(현재 EPUB)에만 " "관련됩니다." #: ../../document.rst:579 ../../document.rst:683 ../../document.rst:1452 #: 650ab56d4df54dd8aec8fe0a7592a3bc d3df878a5b5247f1913be4deb5b6649c #: f14fc92ab834466f8549257c73ebb9ff msgid ":ref:`Page`" msgstr ":ref:`Page`" #: ../../document.rst:583 59d5cb9d27a84699bf71d6a5f487a61b msgid "" "Documents also follow the Python sequence protocol with page numbers as " "indices: *doc.load_page(n) == doc[n]*." msgstr "문서는 페이지 번호를 인덱스로 사용하는 Python 시퀀스 프로토콜도 따릅니다: *doc.load_page(n) == doc[n]*." #: ../../document.rst:585 e1b05eec25bd4808ad4d6219711d4017 msgid "" "For **absolute page numbers** only, expressions like *\"for page in doc: " "...\"* and *\"for page in reversed(doc): ...\"* will successively yield " "the document's pages. Refer to :meth:`Document.pages` which allows " "processing pages as with slicing." msgstr "" "**절대 페이지 번호** 에만 해당하는 경우, *\"for page in doc: ...\"* 및 *\"for page in " "reversed(doc): ...\"* 와 같은 표현식이 문서의 페이지를 순차적으로 생성합니다. 슬라이싱과 같이 페이지를 처리할 수" " 있는 :meth:`Document.pages` 를 참조하세요." #: ../../document.rst:587 a88f8092ff8f4819a3dbc62a28c6bf8f msgid "" "You can also use index notation with the new chapter-based page " "identification: use *page = doc[(5, 2)]* to load the third page of the " "sixth chapter." msgstr "" "새로운 장 기반 페이지 식별과 함께 인덱스 표기법을 사용할 수도 있습니다: *page = doc[(5, 2)]* 를 사용하여 여섯 " "번째 장의 세 번째 페이지를 로드합니다." #: ../../document.rst:589 4664a59b1d8a4c12bcb11bb1222159e2 msgid "" "To maintain a consistent API, for document types not supporting a chapter" " structure (like PDFs), :attr:`Document.chapter_count` is 1, and pages " "can also be loaded via tuples *(0, pno)*. See this [#f3]_ footnote for " "comments on performance improvements." msgstr "" "일관된 API를 유지하기 위해 장 구조를 지원하지 않는 문서 타입(예: PDF)의 경우 " ":attr:`Document.chapter_count` 는 1이며, 튜플 *(0, pno)* 를 통해 페이지를 로드할 수도 " "있습니다. 성능 개선에 대한 설명은 이 [#f3]_ 각주를 참조하세요." #: ../../document.rst:594 98c022087ffe4895a4720631007c2d24 msgid "" "PDF only: Walk through all images and rewrite them according to the " "specified parameters. This is useful for reducing file size, changing " "image formats, or converting color spaces." msgstr "" "PDF 전용: 모든 이미지를 순회하고 지정된 매개변수에 따라 다시 작성합니다. 파일 크기 줄이기, 이미지 형식 변경 또는 색상 공간" " 변환에 유용합니다." #: ../../document.rst:596 b2634076489d41739029ea4fc04d66fb msgid "" "The typical usage is extra compression of images for significantly " "reducing the file size of the PDF. When setting quality and the dpi " "parameters to positive values and accepting defaults for the rest, the " "following will happen:" msgstr "" "일반적인 사용법은 PDF 파일 크기를 크게 줄이기 위한 이미지의 추가 압축입니다. quality 및 dpi 매개변수를 양수 값으로 " "설정하고 나머지는 기본값을 사용하면 다음이 발생합니다:" #: ../../document.rst:598 dd54469242944d74a52b379438f6cfc5 msgid "" "Lossy and lossless images will be rewritten as JPEG images " "(FZ_RECOMPRESS_JPEG) as far as technically possible." msgstr "손실 및 무손실 이미지는 기술적으로 가능한 한 JPEG 이미지(FZ_RECOMPRESS_JPEG)로 다시 작성됩니다." #: ../../document.rst:600 3fd86e19b8184fcea5b0e19beceb7d0e msgid "" "Bitonal (monochrome) images will be rewritten in FAX format " "(FZ_RECOMPRESS_FAX)." msgstr "이진(단색) 이미지는 FAX 형식(FZ_RECOMPRESS_FAX)으로 다시 작성됩니다." #: ../../document.rst:602 41c0341ee203444eb721a4bfefa8be54 msgid "Subsampling method is **FZ_SUBSAMPLE_AVERAGE** (see below)." msgstr "서브샘플링 방법은 **FZ_SUBSAMPLE_AVERAGE** 입니다(아래 참조)." #: ../../document.rst:604 896371b0945e44788072f44b80bdc859 msgid "" "target DPI value for the resampled images. Ignored if `dpi_threshold` is " "`None`, otherwise must be less than `dpi_threshold` and positive." msgstr "" "리샘플링된 이미지의 대상 DPI 값. `dpi_threshold` 가 `None` 이면 무시되고, 그렇지 않으면 " "`dpi_threshold` 보다 작고 양수여야 합니다." #: ../../document.rst:606 82cca5a2875740f78ab1af43a1df9670 msgid "" "If None (the default) no resampling takes place. Otherwise images with a " "DPI value larger than this will be resampled to `dpi_target` (which must " "be less than `dpi_threshold`)." msgstr "" "None(기본값)이면 리샘플링이 수행되지 않습니다. 그렇지 않으면 이보다 큰 DPI 값을 가진 이미지가 `dpi_target` " "(이것은 `dpi_threshold` 보다 작아야 함)로 리샘플링됩니다." #: ../../document.rst:608 04ad6d72eb9f455dbc3c3035cd070094 msgid "" "desired target JPEG quality, a value between 0 and 100. 0 means no " "quality change, 100 means best quality." msgstr "원하는 대상 JPEG 품질, 0과 100 사이의 값. 0은 품질 변경 없음, 100은 최고 품질을 의미합니다." #: ../../document.rst:610 8f1a2bc154a04ed6a7358524fa961968 msgid "include lossy image types (e.g. JPEG)." msgstr "손실 이미지 타입 포함(예: JPEG)." #: ../../document.rst:612 da7e5cc3e2a14e5fa0ac5bd81550eafe msgid "include lossless image types (e.g. PNG)." msgstr "무손실 이미지 타입 포함(예: PNG)." #: ../../document.rst:614 e7d1e36e44204076baa7694b46d1124e msgid "include black-and-white images (e.g. FAX)." msgstr "흑백 이미지 포함(예: FAX)." #: ../../document.rst:616 2fa81fe258354e9f8dd69f3d1c236a06 msgid "include colored images." msgstr "컬러 이미지 포함." #: ../../document.rst:618 609b31a2a0e643b0877791e7c36e8099 msgid "include grayscale images." msgstr "그레이스케일 이미지 포함." #: ../../document.rst:620 ba3be6437eaf4297a72fb3988952b40a msgid "" "if True, the PDF will be converted to grayscale by executing " ":meth:`Document.recolor` before all image processing. Please note that " "this will also change text and vector graphics to grayscale -- not just " "the images." msgstr "" "True이면 모든 이미지 처리 전에 :meth:`Document.recolor` 를 실행하여 PDF가 그레이스케일로 변환됩니다. " "이것은 이미지뿐만 아니라 텍스트와 벡터 그래픽도 그레이스케일로 변경합니다." #: ../../document.rst:622 3273b321899f43edad29c647ab92b4e0 msgid "" "This parameter is intended for expert users. Except ``set_to_gray``, all " "other parameters are ignored. It must be an object prepared in the " "following way: ``options = pymupdf.mupdf.PdfImageRewriterOptions()``. " "Then attributes of this object can be set to achieve fine-grained " "control. Following are the adjustable attributes of the ``options`` " "object and their default (do nothing) values." msgstr "" "이 매개변수는 전문 사용자를 위한 것입니다. ``set_to_gray`` 를 제외하고 다른 모든 매개변수는 무시됩니다. 다음 " "방법으로 준비된 객체여야 합니다: ``options = pymupdf.mupdf.PdfImageRewriterOptions()``." " 그런 다음 이 객체의 속성을 설정하여 세밀한 제어를 달성할 수 있습니다. 다음은 ``options`` 객체의 조정 가능한 속성과 " "기본값(아무 작업도 하지 않음)입니다." #: ../../document.rst:652 d66b892761bc466a984fd57fd3e38eb2 msgid "" "The ``*_recompress_method`` attributes may be one of the values " "**FZ_RECOMPRESS_NEVER (0), FZ_RECOMPRESS_SAME (1), FZ_RECOMPRESS_LOSSLESS" " (2), FZ_RECOMPRESS_JPEG (3), FZ_RECOMPRESS_J2K (4), FZ_RECOMPRESS_FAX " "(5)**. Value FZ_RECOMPRESS_NEVER will skip this image type altogether and" " FZ_RECOMPRESS_SAME will not change the type. The other values will " "execute type conversions (as far as technically possible)." msgstr "" "``*_recompress_method`` 속성은 **FZ_RECOMPRESS_NEVER (0), FZ_RECOMPRESS_SAME" " (1), FZ_RECOMPRESS_LOSSLESS (2), FZ_RECOMPRESS_JPEG (3), " "FZ_RECOMPRESS_J2K (4), FZ_RECOMPRESS_FAX (5)** 중 하나일 수 있습니다. 값 " "FZ_RECOMPRESS_NEVER는 이 이미지 타입을 완전히 건너뛰고 FZ_RECOMPRESS_SAME는 타입을 변경하지 " "않습니다. 다른 값은 타입 변환을 실행합니다(기술적으로 가능한 한)." #: ../../document.rst:654 f6ec6ec93320485ebaff083bc3a12743 msgid "" "The ``*_quality`` values are strings of integers from \"0\" to \"100\" or" " ``None``." msgstr "``*_quality`` 값은 \"0\" 부터 \"100\" 까지의 정수 문자열 또는 ``None`` 입니다." #: ../../document.rst:656 73c97c37daf445bb8faa816d1e6c2ba6 msgid "" "The ``*_subsample_method`` attributes are either **FZ_SUBSAMPLE_AVERAGE " "(0)** or **FZ_SUBSAMPLE_BICUBIC (1)** and refer to how a pixel value is " "derived from its neighboring pixels during subsampling. For some " "background see `this Wikipedia article about bicubic interpolation " "`_." msgstr "" "``*_subsample_method`` 속성은 **FZ_SUBSAMPLE_AVERAGE (0)** 또는 " "**FZ_SUBSAMPLE_BICUBIC (1)** 이며, 서브샘플링 중 픽셀 값이 인접 픽셀에서 파생되는 방식을 나타냅니다. 배경" " 정보는 `이 Wikipedia 기사 about bicubic interpolation " "`_ 를 참조하세요." #: ../../document.rst:658 3b1ef034e55b417cbc149276289a674f msgid "" "Attributes ``*_subsample_threshold`` excludes images from subsampling " "which have a lower DPI. Participating images will be subsampled to the " "DPI values given by the ``*_subsample_to`` values. Values of 0 mean that " "no subsampling will take place." msgstr "" "속성 ``*_subsample_threshold`` 는 더 낮은 DPI를 가진 이미지를 서브샘플링에서 제외합니다. 참여하는 이미지는" " ``*_subsample_to`` 값으로 주어진 DPI 값으로 서브샘플링됩니다. 0 값은 서브샘플링이 수행되지 않음을 의미합니다." #: ../../document.rst:660 0d8fc34344494f938fe10a322d66c539 msgid "" "The ``*_subsample_threshold`` values should be chosen notably larger than" " the ``*_subsample_to`` values to ensure that there are enough size " "savings. After all, every subsampling inevitably incurs quality losses." msgstr "" "``*_subsample_threshold`` 값은 충분한 크기 절감을 보장하기 위해 ``*_subsample_to`` 값보다 " "상당히 크게 선택해야 합니다. 결국 모든 서브샘플링은 불가피하게 품질 손실을 초래합니다." #: ../../document.rst:662 79510e56339f460e9782beef46bd250d msgid "An example for a good choice is ``threshold=100`` and ``to=72``." msgstr "좋은 선택의 예는 ``threshold=100`` 및 ``to=72`` 입니다." #: ../../document.rst:667 773a1b450cb1473aa93e0cf41357de02 msgid "" "PDF only: Change the color component counts for all object types text, " "images and vector graphics for all pages." msgstr "PDF 전용: 모든 페이지의 모든 객체 타입 텍스트, 이미지 및 벡터 그래픽의 색상 구성 요소 수를 변경합니다." #: ../../document.rst:669 3d7d6e5b619c4faba15d3ba29b0e5c9b msgid "" "desired color space indicated by the number of color components: 1 = " "DeviceGRAY, 3 = DeviceRGB, 4 = DeviceCMYK." msgstr "색상 구성 요소 수로 표시되는 원하는 색상 공간: 1 = DeviceGRAY, 3 = DeviceRGB, 4 = DeviceCMYK." #: ../../document.rst:671 231bbb29ae294db0a5c6b91cedb5bc93 msgid "" "The typical use case is 1 (DeviceGRAY) which converts the PDF to " "grayscale." msgstr "일반적인 사용 사례는 PDF를 그레이스케일로 변환하는 1 (DeviceGRAY) 입니다." #: ../../document.rst:676 25493f351a06440fb51cb6d332c4e8ab msgid "New in v1.16.10" msgstr "v1.16.10에서 새로 추가됨" #: ../../document.rst:678 a43f270497744fba8c4c60e674ced034 msgid "" "PDF only: Provide a new copy of a page after finishing and updating all " "pending changes." msgstr "PDF 전용: 모든 보류 중인 변경 사항을 완료하고 업데이트한 후 페이지의 새 복사본을 제공합니다." #: ../../document.rst:680 eed0d5bbb0e34e5a98d5d7d1347f7563 msgid "page object." msgstr "페이지 객체." #: ../../document.rst:685 5859498b41324ff2904041f7a4135acf msgid "" "a new copy of the same page. All pending updates (e.g. to annotations or " "widgets) will be finalized and a fresh copy of the page will be loaded. " ".. note:: In a typical use case, a page :ref:`Pixmap` should be taken " "after annotations / widgets have been added or changed. To force all " "those changes being reflected in the page structure, this method re-" "instates a fresh copy while keeping the object hierarchy \"document -> " "page -> annotations/widgets\" intact." msgstr "" #: ../../document.rst:685 669719b216f545c294672354612d11fa msgid "" "a new copy of the same page. All pending updates (e.g. to annotations or " "widgets) will be finalized and a fresh copy of the page will be loaded." msgstr "동일한 페이지의 새 복사본. 모든 보류 중인 업데이트(예: 주석 또는 위젯)가 완료되고 페이지의 새 복사본이 로드됩니다." #: ../../document.rst:687 c3492c9a84d2493fa5a46a354f97ebb6 msgid "" "In a typical use case, a page :ref:`Pixmap` should be taken after " "annotations / widgets have been added or changed. To force all those " "changes being reflected in the page structure, this method re-instates a " "fresh copy while keeping the object hierarchy \"document -> page -> " "annotations/widgets\" intact." msgstr "" "일반적인 사용 사례에서 페이지 :ref:`Pixmap` 은 주석/위젯이 추가되거나 변경된 후에 가져와야 합니다. 모든 변경 사항이 " "페이지 구조에 반영되도록 하려면 이 메서드는 객체 계층 구조 \"document -> page -> annotations/widgets\" " "를 그대로 유지하면서 새 복사본을 다시 설정합니다." #: ../../document.rst:692 b7bb34b4f16946e28a2d3112f022c456 msgid "PDF only: Convert destination names into a Python dict." msgstr "PDF 전용: 대상 이름을 Python dict로 변환합니다." #: ../../document.rst:694 2d5cec850cd44110ab3c2074136bd4ce #, python-brace-format msgid "" "A dictionary with the following layout: * *key*: (str) the name. * " "*value*: (dict) with the following layout: * \"page\": target page " "number (0-based). If no page number found -1. * \"to\": (x, y) target" " point on page. Currently in PDF coordinates, i.e. point (0,0) is " "the bottom-left of the page. * \"zoom\": (float) the zoom factor." " * \"dest\": (str) only present if the target location on the page " "has not been provided as \"/XYZ\" or if no page number was found. " "Examples:: { '__bookmark_1': {'page': 0, 'to': (0.0, 541.0)," " 'zoom': 0.0}, '__bookmark_2': {'page': 0, 'to': (0.0, 481.45), " "'zoom': 0.0}, } or:: { " "'21154a7c20684ceb91f9c9adc3b677c40': {'page': -1, 'dest': '/XYZ 15.75 " "1486 0'}, ... }" msgstr "" #: ../../document.rst:695 4a7ee4c9ba2a4d3a85f45e05d21d7585 msgid "A dictionary with the following layout:" msgstr "다음 레이아웃을 가진 딕셔너리:" #: ../../document.rst:697 c5edbf04328248a4b31185f38a0a9e88 msgid "*key*: (str) the name." msgstr "*key*: (str) 이름." #: ../../document.rst:703 ce2e9cdb367e4116a485b2e37d0c68a9 msgid "*value*: (dict) with the following layout:" msgstr "*value*: (dict) 다음 레이아웃을 가진:" #: ../../document.rst:699 36f39015e34140bf9600dc4e0a7dd82a msgid "\"page\": target page number (0-based). If no page number found -1." msgstr "\"page\": 대상 페이지 번호(0 기반). 페이지 번호를 찾을 수 없으면 -1." #: ../../document.rst:700 1febb4d93dd3459a9e791eb0783deebb msgid "" "\"to\": (x, y) target point on page. Currently in PDF coordinates, i.e. " "point (0,0) is the bottom-left of the page." msgstr "\"to\": (x, y) 페이지의 대상 점. 현재 PDF 좌표계를 사용하며, 즉 점 (0,0)은 페이지의 왼쪽 아래입니다." #: ../../document.rst:702 73ea9e5382d746798763ab0603096cbb msgid "\"zoom\": (float) the zoom factor." msgstr "\"zoom\": (float) 확대/축소 인수." #: ../../document.rst:703 1238fa32b21742a79624b48be42151f8 msgid "" "\"dest\": (str) only present if the target location on the page has not " "been provided as \"/XYZ\" or if no page number was found." msgstr "\"dest\": (str) 페이지의 대상 위치가 \"/XYZ\" 로 제공되지 않았거나 페이지 번호를 찾을 수 없는 경우에만 존재합니다." #: ../../document.rst:705 425fb4334a644c2db4c6eb473e93a78e msgid "Examples::" msgstr "예제::" #: ../../document.rst:712 a20f62157adf4795a39385d09af8fd54 msgid "or::" msgstr "또는::" #: ../../document.rst:719 7a833515e8cd42c897ce8167af8a9b8f msgid "" "All names found in the catalog under keys \"/Dests\" and \"/Names/Dests\"" " are included." msgstr "카탈로그의 \"/Dests\" 및 \"/Names/Dests\" 키 아래에서 찾은 모든 이름이 포함됩니다." #: ../../document.rst:722 3a95051f6b30463e8c0e2ea68b6cc48f msgid "New in v1.23.6" msgstr "v1.23.6에서 새로 추가됨" #: ../../document.rst:727 ../../document.rst:737 ../../document.rst:1166 #: ../../document.rst:1176 ../../document.rst:1188 #: 318e00602e594f4dbd1ab58104d6d6e6 8ce28861dec241f992672b27eed544d9 #: cc7d97f955c543a69b42fb763c14b07f ccd76c30264f49b0b6bc13b131a26967 #: d835c71b1d154bb2be4c1c8efc97af43 msgid "New in v1.17.7" msgstr "v1.17.7에서 새로 추가됨" #: ../../document.rst:729 1b80bd2d1f5a41419012ecb261a6db97 msgid "" "PDF only: Return the unrotated page rectangle -- **without loading the " "page** (via :meth:`Document.load_page`). This is meant for internal " "purpose requiring best possible performance." msgstr "PDF 전용: 회전되지 않은 페이지 사각형을 반환합니다 -- **페이지를 로드하지 않고** (:meth:`Document.load_page` 를 통해). 최상의 성능이 필요한 내부 목적을 위한 것입니다." #: ../../document.rst:731 ../../document.rst:741 #: 19f19a11c82e4a50907e74763e0e965d 8c2c15d72ebf4a9990d269ea811b7348 msgid "0-based page number." msgstr "0-기반 페이지 번호." #: ../../document.rst:733 a2e9807b52784408a6d2c65afb8f36de msgid ":ref:`Rect` of the page like :meth:`Page.rect`, but ignoring any rotation." msgstr ":meth:`Page.rect` 와 같은 페이지의 :ref:`Rect` 이지만 회전은 무시합니다." #: ../../document.rst:739 2d213ca7d8494aa7b9c8fd1b4e3d4dfd msgid "" "PDF only: Return the :data:`xref` of the page -- **without loading the " "page** (via :meth:`Document.load_page`). This is meant for internal " "purpose requiring best possible performance." msgstr "PDF 전용: 페이지의 :data:`xref` 를 반환합니다 -- **페이지를 로드하지 않고** (:meth:`Document.load_page` 를 통해). 최상의 성능이 필요한 내부 목적을 위한 것입니다." #: ../../document.rst:743 da21a126d6f04c3abec953dfcc2675ad msgid ":data:`xref` of the page like :attr:`Page.xref`." msgstr ":attr:`Page.xref` 와 같은 페이지의 :data:`xref`." #: ../../document.rst:747 71d4791dad1f4445aa3e3040d731738f msgid "New in v1.16.4" msgstr "v1.16.4에서 새로 추가됨" #: ../../document.rst:749 b38a2716dd8c424d91d72f843b002a17 msgid "" "A generator for a range of pages. Parameters have the same meaning as in " "the built-in function *range()*. Intended for expressions of the form " "*\"for page in doc.pages(start, stop, step): ...\"*." msgstr "페이지 범위에 대한 생성자. 매개변수는 내장 함수 *range()* 와 동일한 의미를 가집니다. *\"for page in doc.pages(start, stop, step): ...\"* 형식의 표현식을 위한 것입니다." #: ../../document.rst:751 616de960867c4972a74ce8066c419f0d msgid "" "start iteration with this page number. Default is zero, allowed values " "are `-∞ < start < page_count`. While this is negative, :attr:`page_count`" " is added **before** starting the iteration." msgstr "이 페이지 번호로 반복을 시작합니다. 기본값은 0이며, 허용되는 값은 `-∞ < start < page_count` 입니다. 이 값이 음수인 동안 반복을 시작하기 **전에** :attr:`page_count` 가 추가됩니다." #: ../../document.rst:752 ecb933c801174ce48e94a1c20e8f0c8f msgid "" "stop iteration at this page number. Default is :attr:`page_count`, " "possible are `-∞ < stop <= page_count`. Larger values are **silently " "replaced** by the default. Negative values will cyclically emit the pages" " in reversed order. As with the built-in *range()*, this is the first " "page **not** returned." msgstr "이 페이지 번호에서 반복을 중지합니다. 기본값은 :attr:`page_count` 이며, 가능한 값은 `-∞ < stop <= page_count` 입니다. 더 큰 값은 기본값으로 **조용히 대체됩니다**. 음수 값은 역순으로 페이지를 순환적으로 생성합니다. 내장 *range()* 와 마찬가지로 이것은 **반환되지 않는** 첫 번째 페이지입니다." #: ../../document.rst:753 b9ce7f24cc314a7384140aaf41765dcd msgid "" "stepping value. Defaults are 1 if start < stop and -1 if start > stop. " "Zero is not allowed." msgstr "스텝 값. start < stop 이면 기본값은 1이고 start > stop 이면 -1입니다. 0은 허용되지 않습니다." #: ../../document.rst:755 c8272a49a7154ff28e5cd556509e8b79 msgid "" "a generator iterator over the document's pages. Some examples: * " "\"doc.pages()\" emits all pages. * \"doc.pages(4, 9, 2)\" emits pages 4, " "6, 8. * \"doc.pages(0, None, 2)\" emits all pages with even numbers. * " "\"doc.pages(-2)\" emits the last two pages. * \"doc.pages(-1, -1)\" emits" " all pages in reversed order. * \"doc.pages(-1, -10)\" always emits 10 " "pages in reversed order, starting with the last page -- **repeatedly** if" " the document has less than 10 pages. So for a 4-page document the " "following page numbers are emitted: 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, " "3." msgstr "" #: ../../document.rst:755 a4556cefb645478780d73c0fd90ce03a msgid "a generator iterator over the document's pages. Some examples:" msgstr "문서의 페이지에 대한 생성기 반복자. 몇 가지 예:" #: ../../document.rst:757 2d87cebad989408c8cbfc49674333423 msgid "\"doc.pages()\" emits all pages." msgstr "\"doc.pages()\" 는 모든 페이지를 생성합니다." #: ../../document.rst:758 0747620460554d40a76ff69a1f360515 msgid "\"doc.pages(4, 9, 2)\" emits pages 4, 6, 8." msgstr "\"doc.pages(4, 9, 2)\" 는 페이지 4, 6, 8을 생성합니다." #: ../../document.rst:759 71c55125fd7148589cf44fedef60ce3f msgid "\"doc.pages(0, None, 2)\" emits all pages with even numbers." msgstr "\"doc.pages(0, None, 2)\" 는 짝수 번호의 모든 페이지를 생성합니다." #: ../../document.rst:760 6b7d4859a5b94056a9dbfb03cf0c8b85 msgid "\"doc.pages(-2)\" emits the last two pages." msgstr "\"doc.pages(-2)\" 는 마지막 두 페이지를 생성합니다." #: ../../document.rst:761 be1f9733ac2c48febc92b6717fb90069 msgid "\"doc.pages(-1, -1)\" emits all pages in reversed order." msgstr "\"doc.pages(-1, -1)\" 는 모든 페이지를 역순으로 생성합니다." #: ../../document.rst:762 6841397d69e848799ce8762dc39001cd msgid "" "\"doc.pages(-1, -10)\" always emits 10 pages in reversed order, starting " "with the last page -- **repeatedly** if the document has less than 10 " "pages. So for a 4-page document the following page numbers are emitted: " "3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, 3." msgstr "" "\"doc.pages(-1, -10)\" 는 항상 마지막 페이지부터 시작하여 역순으로 10페이지를 생성합니다. 문서가 10페이지 " "미만이면 **반복적으로** 생성합니다. 따라서 4페이지 문서의 경우 다음 페이지 번호가 생성됩니다: 3, 2, 1, 0, 3, 2," " 1, 0, 3, 2, 1, 0, 3." #: ../../document.rst:771 5454d912c78644678b8b4dbeb3f774d8 msgid "" "Create a PDF version of the current document and write it to memory. " "**All document types** are supported. The parameters have the same " "meaning as in :meth:`insert_pdf`. In essence, you can restrict the " "conversion to a page subset, specify page rotation, and revert page " "sequence." msgstr "" "현재 문서의 PDF 버전을 생성하고 메모리에 씁니다. **모든 문서 타입** 이 지원됩니다. 매개변수는 " ":meth:`insert_pdf` 와 동일한 의미를 가집니다. 본질적으로 페이지 하위 집합으로 변환을 제한하고, 페이지 회전을 " "지정하고, 페이지 순서를 되돌릴 수 있습니다." #: ../../document.rst:773 d0862bd7eb5f45f68b39be608d7ceacc msgid "first page to copy (0-based). Default is first page." msgstr "복사할 첫 번째 페이지(0 기반). 기본값은 첫 번째 페이지입니다." #: ../../document.rst:775 7ba7a5e06cbc4055830d3f4e5ba74e33 msgid "last page to copy (0-based). Default is last page." msgstr "복사할 마지막 페이지(0 기반). 기본값은 마지막 페이지입니다." #: ../../document.rst:777 32ffc71c0b044be388ae0365845a51f5 msgid "" "rotation angle. Default is 0 (no rotation). Should be *n * 90* with an " "integer n (not checked)." msgstr "회전 각도. 기본값은 0(회전 없음). 정수 n(확인되지 않음)을 사용한 *n * 90* 이어야 합니다." #: ../../document.rst:780 858d98a578db4243937c2a20d50596c3 msgid "" "a Python *bytes* object containing a PDF file image. It is created by " "internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`." " You can output it directly to disk or open it as a PDF. Here are some " "examples:: >>> # convert an XPS file to PDF >>> xps = " "pymupdf.open(\"some.xps\") >>> pdfbytes = xps.convert_to_pdf() >>> >>> # " "either do this --> >>> pdf = pymupdf.open(\"pdf\", pdfbytes) >>> " "pdf.save(\"some.pdf\") >>> >>> # or this --> >>> pdfout = " "open(\"some.pdf\", \"wb\") >>> pdfout.tobytes(pdfbytes) >>> " "pdfout.close() >>> # copy image files to PDF pages >>> # each page will " "have image dimensions >>> doc = pymupdf.open() # new " "PDF >>> imglist = [ ... image file names ...] # e.g. a directory listing " ">>> for img in imglist: imgdoc=pymupdf.open(img) # open" " image as a document pdfbytes=imgdoc.convert_to_pdf() # make a " "1-page PDF of it imgpdf=pymupdf.open(\"pdf\", pdfbytes) " "doc.insert_pdf(imgpdf) # insert the image PDF >>> " "doc.save(\"allmyimages.pdf\")" msgstr "" #: ../../document.rst:780 63c567b2ee504806a11908cc7eda7ddf msgid "" "a Python *bytes* object containing a PDF file image. It is created by " "internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`." " You can output it directly to disk or open it as a PDF. Here are some " "examples::" msgstr "" "PDF 파일 이미지를 포함하는 Python *bytes* 객체. 내부적으로 `tobytes(garbage=4, " "deflate=True)` 를 사용하여 생성됩니다. :meth:`tobytes` 를 참조하세요. 디스크에 직접 출력하거나 PDF로 " "열 수 있습니다. 다음은 몇 가지 예제입니다::" #: ../../document.rst:806 f9ec8d426ea1403cb128eaa26c17445f msgid "" "The method uses the same logic as the *mutool convert* CLI. This works " "very well in most cases -- however, beware of the following limitations." msgstr "" "이 메서드는 *mutool convert* CLI와 동일한 로직을 사용합니다. 대부분의 경우 매우 잘 작동하지만, 다음 제한 사항에" " 주의하세요." #: ../../document.rst:808 25ee83c2d7134eb2a5c23c62615918c2 msgid "" "Image files: perfect, no issues detected. However, image transparency is " "ignored. If you need that (like for a watermark), use " ":meth:`Page.insert_image` instead. Otherwise, this method is recommended " "for its much better performance." msgstr "" "이미지 파일: 완벽하며 문제가 감지되지 않았습니다. 그러나 이미지 투명도는 무시됩니다. 그것이 필요한 경우(워터마크 등) 대신 " ":meth:`Page.insert_image` 를 사용하세요. 그렇지 않으면 훨씬 더 나은 성능을 위해 이 메서드를 권장합니다." #: ../../document.rst:809 bd071d7930ef49e88ecd48466915e7e4 msgid "" "XPS: appearance very good. Links work fine, outlines (bookmarks) are " "lost, but can easily be recovered [#f2]_." msgstr "XPS: 외관이 매우 좋습니다. 링크는 잘 작동하며, 개요(북마크)는 손실되지만 쉽게 복구할 수 있습니다 [#f2]_." #: ../../document.rst:810 0ce6d56bf96d4f8d9273e7511323fd86 msgid "EPUB, CBZ, FB2: similar to XPS." msgstr "EPUB, CBZ, FB2: XPS와 유사합니다." #: ../../document.rst:811 ca4df8faae724b099cfc58f6b2e0ba4f msgid "" "SVG: medium. Roughly comparable to `svglib " "`_." msgstr "SVG: 중간. `svglib `_ 와 대략 비슷합니다." #: ../../document.rst:815 6058dd01aad748969b0759f8d71fdf49 msgid "Creates a table of contents (TOC) out of the document's outline chain." msgstr "문서의 개요 체인에서 목차(TOC)를 생성합니다." #: ../../document.rst:817 3dbca0c298624898acbaf9e5f771ee53 msgid "" "Indicates whether a simple or a detailed TOC is required. If ``False``, " "each item of the list also contains a dictionary with :ref:`linkDest` " "details for each outline entry." msgstr "" "간단한 TOC 또는 상세한 TOC가 필요한지 나타냅니다. ``False`` 이면 목록의 각 항목에는 각 개요 항목에 대한 " ":ref:`linkDest` 세부 정보를 가진 딕셔너리도 포함됩니다." #: ../../document.rst:821 e90635c4d41840b49b24c4cedd58a56f msgid "" "a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its " "entries have the following meanings: * *lvl* -- hierarchy level " "(positive *int*). The first entry is always 1. Entries in a row are " "either **equal**, **increase** by 1, or **decrease** by any number. * " "*title* -- title (*str*) * *page* -- 1-based source page number (*int*). " "`-1` if no destination or outside document. * *dest* -- (*dict*) included" " only if *simple=False*. Contains details of the TOC item as follows: " "- kind: destination kind, see :ref:`linkDest Kinds`. - file: filename " "if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`. - page: target " "page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only. - to: " "position on target page (:ref:`Point`). - zoom: (float) zoom factor on " "target page. - xref: :data:`xref` of the item (0 if no PDF). - color:" " item color in PDF RGB format `(red, green, blue)`, or omitted (always " "omitted if no PDF). - bold: true if bold item text or omitted. PDF " "only. - italic: true if italic item text, or omitted. PDF only. - " "collapse: true if sub-items are folded, or omitted. PDF only. - " "nameddest: target name if kind=4. PDF only. (New in 1.23.7.)" msgstr "" #: ../../document.rst:821 1f916acfd2114c589944f42fe0849446 msgid "" "a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its " "entries have the following meanings:" msgstr "리스트의 리스트. 각 항목은 *[lvl, title, page, dest]* 형식을 가집니다. 항목의 의미는 다음과 같습니다:" #: ../../document.rst:823 7b36d87b6635435eafda08d85d16b1c8 msgid "" "*lvl* -- hierarchy level (positive *int*). The first entry is always 1. " "Entries in a row are either **equal**, **increase** by 1, or **decrease**" " by any number." msgstr "" "*lvl* -- 계층 수준(양수 *int*). 첫 번째 항목은 항상 1입니다. 연속된 항목은 **같거나**, 1씩 **증가** " "하거나, 임의의 수만큼 **감소** 합니다." #: ../../document.rst:824 762b7e29dfec42879ab3702e5193f03c msgid "*title* -- title (*str*)" msgstr "*title* -- 제목 (*str*)" #: ../../document.rst:825 508de47267724444b36c28eb365184e6 msgid "" "*page* -- 1-based source page number (*int*). `-1` if no destination or " "outside document." msgstr "*page* -- 1 기반 소스 페이지 번호 (*int*). 대상이 없거나 문서 외부인 경우 `-1`." #: ../../document.rst:826 5db26a9f7f3a4086ab52e489302c3e8b msgid "" "*dest* -- (*dict*) included only if *simple=False*. Contains details of " "the TOC item as follows:" msgstr "" "*dest* -- (*dict*) *simple=False* 인 경우에만 포함됩니다. TOC 항목의 세부 정보를 다음과 같이 " "포함합니다:" #: ../../document.rst:828 c6e92e67375d43cfae44581cd7f23c8f msgid "kind: destination kind, see :ref:`linkDest Kinds`." msgstr "kind: 대상 종류, :ref:`linkDest Kinds` 를 참조하세요." #: ../../document.rst:829 710dde73a6d7419e945fcb5b21e077d5 msgid "file: filename if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." msgstr "file: kind가 :data:`LINK_GOTOR` 또는 :data:`LINK_LAUNCH` 인 경우 파일 이름." #: ../../document.rst:830 a8bac0a6ac9c43eba24ad53403fc47fa msgid "page: target page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only." msgstr "page: 대상 페이지, 0 기반, :data:`LINK_GOTOR` 또는 :data:`LINK_GOTO` 전용." #: ../../document.rst:831 e9dc7affea7043e08fb2ab93ce8487c3 msgid "to: position on target page (:ref:`Point`)." msgstr "to: 대상 페이지의 위치 (:ref:`Point`)." #: ../../document.rst:832 16c6f209da8c4387a905b11d0f262c91 msgid "zoom: (float) zoom factor on target page." msgstr "zoom: (float) 대상 페이지의 확대/축소 배율." #: ../../document.rst:833 5b0b0da881014748befd8c9fbe86784b msgid "xref: :data:`xref` of the item (0 if no PDF)." msgstr "xref: 항목의 :data:`xref` (PDF가 없으면 0)." #: ../../document.rst:834 ea44c30a773848e4ae4dfc0449224998 msgid "" "color: item color in PDF RGB format `(red, green, blue)`, or omitted " "(always omitted if no PDF)." msgstr "color: PDF RGB 형식 `(red, green, blue)` 의 항목 색상, 또는 생략됨(PDF가 없으면 항상 생략됨)." #: ../../document.rst:835 be0c1730211040fb87559842cb3f7d82 msgid "bold: true if bold item text or omitted. PDF only." msgstr "bold: 굵은 항목 텍스트이면 true 또는 생략됨. PDF 전용." #: ../../document.rst:836 4db8cc6aef9c4e93b5370e0c0703d72b msgid "italic: true if italic item text, or omitted. PDF only." msgstr "italic: 기울임꼴 항목 텍스트이면 true 또는 생략됨. PDF 전용." #: ../../document.rst:837 dbdf470bbd3343aaa06aa7c92bdfa72b msgid "collapse: true if sub-items are folded, or omitted. PDF only." msgstr "collapse: 하위 항목이 접혀 있으면 true 또는 생략됨. PDF 전용." #: ../../document.rst:838 bfc462d0fb2e4bd19071f89ef50d7abe msgid "nameddest: target name if kind=4. PDF only. (New in 1.23.7.)" msgstr "nameddest: kind=4인 경우 대상 이름. PDF 전용. (1.23.7에서 새로 추가됨.)" #: ../../document.rst:845 c3fc69ce58de4a378d986b0b8c8b03e3 msgid "" "PDF only: Return the PDF dictionary keys of the :data:`dictionary` object" " provided by its xref number." msgstr "PDF 전용: xref 번호로 제공된 :data:`dictionary` 객체의 PDF 딕셔너리 키를 반환합니다." #: ../../document.rst:847 e05f361902db4a438e95f2d0b6813501 msgid "" "the :data:`xref`. *(Changed in v1.18.10)* Use `-1` to access the special " "dictionary \"PDF trailer\"." msgstr "" ":data:`xref`. *(v1.18.10에서 변경됨)* 특수 딕셔너리 \"PDF trailer\" 에 액세스하려면 `-1` 을 " "사용하세요." #: ../../document.rst:849 718fc9b6f9ea4799ad613e5ee06da903 msgid "" "a tuple of dictionary keys present in object :data:`xref`. Examples: >>>" " from pprint import pprint >>> import pymupdf >>> " "doc=pymupdf.open(\"pymupdf.pdf\") >>> xref = doc.page_xref(0) # xref of " "page 0 >>> pprint(doc.xref_get_keys(xref)) # primary level keys of a " "page ('Type', 'Contents', 'Resources', 'MediaBox', 'Parent') >>> " "pprint(doc.xref_get_keys(-1)) # primary level keys of the trailer " "('Type', 'Index', 'Size', 'W', 'Root', 'Info', 'ID', 'Length', 'Filter') " ">>>" msgstr "" #: ../../document.rst:849 aa7dc5420dc345bf862b4a857d55b1c9 msgid "a tuple of dictionary keys present in object :data:`xref`. Examples:" msgstr "객체 :data:`xref` 에 있는 딕셔너리 키의 튜플. 예:" #: ../../document.rst:866 ac624cc28bac472580675edd1acf4436 msgid "" "PDF only: Return type and value of a PDF dictionary key of a " ":data:`dictionary` object given by its xref." msgstr "PDF 전용: xref로 제공된 :data:`dictionary` 객체의 PDF 딕셔너리 키의 타입과 값을 반환합니다." #: ../../document.rst:868 27544f0e3f84480f9d4ad7fc8619aa5b msgid "" "the :data:`xref`. *Changed in v1.18.10:* Use `-1` to access the special " "dictionary \"PDF trailer\"." msgstr "" ":data:`xref`. *v1.18.10에서 변경됨:* 특수 딕셔너리 \"PDF trailer\" 에 액세스하려면 `-1` 을 " "사용하세요." #: ../../document.rst:870 b7b4f4ca5ca84d3f9d6241f19925be5a msgid "" "the desired PDF key. Must **exactly** match (case-sensitive) one of the " "keys contained in :meth:`Document.xref_get_keys`." msgstr "" "원하는 PDF 키. :meth:`Document.xref_get_keys` 에 포함된 키 중 하나와 **정확히** 일치해야 " "합니다(대소문자 구분)." #: ../../document.rst:874 7b79f18cd28e46c78897483bebddf81d msgid "" "A tuple (type, value) of strings, where type is one of \"xref\", " "\"array\", \"dict\", \"int\", \"float\", \"null\", \"bool\", \"name\", " "\"string\" or \"unknown\" (should not occur). Independent of \"type\", " "the value of the key is **always** formatted as a string -- see the " "following example -- and (almost always) a faithful reflection of what is" " stored in the PDF. In most cases, the format of the value string also " "gives a clue about the key type:" msgstr "" "문자열의 튜플 (type, value), 여기서 type은 \"xref\", \"array\", \"dict\", \"int\", " "\"float\", \"null\", \"bool\", \"name\", \"string\" 또는 \"unknown\" (발생하지 " "않아야 함) 중 하나입니다. \"type\" 과 무관하게 키의 값은 **항상** 문자열로 포맷됩니다. 다음 예를 참조하세요. 그리고" " (거의 항상) PDF에 저장된 내용의 충실한 반영입니다. 대부분의 경우 값 문자열의 형식은 키 타입에 대한 힌트도 제공합니다:" #: ../../document.rst:876 ec807984aaac414b99a33ab68d3799b1 msgid "A \"name\" always starts with a \"/\" slash." msgstr "\"name\" 은 항상 \"/\" 슬래시로 시작합니다." #: ../../document.rst:877 3d6c9be670f643d0962169a4a9e69bba msgid "An \"xref\" always ends with \" 0 R\"." msgstr "\"xref\" 는 항상 \" 0 R\" 로 끝납니다." #: ../../document.rst:878 cc26f6231b5d40ea99da42fb5fbd6e4e msgid "An \"array\" is always enclosed in \"[...]\" brackets." msgstr "\"array\" 는 항상 \"[...]\" 대괄호로 둘러싸여 있습니다." #: ../../document.rst:879 0e703bc78dfa46ef980a0afffddb7caf msgid "A \"dict\" is always enclosed in \"<<...>>\" brackets." msgstr "\"dict\" 는 항상 \"<<...>>\" 괄호로 둘러싸여 있습니다." #: ../../document.rst:880 846a9dca0e6c44aa99e0254bdf2882a7 msgid "" "A \"bool\", resp. \"null\" always equal either \"true\", \"false\", resp." " \"null\"." msgstr "\"bool\" 또는 \"null\" 은 항상 \"true\", \"false\" 또는 \"null\" 과 같습니다." #: ../../document.rst:881 214cdbec5d6c4d08a8ec85d70a82023d msgid "" "\"float\" and \"int\" are represented by their string format -- and are " "thus not always distinguishable." msgstr "\"float\" 와 \"int\" 는 문자열 형식으로 표현되므로 항상 구별할 수 있는 것은 아닙니다." #: ../../document.rst:882 6b54a834dd684348a075258dcc77932e msgid "" "A \"string\" is converted to UTF-8 and may therefore deviate from what is" " stored in the PDF. For example, the PDF key \"Author\" may have a value " "of \"\" in the " "file, but the method will return `('string', 'Jorj X. McKie')`." msgstr "" "\"string\" 은 UTF-8로 변환되므로 PDF에 저장된 내용과 다를 수 있습니다. 예를 들어, PDF 키 \"Author\"" " 는 파일에서 \"\" 값을" " 가질 수 있지만, 이 메서드는 `('string', 'Jorj X. McKie')` 를 반환합니다." #: ../../document.rst:911 9cd16976fff44c6fb844b8cec7a2c169 msgid "New in v1.18.7, changed in v 1.18.13" msgstr "v1.18.7에서 새로 추가됨, v 1.18.13에서 변경됨" #: ../../document.rst:912 0ac083b623a047b4bcf044eae05904aa msgid "Changed in v1.19.4: remove a key \"physically\" if set to \"null\"." msgstr "v1.19.4에서 변경됨: \"null\" 로 설정된 경우 키를 \"물리적으로\" 제거합니다." #: ../../document.rst:914 64396e0edd7148ca84fae006294159f8 msgid "" "PDF only: Set (add, update, delete) the value of a PDF key for the " ":data:`dictionary` object given by its xref." msgstr "PDF 전용: xref로 제공된 :data:`dictionary` 객체에 대한 PDF 키의 값을 설정(추가, 업데이트, 삭제)합니다." #: ../../document.rst:916 5794fc8ff702458f9aaefe249a14c2ef msgid "" "This is an expert function: if you do not know what you are doing, there " "is a high risk to render (parts of) the PDF unusable. Please do consult " ":ref:`AdobeManual` about object specification formats (page 18) and the " "structure of special dictionary types like page objects." msgstr "" "이것은 전문가용 함수입니다: 무엇을 하고 있는지 모르는 경우 PDF의 (일부)를 사용할 수 없게 만들 위험이 높습니다. 객체 사양 " "형식(18페이지) 및 페이지 객체와 같은 특수 딕셔너리 타입의 구조에 대해 :ref:`AdobeManual` 을 참조하세요." #: ../../document.rst:918 089d864880fa43b0a3e7c78b23aa1fd5 msgid "" "the :data:`xref`. *Changed in v1.18.13:* To update the PDF trailer, " "specify -1." msgstr ":data:`xref`. *v1.18.13에서 변경됨:* PDF 트레일러를 업데이트하려면 -1을 지정하세요." #: ../../document.rst:919 15673f6ba0f34016b8ae9065767b7d8b msgid "" "the desired PDF key (without leading \"/\"). Must not be empty. Any valid" " PDF key -- whether already present in the object (which will be " "overwritten) -- or new. It is possible to use PDF path notation like " "`\"Resources/ExtGState\"` -- which sets the value for key " "`\"/ExtGState\"` as a sub-object of `\"/Resources\"`." msgstr "" "원하는 PDF 키(앞의 \"/\" 없음). 비어 있지 않아야 합니다. 객체에 이미 있는(덮어쓰기됨) 유효한 PDF 키 또는 새 키." " `\"Resources/ExtGState\"` 와 같은 PDF 경로 표기법을 사용할 수 있습니다. 이것은 " "`\"/Resources\"` 의 하위 객체로 `\"/ExtGState\"` 키의 값을 설정합니다." #: ../../document.rst:920 933213233ad746ad840f0156b1f94f1a msgid "" "the value for the key. It must be a non-empty string and, depending on " "the desired PDF object type, the following rules must be observed. There " "is some syntax checking, but **no type checking** and no checking if it " "makes sense PDF-wise, i.e. **no semantics checking**. Upper / lower case " "is important!" msgstr "" "키의 값. 비어 있지 않은 문자열이어야 하며, 원하는 PDF 객체 타입에 따라 다음 규칙을 준수해야 합니다. 일부 구문 검사가 " "있지만 **타입 검사는 없으며** PDF 관점에서 의미가 있는지 확인하지 않습니다. 즉, **의미론 검사는 없습니다**. 대소문자가" " 중요합니다!" #: ../../document.rst:922 88dc206233204bdfba432773e3390307 msgid "" "*:data:`xref`* -- must be provided as `\"nnn 0 R\"` with a valid " ":data:`xref` number nnn of the PDF. The suffix \"`0 R`\" is required to " "be recognizable as an xref by PDF applications." msgstr "" "*:data:`xref`* -- PDF의 유효한 :data:`xref` 번호 nnn을 사용하여 `\"nnn 0 R\"` 로 제공해야" " 합니다. PDF 애플리케이션에서 xref로 인식할 수 있도록 접미사 \"`0 R`\" 이 필요합니다." #: ../../document.rst:923 6925d7ed24cb4b64a6e6691de1cc2ad2 msgid "" "**array** -- a string like `\"[a b c d e f]\"`. The brackets are " "required. Array items must be separated by at least one space (not commas" " like in Python). An empty array `\"[]\"` is possible and *equivalent* to" " removing the key. Array items may be any PDF objects, like dictionaries," " xrefs, other arrays, etc. Like in Python, array items may be of " "different types." msgstr "" "**array** -- `\"[a b c d e f]\"` 와 같은 문자열. 대괄호가 필요합니다. 배열 항목은 최소한 하나의 " "공백으로 구분되어야 합니다(Python처럼 쉼표가 아님). 빈 배열 `\"[]\"` 가 가능하며 키 제거와 *동등* 합니다. 배열 " "항목은 딕셔너리, xref, 다른 배열 등과 같은 모든 PDF 객체일 수 있습니다. Python처럼 배열 항목은 다른 타입일 수 " "있습니다." #: ../../document.rst:924 28eb8fae1c82426ead4bb35d11289b23 msgid "" "**dict** -- a string like `\"<< ... >>\"`. The brackets are required and " "must enclose a valid PDF dictionary definition. The empty dictionary " "`\"<<>>\"` is possible and *equivalent* to removing the key." msgstr "" "**dict** -- `\"<< ... >>\"` 와 같은 문자열. 괄호가 필요하며 유효한 PDF 딕셔너리 정의를 포함해야 합니다." " 빈 딕셔너리 `\"<<>>\"` 가 가능하며 키 제거와 *동등* 합니다." #: ../../document.rst:925 a04a73f6b8654574bbd1a85f0a618a09 msgid "**int** -- an integer formatted **as a string**." msgstr "**int** -- **문자열로** 포맷된 정수." #: ../../document.rst:926 aaaafb8231484e539107d63be48d47d6 msgid "" "**float** -- a float formatted **as a string**. Scientific notation (with" " exponents) is **not allowed by PDF**." msgstr "**float** -- **문자열로** 포맷된 부동소수점. 과학적 표기법(지수 포함)은 **PDF에서 허용되지 않습니다**." #: ../../document.rst:927 37b8e833142747c3843fd9b6b6c7847b msgid "" "**null** -- the string `\"null\"`. This is the PDF equivalent to Python's" " `None` and causes the key to be ignored -- however not necessarily " "removed, resp. removed on saves with garbage collection. *Changed in " "v1.19.4:* If the key is no path hierarchy (i.e. contains no slash \"/\")," " then it will be completely removed." msgstr "" "**null** -- 문자열 `\"null\"`. 이것은 Python의 `None` 과 동등한 PDF이며 키를 무시하게 만듭니다. " "그러나 반드시 제거되는 것은 아니며, 가비지 수집과 함께 저장 시 제거됩니다. *v1.19.4에서 변경됨:* 키가 경로 계층이 아닌" " 경우(즉, 슬래시 \"/\" 가 없음), 완전히 제거됩니다." #: ../../document.rst:928 216d5b52576143519f482ac216cb8057 msgid "**bool** -- one of the strings `\"true\"` or `\"false\"`." msgstr "**bool** -- 문자열 `\"true\"` 또는 `\"false\"` 중 하나." #: ../../document.rst:929 f0e1858598fd41c29d7a96791dbc5f24 msgid "" "**name** -- a valid PDF name with a leading slash like this: " "`\"/PageLayout\"`. See page 16 of the :ref:`AdobeManual`." msgstr "" "**name** -- 앞에 슬래시가 있는 유효한 PDF 이름, 예: `\"/PageLayout\"`. " ":ref:`AdobeManual` 의 16페이지를 참조하세요." #: ../../document.rst:930 a914ca911c4c4159a3781a52ef7d1f98 msgid "" "**string** -- a valid PDF string. **All PDF strings must be enclosed by " "brackets**. Denote the empty string as `\"()\"`. Depending on its " "content, the possible brackets are" msgstr "" "**string** -- 유효한 PDF 문자열. **모든 PDF 문자열은 괄호로 둘러싸여야 합니다**. 빈 문자열은 `\"()\"`" " 로 표시합니다. 콘텐츠에 따라 가능한 괄호는" #: ../../document.rst:932 1ed9166a48c545be82c39b80562dc2da msgid "" "\"(...)\" for ASCII-only text. Reserved PDF characters must be backslash-" "escaped and non-ASCII characters must be provided as 3-digit backslash-" "escaped octals -- including leading zeros. Example: 12 = 0x0C must be " "encoded as `\\014`." msgstr "" "ASCII 전용 텍스트의 경우 \"(...)\". 예약된 PDF 문자는 백슬래시 이스케이프되어야 하며, 비ASCII 문자는 앞의 " "0을 포함하여 3자리 백슬래시 이스케이프된 8진수로 제공되어야 합니다. 예: 12 = 0x0C는 `\\014` 로 인코딩되어야 " "합니다." #: ../../document.rst:933 d441845d0a85478fa7fc790d3b118854 msgid "" "\"<...>\" for hex-encoded text. Every character must be represented by " "two hex-digits (lower or upper case)." msgstr "16진수 인코딩된 텍스트의 경우 \"<...>\". 모든 문자는 두 자리 16진수(소문자 또는 대문자)로 표현되어야 합니다." #: ../../document.rst:935 a11c1a8286be4329a17ec5d7c98add0f msgid "" "If in doubt, we **strongly recommend** to use :meth:`get_pdf_str`! This " "function automatically generates the right brackets, escapes, and overall" " format. It will for example do conversions like these:" msgstr "" "의심스러운 경우 :meth:`get_pdf_str` 사용을 **강력히 권장** 합니다! 이 함수는 올바른 괄호, 이스케이프 및 전체" " 형식을 자동으로 생성합니다. 예를 들어 다음과 같은 변환을 수행합니다:" #: ../../document.rst:947 cf6f6128b6884ccabee6fba67627f2ec msgid "" "Creates a pixmap from page *pno* (zero-based). Invokes " ":meth:`Page.get_pixmap`." msgstr "페이지 *pno* (0 기반)에서 pixmap을 생성합니다. :meth:`Page.get_pixmap` 을 호출합니다." #: ../../document.rst:949 f0955fd5487a4e5ea3ac0442b8e90f79 msgid "All parameters except `pno` are *keyword-only.*" msgstr "`pno` 를 제외한 모든 매개변수는 *키워드 전용* 입니다." #: ../../document.rst:951 3d8557ce87f14ec781fc2e843670c353 msgid "page number, 0-based in `-∞ < pno < page_count`." msgstr "페이지 번호, `-∞ < pno < page_count` 에서 0 기반." #: ../../document.rst:953 2fd43704060b4800a4b0c48a6d84311a msgid ":ref:`Pixmap`" msgstr ":ref:`Pixmap`" #: ../../document.rst:957 962d634dfd4e4b6b850458e82fe4b7c9 msgid "New in v1.16.13" msgstr "v1.16.13에서 새로 추가됨" #: ../../document.rst:958 9664b300564b4c1780ac04f4b998b8c2 msgid "Changed in v1.18.11" msgstr "v1.18.11에서 변경됨" #: ../../document.rst:960 f7da10aa82f7472b861d90418a3c8b90 msgid "PDF only: Return a list of all XObjects referenced by a page." msgstr "PDF 전용: 페이지에서 참조하는 모든 XObject 목록을 반환합니다." #: ../../document.rst:962 ../../document.rst:977 ../../document.rst:1004 #: 573fd738d1a94d979da34f7c5a090cb7 6a0779fdfff54bad8d6c0b225fef12df #: 7ce886aac0b6421395e6edea44f4a2df msgid "page number, 0-based, `-∞ < pno < page_count`." msgstr "페이지 번호, 0 기반, `-∞ < pno < page_count`." #: ../../document.rst:965 356c31b720a14052a406e595f02cea3f msgid "" "a list of (non-image) XObjects. These objects typically represent pages " "*embedded* (not copied) from other PDFs. For example, " ":meth:`Page.show_pdf_page` will create this type of object. An item of " "this list has the following layout: `(xref, name, invoker, bbox)`, where" " * *:data:`xref`* (*int*) is the XObject's :data:`xref`. * **name** " "(*str*) is the symbolic name to reference the XObject. * **invoker** " "(*int*) the :data:`xref` of the invoking XObject or zero if the page " "directly invokes it. * **bbox** (:ref:`Rect`) the boundary box of the " "XObject's location on the page **in untransformed coordinates**. To get " "actual, non-rotated page coordinates, multiply with the page's " "transformation matrix :attr:`Page.transformation_matrix`. *Changed in " "v.18.11:* the bbox is now formatted as :ref:`Rect`." msgstr "" #: ../../document.rst:965 f5e67a1ceb0f4ee98521899019f091fa msgid "" "a list of (non-image) XObjects. These objects typically represent pages " "*embedded* (not copied) from other PDFs. For example, " ":meth:`Page.show_pdf_page` will create this type of object. An item of " "this list has the following layout: `(xref, name, invoker, bbox)`, where" msgstr "" "(이미지가 아닌) XObject 목록. 이러한 객체는 일반적으로 다른 PDF에서 *임베디드된* (복사되지 않은) 페이지를 " "나타냅니다. 예를 들어, :meth:`Page.show_pdf_page` 는 이 타입의 객체를 생성합니다. 이 목록의 항목은 다음 " "레이아웃을 가집니다: `(xref, name, invoker, bbox)`, 여기서" #: ../../document.rst:967 bc10f1fc12174419970454b5396a5f96 msgid "*:data:`xref`* (*int*) is the XObject's :data:`xref`." msgstr "*:data:`xref`* (*int*)는 XObject의 :data:`xref` 입니다." #: ../../document.rst:968 3458baf801f4472197fe7420ec4729d0 msgid "**name** (*str*) is the symbolic name to reference the XObject." msgstr "**name** (*str*)는 XObject를 참조하는 심볼릭 이름입니다." #: ../../document.rst:969 ff1e7f3a7b5b4e1fba920f8368c15ba7 msgid "" "**invoker** (*int*) the :data:`xref` of the invoking XObject or zero if " "the page directly invokes it." msgstr "**invoker** (*int*)는 호출하는 XObject의 :data:`xref` 이거나 페이지가 직접 호출하는 경우 0입니다." #: ../../document.rst:970 9b7ba572cd2b43628b51e0eaac25c5f1 msgid "" "**bbox** (:ref:`Rect`) the boundary box of the XObject's location on the " "page **in untransformed coordinates**. To get actual, non-rotated page " "coordinates, multiply with the page's transformation matrix " ":attr:`Page.transformation_matrix`. *Changed in v.18.11:* the bbox is now" " formatted as :ref:`Rect`." msgstr "" "**bbox** (:ref:`Rect`)는 페이지에서 XObject 위치의 경계 상자입니다. **변환되지 않은 좌표** 에 " "있습니다. 실제, 비회전 페이지 좌표를 얻으려면 페이지의 변환 행렬 :attr:`Page.transformation_matrix` " "와 곱하세요. *v.18.11에서 변경됨:* bbox는 이제 :ref:`Rect` 로 포맷됩니다." #: ../../document.rst:975 0942f5b9705c43be833e3d4d7c9d04bf msgid "" "PDF only: Return a list of all images (directly or indirectly) referenced" " by the page." msgstr "PDF 전용: 페이지에서 참조하는 모든 이미지(직접 또는 간접) 목록을 반환합니다." #: ../../document.rst:978 c102f9d2a04f4397af702822dd6029d1 msgid "" "whether to also include the referencer's :data:`xref` (which is zero if " "this is the page)." msgstr "참조자의 :data:`xref` 도 포함할지 여부(페이지인 경우 0)." #: ../../document.rst:982 9f36391e139a4365ad37835cb1488399 msgid "" "a list of images **referenced** by this page. Each item looks like: " "`(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, " "filter, referencer)` * ``xref`` (*int*) is the image object number *" " ``smask`` (*int*) is the object number of its soft-mask image * " "``width`` (*int*) is the image width * ``height`` (*int*) is the image " "height * ``bpc`` (*int*) denotes the number of bits per component " "(normally 8) * ``colorspace`` (*str*) a string naming the colorspace " "(like **DeviceRGB**) * ``alt_colorspace`` (*str*) is any alternate " "colorspace depending on the value of **colorspace** * ``name`` (*str*) " "is the symbolic name by which the image is referenced * ``filter`` " "(*str*) is the decode filter of the image (:ref:`AdobeManual`, pp. 22)." " * ``referencer`` (*int*) the :data:`xref` of the referencer. Zero if " "directly referenced by the page. Only present if *full=True*." msgstr "" #: ../../document.rst:982 60c9f6c338a9474db9353697d0031f1c msgid "a list of images **referenced** by this page. Each item looks like:" msgstr "이 페이지에서 **참조하는** 이미지 목록. 각 항목은 다음과 같습니다:" #: ../../document.rst:984 68fa8977fcbf4250bbc0fa671f7c9a29 msgid "" "`(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, " "filter, referencer)`" msgstr "" "`(xref, smask, width, height, bpc, colorspace, alt_colorspace, name, " "filter, referencer)`" #: ../../document.rst:986 32a541d5d2124ba38de883af0a8ca8cc msgid "``xref`` (*int*) is the image object number" msgstr "``xref`` (*int*)는 이미지 객체 번호입니다" #: ../../document.rst:987 6e6e3aa40a1e47eeb6f7d90e271b6ca8 msgid "``smask`` (*int*) is the object number of its soft-mask image" msgstr "``smask`` (*int*)는 소프트 마스크 이미지의 객체 번호입니다" #: ../../document.rst:988 ac66e90cb9514167a7387bd5e1dbc28a msgid "``width`` (*int*) is the image width" msgstr "``width`` (*int*)는 이미지 너비입니다" #: ../../document.rst:989 e3be6fc835c74598885e920fbe4118aa msgid "``height`` (*int*) is the image height" msgstr "``height`` (*int*)는 이미지 높이입니다" #: ../../document.rst:990 814e68df351b4cb2936c13a6692e1877 msgid "``bpc`` (*int*) denotes the number of bits per component (normally 8)" msgstr "``bpc`` (*int*)는 구성 요소당 비트 수를 나타냅니다(일반적으로 8)" #: ../../document.rst:991 abfea8ca1da54ae39f9becdba855e107 msgid "``colorspace`` (*str*) a string naming the colorspace (like **DeviceRGB**)" msgstr "``colorspace`` (*str*)는 색상 공간을 명명하는 문자열(예: **DeviceRGB**)" #: ../../document.rst:992 fcaaa4a4cc5f40cb8fcaa678c8ea8d0d msgid "" "``alt_colorspace`` (*str*) is any alternate colorspace depending on the " "value of **colorspace**" msgstr "``alt_colorspace`` (*str*)는 **colorspace** 값에 따라 대체 색상 공간입니다" #: ../../document.rst:993 1fa8b147b39f418384f1575f3d529a44 msgid "``name`` (*str*) is the symbolic name by which the image is referenced" msgstr "``name`` (*str*)는 이미지가 참조되는 심볼릭 이름입니다" #: ../../document.rst:994 025346bb27a940e08fadeea999559e4d msgid "" "``filter`` (*str*) is the decode filter of the image (:ref:`AdobeManual`," " pp. 22)." msgstr "``filter`` (*str*)는 이미지의 디코드 필터입니다(:ref:`AdobeManual`, 22페이지)." #: ../../document.rst:995 fd32f1661b8a41308edbf4b15af88e2a msgid "" "``referencer`` (*int*) the :data:`xref` of the referencer. Zero if " "directly referenced by the page. Only present if *full=True*." msgstr "" "``referencer`` (*int*)는 참조자의 :data:`xref` 입니다. 페이지에서 직접 참조하는 경우 0입니다. " "*full=True* 인 경우에만 존재합니다." #: ../../document.rst:997 fdb38d2934564ddca22fea4df51c70c8 msgid "" "In general, this is not the list of images that are **actually " "displayed**. This method only parses several PDF objects to collect " "references to embedded images. It does not analyse the page's " ":data:`contents`, where all the actual image display commands are " "defined. To get this information, please use :meth:`Page.get_image_info`." " Also have a look at the discussion in section :ref:`textpagedict`." msgstr "" "일반적으로 이것은 **실제로 표시되는** 이미지 목록이 아닙니다. 이 메서드는 임베디드된 이미지에 대한 참조를 수집하기 위해 여러 " "PDF 객체만 파싱합니다. 실제 이미지 표시 명령이 정의된 페이지의 :data:`contents` 를 분석하지 않습니다. 이 정보를" " 얻으려면 :meth:`Page.get_image_info` 를 사용하세요. 또한 :ref:`textpagedict` 섹션의 논의를" " 참조하세요." #: ../../document.rst:1002 894bfe7ade6b4fe4a158abbb7e8741d3 msgid "" "PDF only: Return a list of all fonts (directly or indirectly) referenced " "by the page object definition." msgstr "PDF 전용: 페이지 객체 정의에서 참조하는 모든 폰트(직접 또는 간접) 목록을 반환합니다." #: ../../document.rst:1005 6a819ec56a614676bc2630447ff70565 msgid "" "whether to also include the referencer's :data:`xref`. If ``True``, the " "returned items are one entry longer. Use this option if you need to know," " whether the page directly references the font. In this case the last " "entry is 0. If the font is referenced by an `/XObject` of the page, you " "will find its :data:`xref` here." msgstr "" "참조자의 :data:`xref` 도 포함할지 여부. ``True`` 인 경우 반환된 항목이 한 항목 더 깁니다. 페이지가 폰트를 " "직접 참조하는지 알아야 하는 경우 이 옵션을 사용하세요. 이 경우 마지막 항목은 0입니다. 폰트가 페이지의 `/XObject` 에 " "의해 참조되는 경우 여기서 :data:`xref` 를 찾을 수 있습니다." #: ../../document.rst:1009 c1b26f5bf24a4321bdc6161a80fcf465 msgid "" "a list of fonts referenced by the object definition of the page. Each " "entry looks like: `(xref, ext, type, basefont, name, encoding, " "referencer)` * ``xref`` (*int*) is the font object number (may be " "zero if the PDF uses one of the builtin fonts directly) * ``ext`` " "(*str*) font file extension (e.g. \"ttf\", see :ref:`FontExtensions`)" " * ``type`` (*str*) is the font type (like \"Type1\" or \"TrueType\" " "etc.) * ``basefont`` (*str*) is the base font name, * ``name`` " "(*str*) is the symbolic name, by which the font is referenced * " "``encoding`` (*str*) the font's character encoding if different from its " "built-in encoding (:ref:`AdobeManual`, p. 254): * ``referencer`` " "(*int* optional) the :data:`xref` of the referencer. Zero if directly " "referenced by the page, otherwise the xref of an XObject. Only present if" " *full=True*." msgstr "" #: ../../document.rst:1009 c428c98ac9e3451f81ddf6d0e2a46e83 msgid "" "a list of fonts referenced by the object definition of the page. Each " "entry looks like:" msgstr "페이지 객체 정의에서 참조하는 폰트 목록. 각 항목은 다음과 같습니다:" #: ../../document.rst:1011 e355409fb7d5477f963c7379da3ddf0d msgid "`(xref, ext, type, basefont, name, encoding, referencer)`" msgstr "`(xref, ext, type, basefont, name, encoding, referencer)`" #: ../../document.rst:1013 f9b1750789b6485eb7a135397b3bb8df msgid "" "``xref`` (*int*) is the font object number (may be zero if the PDF uses " "one of the builtin fonts directly)" msgstr "``xref`` (*int*)는 폰트 객체 번호입니다(PDF가 내장 폰트 중 하나를 직접 사용하는 경우 0일 수 있음)" #: ../../document.rst:1014 7ce84ff9f475477da824c34563018a4a msgid "" "``ext`` (*str*) font file extension (e.g. \"ttf\", see " ":ref:`FontExtensions`)" msgstr "``ext`` (*str*)는 폰트 파일 확장자입니다(예: \"ttf\", :ref:`FontExtensions` 참조)" #: ../../document.rst:1015 6c03df3e7c174603b04400528d105778 msgid "``type`` (*str*) is the font type (like \"Type1\" or \"TrueType\" etc.)" msgstr "``type`` (*str*)는 폰트 타입입니다(예: \"Type1\" 또는 \"TrueType\" 등)" #: ../../document.rst:1016 4ce6e2e5a0c0411faf4f4fc0c1adbc1c msgid "``basefont`` (*str*) is the base font name," msgstr "``basefont`` (*str*)는 기본 폰트 이름입니다," #: ../../document.rst:1017 0765534374664d2985fb156fe239c1d5 msgid "``name`` (*str*) is the symbolic name, by which the font is referenced" msgstr "``name`` (*str*)는 폰트가 참조되는 심볼릭 이름입니다" #: ../../document.rst:1018 1d6115a28a0e4ae598e1ea94e3b004d6 msgid "" "``encoding`` (*str*) the font's character encoding if different from its " "built-in encoding (:ref:`AdobeManual`, p. 254):" msgstr "" "``encoding`` (*str*)는 내장 인코딩과 다른 경우 폰트의 문자 인코딩입니다(:ref:`AdobeManual`, " "254페이지):" #: ../../document.rst:1019 5ebbba5b9e384f76b51b899b9f2d5b16 msgid "" "``referencer`` (*int* optional) the :data:`xref` of the referencer. Zero " "if directly referenced by the page, otherwise the xref of an XObject. " "Only present if *full=True*." msgstr "" "``referencer`` (*int* 선택적)는 참조자의 :data:`xref` 입니다. 페이지에서 직접 참조하는 경우 0이고, " "그렇지 않으면 XObject의 xref입니다. *full=True* 인 경우에만 존재합니다." #: ../../document.rst:1021 3569124c76a74beb8c870ef6fa397799 msgid "Example::" msgstr "예제::" #: ../../document.rst:1034 e2535fc9161242ce8895729b77ec7732 msgid "" "This list has no duplicate entries: the combination of :data:`xref`, " "*name* and *referencer* is unique." msgstr "이 목록에는 중복 항목이 없습니다: :data:`xref`, *name* 및 *referencer* 의 조합이 고유합니다." #: ../../document.rst:1035 34a092cc0bf94ff0967f4b7cf77493af msgid "" "In general, this is a true superset of the fonts actually in use by this " "page. The PDF creator may e.g. have specified some global list, of which " "each page make only partial use." msgstr "" "일반적으로 이것은 이 페이지에서 실제로 사용 중인 폰트의 진정한 상위 집합입니다. PDF 작성자는 예를 들어 각 페이지가 " "부분적으로만 사용하는 전역 목록을 지정했을 수 있습니다." #: ../../document.rst:1036 8aa74a27cd3b495589ae7e3354e6b493 msgid "" "Be aware that font names returned by some variants of " ":meth:`Page.get_text` (respectively :ref:`TextPage` methods) need not " "(exactly) equal the base font name shown here. Reasons for any " "differences include:" msgstr "" ":meth:`Page.get_text` (각각 :ref:`TextPage` 메서드)의 일부 변형에서 반환하는 폰트 이름이 여기에 " "표시된 기본 폰트 이름과 (정확히) 같을 필요는 없습니다. 차이점의 이유는 다음과 같습니다:" #: ../../document.rst:1038 8eb2bfec0bfc435cadf15cb6ae9d42eb msgid "" "This method always shows any subset prefixes (the pattern ``ABCDEF+``), " "whereas text extractions do not do this by default." msgstr "이 메서드는 항상 모든 서브셋 접두사(패턴 ``ABCDEF+``)를 표시하지만, 텍스트 추출은 기본적으로 이를 수행하지 않습니다." #: ../../document.rst:1039 8fc75b1d2a5846f4a24d5dbcfe0cba93 msgid "" "Text extractions use the base library to access the font name, which has " "a length cap of 31 bytes and generally interrogates the font file binary " "to access the name. Method ``get_page_fonts()`` however looks at the PDF " "definition source." msgstr "" "텍스트 추출은 기본 라이브러리를 사용하여 폰트 이름에 액세스하며, 길이 제한이 31바이트이고 일반적으로 폰트 파일 바이너리를 " "조회하여 이름에 액세스합니다. 그러나 ``get_page_fonts()`` 메서드는 PDF 정의 소스를 살펴봅니다." #: ../../document.rst:1040 4274d5880663459d8b1903e93b4888ef msgid "" "Text extractions work for all supported document types in exactly the " "same way -- not just for PDFs. Consequently they do not contain PDF-" "specifics." msgstr "" "텍스트 추출은 PDF뿐만 아니라 지원되는 모든 문서 타입에 대해 정확히 동일한 방식으로 작동합니다. 결과적으로 PDF 특정 사항을 " "포함하지 않습니다." #: ../../document.rst:1044 9dc35195295741e183d3ad6e0209ae53 msgid "" "Extracts the text of a page given its page number *pno* (zero-based). " "Invokes :meth:`Page.get_text`." msgstr "페이지 번호 *pno* (0 기반)가 주어진 페이지의 텍스트를 추출합니다. :meth:`Page.get_text` 를 호출합니다." #: ../../document.rst:1046 9de1724014c8460babe8e3a752d8b7dc msgid "page number, 0-based, any value `-∞ < pno < page_count`." msgstr "페이지 번호, 0 기반, `-∞ < pno < page_count` 범위의 모든 값." #: ../../document.rst:1048 e3c19d5b184049b89dd66e661a7b4077 msgid "For other parameter refer to the page method." msgstr "다른 매개변수는 페이지 메서드를 참조하세요." #: ../../document.rst:1060 612a3f5ebc8a4f2494f277cd51d74e1a msgid "" "Re-paginate (\"reflow\") the document based on the given page dimension " "and fontsize. This only affects some document types like e-books and " "HTML. Ignored if not supported. Supported documents have ``True`` in " "property :attr:`is_reflowable`." msgstr "" "주어진 페이지 크기와 폰트 크기를 기반으로 문서를 다시 페이지화(\"리플로우\")합니다. 이것은 전자책 및 HTML과 같은 일부 " "문서 타입에만 영향을 줍니다. 지원되지 않으면 무시됩니다. 지원되는 문서는 속성 :attr:`is_reflowable` 에 " "``True`` 가 있습니다." #: ../../document.rst:1062 b8a887985240427abf836d07cff96aa4 msgid "desired page size. Must be finite, not empty and start at point (0, 0)." msgstr "원하는 페이지 크기. 유한하고 비어 있지 않으며 점 (0, 0)에서 시작해야 합니다." #: ../../document.rst:1063 f2f1d7b57dea48e2bc68fc8ca3110104 msgid "use it together with ``height`` as alternative to ``rect``." msgstr "``rect`` 의 대안으로 ``height`` 와 함께 사용합니다." #: ../../document.rst:1064 d6f5b528d21c4db999bceef858c1caca msgid "use it together with ``width`` as alternative to ``rect``." msgstr "``rect`` 의 대안으로 ``width`` 와 함께 사용합니다." #: ../../document.rst:1065 1a7ba975d0f4440ebed250c00e4038e7 msgid "the desired default fontsize." msgstr "원하는 기본 폰트 크기." #: ../../document.rst:1069 7abc47fb041a44d69a8d57062d16064a msgid "" "PDF only: Keeps only those pages of the document whose numbers occur in " "the list. Empty sequences or elements outside `range(doc.page_count)` " "will cause a *ValueError*. For more details see remarks at the bottom or " "this chapter." msgstr "" "PDF 전용: 목록에 있는 번호의 페이지만 유지합니다. 빈 시퀀스 또는 `range(doc.page_count)` 범위를 벗어난 " "요소는 *ValueError* 를 발생시킵니다. 자세한 내용은 이 장 하단의 설명을 참조하세요." #: ../../document.rst:1071 bd92b2ecc213478ca936d170a7f34d7c msgid "" "The sequence (see :ref:`SequenceTypes`) of page numbers (zero-based) to " "be included. Pages not in the sequence will be deleted (from memory) and " "become unavailable until the document is reopened. **Page numbers can " "occur multiple times and in any order:** the resulting document will " "reflect the sequence exactly as specified." msgstr "" "포함할 페이지 번호(0 기반)의 시퀀스(:ref:`SequenceTypes` 참조). 시퀀스에 없는 페이지는 삭제(메모리에서)되며 " "문서를 다시 열 때까지 사용할 수 없게 됩니다. **페이지 번호는 여러 번 발생할 수 있으며 어떤 순서로든 가능합니다:** 결과 " "문서는 지정된 대로 시퀀스를 정확히 반영합니다." #: ../../document.rst:1075 24611bb325054f519a6b9ff6cedb6beb msgid "" "Page numbers in the sequence need not be unique nor be in any particular " "order. This makes the method a versatile utility to e.g. select only the " "even or the odd pages or meeting some other criteria and so forth." msgstr "" "시퀀스의 페이지 번호는 고유할 필요도 없고 특정 순서일 필요도 없습니다. 이것은 예를 들어 짝수 페이지만 선택하거나 홀수 페이지만 " "선택하거나 다른 기준을 충족하는 등 다양한 유틸리티로 메서드를 만듭니다." #: ../../document.rst:1077 636a9e8015aa46309e556db665f2746c msgid "" "On a technical level, the method will always create a new " ":data:`pagetree`." msgstr "기술적 수준에서 이 메서드는 항상 새로운 :data:`pagetree` 를 생성합니다." #: ../../document.rst:1079 7e0da8188da041d9812450d9b3cafa12 msgid "" "When dealing with only a few pages, methods :meth:`copy_page`, " ":meth:`move_page`, :meth:`delete_page` are easier to use. In fact, they " "are also **much faster** -- by at least one order of magnitude when the " "document has many pages." msgstr "" "몇 페이지만 다룰 때는 :meth:`copy_page`, :meth:`move_page`, :meth:`delete_page` " "메서드가 더 쉽게 사용할 수 있습니다. 실제로 문서에 많은 페이지가 있을 때 최소한 한 자릿수 이상 **훨씬 빠릅니다**." #: ../../document.rst:1084 2f7f7e6048f34cac94145baf612aa008 msgid "" "PDF only: Sets or updates the metadata of the document as specified in " "*m*, a Python dictionary." msgstr "PDF 전용: Python 딕셔너리인 *m* 에 지정된 대로 문서의 메타데이터를 설정하거나 업데이트합니다." #: ../../document.rst:1086 fb17b12de6804d10baf0442394ea5395 #, python-brace-format msgid "" "A dictionary with the same keys as *metadata* (see below). All keys are " "optional. A PDF's format and encryption method cannot be set or changed " "and will be ignored. If any value should not contain data, do not specify" " its key or set the value to `None`. If you use *{}* all metadata " "information will be cleared to the string *\"none\"*. If you want to " "selectively change only some values, modify a copy of *doc.metadata* and " "use it as the argument. Arbitrary unicode values are possible if " "specified as UTF-8-encoded." msgstr "" "*metadata* (아래 참조)와 동일한 키를 가진 딕셔너리. 모든 키는 선택적입니다. PDF의 형식과 암호화 방법은 설정하거나 " "변경할 수 없으며 무시됩니다. 값에 데이터가 포함되지 않아야 하는 경우 해당 키를 지정하지 않거나 값을 `None` 으로 " "설정하세요. *{}* 를 사용하면 모든 메타데이터 정보가 문자열 *\"none\"* 으로 지워집니다. 일부 값만 선택적으로 " "변경하려면 *doc.metadata* 의 복사본을 수정하고 인수로 사용하세요. UTF-8로 인코딩된 것으로 지정하면 임의의 유니코드" " 값이 가능합니다." #: ../../document.rst:1088 0b2b37c69637443f9e21ca0c677ed090 msgid "" "*(Changed in v1.18.4)* Empty values or \"none\" are no longer written, " "but completely omitted." msgstr "*(v1.18.4에서 변경됨)* 빈 값 또는 \"none\" 은 더 이상 작성되지 않고 완전히 생략됩니다." #: ../../document.rst:1092 494191b897804e449e9c6b8a1a697bc3 msgid "PDF only: Get the document XML metadata." msgstr "PDF 전용: 문서 XML 메타데이터를 가져옵니다." #: ../../document.rst:1095 ef03232dafa34415ab9abc82a7c2da65 msgid "XML metadata of the document. Empty string if not present or not a PDF." msgstr "문서의 XML 메타데이터. 없거나 PDF가 아닌 경우 빈 문자열." #: ../../document.rst:1099 1fa0bae03c40463993e2665f1a49771e msgid "PDF only: Sets or updates XML metadata of the document." msgstr "PDF 전용: 문서의 XML 메타데이터를 설정하거나 업데이트합니다." #: ../../document.rst:1101 ad90c4fc4fdb4a058d7e1a286f93e70b msgid "" "the new XML metadata. Should be XML syntax, however no checking is done " "by this method and any string is accepted." msgstr "새 XML 메타데이터. XML 구문이어야 하지만 이 메서드는 검사를 수행하지 않으며 모든 문자열이 허용됩니다." #: ../../document.rst:1106 ../../document.rst:1115 ../../document.rst:1124 #: ../../document.rst:2062 ../../document.rst:2070 ../../document.rst:2078 #: ../../document.rst:2086 ../../document.rst:2094 #: 4adf90aedc904bc18c42a1a4109c7006 6b892ab1bef84c2dac64a07ddc45d085 #: 9b0e72fc7d0d492d85055abb7b229d4f b5c98f9002e143228355beb92946a982 #: b8c413017fc540269175c20d423a7951 cdd3c3d34b8b4453a89f97769225a597 #: d7f11258ac994270b4ff26f7a9aaef0d e3495fa87644414c88ff95b4ccdd5cfb msgid "New in v1.22.2" msgstr "v1.22.2에서 새로 추가됨" #: ../../document.rst:1108 58ed819517e3447c8b6fca160b416a15 msgid "PDF only: Set the `/PageLayout`." msgstr "PDF 전용: `/PageLayout` 을 설정합니다." #: ../../document.rst:1110 427d37e940fd4b079ecfc93d2ebc2707 msgid "" "one of the strings \"SinglePage\", \"OneColumn\", \"TwoColumnLeft\", " "\"TwoColumnRight\", \"TwoPageLeft\", \"TwoPageRight\". Lower case is " "supported." msgstr "" "문자열 \"SinglePage\", \"OneColumn\", \"TwoColumnLeft\", \"TwoColumnRight\"," " \"TwoPageLeft\", \"TwoPageRight\" 중 하나. 소문자가 지원됩니다." #: ../../document.rst:1117 1a85c014b44e470ba7519e90571a2672 msgid "PDF only: Set the `/PageMode`." msgstr "PDF 전용: `/PageMode` 를 설정합니다." #: ../../document.rst:1119 db113fac96c64e41888cc65fff2476e2 msgid "" "one of the strings \"UseNone\", \"UseOutlines\", \"UseThumbs\", " "\"FullScreen\", \"UseOC\", \"UseAttachments\". Lower case is supported." msgstr "" "문자열 \"UseNone\", \"UseOutlines\", \"UseThumbs\", \"FullScreen\", " "\"UseOC\", \"UseAttachments\" 중 하나. 소문자가 지원됩니다." #: ../../document.rst:1126 5deb2c951d31411794bc3358fc04faf0 msgid "PDF only: Set the `/MarkInfo` values." msgstr "PDF 전용: `/MarkInfo` 값을 설정합니다." #: ../../document.rst:1128 8120c18587bc46eea1126b758658f3f6 #, python-brace-format msgid "" "a dictionary like this one: `{\"Marked\": False, \"UserProperties\": " "False, \"Suspects\": False}`. This dictionary contains information about " "the usage of Tagged PDF conventions. For details please see the `PDF " "specifications `_." msgstr "" "다음과 같은 딕셔너리: `{\"Marked\": False, \"UserProperties\": False, " "\"Suspects\": False}`. 이 딕셔너리는 Tagged PDF 규칙 사용에 대한 정보를 포함합니다. 자세한 내용은 " "`PDF 사양 `_ 을 참조하세요." #: ../../document.rst:1133 72c170bc3e0f43f9ac97af5f1d62753b msgid "" "PDF only: Replaces the **complete current outline** tree (table of " "contents) with the one provided as the argument. After successful " "execution, the new outline tree can be accessed as usual via " ":meth:`Document.get_toc` or via :attr:`Document.outline`. Like with other" " output-oriented methods, changes become permanent only via :meth:`save` " "(incremental save supported). Internally, this method consists of the " "following two steps. For a demonstration see example below." msgstr "" "PDF 전용: **현재 개요** 트리(목차)를 인수로 제공된 것으로 완전히 교체합니다. 성공적으로 실행한 후 새 개요 트리는 " ":meth:`Document.get_toc` 또는 :attr:`Document.outline` 을 통해 평소와 같이 액세스할 수 " "있습니다. 다른 출력 지향 메서드와 마찬가지로 변경 사항은 :meth:`save` 를 통해서만 영구적으로 적용됩니다(증분 저장 " "지원). 내부적으로 이 메서드는 다음 두 단계로 구성됩니다. 데모는 아래 예제를 참조하세요." #: ../../document.rst:1135 98622e412665444fab7ff8c2eda90595 msgid "Step 1 deletes all existing bookmarks." msgstr "1단계는 기존 북마크를 모두 삭제합니다." #: ../../document.rst:1137 6eedcc83ffe74d67bf4a3b29582462f3 msgid "Step 2 creates a new TOC from the entries contained in *toc*." msgstr "2단계는 *toc* 에 포함된 항목에서 새 TOC를 생성합니다." #: ../../document.rst:1139 cadc625db49a4809b4d70bf9b2a3933b msgid "" "A list / tuple with **all bookmark entries** that should form the new " "table of contents. Output variants of :meth:`get_toc` are acceptable. To " "completely remove the table of contents specify an empty sequence or " "None. Each item must be a list with the following format. * [lvl, title," " page [, dest]] where - **lvl** is the hierarchy level (int > 0) of " "the item, which **must be 1** for the first item and at most 1 larger " "than the previous one. - **title** (str) is the title to be displayed." " It is assumed to be UTF-8-encoded (relevant for multibyte code points " "only). - **page** (int) is the target page number **(attention: " "1-based)**. Must be in valid range if positive. Set it to -1 if there is " "no target, or the target is external. - **dest** (optional) is a " "dictionary or a number. If a number, it will be interpreted as the " "desired height (in points) this entry should point to on the page. Use a " "dictionary (like the one given as output by `get_toc(False)`) for a " "detailed control of the bookmark's properties, see " ":meth:`Document.get_toc` for a description." msgstr "" #: ../../document.rst:1141 cdb59ec76f7847e3a0cf3a5b77792ed4 msgid "" "A list / tuple with **all bookmark entries** that should form the new " "table of contents. Output variants of :meth:`get_toc` are acceptable. To " "completely remove the table of contents specify an empty sequence or " "None. Each item must be a list with the following format." msgstr "" "새 목차를 구성할 **모든 북마크 항목** 이 포함된 리스트/튜플. :meth:`get_toc` 의 출력 변형이 허용됩니다. 목차를 " "완전히 제거하려면 빈 시퀀스 또는 None을 지정하세요. 각 항목은 다음 형식의 리스트여야 합니다." #: ../../document.rst:1143 626c048ee62e42a0bef1b3584f2589f5 msgid "[lvl, title, page [, dest]] where" msgstr "[lvl, title, page [, dest]] 여기서" #: ../../document.rst:1145 8bb47b49efa14fc99859d1452d07bf69 msgid "" "**lvl** is the hierarchy level (int > 0) of the item, which **must be 1**" " for the first item and at most 1 larger than the previous one." msgstr "" "**lvl** 은 항목의 계층 수준(int > 0)이며, 첫 번째 항목의 경우 **반드시 1** 이어야 하고 이전 항목보다 최대 " "1만큼 클 수 있습니다." #: ../../document.rst:1147 f1f7cd98aae94a2e8c0a85f5fbe9d7d6 msgid "" "**title** (str) is the title to be displayed. It is assumed to be " "UTF-8-encoded (relevant for multibyte code points only)." msgstr "**title** (str)는 표시할 제목입니다. UTF-8로 인코딩된 것으로 가정됩니다(멀티바이트 코드 포인트에만 해당)." #: ../../document.rst:1149 092134e22d9345ce9a23c842f343e4ba msgid "" "**page** (int) is the target page number **(attention: 1-based)**. Must " "be in valid range if positive. Set it to -1 if there is no target, or the" " target is external." msgstr "" "**page** (int)는 대상 페이지 번호입니다 **(주의: 1 기반)**. 양수인 경우 유효한 범위에 있어야 합니다. 대상이 " "없거나 대상이 외부인 경우 -1로 설정하세요." #: ../../document.rst:1151 b99ea47aafda42d489c734010b1649d5 msgid "" "**dest** (optional) is a dictionary or a number. If a number, it will be " "interpreted as the desired height (in points) this entry should point to " "on the page. Use a dictionary (like the one given as output by " "`get_toc(False)`) for a detailed control of the bookmark's properties, " "see :meth:`Document.get_toc` for a description." msgstr "" "**dest** (선택적)는 딕셔너리 또는 숫자입니다. 숫자인 경우 이 항목이 페이지에서 가리켜야 하는 원하는 높이(포인트)로 " "해석됩니다. 북마크 속성을 세부적으로 제어하려면 딕셔너리를 사용하세요(`get_toc(False)` 의 출력과 같은 형식). 설명은" " :meth:`Document.get_toc` 를 참조하세요." #: ../../document.rst:1153 140d7baa991d45d0af1070c30abc800a msgid "" "*(new in v1.16.9)* controls the hierarchy level beyond which outline " "entries should initially show up collapsed. The default 1 will hence only" " display level 1, higher levels must be unfolded using the PDF viewer. To" " unfold everything, specify either a large integer, 0 or None." msgstr "" "*(v1.16.9에서 새로 추가됨)* 개요 항목이 처음에 접힌 상태로 표시되어야 하는 계층 수준을 제어합니다. 기본값 1은 따라서 " "레벨 1만 표시하며, 더 높은 레벨은 PDF 뷰어를 사용하여 펼쳐야 합니다. 모든 것을 펼치려면 큰 정수, 0 또는 None을 " "지정하세요." #: ../../document.rst:1156 94fd3cfe66044726bbc940305f4fedfd msgid "the number of inserted, resp. deleted items." msgstr "삽입된 항목 수, 각각 삭제된 항목 수." #: ../../document.rst:1158 61bddd5d79224a969e31759461728b07 msgid "" "Changed in v1.23.8: Destination 'to' coordinates should now be in the " "same coordinate system as those returned by `get_toc()` (internally they " "are now transformed with `page.cropbox` and `page.rotation_matrix`). So " "for example `set_toc(get_toc())` now gives unchanged destination 'to' " "coordinates." msgstr "" "v1.23.8에서 변경됨: 대상 'to' 좌표는 이제 `get_toc()` 에서 반환하는 것과 동일한 좌표계에 있어야 " "합니다(내부적으로 `page.cropbox` 와 `page.rotation_matrix` 로 변환됨). 예를 들어 " "`set_toc(get_toc())` 는 이제 변경되지 않은 대상 'to' 좌표를 제공합니다." #: ../../document.rst:1168 d2b2c6ea9a0a4e158130c63e477b1548 msgid "" "PDF only: Return the :data:`xref` of the outline item. This is mainly " "used for internal purposes." msgstr "PDF 전용: 개요 항목의 :data:`xref` 를 반환합니다. 주로 내부 목적으로 사용됩니다." #: ../../document.rst:1170 41a5cf21e50745f3aba9288a72873f10 msgid "index of the item in list :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` 리스트의 항목 인덱스." #: ../../document.rst:1172 849479f903f34747a2b708a93d748011 msgid ":data:`xref`." msgstr ":data:`xref`." #: ../../document.rst:1177 4dd33d7619fc44ecbbe5d72e91d84012 msgid "" "Changed in v1.18.14: no longer remove the item's text, but show it " "grayed-out." msgstr "v1.18.14에서 변경됨: 항목의 텍스트를 더 이상 제거하지 않고 회색으로 표시합니다." #: ../../document.rst:1179 f49f270454b7447389c99fbc3c081369 msgid "" "PDF only: Remove this TOC item. This is a high-speed method, which " "**disables** the respective item, but leaves the overall TOC structure " "intact. Physically, the item still exists in the TOC tree, but is shown " "grayed-out and will no longer point to any destination." msgstr "" "PDF 전용: 이 TOC 항목을 제거합니다. 이것은 해당 항목을 **비활성화** 하지만 전체 TOC 구조는 그대로 유지하는 고속 " "메서드입니다. 물리적으로 항목은 여전히 TOC 트리에 존재하지만 회색으로 표시되며 더 이상 어떤 대상도 가리키지 않습니다." #: ../../document.rst:1181 b5b90e9a53374eb4a723ed21fc6f0ac1 msgid "" "This also implies that you can reassign the item to a new destination " "using :meth:`Document.set_toc_item`, when required." msgstr "이것은 필요할 때 :meth:`Document.set_toc_item` 을 사용하여 항목을 새 대상에 재할당할 수 있음을 의미합니다." #: ../../document.rst:1183 6d53ee1db74b4a2caa95023d65e00b0e msgid "the index of the item in list :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` 리스트의 항목 인덱스." #: ../../document.rst:1189 20ab18dcdb0c4c36a8f7146969f7343a msgid "Changed in v1.18.6" msgstr "v1.18.6에서 변경됨" #: ../../document.rst:1191 bea76c094b844e56a30d16649f55b442 msgid "" "PDF only: Changes the TOC item identified by its index. Change the item " "**title**, **destination**, **appearance** (color, bold, italic) or " "collapsing sub-items -- or to remove the item altogether." msgstr "" "PDF 전용: 인덱스로 식별된 TOC 항목을 변경합니다. 항목의 **제목**, **대상**, **모양** (색상, 굵게, 기울임꼴)" " 또는 하위 항목 접기 -- 또는 항목을 완전히 제거합니다." #: ../../document.rst:1193 a1abb954511f4decb89272ea3006c663 msgid "" "Use this method if you need specific changes for selected entries only " "and want to avoid replacing the complete TOC. This is beneficial " "especially when dealing with large table of contents." msgstr "" "선택한 항목에 대해서만 특정 변경이 필요하고 전체 TOC를 교체하는 것을 피하려는 경우 이 메서드를 사용하세요. 특히 큰 목차를 " "다룰 때 유용합니다." #: ../../document.rst:1195 bf1e8e83220f4e99987d442177c40897 msgid "the index of the entry in the list created by :meth:`Document.get_toc`." msgstr ":meth:`Document.get_toc` 로 생성된 리스트의 항목 인덱스." #: ../../document.rst:1196 f97b0254a2a845b7962cca10c78ef12c msgid "" "the new destination. A dictionary like the last entry of an item in " "`doc.get_toc(False)`. Using this as a template is recommended. When " "given, **all other parameters are ignored** -- except title." msgstr "" "새 대상. `doc.get_toc(False)` 의 항목 마지막 항목과 같은 딕셔너리. 이것을 템플릿으로 사용하는 것이 권장됩니다." " 제공되면 **다른 모든 매개변수는 무시됩니다** -- 제목 제외." #: ../../document.rst:1197 c97e2f7c844f4e64b68ed04c274e7af0 msgid "" "the link kind, see :ref:`linkDest Kinds`. If :data:`LINK_NONE`, then all " "remaining parameter will be ignored, and the TOC item will be removed -- " "same as :meth:`Document.del_toc_item`. If None, then only the title is " "modified and the remaining parameters are ignored. All other values will " "lead to making a new destination dictionary using the subsequent " "arguments." msgstr "" "링크 종류, :ref:`linkDest Kinds` 참조. :data:`LINK_NONE` 인 경우 나머지 모든 매개변수가 무시되고" " TOC 항목이 제거됩니다 -- :meth:`Document.del_toc_item` 과 동일. None인 경우 제목만 수정되고 " "나머지 매개변수는 무시됩니다. 다른 모든 값은 후속 인수를 사용하여 새 대상 딕셔너리를 만듭니다." #: ../../document.rst:1198 d3439567ac7042319ae8dd763512500a msgid "" "the 1-based page number, i.e. a value 1 <= pno <= doc.page_count. " "Required for LINK_GOTO." msgstr "1 기반 페이지 번호, 즉 값 1 <= pno <= doc.page_count. LINK_GOTO에 필요합니다." #: ../../document.rst:1199 5a95d66b5b9a4ae891896126c4591958 msgid "the URL text. Required for LINK_URI." msgstr "URL 텍스트. LINK_URI에 필요합니다." #: ../../document.rst:1200 bd37daff52754143bd1d58d51f64fa0f msgid "the desired new title. None if no change." msgstr "원하는 새 제목. 변경 없으면 None." #: ../../document.rst:1201 9fb31ce97f374940aa9639c9f54f25a9 msgid "" "(optional) points to a coordinate on the target page. Relevant for " "LINK_GOTO. If omitted, a point near the page's top is chosen." msgstr "(선택적) 대상 페이지의 좌표를 가리킵니다. LINK_GOTO와 관련이 있습니다. 생략하면 페이지 상단 근처의 점이 선택됩니다." #: ../../document.rst:1202 5f66a09773424b2dbe81dd4a8fc3c30a msgid "required for LINK_GOTOR and LINK_LAUNCH." msgstr "LINK_GOTOR 및 LINK_LAUNCH에 필요합니다." #: ../../document.rst:1203 b487f04964a9453baf8d5d209996a7fa msgid "use this zoom factor when showing the target page." msgstr "대상 페이지를 표시할 때 이 확대/축소 비율을 사용합니다." #: ../../document.rst:1205 462fa8fbb28645c3918464eef6bf19af msgid "**Example use:** Change the TOC of the SWIG manual to achieve this:" msgstr "**사용 예:** SWIG 매뉴얼의 TOC를 변경하여 다음을 달성합니다:" #: ../../document.rst:1207 266f767d832b44239b654042eb109117 msgid "" "Collapse everything below top level and show the chapter on Python " "support in red, bold and italic::" msgstr "최상위 레벨 아래의 모든 항목을 접고 Python 지원 장을 빨간색, 굵게, 기울임꼴로 표시합니다::" #: ../../document.rst:1224 dbbb176419574079b65c7d553aca8513 msgid "" "In the previous example, we have changed only 42 of the 1240 TOC items of" " the file." msgstr "이전 예제에서 파일의 1240개 TOC 항목 중 42개만 변경했습니다." #: ../../document.rst:1228 9c0eac3df7ec40818cf474ec6d1b90e0 msgid "" "PDF only: Convert annotations and / or widgets to become permanent parts " "of the pages. The PDF **will be changed** by this method. If `widgets` is" " `True`, the document will also no longer be a \"Form PDF\"." msgstr "" "PDF 전용: 주석 및/또는 위젯을 페이지의 영구 부분으로 변환합니다. 이 메서드로 PDF가 **변경됩니다**. `widgets` " "가 `True` 인 경우 문서는 더 이상 \"Form PDF\"가 아닙니다." #: ../../document.rst:1230 bf59f3a2a5f7468f8a28de2522317838 msgid "" "All pages will look the same, but will no longer have annotations, " "respectively fields. The visible parts will be converted to standard " "text, vector graphics or images as required." msgstr "" "모든 페이지는 동일하게 보이지만 더 이상 주석 또는 필드를 갖지 않습니다. 표시되는 부분은 필요에 따라 표준 텍스트, 벡터 그래픽 " "또는 이미지로 변환됩니다." #: ../../document.rst:1232 61e967b2174c4737b81e4fbc697f2643 msgid "" "The method may thus be a viable **alternative for PDF-to-PDF " "conversions** using :meth:`Document.convert_to_pdf`." msgstr "" "따라서 이 메서드는 :meth:`Document.convert_to_pdf` 를 사용한 **PDF-to-PDF 변환의 대안** 이 " "될 수 있습니다." #: ../../document.rst:1234 19d028b19c044458b9d15ce7b68d5d72 msgid "" "Please consider that annotations are complex objects and may consist of " "more data \"underneath\" their visual appearance. Examples are \"Text\" " "and \"FileAttachment\" annotations. When \"baking in\" annotations / " "widgets with this method, all this underlying information (attached " "files, comments, associated PopUp annotations, etc.) will be lost and be " "removed on next garbage collection." msgstr "" "주석은 복잡한 객체이며 시각적 모양 \"아래\"에 더 많은 데이터가 포함될 수 있습니다. 예는 \"Text\" 및 " "\"FileAttachment\" 주석입니다. 이 메서드로 주석/위젯을 \"구워 넣을\" 때 모든 기본 정보(첨부 파일, 주석, " "관련 PopUp 주석 등)가 손실되고 다음 가비지 수집 시 제거됩니다." #: ../../document.rst:1236 0f6435c640bd4abd83e3ab107d798d3c msgid "" "Use this feature for instance for :meth:`Page.show_pdf_page` (which " "supports neither annotations nor widgets) when the source pages should " "look exactly the same in the target." msgstr "" "소스 페이지가 대상에서 정확히 동일하게 보여야 할 때 예를 들어 :meth:`Page.show_pdf_page` (주석도 위젯도 " "지원하지 않음)에 이 기능을 사용하세요." #: ../../document.rst:1239 96ef3fe55fbe415fb7e1ba9a12bf11bf msgid "convert annotations." msgstr "주석을 변환합니다." #: ../../document.rst:1240 7f5d0a321b3940488ca3fb6c8f2943e9 msgid "" "convert fields / widgets. After execution, the document will no longer be" " a \"Form PDF\"." msgstr "필드/위젯을 변환합니다. 실행 후 문서는 더 이상 \"Form PDF\"가 아닙니다." #: ../../document.rst:1245 60d5dfcfd9a74425a9d56d6dbf2c1d2c msgid "New in v1.16.0" msgstr "v1.16.0에서 새로 추가됨" #: ../../document.rst:1247 bb7bb5385d2e417bbdfd1f53e52a28d9 msgid "" "Check whether the document can be saved incrementally. Use it to choose " "the right option without encountering exceptions." msgstr "문서를 증분 저장할 수 있는지 확인합니다. 예외 없이 올바른 옵션을 선택하는 데 사용하세요." #: ../../document.rst:1251 bc2493d433b7493eacdc1dc5afe9f7a5 msgid "New in v1.16.14" msgstr "v1.16.14에서 새로 추가됨" #: ../../document.rst:1253 714cf5c63fe148968601af72485159a0 msgid "" "PDF only: Remove potentially sensitive data from the PDF. This function " "is inspired by the similar \"Sanitize\" function in Adobe Acrobat " "products. The process is configurable by a number of options." msgstr "" "PDF 전용: PDF에서 잠재적으로 민감한 데이터를 제거합니다. 이 함수는 Adobe Acrobat 제품의 유사한 " "\"Sanitize\" 함수에서 영감을 받았습니다. 프로세스는 여러 옵션으로 구성할 수 있습니다." #: ../../document.rst:1255 d59772e9be994beb89b82b6a50277c35 msgid "Search for 'FileAttachment' annotations and remove the file content." msgstr "'FileAttachment' 주석을 검색하고 파일 콘텐츠를 제거합니다." #: ../../document.rst:1256 b0de421c4e9f4532b9e1e53b36cffbb2 msgid "" "Remove any comments from page painting sources. If this option is set to " "``False``, then this is also done for *hidden_text* and *redactions*." msgstr "" "페이지 그리기 소스에서 모든 주석을 제거합니다. 이 옵션이 ``False`` 로 설정되면 *hidden_text* 및 " "*redactions* 에 대해서도 수행됩니다." #: ../../document.rst:1257 9dc57a2c711d40f3a2f979b1f9b73c45 msgid "Remove embedded files." msgstr "임베디드 파일을 제거합니다." #: ../../document.rst:1258 e259fd77d3b44e3aaf2df616427e9cff msgid "Remove OCRed text and invisible text [#f7]_." msgstr "OCR된 텍스트와 보이지 않는 텍스트를 제거합니다 [#f7]_." #: ../../document.rst:1259 3050a96f9ed648baa8cc07b5bf30aef0 msgid "Remove JavaScript sources." msgstr "JavaScript 소스를 제거합니다." #: ../../document.rst:1260 242893b3617448a98703d146fc18d440 msgid "Remove PDF standard metadata." msgstr "PDF 표준 메타데이터를 제거합니다." #: ../../document.rst:1261 390e373af5eb4c48829f4f6b53cddc73 msgid "Apply redaction annotations." msgstr "수정 주석을 적용합니다." #: ../../document.rst:1262 4cd57dcd3a694fee956d822ac6b5a852 msgid "" "how to handle images if applying redactions. One of 0 (ignore), 1 (blank " "out overlaps) or 2 (remove)." msgstr "수정을 적용할 때 이미지를 처리하는 방법. 0(무시), 1(겹침을 비움) 또는 2(제거) 중 하나." #: ../../document.rst:1263 00ef5f77074d44bb82fcda8759ce527b msgid "Remove all links." msgstr "모든 링크를 제거합니다." #: ../../document.rst:1264 526404ef66ce4cb6862edcb9f410cf85 msgid "Reset all form fields to their defaults." msgstr "모든 양식 필드를 기본값으로 재설정합니다." #: ../../document.rst:1265 2a989b196378452b91c99bb4b36f7458 msgid "Remove all responses from all annotations." msgstr "모든 주석에서 모든 응답을 제거합니다." #: ../../document.rst:1266 1f49855b78e9418d850fe0705af4921a msgid "Remove thumbnail images from pages." msgstr "페이지에서 썸네일 이미지를 제거합니다." #: ../../document.rst:1267 73db39387008420ebb8ec2ac21beb2bf msgid "Remove XML metadata." msgstr "XML 메타데이터를 제거합니다." #: ../../document.rst:1272 ../../document.rst:1349 #: 04276335faaa444494e1bdf6a447a071 40680bdd5180459eb399cc80b91c47c1 msgid "Changed in v1.18.7" msgstr "v1.18.7에서 변경됨" #: ../../document.rst:1273 ../../document.rst:1350 #: 7d3e460da3e047e891e251c4b7cfa065 cbd0cf9d3ec94dd9a661a91259f0312b msgid "Changed in v1.19.0" msgstr "v1.19.0에서 변경됨" #: ../../document.rst:1274 ../../document.rst:1351 #: 59e6623e271c4a75bf5f34ff948d1f81 cd2af959721d45009d28f6cd97a4f518 msgid "Changed in v1.24.1" msgstr "v1.24.1에서 변경됨" #: ../../document.rst:1276 a358c08f51ec4d6a97cc369b80908ba3 msgid "PDF only: Saves the document in its **current state**." msgstr "PDF 전용: 문서를 **현재 상태** 로 저장합니다." #: ../../document.rst:1278 8b66e825ec804b7a91f56a4510709e2a msgid "" "The file path, `pathlib.Path` or file object to save to. A file object " "must have been created before via `open(...)` or `io.BytesIO()`. Choosing" " `io.BytesIO()` is similar to :meth:`Document.tobytes` below, which " "equals the `getvalue()` output of an internally created `io.BytesIO()`." msgstr "" "저장할 파일 경로, `pathlib.Path` 또는 파일 객체. 파일 객체는 `open(...)` 또는 `io.BytesIO()` " "를 통해 미리 생성되어야 합니다. `io.BytesIO()` 를 선택하는 것은 아래 :meth:`Document.tobytes` 와" " 유사하며, 내부적으로 생성된 `io.BytesIO()` 의 `getvalue()` 출력과 같습니다." #: ../../document.rst:1280 bec970d0303f4a7caee288540e178d40 msgid "" "Do garbage collection. Positive values exclude \"incremental\". * 0 = " "none * 1 = remove unused (unreferenced) objects. * 2 = in addition to 1, " "compact the :data:`xref` table. * 3 = in addition to 2, merge duplicate " "objects. * 4 = in addition to 3, check :data:`stream` objects for " "duplication. This may be slow because such data are typically large." msgstr "" #: ../../document.rst:1280 a27314cc7f4b477ca9f090f899cff41b msgid "Do garbage collection. Positive values exclude \"incremental\"." msgstr "가비지 수집을 수행합니다. 양수 값은 \"incremental\"을 제외합니다." #: ../../document.rst:1282 ../../document.rst:1300 #: 04eb5f84c28048669c20567fe0e48169 d200a55bded140df93fc1fcc51582d76 msgid "0 = none" msgstr "0 = 없음" #: ../../document.rst:1283 8be03fa92a78481192962b895c92585d msgid "1 = remove unused (unreferenced) objects." msgstr "1 = 사용되지 않는(참조되지 않은) 객체를 제거합니다." #: ../../document.rst:1284 6bb26ad0c00642a2a6e3e6ecc079e041 msgid "2 = in addition to 1, compact the :data:`xref` table." msgstr "2 = 1에 추가하여 :data:`xref` 테이블을 압축합니다." #: ../../document.rst:1285 aa51c2a5b852418985e4421a102ccca8 msgid "3 = in addition to 2, merge duplicate objects." msgstr "3 = 2에 추가하여 중복 객체를 병합합니다." #: ../../document.rst:1286 dac3401261ab4ae5aaecdecc10a1d24b msgid "" "4 = in addition to 3, check :data:`stream` objects for duplication. This " "may be slow because such data are typically large." msgstr "4 = 3에 추가하여 :data:`stream` 객체의 중복을 확인합니다. 이러한 데이터는 일반적으로 크기 때문에 느릴 수 있습니다." #: ../../document.rst:1288 97a5b429f80a42baaa67acfaafa3ccd8 msgid "" "Clean and sanitize content streams [#f1]_. Corresponds to \"mutool clean " "-sc\"." msgstr "콘텐츠 스트림을 정리하고 정화합니다 [#f1]_. \"mutool clean -sc\" 에 해당합니다." #: ../../document.rst:1290 25320d9b0afa46a7a2263c5a006d74ce msgid "Deflate (compress) uncompressed streams." msgstr "압축되지 않은 스트림을 Deflate(압축)합니다." #: ../../document.rst:1291 17c88bde58484f2191ddb9cdc5c7908f msgid "*(new in v1.18.3)* Deflate (compress) uncompressed image streams [#f4]_." msgstr "*(v1.18.3에서 새로 추가됨)* 압축되지 않은 이미지 스트림을 Deflate(압축)합니다 [#f4]_." #: ../../document.rst:1292 f16362460abf4cb5b19b3a97d5dbb203 msgid "" "*(new in v1.18.3)* Deflate (compress) uncompressed fontfile streams " "[#f4]_." msgstr "*(v1.18.3에서 새로 추가됨)* 압축되지 않은 폰트 파일 스트림을 Deflate(압축)합니다 [#f4]_." #: ../../document.rst:1294 2d48d3b453ec453e9a06ecd5a76223e0 msgid "" "Only save changes to the PDF. Excludes \"garbage\" and \"linear\". Can " "only be used if *outfile* is a string or a `pathlib.Path` and equal to " ":attr:`Document.name`. Cannot be used for files that are decrypted or " "repaired and also in some other cases. To be sure, check " ":meth:`Document.can_save_incrementally`. If this is false, saving to a " "new file is required." msgstr "" "PDF에 변경 사항만 저장합니다. \"garbage\" 및 \"linear\"를 제외합니다. *outfile* 이 문자열이거나 " "`pathlib.Path` 이고 :attr:`Document.name` 과 같을 때만 사용할 수 있습니다. 복호화되거나 복구된 파일" " 및 일부 다른 경우에는 사용할 수 없습니다. 확인하려면 :meth:`Document.can_save_incrementally` 를" " 확인하세요. 이것이 false이면 새 파일로 저장해야 합니다." #: ../../document.rst:1296 de1d75d087da4904a87ff4e42c567da2 msgid "convert binary data to ASCII." msgstr "바이너리 데이터를 ASCII로 변환합니다." #: ../../document.rst:1298 73573581067046a2b1d73dadb5784bef msgid "" "Decompress objects. Generates versions that can be better read by some " "other programs and will lead to larger files. * 0 = none * 1 = images * " "2 = fonts * 255 = all" msgstr "" #: ../../document.rst:1298 24b492fbe4214257aab8402badd85f49 msgid "" "Decompress objects. Generates versions that can be better read by some " "other programs and will lead to larger files." msgstr "객체를 압축 해제합니다. 일부 다른 프로그램에서 더 잘 읽을 수 있는 버전을 생성하며 더 큰 파일로 이어집니다." #: ../../document.rst:1301 9bb1ccd1f87d4efc973cda0d5dad59b5 msgid "1 = images" msgstr "1 = 이미지" #: ../../document.rst:1302 f632c4e866254ac4a1f52bdb594e61f0 msgid "2 = fonts" msgstr "2 = 폰트" #: ../../document.rst:1303 8c01aec5e66e45e586fe77a7d35fabf8 msgid "255 = all" msgstr "255 = 모두" #: ../../document.rst:1305 cd58f0f1000c408a81e9a604b071d409 msgid "" "Save a linearised version of the document. This option creates a file " "format for improved performance for Internet access. Excludes " "\"incremental\" and \"use_objstms\"." msgstr "" "문서의 선형화된 버전을 저장합니다. 이 옵션은 인터넷 액세스를 위한 향상된 성능을 위한 파일 형식을 생성합니다. " "\"incremental\" 및 \"use_objstms\"를 제외합니다." #: ../../document.rst:1307 5e331580fd9448fdbfa0698c6df5fe0a msgid "" "Prettify the document source for better readability. PDF objects will be " "reformatted to look like the default output of " ":meth:`Document.xref_object`." msgstr "" "가독성을 높이기 위해 문서 소스를 예쁘게 만듭니다. PDF 객체는 :meth:`Document.xref_object` 의 기본 " "출력처럼 보이도록 재포맷됩니다." #: ../../document.rst:1309 7dd16ad90be84acbaf63def731cbd264 msgid "" "Suppress the update of the file's `/ID` field. If the file happens to " "have no such field at all, also suppress creation of a new one. Default " "is `False`, so every save will lead to an updated file identification." msgstr "" "파일의 `/ID` 필드 업데이트를 억제합니다. 파일에 해당 필드가 전혀 없는 경우 새 필드 생성도 억제합니다. 기본값은 " "`False` 이므로 모든 저장은 업데이트된 파일 식별로 이어집니다." #: ../../document.rst:1311 2a716f171a0f421fa85517312a40a191 msgid "" "*(new in v1.16.0)* Set the desired permission levels. See " ":ref:`PermissionCodes` for possible values. Default is granting all." msgstr "" "*(v1.16.0에서 새로 추가됨)* 원하는 권한 수준을 설정합니다. 가능한 값은 :ref:`PermissionCodes` 를 " "참조하세요. 기본값은 모든 권한을 부여하는 것입니다." #: ../../document.rst:1313 c9d3decafb2f4d53b6c2c54c84c22e21 msgid "" "*(new in v1.16.0)* set the desired encryption method. See " ":ref:`EncryptionMethods` for possible values." msgstr "" "*(v1.16.0에서 새로 추가됨)* 원하는 암호화 방법을 설정합니다. 가능한 값은 :ref:`EncryptionMethods` 를" " 참조하세요." #: ../../document.rst:1315 8c5a0443338f4058bc9b39b87a5a1ed5 msgid "" "*(new in v1.16.0)* set the document's owner password. *(Changed in " "v1.18.3)* If not provided, the user password is taken if provided. The " "string length must not exceed 40 characters." msgstr "" "*(v1.16.0에서 새로 추가됨)* 문서의 소유자 비밀번호를 설정합니다. *(v1.18.3에서 변경됨)* 제공되지 않으면 사용자 " "비밀번호가 제공된 경우 사용됩니다. 문자열 길이는 40자를 초과할 수 없습니다." #: ../../document.rst:1317 a46b78a4a9ae4766a339e09027197bb8 msgid "" "*(new in v1.16.0)* set the document's user password. The string length " "must not exceed 40 characters." msgstr "*(v1.16.0에서 새로 추가됨)* 문서의 사용자 비밀번호를 설정합니다. 문자열 길이는 40자를 초과할 수 없습니다." #: ../../document.rst:1319 481e3dc0b944487ead97aee81e4ba71b msgid "" "*(new in v1.24.0)* compression option that converts eligible PDF object " "definitions to information that is stored in some other object's " ":data:`stream` data. Depending on the `deflate` parameter value, the " "converted object definitions will be compressed -- which can lead to very" " significant file size reductions." msgstr "" "*(v1.24.0에서 새로 추가됨)* 적격 PDF 객체 정의를 다른 객체의 :data:`stream` 데이터에 저장된 정보로 " "변환하는 압축 옵션. `deflate` 매개변수 값에 따라 변환된 객체 정의가 압축됩니다 -- 이는 매우 큰 파일 크기 감소로 " "이어질 수 있습니다." #: ../../document.rst:1321 dc9a543907bb4a3fb5f759bc4d9a772a msgid "" "The method does not check, whether a file of that name already exists, " "will hence not ask for confirmation, and overwrite the file. It is your " "responsibility as a programmer to handle this." msgstr "" "이 메서드는 해당 이름의 파일이 이미 존재하는지 확인하지 않으므로 확인을 요청하지 않고 파일을 덮어씁니다. 프로그래머로서 이를 " "처리하는 것은 귀하의 책임입니다." #: ../../document.rst:1325 5b4cab99c9de4187b00ce3a945826cfc msgid "**File size reduction**" msgstr "**파일 크기 감소**" #: ../../document.rst:1327 a1964e573f34479da5566208ad76e9d4 msgid "" "1. Use the save options like `garbage=3|4, deflate=True, " "use_objstms=True|1`. Do not touch the default values `expand=False|0, " "clean=False|0, incremental=False|0, linear=False|0`. This is a " "\"lossless\" file size reduction. There is a convenience version of this " "method with these values set by default, :meth:`Document.ez_save` -- " "please see below." msgstr "" "1. `garbage=3|4, deflate=True, use_objstms=True|1` 와 같은 저장 옵션을 사용하세요. 기본값" " `expand=False|0, clean=False|0, incremental=False|0, linear=False|0` 는 " "건드리지 마세요. 이것은 \"무손실\" 파일 크기 감소입니다. 이러한 값이 기본적으로 설정된 이 메서드의 편의 버전인 " ":meth:`Document.ez_save` 가 있습니다 -- 아래를 참조하세요." #: ../../document.rst:1330 172936422e304f5b8fd9cfb2460b928b msgid "" "\"Lossy\" file size reduction in essence must give up something with " "respect to images, like (a) remove all images (b) replace images by their" " grayscale versions (c) reduce image resolutions. Find examples in the " "`PyMuPDF Utilities \"replace-image\" folder `_." msgstr "" "\"손실\" 파일 크기 감소는 본질적으로 이미지와 관련하여 무언가를 포기해야 합니다. 예: (a) 모든 이미지 제거 (b) 이미지를" " 그레이스케일 버전으로 교체 (c) 이미지 해상도 감소. 예제는 `PyMuPDF Utilities \"replace-image\" " "폴더 `_ 에서 찾을 수 있습니다." #: ../../document.rst:1334 a8c04ed4cd034b1b925922ea043a48c3 msgid "New in v1.18.11" msgstr "v1.18.11에서 새로 추가됨" #: ../../document.rst:1336 8b017c18d31e4b28b04550143d27f7a4 msgid "" "PDF only: The same as :meth:`Document.save` but with changed defaults " "`deflate=True, garbage=3, use_objstms=1`." msgstr "PDF 전용: :meth:`Document.save` 와 동일하지만 기본값이 `deflate=True, garbage=3, use_objstms=1` 로 변경되었습니다." #: ../../document.rst:1340 2c12cc4ba1bf4213b676b7b14fcb2141 msgid "" "PDF only: saves the document incrementally. This is a convenience " "abbreviation for ``doc.save(doc.name, incremental=True, " "encryption=PDF_ENCRYPT_KEEP)``." msgstr "PDF 전용: 문서를 증분적으로 저장합니다. ``doc.save(doc.name, incremental=True, encryption=PDF_ENCRYPT_KEEP)`` 의 편의 약어입니다." #: ../../document.rst:1344 4b41e922b391460dba7ebb7d4c02f035 msgid "" "Saving incrementally may be required if the document contains verified " "signatures which would be invalidated by saving to a new file." msgstr "문서에 검증된 서명이 포함되어 있는 경우 새 파일로 저장하면 무효화되므로 증분 저장이 필요할 수 있습니다." #: ../../document.rst:1353 bd79b7c8680c4e8191eee4f9cb511e92 msgid "" "PDF only: Writes the **current content of the document** to a bytes " "object instead of to a file. Obviously, you should be wary about memory " "requirements. The meanings of the parameters exactly equal those in " ":meth:`save`. Chapter :ref:`FAQ` contains an example for using this " "method as a pre-processor to `pdfrw " "`_." msgstr "PDF 전용: 문서의 **현재 콘텐츠** 를 파일 대신 bytes 객체에 씁니다. 명백히 메모리 요구 사항에 주의해야 합니다. 매개변수의 의미는 :meth:`save` 와 정확히 동일합니다. :ref:`FAQ` 장에는 이 메서드를 `pdfrw `_ 의 전처리기로 사용하는 예제가 포함되어 있습니다." #: ../../document.rst:1355 55f16e8ab0644d56bc5363e89919a50c msgid "*(Changed in v1.16.0)* for extended encryption support." msgstr "*(v1.16.0에서 변경됨)* 확장된 암호화 지원을 위해." #: ../../document.rst:1358 9f76330059a5422db75889fdc995f329 msgid "a bytes object containing the complete document." msgstr "전체 문서를 포함하는 bytes 객체." #: ../../document.rst:1362 7dd8b6e2ab094eab8120755191d01969 msgid "" "Search for \"text\" on page number \"pno\". Works exactly like the " "corresponding :meth:`Page.search_for`. Any integer `-∞ < pno < " "page_count` is acceptable." msgstr "페이지 번호 \"pno\" 에서 \"text\" 를 검색합니다. 해당 :meth:`Page.search_for` 와 정확히 동일하게 작동합니다. `-∞ < pno < page_count` 범위의 모든 정수가 허용됩니다." #: ../../document.rst:1380 43082a0a5f124b30970b917bb34650e5 msgid "" "PDF only: Copy the page range **[from_page, to_page]** (including both) " "of PDF document *docsrc* into the current one. Inserts will start with " "page number *start_at*. Value -1 indicates default values. All pages thus" " copied will be rotated as specified. Links, annotations and widgets can " "be excluded in the target, see below. All page numbers are 0-based." msgstr "PDF 전용: PDF 문서 *docsrc* 의 페이지 범위 **[from_page, to_page]** (둘 다 포함)를 현재 문서로 복사합니다. 삽입은 페이지 번호 *start_at* 에서 시작합니다. 값 -1은 기본값을 나타냅니다. 이렇게 복사된 모든 페이지는 지정된 대로 회전됩니다. 링크, 주석 및 위젯은 대상에서 제외할 수 있습니다. 아래를 참조하세요. 모든 페이지 번호는 0 기반입니다." #: ../../document.rst:1382 de74f0d7ddaa4321ba9b05f7e6782d7b msgid "" "An opened PDF *Document* which must not be the current document. However," " it may refer to the same underlying file." msgstr "현재 문서가 아니어야 하는 열린 PDF *Document*. 그러나 동일한 기본 파일을 참조할 수 있습니다." #: ../../document.rst:1385 5d8c2339c1ed44d3a9fd29b7eac353d5 msgid "First page number in *docsrc*. Default is zero." msgstr "*docsrc* 의 첫 번째 페이지 번호. 기본값은 0입니다." #: ../../document.rst:1387 b6f7dfe8073c4e1e93f59ad9c41b7a79 msgid "Last page number in *docsrc* to copy. Defaults to last page." msgstr "복사할 *docsrc* 의 마지막 페이지 번호. 기본값은 마지막 페이지입니다." #: ../../document.rst:1389 83d52f17fb0643119d37044f7ee4f12d msgid "" "First copied page, will become page number *start_at* in the target. " "Default -1 appends the page range to the end. If zero, the page range " "will be inserted before current first page." msgstr "첫 번째로 복사된 페이지는 대상에서 페이지 번호 *start_at* 이 됩니다. 기본값 -1은 페이지 범위를 끝에 추가합니다. 0이면 페이지 범위가 현재 첫 번째 페이지 앞에 삽입됩니다." #: ../../document.rst:1391 0ffa16d8a4b94f448bc2d8eefd7285f8 msgid "" "All copied pages will be rotated by the provided value (degrees, integer " "multiple of 90)." msgstr "복사된 모든 페이지는 제공된 값(도, 90의 정수 배수)만큼 회전됩니다." #: ../../document.rst:1393 a4ca40c2a8a14fe587100c9363d2c340 msgid "" "Choose whether (internal and external) links should be included in the " "copy. Default is `True`. *Named* links (:data:`LINK_NAMED`) and internal " "links to outside the copied page range are **always excluded**." msgstr "(내부 및 외부) 링크를 복사본에 포함할지 선택합니다. 기본값은 `True` 입니다. *명명된* 링크(:data:`LINK_NAMED`) 및 복사된 페이지 범위 외부로의 내부 링크는 **항상 제외됩니다**." #: ../../document.rst:1395 f7a2eb67861840798b4bcdaa41872471 msgid "choose whether annotations should be included in the copy." msgstr "주석을 복사본에 포함할지 선택합니다." #: ../../document.rst:1397 d2e9e86dbc054d8595d70da1e19eb60a msgid "" "choose whether annotations should be included in the copy. If `True` and " "at least one of the source pages contains form fields, the target PDF " "will be turned into a Form PDF (if not already being one)." msgstr "주석을 복사본에 포함할지 선택합니다. `True` 이고 소스 페이지 중 하나 이상에 양식 필드가 포함되어 있으면 대상 PDF가 Form PDF로 전환됩니다(아직 그렇지 않은 경우)." #: ../../document.rst:1399 a148422f862e4b318976a18499787dd1 msgid "" "*(New in version 1.25.5)* Choose how to handle duplicate root field names" " in the source pages. This parameter is ignored if `widgets=False`. " "Default is ``False`` which will add unifying strings to the name of those" " source root fields which have a duplicate in the target. For instance, " "if \"name\" already occurs in the target, the source widget's name will " "be changed to \"name [text]\" with a suitably chosen string \"text\". If" " ``True``, root fields with duplicate names in source and target will be " "converted to so-called \"Kids\" of a \"Parent\" object (which lists all " "kid widgets in a PDF array). This will effectively turn those kids into " "instances of the \"same\" widget: if e.g. one of the kids is changed, " "then all its instances will automatically inherit this change -- no " "matter on which page they happen to be displayed." msgstr "" #: ../../document.rst:1399 29fe39aa48044a5a87a3e46722e5dcc2 msgid "" "*(New in version 1.25.5)* Choose how to handle duplicate root field names" " in the source pages. This parameter is ignored if `widgets=False`." msgstr "*(버전 1.25.5에서 새로 추가됨)* 소스 페이지에서 중복된 루트 필드 이름을 처리하는 방법을 선택합니다. `widgets=False` 이면 이 매개변수는 무시됩니다." #: ../../document.rst:1401 529b0cbb3d354c4ca55021b991023c34 msgid "" "Default is ``False`` which will add unifying strings to the name of those" " source root fields which have a duplicate in the target. For instance, " "if \"name\" already occurs in the target, the source widget's name will " "be changed to \"name [text]\" with a suitably chosen string \"text\"." msgstr "기본값은 ``False`` 이며, 대상에 중복이 있는 소스 루트 필드의 이름에 통합 문자열을 추가합니다. 예를 들어 \"name\" 이 이미 대상에 있으면 소스 위젯의 이름이 적절히 선택된 문자열 \"text\" 와 함께 \"name [text]\" 로 변경됩니다." #: ../../document.rst:1403 ff97b1ac50a4459b81ac03121569ae66 msgid "" "If ``True``, root fields with duplicate names in source and target will " "be converted to so-called \"Kids\" of a \"Parent\" object (which lists " "all kid widgets in a PDF array). This will effectively turn those kids " "into instances of the \"same\" widget: if e.g. one of the kids is " "changed, then all its instances will automatically inherit this change --" " no matter on which page they happen to be displayed." msgstr "``True`` 인 경우 소스와 대상에 중복 이름이 있는 루트 필드는 \"Parent\" 객체의 소위 \"Kids\" 로 변환됩니다(PDF 배열에 모든 자식 위젯을 나열). 이것은 효과적으로 이러한 자식을 \"동일한\" 위젯의 인스턴스로 만듭니다: 예를 들어 자식 중 하나가 변경되면 모든 인스턴스가 자동으로 이 변경을 상속받습니다 -- 어떤 페이지에 표시되든 상관없이." #: ../../document.rst:1405 952c23aab20d49af9f19214ea9c24063 msgid "" "*(new in v1.17.7)* specify an interval size greater zero to see progress " "messages on `sys.stdout`. After each interval, a message like `Inserted " "30 of 47 pages.` will be printed." msgstr "*(v1.17.7에서 새로 추가됨)* `sys.stdout` 에 진행 메시지를 보려면 0보다 큰 간격 크기를 지정하세요. 각 간격 후에 `Inserted 30 of 47 pages.` 와 같은 메시지가 인쇄됩니다." #: ../../document.rst:1407 2ff6cf0ddbbf4801a6e1c4b587de1a46 msgid "" "*(new in v1.18.0)* controls whether the list of already copied objects " "should be **dropped** after this method, default ``True``. Set it to 0 " "except for the last one of multiple insertions from the same source PDF. " "This saves target file size and speeds up execution considerably." msgstr "" "*(v1.18.0에서 새로 추가됨)* 이미 복사된 객체 목록을 이 메서드 후에 **삭제** 할지 제어합니다. 기본값 " "``True``. 동일한 소스 PDF에서 여러 삽입의 마지막 항목을 제외하고는 0으로 설정하세요. 이것은 대상 파일 크기를 절약하고" " 실행 속도를 크게 향상시킵니다." #: ../../document.rst:1411 9372e5e0d8e041ac8259407781272ad0 msgid "" "This is a page-based method. Document-level information of source " "documents is therefore mostly ignored. Examples include Optional Content," " Embedded Files, `StructureElem`, table of contents, page labels, " "metadata, named destinations (and other named entries) and some more." msgstr "" "이것은 페이지 기반 메서드입니다. 따라서 소스 문서의 문서 수준 정보는 대부분 무시됩니다. 예로는 Optional Content, " "Embedded Files, `StructureElem`, 목차, 페이지 레이블, 메타데이터, 명명된 대상(및 기타 명명된 항목) " "등이 있습니다." #: ../../document.rst:1413 43f4211198a343f48f9021d6315262d3 msgid "" "If `from_page > to_page`, pages will be **copied in reverse order**. If " "`0 <= from_page == to_page`, then one page will be copied." msgstr "" "`from_page > to_page` 인 경우 페이지는 **역순으로 복사됩니다**. `0 <= from_page == " "to_page` 인 경우 한 페이지가 복사됩니다." #: ../../document.rst:1415 7cc285a8c29d43469d52cb1b3c81c8e3 msgid "" "`docsrc` TOC entries **will not be copied**. It is easy however, to " "recover a table of contents for the resulting document. Look at the " "examples below and at program `join.py `_ in the " "*examples* directory: it can join PDF documents and at the same time " "piece together respective parts of the tables of contents." msgstr "" "`docsrc` TOC 항목은 **복사되지 않습니다**. 그러나 결과 문서에 대한 목차를 복구하는 것은 쉽습니다. 아래 예제와 " "*examples* 디렉토리의 프로그램 `join.py `_ 을 참조하세요: PDF 문서를" " 결합하고 동시에 목차의 해당 부분을 함께 구성할 수 있습니다." #: ../../document.rst:1432 d2452152a5034a9ca2daefca1e0824cc msgid "New in v1.22.0" msgstr "v1.22.0에서 새로 추가됨" #: ../../document.rst:1434 7373f7c4857c46cf8292d68949ff4f6b msgid "" "PDF only: Add an arbitrary supported document to the current PDF. Opens " "\"infile\" as a document, converts it to a PDF and then invokes " ":meth:`Document.insert_pdf`. Parameters are the same as for that method. " "Among other things, this features an easy way to append images as full " "pages to an output PDF." msgstr "" "PDF 전용: 임의의 지원되는 문서를 현재 PDF에 추가합니다. \"infile\" 을 문서로 열고 PDF로 변환한 다음 " ":meth:`Document.insert_pdf` 를 호출합니다. 매개변수는 해당 메서드와 동일합니다. 특히 이것은 이미지를 전체 " "페이지로 출력 PDF에 추가하는 쉬운 방법을 제공합니다." #: ../../document.rst:1436 f479d2cec81c433ebe02aedeecb37264 msgid "" "the input document to insert. May be a filename specification as is valid" " for creating a :ref:`Document` or a :ref:`Pixmap`." msgstr "삽입할 입력 문서. :ref:`Document` 또는 :ref:`Pixmap` 생성에 유효한 파일명 지정일 수 있습니다." #: ../../document.rst:1445 8dcf3ea094984946a1ab40d0ac352086 msgid "PDF only: Insert an empty page." msgstr "PDF 전용: 빈 페이지를 삽입합니다." #: ../../document.rst:1447 00a8d07f6d82488a9575361ef2378659 msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and *doc.page_count* insert **after** the last page." msgstr "" "페이지를 삽입할 페이지 번호 인덱스(0 기반). 특수 값 -1 및 *doc.page_count* 는 마지막 페이지 **뒤에** " "삽입합니다." #: ../../document.rst:1449 3f3a9a8d80db4350b6aa231d7cc28695 msgid "page width." msgstr "페이지 너비." #: ../../document.rst:1450 7f73155629f24628a3c4e697f5a95326 msgid "page height." msgstr "페이지 높이." #: ../../document.rst:1453 f93d2c1aec874e60af37aecd88602571 msgid "" "the created page object. Be aware that the page numbers of pages after " "the inserted one will have changed after method execution. For the same " "reason, **all existing page objects will be invalidated.** Using them " "will lead to exceptions." msgstr "" "생성된 페이지 객체. 삽입된 페이지 이후의 페이지 번호는 메서드 실행 후 변경됩니다. 같은 이유로 **모든 기존 페이지 객체가 " "무효화됩니다.** 사용하면 예외가 발생합니다." #: ../../document.rst:1465 4fec146cb4a844ac8c297a57c50caac2 msgid "" "PDF only: Insert a new page and insert some text. Convenience function " "which combines :meth:`Document.new_page` and (parts of) " ":meth:`Page.insert_text`." msgstr "" "PDF 전용: 새 페이지를 삽입하고 일부 텍스트를 삽입합니다. :meth:`Document.new_page` 와 " ":meth:`Page.insert_text` (일부)를 결합한 편의 함수입니다." #: ../../document.rst:1467 e3181bddc05248ee94dcee0c6c40a956 msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and `doc.page_count` insert **after** the last page. Changed in " "v1.14.12 This is now a positional parameter" msgstr "" "" #: ../../document.rst:1467 bb201d9d3e05493ca05d394ffe6eb5be msgid "" "page number index (zero-indexed) at which to insert page. Special values " "-1 and `doc.page_count` insert **after** the last page." msgstr "" "페이지를 삽입할 페이지 번호 인덱스(0 기반). 특수 값 -1 및 `doc.page_count` 는 마지막 페이지 **뒤에** " "삽입합니다." #: ../../document.rst:1470 690c131f782848fabe1418ba0e89c425 msgid "Changed in v1.14.12" msgstr "v1.14.12에서 변경됨" #: ../../document.rst:1470 47247eda374945e2ad736398081742d3 msgid "This is now a positional parameter" msgstr "이것은 이제 위치 매개변수입니다" #: ../../document.rst:1472 b0c0975bac1c45d5994beda8b6775b5b msgid "For the other parameters, please consult the aforementioned methods." msgstr "다른 매개변수는 위에서 언급한 메서드를 참조하세요." #: ../../document.rst:1475 6d101fcbabdf43b0ac289c175ff53220 msgid "" "the result of :meth:`Page.insert_text` (number of successfully inserted " "lines)." msgstr ":meth:`Page.insert_text` 의 결과(성공적으로 삽입된 줄 수)." #: ../../document.rst:1479 ecc50b85f14241d2aa31343b5e5aa5f7 msgid "" "PDF only: Delete a page given by its 0-based number in `-∞ < pno < " "page_count`." msgstr "PDF 전용: `-∞ < pno < page_count` 범위의 0 기반 번호로 지정된 페이지를 삭제합니다." #: ../../document.rst:1481 ../../document.rst:1488 #: 3763d366c7114f2cb92215e4aa36dd9e f9dd271045134befa0cae7b4d29e2b19 msgid "Changed in v1.18.14: support Python's `del` statement." msgstr "v1.18.14에서 변경됨: Python의 `del` 문 지원." #: ../../document.rst:1483 edd90564c56a475480386e44c20c183f msgid "" "the page to be deleted. Negative number count backwards from the end of " "the document (like with indices). Default is the last page." msgstr "삭제할 페이지. 음수는 문서 끝에서 역순으로 계산합니다(인덱스와 같이). 기본값은 마지막 페이지입니다." #: ../../document.rst:1487 885178ede3f341d9977c12eeee0ce39a msgid "Changed in v1.18.13: more flexibility specifying pages to delete." msgstr "v1.18.13에서 변경됨: 삭제할 페이지 지정의 유연성 향상." #: ../../document.rst:1490 2faf9fc669694bf58fbd3fbda80d6a18 msgid "PDF only: Delete multiple pages given as 0-based numbers." msgstr "PDF 전용: 0 기반 번호로 지정된 여러 페이지를 삭제합니다." #: ../../document.rst:1494 49043c2a25724e858a719fcf64d92c54 msgid "" "**Format 1:** Use keywords. Represents the old format. A contiguous range" " of pages is removed." msgstr "**형식 1:** 키워드를 사용합니다. 이전 형식을 나타냅니다. 연속된 페이지 범위가 제거됩니다." #: ../../document.rst:1493 abdf0e27ad514fa4a0a49edfa8166fc0 msgid "\"from_page\": first page to delete. Zero if omitted." msgstr "\"from_page\": 삭제할 첫 페이지. 생략하면 0입니다." #: ../../document.rst:1494 272c0a7e9e844ab6925f9d42e326b8dd msgid "" "\"to_page\": last page to delete. Last page in document if omitted. Must " "not be less then \"from_page\"." msgstr "" "\"to_page\": 삭제할 마지막 페이지. 생략하면 문서의 마지막 페이지입니다. \"from_page\" 보다 작아서는 안 " "됩니다." #: ../../document.rst:1496 853ec2ac461141488a842564542b01ee msgid "" "**Format 2:** Two page numbers as positional parameters. Handled like " "Format 1." msgstr "**형식 2:** 위치 매개변수로 두 페이지 번호. 형식 1과 같이 처리됩니다." #: ../../document.rst:1498 d11ba0ed8b3448a1b9c698565e879a5c msgid "" "**Format 3:** One positional integer parameter. Equivalent to " ":meth:`Page.delete_page`." msgstr "**형식 3:** 하나의 위치 정수 매개변수. :meth:`Page.delete_page` 와 동일합니다." #: ../../document.rst:1500 0023d1389c764262bb87cf7faa1adc43 msgid "" "**Format 4:** One positional parameter of type *list*, *tuple* or " "*range()* of page numbers. The items of this sequence may be in any order" " and may contain duplicates." msgstr "" "**형식 4:** *list*, *tuple* 또는 *range()* 타입의 페이지 번호 하나의 위치 매개변수. 이 시퀀스의 항목은" " 어떤 순서든 될 수 있으며 중복을 포함할 수 있습니다." #: ../../document.rst:1502 3a616c07b63341aabad5be2aadd5b519 msgid "" "**Format 5:** *(New in v1.18.14)* Using the Python `del` statement and " "index / slice notation is now possible." msgstr "**형식 5:** *(v1.18.14에서 새로 추가됨)* Python `del` 문과 인덱스/슬라이스 표기법을 사용할 수 있습니다." #: ../../document.rst:1506 be81c094406043ae869d72a40ff136e0 msgid "" "*(Changed in v1.14.17, optimized in v1.17.7)* In an effort to maintain a " "valid PDF structure, this method and :meth:`delete_page` will also " "deactivate items in the table of contents which point to deleted pages. " "\"Deactivation\" here means, that the bookmark will point to nowhere and " "the title will be shown grayed-out by supporting PDF viewers. The overall" " TOC structure is left intact." msgstr "" "*(v1.14.17에서 변경됨, v1.17.7에서 최적화됨)* 유효한 PDF 구조를 유지하기 위해 이 메서드와 " ":meth:`delete_page` 는 삭제된 페이지를 가리키는 목차 항목도 비활성화합니다. 여기서 \"비활성화\"는 북마크가 아무" " 곳도 가리키지 않고 제목이 지원 PDF 뷰어에서 회색으로 표시됨을 의미합니다. 전체 TOC 구조는 그대로 유지됩니다." #: ../../document.rst:1508 d7fcfd0146d14359b986d22c70246218 msgid "" "It will also remove any **links on remaining pages** which point to a " "deleted one. This action may have an extended response time for documents" " with many pages." msgstr "" "삭제된 페이지를 가리키는 **남은 페이지의 모든 링크** 도 제거합니다. 이 작업은 많은 페이지가 있는 문서에서 응답 시간이 길어질" " 수 있습니다." #: ../../document.rst:1510 031b85dd387d4fa9ac92c6b66548733c msgid "Following examples will all delete pages 500 through 519:" msgstr "다음 예제는 모두 페이지 500부터 519까지 삭제합니다:" #: ../../document.rst:1512 cfe10a0a274d4d18adb6a3bd80a8c1eb msgid "`doc.delete_pages(500, 519)`" msgstr "`doc.delete_pages(500, 519)`" #: ../../document.rst:1513 3629419e0fec421e899e07854d3dee86 msgid "`doc.delete_pages(from_page=500, to_page=519)`" msgstr "`doc.delete_pages(from_page=500, to_page=519)`" #: ../../document.rst:1514 b99266396f9c4f729d682c6591e66fb7 msgid "`doc.delete_pages((500, 501, 502, ... , 519))`" msgstr "`doc.delete_pages((500, 501, 502, ... , 519))`" #: ../../document.rst:1515 7a5309be435b4725b98df7a5b13abd28 msgid "`doc.delete_pages(range(500, 520))`" msgstr "`doc.delete_pages(range(500, 520))`" #: ../../document.rst:1516 f81d6cadee344814b046eceef5c80d85 msgid "`del doc[500:520]`" msgstr "`del doc[500:520]`" #: ../../document.rst:1517 634d0eae36d4441f91c1a42e91f8628f msgid "`del doc[(500, 501, 502, ... , 519)]`" msgstr "`del doc[(500, 501, 502, ... , 519)]`" #: ../../document.rst:1518 fafab429d5424ce18f58f1ae4c8dbdfb msgid "`del doc[range(500, 520)]`" msgstr "`del doc[range(500, 520)]`" #: ../../document.rst:1520 e32e7365169c4fcb97e6fcce960a23d2 msgid "" "For the :ref:`AdobeManual` the above takes about 0.6 seconds, because the" " remaining 1290 pages must be cleaned from invalid links." msgstr "" ":ref:`AdobeManual` 의 경우 위 작업은 약 0.6초가 걸립니다. 남은 1290페이지에서 잘못된 링크를 정리해야 하기 " "때문입니다." #: ../../document.rst:1522 8cce67b3735c4db09b073f74c42ad5d6 msgid "" "In general, the performance of this method is dependent on the number of " "remaining pages -- **not** on the number of deleted pages: in the above " "example, **deleting all pages except** those 20, will need much less " "time." msgstr "" "일반적으로 이 메서드의 성능은 삭제된 페이지 수가 아니라 **남은 페이지 수** 에 따라 달라집니다: 위 예제에서 **그 20개를 " "제외한 모든 페이지를 삭제** 하면 훨씬 적은 시간이 필요합니다." #: ../../document.rst:1527 583a7be7f7604564b5aea9150f5f1a47 msgid "PDF only: Copy a page reference within the document." msgstr "PDF 전용: 문서 내에서 페이지 참조를 복사합니다." #: ../../document.rst:1529 796aa36a17194091986df564ff5cd031 msgid "the page to be copied. Must be in range `0 <= pno < page_count`." msgstr "복사할 페이지. `0 <= pno < page_count` 범위에 있어야 합니다." #: ../../document.rst:1531 ../../document.rst:1543 #: 35e41025040645fdb1331ee178e2d324 715bba4c474e466bafbb9855293c69d5 msgid "" "the page number in front of which to copy. The default inserts **after** " "the last page." msgstr "복사할 페이지 앞의 페이지 번호. 기본값은 마지막 페이지 **뒤에** 삽입합니다." #: ../../document.rst:1533 f3183958d7134dc7a00e4bfe56a78abb msgid "" "Only a new **reference** to the page object will be created -- not a new " "page object, all copied pages will have identical attribute values, " "including the :attr:`Page.xref`. This implies that any changes to one of " "these copies will appear on all of them." msgstr "페이지 객체에 대한 새 **참조** 만 생성됩니다 -- 새 페이지 객체가 아닙니다. 모든 복사된 페이지는 :attr:`Page.xref` 를 포함하여 동일한 속성 값을 가집니다. 이것은 이러한 복사본 중 하나에 대한 변경 사항이 모두에 나타남을 의미합니다." #: ../../document.rst:1537 4f81f7087616448e9a2079171720cc5e msgid "New in v1.14.17" msgstr "v1.14.17에서 새로 추가됨" #: ../../document.rst:1539 18edd22eb7b54b58973f27488646277d msgid "PDF only: Make a full copy (duplicate) of a page." msgstr "PDF 전용: 페이지의 전체 복사본(중복)을 만듭니다." #: ../../document.rst:1541 2be6a8a3c6254c419fffe87ecf3bea2e msgid "the page to be duplicated. Must be in range `0 <= pno < page_count`." msgstr "중복할 페이지. `0 <= pno < page_count` 범위에 있어야 합니다." #: ../../document.rst:1547 838d6b92f708488bb71ffb9c00ddf20e msgid "" "In contrast to :meth:`copy_page`, this method creates a new page object " "(with a new :data:`xref`), which can be changed independently from the " "original." msgstr ":meth:`copy_page` 와 달리 이 메서드는 원본과 독립적으로 변경할 수 있는 새 페이지 객체(새 :data:`xref` 포함)를 생성합니다." #: ../../document.rst:1549 bf6930ee99a14f56af7c4035128d0a3a msgid "" "Any Popup and \"IRT\" (\"in response to\") annotations are **not copied**" " to avoid potentially incorrect situations." msgstr "잠재적으로 잘못된 상황을 피하기 위해 모든 Popup 및 \"IRT\" (\"in response to\") 주석은 **복사되지 않습니다**." #: ../../document.rst:1553 03d410f070af4c8ab7946dea0b01ec41 msgid "PDF only: Move (copy and then delete original) a page within the document." msgstr "PDF 전용: 문서 내에서 페이지를 이동합니다(복사한 다음 원본 삭제)." #: ../../document.rst:1555 4d77ecb443e649f9940a25cfef2a0225 msgid "the page to be moved. Must be in range `0 <= pno < page_count`." msgstr "이동할 페이지. `0 <= pno < page_count` 범위에 있어야 합니다." #: ../../document.rst:1557 33c20380a2314d1fbb336bedbe0804b3 msgid "" "the page number in front of which to insert the moved page. The default " "moves **after** the last page." msgstr "이동된 페이지를 삽입할 페이지 번호 앞. 기본값은 마지막 페이지 **뒤로** 이동합니다." #: ../../document.rst:1562 e1e656e24f2d412588299042a89712e5 msgid "New in v1.17.4" msgstr "v1.17.4에서 새로 추가됨" #: ../../document.rst:1564 2c50544aa3ca445cb7e7196d1afe9710 msgid "" "PDF only: Get or set the */NeedAppearances* property of Form PDFs. Quote:" " *\"(Optional) A flag specifying whether to construct appearance streams " "and appearance dictionaries for all widget annotations in the document " "... Default value: false.\"* This may help controlling the behavior of " "some readers / viewers." msgstr "PDF 전용: Form PDF의 */NeedAppearances* 속성을 가져오거나 설정합니다. 인용: *\"(선택적) 문서의 모든 위젯 주석에 대한 appearance 스트림 및 appearance 딕셔너리를 구성할지 여부를 지정하는 플래그 ... 기본값: false.\"* 이것은 일부 리더/뷰어의 동작을 제어하는 데 도움이 될 수 있습니다." #: ../../document.rst:1566 b1652fd4ef124c6a9173defa2306862b msgid "" "set the property to this value. If omitted or `None`, inquire the current" " value." msgstr "속성을 이 값으로 설정합니다. 생략하거나 `None` 이면 현재 값을 조회합니다." #: ../../document.rst:1569 10db7e389c3443749906de632a038e80 msgid "" "* None: not a Form PDF, or property not defined. * True / False: the " "value of the property (either just set or existing for inquiries). Has no" " effect if no Form PDF." msgstr "" #: ../../document.rst:1570 20765c4d680e450db6d65401c2d563be msgid "None: not a Form PDF, or property not defined." msgstr "None: Form PDF가 아니거나 속성이 정의되지 않음." #: ../../document.rst:1571 34e43b74a8f24e9bbe54d44cf4d28ddf msgid "" "True / False: the value of the property (either just set or existing for " "inquiries). Has no effect if no Form PDF." msgstr "True / False: 속성의 값(방금 설정되었거나 조회를 위해 존재함). Form PDF가 없으면 효과가 없습니다." #: ../../document.rst:1577 cf26e7bb7e224490bc8cd693fdc457f9 msgid "" "PDF only: Return whether the document contains signature fields. This is " "an optional PDF property: if not present (return value -1), no " "conclusions can be drawn -- the PDF creator may just not have bothered " "using it." msgstr "PDF 전용: 문서에 서명 필드가 포함되어 있는지 반환합니다. 이것은 선택적 PDF 속성입니다: 없으면(반환 값 -1) 결론을 내릴 수 없습니다 -- PDF 작성자가 사용하지 않았을 수 있습니다." #: ../../document.rst:1580 6cc1ff6a8526438793161934c9c4b4e9 msgid "" "* -1: not a Form PDF / no signature fields recorded / no *SigFlags* " "found. * 1: at least one signature field exists. * 3: contains " "signatures that may be invalidated if the file is saved (written) in a " "way that alters its previous contents, as opposed to an incremental " "update." msgstr "" #: ../../document.rst:1581 49e77b466a9c4b8cae591da940e7bb80 msgid "-1: not a Form PDF / no signature fields recorded / no *SigFlags* found." msgstr "-1: Form PDF가 아님 / 기록된 서명 필드 없음 / *SigFlags* 없음." #: ../../document.rst:1582 3c2d9c0c66ac4186aabeb9505ef62861 msgid "1: at least one signature field exists." msgstr "1: 최소한 하나의 서명 필드가 존재함." #: ../../document.rst:1583 eba9fbffaa5f4a66baada0b97bab393c msgid "" "3: contains signatures that may be invalidated if the file is saved " "(written) in a way that alters its previous contents, as opposed to an " "incremental update." msgstr "3: 증분 업데이트와 달리 이전 콘텐츠를 변경하는 방식으로 파일이 저장(쓰기)되면 무효화될 수 있는 서명을 포함함." #: ../../document.rst:1592 4c7b6e1f922e4d48b1e2e0924cfcfbfb msgid "" "Changed in v1.14.16: The sequence of positional parameters \"name\" and " "\"buffer\" has been changed to comply with the call pattern of other " "functions." msgstr "v1.14.16에서 변경됨: 위치 매개변수 \"name\" 및 \"buffer\" 의 순서가 다른 함수의 호출 패턴을 준수하도록 변경되었습니다." #: ../../document.rst:1594 7bdd76ccfaa846f285fb18022d6c352b msgid "" "PDF only: Embed a new file. All string parameters except the name may be " "unicode (in previous versions, only ASCII worked correctly). File " "contents will be compressed (where beneficial)." msgstr "PDF 전용: 새 파일을 임베드합니다. 이름을 제외한 모든 문자열 매개변수는 유니코드일 수 있습니다(이전 버전에서는 ASCII만 올바르게 작동함). 파일 콘텐츠는 압축됩니다(유익한 경우)." #: ../../document.rst:1596 23a4029a12bf4c439ee7db0580ddba4b msgid "entry identifier, **must not already exist**." msgstr "항목 식별자, **이미 존재하지 않아야 합니다**." #: ../../document.rst:1597 617e80916a94448494c2f6a114b89372 msgid "" "file contents. *(Changed in v1.14.13)* *io.BytesIO* is now also " "supported." msgstr "" #: ../../document.rst:1597 3a52550a9c2e4f309e3ccbc749fc6821 msgid "file contents." msgstr "파일 콘텐츠." #: ../../document.rst:1599 ../../document.rst:1673 #: 3190704368d346e78d62a922fea40f03 80b30821875b4646a520a962f6d80271 msgid "*(Changed in v1.14.13)* *io.BytesIO* is now also supported." msgstr "*(v1.14.13에서 변경됨)* *io.BytesIO*도 이제 지원됩니다." #: ../../document.rst:1601 df2b2260b10b42a7838460af69e70ce1 msgid "optional filename. Documentation only, will be set to *name* if `None`." msgstr "선택적 파일 이름. 문서화 전용이며, `None` 이면 *name* 으로 설정됩니다." #: ../../document.rst:1602 7e6e3e037eac466f85a5b54dfc900de1 msgid "" "optional unicode filename. Documentation only, will be set to *filename* " "if `None`." msgstr "선택적 유니코드 파일 이름. 문서화 전용이며, `None` 이면 *filename* 으로 설정됩니다." #: ../../document.rst:1603 ec21943371c34b05a9a07bec862f7348 msgid "optional description. Documentation only, will be set to *name* if `None`." msgstr "선택적 설명. 문서화 전용이며, `None` 이면 *name* 으로 설정됩니다." #: ../../document.rst:1606 5c90aa58601f4e04b3a8163fe1b2379a msgid "" "*(Changed in v1.18.13)* The method now returns the :data:`xref` of the " "inserted file. In addition, the file object now will be automatically " "given the PDF keys `/CreationDate` and `/ModDate` based on the current " "date-time." msgstr "*(v1.18.13에서 변경됨)* 이 메서드는 이제 삽입된 파일의 :data:`xref` 를 반환합니다. 또한 파일 객체는 이제 현재 날짜-시간을 기반으로 PDF 키 `/CreationDate` 및 `/ModDate` 가 자동으로 지정됩니다." #: ../../document.rst:1611 f6b1d2e3c0d540b1b7de75e7fadb748e msgid "" "Changed in v1.14.16: This is now a method. In previous versions, this was" " a property." msgstr "v1.14.16에서 변경됨: 이것은 이제 메서드입니다. 이전 버전에서는 속성이었습니다." #: ../../document.rst:1613 8a7b9828613e4ae4990e91a063c9ee80 msgid "PDF only: Return the number of embedded files." msgstr "PDF 전용: 임베디드 파일 수를 반환합니다." #: ../../document.rst:1617 f19dbbc33b934e2896ad5cc8de4d62b0 msgid "" "PDF only: Retrieve the content of embedded file by its entry number or " "name. If the document is not a PDF, or entry cannot be found, an " "exception is raised." msgstr "" "PDF 전용: 항목 번호 또는 이름으로 임베디드 파일의 콘텐츠를 검색합니다. 문서가 PDF가 아니거나 항목을 찾을 수 없으면 예외가" " 발생합니다." #: ../../document.rst:1619 ../../document.rst:1639 ../../document.rst:1670 #: 0c7fcd8e7e744e80937883ac86d58ec6 1c77829d63c844a48200c5355ead955c #: 6688417b9a8e48749073861a1ef5545b msgid "index or name of entry. An integer must be in `range(embfile_count())`." msgstr "항목의 인덱스 또는 이름. 정수는 `range(embfile_count())` 에 있어야 합니다." #: ../../document.rst:1625 d328e7c757d5492f83a65070c10ccade msgid "Changed in v1.14.16: Items can now be deleted by index, too." msgstr "v1.14.16에서 변경됨: 항목을 인덱스로도 삭제할 수 있습니다." #: ../../document.rst:1627 3e3eef03b196484388e2abce6a21542f msgid "" "PDF only: Remove an entry from `/EmbeddedFiles`. As always, physical " "deletion of the embedded file content (and file space regain) will occur " "only when the document is saved to a new file with a suitable garbage " "option." msgstr "" "PDF 전용: `/EmbeddedFiles` 에서 항목을 제거합니다. 항상 그렇듯이 임베디드 파일 콘텐츠의 물리적 삭제(및 파일 " "공간 회수)는 적절한 가비지 옵션으로 문서를 새 파일로 저장할 때만 발생합니다." #: ../../document.rst:1629 082e792e3de04b1ab322c28b8099b497 msgid "index or name of entry." msgstr "항목의 인덱스 또는 이름." #: ../../document.rst:1631 68c79384328c43fba86792538c70c975 msgid "" "When specifying an entry name, this function will only **delete the first" " item** with that name. Be aware that PDFs not created with PyMuPDF may " "contain duplicate names. So you may want to take appropriate precautions." msgstr "" "항목 이름을 지정할 때 이 함수는 해당 이름을 가진 **첫 번째 항목만 삭제** 합니다. PyMuPDF로 생성되지 않은 PDF에는 " "중복 이름이 포함될 수 있습니다. 따라서 적절한 예방 조치를 취하는 것이 좋습니다." #: ../../document.rst:1635 cf8233c08ead4522b85da495804c1e6e msgid "Changed in v1.18.13" msgstr "v1.18.13에서 변경됨" #: ../../document.rst:1637 ba9d64f33b0446c6a66e20373f94567e msgid "" "PDF only: Retrieve information of an embedded file given by its number or" " by its name." msgstr "PDF 전용: 번호 또는 이름으로 지정된 임베디드 파일의 정보를 검색합니다." #: ../../document.rst:1642 3a582798a4d5409280f2874007ce4a1d msgid "" "a dictionary with the following keys: * ``name`` -- (*str*) name under " "which this entry is stored * ``filename`` -- (*str*) filename * " "``ufilename`` -- (*unicode*) filename * ``description`` -- (*str*) " "description * ``size`` -- (*int*) original file size * ``length`` -- " "(*int*) compressed file length * ``creationDate`` -- (*str*) date-time of" " item creation in PDF format * ``modDate`` -- (*str*) date-time of last " "change in PDF format * ``collection`` -- (*int*) :data:`xref` of the " "associated PDF portfolio item if any, else zero. * ``checksum`` -- " "(*str*) a hashcode of the stored file content as a hexadecimal string. " "Should be MD5 according to PDF specifications, but be prepared to see " "other hashing algorithms." msgstr "" #: ../../document.rst:1642 d35f32e42ce94abaa0187c2a807248f8 msgid "a dictionary with the following keys:" msgstr "다음 키를 가진 딕셔너리:" #: ../../document.rst:1644 e07b475b88d04c2f85be01b11e172b2a msgid "``name`` -- (*str*) name under which this entry is stored" msgstr "``name`` -- (*str*) 이 항목이 저장되는 이름" #: ../../document.rst:1645 ac0ae83d42ca4ae885a61ea6a32cee14 msgid "``filename`` -- (*str*) filename" msgstr "``filename`` -- (*str*) 파일명" #: ../../document.rst:1646 f6f77d03d7be41ccab1e1297bbb406da msgid "``ufilename`` -- (*unicode*) filename" msgstr "``ufilename`` -- (*unicode*) 파일명" #: ../../document.rst:1647 2e10f2dd4b4641cd92c4d4f6cbdaaa84 msgid "``description`` -- (*str*) description" msgstr "``description`` -- (*str*) 설명" #: ../../document.rst:1648 d99fc2985ce4404eb44a2dcac586736b msgid "``size`` -- (*int*) original file size" msgstr "``size`` -- (*int*) 원본 파일 크기" #: ../../document.rst:1649 0ece57be54c548e7bfe5429de67147a8 msgid "``length`` -- (*int*) compressed file length" msgstr "``length`` -- (*int*) 압축된 파일 길이" #: ../../document.rst:1650 542e3d29e1b048f287dd894589eff4ae msgid "``creationDate`` -- (*str*) date-time of item creation in PDF format" msgstr "``creationDate`` -- (*str*) PDF 형식의 항목 생성 날짜-시간" #: ../../document.rst:1651 7472dc1d5e2f48a487fab93a8b23b1cb msgid "``modDate`` -- (*str*) date-time of last change in PDF format" msgstr "``modDate`` -- (*str*) PDF 형식의 마지막 변경 날짜-시간" #: ../../document.rst:1652 d2937c070faf4a7483f304c35c4823e5 msgid "" "``collection`` -- (*int*) :data:`xref` of the associated PDF portfolio " "item if any, else zero." msgstr "``collection`` -- (*int*) 관련 PDF 포트폴리오 항목이 있으면 :data:`xref`, 그렇지 않으면 0." #: ../../document.rst:1653 445152fe6af241e8a193dbfb7712e713 msgid "" "``checksum`` -- (*str*) a hashcode of the stored file content as a " "hexadecimal string. Should be MD5 according to PDF specifications, but be" " prepared to see other hashing algorithms." msgstr "" "``checksum`` -- (*str*) 저장된 파일 콘텐츠의 해시코드를 16진수 문자열로. PDF 사양에 따르면 MD5여야 " "하지만 다른 해싱 알고리즘을 볼 수 있도록 준비하세요." #: ../../document.rst:1657 487c6a0fa0aa4e508875f0aa1e988e66 msgid "" "PDF only: Return a list of embedded file names. The sequence of the names" " equals the physical sequence in the document." msgstr "PDF 전용: 임베디드 파일 이름 목록을 반환합니다. 이름의 순서는 문서의 물리적 순서와 같습니다." #: ../../document.rst:1668 57edf8bf1f7d4045980a5b000df9dc96 msgid "" "PDF only: Change an embedded file given its entry number or name. All " "parameters are optional. Letting them default leads to a no-operation." msgstr "" "PDF 전용: 항목 번호 또는 이름으로 지정된 임베디드 파일을 변경합니다. 모든 매개변수는 선택적입니다. 기본값으로 두면 작업이 " "수행되지 않습니다." #: ../../document.rst:1671 6796cddb078c4d7f937285345d101367 msgid "" "the new file content. *(Changed in v1.14.13)* *io.BytesIO* is now also " "supported." msgstr "새 파일 콘텐츠. *(v1.14.13에서 변경됨)* *io.BytesIO* 도 이제 지원됩니다." #: ../../document.rst:1671 0f489bbc976d421f88323dc2c920648c msgid "the new file content." msgstr "새 파일 콘텐츠." #: ../../document.rst:1675 cbeeef5388e44bb69b3ed62d2ac39d77 msgid "the new filename." msgstr "새 파일명." #: ../../document.rst:1676 47ce01e0c6374d4d817de3d942010ace msgid "the new unicode filename." msgstr "새 유니코드 파일명." #: ../../document.rst:1677 df303b0998a548c2b292678b9add1a9f msgid "the new description." msgstr "새 설명." #: ../../document.rst:1679 572fcc87be1e4d93a0f5cbff844537a2 msgid "" "*(Changed in v1.18.13)* The method now returns the :data:`xref` of the " "file object." msgstr "*(v1.18.13에서 변경됨)* 이 메서드는 이제 파일 객체의 :data:`xref` 를 반환합니다." #: ../../document.rst:1682 266208e50f2048d39743307d29c7c4fa msgid "" "xref of the file object. Automatically, its `/ModDate` PDF key will be " "updated with the current date-time." msgstr "파일 객체의 xref. 자동으로 `/ModDate` PDF 키가 현재 날짜-시간으로 업데이트됩니다." #: ../../document.rst:1687 bbec30c1104c481282c889f264d8def1 msgid "" "Release objects and space allocations associated with the document. If " "created from a file, also closes *filename* (releasing control to the " "OS). Explicitly closing a document is equivalent to deleting it, `del " "doc`, or assigning it to something else like `doc = None`." msgstr "" "문서와 관련된 객체 및 공간 할당을 해제합니다. 파일에서 생성된 경우 *filename* 도 닫습니다(OS에 제어권 해제). 문서를" " 명시적으로 닫는 것은 삭제하는 것, `del doc`, 또는 `doc = None` 과 같이 다른 것으로 할당하는 것과 " "동일합니다." #: ../../document.rst:1691 ../../document.rst:1705 ../../document.rst:1712 #: ../../document.rst:1719 ../../document.rst:1730 ../../document.rst:1739 #: ../../document.rst:1888 247adcd852824bb58b2f946d80b664ca #: 39d0f5a0601d4c96817742c36b72172a 9030fef29e924c53b50ceba2911f2f80 #: be0981e9321b41c591dd8a531ac79cd2 bec9bb1abedd486cb4490cbd68d87c61 #: cfbb8fe0689848d6b77591b0178ee148 da6cafddda6341838772449a7a68e09a msgid "New in v1.16.8" msgstr "v1.16.8에서 새로 추가됨" #: ../../document.rst:1692 97583d3cb0be42099272c425aa4a8828 msgid "Changed in v1.18.10" msgstr "v1.18.10에서 변경됨" #: ../../document.rst:1694 3a4c6876a2844008ab4933d87266a75b msgid "PDF only: Return the definition source of a PDF object." msgstr "PDF 전용: PDF 객체의 정의 소스를 반환합니다." #: ../../document.rst:1696 3efa84c9b26a4a49b7014508567c633e msgid "" "the object's :data:`xref`. *Changed in v1.18.10:* A value of `-1` returns" " the PDF trailer source." msgstr "객체의 :data:`xref`. *v1.18.10에서 변경됨:* `-1` 값은 PDF 트레일러 소스를 반환합니다." #: ../../document.rst:1697 aaf4fbe6e19f49459a59afb370e7437b msgid "whether to generate a compact output with no line breaks or spaces." msgstr "줄 바꿈이나 공백 없이 압축된 출력을 생성할지 여부." #: ../../document.rst:1698 b0596a3700284e3699129ac3d0dffb85 msgid "whether to ASCII-encode binary data." msgstr "바이너리 데이터를 ASCII로 인코딩할지 여부." #: ../../document.rst:1701 527839cb652440c8b6583d8ab665ebbe msgid "The object definition source." msgstr "객체 정의 소스." #: ../../document.rst:1707 99c695fbaa8040d28c182ba8b33e3a80 msgid "" "PDF only: Return the :data:`xref` number of the PDF catalog (or root) " "object. Use that number with :meth:`Document.xref_object` to see its " "source." msgstr "" "PDF 전용: PDF 카탈로그(또는 루트) 객체의 :data:`xref` 번호를 반환합니다. 해당 번호를 " ":meth:`Document.xref_object` 와 함께 사용하여 소스를 확인하세요." #: ../../document.rst:1714 25496e4baa244786951e184999c6d563 msgid "" "PDF only: Return the trailer source of the PDF, which is usually located" " at the PDF file's end. This is :meth:`Document.xref_object` with an " ":data:`xref` argument of -1." msgstr "" "PDF 전용: PDF의 트레일러 소스를 반환합니다. 일반적으로 PDF 파일의 끝에 있습니다. 이것은 :data:`xref` 인수가 " "-1인 :meth:`Document.xref_object` 입니다." #: ../../document.rst:1721 4774099f88fd43d6b2aff5bf066476de msgid "" "PDF only: Return the **decompressed** contents of the :data:`xref` stream" " object." msgstr "PDF 전용: :data:`xref` 스트림 객체의 **압축 해제된** 콘텐츠를 반환합니다." #: ../../document.rst:1723 ../../document.rst:1743 ../../document.rst:1762 #: 61b36d6194a84f7080f16938dbc9891b 7476520cda4f4c27aeb545cf196b943c #: 9532ed01c59144319402fae983ecf5c8 msgid ":data:`xref` number." msgstr ":data:`xref` 번호." #: ../../document.rst:1726 6fc4c5e9e2f449559aeba47da28b65f9 msgid "the (decompressed) stream of the object." msgstr "객체의 (압축 해제된) 스트림." #: ../../document.rst:1732 9bc12dd4862043738d981a86c72cd4ef msgid "" "PDF only: Return the **unmodified** (esp. **not decompressed**) contents " "of the :data:`xref` stream object. Otherwise equal to " ":meth:`Document.xref_stream`." msgstr "" "PDF 전용: :data:`xref` 스트림 객체의 **수정되지 않은** (특히 **압축 해제되지 않은**) 콘텐츠를 반환합니다. " "그렇지 않으면 :meth:`Document.xref_stream` 과 동일합니다." #: ../../document.rst:1735 329eab98eb8a4879a9ade3b4cfc2ba8a msgid "the (original, unmodified) stream of the object." msgstr "객체의 (원본, 수정되지 않은) 스트림." #: ../../document.rst:1741 26685fb8b9594f2db148d7e0c3346e60 msgid "" "PDF only: Replace object definition of :data:`xref` with the provided " "string. The xref may also be new, in which case this instruction " "completes the object definition. If a page object is also given, its " "links and annotations will be reloaded afterwards." msgstr "" "PDF 전용: :data:`xref` 의 객체 정의를 제공된 문자열로 교체합니다. xref는 새 것일 수도 있으며, 이 경우 이 " "지시문이 객체 정의를 완료합니다. 페이지 객체도 제공되면 링크와 주석이 이후에 다시 로드됩니다." #: ../../document.rst:1745 e300685a43d14bc385137c3d5c28e8f3 msgid "a string containing a valid PDF object definition." msgstr "유효한 PDF 객체 정의를 포함하는 문자열." #: ../../document.rst:1747 2b7efd4811764da09018e7cc730abba0 msgid "" "a page object. If provided, indicates, that annotations of this page " "should be refreshed (reloaded) to reflect changes incurred with links and" " / or annotations." msgstr "" "페이지 객체. 제공되면 이 페이지의 주석이 링크 및/또는 주석으로 인한 변경 사항을 반영하도록 새로고침(다시 로드)되어야 함을 " "나타냅니다." #: ../../document.rst:1751 e24ddb8f85e0457d818f44d8481297fc msgid "zero if successful, otherwise an exception will be raised." msgstr "성공하면 0, 그렇지 않으면 예외가 발생합니다." #: ../../document.rst:1756 a88df4afdb3a40c4ac4c87338a6e030c msgid "New in v.1.16.8" msgstr "v.1.16.8에서 새로 추가됨" #: ../../document.rst:1757 65d49b625cd74c04ac3170a8db7d36c7 msgid "Changed in v1.19.2: added parameter \"compress\"" msgstr "v1.19.2에서 변경됨: 매개변수 \"compress\" 추가" #: ../../document.rst:1758 eddb5dc06f7740ffb519cd5af8611dbe msgid "" "Changed in v1.19.6: deprecated parameter \"new\". Now confirms that the " "object is a PDF dictionary object." msgstr "v1.19.6에서 변경됨: 매개변수 \"new\" 사용 중단. 이제 객체가 PDF 딕셔너리 객체임을 확인합니다." #: ../../document.rst:1760 caaeff35c6a34794a4e9ed38fe88e1cd msgid "" "Replace the stream of an object identified by :data:`xref`, which must be" " a PDF dictionary. If the object is no :data:`stream`, it will be turned " "into one. The function automatically performs a compress operation " "(\"deflate\") where beneficial." msgstr "" ":data:`xref` 로 식별된 객체의 스트림을 교체합니다. 이것은 PDF 딕셔너리여야 합니다. 객체가 :data:`stream`" " 이 아니면 하나로 변환됩니다. 함수는 유익한 경우 자동으로 압축 작업(\"deflate\")을 수행합니다." #: ../../document.rst:1764 f71966b2cb6448c58b0b7861d0b9ce0d msgid "" "the new content of the stream. *(Changed in v1.14.13:)* *io.BytesIO* " "objects are now also supported." msgstr "" #: ../../document.rst:1764 c0416641f4ba4bb1a8150bd111049103 msgid "the new content of the stream." msgstr "스트림의 새 콘텐츠." #: ../../document.rst:1766 579c642b3d194151be1211256a2514fd msgid "*(Changed in v1.14.13:)* *io.BytesIO* objects are now also supported." msgstr "*(v1.14.13에서 변경됨:)* *io.BytesIO* 객체도 이제 지원됩니다." #: ../../document.rst:1768 04840a0ca2d741ee8a068ce722449b8f msgid "*deprecated* and ignored. Will be removed some time after v1.20.0." msgstr "*사용 중단됨* 및 무시됨. v1.20.0 이후 어느 시점에 제거됩니다." #: ../../document.rst:1769 76eac7eea7cf45a8b748c1df0750fa6f msgid "" "whether to compress the inserted stream. If `True` (default), the stream " "will be inserted using `/FlateDecode` compression (if beneficial), " "otherwise the stream will inserted as is." msgstr "" "삽입된 스트림을 압축할지 여부. `True` (기본값)인 경우 스트림은 `/FlateDecode` 압축을 사용하여 삽입됩니다(유익한" " 경우). 그렇지 않으면 스트림이 있는 그대로 삽입됩니다." #: ../../document.rst:1771 1c65a4a1d1784a75a4bd385360830396 msgid "" "if :data:`xref` does not represent a PDF :data:`dict`. An empty " "dictionary ``<<>>`` is accepted. So if you just created the xref and want" " to give it a stream, first execute `doc.update_object(xref, \"<<>>\")`, " "and then insert the stream data with this method." msgstr "" ":data:`xref` 가 PDF :data:`dict` 를 나타내지 않는 경우. 빈 딕셔너리 ``<<>>`` 가 허용됩니다. " "따라서 xref를 방금 생성했고 스트림을 제공하려면 먼저 `doc.update_object(xref, \"<<>>\")` 를 실행한" " 다음 이 메서드로 스트림 데이터를 삽입하세요." #: ../../document.rst:1773 c32751ae2d804e89acfe0c201afa2bec msgid "" "The method is primarily (but not exclusively) intended to manipulate " "streams containing PDF operator syntax (see pp. 643 of the " ":ref:`AdobeManual`) as it is the case for e.g. page content streams." msgstr "" "이 메서드는 주로(하지만 독점적으로는 아님) PDF 연산자 구문을 포함하는 스트림을 조작하기 위한 것입니다(예: 페이지 콘텐츠 " "스트림의 경우 :ref:`AdobeManual` 643페이지 참조)." #: ../../document.rst:1775 70e15cf836934e74b7aced0a0a9657ea msgid "" "If you update a contents stream, consider using save parameter " "*clean=True* to ensure consistency between PDF operator source and the " "object structure." msgstr "" "콘텐츠 스트림을 업데이트하는 경우 PDF 연산자 소스와 객체 구조 간의 일관성을 보장하기 위해 저장 매개변수 *clean=True*" " 를 사용하는 것을 고려하세요." #: ../../document.rst:1777 66d2dc91f9a14d18b85327a558ec101b msgid "" "Example: Let us assume that you no longer want a certain image appear on " "a page. This can be achieved by deleting the respective reference in its " "contents source(s) -- and indeed: the image will be gone after reloading " "the page. But the page's :data:`resources` object would still show the " "image as being referenced by the page. This save option will clean up any" " such mismatches." msgstr "" "예: 특정 이미지가 더 이상 페이지에 나타나지 않기를 원한다고 가정합니다. 이것은 콘텐츠 소스에서 해당 참조를 삭제하여 달성할 수 " "있습니다 -- 실제로: 페이지를 다시 로드한 후 이미지는 사라집니다. 하지만 페이지의 :data:`resources` 객체는 여전히" " 이미지가 페이지에서 참조되는 것으로 표시됩니다. 이 저장 옵션은 이러한 불일치를 정리합니다." #: ../../document.rst:1782 101a91a1231a478c9fd1eab7abcf5d90 msgid "New in v1.19.5" msgstr "v1.19.5에서 새로 추가됨" #: ../../document.rst:1784 cf961e739e78442cb3749aa3d173aa55 msgid "" "PDF Only: Make ``target`` xref an exact copy of ``source``. If ``source``" " is a :data:`stream`, then this data is also copied." msgstr "" "PDF 전용: ``target`` xref를 ``source`` 의 정확한 복사본으로 만듭니다. ``source`` 가 " ":data:`stream` 인 경우 이 데이터도 복사됩니다." #: ../../document.rst:1786 fd753c7c6c994eeb9bc0ec1cdc4bad1d msgid "the source :data:`xref`. It must be an existing **dictionary** object." msgstr "소스 :data:`xref`. 기존 **딕셔너리** 객체여야 합니다." #: ../../document.rst:1787 18a7800d73384701aad4a34df34bdc06 msgid "" "the target xref. Must be an existing **dictionary** object. If the xref " "has just been created, make sure to initialize it as a PDF dictionary " "with the minimum specification ``<<>>``." msgstr "" "대상 xref. 기존 **딕셔너리** 객체여야 합니다. xref가 방금 생성된 경우 최소 사양 ``<<>>`` 로 PDF 딕셔너리로" " 초기화해야 합니다." #: ../../document.rst:1788 cbf0113ba5074e96904620888f4d4e9f msgid "" "an optional list of top-level keys in ``target``, that should not be " "removed in preparation of the copy process." msgstr "복사 프로세스 준비에서 제거되지 않아야 하는 ``target`` 의 최상위 키 선택적 목록." #: ../../document.rst:1792 46b874ab362c4632a7c39375f9efd612 msgid "This method has much in common with Python's *dict* method `copy()`." msgstr "이 메서드는 Python의 *dict* 메서드 `copy()` 와 많은 공통점이 있습니다." #: ../../document.rst:1793 8a33e87774c04f4ea90f5a5c2b58ce5c msgid "Both xref numbers must represent existing dictionaries." msgstr "두 xref 번호 모두 기존 딕셔너리를 나타내야 합니다." #: ../../document.rst:1794 d884bd5a35df416abe1dfbc33fe26bee msgid "" "Before data is copied from *source*, all *target* dictionary keys are " "deleted. You can specify exceptions from this in the ``keep`` list. If " "*source* however has a same-named key, its value will still replace the " "target." msgstr "" "*source* 에서 데이터가 복사되기 전에 모든 *target* 딕셔너리 키가 삭제됩니다. ``keep`` 목록에서 예외를 지정할" " 수 있습니다. 그러나 *source* 에 동일한 이름의 키가 있으면 해당 값이 여전히 대상을 교체합니다." #: ../../document.rst:1795 c32a67a043794307be9bb3c0035c2912 msgid "" "If ``source`` is a :data:`stream` object, then these data will also be " "copied over, and ``target`` will be converted to a stream object." msgstr "``source`` 가 :data:`stream` 객체인 경우 이 데이터도 복사되고 ``target`` 은 스트림 객체로 변환됩니다." #: ../../document.rst:1796 5b21ae7a30e54f9ca542bf49a4e969e7 msgid "" "A typical use case is to replace or remove an existing image without " "using redaction annotations. Example scripts can be seen `in this PyMuPDF" " Utilities example `_." msgstr "" "일반적인 사용 사례는 수정 주석을 사용하지 않고 기존 이미지를 교체하거나 제거하는 것입니다. 예제 스크립트는 `이 PyMuPDF " "Utilities 예제 `_ 에서 볼 수 있습니다." #: ../../document.rst:1800 1c92b07b6ad24acdbc3e9de705ca6bea msgid "" "PDF Only: Extract data and meta information of an image stored in the " "document. The output can directly be used to be stored as an image file, " "as input for PIL, :ref:`Pixmap` creation, etc. This method avoids using " "pixmaps wherever possible to present the image in its original format " "(e.g. as JPEG)." msgstr "" "PDF 전용: 문서에 저장된 이미지의 데이터 및 메타 정보를 추출합니다. 출력은 이미지 파일로 저장하거나 PIL, " ":ref:`Pixmap` 생성 등의 입력으로 직접 사용할 수 있습니다. 이 메서드는 가능한 한 pixmap 사용을 피하여 원본 " "형식(예: JPEG)으로 이미지를 표시합니다." #: ../../document.rst:1802 6f93bf4e0d6940f9b39148633ccb02b8 msgid "" ":data:`xref` of an image object. If this is not in `range(1, " "doc.xref_length())`, or the object is no image or other errors occur, " "`None` is returned and no exception is raised." msgstr "" "이미지 객체의 :data:`xref`. 이것이 `range(1, doc.xref_length())` 에 없거나 객체가 이미지가 " "아니거나 다른 오류가 발생하면 `None` 이 반환되고 예외가 발생하지 않습니다." #: ../../document.rst:1805 da816c3d1bbd4aa08e6d2b71245c5339 msgid "" "a dictionary with the following keys * *ext* (*str*) image type (e.g. " "*'jpeg'*), usable as image file extension * *smask* (*int*) :data:`xref` " "number of a stencil (/SMask) image or zero * ``width`` (*int*) image " "width * ``height`` (*int*) image height * *colorspace* (*int*) the " "image's *colorspace.n* number. * *cs-name* (*str*) the image's " "*colorspace.name*. * *xres* (*int*) resolution in x direction. Please " "also see :data:`resolution`. * *yres* (*int*) resolution in y direction. " "Please also see :data:`resolution`. * *image* (*bytes*) image data, " "usable as image file content" msgstr "" #: ../../document.rst:1805 ef447359490d4e5c91399ec554127f12 msgid "a dictionary with the following keys" msgstr "다음 키를 가진 딕셔너리" #: ../../document.rst:1807 2fd5ae6c09e841e9a37e9f7d00594fcc msgid "*ext* (*str*) image type (e.g. *'jpeg'*), usable as image file extension" msgstr "*ext* (*str*) 이미지 타입(예: *'jpeg'*), 이미지 파일 확장자로 사용 가능" #: ../../document.rst:1808 402f7ddd2b5942e7810d7db81101f1bf msgid "*smask* (*int*) :data:`xref` number of a stencil (/SMask) image or zero" msgstr "*smask* (*int*) 스텐실(/SMask) 이미지의 :data:`xref` 번호 또는 0" #: ../../document.rst:1809 b4db1fa6c02c4c8b80b28aa8624cf4e0 msgid "``width`` (*int*) image width" msgstr "``width`` (*int*) 이미지 너비" #: ../../document.rst:1810 f7b7383e8f814a7194b652803c9845a2 msgid "``height`` (*int*) image height" msgstr "``height`` (*int*) 이미지 높이" #: ../../document.rst:1811 9e360b497ea1447daa86fdd4699adf13 msgid "*colorspace* (*int*) the image's *colorspace.n* number." msgstr "*colorspace* (*int*) 이미지의 *colorspace.n* 번호." #: ../../document.rst:1812 abc5b215c0e6488e8744dcacf7a1c90e msgid "*cs-name* (*str*) the image's *colorspace.name*." msgstr "" #: ../../document.rst:1813 458f54a3d150486db1d2170b249014f4 msgid "" "*xres* (*int*) resolution in x direction. Please also see " ":data:`resolution`." msgstr "" #: ../../document.rst:1814 348d1155299f44ba94d846f7a65184e9 msgid "" "*yres* (*int*) resolution in y direction. Please also see " ":data:`resolution`." msgstr "" #: ../../document.rst:1815 acf6f71949524192988704580634da36 msgid "*image* (*bytes*) image data, usable as image file content" msgstr "*image* (*bytes*) 이미지 파일 콘텐츠로 사용 가능한 이미지 데이터" #: ../../document.rst:1827 446e0551034642d5ab3cb8ab7b4ad447 msgid "" "There is a functional overlap with *pix = pymupdf.Pixmap(doc, xref)*, " "followed by a *pix.tobytes()*. Main differences are that extract_image, " "**(1)** does not always deliver PNG image formats, **(2)** is **very** " "much faster with non-PNG images, **(3)** usually results in much less " "disk storage for extracted images, **(4)** returns `None` in error cases " "(generates no exception). Look at the following example images within the" " same PDF." msgstr "" "*pix = pymupdf.Pixmap(doc, xref)* 다음에 *pix.tobytes()* 를 사용하는 것과 기능적으로 겹칩니다. 주요 차이점은 extract_image가 " "**(1)** 항상 PNG 이미지 형식을 제공하지 않으며, **(2)** 비 PNG 이미지에서 **매우** 빠르고, **(3)** 추출된 이미지에 대해 " "일반적으로 훨씬 적은 디스크 저장 공간을 사용하며, **(4)** 오류 경우에 `None` 을 반환한다는 것입니다(예외를 생성하지 않음). 동일한 PDF 내의 " "다음 예제 이미지를 참조하세요." #: ../../document.rst:1829 a8bc35850faa4346bb55fc7684776232 msgid "xref 1268 is a PNG -- Comparable execution time and identical output::" msgstr "xref 1268은 PNG입니다 -- 비교 가능한 실행 시간 및 동일한 출력::" #: ../../document.rst:1841 867df59d1f90424092d7c31b14755ab5 msgid "" "xref 1186 is a JPEG -- :meth:`Document.extract_image` is **many times " "faster** and produces a **much smaller** output (2.48 MB vs. 0.35 MB)::" msgstr "" "xref 1186은 JPEG입니다 -- :meth:`Document.extract_image` 는 **여러 배 빠르며** **훨씬 작은** 출력을 생성합니다(2.48 MB vs. 0.35 MB)::" #: ../../document.rst:1856 e236c029a3ea49058156a22bdd86f213 msgid "Changed in v1.19.4: return a dictionary if `named == True`." msgstr "v1.19.4에서 변경됨: `named == True` 이면 딕셔너리를 반환합니다." #: ../../document.rst:1858 20899e634db84dc9930c742969c15306 msgid "" "PDF Only: Return an embedded font file's data and appropriate file " "extension. This can be used to store the font as an external file. The " "method does not throw exceptions (other than via checking for PDF and " "valid :data:`xref`)." msgstr "" "PDF 전용: 임베디드 폰트 파일의 데이터와 적절한 파일 확장자를 반환합니다. 이것은 폰트를 외부 파일로 저장하는 데 사용할 수 있습니다. 이 " "메서드는 예외를 발생시키지 않습니다(PDF 및 유효한 :data:`xref` 확인을 통한 경우 제외)." #: ../../document.rst:1860 d7c4c48a28a9455680ecffcf20495b1c msgid "PDF object number of the font to extract." msgstr "추출할 폰트의 PDF 객체 번호." #: ../../document.rst:1861 77c4185b821f4d71a7dee301908b579b msgid "" "only return font information, not the buffer. To be used for information-" "only purposes, avoids allocation of large buffer areas." msgstr "" "버퍼가 아닌 폰트 정보만 반환합니다. 정보 전용 목적으로 사용되며, 큰 버퍼 영역 할당을 피합니다." #: ../../document.rst:1862 923895cfb0bf425c8677eed1f5f9a100 msgid "" "If true, a dictionary with the following keys is returned: 'name' (font " "base name), 'ext' (font file extension), 'type' (font type), 'content' " "(font file content)." msgstr "" "true인 경우 다음 키를 가진 딕셔너리가 반환됩니다: 'name'(폰트 기본 이름), 'ext'(폰트 파일 확장자), 'type'(폰트 타입), 'content'(폰트 파일 내용)." #: ../../document.rst:1865 d8c2131db2594d699ecf78d17fc1db47 msgid "" "a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte " "suggested file extension (*str*), *basename* is the font's name (*str*), " "*type* is the font's type (e.g. \"Type1\") and *content* is a bytes " "object containing the font file's content (or *b\"\"*). For possible " "extension values and their meaning see :ref:`FontExtensions`. Return " "details on error: * `(\"\", \"\", \"\", b\"\")` -- invalid xref or xref " "is not a (valid) font object. * `(basename, \"n/a\", \"Type1\", b\"\")` " "-- *basename* is not embedded and thus cannot be extracted. This is the " "case for e.g. the :ref:`Base-14-Fonts` and Type 3 fonts." msgstr "" #: ../../document.rst:1865 4b10129dd3f94faabfbdc2cf2806ae66 msgid "" "a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte " "suggested file extension (*str*), *basename* is the font's name (*str*), " "*type* is the font's type (e.g. \"Type1\") and *content* is a bytes " "object containing the font file's content (or *b\"\"*). For possible " "extension values and their meaning see :ref:`FontExtensions`. Return " "details on error:" msgstr "" "튜플 `(basename, ext, type, content)` 로, 여기서 *ext* 는 3바이트 제안 파일 확장자(*str*), *basename* 는 폰트 이름(*str*), " "*type* 는 폰트 타입(예: \"Type1\"), *content* 는 폰트 파일 내용(또는 *b\"\"*)을 포함하는 bytes 객체입니다. 가능한 " "확장자 값과 의미는 :ref:`FontExtensions` 를 참조하세요. 오류 시 반환 세부 사항:" #: ../../document.rst:1867 d0cf0693516747a0926d8c334fbf3b49 msgid "" "`(\"\", \"\", \"\", b\"\")` -- invalid xref or xref is not a (valid) font" " object." msgstr "" "`(\"\", \"\", \"\", b\"\")` -- 유효하지 않은 xref 또는 xref가 (유효한) 폰트 객체가 아님." #: ../../document.rst:1868 ccf11cf787d44c158c7b4125324789cc msgid "" "`(basename, \"n/a\", \"Type1\", b\"\")` -- *basename* is not embedded and" " thus cannot be extracted. This is the case for e.g. the " ":ref:`Base-14-Fonts` and Type 3 fonts." msgstr "" "`(basename, \"n/a\", \"Type1\", b\"\")` -- *basename* 이 임베디드되지 않아 추출할 수 없음. 예를 들어 " ":ref:`Base-14-Fonts` 및 Type 3 폰트의 경우입니다." #: ../../document.rst:1870 a82028b2f0544a189cb8c0f7b5c3cc92 msgid "Example:" msgstr "예제:" #: ../../document.rst:1879 7435e3ad508d4986a5f8845543e7e0df msgid "" "The basename is returned unchanged from the PDF. So it may contain " "characters (such as blanks) which may disqualify it as a filename for " "your operating system. Take appropriate action." msgstr "" "basename은 PDF에서 변경되지 않은 채로 반환됩니다. 따라서 운영 체제의 파일명으로 사용하기에 부적합한 문자(예: 공백)가 포함될 수 있습니다. 적절한 조치를 취하세요." #: ../../document.rst:1882 35897c9f8dc5431792eeabe5cfe081ed msgid "" "The returned *basename* in general is **not** the original file name, but" " it probably has some similarity." msgstr "" "반환된 *basename* 은 일반적으로 원본 파일 이름이 **아니지만** 일부 유사성이 있을 수 있습니다." #: ../../document.rst:1883 576b38dabe894ac781dc4e26c56c5fbc #, python-brace-format msgid "" "If parameter `named == True`, a dictionary with the following keys is " "returned: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': " "b''}`." msgstr "" "매개변수 `named == True` 인 경우 다음 키를 가진 딕셔너리가 반환됩니다: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': " "b''}`." #: ../../document.rst:1890 cfbc337f74774c9e873b301a3cadb5af msgid "PDF only: Return the :data:`xref` of the document's XML metadata." msgstr "PDF 전용: 문서의 XML 메타데이터의 :data:`xref` 를 반환합니다." #: ../../document.rst:1899 0e955bcdf14d4dbcb8657f98cd3631f4 msgid "" "PDF only: Check whether there are links, resp. annotations anywhere in " "the document." msgstr "" "PDF 전용: 문서 어디에든 링크 또는 주석이 있는지 확인합니다." #: ../../document.rst:1901 ddc5e688329046928b55eaea1db04902 msgid "" "``True`` / ``False``. As opposed to fields, which are also stored in a " "central place of a PDF document, the existence of links / annotations can" " only be detected by parsing each page. These methods are tuned to do " "this efficiently and will immediately return, if the answer is ``True`` " "for a page. For PDFs with many thousand pages however, an answer may take" " some time [#f6]_ if no link, resp. no annotation is found." msgstr "" "``True`` / ``False``. PDF 문서의 중앙 위치에 저장되는 필드와 달리, 링크/주석의 존재는 각 페이지를 구문 분석해야만 감지할 수 있습니다. " "이 메서드들은 이를 효율적으로 수행하도록 조정되었으며, 페이지에 대한 답변이 ``True`` 이면 즉시 반환합니다. 그러나 수천 페이지가 있는 PDF의 경우, " "링크 또는 주석이 발견되지 않으면 답변에 시간이 걸릴 수 있습니다 [#f6]_." #: ../../document.rst:1906 ca08446597a942dfb0c8419c0295e50b msgid "" "PDF only: Investigate eligible fonts for their use by text in the " "document. If a font is supported and a size reduction is possible, that " "font is replaced by a version with a subset of its characters." msgstr "" "PDF 전용: 문서의 텍스트에서 사용되는 적격 폰트를 조사합니다. 폰트가 지원되고 크기 축소가 가능한 경우, 해당 폰트는 문자 서브셋을 가진 버전으로 대체됩니다." #: ../../document.rst:1908 0a1f089883924faa89e7e8840f138d99 msgid "Use this method immediately before saving the document." msgstr "문서를 저장하기 직전에 이 메서드를 사용하세요." #: ../../document.rst:1910 8000c8e5ca0e4393b5619405bc73211d msgid "" "write various progress information to sysout. This currently only has an " "effect if `fallback` is `True`." msgstr "" "다양한 진행 정보를 sysout에 기록합니다. 현재는 `fallback` 이 `True` 인 경우에만 효과가 있습니다." #: ../../document.rst:1911 125f3a0b0abe4f5395592a60330670e0 msgid "" "if `True` use the deprecated algorithm that makes use of package " "`fontTools `_ (which hence must be " "installed). If using the recommended value `False` (default), MuPDF's " "native function is used -- which is **very much faster** and can subset a" " broader range of font types. Package fontTools is not required then." msgstr "" "`True` 인 경우 패키지 `fontTools `_ 를 사용하는 더 이상 사용되지 않는 알고리즘을 사용합니다(따라서 설치되어 있어야 함). 권장 값 `False` (기본값)를 사용하는 경우 MuPDF의 네이티브 함수가 사용됩니다 -- 이것은 **훨씬 빠르며** 더 넓은 범위의 폰트 타입을 서브셋할 수 있습니다. 이 경우 fontTools 패키지가 필요하지 않습니다." #: ../../document.rst:1913 00bacf13890641b88f6f1ad99aff3a06 msgid "" "The greatest benefit can be achieved when creating new PDFs using large " "fonts like is typical for Asian scripts. When using the :ref:`Story` " "class or method :meth:`Page.insert_htmlbox`, multiple fonts may " "automatically be included -- without the programmer becoming aware of it." msgstr "" "아시아 스크립트에 일반적인 것처럼 큰 폰트를 사용하여 새 PDF를 생성할 때 가장 큰 이점을 얻을 수 있습니다. :ref:`Story` 클래스 또는 " ":meth:`Page.insert_htmlbox` 메서드를 사용할 때 여러 폰트가 자동으로 포함될 수 있습니다 -- 프로그래머가 인지하지 못한 채로." #: ../../document.rst:1915 d006a2c3965b4769813d244db91fd2e1 msgid "" "In all these cases, the set of actually used unicodes mostly is very " "small compared to the number of glyphs available in the used fonts. Using" " this method can easily reduce the embedded font binaries by two orders " "of magnitude -- from several megabytes down to a low two-digit kilobyte " "amount." msgstr "" "이러한 모든 경우에서 실제로 사용되는 유니코드 집합은 사용된 폰트에서 사용 가능한 글리프 수에 비해 대부분 매우 작습니다. 이 " "메서드를 사용하면 임베디드 폰트 바이너리를 두 자릿수 크기로 쉽게 줄일 수 있습니다 -- 수 메가바이트에서 낮은 두 자릿수 킬로바이트 " "양으로." #: ../../document.rst:1917 b2b33791b196412e97c3bd6e588482ab msgid "" "Creating font subsets leaves behind a large number of large, now unused " "PDF objects (\"ghosts\"). Therefore, make sure to compress and garbage-" "collect when saving the file. We recommend to use " ":meth:`Document.ez_save`." msgstr "" "폰트 서브셋을 만들면 많은 수의 큰, 이제 사용되지 않는 PDF 객체(\"고스트\")가 남습니다. 따라서 파일을 저장할 때 압축 및" " 가비지 수집을 수행하세요. :meth:`Document.ez_save` 사용을 권장합니다." #: ../../document.rst:1919 328408f7e8dd4fa7bfd094bfd96b99e3 msgid "|history_begin|" msgstr "|history_begin|" #: ../../document.rst:1922 798460dece6a4ad7886988b394a392f5 msgid "Changed in v1.18.9" msgstr "v1.18.9에서 변경됨" #: ../../document.rst:1923 ffb32b88708c47bc9a917650930b7177 msgid "Changed in v1.24.2 use native function of MuPDF." msgstr "v1.24.2에서 변경됨: MuPDF의 네이티브 함수 사용." #: ../../document.rst:1925 8a922608125342a7a0fe043997b5731e msgid "|history_end|" msgstr "|history_end|" #: ../../document.rst:1930 ../../document.rst:1936 ../../document.rst:1943 #: ../../document.rst:1950 ../../document.rst:1959 ../../document.rst:1966 #: ../../document.rst:1975 ../../document.rst:1982 ../../document.rst:1989 #: ../../document.rst:1998 ../../document.rst:2007 #: 2a53866190fe49559ea59107b2ab1ed6 70e42b1a98334fe9afab934648d37034 #: 84ed6cfe188e451ea6f51ecbffac4e7c 917af123d7974a3c8f94f8f458b3e7ce #: 91d2e3633a1041c8a9ecce6b3586bd37 bcbe3a3d5ae54bf2a3ae7b756710592a #: c5666e0424794a9e82f95bec34fa5e5f ccf2561788a34c0ca38f05ccaf1e22fb #: d2fd99018af4450c8ddff8e687633ae0 e919e0a4ef3f4060b9740167dd44e394 #: f353da33d40e46b5ac39ddff1425ba1c msgid "New in v1.19.0" msgstr "v1.19.0에서 새로 추가됨" #: ../../document.rst:1932 6ee29bc23b4d48a79a8c43170676e1eb msgid "" "PDF only: Enable journalling. Use this before you start logging " "operations." msgstr "PDF 전용: 저널링을 활성화합니다. 로깅 작업을 시작하기 전에 이것을 사용하세요." #: ../../document.rst:1938 7d210c47aaa9496797b08af90a645eed msgid "" "PDF only: Start journalling an *\"operation\"* identified by a string " "\"name\". Updates will fail for a journal-enabled PDF, if no operation " "has been started." msgstr "" "PDF 전용: 문자열 \"name\" 으로 식별되는 *\"작업\"* 의 저널링을 시작합니다. 작업이 시작되지 않으면 저널이 활성화된" " PDF에 대한 업데이트가 실패합니다." #: ../../document.rst:1945 66626f215b2042f59d57c01bc5bc9d9c msgid "" "PDF only: Stop the current operation. The updates between start and stop " "of an operation belong to the same unit of work and will be undone / " "redone together." msgstr "" "PDF 전용: 현재 작업을 중지합니다. 작업의 시작과 중지 사이의 업데이트는 동일한 작업 단위에 속하며 함께 실행 취소/다시 " "실행됩니다." #: ../../document.rst:1952 1a9a7a8aa18c4fe18b9dc769ee6af41b msgid "" "PDF only: Return the numbers of the current operation and the total " "operation count." msgstr "PDF 전용: 현재 작업 번호와 총 작업 수를 반환합니다." #: ../../document.rst:1954 a68f9e659a834894b7ae26a288e36c6a msgid "" "a tuple `(step, steps)` containing the current operation number and the " "total number of operations in the journal. If **step** is 0, we are at " "the top of the journal. If **step** equals **steps**, we are at the " "bottom. Updating the PDF with anything other than undo or redo will " "automatically remove all journal entries after the current one and the " "new update will become the new last entry in the journal. The updates " "corresponding to the removed journal entries will be permanently lost." msgstr "" "현재 작업 번호와 저널의 총 작업 수를 포함하는 튜플 `(step, steps)`. **step** 이 0이면 저널의 맨 위에 " "있습니다. **step** 이 **steps** 와 같으면 맨 아래에 있습니다. 실행 취소 또는 다시 실행 이외의 것으로 PDF를 " "업데이트하면 현재 항목 이후의 모든 저널 항목이 자동으로 제거되고 새 업데이트가 저널의 새 마지막 항목이 됩니다. 제거된 저널 " "항목에 해당하는 업데이트는 영구적으로 손실됩니다." #: ../../document.rst:1961 70b630f906a14f6ba6e8d2f1b63d80bb msgid "PDF only: Return the name of operation number *step.*" msgstr "PDF 전용: 작업 번호 *step.* 의 이름을 반환합니다." #: ../../document.rst:1968 c18d1d246dd349ab8f2fae9bdbcd7f6a msgid "" "PDF only: Show whether forward (\"redo\") and / or backward (\"undo\") " "executions are possible from the current journal position." msgstr "PDF 전용: 현재 저널 위치에서 앞으로(\"redo\") 및/또는 뒤로(\"undo\") 실행이 가능한지 표시합니다." #: ../../document.rst:1970 026f194ecdb44484a5a846457b3bebec #, python-brace-format msgid "" "a dictionary `{\"undo\": bool, \"redo\": bool}`. The respective method is" " available if its value is `True`." msgstr "" "딕셔너리 `{\"undo\": bool, \"redo\": bool}`. 해당 메서드는 값이 `True` 인 경우 사용할 수 " "있습니다." #: ../../document.rst:1977 2a24feb018f8432f91aee80e633040d5 msgid "" "PDF only: Revert (undo) the current step in the journal. This moves " "towards the journal's top." msgstr "PDF 전용: 저널의 현재 단계를 되돌립니다(실행 취소). 이것은 저널의 맨 위로 이동합니다." #: ../../document.rst:1984 b8f7aceb49744cb2bb1844ac639ad01c msgid "" "PDF only: Re-apply (redo) the current step in the journal. This moves " "towards the journal's bottom." msgstr "PDF 전용: 저널의 현재 단계를 다시 적용합니다(다시 실행). 이것은 저널의 맨 아래로 이동합니다." #: ../../document.rst:1991 f05f714420554ee9bee4aaf8a9fb46fa msgid "PDF only: Save the journal to a file." msgstr "PDF 전용: 저널을 파일로 저장합니다." #: ../../document.rst:1993 b9888536d6c84d89852aab0d7219a4d4 msgid "" "either a filename as string or a file object opened as \"wb\" (or an " "`io.BytesIO()` object)." msgstr "문자열로 된 파일명 또는 \"wb\" 로 열린 파일 객체(또는 `io.BytesIO()` 객체)." #: ../../document.rst:2000 0c0590abc65e46cda73b5408c9144c3e msgid "" "PDF only: Load journal from a file. Enables journalling for the document." " If journalling is already enabled, an exception is raised." msgstr "PDF 전용: 파일에서 저널을 로드합니다. 문서에 대한 저널링을 활성화합니다. 저널링이 이미 활성화된 경우 예외가 발생합니다." #: ../../document.rst:2002 ae156f5f2acd4bb6a7052525c9245004 msgid "" "the filename (str) of the journal or a file object opened as \"rb\" (or " "an `io.BytesIO()` object)." msgstr "저널의 파일명(str) 또는 \"rb\" 로 열린 파일 객체(또는 `io.BytesIO()` 객체)." #: ../../document.rst:2009 5f940a3e7e834d4bb229807f2f31c126 msgid "" "PDF only: Saves a \"snapshot\" of the document. This is a PDF document " "with a special, incremental-save format compatible with journalling -- " "therefore no save options are available. Saving a snapshot is not " "possible for new documents." msgstr "" "PDF 전용: 문서의 \"스냅샷\"을 저장합니다. 이것은 저널링과 호환되는 특수한 증분 저장 형식의 PDF 문서입니다 -- 따라서 " "저장 옵션을 사용할 수 없습니다. 새 문서의 경우 스냅샷 저장이 불가능합니다." #: ../../document.rst:2011 f586116e945545b1a4cad6f484605631 msgid "" "This is a normal PDF document with no usage restrictions whatsoever. If " "it is not being changed in any way, it can be used together with its " "journal to undo / redo operations or continue updating." msgstr "" "이것은 사용 제한이 전혀 없는 일반 PDF 문서입니다. 어떤 방식으로도 변경되지 않는 경우 저널과 함께 사용하여 작업을 실행 " "취소/다시 실행하거나 업데이트를 계속할 수 있습니다." #: ../../document.rst:2016 f752b2d996c14e0b8a78c71a0f90f84b msgid "" "Contains the first :ref:`Outline` entry of the document (or `None`). Can " "be used as a starting point to walk through all outline items. Accessing " "this property for encrypted, not authenticated documents will raise an " "*AttributeError*." msgstr "" "문서의 첫 번째 :ref:`Outline` 항목(또는 `None`)을 포함합니다. 모든 개요 항목을 순회하는 시작점으로 사용할 수 " "있습니다. 암호화되었지만 인증되지 않은 문서에 대해 이 속성에 액세스하면 *AttributeError* 가 발생합니다." #: ../../document.rst 00995fa57979497dadc4c05245df531b #: 043530a05a4a4547a0fd3a3dd8ad4a0e 0d7830ff904d4136bd22268be51826f7 #: 24bacb47a3b845ae9f78d935aaef2dbc 345e810f6046480f9403b08f9f4bcefd #: 74e3b6ce6dca44149b9d29443c932045 925d12c293744eff9d30dec6c94968ef #: 928860903ad84395aeb563464aa7fa33 95ee7c0c91eb470085cf7a7402a5aca6 #: 9d01a444f38e4b8fa769e04408682bfa a81724fa96ce4c59904551cc1647204a #: b870075b72ee484a8667be1b1f4340cb bed92752ce3a4fd0b268157d0d9196d4 #: c2b8f936790f45f8a293db8ea34ee5e3 cbcd66fd660f48c98c9982ab8bbea7d2 #: cfe8e8750ff14e1686c002553098556d d12fbf5f89594bfc97e8aba7e8e002b3 #: d905df47a8264daa82f71bd16750bae3 d9132afe09b24ff2a3957f60049d362b #: e60554c94b2444189ed5a481cec24a26 eb2f0663adb94352b5a04ed93ef624bc msgid "type" msgstr "타입" #: ../../document.rst:2018 0a1d5db8723b42fb85c316466e7ffb91 msgid ":ref:`Outline`" msgstr ":ref:`Outline`" #: ../../document.rst:2022 3b1a44d3b897441ebdf4f10b248f9a22 msgid "" "``False`` if document is still open. If closed, most other attributes and" " methods will have been deleted / disabled. In addition, :ref:`Page` " "objects referring to this document (i.e. created with " ":meth:`Document.load_page`) and their dependent objects will no longer be" " usable. For reference purposes, :attr:`Document.name` still exists and " "will contain the filename of the original document (if applicable)." msgstr "" "문서가 여전히 열려 있으면 ``False``. 닫히면 대부분의 다른 속성과 메서드가 삭제/비활성화됩니다. 또한 이 문서를 참조하는 " ":ref:`Page` 객체(즉, :meth:`Document.load_page` 로 생성된)와 종속 객체는 더 이상 사용할 수 " "없습니다. 참조 목적으로 :attr:`Document.name` 은 여전히 존재하며 원본 문서의 파일명을 포함합니다(해당하는 " "경우)." #: ../../document.rst:2024 ../../document.rst:2030 ../../document.rst:2036 #: ../../document.rst:2050 ../../document.rst:2058 ../../document.rst:2066 #: ../../document.rst:2104 ../../document.rst:2110 #: 0cc5fd7ca5794cc1b9fbd3cfb3aa27fd 12e50b17b9cb40a48f8695654175db79 #: 27f4f101c07c46c497d090cb3d8f71ad b1a9944e25c54efcb8ed9e82e88109c7 #: c26a6856641b4639b862f347625b17af caa9c5b1a6a84e6992520149259beff6 #: d4a114c416654fe786b4f773ca746d62 ee2dcc70850a4759921e982fb5d6d062 msgid "bool" msgstr "bool" #: ../../document.rst:2028 522e4e6cbfe546ecbc211187c3a94c41 msgid "" "``True`` if this is a PDF document and contains unsaved changes, else " "``False``." msgstr "이것이 PDF 문서이고 저장되지 않은 변경 사항이 포함되어 있으면 ``True``, 그렇지 않으면 ``False``." #: ../../document.rst:2034 299c7a35b22d4fbf90828dc6b9cb044e msgid "``True`` if this is a PDF document, else ``False``." msgstr "이것이 PDF 문서이면 ``True``, 그렇지 않으면 ``False``." #: ../../document.rst:2040 08475f6f36f447c29441b4d3fd76df5d msgid "" "``False`` if this is not a PDF or has no form fields, otherwise the " "number of root form fields (fields with no ancestors)." msgstr "이것이 PDF가 아니거나 양식 필드가 없으면 ``False``, 그렇지 않으면 루트 양식 필드 수(조상이 없는 필드)." #: ../../document.rst:2042 010f3e3f2e224c74971e9b55d2bdaa7d msgid "*(Changed in v1.16.4)* Returns the total number of (root) form fields." msgstr "*(v1.16.4에서 변경됨)* (루트) 양식 필드의 총 수를 반환합니다." #: ../../document.rst:2044 b440f9a8184b42ec823bb89ea41d82fb msgid "bool,int" msgstr "bool,int" #: ../../document.rst:2048 35914fa669fd405da917712ef53a7e92 msgid "" "``True`` if document has a variable page layout (like e-books or HTML). " "In this case you can set the desired page dimensions during document " "creation (open) or via method :meth:`layout`." msgstr "" "문서에 가변 페이지 레이아웃(예: 전자책 또는 HTML)이 있으면 ``True``. 이 경우 문서 생성(열기) 중 또는 메서드 " ":meth:`layout` 을 통해 원하는 페이지 크기를 설정할 수 있습니다." #: ../../document.rst:2054 0ce6260a4e3a4baa8ff2828e5a438327 msgid "New in v1.18.2" msgstr "v1.18.2에서 새로 추가됨" #: ../../document.rst:2056 a6d05b59ff164db98de53893fca7fcdd msgid "" "``True`` if PDF has been repaired during open (because of major structure" " issues). Always ``False`` for non-PDF documents. If true, more details " "have been stored in `TOOLS.mupdf_warnings()`, and " ":meth:`Document.can_save_incrementally` will return ``False``." msgstr "" "PDF가 열기 중에 복구되었으면(주요 구조 문제로 인해) ``True``. 비PDF 문서의 경우 항상 ``False``. true인" " 경우 `TOOLS.mupdf_warnings()` 에 더 자세한 정보가 저장되며 " ":meth:`Document.can_save_incrementally` 는 ``False`` 를 반환합니다." #: ../../document.rst:2064 a9b6d17bc6a64b64a3671e8bf9f83ec9 msgid "``True`` if PDF is in linearized format. ``False`` for non-PDF documents." msgstr "PDF가 선형화 형식이면 ``True``. 비PDF 문서의 경우 ``False``." #: ../../document.rst:2072 e5b2f42393594f9584bc49db8042d6a4 msgid "" "A dictionary indicating the `/MarkInfo` value. If not specified, the " "empty dictionary is returned. If not a PDF, `None` is returned." msgstr "`/MarkInfo` 값을 나타내는 딕셔너리. 지정되지 않으면 빈 딕셔너리가 반환됩니다. PDF가 아니면 `None` 이 반환됩니다." #: ../../document.rst:2074 ../../document.rst:2138 #: 3784f9a4ac6e48878e4c8c36ad21d273 d4410deba0634bce846d5ce0cd9b29c3 msgid "dict" msgstr "dict" #: ../../document.rst:2080 4271fd12fd1a41bfa48723d762e490a3 msgid "" "A string containing the `/PageMode` value. If not specified, the default " "\"UseNone\" is returned. If not a PDF, `None` is returned." msgstr "" "`/PageMode` 값을 포함하는 문자열. 지정되지 않으면 기본값 \"UseNone\" 이 반환됩니다. PDF가 아니면 " "`None` 이 반환됩니다." #: ../../document.rst:2082 ../../document.rst:2090 ../../document.rst:2144 #: 453fec96833e4433b835a1ef639e4b60 713b37981b604e8eb17307f1a2449199 #: cf4e37d7bd7f4c8dba3d4242bbb1f2db msgid "str" msgstr "str" #: ../../document.rst:2088 f9d3ccb16f674ace8f055a5063405edc msgid "" "A string containing the `/PageLayout` value. If not specified, the " "default \"SinglePage\" is returned. If not a PDF, `None` is returned." msgstr "" "`/PageLayout` 값을 포함하는 문자열. 지정되지 않으면 기본값 \"SinglePage\" 가 반환됩니다. PDF가 아니면 " "`None` 이 반환됩니다." #: ../../document.rst:2096 c6a7fa11f6ba45668b3e397c883ba549 msgid "" "An integer counting the number of versions present in the document. Zero " "if not a PDF, otherwise the number of incremental saves plus one." msgstr "문서에 있는 버전 수를 계산하는 정수. PDF가 아니면 0, 그렇지 않으면 증분 저장 수에 1을 더한 값." #: ../../document.rst:2098 ../../document.rst:2118 ../../document.rst:2150 #: ../../document.rst:2158 ../../document.rst:2166 #: 47a023dd007a4136b8709a8573756722 76fb9a9c4c9a40bebeed09ef0bfb3396 #: 984c624fe25a4686a77b774cd80a69ab 9c287bb741d44c889f527a422691acc1 #: fcb19540ceef4b62ad2dccde4b0f7510 msgid "int" msgstr "int" #: ../../document.rst:2102 7453a9e5ba024948a4063deb3b871b49 msgid "" "Indicates whether the document is password-protected against access. This" " indicator remains unchanged -- **even after the document has been " "authenticated**. Precludes incremental saves if true." msgstr "" "문서가 액세스에 대해 비밀번호로 보호되는지 여부를 나타냅니다. 이 표시기는 변경되지 않습니다 -- **문서가 인증된 후에도**. " "true이면 증분 저장을 제외합니다." #: ../../document.rst:2108 5556027f67ae474bab1a88b005f81bc8 msgid "" "This indicator initially equals :attr:`Document.needs_pass`. After " "successful authentication, it is set to ``False`` to reflect the " "situation." msgstr "" "이 표시기는 처음에 :attr:`Document.needs_pass` 와 같습니다. 성공적인 인증 후 상황을 반영하도록 " "``False`` 로 설정됩니다." #: ../../document.rst:2114 271b4315b03a405f8b9789f994bbd44d msgid "" "Changed in v1.16.0: This is now an integer comprised of bit indicators. " "Was a dictionary previously." msgstr "v1.16.0에서 변경됨: 이것은 이제 비트 표시기로 구성된 정수입니다. 이전에는 딕셔너리였습니다." #: ../../document.rst:2116 0a6016a9102f41f98184e468fbc8fcf9 msgid "" "Contains the permissions to access the document. This is an integer " "containing bool values in respective bit positions. For example, if " "*doc.permissions & pymupdf.PDF_PERM_MODIFY > 0*, you may change the " "document. See :ref:`PermissionCodes` for details." msgstr "" "문서 액세스 권한을 포함합니다. 이것은 각 비트 위치에 bool 값을 포함하는 정수입니다. 예를 들어 *doc.permissions" " & pymupdf.PDF_PERM_MODIFY > 0* 이면 문서를 변경할 수 있습니다. 자세한 내용은 " ":ref:`PermissionCodes` 를 참조하세요." #: ../../document.rst:2122 62256c18f0984d2c90bb467782ffeff9 msgid "" "Contains the document's meta data as a Python dictionary or `None` (if " "*is_encrypted=True* and *needPass=True*). Keys are *format*, " "*encryption*, *title*, *author*, *subject*, *keywords*, *creator*, " "*producer*, *creationDate*, *modDate*, *trapped*. All item values are " "strings or `None`." msgstr "" "Python 딕셔너리 또는 `None` (만약 *is_encrypted=True* 및 *needPass=True* 인 경우)로 " "문서의 메타 데이터를 포함합니다. 키는 *format*, *encryption*, *title*, *author*, " "*subject*, *keywords*, *creator*, *producer*, *creationDate*, *modDate*, " "*trapped* 입니다. 모든 항목 값은 문자열 또는 `None` 입니다." #: ../../document.rst:2124 03eee27a933d433fb7db0fce45f47ce5 msgid "" "Except *format* and *encryption*, for PDF documents, the key names " "correspond in an obvious way to the PDF keys */Creator*, */Producer*, " "*/CreationDate*, */ModDate*, */Title*, */Author*, */Subject*, */Trapped* " "and */Keywords* respectively." msgstr "" "*format* 및 *encryption* 을 제외하고, PDF 문서의 경우 키 이름은 PDF 키 */Creator*, " "*/Producer*, */CreationDate*, */ModDate*, */Title*, */Author*, " "*/Subject*, */Trapped* 및 */Keywords* 와 각각 명확하게 대응합니다." #: ../../document.rst:2126 35b7301ea11d45c690ea3d0cd18e2cbb msgid "*format* contains the document format (e.g. 'PDF-1.6', 'XPS', 'EPUB')." msgstr "*format* 는 문서 형식을 포함합니다(예: 'PDF-1.6', 'XPS', 'EPUB')." #: ../../document.rst:2128 d5b947e2ac1a49f59bf2d98bce59ef5f msgid "" "*encryption* either contains `None` (no encryption), or a string naming " "an encryption method (e.g. *'Standard V4 R4 128-bit RC4'*). Note that an " "encryption method may be specified **even if** *needs_pass=False*. In " "such cases not all permissions will probably have been granted. Check " ":attr:`Document.permissions` for details." msgstr "" "*encryption* 는 `None` (암호화 없음) 또는 암호화 방법을 명명하는 문자열(예: *'Standard V4 R4 " "128-bit RC4'*)을 포함합니다. *needs_pass=False* 인 경우에도 암호화 방법이 지정될 수 있습니다. 이러한 " "경우 모든 권한이 부여되지 않았을 수 있습니다. 자세한 내용은 :attr:`Document.permissions` 를 확인하세요." #: ../../document.rst:2130 d7ddc57c41dd4f788b7900b6376aa4a1 msgid "" "If the date fields contain valid data (which need not be the case at " "all!), they are strings in the PDF-specific timestamp format " "\"D:\", where" msgstr "" "날짜 필드에 유효한 데이터가 포함되어 있으면(항상 그런 것은 아님!), PDF 특정 타임스탬프 형식 \"D:\" 의 " "문자열입니다. 여기서" #: ../../document.rst:2132 37980944bd074ca5a4faae476976cc12 msgid "" " is the 12 character ISO timestamp *YYYYMMDDhhmmss* (*YYYY* - year, " "*MM* - month, *DD* - day, *hh* - hour, *mm* - minute, *ss* - second), and" msgstr "" " 는 12자 ISO 타임스탬프 *YYYYMMDDhhmmss* (*YYYY* - 연도, *MM* - 월, *DD* - 일, " "*hh* - 시, *mm* - 분, *ss* - 초)이며," #: ../../document.rst:2134 3856b3200cce432dbd8947d491439b5a msgid "" " is a time zone value (time interval relative to GMT) containing a " "sign ('+' or '-'), the hour (*hh*), and the minute (*'mm'*, note the " "apostrophes!)." msgstr "" " 는 부호('+' 또는 '-'), 시간(*hh*), 분(*'mm'*, 아포스트로피 주의!)을 포함하는 시간대 값(GMT 기준" " 시간 간격)입니다." #: ../../document.rst:2136 50c3a62c47aa4a0e91767db198d13bc9 msgid "" "A Paraguayan value might hence look like *D:20150415131602-04'00'*, which" " corresponds to the timestamp April 15, 2015, at 1:16:02 pm local time " "Asuncion." msgstr "" "파라과이 값은 따라서 *D:20150415131602-04'00'* 와 같이 보일 수 있으며, 이것은 2015년 4월 15일 오후 " "1:16:02 아순시온 현지 시간의 타임스탬프에 해당합니다." #: ../../document.rst:2142 5c4a4b4663dd458ebab9d3d96224ded1 msgid "" "Contains the *filename* or *filetype* value with which *Document* was " "created." msgstr "*Document* 가 생성된 *filename* 또는 *filetype* 값을 포함합니다." #: ../../document.rst:2148 1fd9cb078c3b40fa80177d7d3b7cd662 msgid "" "Contains the number of pages of the document. May return 0 for documents " "with no pages. Function `len(doc)` will also deliver this result." msgstr "" "문서의 페이지 수를 포함합니다. 페이지가 없는 문서의 경우 0을 반환할 수 있습니다. 함수 `len(doc)` 도 이 결과를 " "제공합니다." #: ../../document.rst:2154 ../../document.rst:2162 #: a3d993a5f1ad4023b11623ba4734ce54 c2709f411db54b3695edf605a69854cd msgid "New in v1.17.0" msgstr "v1.17.0에서 새로 추가됨" #: ../../document.rst:2156 ae19f25817824e61a9bb7e1f679b1cd5 msgid "" "Contains the number of chapters in the document. Always at least 1. " "Relevant only for document types with chapter support (EPUB currently). " "Other documents will return 1." msgstr "" "문서의 장 수를 포함합니다. 항상 최소 1입니다. 장 지원이 있는 문서 타입(현재 EPUB)에만 관련이 있습니다. 다른 문서는 1을" " 반환합니다." #: ../../document.rst:2164 3b71ca16faf845728a3b6fa856d2ea2a msgid "" "Contains (chapter, pno) of the document's last page. Relevant only for " "document types with chapter support (EPUB currently). Other documents " "will return `(0, page_count - 1)` and `(0, -1)` if it has no pages." msgstr "" "문서의 마지막 페이지의 (chapter, pno)를 포함합니다. 장 지원이 있는 문서 타입(현재 EPUB)에만 관련이 있습니다. " "다른 문서는 `(0, page_count - 1)` 을 반환하고 페이지가 없으면 `(0, -1)` 을 반환합니다." #: ../../document.rst:2170 cd3ec2161abf42f383b85e109737b05f msgid "" "A list of form field font names defined in the */AcroForm* object. `None`" " if not a PDF." msgstr "*/AcroForm* 객체에 정의된 양식 필드 폰트 이름 목록. PDF가 아니면 `None`." #: ../../document.rst:2172 2919fa430028481f824809524809a17c msgid "list" msgstr "list" #: ../../document.rst:2174 bc73641d1a9c4850a56dd8d1d90136ef msgid "" "For methods that change the structure of a PDF (:meth:`insert_pdf`, " ":meth:`select`, :meth:`copy_page`, :meth:`delete_page` and others), be " "aware that objects or properties in your program may have been " "invalidated or orphaned. Examples are :ref:`Page` objects and their " "children (links, annotations, widgets), variables holding old page " "counts, tables of content and the like. Remember to keep such variables " "up to date or delete orphaned objects. Also refer to " ":ref:`ReferenialIntegrity`." msgstr "" "PDF 구조를 변경하는 메서드(:meth:`insert_pdf`, :meth:`select`, :meth:`copy_page`, " ":meth:`delete_page` 등)의 경우 프로그램의 객체나 속성이 무효화되거나 고아가 되었을 수 있습니다. 예는 " ":ref:`Page` 객체와 그 자식(링크, 주석, 위젯), 이전 페이지 수를 보유하는 변수, 목차 등입니다. 이러한 변수를 최신 " "상태로 유지하거나 고아 객체를 삭제하세요. 또한 :ref:`ReferenialIntegrity` 를 참조하세요." #: ../../document.rst:2177 29ef52d9092f40e4b161b08377bff9f4 msgid ":meth:`set_metadata` Example" msgstr ":meth:`set_metadata` 예제" #: ../../document.rst:2178 9d932a2b03af4a70a7e135168374444b msgid "" "Clear metadata information. If you do this out of privacy / data " "protection concerns, make sure you save the document as a new file with " "*garbage > 0*. Only then the old */Info* object will also be physically " "removed from the file. In this case, you may also want to clear any XML " "metadata inserted by several PDF editors:" msgstr "" "메타데이터 정보를 지웁니다. 개인정보/데이터 보호 우려로 이 작업을 수행하는 경우 *garbage > 0* 로 문서를 새 파일로 " "저장하세요. 그때만 이전 */Info* 객체도 파일에서 물리적으로 제거됩니다. 이 경우 여러 PDF 편집기에서 삽입한 XML " "메타데이터도 지우는 것이 좋습니다:" #: ../../document.rst:2196 e2eb0b4a72184167a71e581190ebe0ed msgid ":meth:`set_toc` Demonstration" msgstr ":meth:`set_toc` 데모" #: ../../document.rst:2197 54198eb7940a4522a14d500ec0a2b760 msgid "" "This shows how to modify or add a table of contents. Also have a look at " "`import.py `_ and `export.py " "`_ in the examples directory." msgstr "" "이것은 목차를 수정하거나 추가하는 방법을 보여줍니다. 예제 디렉토리의 `import.py " "`_ 및 `export.py `_ 도 참조하세요." #: ../../document.rst:2217 803cdd302feb4061b6819a0a3f68b43a msgid ":meth:`insert_pdf` Examples" msgstr ":meth:`insert_pdf` 예제" #: ../../document.rst:2218 e1ab62bf3b5d4358b3314a0d663f91a2 msgid "**(1) Concatenate two documents including their TOCs:**" msgstr "**(1) TOC를 포함하여 두 문서를 연결합니다:**" #: ../../document.rst:2230 66d3a98744254ca8bebc826e6d41788f msgid "" "Obviously, similar ways can be found in more general situations. Just " "make sure that hierarchy levels in a row do not increase by more than " "one. Inserting dummy bookmarks before and after *toc2* segments would " "heal such cases. A ready-to-use GUI (wxPython) solution can be found in " "script `join.py `_ of the examples " "directory." msgstr "" "명백히, 더 일반적인 상황에서도 유사한 방법을 찾을 수 있습니다. 연속된 계층 수준이 1보다 많이 증가하지 않도록 하세요. " "*toc2* 세그먼트 앞뒤에 더미 북마크를 삽입하면 이러한 경우를 해결할 수 있습니다. 바로 사용할 수 있는 " "GUI(wxPython) 솔루션은 예제 디렉토리의 스크립트 `join.py `_ 에서 찾을 수" " 있습니다." #: ../../document.rst:2232 fe43ea94f4cf486e93446c386ef6290b msgid "**(2) More examples:**" msgstr "**(2) 추가 예제:**" #: ../../document.rst:2244 5589340b632247dcb71322e527a4570f msgid "Other Examples" msgstr "기타 예제" #: ../../document.rst:2245 da51858e718249de8fdd7d624f754823 msgid "**Extract all page-referenced images of a PDF into separate PNG files**::" msgstr "**PDF의 모든 페이지 참조 이미지를 별도의 PNG 파일로 추출합니다**::" #: ../../document.rst:2260 0c04c73b8df34278bf443717821a8217 msgid "**Rotate all pages of a PDF:**" msgstr "**PDF의 모든 페이지를 회전합니다:**" #: ../../document.rst:2265 1db40e14af84441b834f859b50baabf7 msgid "Footnotes" msgstr "각주" #: ../../document.rst:2266 ad80ce9bb918432f961168d95b5ded0b msgid "" "Content streams describe what (e.g. text or images) appears where and how" " on a page. PDF uses a specialized mini language similar to PostScript to" " do this (pp. 643 in :ref:`AdobeManual`), which gets interpreted when a " "page is loaded." msgstr "" "콘텐츠 스트림은 페이지에서 무엇(예: 텍스트 또는 이미지)이 어디에 어떻게 나타나는지 설명합니다. PDF는 이를 위해 " "PostScript와 유사한 특수 미니 언어를 사용합니다(:ref:`AdobeManual` 643페이지). 페이지가 로드될 때 " "해석됩니다." #: ../../document.rst:2268 de6710734193418ca5c9bec0d67eb9a3 msgid "" "However, you **can** use :meth:`Document.get_toc` and " ":meth:`Page.get_links` (which are available for all document types) and " "copy this information over to the output PDF. See demo `convert.py " "`_." msgstr "" "그러나 :meth:`Document.get_toc` 및 :meth:`Page.get_links` (모든 문서 타입에서 사용 가능)를" " 사용하여 이 정보를 출력 PDF로 복사할 수 있습니다. 데모 `convert.py " "`_ 를 참조하세요." #: ../../document.rst:2270 04f4a2a7a5114f97b1f359310b4e7013 msgid "" "For applicable (EPUB) document types, loading a page via its absolute " "number may result in layouting a large part of the document, before the " "page can be accessed. To avoid this performance impact, prefer chapter-" "based access. Use convenience methods and attributes " ":meth:`Document.next_location`, :meth:`Document.prev_location` and " ":attr:`Document.last_location` for maintaining a high level of coding " "efficiency." msgstr "" "적용 가능한(EPUB) 문서 타입의 경우 절대 번호를 통해 페이지를 로드하면 페이지에 액세스하기 전에 문서의 큰 부분이 레이아웃될 " "수 있습니다. 이 성능 영향을 피하려면 장 기반 액세스를 선호하세요. 높은 수준의 코딩 효율성을 유지하기 위해 편의 메서드 및 속성" " :meth:`Document.next_location`, :meth:`Document.prev_location` 및 " ":attr:`Document.last_location` 을 사용하세요." #: ../../document.rst:2272 0cdbae3fcd614e118ad4f020fe0d70f7 msgid "" "These parameters cause separate handling of stream categories: use it " "together with `expand` to restrict decompression to streams other than " "images / fontfiles." msgstr "" "이 매개변수는 스트림 카테고리의 별도 처리를 유발합니다: 이미지/폰트 파일이 아닌 스트림으로 압축 해제를 제한하려면 `expand`" " 와 함께 사용하세요." #: ../../document.rst:2274 418afd4e54704148af7cb35c9b73529f msgid "Examples for \"Form XObjects\" are created by :meth:`Page.show_pdf_page`." msgstr "\"Form XObjects\" 예제는 :meth:`Page.show_pdf_page` 로 생성됩니다." #: ../../document.rst:2276 4d9bbbe81fb14c3e82b33b401c51082e msgid "" "For a ``False`` the **complete document** must be scanned. Both methods " "**do not load pages,** but only scan object definitions. This makes them " "at least 10 times faster than application-level loops (where total " "response time roughly equals the time for loading all pages). For the " ":ref:`AdobeManual` (756 pages) and the Pandas documentation (over 3070 " "pages) -- both have no annotations -- the method needs about 11 ms for " "the answer ``False``. So response times will probably become significant " "only well beyond this order of magnitude." msgstr "" "``False`` 의 경우 **전체 문서** 를 스캔해야 합니다. 두 메서드 모두 **페이지를 로드하지 않고** 객체 정의만 " "스캔합니다. 이것은 애플리케이션 수준 루프(총 응답 시간이 모든 페이지를 로드하는 시간과 거의 같음)보다 최소 10배 빠릅니다. " ":ref:`AdobeManual` (756페이지) 및 Pandas 문서(3070페이지 이상)의 경우 -- 둘 다 주석이 없음 -- " "메서드는 답변 ``False`` 에 대해 약 11ms가 필요합니다. 따라서 응답 시간은 이 자릿수를 훨씬 넘어서야만 중요해질 " "것입니다." #: ../../document.rst:2278 e17889162164454eb395d68f5b5f74f8 msgid "" "This only works under certain conditions. For example, if there is normal" " text covered by some image on top of it, then this is undetectable and " "the respective text is **not** removed. Similar is true for white text on" " white background, and so on." msgstr "" "이것은 특정 조건에서만 작동합니다. 예를 들어, 일부 이미지로 덮인 일반 텍스트가 있으면 이것은 감지할 수 없으며 해당 텍스트는 " "**제거되지 않습니다**. 흰색 배경의 흰색 텍스트 등도 마찬가지입니다." #: ../../footer.rst:57 171190eed44c498983f498af56b35570 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/faq.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 abe8297b843740e8818a779fc28f5e03 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 2a09517c326c4536ad593b77a7c34643 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8e302b086c9d4b94a25e05794331fde6 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../faq.rst:7 7cb40df6997749398b9eb35022cc8f6e msgid "FAQ" msgstr "자주 묻는 질문" #: ../../faq.rst:9 e705c9c730c74868ad8d1f1495bccfb2 msgid "A collection of recipes in “How-To” format for using PyMuPDF." msgstr "PyMuPDF 사용을 위한 “사용 방법” 형식의 레시피 모음입니다." #: ../../faq.rst:12 76435ac8e35648f08fd41ecd9c4cf967 msgid "Please see:" msgstr "다음을 참조하세요:" #: ../../faq.rst:14 8f2e64a1c0fc4275bdecc52010b788ff msgid ":ref:`Recipes: Table of Contents`" msgstr ":ref:`레시피: 목차`" #: ../../footer.rst:57 570a7f5b861040448158d8294efe49f2 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/font.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 e188dde9abe149bc8995bf7a6a0bc7d6 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 3cb714fa525c44bbbbd491bc8f62336e msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c23c7d47fe3e429dbde810adabc353b6 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../font.rst:7 d2748ea1ae9940f6b22b259ae4533e13 msgid "Font" msgstr "Font" #: ../../font.rst:9 3bf53a70d692484eaabd5afc3aab44c8 msgid "New in v1.16.18" msgstr "*v1.16.18의 새로운 기능*" #: ../../font.rst:11 4c18f6c0f2b6494fbf226048ecce0907 msgid "" "This class represents a font as defined in |MuPDF| (``fz_font_s`` " "structure). It is required for the new class :ref:`TextWriter` and the " "new :meth:`Page.write_text`. Currently, it has no connection to how fonts" " are used in methods :meth:`Page.insert_text` or " ":meth:`Page.insert_textbox`, respectively." msgstr "이 클래스는 |MuPDF| 에서 정의된 글꼴(``fz_font_s`` 구조)을 나타냅니다. 새로운 클래스 :ref:`TextWriter` 및 새로운 :meth:`Page.write_text` 에 필요합니다. 현재는 :meth:`Page.insert_text` 또는 :meth:`Page.insert_textbox` 메서드에서 글꼴이 사용되는 방식과 연결되어 있지 않습니다." #: ../../font.rst:13 2125868871f645fb9fa0d4390f116a1a msgid "" "A ``Font`` object also contains useful general information, like the font" " bbox, the number of defined glyphs, glyph names or the ``bbox`` of a " "single glyph." msgstr "``Font`` 객체는 글꼴 bbox, 정의된 글리프 수, 글리프 이름 또는 단일 글리프의 ``bbox`` 와 같은 유용한 일반 정보도 포함합니다." #: ../../font.rst:17 842b44a70bf34b07ac2692aa84a193da msgid "**Method / Attribute**" msgstr "**Method / Attribute**" #: ../../font.rst:17 f69a466cefe443c3855949e5cc5ffcd6 msgid "**Short Description**" msgstr "**Short Description**" #: ../../font.rst:19 1bba986439da408a84c24de22da3768d msgid ":meth:`~Font.glyph_advance`" msgstr "" #: ../../font.rst:19 627a6c4218dd4762ae098709cdb920ad msgid "Width of a character" msgstr "문자 너비" #: ../../font.rst:20 6ca041bd76a54c949510e2ed77ca58f0 msgid ":meth:`~Font.glyph_bbox`" msgstr "" #: ../../font.rst:20 d9fb542d691c44a19873b891f02b7812 msgid "Glyph rectangle" msgstr "글리프 사각형" #: ../../font.rst:21 e7791392edbd4e5d9094df1b320d2c5b msgid ":meth:`~Font.glyph_name_to_unicode`" msgstr "" #: ../../font.rst:21 13f06c680aba44698114079c036bcdba msgid "Get unicode from glyph name" msgstr "글리프 이름에서 유니코드 가져오기" #: ../../font.rst:22 c04368ada6c341f093c2f4872cd5cd52 msgid ":meth:`~Font.has_glyph`" msgstr "" #: ../../font.rst:22 689634c88d144bef9223b78f39009eda msgid "Return glyph id of unicode" msgstr "유니코드의 글리프 ID 반환" #: ../../font.rst:23 a369a0e87b4340168dce9cd130684d3c msgid ":meth:`~Font.text_length`" msgstr "" #: ../../font.rst:23 f20e22d5c6534f99a10aad9ab98d9ae3 msgid "Compute string length" msgstr "문자열 길이 계산" #: ../../font.rst:24 d46c723021014de19f30cce31dd6fa83 msgid ":meth:`~Font.char_lengths`" msgstr "" #: ../../font.rst:24 2c939c616c2a45d19cef1d2e9148c5f8 msgid "Tuple of char widths of a string" msgstr "문자열의 문자 너비 튜플" #: ../../font.rst:25 30fcbf0fac8c4137ac05697051b7a487 msgid ":meth:`~Font.unicode_to_glyph_name`" msgstr "" #: ../../font.rst:25 96a805868d65421593f69cabcbdff444 msgid "Get glyph name of a unicode" msgstr "유니코드의 글리프 이름 가져오기" #: ../../font.rst:26 556560ade52f45878ccd9247ed48b124 msgid ":meth:`~Font.valid_codepoints`" msgstr "" #: ../../font.rst:26 f98352016c9a420597ecdc2d4da47bcd msgid "Array of supported unicodes" msgstr "지원되는 유니코드 배열" #: ../../font.rst:27 8046f6ca0658408896ffec620e7c19d2 msgid ":attr:`~Font.ascender`" msgstr "" #: ../../font.rst:27 bdef6c925fd24cd6a8bd423203561e10 msgid "Font ascender" msgstr "글꼴 상승부" #: ../../font.rst:28 b9972b7d50024c5f92aae461b95e9b9d msgid ":attr:`~Font.descender`" msgstr "" #: ../../font.rst:28 333b36880ce240299a20b8d485071b31 msgid "Font descender" msgstr "글꼴 하강부" #: ../../font.rst:29 1ca68d63143c41ae9afaf82231bb0b98 msgid ":attr:`~Font.bbox`" msgstr "" #: ../../font.rst:29 88947fe258eb49d5a4bcd7f9262d6f64 msgid "Font rectangle" msgstr "글꼴 사각형" #: ../../font.rst:30 70204c08ad4f48bfb90c610ace5e2f16 msgid ":attr:`~Font.buffer`" msgstr "" #: ../../font.rst:30 d8dc88a830a143b69cf9198d43a1d8be msgid "Copy of the font's binary image" msgstr "글꼴의 바이너리 이미지 복사본" #: ../../font.rst:31 087ab4d9b8c245329f433d0e0bc1dae2 msgid ":attr:`~Font.flags`" msgstr "" #: ../../font.rst:31 b08397d234cf4d828c277f81b7e5797c msgid "Collection of font properties" msgstr "글꼴 속성 모음" #: ../../font.rst:32 1b9e053341ba4bf29f37614365fca44e msgid ":attr:`~Font.glyph_count`" msgstr "" #: ../../font.rst:32 9266fb9484fe42618bd4b861302ec139 msgid "Number of supported glyphs" msgstr "지원되는 글리프 수" #: ../../font.rst:33 a1a23dee533f4eb9a0253e7ed4dc2160 msgid ":attr:`~Font.name`" msgstr "" #: ../../font.rst:33 f7c44ea05506418686745a0a8b4ccf1e msgid "Name of font" msgstr "글꼴 이름" #: ../../font.rst:34 4d8600344c934dca966561b9b23705a3 msgid ":attr:`~Font.is_bold`" msgstr "" #: ../../font.rst:34 42bd831f9b604a58adec9428f2799d4a msgid "`True` if bold" msgstr "굵게이면 `True`" #: ../../font.rst:35 4fd252e5611e4f25ad7279f120909cc1 msgid ":attr:`~Font.is_monospaced`" msgstr "" #: ../../font.rst:35 53567d475247479ebe27771a05253749 msgid "`True` if mono-spaced" msgstr "고정폭이면 `True`" #: ../../font.rst:36 386c083d80e24cd8889a76d1ed0d655e msgid ":attr:`~Font.is_serif`" msgstr "" #: ../../font.rst:36 dc515a68d8984513880dd9652137056b msgid "`True` if serif, `False` if sans-serif" msgstr "세리프이면 `True`, 산세리프이면 `False`" #: ../../font.rst:37 ef38964ab5634a4a8afc1a4043834bcb msgid ":attr:`~Font.is_italic`" msgstr "" #: ../../font.rst:37 6ab8b6017630445e8a8d73bd87250888 msgid "`True` if italic" msgstr "이탤릭이면 `True`" #: ../../font.rst:41 ef6bc7e0d9cf42848d2ea5ec97cad0e8 msgid "**Class API**" msgstr "**Class API**" #: ../../font.rst:60 07b4413b01ae4ae89132a4d69299fcff msgid "" "Font constructor. The large number of parameters are used to locate font," " which most closely resembles the requirements. Not all parameters are " "ever required -- see the below pseudo code explaining the logic how the " "parameters are evaluated." msgstr "Font 생성자. 많은 매개변수는 요구사항에 가장 가까운 글꼴을 찾는 데 사용됩니다. 모든 매개변수가 항상 필요한 것은 아닙니다 -- 매개변수가 평가되는 방식의 논리를 설명하는 아래 의사 코드를 참조하세요." #: ../../font.rst 51829dd751b848658d1ba228b94ce1de #: 6865a3bfb8444b439d877a9d8a59cb0a 722fbb72278d4e3e8bb0df13f398859a #: 8cbc7148711c4ee9a078b6a806370c78 a100d7e7206946cda8a733ebb3f80137 #: c931f89accb14562827a19ea990df0aa f0f58970e4794ad2b4f9ab161b976692 #: f42510c818544c6180a85f87a852dd28 msgid "Parameters" msgstr "Parameters" #: ../../font.rst:62 b7c66967af094eed88e4cd0bfa9c0b59 msgid "" "one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a " "select few other names like (watch the correct spelling): \"Arial\", " "\"Times\", \"Times Roman\". *(Changed in v1.17.5)* If you have " "installed `pymupdf-fonts `_, " "there are also new \"reserved\" fontnames available, which are listed in " ":attr:`fitz_fonts` and in the table further down." msgstr "" #: ../../font.rst:62 4f54e9a21f4e4cdd94eb896e84a11207 msgid "" "one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a " "select few other names like (watch the correct spelling): \"Arial\", " "\"Times\", \"Times Roman\"." msgstr ":ref:`Base-14-Fonts` 또는 CJK 글꼴 이름 중 하나. (올바른 철자를 주의하세요) \"Arial\", \"Times\", \"Times Roman\"과 같은 몇 가지 다른 이름도 가능합니다." #: ../../font.rst:64 33128ec921644adcb669eed87f58d1ad msgid "*(Changed in v1.17.5)*" msgstr "*(v1.17.5에서 변경됨)*" #: ../../font.rst:66 2580ac163f6d40a6a97df2667e044b70 msgid "" "If you have installed `pymupdf-fonts `_, there are also new \"reserved\" fontnames available, which are" " listed in :attr:`fitz_fonts` and in the table further down." msgstr "`pymupdf-fonts `_ 를 설치한 경우, :attr:`fitz_fonts` 및 아래 표에 나열된 새로운 \"예약된\" 글꼴 이름도 사용할 수 있습니다." #: ../../font.rst:68 0115b8805a994350b1e9b88652d9c671 msgid "the filename of a fontfile somewhere on your system [#f1]_." msgstr "시스템 어딘가에 있는 글꼴 파일의 파일 이름 [#f1]_." #: ../../font.rst:69 855671c475ce4d4a95574d50da436fa8 msgid "a fontfile loaded in memory [#f1]_." msgstr "메모리에 로드된 글꼴 파일 [#f1]_." #: ../../font.rst:70 b4cd7e175eb14d658f5faa379b3ef701 msgid "" "the number of a UCDN script. Currently supported in PyMuPDF are numbers " "24, and 32 through 35." msgstr "UCDN 스크립트 번호. 현재 |PyMuPDF| 에서 지원되는 번호는 24, 32부터 35까지입니다." #: ../../font.rst:71 d5a5fc15ea7c4e1b8d26964a61b402e8 msgid "" "one of the values \"zh-Hant\" (traditional Chinese), \"zh-Hans\" " "(simplified Chinese), \"ja\" (Japanese) and \"ko\" (Korean). Otherwise, " "all ISO 639 codes from the subsets 1, 2, 3 and 5 are also possible, but " "are currently documentary only." msgstr "\"zh-Hant\"(번체 중국어), \"zh-Hans\"(간체 중국어), \"ja\"(일본어), \"ko\"(한국어) 값 중 하나. 그렇지 않으면 하위 집합 1, 2, 3 및 5의 모든 ISO 639 코드도 가능하지만 현재는 문서화만 되어 있습니다." #: ../../font.rst:72 5b0e786be58c4a09a48eacc61882197e msgid "an alternative selector for one of the CJK fonts." msgstr "CJK 글꼴 중 하나에 대한 대체 선택자." #: ../../font.rst:73 6af1f2fb252e4071bab746f2ad57c01d msgid "look for a bold font." msgstr "굵은 글꼴을 찾습니다." #: ../../font.rst:74 6f2bffef2aa94c92b00fa9cf6d97a283 msgid "look for an italic font." msgstr "이탤릭 글꼴을 찾습니다." #: ../../font.rst:75 23ca0f2751ed4b2f834236f7e744dd36 msgid "look for a serifed font." msgstr "세리프 글꼴을 찾습니다." #: ../../font.rst 1d22b29a05e741f387368f96870d4c1b #: 1e8b6f0bc4da4c4db71fcd4ce33f7f4d 1ebfff0006a54633b2e48a4cf728c55b #: 3126e087ce6d47cbb326a10281420878 3aaf4a67eaa8475e97bebd3b14716268 #: 3b8e58b5a2034fddbba0b9f34d785351 425ebf256d4842928912c98469178b2e #: 455992af6eea4168919f71ca6e0a63e9 7512b5e1267b491c80d9886fcb846c91 msgid "Returns" msgstr "Returns" #: ../../font.rst:77 d564d7e503224782b914ea4c4d4bd55b msgid "" "a |MuPDF| font if successful. This is the overall sequence of checks to " "determine an appropriate font: =========== " "============================================================ Argument " "Action =========== " "============================================================ fontfile? " "Create font from file, exception if failure. fontbuffer? Create font from" " buffer, exception if failure. ordering>=0 Create universal font, always " "succeeds. fontname? Create a Base-14 font, universal font, or font" " provided by `pymupdf-fonts `_. See table below. =========== " "============================================================" msgstr "" #: ../../font.rst:77 cea38fccea5241229aadba228571f8be msgid "" "a |MuPDF| font if successful. This is the overall sequence of checks to " "determine an appropriate font:" msgstr "성공하면 |MuPDF| 글꼴. 적절한 글꼴을 결정하기 위한 전체 확인 순서는 다음과 같습니다:" #: ../../font.rst:80 580ec24b97e749299e613764ef3403c6 msgid "Argument" msgstr "Argument" #: ../../font.rst:80 c41ca6b5584649b586f676f06f22549b msgid "Action" msgstr "Action" #: ../../font.rst:82 98333181f4584c9c8bca13c85c415262 msgid "fontfile?" msgstr "fontfile?" #: ../../font.rst:82 73d6da924f634bc7b6e4fe044072fe6d msgid "Create font from file, exception if failure." msgstr "파일에서 글꼴 생성, 실패 시 예외 발생." #: ../../font.rst:83 130073b0bea44ffc890479cdb5f5340d msgid "fontbuffer?" msgstr "fontbuffer?" #: ../../font.rst:83 a74986c74e6843eea78fcc35d447c3a2 msgid "Create font from buffer, exception if failure." msgstr "버퍼에서 글꼴 생성, 실패 시 예외 발생." #: ../../font.rst:84 29919d8588f5493dafda4cfe7f0555b1 msgid "ordering>=0" msgstr "ordering>=0" #: ../../font.rst:84 3f0b6b784f1742238213e67a82078abf msgid "Create universal font, always succeeds." msgstr "범용 글꼴 생성, 항상 성공." #: ../../font.rst:85 fe70636ee76b429da54199e913507119 msgid "fontname?" msgstr "fontname?" #: ../../font.rst:85 a411aeb787b5416f854bb729f143e0b6 msgid "" "Create a Base-14 font, universal font, or font provided by `pymupdf-fonts" " `_. See table below." msgstr "Base-14 글꼴, 범용 글꼴 또는 `pymupdf-fonts `_ 에서 제공하는 글꼴을 생성합니다. 아래 표를 참조하세요." #: ../../font.rst:92 d6d370d9961e418c8c6a25a191d46651 msgid "" "With the usual reserved names \"helv\", \"tiro\", etc., you will create " "fonts with the expected names \"Helvetica\", \"Times-Roman\" and so on. " "**However**, and in contrast to :meth:`Page.insert_font` and friends," msgstr "일반적인 예약된 이름 \"helv\", \"tiro\" 등을 사용하면 예상되는 이름 \"Helvetica\", \"Times-Roman\" 등의 글꼴이 생성됩니다. **그러나** :meth:`Page.insert_font` 및 유사한 메서드와 달리," #: ../../font.rst:94 31fed8debc7c42ca9166ee0b1ef74c98 msgid "a font file will **always** be embedded in your PDF," msgstr "글꼴 파일이 **항상** PDF에 임베드됩니다," #: ../../font.rst:95 9b3d8892b4424474889b2416ef13836b msgid "" "Greek and Cyrillic characters are supported without needing the " "*encoding* parameter." msgstr "그리스 문자 및 키릴 문자는 *encoding* 매개변수 없이 지원됩니다." #: ../../font.rst:97 c07988cc48644ac8846d43cf555ae595 msgid "" "Using *ordering >= 0*, or fontnames \"cjk\", \"china-t\", \"china-s\", " "\"japan\" or \"korea\" will **always create the same \"universal\"** font" " **\"Droid Sans Fallback Regular\"**. This font supports **all Chinese, " "Japanese, Korean and Latin characters**, including Greek and Cyrillic. " "This is a sans-serif font." msgstr "*ordering >= 0* 또는 글꼴 이름 \"cjk\", \"china-t\", \"china-s\", \"japan\" 또는 \"korea\"를 사용하면 **항상 동일한 \"범용\"** 글꼴 **\"Droid Sans Fallback Regular\"** 이 생성됩니다. 이 글꼴은 그리스 문자 및 키릴 문자를 포함하여 **모든 중국어, 일본어, 한국어 및 라틴 문자** 를 지원합니다. 이것은 산세리프 글꼴입니다." #: ../../font.rst:99 6db4519008e44ee682c2a27e4d316f4b msgid "" "Actually, you would rarely ever need another sans-serif font than " "**\"Droid Sans Fallback Regular\"**. **Except** that this font file is " "relatively large and adds about 1.65 MB (compressed) to your PDF file " "size. If you do not need CJK support, stick with specifying \"helv\", " "\"tiro\" etc., and you will get away with about 35 KB compressed." msgstr "실제로 **\"Droid Sans Fallback Regular\"** 외에 다른 산세리프 글꼴이 필요한 경우는 거의 없습니다. **다만** 이 글꼴 파일은 상대적으로 크며 PDF 파일 크기에 약 1.65 MB(압축됨)를 추가합니다. CJK 지원이 필요하지 않다면 \"helv\", \"tiro\" 등을 지정하고 약 35 KB(압축됨)로 처리할 수 있습니다." #: ../../font.rst:101 79c699cd0e0a44828e95752e5f6f2ebe msgid "" "If you **know** you have a mixture of CJK and Latin text, consider just " "using `Font(\"cjk\")` because this supports everything and also " "significantly (by a factor of up to three) speeds up execution: MuPDF " "will always find any character in this single font and never needs to " "check fallbacks." msgstr "CJK와 라틴 텍스트가 혼합되어 있다는 것을 **알고** 있다면, `Font(\"cjk\")` 를 사용하는 것을 고려하세요. 이것은 모든 것을 지원하며 실행 속도를 크게(최대 3배까지) 향상시킵니다: MuPDF는 항상 이 단일 글꼴에서 모든 문자를 찾을 수 있으며 대체 글꼴을 확인할 필요가 없습니다." #: ../../font.rst:103 71613c830de34e6f9ecdf39faec59a38 msgid "" "But if you do use some other font, you will still automatically be able " "to also write CJK characters: MuPDF detects this situation and silently " "falls back to the universal font (which will then of course also be " "embedded in your PDF)." msgstr "그러나 다른 글꼴을 사용하는 경우에도 CJK 문자를 자동으로 쓸 수 있습니다: MuPDF는 이 상황을 감지하고 자동으로 범용 글꼴로 대체합니다(그러면 물론 PDF에도 임베드됩니다)." #: ../../font.rst:105 f904db70b3d246e1b10894809cb39326 msgid "" "*(New in v1.17.5)* Optionally, some new \"reserved\" fontname codes " "become available if you install `pymupdf-fonts `_, `pip install pymupdf-fonts`. **\"Fira Mono\"** is a " "mono-spaced sans font set and **FiraGO** is another non-serifed " "\"universal\" font set which supports all Latin (including Cyrillic and " "Greek) plus Thai, Arabian, Hewbrew and Devanagari -- but none of the CJK " "languages. The size of a FiraGO font is only a quarter of the \"Droid " "Sans Fallback\" size (compressed 400 KB vs. 1.65 MB) -- **and** it " "provides the weights bold, italic, bold-italic -- which the universal " "font doesn't." msgstr "*(v1.17.5의 새로운 기능)* 선택적으로, `pymupdf-fonts `_ (`pip install pymupdf-fonts`)를 설치하면 일부 새로운 \"예약된\" 글꼴 이름 코드를 사용할 수 있습니다. **\"Fira Mono\"** 는 고정폭 산세리프 글꼴 세트이고 **FiraGO** 는 모든 라틴 문자(키릴 문자 및 그리스 문자 포함)와 태국어, 아랍어, 히브리어 및 데바나가리어를 지원하는 또 다른 비세리프 \"범용\" 글꼴 세트입니다 -- 하지만 CJK 언어는 지원하지 않습니다. FiraGO 글꼴의 크기는 \"Droid Sans Fallback\" 크기의 1/4에 불과합니다(압축 시 400 KB vs. 1.65 MB) -- **그리고** 굵게, 이탤릭, 굵은 이탤릭 가중치를 제공합니다 -- 범용 글꼴은 제공하지 않습니다." #: ../../font.rst:107 51115005ef5b45048d055b7507f8bde1 msgid "" "**\"Space Mono\"** is another nice and small mono-spaced font from Google" " Fonts, which supports Latin Extended characters and comes with all 4 " "important weights." msgstr "**\"Space Mono\"** 는 Google Fonts의 또 다른 좋고 작은 고정폭 글꼴로, Latin Extended 문자를 지원하며 모든 4가지 중요한 가중치를 제공합니다." #: ../../font.rst:109 96727739a91940c6a331ed087081f309 msgid "" "The following table maps a fontname code to the corresponding font. For " "the current content of the package please see its documentation:" msgstr "다음 표는 글꼴 이름 코드를 해당 글꼴에 매핑합니다. 패키지의 현재 내용은 해당 문서를 참조하세요:" #: ../../font.rst:112 1a8503b417cf4c8fada552e8610a6e75 msgid "Code" msgstr "Code" #: ../../font.rst:112 2d8f3f6732334560b3d503193be52bed msgid "Fontname" msgstr "Fontname" #: ../../font.rst:112 c74b2b12e6aa454b8f2dbb4143ffd7bf msgid "New in" msgstr "New in" #: ../../font.rst:112 09250ac84f2f444481bee3de0bd29007 msgid "Comment" msgstr "Comment" #: ../../font.rst:114 3092d884950f4b6eb710a9de0dd03966 msgid "figo" msgstr "figo" #: ../../font.rst:114 660c171a6c564814aecb4286056ec31a msgid "FiraGO Regular" msgstr "FiraGO Regular" #: ../../font.rst:114 ../../font.rst:115 ../../font.rst:116 ../../font.rst:117 #: ../../font.rst:118 ../../font.rst:119 3e80c8fdb0dd48d780069b2449ee507f #: 410d087d7e1243d1a54c1ae0aab172ac 6f27e46024f84abd97777e835ae6517f #: 794afaec71784e91b7e817f22ead4ffe baa94f214aea4d77a1a5fad071d449f1 #: ed541c0c11684da3bebb342489caa3cb msgid "v1.0.0" msgstr "v1.0.0" #: ../../font.rst:114 aababde120ff4dbcbe21832121ff155b msgid "narrower than Helvetica" msgstr "Helvetica보다 좁음" #: ../../font.rst:115 01a9c98efef34d0aba6ba3fa0d37813b msgid "figbo" msgstr "figbo" #: ../../font.rst:115 b83719e8b5724cd69e516c29b9367ebb msgid "FiraGO Bold" msgstr "FiraGO Bold" #: ../../font.rst:116 4bbe563434c7425796dc77766d23c9c8 msgid "figit" msgstr "figit" #: ../../font.rst:116 480523c94e564e26be18e84adb38e861 msgid "FiraGO Italic" msgstr "FiraGO Italic" #: ../../font.rst:117 1e31c41d5df44c4fb09a83fdbd89e06d msgid "figbi" msgstr "figbi" #: ../../font.rst:117 0e71b818d3cd4256a6f49c7416f6b1ca msgid "FiraGO Bold Italic" msgstr "FiraGO Bold Italic" #: ../../font.rst:118 7137d532bea243b482a7189e3a3286f8 msgid "fimo" msgstr "fimo" #: ../../font.rst:118 d52c3785bf6c4c6c9fa414b6953b3c21 msgid "Fira Mono Regular" msgstr "Fira Mono Regular" #: ../../font.rst:119 a6bb6a057367406e8c6451c50221bd10 msgid "fimbo" msgstr "fimbo" #: ../../font.rst:119 a9be831c53d643c381182387817e7347 msgid "Fira Mono Bold" msgstr "Fira Mono Bold" #: ../../font.rst:120 2ff90048652c45d8ad808bd8e873a930 msgid "spacemo" msgstr "spacemo" #: ../../font.rst:120 10b17a9bdac441b2a4af57265d22e503 msgid "Space Mono Regular" msgstr "Space Mono Regular" #: ../../font.rst:120 ../../font.rst:121 ../../font.rst:122 ../../font.rst:123 #: 71f76d3cde6b47a3b8a7a0a571913454 74e5c245413f43a1b0bcd54884d11f9b #: 811a2ce8ecf443c3b7c4a0009f550f69 ad9d314c839645d1b264c21f9d500a5d msgid "v1.0.1" msgstr "v1.0.1" #: ../../font.rst:121 cc6628c7c246454785eae18aa76df135 msgid "spacembo" msgstr "spacembo" #: ../../font.rst:121 899d31ca415d4d60a771344775afb052 msgid "Space Mono Bold" msgstr "Space Mono Bold" #: ../../font.rst:122 0fa8a8df23aa46a18ebc85a45faef555 msgid "spacemit" msgstr "spacemit" #: ../../font.rst:122 121e740c51fa4e13b45b780076fdc770 msgid "Space Mono Italic" msgstr "Space Mono Italic" #: ../../font.rst:123 8c761931925c4c9080802855c8de2158 msgid "spacembi" msgstr "spacembi" #: ../../font.rst:123 c294981796074117b39f66e1d0fc697f msgid "Space Mono Bold-Italic" msgstr "Space Mono Bold-Italic" #: ../../font.rst:124 fb3d22993d774962addb0d5e18962566 msgid "math" msgstr "math" #: ../../font.rst:124 d72ffadba17c47d98e45bad69d43f48a msgid "Noto Sans Math Regular" msgstr "Noto Sans Math Regular" #: ../../font.rst:124 ../../font.rst:125 ../../font.rst:126 ../../font.rst:127 #: 4a51871589de44a49f3d817a3e4641ca a1e187ea3001421b848c3e15b2da294f #: c7f9419b4b474f9990c0e7b2548b89bd f44b20960c864e1a812db6b82ccc7b01 msgid "v1.0.2" msgstr "v1.0.2" #: ../../font.rst:124 3527017ccae847e198b6aa3fd407bf86 msgid "math symbols" msgstr "수학 기호" #: ../../font.rst:125 f0c044192be8422bbb062dcfe3fa3867 msgid "music" msgstr "music" #: ../../font.rst:125 5091921f86b8478b884595a229b30799 msgid "Noto Music Regular" msgstr "Noto Music Regular" #: ../../font.rst:125 0cfb05fc68a6412895e997a6f27ab557 msgid "musical symbols" msgstr "음악 기호" #: ../../font.rst:126 198d0ac76851400696fd7bfe7e9c60b3 msgid "symbol1" msgstr "symbol1" #: ../../font.rst:126 8bf74ea20b3d41c081691ba396ba7ec2 msgid "Noto Sans Symbols Regular" msgstr "Noto Sans Symbols Regular" #: ../../font.rst:126 96ef9a86cd4c4af9ad70de3493072981 msgid "replacement for \"symb\"" msgstr "\"symb\"의 대체" #: ../../font.rst:127 4eae35b6626f44edb67bbd03f28f00d6 msgid "symbol2" msgstr "symbol2" #: ../../font.rst:127 b1fdca63e3d74dd29efec985e0b244dc msgid "Noto Sans Symbols2 Regular" msgstr "Noto Sans Symbols2 Regular" #: ../../font.rst:127 0bd6d32f20eb48dd988041621b3d5200 msgid "extended symbol set" msgstr "확장 기호 세트" #: ../../font.rst:128 aa751e08f13849d1a55e72c6aebf8f49 msgid "notos" msgstr "notos" #: ../../font.rst:128 89dea662c0eb4c7eb232a7fdba6ebc9a msgid "Noto Sans Regular" msgstr "Noto Sans Regular" #: ../../font.rst:128 ../../font.rst:129 ../../font.rst:130 ../../font.rst:131 #: 459d3d0e43ff4bf5aa61c68e8e685e29 67cb7c095cf74781840d29e84aa0034b #: 91a98cec9643445d9d588f6c148714f4 d8bd23d980b1436583464316e47308db msgid "v1.0.3" msgstr "v1.0.3" #: ../../font.rst:128 6b98b595462b4d478057da307cdea30a msgid "alternative to Helvetica" msgstr "Helvetica의 대체" #: ../../font.rst:129 691a807af162494ab0b5af4186c9110c msgid "notosit" msgstr "notosit" #: ../../font.rst:129 24201a800ba0419c9bee4bf90edf8825 msgid "Noto Sans Italic" msgstr "Noto Sans Italic" #: ../../font.rst:130 4dd91c5ba63544bba1ceb32e1fdefd55 msgid "notosbo" msgstr "notosbo" #: ../../font.rst:130 ff244216f5904a4697fcab3f6d021a6a msgid "Noto Sans Bold" msgstr "Noto Sans Bold" #: ../../font.rst:131 aa8c2e1781f54593b3331c086c19b814 msgid "notosbi" msgstr "notosbi" #: ../../font.rst:131 6857edcacab24c27817264bb11d9bdad msgid "Noto Sans BoldItalic" msgstr "Noto Sans BoldItalic" #: ../../font.rst:141 2a37a1a4a1aa4945b8df8dbf7e64e154 msgid "" "Check whether the unicode ``chr`` exists in the font or (option) some " "fallback font. May be used to check whether any \"TOFU\" symbols will " "appear on output." msgstr "유니코드 ``chr`` 가 글꼴 또는 (선택적으로) 일부 대체 글꼴에 존재하는지 확인합니다. 출력에 \"TOFU\" 기호가 나타날지 확인하는 데 사용할 수 있습니다." #: ../../font.rst:143 009b9aeb3f9944d596e9f49f9899c324 msgid "the unicode of the character (i.e. ``ord()``)." msgstr "문자의 유니코드(즉, ``ord()``)." #: ../../font.rst:144 a8641b2b63ec4b07875c388e202271b9 msgid "the language -- currently unused." msgstr "언어 -- 현재 사용되지 않음." #: ../../font.rst:145 1bf9dc08f5954b5f965c6b5ea1570763 msgid "the UCDN script number." msgstr "UCDN 스크립트 번호." #: ../../font.rst:146 c652199037ea41779589cd7c702796e7 msgid "" "*(new in v1.17.5)* perform an extended search in fallback fonts or " "restrict to current font (default)." msgstr "*(v1.17.5의 새로운 기능)* 대체 글꼴에서 확장 검색을 수행하거나 현재 글꼴로 제한합니다(기본값)." #: ../../font.rst:147 97e5feeeb43a4af0bb9163c00cad3e2b msgid "*(changed in 1.17.7)* the glyph number. Zero indicates no glyph found." msgstr "*(1.17.7에서 변경됨)* 글리프 번호. 0은 글리프를 찾지 못했음을 나타냅니다." #: ../../font.rst:151 fed10a374e2445d1be29d1f78a496de5 msgid "New in v1.17.5" msgstr "v1.17.5에서 새로 추가됨" #: ../../font.rst:153 290f44f3033a469e89d5444b5d3ec4f9 msgid "Return an array of unicodes supported by this font." msgstr "이 글꼴이 지원하는 유니코드 배열을 반환합니다." #: ../../font.rst:155 ab16e827b27d4022b45b4c90a328da02 #, python-format msgid "" "an ``array.array`` [#f2]_ of length at most :attr:`Font.glyph_count`. " "I.e. ``chr()`` of every item in this array has a glyph in the font " "without using fallbacks. This is an example display of the supported " "glyphs: >>> import pymupdf >>> font = pymupdf.Font(\"math\") >>> vuc = " "font.valid_codepoints() >>> for i in vuc: print(\"%04X %s (%s)\" % " "(i, chr(i), font.unicode_to_glyph_name(i))) 0000 000D (CR) 0020 " "(space) 0021 ! (exclam) 0022 \" (quotedbl) 0023 # (numbersign) 0024 $ " "(dollar) 0025 % (percent) ... 00AC ¬ (logicalnot) 00B1 ± (plusminus) ... " "21D0 ⇐ (arrowdblleft) 21D1 ⇑ (arrowdblup) 21D2 ⇒ (arrowdblright) 21D3 ⇓ " "(arrowdbldown) 21D4 ⇔ (arrowdblboth) ... 221E ∞ (infinity) ..." msgstr "" #: ../../font.rst:155 7031be6a1bcf4a65b62350eb968608e6 msgid "" "an ``array.array`` [#f2]_ of length at most :attr:`Font.glyph_count`. " "I.e. ``chr()`` of every item in this array has a glyph in the font " "without using fallbacks. This is an example display of the supported " "glyphs:" msgstr "길이가 최대 :attr:`Font.glyph_count` 인 ``array.array`` [#f2]_. 즉, 이 배열의 모든 항목의 ``chr()`` 는 대체 글꼴을 사용하지 않고 글꼴에 글리프를 가집니다. 지원되는 글리프의 예제 표시는 다음과 같습니다:" #: ../../font.rst:183 c5ad65fa71a74dd9a63ab09809f0f9cf msgid "" "This method only returns meaningful data for fonts having a CMAP " "(character map, charmap, the `/ToUnicode` PDF key). Otherwise, this array" " will have length 1 and contain zero only." msgstr "이 메서드는 CMAP(문자 맵, charmap, `/ToUnicode` PDF 키)가 있는 글꼴에 대해서만 의미 있는 데이터를 반환합니다. 그렇지 않으면 이 배열의 길이는 1이고 0만 포함합니다." #: ../../font.rst:192 af8b042889b54a38b2a5ddd689449328 msgid "Calculate the \"width\" of the character's glyph (visual representation)." msgstr "문자 글리프의 \"너비\"를 계산합니다(시각적 표현)." #: ../../font.rst:194 c1f6c6b34907404e97ad72617e0fc346 msgid "" "the unicode number of the character. Use ``ord()``, not the character " "itself. Again, this should normally work even if a character is not " "supported by that font, because fallback fonts will be checked where " "necessary." msgstr "문자의 유니코드 번호. 문자 자체가 아닌 ``ord()`` 를 사용하세요. 다시 말하지만, 글꼴이 문자를 지원하지 않더라도 일반적으로 작동해야 합니다. 필요한 경우 대체 글꼴이 확인되기 때문입니다." #: ../../font.rst:195 e838a07682d84a869e2fa1cc89abf58a msgid "write mode, ``0`` = horizontal, ``1`` = vertical." msgstr "쓰기 모드, ``0`` = 가로, ``1`` = 세로." #: ../../font.rst:197 2dc7e2ceacbb4ef690b919a430d04d1b msgid "The other parameters are not in use currently." msgstr "다른 매개변수는 현재 사용되지 않습니다." #: ../../font.rst:199 e8423a5397284db1919f456052773ded msgid "a float representing the glyph's width relative to **fontsize 1**." msgstr "**fontsize 1** 에 상대적인 글리프 너비를 나타내는 float." #: ../../font.rst:203 47dc9dab1b4c4cb8b9e6a069008d81b1 msgid "" "Return the unicode value for a given glyph name. Use it in conjunction " "with `chr()` if you want to output e.g. a certain symbol." msgstr "주어진 글리프 이름에 대한 유니코드 값을 반환합니다. 예를 들어 특정 기호를 출력하려면 `chr()` 와 함께 사용하세요." #: ../../font.rst:205 749831c099134aa7bf7ffe282b0836b5 msgid "The name of the glyph." msgstr "글리프의 이름." #: ../../font.rst:207 377293d9901943dbb4c7c31c7985c7d9 msgid "" "The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: " "`font.glyph_name_to_unicode(\"Sigma\") = 931`, " "`font.glyph_name_to_unicode(\"sigma\") = 963`. Refer to the `Adobe Glyph " "List `_ publication for a list of glyph names " "and their unicode numbers. Example: >>> font = pymupdf.Font(\"helv\") " ">>> font.has_glyph(font.glyph_name_to_unicode(\"infinity\")) True" msgstr "" #: ../../font.rst:207 765a70f4e5934d66adf72deeaaad3599 msgid "" "The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: " "`font.glyph_name_to_unicode(\"Sigma\") = 931`, " "`font.glyph_name_to_unicode(\"sigma\") = 963`. Refer to the `Adobe Glyph " "List `_ publication for a list of glyph names " "and their unicode numbers. Example:" msgstr "유니코드 정수, 또는 이름을 알 수 없는 경우 65533 = 0xFFFD. 예: `font.glyph_name_to_unicode(\"Sigma\") = 931`, `font.glyph_name_to_unicode(\"sigma\") = 963`. 글리프 이름과 유니코드 번호 목록은 `Adobe Glyph List `_ 출판물을 참조하세요. 예:" #: ../../font.rst:219 ceed99f4b1f641ae9879e4ef9b43cfcf msgid "The glyph rectangle relative to :data:`fontsize` 1." msgstr ":data:`fontsize` 1에 상대적인 글리프 사각형." #: ../../font.rst:221 9803fc558ea94924824b3c6f36f33ce5 msgid "``ord()`` of the character." msgstr "문자의 ``ord()``." #: ../../font.rst:223 cae0a18260bf47dcb9d033363ab5176b msgid "a :ref:`Rect`." msgstr ":ref:`Rect`." #: ../../font.rst:228 c530486f148348589a870c1a6fad982d msgid "Show the name of the character's glyph." msgstr "문자 글리프의 이름을 표시합니다." #: ../../font.rst:230 b33374c8c5234c618bbb03b5c25bd99b msgid "" "the unicode number of the character. Use ``ord()``, not the character " "itself." msgstr "문자의 유니코드 번호. 문자 자체가 아닌 ``ord()`` 를 사용하세요." #: ../../font.rst:232 39265ca9c3774508a81f7b6c33627e8d msgid "" "a string representing the glyph's name. E.g. `font.glyph_name(ord(\"#\"))" " = \"numbersign\"`. For an invalid code \".notfound\" is returned. .. " "note:: *(Changed in v1.18.0)* This method and " ":meth:`Font.glyph_name_to_unicode` no longer depend on a font and instead" " retrieve information from the **Adobe Glyph List**. Also available as " "`pymupdf.unicode_to_glyph_name()` and resp. " "`pymupdf.glyph_name_to_unicode()`." msgstr "" #: ../../font.rst:232 7b64931c6f244cfca3c0761329de7f73 msgid "" "a string representing the glyph's name. E.g. `font.glyph_name(ord(\"#\"))" " = \"numbersign\"`. For an invalid code \".notfound\" is returned." msgstr "글리프 이름을 나타내는 문자열. 예: `font.glyph_name(ord(\"#\")) = \"numbersign\"`. 잘못된 코드의 경우 \".notfound\"가 반환됩니다." #: ../../font.rst:234 20712f7e063243888f6395b18c3acae8 msgid "" "*(Changed in v1.18.0)* This method and :meth:`Font.glyph_name_to_unicode`" " no longer depend on a font and instead retrieve information from the " "**Adobe Glyph List**. Also available as `pymupdf.unicode_to_glyph_name()`" " and resp. `pymupdf.glyph_name_to_unicode()`." msgstr "*(v1.18.0에서 변경됨)* 이 메서드와 :meth:`Font.glyph_name_to_unicode` 는 더 이상 글꼴에 의존하지 않으며 대신 **Adobe Glyph List** 에서 정보를 검색합니다. `pymupdf.unicode_to_glyph_name()` 및 각각 `pymupdf.glyph_name_to_unicode()` 로도 사용할 수 있습니다." #: ../../font.rst:241 38b6209e6a4344a8b3be848dc476755c msgid "Calculate the length in points of a unicode string." msgstr "유니코드 문자열의 포인트 단위 길이를 계산합니다." #: ../../font.rst:243 142ac4b87bb644ffa8514275b3e51007 msgid "" "There is a functional overlap with :meth:`get_text_length` for Base-14 " "fonts only." msgstr "Base-14 글꼴에 대해서만 :meth:`get_text_length` 와 기능적 중복이 있습니다." #: ../../font.rst:245 ../../font.rst:269 7c8abec195d7425ab74856419d327b59 #: f31ddd69af474ca98115ec49230627cf msgid "a text string, UTF-8 encoded." msgstr "UTF-8로 인코딩된 텍스트 문자열." #: ../../font.rst:247 ../../font.rst:271 280e2e6390a84299b1eb50742751cc45 #: 5880b72ffefe4073a534b44ef82aa00b msgid "the :data:`fontsize`." msgstr ":data:`fontsize`." #: ../../font.rst 24af9fb41f6d40be800f9d6a56909af0 #: 375fd3e160764b6f97a1b86fc740fe8a 465db7792c4b472f806017a0d364f367 #: 53682f9b23a84002ab90b511020b49f6 5fa74d99fa99412f91d3a82aefa8e4bf #: 70db0a0a767e4ee8867951f816a54be0 9353b0e144af4fc7a2f47be5d63e325b #: b579c7fff96e4c608f8eb22666e2666d d2e13bff74024b768ddd4405202d6cab #: d3196a22363c47ecb37dd5972f00334e msgid "Return type" msgstr "Return type" #: ../../font.rst:251 ec7a7979f9e7418fbdceaeee4f29b39d msgid "" "the length of the string in points when stored in the PDF. If a character" " is not contained in the font, it will automatically be looked up in a " "fallback font. .. note:: This method was originally implemented in " "Python, based on calling :meth:`Font.glyph_advance`. For performance " "reasons, it has been rewritten in C for v1.18.14. To compute the width of" " a single character, you can now use either of the following without " "performance penalty: 1. `font.glyph_advance(ord(\"Ä\")) * fontsize`" " 2. `font.text_length(\"Ä\", fontsize=fontsize)` For multi-" "character strings, the method offers a huge performance advantage " "compared to the previous implementation: instead of about 0.5 " "microseconds for each character, only 12.5 nanoseconds are required for " "the second and subsequent ones." msgstr "" #: ../../font.rst:251 f41d04198f2341a990157155d7f740b1 msgid "" "the length of the string in points when stored in the PDF. If a character" " is not contained in the font, it will automatically be looked up in a " "fallback font." msgstr "PDF에 저장될 때 포인트 단위의 문자열 길이. 글꼴에 문자가 포함되어 있지 않으면 자동으로 대체 글꼴에서 찾습니다." #: ../../font.rst:253 57ccdf4bd0474e3280e1cdda9d041027 msgid "" "This method was originally implemented in Python, based on calling " ":meth:`Font.glyph_advance`. For performance reasons, it has been " "rewritten in C for v1.18.14. To compute the width of a single character, " "you can now use either of the following without performance penalty:" msgstr "이 메서드는 원래 :meth:`Font.glyph_advance` 호출을 기반으로 Python에서 구현되었습니다. 성능상의 이유로 v1.18.14에서 C로 다시 작성되었습니다. 단일 문자의 너비를 계산하려면 성능 저하 없이 다음 중 하나를 사용할 수 있습니다:" #: ../../font.rst:255 b485562f46994ef3a76ed0ba8f486f14 msgid "`font.glyph_advance(ord(\"Ä\")) * fontsize`" msgstr "`font.glyph_advance(ord(\"Ä\")) * fontsize`" #: ../../font.rst:256 7b3106bb9bf0498198809c557ab60339 msgid "`font.text_length(\"Ä\", fontsize=fontsize)`" msgstr "`font.text_length(\"Ä\", fontsize=fontsize)`" #: ../../font.rst:258 3724b3d50f664946b0d42d8fab2f84f6 msgid "" "For multi-character strings, the method offers a huge performance " "advantage compared to the previous implementation: instead of about 0.5 " "microseconds for each character, only 12.5 nanoseconds are required for " "the second and subsequent ones." msgstr "다중 문자 문자열의 경우, 이 메서드는 이전 구현과 비교하여 큰 성능 이점을 제공합니다: 각 문자에 대해 약 0.5 마이크로초 대신 두 번째 및 이후 문자에는 12.5 나노초만 필요합니다." #: ../../font.rst:265 aafd060e84e541abbe7b30af94aa8ded msgid "*New in v1.18.14*" msgstr "*v1.18.14에서 새로 추가됨*" #: ../../font.rst:267 7decb74d1d39477b9462d29370e42a35 msgid "Sequence of character lengths in points of a unicode string." msgstr "유니코드 문자열의 포인트 단위 문자 길이 시퀀스." #: ../../font.rst:275 76401a090dc249fcab049f83b6f83cee msgid "" "the lengths in points of the characters of a string when stored in the " "PDF. It works like :meth:`Font.text_length` broken down to single " "characters. This is a high speed method, used e.g. in " ":meth:`TextWriter.fill_textbox`. The following is true (allowing rounding" " errors): `font.text_length(text) == sum(font.char_lengths(text))`. >>> " "font = pymupdf.Font(\"helv\") >>> text = \"PyMuPDF\" >>> " "font.text_length(text) 50.115999937057495 >>> " "pymupdf.get_text_length(text, fontname=\"helv\") 50.115999937057495 >>> " "sum(font.char_lengths(text)) 50.115999937057495 >>> " "pprint(font.char_lengths(text)) (7.336999952793121, # P 5.5," " # y 9.163000047206879, # M 6.115999937057495, # u " "7.336999952793121, # P 7.942000031471252, # D 6.721000015735626) # " "F" msgstr "" #: ../../font.rst:275 1544e745681a4b6da063619a2e9620b7 msgid "" "the lengths in points of the characters of a string when stored in the " "PDF. It works like :meth:`Font.text_length` broken down to single " "characters. This is a high speed method, used e.g. in " ":meth:`TextWriter.fill_textbox`. The following is true (allowing rounding" " errors): `font.text_length(text) == sum(font.char_lengths(text))`." msgstr "PDF에 저장될 때 문자열 문자의 포인트 단위 길이. :meth:`Font.text_length` 를 단일 문자로 분해한 것처럼 작동합니다. 이것은 고속 메서드이며 예를 들어 :meth:`TextWriter.fill_textbox` 에서 사용됩니다. 다음이 참입니다(반올림 오류 허용): `font.text_length(text) == sum(font.char_lengths(text))`." #: ../../font.rst:297 d80b29e9dd8c454da9c51b26d9cad2fe msgid "New in v1.17.6" msgstr "v1.17.6에서 새로 추가됨" #: ../../font.rst:299 30834747dcfd4dc48a79f57ad356cdd3 msgid "Copy of the binary font file content." msgstr "바이너리 글꼴 파일 내용의 복사본." #: ../../font.rst:305 71cd13ec6bab4c46bb9c7dbb8108fb63 msgid "" "A dictionary with various font properties, each represented as bools. " "Example for Helvetica::" msgstr "각각 bool로 표현되는 다양한 글꼴 속성의 딕셔너리. Helvetica의 예::" #: ../../font.rst:325 dbe85241cd3a4910a0da84236fc69d03 msgid "Name of the font. May be \"\" or \"(null)\"." msgstr "글꼴 이름. \"\" 또는 \"(null)\"일 수 있습니다." #: ../../font.rst:329 190864bf642d4836b3e8ed0493dc4672 msgid "The font bbox. This is the maximum of its glyph bboxes." msgstr "글꼴 bbox. 이것은 글리프 bbox의 최대값입니다." #: ../../font.rst:331 33b968a3b28241e9a604dd232bd3bf7c msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../font.rst:337 38e95b49eec642f784ca39d58b0b40df msgid "The number of glyphs defined in the font." msgstr "글꼴에 정의된 글리프 수." #: ../../font.rst:341 ../../font.rst:349 aa9a0f03418b4adba2109af305a941e1 #: b18be968a53743bdb4bdab316af4c374 msgid "New in v1.18.0" msgstr "v1.18.0에서 새로 추가됨" #: ../../font.rst:343 d3c64bfaff7540aa857c6dcc2fc2b0a0 msgid "" "The ascender value of the font, see `ascender typography " "`_ for details. " "Please note that there is a difference to the strict definition: our " "value includes everything above the baseline -- not just the height " "difference between upper case \"A\" and and lower case \"a\"." msgstr "글꼴의 상승부 값, 자세한 내용은 `ascender typography `_ 를 참조하세요. 엄격한 정의와 차이가 있음을 참고하세요: 우리의 값은 기준선 위의 모든 것을 포함합니다 -- 대문자 \"A\"와 소문자 \"a\" 사이의 높이 차이만이 아닙니다." #: ../../font.rst:351 7fba1bd77fd74cc1abdb335fe3269fbc msgid "" "The descender value of the font, see `descender typography " "`_ for details. This value " "always is negative and is the portion that some glyphs descend below the " "base line, for example \"g\" or \"y\". As a consequence, the value " "`ascender - descender` is the total height, that every glyph of the font " "fits into. This is true at least for most fonts -- as always, there are " "exceptions, especially for calligraphic fonts, etc." msgstr "글꼴의 하강부 값, 자세한 내용은 `descender typography `_ 를 참조하세요. 이 값은 항상 음수이며 일부 글리프가 기준선 아래로 내려가는 부분입니다. 예를 들어 \"g\" 또는 \"y\". 결과적으로 `ascender - descender` 값은 글꼴의 모든 글리프가 들어맞는 전체 높이입니다. 이것은 적어도 대부분의 글꼴에 대해 참입니다 -- 항상 그렇듯이 예외가 있으며, 특히 필기체 글꼴 등에 해당합니다." #: ../../font.rst:363 4ffede0fc21c4b5fa0f667a903b92e93 msgid "" "A number of attributes with obvious meanings. Reflect some values of the " ":attr:`Font.flags` dictionary." msgstr "명확한 의미를 가진 여러 속성. :attr:`Font.flags` 딕셔너리의 일부 값을 반영합니다." #: ../../font.rst:368 4bd92baafe77479faa63b31082e0c69a msgid "Footnotes" msgstr "Footnotes" #: ../../font.rst:369 d66637c72e2b45aea7edd3cb116ec328 msgid "" "MuPDF does not support all fontfiles with this feature and will raise " "exceptions like *\"mupdf: FT_New_Memory_Face((null)): unknown file " "format\"*, if it encounters issues." msgstr "MuPDF는 이 기능을 가진 모든 글꼴 파일을 지원하지 않으며 문제가 발생하면 *\"mupdf: FT_New_Memory_Face((null)): unknown file format\"* 과 같은 예외를 발생시킵니다." #: ../../font.rst:371 7213fcc59c214e508d3da6221ec0d21a msgid "" "The built-in Python module `array` has been chosen for its speed and low " "memory requirement." msgstr "내장 Python 모듈 `array` 는 속도와 낮은 메모리 요구 사항 때문에 선택되었습니다." #: ../../footer.rst:46 3dc04747492b4b4bac6e2c6af8d83002 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/footer.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../footer.rst:46 6174f91a653847f0bf61a4cba1c92a19 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/functions.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 d5eaf8f36ea24d1fa23ebb1e8e41a90a msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 8b803decc5f34c5fb8ad982980d7c72a msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 e66a1624a18842059b9907685b6c923b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../functions.rst:5 09639c24e337417f91e7de56ce3925a9 msgid "Functions" msgstr "함수" #: ../../functions.rst:6 d241bcc35bc04fe898c335516878e3b2 msgid "" "The following are miscellaneous functions and attributes on a fairly low-" "level technical detail." msgstr "다음은 상당히 낮은 수준의 기술 세부 사항에 대한 다양한 함수 및 속성입니다." #: ../../functions.rst:8 59b2d7e5074348b69fc146b45b000d70 msgid "" "Some functions provide detail access to PDF structures. Others are " "stripped-down, high performance versions of other functions which provide" " more information." msgstr "" "일부 함수는 PDF 구조에 대한 세부 액세스를 제공합니다. 다른 함수들은 더 많은 정보를 제공하는 다른 함수들의 간소화된 고성능 " "버전입니다." #: ../../functions.rst:10 ea218c4b21c34a54b5241255f2274c27 msgid "Yet others are handy, general-purpose utilities." msgstr "또 다른 함수들은 편리한 범용 유틸리티입니다." #: ../../functions.rst:14 26226f6d78b94bbfbc116c90ec1b1667 msgid "**Function**" msgstr "**함수**" #: ../../functions.rst:14 8b717e28bda34d8bb8d5d4a899346921 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../functions.rst:16 4fa827142fed47519193771ca5b08092 msgid ":attr:`Annot.apn_bbox`" msgstr "" #: ../../functions.rst:16 5e724998a2fe42beb8664ac646bf06a5 msgid "PDF only: bbox of the appearance object" msgstr "PDF 전용: 외관 객체의 bbox" #: ../../functions.rst:17 e888ae87ebb64c36a00f993c271f9619 msgid ":attr:`Annot.apn_matrix`" msgstr "" #: ../../functions.rst:17 fb98b796e0944e88843ee6b73c5462c8 msgid "PDF only: the matrix of the appearance object" msgstr "PDF 전용: 외관 객체의 행렬" #: ../../functions.rst:18 c82ca559939b4f2999f22b393c9c49c5 msgid ":attr:`Page.is_wrapped`" msgstr "" #: ../../functions.rst:18 8b72a57f280b43758c83633f4cab7d86 msgid "check whether contents wrapping is present" msgstr "콘텐츠 래핑이 있는지 확인" #: ../../functions.rst:19 5ef421856e0e4d2283f1bfc84b188fff msgid ":meth:`adobe_glyph_names`" msgstr "" #: ../../functions.rst:19 3472f840e3f842c182821e72f04801f6 msgid "list of glyph names defined in **Adobe Glyph List**" msgstr "**Adobe Glyph List** 에 정의된 글리프 이름 목록" #: ../../functions.rst:20 752b3e5acbe2461694cdae2a674c5f9f msgid ":meth:`adobe_glyph_unicodes`" msgstr "" #: ../../functions.rst:20 5328c789e05a4c84bb18faf4f590624c msgid "list of unicodes defined in **Adobe Glyph List**" msgstr "**Adobe Glyph List** 에 정의된 유니코드 목록" #: ../../functions.rst:21 31f74aa2555c4a34831b22a7e91f4d78 msgid ":meth:`Annot.clean_contents`" msgstr "" #: ../../functions.rst:21 2f6aed921d3244e9864151ff2181d926 msgid "PDF only: clean the annot's :data:`contents` object" msgstr "PDF 전용: 주석의 :data:`contents` 객체 정리" #: ../../functions.rst:22 8b78b1dcdb9e48ec904da6e3afd94f81 msgid ":meth:`Annot.set_apn_bbox`" msgstr "" #: ../../functions.rst:22 1f6854c2e8d647daa789426623c1beb8 msgid "PDF only: set the bbox of the appearance object" msgstr "PDF 전용: 외관 객체의 bbox 설정" #: ../../functions.rst:23 3857c8ee2f5748ffaa4bb8a896d72d65 msgid ":meth:`Annot.set_apn_matrix`" msgstr "" #: ../../functions.rst:23 8e746324795541b98d2337928d494ac9 msgid "PDF only: set the matrix of the appearance object" msgstr "PDF 전용: 외관 객체의 행렬 설정" #: ../../functions.rst:24 fe9bc78339d044edb57af998111e0e94 msgid ":meth:`ConversionHeader`" msgstr "" #: ../../functions.rst:24 c9d53709f3ec4313886ef34c2592dc2a msgid "return header string for *get_text* methods" msgstr "*get_text* 메서드에 대한 헤더 문자열 반환" #: ../../functions.rst:25 f42819297e9c4f5a9d89b2bd6705b29d msgid ":meth:`ConversionTrailer`" msgstr "" #: ../../functions.rst:25 6c0ab36cb3184db4a0865841dad35fb3 msgid "return trailer string for *get_text* methods" msgstr "*get_text* 메서드에 대한 트레일러 문자열 반환" #: ../../functions.rst:26 5e2606a6e2424e1abef37d5a5336d192 msgid ":meth:`Document.del_xml_metadata`" msgstr "" #: ../../functions.rst:26 ed1d451869034ee1818820271d019376 msgid "PDF only: remove XML metadata" msgstr "PDF 전용: XML 메타데이터 제거" #: ../../functions.rst:27 732e7fffe1c647dab7c6d9fcf6828ce2 msgid ":meth:`Document.get_char_widths`" msgstr "" #: ../../functions.rst:27 351bf40e0c10489fa167be35cbeede88 msgid "PDF only: return a list of glyph widths of a font" msgstr "PDF 전용: 글꼴의 글리프 너비 목록 반환" #: ../../functions.rst:28 9ec9c0e0a2694a88b5162cedf7e99d3c msgid ":meth:`Document.get_new_xref`" msgstr "" #: ../../functions.rst:28 8a4cabef920b48208011d74894909090 msgid "PDF only: create and return a new :data:`xref` entry" msgstr "PDF 전용: 새로운 :data:`xref` 항목 생성 및 반환" #: ../../functions.rst:29 25a750f17eb440d7afc91b91de3c51dc msgid ":meth:`Document.is_stream`" msgstr "" #: ../../functions.rst:29 80d8b21e19054578869eb0f4170ed472 msgid "PDF only: check whether an :data:`xref` is a stream object" msgstr "PDF 전용: :data:`xref` 가 스트림 객체인지 확인" #: ../../functions.rst:30 b7e1dc4e790c41619345dbe8ca19c53f msgid ":meth:`Document.xml_metadata_xref`" msgstr "" #: ../../functions.rst:30 e969dc0606e341eaaa57453eb8eef3fe msgid "PDF only: return XML metadata :data:`xref` number" msgstr "PDF 전용: XML 메타데이터 :data:`xref` 번호 반환" #: ../../functions.rst:31 d7b9b54aaece4890a119fc28f0b0213d msgid ":meth:`Document.xref_length`" msgstr "" #: ../../functions.rst:31 0d5124e0366f4b279c0caecef1badf22 msgid "PDF only: return length of :data:`xref` table" msgstr "PDF 전용: :data:`xref` 테이블의 길이 반환" #: ../../functions.rst:32 7e5cb32316f046989fdfc51b848af3a5 msgid ":meth:`EMPTY_IRECT`" msgstr "" #: ../../functions.rst:32 ../../functions.rst:34 #: 72f212b14bbe40e991e86ece2cc1c252 db2699336cdf40c7acc4bcbba7fc31cd msgid "return the (standard) empty / invalid rectangle" msgstr "(표준) 빈/유효하지 않은 사각형 반환" #: ../../functions.rst:33 18064cd07e9b45088a8b5121afcc373a msgid ":meth:`EMPTY_QUAD`" msgstr "" #: ../../functions.rst:33 2d74cea507794a8cabc329254264d867 msgid "return the (standard) empty / invalid quad" msgstr "(표준) 빈/유효하지 않은 쿼드 반환" #: ../../functions.rst:34 ca50d2c7ddf8434698c2247b7063acff msgid ":meth:`EMPTY_RECT`" msgstr "" #: ../../functions.rst:35 89d408ccc68d4ce39653e0d907c85295 msgid ":meth:`get_pdf_now`" msgstr "" #: ../../functions.rst:35 48f14174d2e34dbfb19df27001f24fec msgid "return the current timestamp in PDF format" msgstr "PDF 형식의 현재 타임스탬프 반환" #: ../../functions.rst:36 cbcbe41ecf5e43edad6d095ce00f09c1 msgid ":meth:`get_pdf_str`" msgstr "" #: ../../functions.rst:36 39f2a8a1b0c143298f9393ea1ed57297 msgid "return PDF-compatible string" msgstr "PDF 호환 문자열 반환" #: ../../functions.rst:37 3d87a50d6b304a6191cd03adecdbf8c5 msgid ":meth:`get_text_length`" msgstr "" #: ../../functions.rst:37 8c4282d6eaab449490037c18b06197cc msgid "return string length for a given font & :data:`fontsize`" msgstr "주어진 글꼴 및 :data:`fontsize` 에 대한 문자열 길이 반환" #: ../../functions.rst:38 33b7cf546f184f529efbb76c2b68f01c msgid ":meth:`glyph_name_to_unicode`" msgstr "" #: ../../functions.rst:38 cef00a6424564bb88d7ff3da7f59a57f msgid "return unicode from a glyph name" msgstr "글리프 이름에서 유니코드 반환" #: ../../functions.rst:39 b92854863247412db8a57b9e4dec0ff2 msgid ":meth:`image_profile`" msgstr "" #: ../../functions.rst:39 0babe345f56341e08a6ce5c46190ae85 msgid "return a dictionary of basic image properties" msgstr "기본 이미지 속성의 딕셔너리 반환" #: ../../functions.rst:40 d15b2478761c42778f75793f3b52e20f msgid ":meth:`INFINITE_IRECT`" msgstr "" #: ../../functions.rst:40 ../../functions.rst:42 #: 531c629266ac4ddf9cf8b93162d99d86 9e3ea8aaed944e1b9dec93f4527643f6 msgid "return the (only existing) infinite rectangle" msgstr "(유일하게 존재하는) 무한 사각형 반환" #: ../../functions.rst:41 06d5cc18fcbf40d6bb99b294dade3c86 msgid ":meth:`INFINITE_QUAD`" msgstr "" #: ../../functions.rst:41 efe4f04d259c43cfa7a294ef6b37e674 msgid "return the (only existing) infinite quad" msgstr "(유일하게 존재하는) 무한 쿼드 반환" #: ../../functions.rst:42 4ebe8dc0e1a94750958a022b23527ae7 msgid ":meth:`INFINITE_RECT`" msgstr "" #: ../../functions.rst:43 810dbb2ba3574ea4a2a27ea13faeb3ed msgid ":meth:`make_table`" msgstr "" #: ../../functions.rst:43 1d2dd96b457c447080a9455ad8ba3d02 msgid "split rectangle in sub-rectangles" msgstr "사각형을 하위 사각형으로 분할" #: ../../functions.rst:44 4efadc8238ca4c81880285681a275b59 msgid ":meth:`Page.clean_contents`" msgstr "" #: ../../functions.rst:44 78470e69571940789a87fa57faa9e6db msgid "PDF only: clean the page's :data:`contents` objects" msgstr "PDF 전용: 페이지의 :data:`contents` 객체 정리" #: ../../functions.rst:45 6083fb6360c44b32b75dce123ed47366 msgid ":meth:`Page.get_bboxlog`" msgstr "" #: ../../functions.rst:45 73f845fdf7ef46e4971320b572f4db8b msgid "list of rectangles that envelop text, drawing or image objects" msgstr "텍스트, 그리기 또는 이미지 객체를 둘러싸는 사각형 목록" #: ../../functions.rst:46 80028783aab041c69b426c082d2aa6df msgid ":meth:`Page.get_contents`" msgstr "" #: ../../functions.rst:46 74a19434f8f246f19e61fe238b478907 msgid "PDF only: return a list of content :data:`xref` numbers" msgstr "PDF 전용: 콘텐츠 :data:`xref` 번호 목록 반환" #: ../../functions.rst:47 019c93458efe4182a147120a0cc10b3e msgid ":meth:`Page.get_displaylist`" msgstr "" #: ../../functions.rst:47 a44e43abf2dc456f8337f43c185d948e msgid "create the page's display list" msgstr "페이지의 디스플레이 리스트 생성" #: ../../functions.rst:48 58150969be474967b037cf952a6c031f msgid ":meth:`Page.get_text_blocks`" msgstr "" #: ../../functions.rst:48 f0b458ff737845fea22ed316da32926a msgid "extract text blocks as a Python list" msgstr "텍스트 블록을 Python 리스트로 추출" #: ../../functions.rst:49 216b4f80f83c4bbcb187c35eb3ee8e40 msgid ":meth:`Page.get_text_words`" msgstr "" #: ../../functions.rst:49 9895bb7c031d4f20b8a5191f4dfd8167 msgid "extract text words as a Python list" msgstr "텍스트 단어를 Python 리스트로 추출" #: ../../functions.rst:50 1112723c3d914a8eb485016e2e43eb25 msgid ":meth:`Page.get_texttrace`" msgstr "" #: ../../functions.rst:50 7a2b3074f96a4a2284ec5f7fceb0f40f msgid "low-level text information" msgstr "저수준 텍스트 정보" #: ../../functions.rst:51 9b6b7e72a5104179aa2df4fd9adbbbcf msgid ":meth:`Page.read_contents`" msgstr "" #: ../../functions.rst:51 934be2410e654699924480d3599ec1fb msgid "PDF only: get complete, concatenated /Contents source" msgstr "PDF 전용: 완전하고 연결된 /Contents 소스 가져오기" #: ../../functions.rst:52 d3db73a2b79141b0bed19fdd1f6ca764 msgid ":meth:`Page.run`" msgstr "" #: ../../functions.rst:52 4902d89cf4b144069ba225a193fe2332 msgid "run a page through a device" msgstr "디바이스를 통해 페이지 실행" #: ../../functions.rst:53 0b2357ceef874b5c81bd4ac101078751 msgid ":meth:`Page.set_contents`" msgstr "" #: ../../functions.rst:53 140d86f801f447ba932d4d0da1636bdf msgid "PDF only: set page's :data:`contents` to some :data:`xref`" msgstr "PDF 전용: 페이지의 :data:`contents` 를 일부 :data:`xref` 로 설정" #: ../../functions.rst:54 4607ba0bc87a49029f60b94358164e9a msgid ":meth:`Page.wrap_contents`" msgstr "" #: ../../functions.rst:54 71d87e984ed1426f994fbda70a1d5acc msgid "wrap contents with stacking commands" msgstr "스택 명령으로 콘텐츠 래핑" #: ../../functions.rst:55 eab975358f5e45f88237eb38bf7efcc2 msgid ":meth:`css_for_pymupdf_font`" msgstr "" #: ../../functions.rst:55 7369ac5afa2a4f87af7504d05e2e95ec msgid "create CSS source for a font in package pymupdf_fonts" msgstr "pymupdf_fonts 패키지의 글꼴에 대한 CSS 소스 생성" #: ../../functions.rst:56 ea96727f97604aa2be9fd94c2b0e4e99 msgid ":meth:`paper_rect`" msgstr "" #: ../../functions.rst:56 4a64de49215140bb9095a7b744a6b10c msgid "return rectangle for a known paper format" msgstr "알려진 용지 형식에 대한 사각형 반환" #: ../../functions.rst:57 63fe68f42d76418396af541b4387963f msgid ":meth:`paper_size`" msgstr "" #: ../../functions.rst:57 bac6f74069d54638915a9402b2fdd32b msgid "return width, height for a known paper format" msgstr "알려진 용지 형식에 대한 너비, 높이 반환" #: ../../functions.rst:58 9d17a64027f048e89712567847e77387 msgid ":meth:`paper_sizes`" msgstr "" #: ../../functions.rst:58 0a3c490c678640d69903658293fb99cd msgid "dictionary of pre-defined paper formats" msgstr "사전 정의된 용지 형식의 딕셔너리" #: ../../functions.rst:59 95cabe729c624a44a074886bc5ba5370 msgid ":meth:`planish_line`" msgstr "" #: ../../functions.rst:59 2c80744fd3094705a838e077b3751f09 msgid "matrix to map a line to the x-axis" msgstr "선을 x축에 매핑하는 행렬" #: ../../functions.rst:60 6d4a42f1a6034615a841e64b17bd95c6 msgid ":meth:`recover_char_quad`" msgstr "" #: ../../functions.rst:60 7509fe7ee06541f2a83976c0820c751f msgid "compute the quad of a char (\"rawdict\")" msgstr "문자(\"rawdict\")의 쿼드 계산" #: ../../functions.rst:61 2dd22daf6b254298b3521c5d8c0c2fc1 msgid ":meth:`recover_line_quad`" msgstr "" #: ../../functions.rst:61 c17fb3f0647848dd9b2d0c9f3375a900 msgid "compute the quad of a subset of line spans" msgstr "라인 스팬의 하위 집합의 쿼드 계산" #: ../../functions.rst:62 69103e21e70648a2ab8f3cedab21fa40 msgid ":meth:`recover_quad`" msgstr "" #: ../../functions.rst:62 d6b90efa394f4fc98f8d557ba6118854 msgid "compute the quad of a span (\"dict\", \"rawdict\")" msgstr "스팬(\"dict\", \"rawdict\")의 쿼드 계산" #: ../../functions.rst:63 e95190855477414fa2fc9b2a462e4d1f msgid ":meth:`recover_span_quad`" msgstr "" #: ../../functions.rst:63 dae88b36bbbb4bbcbe86f14575a8c742 msgid "compute the quad of a subset of span characters" msgstr "스팬 문자의 하위 집합의 쿼드 계산" #: ../../functions.rst:64 a538219c85a948b5bc32b5a86f54ee04 msgid ":meth:`set_messages`" msgstr "" #: ../../functions.rst:64 76a9ba8c6de9444caf517346bcd72399 msgid "set destination of |PyMuPDF| messages." msgstr "|PyMuPDF| 메시지의 대상 설정." #: ../../functions.rst:65 fdb49d59408d4dec91a14dde94092f4f msgid ":meth:`sRGB_to_pdf`" msgstr "" #: ../../functions.rst:65 f871b9297499486d852fd3f0e8a3676a msgid "return PDF RGB color tuple from an sRGB integer" msgstr "sRGB 정수에서 PDF RGB 색상 튜플 반환" #: ../../functions.rst:66 327a435d7e884c0a902aafda1893f6a7 msgid ":meth:`sRGB_to_rgb`" msgstr "" #: ../../functions.rst:66 246a589ca6424f2b9c09f5e823900a8d msgid "return (R, G, B) color tuple from an sRGB integer" msgstr "sRGB 정수에서 (R, G, B) 색상 튜플 반환" #: ../../functions.rst:67 c26211e2c9694a568170ed73ec08e6f6 msgid ":meth:`unicode_to_glyph_name`" msgstr "" #: ../../functions.rst:67 d3eb6eb48d2d404eaaa3e9647e0a61f0 msgid "return glyph name from a unicode" msgstr "유니코드에서 글리프 이름 반환" #: ../../functions.rst:68 ac57370c0a6f47c3bed79dff45b3725c msgid ":meth:`get_tessdata`" msgstr "" #: ../../functions.rst:68 e421bbfb598845dbb4469660bec7f8ca msgid "locates the language support of the Tesseract-OCR installation" msgstr "Tesseract-OCR 설치의 언어 지원 위치 찾기" #: ../../functions.rst:69 30abe7bbaaf24d3ba1760238b668f05b msgid ":meth:`colors_pdf_dict`" msgstr "" #: ../../functions.rst:69 939ec09248774b08b319cff1387a78b3 msgid "return dict of color names." msgstr "색상 이름의 딕셔너리 반환." #: ../../functions.rst:70 08f7a427489c42dc81382f68ac951d07 msgid ":meth:`colors_wx_list`" msgstr "" #: ../../functions.rst:70 c03e3b32246e48eca7222869de63d165 msgid "return list of color names." msgstr "색상 이름의 리스트 반환." #: ../../functions.rst:71 00ff5455c39348df865165ef97c332e5 msgid ":attr:`fitz_fontdescriptors`" msgstr "" #: ../../functions.rst:71 29c5c32218fe4af9b066941c79193e99 msgid "dictionary of available supplement fonts" msgstr "사용 가능한 보조 글꼴의 딕셔너리" #: ../../functions.rst:72 5e5557a7d7264b349905502aa39e0262 msgid ":attr:`PYMUPDF_MESSAGE`" msgstr "" #: ../../functions.rst:72 12be48b55f14460a82c486c307066c6b msgid "destination of |PyMuPDF| messages." msgstr "|PyMuPDF| 메시지의 대상." #: ../../functions.rst:73 93033092a17644e796bdfc012b3fe2ed msgid ":attr:`pdfcolor`" msgstr "" #: ../../functions.rst:73 e11234c49747439eb115b333174c8a11 msgid "dictionary of almost 500 RGB colors in PDF format." msgstr "PDF 형식의 약 500개의 RGB 색상 딕셔너리." #: ../../functions.rst:78 7731072bafdc4e0e948164d83aac73e6 msgid "" "Convenience function to return width and height of a known paper format " "code. These values are given in pixels for the standard resolution 72 " "pixels = 1 inch." msgstr "" "알려진 용지 형식 코드의 너비와 높이를 반환하는 편의 함수. 이러한 값은 표준 해상도 72 픽셀 = 1 인치에 대한 픽셀 단위로 " "제공됩니다." #: ../../functions.rst:80 97f1a71cac764c60a6158645492260ad msgid "" "Currently defined formats include **'A0'** through **'A10'**, **'B0'** " "through **'B10'**, **'C0'** through **'C10'**, **'Card-4x6'**, **'Card-" "5x7'**, **'Commercial'**, **'Executive'**, **'Invoice'**, **'Ledger'**, " "**'Legal'**, **'Legal-13'**, **'Letter'**, **'Monarch'** and **'Tabloid-" "Extra'**, each in either portrait or landscape format." msgstr "" "현재 정의된 형식에는 **'A0'** 부터 **'A10'**, **'B0'** 부터 **'B10'**, **'C0'** 부터 " "**'C10'**, **'Card-4x6'**, **'Card-5x7'**, **'Commercial'**, " "**'Executive'**, **'Invoice'**, **'Ledger'**, **'Legal'**, " "**'Legal-13'**, **'Letter'**, **'Monarch'** 및 **'Tabloid-Extra'** 가 포함되며," " 각각 세로 또는 가로 형식으로 제공됩니다." #: ../../functions.rst:82 dc2a6be14366471dac1a6479494f9346 msgid "" "A format name must be supplied as a string (case **in** \\sensitive), " "optionally suffixed with \"-L\" (landscape) or \"-P\" (portrait). No " "suffix defaults to portrait." msgstr "" "형식 이름은 문자열로 제공해야 하며(대소문자 **구분 안 함**), 선택적으로 \"-L\"(가로) 또는 \"-P\"(세로) 접미사를" " 붙일 수 있습니다. 접미사가 없으면 기본값은 세로입니다." #: ../../functions.rst 03018f66ae484e3db8b6ad2826a044cf #: 0a0669e521764612bda971525dda452a 12ea19fbec324aef8554866eb1efd555 #: 17b4cefc4a164f34978aa987685343a9 1b57ba0eba1e416191010aa7a215b711 #: 1cab8cc500bf48f18a85666579c09fbc 2e96fcb875274281a1347e2eb8addec5 #: 31229e3f712b437c916b0d922411d521 34b10c8b64ee455e952eb5d9cf6b1a80 #: 3613e5ea12d44c5ab4fa219e92529752 398a306ab671437a9988c3756ab7f425 #: 4d5566460617441d84c1f6d527cd4344 509f8e751d5e457699d9a42dc3f0644e #: 58d7dd92da694affb15906f8055cb2f3 60884d82c6ed41c6b0fb30f10c530bc3 #: 6f3e16b01a7e48b7b1286e84bec92f65 70099bc7029b4653a4ce215f5ea21068 #: a5509eb13e9646f48b334f69990300d2 a89151cf3f0740db85a479f2b9b73349 #: aba1d83a80594c35822fea6ded9b9e92 abb1fc81a69a4ce39c3973f59c1ad4b4 #: b2e60629a7ef4d0cb426b6f6e36f1f6f deb835e391664727a28f3d7f49008950 msgid "Parameters" msgstr "매개변수" #: ../../functions.rst:84 868bc857e3eb4ca9a79d072abe89f452 msgid "" "any format name from above in upper or lower case, like *\"A4\"* or " "*\"letter-l\"*." msgstr "위의 형식 이름 중 하나를 대문자 또는 소문자로 지정합니다. 예: *\"A4\"* 또는 *\"letter-l\"*." #: ../../functions.rst 022a9111972c43f4ac95797e47e55115 #: 0c19eadddcc246f6b494636250447fd1 1227b7b4025342248b7726eb436fd672 #: 1344025ac05b4743ab3452c49485b456 16ed36a80352404c9f6b780307f76f2c #: 1a3722844c9c4028b4ca575c633677f8 1e874c6b85ad41ff8d39bd66d4b10459 #: 20d12996ad564b01a013abcf0a595b1b 20ffe31a11ee480896d6d653dbfabe62 #: 2b70ab4546fa4726935510a1e9c6ea1e 32862398c7664800a5f7d7e0ac8dd3a4 #: 468d0e15495548d081abcad8b54b977b 5629f3d073a446cb8a7d2cad64ae5a6e #: 72190288375c4d32a56d69d0e5939fe5 741a274045a04f929fcfa2c3b8b92f2d #: 88398cfff97c477db1e260b56fb9eb7b 8d70daaf324943269c7d19f63b2cc8fe #: 8d9d283148974c8ca3abfd33d28287fe 90882dfe77d24383867c3af45e603974 #: a3c6fbb9de8a4f588b1c288c68c4cca3 aab4d395713b4379a065a2abb64849de #: b546dccfca404e0580e50b1fc6e5ad44 c709831c399146dfb8bd4fe3167a8938 #: f354716ed65b417ca129e97964f83aa0 msgid "Return type" msgstr "반환 타입" #: ../../functions.rst 054986a55bd8412684d7d1053e95c27a #: 0f142076b64b4989b3743f8c7ef4cc0a 32f469a0c91b4a868a39b83f799dd678 #: 349444e692d0463e96ec95137f014f3c 3b461c671ee044138d2bdc62333e42d0 #: 3df66e6bef0d4ea7bf65e4b3638bfb69 5902d0ef2d20466abff84b79b17d8841 #: 6573f0a01dc743d892cfd7006b7cfd57 71a7252151694deab2d3caf80063f899 #: 7d76e05a4b3a4af7b9cad032b510bac6 87784bbec007408e8916cc06e9591342 #: 94c68ca6fcc44b10a660ad293abeeff5 97ee6ea8100b4074aaa5cf8a2c54ab88 #: 9f4a7c0053e141358a36dadc8edd4499 a181be36d67549dab9959ecd33a5c311 #: a20bf25fcc4c453cb352fd964286b1a3 a4183c4f8c0f43eb9e5d7c163475b746 #: a66431d0340e41be826a4392175765a7 b6ec04a4323e457488d3a34c4e2dd176 #: d2a6377848154565a05fc9112dd958ca db6ae0d1dc96463cb4f8ccf9885b98d0 #: df98ff1830f843c7b39c5f50c02a93b2 e03a4ce2cc7248f5952c69d5abcf55b9 #: e532dd33e4cf433a87145131fdb015b3 f4d244d00c2845ec820bba3e866fd756 msgid "Returns" msgstr "반환값" #: ../../functions.rst:87 b03cca1df3ff43cab3ebafdcc5ea4396 msgid "" "*(width, height)* of the paper format. For an unknown format *(-1, -1)* " "is returned. Examples: *pymupdf.paper_size(\"A4\")* returns *(595, 842)* " "and *pymupdf.paper_size(\"letter-l\")* delivers *(792, 612)*." msgstr "" "용지 형식의 *(너비, 높이)*. 알 수 없는 형식의 경우 *(-1, -1)* 이 반환됩니다. 예: " "*pymupdf.paper_size(\"A4\")* 는 *(595, 842)* 를 반환하고 " "*pymupdf.paper_size(\"letter-l\")* 는 *(792, 612)* 를 반환합니다." #: ../../functions.rst:93 39ac61c8acfe4795ad45ca2ed8ae6b2a msgid "Convenience function to return a :ref:`Rect` for a known paper format." msgstr "알려진 용지 형식에 대한 :ref:`Rect` 를 반환하는 편의 함수." #: ../../functions.rst:95 79ce3e075e8047c38fdca8e47040ce19 msgid "any format name supported by :meth:`paper_size`." msgstr ":meth:`paper_size` 에서 지원하는 모든 형식 이름." #: ../../functions.rst:97 6a4b32efe8dd4b0bb8cfd7c6d4b2e4d8 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../functions.rst:98 81a23800b837456cbe9205a60c034ab2 msgid "" "*pymupdf.Rect(0, 0, width, height)* with *width, " "height=pymupdf.paper_size(s)*." msgstr "" "*width, height=pymupdf.paper_size(s)* 를 사용한 *pymupdf.Rect(0, 0, width, height)*." #: ../../functions.rst:109 69c645e94932478f9f3362f568160204 msgid "" "Sets destination of |PyMuPDF| messages to a file descriptor, a file, an " "existing stream or `Python's logging system " "`_." msgstr "" "|PyMuPDF| 메시지의 대상을 파일 디스크립터, 파일, 기존 스트림 또는 `Python의 로깅 시스템 " "`_ 로 설정합니다." #: ../../functions.rst:113 7cbb49615dd5446788c1e7343992b3bd msgid "Usually one would only set one arg, or one or more `pylogging*` args." msgstr "일반적으로 하나의 인수만 설정하거나 하나 이상의 `pylogging*` 인수를 설정합니다." #: ../../functions.rst:115 41d549d619b941e490f0d67a2715a734 msgid "" "A text specification of destination; for details see description of " "environmental variable `PYMUPDF_MESSAGE`." msgstr "대상의 텍스트 사양. 자세한 내용은 환경 변수 `PYMUPDF_MESSAGE` 의 설명을 참조하세요." #: ../../functions.rst:118 489041f4541c47ef9f9e52c6ae05cc96 msgid "Write to file descriptor." msgstr "파일 디스크립터에 쓰기." #: ../../functions.rst:120 47f7f62ceba74f72adcdf0944e9bbb79 msgid "" "Write to existing stream, which must have methods `.write(text)` and " "`.flush()`." msgstr "기존 스트림에 쓰기. `.write(text)` 및 `.flush()` 메서드가 있어야 합니다." #: ../../functions.rst:123 deed94f7b3d04f22b1978ac275a22d14 msgid "Write to a file." msgstr "파일에 쓰기." #: ../../functions.rst:125 d6010f301c214ee981634923329e3b3e msgid "Append to a file." msgstr "파일에 추가." #: ../../functions.rst:127 581212acd9564c1d982afd047cead7b8 msgid "Write to Python's `logging` system." msgstr "Python의 `logging` 시스템에 쓰기." #: ../../functions.rst:129 7082305f15f14e479a4f01f1b5e7cea6 msgid "Write to Python's `logging` system using specified Logger." msgstr "지정된 Logger를 사용하여 Python의 `logging` 시스템에 쓰기." #: ../../functions.rst:131 05eb0dcaf9644b748efa489fccc348d2 msgid "Write to Python's `logging` system using specified level." msgstr "지정된 레벨을 사용하여 Python의 `logging` 시스템에 쓰기." #: ../../functions.rst:133 cedfea3990d24cf1a7929a33284b11a0 msgid "" "Write to Python's `logging` system using specified logger name. Only used" " if `pylogging_logger` is ``None``. Default is `pymupdf`." msgstr "" "지정된 로거 이름을 사용하여 Python의 `logging` 시스템에 쓰기. `pylogging_logger` 가 ``None`` " "인 경우에만 사용됩니다. 기본값은 `pymupdf` 입니다." #: ../../functions.rst:137 777f45cd7d524f84942d9fe412c18edd msgid "" "If any `pylogging*` arg is not ``None``, we write to `Python's logging " "system `_." msgstr "" "`pylogging*` 인수가 ``None`` 이 아니면 `Python의 로깅 시스템 `_ 에 씁니다." #: ../../functions.rst:144 ../../functions.rst:156 ../../functions.rst:270 #: 69f05cfe1b654ab19e0011a944260bec 7558bf3ff3b845559657a578039f1ef0 #: c30fc7f1a9e343bbb4c5e4c8fbbfb032 msgid "*New in v1.17.4*" msgstr "*v1.17.4에서 새로 추가됨*" #: ../../functions.rst:146 895bc494383147339ecd407d7f8feece msgid "" "Convenience function returning a PDF color triple (red, green, blue) for " "a given sRGB color integer as it occurs in :meth:`Page.get_text` " "dictionaries \"dict\" and \"rawdict\"." msgstr "" ":meth:`Page.get_text` 딕셔너리 \"dict\" 및 \"rawdict\" 에서 발생하는 것처럼 주어진 sRGB 색상 정수에 대한 PDF 색상 삼중(빨강, 녹색, 파랑)을 반환하는 편의 함수." #: ../../functions.rst:148 ../../functions.rst:160 #: 017bfb28972946b7afeddc4aa2d96999 7ff4d5ab9e154081be8ea600c0631ffd msgid "" "an integer of format RRGGBB, where each color component is an integer in " "range(255)." msgstr "" "RRGGBB 형식의 정수로, 각 색상 구성 요소는 range(255)의 정수입니다." #: ../../functions.rst:150 37c7bbd5421d4b18b180482fc18889da msgid "" "a tuple (red, green, blue) with float items in interval *0 <= item <= 1* " "representing the same color. Example `sRGB_to_pdf(0xff0000) = (1, 0, 0)` " "(red)." msgstr "" "동일한 색상을 나타내는 *0 <= item <= 1* 구간의 float 항목을 가진 튜플(빨강, 녹색, 파랑). 예: `sRGB_to_pdf(0xff0000) = (1, 0, 0)` (빨강)." #: ../../functions.rst:158 b3779d6ff2064b7191d22f03dc12b37d msgid "" "Convenience function returning a color (red, green, blue) for a given " "*sRGB* color integer." msgstr "" "주어진 *sRGB* 색상 정수에 대한 색상(빨강, 녹색, 파랑)을 반환하는 편의 함수." #: ../../functions.rst:162 c2e711f095d845dcbbb6d1599bf1d8bb msgid "" "a tuple (red, green, blue) with integer items in `range(256)` " "representing the same color. Example `sRGB_to_pdf(0xff0000) = (255, 0, " "0)` (red)." msgstr "" "동일한 색상을 나타내는 `range(256)` 의 정수 항목을 가진 튜플(빨강, 녹색, 파랑). 예: `sRGB_to_pdf(0xff0000) = (255, 0, 0)` (빨강)." #: ../../functions.rst:168 ../../functions.rst:183 ../../functions.rst:198 #: ../../functions.rst:211 0330c6db37ba44e7b01d3331832a082a #: 59756c59d51a4bf59c7c44211fc57b99 c8e9f36450234d3293d8445774911e5d #: d0ad94f8dbd24dd5adb1fc709cde1c9e msgid "*New in v1.18.0*" msgstr "*v1.18.0에서 새로 추가됨*" #: ../../functions.rst:170 18f6f71df9e4437e91b15db0811f02e1 msgid "" "Return the unicode number of a glyph name based on the **Adobe Glyph " "List**." msgstr "" "**Adobe Glyph List**를 기반으로 글리프 이름의 유니코드 번호를 반환합니다." #: ../../functions.rst:172 2ea221eaae354e3a8696af8d26a6727c msgid "" "the name of some glyph. The function is based on the `Adobe Glyph List " "`_." msgstr "" "일부 글리프의 이름. 이 함수는 `Adobe Glyph List `_ 에 기반합니다." #: ../../functions.rst:175 9cab0f810cd041b7b19a385d41b3de4d msgid "the unicode. Invalid ``name`` entries return `0xfffd (65533)`." msgstr "유니코드. 유효하지 않은 ``name`` 항목은 `0xfffd (65533)` 을 반환합니다." #: ../../functions.rst:177 ../../functions.rst:205 ../../functions.rst:218 #: 8ae7164314a54d298a84c72740a19a67 bdcaf136335b4029a886ece439c7db85 #: e4acb745507b430e8af6df66d695d76c msgid "" "A similar functionality is provided by package `fontTools " "`_ in its *agl* sub-package." msgstr "" "유사한 기능이 `fontTools `_ 패키지의 *agl* 하위 패키지에서 제공됩니다." #: ../../functions.rst:185 75a5eea668644ca5ad66e78b8f46f33b msgid "" "Return the glyph name of a unicode number, based on the **Adobe Glyph " "List**." msgstr "" "**Adobe Glyph List**를 기반으로 유니코드 번호의 글리프 이름을 반환합니다." #: ../../functions.rst:187 65f19a9b48e14e2caf273c0cd10e1127 #: 96ee3f05d61747f7adbf5b5d3abd3e7a msgid "" "the unicode given by e.g. `ord(\"ß\")`. The function is based on the " "`Adobe Glyph List `_." msgstr "" "예를 들어 `ord(\"ß\")` 로 주어진 유니코드. 이 함수는 `Adobe Glyph List `_ 에 기반합니다." #: ../../functions.rst:190 85951f82646148b184f726f54c1aacd6 msgid "" "the glyph name. E.g. `pymupdf.unicode_to_glyph_name(ord(\"Ä\"))` returns " "`'Adieresis'`." msgstr "" "글리프 이름. 예: `pymupdf.unicode_to_glyph_name(ord(\"Ä\"))` 는 `'Adieresis'` 를 반환합니다." #: ../../functions.rst:192 bd7a7f8035ae48c1b94b6a14beff47cc msgid "" "A similar functionality is provided by package `fontTools " "`_: in its *agl* sub-package." msgstr "" "유사한 기능은 패키지 `fontTools `_ 의 *agl* 하위" " 패키지에서 제공됩니다." #: ../../functions.rst:200 ea6d8435122e4e03b457b6c4f74f77f2 msgid "Return a list of glyph names defined in the **Adobe Glyph List**." msgstr "**Adobe Glyph List** 에 정의된 글리프 이름 목록을 반환합니다." #: ../../functions.rst:203 67cf198df6114dd3804a1ba80c9c67ce msgid "list of strings." msgstr "문자열 목록." #: ../../functions.rst:213 0041733db7e64ba8a5350f0ea22c9eec msgid "" "Return a list of unicodes for there exists a glyph name in the **Adobe " "Glyph List**." msgstr "**Adobe Glyph List** 에 글리프 이름이 존재하는 유니코드 목록을 반환합니다." #: ../../functions.rst:216 1a1ca8f4c0ee415cac54b1fbbf966aac msgid "list of integers." msgstr "정수 목록." #: ../../functions.rst:224 91d0f084f22d40789e29edca8cc4b512 msgid "*New in v1.21.0*" msgstr "*v1.21.0의 새로운 기능*" #: ../../functions.rst:226 bfdbc87798434761bc202a2afdb0db2a msgid "**Utility function for use with \"Story\" applications.**" msgstr "**\"Story\" 애플리케이션에서 사용하기 위한 유틸리티 함수.**" #: ../../functions.rst:228 eb5487e982fa40b08c6ef9ec4d4d585f msgid "" "Create CSS `@font-face` items for the given fontcode in pymupdf-fonts. " "Creates a CSS font-family for all fonts starting with string " "\"fontcode\"." msgstr "" "pymupdf-fonts에서 주어진 fontcode에 대한 CSS `@font-face` 항목을 생성합니다. 문자열 " "\"fontcode\"로 시작하는 모든 글꼴에 대한 CSS font-family를 생성합니다." #: ../../functions.rst:230 136c05d535f84f80ba229db14ba5e027 msgid "" "The font naming convention in package pymupdf-fonts is \"fontcode\", " "where the suffix \"sf\" is one of \"\" (empty), \"it\"/\"i\", " "\"bo\"/\"b\" or \"bi\". These suffixes thus represent the regular, " "italic, bold or bold-italic variants of that font." msgstr "" "패키지 pymupdf-fonts의 글꼴 명명 규칙은 \"fontcode\"이며, 여기서 접미사 \"sf\"는 \"\"(비어 " "있음), \"it\"/\"i\", \"bo\"/\"b\" 또는 \"bi\" 중 하나입니다. 이러한 접미사는 따라서 해당 글꼴의 " "일반, 기울임꼴, 굵게 또는 굵은 기울임꼴 변형을 나타냅니다." #: ../../functions.rst:232 73f3ec03772745dcb664d3338f909e69 msgid "For example, font code \"notos\" refers to fonts" msgstr "예를 들어, 글꼴 코드 \"notos\"는 다음 글꼴을 나타냅니다" #: ../../functions.rst:234 ab848e07a9544eb0a4a64619cb70670d msgid "\"notos\" - \"Noto Sans Regular\"" msgstr "\"notos\" - \"Noto Sans Regular\"" #: ../../functions.rst:235 f820847aafbf425fa170b1083abd9056 msgid "\"notosit\" - \"Noto Sans Italic\"" msgstr "\"notosit\" - \"Noto Sans Italic\"" #: ../../functions.rst:236 524c95238e1f4af6945c40428fea8d5a msgid "\"notosbo\" - \"Noto Sans Bold\"" msgstr "\"notosbo\" - \"Noto Sans Bold\"" #: ../../functions.rst:237 d6a7415ca6e448e0afcac405b692a483 msgid "\"notosbi\" - \"Noto Sans Bold Italic\"" msgstr "\"notosbi\" - \"Noto Sans Bold Italic\"" #: ../../functions.rst:239 7682199165a64e699943ec683a5dbae8 msgid "" "The function creates (up to) four CSS `@font-face` definitions and " "collectively assigns the `font-family` name \"notos\" to them (or the " "\"name\" value if provided). Associated font buffers are placed / added " "to the provided archive." msgstr "" "함수는 (최대) 4개의 CSS `@font-face` 정의를 생성하고 `font-family` 이름 \"notos\"(또는 제공된 " "경우 \"name\" 값)를 집합적으로 할당합니다. 연결된 글꼴 버퍼는 제공된 아카이브에 배치/추가됩니다." #: ../../functions.rst:241 d60c58db166f4865ba6c5a96c0935714 msgid "" "To use the font in the Python API for :ref:`Story`, execute " "`.set_font(fontcode)` (or \"name\" if given). The correct font weight or " "style will automatically be selected as required." msgstr "" ":ref:`Story` 의 Python API에서 글꼴을 사용하려면 `.set_font(fontcode)` (또는 주어진 경우 " "\"name\")를 실행하세요. 올바른 글꼴 두께 또는 스타일이 필요에 따라 자동으로 선택됩니다." #: ../../functions.rst:243 f4c204d386b647d0a61c376c3c13681d msgid "" "For example to replace the \"sans-serif\" HTML standard (i.e. Helvetica) " "with the above \"notos\", execute the following. Whenever \"sans-serif\" " "is used (whether explicitly or implicitly), the Noto Sans fonts will be " "selected." msgstr "" "예를 들어 위의 \"notos\"로 \"sans-serif\" HTML 표준(즉, Helvetica)을 대체하려면 다음을 " "실행하세요. \"sans-serif\"가 사용될 때마다(명시적으로든 암시적으로든) Noto Sans 글꼴이 선택됩니다." #: ../../functions.rst:245 eabaed48beb946e58d8a1dc9579bb770 msgid "" "`CSS = pymupdf.css_for_pymupdf_font(\"notos\", name=\"sans-serif\", " "archive=...)`" msgstr "" "`CSS = pymupdf.css_for_pymupdf_font(\"notos\", name=\"sans-serif\", " "archive=...)`" #: ../../functions.rst:247 45820ea5c1c34abe9086286b089e5835 msgid "Expects and returns the CSS source, with the new CSS definitions appended." msgstr "CSS 소스를 받아서 새로운 CSS 정의가 추가된 CSS 소스를 반환합니다." #: ../../functions.rst:249 f8e31e8254fc4695a916866897562c67 msgid "" "one of the font codes present in package `pymupdf-fonts " "`_ (usually) representing the " "regular version of the font family." msgstr "" "패키지 `pymupdf-fonts `_ 에 있는 글꼴 코드" " 중 하나(일반적으로 글꼴 패밀리의 일반 버전을 나타냄)." #: ../../functions.rst:250 92f43cf88a624b93bd22752d8bf64bd1 msgid "" "any already existing CSS source, or `None`. The function will append its " "new definitions to this. This is the string that **must be used** as " "`user_css` when creating the :ref:`Story`." msgstr "" "기존 CSS 소스 또는 `None`. 함수는 새로운 정의를 여기에 추가합니다. 이것은 :ref:`Story` 를 생성할 때 " "`user_css` 로 **사용해야 하는** 문자열입니다." #: ../../functions.rst:251 513bb69848834f1b8ee131ac15a8d498 msgid "" ":ref:`Archive`, **mandatory**. All font binaries (i.e. up to four) found " "for \"fontcode\" will be added to the archive. This is the archive that " "**must be used** as `archive` when creating the :ref:`Story`." msgstr "" ":ref:`Archive`, **필수**. \"fontcode\"에 대해 찾은 모든 글꼴 바이너리(최대 4개)가 아카이브에 " "추가됩니다. 이것은 :ref:`Story` 를 생성할 때 `archive` 로 **사용해야 하는** 아카이브입니다." #: ../../functions.rst:252 5497d854266c41399b06bd35ad5f9084 msgid "" "the name under which the \"fontcode\" fonts should be found. If omitted, " "\"fontcode\" will be used." msgstr "\"fontcode\" 글꼴을 찾을 이름. 생략하면 \"fontcode\"가 사용됩니다." #: ../../functions.rst:255 f98ee439f50d4dfe8df6c0efbd7b7815 msgid "" "Modified CSS, with appended `@font-face` statements for each font variant" " of fontcode. Fontbuffers associated with \"fontcode\" will have been " "added to 'archive'. The function will automatically find up to 4 font " "variants. All pymupdf-fonts (that are no special purpose like math or " "music, etc.) have regular, bold, italic and bold-italic variants. To see " "currently available font codes check " "`pymupdf.fitz_fontdescriptors.keys()`. This will show something like " "`dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', " "'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', " "'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', " "'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', " "'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])`." msgstr "" "fontcode의 각 글꼴 변형에 대한 `@font-face` 문이 추가된 수정된 CSS. \"fontcode\"와 연결된 " "Fontbuffers가 'archive'에 추가됩니다. 함수는 자동으로 최대 4개의 글꼴 변형을 찾습니다. 모든 pymupdf-" "fonts(수학이나 음악 등 특수 목적이 아닌 것)는 일반, 굵게, 기울임꼴 및 굵은 기울임꼴 변형을 가지고 있습니다. 현재 사용 " "가능한 글꼴 코드를 확인하려면 `pymupdf.fitz_fontdescriptors.keys()` 를 확인하세요. 이것은 " "`dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', " "'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', " "'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', " "'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', " "'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])` 와 같은 것을 " "보여줍니다." #: ../../functions.rst:257 3526f7b9559347458786dc7c33a512d5 msgid "" "Here is a complete snippet for using the \"Noto Sans\" font instead of " "\"Helvetica\"::" msgstr "\"Helvetica\" 대신 \"Noto Sans\" 글꼴을 사용하는 완전한 코드 조각입니다::" #: ../../functions.rst:272 48272a37d69845059cb56a9a1f7d309d msgid "" "Convenience function to split a rectangle into sub-rectangles of equal " "size. Returns a list of `rows` lists, each containing `cols` :ref:`Rect` " "items. Each sub-rectangle can then be addressed by its row and column " "index." msgstr "" "사각형을 동일한 크기의 하위 사각형으로 분할하는 편의 함수. `rows` 리스트의 리스트를 반환하며, 각 리스트는 `cols` 개의" " :ref:`Rect` 항목을 포함합니다. 각 하위 사각형은 행 및 열 인덱스로 주소를 지정할 수 있습니다." #: ../../functions.rst:274 5536e164169a48f4bdd4363a4f4836d1 msgid "the rectangle to split." msgstr "분할할 사각형." #: ../../functions.rst:275 5f0d1ca61442423c8f9a62f957ac7d34 msgid "the desired number of columns." msgstr "원하는 열 수." #: ../../functions.rst:276 ee278d86b78145a58993d0a15b118289 msgid "the desired number of rows." msgstr "원하는 행 수." #: ../../functions.rst:277 06fb832e511d432a92019b0b3e60d399 msgid "" "a list of :ref:`Rect` objects of equal size, whose union equals *rect*. " "Here is the layout of a 3x4 table created by `cell = " "pymupdf.make_table(rect, cols=4, rows=3)`:" msgstr "" "동일한 크기의 :ref:`Rect` 객체 리스트. 이들의 합집합은 *rect* 와 같습니다. `cell = " "pymupdf.make_table(rect, cols=4, rows=3)` 로 생성된 3x4 테이블의 레이아웃은 다음과 같습니다:" #: ../../functions.rst:287 8bba6d4c49f7447da9e1223dd3e1e7d7 msgid "New in version 1.16.2)*" msgstr "*버전 1.16.2의 새로운 기능*" #: ../../functions.rst:289 2442a2770c3c4ff4af3b3eb24a2a6f1c msgid "" "Return a matrix which maps the line from p1 to p2 to the x-axis such that" " p1 will become (0,0) and p2 a point with the same distance to (0,0)." msgstr "" "p1에서 p2로의 선을 x축에 매핑하는 행렬을 반환합니다. p1은 (0,0)이 되고 p2는 (0,0)까지의 동일한 거리를 가진 점이" " 됩니다." #: ../../functions.rst:291 ea959e9b36794857b92ea27d46682d48 msgid "starting point of the line." msgstr "선의 시작점." #: ../../functions.rst:292 9e2c74d180cb496b89b4fed901585712 msgid "end point of the line." msgstr "선의 끝점." #: ../../functions.rst:294 82cd715a4eaa45dca15ea53c40895156 msgid ":ref:`Matrix`" msgstr ":ref:`Matrix`" #: ../../functions.rst:295 b686e23a96744387bcbaa202c667de89 msgid "" "a matrix which combines a rotation and a translation:: >>> p1 = " "pymupdf.Point(1, 1) >>> p2 = pymupdf.Point(4, 5) >>> abs(p2 - p1) " "# distance of points 5.0 >>> m = pymupdf.planish_line(p1, p2) " ">>> p1 * m Point(0.0, 0.0) >>> p2 * m Point(5.0, " "-5.960464477539063e-08) >>> # distance of the resulting points >>> " "abs(p2 * m - p1 * m) 5.0 .. image:: images/img-planish.png " ":scale: 40" msgstr "" #: ../../functions.rst:295 80b98e912fd147ed91827592eef3d5ad msgid "a matrix which combines a rotation and a translation::" msgstr "회전과 이동을 결합한 행렬::" #: ../../functions.rst:319 b8be325123d8488bb925de622de9d53c msgid "" "A dictionary of pre-defines paper formats. Used as basis for " ":meth:`paper_size`." msgstr "사전 정의된 용지 형식의 딕셔너리. :meth:`paper_size` 의 기반으로 사용됩니다." #: ../../functions.rst:325 406401efed724a1887a2096b373b32b3 msgid "New in v1.17.5" msgstr "*v1.17.5의 새로운 기능*" #: ../../functions.rst:327 7a0262b74b314f1fa78cc0f0f957e5b5 msgid "" "A dictionary of usable fonts from repository `pymupdf-fonts " "`_. Items are keyed by their " "reserved fontname and provide information like this::" msgstr "" "저장소 `pymupdf-fonts `_ 에서 사용 가능한 " "글꼴의 딕셔너리. 항목은 예약된 글꼴 이름으로 키가 지정되며 다음과 같은 정보를 제공합니다::" #: ../../functions.rst:343 9187429ec1b74d7ca17a69875896bb76 msgid "If `pymupdf-fonts` is not installed, the dictionary is empty." msgstr "`pymupdf-fonts` 가 설치되지 않은 경우 딕셔너리는 비어 있습니다." #: ../../functions.rst:345 201981860f614a1da8206b560d991027 msgid "" "The dictionary keys can be used to define a :ref:`Font` via e.g. `font = " "pymupdf.Font(\"fimo\")` -- just like you can do it with the builtin fonts" " \"Helvetica\" and friends." msgstr "" "딕셔너리 키는 예를 들어 `font = pymupdf.Font(\"fimo\")` 를 통해 :ref:`Font` 를 정의하는 데 " "사용할 수 있습니다 -- 내장 글꼴 \"Helvetica\" 등과 동일하게 사용할 수 있습니다." #: ../../functions.rst:351 96bc790c2f3c41eab4eb03e2bbb91044 msgid "" "If in `os.environ` when |PyMuPDF| is imported, sets destination of " "|PyMuPDF| messages. Otherwise messages are sent to `sys.stdout`." msgstr "" "|PyMuPDF| 가 가져올 때 `os.environ` 에 있으면 |PyMuPDF| 메시지의 대상을 설정합니다. 그렇지 않으면 " "메시지는 `sys.stdout` 으로 전송됩니다." #: ../../functions.rst:355 d3a34a5171b84ddc975fd680a2c1d896 msgid "" "If the value starts with `fd:`, the remaining text should be an integer " "file descriptor to which messages are written." msgstr "값이 `fd:` 로 시작하면 나머지 텍스트는 메시지가 기록되는 정수 파일 디스크립터여야 합니다." #: ../../functions.rst:358 26b2a3b05c144932bd212022dc818718 msgid "For example `PYMUPDF_MESSAGE=fd:2` will send messages to stderr." msgstr "예를 들어 `PYMUPDF_MESSAGE=fd:2` 는 메시지를 stderr로 보냅니다." #: ../../functions.rst:360 a9af399eca6b4eafacdee7e4514b60ca msgid "" "If the value starts with `path:`, the remaining text is the path of a " "file to which messages are written. If the file already exists, it is " "truncated." msgstr "값이 `path:` 로 시작하면 나머지 텍스트는 메시지가 기록되는 파일의 경로입니다. 파일이 이미 존재하면 잘립니다." #: ../../functions.rst:364 0d31927b8e434b3680bbc7e7a528b8ba msgid "" "If the value starts with `path+:`, the remaining text is the path of file" " to which messages are written. If the file already exists, we append " "output." msgstr "값이 `path+:` 로 시작하면 나머지 텍스트는 메시지가 기록되는 파일의 경로입니다. 파일이 이미 존재하면 출력을 추가합니다." #: ../../functions.rst:369 367ef9d38b324a2e92535daa15463fd4 msgid "" "If the value starts with `logging:`, messages are written to `Python's " "logging system `_. The " "remaining text can contain comma-separated name=value items:" msgstr "" "값이 `logging:` 로 시작하면 메시지는 `Python의 로깅 시스템 " "`_ 에 기록됩니다. 나머지 텍스트는 쉼표로 " "구분된 name=value 항목을 포함할 수 있습니다:" #: ../../functions.rst:373 727cdb80e0e9424b82a78c9fcf4131ea msgid "`level=` sets the logging level." msgstr "`level=` 는 로깅 레벨을 설정합니다." #: ../../functions.rst:374 cbd781fbde1b482097f102a847dc8399 msgid "`name=` sets the logger name (default is `pymupdf`)." msgstr "`name=` 는 로거 이름을 설정합니다(기본값은 `pymupdf`)." #: ../../functions.rst:376 4f25318185b745a7af1b120f78e29eb8 msgid "Other items are ignored." msgstr "다른 항목은 무시됩니다." #: ../../functions.rst:378 df67601c54d341f5bd7a2d06718b136b msgid "Other prefixes will cause an error." msgstr "다른 접두사는 오류를 발생시킵니다." #: ../../functions.rst:380 d06c09c69e114e30aa122b24d91ad8c4 msgid "Also see `set_messages()`." msgstr "`set_messages()` 도 참조하세요." #: ../../functions.rst:387 834d76807609499695b186421da0488e msgid "New in v1.19.6" msgstr "*v1.19.6의 새로운 기능*" #: ../../functions.rst:389 f0b470d4413e4923a64200e0e1451914 msgid "" "Contains about 500 RGB colors in PDF format with the color name as key. " "To see what is there, you can obviously look at " "`pymupdf.pdfcolor.keys()`." msgstr "" "색상 이름을 키로 하는 PDF 형식의 약 500개의 RGB 색상을 포함합니다. 내용을 확인하려면 " "`pymupdf.pdfcolor.keys()` 를 확인할 수 있습니다." #: ../../functions.rst:391 c5aa4f5a3e6541f99de68bb1b49ffc9c msgid "Examples:" msgstr "예제:" #: ../../functions.rst:393 6198f065e39e4bdf98f3451ff9481bd5 msgid "`pymupdf.pdfcolor[\"red\"] = (1.0, 0.0, 0.0)`" msgstr "`pymupdf.pdfcolor[\"red\"] = (1.0, 0.0, 0.0)`" #: ../../functions.rst:394 46ae89359e384ceeb868dd2014c8c5a1 msgid "" "`pymupdf.pdfcolor[\"skyblue\"] = (0.5294117647058824, 0.807843137254902, " "0.9215686274509803)`" msgstr "" "`pymupdf.pdfcolor[\"skyblue\"] = (0.5294117647058824, 0.807843137254902, " "0.9215686274509803)`" #: ../../functions.rst:395 4fba859674ef468190d4d2fa416c1319 msgid "" "`pymupdf.pdfcolor[\"wheat\"] = (0.9607843137254902, 0.8705882352941177, " "0.7019607843137254)`" msgstr "" "`pymupdf.pdfcolor[\"wheat\"] = (0.9607843137254902, 0.8705882352941177, " "0.7019607843137254)`" #: ../../functions.rst:401 9772c54652e641db860a29f83e7fbe2d msgid "" "Convenience function to return the current local timestamp in PDF " "compatible format, e.g. *D:20170501121525-04'00'* for local datetime May " "1, 2017, 12:15:25 in a timezone 4 hours westward of the UTC meridian." msgstr "" "현재 로컬 타임스탬프를 PDF 호환 형식으로 반환하는 편의 함수. 예: UTC 자오선에서 서쪽으로 4시간 떨어진 시간대의 2017년" " 5월 1일 12:15:25 로컬 날짜/시간에 대한 *D:20170501121525-04'00'*." #: ../../functions.rst:404 5d740fbd9b1d47ff9ed232843a7ff7b5 msgid "current local PDF timestamp." msgstr "현재 로컬 PDF 타임스탬프." #: ../../functions.rst:410 0e8f792a9cd24c8bb5ee20240c898e8a msgid "New in version 1.14.7" msgstr "*버전 1.14.7의 새로운 기능*" #: ../../functions.rst:412 0a47fb8a49c04869ba92bff096b077ba msgid "" "Calculate the length of text on output with a given **builtin** font, " ":data:`fontsize` and encoding." msgstr "주어진 **내장** 글꼴, :data:`fontsize` 및 인코딩으로 출력 시 텍스트 길이를 계산합니다." #: ../../functions.rst:414 fdc381a3ed7e4fe1aabff23f87dfa215 msgid "the text string." msgstr "텍스트 문자열." #: ../../functions.rst:415 ec72804a2b8d4774987c66c5a1e9040c msgid "" "the font name. Must be one of either the :ref:`Base-14-Fonts` or the CJK " "fonts, identified by their \"reserved\" fontnames (see table in " ":meth:`Page.insert_font`)." msgstr "" "글꼴 이름. :ref:`Base-14-Fonts` 또는 \"예약된\" 글꼴 이름으로 식별되는 CJK 글꼴 중 하나여야 " "합니다(:meth:`Page.insert_font` 의 표 참조)." #: ../../functions.rst:416 8bd3348d8d3442778d7f1dae48bc7156 msgid "the :data:`fontsize`." msgstr ":data:`fontsize`." #: ../../functions.rst:417 ca5639a68e354aea8a51fc71a8a482e6 msgid "" "the encoding to use. Besides 0 = Latin, 1 = Greek and 2 = Cyrillic " "(Russian) are available. Relevant for Base-14 fonts \"Helvetica\", " "\"Courier\" and \"Times\" and their variants only. Make sure to use the " "same value as in the corresponding text insertion." msgstr "" "사용할 인코딩. 0 = Latin 외에 1 = Greek 및 2 = Cyrillic(러시아어)을 사용할 수 있습니다. Base-14" " 글꼴 \"Helvetica\", \"Courier\" 및 \"Times\"와 그 변형에만 관련됩니다. 해당 텍스트 삽입에서와 " "동일한 값을 사용해야 합니다." #: ../../functions.rst:419 acc35bea49374d9b96b4a881331de8c3 msgid "" "the length in points the string will have (e.g. when used in " ":meth:`Page.insert_text`)." msgstr "문자열이 가질 포인트 단위의 길이(예: :meth:`Page.insert_text` 에서 사용할 때)." #: ../../functions.rst:421 3dd546e78759471eb2f4224830083feb msgid "" "This function will only do the calculation -- it won't insert font nor " "text." msgstr "이 함수는 계산만 수행합니다 -- 글꼴이나 텍스트를 삽입하지 않습니다." #: ../../functions.rst:423 a55852432419412b8ce47fa7e5754945 msgid "" "The :ref:`Font` class offers a similar method, :meth:`Font.text_length`, " "which supports Base-14 fonts and any font with a character map (CMap, " "Type 0 fonts)." msgstr "" ":ref:`Font` 클래스는 유사한 메서드 :meth:`Font.text_length` 를 제공하며, Base-14 글꼴과 문자 " "맵(CMap, Type 0 글꼴)이 있는 모든 글꼴을 지원합니다." #: ../../functions.rst:425 244877b50d8d4d8daf1796a23b9b76bc msgid "" "If you use this function to determine the required rectangle width for " "the (:ref:`Page` or :ref:`Shape`) *insert_textbox* methods, be aware that" " they calculate on a **by-character level**. Because of rounding effects," " this will mostly lead to a slightly larger number: " "*sum([pymupdf.get_text_length(c) for c in text]) > " "pymupdf.get_text_length(text)*. So either (1) do the same, or (2) use " "something like *pymupdf.get_text_length(text + \"'\")* for your " "calculation." msgstr "" "이 함수를 사용하여 (:ref:`Page` 또는 :ref:`Shape`) *insert_textbox* 메서드에 필요한 사각형 " "너비를 결정하는 경우, 이들은 **문자 단위** 로 계산한다는 점에 유의하세요. 반올림 효과로 인해 대부분 약간 더 큰 숫자가 " "됩니다: *sum([pymupdf.get_text_length(c) for c in text]) > " "pymupdf.get_text_length(text)*. 따라서 (1) 동일하게 수행하거나 (2) 계산에 " "*pymupdf.get_text_length(text + \"'\")* 와 같은 것을 사용하세요." #: ../../functions.rst:431 27bb3947e15d491f9ae1a90557ac93c6 msgid "" "Make a PDF-compatible string: if the text contains code points *ord(c) > " "255*, then it will be converted to UTF-16BE with BOM as a hexadecimal " "character string enclosed in \"<>\" brackets like **. Otherwise," " it will return the string enclosed in (round) brackets, replacing any " "characters outside the ASCII range with some special code. Also, every " "\"(\", \")\" or backslash is escaped with a backslash." msgstr "" "PDF 호환 문자열 생성: 텍스트에 코드 포인트 *ord(c) > 255* 가 포함되어 있으면 BOM이 있는 UTF-16BE로 " "변환되어 ** 와 같이 \"<>\" 괄호로 둘러싸인 16진수 문자 문자열이 됩니다. 그렇지 않으면 (둥근) 괄호로 " "둘러싸인 문자열을 반환하며, ASCII 범위 밖의 모든 문자를 특수 코드로 대체합니다. 또한 모든 \"(\", \")\" 또는 " "백슬래시는 백슬래시로 이스케이프됩니다." #: ../../functions.rst:433 b4ad5c5ee1984abb8dd55c5b805e766b msgid "the object to convert" msgstr "변환할 객체" #: ../../functions.rst:436 fe9be159fa444a69823866ee3a644680 msgid "PDF-compatible string enclosed in either *()* or *<>*." msgstr "*()* 또는 *<>* 로 둘러싸인 PDF 호환 문자열." #: ../../functions.rst:442 d31809b727e34900979c3b181d3eaad1 msgid "New in v1.16.7" msgstr "*v1.16.7의 새로운 기능*" #: ../../functions.rst:443 d24cd05f8ec8403d9c6de79d9ab0d3dd msgid "" "Changed in v1.19.5: also return natural image orientation extracted from " "EXIF data if present." msgstr "v1.19.5에서 변경됨: EXIF 데이터가 있으면 추출된 자연 이미지 방향도 반환합니다." #: ../../functions.rst:444 9c4baadc4f9146b19f4058938d9378d0 msgid "" "Changed in v1.22.5: always return `None` in error cases instead of an " "empty dictionary." msgstr "v1.22.5에서 변경됨: 오류 경우 빈 딕셔너리 대신 항상 `None` 을 반환합니다." #: ../../functions.rst:446 a4aa625db89144ea89c9a3f2dbf7ffab msgid "" "Show important properties of an image provided as a memory area. Its main" " purpose is to avoid using other Python packages just to determine them." msgstr "" "메모리 영역으로 제공된 이미지의 중요한 속성을 표시합니다. 주요 목적은 이를 결정하기 위해 다른 Python 패키지를 사용하는 것을" " 피하는 것입니다." #: ../../functions.rst:448 bd286756e9cf47ccb4c584863393000b msgid "" "either an image in memory or an **opened** file. An image in memory may " "be any of the formats `bytes`, `bytearray` or `io.BytesIO`." msgstr "" "메모리의 이미지 또는 **열린** 파일. 메모리의 이미지는 `bytes`, `bytearray` 또는 `io.BytesIO` 형식 " "중 하나일 수 있습니다." #: ../../functions.rst:451 ae650862b48c4011b850d0daa225794c #, python-brace-format msgid "" "No exception is ever raised. In case of an error, `None` is returned. " "Otherwise, there are the following items:: In [2]: " "pymupdf.image_profile(open(\"nur-ruhig.jpg\", \"rb\").read()) Out[2]:" " {'width': 439, 'height': 501, 'orientation': 0, # natural " "orientation (from EXIF) 'transform': (1.0, 0.0, 0.0, 1.0, 0.0, 0.0), " "# orientation matrix 'xres': 96, 'yres': 96, 'colorspace': 3," " 'bpc': 8, 'ext': 'jpeg', 'cs-name': 'DeviceRGB'} There is the " "following relation to **Exif** information encoded in `orientation`, and " "correspondingly in the `transform` matrix-like (quoted from MuPDF " "documentation, *ccw* = counter-clockwise): 0. Undefined 1. 0 " "degree ccw rotation. (Exif = 1) 2. 90 degree ccw rotation. (Exif = 8)" " 3. 180 degree ccw rotation. (Exif = 3) 4. 270 degree ccw rotation." " (Exif = 6) 5. flip on X. (Exif = 2) 6. flip on X, then rotate ccw " "by 90 degrees. (Exif = 5) 7. flip on X, then rotate ccw by 180 " "degrees. (Exif = 4) 8. flip on X, then rotate ccw by 270 degrees. " "(Exif = 7) .. note:: * For some \"exotic\" images (FAX encodings, " "RAW formats and the like), this method will not work. You can however " "still work with such images in PyMuPDF, e.g. by using " ":meth:`Document.extract_image` or create pixmaps via `Pixmap(doc, xref)`." " These methods will automatically convert exotic images to the PNG format" " before returning results. * You can also get the properties of images" " embedded in a PDF, via their :data:`xref`. In this case make sure to " "extract the raw stream: " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`. * Images as " "returned by the image blocks of :meth:`Page.get_text` using \"dict\" or " "\"rawdict\" options are also supported." msgstr "" #: ../../functions.rst:452 f365046aab6a422ab4ee8b73d543f9cd msgid "" "No exception is ever raised. In case of an error, `None` is returned. " "Otherwise, there are the following items::" msgstr "예외는 발생하지 않습니다. 오류가 발생하면 `None` 이 반환됩니다. 그렇지 않으면 다음 항목이 있습니다::" #: ../../functions.rst:467 0a3c370635a74f479d534ebf96ff9900 msgid "" "There is the following relation to **Exif** information encoded in " "`orientation`, and correspondingly in the `transform` matrix-like (quoted" " from MuPDF documentation, *ccw* = counter-clockwise):" msgstr "" "`orientation` 에 인코딩된 **Exif** 정보 및 이에 해당하는 `transform` 행렬과의 관계는 다음과 " "같습니다(MuPDF 문서에서 인용, *ccw* = 반시계 방향):" #: ../../functions.rst:469 d75fb78e754140279e17dde7e31c4e01 msgid "Undefined" msgstr "정의되지 않음" #: ../../functions.rst:470 b480ec9529c54f6f9e09c19692e33f54 msgid "0 degree ccw rotation. (Exif = 1)" msgstr "0도 반시계 방향 회전. (Exif = 1)" #: ../../functions.rst:471 25587535c5224fac9824b413e690ff06 msgid "90 degree ccw rotation. (Exif = 8)" msgstr "90도 반시계 방향 회전. (Exif = 8)" #: ../../functions.rst:472 f6cf386d1e9e450b8d71f709dcf0eb6f msgid "180 degree ccw rotation. (Exif = 3)" msgstr "180도 반시계 방향 회전. (Exif = 3)" #: ../../functions.rst:473 139d003f85c4423c9cbb2eccc8f4c541 msgid "270 degree ccw rotation. (Exif = 6)" msgstr "270도 반시계 방향 회전. (Exif = 6)" #: ../../functions.rst:474 dc1ea011d6f74d078d9e198ba656d4d0 msgid "flip on X. (Exif = 2)" msgstr "X축으로 뒤집기. (Exif = 2)" #: ../../functions.rst:475 2d185d52566946e2870d9cb80628b63f msgid "flip on X, then rotate ccw by 90 degrees. (Exif = 5)" msgstr "X축으로 뒤집은 후 90도 반시계 방향 회전. (Exif = 5)" #: ../../functions.rst:476 33f9468536364528a46aab5370439e20 msgid "flip on X, then rotate ccw by 180 degrees. (Exif = 4)" msgstr "X축으로 뒤집은 후 180도 반시계 방향 회전. (Exif = 4)" #: ../../functions.rst:477 424b2838db7f419694385fa5eff04abc msgid "flip on X, then rotate ccw by 270 degrees. (Exif = 7)" msgstr "X축으로 뒤집은 후 270도 반시계 방향 회전. (Exif = 7)" #: ../../functions.rst:482 5e9805b4707e468198b7d77d011a26fd msgid "" "For some \"exotic\" images (FAX encodings, RAW formats and the like), " "this method will not work. You can however still work with such images in" " PyMuPDF, e.g. by using :meth:`Document.extract_image` or create pixmaps " "via `Pixmap(doc, xref)`. These methods will automatically convert exotic " "images to the PNG format before returning results." msgstr "" "일부 \"특수\" 이미지(FAX 인코딩, RAW 형식 등)의 경우 이 메서드는 작동하지 않습니다. 그러나 PyMuPDF에서 " ":meth:`Document.extract_image` 를 사용하거나 `Pixmap(doc, xref)` 를 통해 픽스맵을 생성하는" " 등으로 이러한 이미지를 계속 작업할 수 있습니다. 이러한 메서드는 결과를 반환하기 전에 특수 이미지를 자동으로 PNG 형식으로 " "변환합니다." #: ../../functions.rst:483 39ee6e4ff50f4fc1bc0a90cf4b141a03 msgid "" "You can also get the properties of images embedded in a PDF, via their " ":data:`xref`. In this case make sure to extract the raw stream: " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`." msgstr "" "PDF에 포함된 이미지의 속성은 :data:`xref` 를 통해 가져올 수도 있습니다. 이 경우 원시 스트림을 추출해야 합니다: " "`pymupdf.image_profile(doc.xref_stream_raw(xref))`." #: ../../functions.rst:484 5d7229a1558045eab12f2a4a6c855d76 msgid "" "Images as returned by the image blocks of :meth:`Page.get_text` using " "\"dict\" or \"rawdict\" options are also supported." msgstr "" "\"dict\" 또는 \"rawdict\" 옵션을 사용하는 :meth:`Page.get_text` 의 이미지 블록으로 반환된 " "이미지도 지원됩니다." #: ../../functions.rst:491 4c052d2131a14058938b56d3418e131d msgid "" "Return the header string required to make a valid document out of page " "text outputs." msgstr "페이지 텍스트 출력으로 유효한 문서를 만들기 위해 필요한 헤더 문자열을 반환합니다." #: ../../functions.rst:493 ../../functions.rst:505 #: 12aff9588a3141ceb5a3d8365a3228bf e15e0919c03e4689962a3d7f0cbfd1f1 msgid "type of document. Use the same as the output parameter of *get_text()*." msgstr "문서 타입. *get_text()* 의 출력 매개변수와 동일하게 사용하세요." #: ../../functions.rst:495 451d5274d5404d8795385325e59833bb msgid "optional arbitrary name to use in output types \"json\" and \"xml\"." msgstr "출력 타입 \"json\" 및 \"xml\"에서 사용할 선택적 임의 이름." #: ../../functions.rst:503 89b80fb501af4a16b7a9476a55a22270 msgid "" "Return the trailer string required to make a valid document out of page " "text outputs. See :meth:`Page.get_text` for an example." msgstr "" "페이지 텍스트 출력으로 유효한 문서를 만들기 위해 필요한 트레일러 문자열을 반환합니다. 예제는 " ":meth:`Page.get_text` 를 참조하세요." #: ../../functions.rst:513 74049436f1104036ae9fea6fab3f8454 msgid "" "Delete an object containing XML-based metadata from the PDF. (Py-) MuPDF " "does not support XML-based metadata. Use this if you want to make sure " "that the conventional metadata dictionary will be used exclusively. Many " "thirdparty PDF programs insert their own metadata in XML format and thus " "may override what you store in the conventional dictionary. This method " "deletes any such reference, and the corresponding PDF object will be " "deleted during next garbage collection of the file." msgstr "" "PDF에서 XML 기반 메타데이터를 포함하는 객체를 삭제합니다. (Py-) MuPDF는 XML 기반 메타데이터를 지원하지 않습니다." " 기존 메타데이터 딕셔너리가 독점적으로 사용되도록 하려면 이것을 사용하세요. 많은 타사 PDF 프로그램이 자체 메타데이터를 XML " "형식으로 삽입하므로 기존 딕셔너리에 저장한 내용을 덮어쓸 수 있습니다. 이 메서드는 이러한 참조를 삭제하며, 해당 PDF 객체는 " "다음 파일 가비지 수집 중에 삭제됩니다." #: ../../functions.rst:519 5db2a02465744688ab3e7c8aa58850d4 msgid "" "Return the XML-based metadata :data:`xref` of the PDF if present -- also " "refer to :meth:`Document.del_xml_metadata`. You can use it to retrieve " "the content via :meth:`Document.xref_stream` and then work with it using " "some XML software." msgstr "" "PDF의 XML 기반 메타데이터 :data:`xref` 가 있으면 반환합니다 -- " ":meth:`Document.del_xml_metadata` 도 참조하세요. :meth:`Document.xref_stream` 을" " 통해 콘텐츠를 검색한 다음 일부 XML 소프트웨어를 사용하여 작업할 수 있습니다." #: ../../functions.rst:522 8fbcc03c4196406eacf3af64dba64c1d msgid ":data:`xref` of PDF file level XML metadata -- or 0 if none exists." msgstr "PDF 파일 레벨 XML 메타데이터의 :data:`xref` -- 없으면 0." #: ../../functions.rst:528 6b8b6c79577e42c1a405e89e84d55806 msgid "Run a page through a device." msgstr "디바이스를 통해 페이지 실행." #: ../../functions.rst:530 79f4006550f34f108fbceb98de33b368 msgid "Device, obtained from one of the :ref:`Device` constructors." msgstr "디바이스, :ref:`Device` 생성자 중 하나에서 얻음." #: ../../functions.rst:533 c3fd75078a914ad5a5569e5547dd1af9 msgid "" "Transformation to apply to the page. Set it to :ref:`Identity` if no " "transformation is desired." msgstr "페이지에 적용할 변환. 변환이 필요 없으면 :ref:`Identity` 로 설정하세요." #: ../../functions.rst:540 3a6b7151b4a6425ab6f57671e6361a36 msgid "New in v1.19.0" msgstr "*v1.19.0의 새로운 기능*" #: ../../functions.rst:541 630cdd26bd544107b791cfb24730326a msgid "" "Changed in v1.22.0: optionally also return the OCG name applicable to the" " boundary box." msgstr "v1.22.0에서 변경됨: 선택적으로 경계 상자에 적용 가능한 OCG 이름도 반환합니다." #: ../../functions.rst:543 d9826653f5074292942cba6ac72b5123 msgid "" "a list of rectangles that envelop text, image or drawing objects. Each " "item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple " "consists of rectangle coordinates, and *type* is one of the following " "values. If `layers=True`, there is a third item containing the OCG name " "or `None`: `(type, (x0, y0, x1, y1), None)`. * `\"fill-text\"` -- normal" " text (painted without character borders) * `\"stroke-text\"` -- text " "showing character borders only * `\"ignore-text\"` -- text that should " "not be displayed (e.g. as used by OCR text layers) * `\"fill-path\"` -- " "drawing with fill color (and no border) * `\"stroke-path\"` -- drawing " "with border (and no fill color) * `\"fill-image\"` -- displays an image *" " `\"fill-shade\"` -- display a shading The item sequence represents the " "**sequence in which these commands are executed** to build the page's " "appearance. Therefore, if an item's bbox intersects or contains that of a" " previous item, then the previous item may be (partially) covered / " "hidden. So this list can be used to detect such situations. An item's " "index in this list equals the value of a `\"seqno\"` in dictionaries as " "returned by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`." msgstr "" #: ../../functions.rst:543 cea75236177747a387f9c237fd0cbcdd msgid "" "a list of rectangles that envelop text, image or drawing objects. Each " "item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple " "consists of rectangle coordinates, and *type* is one of the following " "values. If `layers=True`, there is a third item containing the OCG name " "or `None`: `(type, (x0, y0, x1, y1), None)`." msgstr "" "텍스트, 이미지 또는 그리기 객체를 둘러싸는 사각형 목록. 각 항목은 `(type, (x0, y0, x1, y1))` 튜플이며, 두" " 번째 튜플은 사각형 좌표로 구성되고 *type* 은 다음 값 중 하나입니다. `layers=True` 인 경우 OCG 이름 또는 " "`None` 을 포함하는 세 번째 항목이 있습니다: `(type, (x0, y0, x1, y1), None)`." #: ../../functions.rst:545 bd57ae852199441396045da3900fa159 msgid "`\"fill-text\"` -- normal text (painted without character borders)" msgstr "`\"fill-text\"` -- 일반 텍스트(문자 경계 없이 그려짐)" #: ../../functions.rst:546 73652bbb988548bf9aecacbdf1d31641 msgid "`\"stroke-text\"` -- text showing character borders only" msgstr "`\"stroke-text\"` -- 문자 경계만 표시하는 텍스트" #: ../../functions.rst:547 4d516464739349f3a0019a924497c287 msgid "" "`\"ignore-text\"` -- text that should not be displayed (e.g. as used by " "OCR text layers)" msgstr "`\"ignore-text\"` -- 표시되지 않아야 하는 텍스트(예: OCR 텍스트 레이어에서 사용)" #: ../../functions.rst:548 3be92a4cabce42a19d1018efd7b77e1a msgid "`\"fill-path\"` -- drawing with fill color (and no border)" msgstr "`\"fill-path\"` -- 채우기 색상으로 그리기(경계 없음)" #: ../../functions.rst:549 5d82465ff84b4562a2c5ecc802effabd msgid "`\"stroke-path\"` -- drawing with border (and no fill color)" msgstr "`\"stroke-path\"` -- 경계로 그리기(채우기 색상 없음)" #: ../../functions.rst:550 af1203ba9d33446facef8a91f01f7559 msgid "`\"fill-image\"` -- displays an image" msgstr "`\"fill-image\"` -- 이미지 표시" #: ../../functions.rst:551 650de20fff594c48b1df187a0852978d msgid "`\"fill-shade\"` -- display a shading" msgstr "`\"fill-shade\"` -- 음영 표시" #: ../../functions.rst:553 ef60b6dd48c44a5b8181df41a22356a2 msgid "" "The item sequence represents the **sequence in which these commands are " "executed** to build the page's appearance. Therefore, if an item's bbox " "intersects or contains that of a previous item, then the previous item " "may be (partially) covered / hidden." msgstr "" "항목 시퀀스는 페이지의 모양을 구축하기 위해 **이러한 명령이 실행되는 순서** 를 나타냅니다. 따라서 항목의 bbox가 이전 " "항목과 교차하거나 포함하는 경우 이전 항목이 (부분적으로) 덮이거나 숨겨질 수 있습니다." #: ../../functions.rst:556 fa7f832dc453447d83d333bd0edaa9aa msgid "" "So this list can be used to detect such situations. An item's index in " "this list equals the value of a `\"seqno\"` in dictionaries as returned " "by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`." msgstr "" "따라서 이 목록을 사용하여 이러한 상황을 감지할 수 있습니다. 이 목록의 항목 인덱스는 " ":meth:`Page.get_drawings` 및 :meth:`Page.get_texttrace` 에서 반환된 딕셔너리의 " "`\"seqno\"` 값과 같습니다." #: ../../functions.rst:563 e6e86279727b44108e80bd887f5dec4b msgid "New in v1.18.16" msgstr "*v1.18.16의 새로운 기능*" #: ../../functions.rst:564 4a8a69681c1f4dd58e655d55319a42bd msgid "Changed in v1.19.0: added key \"seqno\"." msgstr "v1.19.0에서 변경됨: 키 \"seqno\" 추가." #: ../../functions.rst:565 8ec88b876f364e48be39bb7321df5b78 msgid "" "Changed in v1.19.1: stroke and fill colors now always are either RGB or " "GRAY" msgstr "v1.19.1에서 변경됨: 스트로크 및 채우기 색상이 이제 항상 RGB 또는 GRAY입니다" #: ../../functions.rst:566 6262d51351704e3cb0b74e4a397e4d17 msgid "" "Changed in v1.19.3: span and character bboxes are now also correct if " "`dir != (1, 0)`." msgstr "v1.19.3에서 변경됨: `dir != (1, 0)` 인 경우에도 스팬 및 문자 bbox가 이제 올바릅니다." #: ../../functions.rst:567 7b239315a5da4ad49a8e0934405a7fd3 msgid "Changed in v1.22.0: add new dictionary key \"layer\"." msgstr "v1.22.0에서 변경됨: 새로운 딕셔너리 키 \"layer\" 추가." #: ../../functions.rst:570 834e9d9810714938bfbf774e17193982 msgid "" "Return low-level text information of the page. The method is available " "for **all** document types. The result is a list of Python dictionaries " "with the following content::" msgstr "" "페이지의 저수준 텍스트 정보를 반환합니다. 이 메서드는 **모든** 문서 타입에서 사용할 수 있습니다. 결과는 다음 내용을 가진 " "Python 딕셔너리 목록입니다::" #: ../../functions.rst:606 8b58904760d74cf1b106164af7de1954 msgid "Details:" msgstr "세부사항:" #: ../../functions.rst:608 63e3f59519b34151ba92179d999fb9ee msgid "" "Information above tagged with \"(1)\" has the same meaning and value as " "explained in :ref:`TextPage`." msgstr "\"(1)\"로 태그된 위의 정보는 :ref:`TextPage` 에서 설명한 것과 동일한 의미와 값을 가집니다." #: ../../functions.rst:610 adef9c5a97be49e783885187ce3815e0 msgid "" "Please note that the font ``flags`` value will never contain a " "*superscript* flag bit: the detection of superscripts is done within " "MuPDF :ref:`TextPage` code -- it is not a property of any font." msgstr "" "글꼴 ``flags`` 값에는 *위첨자* 플래그 비트가 포함되지 않습니다: 위첨자 감지는 MuPDF :ref:`TextPage` " "코드 내에서 수행됩니다 -- 이것은 어떤 글꼴의 속성도 아닙니다." #: ../../functions.rst:611 42e4ea3c18d54211b94b728f0c637564 msgid "" "Also note, that the text *color* is encoded as the usual tuple of floats " "0 <= f <= 1 -- not in sRGB format. Depending on `span[\"type\"]`, " "interpret this as fill color or stroke color." msgstr "" "텍스트 *color* 는 일반적인 float 튜플 0 <= f <= 1로 인코딩됩니다 -- sRGB 형식이 아닙니다. " "`span[\"type\"]` 에 따라 이를 채우기 색상 또는 스트로크 색상으로 해석하세요." #: ../../functions.rst:613 c064211d745e47be945feb7030afbad2 msgid "There are 3 text span types:" msgstr "3가지 텍스트 스팬 타입이 있습니다:" #: ../../functions.rst:615 fbf31286bd4548fd975462e964233915 msgid "" "0: Filled text -- equivalent to PDF text rendering mode 0 (`0 Tr`, the " "default in PDF), only each character's \"inside\" is shown." msgstr "" "0: 채워진 텍스트 -- PDF 텍스트 렌더링 모드 0(`0 Tr`, PDF의 기본값)과 동일하며, 각 문자의 \"내부\"만 " "표시됩니다." #: ../../functions.rst:616 941b2c374d584068847e1546fdbdf66c msgid "" "1: Stroked text -- equivalent to `1 Tr`, only the character borders are " "shown." msgstr "1: 스트로크 텍스트 -- `1 Tr` 와 동일하며, 문자 경계만 표시됩니다." #: ../../functions.rst:617 d2fc5c83a61a4d4f8edd462b343a794f msgid "3: Ignored text -- equivalent to `3 Tr` (hidden text)." msgstr "3: 무시된 텍스트 -- `3 Tr` (숨겨진 텍스트)와 동일합니다." #: ../../functions.rst:619 82c0b57a08e74995b7bfc0b18220c635 #, python-format msgid "" "Line width in this context is important only for processing " "`span[\"type\"] != 0`: it determines the thickness of the character's " "border line. This value may not be provided at all with the text data. In" " this case, a value of 5% of the :data:`fontsize` (`span[\"size\"] * " "0,05`) is generated. Often, an \"artificial\" bold text in PDF is created" " by `2 Tr`. There is no equivalent span type for this case. Instead, " "respective text is represented by two consecutive spans -- which are " "identical in every aspect, except for their types, which are 0, resp 1. " "It is your responsibility to handle this type of situation - in " ":meth:`Page.get_text`, MuPDF is doing this for you." msgstr "" "이 맥락에서 선 너비는 `span[\"type\"] != 0` 처리에만 중요합니다: 문자 경계선의 두께를 결정합니다. 이 값은 " "텍스트 데이터와 함께 전혀 제공되지 않을 수 있습니다. 이 경우 :data:`fontsize` 의 5% " "값(`span[\"size\"] * 0,05`)이 생성됩니다. 종종 PDF의 \"인위적인\" 굵은 텍스트는 `2 Tr` 로 " "생성됩니다. 이 경우에 해당하는 스팬 타입은 없습니다. 대신 해당 텍스트는 두 개의 연속된 스팬으로 표현됩니다 -- 타입이 각각 " "0과 1인 것을 제외하고 모든 면에서 동일합니다. 이러한 상황을 처리하는 것은 사용자의 책임입니다 - " ":meth:`Page.get_text` 에서는 MuPDF가 이를 수행합니다." #: ../../functions.rst:620 b0c07cf4d26348589ec94ed16a6c3372 msgid "" "For data compactness, the character's unicode is provided here. Use " "built-in function `chr()` for the character itself." msgstr "데이터 압축을 위해 여기에 문자의 유니코드가 제공됩니다. 문자 자체는 내장 함수 `chr()` 을 사용하세요." #: ../../functions.rst:621 3c60ceeb1f4f4171b04db58fdec4733e msgid "" "The alpha / opacity value of the span's text, `0 <= opacity <= 1`, 0 is " "invisible text, 1 (100%) is intransparent. Depending on `span[\"type\"]`," " interpret this value as *fill* opacity or, resp. *stroke* opacity." msgstr "" "스팬 텍스트의 알파/불투명도 값, `0 <= opacity <= 1`, 0은 보이지 않는 텍스트, 1(100%)은 불투명합니다. " "`span[\"type\"]` 에 따라 이 값을 *fill* 불투명도 또는 *stroke* 불투명도로 해석하세요." #: ../../functions.rst:622 b237cc55d5244595a4d9e0f2faf43ec2 msgid "" "*(Changed in v1.19.0)* This value is equal or close to `char[\"bbox\"]` " "of \"rawdict\". In particular, the bbox **height** value is always " "computed as if **\"small glyph heights\"** had been requested." msgstr "" "*(v1.19.0에서 변경됨)* 이 값은 \"rawdict\"의 `char[\"bbox\"]` 와 같거나 가깝습니다. 특히 bbox" " **height** 값은 항상 **\"small glyph heights\"** 가 요청된 것처럼 계산됩니다." #: ../../functions.rst:623 d0aece89209341f4995bd44237ffb0bd msgid "*(New in v1.19.0)* This is the union of all character bboxes." msgstr "*(v1.19.0의 새로운 기능)* 이것은 모든 문자 bbox의 합집합입니다." #: ../../functions.rst:624 4a2dea33adee4c3f934f477d8961d184 msgid "" "*(New in v1.19.0)* Enumerates the commands that build up the page's " "appearance. Can be used to find out whether text is effectively hidden by" " objects, which are painted \"later\", or *over* some object. So if there" " is a drawing or image with a higher sequence number, whose bbox overlaps" " (parts of) this text span, one may assume that such an object hides the " "resp. text. Different text spans have identical sequence numbers if they " "were created in one go." msgstr "" "*(v1.19.0의 새로운 기능)* 페이지의 모양을 구축하는 명령을 열거합니다. 텍스트가 \"나중에\" 그려지거나 어떤 객체 " "*위에* 그려진 객체에 의해 효과적으로 숨겨지는지 확인하는 데 사용할 수 있습니다. 따라서 더 높은 시퀀스 번호를 가진 그리기 또는" " 이미지가 있고, 그 bbox가 이 텍스트 스팬의 (일부)와 겹치는 경우, 그러한 객체가 해당 텍스트를 숨긴다고 가정할 수 " "있습니다. 다른 텍스트 스팬은 한 번에 생성된 경우 동일한 시퀀스 번호를 가집니다." #: ../../functions.rst:625 746e13f904994ba1b391640966cb9cce msgid "" "*(New in v1.22.0)* The name of the Optional Content Group (OCG) if " "applicable or `None`." msgstr "*(v1.22.0의 새로운 기능)* 해당하는 경우 Optional Content Group (OCG)의 이름 또는 `None`." #: ../../functions.rst:627 39e39ef69db145bb8fd6d7a429821aa0 msgid "" "Here is a list of similarities and differences of `page.get_texttrace()` " "compared to `page.get_text(\"rawdict\")`:" msgstr "" "`page.get_text(\"rawdict\")` 와 비교한 `page.get_texttrace()` 의 유사점과 차이점 " "목록입니다:" #: ../../functions.rst:629 917f1c8f176a4ed594b134848132c93c msgid "" "The method is up to **twice as fast,** compared to \"rawdict\" " "extraction. Depends on the amount of text." msgstr "이 메서드는 \"rawdict\" 추출과 비교하여 **최대 2배 빠릅니다**. 텍스트 양에 따라 다릅니다." #: ../../functions.rst:630 1bed3805162b46efbe3f575d925a99b2 msgid "" "The returned data is very **much smaller in size** -- although it " "provides more information." msgstr "반환된 데이터는 **크기가 훨씬 작습니다** -- 더 많은 정보를 제공하지만." #: ../../functions.rst:631 a1624b170eb441899e89639c83c5bec8 msgid "" "Additional types of text **invisibility can be detected**: opacity = 0 or" " type > 1 or overlapping bbox of an object with a higher sequence number." msgstr "" "추가 유형의 텍스트 **보이지 않음을 감지할 수 있습니다**: opacity = 0 또는 type > 1 또는 더 높은 시퀀스 " "번호를 가진 객체의 겹치는 bbox." #: ../../functions.rst:632 8a4627bf3e3b4ccdab047276202cf1cc msgid "" "If MuPDF returns unicode 0xFFFD (65533) for unrecognized characters, you " "may still be able to deduct desired information from the glyph id." msgstr "" "MuPDF가 인식되지 않은 문자에 대해 유니코드 0xFFFD(65533)를 반환하는 경우, 글리프 id에서 원하는 정보를 추론할 수" " 있을 수 있습니다." #: ../../functions.rst:633 9e5fc14c54d74d61a2dc0d327be33a78 msgid "" "The `span[\"chars\"]` **contains no spaces**, **except** the document " "creator has explicitly coded them. They **will never be generated** like " "it happens in :meth:`Page.get_text` methods. To provide some help for " "doing your own computations here, the width of a space character is " "given. This value is derived from the font where possible. Otherwise the " "value of a fallback font is taken." msgstr "" "`span[\"chars\"]` 는 **공백을 포함하지 않습니다**, **문서 작성자가 명시적으로 코딩한 경우를 제외하고**. " ":meth:`Page.get_text` 메서드에서 발생하는 것처럼 **절대 생성되지 않습니다**. 여기서 자체 계산을 수행하는 데 " "도움이 되도록 공백 문자의 너비가 제공됩니다. 이 값은 가능한 경우 글꼴에서 파생됩니다. 그렇지 않으면 대체 글꼴의 값이 " "사용됩니다." #: ../../functions.rst:634 15ac82aad6cb4e3a9170eca749052958 msgid "" "There is no effort to organize text like it happens for a :ref:`TextPage`" " (the hierarchy of blocks, lines, spans, and characters). Characters are " "simply extracted in sequence, one by one, and put in a span. Whenever any" " of the span's characteristics changes, a new span is started. So you may" " find characters with different `origin.y` values in the same span (which" " means they would appear in different lines). You cannot assume, that " "span characters are sorted in any particular order -- you must make sense" " of the info yourself, taking `span[\"dir\"]`, `span[\"wmode\"]`, etc. " "into account." msgstr "" ":ref:`TextPage` 에서 발생하는 것처럼 텍스트를 구성하려는 시도가 없습니다(블록, 라인, 스팬 및 문자의 계층 구조). " "문자는 단순히 순차적으로 하나씩 추출되어 스팬에 배치됩니다. 스팬의 특성이 변경될 때마다 새로운 스팬이 시작됩니다. 따라서 동일한 " "스팬에서 다른 `origin.y` 값을 가진 문자를 찾을 수 있습니다(이는 다른 라인에 나타날 것임을 의미). 스팬 문자가 특정 " "순서로 정렬되어 있다고 가정할 수 없습니다 -- `span[\"dir\"]`, `span[\"wmode\"]` 등을 고려하여 정보를" " 직접 이해해야 합니다." #: ../../functions.rst:652 a0c67b42ef3e49e0b1f2ac26995741aa msgid "Ligatures are represented like this:" msgstr "합자는 다음과 같이 표현됩니다:" #: ../../functions.rst:636 3c824ed918b34e58861b077c4365477f msgid "" "MuPDF handles the following ligatures: \"fi\", \"ff\", \"fl\", \"ft\", " "\"st\", \"ffi\", and \"ffl\" (only the first 3 are mostly ever used). If " "the page contains e.g. ligature \"fi\", you will find the following two " "character items subsequent to each other::" msgstr "" "MuPDF는 다음 합자를 처리합니다: \"fi\", \"ff\", \"fl\", \"ft\", \"st\", \"ffi\", " "\"ffl\" (처음 3개만 주로 사용됨). 페이지에 예를 들어 합자 \"fi\"가 포함되어 있으면 다음 두 문자 항목이 서로 " "연속으로 나타납니다::" #: ../../functions.rst:641 bcc79b6581f34f9280c07f51f267b1ba msgid "" "This means that the bbox of the first ligature character is the area " "containing the complete, compound glyph. Subsequent ligature components " "are recognizable by their glyph value -1 and a bbox of width zero." msgstr "" "이것은 첫 번째 합자 문자의 bbox가 완전한 복합 글리프를 포함하는 영역임을 의미합니다. 후속 합자 구성 요소는 글리프 값 -1과" " 너비가 0인 bbox로 인식할 수 있습니다." #: ../../functions.rst:642 7817cb437109492a80ade1f89c34b3cf msgid "" "You may want to replace those 2 or 3 char tuples by one, that represents " "the ligature itself. Use the following mapping of ligatures to unicodes:" msgstr "2개 또는 3개의 문자 튜플을 합자 자체를 나타내는 하나로 대체할 수 있습니다. 다음 합자-유니코드 매핑을 사용하세요:" #: ../../functions.rst:644 aaebcaafe03144fbb8992f69ed5c8f00 msgid "`\"ff\" -> 0xFB00`" msgstr "`\"ff\" -> 0xFB00`" #: ../../functions.rst:645 939984a5e5e04878ae04eea7858b9f77 msgid "`\"fi\" -> 0xFB01`" msgstr "`\"fi\" -> 0xFB01`" #: ../../functions.rst:646 d3fed8f13cba4ce885dd69100891d76e msgid "`\"fl\" -> 0xFB02`" msgstr "`\"fl\" -> 0xFB02`" #: ../../functions.rst:647 b9933ebf7ec545d8a6c748b98f667811 msgid "`\"ffi\" -> 0xFB03`" msgstr "`\"ffi\" -> 0xFB03`" #: ../../functions.rst:648 e0514a34957c47a78d18f3dda4d2429d msgid "`\"ffl\" -> 0xFB04`" msgstr "`\"ffl\" -> 0xFB04`" #: ../../functions.rst:649 37fa3ab049b5470c812eb68f92a34b47 msgid "`\"ft\" -> 0xFB05`" msgstr "`\"ft\" -> 0xFB05`" #: ../../functions.rst:650 837026b002484cd789d83dcb6b644892 msgid "`\"st\" -> 0xFB06`" msgstr "`\"st\" -> 0xFB06`" #: ../../functions.rst:652 50f11c41758d4ce0bf5813b7baecd6c0 msgid "" "So you may want to replace the two example tuples above by the following " "single one: `(0xFB01, glyph, (x, y), (x0, y0, x1, y1))` (there is usually" " no need to lookup the correct glyph id for 0xFB01 in the resp. font, but" " you may execute `font.has_glyph(0xFB01)` and use its return value)." msgstr "" "따라서 위의 두 예제 튜플을 다음 단일 튜플로 대체할 수 있습니다: `(0xFB01, glyph, (x, y), (x0, y0, " "x1, y1))` (일반적으로 해당 글꼴에서 0xFB01에 대한 올바른 글리프 id를 조회할 필요는 없지만, " "`font.has_glyph(0xFB01)` 을 실행하고 반환 값을 사용할 수 있습니다)." #: ../../functions.rst:654 222e9b82b659431db35af8eeffb194f6 msgid "" "**Changed in v1.19.3:** Similar to other text extraction methods, the " "character and span bboxes envelop the character quads. To recover the " "quads, follow the same methods :meth:`recover_quad`, " ":meth:`recover_char_quad` or :meth:`recover_span_quad` as explained in " ":ref:`textpagedict`. Use either `None` or `span[\"dir\"]` for the writing" " direction." msgstr "" "**v1.19.3에서 변경됨:** 다른 텍스트 추출 메서드와 유사하게, 문자 및 스팬 bbox는 문자 쿼드를 둘러쌉니다. 쿼드를 " "복구하려면 :ref:`textpagedict` 에서 설명한 것과 동일한 메서드 :meth:`recover_quad`, " ":meth:`recover_char_quad` 또는 :meth:`recover_span_quad` 를 따르세요. 쓰기 방향에는 " "`None` 또는 `span[\"dir\"]` 을 사용하세요." #: ../../functions.rst:656 f5faf881db3d4a9487a05fef55996648 msgid "" "**Changed in v1.21.1:** If applicable, the name of the OCG is shown in " "`\"layer\"`." msgstr "**v1.21.1에서 변경됨:** 해당하는 경우 OCG의 이름이 `\"layer\"` 에 표시됩니다." #: ../../functions.rst:662 48bf0e585e944bd7b52be8feaac35c5e msgid "" "Ensures that the page's so-called graphics state is balanced and new " "content can be inserted correctly." msgstr "페이지의 소위 그래픽 상태가 균형을 이루고 새 콘텐츠가 올바르게 삽입될 수 있도록 합니다." #: ../../functions.rst:664 eae68e69d2064990b1bf9c7ed594f48c msgid "" "In versions 1.24.1+ of PyMuPDF the method was improved and is being " "executed automatically as required, so you should no longer need to " "concern yourself with it." msgstr "PyMuPDF 버전 1.24.1+에서 이 메서드가 개선되어 필요에 따라 자동으로 실행되므로 더 이상 신경 쓸 필요가 없습니다." #: ../../functions.rst:666 de7bdd81791342039a777f36b3120609 msgid "We discourage using :meth:`Page.clean_contents` to achieve this." msgstr "이를 달성하기 위해 :meth:`Page.clean_contents` 사용을 권장하지 않습니다." #: ../../functions.rst:672 59ea1ae4764a4a79b7293e1e4acf5bfc msgid "" "Indicate whether the page's so-called graphic state is balanced. If " "`False`, :meth:`Page.wrap_contents` should be executed if new content is " "inserted (only relevant in `overlay=True` mode). In newer versions " "(1.24.1+), this check and corresponding adjustments are automatically " "executed -- you therefore should not be concerned about this anymore." msgstr "" "페이지의 소위 그래픽 상태가 균형을 이루는지 나타냅니다. `False` 인 경우 새 콘텐츠가 삽입되면 " ":meth:`Page.wrap_contents` 를 실행해야 합니다(`overlay=True` 모드에서만 관련됨). 최신 " "버전(1.24.1+)에서는 이 확인 및 해당 조정이 자동으로 실행됩니다 -- 따라서 더 이상 신경 쓸 필요가 없습니다." #: ../../functions.rst:680 77bfdbb9ea154021880b68f407cec45e msgid "" "Deprecated wrapper for :meth:`TextPage.extractBLOCKS`. Use " ":meth:`Page.get_text` with the \"blocks\" option instead." msgstr "" ":meth:`TextPage.extractBLOCKS` 의 더 이상 사용되지 않는 래퍼. 대신 \"blocks\" 옵션을 사용하는 " ":meth:`Page.get_text` 를 사용하세요." #: ../../functions.rst:688 38ae57f9f7514e3ebe8a9c79b5610c01 msgid "" "Deprecated wrapper for :meth:`TextPage.extractWORDS`. Use " ":meth:`Page.get_text` with the \"words\" option instead." msgstr "" ":meth:`TextPage.extractWORDS` 의 더 이상 사용되지 않는 래퍼. 대신 \"words\" 옵션을 사용하는 " ":meth:`Page.get_text` 를 사용하세요." #: ../../functions.rst:696 3cb9ebe8577f4992ad02eb07f1b73bfe msgid "Run a page through a list device and return its display list." msgstr "리스트 디바이스를 통해 페이지를 실행하고 디스플레이 리스트를 반환합니다." #: ../../functions.rst:698 25c2a3b94c1848eeb595b0de57aa1246 msgid ":ref:`DisplayList`" msgstr ":ref:`DisplayList`" #: ../../functions.rst:699 7c69c8db929044cea53feea2943ed7b7 msgid "the display list of the page." msgstr "페이지의 디스플레이 리스트." #: ../../functions.rst:705 fb125de099214795adc6e298598a8f7c msgid "" "PDF only: Retrieve a list of :data:`xref` of :data:`contents` objects of " "a page. May be empty or contain multiple integers. If the page is cleaned" " (:meth:`Page.clean_contents`), it will be no more than one entry. The " "\"source\" of each `/Contents` object can be individually read by " ":meth:`Document.xref_stream` using an item of this list. Method " ":meth:`Page.read_contents` in contrast walks through this list and " "concatenates the corresponding sources into one `bytes` object." msgstr "" "PDF 전용: 페이지의 :data:`contents` 객체의 :data:`xref` 목록을 검색합니다. 비어 있거나 여러 정수를 " "포함할 수 있습니다. 페이지가 정리된 경우(:meth:`Page.clean_contents`) 항목은 하나 이하입니다. 각 " "`/Contents` 객체의 \"source\"는 이 목록의 항목을 사용하여 :meth:`Document.xref_stream` " "으로 개별적으로 읽을 수 있습니다. 반면 :meth:`Page.read_contents` 메서드는 이 목록을 순회하고 해당 소스를 " "하나의 `bytes` 객체로 연결합니다." #: ../../functions.rst:713 7fe9d0c499fd470cb67a324f854cddfc msgid "" "PDF only: Let the page's `/Contents` key point to this xref. Any " "previously used contents objects will be ignored and can be removed via " "garbage collection." msgstr "" "PDF 전용: 페이지의 `/Contents` 키가 이 xref를 가리키도록 합니다. 이전에 사용된 모든 콘텐츠 객체는 무시되며 " "가비지 수집을 통해 제거할 수 있습니다." #: ../../functions.rst:719 3aa3a5c37b1c4a4381ccad00ba9b8aa9 msgid "Changed in v1.17.6" msgstr "v1.17.6에서 변경됨" #: ../../functions.rst:721 60a2a8926c0a40e4b525cb12714eb91a msgid "" "PDF only: Clean and concatenate all :data:`contents` objects associated " "with this page. \"Cleaning\" includes syntactical corrections, " "standardizations and \"pretty printing\" of the contents stream. " "Discrepancies between :data:`contents` and :data:`resources` objects will" " also be corrected if sanitize is true. See :meth:`Page.get_contents` for" " more details." msgstr "" "PDF 전용: 이 페이지와 연결된 모든 :data:`contents` 객체를 정리하고 연결합니다. \"정리\"에는 구문 수정, " "표준화 및 콘텐츠 스트림의 \"예쁘게 인쇄\"가 포함됩니다. sanitize가 true이면 :data:`contents` 와 " ":data:`resources` 객체 간의 불일치도 수정됩니다. 자세한 내용은 :meth:`Page.get_contents` 를 " "참조하세요." #: ../../functions.rst:723 cc05b36c964b4065952275eeb2a4f884 msgid "" "Changed in version 1.16.0 Annotations are no longer implicitly cleaned by" " this method. Use :meth:`Annot.clean_contents` separately." msgstr "" "버전 1.16.0에서 변경됨: 주석은 이 메서드에 의해 더 이상 암시적으로 정리되지 않습니다. " ":meth:`Annot.clean_contents` 를 별도로 사용하세요." #: ../../functions.rst:725 cef2a0b0383148ddb6c4fb2a831d9901 msgid "" "*(new in v1.17.6)* if true, synchronization between resources and their " "actual use in the contents object is snychronized. For example, if a font" " is not actually used for any text of the page, then it will be deleted " "from the `/Resources/Font` object." msgstr "" "*(v1.17.6의 새로운 기능)* true이면 리소스와 콘텐츠 객체에서의 실제 사용 간의 동기화가 이루어집니다. 예를 들어, " "글꼴이 페이지의 어떤 텍스트에도 실제로 사용되지 않으면 `/Resources/Font` 객체에서 삭제됩니다." #: ../../functions.rst:727 e719525edd8b42b5adb8783ffc991f7f msgid "" "This is a complex function which may generate large amounts of new data " "and render old data unused. It is **not recommended** using it together " "with the **incremental save** option. Also note that the resulting " "singleton new */Contents* object is **uncompressed**. So you should save " "to a **new file** using options *\"deflate=True, garbage=3\"*." msgstr "" "이것은 대량의 새 데이터를 생성하고 이전 데이터를 사용하지 않게 만들 수 있는 복잡한 함수입니다. **증분 저장** 옵션과 함께 " "사용하는 것은 **권장되지 않습니다**. 또한 결과 단일 */Contents* 객체는 **압축되지 않습니다**. 따라서 " "*\"deflate=True, garbage=3\"* 옵션을 사용하여 **새 파일** 에 저장해야 합니다." #: ../../functions.rst:729 1b0ce37aead64fe190eb5958ec06bf93 msgid "" "Do not any longer use this method to ensure correct insertions on PDF " "pages. Since PyMuPDF version 1.24.2 this is taken care of automatically." msgstr "" "PDF 페이지에 올바른 삽입을 보장하기 위해 이 메서드를 더 이상 사용하지 마세요. PyMuPDF 버전 1.24.2부터는 이것이 " "자동으로 처리됩니다." #: ../../functions.rst:735 159e3c751b6f49b8a75890a4fd563d0a msgid "" "*New in version 1.17.0.* Return the concatenation of all :data:`contents`" " objects associated with the page -- without cleaning or otherwise " "modifying them. Use this method whenever you need to parse this source in" " its entirety without having to bother how many separate contents objects" " exist." msgstr "" "*버전 1.17.0의 새로운 기능.* 페이지와 연결된 모든 :data:`contents` 객체의 연결을 반환합니다 -- 정리하거나 " "수정하지 않고. 별도의 콘텐츠 객체가 몇 개나 있는지 신경 쓸 필요 없이 전체 소스를 구문 분석해야 할 때마다 이 메서드를 " "사용하세요." #: ../../functions.rst:744 f820b3ca222e41ea9342c19ea2280afc msgid "" "Clean the :data:`contents` streams associated with the annotation. This " "is the same type of action which :meth:`Page.clean_contents` performs -- " "just restricted to this annotation." msgstr "" "주석과 연결된 :data:`contents` 스트림을 정리합니다. 이것은 :meth:`Page.clean_contents` 가 " "수행하는 것과 동일한 작업입니다 -- 단지 이 주석으로 제한됩니다." #: ../../functions.rst:751 057944b45dbf427097061759690378f5 msgid "" "Return a list of character glyphs and their widths for a font that is " "present in the document. A font must be specified by its PDF cross " "reference number :data:`xref`. This function is called automatically from" " :meth:`Page.insert_text` and :meth:`Page.insert_textbox`. So you should " "rarely need to do this yourself." msgstr "" "문서에 있는 글꼴에 대한 문자 글리프 및 너비 목록을 반환합니다. 글꼴은 PDF 교차 참조 번호 :data:`xref` 로 지정해야" " 합니다. 이 함수는 :meth:`Page.insert_text` 및 :meth:`Page.insert_textbox` 에서 " "자동으로 호출됩니다. 따라서 직접 수행할 필요는 거의 없습니다." #: ../../functions.rst:753 f608a923d1b240efb8dc4a1e2ad76be7 msgid "" "cross reference number of a font embedded in the PDF. To find a font " ":data:`xref`, use e.g. *doc.get_page_fonts(pno)* of page number *pno* and" " take the first entry of one of the returned list entries." msgstr "" "PDF에 포함된 글꼴의 교차 참조 번호. 글꼴 :data:`xref` 를 찾으려면 예를 들어 페이지 번호 *pno* 의 " "*doc.get_page_fonts(pno)* 를 사용하고 반환된 목록 항목 중 하나의 첫 번째 항목을 가져옵니다." #: ../../functions.rst:755 18a15dfc86674db5b7ddd87e97061c89 msgid "" "limits the number of returned entries. The default of 256 is enforced for" " all fonts that only support 1-byte characters, so-called \"simple " "fonts\" (checked by this method). All :ref:`Base-14-Fonts` are simple " "fonts." msgstr "" "반환된 항목 수를 제한합니다. 256의 기본값은 1바이트 문자만 지원하는 소위 \"simple fonts\"(이 메서드로 확인됨)에" " 대해 적용됩니다. 모든 :ref:`Base-14-Fonts` 는 simple fonts입니다." #: ../../functions.rst:758 374d9ca3517b46e79684baafbe452c8a msgid "" "a list of *limit* tuples. Each character *c* has an entry *(g, w)* in " "this list with an index of *ord(c)*. Entry *g* (integer) of the tuple is " "the glyph id of the character, and float *w* is its normalized width. The" " actual width for some :data:`fontsize` can be calculated as *w * " "fontsize*. For simple fonts, the *g* entry can always be safely ignored. " "In all other cases *g* is the basis for graphically representing *c*." msgstr "" "*limit* 튜플 목록. 각 문자 *c* 는 *ord(c)* 인덱스를 가진 이 목록에 *(g, w)* 항목을 가집니다. 튜플의 " "항목 *g* (정수)는 문자의 글리프 id이고, float *w* 는 정규화된 너비입니다. 일부 :data:`fontsize` 에 " "대한 실제 너비는 *w * fontsize* 로 계산할 수 있습니다. simple fonts의 경우 *g* 항목은 항상 안전하게 " "무시할 수 있습니다. 다른 모든 경우 *g* 는 *c* 를 그래픽으로 표현하는 기반입니다." #: ../../functions.rst:760 9a82c0fef9f946ee931dcac730381625 msgid "This function calculates the pixel width of a string called *text*::" msgstr "이 함수는 *text* 라는 문자열의 픽셀 너비를 계산합니다::" #: ../../functions.rst:772 1d63e80ff1044164bb37ffb75d916ca9 msgid "New in version 1.14.14" msgstr "*버전 1.14.14의 새로운 기능*" #: ../../functions.rst:774 0499a7e490f54f6f9c36861c661dd5dd msgid "" "PDF only: Check whether the object represented by :data:`xref` is a " ":data:`stream` type. Return is ``False`` if not a PDF or if the number is" " outside the valid xref range." msgstr "" "PDF 전용: :data:`xref` 로 표현된 객체가 :data:`stream` 타입인지 확인합니다. PDF가 아니거나 숫자가 " "유효한 xref 범위를 벗어나면 ``False`` 를 반환합니다." #: ../../functions.rst:776 6ece02cfe6fd4a0ebd3c0babd63401bc msgid ":data:`xref` number." msgstr ":data:`xref` 번호." #: ../../functions.rst:778 1ae7201b78294f7cb4822bbe2b16c89e msgid "" "``True`` if the object definition is followed by data wrapped in keyword " "pair *stream*, *endstream*." msgstr "객체 정의 뒤에 키워드 쌍 *stream*, *endstream* 으로 둘러싸인 데이터가 오면 ``True``." #: ../../functions.rst:784 824395dad4454308bb3acc094f1e1f49 msgid "" "Increase the :data:`xref` by one entry and return that number. This can " "then be used to insert a new object." msgstr ":data:`xref` 를 하나의 항목만큼 증가시키고 해당 번호를 반환합니다. 이것은 새 객체를 삽입하는 데 사용할 수 있습니다." #: ../../functions.rst:786 b74f53e6f461419798c38d5d157d1ddb msgid "" "int :returns: the number of the new :data:`xref` entry. Please note, that" " only a new entry in the PDF's cross reference table is created. At this " "point, there will not yet exist a PDF object associated with it. To " "create an (empty) object with this number use `doc.update_xref(xref, " "\"<<>>\")`." msgstr "" "int :returns: 새 :data:`xref` 항목의 번호. PDF의 교차 참조 테이블에만 새 항목이 생성됩니다. 이 시점에는" " 아직 연결된 PDF 객체가 존재하지 않습니다. 이 번호로 (빈) 객체를 생성하려면 `doc.update_xref(xref, " "\"<<>>\")` 를 사용하세요." #: ../../functions.rst:793 31b915dba1a44258a1cf9373421e9f58 msgid "Return length of :data:`xref` table." msgstr ":data:`xref` 테이블의 길이를 반환합니다." #: ../../functions.rst:796 aeeeacbd76704c80be24a494e9f339de msgid "the number of entries in the :data:`xref` table." msgstr ":data:`xref` 테이블의 항목 수." #: ../../functions.rst:802 994bdeb47ece44ed86fdb81eee8a599d msgid "" "Compute the quadrilateral of a text span extracted via options \"dict\" " "or \"rawdict\" of :meth:`Page.get_text`." msgstr "" ":meth:`Page.get_text` 의 \"dict\" 또는 \"rawdict\" 옵션을 통해 추출된 텍스트 스팬의 사각형을 " "계산합니다." #: ../../functions.rst:804 ff5b2345f37b49ada7b219718699d919 msgid "" "`line[\"dir\"]` of the owning line. Use `None` for a span from " ":meth:`Page.get_texttrace`." msgstr "" "소유 라인의 `line[\"dir\"]`. :meth:`Page.get_texttrace` 에서 가져온 스팬의 경우 `None` 을" " 사용하세요." #: ../../functions.rst:805 ../../functions.rst:815 ../../functions.rst:826 #: 3de95b885fdb4ae3af31bdbf11c40283 4502b3c80d88444093eabb36474662d2 #: 843e47e4ce234f268a145146bbef3077 msgid "the span." msgstr "스팬." #: ../../functions.rst:806 58171abb89e5477197c19eda22c274ae msgid "" "the :ref:`Quad` of the span, usable for text marker annotations " "('Highlight', etc.)." msgstr "스팬의 :ref:`Quad`, 텍스트 마커 주석('Highlight' 등)에 사용 가능." #: ../../functions.rst:812 7ab76daee93b418ead8cbe0eb161c1c0 msgid "" "Compute the quadrilateral of a text character extracted via option " "\"rawdict\" of :meth:`Page.get_text`." msgstr ":meth:`Page.get_text` 의 \"rawdict\" 옵션을 통해 추출된 텍스트 문자의 사각형을 계산합니다." #: ../../functions.rst:814 ../../functions.rst:825 #: cbcfe2d2f449448fab8201428f6897c5 d64beaf47b2f47e78d08e91ac32d1e07 msgid "" "`line[\"dir\"]` of the owning line. Use `None` for a span from " ":meth:`Page.get_texttrace`." msgstr "" "소유 라인의 `line[\"dir\"]`. :meth:`Page.get_texttrace` 에서 가져온 스팬의 경우 `None` 을" " 사용하세요." #: ../../functions.rst:816 0de58fc1e9b343c2b2d6d719c82d5cc9 msgid "the character." msgstr "문자." #: ../../functions.rst:817 b0444b9caf674df4a28978df8d452580 msgid "" "the :ref:`Quad` of the character, usable for text marker annotations " "('Highlight', etc.)." msgstr "문자의 :ref:`Quad`, 텍스트 마커 주석('Highlight' 등)에 사용 가능." #: ../../functions.rst:823 2383e87ea4f74ca3b4dbf8fac78fae8c msgid "" "Compute the quadrilateral of a subset of characters of a span extracted " "via option \"rawdict\" of :meth:`Page.get_text`." msgstr ":meth:`Page.get_text` 의 \"rawdict\" 옵션을 통해 추출된 스팬의 문자 하위 집합의 사각형을 계산합니다." #: ../../functions.rst:827 fe3fd7ff9c464621843bea5d3d910e20 msgid "" "the characters to consider. If given, the selected extraction option must" " be \"rawdict\"." msgstr "고려할 문자. 주어진 경우 선택된 추출 옵션은 \"rawdict\"여야 합니다." #: ../../functions.rst:828 80bc82b9eab8453389713a6186de07d5 msgid "" "the :ref:`Quad` of the selected characters, usable for text marker " "annotations ('Highlight', etc.)." msgstr "선택된 문자의 :ref:`Quad`, 텍스트 마커 주석('Highlight' 등)에 사용 가능." #: ../../functions.rst:834 5a8cf6fbcf4d4ef1be7317c9ccef6471 msgid "" "Compute the quadrilateral of a subset of spans of a text line extracted " "via options \"dict\" or \"rawdict\" of :meth:`Page.get_text`." msgstr "" ":meth:`Page.get_text` 의 \"dict\" 또는 \"rawdict\" 옵션을 통해 추출된 텍스트 라인의 스팬 하위 " "집합의 사각형을 계산합니다." #: ../../functions.rst:836 c22d97f050f94943b1509a1116b1ec58 msgid "the line." msgstr "라인." #: ../../functions.rst:837 93ca3f15067647d68628fc26d746709c msgid "" "a sub-list of `line[\"spans\"]`. If omitted, the full line quad will be " "returned." msgstr "`line[\"spans\"]` 의 하위 목록. 생략하면 전체 라인 쿼드가 반환됩니다." #: ../../functions.rst:838 7bd8eeabe2254422bf223a1658cb6d04 msgid "" "the :ref:`Quad` of the selected line spans, usable for text marker " "annotations ('Highlight', etc.)." msgstr "선택된 라인 스팬의 :ref:`Quad`, 텍스트 마커 주석('Highlight' 등)에 사용 가능." #: ../../functions.rst:844 64e462661be944f3a62a6df56af9d839 msgid "Detect Tesseract language support folder." msgstr "Tesseract 언어 지원 폴더 감지." #: ../../functions.rst:846 36cd291815a54fe890dfc549855cb135 msgid "" "This function is used to enable OCR via Tesseract even if the language " "support folder is not specified directly or in environment variable " "TESSDATA_PREFIX." msgstr "" "이 함수는 언어 지원 폴더가 직접 또는 환경 변수 TESSDATA_PREFIX에 지정되지 않은 경우에도 Tesseract를 통해 " "OCR을 활성화하는 데 사용됩니다." #: ../../functions.rst:850 9df72e40b69a45bf8734dc507588842b msgid "If is set we return it directly." msgstr "가 설정되어 있으면 직접 반환합니다." #: ../../functions.rst:852 6ad23f9268db4f50b930607a1e593e11 msgid "Otherwise we return `os.environ['TESSDATA_PREFIX']` if set." msgstr "그렇지 않으면 설정된 경우 `os.environ['TESSDATA_PREFIX']` 를 반환합니다." #: ../../functions.rst:854 81a272ead43746849c211778e4f173f6 msgid "" "Otherwise we search for a Tesseract installation and return its language " "support folder." msgstr "그렇지 않으면 Tesseract 설치를 검색하고 언어 지원 폴더를 반환합니다." #: ../../functions.rst:857 05770e4eb5f248e1b9c0b632023d3c3e msgid "Otherwise we raise an exception." msgstr "그렇지 않으면 예외를 발생시킵니다." #: ../../functions.rst:867 6165db22dfb447e784347e5fffeb9159 msgid "" "Return the (unique) infinite rectangle `Rect(-2147483648.0, " "-2147483648.0, 2147483520.0, 2147483520.0)`, resp. the :ref:`IRect` and " ":ref:`Quad` counterparts. It is the largest possible rectangle: all valid" " rectangles are contained in it." msgstr "" "(유일한) 무한 사각형 `Rect(-2147483648.0, -2147483648.0, 2147483520.0, " "2147483520.0)` 또는 이에 해당하는 :ref:`IRect` 및 :ref:`Quad` 를 반환합니다. 이것은 가능한 가장 " "큰 사각형입니다: 모든 유효한 사각형이 포함됩니다." #: ../../functions.rst:877 0a193887c7ac4df6b78c43a679165d96 msgid "" "Return the \"standard\" empty and invalid rectangle `Rect(2147483520.0, " "2147483520.0, -2147483648.0, -2147483648.0)` resp. quad. Its top-left and" " bottom-right point values are reversed compared to the infinite " "rectangle. It will e.g. be used to indicate empty bboxes in " "`page.get_text(\"dict\")` dictionaries. There are however infinitely many" " empty or invalid rectangles." msgstr "" "\"표준\" 빈 및 유효하지 않은 사각형 `Rect(2147483520.0, 2147483520.0, -2147483648.0, " "-2147483648.0)` 또는 이에 해당하는 쿼드를 반환합니다. 왼쪽 위 및 오른쪽 아래 점 값이 무한 사각형과 비교하여 " "반대입니다. 예를 들어 `page.get_text(\"dict\")` 딕셔너리에서 빈 bbox를 나타내는 데 사용됩니다. 그러나 " "무한히 많은 빈 또는 유효하지 않은 사각형이 있습니다." #: ../../functions.rst:883 57941cc8bfe54662a58baa544596de42 msgid "" "Returns a dict mapping lower-case color name to `(red, green, blue)` " "tuple, and `red`, `green`, `blue` are floats in range 0..1." msgstr "" "소문자 색상 이름을 `(red, green, blue)` 튜플에 매핑하는 딕셔너리를 반환하며, `red`, `green`, " "`blue` 는 0..1 범위의 float입니다." #: ../../functions.rst:888 501128a84def4aeb9ded0eb35633124b msgid "" "Returns a list of `(colorname, red, green, blue)` tuples, where " "`colorname` is upper case and `red`, `green`, `blue` are integers in " "range 0..255." msgstr "" "`(colorname, red, green, blue)` 튜플 목록을 반환하며, 여기서 `colorname` 은 대문자이고 " "`red`, `green`, `blue` 는 0..255 범위의 정수입니다." #: ../../footer.rst:57 3f2e7072cb5c4a93ab763b29d4244bc2 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/glossary.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d08d3d2cd62e4347ae2805cfcc06a70f msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 739bd76d85de44ed9317676c5473c0c4 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 4c57e05fc77144dfb8faf379a03cc56b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../glossary.rst:7 28cd3665c98c4ea997db495f331f026c msgid "Glossary" msgstr "용어집" #: ../../glossary.rst:11 586bce9bf00e4c89b0241028b3c7ff08 msgid "" "This is an essential general mathematical / geometrical term for " "understanding this documentation. Please see this section for a more " "detailed discussion: :ref:`Coordinates`." msgstr "이것은 이 문서를 이해하기 위한 필수적인 일반적인 수학/기하학 용어입니다. 자세한 내용은 :ref:`Coordinates` 섹션을 참조하세요." #: ../../glossary.rst:15 6bb8cff798704bbb98656190f68b478d msgid "A Python sequence of 6 numbers." msgstr "6개의 숫자로 구성된 Python 시퀀스입니다." #: ../../glossary.rst:19 4be6452df2ab4c31adadf519dd1f3f3d msgid "A Python sequence of 4 numbers." msgstr "4개의 숫자로 구성된 Python 시퀀스입니다." #: ../../glossary.rst:23 4f04da6f55df426d9a81f7ddd5cf35a4 msgid "A Python sequence of 4 integers." msgstr "4개의 정수로 구성된 Python 시퀀스입니다." #: ../../glossary.rst:27 0816befe649d4c23ac61285cc1d4c68a msgid "A Python sequence of 2 numbers." msgstr "2개의 숫자로 구성된 Python 시퀀스입니다." #: ../../glossary.rst:31 4b252ecf18494010ac1b4abf8318014b msgid "A Python sequence of 4 :data:`point_like` items." msgstr "4개의 :data:`point_like` 항목으로 구성된 Python 시퀀스입니다." #: ../../glossary.rst:35 08979edc495d4e0c8fb3091ac014aeb6 msgid "" "A number of values in a PDF can inherited by objects further down in a " "parent-child relationship. The mediabox (physical size) of pages may for " "example be specified only once or in some node(s) of the :data:`pagetree`" " and will then be taken as value for all *kids*, that do not specify " "their own value." msgstr "PDF의 여러 값은 부모-자식 관계에서 하위 객체에 상속될 수 있습니다. 예를 들어 페이지의 mediabox(물리적 크기)는 한 번만 지정되거나 :data:`pagetree` 의 일부 노드에 지정될 수 있으며, 자체 값을 지정하지 않는 모든 *자식* 에 대한 값으로 사용됩니다." #: ../../glossary.rst:41 bd92584d9672427a92de7ae2ca2c9ef5 msgid "" "A PDF array of 4 floats specifying a physical page size -- " "(:data:`inheritable`, mandatory). This rectangle should contain all other" " PDF -- optional -- page rectangles, which may be specified in addition:" " CropBox, TrimBox, ArtBox and BleedBox. Please consult :ref:`AdobeManual`" " for details. The MediaBox is the only rectangle, for which there is no " "difference between MuPDF and PDF coordinate systems: " ":attr:`Page.mediabox` will always show the same coordinates as the " "`/MediaBox` key in a page's object definition. For all other rectangles, " "MuPDF transforms y coordinates such that the **top** border is the point " "of reference. This can sometimes be confusing -- you may for example " "encounter a situation like this one:" msgstr "물리적 페이지 크기를 지정하는 4개의 float로 구성된 PDF 배열입니다 -- (:data:`inheritable`, 필수). 이 사각형은 추가로 지정할 수 있는 다른 모든 PDF 페이지 사각형(CropBox, TrimBox, ArtBox, BleedBox)을 포함해야 합니다. 자세한 내용은 :ref:`AdobeManual` 을 참조하세요. MediaBox는 MuPDF와 PDF 좌표계 간에 차이가 없는 유일한 사각형입니다: :attr:`Page.mediabox` 는 항상 페이지 객체 정의의 `/MediaBox` 키와 동일한 좌표를 표시합니다. 다른 모든 사각형의 경우, MuPDF는 **상단** 경계가 기준점이 되도록 y 좌표를 변환합니다. 이로 인해 때때로 혼란스러울 수 있습니다 -- 예를 들어 다음과 같은 상황을 만날 수 있습니다:" #: ../../glossary.rst:43 c84f72a1ef1a493db58b9912d0b5c864 msgid "" "The page definition contains the following identical values: `/MediaBox [" " 36 45 607.5 765 ]`, `/CropBox [ 36 45 607.5 765 ]`." msgstr "페이지 정의에는 다음과 같은 동일한 값이 포함되어 있습니다: `/MediaBox [ 36 45 607.5 765 ]`, `/CropBox [ 36 45 607.5 765 ]`." #: ../../glossary.rst:44 a0a14effa0694f848b4b68f6433c6e41 msgid "" "PyMuPDF accordingly shows `page.mediabox = Rect(36.0, 45.0, 607.5, " "765.0)`." msgstr "따라서 PyMuPDF는 `page.mediabox = Rect(36.0, 45.0, 607.5, 765.0)` 을 표시합니다." #: ../../glossary.rst:45 6452ee0315854e7a8d8c7b5ceae4b2f4 msgid "" "**BUT:** `page.cropbox = Rect(36.0, 0.0, 607.5, 720.0)`, because the two " "y-coordinates have been transformed (45 subtracted from both of them)." msgstr "**하지만:** `page.cropbox = Rect(36.0, 0.0, 607.5, 720.0)` 입니다. 두 y 좌표가 변환되었기 때문입니다(둘 다에서 45가 빼졌습니다)." #: ../../glossary.rst:49 54bb2fd6606f42b0b61698e8f5e4264f msgid "" "A PDF array of 4 floats specifying a page's visible area -- " "(:data:`inheritable`, optional). It is the default for TrimBox, ArtBox " "and BleedBox. If not present, it defaults to MediaBox. This value is " "**not affected** if the page is rotated -- in contrast to " ":attr:`Page.rect`. Also, other than the page rectangle, the top-left " "corner of the cropbox may or may not be *(0, 0)*." msgstr "페이지의 보이는 영역을 지정하는 4개의 float로 구성된 PDF 배열입니다 -- (:data:`inheritable`, 선택 사항). TrimBox, ArtBox 및 BleedBox의 기본값입니다. 없으면 MediaBox를 기본값으로 사용합니다. 이 값은 페이지가 회전되어도 **영향을 받지 않습니다** -- :attr:`Page.rect` 와 대조됩니다. 또한 페이지 사각형과 달리 cropbox의 왼쪽 상단 모서리는 *(0, 0)* 일 수도 있고 아닐 수도 있습니다." #: ../../glossary.rst:54 32d13994ea71438cba097ae7ab179529 msgid "" "A central PDF :data:`dictionary` -- also called the \"root\" -- " "containing document-wide parameters and pointers to many other " "information. Its :data:`xref` is returned by " ":meth:`Document.pdf_catalog`." msgstr "문서 전체 매개변수와 다른 많은 정보에 대한 포인터를 포함하는 중앙 PDF :data:`dictionary` 입니다 -- \"root\"라고도 합니다. 그 :data:`xref` 는 :meth:`Document.pdf_catalog` 에 의해 반환됩니다." #: ../../glossary.rst:58 5758183571814745904de85f3da96f2c msgid "" "More precisely, the **PDF trailer** contains information in " ":data:`dictionary` format. It is usually located at the file's end. In " "this dictionary, you will find things like the xrefs of the catalog and " "the metadata, the number of :data:`xref` numbers, etc. Here is the " "definition of the PDF spec:" msgstr "더 정확히 말하면, **PDF trailer** 는 :data:`dictionary` 형식의 정보를 포함합니다. 일반적으로 파일의 끝에 위치합니다. 이 사전에는 카탈로그 및 메타데이터의 xref, :data:`xref` 번호의 개수 등이 포함됩니다. PDF 사양의 정의는 다음과 같습니다:" #: ../../glossary.rst:60 0d85c5a6d7454c289824fc58d0a6fdef msgid "" "*\"The trailer of a PDF file enables an application reading the file to " "quickly find the cross-reference table and certain special objects. " "Applications should read a PDF file from its end.\"*" msgstr "*\"PDF 파일의 trailer는 파일을 읽는 애플리케이션이 교차 참조 테이블과 특정 특수 객체를 빠르게 찾을 수 있게 합니다. 애플리케이션은 PDF 파일을 끝에서부터 읽어야 합니다.\"*" #: ../../glossary.rst:62 5e0b8a538504497aa555e757cfa9f113 msgid "" "To access the trailer in PyMuPDF, use the usual methods " ":meth:`Document.xref_object`, :meth:`Document.xref_get_key` and " ":meth:`Document.xref_get_keys` with `-1` instead of a positive xref " "number." msgstr "PyMuPDF에서 trailer에 액세스하려면 일반 메서드 :meth:`Document.xref_object`, :meth:`Document.xref_get_key` 및 :meth:`Document.xref_get_keys` 를 양수 xref 번호 대신 `-1` 과 함께 사용하세요." #: ../../glossary.rst:66 96ea53e1526e4f31b6a7cd5ebbeef7a7 msgid "" "A **content stream** is a PDF :data:`object` with an attached " ":data:`stream`, whose data consists of a sequence of instructions " "describing the graphical elements to be painted on a page, see \"Stream " "Objects\" on page 19 of :ref:`AdobeManual`. For an overview of the mini-" "language used in these streams, see chapter \"Operator Summary\" on page " "643 of the :ref:`AdobeManual`. A PDF :data:`page` can have none to many " "contents objects. If it has none, the page is empty (but still may show " "annotations). If it has several, they will be interpreted in sequence as " "if their instructions had been present in one such object (i.e. like in a" " concatenated string). It should be noted that there are more stream " "object types which use the same syntax: e.g. appearance dictionaries " "associated with annotations and Form XObjects." msgstr "**content stream** 은 첨부된 :data:`stream` 이 있는 PDF :data:`object` 로, 그 데이터는 페이지에 그려질 그래픽 요소를 설명하는 명령 시퀀스로 구성됩니다. :ref:`AdobeManual` 의 19페이지 \"Stream Objects\"를 참조하세요. 이러한 스트림에서 사용되는 미니 언어의 개요는 :ref:`AdobeManual` 의 643페이지 \"Operator Summary\" 장을 참조하세요. PDF :data:`page` 는 0개에서 여러 개의 contents 객체를 가질 수 있습니다. 없으면 페이지가 비어 있습니다(하지만 여전히 주석을 표시할 수 있습니다). 여러 개가 있으면 하나의 객체에 명령이 있는 것처럼 순차적으로 해석됩니다(즉, 연결된 문자열처럼). 동일한 구문을 사용하는 더 많은 스트림 객체 유형이 있습니다: 예를 들어 주석 및 Form XObject와 연결된 appearance dictionary." #: ../../glossary.rst:68 789ecf52493843de99d4baf64aac0706 msgid "PyMuPDF provides a number of methods to deal with contents of PDF pages:" msgstr "PyMuPDF는 PDF 페이지의 콘텐츠를 처리하기 위한 여러 메서드를 제공합니다:" #: ../../glossary.rst:70 7af31d456e6049c781db775b0d937ce4 msgid "" ":meth:`Page.read_contents()` -- reads and concatenates all page contents " "into one `bytes` object." msgstr ":meth:`Page.read_contents()` -- 모든 페이지 콘텐츠를 읽어서 하나의 `bytes` 객체로 연결합니다." #: ../../glossary.rst:71 ed6a3af3341c4060a1e4a75572b4ddd5 msgid "" ":meth:`Page.clean_contents()` -- a wrapper of a MuPDF function that " "reads, concatenates and syntax-cleans all page contents. After this, only" " one `/Contents` object will exist. In addition, page :data:`resources` " "will have been synchronized with it such that it will contain exactly " "those images, fonts and other objects that the page actually references." msgstr ":meth:`Page.clean_contents()` -- 모든 페이지 콘텐츠를 읽고, 연결하고, 구문을 정리하는 MuPDF 함수의 래퍼입니다. 이후에는 하나의 `/Contents` 객체만 존재합니다. 또한 페이지 :data:`resources` 가 동기화되어 페이지가 실제로 참조하는 이미지, 글꼴 및 기타 객체만 정확히 포함됩니다." #: ../../glossary.rst:72 b5f192573e604b7ab3a23459f4ff8d28 msgid "" ":meth:`Page.get_contents()` -- return a list of :data:`xref` numbers of a" " page's :data:`contents` objects. May be empty. Use " ":meth:`Document.xref_stream()` with one of these xrefs to read the resp. " "contents section." msgstr ":meth:`Page.get_contents()` -- 페이지의 :data:`contents` 객체의 :data:`xref` 번호 목록을 반환합니다. 비어 있을 수 있습니다. 이러한 xref 중 하나와 함께 :meth:`Document.xref_stream()` 을 사용하여 해당 콘텐츠 섹션을 읽으세요." #: ../../glossary.rst:73 1999ff45a4f744478c87ada7170c63a7 msgid "" ":meth:`Page.set_contents()` -- set a page's `/Contents` key to the " "provided :data:`xref` number." msgstr ":meth:`Page.set_contents()` -- 페이지의 `/Contents` 키를 제공된 :data:`xref` 번호로 설정합니다." #: ../../glossary.rst:77 a33fe5bd332e49fbac0209663f12f749 msgid "" "A :data:`dictionary` containing references to any resources (like images " "or fonts) required by a PDF :data:`page` (required, inheritable, " ":ref:`AdobeManual` p. 81) and certain other objects (Form XObjects). This" " dictionary appears as a sub-dictionary in the object definition under " "the key */Resources*. Being an inheritable object type, there may exist " "\"parent\" resources for all pages or certain subsets of pages." msgstr "PDF :data:`page` 에 필요한 리소스(이미지 또는 글꼴 등)에 대한 참조를 포함하는 :data:`dictionary` 입니다(필수, 상속 가능, :ref:`AdobeManual` p. 81) 및 특정 다른 객체(Form XObject). 이 사전은 키 */Resources* 아래의 객체 정의에 하위 사전으로 나타납니다. 상속 가능한 객체 유형이므로 모든 페이지 또는 특정 페이지 하위 집합에 대한 \"부모\" 리소스가 존재할 수 있습니다." #: ../../glossary.rst:81 d54465f90aea45f4be640dcb0dd409ab msgid "" "A PDF :data:`object` type, which is somewhat comparable to the same-named" " Python notion: \"A dictionary object is an associative table containing " "pairs of objects, known as the dictionary's entries. The first element of" " each entry is the key and the second element is the value. The key must " "be a name (...). The value can be any kind of object, including another " "dictionary. A dictionary entry whose value is null (...) is equivalent to" " an absent entry.\" (:ref:`AdobeManual` p. 18)." msgstr "동일한 이름의 Python 개념과 어느 정도 비교할 수 있는 PDF :data:`object` 유형입니다: \"dictionary 객체는 dictionary의 항목으로 알려진 객체 쌍을 포함하는 연관 테이블입니다. 각 항목의 첫 번째 요소는 키이고 두 번째 요소는 값입니다. 키는 이름이어야 합니다(...). 값은 다른 dictionary를 포함하여 모든 종류의 객체일 수 있습니다. 값이 null인 dictionary 항목(...)은 없는 항목과 동일합니다.\" (:ref:`AdobeManual` p. 18)." #: ../../glossary.rst:83 f8dd50a4a4dd44b2ab3811dde6bd8cf3 msgid "" "Dictionaries are the most important :data:`object` type in PDF. Here is " "an example (describing a :data:`page`)::" msgstr "Dictionary는 PDF에서 가장 중요한 :data:`object` 유형입니다. 다음은 예제입니다(:data:`page` 설명)::" #: ../../glossary.rst:102 b9f82bb7035946b4804cfd94101fd4c4 msgid "" "*Contents*, *Type*, *MediaBox*, etc. are **keys**, *40 0 R*, *Page*, *[0 " "0 595.32 841.92]*, etc. are the respective **values**. The strings " "*\"<<\"* and *\">>\"* are used to enclose object definitions." msgstr "*Contents*, *Type*, *MediaBox* 등은 **키** 이고, *40 0 R*, *Page*, *[0 0 595.32 841.92]* 등은 각각의 **값** 입니다. 문자열 *\"<<\"* 및 *\">>\"* 는 객체 정의를 묶는 데 사용됩니다." #: ../../glossary.rst:104 b635f1dd09be42db81dc681669f2d25d msgid "" "This example also shows the syntax of **nested** dictionary values: " "*Resources* has an object as its value, which in turn is a dictionary " "with keys like *ExtGState* (with the value *<>*, which is " "another dictionary), etc." msgstr "이 예제는 **중첩된** dictionary 값의 구문도 보여줍니다: *Resources* 는 그 값으로 객체를 가지며, 이 객체는 *ExtGState* (값은 *<>* 로, 또 다른 dictionary)와 같은 키를 가진 dictionary입니다." #: ../../glossary.rst:108 acf84ed282d0488ca9ec42cb7a8b05cd msgid "" "A PDF page is a :data:`dictionary` object which defines one page in a " "PDF, see :ref:`AdobeManual` p. 71." msgstr "PDF 페이지는 PDF의 한 페이지를 정의하는 :data:`dictionary` 객체입니다. :ref:`AdobeManual` p. 71을 참조하세요." #: ../../glossary.rst:112 2e0101c6f2df4a99a2a341fe77b08849 msgid "" "The pages of a document are accessed through a structure known as the " "page tree, which defines the ordering of pages in the document. The tree " "structure allows PDF consumer applications, using only limited memory, to" " quickly open a document containing thousands of pages. The tree contains" " nodes of two types: intermediate nodes, called page tree nodes, and leaf" " nodes, called page objects. (:ref:`AdobeManual` p. 75)." msgstr "문서의 페이지는 페이지 트리라고 하는 구조를 통해 액세스되며, 이는 문서의 페이지 순서를 정의합니다. 트리 구조를 사용하면 제한된 메모리만 사용하여 수천 페이지를 포함하는 문서를 빠르게 열 수 있습니다. 트리에는 두 가지 유형의 노드가 포함됩니다: 중간 노드(페이지 트리 노드라고 함)와 리프 노드(페이지 객체라고 함). (:ref:`AdobeManual` p. 75)." #: ../../glossary.rst:114 4d06cfcc4e614225ae5861c899219585 msgid "" "While it is possible to list all page references in just one array, PDFs " "with many pages are often created using *balanced tree* structures " "(\"page trees\") for faster access to any single page. In relation to the" " total number of pages, this can reduce the average page access time by " "page number from a linear to some logarithmic order of magnitude." msgstr "모든 페이지 참조를 하나의 배열에 나열하는 것이 가능하지만, 많은 페이지가 있는 PDF는 단일 페이지에 더 빠르게 액세스하기 위해 *균형 트리* 구조(\"페이지 트리\")를 사용하여 생성되는 경우가 많습니다. 전체 페이지 수와 관련하여, 이를 통해 페이지 번호별 평균 페이지 액세스 시간을 선형에서 대수적 크기 순서로 줄일 수 있습니다." #: ../../glossary.rst:116 01db9b917bcc4cb89215ac102dda29c9 msgid "" "For fast page access, MuPDF can use its own array in memory -- " "independently from what may or may not be present in the document file. " "This array is indexed by page number and therefore much faster than even " "the access via a perfectly balanced page tree." msgstr "빠른 페이지 액세스를 위해 MuPDF는 문서 파일에 있을 수도 있고 없을 수도 있는 것과 독립적으로 메모리에서 자체 배열을 사용할 수 있습니다. 이 배열은 페이지 번호로 인덱싱되므로 완벽하게 균형 잡힌 페이지 트리를 통한 액세스보다 훨씬 빠릅니다." #: ../../glossary.rst:120 387b50e08c0a4411b5174a213523a1c0 msgid "" "Similar to Python, PDF supports the notion *object*, which can come in " "eight basic types: boolean values (\"true\" or \"false\"), integer and " "real numbers, strings (**always** enclosed in brackets -- either \"()\", " "or \"<>\" to indicate hexadecimal), names (must always start with a " "\"/\", e.g. `/Contents`), arrays (enclosed in brackets \"[]\"), " "dictionaries (enclosed in brackets \"<<>>\"), streams (enclosed by " "keywords \"stream\" / \"endstream\"), and the null object (\"null\") " "(:ref:`AdobeManual` p. 13). Objects can be made identifiable by assigning" " a label. This label is then called *indirect* object. PyMuPDF supports " "retrieving definitions of indirect objects via their cross reference " "number via :meth:`Document.xref_object`." msgstr "Python과 유사하게, PDF는 *object* 개념을 지원하며, 8가지 기본 유형이 있습니다: 불리언 값(\"true\" 또는 \"false\"), 정수 및 실수, 문자열(**항상** 괄호로 묶임 -- \"()\" 또는 16진수를 나타내는 \"<>\"), 이름(항상 \"/\"로 시작해야 함, 예: `/Contents`), 배열(괄호 \"[]\"로 묶임), dictionary(괄호 \"<<>>\"로 묶임), 스트림(키워드 \"stream\" / \"endstream\"로 묶임), null 객체(\"null\") (:ref:`AdobeManual` p. 13). 객체는 레이블을 할당하여 식별 가능하게 만들 수 있습니다. 이 레이블은 *indirect* 객체라고 합니다. PyMuPDF는 :meth:`Document.xref_object` 를 통해 교차 참조 번호로 indirect 객체의 정의를 검색하는 것을 지원합니다." #: ../../glossary.rst:124 06fab8191ebd49d98a31a5d42c048ce5 msgid "" "A PDF :data:`dictionary` :data:`object` type which is followed by a " "sequence of bytes, similar to Python *bytes*. \"However, a PDF " "application can read a stream incrementally, while a string must be read " "in its entirety. Furthermore, a stream can be of unlimited length, " "whereas a string is subject to an implementation limit. For this reason, " "objects with potentially large amounts of data, such as images and page " "descriptions, are represented as streams.\" \"A stream consists of a " ":data:`dictionary` followed by zero or more bytes bracketed between the " "keywords *stream* and *endstream*\"::" msgstr "Python *bytes* 와 유사한 바이트 시퀀스가 뒤따르는 PDF :data:`dictionary` :data:`object` 유형입니다. \"그러나 PDF 애플리케이션은 스트림을 점진적으로 읽을 수 있지만 문자열은 전체를 읽어야 합니다. 또한 스트림은 무제한 길이일 수 있지만 문자열은 구현 제한이 적용됩니다. 이러한 이유로 이미지 및 페이지 설명과 같이 잠재적으로 많은 양의 데이터를 가진 객체는 스트림으로 표현됩니다.\" \"스트림은 키워드 *stream* 과 *endstream* 사이에 괄호로 묶인 0개 이상의 바이트가 뒤따르는 :data:`dictionary` 로 구성됩니다\"::" #: ../../glossary.rst:135 8dc0a34bf972472abef68fc3fe378101 msgid "" "See :ref:`AdobeManual` p. 19. PyMuPDF supports retrieving stream content " "via :meth:`Document.xref_stream`. Use :meth:`Document.is_stream` to " "determine whether an object is of stream type." msgstr ":ref:`AdobeManual` p. 19를 참조하세요. PyMuPDF는 :meth:`Document.xref_stream` 을 통해 스트림 콘텐츠를 검색하는 것을 지원합니다. 객체가 스트림 유형인지 확인하려면 :meth:`Document.is_stream` 을 사용하세요." #: ../../glossary.rst:139 d4686fb4f3814da3a119b81f119de382 msgid "" "A mathematical notion meaning a vector of norm (\"length\") 1 -- usually " "the Euclidean norm is implied. In PyMuPDF, this term is restricted to " ":ref:`Point` objects, see :attr:`Point.unit`." msgstr "노름(\"길이\")이 1인 벡터를 의미하는 수학적 개념입니다 -- 일반적으로 유클리드 노름을 의미합니다. PyMuPDF에서 이 용어는 :ref:`Point` 객체로 제한됩니다. :attr:`Point.unit` 을 참조하세요." #: ../../glossary.rst:143 e286649e7ce1436db8fbb7e65637ba3a msgid "" "Abbreviation for cross-reference number: this is an integer unique " "identification for objects in a PDF. There exists a cross-reference table" " (which may physically consist of several separate segments) in each PDF," " which stores the relative position of each object for quick lookup. The " "cross-reference table is one entry longer than the number of existing " "object: item zero is reserved and must not be used in any way. Many " "PyMuPDF classes have an :data:`xref` attribute (which is zero for non-" "PDFs), and one can find out the total number of objects in a PDF via " ":meth:`Document.xref_length` *- 1*." msgstr "교차 참조 번호의 약어: PDF의 객체에 대한 고유한 정수 식별자입니다. 각 PDF에는 빠른 조회를 위해 각 객체의 상대 위치를 저장하는 교차 참조 테이블이 있습니다(물리적으로 여러 개의 별도 세그먼트로 구성될 수 있음). 교차 참조 테이블은 기존 객체 수보다 하나 더 긴 항목을 가집니다: 항목 0은 예약되어 있으며 어떤 방식으로도 사용해서는 안 됩니다. 많은 PyMuPDF 클래스에는 :data:`xref` 속성이 있습니다(비PDF의 경우 0). :meth:`Document.xref_length` *- 1* 을 통해 PDF의 객체 총 수를 확인할 수 있습니다." #: ../../glossary.rst:148 6aa968ee6fb249d1bc62117c164aba0c msgid "" "When referring to font size this metric is measured in points where 1 " "inch = 72 points." msgstr "글꼴 크기를 나타낼 때 이 측정값은 포인트로 측정되며, 1인치 = 72포인트입니다." #: ../../glossary.rst:152 8c31d4e0a1d44b928122302b18a161d4 msgid "" "Images and :ref:`Pixmap` objects may contain resolution information " "provided as \"dots per inch\", dpi, in each direction (horizontal and " "vertical). When MuPDF reads an image from a file or from a PDF object, it" " will parse this information and put it in :attr:`Pixmap.xres`, " ":attr:`Pixmap.yres`, respectively. If it finds no meaningful information " "in the input (like non-positive values or values exceeding 4800), it will" " use \"sane\" defaults instead. The usual default value is 96, but it may" " also be 72 in some cases (e.g. for JPX images)." msgstr "이미지 및 :ref:`Pixmap` 객체는 각 방향(수평 및 수직)에서 \"인치당 도트 수\"인 dpi로 제공되는 해상도 정보를 포함할 수 있습니다. MuPDF가 파일 또는 PDF 객체에서 이미지를 읽을 때 이 정보를 구문 분석하여 각각 :attr:`Pixmap.xres`, :attr:`Pixmap.yres` 에 넣습니다. 입력에서 의미 있는 정보를 찾지 못하면(양수가 아닌 값 또는 4800을 초과하는 값 등) 대신 \"적절한\" 기본값을 사용합니다. 일반적인 기본값은 96이지만 일부 경우(예: JPX 이미지)에는 72일 수도 있습니다." #: ../../glossary.rst:156 3e01cf857dca416c8faa34ba7d94265e msgid "" "Optional content properties dictionary - a sub :data:`dictionary` of the " "PDF :data:`catalog`. The central place to store optional content " "information, which is identified by the key `/OCProperties`. This " "dictionary has two required and one optional entry: (1) `/OCGs`, " "required, an array listing all optional content groups, (2) `/D`, " "required, the default optional content configuration dictionary (OCCD), " "(3) `/Configs`, optional, an array of alternative OCCDs." msgstr "선택적 콘텐츠 속성 dictionary - PDF :data:`catalog` 의 하위 :data:`dictionary`. 선택적 콘텐츠 정보를 저장하는 중앙 위치이며, 키 `/OCProperties` 로 식별됩니다. 이 dictionary에는 두 개의 필수 항목과 하나의 선택적 항목이 있습니다: (1) `/OCGs`, 필수, 모든 선택적 콘텐츠 그룹을 나열하는 배열, (2) `/D`, 필수, 기본 선택적 콘텐츠 구성 dictionary(OCCD), (3) `/Configs`, 선택, 대체 OCCD 배열." #: ../../glossary.rst:161 428928e7e81c403491625f300bc7e77c msgid "" "Optional content configuration dictionary - a PDF :data:`dictionary` " "inside the PDF :data:`OCPD`. It stores a setting of ON / OFF states of " "OCGs and how they are presented to a PDF viewer program. Selecting a " "configuration is quick way to achieve temporary mass visibility state " "changes. After opening a PDF, the `/D` configuration of the :data:`OCPD` " "is always activated. Viewer should offer a way to switch between the " "`/D`, or one of the optional configurations contained in array " "`/Configs`." msgstr "선택적 콘텐츠 구성 dictionary - PDF :data:`OCPD` 내부의 PDF :data:`dictionary`. OCG의 ON/OFF 상태 설정과 PDF 뷰어 프로그램에 표시되는 방식을 저장합니다. 구성을 선택하는 것은 일시적인 대량 표시 상태 변경을 빠르게 달성하는 방법입니다. PDF를 연 후 :data:`OCPD` 의 `/D` 구성이 항상 활성화됩니다. 뷰어는 `/D` 또는 배열 `/Configs` 에 포함된 선택적 구성 중 하나 사이를 전환하는 방법을 제공해야 합니다." #: ../../glossary.rst:166 01fc3682e86d471d815772b433b66de6 msgid "" "Optional content group -- a :data:`dictionary` object used to control the" " visibility of other PDF objects like images or annotations. " "Independently on which page they are defined, objects with the same OCG " "can simultaneously be shown or hidden by setting their OCG to ON or OFF. " "This can be achieved via the user interface provided by many PDF viewers " "(Adobe Acrobat), or programmatically." msgstr "선택적 콘텐츠 그룹 -- 이미지 또는 주석과 같은 다른 PDF 객체의 표시를 제어하는 데 사용되는 :data:`dictionary` 객체. 정의된 페이지와 무관하게 동일한 OCG를 가진 객체는 OCG를 ON 또는 OFF로 설정하여 동시에 표시하거나 숨길 수 있습니다. 이는 많은 PDF 뷰어(Adobe Acrobat)가 제공하는 사용자 인터페이스를 통해 또는 프로그래밍 방식으로 달성할 수 있습니다." #: ../../glossary.rst:170 63d877bcd5ef46dbb557f06da22dff6e msgid "" "Optional content membership dictionary -- a :data:`dictionary` object " "which can be used like an :data:`OCG`: it has a visibility state. The " "visibility of an OCMD is **computed:** it is a logical expression, which " "uses the state of one or more OCGs to produce a boolean value. The " "expression's result is interpreted as ON (true) or OFF (false)." msgstr "선택적 콘텐츠 멤버십 dictionary -- :data:`OCG` 처럼 사용할 수 있는 :data:`dictionary` 객체: 표시 상태가 있습니다. OCMD의 표시는 **계산됩니다:** 하나 이상의 OCG 상태를 사용하여 불리언 값을 생성하는 논리식입니다. 식의 결과는 ON(true) 또는 OFF(false)로 해석됩니다." #: ../../glossary.rst:174 7685086584e0476aa01c94592195fd87 msgid "" "Some frequent character combinations are represented by their own special" " glyphs in more advanced fonts. Typical examples are \"fi\", \"fl\", " "\"ffi\" and \"ffl\". These compounds are called *ligatures*. In PyMuPDF " "text extractions, there is the option to either return the corresponding " "unicode unchanged, or split ligatures up into their constituent parts: " "\"fi\" ==> \"f\" + \"i\", etc." msgstr "일부 빈번한 문자 조합은 더 고급 글꼴에서 자체 특수 글리프로 표현됩니다. 일반적인 예는 \"fi\", \"fl\", \"ffi\", \"ffl\"입니다. 이러한 복합체를 *ligature* 라고 합니다. PyMuPDF 텍스트 추출에서는 해당 유니코드를 변경하지 않고 반환하거나 ligature를 구성 요소로 분할하는 옵션이 있습니다: \"fi\" ==> \"f\" + \"i\" 등." #: ../../footer.rst:46 55f27ea4f801402884fd2fc89352730f msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/header-404.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header-404.rst:-1 eeba22b6b6f24accb7aaaf2ca8de91f4 msgid "Artifex" msgstr "Artifex" #: ../../header-404.rst:-1 32c66b9fa56c4fa3b5b6abcd9f3abcfc msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header-404.rst:-1 6b881eb1ccc64d55990a936130aecf2d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" ================================================ FILE: docs/locales/ko/LC_MESSAGES/header.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 2f3a42d58aed4c8d919199a1628e46e5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 8c5d0e6b475d4acbbd44f0169353b949 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8a0b412ed68e4084a844b1d3978b547f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" ================================================ FILE: docs/locales/ko/LC_MESSAGES/how-to-open-a-file.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 21b5c4028adc463abcc84975940e6301 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 ee82d615395c4e24b8b07395ed871d70 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 1d5b2478c53f433882bce199582d444d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../how-to-open-a-file.rst:7 5ea3d22849e641d897ccb82f8a12500f msgid "Opening Files" msgstr "파일 열기" #: ../../how-to-open-a-file.rst:16 395abd8299ba47be838498d680488494 msgid "Supported File Types" msgstr "지원되는 파일 유형" #: ../../how-to-open-a-file.rst:21 cb3463a996b24a14a008c2fc0ad2b685 msgid "PyMuPDF" msgstr "PyMuPDF" #: ../../how-to-open-a-file.rst:23 036ac377808741358875a6692e0b2d95 msgid "|PyMuPDF| can open files other than just |PDF|." msgstr "|PyMuPDF| 는 |PDF| 외의 파일도 열 수 있습니다." #: ../../how-to-open-a-file.rst:25 ../../how-to-open-a-file.rst:38 #: 1a17fc4b2c2e43a9a47e3a2a1ed82bd4 40ef4134dff248bc8869aed36fd176fc msgid "The following file types are supported:" msgstr "다음 파일 유형이 지원됩니다:" #: ../../how-to-open-a-file.rst:34 fa9ae965eea142478505848892067bb0 msgid "PyMuPDF Pro" msgstr "PyMuPDF Pro" #: ../../how-to-open-a-file.rst:36 c4725d269a0e41b0867c5b6b16b8960b msgid "|PyMuPDF Pro| can open Office files." msgstr "|PyMuPDF Pro| 는 Office 파일을 열 수 있습니다." #: ../../how-to-open-a-file.rst:43 d91d49bc138843188ab0077259cd82ae msgid "**DOC/DOCX**" msgstr "**DOC/DOCX**" #: ../../how-to-open-a-file.rst:44 6ff3d492743f45da9b9967b7ac205f1c msgid "**XLS/XLSX**" msgstr "**XLS/XLSX**" #: ../../how-to-open-a-file.rst:45 4c317c161ef64bebb742fc17e8e5c6d3 msgid "**PPT/PPTX**" msgstr "**PPT/PPTX**" #: ../../how-to-open-a-file.rst:46 dfd0df787a6d4a8bada3b55675495889 msgid "**HWP/HWPX**" msgstr "**HWP/HWPX**" #: ../../how-to-open-a-file.rst:63 61701c1d1007436987106ec058719b82 msgid "How to Open a File" msgstr "파일을 여는 방법" #: ../../how-to-open-a-file.rst:65 9dd2157acd454f2ea9e62168276399c2 msgid "To open a file, do the following:" msgstr "파일을 열려면 다음을 수행하세요:" #: ../../how-to-open-a-file.rst:72 284b59b0b7ca41789da44c7d61f81fc7 msgid "" "The above creates a :ref:`Document`. The instruction `doc = " "pymupdf.Document(\"a.pdf\")` does exactly the same. So, `open` is just a " "convenient alias and you can find its full API documented in that " "chapter." msgstr "위 코드는 :ref:`Document` 를 생성합니다. `doc = pymupdf.Document(\"a.pdf\")` 명령도 동일하게 작동합니다. 따라서 `open` 은 편의를 위한 별칭이며, 해당 장에서 전체 API 문서를 확인할 수 있습니다." #: ../../how-to-open-a-file.rst:76 1a5ad0264ff94231899c2caafe461a22 msgid "" "File Recognizer: Opening with :index:`a Wrong File Extension `" msgstr "파일 인식기: 잘못된 파일 확장자로 열기" #: ../../how-to-open-a-file.rst:78 90b4fc7ee95f43f49a70a15c890eb8b8 msgid "" "If you have a document with a wrong file extension for its type, do not " "worry: it will still be opened correctly, thanks to the integrated file " "\"content recognizer\"." msgstr "파일 유형과 다른 확장자를 가진 문서가 있어도 걱정하지 마세요: 통합된 파일 \"콘텐츠 인식기\" 덕분에 여전히 올바르게 열립니다." #: ../../how-to-open-a-file.rst:80 792fc8fc530d4591b0673684e9d0b274 msgid "" "This component looks at the actual data in the file using a number of " "heuristics -- independent of the file extension. This of course is also " "true for file names **without** an extension." msgstr "이 구성 요소는 파일 확장자와 무관하게 여러 휴리스틱을 사용하여 파일의 실제 데이터를 확인합니다. 확장자가 **없는** 파일 이름에도 마찬가지입니다." #: ../../how-to-open-a-file.rst:82 8eec48ad8d35400f93aa9ef384f1baee msgid "Here is a list of details about how the file content recognizer works:" msgstr "파일 콘텐츠 인식기의 작동 방식에 대한 세부사항은 다음과 같습니다:" #: ../../how-to-open-a-file.rst:84 999889fc95024292bbe0dc81938a321a msgid "" "When opening from a file name, use the ``filetype`` parameter if your " "file format cannot be determined by content inspection. This is for " "instance the case for all text files: \"txt\", \"html\", \"xml\" or " "source files. If the file extension is missing or wrong or the file " "resides in memory, the ``filetype`` must be used. File formats that can " "successfully be recognized will be opened even without or wrong " "extensions, and the ``filetype`` paraneter will be ignored." msgstr "파일 이름에서 열 때, 콘텐츠 검사를 통해 파일 형식을 결정할 수 없는 경우 ``filetype`` 매개변수를 사용하세요. 예를 들어 모든 텍스트 파일(\"txt\", \"html\", \"xml\" 또는 소스 파일)이 이에 해당합니다. 파일 확장자가 없거나 잘못되었거나 파일이 메모리에 있는 경우 ``filetype`` 을 사용해야 합니다. 성공적으로 인식할 수 있는 파일 형식은 확장자가 없거나 잘못되어도 열리며, ``filetype`` 매개변수는 무시됩니다." #: ../../how-to-open-a-file.rst:86 1ac5dd5257eb4ed280e6ec3ed082da31 msgid "" "Files based on text content do not contain unambiguously recognizable " "internal structures. This is true for source files (Python, C, etc.) but " "also HTML, XML and so on. Here, the file extensions and the ``filetype`` " "parameter continue to play a role and are used to create a \"Tex\" / " "\"HTML\" / ... document. Correspondingly, text files with other / no " "extensions, can successfully be opened using ``filetype``." msgstr "텍스트 콘텐츠 기반 파일은 명확하게 인식 가능한 내부 구조를 포함하지 않습니다. 소스 파일(Python, C 등)뿐만 아니라 HTML, XML 등도 마찬가지입니다. 이 경우 파일 확장자와 ``filetype`` 매개변수가 계속 역할을 하며 \"Tex\" / \"HTML\" / ... 문서를 만드는 데 사용됩니다. 따라서 다른 확장자 또는 확장자가 없는 텍스트 파일은 ``filetype`` 을 사용하여 성공적으로 열 수 있습니다." #: ../../how-to-open-a-file.rst:92 b9b6d23c55ea4547afea0a22f2d79c6d msgid "Opening Remote Files" msgstr "원격 파일 열기" #: ../../how-to-open-a-file.rst:95 3b43bf59bfc148328c683743eac1329f msgid "" "For remote files on a server (i.e. non-local files), you will need to " "*stream* the file data to |PyMuPDF|." msgstr "서버의 원격 파일(즉, 로컬이 아닌 파일)의 경우, 파일 데이터를 |PyMuPDF| 로 *스트리밍* 해야 합니다." #: ../../how-to-open-a-file.rst:97 34b7bf2e937a4250810966ed193bdfc8 msgid "" "For example use the `requests " "`_ library as follows:" msgstr "예를 들어 `requests `_ 라이브러리를 다음과 같이 사용하세요:" #: ../../how-to-open-a-file.rst:110 f259d8091f7242e7bdd2c51ebdd3f925 msgid "Opening Files from Cloud Services" msgstr "클라우드 서비스에서 파일 열기" #: ../../how-to-open-a-file.rst:112 21d40cb6351a4c69bc14196e1eb014ea msgid "" "For further examples which deal with files held on typical cloud services" " please see these `Cloud Interactions code snippets " "`_." msgstr "일반적인 클라우드 서비스에 저장된 파일을 다루는 추가 예제는 `Cloud Interactions 코드 스니펫 `_ 을 참조하세요." #: ../../how-to-open-a-file.rst:120 de92d6a4c46143de86751bded4adc336 msgid "Opening Django Files" msgstr "Django 파일 열기" #: ../../how-to-open-a-file.rst:122 2a24401c8daf4ec1967ffd20ab41ce1c msgid "" "Django implements a `File Storage API " "`_ to store " "files. The default is the `FileSystemStorage " "`_, but the `django-storages `_ library provides a number" " of other storage backends." msgstr "Django는 파일을 저장하기 위해 `File Storage API `_ 를 구현합니다. 기본값은 `FileSystemStorage `_ 이지만, `django-storages `_ 라이브러리는 여러 다른 스토리지 백엔드를 제공합니다." #: ../../how-to-open-a-file.rst:124 ce91bc54879b4e0caad6216633c87800 msgid "" "You can open the file, move the contents into memory, then pass the " "contents to |PyMuPDF| as a stream." msgstr "파일을 열고, 콘텐츠를 메모리로 이동한 다음, 콘텐츠를 스트림으로 |PyMuPDF| 에 전달할 수 있습니다." #: ../../how-to-open-a-file.rst:139 619bd327f13f4ed1a9204d62ce0a0e40 msgid "Please note that if the file you open is large, you may run out of memory." msgstr "열려는 파일이 큰 경우 메모리가 부족할 수 있습니다." #: ../../how-to-open-a-file.rst:141 e974ef8989724d7ca39ae4e2f528060d msgid "" "The File Storage API works well if you're using different storage " "backends in different environments. If you're only using the " "`FileSystemStorage`, you can simply use the `obj.file.name` to open the " "file directly with |PyMuPDF| as shown in an earlier example." msgstr "File Storage API는 다른 환경에서 다른 스토리지 백엔드를 사용하는 경우 잘 작동합니다. `FileSystemStorage` 만 사용하는 경우, 이전 예제에서와 같이 `obj.file.name` 을 사용하여 |PyMuPDF| 로 파일을 직접 열 수 있습니다." #: ../../how-to-open-a-file.rst:149 11fadcb68ef146fc93ca9f4473e140a5 msgid "Opening Files as Text" msgstr "파일을 텍스트로 열기" #: ../../how-to-open-a-file.rst:152 79658fdcc60c4f62821491708e3874a6 msgid "" "|PyMuPDF| has the capability to open any plain text file as a document. " "In order to do this you should provide the `filetype` parameter for the " "`pymupdf.open` function as `\"txt\"`." msgstr "|PyMuPDF| 는 모든 일반 텍스트 파일을 문서로 열 수 있는 기능이 있습니다. 이를 수행하려면 `pymupdf.open` 함수의 `filetype` 매개변수를 `\"txt\"` 로 제공해야 합니다." #: ../../how-to-open-a-file.rst:159 d72a0b8f986843488dfc6ddc257e4f45 msgid "" "In this way you are able to open a variety of file types and perform the " "typical **non-PDF** specific features like text searching, text " "extracting and page rendering. Obviously, once you have rendered your " "`txt` content, then saving as |PDF| or merging with other |PDF| files is " "no problem." msgstr "이렇게 하면 다양한 파일 유형을 열고 텍스트 검색, 텍스트 추출 및 페이지 렌더링과 같은 일반적인 **비PDF** 특정 기능을 수행할 수 있습니다. `txt` 콘텐츠를 렌더링한 후에는 |PDF| 로 저장하거나 다른 |PDF| 파일과 병합하는 것도 문제없습니다." #: ../../how-to-open-a-file.rst:163 25cb1a49799b43669b7c520e52fc2e46 msgid "Examples" msgstr "예제" #: ../../how-to-open-a-file.rst:167 df4ce47e55a94298b344689b280a64df msgid "Opening a `C#` file" msgstr "`C#` 파일 열기" #: ../../how-to-open-a-file.rst:176 2f20ca6b671845fca3ae2bceeb25eebd msgid "Opening an ``XML`` file" msgstr "``XML`` 파일 열기" #: ../../how-to-open-a-file.rst:184 1c25e62b57d843c9b5b8122f59295144 msgid "Opening a `JSON` file" msgstr "`JSON` 파일 열기" #: ../../how-to-open-a-file.rst:191 687e69a017bb48b682d8b720ad323f52 msgid "And so on!" msgstr "등등!" #: ../../how-to-open-a-file.rst:193 f6ae4e85cdb1469bbf04502e1bb02ccd msgid "" "As you can imagine many text based file formats can be *very simply " "opened* and *interpreted* by |PyMuPDF|. This can make data analysis and " "extraction for a wide range of previously unavailable files possible." msgstr "상상할 수 있듯이 많은 텍스트 기반 파일 형식은 |PyMuPDF| 로 *매우 간단하게 열고* *해석할* 수 있습니다. 이를 통해 이전에 사용할 수 없었던 광범위한 파일에 대한 데이터 분석 및 추출이 가능해집니다." #: ../../footer.rst:46 6894d49c24fc4cfa8f9d99a9257edfdf msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/identity.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 74c1aedfabcd4a5c96f4c2597285c328 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 6b94c7df538e4108a3a5ad33241349ec msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 23ee2c9ef17542ffbf5210e348e9de6a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../identity.rst:7 ec6871dd23a6408aba45460204127d54 msgid "Identity" msgstr "Identity" #: ../../identity.rst:9 776ab5a8eb3b4fd5ac5d1b88b17d507a msgid "" "Identity is a :ref:`Matrix` that performs no action -- to be used " "whenever the syntax requires a matrix, but no actual transformation " "should take place. It has the form *pymupdf.Matrix(1, 0, 0, 1, 0, 0)*." msgstr "Identity는 아무 작업도 수행하지 않는 :ref:`Matrix` 입니다. 구문이 행렬을 요구하지만 실제 변환이 필요하지 않을 때 사용됩니다. 형식은 *pymupdf.Matrix(1, 0, 0, 1, 0, 0)* 입니다." #: ../../identity.rst:11 2260793ef04b4f739e2e3ba60744f1c2 msgid "" "Identity is a constant, an \"immutable\" object. So, all of its matrix " "properties are read-only and its methods are disabled." msgstr "Identity는 상수이며 \"불변\" 객체입니다. 따라서 모든 행렬 속성은 읽기 전용이고 메서드는 비활성화됩니다." #: ../../identity.rst:13 66677799dfa547a68a4f708a29d071a0 msgid "" "If you need a **mutable** identity matrix as a starting point, use one of" " the following statements::" msgstr "시작점으로 **변경 가능한** 항등 행렬이 필요하면 다음 문 중 하나를 사용하세요::" #: ../../footer.rst:46 62e975eb99a4452285d40da0e91fc76e msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../index.rst:39 952c2d69888a45e9b0da6e043ddab148 msgid "About" msgstr "소개" #: ../../index.rst:50 83a8e5dd2a9b4d099b68e52044113c27 msgid "User Guide" msgstr "사용자 가이드" #: ../../index.rst:62 d17242cca69d431c8485f8ab5b729f2e msgid "How to Guide" msgstr "사용 방법 가이드" #: ../../index.rst:69 7466b8745c424beaac09483b379e1f16 msgid "API Reference" msgstr "API 참조" #: ../../index.rst:82 b24fcc31226540bc96465c601658ca98 msgid "Other" msgstr "기타" #: ../../header.rst:-1 43d585d8a38b489ca647a0f6d7ee01dd msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 6af6f9115aea4bcba5a905e65f50def7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 d0fa97b60e13424eb62997400c445a63 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../index.rst:20 3275915a8da84e58bd47e046c54375d2 msgid "Welcome to |PyMuPDF|" msgstr "|PyMuPDF| 에 오신 것을 환영합니다" #: ../../index.rst:22 443397ce6ddd47f5b1d2c0008cd4b639 msgid "" "|PyMuPDF| is a high-performance **Python** library for data extraction, " "analysis, conversion & manipulation of |PDF| (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작 기능을 제공하는 고성능 **Python** 라이브러리입니다." #: ../../index.rst:24 b09454f69e4247b09e28b65c7744f34a msgid "" "|PyMuPDF| is hosted on `GitHub `_ and" " registered on `PyPI `_." msgstr "|PyMuPDF| 는 `GitHub `_ 에 호스팅되고 `PyPI `_ 에 등록되어 있습니다." #: ../../footer.rst:46 ../../index.rst:35 9c0239a10d754ddea28f6b0d7597c26f #: d10c71ec0c454e0899fc16f6f34f2a83 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/installation.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 96029ef0e2b04d549d1dd8636b516591 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 2e20adf971da4adf8ade567b89099694 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 e225975277fd4141bab6dfb2babcab67 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../installation.rst:6 ../../installation.rst:31 #: 0e5b938092394f76bb79bd60b8b7bcc8 362130f7ee184277a844a2094e73b166 msgid "Installation" msgstr "설치" #: ../../installation.rst:9 5756ccf1a8cf47d489d528757b4ff1ed msgid "Requirements" msgstr "요구사항" #: ../../installation.rst:11 59418d8369d141eb9ff64af78a5cd0d1 msgid "" "All the examples below assume that you are running inside a Python " "virtual environment. See: https://docs.python.org/3/library/venv.html for" " details. We also assume that `pip` is up to date." msgstr "아래의 모든 예제는 Python 가상 환경 내에서 실행 중이라고 가정합니다. 자세한 내용은 https://docs.python.org/3/library/venv.html 을 참조하세요. 또한 `pip` 가 최신 버전이라고 가정합니다." #: ../../installation.rst:15 c0c567ab87e545dcb02f98a499237cac msgid "For example:" msgstr "예를 들어:" #: ../../installation.rst:17 3566b454695c4d74836795503dc32f88 msgid "Windows::" msgstr "Windows::" #: ../../installation.rst:23 30d9561c3bbd45f79998c3672a481495 msgid "Linux, MacOS::" msgstr "Linux, MacOS::" #: ../../installation.rst:33 a214d3639973479385b1f7fb97f49eb2 msgid "|PyMuPDF| should be installed using pip with::" msgstr "|PyMuPDF| 는 다음 명령으로 pip를 사용하여 설치해야 합니다::" #: ../../installation.rst:37 ea5698bf08544d95ab4dfd879681ba77 msgid "" "This will install from a Python wheel if one is available for your " "platform." msgstr "플랫폼에 사용 가능한 Python wheel이 있으면 이를 사용하여 설치됩니다." #: ../../installation.rst:41 41710c287f054c699809c8bb0c6be619 msgid "Installation when a suitable wheel is not available" msgstr "적합한 wheel 파일을 사용할 수 없는 경우의 설치" #: ../../installation.rst:43 edcf8eac64af49bb9cbe25cbe7de7c5a msgid "" "If a suitable Python wheel is not available, pip will automatically build" " from source using a Python sdist." msgstr "적합한 Python wheel 파일을 사용할 수 없는 경우, pip는 Python sdist를 사용하여 소스에서 자동으로 빌드합니다." #: ../../installation.rst:46 10c33b59ba9e4c868ae010f2a7028814 msgid "**This requires C/C++ development tools to be installed**:" msgstr "**이를 위해서는 C/C++ 개발 도구가 설치되어 있어야 합니다**:" #: ../../installation.rst:48 5ad6beabf5d6474dab9c471133784cb8 msgid "On Windows:" msgstr "Windows에서:" #: ../../installation.rst:51 c850480032484111ad409c8a6d7cc794 msgid "" "Install Visual Studio 2019. If not installed in a standard location, set " "environmental variable `PYMUPDF_SETUP_DEVENV` to the location of the " "`devenv.com` binary." msgstr "Visual Studio 2019를 설치하세요. 표준 위치에 설치되지 않은 경우, 환경 변수 `PYMUPDF_SETUP_DEVENV` 를 `devenv.com` 바이너리의 위치로 설정하세요." #: ../../installation.rst:56 65947958187d45018d139034858bc083 msgid "" "Having other installed versions of Visual Studio, for example Visual " "Studio 2022, can cause problems because one can end up with MuPDF and " "PyMuPDF code being compiled with different compiler versions." msgstr "Visual Studio 2022와 같은 다른 버전의 Visual Studio가 설치되어 있으면, MuPDF와 PyMuPDF 코드가 서로 다른 컴파일러 버전으로 컴파일될 수 있어 문제가 발생할 수 있습니다." #: ../../installation.rst:60 9e448ffec0c64a40968de3839f6b2855 msgid "The build will automatically download and build MuPDF." msgstr "빌드는 자동으로 MuPDF를 다운로드하고 빌드합니다." #: ../../installation.rst:66 9ea3e134885d4f05a4c3e2a4f5bc1095 msgid "Problems after installation" msgstr "설치 후 문제" #: ../../installation.rst:68 ../../installation.rst:117 #: 0d4df66268c544a69e1dba24527b39dc da5b4f00d11844939c6ba2c50436cde5 msgid "On Windows, Python error::" msgstr "Windows에서 Python 오류::" #: ../../installation.rst:72 05623aa04f7948f1928a5424140c8d9d msgid "" "This has been occasionally seen if `MSVCP140.dll` is missing, and appears" " to be caused by a bug in some versions (2015-2017) of `Microsoft Visual " "C++ Redistributables`." msgstr "`MSVCP140.dll` 이 누락된 경우 가끔 발생하며, 일부 버전(2015-2017)의 `Microsoft Visual C++ 재배포 가능 패키지` 의 버그로 인한 것으로 보입니다." #: ../../installation.rst:76 9472b21821c84665a04e27961520861f msgid "" "It is recommended to search for `MSVCP140.dll` in https://msdn.com to " "find instructions for how to reinstall it. For example " "https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist has " "permalinks to the latest supported versions." msgstr "https://msdn.com 에서 `MSVCP140.dll` 을 검색하여 재설치 방법을 찾는 것이 좋습니다. 예를 들어 https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist 에는 지원되는 최신 버전에 대한 영구 링크가 있습니다." #: ../../installation.rst:81 3007dd23091741939a53721b7d628b74 msgid "See https://github.com/pymupdf/PyMuPDF/issues/2678 for more details." msgstr "자세한 내용은 https://github.com/pymupdf/PyMuPDF/issues/2678 을 참조하세요." #: ../../installation.rst:84 c9a39b500d3d45a1b18d1c3f00c2982e msgid "Python error::" msgstr "Python 오류::" #: ../../installation.rst:88 53589cbbfa6944378c7034ed948fa3b4 msgid "" "This can happen if PyMuPDF's legacy name `fitz` is used (for example " "`import fitz` instead of `import pymupdf`), and an unrelated Python " "package called `fitz` (https://pypi.org/project/fitz/) is installed." msgstr "PyMuPDF의 레거시 이름 `fitz` 를 사용하는 경우(예: `import pymupdf` 대신 `import fitz`) 및 관련 없는 Python 패키지 `fitz` (https://pypi.org/project/fitz/)가 설치된 경우 발생할 수 있습니다." #: ../../installation.rst:92 f32677d324ec471f8b25f4becffc62f5 msgid "" "The fitz package appears to be no longer maintained (the latest release " "is from 2017), but unfortunately it does not seem possible to remove it " "from pypi.org. It does not even work on its own, as well as breaking the " "use of PyMuPDF's legacy name." msgstr "fitz 패키지는 더 이상 유지 관리되지 않는 것으로 보입니다(최신 릴리스는 2017년). 불행히도 pypi.org에서 제거하는 것은 불가능해 보입니다. 자체적으로도 작동하지 않으며 PyMuPDF의 레거시 이름 사용도 방해합니다." #: ../../installation.rst:97 31c58415e64d4285b88f8e33a6d97802 msgid "There are a few ways to avoid this problem:" msgstr "이 문제를 피하는 몇 가지 방법이 있습니다:" #: ../../installation.rst:100 3f88b66501a544699823982b2254031f msgid "" "Use `import pymupdf` instead of `import fitz`, and update one's code to " "match." msgstr "`import fitz` 대신 `import pymupdf` 를 사용하고 코드를 업데이트하세요." #: ../../installation.rst:103 eb2fe6e966f44853b6678fc67361a0c0 msgid "Or uninstall the `fitz` package and reinstall PyMuPDF::" msgstr "또는 `fitz` 패키지를 제거하고 PyMuPDF를 재설치하세요::" #: ../../installation.rst:108 f733312e30d5442d8681d28dfc2e0418 msgid "Or use `import pymupdf as fitz`. However this has not been well tested." msgstr "또는 `import pymupdf as fitz` 를 사용하세요. 다만 이 방법은 충분히 테스트되지 않았습니다." #: ../../installation.rst:110 d2942ed579c547888ca1290602ed28cc msgid "With Jupyter labs on Apple Silicon (arm64), Python error::" msgstr "Apple Silicon(arm64)의 Jupyter labs에서 Python 오류::" #: ../../installation.rst:114 3dedae1d6af9447eb2192ed96052aa90 msgid "" "This appears to be a problem in Jupyter labs; see: " "https://github.com/pymupdf/PyMuPDF/issues/3643#issuecomment-2210588778." msgstr "이는 Jupyter labs의 문제로 보입니다. 자세한 내용은 https://github.com/pymupdf/PyMuPDF/issues/3643#issuecomment-2210588778 을 참조하세요." #: ../../installation.rst:121 7bd3b3ebec5f4f07900684f56429ad36 msgid "" "This was reported 2025-03-26 in " "https://github.com/pymupdf/PyMuPDF/issues/4405." msgstr "이 문제는 2025-03-26에 https://github.com/pymupdf/PyMuPDF/issues/4405 에서 보고되었습니다." #: ../../installation.rst:123 b6139c99d78e45a6a9105ecc8404f710 msgid "The fix appears to be to install the latest `VC_redist.x64.exe`." msgstr "해결 방법은 최신 `VC_redist.x64.exe` 를 설치하는 것으로 보입니다." #: ../../installation.rst:127 bccf958282944bd4ac99d1ccf70707d4 msgid "Notes" msgstr "참고사항" #: ../../installation.rst:130 61583f96dcfd4261a2c77d364470a2ac msgid "Wheels are available for the following platforms:" msgstr "다음 플랫폼에 대해 wheel 파일을 사용할 수 있습니다:" #: ../../installation.rst:132 182364ca9ac94666825e7076e6d26a82 msgid "Windows 32-bit Intel." msgstr "Windows 32비트 Intel." #: ../../installation.rst:133 005535b4e858480eb22fb9ed70cd49fe msgid "Windows 64-bit Intel." msgstr "Windows 64비트 Intel." #: ../../installation.rst:134 7687fad16e9e41379221c5187c01a9f6 msgid "Linux 64-bit Intel." msgstr "Linux 64비트 Intel." #: ../../installation.rst:135 e8bae64d60a44c078ddab450469e771d msgid "Linux 64-bit ARM." msgstr "Linux 64비트 ARM." #: ../../installation.rst:136 2064ef5679e64d3db0b45c1dfbdff952 msgid "MacOS 64-bit Intel." msgstr "MacOS 64비트 Intel." #: ../../installation.rst:137 2190d152d5d0476b86a7e483d9bf4e00 msgid "MacOS 64-bit ARM." msgstr "MacOS 64비트 ARM." #: ../../installation.rst:139 5ba4832bb0ca40c3a6f960f5b5665e84 msgid "Details:" msgstr "세부사항:" #: ../../installation.rst:141 41c9bfb953b447c484a012628de54f36 msgid "We release a single wheel for each of the above platforms." msgstr "위 플랫폼 각각에 대해 단일 wheel 파일을 릴리스합니다." #: ../../installation.rst:144 8cf71ef8029a4d07ada650d699bfd1fc msgid "" "Each wheel uses the Python Stable ABI of the current oldest supported " "Python version (currently 3.10), and so works with all later Python " "versions, including new Python releases." msgstr "각 wheel은 현재 지원되는 가장 오래된 Python 버전(현재 3.10)의 Python Stable ABI를 사용하므로, 새로운 Python 릴리스를 포함한 모든 이후 Python 버전에서 작동합니다." #: ../../installation.rst:149 85f0cb2340464eacb0b93de71ce3a42b msgid "" "Wheels are tested on all Python versions currently marked as " "\"Supported\" on https://devguide.python.org/versions/, currently " "|python_versions|." msgstr "Wheel은 https://devguide.python.org/versions/ 에서 현재 \"지원됨\"으로 표시된 모든 Python 버전에서 테스트되며, 현재 |python_versions| 입니다." #: ../../installation.rst:153 b10deebc967f4ab8bdb0f24ad98ed832 msgid "" "Wheels are not available for Python installed with `Chocolatey " "`_ on Windows. Instead install Python using the " "Windows installer from the python.org website, see: " "http://www.python.org/downloads" msgstr "Windows에서 `Chocolatey `_ 로 설치한 Python에는 wheel 파일을 사용할 수 없습니다. 대신 python.org 웹사이트의 Windows 설치 프로그램을 사용하여 Python을 설치하세요. 자세한 내용은 http://www.python.org/downloads 를 참조하세요." #: ../../installation.rst:159 624bcf09993d4be0ae0f8a75b8353859 msgid "" "Wheels are not available for Linux-aarch64 with `Musl libc " "`_ (For example `Alpine Linux " "`_ on aarch64), and building from source is " "known to fail." msgstr "`Musl libc `_ 를 사용하는 Linux-aarch64(예: aarch64의 `Alpine Linux `_)에는 wheel 파일을 사용할 수 없으며, 소스에서 빌드하는 것은 실패하는 것으로 알려져 있습니다." #: ../../installation.rst:164 efeb850ab27c435e9bdc7b4bfcce4292 msgid "" "There are no **mandatory** external dependencies. However, some optional " "feature are available only if additional components are installed:" msgstr "**필수** 외부 종속성은 없습니다. 다만 일부 선택적 기능은 추가 구성 요소가 설치된 경우에만 사용할 수 있습니다:" #: ../../installation.rst:166 112f6dc0117840bb96de1ccb40383a6e msgid "" "`Pillow `_ is required for " ":meth:`Pixmap.pil_save` and :meth:`Pixmap.pil_tobytes`." msgstr "`Pillow `_ 는 :meth:`Pixmap.pil_save` 및 :meth:`Pixmap.pil_tobytes` 에 필요합니다." #: ../../installation.rst:167 1ee77df6b8b94e6798a002846af1766e msgid "" "`fontTools `_ is required for " ":meth:`Document.subset_fonts`." msgstr "`fontTools `_ 는 :meth:`Document.subset_fonts` 에 필요합니다." #: ../../installation.rst:168 28cbd6c15f344131b911099e680559b0 msgid "" "`pymupdf-fonts `_ is a " "collection of nice fonts to be used for text output methods." msgstr "`pymupdf-fonts `_ 는 텍스트 출력 방법에 사용할 수 있는 좋은 글꼴 모음입니다." #: ../../installation.rst:170 4e52c3cf248c4abcb79594a420fd423f msgid "" "`Tesseract-OCR `_ for optical" " character recognition in images and document pages. Tesseract is " "separate software, not a Python package. To enable OCR functions in " "PyMuPDF, Tesseract must be installed and the `tessdata` folder name " "specified; see below." msgstr "이미지 및 문서 페이지의 광학 문자 인식을 위한 `Tesseract-OCR `_ 입니다. Tesseract는 별도의 소프트웨어이며 Python 패키지가 아닙니다. PyMuPDF에서 OCR 기능을 사용하려면 Tesseract를 설치하고 `tessdata` 폴더 이름을 지정해야 합니다. 아래를 참조하세요." #: ../../installation.rst:176 c26a998174ff490b98bd7883858b8b37 msgid "" "You can install these additional components at any time -- before or " "after installing PyMuPDF. PyMuPDF will detect their presence during " "import or when the respective functions are being used." msgstr "이러한 추가 구성 요소는 언제든지 설치할 수 있습니다 -- PyMuPDF 설치 전후 모두 가능합니다. PyMuPDF는 가져오기 중 또는 해당 함수가 사용될 때 이들의 존재를 감지합니다." #: ../../installation.rst:180 06f197dc89334f00b8fde2aa343e6a2f msgid "Build and install from a local PyMuPDF source tree" msgstr "로컬 PyMuPDF 소스 트리에서 빌드 및 설치" #: ../../installation.rst:182 a5b05e1ca807403ba4f04f8b040f4089 msgid "Initial setup:" msgstr "초기 설정:" #: ../../installation.rst:184 6544cbacb1694401940667fbf45ebbe0 msgid "Install C/C++ development tools as described above." msgstr "위에 설명된 대로 C/C++ 개발 도구를 설치하세요." #: ../../installation.rst:185 0645317ab66746168a76c49a26e93d39 msgid "Enter a Python venv and update pip, as described above." msgstr "위에 설명된 대로 Python venv에 들어가서 pip를 업데이트하세요." #: ../../installation.rst:187 82271eef944e4faf817e14c489cd2c16 msgid "Get a PyMuPDF source tree:" msgstr "PyMuPDF 소스 트리 가져오기:" #: ../../installation.rst:189 3c67a60c157048679a1dafd0e6abe5fb msgid "Clone the PyMuPDF git repository::" msgstr "PyMuPDF git 저장소 복제::" #: ../../installation.rst:194 7b0c1e0a13d44979ab25c04feb345ad1 msgid "" "Or download and extract a `.zip` or `.tar.gz` source release from " "https://github.com/pymupdf/PyMuPDF/releases." msgstr "또는 https://github.com/pymupdf/PyMuPDF/releases 에서 `.zip` 또는 `.tar.gz` 소스 릴리스를 다운로드하고 압축을 풀 수 있습니다." #: ../../installation.rst:197 9edcc8838b654d3a9e1882ee8edefa4c msgid "Then one can build PyMuPDF in two ways:" msgstr "그런 다음 PyMuPDF를 두 가지 방법으로 빌드할 수 있습니다:" #: ../../installation.rst:199 575e45b815c94f7cad04f1b45e7c3d7f msgid "Build and install PyMuPDF with default MuPDF version::" msgstr "기본 MuPDF 버전으로 PyMuPDF 빌드 및 설치::" #: ../../installation.rst:203 bb7099833f204ff3829afd0cd54324cf msgid "" "This will automatically download a specific hard-coded MuPDF source " "release, and build it into PyMuPDF." msgstr "이렇게 하면 특정 하드코딩된 MuPDF 소스 릴리스를 자동으로 다운로드하여 PyMuPDF에 빌드합니다." #: ../../installation.rst:206 86e76ec90c1c4d7a89dcb112d69ccbba msgid "Or build and install PyMuPDF using a local MuPDF source tree:" msgstr "또는 로컬 MuPDF 소스 트리를 사용하여 PyMuPDF 빌드 및 설치:" #: ../../installation.rst:208 b9853c693d1f49358428f38af93edc33 msgid "Clone the MuPDF git repository::" msgstr "MuPDF git 저장소 복제::" #: ../../installation.rst:213 854b5ebfeb9847efb51d37d0f3e4c259 msgid "" "Build PyMuPDF, specifying the location of the local MuPDF tree with the " "environmental variables `PYMUPDF_SETUP_MUPDF_BUILD`::" msgstr "환경 변수 `PYMUPDF_SETUP_MUPDF_BUILD` 를 사용하여 로컬 MuPDF 트리의 위치를 지정하여 PyMuPDF 빌드::" #: ../../installation.rst:218 24b5cda1241e4f36b5aaf31c8df91447 msgid "" "Also, one can build for different Python versions in the same PyMuPDF " "tree:" msgstr "또한 동일한 PyMuPDF 트리에서 다른 Python 버전용으로 빌드할 수 있습니다:" #: ../../installation.rst:221 fc0b1a2699064aaaa377451775502e20 msgid "" "PyMuPDF will build for the version of Python that is being used to run " "`pip`. To run `pip` with a specific Python version, use `python -m pip` " "instead of `pip`." msgstr "PyMuPDF는 `pip` 를 실행하는 데 사용되는 Python 버전에 대해 빌드됩니다. 특정 Python 버전으로 `pip` 를 실행하려면 `pip` 대신 `python -m pip` 를 사용하세요." #: ../../installation.rst:225 dd80aa73dedb4313a237f8c77a2d783d msgid "So for example on Windows one can build different versions with::" msgstr "예를 들어 Windows에서 다음과 같이 다른 버전을 빌드할 수 있습니다::" #: ../../installation.rst:229 4fbc355486c04e7fb88bcdd8ffae7059 msgid "or::" msgstr "또는::" #: ../../installation.rst:235 207c24c76f364447839aefe03523527b msgid "Running tests" msgstr "테스트 실행" #: ../../installation.rst:237 052b595cbe1448d79c441e326e94f9d7 msgid "" "Having a PyMuPDF tree available allows one to run PyMuPDF's `pytest` test" " suite::" msgstr "PyMuPDF 트리를 사용할 수 있으면 PyMuPDF의 `pytest` 테스트 스위트를 실행할 수 있습니다::" #: ../../installation.rst:246 795e4545d04f4e04baa8a0527281f16e msgid "Notes about using a non-default MuPDF" msgstr "기본값이 아닌 MuPDF 사용에 대한 참고사항" #: ../../installation.rst:248 9a130c5a8a0946668b8885f28af8aa04 msgid "" "Using a non-default build of MuPDF by setting environmental variable " "`PYMUPDF_SETUP_MUPDF_BUILD` can cause various things to go wrong and so " "is not generally supported:" msgstr "환경 변수 `PYMUPDF_SETUP_MUPDF_BUILD` 를 설정하여 기본값이 아닌 MuPDF 빌드를 사용하면 다양한 문제가 발생할 수 있으므로 일반적으로 지원되지 않습니다:" #: ../../installation.rst:252 79b112fde2cc4475bbef94325d535a3d msgid "" "If MuPDF's major version number differs from what PyMuPDF uses by " "default, PyMuPDF can fail to build, because MuPDF's API can change " "between major versions." msgstr "MuPDF의 주 버전 번호가 PyMuPDF가 기본적으로 사용하는 것과 다르면, MuPDF의 API가 주 버전 간에 변경될 수 있으므로 PyMuPDF 빌드가 실패할 수 있습니다." #: ../../installation.rst:256 26963aaabb354a0fb893981e3cd6b8d0 msgid "" "Runtime behaviour of PyMuPDF can change because MuPDF's runtime behaviour" " changes between different minor releases. This can also break some " "PyMuPDF tests." msgstr "PyMuPDF의 런타임 동작은 MuPDF의 런타임 동작이 다른 부 버전 간에 변경되기 때문에 변경될 수 있습니다. 이로 인해 일부 PyMuPDF 테스트가 실패할 수도 있습니다." #: ../../installation.rst:260 cf6ea4f83bfa409381276082a6a8bdf9 msgid "" "If MuPDF was built with its default config instead of PyMuPDF's " "customised config (for example if MuPDF is a system install), it is " "possible that `tests/test_textbox.py:test_textbox3()` will fail. One can " "skip this particular test by adding `-k 'not test_textbox3'` to the " "`pytest` command line." msgstr "MuPDF가 PyMuPDF의 사용자 정의 구성 대신 기본 구성을 사용하여 빌드된 경우(예: MuPDF가 시스템 설치인 경우), `tests/test_textbox.py:test_textbox3()` 가 실패할 수 있습니다. `pytest` 명령줄에 `-k 'not test_textbox3'` 를 추가하여 이 특정 테스트를 건너뛸 수 있습니다." #: ../../installation.rst:268 700f4d8e58e84935b6c6975860df3b8f msgid "Official PyMuPDF Linux wheels may not install on older Linux systems" msgstr "공식 PyMuPDF Linux wheel 파일이 오래된 Linux 시스템에 설치되지 않을 수 있음" #: ../../installation.rst:270 b47547ab827c4869a01099c6505cf69a msgid "Releases of PyMuPDF are incompatible with older Linux systems." msgstr "PyMuPDF 릴리스는 오래된 Linux 시스템과 호환되지 않습니다." #: ../../installation.rst:272 808eb6388cc546d782e08fad72571c1d msgid "" "For example as of 2025-09-03, `pip install pymupdf` does not work on some" " AWS Lambda systems - see " "https://github.com/pymupdf/PyMuPDF/discussions/4631." msgstr "예를 들어 2025-09-03 기준으로, 일부 AWS Lambda 시스템에서는 `pip install pymupdf` 가 작동하지 않습니다. 자세한 내용은 https://github.com/pymupdf/PyMuPDF/discussions/4631 을 참조하세요." #: ../../installation.rst:275 debea54d4d7a43c2878628b326c0c3f0 msgid "" "This is because official PyMuPDF Linux wheels are built with a version of" " glibc determined by the current Python manylinux environment. These " "wheels are incompatible with Linux systems that have an older glibc." msgstr "이는 공식 PyMuPDF Linux wheel 파일이 현재 Python manylinux 환경에 의해 결정된 glibc 버전으로 빌드되기 때문입니다. 이러한 wheel 파일은 오래된 glibc를 가진 Linux 시스템과 호환되지 않습니다." #: ../../installation.rst:279 bf75483c6b084df08b1cc5bd8206d1bf msgid "" "The official Python manylinux environment is updated periodically to use " "newer glibc versions, so new releases of PyMuPDF become increasingly " "incompatible with older Linux systems." msgstr "공식 Python manylinux 환경은 최신 glibc 버전을 사용하도록 주기적으로 업데이트되므로, PyMuPDF의 새 릴리스는 오래된 Linux 시스템과 점점 더 호환되지 않게 됩니다." #: ../../installation.rst:283 91117ed642e046819ecc665f9b6c9b50 msgid "" "There is nothing that can be done about this, other than updating older " "Linux systems, or building PyMuPDF locally from source." msgstr "오래된 Linux 시스템을 업데이트하거나 소스에서 로컬로 PyMuPDF를 빌드하는 것 외에는 이에 대해 할 수 있는 일이 없습니다." #: ../../installation.rst:286 e7b222da2a044c2fa1eedf9c819d97ca msgid "" "For more details, please see: `Python Packaging Authority " "`_." msgstr "자세한 내용은 `Python Packaging Authority `_ 를 참조하세요." #: ../../installation.rst:290 4adbb8931dfd4590a44a57ffb3936e97 msgid "Packaging" msgstr "패키징" #: ../../installation.rst:292 53c33343b4c24290ad643762f5bbb050 msgid "See :doc:`packaging`." msgstr ":doc:`packaging` 을 참조하세요." #: ../../installation.rst:296 477e709115dd4d119aea37fb3a68a54b msgid "Using with Pyodide" msgstr "Pyodide와 함께 사용" #: ../../installation.rst:298 28b8424d39f448fd863709fd16271d9a msgid "See :doc:`pyodide`." msgstr ":doc:`pyodide` 를 참조하세요." #: ../../installation.rst:304 05d1ad76d8ff49d8b8be1c318e026ccb msgid "Enabling Integrated OCR Support" msgstr "통합 OCR 지원 활성화" #: ../../installation.rst:306 1088128a9ea343a09d2433086fcee140 msgid "" "If you do not intend to use this feature, skip this step. Otherwise, it " "is required for both installation paths: **from wheels and from " "sources.**" msgstr "이 기능을 사용하지 않으려면 이 단계를 건너뛰세요. 그렇지 않으면 두 설치 경로 모두에 필요합니다: **wheel 파일에서 및 소스에서.**" #: ../../installation.rst:308 18290d46b0854568b242288afd51a0da msgid "" "PyMuPDF will already contain all the logic to support OCR functions. But " "it additionally does need `Tesseract’s language support data " "`_." msgstr "PyMuPDF에는 이미 OCR 기능을 지원하는 모든 로직이 포함되어 있습니다. 하지만 추가로 `Tesseract의 언어 지원 데이터 `_ 가 필요합니다." #: ../../installation.rst:310 0cbfeba7ee2e4382baa33ea4562e36c3 msgid "" "If not specified explicitly, PyMuPDF will attempt to find the installed " "Tesseract's tessdata, but this should probably not be relied upon." msgstr "명시적으로 지정하지 않으면 PyMuPDF는 설치된 Tesseract의 tessdata를 찾으려고 시도하지만, 이에 의존하지 않는 것이 좋습니다." #: ../../installation.rst:313 340c284211c64d04a0a7705bbaed97a1 msgid "" "Otherwise PyMuPDF requires that Tesseract's language support folder is " "specified explicitly either in PyMuPDF OCR functions' `tessdata` " "arguments or `os.environ[\"TESSDATA_PREFIX\"]`." msgstr "그렇지 않으면 PyMuPDF는 Tesseract의 언어 지원 폴더가 PyMuPDF OCR 함수의 `tessdata` 인수 또는 `os.environ[\"TESSDATA_PREFIX\"]` 에 명시적으로 지정되어야 합니다." #: ../../installation.rst:317 4050e5d26f8d4fcebd4429bf4468f2c1 msgid "So for a working OCR functionality, make sure to complete this checklist:" msgstr "따라서 OCR 기능이 작동하려면 다음 체크리스트를 완료해야 합니다:" #: ../../installation.rst:319 ae04b692262d427da4c557773bbb6331 msgid "" "Locate Tesseract's language support folder. Typically you will find it " "here:" msgstr "Tesseract의 언어 지원 폴더를 찾으세요. 일반적으로 다음 위치에 있습니다:" #: ../../installation.rst:321 518b279edc7f426199e22b43bb47488e msgid "Windows: `C:/Program Files/Tesseract-OCR/tessdata`" msgstr "Windows: `C:/Program Files/Tesseract-OCR/tessdata`" #: ../../installation.rst:322 2829c0e448b44e639344346371835824 msgid "Unix systems: `/usr/share/tesseract-ocr/4.00/tessdata`" msgstr "Unix 시스템: `/usr/share/tesseract-ocr/4.00/tessdata`" #: ../../installation.rst:324 d8669511863246a096ce609ebddc096b msgid "Specify the language support folder when calling PyMuPDF OCR functions:" msgstr "PyMuPDF OCR 함수를 호출할 때 언어 지원 폴더를 지정하세요:" #: ../../installation.rst:326 2defdb35431444ab8cb2a6832cb3cc88 msgid "Set the `tessdata` argument." msgstr "`tessdata` 인수를 설정하세요." #: ../../installation.rst:327 eda39b64a6ca464d8c23f1eeec197a8f msgid "Or set `os.environ[\"TESSDATA_PREFIX\"]` from within Python." msgstr "또는 Python 내에서 `os.environ[\"TESSDATA_PREFIX\"]` 를 설정하세요." #: ../../installation.rst:328 d711c5765afc4c0cafadc80892c613e9 msgid "" "Or set environment variable `TESSDATA_PREFIX` before running Python, for " "example:" msgstr "또는 Python을 실행하기 전에 환경 변수 `TESSDATA_PREFIX` 를 설정하세요. 예:" #: ../../installation.rst:330 adb02ed301f749c0b70fa768f6279980 msgid "" "Windows: `setx TESSDATA_PREFIX \"C:/Program Files/Tesseract-" "OCR/tessdata\"`" msgstr "Windows: `setx TESSDATA_PREFIX \"C:/Program Files/Tesseract-OCR/tessdata\"`" #: ../../installation.rst:331 a7d44e96bab64a1492085fe6649aa5ba msgid "" "Unix systems: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-" "ocr/4.00/tessdata`" msgstr "Unix 시스템: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-ocr/4.00/tessdata`" #: ../../installation.rst:336 a123b1fc6a474985b09b2e4de3759541 msgid "" "Find out more on the `official documentation for installing Tesseract " "website `_." msgstr "" #: ../../footer.rst:48 04ec8ea4e7e743ab9f77de31a752358a msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/irect.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 fba66bf65f8244c99a76005b4aa13c77 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 c942dc1ee97843a1823121e8c22c5942 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8e36a463460e419f9787f96dfe806717 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../irect.rst:7 5159d7062cad401c98bbfc419330c03c msgid "IRect" msgstr "IRect" #: ../../irect.rst:9 da2f82891e674e9a99975f0e1c77534a msgid "" "IRect is a rectangular bounding box, very similar to :ref:`Rect`, except " "that all corner coordinates are integers. IRect is used to specify an " "area of pixels, e.g. to receive image data during rendering. Otherwise, " "e.g. considerations concerning emptiness and validity of rectangles also " "apply to this class. Methods and attributes have the same names, and in " "many cases are implemented by re-using the respective :ref:`Rect` " "counterparts." msgstr "IRect는 :ref:`Rect` 와 매우 유사한 사각형 경계 상자입니다. 단, 모든 모서리 좌표가 정수라는 점이 다릅니다. IRect는 픽셀 영역을 지정하는 데 사용됩니다(예: 렌더링 중 이미지 데이터를 받기 위해). 그 외에도 사각형의 빈 상태 및 유효성에 대한 고려 사항도 이 클래스에 적용됩니다. 메서드와 속성은 동일한 이름을 가지며, 많은 경우 해당 :ref:`Rect` 대응 항목을 재사용하여 구현됩니다." #: ../../irect.rst:12 a2319632991b4392b7ea2363ed3ce3ca msgid "**Attribute / Method**" msgstr "**속성 / 메서드**" #: ../../irect.rst:12 985bc4b51a2844cc8c87af7ba3568037 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../irect.rst:14 312b0f5bcbbd40a2bd8e8e1e19229048 msgid ":meth:`IRect.contains`" msgstr ":meth:`IRect.contains`" #: ../../irect.rst:14 1ccbbb3d38b14035b18375fea8176585 msgid "checks containment of another object" msgstr "다른 객체의 포함 여부 확인" #: ../../irect.rst:15 48378afa42394efc9fdbf9eb14494570 msgid ":meth:`IRect.get_area`" msgstr ":meth:`IRect.get_area`" #: ../../irect.rst:15 7c5d16bc4f66409496a2544313c511e1 msgid "calculate rectangle area" msgstr "사각형 영역 계산" #: ../../irect.rst:16 f0ccc3542ac74ea990d056a328e04a38 msgid ":meth:`IRect.intersect`" msgstr ":meth:`IRect.intersect`" #: ../../irect.rst:16 1dc1ecaee3494262a0fe5f21fa1f14d9 msgid "common part with another rectangle" msgstr "다른 사각형과의 공통 부분" #: ../../irect.rst:17 dcc6834c254f4196bae3b0d0fab4ceb1 msgid ":meth:`IRect.intersects`" msgstr ":meth:`IRect.intersects`" #: ../../irect.rst:17 4fa770702f6f48ddab2468a3aa6c9af1 msgid "checks for non-empty intersection" msgstr "비어 있지 않은 교집합 확인" #: ../../irect.rst:18 1475b0caba85400c836e2e24795f6c17 msgid ":meth:`IRect.morph`" msgstr ":meth:`IRect.morph`" #: ../../irect.rst:18 185917170ebf4403aecdb06acfbbdb30 msgid "transform with a point and a matrix" msgstr "점과 행렬로 변환" #: ../../irect.rst:19 f89cd99364a04f8ead7c40c76d334821 msgid ":meth:`IRect.torect`" msgstr ":meth:`IRect.torect`" #: ../../irect.rst:19 b73013e1bd9c44e28fb742260bdf0272 msgid "matrix that transforms to another rectangle" msgstr "다른 사각형으로 변환하는 행렬" #: ../../irect.rst:20 15c7541278e84bb8ab6442f22f75170c msgid ":meth:`IRect.norm`" msgstr ":meth:`IRect.norm`" #: ../../irect.rst:20 5344860eef7b4ebca725b7087c5ba8b1 msgid "the Euclidean norm" msgstr "유클리드 노름" #: ../../irect.rst:21 b4daf225e3034e7f9a2a7efdb849941e msgid ":meth:`IRect.normalize`" msgstr ":meth:`IRect.normalize`" #: ../../irect.rst:21 da5ac901945f432e951f9ccfbde9a1e3 msgid "makes a rectangle finite" msgstr "사각형을 유한하게 만듦" #: ../../irect.rst:22 b57e345172924c9f92f87bdeee2b8b3b msgid ":attr:`IRect.bottom_left`" msgstr ":attr:`IRect.bottom_left`" #: ../../irect.rst:22 8de2dbecf83540c2845f6fea2e7ecc7b msgid "bottom left point, synonym *bl*" msgstr "왼쪽 아래 점, 동의어 *bl*" #: ../../irect.rst:23 78ac63f7fbd94c12a1bb2853a704964d msgid ":attr:`IRect.bottom_right`" msgstr ":attr:`IRect.bottom_right`" #: ../../irect.rst:23 694a01dd73e044ebb482e19a2d477c0f msgid "bottom right point, synonym *br*" msgstr "오른쪽 아래 점, 동의어 *br*" #: ../../irect.rst:24 c996baab80024480b6fa888ba3dae48d msgid ":attr:`IRect.height`" msgstr ":attr:`IRect.height`" #: ../../irect.rst:24 5cfaf1765add470395b5f7e3f9f3af09 msgid "height of the rectangle" msgstr "사각형의 높이" #: ../../irect.rst:25 1b7c56522528489b89e2c3863d10335b msgid ":attr:`IRect.is_empty`" msgstr ":attr:`IRect.is_empty`" #: ../../irect.rst:25 0f3aefc4a2e247f4909ac53517ac039c msgid "whether rectangle is empty" msgstr "사각형이 비어 있는지 여부" #: ../../irect.rst:26 ebba20f4de03492090a9968e1e5dd412 msgid ":attr:`IRect.is_infinite`" msgstr ":attr:`IRect.is_infinite`" #: ../../irect.rst:26 9c334c81b9b8415ba1053a2528ecb6ff msgid "whether rectangle is infinite" msgstr "사각형이 무한한지 여부" #: ../../irect.rst:27 5001534eb64f471d85cc5b89d7d974a1 msgid ":attr:`IRect.rect`" msgstr ":attr:`IRect.rect`" #: ../../irect.rst:27 4b920cbbb5bd436ea5424583f46a971f msgid "the :ref:`Rect` equivalent" msgstr ":ref:`Rect` 와 동등한 것" #: ../../irect.rst:28 73d2bc3e97c64f5facee96dfcf12b95c msgid ":attr:`IRect.top_left`" msgstr ":attr:`IRect.top_left`" #: ../../irect.rst:28 5806b5f7f43040419aec40fe1ec99f9b msgid "top left point, synonym *tl*" msgstr "왼쪽 위 점, 동의어 *tl*" #: ../../irect.rst:29 856082fe624c4dd4b8eeb24285c1a347 msgid ":attr:`IRect.top_right`" msgstr ":attr:`IRect.top_right`" #: ../../irect.rst:29 0b985550b8ed4625a72796ab4c754952 msgid "top_right point, synonym *tr*" msgstr "오른쪽 위 점, 동의어 *tr*" #: ../../irect.rst:30 5cc9d50c8cec4d768741a74eca8abf0b msgid ":attr:`IRect.quad`" msgstr ":attr:`IRect.quad`" #: ../../irect.rst:30 d135c468e28048fc921fdfdf4bbb13cf msgid ":ref:`Quad` made from rectangle corners" msgstr "사각형 모서리로 만든 :ref:`Quad`" #: ../../irect.rst:31 022996f05c34445fa253e0e774b365a3 msgid ":attr:`IRect.width`" msgstr ":attr:`IRect.width`" #: ../../irect.rst:31 0b36bdc4d3bf46afab89889318dc863a msgid "width of the rectangle" msgstr "사각형의 너비" #: ../../irect.rst:32 521608cb542c4976ba07f2f56d904ace msgid ":attr:`IRect.x0`" msgstr ":attr:`IRect.x0`" #: ../../irect.rst:32 d0964024870440a58844774693381ec8 msgid "X-coordinate of the top left corner" msgstr "왼쪽 위 모서리의 X 좌표" #: ../../irect.rst:33 548e8fbd99a442b2b5a586073ff4f2ab msgid ":attr:`IRect.x1`" msgstr ":attr:`IRect.x1`" #: ../../irect.rst:33 30a1db52025e46e0be799ff23b4f2696 msgid "X-coordinate of the bottom right corner" msgstr "오른쪽 아래 모서리의 X 좌표" #: ../../irect.rst:34 f81b38bd9fde4f54bed975e459d7a9ac msgid ":attr:`IRect.y0`" msgstr ":attr:`IRect.y0`" #: ../../irect.rst:34 2b16ddf8934849fbaab256d3d54e4363 msgid "Y-coordinate of the top left corner" msgstr "왼쪽 위 모서리의 Y 좌표" #: ../../irect.rst:35 70d84d3ce7a34c4297a1e7700d3f7109 msgid ":attr:`IRect.y1`" msgstr ":attr:`IRect.y1`" #: ../../irect.rst:35 b3e0e713d8d046a8968b780c0340f966 msgid "Y-coordinate of the bottom right corner" msgstr "오른쪽 아래 모서리의 Y 좌표" #: ../../irect.rst:38 2edafd03825b4939bfe6472c41b08bcf msgid "**Class API**" msgstr "**클래스 API**" #: ../../irect.rst:50 70995ff946be4d8d84849a0c0b6f16d3 msgid "" "Overloaded constructors. Also see examples below and those for the " ":ref:`Rect` class." msgstr "오버로드된 생성자. 아래 예제와 :ref:`Rect` 클래스의 예제도 참조하세요." #: ../../irect.rst:52 8f664a86d7374ec9bda83e6905b4e67b msgid "If another irect is specified, a **new copy** will be made." msgstr "다른 irect가 지정되면 **새 복사본** 이 만들어집니다." #: ../../irect.rst:54 6e6e21909c9c4ae3a9139bde73277f88 msgid "" "If sequence is specified, it must be a Python sequence type of 4 numbers " "(see :ref:`SequenceTypes`). Non-integer numbers will be truncated, non-" "numeric values will raise an exception." msgstr "sequence가 지정되면 4개의 숫자로 구성된 Python 시퀀스 유형이어야 합니다(:ref:`SequenceTypes` 참조). 정수가 아닌 숫자는 잘리고, 숫자가 아닌 값은 예외를 발생시킵니다." #: ../../irect.rst:56 f9a414d271ee415fb26b8f0b142958b7 msgid "The other parameters mean integer coordinates." msgstr "다른 매개변수는 정수 좌표를 의미합니다." #: ../../irect.rst:61 7c84bdc985c64c339d0548802f831996 msgid "" "Calculates the area of the rectangle and, with no parameter, equals " "*abs(IRect)*. Like an empty rectangle, the area of an infinite rectangle " "is also zero." msgstr "사각형의 영역을 계산하며, 매개변수 없이는 *abs(IRect)* 와 같습니다. 빈 사각형과 마찬가지로 무한 사각형의 영역도 0입니다." #: ../../irect.rst 18e4b1fb1da640de88306538351ca10b #: 218364ce30ff4c0a9be4541c11fe1e9f 394c5a21898045d19dc3fca6edc763a7 #: 489a707b54a24c2eb3edb81f8229ef4f 5b5047f52c7a458c90e239164e797307 #: 6408eafe7a4547e980f6763bd4b559e1 msgid "Parameters" msgstr "매개변수" #: ../../irect.rst:63 63bea0a8781c48c49fac02eaeda867ce msgid "" "Specify required unit: respective squares of \"px\" (pixels, default), " "\"in\" (inches), \"cm\" (centimeters), or \"mm\" (millimeters)." msgstr "필요한 단위 지정: \"px\"(픽셀, 기본값), \"in\"(인치), \"cm\"(센티미터) 또는 \"mm\"(밀리미터)의 각각의 제곱." #: ../../irect.rst 0f9fbd309a584cab995697cae68f899d #: 7c2bab6d8e594a5589e33354d18a1796 ba5dbf6b9e214071aaec6e290fac295f #: e6ca9e94a86f416a922d607f4943a5a3 msgid "Return type" msgstr "반환 유형" #: ../../irect.rst:69 5dc2badf5382432fa2d57f3db0e32119 msgid "" "The intersection (common rectangular area) of the current rectangle and " "*ir* is calculated and replaces the current rectangle. If either " "rectangle is empty, the result is also empty. If either rectangle is " "infinite, the other one is taken as the result -- and hence also infinite" " if both rectangles were infinite." msgstr "현재 사각형과 *ir* 의 교집합(공통 사각형 영역)이 계산되어 현재 사각형을 대체합니다. 사각형 중 하나가 비어 있으면 결과도 비어 있습니다. 사각형 중 하나가 무한이면 다른 하나가 결과로 사용됩니다 -- 따라서 두 사각형이 모두 무한이면 결과도 무한입니다." #: ../../irect.rst:71 8af38038c172477b9e9af3e3b7862926 msgid "Second rectangle." msgstr "두 번째 사각형." #: ../../irect.rst:75 e7214be906944cddbd77c8aecdd86d95 msgid "" "Checks whether *x* is contained in the rectangle. It may be " ":data:`rect_like`, :data:`point_like` or a number. If *x* is an empty " "rectangle, this is always true. Conversely, if the rectangle is empty " "this is always ``False``, if *x* is not an empty rectangle and not a " "number. If *x* is a number, it will be checked to be one of the four " "components. *x in irect* and *irect.contains(x)* are equivalent." msgstr "*x* 가 사각형에 포함되어 있는지 확인합니다. 이것은 :data:`rect_like`, :data:`point_like` 또는 숫자일 수 있습니다. *x* 가 빈 사각형이면 이것은 항상 true입니다. 반대로, 사각형이 비어 있으면 이것은 항상 ``False`` 입니다. *x* 가 빈 사각형이 아니고 숫자가 아닌 경우. *x* 가 숫자이면 4개의 구성 요소 중 하나인지 확인됩니다. *x in irect* 와 *irect.contains(x)* 는 동일합니다." #: ../../irect.rst:77 7cc8752befc847a9885e54e61f00faee msgid "the object to check." msgstr "확인할 객체." #: ../../irect.rst:84 41a07fef21a04ff9b1f1c59de07d83d1 msgid "" "Checks whether the rectangle and the :data:`rect_like` \"r\" contain a " "common non-empty :ref:`IRect`. This will always be ``False`` if either is" " infinite or empty." msgstr "사각형과 :data:`rect_like` \"r\"이 공통의 비어 있지 않은 :ref:`IRect` 를 포함하는지 확인합니다. 둘 중 하나가 무한이거나 비어 있으면 이것은 항상 ``False`` 입니다." #: ../../irect.rst:86 aa8981e507b44374bd69c86ddf1f7541 msgid "the rectangle to check." msgstr "확인할 사각형." #: ../../irect.rst:92 e0237b4a333a4949bae56a33d349416d msgid "New in version 1.19.3" msgstr "버전 1.19.3에서 새로 추가됨" #: ../../irect.rst:94 a8f435e24dcb48e2bdbca8838eca5764 msgid "" "Compute the matrix which transforms this rectangle to a given one. See " ":meth:`Rect.torect`." msgstr "이 사각형을 주어진 사각형으로 변환하는 행렬을 계산합니다. :meth:`Rect.torect` 를 참조하세요." #: ../../irect.rst:96 d1c97833dc404dbf9a4af4245c9a4541 msgid "the target rectangle. Must not be empty or infinite." msgstr "대상 사각형. 비어 있거나 무한이 아니어야 합니다." #: ../../irect.rst:97 2f2d67d9571f465fa494157309add0d7 msgid ":ref:`Matrix`" msgstr ":ref:`Matrix`" #: ../../irect.rst 75c56c65e0e64566a450b019b0cac229 #: a68dd79a643440fbb2173c54bf9da905 msgid "Returns" msgstr "반환값" #: ../../irect.rst:98 c705e90002274a80b333b03348c54360 msgid "" "a matrix `mat` such that `self * mat = rect`. Can for example be used to " "transform between the page and the pixmap coordinates." msgstr "`self * mat = rect` 가 되는 행렬 `mat`. 예를 들어 페이지와 픽셀맵 좌표 간 변환에 사용할 수 있습니다." #: ../../irect.rst:103 287c04b5d7f141ccb8d6ad779ecaeb1e msgid "New in version 1.17.0" msgstr "버전 1.17.0에서 새로 추가됨" #: ../../irect.rst:105 e37ea5bfcc8d496abb5f6decf903b78d msgid "Return a new quad after applying a matrix to it using a fixed point." msgstr "고정점을 사용하여 행렬을 적용한 후 새 quad를 반환합니다." #: ../../irect.rst:107 05bbb73520154a3181137a24fec1c86f msgid "the fixed point." msgstr "고정점." #: ../../irect.rst:108 b34bf6b64a6543358399eee20fed216a msgid "the matrix." msgstr "행렬." #: ../../irect.rst:109 c69142f99a804255b75e2eaf0d41597a msgid "" "a new :ref:`Quad`. This a wrapper of the same-named quad method. If " "infinite, the infinite quad is returned." msgstr "새 :ref:`Quad`. 이것은 동일한 이름의 quad 메서드의 래퍼입니다. 무한이면 무한 quad가 반환됩니다." #: ../../irect.rst:113 1cacf407916d48f49e0c36e73c9d2795 msgid "New in version 1.16.0" msgstr "버전 1.16.0에서 새로 추가됨" #: ../../irect.rst:115 73cccdef3ba54c138d3c2949905823f1 msgid "" "Return the Euclidean norm of the rectangle treated as a vector of four " "numbers." msgstr "4개의 숫자 벡터로 처리된 사각형의 유클리드 노름을 반환합니다." #: ../../irect.rst:119 1e3b3df827f64cdaa8f3e30d20539c21 msgid "" "Make the rectangle finite. This is done by shuffling rectangle corners. " "After this, the bottom right corner will indeed be south-eastern to the " "top left one. See :ref:`Rect` for a more details." msgstr "사각형을 유한하게 만듭니다. 이것은 사각형 모서리를 재배치하여 수행됩니다. 이 작업 후, 오른쪽 아래 모서리는 실제로 왼쪽 위 모서리의 남동쪽이 됩니다. 자세한 내용은 :ref:`Rect` 를 참조하세요." #: ../../irect.rst:125 80fcd714078d4459b6446f7aa881ded8 msgid "Equals *Point(x0, y0)*." msgstr "*Point(x0, y0)* 와 같습니다." #: ../../irect.rst 1185a0d53778409b8eb3beb582b64888 #: 34743c436e9f444485fae4bae2ddb7f9 352aed9e86654ed0bfb3414c7c9f882a #: 451fc25fef3146ae8daf60b87a4dc707 49a176812ba94813ba64a196ce27e163 #: 4f24b7a2272a40bcb5f1498431a01dff 6692646f4aef49ceb6263730817ee21f #: 89ab45a59a934aa39249ed1a86f07ee5 9d4221e962164e72948ac5d4b8d2703c #: b2290785b17149418de10d614a0f8eda c787e5b509d24f1b838ac1e121cfc685 #: d95b0909ef3d4300a206cd4f2b8c8671 f6cdc81509354493aa34a01e5ebc06b4 #: f97ab05a65224ade959a073fae8e16c2 msgid "type" msgstr "유형" #: ../../irect.rst:127 ../../irect.rst:135 ../../irect.rst:143 #: ../../irect.rst:151 88e60a9d15ad4d409f7a85722cd1cb9c #: c7e32fdd1a374a44979cdc28e388d038 fb5fa1bba9ab48979d23d8dd6744ca12 #: fdc51db9a96f4153893929ddb8e95ee3 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../irect.rst:133 305506d4a8894b98b370bfdaf51af233 msgid "Equals *Point(x1, y0)*." msgstr "*Point(x1, y0)* 와 같습니다." #: ../../irect.rst:141 9af3c12519684f28bb4bc50d612e4372 msgid "Equals *Point(x0, y1)*." msgstr "*Point(x0, y1)* 와 같습니다." #: ../../irect.rst:149 ae11bdfc7226476aac26a17b08ad9204 msgid "Equals *Point(x1, y1)*." msgstr "*Point(x1, y1)* 와 같습니다." #: ../../irect.rst:155 6b6c7c24528e4d028bb599bcaba2d291 msgid "The :ref:`Rect` with the same coordinates as floats." msgstr "float와 동일한 좌표를 가진 :ref:`Rect`." #: ../../irect.rst:157 07b31a4170c647d1ae20c438ea29c332 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../irect.rst:161 6d942227a8804d80be71085d59471e1f msgid "The quadrilateral *Quad(irect.tl, irect.tr, irect.bl, irect.br)*." msgstr "사각형 *Quad(irect.tl, irect.tr, irect.bl, irect.br)*." #: ../../irect.rst:163 21c9866abaed4b9ea6806095673297f4 msgid ":ref:`Quad`" msgstr ":ref:`Quad`" #: ../../irect.rst:167 aa41fcfcf80642958f591e2014a05804 msgid "Contains the width of the bounding box. Equals *abs(x1 - x0)*." msgstr "경계 상자의 너비를 포함합니다. *abs(x1 - x0)* 와 같습니다." #: ../../irect.rst:169 ../../irect.rst:175 ../../irect.rst:181 #: ../../irect.rst:187 ../../irect.rst:193 ../../irect.rst:199 #: 36d28775650b4893b50c1bb5ecf9c14e 65120d228f2f4ab28e5fa51eb06d8761 #: a72fd244eafd454380cfe3bc5def6325 f2ef5e017dda4f76ab39cff8b6079d88 #: fa70673340164af19d538be4a10b59ad fc10d7f00d79406db00d1066e4567571 msgid "int" msgstr "int" #: ../../irect.rst:173 e896ac73b5c64e75b7724b41502abd00 msgid "Contains the height of the bounding box. Equals *abs(y1 - y0)*." msgstr "경계 상자의 높이를 포함합니다. *abs(y1 - y0)* 와 같습니다." #: ../../irect.rst:179 29e02c90a309472484e82207f4e2bb94 msgid "X-coordinate of the left corners." msgstr "왼쪽 모서리의 X 좌표." #: ../../irect.rst:185 ec2198ff697e420d9c05f93f973367bb msgid "Y-coordinate of the top corners." msgstr "위쪽 모서리의 Y 좌표." #: ../../irect.rst:191 e02641fa0cb443a58d8b6f6d447edb7a msgid "X-coordinate of the right corners." msgstr "오른쪽 모서리의 X 좌표." #: ../../irect.rst:197 2e367ece51d84b1280d4ec05cc038c6a msgid "Y-coordinate of the bottom corners." msgstr "아래쪽 모서리의 Y 좌표." #: ../../irect.rst:203 900a2545643f4623905b338b7edefd8b msgid "``True`` if rectangle is infinite, ``False`` otherwise." msgstr "사각형이 무한이면 ``True``, 그렇지 않으면 ``False``." #: ../../irect.rst:205 ../../irect.rst:211 4c1a21a29dfe4414ad6992b3dcc0b117 #: aec6fc0ebb874b20bfb1a90a68a30dcc msgid "bool" msgstr "bool" #: ../../irect.rst:209 877573fb6317435ca1b1a73c24606949 msgid "``True`` if rectangle is empty, ``False`` otherwise." msgstr "사각형이 비어 있으면 ``True``, 그렇지 않으면 ``False``." #: ../../irect.rst:216 7cc608bcd141490a9f473438421895b4 msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "이 클래스는 Python 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 액세스할 수도 있습니다. :ref:`SequenceTypes` 도 참조하세요." #: ../../irect.rst:217 a3c01f53c9ef4d5eb1b84f26294b538b msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "사각형은 산술 연산자와 함께 사용할 수 있습니다 -- :ref:`Algebra` 장을 참조하세요." #: ../../footer.rst:46 512cd6db01a142258a5b31acbcb8a187 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/link.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f61795372a914927a8bb8d2bc7871cd0 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 b6c88945ca3e433796ac09242bcafb92 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 f29d92f907804c35aff5269176052c3a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../link.rst:7 a2ac83b843064d1690148214e4e62cab msgid "Link" msgstr "Link" #: ../../link.rst:8 e3ca00a770434f0896694fc8c2dc8e8d msgid "" "Represents a pointer to somewhere (this document, other documents, the " "internet). Links exist per document page, and they are forward-chained to" " each other, starting from an initial link which is accessible by the " ":attr:`Page.first_link` property." msgstr "어딘가(이 문서, 다른 문서, 인터넷)를 가리키는 포인터를 나타냅니다. 링크는 문서 페이지마다 존재하며, :attr:`Page.first_link` 속성으로 접근할 수 있는 초기 링크에서 시작하여 서로 순방향으로 연결됩니다." #: ../../link.rst:10 55f719cc6bfa4e1dbdf8bba301fe4110 msgid "" "There is a parent-child relationship between a link and its page. If the " "page object becomes unusable (closed document, any document structure " "change, etc.), then so does every of its existing link objects -- an " "exception is raised saying that the object is \"orphaned\", whenever a " "link property or method is accessed." msgstr "링크와 해당 페이지 사이에는 부모-자식 관계가 있습니다. 페이지 객체가 사용 불가능해지면(문서 닫힘, 문서 구조 변경 등) 해당 페이지의 모든 기존 링크 객체도 사용 불가능해집니다 -- 링크 속성이나 메서드에 접근할 때마다 객체가 \"고아\" 상태라는 예외가 발생합니다." #: ../../link.rst:13 a4193e607a9145218508afeabe0b4c2e msgid "**Attribute**" msgstr "**속성**" #: ../../link.rst:13 af32ee5e21764bdab065a26b66230ad7 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../link.rst:15 9f4a2508022d463a93f91c3406c08ab1 msgid ":meth:`Link.set_border`" msgstr ":meth:`Link.set_border`" #: ../../link.rst:15 6a3d66278e124793bee041fb82bd823a msgid "modify border properties" msgstr "테두리 속성 수정" #: ../../link.rst:16 ca6e0ec1d2e5409894887ce466dd9c14 msgid ":meth:`Link.set_colors`" msgstr ":meth:`Link.set_colors`" #: ../../link.rst:16 ebd1bee66f204d6bbd8e54086d79f55f msgid "modify color properties" msgstr "색상 속성 수정" #: ../../link.rst:17 111ec52301b74aac956f980fdfcaf35a msgid ":meth:`Link.set_flags`" msgstr ":meth:`Link.set_flags`" #: ../../link.rst:17 502cb7c9642642f293df7c93f92a2fd6 msgid "modify link flags" msgstr "링크 플래그 수정" #: ../../link.rst:18 489cb6995acd4a8f9459e84f8e29671e msgid ":attr:`Link.border`" msgstr ":attr:`Link.border`" #: ../../link.rst:18 c61da7b8553c4f35b0de3f5b60a3f9e9 msgid "border characteristics" msgstr "테두리 특성" #: ../../link.rst:19 5a1564c23ae44405bedf7e18c649d130 msgid ":attr:`Link.colors`" msgstr ":attr:`Link.colors`" #: ../../link.rst:19 01a00d5d838a47e3964be170b4b2aca4 msgid "border line color" msgstr "테두리 선 색상" #: ../../link.rst:20 df6c0ef2a13f47b28ec2cb2b88f5decf msgid ":attr:`Link.dest`" msgstr ":attr:`Link.dest`" #: ../../link.rst:20 2d7f3af920794e158f2472af28c69a4c msgid "points to destination details" msgstr "대상 세부 정보를 가리킴" #: ../../link.rst:21 c858c9ac8f3148deb29f863be9b27de6 msgid ":attr:`Link.is_external`" msgstr ":attr:`Link.is_external`" #: ../../link.rst:21 df77568aba6c4d24babf4d0d97c19d54 msgid "checks if the link is an external destination" msgstr "링크가 외부 대상인지 확인" #: ../../link.rst:22 09dcfdc3988d4ab0bb1b56be72905b8a msgid ":attr:`Link.flags`" msgstr ":attr:`Link.flags`" #: ../../link.rst:22 0fb0e2e7ae3944e6aa9886cccd29ba57 msgid "link annotation flags" msgstr "링크 주석 플래그" #: ../../link.rst:23 8b3432b79e804e8a8467829f70a5504d msgid ":attr:`Link.next`" msgstr ":attr:`Link.next`" #: ../../link.rst:23 482fbb3ecd0442a8bb0a43de75382822 msgid "points to next link" msgstr "다음 링크를 가리킴" #: ../../link.rst:24 7baaa58c6b184381b9aba640162dfe9b msgid ":attr:`Link.rect`" msgstr ":attr:`Link.rect`" #: ../../link.rst:24 0e0788e18be94b5784f4c8a3d0c8590b msgid "clickable area in untransformed coordinates" msgstr "변환되지 않은 좌표에서 클릭 가능한 영역" #: ../../link.rst:25 e8df77ad16fe4114a80eff4b8240b89c msgid ":attr:`Link.uri`" msgstr ":attr:`Link.uri`" #: ../../link.rst:25 502ec4ee36504004bd39daf295626fbc msgid "link destination" msgstr "링크 대상" #: ../../link.rst:26 d17729b40a80480caa127d310a3450c2 msgid ":attr:`Link.xref`" msgstr ":attr:`Link.xref`" #: ../../link.rst:26 678f619f97a244a0a539107e973f3986 msgid ":data:`xref` number of the entry" msgstr "항목의 :data:`xref` 번호" #: ../../link.rst:29 f76011eb2dd2424bba83dfb242a73eb3 msgid "**Class API**" msgstr "**클래스 API**" #: ../../link.rst:35 e01c9234e1b24ef4a42fe98da9e3b5b8 msgid "PDF only: Change border width and dashing properties." msgstr "PDF 전용: 테두리 너비 및 점선 속성 변경." #: ../../link.rst:37 00c3ab6e292048be95d9d1e26a0319ce msgid "" "*(Changed in version 1.16.9)* Allow specification without using a " "dictionary. The direct parameters are used if *border* is not a " "dictionary." msgstr "*(버전 1.16.9에서 변경됨)* 딕셔너리를 사용하지 않고 지정을 허용합니다. *border* 가 딕셔너리가 아니면 직접 매개변수가 사용됩니다." #: ../../link.rst 00e8660458ca4df49c759966985d7ccf #: 4560ff2f8db3457ea45107e432c3e7ee msgid "Parameters" msgstr "매개변수" #: ../../link.rst:39 9210f90061d54d20bb40b7811a63e193 msgid "" "a dictionary as returned by the :attr:`border` property, with keys " "*\"width\"* (*float*), *\"style\"* (*str*) and *\"dashes\"* (*sequence*)." " Omitted keys will leave the resp. property unchanged. To e.g. remove " "dashing use: *\"dashes\": []*. If dashes is not an empty sequence, " "\"style\" will automatically be set to \"D\" (dashed)." msgstr ":attr:`border` 속성에 의해 반환되는 딕셔너리로, 키 *\"width\"* (*float*), *\"style\"* (*str*) 및 *\"dashes\"* (*sequence*)를 가집니다. 생략된 키는 해당 속성을 변경하지 않습니다. 예를 들어 점선을 제거하려면: *\"dashes\": []* 를 사용하세요. dashes가 빈 시퀀스가 아니면 \"style\"이 자동으로 \"D\"(점선)로 설정됩니다." #: ../../link.rst:41 ../../link.rst:42 ../../link.rst:43 ../../link.rst:54 #: 0f652b3dc1754811b0fd20b619f58221 2a2addfc429e4856a5b9d38ccc565155 #: 4b687a46789e46148cf496194b0b604d 6666190d7e824106bd77ad41db6f0b41 msgid "see above." msgstr "위를 참조하세요." #: ../../link.rst:47 8657681111dc457788d3482a31e7fd86 msgid "PDF only: Changes the \"stroke\" color." msgstr "PDF 전용: \"stroke\" 색상 변경." #: ../../link.rst:49 a9f5e77a06364c1a8e73536a14d852c9 msgid "" "In PDF, links are a subtype of annotations technically and **do not " "support fill colors**. However, to keep a consistent API, we do allow " "specifying a `fill=` parameter like with all annotations, which will be " "ignored with a warning." msgstr "PDF에서 링크는 기술적으로 주석의 하위 유형이며 **채우기 색상을 지원하지 않습니다**. 그러나 일관된 API를 유지하기 위해 모든 주석과 마찬가지로 `fill=` 매개변수를 지정할 수 있지만 경고와 함께 무시됩니다." #: ../../link.rst:51 2f9965cf55cc4fa69cb5dc350c17ad09 msgid "" "*(Changed in version 1.16.9)* Allow colors to be directly set. These " "parameters are used if *colors* is not a dictionary." msgstr "*(버전 1.16.9에서 변경됨)* 색상을 직접 설정할 수 있도록 허용합니다. *colors* 가 딕셔너리가 아니면 이 매개변수가 사용됩니다." #: ../../link.rst:53 d1bb1f867e02444ebfbb4a94573959bf msgid "" "a dictionary containing color specifications. For accepted dictionary " "keys and values see below. The most practical way should be to first make" " a copy of the *colors* property and then modify this dictionary as " "required." msgstr "색상 사양을 포함하는 딕셔너리. 허용되는 딕셔너리 키와 값은 아래를 참조하세요. 가장 실용적인 방법은 먼저 *colors* 속성의 복사본을 만든 다음 필요에 따라 이 딕셔너리를 수정하는 것입니다." #: ../../link.rst:58 ../../link.rst:65 986b15f24ea54de580c0c662299fe12d #: bb27f8be006d4918acba2be1f77e4ee4 msgid "*New in v1.18.16*" msgstr "*v1.18.16에서 새로 추가됨*" #: ../../link.rst:60 df2a5f5ab5654a15a59600eb3536f242 msgid "" "Set the PDF `/F` property of the link annotation. See " ":meth:`Annot.set_flags` for details. If not a PDF, this method is a no-" "op." msgstr "링크 주석의 PDF `/F` 속성을 설정합니다. 자세한 내용은 :meth:`Annot.set_flags` 를 참조하세요. PDF가 아니면 이 메서드는 아무 작업도 수행하지 않습니다." #: ../../link.rst:67 e8cfa36461074dacb4c30dea81b83979 msgid "" "Return the link annotation flags, an integer (see :attr:`Annot.flags` for" " details). Zero if not a PDF." msgstr "링크 주석 플래그를 반환합니다. 정수입니다(자세한 내용은 :attr:`Annot.flags` 참조). PDF가 아니면 0입니다." #: ../../link.rst:72 004a6c2778ec462eb43f612d6513adde msgid "" "Meaningful for PDF only: A dictionary of two tuples of floats in range `0" " <= float <= 1` specifying the *stroke* and the interior (*fill*) colors." " If not a PDF, ``None`` is returned. As mentioned above, the fill color " "is always `None` for links. The stroke color is used for the border of " "the link rectangle. The length of the tuple implicitly determines the " "colorspace: 1 = GRAY, 3 = RGB, 4 = CMYK. So `(1.0, 0.0, 0.0)` stands for " "RGB color red. The value of each float *f* is mapped to the integer value" " *i* in range 0 to 255 via the computation *f = i / 255*." msgstr "PDF에만 의미가 있음: `0 <= float <= 1` 범위의 두 float 튜플 딕셔너리로 *stroke* 및 내부(*fill*) 색상을 지정합니다. PDF가 아니면 ``None`` 이 반환됩니다. 위에서 언급한 대로 링크의 채우기 색상은 항상 `None` 입니다. stroke 색상은 링크 사각형의 테두리에 사용됩니다. 튜플의 길이는 암시적으로 색 공간을 결정합니다: 1 = GRAY, 3 = RGB, 4 = CMYK. 따라서 `(1.0, 0.0, 0.0)` 은 RGB 색상 빨강을 나타냅니다. 각 float *f* 의 값은 계산 *f = i / 255* 를 통해 0에서 255 범위의 정수 값 *i* 에 매핑됩니다." #: ../../link.rst 114960dc31e14f46bd090eb9728c77c2 #: 4fbd9899261b4dcebb25e7595add5438 msgid "Return type" msgstr "반환 유형" #: ../../link.rst:78 3cbc8f0469d241929e34c352e5745bc1 msgid "" "Meaningful for PDF only: A dictionary containing border characteristics. " "It will be ``None`` for non-PDFs and an empty dictionary if no border " "information exists. The following keys can occur:" msgstr "PDF에만 의미가 있음: 테두리 특성을 포함하는 딕셔너리. 비-PDF의 경우 ``None`` 이고 테두리 정보가 없으면 빈 딕셔너리입니다. 다음 키가 나타날 수 있습니다:" #: ../../link.rst:80 c1ab318b501a47688d2fc6b081566c84 msgid "" "*width* -- a float indicating the border thickness in points. The value " "is -1.0 if no width is specified." msgstr "*width* -- 포인트 단위의 테두리 두께를 나타내는 float. 너비가 지정되지 않으면 값은 -1.0입니다." #: ../../link.rst:82 ee2605f02f554ef69ce01c7ce647b5c6 msgid "" "*dashes* -- a sequence of integers specifying a line dash pattern. *[]* " "means no dashes, *[n]* means equal on-off lengths of *n* points, longer " "lists will be interpreted as specifying alternating on-off length values." " See the :ref:`AdobeManual` page 126 for more detail." msgstr "*dashes* -- 선 점선 패턴을 지정하는 정수 시퀀스. *[]* 는 점선 없음을 의미하고, *[n]* 는 *n* 포인트의 동일한 on-off 길이를 의미하며, 더 긴 목록은 교대로 on-off 길이 값을 지정하는 것으로 해석됩니다. 자세한 내용은 :ref:`AdobeManual` 126페이지를 참조하세요." #: ../../link.rst:84 b4b27c2220234e3c9f0da44681173211 msgid "" "*style* -- 1-byte border style: *S* (Solid) = solid rectangle surrounding" " the annotation, *D* (Dashed) = dashed rectangle surrounding the link, " "the dash pattern is specified by the *dashes* entry, *B* (Beveled) = a " "simulated embossed rectangle that appears to be raised above the surface " "of the page, *I* (Inset) = a simulated engraved rectangle that appears to" " be recessed below the surface of the page, *U* (Underline) = a single " "line along the bottom of the annotation rectangle." msgstr "*style* -- 1바이트 테두리 스타일: *S* (Solid) = 주석을 둘러싸는 실선 사각형, *D* (Dashed) = 링크를 둘러싸는 점선 사각형, 점선 패턴은 *dashes* 항목으로 지정됨, *B* (Beveled) = 페이지 표면 위로 올라온 것처럼 보이는 시뮬레이션된 볼록한 사각형, *I* (Inset) = 페이지 표면 아래로 들어간 것처럼 보이는 시뮬레이션된 각인된 사각형, *U* (Underline) = 주석 사각형 하단을 따라가는 단일 선." #: ../../link.rst:90 052b846ac7bf4348bb05373fe93c7f66 msgid "The area that can be clicked in untransformed coordinates." msgstr "변환되지 않은 좌표에서 클릭할 수 있는 영역." #: ../../link.rst 278b7dd100364049a9a0f8a608dfe200 #: 5b8584b479504935a82003972fba8296 91cdff8cf9e5471f8c8c7ebd105a9694 #: 92b24b7f7b1d434bab261bfbfc850087 a7dd1626e8024de0a8394b7ac58b00dc #: b3fc6b24eede40c5a5ff68c9552eb5d3 msgid "type" msgstr "유형" #: ../../link.rst:92 b6cde768d2b448d3918fcc2629f09e45 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../link.rst:96 9cbf66013e07421da625a37f62f421af msgid "" "A bool specifying whether the link target is outside of the current " "document." msgstr "링크 대상이 현재 문서 외부에 있는지 여부를 지정하는 bool입니다." #: ../../link.rst:98 3bf7415e10f64b17a00d1894d75abd4d msgid "bool" msgstr "bool" #: ../../link.rst:102 7722949c512e472da9f50b38d703a9f0 msgid "" "A string specifying the link target. The meaning of this property should " "be evaluated in conjunction with property `is_external`:" msgstr "링크 대상을 지정하는 문자열입니다. 이 속성의 의미는 `is_external` 속성과 함께 평가해야 합니다:" #: ../../link.rst:106 8a85f4db122a4632acda8a79099ab276 msgid "" "`is_external` is true: `uri` points to some target outside the current " "PDF, which may be an internet resource (`uri` starts with ``http://`` or " "similar), another file (`uri` starts with \"file:\" or \"file://\") or " "some other service like an e-mail address (`uri` starts with " "``mailto:``)." msgstr "`is_external` 이 true: `uri` 는 현재 PDF 외부의 대상을 가리키며, 인터넷 리소스(`uri` 가 ``http://`` 또는 유사한 것으로 시작), 다른 파일(`uri` 가 \"file:\" 또는 \"file://\"로 시작) 또는 이메일 주소와 같은 기타 서비스(`uri` 가 ``mailto:`` 로 시작)일 수 있습니다." #: ../../link.rst:112 aa85a467ae894a49801187d31376da42 msgid "" "`is_external` is false: `uri` will be `None` or point to an internal " "location. In case of PDF documents, this should either be *#nnnn* to " "indicate a 1-based (!) page number *nnnn*, or a named location. The " "format varies for other document types, for example " "\"../FixedDoc.fdoc#PG_2_LNK_1\" for page number 2 (1-based) in an XPS " "document." msgstr "`is_external` 이 false: `uri` 는 `None` 이거나 내부 위치를 가리킵니다. PDF 문서의 경우, 이것은 1부터 시작하는(!) 페이지 번호 *nnnn* 을 나타내는 *#nnnn* 이거나 이름이 지정된 위치여야 합니다. 형식은 다른 문서 유형에 따라 다릅니다. 예를 들어 XPS 문서의 페이지 번호 2(1부터 시작)의 경우 \"../FixedDoc.fdoc#PG_2_LNK_1\"입니다." #: ../../link.rst:119 169f5e74d4d248acaf39fe0e78f64c8c msgid "str" msgstr "str" #: ../../link.rst:123 b896a257acf94231987101c53ec2a3ee msgid "An integer specifying the PDF :data:`xref`. Zero if not a PDF." msgstr "PDF :data:`xref` 를 지정하는 정수입니다. PDF가 아니면 0입니다." #: ../../link.rst:125 0a7066aaee624b82bdccf14c63cbeb5a msgid "int" msgstr "int" #: ../../link.rst:129 3d5c16c89c01444b862176bdfbe17241 msgid "The next link or ``None``." msgstr "다음 링크 또는 ``None``." #: ../../link.rst:131 aeff8c341c48462292eba7bef8c73eeb msgid "*Link*" msgstr "*Link*" #: ../../link.rst:135 bc9d0756ee4e4e0c8f03bde2e4a58991 msgid "The link destination details object." msgstr "링크 대상 세부 정보 객체." #: ../../link.rst:137 9b93286e15e64f8f9bc75c6e2a1305bb msgid ":ref:`linkDest`" msgstr ":ref:`linkDest`" #: ../../footer.rst:46 74c752369b354d73af2f7c11e7b19f1f msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/linkdest.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 d57c78d809254da4835f2c2e979be9bf msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 a9ed1908021a4b46ac047f81afa8fd03 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c383513223a942bea5aee21e50d9b3c2 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../linkdest.rst:7 6f11bc05a63745008c94dda126160905 msgid "linkDest" msgstr "linkDest" #: ../../linkdest.rst:8 0b3bb1ecff3b4317aaaabd080edb44e8 msgid "" "Class representing the `dest` property of an outline entry or a link. " "Describes the destination to which such entries point." msgstr "개요 항목 또는 링크의 `dest` 속성을 나타내는 클래스입니다. 이러한 항목이 가리키는 대상을 설명합니다." #: ../../linkdest.rst:10 c02022acb8024740b76912d137b9899a msgid "" "Up to MuPDF v1.9.0 this class existed inside MuPDF and was dropped in " "version 1.10.0. For backward compatibility, PyMuPDF is still maintaining " "it, although some of its attributes are no longer backed by data actually" " available via MuPDF." msgstr "MuPDF v1.9.0까지 이 클래스는 MuPDF 내부에 존재했으며 버전 1.10.0에서 제거되었습니다. 하위 호환성을 위해 PyMuPDF는 여전히 이를 유지하고 있지만, 일부 속성은 더 이상 MuPDF를 통해 실제로 사용 가능한 데이터로 지원되지 않습니다." #: ../../linkdest.rst:13 192d952a7df04c4cb3800c0c6f8b6f99 msgid "**Attribute**" msgstr "**속성**" #: ../../linkdest.rst:13 71e9a555483944ff92a77001b3d42f49 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../linkdest.rst:15 3ccecaa069ff4226b5794d23afcb6f38 msgid ":attr:`linkDest.dest`" msgstr ":attr:`linkDest.dest`" #: ../../linkdest.rst:15 b0182cc143894b7397921f5e6efe2ad8 msgid "destination" msgstr "대상" #: ../../linkdest.rst:16 94cfb537b2034d95b10812ca82ab0904 msgid ":attr:`linkDest.fileSpec`" msgstr ":attr:`linkDest.fileSpec`" #: ../../linkdest.rst:16 8c2d54d1045244c2b2c7be7fe3aff94d msgid "file specification (path, filename)" msgstr "파일 사양(경로, 파일명)" #: ../../linkdest.rst:17 c9d87d20c7e34bdcba3e15b52958cc2d msgid ":attr:`linkDest.flags`" msgstr ":attr:`linkDest.flags`" #: ../../linkdest.rst:17 8eab10462616444ca0c07141a25997d1 msgid "descriptive flags" msgstr "설명 플래그" #: ../../linkdest.rst:18 d3ee936fbf09442985e09022f97346a0 msgid ":attr:`linkDest.isMap`" msgstr ":attr:`linkDest.isMap`" #: ../../linkdest.rst:18 6b10fcc4b7024312b80879a046dde7a1 msgid "is this a MAP?" msgstr "이것이 MAP입니까?" #: ../../linkdest.rst:19 ebd316b494c341949404a1013a0c3716 msgid ":attr:`linkDest.isUri`" msgstr ":attr:`linkDest.isUri`" #: ../../linkdest.rst:19 a3d669f5e1b24a5f8817d790b4dfce24 msgid "is this a URI?" msgstr "이것이 URI입니까?" #: ../../linkdest.rst:20 5f79bf4078184f17aed9690ec43a9e28 msgid ":attr:`linkDest.kind`" msgstr ":attr:`linkDest.kind`" #: ../../linkdest.rst:20 da66f3a913634b5197318056882d489c msgid "kind of destination" msgstr "대상 유형" #: ../../linkdest.rst:21 a9f255b3361541bbbc58d4b524552874 msgid ":attr:`linkDest.lt`" msgstr ":attr:`linkDest.lt`" #: ../../linkdest.rst:21 8696049fe5f14b5e898e8894961de97a msgid "top left coordinates" msgstr "왼쪽 위 좌표" #: ../../linkdest.rst:22 e69848891b564b91b789e415193e2599 msgid ":attr:`linkDest.named`" msgstr ":attr:`linkDest.named`" #: ../../linkdest.rst:22 3e9e08f3e3f646e39ea6939d38f92ea7 msgid "name if named destination" msgstr "이름이 지정된 대상인 경우 이름" #: ../../linkdest.rst:23 e55ceb925d38472da5faac759c6c1f39 msgid ":attr:`linkDest.newWindow`" msgstr ":attr:`linkDest.newWindow`" #: ../../linkdest.rst:23 9da63baa93924bb3810f8b14cd3c6f08 msgid "name of new window" msgstr "새 창 이름" #: ../../linkdest.rst:24 3133f4f237c54427b5f38bb9e4ee0870 msgid ":attr:`linkDest.page`" msgstr ":attr:`linkDest.page`" #: ../../linkdest.rst:24 4e9fb63bb49e45838a66455c5ee65ae9 msgid "page number" msgstr "페이지 번호" #: ../../linkdest.rst:25 007c86d9023d40e5bb0e4e5b93d802dd msgid ":attr:`linkDest.rb`" msgstr ":attr:`linkDest.rb`" #: ../../linkdest.rst:25 6eeedea7ed6145018567f08541f89224 msgid "bottom right coordinates" msgstr "오른쪽 아래 좌표" #: ../../linkdest.rst:26 748aaf1c62434b01970667a3b3033d87 msgid ":attr:`linkDest.uri`" msgstr ":attr:`linkDest.uri`" #: ../../linkdest.rst:26 7ad45d4c5bba4618bf6a5964e2571854 msgid "URI" msgstr "URI" #: ../../linkdest.rst:29 fb8d1e50444c4cd08673dbee32636872 msgid "**Class API**" msgstr "**클래스 API**" #: ../../linkdest.rst:35 899ccd076a8a486087261429c87c1e49 msgid "" "Target destination name if :attr:`linkDest.kind` is :data:`LINK_GOTOR` " "and :attr:`linkDest.page` is *-1*." msgstr ":attr:`linkDest.kind` 가 :data:`LINK_GOTOR` 이고 :attr:`linkDest.page` 가 *-1* 인 경우 대상 이름." #: ../../linkdest.rst 04ee6c88174848ac8bab86ad2416c0a3 #: 1464a774b9d54e0e990c6ebe2da4c6e8 473cf52ca9cf41cf99038dd29cc31c14 #: 4dd16d523ebf4121a0e9a79f97cd9d11 63054de214a4471fbb6d1ab8f3b7b573 #: 670cff5c69074cc6a2bc4689ab5393c9 9ddddca25b3d4f75bcfa839cc96b9a21 #: b44b0784cdb246cfa94a0a2059b94018 b58c6c51b75c480294d940a64089a608 #: bb350508308a4d99acad49e328495653 e224131ce0fe4fd0a1df5250c0487ca4 #: e5f8f3174dfc4ff997a1743196c9e4d6 msgid "type" msgstr "유형" #: ../../linkdest.rst:37 ../../linkdest.rst:43 ../../linkdest.rst:79 #: ../../linkdest.rst:103 581dcd6df6224fbe8745cc8ab2b07a91 #: a81ed9ea22224e639705fc5e3839af2f d3182a558fb849428de433c60a1bdad7 #: f69f354db0e14b7ea4880f6b4e0aa8ff msgid "str" msgstr "str" #: ../../linkdest.rst:41 90baaf8b636c4ee591f82da46afacac7 msgid "" "Contains the filename and path this link points to, if " ":attr:`linkDest.kind` is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`." msgstr ":attr:`linkDest.kind` 가 :data:`LINK_GOTOR` 또는 :data:`LINK_LAUNCH` 인 경우 이 링크가 가리키는 파일명과 경로를 포함합니다." #: ../../linkdest.rst:47 ee1974ce6ace4936a3d8b8b75df71cb3 msgid "" "A bitfield describing the validity and meaning of the different aspects " "of the destination. As far as possible, link destinations are constructed" " such that e.g. :attr:`linkDest.lt` and :attr:`linkDest.rb` can be " "treated as defining a bounding box. But the flags indicate which of the " "values were actually specified, see :ref:`linkDest Flags`." msgstr "대상의 다양한 측면의 유효성과 의미를 설명하는 비트 필드입니다. 가능한 한 링크 대상은 예를 들어 :attr:`linkDest.lt` 와 :attr:`linkDest.rb` 가 경계 상자를 정의하는 것으로 처리될 수 있도록 구성됩니다. 하지만 플래그는 실제로 지정된 값들을 나타냅니다. :ref:`linkDest Flags` 를 참조하세요." #: ../../linkdest.rst:49 ../../linkdest.rst:67 ../../linkdest.rst:91 #: 3b848969f4524896b56f42ff138fb1c9 4f8b0dea71b94d5dbc70216822055473 #: bcc9a9fb3afa46a898733753cf361878 msgid "int" msgstr "int" #: ../../linkdest.rst:53 09670cfe131548ddaff754f8d49d8e50 msgid "" "This flag specifies whether to track the mouse position when the URI is " "resolved. Default value: False." msgstr "이 플래그는 URI가 해결될 때 마우스 위치를 추적할지 여부를 지정합니다. 기본값: False." #: ../../linkdest.rst:55 ../../linkdest.rst:61 ../../linkdest.rst:85 #: 0f0bd710715f40efbacc9b29ff09ea21 44063c7c188e4ce083c47c800c7fe09f #: 64522ffbee3a4d4a93db40e43a1b4f85 msgid "bool" msgstr "bool" #: ../../linkdest.rst:59 fbb535a20f504c3e943e5b5a817ff056 msgid "" "Specifies whether this destination is an internet resource (as opposed to" " e.g. a local file specification in URI format)." msgstr "이 대상이 인터넷 리소스인지 여부를 지정합니다(예: URI 형식의 로컬 파일 사양과 대조)." #: ../../linkdest.rst:65 ca4f535dd57b4577b7809ce0b0137464 msgid "" "Indicates the type of this destination, like a place in this document, a " "URI, a file launch, an action or a place in another file. Look at " ":ref:`linkDest Kinds` to see the names and numerical values." msgstr "이 문서 내의 위치, URI, 파일 실행, 작업 또는 다른 파일 내의 위치와 같은 이 대상의 유형을 나타냅니다. 이름과 숫자 값을 보려면 :ref:`linkDest Kinds` 를 참조하세요." #: ../../linkdest.rst:71 47371977bcbb41fca7f337d5784b6648 msgid "The top left :ref:`Point` of the destination." msgstr "대상의 왼쪽 위 :ref:`Point`." #: ../../linkdest.rst:73 ../../linkdest.rst:97 8e3bc240ba0743959b8cbaa03d0dcff8 #: c1283cb2f6344dc99b2a97cb147bba13 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../linkdest.rst:77 c723aab53cf843ebae6f749ce9ff4e59 msgid "" "This destination refers to some named action to perform (e.g. a " "javascript, see :ref:`AdobeManual`). Standard actions provided are " "*NextPage*, *PrevPage*, *FirstPage*, and *LastPage*." msgstr "이 대상은 수행할 이름이 지정된 작업(예: javascript, :ref:`AdobeManual` 참조)을 나타냅니다. 제공되는 표준 작업은 *NextPage*, *PrevPage*, *FirstPage*, *LastPage* 입니다." #: ../../linkdest.rst:83 1a909731575743f18e88a17658993f9c msgid "If true, the destination should be launched in a new window." msgstr "true이면 대상은 새 창에서 시작되어야 합니다." #: ../../linkdest.rst:89 09037d0a5d7f4c37a6408b92ec712af6 msgid "" "The page number (in this or the target document) this destination points " "to. Only set if :attr:`linkDest.kind` is :data:`LINK_GOTOR` or " ":data:`LINK_GOTO`. May be *-1* if :attr:`linkDest.kind` is " ":data:`LINK_GOTOR`. In this case :attr:`linkDest.dest` contains the " "**name** of a destination in the target document." msgstr "이 대상이 가리키는 페이지 번호(이 문서 또는 대상 문서 내). :attr:`linkDest.kind` 가 :data:`LINK_GOTOR` 또는 :data:`LINK_GOTO` 인 경우에만 설정됩니다. :attr:`linkDest.kind` 가 :data:`LINK_GOTOR` 이면 *-1* 일 수 있습니다. 이 경우 :attr:`linkDest.dest` 에는 대상 문서의 대상 **이름** 이 포함됩니다." #: ../../linkdest.rst:95 c34d69f4dd99459b8b7b950ce4b817ef msgid "The bottom right :ref:`Point` of this destination." msgstr "이 대상의 오른쪽 아래 :ref:`Point`." #: ../../linkdest.rst:101 ab5be4b38a0d488996cc185c94c3339d msgid "The name of the URI this destination points to." msgstr "이 대상이 가리키는 URI의 이름." #: ../../footer.rst:46 fa618bdc623f48169996365910295fee msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/lowlevel.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 218a54ea43ac4940a4a60f2c3a6a2478 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 07e59acd2f254f13ab7d70dabdc0b0e5 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 b0edbb6b219e443c991a8de67143adf0 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../lowlevel.rst:5 ab1b60182cf44f4cbdbc96550824ae06 msgid "Low Level Functions and Classes" msgstr "저수준 함수 및 클래스" #: ../../lowlevel.rst:6 7cd71eb177ee46c7809cc02f9cf0360a msgid "" "Contains a number of functions and classes for the experienced user. To " "be used for special needs or performance requirements." msgstr "경험 많은 사용자를 위한 여러 함수와 클래스를 포함합니다. 특수한 요구사항이나 성능 요구사항에 사용됩니다." #: ../../footer.rst:46 e5486934644f471b8a6673bf428a5c43 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/matrix.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 22b6a2a0571c4176bce077c545c814b3 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 73c9619ac3ee44d084a65d56842dc380 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 84065a34a4a14808906180f02e2efea2 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../matrix.rst:7 8a040befeffb44ac97583a22b00537bb msgid "Matrix" msgstr "Matrix" #: ../../matrix.rst:9 8eb69980d89943bb8e94c77820ab6263 msgid "" "Matrix is a row-major 3x3 matrix used by image transformations in MuPDF " "(which complies with the respective concepts laid down in the " ":ref:`AdobeManual`). With matrices you can manipulate the rendered image " "of a page in a variety of ways: (parts of) the page can be rotated, " "zoomed, flipped, sheared and shifted by setting some or all of just six " "float values." msgstr "Matrix는 MuPDF의 이미지 변환에 사용되는 행 우선 3x3 행렬입니다(:ref:`AdobeManual` 에 명시된 해당 개념을 준수). 행렬을 사용하면 페이지의 렌더링된 이미지를 다양한 방식으로 조작할 수 있습니다: 단 6개의 float 값 중 일부 또는 전체를 설정하여 페이지(의 일부)를 회전, 확대/축소, 뒤집기, 기울이기 및 이동할 수 있습니다." #: ../../matrix.rst:12 99311bf26c5b4fd5b0df9afed1d8ff5a msgid "" "Since all points or pixels live in a two-dimensional space, one column " "vector of that matrix is a constant unit vector, and only the remaining " "six elements are used for manipulations. These six elements are usually " "represented by `[a, b, c, d, e, f]`. Here is how they are positioned in " "the matrix:" msgstr "모든 점 또는 픽셀이 2차원 공간에 있으므로 해당 행렬의 한 열 벡터는 상수 단위 벡터이며, 나머지 6개 요소만 조작에 사용됩니다. 이 6개 요소는 일반적으로 `[a, b, c, d, e, f]` 로 표시됩니다. 행렬에서의 위치는 다음과 같습니다:" #: ../../matrix.rst:17 981036c6e6c24d00adc24601b311399b msgid "Please note:" msgstr "참고:" #: ../../matrix.rst:19 f1ae75aa82ce4a989a3afb538b648bd5 msgid "" "the below methods are just convenience functions -- everything they do, " "can also be achieved by directly manipulating the six numerical values" msgstr "아래 메서드는 편의 함수일 뿐입니다 -- 수행하는 모든 작업은 6개의 숫자 값을 직접 조작하여도 달성할 수 있습니다" #: ../../matrix.rst:20 26c41674818040ab9d706c72f62e5b31 msgid "" "all manipulations can be combined -- you can construct a matrix that " "rotates **and** shears **and** scales **and** shifts, etc. in one go. If " "you however choose to do this, do have a look at the **remarks** further " "down or at the :ref:`AdobeManual`." msgstr "모든 조작을 결합할 수 있습니다 -- 한 번에 회전 **및** 기울이기 **및** 확대/축소 **및** 이동 등을 수행하는 행렬을 구성할 수 있습니다. 하지만 이렇게 하려면 아래의 **참고 사항** 또는 :ref:`AdobeManual` 을 참조하세요." #: ../../matrix.rst:23 afd4ea95b6d34a6e914cc64e20f4259b msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../matrix.rst:23 c34d2903bcee45ddb3cc5e621baefea0 msgid "**Description**" msgstr "**설명**" #: ../../matrix.rst:25 11abdcd6cd234d4fa95850fe12580df9 msgid ":meth:`Matrix.prerotate`" msgstr ":meth:`Matrix.prerotate`" #: ../../matrix.rst:25 80427e602a66422cac1da53c44af455f msgid "perform a rotation" msgstr "회전 수행" #: ../../matrix.rst:26 cad3e578828b433ba7ba0051be2032bf msgid ":meth:`Matrix.prescale`" msgstr ":meth:`Matrix.prescale`" #: ../../matrix.rst:26 a7e0bd6a201641fb912613e9f27fd76f msgid "perform a scaling" msgstr "확대/축소 수행" #: ../../matrix.rst:27 50c7f90d06004c62b19c6bff1b5a0ee9 msgid ":meth:`Matrix.preshear`" msgstr ":meth:`Matrix.preshear`" #: ../../matrix.rst:27 10745ab48ff842fa86f0dba65a8ac4c9 msgid "perform a shearing (skewing)" msgstr "기울이기(왜곡) 수행" #: ../../matrix.rst:28 b4c7cc3f2aff4f929fd556b21396c232 msgid ":meth:`Matrix.pretranslate`" msgstr ":meth:`Matrix.pretranslate`" #: ../../matrix.rst:28 cefba85880554c02abc66d69a6a32faf msgid "perform a translation (shifting)" msgstr "이동(시프트) 수행" #: ../../matrix.rst:29 b3b9abc777594cf8b33d5290836afe88 msgid ":meth:`Matrix.concat`" msgstr ":meth:`Matrix.concat`" #: ../../matrix.rst:29 fe1f3aa66e6042309e54265e9b99b18d msgid "perform a matrix multiplication" msgstr "행렬 곱셈 수행" #: ../../matrix.rst:30 fb89b2f56f6247ac8fc9b88f34f7e6c1 msgid ":meth:`Matrix.invert`" msgstr ":meth:`Matrix.invert`" #: ../../matrix.rst:30 4dab7517ebb647c78b179fbe83285a9f msgid "calculate the inverted matrix" msgstr "역행렬 계산" #: ../../matrix.rst:31 3f0c29fd96594bd7824f5d9ab40c0fd7 msgid ":meth:`Matrix.norm`" msgstr ":meth:`Matrix.norm`" #: ../../matrix.rst:31 bee6a79c30594e5a9982c37569a07722 msgid "the Euclidean norm" msgstr "유클리드 노름" #: ../../matrix.rst:32 b0e601bc11b94c5b978faf3969d20262 msgid ":attr:`Matrix.a`" msgstr ":attr:`Matrix.a`" #: ../../matrix.rst:32 7bd503f42cb2438da182834d71fb2dd4 msgid "zoom factor X direction" msgstr "X 방향 확대/축소 계수" #: ../../matrix.rst:33 b20b6e26dcf04b37bf9d3226d6b7720f msgid ":attr:`Matrix.b`" msgstr ":attr:`Matrix.b`" #: ../../matrix.rst:33 dc49e0f4424c40eaa3c9b116b0a0d20f msgid "shearing effect Y direction" msgstr "Y 방향 기울이기 효과" #: ../../matrix.rst:34 d2e19dfdd9104ec19d44f40c663bcc03 msgid ":attr:`Matrix.c`" msgstr ":attr:`Matrix.c`" #: ../../matrix.rst:34 0a2f7dcd0de34db7a4c69a001674c37a msgid "shearing effect X direction" msgstr "X 방향 기울이기 효과" #: ../../matrix.rst:35 c72a8985cba049b487c8ffebefcf9d99 msgid ":attr:`Matrix.d`" msgstr ":attr:`Matrix.d`" #: ../../matrix.rst:35 c1fe0a57201a4eb6ad2a830ae1b17b15 msgid "zoom factor Y direction" msgstr "Y 방향 확대/축소 계수" #: ../../matrix.rst:36 e471bd7cfd92424ab1e5f3e5059d4be9 msgid ":attr:`Matrix.e`" msgstr ":attr:`Matrix.e`" #: ../../matrix.rst:36 d19ab3110ade4ac3b17c845a8c80fb37 msgid "horizontal shift" msgstr "수평 이동" #: ../../matrix.rst:37 4a6eb68a255c4608873196c13298d411 msgid ":attr:`Matrix.f`" msgstr ":attr:`Matrix.f`" #: ../../matrix.rst:37 0f0db520282844e9869b27e82d6fba11 msgid "vertical shift" msgstr "수직 이동" #: ../../matrix.rst:38 e75c12f64eee44059ea4b0762741fdb1 msgid ":attr:`Matrix.is_rectilinear`" msgstr ":attr:`Matrix.is_rectilinear`" #: ../../matrix.rst:38 bc57693d7a8c445eb2a7717732d081b9 msgid "true if rect corners will remain rect corners" msgstr "사각형 모서리가 사각형 모서리로 유지되면 true" #: ../../matrix.rst:41 01aaa6a5cece41dd86f5e6c6f0d08b42 msgid "**Class API**" msgstr "**클래스 API**" #: ../../matrix.rst:59 56627216de1442368ffe90a40bd40b5a msgid "Overloaded constructors." msgstr "오버로드된 생성자." #: ../../matrix.rst:61 ab9ade436b794d9cb70e8ec07c59573e msgid "" "Without parameters, the zero matrix *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, " "0.0)* will be created." msgstr "매개변수 없이 영 행렬 *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, 0.0)* 이 생성됩니다." #: ../../matrix.rst:63 0ff005031e87475e82c82f509a503432 msgid "" "*zoom-** and *shear-** specify zoom or shear values (float) and create a " "zoom or shear matrix, respectively." msgstr "*zoom-** 및 *shear-** 는 확대/축소 또는 기울이기 값(float)을 지정하고 각각 확대/축소 또는 기울이기 행렬을 생성합니다." #: ../../matrix.rst:65 3772827e3c4e46efaa66e0541654fbde msgid "For \"matrix\" a **new copy** of another matrix will be made." msgstr "\"matrix\"의 경우 다른 행렬의 **새 복사본** 이 만들어집니다." #: ../../matrix.rst:67 e0de220e569d4fb192d61776da7cc98d msgid "" "Float value \"degree\" specifies the creation of a rotation matrix which " "rotates anti-clockwise." msgstr "Float 값 \"degree\"는 반시계 방향으로 회전하는 회전 행렬의 생성을 지정합니다." #: ../../matrix.rst:69 202fbb08a1534f9b873b978d1ee2f25e msgid "" "A \"sequence\" must be any Python sequence object with exactly 6 float " "entries (see :ref:`SequenceTypes`)." msgstr "\"sequence\"는 정확히 6개의 float 항목을 가진 모든 Python 시퀀스 객체여야 합니다(:ref:`SequenceTypes` 참조)." #: ../../matrix.rst:71 3290c36cfd044349b8b73b9a12b39105 msgid "" "*pymupdf.Matrix(1, 1)* and *pymupdf.Matrix(pymupdf.Identity)* create " "modifiable versions of the :ref:`Identity` matrix, which looks like *[1, " "0, 0, 1, 0, 0]*." msgstr "*pymupdf.Matrix(1, 1)* 및 *pymupdf.Matrix(pymupdf.Identity)* 는 *[1, 0, 0, 1, 0, 0]* 처럼 보이는 :ref:`Identity` 행렬의 수정 가능한 버전을 생성합니다." #: ../../matrix.rst:75 2d27925e056c4beab39284c17c097dc8 msgid "New in version 1.16.0" msgstr "버전 1.16.0에서 새로 추가됨" #: ../../matrix.rst:77 23099b3eeb904d19a2fca93ba4ff4ac2 msgid "Return the Euclidean norm of the matrix as a vector." msgstr "행렬의 유클리드 노름을 벡터로 반환합니다." #: ../../matrix.rst:81 cf82a48349524343a3a9fb35951b2482 msgid "" "Modify the matrix to perform a counter-clockwise rotation for positive " "*deg* degrees, else clockwise. The matrix elements of an identity matrix " "will change in the following way:" msgstr "행렬을 수정하여 양수 *deg* 도에 대해 반시계 방향 회전을 수행하고, 그렇지 않으면 시계 방향으로 회전합니다. 항등 행렬의 행렬 요소는 다음과 같이 변경됩니다:" #: ../../matrix.rst:83 a024346df65d49e7bcdef1a35d0f0ea9 msgid "*[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*." msgstr "*[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*." #: ../../matrix.rst 0e2caa4b969d4e8c883315663dfbb010 #: 2a76f7fdef494d7cb96fb9bcb0b288a0 44ed05851fab4cd4b3017cd0b82bc4f4 #: 797389fbee9c42f6a11d44d628804863 c8b2675c06ee43c4abcd46c105be0f19 #: e6e50d5d62724013ba993ce51b6e65a8 msgid "Parameters" msgstr "매개변수" #: ../../matrix.rst:85 34bf9b5e70b9486285ffd6799c5556ca msgid "" "The rotation angle in degrees (use conventional notation based on Pi = " "180 degrees)." msgstr "도 단위의 회전 각도(Pi = 180도를 기준으로 한 일반 표기법 사용)." #: ../../matrix.rst:89 94eb659613c24f939142b8fc6dd19ab4 msgid "" "Modify the matrix to scale by the zoom factors sx and sy. Has effects on " "attributes *a* thru *d* only: *[a, b, c, d, e, f] -> [a*sx, b*sx, c*sy, " "d*sy, e, f]*." msgstr "행렬을 수정하여 확대/축소 계수 sx 및 sy로 스케일링합니다. 속성 *a* 부터 *d* 에만 영향을 줍니다: *[a, b, c, d, e, f] -> [a*sx, b*sx, c*sy, d*sy, e, f]*." #: ../../matrix.rst:91 72c725939ccb4e8b90b12926ae88abec msgid "" "Zoom factor in X direction. For the effect see description of attribute " "*a*." msgstr "X 방향의 확대/축소 계수. 효과는 속성 *a* 의 설명을 참조하세요." #: ../../matrix.rst:93 2ef911aad48643e18db6f643f2613c9a msgid "" "Zoom factor in Y direction. For the effect see description of attribute " "*d*." msgstr "Y 방향의 확대/축소 계수. 효과는 속성 *d* 의 설명을 참조하세요." #: ../../matrix.rst:97 a47d6e8530894f2aac1846c0416c7f14 msgid "" "Modify the matrix to perform a shearing, i.e. transformation of " "rectangles into parallelograms (rhomboids). Has effects on attributes *a*" " thru *d* only: *[a, b, c, d, e, f] -> [c*sy, d*sy, a*sx, b*sx, e, f]*." msgstr "행렬을 수정하여 기울이기를 수행합니다. 즉, 사각형을 평행사변형(마름모)으로 변환합니다. 속성 *a* 부터 *d* 에만 영향을 줍니다: *[a, b, c, d, e, f] -> [c*sy, d*sy, a*sx, b*sx, e, f]*." #: ../../matrix.rst:99 7af0396c77db4280bd8b6ef9764cab2d msgid "Shearing effect in X direction. See attribute *c*." msgstr "X 방향의 기울이기 효과. 속성 *c* 를 참조하세요." #: ../../matrix.rst:101 5a8d7d2b58c348f0bf481d54d9ff5b01 msgid "Shearing effect in Y direction. See attribute *b*." msgstr "Y 방향의 기울이기 효과. 속성 *b* 를 참조하세요." #: ../../matrix.rst:105 152c5f45800e42b6a038fee68ba116d4 msgid "" "Modify the matrix to perform a shifting / translation operation along the" " x and / or y axis. Has effects on attributes *e* and *f* only: *[a, b, " "c, d, e, f] -> [a, b, c, d, tx*a + ty*c, tx*b + ty*d]*." msgstr "행렬을 수정하여 x 및/또는 y 축을 따라 이동/변환 작업을 수행합니다. 속성 *e* 및 *f* 에만 영향을 줍니다: *[a, b, c, d, e, f] -> [a, b, c, d, tx*a + ty*c, tx*b + ty*d]*." #: ../../matrix.rst:107 8b15e98fb7734d2fb7d3a90c734616fd msgid "Translation effect in X direction. See attribute *e*." msgstr "X 방향의 이동 효과. 속성 *e* 를 참조하세요." #: ../../matrix.rst:109 1ac03cdeaadf47039b40d141265dad51 msgid "Translation effect in Y direction. See attribute *f*." msgstr "Y 방향의 이동 효과. 속성 *f* 를 참조하세요." #: ../../matrix.rst:113 a7232949340949e6bee6b5a75b157849 msgid "" "Calculate the matrix product *m1 * m2* and store the result in the " "current matrix. Any of *m1* or *m2* may be the current matrix. Be aware " "that matrix multiplication is not commutative. So the sequence of *m1*, " "*m2* is important." msgstr "행렬 곱 *m1 * m2* 를 계산하고 결과를 현재 행렬에 저장합니다. *m1* 또는 *m2* 중 하나가 현재 행렬일 수 있습니다. 행렬 곱셈은 가환적이지 않습니다. 따라서 *m1*, *m2* 의 순서가 중요합니다." #: ../../matrix.rst:115 c868c7bce6e24c17aefb279a2b589bad msgid "First (left) matrix." msgstr "첫 번째(왼쪽) 행렬." #: ../../matrix.rst:118 6a23a720cc824c018154df578fbe2287 msgid "Second (right) matrix." msgstr "두 번째(오른쪽) 행렬." #: ../../matrix.rst:123 c1c62753df994db5a29eaf60b74d5311 msgid "" "Calculate the matrix inverse of *m* and store the result in the current " "matrix. Returns *1* if *m* is not invertible (\"degenerate\"). In this " "case the current matrix **will not change**. Returns *0* if *m* is " "invertible, and the current matrix is replaced with the inverted *m*." msgstr "*m* 의 역행렬을 계산하고 결과를 현재 행렬에 저장합니다. *m* 이 역행렬이 없으면(\"degenerate\") *1* 을 반환합니다. 이 경우 현재 행렬은 **변경되지 않습니다**. *m* 이 역행렬이 있으면 *0* 을 반환하고 현재 행렬은 역행렬 *m* 으로 대체됩니다." #: ../../matrix.rst:125 6f3f8c966b71407b9e3b02488f7f4034 msgid "Matrix to be inverted. If not provided, the current matrix will be used." msgstr "역행렬을 계산할 행렬. 제공되지 않으면 현재 행렬이 사용됩니다." #: ../../matrix.rst e8077cac107d4551bdd9b1c1d14a4952 msgid "Return type" msgstr "반환 유형" #: ../../matrix.rst:132 db229e59a31b455b98ea5ccfa578122a msgid "" "Scaling in X-direction **(width)**. For example, a value of 0.5 performs " "a shrink of the **width** by a factor of 2. If a < 0, a left-right flip " "will (additionally) occur." msgstr "X 방향 **(너비)** 스케일링. 예를 들어, 0.5 값은 **너비** 를 2배로 축소합니다. a < 0이면 좌우 뒤집기가 (추가로) 발생합니다." #: ../../matrix.rst 6fcedf91827d4c289e6a645364d76ea6 #: 8654b40d08014804b0c0e8c304580291 96cbe6754a4b4f99bb7e0e80e180c0a6 #: afc20c369a9f4c739bc1f16197754859 c2c0c17a6a334d9daf1a246b0a95ca15 #: fab66c3105f3412b8e17b401ecfe57ab fceb1d67502e44b49baa260b088dd68f msgid "type" msgstr "유형" #: ../../matrix.rst:134 ../../matrix.rst:140 ../../matrix.rst:146 #: ../../matrix.rst:152 ../../matrix.rst:158 ../../matrix.rst:164 #: 137024cc37b74d68971a780ab821bb5c 20de69effd914f3f92727bc07f7de025 #: 5804209069a04b28ae858ceb0466f4d1 5b5b333b8cb346858ac4e11335709c2a #: 789de033d5c0443997dabc1c08157dbc 867fd680a9e9402583480286d03e27ca msgid "float" msgstr "float" #: ../../matrix.rst:138 c229f8ba4d804490b761e624fe313b6d msgid "" "Causes a shearing effect: each `Point(x, y)` will become `Point(x, y - " "b*x)`. Therefore, horizontal lines will be \"tilt\"." msgstr "기울이기 효과를 발생시킵니다: 각 `Point(x, y)` 는 `Point(x, y - b*x)` 가 됩니다. 따라서 수평선이 \"기울어집니다\"." #: ../../matrix.rst:144 7b98255d69974126bcf901feb1b268f6 msgid "" "Causes a shearing effect: each `Point(x, y)` will become `Point(x - c*y, " "y)`. Therefore, vertical lines will be \"tilt\"." msgstr "기울이기 효과를 발생시킵니다: 각 `Point(x, y)` 는 `Point(x - c*y, y)` 가 됩니다. 따라서 수직선이 \"기울어집니다\"." #: ../../matrix.rst:150 ac4f38489ad847b7827dcac0e26521a5 msgid "" "Scaling in Y-direction **(height)**. For example, a value of 1.5 performs" " a stretch of the **height** by 50%. If d < 0, an up-down flip will " "(additionally) occur." msgstr "Y 방향 **(높이)** 스케일링. 예를 들어, 1.5 값은 **높이** 를 50% 늘립니다. d < 0이면 상하 뒤집기가 (추가로) 발생합니다." #: ../../matrix.rst:156 9660c53c0df84ae99b72badb3989dddf msgid "" "Causes a horizontal shift effect: Each *Point(x, y)* will become *Point(x" " + e, y)*. Positive (negative) values of *e* will shift right (left)." msgstr "수평 이동 효과를 발생시킵니다: 각 *Point(x, y)* 는 *Point(x + e, y)* 가 됩니다. *e* 의 양수(음수) 값은 오른쪽(왼쪽)으로 이동합니다." #: ../../matrix.rst:162 96c71528239744f1b8cd967c2e46cb62 msgid "" "Causes a vertical shift effect: Each *Point(x, y)* will become *Point(x, " "y - f)*. Positive (negative) values of *f* will shift down (up)." msgstr "수직 이동 효과를 발생시킵니다: 각 *Point(x, y)* 는 *Point(x, y - f)* 가 됩니다. *f* 의 양수(음수) 값은 아래(위)로 이동합니다." #: ../../matrix.rst:168 fbbefd1680244e43b84002ed9a436dec msgid "" "Rectilinear means that no shearing is present and that any rotations are " "integer multiples of 90 degrees. Usually this is used to confirm that " "(axis-aligned) rectangles before the transformation are still axis-" "aligned rectangles afterwards." msgstr "직선형은 기울이기가 없고 모든 회전이 90도의 정수 배수임을 의미합니다. 일반적으로 이것은 변환 전의 (축 정렬) 사각형이 변환 후에도 여전히 축 정렬 사각형임을 확인하는 데 사용됩니다." #: ../../matrix.rst:170 36d4d94103214600af41eafe39212e90 msgid "bool" msgstr "bool" #: ../../matrix.rst:174 90ffe958045f48d090dba5ba44f73165 msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "이 클래스는 Python 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 액세스할 수도 있습니다. :ref:`SequenceTypes` 도 참조하세요." #: ../../matrix.rst:175 ae28f509b9434158ad3509b43fcadd26 msgid "" "Matrices can be used with arithmetic operators almost like ordinary " "numbers: they can be added, subtracted, multiplied or divided -- see " "chapter :ref:`Algebra`." msgstr "행렬은 일반 숫자처럼 산술 연산자와 함께 사용할 수 있습니다: 더하기, 빼기, 곱하기 또는 나누기를 할 수 있습니다 -- :ref:`Algebra` 장을 참조하세요." #: ../../matrix.rst:176 8bec4a086d304bbb9bfd022e4556dd29 msgid "" "Matrix multiplication is **not commutative** -- changing the sequence of " "the multiplicands will change the result in general. So it can quickly " "become unclear which result a transformation will yield." msgstr "행렬 곱셈은 **가환적이지 않습니다** -- 곱하는 순서를 변경하면 일반적으로 결과가 변경됩니다. 따라서 변환이 어떤 결과를 산출할지 빠르게 불명확해질 수 있습니다." #: ../../matrix.rst:180 281fd31e543c4617a40894e7ac37597e msgid "Examples" msgstr "예제" #: ../../matrix.rst:181 401084daabc9429b9009d38c9e0f2aec msgid "" "Here are examples that illustrate some of the achievable effects. All " "pictures show some text, inserted under control of some matrix and " "relative to a fixed reference point (the red dot)." msgstr "달성 가능한 효과 중 일부를 보여주는 예제입니다. 모든 그림은 일부 행렬의 제어 하에 삽입되고 고정된 참조점(빨간 점)을 기준으로 하는 일부 텍스트를 보여줍니다." #: ../../matrix.rst:183 ef95f7140bc84ceb80f3fe9cc5ffe0d2 msgid "The :ref:`Identity` matrix performs no operation." msgstr ":ref:`Identity` 행렬은 작업을 수행하지 않습니다." #: ../../matrix.rst:188 a80fc2a091374e8cb6815dfe8672bddd msgid "" "The scaling matrix `Matrix(2, 0.5)` stretches by a factor of 2 in " "horizontal, and shrinks by factor 0.5 in vertical direction." msgstr "스케일링 행렬 `Matrix(2, 0.5)` 는 수평으로 2배 늘리고 수직으로 0.5배 축소합니다." #: ../../matrix.rst:193 9699134c66a146af9068adb90948b8f2 msgid "" "Attributes :attr:`Matrix.e` and :attr:`Matrix.f` shift horizontally and, " "respectively vertically. In the following 10 to the right and 20 down." msgstr "속성 :attr:`Matrix.e` 및 :attr:`Matrix.f` 는 각각 수평 및 수직으로 이동합니다. 다음에서는 오른쪽으로 10, 아래로 20 이동합니다." #: ../../matrix.rst:198 168fe9a931a94651ac55f633dffbe987 msgid "A negative :attr:`Matrix.a` causes a left-right flip." msgstr "음수 :attr:`Matrix.a` 는 좌우 뒤집기를 발생시킵니다." #: ../../matrix.rst:203 f2cb4722af2e45f6ac67fda814935ea4 msgid "A negative :attr:`Matrix.d` causes an up-down flip." msgstr "음수 :attr:`Matrix.d` 는 상하 뒤집기를 발생시킵니다." #: ../../matrix.rst:208 28cc582a5ec24205816af0c892b692d1 msgid "Attribute :attr:`Matrix.b` tilts upwards / downwards along the x-axis." msgstr "속성 :attr:`Matrix.b` 는 x축을 따라 위/아래로 기울어집니다." #: ../../matrix.rst:213 a2b77644fc61456690d3603561dae948 msgid "Attribute :attr:`Matrix.c` tilts left / right along the y-axis." msgstr "속성 :attr:`Matrix.c` 는 y축을 따라 왼쪽/오른쪽으로 기울어집니다." #: ../../matrix.rst:218 bd842bfbd48b44509584185764d44373 msgid "" "Matrix `Matrix(beta)` performs counterclockwise rotations for positive " "angles `beta`." msgstr "행렬 `Matrix(beta)` 는 양수 각도 `beta` 에 대해 반시계 방향 회전을 수행합니다." #: ../../matrix.rst:223 ac0b2cc97b1347ab9f63fa8f97f50072 msgid "Show some effects on a rectangle::" msgstr "사각형에 대한 일부 효과 표시::" #: ../../footer.rst:46 2a49496b580540908297c502618954b2 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/module.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 62136ba5c5a74ecfa227336e448d62b5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 6fc9c3c622e84783910d3b11c3709f37 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 d611277d72c64dd99b3b9f2f8ec96367 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../module.rst:7 f33c4cbb9f05422084dddcddaf87949a msgid "Command line interface" msgstr "명령줄 인터페이스" #: ../../module.rst:9 9f557fd4350a42ed9a1df58860be9669 msgid "New in version 1.16.8" msgstr "버전 1.16.8의 새로운 기능" #: ../../module.rst:11 ecd7d23131464943807a4fb959173755 msgid "" "PyMuPDF can also be used from the command line to perform utility " "functions. This feature should obsolete writing some of the most basic " "scripts." msgstr "|PyMuPDF| 는 명령줄에서 유틸리티 함수를 수행하는 데에도 사용할 수 있습니다. 이 기능은 가장 기본적인 스크립트 작성 중 일부를 대체해야 합니다." #: ../../module.rst:13 20b8d208b65e4c74bf7ad83bfb388393 msgid "" "Admittedly, there is some functional overlap with the MuPDF CLI `mutool`." " On the other hand, PDF embedded files are no longer supported by MuPDF, " "so PyMuPDF is offering something unique here." msgstr "인정하건대, |MuPDF| CLI `mutool` 과 기능적 중복이 있습니다. 반면, PDF 임베디드 파일은 |MuPDF| 에서 더 이상 지원되지 않으므로, |PyMuPDF| 는 여기서 고유한 기능을 제공합니다." #: ../../module.rst:16 61944c3cbe72440580bdadeeb1269b75 msgid "Invocation" msgstr "호출" #: ../../module.rst:18 295dfa35e12a40d48e27c0055204d5a7 msgid "The command-line interface can be invoked in two ways." msgstr "명령줄 인터페이스는 두 가지 방법으로 호출할 수 있습니다." #: ../../module.rst:20 7177082a690146019882a6b232aa8853 msgid "Use the installed `pymupdf` command::" msgstr "설치된 `pymupdf` 명령을 사용합니다::" #: ../../module.rst:24 87e819afc653442caceed77952e1ed58 msgid "Or use Python's `-m` switch with PyMuPDF's `pymupdf` module::" msgstr "또는 |PyMuPDF| 의 `pymupdf` 모듈과 함께 Python의 `-m` 스위치를 사용합니다::" #: ../../module.rst:31 c1e7f23de6ef452a83faa31ed988d657 msgid "General remarks:" msgstr "일반 참고 사항:" #: ../../module.rst:33 fd3bac8dc3e9421eb2371c451ec1c3da msgid "" "Request help via `\"-h\"`, resp. command-specific help via `\"command " "-h\"`." msgstr "`\"-h\"` 를 통해 도움말을 요청하거나, `\"command -h\"` 를 통해 명령별 도움말을 요청합니다." #: ../../module.rst:34 dbd5a72f66d84df5b18b6bec2f4fd2f5 msgid "Parameters may be abbreviated where this does not introduce ambiguities." msgstr "모호함을 유발하지 않는 경우 매개변수를 축약할 수 있습니다." #: ../../module.rst:35 73cd69c626714f7aa1e084d11447cea6 msgid "" "Several commands support parameters `-pages` and `-xrefs`. They are " "intended for down-selection. Please note that:" msgstr "여러 명령은 `-pages` 및 `-xrefs` 매개변수를 지원합니다. 이들은 하위 선택을 위한 것입니다. 다음을 참고하세요:" #: ../../module.rst:37 7ff6972a285a4695baa4e4276641b755 msgid "**page numbers** for this utility must be given **1-based**." msgstr "이 유틸리티의 **페이지 번호** 는 **1부터 시작** 해야 합니다." #: ../../module.rst:38 b9688dc1937342d0a9ba2a88937c6d0a msgid "valid :data:`xref` numbers start at 1." msgstr "유효한 :data:`xref` 번호는 1부터 시작합니다." #: ../../module.rst:39 7c0c1890d37b41f6820770dd6bed4376 msgid "" "Specify a comma-separated list of either *single* integers or integer " "*ranges*. A **range** is a pair of integers separated by one hyphen " "\"-\". Integers must not exceed the maximum page, resp. xref number. To " "specify that maximum, the symbolic variable \"N\" may be used. Integers " "or ranges may occur several times, in any sequence and may overlap. If in" " a range the first number is greater than the second one, the respective " "items will be processed in reversed order." msgstr "*단일* 정수 또는 정수 *범위* 의 쉼표로 구분된 목록을 지정합니다. **범위** 는 하이픈 \"-\" 로 구분된 정수 쌍입니다. 정수는 최대 페이지(또는 xref 번호)를 초과하지 않아야 합니다. 최대값을 지정하려면 기호 변수 \"N\" 을 사용할 수 있습니다. 정수 또는 범위는 여러 번 발생할 수 있으며, 어떤 순서로든 발생할 수 있고 겹칠 수 있습니다. 범위에서 첫 번째 숫자가 두 번째 숫자보다 크면 해당 항목이 역순으로 처리됩니다." #: ../../module.rst:41 ee46edb0ea2b44e98364d207aaa2d1ef msgid "How to use the module inside your script::" msgstr "스크립트 내에서 모듈을 사용하는 방법::" #: ../../module.rst:50 123a2e5ad2564826b878adadaf638eeb msgid "" "Use the following 2-liner and compile it with `Nuitka " "`_ in standalone mode. This will give " "you a CLI executable with all the module's features, that can be used on " "all compatible platforms without Python, PyMuPDF or MuPDF being " "installed." msgstr "다음 2줄 코드를 사용하고 `Nuitka `_ 로 standalone 모드에서 컴파일합니다. 이것은 모듈의 모든 기능을 가진 CLI 실행 파일을 제공하며, Python, |PyMuPDF| 또는 |MuPDF| 가 설치되지 않은 모든 호환 플랫폼에서 사용할 수 있습니다." #: ../../module.rst:59 621c5379e7d44e29a5ae735c58352834 msgid "Cleaning and Copying" msgstr "정리 및 복사" #: ../../module.rst:63 a41c329fb87940c482d0805086ecc3cf msgid "" "This command will optimize the PDF and store the result in a new file. " "You can use it also for encryption, decryption and creating sub " "documents. It is mostly similar to the MuPDF command line utility " "*\"mutool clean\"*::" msgstr "이 명령은 PDF를 최적화하고 결과를 새 파일에 저장합니다. 암호화, 복호화 및 하위 문서 생성에도 사용할 수 있습니다. 이것은 |MuPDF| 명령줄 유틸리티 *\"mutool clean\"* 과 대부분 유사합니다::" #: ../../module.rst:96 95c61ecff9474da7a32002be18ff00b3 msgid "" "If you specify \"-pages\", be aware that only page-related objects are " "copied, **no document-level items** like e.g. embedded files." msgstr "\"-pages\" 를 지정하면 페이지 관련 객체만 복사되며, 예를 들어 임베디드 파일과 같은 **문서 레벨 항목은 복사되지 않습니다**." #: ../../module.rst:98 958ae9bd4e2244ae9cbb5d24a62a8c94 msgid "Please consult :meth:`Document.save` for the parameter meanings." msgstr "매개변수 의미는 :meth:`Document.save` 를 참조하세요." #: ../../module.rst:102 5b59f04532e94259bf5b3ecd530ca408 msgid "Extracting Fonts and Images" msgstr "글꼴 및 이미지 추출" #: ../../module.rst:103 170896a4fb624362bfbd8172cf909da4 msgid "Extract fonts or images from selected PDF pages to a desired directory::" msgstr "선택한 PDF 페이지에서 글꼴 또는 이미지를 원하는 디렉토리로 추출합니다::" #: ../../module.rst:123 220fe33385e844f3928ec0625f051414 msgid "" "**Image filenames** are built according to the naming scheme: **\"img-" "xref.ext\"**, where \"ext\" is the extension associated with the image " "and \"xref\" the :data:`xref` of the image PDF object." msgstr "**이미지 파일명** 은 명명 체계에 따라 생성됩니다: **\"img-xref.ext\"**, 여기서 \"ext\" 는 이미지와 연결된 확장자이고 \"xref\" 는 이미지 PDF 객체의 :data:`xref` 입니다." #: ../../module.rst:125 d56994d8f2a8433280e4ef35819f2e7a msgid "" "**Font filenames** consist of the fontname and the associated extension. " "Any spaces in the fontname are replaced with hyphens \"-\"." msgstr "**글꼴 파일명** 은 글꼴 이름과 연결된 확장자로 구성됩니다. 글꼴 이름의 공백은 하이픈 \"-\" 로 대체됩니다." #: ../../module.rst:127 a8e1a30f5fde401d810825a6e3b01a09 msgid "The output directory must already exist." msgstr "출력 디렉토리는 이미 존재해야 합니다." #: ../../module.rst:129 f2bc1eaf74014a2c9c0473449a9e7b11 msgid "" "Except for output directory creation, this feature is **functionally " "equivalent** to and obsoletes `this script `_." msgstr "출력 디렉토리 생성 제외, 이 기능은 `이 스크립트 `_ 와 **기능적으로 동일** 하며 이를 대체합니다." #: ../../module.rst:133 b52a0c02382d4e9abbd491e7b26f50d8 msgid "Joining PDF Documents" msgstr "PDF 문서 결합" #: ../../module.rst:134 b52dba2292bb478f86d8bd2a68e72d49 msgid "To join several PDF files specify::" msgstr "여러 PDF 파일을 결합하려면 다음을 지정합니다::" #: ../../module.rst:153 e75a700cceee42eda662850bcb411254 msgid "" "Each input must be entered as **\"filename,password,pages\"**. Password " "and pages are optional." msgstr "각 입력은 **\"filename,password,pages\"** 형식으로 입력해야 합니다. 비밀번호와 페이지는 선택 사항입니다." #: ../../module.rst:154 5bbc4bbfbbe44ea29ce63dc28468ecde msgid "" "The password entry **is required** if the \"pages\" entry is used. If the" " PDF needs no password, specify two commas." msgstr "\"pages\" 항목을 사용하는 경우 비밀번호 항목이 **필수** 입니다. PDF에 비밀번호가 필요하지 않으면 두 개의 쉼표를 지정합니다." #: ../../module.rst:155 24124b66f3f9496c9cba03a6c3987619 msgid "" "The **\"pages\"** format is the same as explained at the top of this " "section." msgstr "**\"pages\"** 형식은 이 섹션 상단에서 설명한 것과 동일합니다." #: ../../module.rst:156 6c8cd3be3fd844a18d6859e34270344c msgid "" "Each input file is immediately closed after use. Therefore you can use " "one of them as output filename, and thus overwrite it." msgstr "각 입력 파일은 사용 후 즉시 닫힙니다. 따라서 그 중 하나를 출력 파일명으로 사용하여 덮어쓸 수 있습니다." #: ../../module.rst:159 62faf24e6a7143aca5c2f6d4d0a3bd13 msgid "Example: To join the following files" msgstr "예제: 다음 파일을 결합하려면" #: ../../module.rst:161 088838df3b2545f8801c172c3bc996f0 msgid "**file1.pdf:** all pages, back to front, no password" msgstr "**file1.pdf:** 모든 페이지, 뒤에서 앞으로, 비밀번호 없음" #: ../../module.rst:162 72f4cc0b55a64f16a43ce016fb9d46a0 msgid "**file2.pdf:** last page, first page, password: \"secret\"" msgstr "**file2.pdf:** 마지막 페이지, 첫 페이지, 비밀번호: \"secret\"" #: ../../module.rst:163 518dcf41451c4ab098ae80c98c705da7 msgid "**file3.pdf:** pages 5 to last, no password" msgstr "**file3.pdf:** 페이지 5부터 마지막까지, 비밀번호 없음" #: ../../module.rst:165 579e18430ffe47deaf32eb9b5bb856c7 msgid "and store the result as **output.pdf** enter this command:" msgstr "결과를 **output.pdf** 로 저장하려면 다음 명령을 입력합니다:" #: ../../module.rst:167 945d0c96b4b34fc782a86ae2fcf40aa5 msgid "" "``pymupdf join -o output.pdf file1.pdf,,N-1 file2.pdf,secret,N,1 " "file3.pdf,,5-N``" msgstr "``pymupdf join -o output.pdf file1.pdf,,N-1 file2.pdf,secret,N,1 file3.pdf,,5-N``" #: ../../module.rst:171 45664921245f42c09b294edb251048f5 msgid "Low Level Information" msgstr "저수준 정보" #: ../../module.rst:173 fdf3d7f12d914afe950de66d094693fa msgid "" "Display PDF internal information. Again, there are similarities to " "*\"mutool show\"*::" msgstr "PDF 내부 정보를 표시합니다. 다시 말하지만, *\"mutool show\"* 와 유사점이 있습니다::" #: ../../module.rst:194 ad5c07b578e24a87b4bdfa72f035288d msgid "Examples::" msgstr "예제::" #: ../../module.rst:243 a932285ed88f489cb35fb9fd00084410 msgid "Embedded Files Commands" msgstr "임베디드 파일 명령" #: ../../module.rst:245 22fe7451356d4b07a68f7b814a48f7db msgid "" "The following commands deal with embedded files -- which is a feature " "completely removed from MuPDF after v1.14, and hence from all its command" " line tools." msgstr "다음 명령은 임베디드 파일을 다룹니다 -- 이것은 v1.14 이후 |MuPDF| 에서 완전히 제거된 기능이며, 따라서 모든 명령줄 도구에서도 제거되었습니다." #: ../../module.rst:248 031889fce5ba40c8aa00dca7f543935f msgid "Information" msgstr "정보" #: ../../module.rst:250 923441e6e99c4679913ea9650bd321f3 msgid "Show the embedded file names (long or short format)::" msgstr "임베디드 파일 이름을 표시합니다(긴 형식 또는 짧은 형식)::" #: ../../module.rst:266 2938ace8fd974862bd2b852f6d01c1b5 msgid "Example::" msgstr "예제::" #: ../../module.rst:287 4b906057dfa84c65ba2f7b3875e76f45 msgid "Detailed output would look like this per entry::" msgstr "각 항목에 대한 상세 출력은 다음과 같습니다::" #: ../../module.rst:297 fa6b969dc09f4e7aa8ddad1a74b85f27 msgid "Extraction" msgstr "추출" #: ../../module.rst:299 b95b620ad9f548139f65380c81a609eb msgid "Extract an embedded file like this::" msgstr "다음과 같이 임베디드 파일을 추출합니다::" #: ../../module.rst:317 b425246653d244139ee6064fef0cce03 msgid "" "For details consult :meth:`Document.embfile_get`. Example (refer to " "previous section)::" msgstr "자세한 내용은 :meth:`Document.embfile_get` 을 참조하세요. 예제(이전 섹션 참조)::" #: ../../module.rst:323 beb7e7b57a2d40d7b80215a90a015016 msgid "Deletion" msgstr "삭제" #: ../../module.rst:324 a66d4e86731745edabc9c4f4e5e0bb9f msgid "Delete an embedded file like this::" msgstr "다음과 같이 임베디드 파일을 삭제합니다::" #: ../../module.rst:340 c7c9134eddaa4ad2b9672122f1aa8fe9 msgid "For details consult :meth:`Document.embfile_del`." msgstr "자세한 내용은 :meth:`Document.embfile_del` 을 참조하세요." #: ../../module.rst:343 8027d6ea455e4050ace1ead2c3a951fb msgid "Insertion" msgstr "삽입" #: ../../module.rst:344 05c0ffa1d1fd4495a04887a13fa6a0ff msgid "Add a new embedded file using this command::" msgstr "다음 명령을 사용하여 새 임베디드 파일을 추가합니다::" #: ../../module.rst:364 a3ce7e14c5a6493190e34f36253a7b11 msgid "" "*\"NAME\"* **must not** already exist in the PDF. For details consult " ":meth:`Document.embfile_add`." msgstr "*\"NAME\"* 은 PDF에 이미 존재해서는 **안 됩니다**. 자세한 내용은 :meth:`Document.embfile_add` 를 참조하세요." #: ../../module.rst:367 8b7188f7140248f2ace12ff2559a5810 msgid "Updates" msgstr "업데이트" #: ../../module.rst:368 bf7de82ffcc6488492d7f1ed813a78d7 msgid "Update an existing embedded file using this command::" msgstr "다음 명령을 사용하여 기존 임베디드 파일을 업데이트합니다::" #: ../../module.rst:393 dfb87b27e010457ea91a44ac1607508d msgid "" "Use this method to change meta-information of the file -- just omit the " "*\"PATH\"*. For details consult :meth:`Document.embfile_upd`." msgstr "이 메서드를 사용하여 파일의 메타 정보를 변경합니다 -- *\"PATH\"* 만 생략하면 됩니다. 자세한 내용은 :meth:`Document.embfile_upd` 를 참조하세요." #: ../../module.rst:397 9724107b71a3473586bf932f86556d37 msgid "Copying" msgstr "복사" #: ../../module.rst:398 320c9dfca9614ce1aad38deec15e2f14 msgid "Copy embedded files between PDFs::" msgstr "PDF 간에 임베디드 파일을 복사합니다::" #: ../../module.rst:422 4f474c3c92134dbf92a95d04287f6b7c msgid "Text Extraction" msgstr "텍스트 추출" #: ../../module.rst:423 10013955206643cdabf54b9427cf9162 msgid "New in v1.18.16" msgstr "v1.18.16의 새로운 기능" #: ../../module.rst:425 6175e1799fe14be7857049aacbf4f76e msgid "" "Extract text from arbitrary :ref:`supported " "documents` to a textfile. Currently, there are " "three output formatting modes available: simple, block sorting and " "reproduction of physical layout." msgstr "임의의 :ref:`지원 문서` 에서 텍스트 파일로 텍스트를 추출합니다. 현재 세 가지 출력 형식 모드가 사용 가능합니다: simple, block sorting 및 물리적 레이아웃 재현." #: ../../module.rst:427 104746a6d24348c085e4d1f05530f3c4 msgid "" "**Simple** text extraction reproduces all text as it appears in the " "document pages -- no effort is made to rearrange in any particular " "reading order." msgstr "**Simple** 텍스트 추출은 문서 페이지에 나타나는 대로 모든 텍스트를 재현합니다 -- 특정 읽기 순서로 재배열하려는 시도는 없습니다." #: ../../module.rst:428 46976f7ba91e4ed195d1d2970b450ce8 msgid "" "**Block sorting** sorts text blocks (as identified by MuPDF) by ascending" " vertical, then horizontal coordinates. This should be sufficient to " "establish a \"natural\" reading order for basic pages of text." msgstr "**Block sorting** 은 텍스트 블록(|MuPDF| 에 의해 식별됨)을 수직 좌표, 그 다음 수평 좌표의 오름차순으로 정렬합니다. 이것은 기본 텍스트 페이지에 대한 \"자연스러운\" 읽기 순서를 설정하는 데 충분해야 합니다." #: ../../module.rst:429 736d584551084ce0ae8db3ab132de413 msgid "" "**Layout** strives to reproduce the original appearance of the input " "pages. You can expect results like this (produced by the command `pymupdf" " gettext -pages 1 demo1.pdf`):" msgstr "**Layout** 은 입력 페이지의 원래 모양을 재현하려고 합니다. 다음과 같은 결과를 기대할 수 있습니다(`pymupdf gettext -pages 1 demo1.pdf` 명령으로 생성됨):" #: ../../module.rst:434 50eb59c01b5243e4a1beb240596e9fcf msgid "" "The \"gettext\" command offers a functionality similar to the CLI tool " "`pdftotext` by XPDF software, http://www.foolabs.com/xpdf/ -- this is " "especially true for \"layout\" mode, which combines that tool's `-layout`" " and `-table` options." msgstr "\"gettext\" 명령은 XPDF 소프트웨어의 CLI 도구 `pdftotext` (http://www.foolabs.com/xpdf/)와 유사한 기능을 제공합니다 -- 이것은 특히 해당 도구의 `-layout` 및 `-table` 옵션을 결합하는 \"layout\" 모드에 해당합니다." #: ../../module.rst:438 49563f540be445d984dba68ffffbfe02 msgid "" "After each page of the output file, a formfeed character, `hex(12)` is " "written -- even if the input page has no text at all. This behavior can " "be controlled via options." msgstr "출력 파일의 각 페이지 후에 폼피드 문자 `hex(12)` 가 기록됩니다 -- 입력 페이지에 텍스트가 전혀 없는 경우에도 마찬가지입니다. 이 동작은 옵션을 통해 제어할 수 있습니다." #: ../../module.rst:440 647dbf1080904cb5b86c438feafcb584 msgid "" "For \"layout\" mode, **only horizontal, left-to-right, top-to bottom** " "text is supported, other text is ignored. In this mode, text is also " "ignored, if its :data:`fontsize` is too small." msgstr "\"layout\" 모드의 경우, **수평, 왼쪽에서 오른쪽으로, 위에서 아래로** 텍스트만 지원되며 다른 텍스트는 무시됩니다. 이 모드에서 텍스트의 :data:`fontsize` 가 너무 작으면 텍스트도 무시됩니다." #: ../../module.rst:442 baeab1e7bac9497995324b659ebebf03 msgid "" "\"Simple\" and \"blocks\" mode in contrast output **all text** for any " "text size or orientation." msgstr "대조적으로 \"Simple\" 및 \"blocks\" 모드는 모든 텍스트 크기나 방향에 대해 **모든 텍스트** 를 출력합니다." #: ../../module.rst:444 8617ac5a55024a57b4b1d70bdb264ced msgid "Command::" msgstr "명령::" #: ../../module.rst:472 f1019c52949f4174acd4b9381a394601 msgid "" "Command options may be abbreviated as long as no ambiguities are " "introduced. So the following do the same:" msgstr "명령 옵션은 모호함을 유발하지 않는 한 축약할 수 있습니다. 따라서 다음은 동일합니다:" #: ../../module.rst:474 d70e9f44b99141809981474f2ff8b052 msgid "" "`... -output text.txt -noligatures -noformfeed -convert-white -grid 3 " "-extra-spaces ...`" msgstr "`... -output text.txt -noligatures -noformfeed -convert-white -grid 3 -extra-spaces ...`" #: ../../module.rst:475 07cb51f3b38747abbb4010f810490249 msgid "`... -o text.txt -nol -nof -c -g 3 -e ...`" msgstr "`... -o text.txt -nol -nof -c -g 3 -e ...`" #: ../../module.rst:477 f16b9ac2c6c14bd5bb7fcea64f1fcd80 msgid "" "The output filename defaults to the input with its extension replaced by " "`.txt`. As with other commands, you can select page ranges **(caution: " "1-based!)** in `mutool` format, as indicated above." msgstr "출력 파일명은 기본적으로 입력 파일의 확장자가 `.txt` 로 대체된 것입니다. 다른 명령과 마찬가지로 위에서 표시한 대로 `mutool` 형식으로 페이지 범위를 선택할 수 있습니다 **(주의: 1부터 시작!)**." #: ../../module.rst:479 f23822348e0f44868acd1a434c638317 msgid "**mode:** (str) select a formatting mode -- default is \"layout\"." msgstr "**mode:** (str) 형식 모드를 선택합니다 -- 기본값은 \"layout\" 입니다." #: ../../module.rst:480 34f6f03b6b7c4d14b5b53d480ad19652 msgid "" "**noligatures:** (bool) corresponds to **not** " ":data:`TEXT_PRESERVE_LIGATURES`. If specified, ligatures (present in " "advanced fonts: glyphs combining multiple characters like \"fi\") are " "split up into their components (i.e. \"f\", \"i\"). Default is passing " "them through." msgstr "**noligatures:** (bool) :data:`TEXT_PRESERVE_LIGATURES` 를 **사용하지 않는** 것에 해당합니다. 지정하면 합자(고급 글꼴에 있음: \"fi\" 와 같은 여러 문자를 결합하는 글리프)가 구성 요소(즉, \"f\", \"i\")로 분할됩니다. 기본값은 통과시킵니다." #: ../../module.rst:481 7ad52df691114a03bf07a72f2434d4a9 msgid "" "**convert-white:** corresponds to **not** " ":data:`TEXT_PRESERVE_WHITESPACE`. If specified, all white space " "characters (like tabs) are replaced with one or more spaces. Default is " "passing them through." msgstr "**convert-white:** :data:`TEXT_PRESERVE_WHITESPACE` 를 **사용하지 않는** 것에 해당합니다. 지정하면 모든 공백 문자(탭 등)가 하나 이상의 공백으로 대체됩니다. 기본값은 통과시킵니다." #: ../../module.rst:482 b925a23489d24b3396cf53888050c32d msgid "" "**extra-spaces:** (bool) corresponds to **not** " ":data:`TEXT_INHIBIT_SPACES`. If specified, large gaps between adjacent " "characters will be filled with one or more spaces. Default is off." msgstr "**extra-spaces:** (bool) :data:`TEXT_INHIBIT_SPACES` 를 **사용하지 않는** 것에 해당합니다. 지정하면 인접 문자 사이의 큰 간격이 하나 이상의 공백으로 채워집니다. 기본값은 꺼짐입니다." #: ../../module.rst:483 9d95e72389b3445ba510fb682107c642 msgid "" "**noformfeed:** (bool) instead of `hex(12)` (formfeed), write linebreaks" " ``\\n`` at end of output pages." msgstr "**noformfeed:** (bool) `hex(12)` (폼피드) 대신 출력 페이지 끝에 줄바꿈 ``\\n`` 을 씁니다." #: ../../module.rst:484 703f5774d5234679a03f67da753bc40a msgid "**skip-empty:** (bool) skip pages with no text." msgstr "**skip-empty:** (bool) 텍스트가 없는 페이지를 건너뜁니다." #: ../../module.rst:485 8f19a7610cc64fc88819c1b7fc295330 msgid "" "**grid:** lines with a vertical coordinate difference of no more than " "this value (in points) will be merged into the same output line. Only " "relevant for \"layout\" mode. **Use with care:** 3 or the default 2 " "should be adequate in most cases. If **too large**, lines that are " "*intended* to be different in the original may be merged and will result " "in garbled and / or incomplete output. If **too low**, artifact separate " "output lines may be generated for some spans in the input line, just " "because they are coded in a different font with slightly deviating " "properties." msgstr "**grid:** 이 값(포인트 단위) 이하의 수직 좌표 차이를 가진 줄이 동일한 출력 줄로 병합됩니다. \"layout\" 모드에만 관련됩니다. **주의해서 사용하세요:** 대부분의 경우 3 또는 기본값 2가 적절합니다. **너무 크면**, 원본에서 *의도적으로* 다른 줄이 병합되어 왜곡되거나 불완전한 출력이 발생할 수 있습니다. **너무 낮으면**, 약간 다른 속성을 가진 다른 글꼴로 코딩되어 있기 때문에 입력 줄의 일부 범위에 대해 인공적인 별도 출력 줄이 생성될 수 있습니다." #: ../../module.rst:486 eac14db14ad14562a3b3b10a76827016 msgid "" "**fontsize:** include text with :data:`fontsize` larger than this value " "only (default 3). Only relevant for \"layout\" option." msgstr "**fontsize:** 이 값보다 큰 :data:`fontsize` 를 가진 텍스트만 포함합니다(기본값 3). \"layout\" 옵션에만 관련됩니다." #: ../../footer.rst:46 bf24bcacdf454aba8a6c79d83a00209b msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/outline.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 bbc8f87339104f1898b46c688e53d1bf msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 c349cfed692041d1831e68981b1432f3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 ccc1347133a5468990182905e2e49042 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../outline.rst:7 ac9aff233a8946e286c95d2a2f9a8e13 msgid "Outline" msgstr "Outline" #: ../../outline.rst:9 7a3be59ed3114a5c8bffd3f17bbb2211 msgid "" "The document outline (otherwise known as \"bookmarks\") is a property of " ":ref:`Document` (see :attr:`Document.outline`). If not ``None``, it " "stands for the first outline item of the document. Its properties in turn" " define the characteristics of this item and also point to other outline " "items in \"horizontal\" or downward direction. The full tree of all " "outline items for e.g. a conventional table of contents (TOC) can be " "recovered by following these \"pointers\"." msgstr "문서 개요(또는 \"북마크\"라고도 함)는 :ref:`Document` 의 속성입니다(:attr:`Document.outline` 참조). ``None`` 이 아니면 문서의 첫 번째 개요 항목을 나타냅니다. 그 속성은 이 항목의 특성을 정의하고 \"수평\" 또는 아래 방향으로 다른 개요 항목을 가리킵니다. 예를 들어 일반적인 목차(TOC)의 모든 개요 항목의 전체 트리는 이러한 \"포인터\"를 따라 복구할 수 있습니다." #: ../../outline.rst:12 b45a2c09637c4f3e9d2b01f1ba92a39f msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../outline.rst:12 47ad240edf4f474fa4acbc5fda0372cb msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../outline.rst:14 be403d58c4de4b12a011b9ed0d0e543f msgid ":attr:`Outline.down`" msgstr ":attr:`Outline.down`" #: ../../outline.rst:14 247939926687419fbfef8ca1aca02f0d msgid "next item downwards" msgstr "아래로 다음 항목" #: ../../outline.rst:15 96c69672ce3043259545e0e655eb91db msgid ":attr:`Outline.next`" msgstr ":attr:`Outline.next`" #: ../../outline.rst:15 4a5f23f96cf749c7872473b681590785 msgid "next item same level" msgstr "같은 레벨의 다음 항목" #: ../../outline.rst:16 c573402a06284cd492bec3c1d27d1e3d msgid ":attr:`Outline.page`" msgstr ":attr:`Outline.page`" #: ../../outline.rst:16 506be6a2e42d4302bdbc7b4e28e2394d msgid "page number (0-based)" msgstr "페이지 번호(0부터 시작)" #: ../../outline.rst:17 f119da14666b4fd3b371cf4ffc3e472a msgid ":attr:`Outline.title`" msgstr ":attr:`Outline.title`" #: ../../outline.rst:17 76ae4b21a6a6447da64b2d5e96423ea6 msgid "title" msgstr "제목" #: ../../outline.rst:18 a5fad59c22974e90b9ea8aad24218452 msgid ":attr:`Outline.uri`" msgstr ":attr:`Outline.uri`" #: ../../outline.rst:18 841c94119419481b8d836018ece01af9 msgid "string further specifying outline target" msgstr "개요 대상을 추가로 지정하는 문자열" #: ../../outline.rst:19 8cfeb148873e49c09a78d54e1a2f77c6 msgid ":attr:`Outline.is_external`" msgstr ":attr:`Outline.is_external`" #: ../../outline.rst:19 8a8f02b1287645c8905eec8793a1b5b6 msgid "target outside document" msgstr "문서 외부 대상" #: ../../outline.rst:20 5de9d126a21d480a9e1ca3476bebb4d3 msgid ":attr:`Outline.is_open`" msgstr ":attr:`Outline.is_open`" #: ../../outline.rst:20 7fc18da2ba4d4cbe9f3b2a82d39f02da msgid "whether sub-outlines are open or collapsed" msgstr "하위 개요가 열려 있는지 접혀 있는지 여부" #: ../../outline.rst:21 6aa64d2eff674fa2890310aecbb14167 msgid ":attr:`Outline.dest`" msgstr ":attr:`Outline.dest`" #: ../../outline.rst:21 0a87f99431e642139f4b43d536359abe msgid "points to destination details object" msgstr "대상 세부 정보 객체를 가리킴" #: ../../outline.rst:24 5ed102082bf84d049ca1f0ce22437f31 msgid "**Class API**" msgstr "**클래스 API**" #: ../../outline.rst:30 7b0ddca9a47d4e648ebdab93710cb150 msgid "" "The next outline item on the next level down. Is ``None`` if the item has" " no children." msgstr "다음 레벨의 다음 개요 항목. 항목에 자식이 없으면 ``None`` 입니다." #: ../../outline.rst 057e37ce84814a1c8c344aab938047f2 #: 1e93414e062d488e892d2f22750666de 76ab3bd1d70641f185a95f718ad0bb69 #: 7bd6079115d0441a82b8de2daaa1f4f9 9ecaaca5f8fd42c5b695d3f7ac9a5477 #: bc6ef4078c8a4c91a859ae4437517df7 e5dc2bd2705743d59033178491288a7a #: ea89654da5734c92aa2797336d8dfbc6 msgid "type" msgstr "유형" #: ../../outline.rst:32 8b64d66496a54db0908a0f6af0d7969e msgid ":ref:`Outline`" msgstr ":ref:`Outline`" #: ../../outline.rst:36 b8f40bec44ec498a866b8b610465788d msgid "" "The next outline item at the same level as this item. Is ``None`` if this" " is the last one in its level." msgstr "이 항목과 같은 레벨의 다음 개요 항목. 이것이 해당 레벨의 마지막 항목이면 ``None`` 입니다." #: ../../outline.rst:38 78788e777e334a73bb007bf2b10702b8 msgid "`Outline`" msgstr "`Outline`" #: ../../outline.rst:42 e0f2f185ffc545688e36397b2ab22051 msgid "The page number (0-based) this bookmark points to." msgstr "이 북마크가 가리키는 페이지 번호(0부터 시작)." #: ../../outline.rst:44 f47207285d9f4747a109ad0f93928b78 msgid "int" msgstr "int" #: ../../outline.rst:48 53ed66d010ce46c8a8afa6580844ac5d msgid "The item's title as a string or ``None``." msgstr "항목의 제목(문자열) 또는 ``None``." #: ../../outline.rst:50 ../../outline.rst:83 f43c0734193d4aedae69249948755e99 #: fc9bbc88a2e842c090ac4d2ea7adf221 msgid "str" msgstr "str" #: ../../outline.rst:54 d0a15fed61c5446e815f91424b141eab msgid "" "Indicator showing whether any sub-outlines should be expanded (``True``) " "or be collapsed (``False``). This information is interpreted by PDF " "reader software." msgstr "하위 개요가 확장되어야 하는지(``True``) 접혀야 하는지(``False``)를 나타내는 표시기입니다. 이 정보는 PDF 리더 소프트웨어에 의해 해석됩니다." #: ../../outline.rst:56 ../../outline.rst:62 1e2367a870064e0ab9fefe235f8f9199 #: 309c517aaa49400181d997b03fb6d487 msgid "bool" msgstr "bool" #: ../../outline.rst:60 eabf7026067444bd881e44370ac424e5 msgid "" "A bool specifying whether the target is outside (``True``) of the current" " document." msgstr "대상이 현재 문서 외부(``True``)인지 여부를 지정하는 bool입니다." #: ../../outline.rst:66 6e1ed475f293437aa748d4d40f55bbc0 msgid "" "A string specifying the link target. The meaning of this property should " "be evaluated in conjunction with property `is_external`:" msgstr "링크 대상을 지정하는 문자열입니다. 이 속성의 의미는 `is_external` 속성과 함께 평가해야 합니다:" #: ../../outline.rst:70 048200e34ebe4f88b8f6ecdfad9e9724 msgid "" "`is_external` is true: ``uri`` points to some target outside the current " "PDF, which may be an internet resource (``uri`` starts with ``http://`` " "or similar), another file (``uri`` starts with ``file:`` or ``file://``) " "or some other service like an e-mail address (``uri`` starts with " "``mailto:``)." msgstr "`is_external` 이 true: ``uri`` 는 현재 PDF 외부의 대상을 가리키며, 인터넷 리소스(``uri`` 가 ``http://`` 또는 유사한 것으로 시작), 다른 파일(``uri`` 가 ``file:`` 또는 ``file://`` 로 시작) 또는 이메일 주소와 같은 기타 서비스(``uri`` 가 ``mailto:`` 로 시작)일 수 있습니다." #: ../../outline.rst:76 e2b37e452977480aadfbf5e2b8eb7ced msgid "" "`is_external` is false: ``uri`` will be `None` or point to an internal " "location. In case of PDF documents, this should either be *#nnnn* to " "indicate a 1-based (!) page number *nnnn*, or a named location. The " "format varies for other document types, for example " "\"../FixedDoc.fdoc#PG_2_LNK_1\" for page number 2 (1-based) in an XPS " "document." msgstr "`is_external` 이 false: ``uri`` 는 `None` 이거나 내부 위치를 가리킵니다. PDF 문서의 경우, 이것은 1부터 시작하는(!) 페이지 번호 *nnnn* 을 나타내는 *#nnnn* 이거나 이름이 지정된 위치여야 합니다. 형식은 다른 문서 유형에 따라 다릅니다. 예를 들어 XPS 문서의 페이지 번호 2(1부터 시작)의 경우 \"../FixedDoc.fdoc#PG_2_LNK_1\"입니다." #: ../../outline.rst:87 0774302e2b4a4cc5be36f90e97235665 msgid "The link destination details object." msgstr "링크 대상 세부 정보 객체." #: ../../outline.rst:89 2c95888d87c844888823cf7c4bfbdd8d msgid ":ref:`linkDest`" msgstr ":ref:`linkDest`" #: ../../footer.rst:46 3da3281d20a349b2afbe0ca6afa704a3 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/packaging.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 3c04d07515a94932a13a95ebeb03dd64 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 bfe728bc4ddc474bb035cd55e714eabf msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 cdf2aaae85c74803bd7026f6e124be96 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../packaging.rst:5 348e8764195645e2bf7ae0ae58e6672e msgid "Packaging for Linux distributions" msgstr "Linux 배포판용 패키징" #: ../../packaging.rst:9 cb613445a87e445abba22e57ddb58ec7 msgid "Requirements" msgstr "요구사항" #: ../../packaging.rst:11 b36b1e7d3fc94b0d9d5c31f4cae79c63 msgid "Python" msgstr "Python" #: ../../packaging.rst:12 4edcec2efc2d4308ad735f013faa422e msgid "MuPDF checkout (including submodules)." msgstr "|MuPDF| 체크아웃(서브모듈 포함)." #: ../../packaging.rst:13 c463c998f736479f892c6b4c57f77d89 msgid "PyMuPDF checkout." msgstr "|PyMuPDF| 체크아웃." #: ../../packaging.rst:14 dbadca79b99f4a80ace5240c78bde785 msgid "System packages listed in `scripts/sysinstall.py:g_sys_packages`." msgstr "`scripts/sysinstall.py:g_sys_packages` 에 나열된 시스템 패키지." #: ../../packaging.rst:15 760e1814501643e8ba68b67bc653f179 msgid "Python packages listed in `pyproject.toml`." msgstr "`pyproject.toml` 에 나열된 Python 패키지." #: ../../packaging.rst:17 7b5ae3db64eb472daed8e6bad3fbf7ac msgid "Extra requirements for running tests:" msgstr "테스트 실행을 위한 추가 요구사항:" #: ../../packaging.rst:19 c7033e7fd7804ba48daa32be3ccdaa7b msgid "Python packages listed in `scripts/gh_release.py:test_packages`." msgstr "`scripts/gh_release.py:test_packages` 에 나열된 Python 패키지." #: ../../packaging.rst:23 d087313018614125b4e745ef56fc63d1 msgid "General steps" msgstr "일반적인 단계" #: ../../packaging.rst:25 ff845be31dc6431c907ec57f88327d5f msgid "Build and install MuPDF:" msgstr "|MuPDF| 빌드 및 설치:" #: ../../packaging.rst:27 22584c396cc342bfba772fe8c81ac949 msgid "Install required system packages." msgstr "필요한 시스템 패키지를 설치합니다." #: ../../packaging.rst:28 f7c3f08a80c141d49a7a07a13474c1bb msgid "" "Run `make install-shared-python` on MuPDF's `Makefile` with at least " "these make variables:" msgstr "|MuPDF| 의 `Makefile` 에서 최소한 다음 make 변수를 사용하여 `make install-shared-python` 을 실행합니다:" #: ../../packaging.rst:31 9d49af42c3a74272b78d5e68b8a53863 msgid "`DESTDIR` set to the install directory, e.g. `/`." msgstr "`DESTDIR` 를 설치 디렉토리로 설정합니다. 예: `/`." #: ../../packaging.rst:33 c80bf2b5d6aa48a3ab8da81dcde780cb msgid "" "`prefix` set to location relative to DESTDIR, such as `/usr/local` or " "`/usr`. Must start with `/`." msgstr "`prefix` 를 DESTDIR에 상대적인 위치로 설정합니다. 예: `/usr/local` 또는 `/usr`. `/` 로 시작해야 합니다." #: ../../packaging.rst:35 11c2299023db4fb19e56a64ef4be5424 msgid "`USE_SYSTEM_LIBS=yes`." msgstr "`USE_SYSTEM_LIBS=yes`." #: ../../packaging.rst:36 1384b7538ae5481a97b504d24690c056 msgid "`HAVE_LEPTONICA=yes`." msgstr "`HAVE_LEPTONICA=yes`." #: ../../packaging.rst:37 06ed0058c43d461db82d505a23ca7094 msgid "`HAVE_TESSERACT=yes`." msgstr "`HAVE_TESSERACT=yes`." #: ../../packaging.rst:39 b3644dcc2c5943bf888d7f8e9dc9edcc msgid "Build and install PyMuPDF:" msgstr "|PyMuPDF| 빌드 및 설치:" #: ../../packaging.rst:42 dcf39ffe359c4c03b4de4f59838ee0f0 msgid "" "Run `pip install ./PyMuPDF` or `pip wheel ./PyMuPDF` with at least these " "environment variables:" msgstr "최소한 다음 환경 변수를 사용하여 `pip install ./PyMuPDF` 또는 `pip wheel ./PyMuPDF` 를 실행합니다:" #: ../../packaging.rst:46 93b07ed437f44924bb31820bb149fa1f msgid "" "`PYMUPDF_SETUP_MUPDF_BUILD=` (empty string) to prevent download and build" " of hard-coded MuPDF release." msgstr "`PYMUPDF_SETUP_MUPDF_BUILD=` (빈 문자열)을 설정하여 하드코딩된 |MuPDF| 릴리스의 다운로드 및 빌드를 방지합니다." #: ../../packaging.rst:49 9ca48e9bfca64481b10e5c28ce400a6a msgid "" "`CFLAGS`, `CXXFLAGS` and `LDFLAGS` set to allow visibility of the " "installed MuPDF headers and shared libraries." msgstr "`CFLAGS`, `CXXFLAGS` 및 `LDFLAGS` 를 설정하여 설치된 |MuPDF| 헤더 및 공유 라이브러리의 가시성을 허용합니다." #: ../../packaging.rst:52 4361b9dfe3094baeaee44b1e98a85735 msgid "Run PyMuPDF tests:" msgstr "|PyMuPDF| 테스트 실행:" #: ../../packaging.rst:54 31da2ee092e74396895c9811cd72275d msgid "Ensure required Python packages are available." msgstr "필요한 Python 패키지를 사용할 수 있는지 확인합니다." #: ../../packaging.rst:56 027bc04d851d4711a60c825c34fd582c msgid "Run `pytest -k \"not test_color_count and not test_3050\" PyMuPDF`" msgstr "`pytest -k \"not test_color_count and not test_3050\" PyMuPDF` 를 실행합니다" #: ../../packaging.rst:58 c29cbb8f2791439fb47faf2ea2080ca8 msgid "" "Test `test_color_count` is known fail if MuPDF is not built with " "PyMuPDF's custom config.h." msgstr "`test_color_count` 테스트는 |MuPDF| 가 |PyMuPDF| 의 사용자 정의 config.h로 빌드되지 않은 경우 실패하는 것으로 알려져 있습니다." #: ../../packaging.rst:59 366f92e009ee412b9ee326e53365c80b msgid "" "Test `test_3050` is known to fail if MuPDF is built without its own " "third-party libraries." msgstr "`test_3050` 테스트는 |MuPDF| 가 자체 서드파티 라이브러리 없이 빌드된 경우 실패하는 것으로 알려져 있습니다." #: ../../packaging.rst:63 dc265d226e3549d395d1ee9b84d7e9b7 msgid "Use of scripts/sysinstall.py" msgstr "scripts/sysinstall.py 사용" #: ../../packaging.rst:65 c5ccd53c72ae43e2a8514ab3361d7530 msgid "" "`scripts/sysinstall.py` provides a useful example of build, install and " "test commands that are known to to work, because it is run regularly by " "Github action `.github/workflows/test_sysinstall.yml`." msgstr "`scripts/sysinstall.py` 는 GitHub 액션 `.github/workflows/test_sysinstall.yml` 에 의해 정기적으로 실행되기 때문에 작동하는 것으로 알려진 빌드, 설치 및 테스트 명령의 유용한 예제를 제공합니다." #: ../../packaging.rst:69 82d7e8c0cbc44e7ba2c922716b3572df msgid "Run with `-h` or look at the doc-string to see detailed usage information." msgstr "`-h` 옵션으로 실행하거나 doc-string을 확인하여 자세한 사용 정보를 확인하세요." #: ../../packaging.rst:70 3e72131ea5f546a3b3328a8e07d2f12c msgid "It uses Debian-style `apt` commands to install system packages." msgstr "시스템 패키지를 설치하는 데 Debian 스타일의 `apt` 명령을 사용합니다." #: ../../packaging.rst:71 d7d9461807534464806ed713797d4c4a msgid "By default it assumes local git checkouts `mupdf/` and `PyMuPDF/`." msgstr "기본적으로 로컬 git 체크아웃 `mupdf/` 및 `PyMuPDF/` 를 가정합니다." #: ../../packaging.rst:73 ef0294479d1943c0b9a9320a2d3a26d5 msgid "" "To run a full build, install and test for both a local fake root and the " "system root:" msgstr "로컬 가짜 루트와 시스템 루트 모두에 대해 전체 빌드, 설치 및 테스트를 실행하려면:" #: ../../packaging.rst:81 541b01cd5c274ffdb287b2e4615b1dcc msgid "To see what commands would be run without actually running them:" msgstr "실제로 실행하지 않고 실행될 명령을 보려면:" #: ../../packaging.rst:89 a1980a6d8b4e4ff483c5461aa5c7c9a2 msgid "See also" msgstr "참고" #: ../../packaging.rst:92 8dfdf3477c0c47799dc0f20fc9645ebe msgid "" "`setup.py`'s initial doc-comment has detailed information about the " "environment variables used when building PyMuPDF." msgstr "`setup.py` 의 초기 doc-comment에는 |PyMuPDF| 를 빌드할 때 사용되는 환경 변수에 대한 자세한 정보가 포함되어 있습니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/page.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 e16c032122ad4e028bed74389ed639aa msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 9732656e336643c0a3688f6451a5d129 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF(및 기타) 문서의 데이터 추출, 분석, 변환 및 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8784bd6bb15a493cb1459dea2fd1c45d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../page.rst:7 ce1211f275594a9799c196eda5262e29 msgid "Page" msgstr "Page" #: ../../page.rst:9 521a22f6c2494b1d8774bbf21c40a438 msgid "" "Class representing a document page. A page object is created by " ":meth:`Document.load_page` or, equivalently, via indexing the document " "like `doc[n]` - it has no independent constructor." msgstr "" "문서 페이지를 나타내는 클래스. 페이지 객체는 :meth:`Document.load_page` 또는 동등하게 `doc[n]` 과 " "같이 문서를 인덱싱하여 생성됩니다 - 독립적인 생성자가 없습니다." #: ../../page.rst:11 926d97edf1a148ba86e31fc4a0907173 msgid "" "There is a parent-child relationship between a document and its pages. If" " the document is closed or deleted, all page objects (and their " "respective children, too) in existence will become unusable " "(\"orphaned\"): If a page property or method is being used, an exception " "is raised." msgstr "" "문서와 페이지 간에는 부모-자식 관계가 있습니다. 문서가 닫히거나 삭제되면 존재하는 모든 페이지 객체(및 각각의 자식도)가 사용 " "불가능해집니다(\"고아\"): 페이지 속성이나 메서드가 사용되면 예외가 발생합니다." #: ../../page.rst:13 63842982bdce4d8b9ab736778c00f188 msgid "" "Several page methods have a :ref:`Document` counterpart for convenience. " "At the end of this chapter you will find a synopsis." msgstr "편의를 위해 여러 페이지 메서드에는 :ref:`Document` 대응 항목이 있습니다. 이 장의 끝에서 요약을 찾을 수 있습니다." #: ../../page.rst:15 1002d10886004b41a5902ec4640a3912 msgid "" "Many times in this chapter we are using the term **coordinate**. It is of" " high importance to have at least a basic understanding of what that is " "and that you feel comfortable with the section :ref:`Coordinates`." msgstr "" "이 장에서 여러 번 **좌표** 라는 용어를 사용합니다. 그것이 무엇인지에 대한 기본적인 이해를 갖추고 " ":ref:`Coordinates` 섹션에 익숙해지는 것이 매우 중요합니다." #: ../../page.rst:18 e1df1b1166044863ac89785a4b65c771 msgid "Modifying Pages" msgstr "페이지 수정" #: ../../page.rst:19 6f307a8c6a02449cbfeb3416e092240f msgid "" "Changing page properties and adding or changing page content is available" " for PDF documents only." msgstr "페이지 속성 변경 및 페이지 콘텐츠 추가 또는 변경은 PDF 문서에서만 사용할 수 있습니다." #: ../../page.rst:21 d491d2d2fb334bafbb8919f76e2e8238 msgid "In a nutshell, this is what you can do with PyMuPDF:" msgstr "간단히 말하면, |PyMuPDF| 로 할 수 있는 것은 다음과 같습니다:" #: ../../page.rst:23 d90792749a9349219c93cc569263ed38 msgid "Modify page rotation and the visible part (\"cropbox\") of the page." msgstr "페이지 회전 및 페이지의 보이는 부분(\"cropbox\")을 수정합니다." #: ../../page.rst:24 58fd1c6d537c448fbd8f5d264a78c21d msgid "Insert images, other PDF pages, text and simple geometrical objects." msgstr "이미지, 다른 PDF 페이지, 텍스트 및 간단한 기하학적 객체를 삽입합니다." #: ../../page.rst:25 a12337916b2f4e5ab028230f71a556eb msgid "Add annotations and form fields." msgstr "주석 및 양식 필드를 추가합니다." #: ../../page.rst:29 11cc1d708f504056baa21c4fed8f0b94 msgid "" "Methods require coordinates (points, rectangles) to put content in " "desired places. Please be aware that these coordinates **must always** be" " provided relative to the **unrotated** page (since v1.17.0). The reverse" " is also true: except :attr:`Page.rect`, resp. :meth:`Page.bound` (both " "*reflect* when the page is rotated), all coordinates returned by methods " "and attributes pertain to the unrotated page." msgstr "" "원하는 위치에 콘텐츠를 배치하기 위해 좌표(점, 사각형)가 필요합니다. 이러한 좌표는 **항상** **회전되지 않은** 페이지를 " "기준으로 제공되어야 합니다(v1.17.0부터). 역도 마찬가지입니다: :attr:`Page.rect`, 각각 " ":meth:`Page.bound` (둘 다 페이지가 회전될 때 *반영* 됨)를 제외하고, 메서드와 속성에서 반환된 모든 좌표는 " "회전되지 않은 페이지에 해당합니다." #: ../../page.rst:31 56d8c3ede59e4cd6b94ed6b542aa071f msgid "" "So the returned value of e.g. :meth:`Page.get_image_bbox` will not change" " if you do a :meth:`Page.set_rotation`. The same is true for coordinates " "returned by :meth:`Page.get_text`, annotation rectangles, and so on. If " "you want to find out, where an object is located in **rotated " "coordinates**, multiply the coordinates with " ":attr:`Page.rotation_matrix`. There also is its inverse, " ":attr:`Page.derotation_matrix`, which you can use when interfacing with " "other readers, which may behave differently in this respect." msgstr "" "따라서 예를 들어 :meth:`Page.get_image_bbox` 의 반환 값은 :meth:`Page.set_rotation` 을" " 수행해도 변경되지 않습니다. :meth:`Page.get_text`, 주석 사각형 등에서 반환된 좌표도 마찬가지입니다. 객체가 " "**회전된 좌표** 에서 어디에 있는지 확인하려면 좌표에 :attr:`Page.rotation_matrix` 를 곱하세요. 역행렬인" " :attr:`Page.derotation_matrix` 도 있으며, 이 점에서 다르게 동작할 수 있는 다른 리더와 인터페이스할 때" " 사용할 수 있습니다." #: ../../page.rst:35 5495c71af02f4a8fb149edfa02294e00 msgid "" "If you add or update annotations, links or form fields on the page and " "immediately afterwards need to work with them (i.e. **without leaving the" " page**), you should reload the page using :meth:`Document.reload_page` " "before referring to these new or updated items." msgstr "" "페이지에 주석, 링크 또는 양식 필드를 추가하거나 업데이트하고 즉시 작업해야 하는 경우(즉, **페이지를 떠나지 않고**), 이러한" " 새 항목이나 업데이트된 항목을 참조하기 전에 :meth:`Document.reload_page` 를 사용하여 페이지를 다시 " "로드해야 합니다." #: ../../page.rst:37 5b62e6a60cbe406cb33ca34fdcdf3756 msgid "" "Reloading the page is generally recommended -- although not strictly " "required in all cases. However, some annotation and widget types have " "extended features in PyMuPDF compared to MuPDF. More of these extensions " "may also be added in the future." msgstr "" "페이지 다시 로드는 일반적으로 권장됩니다 -- 모든 경우에 엄격하게 필요하지는 않지만. 그러나 일부 주석 및 위젯 타입은 " "MuPDF와 비교하여 |PyMuPDF| 에서 확장 기능을 가지고 있습니다. 이러한 확장 기능이 더 추가될 수도 있습니다." #: ../../page.rst:39 9b46165bcb584587982fd25c63ab3c8a msgid "" "Releoading the page ensures all your changes have been fully applied to " "PDF structures, so you can safely create Pixmaps or successfully iterate " "over annotations, links and form fields." msgstr "" "페이지를 다시 로드하면 모든 변경 사항이 PDF 구조에 완전히 적용되므로 Pixmap을 안전하게 만들거나 주석, 링크 및 양식 " "필드를 성공적으로 반복할 수 있습니다." #: ../../page.rst:42 94074d33706748ee9033e7d4bb141a7a msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../page.rst:42 75670f2660794ca6a8f34c6abe09eeed msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../page.rst:44 93d8511e8ebf40a7b1b729cf36aa03d4 msgid ":meth:`Page.add_caret_annot`" msgstr ":meth:`Page.add_caret_annot`" #: ../../page.rst:44 fe25471b8e5b4df8b2c71ef4d98cfc43 msgid "PDF only: add a caret annotation" msgstr "PDF 전용: 캐럿 주석 추가" #: ../../page.rst:45 e3bdedcdb54b4c20aa6a621d8d977bcb msgid ":meth:`Page.add_circle_annot`" msgstr ":meth:`Page.add_circle_annot`" #: ../../page.rst:45 2bccbccc57b34072ada8dedb56d423c3 msgid "PDF only: add a circle annotation" msgstr "PDF 전용: 원형 주석 추가" #: ../../page.rst:46 1b1436b811974ae8af7345271edb8298 msgid ":meth:`Page.add_file_annot`" msgstr ":meth:`Page.add_file_annot`" #: ../../page.rst:46 616bbd5f9f334dd4a3b026d3b6d8f8a6 msgid "PDF only: add a file attachment annotation" msgstr "PDF 전용: 파일 첨부 주석 추가" #: ../../page.rst:47 58a43a7d9941416683a8baa88d2b0274 msgid ":meth:`Page.add_freetext_annot`" msgstr ":meth:`Page.add_freetext_annot`" #: ../../page.rst:47 df78ea811bc646eb900266047ec923a3 msgid "PDF only: add a text annotation" msgstr "PDF 전용: 텍스트 주석 추가" #: ../../page.rst:48 60250ea28c6647cba024dc476244187f msgid ":meth:`Page.add_highlight_annot`" msgstr ":meth:`Page.add_highlight_annot`" #: ../../page.rst:48 702ae035409c46c5963108c602141009 msgid "PDF only: add a \"highlight\" annotation" msgstr "PDF 전용: \"강조\" 주석 추가" #: ../../page.rst:49 f8da534a97ec46fcabe2fa2776737a67 msgid ":meth:`Page.add_ink_annot`" msgstr ":meth:`Page.add_ink_annot`" #: ../../page.rst:49 492961a934c9486b9e9790906dc0363e msgid "PDF only: add an ink annotation" msgstr "PDF 전용: 잉크 주석 추가" #: ../../page.rst:50 5c700ca90cfb47c284dc5d12b68f87cf msgid ":meth:`Page.add_line_annot`" msgstr ":meth:`Page.add_line_annot`" #: ../../page.rst:50 3beaa2a61bfe4649b8072d9d7b3db5cf msgid "PDF only: add a line annotation" msgstr "PDF 전용: 선 주석 추가" #: ../../page.rst:51 8e3053db158f4cf4a38eaca8f62bf82e msgid ":meth:`Page.add_polygon_annot`" msgstr ":meth:`Page.add_polygon_annot`" #: ../../page.rst:51 c396774dd4ad430180ad8bcd7a870076 msgid "PDF only: add a polygon annotation" msgstr "PDF 전용: 다각형 주석 추가" #: ../../page.rst:52 899d9130f087402183b36be01e8fd467 msgid ":meth:`Page.add_polyline_annot`" msgstr ":meth:`Page.add_polyline_annot`" #: ../../page.rst:52 5b67d817b049400ca64fd45749d2a73a msgid "PDF only: add a multi-line annotation" msgstr "PDF 전용: 다중선 주석 추가" #: ../../page.rst:53 ac94a88db1a945ea8624710afea132e3 msgid ":meth:`Page.add_rect_annot`" msgstr ":meth:`Page.add_rect_annot`" #: ../../page.rst:53 c822265b995748939fb6f4e1cd832b4c msgid "PDF only: add a rectangle annotation" msgstr "PDF 전용: 사각형 주석 추가" #: ../../page.rst:54 00e37d1d767341c68663be9358ecc369 msgid ":meth:`Page.add_redact_annot`" msgstr ":meth:`Page.add_redact_annot`" #: ../../page.rst:54 eabcf1844b7c444286ffecdcc20508bc msgid "PDF only: add a redaction annotation" msgstr "PDF 전용: 수정 주석 추가" #: ../../page.rst:55 4c82f8bd39eb48039d304e70ecfcc40d msgid ":meth:`Page.add_squiggly_annot`" msgstr ":meth:`Page.add_squiggly_annot`" #: ../../page.rst:55 6424b91d9a5f4e938881c3daf0930076 msgid "PDF only: add a \"squiggly\" annotation" msgstr "PDF 전용: \"물결선\" 주석 추가" #: ../../page.rst:56 0deda877c85844bdb4116e19e446478b msgid ":meth:`Page.add_stamp_annot`" msgstr ":meth:`Page.add_stamp_annot`" #: ../../page.rst:56 60caeb4508d74196b16df227d730dcf9 msgid "PDF only: add a \"rubber stamp\" annotation" msgstr "PDF 전용: \"고무 도장\" 주석 추가" #: ../../page.rst:57 e9bca0a5a98842f6a9fa657758bbde00 msgid ":meth:`Page.add_strikeout_annot`" msgstr ":meth:`Page.add_strikeout_annot`" #: ../../page.rst:57 7c3096dd58da4af5a5c81213f8dcea99 msgid "PDF only: add a \"strike-out\" annotation" msgstr "PDF 전용: \"취소선\" 주석 추가" #: ../../page.rst:58 ec81831ff1a34e12933ad4fe97ddfc72 msgid ":meth:`Page.add_text_annot`" msgstr ":meth:`Page.add_text_annot`" #: ../../page.rst:58 6166e4c84976477ebbb37a08075be065 msgid "PDF only: add a comment" msgstr "PDF 전용: 주석 추가" #: ../../page.rst:59 9d9e5d56413243e7acd7bc42faea55a8 msgid ":meth:`Page.add_underline_annot`" msgstr ":meth:`Page.add_underline_annot`" #: ../../page.rst:59 0f3e21d031cd4faf9b37cb2a67940487 msgid "PDF only: add an \"underline\" annotation" msgstr "PDF 전용: \"밑줄\" 주석 추가" #: ../../page.rst:60 f5faa32f93624b2487038228f34de580 msgid ":meth:`Page.add_widget`" msgstr ":meth:`Page.add_widget`" #: ../../page.rst:60 cb151ecc51ab45a195811c7976e8e869 msgid "PDF only: add a PDF Form field" msgstr "PDF 전용: PDF 양식 필드 추가" #: ../../page.rst:61 7d757c5dccba4c0fb0941cead965caa8 msgid ":meth:`Page.annot_names`" msgstr ":meth:`Page.annot_names`" #: ../../page.rst:61 2af022e1891743f9a93104db2bad5f5e msgid "PDF only: a list of annotation (and widget) names" msgstr "PDF 전용: 주석(및 위젯) 이름 목록" #: ../../page.rst:62 460e33003788412a8f6af75cd5edeef8 msgid ":meth:`Page.annot_xrefs`" msgstr ":meth:`Page.annot_xrefs`" #: ../../page.rst:62 21f42a813f50480085c3e7d12ae51dde msgid "PDF only: a list of annotation (and widget) xrefs" msgstr "PDF 전용: 주석(및 위젯) xref 목록" #: ../../page.rst:63 fe26f7732fc64062b91138d4a3666ff1 msgid ":meth:`Page.annots`" msgstr ":meth:`Page.annots`" #: ../../page.rst:63 fa2bca1baaa34e9890095cfbad31d943 msgid "return a generator over the annots on the page" msgstr "페이지의 주석에 대한 생성자 반환" #: ../../page.rst:64 ef49a8b7ac1f42d7b517b2a72841b523 msgid ":meth:`Page.apply_redactions`" msgstr ":meth:`Page.apply_redactions`" #: ../../page.rst:64 6eec33ab83094db09f58d366751d135c msgid "PDF only: process the redactions of the page" msgstr "PDF 전용: 페이지의 수정 처리" #: ../../page.rst:65 fffafd8ac71f4946b8d34ddec143fb97 msgid ":meth:`Page.clip_to_rect`" msgstr ":meth:`Page.clip_to_rect`" #: ../../page.rst:65 6c00ecf81e9d421d8d4328df5552a335 msgid "PDF only: remove page content outside a rectangle" msgstr "PDF 전용: 사각형 외부의 페이지 콘텐츠 제거" #: ../../page.rst:66 bc10eac3335e4c7c8aa29962096a4851 msgid ":meth:`Page.bound`" msgstr ":meth:`Page.bound`" #: ../../page.rst:66 ../../page.rst:137 1f3d85fc4fa74bdaa0d5458534460fcf #: ff6962d922fd4757939ee93378e3df3a msgid "rectangle of the page" msgstr "페이지의 사각형" #: ../../page.rst:67 2f6ce14be7ed4e00b009b2eb52d0f7fa msgid ":meth:`Page.cluster_drawings`" msgstr ":meth:`Page.cluster_drawings`" #: ../../page.rst:67 aeca385ef2014bdeaae33e4d3e5405a9 msgid "PDF only: bounding boxes of vector graphics" msgstr "PDF 전용: 벡터 그래픽의 경계 상자" #: ../../page.rst:68 a3fd94d66c45439186fd3381996fa529 msgid ":meth:`Page.delete_annot`" msgstr ":meth:`Page.delete_annot`" #: ../../page.rst:68 fd8317c7a16c4ed3be5d0f91c39d36be msgid "PDF only: delete an annotation" msgstr "PDF 전용: 주석 삭제" #: ../../page.rst:69 9722279391474a879dbd9f2a7b590d84 msgid ":meth:`Page.delete_image`" msgstr ":meth:`Page.delete_image`" #: ../../page.rst:69 46b28a2de9974570ba0436618b032379 msgid "PDF only: delete an image" msgstr "PDF 전용: 이미지 삭제" #: ../../page.rst:70 203a1849b02a42c7a891f062cbf52dfb msgid ":meth:`Page.delete_link`" msgstr ":meth:`Page.delete_link`" #: ../../page.rst:70 ccf68e485ea740aea4e49e3cbf147821 msgid "PDF only: delete a link" msgstr "PDF 전용: 링크 삭제" #: ../../page.rst:71 0d872d8700894747baf6717b43854f1b msgid ":meth:`Page.delete_widget`" msgstr ":meth:`Page.delete_widget`" #: ../../page.rst:71 ce302a0aa96f4ec28810acfee891e36f msgid "PDF only: delete a widget / field" msgstr "PDF 전용: 위젯/필드 삭제" #: ../../page.rst:72 f63490db0707495f85356a222d8f2e01 msgid ":meth:`Page.draw_bezier`" msgstr ":meth:`Page.draw_bezier`" #: ../../page.rst:72 eff1fa903b8d443e887dc9aec924ce87 msgid "PDF only: draw a cubic Bezier curve" msgstr "PDF 전용: 3차 베지어 곡선 그리기" #: ../../page.rst:73 8877a067ebb5495db7bf91973ac843de msgid ":meth:`Page.draw_circle`" msgstr ":meth:`Page.draw_circle`" #: ../../page.rst:73 0249f749cc04468db32846e3a91847b1 msgid "PDF only: draw a circle" msgstr "PDF 전용: 원 그리기" #: ../../page.rst:74 c84553f9888048eab99f9cad82c5ab51 msgid ":meth:`Page.draw_curve`" msgstr ":meth:`Page.draw_curve`" #: ../../page.rst:74 e32a35018a0848c99f5c79513317c3d2 msgid "PDF only: draw a special Bezier curve" msgstr "PDF 전용: 특수 베지어 곡선 그리기" #: ../../page.rst:75 5e4b7f8682084254b71c7302e1dbdd0f msgid ":meth:`Page.draw_line`" msgstr ":meth:`Page.draw_line`" #: ../../page.rst:75 d490933be5ca4395aa5c2fd0582ce268 msgid "PDF only: draw a line" msgstr "PDF 전용: 선 그리기" #: ../../page.rst:76 05641267e0cf4d989f5f26ad935ec02b msgid ":meth:`Page.draw_oval`" msgstr ":meth:`Page.draw_oval`" #: ../../page.rst:76 86a9acc6ccaa4d4280f3c3fc4d7e9ff6 msgid "PDF only: draw an oval / ellipse" msgstr "PDF 전용: 타원 그리기" #: ../../page.rst:77 7a3e2be1ddbb41129d4bb8af04a06aca msgid ":meth:`Page.draw_polyline`" msgstr ":meth:`Page.draw_polyline`" #: ../../page.rst:77 97a5670624784f5e918844be3bd01770 msgid "PDF only: connect a point sequence" msgstr "PDF 전용: 점 시퀀스 연결" #: ../../page.rst:78 71f0edeccebb43d5bb0ecc5da8e92d7b msgid ":meth:`Page.draw_quad`" msgstr ":meth:`Page.draw_quad`" #: ../../page.rst:78 2e390549e54b44b6b7711dc9cc895e16 msgid "PDF only: draw a quad" msgstr "PDF 전용: 사각형 그리기" #: ../../page.rst:79 635ad324729b4b01bbd2afc6fe1d7bdd msgid ":meth:`Page.draw_rect`" msgstr ":meth:`Page.draw_rect`" #: ../../page.rst:79 4150b075ab48434881a4be110c6fcbf0 msgid "PDF only: draw a rectangle" msgstr "PDF 전용: 사각형 그리기" #: ../../page.rst:80 cb18274299ec498384ab4c12af0a38e9 msgid ":meth:`Page.draw_sector`" msgstr ":meth:`Page.draw_sector`" #: ../../page.rst:80 5239a2bc5fc34be584b6589ae4741cc4 msgid "PDF only: draw a circular sector" msgstr "PDF 전용: 원형 섹터 그리기" #: ../../page.rst:81 caaaee7ecb354309a8dc66d853b4c91f msgid ":meth:`Page.draw_squiggle`" msgstr ":meth:`Page.draw_squiggle`" #: ../../page.rst:81 72295b9e8a63496b88094039ffbcde6a msgid "PDF only: draw a squiggly line" msgstr "PDF 전용: 물결선 그리기" #: ../../page.rst:82 49b04744785948b19597a93786497023 msgid ":meth:`Page.draw_zigzag`" msgstr ":meth:`Page.draw_zigzag`" #: ../../page.rst:82 3f21f5eb09354117ad1a536bf3da91fa msgid "PDF only: draw a zig-zagged line" msgstr "PDF 전용: 지그재그 선 그리기" #: ../../page.rst:83 fd9907fef5ad4079a071161d66b17561 msgid ":meth:`Page.find_tables`" msgstr ":meth:`Page.find_tables`" #: ../../page.rst:83 7c12def340ca4445bb3e0f6f3a4119a4 msgid "locate tables on the page" msgstr "페이지에서 테이블 찾기" #: ../../page.rst:84 a705386990574b03a0bb5107e2990478 msgid ":meth:`Page.get_drawings`" msgstr ":meth:`Page.get_drawings`" #: ../../page.rst:84 116ff841fb514d4288112879d23c244f msgid "get vector graphics on page" msgstr "페이지의 벡터 그래픽 가져오기" #: ../../page.rst:85 ../../page.rst:2355 5513869a670140a886b0de7e86105fcc #: 89d76a9e191948898a7d4ddcb3108546 msgid ":meth:`Page.get_fonts`" msgstr ":meth:`Page.get_fonts`" #: ../../page.rst:85 b623d469785e471aa3c1cb2902c44f17 msgid "PDF only: get list of referenced fonts" msgstr "PDF 전용: 참조된 폰트 목록 가져오기" #: ../../page.rst:86 032b7938c6354a188828b99422ce4c1b msgid ":meth:`Page.get_image_bbox`" msgstr ":meth:`Page.get_image_bbox`" #: ../../page.rst:86 de0cdf60868d4940a19846bc5c338aa9 msgid "PDF only: get bbox and matrix of embedded image" msgstr "PDF 전용: 임베디드 이미지의 bbox 및 행렬 가져오기" #: ../../page.rst:87 ea32423fb45a4c829c831fa0302cf4a2 msgid ":meth:`Page.get_image_info`" msgstr ":meth:`Page.get_image_info`" #: ../../page.rst:87 458efa2ccf404e7ab44490f1f0a7eebc msgid "get list of meta information for all used images" msgstr "사용된 모든 이미지의 메타 정보 목록 가져오기" #: ../../page.rst:88 bef50d6ac750452f87453cddca373460 msgid ":meth:`Page.get_image_rects`" msgstr ":meth:`Page.get_image_rects`" #: ../../page.rst:88 0639d98f4696403bab4435ac71e37c56 msgid "PDF only: improved version of :meth:`Page.get_image_bbox`" msgstr "PDF 전용: :meth:`Page.get_image_bbox` 의 개선된 버전" #: ../../page.rst:89 ../../page.rst:2356 2737569248454d5aad0880abcf86d7ce #: 417ddc69f2e84248a5cc652040dc362c msgid ":meth:`Page.get_images`" msgstr ":meth:`Page.get_images`" #: ../../page.rst:89 a0e5ded6cdd146ebb2b5ad6dab673250 msgid "PDF only: get list of referenced images" msgstr "PDF 전용: 참조된 이미지 목록 가져오기" #: ../../page.rst:90 2c2d56778e154346acc5ed92bd33e033 msgid ":meth:`Page.get_label`" msgstr ":meth:`Page.get_label`" #: ../../page.rst:90 8b80f3ad7a864cd496aa891acc3e790a msgid "PDF only: return the label of the page" msgstr "PDF 전용: 페이지의 레이블 반환" #: ../../page.rst:91 5cd06210bb4d47c695294ecea67435ab msgid ":meth:`Page.get_links`" msgstr ":meth:`Page.get_links`" #: ../../page.rst:91 5a062b7c81f344cda0c16b1a005477d7 msgid "get all links" msgstr "모든 링크 가져오기" #: ../../page.rst:92 ../../page.rst:2357 79dd679c248f4983b29496e8e988c628 #: a4bee007c0454a16ad4e26642efefb05 msgid ":meth:`Page.get_pixmap`" msgstr ":meth:`Page.get_pixmap`" #: ../../page.rst:92 1b658d01635b4251a718775d4f5a25b3 msgid "create a page image in raster format" msgstr "래스터 형식의 페이지 이미지 생성" #: ../../page.rst:93 9f1ce6858bce466ebc9ff6ab0f07cf7b msgid ":meth:`Page.get_svg_image`" msgstr ":meth:`Page.get_svg_image`" #: ../../page.rst:93 67e50df05e064d1a82bed624b6647b09 msgid "create a page image in SVG format" msgstr "SVG 형식의 페이지 이미지 생성" #: ../../page.rst:94 ../../page.rst:2358 269ce650459d43218f8f2c39da827d08 #: b9169e61ebdd41fbb8a7c9e3c26d9ce4 msgid ":meth:`Page.get_text`" msgstr ":meth:`Page.get_text`" #: ../../page.rst:94 a8aaa066102c47ccaafb71449455ec6a msgid "extract the page's text" msgstr "페이지의 텍스트 추출" #: ../../page.rst:95 2721ffbd14ab4c188f8d29ee0333a13d msgid ":meth:`Page.get_textbox`" msgstr ":meth:`Page.get_textbox`" #: ../../page.rst:95 12e56111e26244c3b479f67f2a1f1e59 msgid "extract text contained in a rectangle" msgstr "사각형에 포함된 텍스트 추출" #: ../../page.rst:96 da2862c13a76447d8300c492453071f2 msgid ":meth:`Page.get_textpage_ocr`" msgstr ":meth:`Page.get_textpage_ocr`" #: ../../page.rst:96 a94a6c9143a344d6aa67d522fa588026 msgid "create a TextPage with OCR for the page" msgstr "페이지에 대한 OCR이 포함된 TextPage 생성" #: ../../page.rst:97 6a3ac7a182f44d7fa7a198b16825777d msgid ":meth:`Page.get_textpage`" msgstr ":meth:`Page.get_textpage`" #: ../../page.rst:97 3a2ff15016b94cbda54e0a7e342cdca8 msgid "create a TextPage for the page" msgstr "페이지에 대한 TextPage 생성" #: ../../page.rst:98 42257e13df044823b5ada20df4cc1f65 msgid ":meth:`Page.get_xobjects`" msgstr ":meth:`Page.get_xobjects`" #: ../../page.rst:98 dac370a551e94fd1845762ed141b934c msgid "PDF only: get list of referenced xobjects" msgstr "PDF 전용: 참조된 xobjects 목록 가져오기" #: ../../page.rst:99 b455e5d5c0aa4fa7843f679e55dbaf6a msgid ":meth:`Page.insert_font`" msgstr ":meth:`Page.insert_font`" #: ../../page.rst:99 ad790342de2c46229c73dbd2e8549b7d msgid "PDF only: insert a font for use by the page" msgstr "PDF 전용: 페이지에서 사용할 폰트 삽입" #: ../../page.rst:100 5769325361e9409291d2de6ff6a74a6f msgid ":meth:`Page.insert_image`" msgstr ":meth:`Page.insert_image`" #: ../../page.rst:100 5fee15b23dc84739b1ab8ce43e9a636a msgid "PDF only: insert an image" msgstr "PDF 전용: 이미지 삽입" #: ../../page.rst:101 4a6a82d58c03465dbdecd703f6d7f484 msgid ":meth:`Page.insert_link`" msgstr ":meth:`Page.insert_link`" #: ../../page.rst:101 b1e9b94b930141c0bcadb44dfd561924 msgid "PDF only: insert a link" msgstr "PDF 전용: 링크 삽입" #: ../../page.rst:102 17d5d051bd1d45369ac998a2122e0c62 msgid ":meth:`Page.insert_text`" msgstr ":meth:`Page.insert_text`" #: ../../page.rst:102 52672923fad14e51bd5e04a28212d35c msgid "PDF only: insert text" msgstr "PDF 전용: 텍스트 삽입" #: ../../page.rst:103 83ba971b1ba9461390deb0d1ab0402f2 msgid ":meth:`Page.insert_htmlbox`" msgstr ":meth:`Page.insert_htmlbox`" #: ../../page.rst:103 be5e2559a7d14e57954c56d970906946 msgid "PDF only: insert html text in a rectangle" msgstr "PDF 전용: 사각형에 HTML 텍스트 삽입" #: ../../page.rst:104 b3109af9729e40d58a40f4edaac0a175 msgid ":meth:`Page.insert_textbox`" msgstr ":meth:`Page.insert_textbox`" #: ../../page.rst:104 b350237b8a85495a94ab5623219b134f msgid "PDF only: insert a text box" msgstr "PDF 전용: 텍스트 상자 삽입" #: ../../page.rst:105 c688c4af2bb1464aa08e2abfed572208 msgid ":meth:`Page.links`" msgstr ":meth:`Page.links`" #: ../../page.rst:105 fa47810199534f1fac3e4acd7b50ea81 msgid "return a generator of the links on the page" msgstr "페이지의 링크에 대한 생성자 반환" #: ../../page.rst:106 a3a22a08c1c94e718b34bcf0a1c9cc37 msgid ":meth:`Page.load_annot`" msgstr ":meth:`Page.load_annot`" #: ../../page.rst:106 38655b86d4994aacbd28bf85316e1534 msgid "PDF only: load a specific annotation" msgstr "PDF 전용: 특정 주석 로드" #: ../../page.rst:107 eb4c07f56b864d108c056f82854b0931 msgid ":meth:`Page.load_widget`" msgstr ":meth:`Page.load_widget`" #: ../../page.rst:107 c9f0a660efb9401abb92c4ddd9071840 msgid "PDF only: load a specific field" msgstr "PDF 전용: 특정 필드 로드" #: ../../page.rst:108 352c9d2ca82d4804848c4e3b197af6d5 msgid ":meth:`Page.load_links`" msgstr ":meth:`Page.load_links`" #: ../../page.rst:108 e8427f8c37e04f1c835b369b5917501d msgid "return the first link on a page" msgstr "페이지의 첫 번째 링크 반환" #: ../../page.rst:109 75e71d2fde7b4ef69b2e3b82e8f29afe msgid ":meth:`Page.new_shape`" msgstr ":meth:`Page.new_shape`" #: ../../page.rst:109 2a0c8a834cc546f99d2419597b66e3ba msgid "PDF only: create a new :ref:`Shape`" msgstr "PDF 전용: 새 :ref:`Shape` 생성" #: ../../page.rst:110 a2c8cff536ca425ab1da46f6a5559b54 msgid ":meth:`Page.recolor`" msgstr ":meth:`Page.recolor`" #: ../../page.rst:110 ddc1dcc46bd94fa2ac362d97b7d7be96 msgid "PDF only: change the colorspace of objects" msgstr "PDF 전용: 객체의 색상 공간 변경" #: ../../page.rst:111 eb776ad9a91748fa9f4419c19c4b92d2 msgid ":meth:`Page.remove_rotation`" msgstr ":meth:`Page.remove_rotation`" #: ../../page.rst:111 a2c31954539c48b8b378628c2cc80e96 msgid "PDF only: set page rotation to 0" msgstr "PDF 전용: 페이지 회전을 0으로 설정" #: ../../page.rst:112 5057e96ed4734bcbb0133e7ead7a2cab msgid ":meth:`Page.replace_image`" msgstr ":meth:`Page.replace_image`" #: ../../page.rst:112 899c88d73da04ca586624e8dfd412b19 msgid "PDF only: replace an image" msgstr "PDF 전용: 이미지 교체" #: ../../page.rst:113 ../../page.rst:2359 71be303aad804ff5a6400acf38550aa4 #: a36ed4e43659431bb9a4bb520578acf9 msgid ":meth:`Page.search_for`" msgstr ":meth:`Page.search_for`" #: ../../page.rst:113 62c168ceff884befb1a78b7c8d7407e9 msgid "search for a string" msgstr "문자열 검색" #: ../../page.rst:114 8583ac949dd54261b60dc1fa600ba5ce msgid ":meth:`Page.set_artbox`" msgstr ":meth:`Page.set_artbox`" #: ../../page.rst:114 f3329d1a5c484f2085f8abfc485d69fd msgid "PDF only: modify `/ArtBox`" msgstr "PDF 전용: `/ArtBox` 수정" #: ../../page.rst:115 93b0c3cc50ba4ecba1d9f2ecd0b3516e msgid ":meth:`Page.set_bleedbox`" msgstr ":meth:`Page.set_bleedbox`" #: ../../page.rst:115 f3a89a8d724648b9a11cd098e2c87780 msgid "PDF only: modify `/BleedBox`" msgstr "PDF 전용: `/BleedBox` 수정" #: ../../page.rst:116 96033ab15bb242d9aebbedeb42f65c22 msgid ":meth:`Page.set_cropbox`" msgstr ":meth:`Page.set_cropbox`" #: ../../page.rst:116 5ebf1f7c5f2e4938b6071e31711528e4 msgid "PDF only: modify the :data:`cropbox` (visible page)" msgstr "PDF 전용: :data:`cropbox` (보이는 페이지) 수정" #: ../../page.rst:117 3c4547592e4148558c3bb7ef9328b953 msgid ":meth:`Page.set_mediabox`" msgstr ":meth:`Page.set_mediabox`" #: ../../page.rst:117 70664716c7b44846a2d23c4603794d75 msgid "PDF only: modify `/MediaBox`" msgstr "PDF 전용: `/MediaBox` 수정" #: ../../page.rst:118 c38c50f5998e43de9073f15108f0b4e9 msgid ":meth:`Page.set_rotation`" msgstr ":meth:`Page.set_rotation`" #: ../../page.rst:118 ef1b21b5d28947238b694a70d462305d msgid "PDF only: set page rotation" msgstr "PDF 전용: 페이지 회전 설정" #: ../../page.rst:119 6881608670ad44e593239c0b8ca65758 msgid ":meth:`Page.set_trimbox`" msgstr ":meth:`Page.set_trimbox`" #: ../../page.rst:119 b79cecdb274042aa9447129dc4256f28 msgid "PDF only: modify `/TrimBox`" msgstr "PDF 전용: `/TrimBox` 수정" #: ../../page.rst:120 5b977466d1964b72a80eee11dd8e3009 msgid ":meth:`Page.show_pdf_page`" msgstr ":meth:`Page.show_pdf_page`" #: ../../page.rst:120 be9781151fb0400485056a8c9cdfc40e msgid "PDF only: display PDF page image" msgstr "PDF 전용: PDF 페이지 이미지 표시" #: ../../page.rst:121 f2f2542e611141f38ab79ec47c6b24bc msgid ":meth:`Page.update_link`" msgstr ":meth:`Page.update_link`" #: ../../page.rst:121 5ccc634e9dab4e35b87d9283dd4c459c msgid "PDF only: modify a link" msgstr "PDF 전용: 링크 수정" #: ../../page.rst:122 5e672418d9f847e3b5cfb33a73198f4f msgid ":meth:`Page.widgets`" msgstr ":meth:`Page.widgets`" #: ../../page.rst:122 df37c13079364b42bfc84e3b87300cc8 msgid "return a generator over the fields on the page" msgstr "페이지의 필드에 대한 생성자 반환" #: ../../page.rst:123 c7ecde8ede3a4ff7b6a463a3ba205f4e msgid ":meth:`Page.write_text`" msgstr ":meth:`Page.write_text`" #: ../../page.rst:123 dcef4d9315724d998c25fac935454324 msgid "write one or more :ref:`Textwriter` objects" msgstr "하나 이상의 :ref:`Textwriter` 객체 쓰기" #: ../../page.rst:124 f7ddf8cbb96f42e2a9509482a6f12578 msgid ":attr:`Page.cropbox_position`" msgstr ":attr:`Page.cropbox_position`" #: ../../page.rst:124 e58ae174c1e14bf0929d34c067629692 msgid "displacement of the :data:`cropbox`" msgstr ":data:`cropbox` 의 변위" #: ../../page.rst:125 c3f912e91d574e7ba9eca4ebef4e9038 msgid ":attr:`Page.cropbox`" msgstr ":attr:`Page.cropbox`" #: ../../page.rst:125 3106600eed144c0387c3398d559a399b msgid "the page's :data:`cropbox`" msgstr "페이지의 :data:`cropbox`" #: ../../page.rst:126 4bcae534f0e442e89bdb09f321571968 msgid ":attr:`Page.artbox`" msgstr ":attr:`Page.artbox`" #: ../../page.rst:126 16c7fdc208b94e19ba7cb2729005e69c msgid "the page's `/ArtBox`" msgstr "페이지의 `/ArtBox`" #: ../../page.rst:127 bc724a5f20ed468c9cb5537971cd1a67 msgid ":attr:`Page.bleedbox`" msgstr ":attr:`Page.bleedbox`" #: ../../page.rst:127 99aa56333f8243c4bcc312acbdda9b66 msgid "the page's `/BleedBox`" msgstr "페이지의 `/BleedBox`" #: ../../page.rst:128 053890a35a2b4dca970fcce5a35aef43 msgid ":attr:`Page.trimbox`" msgstr ":attr:`Page.trimbox`" #: ../../page.rst:128 93749ed391f94e2da79ed77983ad3e89 msgid "the page's `/TrimBox`" msgstr "페이지의 `/TrimBox`" #: ../../page.rst:129 d91bff725157405e8a4e0702f42a4cea msgid ":attr:`Page.derotation_matrix`" msgstr ":attr:`Page.derotation_matrix`" #: ../../page.rst:129 0c7e82bca054495c87c9e519a1366048 msgid "PDF only: get coordinates in unrotated page space" msgstr "PDF 전용: 회전되지 않은 페이지 공간에서 좌표 가져오기" #: ../../page.rst:130 fd857f2b70ac411c92518c25887c2f87 msgid ":attr:`Page.first_annot`" msgstr ":attr:`Page.first_annot`" #: ../../page.rst:130 3960c3cff7cd4dd7bb4eefa5b00d56a2 msgid "first :ref:`Annot` on the page" msgstr "페이지의 첫 번째 :ref:`Annot`" #: ../../page.rst:131 6a67a4a11ec6453fa36aa5461c6e06d5 msgid ":attr:`Page.first_link`" msgstr ":attr:`Page.first_link`" #: ../../page.rst:131 6c50bbdfa48345e5b46d99fbb87e9f06 msgid "first :ref:`Link` on the page" msgstr "페이지의 첫 번째 :ref:`Link`" #: ../../page.rst:132 27eb250d66a3438f83fea2b8bfde1e1a msgid ":attr:`Page.first_widget`" msgstr ":attr:`Page.first_widget`" #: ../../page.rst:132 6dcac77284924a208b05753baa2f3993 msgid "first widget (form field) on the page" msgstr "페이지의 첫 번째 위젯(양식 필드)" #: ../../page.rst:133 3c80190dfd5b48afb1637767a52f2562 msgid ":attr:`Page.mediabox_size`" msgstr ":attr:`Page.mediabox_size`" #: ../../page.rst:133 74b552a4e7ff422eb90f67ef1b79c612 msgid "bottom-right point of :data:`mediabox`" msgstr ":data:`mediabox` 의 오른쪽 아래 점" #: ../../page.rst:134 5e616c88bd0a4d80994eebb61393c403 msgid ":attr:`Page.mediabox`" msgstr ":attr:`Page.mediabox`" #: ../../page.rst:134 dcb881e86083487d974936ae28de5065 msgid "the page's :data:`mediabox`" msgstr "페이지의 :data:`mediabox`" #: ../../page.rst:135 60c9628e587e454cb43e0bc7c339cbad msgid ":attr:`Page.number`" msgstr ":attr:`Page.number`" #: ../../page.rst:135 9a9f6b22bdb24d779607ffbe6587a360 msgid "page number" msgstr "페이지 번호" #: ../../page.rst:136 1a110f454cdb4eccb45642adad58f06a msgid ":attr:`Page.parent`" msgstr ":attr:`Page.parent`" #: ../../page.rst:136 79ef518099464c51a423337cecbcfc17 msgid "owning document object" msgstr "소유 문서 객체" #: ../../page.rst:137 699d659fe5f64f748fc494f227ca527f msgid ":attr:`Page.rect`" msgstr ":attr:`Page.rect`" #: ../../page.rst:138 41e758f7ff2c4b268ab0de1e5b623c06 msgid ":attr:`Page.rotation_matrix`" msgstr ":attr:`Page.rotation_matrix`" #: ../../page.rst:138 b6bea37a07124c5789ba01157e13610a msgid "PDF only: get coordinates in rotated page space" msgstr "PDF 전용: 회전된 페이지 공간에서 좌표 가져오기" #: ../../page.rst:139 5a09c49610b24ef58acda89953700aa0 msgid ":attr:`Page.rotation`" msgstr ":attr:`Page.rotation`" #: ../../page.rst:139 e2ee37dec6eb40b0b7495c11bdd79f2c msgid "PDF only: page rotation" msgstr "PDF 전용: 페이지 회전" #: ../../page.rst:140 7202394f72a249ba90257b4fc00ecf98 msgid ":attr:`Page.transformation_matrix`" msgstr ":attr:`Page.transformation_matrix`" #: ../../page.rst:140 7399b7e05f4f4cb38c43a83b361f9743 msgid "PDF only: translate between PDF and MuPDF space" msgstr "PDF 전용: PDF와 MuPDF 공간 간 변환" #: ../../page.rst:141 e8a15c725b7c4fb7bfdbf6af72da5dcb msgid ":attr:`Page.xref`" msgstr ":attr:`Page.xref`" #: ../../page.rst:141 e63ce001edc14011a2fe173d7cf8ee65 msgid "PDF only: page :data:`xref`" msgstr "PDF 전용: 페이지 :data:`xref`" #: ../../page.rst:144 ffd2e823bb3644949e18584adce3726f msgid "**Class API**" msgstr "**클래스 API**" #: ../../page.rst:150 16405530ac7d4413b7e7d3b1762263f8 msgid "" "Determine the rectangle of the page. Same as property :attr:`Page.rect`. " "For PDF documents this **usually** also coincides with :data:`mediabox` " "and :data:`cropbox`, but not always. For example, if the page is rotated," " then this is reflected by this method -- the :attr:`Page.cropbox` " "however will not change." msgstr "" "페이지의 사각형을 결정합니다. 속성 :attr:`Page.rect` 와 동일합니다. PDF 문서의 경우 이것은 **일반적으로** " ":data:`mediabox` 및 :data:`cropbox` 와도 일치하지만 항상은 아닙니다. 예를 들어, 페이지가 회전된 경우 " "이것은 이 메서드에 반영됩니다 -- 그러나 :attr:`Page.cropbox` 는 변경되지 않습니다." #: ../../page.rst 1c7e43371bd048ddbe8a51b1390548b7 #: 205cf4fe67bc44ce9a698e96b409bf9b 467a474817be469eab9560aba8f753ea #: 51d3f9dcd4a8427bac8db808615ff6ec 595478a115434fb6b5084114c00c7983 #: 5f5110dd40354c749d8523c0c30ba431 667dd2143f1641b8a5db0979f13804ab #: 66d7f54209244e6c86e9457ff82cdbd3 6bf04982e9a74268b7286e5a368751ab #: 7349c20e85eb40dd9560fb6e7700a2c3 7cde36324f2744389fbdf482fe12c4c8 #: 7e1f2e5330fd4dbd970bfc7abd346e63 7f20d63bc5d448aabf49085b89db55fa #: 83c7c872bd8047c3a7a0939fb05634cc 947b527bf4a547cf956b65b08e6fae28 #: 96d5484b6c864ada88cae8a16ca3d451 9f166cfc77fd41fda88155824e646c30 #: a3141c1461ea48319ecaa99986b93664 a340aa9fa69d44e8ae8707efa903a1c1 #: b477e16d888b4419afa23e619ab80186 b698b81d3295446a8f511570ccc5e7c3 #: be3f2ae375444bda8db47aaecde509ec cdbe637983804854979d3357277ac7d2 #: d3dc85ed25374dea8d2969af15ec7f0b d5fda2787f344daa80e2fd9b298b8d18 #: eec8293f986546c7843eb6b66d7f6a24 f1e13a8c14a5469daa7a4dfe69c5884b #: f2d9c25df1544d359ebbd1cb6c79ee05 f4622e9f6466414d93b014a06ff2e078 #: f757ade36dbc45d88ac62e55fb132ae9 msgid "Return type" msgstr "반환 타입" #: ../../page.rst:152 ../../page.rst:2200 ../../page.rst:2210 #: ../../page.rst:2222 ../../page.rst:2283 ../../page.rst:2289 #: ../../page.rst:2432 ../../page.rst:2492 059602a8c1964a70b776297ba67cadec #: 6be39e10fe814f0d8c9fa1b5ddc808be 79af3cb774e04712a49a2ea5c0104c97 #: aae052a3d76040c18894dff94ce8405d b9f7e0a4775f4917835802a2e3e00c9d #: c35f7f08d00d44fc92bfe49f8fdf9f37 cdd61db2adba438dae792f0a00d7c86a #: d4f8317a2c804daa8710fba8abdb5a64 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../page.rst:156 cfa67eb14e9e433e98c391fadded0bf9 msgid "" "PDF only: Add a caret icon. A caret annotation is a visual symbol " "normally used to indicate the presence of text edits on the page." msgstr "" "PDF 전용: 캐럿 아이콘을 추가합니다. 캐럿 주석은 일반적으로 페이지에 텍스트 편집이 있음을 나타내는 데 사용되는 시각적 " "기호입니다." #: ../../page.rst 00ad5e9bcba84fc2b79745d48c6d1af3 #: 01eb72e00d214526a5c35e8c9512a1f3 0210c580f03c42d89d1a707d35f78b39 #: 02a47f7a522b4c69b203a9f085012b7a 0415dbfd3a504a92aac74ed7618d0ca5 #: 0cde509b3c8e4c4382701e4e4fec7e79 105d75640b1043928d8e2ae0bae6ea7e #: 1b540529e2c24d5998bb0635160a2e33 211979f067de424fa805ef917f41fd3d #: 2c37d3051dee4a3989cac54a11fa306b 34e2bb69e8994ec89859333c4aec2521 #: 3af0605d86d54cef815ba3d01a9a8a50 4327147145c14eaaae2d2d6c4ad86fa9 #: 4593092ade8649b797a37e127740daa4 45a507654ad145b997a81d22a95bd958 #: 466592522da44edfa55c8db0e63c3973 48e27da586d840f499d90fe0b8190a58 #: 49a2594359bc48ad96d423183ac75834 4cbd4a5a00c94435a3dd21301a6eccf3 #: 50470958cec14499a78c0c1efad2a171 5911ecb82f3f4a478321f590e394075d #: 5cb2760dbdf54503b9607f1d84c4cbb2 5da0c8a182b5473ebcdbaf6c0594488c #: 74859be77d7f4033a984cb04e3a92d04 788b0ebe873045dbaedd8a79abaca095 #: 7abeb91e89ff4c7596ae330d3fa0ad68 7b99587e9cbd43d9977f5470d8e561f9 #: 7caf03a4ceb44d279e1aa6aacc6df100 890994f53e0f40d4975a462949bfff83 #: 8dbb9bbaa7e34ceb89e43315d0b7c666 91af70cc23f44f7392743058cc4f8ebf #: a22033444ce4409b8bb2df81f3555fdb a2aeaa0d5a1e4dd38adc6fba64259518 #: a6d3facd39fa416da204664b758c6fb3 a82294ed6014495c928dd45c2f24cd42 #: aa999a0d269948e6b8cdf81fcda375d6 ac48ed3d77584bcbb62550b3c0eb2498 #: ad8430a19361470b895dd21a55e1ab14 bef6913eeda048f0988acbe6a4d145c9 #: c087fad999cd4221886a01597194030e c2cbf37e9f5f4429a2f3f59ed2d69cb6 #: c9a0590b70c44d34924f9d8278ef6c1e d55cd5a6713f40ac9c9a0e40d6a262ed #: d9ce04c2e595471181c6d52278de3cfb dad883c7527d479ab4711f6b92bde5ea #: e220e2d77d0142cfb88d73ab31d9c45d e55fcc6423f24904942ab9293da5e5e5 #: fd950628603d429097cce208f88a4379 msgid "Parameters" msgstr "매개변수" #: ../../page.rst:158 37cee59c04de4b4a903e6fe5c245bda3 msgid "" "the top left point of a 20 x 20 rectangle containing the MuPDF-provided " "icon." msgstr "MuPDF에서 제공하는 아이콘을 포함하는 20 x 20 사각형의 왼쪽 위 점." #: ../../page.rst:160 ../../page.rst:181 ../../page.rst:240 ../../page.rst:264 #: ../../page.rst:273 ../../page.rst:284 ../../page.rst:295 ../../page.rst:323 #: ../../page.rst:388 ../../page.rst:600 ../../page.rst:1923 #: ../../page.rst:2258 0243863d17c1474faec91d58d7fce506 #: 147c468214b145898395799c84065546 164f7d8bb1b04753a29dcda0fe18cf06 #: 257f0462b38a4ddd9cf24447a44a3ea3 785dd2b986dd43d38c430d1d4c3e5033 #: 7d712e7e3ac54230a227b6c35361621d 7e3cb251dc2542dfaf9e6bd4d593360f #: 8b26bafd31fc44c2be39f516b98f084a 9f1c8d3976a441879292d557d6b6bdda #: a5c90e9c9aca41a88881f2b1ee1d7493 da6ca25f37ab4753a4dde348c0f77cfb #: f38cc53fbed041b688f7ddfe765e9544 msgid ":ref:`Annot`" msgstr ":ref:`Annot`" #: ../../page.rst 01874abf007d4bf0841edfda262a5a80 #: 156f763299934672b6fdfb9cfa494b31 1e02ead69f34470ca14b4e7ec7e15edf #: 20c4084afd6c42d28e0d626bbfccbd81 223eb01f06044f8497a2dcc9607f8b5c #: 27c832c2b3cd4099a81f9af2fd5dd6ee 2ceceff29c394b378ed1a58c8fece4c5 #: 36b44d3f175e4e5c9c8a87e956b40b61 380ade06e5774d3a8a5f2c8496569e64 #: 3aa1968744cd417b8ca4b25fc284b7fb 41c20c60aca54cd2bcd0aa07e04c9a7f #: 438ed28c385d4e78be868c5a2836ce98 49b824316b904a0cacf78578eaa5a1dd #: 5383a33f0cde4fd2807c8400cc4e8836 5dcf29df4e9b4660b8b08eb409eddcb5 #: 5e822b4d8cee43b59c158a444c18a8da 650b26fabb1f43d0b0de84d5d60d35ac #: 7533219ef1094965bd9f1d8091e9790e 78b53a15df0e4c309f1858b8e4c01a97 #: 79396917951844af9fa68a25cd231685 7ba40ec72d4f4d7e84ac7aeecdfff789 #: 8a7be57d9396405aa86619144561d8cd 9337311dbf29452e9bc453a05666dd30 #: 942c10676e5043ab80ec716e18b3e81a 9ba8444eecc844a19749cb8abce0078f #: a2506ef3ea0f4143a4eb89eb14223958 a2badc10b7a74bb4ab079e2f9c3fc6bb #: b01cf5b376124ab89cb842acb7a4ca7c b1b50faf962b42c594dc694e4690f284 #: b32622ff4ede4f8780a156da92c608ec b90a3c54acd04e0fa343d741a51e21fe #: b93def862bc44db9a19d8d4642ab9004 d7a26b600e1f45cb867c4af00dc2b7e4 #: dcd2e2a3eaa642ef8cae8921645ba9fe e0addb3fcc6f409a847f950149d1e5f6 #: e37c593b2e9c4b52b082cec18ab5d836 eb2728fcd3994507a6c348424d0a779e #: f1061adfcda74fb9b08daa7aeaa36651 fa2eb3ba0f0d4f3bbd646cb33bafd830 #: faa9a893b9b448c39352f0a55e42083b msgid "Returns" msgstr "반환값" #: ../../page.rst:161 d41e23d93cec47f0a5e33b061c62a8e6 msgid "" "the created annotation. Stroke color blue = (0, 0, 1), no fill color " "support." msgstr "생성된 주석. 선 색상 파란색 = (0, 0, 1), 채우기 색상 지원 없음." #: ../../page.rst:166 ../../page.rst:243 ../../page.rst:328 ../../page.rst:368 #: ../../page.rst:540 ../../page.rst:613 ../../page.rst:649 ../../page.rst:671 #: ../../page.rst:696 ../../page.rst:711 ../../page.rst:733 ../../page.rst:761 #: ../../page.rst:790 ../../page.rst:857 ../../page.rst:894 ../../page.rst:919 #: ../../page.rst:944 ../../page.rst:968 ../../page.rst:992 ../../page.rst:1017 #: ../../page.rst:1041 ../../page.rst:1066 ../../page.rst:1090 #: ../../page.rst:1115 ../../page.rst:1140 ../../page.rst:1321 #: ../../page.rst:1369 ../../page.rst:1393 ../../page.rst:1451 #: ../../page.rst:1479 ../../page.rst:1501 ../../page.rst:1542 #: ../../page.rst:1653 ../../page.rst:1676 ../../page.rst:1735 #: ../../page.rst:1765 ../../page.rst:1785 ../../page.rst:1800 #: ../../page.rst:1841 ../../page.rst:1882 ../../page.rst:1896 #: ../../page.rst:1910 ../../page.rst:1928 ../../page.rst:1945 #: ../../page.rst:2046 ../../page.rst:2083 ../../page.rst:2107 #: ../../page.rst:2125 ../../page.rst:2172 0ca6b086be624551b8d5a3bfd5a5c29c #: 12468912de284f668b30834e02f4e56e 1a7a7daaee05403dbab563e782d112b3 #: 1d1d583195544c76a0842f24848325ae 1ff2f4d3d7764928b9d6cbd3ed332911 #: 2280e88ab4aa440d9df2d4639a07b563 2b7e7d752b444952b8995c12d4b03133 #: 2fff22fb49c04d2bb4c35f1666c49b30 3266e9100bf64637a033863f4d4b0ecd #: 343a36bc5c8b4f86958f75096586f720 3ce4fcaee5ea4f4ca3941a9fe15ceb8e #: 3e8d13ba70a1401c975463e0fdf1cc87 3fd2c7c7b03941f1bdd410868d1dfa96 #: 43af8ec0295947b2908552ffdfaee874 478ec9cc77064d9aaeef46392d935cfb #: 4cb7af8d2ce147bab5b26410b8c3d007 5342c4e8c8b3460bab5aee3fd19e8362 #: 5bb0a7d3e5404686a6dc97681a65f8b1 5e8f1e0e7cd9468a8b05322c1f344190 #: 5f3926a01acc4e44980e0bc496725dc2 61a500c96c504aca9eb7954201c07d1f #: 666ba2b511b941069224d1b093754a83 6778944fad394ba39677af70f67cfd2d #: 6a3b0d0adbd9462da9cc53748bf7ccc0 6d6d536701f747e588356741fc404cbb #: 73439f7cf4ca413c85d04aca1e27a5f0 7ae311fc9ef74a5ca330213ac583359c #: 82dbaad0870c41d8a28b5477b8abe803 9144d51e11884421bbd80a409545f42a #: a472f109adf246cd91c1e97351337c31 a57d2ac5e4f848ed80348b8a89f4af51 #: aadf7e17870442c58916096ef5985781 aaeb6c7f1f494acfb5da432d5c25c42e #: af14cf38d5724598933d62513496740c b0c35e8fcd6a4c63969d92a3c6ccaaed #: b3ba0143c4c04a9cbb0dd847168c07ed b9d4d559e0af4a868716aef4b1884ff4 #: baf563b17acf4b328a01d7ceb0a7bc3e bc16481dcb7640b9914a19268857f26e #: c42d09416fb34718ad4cf94316454fbd ce97837903984a749034b63b6b1526f2 #: d310818865ec411eae18a52f5970ef18 d8fa3ad2a57445d1a9aa6a6b5feeb419 #: d91f916bf7024b1eac0338bb3846c9fb e9af9798bc1b407d8a984f8fd89593c7 #: f3c57a49b90340f4b79abadc86693b9e f58bd9b3d29542e58d2ec81caf05562f #: fde7f05f6f6c4fdda2cc9a2793bf0d55 feb1c7a6d32844deb13a26c3f6e948bf msgid "|history_begin|" msgstr "|history_begin|" #: ../../page.rst:168 96db2ff91a834bd5addd88ee554dea59 msgid "New in v1.16.0" msgstr "v1.16.0에서 새로 추가됨" #: ../../page.rst:170 ../../page.rst:247 ../../page.rst:332 ../../page.rst:376 #: ../../page.rst:545 ../../page.rst:617 ../../page.rst:653 ../../page.rst:675 #: ../../page.rst:700 ../../page.rst:715 ../../page.rst:737 ../../page.rst:765 #: ../../page.rst:794 ../../page.rst:870 ../../page.rst:898 ../../page.rst:923 #: ../../page.rst:948 ../../page.rst:972 ../../page.rst:996 ../../page.rst:1021 #: ../../page.rst:1045 ../../page.rst:1070 ../../page.rst:1094 #: ../../page.rst:1120 ../../page.rst:1144 ../../page.rst:1345 #: ../../page.rst:1373 ../../page.rst:1397 ../../page.rst:1459 #: ../../page.rst:1484 ../../page.rst:1506 ../../page.rst:1547 #: ../../page.rst:1663 ../../page.rst:1684 ../../page.rst:1740 #: ../../page.rst:1769 ../../page.rst:1793 ../../page.rst:1804 #: ../../page.rst:1855 ../../page.rst:1886 ../../page.rst:1900 #: ../../page.rst:1914 ../../page.rst:1932 ../../page.rst:1949 #: ../../page.rst:2051 ../../page.rst:2090 ../../page.rst:2112 #: ../../page.rst:2130 ../../page.rst:2176 02ae4ce4ec884ffea3b18987b7a84578 #: 034dfe1d353e4a6d89a0a90f878677f2 049da9b465da4eab8d6c4253f1b61314 #: 05d96681089544e8a32b8ed6f1d6f1f3 08108b3dff3041948f4a84ff2ae6176b #: 0c11db1b147040b9ba820fe01ae9da58 18914b33eb7f4c3bb79dddca5f56edc0 #: 1a6d6af8879b46b7974578a3c9d04343 1b554ab0b76541c2a7b9b00d4a5135a0 #: 1e8c987524d0478b82d2b226a1ae18fd 2051d14fc29240b1b6db669fa35861c5 #: 21b5cf863bff47bbb8247bbb9dd54fbf 29c2a743ad37445ebe62109322eaad6f #: 2e16f94cf83741368836aba335519715 2ea1bff3b8d5453bad453f97699f9975 #: 318d284c1a4e4df49a2143fdb1a592bb 3846e7e58f594f1ea654c716ce942341 #: 48fea13b28854a3e8037241f0cac75a3 50687e142e7d4d358acfbee0b7828bd9 #: 50ff165fbf384a0db135856cc7855894 55907e73b4254f029b6315f76570f3a4 #: 69269d0e6e2b4321a564891e83d3a972 6974f42beb6443898bffe78925562e7a #: 6cb8027b0a7d4a96b1e6f74c36309243 6fd8c635d7b34337b97b84c1ff0ae41d #: 7031705e19194108bb39098a839628a6 7176e068f9ad4847a4d7b224a05118de #: 718bef9d535d44cbbb56871c7efa2618 7bf1e9ecb2bf4287829db04bad618db7 #: 7fe57d524c094c27a6a01348c400ef3c 84c5bf1c20d149f4a1680a2157f4eb08 #: 84dc12790c384757ab4e44c25c0ce58e 875130bb17324e09b192ffbc49f959f0 #: 9d217d1e2314404291644e771ffe6753 a11e419e262b4a659e133f8d80777b37 #: a78c54c40f0048c996824600e7415dbf af9e409e31964966a75bd201f959d0d8 #: afc655f80b444c7b829bcc6170536143 b14005d7053d44ce9732f5265b71d93d #: b35ec848aa6646a18a773737a4766df2 c4ca8bf9c34a4c848b3eb518158a02fe #: c8f92542a4bc431fb8bbe56eaf71bdea ce742763a46a417ba689244aa10bf44a #: d5863e853d39455bb5e5414aa34ed878 daf50cfc40fb4142aec7eb19b1540003 #: dbfa429a9021430ab3c7f8d80f4ace2f e938d44e132d433aa42ffc35f429d343 #: f8d308248d98414f933d5194478d6985 faa94ecd4765407a84feaa3a5ba92790 msgid "|history_end|" msgstr "|history_end|" #: ../../page.rst:174 51bdd00946d148b8953854efd83df01a msgid "" "PDF only: Add a comment icon (\"sticky note\") with accompanying text. " "Only the icon is visible, the accompanying text is hidden and can be " "visualized by many PDF viewers by hovering the mouse over the symbol." msgstr "" "PDF 전용: 텍스트와 함께 주석 아이콘(\"스티키 노트\")을 추가합니다. 아이콘만 보이고 텍스트는 숨겨져 있으며 많은 PDF " "뷰어에서 기호 위에 마우스를 올리면 표시할 수 있습니다." #: ../../page.rst:176 54a369191cb44ecbb72939e1cfcc1991 msgid "" "the top left point of a 20 x 20 rectangle containing the MuPDF-provided " "\"note\" icon." msgstr "MuPDF에서 제공하는 \"노트\" 아이콘을 포함하는 20 x 20 사각형의 왼쪽 위 점." #: ../../page.rst:178 fd77aeb8334442388dd2eec90ebfbe94 msgid "" "the commentary text. This will be shown on double clicking or hovering " "over the icon. May contain any Latin characters." msgstr "주석 텍스트. 아이콘을 더블 클릭하거나 마우스를 올리면 표시됩니다. 모든 라틴 문자를 포함할 수 있습니다." #: ../../page.rst:179 456b5d9d70414bb3a75145bb8d68febf msgid "" "choose one of \"Note\" (default), \"Comment\", \"Help\", \"Insert\", " "\"Key\", \"NewParagraph\", \"Paragraph\" as the visual symbol for the " "embodied text [#f4]_. (New in v1.16.0)" msgstr "" "\"Note\" (기본값), \"Comment\", \"Help\", \"Insert\", \"Key\", " "\"NewParagraph\", \"Paragraph\" 중 하나를 텍스트의 시각적 기호로 선택합니다 [#f4]_. " "(v1.16.0에서 새로 추가됨)" #: ../../page.rst:182 37733ed2d61c4a4d8963c8fa2c20f9f2 msgid "" "the created annotation. Stroke color yellow = (1, 1, 0), no fill color " "support." msgstr "생성된 주석. 선 색상 노란색 = (1, 1, 0), 채우기 색상 지원 없음." #: ../../page.rst:202 1c146be34a16419cb8750d19046ac2ab msgid "" "PDF only: Add text in a given rectangle. Optionally, the appearance of a " "\"callout\" shape can be requested by specifying two or three point-like " "objects -- see below." msgstr "" "PDF 전용: 주어진 사각형에 텍스트를 추가합니다. 선택적으로 두 개 또는 세 개의 점과 같은 객체를 지정하여 \"말풍선\" 모양의" " 모양을 요청할 수 있습니다 -- 아래 참조." #: ../../page.rst:204 44b8581ef22344d99a19590077f4ce46 msgid "" "the rectangle into which the text should be inserted. Text is " "automatically wrapped to a new line at box width. Text portions not " "fitting into the rectangle will be invisible without warning." msgstr "" "텍스트가 삽입될 사각형. 텍스트는 상자 너비에서 자동으로 새 줄로 줄바꿈됩니다. 사각형에 맞지 않는 텍스트 부분은 경고 없이 보이지" " 않습니다." #: ../../page.rst:206 7d331bcc143943c4a9bb8a8a2db24dd5 msgid "" "the text. May contain any mixture of Latin, Greek, Cyrillic, Chinese, " "Japanese and Korean characters. If `richtext=True` (see below), the " "string is interpreted as HTML syntax. This adds a plethora of ways for " "attractive effects." msgstr "" "텍스트. 라틴, 그리스, 키릴, 중국어, 일본어 및 한국어 문자의 모든 조합을 포함할 수 있습니다. `richtext=True` " "(아래 참조)인 경우 문자열은 HTML 구문으로 해석됩니다. 이것은 매력적인 효과를 위한 다양한 방법을 추가합니다." #: ../../page.rst:208 d184d4430ee747d88f8881eb7b24ea82 msgid "the :data:`fontsize`. Default is 11. Ignored if `richtext=True`." msgstr ":data:`fontsize`. 기본값은 11입니다. `richtext=True` 인 경우 무시됩니다." #: ../../page.rst:210 4fa1ef6ca2f44a17b6c91719560a60dd msgid "" "The font name. Default is \"Helv\". Ignored if `richtext=True`, otherwise" " the following **restritions apply:** * Accepted alternatives are " "\"Helv\" (Helvetica), \"Cour\" (Courier), \"TiRo\" (Timnes-Roman), " "\"ZaDb\" (ZapfDingBats) and \"Symb\" (Symbol). The name may be " "abbreviated to the first two characters, like \"Co\" for \"Cour\", lower " "case accepted. * Bold or italic variants of the fonts are **not " "supported.**" msgstr "" #: ../../page.rst:210 cf9b9e8045234c18b29151b3ff723fa6 msgid "" "The font name. Default is \"Helv\". Ignored if `richtext=True`, otherwise" " the following **restritions apply:**" msgstr "" "폰트 이름. 기본값은 \"Helv\"입니다. `richtext=True` 인 경우 무시되며, 그렇지 않으면 다음 **제한 사항이 " "적용됩니다:**" #: ../../page.rst:212 6b9f7ab0730d4eecbf4ec937dfd826d2 msgid "" "Accepted alternatives are \"Helv\" (Helvetica), \"Cour\" (Courier), " "\"TiRo\" (Timnes-Roman), \"ZaDb\" (ZapfDingBats) and \"Symb\" (Symbol). " "The name may be abbreviated to the first two characters, like \"Co\" for " "\"Cour\", lower case accepted." msgstr "" "허용되는 대안은 \"Helv\" (Helvetica), \"Cour\" (Courier), \"TiRo\" (Times-" "Roman), \"ZaDb\" (ZapfDingBats) 및 \"Symb\" (Symbol)입니다. 이름은 \"Cour\"의 경우 " "\"Co\"와 같이 처음 두 문자로 축약할 수 있으며, 소문자가 허용됩니다." #: ../../page.rst:214 123f4899566d48368c805d9f89b3e331 msgid "Bold or italic variants of the fonts are **not supported.**" msgstr "폰트의 굵게 또는 기울임꼴 변형은 **지원되지 않습니다.**" #: ../../page.rst:216 6f8ffab38b19408191c5984a0e3f53f9 msgid "the text color. Default is black. Ignored if `richtext=True`." msgstr "텍스트 색상. 기본값은 검은색입니다. `richtext=True` 인 경우 무시됩니다." #: ../../page.rst:218 f19df2fca1f946be8dc7d6eeaaa20718 msgid "" "the fill color. This is used for ``rect`` and the end point of the " "callout lines when applicable. Default is ``None``." msgstr "채우기 색상. 이것은 ``rect`` 및 해당하는 경우 말풍선 선의 끝점에 사용됩니다. 기본값은 ``None`` 입니다." #: ../../page.rst:220 548acc7ce2da4307a490d2ec5ba5c350 msgid "" "This parameter **only has an effect** if `richtext=True`. Otherwise, " "``text_color`` is used." msgstr "" "이 매개변수는 `richtext=True` 인 경우에만 **효과가 있습니다**. 그렇지 않으면 ``text_color`` 가 " "사용됩니다." #: ../../page.rst:222 63943749331c448b8b846ca3551f473d msgid "" "the width of border and ``callout`` lines. Default is 0 (no border), in " "which case callout lines may still appear with some hairline width, " "depending on the PDF viewer used. In any case, this value must be " "positive to see a border line." msgstr "" "테두리 및 ``callout`` 선의 너비. 기본값은 0(테두리 없음)이며, 이 경우 사용된 PDF 뷰어에 따라 말풍선 선이 여전히" " 얇은 선 너비로 나타날 수 있습니다. 어떤 경우든 테두리 선을 보려면 이 값이 양수여야 합니다." #: ../../page.rst:224 d9a2ef0ede15487f9edfb910a15dcaed msgid "" "a list of floats specifying how border and callout lines should be " "dashed. Default is ``None``." msgstr "테두리 및 말풍선 선을 점선으로 표시하는 방법을 지정하는 float 목록. 기본값은 ``None`` 입니다." #: ../../page.rst:226 c9271c8fdd374e65988f2aaffd340aea msgid "" "a list / tuple of two or three :data:`point_like` objects, which will be " "interpreted as end point [, knee point] and start point (in this " "sequence) of up to two line segments, converting this annotation into a " "call-out shape." msgstr "" "두 개 또는 세 개의 :data:`point_like` 객체의 리스트/튜플로, 최대 두 개의 선분의 끝점 [, 무릎 점] 및 " "시작점(이 순서로)으로 해석되어 이 주석을 말풍선 모양으로 변환합니다." #: ../../page.rst:228 c33f0a979817431cbd682918b0e62222 msgid "" "the line end symbol of the call-out line. It is drawn at the first point " "specified in the `callout` list. Default is an open arrow. For possible " "values see :ref:`AnnotationLineEnds`." msgstr "" "말풍선 선의 선 끝 기호. `callout` 목록에 지정된 첫 번째 점에 그려집니다. 기본값은 열린 화살표입니다. 가능한 값은 " ":ref:`AnnotationLineEnds` 를 참조하세요." #: ../../page.rst:230 1d92cdcfd87147edb5f5e0bc43ff50ba msgid "" "a float `0 <= opacity < 1` turning the annotation transparent. Default is" " no transparency." msgstr "주석을 투명하게 만드는 float `0 <= opacity < 1`. 기본값은 투명도 없음입니다." #: ../../page.rst:232 cfc26e251ca346dd905d4712fc2ff181 msgid "" "text alignment, one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " "TEXT_ALIGN_RIGHT - justify is **not supported**. Ignored if " "`richtext=True`." msgstr "" "텍스트 정렬, TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT 중 하나 - 양쪽 " "정렬은 **지원되지 않습니다**. `richtext=True` 인 경우 무시됩니다." #: ../../page.rst:234 034b62bc622e49068cee63693843f5a1 msgid "" "the text orientation. Accepted values are integer multiples of 90°. " "Invalid entries receive a rotation of 0." msgstr "텍스트 방향. 허용되는 값은 90°의 정수 배수입니다. 잘못된 항목은 회전 0을 받습니다." #: ../../page.rst:236 da57bcf6cd3b4c3d8e9b68d91eedfe24 msgid "" "treat ``text`` as HTML syntax. This allows to achieve **bold**, *italic*," " arbitrary text colors, font sizes, text alignment including justify and " "more - as far as the PDF subset of HTML and styling instructions supports" " this. This is similar to what happens in :meth:`Page.insert_htmlbox`. " "The base library will for example pull in required fonts if it encounters" " characters not contained in the standard ones. Some parameters are " "ignored if this option is set, as mentioned above. Default is ``False``." msgstr "" "``text`` 를 HTML 구문으로 처리합니다. 이것은 **굵게**, *기울임꼴*, 임의의 텍스트 색상, 폰트 크기, 양쪽 정렬을" " 포함한 텍스트 정렬 등을 달성할 수 있게 합니다 - PDF HTML 서브셋 및 스타일 지시문이 이를 지원하는 한. 이것은 " ":meth:`Page.insert_htmlbox` 에서 일어나는 것과 유사합니다. 기본 라이브러리는 예를 들어 표준 폰트에 포함되지" " 않은 문자를 만나면 필요한 폰트를 가져옵니다. 이 옵션이 설정되면 위에서 언급한 대로 일부 매개변수가 무시됩니다. 기본값은 " "``False`` 입니다." #: ../../page.rst:238 32ec7963c0a04bc78b1231ca653e0386 msgid "" "supply optional HTML styling information in CSS syntax. Ignored if " "`richtext=False`." msgstr "CSS 구문으로 선택적 HTML 스타일 정보를 제공합니다. `richtext=False` 인 경우 무시됩니다." #: ../../page.rst:241 5984cf38fa2c47028b2e176e5b062090 msgid "the created annotation." msgstr "생성된 주석." #: ../../page.rst:245 7e930f01ce524eddac7121e39875dce0 msgid "Changed in v1.19.6: add border color parameter" msgstr "v1.19.6에서 변경됨: 테두리 색상 매개변수 추가" #: ../../page.rst:251 0ba858ddf30f47268c90815b704bd8d7 msgid "" "PDF only: Add a file attachment annotation with a \"PushPin\" icon at the" " specified location." msgstr "PDF 전용: 지정된 위치에 \"PushPin\" 아이콘이 있는 파일 첨부 주석을 추가합니다." #: ../../page.rst:253 952eb34fd29645e3b86fc95af04e12e6 msgid "" "the top-left point of a 18x18 rectangle containing the MuPDF-provided " "\"PushPin\" icon." msgstr "MuPDF에서 제공하는 \"PushPin\" 아이콘을 포함하는 18x18 사각형의 왼쪽 위 점." #: ../../page.rst:255 33c54f02d9ec4958aac36d4ae87ec8b2 msgid "" "the data to be stored (actual file content, any data, etc.). Changed in " "v1.14.13: *io.BytesIO* is now also supported." msgstr "" #: ../../page.rst:255 49a1495385834b0bb8c253a6b035e372 msgid "the data to be stored (actual file content, any data, etc.)." msgstr "저장할 데이터(실제 파일 콘텐츠, 모든 데이터 등)." #: ../../page.rst:257 9106ac69cad44285868e1db831a4f80b msgid "Changed in v1.14.13: *io.BytesIO* is now also supported." msgstr "v1.14.13에서 변경됨: *io.BytesIO* 도 이제 지원됩니다." #: ../../page.rst:259 3054cf84528a428d9364a2a12859b693 msgid "the filename to associate with the data." msgstr "데이터와 연결할 파일명." #: ../../page.rst:260 f0ee2128fd164598b042072345e030e6 msgid "the optional PDF unicode version of filename. Defaults to filename." msgstr "파일명의 선택적 PDF 유니코드 버전. 기본값은 파일명입니다." #: ../../page.rst:261 7ed966fa13094c65b1becda615d4f72d msgid "an optional description of the file. Defaults to filename." msgstr "파일의 선택적 설명. 기본값은 파일명입니다." #: ../../page.rst:262 04c62225b8b74b298de1c93e5d5f135e msgid "" "choose one of \"PushPin\" (default), \"Graph\", \"Paperclip\", \"Tag\" as" " the visual symbol for the attached data [#f4]_. (New in v1.16.0)" msgstr "" "\"PushPin\" (기본값), \"Graph\", \"Paperclip\", \"Tag\" 중 하나를 첨부된 데이터의 시각적 " "기호로 선택합니다 [#f4]_. (v1.16.0에서 새로 추가됨)" #: ../../page.rst:265 e780faf60aac4a58992bf36f5c9ef190 msgid "" "the created annotation. Stroke color yellow = (1, 1, 0), no fill color " "support." msgstr "생성된 주석. 선 색상 노란색 = (1, 1, 0), 채우기 색상 지원 없음." #: ../../page.rst:269 d747b4142e74426e9cafa1e1fad1b357 msgid "PDF only: Add a \"freehand\" scribble annotation." msgstr "PDF 전용: \"자유형\" 낙서 주석을 추가합니다." #: ../../page.rst:271 14e1a3e9c61047ab82b59eb44e721ebf msgid "" "a list of one or more lists, each containing :data:`point_like` items. " "Each item in these sublists is interpreted as a :ref:`Point` through " "which a connecting line is drawn. Separate sublists thus represent " "separate drawing lines." msgstr "" "하나 이상의 리스트의 리스트로, 각각 :data:`point_like` 항목을 포함합니다. 이러한 하위 리스트의 각 항목은 연결 " "선이 그려지는 :ref:`Point` 로 해석됩니다. 따라서 별도의 하위 리스트는 별도의 그리기 선을 나타냅니다." #: ../../page.rst:274 c78d5be71625401caa352e4a3546e8d9 msgid "" "the created annotation in default appearance black =(0, 0, 0),line width " "1. No fill color support." msgstr "기본 모양 검은색 =(0, 0, 0), 선 너비 1의 생성된 주석. 채우기 색상 지원 없음." #: ../../page.rst:278 83a7dfd91643427b9b3ddae21297d1e0 msgid "PDF only: Add a line annotation." msgstr "PDF 전용: 선 주석을 추가합니다." #: ../../page.rst:280 982abaa9a3b04d7dab7a869c40500ee8 msgid "the starting point of the line." msgstr "선의 시작점." #: ../../page.rst:282 71f3d7598f4a438baa35931f6d2292a1 msgid "the end point of the line." msgstr "선의 끝점." #: ../../page.rst:285 d0d3f8e6caee4c659fef7470860d22be msgid "" "the created annotation. It is drawn with line (stroke) color red = (1, 0," " 0) and line width 1. No fill color support. The **annot rectangle** is " "automatically created to contain both points, each one surrounded by a " "circle of radius 3 * line width to make room for any line end symbols." msgstr "" "생성된 주석. 선(스트로크) 색상 빨간색 = (1, 0, 0) 및 선 너비 1로 그려집니다. 채우기 색상 지원 없음. **주석 " "사각형** 은 두 점을 포함하도록 자동으로 생성되며, 각 점은 선 끝 기호를 위한 공간을 만들기 위해 반경 3 * 선 너비의 원으로" " 둘러싸입니다." #: ../../page.rst:291 c1c26bec4d8a4a449fd8205433749a68 msgid "PDF only: Add a rectangle, resp. circle annotation." msgstr "PDF 전용: 사각형, 각각 원형 주석을 추가합니다." #: ../../page.rst:293 fbd4ba67216045c7863c4d7c09726bdc msgid "" "the rectangle in which the circle or rectangle is drawn, must be finite " "and not empty. If the rectangle is not equal-sided, an ellipse is drawn." msgstr "원 또는 사각형이 그려지는 사각형은 유한하고 비어 있지 않아야 합니다. 사각형이 정사각형이 아니면 타원이 그려집니다." #: ../../page.rst:296 2d270d9060804012bc6a6d6daae01393 msgid "" "the created annotation. It is drawn with line (stroke) color red = (1, 0," " 0), line width 1, fill color is supported." msgstr "생성된 주석. 선(스트로크) 색상 빨간색 = (1, 0, 0), 선 너비 1로 그려지며, 채우기 색상이 지원됩니다." #: ../../page.rst:301 b2d0c457ed934ffa8cc63c9daba01877 msgid "Redactions" msgstr "수정" #: ../../page.rst:305 83d32da0d6a9408b8f95066f77189a66 msgid "" "**PDF only**: Add a redaction annotation. A redaction annotation " "identifies an area whose content should be removed from the document. " "Adding such an annotation is the first of two steps. It makes visible " "what will be removed in the subsequent step, " ":meth:`Page.apply_redactions`." msgstr "" "**PDF 전용**: 수정 주석을 추가합니다. 수정 주석은 콘텐츠가 문서에서 제거되어야 하는 영역을 식별합니다. 이러한 주석을 " "추가하는 것은 두 단계 중 첫 번째 단계입니다. 다음 단계인 :meth:`Page.apply_redactions` 에서 제거될 " "내용을 표시합니다." #: ../../page.rst:307 4699fffeef5d4362a039fb781b613690 msgid "" "specifies the (rectangular) area to be removed which is always equal to " "the annotation rectangle. This may be a :data:`rect_like` or " ":data:`quad_like` object. If a quad is specified, then the enveloping " "rectangle is taken." msgstr "" "제거할 (사각형) 영역을 지정하며 항상 주석 사각형과 같습니다. 이것은 :data:`rect_like` 또는 " ":data:`quad_like` 객체일 수 있습니다. quad가 지정되면 둘러싸는 사각형이 사용됩니다." #: ../../page.rst:309 ba0ad939c6964388bbf9da8a1426e156 msgid "" "text to be placed in the rectangle after applying the redaction (and thus" " removing old content). (New in v1.16.12)" msgstr "수정을 적용한 후(따라서 이전 콘텐츠를 제거한 후) 사각형에 배치할 텍스트. (v1.16.12에서 새로 추가됨)" #: ../../page.rst:311 d2d149590d334bd4877f4fc44334eb88 msgid "" "the font to use when ``text`` is given, otherwise ignored. Only CJK and " "the :ref:`Base-14-Fonts` are supported. Apart from this, the same rules " "apply as for :meth:`Page.insert_textbox` -- which is what the method " ":meth:`Page.apply_redactions` internally invokes." msgstr "" "``text`` 가 제공될 때 사용할 폰트, 그렇지 않으면 무시됩니다. CJK 및 :ref:`Base-14-Fonts` 만 " "지원됩니다. 이 외에는 :meth:`Page.insert_textbox` 와 동일한 규칙이 적용됩니다 -- 이것은 메서드 " ":meth:`Page.apply_redactions` 가 내부적으로 호출하는 것입니다." #: ../../page.rst:313 cc4732ea5ec8414ba11322e9735299c3 msgid "" "the :data:`fontsize` to use for the replacing text. If the text is too " "large to fit, several insertion attempts will be made, gradually reducing" " the :data:`fontsize` to no less than 4. If then the text will still not " "fit, no text insertion will take place at all. (New in v1.16.12)" msgstr "" "교체 텍스트에 사용할 :data:`fontsize`. 텍스트가 너무 커서 맞지 않으면 여러 번 삽입을 시도하며, " ":data:`fontsize` 를 점진적으로 4 이상으로 줄입니다. 그래도 텍스트가 맞지 않으면 텍스트 삽입이 전혀 수행되지 " "않습니다. (v1.16.12에서 새로 추가됨)" #: ../../page.rst:315 c4d7520aac904bb99519e58c6bf2140d msgid "" "the horizontal alignment for the replacing text. See " ":meth:`insert_textbox` for available values. The vertical alignment is " "(approximately) centered." msgstr "" "교체 텍스트의 수평 정렬. 사용 가능한 값은 :meth:`insert_textbox` 를 참조하세요. 수직 정렬은 (대략) " "중앙입니다." #: ../../page.rst:317 b3a02eedc12844f68db67a48da623653 msgid "" "the fill color of the rectangle **after applying** the redaction. The " "default is *white = (1, 1, 1)*, which is also taken if ``None`` is " "specified. To suppress a fill color altogether, specify ``False``. In " "this cases the rectangle remains transparent. (New in v1.16.12)" msgstr "" "수정을 **적용한 후** 사각형의 채우기 색상. 기본값은 *white = (1, 1, 1)* 이며, ``None`` 이 지정된 " "경우에도 사용됩니다. 채우기 색상을 완전히 억제하려면 ``False`` 를 지정하세요. 이 경우 사각형은 투명하게 유지됩니다. " "(v1.16.12에서 새로 추가됨)" #: ../../page.rst:319 4f1d52476fb54ea7910fb134279060cc msgid "" "the color of the replacing text. Default is *black = (0, 0, 0)*. (New in " "v1.16.12)" msgstr "교체 텍스트의 색상. 기본값은 *black = (0, 0, 0)* 입니다. (v1.16.12에서 새로 추가됨)" #: ../../page.rst:321 9d20ca01e5ec49d48597ab52ae2429d6 msgid "add two diagonal lines to the annotation rectangle. (New in v1.17.2)" msgstr "주석 사각형에 두 개의 대각선을 추가합니다. (v1.17.2에서 새로 추가됨)" #: ../../page.rst:324 5d7ae07a1eae47d3af0293d6f1cebff7 msgid "" "the created annotation. Its standard appearance looks like a red " "rectangle (no fill color), optionally showing two diagonal lines. Colors," " line width, dashing, opacity and blend mode can now be set and applied " "via :meth:`Annot.update` like with other annotations. (Changed in " "v1.17.2)" msgstr "" "생성된 주석. 표준 모양은 빨간색 사각형(채우기 색상 없음)이며, 선택적으로 두 개의 대각선을 표시합니다. 색상, 선 너비, 점선," " 불투명도 및 블렌드 모드는 이제 다른 주석과 마찬가지로 :meth:`Annot.update` 를 통해 설정하고 적용할 수 " "있습니다. (v1.17.2에서 변경됨)" #: ../../page.rst:330 ../../page.rst:370 8a91d58a85a54e15a0c2a92ab4be3fc8 #: ffdf3291e16d4f3193e3c0d91e3f2010 msgid "New in v1.16.11" msgstr "v1.16.11에서 새로 추가됨" #: ../../page.rst:337 3c7a5faae9b0449d91c14474c64d2051 msgid "" "**PDF only**: Remove all **content** contained in any redaction rectangle" " on the page." msgstr "**PDF 전용**: 페이지의 모든 수정 사각형에 포함된 **콘텐츠** 를 제거합니다." #: ../../page.rst:339 ee1fc729c3c14392bb729f007f5b6698 msgid "**This method applies and then deletes all redactions from the page.**" msgstr "**이 메서드는 모든 수정을 적용한 다음 페이지에서 삭제합니다.**" #: ../../page.rst:341 b227244aaa8440a58e165311f3d4e159 msgid "" "How to redact overlapping images. The default (2) blanks out overlapping " "pixels. `PDF_REDACT_IMAGE_NONE | 0` ignores, and `PDF_REDACT_IMAGE_REMOVE" " | 1` completely removes images overlapping any redaction annotation. " "Option `PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE | 3` only removes images" " that are actually visible." msgstr "" "겹치는 이미지를 수정하는 방법. 기본값(2)은 겹치는 픽셀을 지웁니다. `PDF_REDACT_IMAGE_NONE | 0` 은 " "무시하고, `PDF_REDACT_IMAGE_REMOVE | 1` 은 수정 주석과 겹치는 이미지를 완전히 제거합니다. 옵션 " "`PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE | 3` 은 실제로 보이는 이미지만 제거합니다." #: ../../page.rst:343 732d8771fa524855a96d98bab564cb8f #, python-format msgid "" "How to redact overlapping vector graphics (also called \"line-art\" or " "\"drawings\"). The default (2) removes any overlapping vector graphics. " "`PDF_REDACT_LINE_ART_NONE | 0` ignores, and " "`PDF_REDACT_LINE_ART_REMOVE_IF_COVERED | 1` removes graphics fully " "contained in a redaction annotation. When removing line-art, please be " "aware that **stroked** vector graphics (i.e. type \"s\" or \"sf\") have a" " **larger wrapping rectangle** than one might expect: first of all, at " "least 50% of the path's line width have to be added in each direction to " "truly include all of the drawing. If a so-called \"miter limit\" is " "provided (see page 121 of the PDF specification), the enlarging value is " "`miter * width / 2`. So, when letting everything default (width = 1, " "miter = 10), the redaction rectangle should be at least 5 points larger " "in every direction." msgstr "" "겹치는 벡터 그래픽(또한 \"line-art\" 또는 \"drawings\"라고도 함)을 수정하는 방법. 기본값(2)은 겹치는 모든" " 벡터 그래픽을 제거합니다. `PDF_REDACT_LINE_ART_NONE | 0` 은 무시하고, " "`PDF_REDACT_LINE_ART_REMOVE_IF_COVERED | 1` 은 수정 주석에 완전히 포함된 그래픽을 제거합니다. " "line-art를 제거할 때 **스트로크된** 벡터 그래픽(즉, 타입 \"s\" 또는 \"sf\")은 예상보다 **큰 래핑 " "사각형** 을 가집니다: 먼저, 그림의 모든 부분을 실제로 포함하려면 경로의 선 너비의 최소 50%를 각 방향으로 추가해야 합니다." " 소위 \"miter limit\"이 제공되면(PDF 사양 121페이지 참조), 확대 값은 `miter * width / 2` " "입니다. 따라서 모든 것을 기본값으로 두면(width = 1, miter = 10), 수정 사각형은 모든 방향으로 최소 5포인트 더" " 커야 합니다." #: ../../page.rst:345 b034080c271e4abea6940e78ca7c9b9f msgid "" "Whether to redact overlapping text. The default `PDF_REDACT_TEXT_REMOVE |" " 0` removes all characters whose boundary box overlaps any redaction " "rectangle. This complies with the original legal / data protection " "intentions of redaction annotations. Other use cases however may require " "to **keep text** while redacting vector graphics or images. This can be " "achieved by setting `text=True|PDF_REDACT_TEXT_NONE | 1`. This does **not" " comply** with the data protection intentions of redaction annotations. " "**Do so at your own risk.**" msgstr "" "겹치는 텍스트를 수정할지 여부. 기본값 `PDF_REDACT_TEXT_REMOVE | 0` 은 경계 상자가 수정 사각형과 겹치는 " "모든 문자를 제거합니다. 이것은 수정 주석의 원래 법적/데이터 보호 의도에 부합합니다. 그러나 다른 사용 사례에서는 벡터 그래픽이나" " 이미지를 수정하는 동안 **텍스트를 유지** 해야 할 수 있습니다. 이것은 " "`text=True|PDF_REDACT_TEXT_NONE | 1` 로 설정하여 달성할 수 있습니다. 이것은 수정 주석의 데이터 보호" " 의도에 **부합하지 않습니다**. **자신의 위험으로 수행하세요.**" #: ../../page.rst:347 a88c35da262e43b885d7144a0ff5712f msgid "" "`True` if at least one redaction annotation has been processed, `False` " "otherwise." msgstr "최소 하나의 수정 주석이 처리되었으면 `True`, 그렇지 않으면 `False`." #: ../../page.rst:350 fe01d8d5869c414186b762c70b99a4ea msgid "" "Text contained in a redaction rectangle will be **physically** removed " "from the page (assuming :meth:`Document.save` with a suitable garbage " "option) and will no longer appear in e.g. text extractions or anywhere " "else. All redaction annotations will also be removed. Other annotations " "are unaffected." msgstr "" "수정 사각형에 포함된 텍스트는 페이지에서 **물리적으로** 제거됩니다(적절한 가비지 옵션으로 :meth:`Document.save`" " 가정) 그리고 예를 들어 텍스트 추출이나 다른 곳에서 더 이상 나타나지 않습니다. 모든 수정 주석도 제거됩니다. 다른 주석은 " "영향을 받지 않습니다." #: ../../page.rst:352 c550602fc16b4fb8a1296b8ddcc34b9c msgid "" "All overlapping links will be removed. If the rectangle of the link was " "covering text, then only the overlapping part of the text is being " "removed. Similar applies to images covered by link rectangles." msgstr "" "모든 겹치는 링크가 제거됩니다. 링크의 사각형이 텍스트를 덮고 있으면 텍스트의 겹치는 부분만 제거됩니다. 링크 사각형으로 덮인 " "이미지에도 유사하게 적용됩니다." #: ../../page.rst:354 40b2cb822b0647bdae0d55262944a78a msgid "" "The overlapping parts of **images** will be blanked-out for default " "option `PDF_REDACT_IMAGE_PIXELS` (changed in v1.18.0). Option 0 does not " "touch any images and 1 will remove any image with an overlap." msgstr "" "**이미지** 의 겹치는 부분은 기본 옵션 `PDF_REDACT_IMAGE_PIXELS` (v1.18.0에서 변경됨)에 대해 " "지워집니다. 옵션 0은 이미지를 건드리지 않고 1은 겹치는 모든 이미지를 제거합니다." #: ../../page.rst:356 25b61da15edd48a0899311789eb7ce0f msgid "" "For option `images=PDF_REDACT_IMAGE_REMOVE` only this page's **references" " to the images** are removed - not necessarily the images themselves. " "Images are completely removed from the file only, if no longer referenced" " at all (assuming suitable garbage collection options)." msgstr "" "옵션 `images=PDF_REDACT_IMAGE_REMOVE` 의 경우 이 페이지의 **이미지에 대한 참조** 만 제거됩니다 - " "반드시 이미지 자체는 아닙니다. 이미지는 더 이상 전혀 참조되지 않는 경우에만 파일에서 완전히 제거됩니다(적절한 가비지 수집 옵션 " "가정)." #: ../../page.rst:358 16e6a9f129dd4eee890575533deb157d msgid "" "For option `images=PDF_REDACT_IMAGE_PIXELS` a new image of format PNG is " "created, which the page will use in place of the original one. The " "original image is not deleted or replaced as part of this process, so " "other pages may still show the original. In addition, the new, modified " "PNG image currently is **stored uncompressed**. Do keep these aspects in " "mind when choosing the right garbage collection method and compression " "options during save." msgstr "" "옵션 `images=PDF_REDACT_IMAGE_PIXELS` 의 경우 PNG 형식의 새 이미지가 생성되며, 페이지는 원본 대신 " "이것을 사용합니다. 원본 이미지는 이 프로세스의 일부로 삭제되거나 교체되지 않으므로 다른 페이지는 여전히 원본을 표시할 수 " "있습니다. 또한 새로 수정된 PNG 이미지는 현재 **압축되지 않은 상태로 저장됩니다**. 저장 중 적절한 가비지 수집 방법과 압축" " 옵션을 선택할 때 이러한 측면을 염두에 두세요." #: ../../page.rst:360 6836ae0f5eec41e98cc524e3c6d99a04 msgid "" "**Text removal** is done by character: A character is removed if its bbox" " has a **non-empty overlap** with a redaction rectangle (changed in MuPDF" " v1.17). Depending on the font properties and / or the chosen line " "height, deletion may occur for undesired text parts. Using " ":meth:`Tools.set_small_glyph_heights` with a ``True`` argument before " "text search may help to prevent this." msgstr "" "**텍스트 제거** 는 문자별로 수행됩니다: 문자의 bbox가 수정 사각형과 **비어 있지 않은 겹침** 이 있으면 " "제거됩니다(MuPDF v1.17에서 변경됨). 폰트 속성 및/또는 선택한 줄 높이에 따라 원하지 않는 텍스트 부분에 대한 삭제가 " "발생할 수 있습니다. 텍스트 검색 전에 ``True`` 인수로 :meth:`Tools.set_small_glyph_heights` " "를 사용하면 이를 방지하는 데 도움이 될 수 있습니다." #: ../../page.rst:362 d8fd1608b6084336aed580baa042cfaa msgid "" "Redactions are a simple way to replace single words in a PDF, or to just " "physically remove them. Locate the word \"secret\" using some text " "extraction or search method and insert a redaction using \"xxxxxx\" as " "replacement text for each occurrence." msgstr "" "수정은 PDF에서 단일 단어를 교체하거나 물리적으로 제거하는 간단한 방법입니다. 텍스트 추출 또는 검색 방법을 사용하여 " "\"secret\" 단어를 찾고 각 발생에 대해 \"xxxxxx\" 를 교체 텍스트로 사용하여 수정을 삽입합니다." #: ../../page.rst:364 47c46c9b96834ac9ad8367ae6450697d msgid "" "Be wary if the replacement is longer than the original -- this may lead " "to an awkward appearance, line breaks or no new text at all." msgstr "교체가 원본보다 긴 경우 주의하세요 -- 이것은 어색한 모양, 줄 바꿈 또는 새 텍스트가 전혀 없을 수 있습니다." #: ../../page.rst:366 8682db4dc4af41178c7504d6e0765c2b msgid "" "For a number of reasons, the new text may not exactly be positioned on " "the same line like the old one -- especially true if the replacement font" " was not one of CJK or :ref:`Base-14-Fonts`." msgstr "" "여러 가지 이유로 새 텍스트가 이전 텍스트와 정확히 같은 줄에 위치하지 않을 수 있습니다 -- 특히 교체 폰트가 CJK 또는 " ":ref:`Base-14-Fonts` 중 하나가 아닌 경우." #: ../../page.rst:371 8e9d6723068947caa9c1a7728e5ec00f msgid "" "Changed in v1.16.12: The previous *mark* parameter is gone. Instead, the " "respective rectangles are filled with the individual *fill* color of each" " redaction annotation. If a *text* was given in the annotation, then " ":meth:`insert_textbox` is invoked to insert it, using parameters provided" " with the redaction." msgstr "" "v1.16.12에서 변경됨: 이전 *mark* 매개변수가 제거되었습니다. 대신 각 수정 주석의 개별 *fill* 색상으로 해당 " "사각형이 채워집니다. 주석에 *text* 가 제공된 경우 :meth:`insert_textbox` 가 수정과 함께 제공된 매개변수를" " 사용하여 삽입하도록 호출됩니다." #: ../../page.rst:372 46f68e0c832a480ba4bd336ac3910095 msgid "" "Changed in v1.18.0: added option for handling images that overlap " "redaction areas." msgstr "v1.18.0에서 변경됨: 수정 영역과 겹치는 이미지를 처리하는 옵션 추가." #: ../../page.rst:373 2465ee7b86d54db8bee38570925d4320 msgid "Changed in v1.23.27: added option for removing graphics as well." msgstr "v1.23.27에서 변경됨: 그래픽 제거 옵션도 추가." #: ../../page.rst:374 c25bbe521c624b7ab8551b69d1b5a92e msgid "Changed in v1.24.2: added option `keep_text` to leave text untouched." msgstr "v1.24.2에서 변경됨: 텍스트를 그대로 두는 옵션 `keep_text` 추가." #: ../../page.rst:384 5b39575061fd4afaa2313b0f235fed1c msgid "" "PDF only: Add an annotation consisting of lines which connect the given " "points. A **Polygon's** first and last points are automatically " "connected, which does not happen for a **PolyLine**. The **rectangle** is" " automatically created as the smallest rectangle containing the points, " "each one surrounded by a circle of radius 3 (= 3 * line width). The " "following shows a 'PolyLine' that has been modified with colors and line " "ends." msgstr "" "PDF 전용: 주어진 점을 연결하는 선으로 구성된 주석을 추가합니다. **Polygon** 의 첫 번째와 마지막 점은 자동으로 " "연결되지만, **PolyLine** 에서는 그렇지 않습니다. **사각형** 은 점을 포함하는 가장 작은 사각형으로 자동 생성되며, " "각 점은 반경 3(= 3 * 선 너비)의 원으로 둘러싸입니다. 다음은 색상과 선 끝으로 수정된 'PolyLine'을 보여줍니다." #: ../../page.rst:386 bf625a70b5dc4b178bf672dc80445d94 msgid "a list of :data:`point_like` objects." msgstr ":data:`point_like` 객체의 리스트." #: ../../page.rst:389 3436f7a64b5947eabaebb816d9bed65e msgid "" "the created annotation. It is drawn with line color black, line width 1 " "no fill color but fill color support. Use methods of :ref:`Annot` to make" " any changes to achieve something like this:" msgstr "" "생성된 주석. 선 색상 검은색, 선 너비 1, 채우기 색상 없음이지만 채우기 색상 지원. 다음과 같은 것을 달성하기 위해 변경하려면" " :ref:`Annot` 의 메서드를 사용하세요:" #: ../../page.rst:402 4dd3a4352c934a608cde37542c01e320 msgid "" "PDF only: These annotations are normally used for **marking text** which " "has previously been somehow located (for example via " ":meth:`Page.search_for`). But this is not required: you are free to " "\"mark\" just anything." msgstr "" "PDF 전용: 이러한 주석은 일반적으로 이전에 어떤 방식으로든 찾은(예: :meth:`Page.search_for` 를 통해) " "**텍스트를 표시** 하는 데 사용됩니다. 하지만 이것은 필수는 아닙니다: 무엇이든 \"표시\"할 수 있습니다." #: ../../page.rst:404 ea4d8dff219844daa8178bfd53fe0a12 msgid "" "Standard (stroke only -- no fill color support) colors are chosen per " "annotation type: **yellow** for highlighting, **red** for striking out, " "**green** for underlining, and **magenta** for wavy underlining." msgstr "" "표준(스트로크만 -- 채우기 색상 지원 없음) 색상은 주석 유형별로 선택됩니다: 강조는 **노란색**, 취소선은 **빨간색**, " "밑줄은 **초록색**, 물결 밑줄은 **자홍색**." #: ../../page.rst:406 fd77f9fb49924c3b983cc2177df9713c msgid "" "All these four methods convert the arguments into a list of :ref:`Quad` " "objects. The **annotation** rectangle is then calculated to envelop all " "these quadrilaterals." msgstr "" "이 네 가지 메서드는 모두 인수를 :ref:`Quad` 객체의 리스트로 변환합니다. 그런 다음 **주석** 사각형이 이러한 모든 " "사각형을 둘러싸도록 계산됩니다." #: ../../page.rst:410 b78e92f1133b4f79b8e187d5fdea27b7 msgid "" ":meth:`search_for` delivers a list of either :ref:`Rect` or :ref:`Quad` " "objects. Such a list can be directly used as an argument for these " "annotation types and will deliver **one common annotation** for all " "occurrences of the search string::" msgstr "" ":meth:`search_for` 는 :ref:`Rect` 또는 :ref:`Quad` 객체의 리스트를 제공합니다. 이러한 리스트는 " "이러한 주석 유형에 대한 인수로 직접 사용할 수 있으며 검색 문자열의 모든 발생에 대해 **하나의 공통 주석** 을 제공합니다::" #: ../../page.rst:417 3704912806054f3d84b31c8400d3484c msgid "" "Obviously, text marker annotations need to know what is the top, the " "bottom, the left, and the right side of the area(s) to be marked. If the " "arguments are quads, this information is given by the sequence of the " "quad points. In contrast, a rectangle delivers much less information -- " "this is illustrated by the fact, that 4! = 24 different quads can be " "constructed with the four corners of a rectangle." msgstr "" "명백히, 텍스트 마커 주석은 표시할 영역의 위, 아래, 왼쪽, 오른쪽이 무엇인지 알아야 합니다. 인수가 quad인 경우 이 정보는 " "quad 점의 시퀀스로 제공됩니다. 반면 사각형은 훨씬 적은 정보를 제공합니다 -- 사각형의 네 모서리로 4! = 24개의 서로 " "다른 quad를 구성할 수 있다는 사실로 설명됩니다." #: ../../page.rst:419 108dfad6a6804b93849fe97049fcbb6b msgid "" "Therefore, we **strongly recommend** to use the `quads` option for text " "searches, to ensure correct annotations. A similar consideration applies " "to marking **text spans** extracted with the \"dict\" / \"rawdict\" " "options of :meth:`Page.get_text`. For more details on how to compute " "quadrilaterals in this case, see section \"How to Mark Non-horizontal " "Text\" of :ref:`FAQ`." msgstr "" "따라서 올바른 주석을 보장하기 위해 텍스트 검색에 `quads` 옵션을 사용하는 것을 **강력히 권장** 합니다. " ":meth:`Page.get_text` 의 \"dict\" / \"rawdict\" 옵션으로 추출한 **텍스트 범위** 를 표시하는" " 데도 유사한 고려 사항이 적용됩니다. 이 경우 사각형을 계산하는 방법에 대한 자세한 내용은 :ref:`FAQ` 의 \"How to" " Mark Non-horizontal Text\" 섹션을 참조하세요." #: ../../page.rst:421 bfe59f51028a411fa50cabaf2e094b6e msgid "" "the location(s) -- rectangle(s) or quad(s) -- to be marked. (Changed in " "v1.14.20) A list or tuple must consist of :data:`rect_like` or " ":data:`quad_like` items (or even a mixture of either). Every item must be" " finite, convex and not empty (as applicable). **Set this parameter to** " "``None`` if you want to use the following arguments (Changed in " "v1.16.14). And vice versa: if not ``None``, the remaining parameters must" " be ``None``." msgstr "" "표시할 위치(들) -- 사각형(들) 또는 quad(들). (v1.14.20에서 변경됨) 리스트 또는 튜플은 " ":data:`rect_like` 또는 :data:`quad_like` 항목(또는 둘의 혼합)으로 구성되어야 합니다. 모든 항목은 " "유한하고 볼록하며 비어 있지 않아야 합니다(해당하는 경우). 다음 인수를 사용하려면 **이 매개변수를** ``None`` **으로 " "설정하세요** (v1.16.14에서 변경됨). 반대로 ``None`` 이 아니면 나머지 매개변수는 ``None`` 이어야 합니다." #: ../../page.rst:428 697342726fe34ff398a5409e6779d128 msgid "" "start text marking at this point. Defaults to the top-left point of " "*clip*. Must be provided if `quads` is ``None``. (New in v1.16.14)" msgstr "" "이 지점에서 텍스트 표시를 시작합니다. 기본값은 *clip* 의 왼쪽 위 점입니다. `quads` 가 ``None`` 이면 제공해야" " 합니다. (v1.16.14에서 새로 추가됨)" #: ../../page.rst:429 99afe3b4e6cf47ac8ea2a1d1d7b606ae msgid "" "stop text marking at this point. Defaults to the bottom-right point of " "*clip*. Must be used if `quads` is ``None``. (New in v1.16.14)" msgstr "" "이 지점에서 텍스트 표시를 중지합니다. 기본값은 *clip* 의 오른쪽 아래 점입니다. `quads` 가 ``None`` 이면 " "사용해야 합니다. (v1.16.14에서 새로 추가됨)" #: ../../page.rst:430 bea300d1621748ce83ab03b89f2b395e msgid "" "only consider text lines intersecting this area. Defaults to the page " "rectangle. Only use if `start` and `stop` are provided. (New in v1.16.14)" msgstr "" "이 영역과 교차하는 텍스트 줄만 고려합니다. 기본값은 페이지 사각형입니다. `start` 와 `stop` 이 제공된 경우에만 " "사용하세요. (v1.16.14에서 새로 추가됨)" #: ../../page.rst:432 6474b312ac1a4d25852c770d5bdf88d8 msgid ":ref:`Annot` or ``None`` (changed in v1.16.14)." msgstr ":ref:`Annot` 또는 ``None`` (v1.16.14에서 변경됨)." #: ../../page.rst:433 74842949adb04e869dce146ffd17a597 msgid "" "the created annotation. If *quads* is an empty list, **no annotation** is" " created (changed in v1.16.14)." msgstr "생성된 주석. *quads* 가 빈 리스트이면 **주석이 생성되지 않습니다** (v1.16.14에서 변경됨)." #: ../../page.rst:436 d493279763eb4f87a14d71a66c32af2f msgid "" "You can use parameters *start*, *stop* and *clip* to highlight " "consecutive lines between the points *start* and *stop* (starting with " "v1.16.14). Make use of *clip* to further reduce the selected line bboxes " "and thus deal with e.g. multi-column pages. The following multi-line " "highlight on a page with three text columns was created by specifying the" " two red points and setting clip accordingly." msgstr "" "매개변수 *start*, *stop* 및 *clip* 을 사용하여 점 *start* 와 *stop* 사이의 연속 줄을 강조할 수 " "있습니다(v1.16.14부터). *clip* 을 사용하여 선택된 줄 bbox를 더 줄여 예를 들어 다중 열 페이지를 처리합니다. 세" " 개의 텍스트 열이 있는 페이지의 다음 다중 줄 강조는 두 개의 빨간 점을 지정하고 clip을 그에 따라 설정하여 생성되었습니다." #: ../../page.rst:445 d74c77b69420460eb871f194686b3c80 msgid "" "Cluster vector graphics (synonyms are line-art or drawings) based on " "their geometrical vicinity. The method walks through the output of " ":meth:`Page.get_drawings` and joins paths whose `path[\"rect\"]` are " "closer to each other than some tolerance values (given in the arguments)." " The result is a list of rectangles that each wrap things like tables " "(with gridlines), pie charts, bar charts, etc." msgstr "" "기하학적 근접성을 기반으로 벡터 그래픽(line-art 또는 drawings의 동의어)을 클러스터링합니다. 이 메서드는 " ":meth:`Page.get_drawings` 의 출력을 순회하고 `path[\"rect\"]` 가 인수에 주어진 일부 허용 오차 " "값보다 서로 가까운 경로를 결합합니다. 결과는 각각 테이블(격자선 포함), 파이 차트, 막대 차트 등을 래핑하는 사각형의 " "리스트입니다." #: ../../page.rst:447 ef1d1a3ba8044b5a8123bb549d84a95b msgid "only consider paths inside this area. The default is the full page." msgstr "이 영역 내의 경로만 고려합니다. 기본값은 전체 페이지입니다." #: ../../page.rst:449 996f2a02107e43a2af1da07cdc4de257 msgid "" "(optional) provide a previously generated output of " ":meth:`Page.get_drawings`. If `None` the method will execute the method." msgstr "" "(선택 사항) :meth:`Page.get_drawings` 의 이전에 생성된 출력을 제공합니다. `None` 이면 메서드가 " "메서드를 실행합니다." #: ../../page.rst:451 2248b6e73ea7456f90b4bfa892920615 msgid "" "Assume vector graphics to be close enough neighbors for belonging to the " "same rectangle. Default is 3 points." msgstr "벡터 그래픽이 같은 사각형에 속하기에 충분히 가까운 이웃이라고 가정합니다. 기본값은 3포인트입니다." #: ../../page.rst:453 fc002ef42f2f4c3cb5bd1d64346b1c48 msgid "" "If `True` (default), the method will to remove rectangles having width or" " height smaller than the respective tolerance value. If `False` no such " "filtering is done." msgstr "" "`True` (기본값)이면 메서드는 너비 또는 높이가 각각의 허용 오차 값보다 작은 사각형을 제거합니다. `False` 이면 이러한" " 필터링이 수행되지 않습니다." #: ../../page.rst:457 06ada75b5a1e4fb59ff381d81b4677e9 msgid "" "Find tables on the page and return an object with related information. " "Typically, the default values of the many parameters will be sufficient. " "Adjustments should ever only be needed in corner case situations." msgstr "" "페이지에서 테이블을 찾고 관련 정보가 있는 객체를 반환합니다. 일반적으로 많은 매개변수의 기본값으로 충분합니다. 조정은 극단적인 " "경우에만 필요해야 합니다." #: ../../page.rst:459 0c9311c5177241cc976d58ebbf05a74b msgid "" "specify a region to consider within the page rectangle and ignore the " "rest. Default is the full page." msgstr "페이지 사각형 내에서 고려할 영역을 지정하고 나머지는 무시합니다. 기본값은 전체 페이지입니다." #: ../../page.rst:461 0849ed084d16401a9405689de88c6028 msgid "" "Request a **table detection** strategy. Valid values are \"lines\", " "\"lines_strict\" and \"text\". Default is **\"lines\"** which uses all " "vector graphics on the page to detect grid lines. Strategy " "**\"lines_strict\"** ignores borderless rectangle vector graphics. " "Sometimes single text pieces have background colors which may lead to " "false columns or lines. This strategy ignores them and can thus increase " "detection precision. If **\"text\"** is specified, text positions are " "used to generate \"virtual\" column and / or row boundaries. Use " "`min_words_*` to request the number of words for considering their " "coordinates. Use parameters `vertical_strategy` and " "`horizontal_strategy` **instead** for a more fine-grained treatment of " "the dimensions." msgstr "" #: ../../page.rst:461 59bbe23f13b64174be60fb9b13ef829b msgid "" "Request a **table detection** strategy. Valid values are \"lines\", " "\"lines_strict\" and \"text\"." msgstr "**테이블 감지** 전략을 요청합니다. 유효한 값은 \"lines\", \"lines_strict\" 및 \"text\"입니다." #: ../../page.rst:463 67630a4262924cc0b8aaebb89659163f msgid "" "Default is **\"lines\"** which uses all vector graphics on the page to " "detect grid lines." msgstr "기본값은 페이지의 모든 벡터 그래픽을 사용하여 격자선을 감지하는 **\"lines\"** 입니다." #: ../../page.rst:465 917a16e50aac418b8449496f8539789f msgid "" "Strategy **\"lines_strict\"** ignores borderless rectangle vector " "graphics. Sometimes single text pieces have background colors which may " "lead to false columns or lines. This strategy ignores them and can thus " "increase detection precision." msgstr "" "전략 **\"lines_strict\"** 는 테두리 없는 사각형 벡터 그래픽을 무시합니다. 때로는 단일 텍스트 조각에 배경색이 " "있어 잘못된 열이나 줄을 유발할 수 있습니다. 이 전략은 이를 무시하므로 감지 정밀도를 높일 수 있습니다." #: ../../page.rst:467 6d39e7994a18489c9d4948721b10cb65 msgid "" "If **\"text\"** is specified, text positions are used to generate " "\"virtual\" column and / or row boundaries. Use `min_words_*` to request " "the number of words for considering their coordinates." msgstr "" "**\"text\"** 가 지정되면 텍스트 위치를 사용하여 \"가상\" 열 및/또는 행 경계를 생성합니다. `min_words_*`" " 를 사용하여 좌표를 고려하기 위한 단어 수를 요청합니다." #: ../../page.rst:469 4a9d3be706634b32bfcb3a2d83e20c65 msgid "" "Use parameters `vertical_strategy` and `horizontal_strategy` **instead** " "for a more fine-grained treatment of the dimensions." msgstr "" "차원에 대한 더 세밀한 처리를 위해 매개변수 `vertical_strategy` 및 `horizontal_strategy` 를 " "**대신** 사용하세요." #: ../../page.rst:471 15e7fe12ec2247fbbb34818a5eff8199 msgid "" "y-coordinates of rows. If provided, there will be no attempt to identify " "additional table rows. This influences table detection." msgstr "행의 y 좌표. 제공되면 추가 테이블 행을 식별하려는 시도가 없습니다. 이것은 테이블 감지에 영향을 줍니다." #: ../../page.rst:473 4dc514da6d994fa5baff233b3567f0d4 msgid "" "x-coordinates of columns. If provided, there will be no attempt to " "identify additional table columns. This influences table detection." msgstr "열의 x 좌표. 제공되면 추가 테이블 열을 식별하려는 시도가 없습니다. 이것은 테이블 감지에 영향을 줍니다." #: ../../page.rst:475 6a395bf9fe0545ea97c66c3ad92a7ae0 msgid "" "relevant for vertical strategy option \"text\": at least this many words " "must coincide to establish a **virtual column** boundary." msgstr "수직 전략 옵션 \"text\"와 관련: **가상 열** 경계를 설정하려면 최소 이만큼의 단어가 일치해야 합니다." #: ../../page.rst:477 41131201c866498ab06ef20259e8b494 msgid "" "relevant for horizontal strategy option \"text\": at least this many " "words must coincide to establish a **virtual row** boundary." msgstr "수평 전략 옵션 \"text\"와 관련: **가상 행** 경계를 설정하려면 최소 이만큼의 단어가 일치해야 합니다." #: ../../page.rst:479 26168ab280dd42a7bb9a4c34a044a502 msgid "" "Any two horizontal lines whose y-values differ by no more than this value" " will be **snapped** into one. Accordingly for vertical lines. Default is" " 3. Separate values can be specified instead for the dimensions, using " "`snap_x_tolerance` and `snap_y_tolerance`." msgstr "" "y 값의 차이가 이 값 이하인 두 개의 수평선은 하나로 **스냅** 됩니다. 수직선도 마찬가지입니다. 기본값은 3입니다. 이 값 대신 `snap_x_tolerance` 및 `snap_y_tolerance` 를 사용하여 차원별로 별도의 값을 지정할 수 있습니다." #: ../../page.rst:481 1bce671a9bde42b3bcb301e9dc7929e7 msgid "" "Any two lines will be **joined** to one if the end and the start points " "differ by no more than this value (in points). Default is 3. Instead of " "this value, separate values can be specified for the dimensions using " "`join_x_tolerance` and `join_y_tolerance`." msgstr "" "끝점과 시작점의 차이가 이 값(포인트 단위) 이하인 경우 두 선이 하나로 **결합** 됩니다. 기본값은 3입니다. 이 값 대신 `join_x_tolerance` 및 `join_y_tolerance` 를 사용하여 차원별로 별도의 값을 지정할 수 있습니다." #: ../../page.rst:483 00e7c337bf764aa5a2eae76cdd16ae4a msgid "" "Ignore a line if its length does not exceed this value (points). Default " "is 3." msgstr "길이가 이 값(포인트 단위)을 초과하지 않으면 선을 무시합니다. 기본값은 3입니다." #: ../../page.rst:485 0be2257abf46430e99630f4f4a04f230 msgid "" "When combining lines into cell borders, orthogonal lines must be within " "this value (points) to be considered intersecting. Default is 3. Instead " "of this value, separate values can be specified for the dimensions using " "`intersection_x_tolerance` and `intersection_y_tolerance`." msgstr "" "선을 셀 경계로 결합할 때 직교하는 선은 교차하는 것으로 간주되려면 이 값(포인트 단위) 이내에 있어야 합니다. 기본값은 3입니다. 이 값 대신 `intersection_x_tolerance` 및 `intersection_y_tolerance` 를 사용하여 차원별로 별도의 값을 지정할 수 있습니다." #: ../../page.rst:487 dedd15f25c9f481997ff9451f0f5eaf6 msgid "" "Characters will be combined into words only if their distance is no " "larger than this value (points). Default is 3. Instead of this value, " "separate values can be specified for the dimensions using " "`text_x_tolerance` and `text_y_tolerance`." msgstr "" "문자가 단어로 결합되는 것은 거리가 이 값(포인트 단위) 이하인 경우에만입니다. 기본값은 3입니다. 이 값 대신 `text_x_tolerance` 및 `text_y_tolerance` 를 사용하여 차원별로 별도의 값을 지정할 수 있습니다." #: ../../page.rst:489 f08fd2e9d00f4dac93ce2b4c53ec8d83 msgid "" "Specify a list of \"lines\" (i.e. pairs of :data:`point_like` objects) as" " **additional**, \"virtual\" vector graphics. These lines may help with " "table and / or cell detection and will not otherwise influence the " "detection strategy. Especially, in contrast to parameters " "`horizontal_lines` and `vertical_lines`, they will not prevent detecting " "rows or columns in other ways. These lines will be treated exactly like " "\"real\" vector graphics in terms of joining, snapping, intersecting, " "minimum length and containment in the `clip` rectangle. Similarly, lines " "not parallel to any of the coordinate axes will be ignored." msgstr "" "\"lines\"(즉, :data:`point_like` 객체 쌍)의 리스트를 **추가** \"가상\" 벡터 그래픽으로 지정합니다. 이러한 선은 테이블 및/또는 셀 감지에 도움이 될 수 있으며 감지 전략에는 영향을 주지 않습니다. 특히 `horizontal_lines` 및 `vertical_lines` 매개변수와 달리 다른 방법으로 행이나 열을 감지하는 것을 방지하지 않습니다. 이러한 선은 결합, 스냅, 교차, 최소 길이 및 `clip` 사각형 내 포함 측면에서 \"실제\" 벡터 그래픽과 정확히 동일하게 처리됩니다. 마찬가지로 좌표축 중 어느 것과도 평행하지 않은 선은 무시됩니다." #: ../../page.rst:491 c0c00b0e2c6a4e68bc1e1d28b6fd62de msgid "" "Specify a list of rectangles (:data:`rect_like` objects) as " "**additional**, \"virtual\" vector graphics. These rectangles may help " "with table and / or cell detection and will not otherwise influence the " "detection strategy. Especially, in contrast to parameters " "`horizontal_lines` and `vertical_lines`, they will not prevent detecting " "rows or columns in other ways. These rectangles will be treated exactly " "like \"real\" vector graphics in terms of joining, snapping, " "intersecting, minimum length and containment in the `clip` rectangle." msgstr "" "사각형(:data:`rect_like` 객체)의 리스트를 **추가** \"가상\" 벡터 그래픽으로 지정합니다. 이러한 사각형은 테이블 및/또는 셀 감지에 도움이 될 수 있으며 감지 전략에는 영향을 주지 않습니다. 특히 `horizontal_lines` 및 `vertical_lines` 매개변수와 달리 다른 방법으로 행이나 열을 감지하는 것을 방지하지 않습니다. 이러한 사각형은 결합, 스냅, 교차, 최소 길이 및 `clip` 사각형 내 포함 측면에서 \"실제\" 벡터 그래픽과 정확히 동일하게 처리됩니다." #: ../../page.rst:493 af5ac1f1b1ad4b87b5c8e3c21cea5682 msgid "" "list of vector graphics in the format as returned be " ":meth:`Page.get_drawings`. Using this parameter will prevent the method " "to extract vector graphics itself. This is useful if the vector graphics " "are already available. This can save execution time significantly." msgstr "" ":meth:`Page.get_drawings` 에서 반환되는 형식의 벡터 그래픽 리스트. 이 매개변수를 사용하면 메서드가 벡터 그래픽을 자체적으로 추출하지 않습니다. 벡터 그래픽이 이미 사용 가능한 경우 유용합니다. 이것은 실행 시간을 크게 절약할 수 있습니다." #: ../../page.rst:497 6a7b22cafaa94fd1903b1029979996b7 msgid "" "a `TableFinder` object that has the following significant attributes: * " "`cells`: a list of **all bboxes** on the page, that have been identified " "as table cells (across all tables). Each cell is a :data:`rect_like` " "tuple `(x0, y0, x1, y1)` of coordinates or `None`. * `tables`: a list of " "`Table` objects. This is `[]` if the page has no tables. Single tables " "can be found as items of this list. But the `TableFinder` object itself " "is also a sequence of its tables. This means that if `tabs` is a " "`TableFinder` object, then table \"n\" is delivered by `tabs.tables[n]` " "as well as by the shorter `tabs[n]`. * The `Table` object has the " "following attributes: * ``bbox``: the bounding box of the table as a " "tuple `(x0, y0, x1, y1)`. * ``cells``: bounding boxes of the table's " "cells (list of tuples). A cell may also be `None`. * ``extract()``: " "this method returns the text content of each table cell as a list of list" " of strings. * ``to_markdown()``: this method returns the table as a " "**string in markdown format** (compatible to Github). Markdown viewers " "can render the string as a table. This output is optimized for **small " "token** sizes, which is especially beneficial for LLM/RAG feeds. Pandas " "DataFrames (see method `to_pandas()` below) offer an equivalent markdown " "table output which however is better readable for the human eye. Any line" " breaks (``\\n``) in cells are replaced by HTML line breaks tags `
`." " * `to_pandas()`: this method returns the table as a `pandas " "`_ `DataFrame " "`_. DataFrames are " "very versatile objects allowing a plethora of table manipulation methods " "and outputs to almost 20 well-known formats, among them Excel files, CSV," " JSON, markdown-formatted tables and more. `DataFrame.to_markdown()` " "generates a Github-compatible markdown format optimized for human " "readability. This method however requires the package `tabulate " "`_ to be installed in addition to " "pandas itself. * ``header``: a `TableHeader` object containing header " "information of the table. * ``col_count``: an integer containing the " "number of table columns. * ``row_count``: an integer containing the " "number of table rows. * ``rows``: a list of `TableRow` objects " "containing two attributes, ``bbox`` is the boundary box of the row, and " "`cells` is a list of table cells contained in this row. * The " "`TableHeader` object has the following attributes: * ``bbox``: the " "bounding box of the header. * `cells`: a list of bounding boxes " "containing the name of the respective column. * `names`: a list of " "strings containing the text of each of the cell bboxes. They represent " "the column names -- which are used when exporting the table to pandas " "DataFrames, markdown, etc. * `external`: a bool indicating whether the " "header bbox is outside the table body (`True`) or not. Table headers are " "never identified by the `TableFinder` logic. Therefore, if `external` is " "true, then the header cells are not part of any cell identified by " "`TableFinder`. If `external == False`, then the first table row is the " "header. Please have a look at these `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages. .. caution:: The " "lifetime of the `TableFinder` object, as well as that of all its tables " "**equals the lifetime of the page**. If the page object is deleted or " "reassigned, all tables are no longer valid. The only way to keep " "table content beyond the page's availability is to **extract it** via " "methods `Table.to_markdown()`, `Table.to_pandas()` or a copy of " "`Table.extract()` (e.g. `Table.extract()[:]`). .. note:: Once a " "table has been extracted to a **Pandas DataFrame** with `to_pandas()` it " "is easy to convert to other file types with the **Pandas API**: - " "table to Markdown, use `to_markdown " "`_" " - table to JSON, use: `to_json " "`_" " - table to Excel, use: `to_excel " "`_" " - table to CSV, use: `to_csv " "`_" " - table to HTML, use: `to_html " "`_" " - table to SQL, use: `to_sql " "`_" msgstr "" #: ../../page.rst:497 14ce635b23574ea2aa79e06c2f67cb17 msgid "a `TableFinder` object that has the following significant attributes:" msgstr "다음 중요한 속성을 가진 `TableFinder` 객체:" #: ../../page.rst:499 d2cd90b9f2244722aad190152e8e2c32 msgid "" "`cells`: a list of **all bboxes** on the page, that have been identified " "as table cells (across all tables). Each cell is a :data:`rect_like` " "tuple `(x0, y0, x1, y1)` of coordinates or `None`." msgstr "" "`cells`: 페이지의 **모든 bbox** 의 리스트로, 테이블 셀로 식별된 것들(모든 테이블에 걸쳐). 각 셀은 " ":data:`rect_like` 좌표 튜플 `(x0, y0, x1, y1)` 또는 `None` 입니다." #: ../../page.rst:500 8631b526108946f0923ac7ccbc41d5a4 msgid "" "`tables`: a list of `Table` objects. This is `[]` if the page has no " "tables. Single tables can be found as items of this list. But the " "`TableFinder` object itself is also a sequence of its tables. This means " "that if `tabs` is a `TableFinder` object, then table \"n\" is delivered " "by `tabs.tables[n]` as well as by the shorter `tabs[n]`." msgstr "" "`tables`: `Table` 객체의 리스트. 페이지에 테이블이 없으면 이것은 `[]` 입니다. 단일 테이블은 이 리스트의 " "항목으로 찾을 수 있습니다. 하지만 `TableFinder` 객체 자체는 또한 테이블의 시퀀스입니다. 이것은 `tabs` 가 " "`TableFinder` 객체이면 테이블 \"n\"은 `tabs.tables[n]` 뿐만 아니라 더 짧은 `tabs[n]` 으로도 " "제공된다는 것을 의미합니다." #: ../../page.rst:503 bf87893f818b480584c90a29e1dbfa51 msgid "The `Table` object has the following attributes:" msgstr "`Table` 객체는 다음 속성을 가집니다:" #: ../../page.rst:505 df3028a1564f40df8e43a1893d30ae4e msgid "``bbox``: the bounding box of the table as a tuple `(x0, y0, x1, y1)`." msgstr "``bbox``: 튜플 `(x0, y0, x1, y1)` 로서의 테이블의 경계 상자." #: ../../page.rst:506 f5cc4094136b46c08a012633df49c27b msgid "" "``cells``: bounding boxes of the table's cells (list of tuples). A cell " "may also be `None`." msgstr "``cells``: 테이블의 셀의 경계 상자(튜플의 리스트). 셀은 `None` 일 수도 있습니다." #: ../../page.rst:507 b3a304e981ed49d4b70f79e9b07aaaeb msgid "" "``extract()``: this method returns the text content of each table cell as" " a list of list of strings." msgstr "``extract()``: 이 메서드는 각 테이블 셀의 텍스트 콘텐츠를 문자열의 리스트의 리스트로 반환합니다." #: ../../page.rst:508 ce2f7d37a3e741658ddc96d3dc5c24a6 msgid "" "``to_markdown()``: this method returns the table as a **string in " "markdown format** (compatible to Github). Markdown viewers can render the" " string as a table. This output is optimized for **small token** sizes, " "which is especially beneficial for LLM/RAG feeds. Pandas DataFrames (see " "method `to_pandas()` below) offer an equivalent markdown table output " "which however is better readable for the human eye. Any line breaks " "(``\\n``) in cells are replaced by HTML line breaks tags `
`." msgstr "" "``to_markdown()``: 이 메서드는 테이블을 **마크다운 형식의 문자열** (Github과 호환)로 반환합니다. 마크다운" " 뷰어는 문자열을 테이블로 렌더링할 수 있습니다. 이 출력은 **작은 토큰** 크기에 최적화되어 있으며, 이는 LLM/RAG 피드에" " 특히 유익합니다. Pandas DataFrames (아래 `to_pandas()` 메서드 참조)는 동등한 마크다운 테이블 출력을 " "제공하지만 사람이 읽기에 더 좋습니다. 셀의 모든 줄 바꿈(``\\n``)은 HTML 줄 바꿈 태그 `
` 로 대체됩니다." #: ../../page.rst:509 dc4adc6d410b4f17bc5e500986371e2c msgid "" "`to_pandas()`: this method returns the table as a `pandas " "`_ `DataFrame " "`_. DataFrames are " "very versatile objects allowing a plethora of table manipulation methods " "and outputs to almost 20 well-known formats, among them Excel files, CSV," " JSON, markdown-formatted tables and more. `DataFrame.to_markdown()` " "generates a Github-compatible markdown format optimized for human " "readability. This method however requires the package `tabulate " "`_ to be installed in addition to " "pandas itself." msgstr "" "`to_pandas()`: 이 메서드는 테이블을 `pandas `_ " "`DataFrame `_ 로 " "반환합니다. DataFrames는 매우 다재다능한 객체로, 다양한 테이블 조작 메서드와 Excel 파일, CSV, JSON, " "마크다운 형식의 테이블 등을 포함하여 거의 20개의 잘 알려진 형식으로의 출력을 허용합니다. " "`DataFrame.to_markdown()` 은 사람이 읽기에 최적화된 Github 호환 마크다운 형식을 생성합니다. 그러나 이 " "메서드는 pandas 자체에 추가로 `tabulate `_ 패키지가" " 설치되어 있어야 합니다." #: ../../page.rst:510 9197d223052b40478ad07f80abf7b1c7 msgid "" "``header``: a `TableHeader` object containing header information of the " "table." msgstr "``header``: 테이블의 헤더 정보를 포함하는 `TableHeader` 객체." #: ../../page.rst:511 0136219af3784df8a0ecdc0efae8d13e msgid "``col_count``: an integer containing the number of table columns." msgstr "``col_count``: 테이블 열 수를 포함하는 정수." #: ../../page.rst:512 7a998ad68618450b8121ca084004080d msgid "``row_count``: an integer containing the number of table rows." msgstr "``row_count``: 테이블 행 수를 포함하는 정수." #: ../../page.rst:513 0a15078fa0ff449f802c15643224935a msgid "" "``rows``: a list of `TableRow` objects containing two attributes, " "``bbox`` is the boundary box of the row, and `cells` is a list of table " "cells contained in this row." msgstr "" "``rows``: 두 가지 속성을 포함하는 `TableRow` 객체의 리스트, ``bbox`` 는 행의 경계 상자이고 `cells`" " 는 이 행에 포함된 테이블 셀의 리스트입니다." #: ../../page.rst:515 13b8c3920d2a4476a60f5b4097a1db29 msgid "The `TableHeader` object has the following attributes:" msgstr "`TableHeader` 객체는 다음 속성을 가집니다:" #: ../../page.rst:517 5bbd72ba48c345bc84309a25cc303e84 msgid "``bbox``: the bounding box of the header." msgstr "``bbox``: 헤더의 경계 상자." #: ../../page.rst:518 bd434f2182484c0abbe32315f3e87f58 msgid "" "`cells`: a list of bounding boxes containing the name of the respective " "column." msgstr "`cells`: 각 열의 이름을 포함하는 경계 상자의 리스트." #: ../../page.rst:519 7cf71a498dcd4f449eba656e7941013a msgid "" "`names`: a list of strings containing the text of each of the cell " "bboxes. They represent the column names -- which are used when exporting " "the table to pandas DataFrames, markdown, etc." msgstr "" "`names`: 각 셀 bbox의 텍스트를 포함하는 문자열의 리스트. 이것들은 열 이름을 나타냅니다 -- 테이블을 pandas " "DataFrames, 마크다운 등으로 내보낼 때 사용됩니다." #: ../../page.rst:520 eb6106330fdb44c2b44b4648645f7e28 msgid "" "`external`: a bool indicating whether the header bbox is outside the " "table body (`True`) or not. Table headers are never identified by the " "`TableFinder` logic. Therefore, if `external` is true, then the header " "cells are not part of any cell identified by `TableFinder`. If `external " "== False`, then the first table row is the header." msgstr "" "`external`: 헤더 bbox가 테이블 본문 밖에 있는지(`True`) 여부를 나타내는 bool. 테이블 헤더는 " "`TableFinder` 로직에 의해 식별되지 않습니다. 따라서 `external` 이 true이면 헤더 셀은 " "`TableFinder` 에 의해 식별된 모든 셀의 일부가 아닙니다. `external == False` 이면 첫 번째 테이블 행이" " 헤더입니다." #: ../../page.rst:522 7a5884e0d9f84076927207f38c8676ff msgid "" "Please have a look at these `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages." msgstr "" "한 페이지에 여러 테이블이 있거나 여러 페이지에 걸쳐 테이블 조각을 결합하는 것과 같은 표준 상황을 다루는 이 `Jupyter " "notebooks `_ 를 살펴보세요." #: ../../page.rst:524 27f38775b85f46ed9b56fc7858feddc5 msgid "" "The lifetime of the `TableFinder` object, as well as that of all its " "tables **equals the lifetime of the page**. If the page object is deleted" " or reassigned, all tables are no longer valid." msgstr "" "`TableFinder` 객체의 수명은 모든 테이블의 수명과 마찬가지로 **페이지의 수명과 같습니다**. 페이지 객체가 삭제되거나 " "재할당되면 모든 테이블이 더 이상 유효하지 않습니다." #: ../../page.rst:526 32b46a3c92844999ac692a3cd9b0e565 msgid "" "The only way to keep table content beyond the page's availability is to " "**extract it** via methods `Table.to_markdown()`, `Table.to_pandas()` or " "a copy of `Table.extract()` (e.g. `Table.extract()[:]`)." msgstr "" "페이지의 가용성을 넘어서 테이블 콘텐츠를 유지하는 유일한 방법은 메서드 `Table.to_markdown()`, " "`Table.to_pandas()` 또는 `Table.extract()` 의 복사본(예: `Table.extract()[:]`)을 " "통해 **추출하는** 것입니다." #: ../../page.rst:530 0af5c93cc78342cfba6d9a72d11d1283 msgid "" "Once a table has been extracted to a **Pandas DataFrame** with " "`to_pandas()` it is easy to convert to other file types with the **Pandas" " API**:" msgstr "" "테이블이 `to_pandas()` 로 **Pandas DataFrame** 으로 추출되면 **Pandas API** 로 다른 파일 " "형식으로 쉽게 변환할 수 있습니다:" #: ../../page.rst:532 89be66118eb1404fad9df9edac01c3df msgid "" "table to Markdown, use `to_markdown " "`_" msgstr "" "테이블을 Markdown으로, `to_markdown " "`_" " 사용" #: ../../page.rst:533 92c2673b625246218f1a2c042893181a msgid "" "table to JSON, use: `to_json " "`_" msgstr "" "테이블을 JSON으로, `to_json " "`_" " 사용" #: ../../page.rst:534 157ef119e8044b0c98c73fd91ce91237 msgid "" "table to Excel, use: `to_excel " "`_" msgstr "" "테이블을 Excel로, `to_excel " "`_" " 사용" #: ../../page.rst:535 2a6b453da70142089c467203f10917f7 msgid "" "table to CSV, use: `to_csv " "`_" msgstr "" "테이블을 CSV로, `to_csv " "`_" " 사용" #: ../../page.rst:536 f1c6b94997bf4e2ca9977927dbd80716 msgid "" "table to HTML, use: `to_html " "`_" msgstr "" "테이블을 HTML로, `to_html " "`_" " 사용" #: ../../page.rst:537 c9212bac99ad4a9e90b0fd8672a1f7ee msgid "" "table to SQL, use: `to_sql " "`_" msgstr "" "테이블을 SQL로, `to_sql " "`_" " 사용" #: ../../page.rst:542 540aa40545614f7293315543269c8972 msgid "New in version 1.23.0" msgstr "버전 1.23.0에서 새로 추가됨" #: ../../page.rst:543 36f561d72e0e474598eb7c9a62064674 msgid "Changed in version 1.23.19: new argument `add_lines`." msgstr "버전 1.23.19에서 변경됨: 새 인수 `add_lines`." #: ../../page.rst:549 3159f7a5d1f046b9b7b5148107aae428 msgid "" "There is also the `pdf2docx extract tables method`_ which is capable of " "table extraction if you prefer." msgstr "선호하는 경우 테이블 추출이 가능한 `pdf2docx extract tables method`_ 도 있습니다." #: ../../page.rst:554 ad10a4360b9a470085a13a03f9583cca msgid "" "PDF only: Add a \"rubber stamp\" annotation to e.g. indicate the " "document's intended use (\"DRAFT\", \"CONFIDENTIAL\", etc.). The " "parameter may be either an integer to select text from a predefined array" " of standard texts or an image." msgstr "" "PDF 전용: 예를 들어 문서의 의도된 용도(\"DRAFT\", \"CONFIDENTIAL\" 등)를 나타내기 위해 \"고무 " "도장\" 주석을 추가합니다. 매개변수는 표준 텍스트의 미리 정의된 배열에서 텍스트를 선택하는 정수이거나 이미지일 수 있습니다." #: ../../page.rst:556 b726e69c76e54f959d27f308c2c03a6c msgid "rectangle where to place the annotation." msgstr "주석을 배치할 사각형." #: ../../page.rst:557 dcc92434348946fdab577b695b1c09b6 msgid "" "The following options are available: * The id number (int) of the stamp " "text. For available stamps see :ref:`StampIcons`. * A string specifying " "an image file path. * A ``bytes``, ``bytearray`` or ``io.BytesIO`` " "object for an image in memory. * A :ref:`Pixmap`." msgstr "" #: ../../page.rst:557 6b4516a638e9428994ebcb405d2a1f09 msgid "The following options are available:" msgstr "다음 옵션을 사용할 수 있습니다:" #: ../../page.rst:559 05b78849e840483f9d546b8b9cb89785 msgid "" "The id number (int) of the stamp text. For available stamps see " ":ref:`StampIcons`." msgstr "스탬프 텍스트의 id 번호(int). 사용 가능한 스탬프는 :ref:`StampIcons` 를 참조하세요." #: ../../page.rst:561 9609e86db8ed47fc9c25d4201e538b48 msgid "A string specifying an image file path." msgstr "이미지 파일 경로를 지정하는 문자열." #: ../../page.rst:563 c78dc1111e5d4895aa33e226881ccee6 msgid "" "A ``bytes``, ``bytearray`` or ``io.BytesIO`` object for an image in " "memory." msgstr "메모리의 이미지에 대한 ``bytes``, ``bytearray`` 또는 ``io.BytesIO`` 객체." #: ../../page.rst:565 f2fd36bb8d92458188dd831f23ddbbd2 msgid "A :ref:`Pixmap`." msgstr ":ref:`Pixmap`." #: ../../page.rst:567 7b8c2a5f5ff6477aa270d0725931d67a msgid "**Text-based stamps**" msgstr "**텍스트 기반 스탬프**" #: ../../page.rst:569 7cdfb1bc6f584798b71c7c259befac33 msgid "" ":attr:`Annot.rect` is automatically calculated as the largest rectangle " "with an aspect ratio of ``width:height = 3.8`` that fits in the provided " "``rect``. Its position is vertically and horizontally centered." msgstr "" ":attr:`Annot.rect` 는 제공된 ``rect`` 에 맞는 ``width:height = 3.8`` 의 종횡비를 가진 " "가장 큰 사각형으로 자동 계산됩니다. 위치는 수직 및 수평으로 중앙 정렬됩니다." #: ../../page.rst:570 5187bddcaa8640d8a9ccd88e26edd292 msgid "The font chosen is \"Times Bold\" and the text will be upper case." msgstr "선택된 폰트는 \"Times Bold\"이며 텍스트는 대문자가 됩니다." #: ../../page.rst:571 c2a2656315f64270963a4678ec8683a4 msgid "" "The appearance can be modified using :meth:`Annot.set_opacity` and by " "setting the \"stroke\" color. By PDF specification, stamp annotations " "have no \"fill\" color." msgstr "" "외형은 :meth:`Annot.set_opacity` 를 사용하고 \"stroke\" 색상을 설정하여 수정할 수 있습니다. PDF " "사양에 따라 스탬프 주석은 \"fill\" 색상이 없습니다." #: ../../page.rst:575 3dcfbb130adb4f39b2420f2be36cd141 msgid "**Image-based stamps**" msgstr "**이미지 기반 스탬프**" #: ../../page.rst:577 9593065ae7dc41d5b57c103e9bdc3798 msgid "" "The image is scaled to fit into the rectangle `rect` such that the " "image's center and the center of `rect` coincide. The aspect ratio of the" " image is preserved, so the image may not fill the entire rectangle. " "However, at least one of the given rectangle's width or height are fully " "covered." msgstr "" "이미지는 이미지의 중심과 `rect` 의 중심이 일치하도록 `rect` 에 맞게 크기가 조정됩니다. 이미지의 종횡비가 유지되므로 " "이미지가 전체 사각형을 채우지 않을 수 있습니다. 그러나 주어진 사각형의 너비 또는 높이 중 하나 이상이 완전히 덮입니다." #: ../../page.rst:578 9099123803334c078412737bf2e61161 msgid "" "The annotation can be modified via :meth:`Annot.set_opacity`. This method" " therefore is a way to display images transparently even if no alpha " "channel is present." msgstr "" "주석은 :meth:`Annot.set_opacity` 를 통해 수정할 수 있습니다. 따라서 이 메서드는 알파 채널이 없는 경우에도 " "이미지를 투명하게 표시하는 방법입니다." #: ../../page.rst:579 d1f0df185de3499aac1f209854f3f544 msgid "Setting colors has no effect on image stamps." msgstr "색상 설정은 이미지 스탬프에 영향을 주지 않습니다." #: ../../page.rst:580 957b68c8ae304682b86ad1cf33484142 msgid "" "Rotating image-based stamps **is not supported**. Setting the rotation " "may lead to unexpected results." msgstr "이미지 기반 스탬프 회전은 **지원되지 않습니다**. 회전을 설정하면 예상치 못한 결과가 발생할 수 있습니다." #: ../../page.rst:584 08dc10754b5d431da2675e335e0ce9d4 msgid "" "PDF only: Add a PDF Form field (\"widget\") to a page. This also **turns " "the PDF into a Form PDF**. Because of the large amount of different " "options available for widgets, we have developed a new class " ":ref:`Widget`, which contains the possible PDF field attributes. It must " "be used for both, form field creation and updates." msgstr "" "PDF 전용: 페이지에 PDF 양식 필드(\"위젯\")를 추가합니다. 이것은 또한 **PDF를 양식 PDF로 전환** 합니다. " "위젯에 사용할 수 있는 다양한 옵션이 많기 때문에, 가능한 PDF 필드 속성을 포함하는 새 클래스 :ref:`Widget` 을 " "개발했습니다. 양식 필드 생성과 업데이트 모두에 사용해야 합니다." #: ../../page.rst:586 3bc45874507542b99cf2f9fca40aca42 msgid "a :ref:`Widget` object which must have been created upfront." msgstr "사전에 생성해야 하는 :ref:`Widget` 객체." #: ../../page.rst:589 04fd9437e4e14b78b68a9692f4cec067 msgid "a widget annotation." msgstr "위젯 주석." #: ../../page.rst:593 02ff91d382bc4d89a175faad1e927702 msgid "" "The removal will now include any bound 'Popup' or response annotations " "and related objects (changed in v1.16.6)." msgstr "제거는 이제 연결된 'Popup' 또는 응답 주석과 관련 객체를 포함합니다 (v1.16.6에서 변경됨)." #: ../../page.rst:595 5dcf92ac0b684108bb6755751932a302 msgid "PDF only: Delete annotation from the page and return the next one." msgstr "PDF 전용: 페이지에서 주석을 삭제하고 다음 주석을 반환합니다." #: ../../page.rst:597 63cff108bf9545cd8dd48fa9d507fa9f msgid "the annotation to be deleted." msgstr "삭제할 주석." #: ../../page.rst:601 2d773e7ef8e34abe9cda167207dd2ec2 msgid "" "the annotation following the deleted one. Please remember that physical " "removal requires saving to a new file with garbage > 0." msgstr "삭제된 주석 다음의 주석. 물리적 제거는 garbage > 0으로 새 파일에 저장해야 합니다." #: ../../page.rst:605 0d4d0fda3b604a55a4995a5a22bb22b7 msgid "PDF only: Delete field from the page and return the next one." msgstr "PDF 전용: 페이지에서 필드를 삭제하고 다음 필드를 반환합니다." #: ../../page.rst:607 dd15f294da3545fdbb50d95fb99a289b msgid "the widget to be deleted." msgstr "삭제할 위젯." #: ../../page.rst:610 ../../page.rst:1940 ../../page.rst:2264 #: 2a1b52b969354be08e1eb2839baeee5e 72454d0b5bf7432f874c41a2addc6110 #: c0e0b7c7fa7f4451998ab0755364fc6c msgid ":ref:`Widget`" msgstr ":ref:`Widget`" #: ../../page.rst:611 5946066daec546438c26065bdf00da57 msgid "" "the widget following the deleted one. Please remember that physical " "removal requires saving to a new file with garbage > 0." msgstr "삭제된 위젯 다음의 위젯. 물리적 제거는 garbage > 0으로 새 파일에 저장해야 합니다." #: ../../page.rst:615 94cc00cf1ef84081b9c1cf0a75e3acf4 msgid "(New in v1.18.4)" msgstr "(v1.18.4에서 새로 추가됨)" #: ../../page.rst:622 e5d426c154e94c7b984b51f59f16c523 msgid "" "PDF only: Delete the specified link from the page. The parameter must be " "an **original item** of :meth:`get_links()`, see " ":ref:`link_dict_description`. The reason for this is the dictionary's " "*\"xref\"* key, which identifies the PDF object to be deleted." msgstr "" "PDF 전용: 페이지에서 지정된 링크를 삭제합니다. 매개변수는 :meth:`get_links()` 의 **원본 항목** 이어야 " "하며, :ref:`link_dict_description` 을 참조하세요. 이것은 삭제할 PDF 객체를 식별하는 딕셔너리의 " "*\"xref\"* 키 때문입니다." #: ../../page.rst:624 a031646e991e4e9895b82ae759c2db66 msgid "the link to be deleted." msgstr "삭제할 링크." #: ../../page.rst:628 76e45868389e4b75832b5fb125c80a93 msgid "" "PDF only: Insert a new link on this page. The parameter must be a " "dictionary of format as provided by :meth:`get_links()`, see " ":ref:`link_dict_description`." msgstr "" "PDF 전용: 이 페이지에 새 링크를 삽입합니다. 매개변수는 :meth:`get_links()` 에서 제공하는 형식의 딕셔너리여야 " "하며, :ref:`link_dict_description` 을 참조하세요." #: ../../page.rst:630 64e75920afcb48d6a2fc9267af8f0384 msgid "the link to be inserted." msgstr "삽입할 링크." #: ../../page.rst:634 f13dc7c20063441aba1b7b636417de7b msgid "" "PDF only: Modify the specified link. The parameter must be a (modified) " "**original item** of :meth:`get_links()`, see " ":ref:`link_dict_description`. The reason for this is the dictionary's " "*\"xref\"* key, which identifies the PDF object to be changed." msgstr "" "PDF 전용: 지정된 링크를 수정합니다. 매개변수는 :meth:`get_links()` 의 (수정된) **원본 항목** 이어야 " "하며, :ref:`link_dict_description` 을 참조하세요. 이것은 변경할 PDF 객체를 식별하는 딕셔너리의 " "*\"xref\"* 키 때문입니다." #: ../../page.rst:636 a8c4c853e3ba4c6c9d0241071822f03d msgid "the link to be modified." msgstr "수정할 링크." #: ../../page.rst:638 484ca5ca85d2400f93f6ac66b30c5ffb msgid "" "If updating / inserting a URI link (`\"kind\": LINK_URI`), please make " "sure to start the value for the `\"uri\"` key with a disambiguating " "string like `\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, " "`\"mailto:\"`, etc. Otherwise -- depending on your browser or other " "\"consumer\" software -- unexpected default assumptions may lead to " "unwanted behaviours." msgstr "" "URI 링크(`\"kind\": LINK_URI`)를 업데이트/삽입하는 경우, `\"uri\"` 키의 값이 " "`\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, `\"mailto:\"`" " 등과 같은 명확한 문자열로 시작하도록 하세요. 그렇지 않으면 -- 브라우저나 다른 \"소비자\" 소프트웨어에 따라 -- 예상치 " "못한 기본 가정이 원하지 않는 동작을 유발할 수 있습니다." #: ../../page.rst:643 07c4f8dcaffa479cac56b83714185b8f msgid "PDF only: Return the label for the page." msgstr "PDF 전용: 페이지의 레이블을 반환합니다." #: ../../page.rst:647 ff3152eb66c14216b0b8db26b098505b msgid "the label string like \"vii\" for Roman numbering or \"\" if not defined." msgstr "로마 숫자의 경우 \"vii\"와 같은 레이블 문자열 또는 정의되지 않은 경우 \"\"." #: ../../page.rst:651 58e643e9e53146d188f0a553b3fda009 msgid "New in v1.18.6" msgstr "v1.18.6에서 새로 추가됨" #: ../../page.rst:657 bd5b5f45f592480fa60fad9a3255e097 msgid "Retrieves **all** links of a page." msgstr "페이지의 **모든** 링크를 검색합니다." #: ../../page.rst:660 4c03f4b317a74a40a0786a0a0be21164 msgid "" "A list of dictionaries. For a description of the dictionary entries, see " ":ref:`link_dict_description`. Always use this or the :meth:`Page.links` " "method if you intend to make changes to the links of a page." msgstr "" "딕셔너리의 리스트. 딕셔너리 항목에 대한 설명은 :ref:`link_dict_description` 을 참조하세요. 페이지의 링크를" " 변경하려면 항상 이것 또는 :meth:`Page.links` 메서드를 사용하세요." #: ../../page.rst:664 76949f0001bf42978c2bf318306a909c msgid "" "Return a generator over the page's links. The results equal the entries " "of :meth:`Page.get_links`." msgstr "페이지의 링크에 대한 제너레이터를 반환합니다. 결과는 :meth:`Page.get_links` 의 항목과 같습니다." #: ../../page.rst:666 256c37bf03b649ce921d41b4bd526630 msgid "" "a sequence of integers to down-select to one or more link kinds. Default " "is all links. Example: *kinds=(pymupdf.LINK_GOTO,)* will only return " "internal links." msgstr "" "하나 이상의 링크 종류로 다운 선택하기 위한 정수 시퀀스. 기본값은 모든 링크입니다. 예: " "*kinds=(pymupdf.LINK_GOTO,)* 는 내부 링크만 반환합니다." #: ../../page.rst:669 57bac8c9fe03470b8c9fa8a0976374a5 msgid "an entry of :meth:`Page.get_links()` for each iteration." msgstr "각 반복에 대한 :meth:`Page.get_links()` 의 항목." #: ../../page.rst:673 ../../page.rst:698 ../../page.rst:713 #: 1cfc8ec3d3494a189a5b6fc45f3acc15 b58ceeb1df204612aff9645edd0933c0 #: bec5ab9dd05545d9b73c9e62de8de068 msgid "New in v1.16.4" msgstr "v1.16.4에서 새로 추가됨" #: ../../page.rst:679 190a2da56f4d4954a3b921a7a75b5780 msgid "Return a generator over the page's annotations." msgstr "페이지의 주석에 대한 제너레이터를 반환합니다." #: ../../page.rst:681 7e7f0c894f9f43bb88de193161271398 msgid "" "a sequence of integers to down-select to one or more annotation types. " "Default is all annotations. Example: `types=(pymupdf.PDF_ANNOT_FREETEXT, " "pymupdf.PDF_ANNOT_TEXT)` will only return 'FreeText' and 'Text' " "annotations." msgstr "" "하나 이상의 주석 유형으로 다운 선택하기 위한 정수 시퀀스. 기본값은 모든 주석입니다. 예: " "`types=(pymupdf.PDF_ANNOT_FREETEXT, pymupdf.PDF_ANNOT_TEXT)` 는 'FreeText'" " 및 'Text' 주석만 반환합니다." #: ../../page.rst:684 13e0a4b5e4e14b5e83ce82fc32ea2aba msgid "" "an :ref:`Annot` for each iteration. .. caution:: You **cannot " "safely update annotations** from within this generator. This is because " "most annotation updates require reloading the page via `page = " "doc.reload_page(page)`. To circumvent this restriction, make a list of " "annotations xref numbers first and then iterate over these numbers::" " In [4]: xrefs = [annot.xref for annot in " "page.annots(types=[...])] In [5]: for xref in xrefs: ...:" " annot = page.load_annot(xref) ...: annot.update()" " ...: page = doc.reload_page(page) In [6]:" msgstr "" #: ../../page.rst:684 2ba4670732014e5a829d65d22f631961 msgid "an :ref:`Annot` for each iteration." msgstr "각 반복에 대한 :ref:`Annot`." #: ../../page.rst:687 3fd0c0fee5ef435798110aa4fa398d04 msgid "" "You **cannot safely update annotations** from within this generator. This" " is because most annotation updates require reloading the page via `page " "= doc.reload_page(page)`. To circumvent this restriction, make a list of " "annotations xref numbers first and then iterate over these numbers::" msgstr "" "이 제너레이터 내에서 주석을 **안전하게 업데이트할 수 없습니다**. 대부분의 주석 업데이트는 `page = " "doc.reload_page(page)` 를 통해 페이지를 다시 로드해야 하기 때문입니다. 이 제한을 우회하려면 먼저 주석 xref" " 번호의 리스트를 만든 다음 이 번호들을 반복하세요::" #: ../../page.rst:704 66911a756ed04e0d972a5a041606e4e3 msgid "Return a generator over the page's form fields." msgstr "페이지의 양식 필드에 대한 제너레이터를 반환합니다." #: ../../page.rst:706 a882b8ac49a9428eab1e9b6e59f524f2 msgid "" "a sequence of integers to down-select to one or more widget types. " "Default is all form fields. Example: " "`types=(pymupdf.PDF_WIDGET_TYPE_TEXT,)` will only return 'Text' fields." msgstr "" "하나 이상의 위젯 유형으로 다운 선택하기 위한 정수 시퀀스. 기본값은 모든 양식 필드입니다. 예: " "`types=(pymupdf.PDF_WIDGET_TYPE_TEXT,)` 는 'Text' 필드만 반환합니다." #: ../../page.rst:709 2ccfcd02080e4811b0752b3ee47baa25 msgid "a :ref:`Widget` for each iteration." msgstr "각 반복에 대한 :ref:`Widget`." #: ../../page.rst:720 871dc7a054b94194a4b4f053de5f9eaf msgid "" "PDF only: Write the text of one or more :ref:`Textwriter` objects to the " "page." msgstr "PDF 전용: 하나 이상의 :ref:`Textwriter` 객체의 텍스트를 페이지에 작성합니다." #: ../../page.rst:722 f649e20d39734681ad8c9588059f42ec msgid "" "where to place the text. If omitted, the rectangle union of the text " "writers is used." msgstr "텍스트를 배치할 위치. 생략하면 텍스트 작성기의 사각형 합집합이 사용됩니다." #: ../../page.rst:723 a62f67512f7641b1b02ab65e2ef0843b msgid "" "a non-empty tuple / list of :ref:`TextWriter` objects or a single " ":ref:`TextWriter`." msgstr ":ref:`TextWriter` 객체의 비어 있지 않은 튜플/리스트 또는 단일 :ref:`TextWriter`." #: ../../page.rst:724 31da0f58f5974053919718f6e13dea23 msgid "set transparency, overwrites resp. value in the text writers." msgstr "투명도를 설정하고, 텍스트 작성기의 해당 값을 덮어씁니다." #: ../../page.rst:725 972504b7f4eb441ba75e2424782dd55f msgid "set the text color, overwrites resp. value in the text writers." msgstr "텍스트 색상을 설정하고, 텍스트 작성기의 해당 값을 덮어씁니다." #: ../../page.rst:726 136dae4fb943495eb982c68a28795ab5 msgid "put the text in foreground or background." msgstr "텍스트를 전경 또는 배경에 배치합니다." #: ../../page.rst:727 acb27d4360a244659bf4cc73141dd567 msgid "maintain the aspect ratio." msgstr "종횡비를 유지합니다." #: ../../page.rst:728 d181ff20c7ea4299bcd22d78f20d6ec9 msgid "rotate the text by an arbitrary angle." msgstr "임의의 각도로 텍스트를 회전합니다." #: ../../page.rst:729 5b44553f2f954d5ab51a6e3cbb9c7c13 msgid "the :data:`xref` of an :data:`OCG` or :data:`OCMD`. (New in v1.18.4)" msgstr ":data:`OCG` 또는 :data:`OCMD` 의 :data:`xref`. (v1.18.4에서 새로 추가됨)" #: ../../page.rst:731 b0f06277a3f140c2ac2f20314e571e28 msgid "" "Parameters *overlay, keep_proportion, rotate* and *oc* have the same " "meaning as in :meth:`Page.show_pdf_page`." msgstr "" "매개변수 *overlay, keep_proportion, rotate* 및 *oc* 는 " ":meth:`Page.show_pdf_page` 와 동일한 의미를 가집니다." #: ../../page.rst:735 e07a5fc6945442ee887b7c73cf6c2d2e msgid "New in v1.16.18" msgstr "v1.16.18에서 새로 추가됨" #: ../../page.rst:759 8e95c840195a4c71a918d0a5e67856ae msgid "" "PDF only: Insert text lines starting at :data:`point_like` ``point``. See" " :meth:`Shape.insert_text`." msgstr "" "PDF 전용: :data:`point_like` ``point`` 에서 시작하는 텍스트 줄을 삽입합니다. " ":meth:`Shape.insert_text` 를 참조하세요." #: ../../page.rst:763 ../../page.rst:792 ../../page.rst:896 ../../page.rst:921 #: ../../page.rst:946 ../../page.rst:970 ../../page.rst:994 ../../page.rst:1019 #: ../../page.rst:1043 ../../page.rst:1068 ../../page.rst:1092 #: ../../page.rst:1117 ../../page.rst:1142 29cbed1adef2475eb009d3a5de422210 #: 49f852363925416ea6c234b4c91b6218 5c73ffbadda54fb8bbc88f6430e29130 #: 73f04a44af8c4854a3a105b737a41804 802c5bc146bb4f9391824c1c3ef39bb6 #: 8e030f84abaf493db27e55aa2ac8cd62 97c6b58861a445f8b9d5a0e5c3a310ab #: a74ef5cf7bf74435a6e61758194b384f dabc787b2b6541969db56d13faf4c89d #: df67a6e9ce4048eab88324f5d7e19efe ed3b45533868494381f71199d8329d07 #: f01049b4b200405aa3c91ce9a1a85bd2 f3b6a366e6db4a2383d8d554eadb7e9b msgid "Changed in v1.18.4" msgstr "v1.18.4에서 변경됨" #: ../../page.rst:788 4a878df36e7743f9b6a9d9d9dc06a551 msgid "" "PDF only: Insert text into the specified :data:`rect_like` *rect*. See " ":meth:`Shape.insert_textbox`." msgstr "" "PDF 전용: 지정된 :data:`rect_like` *rect* 에 텍스트를 삽입합니다. " ":meth:`Shape.insert_textbox` 를 참조하세요." #: ../../page.rst:810 7a8b95a9ab4d4c769d7c458bea499710 msgid "" "**PDF only:** Insert text into the specified rectangle. The method has " "similarities with methods :meth:`Page.insert_textbox` and " ":meth:`TextWriter.fill_textbox`, but is **much more powerful**. This is " "achieved by letting a :ref:`Story` object do all the required processing." msgstr "" "**PDF 전용:** 지정된 사각형에 텍스트를 삽입합니다. 이 메서드는 :meth:`Page.insert_textbox` 및 " ":meth:`TextWriter.fill_textbox` 메서드와 유사하지만 **훨씬 더 강력합니다**. 이것은 " ":ref:`Story` 객체가 필요한 모든 처리를 수행하도록 하여 달성됩니다." #: ../../page.rst:812 a0f3fd19bdce48538475a297ca1e344e msgid "" "Parameter ``text`` may be a string as in the other methods. But it will " "be **interpreted as HTML source** and may therefore also contain HTML " "language elements -- including styling. The `css` parameter may be used " "to pass in additional styling instructions." msgstr "" "매개변수 ``text`` 는 다른 메서드와 마찬가지로 문자열일 수 있습니다. 하지만 이것은 **HTML 소스로 해석** 되므로 " "스타일링을 포함하여 HTML 언어 요소를 포함할 수도 있습니다. `css` 매개변수는 추가 스타일링 지시사항을 전달하는 데 사용할 " "수 있습니다." #: ../../page.rst:814 ec504617da2d494da64dcf69cd3d1cb8 msgid "" "Automatic line breaks are generated at word boundaries. The \"soft " "hyphen\" character `\"­\"` (or `­`) can be used to cause " "hyphenation and thus may also cause line breaks. **Forced** line breaks " "however are only achievable via the HTML tag ``
`` - ``\\n`` is " "ignored and will be treated like a space." msgstr "" "자동 줄 바꿈은 단어 경계에서 생성됩니다. \"소프트 하이픈\" 문자 `\"­\"` (또는 `­`)는 하이픈을 " "유발하고 줄 바꿈을 유발할 수도 있습니다. 그러나 **강제** 줄 바꿈은 HTML 태그 ``
`` 를 통해서만 달성할 수 " "있습니다 - ``\\n`` 은 무시되고 공백처럼 처리됩니다." #: ../../page.rst:816 a923c7fb3c8d42e5b998b610488d15e0 msgid "With this method the following can be achieved:" msgstr "이 메서드로 다음을 달성할 수 있습니다:" #: ../../page.rst:818 a35f84bf7d2e49a98470b411d03e5d63 msgid "" "Styling effects like bold, italic, text color, text alignment, font size " "or font switching." msgstr "굵게, 기울임꼴, 텍스트 색상, 텍스트 정렬, 글꼴 크기 또는 글꼴 전환과 같은 스타일링 효과." #: ../../page.rst:819 d424a5099ce8491aa77a38a61ce5145b msgid "" "The text may include arbitrary languages -- **including right-to-left** " "languages." msgstr "텍스트는 임의의 언어를 포함할 수 있습니다 -- **오른쪽에서 왼쪽** 언어를 포함하여." #: ../../page.rst:820 cbe7429b65de417da4c1b1007c31de84 msgid "" "Scripts like `Devanagari `_ and" " several others in Asia have a highly complex system of ligatures, where " "two or more unicodes together yield one glyph. The Story uses the " "software package `HarfBuzz `_ , to deal with" " these things and produce correct output." msgstr "" "`Devanagari `_ 및 아시아의 여러 다른 스크립트는 두 개 이상의 유니코드가 함께 하나의 글리프를 생성하는 매우 복잡한 합자 시스템을 가지고 있습니다. Story는 이러한 것들을 처리하고 올바른 출력을 생성하기 위해 소프트웨어 패키지 `HarfBuzz `_ 를 사용합니다." #: ../../page.rst:821 07bf7ced92754725909626e75183a002 msgid "" "One can also **include images** via HTML tag `` -- the Story will " "take care of the appropriate layout. This is an alternative option to " "insert images, compared to :meth:`Page.insert_image`." msgstr "" "HTML 태그 `` 를 통해 이미지를 **포함** 할 수도 있습니다 -- Story는 적절한 레이아웃을 처리합니다. 이것은" " :meth:`Page.insert_image` 와 비교하여 이미지를 삽입하는 대안입니다." #: ../../page.rst:822 983d14f0830f41c49ef37af23002df74 msgid "" "HTML tables (tag `
`) may be included in the text and will be " "handled appropriately." msgstr "HTML 테이블(태그 `
`)은 텍스트에 포함될 수 있으며 적절히 처리됩니다." #: ../../page.rst:823 3d7e1d6ede5b46fcbec414adef81ef5b msgid "Links are automatically generated when present." msgstr "링크가 있으면 자동으로 생성됩니다." #: ../../page.rst:825 c1697502ce9447428c60c2b19a1b4d03 msgid "If content does not fit in the rectangle, the developer has two choices:" msgstr "콘텐츠가 사각형에 맞지 않으면 개발자는 두 가지 선택이 있습니다:" #: ../../page.rst:827 d5b3273332d0480eb2bfffbc196953f9 msgid "" "**either** only be informed about this (and accept a no-op, just like " "with the other textbox insertion methods)," msgstr "**또는** 이것에 대해 알림만 받습니다(다른 텍스트 상자 삽입 메서드와 마찬가지로 no-op를 수락)," #: ../../page.rst:828 0645d285fa9a4151bdd6d8e92881f0c7 msgid "**or** (`scale_low=0` - the default) scale down the content until it fits." msgstr "**또는** (`scale_low=0` - 기본값) 콘텐츠가 맞을 때까지 축소합니다." #: ../../page.rst:830 ee3b2989599349e79cb1c01ea70ea9cd msgid "rectangle on page to receive the text." msgstr "텍스트를 받을 페이지의 사각형." #: ../../page.rst:831 b1183b7cce24456fa0d8843b773494bf msgid "" "the text to be written. Can contain a mixture of plain text and HTML tags" " with styling instructions. Alternatively, a :ref:`Story` object may be " "specified (in which case the internal Story generation step will be " "omitted). A Story must have been generated with all required styling and " "Archive information." msgstr "" "작성할 텍스트. 일반 텍스트와 스타일링 지시사항이 있는 HTML 태그의 혼합을 포함할 수 있습니다. 또는 :ref:`Story` " "객체를 지정할 수 있습니다(이 경우 내부 Story 생성 단계가 생략됨). Story는 필요한 모든 스타일링과 Archive 정보로" " 생성되어야 합니다." #: ../../page.rst:832 7b2dc0703c9c4338984056f677d0b80b msgid "" "optional string containing additional CSS instructions. This parameter is" " ignored if ``text`` is a Story." msgstr "추가 CSS 지시사항을 포함하는 선택적 문자열. ``text`` 가 Story이면 이 매개변수는 무시됩니다." #: ../../page.rst:833 bc668be54dab49a29a80fbd31c6d3296 msgid "" "if necessary, scale down the content until it fits in the target " "rectangle. This sets the down scaling limit. Default is 0, no limit. A " "value of 1 means no down-scaling permitted. A value of e.g. 0.2 means " "maximum down-scaling by 80%." msgstr "" "필요한 경우 콘텐츠가 대상 사각형에 맞을 때까지 축소합니다. 이것은 축소 제한을 설정합니다. 기본값은 0이며 제한이 없습니다. 값 " "1은 축소가 허용되지 않음을 의미합니다. 예를 들어 값 0.2는 최대 80% 축소를 의미합니다." #: ../../page.rst:834 31c0b5f5b6d04e68a6878b526636f7eb msgid "" "an Archive object that points to locations where to find images or non-" "standard fonts. If ``text`` refers to images or non-standard fonts, this " "parameter is required. This parameter is ignored if ``text`` is a Story." msgstr "" "이미지나 비표준 글꼴을 찾을 위치를 가리키는 Archive 객체. ``text`` 가 이미지나 비표준 글꼴을 참조하면 이 매개변수가" " 필요합니다. ``text`` 가 Story이면 이 매개변수는 무시됩니다." #: ../../page.rst:835 457ccb06bf974da594ce7e13e776e9b0 msgid "" "one of the values 0, 90, 180, 270. Depending on this, text will be " "filled: - 0: top-left to bottom-right. - 90: bottom-left to top-right. -" " 180: bottom-right to top-left. - 270: top-right to bottom-left. .. " "image:: images/img-rotate.*" msgstr "" #: ../../page.rst:835 c81c01b196444618b9998f481f5a0e1a msgid "one of the values 0, 90, 180, 270. Depending on this, text will be filled:" msgstr "값 0, 90, 180, 270 중 하나. 이것에 따라 텍스트가 채워집니다:" #: ../../page.rst:837 f9ff0f28f0f6456da66b0f0df1302527 msgid "0: top-left to bottom-right." msgstr "0: 왼쪽 위에서 오른쪽 아래로." #: ../../page.rst:838 e384b943e7f842698d77609fa3ff4b8c msgid "90: bottom-left to top-right." msgstr "90: 왼쪽 아래에서 오른쪽 위로." #: ../../page.rst:839 8cfc7f849a1e4f288352386f958938b2 msgid "180: bottom-right to top-left." msgstr "180: 오른쪽 아래에서 왼쪽 위로." #: ../../page.rst:840 e9c12cd0f43d498da3d4541d7861e582 msgid "270: top-right to bottom-left." msgstr "270: 오른쪽 위에서 왼쪽 아래로." #: ../../page.rst:844 93a83daaec8442ed8087eb65511b113f msgid "" "the xref of an :data:`OCG` / :data:`OCMD` or 0. Please refer to " ":meth:`Page.show_pdf_page` for details." msgstr "" ":data:`OCG` / :data:`OCMD` 의 xref 또는 0. 자세한 내용은 " ":meth:`Page.show_pdf_page` 를 참조하세요." #: ../../page.rst:845 bfb65b9ea805491db0d5ed71a7027efa msgid "" "set the fill and stroke opacity of the content. Only values `0 <= opacity" " < 1` are considered." msgstr "콘텐츠의 채우기 및 획 불투명도를 설정합니다. `0 <= opacity < 1` 값만 고려됩니다." #: ../../page.rst:846 905bbba40c974a72a58695ec34c09162 msgid "" "put the text in front of other content. Please refer to " ":meth:`Page.show_pdf_page` for details." msgstr "텍스트를 다른 콘텐츠 앞에 배치합니다. 자세한 내용은 :meth:`Page.show_pdf_page` 를 참조하세요." #: ../../page.rst:848 92bf9eaf5c3f4c479b4f36be5a1acd93 msgid "" "A tuple of floats `(spare_height, scale)`. - spare_height: The " "(positive) height of the remaining space in `rect` below the text, or " "-1 if we failed to fit. - scale: The scaling required; `0 < scale <= 1`. " "Will be `scale_low` if we failed to fit." msgstr "" #: ../../page.rst:848 2b0c0730afa5444fb7fda28fe1369de8 msgid "A tuple of floats `(spare_height, scale)`." msgstr "부동소수점 튜플 `(spare_height, scale)`." #: ../../page.rst:850 ce7c975eea734b7da832d65e887cc704 msgid "" "spare_height: The (positive) height of the remaining space in `rect` " "below the text, or -1 if we failed to fit." msgstr "spare_height: 텍스트 아래 `rect` 에 남은 공간의 (양수) 높이, 또는 맞추지 못하면 -1." #: ../../page.rst:852 816917683f904e518274eb1dd0202535 msgid "" "scale: The scaling required; `0 < scale <= 1`. Will be `scale_low` if we " "failed to fit." msgstr "scale: 필요한 스케일링; `0 < scale <= 1`. 맞추지 못하면 `scale_low` 가 됩니다." #: ../../page.rst:855 2559dc387f5a4f2b9b6113b9fbb64cd8 msgid "" "Please refer to examples in this section of the recipes: " ":ref:`RecipesText_I_c`." msgstr "레시피의 이 섹션에 있는 예제를 참조하세요: :ref:`RecipesText_I_c`." #: ../../page.rst:859 ee15ed3a85e94fb59795c752df7727aa msgid "New in v1.26.5:" msgstr "v1.26.5에서 새로 추가됨:" #: ../../page.rst:861 9ebaf4785e394595b1138e09ac1db565 msgid "do additional scaling to fit long words." msgstr "긴 단어에 맞추기 위해 추가 스케일링을 수행합니다." #: ../../page.rst:863 e401bc154829432487340567f7b04879 msgid "" "If we succeeded and scaled down, the returned `spare_height` is now " "generally positive instead of being fixed to zero, because the final " "rect's height is usually not an exact multiple of the font line height." msgstr "" "성공하고 축소한 경우, 반환된 `spare_height` 는 이제 일반적으로 0으로 고정되는 대신 양수가 됩니다. 최종 rect의 " "높이가 일반적으로 글꼴 줄 높이의 정확한 배수가 아니기 때문입니다." #: ../../page.rst:867 f3a5f741edf846059890d9018c0211fd msgid "New in v1.23.8: rebased-only." msgstr "v1.23.8에서 새로 추가됨: rebased-only." #: ../../page.rst:868 91bcebc8a0df4e6fa3bc2c96e6c50749 msgid "New in v1.23.9: `opacity` parameter." msgstr "v1.23.9에서 새로 추가됨: `opacity` 매개변수." #: ../../page.rst:873 5c2e2f42919443729264c6cf723a4a85 msgid "**Drawing Methods**" msgstr "**그리기 메서드**" #: ../../page.rst:892 c2e73d53842e437399410160042819cd msgid "" "PDF only: Draw a line from *p1* to *p2* (:data:`point_like` \\s). See " ":meth:`Shape.draw_line`." msgstr "" "PDF 전용: *p1* 에서 *p2* 로 선을 그립니다 (:data:`point_like` \\s). " ":meth:`Shape.draw_line` 참조." #: ../../page.rst:917 590f66dd92694e3d99c4a4c0e6eda74e msgid "" "PDF only: Draw a zigzag line from *p1* to *p2* (:data:`point_like` \\s). " "See :meth:`Shape.draw_zigzag`." msgstr "" "PDF 전용: *p1* 에서 *p2* 로 지그재그 선을 그립니다 (:data:`point_like` \\s). " ":meth:`Shape.draw_zigzag` 참조." #: ../../page.rst:942 b7e2518e8f634d33abba9359ea9d5881 msgid "" "PDF only: Draw a squiggly (wavy, undulated) line from *p1* to *p2* " "(:data:`point_like` \\s). See :meth:`Shape.draw_squiggle`." msgstr "" "PDF 전용: *p1* 에서 *p2* 로 구불구불한(물결 모양, 파형) 선을 그립니다 (:data:`point_like` \\s)." " :meth:`Shape.draw_squiggle` 참조." #: ../../page.rst:966 a344352656f8495fa26bb886aa41df16 msgid "" "PDF only: Draw a circle around *center* (:data:`point_like`) with a " "radius of *radius*. See :meth:`Shape.draw_circle`." msgstr "" "PDF 전용: 중심(:data:`point_like`)을 기준으로 반지름이 *radius* 인 원을 그립니다. " ":meth:`Shape.draw_circle` 참조." #: ../../page.rst:990 dc78aaf8fe8c46e0987e1e919910b04f msgid "" "PDF only: Draw an oval (ellipse) within the given :data:`rect_like` or " ":data:`quad_like`. See :meth:`Shape.draw_oval`." msgstr "" "PDF 전용: 주어진 :data:`rect_like` 또는 :data:`quad_like` 내에 타원(ellipse)을 그립니다. " ":meth:`Shape.draw_oval` 참조." #: ../../page.rst:1015 efe94da64f144f219b19cf68eae0b77f msgid "" "PDF only: Draw a circular sector, optionally connecting the arc to the " "circle's center (like a piece of pie). See :meth:`Shape.draw_sector`." msgstr "" "PDF 전용: 원형 섹터를 그립니다. 선택적으로 호를 원의 중심에 연결합니다(파이 조각처럼). " ":meth:`Shape.draw_sector` 참조." #: ../../page.rst:1039 33f62e1f2aff415cb1313cfe79341d7a msgid "" "PDF only: Draw several connected lines defined by a sequence of " ":data:`point_like` \\s. See :meth:`Shape.draw_polyline`." msgstr "" "PDF 전용: :data:`point_like` \\s의 시퀀스로 정의된 여러 연결된 라인을 그립니다. " ":meth:`Shape.draw_polyline` 참조." #: ../../page.rst:1064 eaf27ae8a0584f5ab83a1175a2565ae3 msgid "" "PDF only: Draw a cubic Bézier curve from *p1* to *p4* with the control " "points *p2* and *p3* (all are :data:`point_like` \\s). See " ":meth:`Shape.draw_bezier`." msgstr "" "PDF 전용: 제어점 *p2* 및 *p3* 를 사용하여 *p1* 에서 *p4* 까지의 3차 Bézier 곡선을 그립니다(모두 " ":data:`point_like` \\s). :meth:`Shape.draw_bezier` 참조." #: ../../page.rst:1088 5d0be74ed9a240548236f517e0677308 msgid "" "PDF only: This is a special case of *draw_bezier()*. See " ":meth:`Shape.draw_curve`." msgstr "PDF 전용: 이것은 *draw_bezier()* 의 특수한 경우입니다. :meth:`Shape.draw_curve` 참조." #: ../../page.rst:1113 bf9775fdb63446508a077a79eb46fad1 msgid "PDF only: Draw a rectangle. See :meth:`Shape.draw_rect`." msgstr "PDF 전용: 사각형을 그립니다. :meth:`Shape.draw_rect` 참조." #: ../../page.rst:1118 3847474347db459e9cd9b672283c581b msgid "Changed in v1.22.0: Added parameter *radius*." msgstr "v1.22.0에서 변경됨: *radius* 매개변수 추가." #: ../../page.rst:1138 fc73cdf7d47c41f1a7e00043867127f4 msgid "PDF only: Draw a quadrilateral. See :meth:`Shape.draw_quad`." msgstr "PDF 전용: 사각형을 그립니다. :meth:`Shape.draw_quad` 참조." #: ../../page.rst:1156 ecb6c858dcbd4178a6aa41405c91adc3 msgid "" "PDF only: Add a new font to be used by text output methods and return its" " :data:`xref`. If not already present in the file, the font definition " "will be added. Supported are the built-in :data:`Base14_Fonts` and the " "CJK fonts via **\"reserved\"** fontnames. Fonts can also be provided as a" " file path or a memory area containing the image of a font file." msgstr "" "PDF 전용: 텍스트 출력 메서드에서 사용할 새 글꼴을 추가하고 :data:`xref` 를 반환합니다. 파일에 아직 없으면 글꼴 " "정의가 추가됩니다. 내장 :data:`Base14_Fonts` 및 **\"reserved\"** 글꼴 이름을 통한 CJK 글꼴이 " "지원됩니다. 글꼴은 파일 경로 또는 글꼴 파일 이미지를 포함하는 메모리 영역으로 제공할 수도 있습니다." #: ../../page.rst:1158 784ca49abb314196808838c70b6ad0cb msgid "" "The name by which this font shall be referenced when outputting text on " "this page. In general, you have a \"free\" choice here (but consult the " ":ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of " "building legal PDF names). However, if it matches one of the " ":data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer*" " **are ignored**. In other words, you cannot insert a font via " "*fontfile* / *fontbuffer* and also give it a reserved *fontname*. .. " "note:: A reserved fontname can be specified in any mixture of upper or " "lower case and still match the right built-in font definition: fontnames " "\"helv\", \"Helv\", \"HELV\", \"Helvetica\", etc. all lead to the same " "font definition \"Helvetica\". But from a :ref:`Page` perspective, these " "are **different references**. You can exploit this fact when using " "different *encoding* variants (Latin, Greek, Cyrillic) of the same font " "on a page." msgstr "" #: ../../page.rst:1158 e853a8b934d14f3ea02398cad5e939ed msgid "" "The name by which this font shall be referenced when outputting text on " "this page. In general, you have a \"free\" choice here (but consult the " ":ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of " "building legal PDF names). However, if it matches one of the " ":data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer*" " **are ignored**." msgstr "" "이 페이지에서 텍스트를 출력할 때 이 글꼴을 참조하는 데 사용할 이름. 일반적으로 여기서는 \"자유로운\" 선택이 가능합니다(하지만" " 유효한 PDF 이름을 만드는 것에 대한 공식 설명은 :ref:`AdobeManual`, 16페이지, 섹션 7.3.5 참조). " "그러나 :data:`Base14_Fonts` 또는 CJK 글꼴 중 하나와 일치하면 *fontfile* 및 *fontbuffer* 는" " **무시됩니다**." #: ../../page.rst:1160 cf82f15dcf404eadb21b4a1dba93ecb5 msgid "" "In other words, you cannot insert a font via *fontfile* / *fontbuffer* " "and also give it a reserved *fontname*." msgstr "" "즉, *fontfile* / *fontbuffer* 를 통해 글꼴을 삽입하고 동시에 예약된 *fontname* 을 지정할 수 " "없습니다." #: ../../page.rst:1162 e659c191992e48eb94d7f32ba3c46183 msgid "" "A reserved fontname can be specified in any mixture of upper or lower " "case and still match the right built-in font definition: fontnames " "\"helv\", \"Helv\", \"HELV\", \"Helvetica\", etc. all lead to the same " "font definition \"Helvetica\". But from a :ref:`Page` perspective, these " "are **different references**. You can exploit this fact when using " "different *encoding* variants (Latin, Greek, Cyrillic) of the same font " "on a page." msgstr "" "예약된 글꼴 이름은 대소문자를 혼합하여 지정할 수 있으며 여전히 올바른 내장 글꼴 정의와 일치합니다: \"helv\", " "\"Helv\", \"HELV\", \"Helvetica\" 등의 글꼴 이름은 모두 동일한 글꼴 정의 \"Helvetica\"로 " "이어집니다. 하지만 :ref:`Page` 관점에서 이것들은 **다른 참조** 입니다. 페이지에서 동일한 글꼴의 서로 다른 " "*encoding* 변형(라틴어, 그리스어, 키릴 문자)을 사용할 때 이 사실을 활용할 수 있습니다." #: ../../page.rst:1164 ef07701a528349508e27adfd4b1b8ed5 msgid "" "a path to a font file. If used, *fontname* must be **different from all " "reserved names**." msgstr "글꼴 파일의 경로. 사용하는 경우 *fontname* 은 **모든 예약된 이름과 달라야 합니다**." #: ../../page.rst:1166 c56234a1c1bb47d6b53f4c450ee2baaa msgid "" "the memory image of a font file. If used, *fontname* must be **different " "from all reserved names**. This parameter would typically be used with " ":attr:`Font.buffer` for fonts supported / available via :ref:`Font`." msgstr "" "글꼴 파일의 메모리 이미지. 사용하는 경우 *fontname* 은 **모든 예약된 이름과 달라야 합니다**. 이 매개변수는 " "일반적으로 :ref:`Font` 를 통해 지원/사용 가능한 글꼴에 대해 :attr:`Font.buffer` 와 함께 사용됩니다." #: ../../page.rst:1168 c829498fc36446f98af9abf805e60b4e msgid "" "applicable for *fontfile* / *fontbuffer* cases only: enforce treatment as" " a \"simple\" font, i.e. one that only uses character codes up to 255." msgstr "" "*fontfile* / *fontbuffer* 경우에만 적용: \"simple\" 글꼴로 처리하도록 강제합니다. 즉, 255까지의 " "문자 코드만 사용하는 글꼴입니다." #: ../../page.rst:1170 c85e98b3a7994b05a04787dda7a8b07f msgid "" "applicable for the \"Helvetica\", \"Courier\" and \"Times\" sets of " ":data:`Base14_Fonts` only. Select one of the available encodings Latin " "(0), Cyrillic (2) or Greek (1). Only use the default (0 = Latin) for " "\"Symbol\" and \"ZapfDingBats\"." msgstr "" "\"Helvetica\", \"Courier\", \"Times\" 세트의 :data:`Base14_Fonts` 에만 적용됩니다. " "사용 가능한 인코딩 중 하나를 선택하세요: 라틴어(0), 키릴 문자(2) 또는 그리스어(1). \"Symbol\" 및 " "\"ZapfDingBats\"의 경우 기본값(0 = 라틴어)만 사용하세요." #: ../../page.rst 36550b7edee54c1188ca5609869459d7 msgid "rytpe" msgstr "반환 타입" #: ../../page.rst:1172 ../../page.rst:2186 ../../page.rst:2270 #: ../../page.rst:2440 ../../page.rst:2447 2e2e55470cc44eadac95427335597b0d #: 90dd8a61e3a94693983ed36666b06529 b79cd61cdba44da2aa18e06e172e512c #: d7725f03960a46eab8731060d7c5fbd6 e566747d94314d3c95161b75011eb1b8 msgid "int" msgstr "" #: ../../page.rst:1173 5510866376644f7bbd427e5ef653fa7d msgid "the :data:`xref` of the installed font." msgstr "설치된 글꼴의 :data:`xref`." #: ../../page.rst:1175 d480db0679494d579d74b4c34d55a73a msgid "" "Built-in fonts will not lead to the inclusion of a font file. So the " "resulting PDF file will remain small. However, your PDF viewer software " "is responsible for generating an appropriate appearance -- and there " "**exist** differences on whether or how each one of them does this. This " "is especially true for the CJK fonts. But also Symbol and ZapfDingbats " "are incorrectly handled in some cases. Following are the **Font Names** " "and their correspondingly installed **Base Font** names:" msgstr "" "내장 글꼴은 글꼴 파일 포함을 필요로 하지 않습니다. 따라서 결과 PDF 파일은 작게 유지됩니다. 그러나 PDF 뷰어 소프트웨어는 " "적절한 외관을 생성할 책임이 있으며, 각각이 이를 수행하는지 여부나 방법에 **차이** 가 있습니다. 이것은 특히 CJK 글꼴에 " "해당합니다. 하지만 Symbol과 ZapfDingbats도 일부 경우에 잘못 처리됩니다. 다음은 **Font Names** 및 해당" " 설치된 **Base Font** 이름입니다:" #: ../../page.rst:1177 2fc11411f26642cb8e883be2ec988af9 msgid "**Base-14 Fonts** [#f1]_" msgstr "**Base-14 Fonts** [#f1]_" #: ../../page.rst:1180 ../../page.rst:1201 2b45356e25314be8b5bd94785561fa33 #: 53f516761abf4a47b377dc0ce82a5ad2 msgid "**Font Name**" msgstr "**Font Name**" #: ../../page.rst:1180 ../../page.rst:1201 4c08f1380f274a2995cb0532552a27ed #: 637b903b10b743fa92e4243d3f65239e msgid "**Installed Base Font**" msgstr "**Installed Base Font**" #: ../../page.rst:1180 ../../page.rst:1201 4cff83bd3cf54493b09148347eb75b51 #: da3707c6048645368c0956ebc887eb2f msgid "**Comments**" msgstr "**Comments**" #: ../../page.rst:1182 18293365bcfe4cea8468ce984682e74a msgid "helv" msgstr "" #: ../../page.rst:1182 55f64fae05f24262a6bb2c38fbf9628e msgid "Helvetica" msgstr "" #: ../../page.rst:1182 ../../page.rst:1186 ../../page.rst:1190 #: 0e899653f2654c20850bbedf45d3b8b0 593ba869eceb482fb75902f9ad648d45 #: dceffb7e5907437ba8a334b106176f45 msgid "normal" msgstr "" #: ../../page.rst:1183 1c5cb11c1c474c6f8f4d043b8dd09291 msgid "heit" msgstr "" #: ../../page.rst:1183 aa164b95b2d4400f80f650354746f770 msgid "Helvetica-Oblique" msgstr "" #: ../../page.rst:1183 ../../page.rst:1187 ../../page.rst:1191 #: 2fdc4b72443d48bf81c8b63240b714d6 d23ef9bf70e742a6bb3230e917321082 #: ff6f502342704e1b86371e6a7d3aa4c2 msgid "italic" msgstr "" #: ../../page.rst:1184 8f49bb24a40b4de387dfb0b043baaf9b msgid "hebo" msgstr "" #: ../../page.rst:1184 7cbf4e7da59a4718b322603212ee1d57 msgid "Helvetica-Bold" msgstr "" #: ../../page.rst:1184 ../../page.rst:1188 ../../page.rst:1192 #: 838ff8b719074bcb9aa6e14ec2895b7a 8c9e2fd138844d85b496e9183c9065a6 #: 97006eb599164f1a9a2873d2c0af75ad msgid "bold" msgstr "" #: ../../page.rst:1185 0c8b5e39b8d843b3954ce0722e56244d msgid "hebi" msgstr "" #: ../../page.rst:1185 984cc215aa174fabba3896c4cc3cd988 msgid "Helvetica-BoldOblique" msgstr "" #: ../../page.rst:1185 ../../page.rst:1189 ../../page.rst:1193 #: 0bb7be12571e43d48afe5bbd824fbd86 580462e857cc4ae08f5a44c62d007b2f #: 6a92795b28d64e4fbb8e44e487e61ae7 msgid "bold-italic" msgstr "" #: ../../page.rst:1186 5303cf0daa7848a6ac6afdbaa4daef00 msgid "cour" msgstr "" #: ../../page.rst:1186 ccedc4fb0a5744b99f8c423452738f7f msgid "Courier" msgstr "" #: ../../page.rst:1187 16e14eccc0da475e9726a70633179cd5 msgid "coit" msgstr "" #: ../../page.rst:1187 c98264eab09d44468c0b91851cc4c4a8 msgid "Courier-Oblique" msgstr "" #: ../../page.rst:1188 e64194c194364645ade04f15f1ef62a7 msgid "cobo" msgstr "" #: ../../page.rst:1188 e55b1cd2b40543ab9c54d97ade2b9b75 msgid "Courier-Bold" msgstr "" #: ../../page.rst:1189 1aca6ab6b76a4aed908832e8d0fa1571 msgid "cobi" msgstr "" #: ../../page.rst:1189 29904bdcfa1e406190e7bea97386c29c msgid "Courier-BoldOblique" msgstr "" #: ../../page.rst:1190 8f6db99bec2c453da271d5f2c815f825 msgid "tiro" msgstr "" #: ../../page.rst:1190 9743271d2a5c46cfb39f130399e1b959 msgid "Times-Roman" msgstr "" #: ../../page.rst:1191 c8538ccd9183467e9b13a1dd70171f26 msgid "tiit" msgstr "" #: ../../page.rst:1191 6c5eff126dfa4f07b32035767abd3a3a msgid "Times-Italic" msgstr "" #: ../../page.rst:1192 12f1f169bc8d424482ed52c8e0f5c79e msgid "tibo" msgstr "" #: ../../page.rst:1192 ab0221cc28944b99b07d7d60aaedfd69 msgid "Times-Bold" msgstr "" #: ../../page.rst:1193 69bb30b66c774e3e93d7a0849f590e51 msgid "tibi" msgstr "" #: ../../page.rst:1193 e49be3741ac148ee8b2e7fc41200329f msgid "Times-BoldItalic" msgstr "" #: ../../page.rst:1194 f9cce506526e4e5a94056122c567803f msgid "symb" msgstr "" #: ../../page.rst:1194 24960e62fc5749b0bc2e3bcc9d141d70 msgid "Symbol" msgstr "" #: ../../page.rst:1194 ../../page.rst:1195 56a30bd5d1c64f6baa60b7582a72264a #: d7f4778c5af3488f8abb49d03780112c msgid "[#f3]_" msgstr "" #: ../../page.rst:1195 58d2bbe78bd54b628e30622e27019a91 msgid "zadb" msgstr "" #: ../../page.rst:1195 d320a00b7b2747d4a1b212fbd9ed5119 msgid "ZapfDingbats" msgstr "" #: ../../page.rst:1198 74a791ec4c884dc9adc83e26d1751c2b msgid "**CJK Fonts** [#f2]_ (China, Japan, Korea)" msgstr "**CJK Fonts** [#f2]_ (중국, 일본, 한국)" #: ../../page.rst:1203 068dbb7a377f4e5faf6e4aa1b3ce3676 msgid "china-s" msgstr "" #: ../../page.rst:1203 4db5b0c4dc68430cbc0ffcd7a97a70dd msgid "Heiti" msgstr "" #: ../../page.rst:1203 9357308deba14c3385c9d72a034f7880 msgid "simplified Chinese" msgstr "간체 중국어" #: ../../page.rst:1204 6ab7fb2c07cd4c439f9453d2d4af5902 msgid "china-ss" msgstr "" #: ../../page.rst:1204 13f223fbbe2045eebb63e28239948a77 msgid "Song" msgstr "" #: ../../page.rst:1204 cd8e8871140d428a9c83c9322ab1b320 msgid "simplified Chinese (serif)" msgstr "간체 중국어 (세리프)" #: ../../page.rst:1205 03880884fd8b4985b9439d42e3671fc1 msgid "china-t" msgstr "" #: ../../page.rst:1205 f39bfbec06864f53a9321d89ed47c76a msgid "Fangti" msgstr "" #: ../../page.rst:1205 ea0b2ee888694862a655a28eb8dccee6 msgid "traditional Chinese" msgstr "번체 중국어" #: ../../page.rst:1206 b584de518de04581865eff60a3069d72 msgid "china-ts" msgstr "" #: ../../page.rst:1206 14094a25049b4446b25d31d2a6ace697 msgid "Ming" msgstr "" #: ../../page.rst:1206 2c421d836ecb4174ad42a9ccef0eb1a7 msgid "traditional Chinese (serif)" msgstr "번체 중국어 (세리프)" #: ../../page.rst:1207 e9b2a65d815447e6a82eab64d9891634 msgid "japan" msgstr "" #: ../../page.rst:1207 b0ff2c611e0b4d709055dae4e541480f msgid "Gothic" msgstr "" #: ../../page.rst:1207 d76896751b73458a8c326ad9eded2f3f msgid "Japanese" msgstr "일본어" #: ../../page.rst:1208 b9a20234dcc44c96ba614f99a25c1f9f msgid "japan-s" msgstr "" #: ../../page.rst:1208 c8bdf8c39ecf43b89c45842d51668900 msgid "Mincho" msgstr "" #: ../../page.rst:1208 988a1e7ab9cc40e0979ad2d236e4c279 msgid "Japanese (serif)" msgstr "일본어 (세리프)" #: ../../page.rst:1209 6b69e6244f8549d29911f61d1c8b46bb msgid "korea" msgstr "" #: ../../page.rst:1209 dbf67a34442c49dda05b93aca301dd1e msgid "Dotum" msgstr "" #: ../../page.rst:1209 488a6626d802450a99c002882eec0366 msgid "Korean" msgstr "한국어" #: ../../page.rst:1210 3ca620da7a6344078a50bdbb4a038045 msgid "korea-s" msgstr "" #: ../../page.rst:1210 6d3a35431e6b4be786d3be8f9ceeaf20 msgid "Batang" msgstr "" #: ../../page.rst:1210 fb704da9b28f473ea4a3f3e2db5c888e msgid "Korean (serif)" msgstr "한국어 (세리프)" #: ../../page.rst:1226 c67586c85e2a449fae83d95b4d75cf2f msgid "" "PDF only: Put an image inside the given rectangle. The image may already " "exist in the PDF or be taken from a pixmap, a file, or a memory area." msgstr "" "PDF 전용: 주어진 사각형 내에 이미지를 배치합니다. 이미지는 이미 PDF에 존재하거나 픽스맵, 파일 또는 메모리 영역에서 가져올" " 수 있습니다." #: ../../page.rst:1229 04e5d29ccbeb4e709039ad427ff40069 msgid "where to put the image. Must be finite and not empty." msgstr "이미지를 배치할 위치. 유한하고 비어 있지 않아야 합니다." #: ../../page.rst:1230 d72696dae884419390fab43b03412f3b msgid "deprecated and ignored." msgstr "더 이상 사용되지 않으며 무시됩니다." #: ../../page.rst:1231 9d5780a4200f4ee48da1f4c6c9f4161b msgid "" "name of an image file (all formats supported by MuPDF -- see " ":ref:`ImageFiles`)." msgstr "이미지 파일 이름(MuPDF에서 지원하는 모든 형식 -- :ref:`ImageFiles` 참조)." #: ../../page.rst:1235 85e7a2bc15744184be453270c69da4b4 msgid "maintain the aspect ratio of the image." msgstr "이미지의 종횡비를 유지합니다." #: ../../page.rst:1237 8643882ac247408698bcde17b0a3e2a1 msgid "" "image in memory -- to be used as image mask (alpha values) for the base " "image. When specified, the base image must be provided as a filename or a" " stream -- and must not be an image that already has a mask." msgstr "" "메모리의 이미지 -- 기본 이미지의 이미지 마스크(알파 값)로 사용됩니다. 지정된 경우 기본 이미지는 파일 이름 또는 스트림으로 " "제공되어야 하며, 이미 마스크가 있는 이미지가 아니어야 합니다." #: ../../page.rst:1241 e61845a265de4e0f89f8353d7b1bb062 msgid "" "(:data:`xref`) make image visibility dependent on this :data:`OCG` or " ":data:`OCMD`. Ignored after the first of multiple insertions. The " "property is stored with the generated PDF image object and therefore " "controls the image's visibility throughout the PDF." msgstr "" "(:data:`xref`) 이미지 가시성을 이 :data:`OCG` 또는 :data:`OCMD` 에 종속시킵니다. 여러 번 삽입 시" " 첫 번째 이후에는 무시됩니다. 이 속성은 생성된 PDF 이미지 객체와 함께 저장되므로 PDF 전체에서 이미지 가시성을 제어합니다." #: ../../page.rst:1246 c4a6133751b74f3399ef5608f0582302 msgid "see :ref:`CommonParms`." msgstr ":ref:`CommonParms` 참조." #: ../../page.rst:1247 0d9ca43ecaa7497f8c778182f0bba3ee msgid "a pixmap containing the image." msgstr "이미지를 포함하는 픽스맵." #: ../../page.rst:1248 94d006c7929d472fa1526111ad2ec5f6 msgid "" "rotate the image. Must be an integer multiple of 90 degrees. Positive " "values rotate anti-clockwise. If you need a rotation by an arbitrary " "angle, consider converting the image to a PDF " "(:meth:`Document.convert_to_pdf`) first and then use " ":meth:`Page.show_pdf_page` instead." msgstr "" "이미지를 회전시킵니다. 90도의 정수 배여야 합니다. 양수 값은 반시계 방향으로 회전합니다. 임의의 각도로 회전이 필요한 경우 먼저" " 이미지를 PDF로 변환(:meth:`Document.convert_to_pdf`)한 다음 " ":meth:`Page.show_pdf_page` 를 사용하는 것을 고려하세요." #: ../../page.rst:1255 a582d71169ef4cd4a5eb4911e45a312e msgid "image in memory (all formats supported by MuPDF -- see :ref:`ImageFiles`)." msgstr "메모리의 이미지(MuPDF에서 지원하는 모든 형식 -- :ref:`ImageFiles` 참조)." #: ../../page.rst:1258 cef8b29899b44e368609cdbe39ff4247 msgid "" "the :data:`xref` of an image already present in the PDF. If given, " "parameters `filename`, `pixmap`, `stream`, `alpha` and `mask` are " "ignored. The page will simply receive a reference to the existing image." msgstr "" "PDF에 이미 존재하는 이미지의 :data:`xref`. 주어진 경우 `filename`, `pixmap`, `stream`, " "`alpha` 및 `mask` 매개변수는 무시됩니다. 페이지는 기존 이미지에 대한 참조만 받습니다." #: ../../page.rst:1266 8a294a1cb1c14a9b9034df80278ccf95 msgid "" "The `xref` of the embedded image. This can be used as the `xref` argument" " for very significant performance boosts, if the image is inserted again." msgstr "삽입된 이미지의 `xref`. 이미지를 다시 삽입하는 경우 `xref` 인수로 사용하면 성능이 크게 향상될 수 있습니다." #: ../../page.rst:1271 429d172dcd0e4214a6c208e57d4e3afb msgid "This example puts the same image on every page of a document::" msgstr "이 예제는 문서의 모든 페이지에 동일한 이미지를 배치합니다::" #: ../../page.rst:1286 b2d4bb04c80047959353332f0b2e0ac6 msgid "" "The method detects multiple insertions of the same image (like in the " "above example) and will store its data only on the first execution. This" " is even true (although less performant), if using the default `xref=0`." msgstr "" "이 메서드는 동일한 이미지의 여러 번 삽입(위 예제와 같이)을 감지하고 첫 번째 실행 시에만 데이터를 저장합니다. 기본값 " "`xref=0` 을 사용하는 경우에도 이것은 사실입니다(성능은 낮지만)." #: ../../page.rst:1291 f1202c94bfe64affa714aac1ef466862 msgid "" "The method cannot detect if the same image had already been part of the " "file before opening it." msgstr "이 메서드는 파일을 열기 전에 동일한 이미지가 이미 파일의 일부였는지 감지할 수 없습니다." #: ../../page.rst:1295 4b883662d2fc4a8ca0bdc17d835f9d84 msgid "" "You can use this method to provide a background or foreground image for " "the page, like a copyright or a watermark. Please remember, that " "watermarks require a transparent image if put in foreground ..." msgstr "" "이 메서드를 사용하여 저작권 표시나 워터마크와 같은 페이지의 배경 또는 전경 이미지를 제공할 수 있습니다. 워터마크는 전경에 " "배치하는 경우 투명한 이미지가 필요하다는 것을 기억하세요..." #: ../../page.rst:1300 65d8b02c83cc4c1db2dd4c6707b37732 msgid "" "The image may be inserted uncompressed, e.g. if a `Pixmap` is used or if " "the image has an alpha channel. Therefore, consider using `deflate=True` " "when saving the file. In addition, there are ways to control the image " "size -- even if transparency comes into play. Have a look at " ":ref:`RecipesImages_O`." msgstr "" "이미지는 압축되지 않은 상태로 삽입될 수 있습니다(예: `Pixmap` 이 사용되거나 이미지에 알파 채널이 있는 경우). 따라서 " "파일을 저장할 때 `deflate=True` 를 사용하는 것을 고려하세요. 또한 투명도가 관련된 경우에도 이미지 크기를 제어하는 " "방법이 있습니다. :ref:`RecipesImages_O` 를 참조하세요." #: ../../page.rst:1307 605df42da17b4553aa6788fa75e32bd0 msgid "" "The image is stored in the PDF at its original quality level. This may be" " much better than what you need for your display. Consider **decreasing " "the image size** before insertion -- e.g. by using the pixmap option and " "then shrinking it or scaling it down (see :ref:`Pixmap` chapter). The PIL" " method `Image.thumbnail()` can also be used for that purpose. The file " "size savings can be very significant." msgstr "" "이미지는 원본 품질 수준으로 PDF에 저장됩니다. 이것은 디스플레이에 필요한 것보다 훨씬 좋을 수 있습니다. 삽입 전에 **이미지 " "크기를 줄이는** 것을 고려하세요 -- 예를 들어 픽스맵 옵션을 사용한 다음 축소하거나 크기를 줄입니다(:ref:`Pixmap` 장" " 참조). PIL 메서드 `Image.thumbnail()` 도 이 목적에 사용할 수 있습니다. 파일 크기 절감이 매우 클 수 " "있습니다." #: ../../page.rst:1316 17544a4536244b86b695e7a3aa360e86 msgid "" "Another efficient way to display the same image on multiple pages is " "another method: :meth:`show_pdf_page`. Consult " ":meth:`Document.convert_to_pdf` for how to obtain intermediary PDFs " "usable for that method." msgstr "" "여러 페이지에 동일한 이미지를 표시하는 또 다른 효율적인 방법은 다른 메서드입니다: :meth:`show_pdf_page`. 해당 " "메서드에 사용할 수 있는 중간 PDF를 얻는 방법은 :meth:`Document.convert_to_pdf` 를 참조하세요." #: ../../page.rst:1323 8239152d8a2948ae969d5a26895b0f88 msgid "Changed in v1.14.1: By default, the image keeps its aspect ratio." msgstr "v1.14.1에서 변경됨: 기본적으로 이미지는 종횡비를 유지합니다." #: ../../page.rst:1324 cd485cd6ed0447658b17b7b742fb26d1 msgid "Changed in v1.14.11: Added args `keep_proportion`, `rotate`." msgstr "v1.14.11에서 변경됨: `keep_proportion`, `rotate` 인수 추가." #: ../../page.rst:1325 2001b89cf3134a449792eb3d2c50fe8e msgid "Changed in v1.14.13:" msgstr "v1.14.13에서 변경됨:" #: ../../page.rst:1328 557eff2950f84c5295ea861bd576884f msgid "" "The image is now always placed **centered** in the rectangle, i.e. the " "centers of image and rectangle are equal." msgstr "이미지는 이제 항상 사각형 내에서 **중앙** 에 배치됩니다. 즉, 이미지와 사각형의 중심이 같습니다." #: ../../page.rst:1330 bf6a4645943d4c91aa882f357fb84ad0 msgid "Added support for `stream` as `io.BytesIO`." msgstr "`stream` 을 `io.BytesIO` 로 지원 추가." #: ../../page.rst:1332 98bae562bc734a7eae573e415c8f54c8 msgid "" "Changed in v1.17.6: Insertion rectangle no longer needs to have a non-" "empty intersection with the page's :attr:`Page.cropbox` [#f5]_." msgstr "" "v1.17.6에서 변경됨: 삽입 사각형이 더 이상 페이지의 :attr:`Page.cropbox` [#f5]_와 비어 있지 않은 " "교집합을 가질 필요가 없습니다." #: ../../page.rst:1335 89abd8465cd5417b8ee798a837a8650e msgid "Changed in v1.18.1: Added `mask` arg." msgstr "v1.18.1에서 변경됨: `mask` 인수 추가." #: ../../page.rst:1336 a59cc5282da348c79b5b88c040e4b39a msgid "Changed in v1.18.3: Added `oc` arg." msgstr "v1.18.3에서 변경됨: `oc` 인수 추가." #: ../../page.rst:1337 d407eb13d420415686a640bb59ed49aa msgid "Changed in v1.18.13:" msgstr "v1.18.13에서 변경됨:" #: ../../page.rst:1339 7355cd865e4d497399a73cbf63cca7fe msgid "Allow providing the image as the xref of an existing one." msgstr "기존 이미지의 xref로 이미지를 제공할 수 있도록 허용." #: ../../page.rst:1340 126a0f9d15384b44bc73f25f7d23e3f1 msgid "Added `xref` arg." msgstr "`xref` 인수 추가." #: ../../page.rst:1341 4baadf25f03c43dfa268278c9ed4fd2b msgid "Return `xref` of stored image." msgstr "저장된 이미지의 `xref` 반환." #: ../../page.rst:1343 5bd9b05e55c149d79fce515dbf613f38 msgid "Changed in v1.19.3: deprecate and ignore `alpha` arg." msgstr "v1.19.3에서 변경됨: `alpha` 인수를 더 이상 사용하지 않고 무시합니다." #: ../../page.rst:1356 fa99710cc2c94c609e67a7f6c95dba3c msgid "Replace the image at xref with another one." msgstr "xref의 이미지를 다른 이미지로 교체합니다." #: ../../page.rst:1358 ../../page.rst:1383 b807b4221b3a49ad8d260a6f2acf20df #: d10f6e058725472db2c1c7b4026673f0 msgid "the :data:`xref` of the image." msgstr "이미지의 :data:`xref`." #: ../../page.rst:1359 5ed1e953dc324bf58e10b87858d7a47f msgid "the filename of the new image." msgstr "새 이미지의 파일 이름." #: ../../page.rst:1360 d1b533c8c050499893bb4d123651938b msgid "the :ref:`Pixmap` of the new image." msgstr "새 이미지의 :ref:`Pixmap`." #: ../../page.rst:1361 d0457bd767a3410c92a383c91ebcbedd msgid "the memory area containing the new image." msgstr "새 이미지를 포함하는 메모리 영역." #: ../../page.rst:1363 d32714ecc04241a9a4268fac123fb364 msgid "" "Arguments `filename`, `pixmap`, `stream` have the same meaning as in " ":meth:`Page.insert_image`, especially exactly one of these must be " "provided." msgstr "" "인수 `filename`, `pixmap`, `stream` 은 :meth:`Page.insert_image` 와 동일한 의미이며," " 특히 이 중 정확히 하나를 제공해야 합니다." #: ../../page.rst:1365 c4946fe5d64d4ac0b4f5b131d9267fc6 msgid "" "This is a **global replacement:** the new image will also be shown " "wherever the old one has been displayed throughout the file." msgstr "이것은 **전역 교체** 입니다: 새 이미지는 파일 전체에서 이전 이미지가 표시된 모든 위치에 표시됩니다." #: ../../page.rst:1367 9d59a1496ca54e0dbed9f1249b189632 msgid "" "This method mainly exists for technical purposes. Typical uses include " "replacing large images by smaller versions, like a lower resolution, " "graylevel instead of colored, etc., or changing transparency." msgstr "" "이 메서드는 주로 기술적 목적으로 존재합니다. 일반적인 사용 사례에는 낮은 해상도, 컬러 대신 그레이스케일 등과 같은 더 작은 " "버전으로 큰 이미지를 교체하거나 투명도를 변경하는 것이 포함됩니다." #: ../../page.rst:1371 ../../page.rst:1395 8370d57607d948e69e595ebac5f3c631 #: d876451ff8ad4817ba1b232c6e659a5b msgid "New in v1.21.0" msgstr "*v1.21.0의 새로운 기능*" #: ../../page.rst:1381 b276840a105941439de2b273ddff8084 msgid "" "Delete the image at xref. This is slightly misleading: actually the image" " is being replaced with a small transparent :ref:`Pixmap` using above " ":meth:`Page.replace_image`. The visible effect however is equivalent." msgstr "" "xref의 이미지를 삭제합니다. 이것은 약간 오해의 소지가 있습니다: 실제로는 위의 :meth:`Page.replace_image`" " 를 사용하여 작은 투명한 :ref:`Pixmap` 으로 교체됩니다. 그러나 시각적 효과는 동일합니다." #: ../../page.rst:1385 2a45f7a3dad649239d2434094e3c5898 msgid "" "This is a **global replacement:** the image will disappear wherever the " "old one has been displayed throughout the file." msgstr "이것은 **전역 교체** 입니다: 이미지는 파일 전체에서 이전 이미지가 표시된 모든 위치에서 사라집니다." #: ../../page.rst:1387 ae3478603d3944368de35ac28c9151a8 msgid "" "If you inspect / extract a page's images by methods like " ":meth:`Page.get_images`, :meth:`Page.get_image_info` or " ":meth:`Page.get_text`, the replacing \"dummy\" image will be detected " "like so `(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` and " "also seem to \"cover\" the same boundary box on the page." msgstr "" ":meth:`Page.get_images`, :meth:`Page.get_image_info` 또는 " ":meth:`Page.get_text` 와 같은 메서드로 페이지의 이미지를 검사/추출하는 경우, 교체된 \"dummy\" 이미지는 " "`(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` 와 같이 감지되며 " "페이지에서 동일한 경계 상자를 \"덮는\" 것처럼 보입니다." #: ../../page.rst:1418 3484beb579b9420090f7e98d9ea4b47c msgid "" "Retrieves the content of a page in a variety of formats. Depending on the" " ``flags`` value, this may include text, images and several other object " "types. The method is a wrapper for multiple :ref:`TextPage` methods by " "choosing the output option `opt` as follows:" msgstr "" "다양한 형식으로 페이지의 콘텐츠를 검색합니다. ``flags`` 값에 따라 텍스트, 이미지 및 기타 여러 객체 타입이 포함될 수 " "있습니다. 이 메서드는 출력 옵션 `opt` 를 다음과 같이 선택하여 여러 :ref:`TextPage` 메서드에 대한 래퍼입니다:" #: ../../page.rst:1420 c3957a9f0e79439992d9d6615f11fe40 msgid "" "\"text\" -- :meth:`TextPage.extractTEXT`, default. Always includes **text" " only.**" msgstr "\"text\" -- :meth:`TextPage.extractTEXT`, 기본값. 항상 **텍스트만** 포함합니다." #: ../../page.rst:1421 c1b7076659a94128a73a82d593aaa4d3 msgid "" "\"blocks\" -- :meth:`TextPage.extractBLOCKS`. Includes text and **may** " "include image meta information." msgstr "" "\"blocks\" -- :meth:`TextPage.extractBLOCKS`. 텍스트를 포함하며 **이미지 메타 정보를 포함할 " "수 있습니다**." #: ../../page.rst:1422 2da3939e1d7c472e818a36ce516eff17 msgid "\"words\" -- :meth:`TextPage.extractWORDS`. Always includes **text only.**" msgstr "\"words\" -- :meth:`TextPage.extractWORDS`. 항상 **텍스트만** 포함합니다." #: ../../page.rst:1423 db922a0f8df44faca069430e7f5b192d msgid "\"html\" -- :meth:`TextPage.extractHTML`. May include text and images." msgstr "\"html\" -- :meth:`TextPage.extractHTML`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1424 c4332759c6c5457da53be98773162edc msgid "\"xhtml\" -- :meth:`TextPage.extractXHTML`. May include text and images." msgstr "\"xhtml\" -- :meth:`TextPage.extractXHTML`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1425 820d47e90f8e41ebae909a741e197004 msgid "\"xml\" -- :meth:`TextPage.extractXML`. Always includes **text only.**" msgstr "\"xml\" -- :meth:`TextPage.extractXML`. 항상 **텍스트만** 포함합니다." #: ../../page.rst:1426 dd6ad63d5d2944349be005282a9132c9 msgid "\"dict\" -- :meth:`TextPage.extractDICT`. May include text and images." msgstr "\"dict\" -- :meth:`TextPage.extractDICT`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1427 71fcb8dc2d554939b52630ee6f8995a8 msgid "\"json\" -- :meth:`TextPage.extractJSON`. May include text and images." msgstr "\"json\" -- :meth:`TextPage.extractJSON`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1428 ea90fa3efb484e1cb7a8268f72c57bdb msgid "" "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`. May include text and " "images." msgstr "\"rawdict\" -- :meth:`TextPage.extractRAWDICT`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1429 6fbdec11ab834609a97b7105008227b8 msgid "" "\"rawjson\" -- :meth:`TextPage.extractRAWJSON`. May include text and " "images." msgstr "\"rawjson\" -- :meth:`TextPage.extractRAWJSON`. 텍스트와 이미지를 포함할 수 있습니다." #: ../../page.rst:1431 fb947bb8e7d0457c9db932169a26e3e3 msgid "" "A string indicating the requested format, one of the above. A mixture of " "upper and lower case is supported. If misspelled, option \"text\" is " "silently assumed." msgstr "" "요청된 형식을 나타내는 문자열, 위 중 하나. 대소문자 혼합이 지원됩니다. 철자가 잘못된 경우 옵션 \"text\"가 조용히 " "가정됩니다." #: ../../page.rst:1433 1bd53244773c4a5dadef1ff0bab3eee1 msgid "" "restrict the extraction to this rectangle. If ``None`` (default), the " "visible part of the page is taken. Any content (text, images) that is " "**not fully contained** in ``clip`` will be completely omitted. To avoid " "clipping altogether use ``clip=pymupdf.INFINITE_RECT()``. Only then the " "extraction will contain all items. This parameter has **no effect** on " "options \"html\", \"xhtml\" and \"xml\"." msgstr "" "추출을 이 사각형으로 제한합니다. ``None`` (기본값)인 경우 페이지의 보이는 부분이 사용됩니다. ``clip`` 에 **완전히" " 포함되지 않은** 모든 콘텐츠(텍스트, 이미지)는 완전히 생략됩니다. 클리핑을 완전히 피하려면 " "``clip=pymupdf.INFINITE_RECT()`` 를 사용하세요. 그럴 때만 추출에 모든 항목이 포함됩니다. 이 매개변수는" " 옵션 \"html\", \"xhtml\", \"xml\"에 **효과가 없습니다**." #: ../../page.rst:1435 f73603f823f4483c8d30d0a89f7572f8 msgid "" "indicator bits to control whether to include images or how text should be" " handled with respect to white spaces and :data:`ligatures`. See " ":ref:`TextPreserve` for available indicators and " ":ref:`text_extraction_flags` for default settings. (New in v1.16.2)" msgstr "" "이미지를 포함할지 여부 또는 공백 및 :data:`ligatures` 에 대해 텍스트를 처리하는 방법을 제어하는 표시기 비트. 사용" " 가능한 표시기는 :ref:`TextPreserve` 를 참조하고 기본 설정은 :ref:`text_extraction_flags` " "를 참조하세요. (v1.16.2의 새로운 기능)" #: ../../page.rst:1437 c561e7ef134f498793cc90393da4d1c6 msgid "" "use a previously created :ref:`TextPage`. This reduces execution time " "**very significantly:** by more than 50% and up to 95%, depending on the " "extraction option. If specified, the 'flags' and 'clip' arguments are " "ignored, because they are textpage-only properties. If omitted, a new, " "temporary textpage will be created." msgstr "" "이전에 생성된 :ref:`TextPage` 를 사용합니다. 이것은 실행 시간을 **매우 크게** 줄입니다: 추출 옵션에 따라 50%" " 이상 최대 95%까지. 지정된 경우 'flags' 및 'clip' 인수는 무시됩니다. 이는 textpage 전용 속성이기 " "때문입니다. 생략하면 새로운 임시 textpage가 생성됩니다." #: ../../page.rst:1439 f887e407e2af4318822e05c0eff94bc2 msgid "" "sort the output by vertical, then horizontal coordinates. In many cases, " "this should suffice to generate a \"natural\" reading order. Has no " "effect on (X)HTML and XML. For options \"blocks\", \"dict\", \"json\", " "\"rawdict\", \"rawjson\", sorting happens by coordinates `(y1, x0)` of " "the respective block bbox. For options \"words\" and \"text\", the text " "lines are completely re-synthesized to follow the reading sequence and " "appearance in the document -- which even establishes the original layout " "to some extent." msgstr "" "세로 좌표, 그 다음 가로 좌표로 출력을 정렬합니다. 많은 경우 이것은 \"자연스러운\" 읽기 순서를 생성하는 데 충분해야 합니다." " (X)HTML 및 XML에는 효과가 없습니다. 옵션 \"blocks\", \"dict\", \"json\", " "\"rawdict\", \"rawjson\"의 경우 각 블록 bbox의 좌표 `(y1, x0)` 로 정렬이 수행됩니다. 옵션 " "\"words\" 및 \"text\"의 경우 텍스트 라인은 읽기 순서와 문서의 모양을 따르도록 완전히 재구성됩니다 -- 이것은 어느" " 정도 원래 레이아웃을 설정합니다." #: ../../page.rst:1441 95a7095bdcfb4738b0dfd00c84103152 msgid "" "use these characters as *additional* word separators with the \"words\" " "output option (ignored otherwise). By default, all white spaces " "(including non-breaking space `0xA0`) indicate start and end of a word. " "Now you can specify more characters causing this. For instance, the " "default will return `\"john.doe@outlook.com\"` as **one** word. If you " "specify `delimiters=\"@.\"` then the **four** words `\"john\"`, " "`\"doe\"`, `\"outlook\"`, `\"com\"` will be returned. Other possible uses" " include ignoring punctuation characters `delimiters=string.punctuation`." " The \"word\" strings will not contain any delimiting character. (New in " "v1.23.5)" msgstr "" "\"words\" 출력 옵션과 함께 이러한 문자를 *추가* 단어 구분자로 사용합니다(그렇지 않으면 무시됨). 기본적으로 모든 " "공백(줄바꿈 없는 공백 `0xA0` 포함)은 단어의 시작과 끝을 나타냅니다. 이제 이것을 유발하는 더 많은 문자를 지정할 수 " "있습니다. 예를 들어 기본값은 `\"john.doe@outlook.com\"` 을 **하나의** 단어로 반환합니다. " "`delimiters=\"@.\"` 를 지정하면 **네 개의** 단어 `\"john\"`, `\"doe\"`, " "`\"outlook\"`, `\"com\"` 이 반환됩니다. 다른 가능한 사용 사례에는 구두점 문자 무시 " "`delimiters=string.punctuation` 가 포함됩니다. \"word\" 문자열은 구분 문자를 포함하지 않습니다. " "(v1.23.5의 새로운 기능)" #: ../../page.rst:1443 8a3314318f1347968fec4dd7e161108f msgid "*str, list, dict*" msgstr "*str, list, dict*" #: ../../page.rst:1444 2fda8f36df9a4f43b757eb6b210d6ab2 msgid "" "The page's content as a string, a list or a dictionary. Refer to the " "corresponding :ref:`TextPage` method for details." msgstr "문자열, 리스트 또는 딕셔너리로 된 페이지의 콘텐츠. 자세한 내용은 해당 :ref:`TextPage` 메서드를 참조하세요." #: ../../page.rst:1448 87cab378dbb54d2bb87074cf1903d401 msgid "" "You can use this method as a **document conversion tool** from :ref:`any " "supported document type` to one of TEXT, HTML, " "XHTML or XML documents." msgstr "" "이 메서드를 :ref:`지원되는 모든 문서 타입` 에서 TEXT, HTML, XHTML 또는" " XML 문서 중 하나로 변환하는 **문서 변환 도구**로 사용할 수 있습니다." #: ../../page.rst:1449 e2531f96ce69494d982a5c574b459396 msgid "" "The inclusion of text via the *clip* parameter is decided on a by-" "character level: a character becomes part of the output, if its bbox is " "contained in `clip`. This **deviates** from the algorithm used in " "redaction annotations: a character will be **removed if its bbox " "intersects** any redaction annotation." msgstr "" "*clip* 매개변수를 통한 텍스트 포함은 문자 단위로 결정됩니다: 문자의 bbox가 `clip` 에 포함되면 출력의 일부가 " "됩니다. 이것은 삭제 주석에 사용되는 알고리즘과 **다릅니다**: 문자의 bbox가 삭제 주석과 **교차하면 제거됩니다**." #: ../../page.rst:1453 1b5b49c1fa4c45508811e8eebee7a190 msgid "Changed in v1.19.0: added `textpage` parameter" msgstr "v1.19.0에서 변경됨: `textpage` 매개변수 추가" #: ../../page.rst:1454 4bffb71bcae845ccbf0a78d24102fcea msgid "Changed in v1.19.1: added `sort` parameter" msgstr "v1.19.1에서 변경됨: `sort` 매개변수 추가" #: ../../page.rst:1455 6f58853b7eb84463a9e605cd638cc751 msgid "" "Changed in v1.19.6: added new constants for defining default flags per " "method." msgstr "v1.19.6에서 변경됨: 메서드별 기본 플래그를 정의하는 새로운 상수 추가" #: ../../page.rst:1456 0d1821e110d644faa8f8986a696207e8 msgid "Changed in v1.23.5: added `delimiters` parameter" msgstr "v1.23.5에서 변경됨: `delimiters` 매개변수 추가" #: ../../page.rst:1457 b58734a4980841f7a1c1d465c26b3c9b msgid "" "Changed in v1.24.11: changed the effect of `sort_True` for \"text\" and " "\"words\" to closely follow natural reading sequence." msgstr "" "v1.24.11에서 변경됨: \"text\" 및 \"words\"에 대한 `sort_True` 의 효과를 자연스러운 읽기 순서를 " "밀접하게 따르도록 변경." #: ../../page.rst:1467 8c1c27d5f5854a5994c1d79f6640c6de msgid "Retrieve the text contained in a rectangle." msgstr "사각형에 포함된 텍스트를 검색합니다." #: ../../page.rst:1469 d4911798adf84f2e912f80ea9d7c1fbc msgid "rect-like." msgstr "사각형과 유사한." #: ../../page.rst:1470 5f6e40c71fb64050acab8309f49fc2b6 msgid "" "a :ref:`TextPage` to use. If omitted, a new, temporary textpage will be " "created." msgstr "사용할 :ref:`TextPage`. 생략하면 새로운 임시 textpage가 생성됩니다." #: ../../page.rst:1472 b5d117f42415497f85e0315decf882bf msgid "" "a string with interspersed linebreaks where necessary. It is based on " "dedicated code (changed in v1.19.0). A typical use is checking the result" " of :meth:`Page.search_for`: >>> rl = page.search_for(\"currency:\") >>>" " page.get_textbox(rl[0]) 'Currency:' >>>" msgstr "" #: ../../page.rst:1472 aba080f6928a47bca88bf15e82859c44 msgid "" "a string with interspersed linebreaks where necessary. It is based on " "dedicated code (changed in v1.19.0). A typical use is checking the result" " of :meth:`Page.search_for`:" msgstr "" "필요한 경우 줄바꿈이 삽입된 문자열. 전용 코드를 기반으로 합니다(v1.19.0에서 변경됨). 일반적인 사용 사례는 " ":meth:`Page.search_for` 의 결과를 확인하는 것입니다:" #: ../../page.rst:1481 1e92c2a6e6f64f00b15bff149f248e54 msgid "New in v1.17.7" msgstr "*v1.17.7의 새로운 기능*" #: ../../page.rst:1482 4c2cd3bfa050492fbbcfddb097f00283 msgid "Changed in v1.19.0: add `textpage` parameter" msgstr "v1.19.0에서 변경됨: `textpage` 매개변수 추가" #: ../../page.rst:1493 552c575ac4154ab99a2685db626069af msgid "Create a :ref:`TextPage` for the page." msgstr "페이지에 대한 :ref:`TextPage` 생성." #: ../../page.rst:1495 72d281381ba448d2a9296634e86b332f msgid "" "indicator bits controlling the content available for subsequent text " "extractions and searches -- see the parameter of :meth:`Page.get_text`." msgstr "" "후속 텍스트 추출 및 검색에 사용 가능한 콘텐츠를 제어하는 표시기 비트 -- :meth:`Page.get_text` 의 매개변수 " "참조." #: ../../page.rst:1497 8e6348dea3124d21ab5c024e64c7b109 msgid "restrict extracted text to this area. (New in v1.17.7)" msgstr "추출된 텍스트를 이 영역으로 제한합니다. (v1.17.7의 새로운 기능)" #: ../../page.rst:1499 a633ba5141524989bc3d06428d2217f4 msgid ":ref:`TextPage`" msgstr ":ref:`TextPage`" #: ../../page.rst:1503 e83f608779fa4b60a3a81132844375ef msgid "New in v1.16.5" msgstr "*v1.16.5의 새로운 기능*" #: ../../page.rst:1504 808f46c3859f4dcc927e0b0b14281327 msgid "Changed in v1.17.7: introduced `clip` parameter." msgstr "v1.17.7에서 변경됨: `clip` 매개변수 도입." #: ../../page.rst:1518 c70224150c4f475c99d903492862e1bf msgid "" "**Optical Character Recognition** (**OCR**) technology can be used to " "extract text data for documents where text is in a raster image format " "throughout the page. Use this method to **OCR** a page for text " "extraction." msgstr "" "**Optical Character Recognition** (**OCR**) 기술은 페이지 전체에서 텍스트가 래스터 이미지 형식인" " 문서의 텍스트 데이터를 추출하는 데 사용할 수 있습니다. 텍스트 추출을 위해 페이지를 **OCR** 하려면 이 메서드를 사용하세요." #: ../../page.rst:1520 b7f86ebe9de0435e82db8aa8bc9af4c0 msgid "" "This method returns a :ref:`TextPage` for the page that includes OCRed " "text. MuPDF will invoke Tesseract-OCR if this method is used. Otherwise " "this is a normal :ref:`TextPage` object." msgstr "" "이 메서드는 OCR된 텍스트를 포함하는 페이지에 대한 :ref:`TextPage` 를 반환합니다. 이 메서드가 사용되면 MuPDF가" " Tesseract-OCR을 호출합니다. 그렇지 않으면 이것은 일반 :ref:`TextPage` 객체입니다." #: ../../page.rst:1522 1197bedcf2f24b6fa0d282e2118a8337 msgid "" "indicator bits controlling the content available for subsequent test " "extractions and searches -- see the parameter of :meth:`Page.get_text`." msgstr "" "후속 테스트 추출 및 검색에 사용 가능한 콘텐츠를 제어하는 표시기 비트 -- :meth:`Page.get_text` 의 매개변수 " "참조." #: ../../page.rst:1523 53262d05af364b3da0927c53aa377bac msgid "" "the expected language(s). Use \"+\"-separated values if multiple " "languages are expected, \"eng+spa\" for English and Spanish." msgstr "예상되는 언어. 여러 언어가 예상되는 경우 \"+\"로 구분된 값을 사용하세요. 영어와 스페인어의 경우 \"eng+spa\"." #: ../../page.rst:1524 5f0307e724b8447bb42be06da94e312a msgid "" "the desired resolution in dots per inch. Influences recognition quality " "(and execution time)." msgstr "인치당 도트 단위의 원하는 해상도. 인식 품질(및 실행 시간)에 영향을 줍니다." #: ../../page.rst:1525 fe347ff9506f4484a86d5a50d85ca327 msgid "whether to OCR the full page, or just the displayed images." msgstr "전체 페이지를 OCR할지, 아니면 표시된 이미지만 OCR할지 여부." #: ../../page.rst:1526 48120db50bd44e0cae9dc87701c03cf8 msgid "" "The name of Tesseract's language support folder `tessdata`. If omitted, " "this information must be present as environment variable " "`TESSDATA_PREFIX`. Can be determined by function :meth:`get_tessdata`." msgstr "" "Tesseract의 언어 지원 폴더 `tessdata` 의 이름. 생략하면 이 정보는 환경 변수 `TESSDATA_PREFIX` 로" " 제공되어야 합니다. 함수 :meth:`get_tessdata` 로 확인할 수 있습니다." #: ../../page.rst:1528 744d4ab2cad04b2b9d6dc62ee518bac5 msgid "" "This method does **not** support a clip parameter -- OCR will always " "happen for the complete page rectangle." msgstr "이 메서드는 clip 매개변수를 **지원하지 않습니다** -- OCR은 항상 전체 페이지 사각형에 대해 수행됩니다." #: ../../page.rst:1530 b027240195914e2f9485d94002565eeb msgid "" "a :ref:`TextPage`. Execution may be significantly longer than " ":meth:`Page.get_textpage`. For a full page OCR, **all text** will have " "the font \"GlyphlessFont\" from Tesseract. In case of partial OCR, normal" " text will keep its properties, and only text coming from images will " "have the GlyphlessFont. .. note:: **OCRed text is only available** " "to PyMuPDF's text extractions and searches if their `textpage` parameter " "specifies the output of this method. `This Jupyter notebook " "`_ walks through an example for using OCR " "textpages." msgstr "" #: ../../page.rst:1532 8596df79de844fbf890ad989700cdbf8 msgid "" "a :ref:`TextPage`. Execution may be significantly longer than " ":meth:`Page.get_textpage`." msgstr ":ref:`TextPage`. 실행 시간이 :meth:`Page.get_textpage` 보다 훨씬 길 수 있습니다." #: ../../page.rst:1534 02474ff2d6f9486199e495d259a676f5 msgid "" "For a full page OCR, **all text** will have the font \"GlyphlessFont\" " "from Tesseract. In case of partial OCR, normal text will keep its " "properties, and only text coming from images will have the GlyphlessFont." msgstr "" "전체 페이지 OCR의 경우 **모든 텍스트** 는 Tesseract의 \"GlyphlessFont\" 글꼴을 가집니다. 부분 OCR의" " 경우 일반 텍스트는 속성을 유지하고 이미지에서 나온 텍스트만 GlyphlessFont를 가집니다." #: ../../page.rst:1538 c8b06f1ce9c541c0a7dafa1b5983861d msgid "" "**OCRed text is only available** to PyMuPDF's text extractions and " "searches if their `textpage` parameter specifies the output of this " "method." msgstr "" "**OCR된 텍스트는** `textpage` 매개변수가 이 메서드의 출력을 지정하는 경우에만 PyMuPDF의 텍스트 추출 및 검색에" " **사용할 수 있습니다**." #: ../../page.rst:1540 18093ba01d0e4191a8c741c78d6df301 msgid "" "`This Jupyter notebook `_ walks " "through an example for using OCR textpages." msgstr "" "`이 Jupyter notebook `_ 은 OCR " "textpage 사용 예제를 안내합니다." #: ../../page.rst:1544 f40b2fa4b48d4c1d9f4b65fb126edcee msgid "New in v.1.19.0" msgstr "*v.1.19.0의 새로운 기능*" #: ../../page.rst:1545 858d61e097fa41d98f177be970cba353 msgid "Changed in v1.19.1: support full and partial OCRing a page." msgstr "v1.19.1에서 변경됨: 전체 및 부분 페이지 OCR 지원." #: ../../page.rst:1552 c7e3ee200beb4ebd990f650366aad171 msgid "" "Return the vector graphics of the page. These are instructions which draw" " lines, rectangles, quadruples or curves, including properties like " "colors, transparency, line width and dashing, etc. Alternative terms are " "\"line art\" and \"drawings\"." msgstr "" "페이지의 벡터 그래픽을 반환합니다. 이것들은 색상, 투명도, 선 너비 및 파선 등의 속성을 포함하여 선, 사각형, 쿼드 또는 곡선을" " 그리는 명령입니다. 대체 용어는 \"line art\" 및 \"drawings\"입니다." #: ../../page.rst:1554 e64e409f6b2e4e45967c8c6aac0bad56 msgid "" "a list of dictionaries. Each dictionary item contains one or more single " "draw commands belonging together: they have the same properties (colors, " "dashing, etc.). This is called a **\"path\"** in PDF, so we adopted that " "name here, but the method **works for all document types**." msgstr "" "딕셔너리 목록. 각 딕셔너리 항목은 함께 속하는 하나 이상의 단일 그리기 명령을 포함합니다: 동일한 속성(색상, 파선 등)을 " "가집니다. 이것은 PDF에서 **\"path\"** 라고 하므로 여기서도 그 이름을 채택했지만, 이 메서드는 **모든 문서 타입에 " "작동합니다**." #: ../../page.rst:1556 c64685bdd45f4d6bb1cc4ff4068e57b8 msgid "" "The path dictionary for fill, stroke and fill-stroke paths has been " "designed to be compatible with class :ref:`Shape`. There are the " "following keys:" msgstr "" "채우기, 스트로크 및 채우기-스트로크 경로에 대한 경로 딕셔너리는 :ref:`Shape` 클래스와 호환되도록 설계되었습니다. 다음 " "키가 있습니다:" #: ../../page.rst:1559 ../../page.rst:1624 ../../page.rst:1639 #: b7acf7d868cf4e919562977891f0e0a8 ece6a68246ce4a1e8d4c47faf351884a #: fba538fc79d041b7a5a06d8e27da9bb0 msgid "Key" msgstr "Key" #: ../../page.rst:1559 ../../page.rst:1624 ../../page.rst:1639 #: 79c927222a1d4571bdb27f8d8e581798 e6dd0c648ea44198b141fa2c5ec474b3 #: f767d8e05516491292593328f8697ddf msgid "Value" msgstr "Value" #: ../../page.rst:1561 ../../page.rst:1626 4c9594dfce96479da55c6061fda83ef6 #: 843fb4f69f1d49b595bddd522a49b6c4 msgid "closePath" msgstr "closePath" #: ../../page.rst:1561 ../../page.rst:1568 0bb5485c5b154e28a2a94e0c49a7ab0a #: c7cccba55c234feaa7691155b39634d6 msgid "Same as the parameter in :ref:`Shape`." msgstr ":ref:`Shape` 의 매개변수와 동일합니다." #: ../../page.rst:1562 cd6c9da5bb2e48648ab4f4b6d71a6c41 msgid "color" msgstr "color" #: ../../page.rst:1562 c5737caae9ff469ab4ba20ae07489a50 msgid "Stroke color (see :ref:`Shape`)." msgstr "스트로크 색상(:ref:`Shape` 참조)." #: ../../page.rst:1563 28e58c7532c748e1adb3c0d297b18557 msgid "dashes" msgstr "dashes" #: ../../page.rst:1563 6cb1db9ecb934543b995bd0c188dfa03 msgid "Dashed line specification (see :ref:`Shape`)." msgstr "파선 지정(:ref:`Shape` 참조)." #: ../../page.rst:1564 ../../page.rst:1627 706378ca44324162b50fc91701ee84f7 #: e9ee905de99e4ddd970116c9fa0fad74 msgid "even_odd" msgstr "even_odd" #: ../../page.rst:1564 eb35285c61bf47c585d1b5dee58e4c02 msgid "Fill colors of area overlaps -- same as the parameter in :ref:`Shape`." msgstr "영역 겹침의 채우기 색상 -- :ref:`Shape` 의 매개변수와 동일합니다." #: ../../page.rst:1565 99a00de114ab446aa9a7156f94788754 msgid "fill" msgstr "fill" #: ../../page.rst:1565 6541ce13a5374cbdb67442b03c85f36d msgid "Fill color (see :ref:`Shape`)." msgstr "채우기 색상(:ref:`Shape` 참조)." #: ../../page.rst:1566 ../../page.rst:1628 19eb2a71eece4c209ac6cce431b7d19a #: 704c355822ab4ee48ccde125a6d2b184 msgid "items" msgstr "items" #: ../../page.rst:1566 101403480b8b4fc5af798c80802bb355 msgid "List of draw commands: lines, rectangles, quads or curves." msgstr "그리기 명령 목록: 선, 사각형, 쿼드 또는 곡선." #: ../../page.rst:1567 4f48840dea424d8aab46a9fb1644b9e4 msgid "lineCap" msgstr "lineCap" #: ../../page.rst:1567 fb95c6cfd6f243fa8a9b9dc0a63b09e0 msgid "Number 3-tuple, use its max value on output with :ref:`Shape`." msgstr "숫자 3-튜플, :ref:`Shape` 와 함께 출력에서 최대값을 사용합니다." #: ../../page.rst:1568 acf3d1a551de4b9590f034eeb2ad8061 msgid "lineJoin" msgstr "lineJoin" #: ../../page.rst:1569 ecb4b729c6f84a02ace66afe9859c83a msgid "fill_opacity" msgstr "fill_opacity" #: ../../page.rst:1569 6460170cd1cd493f9d8ad754e5297c40 msgid "fill color transparency (see :ref:`Shape`). (New in v1.18.17)" msgstr "채우기 색상 투명도(:ref:`Shape` 참조). (v1.18.17의 새로운 기능)" #: ../../page.rst:1570 8546e57d8a2c43abb8a56d1bd331730d msgid "stroke_opacity" msgstr "stroke_opacity" #: ../../page.rst:1570 0ff66e45b59f416f99cb0024bb1b4eac msgid "stroke color transparency (see :ref:`Shape`). (New in v1.18.17)" msgstr "스트로크 색상 투명도(:ref:`Shape` 참조). (v1.18.17의 새로운 기능)" #: ../../page.rst:1571 ../../page.rst:1629 ../../page.rst:1641 #: 32f0c4257df14fbb958c30e8bb8f68ce 500b3e541eb346279410ebffce76e99d #: 5c7836fd4fe34492864c89d3aef88790 msgid "rect" msgstr "rect" #: ../../page.rst:1571 f5c0b4887e6c4e228c4d85da9010cecc msgid "Page area covered by this path. Information only." msgstr "이 경로가 덮는 페이지 영역. 정보 전용." #: ../../page.rst:1572 ../../page.rst:1630 ../../page.rst:1642 #: 82477c93961a4598b9ea0b648398124b 9dfc21d0511d4abbb95020a4c71d2271 #: bf797b35be6e474ba09ca35ab1b39d05 msgid "layer" msgstr "layer" #: ../../page.rst:1572 867c9e86f09a436ba115aef39ad31ab0 msgid "name of applicable Optional Content Group. (New in v1.22.0)" msgstr "적용 가능한 Optional Content Group의 이름. (v1.22.0의 새로운 기능)" #: ../../page.rst:1573 ../../page.rst:1631 ../../page.rst:1643 #: 6e87d742adac4eeba4b6ddd2e8c5532b ce3a5ce2557648dba228a50d2558c061 #: d0c7e717c97f47cba2ae7c8e2e5af826 msgid "level" msgstr "level" #: ../../page.rst:1573 aa84b0143529449f8c76b7f0a885b57f msgid "the hierarchy level if `extended=True`. (New in v1.22.0)" msgstr "`extended=True` 인 경우 계층 수준. (v1.22.0의 새로운 기능)" #: ../../page.rst:1574 8fc72f3067ca49c4b5b8ec07b54be1c4 msgid "seqno" msgstr "seqno" #: ../../page.rst:1574 894fd6dd16084fbcb60d629693392547 msgid "command number when building page appearance. (New in v1.19.0)" msgstr "페이지 외관을 구축할 때의 명령 번호. (v1.19.0의 새로운 기능)" #: ../../page.rst ../../page.rst:1575 ../../page.rst:1633 ../../page.rst:1648 #: 1fcf757d5dc541d5b3c245d404f73971 20beaee05d194b39b0960d58cecaa93d #: 20d5bfd89a42452389d2b3de105004ed 289aced190834f9aa3f7297df81e881e #: 2ecf513d3d1d4620a6bd5e1704cfae53 313cd7811c254a20b0514620e173e142 #: 3b4a71bc2b6148d8be69dc3c70b28e8b 3e570725d89c40db969ad8ebd9bb872d #: 42f7acc537fe442c890faba8fd0a5500 44a6bae233764069898e0a55d210a796 #: 4cfc1480829f48caa473096b2001366c 51a13afa13134b1e814761ce1621369f #: 5568b527ff7e45e8b2f583d5f9316d40 59049d73b92545138bdab078af040e1b #: 5abe8e3967544950afd9cd7f69e59e37 5f1f0d672a014ca0b2ed58406a5d4302 #: 5fe9177dd10c4af5ac4fd6d2875144fa 6c479020153047cdbcec75b1f3d90cf2 #: 7379336f93474e5499eb57d5b9be1b13 886f1301616a47c2a6710633e38e37c2 #: 89f932d46f3d4b3995682f63b4da6de7 8f9fc672a9bd4fcda41795c11dbb497d #: 9112052403704fe3b81a0bf9fef5dab2 9921eb0cfe194c5a86ec7378a612c5e6 #: 9a2c7607c85348538a85de2db7812879 9a4cfd70928c496f95f0f44eb37acc97 #: 9bdb2311c124404fae2717faeaa735c7 9fd560313114481fade1548731517884 #: bc324c734eb1402894e706a42a4c5800 bea09940c9364903ae6b2360dc99567a #: bf3f44de2eaa416d883bdb5f1fa99d8f fc0d5d5d24f04d50b0e0e7baa40516ce #: fcb92524976849ef90a307fcfe9bd81f msgid "type" msgstr "type" #: ../../page.rst:1575 663d54e871934888839844320dc3fdc3 msgid "type of this path. (New in v1.18.17)" msgstr "이 경로의 타입. (v1.18.17의 새로운 기능)" #: ../../page.rst:1576 ../../page.rst:1719 768f3fc5fb3346bca72ce0b3e0e4a400 #: abba61c9f8ec49aca51e36f10c201119 msgid "width" msgstr "width" #: ../../page.rst:1576 2347d6fa83164607b86cd8a23552840b msgid "Stroke line width. (see :ref:`Shape`)." msgstr "스트로크 선 너비. (:ref:`Shape` 참조)." #: ../../page.rst:1579 0e51042f7f9649dca6e5ca7c2cde0605 msgid "" "Key `\"opacity\"` has been replaced by the new keys `\"fill_opacity\"` " "and `\"stroke_opacity\"`. This is now compatible with the corresponding " "parameters of :meth:`Shape.finish`. (Changed in v1.18.17)" msgstr "" "키 `\"opacity\"` 는 새로운 키 `\"fill_opacity\"` 및 `\"stroke_opacity\"` 로 " "대체되었습니다. 이것은 이제 :meth:`Shape.finish` 의 해당 매개변수와 호환됩니다. (v1.18.17에서 변경됨)" #: ../../page.rst:1582 8609140c98474ef3abd9a14ace738246 msgid "" "For paths other than groups or clips, key `\"type\"` takes one of the " "following values:" msgstr "그룹 또는 클립이 아닌 경로의 경우 키 `\"type\"` 은 다음 값 중 하나를 가집니다:" #: ../../page.rst:1584 cf5d23e35b004933ad6ecf65c9afd033 msgid "" "**\"f\"** -- this is a *fill-only* path. Only key-values relevant for " "this operation have a meaning, not applicable ones are present with a " "value of ``None``: `\"color\"`, `\"lineCap\"`, `\"lineJoin\"`, " "`\"width\"`, `\"closePath\"`, `\"dashes\"` and should be ignored." msgstr "" "**\"f\"** -- 이것은 *채우기 전용* 경로입니다. 이 작업과 관련된 키-값만 의미가 있으며, 적용할 수 없는 항목은 " "``None`` 값으로 존재합니다: `\"color\"`, `\"lineCap\"`, `\"lineJoin\"`, " "`\"width\"`, `\"closePath\"`, `\"dashes\"` 이며 무시해야 합니다." #: ../../page.rst:1585 9c71c83b86054b5bbbd736289eb7042d msgid "" "**\"s\"** -- this is a *stroke-only* path. Similar to previous, key " "`\"fill\"` is present with value ``None``." msgstr "" "**\"s\"** -- 이것은 *스트로크 전용* 경로입니다. 이전과 유사하게 키 `\"fill\"` 은 ``None`` 값으로 " "존재합니다." #: ../../page.rst:1586 097c57e6361e4b2988f97f7007ed0569 msgid "" "**\"fs\"** -- this is a path performing combined *fill* and *stroke* " "operations." msgstr "**\"fs\"** -- 이것은 결합된 *채우기* 및 *스트로크* 작업을 수행하는 경로입니다." #: ../../page.rst:1588 6c78504d072b453d9fd91f2f1a82caec msgid "Each item in `path[\"items\"]` is one of the following:" msgstr "`path[\"items\"]` 의 각 항목은 다음 중 하나입니다:" #: ../../page.rst:1590 56e18decb23a451494b4e90318ae5b7e msgid "`(\"l\", p1, p2)` - a line from p1 to p2 (:ref:`Point` objects)." msgstr "`(\"l\", p1, p2)` - p1에서 p2로의 선(:ref:`Point` 객체)." #: ../../page.rst:1591 26a9972343024dccba36c7e3cd84fcc7 msgid "" "`(\"c\", p1, p2, p3, p4)` - cubic Bézier curve **from p1 to p4** (p2 and " "p3 are the control points). All objects are of type :ref:`Point`." msgstr "" "`(\"c\", p1, p2, p3, p4)` - **p1에서 p4로의** 3차 Bézier 곡선(p2 및 p3는 제어점). 모든 " "객체는 :ref:`Point` 타입입니다." #: ../../page.rst:1592 cdb458944b544837b6fddaef13bf8c3a msgid "" "`(\"re\", rect, orientation)` - a :ref:`Rect`. Multiple rectangles within" " the same path are now detected (changed in v1.18.17). Integer " "`orientation` is 1 resp. -1 indicating whether the enclosed area is " "rotated left (1 = anti-clockwise), or resp. right [#f7]_ (changed in " "v1.19.2)." msgstr "" "`(\"re\", rect, orientation)` - :ref:`Rect`. 동일한 경로 내의 여러 사각형이 이제 " "감지됩니다(v1.18.17에서 변경됨). 정수 `orientation` 은 1 또는 -1로, 둘러싸인 영역이 왼쪽으로 회전(1 = " "반시계 방향) 또는 오른쪽으로 회전하는지 나타냅니다 [#f7]_ (v1.19.2에서 변경됨)." #: ../../page.rst:1593 9c1e4bcf66af446ab5d2a70eff677956 msgid "" "`(\"qu\", quad)` - a :ref:`Quad`. 3 or 4 consecutive lines are detected " "to actually represent a :ref:`Quad` (changed in v1.19.2:). (New in " "v1.18.17)" msgstr "" "`(\"qu\", quad)` - :ref:`Quad`. 3개 또는 4개의 연속 선이 실제로 :ref:`Quad` 를 나타내는 " "것으로 감지됩니다(v1.19.2에서 변경됨). (v1.18.17의 새로운 기능)" #: ../../page.rst:1597 d845d91d1f81456fb5e9d7652704f931 msgid "" "Using class :ref:`Shape`, you should be able to recreate the original " "drawings on a separate (PDF) page with high fidelity under normal, not " "too sophisticated circumstances. Please see the following comments on " "restrictions. A coding draft can be found in :ref:`How to Extract " "Drawings `." msgstr "" ":ref:`Shape` 클래스를 사용하면 일반적이고 너무 복잡하지 않은 상황에서 별도의 (PDF) 페이지에서 원본 그림을 높은 " "충실도로 재현할 수 있어야 합니다. 제한 사항에 대한 다음 주석을 참조하세요. 코딩 초안은 :ref:`How to Extract " "Drawings ` 에서 찾을 수 있습니다." #: ../../page.rst:1599 131db0437b06494f8659f8d73a40a8c9 msgid "" "Specifying `extended=True` significantly alters the output. Most " "importantly, new dictionary types are present: \"clip\" and \"group\". " "All paths will now be organized in a hierarchic structure which is " "encoded by the new integer key \"level\", the hierarchy level. Each group" " or clip establishes a new hierarchy, which applies to all subsequent " "paths having a *larger* level value. (New in v1.22.0)" msgstr "" "`extended=True` 를 지정하면 출력이 크게 변경됩니다. 가장 중요한 것은 새로운 딕셔너리 타입 \"clip\" 및 " "\"group\"이 존재한다는 것입니다. 모든 경로는 이제 계층 수준인 새로운 정수 키 \"level\"로 인코딩된 계층 구조로 " "구성됩니다. 각 그룹 또는 클립은 *더 큰* level 값을 가진 모든 후속 경로에 적용되는 새로운 계층을 설정합니다. " "(v1.22.0의 새로운 기능)" #: ../../page.rst:1601 a847cd281b91455c956e6fe1153f9c9c msgid "" "Any path with a smaller level value than its predecessor will end the " "scope of (at least) the preceding hierarchy level. A \"clip\" path with " "the same level as the preceding clip will end the scope of that clip. " "Same is true for groups. This is best explained by an example::" msgstr "" "이전 항목보다 작은 level 값을 가진 경로는 (최소한) 이전 계층 수준의 범위를 종료합니다. 이전 클립과 동일한 level을 " "가진 \"clip\" 경로는 해당 클립의 범위를 종료합니다. 그룹에도 동일하게 적용됩니다. 이것은 예제로 가장 잘 설명됩니다::" #: ../../page.rst:1617 1aa3c13c698047e4af893cc4e640e9b4 msgid "" "The clip in line 0 applies to line including line 7. Group in line 2 " "applies to lines 3 to 5, clip in line 3 only applies to line 4." msgstr "" "라인 0의 클립은 라인 7을 포함한 라인에 적용됩니다. 라인 2의 그룹은 라인 3부터 5까지에 적용되고, 라인 3의 클립은 라인 " "4에만 적용됩니다." #: ../../page.rst:1619 f2517520385341e8a656b8fbb2657ae6 msgid "" "\"stroke\" in line 4 is under control of \"group\" in line 2 and \"clip\"" " in line 3 (which in turn is a subset of line 0 clip)." msgstr "" "라인 4의 \"stroke\"는 라인 2의 \"group\"과 라인 3의 \"clip\"(차례로 라인 0 클립의 하위 집합)의 제어" " 하에 있습니다." #: ../../page.rst:1621 cbf97a7250774947a89a1404e176d5c5 msgid "" "**\"clip\"** dictionary. Its values (most importantly \"scissor\") remain" " valid / apply as long as following dictionaries have a **larger " "\"level\"** value." msgstr "" "**\"clip\"** 딕셔너리. 후속 딕셔너리가 **더 큰 \"level\"** 값을 가진 한 그 값(가장 중요한 " "\"scissor\")은 유효/적용됩니다." #: ../../page.rst:1626 ../../page.rst:1627 ../../page.rst:1628 #: ../../page.rst:1629 ../../page.rst:1630 ../../page.rst:1631 #: ../../page.rst:1641 ../../page.rst:1642 ../../page.rst:1643 #: 1d3909e3e75348fa82996235f70385dd 57cdd8b09dda41a1be3654cc9daffec3 #: 7744821b23f14be28b550932b2158f41 93007be0b3bb4f049a25aff49f06da4e #: adda1d05909c4d118797b72d75bacab2 d6adb320f0ec4789a9418a9212a5ac3c #: de27d4095ca643cc8e3d1a5b21d78819 ded3d9d6901d4d59817a7ef07fd5a8b3 #: fe445f13f9734edbaa9eaffd432d9c7e msgid "Same as in \"stroke\" or \"fill\" dictionaries" msgstr "\"stroke\" 또는 \"fill\" 딕셔너리와 동일" #: ../../page.rst:1632 a56abf057dd543c49e547c92066afd44 msgid "scissor" msgstr "scissor" #: ../../page.rst:1632 31b078ca7ed643e08dd038a1d1f44a6c msgid "the clip rectangle" msgstr "클립 사각형" #: ../../page.rst:1633 555c0fc188544a68a0b9c5249e003147 msgid "\"clip\"" msgstr "\"clip\"" #: ../../page.rst:1636 1950d3a1cd754711892e66f62f30d488 msgid "" "\"group\" dictionary. Its values remain valid (apply) as long as " "following dictionaries have a **larger \"level\"** value. Any dictionary " "with an equal or lower level end this group." msgstr "" "\"group\" 딕셔너리. 후속 딕셔너리가 **더 큰 \"level\"** 값을 가진 한 그 값은 유효(적용)합니다. 동일하거나 " "더 낮은 level을 가진 딕셔너리는 이 그룹을 종료합니다." #: ../../page.rst:1644 205fddf2363247ce8151b0d3c364035a msgid "isolated" msgstr "isolated" #: ../../page.rst:1644 4d9971e178344c82b26136d679c1ed5d msgid "(bool) Whether this group is isolated" msgstr "(bool) 이 그룹이 격리되었는지 여부" #: ../../page.rst:1645 f6ee5e635f9b474e9d1f122ce4045f11 msgid "knockout" msgstr "knockout" #: ../../page.rst:1645 32061236f29c4751935dd10ede5114c9 msgid "(bool) Whether this is a \"Knockout Group\"" msgstr "(bool) 이것이 \"Knockout Group\"인지 여부" #: ../../page.rst:1646 f9ac0094769243c595cd920e319682f7 msgid "blendmode" msgstr "blendmode" #: ../../page.rst:1646 d691ceffb0944ac1afcd60cc67f3892a msgid "Name of the BlendMode, default is \"Normal\"" msgstr "BlendMode의 이름, 기본값은 \"Normal\"" #: ../../page.rst:1647 3fb054893e63424a844e9c3d4c9c088c msgid "opacity" msgstr "opacity" #: ../../page.rst:1647 e9e6e02283ef4c8cb769e2becd44a466 msgid "Float value in range [0, 1]." msgstr "[0, 1] 범위의 Float 값." #: ../../page.rst:1648 f82a36b717e0488f991404211027f96e msgid "\"group\"" msgstr "\"group\"" #: ../../page.rst:1651 37a68dc01e0d46e6a14acafe5c1d16ef msgid "" "The method is based on the output of :meth:`Page.get_cdrawings` -- which " "is much faster, but requires somewhat more attention processing its " "output." msgstr "" "이 메서드는 :meth:`Page.get_cdrawings` 의 출력을 기반으로 합니다 -- 이것은 훨씬 빠르지만 출력을 처리하는 " "데 다소 더 많은 주의가 필요합니다." #: ../../page.rst:1655 fc64101d9ee84ff59a3146a7a201220c msgid "New in v1.18.0" msgstr "*v1.18.0의 새로운 기능*" #: ../../page.rst:1656 c4d86369f98a403e9d867af9a58910a4 msgid "Changed in v1.18.17" msgstr "v1.18.17에서 변경됨" #: ../../page.rst:1657 486c4617151845d3876e6f5f3b2088e9 msgid "Changed in v1.19.0: add \"seqno\" key, remove \"clippings\" key" msgstr "v1.19.0에서 변경됨: \"seqno\" 키 추가, \"clippings\" 키 제거" #: ../../page.rst:1658 8bed595ac0a34c9cbbba1c5221e9bba5 msgid "" "Changed in v1.19.1: \"color\" / \"fill\" keys now always are either are " "RGB tuples or `None`. This resolves issues caused by exotic colorspaces." msgstr "" "v1.19.1에서 변경됨: \"color\" / \"fill\" 키는 이제 항상 RGB 튜플이거나 `None` 입니다. 이것은 " "이국적인 색 공간으로 인한 문제를 해결합니다." #: ../../page.rst:1659 14b87c784ae24c81b897e2234cb96159 msgid "" "Changed in v1.19.2: add an indicator for the *\"orientation\"* of the " "area covered by an \"re\" item." msgstr "v1.19.2에서 변경됨: \"re\" 항목이 덮는 영역의 *\"orientation\"* 에 대한 표시기 추가." #: ../../page.rst:1660 62afbaadfd244d41b02c5d43cfd713e7 msgid "" "Changed in v1.22.0: add new key `\"layer\"` which contains the name of " "the Optional Content Group of the path (or `None`)." msgstr "" "v1.22.0에서 변경됨: 경로의 Optional Content Group 이름(또는 `None`)을 포함하는 새로운 키 " "`\"layer\"` 추가." #: ../../page.rst:1661 b9a447c651b94fb3bd9cca432d23bb15 msgid "" "Changed in v1.22.0: add parameter `extended` to also return clipping and " "group paths." msgstr "v1.22.0에서 변경됨: 클리핑 및 그룹 경로도 반환하도록 `extended` 매개변수 추가." #: ../../page.rst:1669 3702a72bddbe4940aa9306ff4d7c30f8 msgid "" "Extract the vector graphics on the page. Apart from following technical " "differences, functionally equivalent to :meth:`Page.get_drawings`, but " "much faster:" msgstr "" "페이지의 벡터 그래픽을 추출합니다. 다음 기술적 차이점을 제외하고는 :meth:`Page.get_drawings` 와 기능적으로 " "동일하지만 훨씬 빠릅니다:" #: ../../page.rst:1671 860f6d110f37411399848976d173538b msgid "" "Every path type only contains the relevant keys, e.g. a stroke path has " "no `\"fill\"` color key. See comment in method :meth:`Page.get_drawings`." msgstr "" "각 경로 타입은 관련 키만 포함합니다. 예를 들어 stroke 경로에는 `\"fill\"` 색상 키가 없습니다. " ":meth:`Page.get_drawings` 메서드의 주석을 참조하세요." #: ../../page.rst:1672 6ca768cd73e945298dd50f23c476cc09 msgid "" "Coordinates are given as :data:`point_like`, :data:`rect_like` and " ":data:`quad_like` **tuples** -- not as :ref:`Point`, :ref:`Rect`, " ":ref:`Quad` objects." msgstr "" "좌표는 :ref:`Point`, :ref:`Rect`, :ref:`Quad` 객체가 아닌 :data:`point_like`, " ":data:`rect_like`, :data:`quad_like` **튜플** 로 제공됩니다." #: ../../page.rst:1674 42538119b5214715ad10ceec147d9c59 msgid "" "If performance is a concern, consider using this method: Compared to " "versions earlier than 1.18.17, you should see much shorter response " "times. We have seen pages that required 2 seconds then, now only need 200" " ms with this method." msgstr "" "성능이 중요한 경우 이 메서드 사용을 고려하세요: 1.18.17 이전 버전과 비교하여 응답 시간이 훨씬 짧아집니다. 이전에 2초가 " "걸렸던 페이지가 이 메서드로는 200ms만 필요합니다." #: ../../page.rst:1678 bdf91fd7b086456e9d858e5763582a3e msgid "New in v1.18.17" msgstr "*v1.18.17의 새로운 기능*" #: ../../page.rst:1679 fb1be55a4b15435884e4d3701791875b msgid "Changed in v1.19.0: removed \"clippings\" key, added \"seqno\" key." msgstr "v1.19.0에서 변경됨: \"clippings\" 키 제거, \"seqno\" 키 추가." #: ../../page.rst:1680 6807369fdc33422da5d63cc3a4bfc0d9 msgid "Changed in v1.19.1: always generate RGB color tuples." msgstr "v1.19.1에서 변경됨: 항상 RGB 색상 튜플 생성." #: ../../page.rst:1681 00e1646f78aa4bc8a41fdee57e4b747e msgid "" "Changed in v1.22.0: added new key `\"layer\"` which contains the name of " "the Optional Content Group of the path (or `None`)." msgstr "" "v1.22.0에서 변경됨: 경로의 Optional Content Group 이름(또는 `None`)을 포함하는 새로운 키 " "`\"layer\"` 추가." #: ../../page.rst:1682 3f2c083b24a94aaf9b53114c1dabadaa msgid "" "Changed in v1.22.0: added parameter `extended` to also return clipping " "paths." msgstr "v1.22.0에서 변경됨: 클리핑 경로도 반환하도록 `extended` 매개변수 추가." #: ../../page.rst:1689 0173b2bb8cf94466b53746921fdd8f08 msgid "" "PDF only: Return a list of fonts referenced by the page. Wrapper for " ":meth:`Document.get_page_fonts`." msgstr "PDF 전용: 페이지에서 참조하는 글꼴 목록을 반환합니다. :meth:`Document.get_page_fonts` 의 래퍼입니다." #: ../../page.rst:1694 37f4c0b79c1d4a10b3525052d6da0dfb msgid "" "PDF only: Return a list of images referenced by the page. Wrapper for " ":meth:`Document.get_page_images`." msgstr "" "PDF 전용: 페이지에서 참조하는 이미지 목록을 반환합니다. :meth:`Document.get_page_images` 의 " "래퍼입니다." #: ../../page.rst:1703 52268d5050814eeb85f48b722493807b msgid "" "Return a list of meta information dictionaries for all images displayed " "by the page. This works for all document types." msgstr "페이지에 표시된 모든 이미지에 대한 메타 정보 딕셔너리 목록을 반환합니다. 모든 문서 타입에서 작동합니다." #: ../../page.rst:1705 5008c3cdcdc54d49a2fe35f1cbe8e76d msgid "" "Compute the MD5 hashcode for each encountered image, which allows " "identifying image duplicates. This adds the key `\"digest\"` to the " "output, whose value is a 16 byte `bytes` object. (New in v1.18.13)" msgstr "" "발견된 각 이미지의 MD5 해시코드를 계산하여 이미지 중복을 식별할 수 있습니다. 이것은 출력에 키 `\"digest\"` 를 " "추가하며, 그 값은 16바이트 `bytes` 객체입니다. (v1.18.13의 새로운 기능)" #: ../../page.rst:1707 ea3214183b3a4c46b58190bd2bb70da3 msgid "" "**PDF only.** Try to find the :data:`xref` for each image. Implies " "`hashes=True`. Adds the `\"xref\"` key to the dictionary. If not found, " "the value is 0, which means, the image is either \"inline\" or its xref " "is undetectable for some reason. Please note that this option has an " "extended response time, because the MD5 hashcode will be computed at " "least two times for each image with an xref. (New in v1.18.13)" msgstr "" "**PDF 전용.** 각 이미지의 :data:`xref` 를 찾으려고 시도합니다. `hashes=True` 를 의미합니다. " "딕셔너리에 `\"xref\"` 키를 추가합니다. 찾을 수 없으면 값은 0이며, 이는 이미지가 \"inline\"이거나 어떤 이유로 " "xref를 감지할 수 없음을 의미합니다. xref가 있는 각 이미지에 대해 MD5 해시코드가 최소 두 번 계산되므로 이 옵션은 응답" " 시간이 길어집니다. (v1.18.13의 새로운 기능)" #: ../../page.rst:1710 144394c817d34fd49b7e0f8720e7cea2 msgid "" "A list of dictionaries. This includes information for **exactly those** " "images, that are shown on the page -- including *\"inline images\"*. The " "dictionary layout is similar to that of image blocks in " "`page.get_text(\"dict\")`. In contrast to images included in " ":meth:`Page.get_text`, image **binary content** is not loaded by this " "method, which drastically reduces memory usage. Another difference is " "that image detection is not restricted to the visible part of the page or" " any ``clip`` parameter: method :meth:`Page.get_text` will only extract " "images **fully contained** in the provided ``clip``. =============== " "=============================================================== **Key**" " **Value** =============== " "=============================================================== number" " block number (``int``) bbox image bbox on page, " ":data:`rect_like` width original image width (``int``) height" " original image height (``int``) cs-name colorspace name" " (``str``) colorspace colorspace.n (``int``) xres " "resolution in x-direction (``int``) [#f10]_ yres resolution in" " y-direction (``int``) [#f10]_ bpc bits per component " "(``int``) size storage occupied by image (``int``) digest" " MD5 hashcode (``bytes``), if ``hashes`` is true xref" " image :data:`xref` or 0, if *xrefs* is true transform " "matrix transforming image rect to bbox, :data:`matrix_like` has-mask" " whether the image is transparent and has a mask (``bool``) " "=============== " "=============================================================== Multiple" " occurrences of the same image are always reported. You can detect " "duplicates by comparing their `digest` values." msgstr "동일한 이미지의 여러 발생은 항상 보고됩니다. `digest` 값을 비교하여 중복을 감지할 수 있습니다." #: ../../page.rst:1710 1b149b16c2b34b64bda0baefddcecb55 msgid "" "A list of dictionaries. This includes information for **exactly those** " "images, that are shown on the page -- including *\"inline images\"*. The " "dictionary layout is similar to that of image blocks in " "`page.get_text(\"dict\")`." msgstr "" "딕셔너리 목록. 페이지에 표시된 **정확히 그** 이미지들에 대한 정보를 포함합니다 -- *\"inline images\"* 를 " "포함합니다. 딕셔너리 레이아웃은 `page.get_text(\"dict\")` 의 이미지 블록과 유사합니다." #: ../../page.rst:1712 5a27b15d2c204dab8360ff85856af7a5 msgid "" "In contrast to images included in :meth:`Page.get_text`, image **binary " "content** is not loaded by this method, which drastically reduces memory " "usage. Another difference is that image detection is not restricted to " "the visible part of the page or any ``clip`` parameter: method " ":meth:`Page.get_text` will only extract images **fully contained** in the" " provided ``clip``." msgstr "" ":meth:`Page.get_text` 에 포함된 이미지와 달리 이 메서드는 이미지 **바이너리 콘텐츠**를 로드하지 않아 메모리 " "사용량이 크게 줄어듭니다. 또 다른 차이점은 이미지 감지가 페이지의 보이는 부분이나 ``clip`` 매개변수로 제한되지 않는다는 " "것입니다: :meth:`Page.get_text` 메서드는 제공된 ``clip`` 에 **완전히 포함된** 이미지만 추출합니다." #: ../../page.rst:1715 0b394a9a1cdd432781e149c3892753fd msgid "**Key**" msgstr "**키**" #: ../../page.rst:1715 fbef0bc7bd0342239e371f8a09466df1 msgid "**Value**" msgstr "**값**" #: ../../page.rst:1717 b0f3e604fffb45edb60c2725c31d2ee8 msgid "number" msgstr "" #: ../../page.rst:1717 0c9af015fefa4419821b69772c75b33e msgid "block number (``int``)" msgstr "블록 번호 (``int``)" #: ../../page.rst:1718 4f3a3d19faaf424191cfbea0cc3d3c5a msgid "bbox" msgstr "" #: ../../page.rst:1718 584a470c5b8b46c9a03d901abd20de42 msgid "image bbox on page, :data:`rect_like`" msgstr "페이지의 이미지 bbox, :data:`rect_like`" #: ../../page.rst:1719 6e03ad7f1d6545d09b272ee9b0a60e5d msgid "original image width (``int``)" msgstr "원본 이미지 너비 (``int``)" #: ../../page.rst:1720 1aa4ad67a68e4a0eb3b1fa083bf0b326 msgid "height" msgstr "" #: ../../page.rst:1720 f123e5d62ef44992981d5268e71fa568 msgid "original image height (``int``)" msgstr "원본 이미지 높이 (``int``)" #: ../../page.rst:1721 daea98d42fac49ae934ef380b1a9153e msgid "cs-name" msgstr "" #: ../../page.rst:1721 4f2bab526d8748728ececdba28117ef1 msgid "colorspace name (``str``)" msgstr "색 공간 이름 (``str``)" #: ../../page.rst:1722 8e5b4fa8b6ac4501b3d7714920a97883 msgid "colorspace" msgstr "" #: ../../page.rst:1722 28ca4c918d30488c91e6d3e9d3974ba1 msgid "colorspace.n (``int``)" msgstr "colorspace.n (``int``)" #: ../../page.rst:1723 f7bce3d563f84da19c5a1c3d651a71a1 msgid "xres" msgstr "" #: ../../page.rst:1723 c698d13249ff4c299622cbf37b33668f msgid "resolution in x-direction (``int``) [#f10]_" msgstr "x 방향 해상도 (``int``) [#f10]_" #: ../../page.rst:1724 c5e49fb54a5d4c2abd64840944490fd2 msgid "yres" msgstr "" #: ../../page.rst:1724 40ea45169c4349899787a90365f53c29 msgid "resolution in y-direction (``int``) [#f10]_" msgstr "y 방향 해상도 (``int``) [#f10]_" #: ../../page.rst:1725 8322aa0afc5e44408915f7d1a8fcfbdd msgid "bpc" msgstr "" #: ../../page.rst:1725 b139da1626704293b366bae2a66fbc56 msgid "bits per component (``int``)" msgstr "컴포넌트당 비트 수 (``int``)" #: ../../page.rst:1726 edb0973ea574451f875f61b6d70b6fdd msgid "size" msgstr "" #: ../../page.rst:1726 92b8e55576b74c20b3f763586e41392c msgid "storage occupied by image (``int``)" msgstr "이미지가 차지하는 저장 공간 (``int``)" #: ../../page.rst:1727 07c63cf3e2674d9a8879a1606ad72801 msgid "digest" msgstr "" #: ../../page.rst:1727 32f2d2022f344bf2bb7956c636e31b1c msgid "MD5 hashcode (``bytes``), if ``hashes`` is true" msgstr "MD5 해시코드 (``bytes``), ``hashes`` 가 true인 경우" #: ../../page.rst:1728 9d32331677b648f184a4f3736354bca0 msgid "xref" msgstr "" #: ../../page.rst:1728 d76fdfd8145041c1b583291078929259 msgid "image :data:`xref` or 0, if *xrefs* is true" msgstr "이미지 :data:`xref` 또는 0, *xrefs* 가 true인 경우" #: ../../page.rst:1729 1461121625d34ebfa9284f03a0e98873 msgid "transform" msgstr "" #: ../../page.rst:1729 0180d00af39a43f78b605b04aa54009c msgid "matrix transforming image rect to bbox, :data:`matrix_like`" msgstr "이미지 rect를 bbox로 변환하는 행렬, :data:`matrix_like`" #: ../../page.rst:1730 0c574adc2af64b0082e9d605d1cf94ea msgid "has-mask" msgstr "" #: ../../page.rst:1730 8d6fa2cf1c0f46b191e21be7fc3cccac msgid "whether the image is transparent and has a mask (``bool``)" msgstr "이미지가 투명하고 마스크가 있는지 여부 (``bool``)" #: ../../page.rst:1733 35794dcd87894fcdbc9d7a463e5775c0 msgid "" "Multiple occurrences of the same image are always reported. You can " "detect duplicates by comparing their `digest` values." msgstr "동일한 이미지의 여러 발생이 항상 보고됩니다. `digest` 값을 비교하여 중복을 감지할 수 있습니다." #: ../../page.rst:1737 1f46b5881eef4542b3f758f817cf98e0 msgid "New in v1.18.11" msgstr "*v1.18.11의 새로운 기능*" #: ../../page.rst:1738 c6046c345f124938ac809f67ec47f2ea msgid "" "Changed in v1.18.13: added image MD5 hashcode computation and " ":data:`xref` search." msgstr "v1.18.13에서 변경됨: 이미지 MD5 해시코드 계산 및 :data:`xref` 검색 추가." #: ../../page.rst:1745 2819a626e264435b8e422de9b6396ad5 msgid "" "PDF only: Return a list of Form XObjects referenced by the page. Wrapper " "for :meth:`Document.get_page_xobjects`." msgstr "" "PDF 전용: 페이지에서 참조하는 Form XObjects 목록을 반환합니다. " ":meth:`Document.get_page_xobjects` 의 래퍼입니다." #: ../../page.rst:1753 99a5532742734003b2bf616307a32998 msgid "" "PDF only: Return boundary boxes and transformation matrices of an " "embedded image. This is an improved version of " ":meth:`Page.get_image_bbox` with the following differences:" msgstr "" "PDF 전용: 삽입된 이미지의 경계 상자와 변환 행렬을 반환합니다. 다음 차이점이 있는 " ":meth:`Page.get_image_bbox` 의 개선된 버전입니다:" #: ../../page.rst:1755 ac2fcb7261e34635ad4c75ac12af1689 msgid "" "There is no restriction on **how** the image is invoked (by the page or " "one of its Form XObjects). The result is always complete and correct." msgstr "" "이미지가 **어떻게** 호출되는지(페이지 또는 Form XObjects 중 하나)에 대한 제한이 없습니다. 결과는 항상 완전하고 " "정확합니다." #: ../../page.rst:1756 3c14d4fb99444135be6811cc8cb07f01 msgid "" "The result is a list of :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`) " "objects -- depending on *transform*. Each list item represents one " "location of the image on the page. Multiple occurrences might not be " "detectable by :meth:`Page.get_image_bbox`." msgstr "" "결과는 *transform* 에 따라 :ref:`Rect` 또는 (:ref:`Rect`, :ref:`Matrix`) 객체 " "목록입니다. 각 목록 항목은 페이지에서 이미지의 한 위치를 나타냅니다. 여러 발생은 " ":meth:`Page.get_image_bbox` 로 감지되지 않을 수 있습니다." #: ../../page.rst:1757 3ce396dfb45643b3a2b577396cbfc42a msgid "" "The method invokes :meth:`Page.get_image_info` with `xrefs=True` and " "therefore has a noticeably longer response time than " ":meth:`Page.get_image_bbox`." msgstr "" "이 메서드는 `xrefs=True` 로 :meth:`Page.get_image_info` 를 호출하므로 " ":meth:`Page.get_image_bbox` 보다 응답 시간이 현저히 깁니다." #: ../../page.rst:1759 104a2121204c4e679a4de6d7aebc23b6 msgid "" "an item of the list :meth:`Page.get_images`, or the reference **name** " "entry of such an item (item[7]), or the image :data:`xref`." msgstr "" ":meth:`Page.get_images` 목록의 항목, 또는 해당 항목의 참조 **이름** 항목(item[7]), 또는 이미지 " ":data:`xref`." #: ../../page.rst:1760 97231250d677409c8bcf7f2e5b7be63a msgid "" "also return the matrix used to transform the image rectangle to the bbox " "on the page. If true, then tuples `(bbox, matrix)` are returned." msgstr "" "이미지 사각형을 페이지의 bbox로 변환하는 데 사용된 행렬도 반환합니다. true이면 튜플 `(bbox, matrix)` 가 " "반환됩니다." #: ../../page.rst:1763 02c01da8966543a7bd985e5bfd3a23fa msgid "" "Boundary boxes and respective transformation matrices for each image " "occurrence on the page. If the item is not on the page, an empty list " "`[]` is returned." msgstr "페이지에서 각 이미지 발생에 대한 경계 상자 및 해당 변환 행렬. 항목이 페이지에 없으면 빈 목록 `[]` 이 반환됩니다." #: ../../page.rst:1767 333b89c3033a4043b0372cfe8b568924 msgid "New in v1.18.13" msgstr "*v1.18.13의 새로운 기능*" #: ../../page.rst:1777 e17c11e271f84b1fa49d8f8a2bb401a4 msgid "" "PDF only: Return boundary box and transformation matrix of an embedded " "image." msgstr "PDF 전용: 삽입된 이미지의 경계 상자와 변환 행렬을 반환합니다." #: ../../page.rst:1779 7312ee6f43d64176b708a9703bc38617 msgid "" "an item of the list :meth:`Page.get_images` with *full=True* specified, " "or the reference **name** entry of such an item, which is item[-3] (or " "item[7] respectively)." msgstr "" "*full=True* 로 지정된 :meth:`Page.get_images` 목록의 항목, 또는 해당 항목의 참조 **이름** " "항목(item[-3] 또는 각각 item[7])." #: ../../page.rst:1780 81977283103f4a54a537b6a7cdb91386 msgid "" "return the matrix used to transform the image rectangle to the bbox on " "the page (new in v1.18.11). Default is just the bbox. If true, then a " "tuple `(bbox, matrix)` is returned." msgstr "" "이미지 사각형을 페이지의 bbox로 변환하는 데 사용된 행렬을 반환합니다(v1.18.11의 새로운 기능). 기본값은 " "bbox만입니다. true이면 튜플 `(bbox, matrix)` 가 반환됩니다." #: ../../page.rst:1782 4cc559e506564f04af020bd45227abbd msgid ":ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`)" msgstr "" #: ../../page.rst:1783 6eb9d4bf86fc4298ba39e61874715631 msgid "" "the boundary box of the image -- optionally also its transformation " "matrix." msgstr "" #: ../../page.rst:1783 d317d7767fdf4baca1a1c48080281ae3 msgid "" "the boundary box of the image -- optionally also its transformation " "matrix." msgstr "이미지의 경계 상자 -- 선택적으로 변환 행렬도 포함." #: ../../page.rst:1787 ea294faeab98449baaa5f2d6bac06e57 msgid "" "(Changed in v1.16.7): If the page in fact does not display this image, an" " infinite rectangle is returned now. In previous versions, an exception " "was raised. Formally invalid parameters still raise exceptions." msgstr "" "(v1.16.7에서 변경됨): 페이지가 실제로 이 이미지를 표시하지 않는 경우 이제 무한 사각형이 반환됩니다. 이전 버전에서는 " "예외가 발생했습니다. 형식적으로 잘못된 매개변수는 여전히 예외를 발생시킵니다." #: ../../page.rst:1788 6af68f0315014685ad95f51cd9f03005 msgid "" "(Changed in v1.17.0): Only images referenced directly by the page are " "considered. This means that images occurring in embedded PDF pages are " "ignored and an exception is raised." msgstr "" "(v1.17.0에서 변경됨): 페이지에서 직접 참조하는 이미지만 고려됩니다. 이것은 삽입된 PDF 페이지에 있는 이미지는 무시되고 " "예외가 발생함을 의미합니다." #: ../../page.rst:1789 59689223bb4d404b86fed8d5c6db1aaa msgid "" "(Changed in v1.18.5): Removed the restriction introduced in v1.17.0: any " "item of the page's image list may be specified." msgstr "(v1.18.5에서 변경됨): v1.17.0에서 도입된 제한 제거: 페이지의 이미지 목록의 모든 항목을 지정할 수 있습니다." #: ../../page.rst:1790 2c61d167570646d493cf66b7da9b6b44 msgid "" "(Changed in v1.18.11): Partially re-instated a restriction: only those " "images are considered, that are either directly referenced by the page or" " by a Form XObject directly referenced by the page." msgstr "" "(v1.18.11에서 변경됨): 제한을 부분적으로 재도입: 페이지에서 직접 참조하거나 페이지에서 직접 참조하는 Form " "XObject에서 참조하는 이미지만 고려됩니다." #: ../../page.rst:1791 e2997fe9aa3040cb9ee18cffaaf7f009 msgid "" "(Changed in v1.18.11): Optionally also return the transformation matrix " "together with the bbox as the tuple `(bbox, transform)`." msgstr "(v1.18.11에서 변경됨): 선택적으로 bbox와 함께 변환 행렬을 튜플 `(bbox, transform)` 로 반환합니다." #: ../../page.rst:1797 8cc9d1b6e96c4e90b2c12d9b92e6b283 msgid "" "Be aware that :meth:`Page.get_images` may contain \"dead\" entries i.e. " "images, which the page **does not display**. This is no error, but " "intended by the PDF creator. No exception will be raised in this case, " "but an infinite rectangle is returned. You can avoid this from happening " "by executing :meth:`Page.clean_contents` before this method." msgstr "" ":meth:`Page.get_images` 가 페이지가 **표시하지 않는** 이미지인 \"dead\" 항목을 포함할 수 있음을 " "알아두세요. 이것은 오류가 아니라 PDF 작성자의 의도입니다. 이 경우 예외가 발생하지 않지만 무한 사각형이 반환됩니다. 이 메서드" " 전에 :meth:`Page.clean_contents` 를 실행하여 이를 방지할 수 있습니다." #: ../../page.rst:1798 83a69e80b429439cbdd9dd466683df78 msgid "" "The image's \"transformation matrix\" is defined as the matrix, for which" " the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, " "lookup details here: :ref:`ImageTransformation`." msgstr "" "이미지의 \"변환 행렬\"은 표현식 `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` 이 참인 " "행렬로 정의됩니다. 자세한 내용은 :ref:`ImageTransformation` 을 참조하세요." #: ../../page.rst:1802 349415b87ba948dd997d3d87247095ac msgid "Changed in v1.18.11: return image transformation matrix" msgstr "v1.18.11에서 변경됨: 이미지 변환 행렬 반환" #: ../../page.rst:1811 89bb43ebfacf40f980640179a3aff7f6 msgid "" "Create an SVG image from the page. Only full page images are currently " "supported." msgstr "페이지에서 SVG 이미지를 생성합니다. 현재는 전체 페이지 이미지만 지원됩니다." #: ../../page.rst:1813 e4a43470f94740d08b51e1ba9f3a160c msgid "a matrix, default is :ref:`Identity`." msgstr "행렬, 기본값은 :ref:`Identity` 입니다." #: ../../page.rst:1814 b2f8ee55a2d84526b05eb09a944cad18 msgid "" "-- controls how text is represented. ``True`` outputs each character as a" " series of elementary draw commands, which leads to a more precise text " "display in browsers, but a **very much larger** output for text-oriented " "pages. Display quality for ``False`` relies on the presence of the " "referenced fonts on the current system. For missing fonts, the internet " "browser will fall back to some default -- leading to unpleasant " "appearances. Choose ``False`` if you want to parse the text of the SVG. " "(New in v1.17.5)" msgstr "" "-- 텍스트 표현 방식을 제어합니다. ``True`` 는 각 문자를 기본 그리기 명령 시리즈로 출력하여 브라우저에서 더 정확한 " "텍스트 표시를 제공하지만 텍스트 중심 페이지의 경우 **훨씬 더 큰** 출력을 생성합니다. ``False`` 의 표시 품질은 현재 " "시스템에 참조된 글꼴의 존재에 의존합니다. 글꼴이 없으면 인터넷 브라우저가 일부 기본값으로 대체되어 불쾌한 외관을 유발합니다. " "SVG의 텍스트를 구문 분석하려면 ``False`` 를 선택하세요. (v1.17.5의 새로운 기능)" #: ../../page.rst:1816 dbc1c9ccf13c42fcb9ce7eac13c202a9 msgid "" "a UTF-8 encoded string that contains the image. Because SVG has XML " "syntax it can be saved in a text file, the standard extension is `.svg`." " .. note:: In case of a PDF, you can circumvent the \"full page image " "only\" restriction by modifying the page's CropBox before using the " "method." msgstr "" #: ../../page.rst:1816 dee19b2cc5804be0a5d0340c5e05cf46 msgid "" "a UTF-8 encoded string that contains the image. Because SVG has XML " "syntax it can be saved in a text file, the standard extension is `.svg`." msgstr "" "이미지를 포함하는 UTF-8 인코딩 문자열. SVG는 XML 구문을 사용하므로 텍스트 파일로 저장할 수 있으며, 표준 확장자는 " "`.svg` 입니다." #: ../../page.rst:1818 092cf93cd26a4b0b87d883e43675530d msgid "" "In case of a PDF, you can circumvent the \"full page image only\" " "restriction by modifying the page's CropBox before using the method." msgstr "PDF의 경우 메서드를 사용하기 전에 페이지의 CropBox를 수정하여 \"전체 페이지 이미지만\" 제한을 우회할 수 있습니다." #: ../../page.rst:1830 1f0c1497189a433ebf3ba7729b8ca199 msgid "" "Create a pixmap from the page. This is probably the most often used " "method to create a :ref:`Pixmap`." msgstr "페이지에서 픽스맵을 생성합니다. 이것은 아마도 :ref:`Pixmap` 을 생성하는 가장 자주 사용되는 메서드입니다." #: ../../page.rst:1832 e9365773d87b437ba06039e6f437c934 msgid "All parameters are *keyword-only.*" msgstr "모든 매개변수는 *키워드 전용* 입니다." #: ../../page.rst:1834 bbfd358ca8034538866437eaff12e0e9 msgid "default is :ref:`Identity`." msgstr "기본값은 :ref:`Identity` 입니다." #: ../../page.rst:1835 fbc68083e7894692808b9aa63a89724a msgid "" "desired resolution in x and y direction. If not `None`, the `\"matrix\"` " "parameter is ignored. (New in v1.19.2)" msgstr "" "x 및 y 방향의 원하는 해상도. `None` 이 아니면 `\"matrix\"` 매개변수가 무시됩니다. (v1.19.2의 새로운 " "기능)" #: ../../page.rst:1836 4a9e415f557241c79a1f84a5cc8cb7be msgid "" "The desired colorspace, one of \"GRAY\", \"RGB\" or \"CMYK\" (case " "insensitive). Or specify a :ref:`Colorspace`, ie. one of the predefined " "ones: :data:`csGRAY`, :data:`csRGB` or :data:`csCMYK`." msgstr "" "원하는 색 공간, \"GRAY\", \"RGB\" 또는 \"CMYK\" 중 하나(대소문자 구분 안 함). 또는 " ":ref:`Colorspace` 를 지정하세요. 즉, 미리 정의된 것 중 하나: :data:`csGRAY`, " ":data:`csRGB` 또는 :data:`csCMYK`." #: ../../page.rst:1838 cc13400f2cb743308a15fa123c832e82 msgid "" "restrict rendering to the intersection of this area with the page's " "rectangle." msgstr "이 영역과 페이지 사각형의 교집합으로 렌더링을 제한합니다." #: ../../page.rst:1839 2cf313f7866e4e80ab402ff06c875c12 #, python-format msgid "" "whether to add an alpha channel. Always accept the default ``False`` if " "you do not really need transparency. This will save a lot of memory (25% " "in case of RGB ... and pixmaps are typically **large**!), and also " "processing time. Also note an **important difference** in how the image " "will be rendered: with ``True`` the pixmap's samples area will be pre-" "cleared with *0x00*. This results in **transparent** areas where the page" " is empty. With ``False`` the pixmap's samples will be pre-cleared with " "*0xff*. This results in **white** where the page has nothing to show. " "|history_begin| Changed in v1.14.17 The default alpha value is now " "``False``. * Generated with *alpha=True* .. image:: images/img-" "alpha-1.* * Generated with *alpha=False* .. image:: images/img-" "alpha-0.* |history_end|" msgstr "" #: ../../page.rst:1839 cc267dfe2643423ba3c71fc24479a19e #, python-format msgid "" "whether to add an alpha channel. Always accept the default ``False`` if " "you do not really need transparency. This will save a lot of memory (25% " "in case of RGB ... and pixmaps are typically **large**!), and also " "processing time. Also note an **important difference** in how the image " "will be rendered: with ``True`` the pixmap's samples area will be pre-" "cleared with *0x00*. This results in **transparent** areas where the page" " is empty. With ``False`` the pixmap's samples will be pre-cleared with " "*0xff*. This results in **white** where the page has nothing to show." msgstr "" "알파 채널을 추가할지 여부. 투명도가 실제로 필요하지 않으면 항상 기본값 ``False`` 를 수락하세요. 이것은 많은 " "메모리(RGB의 경우 25% ... 그리고 픽스맵은 일반적으로 **큽니다** !)와 처리 시간을 절약합니다. 또한 이미지가 " "렌더링되는 방식의 **중요한 차이점** 을 참고하세요: ``True`` 로 픽스맵의 샘플 영역은 *0x00* 으로 미리 지워집니다." " 이것은 페이지가 비어 있는 곳에 **투명한** 영역을 만듭니다. ``False`` 로 픽스맵의 샘플은 *0xff* 로 미리 " "지워집니다. 이것은 페이지에 표시할 것이 없을 때 **흰색** 을 만듭니다." #: ../../page.rst:1853 ca4d0cff8b1c49f59d012366959158d7 msgid "Changed in v1.14.17" msgstr "v1.14.17에서 변경됨" #: ../../page.rst:1844 4ddc731a0e3f4ed9bb960db44fcba835 msgid "The default alpha value is now ``False``." msgstr "기본 알파 값은 이제 ``False`` 입니다." #: ../../page.rst:1846 dc3ac4805cad4db386110c93785c573e msgid "Generated with *alpha=True*" msgstr "*alpha=True* 로 생성됨" #: ../../page.rst:1851 80c272dddfea433ba4a5e07661cff5c0 msgid "Generated with *alpha=False*" msgstr "*alpha=False* 로 생성됨" #: ../../page.rst:1857 3eee36d56ce44e4db1a3cf72e9875331 msgid "" "*(new in version 1.16.0)* whether to also render annotations or to " "suppress them. You can create pixmaps for annotations separately." msgstr "*(버전 1.16.0의 새로운 기능)* 주석도 렌더링할지 아니면 억제할지 여부. 주석에 대한 픽스맵을 별도로 생성할 수 있습니다." #: ../../page.rst:1859 a3b15c577a5c4ef3ad45e3c8fca36117 msgid ":ref:`Pixmap`" msgstr ":ref:`Pixmap`" #: ../../page.rst:1860 95a5a19a18a4444a8d23700d99f3c342 msgid "" "Pixmap of the page. For fine-controlling the generated image, the by far " "most important parameter is **matrix**. E.g. you can increase or decrease" " the image resolution by using **Matrix(xzoom, yzoom)**. If zoom > 1, you" " will get a higher resolution: zoom=2 will double the number of pixels in" " that direction and thus generate a 2 times larger image. Non-positive " "values will flip horizontally, resp. vertically. Similarly, matrices also" " let you rotate or shear, and you can combine effects via e.g. matrix " "multiplication. See the :ref:`Matrix` section to learn more." msgstr "" "페이지의 픽스맵. 생성된 이미지를 세밀하게 제어하려면 가장 중요한 매개변수는 **matrix** 입니다. 예를 들어 " "**Matrix(xzoom, yzoom)** 를 사용하여 이미지 해상도를 높이거나 낮출 수 있습니다. zoom > 1이면 더 높은 " "해상도를 얻습니다: zoom=2는 해당 방향의 픽셀 수를 두 배로 하여 2배 큰 이미지를 생성합니다. 음수가 아닌 값은 각각 수평 " "또는 수직으로 뒤집습니다. 마찬가지로 행렬을 사용하여 회전하거나 기울일 수 있으며, 예를 들어 행렬 곱셈을 통해 효과를 결합할 수 " "있습니다. 자세한 내용은 :ref:`Matrix` 섹션을 참조하세요." #: ../../page.rst:1864 ba1441832f284645bcb0cd0256d76dad msgid "" "The pixmap will have *\"premultiplied\"* pixels if `alpha=True`. To learn" " about some background, e.g. look for \"Premultiplied alpha\" `here " "`_." msgstr "" "`alpha=True` 이면 픽스맵은 *\"premultiplied\"* 픽셀을 가집니다. 배경에 대한 자세한 내용은 예를 들어 " "`여기 `_ 에서 " "\"Premultiplied alpha\"를 찾아보세요." #: ../../page.rst:1866 5ca95bd389a94565be97e23e53935c11 msgid "" "The method will respect any page rotation and will not exceed the " "intersection of `clip` and :attr:`Page.cropbox`. If you need the page's " "mediabox (and if this is a different rectangle), you can use a snippet " "like the following to achieve this::" msgstr "" "이 메서드는 모든 페이지 회전을 존중하며 `clip` 과 :attr:`Page.cropbox` 의 교집합을 초과하지 않습니다. " "페이지의 mediabox가 필요한 경우(그리고 이것이 다른 사각형인 경우) 다음과 같은 스니펫을 사용하여 이를 달성할 수 " "있습니다::" #: ../../page.rst:1884 b9a7af8fd114451789f6475d6d413ca8 msgid "Changed in v1.19.2: added support of parameter dpi." msgstr "v1.19.2에서 변경됨: dpi 매개변수 지원 추가." #: ../../page.rst:1892 d38e45c9eb4d45188627dee99647e6b5 msgid "" "PDF only: return a list of the names of annotations, widgets and links. " "Technically, these are the */NM* values of every PDF object found in the " "page's */Annots* array." msgstr "" "PDF 전용: 주석, 위젯 및 링크의 이름 목록을 반환합니다. 기술적으로 이것들은 페이지의 */Annots* 배열에서 찾은 모든 " "PDF 객체의 */NM* 값입니다." #: ../../page.rst:1898 4c2d49dd3d9b4a57ba7cd7543d83679a msgid "New in v1.16.10" msgstr "v1.16.10의 새로운 기능" #: ../../page.rst:1905 43b0e664a184459f8f46ced9df2e4d67 msgid "" "PDF only: return a list of the :data:`xref` numbers of annotations, " "widgets and links -- technically of all entries found in the page's " "*/Annots* array." msgstr "" "PDF 전용: 주석, 위젯 및 링크의 :data:`xref` 번호 목록을 반환합니다 -- 기술적으로 페이지의 */Annots* " "배열에서 찾은 모든 항목입니다." #: ../../page.rst:1908 2589ec16e1d545bc804053c44f660fd6 msgid "" "a list of items *(xref, type)* where type is the annotation type. Use the" " type to tell apart links, fields and annotations, see " ":ref:`AnnotationTypes`." msgstr "" "항목 *(xref, type)* 의 목록으로, type은 주석 타입입니다. 타입을 사용하여 링크, 필드 및 주석을 구분하세요. " ":ref:`AnnotationTypes` 참조." #: ../../page.rst:1912 ../../page.rst:1930 265a6dff70594e58bc37576ebd86d1c4 #: ea22dac92d4e4deba79fc23ace95019a msgid "New in v1.17.1" msgstr "v1.17.1의 새로운 기능" #: ../../page.rst:1919 b8c4c4f249b24a629d3b0554f81f71c8 msgid "" "PDF only: return the annotation identified by *ident*. This may be its " "unique name (PDF `/NM` key), or its :data:`xref`." msgstr "" "PDF 전용: *ident* 로 식별된 주석을 반환합니다. 이것은 고유 이름(PDF `/NM` 키) 또는 :data:`xref` 일" " 수 있습니다." #: ../../page.rst:1921 99d103647d654aa99112b1f2df5fd5e1 msgid "the annotation name or xref." msgstr "주석 이름 또는 xref." #: ../../page.rst:1924 308e3cdaa90a43228e0fff6141198c14 msgid "the annotation or ``None``." msgstr "주석 또는 ``None``." #: ../../page.rst:1926 44c7aaf1a962484ab7df2f56b74b4bf1 msgid "" "Methods :meth:`Page.annot_names`, :meth:`Page.annot_xrefs` provide lists " "of names or xrefs, respectively, from where an item may be picked and " "loaded via this method." msgstr "" ":meth:`Page.annot_names`, :meth:`Page.annot_xrefs` 메서드는 각각 이름 또는 xref 목록을" " 제공하며, 여기서 항목을 선택하여 이 메서드를 통해 로드할 수 있습니다." #: ../../page.rst:1936 fd10fefbee7c437f8c7b6cf0f981510a msgid "PDF only: return the field identified by :data:`xref`." msgstr "PDF 전용: :data:`xref` 로 식별된 필드를 반환합니다." #: ../../page.rst:1938 58524de2ecc046d59b68a2c709c3271a msgid "the field's xref." msgstr "필드의 xref." #: ../../page.rst:1941 381b8423209541b7a3d58b8a6ec5db9f msgid "the field or ``None``." msgstr "필드 또는 ``None``." #: ../../page.rst:1943 4063b13ef0374b37b8d55e04944132ff msgid "" "This is similar to the analogous method :meth:`Page.load_annot` -- except" " that here only the xref is supported as identifier." msgstr "" "이것은 유사한 메서드 :meth:`Page.load_annot` 와 유사합니다 -- 여기서는 xref만 식별자로 지원된다는 점을 " "제외하고." #: ../../page.rst:1947 0438cdbc2ea6414c95089b9e09c4ceb9 msgid "New in v1.19.6" msgstr "v1.19.6의 새로운 기능" #: ../../page.rst:1953 b6f74196aeee4aacb3f2fd74011a5976 msgid "Return the first link on a page. Synonym of property :attr:`first_link`." msgstr "페이지의 첫 번째 링크를 반환합니다. 속성 :attr:`first_link` 의 동의어입니다." #: ../../page.rst:1955 ../../page.rst:2252 62cca066e58a4a0ab79f7377e948f7c3 #: d31c53af7516446089fd6f651872dcff msgid ":ref:`Link`" msgstr ":ref:`Link`" #: ../../page.rst:1956 4fb357ed0a6846cda5965057b49118d2 msgid "first link on the page (or ``None``)." msgstr "페이지의 첫 번째 링크(또는 ``None``)." #: ../../page.rst:1963 6e189460d0b4477dbf6f24a618d34e32 msgid "PDF only: Set the rotation of the page." msgstr "PDF 전용: 페이지의 회전을 설정합니다." #: ../../page.rst:1965 b1f53a50a11149e5b93cd14e3b018bb8 msgid "" "An integer specifying the required rotation in degrees. Must be an " "integer multiple of 90. Values will be converted to one of 0, 90, 180, " "270." msgstr "필요한 회전을 도 단위로 지정하는 정수. 90의 정수 배수여야 합니다. 값은 0, 90, 180, 270 중 하나로 변환됩니다." #: ../../page.rst:1969 652124939d40408f83082ee8d73b98f6 msgid "PDF only: Change the colorspace components of all objects on page." msgstr "PDF 전용: 페이지의 모든 객체의 색 공간 컴포넌트를 변경합니다." #: ../../page.rst:1971 4bb3cbbc9e6a4173bba15172194856ef msgid "" "The desired count of color components. Must be one of 1, 3 or 4, which " "results in color spaces DeviceGray, DeviceRGB or DeviceCMYK respectively." " The method affects text, images and vector graphics. For instance, with " "the default value 1, a page will be converted to grayscale. If a page is " "already grayscale, the method will not cause visible changes -- " "independent of the value of ``components``." msgstr "" "원하는 색상 컴포넌트 수. 1, 3 또는 4 중 하나여야 하며, 각각 색 공간 DeviceGray, DeviceRGB 또는 " "DeviceCMYK를 생성합니다. 이 메서드는 텍스트, 이미지 및 벡터 그래픽에 영향을 줍니다. 예를 들어, 기본값 1을 사용하면 " "페이지가 그레이스케일로 변환됩니다. 페이지가 이미 그레이스케일인 경우 이 메서드는 ``components`` 값과 관계없이 눈에 " "보이는 변경을 일으키지 않습니다." #: ../../page.rst:1973 483d3d2a28a64e1db8c84814f5b62553 msgid "These changes are **permanent** and cannot be reverted." msgstr "이러한 변경 사항은 **영구적** 이며 되돌릴 수 없습니다." #: ../../page.rst:1977 49b350e20d564e5ca4be60761eebd7f6 msgid "" "PDF only: Permanently remove page content outside the given rectangle. " "This is similar to :meth:`Page.set_cropbox`, but the page's rectangle " "will not be changed, only the content outside the rectangle will be " "removed." msgstr "" "PDF 전용: 주어진 사각형 외부의 페이지 콘텐츠를 영구적으로 제거합니다. 이것은 :meth:`Page.set_cropbox` 와 " "유사하지만, 페이지의 사각형은 변경되지 않고 사각형 외부의 콘텐츠만 제거됩니다." #: ../../page.rst:1979 bf753e463def4992b7ab3a5cba587ab6 msgid "" "The rectangle to clip to. Must be finite and its intersection with the " "page must not be empty." msgstr "클리핑할 사각형. 유한해야 하며 페이지와의 교집합이 비어 있지 않아야 합니다." #: ../../page.rst:1981 da1c632880b442c599ff83e02a1fee53 msgid "" "The method works best for text: All text on the page will be removed " "(decided by single character) that has no intersection with the " "rectangle. For vector graphics, the method will remove all paths that " "have no intersection with the rectangle. For images, the method will " "remove all images that have no intersection with the rectangle. Vectors " "and images **having** an intersection with the rectangle, will be kept in" " their entirety." msgstr "" "이 메서드는 텍스트에 가장 잘 작동합니다: 사각형과 교집합이 없는 페이지의 모든 텍스트가 제거됩니다(단일 문자로 결정). 벡터 " "그래픽의 경우 이 메서드는 사각형과 교집합이 없는 모든 경로를 제거합니다. 이미지의 경우 이 메서드는 사각형과 교집합이 없는 모든 " "이미지를 제거합니다. 사각형과 **교집합이 있는** 벡터 및 이미지는 전체가 유지됩니다." #: ../../page.rst:1983 ebdf3ebf7ffa4ae5897bfc0c9e729577 msgid "" "The method roughly has the same effect as if four redactions had been " "applied that cover the rectangle's outside." msgstr "이 메서드는 사각형 외부를 덮는 네 개의 교정이 적용된 것과 거의 동일한 효과를 가집니다." #: ../../page.rst:1985 5834a8e7d537400cb60453c1d4852b9a msgid "New in v1.26.4." msgstr "v1.26.4의 새로운 기능." #: ../../page.rst:1989 0cee26002f6742f798ab8e2f8ded9df9 msgid "" "PDF only: Set page rotation to 0 while maintaining appearance and page " "content." msgstr "PDF 전용: 외관과 페이지 콘텐츠를 유지하면서 페이지 회전을 0으로 설정합니다." #: ../../page.rst:1991 1239f6e2692a4bd99008c859cfdc9938 msgid "" "The inverted matrix used to achieve this change. If the page was not " "rotated (rotation 0), :ref:`Identity` is returned. The method " "automatically recomputes the rectangles of any annotations, links and " "widgets present on the page. This method may come in handy when e.g. " "used with :meth:`Page.show_pdf_page`." msgstr "" #: ../../page.rst:1991 6382757f31774362bd5db92ac43822e7 msgid "" "The inverted matrix used to achieve this change. If the page was not " "rotated (rotation 0), :ref:`Identity` is returned. The method " "automatically recomputes the rectangles of any annotations, links and " "widgets present on the page." msgstr "" "이 변경을 달성하는 데 사용된 역행렬. 페이지가 회전되지 않은 경우(회전 0), :ref:`Identity` 가 반환됩니다. 이 " "메서드는 페이지에 있는 모든 주석, 링크 및 위젯의 사각형을 자동으로 다시 계산합니다." #: ../../page.rst:1993 1325f276d0764aac8a21e6d99585710b msgid "" "This method may come in handy when e.g. used with " ":meth:`Page.show_pdf_page`." msgstr "이 메서드는 예를 들어 :meth:`Page.show_pdf_page` 와 함께 사용할 때 유용할 수 있습니다." #: ../../page.rst:2003 8dc74477058c480eb73af8efa28193fc msgid "" "PDF only: Display a page of another PDF. This is similar to " ":meth:`Page.insert_image` but the source page will appear like a copy of " "itself and will not be rasterized. This is a multi-purpose method. For " "example, you can use it to:" msgstr "" "PDF 전용: 다른 PDF의 페이지를 표시합니다. 이것은 :meth:`Page.insert_image` 와 유사하지만 소스 페이지는" " 자체의 복사본처럼 나타나며 래스터화되지 않습니다. 이것은 다목적 메서드입니다. 예를 들어, 다음에 사용할 수 있습니다:" #: ../../page.rst:2005 354740c7f18a43a986458b228303b6d6 msgid "" "create \"n-up\" versions of existing PDF files, combining several input " "pages into **one output page** (see example `combine.py " "`_)," msgstr "" "기존 PDF 파일의 \"n-up\" 버전 생성, 여러 입력 페이지를 **하나의 출력 페이지** 로 결합(예제 `combine.py " "`_ 참조)," #: ../../page.rst:2006 783780442f794f0cb6359372ce4d1fb5 msgid "" "create \"posterized\" PDF files, i.e. every input page is split up in " "parts which each create a separate output page (see `posterize.py " "`_)," msgstr "" "\"포스터화된\" PDF 파일 생성, 즉 모든 입력 페이지가 여러 부분으로 분할되어 각각 별도의 출력 페이지를 생성(예제 " "`posterize.py `_ 참조)," #: ../../page.rst:2007 cf10ad7db3454757a6226b1377e0f6b6 msgid "" "include PDF-based vector images like company logos, watermarks, etc., see" " `svg-logo.py `_, which puts an SVG-based " "logo on each page." msgstr "" "회사 로고, 워터마크 등과 같은 PDF 기반 벡터 이미지 포함, 각 페이지에 SVG 기반 로고를 배치하는 `svg-logo.py " "`_ 참조." #: ../../page.rst:2009 33c0c00be5d74048bed44c2ebe78831d msgid "" "where to place the image on current page. Must be finite and its " "intersection with the page must not be empty." msgstr "현재 페이지에 이미지를 배치할 위치. 유한해야 하며 페이지와의 교집합이 비어 있지 않아야 합니다." #: ../../page.rst:2010 71c6cc3da72244c483db1f62fe33d794 msgid "" "source PDF document containing the page. Must be a different document " "object, but may be the same file." msgstr "페이지를 포함하는 소스 PDF 문서. 다른 문서 객체여야 하지만 동일한 파일일 수 있습니다." #: ../../page.rst:2013 adf70c9bce3a4133b9ffdde0c8e97b40 msgid "page number (0-based, in `-∞ < pno < docsrc.page_count`) to be shown." msgstr "표시할 페이지 번호(0 기반, `-∞ < pno < docsrc.page_count`)." #: ../../page.rst:2015 d14eefd61c384956a207b09f9ad3c383 msgid "" "whether to maintain the width-height-ratio (default). If false, all 4 " "corners are always positioned on the border of the target rectangle -- " "whatever the rotation value. In general, this will deliver distorted and " "/or non-rectangular images." msgstr "" "너비-높이 비율을 유지할지 여부(기본값). false이면 회전 값과 관계없이 4개의 모서리가 모두 대상 사각형의 경계에 배치됩니다." " 일반적으로 이것은 왜곡되고/또는 비사각형 이미지를 제공합니다." #: ../../page.rst:2017 aa72d9ab8817411da2f050b7e23bcde4 msgid "put image in foreground (default) or background." msgstr "이미지를 전경(기본값) 또는 배경에 배치합니다." #: ../../page.rst:2019 eeb052672cb248acaaffb0046bf42971 msgid "" "(:data:`xref`) make visibility dependent on this :data:`OCG` / " ":data:`OCMD` (which must be defined in the target PDF) [#f9]_. (New in " "v1.18.3)" msgstr "" "(:data:`xref`) 이 :data:`OCG` / :data:`OCMD` 에 따라 가시성을 설정합니다(대상 PDF에 정의되어 " "있어야 함) [#f9]_. (v1.18.3의 새로운 기능)" #: ../../page.rst:2020 96f5420198ff41f89a8c3094e8910629 msgid "" "show the source rectangle rotated by some angle. Any angle is supported " "(changed in v1.14.11). (New in v1.14.10)" msgstr "" "소스 사각형을 특정 각도로 회전하여 표시합니다. 모든 각도가 지원됩니다(v1.14.11에서 변경됨). (v1.14.10의 새로운 " "기능)" #: ../../page.rst:2022 d52ff41f1cd14e97a0c6a6dad3d809dd msgid "" "choose which part of the source page to show. Default is the full page, " "else must be finite and its intersection with the source page must not be" " empty." msgstr "" "소스 페이지의 어느 부분을 표시할지 선택합니다. 기본값은 전체 페이지이며, 그렇지 않으면 유한해야 하며 소스 페이지와의 교집합이 " "비어 있지 않아야 합니다." #: ../../page.rst:2024 3aef8119e20e4ffa8d394518498d43af msgid "" "In contrast to method :meth:`Document.insert_pdf`, this method does not " "copy annotations, widgets or links, so these objects are not included in " "the target [#f6]_. But all its **other resources (text, images, fonts, " "etc.)** will be imported into the current PDF. They will therefore appear" " in text extractions and in :meth:`get_fonts` and :meth:`get_images` " "lists -- even if they are not contained in the visible area given by " "*clip*." msgstr "" ":meth:`Document.insert_pdf` 메서드와 달리 이 메서드는 주석, 위젯 또는 링크를 복사하지 않으므로 이러한 " "객체는 대상에 포함되지 않습니다 [#f6]_. 하지만 모든 **기타 리소스(텍스트, 이미지, 글꼴 등)** 는 현재 PDF로 " "가져옵니다. 따라서 *clip* 으로 지정된 보이는 영역에 포함되지 않더라도 텍스트 추출 및 :meth:`get_fonts` 및 " ":meth:`get_images` 목록에 나타납니다." #: ../../page.rst:2026 5fba7277847b4bc793310bd2e3feece9 msgid "Example: Show the same source page, rotated by 90 and by -90 degrees:" msgstr "예제: 동일한 소스 페이지를 90도 및 -90도로 회전하여 표시:" #: ../../page.rst:2048 073d99851b794037a8e8f80aed9a6844 msgid "" "Changed in v1.14.11: Parameter *reuse_xref* has been deprecated. Position" " the source rectangle centered in target rectangle. Any rotation angle is" " now supported." msgstr "" "v1.14.11에서 변경됨: 매개변수 *reuse_xref* 가 더 이상 사용되지 않습니다. 소스 사각형을 대상 사각형의 중앙에 " "배치합니다. 이제 모든 회전 각도가 지원됩니다." #: ../../page.rst:2049 5c783c076ae74e24ac1476998953fa6e msgid "Changed in v1.18.3: New parameter `oc`." msgstr "v1.18.3에서 변경됨: 새로운 매개변수 `oc`." #: ../../page.rst:2055 0e3799b8dc0a45ee9cc3f0fa9ed0c555 msgid "PDF only: Create a new :ref:`Shape` object for the page." msgstr "PDF 전용: 페이지에 대한 새로운 :ref:`Shape` 객체를 생성합니다." #: ../../page.rst:2057 1836989d75f0407e86fc7a982cdc99f3 msgid ":ref:`Shape`" msgstr ":ref:`Shape`" #: ../../page.rst:2058 846397e4abdf4c3b8e63573909076603 msgid "a new :ref:`Shape` to use for compound drawings. See description there." msgstr "복합 그림에 사용할 새로운 :ref:`Shape`. 설명을 참조하세요." #: ../../page.rst:2069 582bc47d92404cacb9f37e4455d4e925 msgid "Search for *needle* on a page. Wrapper for :meth:`TextPage.search`." msgstr "페이지에서 *needle* 을 검색합니다. :meth:`TextPage.search` 의 래퍼입니다." #: ../../page.rst:2071 8f30cc4067374cefb36176bc93c7b187 msgid "" "Text to search for. May contain spaces. Upper / lower case is ignored, " "but only works for ASCII characters: For example, \"COMPÉTENCES\" will " "not be found if needle is \"compétences\" -- \"compÉtences\" however " "will. Similar is true for German umlauts and the like." msgstr "" "검색할 텍스트. 공백을 포함할 수 있습니다. 대소문자는 무시되지만 ASCII 문자에만 작동합니다: 예를 들어, " "\"COMPÉTENCES\" 는 needle이 \"compétences\" 인 경우 찾을 수 없습니다 -- 하지만 " "\"compÉtences\" 는 찾을 수 있습니다. 독일어 움라우트 등도 마찬가지입니다." #: ../../page.rst:2072 be9d1f75e4d94af6afd2298e0fcb0d1a msgid "only search within this area. (New in v1.18.2)" msgstr "이 영역 내에서만 검색합니다. (v1.18.2의 새로운 기능)" #: ../../page.rst:2073 b4532cd56fb245689ebfe2ad1520d06f msgid "Return object type :ref:`Quad` instead of :ref:`Rect`." msgstr ":ref:`Rect` 대신 :ref:`Quad` 객체 타입을 반환합니다." #: ../../page.rst:2074 fba71b85626a46759cf1e3a4ca5991f5 msgid "" "Control the data extracted by the underlying :ref:`TextPage`. By default," " ligatures and white spaces are kept, and hyphenation [#f8]_ is detected." msgstr "" "기본 :ref:`TextPage` 에 의해 추출된 데이터를 제어합니다. 기본적으로 합자와 공백이 유지되며 하이픈 연결 [#f8]_ " "이 감지됩니다." #: ../../page.rst:2075 411c63769a4848319b2cf5c0a356fe7a msgid "" "use a previously created :ref:`TextPage`. This reduces execution time " "**significantly.** If specified, the 'flags' and 'clip' arguments are " "ignored. If omitted, a temporary textpage will be created. (New in " "v1.19.0)" msgstr "" "이전에 생성된 :ref:`TextPage` 를 사용합니다. 이것은 실행 시간을 **크게** 줄입니다. 지정하면 'flags' 및 " "'clip' 인수는 무시됩니다. 생략하면 임시 textpage가 생성됩니다. (v1.19.0의 새로운 기능)" #: ../../page.rst:2079 720c33ce38fd4b22963ec128ce4a00bb msgid "" "A list of :ref:`Rect` or :ref:`Quad` objects, each of which -- " "**normally!** -- surrounds one occurrence of *needle*. **However:** if " "parts of *needle* occur on more than one line, then a separate item is " "generated for each these parts. So, if `needle = \"search string\"`, two " "rectangles may be generated. |history_begin| Changes in v1.18.2: * " "There no longer is a limit on the list length (removal of the `hit_max` " "parameter). * If a word is **hyphenated** at a line break, it will still " "be found. E.g. the needle \"method\" will be found even if hyphenated as " "\"meth-od\" at a line break, and two rectangles will be returned: one " "surrounding \"meth\" (without the hyphen) and another one surrounding " "\"od\". |history_end|" msgstr "" #: ../../page.rst:2081 f8d208e58858471b8f92953db79f51c3 msgid "" "A list of :ref:`Rect` or :ref:`Quad` objects, each of which -- " "**normally!** -- surrounds one occurrence of *needle*. **However:** if " "parts of *needle* occur on more than one line, then a separate item is " "generated for each these parts. So, if `needle = \"search string\"`, two " "rectangles may be generated." msgstr "" ":ref:`Rect` 또는 :ref:`Quad` 객체의 목록으로, 각각은 -- **일반적으로!** -- *needle* 의 한 " "발생을 둘러쌉니다. **하지만:** *needle* 의 일부가 여러 줄에 나타나면 각 부분에 대해 별도의 항목이 생성됩니다. 따라서" " `needle = \"search string\"` 인 경우 두 개의 사각형이 생성될 수 있습니다." #: ../../page.rst:2085 dbb74981c75a4e0fad63c8a853f37af2 msgid "Changes in v1.18.2:" msgstr "v1.18.2의 변경 사항:" #: ../../page.rst:2087 fe75a9fa204c408d9bec7cc0681e818b msgid "" "There no longer is a limit on the list length (removal of the `hit_max` " "parameter)." msgstr "목록 길이에 더 이상 제한이 없습니다(`hit_max` 매개변수 제거)." #: ../../page.rst:2088 31766ebe188f4ee1ae221104e2508841 msgid "" "If a word is **hyphenated** at a line break, it will still be found. E.g." " the needle \"method\" will be found even if hyphenated as \"meth-od\" at" " a line break, and two rectangles will be returned: one surrounding " "\"meth\" (without the hyphen) and another one surrounding \"od\"." msgstr "" "단어가 줄바꿈에서 **하이픈으로 연결** 되어 있어도 여전히 찾을 수 있습니다. 예를 들어, needle \"method\" 는 " "줄바꿈에서 \"meth-od\" 로 하이픈 연결되어 있어도 찾을 수 있으며, 두 개의 사각형이 반환됩니다: 하나는 \"meth\" " "(하이픈 없이)를 둘러싸고 다른 하나는 \"od\" 를 둘러쌉니다." #: ../../page.rst:2092 77b9f7f5f65e44048049b365e391fb62 msgid "" "The method supports multi-line text marker annotations: you can use the " "full returned list as **one single** parameter for creating the " "annotation." msgstr "" "이 메서드는 다중 줄 텍스트 마커 주석을 지원합니다: 반환된 전체 목록을 주석을 생성하기 위한 **단일** 매개변수로 사용할 수 " "있습니다." #: ../../page.rst:2096 57554cf44857462a93fa6f8911265cf5 msgid "" "There is a tricky aspect: the search logic regards **contiguous multiple " "occurrences** of *needle* as one: assuming *needle* is \"abc\", and the " "page contains \"abc\" and \"abcabc\", then only **two** rectangles will " "be returned, one for \"abc\", and a second one for \"abcabc\"." msgstr "" "까다로운 측면이 있습니다: 검색 로직은 *needle* 의 **연속된 여러 발생** 을 하나로 간주합니다: *needle* 이 " "\"abc\" 이고 페이지에 \"abc\" 와 \"abcabc\" 가 포함된 경우, **두 개의** 사각형만 반환됩니다. 하나는 " "\"abc\" 에 대한 것이고 두 번째는 \"abcabc\" 에 대한 것입니다." #: ../../page.rst:2097 abecd36837344b119db60f93d69e4ab5 msgid "" "You can always use :meth:`Page.get_textbox` to check what text actually " "is being surrounded by each rectangle." msgstr ":meth:`Page.get_textbox` 를 사용하여 각 사각형이 실제로 어떤 텍스트를 둘러싸고 있는지 확인할 수 있습니다." #: ../../page.rst:2099 ae4dd62d990f45049a3d1efab5f6aad6 msgid "" "A feature repeatedly asked for is supporting **regular expressions** when" " specifying the `\"needle\"` string: **There is no way to do this.** If " "you need something in that direction, first extract text in the desired " "format and then subselect the result by matching with some regex pattern." " Here is an example for matching words::" msgstr "" "반복적으로 요청된 기능은 `\"needle\"` 문자열을 지정할 때 **정규 표현식** 을 지원하는 것입니다: **이것을 수행할 " "방법이 없습니다.** 그런 방향이 필요하다면, 먼저 원하는 형식으로 텍스트를 추출한 다음 일부 정규식 패턴과 일치시켜 결과를 하위 " "선택하세요. 단어를 일치시키는 예제는 다음과 같습니다::" #: ../../page.rst:2105 6d2d34e353264e1ca0fc568527af9a70 msgid "" "The `matches` list will contain the words matching the given pattern. In " "the same way you can select `span[\"text\"]` from the output of " "`page.get_text(\"dict\")`." msgstr "" "`matches` 목록에는 주어진 패턴과 일치하는 단어가 포함됩니다. 같은 방식으로 `page.get_text(\"dict\")` " "의 출력에서 `span[\"text\"]` 를 선택할 수 있습니다." #: ../../page.rst:2109 498f8aa809b649cc87bf0051b213dcaa msgid "" "Changed in v1.18.2: added `clip` parameter. Remove `hit_max` parameter. " "Add default \"dehyphenate\"." msgstr "v1.18.2에서 변경됨: `clip` 매개변수 추가. `hit_max` 매개변수 제거. 기본값 \"dehyphenate\" 추가." #: ../../page.rst:2110 20246746300244b382c5d8a1c9d4126a msgid "Changed in v1.19.0: added `textpage` parameter." msgstr "v1.19.0에서 변경됨: `textpage` 매개변수 추가." #: ../../page.rst:2117 2692c3f033cf4f2f805f6a7112f70898 msgid "" "PDF only: Change the physical page dimension by setting :data:`mediabox` " "in the page's object definition." msgstr "PDF 전용: 페이지 객체 정의에서 :data:`mediabox` 를 설정하여 물리적 페이지 크기를 변경합니다." #: ../../page.rst:2119 a9b2bf70f6b74517aa540d6e83f7bea9 msgid "the new :data:`mediabox` value." msgstr "새로운 :data:`mediabox` 값." #: ../../page.rst:2121 7a6526b2c64d4e3a9bd927b363722d6d msgid "" "This method also removes the page's other (optional) rectangles " "(:data:`cropbox`, ArtBox, TrimBox and Bleedbox) to prevent inconsistent " "situations. This will cause those to assume their default values." msgstr "" "이 메서드는 일관성 없는 상황을 방지하기 위해 페이지의 다른 (선택적) 사각형(:data:`cropbox`, ArtBox, " "TrimBox 및 Bleedbox)도 제거합니다. 이것은 그것들이 기본값을 가정하도록 합니다." #: ../../page.rst:2123 1ab3183f788442cb82b31ca3e697cd7d msgid "" "For non-empty pages this may have undesired effects, because the location" " of all content depends on this value and will therefore change position " "or even disappear." msgstr "" "비어 있지 않은 페이지의 경우 이것은 원하지 않는 효과를 가질 수 있습니다. 모든 콘텐츠의 위치가 이 값에 의존하므로 위치가 " "변경되거나 사라질 수 있기 때문입니다." #: ../../page.rst:2127 2db1401ccd4e4c978f4a0b50365f8a62 msgid "New in v1.16.13" msgstr "v1.16.13의 새로운 기능" #: ../../page.rst:2128 9f33ae9d37ea49a9af0f2276c2df8490 msgid "Changed in v1.19.4: remove all other rectangle definitions." msgstr "v1.19.4에서 변경됨: 모든 다른 사각형 정의 제거." #: ../../page.rst:2135 e2267e65404e4f89b3f1d7032048a1b9 msgid "PDF only: change the visible part of the page." msgstr "PDF 전용: 페이지의 보이는 부분을 변경합니다." #: ../../page.rst:2137 26dafb91ce2c4c86b79422d5065a7ff1 msgid "" "the new visible area of the page. Note that this **must** be specified in" " **unrotated coordinates**, not empty, nor infinite and be completely " "contained in the :attr:`Page.mediabox`." msgstr "" "페이지의 새로운 보이는 영역. 이것은 **회전되지 않은 좌표** 로 지정되어야 하며, 비어 있지 않고 무한하지 않으며 " ":attr:`Page.mediabox` 에 완전히 포함되어야 합니다." #: ../../page.rst:2139 1a4ce62ae3164bf9b7d5867e0d15da9f msgid "" "After execution **(if the page is not rotated)**, :attr:`Page.rect` will " "equal this rectangle, but be shifted to the top-left position (0, 0) if " "necessary. Example session:" msgstr "" "실행 후 **(페이지가 회전되지 않은 경우)**, :attr:`Page.rect` 는 이 사각형과 같지만 필요하면 왼쪽 상단 위치 " "(0, 0)로 이동합니다. 예제 세션:" #: ../../page.rst:2170 487d3f62d0154c43b809962cb834db02 msgid "" "PDF only: Set the resp. rectangle in the page object. For the meaning of " "these objects see :ref:`AdobeManual`, page 77. Parameter and restrictions" " are the same as for :meth:`Page.set_cropbox`." msgstr "" "PDF 전용: 페이지 객체에서 해당 사각형을 설정합니다. 이러한 객체의 의미는 :ref:`AdobeManual`, 77페이지를 " "참조하세요. 매개변수와 제한 사항은 :meth:`Page.set_cropbox` 와 동일합니다." #: ../../page.rst:2174 84db1fa5172f42269728027e803083b4 msgid "New in v1.19.4" msgstr "v1.19.4의 새로운 기능" #: ../../page.rst:2180 f499b299e1a344c192594e6c3347536f msgid "" "Contains the rotation of the page in degrees (always 0 for non-PDF " "types). This is a copy of the value in the PDF file. The PDF " "documentation says:" msgstr "" "페이지의 회전을 도 단위로 포함합니다(비-PDF 타입의 경우 항상 0). 이것은 PDF 파일의 값 복사본입니다. PDF 문서에 " "따르면:" #: ../../page.rst:2182 40609a90d7294c4386d6b38c137de2e7 msgid "" "*\"The number of degrees by which the page should be rotated clockwise " "when displayed or printed. The value must be a multiple of 90. Default " "value: 0.\"*" msgstr "*\"표시되거나 인쇄될 때 페이지가 시계 방향으로 회전해야 하는 도 수. 값은 90의 배수여야 합니다. 기본값: 0.\"*" #: ../../page.rst:2184 ef02a9bf2df247b79809ffaceff1c539 msgid "" "In PyMuPDF, we make sure that this attribute is always one of 0, 90, 180 " "or 270." msgstr "PyMuPDF에서는 이 속성이 항상 0, 90, 180 또는 270 중 하나가 되도록 합니다." #: ../../page.rst:2190 217c654874984e38be9562d0c4b8b436 msgid "" "Contains the top-left point of the page's `/CropBox` for a PDF, otherwise" " *Point(0, 0)*." msgstr "PDF의 경우 페이지의 `/CropBox` 의 왼쪽 상단 점을 포함하고, 그렇지 않으면 *Point(0, 0)*." #: ../../page.rst:2192 ../../page.rst:2216 82507dc59ca94b3aa9846470ca6093c8 #: db796a2e28a84eb0a59bac3ca1348f7b msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../page.rst:2196 51b3952c0e0a4489b270e2f2b48c55fb msgid "" "The page's `/CropBox` for a PDF. Always the **unrotated** page rectangle " "is returned. For a non-PDF this will always equal the page rectangle." msgstr "" "PDF의 경우 페이지의 `/CropBox`. 항상 **회전되지 않은** 페이지 사각형이 반환됩니다. 비-PDF의 경우 이것은 항상 " "페이지 사각형과 같습니다." #: ../../page.rst:2198 33482f994ea2453f977561ad97c6e4c0 msgid "" "In PDF, the relationship between `/MediaBox`, `/CropBox` and page " "rectangle may sometimes be confusing, please do lookup the glossary for " ":data:`MediaBox`." msgstr "" "PDF에서 `/MediaBox`, `/CropBox` 및 페이지 사각형 간의 관계는 때때로 혼란스러울 수 있으므로 " ":data:`MediaBox` 에 대한 용어집을 참조하세요." #: ../../page.rst:2208 79b7c13fa8f340dca2a19eb7ce19481c msgid "" "The page's `/ArtBox`, `/BleedBox`, `/TrimBox`, respectively. If not " "provided, defaulting to :attr:`Page.cropbox`." msgstr "" "페이지의 `/ArtBox`, `/BleedBox`, `/TrimBox` 각각. 제공되지 않은 경우 " ":attr:`Page.cropbox` 로 기본값이 설정됩니다." #: ../../page.rst:2214 527ae95e018f4a37824ed8a2e6e720a7 msgid "" "Contains the width and height of the page's :attr:`Page.mediabox` for a " "PDF, otherwise the bottom-right coordinates of :attr:`Page.rect`." msgstr "" "PDF의 경우 페이지의 :attr:`Page.mediabox` 의 너비와 높이를 포함하고, 그렇지 않으면 " ":attr:`Page.rect` 의 오른쪽 하단 좌표를 포함합니다." #: ../../page.rst:2220 df54f6f570c14da0b9f75f4d3cd19aea msgid "The page's :data:`mediabox` for a PDF, otherwise :attr:`Page.rect`." msgstr "PDF의 경우 페이지의 :data:`mediabox`, 그렇지 않으면 :attr:`Page.rect`." #: ../../page.rst:2224 58641a6d613248a5a15705b030d9f4cc msgid "" "For most PDF documents and for **all other document types**, `page.rect " "== page.cropbox == page.mediabox` is true. However, for some PDFs the " "visible page is a true subset of :data:`mediabox`. Also, if the page is " "rotated, its `Page.rect` may not equal `Page.cropbox`. In these cases the" " above attributes help to correctly locate page elements." msgstr "" "대부분의 PDF 문서와 **모든 다른 문서 타입** 의 경우 `page.rect == page.cropbox == " "page.mediabox` 가 참입니다. 하지만 일부 PDF의 경우 보이는 페이지는 :data:`mediabox` 의 " "진부분집합입니다. 또한 페이지가 회전된 경우 `Page.rect` 는 `Page.cropbox` 와 같지 않을 수 있습니다. 이러한" " 경우 위의 속성은 페이지 요소를 올바르게 찾는 데 도움이 됩니다." #: ../../page.rst:2228 691c2b38aaf24491808a5a3aa6056d75 msgid "" "This matrix translates coordinates from the PDF space to the MuPDF space." " For example, in PDF `/Rect [x0 y0 x1 y1]` the pair (x0, y0) specifies " "the **bottom-left** point of the rectangle -- in contrast to MuPDF's " "system, where (x0, y0) specify top-left. Multiplying the PDF coordinates " "with this matrix will deliver the (Py-) MuPDF rectangle version. " "Obviously, the inverse matrix will again yield the PDF rectangle." msgstr "" "이 행렬은 좌표를 PDF 공간에서 MuPDF 공간으로 변환합니다. 예를 들어, PDF에서 `/Rect [x0 y0 x1 y1]` 의" " 쌍 (x0, y0)은 사각형의 **왼쪽 하단** 점을 지정합니다 -- MuPDF 시스템과 대조적으로, 여기서 (x0, y0)는 " "왼쪽 상단을 지정합니다. PDF 좌표에 이 행렬을 곱하면 (Py-) MuPDF 사각형 버전을 제공합니다. 명백히, 역행렬은 다시 " "PDF 사각형을 생성합니다." #: ../../page.rst:2230 ../../page.rst:2246 19d6b8bfeb41482fb77511189c87cadb #: a708f233bdde4cdaa04aa4ba41af32ed msgid ":ref:`Matrix`" msgstr ":ref:`Matrix`" #: ../../page.rst:2236 619ad68a91444dbda5559a50e7b18870 msgid "" "These matrices may be used for dealing with rotated PDF pages. When " "adding / inserting anything to a PDF page, the coordinates of the " "**unrotated** page are always used. These matrices help translating " "between the two states. Example: if a page is rotated by 90 degrees -- " "what would then be the coordinates of the top-left Point(0, 0) of an A4 " "page?" msgstr "" "이 행렬은 회전된 PDF 페이지를 처리하는 데 사용할 수 있습니다. PDF 페이지에 무언가를 추가/삽입할 때 **회전되지 않은** " "페이지의 좌표가 항상 사용됩니다. 이 행렬은 두 상태 간의 변환을 돕습니다. 예: 페이지가 90도 회전된 경우 -- A4 페이지의 " "왼쪽 상단 Point(0, 0)의 좌표는 무엇일까요?" #: ../../page.rst:2250 ddbabcc453ad4c789405db548087aed7 msgid "Contains the first :ref:`Link` of a page (or ``None``)." msgstr "페이지의 첫 번째 :ref:`Link` 를 포함합니다(또는 ``None``)." #: ../../page.rst:2256 8e9b0966949b4b89a06b7c70c1e622fc msgid "Contains the first :ref:`Annot` of a page (or ``None``)." msgstr "페이지의 첫 번째 :ref:`Annot` 를 포함합니다(또는 ``None``)." #: ../../page.rst:2262 8a8e6bd51e1b49d68dc68901f8520cc0 msgid "Contains the first :ref:`Widget` of a page (or ``None``)." msgstr "페이지의 첫 번째 :ref:`Widget` 를 포함합니다(또는 ``None``)." #: ../../page.rst:2268 f1f4e48ddb894011aaba58e324077d17 msgid "The page number." msgstr "페이지 번호." #: ../../page.rst:2274 598a6f8e2b214784be2c4567bd665784 msgid "The owning document object." msgstr "소유 문서 객체." #: ../../page.rst:2276 fc47bb5d9a384a25988d0005179384a0 msgid ":ref:`Document`" msgstr ":ref:`Document`" #: ../../page.rst:2281 903928ce2b2d4d85b69ddd0c2953a6cd msgid "" "Contains the rectangle of the page. Same as result of " ":meth:`Page.bound()`." msgstr "" #: ../../page.rst:2287 db6b044e10064b77a399ca9bf5685897 msgid "The page's PDF :data:`xref`. Zero if not a PDF." msgstr "페이지의 PDF :data:`xref`. PDF가 아니면 0입니다." #: ../../page.rst:2296 65a9c883c60a4f44bbd31db4bb74e649 msgid "Description of *get_links()* Entries" msgstr "*get_links()* 엔트리 설명" #: ../../page.rst:2297 b1b03f14b2234cd59a58aa04d3f31962 msgid "" "Each entry of the :meth:`Page.get_links` list is a dictionary with the " "following keys:" msgstr "" ":meth:`Page.get_links` 리스트의 각 엔트리는 다음 키를 가진 딕셔너리입니다:" #: ../../page.rst:2299 345a52ebe41749919aa7099360b3523d msgid "" "*kind*: (required) an integer indicating the kind of link. This is one " "of *LINK_NONE*, *LINK_GOTO*, *LINK_GOTOR*, *LINK_LAUNCH*, or *LINK_URI*. " "For values and meaning of these names refer to :ref:`linkDest Kinds`." msgstr "" "*kind*: (필수) 링크 종류를 나타내는 정수. 이것은 *LINK_NONE*, *LINK_GOTO*, *LINK_GOTOR*, *LINK_LAUNCH* 또는 *LINK_URI* 중 하나입니다. 이러한 이름의 값과 의미는 :ref:`linkDest Kinds` 를 참조하세요." #: ../../page.rst:2301 8482a0ea9b60495a97834603a7ea0896 msgid "" "*from*: (required) a :ref:`Rect` describing the \"hot spot\" location on" " the page's visible representation (where the cursor changes to a hand " "image, usually)." msgstr "" "*from*: (필수) 페이지의 보이는 표현에서 \"핫 스팟\" 위치를 설명하는 :ref:`Rect` (일반적으로 커서가 손 이미지로 변경되는 위치)." #: ../../page.rst:2303 67493fe07fbb4e2b991f920c746ec961 msgid "" "*page*: a 0-based integer indicating the destination page. Required for " "*LINK_GOTO* and *LINK_GOTOR*, else ignored." msgstr "" "*page*: 대상 페이지를 나타내는 0 기반 정수. *LINK_GOTO* 및 *LINK_GOTOR* 에 필요하며, 그렇지 않으면 무시됩니다." #: ../../page.rst:2305 80ba8c8c6a844419bb7b03b9b096f0cc msgid "" "*to*: either a *pymupdf.Point*, specifying the destination location on " "the provided page, default is *pymupdf.Point(0, 0)*, or a symbolic " "(indirect) name. If an indirect name is specified, *page = -1* is " "required and the name must be defined in the PDF in order for this to " "work. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored." msgstr "" "*to*: 제공된 페이지의 대상 위치를 지정하는 *pymupdf.Point* (기본값은 *pymupdf.Point(0, 0)*) 또는 기호(간접) 이름. 간접 이름이 지정되면 *page = -1* 이 필요하며 이 이름이 작동하려면 PDF에 정의되어 있어야 합니다. *LINK_GOTO* 및 *LINK_GOTOR* 에 필요하며, 그렇지 않으면 무시됩니다." #: ../../page.rst:2307 e3a21fa1d4b54847a47036cdb423d96f msgid "" "*file*: a string specifying the destination file. Required for " "*LINK_GOTOR* and *LINK_LAUNCH*, else ignored." msgstr "" "*file*: 대상 파일을 지정하는 문자열. *LINK_GOTOR* 및 *LINK_LAUNCH* 에 필요하며, 그렇지 않으면 무시됩니다." #: ../../page.rst:2309 f1058b6ba67e46c2ad73d8fc9842241f msgid "" "*uri*: a string specifying the destination internet resource. Required " "for *LINK_URI*, else ignored. You should make sure to start this string " "with an unambiguous substring, that classifies the subtype of the URL, " "like `\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, " "`\"mailto:\"`, etc. Otherwise your browser will try to interpret the text" " and come to unwanted / unexpected conclusions about the intended URL " "type." msgstr "" "*uri*: 대상 인터넷 리소스를 지정하는 문자열. *LINK_URI* 에 필요하며, 그렇지 않으면 무시됩니다. URL의 하위 타입을 분류하는 명확한 하위 문자열로 이 문자열을 시작해야 합니다. 예: `\"http://\"`, `\"https://\"`, `\"file://\"`, `\"ftp://\"`, `\"mailto:\"` 등. 그렇지 않으면 브라우저가 텍스트를 해석하려고 시도하고 의도한 URL 타입에 대해 원하지 않거나 예상치 못한 결론에 도달할 수 있습니다." #: ../../page.rst:2311 fb92e47c1bcc495899578761acc32d09 msgid "" ":data:`xref`: an integer specifying the PDF :data:`xref` of the link " "object. Do not change this entry in any way. Required for link deletion " "and update, otherwise ignored. For non-PDF documents, this entry contains" " *-1*. It is also *-1* for **all** entries in the *get_links()* list, if " "**any** of the links is not supported by MuPDF - see " ":ref:`notes_on_supporting_links`." msgstr "" ":data:`xref`: 링크 객체의 PDF :data:`xref` 를 지정하는 정수. 이 항목을 어떤 방식으로도 변경하지 마세요. 링크 삭제 및 업데이트에 필요하며, 그렇지 않으면 무시됩니다. 비PDF 문서의 경우 이 항목은 *-1* 을 포함합니다. MuPDF에서 지원하지 않는 링크가 **하나라도** 있으면 *get_links()* 리스트의 **모든** 엔트리에 대해 *-1* 입니다 - :ref:`notes_on_supporting_links` 를 참조하세요." #: ../../page.rst:2316 5433fcbb259a455c9591df3957b3a3f8 msgid "Notes on Supporting Links" msgstr "링크 지원에 대한 참고사항" #: ../../page.rst:2317 7408ebdf3c5c461f90ea45dc48374e34 msgid "" "MuPDF's support for links has changed in **v1.10a**. These changes affect" " link types :data:`LINK_GOTO` and :data:`LINK_GOTOR`." msgstr "" "MuPDF의 링크 지원이 **v1.10a** 에서 변경되었습니다. 이러한 변경 사항은 링크 타입 :data:`LINK_GOTO` 및 :data:`LINK_GOTOR` 에 영향을 줍니다." #: ../../page.rst:2320 64771c6af29e451a9594551d29b5f876 msgid "" "Reading (pertains to method *get_links()* and the *first_link* property " "chain)" msgstr "" "읽기 (*get_links()* 메서드 및 *first_link* 속성 체인과 관련)" #: ../../page.rst:2322 d23361bc3a824ef0bdd6ab8d1998480b msgid "" "If MuPDF detects a link to another file, it will supply either a " "*LINK_GOTOR* or a *LINK_LAUNCH* link kind. In case of *LINK_GOTOR* " "destination details may either be given as page number (eventually " "including position information), or as an indirect destination." msgstr "" "MuPDF가 다른 파일에 대한 링크를 감지하면 *LINK_GOTOR* 또는 *LINK_LAUNCH* 링크 종류를 제공합니다. *LINK_GOTOR* 의 경우 대상 세부 정보는 페이지 번호(최종적으로 위치 정보 포함) 또는 간접 대상으로 제공될 수 있습니다." #: ../../page.rst:2324 5cc576ca82454037a175c38f660477ee msgid "" "If an indirect destination is given, then this is indicated by *page = " "-1*, and *link.dest.dest* will contain this name. The dictionaries in the" " *get_links()* list will contain this information as the *to* value." msgstr "" "간접 대상이 제공되면 이것은 *page = -1* 로 표시되며, *link.dest.dest* 에 이 이름이 포함됩니다. *get_links()* 리스트의 딕셔너리는 이 정보를 *to* 값으로 포함합니다." #: ../../page.rst:2326 0a44a885ed1c4110bb98fa9f94783d3a msgid "" "**Internal links are always** of kind *LINK_GOTO*. If an internal link " "specifies an indirect destination, it **will always be resolved** and the" " resulting direct destination will be returned. Names are **never " "returned for internal links**, and undefined destinations will cause the " "link to be ignored." msgstr "" "**내부 링크는 항상** *LINK_GOTO* 종류입니다. 내부 링크가 간접 대상을 지정하면 **항상 해결** 되며 결과적인 직접 대상이 반환됩니다. 이름은 **내부 링크에 대해 절대 반환되지 않으며**, 정의되지 않은 대상은 링크가 무시되도록 합니다." #: ../../page.rst:2329 364ae5f61f534e0cb85fe46e668d9750 msgid "Writing" msgstr "작성" #: ../../page.rst:2331 b3e125859d70416e8b18693ae72bc7c2 msgid "" "PyMuPDF writes (updates, inserts) links by constructing and writing the " "appropriate PDF object **source**. This makes it possible to specify " "indirect destinations for *LINK_GOTOR* **and** *LINK_GOTO* link kinds " "(pre *PDF 1.2* file formats are **not supported**)." msgstr "" "|PyMuPDF| 는 적절한 PDF 객체 **소스** 를 구성하고 작성하여 링크를 작성(업데이트, 삽입)합니다. 이것은 *LINK_GOTOR* **및** *LINK_GOTO* 링크 종류에 대해 간접 대상을 지정할 수 있게 합니다(*PDF 1.2* 이전 파일 형식은 **지원되지 않습니다**)." #: ../../page.rst:2333 e852dc9617584ee58517aec2dc16cf16 msgid "" "If a *LINK_GOTO* indirect destination specifies an undefined name, this " "link can later on not be found / read again with MuPDF / PyMuPDF. Other " "readers however **will** detect it, but flag it as erroneous." msgstr "" "*LINK_GOTO* 간접 대상이 정의되지 않은 이름을 지정하면 이 링크는 나중에 MuPDF / PyMuPDF 로 찾거나 다시 읽을 수 없습니다. 그러나 다른 리더는 **감지** 하지만 오류로 표시합니다." #: ../../page.rst:2335 3f1aee12b6824cf3b031cec169329f4a msgid "" "Indirect *LINK_GOTOR* destinations can in general of course not be " "checked for validity and are therefore **always accepted**." msgstr "" "간접 *LINK_GOTOR* 대상은 일반적으로 유효성을 확인할 수 없으므로 **항상 수락됩니다**." #: ../../page.rst:2337 a64fd9e78538459790a5e2a2c922d4ef msgid "" "**Example: How to insert a link pointing to another page in the same " "document**" msgstr "" "**예제: 동일한 문서의 다른 페이지를 가리키는 링크를 삽입하는 방법**" #: ../../page.rst:2339 66099395d24e4c07956dd70ca3e49b6d msgid "" "Determine the rectangle on the current page, where the link should be " "placed. This may be the bbox of an image or some text." msgstr "" "링크가 배치될 현재 페이지의 사각형을 결정합니다. 이것은 이미지 또는 일부 텍스트의 bbox일 수 있습니다." #: ../../page.rst:2341 eee66e0a08254b82833fe8c4bfea4c53 msgid "" "Determine the target page number (\"pno\", 0-based) and a :ref:`Point` on" " it, where the link should be directed to." msgstr "" "대상 페이지 번호(\"pno\", 0 기반)와 링크가 향해야 할 그 위의 :ref:`Point` 를 결정합니다." #: ../../page.rst:2343 11f4142d175a4fb6b17070fcf3363118 #, python-brace-format msgid "" "Create a dictionary `d = {\"kind\": pymupdf.LINK_GOTO, \"page\": pno, " "\"from\": bbox, \"to\": point}`." msgstr "" "딕셔너리 `d = {\"kind\": pymupdf.LINK_GOTO, \"page\": pno, \"from\": bbox, \"to\": point}` 를 생성합니다." #: ../../page.rst:2345 a4dcca662bf242b3a856fe37acc0d604 msgid "Execute `page.insert_link(d)`." msgstr "`page.insert_link(d)` 를 실행합니다." #: ../../page.rst:2349 0382665d56da4efb9be9ff4a73c4d746 msgid "Homologous Methods of :ref:`Document` and :ref:`Page`" msgstr ":ref:`Document` 및 :ref:`Page` 의 동종 메서드" #: ../../page.rst:2350 e4415ec94f5448acbc079d4818b17baf msgid "" "This is an overview of homologous methods on the :ref:`Document` and on " "the :ref:`Page` level." msgstr "" "이것은 :ref:`Document` 및 :ref:`Page` 수준의 동종 메서드 개요입니다." #: ../../page.rst:2353 3ccac822355b4b54b940ed847bdcb0df msgid "**Document Level**" msgstr "**문서 수준**" #: ../../page.rst:2353 19b869eaaf114813a8abeb080e8aadd8 msgid "**Page Level**" msgstr "**페이지 수준**" #: ../../page.rst:2355 e34587fd22b444f19d97e569757aced3 msgid ":meth:`Document.get_page_fonts`" msgstr ":meth:`Document.get_page_fonts`" #: ../../page.rst:2356 9d5b4df7acc4415ca81db0fa50cdbc3a msgid ":meth:`Document.get_page_images`" msgstr ":meth:`Document.get_page_images`" #: ../../page.rst:2357 643565d4b5fb4159a0c4f6cb6eae52f1 msgid ":meth:`Document.get_page_pixmap`" msgstr ":meth:`Document.get_page_pixmap`" #: ../../page.rst:2358 27b5577e8ff349ec8f0978b9cb964b62 msgid ":meth:`Document.get_page_text`" msgstr ":meth:`Document.get_page_text`" #: ../../page.rst:2359 d901c33d20334d828b2167e39d71168c msgid ":meth:`Document.search_page_for`" msgstr ":meth:`Document.search_page_for`" #: ../../page.rst:2364 6719d58820ca4cbfb5fc796c06e1e36c msgid "" "Most document methods (left column) exist for convenience reasons, and " "are just wrappers for: *Document[pno].*. So they **load and " "discard the page** on each execution." msgstr "" "대부분의 문서 메서드(왼쪽 열)는 편의를 위해 존재하며, *Document[pno].* 의 래퍼일 뿐입니다. 따라서 각 실행마다 **페이지를 로드하고 버립니다**." #: ../../page.rst:2366 5ce80e9cea8e4daea36d8f585ac861c3 msgid "" "However, the first two methods work differently. They only need a page's " "object definition statement - the page itself will **not** be loaded. So " "e.g. :meth:`Page.get_fonts` is a wrapper the other way round and defined " "as follows: `page.get_fonts` == " "`page.parent.get_page_fonts(page.number)`." msgstr "" "그러나 처음 두 메서드는 다르게 작동합니다. 페이지의 객체 정의 문장만 필요하며 - 페이지 자체는 **로드되지 않습니다**. 따라서 예를 들어 :meth:`Page.get_fonts` 는 반대 방향의 래퍼이며 다음과 같이 정의됩니다: `page.get_fonts` == `page.parent.get_page_fonts(page.number)`." #: ../../page.rst:2369 8622914e93ee422e8ed1fb18a52b3757 msgid "" "When calling the :ref:`Document` equivalent methods then the page number " "is sent through as a parameter, e.g.:" msgstr "" ":ref:`Document` 동등 메서드를 호출할 때 페이지 번호가 매개변수로 전달됩니다, 예:" #: ../../page.rst:2371 6841df7218244a1dbd5c84d575bf0c61 msgid "`Document.get_page_images(pno)` or `Document.get_page_text(pno)`" msgstr "`Document.get_page_images(pno)` 또는 `Document.get_page_text(pno)`" #: ../../page.rst:2375 9f0d6803a3b34da2a35934a9f4067f2f msgid "" "The page number parameter, ``pno``, is a 0-based integer `-∞ < pno < " "page_count`." msgstr "" "페이지 번호 매개변수 ``pno`` 는 0 기반 정수 `-∞ < pno < page_count` 입니다." #: ../../page.rst:2382 c7a27a60878d4c9681777a0657f5bfea msgid "Tables and Related Classes" msgstr "테이블 및 관련 클래스" #: ../../page.rst:2384 c3180e51a3bd4b778434ca0ae6c63d89 msgid "" "The `TableFinder` class is returned by :meth:`Page.find_tables` and has " "related classes as follows:" msgstr "" "`TableFinder` 클래스는 :meth:`Page.find_tables` 에 의해 반환되며 다음과 같은 관련 클래스가 있습니다:" #: ../../page.rst:2389 64a011721da24744a543ab64c5a17f12 msgid "" "An object always returned by :meth:`Page.find_tables`. Attributes of " "interest:" msgstr "" ":meth:`Page.find_tables` 에 의해 항상 반환되는 객체. 관심 있는 속성:" #: ../../page.rst:2393 d2d360b0c7714f6eb39099281199a836 msgid "" "A list of :class:`Table` objects, each of which represents a table found " "on the page. An empty list if no tables are found." msgstr "" ":class:`Table` 객체의 리스트로, 각각 페이지에서 찾은 테이블을 나타냅니다. 테이블을 찾지 못하면 빈 리스트입니다." #: ../../page.rst:2397 00907877ee1e4ab88a27a827ca45fd8d msgid "A reference to the :ref:`Page` object." msgstr ":ref:`Page` 객체에 대한 참조." #: ../../page.rst:2399 ../../page.rst:2411 4b46496341814f40addafebc3415c77d #: 6ccafe77babf49dda8f24e0fd508264d msgid ":ref:`Page`" msgstr ":ref:`Page`" #: ../../page.rst:2404 43201788a0d84d56b0b5c860766e84e2 msgid "An object representing a table found on the page." msgstr "페이지에서 찾은 테이블을 나타내는 객체." #: ../../page.rst:2409 e91dd9e61a4844e68986275924bd2cd4 msgid "A back-reference to the owning page." msgstr "소유 페이지에 대한 역참조." #: ../../page.rst:2415 820b3e94587549d5b34a3b7f1991677f msgid "An array of `Rect` objects for each cell in the table." msgstr "테이블의 각 셀에 대한 `Rect` 객체 배열." #: ../../page.rst:2417 ../../page.rst:2454 ../../page.rst:2461 #: ../../page.rst:2498 ../../page.rst:2504 5fc25f510ea64ee1a073674ebe19775f #: 72a07ac5bc354429ba5e23029d97a6b2 7a63d658f0414ce6a03dc5da7b6480e6 #: bd6ad1e8c71041faa53508d47736847a d1886569c90349efbb3e43f245bb097b msgid "list" msgstr "list" #: ../../page.rst:2422 56c6a33a1012473d92478e6bf2c37fc1 msgid "A `TableHeader` object." msgstr "`TableHeader` 객체." #: ../../page.rst:2424 4469b33c46164b4db72edb980ccb08a5 msgid "`TableHeader`" msgstr "`TableHeader`" #: ../../page.rst:2429 add249adfc084030b7eee6e9fb5a5a89 msgid "The bounding box of all cells of the table header." msgstr "테이블 헤더의 모든 셀의 경계 상자." #: ../../page.rst:2438 2981f68aea22477086cc06adb314548f msgid "Number of rows in the table." msgstr "테이블의 행 수." #: ../../page.rst:2445 0d4f1e4b0c1541b9b30b52975b603789 msgid "Number of columns in the table." msgstr "테이블의 열 수." #: ../../page.rst:2452 532d63f6689e48f08800ad2c8933c45c msgid "An array of `TableRow` objects for each row in the table." msgstr "테이블의 각 행에 대한 `TableRow` 객체 배열." #: ../../page.rst:2459 deb8a6d99ed24f249ad4d0d4fb8a73b4 msgid "Extracts table cell text data into a list." msgstr "테이블 셀 텍스트 데이터를 리스트로 추출합니다." #: ../../page.rst:2465 75472d11e66d46b78b281cabdde38c94 msgid "Extracts table data into Markdown text format." msgstr "테이블 데이터를 Markdown 텍스트 형식으로 추출합니다." #: ../../page.rst:2468 468354dc37774ae7aba42d9a80c27100 msgid "If ``True`` then markdown syntax is removed from cell content." msgstr "``True`` 이면 셀 콘텐츠에서 markdown 구문이 제거됩니다." #: ../../page.rst:2469 aaa9083f16584794b6e61a2d29bfc670 msgid "" "If ``True`` then cell content `None` is replaced by the values above " "(columns) or left (rows) in an effort to approximate row and columns " "spans." msgstr "" "``True`` 이면 셀 콘텐츠 `None` 이 행 및 열 스팬을 근사화하기 위해 위(열) 또는 왼쪽(행)의 값으로 대체됩니다." #: ../../page.rst:2472 7a34d01dee7e4826a33b05a0a8bca9cc msgid "string" msgstr "string" #: ../../page.rst:2477 7562b710618a431c97aaa09d4f4b34a6 msgid "" "Return a `pandas DataFrame `_ " "`DataFrame `_ " "version of the table." msgstr "" "테이블의 `pandas DataFrame `_ `DataFrame `_ 버전을 반환합니다." #: ../../page.rst:2479 231c710e2ccf4932a300678886594ca6 msgid "pandas DataFrame" msgstr "pandas DataFrame" #: ../../page.rst:2486 d3ce63902e7f477893ea546d16ae6490 msgid "Dedicated class for table headers." msgstr "테이블 헤더를 위한 전용 클래스." #: ../../page.rst:2490 84e64f2efb644e2b821f471755bc37da msgid "" "The bounding box of the union of cells belonging to the table header, " "given as a tuple (x0, y0, x1, y1). This rectangle contains all table " "header cells." msgstr "" "테이블 헤더에 속하는 셀의 합집합의 경계 상자로, 튜플 (x0, y0, x1, y1)로 제공됩니다. 이 사각형은 모든 테이블 헤더 셀을 포함합니다." #: ../../page.rst:2496 8f36b12f2fe14dbd8d044038a58b9af6 msgid "A list of tuples for each bbox of a column header." msgstr "각 열 헤더의 bbox에 대한 튜플 리스트." #: ../../page.rst:2502 9f497b636e214ba0ab62649bdbe7787f msgid "A list of strings with column header text." msgstr "열 헤더 텍스트가 있는 문자열 리스트." #: ../../page.rst:2508 ae8dc88588404f08b28f6531661b7c8e msgid "A boolean indicating whether the header is outside the table cells." msgstr "헤더가 테이블 셀 밖에 있는지 여부를 나타내는 불리언." #: ../../page.rst:2510 d3b5a1c6519e465e89e91926ae0aea3c msgid "`bool`" msgstr "`bool`" #: ../../page.rst:2515 45925d07fc014a9a99de73f5c477ac73 msgid "Dedicated class for table rows." msgstr "테이블 행을 위한 전용 클래스." #: ../../page.rst:2522 4f1b3b275c9c4913ab0f3b3cfbbec93b msgid "Footnotes" msgstr "각주" #: ../../page.rst:2523 35b460330e4249f49081cee02ccc6687 msgid "" "If your existing code already uses the installed base name as a font " "reference (as it was supported by PyMuPDF versions earlier than 1.14), " "this will continue to work." msgstr "" "기존 코드가 이미 설치된 기본 이름을 폰트 참조로 사용하는 경우(1.14 이전 |PyMuPDF| 버전에서 지원되었던 것처럼), 이것은 계속 작동합니다." #: ../../page.rst:2525 1f07318c687247dabdd707f1eaccb7bf msgid "" "Not all PDF reader software (including internet browsers and office " "software) display all of these fonts. And if they do, the difference " "between the **serifed** and the **non-serifed** version may hardly be " "noticeable. But serifed and non-serifed versions lead to different " "installed base fonts, thus providing an option to be displayable with " "your specific PDF viewer." msgstr "" "모든 PDF 리더 소프트웨어(인터넷 브라우저 및 오피스 소프트웨어 포함)가 이러한 모든 폰트를 표시하는 것은 아닙니다. 표시하더라도 **세리프** 및 **비세리프** 버전 간의 차이는 거의 눈에 띄지 않을 수 있습니다. 하지만 세리프 및 비세리프 버전은 다른 설치된 기본 폰트로 이어지므로 특정 PDF 뷰어에서 표시 가능한 옵션을 제공합니다." #: ../../page.rst:2527 d9d100e5a3b64091a183af6296efa37c msgid "" "Not all PDF readers display these fonts at all. Some others do, but use a" " wrong character spacing, etc." msgstr "" "모든 PDF 리더가 이러한 폰트를 표시하는 것은 아닙니다. 일부는 표시하지만 잘못된 문자 간격 등을 사용합니다." #: ../../page.rst:2529 35028b7ef49143b4816821764f1b95cf msgid "" "You are generally free to choose any of the :ref:`mupdficons` you " "consider adequate." msgstr "" "일반적으로 적절하다고 생각하는 :ref:`mupdficons` 중 하나를 자유롭게 선택할 수 있습니다." #: ../../page.rst:2531 5b91f7ee061349e9ab8627329a680560 msgid "" "The previous algorithm caused images to be **shrunk** to this " "intersection. Now the image can be anywhere on :attr:`Page.mediabox`, " "potentially being invisible or only partially visible if the cropbox " "(representing the visible page part) is smaller." msgstr "" "이전 알고리즘은 이미지를 이 교차점으로 **축소** 시켰습니다. 이제 이미지는 :attr:`Page.mediabox` 의 어디에나 있을 수 있으며, cropbox(보이는 페이지 부분을 나타냄)가 더 작으면 보이지 않거나 부분적으로만 보일 수 있습니다." #: ../../page.rst:2533 bb430f8f65514d70b8096713c386f20f msgid "" "If you need to also see annotations or fields in the target page, you can" " convert the source PDF using :meth:`Document.bake`. The underlying MuPDF" " function of that method will convert these objects to normal page " "content. Then use :meth:`Page.show_pdf_page` with the converted PDF page." msgstr "" "대상 페이지에서 주석이나 필드도 보려면 :meth:`Document.bake` 를 사용하여 소스 PDF를 변환할 수 있습니다. 해당 메서드의 기본 MuPDF 함수는 이러한 객체를 일반 페이지 콘텐츠로 변환합니다. 그런 다음 변환된 PDF 페이지와 함께 :meth:`Page.show_pdf_page` 를 사용하세요." #: ../../page.rst:2535 77c93b6fd9f24046b632e932a9401d83 msgid "" "In PDF, an area enclosed by some lines or curves can have a property " "called \"orientation\". This is significant for switching on or off the " "fill color of that area when there exist multiple area overlaps - see " "discussion in method :meth:`Shape.finish` using the \"non-zero winding " "number\" rule. While orientation of curves, quads, triangles and other " "shapes enclosed by lines always was detectable, this has been impossible " "for \"re\" (rectangle) items in the past. Adding the orientation " "parameter now delivers the missing information." msgstr "" "PDF에서 일부 선이나 곡선으로 둘러싸인 영역은 \"orientation\"(방향)이라는 속성을 가질 수 있습니다. 이것은 여러 영역이 겹칠 때 해당 영역의 채우기 색상을 켜거나 끄는 데 중요합니다 - \"non-zero winding number\" 규칙을 사용하는 :meth:`Shape.finish` 메서드의 논의를 참조하세요. 선으로 둘러싸인 곡선, 사각형, 삼각형 및 기타 모양의 방향은 항상 감지 가능했지만, 과거에는 \"re\"(사각형) 항목에 대해 이것이 불가능했습니다. orientation 매개변수를 추가하면 이제 누락된 정보를 제공합니다." #: ../../page.rst:2537 5b3e04359c58461c9c342889056d8ac3 msgid "" "Hyphenation detection simply means that if the last character of a line " "is \"-\", it will be assumed to be a continuation character. That " "character will not be found by text searching with its default flag " "setting. Please take note, that a MuPDF *line* may not always be what you" " expect: words separated by overly large gaps (e.g. caused by text " "justification) may constitute separate MuPDF lines. If then any of these " "words ends with a hyphen, it will only be found by text searching if " "hyphenation is switched off." msgstr "" "하이픈 감지는 단순히 줄의 마지막 문자가 \"-\"이면 연속 문자로 간주된다는 의미입니다. 해당 문자는 기본 플래그 설정으로 텍스트 검색에서 찾을 수 없습니다. MuPDF *line* 이 항상 예상하는 것과 같지 않을 수 있습니다: 과도하게 큰 간격(예: 텍스트 정당화로 인한)으로 구분된 단어는 별도의 MuPDF 줄을 구성할 수 있습니다. 그러면 이러한 단어 중 하나가 하이픈으로 끝나면 하이픈이 꺼져 있을 때만 텍스트 검색에서 찾을 수 있습니다." #: ../../page.rst:2539 d8f8e96dd085414a812fda2806633c43 msgid "" "Objects inside the source page, like images, text or drawings, are never " "aware of whether their owning page now is under OC control inside the " "target PDF. If source page objects are OC-controlled in the source PDF, " "then this will not be retained on the target: they will become " "unconditionally visible." msgstr "" "소스 페이지 내의 객체(이미지, 텍스트 또는 그림 등)는 소유 페이지가 대상 PDF 내에서 OC 제어 하에 있는지 여부를 절대 인식하지 않습니다. 소스 페이지 객체가 소스 PDF에서 OC 제어되는 경우 이것은 대상에서 유지되지 않습니다: 무조건 표시됩니다." #: ../../page.rst:2541 ce46471c609a4a6182a93a337f577978 msgid "" "This value is always 96, the default of the PDF interpreter. It **does " "not reflect** the resolution of the image itself. If you need the image's" " resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` " "attributes of the :ref:`Pixmap` created from the image binary." msgstr "" "이 값은 항상 96이며 PDF 인터프리터의 기본값입니다. 이것은 **이미지 자체의 해상도를 반영하지 않습니다**. 이미지의 해상도가 필요하면 이미지 바이너리에서 생성된 :ref:`Pixmap` 의 :meth:`Pixmap.xres` 및 :meth:`Pixmap.yres` 속성을 사용하세요." #: ../../footer.rst:57 48ae480fd42d45a79c92e95ead866afc msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/pixmap.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 77cdad9d379a4a459fb8f61a5126752b msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 32cc68ce63c240bdb7a2fdfe4d927af7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 db64d0baaca745e7910c08e63ef36441 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../pixmap.rst:7 e0494509a30b4c1991cc5e57de63e15b msgid "Pixmap" msgstr "Pixmap" #: ../../pixmap.rst:9 32dd6915408a408ea1d9db1812927e46 msgid "" "Pixmaps (\"pixel maps\") are objects at the heart of MuPDF's rendering " "capabilities. They represent plane rectangular sets of pixels. Each pixel" " is described by a number of bytes (\"components\") defining its color, " "plus an optional alpha byte defining its transparency." msgstr "픽스맵(\"pixel maps\")은 MuPDF의 렌더링 기능의 핵심 객체입니다. 평면 사각형 픽셀 집합을 나타냅니다. 각 픽셀은 색상을 정의하는 여러 바이트(\"components\")와 투명도를 정의하는 선택적 알파 바이트로 설명됩니다." #: ../../pixmap.rst:11 0ae7623584d34b0793a6b1689e2e9ff9 msgid "" "In PyMuPDF, there exist several ways to create a pixmap. Except the first" " one, all of them are available as overloaded constructors. A pixmap can " "be created ..." msgstr "PyMuPDF에서는 픽스맵을 생성하는 여러 방법이 있습니다. 첫 번째를 제외하고 모두 오버로드된 생성자로 사용할 수 있습니다. 픽스맵은 다음에서 생성할 수 있습니다..." #: ../../pixmap.rst:13 73ba045692a74b84a13ce27f369588ef msgid "from a document page (method :meth:`Page.get_pixmap`)" msgstr "문서 페이지에서 (메서드 :meth:`Page.get_pixmap`)" #: ../../pixmap.rst:14 d9db8727d6f34c5ea67a95212b48a901 msgid "empty, based on :ref:`Colorspace` and :ref:`IRect` information" msgstr ":ref:`Colorspace` 및 :ref:`IRect` 정보를 기반으로 빈 픽스맵" #: ../../pixmap.rst:15 3bd37a5d119449b79b2df8e6183899b2 msgid "from a file" msgstr "파일에서" #: ../../pixmap.rst:16 6c2ae5d2cf9e4e9c8a85876940ac2c65 msgid "from an in-memory image" msgstr "메모리 내 이미지에서" #: ../../pixmap.rst:17 985854117e77421ab5c08305ad9a7ebc msgid "from a memory area of plain pixels" msgstr "일반 픽셀의 메모리 영역에서" #: ../../pixmap.rst:18 51817c0b224a4d79becc251812e52d59 msgid "from an image inside a PDF document" msgstr "PDF 문서 내의 이미지에서" #: ../../pixmap.rst:19 c50a8dabd5de4315af9f49bd6f4e3300 msgid "as a copy of another pixmap" msgstr "다른 픽스맵의 복사본으로" #: ../../pixmap.rst:21 a40603d11eae465f98c51d914e3f60f0 msgid "" "A number of image formats is supported as input for points 3. and 4. " "above. See section :ref:`ImageFiles`." msgstr "위의 3번과 4번 항목에 대한 입력으로 여러 이미지 형식이 지원됩니다. :ref:`ImageFiles` 섹션을 참조하세요." #: ../../pixmap.rst:23 3bdce298316f4c59aea2dcf926ba360d msgid "" "Have a look at the :ref:`FAQ` section to see some pixmap usage \"at " "work\"." msgstr ":ref:`FAQ` 섹션을 확인하여 픽스맵 사용 예제를 살펴보세요." #: ../../pixmap.rst:26 c77d9f0a0ac441569275429f77da5352 msgid "**Method / Attribute**" msgstr "**Method / Attribute**" #: ../../pixmap.rst:26 0c5aa62f906e4af38c4f3f15dbd58acb msgid "**Short Description**" msgstr "**Short Description**" #: ../../pixmap.rst:28 2202b52b548143ffb14aef4ce3088e4e msgid ":meth:`Pixmap.clear_with`" msgstr "" #: ../../pixmap.rst:28 f8c6fd586d294e3194f9966984db1cd7 msgid "clear parts of the pixmap" msgstr "픽스맵의 일부 지우기" #: ../../pixmap.rst:29 74887257fa9a4ce4bccdc2c054561ab8 msgid ":meth:`Pixmap.color_count`" msgstr "" #: ../../pixmap.rst:29 266d94deb7124050adc51b2d0925c285 msgid "determine used colors" msgstr "사용된 색상 확인" #: ../../pixmap.rst:30 6fa71e0e57754c778d2a793a2d4b5e0c msgid ":meth:`Pixmap.color_topusage`" msgstr "" #: ../../pixmap.rst:30 40a15ae449a04a5fa2c777c1ac0a6175 msgid "determine share of most used color" msgstr "가장 많이 사용된 색상의 비율 확인" #: ../../pixmap.rst:31 b915ce033980496eb00292ada4fbcca5 msgid ":meth:`Pixmap.copy`" msgstr "" #: ../../pixmap.rst:31 8e57cd2829fa414abc482e80c6d4c4d9 msgid "copy parts of another pixmap" msgstr "다른 픽스맵의 일부 복사" #: ../../pixmap.rst:32 112981a34c4348f8ad862d81cdc02514 msgid ":meth:`Pixmap.gamma_with`" msgstr "" #: ../../pixmap.rst:32 f42a9b37c4ac4000a006188d993c87e5 msgid "apply a gamma factor to the pixmap" msgstr "픽스맵에 감마 계수 적용" #: ../../pixmap.rst:33 01c950df9e2145aa8d39d7760c67ad87 msgid ":meth:`Pixmap.invert_irect`" msgstr "" #: ../../pixmap.rst:33 8fd44b50652147ff824e5fc414ff6a30 msgid "invert the pixels of a given area" msgstr "주어진 영역의 픽셀 반전" #: ../../pixmap.rst:34 516fe80e3c4a459a81a150dc6a462f8e msgid ":meth:`Pixmap.pdfocr_save`" msgstr "" #: ../../pixmap.rst:34 ../../pixmap.rst:35 67e410a8f8c842c1944b038c5708de2d #: f38b40a1d99c4c509644c872d19b87e2 msgid "save the pixmap as an OCRed 1-page PDF" msgstr "픽스맵을 OCR된 1페이지 PDF로 저장" #: ../../pixmap.rst:35 be86eecb9ae84058896ab1db4a2fcab1 msgid ":meth:`Pixmap.pdfocr_tobytes`" msgstr "" #: ../../pixmap.rst:36 b0881e3fa8064b569e1476c50325b3d7 msgid ":meth:`Pixmap.pil_image`" msgstr "" #: ../../pixmap.rst:36 6075a73ecdcb46979d4b836f39403d5f msgid "create a Pillow Image" msgstr "Pillow 이미지 생성" #: ../../pixmap.rst:37 c71cca896c4e47509c4fa0e362fa044c msgid ":meth:`Pixmap.pil_save`" msgstr "" #: ../../pixmap.rst:37 4be536342cb047aeb0a6b64adbba1e9a msgid "save as a Pillow Image" msgstr "Pillow 이미지로 저장" #: ../../pixmap.rst:38 52b8400d5cce434b87e23399f61d2117 msgid ":meth:`Pixmap.pil_tobytes`" msgstr "" #: ../../pixmap.rst:38 bafc4631127f4561936ab5d1e6403a2d msgid "write to `bytes` as a Pillow Image" msgstr "Pillow 이미지로 `bytes` 에 쓰기" #: ../../pixmap.rst:39 4002db687ffc4feabe3a41f2274b7804 msgid ":meth:`Pixmap.pixel`" msgstr "" #: ../../pixmap.rst:39 efb78dfb56524049a7580e3a15723114 msgid "return the value of a pixel" msgstr "픽셀 값 반환" #: ../../pixmap.rst:40 e0ffa2a456944476bb6984b064566f95 msgid ":meth:`Pixmap.save`" msgstr "" #: ../../pixmap.rst:40 7f4131a6b70d41cd802f09e3f4f6f11f msgid "save the pixmap in a variety of formats" msgstr "다양한 형식으로 픽스맵 저장" #: ../../pixmap.rst:41 23956dccd6e94052aef51929b1c393dc msgid ":meth:`Pixmap.set_alpha`" msgstr "" #: ../../pixmap.rst:41 3979119c35f341c694e03dd5db7a0115 msgid "set alpha values" msgstr "알파 값 설정" #: ../../pixmap.rst:42 80aa084bf73c4f61abbf2f808d42bdcd msgid ":meth:`Pixmap.set_dpi`" msgstr "" #: ../../pixmap.rst:42 881510d8c71545b59d91fb5dac173605 msgid "set the image resolution" msgstr "이미지 해상도 설정" #: ../../pixmap.rst:43 af00886d005e4a1890d7b7789b93e7e7 msgid ":meth:`Pixmap.set_origin`" msgstr "" #: ../../pixmap.rst:43 7e6045d9838046cea1cd1fcb38a15dab msgid "set pixmap x,y values" msgstr "픽스맵 x, y 값 설정" #: ../../pixmap.rst:44 cb25eecee8af4917ab427d3cf303152f msgid ":meth:`Pixmap.set_pixel`" msgstr "" #: ../../pixmap.rst:44 23d1909be60a4b269aaec2547ae2aa05 msgid "set color and alpha of a pixel" msgstr "픽셀의 색상 및 알파 설정" #: ../../pixmap.rst:45 72b4d710dc894939936c377380bbc22e msgid ":meth:`Pixmap.set_rect`" msgstr "" #: ../../pixmap.rst:45 0f7af78460a4450da9d9108517b4d4c4 msgid "set color and alpha of all pixels in a rectangle" msgstr "사각형 내 모든 픽셀의 색상 및 알파 설정" #: ../../pixmap.rst:46 b791b993ad61409eaef1d0b360847ffc msgid ":meth:`Pixmap.shrink`" msgstr "" #: ../../pixmap.rst:46 38e21b2c7aa8493e8bb7266e1e835f69 msgid "reduce size keeping proportions" msgstr "비율을 유지하면서 크기 축소" #: ../../pixmap.rst:47 be56d7fc15e24cf2826c82badd69df56 msgid ":meth:`Pixmap.tint_with`" msgstr "" #: ../../pixmap.rst:47 d5a1e740218c41ceb31d912cae43599f msgid "tint the pixmap" msgstr "픽스맵에 틴트 적용" #: ../../pixmap.rst:48 408bd07e5e004c53845a34ccb73684f6 msgid ":meth:`Pixmap.tobytes`" msgstr "" #: ../../pixmap.rst:48 dbfd2cd88a2e40689877d688108593b5 msgid "return a memory area in a variety of formats" msgstr "다양한 형식으로 메모리 영역 반환" #: ../../pixmap.rst:49 73ad7e8e412146939a933bc554653bd9 msgid ":meth:`Pixmap.warp`" msgstr "" #: ../../pixmap.rst:49 27dcdd34ccd6434c8be2f3d0cab9f361 msgid "return a pixmap made from a quad inside" msgstr "내부의 quad로 만든 픽스맵 반환" #: ../../pixmap.rst:50 85defbb4523445e9bfc92785c42fcb0b msgid ":attr:`Pixmap.alpha`" msgstr "" #: ../../pixmap.rst:50 f9f7e74d1a854ce584726e3236d915a4 msgid "transparency indicator" msgstr "투명도 표시기" #: ../../pixmap.rst:51 fbf1760092864dcf8f5566ac85074c05 msgid ":attr:`Pixmap.colorspace`" msgstr "" #: ../../pixmap.rst:51 48b501a974724e6cadfe58ebbfebeb9a msgid "pixmap's :ref:`Colorspace`" msgstr "픽스맵의 :ref:`Colorspace`" #: ../../pixmap.rst:52 b766c11c9d60491bb1cd9e4c8cfd9751 msgid ":attr:`Pixmap.digest`" msgstr "" #: ../../pixmap.rst:52 3d7b532618f3451896efe2d64d4ffdfe msgid "MD5 hashcode of the pixmap" msgstr "픽스맵의 MD5 해시코드" #: ../../pixmap.rst:53 76675540ad27482bada64b6a598d25f9 msgid ":attr:`Pixmap.height`" msgstr "" #: ../../pixmap.rst:53 3c22531079e34fa79dddc4e586d958e6 msgid "pixmap height" msgstr "픽스맵 높이" #: ../../pixmap.rst:54 9182d024c67b490b9fe7855b4f5715d0 msgid ":attr:`Pixmap.interpolate`" msgstr "" #: ../../pixmap.rst:54 3688b5e0286840669d320a95bc5a17fb msgid "interpolation method indicator" msgstr "보간 방법 표시기" #: ../../pixmap.rst:55 b7b0a90b1ba846e89b22db0ed4553281 msgid ":attr:`Pixmap.is_monochrome`" msgstr "" #: ../../pixmap.rst:55 df352c76b67546089f124cbd0e5babb1 msgid "check if only black and white occur" msgstr "흑백만 있는지 확인" #: ../../pixmap.rst:56 a17ad0a90a7d413c9fb8b1aa83257598 msgid ":attr:`Pixmap.is_unicolor`" msgstr "" #: ../../pixmap.rst:56 81dfed8a598641f6ae936549b0e7f7ba msgid "check if only one color occurs" msgstr "단일 색상만 있는지 확인" #: ../../pixmap.rst:57 abd7ff4e70754c9daef32d9525250608 msgid ":attr:`Pixmap.irect`" msgstr "" #: ../../pixmap.rst:57 2791b580e848470a814a376d6e220255 msgid ":ref:`IRect` of the pixmap" msgstr "픽스맵의 :ref:`IRect`" #: ../../pixmap.rst:58 2fec6f3a895d4409b0e482a40f200f22 msgid ":attr:`Pixmap.n`" msgstr "" #: ../../pixmap.rst:58 c7b79f65d4494cdb897cc22abe8eff21 msgid "bytes per pixel" msgstr "픽셀당 바이트" #: ../../pixmap.rst:59 743bc8e881d44773b5fcf7beffc6a3fa msgid ":attr:`Pixmap.samples_mv`" msgstr "" #: ../../pixmap.rst:59 4179ce00d1e746b295e577083af074b0 msgid "`memoryview` of pixel area" msgstr "픽셀 영역의 `memoryview`" #: ../../pixmap.rst:60 c5ff63d0faaa4137832a944521ce8069 msgid ":attr:`Pixmap.samples_ptr`" msgstr "" #: ../../pixmap.rst:60 8116e2e6a5fe470082d7fbdca4673935 msgid "Python pointer to pixel area" msgstr "픽셀 영역에 대한 Python 포인터" #: ../../pixmap.rst:61 2abc33dc84a348c6ad9b8da90c57e531 msgid ":attr:`Pixmap.samples`" msgstr "" #: ../../pixmap.rst:61 060cb94948d84088a5cf7c6d4319fea3 msgid "`bytes` copy of pixel area" msgstr "픽셀 영역의 `bytes` 복사본" #: ../../pixmap.rst:62 d41ed2ab508249d0ae96e3145e92258b msgid ":attr:`Pixmap.size`" msgstr "" #: ../../pixmap.rst:62 cfe014376f9745ea9c2ce0e7a11bb369 msgid "pixmap's total length" msgstr "픽스맵의 전체 길이" #: ../../pixmap.rst:63 34fea4631d014515b7406f2f5bb813bc msgid ":attr:`Pixmap.stride`" msgstr "" #: ../../pixmap.rst:63 5a29f36af34340aea9cba617eed85cc6 msgid "size of one image row" msgstr "이미지 한 행의 크기" #: ../../pixmap.rst:64 62ed9c389676438299a427713f0f7b08 msgid ":attr:`Pixmap.width`" msgstr "" #: ../../pixmap.rst:64 70e7618e0783483ea97302b042784152 msgid "pixmap width" msgstr "픽스맵 너비" #: ../../pixmap.rst:65 e62961e6786e48c796a2e5a23a76654f msgid ":attr:`Pixmap.x`" msgstr "" #: ../../pixmap.rst:65 4e8faa2fe6154453bf50951bfbcbfa0e msgid "X-coordinate of top-left corner" msgstr "왼쪽 위 모서리의 X 좌표" #: ../../pixmap.rst:66 d69ccf0ae1844b88aaff3eb7fbfa1973 msgid ":attr:`Pixmap.xres`" msgstr "" #: ../../pixmap.rst:66 a1ecbc77214845fea2e4c6cee89a8ce8 msgid "resolution in X-direction" msgstr "X 방향 해상도" #: ../../pixmap.rst:67 83ca1188acde43af9c9f6c742f8c9fcb msgid ":attr:`Pixmap.y`" msgstr "" #: ../../pixmap.rst:67 b0432d623ef4473aa3515de8b215d9f5 msgid "Y-coordinate of top-left corner" msgstr "왼쪽 위 모서리의 Y 좌표" #: ../../pixmap.rst:68 b704d755356e4e53903e4306cb1850d6 msgid ":attr:`Pixmap.yres`" msgstr "" #: ../../pixmap.rst:68 857aeb5083a44b1795d1ede13f95021f msgid "resolution in Y-direction" msgstr "Y 방향 해상도" #: ../../pixmap.rst:71 a006e37a45ad4ed88da3603714dc9820 msgid "**Class API**" msgstr "**Class API**" #: ../../pixmap.rst:77 046bff7f68fe47dc89b42ec79b63be49 msgid "" "**New empty pixmap:** Create an empty pixmap of size and origin given by " "the rectangle. So, *irect.top_left* designates the top left corner of the" " pixmap, and its width and height are *irect.width* resp. *irect.height*." " Note that the image area is **not initialized** and will contain crap " "data -- use eg. :meth:`clear_with` or :meth:`set_rect` to be sure." msgstr "**새 빈 픽스맵:** 사각형으로 지정된 크기와 원점으로 빈 픽스맵을 생성합니다. 따라서 *irect.top_left* 는 픽스맵의 왼쪽 위 모서리를 지정하고, 너비와 높이는 각각 *irect.width* 및 *irect.height* 입니다. 이미지 영역은 **초기화되지 않으며** 쓰레기 데이터를 포함합니다 -- 예를 들어 :meth:`clear_with` 또는 :meth:`set_rect` 를 사용하여 확실히 하세요." #: ../../pixmap.rst 02b0fea3d9c34817aad000ad9f071590 #: 054aba92b788492e988045fb104e4481 0eb0df83e45a406cb560af5072cdff86 #: 2d9ab2f5c1024f7085600fc7ec9dc603 42fca49eb0844237a0b14c72c95e7dbc #: 4c84fc0dcb054b659ed6e2dae1b27605 57542313cdbd47cc89f43d9329495cb5 #: 610dfac6df044219bea31b4eb7ef6b47 63f20c0df7eb4be8be807f287c781d58 #: 67a50e42c1294501bb59b8b035850481 687444f1e3dc45509b4ec2a7192c0a48 #: 73fe0913c7364c31916311fc0cffc16e 7e25b63146fa45858f1ff6b966a16913 #: 8b3e2416c26c445bb9979be602f6adf5 95824bfb86ff41de835e47b77393048f #: a5c5caaf10934649be3b74635eb16787 af618a04af8e40efa6512d296a27fb9b #: bdfbcea144bd4cfb93f787f52dfadf48 c7f77794bd054561aa08e0b18497e5bd #: d044792ccaea48328805a0a6efd678c9 d625b8ee73b34a459873edc513b40002 #: d81abb686bb542518846ad32bd035b5e dd1276958278455fb3ad0d1ad3b08045 #: dd4e9e5837dc4c1eb17ec63c8681b4d4 e60d8f4e03c24b918ad9bdf22e21adb0 #: f1bff3e4b66c4afca6ae66a014ac0fc1 f2e0f5d755134588846f75c89c28b5af #: f8a2e37bd2ef4ca79bf827a1a3fe8e70 msgid "Parameters" msgstr "Parameters" #: ../../pixmap.rst:79 56321802a9014c348fa2d20d4294c9f2 msgid "colorspace." msgstr "색상 공간." #: ../../pixmap.rst:82 3753a76b227f496eb369ca2d40057f0c msgid "The pixmap's position and dimension." msgstr "픽스맵의 위치 및 크기." #: ../../pixmap.rst:84 0f1256f4866c4a888d73cefe035cfb17 msgid "" "Specifies whether transparency bytes should be included. Default is " "``False``." msgstr "투명도 바이트를 포함할지 여부를 지정합니다. 기본값은 ``False`` 입니다." #: ../../pixmap.rst:88 b9326c334f6345fdaf185501bfa27892 msgid "" "**Copy and set colorspace:** Copy *source* pixmap converting colorspace. " "Any colorspace combination is possible, but source colorspace must not be" " ``None``." msgstr "**복사 및 색상 공간 설정:** 색상 공간을 변환하여 *source* 픽스맵을 복사합니다. 모든 색상 공간 조합이 가능하지만 소스 색상 공간은 ``None`` 이 아니어야 합니다." #: ../../pixmap.rst:90 97014f607fba4a5cb553297120c90034 msgid "" "desired **target** colorspace. This **may also be** ``None``. In this " "case, a \"masking\" pixmap is created: its :attr:`Pixmap.samples` will " "consist of the source's alpha bytes only." msgstr "원하는 **대상** 색상 공간. 이것은 ``None`` 일 수도 있습니다. 이 경우 \"마스킹\" 픽스맵이 생성됩니다: :attr:`Pixmap.samples` 는 소스의 알파 바이트만으로 구성됩니다." #: ../../pixmap.rst:93 ../../pixmap.rst:112 36ef86e1d48d4c5a9dd2bf95b2fd7b14 #: 52423174b9b746d2840bdc738fa82069 msgid "the source pixmap." msgstr "소스 픽스맵." #: ../../pixmap.rst:98 1df405a79ae244d1a01b677a84951540 msgid "New in v1.18.18" msgstr "v1.18.18에서 새로 추가됨" #: ../../pixmap.rst:100 dac52c1c940a488587523e971b8678bb msgid "" "**Copy and add image mask:** Copy *source* pixmap, add an alpha channel " "with transparency data from a mask pixmap." msgstr "**복사 및 이미지 마스크 추가:** *source* 픽스맵을 복사하고 마스크 픽스맵의 투명도 데이터로 알파 채널을 추가합니다." #: ../../pixmap.rst:102 760c74ba53044cbcbdf31aee15f90bca msgid "pixmap without alpha channel." msgstr "알파 채널이 없는 픽스맵." #: ../../pixmap.rst:105 46e5c3640fcf48d382edee1c823984e6 msgid "a mask pixmap. Must be a graysale pixmap." msgstr "마스크 픽스맵. 그레이스케일 픽스맵이어야 합니다." #: ../../pixmap.rst:110 d9ec3e84c0ea4239b426990e4164290e msgid "" "**Copy and scale:** Copy *source* pixmap, scaling new width and height " "values -- the image will appear stretched or shrunk accordingly. Supports" " partial copying. The source colorspace may be ``None``." msgstr "**복사 및 크기 조정:** *source* 픽스맵을 복사하고 새로운 너비와 높이 값을 조정합니다 -- 이미지는 그에 따라 늘어나거나 줄어듭니다. 부분 복사를 지원합니다. 소스 색상 공간은 ``None`` 일 수 있습니다." #: ../../pixmap.rst:115 682ea20bf52b4efe901eaeac97e98829 msgid "desired target width." msgstr "원하는 대상 너비." #: ../../pixmap.rst:117 3bf8da6692aa4465bad88ed923353c01 msgid "desired target height." msgstr "원하는 대상 높이." #: ../../pixmap.rst:119 7aa6286551464fc79c589f402e5f4064 msgid "restrict the resulting pixmap to this region of the **scaled** pixmap." msgstr "결과 픽스맵을 **크기 조정된** 픽스맵의 이 영역으로 제한합니다." #: ../../pixmap.rst:121 3be7525712a64bad8e5cc168ff57efeb msgid "" "If width or height do not *represent* integers (i.e. `value.is_integer() " "!= True`), then the resulting pixmap **will have an alpha channel**." msgstr "너비 또는 높이가 정수를 *나타내지* 않으면(즉, `value.is_integer() != True`), 결과 픽스맵은 **알파 채널을 가집니다**." #: ../../pixmap.rst:125 fcd3877dc9924a5098cb10a1fec25153 msgid "" "**Copy and add or drop alpha:** Copy *source* and add or drop its alpha " "channel. Identical copy if *alpha* equals *source.alpha*. If an alpha " "channel is added, its values will be set to 255." msgstr "**복사 및 알파 추가 또는 제거:** *source* 를 복사하고 알파 채널을 추가하거나 제거합니다. *alpha* 가 *source.alpha* 와 같으면 동일한 복사본입니다. 알파 채널이 추가되면 값은 255로 설정됩니다." #: ../../pixmap.rst:127 ../../pixmap.rst:305 29341e581eda460c9963b056957f0057 #: 6755e67f1ebd4c6397a96a8387727fc0 msgid "source pixmap." msgstr "소스 픽스맵." #: ../../pixmap.rst:130 c616e3541c6f481680da4d95d038b5f5 msgid "" "whether the target will have an alpha channel, default and mandatory if " "source colorspace is ``None``." msgstr "대상이 알파 채널을 가질지 여부, 소스 색상 공간이 ``None`` 이면 기본값이며 필수입니다." #: ../../pixmap.rst:132 df4cef61a1c149a39965a6f332bf9f2c msgid "" "A typical use includes separation of color and transparency bytes in " "separate pixmaps. Some applications require this like e.g. " "*wx.Bitmap.FromBufferAndAlpha()* of *wxPython*:" msgstr "일반적인 사용에는 별도의 픽스맵에서 색상 및 투명도 바이트를 분리하는 것이 포함됩니다. 일부 애플리케이션은 예를 들어 *wxPython* 의 *wx.Bitmap.FromBufferAndAlpha()* 와 같이 이를 요구합니다:" #: ../../pixmap.rst:142 154d69621fb94872a7ad34eae19ef7aa msgid "" "**From a file:** Create a pixmap from *filename*. All properties are " "inferred from the input. The origin of the resulting pixmap is *(0, 0)*." msgstr "**파일에서:** *filename* 에서 픽스맵을 생성합니다. 모든 속성은 입력에서 추론됩니다. 결과 픽스맵의 원점은 *(0, 0)* 입니다." #: ../../pixmap.rst:144 aedb335cf31242c6807afec841343b05 msgid "Path of the image file." msgstr "이미지 파일의 경로." #: ../../pixmap.rst:148 e21d860e62cb466b8dcd5c58ecd8816a msgid "" "**From memory:** Create a pixmap from a memory area. All properties are " "inferred from the input. The origin of the resulting pixmap is *(0, 0)*." msgstr "**메모리에서:** 메모리 영역에서 픽스맵을 생성합니다. 모든 속성은 입력에서 추론됩니다. 결과 픽스맵의 원점은 *(0, 0)* 입니다." #: ../../pixmap.rst:150 74221d3aec5f41afae36e2b37ac8dfc7 msgid "" "Data containing a complete, valid image. Could have been created by e.g. " "*stream = bytearray(open('image.file', 'rb').read())*. Type *bytes* is " "supported in **Python 3 only**, because *bytes == str* in Python 2 and " "the method will interpret the stream as a filename. *Changed in version " "1.14.13:* *io.BytesIO* is now also supported." msgstr "" #: ../../pixmap.rst:150 e9ed395c0d8c4b56a458e072bbd347e0 msgid "" "Data containing a complete, valid image. Could have been created by e.g. " "*stream = bytearray(open('image.file', 'rb').read())*. Type *bytes* is " "supported in **Python 3 only**, because *bytes == str* in Python 2 and " "the method will interpret the stream as a filename." msgstr "완전하고 유효한 이미지를 포함하는 데이터. 예를 들어 *stream = bytearray(open('image.file', 'rb').read())* 로 생성되었을 수 있습니다. *bytes* 타입은 **Python 3에서만** 지원됩니다. Python 2에서는 *bytes == str* 이므로 메서드가 스트림을 파일 이름으로 해석합니다." #: ../../pixmap.rst:152 a162db2d5e5f46a092952a708f6e5469 msgid "*Changed in version 1.14.13:* *io.BytesIO* is now also supported." msgstr "*버전 1.14.13에서 변경됨:* 이제 *io.BytesIO* 도 지원됩니다." #: ../../pixmap.rst:157 016950d3c686415a993d228b20deed87 msgid "" "**From plain pixels:** Create a pixmap from *samples*. Each pixel must be" " represented by a number of bytes as controlled by the *colorspace* and " "*alpha* parameters. The origin of the resulting pixmap is *(0, 0)*. This " "method is useful when raw image data are provided by some other program " "-- see :ref:`FAQ`." msgstr "**일반 픽셀에서:** *samples* 에서 픽스맵을 생성합니다. 각 픽셀은 *colorspace* 및 *alpha* 매개변수에 의해 제어되는 여러 바이트로 표현되어야 합니다. 결과 픽스맵의 원점은 *(0, 0)* 입니다. 이 메서드는 다른 프로그램에서 원시 이미지 데이터가 제공될 때 유용합니다 -- :ref:`FAQ` 를 참조하세요." #: ../../pixmap.rst:159 cda1965dbe524b2f958354d3bf86203d msgid "Colorspace of image." msgstr "이미지의 색상 공간." #: ../../pixmap.rst:162 e4ca43e6639b433195a95bc4b9cff17c msgid "image width" msgstr "이미지 너비" #: ../../pixmap.rst:164 e6bd73524bf443928467e7d153097052 msgid "image height" msgstr "이미지 높이" #: ../../pixmap.rst:166 bc04c5ee0a2f4c219321973a46ca1fec msgid "" "an area containing all pixels of the image. Must include alpha values if " "specified. *Changed in version 1.14.13:* (1) *io.BytesIO* can now also " "be used. (2) Data are now **copied** to the pixmap, so may safely be " "deleted or become unavailable." msgstr "" #: ../../pixmap.rst:166 882216b59426469ebf0fc58e1a590a22 msgid "" "an area containing all pixels of the image. Must include alpha values if " "specified." msgstr "이미지의 모든 픽셀을 포함하는 영역. 지정된 경우 알파 값을 포함해야 합니다." #: ../../pixmap.rst:168 94da32783c284a7c9e5cd26b1aa7aead msgid "" "*Changed in version 1.14.13:* (1) *io.BytesIO* can now also be used. (2) " "Data are now **copied** to the pixmap, so may safely be deleted or become" " unavailable." msgstr "*버전 1.14.13에서 변경됨:* (1) 이제 *io.BytesIO* 도 사용할 수 있습니다. (2) 데이터가 이제 픽스맵에 **복사** 되므로 안전하게 삭제하거나 사용할 수 없게 만들 수 있습니다." #: ../../pixmap.rst:170 92e53d092aa1464db50b36eb7899219d msgid "whether a transparency channel is included." msgstr "투명도 채널이 포함되는지 여부." #: ../../pixmap.rst:174 d35de668e91d424ebf94418d892dcbd6 msgid "" "The following equation **must be true**: *(colorspace.n + alpha) * width " "* height == len(samples)*." msgstr "다음 방정식이 **참이어야 합니다**: *(colorspace.n + alpha) * width * height == len(samples)*." #: ../../pixmap.rst:175 1c597631a5304c869da76bb9d81e6ed9 msgid "" "Starting with version 1.14.13, the samples data are **copied** to the " "pixmap." msgstr "버전 1.14.13부터 samples 데이터가 픽스맵에 **복사** 됩니다." #: ../../pixmap.rst:180 5c8af01ebb9141c4b8de801dd3f3356e msgid "" "**From a PDF image:** Create a pixmap from an image **contained in PDF** " "*doc* identified by its :data:`xref`. All pimap properties are set by the" " image. Have a look at `extract-img1.py " "`_ " "and `extract-img2.py `_ to see how this can be used to recover all of a PDF's" " images." msgstr "**PDF 이미지에서:** :data:`xref` 로 식별되는 |PDF| *doc* 에 **포함된** 이미지에서 픽스맵을 생성합니다. 모든 픽스맵 속성은 이미지에 의해 설정됩니다. `extract-img1.py `_ 및 `extract-img2.py `_ 를 확인하여 이것을 사용하여 PDF의 모든 이미지를 복구하는 방법을 참조하세요." #: ../../pixmap.rst:182 83027e8baba3428f9138b9272d50b7c5 msgid "an opened |PDF| document." msgstr "열린 |PDF| 문서." #: ../../pixmap.rst:185 1d115e0cbe8d45c1a12b21ba961b218c msgid "" "the :data:`xref` of an image object. For example, you can make a list of " "images used on a particular page with :meth:`Document.get_page_images`, " "which also shows the :data:`xref` numbers of each image." msgstr "이미지 객체의 :data:`xref`. 예를 들어 :meth:`Document.get_page_images` 를 사용하여 특정 페이지에서 사용된 이미지 목록을 만들 수 있으며, 이것은 각 이미지의 :data:`xref` 번호도 표시합니다." #: ../../pixmap.rst:189 af2a4e8f44da46f9b6b2a58073bb2cfc msgid "Initialize the samples area." msgstr "samples 영역을 초기화합니다." #: ../../pixmap.rst:191 e9fa66fe4f434c59baeea5e2c721a40d msgid "" "if specified, values from 0 to 255 are valid. Each color byte of each " "pixel will be set to this value, while alpha will be set to 255 (non-" "transparent) if present. If omitted, then all bytes (including any alpha)" " are cleared to *0x00*." msgstr "지정된 경우 0부터 255까지의 값이 유효합니다. 각 픽셀의 각 색상 바이트는 이 값으로 설정되고, 알파가 있으면 255(불투명)로 설정됩니다. 생략하면 모든 바이트(알파 포함)가 *0x00* 으로 지워집니다." #: ../../pixmap.rst:193 bb47605a216946dba119a8bf60a6dcdd msgid "" "the area to be cleared. Omit to clear the whole pixmap. Can only be " "specified, if *value* is also specified." msgstr "지울 영역. 생략하면 전체 픽스맵을 지웁니다. *value* 도 지정된 경우에만 지정할 수 있습니다." #: ../../pixmap.rst:197 78bf5b67f38f46178532a1e37e7ddd72 msgid "" "Colorize a pixmap by replacing black and / or white with colors given as " "**sRGB integer** values. Only colorspaces :data:`CS_GRAY` and " ":data:`CS_RGB` are supported, others are ignored with a warning." msgstr "**sRGB 정수** 값으로 주어진 색상으로 검은색 및/또는 흰색을 교체하여 픽스맵을 색칠합니다. 색상 공간 :data:`CS_GRAY` 및 :data:`CS_RGB` 만 지원되며, 다른 것은 경고와 함께 무시됩니다." #: ../../pixmap.rst:199 abae57d0723b4345a89b12f880d933fa msgid "" "If the colorspace is :data:`CS_GRAY`, the average *(red + green + " "blue)/3* will be taken. The pixmap will be changed in place." msgstr "색상 공간이 :data:`CS_GRAY` 인 경우 평균 *(red + green + blue)/3* 이 사용됩니다. 픽스맵은 제자리에서 변경됩니다." #: ../../pixmap.rst:201 04577dadbfbc43a3abbe3d997f6561ab msgid "replace black with this value. Specifying 0x000000 makes no changes." msgstr "검은색을 이 값으로 교체합니다. 0x000000을 지정하면 변경되지 않습니다." #: ../../pixmap.rst:202 43f498ae78e443a28b06bdcc72789414 msgid "replace white with this value. Specifying 0xFFFFFF makes no changes." msgstr "흰색을 이 값으로 교체합니다. 0xFFFFFF를 지정하면 변경되지 않습니다." #: ../../pixmap.rst:204 391411e29bc24c0183271fc962fc85ae msgid "Examples:" msgstr "Examples:" #: ../../pixmap.rst:206 6e89c521384c4c5bbc9619d3efe8b909 msgid "`tint_with(0x000000, 0xFFFFFF)` is a no-op." msgstr "`tint_with(0x000000, 0xFFFFFF)` 는 no-op입니다." #: ../../pixmap.rst:207 64e6d46367ef4feca63cb7fb163d6b63 msgid "" "`tint_with(0x00FF00, 0xFFFFFF)` changes black to green, leaves white " "intact." msgstr "`tint_with(0x00FF00, 0xFFFFFF)` 는 검은색을 녹색으로 변경하고 흰색은 그대로 둡니다." #: ../../pixmap.rst:208 8ea3f30122264c92b50ec935ec42fc3c msgid "`tint_with(0xFF0000, 0x0000FF)` changes black to red and white to blue." msgstr "`tint_with(0xFF0000, 0x0000FF)` 는 검은색을 빨간색으로, 흰색을 파란색으로 변경합니다." #: ../../pixmap.rst:213 ca2f9c12e08649b5870ae3ad64eacd72 msgid "" "Apply a gamma factor to a pixmap, i.e. lighten or darken it. Pixmaps with" " colorspace ``None`` are ignored with a warning." msgstr "픽스맵에 감마 계수를 적용합니다. 즉, 밝게 하거나 어둡게 합니다. 색상 공간이 ``None`` 인 픽스맵은 경고와 함께 무시됩니다." #: ../../pixmap.rst:215 f4c36ad3313f4088882a49b8ff1847ec msgid "" "*gamma = 1.0* does nothing, *gamma < 1.0* lightens, *gamma > 1.0* darkens" " the image." msgstr "*gamma = 1.0* 은 아무것도 하지 않으며, *gamma < 1.0* 은 밝게 하고, *gamma > 1.0* 은 이미지를 어둡게 합니다." #: ../../pixmap.rst:219 8543630bd8134fbfbad3e241950d6cea msgid "" "Shrink the pixmap by dividing both, its width and height by 2\\ " ":sup:``n``." msgstr "너비와 높이를 모두 2\\ :sup:``n`` 으로 나누어 픽스맵을 축소합니다." #: ../../pixmap.rst:221 30c7f5ad783249949e9748a49eb7d9f9 msgid "" "determines the new pixmap (samples) size. For example, a value of 2 " "divides width and height by 4 and thus results in a size of one 16\\ " ":sup:`th` of the original. Values less than 1 are ignored with a warning." msgstr "새 픽스맵(samples) 크기를 결정합니다. 예를 들어 값 2는 너비와 높이를 4로 나누어 원본의 16\\ :sup:`분의 1` 크기로 만듭니다. 1보다 작은 값은 경고와 함께 무시됩니다." #: ../../pixmap.rst:223 f45f17093df4420cb6fbc619648afd22 msgid "" "Use this methods to reduce a pixmap's size retaining its proportion. The " "pixmap is changed \"in place\". If you want to keep original and also " "have more granular choices, use the resp. copy constructor above." msgstr "이 메서드를 사용하여 비율을 유지하면서 픽스맵의 크기를 줄입니다. 픽스맵은 \"제자리에서\" 변경됩니다. 원본을 유지하고 더 세밀한 선택을 원하면 위의 해당 복사 생성자를 사용하세요." #: ../../pixmap.rst:227 1455e6653c744eeba403a49f543d6fab msgid "" "*New in version:: 1.14.5:* Return the value of the pixel at location (x, " "y) (column, line)." msgstr "*버전 1.14.5의 새로운 기능:* 위치 (x, y)(열, 줄)의 픽셀 값을 반환합니다." #: ../../pixmap.rst:229 ../../pixmap.rst:239 4665e9dd65654240abe6ee77bae37183 #: ffb7d135ed9a41f1b4f0bfa146d6de82 msgid "the column number of the pixel. Must be in `range(pix.width)`." msgstr "픽셀의 열 번호. `range(pix.width)` 에 있어야 합니다." #: ../../pixmap.rst:230 f1efa4c149644cc680d5348ad2c2e068 msgid "the line number of the pixel, Must be in `range(pix.height)`." msgstr "픽셀의 줄 번호. `range(pix.height)` 에 있어야 합니다." #: ../../pixmap.rst 369baee8d7234ef2ab7f82e75e9111ad #: a81a4cbd70ad4e0b8fb189a247cfcaaf b3a66cf736f24daea703147e167c320f #: cc865d958a3d4c81b2cbd3d3f814714b d2546977b027475993b2df887c1cb6e8 #: e81aa1c04aa6419da09b400752672904 eb0378b2f08a49a0af740a769d1a6087 msgid "Return type" msgstr "Return type" #: ../../pixmap.rst 186871c10cae496984d33e4181c189b0 #: 24ba23b408644b24bd9aa5c5c7695c13 375a4a43a898465fa252490979e2f154 #: 44939b8c082c4f128aecb10f802bce36 8183d07de46a4c909fc8ff25a1c13b5e #: 82dd9565faa544cf8799ce6981d78e02 a7c02e0b9035405a9f75f61d1ef8a011 msgid "Returns" msgstr "Returns" #: ../../pixmap.rst:233 1c117c2f7320435ab28104a0c9e6b3f0 msgid "" "a list of color values and, potentially the alpha value. Its length and " "content depend on the pixmap's colorspace and the presence of an alpha. " "For RGBA pixmaps the result would e.g. be *[r, g, b, a]*. All items are " "integers in `range(256)`." msgstr "색상 값 및 잠재적으로 알파 값의 목록. 길이와 내용은 픽스맵의 색상 공간과 알파의 존재에 따라 다릅니다. RGBA 픽스맵의 경우 결과는 예를 들어 *[r, g, b, a]* 가 됩니다. 모든 항목은 `range(256)` 의 정수입니다." #: ../../pixmap.rst:237 4e3d50e363f54e7da5ab00f4aa58fec5 msgid "" "*New in version 1.14.7:* Manipulate the pixel at location (x, y) (column," " line)." msgstr "*버전 1.14.7의 새로운 기능:* 위치 (x, y)(열, 줄)의 픽셀을 조작합니다." #: ../../pixmap.rst:240 0dcca10c1c4c4b58b61746cd5da73f43 msgid "the line number of the pixel. Must be in `range(pix.height)`." msgstr "픽셀의 줄 번호. `range(pix.height)` 에 있어야 합니다." #: ../../pixmap.rst:241 eee0a54112754d7db4a0e21facaf19c8 msgid "" "the desired pixel value given as a sequence of integers in `range(256)`. " "The length of the sequence must equal :attr:`Pixmap.n`, which includes " "any alpha byte." msgstr "`range(256)` 의 정수 시퀀스로 주어진 원하는 픽셀 값. 시퀀스의 길이는 알파 바이트를 포함하여 :attr:`Pixmap.n` 과 같아야 합니다." #: ../../pixmap.rst:245 223fcf7f54984d26a1a64657ed00a81d msgid "*New in version 1.14.8:* Set the pixels of a rectangle to a value." msgstr "*버전 1.14.8의 새로운 기능:* 사각형의 픽셀을 값으로 설정합니다." #: ../../pixmap.rst:247 95d0f97710ba444391fd993ca732bc02 msgid "" "the rectangle to be filled with the value. The actual area is the " "intersection of this parameter and :attr:`Pixmap.irect`. For an empty " "intersection (or an invalid parameter), no change will happen." msgstr "값으로 채울 사각형. 실제 영역은 이 매개변수와 :attr:`Pixmap.irect` 의 교집합입니다. 빈 교집합(또는 잘못된 매개변수)의 경우 변경이 발생하지 않습니다." #: ../../pixmap.rst:248 a8fe7a3cf13a40e6a5abc4a65a481906 msgid "" "the desired value, given as a sequence of integers in `range(256)`. The " "length of the sequence must equal :attr:`Pixmap.n`, which includes any " "alpha byte." msgstr "`range(256)` 의 정수 시퀀스로 주어진 원하는 값. 시퀀스의 길이는 알파 바이트를 포함하여 :attr:`Pixmap.n` 과 같아야 합니다." #: ../../pixmap.rst:251 ef594268cf964435b0f7fae7229908c8 msgid "" "``False`` if the rectangle was invalid or had an empty intersection with " ":attr:`Pixmap.irect`, else ``True``." msgstr "사각형이 유효하지 않거나 :attr:`Pixmap.irect` 와 빈 교집합이 있으면 ``False``, 그렇지 않으면 ``True``." #: ../../pixmap.rst:255 bcf6532518a34f9c87fe6473f29b283c msgid "" "This method is equivalent to :meth:`Pixmap.set_pixel` executed for each " "pixel in the rectangle, but is obviously **very much faster** if many " "pixels are involved." msgstr "이 메서드는 사각형의 각 픽셀에 대해 실행되는 :meth:`Pixmap.set_pixel` 과 동일하지만 많은 픽셀이 관련된 경우 **훨씬 빠릅니다**." #: ../../pixmap.rst:256 bc5f1b513a0f4c4fa649296505adae7c msgid "" "This method can be used similar to :meth:`Pixmap.clear_with` to " "initialize a pixmap with a certain color like this: " "*pix.set_rect(pix.irect, (255, 255, 0))* (RGB example, colors the " "complete pixmap with yellow)." msgstr "이 메서드는 :meth:`Pixmap.clear_with` 와 유사하게 사용하여 픽스맵을 특정 색상으로 초기화할 수 있습니다: *pix.set_rect(pix.irect, (255, 255, 0))* (RGB 예제, 전체 픽스맵을 노란색으로 칠함)." #: ../../pixmap.rst:260 a513c003abe849829c11fe1447ebad4c msgid "New in v1.17.7" msgstr "v1.17.7에서 새로 추가됨" #: ../../pixmap.rst:262 0b7cc0a788dd40cb8acfbdb60fc95d01 msgid "Set the x and y values of the pixmap's top-left point." msgstr "픽스맵의 왼쪽 위 점의 x 및 y 값을 설정합니다." #: ../../pixmap.rst:264 235e6e23b0b24739bc80e81e21526714 msgid "x coordinate" msgstr "x 좌표" #: ../../pixmap.rst:265 6abac422a54b4e5bb66a4859637f5a69 msgid "y coordinate" msgstr "y 좌표" #: ../../pixmap.rst:270 c5527c1032f044a2a640143d01653c61 msgid "New in v1.16.17" msgstr "v1.16.17에서 새로 추가됨" #: ../../pixmap.rst:272 f49f9e8464474d7cbf7a85f1ba506a82 msgid "" "Changed in v1.18.0: When saving as a PNG image, these values will be " "stored now." msgstr "v1.18.0에서 변경됨: PNG 이미지로 저장할 때 이 값들이 이제 저장됩니다." #: ../../pixmap.rst:274 a468673bcf8b49a68b788fd8ae23b5d5 msgid "Set the resolution (dpi) in x and y direction." msgstr "x 및 y 방향의 해상도(dpi)를 설정합니다." #: ../../pixmap.rst:276 0ac91572ffc64e2bba64b0279d3fc7a3 msgid "resolution in x direction." msgstr "x 방향 해상도." #: ../../pixmap.rst:277 1eb356ec57454ca9815ab72ead63956f msgid "resolution in y direction." msgstr "y 방향 해상도." #: ../../pixmap.rst:282 8623995d2c004b0ba2caf470042846f1 msgid "Changed in v 1.18.13" msgstr "v1.18.13에서 변경됨" #: ../../pixmap.rst:284 82d487067f8d4ced9ef11d081f5e4ce8 msgid "Change the alpha values. The pixmap must have an alpha channel." msgstr "알파 값을 변경합니다. 픽스맵은 알파 채널을 가져야 합니다." #: ../../pixmap.rst:286 c98fe169c19c487481ca55cd0633f3f8 msgid "" "the new alpha values. If provided, its length must be at least *width * " "height*. If omitted (`None`), all alpha values are set to 255 (no " "transparency). *Changed in version 1.14.13:* *io.BytesIO* is now also " "accepted." msgstr "새 알파 값. 제공된 경우 길이는 최소 *width * height* 여야 합니다. 생략(`None`)하면 모든 알파 값이 255(투명도 없음)로 설정됩니다. *버전 1.14.13에서 변경됨:* 이제 *io.BytesIO* 도 허용됩니다." #: ../../pixmap.rst:287 e94c3d6b68c141e2b61b6f54ab717d33 msgid "" "*New in v1.18.13:* whether to premultiply color components with the alpha" " value." msgstr "*v1.18.13의 새로운 기능:* 색상 구성 요소를 알파 값으로 사전 곱셈할지 여부." #: ../../pixmap.rst:288 fbe9e806927d460389c858b14d4f3644 msgid "" "ignore the alpha value and set this color to fully transparent. A " "sequence of integers in `range(256)` with a length of :attr:`Pixmap.n`. " "Default is ``None``. For example, a typical choice for RGB would be " "`opaque=(255, 255, 255)` (white)." msgstr "알파 값을 무시하고 이 색상을 완전히 투명하게 설정합니다. :attr:`Pixmap.n` 길이의 `range(256)` 정수 시퀀스. 기본값은 ``None`` 입니다. 예를 들어 RGB의 일반적인 선택은 `opaque=(255, 255, 255)` (흰색)입니다." #: ../../pixmap.rst:293 e617ef83731c4689a35511a90c29ceeb msgid "" "Invert the color of all pixels in :ref:`IRect` *irect*. Will have no " "effect if colorspace is ``None``." msgstr ":ref:`IRect` *irect* 의 모든 픽셀 색상을 반전합니다. 색상 공간이 ``None`` 이면 효과가 없습니다." #: ../../pixmap.rst:295 b9d38a022bef44f89d241d1964237fbb msgid "The area to be inverted. Omit to invert everything." msgstr "반전할 영역. 생략하면 모든 것을 반전합니다." #: ../../pixmap.rst:299 e764fb3df0324f5187dbb68ba9a917ba msgid "" "Copy the *irect* part of the *source* pixmap into the corresponding area " "of this one. The two pixmaps may have different dimensions and can each " "have :data:`CS_GRAY` or :data:`CS_RGB` colorspaces, but they currently " "**must** have the same alpha property [#f2]_. The copy mechanism " "automatically adjusts discrepancies between source and target like so:" msgstr "*source* 픽스맵의 *irect* 부분을 이 픽스맵의 해당 영역에 복사합니다. 두 픽스맵은 다른 크기를 가질 수 있으며 각각 :data:`CS_GRAY` 또는 :data:`CS_RGB` 색상 공간을 가질 수 있지만 현재 **반드시** 동일한 알파 속성을 가져야 합니다 [#f2]_. 복사 메커니즘은 다음과 같이 소스와 대상 간의 차이를 자동으로 조정합니다:" #: ../../pixmap.rst:301 e270f22850b84663930783d1f33ca33c msgid "" "If copying from :data:`CS_GRAY` to :data:`CS_RGB`, the source gray-shade " "value will be put into each of the three rgb component bytes. If the " "other way round, *(r + g + b) / 3* will be taken as the gray-shade value " "of the target." msgstr ":data:`CS_GRAY` 에서 :data:`CS_RGB` 로 복사하는 경우, 소스 그레이 음영 값이 세 개의 RGB 구성 요소 바이트 각각에 배치됩니다. 반대의 경우, *(r + g + b) / 3* 이 대상의 그레이 음영 값으로 사용됩니다." #: ../../pixmap.rst:303 e29fc4caf130461db1843ba16fe4fc72 msgid "" "Between *irect* and the target pixmap's rectangle, an \"intersection\" is" " calculated at first. This takes into account the rectangle coordinates " "and the current attribute values :attr:`Pixmap.x` and :attr:`Pixmap.y` " "(which you are free to modify for this purpose via " ":meth:`Pixmap.set_origin`). Then the corresponding data of this " "intersection are copied. If the intersection is empty, nothing will " "happen." msgstr "*irect* 와 대상 픽스맵의 사각형 사이에서 먼저 \"교집합\"이 계산됩니다. 이것은 사각형 좌표와 현재 속성 값 :attr:`Pixmap.x` 및 :attr:`Pixmap.y` (이 목적을 위해 :meth:`Pixmap.set_origin` 을 통해 자유롭게 수정할 수 있음)를 고려합니다. 그런 다음 이 교집합의 해당 데이터가 복사됩니다. 교집합이 비어 있으면 아무 일도 발생하지 않습니다." #: ../../pixmap.rst:308 fb1b535c8adc44baa4c729c25fec3e14 msgid "The area to be copied." msgstr "복사할 영역." #: ../../pixmap.rst:310 82448c014aa543b68e66cec1b07f3d96 msgid "" "Example: Suppose you have two pixmaps, `pix1` and `pix2` and you want to " "copy the lower right quarter of `pix2` to `pix1` such that it starts at " "the top-left point of `pix1`. Use the following snippet::" msgstr "예제: 두 개의 픽스맵 `pix1` 과 `pix2` 가 있고 `pix2` 의 오른쪽 아래 사분면을 `pix1` 의 왼쪽 위 지점에서 시작하도록 `pix1` 에 복사하려는 경우 다음 스니펫을 사용하세요::" #: ../../pixmap.rst:329 7fbfff308f9d4627a4a6f2fc60e1651e msgid "" "Changed in v1.22.0: Added **direct support of JPEG** images. Image " "quality can be controlled via parameter \"jpg_quality\"." msgstr "v1.22.0에서 변경됨: **JPEG 이미지 직접 지원** 이 추가되었습니다. 이미지 품질은 \"jpg_quality\" 매개변수를 통해 제어할 수 있습니다." #: ../../pixmap.rst:331 97bd54f9e597471292898030e2002c7a msgid "" "Save pixmap as an image file. Depending on the output chosen, only some " "or all colorspaces are supported and different file extensions can be " "chosen. Please see the table below." msgstr "픽스맵을 이미지 파일로 저장합니다. 선택한 출력에 따라 일부 또는 모든 색상 공간이 지원되며 다른 파일 확장자를 선택할 수 있습니다. 아래 표를 참조하세요." #: ../../pixmap.rst:333 9cbb39acd6fd43c7b4231f63399b34d8 msgid "" "The file to save to. May be provided as a string, as a ``pathlib.Path`` " "or as a Python file object. In the latter two cases, the filename is " "taken from the resp. object. The filename's extension determines the " "image format, which can be overruled by the output parameter." msgstr "저장할 파일. 문자열, ``pathlib.Path`` 또는 Python 파일 객체로 제공할 수 있습니다. 후자 두 경우에는 파일 이름이 해당 객체에서 가져옵니다. 파일 이름의 확장자는 이미지 형식을 결정하며, output 매개변수로 재정의할 수 있습니다." #: ../../pixmap.rst:335 a8f9fb30eb6f4e129ccdb1eb4dfb2d50 msgid "" "The desired image format. The default is the filename's extension. If " "both, this value and the file extension are unsupported, an exception is " "raised. For possible values see :ref:`PixmapOutput`." msgstr "원하는 이미지 형식. 기본값은 파일 이름의 확장자입니다. 이 값과 파일 확장자가 모두 지원되지 않으면 예외가 발생합니다. 가능한 값은 :ref:`PixmapOutput` 을 참조하세요." #: ../../pixmap.rst:336 ../../pixmap.rst:346 57c5e89d61b643828893b09c1506e81c #: a4031bcffabf4809bb9b3450054f39ec msgid "" "The desired image quality, default 95. Only applies to JPEG images, else " "ignored. This parameter trades quality against file size. A value of 98 " "is close to lossless. Higher values should not lead to better quality." msgstr "원하는 이미지 품질, 기본값 95. JPEG 이미지에만 적용되며, 그렇지 않으면 무시됩니다. 이 매개변수는 품질과 파일 크기를 교환합니다. 값 98은 무손실에 가깝습니다. 더 높은 값이 더 나은 품질로 이어지지는 않습니다." #: ../../pixmap.rst 31830ae4676c49a29f6eda0ec74b2cc7 #: 35f861d76f76416f84ca4a6cfbb9ba36 9e7d20d2ebff48a5a2f12a7bb9cb207f #: 9e8d92287683474c8894ca359bc0df3c eaa3f51d3c63445d921c804b8d264fba msgid "Raises" msgstr "Raises" #: ../../pixmap.rst:338 ../../pixmap.rst:348 74c8c07d5a4d429180ebc61a6dc88b40 #: 888fc652cefb483cbc631acba45b2a8c msgid "For unsupported image formats." msgstr "지원되지 않는 이미지 형식의 경우." #: ../../pixmap.rst:342 3e89ee831b4744b2a7778a6f2ab7d705 msgid "" "New in version 1.14.5: Return the pixmap as a *bytes* memory object of " "the specified format -- similar to :meth:`save`." msgstr "버전 1.14.5의 새로운 기능: 지정된 형식의 *bytes* 메모리 객체로 픽스맵을 반환합니다 -- :meth:`save` 와 유사합니다." #: ../../pixmap.rst:343 4dff4d1183ff44f2a456ec123ddad67f msgid "" "Changed in v1.22.0: Added **direct JPEG support**. Image quality can be " "influenced via new parameter \"jpg_quality\"." msgstr "v1.22.0에서 변경됨: **직접 JPEG 지원** 이 추가되었습니다. 이미지 품질은 새로운 매개변수 \"jpg_quality\"를 통해 조정할 수 있습니다." #: ../../pixmap.rst:345 17d9ad6bf1cd4d0caaf174d46a29b286 msgid "" "The desired image format. The default is \"png\". For possible values see" " :ref:`PixmapOutput`." msgstr "원하는 이미지 형식. 기본값은 \"png\"입니다. 가능한 값은 :ref:`PixmapOutput` 을 참조하세요." #: ../../pixmap.rst:351 7a4a3392440c413b9549ddfd80aa09e8 msgid "" "The requested image format. The default is \"png\". For other possible " "values see :ref:`PixmapOutput`." msgstr "요청된 이미지 형식. 기본값은 \"png\"입니다. 다른 가능한 값은 :ref:`PixmapOutput` 을 참조하세요." #: ../../pixmap.rst:355 ../../pixmap.rst:370 024249ef113f468bba659314559663a8 #: 3ebc661e655c4894a0780bd40d34f1b9 msgid "New in v1.19.0" msgstr "v1.19.0에서 새로 추가됨" #: ../../pixmap.rst:357 ../../pixmap.rst:372 98399e67142a4ab4bfa0146bb6a938e0 #: fde150994fb44c0dac805e2d7807ae53 msgid "Changed in v1.22.5: Support of new parameter for Tesseract's tessdata." msgstr "v1.22.5에서 변경됨: Tesseract의 tessdata에 대한 새로운 매개변수 지원." #: ../../pixmap.rst:359 7e216757569f4c4ebb1b9d88f2858c00 msgid "" "Perform text recognition using Tesseract and save the image as a 1-page " "PDF with an OCR text layer." msgstr "Tesseract를 사용하여 텍스트 인식을 수행하고 이미지를 OCR 텍스트 레이어가 있는 1페이지 PDF로 저장합니다." #: ../../pixmap.rst:361 9e480852cca4498d8cb34f674e078760 msgid "" "identifies the file to save to. May be either a string or a pointer to a " "file opened with \"wb\" (includes `io.BytesIO()` objects)." msgstr "저장할 파일을 식별합니다. 문자열 또는 \"wb\"로 열린 파일에 대한 포인터(`io.BytesIO()` 객체 포함)일 수 있습니다." #: ../../pixmap.rst:362 739251505f694c69af4730ee2d8f7848 msgid "whether to compress the resulting PDF, default is `True`." msgstr "결과 PDF를 압축할지 여부, 기본값은 `True` 입니다." #: ../../pixmap.rst:363 8c1c54fe56a34bf19f07465936ed9f10 msgid "" "the languages occurring in the image. This must be specified in Tesseract" " format. Default is \"eng\" for English. Use \"+\"-separated Tesseract " "language codes for multiple languages, like \"eng+spa\" for English and " "Spanish." msgstr "이미지에 나타나는 언어. Tesseract 형식으로 지정해야 합니다. 기본값은 영어의 경우 \"eng\"입니다. 여러 언어의 경우 \"+\"로 구분된 Tesseract 언어 코드를 사용하세요(예: 영어와 스페인어의 경우 \"eng+spa\")." #: ../../pixmap.rst:364 fcca47fa76a9459cbec299e7f148dec6 msgid "" "folder name of Tesseract's language support. If omitted, this information" " must be present as environment variable `TESSDATA_PREFIX`." msgstr "Tesseract의 언어 지원 폴더 이름. 생략된 경우 이 정보는 환경 변수 `TESSDATA_PREFIX` 로 존재해야 합니다." #: ../../pixmap.rst:366 21a4cf67602b4076b49b985e8aa0c66b msgid "" "**Will fail** if Tesseract is not installed or if the environment " "variable \"TESSDATA_PREFIX\" is not set to the `tessdata` folder name and" " not provided as parameter." msgstr "Tesseract가 설치되지 않았거나 환경 변수 \"TESSDATA_PREFIX\"가 `tessdata` 폴더 이름으로 설정되지 않고 매개변수로 제공되지 않으면 **실패합니다**." #: ../../pixmap.rst:374 32b8acd13d9f48e1bfd79ab1023be929 msgid "" "Perform text recognition using Tesseract and convert the image to a " "1-page PDF with an OCR text layer. Internally invokes " ":meth:`Pixmap.pdfocr_save`." msgstr "Tesseract를 사용하여 텍스트 인식을 수행하고 이미지를 OCR 텍스트 레이어가 있는 1페이지 PDF로 변환합니다. 내부적으로 :meth:`Pixmap.pdfocr_save` 를 호출합니다." #: ../../pixmap.rst:376 9e005bf6ab3440c085ee1193ba601f87 msgid "" "A 1-page PDF file in memory. Could be opened like " "`doc=pymupdf.open(\"pdf\", pix.pdfocr_tobytes())`, and text extractions " "could be performed on its `page=doc[0]`. .. note:: Another possible " "use is insertion into some pdf. The following snippet reads the images of" " a folder and stores them as pages in a new PDF that contain an OCR text " "layer:: doc = pymupdf.open() for imgfile in " "os.listdir(folder): pix = pymupdf.Pixmap(imgfile) " "imgpdf = pymupdf.open(\"pdf\", pix.pdfocr_tobytes()) " "doc.insert_pdf(imgpdf) pix = None imgpdf.close() " "doc.save(\"ocr-images.pdf\")" msgstr "" #: ../../pixmap.rst:376 b412ebf7d201478890ec75b641a17871 msgid "" "A 1-page PDF file in memory. Could be opened like " "`doc=pymupdf.open(\"pdf\", pix.pdfocr_tobytes())`, and text extractions " "could be performed on its `page=doc[0]`." msgstr "메모리의 1페이지 PDF 파일. `doc=pymupdf.open(\"pdf\", pix.pdfocr_tobytes())` 와 같이 열 수 있으며, `page=doc[0]` 에서 텍스트 추출을 수행할 수 있습니다." #: ../../pixmap.rst:380 2cd418d767ef4149b35f4d0415d14af1 msgid "" "Another possible use is insertion into some pdf. The following snippet " "reads the images of a folder and stores them as pages in a new PDF that " "contain an OCR text layer::" msgstr "다른 가능한 사용법은 일부 PDF에 삽입하는 것입니다. 다음 스니펫은 폴더의 이미지를 읽어 OCR 텍스트 레이어가 포함된 새 PDF의 페이지로 저장합니다::" #: ../../pixmap.rst:394 efc06e14189c4871827c5261c0623dfa msgid "Create a Pillow Image from the pixmap. PIL / Pillow must be installed." msgstr "픽스맵에서 Pillow 이미지를 생성합니다. PIL / Pillow가 설치되어 있어야 합니다." #: ../../pixmap.rst:396 ../../pixmap.rst:416 ../../pixmap.rst:424 #: 3df2560f6e804a789cc70c26deec880b 8087c1edcca942f186efe9ad6be77c16 #: 85c874d70f274112a51bc6ce56e6e197 msgid "if Pillow is not installed." msgstr "Pillow가 설치되지 않은 경우." #: ../../pixmap.rst:397 69708896f8e44f9eb5a130326ae36b80 msgid "a ``PIL.Image`` object" msgstr "``PIL.Image`` 객체" #: ../../pixmap.rst:401 3f77a2ee05134b31a570bc40ff704b87 msgid "" "Write the pixmap as an image file using Pillow. Use this method for " "output unsupported by MuPDF. Examples are" msgstr "Pillow를 사용하여 픽스맵을 이미지 파일로 씁니다. MuPDF에서 지원하지 않는 출력에 이 메서드를 사용하세요. 예는 다음과 같습니다" #: ../../pixmap.rst:403 8f8925fd0a1e4868840945ccf3b35017 msgid "Formats JPX, J2K, WebP, etc." msgstr "JPX, J2K, WebP 등의 형식." #: ../../pixmap.rst:404 bd17d3e24fb740469efea4743e5ffb78 msgid "Storing EXIF information." msgstr "EXIF 정보 저장." #: ../../pixmap.rst:405 d7d0bc56bfcb4f179b7f00d2ad59c255 msgid "" "If you do not provide dpi information, the values *xres*, *yres* stored " "with the pixmap are automatically used." msgstr "dpi 정보를 제공하지 않으면 픽스맵에 저장된 *xres*, *yres* 값이 자동으로 사용됩니다." #: ../../pixmap.rst:407 20bf1e69dd5147b9a108ab328fe2657e msgid "" "A simple example: `pix.pil_save(\"some.webp\", optimize=True, dpi=(150, " "150))`." msgstr "간단한 예제: `pix.pil_save(\"some.webp\", optimize=True, dpi=(150, 150))`." #: ../../pixmap.rst:409 71799e7c62324bbea016ae30eafbc021 msgid "" "If the pixmap's colorspace is RGB with transparency, the alpha values may" " or may not already be multiplied into the color components " "ref/green/blue (called \"premultiplied\"). To enforce undoing " "premultiplication, set this parameter to `True`. To learn about some " "background, e.g. look for `\"Premultiplied alpha\" on this page " "`_." msgstr "픽스맵의 색상 공간이 투명도가 있는 RGB인 경우, 알파 값이 이미 색상 구성 요소 빨강/녹색/파랑(소위 \"사전 곱셈\")에 곱해져 있을 수도 있고 아닐 수도 있습니다. 사전 곱셈을 취소하려면 이 매개변수를 `True` 로 설정하세요. 배경에 대한 자세한 내용은 예를 들어 이 페이지 에서 `\"Premultiplied alpha\" `_ 를 찾아보세요." #: ../../pixmap.rst:412 c5f67c82cc1b4a078d120281dc779a59 msgid "For details on other parameters see the Pillow documentation." msgstr "다른 매개변수에 대한 자세한 내용은 Pillow 문서를 참조하세요." #: ../../pixmap.rst:414 d3f2fde19b034f09971604debcf8e6dc msgid "" "Since v1.22.0, PyMuPDF supports JPEG output directly. We recommended to " "no longer use this method for JPEG output -- for performance reasons and " "for avoiding unnecessary external dependencies." msgstr "v1.22.0부터 PyMuPDF는 JPEG 출력을 직접 지원합니다. 성능상의 이유와 불필요한 외부 종속성을 피하기 위해 JPEG 출력에는 이 메서드를 더 이상 사용하지 않는 것을 권장합니다." #: ../../pixmap.rst:420 835e9bbf2bc047f2b9657ca7741ec37e msgid "New in v1.17.3" msgstr "v1.17.3에서 새로 추가됨" #: ../../pixmap.rst:422 d0177a551753414586749bf415cf6080 msgid "" "Return an image as a bytes object in the specified format using Pillow. " "For example `stream = pix.pil_tobytes(format=\"WEBP\", optimize=True, " "dpi=(150, 150))`. Also see above. For details on other parameters see the" " Pillow documentation." msgstr "Pillow를 사용하여 지정된 형식의 bytes 객체로 이미지를 반환합니다. 예를 들어 `stream = pix.pil_tobytes(format=\"WEBP\", optimize=True, dpi=(150, 150))`. 위 내용도 참조하세요. 다른 매개변수에 대한 자세한 내용은 Pillow 문서를 참조하세요." #: ../../pixmap.rst:431 ../../pixmap.rst:466 68173364cda84dab84fa461435fdec56 #: b156a10f58714dae92ca5c3163c24112 msgid "New in v1.19.3" msgstr "v1.19.3에서 새로 추가됨" #: ../../pixmap.rst:433 129930765e83498b8cb4362c41d7fb9a msgid "" "Return a new pixmap by \"warping\" the quad such that the quad corners " "become the new pixmap's corners. The target pixmap's `irect` will be `(0," " 0, width, height)`." msgstr "quad를 \"왜곡\"하여 quad 모서리가 새 픽스맵의 모서리가 되도록 새 픽스맵을 반환합니다. 대상 픽스맵의 `irect` 는 `(0, 0, width, height)` 가 됩니다." #: ../../pixmap.rst:435 6c6e2bf54f6c4c1cbd3c172dbbfb7712 msgid "" "a convex quad with coordinates inside :attr:`Pixmap.irect` (including the" " border points)." msgstr ":attr:`Pixmap.irect` 내부(경계 점 포함)에 좌표가 있는 볼록 quad." #: ../../pixmap.rst:436 e9644c03761249019390c475ce09eeb9 msgid "desired resulting width." msgstr "원하는 결과 너비." #: ../../pixmap.rst:437 5af3c5ce964244d9ac8c1210ae145777 msgid "desired resulting height." msgstr "원하는 결과 높이." #: ../../pixmap.rst:438 23af53d676c943ab8270f1f4eb3e15f8 msgid "" "A new pixmap where the quad corners are mapped to the pixmap corners in a" " clockwise fashion: `quad.ul -> irect.tl`, `quad.ur -> irect.tr`, etc." msgstr "quad 모서리가 시계 방향으로 픽스맵 모서리에 매핑된 새 픽스맵: `quad.ul -> irect.tl`, `quad.ur -> irect.tr` 등." #: ../../pixmap.rst:439 c3fb88fba3f7447889bc2174e90ed4ed msgid "" ":ref:`Pixmap` .. image:: images/img-warp.* :scale: 40 :align: " "center" msgstr "" #: ../../pixmap.rst:439 8eb4c765b10a4af0b07fe6d1cd7386d2 msgid ":ref:`Pixmap`" msgstr ":ref:`Pixmap`" #: ../../pixmap.rst:448 ../../pixmap.rst:505 ../../pixmap.rst:514 #: 00c62e32e38c4d82895121b426757269 0149558efd01426095beb5bf88035b73 #: 5c3eedb1091c4eb1af8d1010e7f2b3f0 msgid "New in v1.19.2" msgstr "v1.19.2에서 새로 추가됨" #: ../../pixmap.rst:449 b8fe5dd5d0294610a99db8d7ebd6deec msgid "Changed in v1.19.3" msgstr "v1.19.3에서 변경됨" #: ../../pixmap.rst:451 c2da2a6121594d6c8b3f4e6e7d643cee msgid "Determine the pixmap's unique colors and their count." msgstr "픽스맵의 고유 색상과 개수를 확인합니다." #: ../../pixmap.rst:453 992445f66d104d8c89ac2f8297c8e9c4 msgid "" "*(changed in v1.19.3)* If `True` return a dictionary of color pixels and " "their usage count, else just the number of unique colors." msgstr "*(v1.19.3에서 변경됨)* `True` 이면 색상 픽셀과 사용 횟수의 딕셔너리를 반환하고, 그렇지 않으면 고유 색상의 개수만 반환합니다." #: ../../pixmap.rst:454 db2ea4eae7a1492dad41fae7951b0160 msgid "" "a rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels " "are considered. This allows inspecting sub-rectangles of a given pixmap " "directly -- instead of building sub-pixmaps." msgstr ":attr:`Pixmap.irect` 내부의 사각형. 제공된 경우 해당 픽셀만 고려됩니다. 이를 통해 하위 픽스맵을 구축하는 대신 주어진 픽스맵의 하위 사각형을 직접 검사할 수 있습니다." #: ../../pixmap.rst:456 61a615b057024b7a9b6ac7fe5ff849ab msgid "" "either the number of colors, or a dictionary with the items `pixel: " "count`. The pixel key is a `bytes` object of length :attr:`Pixmap.n`. .." " note:: To recover the **tuple** of a pixel, use " "`tuple(colors.keys()[i])` for the i-th item. * The response time " "depends on the pixmap's samples size and may be more than a second for " "very large pixmaps. * Where applicable, pixels with different alpha " "values will be treated as different colors." msgstr "" #: ../../pixmap.rst:456 9ad0b09ff1334369af15be4f052a2f6f msgid "" "either the number of colors, or a dictionary with the items `pixel: " "count`. The pixel key is a `bytes` object of length :attr:`Pixmap.n`." msgstr "색상 개수 또는 `pixel: count` 항목이 있는 딕셔너리. 픽셀 키는 :attr:`Pixmap.n` 길이의 `bytes` 객체입니다." #: ../../pixmap.rst:458 d7bdc5a53abc43d6a1041953b5c0c526 msgid "" "To recover the **tuple** of a pixel, use `tuple(colors.keys()[i])` for " "the i-th item." msgstr "픽셀의 **튜플** 을 복구하려면 i번째 항목에 대해 `tuple(colors.keys()[i])` 를 사용하세요." #: ../../pixmap.rst:460 260f96dbe8c04ab1a25159255b8b79a7 msgid "" "The response time depends on the pixmap's samples size and may be more " "than a second for very large pixmaps." msgstr "응답 시간은 픽스맵의 samples 크기에 따라 달라지며 매우 큰 픽스맵의 경우 1초 이상 걸릴 수 있습니다." #: ../../pixmap.rst:461 1b987ef794b6454eb0d9366a05344070 msgid "" "Where applicable, pixels with different alpha values will be treated as " "different colors." msgstr "해당되는 경우 다른 알파 값을 가진 픽셀은 다른 색상으로 처리됩니다." #: ../../pixmap.rst:468 2b6490adea534fa6a8de4eaf1edb354a msgid "Return the most frequently used color and its relative frequency." msgstr "가장 자주 사용되는 색상과 상대적 빈도를 반환합니다." #: ../../pixmap.rst:470 485c7c5b4da94258b242db7b59b19b53 msgid "" "A rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels " "are considered. This allows inspecting sub-rectangles of a given pixmap " "directly -- instead of building sub-pixmaps." msgstr ":attr:`Pixmap.irect` 내부의 사각형. 제공된 경우 해당 픽셀만 고려됩니다. 이를 통해 하위 픽스맵을 구축하는 대신 주어진 픽스맵의 하위 사각형을 직접 검사할 수 있습니다." #: ../../pixmap.rst:472 9110208e27134f02a9b9bcdc7700add8 #, python-format msgid "" "A tuple `(ratio, pixel)` where `0 < ratio <= 1` and *pixel* is the pixel " "value of the color. Use this to decide if the image is \"almost\" " "unicolor: a response `(0.95, b\"\\x00\\x00\\x00\")` means that 95% of all" " pixels are black. See an example here :ref:`RecipesImages_P`." msgstr "`0 < ratio <= 1` 이고 *pixel* 이 색상의 픽셀 값인 튜플 `(ratio, pixel)`. 이를 사용하여 이미지가 \"거의\" 단색인지 결정하세요: 응답 `(0.95, b\"\\x00\\x00\\x00\")` 는 모든 픽셀의 95%가 검은색임을 의미합니다. 예제는 :ref:`RecipesImages_P` 를 참조하세요." #: ../../pixmap.rst:477 5e93c19118c44e4598fc55ffb9cd04f6 msgid "Indicates whether the pixmap contains transparency information." msgstr "픽스맵에 투명도 정보가 포함되어 있는지 나타냅니다." #: ../../pixmap.rst 09340208613f48af95d9e1d2a3ef91fa #: 0cc2b878ea234bfe8d91795141e3924d 0ff51066858f4faaad58612b0fbd5896 #: 163c7d4bd8d3405ca26c2650fa5d8a10 3eb04a688a904a5eaadf5d79aed68b1a #: 4869cfa0cd314211b192a2294838c7dc 5124ac9063654c24a37926de5ab662b6 #: 557f147c6be94fe083e8082986fa08b6 5ee3e6766dd44d2582e805125e914472 #: 5f52d2e5c48c47d7aec0c2b7a743fd46 6124bd56d7524796b1aa3c3e18458232 #: 7c890834a7cf4a088780dfb0e21745a8 84cbd010ada9441a9182c12bbe62059b #: 89488e9f1e4c4e3d8c6ca9ce290016a4 8be2b06b344443289085426c1e14fa50 #: 922e0d0d08124b5081bcbb57569a2aa8 a1b9de76b34b47f9b95c7bb1563b9e5a #: d0c0191f32ed43c6a6857c305705698b ead0a6e9dc94433ba020dae746028076 msgid "type" msgstr "" #: ../../pixmap.rst:479 ../../pixmap.rst:509 ../../pixmap.rst:518 #: ../../pixmap.rst:633 3d5651d764be40cca15a078b7f2531b8 #: 694a5ede4c4c43319c089b1737fd0b9c a65782123b144e4186d43ddd5c138a97 #: cd79fe63f067476c8342570d590c3121 msgid "bool" msgstr "" #: ../../pixmap.rst:483 98d329d87318478090434465b043c79d msgid "" "The MD5 hashcode (16 bytes) of the pixmap. This is a technical value used" " for unique identifications." msgstr "픽스맵의 MD5 해시코드(16바이트). 고유 식별에 사용되는 기술적 값입니다." #: ../../pixmap.rst:485 ../../pixmap.rst:537 d353d95ffd0249c9985587a89eec06f3 #: fe9d2fb1853646c9bb567d4a448e58de msgid "bytes" msgstr "" #: ../../pixmap.rst:489 94c016ffd0e94ef8a92a913eac909cf0 msgid "" "The colorspace of the pixmap. This value may be ``None`` if the image is " "to be treated as a so-called *image mask* or *stencil mask* (currently " "happens for extracted PDF document images only)." msgstr "픽스맵의 색상 공간. 이미지가 소위 *이미지 마스크* 또는 *스텐실 마스크* 로 처리되는 경우(현재 추출된 PDF 문서 이미지에만 적용) 이 값은 ``None`` 일 수 있습니다." #: ../../pixmap.rst:491 b6cfc944281042b38f313e221d8208ee msgid ":ref:`Colorspace`" msgstr "" #: ../../pixmap.rst:495 6a4abc1ca4ea41e5b98e5867969d0aea msgid "" "Contains the length of one row of image data in :attr:`Pixmap.samples`. " "This is primarily used for calculation purposes. The following " "expressions are true:" msgstr ":attr:`Pixmap.samples` 의 이미지 데이터 한 행의 길이를 포함합니다. 주로 계산 목적으로 사용됩니다. 다음 표현식이 참입니다:" #: ../../pixmap.rst:497 9ef5987d2b004c03a37ac85ebe94eb90 msgid "`len(samples) == height * stride`" msgstr "" #: ../../pixmap.rst:498 ad30730142bb41048a7ad4d99adb37ff msgid "`width * n == stride`" msgstr "" #: ../../pixmap.rst:500 ../../pixmap.rst:575 ../../pixmap.rst:581 #: ../../pixmap.rst:589 ../../pixmap.rst:597 ../../pixmap.rst:603 #: ../../pixmap.rst:609 ../../pixmap.rst:615 ../../pixmap.rst:621 #: ../../pixmap.rst:627 565eef89a4f1443196235c362117a790 #: 5790752de4bc4483b7998ab835faa57f 6b853b1effba4f9fa88e23a4ae3e5bf7 #: a40cc5c113bb4004862e82488bb6ad45 accc4d8148f54c7db1495d30f6c968f0 #: bca3975d0f204589a21f970e856552f3 d03716e1479c4f6b823e4712bf40c8e9 #: d2bde8f030b0409d8de6030b27ad0c95 d833bb6cf43f4a109aa43ffba391db0f #: d8b756b8057c42329c2c1040697bad3a msgid "int" msgstr "" #: ../../pixmap.rst:507 8695567f63d74993b36963cb05639cf6 msgid "Is `True` for a gray pixmap which only has the colors black and white." msgstr "검은색과 흰색만 있는 그레이 픽스맵에 대해 `True` 입니다." #: ../../pixmap.rst:516 b44722fd47e341cb9f851ef65e077148 msgid "" "Is `True` if all pixels are identical (any colorspace). Where applicable," " pixels with different alpha values will be treated as different colors." msgstr "모든 픽셀이 동일한 경우(모든 색상 공간) `True` 입니다. 해당되는 경우 다른 알파 값을 가진 픽셀은 다른 색상으로 처리됩니다." #: ../../pixmap.rst:523 6f074461eb274b3388c6956012c6f942 msgid "Contains the :ref:`IRect` of the pixmap." msgstr "픽스맵의 :ref:`IRect` 를 포함합니다." #: ../../pixmap.rst:525 8f50d53afc654b528e20564902041ddb msgid ":ref:`IRect`" msgstr "" #: ../../pixmap.rst:529 3abafa8c77804d0482f902d9e46ffb92 msgid "" "The color and (if :attr:`Pixmap.alpha` is true) transparency values for " "all pixels. It is an area of `width * height * n` bytes. Each n bytes " "define one pixel. Each successive n bytes yield another pixel in scanline" " order. Subsequent scanlines follow each other with no padding. E.g. for " "an RGBA colorspace this means, *samples* is a sequence of bytes like " "*..., R, G, B, A, ...*, and the four byte values R, G, B, A define one " "pixel." msgstr "모든 픽셀의 색상 및 (:attr:`Pixmap.alpha` 가 true인 경우) 투명도 값. `width * height * n` 바이트 영역입니다. 각 n 바이트는 하나의 픽셀을 정의합니다. 연속된 각 n 바이트는 스캔라인 순서로 또 다른 픽셀을 생성합니다. 후속 스캔라인은 패딩 없이 서로 이어집니다. 예를 들어 RGBA 색상 공간의 경우, *samples* 는 *..., R, G, B, A, ...* 와 같은 바이트 시퀀스이며, 네 개의 바이트 값 R, G, B, A가 하나의 픽셀을 정의합니다." #: ../../pixmap.rst:531 4d2c9332a9384bb2ac55549aea165f04 msgid "" "This area can be passed to other graphics libraries like PIL (Python " "Imaging Library) to do additional processing like saving the pixmap in " "other image formats." msgstr "이 영역은 PIL(Python Imaging Library)과 같은 다른 그래픽 라이브러리에 전달하여 다른 이미지 형식으로 픽스맵을 저장하는 등의 추가 처리를 수행할 수 있습니다." #: ../../pixmap.rst:534 44ba67d25a5246c9b5c0fd86fc515d65 msgid "" "The underlying data is typically a **large** memory area, from which a " "`bytes` copy is made for this attribute ... each time you access it: for " "example an RGB-rendered letter page has a samples size of almost 1.4 MB. " "So consider assigning a new variable to it or use the `memoryview` " "version :attr:`Pixmap.samples_mv` (new in v1.18.17)." msgstr "기본 데이터는 일반적으로 **큰** 메모리 영역이며, 이 속성에 접근할 때마다 `bytes` 복사본이 생성됩니다: 예를 들어 RGB로 렌더링된 레터 페이지는 samples 크기가 거의 1.4MB입니다. 따라서 새 변수에 할당하거나 `memoryview` 버전 :attr:`Pixmap.samples_mv` (v1.18.17에서 새로 추가됨)를 사용하세요." #: ../../pixmap.rst:535 028c2991fa3746d8ba4fcb1363e0ac36 msgid "" "Any changes to the underlying data are available only after accessing " "this attribute again. This is different from using the memoryview " "version." msgstr "기본 데이터에 대한 모든 변경 사항은 이 속성에 다시 접근한 후에만 사용할 수 있습니다. 이것은 memoryview 버전을 사용하는 것과 다릅니다." #: ../../pixmap.rst:541 ../../pixmap.rst:563 6231b732cd664d9ea3f80fe04f0151c9 #: a54baa772ece47f4b743977662b324a4 msgid "New in v1.18.17" msgstr "v1.18.17에서 새로 추가됨" #: ../../pixmap.rst:543 090480ef9ce349efab292a2a0fe883b7 msgid "" "Like :attr:`Pixmap.samples`, but in Python `memoryview` format. It is " "built pointing to the memory in the pixmap -- not from a copy of it. So " "its creation speed is independent from the pixmap size, and any changes " "to pixels will be available immediately." msgstr ":attr:`Pixmap.samples` 와 유사하지만 Python `memoryview` 형식입니다. 픽스맵의 메모리를 가리키도록 구축됩니다 -- 복사본이 아닙니다. 따라서 생성 속도는 픽스맵 크기와 무관하며 픽셀에 대한 모든 변경 사항이 즉시 사용 가능합니다." #: ../../pixmap.rst:545 93fdd4817c6d451593bce44eed03a5c1 msgid "" "Copies like `bytearray(pix.samples_mv)`, or `bytes(pixmap.samples_mv)` " "are equivalent to and can be used in place of `pix.samples`." msgstr "`bytearray(pix.samples_mv)` 또는 `bytes(pixmap.samples_mv)` 와 같은 복사본은 `pix.samples` 와 동일하며 대신 사용할 수 있습니다." #: ../../pixmap.rst:547 a15d8e7edd204441a7b9a76052a64fac msgid "We also have `len(pix.samples) == len(pix.samples_mv)`." msgstr "" #: ../../pixmap.rst:549 f7663a0870b54e46b8a6d53a9a5d3958 msgid "" "Look at this example from a 2 MB JPEG: the memoryview is **ten thousand " "times faster**::" msgstr "2MB JPEG의 이 예제를 보세요: memoryview가 **만 배 빠릅니다**::" #: ../../pixmap.rst:556 4d36f9e0a4af4491be38efa57f54faf8 msgid "" "After the Pixmap has been destroyed, any attempt to use the memoryview " "will fail with ValueError." msgstr "Pixmap이 파괴된 후 memoryview를 사용하려는 시도는 ValueError로 실패합니다." #: ../../pixmap.rst:559 91107ae487b14fe0b83a14f571082c55 msgid "memoryview" msgstr "" #: ../../pixmap.rst:565 d3bfaae3761a4c0eb851933ffe8701a3 msgid "" "Python pointer to the pixel area. This is a special integer format, which" " can be used by supporting applications (such as PyQt) to directly " "address the samples area and thus build their images extremely fast. For " "example::" msgstr "픽셀 영역에 대한 Python 포인터. 이것은 지원 애플리케이션(예: PyQt)이 samples 영역을 직접 주소 지정하여 이미지를 매우 빠르게 구축할 수 있도록 하는 특수 정수 형식입니다. 예제::" #: ../../pixmap.rst:570 92d9db2f39614549b2c8a9605c681e0b msgid "" "Both of the above lead to the same Qt image, but (2) can be **many " "hundred times faster**, because it avoids an additional copy of the pixel" " area." msgstr "위의 두 가지 모두 동일한 Qt 이미지를 생성하지만 (2)는 픽셀 영역의 추가 복사를 피하기 때문에 **수백 배 빠를 수 있습니다**." #: ../../pixmap.rst:572 37f284851e024d87b4ae3d3f4b495885 msgid "" "Warning: after the Pixmap has been destroyed, the Python pointer will be " "invalid and attempting to use it may crash the Python interpreter." msgstr "경고: Pixmap이 파괴된 후 Python 포인터는 무효화되며 사용을 시도하면 Python 인터프리터가 충돌할 수 있습니다." #: ../../pixmap.rst:579 ad8485f478d04d1791c23f7e6c8cf984 msgid "" "Contains *len(pixmap)*. This will generally equal *len(pix.samples)* plus" " some platform-specific value for defining other attributes of the " "object." msgstr "*len(pixmap)* 을 포함합니다. 이것은 일반적으로 *len(pix.samples)* 에 객체의 다른 속성을 정의하는 플랫폼별 값을 더한 것과 같습니다." #: ../../pixmap.rst:587 c1796fc010774081b59146b900edf924 msgid "Width of the region in pixels." msgstr "픽셀 단위의 영역 너비." #: ../../pixmap.rst:595 d21ef5432611489797b4691400ea9d15 msgid "Height of the region in pixels." msgstr "픽셀 단위의 영역 높이." #: ../../pixmap.rst:601 5f88d51c88864babb326d12c5da3c8b4 msgid "" "X-coordinate of top-left corner in pixels. Cannot directly be changed -- " "use :meth:`Pixmap.set_origin`." msgstr "픽셀 단위의 왼쪽 위 모서리 X 좌표. 직접 변경할 수 없습니다 -- :meth:`Pixmap.set_origin` 을 사용하세요." #: ../../pixmap.rst:607 d82f9559530f4ed3a33c06c66cd24f3c msgid "" "Y-coordinate of top-left corner in pixels. Cannot directly be changed -- " "use :meth:`Pixmap.set_origin`." msgstr "픽셀 단위의 왼쪽 위 모서리 Y 좌표. 직접 변경할 수 없습니다 -- :meth:`Pixmap.set_origin` 을 사용하세요." #: ../../pixmap.rst:613 26e889e8aa564bbea3553b3d55151e83 msgid "" "Number of components per pixel. This number depends on colorspace and " "alpha. If colorspace is not ``None`` (stencil masks), then *Pixmap.n - " "Pixmap.alpha == pixmap.colorspace.n* is true. If colorspace is ``None``, " "then *n == alpha == 1*." msgstr "픽셀당 구성 요소 수. 이 숫자는 색상 공간과 알파에 따라 다릅니다. 색상 공간이 ``None`` 이 아니면(스텐실 마스크) *Pixmap.n - Pixmap.alpha == pixmap.colorspace.n* 이 참입니다. 색상 공간이 ``None`` 이면 *n == alpha == 1* 입니다." #: ../../pixmap.rst:619 ddc7c2c6d915466a8673711ed573419a msgid "" "Horizontal resolution in dpi (dots per inch). Please also see " ":data:`resolution`. Cannot directly be changed -- use " ":meth:`Pixmap.set_dpi`." msgstr "dpi(인치당 도트) 단위의 수평 해상도. :data:`resolution` 도 참조하세요. 직접 변경할 수 없습니다 -- :meth:`Pixmap.set_dpi` 를 사용하세요." #: ../../pixmap.rst:625 5952023fee854e3f82d65f1dbcc33361 msgid "" "Vertical resolution in dpi (dots per inch). Please also see " ":data:`resolution`. Cannot directly be changed -- use " ":meth:`Pixmap.set_dpi`." msgstr "dpi(인치당 도트) 단위의 수직 해상도. :data:`resolution` 도 참조하세요. 직접 변경할 수 없습니다 -- :meth:`Pixmap.set_dpi` 를 사용하세요." #: ../../pixmap.rst:631 966a193e7ae14efe944c435e65718b73 msgid "" "An information-only boolean flag set to ``True`` if the image will be " "drawn using \"linear interpolation\". If ``False`` \"nearest neighbour " "sampling\" will be used." msgstr "이미지가 \"선형 보간\"을 사용하여 그려지면 ``True`` 로 설정되는 정보 전용 불리언 플래그. ``False`` 이면 \"최근접 샘플링\"이 사용됩니다." #: ../../pixmap.rst:638 32f8505442184689838784d6630b61ca msgid "Supported Input Image Formats" msgstr "지원되는 입력 이미지 형식" #: ../../pixmap.rst:639 708fca4db2a64b96a2de83796cd396e7 msgid "" "The following file types are supported as **input** to construct pixmaps:" " **BMP, JPEG, GIF, TIFF, JXR, JPX**, **PNG**, **PAM** and all of the " "**Portable Anymap** family (**PBM, PGM, PNM, PPM**). This support is two-" "fold:" msgstr "다음 파일 유형은 픽스맵을 구성하기 위한 **입력** 으로 지원됩니다: **BMP, JPEG, GIF, TIFF, JXR, JPX**, **PNG**, **PAM** 및 모든 **Portable Anymap** 패밀리(**PBM, PGM, PNM, PPM**). 이 지원은 두 가지 방식입니다:" #: ../../pixmap.rst:641 4f4eb0bb22404ab184bf7ed8014abcc3 msgid "" "Directly create a pixmap with *Pixmap(filename)* or *Pixmap(byterray)*. " "The pixmap will then have properties as determined by the image." msgstr "*Pixmap(filename)* 또는 *Pixmap(bytearray)* 로 직접 픽스맵을 생성합니다. 픽스맵은 이미지에 의해 결정된 속성을 갖게 됩니다." #: ../../pixmap.rst:643 1f9a875b37444d988033c769493f20e4 msgid "" "Open such files with *pymupdf.open(...)*. The result will then appear as " "a document containing one single page. Creating a pixmap of this page " "offers all the options available in this context: apply a matrix, choose " "colorspace and alpha, confine the pixmap to a clip area, etc." msgstr "*pymupdf.open(...)* 로 이러한 파일을 엽니다. 결과는 단일 페이지를 포함하는 문서로 나타납니다. 이 페이지의 픽스맵을 생성하면 이 컨텍스트에서 사용 가능한 모든 옵션을 제공합니다: 행렬 적용, 색상 공간 및 알파 선택, 픽스맵을 클립 영역으로 제한 등." #: ../../pixmap.rst:645 b8da58f972e349c099d429016189277f msgid "" "**SVG images** are only supported via method 2 above, not directly as " "pixmaps. But remember: the result of this is a **raster image** as is " "always the case with pixmaps [#f1]_." msgstr "**SVG 이미지** 는 위의 방법 2를 통해서만 지원되며 픽스맵으로 직접 지원되지 않습니다. 하지만 기억하세요: 이것의 결과는 픽스맵의 경우처럼 항상 **래스터 이미지** 입니다 [#f1]_." #: ../../pixmap.rst:650 5eb573904fb7401cb281c16fb4549f3a msgid "Supported Output Image Formats" msgstr "지원되는 출력 이미지 형식" #: ../../pixmap.rst:651 e4357173b7ec40d892ee19fcd4f3b83d msgid "" "A number of image **output** formats are supported. You have the option " "to either write an image directly to a file (:meth:`Pixmap.save`), or to " "generate a bytes object (:meth:`Pixmap.tobytes`). Both methods accept a " "string identifying the desired format (**Format** column below). Please " "note that not all combinations of pixmap colorspace, transparency support" " (alpha) and image format are possible." msgstr "다수의 이미지 **출력** 형식이 지원됩니다. 이미지를 파일에 직접 쓰기(:meth:`Pixmap.save`) 또는 bytes 객체 생성(:meth:`Pixmap.tobytes`) 중 선택할 수 있습니다. 두 메서드 모두 원하는 형식을 식별하는 문자열(아래 **Format** 열)을 허용합니다. 픽스맵 색상 공간, 투명도 지원(알파) 및 이미지 형식의 모든 조합이 가능한 것은 아닙니다." #: ../../pixmap.rst:654 4dbea7a06e2b4187a123a1c604d44efe msgid "**Format**" msgstr "" #: ../../pixmap.rst:654 80b26e8d30f3423393a42e35c1a19bb0 msgid "**Colorspaces**" msgstr "" #: ../../pixmap.rst:654 227b7bee485d4b79a2402f03891614ea msgid "**alpha**" msgstr "" #: ../../pixmap.rst:654 9797dfa1d6b74610af214069c4ee23d6 msgid "**Extensions**" msgstr "" #: ../../pixmap.rst:654 a635c115d504411785c1bf1a3984582a msgid "**Description**" msgstr "" #: ../../pixmap.rst:656 3f28e0c2c0e44d239075c2258795286a msgid "jpg, jpeg" msgstr "" #: ../../pixmap.rst:656 ../../pixmap.rst:657 ../../pixmap.rst:663 #: ../../pixmap.rst:664 18832c370236476095068f372050837f #: 3eb2a94753b44fdd9c7731ef24aef48b 4a67821c83134b4db3e4be1914c17d60 #: c83309e3c1934fc7ae1a973ebe7d1300 msgid "gray, rgb, cmyk" msgstr "" #: ../../pixmap.rst:656 ../../pixmap.rst:658 ../../pixmap.rst:659 #: ../../pixmap.rst:661 ../../pixmap.rst:662 ../../pixmap.rst:663 #: 02f9cb78532645d38d5abf940e1679f8 0cdb296b3e59480f8ec76bf53ac1c17b #: 2e0bd0a838434201878c609cff82145c 73c34c7c328f4d31af9f2258cc254f0d #: 947c1b80c66441799e2aba09091f8adb dd93afdec02947318d933a37f2c15024 msgid "no" msgstr "" #: ../../pixmap.rst:656 600504f9efd041ffb5b69ec388b137e9 msgid ".jpg, .jpeg" msgstr "" #: ../../pixmap.rst:656 26fa6ed5043a4a66a2c7adf39eb4e0cf msgid "Joint Photographic Experts Group" msgstr "" #: ../../pixmap.rst:657 6f1f99578dd84b0b96b1fb4707aac08b msgid "pam" msgstr "" #: ../../pixmap.rst:657 ../../pixmap.rst:660 ../../pixmap.rst:664 #: 1389030dbadc408693776ddaa02d250f db4043e33252451d9cfa830afcf4325c #: eb6f616d9083427b85a8e817b7b3c601 msgid "yes" msgstr "" #: ../../pixmap.rst:657 2f529016f72342f3ad621590a17c2720 msgid ".pam" msgstr "" #: ../../pixmap.rst:657 e2baced162604080b59bf27d358fda6c msgid "Portable Arbitrary Map" msgstr "" #: ../../pixmap.rst:658 95a9f8727e6846bdad7d42b2756dcf5e msgid "pbm" msgstr "" #: ../../pixmap.rst:658 ../../pixmap.rst:659 ../../pixmap.rst:660 #: ../../pixmap.rst:661 ../../pixmap.rst:662 220d5771addc47059dfafb3b7fd7a809 #: 68fd8f934dac404f86a38dcab3bb7bc2 91f4a25b5a5148af9a8c601bdc987ee9 #: 9d56458bd5944b7eab22abdec12c33c6 da23d0d1e79b4239bc3b878fd251ed6f msgid "gray, rgb" msgstr "" #: ../../pixmap.rst:658 10546c5955514cb99a4533ae396c259f msgid ".pbm" msgstr "" #: ../../pixmap.rst:658 3a22578bed7f479ba9f8bd94ddba617b msgid "Portable Bitmap" msgstr "" #: ../../pixmap.rst:659 12f4977253d34e7fb05ef71f9b6bb875 msgid "pgm" msgstr "" #: ../../pixmap.rst:659 34b5715a5a94481fa5410ee5467f5ae1 msgid ".pgm" msgstr "" #: ../../pixmap.rst:659 06d8a88352b54e25b36fc1dbd2289ecc msgid "Portable Graymap" msgstr "" #: ../../pixmap.rst:660 31684d0764064d42a3a8d884741e85be msgid "png" msgstr "" #: ../../pixmap.rst:660 34455c189f334f3ab56545b979560b1b msgid ".png" msgstr "" #: ../../pixmap.rst:660 682ed1780ad3421e9223fdefb0b8184c msgid "Portable Network Graphics" msgstr "" #: ../../pixmap.rst:661 f94a2f8f962f47fc9c9b1a7e2a906e11 msgid "pnm" msgstr "" #: ../../pixmap.rst:661 964f7dfd9ae844129b05d2e56342317d msgid ".pnm" msgstr "" #: ../../pixmap.rst:661 d627891286e44ad3987520c5e705f3a1 msgid "Portable Anymap" msgstr "" #: ../../pixmap.rst:662 3ada12b4d8b84c17aac44fec31492b76 msgid "ppm" msgstr "" #: ../../pixmap.rst:662 29fa1a416b3345479d3cb7258b83155e msgid ".ppm" msgstr "" #: ../../pixmap.rst:662 9045e7c717ae4d61ae56392d64c8f030 msgid "Portable Pixmap" msgstr "" #: ../../pixmap.rst:663 b528c16c8d064788976a0d977cf72a73 msgid "ps" msgstr "" #: ../../pixmap.rst:663 3d3a984cad1f4a1ba8eca7cfbc0af43f msgid ".ps" msgstr "" #: ../../pixmap.rst:663 f472a32950f140dcbd4258d41e955e95 msgid "Adobe PostScript Image" msgstr "" #: ../../pixmap.rst:664 d30993e0b1534a1da119de1e713e1fe7 msgid "psd" msgstr "" #: ../../pixmap.rst:664 c340e5edd2234429989f7c57fcbe6d4f msgid ".psd" msgstr "" #: ../../pixmap.rst:664 5ad137cb3c0c44fb8491eab0123adabe msgid "Adobe Photoshop Document" msgstr "" #: ../../pixmap.rst:668 5b70a01cdd2d49678a5104943c6ceb05 msgid "" "Not all image file types are supported (or at least common) on all OS " "platforms. E.g. PAM and the Portable Anymap formats are rare or even " "unknown on Windows." msgstr "모든 OS 플랫폼에서 모든 이미지 파일 유형이 지원되거나 일반적이지는 않습니다. 예를 들어 PAM 및 Portable Anymap 형식은 Windows에서 드물거나 알려지지 않았습니다." #: ../../pixmap.rst:669 ac24d0029a85434e89d87aea3c768299 msgid "" "Especially pertaining to CMYK colorspaces, you can always convert a CMYK " "pixmap to an RGB pixmap with *rgb_pix = pymupdf.Pixmap(pymupdf.csRGB, " "cmyk_pix)* and then save that in the desired format." msgstr "특히 CMYK 색상 공간에 대해 항상 *rgb_pix = pymupdf.Pixmap(pymupdf.csRGB, cmyk_pix)* 로 CMYK 픽스맵을 RGB 픽스맵으로 변환한 다음 원하는 형식으로 저장할 수 있습니다." #: ../../pixmap.rst:670 0d389b2c11cb4b7dbad0be0409dbf4dc msgid "" "As can be seen, MuPDF's image support range is different for input and " "output. Among those supported both ways, PNG and JPEG are probably the " "most popular." msgstr "볼 수 있듯이 MuPDF의 이미지 지원 범위는 입력과 출력에 따라 다릅니다. 양쪽 모두 지원되는 것 중에서 PNG와 JPEG가 가장 인기 있을 것입니다." #: ../../pixmap.rst:671 78fe092f468843e984dee90661b2dbac msgid "" "We also recommend using \"ppm\" formats as input to tkinter's " "*PhotoImage* method like this: *tkimg = " "tkinter.PhotoImage(data=pix.tobytes(\"ppm\"))* (also see the tutorial). " "This is **very** fast (**60 times** faster than PNG)." msgstr "tkinter의 *PhotoImage* 메서드에 입력으로 \"ppm\" 형식을 사용하는 것도 권장합니다: *tkimg = tkinter.PhotoImage(data=pix.tobytes(\"ppm\"))* (튜토리얼도 참조). 이것은 **매우** 빠릅니다(PNG보다 **60배** 빠름)." #: ../../pixmap.rst:676 ae8dd148bf7a4c1ea2de109295f929f5 msgid "Footnotes" msgstr "Footnotes" #: ../../pixmap.rst:677 b53f5a80a69a41dea8df4b23d4e4be3d msgid "" "If you need a **vector image** from the SVG, you must first convert it to" " a PDF. Try :meth:`Document.convert_to_pdf`. If this is not good enough, " "look for other SVG-to-PDF conversion tools like the Python packages " "`svglib `_, `CairoSVG " "`_, `Uniconvertor " "`_" " or the Java solution `Apache Batik `_. " "Have a look at our Wiki for more examples." msgstr "SVG에서 **벡터 이미지** 가 필요한 경우 먼저 PDF로 변환해야 합니다. :meth:`Document.convert_to_pdf` 를 시도해보세요. 이것으로 충분하지 않으면 Python 패키지 `svglib `_, `CairoSVG `_, `Uniconvertor `_ 또는 Java 솔루션 `Apache Batik `_ 과 같은 다른 SVG-to-PDF 변환 도구를 찾아보세요. 더 많은 예제는 Wiki를 참조하세요." #: ../../pixmap.rst:679 7efc30a117974783984b2f586a774632 msgid "" "To also set the alpha property, add an additional step to this method by " "dropping or adding an alpha channel to the result." msgstr "알파 속성도 설정하려면 결과에 알파 채널을 제거하거나 추가하여 이 메서드에 추가 단계를 더하십시오." #: ../../footer.rst:46 e3d72edf62c54080b2839fccccec965e msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/point.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ff7f2bbd27574c06a12cfe0f8feaa292 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 a938f9fbdec343399166b697412bd381 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 9b1b01d63ee048cba25d12397c4cbc9c msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../point.rst:7 14b832da77494838a52695d7ed883865 msgid "Point" msgstr "Point" #: ../../point.rst:9 ee92bfad50f840c592179ff205c48652 msgid "" "*Point* represents a point in the plane, defined by its x and y " "coordinates." msgstr "*Point* 는 x 및 y 좌표로 정의되는 평면상의 점을 나타냅니다." #: ../../point.rst:12 d95d005e957741acbcc453b2978ab474 msgid "**Attribute / Method**" msgstr "**속성 / 메서드**" #: ../../point.rst:12 6cc17250feda46f3895c61daf01ae9ef msgid "**Description**" msgstr "**설명**" #: ../../point.rst:14 41c8142652234b88ac19813753d3307e msgid ":meth:`Point.distance_to`" msgstr ":meth:`Point.distance_to`" #: ../../point.rst:14 261845b5a5b24bf0b064101ff507b23b msgid "calculate distance to point or rect" msgstr "점 또는 사각형까지의 거리 계산" #: ../../point.rst:15 4aa6b4f0719c46e498b43fe18d24f3eb msgid ":meth:`Point.norm`" msgstr ":meth:`Point.norm`" #: ../../point.rst:15 bb965571d49042f990f2ce83a5b1d501 msgid "the Euclidean norm" msgstr "유클리드 노름" #: ../../point.rst:16 8fa73d7331154012aedebe7f5f583ef0 msgid ":meth:`Point.transform`" msgstr ":meth:`Point.transform`" #: ../../point.rst:16 513606c9c9c24e929a77cffeb961406c msgid "transform point with a matrix" msgstr "행렬로 점 변환" #: ../../point.rst:17 2cb5652a207046aabd4833605b0db9a7 msgid ":attr:`Point.abs_unit`" msgstr ":attr:`Point.abs_unit`" #: ../../point.rst:17 a5938582888c4a3bb9c18a1c3f20c2e8 msgid "same as unit, but positive coordinates" msgstr "unit과 동일하지만 좌표가 양수" #: ../../point.rst:18 3e5b94700abd4e9f9ee59f420160e03b msgid ":attr:`Point.unit`" msgstr ":attr:`Point.unit`" #: ../../point.rst:18 2b7bbc4e8d9b49fd90eba605096d6695 msgid "point coordinates divided by *abs(point)*" msgstr "*abs(point)* 로 나눈 점 좌표" #: ../../point.rst:19 31b75b9a5271468b91957b2b1e4f4cdc msgid ":attr:`Point.x`" msgstr ":attr:`Point.x`" #: ../../point.rst:19 62613a63800c42a9b2e4b7e25ce06a1b msgid "the X-coordinate" msgstr "X 좌표" #: ../../point.rst:20 03bda37b4f4e43d5b2c87664d47e7c88 msgid ":attr:`Point.y`" msgstr ":attr:`Point.y`" #: ../../point.rst:20 1f7a039317c9403b9eef49abcffc3c17 msgid "the Y-coordinate" msgstr "Y 좌표" #: ../../point.rst:23 226585c9d32d4bdda8ea50151987bb6f msgid "**Class API**" msgstr "**클래스 API**" #: ../../point.rst:35 52e6fd50060a435cbcd1ea5ea07199d9 msgid "Overloaded constructors." msgstr "오버로드된 생성자." #: ../../point.rst:37 858213bf59564a6493343f329aa59c60 msgid "Without parameters, *Point(0, 0)* will be created." msgstr "매개변수 없이 *Point(0, 0)* 이 생성됩니다." #: ../../point.rst:39 fe4c165d5aa24d3a979783344bfd9ac0 msgid "" "With another point specified, a **new copy** will be created, " "\"sequence\" is a Python sequence of 2 numbers (see " ":ref:`SequenceTypes`)." msgstr "다른 점이 지정되면 **새 복사본** 이 생성됩니다. \"sequence\"는 2개의 숫자로 구성된 Python 시퀀스입니다(:ref:`SequenceTypes` 참조)." #: ../../point.rst 0eddda1bb6c54ccaa7d284736b29da50 #: 3b9ed60226ef48f0a657c5ba46c27350 c7f85b4fbec2467896a422f72188865d msgid "Parameters" msgstr "매개변수" #: ../../point.rst:41 97152760b7ba410cb622804600ef1a35 msgid "x coordinate of the point" msgstr "점의 x 좌표" #: ../../point.rst:43 7926764c81784f70845fd05cb89d5865 msgid "y coordinate of the point" msgstr "점의 y 좌표" #: ../../point.rst:47 5c3faa24b7e144068803db83b33fe793 msgid "" "Calculate the distance to *x*, which may be :data:`point_like` or " ":data:`rect_like`. The distance is given in units of either pixels " "(default), inches, centimeters or millimeters." msgstr "*x* 까지의 거리를 계산합니다. *x* 는 :data:`point_like` 또는 :data:`rect_like` 일 수 있습니다. 거리는 픽셀(기본값), 인치, 센티미터 또는 밀리미터 단위로 제공됩니다." #: ../../point.rst:49 44d8777c04344d47bc4a9242808880d1 msgid "to which to compute the distance." msgstr "거리를 계산할 대상." #: ../../point.rst:51 91e44f65560e4211accb6c725eebfdd6 msgid "the unit to be measured in. One of \"px\", \"in\", \"cm\", \"mm\"." msgstr "측정 단위. \"px\", \"in\", \"cm\", \"mm\" 중 하나." #: ../../point.rst 64687f2c94ef4b5ba2750e3eb184ad05 #: cd80063c5dc9498cbbdd25b759d31cdb msgid "Return type" msgstr "반환 유형" #: ../../point.rst a750839310d34c5d887db8268777489a msgid "Returns" msgstr "반환값" #: ../../point.rst:54 bc0f187b31f44a7181e31d08f7c53a82 msgid "" "the distance to *x*. If this is :data:`rect_like`, then the distance * " "is the length of the shortest line connecting to one of the rectangle " "sides * is calculated to the **finite version** of it * is zero if it " "**contains** the point" msgstr "" #: ../../point.rst:54 ae37d128ae1440f3bbd8ed1ea99f2152 msgid "the distance to *x*. If this is :data:`rect_like`, then the distance" msgstr "*x* 까지의 거리. 이것이 :data:`rect_like` 인 경우, 거리는" #: ../../point.rst:56 9ee6925c977945fe973ed9ab955366b2 msgid "" "is the length of the shortest line connecting to one of the rectangle " "sides" msgstr "사각형의 한 변에 연결하는 가장 짧은 선의 길이" #: ../../point.rst:57 3081d399626b49c987de03dbfa3d0ff5 msgid "is calculated to the **finite version** of it" msgstr "그것의 **유한 버전** 에 대해 계산됨" #: ../../point.rst:58 c71eaa596c2c423b862c9e70cb89f044 msgid "is zero if it **contains** the point" msgstr "점을 **포함** 하면 0" #: ../../point.rst:62 a6403033f7bf44a591174a022d0fdf1c msgid "New in version 1.16.0" msgstr "버전 1.16.0에서 새로 추가됨" #: ../../point.rst:64 7ece798ec8144d4692eb9a2959a40823 msgid "" "Return the Euclidean norm (the length) of the point as a vector. Equals " "result of function *abs()*." msgstr "점의 유클리드 노름(길이)을 벡터로 반환합니다. 함수 *abs()* 의 결과와 같습니다." #: ../../point.rst:68 f946cd0be509442bb0d77202325e2f96 msgid "Apply a matrix to the point and replace it with the result." msgstr "점에 행렬을 적용하고 결과로 대체합니다." #: ../../point.rst:70 97f1624c012a40e1b233376529f768b0 msgid "The matrix to be applied." msgstr "적용할 행렬." #: ../../point.rst:72 ../../point.rst:80 ../../point.rst:86 #: 18880915c78345d4a3e9807be13f50b7 52b88570e26b4eb5b5d6335523021f5f #: aab72bb00a464b30aa87b8638935ebd6 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../point.rst:76 348afd234c5c4c98ba5a47b9d5463fbb msgid "" "Result of dividing each coordinate by *norm(point)*, the distance of the " "point to (0,0). This is a vector of length 1 pointing in the same " "direction as the point does. Its x, resp. y values are equal to the " "cosine, resp. sine of the angle this vector (and the point itself) has " "with the x axis." msgstr "각 좌표를 *norm(point)*, 점에서 (0,0)까지의 거리로 나눈 결과입니다. 이것은 점과 같은 방향을 가리키는 길이 1의 벡터입니다. x, 각각 y 값은 이 벡터(및 점 자체)가 x축과 이루는 각도의 코사인, 각각 사인과 같습니다." #: ../../point.rst 68c8e993f1924162940b72535b1ce094 #: 74cca4c04a7c48d1a05b1cef455309b7 8ab750f04c354beda9b8193eb29e148a #: c3fab6e7e5714f6cb98f51b356a62c80 msgid "type" msgstr "유형" #: ../../point.rst:84 1c2c3c05d9164c73a34b01b96b77e536 msgid "" "Same as :attr:`unit` above, replacing the coordinates with their absolute" " values." msgstr "위의 :attr:`unit` 과 동일하지만 좌표를 절댓값으로 대체합니다." #: ../../point.rst:90 fd219a7540914e5ea48f7ac85865752a msgid "The x coordinate" msgstr "x 좌표" #: ../../point.rst:92 ../../point.rst:98 2782c521357b46fcb493227c412705b4 #: 7c544b58e0744796b55d935cf4074748 msgid "float" msgstr "float" #: ../../point.rst:96 49f24b3a0ef74f0c936055a979a0c047 msgid "The y coordinate" msgstr "y 좌표" #: ../../point.rst:102 89afd299e213428fb3ff2efbf34ee8cf msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "이 클래스는 Python 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 액세스할 수도 있습니다. :ref:`SequenceTypes` 도 참조하세요." #: ../../point.rst:103 211bda314be541968172253f25a72895 msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "사각형은 산술 연산자와 함께 사용할 수 있습니다 -- :ref:`Algebra` 장을 참조하세요." #: ../../footer.rst:46 065c44f95f8c488584785e74c127cd30 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/pymupdf-layout/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 26c7f492ac6349fe997fad9d41aabea5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 4231d660381d4fa5b43b5d8b068e8dfa msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8bba0218b1e445b192946cba4c548076 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../pymupdf-layout/index.rst:8 65880921881d4c9a95f25a114c1617cc msgid "PyMuPDF Layout" msgstr "PyMuPDF Layout" #: ../../pymupdf-layout/index.rst:11 26826b75387e4aadb2a29e8f577d4b8a msgid "" "|PyMuPDF Layout| is a lightweight layout analysis extension for |PyMuPDF|" " that turns PDFs into clean, structured data with minimal setup. It’s " "fast, accurate, and efficient without any GPU requirement." msgstr "|PyMuPDF Layout| 는 |PyMuPDF| 를 위한 경량 레이아웃 분석 확장으로, 최소한의 설정으로 PDF를 깔끔하고 구조화된 데이터로 변환합니다. GPU 요구 사항 없이 빠르고 정확하며 효율적입니다." #: ../../pymupdf-layout/index.rst:13 20fc4e9d5eae44d58cced93202624c15 msgid "" "It is an optional, but recommended, addition to the |PyMuPDF| library " "especially if you are required to more accurately extract structured data" " with better semantic information." msgstr "이것은 |PyMuPDF| 라이브러리에 대한 선택적이지만 권장되는 추가 기능이며, 특히 더 나은 의미 정보로 구조화된 데이터를 더 정확하게 추출해야 하는 경우에 유용합니다." #: ../../pymupdf-layout/index.rst:17 6cb4d2e97d464990a633d2defd97698e msgid "Installing" msgstr "설치" #: ../../pymupdf-layout/index.rst:19 85aefd1baecd485b800f2238aba711c7 msgid "Install from |PyPI| with::" msgstr "|PyPI| 에서 설치합니다::" #: ../../pymupdf-layout/index.rst:28 5e49fc1022b0491e968e6dac9a6ebd28 msgid "Using" msgstr "사용" #: ../../pymupdf-layout/index.rst:31 c4caa7b3525f461385db5339599b8e02 msgid "" "In nutshell, |PyMuPDF Layout| detects the layout to extract, but we need " "|PyMuPDF4LLM| for the API interface. This provides us with options to " "extract document content as |Markdown|, |JSON| or |TXT|." msgstr "요약하면, |PyMuPDF Layout| 는 추출할 레이아웃을 감지하지만 API 인터페이스를 위해 |PyMuPDF4LLM| 이 필요합니다. 이것은 문서 콘텐츠를 |Markdown|, |JSON| 또는 |TXT| 로 추출하는 옵션을 제공합니다." #: ../../pymupdf-layout/index.rst:33 2851cd8bd3374a3c8fc60a4a0fe524e8 msgid "" "Let's set up the Python coding environment to get started and open a PDF " "then we'll move on to the semantic data extraction." msgstr "시작하기 위해 Python 코딩 환경을 설정하고 PDF를 연 다음 의미 데이터 추출로 넘어가겠습니다." #: ../../pymupdf-layout/index.rst:36 6a1648fb91cc454788a795ffc391432a msgid "Register packages and open a PDF" msgstr "패키지 등록 및 PDF 열기" #: ../../pymupdf-layout/index.rst:38 1ba188d096bc425abbfee2ba07430823 msgid "First up let's import the libraries and open a sample document::" msgstr "먼저 라이브러리를 가져오고 샘플 문서를 엽니다::" #: ../../pymupdf-layout/index.rst:44 d7900ddabe0644c09c53ba9fb57126b0 msgid "" "Note, in the above code, that |PyMuPDF Layout| must be imported as shown " "and before importing |PyMuPDF4LLM| to activate |PyMuPDF|'s layout feature" " and make it available to |PyMuPDF4LLM|." msgstr "위 코드에서 |PyMuPDF Layout| 는 표시된 대로 가져와야 하며, |PyMuPDF| 의 레이아웃 기능을 활성화하고 |PyMuPDF4LLM| 에서 사용할 수 있도록 하려면 |PyMuPDF4LLM| 를 가져오기 전에 가져와야 합니다." #: ../../pymupdf-layout/index.rst:46 7b66dd7c7a164f99b1fd0113f2ccf699 msgid "" "Omitting the first line would cause execution of standard |PyMuPDF4LLM| -" " without the layout feature!" msgstr "첫 번째 줄을 생략하면 레이아웃 기능 없이 표준 |PyMuPDF4LLM| 이 실행됩니다!" #: ../../pymupdf-layout/index.rst:49 a21b9bc7b3844b0ab455c3f364a2057f msgid "Extract the structured data" msgstr "구조화된 데이터 추출" #: ../../pymupdf-layout/index.rst:51 35bc60862bb24334a75b7dc95b60156f msgid "" "We've activated the |PyMuPDF Layout| library and we've loaded a document," " next let's extract the structured data. This is now like a super-charged" " version of standard |PyMuPDF4LLM| with ``Layout`` working behind the " "scenes combining heuristics with machine learning - for better extraction" " results." msgstr "|PyMuPDF Layout| 라이브러리를 활성화하고 문서를 로드했으므로, 이제 구조화된 데이터를 추출하겠습니다. 이것은 이제 휴리스틱과 머신러닝을 결합하여 배후에서 작동하는 ``Layout`` 을 가진 표준 |PyMuPDF4LLM| 의 강화된 버전과 같습니다 -- 더 나은 추출 결과를 위해." #: ../../pymupdf-layout/index.rst:54 8fabaa7045ea40bca50d9b6cf1904b2b msgid "Extract as Markdown" msgstr "Markdown 으로 추출" #: ../../pymupdf-layout/index.rst:62 253f86c879cd4cfda51045e1311a3cba msgid "Extract as JSON" msgstr "JSON 으로 추출" #: ../../pymupdf-layout/index.rst:70 8da4947d5b974f24803ba5ed16e8cd77 msgid "Extract as TXT" msgstr "TXT 로 추출" #: ../../pymupdf-layout/index.rst:78 5bbe37c28031413fa4f86978d66b0161 msgid "" "Please refer top the full :ref:`PyMuPDF4LLM API ` for " "more." msgstr "자세한 내용은 전체 :ref:`PyMuPDF4LLM API ` 를 참조하세요." #: ../../pymupdf-layout/index.rst:80 6eedc55b27574fb583b04a9b9f3e3f55 msgid "Finally we can save the output to an external file as follows::" msgstr "마지막으로 다음과 같이 출력을 외부 파일에 저장할 수 있습니다::" #: ../../pymupdf-layout/index.rst:88 9bdb3f269e1c497e91d97cdc3a687bff msgid "Headers & Footers" msgstr "헤더 및 푸터" #: ../../pymupdf-layout/index.rst:91 c239bc0bbbd64d318e6e8fdc55d1efbe msgid "" "Many documents will have header and footer information on each page of a " "PDF which you may or may not want to include. This information can be " "repetitive and simply not needed ( e.g. the same logo and document title " "or page number information is not always really important when it comes " "to extracting the document content )." msgstr "많은 문서는 PDF의 각 페이지에 헤더 및 푸터 정보가 있으며, 이를 포함할 수도 있고 포함하지 않을 수도 있습니다. 이 정보는 반복적일 수 있으며 단순히 필요하지 않을 수 있습니다(예: 동일한 로고 및 문서 제목 또는 페이지 번호 정보는 문서 콘텐츠를 추출할 때 항상 중요하지 않습니다)." #: ../../pymupdf-layout/index.rst:93 ee2ea44ed53e4d95860be54bee8ead00 msgid "" "|PyMuPDF Layout| is trained in detecting these typical document elements " "and able to omit them." msgstr "|PyMuPDF Layout| 는 이러한 일반적인 문서 요소를 감지하도록 훈련되어 있으며 이를 생략할 수 있습니다." #: ../../pymupdf-layout/index.rst:95 2e53e75f3b83455ab9f885efaae230c7 msgid "" "So in this case we can adjust our API calls to ignore these elements as " "follows::" msgstr "따라서 이 경우 다음과 같이 API 호출을 조정하여 이러한 요소를 무시할 수 있습니다::" #: ../../pymupdf-layout/index.rst:103 fc82782444984a34ab18e40f5123faeb msgid "" "Please note that page ``header`` / ``footer`` exclusion is not applicable" " to JSON output as it aims to always represent all data for the included " "pages. Please refer to the full :ref:`PyMuPDF4LLM API ` " "for more." msgstr "페이지 ``header`` / ``footer`` 제외는 포함된 페이지의 모든 데이터를 항상 나타내는 것을 목표로 하므로 JSON 출력에는 적용되지 않습니다. 자세한 내용은 전체 :ref:`PyMuPDF4LLM API ` 를 참조하세요." #: ../../pymupdf-layout/index.rst:106 a00239ede95b43319833ba01713ce8d7 msgid "Extending Capability" msgstr "기능 확장" #: ../../pymupdf-layout/index.rst:109 f3bec49e1ee042caad2ba1f1f8d07230 msgid "Using with Pro" msgstr "Pro 와 함께 사용" #: ../../pymupdf-layout/index.rst:111 1a6a4c0ada2842d588768a849fe3c7f3 msgid "" "We are able to extend |PyMuPDF Layout| to work with |PyMuPDF Pro| and " "thus increase our capability by allowing Office documents to be provided " "as input files. In this case all we have to do is to add the import for " "|PyMuPDF Pro| and unlock it::" msgstr "" "|PyMuPDF Layout| 를 |PyMuPDF Pro| 와 함께 작동하도록 확장하여 Office 문서를 입력 파일로 제공할 수 있게 하여 기능을 향상시킬 수 있습니다. 이 경우 |PyMuPDF Pro| 를 가져오고 잠금을 해제하기만 하면 됩니다::" #: ../../pymupdf-layout/index.rst:118 695ebd9778304b3da362108ea2e9695e msgid "Now we can happily load Office files and convert them as follows::" msgstr "이제 Office 파일을 로드하고 다음과 같이 변환할 수 있습니다::" #: ../../pymupdf-layout/index.rst:126 14fdcdcd4aab4335919c50efc4749185 msgid "OCR support" msgstr "OCR 지원" #: ../../pymupdf-layout/index.rst:128 99eb4f65329d45c7bb6eaf035c255259 msgid "" "The new layout-sensitive |PyMuPDF4LLM| version also evaluates whether a " "page would benefit from applying OCR to it. If its heuristics come to " "this conclusion, the built-in Tesseract-OCR module is automatically " "invoked. Its results are then handled like normal page content." msgstr "새로운 레이아웃 인식 PyMuPDF4LLM 버전은 페이지에 OCR을 적용하는 것이 유익한지도 평가합니다. 휴리스틱이 이 결론에 도달하면 내장 Tesseract-OCR 모듈이 자동으로 호출됩니다. 그 결과는 일반 페이지 콘텐츠처럼 처리됩니다." #: ../../pymupdf-layout/index.rst:130 cdbf9a9f1f5341cc96aaaa1a6a74434f msgid "" "If a page contains (roughly) no text at all, but is covered with images " "or many character-sized vectors, a check is made using `OpenCV " "`_ whether text is *probably* " "detectable on the page at all. This is done to tell apart image-based " "text from ordinary pictures (like photographs)." msgstr "" "페이지에 (대략적으로) 텍스트가 전혀 없지만 이미지나 많은 문자 크기의 벡터로 덮여 있는 경우, `OpenCV `_ 를 사용하여 페이지에 텍스트가 *아마도* 감지 가능한지 확인합니다. 이것은 이미지 기반 텍스트를 일반 사진(예: 사진)과 구별하기 위해 수행됩니다." #: ../../pymupdf-layout/index.rst:132 8c8ba1c1b2bc4875b04cc60b98293a08 msgid "" "If the page does contain text but too many characters are unreadable " "(like \"�����\"), OCR is also executed, but **for the affected text areas" " only** -- not the full page. This way, we avoid losing already existing " "text and other content like images and vectors." msgstr "" "페이지에 텍스트가 포함되어 있지만 읽을 수 없는 문자가 너무 많은 경우(예: \"\"), OCR도 실행되지만 **영향을 받은 텍스트 영역에만** -- 전체 페이지가 아닙니다. 이렇게 하면 이미 존재하는 텍스트와 이미지 및 벡터와 같은 다른 콘텐츠를 잃지 않습니다." #: ../../pymupdf-layout/index.rst:134 225a390ebce94321a090f94ab2165c16 msgid "" "For these heuristics to work we need both, an existing :ref:`Tesseract " "installation ` and the availability of `OpenCV " "`_ in the Python environment. If" " either is missing, no OCR is attempted at all." msgstr "" "이러한 휴리스틱이 작동하려면 기존 Tesseract 설치와 Python 환경에서 OpenCV의 가용성이 모두 필요합니다. 둘 중 하나라도 없으면 OCR이 전혀 시도되지 않습니다." #: ../../pymupdf-layout/index.rst:136 08b0b8dca54f41e4a81739a6b2fd1324 msgid "" "The decision tree for whether OCR is actually used or not depends on the " "following:" msgstr "" "OCR이 실제로 사용되는지 여부에 대한 결정 트리는 다음에 따라 달라집니다:" #: ../../pymupdf-layout/index.rst:138 8cd3ca3cdb2c404eb48ad42a553220de msgid ":ref:`PyMuPDF Layout is imported `" msgstr ":ref:`PyMuPDF Layout이 가져와짐 `" #: ../../pymupdf-layout/index.rst:140 10ee5e795c7446e8b3403d85522a49cd msgid "" "In the :ref:`PyMuPDF4LLM API ` you have `use_ocr` " "enabled (this is set to `True` by default)" msgstr "" ":ref:`PyMuPDF4LLM API ` 에서 `use_ocr` 이 활성화되어 있음(기본값은 `True` 로 설정됨)" #: ../../pymupdf-layout/index.rst:142 a91c79870eec43b4b647375636f046ea msgid ":ref:`Tesseract is correctly installed `" msgstr ":ref:`Tesseract가 올바르게 설치됨 `" #: ../../pymupdf-layout/index.rst:144 32944c44045a42d29563e3e93a1b1d98 msgid "" "`OpenCV `_ is available in your " "Python environment" msgstr "" "`OpenCV `_ 가 Python 환경에서 사용 가능함" #: ../../pymupdf-layout/index.rst:154 fddcc1ea96e64c658554704bb141490b msgid "|PyMuPDF Layout| and |PyMuPDF4LLM| parameter caveats" msgstr "|PyMuPDF Layout| 및 |PyMuPDF4LLM| 매개변수 주의사항" #: ../../pymupdf-layout/index.rst:156 b7f33df2c3974ea1bbead613286f3639 msgid "" "If you have imported ``pymupdf.layout``, |PyMuPDF4LLM| changes its " "behavior in various areas quite significantly. New methods become " "available and also some features are no longer supported. Please visit " "`this site `_ for" " a detailed description of the changes. That web site is being kept up to" " date while we continue to work on improvements." msgstr "" "``pymupdf.layout`` 를 가져온 경우, |PyMuPDF4LLM| 는 다양한 영역에서 동작이 상당히 크게 변경됩니다. 새로운 메서드가 사용 가능해지고 일부 기능은 더 이상 지원되지 않습니다. 변경 사항에 대한 자세한 설명은 `이 사이트 `_ 를 방문하세요. 개선 작업을 계속하는 동안 해당 웹사이트는 최신 상태로 유지됩니다." #: ../../footer.rst:48 fcc43bbf382644f6928a40bc9aea37c1 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." #~ msgid "" #~ "We are able to extend |PyMuPDF " #~ "Layout| to work with |PyMuPDF Pro| " #~ "and thus increase our capability by " #~ "allowing Office documents to be provided" #~ " as input files. In this case " #~ "all we have to do is to " #~ "include the import for |PyMuPDF Pro| " #~ "and unlock it before we import &" #~ " activate |PyMuPDF Layout|::" #~ msgstr "" #~ msgid "If Tesseract is not installed on your platform, no OCR is attempted." #~ msgstr "" #~ msgid "PyMuPDF Layout and parameter caveats" #~ msgstr "" #~ msgid "" #~ "|PyMuPDF Layout| uses |PyMuPDF4LLM| for " #~ "its interface. However, if you have " #~ "imported ``Layout`` then the following " #~ "caveats apply to the method parameters:" #~ msgstr "" #~ msgid "Parameter" #~ msgstr "" #~ msgid "to_markdown" #~ msgstr "" #~ msgid "to_text" #~ msgstr "" #~ msgid "to_json" #~ msgstr "" #~ msgid "Comments" #~ msgstr "" #~ msgid "doc" #~ msgstr "" #~ msgid "✔️" #~ msgstr "" #~ msgid "header" #~ msgstr "" #~ msgid "ignored" #~ msgstr "" #~ msgid "**new:** replaces ``margins``" #~ msgstr "" #~ msgid "footer" #~ msgstr "" #~ msgid "detect_bg_color" #~ msgstr "" #~ msgid "❌" #~ msgstr "" #~ msgid "dpi" #~ msgstr "" #~ msgid "embed_images" #~ msgstr "" #~ msgid "extract_words" #~ msgstr "" #~ msgid "later" #~ msgstr "" #~ msgid "postponed" #~ msgstr "" #~ msgid "filename" #~ msgstr "" #~ msgid "fontsize_limit" #~ msgstr "" #~ msgid "obsolete" #~ msgstr "" #~ msgid "force_text" #~ msgstr "" #~ msgid "text in pictures is always ignored" #~ msgstr "" #~ msgid "graphics_limit" #~ msgstr "" #~ msgid "hdr_info" #~ msgstr "" #~ msgid "ignore_alpha" #~ msgstr "" #~ msgid "ignore_code" #~ msgstr "" #~ msgid "ignore_graphics" #~ msgstr "" #~ msgid "ignore_images" #~ msgstr "" #~ msgid "image_format" #~ msgstr "" #~ msgid "image_path" #~ msgstr "" #~ msgid "image_size_limit" #~ msgstr "" #~ msgid "margins" #~ msgstr "" #~ msgid "page_chunks" #~ msgstr "" #~ msgid "page_height" #~ msgstr "" #~ msgid "page_separators" #~ msgstr "" #~ msgid "page_width" #~ msgstr "" #~ msgid "pages" #~ msgstr "" #~ msgid "show_progress" #~ msgstr "" #~ msgid "table_strategy" #~ msgstr "" #~ msgid "use_glyphs" #~ msgstr "" #~ msgid "always show �" #~ msgstr "" #~ msgid "write_images" #~ msgstr "" #~ msgid "" #~ "Please note that page ``header`` / " #~ "``footer`` exclusion is not applicable " #~ "to JSON output as it aims to " #~ "always represent all data for the " #~ "included pages. Please refer top the " #~ "full :ref:`PyMuPDF4LLM API `" #~ " for more." #~ msgstr "" #~ msgid "" #~ "The new layout-sensitive PyMuPDF4LLM " #~ "version also evaluates whether a page" #~ " would benefit from applying OCR to" #~ " it. If its heuristics come to " #~ "this conclusion, the built-in " #~ "Tesseract-OCR module is automatically " #~ "invoked. Its results are then handled" #~ " like normal page content." #~ msgstr "" #~ msgid "" #~ "If a page contains (roughly) no " #~ "text at all, but is covered with" #~ " images or many character-sized " #~ "vectors, a check is made using " #~ "`OpenCV `_ " #~ "whether text is *probably* detectable on" #~ " the page at all. This is done" #~ " to tell apart image-based text " #~ "from ordinary pictures (like photographies)." #~ msgstr "" #~ msgid "" #~ "For these heuristics to work we " #~ "need both, an existing Tesseract " #~ "installation and the availability of " #~ "OpenCV in the Python environment. If " #~ "either is missing, no OCR is " #~ "attempted at all." #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/pymupdf-pro/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ff337a9fa03e4fd6a3d7aaec4930912f msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 b9e1a76b005b46c7a35e27ac36b668dd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 5b66ad60d8974f3fb8061286f4b23214 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../pymupdf-pro/index.rst:8 07624f1e03dd463c99bf82f95b91a35e msgid "PyMuPDF Pro" msgstr "PyMuPDF Pro" #: ../../pymupdf-pro/index.rst:11 879666c817c94726a9df9e5880d5425a msgid "|PyMuPDF Pro| is a set of *commercial extensions* for |PyMuPDF|." msgstr "|PyMuPDF Pro| 는 |PyMuPDF| 를 위한 *상용 확장* 세트입니다." #: ../../pymupdf-pro/index.rst:13 ae90e3fd121f4e04a0a9ecd747514717 msgid "" "Enhance |PyMuPDF| capability with **Office** document support & " "**RAG/LLM** integrations." msgstr "**Office** 문서 지원 및 **RAG/LLM** 통합으로 |PyMuPDF| 기능을 향상시킵니다." #: ../../pymupdf-pro/index.rst:15 aed2c2f793d348d8bf6eb0811eecb47a msgid "" "Enables Office document handling, including ``doc``, ``docx``, ``hwp``, " "``hwpx``, ``ppt``, ``pptx``, ``xls``, ``xlsx``, and others." msgstr "``doc``, ``docx``, ``hwp``, ``hwpx``, ``ppt``, ``pptx``, ``xls``, ``xlsx`` 등을 포함한 Office 문서 처리를 활성화합니다." #: ../../pymupdf-pro/index.rst:16 997a064abea1408d914a30cae0872289 msgid "Supports text and table extraction, document conversion and more." msgstr "텍스트 및 테이블 추출, 문서 변환 등을 지원합니다." #: ../../pymupdf-pro/index.rst:17 7ee872ab1d5c4992b77ebbf8c3cf149c msgid "Includes the commercial version of |PyMuPDF4LLM|." msgstr "|PyMuPDF4LLM| 의 상용 버전을 포함합니다." #: ../../pymupdf-pro/index.rst:19 83cc2a9a8a854516b90d26d2841aad02 msgid "" "To enquire about obtaining a commercial license, then `use this contact " "page `_." msgstr "상용 라이선스 취득에 대한 문의는 `이 연락처 페이지 `_ 를 사용하세요." #: ../../pymupdf-pro/index.rst:24 f0a9c51213864c898871ca01453557e1 msgid "" "A licensed version of |PyMuPDF Pro| also gives you a licensed version of " "|PyMuPDF4LLM|. If you are interested in using the |PyMuPDF4LLM| package " "you should install it separately." msgstr "|PyMuPDF Pro| 의 라이선스 버전은 |PyMuPDF4LLM| 의 라이선스 버전도 제공합니다. |PyMuPDF4LLM| 패키지를 사용하려면 별도로 설치해야 합니다." #: ../../pymupdf-pro/index.rst:28 4a1d503fea744f4ba62d54e186f02d87 msgid "Platform support" msgstr "플랫폼 지원" #: ../../pymupdf-pro/index.rst:30 78076f4c0458474f913d726a0fb0e0bc msgid "Available for these platforms only:" msgstr "다음 플랫폼에서만 사용 가능:" #: ../../pymupdf-pro/index.rst:32 ed38f46c156840689524033bf7da829d msgid "Windows x86_64." msgstr "Windows x86_64." #: ../../pymupdf-pro/index.rst:33 259897daea654cb8a90bc8e65c6e4f76 msgid "Linux x86_64 (glibc)." msgstr "Linux x86_64 (glibc)." #: ../../pymupdf-pro/index.rst:34 1923df7caa0b4f04a3b259b4c866ba6e msgid "MacOS x86_64." msgstr "MacOS x86_64." #: ../../pymupdf-pro/index.rst:35 fd5d8bf6fc12467a826ce8202a1d2ec3 msgid "MacOS arm64." msgstr "MacOS arm64." #: ../../pymupdf-pro/index.rst:39 f2952d3e2f47435bb640b83bd15721c4 msgid "Office file support" msgstr "Office 파일 지원" #: ../../pymupdf-pro/index.rst:41 7c38d85a3c164f3a90d869b52ef96eb1 msgid "" "In addition to the `standard file types supported by PyMuPDF " "`, |PyMuPDF Pro| supports:" msgstr "`PyMuPDF 가 지원하는 표준 파일 타입 ` 외에도 |PyMuPDF Pro| 는 다음을 지원합니다:" #: ../../pymupdf-pro/index.rst:46 67438064f36f474186aeb4fbfb093d31 msgid "**DOC/DOCX**" msgstr "**DOC/DOCX**" #: ../../pymupdf-pro/index.rst:47 9ab995c3f8214b9ab04698d96a84b4e2 msgid "**XLS/XLSX**" msgstr "**XLS/XLSX**" #: ../../pymupdf-pro/index.rst:48 9e2c997d6ac44df79efb09f56a593cbb msgid "**PPT/PPTX**" msgstr "**PPT/PPTX**" #: ../../pymupdf-pro/index.rst:49 28e3c375094f40258eea347ffcaf5a8f msgid "**HWP/HWPX**" msgstr "**HWP/HWPX**" #: ../../pymupdf-pro/index.rst:66 9ccca49db9fb4df98d9464183c30d68c msgid "Usage" msgstr "사용법" #: ../../pymupdf-pro/index.rst:69 edd61111e81a46198c9ef49a53e782b0 msgid "Installation" msgstr "설치" #: ../../pymupdf-pro/index.rst:71 f961577e8ffd49469227db2bbdcd9bb2 msgid "Install via pip with:" msgstr "pip 를 통해 설치합니다:" #: ../../pymupdf-pro/index.rst:79 699e6bf8334b4cf8b23793ff0e45ccbf msgid "Loading an **Office** document" msgstr "**Office** 문서 로드" #: ../../pymupdf-pro/index.rst:81 08e39b8bfc514665aafb5c1aa211bcfc msgid "" "Import |PyMuPDF Pro| and you can then reference **Office** documents " "directly, e.g.:" msgstr "|PyMuPDF Pro| 를 가져오면 **Office** 문서를 직접 참조할 수 있습니다. 예:" #: ../../pymupdf-pro/index.rst:92 e21e201731344245a88c7e6bdd9c2dc2 msgid "" "All standard |PyMuPDF| functionality is exposed as expected - |PyMuPDF " "Pro| handles the extended **Office** file types" msgstr "모든 표준 |PyMuPDF| 기능이 예상대로 노출됩니다 - |PyMuPDF Pro| 는 확장된 **Office** 파일 타입을 처리합니다" #: ../../pymupdf-pro/index.rst:95 32d84f02e19a40b5bb42c1d26a81afe5 msgid "" "From then on you can work with document pages just as you would do " "normally, but with respect to the `restrictions " "`." msgstr "그때부터 `제한 사항 ` 을 고려하여 일반적으로 수행하는 것처럼 문서 페이지로 작업할 수 있습니다." #: ../../pymupdf-pro/index.rst:99 36c298b59008468ab926c22842511b25 msgid "Converting an **Office** document to |PDF|" msgstr "**Office** 문서를 |PDF| 로 변환" #: ../../pymupdf-pro/index.rst:101 c01333a0e65f42d29d469ace26b3fd91 msgid "" "The following code snippet can convert your **Office** document to |PDF| " "format:" msgstr "다음 코드 조각은 **Office** 문서를 |PDF| 형식으로 변환할 수 있습니다:" #: ../../pymupdf-pro/index.rst:119 cd5eb6eaf8094ced89572a48282454ca msgid "Restrictions" msgstr "제한 사항" #: ../../pymupdf-pro/index.rst:122 badbfba0a2a0495290e9594585aaefc9 msgid "" "|PyMuPDF Pro| functionality is restricted without a license key as " "follows:" msgstr "라이선스 키 없이 |PyMuPDF Pro| 기능은 다음과 같이 제한됩니다:" #: ../../pymupdf-pro/index.rst:124 0edbc072da504add956116e21d3eebde msgid "**Only the first 3 pages of any document will be available.**" msgstr "**모든 문서의 처음 3페이지만 사용할 수 있습니다.**" #: ../../pymupdf-pro/index.rst:126 6fa9f0d4dec94b3db782dacdc632f5a0 msgid "" "To unlock full functionality you should `obtain a trial key " "`_." msgstr "전체 기능을 잠금 해제하려면 `시험 키를 받으세요 `_." #: ../../pymupdf-pro/index.rst:132 ff0d00debbdb4746809d8750352f10bc msgid "Trial keys" msgstr "시험 키" #: ../../pymupdf-pro/index.rst:134 e689628360fa4b4497ccbb720dd0faca msgid "" "To obtain a license key `please fill out the form on this page " "`_. You will then have the trial key " "emailled to the address you submitted." msgstr "라이선스 키를 받으려면 `이 페이지의 양식을 작성하세요 `_. 그러면 제출한 주소로 시험 키가 이메일로 전송됩니다." #: ../../pymupdf-pro/index.rst:138 b4af428798424c3baae4771829727b28 msgid "Using a key" msgstr "키 사용" #: ../../pymupdf-pro/index.rst:141 6766aa2a1d144b81a15c3ad28ce403da msgid "Initialize |PyMuPDF Pro| with a key as follows:" msgstr "다음과 같이 키로 |PyMuPDF Pro| 를 초기화합니다:" #: ../../pymupdf-pro/index.rst:149 92e495f1e7934e1e83d346f56ab9833d msgid "" "This will allow you to evaluate the product for a limited time. If you " "want to use |PyMuPDF Pro| after this time you should then `enquire about " "obtaining a commercial license `_." msgstr "이것은 제한된 시간 동안 제품을 평가할 수 있게 해줍니다. 이 시간 이후에 |PyMuPDF Pro| 를 사용하려면 `상용 라이선스 취득에 대해 문의하세요 `_." #: ../../pymupdf-pro/index.rst:153 a394162132a04de092aabb5d2fcbc814 msgid "Fonts" msgstr "글꼴" #: ../../pymupdf-pro/index.rst:155 8e2db8a260ac4b8597a804b55d7ab547 msgid "" "By default `pymupdf.pro.unlock()` searches for all installed font " "directories." msgstr "기본적으로 `pymupdf.pro.unlock()` 은 설치된 모든 글꼴 디렉토리를 검색합니다." #: ../../pymupdf-pro/index.rst:157 e0cd7217fd79445ea7e79586abad31d1 msgid "This can be controlled with keyword-only args:" msgstr "키워드 전용 인수로 제어할 수 있습니다:" #: ../../pymupdf-pro/index.rst:159 879866813ec14fd08f5b249e833e7ee7 msgid "" "`fontpath`: specific font directories, either as a list/tuple or " "`os.sep`-separated string. If None (the default), we use " "`os.environ['PYMUPDFPRO_FONT_PATH']` if set." msgstr "`fontpath`: 특정 글꼴 디렉토리, list/tuple 또는 `os.sep` 로 구분된 문자열. None(기본값)인 경우 설정되어 있으면 `os.environ['PYMUPDFPRO_FONT_PATH']` 를 사용합니다." #: ../../pymupdf-pro/index.rst:161 5ca9e3934e6c4c91b603c12662c79cf6 msgid "" "`fontpath_auto`: Whether to append system font directories. If None (the " "default) we use true if `os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` is '1'." " If true we append all system font directories." msgstr "`fontpath_auto`: 시스템 글꼴 디렉토리를 추가할지 여부. None(기본값)인 경우 `os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` 가 '1'이면 true를 사용합니다. true이면 모든 시스템 글꼴 디렉토리를 추가합니다." #: ../../pymupdf-pro/index.rst:165 5ecf267b5f8f4e68be5f69f1cbee4782 msgid "" "Function `pymupdf.pro.get_fontpath()` returns a tuple of all font " "directories used by `unlock()`." msgstr "함수 `pymupdf.pro.get_fontpath()` 는 `unlock()` 에서 사용하는 모든 글꼴 디렉토리의 튜플을 반환합니다." #: ../../footer.rst:46 b26519c017c744e3b52c222b2633f6ed msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/pymupdf4llm/api.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2024, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.24.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" "Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 28d86985971f44c9b5c589f8ab54e80c msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 e7a5b73934cd435dbb28ac3030a6bc42 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "" "|PyMuPDF| 는 PDF(및 기타) 문서의 데이터 추출, 분석, 변환 및 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 92d346afb67b4f3ab88c5a1064a46694 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../pymupdf4llm/api.rst:27 4e5664b1124d48d18fd12e59b727a0bd msgid "API" msgstr "API" #: ../../pymupdf4llm/api.rst:30 e4fe663d1ee04cf7bbc808eeb9ce308b msgid "The |PyMuPDF4LLM| API" msgstr "|PyMuPDF4LLM| API" #: ../../pymupdf4llm/api.rst:35 4e2df9f8107d4db1a2347a4be75c0272 msgid "Prints the version of the library." msgstr "라이브러리의 버전을 출력합니다." #: ../../pymupdf4llm/api.rst:69 c21d1e47747e4a6eadd73614ff6f800a msgid "" "Reads the pages of the file and outputs the text of its pages in " "|Markdown| format. How this should happen in detail can be influenced by " "a number of parameters. Please note that **support for building page " "chunks** from the |Markdown| text is supported." msgstr "" "파일의 페이지를 읽고 |Markdown| 형식으로 페이지 텍스트를 출력합니다. 세부 사항은 여러 매개변수로 제어할 수 있습니다. |Markdown| 텍스트에서 **페이지 청크 구축 지원** 이 지원됩니다." #: ../../pymupdf4llm/api.rst 13d669ad26754dc0b5dd18b71aaaa6e7 #: 9f1452580faf4a6282a5888330a95503 9f18803cca3b49628d55a64c7a8473ee #: b1bbc30b869d4427932592ee651344a4 c3792e58bf894b75870f21f594a83813 #: c57820b438a34e958720773d86d8a687 msgid "Parameters" msgstr "매개변수" #: ../../pymupdf4llm/api.rst:71 ../../pymupdf4llm/api.rst:163 #: ../../pymupdf4llm/api.rst:184 1df54be04e4d4aaeac61cce4ba98817f #: 4632c24ae65b499e81a55a61b741ffba 835d293ddb884273a0d2f38bfd18e563 msgid "" "the file, to be specified either as a file path string, or as a |PyMuPDF|" " :class:`Document` (created via `pymupdf.open`). In order to use " "`pathlib.Path` specifications, Python file-like objects, documents in " "memory etc. you **must** use a |PyMuPDF| :class:`Document`." msgstr "" "파일 경로 문자열 또는 |PyMuPDF| :class:`Document` (`pymupdf.open` 으로 생성)로 지정할 파일입니다. `pathlib.Path` 사양, Python 파일과 같은 객체, 메모리의 문서 등을 사용하려면 **반드시** |PyMuPDF| :class:`Document` 를 사용해야 합니다." #: ../../pymupdf4llm/api.rst:73 5b01dd3e313a4f1183943c524048c4a3 msgid "" "|PyMuPDFLayoutMode_Ignored| does a simple check for the general " "background color of the pages (default is ``True``). If any text or " "vector has this color it will be ignored. May increase detection " "accuracy." msgstr "" "|PyMuPDFLayoutMode_Ignored| 페이지의 일반 배경색에 대한 간단한 확인을 수행합니다(기본값은 ``True``). 이 색상을 가진 텍스트나 벡터는 무시됩니다. 감지 정확도를 높일 수 있습니다." #: ../../pymupdf4llm/api.rst:75 f4d01e56b3794441a8802c4a80be94aa msgid "" "specify the desired image resolution in dots per inch. Relevant only if " "`write_images=True` or `embed_images=True`. Default value is 150." msgstr "" "인치당 도트 수로 원하는 이미지 해상도를 지정합니다. `write_images=True` 또는 `embed_images=True` 인 경우에만 관련됩니다. 기본값은 150입니다." #: ../../pymupdf4llm/api.rst:77 41ff8c59beb54152b76219649e55269d msgid "" "|PyMuPDFLayoutMode_Valid| use :ref:`OCR capability " "` to help analyse the page." msgstr "" "|PyMuPDFLayoutMode_Valid| 페이지 분석을 돕기 위해 :ref:`OCR 기능 ` 을 사용합니다." #: ../../pymupdf4llm/api.rst:79 d3e8adb5845748eeacc23caba37adfb9 msgid "" "|PyMuPDFLayoutMode_Valid| specify the desired image resolution in dots " "per inch for applying OCR to the intermediate image of the page. Default " "value is 400. Only relevant if the page has been determined to profit " "from OCR (no or few text, most of the page covered by images or " "character-like vectors, etc.). Large values may increase the OCR " "precision but increase memory requirements and processing time. There " "also is a risk of over-sharpening the image which may decrease OCR " "precision. So the default value should probably be sufficiently high." msgstr "" "|PyMuPDFLayoutMode_Valid| 페이지의 중간 이미지에 OCR을 적용하기 위한 인치당 도트 수로 원하는 이미지 해상도를 지정합니다. 기본값은 400입니다. 페이지가 OCR로 이익을 얻을 것으로 판단된 경우(텍스트가 없거나 적고, 페이지 대부분이 이미지나 문자와 같은 벡터로 덮인 경우 등)에만 관련됩니다. 큰 값은 OCR 정밀도를 높일 수 있지만 메모리 요구 사항과 처리 시간을 증가시킵니다. 이미지를 과도하게 선명하게 만들어 OCR 정밀도를 떨어뜨릴 위험도 있습니다. 따라서 기본값은 충분히 높아야 합니다." #: ../../pymupdf4llm/api.rst:81 9d41bfc8dacf4906862ed59207d58a4f msgid "" "like `write_images`, but images will be included in the markdown text as " "base64-encoded strings. Mutually exclusive with `write_images` and " "ignores `image_path`. This may drastically increase the size of your " "markdown text." msgstr "" "`write_images` 와 유사하지만 이미지가 base64 인코딩된 문자열로 마크다운 텍스트에 포함됩니다. `write_images` 와 상호 배타적이며 `image_path` 를 무시합니다. 마크다운 텍스트의 크기를 크게 증가시킬 수 있습니다." #: ../../pymupdf4llm/api.rst:83 cbd2e3785be64256b6c64d96627ce87c msgid "" "|PyMuPDFLayoutMode_Ignored| a value of `True` enforces `page_chunks=True`" " and adds key \"words\" to each page dictionary. Its value is a list of " "words as delivered by PyMuPDF's `Page` method `get_text(\"words\")`. The " "sequence of the words in this list is the same as the extracted text." msgstr "" "|PyMuPDFLayoutMode_Ignored| `True` 값은 `page_chunks=True` 를 강제하고 각 페이지 딕셔너리에 \"words\" 키를 추가합니다. 그 값은 |PyMuPDF| 의 `Page` 메서드 `get_text(\"words\")` 에서 제공하는 단어 목록입니다. 이 목록의 단어 순서는 추출된 텍스트와 동일합니다." #: ../../pymupdf4llm/api.rst:85 a9fcde34b67b4aac85960a2058a8384d msgid "" "Overwrites or sets the desired image file name of written images. Useful " "when the document is provided as a memory object (which has no inherent " "file name)." msgstr "" "작성된 이미지의 원하는 이미지 파일 이름을 덮어쓰거나 설정합니다. 문서가 메모리 객체로 제공되는 경우(고유한 파일 이름이 없음)에 유용합니다." #: ../../pymupdf4llm/api.rst:87 445155dce88c4e488ea537ff3be59de6 msgid "" "|PyMuPDFLayoutMode_Ignored| limit the font size to consider for text " "extraction. If the font size is lower than what is set then the text " "won't be considered for extraction. Default is `3`, meaning only text " "with a font size `>= 3` will be considered for extraction." msgstr "" "|PyMuPDFLayoutMode_Ignored| 텍스트 추출을 위해 고려할 폰트 크기를 제한합니다. 폰트 크기가 설정된 값보다 작으면 텍스트가 추출 대상에서 제외됩니다. 기본값은 `3` 이며, 폰트 크기가 `>= 3` 인 텍스트만 추출 대상으로 고려됩니다." #: ../../pymupdf4llm/api.rst:89 a09091d58eb74cb4953110f6516b8f92 msgid "" "|PyMuPDFLayoutMode_Valid| boolean to switch on/off page footer content. " "This parameter controls whether to include or omit footer text from all " "the document pages. Useful if the document has repetitive footer content " "which doesn't add any value to the overall extraction data. Default is " "`True` meaning that footer content will be considered." msgstr "" "|PyMuPDFLayoutMode_Valid| 페이지 푸터 콘텐츠를 켜거나 끄는 부울 값입니다. 이 매개변수는 모든 문서 페이지에서 푸터 텍스트를 포함할지 생략할지를 제어합니다. 문서에 반복적인 푸터 콘텐츠가 있어 전체 추출 데이터에 가치를 추가하지 않는 경우에 유용합니다. 기본값은 `True` 이며 푸터 콘텐츠가 고려됩니다." #: ../../pymupdf4llm/api.rst:91 18670d8b86384ed99d85b86b0328a4ca msgid "" "generate text output even when overlapping images / graphics. This text " "then appears after the respective image." msgstr "" "이미지/그래픽과 겹치는 경우에도 텍스트 출력을 생성합니다. 이 텍스트는 해당 이미지 뒤에 나타납니다." #: ../../pymupdf4llm/api.rst:93 30d505740e2243e4a965d5bed923e367 msgid "" "|PyMuPDFLayoutMode_Ignored| use this to limit dealing with excess amounts" " of vector graphics elements. Scientific documents, or pages simulating " "text via graphics commands may contain tens of thousands of these " "objects. As vector graphics are analyzed for multiple purposes, runtime " "may quickly become intolerable. With this parameter, all vector graphics " "will be ignored if their count exceeds the threshold." msgstr "" "|PyMuPDFLayoutMode_Ignored| 과도한 양의 벡터 그래픽 요소를 처리하는 것을 제한하는 데 사용합니다. 과학 문서나 그래픽 명령을 통해 텍스트를 시뮬레이션하는 페이지는 수만 개의 이러한 객체를 포함할 수 있습니다. 벡터 그래픽이 여러 목적으로 분석되므로 실행 시간이 빠르게 견딜 수 없게 될 수 있습니다. 이 매개변수를 사용하면 개수가 임계값을 초과하면 모든 벡터 그래픽이 무시됩니다." #: ../../pymupdf4llm/api.rst:95 f45e892b070e41909fee2c6af82edbe5 msgid "" "|PyMuPDFLayoutMode_Ignored| use this if you want to provide your own " "header detection logic. This may be a callable or an object having a " "method named `get_header_id`. It must accept a text span (a span " "dictionary as contained in :meth:`~.extractDICT`) and a keyword parameter" " \"page\" (which is the owning :ref:`Page ` object). It must return" " a string \"\" or up to 6 \"#\" characters followed by 1 space. If " "omitted (`None`), a full document scan will be performed to find the most" " popular font sizes and derive header levels based on them. To completely" " avoid this behavior specify `hdr_info=lambda s, page=None: \"\"` or " "`hdr_info=False`." msgstr "" "|PyMuPDFLayoutMode_Ignored| 자체 헤더 감지 로직을 제공하려면 이것을 사용하세요. 이것은 호출 가능한 객체이거나 `get_header_id` 라는 메서드를 가진 객체일 수 있습니다. 텍스트 스팬(:meth:`~.extractDICT` 에 포함된 스팬 딕셔너리)과 키워드 매개변수 \"page\"(소유 :ref:`Page ` 객체)를 받아야 합니다. 빈 문자열 \"\" 또는 최대 6개의 \"#\" 문자 뒤에 공백 1개를 반환해야 합니다. 생략(`None`)하면 전체 문서 스캔을 수행하여 가장 인기 있는 폰트 크기를 찾고 이를 기반으로 헤더 수준을 파생합니다. 이 동작을 완전히 피하려면 `hdr_info=lambda s, page=None: \"\"` 또는 `hdr_info=False` 를 지정하세요." #: ../../pymupdf4llm/api.rst:97 a35f46ec3a53486fa48b3655d9e9c97d msgid "" "|PyMuPDFLayoutMode_Valid| boolean to switch on/off page header content. " "This parameter controls whether we want to include or omit the header " "content from all the document pages. Useful if the document has " "repetitive header content which doesn't add any value to the overall " "extraction data. Default is `True` meaning that header content will be " "considered." msgstr "" "|PyMuPDFLayoutMode_Valid| 페이지 헤더 콘텐츠를 켜거나 끄는 부울 값입니다. 이 매개변수는 모든 문서 페이지에서 헤더 콘텐츠를 포함할지 생략할지를 제어합니다. 문서에 반복적인 헤더 콘텐츠가 있어 전체 추출 데이터에 가치를 추가하지 않는 경우에 유용합니다. 기본값은 `True` 이며 헤더 콘텐츠가 고려됩니다." #: ../../pymupdf4llm/api.rst:99 28b04a679d88497e96269ee7f0812e9e msgid "" "|PyMuPDFLayoutMode_Ignored| if ``True`` includes text even when " "completely transparent. Default is ``False``: transparent text will be " "ignored which usually increases detection accuracy." msgstr "" "|PyMuPDFLayoutMode_Ignored| ``True`` 이면 완전히 투명한 경우에도 텍스트를 포함합니다. 기본값은 ``False`` 입니다: 투명한 텍스트는 무시되며 일반적으로 감지 정확도를 높입니다." #: ../../pymupdf4llm/api.rst:101 36820cc6604844b2a4d5375a7cd5792f msgid "" "if `True` then mono-spaced text lines do not receive special formatting. " "Code blocks will no longer be generated. This value is set to `True` if " "`extract_words=True` is used." msgstr "" "`True` 이면 고정 폭 텍스트 줄이 특별한 형식을 받지 않습니다. 코드 블록이 더 이상 생성되지 않습니다. `extract_words=True` 가 사용되면 이 값은 `True` 로 설정됩니다." #: ../../pymupdf4llm/api.rst:103 bff188eabaf94192af91641c85c1e98d msgid "" "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard vector graphics " "on the page. This may help detecting text correctly when pages are very " "crowded (often the case for documents representing presentation slides). " "Also speeds up processing time. This automatically prevents table " "detection." msgstr "" "|PyMuPDFLayoutMode_Ignored| (v.0.0.20에서 새로 추가됨) 페이지의 벡터 그래픽을 무시합니다. 페이지가 매우 복잡할 때(프레젠테이션 슬라이드를 나타내는 문서에서 자주 발생) 텍스트를 올바르게 감지하는 데 도움이 될 수 있습니다. 또한 처리 시간을 단축합니다. 이것은 자동으로 테이블 감지를 방지합니다." #: ../../pymupdf4llm/api.rst:105 056587fcf3d04ac29d30bcd3886d95f2 msgid "" "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard images on the " "page. This may help detecting text correctly when pages are very crowded " "(often the case for documents representing presentation slides). Also " "speeds up processing time." msgstr "" "|PyMuPDFLayoutMode_Ignored| (v.0.0.20에서 새로 추가됨) 페이지의 이미지를 무시합니다. 페이지가 매우 복잡할 때(프레젠테이션 슬라이드를 나타내는 문서에서 자주 발생) 텍스트를 올바르게 감지하는 데 도움이 될 수 있습니다. 또한 처리 시간을 단축합니다." #: ../../pymupdf4llm/api.rst:107 ecf6dcf203a643bd8e51300ae9ad0a06 msgid "" "specify the desired image format via its extension. Default is \"png\" " "(portable network graphics). Another popular format may be \"jpg\". " "Possible values are all :ref:`supported output formats " "`." msgstr "" "확장자를 통해 원하는 이미지 형식을 지정합니다. 기본값은 \"png\"(portable network graphics)입니다. 다른 인기 있는 형식은 \"jpg\"일 수 있습니다. 가능한 값은 모든 :ref:`지원되는 출력 형식 ` 입니다." #: ../../pymupdf4llm/api.rst:109 adbd88cd1ca14c1ba5ee08b2109bce36 msgid "" "store images in this folder. Relevant if `write_images=True`. Default is " "the path of the script directory." msgstr "" "이 폴더에 이미지를 저장합니다. `write_images=True` 인 경우 관련됩니다. 기본값은 스크립트 디렉토리의 경로입니다." #: ../../pymupdf4llm/api.rst:111 afeb57cfa94f4015b4e1e6c1c2e6e125 #, python-format msgid "" "|PyMuPDFLayoutMode_Ignored| this must be a ``0 <= value < 1``. Images are" " ignored if `width / page.rect.width <= image_size_limit` or `height / " "page.rect.height <= image_size_limit`. For instance, the default value " "0.05 means that to be considered for inclusion, an image's width and " "height must be larger than 5% of the page's width and height, " "respectively." msgstr "" "|PyMuPDFLayoutMode_Ignored| 이것은 ``0 <= value < 1`` 이어야 합니다. `width / page.rect.width <= image_size_limit` 또는 `height / page.rect.height <= image_size_limit` 이면 이미지가 무시됩니다. 예를 들어, 기본값 0.05는 포함을 고려하려면 이미지의 너비와 높이가 각각 페이지 너비와 높이의 5%보다 커야 함을 의미합니다." #: ../../pymupdf4llm/api.rst:113 85475d5ce25043fe947f058364b6d756 msgid "" "|PyMuPDFLayoutMode_Ignored| a float or a sequence of 2 or 4 floats " "specifying page borders. Only objects inside the margins will be " "considered for output. * `margin=f` yields `(f, f, f, f)` for `(left, " "top, right, bottom)`. * `(top, bottom)` yields `(0, top, 0, bottom)`. * " "To always read full pages **(default)**, use `margins=0`." msgstr "" #: ../../pymupdf4llm/api.rst:113 3fb6f34f01ff47e3a66ae8c810ee06e0 msgid "" "|PyMuPDFLayoutMode_Ignored| a float or a sequence of 2 or 4 floats " "specifying page borders. Only objects inside the margins will be " "considered for output." msgstr "" "|PyMuPDFLayoutMode_Ignored| 페이지 여백을 지정하는 float 또는 2개 또는 4개의 float 시퀀스. 여백 내부의 객체만 출력 대상으로 고려됩니다." #: ../../pymupdf4llm/api.rst:115 801899e2be22416aa50f59d49696821f msgid "`margin=f` yields `(f, f, f, f)` for `(left, top, right, bottom)`." msgstr "`margin=f` 는 `(left, top, right, bottom)` 에 대해 `(f, f, f, f)` 를 생성합니다." #: ../../pymupdf4llm/api.rst:116 387562b55d82431291823c1801fd50a4 msgid "`(top, bottom)` yields `(0, top, 0, bottom)`." msgstr "`(top, bottom)` 는 `(0, top, 0, bottom)` 를 생성합니다." #: ../../pymupdf4llm/api.rst:117 cdd8cebf2e1948a0a421609fc71375f2 msgid "To always read full pages **(default)**, use `margins=0`." msgstr "항상 전체 페이지를 읽으려면 **(기본값)**, `margins=0` 을 사용하세요." #: ../../pymupdf4llm/api.rst:119 34c0664f16c740c7aca19e3a24e79e08 msgid "" "if `True` the output will be a list of `Document.page_count` dictionaries" " (one per page). Each dictionary has the following structure: - " "**\"metadata\"** - a dictionary consisting of the document's metadata " ":attr:`Document.metadata`, enriched with additional keys " "**\"file_path\"** (the file name), **\"page_count\"** (number of pages in" " document), and **\"page_number\"** (1-based page number). - " "**\"toc_items\"** - a list of Table of Contents items pointing to this " "page. Each item of this list has the format `[lvl, title, pagenumber]`, " "where `lvl` is the hierarchy level, `title` a string and `pagenumber` as " "a 1-based page number. - **\"tables\"** - a list of tables on this page." " Each item is a dictionary with keys \"bbox\", \"row_count\" and " "\"col_count\". Key \"bbox\" is a `pymupdf.Rect` in tuple format of the " "table's position on the page. - **\"images\"** - " "|PyMuPDFLayoutMode_EmptyList| a list of images on the page. This a copy " "of page method :meth:`Page.get_image_info`. - **\"graphics\"** - " "|PyMuPDFLayoutMode_EmptyList| a list of vector graphics rectangles on the" " page. This is a list of boundary boxes of clustered vector graphics as " "delivered by method :meth:`Page.cluster_drawings`. - **\"text\"** - page" " content as |Markdown| text. - **\"words\"** - " "|PyMuPDFLayoutMode_EmptyList| if `extract_words=True` was used. This is a" " list of tuples `(x0, y0, x1, y1, \"wordstring\", bno, lno, wno)` as " "delivered by `page.get_text(\"words\")`. The **sequence** of these tuples" " however is the same as produced in the markdown text string and thus " "honors multi-column text. This is also true for text in tables: words are" " extracted in the sequence of table row cells." msgstr "" #: ../../pymupdf4llm/api.rst:119 26276a827ba549e7ae6680403a0325be msgid "" "if `True` the output will be a list of `Document.page_count` dictionaries" " (one per page). Each dictionary has the following structure:" msgstr "" "`True` 이면 출력은 `Document.page_count` 딕셔너리 목록(페이지당 하나)이 됩니다. 각 딕셔너리는 다음 구조를 가집니다:" #: ../../pymupdf4llm/api.rst:121 412ffcdcfd664b5a9cdca7475bb6c793 msgid "" "**\"metadata\"** - a dictionary consisting of the document's metadata " ":attr:`Document.metadata`, enriched with additional keys " "**\"file_path\"** (the file name), **\"page_count\"** (number of pages in" " document), and **\"page_number\"** (1-based page number)." msgstr "" "**\"metadata\"** - 문서의 메타데이터 :attr:`Document.metadata` 로 구성된 딕셔너리이며, 추가 키 **\"file_path\"** (파일 이름), **\"page_count\"** (문서의 페이지 수), **\"page_number\"** (1-기반 페이지 번호)로 보강됩니다." #: ../../pymupdf4llm/api.rst:123 e102e7dfa70942fabc2932205ec555ed msgid "" "**\"toc_items\"** - a list of Table of Contents items pointing to this " "page. Each item of this list has the format `[lvl, title, pagenumber]`, " "where `lvl` is the hierarchy level, `title` a string and `pagenumber` as " "a 1-based page number." msgstr "" "**\"toc_items\"** - 이 페이지를 가리키는 목차 항목 목록. 이 목록의 각 항목은 `[lvl, title, pagenumber]` 형식을 가지며, 여기서 `lvl` 은 계층 수준, `title` 은 문자열, `pagenumber` 는 1-기반 페이지 번호입니다." #: ../../pymupdf4llm/api.rst:125 697bc1bf53f943a6a77a7e73b4ed9069 msgid "" "**\"tables\"** - a list of tables on this page. Each item is a dictionary" " with keys \"bbox\", \"row_count\" and \"col_count\". Key \"bbox\" is a " "`pymupdf.Rect` in tuple format of the table's position on the page." msgstr "" "**\"tables\"** - 이 페이지의 테이블 목록. 각 항목은 \"bbox\", \"row_count\", \"col_count\" 키를 가진 딕셔너리입니다. \"bbox\" 키는 페이지에서 테이블 위치의 튜플 형식인 `pymupdf.Rect` 입니다." #: ../../pymupdf4llm/api.rst:127 f4902a3e2743455b879b8e485c311e6e msgid "" "**\"images\"** - |PyMuPDFLayoutMode_EmptyList| a list of images on the " "page. This a copy of page method :meth:`Page.get_image_info`." msgstr "" "**\"images\"** - |PyMuPDFLayoutMode_EmptyList| 페이지의 이미지 목록. 이것은 페이지 메서드 :meth:`Page.get_image_info` 의 복사본입니다." #: ../../pymupdf4llm/api.rst:129 247ba43947304db2939158ac691bb939 msgid "" "**\"graphics\"** - |PyMuPDFLayoutMode_EmptyList| a list of vector " "graphics rectangles on the page. This is a list of boundary boxes of " "clustered vector graphics as delivered by method " ":meth:`Page.cluster_drawings`." msgstr "" "**\"graphics\"** - |PyMuPDFLayoutMode_EmptyList| 페이지의 벡터 그래픽 사각형 목록. 이것은 메서드 :meth:`Page.cluster_drawings` 에서 제공하는 클러스터링된 벡터 그래픽의 경계 상자 목록입니다." #: ../../pymupdf4llm/api.rst:131 57d71d3b3a3249569cbda9768c424bda msgid "**\"text\"** - page content as |Markdown| text." msgstr "**\"text\"** - |Markdown| 텍스트로 된 페이지 콘텐츠." #: ../../pymupdf4llm/api.rst:133 5f83592243374620aa76011c7afea0ae msgid "" "**\"words\"** - |PyMuPDFLayoutMode_EmptyList| if `extract_words=True` was" " used. This is a list of tuples `(x0, y0, x1, y1, \"wordstring\", bno, " "lno, wno)` as delivered by `page.get_text(\"words\")`. The **sequence** " "of these tuples however is the same as produced in the markdown text " "string and thus honors multi-column text. This is also true for text in " "tables: words are extracted in the sequence of table row cells." msgstr "" "**\"words\"** - |PyMuPDFLayoutMode_EmptyList| `extract_words=True` 가 사용된 경우. 이것은 `page.get_text(\"words\")` 에서 제공하는 튜플 `(x0, y0, x1, y1, \"wordstring\", bno, lno, wno)` 목록입니다. 그러나 이러한 튜플의 **순서** 는 마크다운 텍스트 문자열에서 생성된 것과 동일하므로 다중 열 텍스트를 존중합니다. 테이블의 텍스트에도 적용됩니다: 단어는 테이블 행 셀의 순서로 추출됩니다." #: ../../pymupdf4llm/api.rst:135 a4eb7467e30b421a95b8c99919ecbce6 msgid "" "specify a desired page height. For relevance see the `page_width` " "parameter. If using the default `None`, the document will appear as one " "large page with a width of `page_width`. Consequently in this case, no " "markdown page separators will occur (except the final one), respectively " "only one page chunk will be returned." msgstr "" "원하는 페이지 높이를 지정합니다. 관련성은 `page_width` 매개변수를 참조하세요. 기본값 `None` 을 사용하면 문서가 `page_width` 너비의 하나의 큰 페이지로 나타납니다. 결과적으로 이 경우 마크다운 페이지 구분자가 발생하지 않으며(마지막 것 제외), 각각 하나의 페이지 청크만 반환됩니다." #: ../../pymupdf4llm/api.rst:137 3d9536256eb44ab18b73999b0e0a94ef msgid "" "if ``True`` inserts a string ``--- end of page=n ---`` at the end of each" " page output. Intended for debugging purposes. The page number is " "0-based. The separator string is wrapped with line breaks. Default is " "``False``." msgstr "" "``True`` 이면 각 페이지 출력 끝에 문자열 ``--- end of page=n ---`` 를 삽입합니다. 디버깅 목적으로 사용됩니다. 페이지 번호는 0-기반입니다. 구분자 문자열은 줄바꿈으로 감싸집니다. 기본값은 ``False`` 입니다." #: ../../pymupdf4llm/api.rst:139 9cb78dc09dde4bdb80163561a09b2df7 msgid "" "specify a desired page width. This is ignored for documents with a fixed " "page width like PDF, XPS etc. **Reflowable** documents however, like " "e-books, office [#f2]_ or text files have no fixed page dimensions. They " "by default are assumed to have Letter format width (612) and an " "**unlimited** page height. This means that the **full document is treated" " as one large page.**" msgstr "" "원하는 페이지 너비를 지정합니다. PDF, XPS 등 고정 페이지 너비를 가진 문서에서는 무시됩니다. 그러나 **재배치 가능한** 문서(예: 전자책, 오피스 [#f2]_ 또는 텍스트 파일)는 고정 페이지 크기가 없습니다. 기본적으로 Letter 형식 너비(612)와 **무제한** 페이지 높이를 가진 것으로 가정됩니다. 이것은 **전체 문서가 하나의 큰 페이지로 처리됨** 을 의미합니다." #: ../../pymupdf4llm/api.rst:141 ../../pymupdf4llm/api.rst:171 #: 951850c1f7ff4f798dca7dda5b985f12 d4db9adce2fe428ab58a3903b6e897f9 msgid "" "optional, the pages to consider for output (caution: specify 0-based page" " numbers). If omitted (`None`) all pages are processed. Any Python " "sequence with integer items is accepted. The sequence is sorted and " "processed to only contain unique items." msgstr "" "선택 사항, 출력을 위해 고려할 페이지(주의: 0-기반 페이지 번호 지정). 생략(`None`)하면 모든 페이지가 처리됩니다. 정수 항목이 있는 모든 Python 시퀀스가 허용됩니다. 시퀀스는 정렬되고 고유 항목만 포함하도록 처리됩니다." #: ../../pymupdf4llm/api.rst:143 ../../pymupdf4llm/api.rst:175 #: 56fb5c28b7784bf8b4a7d4c352ab926b 82e67bb02bfc4cf09bbf354bfaab4eae #: 9536a5d8ab5a41c98764cbe8dda15cb9 msgid "" "Default is `False`. A value of `True` displays a progress bar as pages " "are being converted. Package `tqdm `_ is " "used if installed, otherwise the built-in text based progress bar is " "used." msgstr "" "기본값은 `False` 입니다. `True` 값은 페이지가 변환되는 동안 진행 표시줄을 표시합니다. `tqdm `_ 패키지가 설치되어 있으면 사용되고, 그렇지 않으면 내장 텍스트 기반 진행 표시줄이 사용됩니다." #: ../../pymupdf4llm/api.rst:145 2db14405113e40179eb2edf68e69b579 msgid "" "|PyMuPDFLayoutMode_Ignored| see: :meth:`table detection strategy " "`. Default is `\"lines_strict\"` which ignores " "background colors. In some occasions, other strategies may be more " "successful, for example `\"lines\"` which uses all vector graphics " "objects for detection." msgstr "" "|PyMuPDFLayoutMode_Ignored| 참조: :meth:`테이블 감지 전략 `. 기본값은 배경색을 무시하는 `\"lines_strict\"` 입니다. 경우에 따라 다른 전략이 더 성공적일 수 있습니다. 예를 들어 모든 벡터 그래픽 객체를 감지에 사용하는 `\"lines\"` 입니다." #: ../../pymupdf4llm/api.rst:147 abf44d2845b94d018e86396e471a2797 msgid "" "|PyMuPDFLayoutMode_Ignored| (New in v.0.0.19) Default is `False`. A value" " of `True` will use the glyph number of the characters instead of the " "character itself if the font does not store the Unicode value." msgstr "" "|PyMuPDFLayoutMode_Ignored| (v.0.0.19에서 새로 추가됨) 기본값은 `False` 입니다. `True` 값은 폰트가 유니코드 값을 저장하지 않는 경우 문자 자체 대신 문자의 글리프 번호를 사용합니다." #: ../../pymupdf4llm/api.rst:149 dfec1fde53d145b4a723e9686dc1ad55 msgid "" "when encountering images or vector graphics, images will be created from " "the respective page area and stored in the specified folder. |Markdown| " "references will be generated pointing to these images. Any text contained" " in these areas will not be included in the text output (but appear as " "part of the images). Therefore, if for instance your document has text " "written on full page images, make sure to set this parameter to `False`." " If using :ref:`PyMuPDF Layout `, boundary boxes that " "are classified as \"picture\" by the layout module will be treated as " "images - independent from the mixture of text, images or vector graphics " "they may be covering. If `force_text=True` is used, text will still be " "extracted from these areas and included in the output after the " "respective image reference." msgstr "" #: ../../pymupdf4llm/api.rst:149 93ccd09a15134624a2ab4a2288ba6171 msgid "" "when encountering images or vector graphics, images will be created from " "the respective page area and stored in the specified folder. |Markdown| " "references will be generated pointing to these images. Any text contained" " in these areas will not be included in the text output (but appear as " "part of the images). Therefore, if for instance your document has text " "written on full page images, make sure to set this parameter to `False`." msgstr "" "이미지나 벡터 그래픽을 만나면 해당 페이지 영역에서 이미지가 생성되어 지정된 폴더에 저장됩니다. |Markdown| 참조가 이러한 이미지를 가리키도록 생성됩니다. 이러한 영역에 포함된 텍스트는 텍스트 출력에 포함되지 않습니다(이미지의 일부로 나타남). 따라서 예를 들어 문서에 전체 페이지 이미지에 텍스트가 작성된 경우 이 매개변수를 `False` 로 설정해야 합니다." #: ../../pymupdf4llm/api.rst:151 250eaf1b38694043b90736d4d9a821ce msgid "" "If using :ref:`PyMuPDF Layout `, boundary boxes that are " "classified as \"picture\" by the layout module will be treated as images " "- independent from the mixture of text, images or vector graphics they " "may be covering. If `force_text=True` is used, text will still be " "extracted from these areas and included in the output after the " "respective image reference." msgstr "" ":ref:`PyMuPDF Layout ` 을 사용하는 경우 레이아웃 모듈에 의해 \"picture\"로 분류된 경계 상자는 이미지로 처리됩니다 - 덮고 있을 수 있는 텍스트, 이미지 또는 벡터 그래픽의 혼합과 무관합니다. `force_text=True` 가 사용되면 텍스트는 여전히 이러한 영역에서 추출되어 해당 이미지 참조 뒤에 출력에 포함됩니다." #: ../../pymupdf4llm/api.rst 0d07c67350cb436fb33e8aad838f6779 #: 598d4d5d997b46ae9c685c56a12f8d30 6c9887cf2f934da0a3139fe4efef9133 #: 7cd056f0a5e24e6c9cb9ef3811c9fe21 85a59fb19a314f869c001f8014cb715b msgid "Returns" msgstr "반환값" #: ../../pymupdf4llm/api.rst:153 5f63166d8164444791851b4680d313dd msgid "" "Either a string of the combined text of all selected document pages, or a" " list of dictionaries if `page_chunks=True`." msgstr "" "선택된 모든 문서 페이지의 결합된 텍스트 문자열이거나 `page_chunks=True` 인 경우 딕셔너리 목록입니다." #: ../../pymupdf4llm/api.rst:159 5b52df94b00743b6a3926949923c8769 msgid "" "Reads the pages of the file and outputs the text of its pages in |TXT| " "format." msgstr "" "파일의 페이지를 읽고 |TXT| 형식으로 페이지 텍스트를 출력합니다." #: ../../pymupdf4llm/api.rst:161 ../../pymupdf4llm/api.rst:182 #: 67252eed1bc0433b86f2f7f7339cf77b b67079733cf74d7ba1d1fbbb866cb359 msgid "" "|PyMuPDFLayoutMode_Valid|. This method is only available with PyMuPDF " "Layout." msgstr "" "|PyMuPDFLayoutMode_Valid|. 이 메서드는 PyMuPDF Layout에서만 사용할 수 있습니다." #: ../../pymupdf4llm/api.rst:165 d3ce63da02ea48dca75f94d50be77f12 msgid "" "boolean to switch on/off page header content. This parameter controls " "whether to include or omit the header content from all the document " "pages. Useful if the document has repetitive header content which doesn't" " add any value to the overall extraction data. Default is `True` meaning " "that header content will be written." msgstr "" "페이지 헤더 콘텐츠를 켜거나 끄는 부울 값입니다. 이 매개변수는 모든 문서 페이지에서 헤더 콘텐츠를 포함할지 생략할지를 제어합니다. 문서에 반복적인 헤더 콘텐츠가 있어 전체 추출 데이터에 가치를 추가하지 않는 경우에 유용합니다. 기본값은 `True` 이며 헤더 콘텐츠가 작성됩니다." #: ../../pymupdf4llm/api.rst:167 67bec0a4a60e463496475cd96362ffeb msgid "" "boolean to switch on/off page footer content. This parameter controls " "whether to include or omit the footer content from all the document " "pages. Useful if the document has repetitive footer content which doesn't" " add any value to the overall extraction data. Default is `True` meaning " "that footer content will be written." msgstr "" "페이지 푸터 콘텐츠를 켜거나 끄는 부울 값입니다. 이 매개변수는 모든 문서 페이지에서 푸터 콘텐츠를 포함할지 생략할지를 제어합니다. 문서에 반복적인 푸터 콘텐츠가 있어 전체 추출 데이터에 가치를 추가하지 않는 경우에 유용합니다. 기본값은 `True` 이며 푸터 콘텐츠가 작성됩니다." #: ../../pymupdf4llm/api.rst:169 fb77c695d98d4c95aa3263b6b6d780b7 msgid "" "if `True` then mono-spaced text lines do not receive special formatting. " "No blocks will be written and text lines will be written continuously." msgstr "" "`True` 이면 고정 폭 텍스트 줄이 특별한 형식을 받지 않습니다. 블록이 작성되지 않고 텍스트 줄이 연속적으로 작성됩니다." #: ../../pymupdf4llm/api.rst:173 1b962ab25f1847bcbeca72a0b761b13e msgid "" "generate text output also when overlapping images / graphics. This text " "then appears after the respective image reference. Images (i.e. " "\"picture\" areas) however will not be written to the text output but " "appear as a text line in the output like `==> picture [width x height] " "<==`." msgstr "" "이미지/그래픽과 겹치는 경우에도 텍스트 출력을 생성합니다. 이 텍스트는 해당 이미지 참조 뒤에 나타납니다. 그러나 이미지(즉, \"picture\" 영역)는 텍스트 출력에 작성되지 않고 `==> picture [width x height] <==` 와 같은 텍스트 줄로 출력에 나타납니다." #: ../../pymupdf4llm/api.rst:180 5d81ef685e2d4f0db6010c6fe5be7a9d msgid "" "Parses the document and the specified pages and converts the result into " "a |JSON|-formatted string." msgstr "" "문서와 지정된 페이지를 구문 분석하고 결과를 |JSON| 형식 문자열로 변환합니다." #: ../../pymupdf4llm/api.rst:186 4855882483854c768ca0261d1ae19f75 msgid "" "specify the desired image resolution in dots per inch. Default value is " "150. Only relevant if one of the parameters `write_images=True` or " "`embed_images=True` is used." msgstr "" "인치당 도트 수로 원하는 이미지 해상도를 지정합니다. 기본값은 150입니다. `write_images=True` 또는 `embed_images=True` 매개변수 중 하나가 사용된 경우에만 관련됩니다." #: ../../pymupdf4llm/api.rst:188 92c49b4e2541455c8fc58a215abe7ded msgid "" "specify the desired image format via its extension. Default is \"png\" " "(portable network graphics). Another popular format may be \"jpg\". " "Possible values are all :ref:`supported output formats " "`. Only relevant if one of the parameters " "`write_images=True` or `embed_images=True` is used." msgstr "" "확장자를 통해 원하는 이미지 형식을 지정합니다. 기본값은 \"png\"(portable network graphics)입니다. 다른 인기 있는 형식은 \"jpg\"일 수 있습니다. 가능한 값은 모든 :ref:`지원되는 출력 형식 ` 입니다. `write_images=True` 또는 `embed_images=True` 매개변수 중 하나가 사용된 경우에만 관련됩니다." #: ../../pymupdf4llm/api.rst:190 1be020ddc3ca4fbe9f5fd73c3298040b msgid "" "store images in this folder. Relevant if `write_images=True`. Default is " "the path of the script directory. Page areas classified as \"picture\" " "will be written as image files to the specified location. The image file " "names will be of the format `{image_path}/{filename}-pagenumber-" "image_number.{image_format}`." msgstr "" "이 폴더에 이미지를 저장합니다. `write_images=True` 인 경우 관련됩니다. 기본값은 스크립트 디렉토리의 경로입니다. \"picture\"로 분류된 페이지 영역은 지정된 위치에 이미지 파일로 작성됩니다. 이미지 파일 이름은 `{image_path}/{filename}-pagenumber-image_number.{image_format}` 형식입니다." #: ../../pymupdf4llm/api.rst:192 984764256bf04d99b89ba80370d8541c msgid "" "generate text output for text that is written upon areas that are " "classified as \"picture\" by the layout module. This may be especially be" " useful when picture content is not stored." msgstr "" "레이아웃 모듈에 의해 \"picture\"로 분류된 영역에 작성된 텍스트에 대한 텍스트 출력을 생성합니다. 그림 콘텐츠가 저장되지 않은 경우 특히 유용할 수 있습니다." #: ../../pymupdf4llm/api.rst:194 8b5e7a2ba58e4b0da1eed3140c9a2eed msgid "display a progress bar during processing." msgstr "처리 중 진행 표시줄을 표시합니다." #: ../../pymupdf4llm/api.rst:196 5a55754f73304138814f39a3895fb5db msgid "" "store image binaries for \"picture\" boundary boxes. Base64-encoded " "images are included in the JSON output. Ignores `image_path` if used. " "This may drastically increase the size of your JSON text." msgstr "" "\"picture\" 경계 상자에 대한 이미지 바이너리를 저장합니다. Base64 인코딩된 이미지가 JSON 출력에 포함됩니다. 사용된 경우 `image_path` 를 무시합니다. 이것은 JSON 텍스트의 크기를 크게 증가시킬 수 있습니다." #: ../../pymupdf4llm/api.rst:198 13a91b7cc1f04969b4e871b8c7920989 msgid "" "store image files \"picture\" boundary boxes.when encountering images, " "image files will be created from the respective page area and stored in " "the specified folder. Any text contained in these areas will still be " "included in the text output." msgstr "" "\"picture\" 경계 상자에 대한 이미지 파일을 저장합니다. 이미지를 만나면 해당 페이지 영역에서 이미지 파일이 생성되어 지정된 폴더에 저장됩니다. 이러한 영역에 포함된 텍스트는 여전히 텍스트 출력에 포함됩니다." #: ../../pymupdf4llm/api.rst:200 dd0ddcf7925544d4b76e9734667d33f4 msgid "" "optional, the pages to consider for output (caution: specify 0-based page" " numbers). If omitted (`None`) all pages are processed. Specify any valid" " Python sequence containing integers between `0` and `page_count - 1`." msgstr "" "선택 사항, 출력을 위해 고려할 페이지(주의: 0-기반 페이지 번호 지정). 생략(`None`)하면 모든 페이지가 처리됩니다. `0` 과 `page_count - 1` 사이의 정수를 포함하는 유효한 Python 시퀀스를 지정하세요." #: ../../pymupdf4llm/api.rst:205 47988e45549446179f8420be32191824 msgid "" "Please see `this site " "`_ for more " "background and the current status of further improvements regarding usage" " with :ref:`PyMuPDF Layout `." msgstr "" ":ref:`PyMuPDF Layout ` 사용에 대한 추가 배경 정보 및 개선 사항의 현재 상태는 `이 사이트 `_ 를 참조하세요." #: ../../pymupdf4llm/api.rst:210 8bdedbb86fac4bdca76803ff7f660033 msgid "" "Create a `pdf_markdown_reader.PDFMarkdownReader` using the `LlamaIndex`_ " "package. Please note that this package will **not automatically be " "installed** when installing **pymupdf4llm**." msgstr "" "`LlamaIndex`_ 패키지를 사용하여 `pdf_markdown_reader.PDFMarkdownReader` 를 생성합니다. 이 패키지는 **pymupdf4llm** 설치 시 **자동으로 설치되지 않습니다**." #: ../../pymupdf4llm/api.rst:212 ac6f0e13b9034f77a6222df6d6f0a966 msgid "" "For details on the possible arguments, please consult the LlamaIndex " "documentation [#f1]_." msgstr "" "가능한 인수에 대한 자세한 내용은 LlamaIndex 문서 [#f1]_ 를 참조하세요." #: ../../pymupdf4llm/api.rst 71aa61f2d1a446ec8dc78203d5e8258b msgid "raises" msgstr "발생" #: ../../pymupdf4llm/api.rst:214 f1a663fdbc6e4f06b71256b6a4ef2df9 msgid "`NotImplementedError`: Please install required `LlamaIndex`_ package." msgstr "`NotImplementedError`: 필요한 `LlamaIndex`_ 패키지를 설치하세요." #: ../../pymupdf4llm/api.rst:215 9c61e09aba8942e081d3fc15080f8708 msgid "" "a `pdf_markdown_reader.PDFMarkdownReader` and issues message " "\"Successfully imported LlamaIndex\". Please note that this method needs " "several seconds to execute. For details on using the markdown reader " "please see below." msgstr "" "`pdf_markdown_reader.PDFMarkdownReader` 를 생성하고 \"Successfully imported LlamaIndex\" 메시지를 발행합니다. 이 메서드는 실행하는 데 몇 초가 필요합니다. 마크다운 리더 사용에 대한 자세한 내용은 아래를 참조하세요." #: ../../pymupdf4llm/api.rst:222 ../../pymupdf4llm/api.rst:350 #: 59202f45ef284beea61e2fb7c2b74d47 71f2f0dd222a44589ed37b4ae0fd4ad7 msgid "|PyMuPDFLayoutMode_Unavailable|" msgstr "|PyMuPDFLayoutMode_Unavailable|" #: ../../pymupdf4llm/api.rst:227 36ad491d525c45e3923f3fd43b7ab548 msgid "" "Create an object which maps text font sizes to the respective number of " "'#' characters which are used by Markdown syntax to indicate header " "levels. The object is created by scanning the document for font size " "\"popularity\". The most popular font size and all smaller sizes are used" " for body text. Larger font sizes are mapped to the respective header " "levels - which correspond to the HTML tags `

` to `

`." msgstr "" "텍스트 폰트 크기를 마크다운 구문에서 헤더 레벨을 나타내는 데 사용되는 '#' 문자 수에 매핑하는 객체를 생성합니다. 이 객체는 문서에서 폰트 크기 \"인기도\"를 스캔하여 생성됩니다. 가장 인기 있는 폰트 크기와 모든 작은 크기는 본문 텍스트에 사용됩니다. 더 큰 폰트 크기는 해당 헤더 레벨에 매핑됩니다 - 이는 HTML 태그 `

` 에서 `

` 에 해당합니다." #: ../../pymupdf4llm/api.rst:229 a5f1efbaa3ec4a3fa953b61ecb108cb5 msgid "All font sizes are rounded to integer values." msgstr "모든 폰트 크기는 정수 값으로 반올림됩니다." #: ../../pymupdf4llm/api.rst:231 060cf88a851843848a644386178dfc4f msgid "" "If more than 6 header levels would be required, then the largest number " "smaller than the `
` font size is used for body text." msgstr "" "6개 이상의 헤더 레벨이 필요한 경우, `
` 폰트 크기보다 작은 가장 큰 숫자가 본문 텍스트에 사용됩니다." #: ../../pymupdf4llm/api.rst:233 4b8c52bf47c0493388a6cae3ddc6dc33 msgid "" "Please note that creating the object will read and inspect the text of " "the entire document - independently of reading the document again in the " "`to_markdown()` method subsequently. Method `to_markdown()` by default " "**will create this object** if you do not override its `hdr_info=None` " "parameter." msgstr "" "객체를 생성하면 문서 전체의 텍스트를 읽고 검사합니다 - 이후 `to_markdown()` 메서드에서 문서를 다시 읽는 것과는 무관하게. `to_markdown()` 메서드는 기본적으로 `hdr_info=None` 매개변수를 재정의하지 않으면 **이 객체를 생성합니다**." #: ../../pymupdf4llm/api.rst:236 8a854caf0428436bb30ff64c0e2b7b99 msgid "" "the file, to be specified either as a file path string, or as a |PyMuPDF|" " Document (created via `pymupdf.open`). In order to use `pathlib.Path` " "specifications, Python file-like objects, documents in memory etc. you " "**must** use a |PyMuPDF| Document." msgstr "" "파일 경로 문자열 또는 `pymupdf.open` 을 통해 생성된 |PyMuPDF| Document로 지정할 파일입니다. `pathlib.Path` 사양, Python 파일과 같은 객체, 메모리의 문서 등을 사용하려면 **반드시** |PyMuPDF| Document를 사용해야 합니다." #: ../../pymupdf4llm/api.rst:238 ca89a89858a54fcbbb852141997e973c msgid "optional, the pages to consider. If omitted all pages are processed." msgstr "선택 사항, 고려할 페이지. 생략하면 모든 페이지가 처리됩니다." #: ../../pymupdf4llm/api.rst:240 28c341c4a1a546bda43c89f339be5704 msgid "" "the default font size limit for body text. Only used when the document " "scan does not deliver valid information." msgstr "" "본문 텍스트의 기본 폰트 크기 제한. 문서 스캔이 유효한 정보를 제공하지 않을 때만 사용됩니다." #: ../../pymupdf4llm/api.rst:242 9f2766b2b7ca488cbd3a37553ff5694f msgid "" "the maximum number of header levels to be used. Valid values are in " "`range(1, 7)`. The default is 6, which corresponds to the HTML tags " "`

` to `

`. A smaller value will limit the number of generated " "header levels. For instance, a value of 3 will only generate header tags " "\"#\", \"##\" and \"###\". Body text will be assumed for all font sizes " "smaller than the one corresponding to \"###\"." msgstr "" "사용할 최대 헤더 레벨 수. 유효한 값은 `range(1, 7)` 입니다. 기본값은 6이며, 이는 HTML 태그 `

` 에서 `

` 에 해당합니다. 더 작은 값은 생성되는 헤더 레벨 수를 제한합니다. 예를 들어, 값 3은 헤더 태그 \"#\", \"##\", \"###\"만 생성합니다. 본문 텍스트는 \"###\"에 해당하는 폰트 크기보다 작은 모든 폰트 크기에 대해 가정됩니다." #: ../../pymupdf4llm/api.rst:247 15756bee4cc048d0804e9ad2b8711c6b msgid "" "Return appropriate markdown header prefix. This is either \"\" or a " "string of \"#\" characters followed by a space." msgstr "" "적절한 마크다운 헤더 접두사를 반환합니다. 이는 빈 문자열이거나 공백이 뒤따르는 \"#\" 문자열입니다." #: ../../pymupdf4llm/api.rst:249 a58b7b22952e44f6a83e6cbd4945aec1 msgid "" "Given a text span from a \"dict\" extraction, determine the markdown " "header prefix string of 0 to n concatenated '#' characters." msgstr "" "\"dict\" 추출에서 텍스트 스팬이 주어지면, 0에서 n까지 연결된 '#' 문자의 마크다운 헤더 접두사 문자열을 결정합니다." #: ../../pymupdf4llm/api.rst:251 ../../pymupdf4llm/api.rst:370 #: 7a4b3f9199c64c60855e87be06938800 937b8a8741c941fe837306b743b991d2 msgid "" "a dictionary containing the text span information. This is the same " "dictionary as returned by `page.get_text(\"dict\")`." msgstr "" "`page.get_text(\"dict\")` 에 의해 반환되는 것과 동일한 텍스트 스팬 정보를 포함하는 딕셔너리입니다." #: ../../pymupdf4llm/api.rst:253 ../../pymupdf4llm/api.rst:372 #: 3f4de965af784b5aa3bc9c1d0da99386 4fb44301f96d4a76813aaaf15f5dbf3f msgid "" "the owning page object. This can be used when additional information " "needs to be extracted." msgstr "" "소유 페이지 객체. 추가 정보가 추출되어야 할 때 사용할 수 있습니다." #: ../../pymupdf4llm/api.rst:255 ../../pymupdf4llm/api.rst:374 #: 1ada9bd96e9e481bbf098e63f0b97a34 4e537632f9824eafa6ea661c5c65813d msgid "a string of \"#\" characters followed by a space." msgstr "공백이 뒤따르는 \"#\" 문자열입니다." #: ../../pymupdf4llm/api.rst:259 e3e73fd9f50a4142a184bd4baa20c90b msgid "" "A dictionary mapping (integer) font sizes to Markdown header strings like" " ``{14: '# ', 12: '## '}``. The dictionary is created by the " ":class:`IdentifyHeaders` constructor. The keys are the font sizes of the " "text spans in the document. The values are the respective header strings." msgstr "" "정수 폰트 크기를 ``{14: '# ', 12: '## '}`` 와 같은 마크다운 헤더 문자열에 매핑하는 딕셔너리입니다. 이 딕셔너리는 :class:`IdentifyHeaders` 생성자에 의해 생성됩니다. 키는 문서의 텍스트 스팬 폰트 크기입니다. 값은 해당 헤더 문자열입니다." #: ../../pymupdf4llm/api.rst:263 c5a884c560bc48cfb1e711db69d97d70 msgid "" "An integer value indicating the font size limit for body text. This is " "computed as ``min(header_id.keys()) - 1``. In the above example, " "body_limit would be 11." msgstr "" "본문 텍스트의 폰트 크기 제한을 나타내는 정수 값. 이는 ``min(header_id.keys()) - 1`` 로 계산됩니다. 위 예시에서 body_limit은 11이 됩니다." #: ../../pymupdf4llm/api.rst:269 18f9b62b612f43cb98b8bc9395d2e91d msgid "**How to limit header levels (example)**" msgstr "**헤더 레벨 제한 방법 (예제)**" #: ../../pymupdf4llm/api.rst:271 fdcd8a88e3764fe2beb711dd0f769a93 msgid "Limit the generated header levels to 3::" msgstr "생성된 헤더 레벨을 3으로 제한::" #: ../../pymupdf4llm/api.rst:281 6922b5601f2b4e85abea7f1588a5242f msgid "**How to provide your own header logic (example 1)**" msgstr "**자체 헤더 로직 제공 방법 (예제 1)**" #: ../../pymupdf4llm/api.rst:283 0c5bbcfbc3d54e32afd708445550f723 msgid "Provide your own function which uses pre-determined, fixed font sizes::" msgstr "사전 결정된 고정 폰트 크기를 사용하는 자체 함수 제공::" #: ../../pymupdf4llm/api.rst:310 b42d96ba59d74b32b1b76a558c18107f msgid "**How to provide your own header logic (example 2)**" msgstr "**자체 헤더 로직 제공 방법 (예제 2)**" #: ../../pymupdf4llm/api.rst:312 c06eabeb42df48b0a48defe0031513fe msgid "" "This user function uses the document's Table of Contents -- under the " "assumption that the bookmark text is also present as a header line on the" " page (which certainly need not be the case!)::" msgstr "" "이 사용자 함수는 문서의 목차를 사용합니다 -- 북마크 텍스트가 페이지의 헤더 줄로도 존재한다는 가정 하에(반드시 그럴 필요는 없습니다!)::" #: ../../pymupdf4llm/api.rst:354 7b2f4631e38449c0829b1d5669205310 msgid "" "Create an object which uses the document's Table of Contents (TOC) to " "determine header levels. Upon object creation, the table of contents is " "read via the `Document.get_toc()` method. The TOC data is then used to " "determine header levels in the `to_markdown()` method." msgstr "" "문서의 목차(TOC)를 사용하여 헤더 레벨을 결정하는 객체를 생성합니다. 객체 생성 시 `Document.get_toc()` 메서드를 통해 목차를 읽습니다. TOC 데이터는 `to_markdown()` 메서드에서 헤더 레벨을 결정하는 데 사용됩니다." #: ../../pymupdf4llm/api.rst:356 80a339f128134f47b56bdd58fb75a2e7 msgid "" "This is an alternative to :class:`IdentifyHeaders`. Instead of running " "through the full document to identify font sizes, it uses the document's " "Table Of Contents (TOC) to identify headers on pages. Like " ":class:`IdentifyHeaders`, this also is no guarantee to find headers, but " "for well-built Table of Contents, there is a good chance for more " "correctly identifying header lines on document pages than the font-size-" "based approach." msgstr "" "이것은 :class:`IdentifyHeaders` 의 대안입니다. 전체 문서를 통해 폰트 크기를 식별하는 대신, 문서의 목차(TOC)를 사용하여 페이지의 헤더를 식별합니다. :class:`IdentifyHeaders` 와 마찬가지로, 이것도 헤더를 찾는 것을 보장하지는 않지만, 잘 구성된 목차의 경우 폰트 크기 기반 접근 방식보다 문서 페이지의 헤더 줄을 더 정확하게 식별할 가능성이 높습니다." #: ../../pymupdf4llm/api.rst:358 6ba9148a06a44cd0b05fab409c4283a1 msgid "" "It also has the advantage of being much faster than the font-size-based " "approach, as it does not execute a full document scan or even access any " "of the document pages." msgstr "" "또한 전체 문서 스캔을 실행하거나 문서 페이지에 액세스하지 않으므로 폰트 크기 기반 접근 방식보다 훨씬 빠르다는 장점이 있습니다." #: ../../pymupdf4llm/api.rst:360 e09d29ea50ee4cb99e1e48f14cb1d419 msgid "" "Examples where this approach works very well are the Adobe's files on PDF" " documentation." msgstr "" "이 접근 방식이 매우 잘 작동하는 예는 Adobe의 PDF 문서 파일입니다." #: ../../pymupdf4llm/api.rst:362 42d005a54259451e84de46008792d588 msgid "" "Please note that this feature **does not read document pages** where the " "table of contents may exist as normal standard text. It only accesses " "data as provided by the `Document.get_toc()` method. It will not identify" " any headers for documents where the table of contents is not available " "as a collection of bookmarks." msgstr "" "이 기능은 목차가 일반 표준 텍스트로 존재할 수 있는 문서 페이지를 **읽지 않습니다**. `Document.get_toc()` 메서드에서 제공하는 데이터에만 액세스합니다. 목차가 북마크 모음으로 제공되지 않는 문서의 헤더는 식별하지 않습니다." #: ../../pymupdf4llm/api.rst:366 9747e3ce0895441493b43d41f4a9df78 msgid "" "Return appropriate markdown header prefix. This is either an empty string" " or a string of \"#\" characters followed by a space." msgstr "" "적절한 마크다운 헤더 접두사를 반환합니다. 이는 빈 문자열이거나 공백이 뒤따르는 \"#\" 문자열입니다." #: ../../pymupdf4llm/api.rst:368 59e1904d38f140f0a477ffbb69d1dc7d msgid "" "Given a text span from a \"dict\" extraction variant, determine the " "markdown header prefix string of 0 to n concatenated \"#\" characters." msgstr "" "\"dict\" 추출 변형에서 텍스트 스팬이 주어지면, 0에서 n까지 연결된 \"#\" 문자의 마크다운 헤더 접두사 문자열을 결정합니다." #: ../../pymupdf4llm/api.rst:378 4b11b54d62a94df4905acf20c2ad8471 msgid "**How to use class TocHeaders**" msgstr "**TocHeaders 클래스 사용 방법**" #: ../../pymupdf4llm/api.rst:380 95ea1015ab4c45ab9fdb488b9c270390 msgid "" "This is a version of previous **example 2** that uses :class:`TocHeaders`" " for header identification::" msgstr "" "이것은 헤더 식별을 위해 :class:`TocHeaders` 를 사용하는 이전 **예제 2** 의 버전입니다::" #: ../../pymupdf4llm/api.rst:398 a4a87f3efb6d472d80ff03a5b8a23c65 msgid "" "This is the only method of the markdown reader you should currently use " "to extract markdown data. Please in any case ignore methods " "`aload_data()` and `lazy_load_data()`. Other methods like " "`use_doc_meta()` may or may not make sense. For more information, please " "consult the LlamaIndex documentation [#f1]_." msgstr "" "이것은 현재 마크다운 데이터를 추출하는 데 사용해야 하는 마크다운 리더의 유일한 메서드입니다. 어떤 경우에도 `aload_data()` 및 `lazy_load_data()` 메서드를 무시하세요. `use_doc_meta()` 와 같은 다른 메서드는 의미가 있을 수도 있고 없을 수도 있습니다. 자세한 내용은 LlamaIndex 문서 [#f1]_ 를 참조하세요." #: ../../pymupdf4llm/api.rst:400 df377eb2611b45ad9e06938903718a76 msgid "Under the hood the method will execute `to_markdown()`." msgstr "내부적으로 메서드는 `to_markdown()` 을 실행합니다." #: ../../pymupdf4llm/api.rst:402 afdbf4a1f22542639e7a55416dbdda7c msgid "a list of `LlamaIndexDocument` documents - one for each page." msgstr "`LlamaIndexDocument` 문서 목록 - 페이지당 하나씩." #: ../../pymupdf4llm/api.rst:406 fd268aa92d6044ef951c3f708636d48e msgid "" "For a list of changes, please see file `CHANGES.md " "`_." msgstr "" "변경 사항 목록은 `CHANGES.md `_ 파일을 참조하세요." #: ../../pymupdf4llm/api.rst:409 6446df28273c490c9e143aed82d42276 msgid "Footnotes" msgstr "각주" #: ../../pymupdf4llm/api.rst:410 bbce2a3f10a44b019ed3acaa0a06e6b6 msgid "`LlamaIndex documentation `_" msgstr "`LlamaIndex 문서 `_" #: ../../pymupdf4llm/api.rst:412 c49adecd61d04edda261abe63966093d msgid "" "When using PyMuPDF-Pro, supported office documents are converted " "internally into a PDF-like format. Therefore, they **will have fixed page" " dimensions** and be no longer \"reflowable\". Consequently, the page " "width and page height specifications will be ignored as well in these " "cases." msgstr "" "PyMuPDF-Pro를 사용할 때 지원되는 오피스 문서는 내부적으로 PDF와 유사한 형식으로 변환됩니다. 따라서 **고정 페이지 크기** 를 가지며 더 이상 \"재배치 가능\"하지 않습니다. 결과적으로 이러한 경우 페이지 너비 및 페이지 높이 사양도 무시됩니다." #: ../../footer.rst:48 1ed68f4bf8fd45fab04f7a49fba09f0a msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." #~ msgid "" #~ "This class is not available in " #~ "\"layout mode\", i.e. if the import " #~ "of pymupdf4llm has happened **after** " #~ "the statement ``import pymupdf.layout``." #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/pymupdf4llm/index.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7f556c0708ab49cdbc462a525dfa7aff msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 4eb9ac713eaa4bc5a5a44191f5dec7ae msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8c03dba2f9bc41ab84de0114382f5e82 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../pymupdf4llm/index.rst:8 96b9f29894ff49beba7a07931c5c900d msgid "PyMuPDF4LLM" msgstr "PyMuPDF4LLM" #: ../../pymupdf4llm/index.rst:10 59d6714b7f6549e0a52c173974da2135 msgid "" "|PyMuPDF4LLM| is aimed to make it easier to extract |PDF| content in the " "format you need for **LLM** & **RAG** environments. It supports " ":ref:`Markdown extraction ` as well as :ref:`LlamaIndex" " document output `." msgstr "|PyMuPDF4LLM| 는 **LLM** 및 **RAG** 환경에 필요한 형식으로 |PDF| 콘텐츠를 더 쉽게 추출할 수 있도록 하는 것을 목표로 합니다. :ref:`Markdown 추출 ` 및 :ref:`LlamaIndex 문서 출력 ` 을 지원합니다." #: ../../pymupdf4llm/index.rst:12 8b36d59c925f4a0d93873eeab7e4843a msgid "" "When using |PyMuPDF4LLM| with PyMuPDF Layout, page layout detection will " "be greatly improved. This is true for table detection, but also for the " "detection of page headers and footers, footnotes, list items and text " "paragraphs. In addition two new methods become available, `to_json()` and" " `to_text()`." msgstr "" "|PyMuPDF4LLM| 를 PyMuPDF Layout과 함께 사용하면 페이지 레이아웃 감지가 크게 향상됩니다. 이것은 테이블 감지뿐만 아니라 페이지 헤더 및 푸터, 각주, 목록 항목 및 텍스트 단락의 감지에도 해당합니다. 또한 두 가지 새로운 메서드 `to_json()` 및 `to_text()` 가 사용 가능해집니다." #: ../../pymupdf4llm/index.rst:16 50bf080e50e64ba58e973f0addf24d73 msgid "" "You can extend the supported file types to also include **Office** " "document formats (DOC/DOCX, XLS/XLSX, PPT/PPTX, HWP/HWPX) by :ref:`using " "PyMuPDF Pro with PyMuPDF4LLM `." msgstr ":ref:`PyMuPDF Pro와 PyMuPDF4LLM 함께 사용 ` 하여 지원되는 파일 타입을 **Office** 문서 형식(DOC/DOCX, XLS/XLSX, PPT/PPTX, HWP/HWPX)도 포함하도록 확장할 수 있습니다." #: ../../pymupdf4llm/index.rst:19 38428359cdaf4039b439454f5c712ec7 msgid "Features" msgstr "기능" #: ../../pymupdf4llm/index.rst:21 5f4fb197fcdd4a0ab3ac79607a78a25e msgid "Support for multi-column pages" msgstr "다중 열 페이지 지원" #: ../../pymupdf4llm/index.rst:22 7e249663241a4aacb2f9b1fcb4450393 msgid "" "Support for image and vector graphics extraction (and inclusion of " "references in the MD text)" msgstr "이미지 및 벡터 그래픽 추출 지원(MD 텍스트에 참조 포함)" #: ../../pymupdf4llm/index.rst:23 cf659dc9b2da48d69e7ab3d1cda7f132 msgid "Support for page chunking output." msgstr "페이지 청킹 출력 지원." #: ../../pymupdf4llm/index.rst:24 20715d6347fb42b7b485fba224287741 msgid "" "Direct support for output as :ref:`LlamaIndex Documents " "`." msgstr ":ref:`LlamaIndex 문서 ` 로 출력하는 직접 지원." #: ../../pymupdf4llm/index.rst:25 42fe53c6392143838058ca9b8b1684a3 msgid "" "When used with :ref:`PyMuPDF Layout ` : Support for plain" " text output similar to Markdown" msgstr "" ":ref:`PyMuPDF Layout ` 와 함께 사용할 때: Markdown과 유사한 일반 텍스트 출력 지원" #: ../../pymupdf4llm/index.rst:26 345e944ae1c54464a70343f8ee2b62e9 msgid "" "When used with :ref:`PyMuPDF Layout ` : Support for JSON " "output" msgstr "" ":ref:`PyMuPDF Layout ` 와 함께 사용할 때: JSON 출력 지원" #: ../../pymupdf4llm/index.rst:30 90f6c12aacd14b7eba944b6c1e013ed5 msgid "Functionality" msgstr "기능" #: ../../pymupdf4llm/index.rst:32 e63a722974dc41f3928dc372e66da5c0 msgid "" "This package converts the pages of a file to text in **Markdown** format " "using |PyMuPDF|." msgstr "이 패키지는 |PyMuPDF| 를 사용하여 파일의 페이지를 **Markdown** 형식의 텍스트로 변환합니다." #: ../../pymupdf4llm/index.rst:34 1504c800279e44568bfbbeef3eb2ba6d msgid "" "Standard text and tables are detected, brought in the right reading " "sequence and then together converted to **GitHub**-compatible " "**Markdown** text." msgstr "표준 텍스트와 테이블이 감지되고 올바른 읽기 순서로 가져온 다음 **GitHub** 호환 **Markdown** 텍스트로 함께 변환됩니다." #: ../../pymupdf4llm/index.rst:36 4d3e28d4b9654f6889e99f25edeafb6f msgid "" "Header lines are identified via the font size and appropriately prefixed " "with one or more `#` tags." msgstr "헤더 줄은 글꼴 크기를 통해 식별되며 하나 이상의 `#` 태그로 적절히 접두사가 붙습니다." #: ../../pymupdf4llm/index.rst:38 d3dc9c01915e4fd5a47c1784eae70c00 msgid "" "Bold, italic, mono-spaced text and code blocks are detected and formatted" " accordingly. Similar applies to ordered and unordered lists." msgstr "굵게, 기울임꼴, 고정폭 텍스트 및 코드 블록이 감지되고 그에 따라 형식화됩니다. 순서 있는 목록과 순서 없는 목록에도 유사하게 적용됩니다." #: ../../pymupdf4llm/index.rst:40 bc9f92950b5b4c038ed82153c462a0c6 msgid "" "By default, all document pages are processed. If desired, a subset of " "pages can be specified by providing a list of `0`-based page numbers." msgstr "기본적으로 모든 문서 페이지가 처리됩니다. 원하는 경우 `0` 기반 페이지 번호 목록을 제공하여 페이지 하위 집합을 지정할 수 있습니다." #: ../../pymupdf4llm/index.rst:44 24714fd3cb744a908099e19f1af6ce7e msgid "Installation" msgstr "설치" #: ../../pymupdf4llm/index.rst:47 dd73904df42146e18551936620e44355 msgid "Install the package via **pip** with:" msgstr "**pip** 를 통해 패키지를 설치합니다:" #: ../../pymupdf4llm/index.rst:58 a08840e778fe46379ec9110ad3c3608a msgid "Extracting a file as **Markdown**" msgstr "파일을 **Markdown** 으로 추출" #: ../../pymupdf4llm/index.rst:60 98c0760b58c04cbeb1299faf5b79ab3f msgid "" "To retrieve your document content in **Markdown** simply install the " "package and then use a couple of lines of **Python** code to get results." msgstr "**Markdown** 형식으로 문서 콘텐츠를 검색하려면 패키지를 설치한 다음 몇 줄의 **Python** 코드를 사용하여 결과를 얻습니다." #: ../../pymupdf4llm/index.rst:64 6a398956ca7f4c9c9057734393a79743 msgid "Then in your **Python** script do:" msgstr "그런 다음 **Python** 스크립트에서 다음을 수행합니다:" #: ../../pymupdf4llm/index.rst:75 b227684a017d42e8b88f83ad2a3c673e msgid "" "Instead of the filename string as above, one can also provide a " ":ref:`PyMuPDF Document `. A second parameter may be a list of " "`0`-based page numbers, e.g. `[0, 1]` would just select the first and " "second pages of the document." msgstr "위와 같이 파일명 문자열 대신 :ref:`PyMuPDF Document ` 를 제공할 수도 있습니다. 두 번째 매개변수는 `0` 기반 페이지 번호 목록일 수 있습니다. 예를 들어 `[0,1]` 은 문서의 첫 번째와 두 번째 페이지만 선택합니다." #: ../../pymupdf4llm/index.rst:78 a0929decafbc41cb86a00b46905219e0 msgid "" "If you want to store your **Markdown** file, e.g. store as a UTF8-encoded" " file, then do:" msgstr "**Markdown** 파일을 저장하려면(예: UTF8 인코딩 파일로 저장) 다음을 수행합니다:" #: ../../pymupdf4llm/index.rst:91 fe47c11343ec4d278c9f9cc524bccb86 msgid "Extracting a file as a **LlamaIndex** document" msgstr "파일을 **LlamaIndex** 문서로 추출" #: ../../pymupdf4llm/index.rst:93 6834228bb5524c319b8c3d5dbe8138d6 msgid "" "|PyMuPDF4LLM| supports direct conversion to a **LLamaIndex** document. A " "document is first converted into **Markdown** format and then a " "**LlamaIndex** document is returned as follows:" msgstr "|PyMuPDF4LLM| 는 **LlamaIndex** 문서로 직접 변환을 지원합니다. 문서는 먼저 **Markdown** 형식으로 변환된 다음 다음과 같이 **LlamaIndex** 문서가 반환됩니다:" #: ../../pymupdf4llm/index.rst:107 e653025ecf1948759d96b33b7902c524 msgid "Using with |PyMuPDF Pro|" msgstr "|PyMuPDF Pro| 와 함께 사용" #: ../../pymupdf4llm/index.rst:110 9e877b4bd26d43cbaf81821091d51a1b msgid "" "For **Office** document support, |PyMuPDF4LLM| works seamlessly with " "|PyMuPDF Pro|. Assuming you have :doc:`../pymupdf-pro` installed you will" " be able to work with **Office** documents as expected:" msgstr "**Office** 문서 지원을 위해 |PyMuPDF4LLM| 는 |PyMuPDF Pro| 와 원활하게 작동합니다. :doc:`../pymupdf-pro` 가 설치되어 있다고 가정하면 예상대로 **Office** 문서로 작업할 수 있습니다:" #: ../../pymupdf4llm/index.rst:121 ff1a10504dbe4b5381a2f6232a21b346 msgid "" "As you can see |PyMuPDF Pro| functionality will be available within the " "|PyMuPDF4LLM| context!" msgstr "보시다시피 |PyMuPDF Pro| 기능이 |PyMuPDF4LLM| 컨텍스트 내에서 사용 가능합니다!" #: ../../pymupdf4llm/index.rst:126 32a7f061e08e4a6ca0f4f3fddb070669 msgid "API" msgstr "API" #: ../../pymupdf4llm/index.rst:128 b4ebede9414d489da467192cd788038a msgid "See :ref:`the PyMuPDF4LLM API `." msgstr ":ref:`PyMuPDF4LLM API ` 를 참조하세요." #: ../../pymupdf4llm/index.rst:131 bb3e7108ffa0474c9130db24bde17039 msgid "Further Resources" msgstr "추가 리소스" #: ../../pymupdf4llm/index.rst:135 ec0ceb929e634253940d9d8b12c34e12 msgid "Sample code" msgstr "샘플 코드" #: ../../pymupdf4llm/index.rst:137 f2d41ac1c1d24d9289e6ce68bc9370de msgid "" "`Command line RAG Chatbot with PyMuPDF " "`_" msgstr "`PyMuPDF 를 사용한 명령줄 RAG 챗봇 `_" #: ../../pymupdf4llm/index.rst:138 bf6ddba28b86427ab7c934e3fe869608 msgid "" "`Example of a Browser Application using Langchain and PyMuPDF " "`_" msgstr "`Langchain과 PyMuPDF 를 사용한 브라우저 애플리케이션 예제 `_" #: ../../pymupdf4llm/index.rst:142 05f33a793ba04dbea19e7a464b4c8cd5 msgid "Blogs" msgstr "블로그" #: ../../pymupdf4llm/index.rst:144 d6c3173afe6a4dbd880c662d9a8b9e66 msgid "" "`RAG/LLM and PDF: Enhanced Text Extraction `_" msgstr "`RAG/LLM 및 PDF: 향상된 텍스트 추출 `_" #: ../../pymupdf4llm/index.rst:145 2469a1a8ebb649b083d10e876d5b3022 msgid "" "`Creating a RAG Chatbot with ChatGPT and PyMuPDF " "`_" msgstr "`ChatGPT와 PyMuPDF 로 RAG 챗봇 만들기 `_" #: ../../pymupdf4llm/index.rst:146 750da7ec1111406c9f24fe09151140ae msgid "" "`Building a RAG Chatbot GUI with the ChatGPT API and PyMuPDF " "`_" msgstr "`ChatGPT API와 PyMuPDF 로 RAG 챗봇 GUI 구축 `_" #: ../../pymupdf4llm/index.rst:147 d820865d4e2b470b975fd95e67ec0436 msgid "" "`RAG/LLM and PDF: Conversion to Markdown Text with PyMuPDF " "`_" msgstr "`RAG/LLM 및 PDF: PyMuPDF 로 Markdown 텍스트로 변환 `_" #: ../../footer.rst:48 30b12247e1244acba7a2885245d87849 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." #~ msgid "" #~ "Instead of the filename string as " #~ "above, one can also provide a " #~ ":ref:`PyMuPDF Document `. A second" #~ " parameter may be a list of " #~ "`0`-based page numbers, e.g. `[0,1]` " #~ "would just select the first and " #~ "second pages of the document." #~ msgstr "" #~ msgid "" #~ "When using |PyMuPDF4LLM| with PyMuPDF-" #~ "Layout, page layout detection will be" #~ " greatly improved. This is true for" #~ " table detection, but also for the" #~ " detection of page headers and " #~ "footers, footnotes, list items and text" #~ " paragraphs. In addition two new " #~ "methods become available, `to_json()` and " #~ "`to_text()`." #~ msgstr "" #~ msgid "In \"layout mode\": Support for plain text output similar to Markdown" #~ msgstr "" #~ msgid "In \"layout mode\": Support for JSON output" #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/pyodide.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9e4f1d023e4c4a2f9b1789603aba1601 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 02180e9a6b5e48f88c53ee91a688adb1 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c68f782efd8344ff9fbda1a7566d3151 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../pyodide.rst:4 b63880b098224734b9b2dc4c700c8ef3 msgid "Pyodide" msgstr "Pyodide" #: ../../pyodide.rst:8 ef1d306e03734c209cc1de803b563abf msgid "Overview" msgstr "개요" #: ../../pyodide.rst:11 a4f52f95cfaf4399817388f7e5cdb9c0 msgid "" "`Pyodide `_ is a client-side Python implementation " "that runs in a web browser." msgstr "`Pyodide `_ 는 웹 브라우저에서 실행되는 클라이언트 측 Python 구현입니다." #: ../../pyodide.rst:14 414c957de5624f6ba708ad075d3d7a63 msgid "The Pyodide build of PyMuPDF is currently experimental." msgstr "|PyMuPDF| 의 Pyodide 빌드는 현재 실험적입니다." #: ../../pyodide.rst:18 1199cc39832d45bdaa78306e41d821e5 msgid "Building a PyMuPDF wheel for Pyodide" msgstr "Pyodide용 |PyMuPDF| 휠 빌드" #: ../../pyodide.rst:20 75ac11d9769c49a1afefaeaf2e66c13e msgid "" "A PyMuPDF wheel for Pyodide can be built by running " "`scripts/gh_release.py` with some environmental variable settings. This " "is regularly tested on Github by `.github/workflows/test_pyodide.yml`." msgstr "일부 환경 변수 설정과 함께 `scripts/gh_release.py` 를 실행하여 Pyodide용 |PyMuPDF| 휠을 빌드할 수 있습니다. 이것은 `.github/workflows/test_pyodide.yml` 에 의해 GitHub에서 정기적으로 테스트됩니다." #: ../../pyodide.rst:24 cf08249abe844603bd188263b0fabb48 msgid "" "Here is an example of this, a single Linux command (to be run with the " "current directory set to a PyMuPDF checkout), that builds a Pyodide " "wheel::" msgstr "다음은 |PyMuPDF| 체크아웃으로 현재 디렉토리를 설정한 상태에서 실행할 단일 Linux 명령으로 Pyodide 휠을 빌드하는 예제입니다::" #: ../../pyodide.rst:33 9801c86b124048eaa3483bd780ea6964 msgid "This does the following (all inside Python venv's):" msgstr "다음 작업을 수행합니다 (모두 Python venv 내부에서):" #: ../../pyodide.rst:35 de17df8ffe044736b9751eb4efeb9640 msgid "" "Download (git clone and pip install) and customise a Pyodide build " "environment." msgstr "Pyodide 빌드 환경을 다운로드(git clone 및 pip install)하고 사용자 정의합니다." #: ../../pyodide.rst:36 00d95a72eea642cf9a06eea851573b78 msgid "Download (git clone) the latest MuPDF." msgstr "최신 |MuPDF| 를 다운로드(git clone)합니다." #: ../../pyodide.rst:37 25c3416cee3a43639827a6237c3a3012 msgid "Build MuPDF and PyMuPDF in the Pyodide build environment." msgstr "Pyodide 빌드 환경에서 |MuPDF| 와 |PyMuPDF| 를 빌드합니다." #: ../../pyodide.rst:38 096c442727774ebd99b66b131e42786f msgid "Create a wheel in `dist/`." msgstr "`dist/` 에 휠을 생성합니다." #: ../../pyodide.rst:40 47aca590fd0649b99cc760c1fbb7029d msgid "" "For more information, see the comments for functions " "`build_pyodide_wheel()` and `pyodide_setup()` in `scripts/gh_release.py`." msgstr "자세한 내용은 `scripts/gh_release.py` 의 함수 `build_pyodide_wheel()` 및 `pyodide_setup()` 에 대한 주석을 참조하세요." #: ../../pyodide.rst:45 c4fc80be31774fb2b23cda8d96a10202 msgid "Using a Pyodide wheel" msgstr "Pyodide 휠 사용" #: ../../pyodide.rst:48 108ac7eb8b964c2cbc563d9761406088 msgid "" "Upload the wheel (for example " "`PyMuPDF/dist/PyMuPDF-1.24.2-cp311-cp311-emscripten_3_1_32_wasm32.whl`) " "to a webserver which has been configured to allow Cross-origin resource " "sharing (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing)." msgstr "휠(예: `PyMuPDF/dist/PyMuPDF-1.24.2-cp311-cp311-emscripten_3_1_32_wasm32.whl`) 을 Cross-origin resource sharing(https://en.wikipedia.org/wiki/Cross-origin_resource_sharing)을 허용하도록 구성된 웹 서버에 업로드합니다." #: ../../pyodide.rst:54 14b102796b7a4d779c994b61aa456eb6 msgid "" "The wheel can be used in a Pyodide console running in a web browser, or a" " JupyterLite notebook running in a web browser." msgstr "휠은 웹 브라우저에서 실행되는 Pyodide 콘솔 또는 웹 브라우저에서 실행되는 JupyterLite 노트북에서 사용할 수 있습니다." #: ../../pyodide.rst:57 298d17eab9bf4ac091904aa16a7b051b msgid "To create a Pyodide console, go to:" msgstr "Pyodide 콘솔을 만들려면 다음으로 이동하세요:" #: ../../pyodide.rst:59 f04d4a5529e5478090c9afdca37eab57 msgid "https://pyodide.org/en/stable/console.html" msgstr "https://pyodide.org/en/stable/console.html" #: ../../pyodide.rst:61 2ed99e58360846728a2003c28a75ccce msgid "To create a JupyterLite notebook, go to:" msgstr "JupyterLite 노트북을 만들려면 다음으로 이동하세요:" #: ../../pyodide.rst:63 87c3dae4109c4bf4ab0ea41e5f5decfd msgid "https://jupyterlite.readthedocs.io/en/latest/_static/lab/index.html" msgstr "https://jupyterlite.readthedocs.io/en/latest/_static/lab/index.html" #: ../../pyodide.rst:66 ae8220ec6a5d45e78e3c2f569bab9574 msgid "" "In both these cases, one can use the following code to download the wheel" " (replace `url` with the URL of the uploaded wheel) and import it::" msgstr "두 경우 모두 다음 코드를 사용하여 휠을 다운로드(`url` 을 업로드된 휠의 URL로 교체)하고 가져올 수 있습니다::" #: ../../pyodide.rst:74 89859ac6e1a347a7b279e57b128fb282 msgid "" "Note that `micropip.install()` does not work, because of PyMuPDF's use of" " shared libraries." msgstr "|PyMuPDF| 가 공유 라이브러리를 사용하기 때문에 `micropip.install()` 이 작동하지 않습니다." #: ../../pyodide.rst:79 4fc797af4a414bd8b824e6adf8ea5e56 msgid "Loading a PDF document from a URL into PyMuPDF" msgstr "URL에서 |PyMuPDF| 로 PDF 문서 로드" #: ../../pyodide.rst:82 df1f0a64f0ec4ac29b93e91709cbb966 msgid "" "Pyodide browser console does not have generic network access, so for " "example `urllib.request.urlopen(url)` fails. But Pyodide has a built-in " "`pyodide.http` module that uses javascript internally, which one can use " "to download into a `bytes` instance, which can be used to create a " "PyMuPDF `Document` instance::" msgstr "Pyodide 브라우저 콘솔에는 일반 네트워크 액세스가 없으므로 예를 들어 `urllib.request.urlopen(url)` 이 실패합니다. 하지만 Pyodide에는 내부적으로 javascript를 사용하는 내장 `pyodide.http` 모듈이 있어, 이를 사용하여 `bytes` 인스턴스로 다운로드할 수 있으며, 이를 사용하여 |PyMuPDF| `Document` 인스턴스를 만들 수 있습니다::" #: ../../pyodide.rst:93 d9380bc488b14d1b863f1225ee39edfe msgid "It looks like this only works with `https://`, not `http://`." msgstr "이것은 `http://` 가 아닌 `https://` 에서만 작동하는 것 같습니다." #: ../../footer.rst:46 4640d757601c44b9a9490b7d6bff2214 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/quad.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7ec5d7130739408fa2694ff0c2ad75d3 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 5fae259f7fcf42cbb62f1d73baa02e63 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 0cf03cc6db804a65815e8d1e0054e12a msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../quad.rst:7 aa798d4be0214b06853be544b0785b84 msgid "Quad" msgstr "Quad" #: ../../quad.rst:9 664d52df82ff48e2a329b6746b58b2b1 msgid "" "Represents a four-sided mathematical shape (also called \"quadrilateral\"" " or \"tetragon\") in the plane, defined as a sequence of four " ":ref:`Point` objects ul, ur, ll, lr (conveniently called upper left, " "upper right, lower left, lower right)." msgstr "평면상의 사각형(또는 \"사변형\" 또는 \"사각형\"이라고도 함)을 나타내며, ul, ur, ll, lr(편의상 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래라고 함)의 4개의 :ref:`Point` 객체 시퀀스로 정의됩니다." #: ../../quad.rst:11 08d263b5866442108b7f33e20416a234 msgid "" "Quads can **be obtained** as results of text search methods " "(:meth:`Page.search_for`), and they **are used** to define text marker " "annotations (see e.g. :meth:`Page.add_squiggly_annot` and friends), and " "in several draw methods (like :meth:`Page.draw_quad` / " ":meth:`Shape.draw_quad`, :meth:`Page.draw_oval`/ " ":meth:`Shape.draw_quad`)." msgstr "Quad는 텍스트 검색 메서드(:meth:`Page.search_for`)의 결과로 **얻을 수 있으며**, 텍스트 마커 주석을 정의하는 데 **사용됩니다** (예: :meth:`Page.add_squiggly_annot` 및 관련 메서드 참조). 또한 여러 그리기 메서드(예: :meth:`Page.draw_quad` / :meth:`Shape.draw_quad`, :meth:`Page.draw_oval` / :meth:`Shape.draw_quad`)에서 사용됩니다." #: ../../quad.rst:15 30cb7b59b1ae4a5ea08731a41542f6bb msgid "" "If the corners of a rectangle are transformed with a **rotation**, " "**scale** or **translation** :ref:`Matrix`, then the resulting quad is " "**rectangular** (= congruent to a rectangle), i.e. all of its corners " "again enclose angles of 90 degrees. Property :attr:`Quad.is_rectangular` " "checks whether a quad can be thought of being the result of such an " "operation." msgstr "사각형의 모서리가 **회전**, **확대/축소** 또는 **이동** :ref:`Matrix` 로 변환되면 결과 quad는 **직사각형** (= 사각형과 합동)입니다. 즉, 모든 모서리가 다시 90도 각도를 이룹니다. 속성 :attr:`Quad.is_rectangular` 는 quad가 이러한 작업의 결과로 간주될 수 있는지 확인합니다." #: ../../quad.rst:17 3be08077e5cf46e193ba24399731c728 msgid "" "This is not true for all matrices: e.g. shear matrices produce " "parallelograms, and non-invertible matrices deliver \"degenerate\" " "tetragons like triangles or lines." msgstr "이것은 모든 행렬에 대해 참이 아닙니다: 예를 들어, 기울이기 행렬은 평행사변형을 생성하고, 역행렬이 없는 행렬은 삼각형이나 선과 같은 \"퇴화된\" 사각형을 제공합니다." #: ../../quad.rst:19 223f177e5a564f43be092c227d86b112 msgid "" "Attribute :attr:`Quad.rect` obtains the enveloping rectangle. Vice versa," " rectangles now have attributes :attr:`Rect.quad`, resp. " ":attr:`IRect.quad` to obtain their respective tetragon versions." msgstr "속성 :attr:`Quad.rect` 는 둘러싸는 사각형을 얻습니다. 반대로, 사각형은 이제 속성 :attr:`Rect.quad`, 각각 :attr:`IRect.quad` 를 가지고 있어 각각의 사각형 버전을 얻을 수 있습니다." #: ../../quad.rst:23 3934fff4cce44ebfac69ca1f1e02500e msgid "**Methods / Attributes**" msgstr "**메서드 / 속성**" #: ../../quad.rst:23 cdb016a40be44d93a40ab88520ffa8b3 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../quad.rst:25 791c2e6dfad84f60a324d45c361eb49f msgid ":meth:`Quad.transform`" msgstr ":meth:`Quad.transform`" #: ../../quad.rst:25 b4219d71eccb4873b81cc4d2cbcb6cbb msgid "transform with a matrix" msgstr "행렬로 변환" #: ../../quad.rst:26 adeda9365d014af99747c1b84d16d245 msgid ":meth:`Quad.morph`" msgstr ":meth:`Quad.morph`" #: ../../quad.rst:26 fcecfd74d9564866958a61afa427072d msgid "transform with a point and matrix" msgstr "점과 행렬로 변환" #: ../../quad.rst:27 939ee16703a748c1b7562657da6cc054 msgid ":attr:`Quad.ul`" msgstr ":attr:`Quad.ul`" #: ../../quad.rst:27 e89af93b74ba463e80523ab573be725d msgid "upper left point" msgstr "왼쪽 위 점" #: ../../quad.rst:28 cab5b3be90554379aae89e7da8ea19e5 msgid ":attr:`Quad.ur`" msgstr ":attr:`Quad.ur`" #: ../../quad.rst:28 5f2493216d724836b99e69bb3f2c6ffd msgid "upper right point" msgstr "오른쪽 위 점" #: ../../quad.rst:29 d6e7980c18a64485b0f538f30d29d060 msgid ":attr:`Quad.ll`" msgstr ":attr:`Quad.ll`" #: ../../quad.rst:29 00ae622c1ee44e99a8dd8ddb76e02b2a msgid "lower left point" msgstr "왼쪽 아래 점" #: ../../quad.rst:30 39a814307b8d4e799ac5cab34bed4f55 msgid ":attr:`Quad.lr`" msgstr ":attr:`Quad.lr`" #: ../../quad.rst:30 880af62ca8a04aae96037daa38ab12b2 msgid "lower right point" msgstr "오른쪽 아래 점" #: ../../quad.rst:31 31a8eb5ee9dd4eaf98509da0c412ccfa msgid ":attr:`Quad.is_convex`" msgstr ":attr:`Quad.is_convex`" #: ../../quad.rst:31 c28042739b2a4b60ac6c42f30bd29401 msgid "true if quad is a convex set" msgstr "quad가 볼록 집합이면 true" #: ../../quad.rst:32 37497d0521974f6b87502804c9456f9d msgid ":attr:`Quad.is_empty`" msgstr ":attr:`Quad.is_empty`" #: ../../quad.rst:32 b051739d6773420e9d1042cf4501fe9e msgid "true if quad is an empty set" msgstr "quad가 빈 집합이면 true" #: ../../quad.rst:33 c7afddefaf7f4476977d2523faf20cbc msgid ":attr:`Quad.is_rectangular`" msgstr ":attr:`Quad.is_rectangular`" #: ../../quad.rst:33 df9d56bff733427dbe82f9bab5bba633 msgid "true if quad is congruent to a rectangle" msgstr "quad가 사각형과 합동이면 true" #: ../../quad.rst:34 bfba7ccca7e84436b2db6a654b9e7208 msgid ":attr:`Quad.rect`" msgstr ":attr:`Quad.rect`" #: ../../quad.rst:34 bcc943456152458291d460cd5fc66400 msgid "smallest containing :ref:`Rect`" msgstr "포함하는 가장 작은 :ref:`Rect`" #: ../../quad.rst:35 9d18f5ed25604421a134ad9c5338e2a8 msgid ":attr:`Quad.width`" msgstr ":attr:`Quad.width`" #: ../../quad.rst:35 3d617c28106542cf93d65cd246bb2ee6 msgid "the longest width value" msgstr "가장 긴 너비 값" #: ../../quad.rst:36 86896dcc8bb845459987fab77ae2fc7e msgid ":attr:`Quad.height`" msgstr ":attr:`Quad.height`" #: ../../quad.rst:36 b00633cc845d40ea8282c89246c89ab9 msgid "the longest height value" msgstr "가장 긴 높이 값" #: ../../quad.rst:39 963eed1326d34022aab68a6721f147e1 msgid "**Class API**" msgstr "**클래스 API**" #: ../../quad.rst:51 045248fd98ef41c9a3e88a5e995d0c01 msgid "" "Overloaded constructors: \"ul\", \"ur\", \"ll\", \"lr\" stand for " ":data:`point_like` objects (the four corners), \"sequence\" is a Python " "sequence with four :data:`point_like` objects." msgstr "오버로드된 생성자: \"ul\", \"ur\", \"ll\", \"lr\"는 :data:`point_like` 객체(4개의 모서리)를 나타내며, \"sequence\"는 4개의 :data:`point_like` 객체를 가진 Python 시퀀스입니다." #: ../../quad.rst:53 5af6b11b5ecb4ff19bf862fa90a4a4f2 msgid "If \"quad\" is specified, the constructor creates a **new copy** of it." msgstr "\"quad\"가 지정되면 생성자는 그것의 **새 복사본** 을 만듭니다." #: ../../quad.rst:55 cea0afbfe7e446829d6109aee4dc330a msgid "" "Without parameters, a quad consisting of 4 copies of *Point(0, 0)* is " "created." msgstr "매개변수 없이 *Point(0, 0)* 의 4개 복사본으로 구성된 quad가 생성됩니다." #: ../../quad.rst:60 4b16d0be6f9a461f93515a13f6ac07ef msgid "" "Modify the quadrilateral by transforming each of its corners with a " "matrix." msgstr "각 모서리를 행렬로 변환하여 사각형을 수정합니다." #: ../../quad.rst 6ad7d5776f2748a380465099b165536d #: fcc95d04edce488f83cc252a7323652c msgid "Parameters" msgstr "매개변수" #: ../../quad.rst:62 ../../quad.rst:69 bed48ffd731349bcb867f40fcbaf8a68 #: fa657693f6094b69ba8adf946f1d9d4d msgid "the matrix." msgstr "행렬." #: ../../quad.rst:66 d449536aa4364cfa8d454ab5552538de msgid "" "*(New in version 1.17.0)* \"Morph\" the quad with a matrix-like using a " "point-like as fixed point." msgstr "*(버전 1.17.0에서 새로 추가됨)* 고정점으로 점과 유사한 것을 사용하여 행렬과 유사한 것으로 quad를 \"변형\"합니다." #: ../../quad.rst:68 1bc5f7ab62ff46dca6c4085984b1973e msgid "the point." msgstr "점." #: ../../quad.rst f004f07cfc6543989140c9a712f8318b msgid "Returns" msgstr "반환값" #: ../../quad.rst:70 2314249ac3bf4d48af9f5d0c9918f092 msgid "a new quad (no operation if this is the infinite quad)." msgstr "새 quad(이것이 무한 quad인 경우 작업 없음)." #: ../../quad.rst:75 790caa78886e4aa0a8e169a3884a528c msgid "" "The smallest rectangle containing the quad, represented by the blue area " "in the following picture." msgstr "quad를 포함하는 가장 작은 사각형으로, 다음 그림의 파란색 영역으로 표시됩니다." #: ../../quad.rst 23306adcb7c441c6b4a06d25179f70ff #: 29fcd747f839470f9cd452054f5ad2c6 2f60233b58254ddc83846169e9b77814 #: 5cb78f927dc040ebb6b41e9dbff03a48 78a7d163966f44928813bdcff435e9bd #: 9e112f66c76f47ed990ca685b6ccb967 d08887513bee4c03877dc766e67a812e #: da27d9920c9247c7b07901d41c25a765 e54af6598b2446f9a18abddbfb930bf4 #: f5aba2a5d1a04f22b723d0c816c0e825 msgid "type" msgstr "유형" #: ../../quad.rst:79 7cca1627db0a4c789cb2bfbe34594522 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../quad.rst:83 db740f8e958d416fac479f484e53e7f5 msgid "Upper left point." msgstr "왼쪽 위 점." #: ../../quad.rst:85 ../../quad.rst:91 ../../quad.rst:97 ../../quad.rst:103 #: 1c8574d31d0343ca90a64a220a722491 325b06978c6644afb11af209b53aef75 #: 5c193b8c51574a7388be59a99ec9f306 70ea90d3bd5645b8bca7b2e0a066b329 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../quad.rst:89 21467c9a895c4e438d7cb0faf4be00ce msgid "Upper right point." msgstr "오른쪽 위 점." #: ../../quad.rst:95 b82ee98f3f134593b40af259336342d3 msgid "Lower left point." msgstr "왼쪽 아래 점." #: ../../quad.rst:101 da89c966391948d895f518fc03b9f064 msgid "Lower right point." msgstr "오른쪽 아래 점." #: ../../quad.rst:107 bb5e071792a14d5c9526c8dc57993167 msgid "New in version 1.16.1" msgstr "버전 1.16.1에서 새로 추가됨" #: ../../quad.rst:109 91bd8cd76c9c4afcbb037ddb9059df47 msgid "" "Checks if for any two points of the quad, all points on their connecting " "line also belong to the quad." msgstr "quad의 임의의 두 점에 대해, 연결선 위의 모든 점도 quad에 속하는지 확인합니다." #: ../../quad.rst:114 ../../quad.rst:120 ../../quad.rst:126 #: 5ae88b9907fb467f84267387a790a3c5 920999ae2e69406995af71a6dae1e8a6 #: a538f6fd994649c1a7d2009e3e9276f3 msgid "bool" msgstr "bool" #: ../../quad.rst:118 c068cc4b85364edea719e7d034e85295 msgid "" "True if enclosed area is zero, which means that at least three of the " "four corners are on the same line. If this is false, the quad may still " "be degenerate or not look like a tetragon at all (triangles, " "parallelograms, trapezoids, ...)." msgstr "둘러싸인 영역이 0이면 True입니다. 이는 4개의 모서리 중 최소 3개가 같은 선상에 있음을 의미합니다. 이것이 false이면 quad는 여전히 퇴화되었거나 사각형처럼 보이지 않을 수 있습니다(삼각형, 평행사변형, 사다리꼴 등)." #: ../../quad.rst:124 9f5e063e47c247c890c6956b98921d91 msgid "" "True if all corner angles are 90 degrees. This implies that the quad is " "**convex and not empty**." msgstr "모든 모서리 각도가 90도이면 True입니다. 이것은 quad가 **볼록하고 비어 있지 않음** 을 의미합니다." #: ../../quad.rst:130 71ec407d1b0f4aa4a81edef402aa24df msgid "The maximum length of the top and the bottom side." msgstr "위쪽과 아래쪽 변의 최대 길이." #: ../../quad.rst:132 ../../quad.rst:138 2ffdd79a0a92446bbaf89d3ea83f1e43 #: e2e1c5c2ebd0423190583a8ee05f1a84 msgid "float" msgstr "float" #: ../../quad.rst:136 4c1f38db1cd34add898f6bdf1977db1a msgid "The maximum length of the left and the right side." msgstr "왼쪽과 오른쪽 변의 최대 길이." #: ../../quad.rst:141 9db22e1b205244fea68bc9fa262c3a44 msgid "Remark" msgstr "참고" #: ../../quad.rst:142 b1fa23555ac34b80a5bf47ad6ba54cb7 msgid "" "This class adheres to the sequence protocol, so components can be dealt " "with via their indices, too. Also refer to :ref:`SequenceTypes`." msgstr "이 클래스는 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 처리할 수도 있습니다. :ref:`SequenceTypes` 도 참조하세요." #: ../../quad.rst:145 cf59f6059ec346a4adf6477b2af26440 msgid "Algebra and Containment Checks" msgstr "대수 및 포함 확인" #: ../../quad.rst:146 d1da8ae52c66485c81bd76a086dda1ed msgid "" "Starting with v1.19.6, quads can be used in algebraic expressions like " "the other geometry object -- the respective restrictions have been " "lifted. In particular, all the following combinations of containment " "checking are now possible:" msgstr "v1.19.6부터 quad는 다른 기하 객체처럼 대수 표현식에서 사용할 수 있습니다 -- 해당 제한이 해제되었습니다. 특히, 다음 포함 확인 조합이 모두 가능합니다:" #: ../../quad.rst:148 de141e1e28bb41bab1a153f2f74dec9c msgid "`{Point | IRect | Rect | Quad} in {IRect | Rect | Quad}`" msgstr "`{Point | IRect | Rect | Quad} in {IRect | Rect | Quad}`" #: ../../quad.rst:150 7822fe7129d44ee09c76eff91fe1b539 msgid "Please note the following interesting detail:" msgstr "다음 흥미로운 세부 사항을 참고하세요:" #: ../../quad.rst:152 323318c4e76344b0a9f47f1f586de2c4 msgid "" "For a rectangle, only its top-left point belongs to it. Since v1.19.0, " "rectangles are defined to be \"open\", such that its bottom and its right" " edge do not belong to it -- including the respective corners. But for " "quads there exists no such notion like \"openness\", so we have the " "following somewhat surprising implication:" msgstr "사각형의 경우, 왼쪽 위 점만 속합니다. v1.19.0부터 사각형은 \"열림\"으로 정의되어 아래쪽과 오른쪽 가장자리는 속하지 않습니다 -- 해당 모서리 포함. 하지만 quad에는 \"열림\"과 같은 개념이 없으므로 다음과 같은 다소 놀라운 함의가 있습니다:" #: ../../footer.rst:46 e7b27ac0bf7e4265b14be6be7b5ca967 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/rag.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9ae2958084504b3cbf245bd73a2ab2b9 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 f48bded6e5a0490fbc182596e6c86f50 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c3968fe2fa604ee2a68fdd576c733553 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../rag.rst:6 d9c164003dda4429a6f39b4abd473e49 msgid "PyMuPDF, LLM & RAG" msgstr "PyMuPDF, LLM 및 RAG" #: ../../rag.rst:9 f18a0f62e26e4863b32ba327cc3828fe msgid "" "Integrating |PyMuPDF| into your :title:`Large Language Model (LLM)` " "framework and overall :title:`RAG (Retrieval-Augmented Generation`) " "solution provides the fastest and most reliable way to deliver document " "data." msgstr "|PyMuPDF| 를 :title:`Large Language Model (LLM)` 프레임워크 및 전체 :title:`RAG (Retrieval-Augmented Generation)` 솔루션에 통합하면 문서 데이터를 제공하는 가장 빠르고 신뢰할 수 있는 방법을 제공합니다." #: ../../rag.rst:11 6e23dfb312db4517ab86e93891470aed msgid "" "There are a few well known :title:`LLM` solutions which have their own " "interfaces with |PyMuPDF| - it is a fast growing area, so please let us " "know if you discover any more!" msgstr "|PyMuPDF| 와 자체 인터페이스를 가진 몇 가지 잘 알려진 :title:`LLM` 솔루션이 있습니다. 빠르게 성장하는 분야이므로 더 발견하시면 알려주세요!" #: ../../rag.rst:13 8de65ced808e469d9fac7bd41abaf9cf msgid "" "If you need to export to :title:`Markdown` or obtain a " ":title:`LlamaIndex` Document from a file:" msgstr ":title:`Markdown` 으로 내보내거나 파일에서 :title:`LlamaIndex` 문서를 얻어야 하는 경우:" #: ../../rag.rst:31 0e6f773ad0c846eb81ad529f37c724ce msgid "Integration with :title:`LangChain`" msgstr ":title:`LangChain` 과의 통합" #: ../../rag.rst:33 617c7d9b690c427cb4d5f385dbaea902 msgid "" "It is simple to integrate directly with :title:`LangChain` by using their" " dedicated loader as follows:" msgstr "다음과 같이 전용 로더를 사용하여 :title:`LangChain` 과 직접 통합하는 것은 간단합니다:" #: ../../rag.rst:43 2b8a08a537ff4f0c9d20ccd117cca1c7 msgid "" "See `LangChain Using PyMuPDF " "`_ for full details." msgstr "자세한 내용은 `LangChain Using PyMuPDF `_ 를 참조하세요." #: ../../rag.rst:47 882dd97452644713ade70ec5d297ac45 msgid "Integration with :title:`LlamaIndex`" msgstr ":title:`LlamaIndex` 와의 통합" #: ../../rag.rst:50 0a3eaf04eb9c4726a40af71757d7454d msgid "" "Use the dedicated `PyMuPDFReader` from :title:`LlamaIndex` 🦙 to manage " "your document loading." msgstr ":title:`LlamaIndex` 🦙 의 전용 `PyMuPDFReader` 를 사용하여 문서 로딩을 관리하세요." #: ../../rag.rst:58 49e6d30976b047949da389fa02a61f6d msgid "" "See `Building RAG from Scratch " "`_" " for more." msgstr "자세한 내용은 `Building RAG from Scratch `_ 를 참조하세요." #: ../../rag.rst:62 a966faf5a5914f53816c15fa2dc9cf18 msgid "Preparing Data for Chunking" msgstr "청킹을 위한 데이터 준비" #: ../../rag.rst:64 c943a32cc39448f396304fd518f9a003 msgid "" "Chunking (or splitting) data is essential to give context to your " ":title:`LLM` data and with :title:`Markdown` output now supported by " "|PyMuPDF| this means that `Level 3 chunking " "`_ is " "supported." msgstr "데이터 청킹(또는 분할)은 :title:`LLM` 데이터에 컨텍스트를 제공하는 데 필수적이며, |PyMuPDF| 가 이제 :title:`Markdown` 출력을 지원하므로 `Level 3 chunking `_ 이 지원됨을 의미합니다." #: ../../rag.rst:71 c1d64297cf6740508697a6569cd86382 msgid "Outputting as :title:`Markdown`" msgstr ":title:`Markdown` 으로 출력" #: ../../rag.rst:73 39636d4fa0cf42edb1f1e408555643f2 msgid "" "In order to export your document in :title:`Markdown` format you will " "need a separate helper. Package :doc:`pymupdf4llm/index` is a high-level " "wrapper of |PyMuPDF| functions which for each page outputs standard and " "table text in an integrated Markdown-formatted string across all document" " pages:" msgstr ":title:`Markdown` 형식으로 문서를 내보내려면 별도의 헬퍼가 필요합니다. 패키지 :doc:`pymupdf4llm/index` 는 |PyMuPDF| 함수의 고수준 래퍼로, 각 페이지에 대해 모든 문서 페이지에 걸쳐 통합된 Markdown 형식 문자열로 표준 텍스트와 테이블 텍스트를 출력합니다:" #: ../../rag.rst:87 ab3bd85d9da04f3288b59385ab304c9a msgid "For further information please refer to: :doc:`pymupdf4llm/index`." msgstr "자세한 내용은 :doc:`pymupdf4llm/index` 를 참조하세요." #: ../../rag.rst:91 0e0368f9987d4fd6989fb56fb6001afd msgid "How to use :title:`Markdown` output" msgstr ":title:`Markdown` 출력 사용 방법" #: ../../rag.rst:93 7bbbb34419cf4138a90d6f32225fd2c0 msgid "" "Once you have your data in :title:`Markdown` format you are ready to " "chunk/split it and supply it to your :title:`LLM`, for example, if this " "is :title:`LangChain` then do the following:" msgstr ":title:`Markdown` 형식의 데이터가 준비되면 청킹/분할하여 :title:`LLM` 에 제공할 준비가 됩니다. 예를 들어, 이것이 :title:`LangChain` 인 경우 다음을 수행하세요:" #: ../../rag.rst:109 e0cd08f28f6b4684b8212adaecee1134 msgid "" "For more see `5 Levels of Text Splitting `_" msgstr "자세한 내용은 `5 Levels of Text Splitting `_ 를 참조하세요." #: ../../rag.rst:113 59da1458c9df47cf875bc76ea4b09c0f msgid "Related Blogs" msgstr "관련 블로그" #: ../../rag.rst:115 fc915048dbc24e0fbbb2afab1ec5ea4c msgid "" "To find out more about |PyMuPDF|, :title:`LLM` & :title:`RAG` check out " "our blogs for implementations & tutorials." msgstr "|PyMuPDF|, :title:`LLM` 및 :title:`RAG` 에 대한 자세한 내용은 구현 및 튜토리얼 블로그를 확인하세요." #: ../../rag.rst:119 0122bc55056941f1ab375130d1567c25 msgid "Methodologies to Extract Text" msgstr "텍스트 추출 방법론" #: ../../rag.rst:121 e7a6690e847f451e86a01250978a6578 msgid "" "`Enhanced Text Extraction `_" msgstr "`Enhanced Text Extraction `_" #: ../../rag.rst:122 04321925122b427b86774ef96ad18527 msgid "" "`Conversion to Markdown Text with PyMuPDF `_" msgstr "`Conversion to Markdown Text with PyMuPDF `_" #: ../../rag.rst:127 60562c518d964c8090b1290cd59e6a19 msgid "Create a Chatbot to discuss your documents" msgstr "문서를 논의하기 위한 챗봇 만들기" #: ../../rag.rst:129 20a7402279fa4414b283adebd82344bd msgid "" "`Make a simple command line Chatbot `_" msgstr "`Make a simple command line Chatbot `_" #: ../../rag.rst:130 68ea640af63a45c382ba8d71fc1796ca msgid "" "`Make a Chatbot GUI `_" msgstr "`Make a Chatbot GUI `_" #: ../../footer.rst:46 e79c14c4775649ff81f129c4ebc2dcb1 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-annotations.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 e39981b2c0484073b422a752a1279263 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 a25bcd51270e4dff8f4dd98b5a7d2ea7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 ffd0e115b0694217a5c11e90d1c837a8 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-annotations.rst:7 12ff591c90a64c459b910af4df023591 msgid "Annotations" msgstr "주석" #: ../../recipes-annotations.rst:12 bc44c8128be246918c791ea26fd73fee msgid "How to Add and Modify Annotations" msgstr "주석 추가 및 수정 방법" #: ../../recipes-annotations.rst:14 a59a46aeff5e4ef494d91210cfb5db2a msgid "" "In |PyMuPDF|, new annotations can be added via :ref:`Page` methods. Once " "an annotation exists, it can be modified to a large extent using methods " "of the :ref:`Annot` class." msgstr "|PyMuPDF| 에서는 :ref:`Page` 메서드를 통해 새로운 주석을 추가할 수 있습니다. 주석이 존재하면 :ref:`Annot` 클래스의 메서드를 사용하여 대부분 수정할 수 있습니다." #: ../../recipes-annotations.rst:16 a3c0373aeefa401f92881e510ad0071c msgid "" "Annotations can **only** be inserted in |PDF| pages - other document " "types do not support annotation insertion." msgstr "주석은 |PDF| 페이지에만 삽입할 수 있습니다. 다른 문서 유형은 주석 삽입을 지원하지 않습니다." #: ../../recipes-annotations.rst:18 46c6f65e527d46acadde2b136d169470 msgid "" "In contrast to many other tools, initial insert of annotations happens " "with a minimum number of properties. We leave it to the programmer to " "e.g. set attributes like author, creation date or subject." msgstr "다른 많은 도구와 달리, 주석의 초기 삽입은 최소한의 속성으로 수행됩니다. 예를 들어 작성자, 생성 날짜 또는 제목과 같은 속성을 설정하는 것은 프로그래머에게 맡깁니다." #: ../../recipes-annotations.rst:20 d729f5e88c444e6c9303c4deddaa0a97 msgid "" "As an overview for these capabilities, look at the following script that " "fills a PDF page with most of the available annotations. Look in the next" " sections for more special situations:" msgstr "이러한 기능에 대한 개요로, 사용 가능한 대부분의 주석으로 PDF 페이지를 채우는 다음 스크립트를 참조하세요. 더 특수한 상황에 대해서는 다음 섹션을 참조하세요:" #: ../../recipes-annotations.rst:26 b668508bf5a2442aaea6ff355de90c9a msgid "This script should lead to the following output:" msgstr "이 스크립트는 다음과 같은 출력을 생성해야 합니다:" #: ../../recipes-annotations.rst:36 8a364e58ae174ad9b402e789c6a65d86 msgid "How to Use FreeText" msgstr "FreeText 사용 방법" #: ../../recipes-annotations.rst:37 0369d14436b04373b454e0cbe29a65b3 msgid "" "This script shows a couple of basic ways to deal with 'FreeText' " "annotations:" msgstr "이 스크립트는 'FreeText' 주석을 처리하는 몇 가지 기본 방법을 보여줍니다:" #: ../../recipes-annotations.rst:41 ../../recipes-annotations.rst:50 #: 1a21cf6f40874661841ad5000a08a6fb 3ca839e69a444b2db34029d783dc79c4 msgid "The result looks like this:" msgstr "결과는 다음과 같습니다:" #: ../../recipes-annotations.rst:46 f9f8bbc9486f42ef87d4c3f349be31d1 msgid "Here is an example for using rich text and call-out lines:" msgstr "다음은 서식 있는 텍스트와 설명선을 사용하는 예제입니다:" #: ../../recipes-annotations.rst:63 cf8c08007d894233a60344bfbafb0253 msgid "How to Use Ink Annotations" msgstr "잉크 주석 사용 방법" #: ../../recipes-annotations.rst:64 c0d699327401467ca37c7e4396f3235b msgid "" "Ink annotations are used to contain freehand scribbling. A typical " "example may be an image of your signature consisting of first name and " "last name. Technically an ink annotation is implemented as a **list of " "lists of points**. Each point list is regarded as a continuous line " "connecting the points. Different point lists represent independent line " "segments of the annotation." msgstr "잉크 주석은 손으로 그린 낙서를 포함하는 데 사용됩니다. 일반적인 예로는 이름과 성으로 구성된 서명 이미지가 있을 수 있습니다. 기술적으로 잉크 주석은 **점 목록의 목록** 으로 구현됩니다. 각 점 목록은 점을 연결하는 연속 선으로 간주됩니다. 서로 다른 점 목록은 주석의 독립적인 선 세그먼트를 나타냅니다." #: ../../recipes-annotations.rst:66 9f3baa89959f4c559f8a04c132d4ef39 msgid "" "The following script creates an ink annotation with two mathematical " "curves (sine and cosine function graphs) as line segments:" msgstr "다음 스크립트는 두 개의 수학 곡선(사인 및 코사인 함수 그래프)을 선 세그먼트로 사용하여 잉크 주석을 생성합니다:" #: ../../recipes-annotations.rst:70 3f0535a897bd412ab755434fe5c5677e msgid "This is the result:" msgstr "결과는 다음과 같습니다:" #: ../../footer.rst:46 921b64bf6be94ffdbd4576b585c70ed6 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-common-issues-and-their-solutions.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b2d82d593c664654bc418e7afdf9e7b4 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 b78b5807c07e4a528626a4138223e8de msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 5b3592575d784e428d8d959c1aa99173 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../recipes-common-issues-and-their-solutions.rst:7 #: cee0b81d77af4629884ac5a2a380da5c msgid "Common Issues and their Solutions" msgstr "일반적인 문제 및 해결 방법" #: ../../recipes-common-issues-and-their-solutions.rst:10 #: 947c39129d6446e094c38d03760b989a msgid "How To Dynamically Clean Up Corrupt :title:`PDFs`" msgstr "손상된 :title:`PDF` 를 동적으로 정리하는 방법" #: ../../recipes-common-issues-and-their-solutions.rst:12 #: 984b7de620ae4755bdc3dd0117a5c862 msgid "" "This shows a potential use of |PyMuPDF| with another Python PDF library " "(the excellent pure Python package `pdfrw " "`_ is used here as an example)." msgstr "이것은 다른 Python PDF 라이브러리와 함께 |PyMuPDF| 를 사용하는 잠재적 사용 사례를 보여줍니다(여기서는 우수한 순수 Python 패키지 `pdfrw `_ 를 예제로 사용합니다)." #: ../../recipes-common-issues-and-their-solutions.rst:14 #: efd17fd3443d4f67899e6f4e8c9bf24e msgid "" "If a clean, non-corrupt / decompressed PDF is needed, one could " "dynamically invoke PyMuPDF to recover from many problems like so::" msgstr "깨끗하고 손상되지 않은/압축 해제된 PDF가 필요한 경우, 다음과 같이 |PyMuPDF| 를 동적으로 호출하여 많은 문제에서 복구할 수 있습니다::" #: ../../recipes-common-issues-and-their-solutions.rst:50 #: 3936184480104b60b59e5f2d35b8ae89 msgid "" "With the command line utility *pdftk* (`available " "`_ for Windows " "only, but reported to also run under `Wine `_) a" " similar result can be achieved, see `here " "`_. " "However, you must invoke it as a separate process via *subprocess.Popen*," " using stdin and stdout as communication vehicles." msgstr "명령줄 유틸리티 *pdftk* (`available `_ 는 Windows 전용이지만 `Wine `_ 에서도 실행된다고 보고됨)를 사용하여 유사한 결과를 얻을 수 있습니다. 자세한 내용은 `here `_ 를 참조하세요. 하지만 stdin과 stdout을 통신 수단으로 사용하여 *subprocess.Popen* 을 통해 별도 프로세스로 호출해야 합니다." #: ../../recipes-common-issues-and-their-solutions.rst:55 #: fe7e596e66ca4a86a1fe34324a9a62b4 msgid "How to Convert Any Document to |PDF|" msgstr "모든 문서를 |PDF| 로 변환하는 방법" #: ../../recipes-common-issues-and-their-solutions.rst:57 #: ac5c06eafcda49af9010b5dfe0e339ba msgid "" "Here is a script that converts any |PyMuPDF| :ref:`supported " "document` to a |PDF|. These include XPS, EPUB, FB2," " CBZ and image formats, including multi-page TIFF images." msgstr "다음은 |PyMuPDF| 가 :ref:`지원하는 문서` 를 |PDF| 로 변환하는 스크립트입니다. 여기에는 XPS, EPUB, FB2, CBZ 및 다중 페이지 TIFF 이미지를 포함한 이미지 형식이 포함됩니다." #: ../../recipes-common-issues-and-their-solutions.rst:59 #: 256a7ef1c5ab469695bfaa2724670908 msgid "" "It features maintaining any metadata, table of contents and links " "contained in the source document::" msgstr "소스 문서에 포함된 모든 메타데이터, 목차 및 링크를 유지하는 기능이 있습니다::" #: ../../recipes-common-issues-and-their-solutions.rst:131 #: 5aee482ebb684ec799994f2a82dbfc75 msgid "Changing Annotations: Unexpected Behaviour" msgstr "주석 변경: 예상치 못한 동작" #: ../../recipes-common-issues-and-their-solutions.rst:134 #: cc0c26247fea4639ae1751eb8901a600 msgid "Problem" msgstr "문제" #: ../../recipes-common-issues-and-their-solutions.rst:135 #: 70437532335143b8b58a1d4c9a8568cb msgid "There are two scenarios:" msgstr "두 가지 시나리오가 있습니다:" #: ../../recipes-common-issues-and-their-solutions.rst:137 #: 081715c0d34b4ed6b9e63c8a63a7ac2d msgid "" "**Updating** an annotation with PyMuPDF which was created by some other " "software." msgstr "다른 소프트웨어로 생성된 주석을 |PyMuPDF| 로 **업데이트** 하는 경우." #: ../../recipes-common-issues-and-their-solutions.rst:138 #: c4827e1b0a8f4af4ad46ecbb0abffa2b msgid "" "**Creating** an annotation with PyMuPDF and later changing it with some " "other software." msgstr "|PyMuPDF| 로 주석을 **생성** 한 후 다른 소프트웨어로 변경하는 경우." #: ../../recipes-common-issues-and-their-solutions.rst:140 #: 4237e934234748d3abf9e524336a4243 msgid "" "In both cases you may experience unintended changes, like a different " "annotation icon or text font, the fill color or line dashing have " "disappeared, line end symbols have changed their size or even have " "disappeared too, etc." msgstr "두 경우 모두 주석 아이콘이나 텍스트 글꼴이 다르게 표시되거나, 채우기 색상이나 선의 파선이 사라지거나, 선 끝 기호의 크기가 변경되거나 사라지는 등의 의도하지 않은 변경이 발생할 수 있습니다." #: ../../recipes-common-issues-and-their-solutions.rst:143 #: ../../recipes-common-issues-and-their-solutions.rst:182 #: ../../recipes-common-issues-and-their-solutions.rst:195 #: 0110a2da1aa6417a956feea6fd30428c 32fb7855910549f2ad7c953701ac3c0e #: c6624f27d1fa44b2a2f88b1c10495ca9 msgid "Cause" msgstr "원인" #: ../../recipes-common-issues-and-their-solutions.rst:144 #: 0c44e7ae5501406d90e73396b2cfde02 msgid "" "Annotation maintenance is handled differently by each PDF maintenance " "application. Some annotation types may not be supported, or not be " "supported fully or some details may be handled in a different way than in" " another application. **There is no standard.**" msgstr "주석 유지 관리는 각 PDF 유지 관리 애플리케이션마다 다르게 처리됩니다. 일부 주석 유형은 지원되지 않거나 완전히 지원되지 않을 수 있으며, 일부 세부 사항은 다른 애플리케이션과 다른 방식으로 처리될 수 있습니다. **표준이 없습니다.**" #: ../../recipes-common-issues-and-their-solutions.rst:146 #: 11bea0e065f94a779ec3d22653833179 msgid "" "Almost always a PDF application also comes with its own icons (file " "attachments, sticky notes and stamps) and its own set of supported text " "fonts. For example:" msgstr "거의 항상 PDF 애플리케이션은 자체 아이콘(파일 첨부, 스티커 메모 및 스탬프)과 자체 지원 텍스트 글꼴 세트를 제공합니다. 예를 들어:" #: ../../recipes-common-issues-and-their-solutions.rst:148 #: 54046db1813c480aa6d0dfaafd081e7f msgid "" "(Py-) MuPDF only supports these 5 basic fonts for 'FreeText' annotations:" " Helvetica, Times-Roman, Courier, ZapfDingbats and Symbol -- no italics /" " no bold variations. When changing a 'FreeText' annotation created by " "some other app, its font will probably not be recognized nor accepted and" " be replaced by Helvetica." msgstr "(Py-) |MuPDF| 는 'FreeText' 주석에 대해 다음 5가지 기본 글꼴만 지원합니다: Helvetica, Times-Roman, Courier, ZapfDingbats 및 Symbol -- 기울임꼴/굵게 변형 없음. 다른 앱으로 생성된 'FreeText' 주석을 변경할 때 해당 글꼴은 인식되지 않거나 허용되지 않을 가능성이 높으며 Helvetica로 대체됩니다." #: ../../recipes-common-issues-and-their-solutions.rst:150 #: 0616819cfbea4e98806d1310924671ec msgid "" "PyMuPDF supports all PDF text markers (highlight, underline, strikeout, " "squiggly), but these types cannot be updated with Adobe Acrobat Reader." msgstr "|PyMuPDF| 는 모든 PDF 텍스트 마커(강조, 밑줄, 취소선, 물결선)를 지원하지만, 이러한 유형은 Adobe Acrobat Reader로 업데이트할 수 없습니다." #: ../../recipes-common-issues-and-their-solutions.rst:152 #: 7109456d991a465085055b08e8e3e36f msgid "" "In most cases there also exists limited support for line dashing which " "causes existing dashes to be replaced by straight lines. For example:" msgstr "대부분의 경우 선 파선에 대한 제한적인 지원이 있어 기존 파선이 직선으로 대체됩니다. 예를 들어:" #: ../../recipes-common-issues-and-their-solutions.rst:154 #: 832b05a803034cb2b31a6a163b766c80 msgid "" "PyMuPDF fully supports all line dashing forms, while other viewers only " "accept a limited subset." msgstr "|PyMuPDF| 는 모든 선 파선 형식을 완전히 지원하지만, 다른 뷰어는 제한된 하위 집합만 허용합니다." #: ../../recipes-common-issues-and-their-solutions.rst:158 #: 608cca13d68e48038902234a11344e7d msgid "Solutions" msgstr "해결 방법" #: ../../recipes-common-issues-and-their-solutions.rst:159 #: f22d020f442e4ee9a04d2d148fb2e24a msgid "Unfortunately there is not much you can do in most of these cases." msgstr "안타깝게도 대부분의 경우 할 수 있는 일이 많지 않습니다." #: ../../recipes-common-issues-and-their-solutions.rst:161 #: 31e1179fb95e4328b53c8cdba8f45e53 msgid "Stay with the same software for **creating and changing** an annotation." msgstr "주석을 **생성하고 변경** 할 때 동일한 소프트웨어를 사용하세요." #: ../../recipes-common-issues-and-their-solutions.rst:162 #: 2c32e4727b8b4bd8ab345f1bb2dab832 msgid "" "When using PyMuPDF to change an \"alien\" annotation, try to **avoid** " ":meth:`Annot.update`. The following methods **can be used without it,** " "so that the original appearance should be maintained:" msgstr "\"외부\" 주석을 변경할 때 |PyMuPDF| 를 사용하는 경우 :meth:`Annot.update` 를 **피하세요**. 다음 메서드는 **이것 없이 사용할 수 있으며**, 원래 모양이 유지됩니다:" #: ../../recipes-common-issues-and-their-solutions.rst:164 #: 5f2c568a7ab34cd6908429c03002c3b8 msgid ":meth:`Annot.set_rect` (location changes)" msgstr ":meth:`Annot.set_rect` (위치 변경)" #: ../../recipes-common-issues-and-their-solutions.rst:165 #: f970043a80bc4905bfbc38378bef6cf7 msgid ":meth:`Annot.set_flags` (annotation behaviour)" msgstr ":meth:`Annot.set_flags` (주석 동작)" #: ../../recipes-common-issues-and-their-solutions.rst:166 #: 89d8eeabb0864857bebb1dbd0b5837ac msgid ":meth:`Annot.set_info` (meta information, except changes to *content*)" msgstr ":meth:`Annot.set_info` (메타 정보, *content* 변경 제외)" #: ../../recipes-common-issues-and-their-solutions.rst:167 #: 8d145d703a694245bf8816344d618fca msgid ":meth:`Annot.set_popup` (create popup or change its rect)" msgstr ":meth:`Annot.set_popup` (팝업 생성 또는 rect 변경)" #: ../../recipes-common-issues-and-their-solutions.rst:168 #: ec8d39e7fcf1408083026bfb2854b761 msgid "" ":meth:`Annot.set_oc` (add / remove reference to optional content " "information)" msgstr ":meth:`Annot.set_oc` (선택적 콘텐츠 정보에 대한 참조 추가/제거)" #: ../../recipes-common-issues-and-their-solutions.rst:169 #: 6b85081690ed4886ba03d08a836e7b4e msgid ":meth:`Annot.set_open`" msgstr ":meth:`Annot.set_open`" #: ../../recipes-common-issues-and-their-solutions.rst:170 #: 90e51807c8d44cc1861553f1df436100 msgid ":meth:`Annot.update_file` (file attachment changes)" msgstr ":meth:`Annot.update_file` (파일 첨부 변경)" #: ../../recipes-common-issues-and-their-solutions.rst:174 #: dee4c83bcb6a49afb8cd17e74037844d msgid "Missing or Unreadable Extracted Text" msgstr "누락되거나 읽을 수 없는 추출된 텍스트" #: ../../recipes-common-issues-and-their-solutions.rst:175 #: c1c8dec56daa4bac965e78b95eb48c58 msgid "" "Fairly often, text extraction does not work text as you would expect: " "text may be missing, or may not appear in the reading sequence visible on" " your screen, or contain garbled characters (like a ? or a \"TOFU\" " "symbol), etc. This can be caused by a number of different problems." msgstr "텍스트 추출이 예상대로 작동하지 않는 경우가 많습니다: 텍스트가 누락되거나 화면에 표시되는 읽기 순서에 나타나지 않거나 문자 깨짐(예: ? 또는 \"TOFU\" 기호)이 포함될 수 있습니다. 이것은 여러 다른 문제로 인해 발생할 수 있습니다." #: ../../recipes-common-issues-and-their-solutions.rst:178 #: 1339e236dda1461f94aa74a5c03ef680 msgid "Problem: no text is extracted" msgstr "문제: 텍스트가 추출되지 않음" #: ../../recipes-common-issues-and-their-solutions.rst:179 #: 10f358276c8043138089b5f17c8602a0 msgid "" "Your PDF viewer does display text, but you cannot select it with your " "cursor, and text extraction delivers nothing." msgstr "PDF 뷰어는 텍스트를 표시하지만 커서로 선택할 수 없고 텍스트 추출 결과가 없습니다." #: ../../recipes-common-issues-and-their-solutions.rst:183 #: f6463d656f7d4526b79aa27ea3adcfd6 msgid "" "You may be looking at an image embedded in the PDF page (e.g. a scanned " "PDF)." msgstr "PDF 페이지에 포함된 이미지를 보고 있을 수 있습니다(예: 스캔된 PDF)." #: ../../recipes-common-issues-and-their-solutions.rst:184 #: 4bda75cc75a84b058bdf9ae2b455a597 msgid "" "The PDF creator used no font, but **simulated** text by painting it, " "using little lines and curves. E.g. a capital \"D\" could be painted by a" " line \"|\" and a left-open semi-circle, an \"o\" by an ellipse, and so " "on." msgstr "PDF 작성자가 글꼴을 사용하지 않고 작은 선과 곡선을 사용하여 텍스트를 **시뮬레이션** 했습니다. 예를 들어 대문자 \"D\"는 선 \"|\"와 왼쪽 열린 반원으로 그려질 수 있고, \"o\"는 타원으로 그려질 수 있습니다." #: ../../recipes-common-issues-and-their-solutions.rst:187 #: ../../recipes-common-issues-and-their-solutions.rst:200 #: 4c8ffe1feebe4a46ba615d636a0cf8c7 5ba7c372d3a145a2983fe0d7161d79c0 msgid "Solution" msgstr "해결 방법" #: ../../recipes-common-issues-and-their-solutions.rst:188 #: b4995dfcae78413486e26863052e0649 msgid "" "Use an OCR software like `OCRmyPDF `_" " to insert a hidden text layer underneath the visible page. The resulting" " PDF should behave as expected." msgstr "`OCRmyPDF `_ 와 같은 OCR 소프트웨어를 사용하여 표시되는 페이지 아래에 숨겨진 텍스트 레이어를 삽입하세요. 결과 PDF는 예상대로 작동해야 합니다." #: ../../recipes-common-issues-and-their-solutions.rst:191 #: 1288979557ce452bb405ebe625a9fe85 msgid "Problem: unreadable text" msgstr "문제: 읽을 수 없는 텍스트" #: ../../recipes-common-issues-and-their-solutions.rst:192 #: b9738107688a468fb12503d2923c9223 msgid "" "Text extraction does not deliver the text in readable order, duplicates " "some text, or is otherwise garbled." msgstr "텍스트 추출이 읽을 수 있는 순서로 텍스트를 제공하지 않거나, 일부 텍스트가 중복되거나, 그렇지 않으면 문자 깨짐이 발생합니다." #: ../../recipes-common-issues-and-their-solutions.rst:196 #: 1287dd9e37d94aae87d08382d28337b0 msgid "" "The single characters are readable as such (no \"\" symbols), but the " "sequence in which the text is **coded in the file** deviates from the " "reading order. The motivation behind may be technical or protection of " "data against unwanted copies." msgstr "개별 문자는 읽을 수 있지만( \"\" 기호 없음), 텍스트가 **파일에 인코딩된** 순서가 읽기 순서와 다릅니다. 그 배경에는 기술적 이유나 원치 않는 복사로부터 데이터를 보호하려는 의도가 있을 수 있습니다." #: ../../recipes-common-issues-and-their-solutions.rst:197 #: f63ebf6449ee40bdaa62ce0cbe979f7b msgid "" "Many \"\" symbols occur, indicating MuPDF could not interpret these " "characters. The font may indeed be unsupported by MuPDF, or the PDF " "creator may haved used a font that displays readable text, but on purpose" " obfuscates the originating corresponding unicode character." msgstr "많은 \"\" 기호가 발생하여 |MuPDF| 가 이러한 문자를 해석할 수 없음을 나타냅니다. 글꼴이 실제로 |MuPDF| 에서 지원되지 않을 수 있거나, PDF 작성자가 읽을 수 있는 텍스트를 표시하지만 의도적으로 원본 해당 유니코드 문자를 난독화하는 글꼴을 사용했을 수 있습니다." #: ../../recipes-common-issues-and-their-solutions.rst:201 #: 70176f300c204737999ad6e71bb79baa msgid "Use layout preserving text extraction: `python -m fitz gettext file.pdf`." msgstr "레이아웃을 유지하는 텍스트 추출을 사용하세요: `python -m fitz gettext file.pdf`." #: ../../recipes-common-issues-and-their-solutions.rst:202 #: 4b4ceb3c473b47a9b06e9bb658885b14 msgid "" "If other text extraction tools also don't work, then the only solution " "again is OCRing the page." msgstr "다른 텍스트 추출 도구도 작동하지 않으면, 다시 유일한 해결책은 페이지를 OCR 처리하는 것입니다." #: ../../footer.rst:46 07c9714719d541aeb1f5ae9b443f8e23 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-drawing-and-graphics.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a59582325d1e4587841306a803482970 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 90e5418f2a4041ddb379751a155076c1 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 cbdc25861a8d484890d2227e3494b661 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-drawing-and-graphics.rst:7 dab2a6c85f334d099e76c1c25fc379f3 msgid "Drawing and Graphics" msgstr "그리기 및 그래픽" #: ../../recipes-drawing-and-graphics.rst:11 a70f821282c64602b5f57347f8a0bae4 msgid "" "When the terms \"Drawings\" or \"Graphics\" are mentioned here we are " "referring to \"Vector Graphics\" or \"Line Art\"." msgstr "여기서 \"Drawings\" 또는 \"Graphics\"라는 용어가 언급될 때는 \"벡터 그래픽\" 또는 \"선화\"를 의미합니다." #: ../../recipes-drawing-and-graphics.rst:13 93510784237c4c4b885dc832f8aaeb1f msgid "Therefore please consider these terms as being synonymous!" msgstr "따라서 이러한 용어를 동의어로 간주하세요!" #: ../../recipes-drawing-and-graphics.rst:16 df755690b5be464ab98f1f6014fc5132 msgid "" "PDF files support elementary drawing operations as part of their syntax. " "These are **vector graphics** and include basic geometrical objects like " "lines, curves, circles, rectangles including specifying colors." msgstr "PDF 파일은 구문의 일부로 기본 그리기 작업을 지원합니다. 이것들은 **벡터 그래픽** 이며 선, 곡선, 원, 사각형과 같은 기본 기하학적 객체를 포함하며 색상 지정도 포함합니다." #: ../../recipes-drawing-and-graphics.rst:18 a7dfbdbdeeb54c68afa0bbf219b2f3ba msgid "" "The syntax for such operations is defined in \"A Operator Summary\" on " "page 643 of the :ref:`AdobeManual`. Specifying these operators for a PDF " "page happens in its :data:`contents` objects." msgstr "이러한 작업의 구문은 :ref:`AdobeManual` 의 643페이지의 \"A Operator Summary\"에 정의되어 있습니다. PDF 페이지에 대한 이러한 연산자 지정은 해당 :data:`contents` 객체에서 수행됩니다." #: ../../recipes-drawing-and-graphics.rst:20 463f264141f64e68b6fbe2cd2f02fbbb msgid "" "|PyMuPDF| implements a large part of the available features via its " ":ref:`Shape` class, which is comparable to notions like \"canvas\" in " "other packages (e.g. `reportlab `_)." msgstr "|PyMuPDF| 는 :ref:`Shape` 클래스를 통해 사용 가능한 기능의 대부분을 구현하며, 이는 다른 패키지(예: `reportlab `_)의 \"canvas\"와 같은 개념과 유사합니다." #: ../../recipes-drawing-and-graphics.rst:22 d166a046958a49a8a28311049458c79a msgid "" "A shape is always created as a **child of a page**, usually with an " "instruction like `shape = page.new_shape()`. The class defines numerous " "methods that perform drawing operations on the page's area. For example, " "`last_point = shape.draw_rect(rect)` draws a rectangle along the borders " "of a suitably defined `rect = pymupdf.Rect(...)`." msgstr "Shape는 항상 **페이지의 자식** 으로 생성되며, 일반적으로 `shape = page.new_shape()` 와 같은 명령으로 생성됩니다. 이 클래스는 페이지 영역에서 그리기 작업을 수행하는 여러 메서드를 정의합니다. 예를 들어, `last_point = shape.draw_rect(rect)` 는 적절히 정의된 `rect = pymupdf.Rect(...)` 의 경계를 따라 사각형을 그립니다." #: ../../recipes-drawing-and-graphics.rst:24 4b3375c816d64b008ab7d1854be54f7a msgid "" "The returned *last_point* **always** is the :ref:`Point` where drawing " "operation ended (\"last point\"). Every such elementary drawing requires " "a subsequent :meth:`Shape.finish` to \"close\" it, but there may be " "multiple drawings which have one common ``finish()`` method." msgstr "반환된 *last_point* 는 **항상** 그리기 작업이 끝난 :ref:`Point` (\"마지막 점\")입니다. 이러한 모든 기본 그리기는 \"닫기\"를 위해 후속 :meth:`Shape.finish` 가 필요하지만, 하나의 공통 ``finish()`` 메서드를 가진 여러 그리기가 있을 수 있습니다." #: ../../recipes-drawing-and-graphics.rst:26 f14edc2fb2be4ab8ba19ffdb3740738d msgid "" "In fact, :meth:`Shape.finish` *defines* a group of preceding draw " "operations to form one -- potentially rather complex -- graphics object. " "|PyMuPDF| provides several predefined graphics in `shapes_and_symbols.py " "`_ which demonstrate " "how this works." msgstr "실제로 :meth:`Shape.finish` 는 앞선 그리기 작업 그룹을 하나의 잠재적으로 복잡한 그래픽 객체로 형성하도록 *정의* 합니다. |PyMuPDF| 는 이것이 어떻게 작동하는지 보여주는 `shapes_and_symbols.py `_ 에 여러 사전 정의된 그래픽을 제공합니다." #: ../../recipes-drawing-and-graphics.rst:28 c9bdfffa82e64c1d8431f654e9925619 msgid "" "If you import this script, you can also directly use its graphics as in " "the following example::" msgstr "이 스크립트를 가져오면 다음 예제와 같이 그래픽을 직접 사용할 수도 있습니다::" #: ../../recipes-drawing-and-graphics.rst:86 e4c7e6930be54525bd756ddc32d931d2 msgid "This is the script's outcome:" msgstr "이것은 스크립트의 결과입니다:" #: ../../recipes-drawing-and-graphics.rst:97 63f4873345ad4432a9dcf2f213c921ca msgid "How to Extract Drawings" msgstr "그리기 추출 방법" #: ../../recipes-drawing-and-graphics.rst:99 c269bccda59e4ce1be7bfbb7665979a2 msgid "New in v1.18.0" msgstr "v1.18.0의 새로운 기능" #: ../../recipes-drawing-and-graphics.rst:101 99437db9d3344f56937dc3ef539d724e msgid "" "Drawing commands (**vector graphics**) issued by a page can be extracted " "as a list of dictionaries. Interestingly, this is possible for :ref:`all " "supported document types` -- not just PDF: so you " "can use it for XPS, EPUB and others as well." msgstr "페이지에서 발행한 그리기 명령(**벡터 그래픽**)은 딕셔너리 목록으로 추출할 수 있습니다. 흥미롭게도 이것은 :ref:`모든 지원 문서 유형` 에 대해 가능합니다. PDF뿐만 아니라 XPS, EPUB 등에도 사용할 수 있습니다." #: ../../recipes-drawing-and-graphics.rst:103 9746769ddda943309de190bcae0ff9fe msgid "" "Page method, :meth:`Page.get_drawings()` accesses draw commands and " "converts them into a list of Python dictionaries. Each dictionary -- " "called a \"path\" -- represents a separate drawing -- it may be simple " "like a single line, or a complex combination of lines and curves " "representing one of the shapes of the previous section." msgstr "페이지 메서드 :meth:`Page.get_drawings()` 는 그리기 명령에 액세스하여 Python 딕셔너리 목록으로 변환합니다. 각 딕셔너리( \"path\" 라고 함)는 별도의 그리기를 나타냅니다. 단일 선과 같이 간단할 수도 있고, 이전 섹션의 모양 중 하나를 나타내는 선과 곡선의 복잡한 조합일 수도 있습니다." #: ../../recipes-drawing-and-graphics.rst:105 3a7f618513034c8e9ef3833145ea41c1 msgid "" "The *path* dictionary has been designed such that it can easily be used " "by the :ref:`Shape` class and its methods. Here is an example for a page " "with one path, that draws a red-bordered yellow circle inside rectangle " "`Rect(100, 100, 200, 200)`::" msgstr "*path* 딕셔너리는 :ref:`Shape` 클래스와 그 메서드에서 쉽게 사용할 수 있도록 설계되었습니다. 다음은 하나의 경로를 가진 페이지의 예로, `Rect(100, 100, 200, 200)` 내부에 빨간색 테두리의 노란색 원을 그립니다::" #: ../../recipes-drawing-and-graphics.rst:140 0de0ff2bcd1b4aa4bc87691ca4f375c5 msgid "" "You need (at least) 4 Bézier curves (of 3rd order) to draw a circle with " "acceptable precision. See this `Wikipedia article " "`_ for some background." msgstr "허용 가능한 정밀도로 원을 그리려면 (최소한) 4개의 3차 베지어 곡선이 필요합니다. 배경 정보는 이 `Wikipedia article `_ 를 참조하세요." #: ../../recipes-drawing-and-graphics.rst:143 b621ef3cc79448109301a7679857a685 msgid "" "The following is a code snippet which extracts the drawings of a page and" " re-draws them on a new page::" msgstr "다음은 페이지의 그리기를 추출하여 새 페이지에 다시 그리는 코드 스니펫입니다::" #: ../../recipes-drawing-and-graphics.rst:194 f4c89adbb0a8490d8e03b50a712dcc58 msgid "" "As can be seen, there is a high congruence level with the :ref:`Shape` " "class. With one exception: For technical reasons `lineCap` is a tuple of " "3 numbers here, whereas it is an integer in :ref:`Shape` (and in PDF). So" " we simply take the maximum value of that tuple." msgstr "보시다시피, :ref:`Shape` 클래스와 높은 일치 수준이 있습니다. 한 가지 예외가 있습니다. 기술적 이유로 여기서는 `lineCap` 이 3개의 숫자 튜플이지만, :ref:`Shape` (및 PDF)에서는 정수입니다. 따라서 해당 튜플의 최대값을 사용합니다." #: ../../recipes-drawing-and-graphics.rst:196 782e233251fb459883d5a1434c5a2365 msgid "" "Here is a comparison between input and output of an example page, created" " by the previous script:" msgstr "다음은 이전 스크립트로 생성된 예제 페이지의 입력과 출력 비교입니다:" #: ../../recipes-drawing-and-graphics.rst:201 ceca22c756464670adafb8f59a266f9f msgid "" "The reconstruction of graphics, like shown here, is not perfect. The " "following aspects will not be reproduced as of this version:" msgstr "여기에 표시된 것과 같은 그래픽 재구성은 완벽하지 않습니다. 다음 측면은 이 버전에서 재현되지 않습니다:" #: ../../recipes-drawing-and-graphics.rst:203 4859b04375644a9da37b4c2c286032e9 msgid "" "Page definitions can be complex and include instructions for not showing " "/ hiding certain areas to keep them invisible. Things like this are " "ignored by :meth:`Page.get_drawings` - it will always return all paths." msgstr "페이지 정의는 복잡할 수 있으며 특정 영역을 보이지 않게 유지하기 위해 표시하지 않거나 숨기는 지시를 포함할 수 있습니다. 이러한 사항은 :meth:`Page.get_drawings` 에 의해 무시됩니다. 항상 모든 경로를 반환합니다." #: ../../recipes-drawing-and-graphics.rst:205 0823be3f9f0b4512b042dd4c974406ca msgid "" "You can use the path list to make your own lists of e.g. all lines or all" " rectangles on the page and subselect them by criteria, like color or " "position on the page etc." msgstr "경로 목록을 사용하여 예를 들어 페이지의 모든 선 또는 모든 사각형 목록을 만들고 색상이나 페이지의 위치 등의 기준으로 하위 선택할 수 있습니다." #: ../../recipes-drawing-and-graphics.rst:210 882f949ade2d4b528fbe0a18f15aa51e msgid "How to Delete Drawings" msgstr "그리기 삭제 방법" #: ../../recipes-drawing-and-graphics.rst:212 d9a69d70bb29499381afbb9347fa3ec5 msgid "" "To delete drawings/vector graphics we must use a :ref:`Redaction " "Annotation ` with the bounding box of the drawing " "and then **add and apply** a redaction to it to delete it." msgstr "그리기/벡터 그래픽을 삭제하려면 그리기의 경계 상자를 사용하여 :ref:`Redaction Annotation ` 을 사용한 다음 **추가하고 적용** 하여 삭제해야 합니다." #: ../../recipes-drawing-and-graphics.rst:215 486d33c08c624da1ba4d3f8b61cf54e2 msgid "" "The following code shows an example of deleting the first drawing found " "on the page::" msgstr "다음 코드는 페이지에서 찾은 첫 번째 그리기를 삭제하는 예제를 보여줍니다::" #: ../../recipes-drawing-and-graphics.rst:225 74954d428a74469bae0a628b09803ec9 msgid "" "See :meth:`Page.apply_redactions` for the parameter options which can be " "sent - you are able to apply deletion options to image, drawing and text " "objects which are bound by the annotation area." msgstr "전송할 수 있는 매개변수 옵션은 :meth:`Page.apply_redactions` 를 참조하세요. 주석 영역에 의해 경계가 지정된 이미지, 그리기 및 텍스트 객체에 삭제 옵션을 적용할 수 있습니다." #: ../../recipes-drawing-and-graphics.rst:229 0e3b851a469b4f34b686a303776ff667 msgid "How to Draw Graphics" msgstr "그래픽 그리기 방법" #: ../../recipes-drawing-and-graphics.rst:231 903bdff31610401eba4df3faa0747295 msgid "" "Drawing graphics is as simple as calling the type of :meth:`Drawing " "Method ` you may want. You can draw graphics directly on " "pages or within shape objects." msgstr "그래픽을 그리는 것은 원하는 :meth:`Drawing Method ` 유형을 호출하는 것만큼 간단합니다. 페이지에 직접 또는 shape 객체 내에서 그래픽을 그릴 수 있습니다." #: ../../recipes-drawing-and-graphics.rst:234 c8c7da7541804af39da538bd86a48706 msgid "For example, to draw a circle::" msgstr "예를 들어, 원을 그리려면::" #: ../../recipes-drawing-and-graphics.rst:245 a58742fee8a64d88a569cc24aa989eac msgid "" "The :ref:`Shape` object can be used to combine multiple drawings that " "should receive common properties as specified by :meth:`Shape.finish`." msgstr ":ref:`Shape` 객체는 :meth:`Shape.finish` 에서 지정한 공통 속성을 받아야 하는 여러 그리기를 결합하는 데 사용할 수 있습니다." #: ../../footer.rst:46 b08a651f11954075811284b1a70b5a8c msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-images.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a5170acfd12b43adbefd8dfbe853d226 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 cb2bde859c1349828bd247664168fdad msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 becd9c25862646c28f77d71822cc2c8b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-images.rst:7 4710064fae7342178423b005970103b5 msgid "Images" msgstr "Images" #: ../../recipes-images.rst:14 4e4cf4f2971d49878a83873ab5b972f7 msgid "How to Make Images from Document Pages" msgstr "문서 페이지에서 이미지 만들기" #: ../../recipes-images.rst:16 e9a6e38305b94ba1b80f9f8c8e22ffd0 msgid "" "This little script will take a document filename and generate a PNG file " "from each of its pages." msgstr "이 작은 스크립트는 문서 파일 이름을 받아 각 페이지에서 PNG 파일을 생성합니다." #: ../../recipes-images.rst:18 308acb4260244cb889d8b5e5e696bc88 msgid "The document can be any :ref:`supported type`." msgstr "문서는 :ref:`지원되는 모든 타입` 일 수 있습니다." #: ../../recipes-images.rst:20 a3082189c02c48da807760245885aa8a msgid "" "The script works as a command line tool which expects the filename being " "supplied as a parameter. The generated image files (1 per page) are " "stored in the directory of the script::" msgstr "스크립트는 매개변수로 제공된 파일 이름을 기대하는 명령줄 도구로 작동합니다. 생성된 이미지 파일(페이지당 1개)은 스크립트 디렉토리에 저장됩니다::" #: ../../recipes-images.rst:29 b7e5e6dd24f045f4a09c4f91b7d4fea8 msgid "" "The script directory will now contain PNG image files named *page-0.png*," " *page-1.png*, etc. Pictures have the dimension of their pages with width" " and height rounded to integers, e.g. 595 x 842 pixels for an A4 portrait" " sized page. They will have a resolution of 96 dpi in x and y dimension " "and have no transparency. You can change all that -- for how to do this, " "read the next sections." msgstr "스크립트 디렉토리에는 이제 *page-0.png*, *page-1.png* 등의 PNG 이미지 파일이 포함됩니다. 그림은 페이지의 크기를 가지며 너비와 높이는 정수로 반올림됩니다. 예를 들어 A4 세로 크기 페이지의 경우 595 x 842 픽셀입니다. x 및 y 차원에서 96 dpi의 해상도를 가지며 투명도가 없습니다. 모든 것을 변경할 수 있습니다 -- 방법은 다음 섹션을 참조하세요." #: ../../recipes-images.rst:37 a572d7ea36d948ea96eded0ff8001773 msgid "How to Increase :index:`Image Resolution `" msgstr ":index:`이미지 해상도 ` 높이는 방법" #: ../../recipes-images.rst:39 11a284ffaf7742f6a03127e4d1240761 msgid "" "The image of a document page is represented by a :ref:`Pixmap`, and the " "simplest way to create a pixmap is via method :meth:`Page.get_pixmap`." msgstr "문서 페이지의 이미지는 :ref:`Pixmap` 으로 표현되며, 픽스맵을 생성하는 가장 간단한 방법은 :meth:`Page.get_pixmap` 메서드를 사용하는 것입니다." #: ../../recipes-images.rst:41 feae2612c8c0499e90d765be25a00eac msgid "" "This method has many options to influence the result. The most important " "among them is the :ref:`Matrix`, which lets you :index:`zoom`, rotate, " "distort or mirror the outcome." msgstr "이 메서드는 결과에 영향을 주는 많은 옵션이 있습니다. 그 중 가장 중요한 것은 :index:`확대`, 회전, 왜곡 또는 미러링을 가능하게 하는 :ref:`Matrix` 입니다." #: ../../recipes-images.rst:43 b12ee8c226f44cbaaa494b318449f822 msgid "" ":meth:`Page.get_pixmap` by default will use the :ref:`Identity` matrix, " "which does nothing." msgstr ":meth:`Page.get_pixmap` 은 기본적으로 아무것도 하지 않는 :ref:`Identity` 행렬을 사용합니다." #: ../../recipes-images.rst:45 1b9e0cde360b4b86b79e4a5560753ac9 msgid "" "In the following, we apply a :index:`zoom factor `" " of 2 to each dimension, which will generate an image with a four times " "better resolution for us (and also about 4 times the size)::" msgstr "다음에서는 각 차원에 :index:`확대 배율 ` 2를 적용하여 4배 더 나은 해상도의 이미지를 생성합니다(크기도 약 4배)::" #: ../../recipes-images.rst:53 4b841620223b468290813f2c76bf2f57 msgid "" "Since version 1.19.2 there is a more direct way to set the resolution: " "Parameter `\"dpi\"` (dots per inch) can be used in place of `\"matrix\"`." " To create a 300 dpi image of a page specify `pix = " "page.get_pixmap(dpi=300)`. Apart from notation brevity, this approach has" " the additional advantage that the **dpi value is saved with the image** " "file -- which does not happen automatically when using the Matrix " "notation." msgstr "" "버전 1.19.2부터 해상도를 설정하는 더 직접적인 방법이 있습니다: `\"dpi\"` (인치당 도트 수) 매개변수를 " "`\"matrix\"` 대신 사용할 수 있습니다. 페이지의 300 dpi 이미지를 만들려면 `pix = " "page.get_pixmap(dpi=300)` 을 지정하세요. 표기법의 간결함 외에도, 이 방법의 추가 장점은 **dpi 값이 이미지 " "파일과 함께 저장된다는** 것입니다 -- Matrix 표기법을 사용할 때는 자동으로 발생하지 않습니다." #: ../../recipes-images.rst:61 31bbb7951f74400fb93921872432755d msgid "How to Create :index:`Partial Pixmaps` (Clips)" msgstr ":index:`부분 픽스맵 ` (클립) 생성 방법" #: ../../recipes-images.rst:62 fbadb2ef5dbd470f8a7e831854d224d8 msgid "" "You do not always need or want the full image of a page. This is the case" " e.g. when you display the image in a GUI and would like to fill the " "respective window with a zoomed part of the page." msgstr "" "항상 페이지의 전체 이미지가 필요하거나 원하는 것은 아닙니다. 예를 들어 GUI에서 이미지를 표시하고 해당 창을 페이지의 확대된 부분으로 " "채우고 싶을 때가 그런 경우입니다." #: ../../recipes-images.rst:64 85f7bd7eb0b042c0813c26e94f741bf2 msgid "" "Let's assume your GUI window has room to display a full document page, " "but you now want to fill this room with the bottom right quarter of your " "page, thus using a four times better resolution." msgstr "" "GUI 창에 전체 문서 페이지를 표시할 공간이 있다고 가정하지만, 이제 이 공간을 페이지의 오른쪽 아래 사분면으로 채워 4배 더 나은 " "해상도를 사용하고 싶다고 가정합니다." #: ../../recipes-images.rst:66 29dbb31ae3f94b88b955a6b089ae6df5 msgid "" "To achieve this, define a rectangle equal to the area you want to appear " "in the GUI and call it \"clip\". One way of constructing rectangles in " "PyMuPDF is by providing two diagonally opposite corners, which is what we" " are doing here." msgstr "" "이를 달성하려면 GUI에 표시하려는 영역과 같은 사각형을 정의하고 \"clip\"이라고 부르세요. PyMuPDF에서 사각형을 구성하는 " "방법 중 하나는 대각선으로 반대편에 있는 두 모서리를 제공하는 것이며, 여기서도 그렇게 합니다." #: ../../recipes-images.rst:79 27b90a5d3a3c45eca6798eb33e10e442 msgid "" "In the above we construct *clip* by specifying two diagonally opposite " "points: the middle point *mp* of the page rectangle, and its bottom " "right, *rect.br*." msgstr "" "위에서는 두 개의 대각선 반대편 점을 지정하여 *clip* 을 구성합니다: 페이지 사각형의 중간점 *mp* 와 그 오른쪽 아래 " "*rect.br* 입니다." #: ../../recipes-images.rst:87 bb7f676a34c54b28a8067fefa1aacd1b msgid "How to Zoom a Clip to a GUI Window" msgstr "클립을 GUI 창에 맞게 확대하는 방법" #: ../../recipes-images.rst:88 3c061aaed37648d081263d96cee3321a msgid "" "Please also read the previous section. This time we want to **compute the" " zoom factor** for a clip, such that its image best fits a given GUI " "window. This means, that the image's width or height (or both) will equal" " the window dimension. For the following code snippet you need to provide" " the WIDTH and HEIGHT of your GUI's window that should receive the page's" " clip rectangle." msgstr "" "이전 섹션도 읽어보세요. 이번에는 클립의 **확대 배율을 계산** 하여 이미지가 주어진 GUI 창에 가장 잘 맞도록 합니다. 즉, " "이미지의 너비 또는 높이(또는 둘 다)가 창 크기와 같아집니다. 다음 코드 스니펫을 위해서는 페이지의 클립 사각형을 받을 GUI " "창의 WIDTH와 HEIGHT를 제공해야 합니다." #: ../../recipes-images.rst:105 b3a9b91ee3804e7b8c64ed8a2205e309 msgid "" "For the other way round, now assume you **have** the zoom factor and need" " to **compute the fitting clip**." msgstr "반대로, 이제 **확대 배율이 있고** **맞는 클립을 계산** 해야 한다고 가정합니다." #: ../../recipes-images.rst:107 8ecba4f1cc2d4ce6b5472a6b7d1f6778 msgid "" "In this case we have `zoom = HEIGHT/clip.height = WIDTH/clip.width`, so " "we must set `clip.height = HEIGHT/zoom` and, `clip.width = WIDTH/zoom`. " "Choose the top-left point `tl` of the clip on the page to compute the " "right pixmap::" msgstr "" "이 경우 `zoom = HEIGHT/clip.height = WIDTH/clip.width` 이므로, `clip.height = " "HEIGHT/zoom` 과 `clip.width = WIDTH/zoom` 을 설정해야 합니다. 올바른 픽스맵을 계산하려면 페이지에서 " "클립의 왼쪽 위 지점 `tl` 을 선택하세요::" #: ../../recipes-images.rst:124 a9179194547c43379baf5fb667307041 msgid "How to Create or Suppress Annotation Images" msgstr "주석 이미지 생성 또는 억제 방법" #: ../../recipes-images.rst:125 9cc92f685bcf4d2bafef5da546fbac00 msgid "" "Normally, the pixmap of a page also shows the page's annotations. " "Occasionally, this may not be desirable." msgstr "일반적으로 페이지의 픽스맵은 페이지의 주석도 표시합니다. 때로는 이것이 바람직하지 않을 수 있습니다." #: ../../recipes-images.rst:127 1079c45bc5474873945edff781094f65 msgid "" "To suppress the annotation images on a rendered page, just specify " "`annots=False` in :meth:`Page.get_pixmap`." msgstr "렌더링된 페이지에서 주석 이미지를 억제하려면 :meth:`Page.get_pixmap` 에서 `annots=False` 를 지정하세요." #: ../../recipes-images.rst:129 b141c29860864fde93d41fedac0919b0 msgid "" "You can also render annotations separately: they have their own " ":meth:`Annot.get_pixmap` method. The resulting pixmap has the same " "dimensions as the annotation rectangle." msgstr "" "주석을 별도로 렌더링할 수도 있습니다: 주석에는 자체 :meth:`Annot.get_pixmap` 메서드가 있습니다. 결과 픽스맵은 주석 " "사각형과 동일한 크기를 가집니다." #: ../../recipes-images.rst:141 5f7013ae1124470a83fa5df727f719d1 msgid "How to Extract Images: Non-PDF Documents" msgstr "이미지 추출 방법: 비 PDF 문서" #: ../../recipes-images.rst:143 3b4b1649fadc41cea019b924cd517adc msgid "" "In contrast to the previous sections, this section deals with " "**extracting** images **contained** in documents, so they can be " "displayed as part of one or more pages." msgstr "" "이전 섹션과 달리, 이 섹션은 문서에 **포함된** 이미지를 **추출** 하는 것을 다루므로, 하나 이상의 페이지의 일부로 표시할 수 " "있습니다." #: ../../recipes-images.rst:145 cd906454fde6400783d50eb0297c5b39 msgid "" "If you want to recreate the original image in file form or as a memory " "area, you have basically two options:" msgstr "원본 이미지를 파일 형식 또는 메모리 영역으로 재생성하려면 기본적으로 두 가지 옵션이 있습니다:" #: ../../recipes-images.rst:147 dda6ef39b73f40f8b4b566ccb3d6011e msgid "" "Convert your document to a PDF, and then use one of the PDF-only " "extraction methods. This snippet will convert a document to PDF::" msgstr "문서를 PDF로 변환한 다음 PDF 전용 추출 방법 중 하나를 사용하세요. 이 스니펫은 문서를 PDF로 변환합니다::" #: ../../recipes-images.rst:153 d9d2f8dd08d6424f8418f2300c013bcd msgid "" "Use :meth:`Page.get_text` with the \"dict\" parameter. This works for all" " document types. It will extract all text and images shown on the page, " "formatted as a Python dictionary. Every image will occur in an image " "block, containing meta information and **the binary image data**. For " "details of the dictionary's structure, see :ref:`TextPage`. The method " "works equally well for PDF files. This creates a list of all images shown" " on a page::" msgstr "" "\"dict\" 매개변수와 함께 :meth:`Page.get_text` 를 사용하세요. 이것은 모든 문서 유형에 작동합니다. 페이지에 표시된 " "모든 텍스트와 이미지를 Python 딕셔너리 형식으로 추출합니다. 각 이미지는 메타 정보와 **바이너리 이미지 데이터** 를 포함하는 이미지 " "블록에 나타납니다. 딕셔너리 구조의 세부 사항은 :ref:`TextPage` 를 참조하세요. 이 방법은 PDF 파일에도 동일하게 " "작동합니다. 이것은 페이지에 표시된 모든 이미지의 목록을 생성합니다::" #: ../../recipes-images.rst:182 44ce44e54f6a4d52b8fa3e4377314037 msgid "How to Extract Images: PDF Documents" msgstr "이미지 추출 방법: PDF 문서" #: ../../recipes-images.rst:184 121c432a4e1b4f0da9d62f1686089fe3 msgid "" "Like any other \"object\" in a PDF, images are identified by a cross " "reference number (:data:`xref`, an integer). If you know this number, you" " have two ways to access the image's data:" msgstr "" "PDF의 다른 \"객체\"와 마찬가지로, 이미지는 교차 참조 번호(:data:`xref`, 정수)로 식별됩니다. 이 번호를 알고 있으면 " "이미지 데이터에 액세스하는 두 가지 방법이 있습니다:" #: ../../recipes-images.rst:186 65a8bdab9a754e05bb94c1a31c2dc6c3 msgid "" "**Create** a :ref:`Pixmap` of the image with instruction *pix = " "pymupdf.Pixmap(doc, xref)*. This method is **very** fast (single digit " "micro-seconds). The pixmap's properties (width, height, ...) will reflect" " the ones of the image. In this case there is no way to tell which image " "format the embedded original has." msgstr "" "*pix = pymupdf.Pixmap(doc, xref)* 지시로 이미지의 :ref:`Pixmap` 을 **생성** 합니다. 이 방법은 " "**매우** 빠릅니다(한 자리 마이크로초). 픽스맵의 속성(너비, 높이 등)은 이미지의 속성을 반영합니다. 이 경우 임베드된 원본의 " "이미지 형식을 알 수 있는 방법이 없습니다." #: ../../recipes-images.rst:188 1270aa02e2f747a8a27ef8e3820b2c51 msgid "" "**Extract** the image with *img = doc.extract_image(xref)*. This is a " "dictionary containing the binary image data as *img[\"image\"]*. A number" " of meta data are also provided -- mostly the same as you would find in " "the pixmap of the image. The major difference is string *img[\"ext\"]*, " "which specifies the image format: apart from \"png\", strings like " "\"jpeg\", \"bmp\", \"tiff\", etc. can also occur. Use this string as the " "file extension if you want to store to disk. The execution speed of this " "method should be compared to the combined speed of the statements *pix = " "pymupdf.Pixmap(doc, xref);pix.tobytes()*. If the embedded image is in PNG" " format, the speed of :meth:`Document.extract_image` is about the same " "(and the binary image data are identical). Otherwise, this method is " "**thousands of times faster**, and the **image data is much smaller**." msgstr "" "*img = doc.extract_image(xref)* 로 이미지를 **추출** 합니다. 이것은 *img[\"image\"]* 로 바이너리 " "이미지 데이터를 포함하는 딕셔너리입니다. 많은 메타데이터도 제공됩니다 -- 대부분 이미지의 픽스맵에서 찾을 수 있는 것과 동일합니다. " "주요 차이점은 이미지 형식을 지정하는 문자열 *img[\"ext\"]* 입니다: \"png\" 외에도 \"jpeg\", " "\"bmp\", \"tiff\" 등의 문자열이 나타날 수 있습니다. 디스크에 저장하려면 이 문자열을 파일 확장자로 사용하세요. 이 " "방법의 실행 속도는 *pix = pymupdf.Pixmap(doc, xref);pix.tobytes()* 문의 결합 속도와 비교해야 합니다. " "임베드된 이미지가 PNG 형식인 경우, :meth:`Document.extract_image` 의 속도는 거의 동일합니다(바이너리 이미지 " "데이터도 동일). 그렇지 않으면 이 방법이 **수천 배 더 빠르고**, **이미지 데이터가 훨씬 작습니다**." #: ../../recipes-images.rst:190 c7235a839397415b88cc200813afa335 msgid "" "The question remains: **\"How do I know those 'xref' numbers of " "images?\"**. There are two answers to this:" msgstr "질문은 남아 있습니다: **\"이미지의 'xref' 번호를 어떻게 알 수 있나요?\"**. 이에 대한 두 가지 답변이 있습니다:" #: ../../recipes-images.rst:192 24b9f0cac5e8493794473b40e99d6fff msgid "" "**\"Inspect the page objects:\"** Loop through the items of " ":meth:`Page.get_images`. It is a list of list, and its items look like " "*[xref, smask, ...]*, containing the :data:`xref` of an image. This " ":data:`xref` can then be used with one of the above methods. Use this " "method for **valid (undamaged)** documents. Be wary however, that the " "same image may be referenced multiple times (by different pages), so you " "might want to provide a mechanism avoiding multiple extracts." msgstr "" "**\"페이지 객체 검사:\"** :meth:`Page.get_images` 의 항목을 반복합니다. 이것은 리스트의 리스트이며, 항목은 " "*[xref, smask, ...]* 와 같이 보이며 이미지의 :data:`xref` 를 포함합니다. 그런 다음 이 :data:`xref` " "를 위의 방법 중 하나와 함께 사용할 수 있습니다. **유효한(손상되지 않은)** 문서에 이 방법을 사용하세요. 그러나 동일한 이미지가 " "여러 번 참조될 수 있으므로(다른 페이지에서) 여러 번 추출을 피하는 메커니즘을 제공하는 것이 좋습니다." #: ../../recipes-images.rst:193 90acb0b07ce44df5809cc83032fab4d6 msgid "" "**\"No need to know:\"** Loop through the list of **all xrefs** of the " "document and perform a :meth:`Document.extract_image` for each one. If " "the returned dictionary is empty, then continue -- this :data:`xref` is " "no image. Use this method if the PDF is **damaged (unusable pages)**. " "Note that a PDF often contains \"pseudo-images\" (\"stencil masks\") with" " the special purpose of defining the transparency of some other image. " "You may want to provide logic to exclude those from extraction. Also have" " a look at the next section." msgstr "" "**\"알 필요 없음:\"** 문서의 **모든 xref** 목록을 반복하고 각각에 대해 :meth:`Document.extract_image` " "를 수행합니다. 반환된 딕셔너리가 비어 있으면 계속합니다 -- 이 :data:`xref` 는 이미지가 아닙니다. PDF가 **손상된(사용 " "불가능한 페이지)** 경우 이 방법을 사용하세요. PDF에는 종종 다른 이미지의 투명도를 정의하는 특수 목적의 \"의사 이미지\"(\"스텐실 " "마스크\")가 포함되어 있습니다. 추출에서 이를 제외하는 로직을 제공하는 것이 좋습니다. 다음 섹션도 살펴보세요." #: ../../recipes-images.rst:195 12c15b841d0c40e5bf38fd3252a5c82f msgid "" "For both extraction approaches, there exist ready-to-use general purpose " "scripts:" msgstr "두 추출 방법 모두에 대해 즉시 사용 가능한 범용 스크립트가 있습니다:" #: ../../recipes-images.rst:197 ae5e3ffd1ec342fdbedcedbd9585539f msgid "" "`extract-from-pages.py `_ " "extracts images page by page:" msgstr "" "`extract-from-pages.py `_ 는 페이지별로 이미지를 추출합니다:" #: ../../recipes-images.rst:202 116fc9d92a524d5fbef97898d73400ef msgid "" "and `extract-from-xref.py `_ " "extracts images by xref table:" msgstr "" "그리고 `extract-from-xref.py `_ 는 xref 테이블로 이미지를 추출합니다:" #: ../../recipes-images.rst:213 27941620eff34254b2f1df365e86c504 msgid "How to Handle Image Masks" msgstr "이미지 마스크 처리 방법" #: ../../recipes-images.rst:214 06e8942247e04ca18cbb0a2e166e63e0 msgid "" "Some images in PDFs are accompanied by **image masks**. In their simplest" " form, masks represent alpha (transparency) bytes stored as separate " "images. In order to reconstruct the original of an image, which has a " "mask, it must be \"enriched\" with transparency bytes taken from its " "mask." msgstr "" "PDF의 일부 이미지에는 **이미지 마스크** 가 함께 제공됩니다. 가장 간단한 형태에서 마스크는 별도의 이미지로 저장된 알파(투명도) " "바이트를 나타냅니다. 마스크가 있는 이미지의 원본을 재구성하려면 마스크에서 가져온 투명도 바이트로 \"보강\"해야 합니다." #: ../../recipes-images.rst:216 6956e284f58a455894dad036a8d732f4 msgid "" "Whether an image does have such a mask can be recognized in one of two " "ways in PyMuPDF:" msgstr "이미지에 그러한 마스크가 있는지는 PyMuPDF에서 두 가지 방법 중 하나로 인식할 수 있습니다:" #: ../../recipes-images.rst:218 8f7b0eb999094613b1ec4e9642a0c45a msgid "" "An item of :meth:`Document.get_page_images` has the general format " "`(xref, smask, ...)`, where :data:`xref` is the image's :data:`xref` and " "*smask*, if positive, then it is the :data:`xref` of a mask." msgstr "" ":meth:`Document.get_page_images` 의 항목은 일반 형식 `(xref, smask, ...)` 을 가지며, 여기서 " ":data:`xref` 는 이미지의 :data:`xref` 이고 *smask* 가 양수이면 마스크의 :data:`xref` 입니다." #: ../../recipes-images.rst:219 76639fa3068e459eb26f660440a3b239 msgid "" "The (dictionary) results of :meth:`Document.extract_image` have a key " "*\"smask\"*, which also contains any mask's :data:`xref` if positive." msgstr "" ":meth:`Document.extract_image` 의 (딕셔너리) 결과에는 *\"smask\"* 키가 있으며, 양수이면 마스크의 " ":data:`xref` 도 포함합니다." #: ../../recipes-images.rst:221 46e1113696e24d6ba6ff91a314912958 msgid "" "If *smask == 0* then the image encountered via :data:`xref` can be " "processed as it is." msgstr "*smask == 0* 이면 :data:`xref` 를 통해 발견된 이미지는 그대로 처리할 수 있습니다." #: ../../recipes-images.rst:223 65ebef4703d447a9b3116690abc567cd msgid "" "To recover the original image using PyMuPDF, the procedure depicted as " "follows must be executed:" msgstr "PyMuPDF를 사용하여 원본 이미지를 복구하려면 다음에 설명된 절차를 실행해야 합니다:" #: ../../recipes-images.rst:232 6a6811e1d3974ca493ec08e4a67eca0f msgid "" "Step (1) creates a pixmap of the basic image. Step (2) does the same with" " the image mask. Step (3) adds an alpha channel and fills it with " "transparency information." msgstr "" "단계 (1)은 기본 이미지의 픽스맵을 생성합니다. 단계 (2)는 이미지 마스크에 대해 동일한 작업을 수행합니다. 단계 (3)는 알파 " "채널을 추가하고 투명도 정보로 채웁니다." #: ../../recipes-images.rst:234 0f019370007b48829a5c384c1d511b38 msgid "" "The scripts `extract-from-pages.py `_, " "and `extract-from-xref.py `_ " "above also contain this logic." msgstr "" "위의 `extract-from-pages.py `_ 및 `extract-from-xref.py " "`_ 스크립트에도 이 로직이 포함되어 있습니다." #: ../../recipes-images.rst:250 e6cc7c95f595417399c8af124895022f msgid "How to Make one PDF of all your Pictures (or Files)" msgstr "모든 사진(또는 파일)을 하나의 PDF로 만드는 방법" #: ../../recipes-images.rst:251 0e5cc72aa12e4c159cee3caf5b124a72 msgid "" "We show here **three scripts** that take a list of (image and other) " "files and put them all in one PDF." msgstr "여기서는 (이미지 및 기타) 파일 목록을 받아 모두 하나의 PDF에 넣는 **세 가지 스크립트** 를 보여줍니다." #: ../../recipes-images.rst:253 23141b711e854c0fb09b4da836e870c4 msgid "**Method 1: Inserting Images as Pages**" msgstr "**방법 1: 이미지를 페이지로 삽입**" #: ../../recipes-images.rst:255 6b5ea11f2ac6474da5bc139a540e80fc msgid "" "The first one converts each image to a PDF page with the same dimensions." " The result will be a PDF with one page per image. It will only work for " ":ref:`supported image` file formats::" msgstr "" "첫 번째는 각 이미지를 동일한 크기의 PDF 페이지로 변환합니다. 결과는 이미지당 한 페이지의 PDF가 됩니다. " ":ref:`지원되는 이미지` 파일 형식에서만 작동합니다::" #: ../../recipes-images.rst:278 5d5f4b70e6ad473b98f0b67b8dd864ee msgid "" "This will generate a PDF only marginally larger than the combined " "pictures' size. Some numbers on performance:" msgstr "이것은 결합된 그림 크기보다 약간만 큰 PDF를 생성합니다. 성능에 대한 일부 수치:" #: ../../recipes-images.rst:280 c29ed63a41334d08bd31d57a51745ab1 msgid "" "The above script needed about 1 minute on my machine for 149 pictures " "with a total size of 514 MB (and about the same resulting PDF size)." msgstr "위 스크립트는 총 크기가 514 MB인 149개의 그림에 대해 내 컴퓨터에서 약 1분이 걸렸습니다(결과 PDF 크기도 거의 동일)." #: ../../recipes-images.rst:285 90edd65fe7324ee6a8c2c256f5dad5b3 msgid "" "Look `here `_ for a more " "complete source code: it offers a directory selection dialog and skips " "unsupported files and non-file entries." msgstr "" "더 완전한 소스 코드는 `여기 `_ 를 참조하세요: 디렉토리 선택 대화 상자를 제공하고 지원되지 않는 파일과 비파일 항목을 건너뜁니다." #: ../../recipes-images.rst:287 66dd4d051e7b4d12816c624eee514c5e msgid "" "We might have used :meth:`Page.insert_image` instead of " ":meth:`Page.show_pdf_page`, and the result would have been a similar " "looking file. However, depending on the image type, it may store **images" " uncompressed**. Therefore, the save option *deflate = True* must be used" " to achieve a reasonable file size, which hugely increases the runtime " "for large numbers of images. So this alternative **cannot be " "recommended** here." msgstr "" ":meth:`Page.show_pdf_page` 대신 :meth:`Page.insert_image` 를 사용했을 수도 있으며, 결과는 비슷해 보이는 " "파일이었을 것입니다. 그러나 이미지 유형에 따라 **이미지를 압축하지 않고** 저장할 수 있습니다. 따라서 합리적인 파일 크기를 " "달성하려면 저장 옵션 *deflate = True* 를 사용해야 하며, 이는 많은 수의 이미지에 대해 실행 시간을 크게 증가시킵니다. " "따라서 이 대안은 여기서 **권장할 수 없습니다**." #: ../../recipes-images.rst:289 31ee78dae4e846c59e2bd4c8213760da msgid "**Method 2: Embedding Files**" msgstr "**방법 2: 파일 임베드**" #: ../../recipes-images.rst:291 d485e0eb28084b90a6b28a8ee7cef448 msgid "" "The second script **embeds** arbitrary files -- not only images. The " "resulting PDF will have just one (empty) page, required for technical " "reasons. To later access the embedded files again, you would need a " "suitable PDF viewer that can display and / or extract embedded files::" msgstr "" "두 번째 스크립트는 이미지뿐만 아니라 임의의 파일을 **임베드** 합니다. 결과 PDF는 기술적 이유로 하나의(빈) 페이지만 있습니다. " "나중에 임베드된 파일에 다시 액세스하려면 임베드된 파일을 표시하고/또는 추출할 수 있는 적절한 PDF 뷰어가 필요합니다::" #: ../../recipes-images.rst:316 c94ada8bd9e04598aaf5ab16502b491d msgid "" "This is by far the fastest method, and it also produces the smallest " "possible output file size. The above pictures needed 20 seconds on my " "machine and yielded a PDF size of 510 MB. Look `here " "`_ for a more complete source code: it offers a directory" " selection dialog and skips non-file entries." msgstr "" "이것은 지금까지 가장 빠른 방법이며 가능한 가장 작은 출력 파일 크기도 생성합니다. 위의 그림은 내 컴퓨터에서 20초가 걸렸고 " "510 MB 크기의 PDF를 생성했습니다. 더 완전한 소스 코드는 `여기 " "`_ " "를 참조하세요: 디렉토리 선택 대화 상자를 제공하고 비파일 항목을 건너뜁니다." #: ../../recipes-images.rst:318 9d6d6606772743a0b3d7948c5256f795 msgid "**Method 3: Attaching Files**" msgstr "**방법 3: 파일 첨부**" #: ../../recipes-images.rst:320 bcaa4036cb074aa2975925493b912887 msgid "" "A third way to achieve this task is **attaching files** via page " "annotations see `here `_ for the " "complete source code." msgstr "" "이 작업을 달성하는 세 번째 방법은 페이지 주석을 통해 파일을 **첨부** 하는 것입니다. 전체 소스 코드는 `여기 " "`_ " "를 참조하세요." #: ../../recipes-images.rst:322 436939e68a27496f95bf3ba627243f13 msgid "" "This has a similar performance as the previous script and it also " "produces a similar file size. It will produce PDF pages which show a " "'FileAttachment' icon for each attached file." msgstr "" "이것은 이전 스크립트와 유사한 성능을 가지며 유사한 파일 크기도 생성합니다. 각 첨부 파일에 대해 'FileAttachment' 아이콘을 " "표시하는 PDF 페이지를 생성합니다." #: ../../recipes-images.rst:326 9ea52a5b17d243b5867452d1793d07b7 msgid "" "Both, the **embed** and the **attach** methods can be used for " "**arbitrary files** -- not just images." msgstr "**임베드** 와 **첨부** 방법 모두 이미지뿐만 아니라 **임의의 파일** 에 사용할 수 있습니다." #: ../../recipes-images.rst:328 034f2966cc014086a05a35dc70520940 msgid "" "We strongly recommend using the awesome package `PySimpleGUI " "`_ to display a progress meter for" " tasks that may run for an extended time span. It's pure Python, uses " "Tkinter (no additional GUI package) and requires just one more line of " "code!" msgstr "" "장시간 실행될 수 있는 작업에 대해 진행 표시기를 표시하려면 `PySimpleGUI " "`_ 패키지 사용을 강력히 권장합니다. 순수 Python이며 " "Tkinter를 사용합니다(추가 GUI 패키지 없음) 그리고 코드 한 줄만 더 필요합니다!" #: ../../recipes-images.rst:342 f8cabd46ec6d45f09659866a69d91b45 msgid "How to Create Vector Images" msgstr "벡터 이미지 생성 방법" #: ../../recipes-images.rst:343 f469c239c3464680bb9794d9b17a101b msgid "" "The usual way to create an image from a document page is " ":meth:`Page.get_pixmap`. A pixmap represents a raster image, so you must " "decide on its quality (i.e. resolution) at creation time. It cannot be " "changed later." msgstr "" "문서 페이지에서 이미지를 만드는 일반적인 방법은 :meth:`Page.get_pixmap` 입니다. 픽스맵은 래스터 이미지를 나타내므로 " "생성 시 품질(즉, 해상도)을 결정해야 합니다. 나중에 변경할 수 없습니다." #: ../../recipes-images.rst:345 39ff1890e34045f0bdaebaf77376c7a6 msgid "" "PyMuPDF also offers a way to create a **vector image** of a page in SVG " "format (scalable vector graphics, defined in XML syntax). SVG images " "remain precise across zooming levels (of course with the exception of any" " raster graphic elements embedded therein)." msgstr "" "PyMuPDF는 또한 SVG 형식(확장 가능한 벡터 그래픽, XML 구문으로 정의됨)으로 페이지의 **벡터 이미지** 를 만드는 방법을 " "제공합니다. SVG 이미지는 확대/축소 수준에서 정확성을 유지합니다(물론 그 안에 임베드된 래스터 그래픽 요소는 제외)." #: ../../recipes-images.rst:347 9f178ef03b574e8297104f71a80c68ea msgid "" "Instruction *svg = page.get_svg_image(matrix=pymupdf.Identity)* delivers " "a UTF-8 string *svg* which can be stored with extension \".svg\"." msgstr "" "지시 *svg = page.get_svg_image(matrix=pymupdf.Identity)* 는 확장자 \".svg\" 로 저장할 수 있는 " "UTF-8 문자열 *svg* 를 제공합니다." #: ../../recipes-images.rst:363 b15d36501a88442697fbeeba5b5bb55f msgid "How to Convert Images" msgstr "이미지 변환 방법" #: ../../recipes-images.rst:364 9c9044f3d0894de0812ab73694a00aca msgid "" "Just as a feature among others, PyMuPDF's image conversion is easy. It " "may avoid using other graphics packages like PIL/Pillow in many cases." msgstr "" "다른 기능과 마찬가지로 PyMuPDF의 이미지 변환은 쉽습니다. 많은 경우 PIL/Pillow와 같은 다른 그래픽 패키지를 사용하지 " "않아도 될 수 있습니다." #: ../../recipes-images.rst:366 f0648a404f50475e9fbc97705bcf53d2 msgid "Notwithstanding that interfacing with Pillow is almost trivial." msgstr "그럼에도 불구하고 Pillow와의 인터페이싱은 거의 사소합니다." #: ../../recipes-images.rst:369 51147cdb2eb848a59946a784bc3f94a1 msgid "**Input Formats**" msgstr "**입력 형식**" #: ../../recipes-images.rst:369 6e77d3be370148e2a5bce129911da566 msgid "**Output Formats**" msgstr "**출력 형식**" #: ../../recipes-images.rst:369 cf281244182e4d06a258fbbb823081c2 msgid "**Description**" msgstr "**설명**" #: ../../recipes-images.rst:371 530dd206bde5448eb1361b263e3af56b msgid "BMP" msgstr "BMP" #: ../../recipes-images.rst:371 ../../recipes-images.rst:373 #: ../../recipes-images.rst:374 ../../recipes-images.rst:375 #: ../../recipes-images.rst:376 ../../recipes-images.rst:383 #: ../../recipes-images.rst:384 0a22e6da6c0e4628bcba466b598c7755 #: 132ea5283e9446b6bef2088214506462 309ee5eed19245778c6c15a0523ba0ec #: 5ee5770cfadd46c0bc090de19200296e 7002bf7646f84d808f1d5f5e672b0559 #: a37b99d8b7f547ee9f63392896f7e2d7 c69685da95a6452a83e40f26243b207b msgid "." msgstr "" #: ../../recipes-images.rst:371 e8fc53116fb14428812ab304c72fcdaf msgid "Windows Bitmap" msgstr "Windows Bitmap" #: ../../recipes-images.rst:372 03735a46d7ff47c291751487299a3f1e #: 17c492d6f34d4470b1aa86f58b11ca2e msgid "JPEG" msgstr "JPEG" #: ../../recipes-images.rst:372 7d1770830b8a487f8c91ea91bd6474eb msgid "Joint Photographic Experts Group" msgstr "Joint Photographic Experts Group" #: ../../recipes-images.rst:373 23fe9f08f0c74644b077b0cf444d3358 msgid "JXR" msgstr "JXR" #: ../../recipes-images.rst:373 f548e4952b8b416689c5ce6bc9f95f33 msgid "JPEG Extended Range" msgstr "JPEG Extended Range" #: ../../recipes-images.rst:374 684a27b7d2874c2b87911e269b40f2d0 msgid "JPX/JP2" msgstr "JPX/JP2" #: ../../recipes-images.rst:374 14493ac2be944a018bff6dbd8ae2bac5 msgid "JPEG 2000" msgstr "JPEG 2000" #: ../../recipes-images.rst:375 7e15ddbcb0ae4375b206202c12d586c7 msgid "GIF" msgstr "GIF" #: ../../recipes-images.rst:375 9978971d8ce4454d86b805ab8d47cfa9 msgid "Graphics Interchange Format" msgstr "Graphics Interchange Format" #: ../../recipes-images.rst:376 13363ae60931495a837cbc8baf5970fc msgid "TIFF" msgstr "TIFF" #: ../../recipes-images.rst:376 10d71cf9bb9e453cb0dcdea2659abd95 msgid "Tagged Image File Format" msgstr "Tagged Image File Format" #: ../../recipes-images.rst:377 05f4cb19c0a34596814f731af32ea876 #: 7931ab4e2d304558895b4c7ce5c29979 msgid "PNG" msgstr "PNG" #: ../../recipes-images.rst:377 62b451811d4e476c8ae5dd6d849a54a4 msgid "Portable Network Graphics" msgstr "Portable Network Graphics" #: ../../recipes-images.rst:378 c1d7da490b554e84a7204e6c99fe37ef #: f730284031c54916ac361e6304056bcb msgid "PNM" msgstr "PNM" #: ../../recipes-images.rst:378 561bb44f8a6f4ec6a424777a37eef460 msgid "Portable Anymap" msgstr "Portable Anymap" #: ../../recipes-images.rst:379 3eb2b8341ba14a0ca14b367fb547e28d #: 57b7760ff7804df8b3a3d1bad69d6b15 msgid "PGM" msgstr "PGM" #: ../../recipes-images.rst:379 21eeb4db595f461792110aec2d8ecea9 msgid "Portable Graymap" msgstr "Portable Graymap" #: ../../recipes-images.rst:380 13aa92582d5d4474abf412bdfe3d0c28 #: 4c893f1c9fcb4388a360d103c115f4ee msgid "PBM" msgstr "PBM" #: ../../recipes-images.rst:380 30f2520397de4b9eb325877a3a507bbf msgid "Portable Bitmap" msgstr "Portable Bitmap" #: ../../recipes-images.rst:381 14f81272a872402b9c2a813dcdf1adbd #: 958c5a3c6c9f445f8782e01f89dc6eb2 msgid "PPM" msgstr "PPM" #: ../../recipes-images.rst:381 b047b29cb5924074b6edcc64ac2f21d4 msgid "Portable Pixmap" msgstr "Portable Pixmap" #: ../../recipes-images.rst:382 8b7545df28fe4e84a4f6e5b4eaa96994 #: b4a70161776d47b9ae8a64cdf4733492 msgid "PAM" msgstr "PAM" #: ../../recipes-images.rst:382 99b6482f875c4216be23cd14e3b55579 msgid "Portable Arbitrary Map" msgstr "Portable Arbitrary Map" #: ../../recipes-images.rst:383 a5f2249d2d1d484f87fad69069bc2941 msgid "PSD" msgstr "PSD" #: ../../recipes-images.rst:383 5aa71e0042e440b8a2ae7d1232ae1da7 msgid "Adobe Photoshop Document" msgstr "Adobe Photoshop Document" #: ../../recipes-images.rst:384 9f13c58a08324e2a9a956e0c7481fdb6 msgid "PS" msgstr "PS" #: ../../recipes-images.rst:384 f7d3f16fd29d4f2e873705fa491cdaab msgid "Adobe Postscript" msgstr "Adobe Postscript" #: ../../recipes-images.rst:387 47aac2499f2743ea83430c735ea35f6d msgid "The general scheme is just the following two lines::" msgstr "일반적인 방식은 다음 두 줄입니다::" #: ../../recipes-images.rst:392 b7f3421a215d4d909a51a70302130d37 msgid "**Remarks**" msgstr "**비고**" #: ../../recipes-images.rst:394 7a47fbda67ec43d7914f6405319663fa msgid "" "The **input** argument of *pymupdf.Pixmap(arg)* can be a file or a bytes " "/ io.BytesIO object containing an image." msgstr "*pymupdf.Pixmap(arg)* 의 **입력** 인수는 이미지를 포함하는 파일 또는 bytes / io.BytesIO 객체일 수 있습니다." #: ../../recipes-images.rst:395 58b740eb05e34db9a556c68fe43e7b90 msgid "" "Instead of an output **file**, you can also create a bytes object via " "*pix.tobytes(\"yyy\")* and pass this around." msgstr "출력 **파일** 대신 *pix.tobytes(\"yyy\")* 를 통해 bytes 객체를 생성하고 이를 전달할 수도 있습니다." #: ../../recipes-images.rst:396 c3b285b2e78146219bd78577d12d121a msgid "" "As a matter of course, input and output formats must be compatible in " "terms of colorspace and transparency. The ``Pixmap`` class has batteries " "included if adjustments are needed." msgstr "" "당연히 입력 및 출력 형식은 색 공간 및 투명도 측면에서 호환되어야 합니다. ``Pixmap`` 클래스는 조정이 필요한 경우 내장 기능을 " "포함하고 있습니다." #: ../../recipes-images.rst:399 e67f10d9438447479868be73be60c969 msgid "**Convert JPEG to Photoshop**::" msgstr "**JPEG를 Photoshop으로 변환**::" #: ../../recipes-images.rst:405 69af5be5c5e042739b6b881440591067 msgid "" "Convert **JPEG to Tkinter PhotoImage**. Any **RGB / no-alpha** image " "works exactly the same. Conversion to one of the **Portable Anymap** " "formats (PPM, PGM, etc.) does the trick, because they are supported by " "all Tkinter versions::" msgstr "" "**JPEG를 Tkinter PhotoImage로 변환** 합니다. 모든 **RGB / 알파 없음** 이미지도 정확히 동일하게 작동합니다. " "**Portable Anymap** 형식(PPM, PGM 등) 중 하나로 변환하면 효과가 있습니다. 모든 Tkinter 버전에서 지원되기 " "때문입니다::" #: ../../recipes-images.rst:412 95cfd29f810e445da70d90c145d8615a msgid "" "Convert **PNG with alpha** to Tkinter PhotoImage. This requires " "**removing the alpha bytes**, before we can do the PPM conversion::" msgstr "" "**알파가 있는 PNG** 를 Tkinter PhotoImage로 변환합니다. PPM 변환을 수행하기 전에 **알파 바이트를 제거** 해야 " "합니다::" #: ../../recipes-images.rst:429 1911e5e8b8924c1a8b4f22e5163ab54f msgid "How to Use Pixmaps: Gluing Images" msgstr "픽스맵 사용 방법: 이미지 붙이기" #: ../../recipes-images.rst:431 7bec2fa27c4e409498516974d3af1a08 msgid "" "This shows how pixmaps can be used for purely graphical, non-document " "purposes. The script reads an image file and creates a new image which " "consist of 3 * 4 tiles of the original::" msgstr "" "이것은 픽스맵이 순수하게 그래픽적이고 문서가 아닌 목적으로 사용될 수 있는 방법을 보여줍니다. 스크립트는 이미지 파일을 읽고 원본의 " "3 * 4 타일로 구성된 새 이미지를 생성합니다::" #: ../../recipes-images.rst:451 5e629a692db5492494234aeaa2c9e000 msgid "This is the input picture:" msgstr "이것이 입력 그림입니다:" #: ../../recipes-images.rst:456 0eb66869c4e049f18880e64efa606cb7 msgid "Here is the output:" msgstr "출력은 다음과 같습니다:" #: ../../recipes-images.rst:473 193131d4ef064104aca816c9fb1b8eda msgid "How to Use Pixmaps: Making a Fractal" msgstr "픽스맵 사용 방법: 프랙탈 만들기" #: ../../recipes-images.rst:475 94c73f5e5e844ef29a6937bacf69e134 msgid "" "Here is another Pixmap example that creates **Sierpinski's Carpet** -- a " "fractal generalizing the **Cantor Set** to two dimensions. Given a square" " carpet, mark its 9 sub-suqares (3 times 3) and cut out the one in the " "center. Treat each of the remaining eight sub-squares in the same way, " "and continue *ad infinitum*. The end result is a set with area zero and " "fractal dimension 1.8928..." msgstr "" "다음은 **시에르핀스키 카펫** 을 생성하는 또 다른 픽스맵 예제입니다 -- **칸토어 집합** 을 2차원으로 일반화한 프랙탈입니다. 정사각형 " "카펫이 주어지면 9개의 하위 사각형(3 x 3)을 표시하고 중앙의 것을 잘라냅니다. 나머지 8개의 하위 사각형 각각에 대해 동일한 " "방식으로 처리하고 *무한히* 계속합니다. 최종 결과는 면적이 0이고 프랙탈 차원이 1.8928...인 집합입니다." #: ../../recipes-images.rst:477 56abcac9cb974ce6ae22fd649ca0859f msgid "" "This script creates an approximate image of it as a PNG, by going down to" " one-pixel granularity. To increase the image precision, change the value" " of n (precision)::" msgstr "" "이 스크립트는 1픽셀 단위까지 내려가서 PNG로 근사 이미지를 생성합니다. 이미지 정밀도를 높이려면 n(정밀도) 값을 변경하세요::" #: ../../recipes-images.rst:531 c2a2453f8f7b4dbdb1a88b9ab6e6be44 msgid "The result should look something like this:" msgstr "결과는 다음과 같아야 합니다:" #: ../../recipes-images.rst:541 7b65b42e069e44c4acda5058a222b54c msgid "How to Interface with NumPy" msgstr "NumPy와 인터페이스하는 방법" #: ../../recipes-images.rst:543 4737dca0e38f4d0391a1712b9196eeb8 msgid "" "This shows how to create a PNG file from a numpy array (several times " "faster than most other methods)::" msgstr "이것은 numpy 배열에서 PNG 파일을 만드는 방법을 보여줍니다(대부분의 다른 방법보다 몇 배 빠름)::" #: ../../recipes-images.rst:570 86677e790d2c4f67807e8699c758c3b8 msgid "How to Add Images to a PDF Page" msgstr "PDF 페이지에 이미지 추가 방법" #: ../../recipes-images.rst:572 8b806d59869144378fcd5066d1490f5c msgid "" "There are two methods to add images to a PDF page: " ":meth:`Page.insert_image` and :meth:`Page.show_pdf_page`. Both methods " "have things in common, but there are also differences." msgstr "" "PDF 페이지에 이미지를 추가하는 두 가지 방법이 있습니다: :meth:`Page.insert_image` 와 " ":meth:`Page.show_pdf_page`. 두 방법 모두 공통점이 있지만 차이점도 있습니다." #: ../../recipes-images.rst:575 2c8c48d1aa0b4d95ba46f51b58d654d6 msgid "**Criterion**" msgstr "**기준**" #: ../../recipes-images.rst:575 7d8993132b2b4a42a0cf8d794f2992d0 msgid ":meth:`Page.insert_image`" msgstr ":meth:`Page.insert_image`" #: ../../recipes-images.rst:575 8a3e9ca045d64f2e8d891f008fec70a3 msgid ":meth:`Page.show_pdf_page`" msgstr ":meth:`Page.show_pdf_page`" #: ../../recipes-images.rst:577 5bd36cce5edc4839bb92e31c9c76b006 msgid "displayable content" msgstr "표시 가능한 콘텐츠" #: ../../recipes-images.rst:577 6abadbc464324e72b3412212af08ddd5 msgid "image file, image in memory, pixmap" msgstr "이미지 파일, 메모리의 이미지, 픽스맵" #: ../../recipes-images.rst:577 fe5a852c20eb446f96ab83f04f7f4a93 msgid "PDF page" msgstr "PDF 페이지" #: ../../recipes-images.rst:578 204fbfd1f4dd47b9b874c7093d251715 msgid "display resolution" msgstr "표시 해상도" #: ../../recipes-images.rst:578 6877443fc21f4ae29b20fa83d0845e7f msgid "image resolution" msgstr "이미지 해상도" #: ../../recipes-images.rst:578 3259783ac12241b39f8d13f3ae0773d6 msgid "vectorized (except raster page content)" msgstr "벡터화됨(래스터 페이지 콘텐츠 제외)" #: ../../recipes-images.rst:579 0a170d4e27b74f7ba12e8e015f247437 msgid "rotation" msgstr "회전" #: ../../recipes-images.rst:579 809287424df744108ab05380b655171e msgid "0, 90, 180 or 270 degrees" msgstr "0, 90, 180 또는 270도" #: ../../recipes-images.rst:579 da8c599cd42840bbac1e77a82693730a msgid "any angle" msgstr "임의의 각도" #: ../../recipes-images.rst:580 f40e820c9fb14438ae80fc9bde7f8a98 msgid "clipping" msgstr "클리핑" #: ../../recipes-images.rst:580 4573b228aad144ed96c21fc96b46d235 msgid "no (full image only)" msgstr "아니오(전체 이미지만)" #: ../../recipes-images.rst:580 ../../recipes-images.rst:585 #: 451bef807fb34d769267984ed465f6dc cca26d0a49b6435a81557dc0961b5744 msgid "yes" msgstr "예" #: ../../recipes-images.rst:581 cfbb20540a0b4c778339a005d689e7b8 msgid "keep aspect ratio" msgstr "종횡비 유지" #: ../../recipes-images.rst:581 9088023618154cb2b1a12c0ddf19f1a2 #: f0b3417bf2a7468f8f23939745c86e02 msgid "yes (default option)" msgstr "예(기본 옵션)" #: ../../recipes-images.rst:582 5f19b1705d7c458d9132e003453cbec7 msgid "transparency (water marking)" msgstr "투명도(워터마킹)" #: ../../recipes-images.rst:582 99fc40d08cd448d4a3d5157524c2fed1 msgid "depends on the image" msgstr "이미지에 따라 다름" #: ../../recipes-images.rst:582 4953bd2dbe474a6a95444caaec0f8e00 msgid "depends on the page" msgstr "페이지에 따라 다름" #: ../../recipes-images.rst:583 800220a1afe84937ab054dd04a19a8c8 msgid "location / placement" msgstr "위치 / 배치" #: ../../recipes-images.rst:583 3d7142d3e8b844178ad964a906047c57 #: 6f79b41a8b7f44d0b808c73f0bca9bbf msgid "scaled to fit target rectangle" msgstr "대상 사각형에 맞게 크기 조정" #: ../../recipes-images.rst:584 bcd9bfd74c0e4791b173eea29559bf7c msgid "performance" msgstr "성능" #: ../../recipes-images.rst:584 709fb304b9de44d69140fb3994966d0b #: aa53a4c8c09a4cfba0e8f1a66a28bb65 msgid "automatic prevention of duplicates;" msgstr "중복 자동 방지;" #: ../../recipes-images.rst:585 0937b39761af40238a7534454037df7f msgid "multi-page image support" msgstr "다중 페이지 이미지 지원" #: ../../recipes-images.rst:585 14f432eb978947a8aeab98f966d2d10f msgid "no" msgstr "아니오" #: ../../recipes-images.rst:586 925c5122b94f48c5b30dceafcb918523 msgid "ease of use" msgstr "사용 편의성" #: ../../recipes-images.rst:586 570bc160fd964dfd90f9efc5d183be86 msgid "simple, intuitive;" msgstr "간단하고 직관적;" #: ../../recipes-images.rst:586 7cf88dffae244d2ab3bda778f8a61657 msgid "" "simple, intuitive; **usable for all document types** (including images!) " "after conversion to PDF via :meth:`Document.convert_to_pdf`" msgstr "" "간단하고 직관적; :meth:`Document.convert_to_pdf` 를 통해 PDF로 변환 후 **모든 문서 유형** (이미지 포함!)에 " "사용 가능" #: ../../recipes-images.rst:592 6ad1ea7eaa8f47249a3a73f2bd375d6e msgid "" "Basic code pattern for :meth:`Page.insert_image`. **Exactly one** of the " "parameters **filename / stream / pixmap** must be given, if not re-" "inserting an existing image::" msgstr "" ":meth:`Page.insert_image` 의 기본 코드 패턴. 기존 이미지를 다시 삽입하지 않는 경우 **filename / stream / " "pixmap** 매개변수 중 **정확히 하나** 를 제공해야 합니다::" #: ../../recipes-images.rst:607 324876f64fbe4c44ab53d2a63fa13939 msgid "" "Basic code pattern for :meth:`Page.show_pdf_page`. Source and target PDF " "must be different :ref:`Document` objects (but may be opened from the " "same file)::" msgstr "" ":meth:`Page.show_pdf_page` 의 기본 코드 패턴. 소스 및 대상 PDF는 서로 다른 :ref:`Document` 객체여야 " "합니다(같은 파일에서 열 수 있음)::" #: ../../recipes-images.rst:623 3fb681b8dd954d6191b33bb9379c5769 msgid "How to Use Pixmaps: Checking Text Visibility" msgstr "픽스맵 사용 방법: 텍스트 가시성 확인" #: ../../recipes-images.rst:625 f6738eb5b3944be59ab375f9b7eb965f msgid "" "Whether or not a given piece of text is actually visible on a page " "depends on a number of factors:" msgstr "주어진 텍스트가 페이지에서 실제로 보이는지는 여러 요인에 따라 다릅니다:" #: ../../recipes-images.rst:627 1e747fae38a041ceab9962bed078d738 msgid "" "Text is not covered by another object but may have the same color as the " "background i.e., white-on-white etc." msgstr "텍스트가 다른 객체에 의해 덮이지 않았지만 배경과 같은 색상일 수 있습니다. 예: 흰색 위의 흰색 등." #: ../../recipes-images.rst:628 f335376e08db4247a18b81df59e129c8 msgid "" "Text may be covered by an image or vector graphics. Detecting this is an " "important capability, for example to uncover badly anonymized legal " "documents." msgstr "" "텍스트가 이미지나 벡터 그래픽에 의해 덮일 수 있습니다. 이를 감지하는 것은 중요한 기능입니다. 예를 들어 잘못 익명화된 법률 문서를 " "발견하는 데 사용됩니다." #: ../../recipes-images.rst:629 c13633a208484210b9ae568ec9ba0f68 msgid "" "Text is created hidden. This technique is usually used by OCR tools to " "store the recognized text in an invisible layer on the page." msgstr "" "텍스트가 숨겨진 상태로 생성됩니다. 이 기술은 일반적으로 OCR 도구가 인식된 텍스트를 페이지의 보이지 않는 레이어에 저장하는 데 " "사용됩니다." #: ../../recipes-images.rst:631 15e4b37ca4e743d9ace6bbddf7721b12 msgid "" "The following shows how to detect situation 1. above, or situation 2. if " "the covering object is unicolor::" msgstr "" "다음은 위의 상황 1을 감지하는 방법 또는 덮는 객체가 단색인 경우 상황 2를 감지하는 방법을 보여줍니다::" #: ../../recipes-images.rst:645 83c1b504293642219a2e1c7034fa13ef msgid "" "Method :meth:`Pixmap.color_topusage` returns a tuple `(ratio, pixel)` " "where 0 < ratio <= 1 and *pixel* is the pixel value of the color. Please " "note that we create a **pixmap only once**. This can save a lot of " "processing time if there are multiple hit rectangles." msgstr "" ":meth:`Pixmap.color_topusage` 메서드는 `(ratio, pixel)` 튜플을 반환합니다. 여기서 0 < ratio <= " "1이고 *pixel* 은 색상의 픽셀 값입니다. **픽스맵을 한 번만 생성** 합니다. 여러 히트 사각형이 있는 경우 처리 시간을 많이 " "절약할 수 있습니다." #: ../../recipes-images.rst:647 a5240ef02f1b474ca0cc0911c89fca25 msgid "" "The logic of the above code is: If the needle's rectangle is (\"almost\":" " > 95%) unicolor, then the text cannot be visible. A typical result for " "visible text returns the color of the background (mostly white) and a " "ratio around 0.7 to 0.8, for example `(0.685, b'\\xff\\xff\\xff')`." msgstr "" "위 코드의 로직은 다음과 같습니다: 바늘이 가리키는 사각형이 (\"거의\": > 95%) 단색이면 텍스트가 보일 수 없습니다. " "보이는 텍스트의 일반적인 결과는 배경 색상(대부분 흰색)과 약 0.7~0.8의 비율을 반환합니다. 예: `(0.685, " "b'\\xff\\xff\\xff')`." #: ../../footer.rst:46 069c8258eace4a40a1b85ff062eeb067 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-journalling.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 25048fda51ce418c9d015f1246e746af msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 797ac5efa9e24c438fafe7f71ce832da msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 753e44f114514b2e927f9c1cf789d18c msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../recipes-journalling.rst:7 b01dda5af224433398494559bf0ada58 msgid "Journalling" msgstr "저널링" #: ../../recipes-journalling.rst:10 f1543a90864a42ea86fe641d52d33bea msgid "" "Starting with version 1.19.0, journalling is possible when updating PDF " "documents." msgstr "버전 1.19.0부터 PDF 문서를 업데이트할 때 저널링이 가능합니다." #: ../../recipes-journalling.rst:12 1456c9ef805443c79a0bd76d2471b773 msgid "" "Journalling is a logging mechanism which permits either **reverting** or " "**re-applying** changes to a PDF. Similar to LUWs \"Logical Units of " "Work\" in modern database systems, one can group a set of updates into an" " \"operation\". In MuPDF journalling, an operation plays the role of a " "LUW." msgstr "저널링은 PDF에 대한 변경 사항을 **되돌리거나** **다시 적용** 할 수 있게 하는 로깅 메커니즘입니다. 현대 데이터베이스 시스템의 LUW \"Logical Units of Work\"와 유사하게, 일련의 업데이트를 \"작업\"으로 그룹화할 수 있습니다. |MuPDF| 저널링에서 작업은 LUW의 역할을 합니다." #: ../../recipes-journalling.rst:14 aa605819004a494da8700c4dbb499ca3 msgid "" "In contrast to LUW implementations found in database systems, MuPDF " "journalling happens on a **per document level**. There is no support for " "simultaneous updates across multiple PDFs: one would have to establish " "one's own logic here." msgstr "데이터베이스 시스템의 LUW 구현과 달리, |MuPDF| 저널링은 **문서별 수준** 에서 발생합니다. 여러 PDF에 걸친 동시 업데이트는 지원되지 않습니다. 여기서는 자체 로직을 구축해야 합니다." #: ../../recipes-journalling.rst:16 cabd8aa10cf746e6b10fc9fd0a9d7182 msgid "" "Journalling must be *enabled* via a document method. Journalling is " "possible for existing or new documents. Journalling **can be disabled " "only** by closing the file." msgstr "저널링은 문서 메서드를 통해 *활성화* 해야 합니다. 기존 문서나 새 문서 모두에서 저널링이 가능합니다. 저널링은 파일을 닫는 경우에만 **비활성화** 할 수 있습니다." #: ../../recipes-journalling.rst:17 1090ca7dc7904871b61188430e85d1a1 msgid "" "Once enabled, every change must happen inside an *operation* -- otherwise" " an exception is raised. An operation is started and stopped via document" " methods. Updates happening between these two calls form an LUW and can " "thus collectively be rolled back or re-applied, or, in MuPDF terminology " "\"undone\" resp. \"redone\"." msgstr "활성화되면 모든 변경은 *작업* 내에서 발생해야 합니다. 그렇지 않으면 예외가 발생합니다. 작업은 문서 메서드를 통해 시작되고 중지됩니다. 이 두 호출 사이에 발생하는 업데이트는 LUW를 형성하므로 집합적으로 롤백하거나 다시 적용할 수 있으며, |MuPDF| 용어로는 각각 \"실행 취소\" 및 \"다시 실행\"입니다." #: ../../recipes-journalling.rst:18 c31321fa1fc14929871630087cdd8b8b msgid "" "At any point, the journalling status can be queried: whether journalling " "is active, how many operations have been recorded, whether \"undo\" or " "\"redo\" is possible, the current position inside the journal, etc." msgstr "언제든지 저널링 상태를 쿼리할 수 있습니다: 저널링이 활성화되어 있는지, 몇 개의 작업이 기록되었는지, \"실행 취소\" 또는 \"다시 실행\"이 가능한지, 저널 내 현재 위치 등입니다." #: ../../recipes-journalling.rst:19 5748ec5bd69741daaecd28651e5b67b8 msgid "" "The journal can be **saved to** or **loaded from** a file. These are " "document methods." msgstr "저널은 파일에 **저장** 하거나 파일에서 **로드** 할 수 있습니다. 이것들은 문서 메서드입니다." #: ../../recipes-journalling.rst:20 2a1ee018fa1144fba3f9e32e294bcd4e msgid "" "When loading a journal file, compatibility with the document is checked " "and journalling is automatically enabled upon success." msgstr "저널 파일을 로드할 때 문서와의 호환성이 확인되며, 성공 시 저널링이 자동으로 활성화됩니다." #: ../../recipes-journalling.rst:21 359a67deba6d45c7b2870adfc40b92b5 msgid "" "For an **existing** PDF being journalled, a special new save method is " "available: :meth:`Document.save_snapshot`. This performs a special " "incremental save that includes all journalled updates so far. If its " "journal is saved at the same time (immediately after the document " "snapshot), then document and journal are in sync and can later on be used" " together to undo or redo operations or to continue journalled updates --" " just as if there had been no interruption." msgstr "저널링 중인 **기존** PDF의 경우 특별한 새 저장 메서드인 :meth:`Document.save_snapshot` 를 사용할 수 있습니다. 이것은 지금까지의 모든 저널링된 업데이트를 포함하는 특별한 증분 저장을 수행합니다. 저널이 동시에 저장되면(문서 스냅샷 직후) 문서와 저널이 동기화되어 나중에 작업을 실행 취소하거나 다시 실행하거나 저널링된 업데이트를 계속하는 데 함께 사용할 수 있습니다. 마치 중단이 없었던 것처럼." #: ../../recipes-journalling.rst:22 2371ef9364394ab18af8172ee2fbd84c msgid "" "The snapshot PDF is a valid PDF in every aspect and fully usable. If the " "document is however changed in any way without using its journal file, " "then a desynchronization will take place and the journal is rendered " "unusable." msgstr "스냅샷 PDF는 모든 측면에서 유효한 PDF이며 완전히 사용 가능합니다. 하지만 저널 파일을 사용하지 않고 문서가 어떤 방식으로든 변경되면 동기화가 해제되고 저널이 사용 불가능해집니다." #: ../../recipes-journalling.rst:23 88b4f9365d4e41919901f2e3341b68b3 msgid "" "Snapshot files are structured like incremental updates. Nevertheless, the" " internal journalling logic requires, that saving **must happen to a new " "file**. So the user should develop a file naming convention to support " "recognizable relationships between an original PDF, like `original.pdf` " "and its snapshot sets, like `original-snap1.pdf` / `original-snap1.log`, " "`original-snap2.pdf` / `original-snap2.log`, etc." msgstr "스냅샷 파일은 증분 업데이트처럼 구조화됩니다. 그럼에도 불구하고 내부 저널링 로직은 저장이 **새 파일에** 발생해야 합니다. 따라서 사용자는 원본 PDF(예: `original.pdf`)와 스냅샷 세트(예: `original-snap1.pdf` / `original-snap1.log`, `original-snap2.pdf` / `original-snap2.log` 등) 간의 인식 가능한 관계를 지원하는 파일 명명 규칙을 개발해야 합니다." #: ../../recipes-journalling.rst:26 86cb216c0b2c49ad82e67e5dcd1dad33 msgid "Example Session 1" msgstr "예제 세션 1" #: ../../recipes-journalling.rst:27 ../../recipes-journalling.rst:98 #: 623199d65f524b49925fac870071c962 e45525e109c54fde88b07c36ca5ae547 msgid "Description:" msgstr "설명:" #: ../../recipes-journalling.rst:29 64be3df2712342b6b3a07eb934808271 msgid "" "Make a new PDF and enable journalling. Then add a page and some text " "lines -- each as a separate operation." msgstr "새 PDF를 만들고 저널링을 활성화합니다. 그런 다음 페이지와 일부 텍스트 줄을 추가합니다. 각각을 별도의 작업으로 수행합니다." #: ../../recipes-journalling.rst:30 f87700abdc524bcf98d294a44fcb2e9d msgid "" "Navigate within the journal, undoing and redoing these updates and " "displaying status and file results::" msgstr "저널 내에서 이동하며 이러한 업데이트를 실행 취소하고 다시 실행하며 상태와 파일 결과를 표시합니다::" #: ../../recipes-journalling.rst:97 f540b437628341a68f1d143da3561958 msgid "Example Session 2" msgstr "예제 세션 2" #: ../../recipes-journalling.rst:100 e49f0638f47e40cfa88e8a2e5c342dc4 msgid "" "Similar to previous, but after undoing some operations, we now add a " "different update. This will cause:" msgstr "이전과 유사하지만 일부 작업을 실행 취소한 후 다른 업데이트를 추가합니다. 이것은 다음을 유발합니다:" #: ../../recipes-journalling.rst:102 aeb2a12789f44076a21e14f5e8edbdf0 msgid "permanent removal of the undone journal entries" msgstr "실행 취소된 저널 항목의 영구 제거" #: ../../recipes-journalling.rst:103 039d45dbbda9472596a7e3eab31cb2f1 msgid "the new update operation will become the new last entry." msgstr "새 업데이트 작업이 새로운 마지막 항목이 됩니다." #: ../../footer.rst:46 5ed33c2c15454dd7b2014d897f80427a msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-low-level-interfaces.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 75434c61000b4a94a1404a3d68f178d3 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 ddfdaa7abef4454c84dd019f11c20c87 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 903f0a7765df4517bf839cf576bb4cd7 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-low-level-interfaces.rst:7 876f381a92644748ae6580657c5d6371 msgid "Low-Level Interfaces" msgstr "저수준 인터페이스" #: ../../recipes-low-level-interfaces.rst:10 56a6762686bb479a903f22b76be1b5e4 msgid "" "Numerous methods are available to access and manipulate PDF files on a " "fairly low level. Admittedly, a clear distinction between \"low level\" " "and \"normal\" functionality is not always possible or subject to " "personal taste." msgstr "PDF 파일에 상당히 낮은 수준으로 액세스하고 조작할 수 있는 많은 메서드가 있습니다. 인정하건대, \"낮은 수준\"과 \"일반\" 기능 간의 명확한 구분이 항상 가능한 것은 아니며 개인 취향에 따라 다를 수 있습니다." #: ../../recipes-low-level-interfaces.rst:12 509bc82d522c4d62bd7cf935e205a083 msgid "" "It also may happen, that functionality previously deemed low-level is " "later on assessed as being part of the normal interface. This has " "happened in v1.14.0 for the class :ref:`Tools` - you now find it as an " "item in the Classes chapter." msgstr "이전에 낮은 수준으로 간주되었던 기능이 나중에 일반 인터페이스의 일부로 평가될 수도 있습니다. 이것은 v1.14.0에서 :ref:`Tools` 클래스에 대해 발생했습니다 -- 이제 Classes 장에서 항목으로 찾을 수 있습니다." #: ../../recipes-low-level-interfaces.rst:14 20061f0fd15a4e39ad5408b30f02ea0d msgid "" "It is a matter of documentation only in which chapter of the " "documentation you find what you are looking for. Everything is available " "and always via the same interface." msgstr "문서의 어느 장에서 찾고 있는 것을 찾을 수 있는지는 문서화의 문제일 뿐입니다. 모든 것이 사용 가능하며 항상 동일한 인터페이스를 통해 제공됩니다." #: ../../recipes-low-level-interfaces.rst:19 3d2eebf5f47c48afb777b5e1cbe85fa9 msgid "How to Iterate through the :data:`xref` Table" msgstr ":data:`xref` 테이블을 반복하는 방법" #: ../../recipes-low-level-interfaces.rst:20 c9233e278f7a44a5b599e88a0848f67a msgid "" "A PDF's :data:`xref` table is a list of all objects defined in the file. " "This table may easily contain many thousands of entries -- the manual " ":ref:`AdobeManual` for example has 127,000 objects. Table entry \"0\" is " "reserved and must not be touched. The following script loops through the " ":data:`xref` table and prints each object's definition::" msgstr "PDF의 :data:`xref` 테이블은 파일에 정의된 모든 객체의 목록입니다. 이 테이블은 수천 개의 항목을 쉽게 포함할 수 있습니다 -- 예를 들어 :ref:`AdobeManual` 에는 127,000개의 객체가 있습니다. 테이블 항목 \"0\"은 예약되어 있으며 건드리면 안 됩니다. 다음 스크립트는 :data:`xref` 테이블을 반복하고 각 객체의 정의를 인쇄합니다::" #: ../../recipes-low-level-interfaces.rst:32 b93c9745639841dabd4c68c0cc52e782 msgid "This produces the following output::" msgstr "이것은 다음 출력을 생성합니다::" #: ../../recipes-low-level-interfaces.rst:72 d3c70e3964ee4a28b58534c83ad26bbc msgid "A PDF object definition is an ordinary ASCII string." msgstr "PDF 객체 정의는 일반 ASCII 문자열입니다." #: ../../recipes-low-level-interfaces.rst:77 493207cb244546a59a72c418fd16281c msgid "How to Handle Object Streams" msgstr "객체 스트림 처리 방법" #: ../../recipes-low-level-interfaces.rst:78 e736d6692a344e6280ec68ba8aa262da msgid "" "Some object types contain additional data apart from their object " "definition. Examples are images, fonts, embedded files or commands " "describing the appearance of a page." msgstr "일부 객체 유형은 객체 정의 외에 추가 데이터를 포함합니다. 예로는 이미지, 글꼴, 임베디드 파일 또는 페이지 모양을 설명하는 명령이 있습니다." #: ../../recipes-low-level-interfaces.rst:80 cabdb524e1d849448046bf6e2d206342 msgid "" "Objects of these types are called \"stream objects\". PyMuPDF allows " "reading an object's stream via method :meth:`Document.xref_stream` with " "the object's :data:`xref` as an argument. It is also possible to write " "back a modified version of a stream using :meth:`Document.update_stream`." msgstr "이러한 유형의 객체를 \"스트림 객체\"라고 합니다. |PyMuPDF| 는 객체의 :data:`xref` 를 인수로 사용하여 :meth:`Document.xref_stream` 메서드를 통해 객체의 스트림을 읽을 수 있게 합니다. :meth:`Document.update_stream` 을 사용하여 수정된 스트림 버전을 다시 쓸 수도 있습니다." #: ../../recipes-low-level-interfaces.rst:82 ba7bea2d5ccf47818f2fbbdf71fff7fd msgid "" "Assume that the following snippet wants to read all streams of a PDF for " "whatever reason::" msgstr "다음 코드 조각이 어떤 이유로든 PDF의 모든 스트림을 읽고 싶다고 가정합니다::" #: ../../recipes-low-level-interfaces.rst:91 9047c6fd5efa437b8bc7bc5353205ab2 msgid "" ":meth:`Document.xref_stream` automatically returns a stream decompressed " "as a bytes object -- and :meth:`Document.update_stream` automatically " "compresses it if beneficial." msgstr ":meth:`Document.xref_stream` 은 스트림을 자동으로 압축 해제하여 bytes 객체로 반환합니다 -- 그리고 :meth:`Document.update_stream` 은 유리한 경우 자동으로 압축합니다." #: ../../recipes-low-level-interfaces.rst:96 5546055dde52483fab745bbc48f96b0f msgid "How to Handle Page Contents" msgstr "페이지 콘텐츠 처리 방법" #: ../../recipes-low-level-interfaces.rst:97 9e0c2c1ba3df4e1d8317099f96c3c0a6 msgid "" "A PDF page can have zero or multiple :data:`contents` objects. These are " "stream objects describing **what** appears **where** and **how** on a " "page (like text and images). They are written in a special mini-language " "described e.g. in chapter \"APPENDIX A - Operator Summary\" on page 643 " "of the :ref:`AdobeManual`." msgstr "PDF 페이지는 0개 또는 여러 개의 :data:`contents` 객체를 가질 수 있습니다. 이것들은 페이지에서 **무엇** 이 **어디에** 그리고 **어떻게** 나타나는지(텍스트 및 이미지와 같은) 설명하는 스트림 객체입니다. 이것들은 :ref:`AdobeManual` 의 643페이지 \"APPENDIX A - Operator Summary\" 장에 설명된 특수 미니 언어로 작성됩니다." #: ../../recipes-low-level-interfaces.rst:99 386e5519cf9249b2ba829b533c775316 msgid "" "Every PDF reader application must be able to interpret the contents " "syntax to reproduce the intended appearance of the page." msgstr "모든 PDF 리더 애플리케이션은 페이지의 의도된 모양을 재현하기 위해 콘텐츠 구문을 해석할 수 있어야 합니다." #: ../../recipes-low-level-interfaces.rst:101 28d8cbd998214286ac22c11bab9374a1 msgid "" "If multiple :data:`contents` objects are provided, they must be " "interpreted in the specified sequence in exactly the same way as if they " "were provided as a concatenation of the several." msgstr "여러 :data:`contents` 객체가 제공되는 경우, 여러 개의 연결로 제공된 것과 정확히 동일한 방식으로 지정된 순서로 해석되어야 합니다." #: ../../recipes-low-level-interfaces.rst:103 d47ff2ffa881474caad92f60fd6bdb53 msgid "" "There are good technical arguments for having multiple :data:`contents` " "objects:" msgstr "여러 :data:`contents` 객체를 갖는 것에 대한 좋은 기술적 논거가 있습니다:" #: ../../recipes-low-level-interfaces.rst:105 0a53f856d8904323aef9b42981091b99 msgid "" "It is a lot easier and faster to just add new :data:`contents` objects " "than maintaining a single big one (which entails reading, decompressing, " "modifying, recompressing, and rewriting it for each change)." msgstr "하나의 큰 객체를 유지하는 것(각 변경에 대해 읽기, 압축 해제, 수정, 재압축 및 다시 쓰기를 수반함)보다 새로운 :data:`contents` 객체를 추가하는 것이 훨씬 쉽고 빠릅니다." #: ../../recipes-low-level-interfaces.rst:106 fcbe0dac945345dd948d48f71cb2211d msgid "" "When working with incremental updates, a modified big :data:`contents` " "object will bloat the update delta and can thus easily negate the " "efficiency of incremental saves." msgstr "" "증분 업데이트로 작업할 때 수정된 큰 :data:`contents` 객체는 업데이트 델타를 부풀려서 증분 저장의 효율성을 쉽게 무효화할 " "수 있습니다." #: ../../recipes-low-level-interfaces.rst:108 0d451f51c5ee4fd7a0f796fedca1aaef msgid "" "For example, PyMuPDF adds new, small :data:`contents` objects in methods " ":meth:`Page.insert_image`, :meth:`Page.show_pdf_page` and the " ":ref:`Shape` methods." msgstr "" "예를 들어, |PyMuPDF| 는 :meth:`Page.insert_image`, :meth:`Page.show_pdf_page` 및 " ":ref:`Shape` 메서드에서 새로운 작은 :data:`contents` 객체를 추가합니다." #: ../../recipes-low-level-interfaces.rst:110 89445c95103d4a92beb375bccb7fa5ab msgid "" "However, there are also situations when a **single** :data:`contents` " "object is beneficial: it is easier to interpret and more compressible " "than multiple smaller ones." msgstr "" "그러나 **단일** :data:`contents` 객체가 유리한 상황도 있습니다: 여러 개의 작은 객체보다 해석하기 쉽고 압축률이 " "더 높습니다." #: ../../recipes-low-level-interfaces.rst:112 2a0b4642b4364684a16adb1d39489ec3 msgid "Here are two ways of combining multiple contents of a page::" msgstr "다음은 페이지의 여러 콘텐츠를 결합하는 두 가지 방법입니다::" #: ../../recipes-low-level-interfaces.rst:124 6057b6061a91411ea964bce99b20537e msgid "" "The clean function :meth:`Page.clean_contents` does a lot more than just " "glueing :data:`contents` objects: it also corrects and optimizes the PDF " "operator syntax of the page and removes any inconsistencies with the " "page's object definition." msgstr "" "정리 함수 :meth:`Page.clean_contents` 는 :data:`contents` 객체를 결합하는 것 이상의 작업을 수행합니다: " "페이지의 PDF 연산자 구문을 수정하고 최적화하며 페이지 객체 정의와의 불일치를 제거합니다." #: ../../recipes-low-level-interfaces.rst:129 844f10a12b4048188390d4080ce7c9c3 msgid "How to Access the PDF Catalog" msgstr "PDF 카탈로그 액세스 방법" #: ../../recipes-low-level-interfaces.rst:130 fb4cc97df02e4b7dabd01a2eb37ac0ce msgid "" "This is a central (\"root\") object of a PDF. It serves as a starting " "point to reach important other objects and it also contains some global " "options for the PDF::" msgstr "" "이것은 PDF의 중앙(\"루트\") 객체입니다. 중요한 다른 객체에 도달하기 위한 시작점 역할을 하며 PDF에 대한 일부 전역 옵션도 " "포함합니다::" #: ../../recipes-low-level-interfaces.rst:146 1a3be34ec5154f478840f9583752a6dd msgid "" "Indentation, line breaks and comments are inserted here for clarification" " purposes only and will not normally appear. For more information on the " "PDF catalog see section 7.7.2 on page 71 of the :ref:`AdobeManual`." msgstr "" "들여쓰기, 줄 바꿈 및 주석은 설명 목적으로만 여기에 삽입되었으며 일반적으로 나타나지 않습니다. PDF 카탈로그에 대한 자세한 " "내용은 :ref:`AdobeManual` 의 71페이지 섹션 7.7.2를 참조하세요." #: ../../recipes-low-level-interfaces.rst:151 f6cb282ffd654805b67324bd72b4ae19 msgid "How to Access the PDF File Trailer" msgstr "PDF 파일 트레일러 액세스 방법" #: ../../recipes-low-level-interfaces.rst:152 2f99555ea9464790998c72d9bb928af6 msgid "" "The trailer of a PDF file is a :data:`dictionary` located towards the end" " of the file. It contains special objects, and pointers to important " "other information. See :ref:`AdobeManual` p. 42. Here is an overview:" msgstr "" "PDF 파일의 트레일러는 파일 끝 부분에 위치한 :data:`dictionary` 입니다. 특수 객체와 중요한 다른 정보에 대한 포인터를 " "포함합니다. :ref:`AdobeManual` 42페이지를 참조하세요. 다음은 개요입니다:" #: ../../recipes-low-level-interfaces.rst:155 04bff59ce53f4b8fa7cc2d5c1e5eea13 msgid "**Key**" msgstr "**키**" #: ../../recipes-low-level-interfaces.rst:155 8e89e5f4179345d481243a717e85c672 msgid "**Type**" msgstr "**유형**" #: ../../recipes-low-level-interfaces.rst:155 903806d55c7b4a6ba366a2fb6723087b msgid "**Value**" msgstr "**값**" #: ../../recipes-low-level-interfaces.rst:157 3f86ae718b944400beb0abe4e3c0ffc6 msgid "Size" msgstr "Size" #: ../../recipes-low-level-interfaces.rst:157 #: ../../recipes-low-level-interfaces.rst:158 #: ../../recipes-low-level-interfaces.rst:163 0151f1cab4e14722a6078e4d9d1ef692 #: 65f366157b6d48fd9a44282c78eeb3fb f3e5b4c1111842a3bdd6a8d28b0ace69 msgid "int" msgstr "int" #: ../../recipes-low-level-interfaces.rst:157 b687a9563e5445e1a4a96170f23fd4ed msgid "Number of entries in the cross-reference table + 1." msgstr "교차 참조 테이블의 항목 수 + 1." #: ../../recipes-low-level-interfaces.rst:158 c04f76c59d18423996a207301fe05b6c msgid "Prev" msgstr "Prev" #: ../../recipes-low-level-interfaces.rst:158 f3def7a36286442a9177758486e19b60 msgid "Offset to previous :data:`xref` section (indicates incremental updates)." msgstr "이전 :data:`xref` 섹션으로의 오프셋(증분 업데이트를 나타냄)." #: ../../recipes-low-level-interfaces.rst:159 c31d927f0f504e1eab1cc5069c67fb84 msgid "Root" msgstr "Root" #: ../../recipes-low-level-interfaces.rst:159 #: ../../recipes-low-level-interfaces.rst:160 #: ../../recipes-low-level-interfaces.rst:161 46c865d65cb54d6a9bd3680eadccc9e2 #: 4cac1014b9f949de8a9fea7b1ec825d4 71dd8129bfe3455c9ba485dee7df486a msgid "dictionary" msgstr "dictionary" #: ../../recipes-low-level-interfaces.rst:159 7ce50eec5fcd45bf8ec4c639257e81f2 msgid "(indirect) Pointer to the catalog. See previous section." msgstr "(간접) 카탈로그에 대한 포인터. 이전 섹션을 참조하세요." #: ../../recipes-low-level-interfaces.rst:160 076ac475747440afa77a21c7e831af71 msgid "Encrypt" msgstr "Encrypt" #: ../../recipes-low-level-interfaces.rst:160 dbd95d95d21d4d63b464a548435e60f7 msgid "Pointer to encryption object (encrypted files only)." msgstr "암호화 객체에 대한 포인터(암호화된 파일만 해당)." #: ../../recipes-low-level-interfaces.rst:161 d3a696bffe5c47e68d3282ffcd42bdbd msgid "Info" msgstr "Info" #: ../../recipes-low-level-interfaces.rst:161 4005b1fad3e54caf9398edeb6a5903d2 msgid "(indirect) Pointer to information (metadata)." msgstr "(간접) 정보(메타데이터)에 대한 포인터." #: ../../recipes-low-level-interfaces.rst:162 5fab0c7955d749a48d2a3b763b7c9670 msgid "ID" msgstr "ID" #: ../../recipes-low-level-interfaces.rst:162 6898db1a22a3477fa753166d2cbe3164 msgid "array" msgstr "array" #: ../../recipes-low-level-interfaces.rst:162 6b2347ffb47c4b0081aa8acde158dcc0 msgid "File identifier consisting of two byte strings." msgstr "두 개의 바이트 문자열로 구성된 파일 식별자." #: ../../recipes-low-level-interfaces.rst:163 8139050a469b4720a0c241492831b167 msgid "XRefStm" msgstr "XRefStm" #: ../../recipes-low-level-interfaces.rst:163 05d57dc7bf91480f8003a6fc80f999f0 msgid "Offset of a cross-reference stream. See :ref:`AdobeManual` p. 49." msgstr "교차 참조 스트림의 오프셋. :ref:`AdobeManual` 49페이지를 참조하세요." #: ../../recipes-low-level-interfaces.rst:166 6202cb8493b044fab435b3e03390cc72 msgid "" "Access this information via PyMuPDF with :meth:`Document.pdf_trailer` or," " equivalently, via :meth:`Document.xref_object` using -1 instead of a " "valid :data:`xref` number." msgstr "" "|PyMuPDF| 에서 :meth:`Document.pdf_trailer` 또는 동등하게 유효한 :data:`xref` 번호 대신 -1을 " "사용하는 :meth:`Document.xref_object` 를 통해 이 정보에 액세스합니다." #: ../../recipes-low-level-interfaces.rst:187 9471214cc8bf436a85a288b50896bcec msgid "How to Access XML Metadata" msgstr "XML 메타데이터 액세스 방법" #: ../../recipes-low-level-interfaces.rst:188 11166fcb45b742b390422fc68e337f42 msgid "" "A PDF may contain XML metadata in addition to the standard metadata " "format. In fact, most PDF viewer or modification software adds this type " "of information when saving the PDF (Adobe, Nitro PDF, PDF-XChange, etc.)." msgstr "" "PDF는 표준 메타데이터 형식 외에 XML 메타데이터를 포함할 수 있습니다. 실제로 대부분의 PDF 뷰어 또는 수정 소프트웨어는 PDF를 " "저장할 때 이 유형의 정보를 추가합니다(Adobe, Nitro PDF, PDF-XChange 등)." #: ../../recipes-low-level-interfaces.rst:190 66fa949fa3734abc94308b18f181168d msgid "" "PyMuPDF has no way to **interpret or change** this information directly, " "because it contains no XML features. XML metadata is however stored as a " ":data:`stream` object, so it can be read, modified with appropriate " "software and written back." msgstr "" "|PyMuPDF| 는 XML 기능을 포함하지 않기 때문에 이 정보를 직접 **해석하거나 변경** 할 수 있는 방법이 없습니다. 그러나 XML " "메타데이터는 :data:`stream` 객체로 저장되므로 읽고, 적절한 소프트웨어로 수정하고, 다시 쓸 수 있습니다." #: ../../recipes-low-level-interfaces.rst:202 d89d8b8d321c4343b58807d0a6abb8f3 msgid "" "Using some XML package, the XML data can be interpreted and / or modified" " and then stored back. The following also works, if the PDF previously " "had no XML metadata::" msgstr "" "일부 XML 패키지를 사용하여 XML 데이터를 해석 및/또는 수정한 다음 다시 저장할 수 있습니다. PDF에 이전에 XML 메타데이터가 " "없었던 경우에도 다음이 작동합니다::" #: ../../recipes-low-level-interfaces.rst:213 1c05939e6ce141669a782bf9f395e2e3 msgid "How to Extend PDF Metadata" msgstr "PDF 메타데이터 확장 방법" #: ../../recipes-low-level-interfaces.rst:214 3c73d296caa64f959f4462e689310160 msgid "" "Attribute :attr:`Document.metadata` is designed so it works for all " ":ref:`supported document types` in the same way: it" " is a Python dictionary with a **fixed set of key-value pairs**. " "Correspondingly, :meth:`Document.set_metadata` only accepts standard " "keys." msgstr "" "속성 :attr:`Document.metadata` 는 모든 :ref:`지원되는 문서 유형` 에 대해 " "동일한 방식으로 작동하도록 설계되었습니다: **고정된 키-값 쌍 집합** 이 있는 Python 딕셔너리입니다. 따라서 " ":meth:`Document.set_metadata` 는 표준 키만 허용합니다." #: ../../recipes-low-level-interfaces.rst:216 2d338508ee9d4183a1e01a0ddc4913fb msgid "" "However, PDFs may contain items not accessible like this. Also, there may" " be reasons to store additional information, like copyrights. Here is a " "way to handle **arbitrary metadata items** by using PyMuPDF low-level " "functions." msgstr "" "그러나 PDF에는 이렇게 액세스할 수 없는 항목이 포함될 수 있습니다. 또한 저작권과 같은 추가 정보를 저장할 이유가 있을 수 " "있습니다. 다음은 |PyMuPDF| 저수준 함수를 사용하여 **임의의 메타데이터 항목** 을 처리하는 방법입니다." #: ../../recipes-low-level-interfaces.rst:218 4b3358b8f8ae445d967cb16ecb41155b msgid "As an example, look at this standard metadata output of some PDF::" msgstr "예를 들어, 일부 PDF의 표준 메타데이터 출력을 살펴보세요::" #: ../../recipes-low-level-interfaces.rst:237 3e9c31875d914679be24d654087376b7 msgid "" "Use the following code to see **all items** stored in the metadata " "object::" msgstr "다음 코드를 사용하여 메타데이터 객체에 저장된 **모든 항목** 을 확인하세요::" #: ../../recipes-low-level-interfaces.rst:265 9044da7dae9243488a9b55198969056f msgid "" "*Vice versa*, you can also **store private metadata items** in a PDF. It " "is your responsibility to make sure that these items conform to PDF " "specifications - especially they must be (unicode) strings. Consult " "section 14.3 (p. 548) of the :ref:`AdobeManual` for details and caveats::" msgstr "" "*반대로*, PDF에 **개인 메타데이터 항목** 을 저장할 수도 있습니다. 이러한 항목이 PDF 사양을 준수하는지 확인하는 것은 " "귀하의 책임입니다. 특히 (유니코드) 문자열이어야 합니다. 자세한 내용과 주의사항은 :ref:`AdobeManual` 의 섹션 " "14.3(548페이지)을 참조하세요::" #: ../../recipes-low-level-interfaces.rst:287 02817b654e9b436b88b8c0bb4315843c msgid "" "To delete selected keys, use `doc.xref_set_key(xref, \"mykey\", " "\"null\")`. As explained in the next section, string \"null\" is the PDF " "equivalent to Python's `None`. A key with that value will be treated as " "not being specified -- and physically removed in garbage collections." msgstr "" "선택한 키를 삭제하려면 `doc.xref_set_key(xref, \"mykey\", \"null\")` 을 사용하세요. 다음 섹션에서 설명한 " "대로 문자열 \"null\" 은 Python의 `None` 에 해당하는 PDF입니다. 해당 값을 가진 키는 지정되지 않은 것으로 " "처리되며 가비지 수집에서 물리적으로 제거됩니다." #: ../../recipes-low-level-interfaces.rst:292 1b30dcfaa7584ec7ad6ea741fcef3f3d msgid "How to Read and Update PDF Objects" msgstr "PDF 객체 읽기 및 업데이트 방법" #: ../../recipes-low-level-interfaces.rst:297 3d42ddab6e0142cebbd430aa2e5703b5 msgid "" "There also exist granular, elegant ways to access and manipulate selected" " PDF :data:`dictionary` keys." msgstr "선택한 PDF :data:`dictionary` 키에 액세스하고 조작하는 세밀하고 우아한 방법도 있습니다." #: ../../recipes-low-level-interfaces.rst:299 0ae387a252ac402cbd803641d93dffb8 msgid "" ":meth:`Document.xref_get_keys` returns the PDF keys of the object at " ":data:`xref`::" msgstr ":meth:`Document.xref_get_keys` 는 :data:`xref` 의 객체의 PDF 키를 반환합니다::" #: ../../recipes-low-level-interfaces.rst:308 3e72f7b183cd4b33906cc3039c3d5231 msgid "Compare with the full object definition::" msgstr "전체 객체 정의와 비교하세요::" #: ../../recipes-low-level-interfaces.rst:319 3e65febdd754494e963713aa6ab4e707 msgid "" "Single keys can also be accessed directly via " ":meth:`Document.xref_get_key`. The value **always is a string** together " "with type information, that helps with interpreting it::" msgstr "" "단일 키는 :meth:`Document.xref_get_key` 를 통해 직접 액세스할 수도 있습니다. 값은 **항상 문자열** 이며 " "해석에 도움이 되는 유형 정보와 함께 제공됩니다::" #: ../../recipes-low-level-interfaces.rst:324 05f684fed3f04de4bb45d40de217b49d msgid "Here is a full listing of the above page keys::" msgstr "다음은 위의 페이지 키의 전체 목록입니다::" #: ../../recipes-low-level-interfaces.rst:335 9a78976524a4487aa10951cc475ba498 msgid "" "An undefined key inquiry returns `('null', 'null')` -- PDF object type " "`null` corresponds to `None` in Python. Similar for the booleans `true` " "and `false`." msgstr "" "정의되지 않은 키 조회는 `('null', 'null')` 을 반환합니다 -- PDF 객체 유형 `null` 은 Python의 `None` " "에 해당합니다. 부울 `true` 및 `false` 도 유사합니다." #: ../../recipes-low-level-interfaces.rst:336 a799622cee4441148aa30dadcc2c66b8 msgid "" "Let us add a new key to the page definition that sets its rotation to 90 " "degrees (you are aware that there actually exists " ":meth:`Page.set_rotation` for this?)::" msgstr "" "페이지 정의에 회전을 90도로 설정하는 새 키를 추가해 보겠습니다(이를 위해 실제로 :meth:`Page.set_rotation` 이 " "존재한다는 것을 알고 계신가요?)::" #: ../../recipes-low-level-interfaces.rst:351 8bf57e3c458a40379cf2dacf4867c307 msgid "" "This method can also be used to remove a key from the :data:`xref` " "dictionary by setting its value to `null`: The following will remove the " "rotation specification from the page: `doc.xref_set_key(page.xref, " "\"Rotate\", \"null\")`. Similarly, to remove all links, annotations and " "fields from a page, use `doc.xref_set_key(page.xref, \"Annots\", " "\"null\")`. Because `Annots` by definition is an array, setting en empty " "array with the statement `doc.xref_set_key(page.xref, \"Annots\", " "\"[]\")` would do the same job in this case." msgstr "" "이 메서드는 값을 `null` 로 설정하여 :data:`xref` 딕셔너리에서 키를 제거하는 데에도 사용할 수 있습니다: 다음은 " "페이지에서 회전 사양을 제거합니다: `doc.xref_set_key(page.xref, \"Rotate\", \"null\")`. " "마찬가지로 페이지에서 모든 링크, 주석 및 필드를 제거하려면 `doc.xref_set_key(page.xref, \"Annots\", " "\"null\")` 을 사용하세요. `Annots` 는 정의상 배열이므로 `doc.xref_set_key(page.xref, \"Annots\", " "\"[]\")` 문으로 빈 배열을 설정하면 이 경우 동일한 작업을 수행합니다." #: ../../recipes-low-level-interfaces.rst:353 eb61cb57cb054fbcba0a0e87011b9704 msgid "" "PDF dictionaries can be hierarchically nested. In the following page " "object definition both, `Font` and `XObject` are subdictionaries of " "`Resources`::" msgstr "" "PDF 딕셔너리는 계층적으로 중첩될 수 있습니다. 다음 페이지 객체 정의에서 `Font` 와 `XObject` 는 모두 `Resources` 의 " "하위 딕셔너리입니다::" #: ../../recipes-low-level-interfaces.rst:373 53a1a5f64c1b46b6a11637fe7a037f27 msgid "" "The above situation **is supported** by methods " ":meth:`Document.xref_set_key` and :meth:`Document.xref_get_key`: use a " "path-like notation to point at the required key. For example, to retrieve" " the value of key `Im1` above, specify the complete chain of dictionaries" " \"above\" it in the key argument: `\"Resources/XObject/Im1\"`::" msgstr "" "위의 상황은 :meth:`Document.xref_set_key` 및 :meth:`Document.xref_get_key` 메서드로 " "**지원됩니다**: 필요한 키를 가리키는 경로와 같은 표기법을 사용하세요. 예를 들어 위의 키 `Im1` 의 값을 검색하려면 키 " "인수에 그 위의 딕셔너리 전체 체인을 지정하세요: `\"Resources/XObject/Im1\"`::" #: ../../recipes-low-level-interfaces.rst:378 29393cc04fc94daf8a80dff959cc95d5 msgid "" "The path notation can also be used to **directly set a value**: use the " "following to let `Im1` point to a different object::" msgstr "" "경로 표기법은 **값을 직접 설정** 하는 데에도 사용할 수 있습니다: 다음을 사용하여 `Im1` 이 다른 객체를 가리키도록 " "하세요::" #: ../../recipes-low-level-interfaces.rst:399 e8cf3e8fbf4a429d8ad7ad100f97899d msgid "" "Be aware, that **no semantic checks** whatsoever will take place here: if" " the PDF has no xref 9999, it won't be detected at this point." msgstr "" "**의미론적 검사** 가 전혀 수행되지 않는다는 점에 유의하세요: PDF에 xref 9999가 없으면 이 시점에서 감지되지 " "않습니다." #: ../../recipes-low-level-interfaces.rst:401 d43960f2d29045d6995ad727a6a18ef6 msgid "" "If a key does not exist, it will be created by setting its value. " "Moreover, if any intermediate keys do not exist either, they will also be" " created as necessary. The following creates an array `D` several levels " "below the existing dictionary `A`. Intermediate dictionaries `B` and `C` " "are automatically created::" msgstr "" "키가 존재하지 않으면 값을 설정하여 생성됩니다. 또한 중간 키가 존재하지 않으면 필요에 따라 생성됩니다. 다음은 기존 딕셔너리 " "`A` 아래 여러 레벨에 배열 `D` 를 만듭니다. 중간 딕셔너리 `B` 와 `C` 가 자동으로 생성됩니다::" #: ../../recipes-low-level-interfaces.rst:421 bba82e04d29a431c8cfaa0c81a8422c0 msgid "" "When setting key values, basic **PDF syntax checking** will be done by " "MuPDF. For example, new keys can only be created **below a dictionary**. " "The following tries to create some new string item `E` below the " "previously created array `D`::" msgstr "" "키 값을 설정할 때 기본 **PDF 구문 검사** 가 MuPDF에 의해 수행됩니다. 예를 들어 새 키는 **딕셔너리 아래에만** 생성할 수 " "있습니다. 다음은 이전에 생성된 배열 `D` 아래에 새 문자열 항목 `E` 를 만들려고 시도합니다::" #: ../../recipes-low-level-interfaces.rst:429 b3e5658efb1847799ff226694699b334 msgid "" "It is also **not possible**, to create a key if some higher level key is " "an **\"indirect\"** object, i.e. an xref. In other words, xrefs can only " "be modified directly and not implicitly via other objects referencing " "them::" msgstr "" "상위 레벨 키가 **\"간접\"** 객체(즉, xref)인 경우 키를 만드는 것도 **불가능합니다**. 즉, xref는 직접적으로만 수정할 " "수 있으며 이를 참조하는 다른 객체를 통해 암시적으로 수정할 수 없습니다::" #: ../../recipes-low-level-interfaces.rst:442 7cb0c4e7fe9e4eb580372473612bca3c msgid "" "These are expert functions! There are no validations as to whether valid " "PDF objects, xrefs, etc. are specified. As with other low-level methods " "there is the risk to render the PDF, or parts of it unusable." msgstr "" "이것들은 전문가용 함수입니다! 유효한 PDF 객체, xref 등이 지정되었는지에 대한 검증이 없습니다. 다른 저수준 메서드와 " "마찬가지로 PDF 또는 그 일부를 사용할 수 없게 만들 위험이 있습니다." #: ../../footer.rst:46 cdf69554bc5f45a1bcc753bd3326f80b msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-multiprocessing.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7e6f40d7964249e79b04c3d1e97663f7 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 0b0e7728efd643f2af88f9a10132b4db msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 fcd448c0f08b44ca81698f910e7f182b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../recipes-multiprocessing.rst:17 c6783e6e6a79406dbcc4279e7db0acff msgid "Multiprocessing" msgstr "멀티프로세싱" #: ../../recipes-multiprocessing.rst:19 3440ee5e309146219a07e286636ee246 msgid "" "|PyMuPDF| does not support running on multiple threads - doing so may " "cause incorrect behaviour or even crash Python itself." msgstr "|PyMuPDF| 는 여러 스레드에서 실행을 지원하지 않습니다. 그렇게 하면 잘못된 동작이 발생하거나 Python 자체가 충돌할 수 있습니다." #: ../../recipes-multiprocessing.rst:21 c2e5df4ee4234d12ae3febd77e85fbe3 msgid "" "However, there is the option to use :title:`Python's` *multiprocessing* " "module in a variety of ways." msgstr "하지만 :title:`Python의` *multiprocessing* 모듈을 다양한 방법으로 사용할 수 있는 옵션이 있습니다." #: ../../recipes-multiprocessing.rst:23 bf58d753cc3b40d7a405acc1f719c73c msgid "" "If you are looking to speed up page-oriented processing for a large " "document, use this script as a starting point. It should be at least " "twice as fast as the corresponding sequential processing." msgstr "큰 문서에 대한 페이지 지향 처리를 가속화하려면 이 스크립트를 시작점으로 사용하세요. 해당 순차 처리보다 최소 2배 빠르게 동작해야 합니다." #: ../../recipes-multiprocessing.rst:26 ../../recipes-multiprocessing.rst:37 #: c80ee239863c4c828445463631c1e884 f7c061f68ffd4ceeb32612aadf8d455e msgid "|toggleStart|" msgstr "|toggleStart|" #: ../../recipes-multiprocessing.rst:31 ../../recipes-multiprocessing.rst:42 #: 591531fd1bc740dcb7a6d96399fe0ae1 71adac329d5748839c5c665b80e4d71d msgid "|toggleEnd|" msgstr "|toggleEnd|" #: ../../recipes-multiprocessing.rst:34 29a0399816a94d87be2670a44b7590db msgid "" "Here is a more complex example involving inter-process communication " "between a main process (showing a GUI) and a child process doing " "|PyMuPDF| access to a document." msgstr "다음은 메인 프로세스(GUI 표시)와 문서에 대한 |PyMuPDF| 액세스를 수행하는 자식 프로세스 간의 프로세스 간 통신을 포함하는 더 복잡한 예제입니다." #: ../../footer.rst:46 bd8b258b125f42cda799e69f58599037 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-ocr.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 5b2b2477e1b643fe878fe480ca8a5a5c msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 9af1355de6074c539e4b51e5dd6b1657 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8dcf3faef7104a2cafff9541cb4c8daf msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../recipes-ocr.rst:17 d523ae4d9ab8407a9cf5b861f5297e31 msgid "OCR - Optical Character Recognition" msgstr "OCR - 광학 문자 인식" #: ../../recipes-ocr.rst:19 ad0635e0379e4e30a03ba26654ccd626 msgid "" "|PyMuPDF| has integrated support for OCR (Optical Character Recognition)." " It is possible to use OCR for both, images (via the :ref:`Pixmap` class)" " and for document pages." msgstr "|PyMuPDF| 는 OCR(광학 문자 인식)에 대한 통합 지원을 제공합니다. 이미지(:ref:`Pixmap` 클래스를 통해)와 문서 페이지 모두에 OCR을 사용할 수 있습니다." #: ../../recipes-ocr.rst:21 0e099596d02b489e9ad0b0acde488005 msgid "" "The feature is currently based on Tesseract-OCR which must be installed " "as a separate application -- see the :ref:`installation_ocr`." msgstr "이 기능은 현재 Tesseract-OCR을 기반으로 하며 별도의 애플리케이션으로 설치해야 합니다. 자세한 내용은 :ref:`installation_ocr` 을 참조하세요." #: ../../recipes-ocr.rst:24 ea8b233238a54196add63aa017b42543 msgid "How to OCR an Image" msgstr "이미지 OCR 방법" #: ../../recipes-ocr.rst:25 a44323f4b0df47da98d91ac1a37d6b21 msgid "" "A supported image must first be converted to a :ref:`Pixmap`. The Pixmap " "can then be saved to a 1-page PDF. This page will look like the original " "image with the same width and height. It will contain a layer of text as " "recognized by Tesseract." msgstr "지원되는 이미지는 먼저 :ref:`Pixmap` 으로 변환해야 합니다. 그런 다음 Pixmap을 1페이지 PDF로 저장할 수 있습니다. 이 페이지는 원본 이미지와 동일한 너비와 높이를 가집니다. Tesseract가 인식한 텍스트 레이어가 포함됩니다." #: ../../recipes-ocr.rst:27 fb8760d9d7144f5786b17ead972a9a1f msgid "" "The PDF can be generated via one of the methods " ":meth:`Pixmap.pdfocr_save` or :meth:`Pixmap.pdfocr_tobytes`, as a file on" " disk or as a PDF in memory." msgstr "PDF는 :meth:`Pixmap.pdfocr_save` 또는 :meth:`Pixmap.pdfocr_tobytes` 메서드 중 하나를 통해 디스크의 파일로 또는 메모리의 PDF로 생성할 수 있습니다." #: ../../recipes-ocr.rst:29 1f42a8e44a1d4d17b7f75da5f822e8aa msgid "" "The text can be extracted and searched with the usual text extraction and" " search methods (:meth:`Page.get_text`, :meth:`Page.search_for`, etc.). " "Please also note the following important facts and prerequisites:" msgstr "텍스트는 일반적인 텍스트 추출 및 검색 메서드(:meth:`Page.get_text`, :meth:`Page.search_for` 등)로 추출하고 검색할 수 있습니다. 다음 중요한 사실과 전제 조건도 참고하세요:" #: ../../recipes-ocr.rst:31 44371b59458b49ce97c3a0a6cc2e6b26 msgid "" "When converting the image to a Pixmap, please confirm that the color " "space is RGB and alpha is `False` (no transparency). Convert the original" " Pixmap if necessary." msgstr "이미지를 Pixmap으로 변환할 때 색 공간이 RGB이고 alpha가 `False` (투명도 없음)인지 확인하세요. 필요하면 원본 Pixmap을 변환하세요." #: ../../recipes-ocr.rst:32 30e5cba3998c418688b3fea3b830296b msgid "" "All text is written as \"hidden\" with Tesseract's own `GlyphLessFont`, a" " mono-spaced font with metrics comparable to Courier." msgstr "모든 텍스트는 Tesseract 자체 `GlyphLessFont` 로 \"숨김\"으로 작성되며, Courier와 유사한 메트릭을 가진 고정폭 글꼴입니다." #: ../../recipes-ocr.rst:33 6ac9d9f5b2824a4890be1cf73715c091 msgid "" "All text has the properties regular and black (i.e. no bold, no italic, " "no information about the original fonts)." msgstr "모든 텍스트는 일반 및 검은색 속성을 가집니다(즉, 굵게, 기울임꼴 없음, 원본 글꼴 정보 없음)." #: ../../recipes-ocr.rst:34 a08272a3cc18432f9cc35cdd8591c309 msgid "" "Tesseract does not recognize vector graphics (i.e. no drawings / line-" "art)." msgstr "Tesseract는 벡터 그래픽을 인식하지 않습니다(즉, 그림/선화 없음)." #: ../../recipes-ocr.rst:36 35e883700cc148b98f8d79dcf362ad4e msgid "This approach is also recommended to OCR a complete scanned PDF:" msgstr "이 방법은 전체 스캔된 PDF를 OCR하는 데도 권장됩니다:" #: ../../recipes-ocr.rst:38 d47d8fca90fb4141932d00dd7353c53a msgid "Render each page to a :ref:`Pixmap` with desired resolution" msgstr "각 페이지를 원하는 해상도로 :ref:`Pixmap` 에 렌더링" #: ../../recipes-ocr.rst:39 666549a157cb4d1eae9cfaa445aa6b78 msgid "Append the resulting 1-page PDF to the output PDF" msgstr "결과 1페이지 PDF를 출력 PDF에 추가" #: ../../recipes-ocr.rst:42 df250dae4cd34a3e9b289c490a3cde65 msgid "How to OCR a Document Page" msgstr "문서 페이지 OCR 방법" #: ../../recipes-ocr.rst:43 9a152c4ead1343cf86489d1427003811 msgid "" "Any supported document page can be OCR-ed -- either the complete page or " "only the image areas on it." msgstr "지원되는 모든 문서 페이지를 OCR할 수 있습니다. 페이지 전체 또는 해당 페이지의 이미지 영역만 OCR할 수 있습니다." #: ../../recipes-ocr.rst:45 75c8b08c675a49f2bf0d5425b06d171a msgid "" "Because optical character recognition is about one thousand times slower " "than standard text extraction, we make sure to do OCR only once per page " "and store the result in a :ref:`TextPage`. Using this TextPage for all " "subsequent extractions and text searches will then happen with " "|PyMuPDF|'s usual top speed." msgstr "광학 문자 인식은 표준 텍스트 추출보다 약 1,000배 느리기 때문에, 페이지당 한 번만 OCR을 수행하고 결과를 :ref:`TextPage` 에 저장합니다. 이후 모든 추출 및 텍스트 검색에 이 TextPage를 사용하면 |PyMuPDF| 의 일반적인 최고 속도로 처리됩니다." #: ../../recipes-ocr.rst:47 96c380b987f94acbbfb8ac4450e43dce msgid "To OCR a document page, follow this approach:" msgstr "문서 페이지를 OCR하려면 다음 방법을 따르세요:" #: ../../recipes-ocr.rst:49 39681da9450c49058ca2763173465812 msgid "" "Determine whether OCR is needed / beneficial at all. A number of criteria" " can be used for this decision, like:" msgstr "OCR이 필요한지/유익한지 판단하세요. 다음과 같은 여러 기준을 사용할 수 있습니다:" #: ../../recipes-ocr.rst:51 671903164c6c495da5a353e4d7e1a112 msgid "page is completely covered by an image" msgstr "페이지가 이미지로 완전히 덮여 있음" #: ../../recipes-ocr.rst:52 67a0e6d81030439db6adb2f9c61737d4 msgid "no text exists on the page" msgstr "페이지에 텍스트가 없음" #: ../../recipes-ocr.rst:53 95a2141830a64bd6b31d96005eb2207b msgid "thousands of small vector graphics (indicating *simulated* text)" msgstr "수천 개의 작은 벡터 그래픽(*시뮬레이션된* 텍스트를 나타냄)" #: ../../recipes-ocr.rst:55 a56ae19e7c8a4d0bb37016395d9ab63c msgid "" "OCR the page and store result in a :ref:`TextPage` object using an " "instruction like `tp = page.get_textpage_ocr(...)`." msgstr "`tp = page.get_textpage_ocr(...)` 와 같은 명령을 사용하여 페이지를 OCR하고 결과를 :ref:`TextPage` 객체에 저장합니다." #: ../../recipes-ocr.rst:57 4e0d85d010b04df58a9c1169c5d8b553 msgid "" "Refer to the produced :ref:`TextPage` in all subsequent text extractions " "and searches via the `textpage=tp` parameter." msgstr "이후 모든 텍스트 추출 및 검색에서 `textpage=tp` 매개변수를 통해 생성된 :ref:`TextPage` 를 참조하세요." #: ../../footer.rst:46 1536d96897a04a48b4b90ead47380207 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-optional-content.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 f427b4b5c89c434aa431d0105a3b4ced msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 25ffbcd722b944a087a274a8e9d2f119 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 29a19d98cec64f3488930f81e11e93e7 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-optional-content.rst:7 700c319fd483491eb9c651ce164689cf msgid "Optional Content Support" msgstr "선택적 콘텐츠 지원" #: ../../recipes-optional-content.rst:9 5ecf5ebcfe42415bb96d754f39769237 msgid "" "This document explains PyMuPDF's support of the PDF concept **\"Optional " "Content\"**." msgstr "이 문서는 |PyMuPDF| 가 지원하는 PDF 개념 **\"선택적 콘텐츠\"** 에 대해 설명합니다." #: ../../recipes-optional-content.rst:12 2d6ce70234fa4a51b645e6eb697c23c1 msgid "Introduction: The Optional Content Concept" msgstr "소개: 선택적 콘텐츠 개념" #: ../../recipes-optional-content.rst:13 a1bba7af8cee41cabc8aa14f83c25097 msgid "" "*Optional Content* in PDF is a way to show or hide parts of a document " "based on certain conditions: Parameters that can be set to ON or to OFF " "when using a supporting PDF consumer (viewer), or programmatically." msgstr "PDF의 *선택적 콘텐츠* 는 특정 조건에 따라 문서의 일부를 표시하거나 숨기는 방법입니다. 지원하는 PDF 소비자(뷰어)를 사용할 때 또는 프로그래밍 방식으로 ON 또는 OFF로 설정할 수 있는 매개변수입니다." #: ../../recipes-optional-content.rst:15 cab765ef09a444c5baccc6ecba041e6e msgid "" "This capability is useful in items such as CAD drawings, layered artwork," " maps, and multi-language documents. Typical uses include showing or " "hiding details of complex vector graphics like geographical maps, " "technical devices, architectural designs and similar, including " "automatically switching between different zooming levels. Other use cases" " may be to automatically show different detail levels when displaying a " "document on screen as opposed to printing it." msgstr "이 기능은 CAD 도면, 레이어 아트워크, 지도, 다국어 문서와 같은 항목에서 유용합니다. 일반적인 용도에는 지리적 지도, 기술 장치, 건축 설계 등과 같은 복잡한 벡터 그래픽의 세부 정보 표시 또는 숨기기, 다양한 확대/축소 수준 간의 자동 전환이 포함됩니다. 다른 사용 사례는 문서를 인쇄하는 것과 달리 화면에 표시할 때 자동으로 다른 세부 수준을 표시하는 것일 수 있습니다." #: ../../recipes-optional-content.rst:17 a3cf8bb5edc04658bcc5b018e1302847 msgid "" "Special PDF objects, so-called **Optional Content Groups** (OCGs) are " "used to define these different *layers* of content." msgstr "특수 PDF 객체인 **선택적 콘텐츠 그룹** (OCG)을 사용하여 이러한 다양한 콘텐츠 *레이어* 를 정의합니다." #: ../../recipes-optional-content.rst:19 11067de9260f444189d97ae6ae624654 msgid "" "Assigning an OCG to a \"normal\" PDF object (like a text or an image) " "causes that object to be visible or hidden, depending on the current " "state of the assigned OCG." msgstr "OCG를 \"일반\" PDF 객체(텍스트 또는 이미지 등)에 할당하면 할당된 OCG의 현재 상태에 따라 해당 객체가 표시되거나 숨겨집니다." #: ../../recipes-optional-content.rst:21 95e830e21e764c0a949cb7ed0a33fc95 msgid "" "To ease definition of the overall configuration of a PDF's Optional " "Content, OCGs can be organized in higher level groupings, called **OC " "Configurations**. Each configuration being a collection of OCGs, together" " with each OCG's desired initial visibility state. Selecting one of these" " configurations (via the PDF viewer or programmatically) causes a " "corresponding visibility change of all affected PDF objects throughout " "the document." msgstr "PDF의 선택적 콘텐츠 전체 구성을 쉽게 정의하기 위해 OCG는 **OC 구성** 이라는 상위 수준 그룹으로 구성할 수 있습니다. 각 구성은 각 OCG의 원하는 초기 표시 상태와 함께 OCG 컬렉션입니다. 이러한 구성 중 하나를 선택하면(PDF 뷰어를 통해 또는 프로그래밍 방식으로) 문서 전체에서 영향을 받는 모든 PDF 객체의 표시 상태가 해당 상태로 변경됩니다." #: ../../recipes-optional-content.rst:23 b707fd22852842e89a0e8e78a296ef39 msgid "Except for the default one, OC Configurations are optional." msgstr "기본 구성 외에는 OC 구성은 선택 사항입니다." #: ../../recipes-optional-content.rst:25 0844d7f44e964e409fefe8c054f52b6d msgid "" "For more explanations and additional background please refer to PDF " "specification manuals." msgstr "자세한 설명과 추가 배경 정보는 PDF 사양 매뉴얼을 참조하세요." #: ../../recipes-optional-content.rst:28 6133510bc73140a4b17bbf8cda929189 msgid "PyMuPDF Support for PDF Optional Content" msgstr "PDF 선택적 콘텐츠에 대한 |PyMuPDF| 지원" #: ../../recipes-optional-content.rst:29 ee3f36d2819e41d2aeabc811bdfcddb2 msgid "" "PyMuPDF offers full support for viewing, defining, changing and deleting " "Option Content Groups, Configurations, maintaining the assignment of OCGs" " to PDF objects and programmatically switching between OC Configurations " "and the visibility states of each single OCG." msgstr "|PyMuPDF| 는 선택적 콘텐츠 그룹 및 구성의 보기, 정의, 변경, 삭제, OCG를 PDF 객체에 할당하는 것의 유지, OC 구성 간의 프로그래밍 방식 전환 및 각 단일 OCG의 표시 상태에 대한 완전한 지원을 제공합니다." #: ../../recipes-optional-content.rst:32 6c810e8459dd45b499132c9ef8a2ec30 msgid "How to Add Optional Content" msgstr "선택적 콘텐츠 추가 방법" #: ../../recipes-optional-content.rst:33 ddc6af20e120444c8d6bcbef96f4ab41 msgid "" "This is as simple as adding an Optional Content Group, OCG, to a PDF: " ":meth:`Document.add_ocg`." msgstr "PDF에 선택적 콘텐츠 그룹(OCG)을 추가하는 것만큼 간단합니다: :meth:`Document.add_ocg`." #: ../../recipes-optional-content.rst:35 247da2498372479cbcf5c1e211c93b70 msgid "" "If previously the PDF had no OC support at all, the required setup (like " "defining the default OC Configuration) will be done at this point " "automatically." msgstr "이전에 PDF에 OC 지원이 전혀 없었다면, 필요한 설정(기본 OC 구성 정의 등)이 이 시점에서 자동으로 수행됩니다." #: ../../recipes-optional-content.rst:37 f3673e60584d40d08730a4d5183a4393 msgid "" "The method returns an :data:`xref` of the created OCG. Use this xref to " "associate (mark) any PDF object with it, that you want to make dependent " "on this OCG's state. For example, you can insert an image on a page and " "refer to the xref like this::" msgstr "이 메서드는 생성된 OCG의 :data:`xref` 를 반환합니다. 이 xref를 사용하여 이 OCG의 상태에 종속되도록 만들고자 하는 모든 PDF 객체를 연결(표시)합니다. 예를 들어, 페이지에 이미지를 삽입하고 다음과 같이 xref를 참조할 수 있습니다::" #: ../../recipes-optional-content.rst:41 f4a0a4f56cf343ce93de964daa847414 msgid "" "If you want to put an **existing** image under the control of an OCG, you" " must first find out the image's xref number (called `img_xref` here) and" " then do `doc.set_oc(img_xref, xref)`. After this, the image will be " "(in-) visible everywhere throughout the document if the OCG's state is " "\"ON\", respectively \"OFF\". You can also assign a different OCG with " "this method." msgstr "**기존** 이미지를 OCG의 제어 하에 두려면 먼저 이미지의 xref 번호(여기서는 `img_xref` 라고 함)를 찾은 다음 `doc.set_oc(img_xref, xref)` 를 수행해야 합니다. 그 후 OCG의 상태가 \"ON\" 또는 \"OFF\"이면 이미지는 문서 전체에서 (비)표시됩니다. 이 메서드를 사용하여 다른 OCG를 할당할 수도 있습니다." #: ../../recipes-optional-content.rst:43 876cc7ea11954c498741a87e7e7f2e81 msgid "To **remove** an OCG from an image, do `doc.set_oc(img_xref, 0)`." msgstr "이미지에서 OCG를 **제거** 하려면 `doc.set_oc(img_xref, 0)` 를 수행하세요." #: ../../recipes-optional-content.rst:45 148754aebd804196a3832628dcd22df6 msgid "" "One single OCG can be assigned to multiple PDF objects to control their " "visibility." msgstr "단일 OCG를 여러 PDF 객체에 할당하여 표시 여부를 제어할 수 있습니다." #: ../../recipes-optional-content.rst:48 654180253edf46a797c215677cb22eba msgid "How to Define Complex Optional Content Conditions" msgstr "복잡한 선택적 콘텐츠 조건 정의 방법" #: ../../recipes-optional-content.rst:50 be5af920b1f64a559cac7f324ea6f913 msgid "" "Sophisticated logical conditions can be established to address complex " "visibility needs." msgstr "복잡한 표시 요구사항을 해결하기 위해 정교한 논리 조건을 설정할 수 있습니다." #: ../../recipes-optional-content.rst:52 78345b4a7695447a871af9b3d7dc1352 msgid "" "For example, you might want to create a multi-language document, so the " "user may switch between languages as required." msgstr "예를 들어, 사용자가 필요에 따라 언어를 전환할 수 있도록 다국어 문서를 만들 수 있습니다." #: ../../recipes-optional-content.rst:54 2975f48b256e4d7f954291ed0f71b2e4 msgid "Please have a look at `this Jupyter Notebook`_ and execute it as desired." msgstr "`이 Jupyter Notebook`_ 을 확인하고 원하는 대로 실행하세요." #: ../../recipes-optional-content.rst:56 5a66d6db462b491488acb6e94488a590 msgid "" "Certainly, your requirements may even be more complex and involve " "multiple OCGs with ON/OFF states that are connected by some kind of " "logical relationship -- but it should give you an impression of what is " "possible and how to plan your next steps." msgstr "물론 요구사항이 더 복잡할 수 있으며 논리적 관계로 연결된 여러 ON/OFF 상태의 OCG를 포함할 수 있지만, 가능한 것과 다음 단계를 계획하는 방법에 대한 인상을 제공해야 합니다." #: ../../footer.rst:46 348e850342ec47b1a57c9045cb6713c3 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-stories.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b5d193bc1b274d55b812ca653ec68fad msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 2bc267634e2a46b2a13b54c6aadda8c0 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 1629ae10629c4c9fbbd1776a5b603010 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-stories.rst:18 8314345d0647437d82e4ab3dfd98d5d1 msgid "Stories" msgstr "Stories" #: ../../recipes-stories.rst:20 595796cef87c4b7ab7031798c86047a5 msgid "" "This document showcases some typical use cases for " ":ref:`Stories`." msgstr "이 문서는 :ref:`Stories` 의 일반적인 사용 사례를 보여줍니다." #: ../../recipes-stories.rst:22 995d0e959c2c43259e09def294ea1759 msgid "" "As mentioned in the :ref:`tutorial`, stories may be " "created using up to three input sources: HTML, CSS and Archives -- all of" " which are optional and which, respectively, can be provided " "programmatically." msgstr ":ref:`튜토리얼` 에서 언급한 대로, 스토리는 최대 세 가지 입력 소스(HTML, CSS 및 Archives)를 사용하여 생성할 수 있습니다. 모두 선택 사항이며 각각 프로그래밍 방식으로 제공할 수 있습니다." #: ../../recipes-stories.rst:24 f48c55a3c4bd4c2f81e39c6ed5117f22 msgid "The following examples will showcase combinations for using these inputs." msgstr "다음 예제는 이러한 입력을 사용하는 조합을 보여줍니다." #: ../../recipes-stories.rst:28 f931abd31c8f473b8a30402b72d2037a msgid "" "Many of these recipe's source code are included as examples in the `docs`" " folder." msgstr "이러한 레시피의 많은 소스 코드가 `docs` 폴더의 예제로 포함되어 있습니다." #: ../../recipes-stories.rst:34 052173f8f2be4dc9938bc267e8d774b8 msgid "How to Add a Line of Text with Some Formatting" msgstr "일부 서식이 있는 텍스트 줄 추가 방법" #: ../../recipes-stories.rst:36 eeb1b6e720474b3ba8158d228da8e939 msgid "Here is the inevitable \"Hello World\" example. We will show two variants:" msgstr "다음은 필수적인 \"Hello World\" 예제입니다. 두 가지 변형을 보여드리겠습니다:" #: ../../recipes-stories.rst:38 c71486f3b5194a389a39bbe61b8a3dd8 msgid "Create using existing HTML source [#f1]_, that may come from anywhere." msgstr "어디서든 올 수 있는 기존 HTML 소스 [#f1]_를 사용하여 생성합니다." #: ../../recipes-stories.rst:39 3477752d744d4d17972620ffab3621ae msgid "Create using the Python API." msgstr "Python API를 사용하여 생성합니다." #: ../../recipes-stories.rst:43 a4855e116ed84da28c0c7f0adb1ba452 msgid "" "Variant using an existing HTML source [#f1]_ -- which in this case is " "defined as a constant in the script::" msgstr "기존 HTML 소스 [#f1]_를 사용하는 변형 -- 이 경우 스크립트에서 상수로 정의됩니다::" #: ../../recipes-stories.rst:69 54989c4eb624422c9343633c849a172d msgid "" "The above effect (sans-serif and blue text) could have been achieved by " "using a separate CSS source like so::" msgstr "위의 효과(산세리프 및 파란색 텍스트)는 다음과 같이 별도의 CSS 소스를 사용하여 달성할 수 있었습니다::" #: ../../recipes-stories.rst:90 d640d05290e44092bef652b25473bfae msgid "The Python API variant -- everything is created programmatically::" msgstr "Python API 변형 -- 모든 것이 프로그래밍 방식으로 생성됩니다::" #: ../../recipes-stories.rst:114 8e4d50be827247b7974656d7de688f75 msgid "Both variants will produce the same output PDF." msgstr "두 변형 모두 동일한 출력 PDF를 생성합니다." #: ../../recipes-stories.rst:122 069e5a16feed4b3ba04b7f545ff25868 msgid "How to use Images" msgstr "이미지 사용 방법" #: ../../recipes-stories.rst:124 d14be063cc6f47e89f14211f41113abb msgid "" "Images can be referenced in the provided HTML source, or the reference to" " a desired image can also be stored via the Python API. In any case, this" " requires using an :ref:`Archive`, which refers to the place where the " "image can be found." msgstr "" "이미지는 제공된 HTML 소스에서 참조할 수 있거나, 원하는 이미지에 대한 참조를 Python API를 통해 저장할 수도 " "있습니다. 어떤 경우든 이미지를 찾을 수 있는 위치를 가리키는 :ref:`Archive` 를 사용해야 합니다." #: ../../recipes-stories.rst:126 097753bc282141dc9c12d4462a635a6a msgid "" "Images with the binary content embedded in the HTML source are **not " "supported** by stories." msgstr "HTML 소스에 바이너리 콘텐츠가 포함된 이미지는 스토리에서 **지원되지 않습니다**." #: ../../recipes-stories.rst:128 5325dfa364c947ee83aa589fc95cff1e msgid "" "We extend our \"Hello World\" example from above and display an image of " "our planet right after the text. Assuming the image has the name " "\"world.jpg\" and is present in the script's folder, then this is the " "modified version of the above Python API variant::" msgstr "" "위의 \"Hello World\" 예제를 확장하여 텍스트 바로 다음에 지구 이미지를 표시합니다. 이미지 이름이 " "\"world.jpg\"이고 스크립트 폴더에 있다고 가정하면, 다음은 위의 Python API 변형의 수정된 버전입니다::" #: ../../recipes-stories.rst:168 615eea37135744afb2f7306c69fcfa53 msgid "How to Read External HTML and CSS for a Story" msgstr "스토리를 위한 외부 HTML 및 CSS 읽기 방법" #: ../../recipes-stories.rst:170 3e62969f6ef34607a59289d3c5a2b616 msgid "These cases are fairly straightforward." msgstr "이러한 경우는 매우 간단합니다." #: ../../recipes-stories.rst:172 9e79a62cf0f8448594719c149f421fe4 msgid "" "As a general recommendation, HTML and CSS sources should be **read as " "binary files** and decoded before using them in a story. The Python " "`pathlib.Path` provides convenient ways to do this::" msgstr "" "일반적인 권장 사항으로, HTML 및 CSS 소스는 **바이너리 파일로 읽어서** 스토리에서 사용하기 전에 디코딩해야 합니다. " "Python `pathlib.Path` 는 이를 수행하는 편리한 방법을 제공합니다::" #: ../../recipes-stories.rst:193 424a5680167f4243bfdae2bc11a6a865 msgid "How to Output Database Content with Story Templates" msgstr "스토리 템플릿으로 데이터베이스 콘텐츠 출력 방법" #: ../../recipes-stories.rst:195 75230534b810462489a2c0543f108196 msgid "" "This script demonstrates how to report SQL database content using an " "**HTML template**." msgstr "이 스크립트는 **HTML 템플릿** 을 사용하여 SQL 데이터베이스 콘텐츠를 보고하는 방법을 보여줍니다." #: ../../recipes-stories.rst:199 573a4db0337c431ba12822e512233a72 msgid "The example SQL database contains two tables:" msgstr "예제 SQL 데이터베이스에는 두 개의 테이블이 포함되어 있습니다:" #: ../../recipes-stories.rst:201 d12453e5387d4c86aef125b1c917cdc5 msgid "" "Table \"films\" contains one row per film with the fields **\"title\"**, " "**\"director\"** and (release) **\"year\"**." msgstr "" "테이블 \"films\" 는 필드 **\"title\"**, **\"director\"** 및 (개봉) **\"year\"** 가 있는 영화당 " "하나의 행을 포함합니다." #: ../../recipes-stories.rst:202 48c7c2781fa04d22ad47bdd68f0e7430 msgid "" "Table \"actors\" contains one row per actor and film title (fields " "(actor) **\"name\"** and (film) **\"title\"**)." msgstr "" "테이블 \"actors\" 는 배우 및 영화 제목당 하나의 행을 포함합니다(필드 (actor) **\"name\"** 및 (film) " "**\"title\"**)." #: ../../recipes-stories.rst:204 29aa52738ef94cbfb71a5e58eb4207f9 msgid "" "The story DOM consists of a template for one film, which reports film " "data together with a list of casted actors." msgstr "스토리 DOM은 하나의 영화에 대한 템플릿으로 구성되며, 영화 데이터와 출연 배우 목록을 함께 보고합니다." #: ../../recipes-stories.rst:206 ../../recipes-stories.rst:231 #: ../../recipes-stories.rst:257 ../../recipes-stories.rst:309 #: ../../recipes-stories.rst:343 ../../recipes-stories.rst:377 #: ../../recipes-stories.rst:398 ../../recipes-stories.rst:433 #: ../../recipes-stories.rst:467 ../../recipes-stories.rst:497 #: ../../recipes-stories.rst:531 08c1a4e126cb48978f4f6d8d01328a9d #: 1f86ef58d3744dc6b95fcda088603493 252df0b354254037b866b630e74e2da8 #: 4e6c2eefb4e04eb1af7f436651caf09b 703c6ee5dcb04da88e0551d3b09617ad #: 7ab440172c9b492d83a77e8c6b3a5ce3 7e9d0135ecac455194beff5db8e97383 #: c3d8138b12a64495b66fc448295bdf87 d783b1de9b01428d87a0f12d8bc86213 #: e6786c9897324e95a0694f81946c35c6 f4a5a290b11645758f555fb83ad91ec4 msgid "**Files:**" msgstr "**파일:**" #: ../../recipes-stories.rst:208 76f13a564fe44af38d30607e6903e0e8 msgid "`docs/samples/filmfestival-sql.py`" msgstr "" #: ../../recipes-stories.rst:209 0011f520db504866869f4fc79f37465a msgid "`docs/samples/filmfestival-sql.db`" msgstr "" #: ../../recipes-stories.rst:212 ../../recipes-stories.rst:235 #: ../../recipes-stories.rst:263 ../../recipes-stories.rst:316 #: ../../recipes-stories.rst:347 ../../recipes-stories.rst:360 #: ../../recipes-stories.rst:381 ../../recipes-stories.rst:402 #: ../../recipes-stories.rst:437 ../../recipes-stories.rst:471 #: ../../recipes-stories.rst:501 ../../recipes-stories.rst:535 #: 1d8920d6cfac4577be9b37a82329452a 278a24defbbf496193211fdfb1c2a54a #: 40ab396528814a3fac246a5a00c34f65 5723b2a904ba47b9860b557379721ae1 #: 9707ab332af04a1a9cb72a3ab89fffd3 9ea47fe98a8844ffaf1223a3e33e1bb8 #: ae83566d84a2413980f2a252c0940048 be88afb45b4948b18b486920f53daf2e #: c004e3f49ac3466c8c9ef9888157f02d c942e3a7452248f58a5bddc23570027c #: f3dbc504b00e4947ac703f22b8109786 f8ece455a9d6481eae9b3f6faac7ac53 msgid "|toggleStart|" msgstr "" #: ../../recipes-stories.rst:216 ../../recipes-stories.rst:239 #: ../../recipes-stories.rst:267 ../../recipes-stories.rst:320 #: ../../recipes-stories.rst:351 ../../recipes-stories.rst:364 #: ../../recipes-stories.rst:385 ../../recipes-stories.rst:406 #: ../../recipes-stories.rst:441 ../../recipes-stories.rst:475 #: ../../recipes-stories.rst:505 ../../recipes-stories.rst:539 #: 092f94a8817948c8abafc3734fcf198b 4a98f729722249cd982f858648efc237 #: 62d1782a6ea04c2db57ab1ee0ca4fe5f 8ba4cffc6b654792918dc7b1dd969a30 #: 8c53e41912464fc1be6bbe4c83f4028f 9ddbc2dae3a649e1ba30b92fc174fbe4 #: caf97ca2ef514514bc825397ac3bf0d9 e3ff13ae3b40495fabcf13c543af9d12 #: eaf1260e02b949b79eed85f34153be91 ec1850ab1501425c8a0bd816f0817878 #: ef3d65dc1872490f8de2efc2cc2a90b2 fef63adfa7c341ffbbf5c7407c27a06f msgid "|toggleEnd|" msgstr "" #: ../../recipes-stories.rst:225 18a13135616545bfad20fd11639e4c84 msgid "How to Integrate with Existing PDFs" msgstr "기존 PDF와 통합하는 방법" #: ../../recipes-stories.rst:227 f03491738dc64176a90468adac627ab0 msgid "" "Because a :ref:`DocumentWriter` can only write to a new file, stories " "cannot be placed on existing pages. This script demonstrates a " "circumvention of this restriction." msgstr "" ":ref:`DocumentWriter` 는 새 파일에만 쓸 수 있으므로 스토리는 기존 페이지에 배치할 수 없습니다. 이 스크립트는 " "이 제한을 우회하는 방법을 보여줍니다." #: ../../recipes-stories.rst:229 96c37297327d48c0bd3a2b2e00278cee msgid "" "The basic idea is letting :ref:`DocumentWriter` output to a PDF in " "memory. Once the story has finished, we re-open this memory PDF and put " "its pages to desired locations on **existing** pages via method " ":meth:`Page.show_pdf_page`." msgstr "" "기본 아이디어는 :ref:`DocumentWriter` 가 메모리의 PDF에 출력하도록 하는 것입니다. 스토리가 완료되면 이 메모리 " "PDF를 다시 열고 :meth:`Page.show_pdf_page` 메서드를 통해 **기존** 페이지의 원하는 위치에 페이지를 " "배치합니다." #: ../../recipes-stories.rst:233 4f5ee88727ea49c296c840ca51c75e45 msgid "`docs/samples/showpdf-page.py`" msgstr "" #: ../../recipes-stories.rst:248 563332f15b53462da0c68cde0c1beb09 msgid "" "How to Make Multi-Columned Layouts and Access Fonts from Package " "`pymupdf-fonts`_" msgstr "다단 레이아웃 만들기 및 패키지 `pymupdf-fonts`_ 에서 폰트 액세스 방법" #: ../../recipes-stories.rst:250 c67e2e9e13c4449cb12ec6a84c9d23ea msgid "" "This script outputs an article (taken from Wikipedia) that contains text " "and multiple images and uses a 2-column page layout." msgstr "이 스크립트는 텍스트와 여러 이미지를 포함하는 기사(Wikipedia에서 가져옴)를 출력하며 2단 페이지 레이아웃을 사용합니다." #: ../../recipes-stories.rst:252 e5c809facc4047608e51c439efe8f7a6 msgid "" "In addition, two \"Ubuntu\" font families from package `pymupdf-fonts`_ " "are used instead of defaulting to Base-14 fonts." msgstr "" "또한 패키지 `pymupdf-fonts`_ 에서 두 개의 \"Ubuntu\" 폰트 패밀리가 Base-14 폰트를 기본값으로 사용하는 대신 " "사용됩니다." #: ../../recipes-stories.rst:254 710ea657eaed417790c2b2e1408ff46a msgid "" "Yet another feature used here is that all data -- the images and the " "article HTML -- are jointly stored in a ZIP file." msgstr "여기서 사용되는 또 다른 기능은 모든 데이터(이미지 및 기사 HTML)가 ZIP 파일에 함께 저장된다는 것입니다." #: ../../recipes-stories.rst:259 baca45cc5cea40718096fd055c4c6f29 msgid "`docs/samples/quickfox.py`" msgstr "" #: ../../recipes-stories.rst:260 ../../recipes-stories.rst:313 #: 279ba9d3da96462d9521b6401f261ffc 79489cda481541c5af08712bcd696dcf msgid "`docs/samples/quickfox.zip`" msgstr "" #: ../../recipes-stories.rst:276 0f2bd834af8f474bb16581d5edd338b8 msgid "How to Make a Layout which Wraps Around a Predefined \"no go area\" Layout" msgstr "사전 정의된 \"금지 영역\" 레이아웃 주위로 감싸는 레이아웃 만들기 방법" #: ../../recipes-stories.rst:279 dbd26e7d6a2f4abaa6462e796a1208bb msgid "" "This is a demo script using PyMuPDF's Story class to output text as a PDF" " with a two-column page layout." msgstr "이것은 |PyMuPDF| 의 Story 클래스를 사용하여 텍스트를 2단 페이지 레이아웃으로 PDF로 출력하는 데모 스크립트입니다." #: ../../recipes-stories.rst:282 2eb13f3738a8491b97fe654a99f8ce3a msgid "The script demonstrates the following features:" msgstr "스크립트는 다음 기능을 보여줍니다:" #: ../../recipes-stories.rst:284 25765b0dd11a43508066ab08e902d66f msgid "Layout text around images of an existing (\"target\") PDF." msgstr "기존(\"대상\") PDF의 이미지 주위에 텍스트 레이아웃." #: ../../recipes-stories.rst:285 e472244ac7ad455690ffc3c6049d7bc3 msgid "" "Based on a few global parameters, areas on each page are identified, that" " can be used to receive text layouted by a Story." msgstr "몇 가지 전역 매개변수를 기반으로 각 페이지의 영역이 식별되며, 이 영역은 Story에 의해 레이아웃된 텍스트를 받는 데 사용할 수 있습니다." #: ../../recipes-stories.rst:287 51459bb508b34fa1adb8a3b05cb25082 msgid "" "These global parameters are not stored anywhere in the target PDF and " "must therefore be provided in some way:" msgstr "이러한 전역 매개변수는 대상 PDF의 어디에도 저장되지 않으므로 어떤 방식으로든 제공되어야 합니다:" #: ../../recipes-stories.rst:290 9c4f7ed7210f4d129f08fc68b1449c1b msgid "The width of the border(s) on each page." msgstr "각 페이지의 테두리 너비." #: ../../recipes-stories.rst:291 2adfda4cd7994235b17faaaa456c4645 msgid "" "The fontsize to use for text. This value determines whether the provided " "text will fit in the empty spaces of the (fixed) pages of target PDF. It " "cannot be predicted in any way. The script ends with an exception if " "target PDF has not enough pages, and prints a warning message if not all " "pages receive at least some text. In both cases, the FONTSIZE value can " "be changed (a float value)." msgstr "" "텍스트에 사용할 글꼴 크기. 이 값은 제공된 텍스트가 대상 PDF의 (고정된) 페이지의 빈 공간에 맞는지 여부를 결정합니다. 어떤 " "방식으로도 예측할 수 없습니다. 대상 PDF에 페이지가 충분하지 않으면 스크립트는 예외로 종료되고, 모든 페이지가 최소한 일부 텍스트를 " "받지 못하면 경고 메시지를 인쇄합니다. 두 경우 모두 FONTSIZE 값을 변경할 수 있습니다(부동 소수점 값)." #: ../../recipes-stories.rst:297 ef8d9dc888f04ea18e29d8deec8eebc7 msgid "Use of a 2-column page layout for the text." msgstr "텍스트에 2단 페이지 레이아웃 사용." #: ../../recipes-stories.rst:298 0dc84c7986d740dea5c0d99ee3cd5965 msgid "" "The layout creates a temporary (memory) PDF. Its produced page content " "(the text) is used to overlay the corresponding target page. If text " "requires more pages than are available in target PDF, an exception is " "raised. If not all target pages receive at least some text, a warning is " "printed." msgstr "" "레이아웃은 임시(메모리) PDF를 생성합니다. 생성된 페이지 콘텐츠(텍스트)는 해당 대상 페이지에 오버레이하는 데 사용됩니다. 텍스트가 " "대상 PDF에서 사용 가능한 페이지보다 더 많은 페이지를 필요로 하면 예외가 발생합니다. 모든 대상 페이지가 최소한 일부 텍스트를 받지 " "못하면 경고가 인쇄됩니다." #: ../../recipes-stories.rst:302 76e3c6f16fca4501a3d6b09051f5c6fc msgid "" "The script reads \"image-no-go.pdf\" in its own folder. This is the " "\"target\" PDF. It contains 2 pages with each 2 images (from the original" " article), which are positioned at places that create a broad overall " "test coverage. Otherwise the pages are empty." msgstr "" "스크립트는 자체 폴더에서 \"image-no-go.pdf\" 를 읽습니다. 이것이 \"대상\" PDF입니다. 원본 기사에서 각각 2개의 " "이미지가 있는 2페이지를 포함하며, 광범위한 전체 테스트 커버리지를 만드는 위치에 배치됩니다. 그렇지 않으면 페이지가 비어 있습니다." #: ../../recipes-stories.rst:306 5feb7616d6454982b6c9c0803bed70ec msgid "" "The script produces \"quickfox-image-no-go.pdf\" which contains the " "original pages and image positions, but with the original article text " "laid out around them." msgstr "" "스크립트는 원본 페이지와 이미지 위치를 포함하지만 원본 기사 텍스트가 그 주위에 배치된 \"quickfox-image-no-go.pdf\" " "를 생성합니다." #: ../../recipes-stories.rst:311 2d87632d8f7d4b999f854a81b2e80541 msgid "`docs/samples/quickfox-image-no-go.py`" msgstr "" #: ../../recipes-stories.rst:312 cab8c8e6552e4a2f88203240822139a2 msgid "`docs/samples/quickfox-image-no-go.pdf`" msgstr "" #: ../../recipes-stories.rst:329 07ad707123e64f328f43969ff77a58f7 msgid "How to Output an HTML Table" msgstr "HTML 테이블 출력 방법" #: ../../recipes-stories.rst:331 6cd7587dab1f4b6aa7013a9ab05d5131 msgid "Outputting HTML tables is supported as follows:" msgstr "HTML 테이블 출력은 다음과 같이 지원됩니다:" #: ../../recipes-stories.rst:333 a094cc112239433e8f1c4e235bd1c1d7 msgid "" "Flat table layouts are supported (\"rows x columns\"), no support of the " "\"colspan\" / \"rowspan\" attributes." msgstr "평면 테이블 레이아웃(\"행 x 열\")이 지원되며, \"colspan\" / \"rowspan\" 속성은 지원되지 않습니다." #: ../../recipes-stories.rst:334 3e3366cef2bc44d29a1f557f36e98bd3 msgid "" "Table header tag :htmlTag:`th` supports attribute \"scope\" with values " "\"row\" or \"col\". Applicable text will be bold by default." msgstr "" "테이블 헤더 태그 :htmlTag:`th` 는 값이 \"row\" 또는 \"col\" 인 \"scope\" 속성을 지원합니다. 적용 가능한 " "텍스트는 기본적으로 굵게 표시됩니다." #: ../../recipes-stories.rst:335 533fc1b4bbf248e2b203786ae6c443b7 msgid "" "Column widths are computed automatically based on column content. They " "cannot be directly set." msgstr "열 너비는 열 콘텐츠를 기반으로 자동으로 계산됩니다. 직접 설정할 수 없습니다." #: ../../recipes-stories.rst:336 76c98b7342de4fd38e793274a40bfee5 msgid "" "Table **cells may contain images** which will be considered in the column" " width calculation magic." msgstr "테이블 **셀에 이미지가 포함될 수 있으며** 열 너비 계산에 고려됩니다." #: ../../recipes-stories.rst:337 2444753418ed48efbdaf659f55ebd3d9 msgid "" "Row heights are computed automatically based on row content - leading to " "multi-line rows where needed." msgstr "행 높이는 행 콘텐츠를 기반으로 자동으로 계산되어 필요한 경우 여러 줄 행이 생성됩니다." #: ../../recipes-stories.rst:338 c66ef7c08bce47369611cd47d34761ad msgid "" "The potentially multiple lines of a table row will always be kept " "together on one page (respectively \"where\" rectangle) and not be split." msgstr "" "테이블 행의 잠재적으로 여러 줄은 항상 한 페이지(각각 \"where\" 사각형)에 함께 유지되며 분할되지 않습니다." #: ../../recipes-stories.rst:339 88f98486ab714f12834b175e3270a938 msgid "" "Table header rows are only **shown on the first page / \"where\" " "rectangle.**" msgstr "테이블 헤더 행은 **첫 번째 페이지 / \"where\" 사각형에만 표시됩니다.**" #: ../../recipes-stories.rst:340 10bdfdc885fb4f9297afc239193cbda7 msgid "" "The \"style\" attribute is ignored when given directly in HTML table " "elements. Styling for a table and its elements must happen separately, in" " CSS source or within the :htmlTag:`style` tag." msgstr "" "\"style\" 속성은 HTML 테이블 요소에 직접 제공될 때 무시됩니다. 테이블과 그 요소의 스타일링은 CSS 소스 또는 " ":htmlTag:`style` 태그 내에서 별도로 수행해야 합니다." #: ../../recipes-stories.rst:341 482d5b34b15a4a9c9f4b7ece5d79a9ce msgid "" "Styling for :htmlTag:`tr` elements is not supported and ignored. " "Therefore, a table-wide grid or alternating row background colors are not" " supported. One of the following example scripts however shows an easy " "way to deal with this limitation." msgstr "" ":htmlTag:`tr` 요소의 스타일링은 지원되지 않으며 무시됩니다. 따라서 테이블 전체 그리드 또는 교대로 나타나는 행 배경색은 " "지원되지 않습니다. 그러나 다음 예제 스크립트 중 하나는 이 제한을 처리하는 쉬운 방법을 보여줍니다." #: ../../recipes-stories.rst:345 8345e9575f6844029b2999b8b6fed76f msgid "`docs/samples/table01.py` This script reflects basic features." msgstr "`docs/samples/table01.py` 이 스크립트는 기본 기능을 반영합니다." #: ../../recipes-stories.rst:353 e5188ccc429743cab9f17635eaab8002 msgid "" "`docs/samples/national-capitals.py` Advanced script extending table " "output options using simple additional code:" msgstr "`docs/samples/national-capitals.py` 간단한 추가 코드를 사용하여 테이블 출력 옵션을 확장하는 고급 스크립트:" #: ../../recipes-stories.rst:355 d786bb83c47a488a86e7603d731dac6b msgid "Multi-page output simulating **repeating header rows**" msgstr "**반복되는 헤더 행** 을 시뮬레이션하는 다중 페이지 출력" #: ../../recipes-stories.rst:356 64263c3cea7742dcafd285f9c1d9a690 msgid "Alternating table row background colors" msgstr "교대로 나타나는 테이블 행 배경색" #: ../../recipes-stories.rst:357 291f158657964fed93655aa568365aca msgid "Table rows and columns delimited by gridlines" msgstr "격자선으로 구분된 테이블 행과 열" #: ../../recipes-stories.rst:358 5f5af232f8f34e9f9f06b6bc48f9b935 msgid "Table rows dynamically generated / filled with data from an SQL database" msgstr "SQL 데이터베이스의 데이터로 동적으로 생성/채워진 테이블 행" #: ../../recipes-stories.rst:373 8de5b747eeee4c49a2ff9b5f6659192a msgid "How to Create a Simple Grid Layout" msgstr "간단한 그리드 레이아웃 만들기 방법" #: ../../recipes-stories.rst:375 2f9c6ef2b7224c718c51897ec71e2722 msgid "" "By creating a sequence of :ref:`Story` objects within a grid created via " "the :ref:`make_table` function a developer can " "create grid layouts as required." msgstr "" ":ref:`make_table` 함수를 통해 생성된 그리드 내에서 :ref:`Story` 객체의 시퀀스를 " "만들면 개발자는 필요에 따라 그리드 레이아웃을 만들 수 있습니다." #: ../../recipes-stories.rst:379 ef7f8c1036ed43a287e48b4719422ffd msgid "`docs/samples/simple-grid.py`" msgstr "" #: ../../recipes-stories.rst:394 d33c94d00852413d800e1a8cc6dce372 msgid "How to Generate a Table of Contents" msgstr "목차 생성 방법" #: ../../recipes-stories.rst:396 30c4a1111f18493d8276608dbce4e4cb msgid "" "This script lists the source code of all Python scripts that live in the " "script's directory." msgstr "이 스크립트는 스크립트 디렉토리에 있는 모든 Python 스크립트의 소스 코드를 나열합니다." #: ../../recipes-stories.rst:400 2b3106d169114915b35cfabdb62e4820 msgid "`docs/samples/code-printer.py`" msgstr "" #: ../../recipes-stories.rst:409 b512515de19446c1b6c1d11c09f1d286 msgid "It features the following capabilities:" msgstr "다음 기능을 제공합니다:" #: ../../recipes-stories.rst:411 d8bc94329c9d42799b70240e483a9535 msgid "" "Automatic generation of a Table of Contents (TOC) on separately numbered " "pages at the start of the document - using a specialized :ref:`Story`." msgstr "" "문서 시작 부분에 별도로 번호가 매겨진 페이지에 목차(TOC) 자동 생성 - 특수화된 :ref:`Story` 를 사용합니다." #: ../../recipes-stories.rst:413 1b625819dde2421ca9d1f8556c5b03cd msgid "" "Use of 3 separate :ref:`Story` objects per page: header story, footer " "story and the story for printing the Python sources." msgstr "" "페이지당 3개의 별도 :ref:`Story` 객체 사용: 헤더 스토리, 푸터 스토리 및 Python 소스 인쇄용 스토리." #: ../../recipes-stories.rst:415 ba47006f7ad743bab33a577e74e7dac7 msgid "" "The page **footer is automatically changed** to show the name of the " "current Python file." msgstr "페이지 **푸터가 자동으로 변경되어** 현재 Python 파일 이름을 표시합니다." #: ../../recipes-stories.rst:417 3723e3ea0ce3414c99483f90f6315678 msgid "" "Use of :meth:`Story.element_positions` to collect the data for the TOC " "and for the dynamic adjustment of page footers. This is an example of a " "**bidirectional communication** between the story output process and the " "script." msgstr "" ":meth:`Story.element_positions` 를 사용하여 TOC 데이터를 수집하고 페이지 푸터를 동적으로 조정합니다. 이것은 " "스토리 출력 프로세스와 스크립트 간의 **양방향 통신** 예제입니다." #: ../../recipes-stories.rst:419 5d56f451e2e44b589a69c8d6faa0dc16 msgid "" "The main PDF with the Python sources is being written to memory by its " ":ref:`DocumentWriter`. Another :ref:`Story` / :ref:`DocumentWriter` pair " "is then used to create a (memory) PDF for the TOC pages. Finally, both " "these PDFs are joined and the result stored to disk." msgstr "" "Python 소스가 포함된 메인 PDF는 :ref:`DocumentWriter` 에 의해 메모리에 기록됩니다. 그런 다음 다른 " ":ref:`Story` / :ref:`DocumentWriter` 쌍을 사용하여 TOC 페이지용 (메모리) PDF를 만듭니다. 마지막으로 " "이 두 PDF가 결합되어 결과가 디스크에 저장됩니다." #: ../../recipes-stories.rst:428 3e0fa770cc3b415fa27affd8b6659042 msgid "How to Display a List from JSON Data" msgstr "JSON 데이터에서 목록 표시 방법" #: ../../recipes-stories.rst:430 fc54ff1f63294ae3880c28ae96b73d3d msgid "" "This example takes some JSON data input which it uses to populate a " ":ref:`Story`. It also contains some visual text formatting and shows how " "to add links." msgstr "" "이 예제는 :ref:`Story` 를 채우는 데 사용하는 일부 JSON 데이터 입력을 가져옵니다. 또한 일부 시각적 텍스트 서식이 " "포함되어 있으며 링크를 추가하는 방법을 보여줍니다." #: ../../recipes-stories.rst:435 96d6b1d5632348d8a2d1a067ea7b5e30 msgid "`docs/samples/json-example.py`" msgstr "" #: ../../recipes-stories.rst:451 d389b54283c647c2aa18c6cac96e2679 msgid "Using the Alternative :meth:`Story.write*()` functions" msgstr "대체 :meth:`Story.write*()` 함수 사용" #: ../../recipes-stories.rst:453 97c0d297b7de4f52be883dd1fe9ec6da msgid "" "The :meth:`Story.write*()` functions provide a different way to use the " ":ref:`Story` functionality, removing the need for calling code to " "implement a loop that calls :meth:`Story.place()` and " ":meth:`Story.draw()` etc, at the expense of having to provide at least a " "`rectfn()` callback." msgstr "" ":meth:`Story.write*()` 함수는 :ref:`Story` 기능을 사용하는 다른 방법을 제공하여 호출 코드가 " ":meth:`Story.place()` 및 :meth:`Story.draw()` 등을 호출하는 루프를 구현할 필요를 제거하지만, 최소한 " "`rectfn()` 콜백을 제공해야 합니다." #: ../../recipes-stories.rst:462 c5a3507786364d729ce97e31af0be224 msgid "How to do Basic Layout with :meth:`Story.write()`" msgstr ":meth:`Story.write()` 로 기본 레이아웃 수행 방법" #: ../../recipes-stories.rst:464 d1aac41eb76d486c8b6ef2a9bf8c1862 msgid "" "This script lays out multiple copies of its own source code, into four " "rectangles per page." msgstr "이 스크립트는 자체 소스 코드의 여러 복사본을 페이지당 4개의 사각형으로 배치합니다." #: ../../recipes-stories.rst:469 0af6a8efdd4b4f829b827d3fdfe7b1a0 msgid "`docs/samples/story-write.py`" msgstr "" #: ../../recipes-stories.rst:484 022633dfece24abd830b877bb6eb3083 msgid "" "How to do Iterative Layout for a Table of Contents with " ":meth:`Story.write_stabilized()`" msgstr ":meth:`Story.write_stabilized()` 로 목차 반복 레이아웃 수행 방법" #: ../../recipes-stories.rst:486 cc0bf853cf404c9bbebe6a560eb9c1d7 msgid "" "This script creates html content dynamically, adding a contents section " "based on :ref:`ElementPosition` items that have non-zero `.heading` " "values." msgstr "" "이 스크립트는 HTML 콘텐츠를 동적으로 생성하며, 0이 아닌 `.heading` 값을 가진 :ref:`ElementPosition` 항목을 " "기반으로 목차 섹션을 추가합니다." #: ../../recipes-stories.rst:489 99707707c94744dda5a7c265feb53666 msgid "" "The contents section is at the start of the document, so modifications to" " the contents can change page numbers in the rest of the document, which " "in turn can cause page numbers in the contents section to be incorrect." msgstr "" "목차 섹션은 문서 시작 부분에 있으므로 목차에 대한 수정은 문서의 나머지 부분의 페이지 번호를 변경할 수 있으며, 이로 인해 목차 " "섹션의 페이지 번호가 잘못될 수 있습니다." #: ../../recipes-stories.rst:493 641abbf30eac459daee550983498c0d2 msgid "" "So the script uses :meth:`Story.write_stabilized()` to repeatedly lay " "things out until things are stable." msgstr "따라서 스크립트는 :meth:`Story.write_stabilized()` 를 사용하여 안정화될 때까지 반복적으로 레이아웃을 수행합니다." #: ../../recipes-stories.rst:499 3be99332904c4113a7541cd214abf180 msgid "`docs/samples/story-write-stabilized.py`" msgstr "" #: ../../recipes-stories.rst:514 524e644a3c994d5aa854cd8bddbe82d5 msgid "" "How to do Iterative Layout and Create PDF Links with " ":meth:`Story.write_stabilized_links()`" msgstr ":meth:`Story.write_stabilized_links()` 로 반복 레이아웃 및 PDF 링크 생성 방법" #: ../../recipes-stories.rst:516 ddff6a045e8d43fca2d9144a4d8433a4 msgid "" "This script is similar to the one described in \"How to use " ":meth:`Story.write_stabilized()`\" above, except that the generated PDF " "also contains links that correspond to the internal links in the original" " html." msgstr "" "이 스크립트는 위의 \":meth:`Story.write_stabilized()` 사용 방법\"에서 설명한 것과 유사하지만, 생성된 PDF에 " "원본 HTML의 내부 링크에 해당하는 링크도 포함됩니다." #: ../../recipes-stories.rst:520 b9678b083c9c4ba788c436e3d5e8c3fb msgid "" "This is done by using :meth:`Story.write_stabilized_links()`; this is " "slightly different from :meth:`Story.write_stabilized()`:" msgstr "" "이것은 :meth:`Story.write_stabilized_links()` 를 사용하여 수행됩니다. 이것은 " ":meth:`Story.write_stabilized()` 와 약간 다릅니다:" #: ../../recipes-stories.rst:523 31f9c57387284c839d1085d91cb625b2 msgid "It does not take a :ref:`DocumentWriter` `writer` arg." msgstr ":ref:`DocumentWriter` `writer` 인수를 사용하지 않습니다." #: ../../recipes-stories.rst:524 9c7bd5e90df443cdbe61b132c03467b2 msgid "It returns a PDF :ref:`Document` instance." msgstr "PDF :ref:`Document` 인스턴스를 반환합니다." #: ../../recipes-stories.rst:526 d8ba37b0defe4b7eb40aa17b6e2d8356 msgid "" "[The reasons for this are a little involved; for example a " ":ref:`DocumentWriter` is not necessarily a PDF writer, so doesn't really " "work in a PDF-specific API.]" msgstr "" "[이에 대한 이유는 약간 복잡합니다. 예를 들어 :ref:`DocumentWriter` 는 반드시 PDF 작성자가 아니므로 PDF 전용 " "API에서는 실제로 작동하지 않습니다.]" #: ../../recipes-stories.rst:533 bdb356f1c6e6499c9a9ed3fa8c0d6721 msgid "`docs/samples/story-write-stabilized-links.py`" msgstr "" #: ../../recipes-stories.rst:547 9b7cb4775a4e44f2881def8ce1ca8369 msgid "Footnotes" msgstr "각주" #: ../../recipes-stories.rst:548 9c133ed7af7a4415b60b9ed96ac04830 msgid "HTML & CSS support" msgstr "HTML 및 CSS 지원" #: ../../recipes-stories.rst:552 b1da3ee4c5a3436a8a6b46802918e564 msgid "" "At the time of writing the HTML engine for Stories is fairly basic and " "supports a subset of CSS2 attributes." msgstr "작성 시점에서 Stories의 HTML 엔진은 상당히 기본적이며 CSS2 속성의 하위 집합을 지원합니다." #: ../../recipes-stories.rst:554 01ac3d98abae4349b9b5c28d6a74755e msgid "Some important CSS support to consider:" msgstr "고려해야 할 중요한 CSS 지원:" #: ../../recipes-stories.rst:556 b91cde3adf67437fb80037c56700f274 msgid "The only available layout is relative layout." msgstr "사용 가능한 유일한 레이아웃은 상대 레이아웃입니다." #: ../../recipes-stories.rst:557 e4be54e31399436792c52c7fda0353d1 msgid "`background` is unavailable, use `background-color` instead." msgstr "`background` 는 사용할 수 없으며, 대신 `background-color` 를 사용하세요." #: ../../recipes-stories.rst:558 2e7a1ffef1e64856a8bac73062d1051f msgid "`float` is unavailable." msgstr "`float` 는 사용할 수 없습니다." #: ../../footer.rst:46 e3f4dcf0211e47ab91f9299fb7f43fd1 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes-text.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 aacd92b247384bf48857a075d285a561 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 dbeb3e790165465a99d5c54f8c3d8ead msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c0909ea966bf494c8da17ef86ca44a3b msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../recipes-text.rst:7 05ae1dd8d9f44a9481a79f9e3b1d86d7 msgid "Text" msgstr "Text" #: ../../recipes-text.rst:13 7caab8ee2fd2466083df37b5e33d293a msgid "How to Extract all Document Text" msgstr "모든 문서 텍스트 추출 방법" #: ../../recipes-text.rst:15 8c1e407daf5546229fd685147c64ce69 msgid "" "This script will take a document filename and generate a text file from " "all of its text." msgstr "이 스크립트는 문서 파일 이름을 받아 모든 텍스트에서 텍스트 파일을 생성합니다." #: ../../recipes-text.rst:17 32ad66847ecb4784aabbcd72e5132bcc msgid "The document can be any :ref:`supported type`." msgstr "문서는 :ref:`지원되는 모든 타입` 일 수 있습니다." #: ../../recipes-text.rst:19 81db58eeb7da49e8ac352d7290a9895b msgid "" "The script works as a command line tool which expects the document " "filename supplied as a parameter. It generates one text file named " "\"filename.txt\" in the script directory. Text of pages is separated by a" " form feed character::" msgstr "스크립트는 매개변수로 제공된 문서 파일 이름을 기대하는 명령줄 도구로 작동합니다. 스크립트 디렉토리에 \"filename.txt\"라는 하나의 텍스트 파일을 생성합니다. 페이지의 텍스트는 폼 피드 문자로 구분됩니다::" #: ../../recipes-text.rst:28 34acce45dea14d438a205400310b647d msgid "" "The output will be plain text as it is coded in the document. No effort " "is made to prettify in any way. Specifically for PDF, this may mean " "output not in usual reading order, unexpected line breaks and so forth." msgstr "출력은 문서에 코딩된 대로 일반 텍스트입니다. 어떤 방식으로도 예쁘게 만들려는 시도는 없습니다. 특히 PDF의 경우, 이것은 일반적인 읽기 순서가 아닌 출력, 예상치 못한 줄바꿈 등을 의미할 수 있습니다." #: ../../recipes-text.rst:30 d85615155c024325ba277a5ca1e1ccc0 msgid "" "You have many options to rectify this -- see chapter :ref:`Appendix2`. " "Among them are:" msgstr "이를 수정하는 많은 옵션이 있습니다 -- :ref:`Appendix2` 장을 참조하세요. 그 중에는 다음이 있습니다:" #: ../../recipes-text.rst:32 9f7a0c712a724bcb8f46594a0696a485 msgid "" "Extract text in HTML format and store it as a HTML document, so it can be" " viewed in any browser." msgstr "HTML 형식으로 텍스트를 추출하고 HTML 문서로 저장하여 모든 브라우저에서 볼 수 있도록 합니다." #: ../../recipes-text.rst:33 14d8db3ab4354b208d1b10a44164247a msgid "" "Extract text as a list of text blocks via *Page.get_text(\"blocks\")*. " "Each item of this list contains position information for its text, which " "can be used to establish a convenient reading order." msgstr "*Page.get_text(\"blocks\")* 를 통해 텍스트 블록 목록으로 텍스트를 추출합니다. 이 목록의 각 항목은 텍스트에 대한 위치 정보를 포함하며, 이를 사용하여 편리한 읽기 순서를 설정할 수 있습니다." #: ../../recipes-text.rst:34 a737dbb5f0df4394b85c682d11c5fbc7 msgid "" "Extract a list of single words via *Page.get_text(\"words\")*. Its items " "are words with position information. Use it to determine text contained " "in a given rectangle -- see next section." msgstr "*Page.get_text(\"words\")* 를 통해 단일 단어 목록을 추출합니다. 항목은 위치 정보가 있는 단어입니다. 주어진 사각형에 포함된 텍스트를 확인하는 데 사용하세요 -- 다음 섹션을 참조하세요." #: ../../recipes-text.rst:36 1eecb5d77eb545a89b29bbbe32c68b52 msgid "See the following two sections for examples and further explanations." msgstr "예제 및 추가 설명은 다음 두 섹션을 참조하세요." #: ../../recipes-text.rst:44 5d550fa30f214c0ab6daaa5da9d1d56b msgid "How to Extract Text as Markdown" msgstr "Markdown 형식으로 텍스트 추출 방법" #: ../../recipes-text.rst:46 3a0e63deebbf4416a1fea6b96c24774a msgid "" "This is especially useful for :title:`RAG/LLM` environments - please see " ":ref:`Outputting as Markdown `." msgstr "" "이는 특히 :title:`RAG/LLM` 환경에 유용합니다 - :ref:`Outputting as Markdown " "` 를 참조하세요." #: ../../recipes-text.rst:52 76343110228443c691bf59b95ab056c9 msgid "How to Extract Key-Value Pairs from a Page" msgstr "페이지에서 키-값 쌍 추출 방법" #: ../../recipes-text.rst:53 34f319f64a034da383333b8c516bb6fc msgid "" "If the layout of a page is *\"predictable\"* in some sense, then there is" " a simple way to find the values for a given set of keywords fast and " "easily -- without using regular expressions. Please see `this example " "script `_." msgstr "" "페이지 레이아웃이 어느 정도 *\"예측 가능한\"* 경우, 정규 표현식을 사용하지 않고도 특정 키워드 집합에 대한 값을 빠르고 쉽게 찾는 간단한 방법이 있습니다. `이 예제 스크립트 " "`_ 를 참조하세요." #: ../../recipes-text.rst:55 0b02d215083344e3bafc3ec057536e9f msgid "\"Predictable\" in this context means:" msgstr "여기서 \"예측 가능한\" 이란 다음을 의미합니다:" #: ../../recipes-text.rst:57 312afbe84baa4bdf84138e6f35377145 msgid "" "Every keyword is followed by its value -- no other text is present in " "between them." msgstr "각 키워드 뒤에는 그 값이 이어집니다 -- 그 사이에 다른 텍스트는 없습니다." #: ../../recipes-text.rst:58 fd6c255cc6164834b85534e21a47f8c3 msgid "" "The bottom of the value's boundary box is **not above** the one of the " "keyword." msgstr "값의 경계 상자 하단이 키워드의 경계 상자보다 **위에 있지 않습니다**." #: ../../recipes-text.rst:59 3a28328449d0465298d40e600034845d msgid "" "There are **no other restrictions**: the page layout may or may not be " "fixed, and the text may also have been stored as one string. Key and " "value may have any distance from each other." msgstr "" "**다른 제한은 없습니다**: 페이지 레이아웃이 고정되어 있을 수도 있고 아닐 수도 있으며, 텍스트가 하나의 문자열로 저장되었을 수도 있습니다. 키와 값은 서로 어떤 거리든 가질 수 있습니다." #: ../../recipes-text.rst:61 d4fc0262f0d74fcd8ab3810ea67fcabd msgid "" "For example, the following five key-value pairs will be correctly " "identified::" msgstr "예를 들어, 다음 다섯 개의 키-값 쌍이 올바르게 식별됩니다::" #: ../../recipes-text.rst:77 193e5336ec2f43b2a832b43d6a58d308 msgid "How to Extract Text from within a Rectangle" msgstr "사각형 내부에서 텍스트 추출 방법" #: ../../recipes-text.rst:78 4c4438f1bc044009b24645d65ce8ab60 msgid "" "There is now (v1.18.0) more than one way to achieve this. We therefore " "have created a `folder `_ in the PyMuPDF-Utilities " "repository specifically dealing with this topic." msgstr "" "이제 (v1.18.0) 이를 달성하는 방법이 여러 가지 있습니다. 따라서 이 주제를 다루는 `폴더 " "`_ 를 " "PyMuPDF-Utilities 저장소에 만들었습니다." #: ../../recipes-text.rst:88 742b2388b2764f87a7e62ef6bfa73dd6 msgid "How to Extract Text in Natural Reading Order" msgstr "자연스러운 읽기 순서로 텍스트 추출 방법" #: ../../recipes-text.rst:90 0e8c0fee0d084b9883b573ad87009d6e msgid "" "One of the common issues with PDF text extraction is, that text may not " "appear in any particular reading order." msgstr "PDF 텍스트 추출의 일반적인 문제 중 하나는 텍스트가 특정 읽기 순서로 나타나지 않을 수 있다는 것입니다." #: ../../recipes-text.rst:92 371d80a5d01448afa0dd235c5b575b74 msgid "" "This is the responsibility of the PDF creator (software or a human). For " "example, page headers may have been inserted in a separate step -- after " "the document had been produced. In such a case, the header text will " "appear at the end of a page text extraction (although it will be " "correctly shown by PDF viewer software). For example, the following " "snippet will add some header and footer lines to an existing PDF::" msgstr "" "이는 PDF 생성자(소프트웨어 또는 사람)의 책임입니다. 예를 들어, 페이지 헤더는 문서가 생성된 후 별도의 단계에서 삽입되었을 수 있습니다. " "이 경우 헤더 텍스트는 페이지 텍스트 추출의 끝에 나타납니다(하지만 PDF 뷰어 소프트웨어에서는 올바르게 표시됩니다). 예를 들어, 다음 스니펫은 기존 " "PDF에 일부 헤더 및 푸터 줄을 추가합니다::" #: ../../recipes-text.rst:104 4e580c24666243d38d3b31b8c81cd144 msgid "" "The text sequence extracted from a page modified in this way will look " "like this:" msgstr "이런 방식으로 수정된 페이지에서 추출된 텍스트 시퀀스는 다음과 같습니다:" #: ../../recipes-text.rst:106 0dc07ee4abb14a8591e99d17d219a66e msgid "original text" msgstr "원본 텍스트" #: ../../recipes-text.rst:107 a16785675c2e42889b217e4366030fc0 msgid "header line" msgstr "헤더 줄" #: ../../recipes-text.rst:108 799554ad7a954b8f9f8b0a65b45eb2ef msgid "footer line" msgstr "푸터 줄" #: ../../recipes-text.rst:110 6dfbb78929994320a0792e1e879361b4 msgid "" "PyMuPDF has several means to re-establish some reading sequence or even " "to re-generate a layout close to the original:" msgstr "PyMuPDF는 읽기 순서를 재구성하거나 원본에 가까운 레이아웃을 재생성하는 여러 가지 방법을 제공합니다:" #: ../../recipes-text.rst:112 3c8a07a9513e4d6faa6519684db819d5 msgid "" "Use `sort` parameter of :meth:`Page.get_text`. It will sort the output " "from top-left to bottom-right (ignored for XHTML, HTML and XML output)." msgstr "" ":meth:`Page.get_text` 의 `sort` 매개변수를 사용하세요. 출력을 왼쪽 위에서 오른쪽 아래로 정렬합니다 (XHTML, " "HTML 및 XML 출력에는 무시됨)." #: ../../recipes-text.rst:113 ec3f668329044785b2d980019e4279e2 msgid "" "Use the `pymupdf` module in CLI: `python -m pymupdf gettext ...`, which " "produces a text file where text has been re-arranged in layout-preserving" " mode. Many options are available to control the output." msgstr "" "CLI에서 `pymupdf` 모듈을 사용하세요: `python -m pymupdf gettext ...`, 이는 레이아웃을 보존하는 모드로 " "텍스트가 재배열된 텍스트 파일을 생성합니다. 출력을 제어하는 많은 옵션이 있습니다." #: ../../recipes-text.rst:115 e9acdb536bca4568ad8b4d1ec10d61ea msgid "" "You can also use the above mentioned `script " "`_ with your modifications." msgstr "" "위에서 언급한 `스크립트 `_ 를 수정하여 사용할 수도 있습니다." #: ../../recipes-text.rst:122 e855c66968e14c8292b797d093cd0b65 msgid "" "How to :index:`Extract Table Content ` from " "Documents" msgstr "문서에서 :index:`테이블 내용 추출 ` 방법" #: ../../recipes-text.rst:123 44f6d95fd2764808af666701bb7f19a0 msgid "" "If you see a table in a document, you are normally not looking at " "something like an embedded Excel or other identifiable object. It usually" " is just normal, standard text, formatted to appear as tabular data." msgstr "" "문서에서 테이블을 볼 때, 일반적으로 Excel 같은 임베드된 객체나 다른 식별 가능한 객체를 보는 것이 아닙니다. 보통은 표 형식 데이터로 " "보이도록 포맷된 일반적인 표준 텍스트일 뿐입니다." #: ../../recipes-text.rst:125 d16f360542d940e5a852c0aa8564e344 msgid "" "Extracting tabular data from such a page area therefore means that you " "must find a way to **identify** the table area (i.e. its boundary box), " "then **(1)** graphically indicate table and column borders, and **(2)** " "then extract text based on this information." msgstr "" "따라서 이러한 페이지 영역에서 표 형식 데이터를 추출하려면 테이블 영역(즉, 경계 상자)을 **식별** 하는 방법을 찾은 다음 **(1)** " "테이블 및 열 경계를 그래픽으로 표시하고 **(2)** 이 정보를 기반으로 텍스트를 추출해야 합니다." #: ../../recipes-text.rst:127 a113658ef8c641279d0583854610b700 msgid "" "This can be a very complex task, depending on details like the presence " "or absence of lines, rectangles or other supporting vector graphics." msgstr "" "이는 선, 사각형 또는 기타 지원 벡터 그래픽의 존재 여부와 같은 세부 사항에 따라 매우 복잡한 작업이 될 수 있습니다." #: ../../recipes-text.rst:129 591bba39c0464acda49f9fc542563e38 msgid "" "Method :meth:`Page.find_tables` does all that for you, with a high table " "detection precision. Its great advantage is that there are no external " "library dependencies, nor the need to employ artificial intelligence or " "machine learning technologies. It also provides an integrated interface " "to the well-known Python package for data analysis `pandas " "`_." msgstr "" ":meth:`Page.find_tables` 메서드는 높은 테이블 감지 정밀도로 모든 작업을 수행합니다. 큰 장점은 외부 라이브러리 의존성이 없고 " "인공 지능이나 머신 러닝 기술을 사용할 필요가 없다는 것입니다. 또한 데이터 분석을 위한 잘 알려진 Python 패키지 `pandas " "`_ 에 대한 통합 인터페이스를 제공합니다." #: ../../recipes-text.rst:131 0ec9741148044d23b6fe82ee829207a2 msgid "" "Please have a look at example `Jupyter notebooks " "`_, which cover standard situations like multiple tables on one " "page or joining table fragments across multiple pages." msgstr "" "한 페이지에 여러 테이블이 있거나 여러 페이지에 걸친 테이블 조각을 결합하는 것과 같은 표준 상황을 다루는 예제 `Jupyter 노트북 " "`_ " "를 살펴보세요." #: ../../recipes-text.rst:138 b1f926e82a76494a9f56c7876863ca93 msgid "How to Mark Extracted Text" msgstr "추출된 텍스트 표시 방법" #: ../../recipes-text.rst:139 1e973eca86874445943029692b1f158c msgid "" "There is a standard search function to search for arbitrary text on a " "page: :meth:`Page.search_for`. It returns a list of :ref:`Rect` objects " "which surround a found occurrence. These rectangles can for example be " "used to automatically insert annotations which visibly mark the found " "text." msgstr "" "페이지에서 임의의 텍스트를 검색하는 표준 검색 함수가 있습니다: :meth:`Page.search_for`. 발견된 항목을 둘러싸는 " ":ref:`Rect` 객체 목록을 반환합니다. 이러한 사각형은 예를 들어 발견된 텍스트를 시각적으로 표시하는 주석을 자동으로 삽입하는 데 사용할 수 있습니다." #: ../../recipes-text.rst:141 dc031cd749464364bf765bac0417b4b0 msgid "This method has advantages and drawbacks. Pros are:" msgstr "이 방법에는 장점과 단점이 있습니다. 장점은 다음과 같습니다:" #: ../../recipes-text.rst:143 86833cccc89c42c3895307b65c1b8961 msgid "The search string can contain blanks and wrap across lines" msgstr "검색 문자열은 공백을 포함할 수 있고 여러 줄에 걸칠 수 있습니다" #: ../../recipes-text.rst:144 fbcd0df95b764ad0a6fc7a6e5cf28042 msgid "Upper or lower case characters are treated equal" msgstr "대문자 또는 소문자 문자가 동일하게 처리됩니다" #: ../../recipes-text.rst:145 5c86c01b36574cb1ac96a3d8134e20f7 msgid "Word hyphenation at line ends is detected and resolved" msgstr "줄 끝의 단어 하이픈 연결이 감지되고 해결됩니다" #: ../../recipes-text.rst:146 3c530d96cd524a0f93975a14b9e1802b msgid "" "Return may also be a list of :ref:`Quad` objects to precisely locate text" " that is **not parallel** to either axis -- using :ref:`Quad` output is " "also recommended, when page rotation is not zero." msgstr "" "반환값은 어느 축에도 **평행하지 않은** 텍스트를 정확히 찾기 위한 :ref:`Quad` 객체 목록일 수도 있습니다 -- 페이지 회전이 " "0이 아닐 때는 :ref:`Quad` 출력 사용을 권장합니다." #: ../../recipes-text.rst:148 d23bafdfe40a49d6bf4bb9a1b76b0938 msgid "But you also have other options::" msgstr "하지만 다른 옵션도 있습니다::" #: ../../recipes-text.rst:182 80855b0c68a2478481c53a15e79cac96 msgid "" "This script uses `Page.get_text(\"words\")` to look for a string, handed " "in via cli parameter. This method separates a page's text into \"words\" " "using white spaces as delimiters. Further remarks:" msgstr "" "이 스크립트는 CLI 매개변수를 통해 전달된 문자열을 찾기 위해 `Page.get_text(\"words\")` 를 사용합니다. 이 방법은 " "페이지의 텍스트를 공백을 구분자로 사용하여 \"단어\"로 분리합니다. 추가 설명:" #: ../../recipes-text.rst:184 1de65ffefd864dd3aba7fd7e18895779 msgid "" "If found, the **complete word containing the string** is marked " "(underlined) -- not only the search string." msgstr "발견되면, 검색 문자열뿐만 아니라 **문자열을 포함하는 전체 단어** 가 표시됩니다(밑줄)." #: ../../recipes-text.rst:185 2b3e71fdbd4147a499e2a703e50786fd msgid "" "The search string may **not contain word delimiters**. By default, word " "delimiters are white spaces and the non-breaking space `chr(0xA0)`. If " "you use extra delimiting characters like `page.get_text(\"words\", " "delimiters=\"./,\")` then none of these characters should be included in " "your search string either." msgstr "" "검색 문자열에는 **단어 구분자를 포함할 수 없습니다**. 기본적으로 단어 구분자는 공백과 줄바꿈 없는 공백 `chr(0xA0)` " "입니다. `page.get_text(\"words\", delimiters=\"./,\")` 와 같이 추가 구분 문자를 사용하는 경우, 이러한 " "문자 중 어느 것도 검색 문자열에 포함되어서는 안 됩니다." #: ../../recipes-text.rst:186 adbf6633cd5e4ad488040e4cc264ca3c msgid "" "As shown here, upper / lower cases are **respected**. But this can be " "changed by using the string method *lower()* (or even regular " "expressions) in function *mark_word*." msgstr "" "여기서 보여주듯이, 대문자/소문자가 **구분됩니다**. 하지만 *mark_word* 함수에서 문자열 메서드 *lower()* (또는 정규 " "표현식)를 사용하여 이를 변경할 수 있습니다." #: ../../recipes-text.rst:187 96993cd9b8a9474da6785f2edc5b39a5 msgid "There is **no upper limit**: all occurrences will be detected." msgstr "**상한이 없습니다**: 모든 항목이 감지됩니다." #: ../../recipes-text.rst:188 0e9d7915b8cc4de6861f917e3f3412e6 msgid "" "You can use **anything** to mark the word: 'Underline', 'Highlight', " "'StrikeThrough' or 'Square' annotations, etc." msgstr "" "단어를 표시하는 데 **어떤 것** 이든 사용할 수 있습니다: 'Underline', 'Highlight', 'StrikeThrough' 또는 " "'Square' 주석 등." #: ../../recipes-text.rst:189 d0f23f19d8d74f58b65405672d5ef654 msgid "" "Here is an example snippet of a page of this manual, where \"MuPDF\" has " "been used as the search string. Note that all strings **containing " "\"MuPDF\"** have been completely underlined (not just the search string)." msgstr "" "이 매뉴얼 페이지의 예제 스니펫입니다. \"MuPDF\" 가 검색 문자열로 사용되었습니다. **\"MuPDF\"를 포함하는** 모든 문자열이 " "완전히 밑줄 처리되었습니다(검색 문자열뿐만 아니라)." #: ../../recipes-text.rst:200 e7ff4483e8b34bd3b6aa194e55963507 msgid "How to Mark Searched Text" msgstr "검색된 텍스트 표시 방법" #: ../../recipes-text.rst:204 7c7b2708f7d045ebb7a03223d6f8ea9d msgid "This script searches for text and marks it::" msgstr "이 스크립트는 텍스트를 검색하고 표시합니다::" #: ../../recipes-text.rst:230 e211931535cf4266a427d5b731c8a73e msgid "The result looks like this:" msgstr "결과는 다음과 같습니다:" #: ../../recipes-text.rst:241 9c36d575753f422cbdc4614a787057ab msgid "How to Mark Non-horizontal Text" msgstr "수평이 아닌 텍스트 표시 방법" #: ../../recipes-text.rst:242 1e52760d0e514e19ba6ab20d5f1fb0d7 msgid "" "The previous section already shows an example for marking non-horizontal " "text, that was detected by text **searching**." msgstr "이전 섹션에서는 텍스트 **검색** 으로 감지된 수평이 아닌 텍스트를 표시하는 예제를 이미 보여주었습니다." #: ../../recipes-text.rst:244 ded1ab547046433489a3f24860ad56dc msgid "" "But text **extraction** with the \"dict\" / \"rawdict\" options of " ":meth:`Page.get_text` may also return text with a non-zero angle to the " "x-axis. This is indicated by the value of the line dictionary's `\"dir\"`" " key: it is the tuple `(cosine, sine)` for that angle. If `line[\"dir\"] " "!= (1, 0)`, then the text of all its spans is rotated by (the same) angle" " != 0." msgstr "" "하지만 :meth:`Page.get_text` 의 \"dict\" / \"rawdict\" 옵션을 사용한 텍스트 **추출** 은 x축에 대해 " "0이 아닌 각도를 가진 텍스트도 반환할 수 있습니다. 이는 줄 딕셔너리의 `\"dir\"` 키 값으로 표시됩니다: 해당 각도의 튜플 " "`(cosine, sine)` 입니다. `line[\"dir\"] != (1, 0)` 이면, 모든 스팬의 텍스트가 (동일한) 각도 != 0으로 " "회전됩니다." #: ../../recipes-text.rst:246 806b832583d84ccc93707076ad170901 msgid "" "The \"bboxes\" returned by the method however are rectangles only -- not " "quads. So, to mark span text correctly, its quad must be recovered from " "the data contained in the line and span dictionary. Do this with the " "following utility function (new in v1.18.9)::" msgstr "" "하지만 이 메서드가 반환하는 \"bboxes\"는 사각형일 뿐입니다 -- 쿼드가 아닙니다. 따라서 스팬 텍스트를 올바르게 표시하려면, 줄 및 " "스팬 딕셔너리에 포함된 데이터에서 쿼드를 복구해야 합니다. 다음 유틸리티 함수를 사용하세요 (v1.18.9에서 새로 추가됨)::" #: ../../recipes-text.rst:251 374483caf365491888ccd4a28c1034f8 msgid "" "If you want to **mark the complete line** or a subset of its spans in one" " go, use the following snippet (works for v1.18.10 or later)::" msgstr "" "**전체 줄** 또는 스팬의 하위 집합을 한 번에 표시하려면 다음 스니펫을 사용하세요 (v1.18.10 이상에서 작동)::" #: ../../recipes-text.rst:258 1257febf78464c89b484b1cf6071bec4 msgid "" "The `spans` argument above may specify any sub-list of `line[\"spans\"]`." " In the example above, the second to second-to-last span are marked. If " "omitted, the complete line is taken." msgstr "" "위의 `spans` 인수는 `line[\"spans\"]` 의 임의의 하위 목록을 지정할 수 있습니다. 위 예제에서는 두 번째부터 " "마지막에서 두 번째까지의 스팬이 표시됩니다. 생략하면 전체 줄이 사용됩니다." #: ../../recipes-text.rst:265 73fd41c1a1a94a5db20497ae5b6e3c38 msgid "How to Analyze Font Characteristics" msgstr "폰트 특성 분석 방법" #: ../../recipes-text.rst:266 7643d48b4b834ad5a18337b0d8dda127 msgid "" "To analyze the characteristics of text in a PDF use this elementary " "script as a starting point:" msgstr "PDF의 텍스트 특성을 분석하려면 이 기본 스크립트를 시작점으로 사용하세요:" #: ../../recipes-text.rst:271 be40eabfee1c41e68990b36a6e79a16f msgid "Here is the PDF page and the script output:" msgstr "PDF 페이지와 스크립트 출력은 다음과 같습니다:" #: ../../recipes-text.rst:282 f7cca7fc650940c6b739a5e09938bbdd msgid "How to Insert Text" msgstr "텍스트 삽입 방법" #: ../../recipes-text.rst:283 dacb14e969f44d09b2a5487775dd63ea msgid "" "PyMuPDF provides ways to insert text on new or existing PDF pages with " "the following features:" msgstr "PyMuPDF는 다음 기능을 사용하여 새 PDF 페이지나 기존 PDF 페이지에 텍스트를 삽입하는 방법을 제공합니다:" #: ../../recipes-text.rst:285 f1dd495e1caa4902a8e5c782e9c679b5 msgid "" "choose the font, including built-in fonts and fonts that are available as" " files" msgstr "파일로 사용 가능한 폰트를 포함하여 내장 폰트와 폰트를 선택" #: ../../recipes-text.rst:286 4b098043ef3245699c145e6b99254bfb msgid "choose text characteristics like bold, italic, font size, font color, etc." msgstr "굵게, 기울임, 폰트 크기, 폰트 색상 등의 텍스트 특성 선택" #: ../../recipes-text.rst:287 a7d20d40102b4dd987941eec0fe2059b msgid "position the text in multiple ways:" msgstr "여러 방법으로 텍스트 위치 지정:" #: ../../recipes-text.rst:289 ebb1742c954f43b6b40e7dd5c8eefbc2 msgid "either as simple line-oriented output starting at a certain point," msgstr "특정 지점에서 시작하는 간단한 줄 지향 출력으로," #: ../../recipes-text.rst:290 caf3e77d02db4d88ba4b4ce0df67f82b msgid "" "or fitting text in a box provided as a rectangle, in which case text " "alignment choices are also available," msgstr "또는 사각형으로 제공된 상자에 텍스트를 맞추는 경우, 이 경우 텍스트 정렬 선택도 사용 가능," #: ../../recipes-text.rst:291 08f04e2e5fff428aad600459aeae779f msgid "" "choose whether text should be put in foreground (overlay existing " "content)," msgstr "텍스트를 전경에 배치할지 선택(기존 콘텐츠 위에 오버레이)," #: ../../recipes-text.rst:292 1899456d8c24474f8bcd5e172b2cde12 msgid "" "all text can be arbitrarily \"morphed\", i.e. its appearance can be " "changed via a :ref:`Matrix`, to achieve effects like scaling, shearing or" " mirroring," msgstr "" "모든 텍스트를 임의로 \"변형\"할 수 있습니다. 즉, :ref:`Matrix` 를 통해 모양을 변경하여 확대/축소, 기울이기 또는 미러링과 " "같은 효과를 얻을 수 있습니다," #: ../../recipes-text.rst:293 86bfde1660ba41f499e89840e1564a90 msgid "" "independently from morphing and in addition to that, text can be rotated " "by integer multiples of 90 degrees." msgstr "변형과 독립적으로, 추가로 텍스트를 90도의 정수 배로 회전할 수 있습니다." #: ../../recipes-text.rst:295 be111c03edb84cf2a94e8762714cc0eb msgid "" "All of the above is provided by three basic :ref:`Page`, resp. " ":ref:`Shape` methods:" msgstr "위의 모든 것은 세 가지 기본 :ref:`Page`, 각각 :ref:`Shape` 메서드로 제공됩니다:" #: ../../recipes-text.rst:297 72cb967325024d41a8ffa1c2ab753fd4 msgid "" ":meth:`Page.insert_font` -- install a font for the page for later " "reference. The result is reflected in the output of " ":meth:`Document.get_page_fonts`. The font can be:" msgstr "" ":meth:`Page.insert_font` -- 나중에 참조할 수 있도록 페이지에 폰트를 설치합니다. 결과는 " ":meth:`Document.get_page_fonts` 의 출력에 반영됩니다. 폰트는 다음 중 하나일 수 있습니다:" #: ../../recipes-text.rst:299 b76fff0661ed480cb05480c7a9a31ddd msgid "provided as a file," msgstr "파일로 제공되거나," #: ../../recipes-text.rst:300 7c635389b9dd4de28b6bfd73e66eb774 msgid "via :ref:`Font` (then use :attr:`Font.buffer`)" msgstr ":ref:`Font` 를 통해 (그런 다음 :attr:`Font.buffer` 사용) 또는" #: ../../recipes-text.rst:301 58c5c49b72314f1fbef5a7fdb829811d msgid "already present somewhere in **this or another** PDF, or" msgstr "**이 PDF 또는 다른** PDF의 어딘가에 이미 있거나," #: ../../recipes-text.rst:302 f6a2b00d975e4ffbb57171c37d4127bb msgid "be a **built-in** font." msgstr "**내장** 폰트일 수 있습니다." #: ../../recipes-text.rst:304 a44d01d2b9bb4d3686811c70f9b9271a msgid "" ":meth:`Page.insert_text` -- write some lines of text. Internally, this " "uses :meth:`Shape.insert_text`." msgstr "" ":meth:`Page.insert_text` -- 텍스트 줄을 작성합니다. 내부적으로는 :meth:`Shape.insert_text` 를 " "사용합니다." #: ../../recipes-text.rst:306 bfd1f9b3c2b741b29c87208a1a66d28e msgid "" ":meth:`Page.insert_textbox` -- fit text in a given rectangle. Here you " "can choose text alignment features (left, right, centered, justified) and" " you keep control as to whether text actually fits. Internally, this uses" " :meth:`Shape.insert_textbox`." msgstr "" ":meth:`Page.insert_textbox` -- 주어진 사각형에 텍스트를 맞춥니다. 여기서 텍스트 정렬 기능(왼쪽, 오른쪽, " "가운데, 양쪽 정렬)을 선택할 수 있으며 텍스트가 실제로 맞는지 제어할 수 있습니다. 내부적으로는 :meth:`Shape.insert_textbox` " "를 사용합니다." #: ../../recipes-text.rst:308 be171eb050b94f58b9cd1b5e0262f4c9 msgid "Both text insertion methods automatically install the font as necessary." msgstr "두 텍스트 삽입 방법 모두 필요에 따라 폰트를 자동으로 설치합니다." #: ../../recipes-text.rst:314 b5fff0f0c7634c4b944d6adf15b57a63 msgid "How to Write Text Lines" msgstr "텍스트 줄 작성 방법" #: ../../recipes-text.rst:315 cb73fdfc91be42e784e9bdd13d791bc0 msgid "Output some text lines on a page::" msgstr "페이지에 텍스트 줄 출력::" #: ../../recipes-text.rst:336 93ea55096a814bf78d67323eff265e39 msgid "" "With this method, only the **number of lines** will be controlled to not " "go beyond page height. Surplus lines will not be written and the number " "of actual lines will be returned. The calculation uses a line height " "calculated from the :data:`fontsize` and 36 points (0.5 inches) as bottom" " margin." msgstr "" "이 방법을 사용하면 **줄 수** 만 페이지 높이를 초과하지 않도록 제어됩니다. 초과 줄은 작성되지 않으며 실제 줄 수가 반환됩니다. 계산은 " ":data:`fontsize` 와 하단 여백으로 36포인트(0.5인치)에서 계산된 줄 높이를 사용합니다." #: ../../recipes-text.rst:338 d32561da58f04605a11ea899f3142f80 msgid "" "Line **width is ignored**. The surplus part of a line will simply be " "invisible." msgstr "줄 **너비는 무시됩니다**. 줄의 초과 부분은 단순히 보이지 않습니다." #: ../../recipes-text.rst:340 be87d53797fa4459b5ccf3c4131594e4 msgid "" "However, for built-in fonts there are ways to calculate the line width " "beforehand - see :meth:`get_text_length`." msgstr "하지만 내장 폰트의 경우 사전에 줄 너비를 계산하는 방법이 있습니다 - :meth:`get_text_length` 를 참조하세요." #: ../../recipes-text.rst:342 f9e73fbbab774c2caa85bbed776cc956 msgid "" "Here is another example. It inserts 4 text strings using the four " "different rotation options, and thereby explains, how the text insertion " "point must be chosen to achieve the desired result::" msgstr "" "다른 예제입니다. 네 가지 다른 회전 옵션을 사용하여 4개의 텍스트 문자열을 삽입하고, 원하는 결과를 얻기 위해 텍스트 삽입 지점을 어떻게 " "선택해야 하는지 설명합니다::" #: ../../recipes-text.rst:378 0213c8bab6154d30805d62976edc9a19 msgid "This is the result:" msgstr "결과는 다음과 같습니다:" #: ../../recipes-text.rst:390 f3944598e7174b5c84183c27d9976e7d msgid "How to Fill a Text Box" msgstr "텍스트 상자 채우기 방법" #: ../../recipes-text.rst:391 432bedd774af4765abc17063d64bbff5 msgid "" "This script fills 4 different rectangles with text, each time choosing a " "different rotation value::" msgstr "이 스크립트는 텍스트로 4개의 다른 사각형을 채우며, 매번 다른 회전 값을 선택합니다::" #: ../../recipes-text.rst:428 b57fefc0582d49269895485a9f9f2d81 msgid "" "Some default values were used above: font size 11 and text alignment " "\"left\". The result will look like this:" msgstr "위에서는 일부 기본값이 사용되었습니다: 폰트 크기 11 및 텍스트 정렬 \"left\". 결과는 다음과 같습니다:" #: ../../recipes-text.rst:438 1b2793a104ab4b5688254d0c742bdce1 msgid "How to Fill a Box with HTML Text" msgstr "HTML 텍스트로 상자 채우기 방법" #: ../../recipes-text.rst:439 19e59b0993924e4c95225686d9cc0d88 msgid "" "Method :meth:`Page.insert_htmlbox` offers a **much more powerful** way to" " insert text in a rectangle." msgstr ":meth:`Page.insert_htmlbox` 메서드는 사각형에 텍스트를 삽입하는 **훨씬 더 강력한** 방법을 제공합니다." #: ../../recipes-text.rst:441 35f57808a8794c8e9e19787c2c32e112 msgid "" "Instead of simple, plain text, this method accepts HTML source, which may" " not only contain HTML tags but also styling instructions to influence " "things like font, font weight (bold) and style (italic), color and much " "more." msgstr "" "간단한 일반 텍스트 대신, 이 메서드는 HTML 소스를 받아들입니다. HTML 태그뿐만 아니라 폰트, 폰트 굵기(굵게), 스타일(기울임), " "색상 등을 제어하는 스타일 지시문도 포함할 수 있습니다." #: ../../recipes-text.rst:443 71ac810a548442d29907981f132dccbf msgid "" "It is also possible to mix multiple fonts and languages, to output HTML " "tables and to insert images and URI links." msgstr "여러 폰트와 언어를 혼합하고, HTML 테이블을 출력하며, 이미지와 URI 링크를 삽입할 수도 있습니다." #: ../../recipes-text.rst:445 0b4174d507754388b32a80b165012df6 msgid "" "For even more styling flexibility, an additional CSS source may also be " "given." msgstr "더 많은 스타일링 유연성을 위해 추가 CSS 소스를 제공할 수도 있습니다." #: ../../recipes-text.rst:447 ef0b305a96e04f7b82deb24dacac92d1 msgid "" "The method is based on the :ref:`Story` class. Therefore, complex script " "systems like Devanagari, Nepali, Tamil and many are supported and written" " correctly thanks to using the HarfBuzz library - which provides this so-" "called **\"text shaping\"** feature." msgstr "" "이 메서드는 :ref:`Story` 클래스를 기반으로 합니다. 따라서 Devanagari, Nepali, Tamil 등과 같은 복잡한 " "문자 체계가 지원되며 HarfBuzz 라이브러리를 사용하여 올바르게 작성됩니다 - 이는 소위 **\"텍스트 셰이핑\"** 기능을 제공합니다." #: ../../recipes-text.rst:449 1260a458a7e544b1aa67b8755b17c8ec msgid "" "Any required fonts to output characters are automatically pulled in from " "the Google NOTO font library - as a fallback (when the -- optionally " "supplied -- user font(s) do not contain some glyphs)." msgstr "" "문자를 출력하는 데 필요한 모든 폰트는 Google NOTO 폰트 라이브러리에서 자동으로 가져옵니다 - 폴백으로 (선택적으로 제공된 " "-- 사용자 폰트에 일부 글리프가 없는 경우)." #: ../../recipes-text.rst:451 fcaf38aee6714a809439a7e41809456a msgid "" "As a small glimpse into the features offered here, we will output the " "following HTML-enriched text::" msgstr "여기서 제공되는 기능을 간단히 살펴보기 위해 다음 HTML이 풍부한 텍스트를 출력합니다::" #: ../../recipes-text.rst:476 9c59a952ce374072a5f1980b9e94e9e5 msgid "" "Please note how the \"css\" parameter is used to globally select the " "default \"sans-serif\" font and a font size of 14." msgstr "\"css\" 매개변수가 기본 \"sans-serif\" 폰트와 폰트 크기 14를 전역적으로 선택하는 데 어떻게 사용되는지 주목하세요." #: ../../recipes-text.rst:478 ../../recipes-text.rst:546 #: 7e28c391edc0498e9f137492e4579c8b d1d571d5e2a543f1960a767a55013650 msgid "The result will look like this:" msgstr "결과는 다음과 같습니다:" #: ../../recipes-text.rst:483 ed1313ec473f4a6abdbea7c7fdbc2bc3 msgid "How to output HTML tables and images" msgstr "HTML 테이블 및 이미지 출력 방법" #: ../../recipes-text.rst:485 d915167d0a8a487ca0714949823727f9 msgid "" "Here is another example that outputs a table with this method. This time," " we are including all the styling in the HTML source itself. Please also " "note, how it works to include an image - even within a table cell::" msgstr "" "이 메서드로 테이블을 출력하는 또 다른 예제입니다. 이번에는 모든 스타일링을 HTML 소스 자체에 포함합니다. 이미지를 포함하는 방법(테이블 " "셀 내부에서도)도 주목하세요::" #: ../../recipes-text.rst:552 8a1001c5f5074d4ba6c32b464a047fe3 msgid "How to Output Languages of the World" msgstr "세계 언어 출력 방법" #: ../../recipes-text.rst:554 694851da42974f849ae4f15fb8583d84 msgid "" "Our third example will demonstrate the automatic multi-language support. " "It includes automatic **text shaping** for complex scripting systems like" " Devanagari and right-to-left languages::" msgstr "" "세 번째 예제는 자동 다국어 지원을 보여줍니다. Devanagari 및 오른쪽에서 왼쪽으로 쓰는 언어와 같은 복잡한 문자 체계에 대한 자동 " "**텍스트 셰이핑** 을 포함합니다::" #: ../../recipes-text.rst:584 11883d2c3225403c9efe9db6404e0614 msgid "And this is the output:" msgstr "그리고 이것이 출력입니다:" #: ../../recipes-text.rst:589 1694d9848471473387efc178c64d1ac3 msgid "How to Specify your Own Fonts" msgstr "자신의 폰트 지정 방법" #: ../../recipes-text.rst:591 e24039a16e614bad9521e9f98300ca0a msgid "" "Define your font files in CSS syntax using the `@font-face` statement. " "You need a separate `@font-face` for every combination of font weight and" " font style (e.g. bold or italic) you want to be supported. The following" " example uses the famous MS Comic Sans font in its four variants regular," " bold, italic and bold-italic." msgstr "" "`@font-face` 문을 사용하여 CSS 구문으로 폰트 파일을 정의하세요. 지원하려는 폰트 굵기와 폰트 스타일(예: 굵게 또는 기울임)의 " "모든 조합에 대해 별도의 `@font-face` 가 필요합니다. 다음 예제는 유명한 MS Comic Sans 폰트를 일반, 굵게, " "기울임, 굵은 기울임의 네 가지 변형으로 사용합니다." #: ../../recipes-text.rst:593 b2b6a21607d34d64a2c7e188ebc89771 msgid "" "As these four font files are located in the system's folder " "`C:/Windows/Fonts` the method needs an :ref:`Archive` definition that " "points to that folder::" msgstr "" "이 네 개의 폰트 파일이 시스템 폴더 `C:/Windows/Fonts` 에 있으므로, 메서드는 해당 폴더를 가리키는 :ref:`Archive` " "정의가 필요합니다::" #: ../../recipes-text.rst:642 e0f58841406a42738934f9d5496b3b1a msgid "How to Request Text Alignment" msgstr "텍스트 정렬 요청 방법" #: ../../recipes-text.rst:644 fe05e68776a74af9bbef92af559109dd msgid "This example combines multiple requirements:" msgstr "이 예제는 여러 요구사항을 결합합니다:" #: ../../recipes-text.rst:646 e70a8667e3944fd9b0816777acb87234 msgid "Rotate the text by 90 degrees anti-clockwise." msgstr "텍스트를 90도 반시계 방향으로 회전합니다." #: ../../recipes-text.rst:647 d9cf7d46a2d346b2a4f74a171faa1447 msgid "" "Use a font from package `pymupdf-fonts `_. You will see that the respective CSS definitions are a lot " "easier in this case." msgstr "" "`pymupdf-fonts `_ 패키지의 폰트를 사용합니다. 이 " "경우 해당 CSS 정의가 훨씬 더 쉬운 것을 볼 수 있습니다." #: ../../recipes-text.rst:648 bd33916fceb54e72962046e30a682445 msgid "Align the text with the \"justify\" option." msgstr "\"justify\" 옵션으로 텍스트를 정렬합니다." #: ../../recipes-text.rst:698 77fa2772ac8f4569be51c8e5f85dfc85 msgid "How to Extract Text with Color" msgstr "색상이 있는 텍스트 추출 방법" #: ../../recipes-text.rst:700 9b6a414568c14a82b047478e4a84f66a msgid "" "Iterate through your text blocks and find the spans of text you need for " "this information." msgstr "텍스트 블록을 반복하고 이 정보에 필요한 텍스트 스팬을 찾으세요." #: ../../footer.rst:46 bdb1928a7ce24b5a9d8c30e00a139e48 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/recipes.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 5df69fce57964130a8f7ba6f591f56a4 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 948de28e8d244748b064cfd92a1bbcfd msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 11790f3e587e4e6bb551d9ae399cc35e msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../footer.rst:46 3bdca21fa122440dad23d3c3a493ace9 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/rect.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 3c227dada5ad4b709a49770ee170baa6 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 8f56716e037546c8b467b98c68c725a0 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 dfa0342751984e2f98c9f67f7362520d msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../rect.rst:7 ad45c59577c04e0d97cd0d7904581921 msgid "Rect" msgstr "Rect" #: ../../rect.rst:9 7f5d586f3c114edaa7ba458bfd6acb19 msgid "" "*Rect* represents a rectangle defined by four floating point numbers x0, " "y0, x1, y1. They are treated as being coordinates of two diagonally " "opposite points. The first two numbers are regarded as the \"top left\" " "corner P\\ :sub:`(x0,y0)` and P\\ :sub:`(x1,y1)` as the \"bottom right\" " "one. However, these two properties need not coincide with their intuitive" " meanings -- read on." msgstr "*Rect* 는 4개의 부동 소수점 숫자 x0, y0, x1, y1로 정의된 사각형을 나타냅니다. 이것들은 대각선으로 반대편에 있는 두 점의 좌표로 처리됩니다. 처음 두 숫자는 \"왼쪽 위\" 모서리 P\\ :sub:`(x0,y0)` 로 간주되고 P\\ :sub:`(x1,y1)` 는 \"오른쪽 아래\" 모서리로 간주됩니다. 그러나 이 두 속성은 직관적인 의미와 일치할 필요가 없습니다 -- 계속 읽어보세요." #: ../../rect.rst:11 dafcd3bc742b4bf98df8a2d355642314 msgid "The following remarks are also valid for :ref:`IRect` objects:" msgstr "다음 설명은 :ref:`IRect` 객체에도 유효합니다:" #: ../../rect.rst:13 be324158236b4de8923841e0b42e8290 msgid "" "A rectangle in the sense of (Py-) MuPDF **(and PDF)** always has " "**borders parallel to the x- resp. y-axis**. A general orthogonal " "tetragon **is not a rectangle** -- in contrast to the mathematical " "definition." msgstr "(Py-) MuPDF **(및 PDF)** 의 의미에서 사각형은 항상 **x축 및 y축에 평행한 경계** 를 가집니다. 일반적인 직교 사각형은 **사각형이 아닙니다** -- 수학적 정의와 대조적으로." #: ../../rect.rst:14 03d260254e054fa0874151431af0b147 msgid "" "The constructing points can be (almost! -- see below) anywhere in the " "plane -- they need not even be different, and e.g. \"top left\" need not " "be the geometrical \"north-western\" point." msgstr "구성 점은 평면의 어디에나 있을 수 있습니다(거의! -- 아래 참조) -- 서로 다를 필요도 없으며, 예를 들어 \"왼쪽 위\"가 기하학적으로 \"북서쪽\" 점일 필요는 없습니다." #: ../../rect.rst:15 fe6fa15cf8b7439aa597e5fcf5b13134 msgid "Units are in points, where 72 points is 1 inch." msgstr "단위는 포인트이며, 72포인트는 1인치입니다." #: ../../rect.rst:20 130a99f1057240a98f97beb4238fadbc msgid "" "For any given quadruple of numbers, the geometrically \"same\" rectangle " "can be defined in four different ways:" msgstr "주어진 4개의 숫자에 대해 기하학적으로 \"동일한\" 사각형은 4가지 다른 방법으로 정의할 수 있습니다:" #: ../../rect.rst:17 03ee461b9fd7463e92b92b0999c2952b msgid "Rect(P\\ :sub:`(x0,y0)`, P\\ :sub:`(x1,y1)`\\ )" msgstr "Rect(P\\ :sub:`(x0,y0)`, P\\ :sub:`(x1,y1)`\\ )" #: ../../rect.rst:18 4e4f6956c7774df98b15fe8f1f149cef msgid "Rect(P\\ :sub:`(x1,y1)`, P\\ :sub:`(x0,y0)`\\ )" msgstr "Rect(P\\ :sub:`(x1,y1)`, P\\ :sub:`(x0,y0)`\\ )" #: ../../rect.rst:19 7b63166e1f914252a70101cc5e25c590 msgid "Rect(P\\ :sub:`(x0,y1)`, P\\ :sub:`(x1,y0)`\\ )" msgstr "Rect(P\\ :sub:`(x0,y1)`, P\\ :sub:`(x1,y0)`\\ )" #: ../../rect.rst:20 baae5ac330ae44adb90f80708b977873 msgid "Rect(P\\ :sub:`(x1,y0)`, P\\ :sub:`(x0,y1)`\\ )" msgstr "Rect(P\\ :sub:`(x1,y0)`, P\\ :sub:`(x0,y1)`\\ )" #: ../../rect.rst:22 3775def55ff3492ea62cba278b2ff00e msgid "**(Changed in v1.19.0)** Hence some classification:" msgstr "**(v1.19.0에서 변경됨)** 따라서 다음과 같은 분류가 있습니다:" #: ../../rect.rst:24 005b82343a4c4d4282a0fc3d8a056830 msgid "" "A rectangle is called **valid** if `x0 <= x1` and `y0 <= y1` (i.e. the " "bottom right point is \"south-eastern\" to the top left one), otherwise " "**invalid**. Of the four alternatives above, **only the first** is valid." " Please take into account, that in MuPDF's coordinate system, the y-axis " "is oriented from **top to bottom**. Invalid rectangles have been called " "infinite in earlier versions." msgstr "사각형은 `x0 <= x1` 이고 `y0 <= y1` 인 경우(즉, 오른쪽 아래 점이 왼쪽 위 점의 \"남동쪽\"에 있는 경우) **유효** 라고 하며, 그렇지 않으면 **무효** 입니다. 위의 4가지 대안 중 **첫 번째만** 유효합니다. MuPDF의 좌표계에서 y축은 **위에서 아래로** 향한다는 점을 고려하세요. 무효한 사각형은 이전 버전에서 무한이라고 불렸습니다." #: ../../rect.rst:26 50cc1e1a23b7410e9b40d9e4a22e2552 msgid "" "A rectangle is called **empty** if `x0 >= x1` or `y0 >= y1`. This " "implies, that **invalid rectangles are also always empty.** And `width` " "(resp. `height`) is **set to zero** if `x0 > x1` (resp. `y0 > y1`). In " "previous versions, a rectangle was empty only if one of width or height " "was zero." msgstr "사각형은 `x0 >= x1` 또는 `y0 >= y1` 인 경우 **비어 있음** 이라고 합니다. 이것은 **무효한 사각형도 항상 비어 있음** 을 의미합니다. 그리고 `x0 > x1` (각각 `y0 > y1`)인 경우 `width` (각각 `height`)는 **0으로 설정** 됩니다. 이전 버전에서는 너비 또는 높이 중 하나가 0인 경우에만 사각형이 비어 있었습니다." #: ../../rect.rst:28 6b8c92c5c94146e38742390553f50ad5 msgid "" "Rectangle coordinates **cannot be outside** the number range from " "`FZ_MIN_INF_RECT = -2147483648` to `FZ_MAX_INF_RECT = 2147483520`. Both " "values have been chosen, because they are the smallest / largest 32bit " "integers that survive C float conversion roundtrips. In previous versions" " there was no limit for coordinate values." msgstr "사각형 좌표는 `FZ_MIN_INF_RECT = -2147483648` 부터 `FZ_MAX_INF_RECT = 2147483520` 까지의 숫자 범위 **밖에 있을 수 없습니다**. 두 값은 C float 변환 왕복에서 살아남는 가장 작은/가장 큰 32비트 정수이기 때문에 선택되었습니다. 이전 버전에서는 좌표 값에 제한이 없었습니다." #: ../../rect.rst:30 f7c36d56736842c7b5057e7ce77215f1 msgid "" "There is **exactly one \"infinite\" rectangle**, defined by `x0 = y0 = " "FZ_MIN_INF_RECT` and `x1 = y1 = FZ_MAX_INF_RECT`. It contains every other" " rectangle. It is mainly used for technical purposes -- e.g. when a " "function call should ignore a formally required rectangle argument. This " "rectangle is not empty." msgstr "**정확히 하나의 \"무한\" 사각형** 이 있으며, `x0 = y0 = FZ_MIN_INF_RECT` 및 `x1 = y1 = FZ_MAX_INF_RECT` 로 정의됩니다. 이것은 다른 모든 사각형을 포함합니다. 이것은 주로 기술적 목적으로 사용됩니다 -- 예를 들어 함수 호출이 형식적으로 필요한 사각형 인수를 무시해야 할 때. 이 사각형은 비어 있지 않습니다." #: ../../rect.rst:32 3fd9c878f8a345649eececf661fa6d0d msgid "" "**Rectangles are (semi-) open:** The right and the bottom edges " "(including the resp. corners) are not considered part of the rectangle. " "This implies, that only the top-left corner `(x0, y0)` can ever belong to" " the rectangle - the other three corners never do. An empty rectangle " "contains no corners at all." msgstr "**사각형은 (반)열림:** 오른쪽과 아래쪽 가장자리(각각의 모서리 포함)는 사각형의 일부로 간주되지 않습니다. 이것은 왼쪽 위 모서리 `(x0, y0)` 만 사각형에 속할 수 있음을 의미합니다 -- 다른 세 모서리는 절대 속하지 않습니다. 빈 사각형은 모서리가 전혀 없습니다." #: ../../rect.rst:38 e57daedf444e46e1b812656ca7832537 msgid "Here is an overview of the changes." msgstr "다음은 변경 사항의 개요입니다." #: ../../rect.rst:41 d393f3a6d9de4c8fa2e06182c5f78760 msgid "Notion" msgstr "개념" #: ../../rect.rst:41 d97438c124b14f35aa198e1ddfb8cfd0 msgid "Versions < 1.19.0" msgstr "버전 < 1.19.0" #: ../../rect.rst:41 7af7abdfb7bc4aa4b28ed21073d90bea msgid "Versions 1.19.*" msgstr "버전 1.19.*" #: ../../rect.rst:43 e4224c064e3f4f68bbb16f57e9a1c844 msgid "empty" msgstr "비어 있음" #: ../../rect.rst:43 48dde36927434fceacc3a177956672c7 msgid "x0 = x1 or y0 = y1" msgstr "x0 = x1 또는 y0 = y1" #: ../../rect.rst:43 3835fcc0738d40929f1271a1c05290b9 msgid "x0 >= x1 or y0 >= y1 -- includes invalid rects" msgstr "x0 >= x1 또는 y0 >= y1 -- 무효한 사각형 포함" #: ../../rect.rst:44 f6c28fec698849cf9309e6c849791287 msgid "valid" msgstr "유효" #: ../../rect.rst:44 754108a5de3646168f6a70e07a111bd9 msgid "n/a" msgstr "해당 없음" #: ../../rect.rst:44 e09f640fd0134a039d61766e33a9c329 msgid "x0 <= x1 and y0 <= y1" msgstr "x0 <= x1 및 y0 <= y1" #: ../../rect.rst:45 17a59c383cd546c8adfe6a7d8ef48da9 msgid "infinite" msgstr "무한" #: ../../rect.rst:45 65113a7b423f4f98b9ce9fcada710d50 msgid "all rects where x0 > x1 or y1 > y0" msgstr "x0 > x1 또는 y1 > y0인 모든 사각형" #: ../../rect.rst:45 41c40bda2ada47e085b2f7f2004a8b76 msgid "**exactly one infinite rect / irect!**" msgstr "**정확히 하나의 무한 rect / irect!**" #: ../../rect.rst:46 4f4ac3d83ad64ebba6176c33b68c4cb3 msgid "coordinate values" msgstr "좌표 값" #: ../../rect.rst:46 453a3c51c1434dc5b1579f747187deb0 msgid "all numbers" msgstr "모든 숫자" #: ../../rect.rst:46 4ca5d71efdb04d8693a83e57697d9d37 msgid "`FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT`" msgstr "`FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT`" #: ../../rect.rst:47 2209987532a249858e55c63d07e52b9c msgid "borders, corners" msgstr "경계, 모서리" #: ../../rect.rst:47 b6ae01c480064de9b11987d6892db4ca msgid "are parts of the rectangle" msgstr "사각형의 일부" #: ../../rect.rst:47 8ef673ab0bbc4257baaeffbe19220f28 msgid "right and bottom corners and edges **are outside**" msgstr "오른쪽 및 아래쪽 모서리와 가장자리는 **외부**" #: ../../rect.rst:50 e3e932700fd949daa0353b543c8a1a4c msgid "" "There are new top level functions defining infinite and standard empty " "rectangles and quads, see :meth:`INFINITE_RECT` and friends." msgstr "무한 및 표준 빈 사각형과 quad를 정의하는 새로운 최상위 함수가 있습니다. :meth:`INFINITE_RECT` 및 관련 항목을 참조하세요." #: ../../rect.rst:54 81a610b0aa1f472b8ae9fea35a2a2c01 msgid "**Methods / Attributes**" msgstr "**메서드 / 속성**" #: ../../rect.rst:54 4ed08c7116224212b88dc25acd42d0b0 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../rect.rst:56 5981a119a05e4daa876289ac03fc5a13 msgid ":meth:`Rect.contains`" msgstr ":meth:`Rect.contains`" #: ../../rect.rst:56 3b511deb4033483dbea1c5c304c2ec6f msgid "checks containment of point_likes and rect_likes" msgstr "point_like 및 rect_like의 포함 여부 확인" #: ../../rect.rst:57 9f5f335e79444316a8a3c6dea665cf95 msgid ":meth:`Rect.get_area`" msgstr ":meth:`Rect.get_area`" #: ../../rect.rst:57 1de8d41280804dcf9822b29195cfe5fe msgid "calculate rectangle area" msgstr "사각형 영역 계산" #: ../../rect.rst:58 7a22090e4a0d467a8ad2400c55ed9f2f msgid ":meth:`Rect.include_point`" msgstr ":meth:`Rect.include_point`" #: ../../rect.rst:58 0526b2070f7e45feab7a311c9ee31128 msgid "enlarge rectangle to also contain a point" msgstr "점도 포함하도록 사각형 확대" #: ../../rect.rst:59 5d2792546865489e8ac28d97886676fb msgid ":meth:`Rect.include_rect`" msgstr ":meth:`Rect.include_rect`" #: ../../rect.rst:59 d9b74ad40df64c1da33f10578102b172 msgid "enlarge rectangle to also contain another one" msgstr "다른 사각형도 포함하도록 사각형 확대" #: ../../rect.rst:60 a084869227454408971a27d515578280 msgid ":meth:`Rect.intersect`" msgstr ":meth:`Rect.intersect`" #: ../../rect.rst:60 fc0d24eaf262443a9767ab3a639a91cf msgid "common part with another rectangle" msgstr "다른 사각형과의 공통 부분" #: ../../rect.rst:61 783c6bb9f98a4c9a9173a33426e15261 msgid ":meth:`Rect.intersects`" msgstr ":meth:`Rect.intersects`" #: ../../rect.rst:61 48c32f08f9bd4fcaba35388fa46ffb7d msgid "checks for non-empty intersections" msgstr "비어 있지 않은 교집합 확인" #: ../../rect.rst:62 54b41e15307745659f567a94fe69654b msgid ":meth:`Rect.morph`" msgstr ":meth:`Rect.morph`" #: ../../rect.rst:62 2724138758314afea0cd2a6f82c22cdd msgid "transform with a point and a matrix" msgstr "점과 행렬로 변환" #: ../../rect.rst:63 fa29117650a04cf992bfbf167039b34d msgid ":meth:`Rect.torect`" msgstr ":meth:`Rect.torect`" #: ../../rect.rst:63 a1b856036d3a4a869c4bfef61e84bc7d msgid "the matrix that transforms to another rectangle" msgstr "다른 사각형으로 변환하는 행렬" #: ../../rect.rst:64 eb541dbc3c38455b94ddf221f6366d80 msgid ":meth:`Rect.norm`" msgstr ":meth:`Rect.norm`" #: ../../rect.rst:64 61a0e738f2784973be15065b6e9b3bf2 msgid "the Euclidean norm" msgstr "유클리드 노름" #: ../../rect.rst:65 e9cec2f1207b4e358bcb22df6331bb76 msgid ":meth:`Rect.normalize`" msgstr ":meth:`Rect.normalize`" #: ../../rect.rst:65 8ba545c6dd824fd08fd072a2c568c6db msgid "makes a rectangle valid" msgstr "사각형을 유효하게 만듦" #: ../../rect.rst:66 ebfc99cce7a74afabc7adf051e9804cc msgid ":meth:`Rect.round`" msgstr ":meth:`Rect.round`" #: ../../rect.rst:66 a5ff1b1dfaf54324b20c6908d06f2c7e msgid "create smallest :ref:`Irect` containing rectangle" msgstr "사각형을 포함하는 가장 작은 :ref:`Irect` 생성" #: ../../rect.rst:67 9c630cfbce96430dbd549ce3edbf5de2 msgid ":meth:`Rect.transform`" msgstr ":meth:`Rect.transform`" #: ../../rect.rst:67 3294ada857004ea2801a93dcdcae9cbb msgid "transform rectangle with a matrix" msgstr "행렬로 사각형 변환" #: ../../rect.rst:68 00f6aca11ba74d9290a39ae6e4d9abdb msgid ":attr:`Rect.bottom_left`" msgstr ":attr:`Rect.bottom_left`" #: ../../rect.rst:68 d8d4c9d808554a389d40caa0c16d5a69 msgid "bottom left point, synonym *bl*" msgstr "왼쪽 아래 점, 동의어 *bl*" #: ../../rect.rst:69 82732f58f72f413b869e3dbe3fc017dd msgid ":attr:`Rect.bottom_right`" msgstr ":attr:`Rect.bottom_right`" #: ../../rect.rst:69 25213177c72349529fffc2b8650278c6 msgid "bottom right point, synonym *br*" msgstr "오른쪽 아래 점, 동의어 *br*" #: ../../rect.rst:70 dee76b0bf2084300ae141c9fc27008bb msgid ":attr:`Rect.height`" msgstr ":attr:`Rect.height`" #: ../../rect.rst:70 7fec492b654e4a6c8f203435ebdcb0e3 msgid "rectangle height" msgstr "사각형 높이" #: ../../rect.rst:71 948cec288c54453aa28f00e584acce0b msgid ":attr:`Rect.irect`" msgstr ":attr:`Rect.irect`" #: ../../rect.rst:71 a1899a79673d49c5a4273f091b474322 msgid "equals result of method *round()*" msgstr "메서드 *round()* 의 결과와 같음" #: ../../rect.rst:72 d60c028c8e234efe9a338e184bb6bc55 msgid ":attr:`Rect.is_empty`" msgstr ":attr:`Rect.is_empty`" #: ../../rect.rst:72 95f758bc9cc644d6a61e703bee39b954 msgid "whether rectangle is empty" msgstr "사각형이 비어 있는지 여부" #: ../../rect.rst:73 3d96f5aae5a54e4eac8a41dc8027ebe2 msgid ":attr:`Rect.is_valid`" msgstr ":attr:`Rect.is_valid`" #: ../../rect.rst:73 0d07626ab6d5457c93ed36d852fe9dc5 msgid "whether rectangle is valid" msgstr "사각형이 유효한지 여부" #: ../../rect.rst:74 ec6784767db149e1af2d3bed517a3154 msgid ":attr:`Rect.is_infinite`" msgstr ":attr:`Rect.is_infinite`" #: ../../rect.rst:74 e2775e5155c94511a9a0b4351aa5aeed msgid "whether rectangle is infinite" msgstr "사각형이 무한한지 여부" #: ../../rect.rst:75 27198e6de32c47129ff1d90e9bcd052b msgid ":attr:`Rect.top_left`" msgstr ":attr:`Rect.top_left`" #: ../../rect.rst:75 991fbeb519074c779da08190535db4a5 msgid "top left point, synonym *tl*" msgstr "왼쪽 위 점, 동의어 *tl*" #: ../../rect.rst:76 ee1026c3112e4ce5ace785e6dbd51983 msgid ":attr:`Rect.top_right`" msgstr ":attr:`Rect.top_right`" #: ../../rect.rst:76 a429e926fb354c3eacca067673ad17f3 msgid "top_right point, synonym *tr*" msgstr "오른쪽 위 점, 동의어 *tr*" #: ../../rect.rst:77 5a5eef69cfdd4fc1b267e64d1899c83d msgid ":attr:`Rect.quad`" msgstr ":attr:`Rect.quad`" #: ../../rect.rst:77 39bf27b7ec18496996041d704db52fa2 msgid ":ref:`Quad` made from rectangle corners" msgstr "사각형 모서리로 만든 :ref:`Quad`" #: ../../rect.rst:78 b77feb74e6d84afe86da1aa9ffd1d688 msgid ":attr:`Rect.width`" msgstr ":attr:`Rect.width`" #: ../../rect.rst:78 ba35625a52bb44278539861d0133f079 msgid "rectangle width" msgstr "사각형 너비" #: ../../rect.rst:79 38859d042e6f49b88c35544ec6e4ed3c msgid ":attr:`Rect.x0`" msgstr ":attr:`Rect.x0`" #: ../../rect.rst:79 7e53ad8c6a824feca26905c64f3e0ea3 msgid "left corners' x coordinate" msgstr "왼쪽 모서리의 x 좌표" #: ../../rect.rst:80 f4f68e6053a840c2a566cf242d7f05b1 msgid ":attr:`Rect.x1`" msgstr ":attr:`Rect.x1`" #: ../../rect.rst:80 b53b5091498c454d88765a544d585de5 msgid "right corners' x -coordinate" msgstr "오른쪽 모서리의 x 좌표" #: ../../rect.rst:81 91c7514c010f464098de9b6e9007f4a8 msgid ":attr:`Rect.y0`" msgstr ":attr:`Rect.y0`" #: ../../rect.rst:81 119b6bb77d59497fa78ea76552d86acd msgid "top corners' y coordinate" msgstr "위쪽 모서리의 y 좌표" #: ../../rect.rst:82 45436c8c00564776b422a0208c48ae3d msgid ":attr:`Rect.y1`" msgstr ":attr:`Rect.y1`" #: ../../rect.rst:82 251741ae294247ddadf61d053276d89f msgid "bottom corners' y coordinate" msgstr "아래쪽 모서리의 y 좌표" #: ../../rect.rst:85 d211a7b97cc54d93b48553a9425130b9 msgid "**Class API**" msgstr "**클래스 API**" #: ../../rect.rst:103 01827e33142142419f360c9f35834288 msgid "" "Overloaded constructors: *top_left*, *bottom_right* stand for " ":data:`point_like` objects, \"sequence\" is a Python sequence type of 4 " "numbers (see :ref:`SequenceTypes`), \"rect\" means another " ":data:`rect_like`, while the other parameters mean coordinates." msgstr "오버로드된 생성자: *top_left*, *bottom_right* 는 :data:`point_like` 객체를 나타내고, \"sequence\"는 4개의 숫자로 구성된 Python 시퀀스 유형(:ref:`SequenceTypes` 참조)이며, \"rect\"는 다른 :data:`rect_like` 를 의미하고, 다른 매개변수는 좌표를 의미합니다." #: ../../rect.rst:105 e075a06a3e264a5fbf6aea37d81f20d9 msgid "If \"rect\" is specified, the constructor creates a **new copy** of it." msgstr "\"rect\"가 지정되면 생성자는 그것의 **새 복사본** 을 만듭니다." #: ../../rect.rst:107 1f9d77ad703345a2a3964ae75caea048 msgid "" "Without parameters, the empty rectangle ``Rect(0.0, 0.0, 0.0, 0.0)`` is " "created." msgstr "매개변수 없이 빈 사각형 ``Rect(0.0, 0.0, 0.0, 0.0)`` 이 생성됩니다." #: ../../rect.rst:111 f10e380576a7412d80886a3b8a51700e msgid "" "Creates the smallest containing :ref:`IRect`. This is **not the same** as" " simply rounding the rectangle's edges: The top left corner is rounded " "upwards and to the left while the bottom right corner is rounded " "downwards and to the right." msgstr "가장 작은 포함 :ref:`IRect` 를 생성합니다. 이것은 단순히 사각형의 가장자리를 반올림하는 것과 **동일하지 않습니다**: 왼쪽 위 모서리는 위쪽과 왼쪽으로 반올림되고 오른쪽 아래 모서리는 아래쪽과 오른쪽으로 반올림됩니다." #: ../../rect.rst:116 552d25bc341a48aba138b957a55b9e83 msgid "If the rectangle is **empty**, the result is also empty." msgstr "사각형이 **비어 있으면** 결과도 비어 있습니다." #: ../../rect.rst:117 df26f93d58284c6a970ae3863ef681bb msgid "" "**Possible paradox:** The result may be empty, **even if** the rectangle " "is **not** empty! In such cases, the result obviously does **not** " "contain the rectangle. This is because MuPDF's algorithm allows for a " "small tolerance (1e-3). Example:" msgstr "**가능한 역설:** 사각형이 **비어 있지 않아도** 결과가 비어 있을 수 있습니다! 이러한 경우 결과는 명백히 사각형을 **포함하지 않습니다**. 이것은 MuPDF의 알고리즘이 작은 허용 오차(1e-3)를 허용하기 때문입니다. 예:" #: ../../rect.rst 223b51190466453684b2185f3dfc69c0 #: 297e474bcf4f49858a23f80dd7128c65 388342f8d94e4d26b238b48872bd5511 #: 4f188f0a74b347a8ba82283a386abbde 6c7f84d51c1c4b3b9dcf69c73a6d6715 #: 6f729bc4a8b948998da46a928feb54e6 96b897da73d141458d7b0fa47bb6846a #: f8ae67a6da5847d7838f6d57ffbba97e msgid "Return type" msgstr "반환 유형" #: ../../rect.rst:127 31c287fef6e3445cafe94d866b5e73bf msgid ":ref:`IRect`" msgstr ":ref:`IRect`" #: ../../rect.rst:131 c8c2cfc194a8468fa9550492f440f872 msgid "" "Transforms the rectangle with a matrix and **replaces the original**. If " "the rectangle is empty or infinite, this is a no-operation." msgstr "행렬로 사각형을 변환하고 **원본을 대체** 합니다. 사각형이 비어 있거나 무한이면 아무 작업도 수행하지 않습니다." #: ../../rect.rst 1769e651f3b64df78e388f49683edfc2 #: 312414a60f5241d7abaee3b012e0c7f4 54d06860552f4fa4bf1e92782d2b517a #: aecbea35a63240b7bb02c03f083daacf d9b739a44f4b427b9772f8da4198b7b3 #: dca5e2461b874ed6ac599ed5bf67591e dd42b3800611490e9091e6942a813e85 #: e64ab107750d4908974794940a14b516 f9eb8fc37f314b86bb12b6037ad64aca msgid "Parameters" msgstr "매개변수" #: ../../rect.rst:133 17bbbee58ca246578928bb7c3f404ef5 msgid "The matrix for the transformation." msgstr "변환을 위한 행렬." #: ../../rect.rst:136 5b54b6fd35e047b9b19b8e92d649c886 msgid "``Rect``" msgstr "``Rect``" #: ../../rect.rst ad2d6666f58d4edab133c0b63812dad1 #: ee287750d1ff4757a1f4aab28350cc3f f617b587a6e84a1d879ad6eb2a4b8163 msgid "Returns" msgstr "반환값" #: ../../rect.rst:137 9310c42c457243d2adf6a8ef7e65abb4 msgid "the smallest rectangle that contains the transformed original." msgstr "변환된 원본을 포함하는 가장 작은 사각형." #: ../../rect.rst:141 515fef48ca8a47adbebb14b402eb85f4 msgid "" "The intersection (common rectangular area, largest rectangle contained in" " both) of the current rectangle and *r* is calculated and **replaces the " "current** rectangle. If either rectangle is empty, the result is also " "empty. If *r* is infinite, this is a no-operation. If the rectangles are " "(mathematically) disjoint sets, then the result is invalid. If the result" " is valid but empty, then the rectangles touch each other in a corner or " "(part of) a side." msgstr "현재 사각형과 *r* 의 교집합(공통 사각형 영역, 둘 다에 포함된 가장 큰 사각형)이 계산되어 **현재** 사각형을 **대체** 합니다. 사각형 중 하나가 비어 있으면 결과도 비어 있습니다. *r* 이 무한이면 아무 작업도 수행하지 않습니다. 사각형이 (수학적으로) 서로소 집합이면 결과는 무효입니다. 결과가 유효하지만 비어 있으면 사각형은 모서리 또는 (일부) 변에서 서로 접촉합니다." #: ../../rect.rst:143 ../../rect.rst:150 5ae4d4eaacb44add974c0aa6cf33f6f8 #: cb94768c038d40d6be30db81f8988f9e msgid "Second rectangle" msgstr "두 번째 사각형" #: ../../rect.rst:148 db7d498e829c4302919da10e026d8ac5 msgid "" "The smallest rectangle containing the current one and ``r`` is calculated" " and **replaces the current** one. If either rectangle is infinite, the " "result is also infinite. If ``r`` is empty, the current rectangle remains" " unchanged. Else if the current rectangle is empty, it is replaced by " "``r``." msgstr "현재 사각형과 ``r`` 을 포함하는 가장 작은 사각형이 계산되어 **현재** 사각형을 **대체** 합니다. 사각형 중 하나가 무한이면 결과도 무한입니다. ``r`` 이 비어 있으면 현재 사각형은 변경되지 않습니다. 현재 사각형이 비어 있으면 ``r`` 로 대체됩니다." #: ../../rect.rst:155 d539db24271d4c00bd98e51fb2c3f2ab msgid "" "The smallest rectangle containing the current one and :data:`point_like` " "``p`` is calculated and **replaces the current** one. **The infinite " "rectangle remains unchanged.** To create the rectangle that wraps a " "sequence of points, start with :meth:`EMPTY_RECT` and successively " "include the members of the sequence." msgstr "현재 사각형과 :data:`point_like` ``p`` 를 포함하는 가장 작은 사각형이 계산되어 **현재** 사각형을 **대체** 합니다. **무한 사각형은 변경되지 않습니다.** 점 시퀀스를 감싸는 사각형을 만들려면 :meth:`EMPTY_RECT` 로 시작하여 시퀀스의 멤버를 순차적으로 포함하세요." #: ../../rect.rst:157 6a72290dd49345a0a63b3757d59663ca msgid "Point to include." msgstr "포함할 점." #: ../../rect.rst:163 ba33391fc40040a4a994136d913ee366 msgid "" "Calculate the area of the rectangle and, with no parameter, equals " "*abs(rect)*. Like an empty rectangle, the area of an infinite rectangle " "is also zero. So, at least one of *pymupdf.Rect(p1, p2)* and " "*pymupdf.Rect(p2, p1)* has a zero area." msgstr "사각형의 영역을 계산하며, 매개변수 없이는 *abs(rect)* 와 같습니다. 빈 사각형과 마찬가지로 무한 사각형의 영역도 0입니다. 따라서 *pymupdf.Rect(p1, p2)* 와 *pymupdf.Rect(p2, p1)* 중 적어도 하나는 영역이 0입니다." #: ../../rect.rst:165 6f367ec895b04a5282f232e658390010 msgid "" "Specify required unit: respective squares of *px* (pixels, default), *in*" " (inches), *cm* (centimeters), or *mm* (millimeters)." msgstr "필요한 단위 지정: *px* (픽셀, 기본값), *in* (인치), *cm* (센티미터) 또는 *mm* (밀리미터)의 각각의 제곱." #: ../../rect.rst:170 f1fdbdae13644bca9624eea1bed293ba msgid "" "Checks whether *x* is contained in the rectangle. It may be an *IRect*, " "*Rect*, *Point* or number. If *x* is an empty rectangle, this is always " "true. If the rectangle is empty this is always ``False`` for all non-" "empty rectangles and for all points. `x in rect` and `rect.contains(x)` " "are equivalent." msgstr "*x* 가 사각형에 포함되어 있는지 확인합니다. 이것은 *IRect*, *Rect*, *Point* 또는 숫자일 수 있습니다. *x* 가 빈 사각형이면 이것은 항상 true입니다. 사각형이 비어 있으면 모든 비어 있지 않은 사각형과 모든 점에 대해 이것은 항상 ``False`` 입니다. `x in rect` 와 `rect.contains(x)` 는 동일합니다." #: ../../rect.rst:172 ca3270a90eac40a4bbb2ec88e8547446 msgid "the object to check." msgstr "확인할 객체." #: ../../rect.rst:179 a2c14b05b36d4decbe4367b3aa764e2f msgid "" "Checks whether the rectangle and a :data:`rect_like` \"r\" contain a " "common non-empty :ref:`Rect`. This will always be ``False`` if either is " "infinite or empty." msgstr "사각형과 :data:`rect_like` \"r\"이 공통의 비어 있지 않은 :ref:`Rect` 를 포함하는지 확인합니다. 둘 중 하나가 무한이거나 비어 있으면 이것은 항상 ``False`` 입니다." #: ../../rect.rst:181 fd7c3c60afa7402f98f4d782416f106d msgid "the rectangle to check." msgstr "확인할 사각형." #: ../../rect.rst:187 a9fe2a547ab44768a39b47d8d9ef868e msgid "New in version 1.19.3" msgstr "버전 1.19.3에서 새로 추가됨" #: ../../rect.rst:189 d15a89c433be470288ee2017503a040f msgid "Compute the matrix which transforms this rectangle to a given one." msgstr "이 사각형을 주어진 사각형으로 변환하는 행렬을 계산합니다." #: ../../rect.rst:191 7492eabbe7d24bdba52f9f8ead663bcd msgid "the target rectangle. Must not be empty or infinite." msgstr "대상 사각형. 비어 있거나 무한이 아니어야 합니다." #: ../../rect.rst:192 1d5dde507c8b434e94689248050663f0 msgid ":ref:`Matrix`" msgstr ":ref:`Matrix`" #: ../../rect.rst:193 fc8cb54b6f794b9ca05b2b2fb57c5290 msgid "" "a matrix `mat` such that `self * mat = rect`. Can for example be used to " "transform between the page and the pixmap coordinates. See an example use" " here :ref:`RecipesImages_P`." msgstr "`self * mat = rect` 가 되는 행렬 `mat`. 예를 들어 페이지와 픽셀맵 좌표 간 변환에 사용할 수 있습니다. 사용 예는 :ref:`RecipesImages_P` 를 참조하세요." #: ../../rect.rst:197 6bfb5ec48e4742898de3cb22ba429c99 msgid "New in version 1.17.0" msgstr "버전 1.17.0에서 새로 추가됨" #: ../../rect.rst:199 33c676862f1241db9159e7a0b76a9f67 msgid "" "Return a new quad after applying a matrix to the rectangle using the " "fixed point `fixpoint`." msgstr "고정점 `fixpoint` 를 사용하여 사각형에 행렬을 적용한 후 새 quad를 반환합니다." #: ../../rect.rst:201 c4251e2f175d41d48a4e66ee81b8a2a0 msgid "the fixed point." msgstr "고정점." #: ../../rect.rst:202 3597e1c1f5d84296b016ca74793b5554 msgid "the matrix." msgstr "행렬." #: ../../rect.rst:203 e7dca746738f46ff95c1c3f83513868b msgid "" "a new :ref:`Quad`. This a wrapper for the same-named quad method. If " "infinite, the infinite quad is returned." msgstr "새 :ref:`Quad`. 이것은 동일한 이름의 quad 메서드의 래퍼입니다. 무한이면 무한 quad가 반환됩니다." #: ../../rect.rst:207 f0e8c79473044506bfc164d658cd0559 msgid "New in version 1.16.0" msgstr "버전 1.16.0에서 새로 추가됨" #: ../../rect.rst:209 5675696559db481c8264784ff3dc7467 msgid "" "Return the Euclidean norm of the rectangle treated as a vector of four " "numbers." msgstr "4개의 숫자 벡터로 처리된 사각형의 유클리드 노름을 반환합니다." #: ../../rect.rst:213 d5b4c7b243b04370ad7717618f6af173 msgid "" "**Replace** the rectangle with its valid version. This is done by " "shuffling the rectangle corners. After completion of this method, the " "bottom right corner will indeed be south-eastern to the top left one (but" " may still be empty)." msgstr "사각형을 유효한 버전으로 **대체** 합니다. 이것은 사각형 모서리를 재배치하여 수행됩니다. 이 메서드 완료 후, 오른쪽 아래 모서리는 실제로 왼쪽 위 모서리의 남동쪽이 됩니다(하지만 여전히 비어 있을 수 있습니다)." #: ../../rect.rst:217 55f5202f243c431cb4a6aae82d228176 msgid "Equals result of method *round()*." msgstr "메서드 *round()* 의 결과와 같습니다." #: ../../rect.rst:223 8ce16ab6c7df44f5abb8f92883c8d5c5 msgid "Equals *Point(x0, y0)*." msgstr "*Point(x0, y0)* 와 같습니다." #: ../../rect.rst 140ba1c8d224453686c608739d150b66 #: 17b10802a6f2405c86d6e263e499d22f 5444bac90c254f1c84d6fe7c0e28890d #: 5bacf55f6fdc41e0a4eaecf91679d95d 5e0076fec68344b9b5094a29a7778e51 #: 6362dacd20114c8e8d8beda49463e502 7bdb41b9074b4fe8b70f89b3feb982f8 #: 8b32b0a8f85c488f8622250501ee942a 9ebaad019109481ebcf4ddd743d67f01 #: d8d182de61d74096abf1ed76f13825b2 dd68eb47fe4f425fb08826a909877002 #: f6c692b144934eb0ba0bbce5f99825bf msgid "type" msgstr "유형" #: ../../rect.rst:225 ../../rect.rst:233 ../../rect.rst:241 ../../rect.rst:249 #: 3bb0a2aad0b34e11b52697850a333f20 403eb084f6f64eb590a9e0627f324bc1 #: 8690457d8ba940b09ec2249670a3ef5b 93767b206e804fd582e4db28c1eb3219 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../rect.rst:231 62f995500f554a04a83c5d7392c75231 msgid "Equals `Point(x1, y0)`." msgstr "`Point(x1, y0)` 와 같습니다." #: ../../rect.rst:239 4b524e88114c4a3d9795ac77e101aac6 msgid "Equals `Point(x0, y1)`." msgstr "`Point(x0, y1)` 와 같습니다." #: ../../rect.rst:247 c781f4a98d33484a8fd5eeb72de6719e msgid "Equals `Point(x1, y1)`." msgstr "`Point(x1, y1)` 와 같습니다." #: ../../rect.rst:253 4fdbb1259b894b85abf811e41bf30f7f msgid "The quadrilateral `Quad(rect.tl, rect.tr, rect.bl, rect.br)`." msgstr "사각형 `Quad(rect.tl, rect.tr, rect.bl, rect.br)`." #: ../../rect.rst:255 a29713ba4e8a43c290093038d033627b msgid ":ref:`Quad`" msgstr ":ref:`Quad`" #: ../../rect.rst:259 a19815eed800437580d69960abffb442 msgid "Width of the rectangle. Equals `max(x1 - x0, 0)`." msgstr "사각형의 너비. `max(x1 - x0, 0)` 와 같습니다." #: ../../rect.rst:265 19c9fc7532244739bb242fc281fe9ab4 msgid "Height of the rectangle. Equals `max(y1 - y0, 0)`." msgstr "사각형의 높이. `max(y1 - y0, 0)` 와 같습니다." #: ../../rect.rst:271 e9d9d68a615844588179b0a9c4ddb63d msgid "X-coordinate of the left corners." msgstr "왼쪽 모서리의 X 좌표." #: ../../rect.rst:273 ../../rect.rst:279 ../../rect.rst:285 ../../rect.rst:291 #: 3159fff4ace944f5b28b66c85c40a391 595d30cddc2441798812da3e6aa60405 #: 7d4d519c37524ecd93c59a92f14a52ee c3f30ece20574d289dd0729b1555cb67 msgid "float" msgstr "float" #: ../../rect.rst:277 ef85ef105e694e3faab5ca56c0e0eecb msgid "Y-coordinate of the top corners." msgstr "위쪽 모서리의 Y 좌표." #: ../../rect.rst:283 01de9b8a52134ea9893026eb6219e2ed msgid "X-coordinate of the right corners." msgstr "오른쪽 모서리의 X 좌표." #: ../../rect.rst:289 0324e83243014e8facb3691297c10edd msgid "Y-coordinate of the bottom corners." msgstr "아래쪽 모서리의 Y 좌표." #: ../../rect.rst:295 63c3980c456449ab98ca919497d7ee18 msgid "`True` if this is the infinite rectangle." msgstr "이것이 무한 사각형이면 `True`." #: ../../rect.rst:297 ../../rect.rst:303 ../../rect.rst:309 #: 84e580180c7c4388939f1b2876f6eb67 9aaf58f7198848dc9acfe4b42c84ad6f #: b9b7f26129e94195801107367cb7fbcc msgid "bool" msgstr "bool" #: ../../rect.rst:301 18ecd70d16ed40779b23464233b589ed msgid "`True` if rectangle is empty." msgstr "사각형이 비어 있으면 `True`." #: ../../rect.rst:307 472d89b6e5324c3487cd59bb9818711c msgid "`True` if rectangle is valid." msgstr "사각형이 유효하면 `True`." #: ../../rect.rst:313 9531f9684b3d4fe5add3912c57ef0e6a msgid "" "This class adheres to the Python sequence protocol, so components can be " "accessed via their index, too. Also refer to :ref:`SequenceTypes`." msgstr "이 클래스는 Python 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 액세스할 수도 있습니다. :ref:`SequenceTypes` 도 참조하세요." #: ../../rect.rst:314 a8f439886c4540a88cfb3aa32cee5363 msgid "" "Rectangles can be used with arithmetic operators -- see chapter " ":ref:`Algebra`." msgstr "사각형은 산술 연산자와 함께 사용할 수 있습니다 -- :ref:`Algebra` 장을 참조하세요." #: ../../footer.rst:46 7bc9c45a377e4124a0eb39872343423a msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/resources.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 ed18d6f38b3341f2bde92874aa4bc5d5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 e9efbd58e1724907a6662c6a6d1443ed msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 f0d9191b949d4c7aaf99c05b1e804afe msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../resources.rst:6 29588c8ac283422b8882c226d20d5624 msgid "Resources" msgstr "리소스" #: ../../resources.rst:9 226156d6aa574ae49ebbc29f7cc0ef0d msgid "**PyMuPDF Pro**" msgstr "**PyMuPDF Pro**" #: ../../resources.rst:12 67c0d5d5d80c4878907a81eb3091f9c3 msgid "For **Office** file support `try PyMuPDF Pro `." msgstr "**Office** 파일 지원을 위해 `PyMuPDF Pro ` 를 사용해 보세요." #: ../../resources.rst:20 28881f0ff7624205aac76bf0a54670e2 msgid "Find out about **PyMuPDF Utilities**" msgstr "**PyMuPDF Utilities** 에 대해 알아보기" #: ../../resources.rst:22 a5cac2a3beb04e638f4ab889c042bce1 msgid "" "The :title:`GitHub` repository `PyMuPDF-Utilities " "`_ contains a full range of" " examples, demonstrations and use cases." msgstr ":title:`GitHub` 저장소 `PyMuPDF-Utilities `_ 에는 다양한 예제, 데모 및 사용 사례가 포함되어 있습니다." #: ../../resources.rst:31 ae915eee85a646ed938c77e4ca278e0f msgid "Do you need |PDF| to **DOCX** conversion?" msgstr "|PDF| 를 **DOCX** 로 변환이 필요하신가요?" #: ../../resources.rst:33 38b205c29ae545f79e6de0b8dda5b6a8 msgid "" "We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-" "docx** library to provide simple document conversion from |PDF| to " "**DOCX** format." msgstr "|PDF| 에서 **DOCX** 형식으로의 간단한 문서 변환을 제공하기 위해 |PyMuPDF| 와 **python-docx** 라이브러리를 사용하는 pdf2docx_ 라이브러리를 권장합니다." #: ../../footer.rst:46 26ed59be763d4fe5a9384c80731d8341 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/shape.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 7909b1fec71a4bb1918715ca5918f604 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 87466d36d4244b14b06775988b5a86da msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 c4e019a1ef45475794222706f39fa6bd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../shape.rst:6 a9435293f59542b2850588abf5b6a5c0 msgid "Shape" msgstr "Shape" #: ../../shape.rst:8 c22618002fb44404a4ac660d7663c2a9 msgid "|pdf_only_class|" msgstr "|pdf_only_class|" #: ../../shape.rst:10 83f7ae44343b4e29b36be26c67c582a7 msgid "" "This class allows creating interconnected graphical elements on a PDF " "page. Its methods have the same meaning and name as the corresponding " ":ref:`Page` methods." msgstr "이 클래스는 PDF 페이지에서 상호 연결된 그래픽 요소를 생성할 수 있게 합니다. 메서드는 해당 :ref:`Page` 메서드와 동일한 의미와 이름을 가집니다." #: ../../shape.rst:12 1687c125d94c4a889d4123d18b33a654 msgid "" "In fact, each :ref:`Page` draw method is just a convenience wrapper for " "(1) one shape draw method, (2) the :meth:`Shape.finish` method, and (3) " "the :meth:`Shape.commit` method. For page text insertion, only the " ":meth:`Shape.commit` method is invoked. If many draw and text operations " "are executed for a page, you should always consider using a Shape object." msgstr "실제로 각 :ref:`Page` draw 메서드는 (1) 하나의 shape draw 메서드, (2) :meth:`Shape.finish` 메서드, (3) :meth:`Shape.commit` 메서드에 대한 편의 래퍼입니다. 페이지 텍스트 삽입의 경우 :meth:`Shape.commit` 메서드만 호출됩니다. 페이지에 많은 그리기 및 텍스트 작업이 실행되는 경우 항상 Shape 객체 사용을 고려해야 합니다." #: ../../shape.rst:14 61eb314053054e4e9a36e36845c74ae6 msgid "" "Several draw methods can be executed in a row and each one of them will " "contribute to one drawing. Once the drawing is complete, the " ":meth:`Shape.finish` method must be invoked to apply color, dashing, " "width, morphing and other attributes." msgstr "여러 draw 메서드를 연속으로 실행할 수 있으며 각각이 하나의 그림에 기여합니다. 그림이 완료되면 :meth:`Shape.finish` 메서드를 호출하여 색상, 대시, 너비, 변형 및 기타 속성을 적용해야 합니다." #: ../../shape.rst:16 f3481ff5d87c41998cb0f7de7874cbee msgid "" "**Draw** methods of this class (and :meth:`Shape.insert_textbox`) are " "logging the area they are covering in a rectangle (:attr:`Shape.rect`). " "This property can for instance be used to set " ":attr:`Page.cropbox_position`." msgstr "이 클래스의 **Draw** 메서드(및 :meth:`Shape.insert_textbox`)는 사각형(:attr:`Shape.rect`)에서 덮고 있는 영역을 기록합니다. 이 속성은 예를 들어 :attr:`Page.cropbox_position` 을 설정하는 데 사용할 수 있습니다." #: ../../shape.rst:18 93fc8032a8144e439538867e5d7d9ff1 msgid "" "**Text insertions** :meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox` implicitly execute a \"finish\" and " "therefore only require :meth:`Shape.commit` to become effective. As a " "consequence, both include parameters for controlling properties like " "colors, etc." msgstr "**텍스트 삽입** :meth:`Shape.insert_text` 및 :meth:`Shape.insert_textbox` 는 암시적으로 \"finish\"를 실행하므로 효과를 발휘하려면 :meth:`Shape.commit` 만 필요합니다. 결과적으로 둘 다 색상 등의 속성을 제어하는 매개변수를 포함합니다." #: ../../shape.rst:21 7753ef6a86874229bc626bf090e7fd68 msgid "**Method / Attribute**" msgstr "**Method / Attribute**" #: ../../shape.rst:21 21306cc0a07a4be8b729f6d593a2a25e msgid "**Description**" msgstr "**Description**" #: ../../shape.rst:23 76875c2923b44844919d4f7dbc4ff2ae msgid ":meth:`Shape.commit`" msgstr "" #: ../../shape.rst:23 b6e101dde14a4c0399c2d1e32dfae0e3 msgid "update the page's contents" msgstr "페이지의 콘텐츠 업데이트" #: ../../shape.rst:24 68e32b027b2a42519c263a5d79f0aca5 msgid ":meth:`Shape.draw_bezier`" msgstr "" #: ../../shape.rst:24 cfd73fa2818546d897d3cc7dbf43cb7f msgid "draw a cubic Bezier curve" msgstr "3차 Bezier 곡선 그리기" #: ../../shape.rst:25 4f7b9a227586442b8c80cfc50bb5d2f6 msgid ":meth:`Shape.draw_circle`" msgstr "" #: ../../shape.rst:25 9f885ddec57646dc9618b9b296ef806e msgid "draw a circle around a point" msgstr "점 주위에 원 그리기" #: ../../shape.rst:26 aa0ac0a299bb4cacbdb189b821d1057f msgid ":meth:`Shape.draw_curve`" msgstr "" #: ../../shape.rst:26 444333668308404a995780c7c2ffd1e8 msgid "draw a cubic Bezier using one helper point" msgstr "하나의 보조 점을 사용하여 3차 Bezier 그리기" #: ../../shape.rst:27 1b7d6cc35258460398a82cc2ea5f5017 msgid ":meth:`Shape.draw_line`" msgstr "" #: ../../shape.rst:27 0a76a1b23d26472bb46eaef1b0b11d37 msgid "draw a line" msgstr "선 그리기" #: ../../shape.rst:28 eea95a7b69df4cc6a775a0d4015d87f5 msgid ":meth:`Shape.draw_oval`" msgstr "" #: ../../shape.rst:28 34529e37e99440538218de68e175f373 msgid "draw an ellipse" msgstr "타원 그리기" #: ../../shape.rst:29 8817f8a373594a85a5b96f2658e31d98 msgid ":meth:`Shape.draw_polyline`" msgstr "" #: ../../shape.rst:29 3b98bc2fd12c456c8a2410d43daa8912 msgid "connect a sequence of points" msgstr "점 시퀀스 연결" #: ../../shape.rst:30 4022cf63cc3a496696d3f62c0a2805ab msgid ":meth:`Shape.draw_quad`" msgstr "" #: ../../shape.rst:30 bde0f7baa3e145cda4e9d029099dda80 msgid "draw a quadrilateral" msgstr "사각형 그리기" #: ../../shape.rst:31 c4addcda29c140a6b1975890737ead18 msgid ":meth:`Shape.draw_rect`" msgstr "" #: ../../shape.rst:31 2b173978a5c64357ac1aabcc6e976c73 msgid "draw a rectangle" msgstr "직사각형 그리기" #: ../../shape.rst:32 7f7f34efc2e944109b6c07df81c75430 msgid ":meth:`Shape.draw_sector`" msgstr "" #: ../../shape.rst:32 d5d4937a74fb42b7b20852638b500044 msgid "draw a circular sector or piece of pie" msgstr "원형 섹터 또는 파이 조각 그리기" #: ../../shape.rst:33 880b0c8a153e48fdaa1029e9be76e520 msgid ":meth:`Shape.draw_squiggle`" msgstr "" #: ../../shape.rst:33 da68180d030a4b1fb309de94d47743b1 msgid "draw a squiggly line" msgstr "구불구불한 선 그리기" #: ../../shape.rst:34 9fe45650af3d4e0ca97f2b9d25d87789 msgid ":meth:`Shape.draw_zigzag`" msgstr "" #: ../../shape.rst:34 63c2fdb3045d4b81ae22677572e74fbe msgid "draw a zigzag line" msgstr "지그재그 선 그리기" #: ../../shape.rst:35 c22ba5f6783649118106601684861498 msgid ":meth:`Shape.finish`" msgstr "" #: ../../shape.rst:35 7c247cc071c04f4383953864f5d543ee msgid "finish a set of draw commands" msgstr "그리기 명령 세트 완료" #: ../../shape.rst:36 0ba068100e264e0b9e9ec1f368662d1d msgid ":meth:`Shape.insert_text`" msgstr "" #: ../../shape.rst:36 5dd5770c7a054a66ab3b70a9d530c6f3 msgid "insert text lines" msgstr "텍스트 줄 삽입" #: ../../shape.rst:37 fa4216d497f9485cb9c79fc192a851bf msgid ":meth:`Shape.insert_textbox`" msgstr "" #: ../../shape.rst:37 47ec8b14ef6c4a6d97b355006a0b0b62 msgid "fit text into a rectangle" msgstr "사각형에 텍스트 맞추기" #: ../../shape.rst:38 f1252e5521e147f5bb1c776091ef3328 msgid ":attr:`Shape.doc`" msgstr "" #: ../../shape.rst:38 7f05739c6d0d459aa0631c532353654e msgid "stores the page's document" msgstr "페이지의 문서 저장" #: ../../shape.rst:39 61f46d3f420545e684f380815c9730f3 msgid ":attr:`Shape.draw_cont`" msgstr "" #: ../../shape.rst:39 8a19e4b60bd145ceaa799130f96ab50f msgid "draw commands since last :meth:`Shape.finish`" msgstr "마지막 :meth:`Shape.finish` 이후의 그리기 명령" #: ../../shape.rst:40 dbc1fe5e22804f4291fdc27abafe492f msgid ":attr:`Shape.height`" msgstr "" #: ../../shape.rst:40 a1b344bfa62b474dbecc168b7566abfd msgid "stores the page's height" msgstr "페이지의 높이 저장" #: ../../shape.rst:41 98c50cf9d34b4f1fac07407191336a46 msgid ":attr:`Shape.lastPoint`" msgstr "" #: ../../shape.rst:41 d744e08ab64c4be89b54b91da06292ad msgid "stores the current point" msgstr "현재 점 저장" #: ../../shape.rst:42 3c7b42195cfb495cba0b78bee8af7989 msgid ":attr:`Shape.page`" msgstr "" #: ../../shape.rst:42 94b8094277504a3e865c3fc7a2fbadcf msgid "stores the owning page" msgstr "소유 페이지 저장" #: ../../shape.rst:43 74e41af07b7e49dfb9e8897106da6072 msgid ":attr:`Shape.rect`" msgstr "" #: ../../shape.rst:43 2fd72b972ba64904b71bf6a28bf4aa69 msgid "rectangle surrounding drawings" msgstr "그림을 둘러싸는 사각형" #: ../../shape.rst:44 d662c10c7b284e1a9e8fb0cfacc0af7e msgid ":attr:`Shape.text_cont`" msgstr "" #: ../../shape.rst:44 260872b329274794a91fbe27de9d0fd7 msgid "accumulated text insertions" msgstr "누적된 텍스트 삽입" #: ../../shape.rst:45 260f168374084a0389735532a415f968 msgid ":attr:`Shape.totalcont`" msgstr "" #: ../../shape.rst:45 cca60781247448a6bef1b019d5b03005 msgid "accumulated string to be stored in :data:`contents`" msgstr ":data:`contents` 에 저장될 누적 문자열" #: ../../shape.rst:46 bf5489e997644d1b86ef1a304a20a630 msgid ":attr:`Shape.width`" msgstr "" #: ../../shape.rst:46 320f315bc7e34fb9a224c8104c0490ba msgid "stores the page's width" msgstr "페이지의 너비 저장" #: ../../shape.rst:49 bb77ff1beb1643f1a32fbeb881764556 msgid "**Class API**" msgstr "**Class API**" #: ../../shape.rst:55 f849eb8fe4ea4d84ae176a3bfaddbc5d msgid "" "Create a new drawing. During importing PyMuPDF, the *pymupdf.Page* object" " is being given the convenience method *new_shape()* to construct a " "*Shape* object. During instantiation, a check will be made whether we do " "have a PDF page. An exception is otherwise raised." msgstr "새로운 그림을 생성합니다. |PyMuPDF| 를 가져오는 동안 *pymupdf.Page* 객체에 *Shape* 객체를 구성하기 위한 편의 메서드 *new_shape()* 가 제공됩니다. 인스턴스화 중에 PDF 페이지가 있는지 확인합니다. 그렇지 않으면 예외가 발생합니다." #: ../../shape.rst 1c33018ebf664e5c82016942d1b106b9 #: 1ffb902ffb054dea81b4421598d73d3b 2c7222c93878455593e199cee35f9bc0 #: 526e0601602e4ad294c77828899ee151 652ecb786383456887f3e684eb50a16f #: 8351d111f6ba44c5a48d07b45ecd69ec 8512993c092848e68b405672b0329a5f #: 97750b106384485e9da4b3a178fc8b8a bdcf123cefb04a72ac000f1e6d213cab #: d33f1cb5159441b288aacd2ccae007dd d522a8dc82fa46aaa1bf98571addfab6 #: ec2e6f2b47e543f780ac5d88287a15e3 f4f238ef2bbb4c60a0db78dc6ba48ae3 #: fc6fd8d86630442eac29f0ee69909dd3 msgid "Parameters" msgstr "Parameters" #: ../../shape.rst:57 7af1e6f9a6c54700a96a634680458cf7 msgid "an existing page of a PDF document." msgstr "PDF 문서의 기존 페이지." #: ../../shape.rst:62 76f377d8f0084511ba9e8ab03be15272 msgid "Draw a line from :data:`point_like` objects *p1* to *p2*." msgstr ":data:`point_like` 객체 *p1* 에서 *p2* 까지 선을 그립니다." #: ../../shape.rst:64 ../../shape.rst:78 ../../shape.rst:114 #: 0bd9ca4fa2034c02bba75a1ed84436e8 67a3775d53744800bce979bd9509dae4 #: 6fdeeec1ae7344738df476d7c0995efd msgid "starting point" msgstr "시작점" #: ../../shape.rst:66 ../../shape.rst:80 ../../shape.rst:116 #: 233bc3b5db494f95bd617855177b0ba3 b9a33dfd5ad0434bb5d1681c4ef5477f #: d7a11d5e2d0843bf98b67ccb4c5a1b5c msgid "end point" msgstr "끝점" #: ../../shape.rst 00c99cce86684724a7484f034aead4b9 #: 11b2ce9eb7ac446288dfe432b6af2d66 37b1db5fc557483698f96296fca977a1 #: 398f16080c7c485daf19f594085b75e3 4fb89ac12ab341e98fd2fbfde502762f #: 79c3be157132461c91fbd43f577c6960 7f449ff12a28486c9377d3eae5881abe #: 86a6ff3345b34b99a0b2846ce9b63f97 87752e32bcb84c439a39262387ed43ad #: 8ce97810f50346f1963cb9045d0e3bc9 9a9e08e465d642609b4034f0ac585738 #: e06a173ede194c2499189e3f4ea96d22 f8c5c0c193bf4857a6d61a7fe76a58a0 msgid "Return type" msgstr "Return type" #: ../../shape.rst:68 ../../shape.rst:84 ../../shape.rst:120 #: ../../shape.rst:129 ../../shape.rst:138 ../../shape.rst:157 #: ../../shape.rst:173 ../../shape.rst:185 ../../shape.rst:207 #: ../../shape.rst:224 ../../shape.rst:233 ../../shape.rst:448 #: 02178d1d64304122974cdd7d2eda4e9a 04e3fd71585f46408e34e1b5d2918e9d #: 1b90b951d85a446a9b18d2751aa79908 258641b6956c4c2ebb65129fbc72ae92 #: 2c6a3892b51541d9b2bc4f6aa0613353 318dc522d9764a2e9e4ad48a39be4ebb #: 60c74e5979e14e0e8d70ebeb78df14b9 6b818606a66c4dc494a2fe410d34be22 #: 6f503a8ab6474890be0934600cf2de3b 881f284fe0a54cc180a7ff765822eb7e #: 8b84d3286ddb4519bb3afc99075e83fb f570f468b63940e4b0b9f5890f13db63 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../shape.rst 19bca25aa417451a9d8eb8425f4d7fe5 #: 2d7984c3e8b24f9cacf4f90e2f10a7e0 42bcff3c5d7c4b3ea0f0cff8b94a1936 #: 5725a8009d724bfda07948d7fdd6a975 5ab553dbd9a245ef85863361d3458c06 #: 5baa94cd077f42439269059c4560779d a0d4f65446c742a5b9f88f747fecf574 #: a8b9ec9227c447c7b5b7e475f0ad137b b93d921a09e2475eb2dfecc00159859c #: c9221ebfa6724c35be3fe1b3043dcc84 edda77c9978d4bdc8e49a11220f628de #: fda0a5dbf3e44f70993141cd223cda9f ffd43af87088494c8ab238422d4affeb msgid "Returns" msgstr "Returns" #: ../../shape.rst:69 ../../shape.rst:85 ../../shape.rst:121 #: 03c2703f4c2c4c488c6e1dd5a8bde13f 54fc79ebcc5547368af108398f088aa1 #: d5a893ea1f9f4e6cb959502504cda257 msgid "the end point, *p2*." msgstr "끝점 *p2*." #: ../../shape.rst:76 eed928e2a53b4d0db6454fc9a3031e88 msgid "" "Draw a squiggly (wavy, undulated) line from :data:`point_like` objects " "*p1* to *p2*. An integer number of full wave periods will always be " "drawn, one period having a length of *4 * breadth*. The breadth parameter" " will be adjusted as necessary to meet this condition. The drawn line " "will always turn \"left\" when leaving *p1* and always join *p2* from the" " \"right\"." msgstr ":data:`point_like` 객체 *p1* 에서 *p2* 까지 구불구불한(물결치는, 파형의) 선을 그립니다. 항상 정수 개의 전체 파형 주기가 그려지며, 한 주기의 길이는 *4 * breadth* 입니다. 이 조건을 충족하기 위해 breadth 매개변수가 필요에 따라 조정됩니다. 그려진 선은 *p1* 을 떠날 때 항상 \"왼쪽\"으로 돌고 항상 \"오른쪽\"에서 *p2* 에 합류합니다." #: ../../shape.rst:82 cbee403daaee4a56b9b2f131ff95afb9 msgid "" "the amplitude of each wave. The condition *2 * breadth < abs(p2 - p1)* " "must be true to fit in at least one wave. See the following picture, " "which shows two points connected by one full period." msgstr "각 파형의 진폭. 최소한 하나의 파형을 맞추려면 조건 *2 * breadth < abs(p2 - p1)* 이 참이어야 합니다. 하나의 전체 주기로 연결된 두 점을 보여주는 다음 그림을 참조하세요." #: ../../shape.rst:89 c61f3a8ac2e84d7e88c065f6a80328ac msgid "" "Here is an example of three connected lines, forming a closed, filled " "triangle. Little arrows indicate the stroking direction." msgstr "다음은 닫힌 채워진 삼각형을 형성하는 세 개의 연결된 선의 예입니다. 작은 화살표는 스트로크 방향을 나타냅니다." #: ../../shape.rst:105 3b09c6c0299043ad9e407b82096dc07f msgid "" "Waves drawn are **not** trigonometric (sine / cosine). If you need that, " "have a look at `draw.py `_." msgstr "그려진 파형은 **삼각함수** (사인/코사인)가 **아닙니다**. 그것이 필요하다면 `draw.py `_ 를 참조하세요." #: ../../shape.rst:112 e6d38796d27441ac9eb554ae3567f070 msgid "" "Draw a zigzag line from :data:`point_like` objects *p1* to *p2*. " "Otherwise works exactly like :meth:`Shape.draw_squiggle`." msgstr ":data:`point_like` 객체 *p1* 에서 *p2* 까지 지그재그 선을 그립니다. 그 외에는 :meth:`Shape.draw_squiggle` 과 정확히 동일하게 작동합니다." #: ../../shape.rst:118 2686f76e3e56495ca08bdd2711d1c28e msgid "" "the amplitude of the movement. The condition *2 * breadth < abs(p2 - p1)*" " must be true to fit in at least one period." msgstr "이동의 진폭. 최소한 하나의 주기를 맞추려면 조건 *2 * breadth < abs(p2 - p1)* 이 참이어야 합니다." #: ../../shape.rst:125 bfb5a00ac07547bf822e4b2d95c0f3d7 msgid "" "Draw several connected lines between points contained in the sequence " "*points*. This can be used for creating arbitrary polygons by setting the" " last item equal to the first one." msgstr "시퀀스 *points* 에 포함된 점들 사이에 여러 개의 연결된 선을 그립니다. 마지막 항목을 첫 번째 항목과 같게 설정하여 임의의 다각형을 만드는 데 사용할 수 있습니다." #: ../../shape.rst:127 9afa3278382745228b82849acc3d1db1 msgid "" "a sequence of :data:`point_like` objects. Its length must at least be 2 " "(in which case it is equivalent to *draw_line()*)." msgstr ":data:`point_like` 객체의 시퀀스. 길이는 최소 2여야 합니다(이 경우 *draw_line()* 와 동일함)." #: ../../shape.rst:130 b0f8276e3be04c6996c165c83ed3fdbd msgid "*points[-1]* -- the last point in the argument sequence." msgstr "*points[-1]* -- 인수 시퀀스의 마지막 점." #: ../../shape.rst:134 bf9fc4f7ee704353953bbb497b85a344 msgid "" "Draw a standard cubic Bézier curve from *p1* to *p4*, using *p2* and *p3*" " as control points." msgstr "*p2* 와 *p3* 를 제어점으로 사용하여 *p1* 에서 *p4* 까지 표준 3차 Bézier 곡선을 그립니다." #: ../../shape.rst:136 65ae6d8fa1ca4696b5ceec6e6a33a484 msgid "All arguments are :data:`point_like` objects." msgstr "모든 인수는 :data:`point_like` 객체입니다." #: ../../shape.rst:139 c3bc7d17a1564a259bbccff931fbceb4 msgid "the end point, *p4*." msgstr "끝점 *p4*." #: ../../shape.rst:141 540f633870214c57b214a2d3dc6fad47 msgid "" "The points do not need to be different -- experiment a bit with some of " "them being equal!" msgstr "점들이 달라야 할 필요는 없습니다 -- 일부가 같도록 실험해보세요!" #: ../../shape.rst:143 cc32f6b9b719471e990541995cb91d8a msgid "Example:" msgstr "Example:" #: ../../shape.rst:149 3cd13feab216456fb40eabb0f87476f2 msgid "" "Draw an \"ellipse\" inside the given tetragon (quadrilateral). If it is a" " square, a regular circle is drawn, a general rectangle will result in an" " ellipse. If a quadrilateral is used instead, a plethora of shapes can be" " the result." msgstr "주어진 사각형(사변형) 내에 \"타원\"을 그립니다. 정사각형이면 일반 원이 그려지고, 일반 직사각형이면 타원이 됩니다. 사변형을 사용하면 다양한 모양이 결과가 될 수 있습니다." #: ../../shape.rst:151 3beef81862054f6c9dcfb27abe73062b msgid "" "The drawing starts and ends at the middle point of the line `bottom-left " "-> top-left` corners in an anti-clockwise movement." msgstr "그리기는 반시계 방향으로 `왼쪽 아래 -> 왼쪽 위` 모서리 선의 중간점에서 시작하고 끝납니다." #: ../../shape.rst:153 dbc5cddf46e74369a4ec90c4aba4a510 msgid "" ":data:`rect_like` or :data:`quad_like`. *Changed in version 1.14.5:* " "Quads are now also supported." msgstr "" #: ../../shape.rst:153 0704abfebefe4fe78ed8116b1a8491c3 msgid ":data:`rect_like` or :data:`quad_like`." msgstr ":data:`rect_like` 또는 :data:`quad_like`." #: ../../shape.rst:155 b5056fbc16ad42e4b786c5a89beddb09 msgid "*Changed in version 1.14.5:* Quads are now also supported." msgstr "*버전 1.14.5에서 변경됨:* 이제 Quads도 지원됩니다." #: ../../shape.rst:158 913c4e5f92e8407f8da84ba1fbe6cb29 msgid "" "the middle point of line `rect.bl -> rect.tl`, or resp. `quad.ll -> " "quad.ul`. Look at just a few examples here, or at the *quad-show?.py* " "scripts in the PyMuPDF-Utilities repository." msgstr "선 `rect.bl -> rect.tl` 또는 각각 `quad.ll -> quad.ul` 의 중간점. 여기서 몇 가지 예제를 보거나 PyMuPDF-Utilities 저장소의 *quad-show?.py* 스크립트를 참조하세요." #: ../../shape.rst:165 e10d02b00d77481699e5ed1c3824246d msgid "" "Draw a circle given its center and radius. The drawing starts and ends at" " point `center - (radius, 0)` in an **anti-clockwise** movement. This " "point is the middle of the enclosing square's left side." msgstr "중심과 반지름이 주어진 원을 그립니다. 그리기는 **반시계 방향** 으로 점 `center - (radius, 0)` 에서 시작하고 끝납니다. 이 점은 둘러싸는 정사각형의 왼쪽 변의 중간입니다." #: ../../shape.rst:167 ab7929d6c83247179ab99962d0e45182 msgid "" "This is a shortcut for `draw_sector(center, start, 360, " "fullSector=False)`. To draw the same circle in a **clockwise** movement, " "use `-360` as degrees." msgstr "이것은 `draw_sector(center, start, 360, fullSector=False)` 의 바로가기입니다. **시계 방향** 으로 동일한 원을 그리려면 각도로 `-360` 을 사용하세요." #: ../../shape.rst:169 ../../shape.rst:199 6f2705ad71a74c2b917e39246bc2698d #: bd872730dfb6401aa65d5bf0dcfa4a1d msgid "the center of the circle." msgstr "원의 중심." #: ../../shape.rst:171 5b6ab9084a254ee998a1d680ac1e0240 msgid "the radius of the circle. Must be positive." msgstr "원의 반지름. 양수여야 합니다." #: ../../shape.rst:174 7c4ce467661b468b8439dadac7926f6a msgid "" "`Point(center.x - radius, center.y)`. .. image:: images/img-drawcircle.*" " :scale: 60" msgstr "" #: ../../shape.rst:174 2debffa3cd414df1912ce3b384b1301c msgid "`Point(center.x - radius, center.y)`." msgstr "`Point(center.x - radius, center.y)`." #: ../../shape.rst:181 ee66694536bb4ca4a6a74521eab10648 msgid "" "A special case of *draw_bezier()*: Draw a cubic Bezier curve from *p1* to" " *p3*. On each of the two lines `p1 -> p2` and `p3 -> p2` one control " "point is generated. Both control points will therefore be on the same " "side of the line `p1 -> p3`. This guaranties that the curve's curvature " "does not change its sign. If the lines to p2 intersect with an angle of " "90 degrees, then the resulting curve is a quarter ellipse (resp. quarter " "circle, if of same length)." msgstr "*draw_bezier()* 의 특수한 경우: *p1* 에서 *p3* 까지 3차 Bezier 곡선을 그립니다. 두 선 `p1 -> p2` 와 `p3 -> p2` 각각에 하나의 제어점이 생성됩니다. 따라서 두 제어점은 모두 선 `p1 -> p3` 의 같은 쪽에 있습니다. 이것은 곡선의 곡률이 부호를 변경하지 않도록 보장합니다. p2로의 선이 90도 각도로 교차하면 결과 곡선은 1/4 타원(또는 같은 길이인 경우 1/4 원)이 됩니다." #: ../../shape.rst:183 b9aa05d9515a4765ba0ed43ffaf7fdc8 msgid "All arguments are :data:`point_like`." msgstr "모든 인수는 :data:`point_like` 입니다." #: ../../shape.rst:186 17f64971541f45cd813e80d02b9a38f9 msgid "" "the end point, *p3*. The following is a filled quarter ellipse segment. " "The yellow area is oriented **clockwise:** .. image:: images/img-" "drawCurve.png :align: center" msgstr "" #: ../../shape.rst:186 13f26770deb8487da263851084fcf4e9 msgid "" "the end point, *p3*. The following is a filled quarter ellipse segment. " "The yellow area is oriented **clockwise:**" msgstr "끝점 *p3*. 다음은 채워진 1/4 타원 세그먼트입니다. 노란색 영역은 **시계 방향** 으로 향합니다:" #: ../../shape.rst:197 e52f58c73f024ab492a6b26bf05ef6d1 msgid "" "Draw a circular sector, optionally connecting the arc to the circle's " "center (like a piece of pie)." msgstr "원형 섹터를 그립니다. 선택적으로 호를 원의 중심에 연결합니다(파이 조각처럼)." #: ../../shape.rst:201 4a4f8fd9d4ae4e9f9d879279d68a23eb msgid "" "one of the two end points of the pie's arc segment. The other one is " "calculated from the *angle*." msgstr "파이의 호 세그먼트의 두 끝점 중 하나. 다른 하나는 *angle* 에서 계산됩니다." #: ../../shape.rst:203 cde4d3b5b77e4714a1e8229d3a7d5901 msgid "" "the angle of the sector in degrees. Used to calculate the other end point" " of the arc. Depending on its sign, the arc is drawn anti-clockwise " "(positive) or clockwise." msgstr "섹터의 각도(도 단위). 호의 다른 끝점을 계산하는 데 사용됩니다. 부호에 따라 호는 반시계 방향(양수) 또는 시계 방향으로 그려집니다." #: ../../shape.rst:205 240361925857465eae04d2b1fb29fe7f msgid "" "whether to draw connecting lines from the ends of the arc to the circle " "center. If a fill color is specified, the full \"pie\" is colored, " "otherwise just the sector." msgstr "호의 끝에서 원의 중심까지 연결선을 그릴지 여부. 채우기 색상이 지정되면 전체 \"파이\"가 색칠되고, 그렇지 않으면 섹터만 색칠됩니다." #: ../../shape.rst:208 be7cd89a7589439eb4d78244412304ad msgid "" "the other end point of the arc. Can be used as starting point for a " "following invocation to create logically connected pies charts. Examples:" " .. image:: images/img-drawSector1.* .. image:: images/img-" "drawSector2.*" msgstr "" #: ../../shape.rst:208 0043e2c7a86744b4a2bc4d7f0bce8a4b msgid "" "the other end point of the arc. Can be used as starting point for a " "following invocation to create logically connected pies charts. Examples:" msgstr "호의 다른 끝점. 논리적으로 연결된 파이 차트를 만들기 위한 후속 호출의 시작점으로 사용할 수 있습니다. 예:" #: ../../shape.rst:217 5fb3a670ab80402c9dcadb97fd8823f0 msgid "Changed in v1.22.0: Added parameter *radius*." msgstr "v1.22.0에서 변경됨: 매개변수 *radius* 추가." #: ../../shape.rst:219 d0e527f29d634bf6a4487b2594b804af msgid "" "Draw a rectangle. The drawing starts and ends at the top-left corner in " "an anti-clockwise movement." msgstr "직사각형을 그립니다. 그리기는 반시계 방향으로 왼쪽 위 모서리에서 시작하고 끝납니다." #: ../../shape.rst:221 9f2b7555b1844871bbf67f60773f3566 msgid "where to put the rectangle on the page." msgstr "페이지에서 직사각형을 배치할 위치." #: ../../shape.rst:222 67f101fa3c674ce7b113450e58af1ac1 #, python-format msgid "" "draw rounded rectangle corners. If not `None`, specifies the radius of " "the curvature as a percentage of a rectangle side length. This must one " "or (a tuple of) two floats `0 < radius <= 0.5`, where 0.5 corresponds to " "50% of the respective side. If a float, the radius of the curvature is " "computed as `radius * min(width, height)`, drawing the corner's perimeter" " as a quarter circle. If a tuple `(rx, ry)` is given, then the curvature " "is asymmetric with respect to the horizontal and vertical directions. A " "value of `radius=(0.5, 0.5)` draws an ellipse." msgstr "둥근 직사각형 모서리를 그립니다. `None` 이 아니면 직사각형 변 길이의 백분율로 곡률의 반지름을 지정합니다. 이것은 하나 또는 (튜플의) 두 개의 float `0 < radius <= 0.5` 여야 하며, 여기서 0.5는 해당 변의 50%에 해당합니다. float인 경우 곡률의 반지름은 `radius * min(width, height)` 로 계산되며, 모서리의 둘레를 1/4 원으로 그립니다. 튜플 `(rx, ry)` 가 주어지면 곡률은 수평 및 수직 방향에 대해 비대칭입니다. `radius=(0.5, 0.5)` 값은 타원을 그립니다." #: ../../shape.rst:225 6c3047af9341428fb1852d642a8d8fb3 msgid "top-left corner of the rectangle." msgstr "직사각형의 왼쪽 위 모서리." #: ../../shape.rst:229 654bd0a3b7ce4bf78f0d2d85b1d37414 msgid "" "Draw a quadrilateral. The drawing starts and ends at the top-left corner " "(:attr:`Quad.ul`) in an anti-clockwise movement. It is a shortcut of " ":meth:`Shape.draw_polyline` with the argument `(ul, ll, lr, ur, ul)`." msgstr "사변형을 그립니다. 그리기는 반시계 방향으로 왼쪽 위 모서리(:attr:`Quad.ul`)에서 시작하고 끝납니다. 인수 `(ul, ll, lr, ur, ul)` 을 사용하는 :meth:`Shape.draw_polyline` 의 바로가기입니다." #: ../../shape.rst:231 046262682daf47c8be64f00f93f9acba msgid "where to put the tetragon on the page." msgstr "페이지에서 사각형을 배치할 위치." #: ../../shape.rst:234 3fe224acf6924b1085f1052564c9423f msgid ":attr:`Quad.ul`." msgstr ":attr:`Quad.ul`." #: ../../shape.rst:253 0de6d95816a442d3b9408559071e8954 msgid "" "Finish a set of *draw*()* methods by applying :ref:`CommonParms` to all " "of them." msgstr ":ref:`CommonParms` 를 모두에 적용하여 *draw*()* 메서드 세트를 완료합니다." #: ../../shape.rst:255 56332b3691544dfbaf0fd9e731231bc5 msgid "" "It has **no effect on** :meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox`." msgstr ":meth:`Shape.insert_text` 및 :meth:`Shape.insert_textbox` 에는 **영향을 주지 않습니다**." #: ../../shape.rst:257 549c8c7eeb8344aaa7576d3e8a534e9c msgid "" "The method also supports **morphing the compound drawing** using " ":ref:`Point` *fixpoint* and :ref:`matrix` *matrix*." msgstr "이 메서드는 :ref:`Point` *fixpoint* 및 :ref:`matrix` *matrix* 를 사용하여 **복합 그림 변형** 도 지원합니다." #: ../../shape.rst:259 dba0c80e395c4f9992d5e84ad7225ffd msgid "" "morph the text or the compound drawing around some arbitrary :ref:`Point`" " *fixpoint* by applying :ref:`Matrix` *matrix* to it. This implies that " "*fixpoint* is a **fixed point** of this operation: it will not change its" " position. Default is no morphing (``None``). The matrix can contain any " "values in its first 4 components, *matrix.e == matrix.f == 0* must be " "true, however. This means that any combination of scaling, shearing, " "rotating, flipping, etc. is possible, but translations are not." msgstr "임의의 :ref:`Point` *fixpoint* 주변의 텍스트 또는 복합 그림을 :ref:`Matrix` *matrix* 를 적용하여 변형합니다. 이것은 *fixpoint* 가 이 작업의 **고정점** 임을 의미합니다: 위치가 변경되지 않습니다. 기본값은 변형 없음(``None``)입니다. 행렬은 처음 4개 구성 요소에 임의의 값을 포함할 수 있지만, *matrix.e == matrix.f == 0* 이 참이어야 합니다. 이것은 확대/축소, 기울이기, 회전, 뒤집기 등의 조합이 가능하지만 이동은 불가능함을 의미합니다." #: ../../shape.rst:261 5dafa22688dd4869b353c3ba9d3b07f7 msgid "" "*(new in v1.18.1)* set transparency for stroke colors. Value < 0 or > 1 " "will be ignored. Default is 1 (intransparent)." msgstr "*(v1.18.1의 새로운 기능)* 스트로크 색상의 투명도를 설정합니다. 값 < 0 또는 > 1은 무시됩니다. 기본값은 1(불투명)입니다." #: ../../shape.rst:262 ccec6b24043c40a28e9532eddd90bdce msgid "" "*(new in v1.18.1)* set transparency for fill colors. Default is 1 " "(intransparent)." msgstr "*(v1.18.1의 새로운 기능)* 채우기 색상의 투명도를 설정합니다. 기본값은 1(불투명)입니다." #: ../../shape.rst:264 df15c1363a6a46538ab6875019646cbd msgid "" "request the **\"even-odd rule\"** for filling operations. Default is " "``False``, so that the **\"nonzero winding number rule\"** is used. These" " rules are alternative methods to apply the fill color where areas " "overlap. Only with fairly complex shapes a different behavior is to be " "expected with these rules. For an in-depth explanation, see " ":ref:`AdobeManual`, pp. 137 ff. Here is an example to demonstrate the " "difference." msgstr "채우기 작업에 **\"even-odd rule\"** 을 요청합니다. 기본값은 ``False`` 이므로 **\"nonzero winding number rule\"** 이 사용됩니다. 이러한 규칙은 영역이 겹치는 곳에 채우기 색상을 적용하는 대체 방법입니다. 상당히 복잡한 모양에서만 이러한 규칙으로 다른 동작이 예상됩니다. 자세한 설명은 :ref:`AdobeManual` 137페이지 이하를 참조하세요. 차이를 보여주는 예제는 다음과 같습니다." #: ../../shape.rst:266 c674e567b1e5433eaf84acd80acc23dc msgid "" "*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " ":data:`OCMD` to make this drawing conditionally displayable." msgstr "*(v1.18.4의 새로운 기능)* 이 그림을 조건부로 표시 가능하게 하는 :data:`OCG` 또는 :data:`OCMD` 의 :data:`xref` 번호." #: ../../shape.rst:270 63c92f36394847c489986e7f2afbb97a msgid "For each pixel in a shape, the following will happen:" msgstr "모양의 각 픽셀에 대해 다음이 발생합니다:" #: ../../shape.rst:272 36c14ed50f0445be999e611bc169aa24 msgid "" "Rule **\"even-odd\"** counts, how many areas contain the pixel. If this " "count is **odd,** the pixel is regarded **inside** the shape, if it is " "**even**, the pixel is **outside**." msgstr "규칙 **\"even-odd\"** 는 픽셀을 포함하는 영역의 수를 계산합니다. 이 카운트가 **홀수** 이면 픽셀은 모양 **내부** 로 간주되고, **짝수** 이면 픽셀은 **외부** 로 간주됩니다." #: ../../shape.rst:274 3effcfe2b7fe4980b3622d1cc2555db9 msgid "" "The default rule **\"nonzero winding\"** in addition looks at the " "*\"orientation\"* of each area containing the pixel: it **adds 1** if an " "area is drawn anti-clockwise and it **subtracts 1** for clockwise areas. " "If the result is zero, the pixel is regarded **outside,** pixels with a " "non-zero count are **inside** the shape." msgstr "기본 규칙 **\"nonzero winding\"** 은 추가로 픽셀을 포함하는 각 영역의 *\"방향\"* 을 봅니다: 영역이 반시계 방향으로 그려지면 **1을 더하고** 시계 방향 영역에 대해서는 **1을 뺍니다**. 결과가 0이면 픽셀은 **외부** 로 간주되고, 0이 아닌 카운트를 가진 픽셀은 모양 **내부** 에 있습니다." #: ../../shape.rst:276 b72f9a0a9d6a42fba11e06941aaae289 msgid "" "Of the four shapes in above image, the top two each show three circles " "drawn in standard manner (anti-clockwise, look at the arrows). The lower " "two shapes contain one (the top-left) circle drawn clockwise. As can be " "seen, area orientation is irrelevant for the right column (even-odd " "rule)." msgstr "위 이미지의 네 모양 중 위쪽 두 개는 각각 표준 방식(반시계 방향, 화살표 참조)으로 그려진 세 개의 원을 보여줍니다. 아래쪽 두 모양은 시계 방향으로 그려진 하나(왼쪽 위)의 원을 포함합니다. 보시다시피 영역 방향은 오른쪽 열(even-odd 규칙)과 무관합니다." #: ../../shape.rst:297 a50a3db9c4f74b3aaed7c91f010f050f msgid "Insert text lines starting at ``point``." msgstr "``point`` 에서 시작하는 텍스트 줄을 삽입합니다." #: ../../shape.rst:299 d60ae29ad0ca4e709ff2c72d7bf5c264 msgid "" "the bottom-left position of the first character of *text* in pixels. It " "is important to understand, how this works in conjunction with the " "*rotate* parameter. Please have a look at the following picture. The " "small red dots indicate the positions of *point* in each of the four " "possible cases. .. image:: images/img-inserttext.* :scale: 33" msgstr "" #: ../../shape.rst:299 1521f8f6fbea43a0be0deb7904e4623c msgid "" "the bottom-left position of the first character of *text* in pixels. It " "is important to understand, how this works in conjunction with the " "*rotate* parameter. Please have a look at the following picture. The " "small red dots indicate the positions of *point* in each of the four " "possible cases." msgstr "픽셀 단위로 *text* 의 첫 번째 문자의 왼쪽 아래 위치. 이것이 *rotate* 매개변수와 함께 어떻게 작동하는지 이해하는 것이 중요합니다. 다음 그림을 참조하세요. 작은 빨간 점은 네 가지 가능한 경우 각각에서 *point* 의 위치를 나타냅니다." #: ../../shape.rst:304 c50197a3ee954fc4b17e16da50350320 msgid "" "the text to be inserted. May be specified as either a string type or as a" " sequence type. For sequences, or strings containing line breaks ``\\n``," " several lines will be inserted. No care will be taken if lines are too " "wide, but the number of inserted lines will be limited by \"vertical\" " "space on the page (in the sense of reading direction as established by " "the *rotate* parameter). Any rest of *text* is discarded -- the return " "code however contains the number of inserted lines." msgstr "삽입할 텍스트. 문자열 타입 또는 시퀀스 타입으로 지정할 수 있습니다. 시퀀스 또는 줄바꿈 ``\\n`` 을 포함하는 문자열의 경우 여러 줄이 삽입됩니다. 줄이 너무 넓어도 처리하지 않지만, 삽입된 줄 수는 페이지의 \"수직\" 공간(*rotate* 매개변수에 의해 설정된 읽기 방향의 의미에서)에 의해 제한됩니다. *text* 의 나머지는 버려집니다 -- 그러나 반환 코드는 삽입된 줄 수를 포함합니다." #: ../../shape.rst:306 ../../shape.rst:346 a2bce94fcad44fc08799f6d16a27e19d #: f75a16cbc40142c5a8ce2199eb87b25c msgid "" "a factor to override the line height calculated from font properties. If " "not `None`, a line height of `fontsize * lineheight` will be used." msgstr "글꼴 속성에서 계산된 줄 높이를 재정의하는 요소. `None` 이 아니면 `fontsize * lineheight` 의 줄 높이가 사용됩니다." #: ../../shape.rst:307 1ecd328d935546d38c4621a762982871 msgid "" "*(new in v1.18.1)* set transparency for stroke colors (the **border " "line** of a character). Only `0 <= value <= 1` will be considered. " "Default is 1 (intransparent)." msgstr "*(v1.18.1의 새로운 기능)* 스트로크 색상(문자의 **테두리 선**)의 투명도를 설정합니다. `0 <= value <= 1` 만 고려됩니다. 기본값은 1(불투명)입니다." #: ../../shape.rst:308 ../../shape.rst:351 168d47f1a50e45efbddb4be1a0a28d1c #: 7029b8b04590494a850f9bf97c737317 msgid "" "*(new in v1.18.1)* set transparency for fill colors. Default is 1 " "(intransparent). Use this value to control transparency of the text " "color. Stroke opacity **only** affects the border line of characters." msgstr "*(v1.18.1의 새로운 기능)* 채우기 색상의 투명도를 설정합니다. 기본값은 1(불투명)입니다. 이 값을 사용하여 텍스트 색상의 투명도를 제어합니다. 스트로크 불투명도는 **문자의 테두리 선에만** 영향을 줍니다." #: ../../shape.rst:310 bc253669783d43fbbcea827f904f8df7 msgid "" "determines whether to rotate the text. Acceptable values are multiples of" " 90 degrees. Default is 0 (no rotation), meaning horizontal text lines " "oriented from left to right. 180 means text is shown upside down from " "**right to left**. 90 means anti-clockwise rotation, text running " "**upwards**. 270 (or -90) means clockwise rotation, text running " "**downwards**. In any case, *point* specifies the bottom-left coordinates" " of the first character's rectangle. Multiple lines, if present, always " "follow the reading direction established by this parameter. So line 2 is " "located **above** line 1 in case of `rotate = 180`, etc." msgstr "텍스트를 회전할지 여부를 결정합니다. 허용되는 값은 90도의 배수입니다. 기본값은 0(회전 없음)이며, 왼쪽에서 오른쪽으로 향하는 수평 텍스트 줄을 의미합니다. 180은 텍스트가 **오른쪽에서 왼쪽** 으로 거꾸로 표시됨을 의미합니다. 90은 반시계 방향 회전, 텍스트가 **위쪽** 으로 실행됨을 의미합니다. 270(또는 -90)은 시계 방향 회전, 텍스트가 **아래쪽** 으로 실행됨을 의미합니다. 어떤 경우든 *point* 는 첫 번째 문자의 사각형의 왼쪽 아래 좌표를 지정합니다. 여러 줄이 있는 경우 항상 이 매개변수에 의해 설정된 읽기 방향을 따릅니다. 따라서 `rotate = 180` 인 경우 줄 2는 줄 1 **위에** 위치합니다." #: ../../shape.rst:312 ../../shape.rst:355 68906f83108042f0b104b462a3b39709 #: 9759f8b8a55448eb88645d85395ee4e8 msgid "" "*(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or " ":data:`OCMD` to make this text conditionally displayable." msgstr "*(v1.18.4의 새로운 기능)* 이 텍스트를 조건부로 표시 가능하게 하는 :data:`OCG` 또는 :data:`OCMD` 의 :data:`xref` 번호." #: ../../shape.rst:315 ed86c6cd4572455ba92ae3ff42b41fdf msgid "number of lines inserted." msgstr "삽입된 줄 수." #: ../../shape.rst:317 ../../shape.rst:367 4a40110f016f4c7bb3e919ac462d14e3 #: 785b22c9fbc5484186666fbe76c0f207 msgid "For a description of the other parameters see :ref:`CommonParms`." msgstr "다른 매개변수에 대한 설명은 :ref:`CommonParms` 를 참조하세요." #: ../../shape.rst:338 32569db0897946de8f8338dcc82e3dd3 msgid "" "PDF only: Insert text into the specified rectangle. The text will be " "split into lines and words and then filled into the available space, " "starting from one of the four rectangle corners, which depends on " "`rotate`. Line feeds and multiple space will be respected." msgstr "PDF 전용: 지정된 사각형에 텍스트를 삽입합니다. 텍스트는 줄과 단어로 분할된 다음 사용 가능한 공간에 채워지며, `rotate` 에 따라 사각형의 네 모서리 중 하나에서 시작합니다. 줄바꿈과 여러 공백이 존중됩니다." #: ../../shape.rst:340 c50da8ee249d416084e826f0a8a2efd6 msgid "the area to use. It must be finite and not empty." msgstr "사용할 영역. 유한하고 비어 있지 않아야 합니다." #: ../../shape.rst:342 7990001f1d8a482696c3ea94ee3b11c5 msgid "" "the text to be inserted. Must be specified as a string or a sequence of " "strings. Line breaks are respected also when occurring in a sequence " "entry." msgstr "삽입할 텍스트. 문자열 또는 문자열 시퀀스로 지정해야 합니다. 시퀀스 항목에 발생하는 경우에도 줄바꿈이 존중됩니다." #: ../../shape.rst:344 8bfa2ed038884962a70ceb3e0459dc06 msgid "" "align each text line. Default is 0 (left). Centered, right and justified " "are the other supported options, see :ref:`TextAlign`. Please note that " "the effect of parameter value *TEXT_ALIGN_JUSTIFY* is only achievable " "with \"simple\" (single-byte) fonts (including the :ref:`Base-14-Fonts`)." msgstr "각 텍스트 줄을 정렬합니다. 기본값은 0(왼쪽)입니다. 중앙, 오른쪽 및 양쪽 정렬은 다른 지원 옵션입니다. :ref:`TextAlign` 을 참조하세요. 매개변수 값 *TEXT_ALIGN_JUSTIFY* 의 효과는 \"simple\"(단일 바이트) 글꼴(:ref:`Base-14-Fonts` 포함)에서만 달성할 수 있습니다." #: ../../shape.rst:348 9adb4b3bbe094da8a624bd552fc13f21 msgid "" "controls handling of tab characters ``\\t`` using the " "`string.expandtabs()` method **per each line**." msgstr "**각 줄마다** `string.expandtabs()` 메서드를 사용하여 탭 문자 ``\\t`` 의 처리를 제어합니다." #: ../../shape.rst:350 67177b4ade6c4da5a4523395d6bd4bf4 msgid "" "*(new in v1.18.1)* set transparency for stroke colors. Negative values " "and values > 1 will be ignored. Default is 1 (intransparent)." msgstr "*(v1.18.1의 새로운 기능)* 스트로크 색상의 투명도를 설정합니다. 음수 값과 값 > 1은 무시됩니다. 기본값은 1(불투명)입니다." #: ../../shape.rst:353 d5edb13ac13b4ab4ba9d26fa3d3a6d82 msgid "" "requests text to be rotated in the rectangle. This value must be a " "multiple of 90 degrees. Default is 0 (no rotation). Effectively, the four" " values `0`, `90`, `180` and `270` (= `-90`) are processed, each causing " "the text to start in a different rectangle corner. Bottom-left is `90`, " "bottom-right is `180`, and `-90 / 270` is top-right. See the example how " "text is filled in a rectangle. This argument takes precedence over " "morphing. See the second example, which shows text first rotated left by " "`90` degrees and then the whole rectangle rotated clockwise around is " "lower left corner." msgstr "사각형에서 텍스트를 회전하도록 요청합니다. 이 값은 90도의 배수여야 합니다. 기본값은 0(회전 없음)입니다. 효과적으로 네 가지 값 `0`, `90`, `180` 및 `270` (= `-90`)이 처리되며, 각각 텍스트가 다른 사각형 모서리에서 시작하도록 합니다. 왼쪽 아래는 `90`, 오른쪽 아래는 `180`, `-90 / 270` 은 오른쪽 위입니다. 텍스트가 사각형에 채워지는 방법의 예제를 참조하세요. 이 인수는 변형보다 우선합니다. 텍스트가 먼저 `90` 도 왼쪽으로 회전한 다음 전체 사각형이 왼쪽 아래 모서리를 중심으로 시계 방향으로 회전하는 두 번째 예제를 참조하세요." #: ../../shape.rst:358 c9924f296b104dcb885e423a8329287a msgid "" "**If positive or zero**: successful execution. The value returned is the " "unused rectangle line space in pixels. This may safely be ignored -- or " "be used to optimize the rectangle, position subsequent items, etc. **If " "negative**: no execution. The value returned is the space deficit to " "store text lines. Enlarge rectangle, decrease *fontsize*, decrease text " "amount, etc." msgstr "" #: ../../shape.rst:359 ff434ea0b01748d3a22351b8914d1de9 msgid "" "**If positive or zero**: successful execution. The value returned is the " "unused rectangle line space in pixels. This may safely be ignored -- or " "be used to optimize the rectangle, position subsequent items, etc." msgstr "**양수 또는 0인 경우**: 성공적인 실행. 반환된 값은 픽셀 단위의 사용되지 않은 사각형 줄 공간입니다. 이것은 안전하게 무시할 수 있습니다 -- 또는 사각형을 최적화하고 후속 항목을 배치하는 데 사용할 수 있습니다." #: ../../shape.rst:361 2d7f62a0c5ec468eb58daea2b7b74842 msgid "" "**If negative**: no execution. The value returned is the space deficit to" " store text lines. Enlarge rectangle, decrease *fontsize*, decrease text " "amount, etc." msgstr "**음수인 경우**: 실행되지 않음. 반환된 값은 텍스트 줄을 저장하기 위한 공간 부족입니다. 사각형을 확대하고, *fontsize* 를 줄이고, 텍스트 양을 줄이는 등을 수행하세요." #: ../../shape.rst:375 f65e40d3ebec4535af01faa79e3c04db msgid "" "Update the page's :data:`contents` with the accumulated drawings, " "followed by any text insertions. If text overlaps drawings, it will be " "written on top of the drawings." msgstr "누적된 그림으로 페이지의 :data:`contents` 를 업데이트한 다음 텍스트 삽입을 수행합니다. 텍스트가 그림과 겹치면 그림 위에 기록됩니다." #: ../../shape.rst:377 3cc36436278147c4bf9af8031f1046a3 msgid "**Do not forget to execute this method:**" msgstr "**이 메서드를 실행하는 것을 잊지 마세요:**" #: ../../shape.rst:379 44ccc171888e476f88b7c3ce68d54ad9 msgid "" "If a shape is **not committed, it will be ignored and the page will not " "be changed!**" msgstr "shape가 **커밋되지 않으면 무시되고 페이지가 변경되지 않습니다!**" #: ../../shape.rst:381 8911998982cf45e6b4d61df722ae0084 msgid "" "The method will reset attributes :attr:`Shape.rect`, :attr:`lastPoint`, " ":attr:`draw_cont`, :attr:`text_cont` and :attr:`totalcont`. Afterwards, " "the shape object can be reused for the **same page**." msgstr "이 메서드는 속성 :attr:`Shape.rect`, :attr:`lastPoint`, :attr:`draw_cont`, :attr:`text_cont` 및 :attr:`totalcont` 를 재설정합니다. 이후 shape 객체는 **동일한 페이지** 에 대해 재사용할 수 있습니다." #: ../../shape.rst:383 90b57d6cc3344abaa5ae796d17518c78 msgid "" "determine whether to put content in foreground (default) or background. " "Relevant only, if the page already has a non-empty :data:`contents` " "object." msgstr "콘텐츠를 전경(기본값) 또는 배경에 배치할지 결정합니다. 페이지에 이미 비어 있지 않은 :data:`contents` 객체가 있는 경우에만 관련됩니다." #: ../../shape.rst:385 555f29f07330465799e60c983380d945 msgid "**---------- Attributes ----------**" msgstr "**---------- Attributes ----------**" #: ../../shape.rst:389 bcd84d9d71fe4ab7a75882c2f6ea55ee msgid "For reference only: the page's document." msgstr "참조용: 페이지의 문서." #: ../../shape.rst 4bc5f78dcd47499499d993fc76937923 #: 51e0e906798c404999816e887c14725e 583eb30bb6764d82886dcee5ecc5ef23 #: 7da907572dab4cdd850b1f99866f1208 84fee03ff02a47de895a2e76a85339b0 #: 8ad67482ac084e4e8acd77c771ac9813 bd1c39ed922a4dba9f34104a29bd9bd6 #: dc8385568c9641d9bb717e0218bc356a f04ca533ba0f465e9baafc622227ff3a msgid "type" msgstr "type" #: ../../shape.rst:391 d4a7179efc87417687ed54512b5fd372 msgid ":ref:`Document`" msgstr ":ref:`Document`" #: ../../shape.rst:395 e50d0793a5eb432bb3c2ca8ea196f4c2 msgid "For reference only: the owning page." msgstr "참조용: 소유 페이지." #: ../../shape.rst:397 a88ee833273045f299c35dd3ead948a4 msgid ":ref:`Page`" msgstr ":ref:`Page`" #: ../../shape.rst:401 2bad01b347624c13a0c42fc3970fc1b5 msgid "Copy of the page's height" msgstr "페이지 높이의 복사본" #: ../../shape.rst:403 ../../shape.rst:409 a1d7f49541cb48ab8a1087635dffe627 #: ee0e76b01d494167bc804a4bcb20168e msgid "float" msgstr "" #: ../../shape.rst:407 ae4a0df9e57c45dd99dc05694d71194d msgid "Copy of the page's width." msgstr "페이지 너비의 복사본." #: ../../shape.rst:413 36e04a92b85b455f986d86cf86a84b9d msgid "" "Accumulated command buffer for **draw methods** since last finish. Every " "finish method will append its commands to :attr:`Shape.totalcont`." msgstr "마지막 finish 이후 **draw 메서드** 의 누적 명령 버퍼. 모든 finish 메서드는 명령을 :attr:`Shape.totalcont` 에 추가합니다." #: ../../shape.rst:415 ../../shape.rst:421 ../../shape.rst:442 #: 0e691c52a692459fb3651063bbd96fa1 3bd5e87273ea409ba3861ff7a5df3fba #: 6131e3edacf44d948d0f06ae76196fb4 msgid "str" msgstr "" #: ../../shape.rst:419 1c7cc423d0b647cc8b976e70594d7e5a msgid "" "Accumulated text buffer. All **text insertions** go here. This buffer " "will be appended to :attr:`totalcont` :meth:`Shape.commit`, so that text " "will never be covered by drawings in the same Shape." msgstr "누적된 텍스트 버퍼. 모든 **텍스트 삽입** 이 여기로 갑니다. 이 버퍼는 :meth:`Shape.commit` 에서 :attr:`totalcont` 에 추가되므로 텍스트가 같은 Shape의 그림에 의해 덮이지 않습니다." #: ../../shape.rst:425 31e0348adf3949dea03c7e108eec0e9a msgid "" "Rectangle surrounding drawings. This attribute is at your disposal and " "may be changed at any time. Its value is set to ``None`` when a shape is " "created or committed. Every *draw** method, and " ":meth:`Shape.insert_textbox` update this property (i.e. **enlarge** the " "rectangle as needed). **Morphing** operations, however " "(:meth:`Shape.finish`, :meth:`Shape.insert_textbox`) are ignored." msgstr "그림을 둘러싸는 사각형. 이 속성은 사용자가 자유롭게 사용할 수 있으며 언제든지 변경할 수 있습니다. shape가 생성되거나 커밋될 때 값이 ``None`` 으로 설정됩니다. 모든 *draw** 메서드와 :meth:`Shape.insert_textbox` 는 이 속성을 업데이트합니다(즉, 필요에 따라 사각형을 **확대**). 하지만 **Morphing** 작업(:meth:`Shape.finish`, :meth:`Shape.insert_textbox`)은 무시됩니다." #: ../../shape.rst:427 58e3a175f61343beb779d52d6f9a968a msgid "" "A typical use of this attribute would be setting " ":attr:`Page.cropbox_position` to this value, when you are creating shapes" " for later or external use. If you have not manipulated the attribute " "yourself, it should reflect a rectangle that contains all drawings so " "far." msgstr "이 속성의 일반적인 사용은 나중에 사용하거나 외부에서 사용하기 위해 shape를 생성할 때 :attr:`Page.cropbox_position` 을 이 값으로 설정하는 것입니다. 속성을 직접 조작하지 않은 경우 지금까지의 모든 그림을 포함하는 사각형을 반영해야 합니다." #: ../../shape.rst:429 bde3111f6fcb4fde8ae6d94e2b784878 msgid "" "If you have used morphing and need a rectangle containing the morphed " "objects, use the following code::" msgstr "변형을 사용했고 변형된 객체를 포함하는 사각형이 필요한 경우 다음 코드를 사용하세요::" #: ../../shape.rst:436 8b59162d4cdc4453a1a62c884c29d8c5 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../shape.rst:440 70f79c2bf0624368be25e43a4b7a3c3f msgid "" "Total accumulated command buffer for draws and text insertions. This will" " be used by :meth:`Shape.commit`." msgstr "그리기 및 텍스트 삽입을 위한 총 누적 명령 버퍼. 이것은 :meth:`Shape.commit` 에서 사용됩니다." #: ../../shape.rst:446 2a512a35544e4ff4bc0908226c3f1474 msgid "" "For reference only: the current point of the drawing path. It is ``None``" " at *Shape* creation and after each *finish()* and *commit()*." msgstr "참조용: 그리기 경로의 현재 점. *Shape* 생성 시 및 각 *finish()* 및 *commit()* 후에 ``None`` 입니다." #: ../../shape.rst:451 5f43e7fa99ee464a8f4e310b6073e35b msgid "Usage" msgstr "사용법" #: ../../shape.rst:452 a35b85f2df424fe5a8123cbd236b49c9 msgid "" "A drawing object is constructed by *shape = page.new_shape()*. After " "this, as many draw, finish and text insertions methods as required may " "follow. Each sequence of draws must be finished before the drawing is " "committed. The overall coding pattern looks like this::" msgstr "그리기 객체는 *shape = page.new_shape()* 로 구성됩니다. 그 후 필요한 만큼 많은 draw, finish 및 텍스트 삽입 메서드가 올 수 있습니다. 그리기가 커밋되기 전에 각 draw 시퀀스가 완료되어야 합니다. 전체 코딩 패턴은 다음과 같습니다::" #: ../../shape.rst:471 7d0392c130464a54a962cc95cad3ce9d msgid "" "Each *finish()* combines the preceding draws into one logical shape, " "giving it common colors, line width, morphing, etc. If *closePath* is " "specified, it will also connect the end point of the last draw with the " "starting point of the first one." msgstr "각 *finish()* 는 앞의 그리기를 하나의 논리적 모양으로 결합하여 공통 색상, 선 너비, 변형 등을 제공합니다. *closePath* 가 지정되면 마지막 그리기의 끝점을 첫 번째 그리기의 시작점과 연결합니다." #: ../../shape.rst:473 d909c60fe1834c8eb1936c81f4fe8a7c msgid "" "To successfully create compound graphics, let each draw method use the " "end point of the previous one as its starting point. In the above pseudo " "code, *draw2* should hence use the returned :ref:`Point` of *draw1* as " "its starting point. Failing to do so, would automatically start a new " "path and *finish()* may not work as expected (but it won't complain " "either)." msgstr "복합 그래픽을 성공적으로 만들려면 각 draw 메서드가 이전 메서드의 끝점을 시작점으로 사용하도록 하세요. 위의 의사 코드에서 *draw2* 는 따라서 *draw1* 의 반환된 :ref:`Point` 를 시작점으로 사용해야 합니다. 그렇게 하지 않으면 자동으로 새 경로가 시작되고 *finish()* 가 예상대로 작동하지 않을 수 있습니다(하지만 불평하지도 않습니다)." #: ../../shape.rst:475 fb42b4b00cfd4c8f9bc125398e78d941 msgid "" "Text insertions may occur anywhere before the commit (they neither touch " ":attr:`Shape.draw_cont` nor :attr:`Shape.lastPoint`). They are appended " "to *Shape.totalcont* directly, whereas draws will be appended by " "*Shape.finish*." msgstr "텍스트 삽입은 커밋 전 어디서든 발생할 수 있습니다(:attr:`Shape.draw_cont` 나 :attr:`Shape.lastPoint` 를 건드리지 않습니다). 이것들은 *Shape.totalcont* 에 직접 추가되는 반면, 그리기는 *Shape.finish* 에 의해 추가됩니다." #: ../../shape.rst:477 f1ba4537b82747479d0306c9e87f4f4c msgid "" "Each *commit* takes all text insertions and shapes and places them in " "foreground or background on the page -- thus providing a way to control " "graphical layers." msgstr "각 *commit* 은 모든 텍스트 삽입과 모양을 가져와 페이지의 전경 또는 배경에 배치합니다 -- 따라서 그래픽 레이어를 제어하는 방법을 제공합니다." #: ../../shape.rst:479 f54933082b2d4eff99e12a13fc1482a9 msgid "" "**Only** *commit* **will update** the page's contents, the other methods " "are basically string manipulations." msgstr "**오직** *commit* 만 페이지의 콘텐츠를 **업데이트** 하며, 다른 메서드는 기본적으로 문자열 조작입니다." #: ../../shape.rst:482 278641dcb46d4baf936c58e97dcd5458 msgid "Examples" msgstr "예제" #: ../../shape.rst:483 eb1041462daa4eaea29f2c68f9820833 msgid "Create a full circle of pieces of pie in different colors::" msgstr "다양한 색상의 파이 조각으로 전체 원 만들기::" #: ../../shape.rst:498 eaebaebe3baa4f09947553ff9e26c2a1 msgid "Here is an example for 5 colors:" msgstr "다음은 5가지 색상의 예제입니다:" #: ../../shape.rst:502 3cf653254d684532a9c3aba1c78bfd12 msgid "" "Create a regular n-edged polygon (fill yellow, red border). We use " "*draw_sector()* only to calculate the points on the circumference, and " "empty the draw command buffer again before drawing the polygon::" msgstr "정규 n각형 만들기(노란색 채우기, 빨간색 테두리). 원주 위의 점을 계산하기 위해 *draw_sector()* 만 사용하고, 다각형을 그리기 전에 그리기 명령 버퍼를 다시 비웁니다::" #: ../../shape.rst:517 e093071b33a14f6ca8a50b7e9ef6d3b1 msgid "Here is the polygon for n = 7:" msgstr "다음은 n = 7인 다각형입니다:" #: ../../shape.rst:524 32cfdbeb116244d09f20318c9cbaa2ac msgid "Common Parameters" msgstr "공통 매개변수" #: ../../shape.rst:526 e8e32aa90b154bf9b1f9186f60ab584a msgid "**fontname** (*str*)" msgstr "**fontname** (*str*)" #: ../../shape.rst:528 77ba86666bd24c11b1d1d22120f706a7 msgid "In general, there are three options:" msgstr "일반적으로 세 가지 옵션이 있습니다:" #: ../../shape.rst:530 02905b80e6194c4eacf48669a2b4862d msgid "" "Use one of the standard :ref:`Base-14-Fonts`. In this case, *fontfile* " "**must not** be specified and *\"Helvetica\"* is used if this parameter " "is omitted, too." msgstr "표준 :ref:`Base-14-Fonts` 중 하나를 사용합니다. 이 경우 *fontfile* 을 **지정하면 안 되며** 이 매개변수도 생략하면 *\"Helvetica\"* 가 사용됩니다." #: ../../shape.rst:531 e643b83ac7934c6a8daf143d5e6ea969 msgid "" "Choose a font already in use by the page. Then specify its **reference** " "name prefixed with a slash \"/\", see example below." msgstr "페이지에서 이미 사용 중인 글꼴을 선택합니다. 그런 다음 슬래시 \"/\" 로 시작하는 **참조** 이름을 지정하세요. 아래 예제를 참조하세요." #: ../../shape.rst:532 1aa96eb291154994b5334cb249b357b8 msgid "" "Specify a font file present on your system. In this case choose an " "arbitrary, but new name for this parameter (without \"/\" prefix)." msgstr "시스템에 있는 글꼴 파일을 지정합니다. 이 경우 이 매개변수에 대해 임의의 새 이름을 선택하세요(\"/\" 접두사 없이)." #: ../../shape.rst:534 42e52261eb524d2984f6a0c4332a2f24 msgid "" "If inserted text should re-use one of the page's fonts, use its reference" " name appearing in :meth:`Page.get_fonts` like so:" msgstr "삽입된 텍스트가 페이지의 글꼴 중 하나를 재사용해야 하는 경우 :meth:`Page.get_fonts` 에 나타나는 참조 이름을 다음과 같이 사용하세요:" #: ../../shape.rst:536 17c14b3525c343518ae06671819af5b8 msgid "" "Suppose the font list has the item *[1024, 0, 'Type1', 'NimbusMonL-Bold'," " 'R366']*, then specify *fontname = \"/R366\", fontfile = None* to use " "font *NimbusMonL-Bold*." msgstr "글꼴 목록에 항목 *[1024, 0, 'Type1', 'NimbusMonL-Bold', 'R366']* 가 있다고 가정하면, 글꼴 *NimbusMonL-Bold* 를 사용하기 위해 *fontname = \"/R366\", fontfile = None* 을 지정하세요." #: ../../shape.rst:540 30272688bae040099e4f10745899bb73 msgid "**fontfile** (*str*)" msgstr "**fontfile** (*str*)" #: ../../shape.rst:542 c86a2afe0b8040a3841ecc108e5f0c2a msgid "" "File path of a font existing on your computer. If you specify *fontfile*," " make sure you use a *fontname* **not occurring** in the above list. This" " new font will be embedded in the PDF upon *doc.save()*. Similar to new " "images, a font file will be embedded only once. A table of MD5 codes for " "the binary font contents is used to ensure this." msgstr "컴퓨터에 있는 글꼴의 파일 경로. *fontfile* 을 지정하는 경우 위 목록에 **나타나지 않는** *fontname* 을 사용해야 합니다. 이 새 글꼴은 *doc.save()* 시 PDF에 포함됩니다. 새 이미지와 유사하게 글꼴 파일은 한 번만 포함됩니다. 바이너리 글꼴 콘텐츠의 MD5 코드 테이블을 사용하여 이를 보장합니다." #: ../../shape.rst:546 de497e62ab204c48ae01fa7ac3ed1c32 msgid "**set_simple** (*bool*)" msgstr "**set_simple** (*bool*)" #: ../../shape.rst:548 8620026ea526446e8ef1ca19f9760737 msgid "" "Fonts installed from files are installed as **Type0** fonts by default. " "If you want to use 1-byte characters only, set this to true. This setting" " cannot be reverted. Subsequent changes are ignored." msgstr "파일에서 설치된 글꼴은 기본적으로 **Type0** 글꼴로 설치됩니다. 1바이트 문자만 사용하려면 이것을 true로 설정하세요. 이 설정은 되돌릴 수 없습니다. 후속 변경 사항은 무시됩니다." #: ../../shape.rst:552 3981f48a75204dc09ff6f422f689ffa4 msgid "**fontsize** (*float*)" msgstr "**fontsize** (*float*)" #: ../../shape.rst:554 30ac30c13b44417bbeb1b66ed6d98114 msgid "Font size of text, see: :data:`fontsize`." msgstr "텍스트의 글꼴 크기, 참조: :data:`fontsize`." #: ../../shape.rst:558 4d0dc80686d94b4c88776c39286aa523 msgid "**dashes** (*str*)" msgstr "**dashes** (*str*)" #: ../../shape.rst:560 47655eea2c2e46188c15bd1c75c4117a msgid "" "Causes lines to be drawn dashed. The general format is `\"[n m] p\"` of " "(up to) 3 floats denoting pixel lengths. ``n`` is the dash length, ``m`` " "(optional) is the subsequent gap length, and ``p`` (the \"phase\" - " "**required**, even if 0!) specifies how many pixels should be skipped " "before the dashing starts. If ``m`` is omitted, it defaults to ``n``." msgstr "선을 점선으로 그리도록 합니다. 일반 형식은 픽셀 길이를 나타내는 (최대) 3개의 float `\"[n m] p\"` 입니다. ``n`` 은 대시 길이이고, ``m`` (선택 사항)은 후속 간격 길이이며, ``p`` (\"phase\" - **필수**, 0이어도!)는 대시가 시작되기 전에 건너뛸 픽셀 수를 지정합니다. ``m`` 이 생략되면 기본값은 ``n`` 입니다." #: ../../shape.rst:562 c003ae76596a4f938a7fd5de9cb061a3 msgid "" "A continuous line (no dashes) is drawn with `\"[] 0\"` or ``None`` or " "`\"\"`. Examples:" msgstr "연속 선(대시 없음)은 `\"[] 0\"` 또는 ``None`` 또는 `\"\"` 로 그려집니다. 예제:" #: ../../shape.rst:564 e6cbda6711694eb8b100b5a9792385ef msgid "" "Specifying `\"[3 4] 0\"` means dashes of 3 and gaps of 4 pixels following" " each other." msgstr "`\"[3 4] 0\"` 을 지정하면 3픽셀 대시와 4픽셀 간격이 연속으로 이어집니다." #: ../../shape.rst:565 3391c97c4550433782ec215117a6557d msgid "`\"[3 3] 0\"` and `\"[3] 0\"` do the same thing." msgstr "`\"[3 3] 0\"` 과 `\"[3] 0\"` 은 동일한 작업을 수행합니다." #: ../../shape.rst:567 f068a3fa466545ecaf2d248a20fc2739 msgid "" "For (the rather complex) details on how to achieve sophisticated dashing " "effects, see :ref:`AdobeManual`, page 217." msgstr "정교한 대시 효과를 얻는 방법에 대한 (상당히 복잡한) 세부 사항은 :ref:`AdobeManual`, 217페이지를 참조하세요." #: ../../shape.rst:571 82aa9894181a4fe3b697261487bbfe7e msgid "**color / fill** (*list, tuple*)" msgstr "**color / fill** (*list, tuple*)" #: ../../shape.rst:573 3ed2643ec6df4cc28a73683cb286285e msgid "" "Stroke and fill colors can be specified as tuples or list of of floats " "from 0 to 1. These sequences must have a length of 1 (GRAY), 3 (RGB) or 4" " (CMYK). For GRAY colorspace, a single float instead of the unwieldy " "*(float,)* or *[float]* is also accepted. Accept (default) or use `None` " "to not use the parameter." msgstr "스트로크 및 채우기 색상은 0부터 1까지의 float 튜플 또는 리스트로 지정할 수 있습니다. 이러한 시퀀스는 길이가 1(GRAY), 3(RGB) 또는 4(CMYK)여야 합니다. GRAY 색 공간의 경우 다루기 어려운 *(float,)* 또는 *[float]* 대신 단일 float도 허용됩니다. 기본값을 수락하거나 `None` 을 사용하여 매개변수를 사용하지 않습니다." #: ../../shape.rst:575 06bd406c862d430d8527a7a38b17df9b msgid "" "To simplify color specification, method *getColor()* in *pymupdf.utils* " "may be used to get predefined RGB color triples by name. It accepts a " "string as the name of the color and returns the corresponding triple. The" " method knows over 540 color names -- see section :ref:`ColorDatabase`." msgstr "색상 지정을 단순화하기 위해 *pymupdf.utils* 의 메서드 *getColor()* 를 사용하여 이름으로 미리 정의된 RGB 색상 삼중항을 가져올 수 있습니다. 색상 이름으로 문자열을 받아 해당 삼중항을 반환합니다. 이 메서드는 540개 이상의 색상 이름을 알고 있습니다 -- 섹션 :ref:`ColorDatabase` 를 참조하세요." #: ../../shape.rst:577 3313c7d4006745a8b2fc466404404f63 msgid "" "Please note that the term *color* usually means \"stroke\" color when " "used in conjunction with fill color." msgstr "*color* 라는 용어는 채우기 색상과 함께 사용될 때 일반적으로 \"스트로크\" 색상을 의미합니다." #: ../../shape.rst:579 0a6d8ba9500941c4bc6aa00352d41451 msgid "" "If letting default a color parameter to `None`, then no resp. color " "selection command will be generated. If *fill* and *color* are both " "`None`, then the drawing will contain no color specification. But it will" " still be \"stroked\", which causes PDF's default color \"black\" be used" " by Adobe Acrobat and all other viewers." msgstr "색상 매개변수의 기본값을 `None` 으로 두면 해당 색상 선택 명령이 생성되지 않습니다. *fill* 과 *color* 가 모두 `None` 이면 그리기에는 색상 사양이 포함되지 않습니다. 하지만 여전히 \"스트로크\"되며, 이로 인해 Adobe Acrobat 및 기타 모든 뷰어에서 PDF의 기본 색상 \"black\" 이 사용됩니다." #: ../../shape.rst:583 2e5246304d274dfaa37af742928af0ea msgid "**width** (*float*)" msgstr "**width** (*float*)" #: ../../shape.rst:585 77b8db9870114d7f91f971f5aaa99512 msgid "" "The stroke (\"border\") width of the elements in a shape (if applicable)." " The default value is 1. The values width, color and fill have the " "following relationship / dependency:" msgstr "shape의 요소의 스트로크(\"테두리\") 너비(해당하는 경우). 기본값은 1입니다. width, color 및 fill 값은 다음과 같은 관계/의존성을 가집니다:" #: ../../shape.rst:587 bd3f3d47979d4ba6967fc689176d7873 msgid "" "If `fill=None` shape elements will always be drawn with a border - even " "if `color=None` (in which case black is taken) or `width=0` (in which " "case 1 is taken)." msgstr "`fill=None` 이면 shape 요소는 항상 테두리와 함께 그려집니다 -- `color=None` (이 경우 검은색이 사용됨)이거나 `width=0` (이 경우 1이 사용됨)인 경우에도 마찬가지입니다." #: ../../shape.rst:588 50e316e85bee43f3ae23b6e8bf36459e msgid "" "Shapes without border can only be achieved if a fill color is specified " "(which may be white of course). To achieve this, specify `width=0`. In " "this case, the ``color`` parameter is ignored." msgstr "테두리 없는 shape는 채우기 색상이 지정된 경우에만 달성할 수 있습니다(물론 흰색일 수 있음). 이를 달성하려면 `width=0` 을 지정하세요. 이 경우 ``color`` 매개변수는 무시됩니다." #: ../../shape.rst:592 dbf0b7aa242944fd9c3dba05b0a5476c msgid "**stroke_opacity / fill_opacity** (*floats*)" msgstr "**stroke_opacity / fill_opacity** (*floats*)" #: ../../shape.rst:594 f10fd732b18e4d06882b251b866820ed msgid "" "Both values are floats in range [0, 1]. Negative values or values > 1 " "will ignored (in most cases). Both set the transparency such that a value" " 0.5 corresponds to 50% transparency, 0 means invisible and 1 means " "intransparent. For e.g. a rectangle the stroke opacity applies to its " "border and fill opacity to its interior." msgstr "두 값 모두 [0, 1] 범위의 float입니다. 음수 값 또는 값 > 1은 (대부분의 경우) 무시됩니다. 둘 다 투명도를 설정하므로 값 0.5는 50% 투명도에 해당하고, 0은 보이지 않음을 의미하며 1은 불투명을 의미합니다. 예를 들어 사각형의 경우 스트로크 불투명도는 테두리에 적용되고 채우기 불투명도는 내부에 적용됩니다." #: ../../shape.rst:596 908ef08674a94047bf811e5db7824042 msgid "" "For text insertions (:meth:`Shape.insert_text` and " ":meth:`Shape.insert_textbox`), use *fill_opacity* for the text. At first " "sight this seems surprising, but it becomes obvious when you look further" " down to `render_mode`: `fill_opacity` applies to the yellow and " "`stroke_opacity` applies to the blue color." msgstr "텍스트 삽입(:meth:`Shape.insert_text` 및 :meth:`Shape.insert_textbox`)의 경우 텍스트에 *fill_opacity* 를 사용합니다. 처음에는 놀라울 수 있지만 `render_mode` 를 보면 명확해집니다: `fill_opacity` 는 노란색에 적용되고 `stroke_opacity` 는 파란색에 적용됩니다." #: ../../shape.rst:600 807dedb850524343a44713165dc92d74 msgid "**border_width** (*float*)" msgstr "**border_width** (*float*)" #: ../../shape.rst:602 7c05f5b49a074002a9a8e24fa16e09c0 msgid "" "Set the border width for text insertions. New in v1.14.9. Relevant only " "if the render mode argument is used with a value greater zero." msgstr "텍스트 삽입의 테두리 너비를 설정합니다. v1.14.9의 새로운 기능. 렌더 모드 인수가 0보다 큰 값으로 사용되는 경우에만 관련됩니다." #: ../../shape.rst:606 e8f74369b5414cf39c02c7bdc84d0278 msgid "**render_mode** (*int*)" msgstr "**render_mode** (*int*)" #: ../../shape.rst:608 07e11204dc2b4479bd2e65c3e33aad8d msgid "" "*New in version 1.14.9:* Integer in `range(8)` which controls the text " "appearance (:meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`). " "See page 246 in :ref:`AdobeManual`. New in v1.14.9. These methods now " "also differentiate between fill and stroke colors." msgstr "*버전 1.14.9의 새로운 기능:* 텍스트 모양을 제어하는 `range(8)` 의 정수(:meth:`Shape.insert_text` 및 :meth:`Shape.insert_textbox`). :ref:`AdobeManual` 246페이지를 참조하세요. v1.14.9의 새로운 기능. 이 메서드는 이제 채우기 색상과 스트로크 색상을 구분합니다." #: ../../shape.rst:610 69a9ed429520483291966e04bc134827 msgid "" "For default 0, only the text fill color is used to paint the text. For " "backward compatibility, using the *color* parameter instead also works." msgstr "기본값 0의 경우 텍스트를 그리는 데 텍스트 채우기 색상만 사용됩니다. 하위 호환성을 위해 *color* 매개변수를 대신 사용해도 작동합니다." #: ../../shape.rst:611 92f8238398a445de9ac634455065140b msgid "" "For render mode 1, only the border of each glyph (i.e. text character) is" " drawn with a thickness as set in argument *border_width*. The color " "chosen in the *color* argument is taken for this, the *fill* parameter is" " ignored." msgstr "렌더 모드 1의 경우 각 글리프(즉, 텍스트 문자)의 테두리만 인수 *border_width* 에 설정된 두께로 그려집니다. *color* 인수에서 선택한 색상이 사용되며 *fill* 매개변수는 무시됩니다." #: ../../shape.rst:612 6dd3e1055d934657ae6fbe17f98f1b7b msgid "" "For render mode 2, the glyphs are filled and stroked, using both color " "parameters and the specified border width. You can use this value to " "simulate **bold text** without using another font: choose the same value " "for *fill* and *color* and an appropriate value for *border_width*." msgstr "렌더 모드 2의 경우 글리프가 채워지고 스트로크되며, 두 색상 매개변수와 지정된 테두리 너비를 사용합니다. 다른 글꼴을 사용하지 않고 **굵은 텍스트** 를 시뮬레이션하려면 이 값을 사용할 수 있습니다: *fill* 과 *color* 에 동일한 값을 선택하고 *border_width* 에 적절한 값을 선택하세요." #: ../../shape.rst:613 44ab50cc9488478cbafcd5e8d9859763 msgid "" "For render mode 3, the glyphs are neither stroked nor filled: the text " "becomes invisible." msgstr "렌더 모드 3의 경우 글리프가 스트로크되지도 채워지지도 않습니다: 텍스트가 보이지 않게 됩니다." #: ../../shape.rst:615 e59e76826913438ea50a2cc075ab7cd2 msgid "" "The following examples use border_width=0.3, together with a fontsize of " "15. Stroke color is blue and fill color is some yellow." msgstr "다음 예제는 border_width=0.3과 함께 fontsize 15를 사용합니다. 스트로크 색상은 파란색이고 채우기 색상은 노란색입니다." #: ../../shape.rst:621 082047ee68a54ee3ae920d7817052247 msgid "**miter_limit** (*float*)" msgstr "**miter_limit** (*float*)" #: ../../shape.rst:623 5df811fb349949d38e4160fbc8097077 msgid "" "A float specifying the maximum acceptable value of the quotient `miter-" "length / line-width` (\"miter quotient\"). Used in text output methods. " "This is only relevant for non-zero render mode values -- then, characters" " are written with border lines (i.e. \"stroked\")." msgstr "몫 `miter-length / line-width` (\"miter quotient\")의 최대 허용 값을 지정하는 float. 텍스트 출력 메서드에서 사용됩니다. 이것은 0이 아닌 렌더 모드 값에만 관련됩니다 -- 그런 경우 문자는 테두리 선(즉, \"스트로크\")으로 작성됩니다." #: ../../shape.rst:625 fcdf5a0b4b05400fabcc68e71bbfe4a3 msgid "" "If two lines stroking some character meet at a sharp (<= 90°) angle and " "the line width is large enough, then \"spikes\" may become visible -- " "causing an ugly appearance as shown below. For more background, see page " "126 of the :ref:`AdobeManual`." msgstr "일부 문자를 스트로크하는 두 선이 날카로운 (<= 90°) 각도로 만나고 선 너비가 충분히 크면 \"스파이크\"가 보일 수 있습니다 -- 아래와 같이 보기 흉한 모양을 만듭니다. 더 자세한 내용은 :ref:`AdobeManual` 126페이지를 참조하세요." #: ../../shape.rst:627 61ef12d76d4c44a5971fbe5f377e42cd msgid "" "For instance, when joins meet at 90°, then the miter length is ``sqrt(2) " "* line-width``, so the miter quotient is ``sqrt(2)``." msgstr "예를 들어, 조인이 90°에서 만나면 miter 길이는 ``sqrt(2) * line-width`` 이므로 miter 몫은 ``sqrt(2)`` 입니다." #: ../../shape.rst:629 6e57edd425af46cab1f0544ea9fb09d6 msgid "" "If ``miter_limit`` is exceeded, then all joins with a larger qotient will" " appear as beveled (\"butt\" appearance)." msgstr "``miter_limit`` 이 초과되면 더 큰 몫을 가진 모든 조인이 베벨 처리된 것처럼(\"butt\" 모양) 나타납니다." #: ../../shape.rst:631 1b9c88426fad4881993b42f8df4e29ba msgid "" "The default value 1 (and any smaller value) will ensure that all joins " "are rendered as a butt. A value of ``None`` will use the PDF default " "value." msgstr "기본값 1(및 더 작은 값)은 모든 조인이 butt로 렌더링되도록 보장합니다. ``None`` 값은 PDF 기본값을 사용합니다." #: ../../shape.rst:633 6c5240d22b91424eb8a99f3f6cdd9e61 msgid "Example text showing spikes (``miter_limit=None``):" msgstr "스파이크를 보여주는 예제 텍스트 (``miter_limit=None``):" #: ../../shape.rst:637 22b2f2ab87704749865bf8654f86f486 msgid "Example text suppressing spikes (``miter_limit=1``):" msgstr "스파이크를 억제하는 예제 텍스트 (``miter_limit=1``):" #: ../../shape.rst:643 ef72de748a3241f494828889b778a5c3 msgid "**overlay** (*bool*)" msgstr "**overlay** (*bool*)" #: ../../shape.rst:645 1a50148614e94b0f9e09a72b981ba540 msgid "Causes the item to appear in foreground (default) or background." msgstr "항목이 전경(기본값) 또는 배경에 나타나도록 합니다." #: ../../shape.rst:649 f9c30f5c9a0245e5acbf5d0126b40609 msgid "**morph** (*sequence*)" msgstr "**morph** (*sequence*)" #: ../../shape.rst:651 5029b952e1be402ea4aea727b6c5334a msgid "" "Causes \"morphing\" of either a shape, created by the *draw*()* methods, " "or the text inserted by page methods *insert_textbox()* / " "*insert_text()*. If not ``None``, it must be a pair *(fixpoint, matrix)*," " where *fixpoint* is a :ref:`Point` and *matrix* is a :ref:`Matrix`. The " "matrix can be anything except translations, i.e. *matrix.e == matrix.f ==" " 0* must be true. The point is used as a fixed point for the matrix " "operation. For example, if *matrix* is a rotation or scaling, then " "*fixpoint* is its center. Similarly, if *matrix* is a left-right or up-" "down flip, then the mirroring axis will be the vertical, respectively " "horizontal line going through *fixpoint*, etc." msgstr "*draw*()* 메서드로 생성된 shape 또는 페이지 메서드 *insert_textbox()* / *insert_text()* 로 삽입된 텍스트의 \"변형\"을 일으킵니다. ``None`` 이 아니면 *(fixpoint, matrix)* 쌍이어야 하며, 여기서 *fixpoint* 는 :ref:`Point` 이고 *matrix* 는 :ref:`Matrix` 입니다. 행렬은 이동을 제외한 모든 것이 될 수 있습니다. 즉, *matrix.e == matrix.f == 0* 이 참이어야 합니다. 점은 행렬 작업의 고정점으로 사용됩니다. 예를 들어, *matrix* 가 회전 또는 확대/축소이면 *fixpoint* 는 중심입니다. 마찬가지로, *matrix* 가 좌우 또는 상하 뒤집기이면 미러링 축은 각각 *fixpoint* 를 통과하는 수직 또는 수평선이 됩니다." #: ../../shape.rst:653 b02e3c71c8f64fc68a15b90bf3c129ea msgid "" "Several methods contain checks whether the to be inserted items will " "actually fit into the page (like :meth:`Shape.insert_text`, or " ":meth:`Shape.draw_rect`). For the result of a morphing operation there is" " however no such guaranty: this is entirely the programmer's " "responsibility." msgstr "여러 메서드는 삽입될 항목이 실제로 페이지에 맞는지 확인합니다(:meth:`Shape.insert_text` 또는 :meth:`Shape.draw_rect` 등). 하지만 변형 작업의 결과에 대해서는 그러한 보장이 없습니다: 이것은 전적으로 프로그래머의 책임입니다." #: ../../shape.rst:657 62281c77ca8f47188d63f20f3712a5b0 msgid "**lineCap (deprecated: \"roundCap\")** (*int*)" msgstr "**lineCap (더 이상 사용되지 않음: \"roundCap\")** (*int*)" #: ../../shape.rst:659 cd5b630baa744b1189ae847e6e8286fd msgid "" "Controls the look of line ends. The default value 0 lets each line end at" " exactly the given coordinate in a sharp edge. A value of 1 adds a semi-" "circle to the ends, whose center is the end point and whose diameter is " "the line width. Value 2 adds a semi-square with an edge length of line " "width and a center of the line end." msgstr "선 끝의 모양을 제어합니다. 기본값 0은 각 선이 날카로운 가장자리에서 정확히 주어진 좌표에서 끝나도록 합니다. 값 1은 끝에 반원을 추가하며, 중심은 끝점이고 지름은 선 너비입니다. 값 2는 선 너비의 가장자리 길이와 선 끝의 중심을 가진 반사각형을 추가합니다." #: ../../shape.rst:661 6026a44a326145afa3e7a6f376a1bbf6 msgid "*Changed in version 1.14.15*" msgstr "*버전 1.14.15에서 변경됨*" #: ../../shape.rst:665 2e6dced4dc3b49d0bfc6d15aba362eba msgid "**lineJoin** (*int*)" msgstr "**lineJoin** (*int*)" #: ../../shape.rst:667 66fbb0a47a7648efa567adac178985a1 msgid "" "*New in version 1.14.15:* Controls the way how line connections look " "like. This may be either as a sharp edge (0), a rounded join (1), or a " "cut-off edge (2, \"butt\")." msgstr "*버전 1.14.15의 새로운 기능:* 선 연결의 모양을 제어합니다. 이것은 날카로운 가장자리(0), 둥근 조인(1) 또는 잘린 가장자리(2, \"butt\")일 수 있습니다." #: ../../shape.rst:671 82bab1c6af0a4d169a36b68529a2ab41 msgid "**closePath** (*bool*)" msgstr "**closePath** (*bool*)" #: ../../shape.rst:673 991347c321464275b6f78b81a2f89e09 msgid "" "Causes the end point of a drawing to be automatically connected with the " "starting point (by a straight line)." msgstr "그리기의 끝점을 시작점과 자동으로 연결합니다(직선으로)." #: ../../footer.rst:46 703f5e6cdc364cd898823615d897ea50 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/story-class.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 4450760445994835a9f3775bc9c6f0d5 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 418de775a4634f88837f5ac77a451b10 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 497384ace3f84fa19412dac9da22148c msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../story-class.rst:7 8fafdeea9e5940c28193c7e4fca942c5 msgid "Story" msgstr "Story" #: ../../story-class.rst:11 ce4d16eaf6e64bc59264c0a812630ed7 msgid "New in v1.21.0" msgstr "v1.21.0 에서 새로 추가됨" #: ../../story-class.rst:14 9b7cd17b7b8b43e89336e41091ffd8db msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../story-class.rst:14 306881cbd8ff40e98c769bdad361af16 msgid "**Short Description**" msgstr "**간단한 설명**" #: ../../story-class.rst:16 87f3b530a2174677808e6a73c8c7c3d4 msgid ":meth:`Story.reset`" msgstr ":meth:`Story.reset`" #: ../../story-class.rst:16 986c1b4812b34f7b90447c9b85c00515 msgid "\"rewind\" story output to its beginning" msgstr "스토리 출력을 시작 부분으로 \"되감기\"" #: ../../story-class.rst:17 acfb8788456043e98e066d8b7f232242 msgid ":meth:`Story.place`" msgstr ":meth:`Story.place`" #: ../../story-class.rst:17 71dd7b0f8852455eb72f274d589300e5 msgid "compute story content to fit in provided rectangle" msgstr "제공된 사각형에 맞도록 스토리 콘텐츠 계산" #: ../../story-class.rst:18 f37a1cf6b3d447fcb752828907626437 msgid ":meth:`Story.draw`" msgstr ":meth:`Story.draw`" #: ../../story-class.rst:18 44a1f29ca77c4ed281ff70a784a28d92 msgid "write the computed content to current page" msgstr "계산된 콘텐츠를 현재 페이지에 쓰기" #: ../../story-class.rst:19 fc8ae71a62484786b2548b2f0715d3e7 msgid ":meth:`Story.element_positions`" msgstr ":meth:`Story.element_positions`" #: ../../story-class.rst:19 78ea4b34e9924ea0b59ec0f387db8d9f msgid "callback function logging currently processed story content" msgstr "현재 처리 중인 스토리 콘텐츠를 로깅하는 콜백 함수" #: ../../story-class.rst:20 5703135b6e844a53859347624fb3ba8e msgid ":attr:`Story.body`" msgstr ":attr:`Story.body`" #: ../../story-class.rst:20 8074d90f9db0473c9f78fde5598d87a0 msgid "the story's underlying :htmlTag:`body`" msgstr "스토리의 기본 :htmlTag:`body`" #: ../../story-class.rst:21 b7007d57a5f0478da333d3b7defa34da msgid ":meth:`Story.write`" msgstr ":meth:`Story.write`" #: ../../story-class.rst:21 529c592a049543488f766ea64af4aef6 msgid "places and draws Story to a DocumentWriter" msgstr "Story를 DocumentWriter에 배치하고 그리기" #: ../../story-class.rst:22 48189b1970a944249727deeaab30767a msgid ":meth:`Story.write_stabilized`" msgstr ":meth:`Story.write_stabilized`" #: ../../story-class.rst:22 c71c16dc9e434b81ae25d7e81791842c msgid "iterative layout of html content to a DocumentWriter" msgstr "HTML 콘텐츠를 DocumentWriter에 반복 레이아웃" #: ../../story-class.rst:23 926f2a550c3b4cb3856a305b4c499249 msgid ":meth:`Story.write_with_links`" msgstr ":meth:`Story.write_with_links`" #: ../../story-class.rst:23 ea4c862bdeb84b94a80868a8fa1d6d3c msgid "like `write()` but also creates PDF links" msgstr "`write()` 와 유사하지만 PDF 링크도 생성" #: ../../story-class.rst:24 355d937b5c4a4d2ea430c50ed160c9a9 msgid ":meth:`Story.write_stabilized_with_links`" msgstr ":meth:`Story.write_stabilized_with_links`" #: ../../story-class.rst:24 ff1a2e0bd3b942a9825101dc74641ab4 msgid "like `write_stabilized()` but also creates PDF links" msgstr "`write_stabilized()` 와 유사하지만 PDF 링크도 생성" #: ../../story-class.rst:25 98afa53a01d5479fb9a84e798fc75af0 msgid ":meth:`Story.fit`" msgstr ":meth:`Story.fit`" #: ../../story-class.rst:25 ../../story-class.rst:252 #: 08f697738e6841388fafdd24e5a00d7d f9fb3d7fc30744c5a4bcf19dc86ef076 msgid "Finds optimal rect that contains the story `self`." msgstr "스토리 `self` 를 포함하는 최적의 rect를 찾습니다." #: ../../story-class.rst:26 071db5186e824d7fad400d8f4d4621cc msgid ":meth:`Story.fit_scale`" msgstr ":meth:`Story.fit_scale`" #: ../../story-class.rst:27 29faf46f8f304213baacc284272e99ba msgid ":meth:`Story.fit_height`" msgstr ":meth:`Story.fit_height`" #: ../../story-class.rst:28 2063bec0fd3d4a00af6338d93189ee72 msgid ":meth:`Story.fit_width`" msgstr ":meth:`Story.fit_width`" #: ../../story-class.rst:31 35c3d645808f404fb3d0ac4e2995d443 msgid "**Class API**" msgstr "**클래스 API**" #: ../../story-class.rst:37 49eb5559ce2b4b13a47f5ad496e9d111 msgid "" "Create a **story**, optionally providing HTML and CSS source. The HTML is" " parsed, and held within the Story as a DOM (Document Object Model)." msgstr "**스토리** 를 생성하며, 선택적으로 HTML 및 CSS 소스를 제공합니다. HTML은 파싱되어 Story 내에서 DOM(Document Object Model)로 유지됩니다." #: ../../story-class.rst:40 bf2f904ab1c24ea9aa46205eca2718ea msgid "" "This structure may be modified: content (text, images) may be added, " "copied, modified or removed by using methods of the :ref:`Xml` class." msgstr "이 구조는 수정할 수 있습니다: :ref:`Xml` 클래스의 메서드를 사용하여 콘텐츠(텍스트, 이미지)를 추가, 복사, 수정 또는 제거할 수 있습니다." #: ../../story-class.rst:43 1e855bc531eb4f55a7c51053f068d9ab msgid "" "When finished, the **story** can be written to any device; in typical " "usage the device may be provided by a :ref:`DocumentWriter` to make new " "pages." msgstr "완료되면 **스토리** 는 모든 장치에 쓸 수 있습니다. 일반적인 사용에서 장치는 :ref:`DocumentWriter` 에 의해 제공되어 새 페이지를 만듭니다." #: ../../story-class.rst:46 c090bdee02db4f288f710c647c45c161 msgid "Here are some general remarks:" msgstr "다음은 일반적인 설명입니다:" #: ../../story-class.rst:48 3110c6455944434ca9ae1a71696896a3 msgid "" "The :ref:`Story` constructor parses and validates the provided HTML to " "create the DOM." msgstr ":ref:`Story` 생성자는 제공된 HTML을 파싱하고 검증하여 DOM을 생성합니다." #: ../../story-class.rst:49 4d9f69c5792d489b85a3b9d41d525d79 msgid "" "PyMuPDF provides a number of ways to manipulate the HTML source by " "providing access to the *nodes* of the underlying DOM. Documents can be " "completely built from ground up programmatically, or the existing DOM can" " be modified pretty arbitrarily. For details of this interface, please " "see the :ref:`Xml` class." msgstr "|PyMuPDF| 는 기본 DOM의 *노드* 에 대한 액세스를 제공하여 HTML 소스를 조작하는 여러 방법을 제공합니다. 문서는 프로그래밍 방식으로 처음부터 완전히 구축할 수 있거나, 기존 DOM을 거의 임의로 수정할 수 있습니다. 이 인터페이스의 세부 사항은 :ref:`Xml` 클래스를 참조하세요." #: ../../story-class.rst:54 ac1a27756a8945c8b1dbf9b6e9da921b msgid "" "If no (or no more) changes to the DOM are required, the story is ready to" " be laid out and to be fed to a series of devices (typically devices " "provided by a :ref:`DocumentWriter` to produce new pages)." msgstr "DOM에 대한 변경이 더 이상 필요하지 않으면 스토리는 레이아웃되고 일련의 장치(일반적으로 새 페이지를 생성하기 위해 :ref:`DocumentWriter` 에 의해 제공되는 장치)에 공급할 준비가 됩니다." #: ../../story-class.rst:57 43fe3dfc3cf348098a32b05485bde654 msgid "" "The next step is to place the story and write it out. This can either be " "done directly, by looping around calling `place()` and `draw()`, or " "alternatively, the looping can handled for you using the `write()` or " "`write_stabilised()` methods. Which method you choose is largely a matter" " of taste." msgstr "다음 단계는 스토리를 배치하고 쓰는 것입니다. 이것은 `place()` 및 `draw()` 호출을 반복하는 루프로 직접 수행하거나, 대신 `write()` 또는 `write_stabilised()` 메서드를 사용하여 루프를 처리할 수 있습니다. 어떤 방법을 선택할지는 주로 취향의 문제입니다." #: ../../story-class.rst:63 f4b32731d97b4d2a84d306de1e33820a msgid "To work in the first of these styles, the following loop should be used:" msgstr "이러한 스타일 중 첫 번째로 작업하려면 다음 루프를 사용해야 합니다:" #: ../../story-class.rst:65 1ae96b31b4494e6b907dcec02c2fdea5 msgid "" "Obtain a suitable device to write to; typically by requesting a new, " "empty page from a :ref:`DocumentWriter`." msgstr "쓰기에 적합한 장치를 얻습니다. 일반적으로 :ref:`DocumentWriter` 에서 새 빈 페이지를 요청합니다." #: ../../story-class.rst:68 73b9d54af347493b94d1d93c72bb7e84 msgid "" "Determine one or more rectangles on the page, that should receive " "**story** data. Note that not every page needs to have the same set of " "rectangles." msgstr "페이지에서 **스토리** 데이터를 받을 하나 이상의 사각형을 결정합니다. 모든 페이지가 동일한 사각형 세트를 가질 필요는 없습니다." #: ../../story-class.rst:71 f486ccb350994671b7e2380f3a839e86 msgid "" "Pass each rectangle to the **story** to place it, learning what part of " "that rectangle has been filled, and whether there is more story data that" " did not fit. This step can be repeated several times with adjusted " "rectangles until the caller is happy with the results." msgstr "각 사각형을 **스토리** 에 전달하여 배치하고, 해당 사각형의 어느 부분이 채워졌는지, 맞지 않는 더 많은 스토리 데이터가 있는지 확인합니다. 이 단계는 호출자가 결과에 만족할 때까지 조정된 사각형으로 여러 번 반복할 수 있습니다." #: ../../story-class.rst:76 ff1738fc7d2d4f969c58dcf423696458 msgid "" "Optionally, at this point, we can request details of where interesting " "items have been placed, by calling the `element_positions()` method. " "Items are deemed to be interesting if their integer `heading` attribute " "is a non-zero (corresponding to HTML tags :htmlTag:`h1` - :htmlTag:`h6`)," " if their `id` attribute is not `None` (corresponding to HTML tag " ":htmlTag:`id`), or if their `href` attribute is not `None` (responding to" " HTML tag :htmlTag:`href`). This can conveniently be used for automatic " "generation of a Table of Contents, an index of images or the like." msgstr "선택적으로 이 시점에서 `element_positions()` 메서드를 호출하여 흥미로운 항목이 배치된 위치에 대한 세부 정보를 요청할 수 있습니다. 항목은 정수 `heading` 속성이 0이 아닌 경우(HTML 태그 :htmlTag:`h1` - :htmlTag:`h6` 에 해당), `id` 속성이 `None` 이 아닌 경우(HTML 태그 :htmlTag:`id` 에 해당), 또는 `href` 속성이 `None` 이 아닌 경우(HTML 태그 :htmlTag:`href` 에 해당) 흥미로운 것으로 간주됩니다. 이것은 목차, 이미지 인덱스 등의 자동 생성에 편리하게 사용할 수 있습니다." #: ../../story-class.rst:85 b921780cdb2e45e389e9a40859c21b25 msgid "Next, draw that rectangle out to the device with the `draw()` method." msgstr "다음으로 `draw()` 메서드를 사용하여 해당 사각형을 장치에 그립니다." #: ../../story-class.rst:86 7c8805ef770e4dde8806474fd720a74d msgid "" "If the most recent call to `place()` indicated that all the story data " "had fitted, stop now." msgstr "`place()` 에 대한 가장 최근 호출이 모든 스토리 데이터가 맞았다고 표시하면 지금 중지합니다." #: ../../story-class.rst:88 c13e1999d6654790a96926efb47a4809 msgid "" "Otherwise, we can loop back. If there are more rectangles to be placed on" " the current device (page), we jump back to step 3 - if not, we jump back" " to step 1 to get a new device." msgstr "그렇지 않으면 루프로 돌아갈 수 있습니다. 현재 장치(페이지)에 배치할 더 많은 사각형이 있으면 3단계로 돌아가고, 그렇지 않으면 새 장치를 얻기 위해 1단계로 돌아갑니다." #: ../../story-class.rst:91 4038804e871b4c1bbe32c9a13c9ec423 msgid "" "Alternatively, in the case where you are using a :ref:`DocumentWriter`, " "the `write()` or `write_stabilized()` methods can be used. These handle " "all the looping for you, in exchange for being provided with callbacks " "that control the behaviour (notably a callback that enumerates the " "rectangles/pages to use)." msgstr "대안으로 :ref:`DocumentWriter` 를 사용하는 경우 `write()` 또는 `write_stabilized()` 메서드를 사용할 수 있습니다. 이것들은 동작을 제어하는 콜백(특히 사용할 사각형/페이지를 열거하는 콜백)을 제공하는 대가로 모든 루프를 처리합니다." #: ../../story-class.rst:96 ee657bc17cb9479098b79a0775f10c3a msgid "" "Which part of the **story** will land on which rectangle / which page, is" " fully under control of the :ref:`Story` object and cannot be predicted." msgstr "**스토리** 의 어느 부분이 어떤 사각형/어떤 페이지에 배치될지는 :ref:`Story` 객체의 완전한 제어 하에 있으며 예측할 수 없습니다." #: ../../story-class.rst:98 2373c29f02c449119f61da189826bc09 msgid "" "Images may be part of a **story**. They will be placed together with any " "surrounding text." msgstr "이미지는 **스토리** 의 일부일 수 있습니다. 주변 텍스트와 함께 배치됩니다." #: ../../story-class.rst:99 30316b2b832342268461f6c7d74a9197 msgid "" "Multiple stories may - independently from each other - write to the same " "page. For example, one may have separate stories for page header, page " "footer, regular text, comment boxes, etc." msgstr "여러 스토리는 서로 독립적으로 같은 페이지에 쓸 수 있습니다. 예를 들어 페이지 헤더, 페이지 푸터, 일반 텍스트, 주석 상자 등에 대해 별도의 스토리를 가질 수 있습니다." #: ../../story-class.rst 3bc54fe727d84b0fb5ec6f5a505593d7 #: 632479f010e74a7fa705e9873fc201e2 6bae93af6e1f4bcd9f975e3dbf237a8f #: 76b91680f9494dcda1b320b971f127f3 835ef3aac08946a7b21892dd5d446841 #: 9faeb1de8c834831b2eefc6ba27d02c6 a7f1db20a98f4acd8ac3a50281de1d54 #: b092aa952799492ab41859def37221e6 c431629c4269486e838a6416b26f8a06 #: ecb562eb477f4178bbbac8624595e806 msgid "Parameters" msgstr "매개변수" #: ../../story-class.rst:103 7a7770ae27444f9cbae197749eec78ab msgid "" "HTML source code. If omitted, a basic minimum is generated (see below). " "If provided, not a complete HTML document is needed. The in-built source " "parser will forgive (many / most) HTML syntax errors and also accepts " "HTML fragments like `\"Hello, World!\"`." msgstr "HTML 소스 코드. 생략하면 기본 최소값이 생성됩니다(아래 참조). 제공된 경우 완전한 HTML 문서가 필요하지 않습니다. 내장 소스 파서는 (많은/대부분의) HTML 구문 오류를 용서하며 `\"Hello, World!\"` 와 같은 HTML 조각도 허용합니다." #: ../../story-class.rst:108 998745be0a874eeb8f4d73e3411eb0cc msgid "CSS source code. If provided, must contain valid CSS specifications." msgstr "CSS 소스 코드. 제공된 경우 유효한 CSS 사양을 포함해야 합니다." #: ../../story-class.rst:109 2bfac39f7a0745239025903a70202169 msgid "the default text font size." msgstr "기본 텍스트 글꼴 크기." #: ../../story-class.rst:110 78219d1129fc40ab9949caef213ed7a5 msgid "" "an :ref:`Archive` from which to load resources for rendering. Currently " "supported resource types are images and text fonts. If omitted, the story" " will not try to look up any such data and may thus produce incomplete " "output. .. note:: Instead of an actual archive, valid arguments for " "**creating** an :ref:`Archive` can also be provided -- in which case an " "archive will temporarily be constructed. So, instead of `story = " "pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))`, one can also " "shorter write `story = pymupdf.Story(archive=\"myfolder\")`." msgstr "" #: ../../story-class.rst:110 4050936d618a42da8eecf6ab4e063d8b msgid "" "an :ref:`Archive` from which to load resources for rendering. Currently " "supported resource types are images and text fonts. If omitted, the story" " will not try to look up any such data and may thus produce incomplete " "output." msgstr "렌더링을 위한 리소스를 로드할 :ref:`Archive`. 현재 지원되는 리소스 타입은 이미지와 텍스트 글꼴입니다. 생략하면 스토리는 이러한 데이터를 찾으려고 시도하지 않으므로 불완전한 출력을 생성할 수 있습니다." #: ../../story-class.rst:112 dbafa089e71b405c8505fe068f111435 msgid "" "Instead of an actual archive, valid arguments for **creating** an " ":ref:`Archive` can also be provided -- in which case an archive will " "temporarily be constructed. So, instead of `story = " "pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))`, one can also " "shorter write `story = pymupdf.Story(archive=\"myfolder\")`." msgstr "실제 아카이브 대신 :ref:`Archive` 를 **생성** 하기 위한 유효한 인수도 제공할 수 있습니다. 이 경우 아카이브가 임시로 구성됩니다. 따라서 `story = pymupdf.Story(archive=pymupdf.Archive(\"myfolder\"))` 대신 `story = pymupdf.Story(archive=\"myfolder\")` 로 더 짧게 쓸 수도 있습니다." #: ../../story-class.rst:116 38e199a574974c68a5789c3487298702 msgid "" "Calculate that part of the story's content, that will fit in the provided" " rectangle. The method maintains a pointer which part of the story's " "content has already been written and upon the next invocation resumes " "from that pointer's position." msgstr "제공된 사각형에 맞는 스토리 콘텐츠의 일부를 계산합니다. 이 메서드는 스토리 콘텐츠의 어느 부분이 이미 쓰여졌는지에 대한 포인터를 유지하며, 다음 호출 시 해당 포인터 위치에서 재개합니다." #: ../../story-class.rst:118 9204c5de62594877a0b9554fe46dd00d msgid "" "layout the current part of the content to fit into this rectangle. This " "must be a sub-rectangle of the page's :ref:`MediaBox`." msgstr "콘텐츠의 현재 부분을 이 사각형에 맞도록 레이아웃합니다. 이것은 페이지의 :ref:`MediaBox` 의 하위 사각형이어야 합니다." #: ../../story-class.rst f63a283a6c88499ead37123b58293124 msgid "Return type" msgstr "반환 타입" #: ../../story-class.rst 94bc5676fca747a28908e39b08f758dd msgid "Returns" msgstr "반환값" #: ../../story-class.rst:121 cfc9d87ae2c0427fb812923a5380f63e msgid "" "a bool (int) `more` and a rectangle `filled`. If `more == 0`, all content" " of the story has been written, otherwise more is waiting to be written " "to subsequent rectangles / pages. Rectangle `filled` is the part of " "`where` that has actually been filled." msgstr "bool(int) `more` 와 사각형 `filled`. `more == 0` 이면 스토리의 모든 콘텐츠가 쓰여진 것이고, 그렇지 않으면 더 많은 콘텐츠가 후속 사각형/페이지에 쓰이기를 기다리고 있습니다. 사각형 `filled` 는 실제로 채워진 `where` 의 부분입니다." #: ../../story-class.rst:125 6813b9d6cf0a4992aac607d827be601c msgid "Write the content part prepared by :meth:`Story.place` to the page." msgstr ":meth:`Story.place` 로 준비된 콘텐츠 부분을 페이지에 씁니다." #: ../../story-class.rst:127 883fc316b5194fbebc4f2e1002d07a4a msgid "" "the :ref:`Device` created by `dev = writer.begin_page(mediabox)`. The " "device knows how to call all MuPDF functions needed to write the content." msgstr "`dev = writer.begin_page(mediabox)` 로 생성된 :ref:`Device`. 장치는 콘텐츠를 쓰는 데 필요한 모든 MuPDF 함수를 호출하는 방법을 알고 있습니다." #: ../../story-class.rst:128 15d1012c1f36445b97b2245366f1fe29 msgid "" "a matrix for transforming content when writing to the page. An example " "may be writing rotated text. The default means no transformation (i.e. " "the :ref:`Identity` matrix)." msgstr "페이지에 쓸 때 콘텐츠를 변환하는 행렬. 예를 들어 회전된 텍스트를 쓰는 것입니다. 기본값은 변환 없음(즉, :ref:`Identity` 행렬)을 의미합니다." #: ../../story-class.rst:132 a4b6e0a215c74c77bc15ee4a585a753c msgid "" "Let the Story provide positioning information about certain HTML elements" " once their place on the current page has been computed - i.e. invoke " "this method **directly after** :meth:`Story.place`." msgstr "Story가 현재 페이지에서의 위치가 계산된 후 특정 HTML 요소에 대한 위치 정보를 제공하도록 합니다. 즉, :meth:`Story.place` **직후에** 이 메서드를 호출합니다." #: ../../story-class.rst:134 132b23607fe24fd4b386d921fa955b1f msgid "" "*Story* will pass position information to *function*. This information " "can for example be used to generate a Table of Contents." msgstr "*Story* 는 위치 정보를 *function* 에 전달합니다. 이 정보는 예를 들어 목차를 생성하는 데 사용할 수 있습니다." #: ../../story-class.rst:136 9b62cdc7c4734ce9bd97fd06ae689ced msgid "" "a Python function accepting an :class:`ElementPosition` object. It will " "be invoked by the Story object to process positioning information. The " "function **must** be a callable accepting exactly one argument." msgstr ":class:`ElementPosition` 객체를 받는 Python 함수. Story 객체에 의해 호출되어 위치 정보를 처리합니다. 함수는 **반드시** 정확히 하나의 인수를 받는 호출 가능한 객체여야 합니다." #: ../../story-class.rst:137 95c635a4d01544919b451835ba7cfb5e msgid "" "an optional dictionary with any **additional** information that should be" " added to the :class:`ElementPosition` instance passed to `function`. " "Like for example the current output page number. Every key in this " "dictionary must be a string that conforms to the rules for a valid Python" " identifier. The complete set of information is explained below." msgstr "`function` 에 전달되는 :class:`ElementPosition` 인스턴스에 추가되어야 하는 **추가** 정보가 있는 선택적 딕셔너리. 예를 들어 현재 출력 페이지 번호입니다. 이 딕셔너리의 모든 키는 유효한 Python 식별자 규칙을 준수하는 문자열이어야 합니다. 전체 정보 세트는 아래에 설명되어 있습니다." #: ../../story-class.rst:146 d1a8ec5e26534fb08b5644c78bdd0f35 msgid "Rewind the story's document to the beginning for starting over its output." msgstr "출력을 다시 시작하기 위해 스토리 문서를 시작 부분으로 되감습니다." #: ../../story-class.rst:150 99e9fa88415b44008dfa1a9212359a94 msgid "" "The :htmlTag:`body` part of the story's DOM. This attribute contains the " ":ref:`Xml` node of :htmlTag:`body`. All relevant content for PDF " "production is contained between \"\" and \"\"." msgstr "스토리 DOM의 :htmlTag:`body` 부분. 이 속성은 :htmlTag:`body` 의 :ref:`Xml` 노드를 포함합니다. PDF 생성을 위한 모든 관련 콘텐츠는 \"\" 와 \"\" 사이에 포함됩니다." #: ../../story-class.rst:154 41b172bf34d0440fadc8322fad80b439 msgid "" "Places and draws Story to a `DocumentWriter`. Avoids the need for calling" " code to implement a loop that calls `Story.place()` and `Story.draw()` " "etc, at the expense of having to provide at least the `rectfn()` " "callback." msgstr "Story를 `DocumentWriter` 에 배치하고 그립니다. `Story.place()` 및 `Story.draw()` 등을 호출하는 루프를 구현하는 호출 코드의 필요성을 피하지만, 최소한 `rectfn()` 콜백을 제공해야 합니다." #: ../../story-class.rst:159 f45d6bee9274444588f63a947cb04ff9 msgid "a `DocumentWriter` or None." msgstr "`DocumentWriter` 또는 None." #: ../../story-class.rst:160 0a82dd0477cc4e6aba46d8bde1ff66cb msgid "" "a callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: " "The next rect into which content should be placed. * ctm: None or a " "`Matrix`." msgstr "" #: ../../story-class.rst:160 09db40fd97944cc3bdc056101682d345 msgid "" "a callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`:" msgstr "`(rect_num: int, filled: Rect)` 를 받아 `(mediabox, rect, ctm)` 를 반환하는 호출 가능한 객체:" #: ../../story-class.rst:163 ../../story-class.rst:204 #: 195039e86a0a453b80a1947c0d982191 cc6afdff529d4b18bf96bab124b071b0 msgid "mediabox: None or rect for new page." msgstr "mediabox: 새 페이지의 None 또는 rect." #: ../../story-class.rst:164 ../../story-class.rst:205 #: 25c7020d98834950b5d94ff65444d7dd 66c0ba4ebccc4299ab74abd2a830ae53 msgid "rect: The next rect into which content should be placed." msgstr "rect: 콘텐츠가 배치될 다음 rect." #: ../../story-class.rst:165 15dd25041536413eb3b45f6c0546d4c9 msgid "ctm: None or a `Matrix`." msgstr "ctm: None 또는 `Matrix`." #: ../../story-class.rst:166 00bf180b2a0c4c8d85c03815119541f1 msgid "" "None, or a callable taking `(position: ElementPosition)`: * position:" " An `ElementPosition` with an extra `.page_num` member. Typically " "called multiple times as we generate elements that are headings or have " "an id." msgstr "" #: ../../story-class.rst:166 25928f4a5c5f491488b15662e26bc608 msgid "None, or a callable taking `(position: ElementPosition)`:" msgstr "None 또는 `(position: ElementPosition)` 를 받는 호출 가능한 객체:" #: ../../story-class.rst:168 2dd05e9f8b994f32855896af88fa138a msgid "position:" msgstr "position:" #: ../../story-class.rst:169 e39ff5907e3f417a840c59e64a0ce9d8 msgid "An `ElementPosition` with an extra `.page_num` member." msgstr "추가 `.page_num` 멤버를 가진 `ElementPosition`." #: ../../story-class.rst:170 4892cafe0f7d41f0985e89860b77823a msgid "" "Typically called multiple times as we generate elements that are headings" " or have an id." msgstr "일반적으로 제목이거나 id를 가진 요소를 생성할 때 여러 번 호출됩니다." #: ../../story-class.rst:172 3fa53b922faa4eda8ba2cba1ac636ca9 msgid "" "None, or a callable taking `(page_num, mediabox, dev, after)`; called at " "start (`after=0`) and end (`after=1`) of each page." msgstr "None 또는 `(page_num, mediabox, dev, after)` 를 받는 호출 가능한 객체. 각 페이지의 시작(`after=0`)과 끝(`after=1`)에서 호출됩니다." #: ../../story-class.rst:178 dd5221f0ed8740b9870aee56024e5b7b msgid "" "Static method that does iterative layout of html content to a " "`DocumentWriter`." msgstr "HTML 콘텐츠를 `DocumentWriter` 에 반복 레이아웃하는 정적 메서드." #: ../../story-class.rst:181 30078c22673b4583b6668ac47bc366ff msgid "" "For example this allows one to add a table of contents section while " "ensuring that page numbers are patched up until stable." msgstr "예를 들어 이것은 페이지 번호가 안정될 때까지 패치되도록 하면서 목차 섹션을 추가할 수 있게 합니다." #: ../../story-class.rst:184 c06d6f0e11c445a79282ea1b2b0ad535 msgid "" "Repeatedly creates a new `Story` from `(contentfn(), user_css, em, " "archive)` and lays it out with internal call to `Story.write()`; uses a " "None writer and extracts the list of `ElementPosition`'s which is passed " "to the next call of `contentfn()`." msgstr "`(contentfn(), user_css, em, archive)` 로부터 새 `Story` 를 반복적으로 생성하고 `Story.write()` 내부 호출로 레이아웃합니다. None writer를 사용하고 `ElementPosition` 목록을 추출하여 `contentfn()` 의 다음 호출에 전달합니다." #: ../../story-class.rst:190 44779b3ded2c4ee6874e7b1ae2bff004 msgid "" "When the html from `contentfn()` becomes unchanged, we do a final " "iteration using `writer`." msgstr "`contentfn()` 의 HTML이 변경되지 않으면 `writer` 를 사용하여 최종 반복을 수행합니다." #: ../../story-class.rst:193 0f2c4d433e064304a49d4bd0a6ebfe73 msgid "A `DocumentWriter`." msgstr "`DocumentWriter`." #: ../../story-class.rst:195 368d195d03b147fc837acd54849c93e0 msgid "" "A function taking a list of `ElementPositions` and returning a string " "containing html. The returned html can depend on the list of positions, " "for example with a table of contents near the start." msgstr "`ElementPositions` 목록을 받아 HTML을 포함하는 문자열을 반환하는 함수. 반환된 HTML은 위치 목록에 따라 달라질 수 있습니다. 예를 들어 시작 부분 근처에 목차가 있습니다." #: ../../story-class.rst:200 1cf1064d178a4eb5abc44f35d1b26213 msgid "" "A callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: " "The next rect into which content should be placed. * ctm: A `Matrix`." msgstr "" #: ../../story-class.rst:201 9c7835ef50c04228a8a373880c57f7ec msgid "" "A callable taking `(rect_num: int, filled: Rect)` and returning " "`(mediabox, rect, ctm)`:" msgstr "`(rect_num: int, filled: Rect)` 를 받아 `(mediabox, rect, ctm)` 를 반환하는 호출 가능한 객체:" #: ../../story-class.rst:206 ee9f39495b5e42c8abe6db31752b059c msgid "ctm: A `Matrix`." msgstr "ctm: `Matrix`." #: ../../story-class.rst:207 0e5bb33450b440519eaa4678352a268d msgid "" "None, or a callable taking `(page_num, medibox, dev, after)`; called at " "start (`after=0`) and end (`after=1`) of each page." msgstr "None 또는 `(page_num, medibox, dev, after)` 를 받는 호출 가능한 객체. 각 페이지의 시작(`after=0`)과 끝(`after=1`)에서 호출됩니다." #: ../../story-class.rst:212 1e4fd7df55fb49df898e449e0f6cc1d4 msgid "" "If true, we add unique ids to all header tags that don't already have an " "id. This can help automatic generation of tables of contents." msgstr "true이면 id가 아직 없는 모든 헤더 태그에 고유 id를 추가합니다. 이것은 목차의 자동 생성에 도움이 될 수 있습니다." #: ../../story-class.rst:216 5855dd1c0eb74ba680d81ec3bd7ab855 msgid "Returns:" msgstr "반환값:" #: ../../story-class.rst:217 b8d9d14cc3f7420cbfcb12cdd3784c27 msgid "None." msgstr "None." #: ../../story-class.rst:221 22ec8dffec4842c2b36b31e44c148e9b msgid "" "Similar to `write()` except that we don't have a `writer` arg and we " "return a PDF `Document` in which links have been created for each " "internal html link." msgstr "`write()` 와 유사하지만 `writer` 인수가 없고 각 내부 HTML 링크에 대해 링크가 생성된 PDF `Document` 를 반환합니다." #: ../../story-class.rst:227 cb292a6045f4454589078e45beb372b8 msgid "" "Similar to `write_stabilized()` except that we don't have a `writer` arg " "and instead return a PDF `Document` in which links have been created for " "each internal html link." msgstr "`write_stabilized()` 와 유사하지만 `writer` 인수가 없고 대신 각 내부 HTML 링크에 대해 링크가 생성된 PDF `Document` 를 반환합니다." #: ../../story-class.rst:233 79e6df9feb764d49bb6c4880d7985f6e msgid "The result from a `Story.fit*()` method." msgstr "`Story.fit*()` 메서드의 결과." #: ../../story-class.rst:235 2a76b4161e5f46ca816faca601040d90 msgid "Members:" msgstr "멤버:" #: ../../story-class.rst:237 035ed3847947402d887364c7d5c447e9 msgid "`big_enough`:" msgstr "`big_enough`:" #: ../../story-class.rst:238 bf717872d31642deaf8eb1605a3012a6 msgid "`True` if the fit succeeded." msgstr "적합이 성공하면 `True`." #: ../../story-class.rst:239 7320376b01af4fa9a8fa3ae295bbda83 msgid "`filled`:" msgstr "`filled`:" #: ../../story-class.rst:240 17cc4e2057bd41cc8e2633814392b385 msgid "From the last call to `Story.place()`." msgstr "`Story.place()` 에 대한 마지막 호출에서." #: ../../story-class.rst:241 e24cc834373e411587bbb7bfa0414333 msgid "`more`:" msgstr "`more`:" #: ../../story-class.rst:242 4a3e937b059041a7b3a20e0d429f503c msgid "`False` if the fit succeeded." msgstr "적합이 성공하면 `False`." #: ../../story-class.rst:243 bbbe1925cdb245ad87cc43c74cf72b73 msgid "`numcalls`:" msgstr "`numcalls`:" #: ../../story-class.rst:244 9e3bcaa3dbf8478a98ff6e4241532bb6 msgid "Number of calls made to `self.place()`." msgstr "`self.place()` 에 대한 호출 횟수." #: ../../story-class.rst:245 169f3c8877c640d8aa7fb28ee47ab520 msgid "`parameter`:" msgstr "`parameter`:" #: ../../story-class.rst:246 985d429bb06144c6bcfa903f4c388ebf msgid "The successful parameter value, or the largest failing value." msgstr "성공한 매개변수 값 또는 가장 큰 실패 값." #: ../../story-class.rst:247 42a31d9fef9248d9a8d194383c59191d msgid "`rect`:" msgstr "`rect`:" #: ../../story-class.rst:248 902774936ea0439f89fd8ff5b6dfc8e4 msgid "The rect created from `parameter`." msgstr "`parameter` 로부터 생성된 rect." #: ../../story-class.rst:254 ../../story-class.rst:282 #: ../../story-class.rst:304 ../../story-class.rst:325 #: 696c11bfa76d489093846a7c247a4851 853a35b41b0d4e92a0abce39320b0d0b #: 8e63b26bcbe146e994f59d0598d8ae81 f109c3abb97c461c90ef5083439ae6b7 msgid "Returns a `Story.FitResult` instance." msgstr "`Story.FitResult` 인스턴스를 반환합니다." #: ../../story-class.rst:256 18ef28643cd147a3a66b0e495f27b656 msgid "" "On success, the last call to `self.place()` will have been with the " "returned rectangle, so `self.draw()` can be used directly." msgstr "성공 시 `self.place()` 에 대한 마지막 호출은 반환된 사각형으로 수행되므로 `self.draw()` 를 직접 사용할 수 있습니다." #: ../../story-class.rst:259 fcc258b789cf4618a282896268872c2f msgid "" "A callable taking a floating point `parameter` and returning a " "`pymupdf.Rect()`. If the rect is empty, we assume the story will not fit " "and do not call `self.place()`. Must guarantee that `self.place()` " "behaves monotonically when given rect `fn(parameter`) as `parameter` " "increases. This usually means that both width and height increase or stay" " unchanged as `parameter` increases." msgstr "" #: ../../story-class.rst:260 c6955c50c2ba4885973d0c3f04c0e2c5 msgid "" "A callable taking a floating point `parameter` and returning a " "`pymupdf.Rect()`. If the rect is empty, we assume the story will not fit " "and do not call `self.place()`." msgstr "부동 소수점 `parameter` 를 받아 `pymupdf.Rect()` 를 반환하는 호출 가능한 객체. rect가 비어 있으면 스토리가 맞지 않는다고 가정하고 `self.place()` 를 호출하지 않습니다." #: ../../story-class.rst:264 d7e59ae0c80245ab9c009b98fd8b45c0 msgid "" "Must guarantee that `self.place()` behaves monotonically when given rect " "`fn(parameter`) as `parameter` increases. This usually means that both " "width and height increase or stay unchanged as `parameter` increases." msgstr "`parameter` 가 증가할 때 rect `fn(parameter`)가 주어지면 `self.place()` 가 단조롭게 동작하도록 보장해야 합니다. 이것은 일반적으로 `parameter` 가 증가할 때 너비와 높이가 모두 증가하거나 변경되지 않음을 의미합니다." #: ../../story-class.rst:268 11dc2ac2cfa948f9b5a1f9820e2552e5 msgid "Minimum parameter to consider; `None` for -infinity." msgstr "고려할 최소 매개변수. `None` 이면 -무한대." #: ../../story-class.rst:270 318cf2242b354dcfaf2261319967a6e2 msgid "Maximum parameter to consider; `None` for +infinity." msgstr "고려할 최대 매개변수. `None` 이면 +무한대." #: ../../story-class.rst:272 c04b8320d63941998719b704f3829f97 msgid "Maximum error in returned `parameter`." msgstr "반환된 `parameter` 의 최대 오류." #: ../../story-class.rst:274 ../../story-class.rst:295 #: ../../story-class.rst:317 ../../story-class.rst:338 #: 04ed040f1f414b7c8386ffe687178265 470693ef9de2469a8028547ee1f19ddd #: 8b4b77e4979541f0a4121fe75de9674d aed40072033645edb4aa0fbcdb14816f msgid "If true we output diagnostics." msgstr "true이면 진단 정보를 출력합니다." #: ../../story-class.rst:279 44286dc4a32a44f390cb28a04e6cf752 msgid "" "Finds smallest value `scale` in range `scale_min..scale_max` where `scale" " * rect` is large enough to contain the story `self`." msgstr "`scale * rect` 가 스토리 `self` 를 포함할 수 있을 만큼 큰 `scale_min..scale_max` 범위에서 가장 작은 값 `scale` 을 찾습니다." #: ../../story-class.rst:284 ../../story-class.rst:306 #: bc70968d12674cddba38101f99cb1fbd fdda159f6afc401ebac759335fb3dfec msgid "width of rect." msgstr "rect의 너비." #: ../../story-class.rst:286 ../../story-class.rst:327 #: 3ee0663bbd3d4788b49acf35a5a11b7e b17196b122de4057b9427222b9a3e7f4 msgid "height of rect." msgstr "rect의 높이." #: ../../story-class.rst:288 198e10d6fd8b4243a6c9e1051223c22e msgid "Minimum scale to consider; must be >= 0." msgstr "고려할 최소 스케일. >= 0 이어야 합니다." #: ../../story-class.rst:290 8fb7f93b830e4d5bb7de7c76d7c7e540 msgid "Maximum scale to consider, must be >= scale_min or `None` for infinite." msgstr "고려할 최대 스케일. >= scale_min 이어야 하거나 무한대의 경우 `None`." #: ../../story-class.rst:293 f423b2cdc42a427f978455fb05d8b7df msgid "Maximum error in returned scale." msgstr "반환된 스케일의 최대 오류." #: ../../story-class.rst:300 9dc7b774a8d94c71b557ecfbb9976265 msgid "" "Finds smallest height in range `height_min..height_max` where a rect with" " size `(width, height)` is large enough to contain the story `self`." msgstr "크기 `(width, height)` 의 rect가 스토리 `self` 를 포함할 수 있을 만큼 큰 `height_min..height_max` 범위에서 가장 작은 높이를 찾습니다." #: ../../story-class.rst:308 85ff87d9747942168779a4df514ba339 msgid "Minimum height to consider; must be >= 0." msgstr "고려할 최소 높이. >= 0 이어야 합니다." #: ../../story-class.rst:310 912d526c91f243f18cb6395c816ca9bc msgid "Maximum height to consider, must be >= height_min or `None` for infinite." msgstr "고려할 최대 높이. >= height_min 이어야 하거나 무한대의 경우 `None`." #: ../../story-class.rst:313 ../../story-class.rst:334 #: c1f7875eb4ae4239a6376368ebf24647 c7cca120f409456097470b299bdfb49a msgid "`(x0, y0)` of rect." msgstr "rect의 `(x0, y0)`." #: ../../story-class.rst:315 f67d83462abe4bbcaff9a80b51a5978f msgid "Maximum error in returned height." msgstr "반환된 높이의 최대 오류." #: ../../story-class.rst:322 acf77aa0831f4a0386314816cc6f06aa msgid "" "Finds smallest width in range `width_min..width_max` where a rect with " "size `(width, height)` is large enough to contain the story `self`." msgstr "크기 `(width, height)` 의 rect가 스토리 `self` 를 포함할 수 있을 만큼 큰 `width_min..width_max` 범위에서 가장 작은 너비를 찾습니다." #: ../../story-class.rst:329 9bd900ad77c545e490768485d91fc7c8 msgid "Minimum width to consider; must be >= 0." msgstr "고려할 최소 너비. >= 0 이어야 합니다." #: ../../story-class.rst:331 ff7c27444b38461aa0606500f65534c2 msgid "Maximum width to consider, must be >= width_min or `None` for infinite." msgstr "고려할 최대 너비. >= width_min 이어야 하거나 무한대의 경우 `None`." #: ../../story-class.rst:336 0b2941234085492388b7df6476fba23f msgid "Maximum error in returned width." msgstr "반환된 너비의 최대 오류." #: ../../story-class.rst:343 b1ca57aa343940a18c8a31095aa158c9 msgid "Element Positioning CallBack function" msgstr "요소 위치 지정 콜백 함수" #: ../../story-class.rst:345 091fadf161344745a01b68eb9c135c89 msgid "" "The callback function can be used to log information about story output. " "The function's access to the information is read-only: it has no way to " "influence the story's output." msgstr "콜백 함수는 스토리 출력에 대한 정보를 로깅하는 데 사용할 수 있습니다. 함수의 정보 액세스는 읽기 전용입니다. 스토리 출력에 영향을 줄 수 있는 방법이 없습니다." #: ../../story-class.rst:347 6228d7d0c75448809d16fd4e876f667e msgid "" "A typical loop for executing a story with using this method would look " "like this::" msgstr "이 메서드를 사용하여 스토리를 실행하는 일반적인 루프는 다음과 같습니다::" #: ../../story-class.rst:379 ae147d021aa143be82a1e049deb89061 msgid "Attributes of the ElementPosition class" msgstr "ElementPosition 클래스의 속성" #: ../../story-class.rst:380 c1fbd0b7565542d1b95f8c57a58016bd msgid "" "Exactly one parameter must be passed to the function provided by " ":meth:`Story.element_positions`. It is an object with the following " "attributes:" msgstr ":meth:`Story.element_positions` 에 의해 제공되는 함수에는 정확히 하나의 매개변수가 전달되어야 합니다. 다음 속성을 가진 객체입니다:" #: ../../story-class.rst:382 db748bf0d1de49da994057c0c9813003 msgid "" "The parameter passed to the `recorder` function is an object with the " "following attributes:" msgstr "`recorder` 함수에 전달되는 매개변수는 다음 속성을 가진 객체입니다:" #: ../../story-class.rst:384 332f4d6df2e849cda1fb558f9f1bc52e msgid "`elpos.depth` (int) -- depth of this element in the box structure." msgstr "`elpos.depth` (int) -- 박스 구조에서 이 요소의 깊이." #: ../../story-class.rst:386 43ebf06ffd544102857d5d1e63b02e5e msgid "" "`elpos.heading` (int) -- the header level, 0 if no header, 1-6 for " ":htmlTag:`h1` - :htmlTag:`h6`." msgstr "`elpos.heading` (int) -- 헤더 레벨, 헤더가 없으면 0, :htmlTag:`h1` - :htmlTag:`h6` 의 경우 1-6." #: ../../story-class.rst:388 fd08004f2ef1497584d8af90ce1c5a41 msgid "" "`elpos.href` (str) -- value of the `href` attribute, or None if not " "defined." msgstr "`elpos.href` (str) -- `href` 속성의 값, 정의되지 않았으면 None." #: ../../story-class.rst:390 d75122312d1142dc8e2d75061746ee48 msgid "`elpos.id` (str) -- value of the `id` attribute, or None if not defined." msgstr "`elpos.id` (str) -- `id` 속성의 값, 정의되지 않았으면 None." #: ../../story-class.rst:392 f0d4a253cad54310a3c431f54e394f96 msgid "`elpos.rect` (tuple) -- element position on page." msgstr "`elpos.rect` (tuple) -- 페이지에서의 요소 위치." #: ../../story-class.rst:394 a66c52c844ca4388889b38841925a406 msgid "`elpos.text` (str) -- immediate text of the element." msgstr "`elpos.text` (str) -- 요소의 직접 텍스트." #: ../../story-class.rst:396 bed702a812984188bb16fc3565c6d75a msgid "" "`elpos.open_close` (int bit field) -- bit 0 set: opens element, bit 1 " "set: closes element. Relevant for elements that may contain other " "elements and thus may not immediately be closed after being created / " "opened." msgstr "`elpos.open_close` (int 비트 필드) -- 비트 0 설정: 요소 열기, 비트 1 설정: 요소 닫기. 다른 요소를 포함할 수 있어 생성/열린 후 즉시 닫히지 않을 수 있는 요소와 관련됩니다." #: ../../story-class.rst:398 9c020d958f7e41739d4c89fc24c82271 msgid "`elpos.rect_num` (int) -- count of rectangles filled by the story so far." msgstr "`elpos.rect_num` (int) -- 지금까지 스토리로 채워진 사각형의 개수." #: ../../story-class.rst:400 64579e878d5a4437b0267944543f75dc msgid "" "`elpos.page_num` (int) -- page number; only present when using " "`pymupdf.Story.write*()` functions." msgstr "`elpos.page_num` (int) -- 페이지 번호. `pymupdf.Story.write*()` 함수를 사용할 때만 존재합니다." #: ../../footer.rst:46 a8171a5060434652be4eadd0eef0baa1 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/supported-files-table.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" ================================================ FILE: docs/locales/ko/LC_MESSAGES/textpage.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 a689d6f014ae4b3e996f4ea1430fd7e2 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 fcaf663acdd64264ba54a9b09a7a053d msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 2384969b3a1a48ecb481ced21413e4ab msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../textpage.rst:7 b50883dcbbd2424db737f428b4204dc7 msgid "TextPage" msgstr "TextPage" #: ../../textpage.rst:9 6e81bba1ccf7481d8fc21ba0651cd715 msgid "" "This class represents text and images shown on a document page. All " ":ref:`MuPDF document types` are supported." msgstr "이 클래스는 문서 페이지에 표시된 텍스트와 이미지를 나타냅니다. 모든 :ref:`MuPDF 문서 타입` 이 지원됩니다." #: ../../textpage.rst:11 214a6f0b55b94183bb1a4fee5b003e96 msgid "" "The usual ways to create a textpage are :meth:`DisplayList.get_textpage` " "and :meth:`Page.get_textpage`. Because there is a limited set of methods " "in this class, there exist wrappers in :ref:`Page` which are handier to " "use. The last column of this table shows these corresponding :ref:`Page` " "methods." msgstr "텍스트 페이지를 생성하는 일반적인 방법은 :meth:`DisplayList.get_textpage` 와 :meth:`Page.get_textpage` 입니다. 이 클래스의 메서드 세트가 제한적이므로, 더 편리하게 사용할 수 있는 :ref:`Page` 에 래퍼가 존재합니다. 이 테이블의 마지막 열은 이러한 해당 :ref:`Page` 메서드를 보여줍니다." #: ../../textpage.rst:13 8974c23cb16b4aa1b56189eff275c6fe msgid "For a description of what this class is all about, see Appendix 2." msgstr "이 클래스에 대한 설명은 부록 2를 참조하세요." #: ../../textpage.rst:16 a2ef271a41f24f089f82cb6c12de5544 msgid "**Method**" msgstr "**메서드**" #: ../../textpage.rst:16 5b00ef707e3f4637b40a48d5d422e544 msgid "**Description**" msgstr "**설명**" #: ../../textpage.rst:16 c508a7963cbb4c77ab691615841f72fb msgid "page get_text or search method" msgstr "페이지 get_text 또는 search 메서드" #: ../../textpage.rst:18 24790f911d6d4af491f3f0d4a90c5e4e msgid ":meth:`~.extractText`" msgstr ":meth:`~.extractText`" #: ../../textpage.rst:18 56f3e18347124df290f5bb60a9c6ab6f msgid "extract plain text" msgstr "일반 텍스트 추출" #: ../../textpage.rst:18 ../../textpage.rst:19 292888a082e041b8820ab5b47243fa82 #: 587fc832f8b941329c209fc49dd67b0b msgid "\"text\"" msgstr "\"text\"" #: ../../textpage.rst:19 062786889a8a4ad586cea1bcbfa2bb0d msgid ":meth:`~.extractTEXT`" msgstr ":meth:`~.extractTEXT`" #: ../../textpage.rst:19 e0b7b72c38c746a4b7c512c66b738f1c msgid "synonym of previous" msgstr "이전의 동의어" #: ../../textpage.rst:20 98ed5aa1b9884de7858b147ee2bd2f0c msgid ":meth:`~.extractBLOCKS`" msgstr ":meth:`~.extractBLOCKS`" #: ../../textpage.rst:20 35f208a1af3c4c5c8f17069788e702ca msgid "plain text grouped in blocks" msgstr "블록으로 그룹화된 일반 텍스트" #: ../../textpage.rst:20 6318f67c8f964981b4a354142092e102 msgid "\"blocks\"" msgstr "\"blocks\"" #: ../../textpage.rst:21 07a1408ddaf24b158ac6dc5d9fcc8115 msgid ":meth:`~.extractWORDS`" msgstr ":meth:`~.extractWORDS`" #: ../../textpage.rst:21 52e0458f76ee4231a07829bb051b29ac msgid "all words with their bbox" msgstr "바운딩 박스를 포함한 모든 단어" #: ../../textpage.rst:21 2efe7bf211e74dc4a731d81393a6e10c msgid "\"words\"" msgstr "\"words\"" #: ../../textpage.rst:22 7c9da76988c243e0b79a0f2a5c23cee7 msgid ":meth:`~.extractHTML`" msgstr ":meth:`~.extractHTML`" #: ../../textpage.rst:22 269dcb92057443e096b0cd366dd7ba29 msgid "page content in HTML format" msgstr "HTML 형식의 페이지 콘텐츠" #: ../../textpage.rst:22 d24ee0e44d5c45e59f125aacaccf3465 msgid "\"html\"" msgstr "\"html\"" #: ../../textpage.rst:23 388abf5016ba455c959cdd56009a4499 msgid ":meth:`~.extractXHTML`" msgstr ":meth:`~.extractXHTML`" #: ../../textpage.rst:23 b09f5acedceb4611bc7ea51121eb9bb2 msgid "page content in XHTML format" msgstr "XHTML 형식의 페이지 콘텐츠" #: ../../textpage.rst:23 416a7019408e492da02693ffd6949a7a msgid "\"xhtml\"" msgstr "\"xhtml\"" #: ../../textpage.rst:24 ee85d9810eff41caa760d9ffb2a4fed2 msgid ":meth:`~.extractXML`" msgstr ":meth:`~.extractXML`" #: ../../textpage.rst:24 8ab1b023d2cc42b6ae74cb3b92b8d797 msgid "page text in XML format" msgstr "XML 형식의 페이지 텍스트" #: ../../textpage.rst:24 fd3d4026c2c045b6a5dc724cd3c1cd16 msgid "\"xml\"" msgstr "\"xml\"" #: ../../textpage.rst:25 a0d67d42d20d483ba2dc7c60232c4262 msgid ":meth:`~.extractDICT`" msgstr ":meth:`~.extractDICT`" #: ../../textpage.rst:25 ../../textpage.rst:27 1867105a7ef841cd809711e47e335c93 #: 8cfc8dba8d384e489e2948bcbd7adaca msgid "page content in *dict* format" msgstr "*dict* 형식의 페이지 콘텐츠" #: ../../textpage.rst:25 8159466e656146a38f47f43f6bdcb810 msgid "\"dict\"" msgstr "\"dict\"" #: ../../textpage.rst:26 1d75b88f1edb442898ea8017de3492d7 msgid ":meth:`~.extractJSON`" msgstr ":meth:`~.extractJSON`" #: ../../textpage.rst:26 ../../textpage.rst:28 7480fba67d534ecc8956acf7902d5aed #: 82d01a9dbb1d488198ecd836fed442ff msgid "page content in JSON format" msgstr "JSON 형식의 페이지 콘텐츠" #: ../../textpage.rst:26 78d2d0b851b240db8420aa1f8c823676 msgid "\"json\"" msgstr "\"json\"" #: ../../textpage.rst:27 1ade4b09c9674544bb58977574f5d593 msgid ":meth:`~.extractRAWDICT`" msgstr ":meth:`~.extractRAWDICT`" #: ../../textpage.rst:27 3155e2902bcd4713aa47e4919ec46081 msgid "\"rawdict\"" msgstr "\"rawdict\"" #: ../../textpage.rst:28 b5f0e031790f497694abb5caa6eee204 msgid ":meth:`~.extractRAWJSON`" msgstr ":meth:`~.extractRAWJSON`" #: ../../textpage.rst:28 9b7e2e49823242bf83ea6a25986488d0 msgid "\"rawjson\"" msgstr "\"rawjson\"" #: ../../textpage.rst:29 c2c9458e9c4a490087a519b61ecc5b19 msgid ":meth:`~.search`" msgstr ":meth:`~.search`" #: ../../textpage.rst:29 ee8c8a71aa524335969fbb8af60b211e msgid "Search for a string in the page" msgstr "페이지에서 문자열 검색" #: ../../textpage.rst:29 f79465ca7ff14a0a80fc365911c70bf6 msgid ":meth:`Page.search_for`" msgstr ":meth:`Page.search_for`" #: ../../textpage.rst:32 083eef252c154937ae0bc85aa81aff68 msgid "**Class API**" msgstr "**클래스 API**" #: ../../textpage.rst:40 f33111b086ad4d72980c782edd305dd0 msgid "" "Return a string of the page's complete text. The text is UTF-8 unicode " "and in the same sequence as specified at the time of document creation." msgstr "페이지의 전체 텍스트 문자열을 반환합니다. 텍스트는 UTF-8 유니코드이며 문서 생성 시 지정된 순서와 동일합니다." #: ../../textpage.rst 3e9d1669f2fe4f15ab3177563f0420e3 #: 4bd4b9fa21ed426188fe213d2241f4ac 720def9977a743fdb77d7caeb93f8e63 #: aea747bd7d624e70bc7def00d62df838 ca24753a6b21474daba199227cbdb7cd #: d0072bc05d7144aca56767bfde82c6a9 e1647eb182054d70be24b2cc9c6381ca msgid "Parameters" msgstr "매개변수" #: ../../textpage.rst:42 ../../textpage.rst:85 ../../textpage.rst:93 #: ../../textpage.rst:113 ../../textpage.rst:121 #: 053cd209c0cd44b08367efe95d323dcb 2e3408186db64af29672df98a2541c3a #: 88f4b7d0b3014f8ab6a88c7157c764d9 eafc202f0101431bbd82bb8f066f24c2 #: f7da0622405347bcb10099abdba152a3 msgid "" "(new in v1.19.1) sort the output by vertical, then horizontal " "coordinates. In many cases, this should suffice to generate a \"natural\"" " reading order." msgstr "(v1.19.1에서 새로 추가됨) 출력을 수직 좌표, 그 다음 수평 좌표로 정렬합니다. 많은 경우 이것으로 \"자연스러운\" 읽기 순서를 생성할 수 있습니다." #: ../../textpage.rst 07f5f0a7fa5f4efbb1093cd496e1425a #: 0f27872a10dd46fda6c8e7ecaf77c92b 34621dc4778249c49fbd4c5f8fd2fd39 #: 4c8745e920b8430fadff84a8e977a147 5081234f6b32451d915cc94583c1d60e #: 9a9a5268dcfc421cb4ca9b69e5030ee1 9f3241fa28914e49a481723379042cd8 #: c0b2e445162446e1b4a2e0eb834ac7ca f3b8d685f26e44edbe5e23bac745020d #: f63537f76faf47c884089748bdcbcd8b f8803c61a6fc41fe89a08237112d6d49 msgid "Return type" msgstr "반환 타입" #: ../../textpage.rst:49 63307d556a584ea19173a54596c7f880 msgid "" "Textpage content as a list of text lines grouped by block. Each list " "items looks like this::" msgstr "블록별로 그룹화된 텍스트 줄 목록으로 된 텍스트 페이지 콘텐츠. 각 목록 항목은 다음과 같습니다::" #: ../../textpage.rst:53 78718be495234f9dbfa93e48e16d1e13 msgid "" "The first four entries are the block's bbox coordinates, *block_type* is " "1 for an image block, 0 for text. *block_no* is the block sequence " "number. Multiple text lines are joined via line breaks." msgstr "처음 네 개 항목은 블록의 bbox 좌표이며, *block_type* 은 이미지 블록의 경우 1, 텍스트의 경우 0입니다. *block_no* 는 블록 시퀀스 번호입니다. 여러 텍스트 줄은 줄바꿈으로 연결됩니다." #: ../../textpage.rst:55 12f402e2e12346f8b7dd871f590f3197 msgid "" "For an image block, its bbox and a text line with some image meta " "information is included -- **not the image content**." msgstr "이미지 블록의 경우 bbox와 일부 이미지 메타 정보가 포함된 텍스트 줄이 포함됩니다. **이미지 콘텐츠는 포함되지 않습니다**." #: ../../textpage.rst:57 fb2f6c324124423bb74dbd2e4b974806 msgid "" "This is a high-speed method with just enough information to output plain " "text in desired reading sequence." msgstr "원하는 읽기 순서로 일반 텍스트를 출력하기에 충분한 정보를 제공하는 고속 메서드입니다." #: ../../textpage.rst:63 cfb05f044359435fb061d158cb6ef21e msgid "Changed in v1.23.5: added `delimiters` parameter" msgstr "v1.23.5에서 변경됨: `delimiters` 매개변수 추가" #: ../../textpage.rst:65 e3116b1baa374ce2b67b6002aaae107d msgid "" "Textpage content as a list of single words with bbox information. An item" " of this list looks like this::" msgstr "bbox 정보가 있는 단일 단어 목록으로 된 텍스트 페이지 콘텐츠. 이 목록의 항목은 다음과 같습니다::" #: ../../textpage.rst:69 6f56fac0469e45afa313a96110815e53 msgid "" "(new in v1.23.5) use these characters as *additional* word separators. By" " default, all white spaces (including the non-breaking space `0xA0`) " "indicate start and end of a word. Now you can specify more characters " "causing this. For instance, the default will return " "`\"john.doe@outlook.com\"` as **one** word. If you specify " "`delimiters=\"@.\"` then the **four** words `\"john\"`, `\"doe\"`, " "`\"outlook\"`, `\"com\"` will be returned. Other possible uses include " "ignoring punctuation characters `delimiters=string.punctuation`. The " "\"word\" strings will not contain any delimiting character." msgstr "(v1.23.5에서 새로 추가됨) 이러한 문자를 *추가* 단어 구분자로 사용합니다. 기본적으로 모든 공백(줄바꿈 없는 공백 `0xA0` 포함)은 단어의 시작과 끝을 나타냅니다. 이제 이를 유발하는 더 많은 문자를 지정할 수 있습니다. 예를 들어 기본값은 `\"john.doe@outlook.com\"` 을 **하나의** 단어로 반환합니다. `delimiters=\"@.\"` 를 지정하면 **네 개의** 단어 `\"john\"`, `\"doe\"`, `\"outlook\"`, `\"com\"` 이 반환됩니다. 다른 가능한 용도로는 구두점 문자 무시 `delimiters=string.punctuation` 가 있습니다. \"word\" 문자열에는 구분 문자가 포함되지 않습니다." #: ../../textpage.rst:71 f122cb9dbcfb43fb8cd911d4aabb4817 msgid "" "This is a high-speed method which e.g. allows extracting text from within" " given areas or recovering the text reading sequence." msgstr "이것은 예를 들어 주어진 영역 내에서 텍스트를 추출하거나 텍스트 읽기 순서를 복구할 수 있게 하는 고속 메서드입니다." #: ../../textpage.rst:77 9fd59d1b4ce240e7ab72d24d4bfe0b1d msgid "" "Textpage content as a string in HTML format. This version contains " "complete formatting and positioning information. Images are included " "(encoded as base64 strings). You need an HTML package to interpret the " "output in Python. Your internet browser should be able to adequately " "display this information, but see :ref:`HTMLQuality`." msgstr "HTML 형식의 문자열로 된 텍스트 페이지 콘텐츠. 이 버전은 완전한 서식 및 위치 정보를 포함합니다. 이미지가 포함됩니다(base64 문자열로 인코딩됨). Python에서 출력을 해석하려면 HTML 패키지가 필요합니다. 인터넷 브라우저가 이 정보를 적절히 표시할 수 있어야 하지만 :ref:`HTMLQuality` 를 참조하세요." #: ../../textpage.rst:83 a07e225c4bf3412585128a2fb86b8200 msgid "" "Textpage content as a Python dictionary. Provides same information detail" " as HTML. See below for the structure." msgstr "Python 딕셔너리로 된 텍스트 페이지 콘텐츠. HTML과 동일한 정보 세부 사항을 제공합니다. 구조는 아래를 참조하세요." #: ../../textpage.rst:91 3c7dcaacfe924c9ab076958b43f75600 msgid "" "Textpage content as a JSON string. Created by " "`json.dumps(TextPage.extractDICT())`. It is included for backlevel " "compatibility. You will probably use this method ever only for outputting" " the result to some file. The method detects binary image data and " "converts them to base64 encoded strings." msgstr "JSON 문자열로 된 텍스트 페이지 콘텐츠. `json.dumps(TextPage.extractDICT())` 로 생성됩니다. 하위 호환성을 위해 포함되었습니다. 이 메서드는 아마도 결과를 파일로 출력하는 용도로만 사용할 것입니다. 이 메서드는 바이너리 이미지 데이터를 감지하고 base64 인코딩된 문자열로 변환합니다." #: ../../textpage.rst:99 87f36a88ced6410383dcdafa2979eae5 msgid "" "Textpage content as a string in XHTML format. Text information detail is " "comparable with :meth:`extractTEXT`, but also contains images (base64 " "encoded). This method makes no attempt to re-create the original visual " "appearance." msgstr "XHTML 형식의 문자열로 된 텍스트 페이지 콘텐츠. 텍스트 정보 세부 사항은 :meth:`extractTEXT` 와 유사하지만 이미지도 포함합니다(base64 인코딩됨). 이 메서드는 원본 시각적 모양을 재현하려고 시도하지 않습니다." #: ../../textpage.rst:105 ce4a584473674c4e91533c25a532fe15 msgid "" "Textpage content as a string in XML format. This contains complete " "formatting information about every single character on the page: font, " "size, line, paragraph, location, color, etc. Contains no images. You need" " an XML package to interpret the output in Python." msgstr "XML 형식의 문자열로 된 텍스트 페이지 콘텐츠. 이것은 페이지의 모든 단일 문자에 대한 완전한 서식 정보를 포함합니다: 글꼴, 크기, 줄, 단락, 위치, 색상 등. 이미지는 포함되지 않습니다. Python에서 출력을 해석하려면 XML 패키지가 필요합니다." #: ../../textpage.rst:111 53dc5f5e5cc04c54a952877ba4755541 msgid "" "Textpage content as a Python dictionary -- technically similar to " ":meth:`extractDICT`, and it contains that information as a subset " "(including any images). It provides additional detail down to each " "character, which makes using XML obsolete in many cases. See below for " "the structure." msgstr "Python 딕셔너리로 된 텍스트 페이지 콘텐츠. 기술적으로 :meth:`extractDICT` 와 유사하며, 해당 정보를 하위 집합으로 포함합니다(이미지 포함). 각 문자까지 추가 세부 정보를 제공하므로 많은 경우 XML 사용을 불필요하게 만듭니다. 구조는 아래를 참조하세요." #: ../../textpage.rst:119 33863035deb9499b8feb6d00b3064acb msgid "" "Textpage content as a JSON string. Created by " "`json.dumps(TextPage.extractRAWDICT())`. You will probably use this " "method ever only for outputting the result to some file. The method " "detects binary image data and converts them to base64 encoded strings." msgstr "JSON 문자열로 된 텍스트 페이지 콘텐츠. `json.dumps(TextPage.extractRAWDICT())` 로 생성됩니다. 이 메서드는 아마도 결과를 파일로 출력하는 용도로만 사용할 것입니다. 이 메서드는 바이너리 이미지 데이터를 감지하고 base64 인코딩된 문자열로 변환합니다." #: ../../textpage.rst:127 209053b84b6545e3994a163287facefa msgid "Changed in v1.18.2" msgstr "v1.18.2에서 변경됨" #: ../../textpage.rst:129 05ffbacb61c7489882f082b48886e8d5 msgid "Search for *string* and return a list of found locations." msgstr "*string* 을 검색하고 찾은 위치 목록을 반환합니다." #: ../../textpage.rst:131 c71683b946f54d84aff575da2005613b msgid "" "the string to search for. Upper and lower cases will all match if needle " "consists of ASCII letters only -- it does not yet work for \"Ä\" versus " "\"ä\", etc." msgstr "검색할 문자열. needle이 ASCII 문자로만 구성된 경우 대소문자가 모두 일치합니다. \"Ä\" 와 \"ä\" 등에는 아직 작동하지 않습니다." #: ../../textpage.rst:132 0f1af98486ec43429066d8c48e3dc958 msgid "return quadrilaterals instead of rectangles." msgstr "사각형 대신 사각형을 반환합니다." #: ../../textpage.rst 943e3f54b51f470ba6d34411ccdabcd3 msgid "Returns" msgstr "반환값" #: ../../textpage.rst:134 89e19eb80ccd4b318611f268b0f75d7e msgid "" "a list of :ref:`Rect` or :ref:`Quad` objects, each surrounding a found " "*needle* occurrence. As the search string may contain spaces, its parts " "may be found on different lines. In this case, more than one rectangle " "(resp. quadrilateral) are returned. **(Changed in v1.18.2)** The method " "**now supports dehyphenation**, so it will find e.g. \"method\", even if " "it was hyphenated in two parts \"meth-\" and \"od\" across two lines. The" " two returned rectangles will contain \"meth\" (no hyphen) and \"od\"." msgstr ":ref:`Rect` 또는 :ref:`Quad` 객체 목록으로, 각각 찾은 *needle* 발생을 둘러쌉니다. 검색 문자열에 공백이 포함될 수 있으므로 해당 부분이 다른 줄에서 발견될 수 있습니다. 이 경우 둘 이상의 사각형(또는 사각형)이 반환됩니다. **(v1.18.2에서 변경됨)** 이 메서드는 **이제 하이픈 제거를 지원** 하므로 두 줄에 걸쳐 \"meth-\" 와 \"od\" 로 하이픈 처리된 경우에도 예를 들어 \"method\" 를 찾을 수 있습니다. 반환된 두 사각형에는 \"meth\" (하이픈 없음)와 \"od\" 가 포함됩니다." #: ../../textpage.rst:136 c134a9fb178648ae8bab433d54e37e2b msgid "**Overview of changes in v1.18.2:**" msgstr "**v1.18.2의 변경 사항 개요:**" #: ../../textpage.rst:138 d9a3438955224e5685de548903667d74 msgid "The `hit_max` parameter has been removed: all hits are always returned." msgstr "`hit_max` 매개변수가 제거되었습니다. 모든 히트가 항상 반환됩니다." #: ../../textpage.rst:139 c687c9305d954f6eaea257e2fe5bbe58 msgid "" "The `rect` parameter of the :ref:`TextPage` is now respected: only text " "inside this area is examined. Only characters with fully contained bboxes" " are considered. The wrapper method :meth:`Page.search_for` " "correspondingly supports a *clip* parameter." msgstr ":ref:`TextPage` 의 `rect` 매개변수가 이제 존중됩니다. 이 영역 내의 텍스트만 검사됩니다. 완전히 포함된 bbox를 가진 문자만 고려됩니다. 래퍼 메서드 :meth:`Page.search_for` 는 이에 따라 *clip* 매개변수를 지원합니다." #: ../../textpage.rst:140 ec9e270e430341a88939c174a0e838a3 msgid "**Hyphenated words** are now found." msgstr "**하이픈 처리된 단어** 가 이제 찾아집니다." #: ../../textpage.rst:141 595b14cd29774ef49fd1666b1d37dbb7 msgid "" "**Overlapping rectangles** in the same line are now automatically joined." " We assume that such separations are an artifact created by multiple " "marked content groups, containing parts of the same search needle." msgstr "같은 줄의 **겹치는 사각형** 이 이제 자동으로 결합됩니다. 이러한 분리는 동일한 검색 needle의 일부를 포함하는 여러 표시된 콘텐츠 그룹에 의해 생성된 아티팩트라고 가정합니다." #: ../../textpage.rst:143 7b283f04f24544e18dc95d6f698f1a39 msgid "" "Example Quad versus Rect: when searching for needle \"pymupdf\", then the" " corresponding entry will either be the blue rectangle, or, if *quads* " "was specified, the quad *Quad(ul, ur, ll, lr)*." msgstr "Quad 대 Rect 예시: needle \"pymupdf\" 를 검색할 때 해당 항목은 파란색 사각형이 되거나, *quads* 가 지정된 경우 사각형 *Quad(ul, ur, ll, lr)* 가 됩니다." #: ../../textpage.rst:149 22015cb6553240db9caee4c5d4d0a06b msgid "" "The rectangle associated with the text page. This either equals the " "rectangle of the creating page or the `clip` parameter of " ":meth:`Page.get_textpage` and text extraction / searching methods." msgstr "텍스트 페이지와 연결된 사각형. 이것은 생성 페이지의 사각형이거나 :meth:`Page.get_textpage` 및 텍스트 추출/검색 메서드의 `clip` 매개변수와 같습니다." #: ../../textpage.rst:151 e4d7797e393d49f38a2ad6066b720a21 msgid "" "The output of text searching and most text extractions **is restricted to" " this rectangle**. (X)HTML and XML output will however always extract the" " full page." msgstr "텍스트 검색 및 대부분의 텍스트 추출 출력은 **이 사각형으로 제한됩니다**. 그러나 (X)HTML 및 XML 출력은 항상 전체 페이지를 추출합니다." #: ../../textpage.rst:156 746d4f0331d74f5eb4b706ab194b8b02 msgid "Structure of Dictionary Outputs" msgstr "딕셔너리 출력 구조" #: ../../textpage.rst:157 ae8559712aa84a3b8f3abc14fba42605 msgid "" "Methods :meth:`TextPage.extractDICT`, :meth:`TextPage.extractJSON`, " ":meth:`TextPage.extractRAWDICT`, and :meth:`TextPage.extractRAWJSON` " "return dictionaries, containing the page's text and image content. The " "dictionary structures of all four methods are almost equal. They strive " "to map the text page's information hierarchy of blocks, lines, spans and " "characters as precisely as possible, by representing each of these by its" " own sub-dictionary:" msgstr ":meth:`TextPage.extractDICT`, :meth:`TextPage.extractJSON`, :meth:`TextPage.extractRAWDICT`, :meth:`TextPage.extractRAWJSON` 메서드는 페이지의 텍스트 및 이미지 콘텐츠를 포함하는 딕셔너리를 반환합니다. 네 가지 메서드의 딕셔너리 구조는 거의 동일합니다. 각각을 자체 하위 딕셔너리로 표현하여 텍스트 페이지의 블록, 줄, 범위 및 문자 정보 계층을 가능한 한 정확하게 매핑합니다:" #: ../../textpage.rst:159 1fc549b40ec54504aba36b49e614c7cc msgid "A **page** consists of a list of **block dictionaries**." msgstr "**페이지** 는 **블록 딕셔너리** 목록으로 구성됩니다." #: ../../textpage.rst:160 531deb445eda49c78ee0170f577f2f93 msgid "A (text) **block** consists of a list of **line dictionaries**." msgstr "(텍스트) **블록** 은 **줄 딕셔너리** 목록으로 구성됩니다." #: ../../textpage.rst:161 5d0d26a55df64fb0bc4619f73f865415 msgid "A **line** consists of a list of **span dictionaries**." msgstr "**줄** 은 **범위 딕셔너리** 목록으로 구성됩니다." #: ../../textpage.rst:162 d297bff2aae540828c971d533f6fe3bb msgid "" "A **span** either consists of the text itself or, for the RAW variants, a" " list of **character dictionaries**." msgstr "**범위** 는 텍스트 자체로 구성되거나 RAW 변형의 경우 **문자 딕셔너리** 목록으로 구성됩니다." #: ../../textpage.rst:163 37000c1f71684c77a812407e7849a0e0 msgid "" "RAW variants: a **character** is a dictionary of its origin, bbox and " "unicode." msgstr "RAW 변형: **문자** 는 원본, bbox 및 유니코드의 딕셔너리입니다." #: ../../textpage.rst:165 192df2422b5e482bbb29f7afc93e8cdc msgid "" "All PyMuPDF geometry objects herein (points, rectangles, matrices) are " "represented by there **\"like\"** formats: a :data:`rect_like` *tuple* is" " used instead of a :ref:`Rect`, etc. The reasons for this are performance" " and memory considerations:" msgstr "여기에 포함된 모든 |PyMuPDF| 기하 객체(점, 사각형, 행렬)는 **\"like\"** 형식으로 표현됩니다: :ref:`Rect` 대신 :data:`rect_like` *tuple* 이 사용됩니다. 그 이유는 성능 및 메모리 고려 사항입니다:" #: ../../textpage.rst:167 517e734e4772478cb6b1bc32cab2ab16 msgid "" "This code is written in C, where Python tuples can easily be generated. " "The geometry objects on the other hand are defined in Python source only." " A conversion of each Python tuple into its corresponding geometry object" " would add significant -- and largely unnecessary -- execution time." msgstr "이 코드는 C로 작성되었으며, Python 튜플을 쉽게 생성할 수 있습니다. 반면 기하 객체는 Python 소스에만 정의되어 있습니다. 각 Python 튜플을 해당 기하 객체로 변환하면 상당한 실행 시간이 추가됩니다(대부분 불필요함)." #: ../../textpage.rst:168 a7f4b55b2bb84753bc138ab3a04c2f8a msgid "" "A 4-tuple needs about 168 bytes, the corresponding :ref:`Rect` 472 bytes " "- almost three times the size. A \"dict\" dictionary for a text-heavy " "page contains 300+ bbox objects -- which thus require about 50 KB storage" " as 4-tuples versus 140 KB as :ref:`Rect` objects. A \"rawdict\" output " "for such a page will however contain **4 to 5 thousand** bboxes, so in " "this case we talk about 750 KB versus 2 MB." msgstr "4-tuple은 약 168바이트가 필요하고, 해당 :ref:`Rect` 는 472바이트입니다. 거의 3배 크기입니다. 텍스트가 많은 페이지의 \"dict\" 딕셔너리에는 300개 이상의 bbox 객체가 포함되어 있습니다. 따라서 4-tuple로 약 50KB, :ref:`Rect` 객체로 140KB의 저장 공간이 필요합니다. 그러나 이러한 페이지의 \"rawdict\" 출력에는 **4천~5천 개** 의 bbox가 포함되므로, 이 경우 750KB 대 2MB를 말하는 것입니다." #: ../../textpage.rst:170 bbdd6aa883a447c5b6bbb24a389b7944 msgid "" "Please also note, that only **bboxes** (= :data:`rect_like` 4-tuples) are" " returned, whereas a :ref:`TextPage` actually has the **full position " "information** -- in :ref:`Quad` format. The reason for this decision is " "again a memory consideration: a :data:`quad_like` needs 488 bytes (3 " "times the size of a :data:`rect_like`). Given the mentioned amounts of " "generated bboxes, returning :data:`quad_like` information would have a " "significant impact." msgstr "또한 **bboxes** (= :data:`rect_like` 4-tuple)만 반환되지만, :ref:`TextPage` 는 실제로 **전체 위치 정보** 를 가지고 있습니다. :ref:`Quad` 형식입니다. 이 결정의 이유는 다시 메모리 고려 사항입니다: :data:`quad_like` 는 488바이트(:data:`rect_like` 크기의 3배)가 필요합니다. 생성된 bbox의 양을 고려하면 :data:`quad_like` 정보를 반환하면 상당한 영향을 미칩니다." #: ../../textpage.rst:172 d2d5ce2b47bc4940b491f08fbbaa0027 msgid "" "In the vast majority of cases, we are dealing with **horizontal text " "only**, where bboxes provide entirely sufficient information." msgstr "대부분의 경우 **수평 텍스트만** 다루며, bbox가 완전히 충분한 정보를 제공합니다." #: ../../textpage.rst:174 feb1b497d7a04358ac4fc4f59750eb21 msgid "" "In addition, **the full quad information is not lost**: it can be " "recovered as needed for lines, spans, and characters by using the " "appropriate function from the following list:" msgstr "또한 **전체 quad 정보는 손실되지 않습니다**: 다음 목록의 적절한 함수를 사용하여 줄, 범위 및 문자에 대해 필요에 따라 복구할 수 있습니다:" #: ../../textpage.rst:176 e89548afd6dc44168e0b77628a3cba31 msgid ":meth:`recover_quad` -- the quad of a complete span" msgstr ":meth:`recover_quad` -- 전체 범위의 quad" #: ../../textpage.rst:177 27d71bee525843278a01adf552fa7a36 msgid ":meth:`recover_span_quad` -- the quad of a character subset of a span" msgstr ":meth:`recover_span_quad` -- 범위의 문자 하위 집합의 quad" #: ../../textpage.rst:178 041a2862fe3d48ac95055a9328f85989 msgid ":meth:`recover_line_quad` -- the quad of a line" msgstr ":meth:`recover_line_quad` -- 줄의 quad" #: ../../textpage.rst:179 66ae40921c104d34aba6daaf7127f04f msgid ":meth:`recover_char_quad` -- the quad of a character" msgstr ":meth:`recover_char_quad` -- 문자의 quad" #: ../../textpage.rst:181 727a2901b16c4ddd96ae14b244c5424a msgid "" "As mentioned, using these functions is ever only needed, if the text is " "**not written horizontally** -- `line[\"dir\"] != (1, 0)` -- and you need" " the quad for text marker annotations (:meth:`Page.add_highlight_annot` " "and friends)." msgstr "언급한 대로, 이러한 함수 사용은 텍스트가 **수평으로 작성되지 않은** 경우(`line[\"dir\"] != (1, 0)`)에만 필요하며, 텍스트 마커 주석(:meth:`Page.add_highlight_annot` 등)에 quad가 필요한 경우입니다." #: ../../textpage.rst:191 7805ac6076c748d18288314bba88341d msgid "Page Dictionary" msgstr "페이지 딕셔너리" #: ../../textpage.rst:194 ../../textpage.rst:208 ../../textpage.rst:251 #: ../../textpage.rst:263 ../../textpage.rst:285 ../../textpage.rst:369 #: 29f9782130d642a8b2fddc4dfd20716c 70f3d2461fad4b3fadb0fc3afaea9f2e #: 975906fdd1184ad3ad3fd3d27e4993b0 baf341562d684245aa92ddd993c2dd48 #: bf7900e8b9b5405a8f0d4d83a8bf0411 c6778ca210f143f38e1b9841a02401e9 msgid "**Key**" msgstr "**키**" #: ../../textpage.rst:194 ../../textpage.rst:208 ../../textpage.rst:251 #: ../../textpage.rst:263 ../../textpage.rst:285 ../../textpage.rst:369 #: 264a4f1acc10474eb5e78fe3b5e5823b b4b639c47a4a414db8f8f3bb50ee8dc9 #: cc9c466c5ba84957921e1ff86a57d116 d94353036c5b40c1846dd829e554f27f #: f0dc2d1c0f2f41dea26d6f56aa6b3a26 fe805e2ac2f84c418cdee9f01871d787 msgid "**Value**" msgstr "**값**" #: ../../textpage.rst:196 ../../textpage.rst:214 #: 07aa10194d0d48eb97c6202f508f7705 8f326282fbe8407aa66c61b1d8bcd062 msgid "width" msgstr "width" #: ../../textpage.rst:196 f244c49149a243688a1885d014c7a1bb msgid "width of the `clip` rectangle *(float)*" msgstr "`clip` 사각형의 너비 *(float)*" #: ../../textpage.rst:197 ../../textpage.rst:215 #: b8882d43fa804c8a9c251b3ec47cef6d bcccca2b99b94b7ea01f4de3b4b7c85a msgid "height" msgstr "height" #: ../../textpage.rst:197 3100ead6fa2e45f5b61d6969928e4877 msgid "height of the `clip` rectangle *(float)*" msgstr "`clip` 사각형의 높이 *(float)*" #: ../../textpage.rst:198 c5935e75747b42e799fe04c7f318b0da msgid "blocks" msgstr "blocks" #: ../../textpage.rst:198 30ab779a07894b089542bb81604f9b47 msgid "*list* of block dictionaries" msgstr "블록 딕셔너리의 *list*" #: ../../textpage.rst:202 db462c15f35c46f5b52a233a3beed4d0 msgid "Block Dictionaries" msgstr "블록 딕셔너리" #: ../../textpage.rst:203 952d964d7a5e43c2848616b970e2716c msgid "" "Block dictionaries come in two different formats for **image blocks** and" " for **text blocks**." msgstr "블록 딕셔너리는 **이미지 블록** 과 **텍스트 블록** 에 대해 두 가지 다른 형식으로 제공됩니다." #: ../../textpage.rst:205 238f68f9676441f1bdcff950557a856e msgid "**Image block:**" msgstr "**이미지 블록:**" #: ../../textpage.rst:210 ../../textpage.rst:253 #: 800a3c27effc460f9480726ec3a5c729 d35d41a494c04f6285bda0eace697528 msgid "type" msgstr "type" #: ../../textpage.rst:210 6328d3cec703451097bfaa7cf7f6c65f msgid "1 = image (``int``)" msgstr "1 = 이미지 (``int``)" #: ../../textpage.rst:211 ../../textpage.rst:254 ../../textpage.rst:265 #: ../../textpage.rst:287 ../../textpage.rst:372 #: 13e6c3dfe54549b9b050cea92d99d01a 322f2d6f5b2b44ed9706ad2f98ad459c #: 4f766fcb9538433a8d4db8a39a80ff3c bc56648f4c414b1eb1faa55dba01ab98 #: db0fdf56b2254240a588914bece3c707 msgid "bbox" msgstr "bbox" #: ../../textpage.rst:211 ff4d18f9a8d24d16a31d552e95f6e589 msgid "image bbox on page (:data:`rect_like`)" msgstr "페이지의 이미지 bbox (:data:`rect_like`)" #: ../../textpage.rst:212 ../../textpage.rst:255 #: 4c56479091544270885701e21d3794c0 5d311b7030c74d77b291641b825cabc0 msgid "number" msgstr "number" #: ../../textpage.rst:212 044f427c89414858935273b873628617 msgid "block count (``int``)" msgstr "블록 개수 (``int``)" #: ../../textpage.rst:213 d457db3dffd648f5b421b9dabda513e8 msgid "ext" msgstr "ext" #: ../../textpage.rst:213 9a1b2497c15747ccae408e2908b03716 msgid "image type (``str``), as file extension, see below" msgstr "이미지 타입 (``str``), 파일 확장자로, 아래 참조" #: ../../textpage.rst:214 65917d8aff0a47ae97e1c880700ae5b9 msgid "original image width (``int``)" msgstr "원본 이미지 너비 (``int``)" #: ../../textpage.rst:215 ef1b2983b8484b67aea4e7c52ec94c5e msgid "original image height (``int``)" msgstr "원본 이미지 높이 (``int``)" #: ../../textpage.rst:216 cdbc1a0fe83a45878f7d57c8195c2541 msgid "colorspace" msgstr "colorspace" #: ../../textpage.rst:216 0768d9dd62e74b518365212bb8f2d509 msgid "colorspace component count (``int``)" msgstr "색 공간 구성 요소 개수 (``int``)" #: ../../textpage.rst:217 c72ef151fd0843acbf96ee02c0b50384 msgid "xres" msgstr "xres" #: ../../textpage.rst:217 2b798798946e43259c410f01235ab8cf msgid "resolution in x-direction (``int``) [#f3]_" msgstr "x 방향 해상도 (``int``) [#f3]_" #: ../../textpage.rst:218 711945f5b34049a1b07317557513f490 msgid "yres" msgstr "yres" #: ../../textpage.rst:218 91a31d61290640b8988418d1a9ebb3ba msgid "resolution in y-direction (``int``) [#f3]_" msgstr "y 방향 해상도 (``int``) [#f3]_" #: ../../textpage.rst:219 c247c45f267c4a6281d20687be8c99af msgid "bpc" msgstr "bpc" #: ../../textpage.rst:219 8934e38405664f3fa8f78d65d3a6dba5 msgid "bits per component (``int``)" msgstr "구성 요소당 비트 수 (``int``)" #: ../../textpage.rst:220 2db498cd52714dd8b5097aa444b17ac0 msgid "transform" msgstr "transform" #: ../../textpage.rst:220 c07a01fdd4744863a7e7b665d9066376 msgid "matrix transforming image rect to bbox (:data:`matrix_like`)" msgstr "이미지 rect를 bbox로 변환하는 행렬 (:data:`matrix_like`)" #: ../../textpage.rst:221 ../../textpage.rst:292 #: 416da7dc62f34728a5e65a5b6eccec10 e5bfbe8873ce4531a1a93eea31b542ab msgid "size" msgstr "size" #: ../../textpage.rst:221 ef114c513c0140809c273a1fca277935 msgid "size of the image in bytes (``int``)" msgstr "바이트 단위의 이미지 크기 (``int``)" #: ../../textpage.rst:222 b4442e7378f340ad9bbc40a5bda85f94 msgid "image" msgstr "image" #: ../../textpage.rst:222 44de8974cd434bbca7c4dea100e9987f msgid "image content (``bytes``)" msgstr "이미지 콘텐츠 (``bytes``)" #: ../../textpage.rst:223 ce697bda1a494d35a92a1a9b886f4a53 msgid "mask" msgstr "mask" #: ../../textpage.rst:223 203d79f1d981499da21d8cae601cef42 msgid "image mask content (``bytes``) for transparent images" msgstr "투명 이미지의 이미지 마스크 콘텐츠 (``bytes``)" #: ../../textpage.rst:226 7b2748f1df1342538dd7b750dd6db1db msgid "" "Possible values of the \"ext\" key are \"bmp\", \"gif\", \"jpeg\", " "\"jpx\" (JPEG 2000), \"jxr\" (JPEG XR), \"png\", \"pnm\", and \"tiff\"." msgstr "\"ext\" 키의 가능한 값은 \"bmp\", \"gif\", \"jpeg\", \"jpx\" (JPEG 2000), \"jxr\" (JPEG XR), \"png\", \"pnm\", \"tiff\" 입니다." #: ../../textpage.rst:230 f165771e95ce4de587ef46d0281ce182 msgid "" "An image block is generated for **all and every image occurrence** on the" " page. Hence there may be duplicates, if an image is shown at different " "locations." msgstr "페이지의 **모든 이미지 발생** 에 대해 이미지 블록이 생성됩니다. 따라서 이미지가 다른 위치에 표시되면 중복이 있을 수 있습니다." #: ../../textpage.rst:232 34122c8c572a45d7a4acfd1f2cbbbe55 msgid "" ":ref:`TextPage` and corresponding method :meth:`Page.get_text` are " "**available for all document types**. Only for PDF documents, methods " ":meth:`Document.get_page_images` / :meth:`Page.get_images` offer some " "overlapping functionality as far as image lists are concerned. But both " "lists **may or may not** contain the same items. Any differences are most" " probably caused by one of the following:" msgstr ":ref:`TextPage` 및 해당 메서드 :meth:`Page.get_text` 는 **모든 문서 타입에 사용 가능합니다**. PDF 문서의 경우에만 :meth:`Document.get_page_images` / :meth:`Page.get_images` 메서드가 이미지 목록과 관련하여 일부 중복 기능을 제공합니다. 그러나 두 목록은 **같은 항목을 포함할 수도 있고 포함하지 않을 수도 있습니다**. 차이점은 다음 중 하나로 인한 것일 가능성이 높습니다:" #: ../../textpage.rst:234 87715f6d6a82452b8ef41b7cbb3b917c msgid "" "\"Inline\" images (see page 214 of the :ref:`AdobeManual`) of a PDF page " "are contained in a textpage, but **do not appear** in " ":meth:`Page.get_images`." msgstr "PDF 페이지의 \"인라인\" 이미지(:ref:`AdobeManual` 214페이지 참조)는 텍스트 페이지에 포함되지만 :meth:`Page.get_images` 에는 **나타나지 않습니다**." #: ../../textpage.rst:235 7671c8c4e14e4452a9de51d3be9f9a57 msgid "" "Annotations may also contain images -- these will **not appear** in " ":meth:`Page.get_images`." msgstr "주석에도 이미지가 포함될 수 있습니다. 이것들은 :meth:`Page.get_images` 에 **나타나지 않습니다**." #: ../../textpage.rst:236 528e4366c2844284b6b3e06d85663c2c msgid "" "Image blocks in a textpage are generated for **every** image location -- " "whether or not there are any duplicates. This is in contrast to " ":meth:`Page.get_images`, which will list each image only once (per " "reference name)." msgstr "텍스트 페이지의 이미지 블록은 **모든** 이미지 위치에 대해 생성됩니다. 중복이 있는지 여부와 관계없이. 이것은 각 이미지를 한 번만 나열하는 :meth:`Page.get_images` (참조 이름당)와 대조됩니다." #: ../../textpage.rst:237 6ba5259a29524a72bae31a85c368deb0 msgid "" "Images mentioned in the page's :data:`object` definition will **always** " "appear in :meth:`Page.get_images` [#f1]_. But it may happen, that there " "is no \"display\" command in the page's :data:`contents` (erroneously or " "on purpose). In this case the image will **not appear** in the textpage." msgstr "페이지의 :data:`object` 정의에 언급된 이미지는 **항상** :meth:`Page.get_images` [#f1]_ 에 나타납니다. 그러나 페이지의 :data:`contents` 에 \"display\" 명령이 없을 수 있습니다(오류 또는 의도적으로). 이 경우 이미지는 텍스트 페이지에 **나타나지 않습니다**." #: ../../textpage.rst:239 e7f81738e67441429325db9963571f7d msgid "" "The image's \"transformation matrix\" is defined as the matrix, for which" " the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, " "lookup details here: :ref:`ImageTransformation`." msgstr "이미지의 \"변환 행렬\" 은 표현식 `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` 가 참인 행렬로 정의됩니다. 자세한 내용은 :ref:`ImageTransformation` 을 참조하세요." #: ../../textpage.rst:241 57bed7561cd444e0b640b95c35da2f85 msgid "" "A transparent image may be accompanied by a mask image. This is stored " "under key `\"mask\"` and has the format of a `DeviceGray` PNG image. " "Otherwise the value of this key is ``None``. If present, you may be able " "to recover (an equivalent of) the original image -- i.e. with " "transparency -- by creating :ref:`Pixmap` objects from the \"image\", " "respectively \"mask\" values and overlay them. This is not guaranteed to " "always work because mask images come in multiple formats, of which not " "all qualify for the conditions under which overlaying Pixmaps are " "supported. Here is a code snippet:" msgstr "투명 이미지에는 마스크 이미지가 함께 제공될 수 있습니다. 이것은 키 `\"mask\"` 아래에 저장되며 `DeviceGray` PNG 이미지 형식을 가집니다. 그렇지 않으면 이 키의 값은 ``None`` 입니다. 있는 경우 \"image\" 및 \"mask\" 값에서 :ref:`Pixmap` 객체를 생성하고 오버레이하여 원본 이미지(즉, 투명도 포함)를 복구할 수 있습니다. 마스크 이미지는 여러 형식으로 제공되며, 모든 형식이 Pixmap 오버레이가 지원되는 조건을 충족하지는 않기 때문에 항상 작동한다고 보장할 수는 없습니다. 다음은 코드 스니펫입니다:" #: ../../textpage.rst:248 4615f23b245b4db39e8ea23b4d176464 msgid "**Text block:**" msgstr "**텍스트 블록:**" #: ../../textpage.rst:253 db5d3f31fc8d4153b8fafecfdf3d1727 msgid "0 = text *(int)*" msgstr "0 = 텍스트 *(int)*" #: ../../textpage.rst:254 6964cf3c7ba24458aae29d347f3f603a msgid "block rectangle, :data:`rect_like`" msgstr "블록 사각형, :data:`rect_like`" #: ../../textpage.rst:255 731cf949720a4619b5ea681f7764d295 msgid "block count *(int)*" msgstr "블록 개수 *(int)*" #: ../../textpage.rst:256 3a23e4510e7949e29bf987d16327eb49 msgid "lines" msgstr "lines" #: ../../textpage.rst:256 ede4e782ec014752989f15767a43462d msgid "*list* of text line dictionaries" msgstr "텍스트 줄 딕셔너리의 *list*" #: ../../textpage.rst:260 647d1430aba549968a23caa9bd2bf178 msgid "Line Dictionary" msgstr "줄 딕셔너리" #: ../../textpage.rst:265 88d566f6551a42a29f62a0819ecbed64 msgid "line rectangle, :data:`rect_like`" msgstr "줄 사각형, :data:`rect_like`" #: ../../textpage.rst:266 bc961e945f144c85a9e1a2193c3a4443 msgid "wmode" msgstr "wmode" #: ../../textpage.rst:266 220a8c26dda34ae4b15fb120791f0296 msgid "writing mode *(int)*: 0 = horizontal, 1 = vertical" msgstr "쓰기 모드 *(int)*: 0 = 수평, 1 = 수직" #: ../../textpage.rst:267 b23571753e8641b391f1c7bd3d666faf msgid "dir" msgstr "dir" #: ../../textpage.rst:267 f040c814bf3643e0b50bb1889d157bc2 msgid "writing direction, :data:`point_like`" msgstr "쓰기 방향, :data:`point_like`" #: ../../textpage.rst:268 f4df6d31bea14f7d9133d10fe217a237 msgid "spans" msgstr "spans" #: ../../textpage.rst:268 d2626131157f45bda11a0a0240ae20e0 msgid "*list* of span dictionaries" msgstr "범위 딕셔너리의 *list*" #: ../../textpage.rst:271 827a258f7a314424b22d7d3077bc4795 msgid "" "The value of key *\"dir\"* is the **unit vector** `dir = (cosine, -sine)`" " of the angle, which the text has relative to the x-axis [#f2]_. See the " "following picture: The word in each quadrant (counter-clockwise from top-" "right to bottom-right) is rotated by 30, 120, 210 and 300 degrees " "respectively." msgstr "키 *\"dir\"* 의 값은 텍스트가 x축에 대해 가진 각도의 **단위 벡터** `dir = (cosine, -sine)` 입니다 [#f2]_. 다음 그림을 참조하세요: 각 사분면(오른쪽 위에서 오른쪽 아래로 반시계 방향)의 단어는 각각 30, 120, 210, 300도 회전됩니다." #: ../../textpage.rst:277 76e3be33b8eb4d20a040a290a7493044 msgid "Span Dictionary" msgstr "범위 딕셔너리" #: ../../textpage.rst:279 44e867372fca4010ae8c117e6f57244a msgid "" "Spans contain the actual text. A line contains **more than one span " "only**, if it contains text with different font properties." msgstr "범위에는 실제 텍스트가 포함됩니다. 줄은 다른 글꼴 속성을 가진 텍스트를 포함하는 경우에만 **하나 이상의 범위** 를 포함합니다." #: ../../textpage.rst:281 2484e6f332594c488b1ab6e8e45e8358 msgid "Changed in version 1.14.17 Spans now also have a *bbox* key (again)." msgstr "버전 1.14.17에서 변경됨: 범위에 이제 *bbox* 키가 다시 있습니다." #: ../../textpage.rst:282 fe2deeccb3484496b06cee9c45979177 msgid "Changed in version 1.17.6 Spans now also have an *origin* key." msgstr "버전 1.17.6에서 변경됨: 범위에 이제 *origin* 키가 있습니다." #: ../../textpage.rst:287 24917424394140498d62e12db012d491 msgid "span rectangle, :data:`rect_like`" msgstr "범위 사각형, :data:`rect_like`" #: ../../textpage.rst:288 ../../textpage.rst:371 #: d062895875c246f08ce11e156a46fe6c e4eadb2bf3fd4656a1dcaea2aa762fb2 msgid "origin" msgstr "origin" #: ../../textpage.rst:288 49dcac4791f7495283b181cd85e5cb96 msgid "the first character's origin, :data:`point_like`" msgstr "첫 번째 문자의 원점, :data:`point_like`" #: ../../textpage.rst:289 a039c803b12f44f2b903bfd72ff968f0 msgid "font" msgstr "font" #: ../../textpage.rst:289 e59d2678453347c3b2290c87101bee41 msgid "font name *(str)*" msgstr "글꼴 이름 *(str)*" #: ../../textpage.rst:290 9789271ef0d44ca8b8b7753a47109329 msgid "ascender" msgstr "ascender" #: ../../textpage.rst:290 bae202ea90f340c08117616fba695605 msgid "ascender of the font *(float)*" msgstr "글꼴의 상승부 *(float)*" #: ../../textpage.rst:291 f04de1e03bc64ecb932178642bbf28a2 msgid "descender" msgstr "descender" #: ../../textpage.rst:291 cab39571402145599cd516740c2cd5e3 msgid "descender of the font *(float)*" msgstr "글꼴의 하강부 *(float)*" #: ../../textpage.rst:292 7bb34b245d0e4a7a807d37f771540973 msgid "font size *(float)*" msgstr "글꼴 크기 *(float)*" #: ../../textpage.rst:293 728b3550893a43df91864ece6b6a6c75 msgid "flags" msgstr "flags" #: ../../textpage.rst:293 d4144f5c31e240ca8a9bc6a9902c4b40 msgid "font characteristics *(int)*" msgstr "글꼴 특성 *(int)*" #: ../../textpage.rst:294 4ab488b7a402495f924066ec5fa0901d msgid "char_flags" msgstr "char_flags" #: ../../textpage.rst:294 ac689e1eb3bd44c196f5a43696910e9c msgid "char characteristics *(int)*" msgstr "문자 특성 *(int)*" #: ../../textpage.rst:295 70dfc6783fdb4c5a8a1e0ad9b92b44fc msgid "color" msgstr "color" #: ../../textpage.rst:295 0c21ca835d2f477e934a8f5cec1f8a4c msgid "text color in sRGB format 0xRRGGBB *(int)*." msgstr "sRGB 형식의 텍스트 색상 0xRRGGBB *(int)*." #: ../../textpage.rst:296 8e921b08a2ba477497897d70a87f4977 msgid "alpha" msgstr "alpha" #: ../../textpage.rst:296 ec794a253afb48ea90cf9d7494caa03b msgid "text opacity 0..255 *(int)*." msgstr "텍스트 불투명도 0..255 *(int)*." #: ../../textpage.rst:297 72dbc8f290b94f6c88700e6a5df12717 msgid "text" msgstr "text" #: ../../textpage.rst:297 42bc9c7faaed433c9e3868ab04254f3f msgid "(only for :meth:`extractDICT`) text *(str)*" msgstr "(:meth:`extractDICT` 전용) 텍스트 *(str)*" #: ../../textpage.rst:298 6c4e864e58554766a1c930bd0e32e581 msgid "chars" msgstr "chars" #: ../../textpage.rst:298 287db5214934490ba0764caaa9ee699d msgid "(only for :meth:`extractRAWDICT`) *list* of character dictionaries" msgstr "(:meth:`extractRAWDICT` 전용) 문자 딕셔너리의 *list*" #: ../../textpage.rst:301 6a3a9323a60541ca97db64597a2a451a msgid "|history_begin|" msgstr "|history_begin|" #: ../../textpage.rst:303 e0b8ee67e36546b0b5b8b155e00eeb45 msgid "*(New in version 1.25.3.0):* Added *\"alpha\"* item." msgstr "*(버전 1.25.3.0에서 새로 추가됨):* *\"alpha\"* 항목 추가." #: ../../textpage.rst:305 04010301eebf4c2dbf6989108e207ae9 msgid "" "*(New in version 1.16.0):* *\"color\"* is the text color encoded in sRGB " "(int) format, e.g. 0xFF0000 for red. There are functions for converting " "this integer back to formats (r, g, b) (PDF with float values from 0 to " "1) :meth:`sRGB_to_pdf`, or (R, G, B), :meth:`sRGB_to_rgb` (with integer " "values from 0 to 255)." msgstr "*(버전 1.16.0에서 새로 추가됨):* *\"color\"* 는 sRGB (int) 형식으로 인코딩된 텍스트 색상입니다. 예: 빨간색의 경우 0xFF0000. 이 정수를 다시 형식으로 변환하는 함수가 있습니다: (r, g, b) (0에서 1까지의 float 값, PDF) :meth:`sRGB_to_pdf`, 또는 (R, G, B) :meth:`sRGB_to_rgb` (0에서 255까지의 정수 값)." #: ../../textpage.rst:307 744bef29da2f4dbc90404a35ef0fd253 msgid "" "*(New in v1.18.5):* *\"ascender\"* and *\"descender\"* are font " "properties, provided relative to :data:`fontsize` 1. Note that descender " "is a negative value. The following picture shows the relationship to " "other values and properties." msgstr "*(v1.18.5에서 새로 추가됨):* *\"ascender\"* 와 *\"descender\"* 는 :data:`fontsize` 1에 상대적인 글꼴 속성입니다. descender는 음수 값입니다. 다음 그림은 다른 값 및 속성과의 관계를 보여줍니다." #: ../../textpage.rst:309 e0a8a997405247f6bb89749ab0b624b7 msgid "|history_end|" msgstr "|history_end|" #: ../../textpage.rst:314 9b180b7db6ac43e489b8d8e9ccb31622 msgid "" "These numbers may be used to compute the minimum height of a character " "(or span) -- as opposed to the standard height provided in the \"bbox\" " "values (which actually represents the **line height**). The following " "code recalculates the span bbox to have a height of **fontsize** exactly " "fitting the text inside:" msgstr "이 숫자는 문자(또는 범위)의 최소 높이를 계산하는 데 사용할 수 있습니다. \"bbox\" 값에 제공된 표준 높이(실제로 **줄 높이** 를 나타냄)와 대조됩니다. 다음 코드는 범위 bbox를 **fontsize** 높이로 재계산하여 내부 텍스트에 정확히 맞도록 합니다:" #: ../../textpage.rst:324 91c353d85b0a45d7bde9987e275b50b5 msgid "" "The above calculation may deliver a **larger** height! This may e.g. " "happen for OCRed documents, where the risk of all sorts of text artifacts" " is high. MuPDF tries to come up with a reasonable bbox height, " "independently from the :data:`fontsize` found in the PDF. So please " "ensure that the height of `span[\"bbox\"]` is **larger** than " "`span[\"size\"]`." msgstr "위 계산은 **더 큰** 높이를 제공할 수 있습니다! 예를 들어 OCR된 문서에서 이런 일이 발생할 수 있으며, 모든 종류의 텍스트 아티팩트 위험이 높습니다. |MuPDF| 는 PDF에서 찾은 :data:`fontsize` 와 독립적으로 합리적인 bbox 높이를 제시하려고 합니다. 따라서 `span[\"bbox\"]` 의 높이가 `span[\"size\"]` 보다 **큰지** 확인하세요." #: ../../textpage.rst:326 cfa2fe9816d741889a16e7a98228f45f msgid "" "You may request PyMuPDF to do all of the above automatically by executing" " `pymupdf.TOOLS.set_small_glyph_heights(True)`. This sets a global " "parameter so that all subsequent text searches and text extractions are " "based on reduced glyph heights, where meaningful." msgstr "`pymupdf.TOOLS.set_small_glyph_heights(True)` 를 실행하여 |PyMuPDF| 가 위의 모든 작업을 자동으로 수행하도록 요청할 수 있습니다. 이것은 전역 매개변수를 설정하여 모든 후속 텍스트 검색 및 텍스트 추출이 의미 있는 경우 감소된 글리프 높이를 기반으로 하도록 합니다." #: ../../textpage.rst:328 dcd3f3103b3a404ea59ed88e1020efbe msgid "" "The following shows the original span rectangle in red and the rectangle " "with re-computed height in blue." msgstr "다음은 빨간색으로 표시된 원본 범위 사각형과 파란색으로 표시된 재계산된 높이의 사각형을 보여줍니다." #: ../../textpage.rst:334 c4897a84054b4b60ab66d79b8388e431 msgid "" "*\"flags\"* is an integer, which represents font properties except for " "the first bit 0. They are to be interpreted like this:" msgstr "*\"flags\"* 는 첫 번째 비트 0을 제외한 글꼴 속성을 나타내는 정수입니다. 다음과 같이 해석됩니다:" #: ../../textpage.rst:336 817f541495b84011b646fb0f5a0c1eff msgid "" "bit 0: superscripted (:data:`TEXT_FONT_SUPERSCRIPT`) -- not a font " "property, detected by MuPDF code." msgstr "비트 0: 위첨자 (:data:`TEXT_FONT_SUPERSCRIPT`) -- 글꼴 속성이 아니며 MuPDF 코드에 의해 감지됩니다." #: ../../textpage.rst:337 4966d75813f448898822b04faffbe380 msgid "bit 1: italic (:data:`TEXT_FONT_ITALIC`)" msgstr "비트 1: 기울임꼴 (:data:`TEXT_FONT_ITALIC`)" #: ../../textpage.rst:338 31205a9cd37941e0ac7c7fbbfb19ffc1 msgid "bit 2: serifed (:data:`TEXT_FONT_SERIFED`)" msgstr "비트 2: 세리프 (:data:`TEXT_FONT_SERIFED`)" #: ../../textpage.rst:339 f887f5fcd078467cbd8ea212d8133aa3 msgid "bit 3: monospaced (:data:`TEXT_FONT_MONOSPACED`)" msgstr "비트 3: 고정폭 (:data:`TEXT_FONT_MONOSPACED`)" #: ../../textpage.rst:340 075ed56b276245c096a3204cc111339a msgid "bit 4: bold (:data:`TEXT_FONT_BOLD`)" msgstr "비트 4: 굵게 (:data:`TEXT_FONT_BOLD`)" #: ../../textpage.rst:342 fafa4c4a530a43fa8278e455dd07640f msgid "Test these characteristics like so:" msgstr "다음과 같이 이러한 특성을 테스트합니다:" #: ../../textpage.rst:348 ffbc346b79aa4a6189253e08eeb6280f msgid "" "Bits 1 thru 4 are font properties, i.e. encoded in the font program. " "Please note, that this information is not necessarily correct or " "complete: fonts quite often contain wrong data here." msgstr "비트 1부터 4까지는 글꼴 속성, 즉 글꼴 프로그램에 인코딩된 것입니다. 이 정보가 반드시 정확하거나 완전하지는 않습니다. 글꼴은 여기에 잘못된 데이터를 포함하는 경우가 많습니다." #: ../../textpage.rst:350 67a56b648e48459abc86b3d71dded7d7 msgid "" "*\"char_flags\"* is an integer, which represents extra character " "properties:" msgstr "*\"char_flags\"* 는 추가 문자 속성을 나타내는 정수입니다:" #: ../../textpage.rst:352 16e54aeb7318448cb0edbbce096027cc msgid "bit 0: strikeout." msgstr "비트 0: 취소선." #: ../../textpage.rst:353 f36bc128a5084f419c7b735cc7a5caeb msgid "bit 1: underline." msgstr "비트 1: 밑줄." #: ../../textpage.rst:354 05f6a81ee7234929b145f42b0eaeb4ee msgid "bit 2: synthetic (always 0, see char dictionary)." msgstr "비트 2: 합성 (항상 0, 문자 딕셔너리 참조)." #: ../../textpage.rst:355 2d7d278b9b7b46479144808b701ed7da msgid "bit 3: filled." msgstr "비트 3: 채움." #: ../../textpage.rst:356 a0b8d460dd8a42e69537652330a1f9ee msgid "bit 4: stroked." msgstr "비트 4: 획." #: ../../textpage.rst:357 430da53ed561403d90a8c2c28cc01a90 msgid "bit 5: clipped." msgstr "비트 5: 클리핑." #: ../../textpage.rst:359 26fc27f279ca42fba75113be40e54d40 msgid "" "For example if not filled and not stroked (`if not (char_flags & 2**3 & " "2**4): ...`) then the text will be invisible." msgstr "예를 들어 채워지지 않고 획이 없으면 (`if not (char_flags & 2**3 & 2**4): ...`) 텍스트가 보이지 않습니다." #: ../../textpage.rst:362 f68e611505354310ab256d5f4ac755f3 msgid "(`char_flags` is new in v1.25.2.)" msgstr "(`char_flags` 는 v1.25.2에서 새로 추가됨.)" #: ../../textpage.rst:366 2b6029a504d149d0b74200b8dd10b461 msgid "Character Dictionary for :meth:`extractRAWDICT`" msgstr ":meth:`extractRAWDICT` 의 문자 딕셔너리" #: ../../textpage.rst:371 e3322f02de66484cb59d9ddf2e914bcb msgid "character's left baseline point, :data:`point_like`" msgstr "문자의 왼쪽 기준선 점, :data:`point_like`" #: ../../textpage.rst:372 3a206190a9b4495299d14480848ee306 msgid "character rectangle, :data:`rect_like`" msgstr "문자 사각형, :data:`rect_like`" #: ../../textpage.rst:373 7925e02a5e07443895c900f6450205fa msgid "synthetic" msgstr "synthetic" #: ../../textpage.rst:373 d557f7b009724b00a3418fb77e4943ce msgid "bool." msgstr "bool." #: ../../textpage.rst:374 fb692a970116495a977cac2daff0d94b msgid "c" msgstr "c" #: ../../textpage.rst:374 30e9a39551314a14a169ee11d34c575f msgid "the character (unicode)" msgstr "문자 (유니코드)" #: ../../textpage.rst:377 504a88fbf1324f19a3ed16c3f2c0c942 msgid "(`synthetic` is new in v1.25.3.)" msgstr "(`synthetic` 는 v1.25.3에서 새로 추가됨.)" #: ../../textpage.rst:379 9d820af6f3ac446a912245d16d5e7bdd msgid "" "This image shows the relationship between a character's bbox and its " "quad: |textpagechar|" msgstr "이 이미지는 문자의 bbox와 quad 간의 관계를 보여줍니다: |textpagechar|" #: ../../textpage.rst:381 64023f700298486f98b566eac340e37b #: 7901af22526f478cb0ba76a7cc56288e msgid "textpagechar" msgstr "textpagechar" #: ../../textpage.rst:386 ab41f5e333004a04a46c0505e9d7bebf msgid "Footnotes" msgstr "각주" #: ../../textpage.rst:387 9c3377a336cd4477b8afbd4528d4dee0 msgid "" "Image specifications for a PDF page are done in a page's (sub-) " ":data:`dictionary`, called `/Resources`. Resource dictionaries can be " "**inherited** from any of the page's parent objects (usually the " ":data:`catalog` -- the top-level parent). The PDF creator may e.g. define" " one `/Resources` on file level, naming all images and / or all fonts " "ever used by any page. In these cases, :meth:`Page.get_images` and " ":meth:`Page.get_fonts` will consequently return the same lists for all " "pages. If desired, this situation can be reverted using " ":meth:`Page.clean_contents`. After execution, the page's object " "definition will show fonts and images that are actually used." msgstr "PDF 페이지의 이미지 사양은 `/Resources` 라는 페이지의 (하위) :data:`dictionary` 에서 수행됩니다. 리소스 딕셔너리는 페이지의 부모 객체(일반적으로 :data:`catalog` -- 최상위 부모) 중 하나에서 **상속** 될 수 있습니다. PDF 생성자는 예를 들어 파일 수준에서 하나의 `/Resources` 를 정의하여 모든 페이지에서 사용된 모든 이미지 및/또는 모든 글꼴을 명명할 수 있습니다. 이 경우 :meth:`Page.get_images` 와 :meth:`Page.get_fonts` 는 결과적으로 모든 페이지에 대해 동일한 목록을 반환합니다. 원하는 경우 :meth:`Page.clean_contents` 를 사용하여 이 상황을 되돌릴 수 있습니다. 실행 후 페이지의 객체 정의는 실제로 사용되는 글꼴과 이미지를 표시합니다." #: ../../textpage.rst:389 8ebe9e78accc4c87b80eb50757ed695f msgid "" "The coordinate systems of MuPDF and PDF are different in that MuPDF uses " "the page's top-left point as `(0, 0)`. In PDF, this is the bottom-left " "point. Therefore, the positive direction for MuPDF's y-axis is **from top" " to bottom**. This causes the sign change for the sine value here: a " "**negative** value indicates anti-clockwise rotation of the text." msgstr "|MuPDF| 와 PDF의 좌표계는 |MuPDF| 가 페이지의 왼쪽 위 점을 `(0, 0)` 으로 사용한다는 점에서 다릅니다. PDF에서는 이것이 왼쪽 아래 점입니다. 따라서 |MuPDF| 의 y축의 양의 방향은 **위에서 아래로** 입니다. 이것은 여기서 사인 값의 부호 변경을 유발합니다: **음수** 값은 텍스트의 반시계 방향 회전을 나타냅니다." #: ../../textpage.rst:391 9bfe3c4bcdac45eb9b746197c51d2a7a msgid "" "This value is always 96, the default of the PDF interpreter. It **does " "not reflect** the resolution of the image itself. If you need the image's" " resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` " "attributes of the :ref:`Pixmap` created from the returned image binary." msgstr "이 값은 항상 96이며, PDF 인터프리터의 기본값입니다. 이것은 **이미지 자체의 해상도를 반영하지 않습니다**. 이미지의 해상도가 필요한 경우 반환된 이미지 바이너리에서 생성된 :ref:`Pixmap` 의 :meth:`Pixmap.xres` 및 :meth:`Pixmap.yres` 속성을 사용하세요." #: ../../footer.rst:46 909bafb54f4646cd8842c5ccd34ceeef msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/textwriter.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 95c1ee7365714a268b45d71ca863b7ee msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 8dbea99845b74a23bde58d46198a17ac msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 cf3d095401604af48e44cc3a35d66bff msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, Pyodide, PyScript" #: ../../textwriter.rst:7 e9730367b10a49359e1d45817a7f7880 msgid "TextWriter" msgstr "TextWriter (텍스트 라이터)" #: ../../textwriter.rst:9 cda3eb15a6fe4186b26bf8276092c97f msgid "|pdf_only_class|" msgstr "|pdf_only_class|" #: ../../textwriter.rst:11 db627f8740eb4561a5527a9d4ca4e25f msgid "New in v1.16.18" msgstr "v1.16.18에서 새로 추가됨" #: ../../textwriter.rst:13 67e48f18fa9440238b3a1969be763ace msgid "" "This class represents a MuPDF *text* object. The basic idea is to " "**decouple (1) text preparation, and (2) text output** to PDF pages." msgstr "이 클래스는 MuPDF *text* 객체를 나타냅니다. 기본 아이디어는 **(1) 텍스트 준비와 (2) PDF 페이지로의 텍스트 출력을 분리** 하는 것입니다." #: ../../textwriter.rst:15 5a301b5eac7846a6a95cae297b7806a2 msgid "" "During **preparation**, a text writer stores any number of text pieces " "(\"spans\") together with their positions and individual font " "information. The **output** of the writer's prepared content may happen " "multiple times to any PDF page with a compatible page size." msgstr "**준비** 중에 텍스트 라이터는 임의의 수의 텍스트 조각(\"스팬\")을 위치 및 개별 글꼴 정보와 함께 저장합니다. 라이터의 준비된 콘텐츠의 **출력** 은 호환되는 페이지 크기를 가진 모든 PDF 페이지에 여러 번 수행될 수 있습니다." #: ../../textwriter.rst:17 7cf591fcc0cf40af9d587a72b702b960 msgid "" "A text writer is an elegant alternative to methods " ":meth:`Page.insert_text` and friends:" msgstr "텍스트 라이터는 :meth:`Page.insert_text` 및 유사한 메서드에 대한 우아한 대안입니다:" #: ../../textwriter.rst:19 8d88b6d0545142bc9885b1dcbb44a4ea msgid "" "**Improved text positioning:** Choose any point where insertion of text " "should start. Storing text returns the \"cursor position\" after the " "*last character* of the span." msgstr "**개선된 텍스트 위치 지정:** 텍스트 삽입이 시작되어야 하는 임의의 지점을 선택합니다. 텍스트 저장은 스팬의 *마지막 문자* 이후의 \"커서 위치\"를 반환합니다." #: ../../textwriter.rst:20 4014fff4490f449991524305bfef1c4b msgid "" "**Free font choice:** Each text span has its own font and " ":data:`fontsize`. This lets you easily switch when composing a larger " "text." msgstr "**자유로운 글꼴 선택:** 각 텍스트 스팬은 자체 글꼴과 :data:`fontsize` 를 가집니다. 이를 통해 더 큰 텍스트를 구성할 때 쉽게 전환할 수 있습니다." #: ../../textwriter.rst:21 96e0cdf2386340edafe0ed3b9aa2a211 msgid "" "**Automatic fallback fonts:** If a character is not supported by the " "chosen font, alternative fonts are automatically searched. This " "significantly reduces the risk of seeing unprintable symbols in the " "output (\"TOFUs\" -- looking like a small rectangle). PyMuPDF now also " "comes with the **universal font \"Droid Sans Fallback Regular\"**, which " "supports **all Latin** characters (including Cyrillic and Greek), and " "**all CJK** characters (Chinese, Japanese, Korean)." msgstr "**자동 대체 글꼴:** 선택한 글꼴이 문자를 지원하지 않으면 대체 글꼴이 자동으로 검색됩니다. 이는 출력에서 인쇄할 수 없는 기호(\"TOFUs\" -- 작은 사각형처럼 보임)를 볼 위험을 크게 줄입니다. |PyMuPDF| 는 이제 **모든 라틴** 문자(키릴 문자 및 그리스 문자 포함)와 **모든 CJK** 문자(중국어, 일본어, 한국어)를 지원하는 **범용 글꼴 \"Droid Sans Fallback Regular\"** 를 제공합니다." #: ../../textwriter.rst:22 89a8833cb85e46909d178dc372f5aaac msgid "" "**Cyrillic and Greek Support:** The :ref:`Base-14-fonts` have integrated " "support of Cyrillic and Greek characters **without specifying encoding.**" " Your text may be a mixture of Latin, Greek and Cyrillic." msgstr "**키릴 문자 및 그리스 문자 지원:** :ref:`Base-14-fonts` 는 **인코딩을 지정하지 않고** 키릴 문자 및 그리스 문자에 대한 통합 지원을 제공합니다. 텍스트는 라틴 문자, 그리스 문자 및 키릴 문자의 혼합일 수 있습니다." #: ../../textwriter.rst:23 939bfd358cb14ee1ac3d682b4310030f msgid "" "**Transparency support:** Parameter *opacity* is supported. This offers a" " handy way to create watermark-style text." msgstr "**투명도 지원:** *opacity* 매개변수가 지원됩니다. 이를 통해 워터마크 스타일의 텍스트를 만드는 편리한 방법을 제공합니다." #: ../../textwriter.rst:24 36106b9c863b43c39d4d348af9680b3e msgid "" "**Justified text:** Supported for any font -- not just simple fonts as in" " :meth:`Page.insert_textbox`." msgstr "**양쪽 정렬 텍스트:** :meth:`Page.insert_textbox` 와 같은 단순 글꼴뿐만 아니라 모든 글꼴에 대해 지원됩니다." #: ../../textwriter.rst:25 88d0bcdd76b94defb985b51bd7050a50 msgid "" "**Reusability:** A TextWriter object exists independent from PDF pages. " "It can be written multiple times, either to the same or to other pages, " "in the same or in different PDFs, choosing different colors or " "transparency." msgstr "**재사용성:** TextWriter 객체는 PDF 페이지와 독립적으로 존재합니다. 동일한 페이지 또는 다른 페이지, 동일한 PDF 또는 다른 PDF에 여러 번 작성할 수 있으며, 다른 색상이나 투명도를 선택할 수 있습니다." #: ../../textwriter.rst:27 6ef8000439b141009aae765ba8c24479 msgid "Using this object entails three steps:" msgstr "이 객체를 사용하려면 세 단계가 필요합니다:" #: ../../textwriter.rst:29 55dea84332984f3ca477041ec762edcf msgid "" "When **created**, a TextWriter requires a fixed **page rectangle** in " "relation to which it calculates text positions. A text writer can write " "to pages of this size only." msgstr "**생성** 시 TextWriter는 텍스트 위치를 계산하기 위한 고정된 **페이지 사각형** 이 필요합니다. 텍스트 라이터는 이 크기의 페이지에만 쓸 수 있습니다." #: ../../textwriter.rst:30 57f72fe6a49d41c7be7ed160f47f3019 msgid "" "Store text in the TextWriter using methods :meth:`TextWriter.append`, " ":meth:`TextWriter.appendv` and :meth:`TextWriter.fill_textbox` as often " "as is desired." msgstr "원하는 만큼 :meth:`TextWriter.append`, :meth:`TextWriter.appendv` 및 :meth:`TextWriter.fill_textbox` 메서드를 사용하여 TextWriter에 텍스트를 저장합니다." #: ../../textwriter.rst:31 ac5cfe5c0bf548bf8358a2cc4efa279b msgid "Output the TextWriter object on some PDF page(s)." msgstr "일부 PDF 페이지에 TextWriter 객체를 출력합니다." #: ../../textwriter.rst:35 a70f239f39dc44bcbbcc7f367f4f04e8 msgid "" "Starting with version 1.17.0, TextWriters **do support** text rotation " "via the *morph* parameter of :meth:`TextWriter.write_text`." msgstr "버전 1.17.0부터 TextWriter는 :meth:`TextWriter.write_text` 의 *morph* 매개변수를 통한 텍스트 회전을 **지원합니다**." #: ../../textwriter.rst:37 39efcbe7af8242d59a6e61a1577bd093 msgid "" "There also exists :meth:`Page.write_text` which combines one or more " "TextWriters and jointly writes them to a given rectangle and with a given" " rotation angle -- much like :meth:`Page.show_pdf_page`." msgstr ":meth:`Page.write_text` 도 존재하며, 하나 이상의 TextWriter를 결합하여 주어진 사각형과 주어진 회전 각도로 공동으로 작성합니다 -- :meth:`Page.show_pdf_page` 와 매우 유사합니다." #: ../../textwriter.rst:41 58759c7fac7b4e859398a94c56641cf5 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../textwriter.rst:41 f8b99b262c4e479daa04854b10a8ca62 msgid "**Short Description**" msgstr "**간략 설명**" #: ../../textwriter.rst:43 5aef1526d3ed401ebe84391dae14eb4e msgid ":meth:`~TextWriter.append`" msgstr ":meth:`~TextWriter.append`" #: ../../textwriter.rst:43 8a1f849d010e4a069dd84d412203d33f msgid "Add text in horizontal write mode" msgstr "수평 쓰기 모드에서 텍스트 추가" #: ../../textwriter.rst:44 a3aab120ca1545a79fce7af51ccd1964 msgid ":meth:`~TextWriter.appendv`" msgstr ":meth:`~TextWriter.appendv`" #: ../../textwriter.rst:44 30601ff66d064e7bbc6b0711078114c1 msgid "Add text in vertical write mode" msgstr "수직 쓰기 모드에서 텍스트 추가" #: ../../textwriter.rst:45 665726b1a2f74150b2cf20b54f5d3864 msgid ":meth:`~TextWriter.fill_textbox`" msgstr ":meth:`~TextWriter.fill_textbox`" #: ../../textwriter.rst:45 79bdf8fe196e481f9e0f7e6b6d83fa39 msgid "Fill rectangle (horizontal write mode)" msgstr "사각형 채우기 (수평 쓰기 모드)" #: ../../textwriter.rst:46 50d2cf2d0f664964ad637397d702ba01 msgid ":meth:`~TextWriter.write_text`" msgstr ":meth:`~TextWriter.write_text`" #: ../../textwriter.rst:46 e17f4b99e3a3451090107da06c63083d msgid "Output TextWriter to a PDF page" msgstr "TextWriter를 PDF 페이지로 출력" #: ../../textwriter.rst:47 b1dd0ce95c524931a45226c559b5fc7f msgid ":attr:`~TextWriter.color`" msgstr ":attr:`~TextWriter.color`" #: ../../textwriter.rst:47 977d247f29344daebbc7eb2edad63dda msgid "Text color (can be changed)" msgstr "텍스트 색상 (변경 가능)" #: ../../textwriter.rst:48 a702a69b27f04a1a8bf416872181b83c msgid ":attr:`~TextWriter.last_point`" msgstr ":attr:`~TextWriter.last_point`" #: ../../textwriter.rst:48 9c6a85c298f542b0ad83608987c80d7c msgid "Last written character ends here" msgstr "마지막으로 작성된 문자가 여기서 끝남" #: ../../textwriter.rst:49 85bb365488064af39728ae2cff15a95e msgid ":attr:`~TextWriter.opacity`" msgstr ":attr:`~TextWriter.opacity`" #: ../../textwriter.rst:49 360143b334e144b188b4fc4606f37cd1 msgid "Text opacity (can be changed)" msgstr "텍스트 투명도 (변경 가능)" #: ../../textwriter.rst:50 44cf6996b53b4136925af2dd23e6d3c3 msgid ":attr:`~TextWriter.rect`" msgstr ":attr:`~TextWriter.rect`" #: ../../textwriter.rst:50 a79f2dca7b614eaaa5682eae3f4fa368 msgid "Page rectangle used by this TextWriter" msgstr "이 TextWriter가 사용하는 페이지 사각형" #: ../../textwriter.rst:51 86888b68bbf045c8a8e10712005c4259 msgid ":attr:`~TextWriter.text_rect`" msgstr ":attr:`~TextWriter.text_rect`" #: ../../textwriter.rst:51 cd277f06068040caa6fda7759192bbd3 msgid "Area occupied so far" msgstr "지금까지 차지한 영역" #: ../../textwriter.rst:55 07466a577be94bd3ab53ccdfc689e759 msgid "**Class API**" msgstr "**클래스 API**" #: ../../textwriter.rst 0671bfe1c02041f88c29cf3ea4be264b #: 7841a29906a944f189e7e759b6592a97 7cb374b81c074ac69a19656e5756ce8c #: 800737d8455c4751bf6f9476b3e4a8df ffbf23da457b4c1fbab7452f6745e439 msgid "Parameters" msgstr "매개변수" #: ../../textwriter.rst:61 1156a360315c4f6cab4971ea0b50224f msgid "rectangle internally used for text positioning computations." msgstr "텍스트 위치 계산에 내부적으로 사용되는 사각형." #: ../../textwriter.rst:62 51fad4a4f8034a198c2666a029ac959b msgid "" "sets the transparency for the text to store here. Values outside the " "interval `[0, 1)` will be ignored. A value of e.g. 0.5 means 50% " "transparency." msgstr "여기에 저장할 텍스트의 투명도를 설정합니다. `[0, 1)` 구간 밖의 값은 무시됩니다. 예를 들어 0.5 값은 50% 투명도를 의미합니다." #: ../../textwriter.rst:63 6b628abb5ffe4a5585ddb2b56255b5dd msgid "" "the color of the text. All colors are specified as floats *0 <= color <= " "1*. A single float represents some gray level, a sequence implies the " "colorspace via its length." msgstr "텍스트의 색상. 모든 색상은 부동 소수점 *0 <= color <= 1* 로 지정됩니다. 단일 부동 소수점은 일부 회색 레벨을 나타내고, 시퀀스는 길이를 통해 색 공간을 암시합니다." #: ../../textwriter.rst:68 0fa13673da764fdaab29ebfad67bf44c msgid "*Changed in v1.18.9*" msgstr "*v1.18.9에서 변경됨*" #: ../../textwriter.rst:69 ../../textwriter.rst:100 #: 08713255cee94718b3bc26b0dda8f233 be3763dd7a294137b65bf5a1770830d3 msgid "*Changed in v1.18.15*" msgstr "*v1.18.15에서 변경됨*" #: ../../textwriter.rst:71 6f8eddc35363416184aad7c44e5d01ef msgid "Add some new text in horizontal writing." msgstr "수평 쓰기로 일부 새 텍스트를 추가합니다." #: ../../textwriter.rst:73 ../../textwriter.rst:104 #: 31e8d87141cf44c5890e5151a73047f4 f7e1346516c8429f9cafb3010a03a215 msgid "start position of the text, the bottom left point of the first character." msgstr "텍스트의 시작 위치, 첫 번째 문자의 왼쪽 하단 점." #: ../../textwriter.rst:74 3b2200db94814c6b84f09e2a67431714 msgid "" "a string of arbitrary length. It will be written starting at position " "\"pos\"." msgstr "임의 길이의 문자열. \"pos\" 위치에서 시작하여 작성됩니다." #: ../../textwriter.rst:75 ../../textwriter.rst:106 #: 6080d699b79c4e7cabc81e6632904644 8f2fdb3f4ec442f4b7703714fb642f4c msgid "a :ref:`Font`. If omitted, `pymupdf.Font(\"helv\")` will be used." msgstr ":ref:`Font`. 생략하면 `pymupdf.Font(\"helv\")` 가 사용됩니다." #: ../../textwriter.rst:76 09fbce8fe4ee46b0a95710e2b4761014 msgid "the :data:`fontsize`, a positive number, default 11." msgstr ":data:`fontsize`, 양수, 기본값 11." #: ../../textwriter.rst:77 ../../textwriter.rst:108 #: 4483c3fec8c3452cac52b7d831f281c1 87ccb28c8f1b4453af79b92ad4c5aabd msgid "" "the language to use, e.g. \"en\" for English. Meaningful values should be" " compliant with the ISO 639 standards 1, 2, 3 or 5. Reserved for future " "use: currently has no effect as far as we know." msgstr "사용할 언어, 예: 영어의 경우 \"en\". 의미 있는 값은 ISO 639 표준 1, 2, 3 또는 5를 준수해야 합니다. 향후 사용을 위해 예약됨: 현재로서는 알려진 바에 따르면 효과가 없습니다." #: ../../textwriter.rst:78 d8bd68ad24da40269a51cc710d5053e8 msgid "" "*(New in v1.18.9)* whether the text should be written from right to left." " Applicable for languages like Arabian or Hebrew. Default is ``False``. " "If ``True``, any Latin parts within the text will automatically " "converted. There are no other consequences, i.e. " ":attr:`TextWriter.last_point` will still be the rightmost character, and " "there neither is any alignment taking place. Hence you may want to use " ":meth:`TextWriter.fill_textbox` instead." msgstr "*(v1.18.9에서 새로 추가)* 텍스트를 오른쪽에서 왼쪽으로 작성할지 여부. 아랍어나 히브리어와 같은 언어에 적용됩니다. 기본값은 ``False`` 입니다. ``True`` 인 경우 텍스트 내의 모든 라틴 문자 부분이 자동으로 변환됩니다. 다른 결과는 없습니다. 즉, :attr:`TextWriter.last_point` 는 여전히 가장 오른쪽 문자이며 정렬도 수행되지 않습니다. 따라서 :meth:`TextWriter.fill_textbox` 를 대신 사용하는 것이 좋을 수 있습니다." #: ../../textwriter.rst:79 75daea05a2a449aa9e600dc6f54efa72 msgid "" "*(New in v1.18.15)* look for the character's Small Capital version in the" " font. If present, take that value instead. Otherwise the original " "character (this font or the fallback font) will be taken. The fallback " "font will never return small caps. For example, this snippet:: >>> doc =" " pymupdf.open() >>> page = doc.new_page() >>> text = \"PyMuPDF: the " "Python bindings for MuPDF\" >>> font = pymupdf.Font(\"figo\") # choose a" " font with small caps >>> tw = pymupdf.TextWriter(page.rect) >>> " "tw.append((50,100), text, font=font, small_caps=True) >>> " "tw.write_text(page) >>> doc.ez_save(\"x.pdf\") will produce this PDF " "text: .. image:: images/img-smallcaps.*" msgstr "" #: ../../textwriter.rst:79 46eb184e73ae4219ac1e4bed06322f56 msgid "" "*(New in v1.18.15)* look for the character's Small Capital version in the" " font. If present, take that value instead. Otherwise the original " "character (this font or the fallback font) will be taken. The fallback " "font will never return small caps. For example, this snippet::" msgstr "*(v1.18.15에서 새로 추가)* 글꼴에서 문자의 작은 대문자 버전을 찾습니다. 존재하면 해당 값을 사용합니다. 그렇지 않으면 원래 문자(이 글꼴 또는 대체 글꼴)가 사용됩니다. 대체 글꼴은 작은 대문자를 반환하지 않습니다. 예를 들어, 이 코드 조각::" #: ../../textwriter.rst:90 973003c33fe84aa69d42e2c43c861a09 msgid "will produce this PDF text:" msgstr "이 PDF 텍스트를 생성합니다:" #: ../../textwriter.rst 031973dcb92c46dfb30974b0b0277dbb #: 56067c1753344901a2a112d292086782 6fe2f7cc1d5b405588798ce1725db0d6 msgid "Returns" msgstr "반환값" #: ../../textwriter.rst:95 ../../textwriter.rst:111 #: 2916a5791a9446a1be47d9bdde016b5b 2d57d9c3e3404a1b8aaedf35dc4f6d7d msgid "" ":attr:`text_rect` and :attr:`last_point`. *(Changed in v1.18.0:)* Raises " "an exception for an unsupported font -- checked via " ":attr:`Font.is_writable`." msgstr ":attr:`text_rect` 및 :attr:`last_point`. *(v1.18.0에서 변경:)* 지원되지 않는 글꼴에 대해 예외를 발생시킵니다 -- :attr:`Font.is_writable` 을 통해 확인됩니다." #: ../../textwriter.rst:102 53cbfa2552fa46b2837c5848f6ae7eed msgid "Add some new text in vertical, top-to-bottom writing." msgstr "수직, 위에서 아래로 쓰기로 일부 새 텍스트를 추가합니다." #: ../../textwriter.rst:105 77e2561d4b4a448caf4a7b3ecbc624ce msgid "a string. It will be written starting at position \"pos\"." msgstr "문자열. \"pos\" 위치에서 시작하여 작성됩니다." #: ../../textwriter.rst:107 1195a41741cd44ca8653fce3a3c8b23f msgid "the :data:`fontsize`, a positive float, default 11." msgstr ":data:`fontsize`, 양수 부동 소수점, 기본값 11." #: ../../textwriter.rst:109 ../../textwriter.rst:133 #: 48cdfcdb373b4a939b9ac2491aaf9f76 a007fa3bc26e4925bac3b3884fa1d6f4 msgid "*(New in v1.18.15)* see :meth:`append`." msgstr "*(v1.18.15에서 새로 추가)* :meth:`append` 를 참조하세요." #: ../../textwriter.rst:115 131d2ddda39f47e5b8750ce4e02aacf1 msgid "" "Changed in 1.17.3: New parameter `pos` to specify where to start writing " "within rectangle." msgstr "1.17.3에서 변경: 사각형 내에서 쓰기를 시작할 위치를 지정하는 새 매개변수 `pos`." #: ../../textwriter.rst:116 29062b4cba8b458c9715b63563932eea msgid "" "Changed in v1.18.9: Return list of lines which do not fit in rectangle. " "Support writing right-to-left (e.g. Arabian, Hebrew)." msgstr "v1.18.9에서 변경: 사각형에 맞지 않는 줄 목록을 반환합니다. 오른쪽에서 왼쪽으로 쓰기 지원(예: 아랍어, 히브리어)." #: ../../textwriter.rst:117 1af15893d8c0406eaba47e8cbc605623 msgid "Changed in v1.18.15: Prefer small caps if supported by the font." msgstr "v1.18.15에서 변경: 글꼴에서 지원하는 경우 작은 대문자를 선호합니다." #: ../../textwriter.rst:119 557382b2514d472bbe73f5017c792395 msgid "" "Fill a given rectangle with text in horizontal writing mode. This is a " "convenience method to use as an alternative for :meth:`append`." msgstr "수평 쓰기 모드로 주어진 사각형을 텍스트로 채웁니다. 이는 :meth:`append` 의 대안으로 사용할 수 있는 편의 메서드입니다." #: ../../textwriter.rst:121 cef4e997c224414e95918704fa70b178 msgid "the area to fill. No part of the text will appear outside of this." msgstr "채울 영역. 텍스트의 어떤 부분도 이 영역 밖에 나타나지 않습니다." #: ../../textwriter.rst:122 eb9a1f87715c476190b440d505b21385 msgid "" "the text. Can be specified as a (UTF-8) string or a list / tuple of " "strings. A string will first be converted to a list using *splitlines()*." " Every list item will begin on a new line (forced line breaks)." msgstr "텍스트. (UTF-8) 문자열 또는 문자열의 리스트/튜플로 지정할 수 있습니다. 문자열은 먼저 *splitlines()* 를 사용하여 리스트로 변환됩니다. 각 리스트 항목은 새 줄에서 시작합니다(강제 줄바꿈)." #: ../../textwriter.rst:123 adaa607ca4b34119b1413a21aa5d5703 msgid "" "*(new in v1.17.3)* start storing at this point. Default is a point near " "rectangle top-left." msgstr "*(v1.17.3에서 새로 추가)* 이 지점에서 저장을 시작합니다. 기본값은 사각형 왼쪽 상단 근처의 점입니다." #: ../../textwriter.rst:124 093d30283065429a8003316402078989 msgid "the :ref:`Font`, default `pymupdf.Font(\"helv\")`." msgstr ":ref:`Font`, 기본값 `pymupdf.Font(\"helv\")`." #: ../../textwriter.rst:125 fa67844b1bdc4fd5b33c77ea89ae7619 msgid "the :data:`fontsize`." msgstr ":data:`fontsize`." #: ../../textwriter.rst:126 a3f0cf660cc34b2aa6461b460ccc9fd7 msgid "" "text alignment. Use one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, " "TEXT_ALIGN_RIGHT or TEXT_ALIGN_JUSTIFY." msgstr "텍스트 정렬. TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT 또는 TEXT_ALIGN_JUSTIFY 중 하나를 사용합니다." #: ../../textwriter.rst:127 fab2e37b003c4547a135db4871ab87f9 msgid "" "*(New in v1.18.9)* whether the text should be written from right to left." " Applicable for languages like Arabian or Hebrew. Default is ``False``. " "If ``True``, any Latin parts are automatically reverted. You must still " "set the alignment (if you want right alignment), it does not happen " "automatically -- the other alignment options remain available as well." msgstr "*(v1.18.9에서 새로 추가)* 텍스트를 오른쪽에서 왼쪽으로 작성할지 여부. 아랍어나 히브리어와 같은 언어에 적용됩니다. 기본값은 ``False`` 입니다. ``True`` 인 경우 모든 라틴 문자 부분이 자동으로 반전됩니다. 정렬(오른쪽 정렬을 원하는 경우)을 여전히 설정해야 하며, 자동으로 발생하지 않습니다 -- 다른 정렬 옵션도 계속 사용할 수 있습니다." #: ../../textwriter.rst:128 fbd4a0182852411d9c83784e6421be47 msgid "" "on text overflow do nothing, warn, or raise an exception. Overflow text " "will never be written. **Changed in v1.18.9:** * Default is ``None``. * " "The list of overflow lines will be returned." msgstr "" #: ../../textwriter.rst:128 0e6db582f2eb4eb28e4c2efbd9fb40e1 msgid "" "on text overflow do nothing, warn, or raise an exception. Overflow text " "will never be written. **Changed in v1.18.9:**" msgstr "텍스트 오버플로우 시 아무 작업도 하지 않거나 경고를 표시하거나 예외를 발생시킵니다. 오버플로우 텍스트는 절대 작성되지 않습니다. **v1.18.9에서 변경:**" #: ../../textwriter.rst:130 cdae6e2706854c9e826f849d936c11ee msgid "Default is ``None``." msgstr "기본값은 ``None`` 입니다." #: ../../textwriter.rst:131 1bda032411484b10b23479232b916047 msgid "The list of overflow lines will be returned." msgstr "오버플로우 줄 목록이 반환됩니다." #: ../../textwriter.rst 035f3f34d091461bbe3cc1d030bfe153 #: 1871d0ab981b44759c8973a335232ef3 6459020d5302480fb99a57af3fd39d02 #: 92e14712db2944b694cdf765796b471d d0a0b9758d76412fb2a1f68276a1f782 #: f3e6dee2f74245bfa95d18620e9bd73d msgid "Return type" msgstr "반환 유형" #: ../../textwriter.rst:136 396c812b4c0346d69cbc578eaae29744 msgid "" "*New in v1.18.9* -- List of lines that did not fit in the rectangle. Each" " item is a tuple `(text, length)` containing a string and its length (on " "the page)." msgstr "*v1.18.9에서 새로 추가* -- 사각형에 맞지 않는 줄 목록. 각 항목은 문자열과 그 길이(페이지에서)를 포함하는 튜플 `(text, length)` 입니다." #: ../../textwriter.rst:138 cd3a09fa82ee40e399e27a6aa0c1235d msgid "" "Use these methods as often as is required -- there is no technical limit " "(except memory constraints of your system). You can also mix " ":meth:`append` and text boxes and have multiple of both. Text positioning" " is exclusively controlled by the insertion point. Therefore there is no " "need to adhere to any order. *(Changed in v1.18.0:)* Raise an exception " "for an unsupported font -- checked via :attr:`Font.is_writable`." msgstr "필요한 만큼 자주 이 메서드를 사용하세요 -- 기술적 제한은 없습니다(시스템의 메모리 제약 제외). :meth:`append` 와 텍스트 상자를 혼합하고 둘 다 여러 개를 가질 수 있습니다. 텍스트 위치 지정은 삽입 지점에 의해서만 제어됩니다. 따라서 순서를 따를 필요가 없습니다. *(v1.18.0에서 변경:)* 지원되지 않는 글꼴에 대해 예외를 발생시킵니다 -- :attr:`Font.is_writable` 을 통해 확인됩니다." #: ../../textwriter.rst:143 54709b98b30a47ac89166f31faf2772a msgid "" "Write the TextWriter text to a page, which is the only mandatory " "parameter. The other parameters can be used to temporarily override the " "values used when the TextWriter was created." msgstr "TextWriter 텍스트를 페이지에 작성합니다. 이는 유일한 필수 매개변수입니다. 다른 매개변수는 TextWriter가 생성될 때 사용된 값을 임시로 재정의하는 데 사용할 수 있습니다." #: ../../textwriter.rst:145 59f4fdcbbc44452680ba4c0c95aa5cff msgid "write to this :ref:`Page`." msgstr "이 :ref:`Page` 에 작성합니다." #: ../../textwriter.rst:146 ../../textwriter.rst:147 #: 376b4dcec8264f3db2f6be76d778904b d45c4d5a07474ef4a0cd683fdd04bcdc msgid "override the value of the TextWriter for this output." msgstr "이 출력에 대해 TextWriter의 값을 재정의합니다." #: ../../textwriter.rst:148 ee07ac03480b41539d94053d359dd9d3 msgid "" "modify the text appearance by applying a matrix to it. If provided, this " "must be a sequence *(fixpoint, matrix)* with a point-like *fixpoint* and " "a matrix-like *matrix*. A typical example is rotating the text around " "*fixpoint*." msgstr "행렬을 적용하여 텍스트 모양을 수정합니다. 제공된 경우 이것은 점과 같은 *fixpoint* 와 행렬과 같은 *matrix* 를 가진 시퀀스 *(fixpoint, matrix)* 여야 합니다. 일반적인 예는 *fixpoint* 주위로 텍스트를 회전하는 것입니다." #: ../../textwriter.rst:149 b45dc013b8e740f9bef33593ed5c8711 msgid "put in foreground (default) or background." msgstr "전경(기본값) 또는 배경에 배치합니다." #: ../../textwriter.rst:150 ba9cfbd9695340699d7179b74412ef18 msgid "*(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`." msgstr "*(v1.18.4에서 새로 추가)* :data:`OCG` 또는 :data:`OCMD` 의 :data:`xref`." #: ../../textwriter.rst:151 9523549f48f246a3ae03b7bc5f901456 msgid "" "The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible). " ".. image:: images/img-rendermode.*" msgstr "" #: ../../textwriter.rst:151 78528b40a6544fe0a046dee8ae6857ef msgid "The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible)." msgstr "PDF `Tr` 연산자 값. 값: 0 (기본값), 1, 2, 3 (보이지 않음)." #: ../../textwriter.rst:158 525f73853e924927ad796c65943a368d msgid "The area currently occupied." msgstr "현재 차지하고 있는 영역." #: ../../textwriter.rst:160 ../../textwriter.rst:184 #: ba565ed25cdd42f7862fcb93e757cf70 be5a7d304fd0479ea3d522fa0b628537 msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../textwriter.rst:164 87ebb8ff55c24240abc1589af86e4a9a msgid "" "The \"cursor position\" -- a :ref:`Point` -- after the last written " "character (its bottom-right)." msgstr "\"커서 위치\" -- 마지막으로 작성된 문자(오른쪽 하단) 이후의 :ref:`Point`." #: ../../textwriter.rst:166 ac55d30024ef4851bc1e890d44698e93 msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../textwriter.rst:170 3f90c9a1dc4c4511a85d2dd1d614e275 msgid "The text opacity (modifiable)." msgstr "텍스트 투명도 (수정 가능)." #: ../../textwriter.rst:176 40b6c71ad92443f69b941e2ae68ef65d msgid "The text color (modifiable)." msgstr "텍스트 색상 (수정 가능)." #: ../../textwriter.rst:182 c8c0cc26dcc643b4b7a36449cc37508b msgid "" "The page rectangle for which this TextWriter was created. Must not be " "modified." msgstr "이 TextWriter가 생성된 페이지 사각형. 수정하면 안 됩니다." #: ../../textwriter.rst:187 96d56c1eedc9403da49260989a4dc7c5 msgid "" "To see some demo scripts dealing with TextWriter, have a look at `the " "TextWriter demo scripts `_." msgstr "TextWriter를 다루는 일부 데모 스크립트를 보려면 `TextWriter 데모 스크립트 `_ 를 참조하세요." #: ../../textwriter.rst:189 86f5ad85ef9f430798003667a5d4bba8 msgid "Opacity and color apply to **all the text** in this object." msgstr "투명도와 색상은 이 객체의 **모든 텍스트** 에 적용됩니다." #: ../../textwriter.rst:190 3fd56e7645674dd592624498a3b40033 msgid "" "If you need different colors / transparency, you must create a separate " "TextWriter. Whenever you determine the color should change, simply append" " the text to the respective TextWriter using the previously returned " ":attr:`last_point` as position for the new text span." msgstr "다른 색상/투명도가 필요한 경우 별도의 TextWriter를 생성해야 합니다. 색상이 변경되어야 한다고 판단할 때마다 이전에 반환된 :attr:`last_point` 를 새 텍스트 스팬의 위치로 사용하여 해당 TextWriter에 텍스트를 추가하세요." #: ../../textwriter.rst:191 473cca9e82e445e7a947ffeaead9f1d6 msgid "" "Appending items or text boxes can occur in arbitrary order: only the " "position parameter controls where text appears." msgstr "항목이나 텍스트 상자를 추가하는 것은 임의의 순서로 발생할 수 있습니다: 위치 매개변수만 텍스트가 나타나는 위치를 제어합니다." #: ../../textwriter.rst:192 e86c99a3e580410c80b33c1b9273d1e5 msgid "" "Font and :data:`fontsize` can freely vary within the same TextWriter. " "This can be used to let text with different properties appear on the same" " displayed line: just specify *pos* accordingly, and e.g. set it to " ":attr:`last_point` of the previously added item." msgstr "글꼴과 :data:`fontsize` 는 동일한 TextWriter 내에서 자유롭게 변경할 수 있습니다. 이를 사용하여 다른 속성을 가진 텍스트가 동일한 표시 줄에 나타나도록 할 수 있습니다: *pos* 를 그에 따라 지정하고, 예를 들어 이전에 추가된 항목의 :attr:`last_point` 로 설정하세요." #: ../../textwriter.rst:193 0dd912f04fa84ab7832bd944567f6dc1 msgid "" "You can use the *pos* argument of :meth:`TextWriter.fill_textbox` to set " "the position of the first text character. This allows filling the same " "textbox with contents from different :ref:`TextWriter` objects, thus " "allowing for multiple colors, opacities, etc." msgstr ":meth:`TextWriter.fill_textbox` 의 *pos* 인수를 사용하여 첫 번째 텍스트 문자의 위치를 설정할 수 있습니다. 이를 통해 다른 :ref:`TextWriter` 객체의 콘텐츠로 동일한 텍스트 상자를 채울 수 있으므로 여러 색상, 투명도 등을 허용합니다." #: ../../textwriter.rst:194 46ddcc45b9594214860870dcb571f619 msgid "" "MuPDF does not support all fonts with this feature, e.g. no Type3 fonts. " "Starting with v1.18.0 this can be checked via the font attribute " ":attr:`Font.is_writable`. This attribute is also checked when using " ":ref:`TextWriter` methods." msgstr "|MuPDF| 는 이 기능으로 모든 글꼴을 지원하지 않습니다. 예를 들어 Type3 글꼴은 지원하지 않습니다. v1.18.0부터는 글꼴 속성 :attr:`Font.is_writable` 을 통해 이를 확인할 수 있습니다. 이 속성은 :ref:`TextWriter` 메서드를 사용할 때도 확인됩니다." #: ../../footer.rst:46 b6d5682a116d45b9b5a6850c9cfd6f9e msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/the-basics.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 909f9969c815483692de0eeae2b2c6b8 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 7c546c172c3049238925a5d3d154deac msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 d775abfe51ed4aae97e87841af09650c msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../the-basics.rst:8 b573d287df3a4994ab9fc76c334671ff msgid "The Basics" msgstr "기초" #: ../../the-basics.rst:13 f7ad136a192c476f8006b215bda74aeb msgid "Opening a File" msgstr "파일 열기" #: ../../the-basics.rst:16 02f1cd284e354ff99efcff59db44a1d3 msgid "To open a file, do the following:" msgstr "파일을 열려면 다음을 수행합니다:" #: ../../the-basics.rst:27 ../../the-basics.rst:58 ../../the-basics.rst:119 #: ../../the-basics.rst:149 ../../the-basics.rst:199 ../../the-basics.rst:249 #: ../../the-basics.rst:287 ../../the-basics.rst:377 ../../the-basics.rst:416 #: ../../the-basics.rst:465 ../../the-basics.rst:551 ../../the-basics.rst:636 #: ../../the-basics.rst:692 ../../the-basics.rst:884 ../../the-basics.rst:1068 #: 0068950bcad54023968e3f762f5f517f 05774a0919aa4c5c9c36f6bac5d452ef #: 0e7e23d4b7bc416cae884504c277d711 1225e0c609dc479ca2f4b881424a32ac #: 2222ebbac6364d5b9b08e76451ddf9a1 47f2b0f15354473b88fd164c09ab6f50 #: 4830de8bf34d47e6a2ffef8fe914a53f 7efa68f16195464b9faadc6def36171f #: 86a29e64e6a24ade8a8ac4da891c7f28 8daf9faca165448ba7a882a6b2cdb4e2 #: 9f4f8da64538439287fec0bfd34094c4 b84230e6f2734b0b8af4a50458974ebf #: d5c2e1f3166846bf85914a88c378cfc2 da8824eb7edf4d73aa56dc95df1dd1d1 #: f53b94d6fdab4636b68a2e80cfc9f035 msgid "**Taking it further**" msgstr "**더 알아보기**" #: ../../the-basics.rst:29 89354d4f696a4471b78c43ab5c2a5c2a msgid "" "See the :ref:`list of supported file types` and " ":ref:`The How to Guide on Opening Files ` for more " "advanced options." msgstr "더 고급 옵션은 :ref:`지원되는 파일 타입 목록` 및 :ref:`파일 열기 방법 가이드 ` 를 참조하세요." #: ../../the-basics.rst:38 5cac62e394ac45989dbc0d2e8dd159be msgid "Extract text from a |PDF|" msgstr "|PDF| 에서 텍스트 추출" #: ../../the-basics.rst:40 a0d1eb5ca0da4ab8951f1b2b8623289d msgid "To extract all the text from a |PDF| file, do the following:" msgstr "|PDF| 파일에서 모든 텍스트를 추출하려면 다음을 수행합니다:" #: ../../the-basics.rst:54 883a6098a76f43d1a5ac736b2cce28a8 msgid "" "Of course it is not just |PDF| which can have text extracted - all the " ":ref:`supported document file formats ` such as " ":title:`MOBI`, :title:`EPUB`, :title:`TXT` can have their text extracted." msgstr "물론 텍스트를 추출할 수 있는 것은 |PDF| 만이 아닙니다 - :ref:`지원되는 문서 파일 형식 ` (예: :title:`MOBI`, :title:`EPUB`, :title:`TXT`) 모두에서 텍스트를 추출할 수 있습니다." #: ../../the-basics.rst:60 20545bb8acee4ab784b06e10f8f6c531 msgid "" "If your document contains image based text content the use OCR on the " "page for subsequent text extraction:" msgstr "문서에 이미지 기반 텍스트 콘텐츠가 포함된 경우 후속 텍스트 추출을 위해 페이지에서 OCR을 사용합니다:" #: ../../the-basics.rst:67 ../../the-basics.rst:121 #: a3622ac2d3a8426eb4bf51fd86910cc2 e6467ed2be7e4603bb2d779b91c7f5b3 msgid "" "There are many more examples which explain how to extract text from " "specific areas or how to extract tables from documents. Please refer to " "the :ref:`How to Guide for Text`." msgstr "특정 영역에서 텍스트를 추출하거나 문서에서 테이블을 추출하는 방법을 설명하는 더 많은 예제가 있습니다. :ref:`텍스트 가이드 ` 를 참조하세요." #: ../../the-basics.rst:69 707cbcbf6a784fb39564f16a7e3dc032 msgid "" "You can now also :ref:`extract text in Markdown " "format`." msgstr "이제 :ref:`Markdown 형식으로 텍스트 추출 ` 도 할 수 있습니다." #: ../../the-basics.rst:71 ../../the-basics.rst:123 ../../the-basics.rst:153 #: ../../the-basics.rst:208 ../../the-basics.rst:255 ../../the-basics.rst:291 #: ../../the-basics.rst:318 ../../the-basics.rst:343 ../../the-basics.rst:383 #: ../../the-basics.rst:420 ../../the-basics.rst:472 ../../the-basics.rst:498 #: ../../the-basics.rst:525 ../../the-basics.rst:606 ../../the-basics.rst:657 #: ../../the-basics.rst:696 ../../the-basics.rst:760 ../../the-basics.rst:819 #: ../../the-basics.rst:896 ../../the-basics.rst:926 ../../the-basics.rst:962 #: ../../the-basics.rst:988 ../../the-basics.rst:1072 #: 07855b8e74cf474bb2c22f4ea1486b77 14463d4aca01470b9aeb4b607b17f5c9 #: 1c3978a5519a4d36b5e656a91c01ecdf 2c0ea7a221bc482c9799c3a352cb1eb9 #: 5c80f9f1865449309e09d88d691bb68a 5efa802d04ed4ed89cd05d92421170f6 #: 67c48e5b292f4e9b9dd54a97ff4accf5 890c419a3008426abe76d049f182b2f8 #: 89defd51bf04459e9d7361784de9c261 8fd41167904a409080c488f71c5f60e3 #: 97e7e736a10449a9bb80fe64abc4572d 9a7f26aa2f0a4af2aefe5dbe1f4bd77f #: a017d665ee0942bc950c27a6f1261a1d a3129d1fc34c489dbce01f464dab1fec #: a42c9f54e3c1452ba53a839adc35e52c bda2261d0d2e4a559d33aa934c6fc244 #: bda7623fd6574e8a9c992679676465a3 c499bd5e8117498eb20b5ad1d95592b0 #: cce4af742f274d3096ca85a76a595aba d7b4b9ff758e46f99007f97eb4ff95c7 #: dbcf27434c3f43c1850b747a56c81c6d e9ad6ac85a8243b7837a2ba0a008093e #: fe8941aaa58649e6b9bbe06143ba9fa4 msgid "**API reference**" msgstr "**API 참조**" #: ../../the-basics.rst:73 b7bf2d8223824a34a302b49fe4ee31fb msgid ":meth:`Page.get_text`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:85 9ada4b1ef4a24e7493857603dcd93d75 msgid "Extract images from a |PDF|" msgstr "|PDF| 에서 이미지 추출" #: ../../the-basics.rst:87 5ed12b425f01418ba06929d7c6d08a32 msgid "To extract all the images from a |PDF| file, do the following:" msgstr "|PDF| 파일에서 모든 이미지를 추출하려면 다음을 수행합니다:" #: ../../the-basics.rst:125 b8190e106cd745da99ebfa71d6dc7550 msgid ":meth:`Page.get_images`" msgstr ":meth:`Page.get_images`" #: ../../the-basics.rst:126 a75e43c33c564cf6a23b07e3f3d7b4f3 msgid ":ref:`Pixmap`" msgstr ":ref:`Pixmap`" #: ../../the-basics.rst:133 6faa94d7643a453791a62048e151e9f6 msgid "Extract vector graphics" msgstr "벡터 그래픽 추출" #: ../../the-basics.rst:135 4f09604cb7f64a9f8e72293ed907ad38 msgid "To extract all the vector graphics from a document page, do the following:" msgstr "문서 페이지에서 모든 벡터 그래픽을 추출하려면 다음을 수행합니다:" #: ../../the-basics.rst:145 2a5a383743524b57b81c68a8b6342599 msgid "" "This will return a dictionary of paths for any vector drawings found on " "the page." msgstr "이것은 페이지에서 발견된 모든 벡터 그림에 대한 경로 딕셔너리를 반환합니다." #: ../../the-basics.rst:151 225e28d931034158a41317ebaea841d5 msgid "" "Please refer to: :ref:`How to Extract " "Drawings`." msgstr ":ref:`그림 추출 방법 ` 를 참조하세요." #: ../../the-basics.rst:155 6f4863d999e44206b34be29b3deb363e msgid ":meth:`Page.get_drawings`" msgstr ":meth:`Page.get_drawings`" #: ../../the-basics.rst:166 810da3e647c342ef9dc50496dad28ba4 msgid "Merging |PDF| files" msgstr "|PDF| 파일 병합" #: ../../the-basics.rst:168 f5160b79b89244d8a6045b6cbdd53e39 msgid "To merge |PDF| files, do the following:" msgstr "|PDF| 파일을 병합하려면 다음을 수행합니다:" #: ../../the-basics.rst:182 fdc9cd0b81044db2822c364c5561f18d msgid "Merging |PDF| files with other types of file" msgstr "다른 타입의 파일과 |PDF| 파일 병합" #: ../../the-basics.rst:184 44edda88e0bb4b66bb4b3f4271487f7b msgid "" "With :meth:`Document.insert_file` you can invoke the method to merge " ":ref:`supported files` with |PDF|. For example:" msgstr ":meth:`Document.insert_file` 메서드를 사용하여 :ref:`지원되는 파일` 을 |PDF| 와 병합할 수 있습니다. 예:" #: ../../the-basics.rst:201 af6d68b7867f4c02b0b25a870eb70be1 msgid "" "It is easy to join PDFs with :meth:`Document.insert_pdf` & " ":meth:`Document.insert_file`. Given open |PDF| documents, you can copy " "page ranges from one to the other. You can select the point where the " "copied pages should be placed, you can revert the page sequence and also " "change page rotation." msgstr ":meth:`Document.insert_pdf` 및 :meth:`Document.insert_file` 로 PDF를 쉽게 결합할 수 있습니다. 열린 |PDF| 문서가 주어지면 한 문서에서 다른 문서로 페이지 범위를 복사할 수 있습니다. 복사된 페이지가 배치될 지점을 선택하고, 페이지 순서를 되돌리고, 페이지 회전을 변경할 수도 있습니다." #: ../../the-basics.rst:203 8c29c60b2e3944278d03602d769f8c7c msgid "" "The GUI script `join.py `_ uses this method" " to join a list of files while also joining the respective table of " "contents segments. It looks like this:" msgstr "GUI 스크립트 `join.py `_ 는 이 메서드를 사용하여 파일 목록을 결합하면서 각 목차 세그먼트도 결합합니다. 다음과 같습니다:" #: ../../the-basics.rst:210 dfc7e6e8e50b40d19288f88e51710867 msgid ":meth:`Document.insert_pdf`" msgstr ":meth:`Document.insert_pdf`" #: ../../the-basics.rst:211 3c85c393fc9a47d1a1f4d4bd44f71f7d msgid ":meth:`Document.insert_file`" msgstr ":meth:`Document.insert_file`" #: ../../the-basics.rst:218 5374c164503d49308ea222d3f1f4ac68 msgid "Working with Coordinates" msgstr "좌표 작업" #: ../../the-basics.rst:220 32ef87567fbf4591aa33613a467efc43 msgid "" "There is one *mathematical term* that you should feel comfortable with " "when using |PyMuPDF| - **\"coordinates\"**. Please have a quick look at " "the :ref:`Coordinates` section to understand the coordinate system to " "help you with positioning objects and understand your document space." msgstr "|PyMuPDF| 를 사용할 때 익숙해야 할 *수학 용어* 가 하나 있습니다 - **\"좌표\"** 입니다. 객체를 배치하고 문서 공간을 이해하는 데 도움이 되도록 좌표계를 이해하기 위해 :ref:`Coordinates` 섹션을 빠르게 살펴보세요." #: ../../the-basics.rst:229 808c51c176874e4f8e4f561f56a7e050 msgid "Adding a watermark to a |PDF|" msgstr "|PDF| 에 워터마크 추가" #: ../../the-basics.rst:231 e3bd1bcc59dd4871843542cffb69e4d9 msgid "To add a watermark to a |PDF| file, do the following:" msgstr "|PDF| 파일에 워터마크를 추가하려면 다음을 수행합니다:" #: ../../the-basics.rst:251 a02e5eacf1034f0fae2054ffe20904e8 msgid "" "Adding watermarks is essentially as simple as adding an image at the base" " of each |PDF| page. You should ensure that the image has the required " "opacity and aspect ratio to make it look the way you need it to." msgstr "워터마크 추가는 기본적으로 각 |PDF| 페이지 하단에 이미지를 추가하는 것만큼 간단합니다. 필요한 불투명도와 종횡비를 갖도록 이미지를 확인해야 합니다." #: ../../the-basics.rst:253 d20d708a49884eba9914d117e2f10133 msgid "" "In the example above a new image is created from each file reference, but" " to be more performant (by saving memory and file size) this image data " "should be referenced only once - see the code example and explanation on " ":meth:`Page.insert_image` for the implementation." msgstr "위 예제에서는 각 파일 참조에서 새 이미지가 생성되지만, 더 성능을 높이려면(메모리와 파일 크기를 절약하기 위해) 이 이미지 데이터는 한 번만 참조해야 합니다 - 구현에 대한 코드 예제 및 설명은 :meth:`Page.insert_image` 를 참조하세요." #: ../../the-basics.rst:257 3d33f6e4d88f4ad0934fe5db402cbd31 msgid ":meth:`Page.bound`" msgstr ":meth:`Page.bound`" #: ../../the-basics.rst:258 ../../the-basics.rst:294 #: 289513e33a19434b93565b65bb3c2d5c fe5190d74fae437cbe633bd7b771d7ef msgid ":meth:`Page.insert_image`" msgstr ":meth:`Page.insert_image`" #: ../../the-basics.rst:267 13c93c134b884caa94bdb24bcf268c12 msgid "Adding an image to a |PDF|" msgstr "|PDF| 에 이미지 추가" #: ../../the-basics.rst:269 4c1ed375c4bf445fbb7cbc313de62c6d msgid "To add an image to a |PDF| file, for example a logo, do the following:" msgstr "|PDF| 파일에 이미지(예: 로고)를 추가하려면 다음을 수행합니다:" #: ../../the-basics.rst:289 de096300347c4213ba1adacf5f0db3f9 msgid "" "As with the watermark example you should ensure to be more performant by " "only referencing the image once if possible - see the code example and " "explanation on :meth:`Page.insert_image`." msgstr "워터마크 예제와 마찬가지로 가능한 경우 이미지를 한 번만 참조하여 성능을 높이도록 해야 합니다 - 코드 예제 및 설명은 :meth:`Page.insert_image` 를 참조하세요." #: ../../the-basics.rst:293 8945f4f902264ba6b1269f807ddfd71e msgid ":ref:`Rect`" msgstr ":ref:`Rect`" #: ../../the-basics.rst:303 71949133fcb94c6f98465813be0eb404 msgid "Rotating a |PDF|" msgstr "|PDF| 회전" #: ../../the-basics.rst:305 7e3ebb344a7348c2bf946c4795d74d92 msgid "To add a rotation to a page, do the following:" msgstr "페이지에 회전을 추가하려면 다음을 수행합니다:" #: ../../the-basics.rst:320 3d4e339ae052429bb76f09916c436436 msgid ":meth:`Page.set_rotation`" msgstr ":meth:`Page.set_rotation`" #: ../../the-basics.rst:328 6e2d701fd5f047cda7216925fec76fc7 msgid "Cropping a |PDF|" msgstr "|PDF| 자르기" #: ../../the-basics.rst:330 b7c23f5face54c169824a13ca7b42f15 msgid "To crop a page to a defined :ref:`Rect`, do the following:" msgstr "페이지를 정의된 :ref:`Rect` 로 자르려면 다음을 수행합니다:" #: ../../the-basics.rst:345 a6b1cd0d8cad41189d7c67fabc5f334b msgid ":meth:`Page.set_cropbox`" msgstr ":meth:`Page.set_cropbox`" #: ../../the-basics.rst:354 d575dbec6b32487f8b9cf82c6e30d10c msgid ":index:`Attaching Files `" msgstr ":index:`파일 첨부 `" #: ../../the-basics.rst:356 c9c54ff0348c471ead7ff5c1018b7d28 msgid "To attach another file to a page, do the following:" msgstr "페이지에 다른 파일을 첨부하려면 다음을 수행합니다:" #: ../../the-basics.rst:379 3314a0f701fc46868da9fe2bf79bdca5 msgid "" "When adding the file with :meth:`Page.add_file_annot` note that the third" " parameter for the `filename` should include the actual file extension. " "Without this the attachment possibly will not be able to be recognized as" " being something which can be opened. For example, if the `filename` is " "just *\"attachment\"* when view the resulting PDF and attempting to open " "the attachment you may well get an error. However, with " "*\"attachment.pdf\"* this can be recognized and opened by PDF viewers as " "a valid file type." msgstr ":meth:`Page.add_file_annot` 로 파일을 추가할 때 `filename` 의 세 번째 매개변수에는 실제 파일 확장자가 포함되어야 합니다. 이것이 없으면 첨부 파일이 열 수 있는 것으로 인식되지 않을 수 있습니다. 예를 들어, `filename` 이 단순히 *\"attachment\"* 인 경우 결과 PDF를 보고 첨부 파일을 열려고 하면 오류가 발생할 수 있습니다. 그러나 *\"attachment.pdf\"* 인 경우 PDF 뷰어에서 유효한 파일 타입으로 인식하고 열 수 있습니다." #: ../../the-basics.rst:381 b376de22c21a4a678e98898f240e4e68 msgid "" "The default icon for the attachment is by default a \"push pin\", however" " you can change this by setting the `icon` parameter." msgstr "첨부 파일의 기본 아이콘은 기본적으로 \"push pin\" 이지만, `icon` 매개변수를 설정하여 변경할 수 있습니다." #: ../../the-basics.rst:385 ddad44834e324cef9b0c5a12b15fb49e msgid ":ref:`Point`" msgstr ":ref:`Point`" #: ../../the-basics.rst:386 ../../the-basics.rst:422 #: b75a50b64e26476e944aa8754f20bf2f f27fcc6d362c42cda221464725dea5af msgid ":meth:`Document.tobytes`" msgstr ":meth:`Document.tobytes`" #: ../../the-basics.rst:387 0a0ed0f4324040aa8e444b4b4434a966 msgid ":meth:`Page.add_file_annot`" msgstr ":meth:`Page.add_file_annot`" #: ../../the-basics.rst:396 2c6b15690e394abebe55eb54a8f0e9b4 msgid ":index:`Embedding Files `" msgstr ":index:`파일 임베드 `" #: ../../the-basics.rst:398 566061a4f08642cf8ce04c7d8822cfb5 msgid "To embed a file to a document, do the following:" msgstr "문서에 파일을 임베드하려면 다음을 수행합니다:" #: ../../the-basics.rst:418 c7fc5f4b49a94065be458d831ec56a8d msgid "" "As with :ref:`attaching files`, when adding " "the file with :meth:`Document.embfile_add` note that the first parameter " "for the `filename` should include the actual file extension." msgstr ":ref:`파일 첨부` 와 마찬가지로 :meth:`Document.embfile_add` 로 파일을 추가할 때 `filename` 의 첫 번째 매개변수에는 실제 파일 확장자가 포함되어야 합니다." #: ../../the-basics.rst:423 e86602ef585c432bab7857de813ba158 msgid ":meth:`Document.embfile_add`" msgstr ":meth:`Document.embfile_add`" #: ../../the-basics.rst:433 1dadf897eed34352b65305be6227cc68 msgid "Deleting Pages" msgstr "페이지 삭제" #: ../../the-basics.rst:435 b2ec142ee4284464bac65150b104a3c8 msgid "To delete a page from a document, do the following:" msgstr "문서에서 페이지를 삭제하려면 다음을 수행합니다:" #: ../../the-basics.rst:445 26bcb9712b45488d81fcd37a2c5338dc msgid "To delete a multiple pages from a document, do the following:" msgstr "문서에서 여러 페이지를 삭제하려면 다음을 수행합니다:" #: ../../the-basics.rst:457 2a651424c7104dda8fccdeb738d8f3d4 msgid "What happens if I delete a page referred to by bookmarks or hyperlinks?" msgstr "책갈피나 하이퍼링크가 참조하는 페이지를 삭제하면 어떻게 되나요?" #: ../../the-basics.rst:459 268000ef67c644459cb4d5f0f21c3a0f msgid "" "A bookmark (entry in the Table of Contents) will become inactive and will" " no longer navigate to any page." msgstr "책갈피(목차 항목)는 비활성화되어 더 이상 어떤 페이지로도 이동하지 않습니다." #: ../../the-basics.rst:461 c9da611cc8bd48d69c43c3418cd4dba8 msgid "" "A hyperlink will be removed from the page that contains it. The visible " "content on that page will not otherwise be changed in any way." msgstr "하이퍼링크는 포함된 페이지에서 제거됩니다. 해당 페이지의 표시된 콘텐츠는 다른 방식으로 변경되지 않습니다." #: ../../the-basics.rst:467 691f875a941741d08cb1049a5fd7fea0 msgid "" "The page index is zero-based, so to delete page 10 of a document you " "would do the following `doc.delete_page(9)`." msgstr "페이지 인덱스는 0 기반이므로 문서의 10페이지를 삭제하려면 `doc.delete_page(9)` 를 수행합니다." #: ../../the-basics.rst:469 471029bcec864d5c83b56258d14c9a6b msgid "" "Similarly, `doc.delete_pages(from_page=9, to_page=14)` will delete pages " "10 - 15 inclusive." msgstr "마찬가지로 `doc.delete_pages(from_page=9, to_page=14)` 는 10-15페이지를 포함하여 삭제합니다." #: ../../the-basics.rst:474 a6edabe8375f47aab6ecea141c9de9ef msgid ":meth:`Document.delete_page`" msgstr ":meth:`Document.delete_page`" #: ../../the-basics.rst:475 dc08fba2f443449d9604c358be0f59b2 msgid ":meth:`Document.delete_pages`" msgstr ":meth:`Document.delete_pages`" #: ../../the-basics.rst:483 94049f92c8ad4d6b8b0024d436ab9235 msgid "Re-Arranging Pages" msgstr "페이지 재배열" #: ../../the-basics.rst:485 82cc8c6d56974119a12c0c709d30c2d0 msgid "To change the sequence of pages, i.e. re-arrange pages, do the following:" msgstr "페이지 순서를 변경하려면(즉, 페이지를 재배열하려면) 다음을 수행합니다:" #: ../../the-basics.rst:500 4c1a980fdd2442ae896528a2b043b4d7 msgid ":meth:`Document.move_page`" msgstr ":meth:`Document.move_page`" #: ../../the-basics.rst:509 1b6a6d6430b64d2fa81c618aa5a36c2a msgid "Copying Pages" msgstr "페이지 복사" #: ../../the-basics.rst:512 703c6c326a244e3f95a5f9308a4db9f8 msgid "To copy pages, do the following:" msgstr "페이지를 복사하려면 다음을 수행합니다:" #: ../../the-basics.rst:527 e0f411a53f464a6cb29477e745869390 msgid ":meth:`Document.copy_page`" msgstr ":meth:`Document.copy_page`" #: ../../the-basics.rst:535 3f3ac486797b4e59a03d43dfd13d0ae9 msgid "Selecting Pages" msgstr "페이지 선택" #: ../../the-basics.rst:538 c5e43d6789904283afdfc2c3e31f4b3e msgid "To select pages, do the following:" msgstr "페이지를 선택하려면 다음을 수행합니다:" #: ../../the-basics.rst:553 0c1c3c72d9c542d5a9fd994ca426390d msgid "" "With |PyMuPDF| you have all options to copy, move, delete or re-arrange " "the pages of a |PDF|. Intuitive methods exist that allow you to do this " "on a page-by-page level, like the :meth:`Document.copy_page` method." msgstr "|PyMuPDF| 를 사용하면 |PDF| 의 페이지를 복사, 이동, 삭제 또는 재배열할 수 있는 모든 옵션이 있습니다. :meth:`Document.copy_page` 메서드와 같이 페이지별로 수행할 수 있는 직관적인 메서드가 있습니다." #: ../../the-basics.rst:555 99b4ed9af68646628e27f7fd50ed6026 msgid "" "Or you alternatively prepare a complete new page layout in form of a " ":title:`Python` sequence, that contains the page numbers you want, in the" " sequence you want, and as many times as you want each page. The " "following may illustrate what can be done with :meth:`Document.select`" msgstr "또는 원하는 페이지 번호를 원하는 순서로, 각 페이지를 원하는 횟수만큼 포함하는 :title:`Python` 시퀀스 형식으로 완전히 새로운 페이지 레이아웃을 준비할 수도 있습니다. 다음은 :meth:`Document.select` 로 수행할 수 있는 작업을 보여줍니다" #: ../../the-basics.rst:562 6807a098f55f41e08049ad773d010494 msgid "" "Now let's prepare a PDF for double-sided printing (on a printer not " "directly supporting this):" msgstr "이제 양면 인쇄를 위한 PDF를 준비하겠습니다(이를 직접 지원하지 않는 프린터에서):" #: ../../the-basics.rst:564 2bd6434b882a4d8db3c304ffbd3aa687 msgid "" "The number of pages is given by `len(doc)` (equal to `doc.page_count`). " "The following lists represent the even and the odd page numbers, " "respectively:" msgstr "페이지 수는 `len(doc)` (또는 `doc.page_count` 와 동일)로 제공됩니다. 다음 목록은 각각 짝수 및 홀수 페이지 번호를 나타냅니다:" #: ../../the-basics.rst:571 293d86f017734a8ebc3c3f116fd93ed9 msgid "" "This snippet creates the respective sub documents which can then be used " "to print the document:" msgstr "이 코드 조각은 문서를 인쇄하는 데 사용할 수 있는 각 하위 문서를 생성합니다:" #: ../../the-basics.rst:583 7c03acb1833d4a7e835b8d14d71d52a1 msgid "" "For more information also have a look at this Wiki `article " "`_." msgstr "자세한 내용은 이 Wiki `문서 `_ 도 참조하세요." #: ../../the-basics.rst:586 54ec68649c0e4b609bbc4f4ad4e005cb msgid "" "The following example will reverse the order of all pages (**extremely " "fast:** sub-second time for the 756 pages of the :ref:`AdobeManual`):" msgstr "다음 예제는 모든 페이지의 순서를 반대로 합니다(**매우 빠름:** :ref:`AdobeManual` 의 756페이지에 대해 1초 미만):" #: ../../the-basics.rst:596 bb40e1408cac4faa8820273561325390 msgid "" "This snippet duplicates the PDF with itself so that it will contain the " "pages *0, 1, ..., n, 0, 1, ..., n* **(extremely fast and without " "noticeably increasing the file size!)**:" msgstr "이 코드 조각은 PDF를 자체와 중복시켜 *0, 1, ..., n, 0, 1, ..., n* 페이지를 포함하도록 합니다**(매우 빠르고 파일 크기가 눈에 띄게 증가하지 않음!)**" #: ../../the-basics.rst:608 2c346b1ac6fe452d96ab804a995e9039 msgid ":meth:`Document.select`" msgstr ":meth:`Document.select`" #: ../../the-basics.rst:619 0c4e94066fe44ad499c54211fe16aae6 msgid "Adding Blank Pages" msgstr "빈 페이지 추가" #: ../../the-basics.rst:621 b2cff0e96799476d884ceb9a27a0a394 msgid "To add a blank page, do the following:" msgstr "빈 페이지를 추가하려면 다음을 수행합니다:" #: ../../the-basics.rst:638 ce36fc6b536c46d4b1f018b19e714a4d msgid "Use this to create the page with another pre-defined paper format:" msgstr "다른 사전 정의된 용지 형식으로 페이지를 만들려면 다음을 사용합니다:" #: ../../the-basics.rst:646 7d2dc00bc025437295e6e7ac8de51e61 msgid "" "The convenience function :meth:`paper_size` knows over 40 industry " "standard paper formats to choose from. To see them, inspect dictionary " ":attr:`paperSizes`. Pass the desired dictionary key to :meth:`paper_size`" " to retrieve the paper dimensions. Upper and lower case is supported. If " "you append \"-L\" to the format name, the landscape version is returned." msgstr "편의 함수 :meth:`paper_size` 는 선택할 수 있는 40개 이상의 산업 표준 용지 형식을 알고 있습니다. 이를 보려면 딕셔너리 :attr:`paperSizes` 를 검사하세요. 원하는 딕셔너리 키를 :meth:`paper_size` 에 전달하여 용지 크기를 검색합니다. 대소문자가 지원됩니다. 형식 이름에 \"-L\" 을 추가하면 가로 방향 버전이 반환됩니다." #: ../../the-basics.rst:648 b44282f4ada544d1b18a337f793bbdfb msgid "" "Here is a 3-liner that creates a |PDF|: with one empty page. Its file " "size is 460 bytes:" msgstr "다음은 빈 페이지 하나가 있는 |PDF| 를 생성하는 3줄 코드입니다. 파일 크기는 460바이트입니다:" #: ../../the-basics.rst:659 af312c05560c44ba8fb88cf29ece1e12 msgid ":meth:`Document.new_page`" msgstr ":meth:`Document.new_page`" #: ../../the-basics.rst:660 055ca7bfd52e46bda58c8e862bd8e592 msgid ":attr:`paperSizes`" msgstr ":attr:`paperSizes`" #: ../../the-basics.rst:669 6ec80ca2c8344ab1b10072ee1e7ecfdf msgid "Inserting Pages with Text Content" msgstr "텍스트 콘텐츠가 있는 페이지 삽입" #: ../../the-basics.rst:671 7c9a1501fb5d405a9f5ad46a99f0b474 msgid "" "Using the :meth:`Document.insert_page` method also inserts a new page and" " accepts the same ``width`` and ``height`` parameters. But it lets you " "also insert arbitrary text into the new page and returns the number of " "inserted lines." msgstr ":meth:`Document.insert_page` 메서드를 사용하면 새 페이지도 삽입되고 동일한 `width` 및 `height` 매개변수를 허용합니다. 하지만 새 페이지에 임의의 텍스트를 삽입할 수 있으며 삽입된 줄 수를 반환합니다." #: ../../the-basics.rst:694 815fd32c08dc43ed939c0022fe0cb355 msgid "" "The text parameter can be a (sequence of) string (assuming UTF-8 " "encoding). Insertion will start at :ref:`Point` (50, 72), which is one " "inch below top of page and 50 points from the left. The number of " "inserted text lines is returned." msgstr "텍스트 매개변수는 문자열(또는 문자열 시퀀스)일 수 있습니다(UTF-8 인코딩 가정). 삽입은 :ref:`Point` (50, 72)에서 시작되며, 이는 페이지 상단에서 1인치 아래, 왼쪽에서 50포인트입니다. 삽입된 텍스트 줄 수가 반환됩니다." #: ../../the-basics.rst:698 ee1877c30f20440d928f255b6b27ec30 msgid ":meth:`Document.insert_page`" msgstr ":meth:`Document.insert_page`" #: ../../the-basics.rst:709 3399cdc8dfc44101b644bcf9d0619529 msgid "Splitting Single Pages" msgstr "단일 페이지 분할" #: ../../the-basics.rst:711 1f3717fc854a40d5a0fd9753b49a88a0 msgid "" "This deals with splitting up pages of a |PDF| in arbitrary pieces. For " "example, you may have a |PDF| with *Letter* format pages which you want " "to print with a magnification factor of four: each page is split up in 4 " "pieces which each going to a separate |PDF| page in *Letter* format " "again." msgstr "이것은 |PDF| 의 페이지를 임의의 조각으로 분할하는 것을 다룹니다. 예를 들어, 4배 확대 인쇄하려는 *Letter* 형식 페이지가 있는 |PDF| 가 있을 수 있습니다: 각 페이지는 4개 조각으로 분할되며, 각 조각은 다시 *Letter* 형식의 별도 |PDF| 페이지로 이동합니다." #: ../../the-basics.rst:754 ../../the-basics.rst:812 #: 0ece8212e7b845609bb12d9e90ea10a7 e15f29ebe62e4a60a0bbbb8de5608f21 msgid "Example:" msgstr "예제:" #: ../../the-basics.rst:762 ../../the-basics.rst:821 #: aca3faccb4c045c097b9959629642eef b75fa5b0807b4f56bffef5b96e756cdd msgid ":meth:`Page.cropbox_position`" msgstr ":meth:`Page.cropbox_position`" #: ../../the-basics.rst:763 ../../the-basics.rst:822 #: 0ffa92661611435b91fb6a7e14df8701 2322a38c63f947d589e9b2ec7f1f17f2 msgid ":meth:`Page.show_pdf_page`" msgstr ":meth:`Page.show_pdf_page`" #: ../../the-basics.rst:773 e866676a9e9f4db28f98f0921db8b45f msgid "Combining Single Pages" msgstr "단일 페이지 결합" #: ../../the-basics.rst:775 66702d857bfe496f8bd6f6120c0c5137 msgid "" "This deals with joining |PDF| pages to form a new |PDF| with pages each " "combining two or four original ones (also called \"2-up\", \"4-up\", " "etc.). This could be used to create booklets or thumbnail-like overviews." msgstr "이것은 |PDF| 페이지를 결합하여 원본 두 개 또는 네 개를 각각 결합한 페이지가 있는 새 |PDF| 를 만드는 것을 다룹니다(\"2-up\", \"4-up\" 등이라고도 함). 이것은 소책자나 썸네일 같은 개요를 만드는 데 사용할 수 있습니다." #: ../../the-basics.rst:831 dd61fd34be574893bee88166ee3d19f3 msgid "|PDF| Encryption & Decryption" msgstr "|PDF| 암호화 및 복호화" #: ../../the-basics.rst:834 16ea9b1cd9f949fdab48b3c4210a4d72 msgid "" "Starting with version 1.16.0, |PDF| decryption and encryption (using " "passwords) are fully supported. You can do the following:" msgstr "버전 1.16.0부터 |PDF| 복호화 및 암호화(비밀번호 사용)가 완전히 지원됩니다. 다음을 수행할 수 있습니다:" #: ../../the-basics.rst:836 3b6def2609e44c32be069c6362839e2f msgid "" "Check whether a document is password protected / (still) encrypted " "(:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`)." msgstr "문서가 비밀번호로 보호되어 있는지/(여전히) 암호화되어 있는지 확인합니다(:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`)." #: ../../the-basics.rst:837 ce41ab81ce8b4386a83878a416a7940a msgid "Gain access authorization to a document (:meth:`Document.authenticate`)." msgstr "문서에 대한 액세스 권한을 얻습니다(:meth:`Document.authenticate`)." #: ../../the-basics.rst:838 b189a7d59fa543a19cf3c17b16f8d694 msgid "" "Set encryption details for PDF files using :meth:`Document.save` or " ":meth:`Document.write` and" msgstr ":meth:`Document.save` 또는 :meth:`Document.write` 를 사용하여 PDF 파일의 암호화 세부 정보를 설정하고" #: ../../the-basics.rst:840 d636f0b456a045fe96ded79e540924a6 msgid "decrypt or encrypt the content" msgstr "콘텐츠 복호화 또는 암호화" #: ../../the-basics.rst:841 c02d51458a324504be651a75c4b42da7 msgid "set password(s)" msgstr "비밀번호 설정" #: ../../the-basics.rst:842 a9dbedfc3d3840d2b0ddef263073ee71 msgid "set the encryption method" msgstr "암호화 방법 설정" #: ../../the-basics.rst:843 8613c50a6710457fb64b656501a9ed53 msgid "set permission details" msgstr "권한 세부 정보 설정" #: ../../the-basics.rst:845 4d78b28e7d8c479bb687ad0b04fea32f msgid "A PDF document may have two different passwords:" msgstr "PDF 문서는 두 가지 다른 비밀번호를 가질 수 있습니다:" #: ../../the-basics.rst:847 17b762c8cf4d4efba56eae14ccf0e0e6 msgid "" "The **owner password** provides full access rights, including changing " "passwords, encryption method, or permission detail." msgstr "**소유자 비밀번호** 는 비밀번호, 암호화 방법 또는 권한 세부 정보 변경을 포함한 전체 액세스 권한을 제공합니다." #: ../../the-basics.rst:848 25b92c66fe7843978232636bf038bea9 msgid "" "The **user password** provides access to document content according to " "the established permission details. If present, opening the |PDF| in a " "viewer will require providing it." msgstr "**사용자 비밀번호** 는 설정된 권한 세부 정보에 따라 문서 콘텐츠에 대한 액세스를 제공합니다. 있는 경우 뷰어에서 |PDF| 를 열려면 이를 제공해야 합니다." #: ../../the-basics.rst:850 1fc241ab15944159a3e960c912753d85 msgid "" "Method :meth:`Document.authenticate` will automatically establish access " "rights according to the password used." msgstr ":meth:`Document.authenticate` 메서드는 사용된 비밀번호에 따라 액세스 권한을 자동으로 설정합니다." #: ../../the-basics.rst:852 5a8ee082646145f0af795201a5cf3f2c msgid "" "The following snippet creates a new |PDF| and encrypts it with separate " "user and owner passwords. Permissions are granted to print, copy and " "annotate, but no changes are allowed to someone authenticating with the " "user password." msgstr "다음 코드 조각은 새 |PDF| 를 생성하고 별도의 사용자 및 소유자 비밀번호로 암호화합니다. 인쇄, 복사 및 주석 달기 권한이 부여되지만 사용자 비밀번호로 인증하는 사람에게는 변경이 허용되지 않습니다." #: ../../the-basics.rst:886 bc1d33f5c72f4b7c91414475ea9319ad msgid "" "Opening this document with some viewer (Nitro Reader 5) reflects these " "settings:" msgstr "일부 뷰어(Nitro Reader 5)로 이 문서를 열면 이러한 설정이 반영됩니다:" #: ../../the-basics.rst:890 8d0714fc6e9b483da17392fad5a08ef9 msgid "" "**Decrypting** will automatically happen on save as before when no " "encryption parameters are provided." msgstr "**복호화** 는 암호화 매개변수가 제공되지 않으면 이전과 같이 저장 시 자동으로 발생합니다." #: ../../the-basics.rst:892 5ad13206208e4f04ab1f73c460b95b06 msgid "" "To **keep the encryption method** of a PDF save it using " "`encryption=pymupdf.PDF_ENCRYPT_KEEP`. If `doc.can_save_incrementally() " "== True`, an incremental save is also possible." msgstr "PDF의 **암호화 방법을 유지** 하려면 `encryption=pymupdf.PDF_ENCRYPT_KEEP` 를 사용하여 저장합니다. `doc.can_save_incrementally() == True` 인 경우 증분 저장도 가능합니다." #: ../../the-basics.rst:894 ea683283b4ae4990996434cbfc824108 msgid "" "To **change the encryption method** specify the full range of options " "above (`encryption`, `owner_pw`, `user_pw`, `permissions`). An " "incremental save is **not possible** in this case." msgstr "**암호화 방법을 변경** 하려면 위의 전체 옵션 범위(`encryption`, `owner_pw`, `user_pw`, `permissions`)를 지정합니다. 이 경우 증분 저장은 **불가능** 합니다." #: ../../the-basics.rst:898 6b214aa29bc543f4acbac8c3cd3481b0 msgid ":meth:`Document.save`" msgstr ":meth:`Document.save`" #: ../../the-basics.rst:907 a57f259ce92445d6a5d6c2862dc3cf54 msgid "Extracting Tables from a :title:`Page`" msgstr ":title:`Page` 에서 테이블 추출" #: ../../the-basics.rst:909 6f9e7f86d5ac46e3b9825c17b82571e4 msgid "Tables can be found and extracted from any document :ref:`Page`." msgstr "테이블은 모든 문서 :ref:`Page` 에서 찾고 추출할 수 있습니다." #: ../../the-basics.rst:928 b7494b5442a14995a5d2119082615ca8 msgid ":meth:`Page.find_tables`" msgstr ":meth:`Page.find_tables`" #: ../../the-basics.rst:933 c890052d477340849a65eeee67960e53 msgid "" "There is also the `pdf2docx extract tables method`_ which is capable of " "table extraction if you prefer." msgstr "원하는 경우 테이블 추출이 가능한 `pdf2docx extract tables method`_ 도 있습니다." #: ../../the-basics.rst:942 a282cebe140b45f5b2ed5299e377820a msgid "Getting Page Links" msgstr "페이지 링크 가져오기" #: ../../the-basics.rst:944 65729bc707934b5eb43017e9a7ccf13f msgid "Links can be extracted from a :ref:`Page` to return :ref:`Link` objects." msgstr "링크는 :ref:`Page` 에서 추출하여 :ref:`Link` 객체를 반환할 수 있습니다." #: ../../the-basics.rst:964 a413c62db71c4a03bcf604d1cbb23495 msgid ":meth:`Page.first_link`" msgstr ":meth:`Page.first_link`" #: ../../the-basics.rst:973 9c52975671c8427abba8f3c2386f6cfd msgid "Getting All Annotations from a Document" msgstr "문서에서 모든 주석 가져오기" #: ../../the-basics.rst:975 6c049fc7e04c48738c8b0a947179c35a msgid "" "Annotations (:ref:`Annot`) on pages can be retrieved with the " "`page.annots()` method." msgstr "페이지의 주석(:ref:`Annot`)은 `page.annots()` 메서드로 검색할 수 있습니다." #: ../../the-basics.rst:990 02ac755f074b4ae28b2dde5d67b4474f msgid ":meth:`Page.annots`" msgstr ":meth:`Page.annots`" #: ../../the-basics.rst:1000 3d4556c1d28240f2aa6a1c395fc1a1a9 msgid "Redacting content from a |PDF|" msgstr "|PDF| 에서 콘텐츠 편집" #: ../../the-basics.rst:1002 d99eb5ab89464e8d97d4fc7e46651604 msgid "" "Redactions are special types of annotations which can be marked onto a " "document page to denote an area on the page which should be securely " "removed. After marking an area with a rectangle then this area will be " "marked for *redaction*, once the redaction is *applied* then the content " "is securely removed." msgstr "편집은 문서 페이지에 표시되어 안전하게 제거해야 하는 페이지 영역을 나타내는 특수한 유형의 주석입니다. 사각형으로 영역을 표시한 후 이 영역은 *편집* 으로 표시되며, 편집이 *적용* 되면 콘텐츠가 안전하게 제거됩니다." #: ../../the-basics.rst:1004 223f6cd8cecb4da98e5dd318031c8fda msgid "" "For example if we wanted to redact all instances of the name \"Jane Doe\"" " from a document we could do the following:" msgstr "예를 들어 문서에서 이름 \"Jane Doe\" 의 모든 인스턴스를 편집하려면 다음을 수행할 수 있습니다:" #: ../../the-basics.rst:1032 62dd2d2bb85640b2b62115053f61669a msgid "" "Another example could be redacting an area of a page, but not to redact " "any line art (i.e. vector graphics) within the defined area, by setting a" " parameter flag as follows:" msgstr "다른 예제는 페이지의 영역을 편집하되, 다음처럼 매개변수 플래그를 설정하여 정의된 영역 내의 선 아트(즉, 벡터 그래픽)는 편집하지 않는 것입니다:" #: ../../the-basics.rst:1063 d9d9f830754d466387849b71b4085d14 msgid "" "Once a redacted version of a document is saved then the redacted content " "in the |PDF| is *irretrievable*. Thus, a redacted area in a document " "removes text and graphics completely from that area." msgstr "문서의 편집된 버전이 저장되면 |PDF| 의 편집된 콘텐츠는 *복구할 수 없습니다*. 따라서 문서의 편집된 영역은 해당 영역에서 텍스트와 그래픽을 완전히 제거합니다." #: ../../the-basics.rst:1070 946a2796985d485fb5e2ed7acc4289e8 msgid "" "The are a few options for creating and applying redactions to a page, for" " the full API details to understand the parameters to control these " "options refer to the API reference." msgstr "페이지에 편집을 생성하고 적용하는 몇 가지 옵션이 있습니다. 이러한 옵션을 제어하는 매개변수를 이해하려면 전체 API 세부 정보는 API 참조를 참조하세요." #: ../../the-basics.rst:1074 548f9c1e5ac243f8b4055e2a34c65166 msgid ":meth:`Page.add_redact_annot`" msgstr ":meth:`Page.add_redact_annot`" #: ../../the-basics.rst:1076 47c9ad1997a44ad7b9d0ef477ee10755 msgid ":meth:`Page.apply_redactions`" msgstr ":meth:`Page.apply_redactions`" #: ../../the-basics.rst:1086 1a162b81c4bf4f65abc57893d5ffe457 msgid "Converting PDF Documents" msgstr "PDF 문서 변환" #: ../../the-basics.rst:1088 72cd004015184e5c91130763bcf42e8b msgid "" "We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-" "docx** library to provide simple document conversion from |PDF| to " "**DOCX** format." msgstr "|PyMuPDF| 와 **python-docx** 라이브러리를 사용하여 |PDF| 에서 **DOCX** 형식으로 간단한 문서 변환을 제공하는 pdf2docx_ 라이브러리를 권장합니다." #: ../../footer.rst:48 3e0afdfbfd574b1daaa229594686200d msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." #~ msgid "" #~ "Using the :meth:`Document.insert_page` method " #~ "also inserts a new page and " #~ "accepts the same `width` and `height`" #~ " parameters. But it lets you also " #~ "insert arbitrary text into the new " #~ "page and returns the number of " #~ "inserted lines." #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/tools.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 0d73a14a6d9b419f84fde1e0a7e33dfb msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 921ceade773644d4b48019b5e3890fb7 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 a82f7fcc28444c4fb146f56d5780eff7 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../tools.rst:6 bf1306c6f8b244acaf911ab721a197e6 msgid "Tools" msgstr "Tools" #: ../../tools.rst:8 d6c5d72a09a14bd5b21c5508eee3c250 msgid "" "This class is a collection of utility methods and attributes, mainly " "around memory management. To simplify and speed up its use, it is " "automatically instantiated under the name *TOOLS* when PyMuPDF is " "imported." msgstr "이 클래스는 주로 메모리 관리와 관련된 유틸리티 메서드 및 속성의 모음입니다. 사용을 단순화하고 속도를 높이기 위해 PyMuPDF가 가져올 때 *TOOLS* 라는 이름으로 자동 인스턴스화됩니다." #: ../../tools.rst:11 9f4695034d1a41088a1a1d353f6e4809 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../tools.rst:11 f90fa89b5ac8455297a7e999b318a95d msgid "**Description**" msgstr "**설명**" #: ../../tools.rst:13 3b8fa8bde4af4703bd9f495bf42f0357 msgid ":meth:`Tools.gen_id`" msgstr ":meth:`Tools.gen_id`" #: ../../tools.rst:13 f4df8c5ade854c22b113521c4432ad43 msgid "generate a unique identifier" msgstr "고유 식별자 생성" #: ../../tools.rst:14 f8432b4a73fd4daebad6cf69ee75d4d4 msgid ":meth:`Tools.store_shrink`" msgstr ":meth:`Tools.store_shrink`" #: ../../tools.rst:14 8e71bc4d1dff4fffab79133c5adb84ef msgid "shrink the storables cache [#f1]_" msgstr "저장 가능한 캐시 축소 [#f1]_" #: ../../tools.rst:15 00c0e3852ea44f5ea91c82ec35aed5c6 msgid ":meth:`Tools.mupdf_warnings`" msgstr ":meth:`Tools.mupdf_warnings`" #: ../../tools.rst:15 6c729a59131c47e3991d378e1a1d7cf5 msgid "return the accumulated MuPDF warnings" msgstr "누적된 MuPDF 경고 반환" #: ../../tools.rst:16 7c9ee72296df4159918174ed60bb239f msgid ":meth:`Tools.mupdf_display_errors`" msgstr ":meth:`Tools.mupdf_display_errors`" #: ../../tools.rst:16 ad79443c20664a909cafe94ef8993c2e msgid "control whether MuPDF errors are displayed as messages." msgstr "MuPDF 오류를 메시지로 표시할지 제어합니다." #: ../../tools.rst:17 a3c989deda0d478a8f40594bf7839b13 msgid ":meth:`Tools.mupdf_display_warnings`" msgstr ":meth:`Tools.mupdf_display_warnings`" #: ../../tools.rst:17 3331b000061f4a199137b54996d28f55 msgid "control whether MuPDF warnings are displayed as messages." msgstr "MuPDF 경고를 메시지로 표시할지 제어합니다." #: ../../tools.rst:18 f77ae8fb589148f0bf492ce7a1e42572 msgid ":meth:`Tools.reset_mupdf_warnings`" msgstr ":meth:`Tools.reset_mupdf_warnings`" #: ../../tools.rst:18 2cd40e7b15e749f7ba4befb2c7516c7e msgid "empty MuPDF warnings/errors message buffer." msgstr "MuPDF 경고/오류 메시지 버퍼 비우기." #: ../../tools.rst:19 4447fb5926bd4ba7bec76e747bab9297 msgid ":meth:`Tools.set_aa_level`" msgstr ":meth:`Tools.set_aa_level`" #: ../../tools.rst:19 2e6c524419ac41e9a6900f4809d65d99 msgid "set the anti-aliasing values" msgstr "안티앨리어싱 값 설정" #: ../../tools.rst:20 a2dafc1f04fb468e927711809b1b4abb msgid ":meth:`Tools.set_annot_stem`" msgstr ":meth:`Tools.set_annot_stem`" #: ../../tools.rst:20 ee82321884b340e6a4b6fcffc62f8557 msgid "set the prefix of new annotation / link ids" msgstr "새 주석/링크 ID의 접두사 설정" #: ../../tools.rst:21 c1bc06eb490b40dab6174b41d9a9ee6c msgid ":meth:`Tools.set_small_glyph_heights`" msgstr ":meth:`Tools.set_small_glyph_heights`" #: ../../tools.rst:21 15946a92e17a460a9c36b31c32fe3247 msgid "search and extract using small bbox heights" msgstr "작은 bbox 높이를 사용하여 검색 및 추출" #: ../../tools.rst:22 8ecbbd2dd4e14e78a91df8d330c13ff6 msgid ":meth:`Tools.set_subset_fontnames`" msgstr ":meth:`Tools.set_subset_fontnames`" #: ../../tools.rst:22 4fa566e4c99645d999c63acedee77f82 msgid "control suppression of subset fontname tags" msgstr "서브셋 글꼴 이름 태그 억제 제어" #: ../../tools.rst:23 61d6e34abc994469a66c945c3a08e615 msgid ":meth:`Tools.show_aa_level`" msgstr ":meth:`Tools.show_aa_level`" #: ../../tools.rst:23 a7fd746934534e9d831b150cfe0481c9 msgid "return the anti-aliasing values" msgstr "안티앨리어싱 값 반환" #: ../../tools.rst:24 c9363164a1784bcaa8761a54aff46d1d msgid ":meth:`Tools.unset_quad_corrections`" msgstr ":meth:`Tools.unset_quad_corrections`" #: ../../tools.rst:24 5f3c02c8cfbd421e94b18e090cd74703 msgid "disable PyMuPDF-specific code" msgstr "PyMuPDF 전용 코드 비활성화" #: ../../tools.rst:25 651ff5c6373f471e8d008e9c405305ab msgid ":attr:`Tools.fitz_config`" msgstr ":attr:`Tools.fitz_config`" #: ../../tools.rst:25 b9e06f68f97a4ae1bbd309ad39720d5d msgid "configuration settings of PyMuPDF" msgstr "PyMuPDF의 구성 설정" #: ../../tools.rst:26 4df2a633c6da421f9959024a3d94fa3f msgid ":attr:`Tools.store_maxsize`" msgstr ":attr:`Tools.store_maxsize`" #: ../../tools.rst:26 122b22e68967478289e3a595b9e4e8f7 msgid "maximum storables cache size" msgstr "최대 저장 가능한 캐시 크기" #: ../../tools.rst:27 d7402c339e7e41708fd85b9e49948078 msgid ":attr:`Tools.store_size`" msgstr ":attr:`Tools.store_size`" #: ../../tools.rst:27 14ccf353f0934125951cc340919573ee msgid "current storables cache size" msgstr "현재 저장 가능한 캐시 크기" #: ../../tools.rst:30 2128d557bf1f4f3d9d16ad8e9dba7f05 msgid "**Class API**" msgstr "**클래스 API**" #: ../../tools.rst:36 189938171e2b49469e4180e2f35aa327 msgid "" "A convenience method returning a unique positive integer which will " "increase by 1 on every invocation. Example usages include creating unique" " keys in databases - its creation should be faster than using timestamps " "by an order of magnitude." msgstr "호출할 때마다 1씩 증가하는 고유한 양의 정수를 반환하는 편의 메서드입니다. 사용 예에는 데이터베이스에서 고유 키 생성이 포함됩니다. 생성은 타임스탬프 사용보다 한 자릿수 빠를 수 있습니다." #: ../../tools.rst:38 695deea765974c6fad7f3e3815d0a10f msgid "" "MuPDF has dropped support for this in v1.14.0, so we have re-implemented " "a similar function with the following differences:" msgstr "MuPDF는 v1.14.0에서 이것에 대한 지원을 중단했으므로 다음과 같은 차이점이 있는 유사한 함수를 다시 구현했습니다:" #: ../../tools.rst:40 a683185479de4917b28d0da3b150aeb8 msgid "" "It is not part of MuPDF's global context and not threadsafe (not an issue" " because we do not support threads in PyMuPDF anyway)." msgstr "MuPDF의 전역 컨텍스트의 일부가 아니며 스레드 안전하지 않습니다(PyMuPDF에서 어쨌든 스레드를 지원하지 않으므로 문제가 되지 않습니다)." #: ../../tools.rst:41 1b2ba6f48de24451a18b344a30157fbd msgid "" "It is implemented as *int*. This means that the maximum number is " "*sys.maxsize*. Should this number ever be exceeded, the counter starts " "over again at 1." msgstr "*int* 로 구현됩니다. 즉, 최대 숫자는 *sys.maxsize* 입니다. 이 숫자가 초과되면 카운터가 1부터 다시 시작합니다." #: ../../tools.rst 4a3706449679419cbfe46da4fca67368 #: 4b21a59b097141b5aaf0f44b355bd101 5672ab6b4aba48c892de4d5bb4e0f0b9 #: 6669bbdf4a3e4020a1d9b48bff99e268 957464664fbc40f0af479085467effc0 #: 9990614cbe3041348193e004172104db 999752762ad24ea4bf641bfb8ad2f43f #: c24f35275eaf4e4192cf718cc1f06dbc e55479e7313947a092977c725c75a395 #: e919810950e6418e9d92a82349a27cc5 msgid "Return type" msgstr "반환 유형" #: ../../tools.rst 07f96f9c40e24f1993747e0c10a8eff6 #: 226fe9b32c914b299f5fbc681e42ffc1 22d12df8c6e44432b1b8c0ca643fe26b #: 6bd8faa6d20a40a2a3317b0b6c56695c 95ff0c78ce0449998879214817772a0f #: a12efba073594882b138ec467749be24 b15ef08627884b7d9cb926fae2c74680 #: d317ebc8557f4d41bb1a58c902624a43 de51e2f78e304d46be9085659f5175b0 msgid "Returns" msgstr "반환값" #: ../../tools.rst:44 cf26039ee2174ec4a0622c0822a413bb msgid "a unique positive integer." msgstr "고유한 양의 정수." #: ../../tools.rst:49 329f36f70579439ea15f22b38c11d02a msgid "New in v1.18.6" msgstr "v1.18.6에서 새로 추가됨" #: ../../tools.rst:51 9db0524a2e0b4842a9c038c8912cd9d8 msgid "Set or inquire the prefix for the id of new annotations, fields or links." msgstr "새 주석, 필드 또는 링크의 ID 접두사를 설정하거나 조회합니다." #: ../../tools.rst 07fc0d2c71f440218ad32d0fa55bd668 #: 0ac957fb86d34012bc3ca235b75a2815 13711810c96c4b3eba0c108d0199a0a7 #: 1d1396015b5247a5bd6c115fb3673828 3c06afcb1d6a424383b91978fc6206bc #: 631e43e526dd46998258d5316be56c67 6605936ea7ec4e80b4bbea17b256c74d #: 6fee094bef9d4193923a723c70f17922 ddd35b40d05a410cb68e69625771ba39 msgid "Parameters" msgstr "매개변수" #: ../../tools.rst:53 4b1ab23b0f98420db4907311dec28fb1 msgid "" "if omitted, the current value is returned, default is \"fitz\". " "Annotations, fields / widgets and links technically are subtypes of the " "same type of object (`/Annot`) in PDF documents. An `/Annot` object may " "be given a unique identifier within a page. For each of the applicable " "subtypes, PyMuPDF generates identifiers \"stem-Annn\", \"stem-Wnnn\" or " "\"stem-Lnnn\" respectively. The number \"nnn\" is used to enforce the " "required uniqueness." msgstr "생략하면 현재 값이 반환되며, 기본값은 \"fitz\"입니다. 주석, 필드/위젯 및 링크는 기술적으로 PDF 문서에서 동일한 객체 유형(`/Annot`)의 하위 유형입니다. `/Annot` 객체는 페이지 내에서 고유 식별자를 가질 수 있습니다. 각 적용 가능한 하위 유형에 대해 PyMuPDF는 각각 \"stem-Annn\", \"stem-Wnnn\" 또는 \"stem-Lnnn\" 식별자를 생성합니다. 숫자 \"nnn\"은 필요한 고유성을 강제하는 데 사용됩니다." #: ../../tools.rst:56 4f61028eee9146b292fb1b2405da09d1 msgid "the current value." msgstr "현재 값." #: ../../tools.rst:61 3cb17a9bd0814e1687e04154eec0593c msgid "New in v1.18.5" msgstr "v1.18.5에서 새로 추가됨" #: ../../tools.rst:63 217da1303cbb4b13b6837e9ca5541ce0 msgid "" "Set or inquire reduced bbox heights in text extract and text search " "methods." msgstr "텍스트 추출 및 텍스트 검색 메서드에서 축소된 bbox 높이를 설정하거나 조회합니다." #: ../../tools.rst:65 56c84534f6434dc8841353567d8b453e msgid "" "if omitted or `None`, the current setting is returned. For other values " "the *bool()* function is applied to set a global variable. If `True`, " ":meth:`Page.search_for` and :meth:`Page.get_text` methods return " "character, span, line or block bboxes that have a height of *font size*. " "If `False` (standard setting when PyMuPDF is imported), bbox height will " "be based on font properties and normally equal *line height*." msgstr "생략하거나 `None` 이면 현재 설정이 반환됩니다. 다른 값의 경우 *bool()* 함수가 적용되어 전역 변수가 설정됩니다. `True` 인 경우 :meth:`Page.search_for` 및 :meth:`Page.get_text` 메서드는 *글꼴 크기* 의 높이를 가진 문자, 스팬, 줄 또는 블록 bbox를 반환합니다. `False` 인 경우(PyMuPDF를 가져올 때의 표준 설정) bbox 높이는 글꼴 속성을 기반으로 하며 일반적으로 *줄 높이* 와 같습니다." #: ../../tools.rst:68 ../../tools.rst:81 ../../tools.rst:95 #: a176f0944378445b9d91fe21cb93ad4d d1b2c5f192854ac09a19db50d3b38655 #: f628ee815a1c4d908896ef7b8f14b847 msgid "``True`` or ``False``." msgstr "``True`` 또는 ``False``." #: ../../tools.rst:70 808cb746a7f74b23b2eccf918a1aee94 msgid "" "Text extraction options \"xml\", \"xhtml\" and \"html\", which directly " "wrap MuPDF code, are not influenced by this." msgstr "MuPDF 코드를 직접 래핑하는 텍스트 추출 옵션 \"xml\", \"xhtml\" 및 \"html\"은 이것의 영향을 받지 않습니다." #: ../../tools.rst:74 897746f738b94bc295467ea1ebcea01b msgid "New in v1.18.9" msgstr "v1.18.9에서 새로 추가됨" #: ../../tools.rst:76 744e708191de4faa9c2a7dade121573a msgid "Control suppression of subset fontname tags in text extractions." msgstr "텍스트 추출에서 서브셋 글꼴 이름 태그 억제를 제어합니다." #: ../../tools.rst:78 59d2a8ce838b418a8dc500d85140932e msgid "" "if omitted / `None`, the current setting is returned. Arguments " "evaluating to `True` or `False` set a global variable. If `True`, options" " \"dict\", \"json\", \"rawdict\" and \"rawjson\" will return e.g. " "`\"NOHSJV+Calibri-Light\"`, otherwise only `\"Calibri-Light\"` (the " "default). The setting remains in effect until changed again." msgstr "생략/`None` 이면 현재 설정이 반환됩니다. `True` 또는 `False` 로 평가되는 인수는 전역 변수를 설정합니다. `True` 인 경우 옵션 \"dict\", \"json\", \"rawdict\" 및 \"rawjson\"은 예를 들어 `\"NOHSJV+Calibri-Light\"` 를 반환하고, 그렇지 않으면 `\"Calibri-Light\"` 만 반환합니다(기본값). 설정은 다시 변경될 때까지 유효합니다." #: ../../tools.rst:83 d6465691fb404e9f9138143abb284794 msgid "" "Except mentioned above, no other text extraction variants are influenced " "by this. This is especially true for the options \"xml\", \"xhtml\" and " "\"html\", which are based on MuPDF code. They extract the font name " "`\"Calibri-Light\"`, or even just the **family** name -- `Calibri` in " "this example." msgstr "위에서 언급한 것 외에는 다른 텍스트 추출 변형은 이것의 영향을 받지 않습니다. 이것은 특히 MuPDF 코드를 기반으로 하는 옵션 \"xml\", \"xhtml\" 및 \"html\"에 해당합니다. 이들은 글꼴 이름 `\"Calibri-Light\"` 또는 **패밀리** 이름만 추출합니다 -- 이 예에서는 `Calibri` 입니다." #: ../../tools.rst:88 d588b77e57cf47edadda3e5a2bd2640c msgid "New in v1.18.10" msgstr "v1.18.10에서 새로 추가됨" #: ../../tools.rst:90 a2f363e88df54db6bf8ab0004f895156 msgid "" "Enable / disable PyMuPDF-specific code, that tries to rebuild valid " "character quads when encountering nonsense in :meth:`Page.get_text` text " "extractions. This code depends on certain font properties (ascender and " "descender), which do not exist in rare situations and cause segmentation " "faults when trying to access them. This method sets a global parameter in" " PyMuPDF, which suppresses execution of this code." msgstr "PyMuPDF 전용 코드를 활성화/비활성화합니다. 이 코드는 :meth:`Page.get_text` 텍스트 추출에서 의미 없는 내용을 만날 때 유효한 문자 quad를 재구성하려고 시도합니다. 이 코드는 특정 글꼴 속성(ascender 및 descender)에 의존하며, 이는 드문 상황에서 존재하지 않으며 접근하려고 할 때 세그멘테이션 오류를 일으킵니다. 이 메서드는 PyMuPDF에서 전역 매개변수를 설정하여 이 코드의 실행을 억제합니다." #: ../../tools.rst:92 d5e3272b930e4822a2e6c4d5e66a011b msgid "" "if omitted or `None`, the current setting is returned. For other values " "the *bool()* function is applied to set a global variable. If `True`, " "PyMuPDF will not try to access the resp. font properties and use values " "`ascender=0.8` and `descender=-0.2` instead." msgstr "생략하거나 `None` 이면 현재 설정이 반환됩니다. 다른 값의 경우 *bool()* 함수가 적용되어 전역 변수가 설정됩니다. `True` 인 경우 PyMuPDF는 해당 글꼴 속성에 접근하려고 시도하지 않고 대신 `ascender=0.8` 및 `descender=-0.2` 값을 사용합니다." #: ../../tools.rst:100 333a61c7d142433ab4fd0f13a7aabc3c msgid "Reduce the storables cache by a percentage of its current size." msgstr "저장 가능한 캐시를 현재 크기의 백분율로 줄입니다." #: ../../tools.rst:102 5790eaa60b4f4f4cadc19ece9d505603 msgid "" "the percentage of current size to free. If 100+ the store will be " "emptied, if zero, nothing will happen. MuPDF's caching strategy is " "\"least recently used\", so low-usage elements get deleted first." msgstr "해제할 현재 크기의 백분율. 100 이상이면 저장소가 비워지고, 0이면 아무 일도 일어나지 않습니다. MuPDF의 캐싱 전략은 \"최근에 사용되지 않은 것\"이므로 사용 빈도가 낮은 요소가 먼저 삭제됩니다." #: ../../tools.rst:105 1b9c6e1ac6134c118b552c8a38a7587a msgid "" "the new current store size. Depending on the situation, the size " "reduction may be larger than the requested percentage." msgstr "새로운 현재 저장소 크기. 상황에 따라 크기 감소가 요청된 백분율보다 클 수 있습니다." #: ../../tools.rst:109 ../../tools.rst:119 5be5f274ce2740e89346b52c7e37e06a #: b90faa6a9e97498798492c9d79a9bf6d msgid "New in version 1.16.14" msgstr "버전 1.16.14에서 새로 추가됨" #: ../../tools.rst:111 1f5fae3d0c1e48c8a312f344dfa41fc0 msgid "" "Return the current anti-aliasing values. These values control the " "rendering quality of graphics and text elements." msgstr "현재 안티앨리어싱 값을 반환합니다. 이 값들은 그래픽 및 텍스트 요소의 렌더링 품질을 제어합니다." #: ../../tools.rst:114 e6976bc95bab4023b63ca1064c6a68ca msgid "" "A dictionary with the following initial content: `{'graphics': 8, 'text':" " 8, 'graphics_min_line_width': 0.0}`." msgstr "다음 초기 내용을 가진 딕셔너리: `{'graphics': 8, 'text': 8, 'graphics_min_line_width': 0.0}`." #: ../../tools.rst:121 911a1d5a1cb24741a60e13fc35d16874 msgid "" "Set the new number of bits to use for anti-aliasing. The same value is " "taken currently for graphics and text rendering. This might change in a " "future MuPDF release." msgstr "안티앨리어싱에 사용할 새로운 비트 수를 설정합니다. 현재 그래픽 및 텍스트 렌더링에 동일한 값이 사용됩니다. 이것은 향후 MuPDF 릴리스에서 변경될 수 있습니다." #: ../../tools.rst:123 926fa10830264d0c8cfbe04143b5486e msgid "" "an integer ranging between 0 and 8. Value outside this range will be " "silently changed to valid values. The value will remain in effect " "throughout the current session or until changed again." msgstr "0과 8 사이의 정수. 이 범위를 벗어난 값은 자동으로 유효한 값으로 변경됩니다. 값은 현재 세션 동안 또는 다시 변경될 때까지 유효합니다." #: ../../tools.rst:128 ../../tools.rst:167 144d6b730a8649498527dfd19b461f43 #: 3a2e5f71bfd04dd5a13298d81dc0c38c msgid "New in version 1.16.0" msgstr "버전 1.16.0에서 새로 추가됨" #: ../../tools.rst:130 2d91e313160b448ea59abdf6c66b4a0d msgid "Empty MuPDF warnings message buffer." msgstr "MuPDF 경고 메시지 버퍼 비우기." #: ../../tools.rst:135 92b7764848884178b4a41b5d1ff2caa3 msgid "Control whether MuPDF errors should be displayed as |PyMuPDF| messages." msgstr "MuPDF 오류를 |PyMuPDF| 메시지로 표시할지 제어합니다." #: ../../tools.rst:138 ../../tools.rst:154 1d6bb3c5c84647d58a7d5ed4b5a92b2c #: e72ab3692a3e4261b45203c6bfa6fd63 msgid "If `None`, the current setting is left unchanged." msgstr "`None` 이면 현재 설정이 변경되지 않습니다." #: ../../tools.rst:139 c2abcce114b8497dae07e3ea0bc60591 msgid "" "Otherwise changes the current setting to `bool(value)`; if ``True``, " "future MuPDF errors will be shown as :ref:`Messages`." msgstr "그렇지 않으면 현재 설정을 `bool(value)` 로 변경합니다. ``True`` 인 경우 향후 MuPDF 오류가 :ref:`Messages` 로 표시됩니다." #: ../../tools.rst:141 a4be68a89b5d4042996ecf157036e027 msgid "" "Regardless of this setting, MuPDF errors will always be stored in the " "warnings store." msgstr "이 설정과 관계없이 MuPDF 오류는 항상 경고 저장소에 저장됩니다." #: ../../tools.rst:142 ../../tools.rst:158 23ee905f3f0e48319c7c3638b644070d #: b94e26874cea438aa7f0653a55f1414f msgid "Upon import of |PyMuPDF| this value is ``True``." msgstr "|PyMuPDF| 를 가져올 때 이 값은 ``True`` 입니다." #: ../../tools.rst:144 ../../tools.rst:160 380a472c7f0440deadd5f2a66e36cd6d #: ec3080d72d284985b697f158380df6b2 msgid "The current setting as ``True`` or ``False``." msgstr "``True`` 또는 ``False`` 로 표시된 현재 설정." #: ../../tools.rst:146 ../../tools.rst:162 7482f516a78043879c8c3e587e6ecbe6 #: c135c85d22654225b7e4564087de3d01 msgid "New in version 1.16.8" msgstr "버전 1.16.8에서 새로 추가됨" #: ../../tools.rst:151 35926b1a764d48ae80b23f5dd83f3451 msgid "Control whether MuPDF warnings should be displayed as |PyMuPDF| messages." msgstr "MuPDF 경고를 |PyMuPDF| 메시지로 표시할지 제어합니다." #: ../../tools.rst:155 16b5294227bd4af28cbe50a51eb464b5 msgid "" "Otherwise changes the current setting to `bool(value)`; if ``True``, " "future MuPDF warnings will be shown as :ref:`Messages`." msgstr "그렇지 않으면 현재 설정을 `bool(value)` 로 변경합니다. ``True`` 인 경우 향후 MuPDF 경고가 :ref:`Messages` 로 표시됩니다." #: ../../tools.rst:157 f7cf6d0e1c1543b09eed6f3596cc274c msgid "" "Regardless of this setting, MuPDF warnings will always be stored in the " "warnings store." msgstr "이 설정과 관계없이 MuPDF 경고는 항상 경고 저장소에 저장됩니다." #: ../../tools.rst:169 a3f7042644dd47c383bcc0f2188e0677 msgid "" "Return all stored MuPDF messages as a string with interspersed line-" "breaks." msgstr "줄바꿈이 섞인 문자열로 저장된 모든 MuPDF 메시지를 반환합니다." #: ../../tools.rst:171 287a6a8e83ba40cebec9beb0cce433ad msgid "*(new in version 1.16.7)* whether to automatically empty the store." msgstr "*(버전 1.16.7에서 새로 추가됨)* 저장소를 자동으로 비울지 여부." #: ../../tools.rst:176 0b1e9109776c417d9631077a29280c56 msgid "" "A dictionary containing the actual values used for configuring PyMuPDF " "and MuPDF. Also refer to the installation chapter. This is an overview of" " the keys, each of which describes the status of a support aspect." msgstr "PyMuPDF 및 MuPDF 구성에 사용되는 실제 값을 포함하는 딕셔너리. 설치 장도 참조하세요. 이것은 각 키가 지원 측면의 상태를 설명하는 키의 개요입니다." #: ../../tools.rst:179 29eef430a5db42389b1ed5ded77ee8dc msgid "**Key**" msgstr "**키**" #: ../../tools.rst:179 8ec8d2564994434abd178d4f3c3f4c27 msgid "**Support included for ...**" msgstr "**다음에 대한 지원 포함 ...**" #: ../../tools.rst:181 b78162547f5b4e87a989c50674465ac3 msgid "plotter-g" msgstr "plotter-g" #: ../../tools.rst:181 a6e78ff6069e4d3ba0c8d22a1dd3e306 msgid "Gray colorspace rendering" msgstr "회색 색 공간 렌더링" #: ../../tools.rst:182 018d6608637142b39977343ce2007a00 msgid "plotter-rgb" msgstr "plotter-rgb" #: ../../tools.rst:182 e760fa73ba9244e5a70d3038f62eedc0 msgid "RGB colorspace rendering" msgstr "RGB 색 공간 렌더링" #: ../../tools.rst:183 0ebf2b22dcae46a4ac0e108cd380d920 msgid "plotter-cmyk" msgstr "plotter-cmyk" #: ../../tools.rst:183 219cf41f7248407fb5018ae49943793b msgid "CMYK colorspcae rendering" msgstr "CMYK 색 공간 렌더링" #: ../../tools.rst:184 3c60e398c9bf4ea1a21599b87752ff86 msgid "plotter-n" msgstr "plotter-n" #: ../../tools.rst:184 769eb710317c41a480dbc570a4cee0f1 msgid "overprint rendering" msgstr "오버프린트 렌더링" #: ../../tools.rst:185 de0c1cb2bd6e4d3f9218813213738b89 msgid "pdf" msgstr "pdf" #: ../../tools.rst:185 0eb90b0c563943b092427c844fa84d82 msgid "PDF documents" msgstr "PDF 문서" #: ../../tools.rst:186 b99df5adf3fa4e9f9146cf0f5b29995a msgid "xps" msgstr "xps" #: ../../tools.rst:186 9489b74272084bbeb3d2c279e697ecf2 msgid "XPS documents" msgstr "XPS 문서" #: ../../tools.rst:187 d2a4ee5c893b4b87a0166bbe1856cda6 msgid "svg" msgstr "svg" #: ../../tools.rst:187 e551c61cd7e441449280f9359dec7dc7 msgid "SVG documents" msgstr "SVG 문서" #: ../../tools.rst:188 577bc099e8ac44c9b26c26942341b2c7 msgid "cbz" msgstr "cbz" #: ../../tools.rst:188 ebc6a4b501dc4f6b962a645852e681d1 msgid "CBZ documents" msgstr "CBZ 문서" #: ../../tools.rst:189 64ec1daad09243c88803ed7eb5709835 msgid "img" msgstr "img" #: ../../tools.rst:189 7d744907b35241c78b99cc180e6b9113 msgid "IMG documents" msgstr "IMG 문서" #: ../../tools.rst:190 bb12f79a20f04779acd3ed438cfbbc96 msgid "html" msgstr "html" #: ../../tools.rst:190 bb3a4a4575c943969b56f0af2d838d7e msgid "HTML documents" msgstr "HTML 문서" #: ../../tools.rst:191 ab3d19b472154fce925a82f813fe20c5 msgid "epub" msgstr "epub" #: ../../tools.rst:191 44a8aabb49ac41458e987ca800cc7eac msgid "EPUB documents" msgstr "EPUB 문서" #: ../../tools.rst:192 4a9f9a0ca3fe4cc79bc5b83c962ebe17 msgid "jpx" msgstr "jpx" #: ../../tools.rst:192 5ab6d3192a344c83a9666aadf1016b5b msgid "JPEG2000 images" msgstr "JPEG2000 이미지" #: ../../tools.rst:193 b74ed5834b3d4fd081414ff7634e74ec msgid "js" msgstr "js" #: ../../tools.rst:193 36672693f4374487a530bf0c3af9832c msgid "JavaScript" msgstr "JavaScript" #: ../../tools.rst:194 adc238844f2c4040bbd4a86abbf6039a msgid "tofu" msgstr "tofu" #: ../../tools.rst:194 558f9de6ca4f46dd808cfbf415f7ce06 msgid "all TOFU fonts" msgstr "모든 TOFU 글꼴" #: ../../tools.rst:195 3f1c381eadc64b8db7d515ae9eba3984 msgid "tofu-cjk" msgstr "tofu-cjk" #: ../../tools.rst:195 ea40b88f4fdd4d1eb43a2a6bf6e8f5ba msgid "CJK font subset (China, Japan, Korea)" msgstr "CJK 글꼴 서브셋 (중국, 일본, 한국)" #: ../../tools.rst:196 a4f1e69f4b814edb83e603a1355259dc msgid "tofu-cjk-ext" msgstr "tofu-cjk-ext" #: ../../tools.rst:196 c377019167934982a83d55627ae3ba2c msgid "CJK font extensions" msgstr "CJK 글꼴 확장" #: ../../tools.rst:197 0fc7a1646f7646738d72ec2061e7691c msgid "tofu-cjk-lang" msgstr "tofu-cjk-lang" #: ../../tools.rst:197 66d5555a5824418a9f35c3b2b71e4b88 msgid "CJK font language extensions" msgstr "CJK 글꼴 언어 확장" #: ../../tools.rst:198 1b5d5d0dbd32445593b767b2483e3060 msgid "tofu-emoji" msgstr "tofu-emoji" #: ../../tools.rst:198 0cdbcf60f7d64d39b197db2579600064 msgid "TOFU emoji fonts" msgstr "TOFU 이모지 글꼴" #: ../../tools.rst:199 7fc6679d779c41719fccabfb090325fa msgid "tofu-historic" msgstr "tofu-historic" #: ../../tools.rst:199 9cbba9254c32429899b6b2dac733f20d msgid "TOFU historic fonts" msgstr "TOFU 역사적 글꼴" #: ../../tools.rst:200 2ef2e1b8fab04ed5b5cf6812262986b0 msgid "tofu-symbol" msgstr "tofu-symbol" #: ../../tools.rst:200 70b9a0a97d0f47deb48c32f026c189b8 msgid "TOFU symbol fonts" msgstr "TOFU 기호 글꼴" #: ../../tools.rst:201 84425b54341d4ddf86a53d5636ce6d6c msgid "tofu-sil" msgstr "tofu-sil" #: ../../tools.rst:201 eb589864b3f14b24adedd043685a8f64 msgid "TOFU SIL fonts" msgstr "TOFU SIL 글꼴" #: ../../tools.rst:202 755f0012ad0c4aea8e9a52a0776c2c81 msgid "icc" msgstr "icc" #: ../../tools.rst:202 5358baa2b811434fb799602302fdbe35 msgid "ICC profiles" msgstr "ICC 프로필" #: ../../tools.rst:203 1ea2192091824ca8a0a392c9dc10f890 msgid "py-memory" msgstr "py-memory" #: ../../tools.rst:203 9cb31e10c386492c9cbb9a5e2265ace3 msgid "using Python memory management [#f2]_" msgstr "Python 메모리 관리 사용 [#f2]_" #: ../../tools.rst:204 dec087f849db4162a867ce6d93c08a53 msgid "base14" msgstr "base14" #: ../../tools.rst:204 69f5e80bd30c411d97af4b8a75e364ec msgid "Base-14 fonts (should always be true)" msgstr "Base-14 글꼴 (항상 true여야 함)" #: ../../tools.rst:207 3a669d605b904f36b9308d04b1fad7df msgid "" "For an explanation of the term \"TOFU\" see `this Wikipedia article " "`_::" msgstr "\"TOFU\" 용어에 대한 설명은 `이 위키피디아 기사 `_ 를 참조하세요::" #: ../../tools.rst:241 bf3651fc67ee458a8794cf46e18bdaa0 msgid "" "Maximum storables cache size in bytes. |PyMuPDF| is generated with a " "value of 268'435'456 (256 MB, the default value), which you should " "therefore always see here. If this value is zero, then an \"unlimited\" " "growth is permitted." msgstr "최대 저장 가능한 캐시 크기(바이트). |PyMuPDF| 는 268'435'456(256 MB, 기본값) 값으로 생성되므로 여기서 항상 이 값을 볼 수 있습니다. 이 값이 0이면 \"무제한\" 증가가 허용됩니다." #: ../../tools.rst:247 cd118310efc74373a064388fb69baf0b msgid "" "Current storables cache size in bytes. This value may change (and will " "usually increase) with every use of a |PyMuPDF| function. It will " "(automatically) decrease only when :attr:`Tools.store_maxsize` is going " "to be exceeded: in this case, |MuPDF| will evict low-usage objects until " "the value is again in range." msgstr "현재 저장 가능한 캐시 크기(바이트). 이 값은 |PyMuPDF| 함수를 사용할 때마다 변경될 수 있으며(일반적으로 증가) :attr:`Tools.store_maxsize` 가 초과될 때만 (자동으로) 감소합니다. 이 경우 |MuPDF| 는 값이 다시 범위 내에 있을 때까지 사용 빈도가 낮은 객체를 제거합니다." #: ../../tools.rst:252 eb29156bef9747b0801b3a3a7cb7b827 msgid "Example Session" msgstr "예제 세션" #: ../../tools.rst:288 4ea509ba0cce45108ae592589157ef48 msgid "Footnotes" msgstr "각주" #: ../../tools.rst:289 eac7cbc90f544d38b17f9aaecb25533b msgid "" "This memory area is internally used by MuPDF, and it serves as a cache " "for objects that have already been read and interpreted, thus improving " "performance. The most bulky object types are images and also fonts. When " "an application starts up the MuPDF library (in our case this happens as " "part of *import pymupdf*), it must specify a maximum size for this area. " "PyMuPDF's uses the default value (256 MB) to limit memory consumption. " "Use the methods here to control or investigate store usage. For example: " "even after a document has been closed and all related objects have been " "deleted, the store usage may still not drop down to zero. So you might " "want to enforce that before opening another document." msgstr "이 메모리 영역은 MuPDF에서 내부적으로 사용되며, 이미 읽고 해석된 객체에 대한 캐시 역할을 하여 성능을 향상시킵니다. 가장 큰 객체 유형은 이미지와 글꼴입니다. 애플리케이션이 MuPDF 라이브러리를 시작할 때(*import pymupdf* 의 일부로 발생) 이 영역에 대한 최대 크기를 지정해야 합니다. PyMuPDF는 기본값(256 MB)을 사용하여 메모리 소비를 제한합니다. 여기서 메서드를 사용하여 저장소 사용을 제어하거나 조사하세요. 예를 들어: 문서가 닫히고 관련 객체가 모두 삭제된 후에도 저장소 사용량이 여전히 0으로 떨어지지 않을 수 있습니다. 따라서 다른 문서를 열기 전에 이를 강제로 실행할 수 있습니다." #: ../../tools.rst:291 762bd894d82742c9b21223dc22c6390d msgid "" "By default PyMuPDF and MuPDF use `malloc()`/`free()` for dynamic memory " "management. One can instead force them to use the Python allocation " "functions `PyMem_New()`/`PyMem_Del()`, by modifying *fitz/fitz.i* to do " "`#define JM_MEMORY 1` and rebuilding PyMuPDF." msgstr "기본적으로 PyMuPDF와 MuPDF는 동적 메모리 관리에 `malloc()`/`free()` 를 사용합니다. 대신 *fitz/fitz.i* 를 수정하여 `#define JM_MEMORY 1` 을 수행하고 PyMuPDF를 다시 빌드하여 Python 할당 함수 `PyMem_New()`/`PyMem_Del()` 을 사용하도록 강제할 수 있습니다." #: ../../footer.rst:46 78ca850d896b41bda3d3e7d7c4795819 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/tutorial.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 af1c872c0c8149488a828ec57db0d05a msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 5f296e40a5a84c7db71c20c23cf034c9 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 PDF(및 기타) 문서의 데이터 추출, 분석, 변환 및 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 6ce8107c629e456a909666cce87fe6bd msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../tutorial.rst:8 939af6d1c28b485eb4ff9f7d7027d32c msgid "Tutorial" msgstr "튜토리얼" #: ../../tutorial.rst:12 4f39e913a37d45aaaae25d581b6b21a5 msgid "" "This tutorial will show you the use of |PyMuPDF|, |MuPDF| in Python, step" " by step." msgstr "이 튜토리얼은 Python에서 |PyMuPDF|, |MuPDF| 사용법을 단계별로 보여줍니다." #: ../../tutorial.rst:14 5a427c507e6b44479862e8eb2c0a69ba msgid "" "Because |MuPDF| supports not only PDF, but also XPS, OpenXPS, CBZ, CBR, " "FB2 and EPUB formats, so does |PyMuPDF| [#f1]_. Nevertheless, for the " "sake of brevity we will only talk about PDF files. At places where indeed" " only PDF files are supported, this will be mentioned explicitly." msgstr "|MuPDF| 가 PDF뿐만 아니라 XPS, OpenXPS, CBZ, CBR, FB2, EPUB 형식도 지원하므로 |PyMuPDF| 도 마찬가지입니다 [#f1]_. 그러나 간결성을 위해 PDF 파일만 다룹니다. PDF 파일만 지원되는 경우에는 명시적으로 언급합니다." #: ../../tutorial.rst:16 b2c324e1eda6484681a5b98002f9f022 msgid "" "In addition to this introduction, please do visit PyMuPDF's `YouTube " "Channel `_ which covers most of the " "following in the form of YouTube \"Shorts\" and longer videos." msgstr "이 소개 외에도 |PyMuPDF| 의 `YouTube 채널 `_ 을 방문하시기 바랍니다. YouTube \"Shorts\" 및 더 긴 비디오 형식으로 대부분의 내용을 다루고 있습니다." #: ../../tutorial.rst:19 c23da3317c5d43fdadba3fa7c99c3afc msgid "Importing the Bindings" msgstr "바인딩 가져오기" #: ../../tutorial.rst:20 a04dcd4a09c3420f950b46d664276cd8 msgid "" "The Python bindings to MuPDF are made available by this import statement." " We also show here how your version can be checked::" msgstr "이 import 문으로 |MuPDF| 에 대한 Python 바인딩을 사용할 수 있습니다. 여기서 버전을 확인하는 방법도 보여줍니다::" #: ../../tutorial.rst:30 56adbb5b22484758912815cc290316d8 msgid "Note on the Name *fitz*" msgstr "*fitz* 이름에 대한 참고사항" #: ../../tutorial.rst:32 3b2a413d1d2040d38bbc841d83f98d16 msgid "" "Old versions of |PyMuPDF| had their **Python** import name as `fitz`. " "Newer versions use `pymupdf` instead, and offer `fitz` as a fallback so " "that old code will still work." msgstr "이전 버전의 |PyMuPDF| 는 **Python** import 이름이 `fitz` 였습니다. 최신 버전은 대신 `pymupdf` 를 사용하며, 이전 코드가 계속 작동하도록 `fitz` 를 대체 옵션으로 제공합니다." #: ../../tutorial.rst:34 e7ad072736bc434da33243355f43a143 msgid "The reason for the name `fitz` is a historical curiosity:" msgstr "`fitz` 라는 이름의 이유는 역사적인 호기심입니다:" #: ../../tutorial.rst:36 0a1388985e214bc8803f67a3cdc99664 msgid "The original rendering library for MuPDF was called *Libart*." msgstr "|MuPDF| 의 원래 렌더링 라이브러리는 *Libart* 라고 불렸습니다." #: ../../tutorial.rst:38 6bb98d1d5fd843a9a823b5a023f389e8 msgid "" "*\"After Artifex Software acquired the MuPDF project, the development " "focus shifted on writing a new modern graphics library called \"Fitz\". " "Fitz was originally intended as an R&D project to replace the aging " "Ghostscript graphics library, but has instead become the rendering engine" " powering MuPDF.\"* (Quoted from `Wikipedia " "`_)." msgstr "*\"Artifex Software가 MuPDF 프로젝트를 인수한 후, 개발 초점은 \"Fitz\"라는 새로운 현대적인 그래픽 라이브러리 작성으로 옮겨졌습니다. Fitz는 원래 노후화된 Ghostscript 그래픽 라이브러리를 대체하기 위한 R&D 프로젝트로 의도되었지만, 대신 MuPDF를 구동하는 렌더링 엔진이 되었습니다.\"* (`Wikipedia `_ 에서 인용)." #: ../../tutorial.rst:42 f0b608072e0948f0a8d5019e86f78ae4 msgid "" "Use of legacy name `fitz` can fail if defunct pypi.org package `fitz` is " "installed; see :ref:`problems-after-installation`." msgstr "사용되지 않는 pypi.org 패키지 `fitz` 가 설치된 경우 레거시 이름 `fitz` 사용이 실패할 수 있습니다. :ref:`problems-after-installation` 을 참조하세요." #: ../../tutorial.rst:48 5b6f4f47d3d14b3dabbafb6419e1bfd3 msgid "Opening a Document" msgstr "문서 열기" #: ../../tutorial.rst:50 bad87b705ed349689aeb233740a2a4dd msgid "" "To access a :ref:`supported document`, it must be " "opened with the following statement::" msgstr ":ref:`지원되는 문서` 에 액세스하려면 다음 문으로 열어야 합니다::" #: ../../tutorial.rst:54 8ee29d11c6664eaba2d74e39fe256992 msgid "" "This creates the :ref:`Document` object *doc*. *filename* must be a " "Python string (or a `pathlib.Path`) specifying the name of an existing " "file." msgstr "이것은 :ref:`Document` 객체 *doc* 을 생성합니다. *filename* 은 기존 파일의 이름을 지정하는 Python 문자열(또는 `pathlib.Path`)이어야 합니다." #: ../../tutorial.rst:56 fd7dc22114c4467ea703f11c5e4ddad9 msgid "" "It is also possible to open a document from memory data, or to create a " "new, empty PDF. See :ref:`Document` for details. You can also use " ":ref:`Document` as a *context manager*." msgstr "메모리 데이터에서 문서를 열거나 새로운 빈 PDF를 생성할 수도 있습니다. 자세한 내용은 :ref:`Document` 를 참조하세요. :ref:`Document` 를 *context manager* 로 사용할 수도 있습니다." #: ../../tutorial.rst:58 e53b2ee3b09744bba7d0a597e3110a06 msgid "" "A document contains many attributes and functions. Among them are meta " "information (like \"author\" or \"subject\"), number of total pages, " "outline and encryption information." msgstr "문서에는 많은 속성과 함수가 포함되어 있습니다. 그 중에는 메타 정보(\"author\" 또는 \"subject\" 등), 총 페이지 수, 개요 및 암호화 정보가 있습니다." #: ../../tutorial.rst:61 ed2d7a85b35c446faacb3600235eef21 msgid "Some :ref:`Document` Methods and Attributes" msgstr "일부 :ref:`Document` 메서드 및 속성" #: ../../tutorial.rst:64 3b4470725538483087f6877a0b238a75 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../tutorial.rst:64 348a919c08be4e7bacbcbdebf6aadceb msgid "**Description**" msgstr "**설명**" #: ../../tutorial.rst:66 3c58bb5e0cfd4357bf595f5730c490f5 msgid ":attr:`Document.page_count`" msgstr ":attr:`Document.page_count`" #: ../../tutorial.rst:66 71bcf48456184a0a864819c5c6c6b639 msgid "the number of pages (*int*)" msgstr "페이지 수 (*int*)" #: ../../tutorial.rst:67 a9ca3bea8587466696f8c3a412c51474 msgid ":attr:`Document.metadata`" msgstr ":attr:`Document.metadata`" #: ../../tutorial.rst:67 5d63c2f5c2bf442da412566cddc8f0da msgid "the metadata (*dict*)" msgstr "메타데이터 (*dict*)" #: ../../tutorial.rst:68 3a230f9d11cf49c8abaabfc21332281a msgid ":meth:`Document.get_toc`" msgstr ":meth:`Document.get_toc`" #: ../../tutorial.rst:68 670c25d439184b3d864535494e4bc345 msgid "get the table of contents (*list*)" msgstr "목차 가져오기 (*list*)" #: ../../tutorial.rst:69 4dbf36bdcc774cfe94f6fe488e23ab70 msgid ":meth:`Document.load_page`" msgstr ":meth:`Document.load_page`" #: ../../tutorial.rst:69 6a5260a61382415882e9d006c179fe90 msgid "read a :ref:`Page`" msgstr ":ref:`Page` 읽기" #: ../../tutorial.rst:73 d6bc5b209b1c4e7aa5b367e616992438 msgid "Accessing Meta Data" msgstr "메타데이터 액세스" #: ../../tutorial.rst:74 5eeb7a67a3834701bda60567079af358 msgid "" "PyMuPDF fully supports standard metadata. :attr:`Document.metadata` is a " "Python dictionary with the following keys. It is available for **all " "document types**, though not all entries may always contain data. For " "details of their meanings and formats consult the respective manuals, " "e.g. :ref:`AdobeManual` for PDF. Further information can also be found in" " chapter :ref:`Document`. The meta data fields are strings or ``None`` if" " not otherwise indicated. Also be aware that not all of them always " "contain meaningful data -- even if they are not ``None``." msgstr "|PyMuPDF| 는 표준 메타데이터를 완전히 지원합니다. :attr:`Document.metadata` 는 다음 키를 가진 Python 딕셔너리입니다. **모든 문서 타입** 에서 사용할 수 있지만, 모든 항목이 항상 데이터를 포함하지는 않을 수 있습니다. 의미와 형식에 대한 자세한 내용은 각 매뉴얼(예: PDF의 경우 :ref:`AdobeManual`)을 참조하세요. 추가 정보는 :ref:`Document` 장에서도 찾을 수 있습니다. 메타데이터 필드는 달리 표시되지 않는 한 문자열 또는 ``None`` 입니다. 또한 모든 필드가 항상 의미 있는 데이터를 포함하는 것은 아니라는 점에 유의하세요. ``None`` 이 아니더라도 그렇습니다." #: ../../tutorial.rst:77 6c9a21d704a241029ce9b7f001b7bac5 msgid "Key" msgstr "키" #: ../../tutorial.rst:77 8400973337594bcf8e3da33817744ccf msgid "Value" msgstr "값" #: ../../tutorial.rst:79 6aa5ce470f8642c4af491e28af8bc999 msgid "producer" msgstr "producer" #: ../../tutorial.rst:79 52ee9d5cf1d94e4e824f1486804c0a49 msgid "producer (producing software)" msgstr "생성자(생성 소프트웨어)" #: ../../tutorial.rst:80 85a0fa96090940f499052abc68aac361 msgid "format" msgstr "format" #: ../../tutorial.rst:80 cd1a7dc5cfca479ca59b0e5e2b00f5bb msgid "format: 'PDF-1.4', 'EPUB', etc." msgstr "형식: 'PDF-1.4', 'EPUB' 등" #: ../../tutorial.rst:81 96773e4fde41492a8fbc9d8e0dfffe01 msgid "encryption" msgstr "encryption" #: ../../tutorial.rst:81 4b242b9f88fb40e4847a8ad0358789ec msgid "encryption method used if any" msgstr "사용된 암호화 방법(있는 경우)" #: ../../tutorial.rst:82 520e1f5cffc3419faccbecacb778ad88 #: adc5542c41534ce68fe9d02192b1f9e0 msgid "author" msgstr "author" #: ../../tutorial.rst:83 d593bfa2f3f1464ca98020a5d8cc2d74 msgid "modDate" msgstr "modDate" #: ../../tutorial.rst:83 49db626a877e41699ba02058512b97d9 msgid "date of last modification" msgstr "마지막 수정 날짜" #: ../../tutorial.rst:84 ac0f4c311d9d4f91b366556afa0eac07 #: cad667882e9247ed9a8465e9e8f6f30e msgid "keywords" msgstr "keywords" #: ../../tutorial.rst:85 4a12c1d082794891871985009346217e #: 9afee53342a24f749bd6b1695ceba4ca msgid "title" msgstr "title" #: ../../tutorial.rst:86 0659f2376ae84f0694559432c6acc6ab msgid "creationDate" msgstr "creationDate" #: ../../tutorial.rst:86 c3e9c7f2af964de1a4ea55d6dfc87ae7 msgid "date of creation" msgstr "생성 날짜" #: ../../tutorial.rst:87 f7336bfddb6c47da8c979a965fd0e200 msgid "creator" msgstr "creator" #: ../../tutorial.rst:87 cde7dc3a8d604edeb4df81869876cc12 msgid "creating application" msgstr "생성 애플리케이션" #: ../../tutorial.rst:88 59f646e95f21440aab80a6d9eaee2cb5 #: dfcc9986b7404e3ea4869973f3300afb msgid "subject" msgstr "subject" #: ../../tutorial.rst:91 e212f47f482f4ba086c347c1ee602818 msgid "" "Apart from these standard metadata, **PDF documents** starting from PDF " "version 1.4 may also contain so-called *\"metadata streams\"* (see also " ":data:`stream`). Information in such streams is coded in XML. PyMuPDF " "deliberately contains no XML components for this purpose (the " ":ref:`PyMuPDF Xml class` is a helper class intended to access the " "DOM content of a :ref:`Story` object), so we do not directly support " "access to information contained therein. But you can extract the stream " "as a whole, inspect or modify it using a package like `lxml`_ and then " "store the result back into the PDF. If you want, you can also delete this" " data altogether." msgstr "이러한 표준 메타데이터 외에도 PDF 버전 1.4부터 시작하는 **PDF 문서** 는 소위 *\"metadata streams\"* (:data:`stream` 도 참조)를 포함할 수도 있습니다. 이러한 스트림의 정보는 XML로 인코딩됩니다. |PyMuPDF| 는 의도적으로 이 목적을 위한 XML 구성 요소를 포함하지 않습니다(:ref:`PyMuPDF Xml class` 는 :ref:`Story` 객체의 DOM 콘텐츠에 액세스하기 위한 헬퍼 클래스입니다). 따라서 그 안에 포함된 정보에 대한 직접 액세스를 지원하지 않습니다. 그러나 스트림 전체를 추출하고 `lxml`_ 같은 패키지를 사용하여 검사하거나 수정한 다음 결과를 PDF에 다시 저장할 수 있습니다. 원하는 경우 이 데이터를 완전히 삭제할 수도 있습니다." #: ../../tutorial.rst:93 5ec202ac5c494be3bf62e68bf5ba28b1 msgid "" "There are two utility scripts in the repository that `metadata import " "(PDF only)`_ resp. `metadata export`_ metadata from resp. to CSV files." msgstr "저장소에는 CSV 파일에서 메타데이터를 가져오거나(`metadata import (PDF only)`_) CSV 파일로 내보내는(`metadata export`_) 두 가지 유틸리티 스크립트가 있습니다." #: ../../tutorial.rst:96 1d31369f6b884d08a61b700b01e9e7b1 msgid "Working with Outlines" msgstr "개요 작업" #: ../../tutorial.rst:97 fe8e22242a324f349fca363f8d0f6348 msgid "" "The easiest way to get all outlines (also called \"bookmarks\") of a " "document, is by loading its *table of contents*::" msgstr "문서의 모든 개요(\"bookmarks\"라고도 함)를 가져오는 가장 쉬운 방법은 *목차* 를 로드하는 것입니다::" #: ../../tutorial.rst:101 4fe54a9ca0244cd9871ba72a155cbe95 msgid "" "This will return a Python list of lists *[[lvl, title, page, ...], ...]* " "which looks much like a conventional table of contents found in books." msgstr "이것은 책에서 볼 수 있는 일반적인 목차와 매우 유사한 Python 리스트의 리스트 *[[lvl, title, page, ...], ...]* 를 반환합니다." #: ../../tutorial.rst:103 a0df1526a42e4d88bf1fb24bf14c2392 msgid "" "*lvl* is the hierarchy level of the entry (starting from 1), *title* is " "the entry's title, and *page* the page number (1-based!). Other " "parameters describe details of the bookmark target." msgstr "*lvl* 은 항목의 계층 레벨(1부터 시작), *title* 은 항목의 제목, *page* 는 페이지 번호(1 기반!)입니다. 다른 매개변수는 북마크 대상의 세부 정보를 설명합니다." #: ../../tutorial.rst:105 f60efb5302364edfb64c7775c185929b msgid "" "There are two utility scripts in the repository that `toc import (PDF " "only)`_ resp. `toc export`_ table of contents from resp. to CSV files." msgstr "저장소에는 CSV 파일에서 목차를 가져오거나(`toc import (PDF only)`_) CSV 파일로 내보내는(`toc export`_) 두 가지 유틸리티 스크립트가 있습니다." #: ../../tutorial.rst:108 f7e0d8ac5cd64bbfb19d5a7680f37840 msgid "Working with Pages" msgstr "페이지 작업" #: ../../tutorial.rst:109 bea68ab57a6a4ec49fa98a57625daec3 msgid ":ref:`Page` handling is at the core of MuPDF's functionality." msgstr ":ref:`Page` 처리는 |MuPDF| 기능의 핵심입니다." #: ../../tutorial.rst:111 705fbd37cfd04f5eb2725ee74973716c msgid "" "You can render a page into a raster or vector (SVG) image, optionally " "zooming, rotating, shifting or shearing it." msgstr "페이지를 래스터 또는 벡터(SVG) 이미지로 렌더링할 수 있으며, 선택적으로 확대/축소, 회전, 이동 또는 기울이기를 할 수 있습니다." #: ../../tutorial.rst:112 07346e73ca2f4851bcb7243ed707f0c5 msgid "" "You can extract a page's text and images in many formats and search for " "text strings." msgstr "페이지의 텍스트와 이미지를 여러 형식으로 추출하고 텍스트 문자열을 검색할 수 있습니다." #: ../../tutorial.rst:113 b10390460b7e469d933d4b0bca64cbd8 msgid "" "For PDF documents many more methods are available to add text or images " "to pages." msgstr "PDF 문서의 경우 페이지에 텍스트나 이미지를 추가하는 더 많은 메서드를 사용할 수 있습니다." #: ../../tutorial.rst:115 634af7e840c34aba910ebc8b50aac6b1 msgid "" "First, a :ref:`Page` must be created. This is a method of " ":ref:`Document`::" msgstr "먼저 :ref:`Page` 를 생성해야 합니다. 이것은 :ref:`Document` 의 메서드입니다::" #: ../../tutorial.rst:120 e13781020ec34c48a1d29405c5d4063b msgid "" "Any integer `-∞ < pno < page_count` is possible here. Negative numbers " "count backwards from the end, so *doc[-1]* is the last page, like with " "Python sequences." msgstr "여기서는 `-∞ < pno < page_count` 범위의 정수가 가능합니다. 음수는 끝에서 역순으로 계산되므로 Python 시퀀스와 같이 *doc[-1]* 은 마지막 페이지입니다." #: ../../tutorial.rst:122 4e28316907e444489cfbf10a12e27bba msgid "" "Some more advanced way would be using the document as an **iterator** " "over its pages::" msgstr "더 고급 방법은 문서를 페이지에 대한 **반복자** 로 사용하는 것입니다::" #: ../../tutorial.rst:136 84e73234fd424852a2b36c0bc15b2d9d msgid "Once you have your page, here is what you would typically do with it:" msgstr "페이지를 얻으면 일반적으로 다음과 같은 작업을 수행합니다:" #: ../../tutorial.rst:139 088737b71af34948b17fbe30a60a9dc4 msgid "Inspecting the Links, Annotations or Form Fields of a Page" msgstr "페이지의 링크, 주석 또는 양식 필드 검사" #: ../../tutorial.rst:140 80600b8ed5664159a8aad4e5b6706037 msgid "" "Links are shown as \"hot areas\" when a document is displayed with some " "viewer software. If you click while your cursor shows a hand symbol, you " "will usually be taken to the target that is encoded in that hot area. " "Here is how to get all links::" msgstr "링크는 문서가 뷰어 소프트웨어로 표시될 때 \"hot areas\"로 표시됩니다. 커서가 손 기호를 표시하는 동안 클릭하면 일반적으로 해당 hot area에 인코딩된 대상으로 이동합니다. 모든 링크를 가져오는 방법은 다음과 같습니다::" #: ../../tutorial.rst:145 5b90391005b24d46b953ffde747dbd80 msgid "" "*links* is a Python list of dictionaries. For details see " ":meth:`Page.get_links`." msgstr "*links* 는 딕셔너리의 Python 리스트입니다. 자세한 내용은 :meth:`Page.get_links` 를 참조하세요." #: ../../tutorial.rst:147 19b388140fd44ace88779d4d2f85e3f5 msgid "You can also use an iterator which emits one link at a time::" msgstr "한 번에 하나의 링크를 생성하는 반복자를 사용할 수도 있습니다::" #: ../../tutorial.rst:152 972adb409c6b4d1781d1976cb040f944 msgid "" "If dealing with a PDF document page, there may also exist annotations " "(:ref:`Annot`) or form fields (:ref:`Widget`), each of which have their " "own iterators::" msgstr "PDF 문서 페이지를 다루는 경우 주석(:ref:`Annot`) 또는 양식 필드(:ref:`Widget`)가 있을 수도 있으며, 각각 고유한 반복자를 가집니다::" #: ../../tutorial.rst:162 354960511fbd4e299b3561f27464ffa6 msgid "Rendering a Page" msgstr "페이지 렌더링" #: ../../tutorial.rst:163 4b29e0e4b9f04b54a4b12db45462cebe msgid "This example creates a **raster** image of a page's content::" msgstr "이 예제는 페이지 콘텐츠의 **래스터** 이미지를 생성합니다::" #: ../../tutorial.rst:167 b23c4b5d3b5345f0add5cb0dffaa6255 msgid "" "``pix`` is a :ref:`Pixmap` object which (in this case) contains an " "**RGB** image of the page, ready to be used for many purposes. Method " ":meth:`Page.get_pixmap` offers lots of variations for controlling the " "image: resolution / DPI, colorspace (e.g. to produce a grayscale image or" " an image with a subtractive color scheme), transparency, rotation, " "mirroring, shifting, shearing, etc. For example: to create an **RGBA** " "image (i.e. containing an alpha channel), specify *pix = " "page.get_pixmap(alpha=True)*." msgstr "``pix`` 는 (이 경우) 페이지의 **RGB** 이미지를 포함하는 :ref:`Pixmap` 객체로, 다양한 용도로 사용할 준비가 되어 있습니다. :meth:`Page.get_pixmap` 메서드는 이미지를 제어하기 위한 많은 변형을 제공합니다: 해상도/DPI, 색 공간(예: 그레이스케일 이미지 또는 감산 색상 체계의 이미지 생성), 투명도, 회전, 미러링, 이동, 기울이기 등. 예를 들어: **RGBA** 이미지(즉, 알파 채널 포함)를 생성하려면 *pix = page.get_pixmap(alpha=True)* 를 지정하세요." #: ../../tutorial.rst:169 e2331fb68ff848cab6245b27ba5f4079 msgid "" "A :ref:`Pixmap` contains a number of methods and attributes which are " "referenced below. Among them are the integers ``width``, ``height`` (each" " in pixels) and ``stride`` (number of bytes of one horizontal image " "line). Attribute ``samples`` represents a rectangular area of bytes " "representing the image data (a Python ``bytes`` object)." msgstr ":ref:`Pixmap` 은 아래에서 참조되는 많은 메서드와 속성을 포함합니다. 그 중에는 정수 ``width``, ``height`` (각각 픽셀 단위) 및 ``stride`` (한 수평 이미지 라인의 바이트 수)가 있습니다. 속성 ``samples`` 는 이미지 데이터를 나타내는 바이트의 사각형 영역(Python ``bytes`` 객체)을 나타냅니다." #: ../../tutorial.rst:171 03e8c67cd34a4299bbacfe8abd40de63 msgid "" "You can also create a **vector** image of a page by using " ":meth:`Page.get_svg_image`. Refer to this `Vector Image Support page`_ " "for details." msgstr ":meth:`Page.get_svg_image` 를 사용하여 페이지의 **벡터** 이미지를 생성할 수도 있습니다. 자세한 내용은 `Vector Image Support page`_ 를 참조하세요." #: ../../tutorial.rst:174 c887d409be174ceca947d6b32e881d03 msgid "Saving the Page Image in a File" msgstr "파일에 페이지 이미지 저장" #: ../../tutorial.rst:175 5e39659faf42451083abd892ba3bdb4e msgid "We can simply store the image in a PNG file::" msgstr "이미지를 PNG 파일에 간단히 저장할 수 있습니다::" #: ../../tutorial.rst:180 7ef7b19218354906a6c5d511a0672a1f msgid "Displaying the Image in GUIs" msgstr "GUI에서 이미지 표시" #: ../../tutorial.rst:181 f6651c84f3d54689abdaff0d00a3095e msgid "" "We can also use it in GUI dialog managers. :attr:`Pixmap.samples` " "represents an area of bytes of all the pixels as a Python bytes object. " "Here are some examples, find more in the `examples`_ directory." msgstr "GUI 대화 상자 관리자에서도 사용할 수 있습니다. :attr:`Pixmap.samples` 는 모든 픽셀의 바이트 영역을 Python bytes 객체로 나타냅니다. 다음은 몇 가지 예입니다. `examples`_ 디렉토리에서 더 많은 예를 찾을 수 있습니다." #: ../../tutorial.rst:184 93b0ff029516467ca4a36bb526aeb687 msgid "wxPython" msgstr "wxPython" #: ../../tutorial.rst:185 6f03843027834dda8394ee85d04238d5 msgid "" "Consult their documentation for adjustments to RGB(A) pixmaps and, " "potentially, specifics for your wxPython release::" msgstr "RGB(A) pixmap 조정 및 wxPython 릴리스별 세부 사항에 대해서는 해당 문서를 참조하세요::" #: ../../tutorial.rst:193 b6f1e9b15675411e9bd7023777e4b99a msgid "Tkinter" msgstr "Tkinter" #: ../../tutorial.rst:194 c11e72b65c0e4368a0fe00c748909105 msgid "Please also see section 3.19 of the `Pillow documentation`_::" msgstr "`Pillow documentation`_ 의 섹션 3.19도 참조하세요::" #: ../../tutorial.rst:203 41e53493133b4606b75fc48aa4b02d6b msgid "The following **avoids using Pillow**::" msgstr "다음은 **Pillow 사용을 피합니다**::" #: ../../tutorial.rst:210 2d36aa26bccf4e5ba49ede95aef20a49 msgid "" "If you are looking for a complete Tkinter script paging through **any " "supported** document, `here it is!`_. It can also zoom into pages, and it" " runs under Python 2 or 3. It requires the extremely handy `PySimpleGUI`_" " pure Python package." msgstr "**지원되는 모든** 문서를 페이지로 나누는 완전한 Tkinter 스크립트를 찾고 있다면 `여기 있습니다!`_. 페이지 확대도 가능하며 Python 2 또는 3에서 실행됩니다. 매우 편리한 `PySimpleGUI`_ 순수 Python 패키지가 필요합니다." #: ../../tutorial.rst:213 9a88cb97b2d9452ab197250569501e5f msgid "PyQt4, PyQt5, PySide" msgstr "PyQt4, PyQt5, PySide" #: ../../tutorial.rst:214 daeac83261ba4066a7dc604d3aa562f2 msgid "Please also see section 3.16 of the `Pillow documentation`_::" msgstr "`Pillow documentation`_ 의 섹션 3.16도 참조하세요::" #: ../../tutorial.rst:223 b85add3e93e4499b89e82f1646430a26 msgid "" "Again, you also can get along **without using Pillow.** Qt's `QImage` " "luckily supports native Python pointers, so the following is the " "recommended way to create Qt images::" msgstr "다시 말하지만, **Pillow를 사용하지 않고도** 진행할 수 있습니다. Qt의 `QImage` 는 다행히 네이티브 Python 포인터를 지원하므로 다음은 Qt 이미지를 생성하는 권장 방법입니다::" #: ../../tutorial.rst:233 0fcb7bc54009424fa20575e22fb06d0e msgid "Extracting Text and Images" msgstr "텍스트 및 이미지 추출" #: ../../tutorial.rst:234 f5900cc6c4924334a0f4bf4d1bdae4ae msgid "" "We can also extract all text, images and other information of a page in " "many different forms, and levels of detail::" msgstr "페이지의 모든 텍스트, 이미지 및 기타 정보를 다양한 형식과 세부 수준으로 추출할 수도 있습니다::" #: ../../tutorial.rst:238 48bff694040b45549010d3b53435733b msgid "" "Use one of the following strings for *opt* to obtain different formats " "[#f2]_:" msgstr "다양한 형식을 얻으려면 *opt* 에 다음 문자열 중 하나를 사용하세요 [#f2]_:" #: ../../tutorial.rst:240 3c9203fe338a46629695295936dc44a4 msgid "" "**\"text\"**: (default) plain text with line breaks. No formatting, no " "text position details, no images." msgstr "**\"text\"**: (기본값) 줄바꿈이 있는 일반 텍스트. 서식 없음, 텍스트 위치 세부 정보 없음, 이미지 없음." #: ../../tutorial.rst:242 ef523faacbb4433e9599b78451f9a623 msgid "**\"blocks\"**: generate a list of text blocks (= paragraphs)." msgstr "**\"blocks\"**: 텍스트 블록(= 단락) 목록 생성." #: ../../tutorial.rst:244 494f2cbaf4dc4d3595b54a18d8165a4f msgid "**\"words\"**: generate a list of words (strings not containing spaces)." msgstr "**\"words\"**: 단어 목록 생성(공백을 포함하지 않는 문자열)." #: ../../tutorial.rst:246 f95d696f7efa4e48a4fe4018638ee139 msgid "" "**\"html\"**: creates a full visual version of the page including any " "images. This can be displayed with your internet browser." msgstr "**\"html\"**: 이미지를 포함한 페이지의 전체 시각적 버전 생성. 인터넷 브라우저로 표시할 수 있습니다." #: ../../tutorial.rst:248 8f24748d78b04cc6b92c29fcae8ff8ca msgid "" "**\"dict\"** / **\"json\"**: same information level as HTML, but provided" " as a Python dictionary or resp. JSON string. See " ":meth:`TextPage.extractDICT` for details of its structure." msgstr "**\"dict\"** / **\"json\"**: HTML과 동일한 정보 수준이지만 Python 딕셔너리 또는 JSON 문자열로 제공됩니다. 구조에 대한 자세한 내용은 :meth:`TextPage.extractDICT` 를 참조하세요." #: ../../tutorial.rst:250 266283a205584bb98dd88e0282b81b8a msgid "" "**\"rawdict\"** / **\"rawjson\"**: a super-set of **\"dict\"** / " "**\"json\"**. It additionally provides character detail information like " "XML. See :meth:`TextPage.extractRAWDICT` for details of its structure." msgstr "**\"rawdict\"** / **\"rawjson\"**: **\"dict\"** / **\"json\"** 의 상위 집합. XML과 같은 문자 세부 정보를 추가로 제공합니다. 구조에 대한 자세한 내용은 :meth:`TextPage.extractRAWDICT` 를 참조하세요." #: ../../tutorial.rst:252 be5015a7daf84be89659b718295dcaf6 msgid "" "**\"xhtml\"**: text information level as the TEXT version but includes " "images. Can also be displayed by internet browsers." msgstr "**\"xhtml\"**: TEXT 버전과 동일한 텍스트 정보 수준이지만 이미지를 포함합니다. 인터넷 브라우저로도 표시할 수 있습니다." #: ../../tutorial.rst:254 6a9fccccc2af470dbe418b64d95196fb msgid "" "**\"xml\"**: contains no images, but full position and font information " "down to each single text character. Use an XML module to interpret." msgstr "**\"xml\"**: 이미지는 포함하지 않지만 각 단일 텍스트 문자까지 전체 위치 및 글꼴 정보를 포함합니다. XML 모듈을 사용하여 해석합니다." #: ../../tutorial.rst:256 c2fb29629d574544ba6240118706a993 msgid "" "To give you an idea about the output of these alternatives, we did text " "example extracts. See :ref:`Appendix1`." msgstr "이러한 대안의 출력에 대한 아이디어를 제공하기 위해 텍스트 예제 추출을 수행했습니다. :ref:`Appendix1` 을 참조하세요." #: ../../tutorial.rst:259 6fcbe8fa549f4672940aa6a7baa43298 msgid "Searching for Text" msgstr "텍스트 검색" #: ../../tutorial.rst:260 055f0da706d34efba1868870cc7ac25e msgid "You can find out, exactly where on a page a certain text string appears::" msgstr "페이지에서 특정 텍스트 문자열이 정확히 어디에 나타나는지 확인할 수 있습니다::" #: ../../tutorial.rst:264 fa6460b021d44b8aba602b1940777f99 msgid "" "This delivers a list of rectangles (see :ref:`Rect`), each of which " "surrounds one occurrence of the string \"mupdf\" (case insensitive). You " "could use this information to e.g. highlight those areas (PDF only) or " "create a cross reference of the document." msgstr "이것은 사각형 목록(:ref:`Rect` 참조)을 제공하며, 각각은 문자열 \"mupdf\" 의 한 번 발생을 둘러쌉니다(대소문자 구분 안 함). 이 정보를 사용하여 예를 들어 해당 영역을 강조 표시하거나(PDF만) 문서의 상호 참조를 생성할 수 있습니다." #: ../../tutorial.rst:266 9602ff0fbee54febb5a9bce0eb7643a8 msgid "" "Please also do have a look at chapter :ref:`cooperation` and at demo " "programs `demo.py`_ and `demo-lowlevel.py`_. Among other things they " "contain details on how the :ref:`TextPage`, :ref:`Device` and " ":ref:`DisplayList` classes can be used for a more direct control, e.g. " "when performance considerations suggest it." msgstr ":ref:`cooperation` 장과 데모 프로그램 `demo.py`_ 및 `demo-lowlevel.py`_ 도 살펴보세요. 특히 성능 고려 사항이 제안될 때 :ref:`TextPage`, :ref:`Device` 및 :ref:`DisplayList` 클래스를 더 직접적으로 제어하는 방법에 대한 세부 정보를 포함합니다." #: ../../tutorial.rst:273 d532b1e3d0b249d5863b7d1af292f56f msgid "Stories: Generating PDF from HTML Source" msgstr "Stories: HTML 소스에서 PDF 생성" #: ../../tutorial.rst:275 416352710d134781921a3400fd5b5ef0 msgid "" "The :ref:`Story` class is a new feature of PyMuPDF version 1.21.0. It " "represents support for MuPDF's **\"story\"** interface." msgstr ":ref:`Story` 클래스는 |PyMuPDF| 버전 1.21.0의 새로운 기능입니다. |MuPDF| 의 **\"story\"** 인터페이스 지원을 나타냅니다." #: ../../tutorial.rst:277 accd3e3fc6d547b78b274237642033d6 msgid "" "The following is a quote from the book `\"MuPDF Explored\"`_ by Robin " "Watts from `Artifex`_:" msgstr "다음은 `Artifex`_ 의 Robin Watts가 쓴 `\"MuPDF Explored\"`_ 책에서 인용한 내용입니다:" #: ../../tutorial.rst:281 47e500970eb842949a968db6adee0910 msgid "" "*Stories provide a way to easily layout styled content for use with " "devices, such as those offered by Document Writers (...). The concept of " "a story comes from desktop publishing, which in turn (...) gets it from " "newspapers. If you consider a traditional newspaper layout, it will " "consist of various news articles (stories) that are laid out into " "multiple columns, possibly across multiple pages.*" msgstr "*Stories는 Document Writers가 제공하는 것과 같은 장치에서 사용할 수 있도록 스타일이 지정된 콘텐츠를 쉽게 레이아웃하는 방법을 제공합니다(...). story의 개념은 데스크톱 출판에서 나왔으며, 이는 차례로(...) 신문에서 가져온 것입니다. 전통적인 신문 레이아웃을 고려하면 여러 열로 배치되고 여러 페이지에 걸칠 수 있는 다양한 뉴스 기사(stories)로 구성됩니다.*" #: ../../tutorial.rst:283 27ebf650cfb746b6ae9e42bdde508478 msgid "" "*Accordingly, MuPDF uses a story to represent a flow of text with styling" " information. The user of the story can then supply a sequence of " "rectangles into which the story will be laid out, and the positioned text" " can then be drawn to an output device. This keeps the concept of the " "text itself (the story) to be separated from the areas into which the " "text should be flowed (the layout).*" msgstr "*따라서 |MuPDF| 는 스타일 정보가 있는 텍스트 흐름을 나타내기 위해 story를 사용합니다. story 사용자는 story가 배치될 사각형 시퀀스를 제공할 수 있으며, 배치된 텍스트는 출력 장치에 그려질 수 있습니다. 이것은 텍스트 자체(story)의 개념을 텍스트가 흐를 영역(레이아웃)과 분리된 상태로 유지합니다.*" #: ../../tutorial.rst:287 7da64d937fe84390a33b56158c76d219 msgid "" "A Story works somewhat similar to an internet browser: It faithfully " "parses and renders HTML hypertext and also optional stylesheets (CSS). " "But its **output is a PDF** -- not web pages." msgstr "Story는 인터넷 브라우저와 다소 유사하게 작동합니다: HTML 하이퍼텍스트와 선택적 스타일시트(CSS)를 충실하게 구문 분석하고 렌더링합니다. 그러나 **출력은 PDF** 입니다. 웹 페이지가 아닙니다." #: ../../tutorial.rst:290 290d5414b6754a0a8cec4ef553811e70 msgid "" "When creating a :ref:`Story`, the input from up to three different " "information sources is taken into account. All these items are optional." msgstr ":ref:`Story` 를 생성할 때 최대 세 가지 다른 정보 소스의 입력이 고려됩니다. 이러한 항목은 모두 선택 사항입니다." #: ../../tutorial.rst:292 b76811f3a6e94ca48849af027b1e4aa7 msgid "" "HTML source code, either a Python string or **created by the script** " "using methods of :ref:`Xml`." msgstr "HTML 소스 코드, Python 문자열이거나 :ref:`Xml` 의 메서드를 사용하여 **스크립트로 생성된** 것." #: ../../tutorial.rst:294 631005d36d9d478eb1222c6746a62f78 msgid "" "CSS (Cascaded Style Sheet) source code, provided as a Python string. CSS " "can be used to provide styling information (text font size, color, etc.) " "like it would happen for web pages. Obviously, this string may also be " "read from a file." msgstr "CSS(Cascaded Style Sheet) 소스 코드, Python 문자열로 제공됩니다. CSS는 웹 페이지에서와 같이 스타일 정보(텍스트 글꼴 크기, 색상 등)를 제공하는 데 사용할 수 있습니다. 명백히 이 문자열은 파일에서 읽을 수도 있습니다." #: ../../tutorial.rst:296 b555903aaf064df4ac02bf4379ecd84b msgid "" "An :ref:`Archive` **must be used** whenever the DOM references images, or" " uses text fonts except the standard :ref:`Base-14-Fonts`, CJK fonts and " "the NOTO fonts generated into the PyMuPDF binary." msgstr "DOM이 이미지를 참조하거나 표준 :ref:`Base-14-Fonts`, CJK 글꼴 및 |PyMuPDF| 바이너리에 생성된 NOTO 글꼴을 제외한 텍스트 글꼴을 사용할 때마다 :ref:`Archive` **를 사용해야 합니다**." #: ../../tutorial.rst:299 5a5a7775caf44157ab99d4fb18a08da0 msgid "" "The :ref:`API` allows creating DOMs completely from scratch, " "including desired styling information. It can also be used to modify or " "extend **provided** HTML: text can be deleted or replaced, or its styling" " can be changed. Text -- for example extracted from databases -- can also" " be added and fill template-like HTML documents." msgstr ":ref:`API` 는 원하는 스타일 정보를 포함하여 처음부터 DOM을 생성할 수 있게 합니다. 또한 **제공된** HTML을 수정하거나 확장하는 데 사용할 수 있습니다: 텍스트를 삭제하거나 교체하거나 스타일을 변경할 수 있습니다. 데이터베이스에서 추출한 것과 같은 텍스트도 추가하고 템플릿과 같은 HTML 문서를 채울 수 있습니다." #: ../../tutorial.rst:301 eff1f356f57a4a5baa32893df82ccc7f msgid "" "It is **not required** to provide syntactically complete HTML documents: " "snippets like `Hello World!` are fully accepted, and many /" " most syntax errors are automatically corrected." msgstr "구문적으로 완전한 HTML 문서를 제공할 **필요는 없습니다**: `Hello World!` 와 같은 스니펫이 완전히 허용되며 많은/대부분의 구문 오류가 자동으로 수정됩니다." #: ../../tutorial.rst:303 365fa2cc06434ed8ad7429aaf3a63265 msgid "" "After the HTML is considered complete, it can be used to create a PDF " "document. This happens via the new :ref:`DocumentWriter` class. The " "programmer calls its methods to create a new empty page, and passes " "rectangles to the Story to fill them." msgstr "HTML이 완료된 것으로 간주되면 PDF 문서를 생성하는 데 사용할 수 있습니다. 이것은 새로운 :ref:`DocumentWriter` 클래스를 통해 수행됩니다. 프로그래머는 메서드를 호출하여 새로운 빈 페이지를 만들고 Story에 사각형을 전달하여 채웁니다." #: ../../tutorial.rst:305 3291ca47108e47b19f4b0bc0a5a4027b msgid "" "The story in turn will return completion codes indicating whether or not " "more content is waiting to be written. Which part of the content will " "land in which rectangle or on which page is automatically determined by " "the story itself -- it cannot be influenced other than by providing the " "rectangles." msgstr "story는 차례로 더 많은 콘텐츠가 작성되기를 기다리고 있는지 여부를 나타내는 완료 코드를 반환합니다. 콘텐츠의 어느 부분이 어떤 사각형이나 어떤 페이지에 배치될지는 story 자체에 의해 자동으로 결정됩니다. 사각형을 제공하는 것 외에는 영향을 줄 수 없습니다." #: ../../tutorial.rst:307 bd9d9dd769be42d4b2431ad4fac946e4 msgid "" "Please see the :ref:`Stories recipes` for a number of " "typical use cases." msgstr "일반적인 사용 사례는 :ref:`Stories recipes` 를 참조하세요." #: ../../tutorial.rst:311 b4514f2b40064533bbf026420a0260d7 msgid "PDF Maintenance" msgstr "PDF 유지보수" #: ../../tutorial.rst:312 76f8cae636954def812f6bd6aa4d9077 msgid "" "PDFs are the only document type that can be **modified** using PyMuPDF. " "Other file types are read-only." msgstr "PDF는 |PyMuPDF| 를 사용하여 **수정** 할 수 있는 유일한 문서 타입입니다. 다른 파일 타입은 읽기 전용입니다." #: ../../tutorial.rst:314 6d192d43c9e24232be29c65e1e0c1018 msgid "" "However, you can convert **any document** (including images) to a PDF and" " then apply all PyMuPDF features to the conversion result. Find out more " "here :meth:`Document.convert_to_pdf`, and also look at the demo script " "`pdf-converter.py`_ which can convert any :ref:`supported " "document` to PDF." msgstr "그러나 **모든 문서** (이미지 포함)를 PDF로 변환한 다음 변환 결과에 모든 |PyMuPDF| 기능을 적용할 수 있습니다. 자세한 내용은 :meth:`Document.convert_to_pdf` 를 참조하고, 모든 :ref:` 지원되는 문서` 를 PDF로 변환할 수 있는 데모 스크립트 `pdf-converter.py`_ 도 살펴보세요." #: ../../tutorial.rst:316 05d7bbe4027a4e9b98372c4707c22cd4 msgid "" ":meth:`Document.save()` always stores a PDF in its current (potentially " "modified) state on disk." msgstr ":meth:`Document.save()` 는 항상 PDF를 현재(잠재적으로 수정된) 상태로 디스크에 저장합니다." #: ../../tutorial.rst:318 400c516b51f0441a9c6ac7d433101329 msgid "" "You normally can choose whether to save to a new file, or just append " "your modifications to the existing one (\"incremental save\"), which " "often is very much faster." msgstr "일반적으로 새 파일에 저장할지 또는 기존 파일에 수정 사항만 추가할지(\"incremental save\") 선택할 수 있으며, 후자가 종종 훨씬 빠릅니다." #: ../../tutorial.rst:320 57fdfcd11a1245249d7e837f37b43094 msgid "" "The following describes ways how you can manipulate PDF documents. This " "description is by no means complete: much more can be found in the " "following chapters." msgstr "다음은 PDF 문서를 조작하는 방법을 설명합니다. 이 설명은 결코 완전하지 않습니다. 다음 장에서 더 많은 내용을 찾을 수 있습니다." #: ../../tutorial.rst:323 ec4c85ec57124203b67f52652f082b88 msgid "Modifying, Creating, Re-arranging and Deleting Pages" msgstr "페이지 수정, 생성, 재배열 및 삭제" #: ../../tutorial.rst:324 625ab390c172404fbdc7aa9520874495 msgid "" "There are several ways to manipulate the so-called **page tree** (a " "structure describing all the pages) of a PDF:" msgstr "PDF의 소위 **페이지 트리** (모든 페이지를 설명하는 구조)를 조작하는 여러 방법이 있습니다:" #: ../../tutorial.rst:326 159259eb9e4145daa6c13b2ad767f12e msgid "" ":meth:`Document.delete_page` and :meth:`Document.delete_pages` delete " "pages." msgstr ":meth:`Document.delete_page` 및 :meth:`Document.delete_pages` 는 페이지를 삭제합니다." #: ../../tutorial.rst:328 473d5897fff649019f539d6232e91f44 msgid "" ":meth:`Document.copy_page`, :meth:`Document.fullcopy_page` and " ":meth:`Document.move_page` copy or move a page to other locations within " "the same document." msgstr ":meth:`Document.copy_page`, :meth:`Document.fullcopy_page` 및 :meth:`Document.move_page` 는 페이지를 같은 문서 내의 다른 위치로 복사하거나 이동합니다." #: ../../tutorial.rst:330 1e6c19e64c734426bec58da4dfbe7e0b msgid "" ":meth:`Document.select` shrinks a PDF down to selected pages. Parameter " "is a sequence [#f3]_ of the page numbers that you want to keep. These " "integers must all be in range *0 <= i < page_count*. When executed, all " "pages **missing** in this list will be deleted. Remaining pages will " "occur **in the sequence and as many times (!) as you specify them**." msgstr ":meth:`Document.select` 는 PDF를 선택한 페이지로 축소합니다. 매개변수는 유지하려는 페이지 번호의 시퀀스 [#f3]_ 입니다. 이러한 정수는 모두 *0 <= i < page_count* 범위에 있어야 합니다. 실행되면 이 목록에 **없는** 모든 페이지가 삭제됩니다. 남은 페이지는 **시퀀스에서 지정한 횟수만큼(!) 나타납니다**." #: ../../tutorial.rst:332 1032d54636274cfab2c769409afa76e0 msgid "So you can easily create new PDFs with" msgstr "따라서 다음과 같은 새 PDF를 쉽게 만들 수 있습니다:" #: ../../tutorial.rst:334 e8415caf00594110bef2b948c89abcbd msgid "the first or last 10 pages," msgstr "처음 또는 마지막 10페이지," #: ../../tutorial.rst:335 fc336f721207413b95dce987329adfad msgid "only the odd or only the even pages (for doing double-sided printing)," msgstr "홀수 페이지만 또는 짝수 페이지만(양면 인쇄용)," #: ../../tutorial.rst:336 3a6929bd1e7d4e178ef1549c9c67d87a msgid "pages that **do** or **don't** contain a given text," msgstr "주어진 텍스트를 **포함하는** 또는 **포함하지 않는** 페이지," #: ../../tutorial.rst:337 968ba746356447208207a1cee391ea52 msgid "reverse the page sequence, ..." msgstr "페이지 시퀀스 반전, ..." #: ../../tutorial.rst:339 1c2ed724e9564be1a8841011462e53a1 msgid "... whatever you can think of." msgstr "... 생각할 수 있는 모든 것." #: ../../tutorial.rst:341 3a7dc1aa206e4858a930d0cc0ce437cf msgid "" "The saved new document will contain links, annotations and bookmarks that" " are still valid (i.a.w. either pointing to a selected page or to some " "external resource)." msgstr "저장된 새 문서는 여전히 유효한 링크, 주석 및 북마크를 포함합니다(즉, 선택한 페이지 또는 일부 외부 리소스를 가리킴)." #: ../../tutorial.rst:343 62273df02f3a43edaca93b7b9899b551 msgid "" ":meth:`Document.insert_page` and :meth:`Document.new_page` insert new " "pages." msgstr ":meth:`Document.insert_page` 및 :meth:`Document.new_page` 는 새 페이지를 삽입합니다." #: ../../tutorial.rst:345 62ec5bdcc4854cc0ab7b5a9c5de8295e msgid "" "Pages themselves can moreover be modified by a range of methods (e.g. " "page rotation, annotation and link maintenance, text and image " "insertion)." msgstr "페이지 자체는 다양한 메서드(예: 페이지 회전, 주석 및 링크 유지보수, 텍스트 및 이미지 삽입)로 수정할 수 있습니다." #: ../../tutorial.rst:348 f481a1f85523458ba716bfffa017ecc2 msgid "Joining and Splitting PDF Documents" msgstr "PDF 문서 결합 및 분할" #: ../../tutorial.rst:350 5c4f9e715c364f99ab85e02a35390a54 msgid "" "Method :meth:`Document.insert_pdf` copies pages **between different** PDF" " documents. Here is a simple **joiner** example (*doc1* and *doc2* being " "opened PDFs)::" msgstr ":meth:`Document.insert_pdf` 메서드는 **다른** PDF 문서 간에 페이지를 복사합니다. 다음은 간단한 **결합** 예제입니다(*doc1* 및 *doc2* 는 열린 PDF)::" #: ../../tutorial.rst:355 76e1ca6378be4c7780b008c6aa0147b1 msgid "" "Here is a snippet that **splits** *doc1*. It creates a new document of " "its first and its last 10 pages::" msgstr "다음은 *doc1* 을 **분할** 하는 스니펫입니다. 처음 10페이지와 마지막 10페이지로 새 문서를 만듭니다::" #: ../../tutorial.rst:362 425d928677684aaebd2c13acc306cc3a msgid "" "More can be found in the :ref:`Document` chapter. Also have a look at " "`PDFjoiner.py`_." msgstr "더 많은 내용은 :ref:`Document` 장에서 찾을 수 있습니다. `PDFjoiner.py`_ 도 살펴보세요." #: ../../tutorial.rst:365 3a32f81f55af4ff2942e6a5bda5351e4 msgid "Embedding Data" msgstr "데이터 임베딩" #: ../../tutorial.rst:367 e8c1a07274464e69b5716d2cfcd333a2 msgid "" "PDFs can be used as containers for arbitrary data (executables, other " "PDFs, text or binary files, etc.) much like ZIP archives." msgstr "PDF는 ZIP 아카이브와 매우 유사하게 임의의 데이터(실행 파일, 다른 PDF, 텍스트 또는 바이너리 파일 등)의 컨테이너로 사용할 수 있습니다." #: ../../tutorial.rst:369 e53116859c304e5d8cae52bca7615d49 msgid "" "PyMuPDF fully supports this feature via :ref:`Document` ``embfile_*`` " "methods and attributes. For some detail read :ref:`Appendix 3`, consult " "the Wiki on `dealing with embedding files`_, or the example scripts " "`embedded-copy.py`_, `embedded-export.py`_, `embedded-import.py`_, and " "`embedded-list.py`_." msgstr "|PyMuPDF| 는 :ref:`Document` ``embfile_*`` 메서드 및 속성을 통해 이 기능을 완전히 지원합니다. 자세한 내용은 :ref:`Appendix 3` 을 읽거나, `dealing with embedding files`_ 에 대한 Wiki를 참조하거나, 예제 스크립트 `embedded-copy.py`_, `embedded-export.py`_, `embedded-import.py`_, `embedded-list.py`_ 를 살펴보세요." #: ../../tutorial.rst:373 7e063cc85bf74b67af328699883eabcd msgid "Saving" msgstr "저장" #: ../../tutorial.rst:375 ddc980f323444d9a888df621e5e4413a msgid "" "As mentioned above, :meth:`Document.save` will **always** save the " "document in its current state." msgstr "위에서 언급한 대로 :meth:`Document.save` 는 **항상** 문서를 현재 상태로 저장합니다." #: ../../tutorial.rst:377 938eb4bca93d44e7ad9d9db6a21b0197 msgid "" "You can write changes back to the **original PDF** by specifying option " "``incremental=True``. This process is (usually) **extremely fast**, since" " changes are **appended to the original file** without completely " "rewriting it." msgstr "``incremental=True`` 옵션을 지정하여 변경 사항을 **원본 PDF** 에 다시 쓸 수 있습니다. 이 프로세스는 (일반적으로) **매우 빠릅니다**. 파일을 완전히 다시 쓰지 않고 변경 사항을 **원본 파일에 추가** 하기 때문입니다." #: ../../tutorial.rst:379 34a90e8b41204457b27c7bf4c896ed07 msgid "" ":meth:`Document.save` options correspond to options of MuPDF's command " "line utility *mutool clean*, see the following table." msgstr ":meth:`Document.save` 옵션은 |MuPDF| 의 명령줄 유틸리티 *mutool clean* 의 옵션에 해당합니다. 다음 표를 참조하세요." #: ../../tutorial.rst:382 1163070c3e2e478c9edfeeef99960201 msgid "**Save Option**" msgstr "**저장 옵션**" #: ../../tutorial.rst:382 94311b1ebca3478a8d7bf6f6d522fd8b msgid "**mutool**" msgstr "**mutool**" #: ../../tutorial.rst:382 962d3ef8846c431c8e9dfdf9d487bfb1 msgid "**Effect**" msgstr "**효과**" #: ../../tutorial.rst:384 b65cf8acc8bc476f8334931a4c8a17b8 msgid "garbage=1" msgstr "garbage=1" #: ../../tutorial.rst:384 6b4221531c1b4915975145d5a46840f9 msgid "g" msgstr "g" #: ../../tutorial.rst:384 b773213735d5433a912d7d50de094b58 msgid "garbage collect unused objects" msgstr "사용하지 않는 객체 가비지 수집" #: ../../tutorial.rst:385 9bb3557107484b32b9d48ee883975e41 msgid "garbage=2" msgstr "garbage=2" #: ../../tutorial.rst:385 e5d8266ec4434156843ae8d329cb1234 msgid "gg" msgstr "gg" #: ../../tutorial.rst:385 5d1cd64ee4a44495b52e5808a4c51ebf msgid "in addition to 1, compact :data:`xref` tables" msgstr "1에 추가하여 :data:`xref` 테이블 압축" #: ../../tutorial.rst:386 5846a30c454d494b9cb77c2612b7e3ba msgid "garbage=3" msgstr "garbage=3" #: ../../tutorial.rst:386 8499a2c0b7254ddfbc44cba627532452 msgid "ggg" msgstr "ggg" #: ../../tutorial.rst:386 349d1afd120c468c8663d3467baf0a1d msgid "in addition to 2, merge duplicate objects" msgstr "2에 추가하여 중복 객체 병합" #: ../../tutorial.rst:387 f97513200d184db2818ef3272e06659d msgid "garbage=4" msgstr "garbage=4" #: ../../tutorial.rst:387 8818b59f9bf3464e8ff2acae77c152f2 msgid "gggg" msgstr "gggg" #: ../../tutorial.rst:387 c284ddf0b0794e979bfa728c57373d83 msgid "in addition to 3, merge duplicate stream content" msgstr "3에 추가하여 중복 스트림 콘텐츠 병합" #: ../../tutorial.rst:388 7874a21a2a374610abddf1cbd7efb717 msgid "clean=True" msgstr "clean=True" #: ../../tutorial.rst:388 c1e6bac1097a452a8399150c1e9c8279 msgid "cs" msgstr "cs" #: ../../tutorial.rst:388 9ddc64830c9040ed8451f02ed2741816 msgid "clean and sanitize content streams" msgstr "콘텐츠 스트림 정리 및 정화" #: ../../tutorial.rst:389 c2f486c396c84db0ba07db1c9ee5a7ae msgid "deflate=True" msgstr "deflate=True" #: ../../tutorial.rst:389 49a98a67d15747c98e6ca70bb53f3c51 msgid "z" msgstr "z" #: ../../tutorial.rst:389 37e910e46f2247d3a69e36dbd0748d94 msgid "deflate uncompressed streams" msgstr "압축되지 않은 스트림 압축" #: ../../tutorial.rst:390 7ffbd7aa96264ff1902b58f73b4fd092 msgid "deflate_images=True" msgstr "deflate_images=True" #: ../../tutorial.rst:390 83ea4c4b317d488092885540eb84f939 msgid "i" msgstr "i" #: ../../tutorial.rst:390 4e719956c06a4d49bb8d10a19576ee42 msgid "deflate image streams" msgstr "이미지 스트림 압축" #: ../../tutorial.rst:391 c33f6052e9494538ae7f4e1191c64fd2 msgid "deflate_fonts=True" msgstr "deflate_fonts=True" #: ../../tutorial.rst:391 9786f972e1be4a16b85ffee8b754ec19 msgid "f" msgstr "f" #: ../../tutorial.rst:391 79fefb0533874ecb8a096e7db7f10332 msgid "deflate fontfile streams" msgstr "글꼴 파일 스트림 압축" #: ../../tutorial.rst:392 423d166f2fc54b4498a9377a2dd30960 msgid "ascii=True" msgstr "ascii=True" #: ../../tutorial.rst:392 a67143a6cbe040c590ae0a63a0fe9234 msgid "a" msgstr "a" #: ../../tutorial.rst:392 59590f861522439b8f81250d3941e06c msgid "convert binary data to ASCII format" msgstr "바이너리 데이터를 ASCII 형식으로 변환" #: ../../tutorial.rst:393 86236a9e66cf4150970d92080d6e1583 msgid "linear=True" msgstr "linear=True" #: ../../tutorial.rst:393 5893e24f2faa4060ba0c43aa63dbd263 msgid "l" msgstr "l" #: ../../tutorial.rst:393 0dec5675398e49978e78651893a99395 msgid "create a linearized version" msgstr "선형화된 버전 생성" #: ../../tutorial.rst:394 febbe58d4b104f8bbe950ccccccb1859 msgid "expand=True" msgstr "expand=True" #: ../../tutorial.rst:394 ef0e028a01314e21a0d744ca0d2ad01f msgid "d" msgstr "d" #: ../../tutorial.rst:394 09ec7a0736e34a67aa68a9542195d17e msgid "decompress all streams" msgstr "모든 스트림 압축 해제" #: ../../tutorial.rst:397 e917b060c085407fb80a474e3bec75e9 msgid "" "For an explanation of terms like ``object``, ``stream``, ``xref`` consult" " the :ref:`Glossary` chapter." msgstr "``object``, ``stream``, ``xref`` 와 같은 용어에 대한 설명은 :ref:`Glossary` 장을 참조하세요." #: ../../tutorial.rst:399 dcb5dc3e6c3a41349a7db5e5052ed2e0 msgid "" "For example, ``mutool clean -ggggz file.pdf`` yields excellent " "compression results. It corresponds to ``doc.save(filename, garbage=4, " "deflate=True)``." msgstr "예를 들어 ``mutool clean -ggggz file.pdf`` 는 우수한 압축 결과를 제공합니다. 이것은 ``doc.save(filename, garbage=4, deflate=True)`` 에 해당합니다." #: ../../tutorial.rst:402 c79ea0512d3b44e78f142255268af6ac msgid "Closing" msgstr "닫기" #: ../../tutorial.rst:403 f745b8b8cfd64cd0955b6d9c72baa5f3 msgid "" "It is often desirable to \"close\" a document to relinquish control of " "the underlying file to the OS, while your program continues." msgstr "프로그램이 계속 실행되는 동안 기본 파일에 대한 제어를 OS에 반환하기 위해 문서를 \"닫는\" 것이 종종 바람직합니다." #: ../../tutorial.rst:405 6ec44b753b01413a9bcbd6b21a1310d7 msgid "" "This can be achieved by the :meth:`Document.close` method. Apart from " "closing the underlying file, buffer areas associated with the document " "will be freed." msgstr "이것은 :meth:`Document.close` 메서드로 달성할 수 있습니다. 기본 파일을 닫는 것 외에도 문서와 연결된 버퍼 영역이 해제됩니다." #: ../../tutorial.rst:408 88cb960755d5457da5441939ff0c836d msgid "Further Reading" msgstr "추가 읽기" #: ../../tutorial.rst:409 079337447add4588b00679495c0756c6 msgid "" "Also have a look at PyMuPDF's `Wiki`_ pages. Especially those named in " "the sidebar under title **\"Recipes\"** cover over 15 topics written in " "\"How-To\" style." msgstr "|PyMuPDF| 의 `Wiki`_ 페이지도 살펴보세요. 특히 사이드바의 **\"Recipes\"** 제목 아래에 나열된 항목은 \"How-To\" 스타일로 작성된 15개 이상의 주제를 다룹니다." #: ../../tutorial.rst:411 4ff206365d3c46319f8786732294335f msgid "" "This document also contains a :ref:`FAQ`. This chapter has close " "connection to the aforementioned recipes, and it will be extended with " "more content over time." msgstr "이 문서에는 :ref:`FAQ` 도 포함되어 있습니다. 이 장은 앞서 언급한 recipes와 밀접한 관련이 있으며, 시간이 지나면서 더 많은 콘텐츠로 확장될 것입니다." #: ../../tutorial.rst:418 8469cb98a4bc46da95e015537403452d msgid "Footnotes" msgstr "각주" #: ../../tutorial.rst:419 7abfecf3e58542b0859cd575498948f7 msgid "" "PyMuPDF lets you also open several image file types just like normal " "documents. See section :ref:`ImageFiles` in chapter :ref:`Pixmap` for " "more comments." msgstr "|PyMuPDF| 는 일반 문서처럼 여러 이미지 파일 타입을 열 수 있게 합니다. 자세한 내용은 :ref:`Pixmap` 장의 :ref:`ImageFiles` 섹션을 참조하세요." #: ../../tutorial.rst:421 70b740aad28644b395c85b6a12f20f0e msgid "" ":meth:`Page.get_text` is a convenience wrapper for several methods of " "another PyMuPDF class, :ref:`TextPage`. The names of these methods " "correspond to the argument string passed to :meth:`Page.get_text` \\: " "*Page.get_text(\"dict\")* is equivalent to *TextPage.extractDICT()* \\." msgstr ":meth:`Page.get_text` 는 다른 |PyMuPDF| 클래스인 :ref:`TextPage` 의 여러 메서드에 대한 편의 래퍼입니다. 이러한 메서드의 이름은 :meth:`Page.get_text` 에 전달된 인수 문자열에 해당합니다: *Page.get_text(\"dict\")* 는 *TextPage.extractDICT()* 와 동일합니다." #: ../../tutorial.rst:423 13eddbfd7bd64cd49e523d76972c7368 msgid "" "\"Sequences\" are Python objects conforming to the sequence protocol. " "These objects implement a method named *__getitem__()*. Best known " "examples are Python tuples and lists. But *array.array*, *numpy.array* " "and PyMuPDF's \"geometry\" objects (:ref:`Algebra`) are sequences, too. " "Refer to :ref:`SequenceTypes` for details." msgstr "\"Sequences\"는 시퀀스 프로토콜을 준수하는 Python 객체입니다. 이러한 객체는 *__getitem__()* 이라는 메서드를 구현합니다. 가장 잘 알려진 예는 Python 튜플과 리스트입니다. 그러나 *array.array*, *numpy.array* 및 |PyMuPDF| 의 \"geometry\" 객체(:ref:`Algebra`)도 시퀀스입니다. 자세한 내용은 :ref:`SequenceTypes` 를 참조하세요." #: ../../footer.rst:46 34f591e7f8ab491b884b15a32b4f508e msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/vars.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 b5ad9d8dc172425eb69cab3f7d6af3f1 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 469b53fb216c416cab35e3785cb83220 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 3fc4b25efb434bdd9a36d5ea7c1bb7e4 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../vars.rst:5 f49c06cd5a6f4032b8cd339c64a77df1 msgid "Constants and Enumerations" msgstr "상수 및 열거형" #: ../../vars.rst:6 49759909465a4d1794c2b500ea92ef1d msgid "" "Constants and enumerations of :title:`MuPDF` as implemented by |PyMuPDF|." " Each of the following values is accessible as `pymupdf.value`." msgstr "|PyMuPDF| 에서 구현한 :title:`MuPDF` 의 상수 및 열거형. 다음 각 값은 `pymupdf.value` 로 접근할 수 있습니다." #: ../../vars.rst:10 32fc3323ad3f4cdfb477267318e012bc msgid "Constants" msgstr "상수" #: ../../vars.rst:14 5b27640ef1ee4e98bea1cf03003160a1 msgid "Predefined Python list of valid :ref:`Base-14-Fonts`." msgstr "유효한 :ref:`Base-14-Fonts` 의 사전 정의된 Python 목록." #: ../../vars.rst 03741e7ad1a44d5299f6572dedaca7b4 #: 049f7b4ff1974e208b3a904e6026a510 05d7b5730e6142eb96888bc1f1fbcc93 #: 0651bf5144c1497e884e5c0cc6076c5a 0d7a04755856497fa83f67a8849b2425 #: 26435fd0d5d24581abb8057002bce4cc 340ebf4c39ec45d4bfe3a768d8345ba6 #: 4305209c628b41b484db244a821e36a6 441240ad284b456d8fe847ecb191b0f1 #: 5ba5705e35594ba28d545462f311e0f9 61aa981fd8a346deaaf51a3d4c08d34a #: 6ca990f8a13b4358bbabc20892811cc3 771ae51b4e044a81ae255f6c908697fb #: 84cd0a4cb52c4fec9fe883c2ad4ace9d 850da1d028064e8191dfa082a3f82827 #: 8792cce457a84f11b18d64b74d8debc3 8a25036eb68c414abfb7ad4fa62d7229 #: 92c64e0683614c6c9deb6668c7f4b761 a2004991370a40408515cf83163b6ffb #: cdbf08fc2b5b4750b45132b7ec6c2616 d06dea99fa0a4e3cbee4b2b714c43296 #: f03ecc8098ca4cc181b8356bd7a2bb91 f3646d6d4cee48e0b1af3350ce178eec #: f7af32255ccb4f66a37175278b7b7087 fddcade3afa241b8a81b00e45d91f2a4 msgid "type" msgstr "유형" #: ../../vars.rst:16 669fb77a7bdd4fbcb224507f1b8d7932 msgid "list" msgstr "list" #: ../../vars.rst:20 b3ae8b9f4f43444aa8fdc74de25f17f0 msgid "Predefined RGB colorspace *pymupdf.Colorspace(pymupdf.CS_RGB)*." msgstr "사전 정의된 RGB 색 공간 *pymupdf.Colorspace(pymupdf.CS_RGB)*." #: ../../vars.rst:22 ../../vars.rst:28 ../../vars.rst:34 #: 19f89992935a4f8e839adc1511263368 204d25d273a7452cb5ba5e71b6869076 #: 79e2265294cd409f800e1e4a446e2ccf msgid ":ref:`Colorspace`" msgstr ":ref:`Colorspace`" #: ../../vars.rst:26 6a13d5103eb54565bf88415ab0ddc8c5 msgid "Predefined GRAY colorspace *pymupdf.Colorspace(pymupdf.CS_GRAY)*." msgstr "사전 정의된 GRAY 색 공간 *pymupdf.Colorspace(pymupdf.CS_GRAY)*." #: ../../vars.rst:32 7321e72d393e42a3b735759e78d1800e msgid "Predefined CMYK colorspace *pymupdf.Colorspace(pymupdf.CS_CMYK)*." msgstr "사전 정의된 CMYK 색 공간 *pymupdf.Colorspace(pymupdf.CS_CMYK)*." #: ../../vars.rst:38 69ab2345dd374ad1873f76d16292717c msgid "1 -- Type of :ref:`Colorspace` is RGBA" msgstr "1 -- :ref:`Colorspace` 유형은 RGBA" #: ../../vars.rst:40 ../../vars.rst:46 ../../vars.rst:52 ../../vars.rst:324 #: ../../vars.rst:330 ../../vars.rst:339 ../../vars.rst:348 ../../vars.rst:354 #: ../../vars.rst:360 015aafcf193f4fd986c01b2543bb2157 #: 0a5dae970bce40d4a3ef066a7b52120d 648ca70552324683a3f2d83756f7f850 #: 9b976dcffb04497a9119e83b6b78aab2 ab0b93519cea4419af8c90b1cc9d3a36 #: b6975d022fb6464bb4f18e4ee6bd73fa c2c115fb5ad14e8da9970160f490f151 #: c3202da1e321403b976247fc2a19756a d3d462436758488a8dab6f328e27425e msgid "int" msgstr "int" #: ../../vars.rst:44 23b50446130242d885968a5027985060 msgid "2 -- Type of :ref:`Colorspace` is GRAY" msgstr "2 -- :ref:`Colorspace` 유형은 GRAY" #: ../../vars.rst:50 9cf5e34e2e83453799d96f7be872aa7b msgid "3 -- Type of :ref:`Colorspace` is CMYK" msgstr "3 -- :ref:`Colorspace` 유형은 CMYK" #: ../../vars.rst:56 22d14edcfed74d6ba68f180a5162d3bc msgid "'x.xx.x' -- MuPDF version that is being used by PyMuPDF." msgstr "'x.xx.x' -- PyMuPDF에서 사용 중인 MuPDF 버전." #: ../../vars.rst:58 ../../vars.rst:70 24ffecb2a7de45fbbce9cac71b9ad2c2 #: 4162b0bbb82145f5863294fee9b84fcb msgid "string" msgstr "string" #: ../../vars.rst:62 22fa0f6343d143a783918bf5d77c0101 msgid "MuPDF version as a tuple of integers, `(major, minor, patch)`." msgstr "정수 튜플로 표현된 MuPDF 버전, `(major, minor, patch)`." #: ../../vars.rst:64 ../../vars.rst:76 ../../vars.rst:86 #: 2f0bacf105574469a7a2f46854047382 ad5b78a4130443e0b9cb7a3e7209521d #: d8a2a6e3dcc44d9a96a1324281332fc4 msgid "tuple" msgstr "tuple" #: ../../vars.rst:68 44158f3deff845c6a420df354f39c1ae msgid "'x.xx.x' -- PyMuPDF version." msgstr "'x.xx.x' -- PyMuPDF 버전." #: ../../vars.rst:74 503076c6013f48dea2d5aff3c0bfffe3 msgid "PyMuPDF version as a tuple of integers, `(major, minor, patch)`." msgstr "정수 튜플로 표현된 PyMuPDF 버전, `(major, minor, patch)`." #: ../../vars.rst:80 ../../vars.rst:98 60b862b7a373462c8b0819e549788e84 #: c79955e7841e4b48a637775a61cfbd69 msgid "Disabled (set to None) in 1.26.1." msgstr "1.26.1에서 비활성화됨(None으로 설정)." #: ../../vars.rst:84 fff27c04ee62442897c643c5bfb60fd8 msgid "" "(pymupdf_version, mupdf_version, timestamp) -- combined version " "information where `timestamp` is the generation point in time formatted " "as \"YYYYMMDDhhmmss\"." msgstr "(pymupdf_version, mupdf_version, timestamp) -- 결합된 버전 정보. `timestamp` 는 \"YYYYMMDDhhmmss\" 형식의 생성 시점입니다." #: ../../vars.rst:90 4fbbccb8f9024a63a332534e6a7d0d2e msgid "Legacy equivalent to `mupdf_version`." msgstr "`mupdf_version` 과 동일한 레거시." #: ../../vars.rst:94 24f0ff9e8cf44c5fba17fe9c4bd63d7f msgid "Legacy equivalent to `pymupdf_version`." msgstr "`pymupdf_version` 과 동일한 레거시." #: ../../vars.rst:104 4dce9933f18a45198a4633f8fefe9d07 msgid "Document Permissions" msgstr "문서 권한" #: ../../vars.rst:107 ../../vars.rst:125 ../../vars.rst:138 #: 69c0225036764f13b91eaa9dd3d4b5a1 8e2f223c79664413ba8ac6afd092c3fa #: a0a9b218a32347e18401eec3e71b51c6 msgid "Code" msgstr "코드" #: ../../vars.rst:107 c680e8bb0a64489fbe38ff0350dae277 msgid "Permitted Action" msgstr "허용된 작업" #: ../../vars.rst:109 a79221d078824de999e2f0ccf27939da msgid "PDF_PERM_PRINT" msgstr "PDF_PERM_PRINT" #: ../../vars.rst:109 634b2c786f6946a99a89687ae863c63d msgid "Print the document" msgstr "문서 인쇄" #: ../../vars.rst:110 488e117f6ad841e4b5ebe9ca302ecd70 msgid "PDF_PERM_MODIFY" msgstr "PDF_PERM_MODIFY" #: ../../vars.rst:110 a868ac82b5084146a37a1633ab518c6c msgid "Modify the document's contents" msgstr "문서 내용 수정" #: ../../vars.rst:111 18ef7dd19b374b5ebfdb3cec757c73ac msgid "PDF_PERM_COPY" msgstr "PDF_PERM_COPY" #: ../../vars.rst:111 8f52d72b641b40d285393c8d0bdf12b3 msgid "Copy or otherwise extract text and graphics" msgstr "텍스트 및 그래픽 복사 또는 추출" #: ../../vars.rst:112 9e025ab3d4f741e2a325152bc6f8a701 msgid "PDF_PERM_ANNOTATE" msgstr "PDF_PERM_ANNOTATE" #: ../../vars.rst:112 cb0beab224b94270bdabfc3bd1ceacc6 msgid "Add or modify text annotations and interactive form fields" msgstr "텍스트 주석 및 대화형 양식 필드 추가 또는 수정" #: ../../vars.rst:113 65f9a8539a38426e9d9edea861734d4d msgid "PDF_PERM_FORM" msgstr "PDF_PERM_FORM" #: ../../vars.rst:113 9880c191956741d1ada6315e712e1df3 msgid "Fill in forms and sign the document" msgstr "양식 작성 및 문서 서명" #: ../../vars.rst:114 419137e25c424c91876fed826c5a5bb0 msgid "PDF_PERM_ACCESSIBILITY" msgstr "PDF_PERM_ACCESSIBILITY" #: ../../vars.rst:114 c90f5be96ba842199ff198fe845a93a8 msgid "Obsolete, always permitted" msgstr "사용 중단됨, 항상 허용됨" #: ../../vars.rst:115 2ac0ea137a68490a808035fe357a1eb5 msgid "PDF_PERM_ASSEMBLE" msgstr "PDF_PERM_ASSEMBLE" #: ../../vars.rst:115 ee21ef3d77b543aa83b85d5966fa800c msgid "Insert, rotate, or delete pages, bookmarks, thumbnail images" msgstr "페이지, 책갈피, 썸네일 이미지 삽입, 회전 또는 삭제" #: ../../vars.rst:116 12f225fa0c204cecae58e07d185ee517 msgid "PDF_PERM_PRINT_HQ" msgstr "PDF_PERM_PRINT_HQ" #: ../../vars.rst:116 40cb4480233843f686a1bb405c551ad8 msgid "High quality printing" msgstr "고품질 인쇄" #: ../../vars.rst:122 c7730f8c05a4440dabe25baa7a267683 msgid "PDF Optional Content Codes" msgstr "PDF 선택적 콘텐츠 코드" #: ../../vars.rst:125 ../../vars.rst:138 063e2ffd14154f0ebe27a414e68d96c6 #: fe257d4a0ce0417dba5855c9020e0ca1 msgid "Meaning" msgstr "의미" #: ../../vars.rst:127 fe2012971224466ea97a0fb2a812c5d5 msgid "PDF_OC_ON" msgstr "PDF_OC_ON" #: ../../vars.rst:127 420c6f19787341418e8a584a6befd890 msgid "Set an OCG to ON temporarily" msgstr "OCG를 일시적으로 ON으로 설정" #: ../../vars.rst:128 2c29aec5886a45cfae0e991402caad13 msgid "PDF_OC_TOGGLE" msgstr "PDF_OC_TOGGLE" #: ../../vars.rst:128 a7ebc40cd09c47a3867c2d73be2fdc36 msgid "Toggle OCG status temporarily" msgstr "OCG 상태를 일시적으로 토글" #: ../../vars.rst:129 4b06b1f6475a41cb8d448d28fbf5dd24 msgid "PDF_OC_OFF" msgstr "PDF_OC_OFF" #: ../../vars.rst:129 8a6a1199c65a44ba85224f9de436969f msgid "Set an OCG to OFF temporarily" msgstr "OCG를 일시적으로 OFF로 설정" #: ../../vars.rst:135 2b7b50430a24457fafc7cd3943e62be7 msgid "PDF encryption method codes" msgstr "PDF 암호화 방법 코드" #: ../../vars.rst:140 a3c958105b9a4e8db59f50cb6ab72b3f msgid "PDF_ENCRYPT_KEEP" msgstr "PDF_ENCRYPT_KEEP" #: ../../vars.rst:140 30102a9f273a4422a20bf1aa06b451e6 msgid "do not change" msgstr "변경하지 않음" #: ../../vars.rst:141 57fd2541dc9c472e9d50b26ef7cd6daf msgid "PDF_ENCRYPT_NONE" msgstr "PDF_ENCRYPT_NONE" #: ../../vars.rst:141 49f9186cb5ae45cd9064cb575b6d5385 msgid "remove any encryption" msgstr "모든 암호화 제거" #: ../../vars.rst:142 49fe127596b048f4a7ea339156fdf19d msgid "PDF_ENCRYPT_RC4_40" msgstr "PDF_ENCRYPT_RC4_40" #: ../../vars.rst:142 5e3374e98bdc43a199f2fd85dcc18580 msgid "RC4 40 bit" msgstr "RC4 40비트" #: ../../vars.rst:143 178727ee434846ad808cce5a8aaad74f msgid "PDF_ENCRYPT_RC4_128" msgstr "PDF_ENCRYPT_RC4_128" #: ../../vars.rst:143 a3c8b50a7af8456a966bcd7de122f754 msgid "RC4 128 bit" msgstr "RC4 128비트" #: ../../vars.rst:144 1ccff559acbb47a8a81bae717b32c4c8 msgid "PDF_ENCRYPT_AES_128" msgstr "PDF_ENCRYPT_AES_128" #: ../../vars.rst:144 d1fdccc17e4348788f55154c73a66ddd msgid "*Advanced Encryption Standard* 128 bit" msgstr "*고급 암호화 표준* 128비트" #: ../../vars.rst:145 6052a9f31b7f4ec0b078312655adc0d5 msgid "PDF_ENCRYPT_AES_256" msgstr "PDF_ENCRYPT_AES_256" #: ../../vars.rst:145 14eb7ccec2184fbbb74c67eb54aeaa93 msgid "*Advanced Encryption Standard* 256 bit" msgstr "*고급 암호화 표준* 256비트" #: ../../vars.rst:146 0e8a697210064a68a4acb78e4798c066 msgid "PDF_ENCRYPT_UNKNOWN" msgstr "PDF_ENCRYPT_UNKNOWN" #: ../../vars.rst:146 c4ff9f33d8bf406baac59afdedce3393 msgid "unknown" msgstr "알 수 없음" #: ../../vars.rst:152 41ce5d42a96641298f59e62ca328c3ad msgid "Font File Extensions" msgstr "글꼴 파일 확장자" #: ../../vars.rst:153 a5aa4b1442b84096a3364986edc00478 msgid "" "The table show file extensions you should use when saving fontfile " "buffers extracted from a PDF. This string is returned by " ":meth:`Document.get_page_fonts`, :meth:`Page.get_fonts` and " ":meth:`Document.extract_font`." msgstr "이 표는 PDF에서 추출한 글꼴 파일 버퍼를 저장할 때 사용해야 하는 파일 확장자를 보여줍니다. 이 문자열은 :meth:`Document.get_page_fonts`, :meth:`Page.get_fonts` 및 :meth:`Document.extract_font` 에 의해 반환됩니다." #: ../../vars.rst:156 0052347b09ef46dd84c581597bacb35f msgid "Ext" msgstr "확장자" #: ../../vars.rst:156 2d2cd27d463f4ff0997dae7caa6b83b6 msgid "Description" msgstr "설명" #: ../../vars.rst:158 112b17f0de1840a08e0864ed1e9fad0c msgid "ttf" msgstr "ttf" #: ../../vars.rst:158 0cb8088360d7427baefcf5281b49766b msgid "TrueType font" msgstr "TrueType 글꼴" #: ../../vars.rst:159 c2a6b6d61d0e40d583db103da173e32f msgid "pfa" msgstr "pfa" #: ../../vars.rst:159 5a1d03107af64f5981ab318e0360c9af msgid "Postscript for ASCII font (various subtypes)" msgstr "ASCII 글꼴용 Postscript (다양한 하위 유형)" #: ../../vars.rst:160 86be9bafc4174236b68e13a9dac7e5c8 msgid "cff" msgstr "cff" #: ../../vars.rst:160 8675d363e0c9499ab403a49e9cda22a1 msgid "Type1C font (compressed font equivalent to Type1)" msgstr "Type1C 글꼴 (Type1과 동등한 압축 글꼴)" #: ../../vars.rst:161 4c60a1421ea7458e81092448bae7a1d8 msgid "cid" msgstr "cid" #: ../../vars.rst:161 cf49f17f14d346f89b4ace2ba62a022f msgid "character identifier font (postscript format)" msgstr "문자 식별자 글꼴 (postscript 형식)" #: ../../vars.rst:162 fc39dc6369a74d13baa2932ca54039b7 msgid "otf" msgstr "otf" #: ../../vars.rst:162 e6d68a78565e4efdbdabf3ad08977b53 msgid "OpenType font" msgstr "OpenType 글꼴" #: ../../vars.rst:163 b7864b379d2a4c898a5538edf898a0a6 msgid "n/a" msgstr "해당 없음" #: ../../vars.rst:163 d276c42e480048c98e84446e521418fb msgid "not extractable, e.g. :ref:`Base-14-Fonts`, Type 3 fonts and others" msgstr "추출할 수 없음, 예: :ref:`Base-14-Fonts`, Type 3 글꼴 및 기타" #: ../../vars.rst:169 30a554d8b43e4399ac3db70eb4861a79 msgid "Text Alignment" msgstr "텍스트 정렬" #: ../../vars.rst:172 c285bb937c45411c9e8428e8cbc6d5ce msgid "0 -- align left." msgstr "0 -- 왼쪽 정렬." #: ../../vars.rst:176 f6c2ead9ebb844e2a50572a57dbf9a86 msgid "1 -- align center." msgstr "1 -- 가운데 정렬." #: ../../vars.rst:180 8e82db4889224a20909e002199177be8 msgid "2 -- align right." msgstr "2 -- 오른쪽 정렬." #: ../../vars.rst:184 75af6aadfef54289894f0d114de9eeae msgid "3 -- align justify." msgstr "3 -- 양쪽 정렬." #: ../../vars.rst:191 cf47b8894ae04d868274979275d334ee msgid "Font Properties" msgstr "글꼴 속성" #: ../../vars.rst:192 5c56a8ed6d794191b089c5b738da3cf9 msgid "" "Please note that the following bits are derived from what a font has to " "say about its properties. It may not be (and quite often is not) correct." msgstr "다음 비트는 글꼴이 자신의 속성에 대해 말하는 내용에서 파생됩니다. 정확하지 않을 수 있으며(그리고 종종 그렇습니다)." #: ../../vars.rst:196 d8f06c39601c4b96bd13ea9e078c40ce msgid "" "1 -- the character or span is a superscript. This property is computed by" " MuPDF and not part of any font information." msgstr "1 -- 문자 또는 스팬이 위첨자입니다. 이 속성은 MuPDF에 의해 계산되며 글꼴 정보의 일부가 아닙니다." #: ../../vars.rst:200 d21771d5f06e4862a5dc0a350e8a4def msgid "2 -- the font is italic." msgstr "2 -- 글꼴이 이탤릭체입니다." #: ../../vars.rst:204 c25bebd41297409da31265769924b7c0 msgid "4 -- the font is serifed." msgstr "4 -- 글꼴이 세리프입니다." #: ../../vars.rst:208 b4a15a033d644c66b6b71cd52bef75b0 msgid "8 -- the font is mono-spaced." msgstr "8 -- 글꼴이 고정폭입니다." #: ../../vars.rst:212 fd8f231700104de8a26b9fa17f57dca6 msgid "16 -- the font is bold." msgstr "16 -- 글꼴이 굵게입니다." #: ../../vars.rst:215 ae7fc7375fe24bcab9635e7ecaf45788 msgid "Text Extraction Flags" msgstr "텍스트 추출 플래그" #: ../../vars.rst:216 b53381821bdc40c69b532bc7e53092be msgid "" "Option bits controlling the amount of data, that are parsed into a " ":ref:`TextPage`." msgstr ":ref:`TextPage` 로 파싱되는 데이터 양을 제어하는 옵션 비트." #: ../../vars.rst:218 4e0693fb1e8f4c7e991b270de3d35b6c msgid "" "For the PyMuPDF programmer, some combination (using Python's `|` " "operator, or simply use `+`) of these values are aggregated in the " "``flags`` integer, a parameter of all text search and text extraction " "methods. Depending on the individual method, different default " "combinations of the values are used. Please use a value that meets your " "situation. Especially make sure to switch off image extraction unless you" " really need them. The impact on performance and memory is significant!" msgstr "PyMuPDF 프로그래머의 경우, 이러한 값의 일부 조합(Python의 `|` 연산자를 사용하거나 단순히 `+` 사용)이 모든 텍스트 검색 및 텍스트 추출 메서드의 매개변수인 ``flags`` 정수에 집계됩니다. 개별 메서드에 따라 다른 기본 값 조합이 사용됩니다. 상황에 맞는 값을 사용하세요. 특히 실제로 필요하지 않은 경우 이미지 추출을 끄는 것이 중요합니다. 성능과 메모리에 미치는 영향이 큽니다!" #: ../../vars.rst:222 e2a36dbf69d04d888507fc509ee2b720 msgid "" "1 -- If set, ligatures are passed through to the application in their " "original form. Otherwise ligatures are expanded into their constituent " "parts, e.g. the ligature \"ffi\" is expanded into three eparate " "characters f, f and i. Default is \"on\" in PyMuPDF. MuPDF supports the " "following 7 ligatures: \"ff\", \"fi\", \"fl\", \"ffi\", \"ffl\", , " "\"ft\", \"st\"." msgstr "1 -- 설정되면 합자가 원래 형태로 애플리케이션에 전달됩니다. 그렇지 않으면 합자가 구성 요소로 확장됩니다. 예를 들어 합자 \"ffi\"는 세 개의 별도 문자 f, f, i로 확장됩니다. PyMuPDF의 기본값은 \"on\"입니다. MuPDF는 다음 7개의 합자를 지원합니다: \"ff\", \"fi\", \"fl\", \"ffi\", \"ffl\", \"ft\", \"st\"." #: ../../vars.rst:226 03ceff6db720488f91e124b08d5a1e41 msgid "" "2 -- If set, whitespace is passed through. Otherwise any type of " "horizontal whitespace (including horizontal tabs) will be replaced with " "space characters of variable width. Default is \"on\" in PyMuPDF." msgstr "2 -- 설정되면 공백이 그대로 전달됩니다. 그렇지 않으면 모든 유형의 수평 공백(수평 탭 포함)이 가변 너비의 공백 문자로 대체됩니다. PyMuPDF의 기본값은 \"on\"입니다." #: ../../vars.rst:230 cf99390225b04a8996e5580bd96fe830 msgid "" "4 -- If set, then images will be stored in the :ref:`TextPage`. This " "causes the presence of (usually large!) binary image content in the " "output of text extractions of types \"blocks\", \"dict\", \"json\", " "\"rawdict\", \"rawjson\", \"html\", and \"xhtml\" and is the default " "there. If used with \"blocks\" however, only image metadata will be " "returned, not the image itself." msgstr "4 -- 설정되면 이미지가 :ref:`TextPage` 에 저장됩니다. 이것은 \"blocks\", \"dict\", \"json\", \"rawdict\", \"rawjson\", \"html\", \"xhtml\" 유형의 텍스트 추출 출력에 (보통 큰!) 바이너리 이미지 콘텐츠가 포함되게 하며, 여기서 기본값입니다. 그러나 \"blocks\"와 함께 사용하면 이미지 자체가 아닌 이미지 메타데이터만 반환됩니다." #: ../../vars.rst:234 2681e56367fe46aa936b2b5870294639 msgid "" "8 -- If set, Mupdf will not try to add missing space characters where " "there are large gaps between characters. In PDF, the creator often does " "not insert spaces to point to the next character's position, but will " "provide the direct location address. The default in PyMuPDF is \"off\" --" " so spaces **will be generated**." msgstr "8 -- 설정되면 MuPDF는 문자 사이에 큰 간격이 있는 곳에 누락된 공백 문자를 추가하려고 시도하지 않습니다. PDF에서 작성자는 종종 다음 문자 위치를 가리키는 공백을 삽입하지 않고 직접 위치 주소를 제공합니다. PyMuPDF의 기본값은 \"off\"입니다 -- 따라서 공백이 **생성됩니다**." #: ../../vars.rst:238 cb25cbf3acb74d84824fa410aed54abd msgid "" "16 -- Ignore hyphens at line ends and join with next line. Used " "internally with the text search functions. However, it is generally " "available: if on, text extractions will return joined text lines (or " "spans) with the ending hyphen of the first line eliminated. So two " "separate spans **\"first meth-\"** and **\"od leads to wrong results\"** " "on different lines will be joined to one span **\"first method leads to " "wrong results\"** and correspondingly updated bboxes: the characters of " "the resulting span will no longer have identical y-coordinates." msgstr "16 -- 줄 끝의 하이픈을 무시하고 다음 줄과 결합합니다. 텍스트 검색 함수와 함께 내부적으로 사용됩니다. 그러나 일반적으로 사용 가능합니다: 켜면 텍스트 추출은 첫 번째 줄의 끝 하이픈이 제거된 결합된 텍스트 줄(또는 스팬)을 반환합니다. 따라서 다른 줄에 있는 두 개의 별도 스팬 **\"first meth-\"** 및 **\"od leads to wrong results\"** 는 하나의 스팬 **\"first method leads to wrong results\"** 로 결합되고 그에 따라 bbox가 업데이트됩니다: 결과 스팬의 문자는 더 이상 동일한 y 좌표를 가지지 않습니다." #: ../../vars.rst:242 19c2601d343547ba88a56aac0f0c8ff5 msgid "" "32 -- Generate a new line for every span. Not used (\"off\") in PyMuPDF, " "but available for your use. Every line in \"dict\", \"json\", " "\"rawdict\", \"rawjson\" will contain exactly one span." msgstr "32 -- 각 스팬에 대해 새 줄을 생성합니다. PyMuPDF에서는 사용되지 않지만(\"off\") 사용할 수 있습니다. \"dict\", \"json\", \"rawdict\", \"rawjson\"의 모든 줄은 정확히 하나의 스팬을 포함합니다." #: ../../vars.rst:246 87e941b789f8436e998a2f3801575756 msgid "" "64 -- Characters entirely outside a page's **mediabox** or contained in " "other \"clipped\" areas will be ignored. This is default in PyMuPDF." msgstr "64 -- 페이지의 **mediabox** 완전히 밖에 있거나 다른 \"클리핑된\" 영역에 포함된 문자는 무시됩니다. 이것은 PyMuPDF의 기본값입니다." #: ../../vars.rst:250 befbc341b1674e348a9396c99be1ac8a msgid "" "128 -- Use raw character codes instead of U+FFFD. This is the default for" " **text extraction** in PyMuPDF. If you **want to detect** when encoding " "information is missing or uncertain, toggle this flag and scan for the " "presence of U+FFFD (= `chr(0xfffd)`) code points in the resulting text." msgstr "128 -- U+FFFD 대신 원시 문자 코드를 사용합니다. 이것은 PyMuPDF에서 **텍스트 추출** 의 기본값입니다. 인코딩 정보가 누락되거나 불확실할 때 **감지하려면** 이 플래그를 토글하고 결과 텍스트에서 U+FFFD(= `chr(0xfffd)`) 코드 포인트의 존재를 스캔하세요." #: ../../vars.rst:254 328eded5e21c495986514848f3acd090 msgid "256 -- Not supported." msgstr "256 -- 지원되지 않음." #: ../../vars.rst:258 c2468f6ee1364a9aacd5178c2e2e1f03 msgid "" "512 -- Ignore metric values of all fonts when computing character " "boundary boxes -- most prominently the `ascender " "`_ and `descender " "`_ values. Instead, follow the " "drawing commands of each character's glyph and compute its rectangle " "hull. This is the smallest rectangle wrapping all points used for drawing" " the visual appearance - see the :ref:`Shape` class for understanding the" " background. This will especially result in individual character heights." " For instance a (white) space will have a **bbox of height 0** (because " "nothing is drawn) -- in contrast to the non-zero boundary box generated " "when using font metrics. This option may be useful to cope with getting " "meaningful boundary boxes even for fonts containing errors. Its use will " "slow down text extraction somewhat because of the incurred computational " "effort." msgstr "" "512 -- 문자 경계 상자를 계산할 때 모든 글꼴의 메트릭 값을 무시합니다 -- 가장 " "두드러지게 `ascender " "`_ 및 `descender " "`_ 값입니다. 대신 각 문자의 글리프의 " "그리기 명령을 따르고 해당 사각형 경계를 계산합니다. 이것은 시각적 모양을 그리는 " "데 사용된 모든 점을 감싸는 가장 작은 사각형입니다 - 배경을 이해하려면 " ":ref:`Shape` 클래스를 참조하세요. 이것은 특히 개별 문자 높이를 초래합니다. " "예를 들어 (흰색) 공백은 **높이가 0인 bbox** 를 가집니다(아무것도 그려지지 않기 " "때문) -- 글꼴 메트릭을 사용할 때 생성되는 0이 아닌 경계 상자와 대조됩니다. 이 " "옵션은 오류가 포함된 글꼴에 대해서도 의미 있는 경계 상자를 얻는 데 유용할 수 " "있습니다. 발생하는 계산 작업으로 인해 사용 시 텍스트 추출 속도가 다소 느려집니다." #: ../../vars.rst:260 0d005cfd39294c549dcb076c7db6a438 msgid "" "Note that this has no effect by default - one must also disable the " "global quad corrections setting with " "`pymupdf.TOOLS.unset_quad_corrections(True)`." msgstr "기본적으로는 효과가 없습니다 - `pymupdf.TOOLS.unset_quad_corrections(True)` 로 전역 quad 보정 설정도 비활성화해야 합니다." #: ../../vars.rst:265 26addbea02e84233b6230ff416c3f839 msgid "1024 -- Not supported." msgstr "1024 -- 지원되지 않음." #: ../../vars.rst:269 71ca80b7b9a0453f96fbe2509cc882f8 msgid "" "2048 -- Ignore built-in differences between text appearing in e.g. PDF " "viewers versus text stored in the PDF. See :ref:`AdobeManual`, page 615 " "for background. If set, the **stored** (\"replacement\" text) is ignored " "in favor of the displayed text." msgstr "" "2048 -- PDF 뷰어 등에 나타나는 텍스트와 PDF에 저장된 텍스트 간의 내장된 " "차이를 무시합니다. 배경은 :ref:`AdobeManual` 615페이지를 참조하세요. 설정되면 " "**저장된** (\"대체\" 텍스트)이 무시되고 표시된 텍스트가 우선됩니다." #: ../../vars.rst:273 a2280aa3922d45a0b01eec12d3b1828e msgid "4096 -- Attempt to segment page into different regions." msgstr "4096 -- 페이지를 다른 영역으로 분할하려고 시도합니다." #: ../../vars.rst:275 6055e0ec2f2640a4a69c769d60051dd1 msgid "" "The following constants represent the default combinations of the above " "for text extraction and searching:" msgstr "다음 상수는 텍스트 추출 및 검색을 위한 위의 기본 조합을 나타냅니다:" #: ../../vars.rst:279 ../../vars.rst:283 ../../vars.rst:287 ../../vars.rst:307 #: 18445061c2274e3094f8e223b2f97d8b 4848e850ecdd4b71ae9e0fe4bd1bd2ab #: 7e1253a470a94b4bad14d5086ec64c03 b78142b94eed4f5ca84f11c2fef8b074 msgid "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" msgstr "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" #: ../../vars.rst:291 ../../vars.rst:295 ../../vars.rst:299 ../../vars.rst:303 #: 1cef0274d54745cead1031d1bca2799f 2fbf2a5e26ee49eb868428bcbb529499 #: 9fdd1b123b4e4f2fa9c013d23a2b966c ffe8940542984cda9c70ce1c925581dc msgid "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" msgstr "" "`TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP " "| TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE`" #: ../../vars.rst:311 bb90ee72173049c7a370c67ba9105b23 msgid "`TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE`" msgstr "`TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE`" #: ../../vars.rst:317 f588bfe5d7214e09848d2ea66fc226e0 msgid "Link Destination Kinds" msgstr "링크 대상 종류" #: ../../vars.rst:318 25e6f87b871146ab8c9d29979584f4b3 msgid "Possible values of :attr:`linkDest.kind` (link destination kind)." msgstr ":attr:`linkDest.kind` (링크 대상 종류)의 가능한 값." #: ../../vars.rst:322 93386ed82cc246f889866c47a3647e09 msgid "0 -- No destination. Indicates a dummy link." msgstr "0 -- 대상 없음. 더미 링크를 나타냅니다." #: ../../vars.rst:328 55d8c4d1bc6e4ff7896e13f3fcbbfa74 msgid "1 -- Points to a place in this document." msgstr "1 -- 이 문서의 위치를 가리킵니다." #: ../../vars.rst:334 17fd7d0b788140929657b02c096290f0 msgid "" "2 -- Points to a URI -- typically a resource specified with internet " "syntax." msgstr "2 -- URI를 가리킵니다 -- 일반적으로 인터넷 구문으로 지정된 리소스." #: ../../vars.rst:336 c2c977e93a6b466686c3ec774112b806 msgid "" "PyMuPDF treats any external link that contains a colon and does not start" " with `file:`, as `LINK_URI`." msgstr "PyMuPDF는 콜론을 포함하고 `file:` 로 시작하지 않는 모든 외부 링크를 `LINK_URI` 로 처리합니다." #: ../../vars.rst:343 f2f74244f1ff419e9d052ead3e767a51 msgid "3 -- Launch (open) another file (of any \"executable\" type)." msgstr "3 -- 다른 파일(모든 \"실행 가능한\" 유형)을 실행(열기)합니다." #: ../../vars.rst:345 80fd06d08b3a4bbd91c5550c158e44a4 msgid "" "|PyMuPDF| treats any external link that starts with `file:` or doesn't " "contain a colon, as `LINK_LAUNCH`." msgstr "|PyMuPDF| 는 `file:` 로 시작하거나 콜론을 포함하지 않는 모든 외부 링크를 `LINK_LAUNCH` 로 처리합니다." #: ../../vars.rst:352 953c280a5a2c4081b49b4428360d0b70 msgid "4 -- points to a named location." msgstr "4 -- 명명된 위치를 가리킵니다." #: ../../vars.rst:358 c2dd6d723df94a729c602ab39198e6e3 msgid "5 -- Points to a place in another PDF document." msgstr "5 -- 다른 PDF 문서의 위치를 가리킵니다." #: ../../vars.rst:365 13d9db49dc764ad2943a0bd89bf1eccd msgid "Link Destination Flags" msgstr "링크 대상 플래그" #: ../../vars.rst:367 d3b19de8c19a4cca93ae0614069136aa msgid "" "The rightmost byte of this integer is a bit field, so test the truth of " "these bits with the *&* operator." msgstr "이 정수의 가장 오른쪽 바이트는 비트 필드이므로 *&* 연산자로 이러한 비트의 참을 테스트하세요." #: ../../vars.rst:371 adfb385a3f204afa96eae840376cfaaf msgid "1 (bit 0) Top left x value is valid" msgstr "1 (비트 0) 왼쪽 상단 x 값이 유효함" #: ../../vars.rst:373 ../../vars.rst:379 ../../vars.rst:385 ../../vars.rst:391 #: ../../vars.rst:397 ../../vars.rst:403 ../../vars.rst:409 #: 45d5d66079ad4119a37daf32345170ea 68ec9fd7a3194726abc3dd123922506c #: 802dc57d84e340dda07eb08e1fa533ea a78880c24f194e0183ba7acb53112b5c #: b54e07447ebd48d08adcaa6c2330efd7 cc044f3983144e34b9ec5e221c661f84 #: de33e1ca908e4329acf8e771d8062395 msgid "bool" msgstr "bool" #: ../../vars.rst:377 f6bb945288e84c2ea7af6535127f5686 msgid "2 (bit 1) Top left y value is valid" msgstr "2 (비트 1) 왼쪽 상단 y 값이 유효함" #: ../../vars.rst:383 1429f391f08e4098bf3648e649655ce7 msgid "4 (bit 2) Bottom right x value is valid" msgstr "4 (비트 2) 오른쪽 하단 x 값이 유효함" #: ../../vars.rst:389 dd2f2b2b41774030b5c2a8b95d745273 msgid "8 (bit 3) Bottom right y value is valid" msgstr "8 (비트 3) 오른쪽 하단 y 값이 유효함" #: ../../vars.rst:395 62df816d97ee45ccab57344fe8d25a10 msgid "16 (bit 4) Horizontal fit" msgstr "16 (비트 4) 수평 맞춤" #: ../../vars.rst:401 78e6492677c146c4a8d9bf5ea9d48be1 msgid "32 (bit 5) Vertical fit" msgstr "32 (비트 5) 수직 맞춤" #: ../../vars.rst:407 40d05c050d174b918e1b5d3b4e8d4671 msgid "64 (bit 6) Bottom right x is a zoom figure" msgstr "64 (비트 6) 오른쪽 하단 x는 확대/축소 수치" #: ../../vars.rst:413 136d76a8f9eb46c88e7d3a181650da73 msgid "Annotation Related Constants" msgstr "주석 관련 상수" #: ../../vars.rst:414 0afb6c758143449fb56a0b04ab704888 msgid "See chapter 8.4.5, pp. 615 of the :ref:`AdobeManual` for details." msgstr "자세한 내용은 :ref:`AdobeManual` 615페이지의 8.4.5장을 참조하세요." #: ../../vars.rst:419 c080cb77d13c409a8faecbcbd760910c msgid "Annotation Types" msgstr "주석 유형" #: ../../vars.rst:420 d20a798f8f554b5d8529e31b8816197f msgid "" "These identifiers also cover **links** and **widgets**: the PDF " "specification technically handles them all in the same way, whereas " "|MuPDF| (and PyMuPDF) treats them as three basically different types of " "objects." msgstr "이 식별자는 **링크** 및 **위젯** 도 포함합니다: PDF 사양은 기술적으로 모두 동일한 방식으로 처리하지만, |MuPDF| (및 PyMuPDF)는 이를 기본적으로 세 가지 다른 유형의 객체로 처리합니다." #: ../../vars.rst:457 713c32c363bd480cba99fcadd3fa3555 msgid "Annotation Flag Bits" msgstr "주석 플래그 비트" #: ../../vars.rst:474 9fdaae6162c54afea314aa849239b470 msgid "Annotation Line Ending Styles" msgstr "주석 선 끝 스타일" #: ../../vars.rst:490 3e407ea8c72444ebba3331d472a6a25a msgid "Widget Constants" msgstr "위젯 상수" #: ../../vars.rst:495 96ec99e51a7e4985a737ba02c17541ac msgid "Widget Types (*field_type*)" msgstr "위젯 유형 (*field_type*)" #: ../../vars.rst:508 755546e537074e1aaa1b792a365b879a msgid "Text Widget Subtypes (*text_format*)" msgstr "텍스트 위젯 하위 유형 (*text_format*)" #: ../../vars.rst:519 2d435f5842544cc5ad764fc27d6e30db msgid "Widget flags (*field_flags*)" msgstr "위젯 플래그 (*field_flags*)" #: ../../vars.rst:520 1be2e082d5f24d78b93633d42c3ab6b3 msgid "**Common to all field types**::" msgstr "**모든 필드 유형에 공통**::" #: ../../vars.rst:526 9a70d77fe1724d00a6baf6703369f739 msgid "**Text widgets**::" msgstr "**텍스트 위젯**::" #: ../../vars.rst:536 a70d3da20a7a4996843ce3b94a65f844 msgid "**Button widgets**::" msgstr "**버튼 위젯**::" #: ../../vars.rst:543 33f39c42d34a4fa49140b193aec55d00 msgid "**Choice widgets**::" msgstr "**선택 위젯**::" #: ../../vars.rst:556 05602853929445cfb71dfca4dc7fb284 msgid "PDF Standard Blend Modes" msgstr "PDF 표준 블렌드 모드" #: ../../vars.rst:558 d1da99abe9c4449e9af156616a68a1c3 msgid "For an explanation see :ref:`AdobeManual`, page 324::" msgstr "설명은 :ref:`AdobeManual` 324페이지를 참조하세요::" #: ../../vars.rst:581 72834b1fb7fb47c6982ed3593f7600d3 msgid "Stamp Annotation Icons" msgstr "스탬프 주석 아이콘" #: ../../vars.rst:582 71aa56b7b0644cef8475af050d9bccf3 msgid "MuPDF has defined the following icons for **rubber stamp** annotations::" msgstr "MuPDF는 **고무 스탬프** 주석에 대해 다음 아이콘을 정의했습니다::" #: ../../footer.rst:46 7b627849860f4ae7a235d36a44c7c566 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/version.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-02 16:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../version.rst:1 d1fbe6ff1d5549fb8be875f6d37c584b msgid "This documentation covers PyMuPDF |version|." msgstr "이 문서는 PyMuPDF |version| 을 다룹니다." #: ../../version.rst:3 133bf913bb004c8ca82964184ed7628c msgid "" "The major and minor versions of PyMuPDF and MuPDF will always be the " "same. Only the third qualifier (patch level) may deviate from that of " "MuPDF." msgstr "|PyMuPDF| 와 |MuPDF| 의 주 버전과 부 버전은 항상 동일합니다. 세 번째 한정자(패치 레벨)만 |MuPDF| 와 다를 수 있습니다." #: ../../version.rst:5 994720d99f72419ebd711b2cf71dcefb msgid "" "Typically PyMuPDF is released more frequently than MuPDF so it will often" " be the case that the patch level of PyMuPDF will be greater than the " "embedded MuPDF." msgstr "일반적으로 PyMuPDF는 MuPDF보다 더 자주 릴리스되므로, PyMuPDF의 패치 레벨이 내장된 MuPDF보다 높은 경우가 많습니다." #: ../../version.rst:9 371aa251e8314b9aad7c870f54636f80 msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2." msgstr "예를 들어 PyMuPDF-1.24.5는 MuPDF-1.24.2를 포함합니다." #: ../../version.rst:11 7c7d7d87d7e14441959c236fee7d2ee5 msgid "Also see `pymupdf_version` and `mupdf_version`." msgstr "`pymupdf_version` 및 `mupdf_version` 도 참조하세요." #~ msgid "" #~ "The major and minor versions of " #~ "|PyMuPDF| and |MuPDF| will always be " #~ "the same. Only the third qualifier " #~ "(patch level) may deviate from that " #~ "of |MuPDF|." #~ msgstr "" ================================================ FILE: docs/locales/ko/LC_MESSAGES/widget.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 9be7fe8ece684722b20723502ba6e81a msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 4fd0b4c61f30429d928c92ebb1081bc3 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 8395c05a667445b68d678e31a6c9296f msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../widget.rst:7 b5bf7834aa6d4acc80837502b85e97c1 msgid "Widget" msgstr "Widget (위젯)" #: ../../widget.rst:9 db658752009445c5a3459712f6b25c8f msgid "|pdf_only_class|" msgstr "|pdf_only_class|" #: ../../widget.rst:11 d1312e8bf60148598975d49439011b6c msgid "" "This class represents a PDF Form field, also called a \"widget\". " "Throughout this documentation, we are using these terms synonymously. " "Fields technically are a special case of PDF annotations, which allow " "users with limited permissions to enter information in a PDF. This is " "primarily used for filling out forms." msgstr "이 클래스는 PDF 폼 필드(또한 \"위젯\"이라고도 함)를 나타냅니다. 이 문서 전체에서 이 용어들을 동의어로 사용합니다. 필드는 기술적으로 PDF 주석의 특수한 경우이며, 제한된 권한을 가진 사용자가 PDF에 정보를 입력할 수 있게 합니다. 이것은 주로 양식 작성에 사용됩니다." #: ../../widget.rst:13 6befe4905ed146a2ab8cfd92d1d923bc msgid "" "Like annotations, widgets live on PDF pages. Similar to annotations, the " "first widget on a page is accessible via :attr:`Page.first_widget` and " "subsequent widgets can be accessed via the :attr:`Widget.next` property." msgstr "주석과 마찬가지로 위젯은 PDF 페이지에 존재합니다. 주석과 유사하게, 페이지의 첫 번째 위젯은 :attr:`Page.first_widget` 를 통해 접근할 수 있으며, 이후 위젯은 :attr:`Widget.next` 속성을 통해 접근할 수 있습니다." #: ../../widget.rst:15 f5dcbec91e9446b1bc886ab894d9b27c msgid "" "Like annotations, widgets also lose connection to their page when the " "page becomes unavailable, please see `here " "`_ for details. This is relevant " "especially when updating the widget: this will fail if the original page " "object is no longer available." msgstr "주석과 마찬가지로 위젯도 페이지를 사용할 수 없게 되면 페이지와의 연결을 잃습니다. 자세한 내용은 `여기 `_ 를 참조하세요. 이것은 특히 위젯을 업데이트할 때 관련이 있습니다: 원본 페이지 객체를 더 이상 사용할 수 없으면 실패합니다." #: ../../widget.rst:17 23ea64f7e0164b6788a0c02783469bef msgid "" "*(Changed in version 1.16.0)* MuPDF no longer treats widgets as a subset " "of general annotations. Consequently, :attr:`Page.first_annot` and " ":meth:`Annot.next` will deliver **non-widget annotations exclusively**, " "and be ``None`` if only form fields exist on a page. Vice versa, " ":attr:`Page.first_widget` and :meth:`Widget.next` will only show widgets." " This design decision is purely internal to MuPDF; technically, links, " "annotations and fields have a lot in common and also continue to share " "the better part of their code within (Py-) MuPDF." msgstr "*(버전 1.16.0에서 변경)* |MuPDF| 는 더 이상 위젯을 일반 주석의 하위 집합으로 처리하지 않습니다. 결과적으로 :attr:`Page.first_annot` 및 :meth:`Annot.next` 는 **위젯이 아닌 주석만** 제공하며, 페이지에 폼 필드만 존재하는 경우 ``None`` 이 됩니다. 반대로 :attr:`Page.first_widget` 및 :meth:`Widget.next` 는 위젯만 표시합니다. 이 설계 결정은 순전히 |MuPDF| 내부적인 것입니다. 기술적으로 링크, 주석 및 필드는 많은 공통점이 있으며 (Py-) |MuPDF| 내에서 코드의 대부분을 계속 공유합니다." #: ../../widget.rst:20 4c382afc381347e990494e4d0e1c78f7 msgid "**Class API**" msgstr "**클래스 API**" #: ../../widget.rst:26 f56bf175166444f7920a252639d09199 msgid "*New in version 1.18.15*" msgstr "*버전 1.18.15에서 새로 추가됨*" #: ../../widget.rst:28 00cee4b5b9734e0484ff17718afb7614 msgid "" "Return the names of On / Off (i.e. selected / clicked or not) states a " "button field may have. While the 'Off' state usually is also named like " "so, the 'On' state is often given a name relating to the functional " "context, for example 'Yes', 'Female', etc." msgstr "버튼 필드가 가질 수 있는 On/Off(즉, 선택/클릭 여부) 상태의 이름을 반환합니다. 'Off' 상태는 일반적으로 그렇게 명명되지만, 'On' 상태는 기능적 맥락과 관련된 이름(예: 'Yes', 'Female' 등)이 자주 지정됩니다." #: ../../widget.rst:30 7d6a3ae94e2742d5a84bf396789e24e1 msgid "" "This method helps finding out the possible values of :attr:`field_value` " "in these cases." msgstr "이 메서드는 이러한 경우 :attr:`field_value` 의 가능한 값을 찾는 데 도움이 됩니다." #: ../../widget.rst 3ba59739b0504accbfb45a04c8b24a7f #: ac61f1c8af7547ca9e4696981cd7c001 msgid "returns" msgstr "반환값" #: ../../widget.rst:32 dc0ef726c74e4a249337ee6f20cdd308 msgid "" "a dictionary with the names of 'On' and 'Off' for the *normal* and the " "*pressed-down* appearance of button widgets. The following example shows " "that the \"selected\" value is \"Male\":" msgstr "*normal* 및 *pressed-down* 모양의 버튼 위젯에 대한 'On' 및 'Off' 이름을 가진 딕셔너리. 다음 예제는 \"selected\" 값이 \"Male\"임을 보여줍니다:" #: ../../widget.rst:40 dca66819e96f4f19a12d511c1409a188 msgid "New in version 1.22.2" msgstr "버전 1.22.2에서 새로 추가됨" #: ../../widget.rst:42 72cfa1c4a4794fdebcf176d87534ed11 msgid "" "Return the value of the \"ON\" state of check boxes and radio buttons. " "For check boxes this is always the value \"Yes\". For radio buttons, this" " is the value to select / activate the button." msgstr "체크박스 및 라디오 버튼의 \"ON\" 상태 값을 반환합니다. 체크박스의 경우 이것은 항상 \"Yes\" 값입니다. 라디오 버튼의 경우 이것은 버튼을 선택/활성화하는 값입니다." #: ../../widget.rst:44 ef6612006aa6463b9f062200357220e8 msgid "" "the value that sets the button to \"selected\". For non-checkbox, non-" "radiobutton fields, always `None` is returned. For check boxes the return" " is `True`. For radio buttons this is the value \"Male\" in the following" " example:" msgstr "버튼을 \"selected\"로 설정하는 값. 체크박스가 아니고 라디오 버튼이 아닌 필드의 경우 항상 `None` 이 반환됩니다. 체크박스의 경우 반환값은 `True` 입니다. 라디오 버튼의 경우 다음 예제에서 값은 \"Male\"입니다:" #: ../../widget.rst:51 149007e65bf84de18e2eb1c2afe8bf71 msgid "" "So for check boxes and radio buttons, the recommended method to set them " "to \"selected\", or to check the state is the following:" msgstr "따라서 체크박스 및 라디오 버튼의 경우 \"selected\"로 설정하거나 상태를 확인하는 권장 방법은 다음과 같습니다:" #: ../../widget.rst:60 9b42ee70ae144a8b92f71cf466956b05 msgid "" "After any changes to a widget, this **method must be used** to reflect " "changes in the PDF [#f1]_." msgstr "위젯에 대한 변경 사항이 있은 후, PDF에 변경 사항을 반영하려면 이 **메서드를 사용해야 합니다** [#f1]_." #: ../../widget.rst f9afde507f67494fbafed9da093edc2c msgid "Parameters" msgstr "매개변수" #: ../../widget.rst:62 4a0049c3506c40d99e4aba3b7c10c027 msgid "" "if ``True``, the widget's :attr:`Widget.field_flags` are copied to the " "``Parent`` object (if present) and all widgets named in its ``Kids`` " "array. This provides a convenient way to -- for example -- set all " "instances of the widget to read-only, no matter on which page they may " "occur [#f2]_." msgstr "``True`` 인 경우 위젯의 :attr:`Widget.field_flags` 가 ``Parent`` 객체(존재하는 경우)와 ``Kids`` 배열에 명명된 모든 위젯에 복사됩니다. 이를 통해 예를 들어 위젯의 모든 인스턴스를 읽기 전용으로 설정할 수 있는 편리한 방법을 제공합니다. 어떤 페이지에 나타나든 상관없이 [#f2]_." #: ../../widget.rst:66 ad4e8312e49447b68aa62039c7138968 msgid "" "Reset the field's value to its default -- if defined -- or remove it. Do " "not forget to issue :meth:`update` afterwards." msgstr "필드 값을 기본값으로 재설정합니다(정의된 경우) 또는 제거합니다. 이후 :meth:`update` 를 호출하는 것을 잊지 마세요." #: ../../widget.rst:70 ac472167a7e14f4290ac8a193c79160c msgid "" "Point to the next form field on the page. The last widget returns " "``None``." msgstr "페이지의 다음 폼 필드를 가리킵니다. 마지막 위젯은 ``None`` 을 반환합니다." #: ../../widget.rst:74 1f2d580b4eca4c468f4a0e6592281c85 msgid "" "A list of up to 4 floats defining the field's border color. Default value" " is ``None`` which causes border style and border width to be ignored." msgstr "필드의 테두리 색상을 정의하는 최대 4개의 float 목록. 기본값은 ``None`` 으로, 테두리 스타일과 테두리 너비가 무시됩니다." #: ../../widget.rst:78 4d75daab990241b7a3b26a0e4ab3a3f3 msgid "" "A string defining the line style of the field's border. See " ":attr:`Annot.border`. Default is \"s\" (\"Solid\") -- a continuous line. " "Only the first character (upper or lower case) will be regarded when " "creating a widget." msgstr "필드 테두리의 선 스타일을 정의하는 문자열. :attr:`Annot.border` 를 참조하세요. 기본값은 \"s\"(\"Solid\") -- 연속선입니다. 위젯을 생성할 때 첫 번째 문자(대문자 또는 소문자)만 고려됩니다." #: ../../widget.rst:82 a3b4c3bbfb544efd99ac42ab92c5d596 msgid "A float defining the width of the border line. Default is 1." msgstr "테두리 선의 너비를 정의하는 float. 기본값은 1입니다." #: ../../widget.rst:86 8abf38d7b6a540acb99b929363d614c3 msgid "" "A list/tuple of integers defining the dash properties of the border line." " This is only meaningful if *border_style == \"D\"* and " ":attr:`border_color` is provided." msgstr "테두리 선의 대시 속성을 정의하는 정수 목록/튜플. *border_style == \"D\"* 이고 :attr:`border_color` 가 제공된 경우에만 의미가 있습니다." #: ../../widget.rst:90 89fa9c260a8c49f0b07ea1b251cece4e msgid "" "Python sequence of strings defining the valid choices of list boxes and " "combo boxes. For these widget types, this property is mandatory and must " "contain at least two items. Ignored for other types." msgstr "리스트 박스 및 콤보 박스의 유효한 선택 항목을 정의하는 문자열의 Python 시퀀스. 이러한 위젯 유형의 경우 이 속성은 필수이며 최소 두 개의 항목을 포함해야 합니다. 다른 유형에서는 무시됩니다." #: ../../widget.rst:94 d429d2ef1dd644d79f98b280f55ad276 msgid "" "A mandatory string defining the field's name. No checking for duplicates " "takes place." msgstr "필드 이름을 정의하는 필수 문자열. 중복 확인은 수행되지 않습니다." #: ../../widget.rst:98 3e1f3a12889b40cdb2687c5e1e275082 msgid "" "An optional string containing an \"alternate\" field name. Typically used" " for any notes, help on field usage, etc. Default is the field name." msgstr "\"대체\" 필드 이름을 포함하는 선택적 문자열. 일반적으로 필드 사용에 대한 메모, 도움말 등에 사용됩니다. 기본값은 필드 이름입니다." #: ../../widget.rst:102 02bb3f5a570947e98e225720d915a4b5 msgid "The value of the field." msgstr "필드의 값." #: ../../widget.rst:106 159866e898664171a44d8b61241d2731 msgid "" "An integer defining a large amount of properties of a field. Be careful " "when changing this attribute as this may change the field type." msgstr "필드의 많은 속성을 정의하는 정수. 이 속성을 변경할 때는 주의하세요. 필드 유형이 변경될 수 있습니다." #: ../../widget.rst:110 62966a5f68404db5822a72647d202b90 msgid "" "A mandatory integer defining the field type. This is a value in the range" " of 0 to 6. It cannot be changed when updating the widget." msgstr "필드 유형을 정의하는 필수 정수. 이것은 0부터 6까지의 범위 값입니다. 위젯을 업데이트할 때 변경할 수 없습니다." #: ../../widget.rst:114 a9fbed37d8be4f51b900e87522083cb4 msgid "A string describing (and derived from) the field type." msgstr "필드 유형을 설명하는(및 필드 유형에서 파생된) 문자열." #: ../../widget.rst:118 0893214230bb4b998907cfb864bf8047 msgid "A list of up to 4 floats defining the field's background color." msgstr "필드의 배경색을 정의하는 최대 4개의 float 목록." #: ../../widget.rst:122 864cf589b08549bca7920c38f91caa48 msgid "The caption string of a button-type field." msgstr "버튼 유형 필드의 캡션 문자열." #: ../../widget.rst:126 d1ed58b8e9784d0f9f5368aa781d8db2 msgid "A bool indicating the signing status of a signature field, else ``None``." msgstr "서명 필드의 서명 상태를 나타내는 bool, 그렇지 않으면 ``None``." #: ../../widget.rst:130 fd9f9f5619ec4ae69d780dcfdcaf1cf5 msgid "The rectangle containing the field." msgstr "필드를 포함하는 사각형." #: ../../widget.rst:134 32a4055906494c169f91575f408fd75e msgid "" "A list of **1, 3 or 4 floats** defining the text color. Default value is " "black (`[0, 0, 0]`)." msgstr "텍스트 색상을 정의하는 **1, 3 또는 4개의 float** 목록. 기본값은 검은색(`[0, 0, 0]`)입니다." #: ../../widget.rst:138 f951f27a175047e6ad58a7ee9d45d202 msgid "" "A string defining the font to be used. Default and replacement for " "invalid values is *\"Helv\"*. For valid font reference names see the " "table below." msgstr "사용할 글꼴을 정의하는 문자열. 기본값 및 잘못된 값의 대체값은 *\"Helv\"* 입니다. 유효한 글꼴 참조 이름은 아래 표를 참조하세요." #: ../../widget.rst:142 93d6bab5e8ed4964b445aaff3f5a666e msgid "" "A float defining the text :data:`fontsize`. Default value is zero, which " "causes PDF viewer software to dynamically choose a size suitable for the " "annotation's rectangle and text amount." msgstr "텍스트 :data:`fontsize` 를 정의하는 float. 기본값은 0이며, PDF 뷰어 소프트웨어가 주석의 사각형과 텍스트 양에 적합한 크기를 동적으로 선택하도록 합니다." #: ../../widget.rst:146 a1ded660efa640cd9b872d5a1fffdb1f msgid "" "An integer defining the maximum number of text characters. PDF viewers " "will (should) not accept a longer text." msgstr "텍스트 문자의 최대 개수를 정의하는 정수. PDF 뷰어는 더 긴 텍스트를 받아들이지 않습니다(받아들이지 않아야 합니다)." #: ../../widget.rst:150 68eac259cd954e619832866bde7c37e3 msgid "" "An integer defining acceptable text types (e.g. numeric, date, time, " "etc.). For reference only for the time being -- will be ignored when " "creating or updating widgets." msgstr "허용 가능한 텍스트 유형(예: 숫자, 날짜, 시간 등)을 정의하는 정수. 현재는 참고용으로만 사용되며 위젯을 생성하거나 업데이트할 때 무시됩니다." #: ../../widget.rst:154 9df210c84ecd4845b952f6d3cc9195cc msgid "The PDF :data:`xref` of the widget." msgstr "위젯의 PDF :data:`xref`." #: ../../widget.rst:158 ../../widget.rst:164 ../../widget.rst:170 #: ../../widget.rst:176 ../../widget.rst:182 6ac3abf289404eeaafe2d71129cccf4f #: 8034826ba5bf458fa878c3dfe0dcb46e 8155dfc13cad413eb75cd134942ce80a #: b8eb6a539c4941e6b3212dc4474dfd75 c5b33ed64c7043db966de5404c881830 msgid "New in version 1.16.12" msgstr "버전 1.16.12에서 새로 추가됨" #: ../../widget.rst:160 27f8421d8a374cd587fc385b05348e06 msgid "" "JavaScript text (unicode) for an action associated with the widget, or " "``None``. This is the only script action supported for **button type** " "widgets." msgstr "위젯과 연결된 동작에 대한 JavaScript 텍스트(유니코드) 또는 ``None``. 이것은 **버튼 유형** 위젯에서 지원하는 유일한 스크립트 동작입니다." #: ../../widget.rst:166 bbc99abeab574327895dbdfadb016871 msgid "" "JavaScript text (unicode) to be performed when the user types a key-" "stroke into a text field or combo box or modifies the selection in a " "scrollable list box. This action can check the keystroke for validity and" " reject or modify it. ``None`` if not present." msgstr "사용자가 텍스트 필드나 콤보 박스에 키 입력을 하거나 스크롤 가능한 리스트 박스에서 선택을 수정할 때 실행할 JavaScript 텍스트(유니코드). 이 동작은 키 입력의 유효성을 확인하고 거부하거나 수정할 수 있습니다. 존재하지 않으면 ``None``." #: ../../widget.rst:172 49c953662fc846e4ab3a5754771075d5 msgid "" "JavaScript text (unicode) to be performed before the field is formatted " "to display its current value. This action can modify the field’s value " "before formatting. ``None`` if not present." msgstr "필드가 현재 값을 표시하기 위해 포맷되기 전에 실행할 JavaScript 텍스트(유니코드). 이 동작은 포맷하기 전에 필드 값을 수정할 수 있습니다. 존재하지 않으면 ``None``." #: ../../widget.rst:178 f099a7380085444088d138037fc88009 msgid "" "JavaScript text (unicode) to be performed when the field’s value is " "changed. This action can check the new value for validity. ``None`` if " "not present." msgstr "필드 값이 변경될 때 실행할 JavaScript 텍스트(유니코드). 이 동작은 새 값의 유효성을 확인할 수 있습니다. 존재하지 않으면 ``None``." #: ../../widget.rst:184 195412bc8f7645c7af94839cbeef56c7 msgid "" "JavaScript text (unicode) to be performed to recalculate the value of " "this field when that of another field changes. ``None`` if not present." msgstr "다른 필드의 값이 변경될 때 이 필드의 값을 다시 계산하기 위해 실행할 JavaScript 텍스트(유니코드). 존재하지 않으면 ``None``." #: ../../widget.rst:188 ../../widget.rst:194 be53028b2eeb496e91e645ddedbecf73 #: caaac82450ae43fd84f1684ee16cc1aa msgid "New in version 1.22.6" msgstr "버전 1.22.6에서 새로 추가됨" #: ../../widget.rst:190 66757bee21264b4591997469672bf407 msgid "" "JavaScript text (unicode) to be performed on losing the focus of this " "field. ``None`` if not present." msgstr "이 필드의 포커스를 잃을 때 실행할 JavaScript 텍스트(유니코드). 존재하지 않으면 ``None``." #: ../../widget.rst:196 6d86df2f110242b9b322d96488384f39 msgid "" "JavaScript text (unicode) to be performed on focusing this field. " "``None`` if not present." msgstr "이 필드에 포커스를 맞출 때 실행할 JavaScript 텍스트(유니코드). 존재하지 않으면 ``None``." #: ../../widget.rst:200 31230d72253b4583a09b8159f40329f4 msgid "For **adding** or **changing** one of the above scripts," msgstr "위의 스크립트 중 하나를 **추가** 하거나 **변경** 하려면," #: ../../widget.rst:201 3d2a3d82396442afb52dfc4cdd423495 msgid "" "just put the appropriate JavaScript source code in the widget attribute. " "To **remove** a script, set the respective attribute to ``None``." msgstr "위젯 속성에 적절한 JavaScript 소스 코드를 넣으세요. 스크립트를 **제거** 하려면 해당 속성을 ``None`` 으로 설정하세요." #: ../../widget.rst:204 8ae6388eebe44c248ddac814e91ade75 msgid "Button fields only support :attr:`script`." msgstr "버튼 필드는 :attr:`script` 만 지원합니다." #: ../../widget.rst:205 eaf4aaf730aa470bac28fa589c1d9a75 msgid "Other script entries will automatically be set to ``None``." msgstr "다른 스크립트 항목은 자동으로 ``None`` 으로 설정됩니다." #: ../../widget.rst:207 1574012d10e54a92850485e41d1ffedf msgid "" "It is worthwhile to look at `this " "`_ manual with lots of " "information about Adobe's standard scripts for various field types. For " "example, if you want to add a text field representing a date, you may " "want to store the following scripts. They will ensure pattern-compatible " "date formats and display date pickers in supporting viewers::" msgstr "다양한 필드 유형에 대한 Adobe의 표준 스크립트에 대한 많은 정보가 포함된 `이 매뉴얼 `_ 을 살펴보는 것이 좋습니다. 예를 들어, 날짜를 나타내는 텍스트 필드를 추가하려면 다음 스크립트를 저장할 수 있습니다. 이것들은 패턴 호환 날짜 형식을 보장하고 지원하는 뷰어에서 날짜 선택기를 표시합니다::" #: ../../widget.rst:219 c65b215c2ad34e7488b15662ebd4d3bb msgid "Standard Fonts for Widgets" msgstr "위젯용 표준 글꼴" #: ../../widget.rst:220 cdad1a06914d4e0096cf6f84a03b0434 msgid "" "Widgets use their own resources object ``/DR``. A widget resources object" " must at least contain a ``/Font`` object. Widget fonts are independent " "from page fonts. We currently support the 14 PDF base fonts using the " "following fixed reference names, or any name of an already existing field" " font. When specifying a text font for new or changed widgets, **either**" " choose one in the first table column (upper and lower case supported), " "**or** one of the already existing form fonts. In the latter case, " "spelling must exactly match." msgstr "위젯은 자체 리소스 객체 ``/DR`` 를 사용합니다. 위젯 리소스 객체는 최소한 ``/Font`` 객체를 포함해야 합니다. 위젯 글꼴은 페이지 글꼴과 독립적입니다. 현재 다음 고정 참조 이름을 사용하여 14개의 PDF 기본 글꼴을 지원하거나, 이미 존재하는 필드 글꼴의 이름을 사용합니다. 새 위젯이나 변경된 위젯에 대한 텍스트 글꼴을 지정할 때 **첫 번째 테이블 열에서 하나를 선택하거나** (대소문자 지원), **이미 존재하는 폼 글꼴 중 하나를 선택** 하세요. 후자의 경우 철자가 정확히 일치해야 합니다." #: ../../widget.rst:222 7fd5734a55b445cc854e109cbc203e17 msgid "" "To find out already existing field fonts, inspect the list " ":attr:`Document.FormFonts`." msgstr "이미 존재하는 필드 글꼴을 확인하려면 :attr:`Document.FormFonts` 목록을 검사하세요." #: ../../widget.rst:225 989af4e78c0847918dbff49079157c49 msgid "**Reference**" msgstr "**참조**" #: ../../widget.rst:225 2a3d30a6f94b40939fd222ac5505a0c3 msgid "**Base14 Fontname**" msgstr "**Base14 글꼴 이름**" #: ../../widget.rst:227 352a551d7b7d4200932f4f74ab639993 msgid "CoBI" msgstr "CoBI" #: ../../widget.rst:227 97b97d88ac2049608397f18450ce94f9 msgid "Courier-BoldOblique" msgstr "Courier-BoldOblique" #: ../../widget.rst:228 5784d31036e8451ea00333ebfc861db7 msgid "CoBo" msgstr "CoBo" #: ../../widget.rst:228 f62fddbdd0ec4ca5a7de461de53b6f58 msgid "Courier-Bold" msgstr "Courier-Bold" #: ../../widget.rst:229 7b2ab33a398843e2b2becf0f64045392 msgid "CoIt" msgstr "CoIt" #: ../../widget.rst:229 053e2cadb71446e3938febe4ef984f31 msgid "Courier-Oblique" msgstr "Courier-Oblique" #: ../../widget.rst:230 4f7d11706d4b41ec968dff1ac8fb677f msgid "Cour" msgstr "Cour" #: ../../widget.rst:230 bc034dde385b406280bef75f575a2672 msgid "Courier" msgstr "Courier" #: ../../widget.rst:231 ff774f899f274ee5a81ee1e6d1959b8c msgid "HeBI" msgstr "HeBI" #: ../../widget.rst:231 172ee9521a2348cd9f506babd8af5f10 msgid "Helvetica-BoldOblique" msgstr "Helvetica-BoldOblique" #: ../../widget.rst:232 79d0f51c58f54f67a759e45d17d9ffc6 msgid "HeBo" msgstr "HeBo" #: ../../widget.rst:232 467053b50fdf4b6a970d48f6d4cc2e1a msgid "Helvetica-Bold" msgstr "Helvetica-Bold" #: ../../widget.rst:233 5abb199e534a4b2985760322156b7819 msgid "HeIt" msgstr "HeIt" #: ../../widget.rst:233 8d472db0bc5a44caa9de71c566f7cb7e msgid "Helvetica-Oblique" msgstr "Helvetica-Oblique" #: ../../widget.rst:234 d03174f7c84045ea9ef98507a09fa344 msgid "Helv" msgstr "Helv" #: ../../widget.rst:234 bbec46b6db884fb29167ffc50a0c7dcb msgid "Helvetica **(default)**" msgstr "Helvetica **(기본값)**" #: ../../widget.rst:235 cd1c089129784daeb903d5ef116ea70b msgid "Symb" msgstr "Symb" #: ../../widget.rst:235 81ad28b580f44ba78513b1abebbc40bc msgid "Symbol" msgstr "Symbol" #: ../../widget.rst:236 de4c92826dc94244b1b8ef026ab90a2e msgid "TiBI" msgstr "TiBI" #: ../../widget.rst:236 3dc417d13f2d4a6cbb1233643dc93f65 msgid "Times-BoldItalic" msgstr "Times-BoldItalic" #: ../../widget.rst:237 43969ece08334ca685bd92f021cd1884 msgid "TiBo" msgstr "TiBo" #: ../../widget.rst:237 32b0cc34477144ffb88eb7565f2a0533 msgid "Times-Bold" msgstr "Times-Bold" #: ../../widget.rst:238 a1252968a11c4601b7341a5c9ad95394 msgid "TiIt" msgstr "TiIt" #: ../../widget.rst:238 8cdd804d025940c8b5d05a9397419bdc msgid "Times-Italic" msgstr "Times-Italic" #: ../../widget.rst:239 4d07f298c6d14909b518fad20ea5e681 msgid "TiRo" msgstr "TiRo" #: ../../widget.rst:239 b7c540028a3d4cedb72159dba9849432 msgid "Times-Roman" msgstr "Times-Roman" #: ../../widget.rst:240 58ea0b46026f4588b999a9ca93163980 msgid "ZaDb" msgstr "ZaDb" #: ../../widget.rst:240 2e0483edf38749a1928b25d20ab9055a msgid "ZapfDingbats" msgstr "ZapfDingbats" #: ../../widget.rst:243 a31f0eb06f284c738ae3404fb14e5e42 msgid "" "You are generally free to use any font for every widget. However, we " "recommend using ``ZaDb`` (\"ZapfDingbats\") and :data:`fontsize` 0 for " "check boxes: typical viewers will put a correctly sized tickmark in the " "field's rectangle, when it is clicked." msgstr "일반적으로 모든 위젯에 대해 어떤 글꼴이든 자유롭게 사용할 수 있습니다. 그러나 체크박스의 경우 ``ZaDb`` (\"ZapfDingbats\") 및 :data:`fontsize` 0을 사용하는 것을 권장합니다: 일반적인 뷰어는 클릭할 때 필드의 사각형에 올바른 크기의 체크 표시를 넣습니다." #: ../../widget.rst:246 25ed10dbd2a14216bbd4ed04f57c98cd msgid "Supported Widget Types" msgstr "지원되는 위젯 유형" #: ../../widget.rst:247 8cb59d1d5bd14f098f5fc408b8849853 msgid "" "PyMuPDF supports the creation and update of many, but not all widget " "types." msgstr "|PyMuPDF| 는 많은 위젯 유형의 생성 및 업데이트를 지원하지만, 모든 위젯 유형을 지원하는 것은 아닙니다." #: ../../widget.rst:249 8461bca05ec547fabc82884dedd125bb msgid "text (`PDF_WIDGET_TYPE_TEXT`)" msgstr "텍스트 (`PDF_WIDGET_TYPE_TEXT`)" #: ../../widget.rst:250 4c1a2929bc174c79bd4b539f47d803f2 msgid "push button (`PDF_WIDGET_TYPE_BUTTON`)" msgstr "푸시 버튼 (`PDF_WIDGET_TYPE_BUTTON`)" #: ../../widget.rst:251 c8546d5d5e834b6bb9bf78579650d52d msgid "check box (`PDF_WIDGET_TYPE_CHECKBOX`)" msgstr "체크박스 (`PDF_WIDGET_TYPE_CHECKBOX`)" #: ../../widget.rst:252 90c82cab0fe4443ab3b6c96bde056ab8 msgid "combo box (`PDF_WIDGET_TYPE_COMBOBOX`)" msgstr "콤보 박스 (`PDF_WIDGET_TYPE_COMBOBOX`)" #: ../../widget.rst:253 466344d91d064ed5a8d839e9b95d1988 msgid "list box (`PDF_WIDGET_TYPE_LISTBOX`)" msgstr "리스트 박스 (`PDF_WIDGET_TYPE_LISTBOX`)" #: ../../widget.rst:254 315046b3a75448dd80a03dc3287c68fe msgid "" "radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF does not currently " "support the **creation** of groups of (interconnected) radio buttons, " "where setting one button automatically unsets the other buttons in the " "group. The widget object also does not reflect the presence of a button " "group. However: consistently selecting (or unselecting) a radio button is" " supported. This includes correctly setting the value maintained in the " "owning button group. Selecting a radio button may be done by either " "assigning `True` or `field.on_state()` to the field value. **De-" "selecting** the button should be done assigning `False`." msgstr "라디오 버튼 (`PDF_WIDGET_TYPE_RADIOBUTTON`): |PyMuPDF| 는 현재 (상호 연결된) 라디오 버튼 그룹의 **생성** 을 지원하지 않습니다. 한 버튼을 설정하면 그룹의 다른 버튼이 자동으로 해제됩니다. 위젯 객체는 버튼 그룹의 존재를 반영하지 않습니다. 그러나: 라디오 버튼을 일관되게 선택(또는 선택 해제)하는 것은 지원됩니다. 여기에는 소유 버튼 그룹에서 유지되는 값을 올바르게 설정하는 것이 포함됩니다. 라디오 버튼을 선택하는 것은 필드 값에 `True` 또는 `field.on_state()` 를 할당하여 수행할 수 있습니다. 버튼 **선택 해제** 는 `False` 를 할당하여 수행해야 합니다." #: ../../widget.rst:255 b7ca95506bb743bf8bc9d51686c700fc msgid "" "signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only** -- no update or " "creation of signatures." msgstr "서명 (`PDF_WIDGET_TYPE_SIGNATURE`) **읽기 전용** -- 서명 업데이트 또는 생성 없음." #: ../../widget.rst:258 b53b3f3d840749208db6e32b83f6d04d msgid "Footnotes" msgstr "각주" #: ../../widget.rst:259 3eaba62dde8347e2a386454b987a2ed7 msgid "" "If you intend to re-access a new or updated field (e.g. for making a " "pixmap), make sure to reload the page first. Either close and re-open the" " document, or load another page first, or simply do `page = " "doc.reload_page(page)`." msgstr "새 필드나 업데이트된 필드에 다시 접근하려는 경우(예: 픽스맵 생성) 먼저 페이지를 다시 로드해야 합니다. 문서를 닫고 다시 열거나, 다른 페이지를 먼저 로드하거나, 간단히 `page = doc.reload_page(page)` 를 수행하세요." #: ../../widget.rst:261 148f6fb2b3f74450a3f794e012c04772 msgid "" "Among other purposes, ``Parent`` objects are also used to facilitate " "multiple occurrences of a field (on the same or on different pages). The " "``Kids`` array in this ``Parent`` object contains the cross references of" " all widgets that are \"copies\" of the same field. Whenever the field " "value of any \"kid\" widget is changed, all the other kids are " "immediately updated too. This is a very efficient way to handle multiple " "copies of the same field, e.g. for filling out forms. This simultaneous " "update only happens for :attr:`Widget.field value`. The new parameter " "``sync_flags`` extends this to :attr:`Widget.field_flags`. This cannot be" " automated in the same way as for the field value to allow for more " "flexibility." msgstr "다른 목적 중에서 ``Parent`` 객체는 필드의 여러 발생(같은 페이지 또는 다른 페이지에)을 용이하게 하는 데에도 사용됩니다. 이 ``Parent`` 객체의 ``Kids`` 배열은 동일한 필드의 \"복사본\"인 모든 위젯의 교차 참조를 포함합니다. \"kid\" 위젯의 필드 값이 변경될 때마다 다른 모든 kids도 즉시 업데이트됩니다. 이것은 같은 필드의 여러 복사본을 처리하는 매우 효율적인 방법입니다. 예를 들어 양식 작성에 사용됩니다. 이 동시 업데이트는 :attr:`Widget.field value` 에 대해서만 발생합니다. 새 매개변수 ``sync_flags`` 는 이를 :attr:`Widget.field_flags` 로 확장합니다. 더 많은 유연성을 허용하기 위해 필드 값과 동일한 방식으로 자동화할 수 없습니다." #: ../../footer.rst:46 00e495d1b07b4fb7afe8b0b3fc2b91b4 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/xml-class.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-12-03 09:30+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" #: ../../header.rst:-1 ed98a333448b4887914630a5de49f19a msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 cda7864bd6cb46cd906155fc2d06eb89 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "|PyMuPDF| 는 |PDF| 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 b693e8da5abe4227a083012cc8103fca msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "" "|PDF| 텍스트 추출, |PDF| 이미지 추출, |PDF| 변환, |PDF| 테이블, |PDF| 분할, |PDF| 생성, " "Pyodide, PyScript" #: ../../xml-class.rst:7 e50ebb3c4d5c4feda9d8282fdc5ffaeb msgid "Xml" msgstr "Xml" #: ../../xml-class.rst:11 8459b446e9bd4af5a330a44105902123 msgid "New in v1.21.0" msgstr "v1.21.0 에서 새로 추가됨" #: ../../xml-class.rst:13 d2debef004f14adfb792ab0d1ea7ea88 msgid "" "This represents an HTML or an XML node. It is a helper class intended to " "access the DOM (Document Object Model) content of a :ref:`Story` object." msgstr "" "이것은 HTML 또는 XML 노드를 나타냅니다. :ref:`Story` 객체의 DOM(Document Object Model) " "콘텐츠에 액세스하기 위한 헬퍼 클래스입니다." #: ../../xml-class.rst:15 14ab416bec2a4f7eb7f16bde88da3ce2 msgid "" "There is no need to ever directly construct an :ref:`Xml` object: after " "creating a :ref:`Story`, simply take :attr:`Story.body` -- which is an " "Xml node -- and use it to navigate your way through the story's DOM." msgstr "" ":ref:`Xml` 객체를 직접 생성할 필요는 없습니다: :ref:`Story` 를 생성한 후 단순히 " ":attr:`Story.body` (Xml 노드)를 가져와 스토리의 DOM을 탐색하는 데 사용하세요." #: ../../xml-class.rst:19 1ff0c788ff7545fb96b56af99ee3e0a7 msgid "**Method / Attribute**" msgstr "**메서드 / 속성**" #: ../../xml-class.rst:19 c32ff8180e3148f5ac8a1a0e4fbd44be msgid "**Description**" msgstr "**설명**" #: ../../xml-class.rst:21 bed67d61200b4f0aacbf74acccda80e3 msgid ":meth:`~.add_bullet_list`" msgstr ":meth:`~.add_bullet_list`" #: ../../xml-class.rst:21 58a9340e599b4537a98193837f61ed21 msgid "Add a :htmlTag:`ul` tag - bulleted list, context manager." msgstr ":htmlTag:`ul` 태그 추가 - 불릿 목록, 컨텍스트 매니저." #: ../../xml-class.rst:22 9c06610248694be19672bc74726fe7a1 msgid ":meth:`~.add_codeblock`" msgstr ":meth:`~.add_codeblock`" #: ../../xml-class.rst:22 e03fce97fc1c4485b4ed438dcfa589ea msgid "Add a :htmlTag:`pre` tag, context manager." msgstr ":htmlTag:`pre` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:23 3343ffac757b42c0a4b4f8d2ca00aaef msgid ":meth:`~.add_description_list`" msgstr ":meth:`~.add_description_list`" #: ../../xml-class.rst:23 23c0254efb6d4087bfa74d7ca410ec92 msgid "Add a :htmlTag:`dl` tag, context manager." msgstr ":htmlTag:`dl` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:24 9119362458ae4f17a2ef89f729f32373 msgid ":meth:`~.add_division`" msgstr ":meth:`~.add_division`" #: ../../xml-class.rst:24 7e04a7789665496db5078e87d6c81350 msgid "add a :htmlTag:`div` tag (renamed from “section”), context manager." msgstr ":htmlTag:`div` 태그 추가(“section”에서 이름 변경), 컨텍스트 매니저." #: ../../xml-class.rst:25 70fbc87b6be8435583e12d042de78491 msgid ":meth:`~.add_header`" msgstr ":meth:`~.add_header`" #: ../../xml-class.rst:25 7a4857be283545b1a78b05d4a7a0467b msgid "Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context manager." msgstr "헤더 태그 추가(:htmlTag:`h1` ~ :htmlTag:`h6` 중 하나), 컨텍스트 매니저." #: ../../xml-class.rst:26 6d66e3e04e534e5581b83b86bfb1a802 msgid ":meth:`~.add_horizontal_line`" msgstr ":meth:`~.add_horizontal_line`" #: ../../xml-class.rst:26 23f5482c4a9c4b7d875751cb669e52fd msgid "Add a :htmlTag:`hr` tag." msgstr ":htmlTag:`hr` 태그 추가." #: ../../xml-class.rst:27 e52a5dae28dd4513b88d05c0a4397237 msgid ":meth:`~.add_image`" msgstr ":meth:`~.add_image`" #: ../../xml-class.rst:27 7dd038f55d0941249c97a617a6075c4f msgid "Add a :htmlTag:`img` tag." msgstr ":htmlTag:`img` 태그 추가." #: ../../xml-class.rst:28 12026fdfd30347fb90a89a426dfa6843 msgid ":meth:`~.add_link`" msgstr ":meth:`~.add_link`" #: ../../xml-class.rst:28 c0d7d501bcfa4bf19e55d60774ed8346 msgid "Add a :htmlTag:`a` tag." msgstr ":htmlTag:`a` 태그 추가." #: ../../xml-class.rst:29 0c874d7eb4a24776b75476759d792ac3 msgid ":meth:`~.add_number_list`" msgstr ":meth:`~.add_number_list`" #: ../../xml-class.rst:29 8f48fb94a00a4274aa70418af5a315d8 msgid "Add a :htmlTag:`ol` tag, context manager." msgstr ":htmlTag:`ol` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:30 0d7d7fd6a8f442e3b330d2ed8e2d3ae1 msgid ":meth:`~.add_paragraph`" msgstr ":meth:`~.add_paragraph`" #: ../../xml-class.rst:30 e494547a61e44f3d9ea45f067f3de220 msgid "Add a :htmlTag:`p` tag." msgstr ":htmlTag:`p` 태그 추가." #: ../../xml-class.rst:31 ec19e6cf23634df79dde0434e20e634a msgid ":meth:`~.add_span`" msgstr ":meth:`~.add_span`" #: ../../xml-class.rst:31 5d96649419b84f9d9df8c0181ca44fb7 msgid "Add a :htmlTag:`span` tag, context manager." msgstr ":htmlTag:`span` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:32 9c5bbdc52ebf49b79197d08b06938f09 msgid ":meth:`~.add_subscript`" msgstr ":meth:`~.add_subscript`" #: ../../xml-class.rst:32 8c9a0c7d7e4d451fa071ed2e4743cc20 msgid "" "Add subscript text(:htmlTag:`sub` tag) - inline element, treated like " "text." msgstr "아래첨자 텍스트 추가(:htmlTag:`sub` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:33 56eea7a8c34c4e85bf3e08779e96b5ea msgid ":meth:`~.add_superscript`" msgstr ":meth:`~.add_superscript`" #: ../../xml-class.rst:33 ab759e84a2c3405eb25d36a03dd85997 msgid "" "Add subscript text (:htmlTag:`sup` tag) - inline element, treated like " "text." msgstr "위첨자 텍스트 추가(:htmlTag:`sup` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:34 6b9f3b0a71c84eeb8e13ba521a67288c msgid ":meth:`~.add_code`" msgstr ":meth:`~.add_code`" #: ../../xml-class.rst:34 ../../xml-class.rst:35 ../../xml-class.rst:36 #: ../../xml-class.rst:37 5bcb0d50e2bb46b2a6f792e3f82f23c0 #: 6286fc4f2bf34d939839ab3897974dac 663faea7bc304553a7c5bd23ae2ca42a #: 9d4732e3cf3447dbab81a3764aa04b3d msgid "Add code text (:htmlTag:`code` tag) - inline element, treated like text." msgstr "코드 텍스트 추가(:htmlTag:`code` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:35 36bddbf021b2409fb2aa99cf1356df2b msgid ":meth:`~.add_var`" msgstr ":meth:`~.add_var`" #: ../../xml-class.rst:36 05699304cc954f389932529cb4bc06b3 msgid ":meth:`~.add_samp`" msgstr ":meth:`~.add_samp`" #: ../../xml-class.rst:37 119929ceb54c4bd0922ef4710c88b67a msgid ":meth:`~.add_kbd`" msgstr ":meth:`~.add_kbd`" #: ../../xml-class.rst:38 fa67c459b1a94b2bb9d528bb4d279866 msgid ":meth:`~.add_text`" msgstr ":meth:`~.add_text`" #: ../../xml-class.rst:38 ../../xml-class.rst:162 #: 69ad3795bdff49a6a4c840098fbd1c8b c0627134be5440cd804e621517945927 msgid "Add a text string. Line breaks ``\\n`` are honored as :htmlTag:`br` tags." msgstr "텍스트 문자열 추가. 줄바꿈 ``\\n`` 은 :htmlTag:`br` 태그로 처리됩니다." #: ../../xml-class.rst:39 a98056baf3e04d2cb661f2078c05704a msgid ":meth:`~.append_child`" msgstr ":meth:`~.append_child`" #: ../../xml-class.rst:39 18c4dca5a6574be987d4c4161650ca4b msgid "Append a child node." msgstr "자식 노드를 추가합니다." #: ../../xml-class.rst:40 4809359e7dbf47d0a5f5134d701b689a msgid ":meth:`~.clone`" msgstr ":meth:`~.clone`" #: ../../xml-class.rst:40 d333be626baf48a8ac39807b83cdd8be msgid "Make a copy if this node." msgstr "이 노드의 복사본을 만듭니다." #: ../../xml-class.rst:41 9a1130d2be3142909ea7c0912166a0f2 msgid ":meth:`~.create_element`" msgstr ":meth:`~.create_element`" #: ../../xml-class.rst:41 1a46a86ef6e84eceb1c268058f46cd85 msgid "Make a new node with a given tag name." msgstr "주어진 태그 이름으로 새 노드를 만듭니다." #: ../../xml-class.rst:42 db997b2687de482b83f5bc357fc4b215 msgid ":meth:`~.create_text_node`" msgstr ":meth:`~.create_text_node`" #: ../../xml-class.rst:42 ../../xml-class.rst:306 #: 0c24293c6f454cf8ac5e9e378e6d49df ab5a32784a7244a0b2c1a1bbdd20c908 msgid "Create direct text for the current node." msgstr "현재 노드에 대한 직접 텍스트를 생성합니다." #: ../../xml-class.rst:43 b53e49d497e340ba8d87d21bca63ee08 msgid ":meth:`~.find`" msgstr ":meth:`~.find`" #: ../../xml-class.rst:43 54e83a9f44b545e9bfe1a2b06258a179 msgid "Find a sub-node with given properties." msgstr "주어진 속성을 가진 하위 노드를 찾습니다." #: ../../xml-class.rst:44 279258dff67b40a986c18f707623ce7b msgid ":meth:`~.find_next`" msgstr ":meth:`~.find_next`" #: ../../xml-class.rst:44 54393fb756ce48a1935a45fa6c483fd9 msgid "Repeat previous \"find\" with the same criteria." msgstr "동일한 기준으로 이전 \"find\" 를 반복합니다." #: ../../xml-class.rst:45 536488e527e642478653b6c87079f25d msgid ":meth:`~.insert_after`" msgstr ":meth:`~.insert_after`" #: ../../xml-class.rst:45 3c35e0b8245c4d3894e3e33f8c437b0c msgid "Insert an element after current node." msgstr "현재 노드 뒤에 요소를 삽입합니다." #: ../../xml-class.rst:46 f8abe4048c244c3dbdc13b3c4e5ad69a msgid ":meth:`~.insert_before`" msgstr ":meth:`~.insert_before`" #: ../../xml-class.rst:46 297894701e8b45be843568131def067b msgid "Insert an element before current node." msgstr "현재 노드 앞에 요소를 삽입합니다." #: ../../xml-class.rst:47 8dfc91e812d545cc915f8fe33c6b5fbf msgid ":meth:`~.remove`" msgstr ":meth:`~.remove`" #: ../../xml-class.rst:47 5d36ebaefdd54b1982ac6726613e2112 msgid "Remove this node." msgstr "이 노드를 제거합니다." #: ../../xml-class.rst:48 96abe1793f174eec994fb30aab4effea msgid ":meth:`~.set_align`" msgstr ":meth:`~.set_align`" #: ../../xml-class.rst:48 a55a6f5e66e2493cbd7dbc5b956f1a3e msgid "Set the alignment using a CSS style spec. Only works for block-level tags." msgstr "CSS 스타일 사양을 사용하여 정렬을 설정합니다. 블록 레벨 태그에만 작동합니다." #: ../../xml-class.rst:49 ea21515c71e24b0188b60a1a70913497 msgid ":meth:`~.set_attribute`" msgstr ":meth:`~.set_attribute`" #: ../../xml-class.rst:49 ../../xml-class.rst:172 #: c52ac8e27b044dd68190bd1c067c3c3e cb302d2f3079458ca8d3ceb266e47cbd msgid "Set an arbitrary key to some value (which may be empty)." msgstr "임의의 키를 일부 값(비어 있을 수 있음)으로 설정합니다." #: ../../xml-class.rst:50 03813ecb5505495185805991093ca9d3 msgid ":meth:`~.set_bgcolor`" msgstr ":meth:`~.set_bgcolor`" #: ../../xml-class.rst:50 ../../xml-class.rst:199 #: 7b89b00dcad741248713dda7ba5d06d0 994f5e2b0df34266bde8fc8388e3045e msgid "Set the background color. Only works for block-level tags." msgstr "배경색을 설정합니다. 블록 레벨 태그에만 작동합니다." #: ../../xml-class.rst:51 7352b4b42f8a4f8392bc82e0c98aba56 msgid ":meth:`~.set_bold`" msgstr ":meth:`~.set_bold`" #: ../../xml-class.rst:51 ../../xml-class.rst:205 #: 756c1471bfe7439482da584fb5e10c44 8ba71a63948e473599b07b28a86a490c msgid "Set bold on or off or to some string value." msgstr "굵게를 켜거나 끄거나 일부 문자열 값으로 설정합니다." #: ../../xml-class.rst:52 11e420e055184eb8b13706473ad5a325 msgid ":meth:`~.set_color`" msgstr ":meth:`~.set_color`" #: ../../xml-class.rst:52 43619286063e475b9ca8e799b0ed6b26 msgid "Set text color." msgstr "텍스트 색상을 설정합니다." #: ../../xml-class.rst:53 cf8a517ba10a451d9578a9c6a0f414b6 msgid ":meth:`~.set_columns`" msgstr ":meth:`~.set_columns`" #: ../../xml-class.rst:53 f418d11d24d44223a434608e1ae690f8 msgid "Set the number of columns. Argument may be any valid number or string." msgstr "열 수를 설정합니다. 인수는 유효한 숫자 또는 문자열일 수 있습니다." #: ../../xml-class.rst:54 4c848bf493914ddcbfd8d32d1526f510 msgid ":meth:`~.set_font`" msgstr ":meth:`~.set_font`" #: ../../xml-class.rst:54 362b271a59604e4f957f8702d7ef2b53 msgid "Set the font-family, e.g. “sans-serif”." msgstr "글꼴 패밀리를 설정합니다. 예: “sans-serif”." #: ../../xml-class.rst:55 ff571b94a01a477fba4693ef0a1b492f msgid ":meth:`~.set_fontsize`" msgstr ":meth:`~.set_fontsize`" #: ../../xml-class.rst:55 e94b2ea525e24124a168317cd6071fdc msgid "Set the font size. Either a float or a valid HTML/CSS string." msgstr "글꼴 크기를 설정합니다. float 또는 유효한 HTML/CSS 문자열입니다." #: ../../xml-class.rst:56 1feb11c650204bb0bfece8527099e866 msgid ":meth:`~.set_id`" msgstr ":meth:`~.set_id`" #: ../../xml-class.rst:56 4b5b5816aa62459e9d8baab00f0edc99 msgid "Set a :htmlTag:`id`. A check for uniqueness is performed." msgstr ":htmlTag:`id` 를 설정합니다. 고유성 검사가 수행됩니다." #: ../../xml-class.rst:57 ce34ec1e82914fb1b1b90bb31d40470d msgid ":meth:`~.set_italic`" msgstr ":meth:`~.set_italic`" #: ../../xml-class.rst:57 4e45de6be07840af90c12e676fd9c5ae msgid "Set italic on or off or to some string value." msgstr "기울임꼴을 켜거나 끄거나 일부 문자열 값으로 설정합니다." #: ../../xml-class.rst:58 11c92dcf021e4d5cbb52560db075d9fe msgid ":meth:`~.set_leading`" msgstr ":meth:`~.set_leading`" #: ../../xml-class.rst:58 ../../xml-class.rst:249 #: 0313848222a04025b98a78e2faf28cf8 269609b91bb44ac7880bff03d7847f2a msgid "" "Set inter-block text distance (`-mupdf-leading`), only works on block-" "level nodes." msgstr "블록 간 텍스트 거리(`-mupdf-leading`)를 설정합니다. 블록 레벨 노드에만 작동합니다." #: ../../xml-class.rst:59 15f03bc6829c4d129ca26b81e84a6eb6 msgid ":meth:`~.set_lineheight`" msgstr ":meth:`~.set_lineheight`" #: ../../xml-class.rst:59 01673ca076f64027883cfb4fe9c97046 msgid "Set height of a line. Float like 1.5, which sets to `1.5 * fontsize`." msgstr "줄 높이를 설정합니다. 1.5와 같은 float는 `1.5 * fontsize` 로 설정됩니다." #: ../../xml-class.rst:60 41bdd81afe8e46d1a7038efdc95fb1f4 msgid ":meth:`~.set_margins`" msgstr ":meth:`~.set_margins`" #: ../../xml-class.rst:60 ffba6357a0f54dfa979916919ace72b6 msgid "Set the margin(s), float or string with up to 4 values." msgstr "여백을 설정합니다. 최대 4개의 값을 가진 float 또는 문자열입니다." #: ../../xml-class.rst:61 19d802eea7664074a119a0ca9611d63a msgid ":meth:`~.set_pagebreak_after`" msgstr ":meth:`~.set_pagebreak_after`" #: ../../xml-class.rst:61 ../../xml-class.rst:267 #: 635579fb8b334ef496c13d09aa9b2a24 bbb7b82028684c03935a74cc78c43f79 msgid "Insert a page break after this node." msgstr "이 노드 뒤에 페이지 나누기를 삽입합니다." #: ../../xml-class.rst:62 d9f038d12f844c37bba8348d97d4c4a4 msgid ":meth:`~.set_pagebreak_before`" msgstr ":meth:`~.set_pagebreak_before`" #: ../../xml-class.rst:62 ../../xml-class.rst:271 #: 5c16b15d44844c4dacb4a296d0ebf537 83dfe30bd4c54eeaa4fc51696b2e4189 msgid "Insert a page break before this node." msgstr "이 노드 앞에 페이지 나누기를 삽입합니다." #: ../../xml-class.rst:63 4986e5fa09f34f80a02ffebc470181cb msgid ":meth:`~.set_properties`" msgstr ":meth:`~.set_properties`" #: ../../xml-class.rst:63 8aa5fb55e133414bb1a07fa48f8c495a msgid "Set any or all desired properties in one call." msgstr "한 번의 호출로 원하는 모든 속성을 설정합니다." #: ../../xml-class.rst:64 8bd74a9264e847218ff74d28819f9b3a msgid ":meth:`~.add_style`" msgstr ":meth:`~.add_style`" #: ../../xml-class.rst:64 696084f4662f4afa8f1d2f9fe9803858 msgid "Set (add) a “style” that is not supported by its own `set_` method." msgstr "자체 `set_` 메서드로 지원되지 않는 “style” 을 설정(추가)합니다." #: ../../xml-class.rst:65 6783ab89d34e4bb1beacc5d2ebee9ba1 msgid ":meth:`~.add_class`" msgstr ":meth:`~.add_class`" #: ../../xml-class.rst:65 26d405ede2ea47bf85cdce1edf045fe7 msgid "Set (add) a “class” attribute." msgstr "“class” 속성을 설정(추가)합니다." #: ../../xml-class.rst:66 0de080acfdf143efbf77e424fd977b61 msgid ":meth:`~.set_text_indent`" msgstr ":meth:`~.set_text_indent`" #: ../../xml-class.rst:66 a7815d341b0d4bec895b0cc65db7a8a9 msgid "" "Set indentation for first textblock line. Only works for block-level " "nodes." msgstr "첫 번째 텍스트 블록 줄의 들여쓰기를 설정합니다. 블록 레벨 노드에만 작동합니다." #: ../../xml-class.rst:67 73ba9526545c47ae8c78f869547404a1 msgid ":attr:`~.tagname`" msgstr ":attr:`~.tagname`" #: ../../xml-class.rst:67 ../../xml-class.rst:370 #: 48584833c9fe4ca985f37c45ad2c3d76 d9381cddd5514b6fadcac87352ef53c1 msgid "Either the HTML tag name like :htmlTag:`p` or `None` if a text node." msgstr ":htmlTag:`p` 와 같은 HTML 태그 이름이거나 텍스트 노드인 경우 `None` 입니다." #: ../../xml-class.rst:68 6abc57bcb9f4408d90fa105b05243e71 msgid ":attr:`~.text`" msgstr ":attr:`~.text`" #: ../../xml-class.rst:68 ../../xml-class.rst:374 #: 4cf7d8eb06994aaf8da0a99630a2b88f dd52e4753283435ab62a4e5cf08c3c67 msgid "Either the node's text or `None` if a tag node." msgstr "노드의 텍스트이거나 태그 노드인 경우 `None` 입니다." #: ../../xml-class.rst:69 c80ecae6e2374362bda69ab5f6f83bb5 msgid ":attr:`~.is_text`" msgstr ":attr:`~.is_text`" #: ../../xml-class.rst:69 7058d637f998456c9acd2330b63e694d msgid "Check if the node is a text." msgstr "노드가 텍스트인지 확인합니다." #: ../../xml-class.rst:70 1866cee8d0c84959a92ba46715af839b msgid ":attr:`~.first_child`" msgstr ":attr:`~.first_child`" #: ../../xml-class.rst:70 ../../xml-class.rst:382 #: 238d1286994b4be289304b0355f413cf 6fcf64063e504c83874560e24334da81 msgid "Contains the first node one level below this one (or `None`)." msgstr "이 노드보다 한 단계 아래의 첫 번째 노드를 포함합니다(또는 `None`)." #: ../../xml-class.rst:71 851a9238caa94b969efa1adb031498b6 msgid ":attr:`~.last_child`" msgstr ":attr:`~.last_child`" #: ../../xml-class.rst:71 ../../xml-class.rst:386 #: 0048d0bc3d6642349608efc96461213e 7f4b0ba5d00f4ce2baef3b1f449e84bc msgid "Contains the last node one level below this one (or `None`)." msgstr "이 노드보다 한 단계 아래의 마지막 노드를 포함합니다(또는 `None`)." #: ../../xml-class.rst:72 e31062e64395499283472e5f0cce8591 msgid ":attr:`~.next`" msgstr ":attr:`~.next`" #: ../../xml-class.rst:72 ../../xml-class.rst:390 #: 74da4c4190d2452ea26e9a031c65d9c0 76197938be5e4a7cb15873e3587d6473 msgid "The next node at the same level (or `None`)." msgstr "같은 레벨의 다음 노드(또는 `None`)." #: ../../xml-class.rst:73 00b770d5e9494151944f8ca72875704f msgid ":attr:`~.previous`" msgstr ":attr:`~.previous`" #: ../../xml-class.rst:73 ../../xml-class.rst:394 #: de9653bc4d6d46fdb546a8b1020ade72 f0b4ecf139a546ab893551141166f15b msgid "The previous node at the same level." msgstr "같은 레벨의 이전 노드." #: ../../xml-class.rst:74 324f133ed2e54ac28e45a08cd4deb6ee msgid ":attr:`~.root`" msgstr ":attr:`~.root`" #: ../../xml-class.rst:74 ../../xml-class.rst:398 #: 5ee16878f554413ab4a0ef55e762dd20 b84698fd03b74ab2a6bf011ec67a7c31 msgid "The top node of the DOM, which hence has the tagname :htmlTag:`html`." msgstr "DOM의 최상위 노드로, 따라서 태그 이름이 :htmlTag:`html` 입니다." #: ../../xml-class.rst:79 9cc8e3fdf4f345fabd4b30db4fa7b2df msgid "**Class API**" msgstr "**클래스 API**" #: ../../xml-class.rst:85 2e41fcde489d4a928300d15f33e3e110 msgid "" "Add an :htmlTag:`ul` tag - bulleted list, context manager. See `ul " "`_." msgstr "" ":htmlTag:`ul` 태그 추가 - 불릿 목록, 컨텍스트 매니저. `ul `_ 를 참조하세요." #: ../../xml-class.rst:89 8cbdd27873fd4c138f660770ffd885c0 msgid "" "Add a :htmlTag:`pre` tag, context manager. See `pre " "`_." msgstr "" ":htmlTag:`pre` 태그 추가, 컨텍스트 매니저. `pre `_ 를 참조하세요." #: ../../xml-class.rst:93 4c52e991f2d1486fb520ada7b65ecf60 msgid "" "Add a :htmlTag:`dl` tag, context manager. See `dl " "`_." msgstr "" ":htmlTag:`dl` 태그 추가, 컨텍스트 매니저. `dl `_ 를 참조하세요." #: ../../xml-class.rst:97 97dd62a837dc41eaa3e350af10039f9e msgid "" "Add a :htmlTag:`div` tag, context manager. See `div " "`_." msgstr "" ":htmlTag:`div` 태그 추가, 컨텍스트 매니저. `div `_ 를 참조하세요." #: ../../xml-class.rst:101 75c8952433194970b978abc00b3b97b8 msgid "" "Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context " "manager. See `headings `_." msgstr "" "헤더 태그 추가(:htmlTag:`h1` ~ :htmlTag:`h6` 중 하나), 컨텍스트 매니저. `headings " "`_ 를 참조하세요." #: ../../xml-class.rst 071ee6894c3048e98dcde2ce36b62fe0 #: 07f4e7a4d07742a09eb64bac4f8e7f47 18d5dca41f9148d989d31b098cc7068b #: 2513b123c6ad435aaf40448eb9661ffd 2552e11c47ee4b3083c32e3e42fd2227 #: 2b9417956fe4424d9bdc4167f4fe27f0 4b45aea1b75e4f5a8493bb97947f7670 #: 5a7226878eaf4bf4a8d146aefd9fc6c2 6c8408dac31f401ca4b20970c770d909 #: 6ecf5c2861b5443e8422f34c3df4c6d4 7175254a32ea4b3a969c0812d221bcc0 #: 8160ce73204e4f67a9c2729a2ae2fe0a 8430e36693a446708867badbfd49b16f #: 8db3cbff4c56472d9086e987c0ff90d5 8f2186fb783d4c99b915b40831a80551 #: 9fee7d00425e495a9ea52cdcdb1105df a0e8644184de4688befedd1b1f6b1f48 #: a936bac1d8f84238927172f0c1b1a9f9 ac6183c17f40424fbf98f29ac05b6d7c #: ad072640a531401a90210d2c5ddcb035 bcc06f6598a5432cbef93a7b8e8f51ab #: bd8f12e471e54f19a3231352d44d77e8 d643adfc3ba14ca9a6eb51fd2e03a7bd #: ec41031277d64f758e22602fd6090f70 f0477f34f1c24a31976ab44e62cf544b #: f58492282617408fbf640c0870739c87 fc36c0decdf847d59b50e8f8db732c05 msgid "Parameters" msgstr "매개변수" #: ../../xml-class.rst:103 512df5124cdc4ee9b171d85403bf5626 msgid "a value 1 - 6." msgstr "1 - 6 사이의 값." #: ../../xml-class.rst:107 1d8612c571cf4a7b9374d9ace7b2f9db msgid "" "Add a :htmlTag:`hr` tag. See `hr `_." msgstr "" ":htmlTag:`hr` 태그 추가. `hr `_ 를 참조하세요." #: ../../xml-class.rst:111 c7287c022bd74ffb8a4456a54fbab923 msgid "" "Add an :htmlTag:`img` tag. This causes the inclusion of the named image " "in the DOM." msgstr ":htmlTag:`img` 태그 추가. 이것은 DOM에 명명된 이미지를 포함시킵니다." #: ../../xml-class.rst:113 803faa071c22481ca0eb93e0dfe4a50c msgid "" "the filename of the image. This **must be the member name** of some entry" " of the :ref:`Archive` parameter of the :ref:`Story` constructor." msgstr "이미지의 파일명. 이것은 :ref:`Story` 생성자의 :ref:`Archive` 매개변수 항목의 **멤버 이름** 이어야 합니다." #: ../../xml-class.rst:114 e30e974b6d8f40e2a1f1ee4faf38c16e msgid "" "if provided, either an absolute (int) value, or a percentage string like " "\"30%\". A percentage value refers to the width of the specified `where` " "rectangle in :meth:`Story.place`. If this value is provided and `height` " "is omitted, the image will be included keeping its aspect ratio." msgstr "" "제공된 경우 절대(int) 값 또는 \"30%\" 와 같은 백분율 문자열입니다. 백분율 값은 :meth:`Story.place` 의" " 지정된 `where` 사각형의 너비를 나타냅니다. 이 값이 제공되고 `height` 가 생략되면 이미지는 종횡비를 유지하면서 " "포함됩니다." #: ../../xml-class.rst:115 c0a019f0782f47a5941d4ff3a82604c2 msgid "" "if provided, either an absolute (int) value, or a percentage string like " "\"30%\". A percentage value refers to the height of the specified `where`" " rectangle in :meth:`Story.place`. If this value is provided and `width` " "is omitted, the image's aspect ratio will be honored." msgstr "" "제공된 경우 절대(int) 값 또는 \"30%\" 와 같은 백분율 문자열입니다. 백분율 값은 :meth:`Story.place` 의" " 지정된 `where` 사각형의 높이를 나타냅니다. 이 값이 제공되고 `width` 가 생략되면 이미지의 종횡비가 유지됩니다." #: ../../xml-class.rst:119 6222aa6b43c84a56996f4df07038c376 msgid "Add an :htmlTag:`a` tag - inline element, treated like text." msgstr ":htmlTag:`a` 태그 추가 - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:121 fdb4bad9f0de43c296f9e0a510b0be66 msgid "the URL target." msgstr "URL 대상." #: ../../xml-class.rst:122 f986906bddca4fce889f02adb8c3edfa msgid "the text to display. If omitted, the `href` text is shown instead." msgstr "표시할 텍스트. 생략하면 `href` 텍스트가 대신 표시됩니다." #: ../../xml-class.rst:126 92be3d9375f54667873b6fe8ca12fa51 msgid "Add an :htmlTag:`ol` tag, context manager." msgstr ":htmlTag:`ol` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:130 f4d77e1cdb65420fa7405be7460b249f msgid "Add a :htmlTag:`p` tag, context manager." msgstr ":htmlTag:`p` 태그 추가, 컨텍스트 매니저." #: ../../xml-class.rst:134 29eaf25ddba343e692000d7110886a16 msgid "Add a :htmlTag:`span` tag, context manager. See `span`_" msgstr ":htmlTag:`span` 태그 추가, 컨텍스트 매니저. `span`_ 를 참조하세요" #: ../../xml-class.rst:138 dccc012fd1c245d9a82d12506448b061 msgid "" "Add \"subscript\" text(:htmlTag:`sub` tag) - inline element, treated like" " text." msgstr "\"아래첨자\" 텍스트 추가(:htmlTag:`sub` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:142 cf804acbbb5f464b8f6397266f166088 msgid "" "Add \"superscript\" text (:htmlTag:`sup` tag) - inline element, treated " "like text." msgstr "\"위첨자\" 텍스트 추가(:htmlTag:`sup` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:146 8dc97f93b0274ec5bce1de3b4ff37925 msgid "" "Add \"code\" text (:htmlTag:`code` tag) - inline element, treated like " "text." msgstr "\"코드\" 텍스트 추가(:htmlTag:`code` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:150 7ba6387f382a47489d0ce8bcdcf295b7 msgid "" "Add \"variable\" text (:htmlTag:`var` tag) - inline element, treated like" " text." msgstr "\"변수\" 텍스트 추가(:htmlTag:`var` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:154 f838fe3c409c4c24b69164831b3e719a msgid "" "Add \"sample output\" text (:htmlTag:`samp` tag) - inline element, " "treated like text." msgstr "\"샘플 출력\" 텍스트 추가(:htmlTag:`samp` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:158 e0ac1ab1ff06451286d193648fa3012e msgid "" "Add \"keyboard input\" text (:htmlTag:`kbd` tag) - inline element, " "treated like text." msgstr "\"키보드 입력\" 텍스트 추가(:htmlTag:`kbd` 태그) - 인라인 요소, 텍스트처럼 처리됩니다." #: ../../xml-class.rst:166 fb7159ea6f3e454687d447905e1fb63e msgid "Set the text alignment. Only works for block-level tags." msgstr "텍스트 정렬을 설정합니다. 블록 레벨 태그에만 작동합니다." #: ../../xml-class.rst:168 66bce7c8f20f4b2987deadc2e78c5e17 msgid "" "either one of the :ref:`TextAlign` or the `text-align " "`_ values." msgstr "" ":ref:`TextAlign` 중 하나 또는 `text-align `_ 값." #: ../../xml-class.rst:174 ../../xml-class.rst:187 ../../xml-class.rst:195 #: d7aad8433d4b4ae28b02feced7823c68 ed342f6d55a241d08a69381dee663b2f #: efe9866f00ec4947a478509974de173a msgid "the name of the attribute." msgstr "속성의 이름." #: ../../xml-class.rst:175 830437471d0e48c785ca5e15b55e435f msgid "the (optional) value of the attribute." msgstr "속성의 (선택적) 값." #: ../../xml-class.rst:179 60d418fba6084ff28607414510c9266a msgid "Retrieve all attributes of the current nodes as a dictionary." msgstr "현재 노드의 모든 속성을 딕셔너리로 검색합니다." #: ../../xml-class.rst 2a701f48413144dab311db1561eb1c0e #: c37952141e1f421b8ce9ae427841107e cc52891e847543b59823983f02b914d4 #: da7ccff444ac4cea98762959deb04bf2 dfda8cf8c928444b9a36c099258dcd98 #: e957c78900eb4dc6b0ef81f303dc9a49 f1f773fbd025444c85403f7249ce73a3 msgid "Returns" msgstr "반환값" #: ../../xml-class.rst:181 03d7a82f94c4440ca4de7313573c205e msgid "a dictionary with the attributes and their values of the node." msgstr "노드의 속성과 값이 있는 딕셔너리." #: ../../xml-class.rst:185 64fde0623dc74f35a18bdd2e5f525e1a msgid "Get the attribute value of `key`." msgstr "`key` 의 속성 값을 가져옵니다." #: ../../xml-class.rst:189 75de20320c6e4393bd9bb242e39953b5 msgid "a string with the value of `key`." msgstr "`key` 의 값을 가진 문자열." #: ../../xml-class.rst:193 60c7b6c3758a4d87ae2aba6bbd8119d9 msgid "Remove the attribute `key` from the node." msgstr "노드에서 속성 `key` 를 제거합니다." #: ../../xml-class.rst:201 e5de65082c214d558cbb52a710140364 msgid "" "either an RGB value like (255, 0, 0) (for \"red\") or a valid " "`background-color `_ value." msgstr "" "(255, 0, 0)(\"red\"의 경우)와 같은 RGB 값 또는 유효한 `background-color " "`_ 값." #: ../../xml-class.rst:207 cc773c1679604ba6b0c57266774838b3 msgid "" "`True`, `False` or a valid `font-weight `_ value." msgstr "" "`True`, `False` 또는 유효한 `font-weight `_ 값." #: ../../xml-class.rst:211 d90edf95aa3c4c75b9e7500594da74b2 msgid "Set the color of the text following." msgstr "다음 텍스트의 색상을 설정합니다." #: ../../xml-class.rst:213 dd4f443acc6e4824b8cbe2bfe79d6923 msgid "" "either an RGB value like (255, 0, 0) (for \"red\") or a valid `color " "`_ value." msgstr "" "(255, 0, 0)(\"red\"의 경우)와 같은 RGB 값 또는 유효한 `color " "`_ 값." #: ../../xml-class.rst:217 d077d7854b80478dacf03fa0669683dd msgid "Set the number of columns." msgstr "열 수를 설정합니다." #: ../../xml-class.rst:219 96343b27b1504159919805d5df4e0f45 msgid "" "a valid `columns `_ value." msgstr "" "유효한 `columns `_" " 값." #: ../../xml-class.rst:221 74ba294325804581ab5480e351d416dc msgid "Currently ignored - supported in a future MuPDF version." msgstr "현재 무시됨 - 향후 MuPDF 버전에서 지원됩니다." #: ../../xml-class.rst:225 cc957f31c573429db439f0f119f8b79a msgid "Set the font-family." msgstr "글꼴 패밀리를 설정합니다." #: ../../xml-class.rst:227 2ee787378e4543f8aa556edc1b69e9f4 msgid "e.g. \"sans-serif\"." msgstr "예: \"sans-serif\"." #: ../../xml-class.rst:231 2c45062745bc4642a19aa67d3d79273b msgid "Set the font size for text following." msgstr "다음 텍스트의 글꼴 크기를 설정합니다." #: ../../xml-class.rst:233 ec2f8b7640cf481eb1fa289645417c1f msgid "" "a float or a valid `font-size `_ value." msgstr "" "float 또는 유효한 `font-size `_ 값." #: ../../xml-class.rst:237 febde85bc5fd4f8ea34b31ed63f36672 msgid "" "Set a :htmlTag:`id`. This serves as a unique identification of the node " "within the DOM. Use it to easily locate the node to inspect or modify it." " A check for uniqueness is performed." msgstr "" ":htmlTag:`id` 를 설정합니다. 이것은 DOM 내에서 노드의 고유 식별자 역할을 합니다. 노드를 쉽게 찾아 검사하거나 " "수정하는 데 사용하세요. 고유성 검사가 수행됩니다." #: ../../xml-class.rst:239 e37b1314ab6d42b0a2ec907c5db6d0dd msgid "id string of the node." msgstr "노드의 id 문자열." #: ../../xml-class.rst:243 aa326115828c452382e6d09902d27dab msgid "Set italic on or off or to some string value for the text following it." msgstr "다음 텍스트에 대해 기울임꼴을 켜거나 끄거나 일부 문자열 값으로 설정합니다." #: ../../xml-class.rst:245 5fb40161298741eb829c7b4bd4131f42 msgid "" "`True`, `False` or some valid `font-style `_ value." msgstr "" "`True`, `False` 또는 유효한 `font-style `_ 값." #: ../../xml-class.rst:251 2ff6178aa7a4490cb0b3b797e692f3b3 msgid "the distance in points to the previous block." msgstr "이전 블록까지의 거리(포인트 단위)." #: ../../xml-class.rst:255 aa0c45b2f59b4dba8ff847821f1805b3 msgid "Set height of a line." msgstr "줄 높이를 설정합니다." #: ../../xml-class.rst:257 816223093e62465d9c778a7599f93b30 msgid "" "a float like 1.5 (which sets to `1.5 * fontsize`), or some valid `line-" "height `_ " "value." msgstr "" "1.5와 같은 float(`1.5 * fontsize` 로 설정됨) 또는 유효한 `line-height " "`_ 값." #: ../../xml-class.rst:261 ab5060c3426c487d9c1f1b68eb6d3c69 msgid "Set the margin(s)." msgstr "여백을 설정합니다." #: ../../xml-class.rst:263 eb0e87c661e741e7ac93e7749a905007 msgid "" "float or string with up to 4 values. See `CSS documentation " "`_." msgstr "" "최대 4개의 값을 가진 float 또는 문자열. `CSS documentation " "`_ 를 참조하세요." #: ../../xml-class.rst:275 0157cb04fc7e41299f0dc0a351924d25 msgid "" "Set any or all desired properties in one call. The meaning of argument " "values equal the values of the corresponding `set_` methods." msgstr "한 번의 호출로 원하는 모든 속성을 설정합니다. 인수 값의 의미는 해당 `set_` 메서드의 값과 같습니다." #: ../../xml-class.rst:277 0bd79cbc338f46fb9d6dbca48839d876 msgid "" "The properties set by this method are directly attached to the node, " "whereas every `set_` method generates a new :htmlTag:`span` below the " "current node that has the respective property. So to e.g. \"globally\" " "set some property for the :htmlTag:`body`, this method must be used." msgstr "" "이 메서드로 설정된 속성은 노드에 직접 연결되지만, 모든 `set_` 메서드는 해당 속성을 가진 새 :htmlTag:`span` 을" " 현재 노드 아래에 생성합니다. 따라서 예를 들어 :htmlTag:`body` 에 대해 일부 속성을 \"전역적으로\" 설정하려면 이" " 메서드를 사용해야 합니다." #: ../../xml-class.rst:281 d0e7dcd50d50443298496ec86ea5f06f msgid "Set (add) some style attribute not supported by its own `set_` method." msgstr "자체 `set_` 메서드로 지원되지 않는 일부 스타일 속성을 설정(추가)합니다." #: ../../xml-class.rst:283 89724c2b528143acb5bf27d647496828 msgid "any valid CSS style value." msgstr "유효한 CSS 스타일 값." #: ../../xml-class.rst:287 5d883179b1f24ccb981b1a229346ba04 msgid "Set (add) some \"class\" attribute." msgstr "\"class\" 속성을 설정(추가)합니다." #: ../../xml-class.rst:289 3389956444bb4b60ad401df187e94d35 msgid "" "the name of the class. Must have been defined in either the HTML or the " "CSS source of the DOM." msgstr "클래스의 이름. DOM의 HTML 또는 CSS 소스에 정의되어 있어야 합니다." #: ../../xml-class.rst:293 c56792aa596943509620fa4f964b76df msgid "" "Set indentation for the first textblock line. Only works for block-level " "nodes." msgstr "첫 번째 텍스트 블록 줄의 들여쓰기를 설정합니다. 블록 레벨 노드에만 작동합니다." #: ../../xml-class.rst:295 a8dbb4085cbe4b2a8faf0e4dedeaac64 msgid "" "a valid `text-indent `_ value. Please note that negative values do not work." msgstr "" "유효한 `text-indent `_ 값. 음수 값은 작동하지 않습니다." #: ../../xml-class.rst:300 34b0b40691834d299f9242060c378272 msgid "" "Append a child node. This is a low-level method used by other methods " "like :meth:`Xml.add_paragraph`." msgstr "자식 노드를 추가합니다. 이것은 :meth:`Xml.add_paragraph` 와 같은 다른 메서드에서 사용하는 저수준 메서드입니다." #: ../../xml-class.rst:302 4c13861f3a074b469917e2e88ad6c284 msgid "the :ref:`Xml` node to append." msgstr "추가할 :ref:`Xml` 노드." #: ../../xml-class.rst:308 96d40261c6e84cceaf10bd528d633399 msgid "the text to append." msgstr "추가할 텍스트." #: ../../xml-class.rst 474ed85eaea94b85a254b07bf5054bf1 #: 72f9935368ec4cb5b008689ec052a3a5 7be3b6d6eee5465187b72a87498fa9c7 #: d92af6de71cf4f6b9697f66106f46df6 msgid "Return type" msgstr "반환 타입" #: ../../xml-class.rst:310 ../../xml-class.rst:319 #: 248a06ef868840be803afcb1c276fbfa 69466f3d8b5847bd8ddfddfc7474f0d6 msgid ":ref:`Xml`" msgstr ":ref:`Xml`" #: ../../xml-class.rst:311 17a38613ac3c4a1a8c69cf5d7140b0b2 msgid "the created element." msgstr "생성된 요소." #: ../../xml-class.rst:315 e3a170c5762240faba5225ad0ad8a408 msgid "" "Create a new node with a given tag. This a low-level method used by other" " methods like :meth:`Xml.add_paragraph`." msgstr "" "주어진 태그로 새 노드를 생성합니다. 이것은 :meth:`Xml.add_paragraph` 와 같은 다른 메서드에서 사용하는 저수준" " 메서드입니다." #: ../../xml-class.rst:317 f16e668926f44a5ebc013218d888af8b msgid "the element tag." msgstr "요소 태그." #: ../../xml-class.rst:320 50c7ac51012d41ef83aca12b4c6bfd13 msgid "" "the created element. To actually bind it to the DOM, use " ":meth:`Xml.append_child`." msgstr "생성된 요소. 실제로 DOM에 바인딩하려면 :meth:`Xml.append_child` 를 사용하세요." #: ../../xml-class.rst:324 a74da9bcb64a4677bdab647d12b9698d msgid "Insert the given element `elem` before this node." msgstr "주어진 요소 `elem` 을 이 노드 앞에 삽입합니다." #: ../../xml-class.rst:326 ../../xml-class.rst:332 #: a03dabcd2f5e44909735e0fa454a622a ac47ac263e2644b9a6a056f2b71dd185 msgid "some :ref:`Xml` element." msgstr "일부 :ref:`Xml` 요소." #: ../../xml-class.rst:330 2285051e65084c86bdb3ac4c50b6ee73 msgid "Insert the given element `elem` after this node." msgstr "주어진 요소 `elem` 을 이 노드 뒤에 삽입합니다." #: ../../xml-class.rst:336 efebb24cc65b4bf7810de7852eee4bb3 msgid "" "Make a copy of this node, which then may be appended (using " ":meth:`Xml.append_child`) or inserted (using one of " ":meth:`Xml.insert_before`, :meth:`Xml.insert_after`) in this DOM." msgstr "" "이 노드의 복사본을 만듭니다. 그런 다음 이 DOM에 추가( :meth:`Xml.append_child` 사용)하거나 삽입( " ":meth:`Xml.insert_before`, :meth:`Xml.insert_after` 중 하나 사용)할 수 있습니다." #: ../../xml-class.rst:338 443c529ea1eb4979bac6aa87b07e5ae5 msgid "the clone (:ref:`Xml`) of the current node." msgstr "현재 노드의 복제본(:ref:`Xml`)." #: ../../xml-class.rst:342 47ec6b03e3584446a21cae3e9dfc740e msgid "Remove this node from the DOM." msgstr "이 노드를 DOM에서 제거합니다." #: ../../xml-class.rst:347 436c60e603974335862d86319e3ad149 msgid "For debugging purposes, print this node's structure in a simplified form." msgstr "디버깅 목적으로 이 노드의 구조를 간소화된 형태로 출력합니다." #: ../../xml-class.rst:351 6eb8a8f3e0e242169288042ca92620ce msgid "" "Under the current node, find the first node with the given `tag`, " "attribute `att` and value `match`." msgstr "현재 노드 아래에서 주어진 `tag`, 속성 `att` 및 값 `match` 를 가진 첫 번째 노드를 찾습니다." #: ../../xml-class.rst:353 15e37abf37614b23be73a14603937165 msgid "restrict search to this tag. May be `None` for unrestricted searches." msgstr "이 태그로 검색을 제한합니다. 제한 없는 검색의 경우 `None` 일 수 있습니다." #: ../../xml-class.rst:354 f745373d2e69452e985e2dac159ea5c2 msgid "check this attribute. May be `None`." msgstr "이 속성을 확인합니다. `None` 일 수 있습니다." #: ../../xml-class.rst:355 165356d315d24c0a8ed99526c1b01dd7 msgid "the desired attribute value to match. May be `None`." msgstr "일치시킬 원하는 속성 값. `None` 일 수 있습니다." #: ../../xml-class.rst:357 ../../xml-class.rst:364 #: 01f3aba4e08b4252b10413f4311480f2 f48e420675664a59bc388c905451c4fc msgid ":ref:`Xml`." msgstr ":ref:`Xml`." #: ../../xml-class.rst:358 ccbc86d49fc74fa5b0de1f0336c0fce8 msgid "`None` if nothing found, otherwise the first matching node." msgstr "찾은 것이 없으면 `None`, 그렇지 않으면 첫 번째 일치하는 노드." #: ../../xml-class.rst:362 b0c5a67c416d423d838e1bf344e4819d msgid "" "Continue a previous :meth:`Xml.find` (or :meth:`find_next`) with the same" " values." msgstr "동일한 값으로 이전 :meth:`Xml.find` (또는 :meth:`find_next`) 를 계속합니다." #: ../../xml-class.rst:365 57c7ab6c7b504406b51c6e8574ddec4b msgid "`None` if none more found, otherwise the next matching node." msgstr "더 이상 찾은 것이 없으면 `None`, 그렇지 않으면 다음 일치하는 노드." #: ../../xml-class.rst:378 89934d92ed6140979716d32f3cc7a713 msgid "Check if a text node." msgstr "텍스트 노드인지 확인합니다." #: ../../xml-class.rst:402 400a4f578b98416091fc04c3e3347a91 msgid "Setting Text properties" msgstr "텍스트 속성 설정" #: ../../xml-class.rst:404 3fa3fea9963b4eba99ff8e83ed31ee32 msgid "" "In HTML tags can be nested such that innermost text **inherits " "properties** from the tag enveloping its parent tag. For example " "`

some bold textthis is bold and italicregular text

`." msgstr "" "HTML에서 태그는 가장 안쪽 텍스트가 부모 태그를 감싸는 태그로부터 **속성을 상속** 하도록 중첩될 수 있습니다. 예: " "`

some bold textthis is bold and italicregular text

`." #: ../../xml-class.rst:406 eed0c2145e1647ee82f831b11a407df7 msgid "" "To achieve the same effect, methods like :meth:`Xml.set_bold` and " ":meth:`Xml.set_italic` each open a temporary :htmlTag:`span` with the " "desired property underneath the current node." msgstr "" "동일한 효과를 얻기 위해 :meth:`Xml.set_bold` 및 :meth:`Xml.set_italic` 와 같은 메서드는 각각 " "현재 노드 아래에 원하는 속성을 가진 임시 :htmlTag:`span` 을 엽니다." #: ../../xml-class.rst:408 f93907c09e2e4f8983b02e2797060870 msgid "" "In addition, these methods return there parent node, so they can be " "concatenated with each other." msgstr "또한 이러한 메서드는 부모 노드를 반환하므로 서로 연결할 수 있습니다." #: ../../xml-class.rst:413 6c46240a1795450497d3b9f26c22b085 msgid "Context Manager support" msgstr "컨텍스트 매니저 지원" #: ../../xml-class.rst:414 ebbde3aa8eae44eaa2eb7717c33fd3c7 msgid "The standard way to add nodes to a DOM is this::" msgstr "DOM에 노드를 추가하는 표준 방법은 다음과 같습니다::" #: ../../xml-class.rst:427 aa6e31a0372e4c5082cdb4ff60b21766 msgid "" "Methods that are flagged as \"context managers\" can conveniently be used" " in this way::" msgstr "\"컨텍스트 매니저\" 로 표시된 메서드는 다음과 같이 편리하게 사용할 수 있습니다::" #: ../../footer.rst:57 3237dfa1d64d4115b40cd8888565be39 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/locales/ko/LC_MESSAGES/znames.po ================================================ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2025, Artifex # This file is distributed under the same license as the PyMuPDF package. # FIRST AUTHOR , 2025. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PyMuPDF 1.26.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-11-25 23:33+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" "Language-Team: ko \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.3\n" #: ../../header.rst:-1 0eb4a369e5b94c7489997eb18eb43347 msgid "Artifex" msgstr "Artifex" #: ../../header.rst:-1 d0b7be7b87414f0dacea935473d04f43 msgid "" "PyMuPDF is a high-performance Python library for data extraction, " "analysis, conversion & manipulation of PDF (and other) documents." msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다." #: ../../header.rst:-1 caca777a734049198ad1a788ab3304f9 msgid "" "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, " "PDF Splitting, PDF Creation, Pyodide, PyScript" msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript" #: ../../znames.rst:7 083b7e0a5a2b460f8da6d411d620371a msgid "Deprecated Names" msgstr "사용 중단된 이름" #: ../../znames.rst:9 e3a203bb6f834ba0a39fa9d32da05a58 msgid "" "The original naming convention for methods and properties has been " "\"camelCase\". Since its creation around 2013, a tremendous increase of " "functionality has happened in PyMuPDF -- and with it a corresponding " "increase in classes, methods and properties. In too many cases, this has " "led to non-intuitive, illogical and ugly names, difficult to memorize or " "guess." msgstr "메서드와 속성의 원래 명명 규칙은 \"camelCase\"였습니다. 2013년경 생성 이후 PyMuPDF에서 기능이 크게 증가했고, 이에 따라 클래스, 메서드, 속성도 증가했습니다. 많은 경우 직관적이지 않고 논리적이지 않으며 기억하거나 추측하기 어려운 이름이 생겼습니다." #: ../../znames.rst:11 d001aeecdacb4bd59a62961dbc1370dd msgid "" "A few versions ago, I therefore decided to shift gears and switch to a " "\"snake_cased\" naming standard. This was a major effort, which needed a " "step-wise approach. I think am done with it now (version 1.18.14)." msgstr "몇 버전 전, 단계적 접근이 필요한 큰 작업이었지만 \"snake_cased\" 명명 표준으로 전환하기로 했습니다. 이제는 완료된 것으로 봅니다(버전 1.18.14)." #: ../../znames.rst:14 6f07346687c14dbb83e38186df94b743 msgid "" "The following list maps deprecated names to their new versions. For " "example, property `pageCount` became `page_count` in the :ref:`Document` " "class. There also are less obvious name changes, e.g. method `getPNGdata`" " was renamed to `tobytes` in the :ref:`Pixmap` class." msgstr "다음 목록은 사용 중단된 이름을 새 버전에 매핑합니다. 예를 들어, 속성 `pageCount` 는 :ref:`Document` 클래스에서 `page_count` 가 되었습니다. 덜 명확한 이름 변경도 있습니다. 예를 들어 메서드 `getPNGdata` 는 :ref:`Pixmap` 클래스에서 `tobytes` 로 이름이 변경되었습니다." #: ../../znames.rst:16 cc7e51d7a5144cd290ff0b79249d442c msgid "" "Names of classes (camel case) and package-wide constants (the majority is" " upper case) remain untouched." msgstr "클래스 이름(카멜 케이스)과 패키지 전체 상수(대부분 대문자)는 변경되지 않았습니다." #: ../../znames.rst:18 6e79bdebc3d2434394db7e65ce997c71 msgid "" "Old names will remain available as deprecated aliases through MuPDF " "version 1.19.0 and **be removed** in the version that follows it - " "probably version 1.20.0, but this depends on upstream decisions (MuPDF)." msgstr "이전 이름은 MuPDF 버전 1.19.0까지 사용 중단된 별칭으로 사용 가능하며, 그 이후 버전(아마도 버전 1.20.0이지만, 이는 상류 결정(MuPDF)에 따라 다름)에서 **제거됩니다**." #: ../../znames.rst:20 dbf4b6c8f3134ca596bd0a822ffd2e9b msgid "" "Starting with version 1.19.0, we will issue deprecation warnings on " "`sys.stderr` like `Deprecation: 'newPage' removed from class 'Document' " "after v1.19.0 - use 'new_page'.` when aliased methods are being used. " "Using a deprecated property will not cause this type of warning." msgstr "버전 1.19.0부터 별칭 메서드가 사용될 때 `sys.stderr` 에 `Deprecation: 'newPage' removed from class 'Document' after v1.19.0 - use 'new_page'.` 와 같은 사용 중단 경고를 발행합니다. 사용 중단된 속성을 사용해도 이 유형의 경고는 발생하지 않습니다." #: ../../znames.rst:22 2f0d5cce9e2e4f5e8541eb4b6fc686ed msgid "" "Starting immediately, all deprecated objects (methods and properties) " "will show a copy of the original's docstring, **prefixed** with the " "deprecation message, for example::" msgstr "즉시부터 모든 사용 중단된 객체(메서드 및 속성)는 원본의 docstring 복사본을 표시하며, 사용 중단 메시지가 **접두사** 로 붙습니다. 예:" #: ../../znames.rst:39 8e4f2cae0e38499bbf0543f4bdfb1885 msgid "" "There is a utility script `alias-changer.py `_ which can be used to " "do mass-renames in your scripts. It accepts either a single file or a " "folder as argument. If a folder is supplied, all its Python files and " "those of its subfolders are changed. Optionally, backups of the scripts " "can be taken." msgstr "스크립트에서 대량 이름 변경을 수행하는 데 사용할 수 있는 유틸리티 스크립트 `alias-changer.py `_ 가 있습니다. 단일 파일 또는 폴더를 인수로 받습니다. 폴더가 제공되면 해당 폴더의 모든 Python 파일과 하위 폴더의 파일이 변경됩니다. 선택적으로 스크립트의 백업을 만들 수 있습니다." #: ../../footer.rst:46 52ab1685187a4ce284f0a14818fcf934 msgid "This documentation covers all versions up to |version|." msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다." ================================================ FILE: docs/lowlevel.rst ================================================ .. include:: header.rst ================================= Low Level Functions and Classes ================================= Contains a number of functions and classes for the experienced user. To be used for special needs or performance requirements. .. toctree:: :maxdepth: 1 functions device coop_low .. include:: footer.rst ================================================ FILE: docs/matrix.rst ================================================ .. include:: header.rst .. _Matrix: ========== Matrix ========== Matrix is a row-major 3x3 matrix used by image transformations in MuPDF (which complies with the respective concepts laid down in the :ref:`AdobeManual`). With matrices you can manipulate the rendered image of a page in a variety of ways: (parts of) the page can be rotated, zoomed, flipped, sheared and shifted by setting some or all of just six float values. Since all points or pixels live in a two-dimensional space, one column vector of that matrix is a constant unit vector, and only the remaining six elements are used for manipulations. These six elements are usually represented by `[a, b, c, d, e, f]`. Here is how they are positioned in the matrix: .. image:: images/img-matrix.* Please note: * the below methods are just convenience functions -- everything they do, can also be achieved by directly manipulating the six numerical values * all manipulations can be combined -- you can construct a matrix that rotates **and** shears **and** scales **and** shifts, etc. in one go. If you however choose to do this, do have a look at the **remarks** further down or at the :ref:`AdobeManual`. ================================ ============================================== **Method / Attribute** **Description** ================================ ============================================== :meth:`Matrix.prerotate` perform a rotation :meth:`Matrix.prescale` perform a scaling :meth:`Matrix.preshear` perform a shearing (skewing) :meth:`Matrix.pretranslate` perform a translation (shifting) :meth:`Matrix.concat` perform a matrix multiplication :meth:`Matrix.invert` calculate the inverted matrix :meth:`Matrix.norm` the Euclidean norm :attr:`Matrix.a` zoom factor X direction :attr:`Matrix.b` shearing effect Y direction :attr:`Matrix.c` shearing effect X direction :attr:`Matrix.d` zoom factor Y direction :attr:`Matrix.e` horizontal shift :attr:`Matrix.f` vertical shift :attr:`Matrix.is_rectilinear` true if rect corners will remain rect corners ================================ ============================================== **Class API** .. class:: Matrix .. method:: __init__(self) .. method:: __init__(self, zoom-x, zoom-y) .. method:: __init__(self, shear-x, shear-y, 1) .. method:: __init__(self, a, b, c, d, e, f) .. method:: __init__(self, matrix) .. method:: __init__(self, degree) .. method:: __init__(self, sequence) Overloaded constructors. Without parameters, the zero matrix *Matrix(0.0, 0.0, 0.0, 0.0, 0.0, 0.0)* will be created. *zoom-** and *shear-** specify zoom or shear values (float) and create a zoom or shear matrix, respectively. For "matrix" a **new copy** of another matrix will be made. Float value "degree" specifies the creation of a rotation matrix which rotates anti-clockwise. A "sequence" must be any Python sequence object with exactly 6 float entries (see :ref:`SequenceTypes`). *pymupdf.Matrix(1, 1)* and *pymupdf.Matrix(pymupdf.Identity)* create modifiable versions of the :ref:`Identity` matrix, which looks like *[1, 0, 0, 1, 0, 0]*. .. method:: norm() * New in version 1.16.0 Return the Euclidean norm of the matrix as a vector. .. method:: prerotate(deg) Modify the matrix to perform a counter-clockwise rotation for positive *deg* degrees, else clockwise. The matrix elements of an identity matrix will change in the following way: *[1, 0, 0, 1, 0, 0] -> [cos(deg), sin(deg), -sin(deg), cos(deg), 0, 0]*. :arg float deg: The rotation angle in degrees (use conventional notation based on Pi = 180 degrees). .. method:: prescale(sx, sy) Modify the matrix to scale by the zoom factors sx and sy. Has effects on attributes *a* thru *d* only: *[a, b, c, d, e, f] -> [a*sx, b*sx, c*sy, d*sy, e, f]*. :arg float sx: Zoom factor in X direction. For the effect see description of attribute *a*. :arg float sy: Zoom factor in Y direction. For the effect see description of attribute *d*. .. method:: preshear(sx, sy) Modify the matrix to perform a shearing, i.e. transformation of rectangles into parallelograms (rhomboids). Has effects on attributes *a* thru *d* only: *[a, b, c, d, e, f] -> [c*sy, d*sy, a*sx, b*sx, e, f]*. :arg float sx: Shearing effect in X direction. See attribute *c*. :arg float sy: Shearing effect in Y direction. See attribute *b*. .. method:: pretranslate(tx, ty) Modify the matrix to perform a shifting / translation operation along the x and / or y axis. Has effects on attributes *e* and *f* only: *[a, b, c, d, e, f] -> [a, b, c, d, tx*a + ty*c, tx*b + ty*d]*. :arg float tx: Translation effect in X direction. See attribute *e*. :arg float ty: Translation effect in Y direction. See attribute *f*. .. method:: concat(m1, m2) Calculate the matrix product *m1 * m2* and store the result in the current matrix. Any of *m1* or *m2* may be the current matrix. Be aware that matrix multiplication is not commutative. So the sequence of *m1*, *m2* is important. :arg m1: First (left) matrix. :type m1: :ref:`Matrix` :arg m2: Second (right) matrix. :type m2: :ref:`Matrix` .. method:: invert(m = None) Calculate the matrix inverse of *m* and store the result in the current matrix. Returns *1* if *m* is not invertible ("degenerate"). In this case the current matrix **will not change**. Returns *0* if *m* is invertible, and the current matrix is replaced with the inverted *m*. :arg m: Matrix to be inverted. If not provided, the current matrix will be used. :type m: :ref:`Matrix` :rtype: int .. attribute:: a Scaling in X-direction **(width)**. For example, a value of 0.5 performs a shrink of the **width** by a factor of 2. If a < 0, a left-right flip will (additionally) occur. :type: float .. attribute:: b Causes a shearing effect: each `Point(x, y)` will become `Point(x, y - b*x)`. Therefore, horizontal lines will be "tilt". :type: float .. attribute:: c Causes a shearing effect: each `Point(x, y)` will become `Point(x - c*y, y)`. Therefore, vertical lines will be "tilt". :type: float .. attribute:: d Scaling in Y-direction **(height)**. For example, a value of 1.5 performs a stretch of the **height** by 50%. If d < 0, an up-down flip will (additionally) occur. :type: float .. attribute:: e Causes a horizontal shift effect: Each *Point(x, y)* will become *Point(x + e, y)*. Positive (negative) values of *e* will shift right (left). :type: float .. attribute:: f Causes a vertical shift effect: Each *Point(x, y)* will become *Point(x, y - f)*. Positive (negative) values of *f* will shift down (up). :type: float .. attribute:: is_rectilinear Rectilinear means that no shearing is present and that any rotations are integer multiples of 90 degrees. Usually this is used to confirm that (axis-aligned) rectangles before the transformation are still axis-aligned rectangles afterwards. :type: bool .. note:: * This class adheres to the Python sequence protocol, so components can be accessed via their index, too. Also refer to :ref:`SequenceTypes`. * Matrices can be used with arithmetic operators almost like ordinary numbers: they can be added, subtracted, multiplied or divided -- see chapter :ref:`Algebra`. * Matrix multiplication is **not commutative** -- changing the sequence of the multiplicands will change the result in general. So it can quickly become unclear which result a transformation will yield. Examples ------------- Here are examples that illustrate some of the achievable effects. All pictures show some text, inserted under control of some matrix and relative to a fixed reference point (the red dot). 1. The :ref:`Identity` matrix performs no operation. .. image:: images/img-matrix-0.* :scale: 66 2. The scaling matrix `Matrix(2, 0.5)` stretches by a factor of 2 in horizontal, and shrinks by factor 0.5 in vertical direction. .. image:: images/img-matrix-1.* :scale: 66 3. Attributes :attr:`Matrix.e` and :attr:`Matrix.f` shift horizontally and, respectively vertically. In the following 10 to the right and 20 down. .. image:: images/img-matrix-2.* :scale: 66 4. A negative :attr:`Matrix.a` causes a left-right flip. .. image:: images/img-matrix-3.* :scale: 66 5. A negative :attr:`Matrix.d` causes an up-down flip. .. image:: images/img-matrix-4.* :scale: 66 6. Attribute :attr:`Matrix.b` tilts upwards / downwards along the x-axis. .. image:: images/img-matrix-5.* :scale: 66 7. Attribute :attr:`Matrix.c` tilts left / right along the y-axis. .. image:: images/img-matrix-6.* :scale: 66 8. Matrix `Matrix(beta)` performs counterclockwise rotations for positive angles `beta`. .. image:: images/img-matrix-7.* :scale: 66 9. Show some effects on a rectangle:: import pymupdf # just definitions and a temp PDF RED = (1, 0, 0) BLUE = (0, 0, 1) GREEN = (0, 1, 0) doc = pymupdf.open() page = doc.new_page() # rectangle r1 = pymupdf.Rect(100, 100, 200, 200) # scales down by 50% in x- and up by 50% in y-direction mat1 = pymupdf.Matrix(0.5, 1.5) # shifts by 50 in both directions mat2 = pymupdf.Matrix(1, 0, 0, 1, 50, 50) # draw corresponding rectangles page.draw_rect(r1, color=RED) # original page.draw_rect(r1 * mat1, color=GREEN) # scaled page.draw_rect(r1 * mat2, color=BLUE) # shifted doc.ez_save("matrix-effects.pdf") .. image:: images/img-matrix-9.* :scale: 66 .. include:: footer.rst ================================================ FILE: docs/module.rst ================================================ .. include:: header.rst .. _Module: ============================ Command line interface ============================ * New in version 1.16.8 PyMuPDF can also be used from the command line to perform utility functions. This feature should obsolete writing some of the most basic scripts. Admittedly, there is some functional overlap with the MuPDF CLI `mutool`. On the other hand, PDF embedded files are no longer supported by MuPDF, so PyMuPDF is offering something unique here. Invocation ----------- The command-line interface can be invoked in two ways. * Use the installed `pymupdf` command:: pymupdf * Or use Python's `-m` switch with PyMuPDF's `pymupdf` module:: python -m pymupdf .. highlight:: python General remarks: * Request help via `"-h"`, resp. command-specific help via `"command -h"`. * Parameters may be abbreviated where this does not introduce ambiguities. * Several commands support parameters `-pages` and `-xrefs`. They are intended for down-selection. Please note that: - **page numbers** for this utility must be given **1-based**. - valid :data:`xref` numbers start at 1. - Specify a comma-separated list of either *single* integers or integer *ranges*. A **range** is a pair of integers separated by one hyphen "-". Integers must not exceed the maximum page, resp. xref number. To specify that maximum, the symbolic variable "N" may be used. Integers or ranges may occur several times, in any sequence and may overlap. If in a range the first number is greater than the second one, the respective items will be processed in reversed order. * How to use the module inside your script:: >>> import pymupdf.__main__ >>> cmd = "clean input.pdf output.pdf -pages 1,N".split() # prepare command line >>> saved_parms = sys.argv[1:] # save original command line >>> sys.argv[1:] = cmd # store new command line >>> pymupdf.__main__.() # execute module >>> sys.argv[1:] = saved_parms # restore original command line * Use the following 2-liner and compile it with `Nuitka `_ in standalone mode. This will give you a CLI executable with all the module's features, that can be used on all compatible platforms without Python, PyMuPDF or MuPDF being installed. :: from pymupdf.__main__ import main main() Cleaning and Copying ---------------------- .. highlight:: text This command will optimize the PDF and store the result in a new file. You can use it also for encryption, decryption and creating sub documents. It is mostly similar to the MuPDF command line utility *"mutool clean"*:: pymupdf clean -h usage: pymupdf clean [-h] [-password PASSWORD] [-encryption {keep,none,rc4-40,rc4-128,aes-128,aes-256}] [-owner OWNER] [-user USER] [-garbage {0,1,2,3,4}] [-compress] [-ascii] [-linear] [-permission PERMISSION] [-sanitize] [-pretty] [-pages PAGES] input output -------------- optimize PDF or create sub-PDF if pages given -------------- positional arguments: input PDF filename output output PDF filename optional arguments: -h, --help show this help message and exit -password PASSWORD password -encryption {keep,none,rc4-40,rc4-128,aes-128,aes-256} encryption method -owner OWNER owner password -user USER user password -garbage {0,1,2,3,4} garbage collection level -compress compress (deflate) output -ascii ASCII encode binary data -linear format for fast web display -permission PERMISSION integer with permission levels -sanitize sanitize / clean contents -pretty prettify PDF structure -pages PAGES output selected pages, format: 1,5-7,50-N If you specify "-pages", be aware that only page-related objects are copied, **no document-level items** like e.g. embedded files. Please consult :meth:`Document.save` for the parameter meanings. Extracting Fonts and Images ---------------------------- Extract fonts or images from selected PDF pages to a desired directory:: pymupdf extract -h usage: pymupdf extract [-h] [-images] [-fonts] [-output OUTPUT] [-password PASSWORD] [-pages PAGES] input --------------------- extract images and fonts to disk -------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -images extract images -fonts extract fonts -output OUTPUT output directory, defaults to current -password PASSWORD password -pages PAGES only consider these pages, format: 1,5-7,50-N **Image filenames** are built according to the naming scheme: **"img-xref.ext"**, where "ext" is the extension associated with the image and "xref" the :data:`xref` of the image PDF object. **Font filenames** consist of the fontname and the associated extension. Any spaces in the fontname are replaced with hyphens "-". The output directory must already exist. .. note:: Except for output directory creation, this feature is **functionally equivalent** to and obsoletes `this script `_. Joining PDF Documents ----------------------- To join several PDF files specify:: pymupdf join -h usage: pymupdf join [-h] -output OUTPUT [input [input ...]] ---------------------------- join PDF documents --------------------------- positional arguments: input input filenames optional arguments: -h, --help show this help message and exit -output OUTPUT output filename specify each input as 'filename[,password[,pages]]' .. note:: 1. Each input must be entered as **"filename,password,pages"**. Password and pages are optional. 2. The password entry **is required** if the "pages" entry is used. If the PDF needs no password, specify two commas. 3. The **"pages"** format is the same as explained at the top of this section. 4. Each input file is immediately closed after use. Therefore you can use one of them as output filename, and thus overwrite it. Example: To join the following files 1. **file1.pdf:** all pages, back to front, no password 2. **file2.pdf:** last page, first page, password: "secret" 3. **file3.pdf:** pages 5 to last, no password and store the result as **output.pdf** enter this command: ``pymupdf join -o output.pdf file1.pdf,,N-1 file2.pdf,secret,N,1 file3.pdf,,5-N`` Low Level Information ---------------------- Display PDF internal information. Again, there are similarities to *"mutool show"*:: pymupdf show -h usage: pymupdf show [-h] [-password PASSWORD] [-catalog] [-trailer] [-metadata] [-xrefs XREFS] [-pages PAGES] input ------------------------- display PDF information ------------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -password PASSWORD password -catalog show PDF catalog -trailer show PDF trailer -metadata show PDF metadata -xrefs XREFS show selected objects, format: 1,5-7,N -pages PAGES show selected pages, format: 1,5-7,50-N Examples:: pymupdf show x.pdf PDF is password protected pymupdf show x.pdf -pass hugo authentication unsuccessful pymupdf show x.pdf -pass jorjmckie authenticated as owner file 'x.pdf', pages: 1, objects: 19, 58 MB, PDF 1.4, encryption: Standard V5 R6 256-bit AES Document contains 15 embedded files. pymupdf show FDA-1572_508_R6_FINAL.pdf -tr -m 'FDA-1572_508_R6_FINAL.pdf', pages: 2, objects: 1645, 1.4 MB, PDF 1.6, encryption: Standard V4 R4 128-bit AES document contains 740 root form fields and is signed ------------------------------- PDF metadata ------------------------------ format: PDF 1.6 title: FORM FDA 1572 author: PSC Publishing Services subject: Statement of Investigator keywords: None creator: PScript5.dll Version 5.2.2 producer: Acrobat Distiller 9.0.0 (Windows) creationDate: D:20130522104413-04'00' modDate: D:20190718154905-07'00' encryption: Standard V4 R4 128-bit AES ------------------------------- PDF trailer ------------------------------- << /DecodeParms << /Columns 5 /Predictor 12 >> /Encrypt 1389 0 R /Filter /FlateDecode /ID [ <9252E9E39183F2A0B0C51BE557B8A8FC> <85227BE9B84B724E8F678E1529BA8351> ] /Index [ 1388 258 ] /Info 1387 0 R /Length 253 /Prev 1510559 /Root 1390 0 R /Size 1646 /Type /XRef /W [ 1 3 1 ] >> Embedded Files Commands ------------------------ The following commands deal with embedded files -- which is a feature completely removed from MuPDF after v1.14, and hence from all its command line tools. Information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Show the embedded file names (long or short format):: pymupdf embed-info -h usage: pymupdf embed-info [-h] [-name NAME] [-detail] [-password PASSWORD] input --------------------------- list embedded files --------------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -name NAME if given, report only this one -detail show detail information -password PASSWORD password Example:: pymupdf embed-info some.pdf 'some.pdf' contains the following 15 embedded files. 20110813_180956_0002.jpg 20110813_181009_0003.jpg 20110813_181012_0004.jpg 20110813_181131_0005.jpg 20110813_181144_0006.jpg 20110813_181306_0007.jpg 20110813_181307_0008.jpg 20110813_181314_0009.jpg 20110813_181315_0010.jpg 20110813_181324_0011.jpg 20110813_181339_0012.jpg 20110813_181913_0013.jpg insta-20110813_180944_0001.jpg markiert-20110813_180944_0001.jpg neue.datei Detailed output would look like this per entry:: name: neue.datei filename: text-tester.pdf ufilename: text-tester.pdf desc: nur zum Testen! size: 4639 length: 1566 Extraction ~~~~~~~~~~~~~~~~~~~~~~~~~ Extract an embedded file like this:: pymupdf embed-extract -h usage: pymupdf embed-extract [-h] -name NAME [-password PASSWORD] [-unsafe] [-output OUTPUT] input ---------------------- extract embedded file to disk ---------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -name NAME name of entry -password PASSWORD password -unsafe allow write to stored name even if an existing file or outside current directory -output OUTPUT output filename, default is stored name For details consult :meth:`Document.embfile_get`. Example (refer to previous section):: pymupdf embed-extract some.pdf -name neue.datei Saved entry 'neue.datei' as 'text-tester.pdf' Deletion ~~~~~~~~~~~~~~~~~~~~~~~~ Delete an embedded file like this:: pymupdf embed-del -h usage: pymupdf embed-del [-h] [-password PASSWORD] [-output OUTPUT] -name NAME input --------------------------- delete embedded file -------------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -password PASSWORD password -output OUTPUT output PDF filename, incremental save if none -name NAME name of entry to delete For details consult :meth:`Document.embfile_del`. Insertion ~~~~~~~~~~~~~~~~~~~~~~~~ Add a new embedded file using this command:: pymupdf embed-add -h usage: pymupdf embed-add [-h] [-password PASSWORD] [-output OUTPUT] -name NAME -path PATH [-desc DESC] input ---------------------------- add embedded file ---------------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -password PASSWORD password -output OUTPUT output PDF filename, incremental save if none -name NAME name of new entry -path PATH path to data for new entry -desc DESC description of new entry *"NAME"* **must not** already exist in the PDF. For details consult :meth:`Document.embfile_add`. Updates ~~~~~~~~~~~~~~~~~~~~~~~ Update an existing embedded file using this command:: pymupdf embed-upd -h usage: pymupdf embed-upd [-h] -name NAME [-password PASSWORD] [-output OUTPUT] [-path PATH] [-filename FILENAME] [-ufilename UFILENAME] [-desc DESC] input --------------------------- update embedded file -------------------------- positional arguments: input PDF filename optional arguments: -h, --help show this help message and exit -name NAME name of entry -password PASSWORD password -output OUTPUT Output PDF filename, incremental save if none -path PATH path to new data for entry -filename FILENAME new filename to store in entry -ufilename UFILENAME new unicode filename to store in entry -desc DESC new description to store in entry except '-name' all parameters are optional Use this method to change meta-information of the file -- just omit the *"PATH"*. For details consult :meth:`Document.embfile_upd`. Copying ~~~~~~~~~~~~~~~~~~~~~~~ Copy embedded files between PDFs:: pymupdf embed-copy -h usage: pymupdf embed-copy [-h] [-password PASSWORD] [-output OUTPUT] -source SOURCE [-pwdsource PWDSOURCE] [-name [NAME [NAME ...]]] input --------------------- copy embedded files between PDFs -------------------- positional arguments: input PDF to receive embedded files optional arguments: -h, --help show this help message and exit -password PASSWORD password of input -output OUTPUT output PDF, incremental save to 'input' if omitted -source SOURCE copy embedded files from here -pwdsource PWDSOURCE password of 'source' PDF -name [NAME [NAME ...]] restrict copy to these entries Text Extraction ---------------- * New in v1.18.16 Extract text from arbitrary :ref:`supported documents` to a textfile. Currently, there are three output formatting modes available: simple, block sorting and reproduction of physical layout. * **Simple** text extraction reproduces all text as it appears in the document pages -- no effort is made to rearrange in any particular reading order. * **Block sorting** sorts text blocks (as identified by MuPDF) by ascending vertical, then horizontal coordinates. This should be sufficient to establish a "natural" reading order for basic pages of text. * **Layout** strives to reproduce the original appearance of the input pages. You can expect results like this (produced by the command `pymupdf gettext -pages 1 demo1.pdf`): .. image:: images/img-layout-text.* :scale: 60 .. note:: The "gettext" command offers a functionality similar to the CLI tool `pdftotext` by XPDF software, http://www.foolabs.com/xpdf/ -- this is especially true for "layout" mode, which combines that tool's `-layout` and `-table` options. After each page of the output file, a formfeed character, `hex(12)` is written -- even if the input page has no text at all. This behavior can be controlled via options. .. note:: For "layout" mode, **only horizontal, left-to-right, top-to bottom** text is supported, other text is ignored. In this mode, text is also ignored, if its :data:`fontsize` is too small. "Simple" and "blocks" mode in contrast output **all text** for any text size or orientation. Command:: pymupdf gettext -h usage: pymupdf gettext [-h] [-password PASSWORD] [-mode {simple,blocks,layout}] [-pages PAGES] [-noligatures] [-convert-white] [-extra-spaces] [-noformfeed] [-skip-empty] [-output OUTPUT] [-grid GRID] [-fontsize FONTSIZE] input ----------------- extract text in various formatting modes ---------------- positional arguments: input input document filename optional arguments: -h, --help show this help message and exit -password PASSWORD password for input document -mode {simple,blocks,layout} mode: simple, block sort, or layout (default) -pages PAGES select pages, format: 1,5-7,50-N -noligatures expand ligature characters (default False) -convert-white convert whitespace characters to space (default False) -extra-spaces fill gaps with spaces (default False) -noformfeed write linefeeds, no formfeeds (default False) -skip-empty suppress pages with no text (default False) -output OUTPUT store text in this file (default inputfilename.txt) -grid GRID merge lines if closer than this (default 2) -fontsize FONTSIZE only include text with a larger :data:`fontsize` (default 3) .. note:: Command options may be abbreviated as long as no ambiguities are introduced. So the following do the same: * `... -output text.txt -noligatures -noformfeed -convert-white -grid 3 -extra-spaces ...` * `... -o text.txt -nol -nof -c -g 3 -e ...` The output filename defaults to the input with its extension replaced by `.txt`. As with other commands, you can select page ranges **(caution: 1-based!)** in `mutool` format, as indicated above. * **mode:** (str) select a formatting mode -- default is "layout". * **noligatures:** (bool) corresponds to **not** :data:`TEXT_PRESERVE_LIGATURES`. If specified, ligatures (present in advanced fonts: glyphs combining multiple characters like "fi") are split up into their components (i.e. "f", "i"). Default is passing them through. * **convert-white:** corresponds to **not** :data:`TEXT_PRESERVE_WHITESPACE`. If specified, all white space characters (like tabs) are replaced with one or more spaces. Default is passing them through. * **extra-spaces:** (bool) corresponds to **not** :data:`TEXT_INHIBIT_SPACES`. If specified, large gaps between adjacent characters will be filled with one or more spaces. Default is off. * **noformfeed:** (bool) instead of `hex(12)` (formfeed), write linebreaks ``\n`` at end of output pages. * **skip-empty:** (bool) skip pages with no text. * **grid:** lines with a vertical coordinate difference of no more than this value (in points) will be merged into the same output line. Only relevant for "layout" mode. **Use with care:** 3 or the default 2 should be adequate in most cases. If **too large**, lines that are *intended* to be different in the original may be merged and will result in garbled and / or incomplete output. If **too low**, artifact separate output lines may be generated for some spans in the input line, just because they are coded in a different font with slightly deviating properties. * **fontsize:** include text with :data:`fontsize` larger than this value only (default 3). Only relevant for "layout" option. .. highlight:: python .. include:: footer.rst ================================================ FILE: docs/ocr/tesseract-language-packs.rst ================================================ .. include:: ../header.rst .. _pymupdf-pro: .. raw:: html .. _tesseract-language-packs: Tesseract Language Packs ======================== .. meta:: :description: How to install additional Tesseract language packs on macOS, Linux, and Windows. Overview -------- Tesseract identifies languages using three-letter `ISO 639-2 `_ codes. English (``eng``) is installed by default on most platforms. For any other language, you need to install the corresponding language pack before pymupdf4llm can use it for OCR. A full list of supported language codes is available on the `Tesseract tessdata repository `_. .. tip:: To see which languages are already installed on your system, run ``tesseract --list-langs`` in your terminal. ---- Linux ----- Language pack installation varies slightly by distribution. **Ubuntu / Debian** .. code-block:: bash # List all available language packs apt-cache search tesseract-ocr # Install a specific language (e.g. German) sudo apt install tesseract-ocr-deu # Install all available languages at once sudo apt install tesseract-ocr-all Language packages follow the naming pattern ``tesseract-ocr-``, for example ``tesseract-ocr-fra`` for French or ``tesseract-ocr-chi-sim`` for Simplified Chinese. **Fedora / RHEL** .. code-block:: bash # Search for available language packs dnf search tesseract # Install a specific language (e.g. German) sudo dnf install tesseract-langpack-deu # Install all language packs sudo dnf install tesseract-langpack-* On Fedora, packages are named ``tesseract-langpack-``. **Arch Linux** .. code-block:: bash # Search for available language packs pacman -Ss tesseract-data # Install a specific language (e.g. German) sudo pacman -S tesseract-data-deu On Arch, packages are named ``tesseract-data-``. Manual Installation (All Distros) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If a language pack is not available through your package manager, download the ``.traineddata`` file directly from GitHub and copy it to your Tesseract data directory: .. code-block:: bash # Download language pack (e.g. French) curl -L https://github.com/tesseract-ocr/tessdata/raw/main/fra.traineddata \ -o fra.traineddata # Copy to tessdata directory (path varies by distro) sudo cp fra.traineddata /usr/share/tesseract-ocr/4.00/tessdata/ # or sudo cp fra.traineddata /usr/share/tessdata/ Common tessdata locations on Linux: .. list-table:: :header-rows: 1 :widths: 40 60 * - Distribution - Path * - Ubuntu / Debian - ``/usr/share/tesseract-ocr/4.00/tessdata/`` * - Fedora / RHEL - ``/usr/share/tesseract/tessdata/`` * - Arch Linux - ``/usr/share/tessdata/`` ---- Windows ------- During Installation (Recommended) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The Tesseract Windows installer from `UB Mannheim `_ lets you select additional language packs during setup. When you reach the **Choose Components** screen, expand **Additional language data** and tick the languages you need. After Installation (Manual) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If Tesseract is already installed, download language packs manually: 1. Go to `github.com/tesseract-ocr/tessdata `_ 2. Download the ``.traineddata`` file for your language (e.g. ``fra.traineddata`` for French) 3. Copy the file into your Tesseract ``tessdata`` folder, typically: .. code-block:: text C:\Program Files\Tesseract-OCR\tessdata\ .. note:: The Chocolatey (``choco install tesseract``) package only includes English. All additional languages must be added manually using the steps above. Verify the Install ~~~~~~~~~~~~~~~~~~ Open Command Prompt or PowerShell and run: .. code-block:: powershell tesseract --list-langs Your newly installed language should appear in the output. ---- macOS ----- The recommended approach on macOS is `Homebrew `_. There are two options depending on how much disk space you want to use. Install All Languages at Once ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The ``tesseract-lang`` formula bundles Tesseract with every available language pack: .. code-block:: bash brew install tesseract-lang Install Specific Languages ~~~~~~~~~~~~~~~~~~~~~~~~~~ If you only need a few languages, install ``tesseract`` first and then manually download the ``.traineddata`` files you need: .. code-block:: bash # Install Tesseract engine only brew install tesseract # Find the tessdata directory brew info tesseract # Look for a line like: /opt/homebrew/share/tessdata # Download a specific language pack (e.g. French) curl -L https://github.com/tesseract-ocr/tessdata/raw/main/fra.traineddata \ -o /opt/homebrew/share/tessdata/fra.traineddata Replace ``fra`` with your target language code and adjust the tessdata path to match what ``brew info tesseract`` reports on your machine. .. note:: If you installed Tesseract via MacPorts instead of Homebrew, use ``port install tesseract-``, for example ``sudo port install tesseract-fra``. ---- Using a Language with pymupdf4llm ---------------------------------- Once a language pack is installed, pass its code to ``to_markdown()`` via the ``ocr_language`` parameter: .. code-block:: python import pymupdf4llm # Single language md = pymupdf4llm.to_markdown("document.pdf", ocr_language="fra") # Multiple languages md = pymupdf4llm.to_markdown("document.pdf", ocr_language="eng+fra+deu") ---- Common Language Codes --------------------- .. list-table:: :header-rows: 1 :widths: 50 50 * - Language - Code * - English - ``eng`` * - French - ``fra`` * - German - ``deu`` * - Spanish - ``spa`` * - Italian - ``ita`` * - Portuguese - ``por`` * - Simplified Chinese - ``chi_sim`` * - Traditional Chinese - ``chi_tra`` * - Japanese - ``jpn`` * - Korean - ``kor`` * - Arabic - ``ara`` * - Russian - ``rus`` * - Hindi - ``hin`` For the full list of supported languages and their codes, see the `Tesseract tessdata repository `_. .. include:: ../footer.rst ================================================ FILE: docs/outline.rst ================================================ .. include:: header.rst .. _Outline: ================ Outline ================ The document outline (otherwise known as "bookmarks") is a property of :ref:`Document` (see :attr:`Document.outline`). If not ``None``, it stands for the first outline item of the document. Its properties in turn define the characteristics of this item and also point to other outline items in "horizontal" or downward direction. The full tree of all outline items for e.g. a conventional table of contents (TOC) can be recovered by following these "pointers". ============================ ================================================== **Method / Attribute** **Short Description** ============================ ================================================== :attr:`Outline.down` next item downwards :attr:`Outline.next` next item same level :attr:`Outline.page` page number (0-based) :attr:`Outline.title` title :attr:`Outline.uri` string further specifying outline target :attr:`Outline.is_external` target outside document :attr:`Outline.is_open` whether sub-outlines are open or collapsed :attr:`Outline.dest` points to destination details object ============================ ================================================== **Class API** .. class:: Outline .. attribute:: down The next outline item on the next level down. Is ``None`` if the item has no children. :type: :ref:`Outline` .. attribute:: next The next outline item at the same level as this item. Is ``None`` if this is the last one in its level. :type: `Outline` .. attribute:: page The page number (0-based) this bookmark points to. :type: int .. attribute:: title The item's title as a string or ``None``. :type: str .. attribute:: is_open Indicator showing whether any sub-outlines should be expanded (``True``) or be collapsed (``False``). This information is interpreted by PDF reader software. :type: bool .. attribute:: is_external A bool specifying whether the target is outside (``True``) of the current document. :type: bool .. attribute:: uri A string specifying the link target. The meaning of this property should be evaluated in conjunction with property `is_external`: * `is_external` is true: ``uri`` points to some target outside the current PDF, which may be an internet resource (``uri`` starts with ``http://`` or similar), another file (``uri`` starts with ``file:`` or ``file://``) or some other service like an e-mail address (``uri`` starts with ``mailto:``). * `is_external` is false: ``uri`` will be `None` or point to an internal location. In case of PDF documents, this should either be *#nnnn* to indicate a 1-based (!) page number *nnnn*, or a named location. The format varies for other document types, for example "../FixedDoc.fdoc#PG_2_LNK_1" for page number 2 (1-based) in an XPS document. :type: str .. attribute:: dest The link destination details object. :type: :ref:`linkDest` .. include:: footer.rst ================================================ FILE: docs/packaging.rst ================================================ .. include:: header.rst Packaging for Linux distributions ================================= Requirements ------------ * Python * MuPDF checkout (including submodules). * PyMuPDF checkout. * System packages listed in `scripts/sysinstall.py:g_sys_packages`. * Python packages listed in `pyproject.toml`. Extra requirements for running tests: * Python packages listed in `scripts/gh_release.py:test_packages`. General steps ------------- * Build and install MuPDF: * Install required system packages. * Run `make install-shared-python` on MuPDF's `Makefile` with at least these make variables: * `DESTDIR` set to the install directory, e.g. `/`. * `prefix` set to location relative to DESTDIR, such as `/usr/local` or `/usr`. Must start with `/`. * `USE_SYSTEM_LIBS=yes`. * `HAVE_LEPTONICA=yes`. * `HAVE_TESSERACT=yes`. * Build and install PyMuPDF: * Run `pip install ./PyMuPDF` or `pip wheel ./PyMuPDF` with at least these environment variables: * `PYMUPDF_SETUP_MUPDF_BUILD=` (empty string) to prevent download and build of hard-coded MuPDF release. * `CFLAGS`, `CXXFLAGS` and `LDFLAGS` set to allow visibility of the installed MuPDF headers and shared libraries. * Run PyMuPDF tests: * Ensure required Python packages are available. * Run `pytest -k "not test_color_count and not test_3050" PyMuPDF` * Test `test_color_count` is known fail if MuPDF is not built with PyMuPDF's custom config.h. * Test `test_3050` is known to fail if MuPDF is built without its own third-party libraries. Use of scripts/sysinstall.py ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ `scripts/sysinstall.py` provides a useful example of build, install and test commands that are known to to work, because it is run regularly by Github action `.github/workflows/test_sysinstall.yml`. * Run with `-h` or look at the doc-string to see detailed usage information. * It uses Debian-style `apt` commands to install system packages. * By default it assumes local git checkouts `mupdf/` and `PyMuPDF/`. To run a full build, install and test for both a local fake root and the system root: .. code-block:: shell ./PyMuPDF/scripts/sysinstall.py ./PyMuPDF/scripts/sysinstall.py --root / To see what commands would be run without actually running them: .. code-block:: shell ./PyMuPDF/scripts/sysinstall.py -m 0 -p 0 -t 0 See also -------- * `setup.py`'s initial doc-comment has detailed information about the environment variables used when building PyMuPDF. ================================================ FILE: docs/page.rst ================================================ .. include:: header.rst .. _Page: ================ Page ================ Class representing a document page. A page object is created by :meth:`Document.load_page` or, equivalently, via indexing the document like `doc[n]` - it has no independent constructor. There is a parent-child relationship between a document and its pages. If the document is closed or deleted, all page objects (and their respective children, too) in existence will become unusable ("orphaned"): If a page property or method is being used, an exception is raised. Several page methods have a :ref:`Document` counterpart for convenience. At the end of this chapter you will find a synopsis. .. note:: Many times in this chapter we are using the term **coordinate**. It is of high importance to have at least a basic understanding of what that is and that you feel comfortable with the section :ref:`Coordinates`. Modifying Pages --------------- Changing page properties and adding or changing page content is available for PDF documents only. In a nutshell, this is what you can do with PyMuPDF: * Modify page rotation and the visible part ("cropbox") of the page. * Insert images, other PDF pages, text and simple geometrical objects. * Add annotations and form fields. .. note:: Methods require coordinates (points, rectangles) to put content in desired places. Please be aware that these coordinates **must always** be provided relative to the **unrotated** page (since v1.17.0). The reverse is also true: except :attr:`Page.rect`, resp. :meth:`Page.bound` (both *reflect* when the page is rotated), all coordinates returned by methods and attributes pertain to the unrotated page. So the returned value of e.g. :meth:`Page.get_image_bbox` will not change if you do a :meth:`Page.set_rotation`. The same is true for coordinates returned by :meth:`Page.get_text`, annotation rectangles, and so on. If you want to find out, where an object is located in **rotated coordinates**, multiply the coordinates with :attr:`Page.rotation_matrix`. There also is its inverse, :attr:`Page.derotation_matrix`, which you can use when interfacing with other readers, which may behave differently in this respect. .. note:: If you add or update annotations, links or form fields on the page and immediately afterwards need to work with them (i.e. **without leaving the page**), you should reload the page using :meth:`Document.reload_page` before referring to these new or updated items. Reloading the page is generally recommended -- although not strictly required in all cases. However, some annotation and widget types have extended features in PyMuPDF compared to MuPDF. More of these extensions may also be added in the future. Releoading the page ensures all your changes have been fully applied to PDF structures, so you can safely create Pixmaps or successfully iterate over annotations, links and form fields. ================================== ======================================================= **Method / Attribute** **Short Description** ================================== ======================================================= :meth:`Page.add_caret_annot` PDF only: add a caret annotation :meth:`Page.add_circle_annot` PDF only: add a circle annotation :meth:`Page.add_file_annot` PDF only: add a file attachment annotation :meth:`Page.add_freetext_annot` PDF only: add a text annotation :meth:`Page.add_highlight_annot` PDF only: add a "highlight" annotation :meth:`Page.add_ink_annot` PDF only: add an ink annotation :meth:`Page.add_line_annot` PDF only: add a line annotation :meth:`Page.add_polygon_annot` PDF only: add a polygon annotation :meth:`Page.add_polyline_annot` PDF only: add a multi-line annotation :meth:`Page.add_rect_annot` PDF only: add a rectangle annotation :meth:`Page.add_redact_annot` PDF only: add a redaction annotation :meth:`Page.add_squiggly_annot` PDF only: add a "squiggly" annotation :meth:`Page.add_stamp_annot` PDF only: add a "rubber stamp" annotation :meth:`Page.add_strikeout_annot` PDF only: add a "strike-out" annotation :meth:`Page.add_text_annot` PDF only: add a comment :meth:`Page.add_underline_annot` PDF only: add an "underline" annotation :meth:`Page.add_widget` PDF only: add a PDF Form field :meth:`Page.annot_names` PDF only: a list of annotation (and widget) names :meth:`Page.annot_xrefs` PDF only: a list of annotation (and widget) xrefs :meth:`Page.annots` return a generator over the annots on the page :meth:`Page.apply_redactions` PDF only: process the redactions of the page :meth:`Page.clip_to_rect` PDF only: remove page content outside a rectangle :meth:`Page.bound` rectangle of the page :meth:`Page.cluster_drawings` PDF only: bounding boxes of vector graphics :meth:`Page.delete_annot` PDF only: delete an annotation :meth:`Page.delete_image` PDF only: delete an image :meth:`Page.delete_link` PDF only: delete a link :meth:`Page.delete_widget` PDF only: delete a widget / field :meth:`Page.draw_bezier` PDF only: draw a cubic Bezier curve :meth:`Page.draw_circle` PDF only: draw a circle :meth:`Page.draw_curve` PDF only: draw a special Bezier curve :meth:`Page.draw_line` PDF only: draw a line :meth:`Page.draw_oval` PDF only: draw an oval / ellipse :meth:`Page.draw_polyline` PDF only: connect a point sequence :meth:`Page.draw_quad` PDF only: draw a quad :meth:`Page.draw_rect` PDF only: draw a rectangle :meth:`Page.draw_sector` PDF only: draw a circular sector :meth:`Page.draw_squiggle` PDF only: draw a squiggly line :meth:`Page.draw_zigzag` PDF only: draw a zig-zagged line :meth:`Page.find_tables` locate tables on the page :meth:`Page.get_drawings` get vector graphics on page :meth:`Page.get_fonts` PDF only: get list of referenced fonts :meth:`Page.get_image_bbox` PDF only: get bbox and matrix of embedded image :meth:`Page.get_image_info` get list of meta information for all used images :meth:`Page.get_image_rects` PDF only: improved version of :meth:`Page.get_image_bbox` :meth:`Page.get_images` PDF only: get list of referenced images :meth:`Page.get_label` PDF only: return the label of the page :meth:`Page.get_links` get all links :meth:`Page.get_pixmap` create a page image in raster format :meth:`Page.get_svg_image` create a page image in SVG format :meth:`Page.get_text` extract the page's text :meth:`Page.get_textbox` extract text contained in a rectangle :meth:`Page.get_textpage_ocr` create a TextPage with OCR for the page :meth:`Page.get_textpage` create a TextPage for the page :meth:`Page.get_xobjects` PDF only: get list of referenced xobjects :meth:`Page.insert_font` PDF only: insert a font for use by the page :meth:`Page.insert_image` PDF only: insert an image :meth:`Page.insert_link` PDF only: insert a link :meth:`Page.insert_text` PDF only: insert text :meth:`Page.insert_htmlbox` PDF only: insert html text in a rectangle :meth:`Page.insert_textbox` PDF only: insert a text box :meth:`Page.links` return a generator of the links on the page :meth:`Page.load_annot` PDF only: load a specific annotation :meth:`Page.load_widget` PDF only: load a specific field :meth:`Page.load_links` return the first link on a page :meth:`Page.new_shape` PDF only: create a new :ref:`Shape` :meth:`Page.recolor` PDF only: change the colorspace of objects :meth:`Page.remove_rotation` PDF only: set page rotation to 0 :meth:`Page.replace_image` PDF only: replace an image :meth:`Page.search_for` search for a string :meth:`Page.set_artbox` PDF only: modify `/ArtBox` :meth:`Page.set_bleedbox` PDF only: modify `/BleedBox` :meth:`Page.set_cropbox` PDF only: modify the :data:`cropbox` (visible page) :meth:`Page.set_mediabox` PDF only: modify `/MediaBox` :meth:`Page.set_rotation` PDF only: set page rotation :meth:`Page.set_trimbox` PDF only: modify `/TrimBox` :meth:`Page.show_pdf_page` PDF only: display PDF page image :meth:`Page.update_link` PDF only: modify a link :meth:`Page.widgets` return a generator over the fields on the page :meth:`Page.write_text` write one or more :ref:`Textwriter` objects :attr:`Page.cropbox_position` displacement of the :data:`cropbox` :attr:`Page.cropbox` the page's :data:`cropbox` :attr:`Page.artbox` the page's `/ArtBox` :attr:`Page.bleedbox` the page's `/BleedBox` :attr:`Page.trimbox` the page's `/TrimBox` :attr:`Page.derotation_matrix` PDF only: get coordinates in unrotated page space :attr:`Page.first_annot` first :ref:`Annot` on the page :attr:`Page.first_link` first :ref:`Link` on the page :attr:`Page.first_widget` first widget (form field) on the page :attr:`Page.mediabox_size` bottom-right point of :data:`mediabox` :attr:`Page.mediabox` the page's :data:`mediabox` :attr:`Page.number` page number :attr:`Page.parent` owning document object :attr:`Page.rect` rectangle of the page :attr:`Page.rotation_matrix` PDF only: get coordinates in rotated page space :attr:`Page.rotation` PDF only: page rotation :attr:`Page.transformation_matrix` PDF only: translate between PDF and MuPDF space :attr:`Page.xref` PDF only: page :data:`xref` ================================== ======================================================= **Class API** .. class:: Page .. method:: bound() Determine the rectangle of the page. Same as property :attr:`Page.rect`. For PDF documents this **usually** also coincides with :data:`mediabox` and :data:`cropbox`, but not always. For example, if the page is rotated, then this is reflected by this method -- the :attr:`Page.cropbox` however will not change. :rtype: :ref:`Rect` .. method:: add_caret_annot(point) PDF only: Add a caret icon. A caret annotation is a visual symbol normally used to indicate the presence of text edits on the page. :arg point_like point: the top left point of a 20 x 20 rectangle containing the MuPDF-provided icon. :rtype: :ref:`Annot` :returns: the created annotation. Stroke color blue = (0, 0, 1), no fill color support. .. image:: images/img-caret-annot.* :scale: 70 |history_begin| * New in v1.16.0 |history_end| .. method:: add_text_annot(point, text, icon="Note") PDF only: Add a comment icon ("sticky note") with accompanying text. Only the icon is visible, the accompanying text is hidden and can be visualized by many PDF viewers by hovering the mouse over the symbol. :arg point_like point: the top left point of a 20 x 20 rectangle containing the MuPDF-provided "note" icon. :arg str text: the commentary text. This will be shown on double clicking or hovering over the icon. May contain any Latin characters. :arg str icon: choose one of "Note" (default), "Comment", "Help", "Insert", "Key", "NewParagraph", "Paragraph" as the visual symbol for the embodied text [#f4]_. (New in v1.16.0) :rtype: :ref:`Annot` :returns: the created annotation. Stroke color yellow = (1, 1, 0), no fill color support. .. index:: pair: rect; add_freetext_annot pair: fontsize; add_freetext_annot pair: fontname; add_freetext_annot pair: text_color; add_freetext_annot pair: fill_color; add_freetext_annot pair: border_width; add_freetext_annot pair: dashes; add_freetext_annot pair: callout; add_freetext_annot pair: line_end; add_freetext_annot pair: opacity; add_freetext_annot pair: align; add_freetext_annot pair: rotate; add_freetext_annot pair: richtext; add_freetext_annot pair: style; add_freetext_annot .. method:: add_freetext_annot(rect, text, *, fontsize=11, fontname="helv", text_color=0, fill_color=None, border_width=0, dashes=None, callout=None, line_end=PDF_ANNOT_LE_OPEN_ARROW, opacity=1, align=TEXT_ALIGN_LEFT, rotate=0, richtext=False, style=None) PDF only: Add text in a given rectangle. Optionally, the appearance of a "callout" shape can be requested by specifying two or three point-like objects -- see below. :arg rect_like rect: the rectangle into which the text should be inserted. Text is automatically wrapped to a new line at box width. Text portions not fitting into the rectangle will be invisible without warning. :arg str text: the text. May contain any mixture of Latin, Greek, Cyrillic, Chinese, Japanese and Korean characters. If `richtext=True` (see below), the string is interpreted as HTML syntax. This adds a plethora of ways for attractive effects. :arg float fontsize: the :data:`fontsize`. Default is 11. Ignored if `richtext=True`. :arg str fontname: The font name. Default is "Helv". Ignored if `richtext=True`, otherwise the following **restritions apply:** * Accepted alternatives are "Helv" (Helvetica), "Cour" (Courier), "TiRo" (Timnes-Roman), "ZaDb" (ZapfDingBats) and "Symb" (Symbol). The name may be abbreviated to the first two characters, like "Co" for "Cour", lower case accepted. * Bold or italic variants of the fonts are **not supported.** :arg list,tuple,float text_color: the text color. Default is black. Ignored if `richtext=True`. :arg list,tuple,float fill_color: the fill color. This is used for ``rect`` and the end point of the callout lines when applicable. Default is ``None``. :arg list,tuple,float border_color: This parameter **only has an effect** if `richtext=True`. Otherwise, ``text_color`` is used. :arg float border_width: the width of border and ``callout`` lines. Default is 0 (no border), in which case callout lines may still appear with some hairline width, depending on the PDF viewer used. In any case, this value must be positive to see a border line. :arg list,tuple dashes: a list of floats specifying how border and callout lines should be dashed. Default is ``None``. :arg list,tuple callout: a list / tuple of two or three :data:`point_like` objects, which will be interpreted as end point [, knee point] and start point (in this sequence) of up to two line segments, converting this annotation into a call-out shape. :arg int line_end: the line end symbol of the call-out line. It is drawn at the first point specified in the `callout` list. Default is an open arrow. For possible values see :ref:`AnnotationLineEnds`. :arg float opacity: a float `0 <= opacity < 1` turning the annotation transparent. Default is no transparency. :arg int align: text alignment, one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT - justify is **not supported**. Ignored if `richtext=True`. :arg int rotate: the text orientation. Accepted values are integer multiples of 90°. Invalid entries receive a rotation of 0. :arg bool richtext: treat ``text`` as HTML syntax. This allows to achieve **bold**, *italic*, arbitrary text colors, font sizes, text alignment including justify and more - as far as the PDF subset of HTML and styling instructions supports this. This is similar to what happens in :meth:`Page.insert_htmlbox`. The base library will for example pull in required fonts if it encounters characters not contained in the standard ones. Some parameters are ignored if this option is set, as mentioned above. Default is ``False``. :arg str style: supply optional HTML styling information in CSS syntax. Ignored if `richtext=False`. :rtype: :ref:`Annot` :returns: the created annotation. |history_begin| * Changed in v1.19.6: add border color parameter |history_end| .. method:: add_file_annot(point, buffer_, filename, ufilename=None, desc=None, icon="PushPin") PDF only: Add a file attachment annotation with a "PushPin" icon at the specified location. :arg point_like pos: the top-left point of a 18x18 rectangle containing the MuPDF-provided "PushPin" icon. :arg bytes,bytearray,BytesIO buffer: the data to be stored (actual file content, any data, etc.). Changed in v1.14.13: *io.BytesIO* is now also supported. :arg str filename: the filename to associate with the data. :arg str ufilename: the optional PDF unicode version of filename. Defaults to filename. :arg str desc: an optional description of the file. Defaults to filename. :arg str icon: choose one of "PushPin" (default), "Graph", "Paperclip", "Tag" as the visual symbol for the attached data [#f4]_. (New in v1.16.0) :rtype: :ref:`Annot` :returns: the created annotation. Stroke color yellow = (1, 1, 0), no fill color support. .. method:: add_ink_annot(list) PDF only: Add a "freehand" scribble annotation. :arg sequence list: a list of one or more lists, each containing :data:`point_like` items. Each item in these sublists is interpreted as a :ref:`Point` through which a connecting line is drawn. Separate sublists thus represent separate drawing lines. :rtype: :ref:`Annot` :returns: the created annotation in default appearance black =(0, 0, 0),line width 1. No fill color support. .. method:: add_line_annot(p1, p2) PDF only: Add a line annotation. :arg point_like p1: the starting point of the line. :arg point_like p2: the end point of the line. :rtype: :ref:`Annot` :returns: the created annotation. It is drawn with line (stroke) color red = (1, 0, 0) and line width 1. No fill color support. The **annot rectangle** is automatically created to contain both points, each one surrounded by a circle of radius 3 * line width to make room for any line end symbols. .. method:: add_rect_annot(rect) .. method:: add_circle_annot(rect) PDF only: Add a rectangle, resp. circle annotation. :arg rect_like rect: the rectangle in which the circle or rectangle is drawn, must be finite and not empty. If the rectangle is not equal-sided, an ellipse is drawn. :rtype: :ref:`Annot` :returns: the created annotation. It is drawn with line (stroke) color red = (1, 0, 0), line width 1, fill color is supported. --------- Redactions ~~~~~~~~~~~ .. method:: add_redact_annot(quad, text=None, fontname=None, fontsize=11, align=TEXT_ALIGN_LEFT, fill=(1, 1, 1), text_color=(0, 0, 0), cross_out=True) **PDF only**: Add a redaction annotation. A redaction annotation identifies an area whose content should be removed from the document. Adding such an annotation is the first of two steps. It makes visible what will be removed in the subsequent step, :meth:`Page.apply_redactions`. :arg quad_like,rect_like quad: specifies the (rectangular) area to be removed which is always equal to the annotation rectangle. This may be a :data:`rect_like` or :data:`quad_like` object. If a quad is specified, then the enveloping rectangle is taken. :arg str text: text to be placed in the rectangle after applying the redaction (and thus removing old content). (New in v1.16.12) :arg str fontname: the font to use when ``text`` is given, otherwise ignored. Only CJK and the :ref:`Base-14-Fonts` are supported. Apart from this, the same rules apply as for :meth:`Page.insert_textbox` -- which is what the method :meth:`Page.apply_redactions` internally invokes. :arg float fontsize: the :data:`fontsize` to use for the replacing text. If the text is too large to fit, several insertion attempts will be made, gradually reducing the :data:`fontsize` to no less than 4. If then the text will still not fit, no text insertion will take place at all. (New in v1.16.12) :arg int align: the horizontal alignment for the replacing text. See :meth:`insert_textbox` for available values. The vertical alignment is (approximately) centered. :arg sequence fill: the fill color of the rectangle **after applying** the redaction. The default is *white = (1, 1, 1)*, which is also taken if ``None`` is specified. To suppress a fill color altogether, specify ``False``. In this cases the rectangle remains transparent. (New in v1.16.12) :arg sequence text_color: the color of the replacing text. Default is *black = (0, 0, 0)*. (New in v1.16.12) :arg bool cross_out: add two diagonal lines to the annotation rectangle. (New in v1.17.2) :rtype: :ref:`Annot` :returns: the created annotation. Its standard appearance looks like a red rectangle (no fill color), optionally showing two diagonal lines. Colors, line width, dashing, opacity and blend mode can now be set and applied via :meth:`Annot.update` like with other annotations. (Changed in v1.17.2) .. image:: images/img-redact.* |history_begin| * New in v1.16.11 |history_end| .. method:: apply_redactions(images=PDF_REDACT_IMAGE_PIXELS|2, graphics=PDF_REDACT_LINE_ART_REMOVE_IF_COVERED|1, text=PDF_REDACT_TEXT_REMOVE|0) **PDF only**: Remove all **content** contained in any redaction rectangle on the page. **This method applies and then deletes all redactions from the page.** :arg int images: How to redact overlapping images. The default `PDF_REDACT_IMAGE_PIXELS | 2` blanks out overlapping pixels. `PDF_REDACT_IMAGE_NONE | 0` ignores, and `PDF_REDACT_IMAGE_REMOVE | 1` completely removes images overlapping any redaction annotation. Option `PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE | 3` only removes images that are actually visible. :arg int graphics: How to redact overlapping vector graphics (also called "line-art" or "drawings"). The default `PDF_REDACT_LINE_ART_REMOVE_IF_COVERED | 1` removes any overlapping vector graphics. `PDF_REDACT_LINE_ART_NONE | 0` ignores, and `PDF_REDACT_LINE_ART_REMOVE_IF_TOUCHED | 2` removes graphics fully contained in a redaction annotation. When removing line-art, please be aware that **stroked** vector graphics (i.e. type "s" or "sf") have a **larger wrapping rectangle** than one might expect: first of all, at least 50% of the path's line width have to be added in each direction to truly include all of the drawing. If a so-called "miter limit" is provided (see page 121 of the PDF specification), the enlarging value is `miter * width / 2`. So, when letting everything default (width = 1, miter = 10), the redaction rectangle should be at least 5 points larger in every direction. :arg int text: Whether to redact overlapping text. The default `PDF_REDACT_TEXT_REMOVE | 0` removes all characters whose boundary box overlaps any redaction rectangle. This complies with the original legal / data protection intentions of redaction annotations. Other use cases however may require to **keep text** while redacting vector graphics or images. This can be achieved by setting `text=True|PDF_REDACT_TEXT_NONE | 1`. This does **not comply** with the data protection intentions of redaction annotations. **Do so at your own risk.** :returns: `True` if at least one redaction annotation has been processed, `False` otherwise. .. note:: * Text contained in a redaction rectangle will be **physically** removed from the page (assuming :meth:`Document.save` with a suitable garbage option) and will no longer appear in e.g. text extractions or anywhere else. All redaction annotations will also be removed. Other annotations are unaffected. * All overlapping links will be removed. If the rectangle of the link was covering text, then only the overlapping part of the text is being removed. Similar applies to images covered by link rectangles. * The overlapping parts of **images** will be blanked-out for default option `PDF_REDACT_IMAGE_PIXELS` (changed in v1.18.0). Option 0 does not touch any images and 1 will remove any image with an overlap. * For option `images=PDF_REDACT_IMAGE_REMOVE` only this page's **references to the images** are removed - not necessarily the images themselves. Images are completely removed from the file only, if no longer referenced at all (assuming suitable garbage collection options). * For option `images=PDF_REDACT_IMAGE_PIXELS` a new image of format PNG is created, which the page will use in place of the original one. The original image is not deleted or replaced as part of this process, so other pages may still show the original. In addition, the new, modified PNG image currently is **stored uncompressed**. Do keep these aspects in mind when choosing the right garbage collection method and compression options during save. * **Text removal** is done by character: A character is removed if its bbox has a **non-empty overlap** with a redaction rectangle (changed in MuPDF v1.17). Depending on the font properties and / or the chosen line height, deletion may occur for undesired text parts. Using :meth:`Tools.set_small_glyph_heights` with a ``True`` argument before text search may help to prevent this. * Redactions are a simple way to replace single words in a PDF, or to just physically remove them. Locate the word "secret" using some text extraction or search method and insert a redaction using "xxxxxx" as replacement text for each occurrence. - Be wary if the replacement is longer than the original -- this may lead to an awkward appearance, line breaks or no new text at all. - For a number of reasons, the new text may not exactly be positioned on the same line like the old one -- especially true if the replacement font was not one of CJK or :ref:`Base-14-Fonts`. |history_begin| * New in v1.16.11 * Changed in v1.16.12: The previous *mark* parameter is gone. Instead, the respective rectangles are filled with the individual *fill* color of each redaction annotation. If a *text* was given in the annotation, then :meth:`insert_textbox` is invoked to insert it, using parameters provided with the redaction. * Changed in v1.18.0: added option for handling images that overlap redaction areas. * Changed in v1.23.27: added option for removing graphics as well. * Changed in v1.24.2: added option `keep_text` to leave text untouched. |history_end| --------- .. method:: add_polyline_annot(points) .. method:: add_polygon_annot(points) PDF only: Add an annotation consisting of lines which connect the given points. A **Polygon's** first and last points are automatically connected, which does not happen for a **PolyLine**. The **rectangle** is automatically created as the smallest rectangle containing the points, each one surrounded by a circle of radius 3 (= 3 * line width). The following shows a 'PolyLine' that has been modified with colors and line ends. :arg list points: a list of :data:`point_like` objects. :rtype: :ref:`Annot` :returns: the created annotation. It is drawn with line color black, line width 1 no fill color but fill color support. Use methods of :ref:`Annot` to make any changes to achieve something like this: .. image:: images/img-polyline.* :scale: 70 .. method:: add_underline_annot(quads=None, start=None, stop=None, clip=None) .. method:: add_strikeout_annot(quads=None, start=None, stop=None, clip=None) .. method:: add_squiggly_annot(quads=None, start=None, stop=None, clip=None) .. method:: add_highlight_annot(quads=None, start=None, stop=None, clip=None) PDF only: These annotations are normally used for **marking text** which has previously been somehow located (for example via :meth:`Page.search_for`). But this is not required: you are free to "mark" just anything. Standard (stroke only -- no fill color support) colors are chosen per annotation type: **yellow** for highlighting, **red** for striking out, **green** for underlining, and **magenta** for wavy underlining. All these four methods convert the arguments into a list of :ref:`Quad` objects. The **annotation** rectangle is then calculated to envelop all these quadrilaterals. .. note:: :meth:`search_for` delivers a list of either :ref:`Rect` or :ref:`Quad` objects. Such a list can be directly used as an argument for these annotation types and will deliver **one common annotation** for all occurrences of the search string:: >>> # prefer quads=True in text searching for annotations! >>> quads = page.search_for("pymupdf", quads=True) >>> page.add_highlight_annot(quads) .. note:: Obviously, text marker annotations need to know what is the top, the bottom, the left, and the right side of the area(s) to be marked. If the arguments are quads, this information is given by the sequence of the quad points. In contrast, a rectangle delivers much less information -- this is illustrated by the fact, that 4! = 24 different quads can be constructed with the four corners of a rectangle. Therefore, we **strongly recommend** to use the `quads` option for text searches, to ensure correct annotations. A similar consideration applies to marking **text spans** extracted with the "dict" / "rawdict" options of :meth:`Page.get_text`. For more details on how to compute quadrilaterals in this case, see section "How to Mark Non-horizontal Text" of :ref:`FAQ`. :arg rect_like,quad_like,list,tuple quads: the location(s) -- rectangle(s) or quad(s) -- to be marked. (Changed in v1.14.20) A list or tuple must consist of :data:`rect_like` or :data:`quad_like` items (or even a mixture of either). Every item must be finite, convex and not empty (as applicable). **Set this parameter to** ``None`` if you want to use the following arguments (Changed in v1.16.14). And vice versa: if not ``None``, the remaining parameters must be ``None``. :arg point_like start: start text marking at this point. Defaults to the top-left point of *clip*. Must be provided if `quads` is ``None``. (New in v1.16.14) :arg point_like stop: stop text marking at this point. Defaults to the bottom-right point of *clip*. Must be used if `quads` is ``None``. (New in v1.16.14) :arg rect_like clip: only consider text lines intersecting this area. Defaults to the page rectangle. Only use if `start` and `stop` are provided. (New in v1.16.14) :rtype: :ref:`Annot` or ``None`` (changed in v1.16.14). :returns: the created annotation. If *quads* is an empty list, **no annotation** is created (changed in v1.16.14). .. note:: You can use parameters *start*, *stop* and *clip* to highlight consecutive lines between the points *start* and *stop* (starting with v1.16.14). Make use of *clip* to further reduce the selected line bboxes and thus deal with e.g. multi-column pages. The following multi-line highlight on a page with three text columns was created by specifying the two red points and setting clip accordingly. .. image:: images/img-markers.* :scale: 100 .. method:: cluster_drawings(clip=None, drawings=None, x_tolerance=3, y_tolerance=3, final_filter=True) Cluster vector graphics (synonyms are line-art or drawings) based on their geometrical vicinity. The method walks through the output of :meth:`Page.get_drawings` and joins paths whose `path["rect"]` are closer to each other than some tolerance values (given in the arguments). The result is a list of rectangles that each wrap things like tables (with gridlines), pie charts, bar charts, etc. :arg rect_like clip: only consider paths inside this area. The default is the full page. :arg list drawings: (optional) provide a previously generated output of :meth:`Page.get_drawings`. If `None` the method will execute the method. :arg float x_tolerance / y_tolerance: Assume vector graphics to be close enough neighbors for belonging to the same rectangle. Default is 3 points. :arg bool final_filter: If `True` (default), the method will to remove rectangles having width or height smaller than the respective tolerance value. If `False` no such filtering is done. .. method:: find_tables(clip=None, strategy=None, vertical_strategy=None, horizontal_strategy=None, vertical_lines=None, horizontal_lines=None, snap_tolerance=None, snap_x_tolerance=None, snap_y_tolerance=None, join_tolerance=None, join_x_tolerance=None, join_y_tolerance=None, edge_min_length=3, min_words_vertical=3, min_words_horizontal=1, intersection_tolerance=None, intersection_x_tolerance=None, intersection_y_tolerance=None, text_tolerance=None, text_x_tolerance=None, text_y_tolerance=None, add_lines=None, add_boxes=None, paths=None) Find tables on the page and return an object with related information. Typically, the default values of the many parameters will be sufficient. Adjustments should ever only be needed in corner case situations. :arg rect_like clip: specify a region to consider within the page rectangle and ignore the rest. Default is the full page. :arg str strategy: Request a **table detection** strategy. Valid values are "lines", "lines_strict" and "text". Default is **"lines"** which uses all vector graphics on the page to detect grid lines. Strategy **"lines_strict"** ignores borderless rectangle vector graphics. Sometimes single text pieces have background colors which may lead to false columns or lines. This strategy ignores them and can thus increase detection precision. If **"text"** is specified, text positions are used to generate "virtual" column and / or row boundaries. Use `min_words_*` to request the number of words for considering their coordinates. Use parameters `vertical_strategy` and `horizontal_strategy` **instead** for a more fine-grained treatment of the dimensions. :arg sequence[floats] horizontal_lines: y-coordinates of rows. If provided, there will be no attempt to identify additional table rows. This influences table detection. :arg sequence[floats] vertical_lines: x-coordinates of columns. If provided, there will be no attempt to identify additional table columns. This influences table detection. :arg int min_words_vertical: relevant for vertical strategy option "text": at least this many words must coincide to establish a **virtual column** boundary. :arg int min_words_horizontal: relevant for horizontal strategy option "text": at least this many words must coincide to establish a **virtual row** boundary. :arg float snap_tolerance: Any two horizontal lines whose y-values differ by no more than this value will be **snapped** into one. Accordingly for vertical lines. Default is 3. Separate values can be specified instead for the dimensions, using `snap_x_tolerance` and `snap_y_tolerance`. :arg float join_tolerance: Any two lines will be **joined** to one if the end and the start points differ by no more than this value (in points). Default is 3. Instead of this value, separate values can be specified for the dimensions using `join_x_tolerance` and `join_y_tolerance`. :arg float edge_min_length: Ignore a line if its length does not exceed this value (points). Default is 3. :arg float intersection_tolerance: When combining lines into cell borders, orthogonal lines must be within this value (points) to be considered intersecting. Default is 3. Instead of this value, separate values can be specified for the dimensions using `intersection_x_tolerance` and `intersection_y_tolerance`. :arg float text_tolerance: Characters will be combined into words only if their distance is no larger than this value (points). Default is 3. Instead of this value, separate values can be specified for the dimensions using `text_x_tolerance` and `text_y_tolerance`. :arg tuple,list add_lines: Specify a list of "lines" (i.e. pairs of :data:`point_like` objects) as **additional**, "virtual" vector graphics. These lines may help with table and / or cell detection and will not otherwise influence the detection strategy. Especially, in contrast to parameters `horizontal_lines` and `vertical_lines`, they will not prevent detecting rows or columns in other ways. These lines will be treated exactly like "real" vector graphics in terms of joining, snapping, intersecting, minimum length and containment in the `clip` rectangle. Similarly, lines not parallel to any of the coordinate axes will be ignored. :arg tuple,list add_boxes: Specify a list of rectangles (:data:`rect_like` objects) as **additional**, "virtual" vector graphics. These rectangles may help with table and / or cell detection and will not otherwise influence the detection strategy. Especially, in contrast to parameters `horizontal_lines` and `vertical_lines`, they will not prevent detecting rows or columns in other ways. These rectangles will be treated exactly like "real" vector graphics in terms of joining, snapping, intersecting, minimum length and containment in the `clip` rectangle. :arg list paths: list of vector graphics in the format as returned be :meth:`Page.get_drawings`. Using this parameter will prevent the method to extract vector graphics itself. This is useful if the vector graphics are already available. This can save execution time significantly. .. image:: images/img-findtables.* :returns: a `TableFinder` object that has the following significant attributes: * `cells`: a list of **all bboxes** on the page, that have been identified as table cells (across all tables). Each cell is a :data:`rect_like` tuple `(x0, y0, x1, y1)` of coordinates or `None`. * `tables`: a list of `Table` objects. This is `[]` if the page has no tables. Single tables can be found as items of this list. But the `TableFinder` object itself is also a sequence of its tables. This means that if `tabs` is a `TableFinder` object, then table "n" is delivered by `tabs.tables[n]` as well as by the shorter `tabs[n]`. * The `Table` object has the following attributes: * ``bbox``: the bounding box of the table as a tuple `(x0, y0, x1, y1)`. * ``cells``: bounding boxes of the table's cells (list of tuples). A cell may also be `None`. * ``extract()``: this method returns the text content of each table cell as a list of list of strings. * ``to_markdown()``: this method returns the table as a **string in markdown format** (compatible to Github). Markdown viewers can render the string as a table. This output is optimized for **small token** sizes, which is especially beneficial for LLM/RAG feeds. Pandas DataFrames (see method `to_pandas()` below) offer an equivalent markdown table output which however is better readable for the human eye. Any line breaks (``\n``) in cells are replaced by HTML line breaks tags `
`. * `to_pandas()`: this method returns the table as a `pandas `_ `DataFrame `_. DataFrames are very versatile objects allowing a plethora of table manipulation methods and outputs to almost 20 well-known formats, among them Excel files, CSV, JSON, markdown-formatted tables and more. `DataFrame.to_markdown()` generates a Github-compatible markdown format optimized for human readability. This method however requires the package `tabulate `_ to be installed in addition to pandas itself. * ``header``: a `TableHeader` object containing header information of the table. * ``col_count``: an integer containing the number of table columns. * ``row_count``: an integer containing the number of table rows. * ``rows``: a list of `TableRow` objects containing two attributes, ``bbox`` is the boundary box of the row, and `cells` is a list of table cells contained in this row. * The `TableHeader` object has the following attributes: * ``bbox``: the bounding box of the header. * `cells`: a list of bounding boxes containing the name of the respective column. * `names`: a list of strings containing the text of each of the cell bboxes. They represent the column names -- which are used when exporting the table to pandas DataFrames, markdown, etc. * `external`: a bool indicating whether the header bbox is outside the table body (`True`) or not. Table headers are never identified by the `TableFinder` logic. Therefore, if `external` is true, then the header cells are not part of any cell identified by `TableFinder`. If `external == False`, then the first table row is the header. Please have a look at these `Jupyter notebooks `_, which cover standard situations like multiple tables on one page or joining table fragments across multiple pages. .. caution:: The lifetime of the `TableFinder` object, as well as that of all its tables **equals the lifetime of the page**. If the page object is deleted or reassigned, all tables are no longer valid. The only way to keep table content beyond the page's availability is to **extract it** via methods `Table.to_markdown()`, `Table.to_pandas()` or a copy of `Table.extract()` (e.g. `Table.extract()[:]`). .. note:: Once a table has been extracted to a **Pandas DataFrame** with `to_pandas()` it is easy to convert to other file types with the **Pandas API**: - table to Markdown, use `to_markdown `_ - table to JSON, use: `to_json `_ - table to Excel, use: `to_excel `_ - table to CSV, use: `to_csv `_ - table to HTML, use: `to_html `_ - table to SQL, use: `to_sql `_ |history_begin| * New in version 1.23.0 * Changed in version 1.23.19: new argument `add_lines`. |history_end| .. important:: There is also the `pdf2docx extract tables method`_ which is capable of table extraction if you prefer. .. method:: add_stamp_annot(rect, stamp=0) PDF only: Add a "rubber stamp" annotation to e.g. indicate the document's intended use ("DRAFT", "CONFIDENTIAL", etc.). The parameter may be either an integer to select text from a predefined array of standard texts or an image. :arg rect_like rect: rectangle where to place the annotation. :arg multiple stamp: The following options are available: * The id number (int) of the stamp text. For available stamps see :ref:`StampIcons`. * A string specifying an image file path. * A ``bytes``, ``bytearray`` or ``io.BytesIO`` object for an image in memory. * A :ref:`Pixmap`. 1. **Text-based stamps** * :attr:`Annot.rect` is automatically calculated as the largest rectangle with an aspect ratio of ``width:height = 3.8`` that fits in the provided ``rect``. Its position is vertically and horizontally centered. * The font chosen is "Times Bold" and the text will be upper case. * The appearance can be modified using :meth:`Annot.set_opacity` and by setting the "stroke" color. By PDF specification, stamp annotations have no "fill" color. .. image:: images/img-stampannot.* 2. **Image-based stamps** * The image is scaled to fit into the rectangle `rect` such that the image's center and the center of `rect` coincide. The aspect ratio of the image is preserved, so the image may not fill the entire rectangle. However, at least one of the given rectangle's width or height are fully covered. * The annotation can be modified via :meth:`Annot.set_opacity`. This method therefore is a way to display images transparently even if no alpha channel is present. * Setting colors has no effect on image stamps. * Rotating image-based stamps **is not supported**. Setting the rotation may lead to unexpected results. .. method:: add_widget(widget) PDF only: Add a PDF Form field ("widget") to a page. This also **turns the PDF into a Form PDF**. Because of the large amount of different options available for widgets, we have developed a new class :ref:`Widget`, which contains the possible PDF field attributes. It must be used for both, form field creation and updates. :arg widget: a :ref:`Widget` object which must have been created upfront. :type widget: :ref:`Widget` :returns: a widget annotation. .. method:: delete_annot(annot) * The removal will now include any bound 'Popup' or response annotations and related objects (changed in v1.16.6). PDF only: Delete annotation from the page and return the next one. :arg annot: the annotation to be deleted. :type annot: :ref:`Annot` :rtype: :ref:`Annot` :returns: the annotation following the deleted one. Please remember that physical removal requires saving to a new file with garbage > 0. .. method:: delete_widget(widget) PDF only: Delete field from the page and return the next one. :arg widget: the widget to be deleted. :type widget: :ref:`Widget` :rtype: :ref:`Widget` :returns: the widget following the deleted one. Please remember that physical removal requires saving to a new file with garbage > 0. |history_begin| (New in v1.18.4) |history_end| .. method:: delete_link(linkdict) PDF only: Delete the specified link from the page. The parameter must be an **original item** of :meth:`get_links()`, see :ref:`link_dict_description`. The reason for this is the dictionary's *"xref"* key, which identifies the PDF object to be deleted. :arg dict linkdict: the link to be deleted. .. method:: insert_link(linkdict) PDF only: Insert a new link on this page. The parameter must be a dictionary of format as provided by :meth:`get_links()`, see :ref:`link_dict_description`. :arg dict linkdict: the link to be inserted. .. method:: update_link(linkdict) PDF only: Modify the specified link. The parameter must be a (modified) **original item** of :meth:`get_links()`, see :ref:`link_dict_description`. The reason for this is the dictionary's *"xref"* key, which identifies the PDF object to be changed. :arg dict linkdict: the link to be modified. .. warning:: If updating / inserting a URI link (`"kind": LINK_URI`), please make sure to start the value for the `"uri"` key with a disambiguating string like `"http://"`, `"https://"`, `"file://"`, `"ftp://"`, `"mailto:"`, etc. Otherwise -- depending on your browser or other "consumer" software -- unexpected default assumptions may lead to unwanted behaviours. .. method:: get_label() PDF only: Return the label for the page. :rtype: str :returns: the label string like "vii" for Roman numbering or "" if not defined. |history_begin| * New in v1.18.6 |history_end| .. method:: get_links() Retrieves **all** links of a page. :rtype: list :returns: A list of dictionaries. For a description of the dictionary entries, see :ref:`link_dict_description`. Always use this or the :meth:`Page.links` method if you intend to make changes to the links of a page. .. method:: links(kinds=None) Return a generator over the page's links. The results equal the entries of :meth:`Page.get_links`. :arg sequence kinds: a sequence of integers to down-select to one or more link kinds. Default is all links. Example: *kinds=(pymupdf.LINK_GOTO,)* will only return internal links. :rtype: generator :returns: an entry of :meth:`Page.get_links()` for each iteration. |history_begin| * New in v1.16.4 |history_end| .. method:: annots(types=None) Return a generator over the page's annotations. :arg sequence types: a sequence of integers to down-select to one or more annotation types. Default is all annotations. Example: `types=(pymupdf.PDF_ANNOT_FREETEXT, pymupdf.PDF_ANNOT_TEXT)` will only return 'FreeText' and 'Text' annotations. :rtype: generator :returns: an :ref:`Annot` for each iteration. .. caution:: You **cannot safely update annotations** from within this generator. This is because most annotation updates require reloading the page via `page = doc.reload_page(page)`. To circumvent this restriction, make a list of annotations xref numbers first and then iterate over these numbers:: In [4]: xrefs = [annot.xref for annot in page.annots(types=[...])] In [5]: for xref in xrefs: ...: annot = page.load_annot(xref) ...: annot.update() ...: page = doc.reload_page(page) In [6]: |history_begin| * New in v1.16.4 |history_end| .. method:: widgets(types=None) Return a generator over the page's form fields. :arg sequence types: a sequence of integers to down-select to one or more widget types. Default is all form fields. Example: `types=(pymupdf.PDF_WIDGET_TYPE_TEXT,)` will only return 'Text' fields. :rtype: generator :returns: a :ref:`Widget` for each iteration. |history_begin| * New in v1.16.4 |history_end| .. method:: write_text(rect=None, writers=None, overlay=True, color=None, opacity=None, keep_proportion=True, rotate=0, oc=0) PDF only: Write the text of one or more :ref:`Textwriter` objects to the page. :arg rect_like rect: where to place the text. If omitted, the rectangle union of the text writers is used. :arg sequence writers: a non-empty tuple / list of :ref:`TextWriter` objects or a single :ref:`TextWriter`. :arg float opacity: set transparency, overwrites resp. value in the text writers. :arg sequ color: set the text color, overwrites resp. value in the text writers. :arg bool overlay: put the text in foreground or background. :arg bool keep_proportion: maintain the aspect ratio. :arg float rotate: rotate the text by an arbitrary angle. :arg int oc: the :data:`xref` of an :data:`OCG` or :data:`OCMD`. (New in v1.18.4) .. note:: Parameters *overlay, keep_proportion, rotate* and *oc* have the same meaning as in :meth:`Page.show_pdf_page`. |history_begin| * New in v1.16.18 |history_end| .. index:: pair: border_width; insert_text pair: color; insert_text pair: encoding; insert_text pair: fill; insert_text pair: fontfile; insert_text pair: fontname; insert_text pair: fontsize; insert_text pair: morph; insert_text pair: overlay; insert_text pair: render_mode; insert_text pair: miter_limit; insert_text pair: rotate; insert_text pair: stroke_opacity; insert_text pair: fill_opacity; insert_text pair: oc; insert_text .. method:: insert_text(point, text, *, fontsize=11, fontname="helv", fontfile=None, idx=0, color=None, fill=None, render_mode=0, miter_limit=1, border_width=0.05, encoding=TEXT_ENCODING_LATIN, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, overlay=True, oc=0) PDF only: Insert text lines starting at :data:`point_like` ``point``. See :meth:`Shape.insert_text`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: align; insert_textbox pair: border_width; insert_textbox pair: color; insert_textbox pair: encoding; insert_textbox pair: expandtabs; insert_textbox pair: fill; insert_textbox pair: fontfile; insert_textbox pair: fontname; insert_textbox pair: fontsize; insert_textbox pair: morph; insert_textbox pair: overlay; insert_textbox pair: render_mode; insert_textbox pair: miter_limit; insert_textbox pair: rotate; insert_textbox pair: stroke_opacity; insert_textbox pair: fill_opacity; insert_textbox pair: oc; insert_textbox .. method:: insert_textbox(rect, buffer, \ *, \ align=TEXT_ALIGN_LEFT, \ border_width=1, \ color=None, \ encoding=TEXT_ENCODING_LATIN, \ expandtabs=8, \ fill=None, \ fill_opacity=1, \ fontfile=None, \ fontname="helv", \ fontsize=11, \ lineheight=None, \ miter_limit=1, \ morph=None, \ oc=0, \ overlay=True, \ render_mode=0, \ rotate=0, \ set_simple=False, \ stroke_opacity=1, \ ) PDF only: Insert text into the specified :data:`rect_like` *rect*. :arg overlay: see :meth:`Shape.commit`. For other args, see `Shape.insert_textbox`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: rect; insert_htmlbox pair: text; insert_htmlbox pair: css; insert_htmlbox pair: adjust; insert_htmlbox pair: archive; insert_htmlbox pair: overlay; insert_htmlbox pair: rotate; insert_htmlbox pair: oc; insert_htmlbox pair: opacity; insert_htmlbox pair: morph; insert_htmlbox .. method:: insert_htmlbox(rect, text, *, css=None, scale_low=0, archive=None, rotate=0, oc=0, opacity=1, overlay=True) **PDF only:** Insert text into the specified rectangle. The method has similarities with methods :meth:`Page.insert_textbox` and :meth:`TextWriter.fill_textbox`, but is **much more powerful**. This is achieved by letting a :ref:`Story` object do all the required processing. * Parameter ``text`` may be a string as in the other methods. But it will be **interpreted as HTML source** and may therefore also contain HTML language elements -- including styling. The `css` parameter may be used to pass in additional styling instructions. * Automatic line breaks are generated at word boundaries. The "soft hyphen" character `"­"` (or `­`) can be used to cause hyphenation and thus may also cause line breaks. **Forced** line breaks however are only achievable via the HTML tag ``
`` - ``\n`` is ignored and will be treated like a space. * With this method the following can be achieved: - Styling effects like bold, italic, text color, text alignment, font size or font switching. - The text may include arbitrary languages -- **including right-to-left** languages. - Scripts like `Devanagari `_ and several others in Asia have a highly complex system of ligatures, where two or more unicodes together yield one glyph. The Story uses the software package `HarfBuzz `_ , to deal with these things and produce correct output. - One can also **include images** via HTML tag `` -- the Story will take care of the appropriate layout. This is an alternative option to insert images, compared to :meth:`Page.insert_image`. - HTML tables (tag `
`) may be included in the text and will be handled appropriately. - Links are automatically generated when present. * If content does not fit in the rectangle, the developer has two choices: - **either** only be informed about this (and accept a no-op, just like with the other textbox insertion methods), - **or** (`scale_low=0` - the default) scale down the content until it fits. :arg rect_like rect: rectangle on page to receive the text. :arg str,Story text: the text to be written. Can contain a mixture of plain text and HTML tags with styling instructions. Alternatively, a :ref:`Story` object may be specified (in which case the internal Story generation step will be omitted). A Story must have been generated with all required styling and Archive information. :arg str css: optional string containing additional CSS instructions. This parameter is ignored if ``text`` is a Story. :arg float scale_low: if necessary, scale down the content until it fits in the target rectangle. This sets the down scaling limit. Default is 0, no limit. A value of 1 means no down-scaling permitted. A value of e.g. 0.2 means maximum down-scaling by 80%. :arg Archive archive: an Archive object that points to locations where to find images or non-standard fonts. If ``text`` refers to images or non-standard fonts, this parameter is required. This parameter is ignored if ``text`` is a Story. :arg int rotate: one of the values 0, 90, 180, 270. Depending on this, text will be filled: - 0: top-left to bottom-right. - 90: bottom-left to top-right. - 180: bottom-right to top-left. - 270: top-right to bottom-left. .. image:: images/img-rotate.* :arg int oc: the xref of an :data:`OCG` / :data:`OCMD` or 0. Please refer to :meth:`Page.show_pdf_page` for details. :arg float opacity: set the fill and stroke opacity of the content. Only values `0 <= opacity < 1` are considered. :arg bool overlay: put the text in front of other content. Please refer to :meth:`Page.show_pdf_page` for details. :returns: A tuple of floats `(spare_height, scale)`. - spare_height: The (positive) height of the remaining space in `rect` below the text, or -1 if we failed to fit. - scale: The scaling required; `0 < scale <= 1`. Will be `scale_low` if we failed to fit. Please refer to examples in this section of the recipes: :ref:`RecipesText_I_c`. |history_begin| * New in v1.26.5: * do additional scaling to fit long words. * If we succeeded and scaled down, the returned `spare_height` is now generally positive instead of being fixed to zero, because the final rect's height is usually not an exact multiple of the font line height. * New in v1.23.8: rebased-only. * New in v1.23.9: `opacity` parameter. |history_end| **Drawing Methods** .. index:: pair: closePath; draw_line pair: color; draw_line pair: dashes; draw_line pair: fill; draw_line pair: lineCap; draw_line pair: lineJoin; draw_line pair: lineJoin; draw_line pair: morph; draw_line pair: overlay; draw_line pair: width; draw_line pair: stroke_opacity; draw_line pair: fill_opacity; draw_line pair: oc; draw_line .. method:: draw_line(p1, p2, color=(0,), width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_line`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: breadth; draw_zigzag pair: closePath; draw_zigzag pair: color; draw_zigzag pair: dashes; draw_zigzag pair: fill; draw_zigzag pair: lineCap; draw_zigzag pair: lineJoin; draw_zigzag pair: morph; draw_zigzag pair: overlay; draw_zigzag pair: width; draw_zigzag pair: stroke_opacity; draw_zigzag pair: fill_opacity; draw_zigzag pair: oc; draw_zigzag .. method:: draw_zigzag(p1, p2, breadth=2, color=(0,), width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a zigzag line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_zigzag`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: breadth; draw_squiggle pair: closePath; draw_squiggle pair: color; draw_squiggle pair: dashes; draw_squiggle pair: fill; draw_squiggle pair: lineCap; draw_squiggle pair: lineJoin; draw_squiggle pair: morph; draw_squiggle pair: overlay; draw_squiggle pair: width; draw_squiggle pair: stroke_opacity; draw_squiggle pair: fill_opacity; draw_squiggle pair: oc; draw_squiggle .. method:: draw_squiggle(p1, p2, breadth=2, color=(0,), width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a squiggly (wavy, undulated) line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_squiggle`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_circle pair: color; draw_circle pair: dashes; draw_circle pair: fill; draw_circle pair: lineCap; draw_circle pair: lineJoin; draw_circle pair: morph; draw_circle pair: overlay; draw_circle pair: width; draw_circle pair: stroke_opacity; draw_circle pair: fill_opacity; draw_circle pair: oc; draw_circle .. method:: draw_circle(center, radius, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a circle around *center* (:data:`point_like`) with a radius of *radius*. See :meth:`Shape.draw_circle`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_oval pair: color; draw_oval pair: dashes; draw_oval pair: fill; draw_oval pair: lineCap; draw_oval pair: lineJoin; draw_oval pair: morph; draw_oval pair: overlay; draw_oval pair: width; draw_oval pair: stroke_opacity; draw_oval pair: fill_opacity; draw_oval pair: oc; draw_oval .. method:: draw_oval(quad, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw an oval (ellipse) within the given :data:`rect_like` or :data:`quad_like`. See :meth:`Shape.draw_oval`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_sector pair: color; draw_sector pair: dashes; draw_sector pair: fill; draw_sector pair: fullSector; draw_sector pair: lineCap; draw_sector pair: lineJoin; draw_sector pair: morph; draw_sector pair: overlay; draw_sector pair: width; draw_sector pair: stroke_opacity; draw_sector pair: fill_opacity; draw_sector pair: oc; draw_sector .. method:: draw_sector(center, point, angle, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, fullSector=True, overlay=True, closePath=False, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a circular sector, optionally connecting the arc to the circle's center (like a piece of pie). See :meth:`Shape.draw_sector`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_polyline pair: color; draw_polyline pair: dashes; draw_polyline pair: fill; draw_polyline pair: lineCap; draw_polyline pair: lineJoin; draw_polyline pair: morph; draw_polyline pair: overlay; draw_polyline pair: width; draw_polyline pair: stroke_opacity; draw_polyline pair: fill_opacity; draw_polyline pair: oc; draw_polyline .. method:: draw_polyline(points, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, closePath=False, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw several connected lines defined by a sequence of :data:`point_like` \s. See :meth:`Shape.draw_polyline`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_bezier pair: color; draw_bezier pair: dashes; draw_bezier pair: fill; draw_bezier pair: lineCap; draw_bezier pair: lineJoin; draw_bezier pair: morph; draw_bezier pair: overlay; draw_bezier pair: width; draw_bezier pair: stroke_opacity; draw_bezier pair: fill_opacity; draw_bezier pair: oc; draw_bezier .. method:: draw_bezier(p1, p2, p3, p4, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, closePath=False, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a cubic Bézier curve from *p1* to *p4* with the control points *p2* and *p3* (all are :data:`point_like` \s). See :meth:`Shape.draw_bezier`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_curve pair: color; draw_curve pair: dashes; draw_curve pair: fill; draw_curve pair: lineCap; draw_curve pair: lineJoin; draw_curve pair: morph; draw_curve pair: overlay; draw_curve pair: width; draw_curve pair: stroke_opacity; draw_curve pair: fill_opacity; draw_curve pair: oc; draw_curve .. method:: draw_curve(p1, p2, p3, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, closePath=False, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: This is a special case of *draw_bezier()*. See :meth:`Shape.draw_curve`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: closePath; draw_rect pair: color; draw_rect pair: dashes; draw_rect pair: fill; draw_rect pair: lineCap; draw_rect pair: lineJoin; draw_rect pair: morph; draw_rect pair: overlay; draw_rect pair: width; draw_rect pair: stroke_opacity; draw_rect pair: fill_opacity; draw_rect pair: radius; draw_rect pair: oc; draw_rect .. method:: draw_rect(rect, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, radius=None, oc=0) PDF only: Draw a rectangle. See :meth:`Shape.draw_rect`. |history_begin| * Changed in v1.18.4 * Changed in v1.22.0: Added parameter *radius*. |history_end| .. index:: pair: closePath; draw_quad pair: color; draw_quad pair: dashes; draw_quad pair: fill; draw_quad pair: lineCap; draw_quad pair: lineJoin; draw_quad pair: morph; draw_quad pair: overlay; draw_quad pair: width; draw_quad pair: stroke_opacity; draw_quad pair: fill_opacity; draw_quad pair: oc; draw_quad .. method:: draw_quad(quad, color=(0,), fill=None, width=1, dashes=None, lineCap=0, lineJoin=0, overlay=True, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) PDF only: Draw a quadrilateral. See :meth:`Shape.draw_quad`. |history_begin| * Changed in v1.18.4 |history_end| .. index:: pair: encoding; insert_font pair: fontbuffer; insert_font pair: fontfile; insert_font pair: fontname; insert_font pair: set_simple; insert_font .. method:: insert_font(fontname="helv", fontfile=None, fontbuffer=None, set_simple=False, encoding=TEXT_ENCODING_LATIN) PDF only: Add a new font to be used by text output methods and return its :data:`xref`. If not already present in the file, the font definition will be added. Supported are the built-in :data:`Base14_Fonts` and the CJK fonts via **"reserved"** fontnames. Fonts can also be provided as a file path or a memory area containing the image of a font file. :arg str fontname: The name by which this font shall be referenced when outputting text on this page. In general, you have a "free" choice here (but consult the :ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of building legal PDF names). However, if it matches one of the :data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer* **are ignored**. In other words, you cannot insert a font via *fontfile* / *fontbuffer* and also give it a reserved *fontname*. .. note:: A reserved fontname can be specified in any mixture of upper or lower case and still match the right built-in font definition: fontnames "helv", "Helv", "HELV", "Helvetica", etc. all lead to the same font definition "Helvetica". But from a :ref:`Page` perspective, these are **different references**. You can exploit this fact when using different *encoding* variants (Latin, Greek, Cyrillic) of the same font on a page. :arg str fontfile: a path to a font file. If used, *fontname* must be **different from all reserved names**. :arg bytes/bytearray fontbuffer: the memory image of a font file. If used, *fontname* must be **different from all reserved names**. This parameter would typically be used with :attr:`Font.buffer` for fonts supported / available via :ref:`Font`. :arg int set_simple: applicable for *fontfile* / *fontbuffer* cases only: enforce treatment as a "simple" font, i.e. one that only uses character codes up to 255. :arg int encoding: applicable for the "Helvetica", "Courier" and "Times" sets of :data:`Base14_Fonts` only. Select one of the available encodings Latin (0), Cyrillic (2) or Greek (1). Only use the default (0 = Latin) for "Symbol" and "ZapfDingBats". :rytpe: int :returns: the :data:`xref` of the installed font. .. note:: Built-in fonts will not lead to the inclusion of a font file. So the resulting PDF file will remain small. However, your PDF viewer software is responsible for generating an appropriate appearance -- and there **exist** differences on whether or how each one of them does this. This is especially true for the CJK fonts. But also Symbol and ZapfDingbats are incorrectly handled in some cases. Following are the **Font Names** and their correspondingly installed **Base Font** names: **Base-14 Fonts** [#f1]_ ============= ============================ ========================================= **Font Name** **Installed Base Font** **Comments** ============= ============================ ========================================= helv Helvetica normal heit Helvetica-Oblique italic hebo Helvetica-Bold bold hebi Helvetica-BoldOblique bold-italic cour Courier normal coit Courier-Oblique italic cobo Courier-Bold bold cobi Courier-BoldOblique bold-italic tiro Times-Roman normal tiit Times-Italic italic tibo Times-Bold bold tibi Times-BoldItalic bold-italic symb Symbol [#f3]_ zadb ZapfDingbats [#f3]_ ============= ============================ ========================================= **CJK Fonts** [#f2]_ (China, Japan, Korea) ============= ============================ ========================================= **Font Name** **Installed Base Font** **Comments** ============= ============================ ========================================= china-s Heiti simplified Chinese china-ss Song simplified Chinese (serif) china-t Fangti traditional Chinese china-ts Ming traditional Chinese (serif) japan Gothic Japanese japan-s Mincho Japanese (serif) korea Dotum Korean korea-s Batang Korean (serif) ============= ============================ ========================================= .. index:: pair: filename; insert_image pair: keep_proportion; insert_image pair: overlay; insert_image pair: pixmap; insert_image pair: rotate; insert_image pair: stream; insert_image pair: mask; insert_image pair: oc; insert_image pair: xref; insert_image .. method:: insert_image(rect, *, alpha=-1, filename=None, height=0, keep_proportion=True, mask=None, oc=0, overlay=True, pixmap=None, rotate=0, stream=None, width=0, xref=0) PDF only: Put an image inside the given rectangle. The image may already exist in the PDF or be taken from a pixmap, a file, or a memory area. :arg rect_like rect: where to put the image. Must be finite and not empty. :arg int alpha: deprecated and ignored. :arg str filename: name of an image file (all formats supported by MuPDF -- see :ref:`ImageFiles`). :arg int height: :arg bool keep_proportion: maintain the aspect ratio of the image. :arg bytes,bytearray,io.BytesIO mask: image in memory -- to be used as image mask (alpha values) for the base image. When specified, the base image must be provided as a filename or a stream -- and must not be an image that already has a mask. :arg int oc: (:data:`xref`) make image visibility dependent on this :data:`OCG` or :data:`OCMD`. Ignored after the first of multiple insertions. The property is stored with the generated PDF image object and therefore controls the image's visibility throughout the PDF. :arg overlay: see :ref:`CommonParms`. :arg pixmap: a pixmap containing the image. :arg int rotate: rotate the image. Must be an integer multiple of 90 degrees. Positive values rotate anti-clockwise. If you need a rotation by an arbitrary angle, consider converting the image to a PDF (:meth:`Document.convert_to_pdf`) first and then use :meth:`Page.show_pdf_page` instead. :arg bytes,bytearray,io.BytesIO stream: image in memory (all formats supported by MuPDF -- see :ref:`ImageFiles`). :arg int width: :arg int xref: the :data:`xref` of an image already present in the PDF. If given, parameters `filename`, `pixmap`, `stream`, `alpha` and `mask` are ignored. The page will simply receive a reference to the existing image. :type pixmap: :ref:`Pixmap` :returns: The `xref` of the embedded image. This can be used as the `xref` argument for very significant performance boosts, if the image is inserted again. This example puts the same image on every page of a document:: >>> doc = pymupdf.open(...) >>> rect = pymupdf.Rect(0, 0, 50, 50) # put thumbnail in upper left corner >>> img = open("some.jpg", "rb").read() # an image file >>> img_xref = 0 # first execution embeds the image >>> for page in doc: img_xref = page.insert_image(rect, stream=img, xref=img_xref, 2nd time reuses existing image ) >>> doc.save(...) .. note:: 1. The method detects multiple insertions of the same image (like in the above example) and will store its data only on the first execution. This is even true (although less performant), if using the default `xref=0`. 2. The method cannot detect if the same image had already been part of the file before opening it. 3. You can use this method to provide a background or foreground image for the page, like a copyright or a watermark. Please remember, that watermarks require a transparent image if put in foreground ... 4. The image may be inserted uncompressed, e.g. if a `Pixmap` is used or if the image has an alpha channel. Therefore, consider using `deflate=True` when saving the file. In addition, there are ways to control the image size -- even if transparency comes into play. Have a look at :ref:`RecipesImages_O`. 5. The image is stored in the PDF at its original quality level. This may be much better than what you need for your display. Consider **decreasing the image size** before insertion -- e.g. by using the pixmap option and then shrinking it or scaling it down (see :ref:`Pixmap` chapter). The PIL method `Image.thumbnail()` can also be used for that purpose. The file size savings can be very significant. 6. Another efficient way to display the same image on multiple pages is another method: :meth:`show_pdf_page`. Consult :meth:`Document.convert_to_pdf` for how to obtain intermediary PDFs usable for that method. |history_begin| * Changed in v1.14.1: By default, the image keeps its aspect ratio. * Changed in v1.14.11: Added args `keep_proportion`, `rotate`. * Changed in v1.14.13: * The image is now always placed **centered** in the rectangle, i.e. the centers of image and rectangle are equal. * Added support for `stream` as `io.BytesIO`. * Changed in v1.17.6: Insertion rectangle no longer needs to have a non-empty intersection with the page's :attr:`Page.cropbox` [#f5]_. * Changed in v1.18.1: Added `mask` arg. * Changed in v1.18.3: Added `oc` arg. * Changed in v1.18.13: * Allow providing the image as the xref of an existing one. * Added `xref` arg. * Return `xref` of stored image. * Changed in v1.19.3: deprecate and ignore `alpha` arg. |history_end| .. index:: pair: filename; replace_image pair: pixmap; replace_image pair: stream; replace_image pair: xref; replace_image .. method:: replace_image(xref, filename=None, pixmap=None, stream=None) Replace the image at xref with another one. :arg int xref: the :data:`xref` of the image. :arg filename: the filename of the new image. :arg pixmap: the :ref:`Pixmap` of the new image. :arg stream: the memory area containing the new image. Arguments `filename`, `pixmap`, `stream` have the same meaning as in :meth:`Page.insert_image`, especially exactly one of these must be provided. This is a **global replacement:** the new image will also be shown wherever the old one has been displayed throughout the file. This method mainly exists for technical purposes. Typical uses include replacing large images by smaller versions, like a lower resolution, graylevel instead of colored, etc., or changing transparency. |history_begin| * New in v1.21.0 |history_end| .. index:: pair: xref; delete_image .. method:: delete_image(xref) Delete the image at xref. This is slightly misleading: actually the image is being replaced with a small transparent :ref:`Pixmap` using above :meth:`Page.replace_image`. The visible effect however is equivalent. :arg int xref: the :data:`xref` of the image. This is a **global replacement:** the image will disappear wherever the old one has been displayed throughout the file. If you inspect / extract a page's images by methods like :meth:`Page.get_images`, :meth:`Page.get_image_info` or :meth:`Page.get_text`, the replacing "dummy" image will be detected like so `(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` and also seem to "cover" the same boundary box on the page. |history_begin| * New in v1.21.0 |history_end| .. index:: pair: blocks; Page.get_text pair: dict; Page.get_text pair: clip; Page.get_text pair: flags; Page.get_text pair: html; Page.get_text pair: json; Page.get_text pair: rawdict; Page.get_text pair: text; Page.get_text pair: words; Page.get_text pair: xhtml; Page.get_text pair: xml; Page.get_text pair: textpage; Page.get_text pair: sort; Page.get_text pair: delimiters; Page.get_text .. method:: get_text(option,*, clip=None, flags=None, textpage=None, sort=False, delimiters=None) Retrieves the content of a page in a variety of formats. Depending on the ``flags`` value, this may include text, images and several other object types. The method is a wrapper for multiple :ref:`TextPage` methods by choosing the output option `opt` as follows: * "text" -- :meth:`TextPage.extractTEXT`, default. Always includes **text only.** * "blocks" -- :meth:`TextPage.extractBLOCKS`. Includes text and **may** include image meta information. * "words" -- :meth:`TextPage.extractWORDS`. Always includes **text only.** * "html" -- :meth:`TextPage.extractHTML`. May include text and images. * "xhtml" -- :meth:`TextPage.extractXHTML`. May include text and images. * "xml" -- :meth:`TextPage.extractXML`. Always includes **text only.** * "dict" -- :meth:`TextPage.extractDICT`. May include text and images. * "json" -- :meth:`TextPage.extractJSON`. May include text and images. * "rawdict" -- :meth:`TextPage.extractRAWDICT`. May include text and images. * "rawjson" -- :meth:`TextPage.extractRAWJSON`. May include text and images. :arg str opt: A string indicating the requested format, one of the above. A mixture of upper and lower case is supported. If misspelled, option "text" is silently assumed. :arg rect-like clip: restrict the extraction to this rectangle. If ``None`` (default), the visible part of the page is taken. Any content (text, images) that is **not fully contained** in ``clip`` will be completely omitted. To avoid clipping altogether use ``clip=pymupdf.INFINITE_RECT()``. Only then the extraction will contain all items. This parameter has **no effect** on options "html", "xhtml" and "xml". :arg int flags: indicator bits to control whether to include images or how text should be handled with respect to white spaces and :data:`ligatures`. See :ref:`TextPreserve` for available indicators and :ref:`text_extraction_flags` for default settings. (New in v1.16.2) :arg textpage: use a previously created :ref:`TextPage`. This reduces execution time **very significantly:** by more than 50% and up to 95%, depending on the extraction option. If specified, the 'flags' and 'clip' arguments are ignored, because they are textpage-only properties. If omitted, a new, temporary textpage will be created. :arg bool sort: sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. Has no effect on (X)HTML and XML. For options "blocks", "dict", "json", "rawdict", "rawjson", sorting happens by coordinates `(y1, x0)` of the respective block bbox. For options "words" and "text", the text lines are completely re-synthesized to follow the reading sequence and appearance in the document -- which even establishes the original layout to some extent. :arg str delimiters: use these characters as *additional* word separators with the "words" output option (ignored otherwise). By default, all white spaces (including non-breaking space `0xA0`) indicate start and end of a word. Now you can specify more characters causing this. For instance, the default will return `"john.doe@outlook.com"` as **one** word. If you specify `delimiters="@."` then the **four** words `"john"`, `"doe"`, `"outlook"`, `"com"` will be returned. Other possible uses include ignoring punctuation characters `delimiters=string.punctuation`. The "word" strings will not contain any delimiting character. (New in v1.23.5) :rtype: *str, list, dict* :returns: The page's content as a string, a list or a dictionary. Refer to the corresponding :ref:`TextPage` method for details. .. note:: 1. You can use this method as a **document conversion tool** from :ref:`any supported document type` to one of TEXT, HTML, XHTML or XML documents. 2. The inclusion of text via the *clip* parameter is decided on a by-character level: a character becomes part of the output, if its bbox is contained in `clip`. This **deviates** from the algorithm used in redaction annotations: a character will be **removed if its bbox intersects** any redaction annotation. |history_begin| * Changed in v1.19.0: added `textpage` parameter * Changed in v1.19.1: added `sort` parameter * Changed in v1.19.6: added new constants for defining default flags per method. * Changed in v1.23.5: added `delimiters` parameter * Changed in v1.24.11: changed the effect of `sort_True` for "text" and "words" to closely follow natural reading sequence. |history_end| .. index:: pair: rect; get_textbox pair: textpage; get_textbox .. method:: get_textbox(rect, textpage=None) Retrieve the text contained in a rectangle. :arg rect-like rect: rect-like. :arg textpage: a :ref:`TextPage` to use. If omitted, a new, temporary textpage will be created. :returns: a string with interspersed linebreaks where necessary. It is based on dedicated code (changed in v1.19.0). A typical use is checking the result of :meth:`Page.search_for`: >>> rl = page.search_for("currency:") >>> page.get_textbox(rl[0]) 'Currency:' >>> |history_begin| * New in v1.17.7 * Changed in v1.19.0: add `textpage` parameter |history_end| .. index:: pair: flags; get_textpage pair: clip; get_textpage .. method:: get_textpage(clip=None, flags=3) Create a :ref:`TextPage` for the page. :arg int flags: indicator bits controlling the content available for subsequent text extractions and searches -- see the parameter of :meth:`Page.get_text`. :arg rect-like clip: restrict extracted text to this area. (New in v1.17.7) :returns: :ref:`TextPage` |history_begin| * New in v1.16.5 * Changed in v1.17.7: introduced `clip` parameter. |history_end| .. index:: pair: flags; get_textpage_ocr pair: language; get_textpage_ocr pair: dpi; get_textpage_ocr pair: full; get_textpage_ocr pair: tessdata; get_textpage_ocr .. method:: get_textpage_ocr(flags=3, language="eng", dpi=72, full=False, tessdata=None) **Optical Character Recognition** (**OCR**) technology can be used to extract text data for pages where text is in raster image or vector graphic format. Use this method to **OCR** a page for subsequent text extraction. This method returns a :ref:`TextPage` for the page that includes OCRed text. MuPDF will invoke Tesseract-OCR if this method is used. :arg int flags: indicator bits controlling the content available for subsequent test extractions and searches -- see the parameter of :meth:`Page.get_text`. :arg str language: the expected language(s). Use "+"-separated values if multiple languages are expected, "eng+spa" for English and Spanish. :arg int dpi: the desired resolution in dots per inch. Influences recognition quality (and execution time). :arg bool full: whether to OCR the full page, or only page areas that contain no legible text. :arg str tessdata: The name of Tesseract's language support folder `tessdata`. If omitted, the name is determined using function :meth:`get_tessdata`. .. note:: This method does **not** support a clip parameter -- OCR (full or partial) will always happen for the complete page rectangle. :returns: a :ref:`TextPage`. Execution may be significantly longer than :meth:`Page.get_textpage`. For ``full=True`` OCR, **all text** will have the font "GlyphLessFont" from Tesseract. In case of partial OCR (``full=False``), legible normal text will keep its properties, and only recognized text will have the GlyphLessFont. Recognized / OCR text will follow (legible) normal text for partial OCR and will thus not be in reading order. Establishing reading order is -- as always -- your responsibility. .. note:: Text extraction results, including any OCR, are stored in the returned :ref:`TextPage`. To access them, you must use the ``textpage`` parameter in all subsequent text extraction and search methods. `This Jupyter notebook `_ walks through an example for using OCR textpages. |history_begin| * New in v.1.19.0 * Changed in v1.19.1: support full and partial OCRing a page. * changed in v1.27.2: For partial OCR, **all** page areas outside legible text are now OCRed, not just those within images. This means that OCR will now also be performed for vector graphics, and for text containing illegible characters. |history_end| .. method:: get_drawings(extended=False) Return the vector graphics of the page. These are instructions which draw lines, rectangles, quadruples or curves, including properties like colors, transparency, line width and dashing, etc. Alternative terms are "line art" and "drawings". :returns: a list of dictionaries. Each dictionary item contains one or more single draw commands belonging together: they have the same properties (colors, dashing, etc.). This is called a **"path"** in PDF, so we adopted that name here, but the method **works for all document types**. The path dictionary for fill, stroke and fill-stroke paths has been designed to be compatible with class :ref:`Shape`. There are the following keys: ============== ============================================================================ Key Value ============== ============================================================================ closePath Same as the parameter in :ref:`Shape`. color Stroke color (see :ref:`Shape`). dashes Dashed line specification (see :ref:`Shape`). even_odd Fill colors of area overlaps -- same as the parameter in :ref:`Shape`. fill Fill color (see :ref:`Shape`). items List of draw commands: lines, rectangles, quads or curves. lineCap Number 3-tuple, use its max value on output with :ref:`Shape`. lineJoin Same as the parameter in :ref:`Shape`. fill_opacity fill color transparency (see :ref:`Shape`). (New in v1.18.17) stroke_opacity stroke color transparency (see :ref:`Shape`). (New in v1.18.17) rect Page area covered by this path. Information only. layer name of applicable Optional Content Group. (New in v1.22.0) level the hierarchy level if `extended=True`. (New in v1.22.0) seqno command number when building page appearance. (New in v1.19.0) type type of this path. (New in v1.18.17) width Stroke line width. (see :ref:`Shape`). ============== ============================================================================ Key `"opacity"` has been replaced by the new keys `"fill_opacity"` and `"stroke_opacity"`. This is now compatible with the corresponding parameters of :meth:`Shape.finish`. (Changed in v1.18.17) For paths other than groups or clips, key `"type"` takes one of the following values: * **"f"** -- this is a *fill-only* path. Only key-values relevant for this operation have a meaning, not applicable ones are present with a value of ``None``: `"color"`, `"lineCap"`, `"lineJoin"`, `"width"`, `"closePath"`, `"dashes"` and should be ignored. * **"s"** -- this is a *stroke-only* path. Similar to previous, key `"fill"` is present with value ``None``. * **"fs"** -- this is a path performing combined *fill* and *stroke* operations. Each item in `path["items"]` is one of the following: * `("l", p1, p2)` - a line from p1 to p2 (:ref:`Point` objects). * `("c", p1, p2, p3, p4)` - cubic Bézier curve **from p1 to p4** (p2 and p3 are the control points). All objects are of type :ref:`Point`. * `("re", rect, orientation)` - a :ref:`Rect`. Multiple rectangles within the same path are now detected (changed in v1.18.17). Integer `orientation` is 1 resp. -1 indicating whether the enclosed area is rotated left (1 = anti-clockwise), or resp. right [#f7]_ (changed in v1.19.2). * `("qu", quad)` - a :ref:`Quad`. 3 or 4 consecutive lines are detected to actually represent a :ref:`Quad` (changed in v1.19.2:). (New in v1.18.17) .. note::, quads and rectangles are more reliably recognized as such. (Starting with v1.19.2) Using class :ref:`Shape`, you should be able to recreate the original drawings on a separate (PDF) page with high fidelity under normal, not too sophisticated circumstances. Please see the following comments on restrictions. A coding draft can be found in :ref:`How to Extract Drawings `. Specifying `extended=True` significantly alters the output. Most importantly, new dictionary types are present: "clip" and "group". All paths will now be organized in a hierarchic structure which is encoded by the new integer key "level", the hierarchy level. Each group or clip establishes a new hierarchy, which applies to all subsequent paths having a *larger* level value. (New in v1.22.0) Any path with a smaller level value than its predecessor will end the scope of (at least) the preceding hierarchy level. A "clip" path with the same level as the preceding clip will end the scope of that clip. Same is true for groups. This is best explained by an example:: +------+------+--------+------+--------+ | line | lvl0 | lvl1 | lvl2 | lvl3 | +------+------+--------+------+--------+ | 0 | clip | | | | | 1 | | fill | | | | 2 | | group | | | | 3 | | | clip | | | 4 | | | | stroke | | 5 | | | fill | | ends scope of clip in line 3 | 6 | | stroke | | | ends scope of group in line 2 | 7 | | clip | | | | 8 | fill | | | | ends scope of line 0 +------+------+--------+------+--------+ The clip in line 0 applies to line including line 7. Group in line 2 applies to lines 3 to 5, clip in line 3 only applies to line 4. "stroke" in line 4 is under control of "group" in line 2 and "clip" in line 3 (which in turn is a subset of line 0 clip). * **"clip"** dictionary. Its values (most importantly "scissor") remain valid / apply as long as following dictionaries have a **larger "level"** value. ============== ============================================================================ Key Value ============== ============================================================================ closePath Same as in "stroke" or "fill" dictionaries even_odd Same as in "stroke" or "fill" dictionaries items Same as in "stroke" or "fill" dictionaries rect Same as in "stroke" or "fill" dictionaries layer Same as in "stroke" or "fill" dictionaries level Same as in "stroke" or "fill" dictionaries scissor the clip rectangle type "clip" ============== ============================================================================ * "group" dictionary. Its values remain valid (apply) as long as following dictionaries have a **larger "level"** value. Any dictionary with an equal or lower level end this group. ============== ============================================================================ Key Value ============== ============================================================================ rect Same as in "stroke" or "fill" dictionaries layer Same as in "stroke" or "fill" dictionaries level Same as in "stroke" or "fill" dictionaries isolated (bool) Whether this group is isolated knockout (bool) Whether this is a "Knockout Group" blendmode Name of the BlendMode, default is "Normal" opacity Float value in range [0, 1]. type "group" ============== ============================================================================ .. note:: The method is based on the output of :meth:`Page.get_cdrawings` -- which is much faster, but requires somewhat more attention processing its output. |history_begin| * New in v1.18.0 * Changed in v1.18.17 * Changed in v1.19.0: add "seqno" key, remove "clippings" key * Changed in v1.19.1: "color" / "fill" keys now always are either are RGB tuples or `None`. This resolves issues caused by exotic colorspaces. * Changed in v1.19.2: add an indicator for the *"orientation"* of the area covered by an "re" item. * Changed in v1.22.0: add new key `"layer"` which contains the name of the Optional Content Group of the path (or `None`). * Changed in v1.22.0: add parameter `extended` to also return clipping and group paths. |history_end| .. method:: get_cdrawings(extended=False) Extract the vector graphics on the page. Apart from following technical differences, functionally equivalent to :meth:`Page.get_drawings`, but much faster: * Every path type only contains the relevant keys, e.g. a stroke path has no `"fill"` color key. See comment in method :meth:`Page.get_drawings`. * Coordinates are given as :data:`point_like`, :data:`rect_like` and :data:`quad_like` **tuples** -- not as :ref:`Point`, :ref:`Rect`, :ref:`Quad` objects. If performance is a concern, consider using this method: Compared to versions earlier than 1.18.17, you should see much shorter response times. We have seen pages that required 2 seconds then, now only need 200 ms with this method. |history_begin| * New in v1.18.17 * Changed in v1.19.0: removed "clippings" key, added "seqno" key. * Changed in v1.19.1: always generate RGB color tuples. * Changed in v1.22.0: added new key `"layer"` which contains the name of the Optional Content Group of the path (or `None`). * Changed in v1.22.0: added parameter `extended` to also return clipping paths. |history_end| .. method:: get_fonts(full=False) PDF only: Return a list of fonts referenced by the page. Wrapper for :meth:`Document.get_page_fonts`. .. method:: get_images(full=False) PDF only: Return a list of images referenced by the page. Wrapper for :meth:`Document.get_page_images`. .. index:: pair: hashes; get_image_info pair: xrefs; get_image_info .. method:: get_image_info(hashes=False, xrefs=False) Return a list of meta information dictionaries for all images displayed by the page. This works for all document types. :arg bool hashes: Compute the MD5 hashcode for each encountered image, which allows identifying image duplicates. This adds the key `"digest"` to the output, whose value is a 16 byte `bytes` object. (New in v1.18.13) :arg bool xrefs: **PDF only.** Try to find the :data:`xref` for each image. Implies `hashes=True`. Adds the `"xref"` key to the dictionary. If not found, the value is 0, which means, the image is either "inline" or its xref is undetectable for some reason. Please note that this option has an extended response time, because the MD5 hashcode will be computed at least two times for each image with an xref. (New in v1.18.13) :rtype: list[dict] :returns: A list of dictionaries. This includes information for **exactly those** images, that are shown on the page -- including *"inline images"*. The dictionary layout is similar to that of image blocks in `page.get_text("dict")`. In contrast to images included in :meth:`Page.get_text`, image **binary content** is not loaded by this method, which drastically reduces memory usage. Another difference is that image detection is not restricted to the visible part of the page or any ``clip`` parameter: method :meth:`Page.get_text` will only extract images **fully contained** in the provided ``clip``. =============== =============================================================== **Key** **Value** =============== =============================================================== number block number (``int``) bbox image bbox on page, :data:`rect_like` width original image width (``int``) height original image height (``int``) cs-name colorspace name (``str``) colorspace colorspace.n (``int``) xres resolution in x-direction (``int``) [#f10]_ yres resolution in y-direction (``int``) [#f10]_ bpc bits per component (``int``) size storage occupied by image (``int``) digest MD5 hashcode (``bytes``), if ``hashes`` is true xref image :data:`xref` or 0, if *xrefs* is true transform matrix transforming image rect to bbox, :data:`matrix_like` has-mask whether the image is transparent and has a mask (``bool``) =============== =============================================================== Multiple occurrences of the same image are always reported. You can detect duplicates by comparing their `digest` values. |history_begin| * New in v1.18.11 * Changed in v1.18.13: added image MD5 hashcode computation and :data:`xref` search. |history_end| .. method:: get_xobjects() PDF only: Return a list of Form XObjects referenced by the page. Wrapper for :meth:`Document.get_page_xobjects`. .. index:: pair: transform; get_image_rects .. method:: get_image_rects(item, transform=False) PDF only: Return boundary boxes and transformation matrices of an embedded image. This is an improved version of :meth:`Page.get_image_bbox` with the following differences: * There is no restriction on **how** the image is invoked (by the page or one of its Form XObjects). The result is always complete and correct. * The result is a list of :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`) objects -- depending on *transform*. Each list item represents one location of the image on the page. Multiple occurrences might not be detectable by :meth:`Page.get_image_bbox`. * The method invokes :meth:`Page.get_image_info` with `xrefs=True` and therefore has a noticeably longer response time than :meth:`Page.get_image_bbox`. :arg list,str,int item: an item of the list :meth:`Page.get_images`, or the reference **name** entry of such an item (item[7]), or the image :data:`xref`. :arg bool transform: also return the matrix used to transform the image rectangle to the bbox on the page. If true, then tuples `(bbox, matrix)` are returned. :rtype: list :returns: Boundary boxes and respective transformation matrices for each image occurrence on the page. If the item is not on the page, an empty list `[]` is returned. |history_begin| New in v1.18.13 |history_end| .. index:: pair: transform; get_image_bbox .. method:: get_image_bbox(item, transform=False) PDF only: Return boundary box and transformation matrix of an embedded image. :arg list,str item: an item of the list :meth:`Page.get_images` with *full=True* specified, or the reference **name** entry of such an item, which is item[-3] (or item[7] respectively). :arg bool transform: return the matrix used to transform the image rectangle to the bbox on the page (new in v1.18.11). Default is just the bbox. If true, then a tuple `(bbox, matrix)` is returned. :rtype: :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`) :returns: the boundary box of the image -- optionally also its transformation matrix. |history_begin| * (Changed in v1.16.7): If the page in fact does not display this image, an infinite rectangle is returned now. In previous versions, an exception was raised. Formally invalid parameters still raise exceptions. * (Changed in v1.17.0): Only images referenced directly by the page are considered. This means that images occurring in embedded PDF pages are ignored and an exception is raised. * (Changed in v1.18.5): Removed the restriction introduced in v1.17.0: any item of the page's image list may be specified. * (Changed in v1.18.11): Partially re-instated a restriction: only those images are considered, that are either directly referenced by the page or by a Form XObject directly referenced by the page. * (Changed in v1.18.11): Optionally also return the transformation matrix together with the bbox as the tuple `(bbox, transform)`. |history_end| .. note:: 1. Be aware that :meth:`Page.get_images` may contain "dead" entries i.e. images, which the page **does not display**. This is no error, but intended by the PDF creator. No exception will be raised in this case, but an infinite rectangle is returned. You can avoid this from happening by executing :meth:`Page.clean_contents` before this method. 2. The image's "transformation matrix" is defined as the matrix, for which the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, lookup details here: :ref:`ImageTransformation`. |history_begin| * Changed in v1.18.11: return image transformation matrix |history_end| .. index:: pair: matrix; get_svg_image .. method:: get_svg_image(matrix=pymupdf.Identity, text_as_path=True) Create an SVG image from the page. Only full page images are currently supported. :arg matrix_like matrix: a matrix, default is :ref:`Identity`. :arg bool text_as_path: -- controls how text is represented. ``True`` outputs each character as a series of elementary draw commands, which leads to a more precise text display in browsers, but a **very much larger** output for text-oriented pages. Display quality for ``False`` relies on the presence of the referenced fonts on the current system. For missing fonts, the internet browser will fall back to some default -- leading to unpleasant appearances. Choose ``False`` if you want to parse the text of the SVG. (New in v1.17.5) :returns: a UTF-8 encoded string that contains the image. Because SVG has XML syntax it can be saved in a text file, the standard extension is `.svg`. .. note:: In case of a PDF, you can circumvent the "full page image only" restriction by modifying the page's CropBox before using the method. .. index:: pair: alpha; get_pixmap pair: annots; get_pixmap pair: clip; get_pixmap pair: colorspace; get_pixmap pair: matrix; get_pixmap pair: dpi; get_pixmap .. method:: get_pixmap(*, matrix=pymupdf.Identity, dpi=None, colorspace=pymupdf.csRGB, clip=None, alpha=False, annots=True) Create a pixmap from the page. This is probably the most often used method to create a :ref:`Pixmap`. All parameters are *keyword-only.* :arg matrix_like matrix: default is :ref:`Identity`. :arg int dpi: desired resolution in x and y direction. If not `None`, the `"matrix"` parameter is ignored. (New in v1.19.2) :arg colorspace: The desired colorspace, one of "GRAY", "RGB" or "CMYK" (case insensitive). Or specify a :ref:`Colorspace`, ie. one of the predefined ones: :data:`csGRAY`, :data:`csRGB` or :data:`csCMYK`. :type colorspace: str or :ref:`Colorspace` :arg irect_like clip: restrict rendering to the intersection of this area with the page's rectangle. :arg bool alpha: whether to add an alpha channel. Always accept the default ``False`` if you do not really need transparency. This will save a lot of memory (25% in case of RGB ... and pixmaps are typically **large**!), and also processing time. Also note an **important difference** in how the image will be rendered: with ``True`` the pixmap's samples area will be pre-cleared with *0x00*. This results in **transparent** areas where the page is empty. With ``False`` the pixmap's samples will be pre-cleared with *0xff*. This results in **white** where the page has nothing to show. |history_begin| Changed in v1.14.17 The default alpha value is now ``False``. * Generated with *alpha=True* .. image:: images/img-alpha-1.* * Generated with *alpha=False* .. image:: images/img-alpha-0.* |history_end| :arg bool annots: *(new in version 1.16.0)* whether to also render annotations or to suppress them. You can create pixmaps for annotations separately. :rtype: :ref:`Pixmap` :returns: Pixmap of the page. For fine-controlling the generated image, the by far most important parameter is **matrix**. E.g. you can increase or decrease the image resolution by using **Matrix(xzoom, yzoom)**. If zoom > 1, you will get a higher resolution: zoom=2 will double the number of pixels in that direction and thus generate a 2 times larger image. Non-positive values will flip horizontally, resp. vertically. Similarly, matrices also let you rotate or shear, and you can combine effects via e.g. matrix multiplication. See the :ref:`Matrix` section to learn more. .. note:: * The pixmap will have *"premultiplied"* pixels if `alpha=True`. To learn about some background, e.g. look for "Premultiplied alpha" `here `_. * The method will respect any page rotation and will not exceed the intersection of `clip` and :attr:`Page.cropbox`. If you need the page's mediabox (and if this is a different rectangle), you can use a snippet like the following to achieve this:: In [1]: import pymupdf In [2]: doc=pymupdf.open("demo1.pdf") In [3]: page=doc[0] In [4]: rotation = page.rotation In [5]: cropbox = page.cropbox In [6]: page.set_cropbox(page.mediabox) In [7]: page.set_rotation(0) In [8]: pix = page.get_pixmap() In [9]: page.set_cropbox(cropbox) In [10]: if rotation != 0: ...: page.set_rotation(rotation) ...: In [11]: |history_begin| * Changed in v1.19.2: added support of parameter dpi. |history_end| .. method:: annot_names() PDF only: return a list of the names of annotations, widgets and links. Technically, these are the */NM* values of every PDF object found in the page's */Annots* array. :rtype: list |history_begin| * New in v1.16.10 |history_end| .. method:: annot_xrefs() PDF only: return a list of the :data:`xref` numbers of annotations, widgets and links -- technically of all entries found in the page's */Annots* array. :rtype: list :returns: a list of items *(xref, type)* where type is the annotation type. Use the type to tell apart links, fields and annotations, see :ref:`AnnotationTypes`. |history_begin| * New in v1.17.1 |history_end| .. method:: load_annot(ident) PDF only: return the annotation identified by *ident*. This may be its unique name (PDF `/NM` key), or its :data:`xref`. :arg str,int ident: the annotation name or xref. :rtype: :ref:`Annot` :returns: the annotation or ``None``. .. note:: Methods :meth:`Page.annot_names`, :meth:`Page.annot_xrefs` provide lists of names or xrefs, respectively, from where an item may be picked and loaded via this method. |history_begin| * New in v1.17.1 |history_end| .. method:: load_widget(xref) PDF only: return the field identified by :data:`xref`. :arg int xref: the field's xref. :rtype: :ref:`Widget` :returns: the field or ``None``. .. note:: This is similar to the analogous method :meth:`Page.load_annot` -- except that here only the xref is supported as identifier. |history_begin| * New in v1.19.6 |history_end| .. method:: load_links() Return the first link on a page. Synonym of property :attr:`first_link`. :rtype: :ref:`Link` :returns: first link on the page (or ``None``). .. index:: pair: rotate; set_rotation .. method:: set_rotation(rotate) PDF only: Set the rotation of the page. :arg int rotate: An integer specifying the required rotation in degrees. Must be an integer multiple of 90. Values will be converted to one of 0, 90, 180, 270. .. method:: recolor(components=1) PDF only: Change the colorspace components of all objects on page. :arg int components: The desired count of color components. Must be one of 1, 3 or 4, which results in color spaces DeviceGray, DeviceRGB or DeviceCMYK respectively. The method affects text, images and vector graphics. For instance, with the default value 1, a page will be converted to grayscale. If a page is already grayscale, the method will not cause visible changes -- independent of the value of ``components``. These changes are **permanent** and cannot be reverted. .. method:: clip_to_rect(rect) PDF only: Permanently remove page content outside the given rectangle. This is similar to :meth:`Page.set_cropbox`, but the page's rectangle will not be changed, only the content outside the rectangle will be removed. :arg rect_like rect: The rectangle to clip to. Must be finite and its intersection with the page must not be empty. The method works best for text: All text on the page will be removed (decided by single character) that has no intersection with the rectangle. For vector graphics, the method will remove all paths that have no intersection with the rectangle. For images, the method will remove all images that have no intersection with the rectangle. Vectors and images **having** an intersection with the rectangle, will be kept in their entirety. The method roughly has the same effect as if four redactions had been applied that cover the rectangle's outside. * New in v1.26.4. .. method:: remove_rotation() PDF only: Set page rotation to 0 while maintaining appearance and page content. :returns: The inverted matrix used to achieve this change. If the page was not rotated (rotation 0), :ref:`Identity` is returned. The method automatically recomputes the rectangles of any annotations, links and widgets present on the page. This method may come in handy when e.g. used with :meth:`Page.show_pdf_page`. .. index:: pair: clip; show_pdf_page pair: keep_proportion; show_pdf_page pair: overlay; show_pdf_page pair: rotate; show_pdf_page .. method:: show_pdf_page(rect, docsrc, pno=0, keep_proportion=True, overlay=True, oc=0, rotate=0, clip=None) PDF only: Display a page of another PDF. This is similar to :meth:`Page.insert_image` but the source page will appear like a copy of itself and will not be rasterized. This is a multi-purpose method. For example, you can use it to: * create "n-up" versions of existing PDF files, combining several input pages into **one output page** (see example `combine.py `_), * create "posterized" PDF files, i.e. every input page is split up in parts which each create a separate output page (see `posterize.py `_), * include PDF-based vector images like company logos, watermarks, etc., see `svg.py `_, which puts an SVG-based logo on each page. :arg rect_like rect: where to place the image on current page. Must be finite and its intersection with the page must not be empty. :arg docsrc: source PDF document containing the page. Must be a different document object, but may be the same file. :type docsrc: :ref:`Document` :arg int pno: page number (0-based, in `-∞ < pno < docsrc.page_count`) to be shown. :arg bool keep_proportion: whether to maintain the width-height-ratio (default). If false, all 4 corners are always positioned on the border of the target rectangle -- whatever the rotation value. In general, this will deliver distorted and /or non-rectangular images. :arg bool overlay: put image in foreground (default) or background. :arg int oc: (:data:`xref`) make visibility dependent on this :data:`OCG` / :data:`OCMD` (which must be defined in the target PDF) [#f9]_. (New in v1.18.3) :arg float rotate: show the source rectangle rotated by some angle. Any angle is supported (changed in v1.14.11). (New in v1.14.10) :arg rect_like clip: choose which part of the source page to show. Default is the full page, else must be finite and its intersection with the source page must not be empty. .. note:: In contrast to method :meth:`Document.insert_pdf`, this method does not copy annotations, widgets or links, so these objects are not included in the target [#f6]_. But all its **other resources (text, images, fonts, etc.)** will be imported into the current PDF. They will therefore appear in text extractions and in :meth:`get_fonts` and :meth:`get_images` lists -- even if they are not contained in the visible area given by *clip*. Example: Show the same source page, rotated by 90 and by -90 degrees: >>> doc = pymupdf.open() # new empty PDF >>> page=doc.new_page() # new page in A4 format >>> >>> # upper half page >>> r1 = pymupdf.Rect(0, 0, page.rect.width, page.rect.height/2) >>> >>> # lower half page >>> r2 = r1 + (0, page.rect.height/2, 0, page.rect.height/2) >>> >>> src = pymupdf.open("PyMuPDF.pdf") # show page 0 of this >>> >>> page.show_pdf_page(r1, src, 0, rotate=90) >>> page.show_pdf_page(r2, src, 0, rotate=-90) >>> doc.save("show.pdf") .. image:: images/img-showpdfpage.* :scale: 70 |history_begin| * Changed in v1.14.11: Parameter *reuse_xref* has been deprecated. Position the source rectangle centered in target rectangle. Any rotation angle is now supported. * Changed in v1.18.3: New parameter `oc`. |history_end| .. method:: new_shape() PDF only: Create a new :ref:`Shape` object for the page. :rtype: :ref:`Shape` :returns: a new :ref:`Shape` to use for compound drawings. See description there. .. index:: pair: flags; search_for pair: quads; search_for pair: clip; search_for pair: textpage; search_for .. method:: search_for(needle, *, clip=None, quads=False, flags=TEXT_DEHYPHENATE | TEXT_PRESERVE_WHITESPACE | TEXT_PRESERVE_LIGATURES | TEXT_MEDIABOX_CLIP, textpage=None) Search for *needle* on a page. Wrapper for :meth:`TextPage.search`. :arg str needle: Text to search for. May contain spaces. Upper / lower case is ignored, but only works for ASCII characters: For example, "COMPÉTENCES" will not be found if needle is "compétences" -- "compÉtences" however will. Similar is true for German umlauts and the like. :arg rect_like clip: only search within this area. (New in v1.18.2) :arg bool quads: Return object type :ref:`Quad` instead of :ref:`Rect`. :arg int flags: Control the data extracted by the underlying :ref:`TextPage`. By default, ligatures and white spaces are kept, and hyphenation [#f8]_ is detected. :arg textpage: use a previously created :ref:`TextPage`. This reduces execution time **significantly.** If specified, the 'flags' and 'clip' arguments are ignored. If omitted, a temporary textpage will be created. (New in v1.19.0) :rtype: list :returns: A list of :ref:`Rect` or :ref:`Quad` objects, each of which -- **normally!** -- surrounds one occurrence of *needle*. **However:** if parts of *needle* occur on more than one line, then a separate item is generated for each these parts. So, if `needle = "search string"`, two rectangles may be generated. |history_begin| Changes in v1.18.2: * There no longer is a limit on the list length (removal of the `hit_max` parameter). * If a word is **hyphenated** at a line break, it will still be found. E.g. the needle "method" will be found even if hyphenated as "meth-od" at a line break, and two rectangles will be returned: one surrounding "meth" (without the hyphen) and another one surrounding "od". |history_end| .. note:: The method supports multi-line text marker annotations: you can use the full returned list as **one single** parameter for creating the annotation. .. caution:: * There is a tricky aspect: the search logic regards **contiguous multiple occurrences** of *needle* as one: assuming *needle* is "abc", and the page contains "abc" and "abcabc", then only **two** rectangles will be returned, one for "abc", and a second one for "abcabc". * You can always use :meth:`Page.get_textbox` to check what text actually is being surrounded by each rectangle. .. note:: A feature repeatedly asked for is supporting **regular expressions** when specifying the `"needle"` string: **There is no way to do this.** If you need something in that direction, first extract text in the desired format and then subselect the result by matching with some regex pattern. Here is an example for matching words:: >>> pattern = re.compile(r"...") # the regex pattern >>> words = page.get_text("words") # extract words on page >>> matches = [w for w in words if pattern.search(w[4])] The `matches` list will contain the words matching the given pattern. In the same way you can select `span["text"]` from the output of `page.get_text("dict")`. |history_begin| * Changed in v1.18.2: added `clip` parameter. Remove `hit_max` parameter. Add default "dehyphenate". * Changed in v1.19.0: added `textpage` parameter. |history_end| .. method:: set_mediabox(r) PDF only: Change the physical page dimension by setting :data:`mediabox` in the page's object definition. :arg rect-like r: the new :data:`mediabox` value. .. note:: This method also removes the page's other (optional) rectangles (:data:`cropbox`, ArtBox, TrimBox and Bleedbox) to prevent inconsistent situations. This will cause those to assume their default values. .. caution:: For non-empty pages this may have undesired effects, because the location of all content depends on this value and will therefore change position or even disappear. |history_begin| * New in v1.16.13 * Changed in v1.19.4: remove all other rectangle definitions. |history_end| .. method:: set_cropbox(r) PDF only: change the visible part of the page. :arg rect_like r: the new visible area of the page. Note that this **must** be specified in **unrotated coordinates**, not empty, nor infinite and be completely contained in the :attr:`Page.mediabox`. After execution **(if the page is not rotated)**, :attr:`Page.rect` will equal this rectangle, but be shifted to the top-left position (0, 0) if necessary. Example session: >>> page = doc.new_page() >>> page.rect pymupdf.Rect(0.0, 0.0, 595.0, 842.0) >>> >>> page.cropbox # cropbox and mediabox still equal pymupdf.Rect(0.0, 0.0, 595.0, 842.0) >>> >>> # now set cropbox to a part of the page >>> page.set_cropbox(pymupdf.Rect(100, 100, 400, 400)) >>> # this will also change the "rect" property: >>> page.rect pymupdf.Rect(0.0, 0.0, 300.0, 300.0) >>> >>> # but mediabox remains unaffected >>> page.mediabox pymupdf.Rect(0.0, 0.0, 595.0, 842.0) >>> >>> # revert CropBox change >>> # either set it to MediaBox >>> page.set_cropbox(page.mediabox) >>> # or 'refresh' MediaBox: will remove all other rectangles >>> page.set_mediabox(page.mediabox) .. method:: set_artbox(r) .. method:: set_bleedbox(r) .. method:: set_trimbox(r) PDF only: Set the resp. rectangle in the page object. For the meaning of these objects see :ref:`AdobeManual`, page 77. Parameter and restrictions are the same as for :meth:`Page.set_cropbox`. |history_begin| * New in v1.19.4 |history_end| .. attribute:: rotation Contains the rotation of the page in degrees (always 0 for non-PDF types). This is a copy of the value in the PDF file. The PDF documentation says: *"The number of degrees by which the page should be rotated clockwise when displayed or printed. The value must be a multiple of 90. Default value: 0."* In PyMuPDF, we make sure that this attribute is always one of 0, 90, 180 or 270. :type: int .. attribute:: cropbox_position Contains the top-left point of the page's `/CropBox` for a PDF, otherwise *Point(0, 0)*. :type: :ref:`Point` .. attribute:: cropbox The page's `/CropBox` for a PDF. Always the **unrotated** page rectangle is returned. For a non-PDF this will always equal the page rectangle. .. note:: In PDF, the relationship between `/MediaBox`, `/CropBox` and page rectangle may sometimes be confusing, please do lookup the glossary for :data:`MediaBox`. :type: :ref:`Rect` .. attribute:: artbox .. attribute:: bleedbox .. attribute:: trimbox The page's `/ArtBox`, `/BleedBox`, `/TrimBox`, respectively. If not provided, defaulting to :attr:`Page.cropbox`. :type: :ref:`Rect` .. attribute:: mediabox_size Contains the width and height of the page's :attr:`Page.mediabox` for a PDF, otherwise the bottom-right coordinates of :attr:`Page.rect`. :type: :ref:`Point` .. attribute:: mediabox The page's :data:`mediabox` for a PDF, otherwise :attr:`Page.rect`. :type: :ref:`Rect` .. note:: For most PDF documents and for **all other document types**, `page.rect == page.cropbox == page.mediabox` is true. However, for some PDFs the visible page is a true subset of :data:`mediabox`. Also, if the page is rotated, its `Page.rect` may not equal `Page.cropbox`. In these cases the above attributes help to correctly locate page elements. .. attribute:: transformation_matrix This matrix translates coordinates from the PDF space to the MuPDF space. For example, in PDF `/Rect [x0 y0 x1 y1]` the pair (x0, y0) specifies the **bottom-left** point of the rectangle -- in contrast to MuPDF's system, where (x0, y0) specify top-left. Multiplying the PDF coordinates with this matrix will deliver the (Py-) MuPDF rectangle version. Obviously, the inverse matrix will again yield the PDF rectangle. :type: :ref:`Matrix` .. attribute:: rotation_matrix .. attribute:: derotation_matrix These matrices may be used for dealing with rotated PDF pages. When adding / inserting anything to a PDF page, the coordinates of the **unrotated** page are always used. These matrices help translating between the two states. Example: if a page is rotated by 90 degrees -- what would then be the coordinates of the top-left Point(0, 0) of an A4 page? >>> page.set_rotation(90) # rotate an ISO A4 page >>> page.rect Rect(0.0, 0.0, 842.0, 595.0) >>> p = pymupdf.Point(0, 0) # where did top-left point land? >>> p * page.rotation_matrix Point(842.0, 0.0) >>> :type: :ref:`Matrix` .. attribute:: first_link Contains the first :ref:`Link` of a page (or ``None``). :type: :ref:`Link` .. attribute:: first_annot Contains the first :ref:`Annot` of a page (or ``None``). :type: :ref:`Annot` .. attribute:: first_widget Contains the first :ref:`Widget` of a page (or ``None``). :type: :ref:`Widget` .. attribute:: number The page number. :type: int .. attribute:: parent The owning document object. :type: :ref:`Document` .. attribute:: rect Contains the rectangle of the page. Same as result of :meth:`Page.bound()`. :type: :ref:`Rect` .. attribute:: xref The page's PDF :data:`xref`. Zero if not a PDF. :type: :ref:`Rect` ----- .. _link_dict_description: Description of *get_links()* Entries ---------------------------------------- Each entry of the :meth:`Page.get_links` list is a dictionary with the following keys: * *kind*: (required) an integer indicating the kind of link. This is one of *LINK_NONE*, *LINK_GOTO*, *LINK_GOTOR*, *LINK_LAUNCH*, or *LINK_URI*. For values and meaning of these names refer to :ref:`linkDest Kinds`. * *from*: (required) a :ref:`Rect` describing the "hot spot" location on the page's visible representation (where the cursor changes to a hand image, usually). * *page*: a 0-based integer indicating the destination page. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored. * *to*: either a *pymupdf.Point*, specifying the destination location on the provided page, default is *pymupdf.Point(0, 0)*, or a symbolic (indirect) name. If an indirect name is specified, *page = -1* is required and the name must be defined in the PDF in order for this to work. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored. * *file*: a string specifying the destination file. Required for *LINK_GOTOR* and *LINK_LAUNCH*, else ignored. * *uri*: a string specifying the destination internet resource. Required for *LINK_URI*, else ignored. You should make sure to start this string with an unambiguous substring, that classifies the subtype of the URL, like `"http://"`, `"https://"`, `"file://"`, `"ftp://"`, `"mailto:"`, etc. Otherwise your browser will try to interpret the text and come to unwanted / unexpected conclusions about the intended URL type. * :data:`xref`: an integer specifying the PDF :data:`xref` of the link object. Do not change this entry in any way. Required for link deletion and update, otherwise ignored. For non-PDF documents, this entry contains *-1*. It is also *-1* for **all** entries in the *get_links()* list, if **any** of the links is not supported by MuPDF - see :ref:`notes_on_supporting_links`. .. _notes_on_supporting_links: Notes on Supporting Links --------------------------- MuPDF's support for links has changed in **v1.10a**. These changes affect link types :data:`LINK_GOTO` and :data:`LINK_GOTOR`. Reading (pertains to method *get_links()* and the *first_link* property chain) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If MuPDF detects a link to another file, it will supply either a *LINK_GOTOR* or a *LINK_LAUNCH* link kind. In case of *LINK_GOTOR* destination details may either be given as page number (eventually including position information), or as an indirect destination. If an indirect destination is given, then this is indicated by *page = -1*, and *link.dest.dest* will contain this name. The dictionaries in the *get_links()* list will contain this information as the *to* value. **Internal links are always** of kind *LINK_GOTO*. If an internal link specifies an indirect destination, it **will always be resolved** and the resulting direct destination will be returned. Names are **never returned for internal links**, and undefined destinations will cause the link to be ignored. Writing ~~~~~~~~~ PyMuPDF writes (updates, inserts) links by constructing and writing the appropriate PDF object **source**. This makes it possible to specify indirect destinations for *LINK_GOTOR* **and** *LINK_GOTO* link kinds (pre *PDF 1.2* file formats are **not supported**). .. warning:: If a *LINK_GOTO* indirect destination specifies an undefined name, this link can later on not be found / read again with MuPDF / PyMuPDF. Other readers however **will** detect it, but flag it as erroneous. Indirect *LINK_GOTOR* destinations can in general of course not be checked for validity and are therefore **always accepted**. **Example: How to insert a link pointing to another page in the same document** 1. Determine the rectangle on the current page, where the link should be placed. This may be the bbox of an image or some text. 2. Determine the target page number ("pno", 0-based) and a :ref:`Point` on it, where the link should be directed to. 3. Create a dictionary `d = {"kind": pymupdf.LINK_GOTO, "page": pno, "from": bbox, "to": point}`. 4. Execute `page.insert_link(d)`. Homologous Methods of :ref:`Document` and :ref:`Page` -------------------------------------------------------- This is an overview of homologous methods on the :ref:`Document` and on the :ref:`Page` level. ====================================== ===================================== **Document Level** **Page Level** ====================================== ===================================== :meth:`Document.get_page_fonts` :meth:`Page.get_fonts` :meth:`Document.get_page_images` :meth:`Page.get_images` :meth:`Document.get_page_pixmap` :meth:`Page.get_pixmap` :meth:`Document.get_page_text` :meth:`Page.get_text` :meth:`Document.search_page_for` :meth:`Page.search_for` ====================================== ===================================== .. note:: Most document methods (left column) exist for convenience reasons, and are just wrappers for: *Document[pno].*. So they **load and discard the page** on each execution. However, the first two methods work differently. They only need a page's object definition statement - the page itself will **not** be loaded. So e.g. :meth:`Page.get_fonts` is a wrapper the other way round and defined as follows: `page.get_fonts` == `page.parent.get_page_fonts(page.number)`. When calling the :ref:`Document` equivalent methods then the page number is sent through as a parameter, e.g.: `Document.get_page_images(pno)` or `Document.get_page_text(pno)` .. tip:: The page number parameter, ``pno``, is a 0-based integer `-∞ < pno < page_count`. Tables and Related Classes ------------------------------------ The `TableFinder` class is returned by :meth:`Page.find_tables` and has related classes as follows: .. class:: TableFinder An object always returned by :meth:`Page.find_tables`. Attributes of interest: .. attribute:: tables A list of :class:`Table` objects, each of which represents a table found on the page. An empty list if no tables are found. .. attribute:: page A reference to the :ref:`Page` object. :type: :ref:`Page` .. class:: Table An object representing a table found on the page. .. attribute:: page A back-reference to the owning page. :type: :ref:`Page` .. attribute:: cells An array of `Rect` objects for each cell in the table. :type: list .. attribute:: header A `TableHeader` object. :type: `TableHeader` .. attribute:: bbox The bounding box of all cells of the table header. :type: :ref:`Rect` .. attribute:: row_count Number of rows in the table. :type: int .. attribute:: col_count Number of columns in the table. :type: int .. attribute:: rows An array of `TableRow` objects for each row in the table. :type: list .. method:: extract() Extracts table cell text data into a list. :type: list .. method:: to_markdown(clean=False, fill_empty=True) Extracts table data into Markdown text format. :arg bool clean: If ``True`` then markdown syntax is removed from cell content. :arg bool fill_empty: If ``True`` then cell content `None` is replaced by the values above (columns) or left (rows) in an effort to approximate row and columns spans. :type: string .. method:: to_pandas() Return a `pandas DataFrame `_ `DataFrame `_ version of the table. :type: pandas DataFrame .. class:: TableHeader Dedicated class for table headers. .. attribute:: bbox The bounding box of the union of cells belonging to the table header, given as a tuple (x0, y0, x1, y1). This rectangle contains all table header cells. :type: :ref:`Rect` .. attribute:: cells A list of tuples for each bbox of a column header. :type: list .. attribute:: names A list of strings with column header text. :type: list .. attribute:: external A boolean indicating whether the header is outside the table cells. :type: `bool` .. class:: TableRow Dedicated class for table rows. ---- .. rubric:: Footnotes .. [#f1] If your existing code already uses the installed base name as a font reference (as it was supported by PyMuPDF versions earlier than 1.14), this will continue to work. .. [#f2] Not all PDF reader software (including internet browsers and office software) display all of these fonts. And if they do, the difference between the **serifed** and the **non-serifed** version may hardly be noticeable. But serifed and non-serifed versions lead to different installed base fonts, thus providing an option to be displayable with your specific PDF viewer. .. [#f3] Not all PDF readers display these fonts at all. Some others do, but use a wrong character spacing, etc. .. [#f4] You are generally free to choose any of the :ref:`mupdficons` you consider adequate. .. [#f5] The previous algorithm caused images to be **shrunk** to this intersection. Now the image can be anywhere on :attr:`Page.mediabox`, potentially being invisible or only partially visible if the cropbox (representing the visible page part) is smaller. .. [#f6] If you need to also see annotations or fields in the target page, you can convert the source PDF using :meth:`Document.bake`. The underlying MuPDF function of that method will convert these objects to normal page content. Then use :meth:`Page.show_pdf_page` with the converted PDF page. .. [#f7] In PDF, an area enclosed by some lines or curves can have a property called "orientation". This is significant for switching on or off the fill color of that area when there exist multiple area overlaps - see discussion in method :meth:`Shape.finish` using the "non-zero winding number" rule. While orientation of curves, quads, triangles and other shapes enclosed by lines always was detectable, this has been impossible for "re" (rectangle) items in the past. Adding the orientation parameter now delivers the missing information. .. [#f8] Hyphenation detection simply means that if the last character of a line is "-", it will be assumed to be a continuation character. That character will not be found by text searching with its default flag setting. Please take note, that a MuPDF *line* may not always be what you expect: words separated by overly large gaps (e.g. caused by text justification) may constitute separate MuPDF lines. If then any of these words ends with a hyphen, it will only be found by text searching if hyphenation is switched off. .. [#f9] Objects inside the source page, like images, text or drawings, are never aware of whether their owning page now is under OC control inside the target PDF. If source page objects are OC-controlled in the source PDF, then this will not be retained on the target: they will become unconditionally visible. .. [#f10] This value is always 96, the default of the PDF interpreter. It **does not reflect** the resolution of the image itself. If you need the image's resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` attributes of the :ref:`Pixmap` created from the image binary. .. include:: footer.rst ================================================ FILE: docs/pixmap.rst ================================================ .. include:: header.rst .. _Pixmap: ================ Pixmap ================ Pixmaps ("pixel maps") are objects at the heart of MuPDF's rendering capabilities. They represent plane rectangular sets of pixels. Each pixel is described by a number of bytes ("components") defining its color, plus an optional alpha byte defining its transparency. In PyMuPDF, there exist several ways to create a pixmap. Except the first one, all of them are available as overloaded constructors. A pixmap can be created ... 1. from a document page (method :meth:`Page.get_pixmap`) 2. empty, based on :ref:`Colorspace` and :ref:`IRect` information 3. from a file 4. from an in-memory image 5. from a memory area of plain pixels 6. from an image inside a PDF document 7. as a copy of another pixmap .. note:: A number of image formats is supported as input for points 3. and 4. above. See section :ref:`ImageFiles`. Have a look at the :ref:`FAQ` section to see some pixmap usage "at work". ================================ =================================================== **Method / Attribute** **Short Description** ================================ =================================================== :meth:`Pixmap.clear_with` clear parts of the pixmap :meth:`Pixmap.color_count` determine used colors :meth:`Pixmap.color_topusage` determine share of most used color :meth:`Pixmap.copy` copy parts of another pixmap :meth:`Pixmap.gamma_with` apply a gamma factor to the pixmap :meth:`Pixmap.invert_irect` invert the pixels of a given area :meth:`Pixmap.pdfocr_save` save the pixmap as an OCRed 1-page PDF :meth:`Pixmap.pdfocr_tobytes` save the pixmap as an OCRed 1-page PDF :meth:`Pixmap.pil_image` create a Pillow Image :meth:`Pixmap.pil_save` save as a Pillow Image :meth:`Pixmap.pil_tobytes` write to `bytes` as a Pillow Image :meth:`Pixmap.pixel` return the value of a pixel :meth:`Pixmap.save` save the pixmap in a variety of formats :meth:`Pixmap.set_alpha` set alpha values :meth:`Pixmap.set_dpi` set the image resolution :meth:`Pixmap.set_origin` set pixmap x,y values :meth:`Pixmap.set_pixel` set color and alpha of a pixel :meth:`Pixmap.set_rect` set color and alpha of all pixels in a rectangle :meth:`Pixmap.shrink` reduce size keeping proportions :meth:`Pixmap.tint_with` tint the pixmap :meth:`Pixmap.tobytes` return a memory area in a variety of formats :meth:`Pixmap.warp` return a pixmap made from a quad inside :attr:`Pixmap.alpha` transparency indicator :attr:`Pixmap.colorspace` pixmap's :ref:`Colorspace` :attr:`Pixmap.digest` MD5 hashcode of the pixmap :attr:`Pixmap.height` pixmap height :attr:`Pixmap.interpolate` interpolation method indicator :attr:`Pixmap.is_monochrome` check if only black and white occur :attr:`Pixmap.is_unicolor` check if only one color occurs :attr:`Pixmap.irect` :ref:`IRect` of the pixmap :attr:`Pixmap.n` bytes per pixel :attr:`Pixmap.samples_mv` `memoryview` of pixel area :attr:`Pixmap.samples_ptr` Python pointer to pixel area :attr:`Pixmap.samples` `bytes` copy of pixel area :attr:`Pixmap.size` pixmap's total length :attr:`Pixmap.stride` size of one image row :attr:`Pixmap.width` pixmap width :attr:`Pixmap.x` X-coordinate of top-left corner :attr:`Pixmap.xres` resolution in X-direction :attr:`Pixmap.y` Y-coordinate of top-left corner :attr:`Pixmap.yres` resolution in Y-direction ================================ =================================================== **Class API** .. class:: Pixmap .. method:: __init__(self, colorspace, irect, alpha=False) **New empty pixmap:** Create an empty pixmap of size and origin given by the rectangle. So, *irect.top_left* designates the top left corner of the pixmap, and its width and height are *irect.width* resp. *irect.height*. Note that the image area is **not initialized** and will contain crap data -- use eg. :meth:`clear_with` or :meth:`set_rect` to be sure. :arg colorspace: colorspace. :type colorspace: :ref:`Colorspace` :arg irect_like irect: The pixmap's position and dimension. :arg bool alpha: Specifies whether transparency bytes should be included. Default is ``False``. .. method:: __init__(self, colorspace, source) **Copy and set colorspace:** Copy *source* pixmap converting colorspace. Any colorspace combination is possible, but source colorspace must not be ``None``. :arg colorspace: desired **target** colorspace. This **may also be** ``None``. In this case, a "masking" pixmap is created: its :attr:`Pixmap.samples` will consist of the source's alpha bytes only. :type colorspace: :ref:`Colorspace` :arg source: the source pixmap. :type source: :ref:`Pixmap`. .. method:: __init__(self, source, mask) * New in v1.18.18 **Copy and add image mask:** Copy *source* pixmap, add an alpha channel with transparency data from a mask pixmap. :arg source: pixmap without alpha channel. :type source: :ref:`Pixmap`. :arg mask: a mask pixmap. Must be a graysale pixmap. :type mask: :ref:`Pixmap`. .. method:: __init__(self, source, width, height, [clip]) **Copy and scale:** Copy *source* pixmap, scaling new width and height values -- the image will appear stretched or shrunk accordingly. Supports partial copying. The source colorspace may be ``None``. :arg source: the source pixmap. :type source: :ref:`Pixmap`. :arg float width: desired target width. :arg float height: desired target height. :arg irect_like clip: restrict the resulting pixmap to this region of the **scaled** pixmap. .. note:: If width or height do not *represent* integers (i.e. `value.is_integer() != True`), then the resulting pixmap **will have an alpha channel**. .. method:: __init__(self, source, alpha=1) **Copy and add or drop alpha:** Copy *source* and add or drop its alpha channel. Identical copy if *alpha* equals *source.alpha*. If an alpha channel is added, its values will be set to 255. :arg source: source pixmap. :type source: :ref:`Pixmap`. :arg bool alpha: whether the target will have an alpha channel, default and mandatory if source colorspace is ``None``. .. note:: A typical use includes separation of color and transparency bytes in separate pixmaps. Some applications require this like e.g. *wx.Bitmap.FromBufferAndAlpha()* of *wxPython*: >>> # 'pix' is an RGBA pixmap >>> pixcolors = pymupdf.Pixmap(pix, 0) # extract the RGB part (drop alpha) >>> pixalpha = pymupdf.Pixmap(None, pix) # extract the alpha part >>> bm = wx.Bitmap.FromBufferAndAlpha(pix.width, pix.height, pixcolors.samples, pixalpha.samples) .. method:: __init__(self, filename) **From a file:** Create a pixmap from *filename*. All properties are inferred from the input. The origin of the resulting pixmap is *(0, 0)*. :arg str filename: Path of the image file. .. method:: __init__(self, stream) **From memory:** Create a pixmap from a memory area. All properties are inferred from the input. The origin of the resulting pixmap is *(0, 0)*. :arg bytes,bytearray,BytesIO stream: Data containing a complete, valid image. Could have been created by e.g. *stream = bytearray(open('image.file', 'rb').read())*. Type *bytes* is supported in **Python 3 only**, because *bytes == str* in Python 2 and the method will interpret the stream as a filename. *Changed in version 1.14.13:* *io.BytesIO* is now also supported. .. method:: __init__(self, colorspace, width, height, samples, alpha) **From plain pixels:** Create a pixmap from *samples*. Each pixel must be represented by a number of bytes as controlled by the *colorspace* and *alpha* parameters. The origin of the resulting pixmap is *(0, 0)*. This method is useful when raw image data are provided by some other program -- see :ref:`FAQ`. :arg colorspace: Colorspace of image. :type colorspace: :ref:`Colorspace` :arg int width: image width :arg int height: image height :arg bytes,bytearray,BytesIO samples: an area containing all pixels of the image. Must include alpha values if specified. *Changed in version 1.14.13:* (1) *io.BytesIO* can now also be used. (2) Data are now **copied** to the pixmap, so may safely be deleted or become unavailable. :arg bool alpha: whether a transparency channel is included. .. note:: 1. The following equation **must be true**: *(colorspace.n + alpha) * width * height == len(samples)*. 2. Starting with version 1.14.13, the samples data are **copied** to the pixmap. .. method:: __init__(self, doc, xref) **From a PDF image:** Create a pixmap from an image **contained in PDF** *doc* identified by its :data:`xref`. All pimap properties are set by the image. Have a look at `extract-from-pages.py `_ and `extract-from-xref.py `_ to see how this can be used to recover all of a PDF's images. :arg doc: an opened |PDF| document. :type doc: :ref:`Document` :arg int xref: the :data:`xref` of an image object. For example, you can make a list of images used on a particular page with :meth:`Document.get_page_images`, which also shows the :data:`xref` numbers of each image. .. method:: clear_with([value [, irect]]) Initialize the samples area. :arg int value: if specified, values from 0 to 255 are valid. Each color byte of each pixel will be set to this value, while alpha will be set to 255 (non-transparent) if present. If omitted, then all bytes (including any alpha) are cleared to *0x00*. :arg irect_like irect: the area to be cleared. Omit to clear the whole pixmap. Can only be specified, if *value* is also specified. .. method:: tint_with(black, white) Colorize a pixmap by replacing black and / or white with colors given as **sRGB integer** values. Only colorspaces :data:`CS_GRAY` and :data:`CS_RGB` are supported, others are ignored with a warning. If the colorspace is :data:`CS_GRAY`, the average *(red + green + blue)/3* will be taken. The pixmap will be changed in place. :arg int black: replace black with this value. Specifying 0x000000 makes no changes. :arg int white: replace white with this value. Specifying 0xFFFFFF makes no changes. Examples: * `tint_with(0x000000, 0xFFFFFF)` is a no-op. * `tint_with(0x00FF00, 0xFFFFFF)` changes black to green, leaves white intact. * `tint_with(0xFF0000, 0x0000FF)` changes black to red and white to blue. .. method:: gamma_with(gamma) Apply a gamma factor to a pixmap, i.e. lighten or darken it. Pixmaps with colorspace ``None`` are ignored with a warning. :arg float gamma: *gamma = 1.0* does nothing, *gamma < 1.0* lightens, *gamma > 1.0* darkens the image. .. method:: shrink(n) Shrink the pixmap by dividing both, its width and height by 2\ :sup:``n``. :arg int n: determines the new pixmap (samples) size. For example, a value of 2 divides width and height by 4 and thus results in a size of one 16\ :sup:`th` of the original. Values less than 1 are ignored with a warning. .. note:: Use this methods to reduce a pixmap's size retaining its proportion. The pixmap is changed "in place". If you want to keep original and also have more granular choices, use the resp. copy constructor above. .. method:: pixel(x, y) *New in version:: 1.14.5:* Return the value of the pixel at location (x, y) (column, line). :arg int x: the column number of the pixel. Must be in `range(pix.width)`. :arg int y: the line number of the pixel, Must be in `range(pix.height)`. :rtype: list :returns: a list of color values and, potentially the alpha value. Its length and content depend on the pixmap's colorspace and the presence of an alpha. For RGBA pixmaps the result would e.g. be *[r, g, b, a]*. All items are integers in `range(256)`. .. method:: set_pixel(x, y, color) *New in version 1.14.7:* Manipulate the pixel at location (x, y) (column, line). :arg int x: the column number of the pixel. Must be in `range(pix.width)`. :arg int y: the line number of the pixel. Must be in `range(pix.height)`. :arg sequence color: the desired pixel value given as a sequence of integers in `range(256)`. The length of the sequence must equal :attr:`Pixmap.n`, which includes any alpha byte. .. method:: set_rect(irect, color) *New in version 1.14.8:* Set the pixels of a rectangle to a value. :arg irect_like irect: the rectangle to be filled with the value. The actual area is the intersection of this parameter and :attr:`Pixmap.irect`. For an empty intersection (or an invalid parameter), no change will happen. :arg sequence color: the desired value, given as a sequence of integers in `range(256)`. The length of the sequence must equal :attr:`Pixmap.n`, which includes any alpha byte. :rtype: bool :returns: ``False`` if the rectangle was invalid or had an empty intersection with :attr:`Pixmap.irect`, else ``True``. .. note:: 1. This method is equivalent to :meth:`Pixmap.set_pixel` executed for each pixel in the rectangle, but is obviously **very much faster** if many pixels are involved. 2. This method can be used similar to :meth:`Pixmap.clear_with` to initialize a pixmap with a certain color like this: *pix.set_rect(pix.irect, (255, 255, 0))* (RGB example, colors the complete pixmap with yellow). .. method:: set_origin(x, y) * New in v1.17.7 Set the x and y values of the pixmap's top-left point. :arg int x: x coordinate :arg int y: y coordinate .. method:: set_dpi(xres, yres) * New in v1.16.17 * Changed in v1.18.0: When saving as a PNG image, these values will be stored now. Set the resolution (dpi) in x and y direction. :arg int xres: resolution in x direction. :arg int yres: resolution in y direction. .. method:: set_alpha(alphavalues, premultiply=1, opaque=None) * Changed in v 1.18.13 Change the alpha values. The pixmap must have an alpha channel. :arg bytes,bytearray,BytesIO alphavalues: the new alpha values. If provided, its length must be at least *width * height*. If omitted (`None`), all alpha values are set to 255 (no transparency). *Changed in version 1.14.13:* *io.BytesIO* is now also accepted. :arg bool premultiply: *New in v1.18.13:* whether to premultiply color components with the alpha value. :arg list,tuple opaque: ignore the alpha value and set this color to fully transparent. A sequence of integers in `range(256)` with a length of :attr:`Pixmap.n`. Default is ``None``. For example, a typical choice for RGB would be `opaque=(255, 255, 255)` (white). .. method:: invert_irect([irect]) Invert the color of all pixels in :ref:`IRect` *irect*. Will have no effect if colorspace is ``None``. :arg irect_like irect: The area to be inverted. Omit to invert everything. .. method:: copy(source, irect) Copy the *irect* part of the *source* pixmap into the corresponding area of this one. The two pixmaps may have different dimensions and can each have :data:`CS_GRAY` or :data:`CS_RGB` colorspaces, but they currently **must** have the same alpha property [#f2]_. The copy mechanism automatically adjusts discrepancies between source and target like so: If copying from :data:`CS_GRAY` to :data:`CS_RGB`, the source gray-shade value will be put into each of the three rgb component bytes. If the other way round, *(r + g + b) / 3* will be taken as the gray-shade value of the target. Between *irect* and the target pixmap's rectangle, an "intersection" is calculated at first. This takes into account the rectangle coordinates and the current attribute values :attr:`Pixmap.x` and :attr:`Pixmap.y` (which you are free to modify for this purpose via :meth:`Pixmap.set_origin`). Then the corresponding data of this intersection are copied. If the intersection is empty, nothing will happen. :arg source: source pixmap. :type source: :ref:`Pixmap` :arg irect_like irect: The area to be copied. .. note:: Example: Suppose you have two pixmaps, `pix1` and `pix2` and you want to copy the lower right quarter of `pix2` to `pix1` such that it starts at the top-left point of `pix1`. Use the following snippet:: >>> # safeguard: set top-left of pix1 and pix2 to (0, 0) >>> pix1.set_origin(0, 0) >>> pix2.set_origin(0, 0) >>> # compute top-left coordinates of pix2 region to copy >>> x1 = int(pix2.width / 2) >>> y1 = int(pix2.height / 2) >>> # shift top-left of pix2 such, that the to-be-copied >>> # area starts at (0, 0): >>> pix2.set_origin(-x1, -y1) >>> # now copy ... >>> pix1.copy(pix2, (0, 0, x1, y1)) .. image:: images/img-pixmapcopy.* :scale: 20 .. method:: save(filename, output=None, jpg_quality=95) * Changed in v1.22.0: Added **direct support of JPEG** images. Image quality can be controlled via parameter "jpg_quality". Save pixmap as an image file. Depending on the output chosen, only some or all colorspaces are supported and different file extensions can be chosen. Please see the table below. :arg str,Path,file filename: The file to save to. May be provided as a string, as a ``pathlib.Path`` or as a Python file object. In the latter two cases, the filename is taken from the resp. object. The filename's extension determines the image format, which can be overruled by the output parameter. :arg str output: The desired image format. The default is the filename's extension. If both, this value and the file extension are unsupported, an exception is raised. For possible values see :ref:`PixmapOutput`. :arg int jpg_quality: The desired image quality, default 95. Only applies to JPEG images, else ignored. This parameter trades quality against file size. A value of 98 is close to lossless. Higher values should not lead to better quality. :raises ValueError: For unsupported image formats. .. method:: tobytes(output="png", jpg_quality=95) * New in version 1.14.5: Return the pixmap as a *bytes* memory object of the specified format -- similar to :meth:`save`. * Changed in v1.22.0: Added **direct JPEG support**. Image quality can be influenced via new parameter "jpg_quality". :arg str output: The desired image format. The default is "png". For possible values see :ref:`PixmapOutput`. :arg int jpg_quality: The desired image quality, default 95. Only applies to JPEG images, else ignored. This parameter trades quality against file size. A value of 98 is close to lossless. Higher values should not lead to better quality. :raises ValueError: For unsupported image formats. :rtype: bytes :arg str output: The requested image format. The default is "png". For other possible values see :ref:`PixmapOutput`. .. method:: pdfocr_save(filename, compress=True, language="eng", tessdata=None) * New in v1.19.0 * Changed in v1.22.5: Support of new parameter for Tesseract's tessdata. Perform text recognition using Tesseract and save the image as a 1-page PDF with an OCR text layer. :arg str,fp filename: identifies the file to save to. May be either a string or a pointer to a file opened with "wb" (includes `io.BytesIO()` objects). :arg bool compress: whether to compress the resulting PDF, default is `True`. :arg str language: the languages occurring in the image. This must be specified in Tesseract format. Default is "eng" for English. Use "+"-separated Tesseract language codes for multiple languages, like "eng+spa" for English and Spanish. :arg str tessdata: folder name of Tesseract's language support. If omitted, this information must be present as environment variable `TESSDATA_PREFIX`. .. note:: **Will fail** if Tesseract is not installed or if the environment variable "TESSDATA_PREFIX" is not set to the `tessdata` folder name and not provided as parameter. .. method:: pdfocr_tobytes(compress=True, language="eng", tessdata=None) * New in v1.19.0 * Changed in v1.22.5: Support of new parameter for Tesseract's tessdata. Perform text recognition using Tesseract and convert the image to a 1-page PDF with an OCR text layer. Internally invokes :meth:`Pixmap.pdfocr_save`. :returns: A 1-page PDF file in memory. Could be opened like `doc=pymupdf.open("pdf", pix.pdfocr_tobytes())`, and text extractions could be performed on its `page=doc[0]`. .. note:: Another possible use is insertion into some pdf. The following snippet reads the images of a folder and stores them as pages in a new PDF that contain an OCR text layer:: doc = pymupdf.open() for imgfile in os.listdir(folder): pix = pymupdf.Pixmap(imgfile) imgpdf = pymupdf.open("pdf", pix.pdfocr_tobytes()) doc.insert_pdf(imgpdf) pix = None imgpdf.close() doc.save("ocr-images.pdf") .. method:: pil_image() Create a Pillow Image from the pixmap. PIL / Pillow must be installed. :raises ImportError: if Pillow is not installed. :returns: a ``PIL.Image`` object .. method:: pil_save(*args, unmultiply=False, **kwargs) Write the pixmap as an image file using Pillow. Use this method for output unsupported by MuPDF. Examples are * Formats JPX, J2K, WebP, etc. * Storing EXIF information. * If you do not provide dpi information, the values *xres*, *yres* stored with the pixmap are automatically used. A simple example: `pix.pil_save("some.webp", optimize=True, dpi=(150, 150))`. :arg bool unmultiply: If the pixmap's colorspace is RGB with transparency, the alpha values may or may not already be multiplied into the color components ref/green/blue (called "premultiplied"). To enforce undoing premultiplication, set this parameter to `True`. To learn about some background, e.g. look for `"Premultiplied alpha" on this page `_. For details on other parameters see the Pillow documentation. Since v1.22.0, PyMuPDF supports JPEG output directly. We recommended to no longer use this method for JPEG output -- for performance reasons and for avoiding unnecessary external dependencies. :raises ImportError: if Pillow is not installed. .. method:: pil_tobytes(*args, unmultiply=False, **kwargs) * New in v1.17.3 Return an image as a bytes object in the specified format using Pillow. For example `stream = pix.pil_tobytes(format="WEBP", optimize=True, dpi=(150, 150))`. Also see above. For details on other parameters see the Pillow documentation. :raises ImportError: if Pillow is not installed. :rtype: bytes .. method:: warp(quad, width, height) * New in v1.19.3 Return a new pixmap by "warping" the quad such that the quad corners become the new pixmap's corners. The target pixmap's `irect` will be `(0, 0, width, height)`. :arg quad_like quad: a convex quad with coordinates inside :attr:`Pixmap.irect` (including the border points). :arg int width: desired resulting width. :arg int height: desired resulting height. :returns: A new pixmap where the quad corners are mapped to the pixmap corners in a clockwise fashion: `quad.ul -> irect.tl`, `quad.ur -> irect.tr`, etc. :rtype: :ref:`Pixmap` .. image:: images/img-warp.* :scale: 40 :align: center .. method:: color_count(colors=False, clip=None) * New in v1.19.2 * Changed in v1.19.3 Determine the pixmap's unique colors and their count. :arg bool colors: *(changed in v1.19.3)* If `True` return a dictionary of color pixels and their usage count, else just the number of unique colors. :arg rect_like clip: a rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels are considered. This allows inspecting sub-rectangles of a given pixmap directly -- instead of building sub-pixmaps. :rtype: dict or int :returns: either the number of colors, or a dictionary with the items `pixel: count`. The pixel key is a `bytes` object of length :attr:`Pixmap.n`. .. note:: To recover the **tuple** of a pixel, use `tuple(colors.keys()[i])` for the i-th item. * The response time depends on the pixmap's samples size and may be more than a second for very large pixmaps. * Where applicable, pixels with different alpha values will be treated as different colors. .. method:: color_topusage(clip=None) * New in v1.19.3 Return the most frequently used color and its relative frequency. :arg rect_like clip: A rectangle inside :attr:`Pixmap.irect`. If provided, only those pixels are considered. This allows inspecting sub-rectangles of a given pixmap directly -- instead of building sub-pixmaps. :rtype: tuple :returns: A tuple `(ratio, pixel)` where `0 < ratio <= 1` and *pixel* is the pixel value of the color. Use this to decide if the image is "almost" unicolor: a response `(0.95, b"\x00\x00\x00")` means that 95% of all pixels are black. See an example here :ref:`RecipesImages_P`. .. attribute:: alpha Indicates whether the pixmap contains transparency information. :type: bool .. attribute:: digest The MD5 hashcode (16 bytes) of the pixmap. This is a technical value used for unique identifications. :type: bytes .. attribute:: colorspace The colorspace of the pixmap. This value may be ``None`` if the image is to be treated as a so-called *image mask* or *stencil mask* (currently happens for extracted PDF document images only). :type: :ref:`Colorspace` .. attribute:: stride Contains the length of one row of image data in :attr:`Pixmap.samples`. This is primarily used for calculation purposes. The following expressions are true: * `len(samples) == height * stride` * `width * n == stride` :type: int .. attribute:: is_monochrome * New in v1.19.2 Is `True` for a gray pixmap which only has the colors black and white. :type: bool .. attribute:: is_unicolor * New in v1.19.2 Is `True` if all pixels are identical (any colorspace). Where applicable, pixels with different alpha values will be treated as different colors. :type: bool .. attribute:: irect Contains the :ref:`IRect` of the pixmap. :type: :ref:`IRect` .. attribute:: samples The color and (if :attr:`Pixmap.alpha` is true) transparency values for all pixels. It is an area of `width * height * n` bytes. Each n bytes define one pixel. Each successive n bytes yield another pixel in scanline order. Subsequent scanlines follow each other with no padding. E.g. for an RGBA colorspace this means, *samples* is a sequence of bytes like *..., R, G, B, A, ...*, and the four byte values R, G, B, A define one pixel. This area can be passed to other graphics libraries like PIL (Python Imaging Library) to do additional processing like saving the pixmap in other image formats. .. note:: * The underlying data is typically a **large** memory area, from which a `bytes` copy is made for this attribute ... each time you access it: for example an RGB-rendered letter page has a samples size of almost 1.4 MB. So consider assigning a new variable to it or use the `memoryview` version :attr:`Pixmap.samples_mv` (new in v1.18.17). * Any changes to the underlying data are available only after accessing this attribute again. This is different from using the memoryview version. :type: bytes .. attribute:: samples_mv * New in v1.18.17 Like :attr:`Pixmap.samples`, but in Python `memoryview` format. It is built pointing to the memory in the pixmap -- not from a copy of it. So its creation speed is independent from the pixmap size, and any changes to pixels will be available immediately. Copies like `bytearray(pix.samples_mv)`, or `bytes(pixmap.samples_mv)` are equivalent to and can be used in place of `pix.samples`. We also have `len(pix.samples) == len(pix.samples_mv)`. Look at this example from a 2 MB JPEG: the memoryview is **ten thousand times faster**:: In [3]: %timeit len(pix.samples_mv) 367 ns ± 1.75 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each) In [4]: %timeit len(pix.samples) 3.52 ms ± 57.5 µs per loop (mean ± std. dev. of 7 runs, 100 loops each) After the Pixmap has been destroyed, any attempt to use the memoryview will fail with ValueError. :type: memoryview .. attribute:: samples_ptr * New in v1.18.17 Python pointer to the pixel area. This is a special integer format, which can be used by supporting applications (such as PyQt) to directly address the samples area and thus build their images extremely fast. For example:: img = QtGui.QImage(pix.samples, pix.width, pix.height, format) # (1) img = QtGui.QImage(pix.samples_ptr, pix.width, pix.height, format) # (2) Both of the above lead to the same Qt image, but (2) can be **many hundred times faster**, because it avoids an additional copy of the pixel area. Warning: after the Pixmap has been destroyed, the Python pointer will be invalid and attempting to use it may crash the Python interpreter. :type: int .. attribute:: size Contains *len(pixmap)*. This will generally equal *len(pix.samples)* plus some platform-specific value for defining other attributes of the object. :type: int .. attribute:: width .. attribute:: w Width of the region in pixels. :type: int .. attribute:: height .. attribute:: h Height of the region in pixels. :type: int .. attribute:: x X-coordinate of top-left corner in pixels. Cannot directly be changed -- use :meth:`Pixmap.set_origin`. :type: int .. attribute:: y Y-coordinate of top-left corner in pixels. Cannot directly be changed -- use :meth:`Pixmap.set_origin`. :type: int .. attribute:: n Number of components per pixel. This number depends on colorspace and alpha. If colorspace is not ``None`` (stencil masks), then *Pixmap.n - Pixmap.alpha == pixmap.colorspace.n* is true. If colorspace is ``None``, then *n == alpha == 1*. :type: int .. attribute:: xres Horizontal resolution in dpi (dots per inch). Please also see :data:`resolution`. Cannot directly be changed -- use :meth:`Pixmap.set_dpi`. :type: int .. attribute:: yres Vertical resolution in dpi (dots per inch). Please also see :data:`resolution`. Cannot directly be changed -- use :meth:`Pixmap.set_dpi`. :type: int .. attribute:: interpolate An information-only boolean flag set to ``True`` if the image will be drawn using "linear interpolation". If ``False`` "nearest neighbour sampling" will be used. :type: bool .. _ImageFiles: Supported Input Image Formats ----------------------------------------------- The following file types are supported as **input** to construct pixmaps: **BMP, JPEG, GIF, TIFF, JXR, JPX**, **PNG**, **PAM** and all of the **Portable Anymap** family (**PBM, PGM, PNM, PPM**). This support is two-fold: 1. Directly create a pixmap with *Pixmap(filename)* or *Pixmap(byterray)*. The pixmap will then have properties as determined by the image. 2. Open such files with *pymupdf.open(...)*. The result will then appear as a document containing one single page. Creating a pixmap of this page offers all the options available in this context: apply a matrix, choose colorspace and alpha, confine the pixmap to a clip area, etc. **SVG images** are only supported via method 2 above, not directly as pixmaps. But remember: the result of this is a **raster image** as is always the case with pixmaps [#f1]_. .. _PixmapOutput: Supported Output Image Formats --------------------------------------------------------------------------- A number of image **output** formats are supported. You have the option to either write an image directly to a file (:meth:`Pixmap.save`), or to generate a bytes object (:meth:`Pixmap.tobytes`). Both methods accept a string identifying the desired format (**Format** column below). Please note that not all combinations of pixmap colorspace, transparency support (alpha) and image format are possible. ========== =============== ========= ============== ================================= **Format** **Colorspaces** **alpha** **Extensions** **Description** ========== =============== ========= ============== ================================= jpg, jpeg gray, rgb, cmyk no .jpg, .jpeg Joint Photographic Experts Group pam gray, rgb, cmyk yes .pam Portable Arbitrary Map pbm gray, rgb no .pbm Portable Bitmap pgm gray, rgb no .pgm Portable Graymap png gray, rgb yes .png Portable Network Graphics pnm gray, rgb no .pnm Portable Anymap ppm gray, rgb no .ppm Portable Pixmap ps gray, rgb, cmyk no .ps Adobe PostScript Image psd gray, rgb, cmyk yes .psd Adobe Photoshop Document ========== =============== ========= ============== ================================= .. note:: * Not all image file types are supported (or at least common) on all OS platforms. E.g. PAM and the Portable Anymap formats are rare or even unknown on Windows. * Especially pertaining to CMYK colorspaces, you can always convert a CMYK pixmap to an RGB pixmap with *rgb_pix = pymupdf.Pixmap(pymupdf.csRGB, cmyk_pix)* and then save that in the desired format. * As can be seen, MuPDF's image support range is different for input and output. Among those supported both ways, PNG and JPEG are probably the most popular. * We also recommend using "ppm" formats as input to tkinter's *PhotoImage* method like this: *tkimg = tkinter.PhotoImage(data=pix.tobytes("ppm"))* (also see the tutorial). This is **very** fast (**60 times** faster than PNG). .. rubric:: Footnotes .. [#f1] If you need a **vector image** from the SVG, you must first convert it to a PDF. Try :meth:`Document.convert_to_pdf`. If this is not good enough, look for other SVG-to-PDF conversion tools like the Python packages `svglib `_, `CairoSVG `_, `Uniconvertor `_ or the Java solution `Apache Batik `_. Have a look at our Wiki for more examples. .. [#f2] To also set the alpha property, add an additional step to this method by dropping or adding an alpha channel to the result. .. include:: footer.rst ================================================ FILE: docs/point.rst ================================================ .. include:: header.rst .. _Point: ================ Point ================ *Point* represents a point in the plane, defined by its x and y coordinates. ============================ ============================================ **Attribute / Method** **Description** ============================ ============================================ :meth:`Point.distance_to` calculate distance to point or rect :meth:`Point.norm` the Euclidean norm :meth:`Point.transform` transform point with a matrix :attr:`Point.abs_unit` same as unit, but positive coordinates :attr:`Point.unit` point coordinates divided by *abs(point)* :attr:`Point.x` the X-coordinate :attr:`Point.y` the Y-coordinate ============================ ============================================ **Class API** .. class:: Point .. method:: __init__(self) .. method:: __init__(self, x, y) .. method:: __init__(self, point) .. method:: __init__(self, sequence) Overloaded constructors. Without parameters, *Point(0, 0)* will be created. With another point specified, a **new copy** will be created, "sequence" is a Python sequence of 2 numbers (see :ref:`SequenceTypes`). :arg float x: x coordinate of the point :arg float y: y coordinate of the point .. method:: distance_to(x [, unit]) Calculate the distance to *x*, which may be :data:`point_like` or :data:`rect_like`. The distance is given in units of either pixels (default), inches, centimeters or millimeters. :arg point_like,rect_like x: to which to compute the distance. :arg str unit: the unit to be measured in. One of "px", "in", "cm", "mm". :rtype: float :returns: the distance to *x*. If this is :data:`rect_like`, then the distance * is the length of the shortest line connecting to one of the rectangle sides * is calculated to the **finite version** of it * is zero if it **contains** the point .. method:: norm() * New in version 1.16.0 Return the Euclidean norm (the length) of the point as a vector. Equals result of function *abs()*. .. method:: transform(m) Apply a matrix to the point and replace it with the result. :arg matrix_like m: The matrix to be applied. :rtype: :ref:`Point` .. attribute:: unit Result of dividing each coordinate by *norm(point)*, the distance of the point to (0,0). This is a vector of length 1 pointing in the same direction as the point does. Its x, resp. y values are equal to the cosine, resp. sine of the angle this vector (and the point itself) has with the x axis. .. image:: images/img-point-unit.* :type: :ref:`Point` .. attribute:: abs_unit Same as :attr:`unit` above, replacing the coordinates with their absolute values. :type: :ref:`Point` .. attribute:: x The x coordinate :type: float .. attribute:: y The y coordinate :type: float .. note:: * This class adheres to the Python sequence protocol, so components can be accessed via their index, too. Also refer to :ref:`SequenceTypes`. * Rectangles can be used with arithmetic operators -- see chapter :ref:`Algebra`. .. include:: footer.rst ================================================ FILE: docs/pymupdf-pro/index.rst ================================================ .. include:: ../header.rst .. _pymupdf-pro: .. raw:: html PyMuPDF Pro ============= |PyMuPDF Pro| is a set of *commercial extensions* for |PyMuPDF|. Enhance |PyMuPDF| capability with **Office** document support & **RAG/LLM** integrations. - Enables Office document handling, including ``doc``, ``docx``, ``hwp``, ``hwpx``, ``ppt``, ``pptx``, ``xls``, ``xlsx``, and others. - Supports text and table extraction, document conversion and more. - Includes the commercial version of |PyMuPDF4LLM|. To enquire about obtaining a commercial license, then `use this contact page `_. .. note:: A licensed version of |PyMuPDF Pro| also gives you a licensed version of |PyMuPDF4LLM|. If you are interested in using the |PyMuPDF4LLM| package you should install it separately. Platform support -------------------- Available for these platforms only: - Windows x86_64. - Linux x86_64 (glibc). - MacOS x86_64. - MacOS arm64. Office file support ---------------------- In addition to the `standard file types supported by PyMuPDF `, |PyMuPDF Pro| supports: .. list-table:: :header-rows: 1 * - **DOC/DOCX** - **XLS/XLSX** - **PPT/PPTX** - **HWP/HWPX** * - .. image:: ../images/icons/icon-docx.svg :width: 40 :height: 40 - .. image:: ../images/icons/icon-xlsx.svg :width: 40 :height: 40 - .. image:: ../images/icons/icon-pptx.svg :width: 40 :height: 40 - .. image:: ../images/icons/icon-hangul.svg :width: 40 :height: 40 Usage -------------- Installation ~~~~~~~~~~~~~~~~~~ Install via pip with: .. code-block:: bash pip install pymupdfpro Loading an **Office** document ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Import |PyMuPDF Pro| and you can then reference **Office** documents directly, e.g.: .. code-block:: python import pymupdf.pro pymupdf.pro.unlock() # PyMuPDF has now been extended with PyMuPDF Pro features, with some restrictions. doc = pymupdf.open("my-office-doc.xls") .. note:: All standard |PyMuPDF| functionality is exposed as expected - |PyMuPDF Pro| handles the extended **Office** file types From then on you can work with document pages just as you would do normally, but with respect to the `restrictions `. Converting an **Office** document to |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following code snippet can convert your **Office** document to |PDF| format: .. code-block:: python import pymupdf.pro pymupdf.pro.unlock() doc = pymupdf.open("my-office-doc.xlsx") pdfdata = doc.convert_to_pdf() with open('output.pdf', 'wb') as f: f.write(pdfdata) .. _PyMuPDFPro_Restrictions: Restrictions ~~~~~~~~~~~~~~~~~~~~ |PyMuPDF Pro| functionality is restricted without a license key as follows: **Only the first 3 pages of any document will be available.** To unlock full functionality you should `obtain a trial key `_. .. _PyMuPDFPro_TrialKeys: Trial keys ----------------------- To obtain a license key `please fill out the form on this page `_. You will then have the trial key emailled to the address you submitted. Using a key ~~~~~~~~~~~~~~~~ Initialize |PyMuPDF Pro| with a key as follows: .. code-block:: python import pymupdf.pro pymupdf.pro.unlock(my_key) # PyMuPDF has now been extended with PyMuPDF Pro features. This will allow you to evaluate the product for a limited time. If you want to use |PyMuPDF Pro| after this time you should then `enquire about obtaining a commercial license `_. Fonts ----------------------- By default `pymupdf.pro.unlock()` searches for all installed font directories. This can be controlled with keyword-only args: * `fontpath`: specific font directories, either as a list/tuple or `os.sep`-separated string. If None (the default), we use `os.environ['PYMUPDFPRO_FONT_PATH']` if set. * `fontpath_auto`: Whether to append system font directories. If None (the default) we use true if `os.environ['PYMUPDFPRO_FONT_PATH_AUTO']` is '1'. If true we append all system font directories. Function `pymupdf.pro.get_fontpath()` returns a tuple of all font directories used by `unlock()`. .. raw:: html .. include:: ../footer.rst ================================================ FILE: docs/pymupdf4llm/api.rst ================================================ .. include:: ../header.rst .. |PyMuPDFLayoutMode_Ignored| raw:: html use_layout() must be False .. |PyMuPDFLayoutMode_Valid| raw:: html .. |PyMuPDFLayoutMode_EmptyList| raw:: html Only if use_layout() is False .. |PyMuPDFLayoutMode_Unavailable| raw:: html Only if use_layout() is False .. _pymupdf4llm-api: The PyMuPDF4LLM API =========================================================================== .. property:: version Prints the version of the library. .. method:: to_markdown(doc: pymupdf.Document | str, *, \ detect_bg_color: bool = True, \ dpi: int = 150, \ embed_images: bool = False, \ extract_words: bool = False, \ filename: str | None = None, \ fontsize_limit: float = 3, \ footer: bool = True, \ force_ocr: bool = False, \ force_text: bool = True, \ graphics_limit: int = None, \ hdr_info: Any = None, \ header: bool = True, \ ignore_alpha: bool = False, \ ignore_code: bool = False, \ ignore_graphics: bool = False, \ ignore_images: bool = False, \ image_format: str = "png", \ image_path: str = "", \ image_size_limit: float = 0.05, \ margins: float | list = 0, \ ocr_dpi: int = 300, \ ocr_function: callable = None, \ ocr_language: str = "eng", \ page_chunks: bool = False, \ page_height: float = None, \ page_separators: bool = False, \ page_width: float = 612, \ pages: list | range | None = None, \ show_progress: bool = False, \ table_strategy: str = "lines_strict", \ use_glyphs: bool = False, \ use_ocr: bool = True, \ write_images: bool = False) -> str | list[dict] Reads the pages of the file and outputs the text of its pages in |Markdown| format. How this should happen in detail can be influenced by a number of parameters. Please note that **support for building page chunks** from the |Markdown| text is supported. :arg Document,str doc: the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`. :arg bool detect_bg_color: |PyMuPDFLayoutMode_Ignored| does a simple check for the general background color of the pages (default is ``True``). If any text or vector has this color it will be ignored. May increase detection accuracy. :arg int dpi: specify the desired image resolution in dots per inch. Relevant only if `write_images=True` or `embed_images=True`. Default value is 150. :arg bool embed_images: like `write_images`, but images will be included in the markdown text as base64-encoded strings. Mutually exclusive with `write_images` and ignores `image_path`. This may drastically increase the size of your markdown text. :arg bool extract_words: |PyMuPDFLayoutMode_Ignored| a value of `True` enforces `page_chunks=True` and adds key "words" to each page dictionary. Its value is a list of words as delivered by PyMuPDF's `Page` method `get_text("words")`. The sequence of the words in this list is the same as the extracted text. :arg str filename: Overwrites or sets the desired image file name of written images. Useful when the document is provided as a memory object (which has no inherent file name). :arg float fontsize_limit: |PyMuPDFLayoutMode_Ignored| limit the font size to consider for text extraction. If the font size is lower than what is set then the text won't be considered for extraction. Default is `3`, meaning only text with a font size `>= 3` will be considered for extraction. :arg bool footer: |PyMuPDFLayoutMode_Valid| boolean to switch on/off page footer content. This parameter controls whether to include or omit footer text from all the document pages. Useful if the document has repetitive footer content which doesn't add any value to the overall extraction data. Default is `True` meaning that footer content will be considered. :arg bool force_ocr: |PyMuPDFLayoutMode_Valid| if `True`, OCR will be applied to all pages regardless of their content. This may be useful for documents which are known to be image-based and thus profit from OCR, but which do not meet the default criteria for applying OCR. Default is `False` meaning that OCR will only be applied to pages which meet the default criteria. .. warning:: Requires that either one of the default supported OCR engines is installed or `ocr_function` specifies a callable OCR function. Otherwise, an exception will be raised. :arg bool force_text: generate text output even when overlapping images / graphics. This text then appears after the respective image. :arg int graphics_limit: |PyMuPDFLayoutMode_Ignored| use this to limit dealing with excess amounts of vector graphics elements. Scientific documents, or pages simulating text via graphics commands may contain tens of thousands of these objects. As vector graphics are analyzed for multiple purposes, runtime may quickly become intolerable. With this parameter, all vector graphics will be ignored if their count exceeds the threshold. :arg hdr_info: |PyMuPDFLayoutMode_Ignored| use this if you want to provide your own header detection logic. This may be a callable or an object having a method named `get_header_id`. It must accept a text span (a span dictionary as contained in :meth:`~.extractDICT`) and a keyword parameter "page" (which is the owning :ref:`Page ` object). It must return a string "" or up to 6 "#" characters followed by 1 space. If omitted (`None`), a full document scan will be performed to find the most popular font sizes and derive header levels based on them. To completely avoid this behavior specify `hdr_info=lambda s, page=None: ""` or `hdr_info=False`. :arg bool header: |PyMuPDFLayoutMode_Valid| boolean to switch on/off page header content. This parameter controls whether we want to include or omit the header content from all the document pages. Useful if the document has repetitive header content which doesn't add any value to the overall extraction data. Default is `True` meaning that header content will be considered. :arg bool ignore_alpha: |PyMuPDFLayoutMode_Ignored| if ``True`` includes text even when completely transparent. Default is ``False``: transparent text will be ignored which usually increases detection accuracy. :arg bool ignore_code: if `True` then mono-spaced text lines do not receive special formatting. Code blocks will no longer be generated. This value is set to `True` if `extract_words=True` is used. :arg bool ignore_graphics: |PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard vector graphics on the page. This may help detecting text correctly when pages are very crowded (often the case for documents representing presentation slides). Also speeds up processing time. This automatically prevents table detection. :arg bool ignore_images: |PyMuPDFLayoutMode_Ignored| (New in v.0.0.20) Disregard images on the page. This may help detecting text correctly when pages are very crowded (often the case for documents representing presentation slides). Also speeds up processing time. :arg str image_format: specify the desired image format via its extension. Default is "png" (portable network graphics). Another popular format may be "jpg". Possible values are all :ref:`supported output formats `. :arg str image_path: store images in this folder. Relevant if `write_images=True`. Default is the path of the script directory. :arg float image_size_limit: |PyMuPDFLayoutMode_Ignored| this must be a ``0 <= value < 1``. Images are ignored if `width / page.rect.width <= image_size_limit` or `height / page.rect.height <= image_size_limit`. For instance, the default value 0.05 means that to be considered for inclusion, an image's width and height must be larger than 5% of the page's width and height, respectively. :arg float,list margins: |PyMuPDFLayoutMode_Ignored| a float or a sequence of 2 or 4 floats specifying page borders. Only objects inside the margins will be considered for output. * `margin=f` yields `(f, f, f, f)` for `(left, top, right, bottom)`. * `(top, bottom)` yields `(0, top, 0, bottom)`. * To always read full pages **(default)**, use `margins=0`. :arg int ocr_dpi: |PyMuPDFLayoutMode_Valid| specify the desired image resolution in dots per inch for applying OCR to the intermediate image of the page. Default value is 300. Only relevant if the page has been determined to profit from OCR (no or few text, most of the page covered by images or character-like vectors, etc.). Larger values do not usually increase the OCR precision. There also is a risk of over-sharpening the image which may decrease OCR precision. So the default value should probably be sufficiently high - in many cases you should see satisfactory results already with values of 150 or 200. Be aware that processing time and memory requirements grow quadratically with this value (an O(ocr_dpi²) impact). :arg callable ocr_function: |PyMuPDFLayoutMode_Valid| if you want to provide your own :ref:`OCR function `, specify it here. If omitted (`None`), one of the available built-in OCR engines will be used. :arg str ocr_language: |PyMuPDFLayoutMode_Valid| specify the language to be used by the Tesseract OCR engine. Default is "eng" (English). Make sure that the respective language data files are installed. Remember to use correct Tesseract language codes. Multiple languages can be specified by concatenating the respective codes with a plus sign "+", for example "eng+deu" for English and German. :arg bool page_chunks: if `True` the output will be a list of `Document.page_count` dictionaries (one per page). Each dictionary has the following structure: - **"metadata"** - a dictionary consisting of the document's metadata :attr:`Document.metadata`, enriched with additional keys **"file_path"** (the file name), **"page_count"** (number of pages in document), and **"page_number"** (1-based page number). - **"toc_items"** - a list of Table of Contents items pointing to this page. Each item of this list has the format `[lvl, title, pagenumber]`, where `lvl` is the hierarchy level, `title` a string and `pagenumber` as a 1-based page number. - **"tables"** - |PyMuPDFLayoutMode_EmptyList| a list of tables on this page. Each item is a dictionary with keys "bbox", "row_count" and "col_count". Key "bbox" is a `pymupdf.Rect` in tuple format of the table's position on the page. - **"images"** - |PyMuPDFLayoutMode_EmptyList| a list of images on the page. This a copy of page method :meth:`Page.get_image_info`. - **"graphics"** - |PyMuPDFLayoutMode_EmptyList| a list of vector graphics rectangles on the page. This is a list of boundary boxes of clustered vector graphics as delivered by method :meth:`Page.cluster_drawings`. - **"text"** - page content as |Markdown| text. - **"words"** - |PyMuPDFLayoutMode_EmptyList| if `extract_words=True` was used. This is a list of tuples `(x0, y0, x1, y1, "wordstring", bno, lno, wno)` as delivered by `page.get_text("words")`. The **sequence** of these tuples however is the same as produced in the markdown text string and thus honors multi-column text. This is also true for text in tables: words are extracted in the sequence of table row cells. - **"text"** - page content as |Markdown| text. - **"page_boxes"** - |PyMuPDFLayoutMode_Valid| a list of dictionaries representing the layout boundary boxes. Each dictionary has the following structure:: { "index": int, # 0-based integer index of the box in reading sequence "class": str, # one of "text", "picture", "table", etc. "bbox": [x0, y0, x1, y1], # boundary box coordinates "pos": (start, stop), # 0-based integers: bbox_text = chunk["text"][start:stop] } :arg float page_height: specify a desired page height. For relevance see the `page_width` parameter. If using the default `None`, the document will appear as one large page with a width of `page_width`. Consequently in this case, no markdown page separators will occur (except the final one), respectively only one page chunk will be returned. :arg bool page_separators: if ``True`` inserts a string ``--- end of page=n ---`` at the end of each page output. Intended for debugging purposes. The page number is 0-based. The separator string is wrapped with line breaks. Default is ``False``. :arg float page_width: specify a desired page width. This is ignored for documents with a fixed page width like PDF, XPS etc. **Reflowable** documents however, like e-books, office [#f2]_ or text files have no fixed page dimensions. They by default are assumed to have Letter format width (612) and an **unlimited** page height. This means that the **full document is treated as one large page.** :arg list pages: optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Any Python sequence with integer items is accepted. The sequence is sorted and processed to only contain unique items. :arg bool show_progress: Default is `False`. A value of `True` displays a progress bar as pages are being converted. Package `tqdm `_ is used if installed, otherwise the built-in text based progress bar is used. :arg str table_strategy: |PyMuPDFLayoutMode_Ignored| see: :meth:`table detection strategy `. Default is `"lines_strict"` which ignores background colors. In some occasions, other strategies may be more successful, for example `"lines"` which uses all vector graphics objects for detection. :arg bool use_glyphs: |PyMuPDFLayoutMode_Ignored| (New in v.0.0.19) Default is `False`. A value of `True` will use the glyph number of the characters instead of the character itself if the font does not store the Unicode value. :arg bool use_ocr: |PyMuPDFLayoutMode_Valid| use :ref:`OCR capability ` to help analyse the page. This will OCR pages as determined by the default criteria. :arg bool write_images: when encountering images or vector graphics, images will be created from the respective page area and stored in the specified folder. |Markdown| references will be generated pointing to these images. Any text contained in these areas will not be included in the text output (but appear as part of the images). Therefore, if for instance your document has text written on full page images, make sure to set this parameter to `False`. If using :ref:`PyMuPDF Layout `, boundary boxes that are classified as "picture" by the layout module will be treated as images - independent from the mixture of text, images or vector graphics they may be covering. If `force_text=True` is used, text will still be extracted from these areas and included in the output after the respective image reference. :returns: Either a string of the combined text of all selected document pages, or a list of dictionaries if `page_chunks=True`. .. method:: to_text(doc: pymupdf.Document | str, *, **kwargs) -> str Reads the pages of the file and outputs the text of its pages in plain text (|TXT|) format. :arg Document,str doc: the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`. :arg bool use_ocr: |PyMuPDFLayoutMode_Valid| use :ref:`OCR capability ` to help analyse the page. :arg str ocr_language: |PyMuPDFLayoutMode_Valid| specify the language to be used by the Tesseract OCR engine. Default is "eng" (English). Make sure that the respective language data files are installed. Remember to use correct Tesseract language codes. Multiple languages can be specified by concatenating the respective codes with a plus sign "+", for example "eng+deu" for English and German. :arg int ocr_dpi: |PyMuPDFLayoutMode_Valid| specify the desired image resolution in dots per inch for applying OCR to the intermediate image of the page. Default value is 400. Only relevant if the page has been determined to profit from OCR (no or few text, most of the page covered by images or character-like vectors, etc.). Large values may increase the OCR precision but increase memory requirements and processing time. There also is a risk of over-sharpening the image which may decrease OCR precision. So the default value should probably be sufficiently high. :arg bool header: boolean to switch on/off page header content. This parameter controls whether to include or omit the header content from all the document pages. Useful if the document has repetitive header content which doesn't add any value to the overall extraction data. Default is `True` meaning that header content will be written. :arg bool footer: boolean to switch on/off page footer content. This parameter controls whether to include or omit the footer content from all the document pages. Useful if the document has repetitive footer content which doesn't add any value to the overall extraction data. Default is `True` meaning that footer content will be written. :arg bool ignore_code: if `True` then mono-spaced text lines do not receive special formatting. No blocks will be written and text lines will be written continuously. :arg list pages: optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Any Python sequence with integer items is accepted. The sequence is sorted and processed to only contain unique items. :arg bool force_text: generate text output also when overlapping images / graphics. This text then appears after the respective image reference. Images (i.e. "picture" areas) however will not be written to the text output but appear as a text line in the output like `==> picture [width x height] <==`. :arg bool show_progress: Default is `False`. A value of `True` displays a progress bar as pages are being converted. Package `tqdm `_ is used if installed, otherwise the built-in text based progress bar is used. :arg bool page_chunks: if `True` the output will be a list of `Document.page_count` dictionaries (one per page). Each dictionary has the following structure: - **"metadata"** - a dictionary consisting of the document's metadata :attr:`Document.metadata`, enriched with additional keys **"file_path"** (the file name), **"page_count"** (number of pages in document), and **"page_number"** (1-based page number). - **"toc_items"** - a list of Table of Contents items pointing to this page. Each item of this list has the format `[lvl, title, pagenumber]`, where `lvl` is the hierarchy level, `title` a string and `pagenumber` as a 1-based page number. - **"tables"** - empty list. - **"images"** - empty list. - **"graphics"** - empty list. - **"words"** - empty list. - **"text"** - page content as plain text. - **"page_boxes"** - a list of dictionaries representing the layout boundary boxes. Each dictionary has the following structure:: { "index": int, # 0-based integer index of the box in reading sequence "class": str, # one of "text", "picture", "table", etc. "bbox": [x0, y0, x1, y1], # boundary box coordinates "pos": (start, stop), # 0-based integers: bbox_text = chunk["text"][start:stop] } .. method:: to_json(doc: pymupdf.Document | str, *, **kwargs) -> str Parses the document and the specified pages and converts the result into a |JSON|-formatted string. :arg Document,str doc: the file, to be specified either as a file path string, or as a |PyMuPDF| :class:`Document` (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| :class:`Document`. :arg bool use_ocr: |PyMuPDFLayoutMode_Valid| use :ref:`OCR capability ` to help analyse the page. :arg str ocr_language: |PyMuPDFLayoutMode_Valid| specify the language to be used by the Tesseract OCR engine. Default is "eng" (English). Make sure that the respective language data files are installed. Remember to use correct Tesseract language codes. Multiple languages can be specified by concatenating the respective codes with a plus sign "+", for example "eng+deu" for English and German. :arg int ocr_dpi: |PyMuPDFLayoutMode_Valid| specify the desired image resolution in dots per inch for applying OCR to the intermediate image of the page. Default value is 400. Only relevant if the page has been determined to profit from OCR (no or few text, most of the page covered by images or character-like vectors, etc.). Large values may increase the OCR precision but increase memory requirements and processing time. There also is a risk of over-sharpening the image which may decrease OCR precision. So the default value should probably be sufficiently high. :arg int image_dpi: specify the desired image resolution in dots per inch. Default value is 150. Only relevant if one of the parameters `write_images=True` or `embed_images=True` is used. :arg str image_format: specify the desired image format via its extension. Default is "png" (portable network graphics). Another popular format may be "jpg". Possible values are all :ref:`supported output formats `. Only relevant if one of the parameters `write_images=True` or `embed_images=True` is used. :arg str image_path: store images in this folder. Relevant if `write_images=True`. Default is the path of the script directory. Page areas classified as "picture" will be written as image files to the specified location. The image file names will be of the format `{image_path}/{filename}-pagenumber-image_number.{image_format}`. :arg bool force_text: generate text output for text that is written upon areas that are classified as "picture" by the layout module. This may be especially be useful when picture content is not stored. :arg bool show_progress: display a progress bar during processing. :arg bool embed_images: store image binaries for "picture" boundary boxes. Base64-encoded images are included in the JSON output. Ignores `image_path` if used. This may drastically increase the size of your JSON text. :arg bool write_images: store image files "picture" boundary boxes.when encountering images, image files will be created from the respective page area and stored in the specified folder. Any text contained in these areas will still be included in the text output. :arg list pages: optional, the pages to consider for output (caution: specify 0-based page numbers). If omitted (`None`) all pages are processed. Specify any valid Python sequence containing integers between `0` and `page_count - 1`. .. _pymupdf4llm-api-layout: .. method:: use_layout(yes: bool = True) Switch on/off the use of the :ref:`PyMuPDF Layout module `. If `yes=True` (default), the layout module will be used for page analysis for optimal results. If `yes=False`, the layout module will not be used. .. method:: get_key_values(doc: pymupdf.Document | str) -> list[dict] Parse the document if it is a **Form PDF** and extract key-value pairs from all form fields (widgets). Please note that this method is only relevant for PDF documents that contain widgets. Otherwise, an empty list will be returned. The function is always available -- independently of whether you are using the PyMuPDF Layout module or not. Each dictionary item has the following structure:: { "field_name": str, # the full name of the form field, components separated by dots { "value": str, # the field value as string "pages": list, # list of 0-based page numbers where the field appears } } .. note:: Please see `this site `_ for more background and the current status of further improvements regarding usage with :ref:`PyMuPDF Layout `. .. method:: LlamaMarkdownReader(*args, **kwargs) Create a `pdf_markdown_reader.PDFMarkdownReader` using the `LlamaIndex`_ package. Please note that this package will **not automatically be installed** when installing **pymupdf4llm**. For details on the possible arguments, please consult the LlamaIndex documentation [#f1]_. :raises: `NotImplementedError`: Please install required `LlamaIndex`_ package. :returns: a `pdf_markdown_reader.PDFMarkdownReader` and issues message "Successfully imported LlamaIndex". Please note that this method needs several seconds to execute. For details on using the markdown reader please see below. ---- .. class:: IdentifyHeaders .. note:: |PyMuPDFLayoutMode_Unavailable| .. method:: __init__(self, doc: pymupdf.Document | str, *, pages: list | range | None = None, body_limit: float = 11, max_levels: int = 6) Create an object which maps text font sizes to the respective number of '#' characters which are used by Markdown syntax to indicate header levels. The object is created by scanning the document for font size "popularity". The most popular font size and all smaller sizes are used for body text. Larger font sizes are mapped to the respective header levels - which correspond to the HTML tags `

` to `

`. All font sizes are rounded to integer values. If more than 6 header levels would be required, then the largest number smaller than the `
` font size is used for body text. Please note that creating the object will read and inspect the text of the entire document - independently of reading the document again in the `to_markdown()` method subsequently. Method `to_markdown()` by default **will create this object** if you do not override its `hdr_info=None` parameter. :arg Document,str doc: the file, to be specified either as a file path string, or as a |PyMuPDF| Document (created via `pymupdf.open`). In order to use `pathlib.Path` specifications, Python file-like objects, documents in memory etc. you **must** use a |PyMuPDF| Document. :arg list pages: optional, the pages to consider. If omitted all pages are processed. :arg float body_limit: the default font size limit for body text. Only used when the document scan does not deliver valid information. :arg int max_levels: the maximum number of header levels to be used. Valid values are in `range(1, 7)`. The default is 6, which corresponds to the HTML tags `

` to `

`. A smaller value will limit the number of generated header levels. For instance, a value of 3 will only generate header tags "#", "##" and "###". Body text will be assumed for all font sizes smaller than the one corresponding to "###". .. method:: get_header_id(self, span: dict, page=None) -> str Return appropriate markdown header prefix. This is either "" or a string of "#" characters followed by a space. Given a text span from a "dict" extraction, determine the markdown header prefix string of 0 to n concatenated '#' characters. :arg dict span: a dictionary containing the text span information. This is the same dictionary as returned by `page.get_text("dict")`. :arg Page page: the owning page object. This can be used when additional information needs to be extracted. :returns: a string of "#" characters followed by a space. .. attribute:: header_id A dictionary mapping (integer) font sizes to Markdown header strings like ``{14: '# ', 12: '## '}``. The dictionary is created by the :class:`IdentifyHeaders` constructor. The keys are the font sizes of the text spans in the document. The values are the respective header strings. .. attribute:: body_limit An integer value indicating the font size limit for body text. This is computed as ``min(header_id.keys()) - 1``. In the above example, body_limit would be 11. ---- **How to limit header levels (example)** Limit the generated header levels to 3:: import pymupdf, pymupdf4llm filename = "input.pdf" doc = pymupdf.open(filename) # use a Document for subsequent processing my_headers = pymupdf4llm.IdentifyHeaders(doc, max_levels=3) # generate header info md_text = pymupdf4llm.to_markdown(doc, hdr_info=my_headers) **How to provide your own header logic (example 1)** Provide your own function which uses pre-determined, fixed font sizes:: import pymupdf, pymupdf4llm filename = "input.pdf" doc = pymupdf.open(filename) # use a Document for subsequent processing def my_headers(span, page=None): """ Provide some custom header logic. This is a callable which accepts a text span and the page. Could be extended to check for other properties of the span, for instance the font name, text color and other attributes. """ # header level is h1 if font size is larger than 14 # header level is h2 if font size is larger than 10 # otherwise it is body text if span["size"] > 14: return "# " elif span["size"] > 10: return "## " else: return "" # this will *NOT* scan the document for font sizes! md_text = pymupdf4llm.to_markdown(doc, hdr_info=my_headers) **How to provide your own header logic (example 2)** This user function uses the document's Table of Contents -- under the assumption that the bookmark text is also present as a header line on the page (which certainly need not be the case!):: import pymupdf, pymupdf4llm filename = "input.pdf" doc = pymupdf.open(filename) # use a Document for subsequent processing TOC = doc.get_toc() # use the table of contents for determining headers def my_headers(span, page=None): """ Provide some custom header logic (experimental!). This callable checks whether the span text matches any of the TOC titles on this page. If so, use TOC hierarchy level as header level. """ # TOC items on this page: toc = [t for t in TOC if t[-1] == page.number + 1] if not toc: # no TOC items on this page return "" # look for a match in the TOC items for lvl, title, _ in toc: if span["text"].startswith(title): return "#" * lvl + " " if title.startswith(span["text"]): return "#" * lvl + " " return "" # this will *NOT* scan the document for font sizes! md_text = pymupdf4llm.to_markdown(doc, hdr_info=my_headers) ---- .. class:: TocHeaders .. note:: |PyMuPDFLayoutMode_Unavailable| .. method:: __init__(self, doc: pymupdf.Document | str) Create an object which uses the document's Table of Contents (TOC) to determine header levels. Upon object creation, the table of contents is read via the `Document.get_toc()` method. The TOC data is then used to determine header levels in the `to_markdown()` method. This is an alternative to :class:`IdentifyHeaders`. Instead of running through the full document to identify font sizes, it uses the document's Table Of Contents (TOC) to identify headers on pages. Like :class:`IdentifyHeaders`, this also is no guarantee to find headers, but for well-built Table of Contents, there is a good chance for more correctly identifying header lines on document pages than the font-size-based approach. It also has the advantage of being much faster than the font-size-based approach, as it does not execute a full document scan or even access any of the document pages. Examples where this approach works very well are the Adobe's files on PDF documentation. Please note that this feature **does not read document pages** where the table of contents may exist as normal standard text. It only accesses data as provided by the `Document.get_toc()` method. It will not identify any headers for documents where the table of contents is not available as a collection of bookmarks. .. method:: get_header_id(self, span: dict, page=None) -> str Return appropriate markdown header prefix. This is either an empty string or a string of "#" characters followed by a space. Given a text span from a "dict" extraction variant, determine the markdown header prefix string of 0 to n concatenated "#" characters. :arg dict span: a dictionary containing the text span information. This is the same dictionary as returned by `page.get_text("dict")`. :arg Page page: the owning page object. This can be used when additional information needs to be extracted. :returns: a string of "#" characters followed by a space. **How to use class TocHeaders** This is a version of previous **example 2** that uses :class:`TocHeaders` for header identification:: import pymupdf, pymupdf4llm filename = "input.pdf" doc = pymupdf.open(filename) # use a Document for subsequent processing my_headers = pymupdf4llm.TocHeaders(doc) # use the table of contents for determining headers # this will *NOT* scan the document for font sizes! md_text = pymupdf4llm.to_markdown(doc, hdr_info=my_headers) ----- .. class:: pdf_markdown_reader.PDFMarkdownReader .. method:: load_data(file_path: Union[Path, str], extra_info: Optional[Dict] = None, **load_kwargs: Any) -> List[LlamaIndexDocument] This is the only method of the markdown reader you should currently use to extract markdown data. Please in any case ignore methods `aload_data()` and `lazy_load_data()`. Other methods like `use_doc_meta()` may or may not make sense. For more information, please consult the LlamaIndex documentation [#f1]_. Under the hood the method will execute `to_markdown()`. :returns: a list of `LlamaIndexDocument` documents - one for each page. ----- For a list of changes, please see file `CHANGES.md `_. .. rubric:: Footnotes .. [#f1] `LlamaIndex documentation `_ .. [#f2] When using PyMuPDF-Pro, supported office documents are converted internally into a PDF-like format. Therefore, they **will have fixed page dimensions** and be no longer "reflowable". Consequently, the page width and page height specifications will be ignored as well in these cases. .. include:: ../footer.rst .. _LlamaIndex: https://pypi.org/project/llama-index/ .. raw:: html /* this script is used to adjust the search widget and to add line breaks after parameters in the signature blocks for better readability */ ================================================ FILE: docs/pymupdf4llm/index.rst ================================================ .. include:: ../header.rst .. _pymupdf4llm: .. raw:: html PyMuPDF4LLM =========================================================================== |PyMuPDF4LLM| is a lightweight extension for |PyMuPDF| that turns PDFs into clean, structured data with minimal setup. It includes layout analysis *without* any GPU requirement. |PyMuPDF4LLM| makes it easy to extract document content in the format you need for **LLM** & **RAG** environments. It supports structured data extraction to :ref:`Markdown `, :ref:`JSON ` and :ref:`TXT `, as well as :ref:`LlamaIndex ` and :ref:`LangChain ` integration. .. important:: You can also extend the supported file types to also include **Office** document formats (DOC/DOCX, XLS/XLSX, PPT/PPTX, HWP/HWPX) by :ref:`using PyMuPDF Pro with PyMuPDF4LLM `. Features ------------------------------- - Support for Markdown, JSON and plain text output formats. - Support for multi-column pages. - Support for image and vector graphics extraction. - Layout analysis for better semantic understanding of document structure. - Support for page chunking output. - Automatic detection of pages which profit from OCR and support for various OCR engines. - Integration with :ref:`LlamaIndex ` & :ref:`LangChain `. API ------- See: :doc:`api`. Installation ---------------- Install the package via **pip** with: .. code-block:: bash pip install pymupdf4llm Extracting ------------------------------- .. _extracting_as_md: As **Markdown** ~~~~~~~~~~~~~~~~~~~~~~~ To retrieve your document content in **Markdown** use the :meth:`to_markdown` method as follows: .. code-block:: python import pymupdf4llm md = pymupdf4llm.to_markdown("input.pdf") .. _extracting_as_json: As **JSON** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To retrieve your document content in **JSON** use the :meth:`to_json` method as follows: .. code-block:: python import pymupdf4llm json = pymupdf4llm.to_json("input.pdf") The JSON export will give you bounding box information and layout data for each element on the page. This can be used to create your own custom output formats or to simply have more detailed information about the document structure for RAG workflows & LLM integrations. .. _extracting_as_txt: As **TXT** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To retrieve your document content in **TXT** use the :meth:`to_text` method as follows: .. code-block:: python import pymupdf4llm txt = pymupdf4llm.to_text("input.pdf") ---- .. note:: Instead of using filename strings as above, one can also provide a :ref:`PyMuPDF Document `. Finally we can save the output to an external file as follows:: from pathlib import Path suffix = ".md" # or ".json" or ".txt" Path(doc.name).with_suffix(suffix).write_bytes(md.encode()) Headers & Footers ~~~~~~~~~~~~~~~~~~~~~~~ Many documents will have header and footer information on each page of a PDF which you may or may not want to include. This information can be repetitive and simply not needed ( e.g. the same logo and document title or page number information is not always required when it comes to extracting the document content ). |PyMuPDF4LLM| is trained in detecting these typical document elements and able to omit them. So in this case we can adjust our API calls to ignore these elements as follows:: md = pymupdf4llm.to_markdown(doc, header=False, footer=False) .. note:: Please note that page ``header`` / ``footer`` exclusion is not applicable to JSON output as it aims to always represent all data for the included pages. Please refer to :doc:`api` for more. Integrations ------------------------------- .. _integration_with_llamaindex: With **LlamaIndex** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |PyMuPDF4LLM| supports direct conversion to a **LlamaIndex** document. A document is first converted into **Markdown** format and then a **LlamaIndex** document is returned as follows: .. code-block:: python import pymupdf4llm llama_reader = pymupdf4llm.LlamaMarkdownReader() llama_docs = llama_reader.load_data("input.pdf") .. _integration_with_langchain: With **LangChain** ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |PyMuPDF4LLM| also supports **LangChain** integration, see the `PyMuPDF4LLM Document Loader`_ for more details. .. _using_pymupdf4llm_with_pymupdfpro: Using with |PyMuPDF Pro| --------------------------- For **Office** document support, |PyMuPDF4LLM| works seamlessly with |PyMuPDF Pro|. Assuming you have :doc:`../pymupdf-pro/index` installed you will be able to work with **Office** documents as expected: .. code-block:: python import pymupdf4llm import pymupdf.pro pymupdf.pro.unlock() md = pymupdf4llm.to_markdown("sample.doc") .. _pymupdf4llm_and_layout: PyMuPDF4LLM & PyMuPDF Layout ----------------------------------- By default |PyMuPDF4LLM| includes a `layout analysis module`_ to enhance output results. To disable this module you can do so by calling the :meth:`use_layout` method. OCR -------- PyMuPDF4LLM includes built-in OCR support for scanned documents and image-based PDFs. By default, OCR runs **automatically** when needed — you don't have to opt in. For more control, you can force OCR on specific pages, disable it entirely, or swap in a different OCR engine using the adaptor interface. .. note:: If you want to use an OCR engine other than Tesseract, see :ref:`OCR Engines ` for details. Hybrid OCR strategy ~~~~~~~~~~~~~~~~~~~~~~~~~ PyMuPDF4LLM applies OCR only when it is genuinely required to obtain the complete text of a PDF page. If a page already contains sufficient extractable text, OCR is skipped entirely — avoiding unnecessary work and eliminating the risk of degrading high-quality digital text. When OCR is needed, PyMuPDF4LLM automatically selects the most suitable OCR plugin available in the runtime environment, balancing detection accuracy with processing speed. Its built-in OCR plugins implement a Hybrid OCR strategy: only those regions lacking extractable, legible text are passed to the OCR engine. This selective approach typically reduces OCR processing time by around 50% while improving recognition accuracy, since the engine focuses exclusively on the problematic regions. The recognized text is then merged back into the original page, enriching it without disturbing existing digital content. ---- Auto-OCR Behaviour ~~~~~~~~~~~~~~~~~~~~~~~~~~ PyMuPDF4LLM inspects each page before extracting text. If a page contains **no selectable text** — meaning all content is rasterised into images — OCR is triggered automatically for that page. Pages that contain native text only are never sent through OCR. This keeps processing fast and avoids degrading already-clean text. .. code-block:: python import pymupdf4llm # OCR runs automatically on any page with no selectable text md_text = pymupdf4llm.to_markdown("scanned-document.pdf") The resulting Markdown is seamless — pages extracted via OCR and pages extracted natively are combined into a single output with no distinction between them. ---- How OCR is Triggered ~~~~~~~~~~~~~~~~~~~~~~~~~~ There are two scenarios where OCR is applied automatically: **No text at all** — if a page contains roughly no text but is covered with images or many character-sized vectors, PyMuPDF4LLM checks whether text is *probably* detectable on the page. This distinguishes image-based text (e.g. a scanned document) from ordinary pictures like photographs. **Garbled text** — if a page does contain text but too many characters are unreadable (e.g. ``"�����"``), OCR is applied **for the affected text areas only**, not the full page. This preserves already-readable text, images, and vectors while recovering only what is broken. ---- Forcing OCR ~~~~~~~~~~~~~ In some cases you may want to force OCR even on pages that contain selectable text — for example, when the native text layer is corrupt, misencoded, or misaligned with the visual content. Use ``force_ocr=True`` to bypass the auto-detection check entirely: .. code-block:: python md_text = pymupdf4llm.to_markdown("document.pdf", force_ocr=True) .. warning:: Forcing OCR on clean, text-based PDFs will slow down processing significantly and may reduce output quality. Only use ``force_ocr=True`` when you have reason to distrust the native text layer. You can also force OCR on specific pages rather than the whole document: .. code-block:: python md_text = pymupdf4llm.to_markdown( "document.pdf", pages=[2, 3, 4], force_ocr=True ) ---- Disabling OCR ~~~~~~~~~~~~~ To prevent OCR from running at all — even on pages with no selectable text — set ``use_ocr=False``: .. code-block:: python md_text = pymupdf4llm.to_markdown("document.pdf", use_ocr=False) Pages with no selectable text will return empty strings in this mode. This is useful when you know your documents are always text-based, or when you want to handle OCR yourself in a downstream step. ---- .. _ocr-adaptors: .. _ocr-engines: .. _ocr-plugins: OCR Engines ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Other OCR Engines (OCR Adaptors or Plugins) can be used with PyMuPDF4LLM. See :doc:`ocr-plugins` for details on how to use different OCR engines with PyMuPDF4LLM, including Tesseract, RapidOCR, and how to implement your own custom OCR function. OCR Language Support ~~~~~~~~~~~~~~~~~~~~~~~~~~ When using the default Tesseract adaptor, you can specify one or more languages using Tesseract's language codes. Specify the language to be used by the Tesseract OCR engine. Default is ``"eng"`` (English). Make sure that the respective language data files are installed. Remember to use correct Tesseract language codes. Multiple languages can be specified by concatenating the respective codes with a plus sign ``"+"``, for example ``"eng+deu"`` for English and German. .. code-block:: python md_text = pymupdf4llm.to_markdown("multilingual.pdf", ocr_language="eng+deu") Tesseract language packs must be installed on your system. For example, on Ubuntu: .. code-block:: bash sudo apt install tesseract-ocr-deu tesseract-ocr-fra See the page on :ref:`installing Tesseract language packs ` for further details. ---- Performance Tips ~~~~~~~~~~~~~~~~~~~~~~~~~~ OCR is the most compute-intensive part of the extraction pipeline. A few ways to keep it fast: - **Process only the pages you need** using the ``pages`` parameter to avoid running OCR on the entire document. - **Cache results** — write the output to disk after the first run so you don't re-process the same file. - **Use** ``force_ocr=False`` (the default) so clean pages skip OCR entirely. - **Resize images before passing to OCR** — very high DPI scans can slow Tesseract down without improving accuracy. ---- Further Resources ------------------- Sample code ~~~~~~~~~~~~~~~ - `Command line RAG Chatbot with PyMuPDF `_ - `Example of a Browser Application using LangChain and PyMuPDF `_ Blogs ~~~~~~~~~~~~~~ - `RAG/LLM and PDF: Enhanced Text Extraction `_ - `Creating a RAG Chatbot with ChatGPT and PyMuPDF `_ - `Building a RAG Chatbot GUI with the ChatGPT API and PyMuPDF `_ - `RAG/LLM and PDF: Conversion to Markdown Text with PyMuPDF `_ .. include:: ../footer.rst .. _PyMuPDF4LLM Document Loader: https://docs.langchain.com/oss/python/integrations/providers/pymupdf4llm/ .. _layout analysis module: https://pypi.org/project/pymupdf-layout/ ================================================ FILE: docs/pymupdf4llm/ocr-plugins.rst ================================================ .. include:: ../header.rst OCR Plugins ====================== PyMuPDF4LLM supports default OCR functions. They come in the form of plugins that are present in its `ocr` subpackage. They are based on currently 3 popular OCR engines, Tesseract OCR, RapidOCR and PaddleOCR. Some engines can be combined to make use of their strengths and mitigate their weaknesses. For example, Tesseract OCR is very good at **recognizing** text, while RapidOCR is better at **detecting** text bounding boxes in images with complex backgrounds. By combining the two engines, we can achieve better overall OCR results while at the same time also reducing the overall OCR processing time. Here is an overview of the available default plugins: ============== ========================= ================================================================================= Plugin Name Engines Description ============== ========================= ================================================================================= rapidocr_api RapidOCR Uses RapidOCR for both text **detection** and text **recognition** paddleocr_api PaddleOCR Uses PaddleOCR for both text **detection** and text **recognition** tesseract_api Tesseract OCR Uses Tesseract OCR for both text **detection** and text **recognition** rapidtess_api RapidOCR + Tesseract OCR Uses RapidOCR for text **detection** and Tesseract OCR for text **recognition** paddletess_api PaddleOCR + Tesseract OCR Uses PaddleOCR for text **detection** and Tesseract OCR for text **recognition** ============== ========================= ================================================================================= If not explicitly selected via the `ocr_function` parameter, PyMuPDF4LLM will check the availability of the three OCR engines and pick one of the above plugins in the following order of preference: 1. `rapidtess_api` (if both RapidOCR and Tesseract OCR are available) 2. `paddletess_api` (if both PaddleOCR and Tesseract OCR are available) 3. `rapidocr_api` (if RapidOCR is available, but not Tesseract OCR) 4. `paddleocr_api` (if PaddleOCR is available, but not Tesseract OCR) 5. `tesseract_api` (if Tesseract OCR is available, but neither RapidOCR nor PaddleOCR are available) If none of these engines is available (and no own plugin is provided), no OCR will be performed at all. If the `force_ocr` parameter is ``True``, an error will be raised. Otherwise, the document will be processed without OCR and a warning will be displayed. The chosen plugin is displayed as an information message. How Default Plugins Work ------------------------ The provided default plugins use the following **"hybrid"** OCR approach: 1. Each page is cleaned from any existing standard text content. 2. The remaining page is rendered as an image and passed to the OCR engine for text detection and recognition. 3. Only the detected text is inserted back into the original page as standard text content. In this way, all original content (text and other elements) is preserved and only **augmented** with the newly recognized text. This allows for a more accurate and complete text extraction while also preserving the original document structure and formatting as much as possible. It also allows for a more efficient OCR processing since only the non-extractable text is processed by the OCR engine. This can significantly reduce the overall processing time. It also increases the chances for a successful layout detection, because other original content like vectors remain intact and will not be rendered to pixels. Forcing the Choice of a Default Plugin --------------------------------------- The default plugins are designed to be used as is, without any need for configuration. However, if you want to use a specific plugin, you can do so by using the following approach (which enforces for instance using RapidOCR and skipping the above selection process). Please note that all plugins have a function named `exec_ocr` that does the actual OCR. RapidOCR ~~~~~~~~~ If `RapidOCR `_ and the RapidOCR ONNX Runtime are available, you can use a pre-made callable OCR function for it, which is provided in the ``pymupdf4llm.ocr`` module as ``rapidocr_api.exec_ocr``. .. code-block:: python import pymupdf4llm from pymupdf4llm.ocr import rapidocr_api my_ocr_function = rapidocr_api.exec_ocr # Use my_ocr_function as the OCR function in PyMuPDF4LLM md_text = pymupdf4llm.to_markdown("input.pdf", ocr_function=my_ocr_function) RapidOCR & Tesseract Side-by-Side ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you want to use both OCR engines side-by-side, you can do so by implementing a custom OCR function which calls both OCR engines — one for bbox recognition (RapidOCR) and the other for text recognition (Tesseract) — and then combines their results. This pre-made callable OCR function can be found in the ``pymupdf4llm.ocr`` module as ``rapidtess_api.exec_ocr()``. **Example** .. code-block:: python from pymupdf4llm.ocr import rapidtess_api md = pymupdf4llm.to_markdown( doc, ocr_function=rapidtess_api.exec_ocr, force_ocr=True ) .. list-table:: :header-rows: 1 :widths: 35 25 40 * - Adaptor - Engines - Notes * - ``rapidocr_api.exec_ocr`` - RapidOCR - Requires RapidOCR and ONNX Runtime * - ``rapidtess_api.exec_ocr`` - RapidOCR & Tesseract - Better accuracy for bounding box detection and text recognition Providing your Own Plugin ------------------------- If you want to use your own OCR function, you can do so as follows:: import pymupdf4llm def my_ocr_function(page, pixmap=None, dpi=300, language="eng"): # Your OCR implementation here return None # Use my_ocr_function as the OCR function in PyMuPDF4LLM md_text = pymupdf4llm.to_markdown("input.pdf", ocr_function=my_ocr_function) Your plugin must accept at least the ``page`` parameter which is a PyMuPDF Page object. The other parameters are optional. The plugin must create (or extend) the text of the passed-in page object by simply inserting text (using any of PyMuPDF's text insertion methods). No return values expected. Be prepared to accept ``None`` or a PyMuPDF Pixmap object as the `pixmap` parameter, which is the rendered image of the page if provided. Parameters ``dpi`` and ``language`` are passed through from the respective function parameters. Selecting Pages for OCR ------------------------ Usually in document processing, the vast majority of pages contain extractable text and do not require OCR. PyMuPDF4LLM contains logic that analyzes the content based on a number of criteria including (but not restricted to) the following: * Presence of extractable and legible (!) text * Presence of images that appear to contain text * Presence of vector graphics that simulate text * Presence of text generated by previous OCR activities The OCR decision is internally based on the results of the following function:: from pymupdf4llm.helpers.utils import analyze_page analysis = analyze_page(page) The result ``analysis`` is a dictionary with the following keys and values. The area-related float values are computed as fractions of the total covered area. * "covered": pymupdf.Rect, page area covered by content * "img_joins": float, fraction of area of the joined images * "img_area": float, fraction of **sum** of image area sizes * "txt_joins": float, fraction of area of the joined text spans * "txt_area": float, fraction of **sum** of text span bbox area sizes * "vec_joins": float, fraction of area of the joined vector characters * "vec_area": float, fraction of **sum** of vector character area sizes * "chars_total": int, count of visible characters * "chars_bad": int, count of Replacement Unicode characters * "ocr_spans": int, count: text spans with ignored text (render mode 3) * "img_var": float, area-weighted image variance * "img_edges": float, area-weighted image edge energy * "vec_suspicious": int, minimum number of suspected vector-based glyphs * "reason": str, reason for the OCR decision, else ``None`` * "needs_ocr": bool, OCR decision (recommendation) The reason is one of the following values: * "chars_bad": more than 10% of all characters are illegible (i.e. Replacement Unicode characters) * "ocr_spans": there exist text spans created from previous OCR executions (render mode 3) * "vec_text": there exist suspected vector-based glyphs * "img_text": there exist images which (probably) contain recognizable text Based on this analysis, PyMuPDF4LLM will decide whether to invoke or skip OCR for a page. This is done to optimize processing time and resource usage by only performing OCR when it is likely to yield additional text content that cannot be extracted by other means. You can override this logic in the following ways: 1. By setting `force_ocr=True` in the output functions (`to_markdown`, `to_text`, `to_json`). All pages will then be OCRed with the selected or provided OCR function regardless of their content. This will obviously have a massive impact on your execution time: expect several seconds duration per each page. 2. Do as before, but add your own selection logic to the OCR plugin:: import pymupdf4llm from pymupdf4llm.ocr import rapidocr_api from pymupdf4llm.helpers.utils import analyze_page def my_ocr_function(page, pixmap=None, dpi=300, language="eng"): # analyze the page content and perform OCR only if necessary analysis = analyze_page(page) # inspect the items of the analysis dictionary to make your own # decision about whether to perform OCR or not, e.g.: if not analysis["needs_ocr"]: # accept decision NOT to perform OCR: return None # if OCR is recommended, you can decide differently based on # your own insights, e.g. we might want to accept previous OCR # results and skip OCR if there are already text spans created # from previous OCR executions (render mode 3): if analysis["reason"] == "ocr_spans": return None # execute desired OCR engine rapidocr_api.exec_ocr(page, pixmap=pixmap, dpi=dpi, language=language) return None md_text = pymupdf4llm.to_markdown("input.pdf", force_ocr=True, ocr_function=my_ocr_function, ...) .. include:: ../footer.rst ================================================ FILE: docs/pyodide.rst ================================================ .. include:: header.rst Pyodide ======= Overview -------- * `Pyodide `_ is a client-side Python implementation that runs in a web browser. * The Pyodide build of PyMuPDF is currently experimental. Building a PyMuPDF wheel for Pyodide ------------------------------------ A PyMuPDF wheel for Pyodide can be built by running `scripts/gh_release.py` with some environmental variable settings. This is regularly tested on Github by `.github/workflows/test_pyodide.yml`. Here is an example of this, a single Linux command (to be run with the current directory set to a PyMuPDF checkout), that builds a Pyodide wheel:: inputs_sdist=0 \ inputs_PYMUPDF_SETUP_MUPDF_BUILD="git:--recursive --depth 1 --shallow-submodules --branch master https://github.com/ArtifexSoftware/mupdf.git" \ inputs_wheels_default=0 \ inputs_wheels_linux_pyodide=1 \ ./scripts/gh_release.py build This does the following (all inside Python venv's): * Download (git clone and pip install) and customise a Pyodide build environment. * Download (git clone) the latest MuPDF. * Build MuPDF and PyMuPDF in the Pyodide build environment. * Create a wheel in `dist/`. For more information, see the comments for functions `build_pyodide_wheel()` and `pyodide_setup()` in `scripts/gh_release.py`. Using a Pyodide wheel --------------------- * Upload the wheel (for example `PyMuPDF/dist/PyMuPDF-1.24.2-cp311-cp311-emscripten_3_1_32_wasm32.whl`) to a webserver which has been configured to allow Cross-origin resource sharing (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing). * The wheel can be used in a Pyodide console running in a web browser, or a JupyterLite notebook running in a web browser. * To create a Pyodide console, go to: https://pyodide.org/en/stable/console.html * To create a JupyterLite notebook, go to: https://jupyterlite.readthedocs.io/en/latest/_static/lab/index.html * In both these cases, one can use the following code to download the wheel (replace `url` with the URL of the uploaded wheel) and import it:: import pyodide_js await pyodide_js.loadPackage(url) import pymupdf * Note that `micropip.install()` does not work, because of PyMuPDF's use of shared libraries. Loading a PDF document from a URL into PyMuPDF ---------------------------------------------- * Pyodide browser console does not have generic network access, so for example `urllib.request.urlopen(url)` fails. But Pyodide has a built-in `pyodide.http` module that uses javascript internally, which one can use to download into a `bytes` instance, which can be used to create a PyMuPDF `Document` instance:: import pyodide.http r = await pyodide.http.pyfetch('https://...') data = await r.bytes() doc = pymupdf.Document(stream=data) * It looks like this only works with `https://`, not `http://`. .. include:: footer.rst ================================================ FILE: docs/quad.rst ================================================ .. include:: header.rst .. _Quad: ========== Quad ========== Represents a four-sided mathematical shape (also called "quadrilateral" or "tetragon") in the plane, defined as a sequence of four :ref:`Point` objects ul, ur, ll, lr (conveniently called upper left, upper right, lower left, lower right). Quads can **be obtained** as results of text search methods (:meth:`Page.search_for`), and they **are used** to define text marker annotations (see e.g. :meth:`Page.add_squiggly_annot` and friends), and in several draw methods (like :meth:`Page.draw_quad` / :meth:`Shape.draw_quad`, :meth:`Page.draw_oval`/ :meth:`Shape.draw_quad`). .. note:: * If the corners of a rectangle are transformed with a **rotation**, **scale** or **translation** :ref:`Matrix`, then the resulting quad is **rectangular** (= congruent to a rectangle), i.e. all of its corners again enclose angles of 90 degrees. Property :attr:`Quad.is_rectangular` checks whether a quad can be thought of being the result of such an operation. * This is not true for all matrices: e.g. shear matrices produce parallelograms, and non-invertible matrices deliver "degenerate" tetragons like triangles or lines. * Attribute :attr:`Quad.rect` obtains the enveloping rectangle. Vice versa, rectangles now have attributes :attr:`Rect.quad`, resp. :attr:`IRect.quad` to obtain their respective tetragon versions. ============================= ======================================================= **Methods / Attributes** **Short Description** ============================= ======================================================= :meth:`Quad.transform` transform with a matrix :meth:`Quad.morph` transform with a point and matrix :attr:`Quad.ul` upper left point :attr:`Quad.ur` upper right point :attr:`Quad.ll` lower left point :attr:`Quad.lr` lower right point :attr:`Quad.is_convex` true if quad is a convex set :attr:`Quad.is_empty` true if quad is an empty set :attr:`Quad.is_rectangular` true if quad is congruent to a rectangle :attr:`Quad.rect` smallest containing :ref:`Rect` :attr:`Quad.width` the longest width value :attr:`Quad.height` the longest height value ============================= ======================================================= **Class API** .. class:: Quad .. method:: __init__(self) .. method:: __init__(self, ul, ur, ll, lr) .. method:: __init__(self, quad) .. method:: __init__(self, sequence) Overloaded constructors: "ul", "ur", "ll", "lr" stand for :data:`point_like` objects (the four corners), "sequence" is a Python sequence with four :data:`point_like` objects. If "quad" is specified, the constructor creates a **new copy** of it. Without parameters, a quad consisting of 4 copies of *Point(0, 0)* is created. .. method:: transform(matrix) Modify the quadrilateral by transforming each of its corners with a matrix. :arg matrix_like matrix: the matrix. .. method:: morph(fixpoint, matrix) *(New in version 1.17.0)* "Morph" the quad with a matrix-like using a point-like as fixed point. :arg point_like fixpoint: the point. :arg matrix_like matrix: the matrix. :returns: a new quad (no operation if this is the infinite quad). .. attribute:: rect The smallest rectangle containing the quad, represented by the blue area in the following picture. .. image:: images/img-quads.* :type: :ref:`Rect` .. attribute:: ul Upper left point. :type: :ref:`Point` .. attribute:: ur Upper right point. :type: :ref:`Point` .. attribute:: ll Lower left point. :type: :ref:`Point` .. attribute:: lr Lower right point. :type: :ref:`Point` .. attribute:: is_convex * New in version 1.16.1 Checks if for any two points of the quad, all points on their connecting line also belong to the quad. .. image:: images/img-convexity.* :scale: 30 :type: bool .. attribute:: is_empty True if enclosed area is zero, which means that at least three of the four corners are on the same line. If this is false, the quad may still be degenerate or not look like a tetragon at all (triangles, parallelograms, trapezoids, ...). :type: bool .. attribute:: is_rectangular True if all corner angles are 90 degrees. This implies that the quad is **convex and not empty**. :type: bool .. attribute:: width The maximum length of the top and the bottom side. :type: float .. attribute:: height The maximum length of the left and the right side. :type: float Remark ------ This class adheres to the sequence protocol, so components can be dealt with via their indices, too. Also refer to :ref:`SequenceTypes`. Algebra and Containment Checks ------------------------------- Starting with v1.19.6, quads can be used in algebraic expressions like the other geometry object -- the respective restrictions have been lifted. In particular, all the following combinations of containment checking are now possible: `{Point | IRect | Rect | Quad} in {IRect | Rect | Quad}` Please note the following interesting detail: For a rectangle, only its top-left point belongs to it. Since v1.19.0, rectangles are defined to be "open", such that its bottom and its right edge do not belong to it -- including the respective corners. But for quads there exists no such notion like "openness", so we have the following somewhat surprising implication: >>> rect.br in rect False >>> # but: >>> rect.br in rect.quad True .. include:: footer.rst ================================================ FILE: docs/rag.rst ================================================ .. include:: header.rst PyMuPDF, LLM & RAG ============================ Integrating |PyMuPDF| into your :title:`Large Language Model (LLM)` framework and overall :title:`RAG (Retrieval-Augmented Generation`) solution provides the fastest and most reliable way to deliver document data. There are a few well known :title:`LLM` solutions which have their own interfaces with |PyMuPDF| - it is a fast growing area, so please let us know if you discover any more! If you need to export to :title:`Markdown` or obtain a :title:`LlamaIndex` Document from a file: .. raw:: html

Integration with :title:`LangChain` ------------------------------------- It is simple to integrate directly with :title:`LangChain` by using their dedicated loader as follows: .. code-block:: python from langchain_community.document_loaders import PyMuPDFLoader loader = PyMuPDFLoader("example.pdf") data = loader.load() See `LangChain Using PyMuPDF `_ for full details. Integration with :title:`LlamaIndex` --------------------------------------- Use the dedicated `PyMuPDFReader` from :title:`LlamaIndex` 🦙 to manage your document loading. .. code-block:: python from llama_index.readers.file import PyMuPDFReader loader = PyMuPDFReader() documents = loader.load(file_path="example.pdf") See `Building RAG from Scratch `_ for more. Preparing Data for Chunking ----------------------------- Chunking (or splitting) data is essential to give context to your :title:`LLM` data and with :title:`Markdown` output now supported by |PyMuPDF| this means that `Level 3 chunking `_ is supported. .. _rag_outputting_as_md: Outputting as :title:`Markdown` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In order to export your document in :title:`Markdown` format you will need a separate helper. Package :doc:`pymupdf4llm/index` is a high-level wrapper of |PyMuPDF| functions which for each page outputs standard and table text in an integrated Markdown-formatted string across all document pages: .. code-block:: python # convert the document to markdown import pymupdf4llm md_text = pymupdf4llm.to_markdown("input.pdf") # Write the text to some file in UTF8-encoding import pathlib pathlib.Path("output.md").write_bytes(md_text.encode()) For further information please refer to: :doc:`pymupdf4llm/index`. How to use :title:`Markdown` output ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Once you have your data in :title:`Markdown` format you are ready to chunk/split it and supply it to your :title:`LLM`, for example, if this is :title:`LangChain` then do the following: .. code-block:: python import pymupdf4llm from langchain.text_splitter import MarkdownTextSplitter # Get the MD text md_text = pymupdf4llm.to_markdown("input.pdf") # get markdown for all pages splitter = MarkdownTextSplitter(chunk_size=40, chunk_overlap=0) splitter.create_documents([md_text]) For more see `5 Levels of Text Splitting `_ Related Blogs -------------------- To find out more about |PyMuPDF|, :title:`LLM` & :title:`RAG` check out our blogs for implementations & tutorials. Methodologies to Extract Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - `Enhanced Text Extraction `_ - `Conversion to Markdown Text with PyMuPDF `_ Create a Chatbot to discuss your documents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - `Make a simple command line Chatbot `_ - `Make a Chatbot GUI `_ .. include:: footer.rst ================================================ FILE: docs/recipes-annotations.rst ================================================ .. include:: header.rst .. _RecipesAnnotations: ============================== Annotations ============================== .. _RecipesAnnotations_A: How to Add and Modify Annotations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In |PyMuPDF|, new annotations can be added via :ref:`Page` methods. Once an annotation exists, it can be modified to a large extent using methods of the :ref:`Annot` class. Annotations can **only** be inserted in |PDF| pages - other document types do not support annotation insertion. In contrast to many other tools, initial insert of annotations happens with a minimum number of properties. We leave it to the programmer to e.g. set attributes like author, creation date or subject. As an overview for these capabilities, look at the following script that fills a PDF page with most of the available annotations. Look in the next sections for more special situations: .. literalinclude:: samples/new-annots.py :language: python This script should lead to the following output: .. image:: images/img-annots.* :scale: 80 ------------------------------ .. _RecipesAnnotations_B: How to Use FreeText ~~~~~~~~~~~~~~~~~~~~~ This script shows a couple of basic ways to deal with 'FreeText' annotations: .. literalinclude:: samples/annotations-freetext1.py The result looks like this: .. image:: images/img-freetext1.* :scale: 80 Here is an example for using rich text and call-out lines: .. literalinclude:: samples/annotations-freetext2.py The result looks like this: .. image:: images/img-freetext2.* :scale: 80 ------------------------------ .. _RecipesAnnotations_C: How to Use Ink Annotations ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Ink annotations are used to contain freehand scribbling. A typical example may be an image of your signature consisting of first name and last name. Technically an ink annotation is implemented as a **list of lists of points**. Each point list is regarded as a continuous line connecting the points. Different point lists represent independent line segments of the annotation. The following script creates an ink annotation with two mathematical curves (sine and cosine function graphs) as line segments: .. literalinclude:: samples/annotations-ink.py This is the result: .. image:: images/img-inkannot.* :scale: 50 .. include:: footer.rst ================================================ FILE: docs/recipes-common-issues-and-their-solutions.rst ================================================ .. include:: header.rst .. _RecipesCommonIssuesAndTheirSolutions: ========================================== Common Issues and their Solutions ========================================== How To Dynamically Clean Up Corrupt :title:`PDFs` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This shows a potential use of |PyMuPDF| with another Python PDF library (the excellent pure Python package `pdfrw `_ is used here as an example). If a clean, non-corrupt / decompressed PDF is needed, one could dynamically invoke PyMuPDF to recover from many problems like so:: import sys from io import BytesIO from pdfrw import PdfReader import pymupdf #--------------------------------------- # 'Tolerant' PDF reader #--------------------------------------- def reader(fname, password = None): idata = open(fname, "rb").read() # read the PDF into memory and ibuffer = BytesIO(idata) # convert to stream if password is None: try: return PdfReader(ibuffer) # if this works: fine! except: pass # either we need a password or it is a problem-PDF # create a repaired / decompressed / decrypted version doc = pymupdf.open("pdf", ibuffer) if password is not None: # decrypt if password provided rc = doc.authenticate(password) if not rc > 0: raise ValueError("wrong password") c = doc.tobytes(garbage=3, deflate=True) del doc # close & delete doc return PdfReader(BytesIO(c)) # let pdfrw retry #--------------------------------------- # Main program #--------------------------------------- pdf = reader("pymupdf.pdf", password = None) # include a password if necessary print pdf.Info # do further processing With the command line utility *pdftk* (`available `_ for Windows only, but reported to also run under `Wine `_) a similar result can be achieved, see `here `_. However, you must invoke it as a separate process via *subprocess.Popen*, using stdin and stdout as communication vehicles. How to Convert Any Document to |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Here is a script that converts any |PyMuPDF| :ref:`supported document` to a |PDF|. These include XPS, EPUB, FB2, CBZ and image formats, including multi-page TIFF images. It features maintaining any metadata, table of contents and links contained in the source document:: """ Demo script: Convert input file to a PDF ----------------------------------------- Intended for multi-page input files like XPS, EPUB etc. Features: --------- Recovery of table of contents and links of input file. While this works well for bookmarks (outlines, table of contents), links will only work if they are not of type "LINK_NAMED". This link type is skipped by the script. For XPS and EPUB input, internal links however **are** of type "LINK_NAMED". Base library MuPDF does not resolve them to page numbers. So, for anyone expert enough to know the internal structure of these document types, can further interpret and resolve these link types. Dependencies -------------- PyMuPDF v1.14.0+ """ import sys import pymupdf if not (list(map(int, pymupdf.VersionBind.split("."))) >= [1,14,0]): raise SystemExit("need PyMuPDF v1.14.0+") fn = sys.argv[1] print(f"Converting '{fn}' to '{fn}.pdf'") doc = pymupdf.open(fn) b = doc.convert_to_pdf() # convert to pdf pdf = pymupdf.open("pdf", b) # open as pdf toc= doc.get_toc() # table of contents of input pdf.set_toc(toc) # simply set it for output meta = doc.metadata # read and set metadata if not meta["producer"]: meta["producer"] = "PyMuPDF v" + pymupdf.VersionBind if not meta["creator"]: meta["creator"] = "PyMuPDF PDF converter" meta["modDate"] = pymupdf.get_pdf_now() meta["creationDate"] = meta["modDate"] pdf.set_metadata(meta) # now process the links link_cnti = 0 link_skip = 0 for pinput in doc: # iterate through input pages links = pinput.get_links() # get list of links link_cnti += len(links) # count how many pout = pdf[pinput.number] # read corresp. output page for l in links: # iterate though the links if l["kind"] == pymupdf.LINK_NAMED: # we do not handle named links print("named link page", pinput.number, l) link_skip += 1 # count them continue pout.insert_link(l) # simply output the others # save the conversion result pdf.save(fn + ".pdf", garbage=4, deflate=True) # say how many named links we skipped if link_cnti > 0: print(f"Skipped {link_skip} named links of a total of {link_cnti} in input.") Changing Annotations: Unexpected Behaviour ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Problem ^^^^^^^^^ There are two scenarios: 1. **Updating** an annotation with PyMuPDF which was created by some other software. 2. **Creating** an annotation with PyMuPDF and later changing it with some other software. In both cases you may experience unintended changes, like a different annotation icon or text font, the fill color or line dashing have disappeared, line end symbols have changed their size or even have disappeared too, etc. Cause ^^^^^^ Annotation maintenance is handled differently by each PDF maintenance application. Some annotation types may not be supported, or not be supported fully or some details may be handled in a different way than in another application. **There is no standard.** Almost always a PDF application also comes with its own icons (file attachments, sticky notes and stamps) and its own set of supported text fonts. For example: * (Py-) MuPDF only supports these 5 basic fonts for 'FreeText' annotations: Helvetica, Times-Roman, Courier, ZapfDingbats and Symbol -- no italics / no bold variations. When changing a 'FreeText' annotation created by some other app, its font will probably not be recognized nor accepted and be replaced by Helvetica. * PyMuPDF supports all PDF text markers (highlight, underline, strikeout, squiggly), but these types cannot be updated with Adobe Acrobat Reader. In most cases there also exists limited support for line dashing which causes existing dashes to be replaced by straight lines. For example: * PyMuPDF fully supports all line dashing forms, while other viewers only accept a limited subset. Solutions ^^^^^^^^^^ Unfortunately there is not much you can do in most of these cases. 1. Stay with the same software for **creating and changing** an annotation. 2. When using PyMuPDF to change an "alien" annotation, try to **avoid** :meth:`Annot.update`. The following methods **can be used without it,** so that the original appearance should be maintained: * :meth:`Annot.set_rect` (location changes) * :meth:`Annot.set_flags` (annotation behaviour) * :meth:`Annot.set_info` (meta information, except changes to *content*) * :meth:`Annot.set_popup` (create popup or change its rect) * :meth:`Annot.set_oc` (add / remove reference to optional content information) * :meth:`Annot.set_open` * :meth:`Annot.update_file` (file attachment changes) Missing or Unreadable Extracted Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Fairly often, text extraction does not work text as you would expect: text may be missing, or may not appear in the reading sequence visible on your screen, or contain garbled characters (like a ? or a "TOFU" symbol), etc. This can be caused by a number of different problems. Problem: no text is extracted ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Your PDF viewer does display text, but you cannot select it with your cursor, and text extraction delivers nothing. Cause ^^^^^^ 1. You may be looking at an image embedded in the PDF page (e.g. a scanned PDF). 2. The PDF creator used no font, but **simulated** text by painting it, using little lines and curves. E.g. a capital "D" could be painted by a line "|" and a left-open semi-circle, an "o" by an ellipse, and so on. Solution ^^^^^^^^^^ Use an OCR software like `OCRmyPDF `_ to insert a hidden text layer underneath the visible page. The resulting PDF should behave as expected. Problem: unreadable text ^^^^^^^^^^^^^^^^^^^^^^^^ Text extraction does not deliver the text in readable order, duplicates some text, or is otherwise garbled. Cause ^^^^^^ 1. The single characters are readable as such (no "" symbols), but the sequence in which the text is **coded in the file** deviates from the reading order. The motivation behind may be technical or protection of data against unwanted copies. 2. Many "" symbols occur, indicating MuPDF could not interpret these characters. The font may indeed be unsupported by MuPDF, or the PDF creator may haved used a font that displays readable text, but on purpose obfuscates the originating corresponding unicode character. Solution ^^^^^^^^ 1. Use layout preserving text extraction: `python -m fitz gettext file.pdf`. 2. If other text extraction tools also don't work, then the only solution again is OCRing the page. .. include:: footer.rst ================================================ FILE: docs/recipes-drawing-and-graphics.rst ================================================ .. include:: header.rst .. _RecipesDrawingAndGraphics: ============================== Drawing and Graphics ============================== .. note:: When the terms "Drawings" or "Graphics" are mentioned here we are referring to "Vector Graphics" or "Line Art". Therefore please consider these terms as being synonymous! PDF files support elementary drawing operations as part of their syntax. These are **vector graphics** and include basic geometrical objects like lines, curves, circles, rectangles including specifying colors. The syntax for such operations is defined in "A Operator Summary" on page 643 of the :ref:`AdobeManual`. Specifying these operators for a PDF page happens in its :data:`contents` objects. |PyMuPDF| implements a large part of the available features via its :ref:`Shape` class, which is comparable to notions like "canvas" in other packages (e.g. `reportlab `_). A shape is always created as a **child of a page**, usually with an instruction like `shape = page.new_shape()`. The class defines numerous methods that perform drawing operations on the page's area. For example, `last_point = shape.draw_rect(rect)` draws a rectangle along the borders of a suitably defined `rect = pymupdf.Rect(...)`. The returned *last_point* **always** is the :ref:`Point` where drawing operation ended ("last point"). Every such elementary drawing requires a subsequent :meth:`Shape.finish` to "close" it, but there may be multiple drawings which have one common ``finish()`` method. In fact, :meth:`Shape.finish` *defines* a group of preceding draw operations to form one -- potentially rather complex -- graphics object. |PyMuPDF| provides several predefined graphics in `shapes_and_symbols.py `_ which demonstrate how this works. If you import this script, you can also directly use its graphics as in the following example:: # -*- coding: utf-8 -*- """ Created on Sun Dec 9 08:34:06 2018 @author: Jorj @license: GNU AFFERO GPL V3 Create a list of available symbols defined in shapes_and_symbols.py This also demonstrates an example usage: how these symbols could be used as bullet-point symbols in some text. """ import pymupdf import shapes_and_symbols as sas # list of available symbol functions and their descriptions tlist = [ (sas.arrow, "arrow (easy)"), (sas.caro, "caro (easy)"), (sas.clover, "clover (easy)"), (sas.diamond, "diamond (easy)"), (sas.dontenter, "do not enter (medium)"), (sas.frowney, "frowney (medium)"), (sas.hand, "hand (complex)"), (sas.heart, "heart (easy)"), (sas.pencil, "pencil (very complex)"), (sas.smiley, "smiley (easy)"), ] r = pymupdf.Rect(50, 50, 100, 100) # first rect to contain a symbol d = pymupdf.Rect(0, r.height + 10, 0, r.height + 10) # displacement to next rect p = (15, -r.height * 0.2) # starting point of explanation text rlist = [r] # rectangle list for i in range(1, len(tlist)): # fill in all the rectangles rlist.append(rlist[i-1] + d) doc = pymupdf.open() # create empty PDF page = doc.new_page() # create an empty page shape = page.new_shape() # start a Shape (canvas) for i, r in enumerate(rlist): tlist[i][0](shape, rlist[i]) # execute symbol creation shape.insert_text(rlist[i].br + p, # insert description text tlist[i][1], fontsize=r.height/1.2) # store everything to the page's /Contents object shape.commit() import os scriptdir = os.path.dirname(__file__) doc.save(os.path.join(scriptdir, "symbol-list.pdf")) # save the PDF This is the script's outcome: .. image:: images/img-symbols.* :scale: 50 ------------------------------ .. _RecipesDrawingAndGraphics_Extract_Drawings: How to Extract Drawings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * New in v1.18.0 Drawing commands (**vector graphics**) issued by a page can be extracted as a list of dictionaries. Interestingly, this is possible for :ref:`all supported document types` -- not just PDF: so you can use it for XPS, EPUB and others as well. Page method, :meth:`Page.get_drawings()` accesses draw commands and converts them into a list of Python dictionaries. Each dictionary -- called a "path" -- represents a separate drawing -- it may be simple like a single line, or a complex combination of lines and curves representing one of the shapes of the previous section. The *path* dictionary has been designed such that it can easily be used by the :ref:`Shape` class and its methods. Here is an example for a page with one path, that draws a red-bordered yellow circle inside rectangle `Rect(100, 100, 200, 200)`:: >>> pprint(page.get_drawings()) [{'closePath': True, 'color': [1.0, 0.0, 0.0], 'dashes': '[] 0', 'even_odd': False, 'fill': [1.0, 1.0, 0.0], 'items': [('c', Point(100.0, 150.0), Point(100.0, 177.614013671875), Point(122.38600158691406, 200.0), Point(150.0, 200.0)), ('c', Point(150.0, 200.0), Point(177.61399841308594, 200.0), Point(200.0, 177.614013671875), Point(200.0, 150.0)), ('c', Point(200.0, 150.0), Point(200.0, 122.385986328125), Point(177.61399841308594, 100.0), Point(150.0, 100.0)), ('c', Point(150.0, 100.0), Point(122.38600158691406, 100.0), Point(100.0, 122.385986328125), Point(100.0, 150.0))], 'lineCap': (0, 0, 0), 'lineJoin': 0, 'opacity': 1.0, 'rect': Rect(100.0, 100.0, 200.0, 200.0), 'width': 1.0}] >>> .. note:: You need (at least) 4 Bézier curves (of 3rd order) to draw a circle with acceptable precision. See this `Wikipedia article `_ for some background. The following is a code snippet which extracts the drawings of a page and re-draws them on a new page:: import pymupdf doc = pymupdf.open("some.file") page = doc[0] paths = page.get_drawings() # extract existing drawings # this is a list of "paths", which can directly be drawn again using Shape # ------------------------------------------------------------------------- # # define some output page with the same dimensions outpdf = pymupdf.open() outpage = outpdf.new_page(width=page.rect.width, height=page.rect.height) shape = outpage.new_shape() # make a drawing canvas for the output page # -------------------------------------- # loop through the paths and draw them # -------------------------------------- for path in paths: # ------------------------------------ # draw each entry of the 'items' list # ------------------------------------ for item in path["items"]: # these are the draw commands if item[0] == "l": # line shape.draw_line(item[1], item[2]) elif item[0] == "re": # rectangle shape.draw_rect(item[1]) elif item[0] == "qu": # quad shape.draw_quad(item[1]) elif item[0] == "c": # curve shape.draw_bezier(item[1], item[2], item[3], item[4]) else: raise ValueError("unhandled drawing", item) # ------------------------------------------------------ # all items are drawn, now apply the common properties # to finish the path # ------------------------------------------------------ shape.finish( fill=path["fill"], # fill color color=path["color"], # line color dashes=path["dashes"], # line dashing even_odd=path.get("even_odd", True), # control color of overlaps closePath=path["closePath"], # whether to connect last and first point lineJoin=path["lineJoin"], # how line joins should look like lineCap=max(path["lineCap"]), # how line ends should look like width=path["width"], # line width stroke_opacity=path.get("stroke_opacity", 1), # same value for both fill_opacity=path.get("fill_opacity", 1), # opacity parameters ) # all paths processed - commit the shape to its page shape.commit() outpdf.save("drawings-page-0.pdf") As can be seen, there is a high congruence level with the :ref:`Shape` class. With one exception: For technical reasons `lineCap` is a tuple of 3 numbers here, whereas it is an integer in :ref:`Shape` (and in PDF). So we simply take the maximum value of that tuple. Here is a comparison between input and output of an example page, created by the previous script: .. image:: images/img-getdrawings.png :scale: 50 .. note:: The reconstruction of graphics, like shown here, is not perfect. The following aspects will not be reproduced as of this version: * Page definitions can be complex and include instructions for not showing / hiding certain areas to keep them invisible. Things like this are ignored by :meth:`Page.get_drawings` - it will always return all paths. .. note:: You can use the path list to make your own lists of e.g. all lines or all rectangles on the page and subselect them by criteria, like color or position on the page etc. .. _RecipesDrawingAndGraphics_Delete_Drawings: How to Delete Drawings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To delete drawings/vector graphics we must use a :ref:`Redaction Annotation ` with the bounding box of the drawing and then **add and apply** a redaction to it to delete it. The following code shows an example of deleting the first drawing found on the page:: paths = page.get_drawings() rect = paths[0]["rect"] # rectangle of the 1st drawing page.add_redact_annot(rect) page.apply_redactions(0,2,1) # potentially set options for any of images, drawings, text .. note:: See :meth:`Page.apply_redactions` for the parameter options which can be sent - you are able to apply deletion options to image, drawing and text objects which are bound by the annotation area. How to Draw Graphics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Drawing graphics is as simple as calling the type of :meth:`Drawing Method ` you may want. You can draw graphics directly on pages or within shape objects. For example, to draw a circle:: # Draw a circle on the page using the Page method page.draw_circle((center_x, center_y), radius, color=(1, 0, 0), width=2) # Draw a circle on the page using a Shape object shape = page.new_shape() shape.draw_circle((center_x, center_y), radius) shape.finish(color=(1, 0, 0), width=2) shape.commit(overlay=True) The :ref:`Shape` object can be used to combine multiple drawings that should receive common properties as specified by :meth:`Shape.finish`. .. include:: footer.rst ================================================ FILE: docs/recipes-images.rst ================================================ .. include:: header.rst .. _RecipesImages: ============================== Images ============================== .. _RecipesImages_A: How to Make Images from Document Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This little script will take a document filename and generate a PNG file from each of its pages. The document can be any :ref:`supported type`. The script works as a command line tool which expects the filename being supplied as a parameter. The generated image files (1 per page) are stored in the directory of the script:: import sys, pymupdf # import the bindings fname = sys.argv[1] # get filename from command line doc = pymupdf.open(fname) # open document for page in doc: # iterate through the pages pix = page.get_pixmap() # render page to an image pix.save(f"page-{page.number}.png") # store image as a PNG The script directory will now contain PNG image files named *page-0.png*, *page-1.png*, etc. Pictures have the dimension of their pages with width and height rounded to integers, e.g. 595 x 842 pixels for an A4 portrait sized page. They will have a resolution of 96 dpi in x and y dimension and have no transparency. You can change all that -- for how to do this, read the next sections. ---------- .. _RecipesImages_B: How to Increase :index:`Image Resolution ` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The image of a document page is represented by a :ref:`Pixmap`, and the simplest way to create a pixmap is via method :meth:`Page.get_pixmap`. This method has many options to influence the result. The most important among them is the :ref:`Matrix`, which lets you :index:`zoom`, rotate, distort or mirror the outcome. :meth:`Page.get_pixmap` by default will use the :ref:`Identity` matrix, which does nothing. In the following, we apply a :index:`zoom factor ` of 2 to each dimension, which will generate an image with a four times better resolution for us (and also about 4 times the size):: zoom_x = 2.0 # horizontal zoom zoom_y = 2.0 # vertical zoom mat = pymupdf.Matrix(zoom_x, zoom_y) # zoom factor 2 in each dimension pix = page.get_pixmap(matrix=mat) # use 'mat' instead of the identity matrix Since version 1.19.2 there is a more direct way to set the resolution: Parameter `"dpi"` (dots per inch) can be used in place of `"matrix"`. To create a 300 dpi image of a page specify `pix = page.get_pixmap(dpi=300)`. Apart from notation brevity, this approach has the additional advantage that the **dpi value is saved with the image** file -- which does not happen automatically when using the Matrix notation. ---------- .. _RecipesImages_C: How to Create :index:`Partial Pixmaps` (Clips) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You do not always need or want the full image of a page. This is the case e.g. when you display the image in a GUI and would like to fill the respective window with a zoomed part of the page. Let's assume your GUI window has room to display a full document page, but you now want to fill this room with the bottom right quarter of your page, thus using a four times better resolution. To achieve this, define a rectangle equal to the area you want to appear in the GUI and call it "clip". One way of constructing rectangles in PyMuPDF is by providing two diagonally opposite corners, which is what we are doing here. .. image:: images/img-clip.* :width: 50% :: mat = pymupdf.Matrix(2, 2) # zoom factor 2 in each direction rect = page.rect # the page rectangle mp = (rect.tl + rect.br) / 2 # its middle point, becomes top-left of clip clip = pymupdf.Rect(mp, rect.br) # the area we want pix = page.get_pixmap(matrix=mat, clip=clip) In the above we construct *clip* by specifying two diagonally opposite points: the middle point *mp* of the page rectangle, and its bottom right, *rect.br*. ---------- .. _RecipesImages_D: How to Zoom a Clip to a GUI Window ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Please also read the previous section. This time we want to **compute the zoom factor** for a clip, such that its image best fits a given GUI window. This means, that the image's width or height (or both) will equal the window dimension. For the following code snippet you need to provide the WIDTH and HEIGHT of your GUI's window that should receive the page's clip rectangle. :: # WIDTH: width of the GUI window # HEIGHT: height of the GUI window # clip: a subrectangle of the document page # compare width/height ratios of image and window if clip.width / clip.height < WIDTH / HEIGHT: # clip is narrower: zoom to window HEIGHT zoom = HEIGHT / clip.height else: # clip is broader: zoom to window WIDTH zoom = WIDTH / clip.width mat = pymupdf.Matrix(zoom, zoom) pix = page.get_pixmap(matrix=mat, clip=clip) For the other way round, now assume you **have** the zoom factor and need to **compute the fitting clip**. In this case we have `zoom = HEIGHT/clip.height = WIDTH/clip.width`, so we must set `clip.height = HEIGHT/zoom` and, `clip.width = WIDTH/zoom`. Choose the top-left point `tl` of the clip on the page to compute the right pixmap:: width = WIDTH / zoom height = HEIGHT / zoom clip = pymupdf.Rect(tl, tl.x + width, tl.y + height) # ensure we still are inside the page clip &= page.rect mat = pymupdf.Matrix(zoom, zoom) pix = pymupdf.Pixmap(matrix=mat, clip=clip) ---------- .. _RecipesImages_E: How to Create or Suppress Annotation Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Normally, the pixmap of a page also shows the page's annotations. Occasionally, this may not be desirable. To suppress the annotation images on a rendered page, just specify `annots=False` in :meth:`Page.get_pixmap`. You can also render annotations separately: they have their own :meth:`Annot.get_pixmap` method. The resulting pixmap has the same dimensions as the annotation rectangle. ---------- .. index:: triple: extract;image;non-PDF pair: convert_to_pdf;examples .. _RecipesImages_F: How to Extract Images: Non-PDF Documents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In contrast to the previous sections, this section deals with **extracting** images **contained** in documents, so they can be displayed as part of one or more pages. If you want to recreate the original image in file form or as a memory area, you have basically two options: 1. Convert your document to a PDF, and then use one of the PDF-only extraction methods. This snippet will convert a document to PDF:: >>> pdfbytes = doc.convert_to_pdf() # this a bytes object >>> pdf = pymupdf.open("pdf", pdfbytes) # open it as a PDF document >>> # now use 'pdf' like any PDF document 2. Use :meth:`Page.get_text` with the "dict" parameter. This works for all document types. It will extract all text and images shown on the page, formatted as a Python dictionary. Every image will occur in an image block, containing meta information and **the binary image data**. For details of the dictionary's structure, see :ref:`TextPage`. The method works equally well for PDF files. This creates a list of all images shown on a page:: >>> d = page.get_text("dict") >>> blocks = d["blocks"] # the list of block dictionaries >>> imgblocks = [b for b in blocks if b["type"] == 1] >>> pprint(imgblocks[0]) {'bbox': (100.0, 135.8769989013672, 300.0, 364.1230163574219), 'bpc': 8, 'colorspace': 3, 'ext': 'jpeg', 'height': 501, 'image': b'\xff\xd8\xff\xe0\x00\x10JFIF\...', # CAUTION: LARGE! 'size': 80518, 'transform': (200.0, 0.0, -0.0, 228.2460174560547, 100.0, 135.8769989013672), 'type': 1, 'width': 439, 'xres': 96, 'yres': 96} ---------- .. index:: triple: extract;image;PDF pair: extract_image;examples .. _RecipesImages_G: How to Extract Images: PDF Documents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Like any other "object" in a PDF, images are identified by a cross reference number (:data:`xref`, an integer). If you know this number, you have two ways to access the image's data: 1. **Create** a :ref:`Pixmap` of the image with instruction *pix = pymupdf.Pixmap(doc, xref)*. This method is **very** fast (single digit micro-seconds). The pixmap's properties (width, height, ...) will reflect the ones of the image. In this case there is no way to tell which image format the embedded original has. 2. **Extract** the image with *img = doc.extract_image(xref)*. This is a dictionary containing the binary image data as *img["image"]*. A number of meta data are also provided -- mostly the same as you would find in the pixmap of the image. The major difference is string *img["ext"]*, which specifies the image format: apart from "png", strings like "jpeg", "bmp", "tiff", etc. can also occur. Use this string as the file extension if you want to store to disk. The execution speed of this method should be compared to the combined speed of the statements *pix = pymupdf.Pixmap(doc, xref);pix.tobytes()*. If the embedded image is in PNG format, the speed of :meth:`Document.extract_image` is about the same (and the binary image data are identical). Otherwise, this method is **thousands of times faster**, and the **image data is much smaller**. The question remains: **"How do I know those 'xref' numbers of images?"**. There are two answers to this: a. **"Inspect the page objects:"** Loop through the items of :meth:`Page.get_images`. It is a list of list, and its items look like *[xref, smask, ...]*, containing the :data:`xref` of an image. This :data:`xref` can then be used with one of the above methods. Use this method for **valid (undamaged)** documents. Be wary however, that the same image may be referenced multiple times (by different pages), so you might want to provide a mechanism avoiding multiple extracts. b. **"No need to know:"** Loop through the list of **all xrefs** of the document and perform a :meth:`Document.extract_image` for each one. If the returned dictionary is empty, then continue -- this :data:`xref` is no image. Use this method if the PDF is **damaged (unusable pages)**. Note that a PDF often contains "pseudo-images" ("stencil masks") with the special purpose of defining the transparency of some other image. You may want to provide logic to exclude those from extraction. Also have a look at the next section. For both extraction approaches, there exist ready-to-use general purpose scripts: `extract-from-pages.py `_ extracts images page by page: .. image:: images/img-extract-imga.* :scale: 80 and `extract-from-xref.py `_ extracts images by xref table: .. image:: images/img-extract-imgb.* :scale: 80 ---------- .. _RecipesImages_H: How to Handle Image Masks ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Some images in PDFs are accompanied by **image masks**. In their simplest form, masks represent alpha (transparency) bytes stored as separate images. In order to reconstruct the original of an image, which has a mask, it must be "enriched" with transparency bytes taken from its mask. Whether an image does have such a mask can be recognized in one of two ways in PyMuPDF: 1. An item of :meth:`Document.get_page_images` has the general format `(xref, smask, ...)`, where :data:`xref` is the image's :data:`xref` and *smask*, if positive, then it is the :data:`xref` of a mask. 2. The (dictionary) results of :meth:`Document.extract_image` have a key *"smask"*, which also contains any mask's :data:`xref` if positive. If *smask == 0* then the image encountered via :data:`xref` can be processed as it is. To recover the original image using PyMuPDF, the procedure depicted as follows must be executed: .. image:: images/img-stencil.* :scale: 60 >>> pix1 = pymupdf.Pixmap(doc.extract_image(xref)["image"]) # (1) pixmap of image w/o alpha >>> mask = pymupdf.Pixmap(doc.extract_image(smask)["image"]) # (2) mask pixmap >>> pix = pymupdf.Pixmap(pix1, mask) # (3) copy of pix1, image mask added Step (1) creates a pixmap of the basic image. Step (2) does the same with the image mask. Step (3) adds an alpha channel and fills it with transparency information. The scripts `extract-from-pages.py `_, and `extract-from-xref.py `_ above also contain this logic. ---------- .. index:: triple: picture;embed;PDF pair: show_pdf_page;examples pair: insert_image;examples pair: embfile_add;examples pair: add_file_annot;examples .. _RecipesImages_I: How to Make one PDF of all your Pictures (or Files) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ We show here **three scripts** that take a list of (image and other) files and put them all in one PDF. **Method 1: Inserting Images as Pages** The first one converts each image to a PDF page with the same dimensions. The result will be a PDF with one page per image. It will only work for :ref:`supported image` file formats:: import os, pymupdf import PySimpleGUI as psg # for showing a progress bar doc = pymupdf.open() # PDF with the pictures imgdir = "D:/2012_10_05" # where the pics are imglist = os.listdir(imgdir) # list of them imgcount = len(imglist) # pic count for i, f in enumerate(imglist): img = pymupdf.open(os.path.join(imgdir, f)) # open pic as document rect = img[0].rect # pic dimension pdfbytes = img.convert_to_pdf() # make a PDF stream img.close() # no longer needed imgPDF = pymupdf.open("pdf", pdfbytes) # open stream as PDF page = doc.new_page(width = rect.width, # new page with ... height = rect.height) # pic dimension page.show_pdf_page(rect, imgPDF, 0) # image fills the page psg.EasyProgressMeter("Import Images", # show our progress i+1, imgcount) doc.save("all-my-pics.pdf") This will generate a PDF only marginally larger than the combined pictures' size. Some numbers on performance: The above script needed about 1 minute on my machine for 149 pictures with a total size of 514 MB (and about the same resulting PDF size). .. image:: images/img-import-progress.* :scale: 80 Look `here `_ for a more complete source code: it offers a directory selection dialog and skips unsupported files and non-file entries. .. note:: We might have used :meth:`Page.insert_image` instead of :meth:`Page.show_pdf_page`, and the result would have been a similar looking file. However, depending on the image type, it may store **images uncompressed**. Therefore, the save option *deflate = True* must be used to achieve a reasonable file size, which hugely increases the runtime for large numbers of images. So this alternative **cannot be recommended** here. **Method 2: Embedding Files** The second script **embeds** arbitrary files -- not only images. The resulting PDF will have just one (empty) page, required for technical reasons. To later access the embedded files again, you would need a suitable PDF viewer that can display and / or extract embedded files:: import os, pymupdf import PySimpleGUI as psg # for showing progress bar doc = pymupdf.open() # PDF with the pictures imgdir = "D:/2012_10_05" # where my files are imglist = os.listdir(imgdir) # list of pictures imgcount = len(imglist) # pic count imglist.sort() # nicely sort them for i, f in enumerate(imglist): img = open(os.path.join(imgdir,f), "rb").read() # make pic stream doc.embfile_add(img, f, filename=f, # and embed it ufilename=f, desc=f) psg.EasyProgressMeter("Embedding Files", # show our progress i+1, imgcount) page = doc.new_page() # at least 1 page is needed doc.save("all-my-pics-embedded.pdf") .. image:: images/img-embed-progress.* :scale: 80 This is by far the fastest method, and it also produces the smallest possible output file size. The above pictures needed 20 seconds on my machine and yielded a PDF size of 510 MB. Look `here `_ for a more complete source code: it offers a directory selection dialog and skips non-file entries. **Method 3: Attaching Files** A third way to achieve this task is **attaching files** via page annotations see `here `_ for the complete source code. This has a similar performance as the previous script and it also produces a similar file size. It will produce PDF pages which show a 'FileAttachment' icon for each attached file. .. image:: images/img-attach-result.* .. note:: Both, the **embed** and the **attach** methods can be used for **arbitrary files** -- not just images. .. note:: We strongly recommend using the awesome package `PySimpleGUI `_ to display a progress meter for tasks that may run for an extended time span. It's pure Python, uses Tkinter (no additional GUI package) and requires just one more line of code! ---------- .. index:: triple: vector;image;SVG pair: show_pdf_page;examples pair: insert_image;examples pair: embfile_add;examples .. _RecipesImages_J: How to Create Vector Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The usual way to create an image from a document page is :meth:`Page.get_pixmap`. A pixmap represents a raster image, so you must decide on its quality (i.e. resolution) at creation time. It cannot be changed later. PyMuPDF also offers a way to create a **vector image** of a page in SVG format (scalable vector graphics, defined in XML syntax). SVG images remain precise across zooming levels (of course with the exception of any raster graphic elements embedded therein). Instruction *svg = page.get_svg_image(matrix=pymupdf.Identity)* delivers a UTF-8 string *svg* which can be stored with extension ".svg". ---------- .. index:: pair: save;examples pair: tobytes;examples pair: Photoshop;examples pair: Postscript;examples pair: JPEG;examples pair: PhotoImage;examples .. _RecipesImages_K: How to Convert Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Just as a feature among others, PyMuPDF's image conversion is easy. It may avoid using other graphics packages like PIL/Pillow in many cases. Notwithstanding that interfacing with Pillow is almost trivial. ================= ================== ========================================= **Input Formats** **Output Formats** **Description** ================= ================== ========================================= BMP . Windows Bitmap JPEG JPEG Joint Photographic Experts Group JXR . JPEG Extended Range JPX/JP2 . JPEG 2000 GIF . Graphics Interchange Format TIFF . Tagged Image File Format PNG PNG Portable Network Graphics PNM PNM Portable Anymap PGM PGM Portable Graymap PBM PBM Portable Bitmap PPM PPM Portable Pixmap PAM PAM Portable Arbitrary Map . PSD Adobe Photoshop Document . PS Adobe Postscript ================= ================== ========================================= The general scheme is just the following two lines:: pix = pymupdf.Pixmap("input.xxx") # any supported input format pix.save("output.yyy") # any supported output format **Remarks** 1. The **input** argument of *pymupdf.Pixmap(arg)* can be a file or a bytes / io.BytesIO object containing an image. 2. Instead of an output **file**, you can also create a bytes object via *pix.tobytes("yyy")* and pass this around. 3. As a matter of course, input and output formats must be compatible in terms of colorspace and transparency. The ``Pixmap`` class has batteries included if adjustments are needed. .. note:: **Convert JPEG to Photoshop**:: pix = pymupdf.Pixmap("myfamily.jpg") pix.save("myfamily.psd") .. note:: Convert **JPEG to Tkinter PhotoImage**. Any **RGB / no-alpha** image works exactly the same. Conversion to one of the **Portable Anymap** formats (PPM, PGM, etc.) does the trick, because they are supported by all Tkinter versions:: import tkinter as tk pix = pymupdf.Pixmap("input.jpg") # or any RGB / no-alpha image tkimg = tk.PhotoImage(data=pix.tobytes("ppm")) .. note:: Convert **PNG with alpha** to Tkinter PhotoImage. This requires **removing the alpha bytes**, before we can do the PPM conversion:: import tkinter as tk pix = pymupdf.Pixmap("input.png") # may have an alpha channel if pix.alpha: # we have an alpha channel! pix = pymupdf.Pixmap(pix, 0) # remove it tkimg = tk.PhotoImage(data=pix.tobytes("ppm")) ---------- .. index:: pair: copy;examples .. _RecipesImages_L: How to Use Pixmaps: Gluing Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This shows how pixmaps can be used for purely graphical, non-document purposes. The script reads an image file and creates a new image which consist of 3 * 4 tiles of the original:: import pymupdf src = pymupdf.Pixmap("img-7edges.png") # create pixmap from a picture col = 3 # tiles per row lin = 4 # tiles per column tar_w = src.width * col # width of target tar_h = src.height * lin # height of target # create target pixmap tar_pix = pymupdf.Pixmap(src.colorspace, (0, 0, tar_w, tar_h), src.alpha) # now fill target with the tiles for i in range(col): for j in range(lin): src.set_origin(src.width * i, src.height * j) tar_pix.copy(src, src.irect) # copy input to new loc tar_pix.save("tar.png") This is the input picture: .. image:: images/img-7edges.png :scale: 33 Here is the output: .. image:: images/img-target.png :scale: 33 ---------- .. index:: pair: set_rect;examples pair: invert_irect;examples pair: copy;examples pair: save;examples .. _RecipesImages_M: How to Use Pixmaps: Making a Fractal ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Here is another Pixmap example that creates **Sierpinski's Carpet** -- a fractal generalizing the **Cantor Set** to two dimensions. Given a square carpet, mark its 9 sub-suqares (3 times 3) and cut out the one in the center. Treat each of the remaining eight sub-squares in the same way, and continue *ad infinitum*. The end result is a set with area zero and fractal dimension 1.8928... This script creates an approximate image of it as a PNG, by going down to one-pixel granularity. To increase the image precision, change the value of n (precision):: import pymupdf, time if not list(map(int, pymupdf.VersionBind.split("."))) >= [1, 14, 8]: raise SystemExit("need PyMuPDF v1.14.8 for this script") n = 6 # depth (precision) d = 3**n # edge length t0 = time.perf_counter() ir = (0, 0, d, d) # the pixmap rectangle pm = pymupdf.Pixmap(pymupdf.csRGB, ir, False) pm.set_rect(pm.irect, (255,255,0)) # fill it with some background color color = (0, 0, 255) # color to fill the punch holes # alternatively, define a 'fill' pixmap for the punch holes # this could be anything, e.g. some photo image ... fill = pymupdf.Pixmap(pymupdf.csRGB, ir, False) # same size as 'pm' fill.set_rect(fill.irect, (0, 255, 255)) # put some color in def punch(x, y, step): """Recursively "punch a hole" in the central square of a pixmap. Arguments are top-left coords and the step width. Some alternative punching methods are commented out. """ s = step // 3 # the new step # iterate through the 9 sub-squares # the central one will be filled with the color for i in range(3): for j in range(3): if i != j or i != 1: # this is not the central cube if s >= 3: # recursing needed? punch(x+i*s, y+j*s, s) # recurse else: # punching alternatives are: pm.set_rect((x+s, y+s, x+2*s, y+2*s), color) # fill with a color #pm.copy(fill, (x+s, y+s, x+2*s, y+2*s)) # copy from fill #pm.invert_irect((x+s, y+s, x+2*s, y+2*s)) # invert colors return #============================================================================== # main program #============================================================================== # now start punching holes into the pixmap punch(0, 0, d) t1 = time.perf_counter() pm.save("sierpinski-punch.png") t2 = time.perf_counter() print (f"{round(t1-t0,3)} sec to create / fill the pixmap") print (f"{round(t2-t1,3)} sec to save the image") The result should look something like this: .. image:: images/img-sierpinski.png :scale: 33 ---------- .. _RecipesImages_N: How to Interface with NumPy ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This shows how to create a PNG file from a numpy array (several times faster than most other methods):: import numpy as np import pymupdf #============================================================================== # create a fun-colored width * height PNG with pymupdf and numpy #============================================================================== height = 150 width = 100 bild = np.ndarray((height, width, 3), dtype=np.uint8) for i in range(height): for j in range(width): # one pixel (some fun coloring) bild[i, j] = [(i+j)%256, i%256, j%256] samples = bytearray(bild.tostring()) # get plain pixel data from numpy array pix = pymupdf.Pixmap(pymupdf.csRGB, width, height, samples, alpha=False) pix.save("test.png") ---------- .. _RecipesImages_O: How to Add Images to a PDF Page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There are two methods to add images to a PDF page: :meth:`Page.insert_image` and :meth:`Page.show_pdf_page`. Both methods have things in common, but there are also differences. ============================== ===================================== ========================================= **Criterion** :meth:`Page.insert_image` :meth:`Page.show_pdf_page` ============================== ===================================== ========================================= displayable content image file, image in memory, pixmap PDF page display resolution image resolution vectorized (except raster page content) rotation 0, 90, 180 or 270 degrees any angle clipping no (full image only) yes keep aspect ratio yes (default option) yes (default option) transparency (water marking) depends on the image depends on the page location / placement scaled to fit target rectangle scaled to fit target rectangle performance automatic prevention of duplicates; automatic prevention of duplicates; multi-page image support no yes ease of use simple, intuitive; simple, intuitive; **usable for all document types** (including images!) after conversion to PDF via :meth:`Document.convert_to_pdf` ============================== ===================================== ========================================= Basic code pattern for :meth:`Page.insert_image`. **Exactly one** of the parameters **filename / stream / pixmap** must be given, if not re-inserting an existing image:: page.insert_image( rect, # where to place the image (rect-like) filename=None, # image in a file stream=None, # image in memory (bytes) pixmap=None, # image from pixmap mask=None, # specify alpha channel separately rotate=0, # rotate (int, multiple of 90) xref=0, # re-use existing image oc=0, # control visibility via OCG / OCMD keep_proportion=True, # keep aspect ratio overlay=True, # put in foreground ) Basic code pattern for :meth:`Page.show_pdf_page`. Source and target PDF must be different :ref:`Document` objects (but may be opened from the same file):: page.show_pdf_page( rect, # where to place the image (rect-like) src, # source PDF pno=0, # page number in source PDF clip=None, # only display this area (rect-like) rotate=0, # rotate (float, any value) oc=0, # control visibility via OCG / OCMD keep_proportion=True, # keep aspect ratio overlay=True, # put in foreground ) .. _RecipesImages_P: How to Use Pixmaps: Checking Text Visibility ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Whether or not a given piece of text is actually visible on a page depends on a number of factors: 1. Text is not covered by another object but may have the same color as the background i.e., white-on-white etc. 2. Text may be covered by an image or vector graphics. Detecting this is an important capability, for example to uncover badly anonymized legal documents. 3. Text is created hidden. This technique is usually used by OCR tools to store the recognized text in an invisible layer on the page. The following shows how to detect situation 1. above, or situation 2. if the covering object is unicolor:: pix = page.get_pixmap(dpi=150) # make page image with a decent resolution # the following matrix transforms page to pixmap coordinates mat = page.rect.torect(pix.irect) # search for some string "needle" rlist = page.search_for("needle") # check the visibility for each hit rectangle for rect in rlist: if pix.color_topusage(clip=rect * mat)[0] > 0.95: print("'needle' is invisible here:", rect) Method :meth:`Pixmap.color_topusage` returns a tuple `(ratio, pixel)` where 0 < ratio <= 1 and *pixel* is the pixel value of the color. Please note that we create a **pixmap only once**. This can save a lot of processing time if there are multiple hit rectangles. The logic of the above code is: If the needle's rectangle is ("almost": > 95%) unicolor, then the text cannot be visible. A typical result for visible text returns the color of the background (mostly white) and a ratio around 0.7 to 0.8, for example `(0.685, b'\xff\xff\xff')`. .. include:: footer.rst ================================================ FILE: docs/recipes-journalling.rst ================================================ .. include:: header.rst .. _RecipesJournalling: ========================================= Journalling ========================================= Starting with version 1.19.0, journalling is possible when updating PDF documents. Journalling is a logging mechanism which permits either **reverting** or **re-applying** changes to a PDF. Similar to LUWs "Logical Units of Work" in modern database systems, one can group a set of updates into an "operation". In MuPDF journalling, an operation plays the role of a LUW. .. note:: In contrast to LUW implementations found in database systems, MuPDF journalling happens on a **per document level**. There is no support for simultaneous updates across multiple PDFs: one would have to establish one's own logic here. * Journalling must be *enabled* via a document method. Journalling is possible for existing or new documents. Journalling **can be disabled only** by closing the file. * Once enabled, every change must happen inside an *operation* -- otherwise an exception is raised. An operation is started and stopped via document methods. Updates happening between these two calls form an LUW and can thus collectively be rolled back or re-applied, or, in MuPDF terminology "undone" resp. "redone". * At any point, the journalling status can be queried: whether journalling is active, how many operations have been recorded, whether "undo" or "redo" is possible, the current position inside the journal, etc. * The journal can be **saved to** or **loaded from** a file. These are document methods. * When loading a journal file, compatibility with the document is checked and journalling is automatically enabled upon success. * For an **existing** PDF being journalled, a special new save method is available: :meth:`Document.save_snapshot`. This performs a special incremental save that includes all journalled updates so far. If its journal is saved at the same time (immediately after the document snapshot), then document and journal are in sync and can later on be used together to undo or redo operations or to continue journalled updates -- just as if there had been no interruption. * The snapshot PDF is a valid PDF in every aspect and fully usable. If the document is however changed in any way without using its journal file, then a desynchronization will take place and the journal is rendered unusable. * Snapshot files are structured like incremental updates. Nevertheless, the internal journalling logic requires, that saving **must happen to a new file**. So the user should develop a file naming convention to support recognizable relationships between an original PDF, like `original.pdf` and its snapshot sets, like `original-snap1.pdf` / `original-snap1.log`, `original-snap2.pdf` / `original-snap2.log`, etc. Example Session 1 ~~~~~~~~~~~~~~~~~~ Description: * Make a new PDF and enable journalling. Then add a page and some text lines -- each as a separate operation. * Navigate within the journal, undoing and redoing these updates and displaying status and file results:: >>> import pymupdf >>> doc=pymupdf.open() >>> doc.journal_enable() >>> # try update without an operation: >>> page = doc.new_page() mupdf: No journalling operation started ... omitted lines RuntimeError: No journalling operation started >>> doc.journal_start_op("op1") >>> page = doc.new_page() >>> doc.journal_stop_op() >>> doc.journal_start_op("op2") >>> page.insert_text((100,100), "Line 1") >>> doc.journal_stop_op() >>> doc.journal_start_op("op3") >>> page.insert_text((100,120), "Line 2") >>> doc.journal_stop_op() >>> doc.journal_start_op("op4") >>> page.insert_text((100,140), "Line 3") >>> doc.journal_stop_op() >>> # show position in journal >>> doc.journal_position() (4, 4) >>> # 4 operations recorded - positioned at bottom >>> # what can we do? >>> doc.journal_can_do() {'undo': True, 'redo': False} >>> # currently only undos are possible. Print page content: >>> print(page.get_text()) Line 1 Line 2 Line 3 >>> # undo last insert: >>> doc.journal_undo() >>> # show combined status again: >>> doc.journal_position();doc.journal_can_do() (3, 4) {'undo': True, 'redo': True} >>> print(page.get_text()) Line 1 Line 2 >>> # our position is now second to last >>> # last text insertion was reverted >>> # but we can redo / move forward as well: >>> doc.journal_redo() >>> # our combined status: >>> doc.journal_position();doc.journal_can_do() (4, 4) {'undo': True, 'redo': False} >>> print(page.get_text()) Line 1 Line 2 Line 3 >>> # line 3 has appeared again! Example Session 2 ~~~~~~~~~~~~~~~~~~ Description: * Similar to previous, but after undoing some operations, we now add a different update. This will cause: - permanent removal of the undone journal entries - the new update operation will become the new last entry. >>> doc=pymupdf.open() >>> doc.journal_enable() >>> doc.journal_start_op("Page insert") >>> page=doc.new_page() >>> doc.journal_stop_op() >>> for i in range(5): doc.journal_start_op(f"insert-{i}") page.insert_text((100, 100 + 20*i), f"text line {i}") doc.journal_stop_op() >>> # combined status info: >>> doc.journal_position();doc.journal_can_do() (6, 6) {'undo': True, 'redo': False} >>> for i in range(3): # revert last three operations doc.journal_undo() >>> doc.journal_position();doc.journal_can_do() (3, 6) {'undo': True, 'redo': True} >>> # now do a different update: >>> doc.journal_start_op("Draw some line") >>> page.draw_line((100,150), (300,150)) Point(300.0, 150.0) >>> doc.journal_stop_op() >>> doc.journal_position();doc.journal_can_do() (4, 4) {'undo': True, 'redo': False} >>> # this has changed the journal: >>> # previous last 3 text line operations were removed, and >>> # we have only 4 operations: drawing the line is the new last one .. include:: footer.rst ================================================ FILE: docs/recipes-low-level-interfaces.rst ================================================ .. include:: header.rst .. _RecipesLowLevelInterfaces: ========================================= Low-Level Interfaces ========================================= Numerous methods are available to access and manipulate PDF files on a fairly low level. Admittedly, a clear distinction between "low level" and "normal" functionality is not always possible or subject to personal taste. It also may happen, that functionality previously deemed low-level is later on assessed as being part of the normal interface. This has happened in v1.14.0 for the class :ref:`Tools` - you now find it as an item in the Classes chapter. It is a matter of documentation only in which chapter of the documentation you find what you are looking for. Everything is available and always via the same interface. ---------------------------------- How to Iterate through the :data:`xref` Table ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A PDF's :data:`xref` table is a list of all objects defined in the file. This table may easily contain many thousands of entries -- the manual :ref:`AdobeManual` for example has 127,000 objects. Table entry "0" is reserved and must not be touched. The following script loops through the :data:`xref` table and prints each object's definition:: >>> xreflen = doc.xref_length() # length of objects table >>> for xref in range(1, xreflen): # skip item 0! print("") print(f"object {xref} (stream: {doc.xref_is_stream(xref)})") print(doc.xref_object(xref, compressed=False)) .. highlight:: text This produces the following output:: object 1 (stream: False) << /ModDate (D:20170314122233-04'00') /PXCViewerInfo (PDF-XChange Viewer;2.5.312.1;Feb 9 2015;12:00:06;D:20170314122233-04'00') >> object 2 (stream: False) << /Type /Catalog /Pages 3 0 R >> object 3 (stream: False) << /Kids [ 4 0 R 5 0 R ] /Type /Pages /Count 2 >> object 4 (stream: False) << /Type /Page /Annots [ 6 0 R ] /Parent 3 0 R /Contents 7 0 R /MediaBox [ 0 0 595 842 ] /Resources 8 0 R >> ... object 7 (stream: True) << /Length 494 /Filter /FlateDecode >> ... .. highlight:: python A PDF object definition is an ordinary ASCII string. ---------------------------------- How to Handle Object Streams ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Some object types contain additional data apart from their object definition. Examples are images, fonts, embedded files or commands describing the appearance of a page. Objects of these types are called "stream objects". PyMuPDF allows reading an object's stream via method :meth:`Document.xref_stream` with the object's :data:`xref` as an argument. It is also possible to write back a modified version of a stream using :meth:`Document.update_stream`. Assume that the following snippet wants to read all streams of a PDF for whatever reason:: >>> xreflen = doc.xref_length() # number of objects in file >>> for xref in range(1, xreflen): # skip item 0! if stream := doc.xref_stream(xref): # do something with it (it is a bytes object or None) # e.g. just write it back: doc.update_stream(xref, stream) :meth:`Document.xref_stream` automatically returns a stream decompressed as a bytes object -- and :meth:`Document.update_stream` automatically compresses it if beneficial. ---------------------------------- How to Handle Page Contents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A PDF page can have zero or multiple :data:`contents` objects. These are stream objects describing **what** appears **where** and **how** on a page (like text and images). They are written in a special mini-language described e.g. in chapter "APPENDIX A - Operator Summary" on page 643 of the :ref:`AdobeManual`. Every PDF reader application must be able to interpret the contents syntax to reproduce the intended appearance of the page. If multiple :data:`contents` objects are provided, they must be interpreted in the specified sequence in exactly the same way as if they were provided as a concatenation of the several. There are good technical arguments for having multiple :data:`contents` objects: * It is a lot easier and faster to just add new :data:`contents` objects than maintaining a single big one (which entails reading, decompressing, modifying, recompressing, and rewriting it for each change). * When working with incremental updates, a modified big :data:`contents` object will bloat the update delta and can thus easily negate the efficiency of incremental saves. For example, PyMuPDF adds new, small :data:`contents` objects in methods :meth:`Page.insert_image`, :meth:`Page.show_pdf_page` and the :ref:`Shape` methods. However, there are also situations when a **single** :data:`contents` object is beneficial: it is easier to interpret and more compressible than multiple smaller ones. Here are two ways of combining multiple contents of a page:: >>> # method 1: use the MuPDF clean function >>> page.clean_contents() # cleans and combines multiple Contents >>> xref = page.get_contents()[0] # only one /Contents now! >>> cont = doc.xref_stream(xref) >>> # this has also reformatted the PDF commands >>> # method 2: extract concatenated contents >>> cont = page.read_contents() >>> # the /Contents source itself is unmodified The clean function :meth:`Page.clean_contents` does a lot more than just glueing :data:`contents` objects: it also corrects and optimizes the PDF operator syntax of the page and removes any inconsistencies with the page's object definition. ---------------------------------- How to Access the PDF Catalog ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a central ("root") object of a PDF. It serves as a starting point to reach important other objects and it also contains some global options for the PDF:: >>> import pymupdf >>> doc=pymupdf.open("PyMuPDF.pdf") >>> cat = doc.pdf_catalog() # get xref of the /Catalog >>> print(doc.xref_object(cat)) # print object definition << /Type/Catalog % object type /Pages 3593 0 R % points to page tree /OpenAction 225 0 R % action to perform on open /Names 3832 0 R % points to global names tree /PageMode /UseOutlines % initially show the TOC /PageLabels<>2<>8<>]>> % labels given to pages /Outlines 3835 0 R % points to outline tree >> .. note:: Indentation, line breaks and comments are inserted here for clarification purposes only and will not normally appear. For more information on the PDF catalog see section 7.7.2 on page 71 of the :ref:`AdobeManual`. ---------------------------------- How to Access the PDF File Trailer ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The trailer of a PDF file is a :data:`dictionary` located towards the end of the file. It contains special objects, and pointers to important other information. See :ref:`AdobeManual` p. 42. Here is an overview: ======= =========== =================================================================================== **Key** **Type** **Value** ======= =========== =================================================================================== Size int Number of entries in the cross-reference table + 1. Prev int Offset to previous :data:`xref` section (indicates incremental updates). Root dictionary (indirect) Pointer to the catalog. See previous section. Encrypt dictionary Pointer to encryption object (encrypted files only). Info dictionary (indirect) Pointer to information (metadata). ID array File identifier consisting of two byte strings. XRefStm int Offset of a cross-reference stream. See :ref:`AdobeManual` p. 49. ======= =========== =================================================================================== Access this information via PyMuPDF with :meth:`Document.pdf_trailer` or, equivalently, via :meth:`Document.xref_object` using -1 instead of a valid :data:`xref` number. >>> import pymupdf >>> doc=pymupdf.open("PyMuPDF.pdf") >>> print(doc.xref_object(-1)) # or: print(doc.pdf_trailer()) << /Type /XRef /Index [ 0 8263 ] /Size 8263 /W [ 1 3 1 ] /Root 8260 0 R /Info 8261 0 R /ID [ <4339B9CEE46C2CD28A79EBDDD67CC9B3> <4339B9CEE46C2CD28A79EBDDD67CC9B3> ] /Length 19883 /Filter /FlateDecode >> >>> ---------------------------------- How to Access XML Metadata ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A PDF may contain XML metadata in addition to the standard metadata format. In fact, most PDF viewer or modification software adds this type of information when saving the PDF (Adobe, Nitro PDF, PDF-XChange, etc.). PyMuPDF has no way to **interpret or change** this information directly, because it contains no XML features. XML metadata is however stored as a :data:`stream` object, so it can be read, modified with appropriate software and written back. >>> xmlmetadata = doc.get_xml_metadata() >>> print(xmlmetadata) ... omitted data ... Using some XML package, the XML data can be interpreted and / or modified and then stored back. The following also works, if the PDF previously had no XML metadata:: >>> # write back modified XML metadata: >>> doc.set_xml_metadata(xmlmetadata) >>> >>> # XML metadata can be deleted like this: >>> doc.del_xml_metadata() ---------------------------------- How to Extend PDF Metadata ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Attribute :attr:`Document.metadata` is designed so it works for all :ref:`supported document types` in the same way: it is a Python dictionary with a **fixed set of key-value pairs**. Correspondingly, :meth:`Document.set_metadata` only accepts standard keys. However, PDFs may contain items not accessible like this. Also, there may be reasons to store additional information, like copyrights. Here is a way to handle **arbitrary metadata items** by using PyMuPDF low-level functions. As an example, look at this standard metadata output of some PDF:: # --------------------- # standard metadata # --------------------- pprint(doc.metadata) {'author': 'PRINCE', 'creationDate': "D:2010102417034406'-30'", 'creator': 'PrimoPDF http://www.primopdf.com/', 'encryption': None, 'format': 'PDF 1.4', 'keywords': '', 'modDate': "D:20200725062431-04'00'", 'producer': 'macOS Version 10.15.6 (Build 19G71a) Quartz PDFContext, ' 'AppendMode 1.1', 'subject': '', 'title': 'Full page fax print', 'trapped': ''} Use the following code to see **all items** stored in the metadata object:: # ---------------------------------- # metadata including private items # ---------------------------------- metadata = {} # make my own metadata dict what, value = doc.xref_get_key(-1, "Info") # /Info key in the trailer if what != "xref": pass # PDF has no metadata else: xref = int(value.replace("0 R", "")) # extract the metadata xref for key in doc.xref_get_keys(xref): metadata[key] = doc.xref_get_key(xref, key)[1] pprint(metadata) {'Author': 'PRINCE', 'CreationDate': "D:2010102417034406'-30'", 'Creator': 'PrimoPDF http://www.primopdf.com/', 'ModDate': "D:20200725062431-04'00'", 'PXCViewerInfo': 'PDF-XChange Viewer;2.5.312.1;Feb 9 ' "2015;12:00:06;D:20200725062431-04'00'", 'Producer': 'macOS Version 10.15.6 (Build 19G71a) Quartz PDFContext, ' 'AppendMode 1.1', 'Title': 'Full page fax print'} # --------------------------------------------------------------- # note the additional 'PXCViewerInfo' key - ignored in standard! # --------------------------------------------------------------- *Vice versa*, you can also **store private metadata items** in a PDF. It is your responsibility to make sure that these items conform to PDF specifications - especially they must be (unicode) strings. Consult section 14.3 (p. 548) of the :ref:`AdobeManual` for details and caveats:: what, value = doc.xref_get_key(-1, "Info") # /Info key in the trailer if what != "xref": raise ValueError("PDF has no metadata") xref = int(value.replace("0 R", "")) # extract the metadata xref # add some private information doc.xref_set_key(xref, "mykey", pymupdf.get_pdf_str("北京 is Beijing")) # # after executing the previous code snippet, we will see this: pprint(metadata) {'Author': 'PRINCE', 'CreationDate': "D:2010102417034406'-30'", 'Creator': 'PrimoPDF http://www.primopdf.com/', 'ModDate': "D:20200725062431-04'00'", 'PXCViewerInfo': 'PDF-XChange Viewer;2.5.312.1;Feb 9 ' "2015;12:00:06;D:20200725062431-04'00'", 'Producer': 'macOS Version 10.15.6 (Build 19G71a) Quartz PDFContext, ' 'AppendMode 1.1', 'Title': 'Full page fax print', 'mykey': '北京 is Beijing'} To delete selected keys, use `doc.xref_set_key(xref, "mykey", "null")`. As explained in the next section, string "null" is the PDF equivalent to Python's `None`. A key with that value will be treated as not being specified -- and physically removed in garbage collections. ---------------------------------- How to Read and Update PDF Objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. highlight:: python There also exist granular, elegant ways to access and manipulate selected PDF :data:`dictionary` keys. * :meth:`Document.xref_get_keys` returns the PDF keys of the object at :data:`xref`:: In [1]: import pymupdf In [2]: doc = pymupdf.open("pymupdf.pdf") In [3]: page = doc[0] In [4]: from pprint import pprint In [5]: pprint(doc.xref_get_keys(page.xref)) ('Type', 'Contents', 'Resources', 'MediaBox', 'Parent') * Compare with the full object definition:: In [6]: print(doc.xref_object(page.xref)) << /Type /Page /Contents 1297 0 R /Resources 1296 0 R /MediaBox [ 0 0 612 792 ] /Parent 1301 0 R >> * Single keys can also be accessed directly via :meth:`Document.xref_get_key`. The value **always is a string** together with type information, that helps with interpreting it:: In [7]: doc.xref_get_key(page.xref, "MediaBox") Out[7]: ('array', '[0 0 612 792]') * Here is a full listing of the above page keys:: In [9]: for key in doc.xref_get_keys(page.xref): ...: print(f"{key} = {doc.xref_get_key(page.xref, key)}") ...: Type = ('name', '/Page') Contents = ('xref', '1297 0 R') Resources = ('xref', '1296 0 R') MediaBox = ('array', '[0 0 612 792]') Parent = ('xref', '1301 0 R') * An undefined key inquiry returns `('null', 'null')` -- PDF object type `null` corresponds to `None` in Python. Similar for the booleans `true` and `false`. * Let us add a new key to the page definition that sets its rotation to 90 degrees (you are aware that there actually exists :meth:`Page.set_rotation` for this?):: In [11]: doc.xref_get_key(page.xref, "Rotate") # no rotation set: Out[11]: ('null', 'null') In [12]: doc.xref_set_key(page.xref, "Rotate", "90") # insert a new key In [13]: print(doc.xref_object(page.xref)) # confirm success << /Type /Page /Contents 1297 0 R /Resources 1296 0 R /MediaBox [ 0 0 612 792 ] /Parent 1301 0 R /Rotate 90 >> * This method can also be used to remove a key from the :data:`xref` dictionary by setting its value to `null`: The following will remove the rotation specification from the page: `doc.xref_set_key(page.xref, "Rotate", "null")`. Similarly, to remove all links, annotations and fields from a page, use `doc.xref_set_key(page.xref, "Annots", "null")`. Because `Annots` by definition is an array, setting en empty array with the statement `doc.xref_set_key(page.xref, "Annots", "[]")` would do the same job in this case. * PDF dictionaries can be hierarchically nested. In the following page object definition both, `Font` and `XObject` are subdictionaries of `Resources`:: In [15]: print(doc.xref_object(page.xref)) << /Type /Page /Contents 1297 0 R /Resources << /XObject << /Im1 1291 0 R >> /Font << /F39 1299 0 R /F40 1300 0 R >> >> /MediaBox [ 0 0 612 792 ] /Parent 1301 0 R /Rotate 90 >> * The above situation **is supported** by methods :meth:`Document.xref_set_key` and :meth:`Document.xref_get_key`: use a path-like notation to point at the required key. For example, to retrieve the value of key `Im1` above, specify the complete chain of dictionaries "above" it in the key argument: `"Resources/XObject/Im1"`:: In [16]: doc.xref_get_key(page.xref, "Resources/XObject/Im1") Out[16]: ('xref', '1291 0 R') * The path notation can also be used to **directly set a value**: use the following to let `Im1` point to a different object:: In [17]: doc.xref_set_key(page.xref, "Resources/XObject/Im1", "9999 0 R") In [18]: print(doc.xref_object(page.xref)) # confirm success: << /Type /Page /Contents 1297 0 R /Resources << /XObject << /Im1 9999 0 R >> /Font << /F39 1299 0 R /F40 1300 0 R >> >> /MediaBox [ 0 0 612 792 ] /Parent 1301 0 R /Rotate 90 >> Be aware, that **no semantic checks** whatsoever will take place here: if the PDF has no xref 9999, it won't be detected at this point. * If a key does not exist, it will be created by setting its value. Moreover, if any intermediate keys do not exist either, they will also be created as necessary. The following creates an array `D` several levels below the existing dictionary `A`. Intermediate dictionaries `B` and `C` are automatically created:: In [5]: print(doc.xref_object(xref)) # some existing PDF object: << /A << >> >> In [6]: # the following will create 'B', 'C' and 'D' In [7]: doc.xref_set_key(xref, "A/B/C/D", "[1 2 3 4]") In [8]: print(doc.xref_object(xref)) # check out what happened: << /A << /B << /C << /D [ 1 2 3 4 ] >> >> >> >> * When setting key values, basic **PDF syntax checking** will be done by MuPDF. For example, new keys can only be created **below a dictionary**. The following tries to create some new string item `E` below the previously created array `D`:: In [9]: # 'D' is an array, no dictionary! In [10]: doc.xref_set_key(xref, "A/B/C/D/E", "(hello)") mupdf: not a dict (array) --- ... --- RuntimeError: not a dict (array) * It is also **not possible**, to create a key if some higher level key is an **"indirect"** object, i.e. an xref. In other words, xrefs can only be modified directly and not implicitly via other objects referencing them:: In [13]: # the following object points to an xref In [14]: print(doc.xref_object(4)) << /E 3 0 R >> In [15]: # 'E' is an indirect object and cannot be modified here! In [16]: doc.xref_set_key(4, "E/F", "90") mupdf: path to 'F' has indirects --- ... --- RuntimeError: path to 'F' has indirects .. caution:: These are expert functions! There are no validations as to whether valid PDF objects, xrefs, etc. are specified. As with other low-level methods there is the risk to render the PDF, or parts of it unusable. .. include:: footer.rst ================================================ FILE: docs/recipes-multiprocessing.rst ================================================ .. include:: header.rst .. _RecipesMultiprocessing: .. |toggleStart| raw:: html
See code .. |toggleEnd| raw:: html
============================== Multiprocessing ============================== |PyMuPDF| does not support running on multiple threads - doing so may cause incorrect behaviour or even crash Python itself. However, there is the option to use :title:`Python's` *multiprocessing* module in a variety of ways. If you are looking to speed up page-oriented processing for a large document, use this script as a starting point. It should be at least twice as fast as the corresponding sequential processing. |toggleStart| .. literalinclude:: samples/multiprocess-render.py :language: python |toggleEnd| Here is a more complex example involving inter-process communication between a main process (showing a GUI) and a child process doing |PyMuPDF| access to a document. |toggleStart| .. literalinclude:: samples/multiprocess-gui.py :language: python |toggleEnd| .. include:: footer.rst ================================================ FILE: docs/recipes-ocr.rst ================================================ .. include:: header.rst .. _RecipesOCR: .. |toggleStart| raw:: html
See code .. |toggleEnd| raw:: html
==================================== OCR - Optical Character Recognition ==================================== |PyMuPDF| has integrated support for OCR (Optical Character Recognition). It is possible to use OCR for both, images (via the :ref:`Pixmap` class) and for document pages. The feature is currently based on Tesseract-OCR which must be installed as a separate application -- see the :ref:`installation_ocr`. How to OCR an Image -------------------- A supported image must first be converted to a :ref:`Pixmap`. The Pixmap can then be saved to a 1-page PDF. This page will look like the original image with the same width and height. It will contain a layer of text as recognized by Tesseract. The PDF can be generated via one of the methods :meth:`Pixmap.pdfocr_save` or :meth:`Pixmap.pdfocr_tobytes`, as a file on disk or as a PDF in memory. The text can be extracted and searched with the usual text extraction and search methods (:meth:`Page.get_text`, :meth:`Page.search_for`, etc.). Please also note the following important facts and prerequisites: * When converting the image to a Pixmap, please confirm that the color space is RGB and alpha is `False` (no transparency). Convert the original Pixmap if necessary. * All text is written as "hidden" with Tesseract's own `GlyphLessFont`, a mono-spaced font with metrics comparable to Courier. * All text has the properties regular and black (i.e. no bold, no italic, no information about the original fonts). * Tesseract does not recognize vector graphics (i.e. no drawings / line-art). This approach is also recommended to OCR a complete scanned PDF: * Render each page to a :ref:`Pixmap` with desired resolution * Append the resulting 1-page PDF to the output PDF How to OCR a Document Page ---------------------------- Any supported document page can be OCR-ed -- either the complete page or only the image areas on it. Because optical character recognition is about one thousand times slower than standard text extraction, we make sure to do OCR only once per page and store the result in a :ref:`TextPage`. Using this TextPage for all subsequent extractions and text searches will then happen with |PyMuPDF|'s usual top speed. To OCR a document page, follow this approach: 1. Determine whether OCR is needed / beneficial at all. A number of criteria can be used for this decision, like: * page is completely covered by an image * no text exists on the page * thousands of small vector graphics (indicating *simulated* text) 2. OCR the page and store result in a :ref:`TextPage` object using an instruction like `tp = page.get_textpage_ocr(...)`. 3. Refer to the produced :ref:`TextPage` in all subsequent text extractions and searches via the `textpage=tp` parameter. .. include:: footer.rst ================================================ FILE: docs/recipes-optional-content.rst ================================================ .. include:: header.rst .. _RecipesOptionalContent: ============================== Optional Content Support ============================== This document explains PyMuPDF's support of the PDF concept **"Optional Content"**. Introduction: The Optional Content Concept ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ *Optional Content* in PDF is a way to show or hide parts of a document based on certain conditions: Parameters that can be set to ON or to OFF when using a supporting PDF consumer (viewer), or programmatically. This capability is useful in items such as CAD drawings, layered artwork, maps, and multi-language documents. Typical uses include showing or hiding details of complex vector graphics like geographical maps, technical devices, architectural designs and similar, including automatically switching between different zooming levels. Other use cases may be to automatically show different detail levels when displaying a document on screen as opposed to printing it. Special PDF objects, so-called **Optional Content Groups** (OCGs) are used to define these different *layers* of content. Assigning an OCG to a "normal" PDF object (like a text or an image) causes that object to be visible or hidden, depending on the current state of the assigned OCG. To ease definition of the overall configuration of a PDF's Optional Content, OCGs can be organized in higher level groupings, called **OC Configurations**. Each configuration being a collection of OCGs, together with each OCG's desired initial visibility state. Selecting one of these configurations (via the PDF viewer or programmatically) causes a corresponding visibility change of all affected PDF objects throughout the document. Except for the default one, OC Configurations are optional. For more explanations and additional background please refer to PDF specification manuals. PyMuPDF Support for PDF Optional Content ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PyMuPDF offers full support for viewing, defining, changing and deleting Option Content Groups, Configurations, maintaining the assignment of OCGs to PDF objects and programmatically switching between OC Configurations and the visibility states of each single OCG. How to Add Optional Content ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is as simple as adding an Optional Content Group, OCG, to a PDF: :meth:`Document.add_ocg`. If previously the PDF had no OC support at all, the required setup (like defining the default OC Configuration) will be done at this point automatically. The method returns an :data:`xref` of the created OCG. Use this xref to associate (mark) any PDF object with it, that you want to make dependent on this OCG's state. For example, you can insert an image on a page and refer to the xref like this:: img_xref = page.insert_image(rect, filename="image.file", oc=xref) If you want to put an **existing** image under the control of an OCG, you must first find out the image's xref number (called `img_xref` here) and then do `doc.set_oc(img_xref, xref)`. After this, the image will be (in-) visible everywhere throughout the document if the OCG's state is "ON", respectively "OFF". You can also assign a different OCG with this method. To **remove** an OCG from an image, do `doc.set_oc(img_xref, 0)`. One single OCG can be assigned to multiple PDF objects to control their visibility. How to Define Complex Optional Content Conditions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sophisticated logical conditions can be established to address complex visibility needs. For example, you might want to create a multi-language document, so the user may switch between languages as required. Please have a look at `this Jupyter Notebook`_ and execute it as desired. Certainly, your requirements may even be more complex and involve multiple OCGs with ON/OFF states that are connected by some kind of logical relationship -- but it should give you an impression of what is possible and how to plan your next steps. .. include:: footer.rst .. External Links: .. _this Jupyter Notebook: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/jupyter-notebooks/optional-content.ipynb ================================================ FILE: docs/recipes-stories.rst ================================================ .. include:: header.rst .. _RecipesStories: .. role:: htmlTag(emphasis) .. |toggleStart| raw:: html
See recipe .. |toggleEnd| raw:: html
============================== Stories ============================== This document showcases some typical use cases for :ref:`Stories`. As mentioned in the :ref:`tutorial`, stories may be created using up to three input sources: HTML, CSS and Archives -- all of which are optional and which, respectively, can be provided programmatically. The following examples will showcase combinations for using these inputs. .. note:: Many of these recipe's source code are included as examples in the `docs` folder. .. _RecipesStories_A: How to Add a Line of Text with Some Formatting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Here is the inevitable "Hello World" example. We will show two variants: 1. Create using existing HTML source [#f1]_, that may come from anywhere. 2. Create using the Python API. ----- Variant using an existing HTML source [#f1]_ -- which in this case is defined as a constant in the script:: import pymupdf HTML = """

Hello World!

""" MEDIABOX = pymupdf.paper_rect("letter") # output page format: Letter WHERE = MEDIABOX + (36, 36, -36, -36) # leave borders of 0.5 inches story = pymupdf.Story(html=HTML) # create story from HTML writer = pymupdf.DocumentWriter("output.pdf") # create the writer more = 1 # will indicate end of input once it is set to 0 while more: # loop outputting the story device = writer.begin_page(MEDIABOX) # make new page more, _ = story.place(WHERE) # layout into allowed rectangle story.draw(device) # write on page writer.end_page() # finish page writer.close() # close output file .. note:: The above effect (sans-serif and blue text) could have been achieved by using a separate CSS source like so:: import pymupdf CSS = """ body { font-family: sans-serif; color: blue; } """ HTML = """

Hello World!

""" # the story would then be created like this: story = pymupdf.Story(html=HTML, user_css=CSS) ----- The Python API variant -- everything is created programmatically:: import pymupdf MEDIABOX = pymupdf.paper_rect("letter") WHERE = MEDIABOX + (36, 36, -36, -36) story = pymupdf.Story() # create an empty story body = story.body # access the body of its DOM with body.add_paragraph() as para: # store desired content para.set_font("sans-serif").set_color("blue").add_text("Hello World!") writer = pymupdf.DocumentWriter("output.pdf") more = 1 while more: device = writer.begin_page(MEDIABOX) more, _ = story.place(WHERE) story.draw(device) writer.end_page() writer.close() Both variants will produce the same output PDF. ----- .. _RecipesStories_B: How to use Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Images can be referenced in the provided HTML source, or the reference to a desired image can also be stored via the Python API. In any case, this requires using an :ref:`Archive`, which refers to the place where the image can be found. .. note:: Images with the binary content embedded in the HTML source are **not supported** by stories. We extend our "Hello World" example from above and display an image of our planet right after the text. Assuming the image has the name "world.jpg" and is present in the script's folder, then this is the modified version of the above Python API variant:: import pymupdf MEDIABOX = pymupdf.paper_rect("letter") WHERE = MEDIABOX + (36, 36, -36, -36) # create story, let it look at script folder for resources story = pymupdf.Story(archive=".") body = story.body # access the body of its DOM with body.add_paragraph() as para: # store desired content para.set_font("sans-serif").set_color("blue").add_text("Hello World!") # another paragraph for our image: with body.add_paragraph() as para: # store image in another paragraph para.add_image("world.jpg") writer = pymupdf.DocumentWriter("output.pdf") more = 1 while more: device = writer.begin_page(MEDIABOX) more, _ = story.place(WHERE) story.draw(device) writer.end_page() writer.close() ----- .. _RecipesStories_C: How to Read External HTML and CSS for a Story ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These cases are fairly straightforward. As a general recommendation, HTML and CSS sources should be **read as binary files** and decoded before using them in a story. The Python `pathlib.Path` provides convenient ways to do this:: import pathlib import pymupdf htmlpath = pathlib.Path("myhtml.html") csspath = pathlib.Path("mycss.css") HTML = htmlpath.read_bytes().decode() CSS = csspath.read_bytes().decode() story = pymupdf.Story(html=HTML, user_css=CSS) ----- .. _RecipesStories_D: How to Output Database Content with Story Templates ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This script demonstrates how to report SQL database content using an **HTML template**. The example SQL database contains two tables: 1. Table "films" contains one row per film with the fields **"title"**, **"director"** and (release) **"year"**. 2. Table "actors" contains one row per actor and film title (fields (actor) **"name"** and (film) **"title"**). The story DOM consists of a template for one film, which reports film data together with a list of casted actors. **Files:** * `docs/samples/filmfestival-sql.py` * `docs/samples/filmfestival-sql.db` |toggleStart| .. literalinclude:: samples/filmfestival-sql.py |toggleEnd| ----- .. _RecipesStories_E: How to Integrate with Existing PDFs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Because a :ref:`DocumentWriter` can only write to a new file, stories cannot be placed on existing pages. This script demonstrates a circumvention of this restriction. The basic idea is letting :ref:`DocumentWriter` output to a PDF in memory. Once the story has finished, we re-open this memory PDF and put its pages to desired locations on **existing** pages via method :meth:`Page.show_pdf_page`. **Files:** * `docs/samples/showpdf-page.py` |toggleStart| .. literalinclude:: samples/showpdf-page.py |toggleEnd| ----- .. _RecipesStories_F: How to Make Multi-Columned Layouts and Access Fonts from Package `pymupdf-fonts`_ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This script outputs an article (taken from Wikipedia) that contains text and multiple images and uses a 2-column page layout. In addition, two "Ubuntu" font families from package `pymupdf-fonts`_ are used instead of defaulting to Base-14 fonts. Yet another feature used here is that all data -- the images and the article HTML -- are jointly stored in a ZIP file. **Files:** * `docs/samples/quickfox.py` * `docs/samples/quickfox.zip` |toggleStart| .. literalinclude:: samples/quickfox.py |toggleEnd| ----- .. _RecipesStories_G: How to Make a Layout which Wraps Around a Predefined "no go area" Layout ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a demo script using PyMuPDF's Story class to output text as a PDF with a two-column page layout. The script demonstrates the following features: * Layout text around images of an existing ("target") PDF. * Based on a few global parameters, areas on each page are identified, that can be used to receive text layouted by a Story. * These global parameters are not stored anywhere in the target PDF and must therefore be provided in some way: - The width of the border(s) on each page. - The fontsize to use for text. This value determines whether the provided text will fit in the empty spaces of the (fixed) pages of target PDF. It cannot be predicted in any way. The script ends with an exception if target PDF has not enough pages, and prints a warning message if not all pages receive at least some text. In both cases, the FONTSIZE value can be changed (a float value). - Use of a 2-column page layout for the text. * The layout creates a temporary (memory) PDF. Its produced page content (the text) is used to overlay the corresponding target page. If text requires more pages than are available in target PDF, an exception is raised. If not all target pages receive at least some text, a warning is printed. * The script reads "image-no-go.pdf" in its own folder. This is the "target" PDF. It contains 2 pages with each 2 images (from the original article), which are positioned at places that create a broad overall test coverage. Otherwise the pages are empty. * The script produces "quickfox-image-no-go.pdf" which contains the original pages and image positions, but with the original article text laid out around them. **Files:** * `docs/samples/quickfox-image-no-go.py` * `docs/samples/quickfox-image-no-go.pdf` * `docs/samples/quickfox.zip` |toggleStart| .. literalinclude:: samples/quickfox-image-no-go.py |toggleEnd| ----- .. _RecipesStories_H: How to Output an HTML Table ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Outputting HTML tables is supported as follows: * Flat table layouts are supported ("rows x columns"), no support of the "colspan" / "rowspan" attributes. * Table header tag :htmlTag:`th` supports attribute "scope" with values "row" or "col". Applicable text will be bold by default. * Column widths are computed automatically based on column content. They cannot be directly set. * Table **cells may contain images** which will be considered in the column width calculation magic. * Row heights are computed automatically based on row content - leading to multi-line rows where needed. * The potentially multiple lines of a table row will always be kept together on one page (respectively "where" rectangle) and not be split. * Table header rows are only **shown on the first page / "where" rectangle.** * The "style" attribute is ignored when given directly in HTML table elements. Styling for a table and its elements must happen separately, in CSS source or within the :htmlTag:`style` tag. * Styling for :htmlTag:`tr` elements is not supported and ignored. Therefore, a table-wide grid or alternating row background colors are not supported. One of the following example scripts however shows an easy way to deal with this limitation. **Files:** * `docs/samples/table01.py` This script reflects basic features. |toggleStart| .. literalinclude:: samples/table01.py |toggleEnd| * `docs/samples/national-capitals.py` Advanced script extending table output options using simple additional code: - Multi-page output simulating **repeating header rows** - Alternating table row background colors - Table rows and columns delimited by gridlines - Table rows dynamically generated / filled with data from an SQL database |toggleStart| .. literalinclude:: samples/national-capitals.py |toggleEnd| ----- .. _RecipesStories_I: How to Create a Simple Grid Layout ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ By creating a sequence of :ref:`Story` objects within a grid created via the :ref:`make_table` function a developer can create grid layouts as required. **Files:** * `docs/samples/simple-grid.py` |toggleStart| .. literalinclude:: samples/simple-grid.py |toggleEnd| ----- .. _RecipesStories_J: How to Generate a Table of Contents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This script lists the source code of all Python scripts that live in the script's directory. **Files:** * `docs/samples/code-printer.py` |toggleStart| .. literalinclude:: samples/code-printer.py |toggleEnd| It features the following capabilities: * Automatic generation of a Table of Contents (TOC) on separately numbered pages at the start of the document - using a specialized :ref:`Story`. * Use of 3 separate :ref:`Story` objects per page: header story, footer story and the story for printing the Python sources. - The page **footer is automatically changed** to show the name of the current Python file. * Use of :meth:`Story.element_positions` to collect the data for the TOC and for the dynamic adjustment of page footers. This is an example of a **bidirectional communication** between the story output process and the script. * The main PDF with the Python sources is being written to memory by its :ref:`DocumentWriter`. Another :ref:`Story` / :ref:`DocumentWriter` pair is then used to create a (memory) PDF for the TOC pages. Finally, both these PDFs are joined and the result stored to disk. ----- .. _RecipesStories_K: How to Display a List from JSON Data ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This example takes some JSON data input which it uses to populate a :ref:`Story`. It also contains some visual text formatting and shows how to add links. **Files:** * `docs/samples/json-example.py` |toggleStart| .. literalinclude:: samples/json-example.py |toggleEnd| ----- .. _RecipesStories_L: Using the Alternative :meth:`Story.write*()` functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The :meth:`Story.write*()` functions provide a different way to use the :ref:`Story` functionality, removing the need for calling code to implement a loop that calls :meth:`Story.place()` and :meth:`Story.draw()` etc, at the expense of having to provide at least a `rectfn()` callback. .. _RecipesStories_L_a: How to do Basic Layout with :meth:`Story.write()` ------------------------------------------------- This script lays out multiple copies of its own source code, into four rectangles per page. **Files:** * `docs/samples/story-write.py` |toggleStart| .. literalinclude:: samples/story-write.py |toggleEnd| ----- .. _RecipesStories_L_b: How to do Iterative Layout for a Table of Contents with :meth:`Story.write_stabilized()` ---------------------------------------------------------------------------------------- This script creates html content dynamically, adding a contents section based on :ref:`ElementPosition` items that have non-zero `.heading` values. The contents section is at the start of the document, so modifications to the contents can change page numbers in the rest of the document, which in turn can cause page numbers in the contents section to be incorrect. So the script uses :meth:`Story.write_stabilized()` to repeatedly lay things out until things are stable. **Files:** * `docs/samples/story-write-stabilized.py` |toggleStart| .. literalinclude:: samples/story-write-stabilized.py |toggleEnd| ----- .. _RecipesStories_L_c: How to do Iterative Layout and Create PDF Links with :meth:`Story.write_stabilized_links()` ------------------------------------------------------------------------------------------- This script is similar to the one described in "How to use :meth:`Story.write_stabilized()`" above, except that the generated PDF also contains links that correspond to the internal links in the original html. This is done by using :meth:`Story.write_stabilized_links()`; this is slightly different from :meth:`Story.write_stabilized()`: * It does not take a :ref:`DocumentWriter` `writer` arg. * It returns a PDF :ref:`Document` instance. [The reasons for this are a little involved; for example a :ref:`DocumentWriter` is not necessarily a PDF writer, so doesn't really work in a PDF-specific API.] **Files:** * `docs/samples/story-write-stabilized-links.py` |toggleStart| .. literalinclude:: samples/story-write-stabilized-links.py |toggleEnd| ----- .. rubric:: Footnotes .. [#f1] HTML & CSS support .. note:: At the time of writing the HTML engine for Stories is fairly basic and supports a subset of CSS2 attributes. Some important CSS support to consider: - The only available layout is relative layout. - `background` is unavailable, use `background-color` instead. - `float` is unavailable. .. include:: footer.rst .. External Links: .. _pymupdf-fonts: https://github.com/pymupdf/pymupdf-fonts ================================================ FILE: docs/recipes-text.rst ================================================ .. include:: header.rst .. _RecipesText: ============================== Text ============================== .. _RecipesText_A: How to Extract all Document Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This script will take a document filename and generate a text file from all of its text. The document can be any :ref:`supported type`. The script works as a command line tool which expects the document filename supplied as a parameter. It generates one text file named "filename.txt" in the script directory. Text of pages is separated by a form feed character:: import sys, pathlib, pymupdf fname = sys.argv[1] # get document filename with pymupdf.open(fname) as doc: # open document text = chr(12).join([page.get_text() for page in doc]) # write as a binary file to support non-ASCII characters pathlib.Path(fname + ".txt").write_bytes(text.encode()) The output will be plain text as it is coded in the document. No effort is made to prettify in any way. Specifically for PDF, this may mean output not in usual reading order, unexpected line breaks and so forth. You have many options to rectify this -- see chapter :ref:`Appendix2`. Among them are: 1. Extract text in HTML format and store it as a HTML document, so it can be viewed in any browser. 2. Extract text as a list of text blocks via *Page.get_text("blocks")*. Each item of this list contains position information for its text, which can be used to establish a convenient reading order. 3. Extract a list of single words via *Page.get_text("words")*. Its items are words with position information. Use it to determine text contained in a given rectangle -- see next section. See the following two sections for examples and further explanations. .. index:: triple: lookup;text;key-value How to Extract Text as Markdown ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is especially useful for :title:`RAG/LLM` environments - please see :ref:`Outputting as Markdown `. .. _RecipesText_A1: How to Extract Key-Value Pairs from a Page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the layout of a page is *"predictable"* in some sense, then there is a simple way to find the values for a given set of keywords fast and easily -- without using regular expressions. Please see `this example script `_. "Predictable" in this context means: * Every keyword is followed by its value -- no other text is present in between them. * The bottom of the value's boundary box is **not above** the one of the keyword. * There are **no other restrictions**: the page layout may or may not be fixed, and the text may also have been stored as one string. Key and value may have any distance from each other. For example, the following five key-value pairs will be correctly identified:: key1 value1 key2 value2 key3 value3 blah, blah, blah key4 value4 some other text key5 value5 ... .. index:: triple: extract;text;rectangle .. _RecipesText_B: How to Extract Text from within a Rectangle ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There is now (v1.18.0) more than one way to achieve this. We therefore have created a `folder `_ in the PyMuPDF-Utilities repository specifically dealing with this topic. ---------- .. index:: pair: text;reading order .. _RecipesText_C: How to Extract Text in Natural Reading Order ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ One of the common issues with PDF text extraction is, that text may not appear in any particular reading order. This is the responsibility of the PDF creator (software or a human). For example, page headers may have been inserted in a separate step -- after the document had been produced. In such a case, the header text will appear at the end of a page text extraction (although it will be correctly shown by PDF viewer software). For example, the following snippet will add some header and footer lines to an existing PDF:: doc = pymupdf.open("some.pdf") header = "Header" # text in header for page in doc: page.insert_text((50, 50), header) # insert header page.insert_text( # insert footer 50 points above page bottom (50, page.rect.height - 50), f"Page {page.number + 1} of {doc.page_count}", # text in footer ) The text sequence extracted from a page modified in this way will look like this: 1. original text 2. header line 3. footer line PyMuPDF has several means to re-establish some reading sequence or even to re-generate a layout close to the original: 1. Use `sort` parameter of :meth:`Page.get_text`. It will sort the output from top-left to bottom-right (ignored for XHTML, HTML and XML output). 2. Use the `pymupdf` module in CLI: `python -m pymupdf gettext ...`, which produces a text file where text has been re-arranged in layout-preserving mode. Many options are available to control the output. You can also use the above mentioned `script `_ with your modifications. ---------- .. _RecipesText_D: How to :index:`Extract Table Content ` from Documents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you see a table in a document, you are normally not looking at something like an embedded Excel or other identifiable object. It usually is just normal, standard text, formatted to appear as tabular data. Extracting tabular data from such a page area therefore means that you must find a way to **identify** the table area (i.e. its boundary box), then **(1)** graphically indicate table and column borders, and **(2)** then extract text based on this information. This can be a very complex task, depending on details like the presence or absence of lines, rectangles or other supporting vector graphics. Method :meth:`Page.find_tables` does all that for you, with a high table detection precision. Its great advantage is that there are no external library dependencies, nor the need to employ artificial intelligence or machine learning technologies. It also provides an integrated interface to the well-known Python package for data analysis `pandas `_. Please have a look at example `Jupyter notebooks `_, which cover standard situations like multiple tables on one page or joining table fragments across multiple pages. ---------- .. _RecipesText_E: How to Mark Extracted Text ~~~~~~~~~~~~~~~~~~~~~~~~~~ There is a standard search function to search for arbitrary text on a page: :meth:`Page.search_for`. It returns a list of :ref:`Rect` objects which surround a found occurrence. These rectangles can for example be used to automatically insert annotations which visibly mark the found text. This method has advantages and drawbacks. Pros are: * The search string can contain blanks and wrap across lines * Upper or lower case characters are treated equal * Word hyphenation at line ends is detected and resolved * Return may also be a list of :ref:`Quad` objects to precisely locate text that is **not parallel** to either axis -- using :ref:`Quad` output is also recommended, when page rotation is not zero. But you also have other options:: import sys import pymupdf def mark_word(page, text): """Underline each word that contains 'text'. """ found = 0 wlist = page.get_text("words", delimiters=None) # make the word list for w in wlist: # scan through all words on page if text in w[4]: # w[4] is the word's string found += 1 # count r = pymupdf.Rect(w[:4]) # make rect from word bbox page.add_underline_annot(r) # underline return found fname = sys.argv[1] # filename text = sys.argv[2] # search string doc = pymupdf.open(fname) print(f"underlining words containing '{word}' in document '{doc.name}'") new_doc = False # indicator if anything found at all for page in doc: # scan through the pages found = mark_word(page, text) # mark the page's words if found: # if anything found ... new_doc = True print(f"found '{text}' {found} times on page {page.number + 1}") if new_doc: doc.save("marked-" + doc.name) This script uses `Page.get_text("words")` to look for a string, handed in via cli parameter. This method separates a page's text into "words" using white spaces as delimiters. Further remarks: * If found, the **complete word containing the string** is marked (underlined) -- not only the search string. * The search string may **not contain word delimiters**. By default, word delimiters are white spaces and the non-breaking space `chr(0xA0)`. If you use extra delimiting characters like `page.get_text("words", delimiters="./,")` then none of these characters should be included in your search string either. * As shown here, upper / lower cases are **respected**. But this can be changed by using the string method *lower()* (or even regular expressions) in function *mark_word*. * There is **no upper limit**: all occurrences will be detected. * You can use **anything** to mark the word: 'Underline', 'Highlight', 'StrikeThrough' or 'Square' annotations, etc. * Here is an example snippet of a page of this manual, where "MuPDF" has been used as the search string. Note that all strings **containing "MuPDF"** have been completely underlined (not just the search string). .. image:: images/img-markedpdf.* :scale: 60 ---------------------------------------------- .. _RecipesText_F: How to Mark Searched Text ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. codespell:ignore-begin This script searches for text and marks it:: # -*- coding: utf-8 -*- import pymupdf # the document to annotate doc = pymupdf.open("tilted-text.pdf") # the text to be marked needle = "¡La práctica hace el campeón!" # work with first page only page = doc[0] # get list of text locations # we use "quads", not rectangles because text may be tilted! rl = page.search_for(needle, quads=True) # mark all found quads with one annotation page.add_squiggly_annot(rl) # save to a new PDF doc.save("a-squiggly.pdf") .. codespell:ignore-end The result looks like this: .. image:: images/img-textmarker.* :scale: 80 ---------------------------------------------- .. _RecipesText_G: How to Mark Non-horizontal Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The previous section already shows an example for marking non-horizontal text, that was detected by text **searching**. But text **extraction** with the "dict" / "rawdict" options of :meth:`Page.get_text` may also return text with a non-zero angle to the x-axis. This is indicated by the value of the line dictionary's `"dir"` key: it is the tuple `(cosine, sine)` for that angle. If `line["dir"] != (1, 0)`, then the text of all its spans is rotated by (the same) angle != 0. The "bboxes" returned by the method however are rectangles only -- not quads. So, to mark span text correctly, its quad must be recovered from the data contained in the line and span dictionary. Do this with the following utility function (new in v1.18.9):: span_quad = pymupdf.recover_quad(line["dir"], span) annot = page.add_highlight_annot(span_quad) # this will mark the complete span text If you want to **mark the complete line** or a subset of its spans in one go, use the following snippet (works for v1.18.10 or later):: line_quad = pymupdf.recover_line_quad(line, spans=line["spans"][1:-1]) page.add_highlight_annot(line_quad) .. image:: images/img-linequad.* The `spans` argument above may specify any sub-list of `line["spans"]`. In the example above, the second to second-to-last span are marked. If omitted, the complete line is taken. ------------------------------ .. _RecipesText_H: How to Analyze Font Characteristics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To analyze the characteristics of text in a PDF use this elementary script as a starting point: .. literalinclude:: samples/text-lister.py :language: python Here is the PDF page and the script output: .. image:: images/img-pdftext.* :scale: 80 ----------------------------------------- .. _RecipesText_I: How to Insert Text ~~~~~~~~~~~~~~~~~~~~ PyMuPDF provides ways to insert text on new or existing PDF pages with the following features: * choose the font, including built-in fonts and fonts that are available as files * choose text characteristics like bold, italic, font size, font color, etc. * position the text in multiple ways: - either as simple line-oriented output starting at a certain point, - or fitting text in a box provided as a rectangle, in which case text alignment choices are also available, - choose whether text should be put in foreground (overlay existing content), - all text can be arbitrarily "morphed", i.e. its appearance can be changed via a :ref:`Matrix`, to achieve effects like scaling, shearing or mirroring, - independently from morphing and in addition to that, text can be rotated by integer multiples of 90 degrees. All of the above is provided by three basic :ref:`Page`, resp. :ref:`Shape` methods: * :meth:`Page.insert_font` -- install a font for the page for later reference. The result is reflected in the output of :meth:`Document.get_page_fonts`. The font can be: - provided as a file, - via :ref:`Font` (then use :attr:`Font.buffer`) - already present somewhere in **this or another** PDF, or - be a **built-in** font. * :meth:`Page.insert_text` -- write some lines of text. Internally, this uses :meth:`Shape.insert_text`. * :meth:`Page.insert_textbox` -- fit text in a given rectangle. Here you can choose text alignment features (left, right, centered, justified) and you keep control as to whether text actually fits. Internally, this uses :meth:`Shape.insert_textbox`. .. note:: Both text insertion methods automatically install the font as necessary. .. _RecipesText_I_a: How to Write Text Lines ^^^^^^^^^^^^^^^^^^^^^^^^^^ Output some text lines on a page:: import pymupdf doc = pymupdf.open(...) # new or existing PDF page = doc.new_page() # new or existing page via doc[n] p = pymupdf.Point(50, 72) # start point of 1st line text = "Some text,\nspread across\nseveral lines." # the same result is achievable by # text = ["Some text", "spread across", "several lines."] rc = page.insert_text(p, # bottom-left of 1st char text, # the text (honors '\n') fontname = "helv", # the default font fontsize = 11, # the default font size rotate = 0, # also available: 90, 180, 270 ) print(f"{rc} lines printed on page {page.number}.") doc.save("text.pdf") With this method, only the **number of lines** will be controlled to not go beyond page height. Surplus lines will not be written and the number of actual lines will be returned. The calculation uses a line height calculated from the :data:`fontsize` and 36 points (0.5 inches) as bottom margin. Line **width is ignored**. The surplus part of a line will simply be invisible. However, for built-in fonts there are ways to calculate the line width beforehand - see :meth:`get_text_length`. Here is another example. It inserts 4 text strings using the four different rotation options, and thereby explains, how the text insertion point must be chosen to achieve the desired result:: import pymupdf doc = pymupdf.open() page = doc.new_page() # the text strings, each having 3 lines text1 = "rotate=0\nLine 2\nLine 3" text2 = "rotate=90\nLine 2\nLine 3" text3 = "rotate=-90\nLine 2\nLine 3" text4 = "rotate=180\nLine 2\nLine 3" red = (1, 0, 0) # the color for the red dots # the insertion points, each with a 25 pix distance from the corners p1 = pymupdf.Point(25, 25) p2 = pymupdf.Point(page.rect.width - 25, 25) p3 = pymupdf.Point(25, page.rect.height - 25) p4 = pymupdf.Point(page.rect.width - 25, page.rect.height - 25) # create a Shape to draw on shape = page.new_shape() # draw the insertion points as red, filled dots shape.draw_circle(p1,1) shape.draw_circle(p2,1) shape.draw_circle(p3,1) shape.draw_circle(p4,1) shape.finish(width=0.3, color=red, fill=red) # insert the text strings shape.insert_text(p1, text1) shape.insert_text(p3, text2, rotate=90) shape.insert_text(p2, text3, rotate=-90) shape.insert_text(p4, text4, rotate=180) # store our work to the page shape.commit() doc.save(...) This is the result: .. image:: images/img-inserttext.* :scale: 33 ------------------------------------------ .. _RecipesText_I_b: How to Fill a Text Box ^^^^^^^^^^^^^^^^^^^^^^^^^^ This script fills 4 different rectangles with text, each time choosing a different rotation value:: import pymupdf doc = pymupdf.open() # new or existing PDF page = doc.new_page() # new page, or choose doc[n] # write in this overall area rect = pymupdf.Rect(100, 100, 300, 150) # partition the area in 4 equal sub-rectangles CELLS = pymupdf.make_table(rect, cols=4, rows=1) t1 = "text with rotate = 0." # these texts we will written t2 = "text with rotate = 90." t3 = "text with rotate = 180." t4 = "text with rotate = 270." text = [t1, t2, t3, t4] red = pymupdf.pdfcolor["red"] # some colors gold = pymupdf.pdfcolor["gold"] blue = pymupdf.pdfcolor["blue"] """ We use a Shape object (something like a canvas) to output the text and the rectangles surrounding it for demonstration. """ shape = page.new_shape() # create Shape for i in range(len(CELLS[0])): shape.draw_rect(CELLS[0][i]) # draw rectangle shape.insert_textbox( CELLS[0][i], text[i], fontname="hebo", color=blue, rotate=90 * i ) shape.finish(width=0.3, color=red, fill=gold) shape.commit() # write all stuff to the page doc.ez_save(__file__.replace(".py", ".pdf")) Some default values were used above: font size 11 and text alignment "left". The result will look like this: .. image:: images/img-rotate.* :scale: 50 ------------------------------------------ .. _RecipesText_I_c: How to Fill a Box with HTML Text ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Method :meth:`Page.insert_htmlbox` offers a **much more powerful** way to insert text in a rectangle. Instead of simple, plain text, this method accepts HTML source, which may not only contain HTML tags but also styling instructions to influence things like font, font weight (bold) and style (italic), color and much more. It is also possible to mix multiple fonts and languages, to output HTML tables and to insert images and URI links. For even more styling flexibility, an additional CSS source may also be given. The method is based on the :ref:`Story` class. Therefore, complex script systems like Devanagari, Nepali, Tamil and many are supported and written correctly thanks to using the HarfBuzz library - which provides this so-called **"text shaping"** feature. Any required fonts to output characters are automatically pulled in from the Google NOTO font library - as a fallback (when the -- optionally supplied -- user font(s) do not contain some glyphs). As a small glimpse into the features offered here, we will output the following HTML-enriched text:: import pymupdf rect = pymupdf.Rect(100, 100, 400, 300) text = """Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""" doc = pymupdf.Document() page = doc.new_page() page.insert_htmlbox(rect, text, css="* {font-family: sans-serif;font-size:14px;}") doc.ez_save(__file__.replace(".py", ".pdf")) Please note how the "css" parameter is used to globally select the default "sans-serif" font and a font size of 14. The result will look like this: .. image:: images/img-htmlbox1.* How to output HTML tables and images ....................................... Here is another example that outputs a table with this method. This time, we are including all the styling in the HTML source itself. Please also note, how it works to include an image - even within a table cell:: import pymupdf import os filedir = os.path.dirname(__file__) text = """

Some Colors

Lime Lemon Image Mauve
Green Yellow Between
Gray and Purple
""" doc = pymupdf.Document() page = doc.new_page() rect = page.rect + (36, 36, -36, -36) # we must specify an Archive because of the image page.insert_htmlbox(rect, text, archive=pymupdf.Archive(".")) doc.ez_save(__file__.replace(".py", ".pdf")) The result will look like this: .. image:: images/img-htmlbox2.* How to Output Languages of the World ....................................... Our third example will demonstrate the automatic multi-language support. It includes automatic **text shaping** for complex scripting systems like Devanagari and right-to-left languages:: import pymupdf greetings = ( "Hello, World!", # english "Hallo, Welt!", # german "سلام دنیا!", # persian "வணக்கம், உலகம்!", # tamil "สวัสดีชาวโลก!", # thai "Привіт Світ!", # ucranian "שלום עולם!", # hebrew "ওহে বিশ্ব!", # bengali "你好世界！", # chinese "こんにちは世界！", # japanese "안녕하세요, 월드!", # korean "नमस्कार, विश्व !", # sanskrit "हैलो वर्ल्ड!", # hindi ) doc = pymupdf.open() page = doc.new_page() rect = (50, 50, 200, 500) # join greetings into one text string text = " ... ".join([t for t in greetings]) # the output of the above is simple: page.insert_htmlbox(rect, text) doc.save(__file__.replace(".py", ".pdf")) And this is the output: .. image:: images/img-htmlbox3.* How to Specify your Own Fonts ................................. Define your font files in CSS syntax using the `@font-face` statement. You need a separate `@font-face` for every combination of font weight and font style (e.g. bold or italic) you want to be supported. The following example uses the famous MS Comic Sans font in its four variants regular, bold, italic and bold-italic. As these four font files are located in the system's folder `C:/Windows/Fonts` the method needs an :ref:`Archive` definition that points to that folder:: """ How to use your own fonts with method Page.insert_htmlbox(). """ import pymupdf # Example text text = """Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""" """ We need an Archive object to show where font files are located. We intend to use the font family "MS Comic Sans". """ arch = pymupdf.Archive("C:/Windows/Fonts") # These statements define which font file to use for regular, bold, # italic and bold-italic text. # We assign an arbitrary common font-family for all 4 font files. # The Story algorithm will select the right file as required. # We request to use "comic" throughout the text. css = """ @font-face {font-family: comic; src: url(comic.ttf);} @font-face {font-family: comic; src: url(comicbd.ttf);font-weight: bold;} @font-face {font-family: comic; src: url(comicz.ttf);font-weight: bold;font-style: italic;} @font-face {font-family: comic; src: url(comici.ttf);font-style: italic;} * {font-family: comic;} """ doc = pymupdf.Document() page = doc.new_page(width=150, height=150) # make small page page.insert_htmlbox(page.rect, text, css=css, archive=arch) doc.subset_fonts(verbose=True) # build subset fonts to reduce file size doc.ez_save(__file__.replace(".py", ".pdf")) .. image:: images/img-htmlbox4.* How to Request Text Alignment ................................ This example combines multiple requirements: * Rotate the text by 90 degrees anti-clockwise. * Use a font from package `pymupdf-fonts `_. You will see that the respective CSS definitions are a lot easier in this case. * Align the text with the "justify" option. :: """ How to use a pymupdf font with method Page.insert_htmlbox(). """ import pymupdf # Example text text = """Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""" """ This is similar to font file support. However, we can use a convenience function for creating required CSS definitions. We still need an Archive for finding the font binaries. """ arch = pymupdf.Archive() # We request to use "myfont" throughout the text. css = pymupdf.css_for_pymupdf_font("ubuntu", archive=arch, name="myfont") css += "* {font-family: myfont;text-align: justify;}" doc = pymupdf.Document() page = doc.new_page(width=150, height=150) page.insert_htmlbox(page.rect, text, css=css, archive=arch, rotate=90) doc.subset_fonts(verbose=True) doc.ez_save(__file__.replace(".py", ".pdf")) .. image:: images/img-htmlbox5.* | .. _RecipesText_J: How to Extract Text with Color ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Iterate through your text blocks and find the spans of text you need for this information. :: for page in doc: text_blocks = page.get_text("dict", flags=pymupdf.TEXTFLAGS_TEXT)["blocks"] for block in text_blocks: for line in block["lines"]: for span in line["spans"]: text = span["text"] color = pymupdf.sRGB_to_rgb(span["color"]) print(f"Text: {text}, Color: {color}") .. include:: footer.rst ================================================ FILE: docs/recipes.rst ================================================ .. include:: header.rst .. title:: PyMuPDF: How to Guide .. _RecipesTOC: .. toctree:: how-to-open-a-file.rst ---- .. toctree:: converting-files.rst ---- .. toctree:: recipes-ocr.rst ---- .. toctree:: recipes-text.rst ---- .. toctree:: recipes-images.rst ---- .. toctree:: recipes-annotations.rst ---- .. toctree:: recipes-drawing-and-graphics.rst ---- .. toctree:: recipes-stories.rst ---- .. toctree:: recipes-journalling.rst ---- .. toctree:: recipes-multiprocessing.rst ---- .. toctree:: recipes-optional-content.rst ---- .. toctree:: recipes-low-level-interfaces.rst ---- .. toctree:: recipes-common-issues-and-their-solutions.rst .. include:: footer.rst ================================================ FILE: docs/rect.rst ================================================ .. include:: header.rst .. _Rect: ========== Rect ========== *Rect* represents a rectangle defined by four floating point numbers x0, y0, x1, y1. They are treated as being coordinates of two diagonally opposite points. The first two numbers are regarded as the "top left" corner P\ :sub:`(x0,y0)` and P\ :sub:`(x1,y1)` as the "bottom right" one. However, these two properties need not coincide with their intuitive meanings -- read on. The following remarks are also valid for :ref:`IRect` objects: * A rectangle in the sense of (Py-) MuPDF **(and PDF)** always has **borders parallel to the x- resp. y-axis**. A general orthogonal tetragon **is not a rectangle** -- in contrast to the mathematical definition. * The constructing points can be (almost! -- see below) anywhere in the plane -- they need not even be different, and e.g. "top left" need not be the geometrical "north-western" point. * Units are in points, where 72 points is 1 inch. * For any given quadruple of numbers, the geometrically "same" rectangle can be defined in four different ways: 1. Rect(P\ :sub:`(x0,y0)`, P\ :sub:`(x1,y1)`\ ) 2. Rect(P\ :sub:`(x1,y1)`, P\ :sub:`(x0,y0)`\ ) 3. Rect(P\ :sub:`(x0,y1)`, P\ :sub:`(x1,y0)`\ ) 4. Rect(P\ :sub:`(x1,y0)`, P\ :sub:`(x0,y1)`\ ) **(Changed in v1.19.0)** Hence some classification: * A rectangle is called **valid** if `x0 <= x1` and `y0 <= y1` (i.e. the bottom right point is "south-eastern" to the top left one), otherwise **invalid**. Of the four alternatives above, **only the first** is valid. Please take into account, that in MuPDF's coordinate system, the y-axis is oriented from **top to bottom**. Invalid rectangles have been called infinite in earlier versions. * A rectangle is called **empty** if `x0 >= x1` or `y0 >= y1`. This implies, that **invalid rectangles are also always empty.** And `width` (resp. `height`) is **set to zero** if `x0 > x1` (resp. `y0 > y1`). In previous versions, a rectangle was empty only if one of width or height was zero. * Rectangle coordinates **cannot be outside** the number range from `FZ_MIN_INF_RECT = -2147483648` to `FZ_MAX_INF_RECT = 2147483520`. Both values have been chosen, because they are the smallest / largest 32bit integers that survive C float conversion roundtrips. In previous versions there was no limit for coordinate values. * There is **exactly one "infinite" rectangle**, defined by `x0 = y0 = FZ_MIN_INF_RECT` and `x1 = y1 = FZ_MAX_INF_RECT`. It contains every other rectangle. It is mainly used for technical purposes -- e.g. when a function call should ignore a formally required rectangle argument. This rectangle is not empty. * **Rectangles are (semi-) open:** The right and the bottom edges (including the resp. corners) are not considered part of the rectangle. This implies, that only the top-left corner `(x0, y0)` can ever belong to the rectangle - the other three corners never do. An empty rectangle contains no corners at all. .. image:: images/img-rect-contains.* :scale: 30 :align: center * Here is an overview of the changes. ================= =================================== ================================================== Notion Versions < 1.19.0 Versions 1.19.* ================= =================================== ================================================== empty x0 = x1 or y0 = y1 x0 >= x1 or y0 >= y1 -- includes invalid rects valid n/a x0 <= x1 and y0 <= y1 infinite all rects where x0 > x1 or y1 > y0 **exactly one infinite rect / irect!** coordinate values all numbers `FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT` borders, corners are parts of the rectangle right and bottom corners and edges **are outside** ================= =================================== ================================================== * There are new top level functions defining infinite and standard empty rectangles and quads, see :meth:`INFINITE_RECT` and friends. ============================= ======================================================= **Methods / Attributes** **Short Description** ============================= ======================================================= :meth:`Rect.contains` checks containment of point_likes and rect_likes :meth:`Rect.get_area` calculate rectangle area :meth:`Rect.include_point` enlarge rectangle to also contain a point :meth:`Rect.include_rect` enlarge rectangle to also contain another one :meth:`Rect.intersect` common part with another rectangle :meth:`Rect.intersects` checks for non-empty intersections :meth:`Rect.morph` transform with a point and a matrix :meth:`Rect.torect` the matrix that transforms to another rectangle :meth:`Rect.norm` the Euclidean norm :meth:`Rect.normalize` makes a rectangle valid :meth:`Rect.round` create smallest :ref:`Irect` containing rectangle :meth:`Rect.transform` transform rectangle with a matrix :attr:`Rect.bottom_left` bottom left point, synonym *bl* :attr:`Rect.bottom_right` bottom right point, synonym *br* :attr:`Rect.height` rectangle height :attr:`Rect.irect` equals result of method *round()* :attr:`Rect.is_empty` whether rectangle is empty :attr:`Rect.is_valid` whether rectangle is valid :attr:`Rect.is_infinite` whether rectangle is infinite :attr:`Rect.top_left` top left point, synonym *tl* :attr:`Rect.top_right` top_right point, synonym *tr* :attr:`Rect.quad` :ref:`Quad` made from rectangle corners :attr:`Rect.width` rectangle width :attr:`Rect.x0` left corners' x coordinate :attr:`Rect.x1` right corners' x -coordinate :attr:`Rect.y0` top corners' y coordinate :attr:`Rect.y1` bottom corners' y coordinate ============================= ======================================================= **Class API** .. class:: Rect .. method:: __init__(self) .. method:: __init__(self, x0, y0, x1, y1) .. method:: __init__(self, top_left, bottom_right) .. method:: __init__(self, top_left, x1, y1) .. method:: __init__(self, x0, y0, bottom_right) .. method:: __init__(self, rect) .. method:: __init__(self, sequence) Overloaded constructors: *top_left*, *bottom_right* stand for :data:`point_like` objects, "sequence" is a Python sequence type of 4 numbers (see :ref:`SequenceTypes`), "rect" means another :data:`rect_like`, while the other parameters mean coordinates. If "rect" is specified, the constructor creates a **new copy** of it. Without parameters, the empty rectangle ``Rect(0.0, 0.0, 0.0, 0.0)`` is created. .. method:: round() Creates the smallest containing :ref:`IRect`. This is **not the same** as simply rounding the rectangle's edges: The top left corner is rounded upwards and to the left while the bottom right corner is rounded downwards and to the right. >>> pymupdf.Rect(0.5, -0.01, 123.88, 455.123456).round() IRect(0, -1, 124, 456) 1. If the rectangle is **empty**, the result is also empty. 2. **Possible paradox:** The result may be empty, **even if** the rectangle is **not** empty! In such cases, the result obviously does **not** contain the rectangle. This is because MuPDF's algorithm allows for a small tolerance (1e-3). Example: >>> r = pymupdf.Rect(100, 100, 200, 100.001) >>> r.is_empty # rect is NOT empty False >>> r.round() # but its irect IS empty! pymupdf.IRect(100, 100, 200, 100) >>> r.round().is_empty True :rtype: :ref:`IRect` .. method:: transform(m) Transforms the rectangle with a matrix and **replaces the original**. If the rectangle is empty or infinite, this is a no-operation. :arg m: The matrix for the transformation. :type m: :data:`matrix_like` :rtype: ``Rect`` :returns: the smallest rectangle that contains the transformed original. .. method:: intersect(r) The intersection (common rectangular area, largest rectangle contained in both) of the current rectangle and *r* is calculated and **replaces the current** rectangle. If either rectangle is empty, the result is also empty. If *r* is infinite, this is a no-operation. If the rectangles are (mathematically) disjoint sets, then the result is invalid. If the result is valid but empty, then the rectangles touch each other in a corner or (part of) a side. :arg r: Second rectangle :type r: :data:`rect_like` .. method:: include_rect(r) The smallest rectangle containing the current one and ``r`` is calculated and **replaces the current** one. If either rectangle is infinite, the result is also infinite. If ``r`` is empty, the current rectangle remains unchanged. Else if the current rectangle is empty, it is replaced by ``r``. :arg r: Second rectangle :type r: :data:`rect_like` .. method:: include_point(p) The smallest rectangle containing the current one and :data:`point_like` ``p`` is calculated and **replaces the current** one. **The infinite rectangle remains unchanged.** To create the rectangle that wraps a sequence of points, start with :meth:`EMPTY_RECT` and successively include the members of the sequence. :arg p: Point to include. :type p: :data:`point_like` .. method:: get_area([unit]) Calculate the area of the rectangle and, with no parameter, equals *abs(rect)*. Like an empty rectangle, the area of an infinite rectangle is also zero. So, at least one of *pymupdf.Rect(p1, p2)* and *pymupdf.Rect(p2, p1)* has a zero area. :arg str unit: Specify required unit: respective squares of *px* (pixels, default), *in* (inches), *cm* (centimeters), or *mm* (millimeters). :rtype: float .. method:: contains(x) Checks whether *x* is contained in the rectangle. It may be an *IRect*, *Rect*, *Point* or number. If *x* is an empty rectangle, this is always true. If the rectangle is empty this is always ``False`` for all non-empty rectangles and for all points. `x in rect` and `rect.contains(x)` are equivalent. :arg x: the object to check. :type x: :data:`rect_like` or :data:`point_like`. :rtype: bool .. method:: intersects(r) Checks whether the rectangle and a :data:`rect_like` "r" contain a common non-empty :ref:`Rect`. This will always be ``False`` if either is infinite or empty. :arg rect_like r: the rectangle to check. :rtype: bool .. method:: torect(rect) * New in version 1.19.3 Compute the matrix which transforms this rectangle to a given one. :arg rect_like rect: the target rectangle. Must not be empty or infinite. :rtype: :ref:`Matrix` :returns: a matrix `mat` such that `self * mat = rect`. Can for example be used to transform between the page and the pixmap coordinates. See an example use here :ref:`RecipesImages_P`. .. method:: morph(fixpoint, matrix) * New in version 1.17.0 Return a new quad after applying a matrix to the rectangle using the fixed point `fixpoint`. :arg point_like fixpoint: the fixed point. :arg matrix_like matrix: the matrix. :returns: a new :ref:`Quad`. This a wrapper for the same-named quad method. If infinite, the infinite quad is returned. .. method:: norm() * New in version 1.16.0 Return the Euclidean norm of the rectangle treated as a vector of four numbers. .. method:: normalize() **Replace** the rectangle with its valid version. This is done by shuffling the rectangle corners. After completion of this method, the bottom right corner will indeed be south-eastern to the top left one (but may still be empty). .. attribute:: irect Equals result of method *round()*. .. attribute:: top_left .. attribute:: tl Equals *Point(x0, y0)*. :type: :ref:`Point` .. attribute:: top_right .. attribute:: tr Equals `Point(x1, y0)`. :type: :ref:`Point` .. attribute:: bottom_left .. attribute:: bl Equals `Point(x0, y1)`. :type: :ref:`Point` .. attribute:: bottom_right .. attribute:: br Equals `Point(x1, y1)`. :type: :ref:`Point` .. attribute:: quad The quadrilateral `Quad(rect.tl, rect.tr, rect.bl, rect.br)`. :type: :ref:`Quad` .. attribute:: width Width of the rectangle. Equals `max(x1 - x0, 0)`. :rtype: float .. attribute:: height Height of the rectangle. Equals `max(y1 - y0, 0)`. :rtype: float .. attribute:: x0 X-coordinate of the left corners. :type: float .. attribute:: y0 Y-coordinate of the top corners. :type: float .. attribute:: x1 X-coordinate of the right corners. :type: float .. attribute:: y1 Y-coordinate of the bottom corners. :type: float .. attribute:: is_infinite `True` if this is the infinite rectangle. :type: bool .. attribute:: is_empty `True` if rectangle is empty. :type: bool .. attribute:: is_valid `True` if rectangle is valid. :type: bool .. note:: * This class adheres to the Python sequence protocol, so components can be accessed via their index, too. Also refer to :ref:`SequenceTypes`. * Rectangles can be used with arithmetic operators -- see chapter :ref:`Algebra`. .. include:: footer.rst ================================================ FILE: docs/requirements.txt ================================================ rst2pdf # define sphinx versioning sphinx==8.1.3 furo readthedocs-sphinx-search==0.3.2 sphinx_copybutton sphinx-notfound-page sphinxcontrib-googleanalytics ================================================ FILE: docs/resources.rst ================================================ .. include:: header.rst Resources ============= **PyMuPDF Pro** -------------------- For **Office** file support `try PyMuPDF Pro `. | ---- Find out about **PyMuPDF Utilities** ------------------------------------------------- The :title:`GitHub` repository `PyMuPDF-Utilities `_ contains a full range of examples, demonstrations and use cases. | ---- .. _pdf2docx_conversion: Do you need |PDF| to **DOCX** conversion? -------------------------------------------------- We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-docx** library to provide simple document conversion from |PDF| to **DOCX** format. .. include:: footer.rst ================================================ FILE: docs/samples/annotations-freetext1.py ================================================ # -*- coding: utf-8 -*- import pymupdf # some colors blue = (0, 0, 1) green = (0, 1, 0) red = (1, 0, 0) gold = (1, 1, 0) # a new PDF with 1 page doc = pymupdf.open() page = doc.new_page() # 3 rectangles, same size, above each other r1 = pymupdf.Rect(100, 100, 200, 150) r2 = r1 + (0, 75, 0, 75) r3 = r2 + (0, 75, 0, 75) # the text, Latin alphabet t = "¡Un pequeño texto para practicar!" # add 3 annots, modify the last one somewhat a1 = page.add_freetext_annot(r1, t, text_color=red) a2 = page.add_freetext_annot(r2, t, fontname="Ti", text_color=blue) a3 = page.add_freetext_annot(r3, t, fontname="Co", text_color=blue, rotate=90) a3.set_border(width=0) a3.update(fontsize=8, fill_color=gold) # save the PDF doc.save("a-freetext.pdf") ================================================ FILE: docs/samples/annotations-freetext2.py ================================================ import pymupdf """Use rich text for FreeText annotations""" # define an overall styling ds = """font-size: 11pt; font-family: sans-serif;""" # some special characters bullet = chr(0x2610) + chr(0x2611) + chr(0x2612) # the annotation text with HTML and styling syntax text = f"""

PyMuPDF འདི་ ཡིག་ཆ་བཀྲམ་སྤེལ་གྱི་དོན་ལུ་ པའི་ཐོན་ཐུམ་སྒྲིལ་དྲག་ཤོས་དང་མགྱོགས་ཤོས་ཅིག་ཨིན། Here is some bold and italic text, followed by bold-italic. Text-based check boxes: {bullet}.

""" # here are some colors gold = (1, 1, 0) green = (0, 1, 0) # new/empty PDF doc = pymupdf.open() # make a page in ISO-A4 format page = doc.new_page() # text goes into this: rect = pymupdf.Rect(100, 100, 350, 200) # define some points for callout lines p2 = rect.tr + (50, 30) p3 = p2 + (0, 30) # define the annotation annot = page.add_freetext_annot( rect, text, fill_color=gold, # fill color opacity=1, # non-transparent rotate=0, # no rotation border_width=1, # border and callout line width dashes=None, # no dashing richtext=True, # this is rich text style=ds, # my styling default callout=(p3, p2, rect.tr), # define end, knee, start points line_end=pymupdf.PDF_ANNOT_LE_OPEN_ARROW, # symbol shown at p3 border_color=green, ) doc.save(__file__.replace(".py", ".pdf"), pretty=True) ================================================ FILE: docs/samples/annotations-ink.py ================================================ import math import pymupdf #------------------------------------------------------------------------------ # preliminary stuff: create function value lists for sine and cosine #------------------------------------------------------------------------------ w360 = math.pi * 2 # go through full circle deg = w360 / 360 # 1 degree as radians rect = pymupdf.Rect(100,200, 300, 300) # use this rectangle first_x = rect.x0 # x starts from left first_y = rect.y0 + rect.height / 2. # rect middle means y = 0 x_step = rect.width / 360 # rect width means 360 degrees y_scale = rect.height / 2. # rect height means 2 sin_points = [] # sine values go here cos_points = [] # cosine values go here for x in range(362): # now fill in the values x_coord = x * x_step + first_x # current x coordinate y = -math.sin(x * deg) # sine p = (x_coord, y * y_scale + first_y) # corresponding point sin_points.append(p) # append y = -math.cos(x * deg) # cosine p = (x_coord, y * y_scale + first_y) # corresponding point cos_points.append(p) # append #------------------------------------------------------------------------------ # create the document with one page #------------------------------------------------------------------------------ doc = pymupdf.open() # make new PDF page = doc.new_page() # give it a page #------------------------------------------------------------------------------ # add the Ink annotation, consisting of 2 curve segments #------------------------------------------------------------------------------ annot = page.add_ink_annot((sin_points, cos_points)) # let it look a little nicer annot.set_border(width=0.3, dashes=[1,]) # line thickness, some dashing annot.set_colors(stroke=(0,0,1)) # make the lines blue annot.update() # update the appearance page.draw_rect(rect, width=0.3) # only to demonstrate we did OK doc.save("a-inktest.pdf") ================================================ FILE: docs/samples/code-printer.py ================================================ """ Demo script PyMuPDF Story class ------------------------------- Read the Python sources in the script directory and create a PDF of all their source codes. The following features are included as a specialty: 1. HTML source for pymupdf.Story created via Python API exclusively 2. Separate Story objects for page headers and footers 3. Use of HTML "id" elements for identifying source start pages 4. Generate a Table of Contents pointing to source file starts. This - uses the new Stoy callback feature - uses Story also for making the TOC page(s) """ import io import os import time import pymupdf THISDIR = os.path.dirname(os.path.abspath(__file__)) TOC = [] # this will contain the TOC list items CURRENT_ID = "" # currently processed filename - stored by recorder func MEDIABOX = pymupdf.paper_rect("a4-l") # chosen page size WHERE = MEDIABOX + (36, 50, -36, -36) # sub rectangle for source content # location of the header rectangle HDR_WHERE = (36, 5, MEDIABOX.width - 36, 40) # location of the footer rectangle FTR_WHERE = (36, MEDIABOX.height - 36, MEDIABOX.width - 36, MEDIABOX.height) def recorder(elpos): """Callback function invoked during story.place(). This function generates / collects all TOC items and updates the value of CURRENT_ID - which is used to update the footer line of each page. """ global TOC, CURRENT_ID if not elpos.open_close & 1: # only consider "open" items return level = elpos.heading y0 = elpos.rect[1] # top of written rectangle (use for TOC) if level > 0: # this is a header (h1 - h6) pno = elpos.page + 1 # the page number TOC.append( ( level, elpos.text, elpos.page + 1, y0, ) ) return CURRENT_ID = elpos.id if elpos.id else "" # update for footer line return def header_story(text): """Make the page header""" header = pymupdf.Story() hdr_body = header.body hdr_body.add_paragraph().set_properties( align=pymupdf.TEXT_ALIGN_CENTER, bgcolor="#eee", font="sans-serif", bold=True, fontsize=12, color="green", ).add_text(text) return header def footer_story(text): """Make the page footer""" footer = pymupdf.Story() ftr_body = footer.body ftr_body.add_paragraph().set_properties( bgcolor="#eee", align=pymupdf.TEXT_ALIGN_CENTER, color="blue", fontsize=10, font="sans-serif", ).add_text(text) return footer def code_printer(outfile): """Output the generated PDF to outfile.""" global MAX_TITLE_LEN where = +WHERE writer = pymupdf.DocumentWriter(outfile, "") print_time = time.strftime("%Y-%m-%d %H:%M:%S (%z)") thispath = os.path.abspath(os.curdir) basename = os.path.basename(thispath) story = pymupdf.Story() body = story.body body.set_properties(font="sans-serif") text = f"Python sources in folder '{THISDIR}'" body.add_header(1).add_text(text) # the only h1 item in the story files = os.listdir(THISDIR) # list / select Python files in our directory i = 1 for code_file in files: if not code_file.endswith(".py"): continue # read Python file source fileinput = open(os.path.join(THISDIR, code_file), "rb") text = fileinput.read().decode() fileinput.close() # make level 2 header hdr = body.add_header(2) if i > 1: hdr.set_pagebreak_before() hdr.add_text(f"{i}. Listing of file '{code_file}'") # Write the file code body.add_codeblock().set_bgcolor((240, 255, 210)).set_color("blue").set_id( code_file ).set_fontsize(10).add_text(text) # Indicate end of a source file body.add_paragraph().set_align(pymupdf.TEXT_ALIGN_CENTER).add_text( f"---------- End of File '{code_file}' ----------" ) i += 1 # update file counter i = 0 while True: i += 1 device = writer.begin_page(MEDIABOX) # create Story objects for header, footer and the rest. header = header_story(f"Python Files in '{THISDIR}'") hdr_ok, _ = header.place(HDR_WHERE) if hdr_ok != 0: raise ValueError("header does not fit") header.draw(device, None) # -------------------------------------------------------------- # Write the file content. # -------------------------------------------------------------- more, filled = story.place(where) # Inform the callback function # Args: # recorder: the Python function to call # {}: dictionary containing anything - we pass the page number story.element_positions(recorder, {"page": i - 1}) story.draw(device, None) # -------------------------------------------------------------- # Make / write page footer. # We MUST have a paragraph b/o background color / alignment # -------------------------------------------------------------- if CURRENT_ID: text = f"File '{CURRENT_ID}' printed at {print_time}{chr(160)*5}{'-'*10}{chr(160)*5}Page {i}" else: text = f"Printed at {print_time}{chr(160)*5}{'-'*10}{chr(160)*5}Page {i}" footer = footer_story(text) # write the page footer ftr_ok, _ = footer.place(FTR_WHERE) if ftr_ok != 0: raise ValueError("footer does not fit") footer.draw(device, None) writer.end_page() if more == 0: break writer.close() if __name__ == "__main__" or os.environ.get('PYTEST_CURRENT_TEST'): fileptr1 = io.BytesIO() t0 = time.perf_counter() code_printer(fileptr1) # make the PDF t1 = time.perf_counter() doc = pymupdf.open("pdf", fileptr1) old_count = doc.page_count # ----------------------------------------------------------------------------- # Post-processing step to make / insert the toc # This also works using pymupdf.Story: # - make a new PDF in memory which contains pages with the TOC text # - add these TOC pages to the end of the original file # - search item text on the inserted pages and cover each with a PDF link # - move the TOC pages to the front of the document # ----------------------------------------------------------------------------- story = pymupdf.Story() body = story.body body.add_header(1).set_font("sans-serif").add_text("Table of Contents") # prefix TOC with an entry pointing to this page TOC.insert(0, [1, "Table of Contents", old_count + 1, 36]) for item in TOC[1:]: # write the file name headers as TOC lines body.add_paragraph().set_font("sans-serif").add_text( item[1] + f" - ({item[2]})" ) fileptr2 = io.BytesIO() # put TOC pages to a separate PDF initially writer = pymupdf.DocumentWriter(fileptr2) i = 1 more = 1 while more: device = writer.begin_page(MEDIABOX) header = header_story(f"Python Files in '{THISDIR}'") # write the page header hdr_ok, _ = header.place(HDR_WHERE) header.draw(device, None) more, filled = story.place(WHERE) story.draw(device, None) footer = footer_story(f"TOC-{i}") # separate page numbering scheme # write the page footer ftr_ok, _ = footer.place(FTR_WHERE) footer.draw(device, None) writer.end_page() i += 1 writer.close() doc2 = pymupdf.open("pdf", fileptr2) # open TOC pages as another PDF doc.insert_pdf(doc2) # and append to the main PDF new_range = range(old_count, doc.page_count) # the TOC page numbers pages = [doc[i] for i in new_range] # these are the TOC pages within main PDF for item in TOC: # search for TOC item text to get its rectangle for page in pages: rl = page.search_for(item[1], flags=pymupdf.TEXTFLAGS_SEARCH) if rl != []: # this text must be on next page break else: assert 0, f'Cannot find {item[1]=} in {len(pages)=}.' rect = rl[0] # rectangle of TOC item text link = { # make a link from it "kind": pymupdf.LINK_GOTO, "from": rect, "to": pymupdf.Point(0, item[3]), "page": item[2] - 1, } page.insert_link(link) # insert the TOC in the main PDF doc.set_toc(TOC) # move all the TOC pages to the desired place (1st page here) for i in new_range: doc.move_page(doc.page_count - 1, 0) doc.ez_save(__file__.replace(".py", ".pdf")) ================================================ FILE: docs/samples/filmfestival-sql.py ================================================ """ This is a demo script for using PyMuPDF with its "Story" feature. The following aspects are being covered here: * The script produces a report of films that are stored in an SQL database * The report format is provided as a HTML template The SQL database contains two tables: 1. Table "films" which has the columns "title" (film title, str), "director" (str) and "year" (year of release, int). 2. Table "actors" which has the columns "name" (actor name, str) and "title" (the film title where the actor had been casted, str). The script reads all content of the "films" table. For each film title it reads all rows from table "actors" which took part in that film. Comment 1 --------- To keep things easy and free from pesky technical detail, the relevant file names inherit the name of this script: - the database's filename is the script name with ".py" extension replaced by ".db". - the output PDF similarly has script file name with extension ".pdf". Comment 2 --------- The SQLITE database has been created using https://sqlitebrowser.org/, a free multi-platform tool to maintain or manipulate SQLITE databases. """ import os import sqlite3 import pymupdf # ---------------------------------------------------------------------- # HTML template for the film report # There are four placeholders coded as "id" attributes. # One "id" allows locating the template part itself, the other three # indicate where database text should be inserted. # ---------------------------------------------------------------------- festival_template = ( "Just some arbitrary text" '

Hook Norton Film Festival

' "
    " '
  1. ' '' "
    " '
    Director
    ' '
    Release Year
    ' '
    Cast
    ' "
    " "
    2. " "
" "= num_pages! seg_size = int(num_pages / cpu + 1) seg_from = idx * seg_size # our first page number seg_to = min(seg_from + seg_size, num_pages) # last page number for i in range(seg_from, seg_to): # work through our page segment page = doc[i] # page.get_text("rawdict") # use any page-related type of work here, eg pix = page.get_pixmap(alpha=False, matrix=mat) # store away the result somewhere ... # pix.save("p-%i.png" % i) print(f"Processed page numbers {seg_from} through {seg_to - 1}") if __name__ == "__main__": t0 = mytime() # start a timer filename = sys.argv[1] mat = pymupdf.Matrix(0.2, 0.2) # the rendering matrix: scale down to 20% cpu = cpu_count() # make vectors of arguments for the processes vectors = [(i, cpu, filename, mat) for i in range(cpu)] print(f"Starting {cpu} processes for '{filename}'.") pool = Pool() # make pool of 'cpu_count()' processes pool.map(render_page, vectors, 1) # start processes passing each a vector t1 = mytime() # stop the timer print(f"Total time {round(t1 - t0, 2):g} seconds") ================================================ FILE: docs/samples/national-capitals.py ================================================ """ Demo script using (Py-) MuPDF "Story" feature. The following features are implemented: * Use of Story "template" feature to provide row content * Use database access (SQLITE) to fetch row content * Use ElementPosition feature to locate cell positions on page * Simulate feature "Table Header Repeat" * Simulate feature "Cell Grid Lines" """ import io import sqlite3 import sys import pymupdf """ Table data. Used to populate a temporary SQL database, which will be processed by the script. Its only purpose is to avoid carrying around a separate database file. """ # codespell:ignore-begin table_data = """China;Beijing;21542000;1.5%;2018 Japan;Tokyo;13921000;11.2%;2019 DR Congo;Kinshasa;12691000;13.2%;2017 Russia;Moscow;12655050;8.7%;2021 Indonesia;Jakarta;10562088;3.9%;2020 Egypt;Cairo;10107125;9.3%;2022 South Korea;Seoul;9508451;18.3%;2022 Mexico;Mexico City;9209944;7.3%;2020 United Kingdom;London;9002488;13.4%;2020 Bangladesh;Dhaka;8906039;5.3%;2011 Peru;Lima;8852000;26.3%;2012 Iran;Tehran;8693706;9.9%;2016 Thailand;Bangkok;8305218;11.6%;2010 Vietnam;Hanoi;8053663;8.3%;2019 Iraq;Baghdad;7682136;17.6%;2021 Saudi Arabia;Riyadh;7676654;21.4%;2018 Hong Kong;Hong Kong;7291600;100%;2022 Colombia;Bogotá;7181469;13.9%;2011 Chile;Santiago;6310000;32.4%;2012 Turkey;Ankara;5747325;6.8%;2021 Singapore;Singapore;5453600;91.8%;2021 Afghanistan;Kabul;4601789;11.5%;2021 Kenya;Nairobi;4397073;8.3%;2019 Jordan;Amman;4061150;36.4%;2021 Algeria;Algiers;3915811;8.9%;2011 Germany;Berlin;3677472;4.4%;2021 Spain;Madrid;3305408;7.0%;2021 Ethiopia;Addis Ababa;3040740;2.5%;2012 Kuwait;Kuwait City;2989000;70.3%;2018 Guatemala;Guatemala City;2934841;16.7%;2020 South Africa;Pretoria;2921488;4.9%;2011 Ukraine;Kyiv;2920873;6.7%;2021 Argentina;Buenos Aires;2891082;6.4%;2010 North Korea;Pyongyang;2870000;11.1%;2016 Uzbekistan;Tashkent;2860600;8.4%;2022 Italy;Rome;2761632;4.7%;2022 Ecuador;Quito;2800388;15.7%;2020 Cameroon;Yaoundé;2765568;10.2%;2015 Zambia;Lusaka;2731696;14.0%;2020 Sudan;Khartoum;2682431;5.9%;2012 Brazil;Brasília;2648532;1.2%;2012 Taiwan;Taipei (de facto);2608332;10.9%;2020 Yemen;Sanaa;2575347;7.8%;2012 Angola;Luanda;2571861;7.5%;2020 Burkina Faso;Ouagadougou;2453496;11.1%;2019 Ghana;Accra;2388000;7.3%;2017 Somalia;Mogadishu;2388000;14.0%;2021 Azerbaijan;Baku;2303100;22.3%;2022 Cambodia;Phnom Penh;2281951;13.8%;2019 Venezuela;Caracas;2245744;8.0%;2016 France;Paris;2139907;3.3%;2022 Cuba;Havana;2132183;18.9%;2020 Zimbabwe;Harare;2123132;13.3%;2012 Syria;Damascus;2079000;9.7%;2019 Belarus;Minsk;1996553;20.8%;2022 Austria;Vienna;1962779;22.0%;2022 Poland;Warsaw;1863056;4.9%;2021 Philippines;Manila;1846513;1.6%;2020 Mali;Bamako;1809106;8.3%;2009 Malaysia;Kuala Lumpur;1782500;5.3%;2019 Romania;Bucharest;1716983;8.9%;2021 Hungary;Budapest;1706851;17.6%;2022 Congo;Brazzaville;1696392;29.1%;2015 Serbia;Belgrade;1688667;23.1%;2021 Uganda;Kampala;1680600;3.7%;2019 Guinea;Conakry;1660973;12.3%;2014 Mongolia;Ulaanbaatar;1466125;43.8%;2020 Honduras;Tegucigalpa;1444085;14.0%;2021 Senegal;Dakar;1438725;8.5%;2021 Niger;Niamey;1334984;5.3%;2020 Uruguay;Montevideo;1319108;38.5%;2011 Bulgaria;Sofia;1307439;19.0%;2021 Oman;Muscat;1294101;28.6%;2021 Czech Republic;Prague;1275406;12.1%;2022 Madagascar;Antananarivo;1275207;4.4%;2018 Kazakhstan;Astana;1239900;6.5%;2022 Nigeria;Abuja;1235880;0.6%;2011 Georgia;Tbilisi;1201769;32.0%;2022 Mauritania;Nouakchott;1195600;25.9%;2019 Qatar;Doha;1186023;44.1%;2020 Libya;Tripoli;1170000;17.4%;2019 Myanmar;Naypyidaw;1160242;2.2%;2014 Rwanda;Kigali;1132686;8.4%;2012 Mozambique;Maputo;1124988;3.5%;2020 Dominican Republic;Santo Domingo;1111838;10.0%;2010 Armenia;Yerevan;1096100;39.3%;2021 Kyrgyzstan;Bishkek;1074075;16.5%;2021 Sierra Leone;Freetown;1055964;12.5%;2015 Nicaragua;Managua;1055247;15.4%;2020 Canada;Ottawa;1017449;2.7%;2021 Pakistan;Islamabad;1014825;0.4%;2017 Liberia;Monrovia;1010970;19.5%;2008 United Arab Emirates;Abu Dhabi;1010092;10.8%;2020 Malawi;Lilongwe;989318;5.0%;2018 Haiti;Port-au-Prince;987310;8.6%;2015 Sweden;Stockholm;978770;9.4%;2021 Eritrea;Asmara;963000;26.6%;2020 Israel;Jerusalem;936425;10.5%;2019 Laos;Vientiane;927724;12.5%;2019 Chad;N'Djamena;916000;5.3%;2009 Netherlands;Amsterdam;905234;5.2%;2022 Central African Republic;Bangui;889231;16.3%;2020 Panama;Panama City;880691;20.2%;2013 Tajikistan;Dushanbe;863400;8.9%;2020 Nepal;Kathmandu;845767;2.8%;2021 Togo;Lomé;837437;9.7%;2010 Turkmenistan;Ashgabat;791000;12.5%;2017 Moldova;Chişinău;779300;25.5%;2019 Croatia;Zagreb;769944;19.0%;2021 Gabon;Libreville;703904;30.1%;2013 Norway;Oslo;697010;12.9%;2021 Macau;Macau;671900;97.9%;2022 United States;Washington D.C.;670050;0.2%;2021 Jamaica;Kingston;662491;23.4%;2019 Finland;Helsinki;658864;11.9%;2021 Tunisia;Tunis;638845;5.2%;2014 Denmark;Copenhagen;638117;10.9%;2021 Greece;Athens;637798;6.1%;2021 Latvia;Riga;605802;32.3%;2021 Djibouti;Djibouti (city);604013;54.6%;2012 Ireland;Dublin;588233;11.8%;2022 Morocco;Rabat;577827;1.6%;2014 Lithuania;Vilnius;576195;20.7%;2022 El Salvador;San Salvador;570459;9.0%;2019 Albania;Tirana;557422;19.5%;2011 North Macedonia;Skopje;544086;25.9%;2015 South Sudan;Juba;525953;4.9%;2017 Paraguay;Asunción;521559;7.8%;2020 Portugal;Lisbon;509614;5.0%;2020 Guinea-Bissau;Bissau;492004;23.9%;2015 Slovakia;Bratislava;440948;8.1%;2020 Estonia;Tallinn;438341;33.0%;2021 Australia;Canberra;431380;1.7%;2020 Namibia;Windhoek;431000;17.0%;2020 Tanzania;Dodoma;410956;0.6%;2012 Papua New Guinea;Port Moresby;364145;3.7%;2011 Ivory Coast;Yamoussoukro;361893;1.3%;2020 Lebanon;Beirut;361366;6.5%;2014 Bolivia;Sucre;360544;3.0%;2022 Puerto Rico (US);San Juan;342259;10.5%;2020 Costa Rica;San José;342188;6.6%;2018 Lesotho;Maseru;330760;14.5%;2016 Cyprus;Nicosia;326739;26.3%;2016 Equatorial Guinea;Malabo;297000;18.2%;2018 Slovenia;Ljubljana;285604;13.5%;2021 East Timor;Dili;277279;21.0%;2015 Bosnia and Herzegovina;Sarajevo;275524;8.4%;2013 Bahamas;Nassau;274400;67.3%;2016 Botswana;Gaborone;273602;10.6%;2020 Benin;Porto-Novo;264320;2.0%;2013 Suriname;Paramaribo;240924;39.3%;2012 India;New Delhi;249998;0.0%;2011 Sahrawi Arab Democratic Republic;Laayoune (claimed) - Tifariti (de facto);217732 - 3000;—;2014 New Zealand;Wellington;217000;4.2%;2021 Bahrain;Manama;200000;13.7%;2020 Kosovo;Pristina;198897;12.0%;2011 Montenegro;Podgorica;190488;30.3%;2020 Belgium;Brussels;187686;1.6%;2022 Cape Verde;Praia;159050;27.1%;2017 Mauritius;Port Louis;147066;11.3%;2018 Curaçao (Netherlands);Willemstad;136660;71.8%;2011 Burundi;Gitega;135467;1.1%;2020 Switzerland;Bern (de facto);134591;1.5%;2020 Transnistria;Tiraspol;133807;38.5%;2015 Maldives;Malé;133412;25.6%;2014 Iceland;Reykjavík;133262;36.0%;2021 Luxembourg;Luxembourg City;124509;19.5%;2021 Guyana;Georgetown;118363;14.7%;2012 Bhutan;Thimphu;114551;14.7%;2017 Comoros;Moroni;111326;13.5%;2016 Barbados;Bridgetown;110000;39.1%;2014 Sri Lanka;Sri Jayawardenepura Kotte;107925;0.5%;2012 Brunei;Bandar Seri Begawan;100700;22.6%;2007 Eswatini;Mbabane;94874;8.0%;2010 New Caledonia (France);Nouméa;94285;32.8%;2019 Fiji;Suva;93970;10.2%;2017 Solomon Islands;Honiara;92344;13.0%;2021 Republic of Artsakh;Stepanakert;75000;62.5%;2021 Gambia;Banjul;73000;2.8%;2013 São Tomé and Príncipe;São Tomé;71868;32.2%;2015 Kiribati;Tarawa;70480;54.7%;2020 Vanuatu;Port Vila;51437;16.1%;2016 Northern Mariana Islands (USA);Saipan;47565;96.1%;2017 Samoa;Apia;41611;19.0%;2021 Palestine;Ramallah (de facto);38998;0.8%;2017 Monaco;Monaco;38350;104.5%;2020 Jersey (UK);Saint Helier;37540;34.2%;2018 Trinidad and Tobago;Port of Spain;37074;2.4%;2011 Cayman Islands (UK);George Town;34399;50.5%;2021 Gibraltar (UK);Gibraltar;34003;104.1%;2020 Grenada;St. George's;33734;27.1%;2012 Aruba (Netherlands);Oranjestad;28294;26.6%;2010 Isle of Man (UK);Douglas;27938;33.2%;2011 Marshall Islands;Majuro;27797;66.1%;2011 Tonga;Nukuʻalofa;27600;26.0%;2022 Seychelles;Victoria;26450;24.8%;2010 French Polynesia (France);Papeete;26926;8.9%;2017 Andorra;Andorra la Vella;22873;28.9%;2022 Faroe Islands (Denmark);Tórshavn;22738;43.0%;2022 Antigua and Barbuda;St. John's;22219;23.8%;2011 Belize;Belmopan;20621;5.2%;2016 Saint Lucia;Castries;20000;11.1%;2013 Guernsey (UK);Saint Peter Port;18958;30.1%;2019 Greenland (Denmark);Nuuk;18800;33.4%;2021 Dominica;Roseau;14725;20.3%;2011 Saint Kitts and Nevis;Basseterre;14000;29.4%;2018 Saint Vincent and the Grenadines;Kingstown;12909;12.4%;2012 British Virgin Islands (UK);Road Town;12603;40.5%;2012 Åland (Finland);Mariehamn;11736;39.0%;2021 U.S. Virgin Islands (US);Charlotte Amalie;14477;14.5%;2020 Micronesia;Palikir;6647;5.9%;2010 Tuvalu;Funafuti;6320;56.4%;2017 Malta;Valletta;5827;1.1%;2019 Liechtenstein;Vaduz;5774;14.8%;2021 Saint Pierre and Miquelon (France);Saint-Pierre;5394;91.7%;2019 Cook Islands (NZ);Avarua;4906;28.9%;2016 San Marino;City of San Marino;4061;12.0%;2021 Turks and Caicos Islands (UK);Cockburn Town;3720;8.2%;2016 American Samoa (USA);Pago Pago;3656;8.1%;2010 Saint Martin (France);Marigot;3229;10.1%;2017 Saint Barthélemy (France);Gustavia;2615;24.1%;2010 Falkland Islands (UK);Stanley;2460;65.4%;2016 Svalbard (Norway);Longyearbyen;2417;82.2%;2020 Sint Maarten (Netherlands);Philipsburg;1894;4.3%;2011 Christmas Island (Australia);Flying Fish Cove;1599;86.8%;2016 Anguilla (UK);The Valley;1067;6.8%;2011 Guam (US);Hagåtña;1051;0.6%;2010 Wallis and Futuna (France);Mata Utu;1029;8.9%;2018 Bermuda (UK);Hamilton;854;1.3%;2016 Nauru;Yaren (de facto);747;6.0%;2011 Saint Helena (UK);Jamestown;629;11.6%;2016 Niue (NZ);Alofi;597;30.8%;2017 Tokelau (NZ);Atafu;541;29.3%;2016 Vatican City;Vatican City (city-state);453;100%;2019 Montserrat (UK);Brades (de facto) - Plymouth (de jure);449 - 0;-;2011 Norfolk Island (Australia);Kingston;341;-;2015 Palau;Ngerulmud;271;1.5%;2010 Cocos (Keeling) Islands (Australia);West Island;134;24.6%;2011 Pitcairn Islands (UK);Adamstown;40;100.0%;2021 South Georgia and the South Sandwich Islands (UK);King Edward Point;22;73.3%;2018""" # codespell:ignore-end # ------------------------------------------------------------------- # HTML template for the report. We define no table header items # because this is done in post processing. # The actual template part is the table row, identified by id "row". # The content of each cell will be filled using the respective id. # ------------------------------------------------------------------- HTML = """

World Capital Cities

Percent "%" is city population as a percentage of the country, as of "Year".

""" # ------------------------------------------------------------------- # Sets font-family globally to sans-serif, and text-align to right # for the numerical table columns. # ------------------------------------------------------------------- CSS = """ body { font-family: sans-serif; } td[id="population"], td[id="percent"], td[id="year"] { text-align: right; padding-right: 2px; }""" # ------------------------------------------------------------------- # recorder function for cell positions # ------------------------------------------------------------------- coords = {} # stores cell gridline coordinates def recorder(elpos): """We only record positions of table rows and cells. Information is stored in "coords" with page number as key. """ global coords # dictionary of row and cell coordinates per page if elpos.open_close != 2: # only consider coordinates provided at "close" return if elpos.id not in ("row", "country", "capital", "population", "percent", "year"): return # only look at row / cell content rect = pymupdf.Rect(elpos.rect) # cell rectangle if rect.y1 > elpos.filled: # ignore stuff below the filled rectangle return # per page, we store the floats top-most y, right-most x, column left # and row bottom borders. x, y, x1, y0 = coords.get(elpos.page, (set(), set(), 0, sys.maxsize)) if elpos.id != "row": x.add(rect.x0) # add cell left border coordinate if rect.x1 > x1: # store right-most cell border on page x1 = rect.x1 else: y.add(rect.y1) # add row bottom border coordinate if rect.y0 < y0: # store top-most cell border per page y0 = rect.y0 coords[elpos.page] = (x, y, x1, y0) # write back info per page return # ------------------------------------------------------------------- # define database access: make an intermediate memory database for # our demo purposes. # ------------------------------------------------------------------- dbfilename = ":memory:" # the SQLITE database file name database = sqlite3.connect(dbfilename) # open database cursor = database.cursor() # multi-purpose database cursor # Define and fill the SQLITE database cursor.execute( """CREATE TABLE capitals (Country text, Capital text, Population text, Percent text, Year text)""" ) for value in table_data.splitlines(): cursor.execute("INSERT INTO capitals VALUES (?,?,?,?,?)", value.split(";")) # select statement for the rows - let SQL also sort it for us select = """SELECT * FROM capitals ORDER BY "Country" """ # ------------------------------------------------------------------- # define the HTML Story and fill it with database data # ------------------------------------------------------------------- story = pymupdf.Story(HTML, user_css=CSS) body = story.body # access the HTML body detail template = body.find(None, "id", "row") # find the template part table = body.find("table", None, None) # find start of table # read the rows from the database and put them all in one Python list # NOTE: instead, we might fetch rows one by one (advisable for large volumes) cursor.execute(select) # execute cursor, and ... rows = cursor.fetchall() # read out what was found database.close() # no longer needed for country, capital, population, percent, year in rows: # iterate through the row row = template.clone() # clone the template to report each row row.find(None, "id", "country").add_text(country) row.find(None, "id", "capital").add_text(capital) row.find(None, "id", "population").add_text(population) row.find(None, "id", "percent").add_text(percent) row.find(None, "id", "year").add_text(year) table.append_child(row) template.remove() # remove the template # ------------------------------------------------------------------- # generate the PDF and write it to memory # ------------------------------------------------------------------- fp = io.BytesIO() writer = pymupdf.DocumentWriter(fp) mediabox = pymupdf.paper_rect("letter") # use pages in Letter format where = mediabox + (36, 36, -36, -72) # leave page borders more = True page = 0 while more: dev = writer.begin_page(mediabox) # make a new page if page > 0: # leave room above the cells for inserting header row delta = (0, 20, 0, 0) else: delta = (0, 0, 0, 0) more, filled = story.place(where + delta) # arrange content on this rectangle story.element_positions(recorder, {"page": page, "filled": where.y1}) story.draw(dev) # write content to page writer.end_page() # finish the page page += 1 writer.close() # close the PDF # ------------------------------------------------------------------- # re-open memory PDF for inserting gridlines and header rows # ------------------------------------------------------------------- doc = pymupdf.open("pdf", fp) for page in doc: page.wrap_contents() # ensure all "cm" commands are properly wrapped x, y, x1, y0 = coords[page.number] # read coordinates of the page x = sorted(list(x)) + [x1] # list of cell left-right borders y = [y0] + sorted(list(y)) # list of cell top-bottom borders shape = page.new_shape() # make a canvas to draw upon for item in y: # draw horizontal lines (one under each row) shape.draw_line((x[0] - 2, item), (x[-1] + 2, item)) for i in range(len(y)): # alternating row coloring if i % 2: rect = (x[0] - 2, y[i - 1], x[-1] + 2, y[i]) shape.draw_rect(rect) for i in range(len(x)): # draw vertical lines d = 2 if i == len(x) - 1 else -2 shape.draw_line((x[i] + d, y[0]), (x[i] + d, y[-1])) # Write header row above table content y0 -= 5 # bottom coord for header row text shape.insert_text((x[0], y0), "Country", fontname="hebo", fontsize=12) shape.insert_text((x[1], y0), "Capital", fontname="hebo", fontsize=12) shape.insert_text((x[2], y0), "Population", fontname="hebo", fontsize=12) shape.insert_text((x[3], y0), " %", fontname="hebo", fontsize=12) shape.insert_text((x[4], y0), "Year", fontname="hebo", fontsize=12) # Write page footer y0 = page.rect.height - 50 # top coordinate of footer bbox bbox = pymupdf.Rect(0, y0, page.rect.width, y0 + 20) # footer bbox page.insert_textbox( bbox, f"World Capital Cities, Page {page.number+1} of {doc.page_count}", align=pymupdf.TEXT_ALIGN_CENTER, ) shape.finish(width=0.3, color=0.5, fill=0.9) # rectangles and gray lines shape.commit(overlay=False) # put the drawings in background doc.subset_fonts() doc.save(__file__.replace(".py", ".pdf"), deflate=True, garbage=4, pretty=True) doc.close() ================================================ FILE: docs/samples/new-annots.py ================================================ # -*- coding: utf-8 -*- """ ------------------------------------------------------------------------------- Demo script showing how annotations can be added to a PDF using PyMuPDF. It contains the following annotation types: Caret, Text, FreeText, text markers (underline, strike-out, highlight, squiggle), Circle, Square, Line, PolyLine, Polygon, FileAttachment, Stamp and Redaction. There is some effort to vary appearances by adding colors, line ends, opacity, rotation, dashed lines, etc. Dependencies ------------ PyMuPDF v1.17.0 ------------------------------------------------------------------------------- """ from __future__ import print_function import gc import sys import pymupdf print(pymupdf.__doc__) if pymupdf.VersionBind.split(".") < ["1", "17", "0"]: sys.exit("PyMuPDF v1.17.0+ is needed.") gc.set_debug(gc.DEBUG_UNCOLLECTABLE) highlight = "this text is highlighted" underline = "this text is underlined" strikeout = "this text is striked out" squiggled = "this text is zigzag-underlined" red = (1, 0, 0) blue = (0, 0, 1) gold = (1, 1, 0) green = (0, 1, 0) displ = pymupdf.Rect(0, 50, 0, 50) r = pymupdf.Rect(72, 72, 220, 100) t1 = u"têxt üsès Lätiñ charß,\nEUR: €, mu: µ, super scripts: ²³!" def print_descr(annot): """Print a short description to the right of each annot rect.""" annot.parent.insert_text( annot.rect.br + (10, -5), f"{annot.type[1]} annotation", color=red) doc = pymupdf.open() page = doc.new_page() page.set_rotation(0) annot = page.add_caret_annot(r.tl) print_descr(annot) r = r + displ annot = page.add_freetext_annot( r, t1, fontsize=10, rotate=90, text_color=blue, fill_color=gold, align=pymupdf.TEXT_ALIGN_CENTER, ) annot.set_border(width=0.3, dashes=[2]) annot.update(text_color=blue, fill_color=gold) print_descr(annot) r = annot.rect + displ annot = page.add_text_annot(r.tl, t1) print_descr(annot) # Adding text marker annotations: # first insert a unique text, then search for it, then mark it pos = annot.rect.tl + displ.tl page.insert_text( pos, # insertion point highlight, # inserted text morph=(pos, pymupdf.Matrix(-5)), # rotate around insertion point ) rl = page.search_for(highlight, quads=True) # need a quad b/o tilted text annot = page.add_highlight_annot(rl[0]) print_descr(annot) pos = annot.rect.bl # next insertion point page.insert_text(pos, underline, morph=(pos, pymupdf.Matrix(-10))) rl = page.search_for(underline, quads=True) annot = page.add_underline_annot(rl[0]) print_descr(annot) pos = annot.rect.bl page.insert_text(pos, strikeout, morph=(pos, pymupdf.Matrix(-15))) rl = page.search_for(strikeout, quads=True) annot = page.add_strikeout_annot(rl[0]) print_descr(annot) pos = annot.rect.bl page.insert_text(pos, squiggled, morph=(pos, pymupdf.Matrix(-20))) rl = page.search_for(squiggled, quads=True) annot = page.add_squiggly_annot(rl[0]) print_descr(annot) pos = annot.rect.bl r = pymupdf.Rect(pos, pos.x + 75, pos.y + 35) + (0, 20, 0, 20) annot = page.add_polyline_annot([r.bl, r.tr, r.br, r.tl]) # 'Polyline' annot.set_border(width=0.3, dashes=[2]) annot.set_colors(stroke=blue, fill=green) annot.set_line_ends(pymupdf.PDF_ANNOT_LE_CLOSED_ARROW, pymupdf.PDF_ANNOT_LE_R_CLOSED_ARROW) annot.update(fill_color=(1, 1, 0)) print_descr(annot) r += displ annot = page.add_polygon_annot([r.bl, r.tr, r.br, r.tl]) # 'Polygon' annot.set_border(width=0.3, dashes=[2]) annot.set_colors(stroke=blue, fill=gold) annot.set_line_ends(pymupdf.PDF_ANNOT_LE_DIAMOND, pymupdf.PDF_ANNOT_LE_CIRCLE) annot.update() print_descr(annot) r += displ annot = page.add_line_annot(r.tr, r.bl) # 'Line' annot.set_border(width=0.3, dashes=[2]) annot.set_colors(stroke=blue, fill=gold) annot.set_line_ends(pymupdf.PDF_ANNOT_LE_DIAMOND, pymupdf.PDF_ANNOT_LE_CIRCLE) annot.update() print_descr(annot) r += displ annot = page.add_rect_annot(r) # 'Square' annot.set_border(width=1, dashes=[1, 2]) annot.set_colors(stroke=blue, fill=gold) annot.update(opacity=0.5) print_descr(annot) r += displ annot = page.add_circle_annot(r) # 'Circle' annot.set_border(width=0.3, dashes=[2]) annot.set_colors(stroke=blue, fill=gold) annot.update() print_descr(annot) r += displ annot = page.add_file_annot( r.tl, b"just anything for testing", "testdata.txt" # 'FileAttachment' ) print_descr(annot) # annot.rect r += displ annot = page.add_stamp_annot(r, stamp=10) # 'Stamp' annot.set_colors(stroke=green) annot.update() print_descr(annot) r += displ + (0, 0, 50, 10) rc = page.insert_textbox( r, "This content will be removed upon applying the redaction.", color=blue, align=pymupdf.TEXT_ALIGN_CENTER, ) annot = page.add_redact_annot(r) print_descr(annot) doc.save(__file__.replace(".py", f"-{page.rotation:d}.pdf"), deflate=True) ================================================ FILE: docs/samples/quickfox-image-no-go.py ================================================ """ This is a demo script using PyMuPDF's Story class to output text as a PDF with a two-column page layout. The script demonstrates the following features: * Layout text around images of an existing ("target") PDF. * Based on a few global parameters, areas on each page are identified, that can be used to receive text layouted by a Story. * These global parameters are not stored anywhere in the target PDF and must therefore be provided in some way. - The width of the border(s) on each page. - The fontsize to use for text. This value determines whether the provided text will fit in the empty spaces of the (fixed) pages of target PDF. It cannot be predicted in any way. The script ends with an exception if target PDF has not enough pages, and prints a warning message if not all pages receive at least some text. In both cases, the FONTSIZE value can be changed (a float value). - Use of a 2-column page layout for the text. * The layout creates a temporary (memory) PDF. Its produced page content (the text) is used to overlay the corresponding target page. If text requires more pages than are available in target PDF, an exception is raised. If not all target pages receive at least some text, a warning is printed. * The script reads "image-no-go.pdf" in its own folder. This is the "target" PDF. It contains 2 pages with each 2 images (from the original article), which are positioned at places that create a broad overall test coverage. Otherwise the pages are empty. * The script produces "quickfox-image-no-go.pdf" which contains the original pages and image positions, but with the original article text laid out around them. Note: -------------- This script version uses just image positions to derive "No-Go areas" for layouting the text. Other PDF objects types are detectable by PyMuPDF and may be taken instead or in addition, without influencing the layouting. The following are candidates for other such "No-Go areas". Each can be detected and located by PyMuPDF: * Annotations * Drawings * Existing text -------------- The text and images are taken from the somewhat modified Wikipedia article https://en.wikipedia.org/wiki/The_quick_brown_fox_jumps_over_the_lazy_dog. -------------- """ import io import os import zipfile import pymupdf thisdir = os.path.dirname(os.path.abspath(__file__)) myzip = zipfile.ZipFile(os.path.join(thisdir, "quickfox.zip")) docname = os.path.join(thisdir, "image-no-go.pdf") # "no go" input PDF file name outname = os.path.join(thisdir, "quickfox-image-no-go.pdf") # output PDF file name BORDER = 36 # global parameter FONTSIZE = 12.5 # global parameter COLS = 2 # number of text columns, global parameter def analyze_page(page): """Compute MediaBox and rectangles on page that are free to receive text. Notes: Assume a BORDER around the page, make 2 columns of the resulting sub-rectangle and extract the rectangles of all images on page. For demo purposes, the image rectangles are taken as "NO-GO areas" on the page when writing text with the Story. The function returns free areas for each of the columns. Returns: (page.number, mediabox, CELLS), where CELLS is a list of free cells. """ prect = page.rect # page rectangle - will be our MEDIABOX later where = prect + (BORDER, BORDER, -BORDER, -BORDER) TABLE = pymupdf.make_table(where, rows=1, cols=COLS) # extract rectangles covered by images on this page IMG_RECTS = sorted( # image rects on page (sort top-left to bottom-right) [pymupdf.Rect(item["bbox"]) for item in page.get_image_info()], key=lambda b: (b.y1, b.x0), ) def free_cells(column): """Return free areas in this column.""" free_stripes = [] # y-value pairs wrapping a free area stripe # intersecting images: block complete intersecting column stripe col_imgs = [(b.y0, b.y1) for b in IMG_RECTS if abs(b & column) > 0] s_y0 = column.y0 # top y-value of column for y0, y1 in col_imgs: # an image stripe if y0 > s_y0 + FONTSIZE: # image starts below last free btm value free_stripes.append((s_y0, y0)) # store as free stripe s_y0 = y1 # start of next free stripe if s_y0 + FONTSIZE < column.y1: # enough room to column bottom free_stripes.append((s_y0, column.y1)) if free_stripes == []: # covers "no image in this column" free_stripes.append((column.y0, column.y1)) # make available cells of this column CELLS = [pymupdf.Rect(column.x0, y0, column.x1, y1) for (y0, y1) in free_stripes] return CELLS # collection of available Story rectangles on page CELLS = [] for i in range(COLS): CELLS.extend(free_cells(TABLE[0][i])) return page.number, prect, CELLS HTML = myzip.read("quickfox.html").decode() # -------------------------------------------------------------- # Make the Story object # -------------------------------------------------------------- story = pymupdf.Story(HTML) # modify the DOM somewhat body = story.body # access HTML body body.set_properties(font="sans-serif") # and give it our font globally # modify certain nodes para = body.find("p", None, None) # find relevant nodes (here: paragraphs) while para != None: para.set_properties( # method MUST be used for existing nodes indent=15, fontsize=FONTSIZE, ) para = para.find_next("p", None, None) # we remove all image references, because the target PDF already has them img = body.find("img", None, None) while img != None: next_img = img.find_next("img", None, None) img.remove() img = next_img page_info = {} # contains MEDIABOX and free CELLS per page doc = pymupdf.open(docname) for page in doc: pno, mediabox, cells = analyze_page(page) page_info[pno] = (mediabox, cells) doc.close() # close target PDF for now - re-open later fileobject = io.BytesIO() # let DocumentWriter write to memory writer = pymupdf.DocumentWriter(fileobject) # define output writer more = 1 # stop if this ever becomes zero pno = 0 # count output pages while more: # loop until all HTML text has been written try: MEDIABOX, CELLS = page_info[pno] except KeyError: # too much text space required: reduce fontsize? raise ValueError("text does not fit on target PDF") dev = writer.begin_page(MEDIABOX) # prepare a new output page for cell in CELLS: # iterate over free cells on this page if not more: # need to check this for every cell continue more, _ = story.place(cell) story.draw(dev) writer.end_page() # finish the PDF page pno += 1 writer.close() # close DocumentWriter output # Re-open writer output, read its pages and overlay target pages with them. # The generated pages have same dimension as their targets. src = pymupdf.open("pdf", fileobject) doc = pymupdf.open(doc.name) for page in doc: # overlay every target page with the prepared text if page.number >= src.page_count: print(f"Text only uses {src.page_count} target pages!") continue # story did not need all target pages? # overlay target page page.show_pdf_page(page.rect, src, page.number) # DEBUG start --- draw the text rectangles # mb, cells = page_info[page.number] # for cell in cells: # page.draw_rect(cell, color=(1, 0, 0)) # DEBUG stop --- doc.ez_save(outname) ================================================ FILE: docs/samples/quickfox.py ================================================ """ This is a demo script using PyMuPDF's Story class to output text as a PDF with a two-column page layout. The script demonstrates the following features: * How to fill columns or table cells of complex page layouts * How to embed images * How to modify existing, given HTML sources for output (text indent, font size) * How to use fonts defined in package "pymupdf-fonts" * How to use ZIP files as Archive -------------- The example is taken from the somewhat modified Wikipedia article https://en.wikipedia.org/wiki/The_quick_brown_fox_jumps_over_the_lazy_dog. -------------- """ import io import os import zipfile import pymupdf thisdir = os.path.dirname(os.path.abspath(__file__)) myzip = zipfile.ZipFile(os.path.join(thisdir, "quickfox.zip")) arch = pymupdf.Archive(myzip) if pymupdf.fitz_fontdescriptors: # we want to use the Ubuntu fonts for sans-serif and for monospace CSS = pymupdf.css_for_pymupdf_font("ubuntu", archive=arch, name="sans-serif") CSS = pymupdf.css_for_pymupdf_font("ubuntm", CSS=CSS, archive=arch, name="monospace") else: # No pymupdf-fonts available. CSS="" docname = __file__.replace(".py", ".pdf") # output PDF file name HTML = myzip.read("quickfox.html").decode() # make the Story object story = pymupdf.Story(HTML, user_css=CSS, archive=arch) # -------------------------------------------------------------- # modify the DOM somewhat # -------------------------------------------------------------- body = story.body # access HTML body body.set_properties(font="sans-serif") # and give it our font globally # modify certain nodes para = body.find("p", None, None) # find relevant nodes (here: paragraphs) while para != None: para.set_properties( # method MUST be used for existing nodes indent=15, fontsize=13, ) para = para.find_next("p", None, None) # choose PDF page size MEDIABOX = pymupdf.paper_rect("letter") # text appears only within this subrectangle WHERE = MEDIABOX + (36, 36, -36, -36) # -------------------------------------------------------------- # define page layout within the WHERE rectangle # -------------------------------------------------------------- COLS = 2 # layout: 2 cols 1 row ROWS = 1 TABLE = pymupdf.make_table(WHERE, cols=COLS, rows=ROWS) # fill the cells of each page in this sequence: CELLS = [TABLE[i][j] for i in range(ROWS) for j in range(COLS)] fileobject = io.BytesIO() # let DocumentWriter write to memory writer = pymupdf.DocumentWriter(fileobject) # define the writer more = 1 while more: # loop until all input text has been written out dev = writer.begin_page(MEDIABOX) # prepare a new output page for cell in CELLS: # content may be complete after any cell, ... if more: # so check this status first more, _ = story.place(cell) story.draw(dev) writer.end_page() # finish the PDF page writer.close() # close DocumentWriter output # for housekeeping work re-open from memory doc = pymupdf.open("pdf", fileobject) doc.ez_save(docname) ================================================ FILE: docs/samples/showpdf-page.py ================================================ """ Demo of Story class in PyMuPDF ------------------------------- This script demonstrates how to the results of a pymupdf.Story output can be placed in a rectangle of an existing (!) PDF page. """ import io import os import pymupdf def make_pdf(fileptr, text, rect, font="sans-serif", archive=None): """Make a memory DocumentWriter from HTML text and a rect. Args: fileptr: a Python file object. For example an io.BytesIO(). text: the text to output (HTML format) rect: the target rectangle. Will use its width / height as mediabox font: (str) font family name, default sans-serif archive: pymupdf.Archive parameter. To be used if e.g. images or special fonts should be used. Returns: The matrix to convert page rectangles of the created PDF back to rectangle coordinates in the parameter "rect". Normal use will expect to fit all the text in the given rect. However, if an overflow occurs, this function will output multiple pages, and the caller may decide to either accept or retry with changed parameters. """ # use input rectangle as the page dimension mediabox = pymupdf.Rect(0, 0, rect.width, rect.height) # this matrix converts mediabox back to input rect matrix = mediabox.torect(rect) story = pymupdf.Story(text, archive=archive) body = story.body body.set_properties(font=font) writer = pymupdf.DocumentWriter(fileptr) while True: device = writer.begin_page(mediabox) more, _ = story.place(mediabox) story.draw(device) writer.end_page() if not more: break writer.close() return matrix # ------------------------------------------------------------- # We want to put this in a given rectangle of an existing page # ------------------------------------------------------------- HTML = """

PyMuPDF is a great package! And it still improves significantly from one version to the next one!

It is a Python binding for MuPDF, a lightweight PDF, XPS, and E-book viewer, renderer, and toolkit.
Both are maintained and developed by Artifex Software, Inc.

Via MuPDF it can access files in PDF, XPS, OpenXPS, CBZ, EPUB, MOBI and FB2 (e-books) formats,
and it is known for its top performance and rendering quality.

""" # Make a PDF page for demo purposes root = os.path.abspath( f"{__file__}/..") doc = pymupdf.open(f"{root}/mupdf-title.pdf") page = doc[0] WHERE = pymupdf.Rect(50, 100, 250, 500) # target rectangle on existing page fileptr = io.BytesIO() # let DocumentWriter use this as its file # ------------------------------------------------------------------- # call DocumentWriter and Story to fill our rectangle matrix = make_pdf(fileptr, HTML, WHERE) # ------------------------------------------------------------------- src = pymupdf.open("pdf", fileptr) # open DocumentWriter output PDF if src.page_count > 1: # target rect was too small raise ValueError("target WHERE too small") # its page 0 contains our result page.show_pdf_page(WHERE, src, 0) doc.ez_save(f"{root}/mupdf-title-after.pdf") ================================================ FILE: docs/samples/simple-grid.py ================================================ import pymupdf MEDIABOX = pymupdf.paper_rect("letter") # output page format: Letter GRIDSPACE = pymupdf.Rect(100, 100, 400, 400) GRID = pymupdf.make_table(GRIDSPACE, rows=2, cols=2) CELLS = [GRID[i][j] for i in range(2) for j in range(2)] text_table = ("A", "B", "C", "D") writer = pymupdf.DocumentWriter(__file__.replace(".py", ".pdf")) # create the writer device = writer.begin_page(MEDIABOX) # make new page for i, text in enumerate(text_table): story = pymupdf.Story(em=1) body = story.body with body.add_paragraph() as para: para.set_bgcolor("#ecc") para.set_pagebreak_after() # fills whole cell with bgcolor para.set_align("center") para.set_fontsize(16) para.add_text(f"\n\n\n{text}") story.place(CELLS[i]) story.draw(device) del story writer.end_page() # finish page writer.close() # close output file ================================================ FILE: docs/samples/story-write-stabilized-links.py ================================================ """ Demo script for PyMuPDF's `pymupdf.Story.write_stabilized_with_links()`. `pymupdf.Story.write_stabilized_links()` is similar to `pymupdf.Story.write_stabilized()` except that it creates a PDF `pymupdf.Document` that contains PDF links generated from all internal links in the original html. """ import textwrap import pymupdf def rectfn(rect_num, filled): ''' We return one rect per page. ''' rect = pymupdf.Rect(10, 20, 290, 380) mediabox = pymupdf.Rect(0, 0, 300, 400) #print(f'rectfn(): rect_num={rect_num} filled={filled}') return mediabox, rect, None def contentfn(positions): ''' Returns html content, with a table of contents derived from `positions`. ''' ret = '' ret += textwrap.dedent('''

Contents

    ''') # Create table of contents with links to all sections in the # document. for position in positions: if position.heading and (position.open_close & 1): text = position.text if position.text else '' if position.id: ret += f"
  • {text}\n" else: ret += f"
  • {text}\n" ret += f"
      \n" ret += f"
    • page={position.page_num}\n" ret += f"
    • depth={position.depth}\n" ret += f"
    • heading={position.heading}\n" ret += f"
    • id={position.id!r}\n" ret += f"
    • href={position.href!r}\n" ret += f"
    • rect={position.rect}\n" ret += f"
    • text={text!r}\n" ret += f"
    • open_close={position.open_close}\n" ret += f"
    \n" ret += '
\n' # Main content. ret += textwrap.dedent(f'''

First section

Contents of first section.

Second section

Contents of second section.

Second section first subsection

Contents of second section first subsection.

IDTEST

Third section

Contents of third section.

NAMETEST. ''') ret = ret.strip() with open(__file__.replace('.py', '.html'), 'w') as f: f.write(ret) return ret; out_path = __file__.replace('.py', '.pdf') document = pymupdf.Story.write_stabilized_with_links(contentfn, rectfn) document.save(out_path) ================================================ FILE: docs/samples/story-write-stabilized.py ================================================ """ Demo script for PyMuPDF's `pymupdf.Story.write_stabilized()`. `pymupdf.Story.write_stabilized()` is similar to `pymupdf.Story.write()`, except instead of taking a fixed html document, it does iterative layout of dynamically-generated html content (provided by a callback) to a `pymupdf.DocumentWriter`. For example this allows one to add a dynamically-generated table of contents section while ensuring that page numbers are patched up until stable. """ import textwrap import pymupdf def rectfn(rect_num, filled): ''' We return one rect per page. ''' rect = pymupdf.Rect(10, 20, 290, 380) mediabox = pymupdf.Rect(0, 0, 300, 400) #print(f'rectfn(): rect_num={rect_num} filled={filled}') return mediabox, rect, None def contentfn(positions): ''' Returns html content, with a table of contents derived from `positions`. ''' ret = '' ret += textwrap.dedent('''

Contents

    ''') # Create table of contents with links to all sections in the # document. for position in positions: if position.heading and (position.open_close & 1): text = position.text if position.text else '' if position.id: ret += f"
  • {text}\n" else: ret += f"
  • {text}\n" ret += f"
      \n" ret += f"
    • page={position.page_num}\n" ret += f"
    • depth={position.depth}\n" ret += f"
    • heading={position.heading}\n" ret += f"
    • id={position.id!r}\n" ret += f"
    • href={position.href!r}\n" ret += f"
    • rect={position.rect}\n" ret += f"
    • text={text!r}\n" ret += f"
    • open_close={position.open_close}\n" ret += f"
    \n" ret += '
\n' # Main content. ret += textwrap.dedent(f'''

First section

Contents of first section.

Second section

Contents of second section.

Second section first subsection

Contents of second section first subsection.

Third section

Contents of third section. ''') ret = ret.strip() with open(__file__.replace('.py', '.html'), 'w') as f: f.write(ret) return ret; out_path = __file__.replace('.py', '.pdf') writer = pymupdf.DocumentWriter(out_path) pymupdf.Story.write_stabilized(writer, contentfn, rectfn) writer.close() ================================================ FILE: docs/samples/story-write.py ================================================ """ Demo script for PyMuPDF's `Story.write()` method. This is a way of laying out a story into a PDF document, that avoids the need to write a loop that calls `story.place()` and `story.draw()`. Instead just a single function call is required, albeit with a `rectfn()` callback that returns the rectangles into which the story is placed. """ import html import pymupdf # Create html containing multiple copies of our own source code. # with open(__file__) as f: text = f.read() text = html.escape(text) html = f'''

Contents of {__file__}

Normal

{text}

Strong

{text}

Em

{text}
''' def rectfn(rect_num, filled): ''' We return four rectangles per page in this order: 1 3 2 4 ''' page_w = 800 page_h = 600 margin = 50 rect_w = (page_w - 3*margin) / 2 rect_h = (page_h - 3*margin) / 2 if rect_num % 4 == 0: # New page. mediabox = pymupdf.Rect(0, 0, page_w, page_h) else: mediabox = None # Return one of four rects in turn. rect_x = margin + (rect_w+margin) * ((rect_num // 2) % 2) rect_y = margin + (rect_h+margin) * (rect_num % 2) rect = pymupdf.Rect(rect_x, rect_y, rect_x + rect_w, rect_y + rect_h) #print(f'rectfn(): rect_num={rect_num} filled={filled}. Returning: rect={rect}') return mediabox, rect, None story = pymupdf.Story(html, em=8) out_path = __file__.replace('.py', '.pdf') writer = pymupdf.DocumentWriter(out_path) story.write(writer, rectfn) writer.close() ================================================ FILE: docs/samples/table01.py ================================================ """ Demo script for basic HTML table support in Story objects Outputs a table with three columns that fits on one Letter page. The content of each row is filled via the Story's template mechanism. Column widths and row heights are automatically computed by MuPDF. Some styling via a CSS source is also demonstrated: - The table header row has a gray background - Each cell shows a border at its top - The Story's body uses the sans-serif font family - The text of one of the columns is set to blue Dependencies ------------- PyMuPDF v1.22.0 or later """ import pymupdf table_text = ( # the content of each table row ( "Length", "integer", """(Required) The number of bytes from the beginning of the line following the keyword stream to the last byte just before the keyword endstream. (There may be an additional EOL marker, preceding endstream, that is not included in the count and is not logically part of the stream data.) See “Stream Extent,” above, for further discussion.""", ), ( "Filter", "name or array", """(Optional) The name of a filter to be applied in processing the stream data found between the keywords stream and endstream, or an array of such names. Multiple filters should be specified in the order in which they are to be applied.""", ), ( "FFilter", "name or array", """(Optional; PDF 1.2) The name of a filter to be applied in processing the data found in the stream's external file, or an array of such names. The same rules apply as for Filter.""", ), ( "FDecodeParms", "dictionary or array", """(Optional; PDF 1.2) A parameter dictionary, or an array of such dictionaries, used by the filters specified by FFilter. The same rules apply as for DecodeParms.""", ), ( "DecodeParms", "dictionary or array", """(Optional) A parameter dictionary or an array of such dictionaries, used by the filters specified by Filter. If there is only one filter and that filter has parameters, DecodeParms must be set to the filter's parameter dictionary unless all the filter's parameters have their default values, in which case the DecodeParms entry may be omitted. If there are multiple filters and any of the filters has parameters set to nondefault values, DecodeParms must be an array with one entry for each filter: either the parameter dictionary for that filter, or the null object if that filter has no parameters (or if all of its parameters have their default values). If none of the filters have parameters, or if all their parameters have default values, the DecodeParms entry may be omitted. (See implementation note 7 in Appendix H.)""", ), ( "DL", "integer", """(Optional; PDF 1.5) A non-negative integer representing the number of bytes in the decoded (defiltered) stream. It can be used to determine, for example, whether enough disk space is available to write a stream to a file.\nThis value should be considered a hint only; for some stream filters, it may not be possible to determine this value precisely.""", ), ( "F", "file specification", """(Optional; PDF 1.2) The file containing the stream data. If this entry is present, the bytes between stream and endstream are ignored, the filters are specified by FFilter rather than Filter, and the filter parameters are specified by FDecodeParms rather than DecodeParms. However, the Length entry should still specify the number of those bytes. (Usually, there are no bytes and Length is 0.) (See implementation note 46 in Appendix H.)""", ), ) # Only a minimal HTML source is required to provide the Story's working HTML = """

TABLE 3.4 Entries common to all stream dictionaries

""" """ --------------------------------------------------------------------- Just for demo purposes, set: - header cell background to gray - text color in col1 to blue - a border line at the top of all table cells - all text to the sans-serif font --------------------------------------------------------------------- """ CSS = """th { background-color: #aaa; } td[id="col1"] { color: blue; } td, tr { border: 1px solid black; border-right-width: 0px; border-left-width: 0px; border-bottom-width: 0px; } body { font-family: sans-serif; } """ story = pymupdf.Story(HTML, user_css=CSS) # define the Story body = story.body # access the HTML of it template = body.find(None, "id", "row") # find the template with name "row" parent = template.parent # access its parent i.e., the
KEYTYPEVALUE
for col0, col1, col2 in table_text: row = template.clone() # make a clone of the row template # add text to each cell in the duplicated row row.find(None, "id", "col0").add_text(col0) row.find(None, "id", "col1").add_text(col1) row.find(None, "id", "col2").add_text(col2) parent.append_child(row) # add new row to
template.remove() # remove the template # Story is ready - output it via a writer writer = pymupdf.DocumentWriter(__file__.replace(".py", ".pdf"), "compress") mediabox = pymupdf.paper_rect("letter") # size of one output page where = mediabox + (36, 36, -36, -36) # use this sub-area for the content more = True # detects end of output while more: dev = writer.begin_page(mediabox) # start a page, returning a device more, filled = story.place(where) # compute content fitting into "where" story.draw(dev) # output it to the page writer.end_page() # finalize the page writer.close() # close the output ================================================ FILE: docs/samples/text-lister.py ================================================ import sys import pymupdf def flags_decomposer(flags): """Make font flags human readable.""" l = [] if flags & 2 ** 0: l.append("superscript") if flags & 2 ** 1: l.append("italic") if flags & 2 ** 2: l.append("serifed") else: l.append("sans") if flags & 2 ** 3: l.append("monospaced") else: l.append("proportional") if flags & 2 ** 4: l.append("bold") return ", ".join(l) doc = pymupdf.open(sys.argv[1]) page = doc[0] # read page text as a dictionary, suppressing extra spaces in CJK fonts blocks = page.get_text("dict", flags=11)["blocks"] for b in blocks: # iterate through the text blocks for l in b["lines"]: # iterate through the text lines for s in l["spans"]: # iterate through the text spans print("") s_font = s['font'] s_flags = flags_decomposer(s['flags']) s_size = s['size'] s_color = s['color'] print(f"Text: '{s['text']}'") # simple print of text print(f"Font: '{s_font}' ({s_flags}), size {s_size}, color #{s_color:06x}") ================================================ FILE: docs/shape.rst ================================================ .. include:: header.rst .. _Shape: Shape ================ |pdf_only_class| This class allows creating interconnected graphical elements on a PDF page. Its methods have the same meaning and name as the corresponding :ref:`Page` methods. In fact, each :ref:`Page` draw method is just a convenience wrapper for (1) one shape draw method, (2) the :meth:`Shape.finish` method, and (3) the :meth:`Shape.commit` method. For page text insertion, only the :meth:`Shape.commit` method is invoked. If many draw and text operations are executed for a page, you should always consider using a Shape object. Several draw methods can be executed in a row and each one of them will contribute to one drawing. Once the drawing is complete, the :meth:`Shape.finish` method must be invoked to apply color, dashing, width, morphing and other attributes. **Draw** methods of this class (and :meth:`Shape.insert_textbox`) are logging the area they are covering in a rectangle (:attr:`Shape.rect`). This property can for instance be used to set :attr:`Page.cropbox_position`. **Text insertions** :meth:`Shape.insert_text` and :meth:`Shape.insert_textbox` implicitly execute a "finish" and therefore only require :meth:`Shape.commit` to become effective. As a consequence, both include parameters for controlling properties like colors, etc. ================================ ===================================================== **Method / Attribute** **Description** ================================ ===================================================== :meth:`Shape.commit` update the page's contents :meth:`Shape.draw_bezier` draw a cubic Bezier curve :meth:`Shape.draw_circle` draw a circle around a point :meth:`Shape.draw_curve` draw a cubic Bezier using one helper point :meth:`Shape.draw_line` draw a line :meth:`Shape.draw_oval` draw an ellipse :meth:`Shape.draw_polyline` connect a sequence of points :meth:`Shape.draw_quad` draw a quadrilateral :meth:`Shape.draw_rect` draw a rectangle :meth:`Shape.draw_sector` draw a circular sector or piece of pie :meth:`Shape.draw_squiggle` draw a squiggly line :meth:`Shape.draw_zigzag` draw a zigzag line :meth:`Shape.finish` finish a set of draw commands :meth:`Shape.insert_text` insert text lines :meth:`Shape.insert_textbox` fit text into a rectangle :attr:`Shape.doc` stores the page's document :attr:`Shape.draw_cont` draw commands since last :meth:`Shape.finish` :attr:`Shape.height` stores the page's height :attr:`Shape.lastPoint` stores the current point :attr:`Shape.page` stores the owning page :attr:`Shape.rect` rectangle surrounding drawings :attr:`Shape.text_cont` accumulated text insertions :attr:`Shape.totalcont` accumulated string to be stored in :data:`contents` :attr:`Shape.width` stores the page's width ================================ ===================================================== **Class API** .. class:: Shape .. method:: __init__(self, page) Create a new drawing. During importing PyMuPDF, the *pymupdf.Page* object is being given the convenience method *new_shape()* to construct a *Shape* object. During instantiation, a check will be made whether we do have a PDF page. An exception is otherwise raised. :arg page: an existing page of a PDF document. :type page: :ref:`Page` .. method:: draw_line(p1, p2) Draw a line from :data:`point_like` objects *p1* to *p2*. :arg point_like p1: starting point :arg point_like p2: end point :rtype: :ref:`Point` :returns: the end point, *p2*. .. index:: pair: breadth; draw_squiggle .. method:: draw_squiggle(p1, p2, breadth=2) Draw a squiggly (wavy, undulated) line from :data:`point_like` objects *p1* to *p2*. An integer number of full wave periods will always be drawn, one period having a length of *4 * breadth*. The breadth parameter will be adjusted as necessary to meet this condition. The drawn line will always turn "left" when leaving *p1* and always join *p2* from the "right". :arg point_like p1: starting point :arg point_like p2: end point :arg float breadth: the amplitude of each wave. The condition *2 * breadth < abs(p2 - p1)* must be true to fit in at least one wave. See the following picture, which shows two points connected by one full period. :rtype: :ref:`Point` :returns: the end point, *p2*. .. image:: images/img-breadth.* Here is an example of three connected lines, forming a closed, filled triangle. Little arrows indicate the stroking direction. >>> import pymupdf >>> doc=pymupdf.open() >>> page=doc.new_page() >>> r = pymupdf.Rect(100, 100, 300, 200) >>> shape=page.new_shape() >>> shape.draw_squiggle(r.tl, r.tr) >>> shape.draw_squiggle(r.tr, r.br) >>> shape.draw_squiggle(r.br, r.tl) >>> shape.finish(color=(0, 0, 1), fill=(1, 1, 0)) >>> shape.commit() >>> doc.save("x.pdf") .. image:: images/img-squiggly.* .. note:: Waves drawn are **not** trigonometric (sine / cosine). If you need that, have a look at `draw.py `_. .. index:: pair: breadth; draw_zigzag .. method:: draw_zigzag(p1, p2, breadth=2) Draw a zigzag line from :data:`point_like` objects *p1* to *p2*. Otherwise works exactly like :meth:`Shape.draw_squiggle`. :arg point_like p1: starting point :arg point_like p2: end point :arg float breadth: the amplitude of the movement. The condition *2 * breadth < abs(p2 - p1)* must be true to fit in at least one period. :rtype: :ref:`Point` :returns: the end point, *p2*. .. method:: draw_polyline(points) Draw several connected lines between points contained in the sequence *points*. This can be used for creating arbitrary polygons by setting the last item equal to the first one. :arg sequence points: a sequence of :data:`point_like` objects. Its length must at least be 2 (in which case it is equivalent to *draw_line()*). :rtype: :ref:`Point` :returns: *points[-1]* -- the last point in the argument sequence. .. method:: draw_bezier(p1, p2, p3, p4) Draw a standard cubic Bézier curve from *p1* to *p4*, using *p2* and *p3* as control points. All arguments are :data:`point_like` objects. :rtype: :ref:`Point` :returns: the end point, *p4*. .. note:: The points do not need to be different -- experiment a bit with some of them being equal! Example: .. image:: images/img-drawBezier.* .. method:: draw_oval(tetra) Draw an "ellipse" inside the given tetragon (quadrilateral). If it is a square, a regular circle is drawn, a general rectangle will result in an ellipse. If a quadrilateral is used instead, a plethora of shapes can be the result. The drawing starts and ends at the middle point of the line `bottom-left -> top-left` corners in an anti-clockwise movement. :arg rect_like,quad_like tetra: :data:`rect_like` or :data:`quad_like`. *Changed in version 1.14.5:* Quads are now also supported. :rtype: :ref:`Point` :returns: the middle point of line `rect.bl -> rect.tl`, or resp. `quad.ll -> quad.ul`. Look at just a few examples here, or at the *quad-show?.py* scripts in the PyMuPDF-Utilities repository. .. image:: images/img-drawquad.* :scale: 50 .. method:: draw_circle(center, radius) Draw a circle given its center and radius. The drawing starts and ends at point `center - (radius, 0)` in an **anti-clockwise** movement. This point is the middle of the enclosing square's left side. This is a shortcut for `draw_sector(center, start, 360, fullSector=False)`. To draw the same circle in a **clockwise** movement, use `-360` as degrees. :arg point_like center: the center of the circle. :arg float radius: the radius of the circle. Must be positive. :rtype: :ref:`Point` :returns: `Point(center.x - radius, center.y)`. .. image:: images/img-drawcircle.* :scale: 60 .. method:: draw_curve(p1, p2, p3) A special case of *draw_bezier()*: Draw a cubic Bezier curve from *p1* to *p3*. On each of the two lines `p1 -> p2` and `p3 -> p2` one control point is generated. Both control points will therefore be on the same side of the line `p1 -> p3`. This guaranties that the curve's curvature does not change its sign. If the lines to p2 intersect with an angle of 90 degrees, then the resulting curve is a quarter ellipse (resp. quarter circle, if of same length). All arguments are :data:`point_like`. :rtype: :ref:`Point` :returns: the end point, *p3*. The following is a filled quarter ellipse segment. The yellow area is oriented **clockwise:** .. image:: images/img-drawCurve.png :align: center .. index:: pair: fullSector; draw_sector .. method:: draw_sector(center, point, angle, fullSector=True) Draw a circular sector, optionally connecting the arc to the circle's center (like a piece of pie). :arg point_like center: the center of the circle. :arg point_like point: one of the two end points of the pie's arc segment. The other one is calculated from the *angle*. :arg float angle: the angle of the sector in degrees. Used to calculate the other end point of the arc. Depending on its sign, the arc is drawn anti-clockwise (positive) or clockwise. :arg bool fullSector: whether to draw connecting lines from the ends of the arc to the circle center. If a fill color is specified, the full "pie" is colored, otherwise just the sector. :rtype: :ref:`Point` :returns: the other end point of the arc. Can be used as starting point for a following invocation to create logically connected pies charts. Examples: .. image:: images/img-drawSector1.* .. image:: images/img-drawSector2.* .. method:: draw_rect(rect, *, radius=None) * Changed in v1.22.0: Added parameter *radius*. Draw a rectangle. The drawing starts and ends at the top-left corner in an anti-clockwise movement. :arg rect_like rect: where to put the rectangle on the page. :arg multiple radius: draw rounded rectangle corners. If not `None`, specifies the radius of the curvature as a percentage of a rectangle side length. This must one or (a tuple of) two floats `0 < radius <= 0.5`, where 0.5 corresponds to 50% of the respective side. If a float, the radius of the curvature is computed as `radius * min(width, height)`, drawing the corner's perimeter as a quarter circle. If a tuple `(rx, ry)` is given, then the curvature is asymmetric with respect to the horizontal and vertical directions. A value of `radius=(0.5, 0.5)` draws an ellipse. :rtype: :ref:`Point` :returns: top-left corner of the rectangle. .. method:: draw_quad(quad) Draw a quadrilateral. The drawing starts and ends at the top-left corner (:attr:`Quad.ul`) in an anti-clockwise movement. It is a shortcut of :meth:`Shape.draw_polyline` with the argument `(ul, ll, lr, ur, ul)`. :arg quad_like quad: where to put the tetragon on the page. :rtype: :ref:`Point` :returns: :attr:`Quad.ul`. .. index:: pair: closePath; finish pair: color; finish pair: dashes; finish pair: even_odd; finish pair: fill; finish pair: lineCap; finish pair: lineJoin; finish pair: morph; finish pair: width; finish pair: stroke_opacity; finish pair: fill_opacity; finish pair: oc; finish .. method:: finish(width=1, color=(0,), fill=None, lineCap=0, lineJoin=0, dashes=None, closePath=True, even_odd=False, morph=(fixpoint, matrix), stroke_opacity=1, fill_opacity=1, oc=0) Finish a set of *draw*()* methods by applying :ref:`CommonParms` to all of them. It has **no effect on** :meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`. The method also supports **morphing the compound drawing** using :ref:`Point` *fixpoint* and :ref:`matrix` *matrix*. :arg sequence morph: morph the text or the compound drawing around some arbitrary :ref:`Point` *fixpoint* by applying :ref:`Matrix` *matrix* to it. This implies that *fixpoint* is a **fixed point** of this operation: it will not change its position. Default is no morphing (``None``). The matrix can contain any values in its first 4 components, *matrix.e == matrix.f == 0* must be true, however. This means that any combination of scaling, shearing, rotating, flipping, etc. is possible, but translations are not. :arg float stroke_opacity: *(new in v1.18.1)* set transparency for stroke colors. Value < 0 or > 1 will be ignored. Default is 1 (intransparent). :arg float fill_opacity: *(new in v1.18.1)* set transparency for fill colors. Default is 1 (intransparent). :arg bool even_odd: request the **"even-odd rule"** for filling operations. Default is ``False``, so that the **"nonzero winding number rule"** is used. These rules are alternative methods to apply the fill color where areas overlap. Only with fairly complex shapes a different behavior is to be expected with these rules. For an in-depth explanation, see :ref:`AdobeManual`, pp. 137 ff. Here is an example to demonstrate the difference. :arg int oc: *(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or :data:`OCMD` to make this drawing conditionally displayable. .. image:: images/img-even-odd.* .. note:: For each pixel in a shape, the following will happen: 1. Rule **"even-odd"** counts, how many areas contain the pixel. If this count is **odd,** the pixel is regarded **inside** the shape, if it is **even**, the pixel is **outside**. 2. The default rule **"nonzero winding"** in addition looks at the *"orientation"* of each area containing the pixel: it **adds 1** if an area is drawn anti-clockwise and it **subtracts 1** for clockwise areas. If the result is zero, the pixel is regarded **outside,** pixels with a non-zero count are **inside** the shape. Of the four shapes in above image, the top two each show three circles drawn in standard manner (anti-clockwise, look at the arrows). The lower two shapes contain one (the top-left) circle drawn clockwise. As can be seen, area orientation is irrelevant for the right column (even-odd rule). .. index:: pair: border_width; insert_text pair: color; insert_text pair: encoding; insert_text pair: fill; insert_text pair: fontfile; insert_text pair: fontname; insert_text pair: fontsize; insert_text pair: lineheight; insert_text pair: morph; insert_text pair: render_mode; insert_text pair: miter_limit; insert_text pair: rotate; insert_text pair: stroke_opacity; insert_text pair: fill_opacity; insert_text pair: oc; insert_text .. method:: insert_text(point, text, *, fontsize=11, fontname="helv", fontfile=None, set_simple=False, encoding=TEXT_ENCODING_LATIN, color=None, lineheight=None, fill=None, render_mode=0, miter_limit=1, border_width=1, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, oc=0) Insert text lines starting at ``point``. :arg point_like point: the bottom-left position of the first character of *text* in pixels. It is important to understand, how this works in conjunction with the *rotate* parameter. Please have a look at the following picture. The small red dots indicate the positions of *point* in each of the four possible cases. .. image:: images/img-inserttext.* :scale: 33 :arg str/sequence text: the text to be inserted. May be specified as either a string type or as a sequence type. For sequences, or strings containing line breaks ``\n``, several lines will be inserted. No care will be taken if lines are too wide, but the number of inserted lines will be limited by "vertical" space on the page (in the sense of reading direction as established by the *rotate* parameter). Any rest of *text* is discarded -- the return code however contains the number of inserted lines. :arg float lineheight: a factor to override the line height calculated from font properties. If not `None`, a line height of `fontsize * lineheight` will be used. :arg float stroke_opacity: *(new in v1.18.1)* set transparency for stroke colors (the **border line** of a character). Only `0 <= value <= 1` will be considered. Default is 1 (intransparent). :arg float fill_opacity: *(new in v1.18.1)* set transparency for fill colors. Default is 1 (intransparent). Use this value to control transparency of the text color. Stroke opacity **only** affects the border line of characters. :arg int rotate: determines whether to rotate the text. Acceptable values are multiples of 90 degrees. Default is 0 (no rotation), meaning horizontal text lines oriented from left to right. 180 means text is shown upside down from **right to left**. 90 means anti-clockwise rotation, text running **upwards**. 270 (or -90) means clockwise rotation, text running **downwards**. In any case, *point* specifies the bottom-left coordinates of the first character's rectangle. Multiple lines, if present, always follow the reading direction established by this parameter. So line 2 is located **above** line 1 in case of `rotate = 180`, etc. :arg int oc: *(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or :data:`OCMD` to make this text conditionally displayable. :rtype: int :returns: number of lines inserted. For a description of the other parameters see :ref:`CommonParms`. .. index:: pair: align; insert_textbox pair: border_width; insert_textbox pair: color; insert_textbox pair: encoding; insert_textbox pair: expandtabs; insert_textbox pair: fill; insert_textbox pair: fontfile; insert_textbox pair: fontname; insert_textbox pair: fontsize; insert_textbox pair: lineheight; insert_textbox pair: morph; insert_textbox pair: render_mode; insert_textbox pair: miter_limit; insert_textbox pair: rotate; insert_textbox pair: oc; insert_textbox .. method:: insert_textbox( \ rect, \ buffer, \ *, \ align=TEXT_ALIGN_LEFT, \ border_width=1, \ color=None, \ encoding=TEXT_ENCODING_LATIN, \ expandtabs=8, \ fill=None, \ fill_opacity=1, \ fontfile=None, \ fontname="helv", \ fontsize=11, \ lineheight=None, \ miter_limit=1, \ morph=None, \ oc=0, \ render_mode=0, \ rotate=0, \ set_simple=False, \ stroke_opacity=1, \ ) PDF only: Insert text into the specified rectangle. The text will be split into lines and words and then filled into the available space, starting from one of the four rectangle corners, which depends on `rotate`. Line feeds and multiple space will be respected. :arg rect_like rect: the area to use. It must be finite and not empty. :arg str/sequence buffer: the text to be inserted. Must be specified as a string or a sequence of strings. Line breaks are respected also when occurring in a sequence entry. :arg int align: align each text line. Default is 0 (left). Centered, right and justified are the other supported options, see :ref:`TextAlign`. Please note that the effect of parameter value *TEXT_ALIGN_JUSTIFY* is only achievable with "simple" (single-byte) fonts (including the :ref:`Base-14-Fonts`). :arg int expandtabs: controls handling of tab characters ``\t`` using the `string.expandtabs()` method **per each line**. :arg float fill_opacity: *(new in v1.18.1)* set transparency for fill colors. Default is 1 (intransparent). Use this value to control transparency of the text color. Stroke opacity **only** affects the border line of characters. :arg float lineheight: a factor to override the line height calculated from font properties. If not `None`, a line height of `fontsize * lineheight` will be used. :arg int oc: *(new in v1.18.4)* the :data:`xref` number of an :data:`OCG` or :data:`OCMD` to make this text conditionally displayable. :arg int rotate: requests text to be rotated in the rectangle. This value must be a multiple of 90 degrees. Default is 0 (no rotation). Effectively, the four values `0`, `90`, `180` and `270` (= `-90`) are processed, each causing the text to start in a different rectangle corner. Bottom-left is `90`, bottom-right is `180`, and `-90 / 270` is top-right. See the example how text is filled in a rectangle. This argument takes precedence over morphing. See the second example, which shows text first rotated left by `90` degrees and then the whole rectangle rotated clockwise around is lower left corner. :arg float stroke_opacity: *(new in v1.18.1)* set transparency for stroke colors. Negative values and values > 1 will be ignored. Default is 1 (intransparent). :rtype: float :returns: **If positive or zero**: successful execution. The value returned is the unused rectangle line space in pixels. This may safely be ignored -- or be used to optimize the rectangle, position subsequent items, etc. **If negative**: no execution. The value returned is the space deficit to store text lines. Enlarge rectangle, decrease *fontsize*, decrease text amount, etc. .. image:: images/img-rotate.* .. image:: images/img-rot+morph.* For a description of the other parameters see :ref:`CommonParms`. .. index:: pair: overlay; commit .. method:: commit(overlay=True) Update the page's :data:`contents` with the accumulated drawings, followed by any text insertions. If text overlaps drawings, it will be written on top of the drawings. .. warning:: **Do not forget to execute this method:** If a shape is **not committed, it will be ignored and the page will not be changed!** The method will reset attributes :attr:`Shape.rect`, :attr:`lastPoint`, :attr:`draw_cont`, :attr:`text_cont` and :attr:`totalcont`. Afterwards, the shape object can be reused for the **same page**. :arg bool overlay: determine whether to put content in foreground (default) or background. Relevant only, if the page already has a non-empty :data:`contents` object. **---------- Attributes ----------** .. attribute:: doc For reference only: the page's document. :type: :ref:`Document` .. attribute:: page For reference only: the owning page. :type: :ref:`Page` .. attribute:: height Copy of the page's height :type: float .. attribute:: width Copy of the page's width. :type: float .. attribute:: draw_cont Accumulated command buffer for **draw methods** since last finish. Every finish method will append its commands to :attr:`Shape.totalcont`. :type: str .. attribute:: text_cont Accumulated text buffer. All **text insertions** go here. This buffer will be appended to :attr:`totalcont` :meth:`Shape.commit`, so that text will never be covered by drawings in the same Shape. :type: str .. attribute:: rect Rectangle surrounding drawings. This attribute is at your disposal and may be changed at any time. Its value is set to ``None`` when a shape is created or committed. Every *draw** method, and :meth:`Shape.insert_textbox` update this property (i.e. **enlarge** the rectangle as needed). **Morphing** operations, however (:meth:`Shape.finish`, :meth:`Shape.insert_textbox`) are ignored. A typical use of this attribute would be setting :attr:`Page.cropbox_position` to this value, when you are creating shapes for later or external use. If you have not manipulated the attribute yourself, it should reflect a rectangle that contains all drawings so far. If you have used morphing and need a rectangle containing the morphed objects, use the following code:: >>> # assuming ... >>> morph = (point, matrix) >>> # ... recalculate the shape rectangle like so: >>> shape.rect = (shape.rect - pymupdf.Rect(point, point)) * ~matrix + pymupdf.Rect(point, point) :type: :ref:`Rect` .. attribute:: totalcont Total accumulated command buffer for draws and text insertions. This will be used by :meth:`Shape.commit`. :type: str .. attribute:: lastPoint For reference only: the current point of the drawing path. It is ``None`` at *Shape* creation and after each *finish()* and *commit()*. :type: :ref:`Point` Usage ------ A drawing object is constructed by *shape = page.new_shape()*. After this, as many draw, finish and text insertions methods as required may follow. Each sequence of draws must be finished before the drawing is committed. The overall coding pattern looks like this:: >>> shape = page.new_shape() >>> shape.draw1(...) >>> shape.draw2(...) >>> ... >>> shape.finish(width=..., color=..., fill=..., morph=...) >>> shape.draw3(...) >>> shape.draw4(...) >>> ... >>> shape.finish(width=..., color=..., fill=..., morph=...) >>> ... >>> shape.insert_text* >>> ... >>> shape.commit() >>> .... .. note:: 1. Each *finish()* combines the preceding draws into one logical shape, giving it common colors, line width, morphing, etc. If *closePath* is specified, it will also connect the end point of the last draw with the starting point of the first one. 2. To successfully create compound graphics, let each draw method use the end point of the previous one as its starting point. In the above pseudo code, *draw2* should hence use the returned :ref:`Point` of *draw1* as its starting point. Failing to do so, would automatically start a new path and *finish()* may not work as expected (but it won't complain either). 3. Text insertions may occur anywhere before the commit (they neither touch :attr:`Shape.draw_cont` nor :attr:`Shape.lastPoint`). They are appended to *Shape.totalcont* directly, whereas draws will be appended by *Shape.finish*. 4. Each *commit* takes all text insertions and shapes and places them in foreground or background on the page -- thus providing a way to control graphical layers. 5. **Only** *commit* **will update** the page's contents, the other methods are basically string manipulations. Examples --------- 1. Create a full circle of pieces of pie in different colors:: shape = page.new_shape() # start a new shape cols = (...) # a sequence of RGB color triples pieces = len(cols) # number of pieces to draw beta = 360. / pieces # angle of each piece of pie center = pymupdf.Point(...) # center of the pie p0 = pymupdf.Point(...) # starting point for i in range(pieces): p0 = shape.draw_sector(center, p0, beta, fullSector=True) # draw piece # now fill it but do not connect ends of the arc shape.finish(fill=cols[i], closePath=False) shape.commit() # update the page Here is an example for 5 colors: .. image:: images/img-cake.* 2. Create a regular n-edged polygon (fill yellow, red border). We use *draw_sector()* only to calculate the points on the circumference, and empty the draw command buffer again before drawing the polygon:: shape = page.new_shape() # start a new shape beta = -360.0 / n # our angle, drawn clockwise center = pymupdf.Point(...) # center of circle p0 = pymupdf.Point(...) # start here (1st edge) points = [p0] # store polygon edges for i in range(n): # calculate the edges p0 = shape.draw_sector(center, p0, beta) points.append(p0) shape.draw_cont = "" # do not draw the circle sectors shape.draw_polyline(points) # draw the polygon shape.finish(color=(1,0,0), fill=(1,1,0), closePath=False) shape.commit() Here is the polygon for n = 7: .. image:: images/img-7edges.* .. _CommonParms: Common Parameters ------------------- **fontname** (*str*) In general, there are three options: 1. Use one of the standard :ref:`Base-14-Fonts`. In this case, *fontfile* **must not** be specified and *"Helvetica"* is used if this parameter is omitted, too. 2. Choose a font already in use by the page. Then specify its **reference** name prefixed with a slash "/", see example below. 3. Specify a font file present on your system. In this case choose an arbitrary, but new name for this parameter (without "/" prefix). If inserted text should re-use one of the page's fonts, use its reference name appearing in :meth:`Page.get_fonts` like so: Suppose the font list has the item *[1024, 0, 'Type1', 'NimbusMonL-Bold', 'R366']*, then specify *fontname = "/R366", fontfile = None* to use font *NimbusMonL-Bold*. ---- **fontfile** (*str*) File path of a font existing on your computer. If you specify *fontfile*, make sure you use a *fontname* **not occurring** in the above list. This new font will be embedded in the PDF upon *doc.save()*. Similar to new images, a font file will be embedded only once. A table of MD5 codes for the binary font contents is used to ensure this. ---- **set_simple** (*bool*) Fonts installed from files are installed as **Type0** fonts by default. If you want to use 1-byte characters only, set this to true. This setting cannot be reverted. Subsequent changes are ignored. ---- **fontsize** (*float*) Font size of text, see: :data:`fontsize`. ---- **dashes** (*str*) Causes lines to be drawn dashed. The general format is `"[n m] p"` of (up to) 3 floats denoting pixel lengths. ``n`` is the dash length, ``m`` (optional) is the subsequent gap length, and ``p`` (the "phase" - **required**, even if 0!) specifies how many pixels should be skipped before the dashing starts. If ``m`` is omitted, it defaults to ``n``. A continuous line (no dashes) is drawn with `"[] 0"` or ``None`` or `""`. Examples: * Specifying `"[3 4] 0"` means dashes of 3 and gaps of 4 pixels following each other. * `"[3 3] 0"` and `"[3] 0"` do the same thing. For (the rather complex) details on how to achieve sophisticated dashing effects, see :ref:`AdobeManual`, page 217. ---- **color / fill** (*list, tuple*) Stroke and fill colors can be specified as tuples or list of of floats from 0 to 1. These sequences must have a length of 1 (GRAY), 3 (RGB) or 4 (CMYK). For GRAY colorspace, a single float instead of the unwieldy *(float,)* or *[float]* is also accepted. Accept (default) or use `None` to not use the parameter. To simplify color specification, method *getColor()* in *pymupdf.utils* may be used to get predefined RGB color triples by name. It accepts a string as the name of the color and returns the corresponding triple. The method knows over 540 color names -- see section :ref:`ColorDatabase`. Please note that the term *color* usually means "stroke" color when used in conjunction with fill color. If letting default a color parameter to `None`, then no resp. color selection command will be generated. If *fill* and *color* are both `None`, then the drawing will contain no color specification. But it will still be "stroked", which causes PDF's default color "black" be used by Adobe Acrobat and all other viewers. ---- **width** (*float*) The stroke ("border") width of the elements in a shape (if applicable). The default value is 1. The values width, color and fill have the following relationship / dependency: * If `fill=None` shape elements will always be drawn with a border - even if `color=None` (in which case black is taken) or `width=0` (in which case 1 is taken). * Shapes without border can only be achieved if a fill color is specified (which may be white of course). To achieve this, specify `width=0`. In this case, the ``color`` parameter is ignored. ---- **stroke_opacity / fill_opacity** (*floats*) Both values are floats in range [0, 1]. Negative values or values > 1 will ignored (in most cases). Both set the transparency such that a value 0.5 corresponds to 50% transparency, 0 means invisible and 1 means intransparent. For e.g. a rectangle the stroke opacity applies to its border and fill opacity to its interior. For text insertions (:meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`), use *fill_opacity* for the text. At first sight this seems surprising, but it becomes obvious when you look further down to `render_mode`: `fill_opacity` applies to the yellow and `stroke_opacity` applies to the blue color. ---- **border_width** (*float*) Set the border width for text insertions. New in v1.14.9. Relevant only if the render mode argument is used with a value greater zero. ---- **render_mode** (*int*) *New in version 1.14.9:* Integer in `range(8)` which controls the text appearance (:meth:`Shape.insert_text` and :meth:`Shape.insert_textbox`). See page 246 in :ref:`AdobeManual`. New in v1.14.9. These methods now also differentiate between fill and stroke colors. * For default 0, only the text fill color is used to paint the text. For backward compatibility, using the *color* parameter instead also works. * For render mode 1, only the border of each glyph (i.e. text character) is drawn with a thickness as set in argument *border_width*. The color chosen in the *color* argument is taken for this, the *fill* parameter is ignored. * For render mode 2, the glyphs are filled and stroked, using both color parameters and the specified border width. You can use this value to simulate **bold text** without using another font: choose the same value for *fill* and *color* and an appropriate value for *border_width*. * For render mode 3, the glyphs are neither stroked nor filled: the text becomes invisible. The following examples use border_width=0.3, together with a fontsize of 15. Stroke color is blue and fill color is some yellow. .. image:: images/img-rendermode.* ---- **miter_limit** (*float*) A float specifying the maximum acceptable value of the quotient `miter-length / line-width` ("miter quotient"). Used in text output methods. This is only relevant for non-zero render mode values -- then, characters are written with border lines (i.e. "stroked"). If two lines stroking some character meet at a sharp (<= 90°) angle and the line width is large enough, then "spikes" may become visible -- causing an ugly appearance as shown below. For more background, see page 126 of the :ref:`AdobeManual`. For instance, when joins meet at 90°, then the miter length is ``sqrt(2) * line-width``, so the miter quotient is ``sqrt(2)``. If ``miter_limit`` is exceeded, then all joins with a larger qotient will appear as beveled ("butt" appearance). The default value 1 (and any smaller value) will ensure that all joins are rendered as a butt. A value of ``None`` will use the PDF default value. Example text showing spikes (``miter_limit=None``): .. image:: images/spikes-yes.* Example text suppressing spikes (``miter_limit=1``): .. image:: images/spikes-no.* ---- **overlay** (*bool*) Causes the item to appear in foreground (default) or background. ---- **morph** (*sequence*) Causes "morphing" of either a shape, created by the *draw*()* methods, or the text inserted by page methods *insert_textbox()* / *insert_text()*. If not ``None``, it must be a pair *(fixpoint, matrix)*, where *fixpoint* is a :ref:`Point` and *matrix* is a :ref:`Matrix`. The matrix can be anything except translations, i.e. *matrix.e == matrix.f == 0* must be true. The point is used as a fixed point for the matrix operation. For example, if *matrix* is a rotation or scaling, then *fixpoint* is its center. Similarly, if *matrix* is a left-right or up-down flip, then the mirroring axis will be the vertical, respectively horizontal line going through *fixpoint*, etc. .. note:: Several methods contain checks whether the to be inserted items will actually fit into the page (like :meth:`Shape.insert_text`, or :meth:`Shape.draw_rect`). For the result of a morphing operation there is however no such guaranty: this is entirely the programmer's responsibility. ---- **lineCap (deprecated: "roundCap")** (*int*) Controls the look of line ends. The default value 0 lets each line end at exactly the given coordinate in a sharp edge. A value of 1 adds a semi-circle to the ends, whose center is the end point and whose diameter is the line width. Value 2 adds a semi-square with an edge length of line width and a center of the line end. *Changed in version 1.14.15* ---- **lineJoin** (*int*) *New in version 1.14.15:* Controls the way how line connections look like. This may be either as a sharp edge (0), a rounded join (1), or a cut-off edge (2, "butt"). ---- **closePath** (*bool*) Causes the end point of a drawing to be automatically connected with the starting point (by a straight line). .. include:: footer.rst ================================================ FILE: docs/story-class.rst ================================================ .. include:: header.rst .. _Story: ================ Story ================ .. role:: htmlTag(emphasis) * New in v1.21.0 =========================================== ============================================================= **Method / Attribute** **Short Description** =========================================== ============================================================= :meth:`Story.reset` "rewind" story output to its beginning :meth:`Story.place` compute story content to fit in provided rectangle :meth:`Story.draw` write the computed content to current page :meth:`Story.element_positions` callback function logging currently processed story content :attr:`Story.body` the story's underlying :htmlTag:`body` :meth:`Story.write` places and draws Story to a DocumentWriter :meth:`Story.write_stabilized` iterative layout of html content to a DocumentWriter :meth:`Story.write_with_links` like `write()` but also creates PDF links :meth:`Story.write_stabilized_with_links` like `write_stabilized()` but also creates PDF links :meth:`Story.fit` Finds optimal rect that contains the story `self`. :meth:`Story.fit_scale` :meth:`Story.fit_height` :meth:`Story.fit_width` =========================================== ============================================================= **Class API** .. class:: Story .. method:: __init__(self, html=None, user_css=None, em=12, archive=None) Create a **story**, optionally providing HTML and CSS source. The HTML is parsed, and held within the Story as a DOM (Document Object Model). This structure may be modified: content (text, images) may be added, copied, modified or removed by using methods of the :ref:`Xml` class. When finished, the **story** can be written to any device; in typical usage the device may be provided by a :ref:`DocumentWriter` to make new pages. Here are some general remarks: * The :ref:`Story` constructor parses and validates the provided HTML to create the DOM. * PyMuPDF provides a number of ways to manipulate the HTML source by providing access to the *nodes* of the underlying DOM. Documents can be completely built from ground up programmatically, or the existing DOM can be modified pretty arbitrarily. For details of this interface, please see the :ref:`Xml` class. * If no (or no more) changes to the DOM are required, the story is ready to be laid out and to be fed to a series of devices (typically devices provided by a :ref:`DocumentWriter` to produce new pages). * The next step is to place the story and write it out. This can either be done directly, by looping around calling `place()` and `draw()`, or alternatively, the looping can handled for you using the `write()` or `write_stabilised()` methods. Which method you choose is largely a matter of taste. * To work in the first of these styles, the following loop should be used: 1. Obtain a suitable device to write to; typically by requesting a new, empty page from a :ref:`DocumentWriter`. 2. Determine one or more rectangles on the page, that should receive **story** data. Note that not every page needs to have the same set of rectangles. 3. Pass each rectangle to the **story** to place it, learning what part of that rectangle has been filled, and whether there is more story data that did not fit. This step can be repeated several times with adjusted rectangles until the caller is happy with the results. 4. Optionally, at this point, we can request details of where interesting items have been placed, by calling the `element_positions()` method. Items are deemed to be interesting if their integer `heading` attribute is a non-zero (corresponding to HTML tags :htmlTag:`h1` - :htmlTag:`h6`), if their `id` attribute is not `None` (corresponding to HTML tag :htmlTag:`id`), or if their `href` attribute is not `None` (responding to HTML tag :htmlTag:`href`). This can conveniently be used for automatic generation of a Table of Contents, an index of images or the like. 5. Next, draw that rectangle out to the device with the `draw()` method. 6. If the most recent call to `place()` indicated that all the story data had fitted, stop now. 7. Otherwise, we can loop back. If there are more rectangles to be placed on the current device (page), we jump back to step 3 - if not, we jump back to step 1 to get a new device. * Alternatively, in the case where you are using a :ref:`DocumentWriter`, the `write()` or `write_stabilized()` methods can be used. These handle all the looping for you, in exchange for being provided with callbacks that control the behaviour (notably a callback that enumerates the rectangles/pages to use). * Which part of the **story** will land on which rectangle / which page, is fully under control of the :ref:`Story` object and cannot be predicted. * Images may be part of a **story**. They will be placed together with any surrounding text. * Multiple stories may - independently from each other - write to the same page. For example, one may have separate stories for page header, page footer, regular text, comment boxes, etc. :arg str html: HTML source code. If omitted, a basic minimum is generated (see below). If provided, not a complete HTML document is needed. The in-built source parser will forgive (many / most) HTML syntax errors and also accepts HTML fragments like `"Hello, World!"`. :arg str user_css: CSS source code. If provided, must contain valid CSS specifications. :arg float em: the default text font size. :arg archive: an :ref:`Archive` from which to load resources for rendering. Currently supported resource types are images and text fonts. If omitted, the story will not try to look up any such data and may thus produce incomplete output. .. note:: Instead of an actual archive, valid arguments for **creating** an :ref:`Archive` can also be provided -- in which case an archive will temporarily be constructed. So, instead of `story = pymupdf.Story(archive=pymupdf.Archive("myfolder"))`, one can also shorter write `story = pymupdf.Story(archive="myfolder")`. .. method:: place(where) Calculate that part of the story's content, that will fit in the provided rectangle. The method maintains a pointer which part of the story's content has already been written and upon the next invocation resumes from that pointer's position. :arg rect_like where: layout the current part of the content to fit into this rectangle. This must be a sub-rectangle of the page's :ref:`MediaBox`. :rtype: tuple[bool, rect_like] :returns: a bool (int) `more` and a rectangle `filled`. If `more == 0`, all content of the story has been written, otherwise more is waiting to be written to subsequent rectangles / pages. Rectangle `filled` is the part of `where` that has actually been filled. .. method:: draw(dev, matrix=None) Write the content part prepared by :meth:`Story.place` to the page. :arg dev: the :ref:`Device` created by `dev = writer.begin_page(mediabox)`. The device knows how to call all MuPDF functions needed to write the content. :arg matrix_like matrix: a matrix for transforming content when writing to the page. An example may be writing rotated text. The default means no transformation (i.e. the :ref:`Identity` matrix). .. method:: element_positions(function, args=None) Let the Story provide positioning information about certain HTML elements once their place on the current page has been computed - i.e. invoke this method **directly after** :meth:`Story.place`. *Story* will pass position information to *function*. This information can for example be used to generate a Table of Contents. :arg callable function: a Python function accepting an :class:`ElementPosition` object. It will be invoked by the Story object to process positioning information. The function **must** be a callable accepting exactly one argument. :arg dict args: an optional dictionary with any **additional** information that should be added to the :class:`ElementPosition` instance passed to `function`. Like for example the current output page number. Every key in this dictionary must be a string that conforms to the rules for a valid Python identifier. The complete set of information is explained below. .. method:: reset() Rewind the story's document to the beginning for starting over its output. .. attribute:: body The :htmlTag:`body` part of the story's DOM. This attribute contains the :ref:`Xml` node of :htmlTag:`body`. All relevant content for PDF production is contained between "" and "". .. method:: write(writer, rectfn, positionfn=None, pagefn=None) Places and draws Story to a `DocumentWriter`. Avoids the need for calling code to implement a loop that calls `Story.place()` and `Story.draw()` etc, at the expense of having to provide at least the `rectfn()` callback. :arg writer: a `DocumentWriter` or None. :arg rectfn: a callable taking `(rect_num: int, filled: Rect)` and returning `(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: The next rect into which content should be placed. * ctm: None or a `Matrix`. :arg positionfn: None, or a callable taking `(position: ElementPosition)`: * position: An `ElementPosition` with an extra `.page_num` member. Typically called multiple times as we generate elements that are headings or have an id. :arg pagefn: None, or a callable taking `(page_num, mediabox, dev, after)`; called at start (`after=0`) and end (`after=1`) of each page. .. staticmethod:: write_stabilized(writer, contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True) Static method that does iterative layout of html content to a `DocumentWriter`. For example this allows one to add a table of contents section while ensuring that page numbers are patched up until stable. Repeatedly creates a new `Story` from `(contentfn(), user_css, em, archive)` and lays it out with internal call to `Story.write()`; uses a None writer and extracts the list of `ElementPosition`'s which is passed to the next call of `contentfn()`. When the html from `contentfn()` becomes unchanged, we do a final iteration using `writer`. :arg writer: A `DocumentWriter`. :arg contentfn: A function taking a list of `ElementPositions` and returning a string containing html. The returned html can depend on the list of positions, for example with a table of contents near the start. :arg rectfn: A callable taking `(rect_num: int, filled: Rect)` and returning `(mediabox, rect, ctm)`: * mediabox: None or rect for new page. * rect: The next rect into which content should be placed. * ctm: A `Matrix`. :arg pagefn: None, or a callable taking `(page_num, medibox, dev, after)`; called at start (`after=0`) and end (`after=1`) of each page. :arg archive: :arg add_header_ids: If true, we add unique ids to all header tags that don't already have an id. This can help automatic generation of tables of contents. Returns: None. .. method:: write_with_links(rectfn, positionfn=None, pagefn=None) Similar to `write()` except that we don't have a `writer` arg and we return a PDF `Document` in which links have been created for each internal html link. .. staticmethod:: write_stabilized_with_links(contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True) Similar to `write_stabilized()` except that we don't have a `writer` arg and instead return a PDF `Document` in which links have been created for each internal html link. .. class:: Story.FitResult The result from a `Story.fit*()` method. Members: `big_enough`: `True` if the fit succeeded. `filled`: From the last call to `Story.place()`. `more`: `False` if the fit succeeded. `numcalls`: Number of calls made to `self.place()`. `parameter`: The successful parameter value, or the largest failing value. `rect`: The rect created from `parameter`. .. method:: fit(self, fn, pmin=None, pmax=None, delta=0.001, verbose=False) Finds optimal rect that contains the story `self`. Returns a `Story.FitResult` instance. On success, the last call to `self.place()` will have been with the returned rectangle, so `self.draw()` can be used directly. :arg fn: A callable taking a floating point `parameter` and returning a `pymupdf.Rect()`. If the rect is empty, we assume the story will not fit and do not call `self.place()`. Must guarantee that `self.place()` behaves monotonically when given rect `fn(parameter`) as `parameter` increases. This usually means that both width and height increase or stay unchanged as `parameter` increases. :arg pmin: Minimum parameter to consider; `None` for -infinity. :arg pmax: Maximum parameter to consider; `None` for +infinity. :arg delta: Maximum error in returned `parameter`. :arg verbose: If true we output diagnostics. .. method:: fit_scale(self, rect, scale_min=0, scale_max=None, delta=0.001, verbose=False) Finds smallest value `scale` in range `scale_min..scale_max` where `scale * rect` is large enough to contain the story `self`. Returns a `Story.FitResult` instance. :arg width: width of rect. :arg height: height of rect. :arg scale_min: Minimum scale to consider; must be >= 0. :arg scale_max: Maximum scale to consider, must be >= scale_min or `None` for infinite. :arg delta: Maximum error in returned scale. :arg verbose: If true we output diagnostics. .. method:: fit_height(self, width, height_min=0, height_max=None, origin=(0, 0), delta=0.001, verbose=False) Finds smallest height in range `height_min..height_max` where a rect with size `(width, height)` is large enough to contain the story `self`. Returns a `Story.FitResult` instance. :arg width: width of rect. :arg height_min: Minimum height to consider; must be >= 0. :arg height_max: Maximum height to consider, must be >= height_min or `None` for infinite. :arg origin: `(x0, y0)` of rect. :arg delta: Maximum error in returned height. :arg verbose: If true we output diagnostics. .. method:: fit_width(self, height, width_min=0, width_max=None, origin=(0, 0), delta=0.001, verbose=False) Finds smallest width in range `width_min..width_max` where a rect with size `(width, height)` is large enough to contain the story `self`. Returns a `Story.FitResult` instance. :arg height: height of rect. :arg width_min: Minimum width to consider; must be >= 0. :arg width_max: Maximum width to consider, must be >= width_min or `None` for infinite. :arg origin: `(x0, y0)` of rect. :arg delta: Maximum error in returned width. :arg verbose: If true we output diagnostics. Element Positioning CallBack function -------------------------------------- The callback function can be used to log information about story output. The function's access to the information is read-only: it has no way to influence the story's output. A typical loop for executing a story with using this method would look like this:: HTML = """

Header level 1

Header level 2

Hello MuPDF!

""" MEDIABOX = pymupdf.paper_rect("letter") # size of a page WHERE = MEDIABOX + (36, 36, -36, -36) # leave borders of 0.5 inches story = pymupdf.Story(html=HTML) # make the story writer = pymupdf.DocumentWriter("test.pdf") # make the writer pno = 0 # current page number more = 1 # will be set to 0 when done while more: # loop until all story content is processed dev = writer.begin_page(MEDIABOX) # make a device to write on the page more, filled = story.place(WHERE) # compute content positions on page story.element_positions(recorder, {"page": pno}) # provide page number in addition story.draw(dev) writer.end_page() pno += 1 # increase page number writer.close() # close output file def recorder(elpos): pass Attributes of the ElementPosition class ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Exactly one parameter must be passed to the function provided by :meth:`Story.element_positions`. It is an object with the following attributes: The parameter passed to the `recorder` function is an object with the following attributes: * `elpos.depth` (int) -- depth of this element in the box structure. * `elpos.heading` (int) -- the header level, 0 if no header, 1-6 for :htmlTag:`h1` - :htmlTag:`h6`. * `elpos.href` (str) -- value of the `href` attribute, or None if not defined. * `elpos.id` (str) -- value of the `id` attribute, or None if not defined. * `elpos.rect` (tuple) -- element position on page. * `elpos.text` (str) -- immediate text of the element. * `elpos.open_close` (int bit field) -- bit 0 set: opens element, bit 1 set: closes element. Relevant for elements that may contain other elements and thus may not immediately be closed after being created / opened. * `elpos.rect_num` (int) -- count of rectangles filled by the story so far. * `elpos.page_num` (int) -- page number; only present when using `pymupdf.Story.write*()` functions. .. include:: footer.rst ================================================ FILE: docs/supported-files-table.rst ================================================ .. raw:: html
PDF XPS EPUB MOBI FB2 CBZ SVG TXT
JPG/JPEG, PNG, BMP, GIF, TIFF, PNM, PGM, PBM, PPM, PAM, JXR, JPX/JP2, PSD
 JPG/JPEG, PNG, PNM, PGM, PBM, PPM, PAM, PSD, PS
================================================ FILE: docs/textpage.rst ================================================ .. include:: header.rst .. _TextPage: ================ TextPage ================ This class represents text and images shown on a document page. All :ref:`MuPDF document types` are supported. The usual ways to create a textpage are :meth:`DisplayList.get_textpage` and :meth:`Page.get_textpage`. Because there is a limited set of methods in this class, there exist wrappers in :ref:`Page` which are handier to use. The last column of this table shows these corresponding :ref:`Page` methods. For a description of what this class is all about, see Appendix 2. ======================== ================================ ============================== **Method** **Description** page get_text or search method ======================== ================================ ============================== :meth:`~.extractText` extract plain text "text" :meth:`~.extractTEXT` synonym of previous "text" :meth:`~.extractBLOCKS` plain text grouped in blocks "blocks" :meth:`~.extractWORDS` all words with their bbox "words" :meth:`~.extractHTML` page content in HTML format "html" :meth:`~.extractXHTML` page content in XHTML format "xhtml" :meth:`~.extractXML` page text in XML format "xml" :meth:`~.extractDICT` page content in *dict* format "dict" :meth:`~.extractJSON` page content in JSON format "json" :meth:`~.extractRAWDICT` page content in *dict* format "rawdict" :meth:`~.extractRAWJSON` page content in JSON format "rawjson" :meth:`~.search` Search for a string in the page :meth:`Page.search_for` ======================== ================================ ============================== **Class API** .. class:: TextPage .. method:: extractText(sort=False) .. method:: extractTEXT(sort=False) Return a string of the page's complete text. The text is UTF-8 unicode and in the same sequence as specified at the time of document creation. :arg bool sort: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. :rtype: str .. method:: extractBLOCKS Textpage content as a list of text lines grouped by block. Each list items looks like this:: ``(x0, y0, x1, y1, "lines in the block", block_no, block_type)`` The first four entries are the block's bbox coordinates, *block_type* is 1 for an image block, 3 for a vector block, and 0 for text. *block_no* is the block sequence number. Multiple text lines are joined via line breaks. For an **image block**, its bbox and a text line with some image meta information is included -- not the image **content**. Image blocks are included only if the extraction flag bit :data:`TEXT_PRESERVE_IMAGES` is set. An image block tuple will look like this:: ``(x0, y0, x1, y1, "\n", block_no, 1)`` For a **vector block**, the following item will be included. Vector blocks are included only if the extraction flag bit :data:`TEXT_COLLECT_VECTORS` is set. A vector block tuple will look like this:: ``(x0, y0, x1, y1, "\n", block_no, 3)`` The keyword "vector" is followed by either "stroked" or "filled". The color is given in HTML (hexadecimal RGB) format. Property ``is-rect`` is true, if the vector is not a curve and parallel to the x- or y-axis. So in essence is either a real rectangle or a line segment. Property ``continues`` indicates whether the vector is part of a path (and not the first item). .. note:: When no further details are needed (as provided by :meth:`Page.get_drawings`), then this is an **inexpensive** way to extract basic vector graphics information. Another major advantage is that all block types (text, images and vectors) are included in the output in the same order as they are present in the page's :data:`contents` stream. This is a high-speed method with just enough information to output plain text in desired reading sequence. :rtype: list .. method:: extractWORDS(delimiters=None) * Changed in v1.23.5: added `delimiters` parameter Textpage content as a list of single words with bbox information. An item of this list looks like this:: (x0, y0, x1, y1, "word", block_no, line_no, word_no) :arg str delimiters: (new in v1.23.5) use these characters as *additional* word separators. By default, all white spaces (including the non-breaking space `0xA0`) indicate start and end of a word. Now you can specify more characters causing this. For instance, the default will return `"john.doe@outlook.com"` as **one** word. If you specify `delimiters="@."` then the **four** words `"john"`, `"doe"`, `"outlook"`, `"com"` will be returned. Other possible uses include ignoring punctuation characters `delimiters=string.punctuation`. The "word" strings will not contain any delimiting character. This is a high-speed method which e.g. allows extracting text from within given areas or recovering the text reading sequence. :rtype: list .. method:: extractHTML Textpage content as a string in HTML format. This version contains complete formatting and positioning information. Images are included (encoded as base64 strings). You need an HTML package to interpret the output in Python. Your internet browser should be able to adequately display this information, but see :ref:`HTMLQuality`. :rtype: str .. method:: extractDICT(sort=False) Textpage content as a Python dictionary. Provides same information detail as HTML. See below for the structure. :arg bool sort: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. :rtype: dict .. method:: extractJSON(sort=False) Textpage content as a JSON string. Created by `json.dumps(TextPage.extractDICT())`. It is included for backlevel compatibility. You will probably use this method ever only for outputting the result to some file. The method detects binary image data and converts them to base64 encoded strings. :arg bool sort: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. :rtype: str .. method:: extractXHTML Textpage content as a string in XHTML format. Text information detail is comparable with :meth:`extractTEXT`, but also contains images (base64 encoded). This method makes no attempt to re-create the original visual appearance. :rtype: str .. method:: extractXML Textpage content as a string in XML format. This contains complete formatting information about every single character on the page: font, size, line, paragraph, location, color, etc. Contains no images. You need an XML package to interpret the output in Python. :rtype: str .. method:: extractRAWDICT(sort=False) Textpage content as a Python dictionary -- technically similar to :meth:`extractDICT`, and it contains that information as a subset (including any images). It provides additional detail down to each character, which makes using XML obsolete in many cases. See below for the structure. :arg bool sort: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. :rtype: dict .. method:: extractRAWJSON(sort=False) Textpage content as a JSON string. Created by `json.dumps(TextPage.extractRAWDICT())`. You will probably use this method ever only for outputting the result to some file. The method detects binary image data and converts them to base64 encoded strings. :arg bool sort: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. :rtype: str .. method:: search(needle, quads=False) * Changed in v1.18.2 Search for *string* and return a list of found locations. :arg str needle: the string to search for. Upper and lower cases will all match if needle consists of ASCII letters only -- it does not yet work for "Ä" versus "ä", etc. :arg bool quads: return quadrilaterals instead of rectangles. :rtype: list :returns: a list of :ref:`Rect` or :ref:`Quad` objects, each surrounding a found *needle* occurrence. As the search string may contain spaces, its parts may be found on different lines. In this case, more than one rectangle (resp. quadrilateral) are returned. **(Changed in v1.18.2)** The method **now supports dehyphenation**, so it will find e.g. "method", even if it was hyphenated in two parts "meth-" and "od" across two lines. The two returned rectangles will contain "meth" (no hyphen) and "od". .. note:: **Overview of changes in v1.18.2:** 1. The `hit_max` parameter has been removed: all hits are always returned. 2. The `rect` parameter of the :ref:`TextPage` is now respected: only text inside this area is examined. Only characters with fully contained bboxes are considered. The wrapper method :meth:`Page.search_for` correspondingly supports a *clip* parameter. 3. **Hyphenated words** are now found. 4. **Overlapping rectangles** in the same line are now automatically joined. We assume that such separations are an artifact created by multiple marked content groups, containing parts of the same search needle. Example Quad versus Rect: when searching for needle "pymupdf", then the corresponding entry will either be the blue rectangle, or, if *quads* was specified, the quad *Quad(ul, ur, ll, lr)*. .. image:: images/img-quads.* .. attribute:: rect The rectangle associated with the text page. This either equals the rectangle of the creating page or the `clip` parameter of :meth:`Page.get_textpage` and text extraction / searching methods. .. note:: The output of text searching and most text extractions **is restricted to this rectangle**. (X)HTML and XML output will however always extract the full page. .. _textpagedict: Structure of Dictionary Outputs -------------------------------- Methods :meth:`TextPage.extractDICT`, :meth:`TextPage.extractJSON`, :meth:`TextPage.extractRAWDICT`, and :meth:`TextPage.extractRAWJSON` return dictionaries, containing the page's text and image content. The dictionary structures of all four methods are almost equal. They strive to map the text page's information hierarchy of blocks, lines, spans and characters as precisely as possible, by representing each of these by its own sub-dictionary: * A **page** consists of a list of **block dictionaries**. * A (text) **block** consists of a list of **line dictionaries**. * A **line** consists of a list of **span dictionaries**. * A **span** either consists of the text itself or, for the RAW variants, a list of **character dictionaries**. * RAW variants: a **character** is a dictionary of its origin, bbox and unicode. All PyMuPDF geometry objects herein (points, rectangles, matrices) are represented by there **"like"** formats: a :data:`rect_like` *tuple* is used instead of a :ref:`Rect`, etc. The reasons for this are performance and memory considerations: * This code is written in C, where Python tuples can easily be generated. The geometry objects on the other hand are defined in Python source only. A conversion of each Python tuple into its corresponding geometry object would add significant -- and largely unnecessary -- execution time. * A 4-tuple needs about 168 bytes, the corresponding :ref:`Rect` 472 bytes - almost three times the size. A "dict" dictionary for a text-heavy page contains 300+ bbox objects -- which thus require about 50 KB storage as 4-tuples versus 140 KB as :ref:`Rect` objects. A "rawdict" output for such a page will however contain **4 to 5 thousand** bboxes, so in this case we talk about 750 KB versus 2 MB. Please also note, that only **bboxes** (= :data:`rect_like` 4-tuples) are returned, whereas a :ref:`TextPage` actually has the **full position information** -- in :ref:`Quad` format. The reason for this decision is again a memory consideration: a :data:`quad_like` needs 488 bytes (3 times the size of a :data:`rect_like`). Given the mentioned amounts of generated bboxes, returning :data:`quad_like` information would have a significant impact. In the vast majority of cases, we are dealing with **horizontal text only**, where bboxes provide entirely sufficient information. In addition, **the full quad information is not lost**: it can be recovered as needed for lines, spans, and characters by using the appropriate function from the following list: * :meth:`recover_quad` -- the quad of a complete span * :meth:`recover_span_quad` -- the quad of a character subset of a span * :meth:`recover_line_quad` -- the quad of a line * :meth:`recover_char_quad` -- the quad of a character As mentioned, using these functions is ever only needed, if the text is **not written horizontally** -- `line["dir"] != (1, 0)` -- and you need the quad for text marker annotations (:meth:`Page.add_highlight_annot` and friends). .. image:: images/img-textpage.* .. We used to do `:scale: 66` here, but current (2024-04-22) sphinx messes up the aspect ratio. Page Dictionary ~~~~~~~~~~~~~~~~~ =============== ============================================ **Key** **Value** =============== ============================================ width width of the `clip` rectangle *(float)* height height of the `clip` rectangle *(float)* blocks *list* of block dictionaries =============== ============================================ Block Dictionaries ~~~~~~~~~~~~~~~~~~ Block dictionaries come in different formats for **vector blocks**, **image blocks** and **text blocks**. Vector blocks are included only if the extraction flag bit :data:`TEXT_COLLECT_VECTORS` is set. Image blocks are included only if the extraction flag bit :data:`TEXT_PRESERVE_IMAGES` is set. **Vector block:** =============== ========================================================================================================================= **Key** **Value** =============== ========================================================================================================================= type 3 = vector (``int``) bbox vector bbox on page (:data:`rect_like`) number block count (``int``) stroked either stroked (``True``) or filled (``False``) (``bool``) isrect whether the vector is axis-parallel (``bool``). Can be a line or a rectangle. Curves or diagonal lines are ``False``. continues whether the vector is (not the last) part of a sequence of vectors in a *path* (``bool``). color sRGB integer, e.g. 0xRRGGBB (``int``). alpha Transparency, a value in ``range(256)`` (``int``). =============== ========================================================================================================================= This information is a true subset of the output of :meth:`Page.get_drawings`. Its advantage is its speed (because it is extracted alongside one :ref:`TextPage` creation) and the fact that vector blocks are included in the overall page content sequence together with text and images. **Image block:** =============== =============================================================== **Key** **Value** =============== =============================================================== type 1 = image (``int``) bbox image bbox on page (:data:`rect_like`) number block count (``int``) ext image type (``str``), as file extension, see below width original image width (``int``) height original image height (``int``) colorspace colorspace component count (``int``) xres resolution in x-direction (``int``) [#f3]_ yres resolution in y-direction (``int``) [#f3]_ bpc bits per component (``int``) transform matrix transforming image rect to bbox (:data:`matrix_like`) size size of the image in bytes (``int``) image image content (``bytes``) mask image mask content (``bytes``) for transparent images =============== =============================================================== Possible values of the "ext" key are "bmp", "gif", "jpeg", "jpx" (JPEG 2000), "jxr" (JPEG XR), "png", "pnm", and "tiff". .. note:: 1. An image block is generated for **all and every image occurrence** on the page. Hence there may be duplicates, if an image is shown at different locations. 2. :ref:`TextPage` and corresponding method :meth:`Page.get_text` are **available for all document types**. Only for PDF documents, methods :meth:`Document.get_page_images` / :meth:`Page.get_images` offer some overlapping functionality as far as image lists are concerned. But both lists **may or may not** contain the same items. Any differences are most probably caused by one of the following: - "Inline" images (see page 214 of the :ref:`AdobeManual`) of a PDF page are contained in a textpage, but **do not appear** in :meth:`Page.get_images`. - Annotations may also contain images -- these will **not appear** in :meth:`Page.get_images`. - Image blocks in a textpage are generated for **every** image location -- whether or not there are any duplicates. This is in contrast to :meth:`Page.get_images`, which will list each image only once (per reference name). - Images mentioned in the page's :data:`object` definition will **always** appear in :meth:`Page.get_images` [#f1]_. But it may happen, that there is no "display" command in the page's :data:`contents` (erroneously or on purpose). In this case the image will **not appear** in the textpage. 3. The image's "transformation matrix" is defined as the matrix, for which the expression `bbox / transform == pymupdf.Rect(0, 0, 1, 1)` is true, lookup details here: :ref:`ImageTransformation`. 4. A transparent image may be accompanied by a mask image. This is stored under key `"mask"` and has the format of a `DeviceGray` PNG image. Otherwise the value of this key is ``None``. If present, you may be able to recover (an equivalent of) the original image -- i.e. with transparency -- by creating :ref:`Pixmap` objects from the "image", respectively "mask" values and overlay them. This is not guaranteed to always work because mask images come in multiple formats, of which not all qualify for the conditions under which overlaying Pixmaps are supported. Here is a code snippet: >>> base = pymupdf.Pixmap(block["image"]) >>> mask = pymupdf.Pixmap(block["mask"]) >>> result = pymupdf.Pixmap(base, mask) **Text block:** =============== ==================================================== **Key** **Value** =============== ==================================================== type 0 = text *(int)* bbox block rectangle, :data:`rect_like` number block count *(int)* lines *list* of text line dictionaries =============== ==================================================== Line Dictionary ~~~~~~~~~~~~~~~~~ =============== ===================================================== **Key** **Value** =============== ===================================================== bbox line rectangle, :data:`rect_like` wmode writing mode *(int)*: 0 = horizontal, 1 = vertical dir writing direction, :data:`point_like` spans *list* of span dictionaries =============== ===================================================== The value of key *"dir"* is the **unit vector** `dir = (cosine, -sine)` of the angle, which the text has relative to the x-axis [#f2]_. See the following picture: The word in each quadrant (counter-clockwise from top-right to bottom-right) is rotated by 30, 120, 210 and 300 degrees respectively. .. image:: images/img-line-dir.* :scale: 100 Span Dictionary ~~~~~~~~~~~~~~~~~ Spans contain the actual text. A line contains **more than one span only**, if it contains text with different font properties. * Changed in version 1.14.17 Spans now also have a *bbox* key (again). * Changed in version 1.17.6 Spans now also have an *origin* key. =============== ===================================================================== **Key** **Value** =============== ===================================================================== bbox span rectangle, :data:`rect_like` origin the first character's origin, :data:`point_like` font font name *(str)* ascender ascender of the font *(float)* descender descender of the font *(float)* size font size *(float)* flags font characteristics *(int)* char_flags char characteristics *(int)* color text color in sRGB format 0xRRGGBB *(int)*. alpha text opacity 0..255 *(int)*. text (only for :meth:`extractDICT`) text *(str)* chars (only for :meth:`extractRAWDICT`) *list* of character dictionaries =============== ===================================================================== |history_begin| *(New in version 1.25.3.0):* Added *"alpha"* item. *(New in version 1.16.0):* *"color"* is the text color encoded in sRGB (int) format, e.g. 0xFF0000 for red. There are functions for converting this integer back to formats (r, g, b) (PDF with float values from 0 to 1) :meth:`sRGB_to_pdf`, or (R, G, B), :meth:`sRGB_to_rgb` (with integer values from 0 to 255). *(New in v1.18.5):* *"ascender"* and *"descender"* are font properties, provided relative to :data:`fontsize` 1. Note that descender is a negative value. The following picture shows the relationship to other values and properties. |history_end| .. image:: images/img-asc-desc.* :scale: 60 These numbers may be used to compute the minimum height of a character (or span) -- as opposed to the standard height provided in the "bbox" values (which actually represents the **line height**). The following code recalculates the span bbox to have a height of **fontsize** exactly fitting the text inside: >>> a = span["ascender"] >>> d = span["descender"] >>> r = pymupdf.Rect(span["bbox"]) >>> o = pymupdf.Point(span["origin"]) # its y-value is the baseline >>> r.y1 = o.y - span["size"] * d / (a - d) >>> r.y0 = r.y1 - span["size"] >>> # r now is a rectangle of height 'fontsize' .. caution:: The above calculation may deliver a **larger** height! This may e.g. happen for OCRed documents, where the risk of all sorts of text artifacts is high. MuPDF tries to come up with a reasonable bbox height, independently from the :data:`fontsize` found in the PDF. So please ensure that the height of `span["bbox"]` is **larger** than `span["size"]`. .. note:: You may request PyMuPDF to do all of the above automatically by executing `pymupdf.TOOLS.set_small_glyph_heights(True)`. This sets a global parameter so that all subsequent text searches and text extractions are based on reduced glyph heights, where meaningful. The following shows the original span rectangle in red and the rectangle with re-computed height in blue. .. image:: images/img-span-rect.* :scale: 200 *"flags"* is an integer, which represents font properties except for the first bit 0. They are to be interpreted like this: * bit 0: superscripted (:data:`TEXT_FONT_SUPERSCRIPT`) -- not a font property, detected by MuPDF code. * bit 1: italic (:data:`TEXT_FONT_ITALIC`) * bit 2: serifed (:data:`TEXT_FONT_SERIFED`) * bit 3: monospaced (:data:`TEXT_FONT_MONOSPACED`) * bit 4: bold (:data:`TEXT_FONT_BOLD`) Test these characteristics like so: >>> if flags & pymupdf.TEXT_FONT_BOLD & pymupdf.TEXT_FONT_ITALIC: print(f"{span['text']=} is bold and italic") Bits 1 thru 4 are font properties, i.e. encoded in the font program. Please note, that this information is not necessarily correct or complete: fonts quite often contain wrong data here. *"char_flags"* is an integer, which represents extra character properties: * bit 0: strikeout. * bit 1: underline. * bit 2: synthetic (always 0, see char dictionary). * bit 3: filled. * bit 4: stroked. * bit 5: clipped. For example if not filled and not stroked (`if not (char_flags & 2**3 & 2**4): ...`) then the text will be invisible. (`char_flags` is new in v1.25.2.) Character Dictionary for :meth:`extractRAWDICT` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =============== =========================================================== **Key** **Value** =============== =========================================================== origin character's left baseline point, :data:`point_like` bbox character rectangle, :data:`rect_like` synthetic bool. c the character (unicode) =============== =========================================================== (`synthetic` is new in v1.25.3.) This image shows the relationship between a character's bbox and its quad: |textpagechar| .. |textpagechar| image:: images/img-textpage-char.* :align: top :scale: 66 .. rubric:: Footnotes .. [#f1] Image specifications for a PDF page are done in a page's (sub-) :data:`dictionary`, called `/Resources`. Resource dictionaries can be **inherited** from any of the page's parent objects (usually the :data:`catalog` -- the top-level parent). The PDF creator may e.g. define one `/Resources` on file level, naming all images and / or all fonts ever used by any page. In these cases, :meth:`Page.get_images` and :meth:`Page.get_fonts` will consequently return the same lists for all pages. If desired, this situation can be reverted using :meth:`Page.clean_contents`. After execution, the page's object definition will show fonts and images that are actually used. .. [#f2] The coordinate systems of MuPDF and PDF are different in that MuPDF uses the page's top-left point as `(0, 0)`. In PDF, this is the bottom-left point. Therefore, the positive direction for MuPDF's y-axis is **from top to bottom**. This causes the sign change for the sine value here: a **negative** value indicates anti-clockwise rotation of the text. .. [#f3] This value is always 96, the default of the PDF interpreter. It **does not reflect** the resolution of the image itself. If you need the image's resolution, use the :meth:`Pixmap.xres` and :meth:`Pixmap.yres` attributes of the :ref:`Pixmap` created from the returned image binary. .. include:: footer.rst ================================================ FILE: docs/textwriter.rst ================================================ .. include:: header.rst .. _TextWriter: ================ TextWriter ================ |pdf_only_class| * New in v1.16.18 This class represents a MuPDF *text* object. The basic idea is to **decouple (1) text preparation, and (2) text output** to PDF pages. During **preparation**, a text writer stores any number of text pieces ("spans") together with their positions and individual font information. The **output** of the writer's prepared content may happen multiple times to any PDF page with a compatible page size. A text writer is an elegant alternative to methods :meth:`Page.insert_text` and friends: * **Improved text positioning:** Choose any point where insertion of text should start. Storing text returns the "cursor position" after the *last character* of the span. * **Free font choice:** Each text span has its own font and :data:`fontsize`. This lets you easily switch when composing a larger text. * **Automatic fallback fonts:** If a character is not supported by the chosen font, alternative fonts are automatically searched. This significantly reduces the risk of seeing unprintable symbols in the output ("TOFUs" -- looking like a small rectangle). PyMuPDF now also comes with the **universal font "Droid Sans Fallback Regular"**, which supports **all Latin** characters (including Cyrillic and Greek), and **all CJK** characters (Chinese, Japanese, Korean). * **Cyrillic and Greek Support:** The :ref:`Base-14-fonts` have integrated support of Cyrillic and Greek characters **without specifying encoding.** Your text may be a mixture of Latin, Greek and Cyrillic. * **Transparency support:** Parameter *opacity* is supported. This offers a handy way to create watermark-style text. * **Justified text:** Supported for any font -- not just simple fonts as in :meth:`Page.insert_textbox`. * **Reusability:** A TextWriter object exists independent from PDF pages. It can be written multiple times, either to the same or to other pages, in the same or in different PDFs, choosing different colors or transparency. Using this object entails three steps: 1. When **created**, a TextWriter requires a fixed **page rectangle** in relation to which it calculates text positions. A text writer can write to pages of this size only. 2. Store text in the TextWriter using methods :meth:`TextWriter.append`, :meth:`TextWriter.appendv` and :meth:`TextWriter.fill_textbox` as often as is desired. 3. Output the TextWriter object on some PDF page(s). .. note:: * Starting with version 1.17.0, TextWriters **do support** text rotation via the *morph* parameter of :meth:`TextWriter.write_text`. * There also exists :meth:`Page.write_text` which combines one or more TextWriters and jointly writes them to a given rectangle and with a given rotation angle -- much like :meth:`Page.show_pdf_page`. ================================ ============================================ **Method / Attribute** **Short Description** ================================ ============================================ :meth:`~TextWriter.append` Add text in horizontal write mode :meth:`~TextWriter.appendv` Add text in vertical write mode :meth:`~TextWriter.fill_textbox` Fill rectangle (horizontal write mode) :meth:`~TextWriter.write_text` Output TextWriter to a PDF page :attr:`~TextWriter.color` Text color (can be changed) :attr:`~TextWriter.last_point` Last written character ends here :attr:`~TextWriter.opacity` Text opacity (can be changed) :attr:`~TextWriter.rect` Page rectangle used by this TextWriter :attr:`~TextWriter.text_rect` Area occupied so far ================================ ============================================ **Class API** .. class:: TextWriter .. method:: __init__(self, rect, opacity=1, color=None) :arg rect-like rect: rectangle internally used for text positioning computations. :arg float opacity: sets the transparency for the text to store here. Values outside the interval `[0, 1)` will be ignored. A value of e.g. 0.5 means 50% transparency. :arg float,sequ color: the color of the text. All colors are specified as floats *0 <= color <= 1*. A single float represents some gray level, a sequence implies the colorspace via its length. .. method:: append(pos, text, font=None, fontsize=11, language=None, right_to_left=False, small_caps=0) * *Changed in v1.18.9* * *Changed in v1.18.15* Add some new text in horizontal writing. :arg point_like pos: start position of the text, the bottom left point of the first character. :arg str text: a string of arbitrary length. It will be written starting at position "pos". :arg font: a :ref:`Font`. If omitted, `pymupdf.Font("helv")` will be used. :arg float fontsize: the :data:`fontsize`, a positive number, default 11. :arg str language: the language to use, e.g. "en" for English. Meaningful values should be compliant with the ISO 639 standards 1, 2, 3 or 5. Reserved for future use: currently has no effect as far as we know. :arg bool right_to_left: *(New in v1.18.9)* whether the text should be written from right to left. Applicable for languages like Arabian or Hebrew. Default is ``False``. If ``True``, any Latin parts within the text will automatically converted. There are no other consequences, i.e. :attr:`TextWriter.last_point` will still be the rightmost character, and there neither is any alignment taking place. Hence you may want to use :meth:`TextWriter.fill_textbox` instead. :arg bool small_caps: *(New in v1.18.15)* look for the character's Small Capital version in the font. If present, take that value instead. Otherwise the original character (this font or the fallback font) will be taken. The fallback font will never return small caps. For example, this snippet:: >>> doc = pymupdf.open() >>> page = doc.new_page() >>> text = "PyMuPDF: the Python bindings for MuPDF" >>> font = pymupdf.Font("figo") # choose a font with small caps >>> tw = pymupdf.TextWriter(page.rect) >>> tw.append((50,100), text, font=font, small_caps=True) >>> tw.write_text(page) >>> doc.ez_save("x.pdf") will produce this PDF text: .. image:: images/img-smallcaps.* :returns: :attr:`text_rect` and :attr:`last_point`. *(Changed in v1.18.0:)* Raises an exception for an unsupported font -- checked via :attr:`Font.is_writable`. .. method:: appendv(pos, text, font=None, fontsize=11, language=None, small_caps=0) *Changed in v1.18.15* Add some new text in vertical, top-to-bottom writing. :arg point_like pos: start position of the text, the bottom left point of the first character. :arg str text: a string. It will be written starting at position "pos". :arg font: a :ref:`Font`. If omitted, `pymupdf.Font("helv")` will be used. :arg float fontsize: the :data:`fontsize`, a positive float, default 11. :arg str language: the language to use, e.g. "en" for English. Meaningful values should be compliant with the ISO 639 standards 1, 2, 3 or 5. Reserved for future use: currently has no effect as far as we know. :arg bool small_caps: *(New in v1.18.15)* see :meth:`append`. :returns: :attr:`text_rect` and :attr:`last_point`. *(Changed in v1.18.0:)* Raises an exception for an unsupported font -- checked via :attr:`Font.is_writable`. .. method:: fill_textbox(rect, text, *, pos=None, font=None, fontsize=11, align=0, right_to_left=False, warn=None, small_caps=0) * Changed in 1.17.3: New parameter `pos` to specify where to start writing within rectangle. * Changed in v1.18.9: Return list of lines which do not fit in rectangle. Support writing right-to-left (e.g. Arabian, Hebrew). * Changed in v1.18.15: Prefer small caps if supported by the font. Fill a given rectangle with text in horizontal writing mode. This is a convenience method to use as an alternative for :meth:`append`. :arg rect_like rect: the area to fill. No part of the text will appear outside of this. :arg str,sequ text: the text. Can be specified as a (UTF-8) string or a list / tuple of strings. A string will first be converted to a list using *splitlines()*. Every list item will begin on a new line (forced line breaks). :arg point_like pos: *(new in v1.17.3)* start storing at this point. Default is a point near rectangle top-left. :arg font: the :ref:`Font`, default `pymupdf.Font("helv")`. :arg float fontsize: the :data:`fontsize`. :arg int align: text alignment. Use one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT or TEXT_ALIGN_JUSTIFY. :arg bool right_to_left: *(New in v1.18.9)* whether the text should be written from right to left. Applicable for languages like Arabian or Hebrew. Default is ``False``. If ``True``, any Latin parts are automatically reverted. You must still set the alignment (if you want right alignment), it does not happen automatically -- the other alignment options remain available as well. :arg bool warn: on text overflow do nothing (``None``), warn (``True``), or raise an exception (``False``). Overflow text will never be written. **Changed in v1.18.9:** * Default is ``None``. * The list of overflow lines will be returned. * When ``None`` or ``True`` the partial text will be written. * When ``False``, and an exception is raised, the text *will not* be written. :arg bool small_caps: *(New in v1.18.15)* see :meth:`append`. :rtype: list :returns: *New in v1.18.9* -- List of lines that did not fit in the rectangle. Each item is a tuple `(text, length)` containing a string and its length (on the page). .. note:: Use these methods as often as is required -- there is no technical limit (except memory constraints of your system). You can also mix :meth:`append` and text boxes and have multiple of both. Text positioning is exclusively controlled by the insertion point. Therefore there is no need to adhere to any order. *(Changed in v1.18.0:)* Raise an exception for an unsupported font -- checked via :attr:`Font.is_writable`. .. method:: write_text(page, opacity=None, color=None, morph=None, overlay=True, oc=0, render_mode=0) Write the TextWriter text to a page, which is the only mandatory parameter. The other parameters can be used to temporarily override the values used when the TextWriter was created. :arg page: write to this :ref:`Page`. :arg float opacity: override the value of the TextWriter for this output. :arg sequ color: override the value of the TextWriter for this output. :arg sequ morph: modify the text appearance by applying a matrix to it. If provided, this must be a sequence *(fixpoint, matrix)* with a point-like *fixpoint* and a matrix-like *matrix*. A typical example is rotating the text around *fixpoint*. :arg bool overlay: put in foreground (default) or background. :arg int oc: *(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`. :arg int render_mode: The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible). .. image:: images/img-rendermode.* .. attribute:: text_rect The area currently occupied. :rtype: :ref:`Rect` .. attribute:: last_point The "cursor position" -- a :ref:`Point` -- after the last written character (its bottom-right). :rtype: :ref:`Point` .. attribute:: opacity The text opacity (modifiable). :rtype: float .. attribute:: color The text color (modifiable). :rtype: float,tuple .. attribute:: rect The page rectangle for which this TextWriter was created. Must not be modified. :rtype: :ref:`Rect` .. note:: To see some demo scripts dealing with TextWriter, have a look at `the TextWriter demo scripts `_. 1. Opacity and color apply to **all the text** in this object. 2. If you need different colors / transparency, you must create a separate TextWriter. Whenever you determine the color should change, simply append the text to the respective TextWriter using the previously returned :attr:`last_point` as position for the new text span. 3. Appending items or text boxes can occur in arbitrary order: only the position parameter controls where text appears. 4. Font and :data:`fontsize` can freely vary within the same TextWriter. This can be used to let text with different properties appear on the same displayed line: just specify *pos* accordingly, and e.g. set it to :attr:`last_point` of the previously added item. 5. You can use the *pos* argument of :meth:`TextWriter.fill_textbox` to set the position of the first text character. This allows filling the same textbox with contents from different :ref:`TextWriter` objects, thus allowing for multiple colors, opacities, etc. 6. MuPDF does not support all fonts with this feature, e.g. no Type3 fonts. Starting with v1.18.0 this can be checked via the font attribute :attr:`Font.is_writable`. This attribute is also checked when using :ref:`TextWriter` methods. .. include:: footer.rst ================================================ FILE: docs/the-basics.rst ================================================ .. include:: header.rst .. _TheBasics: ============================== The Basics ============================== .. _The_Basics_Opening_Files: Opening a File ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To open a file, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("a.pdf") # open a document .. note:: **Taking it further** See the :ref:`list of supported file types` and :ref:`The How to Guide on Opening Files ` for more advanced options. ---------- .. _The_Basics_Extracting_Text: Extract text from a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To extract all the text from a |PDF| file, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("a.pdf") # open a document out = open("output.txt", "wb") # create a text output for page in doc: # iterate the document pages text = page.get_text().encode("utf8") # get plain text (is in UTF-8) out.write(text) # write text of page out.write(bytes((12,))) # write page delimiter (form feed 0x0C) out.close() Of course it is not just |PDF| which can have text extracted - all the :ref:`supported document file formats ` such as :title:`MOBI`, :title:`EPUB`, :title:`TXT` can have their text extracted. .. note:: **Taking it further** If your document contains image based text content the use OCR on the page for subsequent text extraction: .. code-block:: python tp = page.get_textpage_ocr() text = page.get_text(textpage=tp) There are many more examples which explain how to extract text from specific areas or how to extract tables from documents. Please refer to the :ref:`How to Guide for Text`. You can now also :ref:`extract text in Markdown format`. **API reference** - :meth:`Page.get_text` ---------- .. _The_Basics_Extracting_Images: Extract images from a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To extract all the images from a |PDF| file, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document for page_index in range(len(doc)): # iterate over pdf pages page = doc[page_index] # get the page image_list = page.get_images() # print the number of images found on the page if image_list: print(f"Found {len(image_list)} images on page {page_index}") else: print("No images found on page", page_index) for image_index, img in enumerate(image_list, start=1): # enumerate the image list xref = img[0] # get the XREF of the image pix = pymupdf.Pixmap(doc, xref) # create a Pixmap if pix.n - pix.alpha > 3: # CMYK: convert to RGB first pix = pymupdf.Pixmap(pymupdf.csRGB, pix) pix.save(f"page_{page_index}-image_{image_index}.png") # save the image as png pix = None .. note:: **Taking it further** There are many more examples which explain how to extract text from specific areas or how to extract tables from documents. Please refer to the :ref:`How to Guide for Text`. **API reference** - :meth:`Page.get_images` - :ref:`Pixmap` .. _The_Basics_Extracting_Vector_Graphics: Extract vector graphics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To extract all the vector graphics from a document page, do the following: .. code-block:: python doc = pymupdf.open("some.file") page = doc[0] paths = page.get_drawings() This will return a dictionary of paths for any vector drawings found on the page. .. note:: **Taking it further** Please refer to: :ref:`How to Extract Drawings`. **API reference** - :meth:`Page.get_drawings` ---------- .. _The_Basics_Merging_PDF: .. _merge PDF: .. _join PDF: Merging |PDF| files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To merge |PDF| files, do the following: .. code-block:: python import pymupdf doc_a = pymupdf.open("a.pdf") # open the 1st document doc_b = pymupdf.open("b.pdf") # open the 2nd document doc_a.insert_pdf(doc_b) # merge the docs doc_a.save("a+b.pdf") # save the merged document with a new filename Merging |PDF| files with other types of file """"""""""""""""""""""""""""""""""""""""""""""""""""" With :meth:`Document.insert_file` you can invoke the method to merge :ref:`supported files` with |PDF|. For example: .. code-block:: python import pymupdf doc_a = pymupdf.open("a.pdf") # open the 1st document doc_b = pymupdf.open("b.svg") # open the 2nd document doc_a.insert_file(doc_b) # merge the docs doc_a.save("a+b.pdf") # save the merged document with a new filename .. note:: **Taking it further** It is easy to join PDFs with :meth:`Document.insert_pdf` & :meth:`Document.insert_file`. Given open |PDF| documents, you can copy page ranges from one to the other. You can select the point where the copied pages should be placed, you can revert the page sequence and also change page rotation. The GUI script `join.py `_ uses this method to join a list of files while also joining the respective table of contents segments. It looks like this: .. image:: images/img-pdfjoiner.* :scale: 60 **API reference** - :meth:`Document.insert_pdf` - :meth:`Document.insert_file` ---------- Working with Coordinates ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There is one *mathematical term* that you should feel comfortable with when using |PyMuPDF| - **"coordinates"**. Please have a quick look at the :ref:`Coordinates` section to understand the coordinate system to help you with positioning objects and understand your document space. ---------- .. _The_Basics_Watermarks: Adding a watermark to a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To add a watermark to a |PDF| file, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("document.pdf") # open a document for page_index in range(len(doc)): # iterate over pdf pages page = doc[page_index] # get the page # insert an image watermark from a file name to fit the page bounds page.insert_image(page.bound(),filename="watermark.png", overlay=False) doc.save("watermarked-document.pdf") # save the document with a new filename .. note:: **Taking it further** Adding watermarks is essentially as simple as adding an image at the base of each |PDF| page. You should ensure that the image has the required opacity and aspect ratio to make it look the way you need it to. In the example above a new image is created from each file reference, but to be more performant (by saving memory and file size) this image data should be referenced only once - see the code example and explanation on :meth:`Page.insert_image` for the implementation. **API reference** - :meth:`Page.bound` - :meth:`Page.insert_image` ---------- .. _The_Basics_Images: Adding an image to a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To add an image to a |PDF| file, for example a logo, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("document.pdf") # open a document for page_index in range(len(doc)): # iterate over pdf pages page = doc[page_index] # get the page # insert an image logo from a file name at the top left of the document page.insert_image(pymupdf.Rect(0,0,50,50),filename="my-logo.png") doc.save("logo-document.pdf") # save the document with a new filename .. note:: **Taking it further** As with the watermark example you should ensure to be more performant by only referencing the image once if possible - see the code example and explanation on :meth:`Page.insert_image`. **API reference** - :ref:`Rect` - :meth:`Page.insert_image` ---------- .. _The_Basics_Rotating: Rotating a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To add a rotation to a page, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open document page = doc[0] # get the 1st page of the document page.set_rotation(90) # rotate the page doc.save("rotated-page-1.pdf") .. note:: **API reference** - :meth:`Page.set_rotation` ---------- .. _The_Basics_Cropping: Cropping a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To crop a page to a defined :ref:`Rect`, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open document page = doc[0] # get the 1st page of the document page.set_cropbox(pymupdf.Rect(100, 100, 400, 400)) # set a cropbox for the page doc.save("cropped-page-1.pdf") .. note:: **API reference** - :meth:`Page.set_cropbox` ---------- .. _The_Basics_Attaching_Files: :index:`Attaching Files ` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To attach another file to a page, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open main document attachment = pymupdf.open("my-attachment.pdf") # open document you want to attach page = doc[0] # get the 1st page of the document point = pymupdf.Point(100, 100) # create the point where you want to add the attachment attachment_data = attachment.tobytes() # get the document byte data as a buffer # add the file annotation with the point, data and the file name file_annotation = page.add_file_annot(point, attachment_data, "attachment.pdf") doc.save("document-with-attachment.pdf") # save the document .. note:: **Taking it further** When adding the file with :meth:`Page.add_file_annot` note that the third parameter for the `filename` should include the actual file extension. Without this the attachment possibly will not be able to be recognized as being something which can be opened. For example, if the `filename` is just *"attachment"* when view the resulting PDF and attempting to open the attachment you may well get an error. However, with *"attachment.pdf"* this can be recognized and opened by PDF viewers as a valid file type. The default icon for the attachment is by default a "push pin", however you can change this by setting the `icon` parameter. **API reference** - :ref:`Point` - :meth:`Document.tobytes` - :meth:`Page.add_file_annot` ---------- .. _The_Basics_Embedding_Files: :index:`Embedding Files ` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To embed a file to a document, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open main document embedded_doc = pymupdf.open("my-embed.pdf") # open document you want to embed embedded_data = embedded_doc.tobytes() # get the document byte data as a buffer # embed with the file name and the data doc.embfile_add("my-embedded_file.pdf", embedded_data) doc.save("document-with-embed.pdf") # save the document .. note:: **Taking it further** As with :ref:`attaching files`, when adding the file with :meth:`Document.embfile_add` note that the first parameter for the `filename` should include the actual file extension. **API reference** - :meth:`Document.tobytes` - :meth:`Document.embfile_add` ---------- .. _The_Basics_Deleting_Pages: Deleting Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To delete a page from a document, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document doc.delete_page(0) # delete the 1st page of the document doc.save("test-deleted-page-one.pdf") # save the document To delete a multiple pages from a document, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document doc.delete_pages(from_page=9, to_page=14) # delete a page range from the document doc.save("test-deleted-pages.pdf") # save the document What happens if I delete a page referred to by bookmarks or hyperlinks? """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - A bookmark (entry in the Table of Contents) will become inactive and will no longer navigate to any page. - A hyperlink will be removed from the page that contains it. The visible content on that page will not otherwise be changed in any way. .. note:: **Taking it further** The page index is zero-based, so to delete page 10 of a document you would do the following `doc.delete_page(9)`. Similarly, `doc.delete_pages(from_page=9, to_page=14)` will delete pages 10 - 15 inclusive. **API reference** - :meth:`Document.delete_page` - :meth:`Document.delete_pages` ---------- .. _The_Basics_Rearrange_Pages: Re-Arranging Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To change the sequence of pages, i.e. re-arrange pages, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document doc.move_page(1,0) # move the 2nd page of the document to the start of the document doc.save("test-page-moved.pdf") # save the document .. note:: **API reference** - :meth:`Document.move_page` ---------- .. _The_Basics_Copying_Pages: Copying Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To copy pages, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document doc.copy_page(0) # copy the 1st page and puts it at the end of the document doc.save("test-page-copied.pdf") # save the document .. note:: **API reference** - :meth:`Document.copy_page` ---------- .. _The_Basics_Selecting_Pages: Selecting Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To select pages, do the following: .. code-block:: python import pymupdf doc = pymupdf.open("test.pdf") # open a document doc.select([0, 1]) # select the 1st & 2nd page of the document doc.save("just-page-one-and-two.pdf") # save the document .. note:: **Taking it further** With |PyMuPDF| you have all options to copy, move, delete or re-arrange the pages of a |PDF|. Intuitive methods exist that allow you to do this on a page-by-page level, like the :meth:`Document.copy_page` method. Or you alternatively prepare a complete new page layout in form of a :title:`Python` sequence, that contains the page numbers you want, in the sequence you want, and as many times as you want each page. The following may illustrate what can be done with :meth:`Document.select` .. code-block:: python doc.select([1, 1, 1, 5, 4, 9, 9, 9, 0, 2, 2, 2]) Now let's prepare a PDF for double-sided printing (on a printer not directly supporting this): The number of pages is given by `len(doc)` (equal to `doc.page_count`). The following lists represent the even and the odd page numbers, respectively: .. code-block:: python p_even = [p in range(doc.page_count) if p % 2 == 0] p_odd = [p in range(doc.page_count) if p % 2 == 1] This snippet creates the respective sub documents which can then be used to print the document: .. code-block:: python doc.select(p_even) # only the even pages left over doc.save("even.pdf") # save the "even" PDF doc.close() # recycle the file doc = pymupdf.open(doc.name) # re-open doc.select(p_odd) # and do the same with the odd pages doc.save("odd.pdf") For more information also have a look at this Wiki `article `_. The following example will reverse the order of all pages (**extremely fast:** sub-second time for the 756 pages of the :ref:`AdobeManual`): .. code-block:: python lastPage = doc.page_count - 1 for i in range(lastPage): doc.move_page(lastPage, i) # move current last page to the front This snippet duplicates the PDF with itself so that it will contain the pages *0, 1, ..., n, 0, 1, ..., n* **(extremely fast and without noticeably increasing the file size!)**: .. code-block:: python page_count = len(doc) for i in range(page_count): doc.copy_page(i) # copy this page to after last page **API reference** - :meth:`Document.select` ---------- .. _The_Basics_Adding_Blank_Pages: Adding Blank Pages ~~~~~~~~~~~~~~~~~~~~~ To add a blank page, do the following: .. code-block:: python import pymupdf doc = pymupdf.open(...) # some new or existing PDF document page = doc.new_page(-1, # insertion point: end of document width = 595, # page dimension: A4 portrait height = 842) doc.save("doc-with-new-blank-page.pdf") # save the document .. note:: **Taking it further** Use this to create the page with another pre-defined paper format: .. code-block:: python w, h = pymupdf.paper_size("letter-l") # 'Letter' landscape page = doc.new_page(width = w, height = h) The convenience function :meth:`paper_size` knows over 40 industry standard paper formats to choose from. To see them, inspect dictionary :attr:`paperSizes`. Pass the desired dictionary key to :meth:`paper_size` to retrieve the paper dimensions. Upper and lower case is supported. If you append "-L" to the format name, the landscape version is returned. Here is a 3-liner that creates a |PDF|: with one empty page. Its file size is 460 bytes: .. code-block:: python doc = pymupdf.open() doc.new_page() doc.save("A4.pdf") **API reference** - :meth:`Document.new_page` - :attr:`paperSizes` ---------- .. _The_Basics_Inserting_Pages: Inserting Pages with Text Content ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Using the :meth:`Document.insert_page` method also inserts a new page and accepts the same ``width`` and ``height`` parameters. But it lets you also insert arbitrary text into the new page and returns the number of inserted lines. .. code-block:: python import pymupdf doc = pymupdf.open(...) # some new or existing PDF document n = doc.insert_page(-1, # default insertion point text = "The quick brown fox jumped over the lazy dog", fontsize = 11, width = 595, height = 842, fontname = "Helvetica", # default font fontfile = None, # any font file name color = (0, 0, 0)) # text color (RGB) .. note:: **Taking it further** The text parameter can be a (sequence of) string (assuming UTF-8 encoding). Insertion will start at :ref:`Point` (50, 72), which is one inch below top of page and 50 points from the left. The number of inserted text lines is returned. **API reference** - :meth:`Document.insert_page` ---------- .. _The_Basics_Spliting_Single_Pages: Splitting Single Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~ This deals with splitting up pages of a |PDF| in arbitrary pieces. For example, you may have a |PDF| with *Letter* format pages which you want to print with a magnification factor of four: each page is split up in 4 pieces which each going to a separate |PDF| page in *Letter* format again. .. code-block:: python import pymupdf src = pymupdf.open("test.pdf") doc = pymupdf.open() # empty output PDF for spage in src: # for each page in input r = spage.rect # input page rectangle d = pymupdf.Rect(spage.cropbox_position, # CropBox displacement if not spage.cropbox_position) # starting at (0, 0) #-------------------------------------------------------------------------- # example: cut input page into 2 x 2 parts #-------------------------------------------------------------------------- r1 = r / 2 # top left rect r2 = r1 + (r1.width, 0, r1.width, 0) # top right rect r3 = r1 + (0, r1.height, 0, r1.height) # bottom left rect r4 = pymupdf.Rect(r1.br, r.br) # bottom right rect rect_list = [r1, r2, r3, r4] # put them in a list for rx in rect_list: # run thru rect list rx += d # add the CropBox displacement page = doc.new_page(-1, # new output page with rx dimensions width = rx.width, height = rx.height) page.show_pdf_page( page.rect, # fill all new page with the image src, # input document spage.number, # input page number clip = rx, # which part to use of input page ) # that's it, save output file doc.save("poster-" + src.name, garbage=3, # eliminate duplicate objects deflate=True, # compress stuff where possible ) Example: .. image:: images/img-posterize.png .. note:: **API reference** - :meth:`Page.cropbox_position` - :meth:`Page.show_pdf_page` -------------------------- .. _The_Basics_Combining_Single_Pages: Combining Single Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This deals with joining |PDF| pages to form a new |PDF| with pages each combining two or four original ones (also called "2-up", "4-up", etc.). This could be used to create booklets or thumbnail-like overviews. .. code-block:: python import pymupdf src = pymupdf.open("test.pdf") doc = pymupdf.open() # empty output PDF width, height = pymupdf.paper_size("a4") # A4 portrait output page format r = pymupdf.Rect(0, 0, width, height) # define the 4 rectangles per page r1 = r / 2 # top left rect r2 = r1 + (r1.width, 0, r1.width, 0) # top right r3 = r1 + (0, r1.height, 0, r1.height) # bottom left r4 = pymupdf.Rect(r1.br, r.br) # bottom right # put them in a list r_tab = [r1, r2, r3, r4] # now copy input pages to output for spage in src: if spage.number % 4 == 0: # create new output page page = doc.new_page(-1, width = width, height = height) # insert input page into the correct rectangle page.show_pdf_page(r_tab[spage.number % 4], # select output rect src, # input document spage.number) # input page number # by all means, save new file using garbage collection and compression doc.save("4up.pdf", garbage=3, deflate=True) Example: .. image:: images/img-4up.png .. note:: **API reference** - :meth:`Page.cropbox_position` - :meth:`Page.show_pdf_page` -------------------------- .. _The_Basics_Encryption_and_Decryption: |PDF| Encryption & Decryption ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Starting with version 1.16.0, |PDF| decryption and encryption (using passwords) are fully supported. You can do the following: * Check whether a document is password protected / (still) encrypted (:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`). * Gain access authorization to a document (:meth:`Document.authenticate`). * Set encryption details for PDF files using :meth:`Document.save` or :meth:`Document.write` and - decrypt or encrypt the content - set password(s) - set the encryption method - set permission details .. note:: A PDF document may have two different passwords: * The **owner password** provides full access rights, including changing passwords, encryption method, or permission detail. * The **user password** provides access to document content according to the established permission details. If present, opening the |PDF| in a viewer will require providing it. Method :meth:`Document.authenticate` will automatically establish access rights according to the password used. The following snippet creates a new |PDF| and encrypts it with separate user and owner passwords. Permissions are granted to print, copy and annotate, but no changes are allowed to someone authenticating with the user password. .. code-block:: python import pymupdf text = "some secret information" # keep this data secret perm = int( pymupdf.PDF_PERM_ACCESSIBILITY # always use this | pymupdf.PDF_PERM_PRINT # permit printing | pymupdf.PDF_PERM_COPY # permit copying | pymupdf.PDF_PERM_ANNOTATE # permit annotations ) owner_pass = "owner" # owner password user_pass = "user" # user password encrypt_meth = pymupdf.PDF_ENCRYPT_AES_256 # strongest algorithm doc = pymupdf.open() # empty pdf page = doc.new_page() # empty page page.insert_text((50, 72), text) # insert the data doc.save( "secret.pdf", encryption=encrypt_meth, # set the encryption method owner_pw=owner_pass, # set the owner password user_pw=user_pass, # set the user password permissions=perm, # set permissions ) .. note:: **Taking it further** Opening this document with some viewer (Nitro Reader 5) reflects these settings: .. image:: images/img-encrypting.* **Decrypting** will automatically happen on save as before when no encryption parameters are provided. To **keep the encryption method** of a PDF save it using `encryption=pymupdf.PDF_ENCRYPT_KEEP`. If `doc.can_save_incrementally() == True`, an incremental save is also possible. To **change the encryption method** specify the full range of options above (`encryption`, `owner_pw`, `user_pw`, `permissions`). An incremental save is **not possible** in this case. **API reference** - :meth:`Document.save` -------------------------- .. _The_Basics_Extracting_Tables: Extracting Tables from a :title:`Page` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Tables can be found and extracted from any document :ref:`Page`. .. code-block:: python import pymupdf from pprint import pprint doc = pymupdf.open("test.pdf") # open document page = doc[0] # get the 1st page of the document tabs = page.find_tables() # locate and extract any tables on page print(f"{len(tabs.tables)} found on {page}") # display number of found tables if tabs.tables: # at least one table found? pprint(tabs[0].extract()) # print content of first table .. note:: **API reference** - :meth:`Page.find_tables` .. important:: There is also the `pdf2docx extract tables method`_ which is capable of table extraction if you prefer. -------------------------- .. _The_Basics_Get_Page_Links: Getting Page Links ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Links can be extracted from a :ref:`Page` to return :ref:`Link` objects. .. code-block:: python import pymupdf for page in doc: # iterate the document pages link = page.first_link # a `Link` object or `None` while link: # iterate over the links on page # do something with the link, then: link = link.next # get next link, last one has `None` in its `next` .. note:: **API reference** - :meth:`Page.first_link` ----------------------------- .. _The_Basics_Get_All_Annotations: Getting All Annotations from a Document ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Annotations (:ref:`Annot`) on pages can be retrieved with the `page.annots()` method. .. code-block:: python import pymupdf for page in doc: for annot in page.annots(): print(f'Annotation on page: {page.number} with type: {annot.type} and rect: {annot.rect}') .. note:: **API reference** - :meth:`Page.annots` -------------------------- .. _The_Basics_Redacting: Redacting content from a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Redactions are special types of annotations which can be marked onto a document page to denote an area on the page which should be securely removed. After marking an area with a rectangle then this area will be marked for *redaction*, once the redaction is *applied* then the content is securely removed. For example if we wanted to redact all instances of the name "Jane Doe" from a document we could do the following: .. code-block:: python import pymupdf # Open the PDF document doc = pymupdf.open('test.pdf') # Iterate over each page of the document for page in doc: # Find all instances of "Jane Doe" on the current page instances = page.search_for("Jane Doe") # Redact each instance of "Jane Doe" on the current page for inst in instances: page.add_redact_annot(inst) # Apply the redactions to the current page page.apply_redactions() # Save the modified document doc.save('redacted_document.pdf') # Close the document doc.close() Another example could be redacting an area of a page, but not to redact any line art (i.e. vector graphics) within the defined area, by setting a parameter flag as follows: .. code-block:: python import pymupdf # Open the PDF document doc = pymupdf.open('test.pdf') # Get the first page page = doc[0] # Add an area to redact rect = [0,0,200,200] # Add a redacction annotation which will have a red fill color page.add_redact_annot(rect, fill=(1,0,0)) # Apply the redactions to the current page, but ignore vector graphics page.apply_redactions(graphics=0) # Save the modified document doc.save('redactied_document.pdf') # Close the document doc.close() .. warning:: Once a redacted version of a document is saved then the redacted content in the |PDF| is *irretrievable*. Thus, a redacted area in a document removes text and graphics completely from that area. .. note:: **Taking it further** The are a few options for creating and applying redactions to a page, for the full API details to understand the parameters to control these options refer to the API reference. **API reference** - :meth:`Page.add_redact_annot` - :meth:`Page.apply_redactions` -------------------------- .. _The Basics_Coverting_PDF_Documents: Converting PDF Documents ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ We recommend the pdf2docx_ library which uses |PyMuPDF| and the **python-docx** library to provide simple document conversion from |PDF| to **DOCX** format. .. include:: footer.rst ================================================ FILE: docs/tools.rst ================================================ .. include:: header.rst .. _Tools: Tools ================ This class is a collection of utility methods and attributes, mainly around memory management. To simplify and speed up its use, it is automatically instantiated under the name *TOOLS* when PyMuPDF is imported. ====================================== ================================================= **Method / Attribute** **Description** ====================================== ================================================= :meth:`Tools.gen_id` generate a unique identifier :meth:`Tools.store_shrink` shrink the storables cache [#f1]_ :meth:`Tools.mupdf_warnings` return the accumulated MuPDF warnings :meth:`Tools.mupdf_display_errors` control whether MuPDF errors are displayed as messages. :meth:`Tools.mupdf_display_warnings` control whether MuPDF warnings are displayed as messages. :meth:`Tools.reset_mupdf_warnings` empty MuPDF warnings/errors message buffer. :meth:`Tools.set_aa_level` set the anti-aliasing values :meth:`Tools.set_annot_stem` set the prefix of new annotation / link ids :meth:`Tools.set_small_glyph_heights` search and extract using small bbox heights :meth:`Tools.set_subset_fontnames` control suppression of subset fontname tags :meth:`Tools.show_aa_level` return the anti-aliasing values :meth:`Tools.unset_quad_corrections` disable PyMuPDF-specific code :attr:`Tools.fitz_config` configuration settings of PyMuPDF :attr:`Tools.store_maxsize` maximum storables cache size :attr:`Tools.store_size` current storables cache size ====================================== ================================================= **Class API** .. class:: Tools .. method:: gen_id() A convenience method returning a unique positive integer which will increase by 1 on every invocation. Example usages include creating unique keys in databases - its creation should be faster than using timestamps by an order of magnitude. .. note:: MuPDF has dropped support for this in v1.14.0, so we have re-implemented a similar function with the following differences: * It is not part of MuPDF's global context and not threadsafe (not an issue because we do not support threads in PyMuPDF anyway). * It is implemented as *int*. This means that the maximum number is *sys.maxsize*. Should this number ever be exceeded, the counter starts over again at 1. :rtype: int :returns: a unique positive integer. .. method:: set_annot_stem(stem=None) * New in v1.18.6 Set or inquire the prefix for the id of new annotations, fields or links. :arg str stem: if omitted, the current value is returned, default is "fitz". Annotations, fields / widgets and links technically are subtypes of the same type of object (`/Annot`) in PDF documents. An `/Annot` object may be given a unique identifier within a page. For each of the applicable subtypes, PyMuPDF generates identifiers "stem-Annn", "stem-Wnnn" or "stem-Lnnn" respectively. The number "nnn" is used to enforce the required uniqueness. :rtype: str :returns: the current value. .. method:: set_small_glyph_heights(on=None) * New in v1.18.5 Set or inquire reduced bbox heights in text extract and text search methods. :arg bool on: if omitted or `None`, the current setting is returned. For other values the *bool()* function is applied to set a global variable. If `True`, :meth:`Page.search_for` and :meth:`Page.get_text` methods return character, span, line or block bboxes that have a height of *font size*. If `False` (standard setting when PyMuPDF is imported), bbox height will be based on font properties and normally equal *line height*. :rtype: bool :returns: ``True`` or ``False``. .. note:: Text extraction options "xml", "xhtml" and "html", which directly wrap MuPDF code, are not influenced by this. .. method:: set_subset_fontnames(on=None) * New in v1.18.9 Control suppression of subset fontname tags in text extractions. :arg bool on: if omitted / `None`, the current setting is returned. Arguments evaluating to `True` or `False` set a global variable. If `True`, options "dict", "json", "rawdict" and "rawjson" will return e.g. `"NOHSJV+Calibri-Light"`, otherwise only `"Calibri-Light"` (the default). The setting remains in effect until changed again. :rtype: bool :returns: ``True`` or ``False``. .. note:: Except mentioned above, no other text extraction variants are influenced by this. This is especially true for the options "xml", "xhtml" and "html", which are based on MuPDF code. They extract the font name `"Calibri-Light"`, or even just the **family** name -- `Calibri` in this example. .. method:: unset_quad_corrections(on=None) * New in v1.18.10 Enable / disable PyMuPDF-specific code, that tries to rebuild valid character quads when encountering nonsense in :meth:`Page.get_text` text extractions. This code depends on certain font properties (ascender and descender), which do not exist in rare situations and cause segmentation faults when trying to access them. This method sets a global parameter in PyMuPDF, which suppresses execution of this code. :arg bool on: if omitted or `None`, the current setting is returned. For other values the *bool()* function is applied to set a global variable. If `True`, PyMuPDF will not try to access the resp. font properties and use values `ascender=0.8` and `descender=-0.2` instead. :rtype: bool :returns: ``True`` or ``False``. .. method:: store_shrink(percent) Reduce the storables cache by a percentage of its current size. :arg int percent: the percentage of current size to free. If 100+ the store will be emptied, if zero, nothing will happen. MuPDF's caching strategy is "least recently used", so low-usage elements get deleted first. :rtype: int :returns: the new current store size. Depending on the situation, the size reduction may be larger than the requested percentage. .. method:: show_aa_level() * New in version 1.16.14 Return the current anti-aliasing values. These values control the rendering quality of graphics and text elements. :rtype: dict :returns: A dictionary with the following initial content: `{'graphics': 8, 'text': 8, 'graphics_min_line_width': 0.0}`. .. method:: set_aa_level(level) * New in version 1.16.14 Set the new number of bits to use for anti-aliasing. The same value is taken currently for graphics and text rendering. This might change in a future MuPDF release. :arg int level: an integer ranging between 0 and 8. Value outside this range will be silently changed to valid values. The value will remain in effect throughout the current session or until changed again. .. method:: reset_mupdf_warnings() * New in version 1.16.0 Empty MuPDF warnings message buffer. .. method:: mupdf_display_errors(value=None) Control whether MuPDF errors should be displayed as |PyMuPDF| messages. :arg value: * If `None`, the current setting is left unchanged. * Otherwise changes the current setting to `bool(value)`; if ``True``, future MuPDF errors will be shown as :ref:`Messages`. * Regardless of this setting, MuPDF errors will always be stored in the warnings store. * Upon import of |PyMuPDF| this value is ``True``. :returns: The current setting as ``True`` or ``False``. * New in version 1.16.8 .. method:: mupdf_display_warnings(value=None) Control whether MuPDF warnings should be displayed as |PyMuPDF| messages. :arg value: * If `None`, the current setting is left unchanged. * Otherwise changes the current setting to `bool(value)`; if ``True``, future MuPDF warnings will be shown as :ref:`Messages`. * Regardless of this setting, MuPDF warnings will always be stored in the warnings store. * Upon import of |PyMuPDF| this value is ``True``. :returns: The current setting as ``True`` or ``False``. * New in version 1.16.8 .. method:: mupdf_warnings(reset=True) * New in version 1.16.0 Return all stored MuPDF messages as a string with interspersed line-breaks. :arg bool reset: *(new in version 1.16.7)* whether to automatically empty the store. .. attribute:: fitz_config A dictionary containing the actual values used for configuring PyMuPDF and MuPDF. Also refer to the installation chapter. This is an overview of the keys, each of which describes the status of a support aspect. ================= =================================================== **Key** **Support included for ...** ================= =================================================== plotter-g Gray colorspace rendering plotter-rgb RGB colorspace rendering plotter-cmyk CMYK colorspcae rendering plotter-n overprint rendering pdf PDF documents xps XPS documents svg SVG documents cbz CBZ documents img IMG documents html HTML documents epub EPUB documents jpx JPEG2000 images js JavaScript tofu all TOFU fonts tofu-cjk CJK font subset (China, Japan, Korea) tofu-cjk-ext CJK font extensions tofu-cjk-lang CJK font language extensions tofu-emoji TOFU emoji fonts tofu-historic TOFU historic fonts tofu-symbol TOFU symbol fonts tofu-sil TOFU SIL fonts icc ICC profiles py-memory using Python memory management [#f2]_ base14 Base-14 fonts (should always be true) ================= =================================================== For an explanation of the term "TOFU" see `this Wikipedia article `_:: In [1]: import pymupdf In [2]: TOOLS.fitz_config Out[2]: {'plotter-g': True, 'plotter-rgb': True, 'plotter-cmyk': True, 'plotter-n': True, 'pdf': True, 'xps': True, 'svg': True, 'cbz': True, 'img': True, 'html': True, 'epub': True, 'jpx': True, 'js': True, 'tofu': False, 'tofu-cjk': True, 'tofu-cjk-ext': False, 'tofu-cjk-lang': False, 'tofu-emoji': False, 'tofu-historic': False, 'tofu-symbol': False, 'tofu-sil': False, 'icc': True, 'py-memory': False, 'base14': True} :rtype: dict .. attribute:: store_maxsize Maximum storables cache size in bytes. |PyMuPDF| is generated with a value of 268'435'456 (256 MB, the default value), which you should therefore always see here. If this value is zero, then an "unlimited" growth is permitted. :rtype: int .. attribute:: store_size Current storables cache size in bytes. This value may change (and will usually increase) with every use of a |PyMuPDF| function. It will (automatically) decrease only when :attr:`Tools.store_maxsize` is going to be exceeded: in this case, |MuPDF| will evict low-usage objects until the value is again in range. :rtype: int Example Session ---------------- .. code-block:: python >>> import pymupdf # print the maximum and current cache sizes >>> pymupdf.TOOLS.store_maxsize 268435456 >>> pymupdf.TOOLS.store_size 0 >>> doc = pymupdf.open("demo1.pdf") # pixmap creation puts lots of object in cache (text, images, fonts), # apart from the pixmap itself >>> pix = doc[0].get_pixmap(alpha=False) >>> pymupdf.TOOLS.store_size 454519 # release (at least) 50% of the storage >>> pymupdf.TOOLS.store_shrink(50) 13471 >>> pymupdf.TOOLS.store_size 13471 # get a few unique numbers >>> pymupdf.TOOLS.gen_id() 1 >>> pymupdf.TOOLS.gen_id() 2 >>> pymupdf.TOOLS.gen_id() 3 # close document and see how much cache is still in use >>> doc.close() >>> pymupdf.TOOLS.store_size 0 >>> .. rubric:: Footnotes .. [#f1] This memory area is internally used by MuPDF, and it serves as a cache for objects that have already been read and interpreted, thus improving performance. The most bulky object types are images and also fonts. When an application starts up the MuPDF library (in our case this happens as part of *import pymupdf*), it must specify a maximum size for this area. PyMuPDF's uses the default value (256 MB) to limit memory consumption. Use the methods here to control or investigate store usage. For example: even after a document has been closed and all related objects have been deleted, the store usage may still not drop down to zero. So you might want to enforce that before opening another document. .. [#f2] By default PyMuPDF and MuPDF use `malloc()`/`free()` for dynamic memory management. One can instead force them to use the Python allocation functions `PyMem_New()`/`PyMem_Del()`, by modifying *fitz/fitz.i* to do `#define JM_MEMORY 1` and rebuilding PyMuPDF. .. include:: footer.rst ================================================ FILE: docs/tutorial.rst ================================================ .. include:: header.rst .. _Tutorial: ========= Tutorial ========= .. highlight:: python This tutorial will show you the use of |PyMuPDF|, |MuPDF| in Python, step by step. Because |MuPDF| supports not only PDF, but also XPS, OpenXPS, CBZ, CBR, FB2 and EPUB formats, so does |PyMuPDF| [#f1]_. Nevertheless, for the sake of brevity we will only talk about PDF files. At places where indeed only PDF files are supported, this will be mentioned explicitly. In addition to this introduction, please do visit PyMuPDF's `YouTube Channel `_ which covers most of the following in the form of YouTube "Shorts" and longer videos. Importing the Bindings ========================== The Python bindings to MuPDF are made available by this import statement. We also show here how your version can be checked:: >>> import pymupdf >>> print(pymupdf.__doc__) PyMuPDF 1.16.0: Python bindings for the MuPDF 1.16.0 library. Version date: 2019-07-28 07:30:14. Built for Python 3.7 on win32 (64-bit). Note on the Name *fitz* -------------------------- Old versions of |PyMuPDF| had their **Python** import name as `fitz`. Newer versions use `pymupdf` instead, and offer `fitz` as a fallback so that old code will still work. The reason for the name `fitz` is a historical curiosity: The original rendering library for MuPDF was called *Libart*. *"After Artifex Software acquired the MuPDF project, the development focus shifted on writing a new modern graphics library called "Fitz". Fitz was originally intended as an R&D project to replace the aging Ghostscript graphics library, but has instead become the rendering engine powering MuPDF."* (Quoted from `Wikipedia `_). .. note:: Use of legacy name `fitz` can fail if defunct pypi.org package `fitz` is installed; see :ref:`problems-after-installation`. .. _Tutorial_Opening_a_Document: Opening a Document ====================== To access a :ref:`supported document`, it must be opened with the following statement:: doc = pymupdf.open(filename) # or pymupdf.Document(filename) This creates the :ref:`Document` object *doc*. *filename* must be a Python string (or a `pathlib.Path`) specifying the name of an existing file. It is also possible to open a document from memory data, or to create a new, empty PDF. See :ref:`Document` for details. You can also use :ref:`Document` as a *context manager*. A document contains many attributes and functions. Among them are meta information (like "author" or "subject"), number of total pages, outline and encryption information. Some :ref:`Document` Methods and Attributes ============================================= =========================== ========================================== **Method / Attribute** **Description** =========================== ========================================== :attr:`Document.page_count` the number of pages (*int*) :attr:`Document.metadata` the metadata (*dict*) :meth:`Document.get_toc` get the table of contents (*list*) :meth:`Document.load_page` read a :ref:`Page` =========================== ========================================== Accessing Meta Data ======================== PyMuPDF fully supports standard metadata. :attr:`Document.metadata` is a Python dictionary with the following keys. It is available for **all document types**, though not all entries may always contain data. For details of their meanings and formats consult the respective manuals, e.g. :ref:`AdobeManual` for PDF. Further information can also be found in chapter :ref:`Document`. The meta data fields are strings or ``None`` if not otherwise indicated. Also be aware that not all of them always contain meaningful data -- even if they are not ``None``. ============== ================================= Key Value ============== ================================= producer producer (producing software) format format: 'PDF-1.4', 'EPUB', etc. encryption encryption method used if any author author modDate date of last modification keywords keywords title title creationDate date of creation creator creating application subject subject ============== ================================= .. note:: Apart from these standard metadata, **PDF documents** starting from PDF version 1.4 may also contain so-called *"metadata streams"* (see also :data:`stream`). Information in such streams is coded in XML. PyMuPDF deliberately contains no XML components for this purpose (the :ref:`PyMuPDF Xml class` is a helper class intended to access the DOM content of a :ref:`Story` object), so we do not directly support access to information contained therein. But you can extract the stream as a whole, inspect or modify it using a package like `lxml`_ and then store the result back into the PDF. If you want, you can also delete this data altogether. .. note:: There are two utility scripts in the repository that `metadata import (PDF only)`_ resp. `metadata export`_ metadata from resp. to CSV files. Working with Outlines ========================= The easiest way to get all outlines (also called "bookmarks") of a document, is by loading its *table of contents*:: toc = doc.get_toc() This will return a Python list of lists *[[lvl, title, page, ...], ...]* which looks much like a conventional table of contents found in books. *lvl* is the hierarchy level of the entry (starting from 1), *title* is the entry's title, and *page* the page number (1-based!). Other parameters describe details of the bookmark target. .. note:: There are two utility scripts in the repository that `toc import (PDF only)`_ resp. `toc export`_ table of contents from resp. to CSV files. Working with Pages ====================== :ref:`Page` handling is at the core of MuPDF's functionality. * You can render a page into a raster or vector (SVG) image, optionally zooming, rotating, shifting or shearing it. * You can extract a page's text and images in many formats and search for text strings. * For PDF documents many more methods are available to add text or images to pages. First, a :ref:`Page` must be created. This is a method of :ref:`Document`:: page = doc.load_page(pno) # loads page number 'pno' of the document (0-based) page = doc[pno] # the short form Any integer `-∞ < pno < page_count` is possible here. Negative numbers count backwards from the end, so *doc[-1]* is the last page, like with Python sequences. Some more advanced way would be using the document as an **iterator** over its pages:: for page in doc: # do something with 'page' # ... or read backwards for page in reversed(doc): # do something with 'page' # ... or even use 'slicing' for page in doc.pages(start, stop, step): # do something with 'page' Once you have your page, here is what you would typically do with it: Inspecting the Links, Annotations or Form Fields of a Page ----------------------------------------------------------- Links are shown as "hot areas" when a document is displayed with some viewer software. If you click while your cursor shows a hand symbol, you will usually be taken to the target that is encoded in that hot area. Here is how to get all links:: # get all links on a page links = page.get_links() *links* is a Python list of dictionaries. For details see :meth:`Page.get_links`. You can also use an iterator which emits one link at a time:: for link in page.links(): # do something with 'link' If dealing with a PDF document page, there may also exist annotations (:ref:`Annot`) or form fields (:ref:`Widget`), each of which have their own iterators:: for annot in page.annots(): # do something with 'annot' for field in page.widgets(): # do something with 'field' Rendering a Page ----------------------- This example creates a **raster** image of a page's content:: pix = page.get_pixmap() ``pix`` is a :ref:`Pixmap` object which (in this case) contains an **RGB** image of the page, ready to be used for many purposes. Method :meth:`Page.get_pixmap` offers lots of variations for controlling the image: resolution / DPI, colorspace (e.g. to produce a grayscale image or an image with a subtractive color scheme), transparency, rotation, mirroring, shifting, shearing, etc. For example: to create an **RGBA** image (i.e. containing an alpha channel), specify *pix = page.get_pixmap(alpha=True)*. A :ref:`Pixmap` contains a number of methods and attributes which are referenced below. Among them are the integers ``width``, ``height`` (each in pixels) and ``stride`` (number of bytes of one horizontal image line). Attribute ``samples`` represents a rectangular area of bytes representing the image data (a Python ``bytes`` object). .. note:: You can also create a **vector** image of a page by using :meth:`Page.get_svg_image`. Refer to this `Vector Image Support page`_ for details. Saving the Page Image in a File ----------------------------------- We can simply store the image in a PNG file:: pix.save(f"page-{page.number}.png") Displaying the Image in GUIs ------------------------------------------- We can also use it in GUI dialog managers. :attr:`Pixmap.samples` represents an area of bytes of all the pixels as a Python bytes object. Here are some examples, find more in the `examples`_ directory. wxPython ~~~~~~~~~~~~~ Consult their documentation for adjustments to RGB(A) pixmaps and, potentially, specifics for your wxPython release:: if pix.alpha: bitmap = wx.Bitmap.FromBufferRGBA(pix.width, pix.height, pix.samples) else: bitmap = wx.Bitmap.FromBuffer(pix.width, pix.height, pix.samples) Tkinter ~~~~~~~~~~ Please also see section 3.19 of the `Pillow documentation`_:: from PIL import Image, ImageTk # set the mode depending on alpha mode = "RGBA" if pix.alpha else "RGB" img = Image.frombytes(mode, [pix.width, pix.height], pix.samples) tkimg = ImageTk.PhotoImage(img) The following **avoids using Pillow**:: # remove alpha if present pix1 = pymupdf.Pixmap(pix, 0) if pix.alpha else pix # PPM does not support transparency imgdata = pix1.tobytes("ppm") # extremely fast! tkimg = tkinter.PhotoImage(data = imgdata) If you are looking for a complete Tkinter script paging through **any supported** document, `here it is!`_. It can also zoom into pages, and it runs under Python 2 or 3. It requires the extremely handy `PySimpleGUI`_ pure Python package. PyQt4, PyQt5, PySide ~~~~~~~~~~~~~~~~~~~~~ Please also see section 3.16 of the `Pillow documentation`_:: from PIL import Image, ImageQt # set the mode depending on alpha mode = "RGBA" if pix.alpha else "RGB" img = Image.frombytes(mode, [pix.width, pix.height], pix.samples) qtimg = ImageQt.ImageQt(img) Again, you also can get along **without using Pillow.** Qt's `QImage` luckily supports native Python pointers, so the following is the recommended way to create Qt images:: from PyQt5.QtGui import QImage # set the correct QImage format depending on alpha fmt = QImage.Format_RGBA8888 if pix.alpha else QImage.Format_RGB888 qtimg = QImage(pix.samples_ptr, pix.width, pix.height, fmt) Extracting Text and Images --------------------------- We can also extract all text, images and other information of a page in many different forms, and levels of detail:: text = page.get_text(opt) Use one of the following strings for *opt* to obtain different formats [#f2]_: * **"text"**: (default) plain text with line breaks. No formatting, no text position details, no images. * **"blocks"**: generate a list of text blocks (= paragraphs). * **"words"**: generate a list of words (strings not containing spaces). * **"html"**: creates a full visual version of the page including any images. This can be displayed with your internet browser. * **"dict"** / **"json"**: same information level as HTML, but provided as a Python dictionary or resp. JSON string. See :meth:`TextPage.extractDICT` for details of its structure. * **"rawdict"** / **"rawjson"**: a super-set of **"dict"** / **"json"**. It additionally provides character detail information like XML. See :meth:`TextPage.extractRAWDICT` for details of its structure. * **"xhtml"**: text information level as the TEXT version but includes images. Can also be displayed by internet browsers. * **"xml"**: contains no images, but full position and font information down to each single text character. Use an XML module to interpret. To give you an idea about the output of these alternatives, we did text example extracts. See :ref:`Appendix1`. Searching for Text ------------------- You can find out, exactly where on a page a certain text string appears:: areas = page.search_for("mupdf") This delivers a list of rectangles (see :ref:`Rect`), each of which surrounds one occurrence of the string "mupdf" (case insensitive). You could use this information to e.g. highlight those areas (PDF only) or create a cross reference of the document. Please also do have a look at chapter :ref:`cooperation` and at demo programs `demo.py`_ and `demo-lowlevel.py`_. Among other things they contain details on how the :ref:`TextPage`, :ref:`Device` and :ref:`DisplayList` classes can be used for a more direct control, e.g. when performance considerations suggest it. .. _WorkingWithStories: Stories: Generating PDF from HTML Source ========================================= The :ref:`Story` class is a new feature of PyMuPDF version 1.21.0. It represents support for MuPDF's **"story"** interface. The following is a quote from the book `"MuPDF Explored"`_ by Robin Watts from `Artifex`_: ----- *Stories provide a way to easily layout styled content for use with devices, such as those offered by Document Writers (...). The concept of a story comes from desktop publishing, which in turn (...) gets it from newspapers. If you consider a traditional newspaper layout, it will consist of various news articles (stories) that are laid out into multiple columns, possibly across multiple pages.* *Accordingly, MuPDF uses a story to represent a flow of text with styling information. The user of the story can then supply a sequence of rectangles into which the story will be laid out, and the positioned text can then be drawn to an output device. This keeps the concept of the text itself (the story) to be separated from the areas into which the text should be flowed (the layout).* ----- .. note:: A Story works somewhat similar to an internet browser: It faithfully parses and renders HTML hypertext and also optional stylesheets (CSS). But its **output is a PDF** -- not web pages. When creating a :ref:`Story`, the input from up to three different information sources is taken into account. All these items are optional. 1. HTML source code, either a Python string or **created by the script** using methods of :ref:`Xml`. 2. CSS (Cascaded Style Sheet) source code, provided as a Python string. CSS can be used to provide styling information (text font size, color, etc.) like it would happen for web pages. Obviously, this string may also be read from a file. 3. An :ref:`Archive` **must be used** whenever the DOM references images, or uses text fonts except the standard :ref:`Base-14-Fonts`, CJK fonts and the NOTO fonts generated into the PyMuPDF binary. The :ref:`API` allows creating DOMs completely from scratch, including desired styling information. It can also be used to modify or extend **provided** HTML: text can be deleted or replaced, or its styling can be changed. Text -- for example extracted from databases -- can also be added and fill template-like HTML documents. It is **not required** to provide syntactically complete HTML documents: snippets like `Hello World!` are fully accepted, and many / most syntax errors are automatically corrected. After the HTML is considered complete, it can be used to create a PDF document. This happens via the new :ref:`DocumentWriter` class. The programmer calls its methods to create a new empty page, and passes rectangles to the Story to fill them. The story in turn will return completion codes indicating whether or not more content is waiting to be written. Which part of the content will land in which rectangle or on which page is automatically determined by the story itself -- it cannot be influenced other than by providing the rectangles. Please see the :ref:`Stories recipes` for a number of typical use cases. PDF Maintenance ================== PDFs are the only document type that can be **modified** using PyMuPDF. Other file types are read-only. However, you can convert **any document** (including images) to a PDF and then apply all PyMuPDF features to the conversion result. Find out more here :meth:`Document.convert_to_pdf`, and also look at the demo script `pdf-converter.py`_ which can convert any :ref:`supported document` to PDF. :meth:`Document.save()` always stores a PDF in its current (potentially modified) state on disk. You normally can choose whether to save to a new file, or just append your modifications to the existing one ("incremental save"), which often is very much faster. The following describes ways how you can manipulate PDF documents. This description is by no means complete: much more can be found in the following chapters. Modifying, Creating, Re-arranging and Deleting Pages ------------------------------------------------------- There are several ways to manipulate the so-called **page tree** (a structure describing all the pages) of a PDF: :meth:`Document.delete_page` and :meth:`Document.delete_pages` delete pages. :meth:`Document.copy_page`, :meth:`Document.fullcopy_page` and :meth:`Document.move_page` copy or move a page to other locations within the same document. :meth:`Document.select` shrinks a PDF down to selected pages. Parameter is a sequence [#f3]_ of the page numbers that you want to keep. These integers must all be in range *0 <= i < page_count*. When executed, all pages **missing** in this list will be deleted. Remaining pages will occur **in the sequence and as many times (!) as you specify them**. So you can easily create new PDFs with * the first or last 10 pages, * only the odd or only the even pages (for doing double-sided printing), * pages that **do** or **don't** contain a given text, * reverse the page sequence, ... ... whatever you can think of. The saved new document will contain links, annotations and bookmarks that are still valid (i.a.w. either pointing to a selected page or to some external resource). :meth:`Document.insert_page` and :meth:`Document.new_page` insert new pages. Pages themselves can moreover be modified by a range of methods (e.g. page rotation, annotation and link maintenance, text and image insertion). Joining and Splitting PDF Documents ------------------------------------ Method :meth:`Document.insert_pdf` copies pages **between different** PDF documents. Here is a simple **joiner** example (*doc1* and *doc2* being opened PDFs):: # append complete doc2 to the end of doc1 doc1.insert_pdf(doc2) Here is a snippet that **splits** *doc1*. It creates a new document of its first and its last 10 pages:: doc2 = pymupdf.open() # new empty PDF doc2.insert_pdf(doc1, to_page = 9) # first 10 pages doc2.insert_pdf(doc1, from_page = len(doc1) - 10) # last 10 pages doc2.save("first-and-last-10.pdf") More can be found in the :ref:`Document` chapter. Also have a look at `PDFjoiner.py`_. Embedding Data --------------- PDFs can be used as containers for arbitrary data (executables, other PDFs, text or binary files, etc.) much like ZIP archives. PyMuPDF fully supports this feature via :ref:`Document` ``embfile_*`` methods and attributes. For some detail read :ref:`Appendix2`, consult the Wiki on `dealing with embedding files`_, or the example scripts `embedded-copy.py`_, `embedded-export.py`_, `embedded-import.py`_, and `embedded-list.py`_. Saving ------- As mentioned above, :meth:`Document.save` will **always** save the document in its current state. You can write changes back to the **original PDF** by specifying option ``incremental=True``. This process is (usually) **extremely fast**, since changes are **appended to the original file** without completely rewriting it. :meth:`Document.save` options correspond to options of MuPDF's command line utility *mutool clean*, see the following table. =================== =========== ================================================== **Save Option** **mutool** **Effect** =================== =========== ================================================== garbage=1 g garbage collect unused objects garbage=2 gg in addition to 1, compact :data:`xref` tables garbage=3 ggg in addition to 2, merge duplicate objects garbage=4 gggg in addition to 3, merge duplicate stream content clean=True cs clean and sanitize content streams deflate=True z deflate uncompressed streams deflate_images=True i deflate image streams deflate_fonts=True f deflate fontfile streams ascii=True a convert binary data to ASCII format linear=True l create a linearized version expand=True d decompress all streams =================== =========== ================================================== .. note:: For an explanation of terms like ``object``, ``stream``, ``xref`` consult the :ref:`Glossary` chapter. For example, ``mutool clean -ggggz file.pdf`` yields excellent compression results. It corresponds to ``doc.save(filename, garbage=4, deflate=True)``. Closing ========= It is often desirable to "close" a document to relinquish control of the underlying file to the OS, while your program continues. This can be achieved by the :meth:`Document.close` method. Apart from closing the underlying file, buffer areas associated with the document will be freed. Further Reading ================ Also have a look at PyMuPDF's `Wiki`_ pages. Especially those named in the sidebar under title **"Recipes"** cover over 15 topics written in "How-To" style. This document also contains a :ref:`FAQ`. This chapter has close connection to the aforementioned recipes, and it will be extended with more content over time. ----- .. rubric:: Footnotes .. [#f1] PyMuPDF lets you also open several image file types just like normal documents. See section :ref:`ImageFiles` in chapter :ref:`Pixmap` for more comments. .. [#f2] :meth:`Page.get_text` is a convenience wrapper for several methods of another PyMuPDF class, :ref:`TextPage`. The names of these methods correspond to the argument string passed to :meth:`Page.get_text` \: *Page.get_text("dict")* is equivalent to *TextPage.extractDICT()* \. .. [#f3] "Sequences" are Python objects conforming to the sequence protocol. These objects implement a method named *__getitem__()*. Best known examples are Python tuples and lists. But *array.array*, *numpy.array* and PyMuPDF's "geometry" objects (:ref:`Algebra`) are sequences, too. Refer to :ref:`SequenceTypes` for details. .. include:: footer.rst .. External links: .. _lxml: https://pypi.org/project/lxml/ .. _metadata import (PDF only): https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/import-metadata/import.py .. _metadata export: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/export-metadata/export.py .. _toc import (PDF only): https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/import-toc/import.py .. _toc export: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/export-toc/export.py .. _Vector Image Support page: https://github.com/pymupdf/PyMuPDF/wiki/Vector-Image-Support .. _examples: https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples .. _Pillow documentation: https://Pillow.readthedocs.io .. _here it is!: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/browse-document/browse.py .. _PySimpleGUI: https://pypi.org/project/PySimpleGUI/ .. _demo.py: https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/demo/demo.py .. _demo-lowlevel.py: https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/demo/demo-lowlevel.py .. _"MuPDF Explored": https://mupdf.com/docs/mupdf_explored.pdf .. _Artifex: https://www.artifex.com .. _pdf-converter.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/convert-document/convert.py .. _PDFjoiner.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py .. _dealing with embedding files: https://github.com/pymupdf/PyMuPDF/wiki/Dealing-with-Embedded-Files .. _embedded-copy.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/copy-embedded/copy.py .. _embedded-export.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/export-embedded/export.py .. _embedded-import.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/import-embedded/import.py .. _embedded-list.py: https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/list-embedded/list.py .. _Wiki: https://github.com/pymupdf/PyMuPDF/wiki ================================================ FILE: docs/vars.rst ================================================ .. include:: header.rst =============================== Constants and Enumerations =============================== Constants and enumerations of :title:`MuPDF` as implemented by |PyMuPDF|. Each of the following values is accessible as `pymupdf.value`. Constants --------- .. py:data:: Base14_Fonts Predefined Python list of valid :ref:`Base-14-Fonts`. :type: list .. py:data:: csRGB Predefined RGB colorspace *pymupdf.Colorspace(pymupdf.CS_RGB)*. :type: :ref:`Colorspace` .. py:data:: csGRAY Predefined GRAY colorspace *pymupdf.Colorspace(pymupdf.CS_GRAY)*. :type: :ref:`Colorspace` .. py:data:: csCMYK Predefined CMYK colorspace *pymupdf.Colorspace(pymupdf.CS_CMYK)*. :type: :ref:`Colorspace` .. py:data:: CS_RGB 1 -- Type of :ref:`Colorspace` is RGBA :type: int .. py:data:: CS_GRAY 2 -- Type of :ref:`Colorspace` is GRAY :type: int .. py:data:: CS_CMYK 3 -- Type of :ref:`Colorspace` is CMYK :type: int .. py:data:: mupdf_version 'x.xx.x' -- MuPDF version that is being used by PyMuPDF. :type: string .. py:data:: mupdf_version_tuple MuPDF version as a tuple of integers, `(major, minor, patch)`. :type: tuple .. py:data:: pymupdf_version 'x.xx.x' -- PyMuPDF version. :type: string .. py:data:: pymupdf_version_tuple PyMuPDF version as a tuple of integers, `(major, minor, patch)`. :type: tuple .. py:data:: pymupdf_date Disabled (set to None) in 1.26.1. .. py:data:: version (pymupdf_version, mupdf_version, timestamp) -- combined version information where `timestamp` is the generation point in time formatted as "YYYYMMDDhhmmss". :type: tuple .. py:data:: VersionBind Legacy equivalent to `mupdf_version`. .. py:data:: VersionFitz Legacy equivalent to `pymupdf_version`. .. py:data:: VersionDate Disabled (set to None) in 1.26.1. .. _PermissionCodes: Document Permissions ---------------------------- ====================== ======================================================================= Code Permitted Action ====================== ======================================================================= PDF_PERM_PRINT Print the document PDF_PERM_MODIFY Modify the document's contents PDF_PERM_COPY Copy or otherwise extract text and graphics PDF_PERM_ANNOTATE Add or modify text annotations and interactive form fields PDF_PERM_FORM Fill in forms and sign the document PDF_PERM_ACCESSIBILITY Obsolete, always permitted PDF_PERM_ASSEMBLE Insert, rotate, or delete pages, bookmarks, thumbnail images PDF_PERM_PRINT_HQ High quality printing ====================== ======================================================================= .. _OptionalContentCodes: PDF Optional Content Codes ---------------------------- ====================== ======================================================================= Code Meaning ====================== ======================================================================= PDF_OC_ON Set an OCG to ON temporarily PDF_OC_TOGGLE Toggle OCG status temporarily PDF_OC_OFF Set an OCG to OFF temporarily ====================== ======================================================================= .. _EncryptionMethods: PDF encryption method codes ---------------------------- =================== ==================================================== Code Meaning =================== ==================================================== PDF_ENCRYPT_KEEP do not change PDF_ENCRYPT_NONE remove any encryption PDF_ENCRYPT_RC4_40 RC4 40 bit PDF_ENCRYPT_RC4_128 RC4 128 bit PDF_ENCRYPT_AES_128 *Advanced Encryption Standard* 128 bit PDF_ENCRYPT_AES_256 *Advanced Encryption Standard* 256 bit PDF_ENCRYPT_UNKNOWN unknown =================== ==================================================== .. _FontExtensions: Font File Extensions ----------------------- The table show file extensions you should use when saving fontfile buffers extracted from a PDF. This string is returned by :meth:`Document.get_page_fonts`, :meth:`Page.get_fonts` and :meth:`Document.extract_font`. ==== ============================================================================ Ext Description ==== ============================================================================ ttf TrueType font pfa Postscript for ASCII font (various subtypes) cff Type1C font (compressed font equivalent to Type1) cid character identifier font (postscript format) otf OpenType font n/a not extractable, e.g. :ref:`Base-14-Fonts`, Type 3 fonts and others ==== ============================================================================ .. _TextAlign: Text Alignment ----------------------- .. py:data:: TEXT_ALIGN_LEFT 0 -- align left. .. py:data:: TEXT_ALIGN_CENTER 1 -- align center. .. py:data:: TEXT_ALIGN_RIGHT 2 -- align right. .. py:data:: TEXT_ALIGN_JUSTIFY 3 -- align justify. .. _TextPreserve: .. _FontProperties: Font Properties ----------------------- Please note that the following bits are derived from what a font has to say about its properties. It may not be (and quite often is not) correct. .. py:data:: TEXT_FONT_SUPERSCRIPT 1 -- the character or span is a superscript. This property is computed by MuPDF and not part of any font information. .. py:data:: TEXT_FONT_ITALIC 2 -- the font is italic. .. py:data:: TEXT_FONT_SERIFED 4 -- the font is serifed. .. py:data:: TEXT_FONT_MONOSPACED 8 -- the font is mono-spaced. .. py:data:: TEXT_FONT_BOLD 16 -- the font is bold. Text Extraction Flags --------------------- Option bits controlling the amount of data, that are parsed into a :ref:`TextPage`. For the PyMuPDF programmer, some combination (using Python's `|` operator, or simply use `+`) of these values are aggregated in the ``flags`` integer, a parameter of all text search and text extraction methods. Depending on the individual method, different default combinations of the values are used. Please use a value that meets your situation. Especially make sure to switch off image extraction unless you really need them. The impact on performance and memory is significant! .. py:data:: TEXT_PRESERVE_LIGATURES 1 -- If set, ligatures are passed through to the application in their original form. Otherwise ligatures are expanded into their constituent parts, e.g. the ligature "ffi" is expanded into three eparate characters f, f and i. Default is "on" in PyMuPDF. MuPDF supports the following 7 ligatures: "ff", "fi", "fl", "ffi", "ffl", , "ft", "st". .. py:data:: TEXT_PRESERVE_WHITESPACE 2 -- If set, whitespace is passed through. Otherwise any type of horizontal whitespace (including horizontal tabs) will be replaced with space characters of variable width. Default is "on" in PyMuPDF. .. py:data:: TEXT_PRESERVE_IMAGES 4 -- If set, then images will be stored in the :ref:`TextPage`. This causes the presence of (usually large!) binary image content in the output of text extractions of types "blocks", "dict", "json", "rawdict", "rawjson", "html", and "xhtml" and is the default there. If used with "blocks" however, only image metadata will be returned, not the image itself. .. py:data:: TEXT_INHIBIT_SPACES 8 -- If set, Mupdf will not try to add missing space characters where there are large gaps between characters. In PDF, the creator often does not insert spaces to point to the next character's position, but will provide the direct location address. The default in PyMuPDF is "off" -- so spaces **will be generated**. .. py:data:: TEXT_DEHYPHENATE 16 -- Ignore hyphens at line ends and join with next line. Used internally with the text search functions. However, it is generally available: if on, text extractions will return joined text lines (or spans) with the ending hyphen of the first line eliminated. So two separate spans **"first meth-"** and **"od leads to wrong results"** on different lines will be joined to one span **"first method leads to wrong results"** and correspondingly updated bboxes: the characters of the resulting span will no longer have identical y-coordinates. .. py:data:: TEXT_PRESERVE_SPANS 32 -- Generate a new line for every span. Not used ("off") in PyMuPDF, but available for your use. Every line in "dict", "json", "rawdict", "rawjson" will contain exactly one span. .. py:data:: TEXT_CLIP, TEXT_MEDIABOX_CLIP 64 -- Characters entirely outside a page's **mediabox** or contained in other "clipped" areas will be ignored. This is default in PyMuPDF. (TEXT_MEDIABOX_CLIP is an old alias.) .. py:data:: TEXT_USE_CID_FOR_UNKNOWN_UNICODE 128 -- Use raw character codes instead of U+FFFD. This is the default for **text extraction** in PyMuPDF. If you **want to detect** when encoding information is missing or uncertain, toggle this flag and scan for the presence of U+FFFD (= `chr(0xfffd)`) code points in the resulting text. .. py:data:: TEXT_COLLECT_STRUCTURE 256 -- Extract or generate the :ref:`Document` structure. Detail documentation pending. .. py:data:: TEXT_ACCURATE_BBOXES 512 -- Ignore metric values of all fonts when computing character boundary boxes -- most prominently the `ascender `_ and `descender `_ values. Instead, follow the drawing commands of each character's glyph and compute their rectangle hull as the bbox. This is the smallest rectangle wrapping all points used for drawing the visual appearance - see the :ref:`Shape` class for understanding the background. This will especially result in individual character heights. For instance a (white) space will have a **bbox of zero height** (because nothing is drawn) -- in contrast to the non-zero boundary box generated when using font metrics. This option may be useful to cope with failures of getting meaningful boundary boxes, even for fonts containing errors. Its use will slow down text extraction somewhat because of the incurred computational effort. Note that this has no effect by default - one must also disable the global quad corrections setting with `pymupdf.TOOLS.unset_quad_corrections(True)`. .. py:data:: TEXT_COLLECT_VECTORS 1024 -- Collect vector drawings into the :ref:`TextPage`. These are stored as blocks alongside text and image blocks, depending on other extraction flags. See :meth:`TextPage.extractBLOCKS` and :meth:`TextPage.extractDICT` for details. Beyond these two methods, vector graphics extraction is also available for :meth:`TextPage.extractJSON`, :meth:`TextPage.extractRAWDICT`, :meth:`TextPage.extractRAWJSON` and :meth:`TextPage.extractXML`. .. py:data:: TEXT_IGNORE_ACTUALTEXT 2048 -- Ignore built-in differences between text appearing in e.g. PDF viewers versus text stored in the PDF. See :ref:`AdobeManual`, page 615 for background. If set, the **stored** ("replacement" text) is ignored in favor of the displayed text. .. py:data:: TEXT_SEGMENT 4096 -- Attempt to segment page into different regions. Detail documentation pending. .. py:data:: TEXT_COLLECT_STYLES 32768 -- Request collecting text **decoration** properties. This includes text underlining and strikeout. In contrast to public awareness, these are not font properties, but are drawn separately as vector graphics or annotations on top of the text. In addition, the flag bit will also cause MuPDF to detect "fake bold" text. In many cases, Document creators **simulate bold** text by printing the same text multiple times with slight offsets. If this flag is set, such text will be marked as bold in the resulting text spans. .. py:data:: TEXT_LAZY_VECTORS 1048576 -- Delay vector blocks in the extraction slightly to avoid breaking what would otherwise be continuous lines of text. .. py:data:: TEXT_FUZZY_VECTORS 2097152 -- If this option is set, we 'fuzzily' collect rectangular vectors of the same colour together. This enables us to spot where 'pixels' or 'slices' of vectors are used to create the appearance of characters on the page without exploding the storage and processing time requirements. The following constants represent the default combinations of the above for text extraction and searching: .. py:data:: TEXTFLAGS_TEXT `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_WORDS `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_BLOCKS `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_DICT `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_RAWDICT `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_HTML `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_XHTML `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_XML `TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE` .. py:data:: TEXTFLAGS_SEARCH `TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE` .. _linkDest Kinds: Link Destination Kinds ----------------------- Possible values of :attr:`linkDest.kind` (link destination kind). .. py:data:: LINK_NONE 0 -- No destination. Indicates a dummy link. :type: int .. py:data:: LINK_GOTO 1 -- Points to a place in this document. :type: int .. py:data:: LINK_URI 2 -- Points to a URI -- typically a resource specified with internet syntax. * PyMuPDF treats any external link that contains a colon and does not start with `file:`, as `LINK_URI`. :type: int .. py:data:: LINK_LAUNCH 3 -- Launch (open) another file (of any "executable" type). * |PyMuPDF| treats any external link that starts with `file:` or doesn't contain a colon, as `LINK_LAUNCH`. :type: int .. py:data:: LINK_NAMED 4 -- points to a named location. :type: int .. py:data:: LINK_GOTOR 5 -- Points to a place in another PDF document. :type: int .. _linkDest Flags: Link Destination Flags ------------------------- .. Note:: The rightmost byte of this integer is a bit field, so test the truth of these bits with the *&* operator. .. py:data:: LINK_FLAG_L_VALID 1 (bit 0) Top left x value is valid :type: bool .. py:data:: LINK_FLAG_T_VALID 2 (bit 1) Top left y value is valid :type: bool .. py:data:: LINK_FLAG_R_VALID 4 (bit 2) Bottom right x value is valid :type: bool .. py:data:: LINK_FLAG_B_VALID 8 (bit 3) Bottom right y value is valid :type: bool .. py:data:: LINK_FLAG_FIT_H 16 (bit 4) Horizontal fit :type: bool .. py:data:: LINK_FLAG_FIT_V 32 (bit 5) Vertical fit :type: bool .. py:data:: LINK_FLAG_R_IS_ZOOM 64 (bit 6) Bottom right x is a zoom figure :type: bool Annotation Related Constants ----------------------------- See chapter 8.4.5, pp. 615 of the :ref:`AdobeManual` for details. .. _AnnotationTypes: Annotation Types ~~~~~~~~~~~~~~~~~ These identifiers also cover **links** and **widgets**: the PDF specification technically handles them all in the same way, whereas |MuPDF| (and PyMuPDF) treats them as three basically different types of objects. :: PDF_ANNOT_TEXT 0 PDF_ANNOT_LINK 1 # <=== Link object in PyMuPDF PDF_ANNOT_FREE_TEXT 2 PDF_ANNOT_LINE 3 PDF_ANNOT_SQUARE 4 PDF_ANNOT_CIRCLE 5 PDF_ANNOT_POLYGON 6 PDF_ANNOT_POLY_LINE 7 PDF_ANNOT_HIGHLIGHT 8 PDF_ANNOT_UNDERLINE 9 PDF_ANNOT_SQUIGGLY 10 PDF_ANNOT_STRIKE_OUT 11 PDF_ANNOT_REDACT 12 PDF_ANNOT_STAMP 13 PDF_ANNOT_CARET 14 PDF_ANNOT_INK 15 PDF_ANNOT_POPUP 16 PDF_ANNOT_FILE_ATTACHMENT 17 PDF_ANNOT_SOUND 18 PDF_ANNOT_MOVIE 19 PDF_ANNOT_RICH_MEDIA 20 PDF_ANNOT_WIDGET 21 # <=== Widget object in PyMuPDF PDF_ANNOT_SCREEN 22 PDF_ANNOT_PRINTER_MARK 23 PDF_ANNOT_TRAP_NET 24 PDF_ANNOT_WATERMARK 25 PDF_ANNOT_3D 26 PDF_ANNOT_PROJECTION 27 PDF_ANNOT_UNKNOWN -1 .. _AnnotationFlags: Annotation Flag Bits ~~~~~~~~~~~~~~~~~~~~~ :: PDF_ANNOT_IS_INVISIBLE 1 << (1-1) PDF_ANNOT_IS_HIDDEN 1 << (2-1) PDF_ANNOT_IS_PRINT 1 << (3-1) PDF_ANNOT_IS_NO_ZOOM 1 << (4-1) PDF_ANNOT_IS_NO_ROTATE 1 << (5-1) PDF_ANNOT_IS_NO_VIEW 1 << (6-1) PDF_ANNOT_IS_READ_ONLY 1 << (7-1) PDF_ANNOT_IS_LOCKED 1 << (8-1) PDF_ANNOT_IS_TOGGLE_NO_VIEW 1 << (9-1) PDF_ANNOT_IS_LOCKED_CONTENTS 1 << (10-1) .. _AnnotationLineEnds: Annotation Line Ending Styles ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: PDF_ANNOT_LE_NONE 0 PDF_ANNOT_LE_SQUARE 1 PDF_ANNOT_LE_CIRCLE 2 PDF_ANNOT_LE_DIAMOND 3 PDF_ANNOT_LE_OPEN_ARROW 4 PDF_ANNOT_LE_CLOSED_ARROW 5 PDF_ANNOT_LE_BUTT 6 PDF_ANNOT_LE_R_OPEN_ARROW 7 PDF_ANNOT_LE_R_CLOSED_ARROW 8 PDF_ANNOT_LE_SLASH 9 Widget Constants ----------------- .. _WidgetTypes: Widget Types (*field_type*) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: PDF_WIDGET_TYPE_UNKNOWN 0 PDF_WIDGET_TYPE_BUTTON 1 PDF_WIDGET_TYPE_CHECKBOX 2 PDF_WIDGET_TYPE_COMBOBOX 3 PDF_WIDGET_TYPE_LISTBOX 4 PDF_WIDGET_TYPE_RADIOBUTTON 5 PDF_WIDGET_TYPE_SIGNATURE 6 PDF_WIDGET_TYPE_TEXT 7 Text Widget Subtypes (*text_format*) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: PDF_WIDGET_TX_FORMAT_NONE 0 PDF_WIDGET_TX_FORMAT_NUMBER 1 PDF_WIDGET_TX_FORMAT_SPECIAL 2 PDF_WIDGET_TX_FORMAT_DATE 3 PDF_WIDGET_TX_FORMAT_TIME 4 Widget flags (*field_flags*) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ **Common to all field types**:: PDF_FIELD_IS_READ_ONLY 1 PDF_FIELD_IS_REQUIRED 1 << 1 PDF_FIELD_IS_NO_EXPORT 1 << 2 **Text widgets**:: PDF_TX_FIELD_IS_MULTILINE 1 << 12 PDF_TX_FIELD_IS_PASSWORD 1 << 13 PDF_TX_FIELD_IS_FILE_SELECT 1 << 20 PDF_TX_FIELD_IS_DO_NOT_SPELL_CHECK 1 << 22 PDF_TX_FIELD_IS_DO_NOT_SCROLL 1 << 23 PDF_TX_FIELD_IS_COMB 1 << 24 PDF_TX_FIELD_IS_RICH_TEXT 1 << 25 **Button widgets**:: PDF_BTN_FIELD_IS_NO_TOGGLE_TO_OFF 1 << 14 PDF_BTN_FIELD_IS_RADIO 1 << 15 PDF_BTN_FIELD_IS_PUSHBUTTON 1 << 16 PDF_BTN_FIELD_IS_RADIOS_IN_UNISON 1 << 25 **Choice widgets**:: PDF_CH_FIELD_IS_COMBO 1 << 17 PDF_CH_FIELD_IS_EDIT 1 << 18 PDF_CH_FIELD_IS_SORT 1 << 19 PDF_CH_FIELD_IS_MULTI_SELECT 1 << 21 PDF_CH_FIELD_IS_DO_NOT_SPELL_CHECK 1 << 22 PDF_CH_FIELD_IS_COMMIT_ON_SEL_CHANGE 1 << 26 .. _BlendModes: PDF Standard Blend Modes ---------------------------- For an explanation see :ref:`AdobeManual`, page 324:: 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" .. _StampIcons: Stamp Annotation Icons ---------------------------- MuPDF has defined the following icons for **rubber stamp** annotations:: STAMP_Approved 0 STAMP_AsIs 1 STAMP_Confidential 2 STAMP_Departmental 3 STAMP_Experimental 4 STAMP_Expired 5 STAMP_Final 6 STAMP_ForComment 7 STAMP_ForPublicRelease 8 STAMP_NotApproved 9 STAMP_NotForPublicRelease 10 STAMP_Sold 11 STAMP_TopSecret 12 STAMP_Draft 13 .. include:: footer.rst ================================================ FILE: docs/version.rst ================================================ This documentation covers PyMuPDF |version|. The major and minor versions of PyMuPDF and MuPDF will always be the same. Only the third qualifier (patch level) may deviate from that of MuPDF. Typically PyMuPDF is released more frequently than MuPDF so it will often be the case that the patch level of PyMuPDF will be greater than the embedded MuPDF. For example PyMuPDF-1.24.5 contains MuPDF-1.24.2. Also see `pymupdf_version` and `mupdf_version`. ================================================ FILE: docs/widget.rst ================================================ .. include:: header.rst .. _Widget: ================ Widget ================ |pdf_only_class| This class represents a PDF Form field, also called a "widget". Throughout this documentation, we are using these terms synonymously. Fields technically are a special case of PDF annotations, which allow users with limited permissions to enter information in a PDF. This is primarily used for filling out forms. Like annotations, widgets live on PDF pages. Similar to annotations, the first widget on a page is accessible via :attr:`Page.first_widget` and subsequent widgets can be accessed via the :attr:`Widget.next` property. Like annotations, widgets also lose connection to their page when the page becomes unavailable, please see `here `_ for details. This is relevant especially when updating the widget: this will fail if the original page object is no longer available. *(Changed in version 1.16.0)* MuPDF no longer treats widgets as a subset of general annotations. Consequently, :attr:`Page.first_annot` and :meth:`Annot.next` will deliver **non-widget annotations exclusively**, and be ``None`` if only form fields exist on a page. Vice versa, :attr:`Page.first_widget` and :meth:`Widget.next` will only show widgets. This design decision is purely internal to MuPDF; technically, links, annotations and fields have a lot in common and also continue to share the better part of their code within (Py-) MuPDF. **Class API** .. class:: Widget .. method:: button_states *New in version 1.18.15* Return the names of On / Off (i.e. selected / clicked or not) states a button field may have. While the 'Off' state usually is also named like so, the 'On' state is often given a name relating to the functional context, for example 'Yes', 'Female', etc. This method helps finding out the possible values of :attr:`field_value` in these cases. :returns: a dictionary with the names of 'On' and 'Off' for the *normal* and the *pressed-down* appearance of button widgets. The following example shows that the "selected" value is "Male": >>> print(field.field_name, field.button_states()) Gender Second person {'down': ['Male', 'Off'], 'normal': ['Male', 'Off']} .. method:: on_state * New in version 1.22.2 Return the value of the "ON" state of check boxes and radio buttons. For check boxes this is always the value "Yes". For radio buttons, this is the value to select / activate the button. :returns: the value that sets the button to "selected". For non-checkbox, non-radiobutton fields, always `None` is returned. For check boxes the return is `True`. For radio buttons this is the value "Male" in the following example: >>> print(field.field_name, field.button_states()) Gender Second person {'down': ['Male', 'Off'], 'normal': ['Male', 'Off']} >>> print(field.on_state()) Male So for check boxes and radio buttons, the recommended method to set them to "selected", or to check the state is the following: >>> field.field_value = field.on_state() >>> field.field_value == field.on_state() True .. method:: update(sync_flags=False) After any changes to a widget, this **method must be used** to reflect changes in the PDF [#f1]_. :arg bool sync_flags: if ``True``, the widget's :attr:`Widget.field_flags` are copied to the ``Parent`` object (if present) and all widgets named in its ``Kids`` array. This provides a convenient way to -- for example -- set all instances of the widget to read-only, no matter on which page they may occur [#f2]_. .. method:: reset Reset the field's value to its default -- if defined -- or remove it. Do not forget to issue :meth:`update` afterwards. .. attribute:: next Point to the next form field on the page. The last widget returns ``None``. .. attribute:: border_color A list of up to 4 floats defining the field's border color. Default value is ``None`` which causes border style and border width to be ignored. .. attribute:: border_style A string defining the line style of the field's border. See :attr:`Annot.border`. Default is "s" ("Solid") -- a continuous line. Only the first character (upper or lower case) will be regarded when creating a widget. .. attribute:: border_width A float defining the width of the border line. Default is 1. .. attribute:: border_dashes A list/tuple of integers defining the dash properties of the border line. This is only meaningful if *border_style == "D"* and :attr:`border_color` is provided. .. attribute:: choice_values Python sequence of strings defining the valid choices of list boxes and combo boxes. For these widget types, this property is mandatory and must contain at least two items. Ignored for other types. .. attribute:: field_name A mandatory string defining the field's name. No checking for duplicates takes place. .. attribute:: field_label An optional string containing an "alternate" field name. Typically used for any notes, help on field usage, etc. Default is the field name. .. attribute:: field_value The value of the field. .. attribute:: field_flags An integer defining a large amount of properties of a field. Be careful when changing this attribute as this may change the field type. .. attribute:: field_type A mandatory integer defining the field type. This is a value in the range of 0 to 6. It cannot be changed when updating the widget. .. attribute:: field_type_string A string describing (and derived from) the field type. .. attribute:: fill_color A list of up to 4 floats defining the field's background color. .. attribute:: button_caption The caption string of a button-type field. .. attribute:: is_signed A bool indicating the signing status of a signature field, else ``None``. .. attribute:: rect The rectangle containing the field. .. attribute:: text_color A list of **1, 3 or 4 floats** defining the text color. Default value is black (`[0, 0, 0]`). .. attribute:: text_font A string defining the font to be used. Default and replacement for invalid values is *"Helv"*. For valid font reference names see the table below. .. attribute:: text_fontsize A float defining the text :data:`fontsize`. Default value is zero, which causes PDF viewer software to dynamically choose a size suitable for the annotation's rectangle and text amount. .. attribute:: text_maxlen An integer defining the maximum number of text characters. PDF viewers will (should) not accept a longer text. .. attribute:: text_type An integer defining acceptable text types (e.g. numeric, date, time, etc.). For reference only for the time being -- will be ignored when creating or updating widgets. .. attribute:: xref The PDF :data:`xref` of the widget. .. attribute:: script * New in version 1.16.12 JavaScript text (unicode) for an action associated with the widget, or ``None``. This is the only script action supported for **button type** widgets. .. attribute:: script_stroke * New in version 1.16.12 JavaScript text (unicode) to be performed when the user types a key-stroke into a text field or combo box or modifies the selection in a scrollable list box. This action can check the keystroke for validity and reject or modify it. ``None`` if not present. .. attribute:: script_format * New in version 1.16.12 JavaScript text (unicode) to be performed before the field is formatted to display its current value. This action can modify the field’s value before formatting. ``None`` if not present. .. attribute:: script_change * New in version 1.16.12 JavaScript text (unicode) to be performed when the field’s value is changed. This action can check the new value for validity. ``None`` if not present. .. attribute:: script_calc * New in version 1.16.12 JavaScript text (unicode) to be performed to recalculate the value of this field when that of another field changes. ``None`` if not present. .. attribute:: script_blur * New in version 1.22.6 JavaScript text (unicode) to be performed on losing the focus of this field. ``None`` if not present. .. attribute:: script_focus * New in version 1.22.6 JavaScript text (unicode) to be performed on focusing this field. ``None`` if not present. .. note:: 1. For **adding** or **changing** one of the above scripts, just put the appropriate JavaScript source code in the widget attribute. To **remove** a script, set the respective attribute to ``None``. 2. Button fields only support :attr:`script`. Other script entries will automatically be set to ``None``. 3. It is worthwhile to look at `this `_ manual with lots of information about Adobe's standard scripts for various field types. For example, if you want to add a text field representing a date, you may want to store the following scripts. They will ensure pattern-compatible date formats and display date pickers in supporting viewers:: widget.script_format = 'AFDate_FormatEx("mm/dd/yyyy");' widget.script_stroke = 'AFDate_KeystrokeEx("mm/dd/yyyy");' Standard Fonts for Widgets ---------------------------------- Widgets use their own resources object ``/DR``. A widget resources object must at least contain a ``/Font`` object. Widget fonts are independent from page fonts. We currently support the 14 PDF base fonts using the following fixed reference names, or any name of an already existing field font. When specifying a text font for new or changed widgets, **either** choose one in the first table column (upper and lower case supported), **or** one of the already existing form fonts. In the latter case, spelling must exactly match. To find out already existing field fonts, inspect the list :attr:`Document.FormFonts`. ============= ======================= **Reference** **Base14 Fontname** ============= ======================= CoBI Courier-BoldOblique CoBo Courier-Bold CoIt Courier-Oblique Cour Courier HeBI Helvetica-BoldOblique HeBo Helvetica-Bold HeIt Helvetica-Oblique Helv Helvetica **(default)** Symb Symbol TiBI Times-BoldItalic TiBo Times-Bold TiIt Times-Italic TiRo Times-Roman ZaDb ZapfDingbats ============= ======================= You are generally free to use any font for every widget. However, we recommend using ``ZaDb`` ("ZapfDingbats") and :data:`fontsize` 0 for check boxes: typical viewers will put a correctly sized tickmark in the field's rectangle, when it is clicked. Supported Widget Types ----------------------- PyMuPDF supports the creation and update of many, but not all widget types. * text (`PDF_WIDGET_TYPE_TEXT`) * push button (`PDF_WIDGET_TYPE_BUTTON`) * check box (`PDF_WIDGET_TYPE_CHECKBOX`) * combo box (`PDF_WIDGET_TYPE_COMBOBOX`) * list box (`PDF_WIDGET_TYPE_LISTBOX`) * radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF does not currently support the **creation** of groups of (interconnected) radio buttons, where setting one button automatically unsets the other buttons in the group. The widget object also does not reflect the presence of a button group. However: consistently selecting (or unselecting) a radio button is supported. This includes correctly setting the value maintained in the owning button group. Selecting a radio button may be done by either assigning `True` or `field.on_state()` to the field value. **De-selecting** the button should be done assigning `False`. * signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only** -- no update or creation of signatures. .. rubric:: Footnotes .. [#f1] If you intend to re-access a new or updated field (e.g. for making a pixmap), make sure to reload the page first. Either close and re-open the document, or load another page first, or simply do `page = doc.reload_page(page)`. .. [#f2] Among other purposes, ``Parent`` objects are also used to facilitate multiple occurrences of a field (on the same or on different pages). The ``Kids`` array in this ``Parent`` object contains the cross references of all widgets that are "copies" of the same field. Whenever the field value of any "kid" widget is changed, all the other kids are immediately updated too. This is a very efficient way to handle multiple copies of the same field, e.g. for filling out forms. This simultaneous update only happens for :attr:`Widget.field value`. The new parameter ``sync_flags`` extends this to :attr:`Widget.field_flags`. This cannot be automated in the same way as for the field value to allow for more flexibility. .. include:: footer.rst ================================================ FILE: docs/xml-class.rst ================================================ .. include:: header.rst .. _Xml: ================ Xml ================ .. role:: htmlTag(emphasis) * New in v1.21.0 This represents an HTML or an XML node. It is a helper class intended to access the DOM (Document Object Model) content of a :ref:`Story` object. There is no need to ever directly construct an :ref:`Xml` object: after creating a :ref:`Story`, simply take :attr:`Story.body` -- which is an Xml node -- and use it to navigate your way through the story's DOM. ================================ =========================================================================================== **Method / Attribute** **Description** ================================ =========================================================================================== :meth:`~.add_bullet_list` Add a :htmlTag:`ul` tag - bulleted list, context manager. :meth:`~.add_codeblock` Add a :htmlTag:`pre` tag, context manager. :meth:`~.add_description_list` Add a :htmlTag:`dl` tag, context manager. :meth:`~.add_division` add a :htmlTag:`div` tag (renamed from “section”), context manager. :meth:`~.add_header` Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context manager. :meth:`~.add_horizontal_line` Add a :htmlTag:`hr` tag. :meth:`~.add_image` Add a :htmlTag:`img` tag. :meth:`~.add_link` Add a :htmlTag:`a` tag. :meth:`~.add_number_list` Add a :htmlTag:`ol` tag, context manager. :meth:`~.add_paragraph` Add a :htmlTag:`p` tag. :meth:`~.add_span` Add a :htmlTag:`span` tag, context manager. :meth:`~.add_subscript` Add subscript text(:htmlTag:`sub` tag) - inline element, treated like text. :meth:`~.add_superscript` Add subscript text (:htmlTag:`sup` tag) - inline element, treated like text. :meth:`~.add_code` Add code text (:htmlTag:`code` tag) - inline element, treated like text. :meth:`~.add_var` Add code text (:htmlTag:`code` tag) - inline element, treated like text. :meth:`~.add_samp` Add code text (:htmlTag:`code` tag) - inline element, treated like text. :meth:`~.add_kbd` Add code text (:htmlTag:`code` tag) - inline element, treated like text. :meth:`~.add_text` Add a text string. Line breaks ``\n`` are honored as :htmlTag:`br` tags. :meth:`~.append_child` Append a child node. :meth:`~.clone` Make a copy if this node. :meth:`~.create_element` Make a new node with a given tag name. :meth:`~.create_text_node` Create direct text for the current node. :meth:`~.find` Find a sub-node with given properties. :meth:`~.find_next` Repeat previous "find" with the same criteria. :meth:`~.insert_after` Insert an element after current node. :meth:`~.insert_before` Insert an element before current node. :meth:`~.remove` Remove this node. :meth:`~.set_align` Set the alignment using a CSS style spec. Only works for block-level tags. :meth:`~.set_attribute` Set an arbitrary key to some value (which may be empty). :meth:`~.set_bgcolor` Set the background color. Only works for block-level tags. :meth:`~.set_bold` Set bold on or off or to some string value. :meth:`~.set_color` Set text color. :meth:`~.set_columns` Set the number of columns. Argument may be any valid number or string. :meth:`~.set_font` Set the font-family, e.g. “sans-serif”. :meth:`~.set_fontsize` Set the font size. Either a float or a valid HTML/CSS string. :meth:`~.set_id` Set a :htmlTag:`id`. A check for uniqueness is performed. :meth:`~.set_italic` Set italic on or off or to some string value. :meth:`~.set_leading` Set inter-block text distance (`-mupdf-leading`), only works on block-level nodes. :meth:`~.set_lineheight` Set height of a line. Float like 1.5, which sets to `1.5 * fontsize`. :meth:`~.set_margins` Set the margin(s), float or string with up to 4 values. :meth:`~.set_pagebreak_after` Insert a page break after this node. :meth:`~.set_pagebreak_before` Insert a page break before this node. :meth:`~.set_properties` Set any or all desired properties in one call. :meth:`~.add_style` Set (add) a “style” that is not supported by its own `set_` method. :meth:`~.add_class` Set (add) a “class” attribute. :meth:`~.set_text_indent` Set indentation for first textblock line. Only works for block-level nodes. :attr:`~.tagname` Either the HTML tag name like :htmlTag:`p` or `None` if a text node. :attr:`~.text` Either the node's text or `None` if a tag node. :attr:`~.is_text` Check if the node is a text. :attr:`~.first_child` Contains the first node one level below this one (or `None`). :attr:`~.last_child` Contains the last node one level below this one (or `None`). :attr:`~.next` The next node at the same level (or `None`). :attr:`~.previous` The previous node at the same level. :attr:`~.root` The top node of the DOM, which hence has the tagname :htmlTag:`html`. ================================ =========================================================================================== **Class API** .. class:: Xml .. method:: add_bullet_list Add an :htmlTag:`ul` tag - bulleted list, context manager. See `ul `_. .. method:: add_codeblock Add a :htmlTag:`pre` tag, context manager. See `pre `_. .. method:: add_description_list Add a :htmlTag:`dl` tag, context manager. See `dl `_. .. method:: add_division Add a :htmlTag:`div` tag, context manager. See `div `_. .. method:: add_header(value) Add a header tag (one of :htmlTag:`h1` to :htmlTag:`h6`), context manager. See `headings `_. :arg int value: a value 1 - 6. .. method:: add_horizontal_line Add a :htmlTag:`hr` tag. See `hr `_. .. method:: add_image(name, width=None, height=None) Add an :htmlTag:`img` tag. This causes the inclusion of the named image in the DOM. :arg str name: the filename of the image. This **must be the member name** of some entry of the :ref:`Archive` parameter of the :ref:`Story` constructor. :arg width: if provided, either an absolute (int) value, or a percentage string like "30%". A percentage value refers to the width of the specified `where` rectangle in :meth:`Story.place`. If this value is provided and `height` is omitted, the image will be included keeping its aspect ratio. :arg height: if provided, either an absolute (int) value, or a percentage string like "30%". A percentage value refers to the height of the specified `where` rectangle in :meth:`Story.place`. If this value is provided and `width` is omitted, the image's aspect ratio will be honored. .. method:: add_link(href, text=None) Add an :htmlTag:`a` tag - inline element, treated like text. :arg str href: the URL target. :arg str text: the text to display. If omitted, the `href` text is shown instead. .. method:: add_number_list Add an :htmlTag:`ol` tag, context manager. .. method:: add_paragraph Add a :htmlTag:`p` tag, context manager. .. method:: add_span Add a :htmlTag:`span` tag, context manager. See `span`_ .. method:: add_subscript(text) Add "subscript" text(:htmlTag:`sub` tag) - inline element, treated like text. .. method:: add_superscript(text) Add "superscript" text (:htmlTag:`sup` tag) - inline element, treated like text. .. method:: add_code(text) Add "code" text (:htmlTag:`code` tag) - inline element, treated like text. .. method:: add_var(text) Add "variable" text (:htmlTag:`var` tag) - inline element, treated like text. .. method:: add_samp(text) Add "sample output" text (:htmlTag:`samp` tag) - inline element, treated like text. .. method:: add_kbd(text) Add "keyboard input" text (:htmlTag:`kbd` tag) - inline element, treated like text. .. method:: add_text(text) Add a text string. Line breaks ``\n`` are honored as :htmlTag:`br` tags. .. method:: set_align(value) Set the text alignment. Only works for block-level tags. :arg value: either one of the :ref:`TextAlign` or the `text-align `_ values. .. method:: set_attribute(key, value=None) Set an arbitrary key to some value (which may be empty). :arg str key: the name of the attribute. :arg str value: the (optional) value of the attribute. .. method:: get_attributes() Retrieve all attributes of the current nodes as a dictionary. :returns: a dictionary with the attributes and their values of the node. .. method:: get_attribute_value(key) Get the attribute value of `key`. :arg str key: the name of the attribute. :returns: a string with the value of `key`. .. method:: remove_attribute(key) Remove the attribute `key` from the node. :arg str key: the name of the attribute. .. method:: set_bgcolor(value) Set the background color. Only works for block-level tags. :arg value: either an RGB value like (255, 0, 0) (for "red") or a valid `background-color `_ value. .. method:: set_bold(value) Set bold on or off or to some string value. :arg value: `True`, `False` or a valid `font-weight `_ value. .. method:: set_color(value) Set the color of the text following. :arg value: either an RGB value like (255, 0, 0) (for "red") or a valid `color `_ value. .. method:: set_columns(value) Set the number of columns. :arg value: a valid `columns `_ value. .. note:: Currently ignored - supported in a future MuPDF version. .. method:: set_font(value) Set the font-family. :arg str value: e.g. "sans-serif". .. method:: set_fontsize(value) Set the font size for text following. :arg value: a float or a valid `font-size `_ value. .. method:: set_id(unqid) Set a :htmlTag:`id`. This serves as a unique identification of the node within the DOM. Use it to easily locate the node to inspect or modify it. A check for uniqueness is performed. :arg str unqid: id string of the node. .. method:: set_italic(value) Set italic on or off or to some string value for the text following it. :arg value: `True`, `False` or some valid `font-style `_ value. .. method:: set_leading(value) Set inter-block text distance (`-mupdf-leading`), only works on block-level nodes. :arg float value: the distance in points to the previous block. .. method:: set_lineheight(value) Set height of a line. :arg value: a float like 1.5 (which sets to `1.5 * fontsize`), or some valid `line-height `_ value. .. method:: set_margins(value) Set the margin(s). :arg value: float or string with up to 4 values. See `CSS documentation `_. .. method:: set_pagebreak_after Insert a page break after this node. .. method:: set_pagebreak_before Insert a page break before this node. .. method:: set_properties(align=None, bgcolor=None, bold=None, color=None, columns=None, font=None, fontsize=None, indent=None, italic=None, leading=None, lineheight=None, margins=None, pagebreak_after=False, pagebreak_before=False, unqid=None, cls=None) Set any or all desired properties in one call. The meaning of argument values equal the values of the corresponding `set_` methods. .. note:: The properties set by this method are directly attached to the node, whereas every `set_` method generates a new :htmlTag:`span` below the current node that has the respective property. So to e.g. "globally" set some property for the :htmlTag:`body`, this method must be used. .. method:: add_style(value) Set (add) some style attribute not supported by its own `set_` method. :arg str value: any valid CSS style value. .. method:: add_class(value) Set (add) some "class" attribute. :arg str value: the name of the class. Must have been defined in either the HTML or the CSS source of the DOM. .. method:: set_text_indent(value) Set indentation for the first textblock line. Only works for block-level nodes. :arg value: a valid `text-indent `_ value. Please note that negative values do not work. .. method:: append_child(node) Append a child node. This is a low-level method used by other methods like :meth:`Xml.add_paragraph`. :arg node: the :ref:`Xml` node to append. .. method:: create_text_node(text) Create direct text for the current node. :arg str text: the text to append. :rtype: :ref:`Xml` :returns: the created element. .. method:: create_element(tag) Create a new node with a given tag. This a low-level method used by other methods like :meth:`Xml.add_paragraph`. :arg str tag: the element tag. :rtype: :ref:`Xml` :returns: the created element. To actually bind it to the DOM, use :meth:`Xml.append_child`. .. method:: insert_before(elem) Insert the given element `elem` before this node. :arg elem: some :ref:`Xml` element. .. method:: insert_after(elem) Insert the given element `elem` after this node. :arg elem: some :ref:`Xml` element. .. method:: clone() Make a copy of this node, which then may be appended (using :meth:`Xml.append_child`) or inserted (using one of :meth:`Xml.insert_before`, :meth:`Xml.insert_after`) in this DOM. :returns: the clone (:ref:`Xml`) of the current node. .. method:: remove() Remove this node from the DOM. .. method:: debug() For debugging purposes, print this node's structure in a simplified form. .. method:: find(tag, att, match) Under the current node, find the first node with the given `tag`, attribute `att` and value `match`. :arg str tag: restrict search to this tag. May be `None` for unrestricted searches. :arg str att: check this attribute. May be `None`. :arg str match: the desired attribute value to match. May be `None`. :rtype: :ref:`Xml`. :returns: `None` if nothing found, otherwise the first matching node. .. method:: find_next( tag, att, match) Continue a previous :meth:`Xml.find` (or :meth:`find_next`) with the same values. :rtype: :ref:`Xml`. :returns: `None` if none more found, otherwise the next matching node. .. attribute:: tagname Either the HTML tag name like :htmlTag:`p` or `None` if a text node. .. attribute:: text Either the node's text or `None` if a tag node. .. attribute:: is_text Check if a text node. .. attribute:: first_child Contains the first node one level below this one (or `None`). .. attribute:: last_child Contains the last node one level below this one (or `None`). .. attribute:: next The next node at the same level (or `None`). .. attribute:: previous The previous node at the same level. .. attribute:: root The top node of the DOM, which hence has the tagname :htmlTag:`html`. Setting Text properties ------------------------ In HTML tags can be nested such that innermost text **inherits properties** from the tag enveloping its parent tag. For example `

some bold textthis is bold and italicregular text

`. To achieve the same effect, methods like :meth:`Xml.set_bold` and :meth:`Xml.set_italic` each open a temporary :htmlTag:`span` with the desired property underneath the current node. In addition, these methods return there parent node, so they can be concatenated with each other. Context Manager support ------------------------ The standard way to add nodes to a DOM is this:: body = story.body para = body.add_paragraph() # add a paragraph para.set_bold() # text that follows will be bold para.add_text("some bold text") para.set_italic() # text that follows will additionally be italic para.add_txt("this is bold and italic") para.set_italic(False).set_bold(False) # all following text will be regular para.add_text("regular text") Methods that are flagged as "context managers" can conveniently be used in this way:: body = story.body with body.add_paragraph() as para: para.set_bold().add_text("some bold text") para.set_italic().add_text("this is bold and italic") para.set_italic(False).set_bold(False).add_text("regular text") para.add_text("more regular text") .. include:: footer.rst .. External links: .. _span: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span ================================================ FILE: docs/znames.rst ================================================ .. include:: header.rst .. _Deprecated: ================ Deprecated Names ================ The original naming convention for methods and properties has been "camelCase". Since its creation around 2013, a tremendous increase of functionality has happened in PyMuPDF -- and with it a corresponding increase in classes, methods and properties. In too many cases, this has led to non-intuitive, illogical and ugly names, difficult to memorize or guess. A few versions ago, I therefore decided to shift gears and switch to a "snake_cased" naming standard. This was a major effort, which needed a step-wise approach. I think am done with it now (version 1.18.14). The following list maps deprecated names to their new versions. For example, property `pageCount` became `page_count` in the :ref:`Document` class. There also are less obvious name changes, e.g. method `getPNGdata` was renamed to `tobytes` in the :ref:`Pixmap` class. Names of classes (camel case) and package-wide constants (the majority is upper case) remain untouched. Old names will remain available as deprecated aliases through MuPDF version 1.19.0 and **be removed** in the version that follows it - probably version 1.20.0, but this depends on upstream decisions (MuPDF). Starting with version 1.19.0, we will issue deprecation warnings on `sys.stderr` like `Deprecation: 'newPage' removed from class 'Document' after v1.19.0 - use 'new_page'.` when aliased methods are being used. Using a deprecated property will not cause this type of warning. Starting immediately, all deprecated objects (methods and properties) will show a copy of the original's docstring, **prefixed** with the deprecation message, for example:: >>> print(pymupdf.Document.pageCount.__doc__) *** Deprecated and removed in version following 1.19.0 - use 'page_count'. *** Number of pages. >>> print(pymupdf.Document.newPage.__doc__) *** Deprecated and removed in version following 1.19.0 - use 'new_page'. *** Create and return a new page object. Args: pno: (int) insert before this page. Default: after last page. width: (float) page width in points. Default: 595 (ISO A4 width). height: (float) page height in points. Default 842 (ISO A4 height). Returns: A Page object. There is a utility script `alias-changer.py `_ which can be used to do mass-renames in your scripts. It accepts either a single file or a folder as argument. If a folder is supplied, all its Python files and those of its subfolders are changed. Optionally, backups of the scripts can be taken. .. include:: footer.rst ================================================ FILE: pyproject.toml ================================================ [build-system] requires = ['pipcl'] build-backend = "setup" backend-path = ["."] ================================================ FILE: pytest.ini ================================================ [pytest] python_files = tests/test_*.py addopts = --tb=native ================================================ FILE: scripts/gh_release.py ================================================ #! /usr/bin/env python3 ''' Build+test script for PyMuPDF using cibuildwheel. Mostly for use with github builds. We run cibuild manually, in order to build and test PyMuPDF wheels. As of 2024-10-08 we also support the old two wheel flavours that make up PyMuPDF: PyMuPDFb Not specific to particular versions of Python. Contains shared libraries for the MuPDF C and C++ bindings. PyMuPDF Specific to particular versions of Python. Contains the rest of the PyMuPDF implementation. Args: build Build using cibuildwheel. build-devel Build using cibuild with `--platform` set. pip_install For internal use. Runs `pip install -*.whl`, where `platform_tag` will be things like 'win32', 'win_amd64', 'x86_64`, depending on the python we are running on. venv Run with remaining args inside a venv. test Internal. We also look at specific items in the environment. This allows use with Github action inputs, which can't be easily translated into command-line arguments. inputs_flavours If '0' or unset, build complete PyMuPDF wheels. If '1', build separate PyMuPDF and PyMuPDFb wheels. inputs_sdist inputs_skeleton Build minimal wheel; for testing only. inputs_wheels_cps: Python versions to build for. E.g. 'cp39* cp313*'. inputs_wheels_default Default value for other inputs_wheels_* if unset. inputs_wheels_linux_aarch64 inputs_wheels_linux_auto inputs_wheels_linux_pyodide inputs_wheels_macos_arm64 inputs_wheels_macos_auto inputs_wheels_windows_auto If '1' we build the relevant wheels. inputs_PYMUPDF_SETUP_MUPDF_BUILD Used to directly set PYMUPDF_SETUP_MUPDF_BUILD. E.g. 'git:--recursive --depth 1 --shallow-submodules --branch master https://github.com/ArtifexSoftware/mupdf.git' inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE Used to directly set PYMUPDF_SETUP_MUPDF_BUILD_TYPE. Note that as of 2024-09-10 .github/workflows/build_wheels.yml does not set this. PYMUPDF_SETUP_PY_LIMITED_API If not '0' we build a single wheel for all python versions using the Python Limited API. Building for Pyodide If `inputs_wheels_linux_pyodide` is true and we are on Linux, we build a Pyodide wheel, using scripts/test.py. Set up for use outside Github sudo apt install docker.io sudo usermod -aG docker $USER Example usage: PYMUPDF_SETUP_MUPDF_BUILD=../mupdf py -3.9-32 PyMuPDF/scripts/gh_release.py venv build-devel ''' import glob import inspect import os import platform import re import shlex import subprocess import sys import textwrap import test as test_py pymupdf_dir = os.path.abspath( f'{__file__}/../..') sys.path.insert(0, f'{pymupdf_dir}/src') import pipcl del sys.path[0] log = pipcl.log0 run = pipcl.run def main(): log( '### main():') log(f'{platform.platform()=}') log(f'{platform.python_version()=}') log(f'{platform.architecture()=}') log(f'{platform.machine()=}') log(f'{platform.processor()=}') log(f'{platform.release()=}') log(f'{platform.system()=}') log(f'{platform.version()=}') log(f'{platform.uname()=}') log(f'{sys.executable=}') log(f'{sys.maxsize=}') log(f'sys.argv ({len(sys.argv)}):') for i, arg in enumerate(sys.argv): log(f' {i}: {arg!r}') log(f'os.environ ({len(os.environ)}):') for k in sorted( os.environ.keys()): v = os.environ[ k] log( f' {k}: {v!r}') if test_py.github_workflow_unimportant(): return valgrind = False if len( sys.argv) == 1: args = iter( ['build']) else: args = iter( sys.argv[1:]) while 1: try: arg = next(args) except StopIteration: break if arg == 'build': build(valgrind=valgrind) elif arg == 'build-devel': if platform.system() == 'Linux': p = 'linux' elif platform.system() == 'Windows': p = 'windows' elif platform.system() == 'Darwin': p = 'macos' else: assert 0, f'Unrecognised {platform.system()=}' build(platform_=p) elif arg == 'pip_install': prefix = next(args) d = os.path.dirname(prefix) log( f'{prefix=}') log( f'{d=}') for leaf in os.listdir(d): log( f' {d}/{leaf}') pattern = f'{prefix}-*{platform_tag()}.whl' paths = glob.glob( pattern) log( f'{pattern=} {paths=}') # Follow pipcl.py and look at AUDITWHEEL_PLAT. This allows us to # cope if building for both musl and normal linux. awp = os.environ.get('AUDITWHEEL_PLAT') if awp: paths = [i for i in paths if awp in i] log(f'After selecting AUDITWHEEL_PLAT={awp!r}, {paths=}.') paths = ' '.join( paths) run( f'pip install {paths}') elif arg == 'venv': command = ['python', sys.argv[0]] for arg in args: command.append( arg) venv( command, packages = 'cibuildwheel') elif arg == 'test': project = next(args) package = next(args) test( project, package, valgrind=valgrind) elif arg == '--valgrind': valgrind = int(next(args)) else: assert 0, f'Unrecognised {arg=}' def build( platform_=None, valgrind=False): log( '### build():') platform_arg = f' --platform {platform_}' if platform_ else '' # Parameters are in os.environ, as that seems to be the only way that # Github workflow .yml files can encode them. # def get_bool(name, default=0): v = os.environ.get(name) if v in ('1', 'true'): return 1 elif v in ('0', 'false'): return 0 elif v is None: return default else: assert 0, f'Bad environ {name=} {v=}' inputs_flavours = get_bool('inputs_flavours', 1) inputs_sdist = get_bool('inputs_sdist') inputs_skeleton = os.environ.get('inputs_skeleton') inputs_wheels_default = get_bool('inputs_wheels_default', 1) inputs_wheels_linux_aarch64 = get_bool('inputs_wheels_linux_aarch64', inputs_wheels_default) inputs_wheels_linux_auto = get_bool('inputs_wheels_linux_auto', inputs_wheels_default) inputs_wheels_linux_pyodide = get_bool('inputs_wheels_linux_pyodide', 0) inputs_wheels_macos_arm64 = get_bool('inputs_wheels_macos_arm64', 0) inputs_wheels_macos_auto = get_bool('inputs_wheels_macos_auto', inputs_wheels_default) inputs_wheels_windows_auto = get_bool('inputs_wheels_windows_auto', inputs_wheels_default) inputs_wheels_cps = os.environ.get('inputs_wheels_cps') inputs_PYMUPDF_SETUP_MUPDF_BUILD = os.environ.get('inputs_PYMUPDF_SETUP_MUPDF_BUILD') inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE = os.environ.get('inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE') PYMUPDF_SETUP_PY_LIMITED_API = os.environ.get('PYMUPDF_SETUP_PY_LIMITED_API') log( f'{inputs_flavours=}') log( f'{inputs_sdist=}') log( f'{inputs_skeleton=}') log( f'{inputs_wheels_default=}') log( f'{inputs_wheels_linux_aarch64=}') log( f'{inputs_wheels_linux_auto=}') log( f'{inputs_wheels_linux_pyodide=}') log( f'{inputs_wheels_macos_arm64=}') log( f'{inputs_wheels_macos_auto=}') log( f'{inputs_wheels_windows_auto=}') log( f'{inputs_wheels_cps=}') log( f'{inputs_PYMUPDF_SETUP_MUPDF_BUILD=}') log( f'{inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE=}') log( f'{PYMUPDF_SETUP_PY_LIMITED_API=}') # Build Pyodide wheel if specified. # if platform.system() == 'Linux' and inputs_wheels_linux_pyodide: # Pyodide wheels are built by running scripts/test.py, not # cibuildwheel. command = f'{sys.executable} scripts/test.py -P 1' if inputs_PYMUPDF_SETUP_MUPDF_BUILD: command += f' -m {shlex.quote(inputs_PYMUPDF_SETUP_MUPDF_BUILD)}' command += ' pyodide_wheel' run(command) # Build sdist(s). # if inputs_sdist: if pymupdf_dir != os.path.abspath( os.getcwd()): log( f'Changing dir to {pymupdf_dir=}') os.chdir( pymupdf_dir) # Create PyMuPDF sdist. run(f'{sys.executable} setup.py sdist') assert glob.glob('dist/pymupdf-*.tar.gz') if inputs_flavours: # Create PyMuPDFb sdist. run( f'{sys.executable} setup.py sdist', env_extra=dict(PYMUPDF_SETUP_FLAVOUR='b'), ) assert glob.glob('dist/pymupdfb-*.tar.gz') # Build wheels. # if (0 or inputs_wheels_linux_aarch64 or inputs_wheels_linux_auto or inputs_wheels_macos_arm64 or inputs_wheels_macos_auto or inputs_wheels_windows_auto ): env_extra = dict() def set_if_unset(name, value): v = os.environ.get(name) if v is None: log( f'Setting environment {name=} to {value=}') env_extra[ name] = value else: log( f'Not changing {name}={v!r} to {value!r}') set_if_unset( 'CIBW_BUILD_VERBOSITY', '1') # We exclude pp* because of `fitz_wrap.obj : error LNK2001: unresolved # external symbol PyUnicode_DecodeRawUnicodeEscape`. # 2024-06-05: musllinux on aarch64 fails because libclang cannot find # libclang.so. # # Note that we had to disable cp313-win32 when 3.13 was experimental # because there was no 64-bit Python-3.13 available via `py # -3.13`. (Win32 builds need to use win64 Python because win32 # libclang is broken.) # set_if_unset( 'CIBW_SKIP', 'pp* *i686 cp36* cp37* *musllinux*aarch64*') def make_string(*items): ret = list() for item in items: if item: ret.append(item) return ' '.join(ret) cps = inputs_wheels_cps if inputs_wheels_cps else 'cp39* cp310* cp311* cp312* cp313*' set_if_unset( 'CIBW_BUILD', cps) for cp in cps.split(): m = re.match('cp([0-9]+)[*]', cp) assert m, f'{cps=} {cp=}' v = int(m.group(1)) if v == 314: # Need to set CIBW_PRERELEASE_PYTHONS, otherwise cibuildwheel # will refuse. log(f'Setting CIBW_PRERELEASE_PYTHONS for Python version {cp=}.') set_if_unset( 'CIBW_PRERELEASE_PYTHONS', '1') if platform.system() == 'Linux': set_if_unset( 'CIBW_ARCHS_LINUX', make_string( 'auto64' * inputs_wheels_linux_auto, 'aarch64' * inputs_wheels_linux_aarch64, ), ) if env_extra.get('CIBW_ARCHS_LINUX') == '': log(f'Not running cibuildwheel because CIBW_ARCHS_LINUX is empty string.') return if platform.system() == 'Windows': set_if_unset( 'CIBW_ARCHS_WINDOWS', make_string( 'auto' * inputs_wheels_windows_auto, ), ) if env_extra.get('CIBW_ARCHS_WINDOWS') == '': log(f'Not running cibuildwheel because CIBW_ARCHS_WINDOWS is empty string.') return if platform.system() == 'Darwin': set_if_unset( 'CIBW_ARCHS_MACOS', make_string( 'auto' * inputs_wheels_macos_auto, 'arm64' * inputs_wheels_macos_arm64, ), ) if env_extra.get('CIBW_ARCHS_MACOS') == '': log(f'Not running cibuildwheel because CIBW_ARCHS_MACOS is empty string.') return def env_pass(name): ''' Adds `name` to CIBW_ENVIRONMENT_PASS_LINUX if required to be available when building wheel with cibuildwheel. ''' if platform.system() == 'Linux': v = env_extra.get('CIBW_ENVIRONMENT_PASS_LINUX', '') if v: v += ' ' v += name env_extra['CIBW_ENVIRONMENT_PASS_LINUX'] = v def env_set(name, value, pass_=False): assert isinstance( value, str) if not name.startswith('CIBW'): assert pass_, f'Non-CIBW* name requires `pass_` to be true. {name=} {value=}.' env_extra[ name] = value if pass_: env_pass(name) env_pass('PYMUPDF_SETUP_PY_LIMITED_API') if os.environ.get('PYMUPDF_SETUP_LIBCLANG'): env_pass('PYMUPDF_SETUP_LIBCLANG') if inputs_skeleton: env_set('PYMUPDF_SETUP_SKELETON', inputs_skeleton, pass_=1) if inputs_PYMUPDF_SETUP_MUPDF_BUILD not in ('-', None): log(f'Setting PYMUPDF_SETUP_MUPDF_BUILD to {inputs_PYMUPDF_SETUP_MUPDF_BUILD!r}.') env_set('PYMUPDF_SETUP_MUPDF_BUILD', inputs_PYMUPDF_SETUP_MUPDF_BUILD, pass_=True) env_set('PYMUPDF_SETUP_MUPDF_TGZ', '', pass_=True) # Don't put mupdf in sdist. if inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE not in ('-', None): log(f'Setting PYMUPDF_SETUP_MUPDF_BUILD_TYPE to {inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE!r}.') env_set('PYMUPDF_SETUP_MUPDF_BUILD_TYPE', inputs_PYMUPDF_SETUP_MUPDF_BUILD_TYPE, pass_=True) def set_cibuild_test(): log( f'set_cibuild_test(): {inputs_skeleton=}') valgrind_text = '' if valgrind: valgrind_text = ' --valgrind 1' env_set('CIBW_TEST_COMMAND', f'python {{project}}/scripts/gh_release.py{valgrind_text} test {{project}} {{package}}') if pymupdf_dir != os.path.abspath( os.getcwd()): log( f'Changing dir to {pymupdf_dir=}') os.chdir( pymupdf_dir) run('pip install cibuildwheel') # We include MuPDF build-time files. flavour_d = True if PYMUPDF_SETUP_PY_LIMITED_API != '0': # Build one wheel with oldest python, then fake build with other python # versions so we test everything. log(f'{PYMUPDF_SETUP_PY_LIMITED_API=}') env_pass('PYMUPDF_SETUP_PY_LIMITED_API') CIBW_BUILD_old = env_extra.get('CIBW_BUILD') assert CIBW_BUILD_old is not None cp = cps.split()[0] env_set('CIBW_BUILD', cp) log(f'Building single wheel.') run( f'cibuildwheel{platform_arg}', env_extra=env_extra) # Fake-build with all python versions, using the wheel we have # just created. This works by setting PYMUPDF_SETUP_URL_WHEEL # which makes PyMuPDF's setup.py copy an existing wheel instead # of building a wheel itself; it also copes with existing # wheels having extra platform tags (from cibuildwheel's use of # auditwheel). # env_set('PYMUPDF_SETUP_URL_WHEEL', f'file://wheelhouse/', pass_=True) set_cibuild_test() env_set('CIBW_BUILD', CIBW_BUILD_old) # Disable cibuildwheels use of auditwheel. The wheel was repaired # when it was created above so we don't need to do so again. This # also avoids problems with musl wheels on a Linux glibc host where # auditwheel fails with: `ValueError: Cannot repair wheel, because # required library "libgcc_s-a3a07607.so.1" could not be located`. # env_set('CIBW_REPAIR_WHEEL_COMMAND', '') if platform.system() == 'Linux' and env_extra.get('CIBW_ARCHS_LINUX') == 'aarch64': log(f'Testing all Python versions on linux-aarch64 is too slow and is killed by github after 6h.') log(f'Testing on restricted python versions using wheels in wheelhouse/.') # Testing only on first and last python versions. cp1 = cps.split()[0] cp2 = cps.split()[-1] cp = cp1 if cp1 == cp2 else f'{cp1} {cp2}' env_set('CIBW_BUILD', cp) else: log(f'Testing on all python versions using wheels in wheelhouse/.') run( f'cibuildwheel{platform_arg}', env_extra=env_extra) elif inputs_flavours: # Build and test PyMuPDF and PyMuPDFb wheels. # # First build PyMuPDFb wheel. cibuildwheel will build a single wheel # here, which will work with any python version on current OS. # flavour = 'b' if flavour_d: # Include MuPDF build-time files. flavour += 'd' env_set( 'PYMUPDF_SETUP_FLAVOUR', flavour, pass_=1) run( f'cibuildwheel{platform_arg}', env_extra=env_extra) run( 'echo after {flavour=}') run( 'ls -l wheelhouse') # Now set environment to build PyMuPDF wheels. cibuildwheel will build # one for each Python version. # # Tell cibuildwheel not to use `auditwheel`, because it cannot cope # with us deliberately putting required libraries into a different # wheel. # # Also, `auditwheel addtag` says `No tags to be added` and terminates # with non-zero. See: https://github.com/pypa/auditwheel/issues/439. # env_set('CIBW_REPAIR_WHEEL_COMMAND_LINUX', '') env_set('CIBW_REPAIR_WHEEL_COMMAND_MACOS', '') # We tell cibuildwheel to test these wheels, but also set # CIBW_BEFORE_TEST to make it first run ourselves with the # `pip_install` arg to install the PyMuPDFb wheel. Otherwise # installation of PyMuPDF would fail because it lists the # PyMuPDFb wheel as a prerequisite. We need to use `pip_install` # because wildcards do not work on Windows, and we want to be # careful to avoid incompatible wheels, e.g. 32 vs 64-bit wheels # coexist during Windows builds. # env_set('CIBW_BEFORE_TEST', f'python scripts/gh_release.py pip_install wheelhouse/pymupdfb') set_cibuild_test() # Build main PyMuPDF wheel. flavour = 'p' env_set( 'PYMUPDF_SETUP_FLAVOUR', flavour, pass_=1) run( f'cibuildwheel{platform_arg}', env_extra=env_extra) else: # Build and test wheels which contain everything. # flavour = 'pb' if flavour_d: flavour += 'd' set_cibuild_test() env_set( 'PYMUPDF_SETUP_FLAVOUR', flavour, pass_=1) run( f'cibuildwheel{platform_arg}', env_extra=env_extra) run( 'ls -lt wheelhouse') def cpu_bits(): return 32 if sys.maxsize == 2**31 - 1 else 64 # Name of venv used by `venv()`. # venv_name = f'venv-pymupdf-{platform.python_version()}-{cpu_bits()}' def venv( command=None, packages=None, quick=False, system_site_packages=False): ''' Runs remaining args, or the specified command if present, in a venv. command: Command as string or list of args. Should usually start with 'python' to run the venv's python. packages: List of packages (or comma-separated string) to install. quick: If true and venv directory already exists, we don't recreate venv or install Python packages in it. ''' command2 = '' if platform.system() == 'OpenBSD': # libclang not available from pypi.org, but system py3-llvm package # works. `pip install` should be run with --no-build-isolation and # explicit `pip install swig psutil`. system_site_packages = True #ssp = ' --system-site-packages' log(f'OpenBSD: libclang not available from pypi.org.') log(f'OpenBSD: system package `py3-llvm` must be installed.') log(f'OpenBSD: creating venv with --system-site-packages.') log(f'OpenBSD: `pip install .../PyMuPDF` must be preceded by install of swig etc.') ssp = ' --system-site-packages' if system_site_packages else '' if quick and os.path.isdir(venv_name): log(f'{quick=}: Not creating venv because directory already exists: {venv_name}') command2 += 'true' else: quick = False command2 += f'{sys.executable} -m venv{ssp} {venv_name}' if platform.system() == 'Windows': command2 += f' && {venv_name}\\Scripts\\activate' else: command2 += f' && . {venv_name}/bin/activate' if quick: log(f'{quick=}: Not upgrading pip or installing packages.') else: command2 += ' && python -m pip install --upgrade pip' if packages: if isinstance(packages, str): packages = packages.split(',') command2 += ' && pip install ' + ' '.join(packages) command2 += ' &&' if isinstance( command, str): command2 += ' ' + command else: for arg in command: command2 += ' ' + shlex.quote(arg) run( command2) def test( project, package, valgrind): run(f'pip install {test_packages}') if valgrind: log('Installing valgrind.') run(f'sudo apt update') run(f'sudo apt install valgrind') run(f'valgrind --version') log('Running PyMuPDF tests under valgrind.') # We ignore memory leaks. run( f'{sys.executable} {project}/tests/run_compound.py' f' valgrind --suppressions={project}/valgrind.supp --error-exitcode=100 --errors-for-leak-kinds=none --fullpath-after=' f' pytest {project}/tests' , env_extra=dict( PYTHONMALLOC='malloc', PYMUPDF_RUNNING_ON_VALGRIND='1', ), ) else: run(f'{sys.executable} {project}/tests/run_compound.py pytest {project}/tests') if platform.system() == 'Windows': def relpath(path, start=None): try: return os.path.relpath(path, start) except ValueError: # os.path.relpath() fails if trying to change drives. return os.path.abspath(path) else: def relpath(path, start=None): return os.path.relpath(path, start) def platform_tag(): bits = cpu_bits() if platform.system() == 'Windows': return 'win32' if bits==32 else 'win_amd64' elif platform.system() in ('Linux', 'Darwin'): assert bits == 64 return platform.machine() #return 'x86_64' else: assert 0, f'Unrecognised: {platform.system()=}' test_packages = 'pytest fontTools pymupdf-fonts flake8 pylint codespell' if platform.system() == 'Windows' and cpu_bits() == 32: # No pillow wheel available, and doesn't build easily. pass else: test_packages += ' pillow' if platform.system().startswith('MSYS_NT-'): # psutil not available on msys2. pass else: test_packages += ' psutil' if __name__ == '__main__': main() ================================================ FILE: scripts/sysinstall.py ================================================ #! /usr/bin/env python3 ''' Test for Linux system install of MuPDF and PyMuPDF. We build and install MuPDF and PyMuPDF into a root directory, then use scripts/test.py to run PyMuPDF's pytest tests with LD_PRELOAD_PATH and PYTHONPATH set. PyMuPDF itself is installed using `python -m install` with a wheel created with `pip wheel`. We run install commands with `sudo` if `--root /` is used. Note that we run some commands with sudo; it's important that these use the same python as non-sudo, otherwise things can be build and installed for different python versions. For example when we are run from a github action, it should not do `- uses: actions/setup-python@v5` but instead use whatever system python is already defined. Args: --gdb 0|1 --mupdf-dir Path of MuPDF checkout; default is 'mupdf'. --mupdf-do 0|1 Whether to build and install mupdf. --mupdf-git Get or update `mupdf_dir` using git. If `mupdf_dir` already exists we run `git pull` in it; otherwise we run `git clone` with ` `. For example: --mupdf-git "--branch master https://github.com/ArtifexSoftware/mupdf.git" --mupdf-so-mode Used with `install -m ...` when installing MuPDF. For example `--mupdf-so-mode 744`. --packages 0|1 If 1 (the default) we install required system packages such as `libfreetype-dev`. --pip 0|venv|sudo Whether/how to install Python packages. If '0' we assume required packages are already available. If 'sudo' we install required Python packages using `sudo pip install ...`. If 'venv' (the default) we install Python packages and run installer and test commands inside venv's. --prefix: Directory within `root`; default is `/usr/local`. Must start with `/`. --pymupdf-dir Path of PyMuPDF checkout; default is 'PyMuPDF'. --pymupdf-do 0|1 Whether to build and install pymupdf. --root Root of install directory; default is 'pymupdf-sysinstall-test-root'. --tesseract5 0|1 If 1 (the default), we force installation of libtesseract-dev version 5 (which is not available as a default package in Ubuntu-22.04) from package repository ppa:alex-p/tesseract-ocr-devel. --test-venv Set the name of the venv in which we run tests (only with `--pip venv`); the default is a hard-coded venv name. The venv will be created, and required packages installed using `pip`. --use-installer 0|1 If 1 (the default), we use `python -m installer` to install PyMuPDF from a generated wheel. [Otherwise we use `pip install`, which refuses to do a system install with `--root /`, referencing PEP-668.] -i Passed through to scripts/test.py. Default is 'rR'. -f Passed through to scripts/test.py. Default is '1'. -p Passed through to scripts/test.py. -t Passed through to scripts/test.py. To only show what commands would be run, but not actually run them, specify `-m 0 -p 0 -t 0`. ''' import glob import multiprocessing import os import platform import shlex import subprocess import sys import sysconfig import test as test_py pymupdf_dir = os.path.abspath( f'{__file__}/../..') sys.path.insert(0, f'{pymupdf_dir}/src') import pipcl del sys.path[0] log = pipcl.log0 # Requirements for a system build and install: # # system packages (Debian names): # g_sys_packages = [ 'libfreetype-dev', 'libgumbo-dev', 'libharfbuzz-dev', 'libjbig2dec-dev', 'libjpeg-dev', 'libleptonica-dev', 'libopenjp2-7-dev', ] # We also need libtesseract-dev version 5. # def main(): if 1: log(f'## {__file__}: Starting.') log(f'{sys.executable=}') log(f'{platform.python_version()=}') log(f'{__file__=}') log(f'{os.environ.get("PYMUDF_SCRIPTS_SYSINSTALL_ARGS_PRE")=}') log(f'{os.environ.get("PYMUDF_SCRIPTS_SYSINSTALL_ARGS_POST")=}') log(f'{sys.argv=}') log(f'{sysconfig.get_path("platlib")=}') run_command(f'python -V', check=0) run_command(f'python3 -V', check=0) run_command(f'sudo python -V', check=0) run_command(f'sudo python3 -V', check=0) run_command(f'sudo PATH={os.environ["PATH"]} python -V', check=0) run_command(f'sudo PATH={os.environ["PATH"]} python3 -V', check=0) if test_py.github_workflow_unimportant(): return # Set default behaviour. # gdb = False use_installer = True mupdf_do = True mupdf_dir = 'mupdf' mupdf_git = None mupdf_so_mode = None packages = True prefix = '/usr/local' pymupdf_do = True root = 'pymupdf-sysinstall-test-root' tesseract5 = True pytest_args = None pytest_do = True pytest_name = None test_venv = 'venv-pymupdf-sysinstall-test' pip = 'venv' test_fitz = '1' test_implementations = 'rR' # Parse command-line. # env_args_pre = shlex.split(os.environ.get('PYMUDF_SCRIPTS_SYSINSTALL_ARGS_PRE', '')) env_args_post = shlex.split(os.environ.get('PYMUDF_SCRIPTS_SYSINSTALL_ARGS_POST', '')) args = iter(env_args_pre + sys.argv[1:] + env_args_post) while 1: try: arg = next(args) except StopIteration: break if arg in ('-h', '--help'): log(__doc__) return elif arg == '--gdb': gdb = int(next(args)) elif arg == '--mupdf-do': mupdf_do = int(next(args)) elif arg == '--mupdf-dir': mupdf_dir = next(args) elif arg == '--mupdf-git': mupdf_git = next(args) elif arg == '--mupdf-so-mode': mupdf_so_mode = next(args) elif arg == '--packages': packages = int(next(args)) elif arg == '--prefix': prefix = next(args) elif arg == '--pymupdf-do': pymupdf_do = int(next(args)) elif arg == '--root': root = next(args) elif arg == '--tesseract5': tesseract5 = int(next(args)) elif arg == '--pytest-do': pytest_do = int(next(args)) elif arg == '--test-venv': test_venv = next(args) elif arg == '--use-installer': use_installer = int(next(args)) elif arg == '--pip': pip = next(args) elif arg == '-f': test_fitz = next(args) elif arg == '-i': test_implementations = next(args) elif arg == '-p': pytest_args = next(args) elif arg == '-t': pytest_name = next(args) else: assert 0, f'Unrecognised arg: {arg!r}' assert prefix.startswith('/') pip_values = ('0', 'sudo', 'venv') assert pip in pip_values, f'Unrecognised --pip value {pip!r} should be one of: {pip_values!r}' root = os.path.abspath(root) root_prefix = f'{root}{prefix}'.replace('//', '/') sudo = '' if root == '/': sudo = f'sudo PATH={os.environ["PATH"]} ' def run(command, env_extra=None): return run_command(command, doit=mupdf_do, env_extra=env_extra) # Get MuPDF from git if specified. # if mupdf_git: # Update existing checkout or do `git clone`. if os.path.exists(mupdf_dir): log(f'## Update MuPDF checkout {mupdf_dir}.') run(f'cd {mupdf_dir} && git pull && git submodule update --init') else: # No existing git checkout, so do a fresh clone. log(f'## Clone MuPDF into {mupdf_dir}.') run(f'git clone --recursive --depth 1 --shallow-submodules {mupdf_git} {mupdf_dir}') if packages: # Install required system packages. We assume a Debian package system. # log('## Install system packages required by MuPDF.') run(f'sudo apt update') run(f'sudo apt install {" ".join(g_sys_packages)}') # Ubuntu-22.04 has freeglut3-dev, not libglut-dev. run(f'sudo apt install libglut-dev | sudo apt install freeglut3-dev') if tesseract5: log(f'## Force installation of libtesseract-dev version 5.') # https://stackoverflow.com/questions/76834972/how-can-i-run-pytesseract-python-library-in-ubuntu-22-04 # run('sudo apt install -y software-properties-common') run('sudo add-apt-repository ppa:alex-p/tesseract-ocr-devel') run('sudo apt update') run('sudo apt install -y libtesseract-dev') else: run('sudo apt install libtesseract-dev') # Build+install MuPDF. We use mupd:Makefile's install-shared-python target. # if pip == 'sudo': log('## Installing Python packages required for building MuPDF and PyMuPDF.') #run(f'sudo pip install --upgrade pip') # Breaks on Github see: https://github.com/pypa/get-pip/issues/226. # We need to install psutil and pillow as system packages, otherwise things like `import psutil` # fail, seemingly because of pip warning: # # WARNING: Running pip as the 'root' user can result in broken # permissions and conflicting behaviour with the system package # manager. It is recommended to use a virtual environment instead: # https://pip.pypa.io/warnings/venv # names = test_py.wrap_get_requires_for_build_wheel(f'{__file__}/../..') names = names.split(' ') names = [n for n in names if n not in ('psutil', 'pillow')] names = ' '.join(names) run(f'sudo pip install {names}') run(f'sudo apt install python3-psutil python3-pillow') log('## Build and install MuPDF.') command = f'cd {mupdf_dir}' command += f' && {sudo}make' command += f' -j {multiprocessing.cpu_count()}' #command += f' EXE_LDFLAGS=-Wl,--trace' # Makes linker generate diagnostics as it runs. command += f' DESTDIR={root}' command += f' HAVE_LEPTONICA=yes' command += f' HAVE_TESSERACT=yes' command += f' USE_SYSTEM_LIBS=yes' # We need latest zxingcpp so system version not ok. command += f' USE_SYSTEM_ZXINGCPP=no' command += f' barcode=yes' command += f' VENV_FLAG={"--venv" if pip == "venv" else ""}' if mupdf_so_mode: command += f' SO_INSTALL_MODE={mupdf_so_mode}' command += f' build_prefix=system-libs-' command += f' prefix={prefix}' command += f' verbose=yes' command += f' install-shared-python' command += f' INSTALL_MODE=755' run( command) # Build+install PyMuPDF. # log('## Build and install PyMuPDF.') def run(command): return run_command(command, doit=pymupdf_do) flags_freetype2 = run_command('pkg-config --cflags freetype2', capture=1) compile_flags = f'-I {root_prefix}/include {flags_freetype2}' link_flags = f'-L {root_prefix}/lib' env = '' env += f'CFLAGS="{compile_flags}" ' env += f'CXXFLAGS="{compile_flags}" ' env += f'LDFLAGS="-L {root}/{prefix}/lib" ' env += f'PYMUPDF_SETUP_MUPDF_BUILD= ' # Use system MuPDF. if use_installer: log(f'## Building wheel.') if pip == 'venv': venv_name = 'venv-pymupdf-sysinstall' run(f'pwd') run(f'rm dist/* || true') if pip == 'venv': run(f'{sys.executable} -m venv {venv_name}') run(f'. {venv_name}/bin/activate && pip install --upgrade pip') run(f'. {venv_name}/bin/activate && pip install --upgrade installer') run(f'{env} {venv_name}/bin/python -m pip wheel -vv -w dist {os.path.abspath(pymupdf_dir)}') elif pip == 'sudo': #run(f'sudo pip install --upgrade pip') # Breaks on Github see: https://github.com/pypa/get-pip/issues/226. run(f'sudo pip install installer') run(f'{env} pip wheel -vv -w dist {os.path.abspath(pymupdf_dir)}') else: log(f'Not installing "installer" because {pip=}.') wheel = glob.glob(f'dist/*') assert len(wheel) == 1, f'{wheel=}' wheel = wheel[0] log(f'## Installing wheel using `installer`.') pv = '.'.join(platform.python_version_tuple()[:2]) p = f'{root_prefix}/lib/python{pv}' # `python -m installer` fails to overwrite existing files. run(f'{sudo}rm -r {p}/site-packages/pymupdf || true') run(f'{sudo}rm -r {p}/site-packages/pymupdf.py || true') run(f'{sudo}rm -r {p}/site-packages/fitz || true') run(f'{sudo}rm -r {p}/site-packages/fitz.py || true') run(f'{sudo}rm -r {p}/site-packages/pymupdf-*.dist-info || true') run(f'{sudo}rm -r {root_prefix}/bin/pymupdf || true') if pip == 'venv': run(f'{sudo}{venv_name}/bin/python -m installer --destdir {root} --prefix {prefix} {wheel}') else: run(f'{sudo}{sys.executable} -m installer --destdir {root} --prefix {prefix} {wheel}') # It seems that MuPDF Python bindings are installed into # `.../dist-packages` (from mupdf:Mafile's call of `$(shell python3 # -c "import sysconfig; print(sysconfig.get_path('platlib'))")` while # `python -m installer` installs PyMuPDF into `.../site-packages`. # # This might be because `sysconfig.get_path('platlib')` returns # `.../site-packages` if run in a venv, otherwise `.../dist-packages`. # # And on github ubuntu-latest, sysconfig.get_path("platlib") is # /opt/hostedtoolcache/Python/3.11.7/x64/lib/python3.11/site-packages # # So we set pythonpath (used later) to import from all # `pythonX.Y/site-packages/` and `pythonX.Y/dist-packages` directories # within `root_prefix`: # pv = platform.python_version().split('.') pv = f'python{pv[0]}.{pv[1]}' pythonpath = list() for dirpath, dirnames, filenames in os.walk(root_prefix): if os.path.basename(dirpath) == pv: for leaf in 'site-packages', 'dist-packages': if leaf in dirnames: pythonpath.append(os.path.join(dirpath, leaf)) pythonpath = ':'.join(pythonpath) log(f'{pythonpath=}') else: command = f'{env} pip install -vv --root {root} {os.path.abspath(pymupdf_dir)}' run( command) pythonpath = pipcl.install_dir(root) # Show contents of installation directory. This is very slow on github, # where /usr/local contains lots of things. #run(f'find {root_prefix}|sort') # Run pytest tests. # log('## Run PyMuPDF pytest tests.') def run(command, env_extra=None): return run_command(command, doit=pytest_do, env_extra=env_extra, caller=1) import gh_release if pip == 'venv': # Create venv. run(f'{sys.executable} -m venv {test_venv}') # Install required packages. command = f'. {test_venv}/bin/activate' command += f' && pip install --upgrade pip' command += f' && pip install --upgrade {gh_release.test_packages}' run(command) elif pip == 'sudo': names = gh_release.test_packages names = names.split(' ') names = [n for n in names if n not in ('psutil', 'pillow')] names = ' '.join(names) run(f'sudo pip install --upgrade {names}') else: log(f'Not installing packages for testing because {pip=}.') # Run pytest. # # We need to set PYTHONPATH and LD_LIBRARY_PATH. In particular we # use pipcl.install_dir() to find where pipcl will have installed # PyMuPDF. command = '' if pip == 'venv': command += f'. {test_venv}/bin/activate &&' command += f' LD_LIBRARY_PATH={root_prefix}/lib PYTHONPATH={pythonpath} PATH=$PATH:{root_prefix}/bin' run(f'ls -l {root_prefix}/bin/') # 2024-03-20: Not sure whether/where `pymupdf` binary is installed, so we # disable the test_cli* tests. command += f' {pymupdf_dir}/scripts/test.py' if gdb: command += ' --gdb 1' command += f' -v 0' if pytest_name is None: excluded_tests = ( 'test_color_count', 'test_3050', 'test_cli', 'test_cli_out', 'test_pylint', 'test_textbox3', 'test_3493', 'test_4180', 'test_4767', ) excluded_tests = ' and not '.join(excluded_tests) if not pytest_args: pytest_args = '' pytest_args += f' -k \'not {excluded_tests}\'' else: command += f' -t {pytest_name}' if test_fitz: command += f' -f {test_fitz}' if test_implementations: command += f' -i {test_implementations}' if pytest_args: command += f' -p {shlex.quote(pytest_args)}' if pytest_do: command += ' test' run(command, env_extra=dict(PYMUPDF_SYSINSTALL_TEST='1')) def run_command(command, capture=False, check=True, doit=True, env_extra=None, caller=0): if doit: return pipcl.run(command, capture=capture, check=check, caller=caller+2, env_extra=env_extra) else: log(f'## Would have run: {command}', caller=2) if __name__ == '__main__': main() ================================================ FILE: scripts/test.py ================================================ #! /usr/bin/env python3 '''Developer build/test script for PyMuPDF. Examples: ./PyMuPDF/scripts/test.py -m mupdf build test Build and test with pre-existing local mupdf/ checkout. ./PyMuPDF/scripts/test.py build test Build and test with default internal download of mupdf. ./PyMuPDF/scripts/test.py -m 'git:https://git.ghostscript.com/mupdf.git' build test Build and test with internal checkout of MuPDF master. ./PyMuPDF/scripts/test.py -m ':1.27.x' build test Build and test using internal checkout of mupdf 1.27.x branch from Github. ./PyMuPDF/scripts/test.py install test -i 1.26.3 -k test_2596 Install pymupdf-1.26.3 from pupi.org and test only test_2596. Usage: * Command line arguments are called parameters if they start with `-`, otherwise they are called commands. * Parameters are evaluated first in the order that they were specified. * Then commands are run in the order in which they were specified. * Usually command `test` would be specified after a `build`, `install` or `wheel` command. * Parameters and commands can be interleaved but it may be clearer to separate them on the command line. Other: * If we are not already running inside a Python venv, we automatically create a venv and re-run ourselves inside it (also see the -v option). * Build/wheel/install commands always install into the venv. * Tests use whatever PyMuPDF/MuPDF is currently installed in the venv. * We run tests with pytest. * One can generate call traces by setting environment variables in debug builds. For details see: https://mupdf.readthedocs.io/en/latest/language-bindings.html#environmental-variables Command line args: -a Read next space-separated argument(s) from environmental variable . * Does nothing if is unset. * Useful when running via Github action. -b Set build type for `build` commands. `` should be one of 'release', 'debug', 'memento'. [This makes `build` set environment variable `PYMUPDF_SETUP_MUPDF_BUILD_TYPE`, which is used by PyMuPDF's `setup.py`.] --build-flavour [Obsolete.] Combination of 'p', 'b', 'd'. See ../setup.py's description of PYMUPDF_SETUP_FLAVOUR. Default is 'pbd', i.e. self-contained PyMuPDF wheels including MuPDF build-time files. --build-isolation 0|1 If true (the default on non-OpenBSD systems), we let pip create and use its own new venv to build PyMuPDF. Otherwise we force pip to use the current venv. --cibw-archs-linux Set CIBW_ARCHS_LINUX, e.g. to `auto64 aarch64`. Default is `auto64` so this allows control over whether to build linux-aarch64 wheels. --cibw-name Name to use when installing cibuildwheel, e.g.: --cibw-name cibuildwheel==3.0.0b1 --cibw-name git+https://github.com/pypa/cibuildwheel Default is `cibuildwheel`, i.e. the current release. --cibw-pyodide 0|1 Experimental, make `cibw` command build a pyodide wheel. 2025-05-27: this fails when building mupdf C API - `ld -r -b binary ...` fails with: emcc: error: binary: No such file or directory ("binary" was expected to be an input file, based on the commandline arguments provided) --cibw-pyodide-version Override default Pyodide version to use with `cibuildwheel` command. If empty string we use cibuildwheel's default. --cibw-release-1 Set up so that `cibw` builds all wheels except linux-aarch64, and sdist if on Linux. --cibw-release-2 Set up so that `cibw` builds only linux-aarch64 wheel. --cibw-skip-add-defaults 0|1 If 1 (the default) we add defaults to CIBW_SKIP such as `pp*` (to exclude pypy) and `cp3??t-*` (to exclude free-threading). --cibw-test-project 0|1 If 1, command `cibw` will use a minimal test project instead of the PyMuPDF directory itself. The test project uses setjmp/longjmp and C++ throw/catch. The test checks for current behaviour, so with `--cibw-pyodide 1` it succeeds if the cibw command fails with the expected error message. 2025-08-22: Builds ok on Linux. Fails at runtime with --cibw-pyodide 1: With compile/link flags ``: (+45.0s): remote.py:233:main: jules-devuan: Pyodide has suffered a fatal error. Please report this to the Pyodide maintainers. (+45.1s): remote.py:233:main: jules-devuan: Stack (most recent call first): (+45.1s): remote.py:233:main: jules-devuan: File "/tmp/cibw-run-h_pfo0wf/cp312-pyodide_wasm32/venv-test/lib/python3.12/site-packages/foo/__init__.py", line 63 in bar (+45.1s): remote.py:233:main: jules-devuan: File "The cause of the fatal error was: (+45.1s): remote.py:233:main: jules-devuan: CppException std::runtime_error: deliberate exception (+45.1s): remote.py:233:main: jules-devuan: at convertCppException (/home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/pyodide.asm.js:10:48959) (+45.1s): remote.py:233:main: jules-devuan: at API.fatal_error (/home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/pyodide.asm.js:10:49253) (+45.1s): remote.py:233:main: jules-devuan: at main (file:///home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/python_cli_entry.mjs:149:13) { (+45.1s): remote.py:233:main: jules-devuan: ty: 'std::runtime_error', (+45.1s): remote.py:233:main: jules-devuan: pyodide_fatal_error: true (+45.1s): remote.py:233:main: jules-devuan: } (+45.1s): remote.py:233:main: jules-devuan: ", line 1 in (+45.1s): remote.py:233:main: jules-devuan: CppException std::runtime_error: deliberate exception (+45.1s): remote.py:233:main: jules-devuan: at convertCppException (/home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/pyodide.asm.js:10:48959) (+45.1s): remote.py:233:main: jules-devuan: at API.fatal_error (/home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/pyodide.asm.js:10:49253) (+45.1s): remote.py:233:main: jules-devuan: at main (file:///home/jules/.cache/cibuildwheel/pyodide-build-0.30.7/0.27.7/xbuildenv/pyodide-root/dist/python_cli_entry.mjs:149:13) { (+45.1s): remote.py:233:main: jules-devuan: ty: 'std::runtime_error', (+45.1s): remote.py:233:main: jules-devuan: pyodide_fatal_error: true (+45.1s): remote.py:233:main: jules-devuan: } With compile/link flags `-fwasm-exceptions`: [LinkError: WebAssembly.instantiate(): Import #60 module="env" function="__c_longjmp": tag import requires a WebAssembly.Tag] With compile/link flags `-fwasm-exceptions -sSUPPORT_LONGJMP=wasm`: [LinkError: WebAssembly.instantiate(): Import #60 module="env" function="__c_longjmp": tag import requires a WebAssembly.Tag] --cibw-test-project-setjmp 0|1 If 1, --cibw-test-project builds a project that uses setjmp/longjmp. Default is 0 (Windows builds fail when attempting to compile the output from swig). -d Equivalent to `-b debug`. --dummy Sets PYMUPDF_SETUP_DUMMY=1 which makes setup.py build a dummy wheel with no content. For internal testing only. -e = Add to environment used in build and test commands. Can be specified multiple times. -f 0|1 If 1 we also test alias `fitz` as well as `pymupdf`. Default is '0'. --graal Use graal - run inside a Graal VM instead of a Python venv. As of 2025-08-04, if specified: * We assert-fail if cibw and non-cibw commands are specified. * If `cibw` is specified: * We use a conventional venv. * We set CIBW_ENABLE=graalpy. * We set CIBW_BUILD = 'gp*'. * Otherwise: * We don't create a conventional venv. * Clone the latest pyenv and build it. * Use pyenv to install graalpy. * Use graalpy to create venv. [After the first time, suggest `-v 1` to avoid delay from updating/building pyenv and recreating the graal venv.] --help -h Show help. -I Set PyMuPDF implementations to test. must contain only these individual characters: 'r' - rebased. 'R' - rebased without optimisations. Default is 'r'. Also see `PyMuPDF:tests/run_compound.py`. -i Controls behaviour of `install` command: * If ends with `.whl` we use `pip install `. * If starts with == or >= or >, we use `pip install pymupdf`. * Otherwise we use `pip install pymupdf==`. -k Specify which test(s) to run; passed straight through to pytest's `-k`. For example `-k test_3354`. -m | --mupdf Location of mupdf as local directory or remote git, to be used when building PyMuPDF. This sets environment variable PYMUPDF_SETUP_MUPDF_BUILD, which is used by PyMuPDF/setup.py. If not specified PyMuPDF will download its default mupdf .tgz. Additionally if starts with ':' we use the remaining text as the branch name and add https://github.com/ArtifexSoftware/mupdf.git. For example: -m "git:--branch master https://github.com/ArtifexSoftware/mupdf.git" -m :master -m "git:--branch 1.27.x https://github.com/ArtifexSoftware/mupdf.git" -m :1.27.x --mupdf-clean 0|1 If 1 we do a clean MuPDF build. -M 0|1 --build-mupdf 0|1 Whether to rebuild mupdf when we build PyMuPDF. Default is 1. -o Control whether we do nothing on the current platform. * is a comma-separated list of names. * If is empty (the default), we always run normally. * Otherwise we only run if an item in matches (case insensitive) platform.system(). * For example `-o linux,darwin` will do nothing unless on Linux or MacOS. -p Set pytest options; default is ''. -P 0|1 If 1, automatically install required system packages such as Valgrind. Default is 1 if running as Github action, otherwise 0. --pybind 0|1 Experimental, for investigating https://github.com/pymupdf/PyMuPDF/issues/3869. Runs run basic code inside C++ pybind. Requires `sudo apt install pybind11-dev` or similar. --pyodide-build-version Version of Python package pyodide-build to use with `pyodide` command. If None (the default) `pyodide` uses the latest available version. 2025-02-13: pyodide_build_version='0.29.3' works. -s 0 | 1 If 1 (the default), build with Python Limited API/Stable ABI. [This simply sSets $PYMUPDF_SETUP_PY_LIMITED_API, which is used by PyMuPDF/setup.py.] --show-args: Show sys.argv and exit. For debugging. --sync-paths Do not run anything, instead write required files/directories/checkouts to , one per line. This is to help with automated running on remote machines. --system-site-packages 0|1 If 1, use `--system-site-packages` when creating venv. Defaults is 0. --swig Use instead of the `swig` command. Unix only: Clone/update/build swig from a git repository using 'git:' prefix. We default to https://github.com/swig/swig.git branch master, so these are all equivalent: --swig 'git:--branch master https://github.com/swig/swig.git' --swig 'git:--branch master' --swig git: 2025-08-18: This fixes building with py_limited_api on python-3.13. --swig-quick 0|1 If 1 and `--swig` starts with 'git:', we do not update/build swig if already present. See description of PYMUPDF_SETUP_SWIG_QUICK in setup.py. -t Pytest test names, comma-separated. Should be relative to PyMuPDF directory. For example: -t tests/test_general.py -t tests/test_general.py::test_subset_fonts To specify multiple tests, use comma-separated list and/or multiple `-t ` args. --timeout Sets timeout when running tests. -T Use specified prefix when running pytest, must be one of: gdb helgrind valgrind -v venv is: 0 - do not use a venv. 1 - Use venv. If it already exists, we assume the existing directory was created by us earlier and is a valid venv containing all necessary packages; this saves a little time. 2 - Use venv. 3 - Use venv but delete it first if it already exists. The default is 2. Commands: build Builds and installs PyMuPDF into venv, using `pip install .../PyMuPDF`. buildtest Same as 'build test'. cibw Build and test PyMuPDF wheel(s) using cibuildwheel. Wheels are placed in directory `wheelhouse`. * We do not attempt to install wheels. * So it is generally not useful to do `cibw test`. If CIBW_BUILD is unset, we set it as follows: * On Github we build and test all supported Python versions. * Otherwise we build and test the current Python version only. If CIBW_ARCHS is unset we set $CIBW_ARCHS_WINDOWS, $CIBW_ARCHS_MACOS and $CIBW_ARCHS_LINUX to auto64 if they are unset. install Install with `pip install --force-reinstall `. pyodide Build Pyodide wheel. We clone `emsdk.git`, set it up, and run `pyodide build`. This runs our setup.py with CC etc set up to create Pyodide binaries in a wheel called, for example, `PyMuPDF-1.23.2-cp311-none-emscripten_3_1_32_wasm32.whl`. It seems that sys.version must match the Python version inside emsdk; as of 2025-02-14 this is 3.12. Otherwise we get build errors such as: [wasm-validator error in function 723] unexpected false: all used features should be allowed, on ... test Runs PyMuPDF's pytest tests. Default is to test rebased and unoptimised rebased; use `-i` to change this. wheel Build and install wheel. Environment: PYMUDF_SCRIPTS_TEST_options Is prepended to command line args. ''' import glob import os import platform import re import shlex import shutil import subprocess import sys import textwrap pymupdf_dir_abs = os.path.abspath( f'{__file__}/../..') try: sys.path.insert(0, f'{pymupdf_dir_abs}/src') import pipcl finally: del sys.path[0] try: sys.path.insert(0, f'{pymupdf_dir_abs}/scripts') import gh_release finally: del sys.path[0] pymupdf_dir = pipcl.relpath(pymupdf_dir_abs) log = pipcl.log0 run = pipcl.run # We build and test Python 3.x for x in this range. python_versions_minor = range(9, 14+1) def cibw_cp(*version_minors): ''' Returns in 'cp39*' format, e.g. suitable for CIBW_BUILD. ''' ret = list() for version_minor in version_minors: ret.append(f'cp3{version_minor}*') return ' '.join(ret) def main(argv): if github_workflow_unimportant(): return build_isolation = None cibw_name = None cibw_pyodide = None cibw_pyodide_version = None cibw_skip_add_defaults = True cibw_test_project = None cibw_test_project_setjmp = False commands = list() env_extra = dict() graal = False implementations = 'r' install_version = None mupdf_sync = None os_names = list() system_packages = True if os.environ.get('GITHUB_ACTIONS') == 'true' else False pybind = False pyodide_build_version = None pytest_options = '' pytest_prefix = None cibw_sdist = None show_args = False show_help = False sync_paths = False system_site_packages = False swig = None swig_quick = None test_fitz = False test_names = list() test_timeout = None valgrind = False warnings = list() venv = 2 options = os.environ.get('PYMUDF_SCRIPTS_TEST_options', '') options = shlex.split(options) # Parse args and update the above state. We do this before moving into a # venv, partly so we can return errors immediately. # args = iter(options + argv[1:]) i = 0 while 1: try: arg = next(args) except StopIteration: arg = None break if 0: pass elif arg == '-a': _name = next(args) _value = os.environ.get(_name, '') _args = shlex.split(_value) + list(args) args = iter(_args) elif arg == '-b': env_extra['PYMUPDF_SETUP_MUPDF_BUILD_TYPE'] = next(args) elif arg == '--build-flavour': env_extra['PYMUPDF_SETUP_FLAVOUR'] = next(args) elif arg == '--build-isolation': build_isolation = int(next(args)) elif arg == '--cibw-pyodide-version': cibw_pyodide_version = next(args) elif arg == '--cibw-release-1': cibw_sdist = True env_extra['CIBW_ARCHS_LINUX'] = 'auto64' env_extra['CIBW_ARCHS_MACOS'] = 'auto64' env_extra['CIBW_ARCHS_WINDOWS'] = 'auto' # win32 and win64. env_extra['CIBW_SKIP'] = '*i686 *musllinux*aarch64* cp3??t-*' cibw_skip_add_defaults = 0 elif arg == '--cibw-release-2': # Testing only first and last python versions because otherwise # Github times out after 6h. env_extra['CIBW_BUILD'] = cibw_cp(python_versions_minor[0], python_versions_minor[-1]) env_extra['CIBW_ARCHS_LINUX'] = 'aarch64' env_extra['CIBW_SKIP'] = '*i686 *musllinux*aarch64* cp3??t-*' cibw_skip_add_defaults = 0 os_names = ['linux'] elif arg == '--cibw-archs-linux': env_extra['CIBW_ARCHS_LINUX'] = next(args) elif arg == '--cibw-name': cibw_name = next(args) elif arg == '--cibw-pyodide': cibw_pyodide = int(next(args)) elif arg == '--cibw-skip-add-defaults': cibw_skip_add_defaults = int(next(args)) elif arg == '--cibw-test-project': cibw_test_project = int(next(args)) elif arg == '--cibw-test-project-setjmp': cibw_test_project_setjmp = int(next(args)) elif arg == '-d': env_extra['PYMUPDF_SETUP_MUPDF_BUILD_TYPE'] = 'debug' elif arg == '--dummy': env_extra['PYMUPDF_SETUP_DUMMY'] = '1' env_extra['CIBW_TEST_COMMAND'] = '' elif arg == '-e': _nv = next(args) assert '=' in _nv, f'-e = does not contain "=": {_nv!r}' _name, _value = _nv.split('=', 1) env_extra[_name] = _value elif arg == '-f': test_fitz = int(next(args)) elif arg == '--graal': graal = True elif arg in ('-h', '--help'): show_help = True elif arg == '-i': install_version = next(args) elif arg == '-I': implementations = next(args) elif arg == '-k': pytest_options += f' -k {shlex.quote(next(args))}' elif arg in ('-m', '--mupdf'): _mupdf = next(args) if _mupdf == '-': _mupdf = None elif _mupdf.startswith(':'): _branch = _mupdf[1:] _mupdf = f'git:--branch {_branch} https://github.com/ArtifexSoftware/mupdf.git' env_extra['PYMUPDF_SETUP_MUPDF_BUILD'] = _mupdf elif _mupdf.startswith('git:') or '://' in _mupdf: env_extra['PYMUPDF_SETUP_MUPDF_BUILD'] = _mupdf else: assert os.path.isdir(_mupdf), f'Not a directory: {_mupdf=}' env_extra['PYMUPDF_SETUP_MUPDF_BUILD'] = os.path.abspath(_mupdf) mupdf_sync = _mupdf elif arg == '--mupdf-clean': env_extra['PYMUPDF_SETUP_MUPDF_CLEAN']=next(args) elif arg in ('-M', '--build-mupdf'): env_extra['PYMUPDF_SETUP_MUPDF_REBUILD'] = next(args) elif arg == '-o': os_names += next(args).split(',') elif arg == '-p': pytest_options += f' {next(args)}' elif arg == '-P': system_packages = int(next(args)) elif arg == '--pybind': pybind = int(next(args)) elif arg == '--pyodide-build-version': pyodide_build_version = next(args) elif arg == '-s': _value = next(args) assert _value in ('0', '1'), f'`-s` must be followed by `0` or `1`, not {_value=}.' env_extra['PYMUPDF_SETUP_PY_LIMITED_API'] = _value elif arg == '--show-args': show_args = 1 elif arg == '--sync-paths': sync_paths = next(args) elif arg == '--system-site-packages': system_site_packages = int(next(args)) elif arg == '--swig': swig = next(args) elif arg == '--swig-quick': swig_quick = int(next(args)) elif arg == '-t': test_names += next(args).split(',') elif arg == '--timeout': test_timeout = float(next(args)) elif arg == '-T': pytest_prefix = next(args) assert pytest_prefix in ('gdb', 'helgrind', 'valgrind'), \ f'Unrecognised {pytest_prefix=}, should be one of: gdb valgrind helgrind.' elif arg == '-v': venv = int(next(args)) assert venv in (0, 1, 2, 3), f'Invalid {venv=} should be 0, 1, 2 or 3.' elif arg in ('build', 'cibw', 'install', 'pyodide', 'test', 'wheel'): commands.append(arg) elif arg == 'buildtest': commands += ['build', 'test'] else: assert 0, f'Unrecognised option/command: {arg=}.' # Handle special args --sync-paths, -h, -v, -o first. # if sync_paths: # Print required files, directories and checkouts. with open(sync_paths, 'w') as f: print(pymupdf_dir, file=f) if mupdf_sync: print(mupdf_sync, file=f) return if show_help: print(__doc__) return if show_args: print(f'sys.argv ({len(sys.argv)}):') for arg in sys.argv: print(f' {arg!r}') return if os_names: if platform.system().lower() not in os_names: log(f'Not running because {platform.system().lower()=} not in {os_names=}') return if commands: if venv: # Rerun ourselves inside a venv if not already in a venv. if not venv_in(): if graal: if 'cibw' in commands: # We don't create graal/pyenv so wheel/build commands # will not work. assert 'wheel' not in commands assert 'build' not in commands if graal and 'cibw' not in commands: # 2025-07-24: We need the latest pyenv. graalpy = 'graalpy-24.2.1' venv_name = f'venv-pymupdf-{graalpy}' pyenv_dir = f'{pymupdf_dir_abs}/pyenv-git' os.environ['PYENV_ROOT'] = pyenv_dir os.environ['PATH'] = f'{pyenv_dir}/bin:{os.environ["PATH"]}' os.environ['PIPCL_GRAAL_PYTHON'] = sys.executable if venv >= 3: shutil.rmtree(venv_name, ignore_errors=1) if venv == 1 and os.path.exists(pyenv_dir) and os.path.exists(venv_name): log(f'{venv=} and {venv_name=} already exists so not building pyenv or creating venv.') else: pipcl.git_get(pyenv_dir, remote='https://github.com/pyenv/pyenv.git', branch='master') run(f'cd {pyenv_dir} && src/configure && make -C src') run(f'which pyenv') run(f'pyenv install -v -s {graalpy}') run(f'{pyenv_dir}/versions/{graalpy}/bin/graalpy -m venv {venv_name}') e = run(f'. {venv_name}/bin/activate && python {shlex.join(sys.argv)}', check=False, ) else: venv_name = f'venv-pymupdf-{platform.python_version()}-{int.bit_length(sys.maxsize+1)}' e = venv_run( sys.argv, venv_name, recreate=(venv>=2), clean=(venv>=3), ) sys.exit(e) else: log(f'Warning, no commands specified so nothing to do.') # Clone/update/build swig if specified. swig_binary = pipcl.swig_get(swig, swig_quick) if swig_binary: os.environ['PYMUPDF_SETUP_SWIG'] = swig_binary # Handle commands. # have_installed = False for command in commands: log(f'### {command=}.') if 0: pass elif command in ('build', 'wheel'): build( env_extra, build_isolation=build_isolation, venv=venv, wheel=(command=='wheel'), ) have_installed = True elif command == 'cibw': # Build wheel(s) with cibuildwheel. if platform.system() == 'Linux': PYMUPDF_SETUP_MUPDF_BUILD = env_extra.get('PYMUPDF_SETUP_MUPDF_BUILD') if PYMUPDF_SETUP_MUPDF_BUILD and not PYMUPDF_SETUP_MUPDF_BUILD.startswith('git:'): assert PYMUPDF_SETUP_MUPDF_BUILD.startswith('/') env_extra['PYMUPDF_SETUP_MUPDF_BUILD'] = f'/host/{PYMUPDF_SETUP_MUPDF_BUILD}' cibuildwheel( env_extra, cibw_name or 'cibuildwheel', cibw_pyodide, cibw_pyodide_version, cibw_sdist, cibw_test_project, cibw_test_project_setjmp, cibw_skip_add_defaults, graal, ) elif command == 'install': p = 'pymupdf' if install_version: if install_version.endswith('.whl'): p = install_version elif install_version.startswith(('==', '>=', '>')): p = f'{p}{install_version}' else: p = f'{p}=={install_version}' run(f'pip install --force-reinstall {p}') have_installed = True elif command == 'test': if not have_installed: log(f'## Warning: have not built/installed PyMuPDF; testing whatever is already installed.') test( env_extra=env_extra, implementations=implementations, test_names=test_names, pytest_options=pytest_options, test_timeout=test_timeout, pytest_prefix=pytest_prefix, test_fitz=test_fitz, pybind=pybind, system_packages=system_packages, venv=venv, ) elif command == 'pyodide': build_pyodide_wheel(pyodide_build_version=pyodide_build_version) else: assert 0, f'{command=}' def get_env_bool(name, default=0): v = os.environ.get(name) if v in ('1', 'true'): return 1 elif v in ('0', 'false'): return 0 elif v is None: return default else: assert 0, f'Bad environ {name=} {v=}' def show_help(): print(__doc__) print(venv_info()) def github_workflow_unimportant(): ''' Returns true if we are running a Github scheduled workflow but in a repository not called 'PyMuPDF'. This can be used to avoid consuming unnecessary Github minutes running workflows on non-main repositories such as ArtifexSoftware/PyMuPDF-julian. ''' GITHUB_EVENT_NAME = os.environ.get('GITHUB_EVENT_NAME') GITHUB_REPOSITORY = os.environ.get('GITHUB_REPOSITORY') if GITHUB_EVENT_NAME == 'schedule' and GITHUB_REPOSITORY != 'pymupdf/PyMuPDF': log(f'## This is an unimportant Github workflow: a scheduled event, not in the main repository `pymupdf/PyMuPDF`.') log(f'## {GITHUB_EVENT_NAME=}.') log(f'## {GITHUB_REPOSITORY=}.') return True def venv_info(pytest_args=None): ''' Returns string containing information about the venv we use and how to run tests manually. If specified, `pytest_args` contains the pytest args, otherwise we use an example. ''' pymupdf_dir_rel = gh_release.relpath(pymupdf_dir) ret = f'Name of venv: {gh_release.venv_name}\n' if pytest_args is None: pytest_args = f'{pymupdf_dir_rel}/tests/test_general.py::test_subset_fonts' if platform.system() == 'Windows': ret += textwrap.dedent(f''' Rerun tests manually with rebased implementation: Enter venv: {gh_release.venv_name}\\Scripts\\activate Run specific test in venv: {gh_release.venv_name}\\Scripts\\python -m pytest {pytest_args} ''') else: ret += textwrap.dedent(f''' Rerun tests manually with rebased implementation: Enter venv and run specific test, also under gdb: . {gh_release.venv_name}/bin/activate python -m pytest {pytest_args} gdb --args python -m pytest {pytest_args} Run without explicitly entering venv, also under gdb: ./{gh_release.venv_name}/bin/python -m pytest {pytest_args} gdb --args ./{gh_release.venv_name}/bin/python -m pytest {pytest_args} ''') return ret def build( env_extra, *, build_isolation, venv, wheel, ): log(f'{build_isolation=}') if build_isolation is None: # On OpenBSD libclang is not available on pypi.org, so we need to force # use of system package py3-llvm with --no-build-isolation, manually # installing other required packages. build_isolation = False if platform.system() == 'OpenBSD' else True if build_isolation: # This is the default on non-OpenBSD. build_isolation_text = '' else: # Not using build isolation - i.e. pip will not be using its own clean # venv, so we need to explicitly install required packages. Manually # install required packages from pyproject.toml. sys.path.insert(0, os.path.abspath(f'{__file__}/../..')) import setup names = setup.get_requires_for_build_wheel() del sys.path[0] if names: names = ' '.join(names) if venv == 2: run( f'python -m pip install --upgrade {names}') else: log(f'{venv=}: Not installing packages with pip: {names}') build_isolation_text = ' --no-build-isolation' if wheel: new_files = pipcl.NewFiles(f'wheelhouse/*.whl') run(f'pip wheel{build_isolation_text} -w wheelhouse -v {pymupdf_dir_abs}', env_extra=env_extra) wheel = new_files.get_one() run(f'pip install --force-reinstall {wheel}') else: run(f'pip install{build_isolation_text} -v --force-reinstall {pymupdf_dir_abs}', env_extra=env_extra) def cibuildwheel( env_extra, cibw_name, cibw_pyodide, cibw_pyodide_version, cibw_sdist, cibw_test_project, cibw_test_project_setjmp, cibw_skip_add_defaults, graal, ): if cibw_sdist and platform.system() == 'Linux': log(f'Building sdist.') run(f'cd {pymupdf_dir_abs} && {sys.executable} setup.py -d wheelhouse sdist', env_extra=env_extra) sdists = glob.glob(f'{pymupdf_dir_abs}/wheelhouse/pymupdf-*.tar.gz') log(f'{sdists=}') assert sdists run(f'pip install --upgrade --force-reinstall {cibw_name}') # Some general flags. if 'CIBW_BUILD_VERBOSITY' not in env_extra: env_extra['CIBW_BUILD_VERBOSITY'] = '1' # Add default flags to CIBW_SKIP. # 2025-10-07: `cp3??t-*` excludes free-threading, which currently breaks # some tests. if cibw_skip_add_defaults: CIBW_SKIP = env_extra.get('CIBW_SKIP', '') CIBW_SKIP += ' *i686 *musllinux* *-win32 *-aarch64 cp3??t-*' CIBW_SKIP = CIBW_SKIP.split() CIBW_SKIP = sorted(list(set(CIBW_SKIP))) CIBW_SKIP = ' '.join(CIBW_SKIP) env_extra['CIBW_SKIP'] = CIBW_SKIP # Set what wheels to build, if not already specified. if 'CIBW_ARCHS' not in env_extra: if 'CIBW_ARCHS_WINDOWS' not in env_extra: env_extra['CIBW_ARCHS_WINDOWS'] = 'auto64' if 'CIBW_ARCHS_MACOS' not in env_extra: env_extra['CIBW_ARCHS_MACOS'] = 'auto64' if 'CIBW_ARCHS_LINUX' not in env_extra: env_extra['CIBW_ARCHS_LINUX'] = 'auto64' # Tell cibuildwheel not to use `auditwheel` on Linux and MacOS, # because it cannot cope with us deliberately having required # libraries in different wheel - specifically in the PyMuPDF wheel. # # We cannot use a subset of auditwheel's functionality # with `auditwheel addtag` because it says `No tags # to be added` and terminates with non-zero. See: # https://github.com/pypa/auditwheel/issues/439. # env_extra['CIBW_REPAIR_WHEEL_COMMAND_LINUX'] = '' env_extra['CIBW_REPAIR_WHEEL_COMMAND_MACOS'] = '' # Tell cibuildwheel how to test PyMuPDF. if 'CIBW_TEST_COMMAND' not in env_extra: env_extra['CIBW_TEST_COMMAND'] = f'python {{project}}/scripts/test.py test' # Specify python versions. CIBW_BUILD = env_extra.get('CIBW_BUILD') log(f'{CIBW_BUILD=}') if CIBW_BUILD is None: if graal: CIBW_BUILD = 'gp*' env_extra['CIBW_ENABLE'] = 'graalpy' elif cibw_pyodide: # Using python-3.13 fixes problems with MuPDF's setjmp/longjmp. CIBW_BUILD = 'cp313*' elif os.environ.get('GITHUB_ACTIONS') == 'true': # Build/test all supported Python versions. CIBW_BUILD = cibw_cp(*python_versions_minor) else: # Build/test current Python only. v = platform.python_version_tuple()[:2] log(f'{v=}') CIBW_BUILD = f'cp{"".join(v)}*' log(f'Defaulting to {CIBW_BUILD=}.') cibw_pyodide_args = '' if cibw_pyodide: cibw_pyodide_args = ' --platform pyodide' env_extra['HAVE_LIBCRYPTO'] = 'no' env_extra['PYMUPDF_SETUP_MUPDF_TESSERACT'] = '0' if cibw_pyodide_version: # 2025-07-21: there is no --pyodide-version option so we set # CIBW_PYODIDE_VERSION. env_extra['CIBW_PYODIDE_VERSION'] = cibw_pyodide_version env_extra['CIBW_ENABLE'] = 'pyodide-prerelease' # Pass all the environment variables we have set, to Linux docker. Note # that this will miss any settings in the original environment. We have to # add CIBW_BUILD explicitly because we haven't set it yet. CIBW_ENVIRONMENT_PASS_LINUX = set(env_extra.keys()) CIBW_ENVIRONMENT_PASS_LINUX.add('CIBW_BUILD') CIBW_ENVIRONMENT_PASS_LINUX = sorted(list(CIBW_ENVIRONMENT_PASS_LINUX)) CIBW_ENVIRONMENT_PASS_LINUX = ' '.join(CIBW_ENVIRONMENT_PASS_LINUX) env_extra['CIBW_ENVIRONMENT_PASS_LINUX'] = CIBW_ENVIRONMENT_PASS_LINUX if cibw_test_project: cibw_do_test_project( env_extra, CIBW_BUILD, cibw_pyodide, cibw_pyodide_args, cibw_test_project_setjmp, ) return env_extra['CIBW_BUILD'] = CIBW_BUILD run(f'cd {pymupdf_dir} && cibuildwheel{cibw_pyodide_args}', env_extra=env_extra, prefix='cibw: ') run(f'ls -ld {pymupdf_dir}/wheelhouse/*') def cibw_do_test_project( env_extra, CIBW_BUILD, cibw_pyodide, cibw_pyodide_args, cibw_test_project_setjmp, ): testdir = f'{pymupdf_dir_abs}/cibw_test' shutil.rmtree(testdir, ignore_errors=1) os.mkdir(testdir) with open(f'{testdir}/setup.py', 'w') as f: f.write(textwrap.dedent(f''' import shutil import sys import os import pipcl def build(): so_leaf = pipcl.build_extension( name = 'foo', path_i = 'foo.i', outdir = 'build', source_extra = 'qwerty.cpp', py_limited_api = True, ) return [ ('build/foo.py', 'foo/__init__.py'), (f'build/{{so_leaf}}', f'foo/'), ] p = pipcl.Package( name = 'pymupdf-test', version = '1.2.3', fn_build = build, py_limited_api=True, ) def get_requires_for_build_wheel(config_settings=None): return ['swig'] build_wheel = p.build_wheel build_sdist = p.build_sdist # Handle old-style setup.py command-line usage: if __name__ == '__main__': p.handle_argv(sys.argv) ''')) with open(f'{testdir}/foo.i', 'w') as f: if cibw_test_project_setjmp: f.write(textwrap.dedent(''' %{ #include #include #include #include #include int qwerty(void); static sigjmp_buf jmpbuf; static int bar0(const char* text) { printf("bar0(): text: %s\\n", text); int q = qwerty(); printf("bar0(): q=%i\\n", q); int len = (int) strlen(text); printf("bar0(): len=%i\\n", len); printf("bar0(): calling longjmp().\\n"); fflush(stdout); longjmp(jmpbuf, 1); assert(0); } int bar1(const char* text) { int ret = 0; if (setjmp(jmpbuf) == 0) { ret = bar0(text); } else { printf("bar1(): setjmp() returned non-zero.\\n"); throw std::runtime_error("deliberate exception"); } assert(0); } int bar(const char* text) { int ret = 0; try { ret = bar1(text); } catch(std::exception& e) { printf("bar1(): received exception: %s\\n", e.what()); } return ret; } %} int bar(const char* text); ''')) else: f.write(textwrap.dedent(''' %{ #include #include #include #include int qwerty(void); int bar(const char* text) { qwerty(); return strlen(text); } %} int bar(const char* text); ''')) with open(f'{testdir}/qwerty.cpp', 'w') as f: f.write(textwrap.dedent(''' #include int qwerty(void) { printf("qwerty()\\n"); return 3; } ''')) with open(f'{testdir}/pyproject.toml', 'w') as f: f.write(textwrap.dedent(''' [build-system] requires = ['pipcl'] build-backend = 'setup' backend-path = ['.'] ''')) shutil.copy2(f'{pymupdf_dir_abs}/pipcl.py', f'{testdir}/pipcl.py') shutil.copy2(f'{pymupdf_dir_abs}/wdev.py', f'{testdir}/wdev.py') env_extra['CIBW_BUILD'] = CIBW_BUILD CIBW_TEST_COMMAND = '' if cibw_pyodide: CIBW_TEST_COMMAND += 'pyodide xbuildenv search --all; ' CIBW_TEST_COMMAND += 'python -c "import foo; foo.bar(\\"some text\\")"' env_extra['CIBW_TEST_COMMAND'] = CIBW_TEST_COMMAND #env_extra['CIBW_TEST_COMMAND'] = '' run(f'cd {testdir} && cibuildwheel --output-dir ../wheelhouse{cibw_pyodide_args}', env_extra=env_extra, prefix='cibw: ', ) run(f'ls -ldt {pymupdf_dir_abs}/wheelhouse/*') def build_pyodide_wheel(pyodide_build_version=None): ''' Build Pyodide wheel. This runs `pyodide build` inside the PyMuPDF directory, which in turn runs setup.py in a Pyodide build environment. ''' log(f'## Building Pyodide wheel.') # Our setup.py does not know anything about Pyodide; we set a few # required environmental variables here. # env_extra = dict() # Disable libcrypto because not available in Pyodide. env_extra['HAVE_LIBCRYPTO'] = 'no' # Tell MuPDF to build for Pyodide. env_extra['OS'] = 'pyodide' # Build a single wheel without a separate PyMuPDFb wheel. env_extra['PYMUPDF_SETUP_FLAVOUR'] = 'pb' # 2023-08-30: We set PYMUPDF_SETUP_MUPDF_BUILD_TESSERACT=0 because # otherwise mupdf thirdparty/tesseract/src/ccstruct/dppoint.cpp fails to # build because `#include "errcode.h"` finds a header inside emsdk. This is # pyodide bug https://github.com/pyodide/pyodide/issues/3839. It's fixed in # https://github.com/pyodide/pyodide/pull/3866 but the fix has not reached # pypi.org's pyodide-build package. E.g. currently in tag 0.23.4, but # current devuan pyodide-build is pyodide_build-0.23.4. # env_extra['PYMUPDF_SETUP_MUPDF_TESSERACT'] = '0' setup = pyodide_setup(pymupdf_dir, pyodide_build_version=pyodide_build_version) command = f'{setup} && echo "### Running pyodide build" && pyodide build --exports whole_archive' command = command.replace(' && ', '\n && ') run(command, env_extra=env_extra) # Copy wheel into `wheelhouse/` so it is picked up as a workflow # artifact. # run(f'ls -l {pymupdf_dir}/dist/') run(f'mkdir -p {pymupdf_dir}/wheelhouse && cp -p {pymupdf_dir}/dist/* {pymupdf_dir}/wheelhouse/') run(f'ls -l {pymupdf_dir}/wheelhouse/') def pyodide_setup( directory, clean=False, pyodide_build_version=None, ): ''' Returns a command that will set things up for a pyodide build. Args: directory: Our command cd's into this directory. clean: If true we create an entirely new environment. Otherwise we reuse any existing emsdk repository and venv. pyodide_build_version: Version of Python package pyodide-build; if None we use latest available version. 2025-02-13: pyodide_build_version='0.29.3' works. The returned command does the following: * Checkout latest emsdk from https://github.com/emscripten-core/emsdk.git: * Clone emsdk repository to `emsdk` if not already present. * Run `git pull -r` inside emsdk checkout. * Create venv `venv_pyodide_` if not already present. * Activate venv `venv_pyodide_`. * Install/upgrade package `pyodide-build`. * Run emsdk install scripts and enter emsdk environment. Example usage in a build function: command = pyodide_setup() command += ' && pyodide build --exports pyinit' subprocess.run(command, shell=1, check=1) ''' pv = platform.python_version_tuple()[:2] assert pv == ('3', '12'), f'Pyodide builds need to be run with Python-3.12 but current Python is {platform.python_version()}.' command = f'cd {directory}' # Clone/update emsdk. We always use the latest emsdk with `git pull`. # # 2025-02-13: this works: 2514ec738de72cebbba7f4fdba0cf2fabcb779a5 # dir_emsdk = 'emsdk' if clean: shutil.rmtree(dir_emsdk, ignore_errors=1) # 2024-06-25: old `.pyodide-xbuildenv` directory was breaking build, so # important to remove it here. shutil.rmtree('.pyodide-xbuildenv', ignore_errors=1) if not os.path.exists(f'{directory}/{dir_emsdk}'): command += f' && echo "### Cloning emsdk.git"' command += f' && git clone https://github.com/emscripten-core/emsdk.git {dir_emsdk}' command += f' && echo "### Updating checkout {dir_emsdk}"' command += f' && (cd {dir_emsdk} && git pull -r)' command += f' && echo "### Checkout {dir_emsdk} is:"' command += f' && (cd {dir_emsdk} && git show -s --oneline)' # Create and enter Python venv. # python = sys.executable venv_pyodide = f'venv_pyodide_{sys.version_info[0]}.{sys.version_info[1]}' if not os.path.exists( f'{directory}/{venv_pyodide}'): command += f' && echo "### Creating venv {venv_pyodide}"' command += f' && {python} -m venv {venv_pyodide}' command += f' && . {venv_pyodide}/bin/activate' command += f' && echo "### Installing Python packages."' command += f' && python -m pip install --upgrade pip wheel pyodide-build' if pyodide_build_version: command += f'=={pyodide_build_version}' # Run emsdk install scripts and enter emsdk environment. # command += f' && cd {dir_emsdk}' command += ' && PYODIDE_EMSCRIPTEN_VERSION=$(pyodide config get emscripten_version)' command += ' && echo "### PYODIDE_EMSCRIPTEN_VERSION is: $PYODIDE_EMSCRIPTEN_VERSION"' command += ' && echo "### Running ./emsdk install"' command += ' && ./emsdk install ${PYODIDE_EMSCRIPTEN_VERSION}' command += ' && echo "### Running ./emsdk activate"' command += ' && ./emsdk activate ${PYODIDE_EMSCRIPTEN_VERSION}' command += ' && echo "### Running ./emsdk_env.sh"' command += ' && . ./emsdk_env.sh' # Need leading `./` otherwise weird 'Not found' error. command += ' && cd ..' return command def test( *, env_extra, implementations, venv=False, test_names=None, pytest_options=None, test_timeout=None, pytest_prefix=None, test_fitz=True, pytest_k=None, pybind=False, system_packages=False, ): if pybind: cpp_path = 'pymupdf_test_pybind.cpp' cpp_exe = 'pymupdf_test_pybind.exe' cpp = textwrap.dedent(''' #include int main() { pybind11::scoped_interpreter guard{}; pybind11::exec(R"( print('Hello world', flush=1) import pymupdf pymupdf.JM_mupdf_show_warnings = 1 print(f'{pymupdf.version=}', flush=1) doc = pymupdf.Document() pymupdf.mupdf.fz_warn('Dummy warning.') pymupdf.mupdf.fz_warn('Dummy warning.') pymupdf.mupdf.fz_warn('Dummy warning.') print(f'{doc=}', flush=1) )"); } ''') def fs_read(path): try: with open(path) as f: return f.read() except Exception: return def fs_remove(path): try: os.remove(path) except Exception: pass cpp_existing = fs_read(cpp_path) if cpp == cpp_existing: log(f'Not creating {cpp_exe} because unchanged: {cpp_path}') else: with open(cpp_path, 'w') as f: f.write(cpp) def getmtime(path): try: return os.path.getmtime(path) except Exception: return 0 python_config = f'{os.path.realpath(sys.executable)}-config' # `--embed` adds `-lpython3.11` to the link command, which appears to # be necessary when building an executable. flags = run(f'{python_config} --cflags --ldflags --embed', capture=1) build_command = f'c++ {cpp_path} -o {cpp_exe} -g -W -Wall {flags}' build_path = f'{cpp_exe}.cmd' build_command_prev = fs_read(build_path) if build_command != build_command_prev or getmtime(cpp_path) >= getmtime(cpp_exe): fs_remove(build_path) run(build_command) with open(build_path, 'w') as f: f.write(build_command) run(f'./{cpp_exe}') return pymupdf_dir_rel = gh_release.relpath(pymupdf_dir) if not pytest_options and pytest_prefix == 'valgrind': pytest_options = '-sv' if pytest_k: pytest_options += f' -k {shlex.quote(pytest_k)}' pytest_arg = '' if test_names: for test_name in test_names: pytest_arg += f' {pymupdf_dir_rel}/{test_name}' else: pytest_arg += f' {pymupdf_dir_rel}/tests' python = gh_release.relpath(sys.executable) log('Running tests with tests/run_compound.py and pytest.') PYODIDE_ROOT = os.environ.get('PYODIDE_ROOT') if PYODIDE_ROOT is not None: # We can't install packages with `pip install`; setup.py will have # specified pytest in the wheels's , so it will be # already installed. # log(f'Not installing test packages because {PYODIDE_ROOT=}.') command = f'{pytest_options} {pytest_arg}' args = shlex.split(command) log(f'{PYODIDE_ROOT=} so calling pytest.main(args).') log(f'{command=}') log(f'args are ({len(args)}):') for arg in args: log(f' {arg!r}') import pytest e = pytest.main(args) assert e == 0, f'pytest.main() failed: {e=}' return if venv >= 2: run(f'pip install --upgrade {gh_release.test_packages}') else: log(f'{venv=}: Not installing test packages: {gh_release.test_packages}') run_compound_args = '' if implementations: run_compound_args += f' -i {implementations}' if test_timeout: run_compound_args += f' -t {test_timeout}' if pytest_prefix in ('valgrind', 'helgrind'): if system_packages: log('Installing valgrind.') run(f'sudo apt update') run(f'sudo apt install --upgrade valgrind') run(f'valgrind --version') command = f'{python} {pymupdf_dir_rel}/tests/run_compound.py{run_compound_args}' if pytest_prefix is None: pass elif pytest_prefix == 'gdb': command += ' gdb --args' elif pytest_prefix == 'valgrind': env_extra['PYMUPDF_RUNNING_ON_VALGRIND'] = '1' env_extra['PYTHONMALLOC'] = 'malloc' command += ( f' valgrind' f' --suppressions={pymupdf_dir_abs}/valgrind.supp' f' --trace-children=no' f' --num-callers=20' f' --error-exitcode=100' f' --errors-for-leak-kinds=none' f' --fullpath-after=' ) elif pytest_prefix == 'helgrind': env_extra['PYMUPDF_RUNNING_ON_VALGRIND'] = '1' env_extra['PYTHONMALLOC'] = 'malloc' command = ( f' valgrind' f' --tool=helgrind' f' --trace-children=no' f' --num-callers=20' f' --error-exitcode=100' f' --fullpath-after=' ) else: assert 0, f'Unrecognised {pytest_prefix=}' if platform.system() == 'Windows': # `python -m pytest` doesn't seem to work. command += ' pytest' else: # On OpenBSD `pip install pytest` doesn't seem to install the pytest # command, so we use `python -m pytest ...`. command += f' {python} -m pytest' command += f' {pytest_options} {pytest_arg}' # Always start by removing any test_*_fitz.py files. for p in glob.glob(f'{pymupdf_dir_rel}/tests/test_*_fitz.py'): log(f'Removing {p=}') os.remove(p) if test_fitz: # Create copies of each test file, modified to use `pymupdf` # instead of `fitz`. for p in glob.glob(f'{pymupdf_dir_rel}/tests/test_*.py'): if os.path.basename(p).startswith('test_fitz_'): # Don't recursively generate test_fitz_fitz_foo.py, # test_fitz_fitz_fitz_foo.py, ... etc. continue branch, leaf = os.path.split(p) p2 = f'{branch}/{leaf[:5]}fitz_{leaf[5:]}' log(f'Converting {p=} to {p2=}.') with open(p, encoding='utf8') as f: text = f.read() text2 = re.sub("([^\'])\\bpymupdf\\b", '\\1fitz', text) if p.replace(os.sep, '/') == f'{pymupdf_dir_rel}/tests/test_docs_samples.py'.replace(os.sep, '/'): assert text2 == text else: assert text2 != text, f'Unexpectedly unchanged when creating {p!r} => {p2!r}' with open(p2, 'w', encoding='utf8') as f: f.write(text2) try: log(f'Running tests with tests/run_compound.py and pytest.') run(command, env_extra=env_extra, timeout=test_timeout) except subprocess.TimeoutExpired as e: log(f'Timeout when running tests.') raise finally: log(f'\n' f'[As of 2024-10-10 we get warnings from pytest/Python such as:\n' f' DeprecationWarning: builtin type SwigPyPacked has no __module__ attribute\n' f'This seems to be due to Swig\'s handling of Py_LIMITED_API.\n' f'For details see https://github.com/swig/swig/issues/2881.\n' f']' ) log('\n' + venv_info(pytest_args=f'{pytest_options} {pytest_arg}')) def get_pyproject_required(ppt=None): ''' Returns list of names of required packages in pyproject.toml. We do not do a proper parse and rely on the packages being in a single line. ''' if ppt is None: ppt = os.path.abspath(f'{__file__}/../../pyproject.toml') with open(ppt) as f: for line in f: m = re.match('^ *requires = \\[(.*)\\]$', line) if m: names = m.group(1).replace(',', ' ').replace('"', '').replace("'", '') names = names.split() return names else: assert 0, f'Failed to find "requires" line in {ppt}' def wrap_get_requires_for_build_wheel(dir_): ''' Returns space-separated list of required packages. Looks at `dir_`/pyproject.toml and calls `dir_`/setup.py:get_requires_for_build_wheel(). ''' dir_abs = os.path.abspath(dir_) ret = list() ppt = os.path.join(dir_abs, 'pyproject.toml') if os.path.exists(ppt): ret += get_pyproject_required(ppt) log(f'{ret=}') if os.path.exists(os.path.join(dir_abs, 'setup.py')): sys.path.insert(0, dir_abs) try: from setup import get_requires_for_build_wheel as foo for i in foo(): ret.append(i) finally: del sys.path[0] return ' '.join(ret) def venv_in(path=None): ''' If path is None, returns true if we are in a venv. Otherwise returns true only if we are in venv . ''' if path: return os.path.abspath(sys.prefix) == os.path.abspath(path) else: return sys.prefix != sys.base_prefix def venv_run(args, path, recreate=True, clean=False): ''' Runs command inside venv and returns termination code. Args: args: List of args. path: Name of venv. recreate: If false we do not run ` -m venv ` if already exists. This avoids a delay in the common case where is already set up, but fails if exists but does not contain a valid venv. clean: If true we first delete . ''' if clean: log(f'Removing any existing venv {path}.') assert path.startswith('venv-') shutil.rmtree(path, ignore_errors=1) if recreate or not os.path.isdir(path): run(f'{sys.executable} -m venv {path}') if platform.system() == 'Windows': command = f'{path}\\Scripts\\activate && python' # shlex not reliable on Windows. # Use crude quoting with "...". Seems to work. for arg in args: assert '"' not in arg command += f' "{arg}"' else: command = f'. {path}/bin/activate && python {shlex.join(args)}' e = run(command, check=0) return e if __name__ == '__main__': try: sys.exit(main(sys.argv)) except (subprocess.CalledProcessError, subprocess.TimeoutExpired) as e: # Terminate relatively quietly, failed commands will usually have # generated diagnostics. log(f'{e}') sys.exit(1) # Other exceptions should not happen, and will generate a full Python # backtrace etc here. ================================================ FILE: setup.py ================================================ #! /usr/bin/env python3 ''' Overview: Build script for PyMuPDF, supporting PEP-517 and simple command-line usage. We hard-code the URL of the MuPDF .tar.gz file that we require. This generally points to a particular source release on mupdf.com. Default behaviour: Building an sdist: As of 2024-002-28 we no longer download the MuPDF .tar.gz file and embed it within the sdist. Instead it will be downloaded at build time. Building PyMuPDF: We first download the hard-coded mupdf .tar.gz file. Then we extract and build MuPDF locally, before building PyMuPDF itself. So PyMuPDF will always be built with the exact MuPDF release that we require. Environmental variables: If building with system MuPDF (PYMUPDF_SETUP_MUPDF_BUILD is empty string): CFLAGS CXXFLAGS LDFLAGS Added to c, c++, and link commands. PYMUPDF_INCLUDES Colon-separated extra include paths. PYMUPDF_MUPDF_LIB Directory containing MuPDF libraries, (libmupdf.so, libmupdfcpp.so). PIPCL_SHOW_ENV If '0', we do not show environment variables on startup. PYMUPDF_SETUP_DEVENV Location of devenv.com on Windows. If unset we search for it - see wdev.py. if that fails we use just 'devenv.com'. PYMUPDF_SETUP_DUMMY If 1, we build dummy sdist and wheel with no files. PYMUPDF_SETUP_FLAVOUR Control building of separate wheels for PyMuPDF. Must be unset or a combination of 'p', 'b' and 'd'. Default is 'pbd'. 'p': Generated wheel contains PyMuPDF code. 'b': Generated wheel contains MuPDF libraries; these are independent of the Python version. 'd': Generated wheel contains includes and libraries for MuPDF. If 'p' is included, the generated wheel is called PyMuPDF. Otherwise if 'b' is included the generated wheel is called PyMuPDFb. Otherwise if 'd' is included the generated wheel is called PyMuPDFd. For example: 'pb': a `PyMuPDF` wheel with PyMuPDF runtime files and MuPDF runtime shared libraries. 'b': a `PyMuPDFb` wheel containing MuPDF runtime shared libraries. 'pbd' a `PyMuPDF` wheel with PyMuPDF runtime files and MuPDF runtime shared libraries, plus MuPDF build-time files (includes, *.lib files on Windows). 'd': a `PyMuPDFd` wheel containing MuPDF build-time files (includes, *.lib files on Windows). PYMUPDF_SETUP_LIBCLANG For internal testing. PYMUPDF_SETUP_MUPDF_BUILD If unset or '-', use internal hard-coded default MuPDF location. Otherwise overrides location of MuPDF when building PyMuPDF: Empty string: Build PyMuPDF with the system MuPDF. A string starting with 'git:': We use `git` commands to clone/update a local MuPDF checkout. Should match `git:[--branch ][--tag ][]`. If is omitted we use a default. For example: PYMUPDF_SETUP_MUPDF_BUILD="git:--branch master" Passed as arg to pipcl.git_get(). Otherwise: Location of mupdf directory. PYMUPDF_SETUP_MUPDF_BSYMBOLIC If '0' we do not link libmupdf.so with -Bsymbolic. PYMUPDF_SETUP_MUPDF_TESSERACT If '0' we build MuPDF without Tesseract. PYMUPDF_SETUP_MUPDF_BUILD_TYPE Unix only. Controls build type of MuPDF. Supported values are: debug memento release (default) PYMUPDF_SETUP_FAKE_NOGIL If '1' we (incorrectly) claim we are thread-safe. PYMUPDF_SETUP_MUPDF_CLEAN Unix only. If '1', we do a clean MuPDF build. PYMUPDF_SETUP_MUPDF_REFCHECK_IF Should be preprocessor statement to enable MuPDF reference count checking. As of 2024-09-27, MuPDF default is `#ifndef NDEBUG`. PYMUPDF_SETUP_MUPDF_TRACE_IF Should be preprocessor statement to enable MuPDF runtime diagnostics in response to environment variables such as MUPDF_trace. As of 2024-09-27, MuPDF default is `#ifndef NDEBUG`. PYMUPDF_SETUP_MUPDF_THIRD If '0' and we are building on Linux with the system MuPDF (i.e. PYMUPDF_SETUP_MUPDF_BUILD=''), then don't link with `-lmupdf-third`. PYMUPDF_SETUP_MUPDF_VS_UPGRADE If '1' we run mupdf `scripts/mupdfwrap.py` with `--vs-upgrade 1` to help Windows builds work with Visual Studio versions newer than 2019. PYMUPDF_SETUP_MUPDF_TGZ If set, overrides location of MuPDF .tar.gz file: Empty string: Do not download MuPDF .tar.gz file. Sdist's will not contain MuPDF. A string containing '://': The URL from which to download the MuPDF .tar.gz file. Leaf must match mupdf-*.tar.gz. Otherwise: The path of local mupdf git checkout. We put all files in this checkout known to git into a local tar archive. PYMUPDF_SETUP_MUPDF_OVERWRITE_CONFIG If '0' we do not overwrite MuPDF's include/mupdf/fitz/config.h with PyMuPDF's own configuration file, before building MuPDF. PYMUPDF_SETUP_MUPDF_REBUILD If 0 we do not (re)build mupdf. PYMUPDF_SETUP_PY_LIMITED_API If not '0', we build for current Python's stable ABI. PYMUPDF_SETUP_URL_WHEEL If set, we use an existing wheel instead of building a new wheel. If starts with `http://` or `https://`: If ends with '/', we append our wheel name and download. Otherwise we download directly. If starts with `file://`: If ends with '/' we look for a matching wheel name, `using pipcl.wheel_name_match()` to cope with differing platform tags, for example our `manylinux2014_x86_64` will match with an existing wheel with `manylinux2014_x86_64.manylinux_2_17_x86_64`. Any other prefix is an error. PYMUPDF_SETUP_SWIG If set, we use this instead of `swig`. WDEV_VS_YEAR If set, we use as Visual Studio year, for example '2019' or '2022'. WDEV_VS_GRADE If set, we use as Visual Studio grade, for example 'Community' or 'Professional' or 'Enterprise'. ''' import glob import io import os import textwrap import time import platform import re import shlex import shutil import stat import subprocess import sys import tarfile import traceback import urllib.request import zipfile import pipcl log = pipcl.log0 run = pipcl.run if 1: # For debugging. log(f'### Starting.') pipcl.show_system() PYMUPDF_SETUP_FLAVOUR = os.environ.get( 'PYMUPDF_SETUP_FLAVOUR', 'pbd') for i in PYMUPDF_SETUP_FLAVOUR: assert i in 'pbd', f'Unrecognised flag "{i} in {PYMUPDF_SETUP_FLAVOUR=}. Should be one of "p", "b", "d"' g_root = os.path.abspath( f'{__file__}/..') # Name of file that identifies that we are in a PyMuPDF sdist. g_pymupdfb_sdist_marker = 'pymupdfb_sdist' python_version_tuple = tuple(int(x) for x in platform.python_version_tuple()[:2]) PYMUPDF_SETUP_PY_LIMITED_API = os.environ.get('PYMUPDF_SETUP_PY_LIMITED_API') assert PYMUPDF_SETUP_PY_LIMITED_API in (None, '', '0', '1'), \ f'Should be "", "0", "1" or undefined: {PYMUPDF_SETUP_PY_LIMITED_API=}.' g_py_limited_api = (PYMUPDF_SETUP_PY_LIMITED_API != '0') PYMUPDF_SETUP_URL_WHEEL = os.environ.get('PYMUPDF_SETUP_URL_WHEEL') log(f'{PYMUPDF_SETUP_URL_WHEEL=}') PYMUPDF_SETUP_DUMMY = os.environ.get('PYMUPDF_SETUP_DUMMY') log(f'{PYMUPDF_SETUP_DUMMY=}') PYMUPDF_SETUP_SWIG = os.environ.get('PYMUPDF_SETUP_SWIG') PYMUPDF_SETUP_FAKE_NOGIL = os.environ.get('PYMUPDF_SETUP_FAKE_NOGIL') def _fs_remove(path): ''' Removes file or directory, without raising exception if it doesn't exist. We assert-fail if the path still exists when we return, in case of permission problems etc. ''' # First try deleting `path` as a file. try: os.remove( path) except Exception as e: pass if os.path.exists(path): # Try deleting `path` as a directory. Need to use # shutil.rmtree() callback to handle permission problems; see: # https://docs.python.org/3/library/shutil.html#rmtree-example # def error_fn(fn, path, excinfo): # Clear the readonly bit and reattempt the removal. os.chmod(path, stat.S_IWRITE) fn(path) shutil.rmtree( path, onerror=error_fn) assert not os.path.exists( path) def _git_get_branch( directory): command = f'cd {directory} && git branch --show-current' log( f'Running: {command}') p = subprocess.run( command, shell=True, check=False, text=True, stdout=subprocess.PIPE, ) ret = None if p.returncode == 0: ret = p.stdout.strip() log( f'Have found MuPDF git branch: ret={ret!r}') return ret def tar_check(path, mode='r:gz', prefix=None, remove=False): ''' Checks items in tar file have same , or if not None. We fail if items in tar file have different top-level directory names. path: The tar file. mode: As tarfile.open(). prefix: If not None, we fail if tar file's is not . Returns the directory name (which will be if not None). ''' with tarfile.open( path, mode) as t: items = t.getnames() assert items item = items[0] assert not item.startswith('./') and not item.startswith('../') s = item.find('/') if s == -1: prefix_actual = item + '/' else: prefix_actual = item[:s+1] if prefix: assert prefix == prefix_actual, f'{path=} {prefix=} {prefix_actual=}' for item in items[1:]: assert item.startswith( prefix_actual), f'prefix_actual={prefix_actual!r} != item={item!r}' return prefix_actual def tar_extract(path, mode='r:gz', prefix=None, exists='raise'): ''' Extracts tar file into single local directory. We fail if items in tar file have different . path: The tar file. mode: As tarfile.open(). prefix: If not None, we fail if tar file's is not . exists: What to do if already exists: 'raise': raise exception. 'remove': remove existing file/directory before extracting. 'return': return without extracting. Returns the directory name (which will be if not None, with '/' appended if not already present). ''' prefix_actual = tar_check( path, mode, prefix) if os.path.exists( prefix_actual): if exists == 'raise': raise Exception( f'Path already exists: {prefix_actual!r}') elif exists == 'remove': remove( prefix_actual) elif exists == 'return': log( f'Not extracting {path} because already exists: {prefix_actual}') return prefix_actual else: assert 0, f'Unrecognised exists={exists!r}' assert not os.path.exists( prefix_actual), f'Path already exists: {prefix_actual}' log( f'Extracting {path}') with tarfile.open( path, mode) as t: t.extractall() return prefix_actual def git_info( directory): ''' Returns `(sha, comment, diff, branch)`, all items are str or None if not available. directory: Root of git checkout. ''' sha, comment, diff, branch = '', '', '', '' cp = subprocess.run( f'cd {directory} && (PAGER= git show --pretty=oneline|head -n 1 && git diff)', capture_output=1, shell=1, text=1, ) if cp.returncode == 0: sha, _ = cp.stdout.split(' ', 1) comment, diff = _.split('\n', 1) cp = subprocess.run( f'cd {directory} && git rev-parse --abbrev-ref HEAD', capture_output=1, shell=1, text=1, ) if cp.returncode == 0: branch = cp.stdout.strip() log(f'git_info(): directory={directory!r} returning branch={branch!r} sha={sha!r} comment={comment!r}') return sha, comment, diff, branch def git_patch(directory, patch, hard=False): ''' Applies string with `git patch` in . If is true we clean the tree with `git checkout .` and then apply the patch. Otherwise we apply patch only if it is not already applied; this might fail if there are conflicting changes in the tree. ''' log(f'Applying patch in {directory}:\n{textwrap.indent(patch, " ")}') if not patch: return # Carriage returns break `git apply` so we use `newline='\n'` in open(). path = os.path.abspath(f'{directory}/pymupdf_patch.txt') with open(path, 'w', newline='\n') as f: f.write(patch) log(f'Using patch file: {path}') if hard: run(f'cd {directory} && git checkout .') run(f'cd {directory} && git apply {path}') log(f'Have applied patch in {directory}.') else: e = run( f'cd {directory} && git apply --check --reverse {path}', check=0) if e == 0: log(f'Not patching {directory} because already patched.') else: run(f'cd {directory} && git apply {path}') log(f'Have applied patch in {directory}.') run(f'cd {directory} && git diff') mupdf_tgz = os.path.abspath( f'{__file__}/../mupdf.tgz') def get_mupdf_internal(out, location=None, local_tgz=None): ''' Gets MuPDF as either a .tgz or a local directory. Args: out: Either 'dir' (we return name of local directory containing mupdf) or 'tgz' (we return name of local .tgz file containing mupdf). location: First, if None we set to hard-coded default URL or git location. If starts with 'git:', should be remote git location. Otherwise if containing '://' should be URL for .tgz. Otherwise should path of local mupdf checkout. local_tgz: If not None, must be local .tgz file. Returns: (path, location): `path` is absolute path of local directory or .tgz containing MuPDF, or None if we are to use system MuPDF. `location_out` is `location` if not None, else the hard-coded default location. ''' log(f'get_mupdf_internal(): {out=} {location=}') assert out in ('dir', 'tgz') if location is None: location = f'https://mupdf.com/downloads/archive/mupdf-{version_mupdf}-source.tar.gz' #location = 'git:--branch master https://github.com/ArtifexSoftware/mupdf.git' if location == '': # Use system mupdf. return None, location local_dir = None if local_tgz: assert os.path.isfile(local_tgz) elif location.startswith( 'git:'): local_dir = 'mupdf-git' pipcl.git_get(local_dir, text=location, remote='https://github.com/ArtifexSoftware/mupdf.git') # Show sha of checkout. run( f'cd {local_dir} && git show --pretty=oneline|head -n 1', check = False, prefix = 'mupdf git id: ', ) elif '://' in location: # Download .tgz. local_tgz = os.path.basename( location) suffix = '.tar.gz' assert location.endswith(suffix), f'Unrecognised suffix in remote URL {location=}.' name = local_tgz[:-len(suffix)] log( f'Download {location=} {local_tgz=} {name=}') if os.path.exists(local_tgz): try: tar_check(local_tgz, 'r:gz', prefix=f'{name}/') except Exception as e: log(f'Not using existing file {local_tgz} because invalid tar data: {e}') _fs_remove( local_tgz) if os.path.exists(local_tgz): log(f'Not downloading from {location} because already present: {local_tgz!r}') else: log(f'Downloading from {location=} to {local_tgz=}.') urllib.request.urlretrieve( location, local_tgz + '-') os.rename(local_tgz + '-', local_tgz) assert os.path.exists( local_tgz) tar_check( local_tgz, 'r:gz', prefix=f'{name}/') else: assert os.path.isdir(location), f'Local MuPDF does not exist: {location=}' local_dir = location assert bool(local_dir) != bool(local_tgz) if out == 'dir': if not local_dir: assert local_tgz local_dir = tar_extract( local_tgz, exists='return') return os.path.abspath( local_dir), location elif out == 'tgz': if not local_tgz: # Create .tgz containing git files in `local_dir`. assert local_dir if local_dir.endswith( '/'): local_dir = local_dir[:-1] top = os.path.basename(local_dir) local_tgz = f'{local_dir}.tgz' log( f'Creating .tgz from git files. {top=} {local_dir=} {local_tgz=}') _fs_remove( local_tgz) with tarfile.open( local_tgz, 'w:gz') as f: for name in pipcl.git_items( local_dir, submodules=True): path = os.path.join( local_dir, name) if os.path.isfile( path): path2 = f'{top}/{name}' log(f'Adding {path=} {path2=}.') f.add( path, path2, recursive=False) return os.path.abspath( local_tgz), location else: assert 0, f'Unrecognised {out=}' def get_mupdf_tgz(): ''' Creates .tgz file called containing MuPDF source, for inclusion in an sdist. What we do depends on environmental variable PYMUPDF_SETUP_MUPDF_TGZ; see docs at start of this file for details. Returns name of top-level directory within the .tgz file. ''' name, location = get_mupdf_internal( 'tgz', os.environ.get('PYMUPDF_SETUP_MUPDF_TGZ')) return name, location def get_mupdf(path=None, sha=None): ''' Downloads and/or extracts mupdf and returns (path, location) where `path` is the local mupdf directory and `location` is where it came from. Exact behaviour depends on environmental variable PYMUPDF_SETUP_MUPDF_BUILD; see docs at start of this file for details. ''' m = os.environ.get('PYMUPDF_SETUP_MUPDF_BUILD') if m == '-': # This allows easy specification in Github actions. m = None if m is None and os.path.isfile(mupdf_tgz): # This makes us use tgz inside sdist. log(f'Using local tgz: {mupdf_tgz=}') return get_mupdf_internal('dir', local_tgz=mupdf_tgz) return get_mupdf_internal('dir', m) linux = sys.platform.startswith( 'linux') or 'gnu' in sys.platform openbsd = sys.platform.startswith( 'openbsd') freebsd = sys.platform.startswith( 'freebsd') darwin = sys.platform.startswith( 'darwin') windows = platform.system() == 'Windows' or platform.system().startswith('CYGWIN') msys2 = platform.system().startswith('MSYS_NT-') if os.environ.get('PYODIDE') == '1': if os.environ.get('OS') != 'pyodide': log('PYODIDE=1, setting OS=pyodide.') os.environ['OS'] = 'pyodide' pyodide = os.environ.get('OS') == 'pyodide' def build(): ''' pipcl.py `build_fn()` callback. ''' #pipcl.show_sysconfig() if PYMUPDF_SETUP_DUMMY == '1': log(f'{PYMUPDF_SETUP_DUMMY=} Building dummy wheel with no files.') return list() # Download MuPDF. # mupdf_local, mupdf_location = get_mupdf() if mupdf_local: mupdf_version_tuple = get_mupdf_version(mupdf_local) # else we cannot determine version this way and do not use it build_type = os.environ.get( 'PYMUPDF_SETUP_MUPDF_BUILD_TYPE', 'release') assert build_type in ('debug', 'memento', 'release'), \ f'Unrecognised build_type={build_type!r}' overwrite_config = os.environ.get('PYMUPDF_SETUP_MUPDF_OVERWRITE_CONFIG', '1') == '1' PYMUPDF_SETUP_MUPDF_REFCHECK_IF = os.environ.get('PYMUPDF_SETUP_MUPDF_REFCHECK_IF') PYMUPDF_SETUP_MUPDF_TRACE_IF = os.environ.get('PYMUPDF_SETUP_MUPDF_TRACE_IF') # Build MuPDF shared libraries. # if windows: mupdf_build_dir = build_mupdf_windows( mupdf_local, build_type, overwrite_config, g_py_limited_api, PYMUPDF_SETUP_MUPDF_REFCHECK_IF, PYMUPDF_SETUP_MUPDF_TRACE_IF, PYMUPDF_SETUP_FAKE_NOGIL, ) else: if 'p' not in PYMUPDF_SETUP_FLAVOUR and 'b' not in PYMUPDF_SETUP_FLAVOUR: # We only need MuPDF headers, so no point building MuPDF. log(f'Not building MuPDF because not Windows and {PYMUPDF_SETUP_FLAVOUR=}.') mupdf_build_dir = None else: mupdf_build_dir = build_mupdf_unix( mupdf_local, build_type, overwrite_config, g_py_limited_api, PYMUPDF_SETUP_MUPDF_REFCHECK_IF, PYMUPDF_SETUP_MUPDF_TRACE_IF, PYMUPDF_SETUP_SWIG, PYMUPDF_SETUP_FAKE_NOGIL, ) log( f'build(): mupdf_build_dir={mupdf_build_dir!r}') # Build `extra` module. # if 'p' in PYMUPDF_SETUP_FLAVOUR: path_so_leaf = _build_extension( mupdf_local, mupdf_build_dir, build_type, g_py_limited_api, ) else: log(f'Not building extension.') path_so_leaf = None # Generate list of (from, to) items to return to pipcl. What we add depends # on PYMUPDF_SETUP_FLAVOUR. # ret = list() def add(flavour, from_, to_): assert flavour in 'pbd' if flavour in PYMUPDF_SETUP_FLAVOUR: ret.append((from_, to_)) to_dir = 'pymupdf/' to_dir_d = f'{to_dir}/mupdf-devel' # Add implementation files. add('p', f'{g_root}/src/__init__.py', to_dir) add('p', f'{g_root}/src/__main__.py', to_dir) add('p', f'{g_root}/src/pymupdf.py', to_dir) add('p', f'{g_root}/src/table.py', to_dir) add('p', f'{g_root}/src/utils.py', to_dir) add('p', f'{g_root}/src/_wxcolors.py', to_dir) add('p', f'{g_root}/src/_apply_pages.py', to_dir) add('p', f'{g_root}/src/build/extra.py', to_dir) add('p', b'', f'{to_dir}/py.typed') if path_so_leaf: add('p', f'{g_root}/src/build/{path_so_leaf}', to_dir) # Add support for `fitz` backwards compatibility. add('p', f'{g_root}/src/fitz___init__.py', 'fitz/__init__.py') add('p', f'{g_root}/src/fitz_table.py', 'fitz/table.py') add('p', f'{g_root}/src/fitz_utils.py', 'fitz/utils.py') if mupdf_local: # Add MuPDF Python API. add('p', f'{mupdf_build_dir}/mupdf.py', to_dir) # Add MuPDF shared libraries. if windows: wp = pipcl.wdev.WindowsPython() add('p', f'{mupdf_build_dir}/_mupdf.pyd', to_dir) add('b', f'{mupdf_build_dir}/mupdfcpp{wp.cpu.windows_suffix}.dll', to_dir) # Add Windows .lib files. mupdf_build_dir2 = _windows_lib_directory(mupdf_local, build_type) add('d', f'{mupdf_build_dir2}/mupdfcpp{wp.cpu.windows_suffix}.lib', f'{to_dir_d}/lib/') # MuPDF-1.25+ language bindings build also builds libmuthreads. add('d', f'{mupdf_build_dir2}/libmuthreads.lib', f'{to_dir_d}/lib/') elif darwin: add('p', f'{mupdf_build_dir}/_mupdf.so', to_dir) add('b', f'{mupdf_build_dir}/libmupdfcpp.so', to_dir) add('b', f'{mupdf_build_dir}/libmupdf.dylib', to_dir) add('d', f'{mupdf_build_dir}/libmupdf-threads.a', f'{to_dir_d}/lib/') elif pyodide: add('p', f'{mupdf_build_dir}/_mupdf.so', to_dir) add('b', f'{mupdf_build_dir}/libmupdfcpp.so', to_dir) add('b', f'{mupdf_build_dir}/libmupdf.so', to_dir) else: add('p', f'{mupdf_build_dir}/_mupdf.so', to_dir) add('b', pipcl.get_soname(f'{mupdf_build_dir}/libmupdfcpp.so'), to_dir) add('b', pipcl.get_soname(f'{mupdf_build_dir}/libmupdf.so'), to_dir) add('d', f'{mupdf_build_dir}/libmupdf-threads.a', f'{to_dir_d}/lib/') if 'd' in PYMUPDF_SETUP_FLAVOUR: # Add MuPDF C and C++ headers to `ret_d`. Would prefer to use # pipcl.git_items() but hard-coded mupdf tree is not a git # checkout. # for root in ( f'{mupdf_local}/include', f'{mupdf_local}/platform/c++/include', ): for dirpath, dirnames, filenames in os.walk(root): for filename in filenames: if not filename.endswith('.h'): continue header_abs = os.path.join(dirpath, filename) assert header_abs.startswith(root) header_rel = header_abs[len(root)+1:] add('d', f'{header_abs}', f'{to_dir_d}/include/{header_rel}') # Add a .py file containing location of MuPDF. try: sha, comment, diff, branch = git_info(g_root) except Exception as e: log(f'Failed to get git information: {e}') sha, comment, diff, branch = (None, None, None, None) swig = PYMUPDF_SETUP_SWIG or 'swig' swig_version_text = run(f'{swig} -version', capture=1) m = re.search('\nSWIG Version ([^\n]+)', swig_version_text) log(f'{swig_version_text=}') assert m, f'Unrecognised {swig_version_text=}' swig_version = m.group(1) def int_or_0(text): try: return int(text) except Exception: return 0 swig_version_tuple = tuple(int_or_0(i) for i in swig_version.split('.')) version_p_tuple = tuple(int_or_0(i) for i in version_p.split('.')) log(f'{swig_version=}') text = '' text += f'mupdf_location = {mupdf_location!r}\n' text += f'pymupdf_version = {version_p!r}\n' text += f'pymupdf_version_tuple = {version_p_tuple!r}\n' text += f'pymupdf_git_sha = {sha!r}\n' text += f'pymupdf_git_diff = {diff!r}\n' text += f'pymupdf_git_branch = {branch!r}\n' text += f'swig_version = {swig_version!r}\n' text += f'swig_version_tuple = {swig_version_tuple!r}\n' text += f'fake_no_gil = {PYMUPDF_SETUP_FAKE_NOGIL=="1"!r}\n' log(f'_build.py is:\n{textwrap.indent(text, " ")}') add('p', text.encode(), f'{to_dir}/_build.py') # Add single README file. if 'p' in PYMUPDF_SETUP_FLAVOUR: add('p', f'{g_root}/README.md', '$dist-info/README.md') elif 'b' in PYMUPDF_SETUP_FLAVOUR: add('b', f'{g_root}/READMEb.md', '$dist-info/README.md') elif 'd' in PYMUPDF_SETUP_FLAVOUR: add('d', f'{g_root}/READMEd.md', '$dist-info/README.md') return ret def env_add(env, name, value, sep=' ', prepend=False, verbose=False): ''' Appends/prepends `` to `env[name]`. If `name` is not in `env`, we use os.environ[name] if it exists. ''' v = env.get(name) if verbose: log(f'Initally: {name}={v!r}') if v is None: v = os.environ.get(name) if v is None: env[ name] = value else: if prepend: env[ name] = f'{value}{sep}{v}' else: env[ name] = f'{v}{sep}{value}' if verbose: log(f'Returning with {name}={env[name]!r}') def build_mupdf_windows( mupdf_local, build_type, overwrite_config, g_py_limited_api, PYMUPDF_SETUP_MUPDF_REFCHECK_IF, PYMUPDF_SETUP_MUPDF_TRACE_IF, PYMUPDF_SETUP_FAKE_NOGIL, ): assert mupdf_local mupdf_version_tuple = get_mupdf_version(mupdf_local) log(f'{overwrite_config=}') log(f'{mupdf_version_tuple=}') wp = pipcl.wdev.WindowsPython() tesseract = '' if os.environ.get('PYMUPDF_SETUP_MUPDF_TESSERACT') == '0' else 'tesseract-' windows_build_tail = f'build\\shared-{tesseract}{build_type}' if overwrite_config: if mupdf_version_tuple >= (1, 28): # Tell mupdf build to use, for example, `/Build "ReleaseTofuCjkExt|x64"`. # This avoids the need for us to modify mupdf's config.h. windows_build_tail += '-TOFU_CJK_EXT' log(f'Appending, {windows_build_tail=}') else: log(f'modifying mupdf:include/mupdf/fitz/config.h') mupdf_config_h = f'{mupdf_local}/include/mupdf/fitz/config.h' prefix = '#define TOFU_CJK_EXT 1 /* PyMuPDF override. */\n' with open(mupdf_config_h) as f: text = f.read() if text.startswith(prefix): log(f'Not modifying {mupdf_config_h} because already has prefix {prefix!r}.') else: log(f'Prefixing {mupdf_config_h} with {prefix!r}.') text = prefix + text st = os.stat(mupdf_config_h) with open(mupdf_config_h, 'w') as f: f.write(text) os.utime(mupdf_config_h, (st.st_atime, st.st_mtime)) if g_py_limited_api: windows_build_tail += f'-Py_LIMITED_API_{pipcl.current_py_limited_api()}' if PYMUPDF_SETUP_FAKE_NOGIL == '1': windows_build_tail += '-nogil' windows_build_tail += f'-x{wp.cpu.bits}-py{wp.version}' windows_build_dir = f'{mupdf_local}\\{windows_build_tail}' #log( f'Building mupdf.') devenv = os.environ.get('PYMUPDF_SETUP_DEVENV') if not devenv: try: # Prefer VS-2022 as that is what Github provide in windows-2022. log(f'Looking for Visual Studio 2022.') vs = pipcl.wdev.WindowsVS(year=2022) except Exception as e: log(f'Failed to find VS-2022:\n' f'{textwrap.indent(traceback.format_exc(), " ")}' ) log(f'Looking for any Visual Studio.') vs = pipcl.wdev.WindowsVS() log(f'vs:\n{vs.description_ml(" ")}') devenv = vs.devenv if not devenv: devenv = 'devenv.com' log( f'Cannot find devenv.com in default locations, using: {devenv!r}') command = f'cd "{mupdf_local}" && "{sys.executable}" ./scripts/mupdfwrap.py' if os.environ.get('PYMUPDF_SETUP_MUPDF_VS_UPGRADE') == '1': command += ' --vs-upgrade 1' # Would like to simply do f'... --devenv {shutil.quote(devenv)}', but # it looks like if `devenv` has spaces then `shutil.quote()` puts it # inside single quotes, which then appear to be ignored when run by # subprocess.run(). # # So instead we strip any enclosing quotes and the enclose with # double-quotes. # if len(devenv) >= 2: for q in '"', "'": if devenv.startswith( q) and devenv.endswith( q): devenv = devenv[1:-1] command += f' -d {windows_build_tail}' command += f' -b' if PYMUPDF_SETUP_MUPDF_REFCHECK_IF: command += f' --refcheck-if "{PYMUPDF_SETUP_MUPDF_REFCHECK_IF}"' if PYMUPDF_SETUP_MUPDF_TRACE_IF: command += f' --trace-if "{PYMUPDF_SETUP_MUPDF_TRACE_IF}"' command += f' --devenv "{devenv}"' command += f' all' if os.environ.get( 'PYMUPDF_SETUP_MUPDF_REBUILD') == '0': log( f'PYMUPDF_SETUP_MUPDF_REBUILD is "0" so not building MuPDF; would have run: {command}') else: log( f'Building MuPDF by running: {command}') subprocess.run( command, shell=True, check=True) log( f'Finished building mupdf.') return windows_build_dir def _windows_lib_directory(mupdf_local, build_type): ret = f'{mupdf_local}/platform/win32/' if _cpu_bits() == 64: ret += 'x64/' if build_type == 'release': ret += 'Release/' elif build_type == 'debug': ret += 'Debug/' else: assert 0, f'Unrecognised {build_type=}.' return ret def _cpu_bits(): if sys.maxsize == 2**31 - 1: return 32 return 64 def build_mupdf_unix( mupdf_local, build_type, overwrite_config, g_py_limited_api, PYMUPDF_SETUP_MUPDF_REFCHECK_IF, PYMUPDF_SETUP_MUPDF_TRACE_IF, PYMUPDF_SETUP_SWIG, PYMUPDF_SETUP_FAKE_NOGIL, ): ''' Builds MuPDF. Args: mupdf_local: Path of MuPDF directory or None if we are using system MuPDF. Returns the absolute path of build directory within MuPDF, e.g. `.../mupdf/build/pymupdf-shared-release`, or `None` if we are using the system MuPDF. ''' if not mupdf_local: log( f'Using system mupdf.') return None env = dict() if overwrite_config: # By predefining TOFU_CJK_EXT here, we don't need to modify # MuPDF's include/mupdf/fitz/config.h. log( f'Setting XCFLAGS and XCXXFLAGS to predefine TOFU_CJK_EXT.') env_add(env, 'XCFLAGS', '-DTOFU_CJK_EXT') env_add(env, 'XCXXFLAGS', '-DTOFU_CJK_EXT') if openbsd or freebsd: env_add(env, 'CXX', 'c++', ' ') if darwin and os.environ.get('GITHUB_ACTIONS') == 'true': if os.environ.get('ImageOS') == 'macos13': # On Github macos13 we need to use Clang/LLVM (Homebrew) 15.0.7, # otherwise mupdf:thirdparty/tesseract/src/api/baseapi.cpp fails to # compile with: # # thirdparty/tesseract/src/api/baseapi.cpp:150:25: error: 'recursive_directory_iterator' is unavailable: introduced in macOS 10.15 # # See: # https://github.com/actions/runner-images/blob/main/images/macos/macos-13-Readme.md # log(f'Using llvm@15 clang and clang++') cl15 = pipcl.run(f'brew --prefix llvm@15', capture=1) log(f'{cl15=}') cl15 = cl15.strip() pipcl.run(f'ls -lL {cl15}') pipcl.run(f'ls -lL {cl15}/bin') cc = f'{cl15}/bin/clang' cxx = f'{cl15}/bin/clang++' env['CC'] = cc env['CXX'] = cxx # Show compiler versions. cc = env.get('CC', 'cc') cxx = env.get('CXX', 'c++') pipcl.run(f'{cc} --version') pipcl.run(f'{cxx} --version') # Add extra flags for MacOS cross-compilation, where ARCHFLAGS can be # '-arch arm64'. # archflags = os.environ.get( 'ARCHFLAGS') if archflags: env_add(env, 'XCFLAGS', archflags) env_add(env, 'XLIBS', archflags) mupdf_version_tuple = get_mupdf_version(mupdf_local) # We specify a build directory path containing 'pymupdf' so that we # coexist with non-PyMuPDF builds (because PyMuPDF builds have a # different config.h). # # We also append further text to try to allow different builds to # work if they reuse the mupdf directory. # # Using platform.machine() (e.g. 'amd64') ensures that different # builds of mupdf on a shared filesystem can coexist. Using # $_PYTHON_HOST_PLATFORM allows cross-compiled cibuildwheel builds # to coexist, e.g. on github. # # Have experimented with looking at getconf_ARG_MAX to decide whether to # omit `PyMuPDF-` from the build directory, to avoid command-too-long # errors with mupdf-1.26. But it seems that `getconf ARG_MAX` returns # a system limit, not the actual limit of the current shell, and there # doesn't seem to be a way to find the current shell's limit. # # Avoid link command length problems seen on musllinux. build_prefix = '' if pyodide: build_prefix += 'pyodide-' else: build_prefix += f'{platform.machine()}-' build_prefix_extra = os.environ.get( '_PYTHON_HOST_PLATFORM') if build_prefix_extra: build_prefix += f'{build_prefix_extra}-' build_prefix += 'shared-' if msys2: # Error in mupdf/scripts/tesseract/endianness.h: # #error "I don't know what architecture this is!" log(f'msys2: building MuPDF without tesseract.') elif os.environ.get('PYMUPDF_SETUP_MUPDF_TESSERACT') == '0': log(f'PYMUPDF_SETUP_MUPDF_TESSERACT=0 so building mupdf without tesseract.') else: build_prefix += 'tesseract-' if ( linux and os.environ.get('PYMUPDF_SETUP_MUPDF_BSYMBOLIC', '1') == '1' ): log(f'Appending `bsymbolic-` to MuPDF build path.') build_prefix += 'bsymbolic-' log(f'{g_py_limited_api=}') if g_py_limited_api: build_prefix += f'Py_LIMITED_API_{pipcl.current_py_limited_api()}-' if PYMUPDF_SETUP_FAKE_NOGIL == '1': build_prefix += 'nogil-' unix_build_dir = f'{mupdf_local}/build/{build_prefix}{build_type}' PYMUPDF_SETUP_MUPDF_CLEAN = os.environ.get('PYMUPDF_SETUP_MUPDF_CLEAN') if PYMUPDF_SETUP_MUPDF_CLEAN == '1': log(f'{PYMUPDF_SETUP_MUPDF_CLEAN=}, deleting {unix_build_dir=}.') shutil.rmtree(unix_build_dir, ignore_errors=1) # We need MuPDF's Python bindings, so we build MuPDF with # `mupdf/scripts/mupdfwrap.py` instead of running `make`. # command = f'cd {mupdf_local} &&' for n, v in env.items(): command += f' {n}={shlex.quote(v)}' command += f' {sys.executable} ./scripts/mupdfwrap.py' if PYMUPDF_SETUP_SWIG: command += f' --swig {shlex.quote(PYMUPDF_SETUP_SWIG)}' command += f' -d build/{build_prefix}{build_type} -b' if sys.implementation.name == 'graalpy': # Force rerun of swig. pipcl.run(f'ls -l {mupdf_local}/platform/python/') for p in glob.glob(f'{mupdf_local}/platform/python/mupdfcpp*.i.cpp'): pipcl.log(f'Graal, deleting: {p!r}') pipcl.fs_remove(p) if PYMUPDF_SETUP_MUPDF_REFCHECK_IF: command += f' --refcheck-if "{PYMUPDF_SETUP_MUPDF_REFCHECK_IF}"' if PYMUPDF_SETUP_MUPDF_TRACE_IF: command += f' --trace-if "{PYMUPDF_SETUP_MUPDF_TRACE_IF}"' if 'p' in PYMUPDF_SETUP_FLAVOUR: command += ' all' else: command += ' m01' # No need for C++/Python bindings. command += f' && echo {unix_build_dir}:' command += f' && ls -l {unix_build_dir}' if os.environ.get( 'PYMUPDF_SETUP_MUPDF_REBUILD') == '0': log( f'PYMUPDF_SETUP_MUPDF_REBUILD is "0" so not building MuPDF; would have run: {command}') else: log( f'Building MuPDF by running: {command}') subprocess.run( command, shell=True, check=True) log( f'Finished building mupdf.') return unix_build_dir def get_mupdf_version(mupdf_dir): path = f'{mupdf_dir}/include/mupdf/fitz/version.h' with open(path) as f: text = f.read() v0 = re.search('#define FZ_VERSION_MAJOR ([0-9]+)', text) v1 = re.search('#define FZ_VERSION_MINOR ([0-9]+)', text) v2 = re.search('#define FZ_VERSION_PATCH ([0-9]+)', text) assert v0 and v1 and v2, f'Cannot find MuPDF version numbers in {path=}.' v0 = int(v0.group(1)) v1 = int(v1.group(1)) v2 = int(v2.group(1)) return v0, v1, v2 def _fs_update(text, path): try: with open( path) as f: text0 = f.read() except OSError: text0 = None print(f'path={path!r} text==text0={text==text0!r}') if text != text0: with open( path, 'w') as f: f.write( text) def _build_extension( mupdf_local, mupdf_build_dir, build_type, g_py_limited_api): ''' Builds Python extension module `_extra`. Returns leafname of the generated shared libraries within mupdf_build_dir. ''' (compiler_extra, linker_extra, includes, defines, optimise, debug, libpaths, libs, libraries) \ = _extension_flags( mupdf_local, mupdf_build_dir, build_type) log(f'_build_extension(): {g_py_limited_api=} {defines=}') if mupdf_local: includes = ( f'{mupdf_local}/platform/c++/include', f'{mupdf_local}/include', ) log('Building PyMuPDF extension.') compile_extra_cpp = '' if darwin: # Avoids `error: cannot pass object of non-POD type # 'std::nullptr_t' through variadic function; call will abort at # runtime` when compiling `mupdf::pdf_dict_getl(..., nullptr)`. compile_extra_cpp += ' -Wno-non-pod-varargs' # Avoid errors caused by mupdf's C++ bindings' exception classes # not having `nothrow` to match the base exception class. compile_extra_cpp += ' -std=c++14' if windows: wp = pipcl.wdev.WindowsPython() libs = f'mupdfcpp{wp.cpu.windows_suffix}.lib' else: libs = ('mupdf', 'mupdfcpp') libraries = [ f'{mupdf_build_dir}/libmupdf.so' f'{mupdf_build_dir}/libmupdfcpp.so' ] path_so_leaf = pipcl.build_extension( name = 'extra', path_i = f'{g_root}/src/extra.i', outdir = f'{g_root}/src/build', includes = includes, defines = defines, libpaths = libpaths, libs = libs, compiler_extra = compiler_extra + compile_extra_cpp, linker_extra = linker_extra, optimise = optimise, debug = debug, prerequisites_swig = None, prerequisites_compile = f'{mupdf_local}/include', prerequisites_link = libraries, py_limited_api = g_py_limited_api, swig = PYMUPDF_SETUP_SWIG, nogil = (PYMUPDF_SETUP_FAKE_NOGIL=='1') ) return path_so_leaf def _extension_flags( mupdf_local, mupdf_build_dir, build_type): ''' Returns various flags to pass to pipcl.build_extension(). ''' compiler_extra = '' linker_extra = '' if build_type == 'memento': compiler_extra += ' -DMEMENTO' if mupdf_build_dir: mupdf_build_dir_flags = os.path.basename( mupdf_build_dir).split( '-') else: mupdf_build_dir_flags = [build_type] optimise = 'release' in mupdf_build_dir_flags debug = 'debug' in mupdf_build_dir_flags r_extra = '' defines = list() if windows: defines.append('FZ_DLL_CLIENT') wp = pipcl.wdev.WindowsPython() if os.environ.get('PYMUPDF_SETUP_MUPDF_VS_UPGRADE') == '1': # MuPDF C++ build uses a parallel build tree with updated VS files. infix = 'win32-vs-upgrade' else: infix = 'win32' build_type_infix = 'Debug' if debug else 'Release' libpaths = ( f'{mupdf_local}\\platform\\{infix}\\{wp.cpu.windows_subdir}{build_type_infix}', f'{mupdf_local}\\platform\\{infix}\\{wp.cpu.windows_subdir}{build_type_infix}Tesseract', ) libs = f'mupdfcpp{wp.cpu.windows_suffix}.lib' libraries = f'{mupdf_local}\\platform\\{infix}\\{wp.cpu.windows_subdir}{build_type_infix}\\{libs}' compiler_extra = '' else: libs = ['mupdf'] compiler_extra += ( ' -Wall' ' -Wno-deprecated-declarations' ' -Wno-unused-const-variable' ) if mupdf_local: libpaths = (mupdf_build_dir,) libraries = f'{mupdf_build_dir}/{libs[0]}' if openbsd: compiler_extra += ' -Wno-deprecated-declarations' else: libpaths = os.environ.get('PYMUPDF_MUPDF_LIB') libraries = None if libpaths: libpaths = libpaths.split(':') if mupdf_local: includes = ( f'{mupdf_local}/include', f'{mupdf_local}/include/mupdf', f'{mupdf_local}/thirdparty/freetype/include', ) else: # Use system MuPDF. includes = list() pi = os.environ.get('PYMUPDF_INCLUDES') if pi: includes += pi.split(':') pmi = os.environ.get('PYMUPDF_MUPDF_INCLUDE') if pmi: includes.append(pmi) ldflags = os.environ.get('LDFLAGS') if ldflags: linker_extra += f' {ldflags}' cflags = os.environ.get('CFLAGS') if cflags: compiler_extra += f' {cflags}' cxxflags = os.environ.get('CXXFLAGS') if cxxflags: compiler_extra += f' {cxxflags}' return compiler_extra, linker_extra, includes, defines, optimise, debug, libpaths, libs, libraries, def clean(all_): pipcl.log(f'{all_=}') ret = list() ret.append(f'{g_root}/src/build') path_mupdf, _ = get_mupdf() # We remove mupdf directories directly with shutil.rmtree() instead of # returning them to pipcl, because pipcl will deliberately fail if asked to # remove things that are outside our checkout. shutil.rmtree(f'{path_mupdf}/platform/c++', ignore_errors=True) shutil.rmtree(f'{path_mupdf}/platform/python', ignore_errors=True) if all_: # Clean mupdf C library. shutil.rmtree(f'{path_mupdf}/build', ignore_errors=True) shutil.rmtree(f'{path_mupdf}/platform/win32', ignore_errors=True) shutil.rmtree(f'{path_mupdf}/platform/win32/Release', ignore_errors=True) shutil.rmtree(f'{path_mupdf}/platform/win32/x64', ignore_errors=True) pipcl.log(f'Returning: {ret=}') return ret def sdist(): ret = list() if PYMUPDF_SETUP_DUMMY == '1': return ret if PYMUPDF_SETUP_FLAVOUR == 'b': # Create a minimal sdist that will build/install a dummy PyMuPDFb. for p in ( 'setup.py', 'pipcl.py', 'wdev.py', 'pyproject.toml', ): ret.append(p) ret.append( ( b'This file indicates that we are a PyMuPDFb sdist and should build/install a dummy PyMuPDFb package.\n', g_pymupdfb_sdist_marker, ) ) return ret for p in pipcl.git_items( g_root): if p.startswith( ( 'docs/', 'signatures/', '.', ) ): pass else: ret.append(p) if 0: tgz, mupdf_location = get_mupdf_tgz() if tgz: ret.append((tgz, mupdf_tgz)) else: log(f'Not including MuPDF .tgz in sdist.') return ret classifier = [ 'Development Status :: 5 - Production/Stable', 'Intended Audience :: Developers', 'Intended Audience :: Information Technology', 'Operating System :: MacOS', 'Operating System :: Microsoft :: Windows', 'Operating System :: POSIX :: Linux', 'Programming Language :: C', 'Programming Language :: C++', 'Programming Language :: Python :: 3 :: Only', 'Programming Language :: Python :: Implementation :: CPython', 'Topic :: Utilities', 'Topic :: Multimedia :: Graphics', 'Topic :: Software Development :: Libraries', ] # We generate different wheels depending on PYMUPDF_SETUP_FLAVOUR. # # PyMuPDF version. version_p = '1.27.2.3' version_mupdf = '1.27.2' # PyMuPDFb version. This is the PyMuPDF version whose PyMuPDFb wheels we will # (re)use if generating separate PyMuPDFb wheels. Though as of PyMuPDF-1.24.11 # (2024-10-03) we no longer use PyMuPDFb wheels so this is actually unused. # version_b = '1.26.3' if os.path.exists(f'{g_root}/{g_pymupdfb_sdist_marker}'): # We are in a PyMuPDFb sdist. We specify a dummy package so that pip builds # from sdists work - pip's build using PyMuPDF's sdist will already create # the required binaries, but pip will still see `requires_dist` set to # 'PyMuPDFb', so will also download and build PyMuPDFb's sdist. # log(f'Specifying dummy PyMuPDFb wheel.') def get_requires_for_build_wheel(config_settings=None): return list() p = pipcl.Package( 'PyMuPDFb', version_b, summary = 'Dummy PyMuPDFb wheel', description = '', author = 'Artifex', author_email = 'support@artifex.com', license = 'GNU AFFERO GPL 3.0', tag_python = 'py3', ) else: # A normal PyMuPDF package. with open( f'{g_root}/README.md', encoding='utf-8') as f: readme_p = f.read() with open( f'{g_root}/READMEb.md', encoding='utf-8') as f: readme_b = f.read() with open( f'{g_root}/READMEd.md', encoding='utf-8') as f: readme_d = f.read() tag_python = None requires_dist = list() entry_points = None if 'p' in PYMUPDF_SETUP_FLAVOUR: version = version_p name = 'PyMuPDF' readme = readme_p summary = 'A high performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.' if 'b' not in PYMUPDF_SETUP_FLAVOUR: requires_dist.append(f'PyMuPDFb =={version_b}') # Create a `pymupdf` command. entry_points = textwrap.dedent(''' [console_scripts] pymupdf = pymupdf.__main__:main ''') elif 'b' in PYMUPDF_SETUP_FLAVOUR: version = version_b name = 'PyMuPDFb' readme = readme_b summary = 'MuPDF shared libraries for PyMuPDF.' tag_python = 'py3' elif 'd' in PYMUPDF_SETUP_FLAVOUR: version = version_b name = 'PyMuPDFd' readme = readme_d summary = 'MuPDF build-time files for PyMuPDF.' tag_python = 'py3' else: assert 0, f'Unrecognised {PYMUPDF_SETUP_FLAVOUR=}.' if os.environ.get('PYODIDE_ROOT'): # We can't pip install pytest on pyodide, so specify it here. requires_dist.append('pytest') p = pipcl.Package( name, version, summary = summary, description = readme, description_content_type = 'text/markdown', classifier = classifier, author = 'Artifex', author_email = 'support@artifex.com', requires_dist = requires_dist, requires_python = '>=3.10', license = 'Dual Licensed - GNU AFFERO GPL 3.0 or Artifex Commercial License', project_url = [ ('Documentation, https://pymupdf.readthedocs.io/'), ('Source, https://github.com/pymupdf/pymupdf'), ('Tracker, https://github.com/pymupdf/PyMuPDF/issues'), ('Changelog, https://pymupdf.readthedocs.io/en/latest/changes.html'), ], entry_points = entry_points, fn_build=build, fn_clean=clean, fn_sdist=sdist, tag_python=tag_python, py_limited_api=g_py_limited_api, # 30MB: 9 ZIP_DEFLATED # 28MB: 9 ZIP_BZIP2 # 23MB: 9 ZIP_LZMA #wheel_compression = zipfile.ZIP_DEFLATED if (darwin or pyodide) else zipfile.ZIP_LZMA, wheel_compresslevel = 9, ) def get_requires_for_build_wheel(config_settings=None): ''' Adds to pyproject.toml:[build-system]:requires, allowing programmatic control over what packages we require. ''' def platform_release_tuple(): r = platform.release() r = r.split('.') r = tuple(int(i) for i in r) log(f'platform_release_tuple() returning {r=}.') return r ret = list() libclang = os.environ.get('PYMUPDF_SETUP_LIBCLANG') if libclang: print(f'Overriding to use {libclang=}.') ret.append(libclang) elif openbsd: print(f'OpenBSD: libclang not available via pip; assuming `pkg_add py3-llvm`.') elif darwin and platform_release_tuple() < (18,): # There are still of problems when building on old macos. ret.append('libclang==14.0.6') else: ret.append('libclang') if msys2: print(f'msys2: pip install of swig does not build; assuming `pacman -S swig`.') elif openbsd: print(f'OpenBSD: pip install of swig does not build; assuming `pkg_add swig`.') elif PYMUPDF_SETUP_SWIG: pass elif darwin and python_version_tuple < (3, 13): # Latest swig-4.4.1 gives director errors on macos with python<3.13. ret.append('swig==4.3.1') else: ret.append('swig') return ret if PYMUPDF_SETUP_URL_WHEEL: def build_wheel( wheel_directory, config_settings=None, metadata_directory=None, p=p, ): ''' Instead of building wheel, we look for and copy a wheel from location specified by PYMUPDF_SETUP_URL_WHEEL. ''' log(f'{PYMUPDF_SETUP_URL_WHEEL=}') log(f'{p.wheel_name()=}') url = PYMUPDF_SETUP_URL_WHEEL if url.startswith(('http://', 'https://')): leaf = p.wheel_name() out_path = f'{wheel_directory}{leaf}' out_path_temp = out_path + '-' if url.endswith('/'): url += leaf log(f'Downloading from {url=} to {out_path_temp=}.') urllib.request.urlretrieve(url, out_path_temp) elif url.startswith(f'file://'): in_path = url[len('file://'):] log(f'{in_path=}') if in_path.endswith('/'): # Look for matching wheel within this directory. wheels = glob.glob(f'{in_path}*.whl') log(f'{len(wheels)=}') for in_path in wheels: log(f'{in_path=}') leaf = os.path.basename(in_path) if p.wheel_name_match(leaf): log(f'Match: {in_path=}') break else: message = f'Cannot find matching for {p.wheel_name()=} in ({len(wheels)=}):\n' wheels_text = '' for wheel in wheels: wheels_text += f' {wheel}\n' assert 0, f'Cannot find matching for {p.wheel_name()=} in:\n{wheels_text}' else: leaf = os.path.basename(in_path) out_path = os.path.join(wheel_directory, leaf) out_path_temp = out_path + '-' log(f'Copying from {in_path=} to {out_path_temp=}.') shutil.copy2(in_path, out_path_temp) else: assert 0, f'Unrecognised prefix in {PYMUPDF_SETUP_URL_WHEEL=}.' log(f'Renaming from:\n {out_path_temp}\nto:\n {out_path}.') os.rename(out_path_temp, out_path) return os.path.basename(out_path) else: build_wheel = p.build_wheel build_sdist = p.build_sdist if __name__ == '__main__': p.handle_argv(sys.argv) ================================================ FILE: src/__init__.py ================================================ ''' PyMuPDF implemented on top of MuPDF Python bindings. License: SPDX-License-Identifier: GPL-3.0-only ''' from __future__ import annotations # To reduce startup times, we don't import everything we require here. # import atexit import binascii import collections import glob import importlib.util import inspect import io import math import os import pathlib import re import string import sys import tarfile import time import typing import warnings import weakref import zipfile from . import extra # Set up g_out_log and g_out_message from environment variables. # # PYMUPDF_MESSAGE controls the destination of user messages (from function # `pymupdf.message()`). # # PYMUPDF_LOG controls the destination of internal development logging (from # function `pymupdf.log()`). # # For syntax, see _make_output()'s `text` arg. # def _make_output( *, text=None, fd=None, stream=None, path=None, path_append=None, pylogging=None, pylogging_logger=None, pylogging_level=None, pylogging_name=None, default=None, ): ''' Returns a stream that writes to a specified destination, which can be a file descriptor, a file, an existing stream or Python's `logging' system. Args: text: text specification of destination. fd: - write to file descriptor. path: - write to file. path+: - append to file. logging: - write to Python `logging` module. items: comma-separated pairs. level= name=. Other names are ignored. fd: an int file descriptor. stream: something with methods .write(text) and .flush(). If specified we simply return . path: a file path. If specified we return a stream that writes to this file. path_append: a file path. If specified we return a stream that appends to this file. pylogging*: if any of these args is not None, we return a stream that writes to Python's `logging` module. pylogging: Unused other than to activate use of logging module. pylogging_logger: A logging.Logger; If None, set from . pylogging_level: An int log level, if None we use pylogging_logger.getEffectiveLevel(). pylogging_name: Only used if is None: If is None, we set it to 'pymupdf'. Then we do: pylogging_logger = logging.getLogger(pylogging_name) ''' if text is not None: # Textual specification, for example from from environment variable. if text.startswith('fd:'): fd = int(text[3:]) elif text.startswith('path:'): path = text[5:] elif text.startswith('path+'): path_append = text[5:] elif text.startswith('logging:'): pylogging = True items_d = dict() items = text[8:].split(',') #items_d = {n: v for (n, v) in [item.split('=', 1) for item in items]} for item in items: if not item: continue nv = item.split('=', 1) assert len(nv) == 2, f'Need `=` in {item=}.' n, v = nv items_d[n] = v pylogging_level = items_d.get('level') if pylogging_level is not None: pylogging_level = int(pylogging_level) pylogging_name = items_d.get('name', 'pymupdf') else: assert 0, f'Expected prefix `fd:`, `path:`. `path+:` or `logging:` in {text=}.' if fd is not None: ret = io.open(fd, mode='w', closefd=False) elif stream is not None: assert hasattr(stream, 'write') assert hasattr(stream, 'flush') ret = stream elif path is not None: ret = io.open(path, 'w') elif path_append is not None: ret = io.open(path_append, 'a') elif (0 or pylogging is not None or pylogging_logger is not None or pylogging_level is not None or pylogging_name is not None ): import logging if pylogging_logger is None: if pylogging_name is None: pylogging_name = 'pymupdf' pylogging_logger = logging.getLogger(pylogging_name) assert isinstance(pylogging_logger, logging.Logger) if pylogging_level is None: pylogging_level = pylogging_logger.getEffectiveLevel() class Out: def write(self, text): # `logging` module appends newlines, but so does the `print()` # functions in our caller message() and log() fns, so we need to # remove them here. text = text.rstrip('\n') if text: pylogging_logger.log(pylogging_level, text) def flush(self): pass ret = Out() else: ret = default return ret # Set steam used by PyMuPDF messaging. _g_out_message = _make_output(text=os.environ.get('PYMUPDF_MESSAGE'), default=sys.stdout) # Set steam used by PyMuPDF development/debugging logging. _g_out_log = _make_output(text=os.environ.get('PYMUPDF_LOG'), default=sys.stdout) # Things for testing logging. _g_log_items = list() _g_log_items_active = False def _log_items(): return _g_log_items def _log_items_active(active): global _g_log_items_active _g_log_items_active = active def _log_items_clear(): del _g_log_items[:] def set_messages( *, text=None, fd=None, stream=None, path=None, path_append=None, pylogging=None, pylogging_logger=None, pylogging_level=None, pylogging_name=None, ): ''' Sets destination of PyMuPDF messages. See _make_output() for details. ''' global _g_out_message _g_out_message = _make_output( text=text, fd=fd, stream=stream, path=path, path_append=path_append, pylogging=pylogging, pylogging_logger=pylogging_logger, pylogging_level=pylogging_level, pylogging_name=pylogging_name, default=_g_out_message, ) def set_log( *, text=None, fd=None, stream=None, path=None, path_append=None, pylogging=None, pylogging_logger=None, pylogging_level=None, pylogging_name=None, ): ''' Sets destination of PyMuPDF development/debugging logging. See _make_output() for details. ''' global _g_out_log _g_out_log = _make_output( text=text, fd=fd, stream=stream, path=path, path_append=path_append, pylogging=pylogging, pylogging_logger=pylogging_logger, pylogging_level=pylogging_level, pylogging_name=pylogging_name, default=_g_out_log, ) def log( text='', caller=1): ''' For development/debugging diagnostics. ''' try: stack = inspect.stack(context=0) except StopIteration: pass else: frame_record = stack[caller] try: filename = os.path.relpath(frame_record.filename) except Exception: # Can fail on windows. filename = frame_record.filename line = frame_record.lineno function = frame_record.function text = f'{filename}:{line}:{function}(): {text}' del stack # Leaving to be garbage collected, appears to change behaviour. if _g_log_items_active: _g_log_items.append(text) if _g_out_log: print(text, file=_g_out_log, flush=1) def message(text=''): ''' For user messages. ''' # It looks like `print()` does nothing if sys.stdout is None (without # raising an exception), but we don't rely on this. if _g_out_message: print(text, file=_g_out_message, flush=1) def exception_info(): import traceback log(f'exception_info:') log(traceback.format_exc()) # PDF names must not contain these characters: INVALID_NAME_CHARS = set(string.whitespace + "()<>[]{}/%" + chr(0)) def get_env_bool( name, default): ''' Returns `True`, `False` or `default` depending on whether $ is '1', '0' or unset. Otherwise assert-fails. ''' v = os.environ.get( name) if v is None: ret = default elif v == '1': ret = True elif v == '0': ret = False else: assert 0, f'Unrecognised value for {name}: {v!r}' if ret != default: log(f'Using non-default setting from {name}: {v!r}') return ret def get_env_int( name, default): ''' Returns `True`, `False` or `default` depending on whether $ is '1', '0' or unset. Otherwise assert-fails. ''' v = os.environ.get( name) if v is None: ret = default else: ret = int(v) if ret != default: log(f'Using non-default setting from {name}: {v}') return ret # All our `except ...` blocks output diagnostics if `g_exceptions_verbose` is # true. g_exceptions_verbose = get_env_int( 'PYMUPDF_EXCEPTIONS_VERBOSE', 1) # $PYMUPDF_USE_EXTRA overrides whether to use optimised C fns in `extra`. # g_use_extra = get_env_bool( 'PYMUPDF_USE_EXTRA', True) # Global switches # class _Globals: def __init__(self): self.no_device_caching = 0 self.small_glyph_heights = 0 self.subset_fontnames = 0 self.skip_quad_corrections = 0 _globals = _Globals() _get_layout: typing.Optional[typing.Callable] = None # global switch ensuring that the recommendation message is shown at most once _recommend_layout = True # must be referred to as "global" everywhere def no_recommend_layout(): """For users who never want to see the layout recommendation.""" global _recommend_layout _recommend_layout = False def _warn_layout_once(): """Check if we should recommend installing the layout package.""" msg="""Consider using the pymupdf_layout package for a greatly improved page layout analysis.""" global _recommend_layout if ( 1 and _recommend_layout # still True? and _get_layout is None # no layout function stored here # client did not globally disable the recommendation and os.getenv("PYMUPDF_SUGGEST_LAYOUT_ANALYZER") != "0" # layout is not available in this Python and not importlib.util.find_spec("pymupdf.layout") ): print(msg) _recommend_layout = False # never show the message again # Optionally use MuPDF via cppyy bindings; experimental and not tested recently # as of 2023-01-20 11:51:40 # mupdf_cppyy = os.environ.get( 'MUPDF_CPPYY') if mupdf_cppyy is not None: # pylint: disable=all log( f'{__file__}: $MUPDF_CPPYY={mupdf_cppyy!r} so attempting to import mupdf_cppyy.') log( f'{__file__}: $PYTHONPATH={os.environ["PYTHONPATH"]}') if mupdf_cppyy == '': import mupdf_cppyy else: import importlib mupdf_cppyy = importlib.machinery.SourceFileLoader( 'mupdf_cppyy', mupdf_cppyy ).load_module() mupdf = mupdf_cppyy.cppyy.gbl.mupdf else: # Use MuPDF Python SWIG bindings. We allow import from either our own # directory for conventional wheel installs, or from separate place in case # we are using a separately-installed system installation of mupdf. # try: from . import mupdf except Exception: import mupdf if hasattr(mupdf, 'internal_check_ndebug'): mupdf.internal_check_ndebug() mupdf.reinit_singlethreaded() def _int_rc(text): ''' Converts string to int, ignoring trailing 'rc...'. ''' rc = text.find('rc') if rc >= 0: text = text[:rc] return int(text) # Basic version information. # # (We use `noqa F401` to avoid flake8 errors such as `F401 # '._build.mupdf_location' imported but unused`. # from ._build import mupdf_location # noqa F401 from ._build import pymupdf_git_branch # noqa F401 from ._build import pymupdf_git_diff # noqa F401 from ._build import pymupdf_git_sha # noqa F401 from ._build import pymupdf_version # noqa F401 from ._build import pymupdf_version_tuple # noqa F401 from ._build import swig_version # noqa F401 from ._build import swig_version_tuple # noqa F401 mupdf_version = mupdf.FZ_VERSION # Removed in PyMuPDF-1.26.1. pymupdf_date = None # Versions as tuples; useful when comparing versions. # mupdf_version_tuple = tuple( [_int_rc(i) for i in mupdf_version.split('.')]) assert mupdf_version_tuple == (mupdf.FZ_VERSION_MAJOR, mupdf.FZ_VERSION_MINOR, mupdf.FZ_VERSION_PATCH), \ f'Inconsistent MuPDF version numbers: {mupdf_version_tuple=} != {(mupdf.FZ_VERSION_MAJOR, mupdf.FZ_VERSION_MINOR, mupdf.FZ_VERSION_PATCH)=}' # Legacy version information. # version = (pymupdf_version, mupdf_version, None) VersionFitz = mupdf_version VersionBind = pymupdf_version VersionDate = None # String formatting. def _format_g(value, *, fmt='%g'): ''' Returns `value` formatted with mupdf.fz_format_double() if available, otherwise with Python's `%`. If `value` is a list or tuple, we return a space-separated string of formatted values. ''' if isinstance(value, (list, tuple)): ret = '' for v in value: if ret: ret += ' ' ret += _format_g(v, fmt=fmt) return ret else: return mupdf.fz_format_double(fmt, value) format_g = _format_g # ByteString is gone from typing in 3.14. # collections.abc.Buffer available from 3.12 only try: ByteString = typing.ByteString except AttributeError: ByteString = bytes | bytearray | memoryview # Names required by class method typing annotations. OptBytes = typing.Optional[ByteString] OptDict = typing.Optional[dict] OptFloat = typing.Optional[float] OptInt = typing.Union[int, None] OptSeq = typing.Optional[typing.Sequence] OptStr = typing.Optional[str] matrix_like = 'matrix_like' point_like = 'point_like' quad_like = 'quad_like' rect_like = 'rect_like' def _as_fz_document(document): ''' Returns document as a mupdf.FzDocument, upcasting as required. Raises 'document closed' exception if closed. ''' if isinstance(document, Document): if document.is_closed: raise ValueError('document closed') document = document.this if isinstance(document, mupdf.FzDocument): return document elif isinstance(document, mupdf.PdfDocument): return document.super() elif document is None: assert 0, f'document is None' else: assert 0, f'Unrecognised {type(document)=}' def _as_pdf_document(document, required=True): ''' Returns `document` downcast to a mupdf.PdfDocument. If downcast fails (i.e. `document` is not actually a `PdfDocument`) then we assert-fail if `required` is true (the default) else return a `mupdf.PdfDocument` with `.m_internal` false. ''' if isinstance(document, Document): if document.is_closed: raise ValueError('document closed') document = document.this if isinstance(document, mupdf.PdfDocument): return document elif isinstance(document, mupdf.FzDocument): ret = mupdf.PdfDocument(document) if required: assert ret.m_internal return ret elif document is None: assert 0, f'document is None' else: assert 0, f'Unrecognised {type(document)=}' def _as_fz_page(page): ''' Returns page as a mupdf.FzPage, upcasting as required. ''' if isinstance(page, Page): page = page.this if isinstance(page, mupdf.PdfPage): return page.super() elif isinstance(page, mupdf.FzPage): return page elif page is None: assert 0, f'page is None' else: assert 0, f'Unrecognised {type(page)=}' def _as_pdf_page(page, required=True): ''' Returns `page` downcast to a mupdf.PdfPage. If downcast fails (i.e. `page` is not actually a `PdfPage`) then we assert-fail if `required` is true (the default) else return a `mupdf.PdfPage` with `.m_internal` false. ''' if isinstance(page, Page): page = page.this if isinstance(page, mupdf.PdfPage): return page elif isinstance(page, mupdf.FzPage): ret = mupdf.pdf_page_from_fz_page(page) if required: assert ret.m_internal return ret elif page is None: assert 0, f'page is None' else: assert 0, f'Unrecognised {type(page)=}' def _pdf_annot_page(annot): ''' Wrapper for mupdf.pdf_annot_page() which raises an exception if is not bound to a page instead of returning a mupdf.PdfPage with `.m_internal=None`. [Some other MuPDF functions such as pdf_update_annot()` already raise a similar exception if a pdf_annot's .page field is null.] ''' page = mupdf.pdf_annot_page(annot) if not page.m_internal: raise RuntimeError('Annot is not bound to a page') return page # Fixme: we don't support JM_MEMORY=1. JM_MEMORY = 0 # Classes # class Annot: def __init__(self, annot): assert isinstance( annot, mupdf.PdfAnnot) self.this = annot def __bool__(self): return bool(self.this) def __repr__(self): parent = getattr(self, 'parent', '<>') return f"'{self.type[1]}' annotation on {parent}" def __str__(self): return self.__repr__() def _erase(self): if getattr(self, "thisown", False): self.thisown = False def _get_redact_values(self): annot = self.this if mupdf.pdf_annot_type(annot) != mupdf.PDF_ANNOT_REDACT: return values = dict() try: obj = mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "RO") if obj.m_internal: message_warning("Ignoring redaction key '/RO'.") xref = mupdf.pdf_to_num(obj) values[dictkey_xref] = xref obj = mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "OverlayText") if obj.m_internal: text = mupdf.pdf_to_text_string(obj) values[dictkey_text] = JM_UnicodeFromStr(text) else: values[dictkey_text] = '' obj = mupdf.pdf_dict_get(mupdf.pdf_annot_obj(annot), PDF_NAME('Q')) align = 0 if obj.m_internal: align = mupdf.pdf_to_int(obj) values[dictkey_align] = align except Exception: if g_exceptions_verbose: exception_info() return val = values if not val: return val val["rect"] = self.rect text_color, fontname, fontsize = TOOLS._parse_da(self) val["text_color"] = text_color val["fontname"] = fontname val["fontsize"] = fontsize fill = self.colors["fill"] val["fill"] = fill return val def _getAP(self): if g_use_extra: assert isinstance( self.this, mupdf.PdfAnnot) ret = extra.Annot_getAP(self.this) assert isinstance( ret, bytes) return ret else: r = None res = None annot = self.this assert isinstance( annot, mupdf.PdfAnnot) annot_obj = mupdf.pdf_annot_obj( annot) ap = mupdf.pdf_dict_getl( annot_obj, PDF_NAME('AP'), PDF_NAME('N')) if mupdf.pdf_is_stream( ap): res = mupdf.pdf_load_stream( ap) if res and res.m_internal: r = JM_BinFromBuffer(res) return r def _setAP(self, buffer_, rect=0): try: annot = self.this annot_obj = mupdf.pdf_annot_obj( annot) page = _pdf_annot_page(annot) apobj = mupdf.pdf_dict_getl( annot_obj, PDF_NAME('AP'), PDF_NAME('N')) if not apobj.m_internal: raise RuntimeError( MSG_BAD_APN) if not mupdf.pdf_is_stream( apobj): raise RuntimeError( MSG_BAD_APN) res = JM_BufferFromBytes( buffer_) if not res.m_internal: raise ValueError( MSG_BAD_BUFFER) JM_update_stream( page.doc(), apobj, res, 1) if rect: bbox = mupdf.pdf_dict_get_rect( annot_obj, PDF_NAME('Rect')) mupdf.pdf_dict_put_rect( apobj, PDF_NAME('BBox'), bbox) except Exception: if g_exceptions_verbose: exception_info() def _update_appearance(self, opacity=-1, blend_mode=None, fill_color=None, rotate=-1): annot = self.this assert annot.m_internal annot_obj = mupdf.pdf_annot_obj( annot) page = _pdf_annot_page(annot) pdf = page.doc() type_ = mupdf.pdf_annot_type( annot) nfcol, fcol = JM_color_FromSequence(fill_color) try: # remove fill color from unsupported annots # or if so requested if nfcol == 0 or type_ not in ( mupdf.PDF_ANNOT_SQUARE, mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON ): mupdf.pdf_dict_del( annot_obj, PDF_NAME('IC')) elif nfcol > 0: mupdf.pdf_set_annot_interior_color( annot, fcol[:nfcol]) insert_rot = 1 if rotate >= 0 else 0 if type_ not in ( mupdf.PDF_ANNOT_CARET, mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FREE_TEXT, mupdf.PDF_ANNOT_FILE_ATTACHMENT, mupdf.PDF_ANNOT_INK, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, mupdf.PDF_ANNOT_STAMP, mupdf.PDF_ANNOT_TEXT, ): insert_rot = 0 if insert_rot: mupdf.pdf_dict_put_int(annot_obj, PDF_NAME('Rotate'), rotate) # insert fill color if type_ == mupdf.PDF_ANNOT_FREE_TEXT: if nfcol > 0: mupdf.pdf_set_annot_color(annot, fcol[:nfcol]) elif nfcol > 0: col = mupdf.pdf_new_array(page.doc(), nfcol) for i in range( nfcol): mupdf.pdf_array_push_real(col, fcol[i]) mupdf.pdf_dict_put(annot_obj, PDF_NAME('IC'), col) mupdf.pdf_dirty_annot(annot) mupdf.pdf_update_annot(annot) # let MuPDF update pdf.resynth_required = 0 except Exception as e: if g_exceptions_verbose: exception_info() message( f'cannot update annot: {e}') raise if (opacity < 0 or opacity >= 1) and not blend_mode: # no opacity, no blend_mode return True try: # create or update /ExtGState ap = mupdf.pdf_dict_getl( mupdf.pdf_annot_obj(annot), PDF_NAME('AP'), PDF_NAME('N') ) if not ap.m_internal: # should never happen raise RuntimeError( MSG_BAD_APN) resources = mupdf.pdf_dict_get( ap, PDF_NAME('Resources')) if not resources.m_internal: # no Resources yet: make one resources = mupdf.pdf_dict_put_dict( ap, PDF_NAME('Resources'), 2) alp0 = mupdf.pdf_new_dict( page.doc(), 3) if opacity >= 0 and opacity < 1: mupdf.pdf_dict_put_real( alp0, PDF_NAME('CA'), opacity) mupdf.pdf_dict_put_real( alp0, PDF_NAME('ca'), opacity) mupdf.pdf_dict_put_real( annot_obj, PDF_NAME('CA'), opacity) if blend_mode: mupdf.pdf_dict_put_name( alp0, PDF_NAME('BM'), blend_mode) mupdf.pdf_dict_put_name( annot_obj, PDF_NAME('BM'), blend_mode) extg = mupdf.pdf_dict_get( resources, PDF_NAME('ExtGState')) if not extg.m_internal: # no ExtGState yet: make one extg = mupdf.pdf_dict_put_dict( resources, PDF_NAME('ExtGState'), 2) mupdf.pdf_dict_put( extg, PDF_NAME('H'), alp0) except Exception as e: if g_exceptions_verbose: exception_info() message( f'cannot set opacity or blend mode\n: {e}') raise return True @property def apn_bbox(self): """annotation appearance bbox""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) ap = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AP'), PDF_NAME('N')) if not ap.m_internal: val = JM_py_from_rect(mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE)) else: rect = mupdf.pdf_dict_get_rect(ap, PDF_NAME('BBox')) val = JM_py_from_rect(rect) val = Rect(val) * self.get_parent().transformation_matrix val *= self.get_parent().derotation_matrix return val @property def apn_matrix(self): """annotation appearance matrix""" try: CheckParent(self) annot = self.this assert isinstance(annot, mupdf.PdfAnnot) ap = mupdf.pdf_dict_getl( mupdf.pdf_annot_obj(annot), mupdf.PDF_ENUM_NAME_AP, mupdf.PDF_ENUM_NAME_N ) if not ap.m_internal: return JM_py_from_matrix(mupdf.FzMatrix()) mat = mupdf.pdf_dict_get_matrix(ap, mupdf.PDF_ENUM_NAME_Matrix) val = JM_py_from_matrix(mat) val = Matrix(val) return val except Exception: if g_exceptions_verbose: exception_info() raise @property def blendmode(self): """annotation BlendMode""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) obj = mupdf.pdf_dict_get(annot_obj, PDF_NAME('BM')) blend_mode = None if obj.m_internal: blend_mode = JM_UnicodeFromStr(mupdf.pdf_to_name(obj)) return blend_mode # loop through the /AP/N/Resources/ExtGState objects obj = mupdf.pdf_dict_getl( annot_obj, PDF_NAME('AP'), PDF_NAME('N'), PDF_NAME('Resources'), PDF_NAME('ExtGState'), ) if mupdf.pdf_is_dict(obj): n = mupdf.pdf_dict_len(obj) for i in range(n): obj1 = mupdf.pdf_dict_get_val(obj, i) if mupdf.pdf_is_dict(obj1): m = mupdf.pdf_dict_len(obj1) for j in range(m): obj2 = mupdf.pdf_dict_get_key(obj1, j) if mupdf.pdf_objcmp(obj2, PDF_NAME('BM')) == 0: blend_mode = JM_UnicodeFromStr(mupdf.pdf_to_name(mupdf.pdf_dict_get_val(obj1, j))) return blend_mode return blend_mode @property def border(self): """Border information.""" CheckParent(self) atype = self.type[0] if atype not in ( mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FREE_TEXT, mupdf.PDF_ANNOT_INK, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, ): return dict() ao = mupdf.pdf_annot_obj(self.this) ret = JM_annot_border(ao) return ret def clean_contents(self, sanitize=1): """Clean appearance contents stream.""" CheckParent(self) annot = self.this pdf = mupdf.pdf_get_bound_document(mupdf.pdf_annot_obj(annot)) filter_ = _make_PdfFilterOptions(recurse=1, instance_forms=0, ascii=0, sanitize=sanitize) mupdf.pdf_filter_annot_contents(pdf, annot, filter_) @property def colors(self): """Color definitions.""" try: CheckParent(self) annot = self.this assert isinstance(annot, mupdf.PdfAnnot) return JM_annot_colors(mupdf.pdf_annot_obj(annot)) except Exception: if g_exceptions_verbose: exception_info() raise def delete_responses(self): """Delete 'Popup' and responding annotations.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) page = _pdf_annot_page(annot) while 1: irt_annot = JM_find_annot_irt(annot) if not irt_annot: break mupdf.pdf_delete_annot(page, irt_annot) mupdf.pdf_dict_del(annot_obj, PDF_NAME('Popup')) annots = mupdf.pdf_dict_get(page.obj(), PDF_NAME('Annots')) n = mupdf.pdf_array_len(annots) found = 0 for i in range(n-1, -1, -1): o = mupdf.pdf_array_get(annots, i) p = mupdf.pdf_dict_get(o, PDF_NAME('Parent')) if not o.m_internal: continue if not mupdf.pdf_objcmp(p, annot_obj): mupdf.pdf_array_delete(annots, i) found = 1 if found: mupdf.pdf_dict_put(page.obj(), PDF_NAME('Annots'), annots) @property def file_info(self): """Attached file information.""" CheckParent(self) res = dict() length = -1 size = -1 desc = None annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) type_ = mupdf.pdf_annot_type(annot) if type_ != mupdf.PDF_ANNOT_FILE_ATTACHMENT: raise TypeError( MSG_BAD_ANNOT_TYPE) stream = mupdf.pdf_dict_getl( annot_obj, PDF_NAME('FS'), PDF_NAME('EF'), PDF_NAME('F'), ) if not stream.m_internal: RAISEPY( "bad PDF: file entry not found", JM_Exc_FileDataError) fs = mupdf.pdf_dict_get(annot_obj, PDF_NAME('FS')) o = mupdf.pdf_dict_get(fs, PDF_NAME('UF')) if o.m_internal: filename = mupdf.pdf_to_text_string(o) else: o = mupdf.pdf_dict_get(fs, PDF_NAME('F')) if o.m_internal: filename = mupdf.pdf_to_text_string(o) o = mupdf.pdf_dict_get(fs, PDF_NAME('Desc')) if o.m_internal: desc = mupdf.pdf_to_text_string(o) o = mupdf.pdf_dict_get(stream, PDF_NAME('Length')) if o.m_internal: length = mupdf.pdf_to_int(o) o = mupdf.pdf_dict_getl(stream, PDF_NAME('Params'), PDF_NAME('Size')) if o.m_internal: size = mupdf.pdf_to_int(o) res[ dictkey_filename] = JM_EscapeStrFromStr(filename) res[ dictkey_descr] = JM_UnicodeFromStr(desc) res[ dictkey_length] = length res[ dictkey_size] = size return res @property def flags(self): """Flags field.""" CheckParent(self) annot = self.this return mupdf.pdf_annot_flags(annot) def get_file(self): """Retrieve attached file content.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) type = mupdf.pdf_annot_type(annot) if type != mupdf.PDF_ANNOT_FILE_ATTACHMENT: raise TypeError( MSG_BAD_ANNOT_TYPE) stream = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('FS'), PDF_NAME('EF'), PDF_NAME('F')) if not stream.m_internal: RAISEPY( "bad PDF: file entry not found", JM_Exc_FileDataError) buf = mupdf.pdf_load_stream(stream) res = JM_BinFromBuffer(buf) return res def get_oc(self): """Get annotation optional content reference.""" CheckParent(self) oc = 0 annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) obj = mupdf.pdf_dict_get(annot_obj, PDF_NAME('OC')) if obj.m_internal: oc = mupdf.pdf_to_num(obj) return oc # PyMuPDF doesn't seem to have this .parent member, but removing it breaks # 11 tests...? #@property def get_parent(self): try: ret = getattr( self, 'parent') except AttributeError: page = _pdf_annot_page(self.this) assert isinstance( page, mupdf.PdfPage) document = Document( page.doc()) if page.m_internal else None ret = Page(page, document) #self.parent = weakref.proxy( ret) self.parent = ret #log(f'No attribute .parent: {type(self)=} {id(self)=}: have set {id(self.parent)=}.') #log( f'Have set self.parent') return ret def get_pixmap(self, matrix=None, dpi=None, colorspace=None, alpha=0): """annotation Pixmap""" CheckParent(self) cspaces = {"gray": csGRAY, "rgb": csRGB, "cmyk": csCMYK} if type(colorspace) is str: colorspace = cspaces.get(colorspace.lower(), None) if dpi: matrix = Matrix(dpi / 72, dpi / 72) ctm = JM_matrix_from_py(matrix) cs = colorspace if not cs: cs = mupdf.fz_device_rgb() pix = mupdf.pdf_new_pixmap_from_annot(self.this, ctm, cs, mupdf.FzSeparations(0), alpha) ret = Pixmap(pix) if dpi: ret.set_dpi(dpi, dpi) return ret def get_sound(self): """Retrieve sound stream.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) type = mupdf.pdf_annot_type(annot) sound = mupdf.pdf_dict_get(annot_obj, PDF_NAME('Sound')) if type != mupdf.PDF_ANNOT_SOUND or not sound.m_internal: raise TypeError( MSG_BAD_ANNOT_TYPE) if mupdf.pdf_dict_get(sound, PDF_NAME('F')).m_internal: RAISEPY( "unsupported sound stream", JM_Exc_FileDataError) res = dict() obj = mupdf.pdf_dict_get(sound, PDF_NAME('R')) if obj.m_internal: res['rate'] = mupdf.pdf_to_real(obj) obj = mupdf.pdf_dict_get(sound, PDF_NAME('C')) if obj.m_internal: res['channels'] = mupdf.pdf_to_int(obj) obj = mupdf.pdf_dict_get(sound, PDF_NAME('B')) if obj.m_internal: res['bps'] = mupdf.pdf_to_int(obj) obj = mupdf.pdf_dict_get(sound, PDF_NAME('E')) if obj.m_internal: res['encoding'] = mupdf.pdf_to_name(obj) obj = mupdf.pdf_dict_gets(sound, "CO") if obj.m_internal: res['compression'] = mupdf.pdf_to_name(obj) buf = mupdf.pdf_load_stream(sound) stream = JM_BinFromBuffer(buf) res['stream'] = stream return res def get_text(self, *args, **kwargs): return utils.get_text(self, *args, **kwargs) def get_textbox(self, *args, **kwargs): return utils.get_textbox(self, *args, **kwargs) def get_textpage(self, clip=None, flags=0): """Make annotation TextPage.""" CheckParent(self) options = mupdf.FzStextOptions(flags) if clip: assert hasattr(mupdf, 'FZ_STEXT_CLIP_RECT'), f'MuPDF-{mupdf_version} does not support FZ_STEXT_CLIP_RECT.' clip2 = JM_rect_from_py(clip) options.clip = clip2.internal() options.flags |= mupdf.FZ_STEXT_CLIP_RECT annot = self.this stextpage = mupdf.FzStextPage(annot, options) ret = TextPage(stextpage) p = self.get_parent() if isinstance(p, weakref.ProxyType): ret.parent = p else: ret.parent = weakref.proxy(p) return ret @property def has_popup(self): """Check if annotation has a Popup.""" CheckParent(self) annot = self.this obj = mupdf.pdf_dict_get(mupdf.pdf_annot_obj(annot), PDF_NAME('Popup')) return True if obj.m_internal else False @property def info(self): """Various information details.""" CheckParent(self) annot = self.this res = dict() res[dictkey_content] = JM_UnicodeFromStr(mupdf.pdf_annot_contents(annot)) o = mupdf.pdf_dict_get(mupdf.pdf_annot_obj(annot), PDF_NAME('Name')) res[dictkey_name] = JM_UnicodeFromStr(mupdf.pdf_to_name(o)) # Title (= author) o = mupdf.pdf_dict_get(mupdf.pdf_annot_obj(annot), PDF_NAME('T')) res[dictkey_title] = JM_UnicodeFromStr(mupdf.pdf_to_text_string(o)) # CreationDate o = mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "CreationDate") res[dictkey_creationDate] = JM_UnicodeFromStr(mupdf.pdf_to_text_string(o)) # ModDate o = mupdf.pdf_dict_get(mupdf.pdf_annot_obj(annot), PDF_NAME('M')) res[dictkey_modDate] = JM_UnicodeFromStr(mupdf.pdf_to_text_string(o)) # Subj o = mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "Subj") res[dictkey_subject] = mupdf.pdf_to_text_string(o) # Identification (PDF key /NM) o = mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "NM") res[dictkey_id] = JM_UnicodeFromStr(mupdf.pdf_to_text_string(o)) return res @property def irt_xref(self): ''' annotation IRT xref ''' annot = self.this annot_obj = mupdf.pdf_annot_obj( annot) irt = mupdf.pdf_dict_get( annot_obj, PDF_NAME('IRT')) if not irt.m_internal: return 0 return mupdf.pdf_to_num( irt) @property def is_open(self): """Get 'open' status of annotation or its Popup.""" CheckParent(self) return mupdf.pdf_annot_is_open(self.this) @property def language(self): """annotation language""" this_annot = self.this lang = mupdf.pdf_annot_language(this_annot) if lang == mupdf.FZ_LANG_UNSET: return assert hasattr(mupdf, 'fz_string_from_text_language2') return mupdf.fz_string_from_text_language2(lang) @property def line_ends(self): """Line end codes.""" CheckParent(self) annot = self.this # return nothing for invalid annot types if not mupdf.pdf_annot_has_line_ending_styles(annot): return lstart = mupdf.pdf_annot_line_start_style(annot) lend = mupdf.pdf_annot_line_end_style(annot) return lstart, lend @property def next(self): """Next annotation.""" CheckParent(self) this_annot = self.this assert isinstance(this_annot, mupdf.PdfAnnot) assert this_annot.m_internal type_ = mupdf.pdf_annot_type(this_annot) if type_ != mupdf.PDF_ANNOT_WIDGET: annot = mupdf.pdf_next_annot(this_annot) else: annot = mupdf.pdf_next_widget(this_annot) val = Annot(annot) if annot.m_internal else None if not val: return None val.thisown = True assert val.get_parent().this.m_internal_value() == self.get_parent().this.m_internal_value() val.parent._annot_refs[id(val)] = val if val.type[0] == mupdf.PDF_ANNOT_WIDGET: widget = Widget() TOOLS._fill_widget(val, widget) val = widget return val @property def opacity(self): """Opacity.""" CheckParent(self) annot = self.this opy = -1 ca = mupdf.pdf_dict_get( mupdf.pdf_annot_obj(annot), mupdf.PDF_ENUM_NAME_CA) if mupdf.pdf_is_number(ca): opy = mupdf.pdf_to_real(ca) return opy @property def popup_rect(self): """annotation 'Popup' rectangle""" CheckParent(self) rect = mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE) annot = self.this annot_obj = mupdf.pdf_annot_obj( annot) obj = mupdf.pdf_dict_get( annot_obj, PDF_NAME('Popup')) if obj.m_internal: rect = mupdf.pdf_dict_get_rect(obj, PDF_NAME('Rect')) #log(f'{rect=}') val = JM_py_from_rect(rect) #log(f'{val=}') val = Rect(val) * self.get_parent().transformation_matrix val *= self.get_parent().derotation_matrix return val @property def popup_xref(self): """annotation 'Popup' xref""" CheckParent(self) xref = 0 annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) obj = mupdf.pdf_dict_get(annot_obj, PDF_NAME('Popup')) if obj.m_internal: xref = mupdf.pdf_to_num(obj) return xref @property def rect(self): """annotation rectangle""" if g_use_extra: val = extra.Annot_rect3( self.this) else: val = mupdf.pdf_bound_annot(self.this) val = Rect(val) # Caching self.parent_() reduces 1000x from 0.07 to 0.04. # p = self.get_parent() #p = getattr( self, 'parent', None) #if p is None: # p = self.parent # self.parent = p #p = self.parent_() val *= p.derotation_matrix return val @property def rect_delta(self): ''' annotation delta values to rectangle ''' annot_obj = mupdf.pdf_annot_obj(self.this) arr = mupdf.pdf_dict_get( annot_obj, PDF_NAME('RD')) if mupdf.pdf_array_len( arr) == 4: return ( mupdf.pdf_to_real( mupdf.pdf_array_get( arr, 0)), mupdf.pdf_to_real( mupdf.pdf_array_get( arr, 1)), -mupdf.pdf_to_real( mupdf.pdf_array_get( arr, 2)), -mupdf.pdf_to_real( mupdf.pdf_array_get( arr, 3)), ) @property def rotation(self): """annotation rotation""" CheckParent(self) annot = self.this rotation = mupdf.pdf_dict_get( mupdf.pdf_annot_obj(annot), mupdf.PDF_ENUM_NAME_Rotate) if not rotation.m_internal: return -1 return mupdf.pdf_to_int( rotation) def set_apn_bbox(self, bbox): """ Set annotation appearance bbox. """ CheckParent(self) page = self.get_parent() rot = page.rotation_matrix mat = page.transformation_matrix bbox *= rot * ~mat annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) ap = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AP'), PDF_NAME('N')) if not ap.m_internal: raise RuntimeError( MSG_BAD_APN) rect = JM_rect_from_py(bbox) mupdf.pdf_dict_put_rect(ap, PDF_NAME('BBox'), rect) def set_apn_matrix(self, matrix): """Set annotation appearance matrix.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) ap = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AP'), PDF_NAME('N')) if not ap.m_internal: raise RuntimeError( MSG_BAD_APN) mat = JM_matrix_from_py(matrix) mupdf.pdf_dict_put_matrix(ap, PDF_NAME('Matrix'), mat) def set_blendmode(self, blend_mode): """Set annotation BlendMode.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('BM'), blend_mode) def set_border(self, border=None, width=-1, style=None, dashes=None, clouds=-1): """Set border properties. Either a dict, or direct arguments width, style, dashes or clouds.""" CheckParent(self) atype, atname = self.type[:2] # annotation type if atype not in ( mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FREE_TEXT, mupdf.PDF_ANNOT_INK, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, ): message(f"Cannot set border for '{atname}'.") return None if atype not in ( mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FREE_TEXT, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, ): if clouds > 0: message(f"Cannot set cloudy border for '{atname}'.") clouds = -1 # do not set border effect if type(border) is not dict: border = {"width": width, "style": style, "dashes": dashes, "clouds": clouds} border.setdefault("width", -1) border.setdefault("style", None) border.setdefault("dashes", None) border.setdefault("clouds", -1) if border["width"] is None: border["width"] = -1 if border["clouds"] is None: border["clouds"] = -1 if hasattr(border["dashes"], "__getitem__"): # ensure sequence items are integers border["dashes"] = tuple(border["dashes"]) for item in border["dashes"]: if not isinstance(item, int): border["dashes"] = None break annot = self.this annot_obj = mupdf.pdf_annot_obj( annot) pdf = mupdf.pdf_get_bound_document( annot_obj) return JM_annot_set_border( border, pdf, annot_obj) def set_colors(self, colors=None, stroke=None, fill=None): """Set 'stroke' and 'fill' colors. Use either a dict or the direct arguments. """ if self.type[0] == mupdf.PDF_ANNOT_FREE_TEXT: raise ValueError("cannot be used for FreeText annotations") CheckParent(self) doc = self.get_parent().parent if type(colors) is not dict: colors = {"fill": fill, "stroke": stroke} fill = colors.get("fill") stroke = colors.get("stroke") fill_annots = (mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_SQUARE, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_REDACT,) if stroke in ([], ()): doc.xref_set_key(self.xref, "C", "[]") elif stroke is not None: if hasattr(stroke, "__float__"): stroke = [float(stroke)] CheckColor(stroke) assert len(stroke) in (1, 3, 4) s = f"[{_format_g(stroke)}]" doc.xref_set_key(self.xref, "C", s) if fill and self.type[0] not in fill_annots: message(f"Warning: fill color ignored for annot type '{self.type[1]}'.") return if fill in ([], ()): doc.xref_set_key(self.xref, "IC", "[]") elif fill is not None: if hasattr(fill, "__float__"): fill = [float(fill)] CheckColor(fill) assert len(fill) in (1, 3, 4) s = f"[{_format_g(fill)}]" doc.xref_set_key(self.xref, "IC", s) def set_flags(self, flags): """Set annotation flags.""" CheckParent(self) annot = self.this mupdf.pdf_set_annot_flags(annot, flags) def set_info(self, info=None, content=None, title=None, creationDate=None, modDate=None, subject=None): """Set various properties.""" CheckParent(self) if type(info) is dict: # build the args from the dictionary content = info.get("content", None) title = info.get("title", None) creationDate = info.get("creationDate", None) modDate = info.get("modDate", None) subject = info.get("subject", None) info = None annot = self.this # use this to indicate a 'markup' annot type is_markup = mupdf.pdf_annot_has_author(annot) # contents if content: mupdf.pdf_set_annot_contents(annot, content) if is_markup: # title (= author) if title: mupdf.pdf_set_annot_author(annot, title) # creation date if creationDate: mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(annot), PDF_NAME('CreationDate'), creationDate) # mod date if modDate: mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(annot), PDF_NAME('M'), modDate) # subject if subject: mupdf.pdf_dict_puts(mupdf.pdf_annot_obj(annot), "Subj", mupdf.pdf_new_text_string(subject)) def set_irt_xref(self, xref): ''' Set annotation IRT xref ''' annot = self.this annot_obj = mupdf.pdf_annot_obj( annot) page = _pdf_annot_page(annot) if xref < 1 or xref >= mupdf.pdf_xref_len( page.doc()): raise ValueError( MSG_BAD_XREF) irt = mupdf.pdf_new_indirect( page.doc(), xref, 0) subt = mupdf.pdf_dict_get( irt, PDF_NAME('Subtype')) irt_subt = mupdf.pdf_annot_type_from_string( mupdf.pdf_to_name( subt)) if irt_subt < 0: raise ValueError( MSG_IS_NO_ANNOT) mupdf.pdf_dict_put( annot_obj, PDF_NAME('IRT'), irt) def set_language(self, language=None): """Set annotation language.""" CheckParent(self) this_annot = self.this if not language: lang = mupdf.FZ_LANG_UNSET else: lang = mupdf.fz_text_language_from_string(language) mupdf.pdf_set_annot_language(this_annot, lang) def set_line_ends(self, start, end): """Set line end codes.""" CheckParent(self) annot = self.this if mupdf.pdf_annot_has_line_ending_styles(annot): mupdf.pdf_set_annot_line_ending_styles(annot, start, end) else: message_warning("bad annot type for line ends") def set_name(self, name): """Set /Name (icon) of annotation.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('Name'), name) def set_oc(self, oc=0): """Set / remove annotation OC xref.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) if not oc: mupdf.pdf_dict_del(annot_obj, PDF_NAME('OC')) else: JM_add_oc_object(mupdf.pdf_get_bound_document(annot_obj), annot_obj, oc) def set_opacity(self, opacity): """Set opacity.""" CheckParent(self) annot = self.this if not _INRANGE(opacity, 0.0, 1.0): mupdf.pdf_set_annot_opacity(annot, 1) return mupdf.pdf_set_annot_opacity(annot, opacity) if opacity < 1.0: page = _pdf_annot_page(annot) page.transparency = 1 def set_open(self, is_open): """Set 'open' status of annotation or its Popup.""" CheckParent(self) annot = self.this mupdf.pdf_set_annot_is_open(annot, is_open) def set_popup(self, rect): ''' Create annotation 'Popup' or update rectangle. ''' CheckParent(self) annot = self.this pdfpage = _pdf_annot_page(annot) rot = JM_rotate_page_matrix(pdfpage) r = mupdf.fz_transform_rect(JM_rect_from_py(rect), rot) mupdf.pdf_set_annot_popup(annot, r) def set_rect(self, rect): """Set annotation rectangle.""" CheckParent(self) annot = self.this pdfpage = _pdf_annot_page(annot) rot = JM_rotate_page_matrix(pdfpage) r = mupdf.fz_transform_rect(JM_rect_from_py(rect), rot) if mupdf.fz_is_empty_rect(r) or mupdf.fz_is_infinite_rect(r): raise ValueError( MSG_BAD_RECT) try: mupdf.pdf_set_annot_rect(annot, r) except Exception as e: message(f'cannot set rect: {e}') return False def set_rotation(self, rotate=0): """Set annotation rotation.""" CheckParent(self) annot = self.this type = mupdf.pdf_annot_type(annot) if type not in ( mupdf.PDF_ANNOT_CARET, mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FREE_TEXT, mupdf.PDF_ANNOT_FILE_ATTACHMENT, mupdf.PDF_ANNOT_INK, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, mupdf.PDF_ANNOT_STAMP, mupdf.PDF_ANNOT_TEXT, ): return rot = rotate while rot < 0: rot += 360 while rot >= 360: rot -= 360 if type == mupdf.PDF_ANNOT_FREE_TEXT and rot % 90 != 0: rot = 0 annot_obj = mupdf.pdf_annot_obj(annot) mupdf.pdf_dict_put_int(annot_obj, PDF_NAME('Rotate'), rot) @property def type(self): """annotation type""" CheckParent(self) if not self.this.m_internal: return 'null' type_ = mupdf.pdf_annot_type(self.this) c = mupdf.pdf_string_from_annot_type(type_) o = mupdf.pdf_dict_gets( mupdf.pdf_annot_obj(self.this), 'IT') if not o.m_internal or mupdf.pdf_is_name(o): return (type_, c) it = mupdf.pdf_to_name(o) return (type_, c, it) def update(self, blend_mode: OptStr =None, opacity: OptFloat =None, fontsize: float =0, fontname: OptStr =None, text_color: OptSeq =None, border_color: OptSeq =None, fill_color: OptSeq =None, cross_out: bool =True, rotate: int =-1, ): """Update annot appearance. Notes: Depending on the annot type, some parameters make no sense, while others are only available in this method to achieve the desired result. This is especially true for 'FreeText' annots. Args: blend_mode: set the blend mode, all annotations. opacity: set the opacity, all annotations. fontsize: set fontsize, 'FreeText' only. fontname: set the font, 'FreeText' only. border_color: set border color, 'FreeText' only. text_color: set text color, 'FreeText' only. fill_color: set fill color, all annotations. cross_out: draw diagonal lines, 'Redact' only. rotate: set rotation, 'FreeText' and some others. """ annot_obj = mupdf.pdf_annot_obj(self.this) if border_color: is_rich_text = mupdf.pdf_dict_get(annot_obj, PDF_NAME("RC")) if not is_rich_text: raise ValueError("cannot set border_color if rich_text is False") Annot.update_timing_test() CheckParent(self) def color_string(cs, code): """Return valid PDF color operator for a given color sequence. """ cc = ColorCode(cs, code) if not cc: return b"" return (cc + "\n").encode() annot_type = self.type[0] # get the annot type dt = self.border.get("dashes", None) # get the dashes spec bwidth = self.border.get("width", -1) # get border line width stroke = self.colors["stroke"] # get the stroke color if fill_color is not None: fill = fill_color else: fill = self.colors["fill"] rect = None # self.rect # prevent MuPDF fiddling with it apnmat = self.apn_matrix # prevent MuPDF fiddling with it if rotate != -1: # sanitize rotation value while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if annot_type == mupdf.PDF_ANNOT_FREE_TEXT and rotate % 90 != 0: rotate = 0 #------------------------------------------------------------------ # handle opacity and blend mode #------------------------------------------------------------------ if blend_mode is None: blend_mode = self.blendmode if not hasattr(opacity, "__float__"): opacity = self.opacity if 0 <= opacity < 1 or blend_mode: opa_code = "/H gs\n" # then we must reference this 'gs' else: opa_code = "" if annot_type == mupdf.PDF_ANNOT_FREE_TEXT: CheckColor(text_color) CheckColor(fill_color) tcol, fname, fsize = TOOLS._parse_da(self) # read and update default appearance as necessary if fsize <= 0: fsize = 12 if text_color: tcol = text_color if fontname: fname = fontname if fontsize > 0: fsize = fontsize JM_make_annot_DA(self, len(tcol), tcol, fname, fsize) blend_mode = None # not supported for free text annotations! #------------------------------------------------------------------ # now invoke MuPDF to update the annot appearance #------------------------------------------------------------------ val = self._update_appearance( opacity=opacity, blend_mode=blend_mode, fill_color=fill, rotate=rotate, ) if val is False: raise RuntimeError("Error updating annotation.") if annot_type == mupdf.PDF_ANNOT_FREE_TEXT: # in absence of previous opacity, we may need to modify the AP ap = self._getAP() if 0 <= opacity < 1 and not ap.startswith(b"/H gs"): self._setAP(b"/H gs\n" + ap) return bfill = color_string(fill, "f") bstroke = color_string(stroke, "c") p_ctm = self.get_parent().transformation_matrix imat = ~p_ctm # inverse page transf. matrix if dt: dashes = "[" + " ".join(map(str, dt)) + "] 0 d\n" dashes = dashes.encode("utf-8") else: dashes = None if self.line_ends: line_end_le, line_end_ri = self.line_ends else: line_end_le, line_end_ri = 0, 0 # init line end codes # read contents as created by MuPDF ap = self._getAP() ap_tab = ap.splitlines() # split in single lines ap_updated = False # assume we did nothing if annot_type == mupdf.PDF_ANNOT_REDACT: if cross_out: # create crossed-out rect ap_updated = True ap_tab = ap_tab[:-1] _, LL, LR, UR, UL = ap_tab ap_tab.append(LR) ap_tab.append(LL) ap_tab.append(UR) ap_tab.append(LL) ap_tab.append(UL) ap_tab.append(b"S") if bwidth > 0 or bstroke != b"": ap_updated = True ntab = [_format_g(bwidth).encode() + b" w"] if bwidth > 0 else [] for line in ap_tab: if line.endswith(b"w"): continue if line.endswith(b"RG") and bstroke != b"": line = bstroke[:-1] ntab.append(line) ap_tab = ntab ap = b"\n".join(ap_tab) if annot_type in (mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_POLY_LINE): ap = b"\n".join(ap_tab[:-1]) + b"\n" ap_updated = True if bfill != b"": if annot_type == mupdf.PDF_ANNOT_POLYGON: ap = ap + bfill + b"b" # close, fill, and stroke elif annot_type == mupdf.PDF_ANNOT_POLY_LINE: ap = ap + b"S" # stroke else: if annot_type == mupdf.PDF_ANNOT_POLYGON: ap = ap + b"s" # close and stroke elif annot_type == mupdf.PDF_ANNOT_POLY_LINE: ap = ap + b"S" # stroke if dashes is not None: # handle dashes ap = dashes + ap # reset dashing - only applies for LINE annots with line ends given ap = ap.replace(b"\nS\n", b"\nS\n[] 0 d\n", 1) ap_updated = True if opa_code: ap = opa_code.encode("utf-8") + ap ap_updated = True ap = b"q\n" + ap + b"\nQ\n" #---------------------------------------------------------------------- # the following handles line end symbols for 'Polygon' and 'Polyline' #---------------------------------------------------------------------- if line_end_le + line_end_ri > 0 and annot_type in (mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_POLY_LINE): le_funcs = (None, TOOLS._le_square, TOOLS._le_circle, TOOLS._le_diamond, TOOLS._le_openarrow, TOOLS._le_closedarrow, TOOLS._le_butt, TOOLS._le_ropenarrow, TOOLS._le_rclosedarrow, TOOLS._le_slash) le_funcs_range = range(1, len(le_funcs)) d = 2 * max(1, self.border["width"]) rect = self.rect + (-d, -d, d, d) ap_updated = True points = self.vertices if line_end_le in le_funcs_range: p1 = Point(points[0]) * imat p2 = Point(points[1]) * imat left = le_funcs[line_end_le](self, p1, p2, False, fill_color) ap += left.encode() if line_end_ri in le_funcs_range: p1 = Point(points[-2]) * imat p2 = Point(points[-1]) * imat left = le_funcs[line_end_ri](self, p1, p2, True, fill_color) ap += left.encode() if ap_updated: if rect: # rect modified here? self.set_rect(rect) self._setAP(ap, rect=1) else: self._setAP(ap, rect=0) #------------------------------- # handle annotation rotations #------------------------------- if annot_type not in ( # only these types are supported mupdf.PDF_ANNOT_CARET, mupdf.PDF_ANNOT_CIRCLE, mupdf.PDF_ANNOT_FILE_ATTACHMENT, mupdf.PDF_ANNOT_INK, mupdf.PDF_ANNOT_LINE, mupdf.PDF_ANNOT_POLY_LINE, mupdf.PDF_ANNOT_POLYGON, mupdf.PDF_ANNOT_SQUARE, mupdf.PDF_ANNOT_STAMP, mupdf.PDF_ANNOT_TEXT, ): return rot = self.rotation # get value from annot object if rot == -1: # nothing to change return M = (self.rect.tl + self.rect.br) / 2 # center of annot rect if rot == 0: # undo rotations if abs(apnmat - Matrix(1, 1)) < 1e-5: return # matrix already is a no-op quad = self.rect.morph(M, ~apnmat) # derotate rect self.setRect(quad.rect) self.set_apn_matrix(Matrix(1, 1)) # appearance matrix = no-op return mat = Matrix(rot) quad = self.rect.morph(M, mat) self.set_rect(quad.rect) self.set_apn_matrix(apnmat * mat) def update_file(self, buffer_=None, filename=None, ufilename=None, desc=None): """Update attached file.""" CheckParent(self) annot = self.this annot_obj = mupdf.pdf_annot_obj(annot) pdf = mupdf.pdf_get_bound_document(annot_obj) # the owning PDF type = mupdf.pdf_annot_type(annot) if type != mupdf.PDF_ANNOT_FILE_ATTACHMENT: raise TypeError( MSG_BAD_ANNOT_TYPE) stream = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('FS'), PDF_NAME('EF'), PDF_NAME('F')) # the object for file content if not stream.m_internal: RAISEPY( "bad PDF: no /EF object", JM_Exc_FileDataError) fs = mupdf.pdf_dict_get(annot_obj, PDF_NAME('FS')) # file content given res = JM_BufferFromBytes(buffer_) if buffer_ and not res.m_internal: raise ValueError( MSG_BAD_BUFFER) if res: JM_update_stream(pdf, stream, res, 1) # adjust /DL and /Size parameters len, _ = mupdf.fz_buffer_storage(res) l = mupdf.pdf_new_int(len) mupdf.pdf_dict_put(stream, PDF_NAME('DL'), l) mupdf.pdf_dict_putl(stream, l, PDF_NAME('Params'), PDF_NAME('Size')) if filename: mupdf.pdf_dict_put_text_string(stream, PDF_NAME('F'), filename) mupdf.pdf_dict_put_text_string(fs, PDF_NAME('F'), filename) mupdf.pdf_dict_put_text_string(stream, PDF_NAME('UF'), filename) mupdf.pdf_dict_put_text_string(fs, PDF_NAME('UF'), filename) mupdf.pdf_dict_put_text_string(annot_obj, PDF_NAME('Contents'), filename) if ufilename: mupdf.pdf_dict_put_text_string(stream, PDF_NAME('UF'), ufilename) mupdf.pdf_dict_put_text_string(fs, PDF_NAME('UF'), ufilename) if desc: mupdf.pdf_dict_put_text_string(stream, PDF_NAME('Desc'), desc) mupdf.pdf_dict_put_text_string(fs, PDF_NAME('Desc'), desc) @staticmethod def update_timing_test(): total = 0 for i in range( 30*1000): total += i return total @property def vertices(self): """annotation vertex points""" CheckParent(self) annot = self.this assert isinstance(annot, mupdf.PdfAnnot) annot_obj = mupdf.pdf_annot_obj(annot) page = _pdf_annot_page(annot) page_ctm = mupdf.FzMatrix() # page transformation matrix dummy = mupdf.FzRect() # Out-param for mupdf.pdf_page_transform(). mupdf.pdf_page_transform(page, dummy, page_ctm) derot = JM_derotate_page_matrix(page) page_ctm = mupdf.fz_concat(page_ctm, derot) #---------------------------------------------------------------- # The following objects occur in different annotation types. # So we are sure that (!o) occurs at most once. # Every pair of floats is one point, that needs to be separately # transformed with the page transformation matrix. #---------------------------------------------------------------- o = mupdf.pdf_dict_get(annot_obj, PDF_NAME('Vertices')) if not o.m_internal: o = mupdf.pdf_dict_get(annot_obj, PDF_NAME('L')) if not o.m_internal: o = mupdf.pdf_dict_get(annot_obj, PDF_NAME('QuadPoints')) if not o.m_internal: o = mupdf.pdf_dict_gets(annot_obj, 'CL') if o.m_internal: # handle lists with 1-level depth # weiter res = [] for i in range(0, mupdf.pdf_array_len(o), 2): x = mupdf.pdf_to_real(mupdf.pdf_array_get(o, i)) y = mupdf.pdf_to_real(mupdf.pdf_array_get(o, i+1)) point = mupdf.FzPoint(x, y) point = mupdf.fz_transform_point(point, page_ctm) res.append( (point.x, point.y)) return res o = mupdf.pdf_dict_gets(annot_obj, 'InkList') if o.m_internal: # InkList has 2-level lists #inklist: res = [] for i in range(mupdf.pdf_array_len(o)): res1 = [] o1 = mupdf.pdf_array_get(o, i) for j in range(0, mupdf.pdf_array_len(o1), 2): x = mupdf.pdf_to_real(mupdf.pdf_array_get(o1, j)) y = mupdf.pdf_to_real(mupdf.pdf_array_get(o1, j+1)) point = mupdf.FzPoint(x, y) point = mupdf.fz_transform_point(point, page_ctm) res1.append( (point.x, point.y)) res.append(res1) return res @property def xref(self): """annotation xref number""" CheckParent(self) annot = self.this return mupdf.pdf_to_num(mupdf.pdf_annot_obj(annot)) class Archive: def __init__( self, *args): ''' Archive(dirname [, path]) - from folder Archive(file [, path]) - from file name or object Archive(data, name) - from memory item Archive() - empty archive Archive(archive [, path]) - from archive ''' self._subarchives = list() self.this = mupdf.fz_new_multi_archive() if args: self.add( *args) def __repr__( self): return f'Archive, sub-archives: {len(self._subarchives)}' def _add_arch( self, subarch, path=None): mupdf.fz_mount_multi_archive( self.this, subarch, path) def _add_dir( self, folder, path=None): sub = mupdf.fz_open_directory( folder) mupdf.fz_mount_multi_archive( self.this, sub, path) def _add_treeitem( self, memory, name, path=None): buff = JM_BufferFromBytes( memory) sub = mupdf.fz_new_tree_archive( mupdf.FzTree()) mupdf.fz_tree_archive_add_buffer( sub, name, buff) mupdf.fz_mount_multi_archive( self.this, sub, path) def _add_ziptarfile( self, filepath, type_, path=None): if type_ == 1: sub = mupdf.fz_open_zip_archive( filepath) else: sub = mupdf.fz_open_tar_archive( filepath) mupdf.fz_mount_multi_archive( self.this, sub, path) def _add_ziptarmemory( self, memory, type_, path=None): buff = JM_BufferFromBytes( memory) stream = mupdf.fz_open_buffer( buff) if type_==1: sub = mupdf.fz_open_zip_archive_with_stream( stream) else: sub = mupdf.fz_open_tar_archive_with_stream( stream) mupdf.fz_mount_multi_archive( self.this, sub, path) def add( self, content, path=None): ''' Add a sub-archive. Args: content: The content to be added. May be one of: `str` - must be path of directory or file. `bytes`, `bytearray`, `io.BytesIO` - raw data. `zipfile.Zipfile`. `tarfile.TarFile`. `pymupdf.Archive`. A two-item tuple `(data, name)`. List or tuple (but not tuple with length 2) of the above. path: (str) a "virtual" path name, under which the elements of content can be retrieved. Use it to e.g. cope with duplicate element names. ''' def is_binary_data(x): return isinstance(x, (bytes, bytearray, io.BytesIO)) def make_subarch(entries, mount, fmt): subarch = dict(fmt=fmt, entries=entries, path=mount) if fmt != "tree" or self._subarchives == []: self._subarchives.append(subarch) else: ltree = self._subarchives[-1] if ltree["fmt"] != "tree" or ltree["path"] != subarch["path"]: self._subarchives.append(subarch) else: ltree["entries"].extend(subarch["entries"]) self._subarchives[-1] = ltree if isinstance(content, pathlib.Path): content = str(content) if isinstance(content, str): if os.path.isdir(content): self._add_dir(content, path) return make_subarch(os.listdir(content), path, 'dir') elif os.path.isfile(content): assert isinstance(path, str) and path != '', \ f'Need name for binary content, but {path=}.' with io.open(content, 'rb') as f: ff = f.read() self._add_treeitem(ff, path) return make_subarch([path], None, 'tree') else: raise ValueError(f'Not a file or directory: {content!r}') elif is_binary_data(content): assert isinstance(path, str) and path != '' \ f'Need name for binary content, but {path=}.' self._add_treeitem(content, path) return make_subarch([path], None, 'tree') elif isinstance(content, zipfile.ZipFile): filename = getattr(content, "filename", None) if filename is None: fp = content.fp.getvalue() self._add_ziptarmemory(fp, 1, path) else: self._add_ziptarfile(filename, 1, path) return make_subarch(content.namelist(), path, 'zip') elif isinstance(content, tarfile.TarFile): filename = getattr(content.fileobj, "name", None) if filename is None: fp = content.fileobj if not isinstance(fp, io.BytesIO): fp = fp.fileobj self._add_ziptarmemory(fp.getvalue(), 0, path) else: self._add_ziptarfile(filename, 0, path) return make_subarch(content.getnames(), path, 'tar') elif isinstance(content, Archive): self._add_arch(content, path) return make_subarch([], path, 'multi') if isinstance(content, tuple) and len(content) == 2: # covers the tree item plus path data, name = content assert isinstance(name, str), f'Unexpected {type(name)=}' if is_binary_data(data): self._add_treeitem(data, name, path=path) elif isinstance(data, str): if os.path.isfile(data): with io.open(data, 'rb') as f: ff = f.read() self._add_treeitem(ff, name, path=path) else: assert 0, f'Unexpected {type(data)=}.' return make_subarch([name], path, 'tree') elif hasattr(content, '__getitem__'): # Deal with sequence of disparate items. for item in content: self.add(item, path) return else: raise TypeError(f'Unrecognised type {type(content)}.') assert 0 @property def entry_list( self): ''' List of sub archives. ''' return self._subarchives def has_entry( self, name): return mupdf.fz_has_archive_entry( self.this, name) def read_entry( self, name): buff = mupdf.fz_read_archive_entry( self.this, name) return JM_BinFromBuffer( buff) class Xml: def __enter__(self): return self def __exit__(self, *args): pass def __init__(self, rhs): if isinstance(rhs, mupdf.FzXml): self.this = rhs elif isinstance(rhs, str): buff = mupdf.fz_new_buffer_from_copied_data(rhs) self.this = mupdf.fz_parse_xml_from_html5(buff) else: assert 0, f'Unsupported type for rhs: {type(rhs)}' def _get_node_tree( self): def show_node(node, items, shift): while node is not None: if node.is_text: items.append((shift, f'"{node.text}"')) node = node.next continue items.append((shift, f"({node.tagname}")) for k, v in node.get_attributes().items(): items.append((shift, f"={k} '{v}'")) child = node.first_child if child: items = show_node(child, items, shift + 1) items.append((shift, f"){node.tagname}")) node = node.next return items shift = 0 items = [] items = show_node(self, items, shift) return items def add_bullet_list(self): """Add bulleted list ("ul" tag)""" child = self.create_element("ul") self.append_child(child) return child def add_class(self, text): """Set some class via CSS. Replaces complete class spec.""" cls = self.get_attribute_value("class") if cls is not None and text in cls: return self self.remove_attribute("class") if cls is None: cls = text else: cls += " " + text self.set_attribute("class", cls) return self def add_code(self, text=None): """Add a "code" tag""" child = self.create_element("code") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev is None: prev = self prev.append_child(child) return self def add_codeblock(self): """Add monospaced lines ("pre" node)""" child = self.create_element("pre") self.append_child(child) return child def add_description_list(self): """Add description list ("dl" tag)""" child = self.create_element("dl") self.append_child(child) return child def add_division(self): """Add "div" tag""" child = self.create_element("div") self.append_child(child) return child def add_header(self, level=1): """Add header tag""" if level not in range(1, 7): raise ValueError("Header level must be in [1, 6]") this_tag = self.tagname new_tag = f"h{level}" child = self.create_element(new_tag) if this_tag not in ("h1", "h2", "h3", "h4", "h5", "h6", "p"): self.append_child(child) return child self.parent.append_child(child) return child def add_horizontal_line(self): """Add horizontal line ("hr" tag)""" child = self.create_element("hr") self.append_child(child) return child def add_image(self, name, width=None, height=None, imgfloat=None, align=None): """Add image node (tag "img").""" child = self.create_element("img") if width is not None: child.set_attribute("width", f"{width}") if height is not None: child.set_attribute("height", f"{height}") if imgfloat is not None: child.set_attribute("style", f"float: {imgfloat}") if align is not None: child.set_attribute("align", f"{align}") child.set_attribute("src", f"{name}") self.append_child(child) return child def add_link(self, href, text=None): """Add a hyperlink ("a" tag)""" child = self.create_element("a") if not isinstance(text, str): text = href child.set_attribute("href", href) child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev is None: prev = self prev.append_child(child) return self def add_list_item(self): """Add item ("li" tag) under a (numbered or bulleted) list.""" if self.tagname not in ("ol", "ul"): raise ValueError("cannot add list item to", self.tagname) child = self.create_element("li") self.append_child(child) return child def add_number_list(self, start=1, numtype=None): """Add numbered list ("ol" tag)""" child = self.create_element("ol") if start > 1: child.set_attribute("start", str(start)) if numtype is not None: child.set_attribute("type", numtype) self.append_child(child) return child def add_paragraph(self): """Add "p" tag""" child = self.create_element("p") if self.tagname != "p": self.append_child(child) else: self.parent.append_child(child) return child def add_span(self): child = self.create_element("span") self.append_child(child) return child def add_style(self, text): """Set some style via CSS style. Replaces complete style spec.""" style = self.get_attribute_value("style") if style is not None and text in style: return self self.remove_attribute("style") if style is None: style = text else: style += ";" + text self.set_attribute("style", style) return self def add_subscript(self, text=None): """Add a subscript ("sub" tag)""" child = self.create_element("sub") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev is None: prev = self prev.append_child(child) return self def add_superscript(self, text=None): """Add a superscript ("sup" tag)""" child = self.create_element("sup") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev is None: prev = self prev.append_child(child) return self def add_text(self, text): """Add text. Line breaks are honored.""" lines = text.splitlines() line_count = len(lines) prev = self.span_bottom() if prev is None: prev = self for i, line in enumerate(lines): prev.append_child(self.create_text_node(line)) if i < line_count - 1: prev.append_child(self.create_element("br")) return self def append_child( self, child): mupdf.fz_dom_append_child( self.this, child.this) def append_styled_span(self, style): span = self.create_element("span") span.add_style(style) prev = self.span_bottom() if prev is None: prev = self prev.append_child(span) return prev def bodytag( self): return Xml( mupdf.fz_dom_body( self.this)) def clone( self): ret = mupdf.fz_dom_clone( self.this) return Xml( ret) @staticmethod def color_text(color): if type(color) is str: return color if type(color) is int: return f"rgb({sRGB_to_rgb(color)})" if type(color) in (tuple, list): return f"rgb{tuple(color)}" return color def create_element( self, tag): return Xml( mupdf.fz_dom_create_element( self.this, tag)) def create_text_node( self, text): return Xml( mupdf.fz_dom_create_text_node( self.this, text)) def debug(self): """Print a list of the node tree below self.""" items = self._get_node_tree() for item in items: message(" " * item[0] + item[1].replace("\n", "\\n")) def find( self, tag, att, match): ret = mupdf.fz_dom_find( self.this, tag, att, match) if ret.m_internal: return Xml( ret) def find_next( self, tag, att, match): ret = mupdf.fz_dom_find_next( self.this, tag, att, match) if ret.m_internal: return Xml( ret) @property def first_child( self): if mupdf.fz_xml_text( self.this): # text node, has no child. return ret = mupdf.fz_dom_first_child( self) if ret.m_internal: return Xml( ret) def get_attribute_value( self, key): assert key return mupdf.fz_dom_attribute( self.this, key) def get_attributes( self): if mupdf.fz_xml_text( self.this): # text node, has no attributes. return result = dict() i = 0 while 1: val, key = mupdf.fz_dom_get_attribute( self.this, i) if not val or not key: break result[ key] = val i += 1 return result def insert_after( self, node): mupdf.fz_dom_insert_after( self.this, node.this) def insert_before( self, node): mupdf.fz_dom_insert_before( self.this, node.this) def insert_text(self, text): lines = text.splitlines() line_count = len(lines) for i, line in enumerate(lines): self.append_child(self.create_text_node(line)) if i < line_count - 1: self.append_child(self.create_element("br")) return self @property def is_text(self): """Check if this is a text node.""" return self.text is not None @property def last_child(self): """Return last child node.""" child = self.first_child if child is None: return None while True: next = child.next if not next: return child child = next @property def next( self): ret = mupdf.fz_dom_next( self.this) if ret.m_internal: return Xml( ret) @property def parent( self): ret = mupdf.fz_dom_parent( self.this) if ret.m_internal: return Xml( ret) @property def previous( self): ret = mupdf.fz_dom_previous( self.this) if ret.m_internal: return Xml( ret) def remove( self): mupdf.fz_dom_remove( self.this) def remove_attribute( self, key): assert key mupdf.fz_dom_remove_attribute( self.this, key) @property def root( self): return Xml( mupdf.fz_xml_root( self.this)) def set_align(self, align): """Set text alignment via CSS style""" if isinstance( align, str): t = align elif align == TEXT_ALIGN_LEFT: t = "left" elif align == TEXT_ALIGN_CENTER: t = "center" elif align == TEXT_ALIGN_RIGHT: t = "right" elif align == TEXT_ALIGN_JUSTIFY: t = "justify" else: raise ValueError(f"Unrecognised {align=}") self.add_style(f"text-align: {t}") return self def set_attribute( self, key, value): assert key mupdf.fz_dom_add_attribute( self.this, key, value) def set_bgcolor(self, color): """Set background color via CSS style""" self.add_style(f'background-color: {self.color_text(color)}') # does not work on span level return self def set_bold(self, val=True): """Set bold on / off via CSS style""" if val: val="bold" else: val="normal" self.append_styled_span(f"font-weight: {val}") return self def set_color(self, color): """Set text color via CSS style""" self.append_styled_span(f"color: {self.color_text(color)}") return self def set_columns(self, cols): """Set number of text columns via CSS style""" self.append_styled_span(f"columns: {cols}") return self def set_font(self, font): """Set font-family name via CSS style""" self.append_styled_span(f"font-family: {font}") return self def set_fontsize(self, fontsize): """Set font size name via CSS style""" if type(fontsize) is str: px="" else: px="px" text = f"font-size: {fontsize}{px}" self.append_styled_span(text) return self def set_id(self, unique): """Set a unique id.""" # check uniqueness root = self.root if root.find(None, "id", unique): raise ValueError(f"id '{unique}' already exists") self.set_attribute("id", unique) return self def set_italic(self, val=True): """Set italic on / off via CSS style""" if val: val="italic" else: val="normal" self.append_styled_span(f"font-style: {val}") return self def set_leading(self, leading): """Set inter-line spacing value via CSS style - block-level only.""" self.add_style(f"-mupdf-leading: {leading}") return self def set_letter_spacing(self, spacing): """Set inter-letter spacing value via CSS style""" self.append_styled_span(f"letter-spacing: {spacing}") return self def set_lineheight(self, lineheight): """Set line height name via CSS style - block-level only.""" self.add_style(f"line-height: {lineheight}") return self def set_margins(self, val): """Set margin values via CSS style""" self.append_styled_span(f"margins: {val}") return self def set_opacity(self, opacity): """Set opacity via CSS style""" self.append_styled_span(f"opacity: {opacity}") return self def set_pagebreak_after(self): """Insert a page break after this node.""" self.add_style("page-break-after: always") return self def set_pagebreak_before(self): """Insert a page break before this node.""" self.add_style("page-break-before: always") return self def set_properties( self, align=None, bgcolor=None, bold=None, color=None, columns=None, font=None, fontsize=None, indent=None, italic=None, leading=None, letter_spacing=None, lineheight=None, margins=None, pagebreak_after=None, pagebreak_before=None, word_spacing=None, unqid=None, cls=None, ): """Set any or all properties of a node. To be used for existing nodes preferably. """ root = self.root temp = root.add_division() if align is not None: temp.set_align(align) if bgcolor is not None: temp.set_bgcolor(bgcolor) if bold is not None: temp.set_bold(bold) if color is not None: temp.set_color(color) if columns is not None: temp.set_columns(columns) if font is not None: temp.set_font(font) if fontsize is not None: temp.set_fontsize(fontsize) if indent is not None: temp.set_text_indent(indent) if italic is not None: temp.set_italic(italic) if leading is not None: temp.set_leading(leading) if letter_spacing is not None: temp.set_letter_spacing(letter_spacing) if lineheight is not None: temp.set_lineheight(lineheight) if margins is not None: temp.set_margins(margins) if pagebreak_after is not None: temp.set_pagebreak_after() if pagebreak_before is not None: temp.set_pagebreak_before() if word_spacing is not None: temp.set_word_spacing(word_spacing) if unqid is not None: self.set_id(unqid) if cls is not None: self.add_class(cls) styles = [] top_style = temp.get_attribute_value("style") if top_style is not None: styles.append(top_style) child = temp.first_child while child: styles.append(child.get_attribute_value("style")) child = child.first_child self.set_attribute("style", ";".join(styles)) temp.remove() return self def set_text_indent(self, indent): """Set text indentation name via CSS style - block-level only.""" self.add_style(f"text-indent: {indent}") return self def set_underline(self, val="underline"): self.append_styled_span(f"text-decoration: {val}") return self def set_word_spacing(self, spacing): """Set inter-word spacing value via CSS style""" self.append_styled_span(f"word-spacing: {spacing}") return self def span_bottom(self): """Find deepest level in stacked spans.""" parent = self child = self.last_child if child is None: return None while child.is_text: child = child.previous if child is None: break if child is None or child.tagname != "span": return None while True: if child is None: return parent if child.tagname in ("a", "sub","sup","body") or child.is_text: child = child.next continue if child.tagname == "span": parent = child child = child.first_child else: return parent @property def tagname( self): return mupdf.fz_xml_tag( self.this) @property def text( self): return mupdf.fz_xml_text( self.this) add_var = add_code add_samp = add_code add_kbd = add_code class Colorspace: def __init__(self, type_): """Supported are GRAY, RGB and CMYK.""" if isinstance( type_, mupdf.FzColorspace): self.this = type_ elif type_ == CS_GRAY: self.this = mupdf.FzColorspace(mupdf.FzColorspace.Fixed_GRAY) elif type_ == CS_CMYK: self.this = mupdf.FzColorspace(mupdf.FzColorspace.Fixed_CMYK) elif type_ == CS_RGB: self.this = mupdf.FzColorspace(mupdf.FzColorspace.Fixed_RGB) else: self.this = mupdf.FzColorspace(mupdf.FzColorspace.Fixed_RGB) def __repr__(self): x = ("", "GRAY", "", "RGB", "CMYK")[self.n] return f"Colorspace(CS_{x}) - {self.name}" def _name(self): return mupdf.fz_colorspace_name(self.this) @property def n(self): """Size of one pixel.""" return mupdf.fz_colorspace_n(self.this) @property def name(self): """Name of the Colorspace.""" return self._name() class DeviceWrapper: def __init__(self, *args): if args_match( args, mupdf.FzDevice): device, = args self.this = device elif args_match( args, Pixmap, None): pm, clip = args bbox = JM_irect_from_py( clip) if mupdf.fz_is_infinite_irect( bbox): self.this = mupdf.fz_new_draw_device( mupdf.FzMatrix(), pm) else: self.this = mupdf.fz_new_draw_device_with_bbox( mupdf.FzMatrix(), pm, bbox) elif args_match( args, mupdf.FzDisplayList): dl, = args self.this = mupdf.fz_new_list_device( dl) elif args_match( args, mupdf.FzStextPage, None): tp, flags = args opts = mupdf.FzStextOptions( flags) self.this = mupdf.fz_new_stext_device( tp, opts) else: raise Exception( f'Unrecognised args for DeviceWrapper: {args!r}') class DisplayList: def __del__(self): if not type(self) is DisplayList: return self.thisown = False def __init__(self, *args): if len(args) == 1 and isinstance(args[0], mupdf.FzRect): self.this = mupdf.FzDisplayList(args[0]) elif len(args) == 1 and isinstance(args[0], mupdf.FzDisplayList): self.this = args[0] else: assert 0, f'Unrecognised {args=}' def get_pixmap(self, matrix=None, colorspace=None, alpha=0, clip=None): if isinstance(colorspace, Colorspace): colorspace = colorspace.this else: colorspace = mupdf.FzColorspace(mupdf.FzColorspace.Fixed_RGB) val = JM_pixmap_from_display_list(self.this, matrix, colorspace, alpha, clip, None) val.thisown = True return val def get_textpage(self, flags=3): """Make a TextPage from a DisplayList.""" stext_options = mupdf.FzStextOptions() stext_options.flags = flags val = mupdf.FzStextPage(self.this, stext_options) val.thisown = True return val @property def rect(self): val = JM_py_from_rect(mupdf.fz_bound_display_list(self.this)) val = Rect(val) return val def run(self, dw, m, area): mupdf.fz_run_display_list( self.this, dw.device, JM_matrix_from_py(m), JM_rect_from_py(area), mupdf.FzCookie(), ) if g_use_extra: extra_FzDocument_insert_pdf = extra.FzDocument_insert_pdf class Document: def __contains__(self, loc) -> bool: if type(loc) is int: if loc < self.page_count: return True return False if type(loc) not in (tuple, list) or len(loc) != 2: return False chapter, pno = loc if (0 or not isinstance(chapter, int) or chapter < 0 or chapter >= self.chapter_count ): return False if (0 or not isinstance(pno, int) or pno < 0 or pno >= self.chapter_page_count(chapter) ): return False return True def __delitem__(self, i)->None: if not self.is_pdf: raise ValueError("is no PDF") if type(i) is int: return self.delete_page(i) if type(i) in (list, tuple, range): return self.delete_pages(i) if type(i) is not slice: raise ValueError("bad argument type") pc = self.page_count start = i.start if i.start else 0 stop = i.stop if i.stop else pc step = i.step if i.step else 1 while start < 0: start += pc if start >= pc: raise ValueError("bad page number(s)") while stop < 0: stop += pc if stop > pc: raise ValueError("bad page number(s)") return self.delete_pages(range(start, stop, step)) def __enter__(self): return self def __exit__(self, *args): self.close() @typing.overload def __getitem__(self, i: int = 0) -> Page: ... if sys.version_info >= (3, 9): @typing.overload def __getitem__(self, i: slice) -> list[Page]: ... @typing.overload def __getitem__(self, i: tuple[int, int]) -> Page: ... def __getitem__(self, i=0): if isinstance(i, slice): return [self[j] for j in range(*i.indices(len(self)))] assert isinstance(i, int) or (isinstance(i, tuple) and len(i) == 2 and all(isinstance(x, int) for x in i)), \ f'Invalid item number: {i=}.' if i not in self: raise IndexError(f"page {i} not in document") return self.load_page(i) def __init__(self, filename=None, stream=None, filetype=None, rect=None, width=0, height=0, fontsize=11): """Creates a document. Use 'open' as a synonym. Notes: Basic usages: open() - new PDF document open(filename) - string or pathlib.Path, must have supported file extension. open(type, buffer) - type: valid extension, buffer: bytes object. open(stream=buffer, filetype=type) - keyword version of previous. open(filename, fileype=type) - filename with unrecognized extension. rect, width, height, fontsize: layout reflowable document on open (e.g. EPUB). Ignored if n/a. """ # We temporarily set JM_mupdf_show_errors=0 while we are constructing, # then restore its original value in a `finally:` block. # global JM_mupdf_show_errors JM_mupdf_show_errors_old = JM_mupdf_show_errors JM_mupdf_show_errors = 0 try: self.is_closed = False self.is_encrypted = False self.is_encrypted = False self.metadata = None self.FontInfos = [] self.Graftmaps = {} self.ShownPages = {} self.InsertedImages = {} self._page_refs = weakref.WeakValueDictionary() if isinstance(filename, mupdf.PdfDocument): pdf_document = filename self.this = pdf_document self.this_is_pdf = True return w = width h = height r = JM_rect_from_py(rect) if not mupdf.fz_is_infinite_rect(r): w = r.x1 - r.x0 h = r.y1 - r.y0 self._name = filename self.stream = stream if stream is not None: if filename is not None and filetype is None: # 2025-05-06: Use as the filetype. This is # reversing precedence - we used to use if both # were set. filetype = filename if isinstance(stream, (bytes, memoryview)): pass elif isinstance(stream, bytearray): stream = bytes(stream) elif isinstance(stream, io.BytesIO): stream = stream.getvalue() else: raise TypeError(f"bad stream: {type(stream)=}.") self.stream = stream assert isinstance(stream, (bytes, memoryview)) if len(stream) == 0: # MuPDF raise an exception for this but also generates # warnings, which is not very helpful for us. So instead we # raise a specific exception. raise EmptyFileError('Cannot open empty stream.') stream2 = mupdf.fz_open_memory(mupdf.python_buffer_data(stream), len(stream)) try: doc = mupdf.fz_open_document_with_stream(filetype if filetype else '', stream2) except Exception as e: if g_exceptions_verbose > 1: exception_info() raise FileDataError('Failed to open stream') from e elif filename: assert not stream if isinstance(filename, str): pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name else: raise TypeError(f"bad filename: {type(filename)=} {filename=}.") self._name = filename # Generate our own specific exceptions. This avoids MuPDF # generating warnings etc. if not os.path.exists(filename): raise FileNotFoundError(f"no such file: '{filename}'") elif not os.path.isfile(filename): raise FileDataError(f"'{filename}' is no file") elif os.path.getsize(filename) == 0: raise EmptyFileError(f'Cannot open empty file: {filename=}.') if filetype: # Override the type implied by . MuPDF does not # have a way to do this directly so we open via a stream. try: fz_stream = mupdf.fz_open_file(filename) doc = mupdf.fz_open_document_with_stream(filetype, fz_stream) except Exception as e: if g_exceptions_verbose > 1: exception_info() raise FileDataError(f'Failed to open file {filename!r} as type {filetype!r}.') from e else: try: doc = mupdf.fz_open_document(filename) except Exception as e: if g_exceptions_verbose > 1: exception_info() raise FileDataError(f'Failed to open file {filename!r}.') from e else: pdf = mupdf.PdfDocument() doc = mupdf.FzDocument(pdf) if w > 0 and h > 0: mupdf.fz_layout_document(doc, w, h, fontsize) elif mupdf.fz_is_document_reflowable(doc): mupdf.fz_layout_document(doc, 400, 600, 11) self.this = doc # fixme: not sure where self.thisown gets initialised in PyMuPDF. # self.thisown = True if self.thisown: self._graft_id = TOOLS.gen_id() if self.needs_pass: self.is_encrypted = True else: # we won't init until doc is decrypted self.init_doc() # the following hack detects invalid/empty SVG files, which else may lead # to interpreter crashes if filename and filename.lower().endswith("svg") or filetype and "svg" in filetype.lower(): try: _ = self.convert_to_pdf() # this seems to always work except Exception as e: if g_exceptions_verbose > 1: exception_info() raise FileDataError("cannot open broken document") from e if g_use_extra: self.this_is_pdf = isinstance( self.this, mupdf.PdfDocument) if self.this_is_pdf: self.page_count2 = extra.page_count_pdf else: self.page_count2 = extra.page_count_fz finally: JM_mupdf_show_errors = JM_mupdf_show_errors_old def __len__(self) -> int: return self.page_count def __repr__(self) -> str: is_closed = "closed " if self.is_closed else "" if self.stream is None: if self.name == "": return f"{is_closed}Document()" return f"{is_closed}Document('{self.name}')" return f"{is_closed}Document('{self.name}', )" def _addFormFont(self, name, font): """Add new form font.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return fonts = mupdf.pdf_dict_getl( mupdf.pdf_trailer( pdf), PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('DR'), PDF_NAME('Font'), ) if not fonts.m_internal or not mupdf.pdf_is_dict( fonts): raise RuntimeError( "PDF has no form fonts yet") k = mupdf.pdf_new_name( name) v = JM_pdf_obj_from_str( pdf, font) mupdf.pdf_dict_put( fonts, k, v) def del_toc_item( self, idx: int, ) -> None: """Delete TOC / bookmark item by index.""" xref = self.get_outline_xrefs()[idx] self._remove_toc_item(xref) def _delToC(self): """Delete the TOC.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") xrefs = [] # create Python list pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return xrefs # not a pdf # get the main root root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) # get the outline root olroot = mupdf.pdf_dict_get(root, PDF_NAME('Outlines')) if not olroot.m_internal: return xrefs # no outlines or some problem first = mupdf.pdf_dict_get(olroot, PDF_NAME('First')) # first outline xrefs = JM_outline_xrefs(first, xrefs) xref_count = len(xrefs) olroot_xref = mupdf.pdf_to_num(olroot) # delete OL root mupdf.pdf_delete_object(pdf, olroot_xref) # delete OL root mupdf.pdf_dict_del(root, PDF_NAME('Outlines')) # delete OL root for i in range(xref_count): _, xref = JM_INT_ITEM(xrefs, i) mupdf.pdf_delete_object(pdf, xref) # delete outline item xrefs.append(olroot_xref) val = xrefs self.init_doc() return val def _delete_page(self, pno): pdf = _as_pdf_document(self) mupdf.pdf_delete_page( pdf, pno) if pdf.m_internal.rev_page_map: mupdf.ll_pdf_drop_page_tree( pdf.m_internal) def _deleteObject(self, xref): """Delete object.""" pdf = _as_pdf_document(self) if not _INRANGE(xref, 1, mupdf.pdf_xref_len(pdf)-1): raise ValueError( MSG_BAD_XREF) mupdf.pdf_delete_object(pdf, xref) def _do_links( doc1: 'Document', doc2: 'Document', from_page: int = -1, to_page: int = -1, start_at: int = -1, ) -> None: """Insert links contained in copied page range into destination PDF. Parameter values **must** equal those of method insert_pdf(), which must have been previously executed. """ #pymupdf.log( 'utils.do_links()') # -------------------------------------------------------------------------- # internal function to create the actual "/Annots" object string # -------------------------------------------------------------------------- def cre_annot(lnk, xref_dst, pno_src, ctm): """Create annotation object string for a passed-in link.""" r = lnk["from"] * ctm # rect in PDF coordinates rect = _format_g(tuple(r)) if lnk["kind"] == LINK_GOTO: txt = annot_skel["goto1"] # annot_goto idx = pno_src.index(lnk["page"]) p = lnk["to"] * ctm # target point in PDF coordinates annot = txt(xref_dst[idx], p.x, p.y, lnk["zoom"], rect) elif lnk["kind"] == LINK_GOTOR: if lnk["page"] >= 0: txt = annot_skel["gotor1"] # annot_gotor pnt = lnk.get("to", Point(0, 0)) # destination point if type(pnt) is not Point: pnt = Point(0, 0) annot = txt( lnk["page"], pnt.x, pnt.y, lnk["zoom"], lnk["file"], lnk["file"], rect, ) else: txt = annot_skel["gotor2"] # annot_gotor_n to = get_pdf_str(lnk["to"]) to = to[1:-1] f = lnk["file"] annot = txt(to, f, rect) elif lnk["kind"] == LINK_LAUNCH: txt = annot_skel["launch"] # annot_launch annot = txt(lnk["file"], lnk["file"], rect) elif lnk["kind"] == LINK_URI: txt = annot_skel["uri"] # annot_uri annot = txt(lnk["uri"], rect) else: annot = "" return annot # -------------------------------------------------------------------------- # validate & normalize parameters if from_page < 0: fp = 0 elif from_page >= doc2.page_count: fp = doc2.page_count - 1 else: fp = from_page if to_page < 0 or to_page >= doc2.page_count: tp = doc2.page_count - 1 else: tp = to_page if start_at < 0: raise ValueError("'start_at' must be >= 0") sa = start_at incr = 1 if fp <= tp else -1 # page range could be reversed # lists of source / destination page numbers pno_src = list(range(fp, tp + incr, incr)) pno_dst = [sa + i for i in range(len(pno_src))] # lists of source / destination page xrefs xref_src = [] xref_dst = [] for i in range(len(pno_src)): p_src = pno_src[i] p_dst = pno_dst[i] old_xref = doc2.page_xref(p_src) new_xref = doc1.page_xref(p_dst) xref_src.append(old_xref) xref_dst.append(new_xref) # create the links for each copied page in destination PDF for i in range(len(xref_src)): page_src = doc2[pno_src[i]] # load source page links = page_src.get_links() # get all its links #log(f'{pno_src=}') #log(f'{type(page_src)=}') #log(f'{page_src=}') #log(f'{=i len(links)}') if len(links) == 0: # no links there page_src = None continue page_dst = doc1[pno_dst[i]] # load destination page # In our call above to page_src.get_links(), we end up in # fz_load_links(). This extracts the raw rects (encoded as strings # such as `/Rect[10 782 40 822]`) and multiplies them by page_ctm # from pdf_page_transform(). # # We want to recreate the original raw rects, so we need to # multiply by inverse of page_ctm. This fixes #4958. ctm = mupdf.FzMatrix() page_src_pdf_document = _as_pdf_page(page_src) mupdf.pdf_page_transform(page_src_pdf_document, mupdf.FzRect(0), ctm) ictm = Matrix(mupdf.fz_invert_matrix(ctm)) link_tab = [] # store all link definitions here for l in links: if l["kind"] == LINK_GOTO and (l["page"] not in pno_src): continue # GOTO link target not in copied pages annot_text = cre_annot(l, xref_dst, pno_src, ictm) if annot_text: link_tab.append(annot_text) if link_tab != []: page_dst._addAnnot_FromString( tuple(link_tab)) #log( 'utils.do_links() returning.') def _do_widgets( tar: 'Document', src: 'Document', graftmap, from_page: int = -1, to_page: int = -1, start_at: int = -1, join_duplicates=0, ) -> None: """Insert widgets of copied page range into target PDF. Parameter values **must** equal those of method insert_pdf() which must have been previously executed. """ if not src.is_form_pdf: # nothing to do: source PDF has no fields return def clean_kid_parents(acro_fields): """ Make sure all kids have correct "Parent" pointers.""" for i in range(acro_fields.pdf_array_len()): parent = acro_fields.pdf_array_get(i) kids = parent.pdf_dict_get(PDF_NAME("Kids")) for j in range(kids.pdf_array_len()): kid = kids.pdf_array_get(j) kid.pdf_dict_put(PDF_NAME("Parent"), parent) def join_widgets(pdf, acro_fields, xref1, xref2, name): """Called for each pair of widgets having the same name. Args: pdf: target MuPDF document acro_fields: object Root/AcroForm/Fields xref1, xref2: widget xrefs having same names name: (str) the name Result: Defined or updated widget parent that points to both widgets. """ def re_target(pdf, acro_fields, xref1, kids1, xref2, kids2): """Merge widget in xref2 into "Kids" list of widget xref1. Args: xref1, kids1: target widget and its "Kids" array. xref2, kids2: source wwidget and its "Kids" array (may be empty). """ # make indirect objects from widgets w1_ind = mupdf.pdf_new_indirect(pdf, xref1, 0) w2_ind = mupdf.pdf_new_indirect(pdf, xref2, 0) # find source widget in "Fields" array idx = acro_fields.pdf_array_find(w2_ind) acro_fields.pdf_array_delete(idx) if not kids2.pdf_is_array(): # source widget has no kids widget = mupdf.pdf_load_object(pdf, xref2) # delete name from widget and insert target as parent widget.pdf_dict_del(PDF_NAME("T")) widget.pdf_dict_put(PDF_NAME("Parent"), w1_ind) # put in target Kids kids1.pdf_array_push(w2_ind) else: # copy source kids to target kids for i in range(kids2.pdf_array_len()): kid = kids2.pdf_array_get(i) kid.pdf_dict_put(PDF_NAME("Parent"), w1_ind) kid_ind = mupdf.pdf_new_indirect(pdf, kid.pdf_to_num(), 0) kids1.pdf_array_push(kid_ind) def new_target(pdf, acro_fields, xref1, w1, xref2, w2, name): """Make new "Parent" for two widgets with same name. Args: xref1, w1: first widget xref2, w2: second widget name: field name Result: Both widgets have no "Kids". We create a new object with the name and a "Kids" array containing the widgets. Original widgets must be removed from AcroForm/Fields. """ # make new "Parent" object new = mupdf.pdf_new_dict(pdf, 5) new.pdf_dict_put_text_string(PDF_NAME("T"), name) kids = new.pdf_dict_put_array(PDF_NAME("Kids"), 2) new_obj = mupdf.pdf_add_object(pdf, new) new_obj_xref = new_obj.pdf_to_num() new_ind = mupdf.pdf_new_indirect(pdf, new_obj_xref, 0) # copy over some required source widget properties ft = w1.pdf_dict_get(PDF_NAME("FT")) w1.pdf_dict_del(PDF_NAME("FT")) new_obj.pdf_dict_put(PDF_NAME("FT"), ft) aa = w1.pdf_dict_get(PDF_NAME("AA")) w1.pdf_dict_del(PDF_NAME("AA")) new_obj.pdf_dict_put(PDF_NAME("AA"), aa) # remove name field, insert "Parent" field in source widgets w1.pdf_dict_del(PDF_NAME("T")) w1.pdf_dict_put(PDF_NAME("Parent"), new_ind) w2.pdf_dict_del(PDF_NAME("T")) w2.pdf_dict_put(PDF_NAME("Parent"), new_ind) # put source widgets in "kids" array ind1 = mupdf.pdf_new_indirect(pdf, xref1, 0) ind2 = mupdf.pdf_new_indirect(pdf, xref2, 0) kids.pdf_array_push(ind1) kids.pdf_array_push(ind2) # remove source widgets from "AcroForm/Fields" idx = acro_fields.pdf_array_find(ind1) acro_fields.pdf_array_delete(idx) idx = acro_fields.pdf_array_find(ind2) acro_fields.pdf_array_delete(idx) acro_fields.pdf_array_push(new_ind) w1 = mupdf.pdf_load_object(pdf, xref1) w2 = mupdf.pdf_load_object(pdf, xref2) kids1 = w1.pdf_dict_get(PDF_NAME("Kids")) kids2 = w2.pdf_dict_get(PDF_NAME("Kids")) # check which widget has a suitable "Kids" array if kids1.pdf_is_array(): re_target(pdf, acro_fields, xref1, kids1, xref2, kids2) # pylint: disable=arguments-out-of-order elif kids2.pdf_is_array(): re_target(pdf, acro_fields, xref2, kids2, xref1, kids1) # pylint: disable=arguments-out-of-order else: new_target(pdf, acro_fields, xref1, w1, xref2, w2, name) # pylint: disable=arguments-out-of-order def get_kids(parent, kids_list): """Return xref list of leaf kids for a parent. Call with an empty list. """ kids = mupdf.pdf_dict_get(parent, PDF_NAME("Kids")) if not kids.pdf_is_array(): return kids_list for i in range(kids.pdf_array_len()): kid = kids.pdf_array_get(i) if mupdf.pdf_is_dict(mupdf.pdf_dict_get(kid, PDF_NAME("Kids"))): kids_list = get_kids(kid, kids_list) else: kids_list.append(kid.pdf_to_num()) return kids_list def kids_xrefs(widget): """Get the xref of top "Parent" and the list of leaf widgets.""" kids_list = [] parent = mupdf.pdf_dict_get(widget, PDF_NAME("Parent")) parent_xref = parent.pdf_to_num() if parent_xref == 0: return parent_xref, kids_list kids_list = get_kids(parent, kids_list) return parent_xref, kids_list def deduplicate_names(pdf, acro_fields, join_duplicates=False): """Handle any widget name duplicates caused by the merge.""" names = {} # key is a widget name, value a list of widgets having it. # extract all names and widgets in "AcroForm/Fields" for i in range(mupdf.pdf_array_len(acro_fields)): wobject = mupdf.pdf_array_get(acro_fields, i) xref = wobject.pdf_to_num() # extract widget name and collect widget(s) using it T = mupdf.pdf_dict_get_text_string(wobject, PDF_NAME("T")) xrefs = names.get(T, []) xrefs.append(xref) names[T] = xrefs for name, xrefs in names.items(): if len(xrefs) < 2: continue xref0, xref1 = xrefs[:2] # only exactly 2 should occur! if join_duplicates: # combine fields with equal names join_widgets(pdf, acro_fields, xref0, xref1, name) else: # make field names unique newname = name + f" [{xref1}]" # append this to the name wobject = mupdf.pdf_load_object(pdf, xref1) wobject.pdf_dict_put_text_string(PDF_NAME("T"), newname) clean_kid_parents(acro_fields) def get_acroform(doc): """Retrieve the AcroForm dictionary form a PDF.""" pdf = mupdf.pdf_document_from_fz_document(doc) # AcroForm (= central form field info) return mupdf.pdf_dict_getp(mupdf.pdf_trailer(pdf), "Root/AcroForm") tarpdf = mupdf.pdf_document_from_fz_document(tar) srcpdf = mupdf.pdf_document_from_fz_document(src) if tar.is_form_pdf: # target is a Form PDF, so use it to include source fields acro = get_acroform(tar) # Important arrays in AcroForm acro_fields = acro.pdf_dict_get(PDF_NAME("Fields")) tar_co = acro.pdf_dict_get(PDF_NAME("CO")) if not tar_co.pdf_is_array(): tar_co = acro.pdf_dict_put_array(PDF_NAME("CO"), 5) else: # target is no Form PDF, so copy over source AcroForm acro = mupdf.pdf_deep_copy_obj(get_acroform(src)) # make a copy # Clear "Fields" and "CO" arrays: will be populated by page fields. # This is required to avoid copying unneeded objects. acro.pdf_dict_del(PDF_NAME("Fields")) acro.pdf_dict_put_array(PDF_NAME("Fields"), 5) acro.pdf_dict_del(PDF_NAME("CO")) acro.pdf_dict_put_array(PDF_NAME("CO"), 5) # Enrich AcroForm for copying to target acro_graft = mupdf.pdf_graft_mapped_object(graftmap, acro) # Insert AcroForm into target PDF acro_tar = mupdf.pdf_add_object(tarpdf, acro_graft) acro_fields = acro_tar.pdf_dict_get(PDF_NAME("Fields")) tar_co = acro_tar.pdf_dict_get(PDF_NAME("CO")) # get its xref and insert it into target catalog tar_xref = acro_tar.pdf_to_num() acro_tar_ind = mupdf.pdf_new_indirect(tarpdf, tar_xref, 0) root = mupdf.pdf_dict_get(mupdf.pdf_trailer(tarpdf), PDF_NAME("Root")) root.pdf_dict_put(PDF_NAME("AcroForm"), acro_tar_ind) if from_page <= to_page: src_range = range(from_page, to_page + 1) else: src_range = range(from_page, to_page - 1, -1) parents = {} # information about widget parents # remove "P" owning page reference from all widgets of all source pages for i in src_range: src_page = src[i] for xref in [ xref for xref, wtype, _ in src_page.annot_xrefs() if wtype == mupdf.PDF_ANNOT_WIDGET # pylint: disable=no-member ]: w_obj = mupdf.pdf_load_object(srcpdf, xref) w_obj.pdf_dict_del(PDF_NAME("P")) # get the widget's parent structure parent_xref, old_kids = kids_xrefs(w_obj) if parent_xref: parents[parent_xref] = { "new_xref": 0, "old_kids": old_kids, "new_kids": [], } # Copy over Parent widgets first - they are not page-dependent for xref in parents.keys(): # pylint: disable=consider-using-dict-items parent = mupdf.pdf_load_object(srcpdf, xref) parent_graft = mupdf.pdf_graft_mapped_object(graftmap, parent) parent_tar = mupdf.pdf_add_object(tarpdf, parent_graft) kids_xrefs_new = get_kids(parent_tar, []) parent_xref_new = parent_tar.pdf_to_num() parent_ind = mupdf.pdf_new_indirect(tarpdf, parent_xref_new, 0) acro_fields.pdf_array_push(parent_ind) parents[xref]["new_xref"] = parent_xref_new parents[xref]["new_kids"] = kids_xrefs_new for i in range(len(src_range)): # read first copied over page in target tar_page = tar[start_at + i] # read the original page in the source PDF src_page = src[src_range[i]] # now walk through source page widgets and copy over w_xrefs = [ # widget xrefs of the source page xref for xref, wtype, _ in src_page.annot_xrefs() if wtype == mupdf.PDF_ANNOT_WIDGET # pylint: disable=no-member ] if not w_xrefs: # no widgets on this source page continue # convert to formal PDF page tar_page_pdf = mupdf.pdf_page_from_fz_page(tar_page) # extract annotations array tar_annots = mupdf.pdf_dict_get(tar_page_pdf.obj(), PDF_NAME("Annots")) if not mupdf.pdf_is_array(tar_annots): tar_annots = mupdf.pdf_dict_put_array( tar_page_pdf.obj(), PDF_NAME("Annots"), 5 ) for xref in w_xrefs: w_obj = mupdf.pdf_load_object(srcpdf, xref) # check if field takes part in inter-field validations is_aac = mupdf.pdf_is_dict(mupdf.pdf_dict_getp(w_obj, "AA/C")) # check if parent of widget already in target parent_xref = mupdf.pdf_to_num( w_obj.pdf_dict_get(PDF_NAME("Parent")) ) if parent_xref == 0: # parent not in target yet try: w_obj_graft = mupdf.pdf_graft_mapped_object(graftmap, w_obj) except Exception as e: message_warning(f"cannot copy widget at {xref=}: {e}") continue w_obj_tar = mupdf.pdf_add_object(tarpdf, w_obj_graft) tar_xref = w_obj_tar.pdf_to_num() w_obj_tar_ind = mupdf.pdf_new_indirect(tarpdf, tar_xref, 0) mupdf.pdf_array_push(tar_annots, w_obj_tar_ind) mupdf.pdf_array_push(acro_fields, w_obj_tar_ind) else: parent = parents[parent_xref] idx = parent["old_kids"].index(xref) # search for xref in parent tar_xref = parent["new_kids"][idx] w_obj_tar_ind = mupdf.pdf_new_indirect(tarpdf, tar_xref, 0) mupdf.pdf_array_push(tar_annots, w_obj_tar_ind) # Into "AcroForm/CO" if a computation field. if is_aac: mupdf.pdf_array_push(tar_co, w_obj_tar_ind) deduplicate_names(tarpdf, acro_fields, join_duplicates=join_duplicates) def _embeddedFileGet(self, idx): pdf = _as_pdf_document(self) names = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) entry = mupdf.pdf_array_get(names, 2*idx+1) filespec = mupdf.pdf_dict_getl(entry, PDF_NAME('EF'), PDF_NAME('F')) buf = mupdf.pdf_load_stream(filespec) cont = JM_BinFromBuffer(buf) return cont def _embeddedFileIndex(self, item: typing.Union[int, str]) -> int: filenames = self.embfile_names() if item in filenames: idx = filenames.index(item) elif item in range(len(filenames)): idx = item else: raise ValueError(f"'{item}' not in EmbeddedFiles array.") return idx def _embfile_add(self, name, buffer_, filename=None, ufilename=None, desc=None): pdf = _as_pdf_document(self) data = JM_BufferFromBytes(buffer_) if not data.m_internal: raise TypeError( MSG_BAD_BUFFER) names = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) if not mupdf.pdf_is_array(names): root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) names = mupdf.pdf_new_array(pdf, 6) # an even number! mupdf.pdf_dict_putl( root, names, PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) fileentry = JM_embed_file(pdf, data, filename, ufilename, desc, 1) xref = mupdf.pdf_to_num( mupdf.pdf_dict_getl(fileentry, PDF_NAME('EF'), PDF_NAME('F')) ) mupdf.pdf_array_push(names, mupdf.pdf_new_text_string(name)) mupdf.pdf_array_push(names, fileentry) return xref def _embfile_del(self, idx): pdf = _as_pdf_document(self) names = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) mupdf.pdf_array_delete(names, idx + 1) mupdf.pdf_array_delete(names, idx) def _embfile_info(self, idx, infodict): pdf = _as_pdf_document(self) xref = 0 ci_xref=0 trailer = mupdf.pdf_trailer(pdf) names = mupdf.pdf_dict_getl( trailer, PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) o = mupdf.pdf_array_get(names, 2*idx+1) ci = mupdf.pdf_dict_get(o, PDF_NAME('CI')) if ci.m_internal: ci_xref = mupdf.pdf_to_num(ci) infodict["collection"] = ci_xref name = mupdf.pdf_to_text_string(mupdf.pdf_dict_get(o, PDF_NAME('F'))) infodict[dictkey_filename] = JM_EscapeStrFromStr(name) name = mupdf.pdf_to_text_string(mupdf.pdf_dict_get(o, PDF_NAME('UF'))) infodict[dictkey_ufilename] = JM_EscapeStrFromStr(name) name = mupdf.pdf_to_text_string(mupdf.pdf_dict_get(o, PDF_NAME('Desc'))) infodict[dictkey_descr] = JM_UnicodeFromStr(name) len_ = -1 DL = -1 fileentry = mupdf.pdf_dict_getl(o, PDF_NAME('EF'), PDF_NAME('F')) xref = mupdf.pdf_to_num(fileentry) o = mupdf.pdf_dict_get(fileentry, PDF_NAME('Length')) if o.m_internal: len_ = mupdf.pdf_to_int(o) o = mupdf.pdf_dict_get(fileentry, PDF_NAME('DL')) if o.m_internal: DL = mupdf.pdf_to_int(o) else: o = mupdf.pdf_dict_getl(fileentry, PDF_NAME('Params'), PDF_NAME('Size')) if o.m_internal: DL = mupdf.pdf_to_int(o) infodict[dictkey_size] = DL infodict[dictkey_length] = len_ return xref def _embfile_names(self, namelist): """Get list of embedded file names.""" pdf = _as_pdf_document(self) names = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) if mupdf.pdf_is_array(names): n = mupdf.pdf_array_len(names) for i in range(0, n, 2): val = JM_EscapeStrFromStr( mupdf.pdf_to_text_string( mupdf.pdf_array_get(names, i) ) ) namelist.append(val) def _embfile_upd(self, idx, buffer_=None, filename=None, ufilename=None, desc=None): pdf = _as_pdf_document(self) xref = 0 names = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) entry = mupdf.pdf_array_get(names, 2*idx+1) filespec = mupdf.pdf_dict_getl(entry, PDF_NAME('EF'), PDF_NAME('F')) if not filespec.m_internal: RAISEPY( "bad PDF: no /EF object", JM_Exc_FileDataError) res = JM_BufferFromBytes(buffer_) if buffer_ and buffer_.m_internal and not res.m_internal: raise TypeError( MSG_BAD_BUFFER) if res.m_internal and buffer_ and buffer_.m_internal: JM_update_stream(pdf, filespec, res, 1) # adjust /DL and /Size parameters len, _ = mupdf.fz_buffer_storage(res) l = mupdf.pdf_new_int(len) mupdf.pdf_dict_put(filespec, PDF_NAME('DL'), l) mupdf.pdf_dict_putl(filespec, l, PDF_NAME('Params'), PDF_NAME('Size')) xref = mupdf.pdf_to_num(filespec) if filename: mupdf.pdf_dict_put_text_string(entry, PDF_NAME('F'), filename) if ufilename: mupdf.pdf_dict_put_text_string(entry, PDF_NAME('UF'), ufilename) if desc: mupdf.pdf_dict_put_text_string(entry, PDF_NAME('Desc'), desc) return xref def _extend_toc_items(self, items): """Add color info to all items of an extended TOC list.""" if self.is_closed: raise ValueError("document closed") if g_use_extra: return extra.Document_extend_toc_items( self.this, items) pdf = _as_pdf_document(self) zoom = "zoom" bold = "bold" italic = "italic" collapse = "collapse" root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) if not root.m_internal: return olroot = mupdf.pdf_dict_get(root, PDF_NAME('Outlines')) if not olroot.m_internal: return first = mupdf.pdf_dict_get(olroot, PDF_NAME('First')) if not first.m_internal: return xrefs = [] xrefs = JM_outline_xrefs(first, xrefs) n = len(xrefs) m = len(items) if not n: return if n != m: raise IndexError( "internal error finding outline xrefs") # update all TOC item dictionaries for i in range(n): xref = int(xrefs[i]) item = items[i] itemdict = item[3] if not isinstance(itemdict, dict): raise ValueError( "need non-simple TOC format") itemdict[dictkey_xref] = xrefs[i] bm = mupdf.pdf_load_object(pdf, xref) flags = mupdf.pdf_to_int( mupdf.pdf_dict_get(bm, PDF_NAME('F'))) if flags == 1: itemdict[italic] = True elif flags == 2: itemdict[bold] = True elif flags == 3: itemdict[italic] = True itemdict[bold] = True count = mupdf.pdf_to_int( mupdf.pdf_dict_get(bm, PDF_NAME('Count'))) if count < 0: itemdict[collapse] = True elif count > 0: itemdict[collapse] = False col = mupdf.pdf_dict_get(bm, PDF_NAME('C')) if mupdf.pdf_is_array(col) and mupdf.pdf_array_len(col) == 3: color = ( mupdf.pdf_to_real(mupdf.pdf_array_get(col, 0)), mupdf.pdf_to_real(mupdf.pdf_array_get(col, 1)), mupdf.pdf_to_real(mupdf.pdf_array_get(col, 2)), ) itemdict[dictkey_color] = color z=0 obj = mupdf.pdf_dict_get(bm, PDF_NAME('Dest')) if not obj.m_internal or not mupdf.pdf_is_array(obj): obj = mupdf.pdf_dict_getl(bm, PDF_NAME('A'), PDF_NAME('D')) if mupdf.pdf_is_array(obj) and mupdf.pdf_array_len(obj) == 5: z = mupdf.pdf_to_real(mupdf.pdf_array_get(obj, 4)) itemdict[zoom] = float(z) item[3] = itemdict items[i] = item def _forget_page(self, page: Page): """Remove a page from document page dict.""" pid = id(page) if pid in self._page_refs: #self._page_refs[pid] = None del self._page_refs[pid] def _get_char_widths(self, xref: int, bfname: str, ext: str, ordering: int, limit: int, idx: int = 0): pdf = _as_pdf_document(self) mylimit = limit if mylimit < 256: mylimit = 256 if ordering >= 0: data, size, index = mupdf.fz_lookup_cjk_font(ordering) font = mupdf.fz_new_font_from_memory(None, data, size, index, 0) else: data, size = mupdf.fz_lookup_base14_font(bfname) if data: font = mupdf.fz_new_font_from_memory(bfname, data, size, 0, 0) else: buf = JM_get_fontbuffer(pdf, xref) if not buf.m_internal: raise Exception(f"font at xref {xref:d} is not supported") font = mupdf.fz_new_font_from_buffer(None, buf, idx, 0) wlist = [] for i in range(mylimit): glyph = mupdf.fz_encode_character(font, i) adv = mupdf.fz_advance_glyph(font, glyph, 0) if ordering >= 0: glyph = i if glyph > 0: wlist.append( (glyph, adv)) else: wlist.append( (glyph, 0.0)) return wlist def _get_page_labels(self): pdf = _as_pdf_document(self) rc = [] pagelabels = mupdf.pdf_new_name("PageLabels") obj = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), pagelabels) if not obj.m_internal: return rc # simple case: direct /Nums object nums = mupdf.pdf_resolve_indirect( mupdf.pdf_dict_get( obj, PDF_NAME('Nums'))) if nums.m_internal: JM_get_page_labels(rc, nums) return rc # case: /Kids/Nums nums = mupdf.pdf_resolve_indirect( mupdf.pdf_dict_getl(obj, PDF_NAME('Kids'), PDF_NAME('Nums'))) if nums.m_internal: JM_get_page_labels(rc, nums) return rc # case: /Kids is an array of multiple /Nums kids = mupdf.pdf_resolve_indirect( mupdf.pdf_dict_get( obj, PDF_NAME('Kids'))) if not kids.m_internal or not mupdf.pdf_is_array(kids): return rc n = mupdf.pdf_array_len(kids) for i in range(n): nums = mupdf.pdf_resolve_indirect( mupdf.pdf_dict_get( mupdf.pdf_array_get(kids, i), PDF_NAME('Nums'), ) ) JM_get_page_labels(rc, nums) return rc def _getMetadata(self, key): """Get metadata.""" try: return mupdf.fz_lookup_metadata2( self.this, key) except Exception: if g_exceptions_verbose > 2: exception_info() return '' def _getOLRootNumber(self): """Get xref of Outline Root, create it if missing.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) # get main root root = mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')) # get outline root olroot = mupdf.pdf_dict_get( root, PDF_NAME('Outlines')) if not olroot.m_internal: olroot = mupdf.pdf_new_dict( pdf, 4) mupdf.pdf_dict_put( olroot, PDF_NAME('Type'), PDF_NAME('Outlines')) ind_obj = mupdf.pdf_add_object( pdf, olroot) mupdf.pdf_dict_put( root, PDF_NAME('Outlines'), ind_obj) olroot = mupdf.pdf_dict_get( root, PDF_NAME('Outlines')) return mupdf.pdf_to_num( olroot) def _getPDFfileid(self): """Get PDF file id.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return idlist = [] identity = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('ID')) if identity.m_internal: n = mupdf.pdf_array_len(identity) for i in range(n): o = mupdf.pdf_array_get(identity, i) text = mupdf.pdf_to_text_string(o) hex_ = binascii.hexlify(text) idlist.append(hex_) return idlist def _getPageInfo(self, pno, what): """List fonts, images, XObjects used on a page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") doc = self.this pageCount = mupdf.pdf_count_pages(doc) if isinstance(doc, mupdf.PdfDocument) else mupdf.fz_count_pages(doc) n = pno # pno < 0 is allowed while n < 0: n += pageCount # make it non-negative if n >= pageCount: raise ValueError( MSG_BAD_PAGENO) pdf = _as_pdf_document(self) pageref = mupdf.pdf_lookup_page_obj(pdf, n) rsrc = mupdf.pdf_dict_get_inheritable(pageref, mupdf.PDF_ENUM_NAME_Resources) liste = [] tracer = [] if rsrc.m_internal: JM_scan_resources(pdf, rsrc, liste, what, 0, tracer) return liste def _insert_font(self, fontfile=None, fontbuffer=None): ''' Utility: insert font from file or binary. ''' pdf = _as_pdf_document(self) if not fontfile and not fontbuffer: raise ValueError( MSG_FILE_OR_BUFFER) value = JM_insert_font(pdf, None, fontfile, fontbuffer, 0, 0, 0, 0, 0, -1) return value def _loadOutline(self): """Load first outline.""" doc = self.this assert isinstance( doc, mupdf.FzDocument) try: ol = mupdf.fz_load_outline( doc) except Exception: if g_exceptions_verbose > 1: exception_info() return return Outline( ol) def _make_page_map(self): """Make an array page number -> page object.""" if self.is_closed: raise ValueError("document closed") assert 0, f'_make_page_map() is no-op' def _move_copy_page(self, pno, nb, before, copy): """Move or copy a PDF page reference.""" pdf = _as_pdf_document(self) same = 0 # get the two page objects ----------------------------------- # locate the /Kids arrays and indices in each page1, parent1, i1 = pdf_lookup_page_loc( pdf, pno) kids1 = mupdf.pdf_dict_get( parent1, PDF_NAME('Kids')) page2, parent2, i2 = pdf_lookup_page_loc( pdf, nb) kids2 = mupdf.pdf_dict_get( parent2, PDF_NAME('Kids')) if before: # calc index of source page in target /Kids pos = i2 else: pos = i2 + 1 # same /Kids array? ------------------------------------------ same = mupdf.pdf_objcmp( kids1, kids2) # put source page in target /Kids array ---------------------- if not copy and same != 0: # update parent in page object mupdf.pdf_dict_put( page1, PDF_NAME('Parent'), parent2) mupdf.pdf_array_insert( kids2, page1, pos) if same != 0: # different /Kids arrays ---------------------- parent = parent2 while parent.m_internal: # increase /Count objects in parents count = mupdf.pdf_dict_get_int( parent, PDF_NAME('Count')) mupdf.pdf_dict_put_int( parent, PDF_NAME('Count'), count + 1) parent = mupdf.pdf_dict_get( parent, PDF_NAME('Parent')) if not copy: # delete original item mupdf.pdf_array_delete( kids1, i1) parent = parent1 while parent.m_internal: # decrease /Count objects in parents count = mupdf.pdf_dict_get_int( parent, PDF_NAME('Count')) mupdf.pdf_dict_put_int( parent, PDF_NAME('Count'), count - 1) parent = mupdf.pdf_dict_get( parent, PDF_NAME('Parent')) else: # same /Kids array if copy: # source page is copied parent = parent2 while parent.m_internal: # increase /Count object in parents count = mupdf.pdf_dict_get_int( parent, PDF_NAME('Count')) mupdf.pdf_dict_put_int( parent, PDF_NAME('Count'), count + 1) parent = mupdf.pdf_dict_get( parent, PDF_NAME('Parent')) else: if i1 < pos: mupdf.pdf_array_delete( kids1, i1) else: mupdf.pdf_array_delete( kids1, i1 + 1) if pdf.m_internal.rev_page_map: # page map no longer valid: drop it mupdf.ll_pdf_drop_page_tree( pdf.m_internal) self._reset_page_refs() def _newPage(self, pno=-1, width=595, height=842): """Make a new PDF page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if g_use_extra: extra._newPage( self.this, pno, width, height) else: pdf = _as_pdf_document(self) mediabox = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) mediabox.x1 = width mediabox.y1 = height contents = mupdf.FzBuffer() if pno < -1: raise ValueError( MSG_BAD_PAGENO) # create /Resources and /Contents objects #resources = pdf.add_object(pdf.new_dict(1)) resources = mupdf.pdf_add_new_dict(pdf, 1) page_obj = mupdf.pdf_add_page( pdf, mediabox, 0, resources, contents) mupdf.pdf_insert_page( pdf, pno, page_obj) # fixme: pdf->dirty = 1; self._reset_page_refs() return self[pno] def _remove_links_to(self, numbers): pdf = _as_pdf_document(self) _remove_dest_range(pdf, numbers) def _remove_toc_item(self, xref): # "remove" bookmark by letting it point to nowhere pdf = _as_pdf_document(self) item = mupdf.pdf_new_indirect(pdf, xref, 0) mupdf.pdf_dict_del( item, PDF_NAME('Dest')) mupdf.pdf_dict_del( item, PDF_NAME('A')) color = mupdf.pdf_new_array( pdf, 3) for i in range(3): mupdf.pdf_array_push_real( color, 0.8) mupdf.pdf_dict_put( item, PDF_NAME('C'), color) def _reset_page_refs(self): """Invalidate all pages in document dictionary.""" if getattr(self, "is_closed", True): return pages = [p for p in self._page_refs.values()] for page in pages: if page: page._erase() page = None self._page_refs.clear() def _set_page_labels(self, labels): pdf = _as_pdf_document(self) pagelabels = mupdf.pdf_new_name("PageLabels") root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) mupdf.pdf_dict_del(root, pagelabels) mupdf.pdf_dict_putl(root, mupdf.pdf_new_array(pdf, 0), pagelabels, PDF_NAME('Nums')) xref = self.pdf_catalog() text = self.xref_object(xref, compressed=True) text = text.replace("/Nums[]", f"/Nums[{labels}]") self.update_object(xref, text) def _update_toc_item(self, xref, action=None, title=None, flags=0, collapse=None, color=None): ''' "update" bookmark by letting it point to nowhere ''' pdf = _as_pdf_document(self) item = mupdf.pdf_new_indirect( pdf, xref, 0) if title: mupdf.pdf_dict_put_text_string( item, PDF_NAME('Title'), title) if action: mupdf.pdf_dict_del( item, PDF_NAME('Dest')) obj = JM_pdf_obj_from_str( pdf, action) mupdf.pdf_dict_put( item, PDF_NAME('A'), obj) mupdf.pdf_dict_put_int( item, PDF_NAME('F'), flags) if color: c = mupdf.pdf_new_array( pdf, 3) for i in range(3): f = color[i] mupdf.pdf_array_push_real( c, f) mupdf.pdf_dict_put( item, PDF_NAME('C'), c) elif color is not None: mupdf.pdf_dict_del( item, PDF_NAME('C')) if collapse is not None: if mupdf.pdf_dict_get( item, PDF_NAME('Count')).m_internal: i = mupdf.pdf_dict_get_int( item, PDF_NAME('Count')) if (i < 0 and collapse is False) or (i > 0 and collapse is True): i = i * (-1) mupdf.pdf_dict_put_int( item, PDF_NAME('Count'), i) @property def FormFonts(self): """Get list of field font resource names.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return fonts = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('DR'), PDF_NAME('Font'), ) liste = list() if fonts.m_internal and mupdf.pdf_is_dict(fonts): # fonts exist n = mupdf.pdf_dict_len(fonts) for i in range(n): f = mupdf.pdf_dict_get_key(fonts, i) liste.append(JM_UnicodeFromStr(mupdf.pdf_to_name(f))) return liste def add_layer(self, name, creator=None, on=None): """Add a new OC layer.""" pdf = _as_pdf_document(self) JM_add_layer_config( pdf, name, creator, on) mupdf.ll_pdf_read_ocg( pdf.m_internal) def add_ocg(self, name, config=-1, on=1, intent=None, usage=None): """Add new optional content group.""" xref = 0 pdf = _as_pdf_document(self) # make the OCG ocg = mupdf.pdf_add_new_dict(pdf, 3) mupdf.pdf_dict_put(ocg, PDF_NAME('Type'), PDF_NAME('OCG')) mupdf.pdf_dict_put_text_string(ocg, PDF_NAME('Name'), name) intents = mupdf.pdf_dict_put_array(ocg, PDF_NAME('Intent'), 2) if not intent: mupdf.pdf_array_push(intents, PDF_NAME('View')) elif not isinstance(intent, str): assert 0, f'fixme: intent is not a str. {type(intent)=} {type=}' #n = len(intent) #for i in range(n): # item = intent[i] # c = JM_StrAsChar(item); # if (c) { # pdf_array_push(gctx, intents, pdf_new_name(gctx, c)); # } # Py_DECREF(item); #} else: mupdf.pdf_array_push(intents, mupdf.pdf_new_name(intent)) use_for = mupdf.pdf_dict_put_dict(ocg, PDF_NAME('Usage'), 3) ci_name = mupdf.pdf_new_name("CreatorInfo") cre_info = mupdf.pdf_dict_put_dict(use_for, ci_name, 2) mupdf.pdf_dict_put_text_string(cre_info, PDF_NAME('Creator'), "PyMuPDF") if usage: mupdf.pdf_dict_put_name(cre_info, PDF_NAME('Subtype'), usage) else: mupdf.pdf_dict_put_name(cre_info, PDF_NAME('Subtype'), "Artwork") indocg = mupdf.pdf_add_object(pdf, ocg) # Insert OCG in the right config ocp = JM_ensure_ocproperties(pdf) obj = mupdf.pdf_dict_get(ocp, PDF_NAME('OCGs')) mupdf.pdf_array_push(obj, indocg) if config > -1: obj = mupdf.pdf_dict_get(ocp, PDF_NAME('Configs')) if not mupdf.pdf_is_array(obj): raise ValueError( MSG_BAD_OC_CONFIG) cfg = mupdf.pdf_array_get(obj, config) if not cfg.m_internal: raise ValueError( MSG_BAD_OC_CONFIG) else: cfg = mupdf.pdf_dict_get(ocp, PDF_NAME('D')) obj = mupdf.pdf_dict_get(cfg, PDF_NAME('Order')) if not obj.m_internal: obj = mupdf.pdf_dict_put_array(cfg, PDF_NAME('Order'), 1) mupdf.pdf_array_push(obj, indocg) if on: obj = mupdf.pdf_dict_get(cfg, PDF_NAME('ON')) if not obj.m_internal: obj = mupdf.pdf_dict_put_array(cfg, PDF_NAME('ON'), 1) else: obj =mupdf.pdf_dict_get(cfg, PDF_NAME('OFF')) if not obj.m_internal: obj =mupdf.pdf_dict_put_array(cfg, PDF_NAME('OFF'), 1) mupdf.pdf_array_push(obj, indocg) # let MuPDF take note: re-read OCProperties mupdf.ll_pdf_read_ocg(pdf.m_internal) xref = mupdf.pdf_to_num(indocg) return xref def authenticate(self, password): """Decrypt document.""" if self.is_closed: raise ValueError("document closed") val = mupdf.fz_authenticate_password(self.this, password) if val: # the doc is decrypted successfully and we init the outline self.is_encrypted = False self.is_encrypted = False self.init_doc() self.thisown = True return val def can_save_incrementally(self): """Check whether incremental saves are possible.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return False return mupdf.pdf_can_be_saved_incrementally(pdf) def bake(self, *, annots: bool = True, widgets: bool = True) -> None: """Convert annotations or fields to permanent content. Notes: Converts annotations or widgets to permanent page content, like text and vector graphics, as appropriate. After execution, pages will still look the same, but no longer have annotations, respectively no fields. If widgets are selected the PDF will no longer be a Form PDF. Args: annots: convert annotations widgets: convert form fields """ pdf = _as_pdf_document(self) mupdf.pdf_bake_document(pdf, int(annots), int(widgets)) @property def chapter_count(self): """Number of chapters.""" if self.is_closed: raise ValueError("document closed") return mupdf.fz_count_chapters( self.this) def chapter_page_count(self, chapter): """Page count of chapter.""" if self.is_closed: raise ValueError("document closed") chapters = mupdf.fz_count_chapters( self.this) if chapter < 0 or chapter >= chapters: raise ValueError( "bad chapter number") pages = mupdf.fz_count_chapter_pages( self.this, chapter) return pages def close(self): """Close document.""" if getattr(self, "is_closed", True): raise ValueError("document closed") # self._cleanup() if hasattr(self, "_outline") and self._outline: self._outline = None self._reset_page_refs() #self.metadata = None #self.stream = None self.is_closed = True #self.FontInfos = [] self.Graftmaps = {} # Fixes test_3140(). #self.ShownPages = {} #self.InsertedImages = {} #self.this = None self.this = None def convert_to_pdf(self, from_page=0, to_page=-1, rotate=0): """Convert document to a PDF, selecting page range and optional rotation. Output bytes object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") fz_doc = self.this fp = from_page tp = to_page srcCount = mupdf.fz_count_pages(fz_doc) if fp < 0: fp = 0 if fp > srcCount - 1: fp = srcCount - 1 if tp < 0: tp = srcCount - 1 if tp > srcCount - 1: tp = srcCount - 1 len0 = len(JM_mupdf_warnings_store) doc = JM_convert_to_pdf(fz_doc, fp, tp, rotate) len1 = len(JM_mupdf_warnings_store) for i in range(len0, len1): message(f'{JM_mupdf_warnings_store[i]}') return doc def copy_page(self, pno: int, to: int =-1): """Copy a page within a PDF document. This will only create another reference of the same page object. Args: pno: source page number to: put before this page, '-1' means after last page. """ if self.is_closed: raise ValueError("document closed") page_count = len(self) if ( pno not in range(page_count) or to not in range(-1, page_count) ): raise ValueError("bad page number(s)") before = 1 copy = 1 if to == -1: to = page_count - 1 before = 0 return self._move_copy_page(pno, to, before, copy) def del_xml_metadata(self): """Delete XML metadata.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) root = mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')) if root.m_internal: mupdf.pdf_dict_del( root, PDF_NAME('Metadata')) def delete_page(self, pno: int =-1): """ Delete one page from a PDF. """ return self.delete_pages(pno) def delete_pages(self, *args, **kw): """Delete pages from a PDF. Args: Either keywords 'from_page'/'to_page', or two integers to specify the first/last page to delete. Or a list/tuple/range object, which can contain arbitrary page numbers. Or a single integer page number. """ if not self.is_pdf: raise ValueError("is no PDF") if self.is_closed: raise ValueError("document closed") page_count = self.page_count # page count of document f = t = -1 if kw: # check if keywords were used if args: # then no positional args are allowed raise ValueError("cannot mix keyword and positional argument") f = kw.get("from_page", -1) # first page to delete t = kw.get("to_page", -1) # last page to delete while f < 0: f += page_count while t < 0: t += page_count if not f <= t < page_count: raise ValueError("bad page number(s)") numbers = tuple(range(f, t + 1)) else: if len(args) > 2 or args == []: raise ValueError("need 1 or 2 positional arguments") if len(args) == 2: f, t = args if not (type(f) is int and type(t) is int): raise ValueError("both arguments must be int") if f > t: f, t = t, f if not f <= t < page_count: raise ValueError("bad page number(s)") numbers = tuple(range(f, t + 1)) elif isinstance(args[0], int): pno = args[0] while pno < 0: pno += page_count numbers = (pno,) else: numbers = tuple(args[0]) numbers = list(map(int, set(numbers))) # ensure unique integers if numbers == []: message("nothing to delete") return numbers.sort() if numbers[0] < 0 or numbers[-1] >= page_count: raise ValueError("bad page number(s)") frozen_numbers = frozenset(numbers) toc = self.get_toc() for i, xref in enumerate(self.get_outline_xrefs()): if toc[i][2] - 1 in frozen_numbers: self._remove_toc_item(xref) # remove target in PDF object self._remove_links_to(frozen_numbers) for i in reversed(numbers): # delete pages, last to first self._delete_page(i) self._reset_page_refs() def embfile_add(self, name: str, buffer_: ByteString, filename: OptStr =None, ufilename: OptStr =None, desc: OptStr =None, ) -> None: """Add an item to the EmbeddedFiles array. Args: name: name of the new item, must not already exist. buffer_: (binary data) the file content. filename: (str) the file name, default: the name ufilename: (unicode) the file name, default: filename desc: (str) the description. """ filenames = self.embfile_names() if name in filenames: raise ValueError(f"Name '{name}' already exists.") if filename is None: filename = name if ufilename is None: ufilename = filename if desc is None: desc = name xref = self._embfile_add( name, buffer_=buffer_, filename=filename, ufilename=ufilename, desc=desc, ) date = get_pdf_now() self.xref_set_key(xref, "Type", "/EmbeddedFile") self.xref_set_key(xref, "Params/CreationDate", get_pdf_str(date)) self.xref_set_key(xref, "Params/ModDate", get_pdf_str(date)) return xref def embfile_count(self) -> int: """Get number of EmbeddedFiles.""" return len(self.embfile_names()) def embfile_del(self, item: typing.Union[int, str]): """Delete an entry from EmbeddedFiles. Notes: The argument must be name or index of an EmbeddedFiles item. Physical deletion of data will happen on save to a new file with appropriate garbage option. Args: item: name or number of item. Returns: None """ idx = self._embeddedFileIndex(item) return self._embfile_del(idx) def embfile_get(self, item: typing.Union[int, str]) -> bytes: """Get the content of an item in the EmbeddedFiles array. Args: item: number or name of item. Returns: (bytes) The file content. """ idx = self._embeddedFileIndex(item) return self._embeddedFileGet(idx) def embfile_info(self, item: typing.Union[int, str]) -> dict: """Get information of an item in the EmbeddedFiles array. Args: item: number or name of item. Returns: Information dictionary. """ idx = self._embeddedFileIndex(item) infodict = {"name": self.embfile_names()[idx]} xref = self._embfile_info(idx, infodict) t, date = self.xref_get_key(xref, "Params/CreationDate") if t != "null": infodict["creationDate"] = date t, date = self.xref_get_key(xref, "Params/ModDate") if t != "null": infodict["modDate"] = date t, md5 = self.xref_get_key(xref, "Params/CheckSum") if t != "null": infodict["checksum"] = binascii.hexlify(md5.encode()).decode() return infodict def embfile_names(self) -> list: """Get list of names of EmbeddedFiles.""" filenames = [] self._embfile_names(filenames) return filenames def embfile_upd(self, item: typing.Union[int, str], buffer_: OptBytes =None, filename: OptStr =None, ufilename: OptStr =None, desc: OptStr =None, ) -> None: """Change an item of the EmbeddedFiles array. Notes: Only provided parameters are changed. If all are omitted, the method is a no-op. Args: item: number or name of item. buffer_: (binary data) the new file content. filename: (str) the new file name. ufilename: (unicode) the new filen ame. desc: (str) the new description. """ idx = self._embeddedFileIndex(item) xref = self._embfile_upd( idx, buffer_=buffer_, filename=filename, ufilename=ufilename, desc=desc, ) date = get_pdf_now() self.xref_set_key(xref, "Params/ModDate", get_pdf_str(date)) return xref def extract_font(self, xref=0, info_only=0, named=None): ''' Get a font by xref. Returns a tuple or dictionary. ''' #log(f'{=xref info_only}') pdf = _as_pdf_document(self) obj = mupdf.pdf_load_object(pdf, xref) type_ = mupdf.pdf_dict_get(obj, PDF_NAME('Type')) subtype = mupdf.pdf_dict_get(obj, PDF_NAME('Subtype')) if (mupdf.pdf_name_eq(type_, PDF_NAME('Font')) and not mupdf.pdf_to_name( subtype).startswith('CIDFontType') ): basefont = mupdf.pdf_dict_get(obj, PDF_NAME('BaseFont')) if not basefont.m_internal or mupdf.pdf_is_null(basefont): bname = mupdf.pdf_dict_get(obj, PDF_NAME('Name')) else: bname = basefont ext = JM_get_fontextension(pdf, xref) if ext != 'n/a' and not info_only: buffer_ = JM_get_fontbuffer(pdf, xref) bytes_ = JM_BinFromBuffer(buffer_) else: bytes_ = b'' if not named: rc = ( JM_EscapeStrFromStr(mupdf.pdf_to_name(bname)), JM_UnicodeFromStr(ext), JM_UnicodeFromStr(mupdf.pdf_to_name(subtype)), bytes_, ) else: rc = { dictkey_name: JM_EscapeStrFromStr(mupdf.pdf_to_name(bname)), dictkey_ext: JM_UnicodeFromStr(ext), dictkey_type: JM_UnicodeFromStr(mupdf.pdf_to_name(subtype)), dictkey_content: bytes_, } else: if not named: rc = '', '', '', b'' else: rc = { dictkey_name: '', dictkey_ext: '', dictkey_type: '', dictkey_content: b'', } return rc def extract_image(self, xref): """Get image by xref. Returns a dictionary.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) if not _INRANGE(xref, 1, mupdf.pdf_xref_len(pdf)-1): raise ValueError( MSG_BAD_XREF) obj = mupdf.pdf_new_indirect(pdf, xref, 0) subtype = mupdf.pdf_dict_get(obj, PDF_NAME('Subtype')) if not mupdf.pdf_name_eq(subtype, PDF_NAME('Image')): raise ValueError( "not an image") o = mupdf.pdf_dict_geta(obj, PDF_NAME('SMask'), PDF_NAME('Mask')) if o.m_internal: smask = mupdf.pdf_to_num(o) else: smask = 0 # load the image img = mupdf.pdf_load_image(pdf, obj) rc = dict() _make_image_dict(img, rc) rc[dictkey_smask] = smask rc[dictkey_cs_name] = mupdf.fz_colorspace_name(img.colorspace()) return rc def ez_save( self, filename, garbage=3, clean=False, deflate=True, deflate_images=True, deflate_fonts=True, incremental=False, ascii=False, expand=False, linear=False, pretty=False, encryption=1, permissions=4095, owner_pw=None, user_pw=None, no_new_id=True, preserve_metadata=1, use_objstms=1, compression_effort=0, raise_on_repair=False, ): ''' Save PDF using some different defaults ''' return self.save( filename, garbage=garbage, clean=clean, deflate=deflate, deflate_images=deflate_images, deflate_fonts=deflate_fonts, incremental=incremental, ascii=ascii, expand=expand, linear=linear, pretty=pretty, encryption=encryption, permissions=permissions, owner_pw=owner_pw, user_pw=user_pw, no_new_id=no_new_id, preserve_metadata=preserve_metadata, use_objstms=use_objstms, compression_effort=compression_effort, raise_on_repair=raise_on_repair, ) def find_bookmark(self, bm): """Find new location after layouting a document.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") location = mupdf.fz_lookup_bookmark2( self.this, bm) return location.chapter, location.page def fullcopy_page(self, pno, to=-1): """Make a full page duplicate.""" pdf = _as_pdf_document(self) page_count = mupdf.pdf_count_pages( pdf) try: if (not _INRANGE(pno, 0, page_count - 1) or not _INRANGE(to, -1, page_count - 1) ): raise ValueError( MSG_BAD_PAGENO) page1 = mupdf.pdf_resolve_indirect( mupdf.pdf_lookup_page_obj( pdf, pno)) page2 = mupdf.pdf_deep_copy_obj( page1) old_annots = mupdf.pdf_dict_get( page2, PDF_NAME('Annots')) # copy annotations, but remove Popup and IRT types if old_annots.m_internal: n = mupdf.pdf_array_len( old_annots) new_annots = mupdf.pdf_new_array( pdf, n) for i in range(n): o = mupdf.pdf_array_get( old_annots, i) subtype = mupdf.pdf_dict_get( o, PDF_NAME('Subtype')) if mupdf.pdf_name_eq( subtype, PDF_NAME('Popup')): continue if mupdf.pdf_dict_gets( o, "IRT").m_internal: continue copy_o = mupdf.pdf_deep_copy_obj( mupdf.pdf_resolve_indirect( o)) xref = mupdf.pdf_create_object( pdf) mupdf.pdf_update_object( pdf, xref, copy_o) copy_o = mupdf.pdf_new_indirect( pdf, xref, 0) mupdf.pdf_dict_del( copy_o, PDF_NAME('Popup')) mupdf.pdf_dict_del( copy_o, PDF_NAME('P')) mupdf.pdf_array_push( new_annots, copy_o) mupdf.pdf_dict_put( page2, PDF_NAME('Annots'), new_annots) # copy the old contents stream(s) res = JM_read_contents( page1) # create new /Contents object for page2 if res and res.m_internal: #contents = mupdf.pdf_add_stream( pdf, mupdf.fz_new_buffer_from_copied_data( b" ", 1), NULL, 0) contents = mupdf.pdf_add_stream( pdf, mupdf.fz_new_buffer_from_copied_data( b" "), mupdf.PdfObj(), 0) JM_update_stream( pdf, contents, res, 1) mupdf.pdf_dict_put( page2, PDF_NAME('Contents'), contents) # now insert target page, making sure it is an indirect object xref = mupdf.pdf_create_object( pdf) # get new xref mupdf.pdf_update_object( pdf, xref, page2) # store new page page2 = mupdf.pdf_new_indirect( pdf, xref, 0) # reread object mupdf.pdf_insert_page( pdf, to, page2) # and store the page finally: mupdf.ll_pdf_drop_page_tree( pdf.m_internal) self._reset_page_refs() def get_char_widths( doc: 'Document', xref: int, limit: int = 256, idx: int = 0, fontdict: OptDict = None, ) -> list: """Get list of glyph information of a font. Notes: Must be provided by its XREF number. If we already dealt with the font, it will be recorded in doc.FontInfos. Otherwise we insert an entry there. Finally we return the glyphs for the font. This is a list of (glyph, width) where glyph is an integer controlling the char appearance, and width is a float controlling the char's spacing: width * fontsize is the actual space. For 'simple' fonts, glyph == ord(char) will usually be true. Exceptions are 'Symbol' and 'ZapfDingbats'. We are providing data for these directly here. """ fontinfo = CheckFontInfo(doc, xref) if fontinfo is None: # not recorded yet: create it if fontdict is None: name, ext, stype, asc, dsc = utils._get_font_properties(doc, xref) fontdict = { "name": name, "type": stype, "ext": ext, "ascender": asc, "descender": dsc, } else: name = fontdict["name"] ext = fontdict["ext"] stype = fontdict["type"] ordering = fontdict["ordering"] simple = fontdict["simple"] if ext == "": raise ValueError("xref is not a font") # check for 'simple' fonts if stype in ("Type1", "MMType1", "TrueType"): simple = True else: simple = False # check for CJK fonts if name in ("Fangti", "Ming"): ordering = 0 elif name in ("Heiti", "Song"): ordering = 1 elif name in ("Gothic", "Mincho"): ordering = 2 elif name in ("Dotum", "Batang"): ordering = 3 else: ordering = -1 fontdict["simple"] = simple if name == "ZapfDingbats": glyphs = zapf_glyphs elif name == "Symbol": glyphs = symbol_glyphs else: glyphs = None fontdict["glyphs"] = glyphs fontdict["ordering"] = ordering fontinfo = [xref, fontdict] doc.FontInfos.append(fontinfo) else: fontdict = fontinfo[1] glyphs = fontdict["glyphs"] simple = fontdict["simple"] ordering = fontdict["ordering"] if glyphs is None: oldlimit = 0 else: oldlimit = len(glyphs) mylimit = max(256, limit) if mylimit <= oldlimit: return glyphs if ordering < 0: # not a CJK font glyphs = doc._get_char_widths( xref, fontdict["name"], fontdict["ext"], fontdict["ordering"], mylimit, idx ) else: # CJK fonts use char codes and width = 1 glyphs = None fontdict["glyphs"] = glyphs fontinfo[1] = fontdict UpdateFontInfo(doc, fontinfo) return glyphs def get_layer(self, config=-1): """Content of ON, OFF, RBGroups of an OC layer.""" pdf = _as_pdf_document(self) ocp = mupdf.pdf_dict_getl( mupdf.pdf_trailer( pdf), PDF_NAME('Root'), PDF_NAME('OCProperties'), ) if not ocp.m_internal: return if config == -1: obj = mupdf.pdf_dict_get( ocp, PDF_NAME('D')) else: obj = mupdf.pdf_array_get( mupdf.pdf_dict_get( ocp, PDF_NAME('Configs')), config, ) if not obj.m_internal: raise ValueError( MSG_BAD_OC_CONFIG) rc = JM_get_ocg_arrays( obj) return rc def get_layers(self): """Show optional OC layers.""" pdf = _as_pdf_document(self) n = mupdf.pdf_count_layer_configs( pdf) if n == 1: obj = mupdf.pdf_dict_getl( mupdf.pdf_trailer( pdf), PDF_NAME('Root'), PDF_NAME('OCProperties'), PDF_NAME('Configs'), ) if not mupdf.pdf_is_array( obj): n = 0 rc = [] info = mupdf.PdfLayerConfig() for i in range(n): mupdf.pdf_layer_config_info( pdf, i, info) item = { "number": i, "name": info.name, "creator": info.creator, } rc.append( item) return rc def get_new_xref(self): """Make new xref.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) xref = 0 ENSURE_OPERATION(pdf) xref = mupdf.pdf_create_object(pdf) return xref def get_oc(doc: 'Document', xref: int) -> int: """Return optional content object xref for an image or form xobject. Args: xref: (int) xref number of an image or form xobject. """ if doc.is_closed or doc.is_encrypted: raise ValueError("document close or encrypted") t, name = doc.xref_get_key(xref, "Subtype") if t != "name" or name not in ("/Image", "/Form"): raise ValueError(f"bad object type at xref {xref}") t, oc = doc.xref_get_key(xref, "OC") if t != "xref": return 0 rc = int(oc.replace("0 R", "")) return rc def get_ocgs(self): """Show existing optional content groups.""" ci = mupdf.pdf_new_name( "CreatorInfo") pdf = _as_pdf_document(self) ocgs = mupdf.pdf_dict_getl( mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')), PDF_NAME('OCProperties'), PDF_NAME('OCGs'), ) rc = dict() if not mupdf.pdf_is_array( ocgs): return rc n = mupdf.pdf_array_len( ocgs) for i in range(n): ocg = mupdf.pdf_array_get( ocgs, i) xref = mupdf.pdf_to_num( ocg) name = mupdf.pdf_to_text_string( mupdf.pdf_dict_get( ocg, PDF_NAME('Name'))) obj = mupdf.pdf_dict_getl( ocg, PDF_NAME('Usage'), ci, PDF_NAME('Subtype')) usage = None if obj.m_internal: usage = mupdf.pdf_to_name( obj) intents = list() intent = mupdf.pdf_dict_get( ocg, PDF_NAME('Intent')) if intent.m_internal: if mupdf.pdf_is_name( intent): intents.append( mupdf.pdf_to_name( intent)) elif mupdf.pdf_is_array( intent): m = mupdf.pdf_array_len( intent) for j in range(m): o = mupdf.pdf_array_get( intent, j) if mupdf.pdf_is_name( o): intents.append( mupdf.pdf_to_name( o)) if mupdf_version_tuple >= (1, 26, 11): resource_stack = mupdf.PdfResourceStack() hidden = mupdf.pdf_is_ocg_hidden( pdf, resource_stack, usage, ocg) else: hidden = mupdf.pdf_is_ocg_hidden( pdf, mupdf.PdfObj(), usage, ocg) item = { "name": name, "intent": intents, "on": not hidden, "usage": usage, } temp = xref rc[ temp] = item return rc def get_ocmd(doc: 'Document', xref: int) -> dict: """Return the definition of an OCMD (optional content membership dictionary). Recognizes PDF dict keys /OCGs (PDF array of OCGs), /P (policy string) and /VE (visibility expression, PDF array). Via string manipulation, this info is converted to a Python dictionary with keys "xref", "ocgs", "policy" and "ve" - ready to recycle as input for 'set_ocmd()'. """ if xref not in range(doc.xref_length()): raise ValueError("bad xref") text = doc.xref_object(xref, compressed=True) if "/Type/OCMD" not in text: raise ValueError("bad object type") textlen = len(text) p0 = text.find("/OCGs[") # look for /OCGs key p1 = text.find("]", p0) if p0 < 0 or p1 < 0: # no OCGs found ocgs = None else: ocgs = text[p0 + 6 : p1].replace("0 R", " ").split() ocgs = list(map(int, ocgs)) p0 = text.find("/P/") # look for /P policy key if p0 < 0: policy = None else: p1 = text.find("ff", p0) if p1 < 0: p1 = text.find("on", p0) if p1 < 0: # some irregular syntax raise ValueError("bad object at xref") else: policy = text[p0 + 3 : p1 + 2] p0 = text.find("/VE[") # look for /VE visibility expression key if p0 < 0: # no visibility expression found ve = None else: lp = rp = 0 # find end of /VE by finding last ']'. p1 = p0 while lp < 1 or lp != rp: p1 += 1 if not p1 < textlen: # some irregular syntax raise ValueError("bad object at xref") if text[p1] == "[": lp += 1 if text[p1] == "]": rp += 1 # p1 now positioned at the last "]" ve = text[p0 + 3 : p1 + 1] # the PDF /VE array ve = ( ve.replace("/And", '"and",') .replace("/Not", '"not",') .replace("/Or", '"or",') ) ve = ve.replace(" 0 R]", "]").replace(" 0 R", ",").replace("][", "],[") import json try: ve = json.loads(ve) except Exception: exception_info() message(f"bad /VE key: {ve!r}") raise return {"xref": xref, "ocgs": ocgs, "policy": policy, "ve": ve} def get_outline_xrefs(self): """Get list of outline xref numbers.""" xrefs = [] pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return xrefs root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) if not root.m_internal: return xrefs olroot = mupdf.pdf_dict_get(root, PDF_NAME('Outlines')) if not olroot.m_internal: return xrefs first = mupdf.pdf_dict_get(olroot, PDF_NAME('First')) if not first.m_internal: return xrefs xrefs = JM_outline_xrefs(first, xrefs) return xrefs def get_page_fonts(self, pno: int, full: bool =False) -> list: """Retrieve a list of fonts used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () if type(pno) is not int: try: pno = pno.number except Exception: exception_info() raise ValueError("need a Page or page number") val = self._getPageInfo(pno, 1) if not full: return [v[:-1] for v in val] return val def get_page_images(self, pno: int, full: bool =False) -> list: """Retrieve a list of images used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () val = self._getPageInfo(pno, 2) if not full: return [v[:-1] for v in val] return val def get_page_labels(self): """Return page label definitions in PDF document. Returns: A list of dictionaries with the following format: {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. """ # Jorj McKie, 2021-01-10 return [utils.rule_dict(item) for item in self._get_page_labels()] def get_page_numbers(doc, label, only_one=False): """Return a list of page numbers with the given label. Args: doc: PDF document object (resp. 'self'). label: (str) label. only_one: (bool) stop searching after first hit. Returns: List of page numbers having this label. """ # Jorj McKie, 2021-01-06 numbers = [] if not label: return numbers labels = doc._get_page_labels() if labels == []: return numbers for i in range(doc.page_count): plabel = utils.get_label_pno(i, labels) if plabel == label: numbers.append(i) if only_one: break return numbers def get_page_pixmap( doc: 'Document', pno: int, *, matrix: matrix_like = None, dpi=None, colorspace: Colorspace = None, clip: rect_like = None, alpha: bool = False, annots: bool = True, ) -> 'Pixmap': """Create pixmap of document page by page number. Notes: Convenience function calling page.get_pixmap. Args: pno: (int) page number matrix: pymupdf.Matrix for transformation (default: pymupdf.Identity). colorspace: (str,pymupdf.Colorspace) rgb, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) include alpha channel annots: (bool) also render annotations """ if matrix is None: matrix = Identity if colorspace is None: colorspace = csRGB return doc[pno].get_pixmap( matrix=matrix, dpi=dpi, colorspace=colorspace, clip=clip, alpha=alpha, annots=annots ) def get_page_text( doc: 'Document', pno: int, option: str = "text", clip: rect_like = None, flags: OptInt = None, textpage: 'TextPage' = None, sort: bool = False, ) -> typing.Any: """Extract a document page's text by page number. Notes: Convenience function calling page.get_text(). Args: pno: page number option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. Returns: output from page.TextPage(). """ return doc[pno].get_text(option, clip=clip, flags=flags, sort=sort) def get_page_xobjects(self, pno: int) -> list: """Retrieve a list of XObjects used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () val = self._getPageInfo(pno, 3) return val def get_sigflags(self): """Get the /SigFlags value.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return -1 # not a PDF sigflags = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('SigFlags'), ) sigflag = -1 if sigflags.m_internal: sigflag = mupdf.pdf_to_int(sigflags) return sigflag def get_toc( doc: 'Document', simple: bool = True, ) -> list: """Create a table of contents. Args: simple: a bool to control output. Returns a list, where each entry consists of outline level, title, page number and link destination (if simple = False). For details see PyMuPDF's documentation. """ def recurse(olItem, liste, lvl): """Recursively follow the outline item chain and record item information in a list.""" while olItem and olItem.this.m_internal: if olItem.title: title = olItem.title else: title = " " if not olItem.is_external: if olItem.uri: if olItem.page == -1: resolve = doc.resolve_link(olItem.uri) page = resolve[0] + 1 else: page = olItem.page + 1 else: page = -1 else: page = -1 if not simple: link = utils.getLinkDict(olItem, doc) liste.append([lvl, title, page, link]) else: liste.append([lvl, title, page]) if olItem.down: liste = recurse(olItem.down, liste, lvl + 1) olItem = olItem.next return liste # ensure document is open if doc.is_closed: raise ValueError("document closed") doc.init_doc() olItem = doc.outline if not olItem: return [] lvl = 1 liste = [] toc = recurse(olItem, liste, lvl) if doc.is_pdf and not simple: doc._extend_toc_items(toc) return toc def get_xml_metadata(self): """Get document XML metadata.""" xml = None pdf = _as_pdf_document(self, required=0) if pdf.m_internal: xml = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('Metadata'), ) if xml is not None and xml.m_internal: buff = mupdf.pdf_load_stream(xml) rc = JM_UnicodeFromBuffer(buff) else: rc = '' return rc def has_annots(doc: 'Document') -> bool: """Check whether there are annotations on any page.""" if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") for i in range(doc.page_count): for item in doc.page_annot_xrefs(i): # pylint: disable=no-member if not (item[1] == mupdf.PDF_ANNOT_LINK or item[1] == mupdf.PDF_ANNOT_WIDGET): # pylint: disable=no-member return True return False def has_links(doc: 'Document') -> bool: """Check whether there are links on any page.""" if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") for i in range(doc.page_count): for item in doc.page_annot_xrefs(i): if item[1] == mupdf.PDF_ANNOT_LINK: # pylint: disable=no-member return True return False def init_doc(self): if self.is_encrypted: raise ValueError("cannot initialize - document still encrypted") self._outline = self._loadOutline() self.metadata = dict( [ (k,self._getMetadata(v)) for k,v in { 'format':'format', 'title':'info:Title', 'author':'info:Author', 'subject':'info:Subject', 'keywords':'info:Keywords', 'creator':'info:Creator', 'producer':'info:Producer', 'creationDate':'info:CreationDate', 'modDate':'info:ModDate', 'trapped':'info:Trapped' }.items() ] ) self.metadata['encryption'] = None if self._getMetadata('encryption')=='None' else self._getMetadata('encryption') def insert_file(self, infile, from_page=-1, to_page=-1, start_at=-1, rotate=-1, links=True, annots=True, show_progress=0, final=1, ): ''' Insert an arbitrary supported document to an existing PDF. The infile may be given as a filename, a Document or a Pixmap. Other parameters - where applicable - equal those of insert_pdf(). ''' src = None if isinstance(infile, Pixmap): if infile.colorspace.n > 3: infile = Pixmap(csRGB, infile) src = Document("png", infile.tobytes()) elif isinstance(infile, Document): src = infile else: src = Document(infile) if not src: raise ValueError("bad infile parameter") if not src.is_pdf: pdfbytes = src.convert_to_pdf() src = Document("pdf", pdfbytes) return self.insert_pdf( src, from_page=from_page, to_page=to_page, start_at=start_at, rotate=rotate, links=links, annots=annots, show_progress=show_progress, final=final, ) def insert_page( doc: 'Document', pno: int, text: typing.Union[str, list, None] = None, fontsize: float = 11, width: float = 595, height: float = 842, fontname: str = "helv", fontfile: OptStr = None, color: OptSeq = (0,), ) -> int: """Create a new PDF page and insert some text. Notes: Function combining pymupdf.Document.new_page() and pymupdf.Page.insert_text(). For parameter details see these methods. """ page = doc.new_page(pno=pno, width=width, height=height) if not bool(text): return 0 rc = page.insert_text( (50, 72), text, fontsize=fontsize, fontname=fontname, fontfile=fontfile, color=color, ) return rc def insert_pdf( self, docsrc, *, from_page=-1, to_page=-1, start_at=-1, rotate=-1, links=1, annots=1, widgets=1, join_duplicates=0, show_progress=0, final=1, _gmap=None, ): """Insert a page range from another PDF. Args: docsrc: PDF to copy from. Must be different object, but may be same file. from_page: (int) first source page to copy, 0-based, default 0. to_page: (int) last source page to copy, 0-based, default last page. start_at: (int) from_page will become this page number in target. rotate: (int) rotate copied pages, default -1 is no change. links: (int/bool) whether to also copy links. annots: (int/bool) whether to also copy annotations. widgets: (int/bool) whether to also copy form fields. join_duplicates: (int/bool) join or rename duplicate widget names. show_progress: (int) progress message interval, 0 is no messages. final: (bool) indicates last insertion from this source PDF. _gmap: internal use only Copy sequence reversed if from_page > to_page.""" # Insert pages from a source PDF into this PDF. # For reconstructing the links (_do_links method), we must save the # insertion point (start_at) if it was specified as -1. #log( 'insert_pdf(): start') if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self._graft_id == docsrc._graft_id: raise ValueError("source and target cannot be same object") sa = start_at if sa < 0: sa = self.page_count outCount = self.page_count srcCount = docsrc.page_count # local copies of page numbers fp = from_page tp = to_page sa = start_at # normalize page numbers fp = max(fp, 0) # -1 = first page fp = min(fp, srcCount - 1) # but do not exceed last page if tp < 0: tp = srcCount - 1 # -1 = last page tp = min(tp, srcCount - 1) # but do not exceed last page if sa < 0: sa = outCount # -1 = behind last page sa = min(sa, outCount) # but that is also the limit if len(docsrc) > show_progress > 0: inname = os.path.basename(docsrc.name) if not inname: inname = "memory PDF" outname = os.path.basename(self.name) if not outname: outname = "memory PDF" message(f"Inserting '{inname}' at '{outname}'") # retrieve / make a Graftmap to avoid duplicate objects #log( 'insert_pdf(): Graftmaps') isrt = docsrc._graft_id _gmap = self.Graftmaps.get(isrt, None) if _gmap is None: #log( 'insert_pdf(): Graftmaps2') _gmap = Graftmap(self) self.Graftmaps[isrt] = _gmap if g_use_extra: #log( 'insert_pdf(): calling extra_FzDocument_insert_pdf()') extra_FzDocument_insert_pdf( self.this, docsrc.this, from_page, to_page, start_at, rotate, links, annots, show_progress, final, _gmap, ) #log( 'insert_pdf(): extra_FzDocument_insert_pdf() returned.') else: pdfout = _as_pdf_document(self) pdfsrc = _as_pdf_document(docsrc) if not pdfout.m_internal or not pdfsrc.m_internal: raise TypeError( "source or target not a PDF") ENSURE_OPERATION(pdfout) JM_merge_range(pdfout, pdfsrc, fp, tp, sa, rotate, links, annots, show_progress, _gmap) #log( 'insert_pdf(): calling self._reset_page_refs()') self._reset_page_refs() if links: #log( 'insert_pdf(): calling self._do_links()') self._do_links(docsrc, from_page=fp, to_page=tp, start_at=sa) if widgets: self._do_widgets(docsrc, _gmap, from_page=fp, to_page=tp, start_at=sa, join_duplicates=join_duplicates) if final == 1: self.Graftmaps[isrt] = None #log( 'insert_pdf(): returning') @property def is_dirty(self): pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return False r = mupdf.pdf_has_unsaved_changes(pdf) return True if r else False @property def is_fast_webaccess(self): ''' Check whether we have a linearized PDF. ''' pdf = _as_pdf_document(self, required=0) if pdf.m_internal: return mupdf.pdf_doc_was_linearized(pdf) return False # gracefully handle non-PDF @property def is_form_pdf(self): """Either False or PDF field count.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return False count = -1 try: fields = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), mupdf.PDF_ENUM_NAME_Root, mupdf.PDF_ENUM_NAME_AcroForm, mupdf.PDF_ENUM_NAME_Fields, ) if mupdf.pdf_is_array(fields): count = mupdf.pdf_array_len(fields) except Exception: if g_exceptions_verbose: exception_info() return False if count >= 0: return count return False @property def is_pdf(self): """Check for PDF.""" if isinstance(self.this, mupdf.PdfDocument): return True # Avoid calling smupdf.pdf_specifics because it will end up creating # a new PdfDocument which will call pdf_create_document(), which is ok # but a little unnecessary. # if mupdf.ll_pdf_specifics(self.this.m_internal): ret = True else: ret = False return ret @property def is_reflowable(self): """Check if document is layoutable.""" if self.is_closed: raise ValueError("document closed") return bool(mupdf.fz_is_document_reflowable(self)) @property def is_repaired(self): """Check whether PDF was repaired.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return False r = mupdf.pdf_was_repaired(pdf) if r: return True return False def journal_can_do(self): """Show if undo and / or redo are possible.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") undo=0 redo=0 pdf = _as_pdf_document(self) undo = mupdf.pdf_can_undo(pdf) redo = mupdf.pdf_can_redo(pdf) return {'undo': bool(undo), 'redo': bool(redo)} def journal_enable(self): """Activate document journalling.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) mupdf.pdf_enable_journal(pdf) def journal_is_enabled(self): """Check if journalling is enabled.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) enabled = pdf.m_internal and pdf.m_internal.journal return enabled def journal_load(self, filename): """Load a journal from a file.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) if isinstance(filename, str): mupdf.pdf_load_journal(pdf, filename) else: res = JM_BufferFromBytes(filename) stm = mupdf.fz_open_buffer(res) mupdf.pdf_deserialise_journal(pdf, stm) if not pdf.m_internal.journal: RAISEPY( "Journal and document do not match", JM_Exc_FileDataError) def journal_op_name(self, step): """Show operation name for given step.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) name = mupdf.pdf_undoredo_step(pdf, step) return name def journal_position(self): """Show journalling state.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") steps=0 pdf = _as_pdf_document(self) rc, steps = mupdf.pdf_undoredo_state(pdf) return rc, steps def journal_redo(self): """Move forward in the journal.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) mupdf.pdf_redo(pdf) return True def journal_save(self, filename): """Save journal to a file.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) if isinstance(filename, str): mupdf.pdf_save_journal(pdf, filename) else: out = JM_new_output_fileptr(filename) mupdf.pdf_write_journal(pdf, out) out.fz_close_output() def journal_start_op(self, name=None): """Begin a journalling operation.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) if not pdf.m_internal.journal: raise RuntimeError( "Journalling not enabled") if name: mupdf.pdf_begin_operation(pdf, name) else: mupdf.pdf_begin_implicit_operation(pdf) def journal_stop_op(self): """End a journalling operation.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) mupdf.pdf_end_operation(pdf) def journal_undo(self): """Move backwards in the journal.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) mupdf.pdf_undo(pdf) return True @property def language(self): """Document language.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return lang = mupdf.pdf_document_language(pdf) if lang == mupdf.FZ_LANG_UNSET: return return mupdf.fz_string_from_text_language2(lang) @property def last_location(self): """Id (chapter, page) of last page.""" if self.is_closed: raise ValueError("document closed") last_loc = mupdf.fz_last_page(self.this) return last_loc.chapter, last_loc.page def layer_ui_configs(self): """Show OC visibility status modifiable by user.""" pdf = _as_pdf_document(self) info = mupdf.PdfLayerConfigUi() n = mupdf.pdf_count_layer_config_ui( pdf) rc = [] for i in range(n): mupdf.pdf_layer_config_ui_info( pdf, i, info) if info.type == 1: type_ = "checkbox" elif info.type == 2: type_ = "radiobox" else: type_ = "label" item = { "number": i, "text": info.text, "depth": info.depth, "type": type_, "on": info.selected, "locked": info.locked, } rc.append(item) return rc def layout(self, rect=None, width=0, height=0, fontsize=11): """Re-layout a reflowable document.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") doc = self.this if not mupdf.fz_is_document_reflowable( doc): return w = width h = height r = JM_rect_from_py(rect) if not mupdf.fz_is_infinite_rect(r): w = r.x1 - r.x0 h = r.y1 - r.y0 if w <= 0.0 or h <= 0.0: raise ValueError( "bad page size") mupdf.fz_layout_document( doc, w, h, fontsize) self._reset_page_refs() self.init_doc() def load_page(self, page_id): """Load a page. 'page_id' is either a 0-based page number or a tuple (chapter, pno), with chapter number and page number within that chapter. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if page_id is None: page_id = 0 if page_id not in self: raise ValueError("page not in document") if type(page_id) is int and page_id < 0: np = self.page_count while page_id < 0: page_id += np if isinstance(page_id, int): page = mupdf.fz_load_page(self.this, page_id) else: chapter, pagenum = page_id page = mupdf.fz_load_chapter_page(self.this, chapter, pagenum) val = Page(page, self) val.thisown = True val.parent = self self._page_refs[id(val)] = val val._annot_refs = weakref.WeakValueDictionary() val.number = page_id return val def location_from_page_number(self, pno): """Convert pno to (chapter, page).""" if self.is_closed: raise ValueError("document closed") this_doc = self.this loc = mupdf.fz_make_location(-1, -1) page_count = mupdf.fz_count_pages(this_doc) while pno < 0: pno += page_count if pno >= page_count: raise ValueError( MSG_BAD_PAGENO) loc = mupdf.fz_location_from_page_number(this_doc, pno) return loc.chapter, loc.page def make_bookmark(self, loc): """Make a page pointer before layouting document.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") loc = mupdf.FzLocation(*loc) mark = mupdf.ll_fz_make_bookmark2( self.this.m_internal, loc.internal()) return mark @property def markinfo(self) -> dict: """Return the PDF MarkInfo value.""" xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "MarkInfo") if rc[0] == "null": return {} if rc[0] == "xref": xref = int(rc[1].split()[0]) val = self.xref_object(xref, compressed=True) elif rc[0] == "dict": val = rc[1] else: val = None if val is None or not (val[:2] == "<<" and val[-2:] == ">>"): return {} valid = {"Marked": False, "UserProperties": False, "Suspects": False} val = val[2:-2].split("/") for v in val[1:]: try: key, value = v.split() except Exception: if g_exceptions_verbose > 1: exception_info() return valid if value == "true": valid[key] = True return valid def move_page(self, pno: int, to: int =-1): """Move a page within a PDF document. Args: pno: source page number. to: put before this page, '-1' means after last page. """ if self.is_closed: raise ValueError("document closed") page_count = len(self) if (pno not in range(page_count) or to not in range(-1, page_count)): raise ValueError("bad page number(s)") before = 1 copy = 0 if to == -1: to = page_count - 1 before = 0 return self._move_copy_page(pno, to, before, copy) @property def name(self): return self._name def need_appearances(self, value=None): """Get/set the NeedAppearances value.""" if not self.is_form_pdf: return None pdf = _as_pdf_document(self) oldval = -1 appkey = "NeedAppearances" form = mupdf.pdf_dict_getp( mupdf.pdf_trailer(pdf), "Root/AcroForm", ) app = mupdf.pdf_dict_gets(form, appkey) if mupdf.pdf_is_bool(app): oldval = mupdf.pdf_to_bool(app) if value: mupdf.pdf_dict_puts(form, appkey, mupdf.PDF_TRUE) else: mupdf.pdf_dict_puts(form, appkey, mupdf.PDF_FALSE) if value is None: return oldval >= 0 return value @property def needs_pass(self): """Indicate password required.""" if self.is_closed: raise ValueError("document closed") document = self.this if isinstance(self.this, mupdf.FzDocument) else self.this.super() ret = mupdf.fz_needs_password( document) return ret def new_page( doc: 'Document', pno: int = -1, width: float = 595, height: float = 842, ) -> Page: """Create and return a new page object. Args: pno: (int) insert before this page. Default: after last page. width: (float) page width in points. Default: 595 (ISO A4 width). height: (float) page height in points. Default 842 (ISO A4 height). Returns: A pymupdf.Page object. """ doc._newPage(pno, width=width, height=height) return doc[pno] def next_location(self, page_id): """Get (chapter, page) of next page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(page_id) is int: page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") if tuple(page_id) == self.last_location: return () this_doc = _as_fz_document(self) val = page_id[ 0] if not isinstance(val, int): RAISEPY(MSG_BAD_PAGEID, PyExc_ValueError) chapter = val val = page_id[ 1] pno = val loc = mupdf.fz_make_location(chapter, pno) next_loc = mupdf.fz_next_page( this_doc, loc) return next_loc.chapter, next_loc.page def page_annot_xrefs(self, n): if g_use_extra: return extra.page_annot_xrefs( self.this, n) if isinstance(self.this, mupdf.PdfDocument): page_count = mupdf.pdf_count_pages(self.this) pdf_document = self.this else: page_count = mupdf.fz_count_pages(self.this) pdf_document = _as_pdf_document(self) while n < 0: n += page_count if n > page_count: raise ValueError( MSG_BAD_PAGENO) page_obj = mupdf.pdf_lookup_page_obj(pdf_document, n) annots = JM_get_annot_xref_list(page_obj) return annots @property def page_count(self): """Number of pages.""" if self.is_closed: raise ValueError('document closed') if g_use_extra: return self.page_count2(self) if isinstance( self.this, mupdf.FzDocument): return mupdf.fz_count_pages( self.this) else: return mupdf.pdf_count_pages( self.this) def page_cropbox(self, pno): """Get CropBox of page number (without loading page).""" if self.is_closed: raise ValueError("document closed") this_doc = self.this page_count = mupdf.fz_count_pages( this_doc) n = pno while n < 0: n += page_count pdf = _as_pdf_document(self) if n >= page_count: raise ValueError( MSG_BAD_PAGENO) pageref = mupdf.pdf_lookup_page_obj( pdf, n) cropbox = JM_cropbox(pageref) val = JM_py_from_rect(cropbox) val = Rect(val) return val def page_number_from_location(self, page_id): """Convert (chapter, pno) to page number.""" if type(page_id) is int: np = self.page_count while page_id < 0: page_id += np page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") chapter, pno = page_id loc = mupdf.fz_make_location( chapter, pno) page_n = mupdf.fz_page_number_from_location( self.this, loc) return page_n def page_xref(self, pno): """Get xref of page number.""" if g_use_extra: return extra.page_xref( self.this, pno) if self.is_closed: raise ValueError("document closed") page_count = mupdf.fz_count_pages(self.this) n = pno while n < 0: n += page_count pdf = _as_pdf_document(self) xref = 0 if n >= page_count: raise ValueError( MSG_BAD_PAGENO) xref = mupdf.pdf_to_num(mupdf.pdf_lookup_page_obj(pdf, n)) return xref @property def pagelayout(self) -> str: """Return the PDF PageLayout value. """ xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "PageLayout") if rc[0] == "null": return "SinglePage" if rc[0] == "name": return rc[1][1:] return "SinglePage" @property def pagemode(self) -> str: """Return the PDF PageMode value. """ xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "PageMode") if rc[0] == "null": return "UseNone" if rc[0] == "name": return rc[1][1:] return "UseNone" def pages(self, start: OptInt =None, stop: OptInt =None, step: OptInt =None) -> collections.abc.Iterable[Page]: """Return a generator iterator over a page range. Arguments have the same meaning as for the range() built-in. """ if not self.page_count: return # set the start value start = start or 0 while start < 0: start += self.page_count if start not in range(self.page_count): raise ValueError("bad start page number") # set the stop value stop = stop if stop is not None and stop <= self.page_count else self.page_count # set the step value if step == 0: raise ValueError("arg 3 must not be zero") if step is None: if start > stop: step = -1 else: step = 1 for pno in range(start, stop, step): yield (self.load_page(pno)) def pdf_catalog(self): """Get xref of PDF catalog.""" pdf = _as_pdf_document(self, required=0) xref = 0 if not pdf.m_internal: return xref root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) xref = mupdf.pdf_to_num(root) return xref def pdf_trailer(self, compressed=0, ascii=0): """Get PDF trailer as a string.""" return self.xref_object(-1, compressed=compressed, ascii=ascii) @property def permissions(self): """Document permissions.""" if self.is_encrypted: return 0 doc =self.this pdf = mupdf.pdf_document_from_fz_document(doc) # for PDF return result of standard function if pdf.m_internal: return mupdf.pdf_document_permissions(pdf) # otherwise simulate the PDF return value perm = 0xFFFFFFFC # all permissions granted # now switch off where needed if not mupdf.fz_has_permission(doc, mupdf.FZ_PERMISSION_PRINT): perm = perm ^ mupdf.PDF_PERM_PRINT if not mupdf.fz_has_permission(doc, mupdf.FZ_PERMISSION_EDIT): perm = perm ^ mupdf.PDF_PERM_MODIFY if not mupdf.fz_has_permission(doc, mupdf.FZ_PERMISSION_COPY): perm = perm ^ mupdf.PDF_PERM_COPY if not mupdf.fz_has_permission(doc, mupdf.FZ_PERMISSION_ANNOTATE): perm = perm ^ mupdf.PDF_PERM_ANNOTATE return perm def prev_location(self, page_id): """Get (chapter, page) of previous page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(page_id) is int: page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") if page_id == (0, 0): return () chapter, pno = page_id loc = mupdf.fz_make_location(chapter, pno) prev_loc = mupdf.fz_previous_page(self.this, loc) return prev_loc.chapter, prev_loc.page def reload_page(self, page: Page) -> Page: """Make a fresh copy of a page.""" old_annots = {} # copy annot references to here pno = page.number # save the page number for k, v in page._annot_refs.items(): # save the annot dictionary old_annots[k] = v # When we call `self.load_page()` below, it will end up in # fz_load_chapter_page(), which will return any matching page in the # document's list of non-ref-counted loaded pages, instead of actually # reloading the page. # # We want to assert that we have actually reloaded the fz_page, and not # simply returned the same `fz_page*` pointer from the document's list # of non-ref-counted loaded pages. # # So we first remove our reference to the `fz_page*`. This will # decrement .refs, and if .refs was 1, this is guaranteed to free the # `fz_page*` and remove it from the document's list if it was there. So # we are guaranteed that our returned `fz_page*` is from a genuine # reload, even if it happens to reuse the original block of memory. # # However if the original .refs is greater than one, there must be # other references to the `fz_page` somewhere, and we require that # these other references are not keeping the page in the document's # list. We check that we are returning a newly loaded page by # asserting that our returned `fz_page*` is different from the original # `fz_page*` - the original was not freed, so a new `fz_page` cannot # reuse the same block of memory. # refs_old = page.this.m_internal.refs m_internal_old = page.this.m_internal_value() page.this = None page._erase() # remove the page page = None TOOLS.store_shrink(100) page = self.load_page(pno) # reload the page # copy annot refs over to the new dictionary #page_proxy = weakref.proxy(page) for k, v in old_annots.items(): annot = old_annots[k] #annot.parent = page_proxy # refresh parent to new page page._annot_refs[k] = annot if refs_old == 1: # We know that `page.this = None` will have decremented the ref # count to zero so we are guaranteed that the new `fz_page` is a # new page even if it happens to have reused the same block of # memory. pass else: # Check that the new `fz_page*` is different from the original. m_internal_new = page.this.m_internal_value() assert m_internal_new != m_internal_old, \ f'{refs_old=} {m_internal_old=:#x} {m_internal_new=:#x}' return page def repair(self): ''' If we are a PDF document, does repair. ''' pdf = _as_pdf_document(self, required=False) if pdf.m_internal: mupdf.pdf_check_document(pdf) def resolve_link(self, uri=None, chapters=0): """Calculate internal link destination. Args: uri: (str) some Link.uri chapters: (bool) whether to use (chapter, page) format Returns: (page_id, x, y) where x, y are point coordinates on the page. page_id is either page number (if chapters=0), or (chapter, pno). """ if not uri: if chapters: return (-1, -1), 0, 0 return -1, 0, 0 try: loc, xp, yp = mupdf.fz_resolve_link(self.this, uri) except Exception: if g_exceptions_verbose: exception_info() if chapters: return (-1, -1), 0, 0 return -1, 0, 0 if chapters: return (loc.chapter, loc.page), xp, yp pno = mupdf.fz_page_number_from_location(self.this, loc) return pno, xp, yp def rewrite_images( self, dpi_threshold=None, dpi_target=0, quality=0, lossy=True, lossless=True, bitonal=True, color=True, gray=True, set_to_gray=False, options=None, ): """Rewrite images in a PDF document. The typical use case is to reduce the size of the PDF by recompressing images. Default parameters will convert all images to JPEG where possible, using the specified resolutions and quality. Exclude undesired images by setting parameters to False. Args: dpi_threshold: look at images with a larger DPI only. dpi_target: change eligible images to this DPI. quality: Quality of the recompressed images (0-100). lossy: process lossy image types (e.g. JPEG). lossless: process lossless image types (e.g. PNG). bitonal: process black-and-white images (e.g. FAX) color: process colored images. gray: process gray images. set_to_gray: whether to change the PDF to gray at process start. options: (PdfImageRewriterOptions) Custom options for image rewriting (optional). Expert use only. If provided, other parameters are ignored, except set_to_gray. """ quality_str = str(quality) if not dpi_threshold: dpi_threshold = dpi_target = 0 if dpi_target > 0 and dpi_target >= dpi_threshold: raise ValueError("{dpi_target=} must be less than {dpi_threshold=}") template_opts = mupdf.PdfImageRewriterOptions() dir1 = set(dir(template_opts)) # for checking that only existing options are set if not options: opts = mupdf.PdfImageRewriterOptions() if bitonal: opts.bitonal_image_recompress_method = mupdf.FZ_RECOMPRESS_FAX opts.bitonal_image_subsample_method = mupdf.FZ_SUBSAMPLE_AVERAGE opts.bitonal_image_subsample_to = dpi_target opts.bitonal_image_recompress_quality = quality_str opts.bitonal_image_subsample_threshold = dpi_threshold if color: if lossless: opts.color_lossless_image_recompress_method = mupdf.FZ_RECOMPRESS_JPEG opts.color_lossless_image_subsample_method = mupdf.FZ_SUBSAMPLE_AVERAGE opts.color_lossless_image_subsample_to = dpi_target opts.color_lossless_image_subsample_threshold = dpi_threshold opts.color_lossless_image_recompress_quality = quality_str if lossy: opts.color_lossy_image_recompress_method = mupdf.FZ_RECOMPRESS_JPEG opts.color_lossy_image_subsample_method = mupdf.FZ_SUBSAMPLE_AVERAGE opts.color_lossy_image_subsample_threshold = dpi_threshold opts.color_lossy_image_subsample_to = dpi_target opts.color_lossy_image_recompress_quality = quality_str if gray: if lossless: opts.gray_lossless_image_recompress_method = mupdf.FZ_RECOMPRESS_JPEG opts.gray_lossless_image_subsample_method = mupdf.FZ_SUBSAMPLE_AVERAGE opts.gray_lossless_image_subsample_to = dpi_target opts.gray_lossless_image_subsample_threshold = dpi_threshold opts.gray_lossless_image_recompress_quality = quality_str if lossy: opts.gray_lossy_image_recompress_method = mupdf.FZ_RECOMPRESS_JPEG opts.gray_lossy_image_subsample_method = mupdf.FZ_SUBSAMPLE_AVERAGE opts.gray_lossy_image_subsample_threshold = dpi_threshold opts.gray_lossy_image_subsample_to = dpi_target opts.gray_lossy_image_recompress_quality = quality_str else: opts = options dir2 = set(dir(opts)) # checking that only possible options were used invalid_options = dir2 - dir1 if invalid_options: raise ValueError(f"Invalid options: {invalid_options}") if set_to_gray: self.recolor(1) pdf = _as_pdf_document(self) mupdf.pdf_rewrite_images(pdf, opts) def recolor(self, components=1): """Change the color component count on all pages. Args: components: (int) desired color component count, one of 1, 3, 4. Invokes the same-named method for all pages. """ if not self.is_pdf: raise ValueError("is no PDF") for i in range(self.page_count): self.load_page(i).recolor(components) def resolve_names(self): """Convert the PDF's destination names into a Python dict. The only parameter is the pymupdf.Document. All names found in the catalog under keys "/Dests" and "/Names/Dests" are being included. Returns: A dcitionary with the following layout: - key: (str) the name - value: (dict) with the following layout: * "page": target page number (0-based). If no page number found -1. * "to": (x, y) target point on page - currently in PDF coordinates, i.e. point (0,0) is the bottom-left of the page. * "zoom": (float) the zoom factor * "dest": (str) only occurs if the target location on the page has not been provided as "/XYZ" or if no page number was found. Examples: {'__bookmark_1': {'page': 0, 'to': (0.0, 541.0), 'zoom': 0.0}, '__bookmark_2': {'page': 0, 'to': (0.0, 481.45), 'zoom': 0.0}} or '21154a7c20684ceb91f9c9adc3b677c40': {'page': -1, 'dest': '/XYZ 15.75 1486 0'}, ... """ if hasattr(self, "_resolved_names"): # do not execute multiple times! return self._resolved_names # this is a backward listing of page xref to page number page_xrefs = {self.page_xref(i): i for i in range(self.page_count)} def obj_string(obj): """Return string version of a PDF object definition.""" buffer = mupdf.fz_new_buffer(512) output = mupdf.FzOutput(buffer) mupdf.pdf_print_obj(output, obj, 1, 0) output.fz_close_output() return JM_UnicodeFromBuffer(buffer) def get_array(val): """Generate value of one item of the names dictionary.""" templ_dict = {"page": -1, "dest": ""} # value template if val.pdf_is_indirect(): val = mupdf.pdf_resolve_indirect(val) if val.pdf_is_array(): array = obj_string(val) elif val.pdf_is_dict(): array = obj_string(mupdf.pdf_dict_gets(val, "D")) else: # if all fails return the empty template return templ_dict # replace PDF "null" by zero, omit the square brackets array = array.replace("null", "0")[1:-1] # find stuff before first "/" idx = array.find("/") if idx < 1: # this has no target page spec templ_dict["dest"] = array # return the orig. string return templ_dict subval = array[:idx].strip() # stuff before "/" array = array[idx:] # stuff from "/" onwards templ_dict["dest"] = array # if we start with /XYZ: extract x, y, zoom # 1, 2 or 3 of these values may actually be supplied if array.startswith("/XYZ"): del templ_dict["dest"] # don't return orig string in this case # make a list of the 3 tokens following "/XYZ" array_list = array.split()[1:4] # omit "/XYZ" # fill up missing tokens with "0" strings while len(array_list) < 3: # fill up if too short array_list.append("0") # add missing values # make list of 3 floats: x, y and zoom t = list(map(float, array_list)) # the resulting x, y, z values templ_dict["to"] = (t[0], t[1]) templ_dict["zoom"] = t[2] # extract page number if subval.endswith("0 R"): # page xref given? templ_dict["page"] = page_xrefs.get(int(subval.split()[0]),-1) else: # naked page number given templ_dict["page"] = int(subval) return templ_dict def fill_dict(dest_dict, pdf_dict): """Generate name resolution items for pdf_dict. This may be either "/Names/Dests" or just "/Dests" """ # length of the PDF dictionary name_count = mupdf.pdf_dict_len(pdf_dict) # extract key-val of each dict item for i in range(name_count): key = mupdf.pdf_dict_get_key(pdf_dict, i) val = mupdf.pdf_dict_get_val(pdf_dict, i) if key.pdf_is_name(): # this should always be true! dict_key = key.pdf_to_name() else: message(f"key {i} is no /Name") dict_key = None if dict_key: dest_dict[dict_key] = get_array(val) # store key/value in dict # access underlying PDF document of fz Document pdf = mupdf.pdf_document_from_fz_document(self) # access PDF catalog catalog = mupdf.pdf_dict_gets(mupdf.pdf_trailer(pdf), "Root") dest_dict = {} # make PDF_NAME(Dests) dests = mupdf.pdf_new_name("Dests") # extract destinations old style (PDF 1.1) old_dests = mupdf.pdf_dict_get(catalog, dests) if old_dests.pdf_is_dict(): fill_dict(dest_dict, old_dests) # extract destinations new style (PDF 1.2+) tree = mupdf.pdf_load_name_tree(pdf, dests) if tree.pdf_is_dict(): fill_dict(dest_dict, tree) self._resolved_names = dest_dict # store result or reuse return dest_dict def save( self, filename, garbage=0, clean=0, deflate=0, deflate_images=0, deflate_fonts=0, incremental=0, ascii=0, expand=0, linear=0, no_new_id=0, appearance=0, pretty=0, encryption=1, permissions=4095, owner_pw=None, user_pw=None, preserve_metadata=1, use_objstms=0, compression_effort=0, raise_on_repair=False, ): # From %pythonprepend save # is_repaired_pre = self.is_repaired """Save PDF to file, pathlib.Path or file pointer.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(filename) is str: pass elif hasattr(filename, "open"): # assume: pathlib.Path filename = str(filename) elif hasattr(filename, "name"): # assume: file object filename = filename.name elif not hasattr(filename, "seek"): # assume file object raise ValueError("filename must be str, Path or file object") if filename == self.name and not incremental: raise ValueError("save to original must be incremental") if linear and use_objstms: raise ValueError("'linear' and 'use_objstms' cannot both be requested") if self.page_count < 1: raise ValueError("cannot save with zero pages") if incremental: if self.name != filename or self.stream: raise ValueError("incremental needs original file") if user_pw and len(user_pw) > 40 or owner_pw and len(owner_pw) > 40: raise ValueError("password length must not exceed 40") pdf = _as_pdf_document(self) opts = mupdf.PdfWriteOptions() opts.do_incremental = incremental opts.do_ascii = ascii opts.do_compress = deflate opts.do_compress_images = deflate_images opts.do_compress_fonts = deflate_fonts opts.do_decompress = expand opts.do_garbage = garbage opts.do_pretty = pretty opts.do_linear = linear opts.do_clean = clean opts.do_sanitize = clean opts.dont_regenerate_id = no_new_id opts.do_appearance = appearance opts.do_encrypt = encryption opts.permissions = permissions if owner_pw is not None: opts.opwd_utf8_set_value(owner_pw) elif user_pw is not None: opts.opwd_utf8_set_value(user_pw) if user_pw is not None: opts.upwd_utf8_set_value(user_pw) opts.do_preserve_metadata = preserve_metadata opts.do_use_objstms = use_objstms opts.compression_effort = compression_effort out = None pdf.m_internal.resynth_required = 0 JM_embedded_clean(pdf) if no_new_id == 0: JM_ensure_identity(pdf) if isinstance(filename, str): #log( 'calling mupdf.pdf_save_document()') mupdf.pdf_save_document(pdf, filename, opts) else: out = JM_new_output_fileptr(filename) #log( f'{type(out)=} {type(out.this)=}') mupdf.pdf_write_document(pdf, out, opts) out.fz_close_output() if raise_on_repair: if self.is_repaired and not is_repaired_pre: raise Exception(f'Document save did a repair') def save_snapshot(self, filename): """Save a file snapshot suitable for journalling.""" if self.is_closed: raise ValueError("doc is closed") if type(filename) is str: pass elif hasattr(filename, "open"): # assume: pathlib.Path filename = str(filename) elif hasattr(filename, "name"): # assume: file object filename = filename.name else: raise ValueError("filename must be str, Path or file object") if filename == self.name: raise ValueError("cannot snapshot to original") pdf = _as_pdf_document(self) mupdf.pdf_save_snapshot(pdf, filename) def saveIncr(self): """ Save PDF incrementally""" return self.save(self.name, incremental=True, encryption=mupdf.PDF_ENCRYPT_KEEP) # ------------------------------------------------------------------------------ # Remove potentially sensitive data from a PDF. Similar to the Adobe # Acrobat 'sanitize' function # ------------------------------------------------------------------------------ def scrub( doc: 'Document', attached_files: bool = True, clean_pages: bool = True, embedded_files: bool = True, hidden_text: bool = True, javascript: bool = True, metadata: bool = True, redactions: bool = True, redact_images: int = 0, remove_links: bool = True, reset_fields: bool = True, reset_responses: bool = True, thumbnails: bool = True, xml_metadata: bool = True, ) -> None: def remove_hidden(cont_lines): """Remove hidden text from a PDF page. Args: cont_lines: list of lines with /Contents content. Should have status from after page.cleanContents(). Returns: List of /Contents lines from which hidden text has been removed. Notes: The input must have been created after the page's /Contents object(s) have been cleaned with page.cleanContents(). This ensures a standard formatting: one command per line, single spaces between operators. This allows for drastic simplification of this code. """ out_lines = [] # will return this in_text = False # indicate if within BT/ET object suppress = False # indicate text suppression active make_return = False for line in cont_lines: if line == b"BT": # start of text object in_text = True # switch on out_lines.append(line) # output it continue if line == b"ET": # end of text object in_text = False # switch off out_lines.append(line) # output it continue if line == b"3 Tr": # text suppression operator suppress = True # switch on make_return = True continue if line[-2:] == b"Tr" and line[0] != b"3": suppress = False # text rendering changed out_lines.append(line) continue if line == b"Q": # unstack command also switches off suppress = False out_lines.append(line) continue if suppress and in_text: # suppress hidden lines continue out_lines.append(line) if make_return: return out_lines else: return None if not doc.is_pdf: # only works for PDF raise ValueError("is no PDF") if doc.is_encrypted or doc.is_closed: raise ValueError("closed or encrypted doc") if not clean_pages: hidden_text = False redactions = False if metadata: doc.set_metadata({}) # remove standard metadata for page in doc: if reset_fields: # reset form fields (widgets) for widget in page.widgets(): widget.reset() if remove_links: links = page.get_links() # list of all links on page for link in links: # remove all links page.delete_link(link) found_redacts = False for annot in page.annots(): if annot.type[0] == mupdf.PDF_ANNOT_FILE_ATTACHMENT and attached_files: annot.update_file(buffer_=b" ") # set file content to empty if reset_responses: annot.delete_responses() if annot.type[0] == mupdf.PDF_ANNOT_REDACT: # pylint: disable=no-member found_redacts = True if redactions and found_redacts: page.apply_redactions(images=redact_images) if not (clean_pages or hidden_text): continue # done with the page page.clean_contents() if not page.get_contents(): continue if hidden_text: xrefs = page.get_contents() assert len(xrefs) == 1 # only one because of cleaning. xref = xrefs[0] cont = doc.xref_stream(xref) cont_lines = remove_hidden(cont.splitlines()) # remove hidden text if cont_lines: # something was actually removed cont = b"\n".join(cont_lines) doc.update_stream(xref, cont) # rewrite the page /Contents if thumbnails: # remove page thumbnails? if doc.xref_get_key(page.xref, "Thumb")[0] != "null": doc.xref_set_key(page.xref, "Thumb", "null") # pages are scrubbed, now perform document-wide scrubbing # remove embedded files if embedded_files: for name in doc.embfile_names(): doc.embfile_del(name) if xml_metadata: doc.del_xml_metadata() if not (xml_metadata or javascript): xref_limit = 0 else: xref_limit = doc.xref_length() for xref in range(1, xref_limit): if not doc.xref_object(xref): msg = f"bad xref {xref} - clean PDF before scrubbing" raise ValueError(msg) if javascript and doc.xref_get_key(xref, "S")[1] == "/JavaScript": # a /JavaScript action object obj = "<>" # replace with a null JavaScript doc.update_object(xref, obj) # update this object continue # no further handling if not xml_metadata: continue if doc.xref_get_key(xref, "Type")[1] == "/Metadata": # delete any metadata object directly doc.update_object(xref, "<<>>") doc.update_stream(xref, b"deleted", new=True) continue if doc.xref_get_key(xref, "Metadata")[0] != "null": doc.xref_set_key(xref, "Metadata", "null") def search_page_for( doc: 'Document', pno: int, text: str, quads: bool = False, clip: rect_like = None, flags: int = None, textpage: 'TextPage' = None, ) -> list: """Search for a string on a page. Args: pno: page number text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: reuse a prepared textpage Returns: a list of rectangles or quads, each containing an occurrence. """ if flags is None: flags = (0 | TEXT_DEHYPHENATE | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP ) return doc[pno].search_for( text, quads=quads, clip=clip, flags=flags, textpage=textpage, ) def select(self, pyliste): """Build sub-pdf with page numbers in the list.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: raise ValueError("is no PDF") if not hasattr(pyliste, "__getitem__"): raise ValueError("sequence required") valid_range = range(len(self)) if (len(pyliste) == 0 or min(pyliste) not in valid_range or max(pyliste) not in valid_range ): raise ValueError("bad page number(s)") # get underlying pdf document, pdf = _as_pdf_document(self) # create page sub-pdf via pdf_rearrange_pages2(). # # We use PDF_CLEAN_STRUCTURE_KEEP otherwise we lose structure tree # which, for example, breaks test_3705. mupdf.pdf_rearrange_pages2(pdf, pyliste, mupdf.PDF_CLEAN_STRUCTURE_KEEP) # remove any existing pages with their kids self._reset_page_refs() def set_language(self, language=None): pdf = _as_pdf_document(self) if not language: lang = mupdf.FZ_LANG_UNSET else: lang = mupdf.fz_text_language_from_string(language) mupdf.pdf_set_document_language(pdf, lang) return True def set_layer(self, config, basestate=None, on=None, off=None, rbgroups=None, locked=None): """Set the PDF keys /ON, /OFF, /RBGroups of an OC layer.""" if self.is_closed: raise ValueError("document closed") ocgs = set(self.get_ocgs().keys()) if ocgs == set(): raise ValueError("document has no optional content") if on: if type(on) not in (list, tuple): raise ValueError("bad type: 'on'") s = set(on).difference(ocgs) if s != set(): raise ValueError(f"bad OCGs in 'on': {s}") if off: if type(off) not in (list, tuple): raise ValueError("bad type: 'off'") s = set(off).difference(ocgs) if s != set(): raise ValueError(f"bad OCGs in 'off': {s}") if locked: if type(locked) not in (list, tuple): raise ValueError("bad type: 'locked'") s = set(locked).difference(ocgs) if s != set(): raise ValueError(f"bad OCGs in 'locked': {s}") if rbgroups: if type(rbgroups) not in (list, tuple): raise ValueError("bad type: 'rbgroups'") for x in rbgroups: if not type(x) in (list, tuple): raise ValueError(f"bad RBGroup '{x}'") s = set(x).difference(ocgs) if s != set(): raise ValueError(f"bad OCGs in RBGroup: {s}") if basestate: basestate = str(basestate).upper() if basestate == "UNCHANGED": basestate = "Unchanged" if basestate not in ("ON", "OFF", "Unchanged"): raise ValueError("bad 'basestate'") pdf = _as_pdf_document(self) ocp = mupdf.pdf_dict_getl( mupdf.pdf_trailer( pdf), PDF_NAME('Root'), PDF_NAME('OCProperties'), ) if not ocp.m_internal: return if config == -1: obj = mupdf.pdf_dict_get( ocp, PDF_NAME('D')) else: obj = mupdf.pdf_array_get( mupdf.pdf_dict_get( ocp, PDF_NAME('Configs')), config, ) if not obj.m_internal: raise ValueError( MSG_BAD_OC_CONFIG) JM_set_ocg_arrays( obj, basestate, on, off, rbgroups, locked) mupdf.ll_pdf_read_ocg( pdf.m_internal) def set_layer_ui_config(self, number, action=0): """Set / unset OC intent configuration.""" # The user might have given the name instead of sequence number, # so select by that name and continue with corresp. number if isinstance(number, str): select = [ui["number"] for ui in self.layer_ui_configs() if ui["text"] == number] if select == []: raise ValueError(f"bad OCG '{number}'.") number = select[0] # this is the number for the name pdf = _as_pdf_document(self) if action == 1: mupdf.pdf_toggle_layer_config_ui(pdf, number) elif action == 2: mupdf.pdf_deselect_layer_config_ui(pdf, number) else: mupdf.pdf_select_layer_config_ui(pdf, number) def set_markinfo(self, markinfo: dict) -> bool: """Set the PDF MarkInfo values.""" xref = self.pdf_catalog() if xref == 0: raise ValueError("not a PDF") if not markinfo or not isinstance(markinfo, dict): return False valid = {"Marked": False, "UserProperties": False, "Suspects": False} if not set(valid.keys()).issuperset(markinfo.keys()): badkeys = f"bad MarkInfo key(s): {set(markinfo.keys()).difference(valid.keys())}" raise ValueError(badkeys) pdfdict = "<<" valid.update(markinfo) for key, value in valid.items(): value=str(value).lower() if value not in ("true", "false"): raise ValueError(f"bad key value '{key}': '{value}'") pdfdict += f"/{key} {value}" pdfdict += ">>" self.xref_set_key(xref, "MarkInfo", pdfdict) return True def set_metadata(doc: 'Document', m: dict = None) -> None: """Update the PDF /Info object. Args: m: a dictionary like doc.metadata. """ if not doc.is_pdf: raise ValueError("is no PDF") if doc.is_closed or doc.is_encrypted: raise ValueError("document closed or encrypted") if m is None: m = {} elif type(m) is not dict: raise ValueError("bad metadata") keymap = { "author": "Author", "producer": "Producer", "creator": "Creator", "title": "Title", "format": None, "encryption": None, "creationDate": "CreationDate", "modDate": "ModDate", "subject": "Subject", "keywords": "Keywords", "trapped": "Trapped", } valid_keys = set(keymap.keys()) diff_set = set(m.keys()).difference(valid_keys) if diff_set != set(): msg = f"bad dict key(s): {diff_set}" raise ValueError(msg) t, temp = doc.xref_get_key(-1, "Info") if t != "xref": info_xref = 0 else: info_xref = int(temp.replace("0 R", "")) if m == {} and info_xref == 0: # nothing to do return if info_xref == 0: # no prev metadata: get new xref info_xref = doc.get_new_xref() doc.update_object(info_xref, "<<>>") # fill it with empty object doc.xref_set_key(-1, "Info", f"{info_xref} 0 R") elif m == {}: # remove existing metadata doc.xref_set_key(-1, "Info", "null") doc.init_doc() return for key, val in [(k, v) for k, v in m.items() if keymap[k] is not None]: pdf_key = keymap[key] if not bool(val) or val in ("none", "null"): val = "null" else: val = get_pdf_str(val) doc.xref_set_key(info_xref, pdf_key, val) doc.init_doc() return def set_oc(doc: 'Document', xref: int, oc: int) -> None: """Attach optional content object to image or form xobject. Args: xref: (int) xref number of an image or form xobject oc: (int) xref number of an OCG or OCMD """ if doc.is_closed or doc.is_encrypted: raise ValueError("document close or encrypted") t, name = doc.xref_get_key(xref, "Subtype") if t != "name" or name not in ("/Image", "/Form"): raise ValueError(f"bad object type at xref {xref}") if oc > 0: t, name = doc.xref_get_key(oc, "Type") if t != "name" or name not in ("/OCG", "/OCMD"): raise ValueError(f"bad object type at xref {oc}") if oc == 0 and "OC" in doc.xref_get_keys(xref): doc.xref_set_key(xref, "OC", "null") return None doc.xref_set_key(xref, "OC", f"{oc} 0 R") return None def set_ocmd( doc: 'Document', xref: int = 0, ocgs: typing.Union[list, None] = None, policy: OptStr = None, ve: typing.Union[list, None] = None, ) -> int: """Create or update an OCMD object in a PDF document. Args: xref: (int) 0 for creating a new object, otherwise update existing one. ocgs: (list) OCG xref numbers, which shall be subject to 'policy'. policy: one of 'AllOn', 'AllOff', 'AnyOn', 'AnyOff' (any casing). ve: (list) visibility expression. Use instead of 'ocgs' with 'policy'. Returns: Xref of the created or updated OCMD. """ all_ocgs = set(doc.get_ocgs().keys()) def ve_maker(ve): if type(ve) not in (list, tuple) or len(ve) < 2: raise ValueError(f"bad 've' format: {ve}") if ve[0].lower() not in ("and", "or", "not"): raise ValueError(f"bad operand: {ve[0]}") if ve[0].lower() == "not" and len(ve) != 2: raise ValueError(f"bad 've' format: {ve}") item = f"[/{ve[0].title()}" for x in ve[1:]: if type(x) is int: if x not in all_ocgs: raise ValueError(f"bad OCG {x}") item += f" {x} 0 R" else: item += f" {ve_maker(x)}" item += "]" return item text = "<>". """ s = f"{label['startpage']}<<" if label.get("prefix", "") != "": s += f"/P({label['prefix']})" if label.get("style", "") != "": s += f"/S/{label['style']}" if label.get("firstpagenum", 1) > 1: s += f"/St {label['firstpagenum']}" s += ">>" return s def create_nums(labels): """Return concatenated string of all labels rules. Args: labels: (list) dictionaries as created by function 'rule_dict'. Returns: PDF compatible string for page label definitions, ready to be enclosed in PDF array 'Nums[...]'. """ labels.sort(key=lambda x: x["startpage"]) s = "".join([create_label_str(label) for label in labels]) return s doc._set_page_labels(create_nums(labels)) def set_toc( doc: 'Document', toc: list, collapse: int = 1, ) -> int: """Create new outline tree (table of contents, TOC). Args: toc: (list, tuple) each entry must contain level, title, page and optionally top margin on the page. None or '()' remove the TOC. collapse: (int) collapses entries beyond this level. Zero or None shows all entries unfolded. Returns: the number of inserted items, or the number of removed items respectively. """ if doc.is_closed or doc.is_encrypted: raise ValueError("document closed or encrypted") if not doc.is_pdf: raise ValueError("is no PDF") if not toc: # remove all entries return len(doc._delToC()) # validity checks -------------------------------------------------------- if type(toc) not in (list, tuple): raise ValueError("'toc' must be list or tuple") toclen = len(toc) page_count = doc.page_count t0 = toc[0] if type(t0) not in (list, tuple): raise ValueError("items must be sequences of 3 or 4 items") if t0[0] != 1: raise ValueError("hierarchy level of item 0 must be 1") for i in list(range(toclen - 1)): t1 = toc[i] t2 = toc[i + 1] if not -1 <= t1[2] <= page_count: raise ValueError(f"row {i}: page number out of range") if (type(t2) not in (list, tuple)) or len(t2) not in (3, 4): raise ValueError(f"bad row {(i + 1)}") if (type(t2[0]) is not int) or t2[0] < 1: raise ValueError(f"bad hierarchy level in row {(i + 1)}") if t2[0] > t1[0] + 1: raise ValueError(f"bad hierarchy level in row {(i + 1)}") # no formal errors in toc -------------------------------------------------- # -------------------------------------------------------------------------- # make a list of xref numbers, which we can use for our TOC entries # -------------------------------------------------------------------------- old_xrefs = doc._delToC() # del old outlines, get their xref numbers # prepare table of xrefs for new bookmarks old_xrefs = [] xref = [0] + old_xrefs xref[0] = doc._getOLRootNumber() # entry zero is outline root xref number if toclen > len(old_xrefs): # too few old xrefs? for i in range((toclen - len(old_xrefs))): xref.append(doc.get_new_xref()) # acquire new ones lvltab = {0: 0} # to store last entry per hierarchy level # ------------------------------------------------------------------------------ # contains new outline objects as strings - first one is the outline root # ------------------------------------------------------------------------------ olitems = [{"count": 0, "first": -1, "last": -1, "xref": xref[0]}] # ------------------------------------------------------------------------------ # build olitems as a list of PDF-like connected dictionaries # ------------------------------------------------------------------------------ for i in range(toclen): o = toc[i] lvl = o[0] # level title = get_pdf_str(o[1]) # title pno = min(doc.page_count - 1, max(0, o[2] - 1)) # page number page_xref = doc.page_xref(pno) page_height = doc.page_cropbox(pno).height top = Point(72, page_height - 36) dest_dict = {"to": top, "kind": LINK_GOTO} # fall back target if o[2] < 0: dest_dict["kind"] = LINK_NONE if len(o) > 3: # some target is specified if type(o[3]) in (int, float): # convert a number to a point dest_dict["to"] = Point(72, page_height - o[3]) else: # if something else, make sure we have a dict # We make a copy of o[3] to avoid modifying our caller's data. dest_dict = o[3].copy() if type(o[3]) is dict else dest_dict if "to" not in dest_dict: # target point not in dict? dest_dict["to"] = top # put default in else: # transform target to PDF coordinates page = doc[pno] point = Point(dest_dict["to"]) point.y = page.cropbox.height - point.y point = point * page.rotation_matrix dest_dict["to"] = (point.x, point.y) d = {} d["first"] = -1 d["count"] = 0 d["last"] = -1 d["prev"] = -1 d["next"] = -1 d["dest"] = utils.getDestStr(page_xref, dest_dict) d["top"] = dest_dict["to"] d["title"] = title d["parent"] = lvltab[lvl - 1] d["xref"] = xref[i + 1] d["color"] = dest_dict.get("color") d["flags"] = dest_dict.get("italic", 0) + 2 * dest_dict.get("bold", 0) lvltab[lvl] = i + 1 parent = olitems[lvltab[lvl - 1]] # the parent entry if ( dest_dict.get("collapse") or collapse and lvl > collapse ): # suppress expansion parent["count"] -= 1 # make /Count negative else: parent["count"] += 1 # positive /Count if parent["first"] == -1: parent["first"] = i + 1 parent["last"] = i + 1 else: d["prev"] = parent["last"] prev = olitems[parent["last"]] prev["next"] = i + 1 parent["last"] = i + 1 olitems.append(d) # ------------------------------------------------------------------------------ # now create each outline item as a string and insert it in the PDF # ------------------------------------------------------------------------------ for i, ol in enumerate(olitems): txt = "<<" if ol["count"] != 0: txt += f"/Count {ol['count']}" try: txt += ol["dest"] except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose >= 2: exception_info() pass try: if ol["first"] > -1: txt += f"/First {xref[ol['first']]} 0 R" except Exception: if g_exceptions_verbose >= 2: exception_info() pass try: if ol["last"] > -1: txt += f"/Last {xref[ol['last']]} 0 R" except Exception: if g_exceptions_verbose >= 2: exception_info() pass try: if ol["next"] > -1: txt += f"/Next {xref[ol['next']]} 0 R" except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose >= 2: exception_info() pass try: if ol["parent"] > -1: txt += f"/Parent {xref[ol['parent']]} 0 R" except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose >= 2: exception_info() pass try: if ol["prev"] > -1: txt += f"/Prev {xref[ol['prev']]} 0 R" except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose >= 2: exception_info() pass try: txt += "/Title" + ol["title"] except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose >= 2: exception_info() pass if ol.get("color") and len(ol["color"]) == 3: txt += f"/C[ {_format_g(tuple(ol['color']))}]" if ol.get("flags", 0) > 0: txt += f"/F {ol['flags']}" if i == 0: # special: this is the outline root txt += "/Type/Outlines" # so add the /Type entry txt += ">>" doc.update_object(xref[i], txt) # insert the PDF object doc.init_doc() return toclen def set_toc_item( doc: 'Document', idx: int, dest_dict: OptDict = None, kind: OptInt = None, pno: OptInt = None, uri: OptStr = None, title: OptStr = None, to: point_like = None, filename: OptStr = None, zoom: float = 0, ) -> None: """Update TOC item by index. It allows changing the item's title and link destination. Args: idx: (int) desired index of the TOC list, as created by get_toc. dest_dict: (dict) destination dictionary as created by get_toc(False). Outrules all other parameters. If None, the remaining parameters are used to make a dest dictionary. kind: (int) kind of link (pymupdf.LINK_GOTO, etc.). If None, then only the title will be updated. If pymupdf.LINK_NONE, the TOC item will be deleted. pno: (int) page number (1-based like in get_toc). Required if pymupdf.LINK_GOTO. uri: (str) the URL, required if pymupdf.LINK_URI. title: (str) the new title. No change if None. to: (point-like) destination on the target page. If omitted, (72, 36) will be used as target coordinates. filename: (str) destination filename, required for pymupdf.LINK_GOTOR and pymupdf.LINK_LAUNCH. name: (str) a destination name for pymupdf.LINK_NAMED. zoom: (float) a zoom factor for the target location (pymupdf.LINK_GOTO). """ xref = doc.get_outline_xrefs()[idx] page_xref = 0 if type(dest_dict) is dict: if dest_dict["kind"] == LINK_GOTO: pno = dest_dict["page"] page_xref = doc.page_xref(pno) page_height = doc.page_cropbox(pno).height to = dest_dict.get('to', Point(72, 36)) to.y = page_height - to.y dest_dict["to"] = to action = utils.getDestStr(page_xref, dest_dict) if not action.startswith("/A"): raise ValueError("bad bookmark dest") color = dest_dict.get("color") if color: color = list(map(float, color)) if len(color) != 3 or min(color) < 0 or max(color) > 1: raise ValueError("bad color value") bold = dest_dict.get("bold", False) italic = dest_dict.get("italic", False) flags = italic + 2 * bold collapse = dest_dict.get("collapse") return doc._update_toc_item( xref, action=action[2:], title=title, color=color, flags=flags, collapse=collapse, ) if kind == LINK_NONE: # delete bookmark item return doc.del_toc_item(idx) if kind is None and title is None: # treat as no-op return None if kind is None: # only update title text return doc._update_toc_item(xref, action=None, title=title) if kind == LINK_GOTO: if pno is None or pno not in range(1, doc.page_count + 1): raise ValueError("bad page number") page_xref = doc.page_xref(pno - 1) page_height = doc.page_cropbox(pno - 1).height if to is None: to = Point(72, page_height - 36) else: to = Point(to) to.y = page_height - to.y ddict = { "kind": kind, "to": to, "uri": uri, "page": pno, "file": filename, "zoom": zoom, } action = utils.getDestStr(page_xref, ddict) if action == "" or not action.startswith("/A"): raise ValueError("bad bookmark dest") return doc._update_toc_item(xref, action=action[2:], title=title) def set_xml_metadata(self, metadata): """Store XML document level metadata.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) root = mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')) if not root.m_internal: RAISEPY( MSG_BAD_PDFROOT, JM_Exc_FileDataError) res = mupdf.fz_new_buffer_from_copied_data( metadata.encode('utf-8')) xml = mupdf.pdf_dict_get( root, PDF_NAME('Metadata')) if xml.m_internal: JM_update_stream( pdf, xml, res, 0) else: xml = mupdf.pdf_add_stream( pdf, res, mupdf.PdfObj(), 0) mupdf.pdf_dict_put( xml, PDF_NAME('Type'), PDF_NAME('Metadata')) mupdf.pdf_dict_put( xml, PDF_NAME('Subtype'), PDF_NAME('XML')) mupdf.pdf_dict_put( root, PDF_NAME('Metadata'), xml) def subset_fonts(doc: 'Document', verbose: bool = False, fallback: bool = False) -> OptInt: """Build font subsets in a PDF. Eligible fonts are potentially replaced by smaller versions. Page text is NOT rewritten and thus should retain properties like being hidden or controlled by optional content. This method by default uses MuPDF's own internal feature to create subset fonts. As this is a new function, errors may still occur. In this case, please fall back to using the previous version by using "fallback=True". Fallback mode requires the external package 'fontTools'. Args: fallback: use the older deprecated implementation. verbose: only used by fallback mode. Returns: The new MuPDF-based code returns None. The deprecated fallback mode returns 0 if there are no fonts to subset. Otherwise, it returns the decrease in fontsize (the difference in fontsize), measured in bytes. """ # Font binaries: - "buffer" -> (names, xrefs, (unicodes, glyphs)) # An embedded font is uniquely defined by its fontbuffer only. It may have # multiple names and xrefs. # Once the sets of used unicodes and glyphs are known, we compute a # smaller version of the buffer user package fontTools. if not fallback: # by default use MuPDF function pdf = mupdf.pdf_document_from_fz_document(doc) mupdf.pdf_subset_fonts2(pdf, list(range(doc.page_count))) return font_buffers = {} def get_old_widths(xref): """Retrieve old font '/W' and '/DW' values.""" df = doc.xref_get_key(xref, "DescendantFonts") if df[0] != "array": # only handle xref specifications return None, None df_xref = int(df[1][1:-1].replace("0 R", "")) widths = doc.xref_get_key(df_xref, "W") if widths[0] != "array": # no widths key found widths = None else: widths = widths[1] dwidths = doc.xref_get_key(df_xref, "DW") if dwidths[0] != "int": dwidths = None else: dwidths = dwidths[1] return widths, dwidths def set_old_widths(xref, widths, dwidths): """Restore the old '/W' and '/DW' in subsetted font. If either parameter is None or evaluates to False, the corresponding dictionary key will be set to null. """ df = doc.xref_get_key(xref, "DescendantFonts") if df[0] != "array": # only handle xref specs return None df_xref = int(df[1][1:-1].replace("0 R", "")) if (type(widths) is not str or not widths) and doc.xref_get_key(df_xref, "W")[ 0 ] != "null": doc.xref_set_key(df_xref, "W", "null") else: doc.xref_set_key(df_xref, "W", widths) if (type(dwidths) is not str or not dwidths) and doc.xref_get_key( df_xref, "DW" )[0] != "null": doc.xref_set_key(df_xref, "DW", "null") else: doc.xref_set_key(df_xref, "DW", dwidths) return None def set_subset_fontname(new_xref): """Generate a name prefix to tag a font as subset. We use a random generator to select 6 upper case ASCII characters. The prefixed name must be put in the font xref as the "/BaseFont" value and in the FontDescriptor object as the '/FontName' value. """ # The following generates a prefix like 'ABCDEF+' import random import string prefix = "".join(random.choices(tuple(string.ascii_uppercase), k=6)) + "+" font_str = doc.xref_object(new_xref, compressed=True) font_str = font_str.replace("/BaseFont/", "/BaseFont/" + prefix) df = doc.xref_get_key(new_xref, "DescendantFonts") if df[0] == "array": df_xref = int(df[1][1:-1].replace("0 R", "")) fd = doc.xref_get_key(df_xref, "FontDescriptor") if fd[0] == "xref": fd_xref = int(fd[1].replace("0 R", "")) fd_str = doc.xref_object(fd_xref, compressed=True) fd_str = fd_str.replace("/FontName/", "/FontName/" + prefix) doc.update_object(fd_xref, fd_str) doc.update_object(new_xref, font_str) def build_subset(buffer, unc_set, gid_set): """Build font subset using fontTools. Args: buffer: (bytes) the font given as a binary buffer. unc_set: (set) required glyph ids. Returns: Either None if subsetting is unsuccessful or the subset font buffer. """ try: import fontTools.subset as fts except ImportError: if g_exceptions_verbose: exception_info() message("This method requires fontTools to be installed.") raise import tempfile with tempfile.TemporaryDirectory() as tmp_dir: oldfont_path = f"{tmp_dir}/oldfont.ttf" newfont_path = f"{tmp_dir}/newfont.ttf" uncfile_path = f"{tmp_dir}/uncfile.txt" args = [ oldfont_path, "--retain-gids", f"--output-file={newfont_path}", "--layout-features=*", "--passthrough-tables", "--ignore-missing-glyphs", "--ignore-missing-unicodes", "--symbol-cmap", ] # store glyph ids or unicodes as file with io.open(f"{tmp_dir}/uncfile.txt", "w", encoding='utf8') as unc_file: if 0xFFFD in unc_set: # error unicode exists -> use glyphs args.append(f"--gids-file={uncfile_path}") gid_set.add(189) unc_list = list(gid_set) for unc in unc_list: unc_file.write(f"{unc}\n") else: args.append(f"--unicodes-file={uncfile_path}") unc_set.add(255) unc_list = list(unc_set) for unc in unc_list: unc_file.write(f"{unc:04x}\n") # store fontbuffer as a file with io.open(oldfont_path, "wb") as fontfile: fontfile.write(buffer) try: os.remove(newfont_path) # remove old file except Exception: pass try: # invoke fontTools subsetter fts.main(args) font = Font(fontfile=newfont_path) new_buffer = font.buffer # subset font binary if font.glyph_count == 0: # intercept empty font new_buffer = None except Exception: exception_info() new_buffer = None return new_buffer def repl_fontnames(doc): """Populate 'font_buffers'. For each font candidate, store its xref and the list of names by which PDF text may refer to it (there may be multiple). """ def norm_name(name): """Recreate font name that contains PDF hex codes. E.g. #20 -> space, chr(32) """ while "#" in name: p = name.find("#") c = int(name[p + 1 : p + 3], 16) name = name.replace(name[p : p + 3], chr(c)) return name def get_fontnames(doc, item): """Return a list of fontnames for an item of page.get_fonts(). There may be multiple names e.g. for Type0 fonts. """ fontname = item[3] names = [fontname] fontname = doc.xref_get_key(item[0], "BaseFont")[1][1:] fontname = norm_name(fontname) if fontname not in names: names.append(fontname) descendents = doc.xref_get_key(item[0], "DescendantFonts") if descendents[0] != "array": return names descendents = descendents[1][1:-1] if descendents.endswith(" 0 R"): xref = int(descendents[:-4]) descendents = doc.xref_object(xref, compressed=True) p1 = descendents.find("/BaseFont") if p1 >= 0: p2 = descendents.find("/", p1 + 1) p1 = min(descendents.find("/", p2 + 1), descendents.find(">>", p2 + 1)) fontname = descendents[p2 + 1 : p1] fontname = norm_name(fontname) if fontname not in names: names.append(fontname) return names for i in range(doc.page_count): for f in doc.get_page_fonts(i, full=True): font_xref = f[0] # font xref font_ext = f[1] # font file extension basename = f[3] # font basename if font_ext not in ( # skip if not supported by fontTools "otf", "ttf", "woff", "woff2", ): continue # skip fonts which already are subsets if len(basename) > 6 and basename[6] == "+": continue extr = doc.extract_font(font_xref) fontbuffer = extr[-1] names = get_fontnames(doc, f) name_set, xref_set, subsets = font_buffers.get( fontbuffer, (set(), set(), (set(), set())) ) xref_set.add(font_xref) for name in names: name_set.add(name) font = Font(fontbuffer=fontbuffer) name_set.add(font.name) del font font_buffers[fontbuffer] = (name_set, xref_set, subsets) def find_buffer_by_name(name): for buffer, (name_set, _, _) in font_buffers.items(): if name in name_set: return buffer return None # ----------------- # main function # ----------------- repl_fontnames(doc) # populate font information if not font_buffers: # nothing found to do if verbose: message(f'No fonts to subset.') return 0 old_fontsize = 0 new_fontsize = 0 for fontbuffer in font_buffers.keys(): old_fontsize += len(fontbuffer) # Scan page text for usage of subsettable fonts for page in doc: # go through the text and extend set of used glyphs by font # we use a modified MuPDF trace device, which delivers us glyph ids. for span in page.get_texttrace(): if type(span) is not dict: # skip useless information continue fontname = span["font"][:33] # fontname for the span buffer = find_buffer_by_name(fontname) if buffer is None: continue name_set, xref_set, (set_ucs, set_gid) = font_buffers[buffer] for c in span["chars"]: set_ucs.add(c[0]) # unicode set_gid.add(c[1]) # glyph id font_buffers[buffer] = (name_set, xref_set, (set_ucs, set_gid)) # build the font subsets for old_buffer, (name_set, xref_set, subsets) in font_buffers.items(): new_buffer = build_subset(old_buffer, subsets[0], subsets[1]) fontname = list(name_set)[0] if new_buffer is None or len(new_buffer) >= len(old_buffer): # subset was not created or did not get smaller if verbose: message(f'Cannot subset {fontname!r}.') continue if verbose: message(f"Built subset of font {fontname!r}.") val = doc._insert_font(fontbuffer=new_buffer) # store subset font in PDF new_xref = val[0] # get its xref set_subset_fontname(new_xref) # tag fontname as subset font font_str = doc.xref_object( # get its object definition new_xref, compressed=True, ) # walk through the original font xrefs and replace each by the subset def for font_xref in xref_set: # we need the original '/W' and '/DW' width values width_table, def_width = get_old_widths(font_xref) # ... and replace original font definition at xref with it doc.update_object(font_xref, font_str) # now copy over old '/W' and '/DW' values if width_table or def_width: set_old_widths(font_xref, width_table, def_width) # 'new_xref' remains unused in the PDF and must be removed # by garbage collection. new_fontsize += len(new_buffer) return old_fontsize - new_fontsize def switch_layer(self, config, as_default=0): """Activate an OC layer.""" pdf = _as_pdf_document(self) cfgs = mupdf.pdf_dict_getl( mupdf.pdf_trailer( pdf), PDF_NAME('Root'), PDF_NAME('OCProperties'), PDF_NAME('Configs') ) if not mupdf.pdf_is_array( cfgs) or not mupdf.pdf_array_len( cfgs): if config < 1: return raise ValueError( MSG_BAD_OC_LAYER) if config < 0: return mupdf.pdf_select_layer_config( pdf, config) if as_default: mupdf.pdf_set_layer_config_as_default( pdf) mupdf.ll_pdf_read_ocg( pdf.m_internal) def update_object(self, xref, text, page=None): """Replace object definition source.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len(pdf) if not _INRANGE(xref, 1, xreflen-1): RAISEPY("bad xref", MSG_BAD_XREF) ENSURE_OPERATION(pdf) # create new object with passed-in string new_obj = JM_pdf_obj_from_str(pdf, text) mupdf.pdf_update_object(pdf, xref, new_obj) if page: JM_refresh_links( _as_pdf_page(page)) def update_stream(self, xref=0, stream=None, new=1, compress=1): """Replace xref stream part.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len(pdf) if xref < 1 or xref > xreflen: raise ValueError( MSG_BAD_XREF) # get the object obj = mupdf.pdf_new_indirect(pdf, xref, 0) if not mupdf.pdf_is_dict(obj): raise ValueError( MSG_IS_NO_DICT) res = JM_BufferFromBytes(stream) if not res.m_internal: raise TypeError( MSG_BAD_BUFFER) JM_update_stream(pdf, obj, res, compress) pdf.dirty = 1 @property def version_count(self): ''' Count versions of PDF document. ''' pdf = _as_pdf_document(self, required=0) if pdf.m_internal: return mupdf.pdf_count_versions(pdf) return 0 def write( self, garbage=False, clean=False, deflate=False, deflate_images=False, deflate_fonts=False, incremental=False, ascii=False, expand=False, linear=False, no_new_id=False, appearance=False, pretty=False, encryption=1, permissions=4095, owner_pw=None, user_pw=None, preserve_metadata=1, use_objstms=0, compression_effort=0, raise_on_repair=False, ): from io import BytesIO bio = BytesIO() self.save( bio, garbage=garbage, clean=clean, no_new_id=no_new_id, appearance=appearance, deflate=deflate, deflate_images=deflate_images, deflate_fonts=deflate_fonts, incremental=incremental, ascii=ascii, expand=expand, linear=linear, pretty=pretty, encryption=encryption, permissions=permissions, owner_pw=owner_pw, user_pw=user_pw, preserve_metadata=preserve_metadata, use_objstms=use_objstms, compression_effort=compression_effort, raise_on_repair=raise_on_repair, ) return bio.getvalue() def tobytes(self, *args, **kwargs): return self.write(*args, **kwargs) @property def xref(self): """PDF xref number of page.""" CheckParent(self) return self.parent.page_xref(self.number) def xref_copy(doc: 'Document', source: int, target: int, *, keep: list = None) -> None: """Copy a PDF dictionary object to another one given their xref numbers. Args: doc: PDF document object source: source xref number target: target xref number, the xref must already exist keep: an optional list of 1st level keys in target that should not be removed before copying. Notes: This works similar to the copy() method of dictionaries in Python. The source may be a stream object. """ if doc.xref_is_stream(source): # read new xref stream, maintaining compression stream = doc.xref_stream_raw(source) doc.update_stream( target, stream, compress=False, # keeps source compression new=True, # in case target is no stream ) # empty the target completely, observe exceptions if keep is None: keep = [] for key in doc.xref_get_keys(target): if key in keep: continue doc.xref_set_key(target, key, "null") # copy over all source dict items for key in doc.xref_get_keys(source): item = doc.xref_get_key(source, key) doc.xref_set_key(target, key, item[1]) def xref_get_key(self, xref, key): """Get PDF dict key value of object at 'xref'.""" pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len(pdf) if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref > 0: obj = mupdf.pdf_load_object(pdf, xref) else: obj = mupdf.pdf_trailer(pdf) if not obj.m_internal: return ("null", "null") subobj = mupdf.pdf_dict_getp(obj, key) if not subobj.m_internal: return ("null", "null") text = None if mupdf.pdf_is_indirect(subobj): type = "xref" text = f"{mupdf.pdf_to_num(subobj):d} 0 R" elif mupdf.pdf_is_array(subobj): type = "array" elif mupdf.pdf_is_dict(subobj): type = "dict" elif mupdf.pdf_is_int(subobj): type = "int" text = f"{mupdf.pdf_to_int(subobj):d}" elif mupdf.pdf_is_real(subobj): type = "float" elif mupdf.pdf_is_null(subobj): type = "null" text = "null" elif mupdf.pdf_is_bool(subobj): type = "bool" if mupdf.pdf_to_bool(subobj): text = "true" else: text = "false" elif mupdf.pdf_is_name(subobj): type = "name" text = f"/{mupdf.pdf_to_name(subobj)}" elif mupdf.pdf_is_string(subobj): type = "string" text = JM_UnicodeFromStr(mupdf.pdf_to_text_string(subobj)) else: type = "unknown" if text is None: res = JM_object_to_buffer(subobj, 1, 0) text = JM_UnicodeFromBuffer(res) return (type, text) def xref_get_keys(self, xref): """Get the keys of PDF dict object at 'xref'. Use -1 for the PDF trailer.""" pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len( pdf) if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref > 0: obj = mupdf.pdf_load_object( pdf, xref) else: obj = mupdf.pdf_trailer( pdf) n = mupdf.pdf_dict_len( obj) rc = [] if n == 0: return rc for i in range(n): key = mupdf.pdf_to_name( mupdf.pdf_dict_get_key( obj, i)) rc.append(key) return rc def xref_is_font(self, xref): """Check if xref is a font object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Type")[1] == "/Font": return True return False def xref_is_image(self, xref): """Check if xref is an image object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Subtype")[1] == "/Image": return True return False def xref_is_stream(self, xref=0): """Check if xref is a stream object.""" pdf = _as_pdf_document(self, required=0) if not pdf.m_internal: return False # not a PDF return bool(mupdf.pdf_obj_num_is_stream(pdf, xref)) def xref_is_xobject(self, xref): """Check if xref is a form xobject.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Subtype")[1] == "/Form": return True return False def xref_length(self): """Get length of xref table.""" xreflen = 0 pdf = _as_pdf_document(self, required=0) if pdf.m_internal: xreflen = mupdf.pdf_xref_len(pdf) return xreflen def xref_object(self, xref, compressed=0, ascii=0): """Get xref object source as a string.""" if self.is_closed: raise ValueError("document closed") if g_use_extra: ret = extra.xref_object( self.this, xref, compressed, ascii) return ret pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len(pdf) if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref > 0: obj = mupdf.pdf_load_object(pdf, xref) else: obj = mupdf.pdf_trailer(pdf) res = JM_object_to_buffer(mupdf.pdf_resolve_indirect(obj), compressed, ascii) text = JM_EscapeStrFromBuffer(res) return text def xref_set_key(self, xref, key, value): """Set the value of a PDF dictionary key.""" if self.is_closed: raise ValueError("document closed") if not key or not isinstance(key, str) or INVALID_NAME_CHARS.intersection(key) not in (set(), {"/"}): raise ValueError("bad 'key'") if not isinstance(value, str) or not value or value[0] == "/" and INVALID_NAME_CHARS.intersection(value[1:]) != set(): raise ValueError("bad 'value'") pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len(pdf) #if not _INRANGE(xref, 1, xreflen-1) and xref != -1: # THROWMSG("bad xref") #if len(value) == 0: # THROWMSG("bad 'value'") #if len(key) == 0: # THROWMSG("bad 'key'") if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref != -1: obj = mupdf.pdf_load_object(pdf, xref) else: obj = mupdf.pdf_trailer(pdf) new_obj = JM_set_object_value(obj, key, value) if not new_obj.m_internal: return # did not work: skip update if xref != -1: mupdf.pdf_update_object(pdf, xref, new_obj) else: n = mupdf.pdf_dict_len(new_obj) for i in range(n): mupdf.pdf_dict_put( obj, mupdf.pdf_dict_get_key(new_obj, i), mupdf.pdf_dict_get_val(new_obj, i), ) def xref_stream(self, xref): """Get decompressed xref stream.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len( pdf) if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref >= 0: obj = mupdf.pdf_new_indirect( pdf, xref, 0) else: obj = mupdf.pdf_trailer( pdf) r = None if mupdf.pdf_is_stream( obj): res = mupdf.pdf_load_stream_number( pdf, xref) r = JM_BinFromBuffer( res) return r def xref_stream_raw(self, xref): """Get xref stream without decompression.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") pdf = _as_pdf_document(self) xreflen = mupdf.pdf_xref_len( pdf) if not _INRANGE(xref, 1, xreflen-1) and xref != -1: raise ValueError( MSG_BAD_XREF) if xref >= 0: obj = mupdf.pdf_new_indirect( pdf, xref, 0) else: obj = mupdf.pdf_trailer( pdf) r = None if mupdf.pdf_is_stream( obj): res = mupdf.pdf_load_raw_stream_number( pdf, xref) r = JM_BinFromBuffer( res) return r def xref_xml_metadata(self): """Get xref of document XML metadata.""" pdf = _as_pdf_document(self) root = mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')) if not root.m_internal: RAISEPY( MSG_BAD_PDFROOT, JM_Exc_FileDataError) xml = mupdf.pdf_dict_get( root, PDF_NAME('Metadata')) xref = 0 if xml.m_internal: xref = mupdf.pdf_to_num( xml) return xref __slots__ = ('this', 'page_count2', 'this_is_pdf', '__dict__') outline = property(lambda self: self._outline) is_stream = xref_is_stream open = Document class DocumentWriter: def __enter__(self): return self def __exit__(self, *args): self.close() def __init__(self, path, options=''): if isinstance( path, str): pass elif hasattr( path, 'absolute'): path = str( path) elif hasattr( path, 'name'): path = path.name if isinstance( path, str): self.this = mupdf.FzDocumentWriter( path, options, mupdf.FzDocumentWriter.PathType_PDF) else: # Need to keep the Python JM_new_output_fileptr_Output instance # alive for the lifetime of this DocumentWriter, otherwise calls # to virtual methods implemented in Python fail. So we make it a # member of this DocumentWriter. # # Unrelated to this, mupdf.FzDocumentWriter will set # self._out.m_internal to null because ownership is passed in. # out = JM_new_output_fileptr( path) self.this = mupdf.FzDocumentWriter( out, options, mupdf.FzDocumentWriter.OutputType_PDF) assert out.m_internal_value() == 0 assert hasattr( self.this, '_out') def begin_page( self, mediabox): mediabox2 = JM_rect_from_py(mediabox) device = mupdf.fz_begin_page( self.this, mediabox2) device_wrapper = DeviceWrapper( device) return device_wrapper def close( self): mupdf.fz_close_document_writer( self.this) def end_page( self): mupdf.fz_end_page( self.this) class Font: def __del__(self): if type(self) is not Font: return None def __init__( self, fontname=None, fontfile=None, fontbuffer=None, script=0, language=None, ordering=-1, is_bold=0, is_italic=0, is_serif=0, embed=1, ): if fontbuffer: if hasattr(fontbuffer, "getvalue"): fontbuffer = fontbuffer.getvalue() elif isinstance(fontbuffer, bytearray): fontbuffer = bytes(fontbuffer) if not isinstance(fontbuffer, bytes): raise ValueError("bad type: 'fontbuffer'") if isinstance(fontname, str): fname_lower = fontname.lower() if "/" in fname_lower or "\\" in fname_lower or "." in fname_lower: message("Warning: did you mean a fontfile?") if fname_lower in ("cjk", "china-t", "china-ts"): ordering = 0 elif fname_lower.startswith("china-s"): ordering = 1 elif fname_lower.startswith("korea"): ordering = 3 elif fname_lower.startswith("japan"): ordering = 2 elif fname_lower in fitz_fontdescriptors.keys(): import pymupdf_fonts # optional fonts fontbuffer = pymupdf_fonts.myfont(fname_lower) # make a copy fontname = None # ensure using fontbuffer only del pymupdf_fonts # remove package again elif ordering < 0: fontname = Base14_fontdict.get(fontname, fontname) lang = mupdf.fz_text_language_from_string(language) font = JM_get_font(fontname, fontfile, fontbuffer, script, lang, ordering, is_bold, is_italic, is_serif, embed) self.this = font def __repr__(self): return f"Font('{self.name}')" @property def ascender(self): """Return the glyph ascender value.""" return mupdf.fz_font_ascender(self.this) @property def bbox(self): return self.this.fz_font_bbox() @property def buffer(self): buffer_ = mupdf.FzBuffer( mupdf.ll_fz_keep_buffer( self.this.m_internal.buffer)) return mupdf.fz_buffer_extract_copy( buffer_) def char_lengths(self, text, fontsize=11, language=None, script=0, wmode=0, small_caps=0): """Return tuple of char lengths of unicode 'text' under a fontsize.""" lang = mupdf.fz_text_language_from_string(language) rc = [] for ch in text: c = ord(ch) if small_caps: gid = mupdf.fz_encode_character_sc(self.this, c) if gid >= 0: font = self.this else: gid, font = mupdf.fz_encode_character_with_fallback(self.this, c, script, lang) rc.append(fontsize * mupdf.fz_advance_glyph(font, gid, wmode)) return rc @property def descender(self): """Return the glyph descender value.""" return mupdf.fz_font_descender(self.this) @property def flags(self): f = mupdf.ll_fz_font_flags(self.this.m_internal) if not f: return assert isinstance( f, mupdf.fz_font_flags_t) #log(f'{f=}') if mupdf_cppyy: # cppyy includes remaining higher bits. v = [f.is_mono] def b(bits): ret = v[0] & ((1 << bits)-1) v[0] = v[0] >> bits return ret is_mono = b(1) is_serif = b(1) is_bold = b(1) is_italic = b(1) ft_substitute = b(1) ft_stretch = b(1) fake_bold = b(1) fake_italic = b(1) has_opentype = b(1) invalid_bbox = b(1) cjk_lang = b(1) embed = b(1) never_embed = b(1) return { "mono": is_mono if mupdf_cppyy else f.is_mono, "serif": is_serif if mupdf_cppyy else f.is_serif, "bold": is_bold if mupdf_cppyy else f.is_bold, "italic": is_italic if mupdf_cppyy else f.is_italic, "substitute": ft_substitute if mupdf_cppyy else f.ft_substitute, "stretch": ft_stretch if mupdf_cppyy else f.ft_stretch, "fake-bold": fake_bold if mupdf_cppyy else f.fake_bold, "fake-italic": fake_italic if mupdf_cppyy else f.fake_italic, "opentype": has_opentype if mupdf_cppyy else f.has_opentype, "invalid-bbox": invalid_bbox if mupdf_cppyy else f.invalid_bbox, 'cjk': cjk_lang if mupdf_cppyy else f.cjk, 'cjk-lang': cjk_lang if mupdf_cppyy else f.cjk_lang, 'embed': embed if mupdf_cppyy else f.embed, 'never-embed': never_embed if mupdf_cppyy else f.never_embed, } def glyph_advance(self, chr_, language=None, script=0, wmode=0, small_caps=0): """Return the glyph width of a unicode (font size 1).""" lang = mupdf.fz_text_language_from_string(language) if small_caps: gid = mupdf.fz_encode_character_sc(self.this, chr_) if gid >= 0: font = self.this else: gid, font = mupdf.fz_encode_character_with_fallback(self.this, chr_, script, lang) return mupdf.fz_advance_glyph(font, gid, wmode) def glyph_bbox(self, char, language=None, script=0, small_caps=0): """Return the glyph bbox of a unicode (font size 1).""" lang = mupdf.fz_text_language_from_string(language) if small_caps: gid = mupdf.fz_encode_character_sc( self.this, char) if gid >= 0: font = self.this else: gid, font = mupdf.fz_encode_character_with_fallback( self.this, char, script, lang) return Rect(mupdf.fz_bound_glyph( font, gid, mupdf.FzMatrix())) @property def glyph_count(self): return self.this.m_internal.glyph_count def glyph_name_to_unicode(self, name): """Return the unicode for a glyph name.""" return glyph_name_to_unicode(name) def has_glyph(self, chr, language=None, script=0, fallback=0, small_caps=0): """Check whether font has a glyph for this unicode.""" if fallback: lang = mupdf.fz_text_language_from_string(language) gid, font = mupdf.fz_encode_character_with_fallback(self.this, chr, script, lang) else: if small_caps: gid = mupdf.fz_encode_character_sc(self.this, chr) else: gid = mupdf.fz_encode_character(self.this, chr) return gid @property def is_bold(self): return mupdf.fz_font_is_bold( self.this) @property def is_italic(self): return mupdf.fz_font_is_italic( self.this) @property def is_monospaced(self): return mupdf.fz_font_is_monospaced( self.this) @property def is_serif(self): return mupdf.fz_font_is_serif( self.this) @property def is_writable(self): return True # see pymupdf commit ef4056ee4da2 font = self.this flags = mupdf.ll_fz_font_flags(font.m_internal) if mupdf_cppyy: # cppyy doesn't handle bitfields correctly. import cppyy ft_substitute = cppyy.gbl.mupdf_mfz_font_flags_ft_substitute( flags) else: ft_substitute = flags.ft_substitute if ( mupdf.ll_fz_font_t3_procs(font.m_internal) or ft_substitute or not mupdf.pdf_font_writing_supported(font) ): return False return True @property def name(self): ret = mupdf.fz_font_name(self.this) #log(f'{ret=}') return ret def text_length(self, text, fontsize=11, language=None, script=0, wmode=0, small_caps=0): """Return length of unicode 'text' under a fontsize.""" thisfont = self.this lang = mupdf.fz_text_language_from_string(language) rc = 0 if not isinstance(text, str): raise TypeError( MSG_BAD_TEXT) for ch in text: c = ord(ch) if small_caps: gid = mupdf.fz_encode_character_sc(thisfont, c) if gid >= 0: font = thisfont else: gid, font = mupdf.fz_encode_character_with_fallback(thisfont, c, script, lang) rc += mupdf.fz_advance_glyph(font, gid, wmode) rc *= fontsize return rc def unicode_to_glyph_name(self, ch): """Return the glyph name for a unicode.""" return unicode_to_glyph_name(ch) def valid_codepoints(self): ''' Returns sorted list of valid unicodes of a fz_font. ''' ucs_gids = mupdf.fz_enumerate_font_cmap2(self.this) ucss = [i.ucs for i in ucs_gids] ucss_unique = set(ucss) ucss_unique_sorted = sorted(ucss_unique) return ucss_unique_sorted class Graftmap: def __del__(self): if not type(self) is Graftmap: return self.thisown = False def __init__(self, doc): dst = _as_pdf_document(doc) map_ = mupdf.pdf_new_graft_map(dst) self.this = map_ self.thisown = True class Link: def __del__(self): self._erase() def __init__( self, this): assert isinstance( this, mupdf.FzLink) self.this = this def __repr__(self): CheckParent(self) return "link on " + str(self.parent) def __str__(self): CheckParent(self) return "link on " + str(self.parent) def _border(self, doc, xref): pdf = _as_pdf_document(doc, required=0) if not pdf.m_internal: return link_obj = mupdf.pdf_new_indirect(pdf, xref, 0) if not link_obj.m_internal: return b = JM_annot_border(link_obj) return b def _colors(self, doc, xref): pdf = _as_pdf_document(doc, required=0) if not pdf.m_internal: return link_obj = mupdf.pdf_new_indirect( pdf, xref, 0) if not link_obj.m_internal: raise ValueError( MSG_BAD_XREF) b = JM_annot_colors( link_obj) return b def _erase(self): self.parent = None self.thisown = False def _setBorder(self, border, doc, xref): pdf = _as_pdf_document(doc, required=0) if not pdf.m_internal: return link_obj = mupdf.pdf_new_indirect(pdf, xref, 0) if not link_obj.m_internal: return b = JM_annot_set_border(border, pdf, link_obj) return b @property def border(self): return self._border(self.parent.parent.this, self.xref) @property def colors(self): return self._colors(self.parent.parent.this, self.xref) @property def dest(self): """Create link destination details.""" if hasattr(self, "parent") and self.parent is None: raise ValueError("orphaned object: parent is None") if self.parent.parent.is_closed or self.parent.parent.is_encrypted: raise ValueError("document closed or encrypted") doc = self.parent.parent if self.is_external or self.uri.startswith("#"): uri = None else: uri = doc.resolve_link(self.uri) return linkDest(self, uri, doc) @property def flags(self)->int: CheckParent(self) doc = self.parent.parent if not doc.is_pdf: return 0 f = doc.xref_get_key(self.xref, "F") if f[1] != "null": return int(f[1]) return 0 @property def is_external(self): """Flag the link as external.""" CheckParent(self) if g_use_extra: return extra.Link_is_external( self.this) this_link = self.this if not this_link.m_internal or not this_link.m_internal.uri: return False return bool( mupdf.fz_is_external_link( this_link.m_internal.uri)) @property def next(self): """Next link.""" if not self.this.m_internal: return None CheckParent(self) if 0 and g_use_extra: val = extra.Link_next( self.this) else: val = self.this.next() if not val.m_internal: return None val = Link( val) if val: val.thisown = True val.parent = self.parent # copy owning page from prev link val.parent._annot_refs[id(val)] = val if self.xref > 0: # prev link has an xref link_xrefs = [x[0] for x in self.parent.annot_xrefs() if x[1] == mupdf.PDF_ANNOT_LINK] link_ids = [x[2] for x in self.parent.annot_xrefs() if x[1] == mupdf.PDF_ANNOT_LINK] idx = link_xrefs.index(self.xref) val.xref = link_xrefs[idx + 1] val.id = link_ids[idx + 1] else: val.xref = 0 val.id = "" return val @property def rect(self): """Rectangle ('hot area').""" CheckParent(self) # utils.py:getLinkDict() appears to expect exceptions from us, so we # ensure that we raise on error. if self.this is None or not self.this.m_internal: raise Exception( 'self.this.m_internal not available') val = JM_py_from_rect( self.this.rect()) val = Rect(val) return val def set_border(self, border=None, width=0, dashes=None, style=None): if type(border) is not dict: border = {"width": width, "style": style, "dashes": dashes} return self._setBorder(border, self.parent.parent.this, self.xref) def set_colors(self, colors=None, stroke=None, fill=None): """Set border colors.""" CheckParent(self) doc = self.parent.parent if type(colors) is not dict: colors = {"fill": fill, "stroke": stroke} fill = colors.get("fill") stroke = colors.get("stroke") if fill is not None: message("warning: links have no fill color") if stroke in ([], ()): doc.xref_set_key(self.xref, "C", "[]") return if hasattr(stroke, "__float__"): stroke = [float(stroke)] CheckColor(stroke) assert len(stroke) in (1, 3, 4) s = f"[{_format_g(stroke)}]" doc.xref_set_key(self.xref, "C", s) def set_flags(self, flags): CheckParent(self) doc = self.parent.parent if not doc.is_pdf: raise ValueError("is no PDF") if not type(flags) is int: raise ValueError("bad 'flags' value") doc.xref_set_key(self.xref, "F", str(flags)) return None @property def uri(self): """Uri string.""" #CheckParent(self) if g_use_extra: return extra.link_uri(self.this) this_link = self.this return this_link.m_internal.uri if this_link.m_internal else '' page = -1 class Matrix: def __abs__(self): return math.sqrt(sum([c*c for c in self])) def __add__(self, m): if hasattr(m, "__float__"): return Matrix(self.a + m, self.b + m, self.c + m, self.d + m, self.e + m, self.f + m) if len(m) != 6: raise ValueError("Matrix: bad seq len") return Matrix(self.a + m[0], self.b + m[1], self.c + m[2], self.d + m[3], self.e + m[4], self.f + m[5]) def __bool__(self): return not (max(self) == min(self) == 0) def __eq__(self, mat): if not hasattr(mat, "__len__"): return False return len(mat) == 6 and not (self - mat) def __getitem__(self, i): return (self.a, self.b, self.c, self.d, self.e, self.f)[i] def __init__(self, *args, a=None, b=None, c=None, d=None, e=None, f=None): """ Matrix() - all zeros Matrix(a, b, c, d, e, f) Matrix(zoom-x, zoom-y) - zoom Matrix(shear-x, shear-y, 1) - shear Matrix(degree) - rotate Matrix(Matrix) - new copy Matrix(sequence) - from 'sequence' Matrix(mupdf.FzMatrix) - from MuPDF class wrapper for fz_matrix. Explicit keyword args a, b, c, d, e, f override any earlier settings if not None. """ if not args: self.a = self.b = self.c = self.d = self.e = self.f = 0.0 elif len(args) > 6: raise ValueError("Matrix: bad seq len") elif len(args) == 6: # 6 numbers self.a, self.b, self.c, self.d, self.e, self.f = map(float, args) elif len(args) == 1: # either an angle or a sequ if isinstance(args[0], mupdf.FzMatrix): self.a = args[0].a self.b = args[0].b self.c = args[0].c self.d = args[0].d self.e = args[0].e self.f = args[0].f elif hasattr(args[0], "__float__"): theta = math.radians(args[0]) c_ = round(math.cos(theta), 8) s_ = round(math.sin(theta), 8) self.a = self.d = c_ self.b = s_ self.c = -s_ self.e = self.f = 0.0 else: self.a, self.b, self.c, self.d, self.e, self.f = map(float, args[0]) elif len(args) == 2 or len(args) == 3 and args[2] == 0: self.a, self.b, self.c, self.d, self.e, self.f = float(args[0]), \ 0.0, 0.0, float(args[1]), 0.0, 0.0 elif len(args) == 3 and args[2] == 1: self.a, self.b, self.c, self.d, self.e, self.f = 1.0, \ float(args[1]), float(args[0]), 1.0, 0.0, 0.0 else: raise ValueError("Matrix: bad args") # Override with explicit args if specified. if a is not None: self.a = a if b is not None: self.b = b if c is not None: self.c = c if d is not None: self.d = d if e is not None: self.e = e if f is not None: self.f = f def __invert__(self): """Calculate inverted matrix.""" m1 = Matrix() m1.invert(self) return m1 def __len__(self): return 6 def __mul__(self, m): if hasattr(m, "__float__"): return Matrix(self.a * m, self.b * m, self.c * m, self.d * m, self.e * m, self.f * m) m1 = Matrix(1,1) return m1.concat(self, m) def __neg__(self): return Matrix(-self.a, -self.b, -self.c, -self.d, -self.e, -self.f) def __nonzero__(self): return not (max(self) == min(self) == 0) def __pos__(self): return Matrix(self) def __repr__(self): return "Matrix" + str(tuple(self)) def __setitem__(self, i, v): v = float(v) if i == 0: self.a = v elif i == 1: self.b = v elif i == 2: self.c = v elif i == 3: self.d = v elif i == 4: self.e = v elif i == 5: self.f = v else: raise IndexError("index out of range") return def __sub__(self, m): if hasattr(m, "__float__"): return Matrix(self.a - m, self.b - m, self.c - m, self.d - m, self.e - m, self.f - m) if len(m) != 6: raise ValueError("Matrix: bad seq len") return Matrix(self.a - m[0], self.b - m[1], self.c - m[2], self.d - m[3], self.e - m[4], self.f - m[5]) def __truediv__(self, m): if hasattr(m, "__float__"): return Matrix(self.a * 1./m, self.b * 1./m, self.c * 1./m, self.d * 1./m, self.e * 1./m, self.f * 1./m) m1 = util_invert_matrix(m)[1] if not m1: raise ZeroDivisionError("matrix not invertible") m2 = Matrix(1,1) return m2.concat(self, m1) def concat(self, one, two): """Multiply two matrices and replace current one.""" if not len(one) == len(two) == 6: raise ValueError("Matrix: bad seq len") self.a, self.b, self.c, self.d, self.e, self.f = util_concat_matrix(one, two) return self def invert(self, src=None): """Calculate the inverted matrix. Return 0 if successful and replace current one. Else return 1 and do nothing. """ if src is None: dst = util_invert_matrix(self) else: dst = util_invert_matrix(src) if dst[0] == 1: return 1 self.a, self.b, self.c, self.d, self.e, self.f = dst[1] return 0 @property def is_rectilinear(self): """True if rectangles are mapped to rectangles.""" return (abs(self.b) < EPSILON and abs(self.c) < EPSILON) or \ (abs(self.a) < EPSILON and abs(self.d) < EPSILON) def prerotate(self, theta): """Calculate pre rotation and replace current matrix.""" theta = float(theta) while theta < 0: theta += 360 while theta >= 360: theta -= 360 if abs(0 - theta) < EPSILON: pass elif abs(90.0 - theta) < EPSILON: a = self.a b = self.b self.a = self.c self.b = self.d self.c = -a self.d = -b elif abs(180.0 - theta) < EPSILON: self.a = -self.a self.b = -self.b self.c = -self.c self.d = -self.d elif abs(270.0 - theta) < EPSILON: a = self.a b = self.b self.a = -self.c self.b = -self.d self.c = a self.d = b else: rad = math.radians(theta) s = math.sin(rad) c = math.cos(rad) a = self.a b = self.b self.a = c * a + s * self.c self.b = c * b + s * self.d self.c =-s * a + c * self.c self.d =-s * b + c * self.d return self def prescale(self, sx, sy): """Calculate pre scaling and replace current matrix.""" sx = float(sx) sy = float(sy) self.a *= sx self.b *= sx self.c *= sy self.d *= sy return self def preshear(self, h, v): """Calculate pre shearing and replace current matrix.""" h = float(h) v = float(v) a, b = self.a, self.b self.a += v * self.c self.b += v * self.d self.c += h * a self.d += h * b return self def pretranslate(self, tx, ty): """Calculate pre translation and replace current matrix.""" tx = float(tx) ty = float(ty) self.e += tx * self.a + ty * self.c self.f += tx * self.b + ty * self.d return self __inv__ = __invert__ __div__ = __truediv__ norm = __abs__ class IdentityMatrix(Matrix): """Identity matrix [1, 0, 0, 1, 0, 0]""" def __hash__(self): return hash((1,0,0,1,0,0)) def __init__(self): Matrix.__init__(self, 1.0, 1.0) def __repr__(self): return "IdentityMatrix(1.0, 0.0, 0.0, 1.0, 0.0, 0.0)" def __setattr__(self, name, value): if name in "ad": self.__dict__[name] = 1.0 elif name in "bcef": self.__dict__[name] = 0.0 else: self.__dict__[name] = value def checkargs(*args): raise NotImplementedError("Identity is readonly") Identity = IdentityMatrix() class linkDest: """link or outline destination details""" def __init__(self, obj, rlink, document=None): isExt = obj.is_external isInt = not isExt self.dest = "" self.file_spec = "" self.flags = 0 self.is_map = False self.is_uri = False self.kind = LINK_NONE self.lt = Point(0, 0) self.named = dict() self.new_window = "" self.page = obj.page self.rb = Point(0, 0) self.uri = obj.uri def uri_to_dict(uri): items = self.uri[1:].split('&') ret = dict() for item in items: eq = item.find('=') if eq >= 0: ret[item[:eq]] = item[eq+1:] else: ret[item] = None return ret def unescape(name): """Unescape '%AB' substrings to chr(0xAB).""" split = name.replace("%%", "%25") # take care of escaped '%' split = split.split("%") newname = split[0] for item in split[1:]: piece = item[:2] newname += chr(int(piece, base=16)) newname += item[2:] return newname if rlink and not self.uri.startswith("#"): self.uri = f"#page={rlink[0] + 1}&zoom=0,{_format_g(rlink[1])},{_format_g(rlink[2])}" if obj.is_external: self.page = -1 self.kind = LINK_URI if not self.uri: self.page = -1 self.kind = LINK_NONE if isInt and self.uri: self.uri = self.uri.replace("&zoom=nan", "&zoom=0") if self.uri.startswith("#"): self.kind = LINK_GOTO m = re.match('^#page=([0-9]+)&zoom=([0-9.]+),(-?[0-9.]+),(-?[0-9.]+)$', self.uri) if m: self.page = int(m.group(1)) - 1 self.lt = Point(float((m.group(3))), float(m.group(4))) self.flags = self.flags | LINK_FLAG_L_VALID | LINK_FLAG_T_VALID else: m = re.match('^#page=([0-9]+)$', self.uri) if m: self.page = int(m.group(1)) - 1 else: self.kind = LINK_NAMED m = re.match('^#nameddest=(.*)', self.uri) assert document if document and m: named = unescape(m.group(1)) self.named = document.resolve_names().get(named) if self.named is None: # document.resolve_names() does not contain an # entry for `named` so use an empty dict. self.named = dict() self.named['nameddest'] = named else: self.named = uri_to_dict(self.uri[1:]) else: self.kind = LINK_NAMED self.named = uri_to_dict(self.uri) if obj.is_external: if not self.uri: pass elif self.uri.startswith("file:"): self.file_spec = self.uri[5:] if self.file_spec.startswith("//"): self.file_spec = self.file_spec[2:] self.is_uri = False self.uri = "" self.kind = LINK_LAUNCH ftab = self.file_spec.split("#") if len(ftab) == 2: if ftab[1].startswith("page="): self.kind = LINK_GOTOR self.file_spec = ftab[0] self.page = int(ftab[1].split("&")[0][5:]) - 1 elif ":" in self.uri: self.is_uri = True self.kind = LINK_URI else: self.is_uri = True self.kind = LINK_LAUNCH assert isinstance(self.named, dict) class Widget: ''' Class describing a PDF form field ("widget") ''' def __init__(self): self.border_color = None self.border_style = "S" self.border_width = 0 self.border_dashes = None self.choice_values = None # choice fields only self.rb_parent = None # radio buttons only: xref of owning parent self.field_name = None # field name self.field_label = None # field label self.field_value = None self.field_flags = 0 self.field_display = 0 self.field_type = 0 # valid range 1 through 7 self.field_type_string = None # field type as string self.fill_color = None self.button_caption = None # button caption self.is_signed = None # True / False if signature self.text_color = (0, 0, 0) self.text_font = "Helv" self.text_fontsize = 0 self.text_maxlen = 0 # text fields only self.text_format = 0 # text fields only self._text_da = "" # /DA = default appearance self.script = None # JavaScript (/A) self.script_stroke = None # JavaScript (/AA/K) self.script_format = None # JavaScript (/AA/F) self.script_change = None # JavaScript (/AA/V) self.script_calc = None # JavaScript (/AA/C) self.script_blur = None # JavaScript (/AA/Bl) self.script_focus = None # JavaScript (/AA/Fo) codespell:ignore self.rect = None # annot value self.xref = 0 # annot value def __repr__(self): return f'Widget:(field_type={self.field_type_string} script={self.script})' def _adjust_font(self): """Ensure text_font is from our list and correctly spelled. """ if not self.text_font: self.text_font = "Helv" return valid_fonts = ("Cour", "TiRo", "Helv", "ZaDb") for f in valid_fonts: if self.text_font.lower() == f.lower(): self.text_font = f return self.text_font = "Helv" return def _checker(self): """Any widget type checks. """ if self.field_type not in range(1, 8): raise ValueError("bad field type") # if setting a radio button to ON, first set Off all buttons # in the group - this is not done by MuPDF: if self.field_type == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON and self.field_value not in (False, "Off") and hasattr(self, "parent"): # so we are about setting this button to ON/True # check other buttons in same group and set them to 'Off' doc = self.parent.parent kids_type, kids_value = doc.xref_get_key(self.xref, "Parent/Kids") if kids_type == "array": xrefs = tuple(map(int, kids_value[1:-1].replace("0 R","").split())) for xref in xrefs: if xref != self.xref: doc.xref_set_key(xref, "AS", "/Off") # the calling method will now set the intended button to on and # will find everything prepared for correct functioning. def _parse_da(self): """Extract font name, size and color from default appearance string (/DA object). Equivalent to 'pdf_parse_default_appearance' function in MuPDF's 'pdf-annot.c'. """ if not self._text_da: return font = "Helv" fsize = 0 col = (0, 0, 0) dat = self._text_da.split() # split on any whitespace for i, item in enumerate(dat): if item == "Tf": font = dat[i - 2][1:] fsize = float(dat[i - 1]) dat[i] = dat[i-1] = dat[i-2] = "" continue if item == "g": # unicolor text col = [(float(dat[i - 1]))] dat[i] = dat[i-1] = "" continue if item == "rg": # RGB colored text col = [float(f) for f in dat[i - 3:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = "" continue self.text_font = font self.text_fontsize = fsize self.text_color = col self._text_da = "" return def _validate(self): """Validate the class entries. """ if (self.rect.is_infinite or self.rect.is_empty ): raise ValueError("bad rect") if not self.field_name: raise ValueError("field name missing") if self.field_label == "Unnamed": self.field_label = None CheckColor(self.border_color) CheckColor(self.fill_color) if not self.text_color: self.text_color = (0, 0, 0) CheckColor(self.text_color) if not self.border_width: self.border_width = 0 if not self.text_fontsize: self.text_fontsize = 0 self.border_style = self.border_style.upper()[0:1] # standardize content of JavaScript entries btn_type = self.field_type in ( mupdf.PDF_WIDGET_TYPE_BUTTON, mupdf.PDF_WIDGET_TYPE_CHECKBOX, mupdf.PDF_WIDGET_TYPE_RADIOBUTTON, ) if not self.script: self.script = None elif type(self.script) is not str: raise ValueError("script content must be a string") # buttons cannot have the following script actions if btn_type or not self.script_calc: self.script_calc = None elif type(self.script_calc) is not str: raise ValueError("script_calc content must be a string") if btn_type or not self.script_change: self.script_change = None elif type(self.script_change) is not str: raise ValueError("script_change content must be a string") if btn_type or not self.script_format: self.script_format = None elif type(self.script_format) is not str: raise ValueError("script_format content must be a string") if btn_type or not self.script_stroke: self.script_stroke = None elif type(self.script_stroke) is not str: raise ValueError("script_stroke content must be a string") if btn_type or not self.script_blur: self.script_blur = None elif type(self.script_blur) is not str: raise ValueError("script_blur content must be a string") if btn_type or not self.script_focus: self.script_focus = None elif type(self.script_focus) is not str: raise ValueError("script_focus content must be a string") self._checker() # any field_type specific checks def _sync_flags(self): """Propagate the field flags. If this widget has a "/Parent", set its field flags and that of all its /Kids widgets to the value of the current widget. Only possible for widgets existing in the PDF. Returns True or False. """ if not self.xref: return False # no xref: widget not in the PDF doc = self.parent.parent # the owning document assert doc pdf = _as_pdf_document(doc) # load underlying PDF object pdf_widget = mupdf.pdf_load_object(pdf, self.xref) Parent = mupdf.pdf_dict_get(pdf_widget, PDF_NAME("Parent")) if not Parent.pdf_is_dict(): return False # no /Parent: nothing to do # put the field flags value into the parent field flags: Parent.pdf_dict_put_int(PDF_NAME("Ff"), self.field_flags) # also put that value into all kids of the Parent kids = Parent.pdf_dict_get(PDF_NAME("Kids")) if not kids.pdf_is_array(): message("warning: malformed PDF, Parent has no Kids array") return False # no /Kids: should never happen! for i in range(kids.pdf_array_len()): # walk through all kids # access kid widget, and do some precautionary checks kid = kids.pdf_array_get(i) if not kid.pdf_is_dict(): continue xref = kid.pdf_to_num() # get xref of the kid if xref == self.xref: # skip self widget continue subtype = kid.pdf_dict_get(PDF_NAME("Subtype")) if not subtype.pdf_to_name() == "Widget": continue # put the field flags value into the kid field flags: kid.pdf_dict_put_int(PDF_NAME("Ff"), self.field_flags) return True # all done def button_states(self): """Return the on/off state names for button widgets. A button may have 'normal' or 'pressed down' appearances. While the 'Off' state is usually called like this, the 'On' state is often given a name relating to the functional context. """ if self.field_type not in (2, 5): return None # no button type if hasattr(self, "parent"): # field already exists on page doc = self.parent.parent else: return xref = self.xref states = {"normal": None, "down": None} APN = doc.xref_get_key(xref, "AP/N") if APN[0] == "dict": nstates = [] APN = APN[1][2:-2] apnt = APN.split("/")[1:] for x in apnt: nstates.append(x.split()[0]) states["normal"] = nstates if APN[0] == "xref": nstates = [] nxref = int(APN[1].split(" ")[0]) APN = doc.xref_object(nxref) apnt = APN.split("/")[1:] for x in apnt: nstates.append(x.split()[0]) states["normal"] = nstates APD = doc.xref_get_key(xref, "AP/D") if APD[0] == "dict": dstates = [] APD = APD[1][2:-2] apdt = APD.split("/")[1:] for x in apdt: dstates.append(x.split()[0]) states["down"] = dstates if APD[0] == "xref": dstates = [] dxref = int(APD[1].split(" ")[0]) APD = doc.xref_object(dxref) apdt = APD.split("/")[1:] for x in apdt: dstates.append(x.split()[0]) states["down"] = dstates return states @property def next(self): return self._annot.next def on_state(self): """Return the "On" value for button widgets. This is useful for radio buttons mainly. Checkboxes will always return "Yes". Radio buttons will return the string that is unequal to "Off" as returned by method button_states(). If the radio button is new / being created, it does not yet have an "On" value. In this case, a warning is shown and True is returned. """ if self.field_type not in (2, 5): return None # no checkbox or radio button bstate = self.button_states() if bstate is None: bstate = dict() for k in bstate.keys(): for v in bstate[k]: if v != "Off": return v message("warning: radio button has no 'On' value.") return True def reset(self): """Reset the field value to its default. """ TOOLS._reset_widget(self._annot) def update(self, sync_flags=False): """Reflect Python object in the PDF.""" self._validate() self._adjust_font() # ensure valid text_font name # now create the /DA string self._text_da = "" if len(self.text_color) == 3: fmt = "{:g} {:g} {:g} rg /{f:s} {s:g} Tf" + self._text_da elif len(self.text_color) == 1: fmt = "{:g} g /{f:s} {s:g} Tf" + self._text_da elif len(self.text_color) == 4: fmt = "{:g} {:g} {:g} {:g} k /{f:s} {s:g} Tf" + self._text_da self._text_da = fmt.format(*self.text_color, f=self.text_font, s=self.text_fontsize) # finally update the widget # if widget has a '/AA/C' script, make sure it is in the '/CO' # array of the '/AcroForm' dictionary. if self.script_calc: # there is a "calculation" script: # make sure we are in the /CO array util_ensure_widget_calc(self._annot) # finally update the widget TOOLS._save_widget(self._annot, self) self._text_da = "" if sync_flags: self._sync_flags() # propagate field flags to parent and kids from . import _extra class Outline: def __init__(self, ol): self.this = ol @property def dest(self): '''outline destination details''' return linkDest(self, None, None) def destination(self, document): ''' Like `dest` property but uses `document` to resolve destinations for kind=LINK_NAMED. ''' return linkDest(self, None, document) @property def down(self): ol = self.this down_ol = ol.down() if not down_ol.m_internal: return return Outline(down_ol) @property def is_external(self): if g_use_extra: # calling _extra.* here appears to save significant time in # test_toc.py:test_full_toc, 1.2s=>0.94s. # return _extra.Outline_is_external( self.this) ol = self.this if not ol.m_internal: return False uri = ol.m_internal.uri if 1 else ol.uri() if uri is None: return False return mupdf.fz_is_external_link(uri) @property def is_open(self): if 1: return self.this.m_internal.is_open return self.this.is_open() @property def next(self): ol = self.this next_ol = ol.next() if not next_ol.m_internal: return return Outline(next_ol) @property def page(self): if 1: return self.this.m_internal.page.page return self.this.page().page @property def title(self): return self.this.m_internal.title @property def uri(self): ol = self.this if not ol.m_internal: return None return ol.m_internal.uri @property def x(self): return self.this.m_internal.x @property def y(self): return self.this.m_internal.y __slots__ = [ 'this'] def _make_PdfFilterOptions( recurse=0, instance_forms=0, ascii=0, no_update=0, sanitize=0, sopts=None, ): ''' Returns a mupdf.PdfFilterOptions instance. ''' filter_ = mupdf.PdfFilterOptions() filter_.recurse = recurse filter_.instance_forms = instance_forms filter_.ascii = ascii filter_.no_update = no_update if sanitize: # We want to use a PdfFilterFactory whose `.filter` fn pointer is # set to MuPDF's `pdf_new_sanitize_filter()`. But not sure how to # get access to this raw fn in Python; and on Windows raw MuPDF # functions are not even available to C++. # # So we use SWIG Director to implement our own # PdfFilterFactory whose `filter()` method calls # `mupdf.ll_pdf_new_sanitize_filter()`. if sopts: assert isinstance(sopts, mupdf.PdfSanitizeFilterOptions) else: sopts = mupdf.PdfSanitizeFilterOptions() class Factory(mupdf.PdfFilterFactory2): def __init__(self): super().__init__() self.use_virtual_filter() self.sopts = sopts def filter(self, ctx, doc, chain, struct_parents, transform, options): if 0: log(f'sanitize filter.filter():') log(f' {self=}') log(f' {ctx=}') log(f' {doc=}') log(f' {chain=}') log(f' {struct_parents=}') log(f' {transform=}') log(f' {options=}') log(f' {self.sopts.internal()=}') return mupdf.ll_pdf_new_sanitize_filter( doc, chain, struct_parents, transform, options, self.sopts.internal(), ) factory = Factory() filter_.add_factory(factory.internal()) filter_._factory = factory return filter_ class Page: def __init__(self, page, document): assert isinstance(page, (mupdf.FzPage, mupdf.PdfPage)), f'page is: {page}' self.this = page self.thisown = True self.last_point = None self.draw_cont = '' self._annot_refs = dict() self.parent = document if page.m_internal: if isinstance( page, mupdf.PdfPage): self.number = page.m_internal.super.number else: self.number = page.m_internal.number else: self.number = None def __repr__(self): return self.__str__() def __str__(self): #CheckParent(self) parent = getattr(self, 'parent', None) if isinstance(self.this.m_internal, mupdf.pdf_page): number = self.this.m_internal.super.number else: number = self.this.m_internal.number if parent: x = self.parent.name if self.parent.stream is not None: x = "memory" if x == "": x = "new PDF" ret = f'page {number} of <{x}, doc# {self.parent._graft_id:d}>' else: ret = f'page {number}' return ret def _add_caret_annot(self, point): if g_use_extra: annot = extra._add_caret_annot( self.this, JM_point_from_py(point)) else: page = self._pdf_page() annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_CARET) if point: p = JM_point_from_py(point) r = mupdf.pdf_annot_rect(annot) r = mupdf.FzRect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0) mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") return annot def _add_file_annot(self, point, buffer_, filename, ufilename=None, desc=None, icon=None): page = self._pdf_page() uf = ufilename if ufilename else filename d = desc if desc else filename p = JM_point_from_py(point) filebuf = JM_BufferFromBytes(buffer_) if not filebuf.m_internal: raise TypeError( MSG_BAD_BUFFER) annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_FILE_ATTACHMENT) r = mupdf.pdf_annot_rect(annot) r = mupdf.fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0) mupdf.pdf_set_annot_rect(annot, r) flags = mupdf.PDF_ANNOT_IS_PRINT mupdf.pdf_set_annot_flags(annot, flags) if icon: mupdf.pdf_set_annot_icon_name(annot, icon) val = JM_embed_file(page.doc(), filebuf, filename, uf, d, 1) mupdf.pdf_dict_put(mupdf.pdf_annot_obj(annot), PDF_NAME('FS'), val) mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(annot), PDF_NAME('Contents'), filename) mupdf.pdf_update_annot(annot) mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_set_annot_flags(annot, flags) JM_add_annot_id(annot, "A") return Annot(annot) def _add_freetext_annot( self, rect, text, fontsize=11, fontname=None, text_color=None, fill_color=None, border_color=None, border_width=0, dashes=None, callout=None, line_end=mupdf.PDF_ANNOT_LE_OPEN_ARROW, opacity=1, align=0, rotate=0, richtext=False, style=None, ): rc = f""" {text}""" page = self._pdf_page() if border_color and not richtext: raise ValueError("cannot set border_color if rich_text is False") if border_color and not text_color: text_color = border_color nfcol, fcol = JM_color_FromSequence(fill_color) ntcol, tcol = JM_color_FromSequence(text_color) r = JM_rect_from_py(rect) if mupdf.fz_is_infinite_rect(r) or mupdf.fz_is_empty_rect(r): raise ValueError( MSG_BAD_RECT) annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_FREE_TEXT) annot_obj = mupdf.pdf_annot_obj(annot) #insert text as 'contents' or 'RC' depending on 'richtext' if not richtext: mupdf.pdf_set_annot_contents(annot, text) else: mupdf.pdf_dict_put_text_string(annot_obj,PDF_NAME("RC"), rc) if style: mupdf.pdf_dict_put_text_string(annot_obj,PDF_NAME("DS"), style) mupdf.pdf_set_annot_rect(annot, r) while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if rotate != 0: mupdf.pdf_dict_put_int(annot_obj, PDF_NAME('Rotate'), rotate) mupdf.pdf_set_annot_quadding(annot, align) if nfcol > 0: mupdf.pdf_set_annot_color(annot, fcol[:nfcol]) mupdf.pdf_set_annot_border_width(annot, border_width) mupdf.pdf_set_annot_opacity(annot, opacity) if dashes: for d in dashes: mupdf.pdf_add_annot_border_dash_item(annot, float(d)) # Insert callout information if callout: mupdf.pdf_dict_put(annot_obj, PDF_NAME("IT"), PDF_NAME("FreeTextCallout")) mupdf.pdf_set_annot_callout_style(annot, line_end) point_count = len(callout) extra.JM_set_annot_callout_line(annot, tuple(callout), point_count) # insert the default appearance string if not richtext: JM_make_annot_DA(annot, ntcol, tcol, fontname, fontsize) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") val = Annot(annot) return val def _add_ink_annot(self, list): page = _as_pdf_page(self.this) if not PySequence_Check(list): raise ValueError( MSG_BAD_ARG_INK_ANNOT) ctm = mupdf.FzMatrix() mupdf.pdf_page_transform(page, mupdf.FzRect(0), ctm) inv_ctm = mupdf.fz_invert_matrix(ctm) annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_INK) annot_obj = mupdf.pdf_annot_obj(annot) n0 = len(list) inklist = mupdf.pdf_new_array(page.doc(), n0) for j in range(n0): sublist = list[j] n1 = len(sublist) stroke = mupdf.pdf_new_array(page.doc(), 2 * n1) for i in range(n1): p = sublist[i] if not PySequence_Check(p) or PySequence_Size(p) != 2: raise ValueError( MSG_BAD_ARG_INK_ANNOT) point = mupdf.fz_transform_point(JM_point_from_py(p), inv_ctm) mupdf.pdf_array_push_real(stroke, point.x) mupdf.pdf_array_push_real(stroke, point.y) mupdf.pdf_array_push(inklist, stroke) mupdf.pdf_dict_put(annot_obj, PDF_NAME('InkList'), inklist) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") return Annot(annot) def _add_line_annot(self, p1, p2): page = self._pdf_page() annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_LINE) a = JM_point_from_py(p1) b = JM_point_from_py(p2) mupdf.pdf_set_annot_line(annot, a, b) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") assert annot.m_internal return Annot(annot) def _add_multiline(self, points, annot_type): page = self._pdf_page() if len(points) < 2: raise ValueError( MSG_BAD_ARG_POINTS) annot = mupdf.pdf_create_annot(page, annot_type) for p in points: if (PySequence_Size(p) != 2): raise ValueError( MSG_BAD_ARG_POINTS) point = JM_point_from_py(p) mupdf.pdf_add_annot_vertex(annot, point) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") return Annot(annot) def _add_redact_annot(self, quad, text=None, da_str=None, align=0, fill=None, text_color=None): page = self._pdf_page() fcol = [ 1, 1, 1, 0] nfcol = 0 annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_REDACT) q = JM_quad_from_py(quad) r = mupdf.fz_rect_from_quad(q) # TODO calculate de-rotated rect mupdf.pdf_set_annot_rect(annot, r) if fill: nfcol, fcol = JM_color_FromSequence(fill) arr = mupdf.pdf_new_array(page.doc(), nfcol) for i in range(nfcol): mupdf.pdf_array_push_real(arr, fcol[i]) mupdf.pdf_dict_put(mupdf.pdf_annot_obj(annot), PDF_NAME('IC'), arr) if text: assert da_str mupdf.pdf_dict_puts( mupdf.pdf_annot_obj(annot), "OverlayText", mupdf.pdf_new_text_string(text), ) mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(annot), PDF_NAME('DA'), da_str) mupdf.pdf_dict_put_int(mupdf.pdf_annot_obj(annot), PDF_NAME('Q'), align) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") annot = mupdf.ll_pdf_keep_annot(annot.m_internal) annot = mupdf.PdfAnnot( annot) return Annot(annot) def _add_square_or_circle(self, rect, annot_type): page = self._pdf_page() r = JM_rect_from_py(rect) if mupdf.fz_is_infinite_rect(r) or mupdf.fz_is_empty_rect(r): raise ValueError( MSG_BAD_RECT) annot = mupdf.pdf_create_annot(page, annot_type) mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") assert annot.m_internal return Annot(annot) def _add_stamp_annot(self, rect, stamp=0): rect = Rect(rect) r = JM_rect_from_py(rect) if mupdf.fz_is_infinite_rect(r) or mupdf.fz_is_empty_rect(r): raise ValueError(MSG_BAD_RECT) page = self._pdf_page() stamp_id = [ "Approved", "AsIs", "Confidential", "Departmental", "Experimental", "Expired", "Final", "ForComment", "ForPublicRelease", "NotApproved", "NotForPublicRelease", "Sold", "TopSecret", "Draft", ] n = len(stamp_id) buf = None name = None if stamp in range(n): name = stamp_id[stamp] elif isinstance(stamp, Pixmap): buf = stamp.tobytes() elif isinstance(stamp, str): buf = pathlib.Path(stamp).read_bytes() elif isinstance(stamp, (bytes, bytearray)): buf = stamp elif isinstance(stamp, io.BytesIO): buf = stamp.getvalue() else: name = stamp_id[0] annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_STAMP) if buf: # image stamp fzbuff = mupdf.fz_new_buffer_from_copied_data(buf) img = mupdf.fz_new_image_from_buffer(fzbuff) # compute image boundary box on page w, h = img.w(), img.h() scale = min(rect.width / w, rect.height / h) width = w * scale # bbox width height = h * scale # bbox height # center of "rect" center = (rect.tl + rect.br) / 2 x0 = center.x - width / 2 y0 = center.y - height / 2 x1 = x0 + width y1 = y0 + height r = mupdf.fz_make_rect(x0, y0, x1, y1) mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_set_annot_stamp_image(annot, img) mupdf.pdf_dict_put(mupdf.pdf_annot_obj(annot), PDF_NAME("Name"), mupdf.pdf_new_name("ImageStamp")) mupdf.pdf_set_annot_contents(annot, "Image Stamp") else: # text stamp mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_dict_put(mupdf.pdf_annot_obj(annot), PDF_NAME("Name"), PDF_NAME(name)) mupdf.pdf_set_annot_contents(annot, name) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") return Annot(annot) def _add_text_annot(self, point, text, icon=None): page = self._pdf_page() p = JM_point_from_py( point) annot = mupdf.pdf_create_annot(page, mupdf.PDF_ANNOT_TEXT) r = mupdf.pdf_annot_rect(annot) r = mupdf.fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0) mupdf.pdf_set_annot_rect(annot, r) mupdf.pdf_set_annot_contents(annot, text) if icon: mupdf.pdf_set_annot_icon_name(annot, icon) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") return Annot(annot) def _add_text_marker(self, quads, annot_type): CheckParent(self) if not self.parent.is_pdf: raise ValueError("is no PDF") val = Page__add_text_marker(self, quads, annot_type) if not val: return None val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val return val def _addAnnot_FromString(self, linklist): """Add links from list of object sources.""" CheckParent(self) if g_use_extra: self.__class__._addAnnot_FromString = extra.Page_addAnnot_FromString #log('Page._addAnnot_FromString() deferring to extra.Page_addAnnot_FromString().') return extra.Page_addAnnot_FromString( self.this, linklist) page = _as_pdf_page(self.this) lcount = len(linklist) # link count if lcount < 1: return i = -1 # insert links from the provided sources if not isinstance(linklist, tuple): raise ValueError( "bad 'linklist' argument") if not mupdf.pdf_dict_get( page.obj(), PDF_NAME('Annots')).m_internal: mupdf.pdf_dict_put_array( page.obj(), PDF_NAME('Annots'), lcount) annots = mupdf.pdf_dict_get( page.obj(), PDF_NAME('Annots')) assert annots.m_internal, f'{lcount=} {annots.m_internal=}' for i in range(lcount): txtpy = linklist[i] text = JM_StrAsChar(txtpy) if not text: message(f"skipping bad link / annot item {i:d}.") continue try: annot = mupdf.pdf_add_object( page.doc(), JM_pdf_obj_from_str( page.doc(), text)) ind_obj = mupdf.pdf_new_indirect( page.doc(), mupdf.pdf_to_num( annot), 0) mupdf.pdf_array_push( annots, ind_obj) except Exception: if g_exceptions_verbose: exception_info() message(f"skipping bad link / annot item {i:d}.\n") def _addWidget(self, field_type, field_name): page = self._pdf_page() pdf = page.doc() annot = JM_create_widget(pdf, page, field_type, field_name) if not annot.m_internal: raise RuntimeError( "cannot create widget") JM_add_annot_id(annot, "W") return Annot(annot) def _apply_redactions(self, text, images, graphics): page = self._pdf_page() opts = mupdf.PdfRedactOptions() opts.black_boxes = 0 # no black boxes opts.text = text # how to treat text opts.image_method = images # how to treat images opts.line_art = graphics # how to treat vector graphics success = mupdf.pdf_redact_page(page.doc(), page, opts) return success def _erase(self): self._reset_annot_refs() try: self.parent._forget_page(self) except Exception: exception_info() pass self.parent = None self.thisown = False self.number = None self.this = None def _count_q_balance(self): """Count missing graphic state pushs and pops. Returns: A pair of integers (push, pop). Push is the number of missing PDF "q" commands, pop is the number of "Q" commands. A balanced graphics state for the page will be reached if its /Contents is prepended with 'push' copies of string "q\n" and appended with 'pop' copies of "\nQ". """ page = _as_pdf_page(self) # need the underlying PDF page res = mupdf.pdf_dict_get( # access /Resources page.obj(), mupdf.PDF_ENUM_NAME_Resources, ) cont = mupdf.pdf_dict_get( # access /Contents page.obj(), mupdf.PDF_ENUM_NAME_Contents, ) pdf = _as_pdf_document(self.parent) # need underlying PDF document # return value of MuPDF function return mupdf.pdf_count_q_balance_outparams_fn(pdf, res, cont) def _get_optional_content(self, oc: OptInt) -> OptStr: if oc is None or oc == 0: return None doc = self.parent check = doc.xref_object(oc, compressed=True) if not ("/Type/OCG" in check or "/Type/OCMD" in check): #log( 'raising "bad optional content"') raise ValueError("bad optional content: 'oc'") #log( 'Looking at self._get_resource_properties()') props = {} for p, x in self._get_resource_properties(): props[x] = p if oc in props.keys(): return props[oc] i = 0 mc = f"MC{i:d}" while mc in props.values(): i += 1 mc = f"MC{i:d}" self._set_resource_property(mc, oc) #log(f'returning {mc=}') return mc def _get_resource_properties(self): ''' page list Resource/Properties ''' page = self._pdf_page() rc = JM_get_resource_properties(page.obj()) return rc def _get_textpage(self, clip=None, flags=0, matrix=None): if 1 or g_use_extra: ll_tpage = extra.page_get_textpage(self.this, clip, flags, matrix) tpage = mupdf.FzStextPage(ll_tpage) return tpage page = self.this options = mupdf.FzStextOptions(flags) rect = JM_rect_from_py(clip) # Default to page's rect if `clip` not specified, for #2048. rect = mupdf.fz_bound_page(page) if clip is None else JM_rect_from_py(clip) ctm = JM_matrix_from_py(matrix) tpage = mupdf.FzStextPage(rect) dev = mupdf.fz_new_stext_device(tpage, options) if _globals.no_device_caching: mupdf.fz_enable_device_hints( dev, mupdf.FZ_NO_CACHE) if isinstance(page, mupdf.FzPage): pass elif isinstance(page, mupdf.PdfPage): page = page.super() else: assert 0, f'Unrecognised {type(page)=}' mupdf.fz_run_page(page, dev, ctm, mupdf.FzCookie()) mupdf.fz_close_device(dev) return tpage def _insert_image(self, filename=None, pixmap=None, stream=None, imask=None, clip=None, overlay=1, rotate=0, keep_proportion=1, oc=0, width=0, height=0, xref=0, alpha=-1, _imgname=None, digests=None ): maskbuf = mupdf.FzBuffer() page = self._pdf_page() # This will create an empty PdfDocument with a call to # pdf_new_document() then assign page.doc()'s return value to it (which # drop the original empty pdf_document). pdf = page.doc() w = width h = height img_xref = xref rc_digest = 0 do_process_pixmap = 1 do_process_stream = 1 do_have_imask = 1 do_have_image = 1 do_have_xref = 1 if xref > 0: ref = mupdf.pdf_new_indirect(pdf, xref, 0) w = mupdf.pdf_to_int( mupdf.pdf_dict_geta( ref, PDF_NAME('Width'), PDF_NAME('W'))) h = mupdf.pdf_to_int( mupdf.pdf_dict_geta( ref, PDF_NAME('Height'), PDF_NAME('H'))) if w + h == 0: raise ValueError( MSG_IS_NO_IMAGE) #goto have_xref() do_process_pixmap = 0 do_process_stream = 0 do_have_imask = 0 do_have_image = 0 else: if stream: imgbuf = JM_BufferFromBytes(stream) do_process_pixmap = 0 else: if filename: imgbuf = mupdf.fz_read_file(filename) #goto have_stream() do_process_pixmap = 0 if do_process_pixmap: #log( 'do_process_pixmap') # process pixmap --------------------------------- arg_pix = pixmap.this w = arg_pix.w() h = arg_pix.h() digest = mupdf.fz_md5_pixmap2(arg_pix) md5_py = digest temp = digests.get(md5_py, None) if temp is not None: img_xref = temp ref = mupdf.pdf_new_indirect(page.doc(), img_xref, 0) #goto have_xref() do_process_stream = 0 do_have_imask = 0 do_have_image = 0 else: if arg_pix.alpha() == 0: image = mupdf.fz_new_image_from_pixmap(arg_pix, mupdf.FzImage()) else: pm = mupdf.fz_convert_pixmap( arg_pix, mupdf.FzColorspace(), mupdf.FzColorspace(), mupdf.FzDefaultColorspaces(None), mupdf.FzColorParams(), 1, ) pm.alpha = 0 pm.colorspace = None mask = mupdf.fz_new_image_from_pixmap(pm, mupdf.FzImage()) image = mupdf.fz_new_image_from_pixmap(arg_pix, mask) #goto have_image() do_process_stream = 0 do_have_imask = 0 if do_process_stream: #log( 'do_process_stream') # process stream --------------------------------- state = mupdf.FzMd5() if mupdf_cppyy: mupdf.fz_md5_update_buffer( state, imgbuf) else: mupdf.fz_md5_update(state, imgbuf.m_internal.data, imgbuf.m_internal.len) if imask: maskbuf = JM_BufferFromBytes(imask) if mupdf_cppyy: mupdf.fz_md5_update_buffer( state, maskbuf) else: mupdf.fz_md5_update(state, maskbuf.m_internal.data, maskbuf.m_internal.len) digest = mupdf.fz_md5_final2(state) md5_py = bytes(digest) temp = digests.get(md5_py, None) if temp is not None: img_xref = temp ref = mupdf.pdf_new_indirect(page.doc(), img_xref, 0) w = mupdf.pdf_to_int( mupdf.pdf_dict_geta( ref, PDF_NAME('Width'), PDF_NAME('W'))) h = mupdf.pdf_to_int( mupdf.pdf_dict_geta( ref, PDF_NAME('Height'), PDF_NAME('H'))) #goto have_xref() do_have_imask = 0 do_have_image = 0 else: image = mupdf.fz_new_image_from_buffer(imgbuf) w = image.w() h = image.h() if not imask: #goto have_image() do_have_imask = 0 if do_have_imask: # `fz_compressed_buffer` is reference counted and # `mupdf.fz_new_image_from_compressed_buffer2()` # is povided as a Swig-friendly wrapper for # `fz_new_image_from_compressed_buffer()`, so we can do things # straightfowardly. # cbuf1 = mupdf.fz_compressed_image_buffer( image) if not cbuf1.m_internal: raise ValueError( "uncompressed image cannot have mask") bpc = image.bpc() colorspace = image.colorspace() xres, yres = mupdf.fz_image_resolution(image) mask = mupdf.fz_new_image_from_buffer(maskbuf) image = mupdf.fz_new_image_from_compressed_buffer2( w, h, bpc, colorspace, xres, yres, 1, # interpolate 0, # imagemask, list(), # decode list(), # colorkey cbuf1, mask, ) if do_have_image: #log( 'do_have_image') ref = mupdf.pdf_add_image(pdf, image) if oc: JM_add_oc_object(pdf, ref, oc) img_xref = mupdf.pdf_to_num(ref) digests[md5_py] = img_xref rc_digest = 1 if do_have_xref: #log( 'do_have_xref') resources = mupdf.pdf_dict_get_inheritable(page.obj(), PDF_NAME('Resources')) if not resources.m_internal: resources = mupdf.pdf_dict_put_dict(page.obj(), PDF_NAME('Resources'), 2) xobject = mupdf.pdf_dict_get(resources, PDF_NAME('XObject')) if not xobject.m_internal: xobject = mupdf.pdf_dict_put_dict(resources, PDF_NAME('XObject'), 2) mat = calc_image_matrix(w, h, clip, rotate, keep_proportion) mupdf.pdf_dict_puts(xobject, _imgname, ref) nres = mupdf.fz_new_buffer(50) s = f"\nq\n{_format_g((mat.a, mat.b, mat.c, mat.d, mat.e, mat.f))} cm\n/{_imgname} Do\nQ\n" #s = s.replace('\n', '\r\n') mupdf.fz_append_string(nres, s) JM_insert_contents(pdf, page.obj(), nres, overlay) if rc_digest: return img_xref, digests else: return img_xref, None def _insertFont(self, fontname, bfname, fontfile, fontbuffer, set_simple, idx, wmode, serif, encoding, ordering): page = self._pdf_page() pdf = page.doc() value = JM_insert_font(pdf, bfname, fontfile,fontbuffer, set_simple, idx, wmode, serif, encoding, ordering) # get the objects /Resources, /Resources/Font resources = mupdf.pdf_dict_get_inheritable(page.obj(), PDF_NAME('Resources')) if not resources.pdf_is_dict(): resources = mupdf.pdf_dict_put_dict(page.obj(), PDF_NAME("Resources"), 5) fonts = mupdf.pdf_dict_get(resources, PDF_NAME('Font')) if not fonts.m_internal: # page has no fonts yet fonts = mupdf.pdf_new_dict(pdf, 5) mupdf.pdf_dict_putl(page.obj(), fonts, PDF_NAME('Resources'), PDF_NAME('Font')) # store font in resources and fonts objects will contain named reference to font _, xref = JM_INT_ITEM(value, 0) if not xref: raise RuntimeError( "cannot insert font") font_obj = mupdf.pdf_new_indirect(pdf, xref, 0) mupdf.pdf_dict_puts(fonts, fontname, font_obj) return value def _load_annot(self, name, xref): page = self._pdf_page() if xref == 0: annot = JM_get_annot_by_name(page, name) else: annot = JM_get_annot_by_xref(page, xref) if annot: return Annot(annot) def _makePixmap(self, doc, ctm, cs, alpha=0, annots=1, clip=None): pix = JM_pixmap_from_page(doc, self.this, ctm, cs, alpha, annots, clip) return Pixmap(pix) def _other_box(self, boxtype): rect = mupdf.FzRect( mupdf.FzRect.Fixed_INFINITE) page = _as_pdf_page(self.this, required=False) if page.m_internal: obj = mupdf.pdf_dict_gets( page.obj(), boxtype) if mupdf.pdf_is_array(obj): rect = mupdf.pdf_to_rect(obj) if mupdf.fz_is_infinite_rect( rect): return return JM_py_from_rect(rect) def _pdf_page(self, required=True): return _as_pdf_page(self.this, required=required) def _reset_annot_refs(self): """Invalidate / delete all annots of this page.""" self._annot_refs.clear() def _set_opacity(self, gstate=None, CA=1, ca=1, blendmode=None): if CA >= 1 and ca >= 1 and blendmode is None: return tCA = int(round(max(CA , 0) * 100)) if tCA >= 100: tCA = 99 tca = int(round(max(ca, 0) * 100)) if tca >= 100: tca = 99 gstate = f"fitzca{tCA:02d}{tca:02d}" if not gstate: return page = _as_pdf_page(self.this) resources = mupdf.pdf_dict_get(page.obj(), PDF_NAME('Resources')) if not resources.m_internal: resources = mupdf.pdf_dict_put_dict(page.obj(), PDF_NAME('Resources'), 2) extg = mupdf.pdf_dict_get(resources, PDF_NAME('ExtGState')) if not extg.m_internal: extg = mupdf.pdf_dict_put_dict(resources, PDF_NAME('ExtGState'), 2) n = mupdf.pdf_dict_len(extg) for i in range(n): o1 = mupdf.pdf_dict_get_key(extg, i) name = mupdf.pdf_to_name(o1) if name == gstate: return gstate opa = mupdf.pdf_new_dict(page.doc(), 3) mupdf.pdf_dict_put_real(opa, PDF_NAME('CA'), CA) mupdf.pdf_dict_put_real(opa, PDF_NAME('ca'), ca) mupdf.pdf_dict_puts(extg, gstate, opa) return gstate def _set_pagebox(self, boxtype, rect): doc = self.parent if doc is None: raise ValueError("orphaned object: parent is None") if not doc.is_pdf: raise ValueError("is no PDF") valid_boxes = ("CropBox", "BleedBox", "TrimBox", "ArtBox") if boxtype not in valid_boxes: raise ValueError("bad boxtype") rect = Rect(rect) mb = self.mediabox rect = Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) if not (mb.x0 <= rect.x0 < rect.x1 <= mb.x1 and mb.y0 <= rect.y0 < rect.y1 <= mb.y1): raise ValueError(f"{boxtype} not in MediaBox") doc.xref_set_key(self.xref, boxtype, f"[{_format_g(tuple(rect))}]") def _set_resource_property(self, name, xref): page = self._pdf_page() JM_set_resource_property(page.obj(), name, xref) def _show_pdf_page(self, fz_srcpage, overlay=1, matrix=None, xref=0, oc=0, clip=None, graftmap=None, _imgname=None): cropbox = JM_rect_from_py(clip) mat = JM_matrix_from_py(matrix) rc_xref = xref tpage = _as_pdf_page(self.this) tpageref = tpage.obj() pdfout = tpage.doc() # target PDF ENSURE_OPERATION(pdfout) #------------------------------------------------------------- # convert the source page to a Form XObject #------------------------------------------------------------- xobj1 = JM_xobject_from_page(pdfout, fz_srcpage, xref, graftmap.this) if not rc_xref: rc_xref = mupdf.pdf_to_num(xobj1) #------------------------------------------------------------- # create referencing XObject (controls display on target page) #------------------------------------------------------------- # fill reference to xobj1 into the /Resources #------------------------------------------------------------- subres1 = mupdf.pdf_new_dict(pdfout, 5) mupdf.pdf_dict_puts(subres1, "fullpage", xobj1) subres = mupdf.pdf_new_dict(pdfout, 5) mupdf.pdf_dict_put(subres, PDF_NAME('XObject'), subres1) res = mupdf.fz_new_buffer(20) mupdf.fz_append_string(res, "/fullpage Do") xobj2 = mupdf.pdf_new_xobject(pdfout, cropbox, mat, subres, res) if oc > 0: JM_add_oc_object(pdfout, mupdf.pdf_resolve_indirect(xobj2), oc) #------------------------------------------------------------- # update target page with xobj2: #------------------------------------------------------------- # 1. insert Xobject in Resources #------------------------------------------------------------- resources = mupdf.pdf_dict_get_inheritable(tpageref, PDF_NAME('Resources')) if not resources.m_internal: resources = mupdf.pdf_dict_put_dict(tpageref,PDF_NAME('Resources'), 5) subres = mupdf.pdf_dict_get(resources, PDF_NAME('XObject')) if not subres.m_internal: subres = mupdf.pdf_dict_put_dict(resources, PDF_NAME('XObject'), 5) mupdf.pdf_dict_puts(subres, _imgname, xobj2) #------------------------------------------------------------- # 2. make and insert new Contents object #------------------------------------------------------------- nres = mupdf.fz_new_buffer(50) # buffer for Do-command mupdf.fz_append_string(nres, " q /") # Do-command mupdf.fz_append_string(nres, _imgname) mupdf.fz_append_string(nres, " Do Q ") JM_insert_contents(pdfout, tpageref, nres, overlay) return rc_xref def add_caret_annot(self, point: point_like) -> Annot: """Add a 'Caret' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_caret_annot(point) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot = Annot( annot) annot_postprocess(self, annot) assert hasattr( annot, 'parent') return annot def add_circle_annot(self, rect: rect_like) -> Annot: """Add a 'Circle' (ellipse, oval) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_square_or_circle(rect, mupdf.PDF_ANNOT_CIRCLE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_file_annot( self, point: point_like, buffer_: ByteString, filename: str, ufilename: OptStr =None, desc: OptStr =None, icon: OptStr =None ) -> Annot: """Add a 'FileAttachment' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_file_annot(point, buffer_, filename, ufilename=ufilename, desc=desc, icon=icon, ) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_freetext_annot( self, rect: rect_like, text: str, *, fontsize: float =11, fontname: OptStr =None, text_color: OptSeq =None, fill_color: OptSeq =None, border_color: OptSeq =None, border_width: float =0, dashes: OptSeq =None, callout: OptSeq =None, line_end: int=mupdf.PDF_ANNOT_LE_OPEN_ARROW, opacity: float =1, align: int =0, rotate: int =0, richtext=False, style=None, ) -> Annot: """Add a 'FreeText' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_freetext_annot( rect, text, fontsize=fontsize, fontname=fontname, text_color=text_color, fill_color=fill_color, border_color=border_color, border_width=border_width, dashes=dashes, callout=callout, line_end=line_end, opacity=opacity, align=align, rotate=rotate, richtext=richtext, style=style, ) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_highlight_annot(self, quads=None, start=None, stop=None, clip=None) -> Annot: """Add a 'Highlight' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) ret = self._add_text_marker(q, mupdf.PDF_ANNOT_HIGHLIGHT) return ret def add_ink_annot(self, handwriting: list) -> Annot: """Add a 'Ink' ('handwriting') annotation. The argument must be a list of lists of point_likes. """ old_rotation = annot_preprocess(self) try: annot = self._add_ink_annot(handwriting) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_line_annot(self, p1: point_like, p2: point_like) -> Annot: """Add a 'Line' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_line_annot(p1, p2) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_polygon_annot(self, points: list) -> Annot: """Add a 'Polygon' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_multiline(points, mupdf.PDF_ANNOT_POLYGON) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_polyline_annot(self, points: list) -> Annot: """Add a 'PolyLine' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_multiline(points, mupdf.PDF_ANNOT_POLY_LINE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_rect_annot(self, rect: rect_like) -> Annot: """Add a 'Square' (rectangle) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_square_or_circle(rect, mupdf.PDF_ANNOT_SQUARE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_redact_annot( self, quad, text: OptStr =None, fontname: OptStr =None, fontsize: float =11, align: int =0, fill: OptSeq =None, text_color: OptSeq =None, cross_out: bool =True, ) -> Annot: """Add a 'Redact' annotation.""" da_str = None if text and not set(string.whitespace).issuperset(text): CheckColor(fill) CheckColor(text_color) if not fontname: fontname = "Helv" if not fontsize: fontsize = 11 if not text_color: text_color = (0, 0, 0) if hasattr(text_color, "__float__"): text_color = (text_color, text_color, text_color) if len(text_color) > 3: text_color = text_color[:3] fmt = "{:g} {:g} {:g} rg /{f:s} {s:g} Tf" da_str = fmt.format(*text_color, f=fontname, s=fontsize) if fill is None: fill = (1, 1, 1) if fill: if hasattr(fill, "__float__"): fill = (fill, fill, fill) if len(fill) > 3: fill = fill[:3] else: text = None old_rotation = annot_preprocess(self) try: annot = self._add_redact_annot(quad, text=text, da_str=da_str, align=align, fill=fill) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) #------------------------------------------------------------- # change appearance to show a crossed-out rectangle #------------------------------------------------------------- if cross_out: ap_tab = annot._getAP().splitlines()[:-1] # get the 4 commands only _, LL, LR, UR, UL = ap_tab ap_tab.append(LR) ap_tab.append(LL) ap_tab.append(UR) ap_tab.append(LL) ap_tab.append(UL) ap_tab.append(b"S") ap = b"\n".join(ap_tab) annot._setAP(ap, 0) return annot def add_squiggly_annot( self, quads=None, start=None, stop=None, clip=None, ) -> Annot: """Add a 'Squiggly' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, mupdf.PDF_ANNOT_SQUIGGLY) def add_stamp_annot(self, rect: rect_like, stamp=0) -> Annot: """Add a ('rubber') 'Stamp' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_stamp_annot(rect, stamp) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_strikeout_annot(self, quads=None, start=None, stop=None, clip=None) -> Annot: """Add a 'StrikeOut' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, mupdf.PDF_ANNOT_STRIKE_OUT) def add_text_annot(self, point: point_like, text: str, icon: str ="Note") -> Annot: """Add a 'Text' (sticky note) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_text_annot(point, text, icon=icon) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_underline_annot(self, quads=None, start=None, stop=None, clip=None) -> Annot: """Add a 'Underline' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, mupdf.PDF_ANNOT_UNDERLINE) def add_widget(self, widget: Widget) -> Annot: """Add a 'Widget' (form field).""" CheckParent(self) doc = self.parent if not doc.is_pdf: raise ValueError("is no PDF") widget._validate() annot = self._addWidget(widget.field_type, widget.field_name) if not annot: return None annot.thisown = True annot.parent = weakref.proxy(self) # owning page object self._annot_refs[id(annot)] = annot widget.parent = annot.parent widget._annot = annot widget.update() return annot def annot_names(self): ''' page get list of annot names ''' """List of names of annotations, fields and links.""" CheckParent(self) page = self._pdf_page(required=False) if not page.m_internal: return [] return JM_get_annot_id_list(page) def annot_xrefs(self): ''' List of xref numbers of annotations, fields and links. ''' return JM_get_annot_xref_list2(self) def annots(self, types=None): """ Generator over the annotations of a page. Args: types: (list) annotation types to subselect from. If none, all annotations are returned. E.g. types=[PDF_ANNOT_LINE] will only yield line annotations. """ skip_types = (mupdf.PDF_ANNOT_LINK, mupdf.PDF_ANNOT_POPUP, mupdf.PDF_ANNOT_WIDGET) if not hasattr(types, "__getitem__"): annot_xrefs = [a[0] for a in self.annot_xrefs() if a[1] not in skip_types] else: annot_xrefs = [a[0] for a in self.annot_xrefs() if a[1] in types and a[1] not in skip_types] for xref in annot_xrefs: annot = self.load_annot(xref) # In #4928, annot can be None, which we need to ignore. if annot: annot._yielded=True yield annot def apply_redactions( page: 'Page', images: int = 2, graphics: int = 1, text: int = 0, ) -> bool: """Apply the redaction annotations of the page. Args: page: the PDF page. images: 0 - ignore images 1 - remove all overlapping images 2 - blank out overlapping image parts 3 - remove image unless invisible graphics: 0 - ignore graphics 1 - remove graphics if contained in rectangle 2 - remove all overlapping graphics text: 0 - remove text 1 - ignore text """ def center_rect(annot_rect, new_text, font, fsize): """Calculate minimal sub-rectangle for the overlay text. Notes: Because 'insert_textbox' supports no vertical text centering, we calculate an approximate number of lines here and return a sub-rect with smaller height, which should still be sufficient. Args: annot_rect: the annotation rectangle new_text: the text to insert. font: the fontname. Must be one of the CJK or Base-14 set, else the rectangle is returned unchanged. fsize: the fontsize Returns: A rectangle to use instead of the annot rectangle. """ if not new_text or annot_rect.width <= EPSILON: return annot_rect try: text_width = get_text_length(new_text, font, fsize) except (ValueError, mupdf.FzErrorBase): # unsupported font if g_exceptions_verbose: exception_info() return annot_rect line_height = fsize * 1.2 limit = annot_rect.width h = math.ceil(text_width / limit) * line_height # estimate rect height if h >= annot_rect.height: return annot_rect r = annot_rect y = (annot_rect.tl.y + annot_rect.bl.y - h) * 0.5 r.y0 = y return r CheckParent(page) doc = page.parent if doc.is_encrypted or doc.is_closed: raise ValueError("document closed or encrypted") if not doc.is_pdf: raise ValueError("is no PDF") redact_annots = [] # storage of annot values for annot in page.annots( types=(mupdf.PDF_ANNOT_REDACT,) # pylint: disable=no-member ): # loop redactions redact_annots.append(annot._get_redact_values()) # save annot values if redact_annots == []: # any redactions on this page? return False # no redactions rc = page._apply_redactions(text, images, graphics) # call MuPDF if not rc: # should not happen really raise ValueError("Error applying redactions.") # now write replacement text in old redact rectangles shape = page.new_shape() for redact in redact_annots: annot_rect = redact["rect"] fill = redact["fill"] if fill: shape.draw_rect(annot_rect) # colorize the rect background shape.finish(fill=fill, color=fill) if "text" in redact.keys(): # if we also have text new_text = redact["text"] align = redact.get("align", 0) fname = redact["fontname"] fsize = redact["fontsize"] color = redact["text_color"] # try finding vertical centered sub-rect trect = center_rect(annot_rect, new_text, fname, fsize) rc = -1 while rc < 0 and fsize >= 4: # while not enough room # (re-) try insertion rc = shape.insert_textbox( trect, new_text, fontname=fname, fontsize=fsize, color=color, align=align, ) fsize -= 0.5 # reduce font if unsuccessful shape.commit() # append new contents object return True def recolor(self, components=1): """Convert colorspaces of objects on the page. Valid values are 1, 3 and 4. """ if components not in (1, 3, 4): raise ValueError("components must be one of 1, 3, 4") pdfdoc = _as_pdf_document(self.parent) ropt = mupdf.pdf_recolor_options() ropt.num_comp = components ropts = mupdf.PdfRecolorOptions(ropt) mupdf.pdf_recolor_page(pdfdoc, self.number, ropts) def clip_to_rect(self, rect): """Clip away page content outside the rectangle.""" clip = Rect(rect) if clip.is_infinite or (clip & self.rect).is_empty: raise ValueError("rect must not be infinite or empty") clip *= self.transformation_matrix pdfpage = _as_pdf_page(self) pclip = JM_rect_from_py(clip) mupdf.pdf_clip_page(pdfpage, pclip) JM_refresh_links(pdfpage) def get_layout(self): """Try to access layout information.""" if self.layout_information is not None: # layout information already present return if not _get_layout: # no layout information available return layout_info = _get_layout(self) self.layout_information = layout_info @property def artbox(self): """The ArtBox""" rect = self._other_box("ArtBox") if rect is None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) @property def bleedbox(self): """The BleedBox""" rect = self._other_box("BleedBox") if rect is None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) def bound(self): """Get page rectangle.""" CheckParent(self) page = _as_fz_page(self.this) val = mupdf.fz_bound_page(page) val = Rect(val) if val.is_infinite and self.parent.is_pdf: cb = self.cropbox w, h = cb.width, cb.height if self.rotation not in (0, 180): w, h = h, w val = Rect(0, 0, w, h) msg = TOOLS.mupdf_warnings(reset=False).splitlines()[-1] message(msg) return val def clean_contents(self, sanitize=1): if not sanitize and not self.is_wrapped: self.wrap_contents() page = _as_pdf_page( self.this, required=False) if not page.m_internal: return filter_ = _make_PdfFilterOptions(recurse=1, sanitize=sanitize) mupdf.pdf_filter_page_contents( page.doc(), page, filter_) @property def cropbox(self): """The CropBox.""" CheckParent(self) page = self._pdf_page(required=False) if not page.m_internal: val = mupdf.fz_bound_page(self.this) else: val = JM_cropbox(page.obj()) val = Rect(val) return val @property def cropbox_position(self): return self.cropbox.tl def delete_annot(self, annot): """Delete annot and return next one.""" CheckParent(self) CheckParent(annot) page = self._pdf_page() while 1: # first loop through all /IRT annots and remove them irt_annot = JM_find_annot_irt(annot.this) if not irt_annot: # no more there break mupdf.pdf_delete_annot(page, irt_annot.this) nextannot = mupdf.pdf_next_annot(annot.this) # store next mupdf.pdf_delete_annot(page, annot.this) val = Annot(nextannot) if val: val.thisown = True val.parent = weakref.proxy(self) # owning page object val.parent._annot_refs[id(val)] = val annot._erase() return val def delete_image(page: 'Page', xref: int): """Delete the image referred to by xef. Actually replaces by a small transparent Pixmap using method Page.replace_image. Args: xref: xref of the image to delete. """ # make a small 100% transparent pixmap (of just any dimension) pix = Pixmap(csGRAY, (0, 0, 1, 1), 1) pix.clear_with() # clear all samples bytes to 0x00 page.replace_image(xref, pixmap=pix) def delete_link(self, linkdict): """Delete a Link.""" CheckParent(self) if not isinstance( linkdict, dict): return # have no dictionary def finished(): if linkdict["xref"] == 0: return try: linkid = linkdict["id"] linkobj = self._annot_refs[linkid] linkobj._erase() except Exception: # Don't print this exception, to match classic. Issue #2841. if g_exceptions_verbose > 1: exception_info() pass page = _as_pdf_page(self.this, required=False) if not page.m_internal: return finished() # have no PDF xref = linkdict[dictkey_xref] if xref < 1: return finished() # invalid xref annots = mupdf.pdf_dict_get( page.obj(), PDF_NAME('Annots')) if not annots.m_internal: return finished() # have no annotations len_ = mupdf.pdf_array_len( annots) if len_ == 0: return finished() oxref = 0 for i in range( len_): oxref = mupdf.pdf_to_num( mupdf.pdf_array_get( annots, i)) if xref == oxref: break # found xref in annotations if xref != oxref: return finished() # xref not in annotations mupdf.pdf_array_delete( annots, i) # delete entry in annotations mupdf.pdf_delete_object( page.doc(), xref) # delete link object mupdf.pdf_dict_put( page.obj(), PDF_NAME('Annots'), annots) JM_refresh_links( page) return finished() def delete_widget(page: 'Page', widget: Widget) -> Widget: """Delete widget from page and return the next one.""" CheckParent(page) annot = getattr(widget, "_annot", None) if annot is None: raise ValueError("bad type: widget") nextwidget = widget.next page.delete_annot(annot) widget._annot.parent = None keylist = list(widget.__dict__.keys()) for key in keylist: del widget.__dict__[key] return nextwidget @property def derotation_matrix(self) -> Matrix: """Reflects page de-rotation.""" if g_use_extra: return Matrix(extra.Page_derotate_matrix( self.this)) pdfpage = self._pdf_page(required=False) if not pdfpage.m_internal: return Matrix(mupdf.FzRect(mupdf.FzRect.UNIT)) return Matrix(JM_derotate_page_matrix(pdfpage)) def draw_bezier( page: 'Page', p1: point_like, p2: point_like, p3: point_like, p4: point_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptStr = None, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a general cubic Bezier curve from p1 to p4 using control points p2 and p3.""" img = page.new_shape() Q = img.draw_bezier(Point(p1), Point(p2), Point(p3), Point(p4)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_circle( page: 'Page', center: point_like, radius: float, color: OptSeq = (0,), fill: OptSeq = None, morph: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a circle given its center and radius.""" img = page.new_shape() Q = img.draw_circle(Point(center), radius) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_curve( page: 'Page', p1: point_like, p2: point_like, p3: point_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptSeq = None, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a special Bezier curve from p1 to p3, generating control points on lines p1 to p2 and p2 to p3.""" img = page.new_shape() Q = img.draw_curve(Point(p1), Point(p2), Point(p3)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_line( page: 'Page', p1: point_like, p2: point_like, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc=0, ) -> Point: """Draw a line from point p1 to point p2.""" img = page.new_shape() p = img.draw_line(Point(p1), Point(p2)) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def draw_oval( page: 'Page', rect: typing.Union[rect_like, quad_like], color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, morph: OptSeq = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw an oval given its containing rectangle or quad.""" img = page.new_shape() Q = img.draw_oval(rect) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_polyline( page: 'Page', points: list, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptSeq = None, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, closePath: bool = False, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw multiple connected line segments.""" img = page.new_shape() Q = img.draw_polyline(points) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_quad( page: 'Page', quad: quad_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a quadrilateral.""" img = page.new_shape() Q = img.draw_quad(Quad(quad)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_rect( page: 'Page', rect: rect_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, radius=None, ) -> Point: ''' Draw a rectangle. See Shape class method for details. ''' img = page.new_shape() Q = img.draw_rect(Rect(rect), radius=radius) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_sector( page: 'Page', center: point_like, point: point_like, beta: float, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, fullSector: bool = True, morph: OptSeq = None, width: float = 1, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a circle sector given circle center, one arc end point and the angle of the arc. Parameters: center -- center of circle point -- arc end point beta -- angle of arc (degrees) fullSector -- connect arc ends with center """ img = page.new_shape() Q = img.draw_sector(Point(center), Point(point), beta, fullSector=fullSector) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_squiggle( page: 'Page', p1: point_like, p2: point_like, breadth: float = 2, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a squiggly line from point p1 to point p2.""" img = page.new_shape() p = img.draw_squiggle(Point(p1), Point(p2), breadth=breadth) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def draw_zigzag( page: 'Page', p1: point_like, p2: point_like, breadth: float = 2, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a zigzag line from point p1 to point p2.""" img = page.new_shape() p = img.draw_zigzag(Point(p1), Point(p2), breadth=breadth) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def extend_textpage(self, tpage, flags=0, matrix=None): page = self.this tp = tpage.this assert isinstance( tp, mupdf.FzStextPage) options = mupdf.FzStextOptions() options.flags = flags ctm = JM_matrix_from_py(matrix) dev = mupdf.FzDevice(tp, options) mupdf.fz_run_page( page, dev, ctm, mupdf.FzCookie()) mupdf.fz_close_device( dev) def find_tables(self, **kwargs): return table.find_tables(self, **kwargs) @property def first_annot(self): """First annotation.""" CheckParent(self) page = self._pdf_page(required=False) if not page.m_internal: return annot = mupdf.pdf_first_annot(page) if not annot.m_internal: return val = Annot(annot) val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val return val @property def first_link(self): ''' First link on page ''' return self.load_links() @property def first_widget(self): """First widget/field.""" CheckParent(self) annot = 0 page = self._pdf_page(required=False) if not page.m_internal: return annot = mupdf.pdf_first_widget(page) if not annot.m_internal: return val = Annot(annot) val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val widget = Widget() TOOLS._fill_widget(val, widget) val = widget return val def get_bboxlog(self, layers=None): CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) page = self.this rc = [] inc_layers = True if layers else False dev = JM_new_bbox_device( rc, inc_layers) mupdf.fz_run_page( page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) mupdf.fz_close_device( dev) if old_rotation != 0: self.set_rotation(old_rotation) return rc def get_cdrawings(self, extended=None, callback=None, method=None): """Extract vector graphics ("line art") from the page.""" CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) page = self.this if isinstance(page, mupdf.PdfPage): # Downcast pdf_page to fz_page. page = mupdf.FzPage(page) assert isinstance(page, mupdf.FzPage), f'{self.this=}' clips = True if extended else False prect = mupdf.fz_bound_page(page) if 1 or g_use_extra: rc = extra.get_cdrawings(page, extended, callback, method) else: rc = list() if callable(callback) or method is not None: dev = JM_new_lineart_device_Device(callback, clips, method) else: dev = JM_new_lineart_device_Device(rc, clips, method) dev.ptm = mupdf.FzMatrix(1, 0, 0, -1, 0, prect.y1) mupdf.fz_run_page(page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) mupdf.fz_close_device(dev) if old_rotation != 0: self.set_rotation(old_rotation) if callable(callback) or method is not None: return return rc def get_contents(self): """Get xrefs of /Contents objects.""" CheckParent(self) ret = [] page = _as_pdf_page(self.this) obj = page.obj() contents = mupdf.pdf_dict_get(obj, mupdf.PDF_ENUM_NAME_Contents) if mupdf.pdf_is_array(contents): n = mupdf.pdf_array_len(contents) for i in range(n): icont = mupdf.pdf_array_get(contents, i) xref = mupdf.pdf_to_num(icont) ret.append(xref) elif contents.m_internal: xref = mupdf.pdf_to_num(contents) ret.append( xref) return ret def get_displaylist(self, annots=1): ''' Make a DisplayList from the page for Pixmap generation. Include (default) or exclude annotations. ''' CheckParent(self) if annots: dl = mupdf.fz_new_display_list_from_page(self.this) else: dl = mupdf.fz_new_display_list_from_page_contents(self.this) return DisplayList(dl) def get_drawings(self, extended: bool=False) -> list: """Retrieve vector graphics. The extended version includes clips. Note: For greater comfort, this method converts point-likes, rect-likes, quad-likes of the C version to respective Point / Rect / Quad objects. It also adds default items that are missing in original path types. """ allkeys = ( 'closePath', 'fill', 'color', 'width', 'lineCap', 'lineJoin', 'dashes', 'stroke_opacity', 'fill_opacity', 'even_odd', ) val = self.get_cdrawings(extended=extended) for i in range(len(val)): npath = val[i] if not npath["type"].startswith("clip"): npath["rect"] = Rect(npath["rect"]) else: npath["scissor"] = Rect(npath["scissor"]) if npath["type"]!="group": items = npath["items"] newitems = [] for item in items: cmd = item[0] rest = item[1:] if cmd == "re": item = ("re", Rect(rest[0]).normalize(), rest[1]) elif cmd == "qu": item = ("qu", Quad(rest[0])) else: item = tuple([cmd] + [Point(i) for i in rest]) newitems.append(item) npath["items"] = newitems if npath['type'] in ('f', 's'): for k in allkeys: npath[k] = npath.get(k) val[i] = npath return val class Drawpath(object): """Reflects a path dictionary from get_cdrawings().""" def __init__(self, **args): self.__dict__.update(args) class Drawpathlist(object): """List of Path objects representing get_cdrawings() output.""" def __getitem__(self, item): return self.paths.__getitem__(item) def __init__(self): self.paths = [] self.path_count = 0 self.group_count = 0 self.clip_count = 0 self.fill_count = 0 self.stroke_count = 0 self.fillstroke_count = 0 def __len__(self): return self.paths.__len__() def append(self, path): self.paths.append(path) self.path_count += 1 if path.type == "clip": self.clip_count += 1 elif path.type == "group": self.group_count += 1 elif path.type == "f": self.fill_count += 1 elif path.type == "s": self.stroke_count += 1 elif path.type == "fs": self.fillstroke_count += 1 def clip_parents(self, i): """Return list of parent clip paths. Args: i: (int) return parents of this path. Returns: List of the clip parents.""" if i >= self.path_count: raise IndexError("bad path index") while i < 0: i += self.path_count lvl = self.paths[i].level clips = list( # clip paths before identified one reversed( [ p for p in self.paths[:i] if p.type == "clip" and p.level < lvl ] ) ) if clips == []: # none found: empty list return [] nclips = [clips[0]] # init return list for p in clips[1:]: if p.level >= nclips[-1].level: continue # only accept smaller clip levels nclips.append(p) return nclips def group_parents(self, i): """Return list of parent group paths. Args: i: (int) return parents of this path. Returns: List of the group parents.""" if i >= self.path_count: raise IndexError("bad path index") while i < 0: i += self.path_count lvl = self.paths[i].level groups = list( # group paths before identified one reversed( [ p for p in self.paths[:i] if p.type == "group" and p.level < lvl ] ) ) if groups == []: # none found: empty list return [] ngroups = [groups[0]] # init return list for p in groups[1:]: if p.level >= ngroups[-1].level: continue # only accept smaller group levels ngroups.append(p) return ngroups def get_lineart(self) -> object: """Get page drawings paths. Note: For greater comfort, this method converts point-like, rect-like, quad-like tuples of the C version to respective Point / Rect / Quad objects. Also adds default items that are missing in original path types. In contrast to get_drawings(), this output is an object. """ val = self.get_cdrawings(extended=True) paths = self.Drawpathlist() for path in val: npath = self.Drawpath(**path) if npath.type != "clip": npath.rect = Rect(path["rect"]) else: npath.scissor = Rect(path["scissor"]) if npath.type != "group": items = path["items"] newitems = [] for item in items: cmd = item[0] rest = item[1:] if cmd == "re": item = ("re", Rect(rest[0]).normalize(), rest[1]) elif cmd == "qu": item = ("qu", Quad(rest[0])) else: item = tuple([cmd] + [Point(i) for i in rest]) newitems.append(item) npath.items = newitems if npath.type == "f": npath.stroke_opacity = None npath.dashes = None npath.line_join = None npath.line_cap = None npath.color = None npath.width = None paths.append(npath) val = None return paths def get_image_info( page: 'Page', hashes: bool = False, xrefs: bool = False ) -> list: """Extract image information only from a pymupdf.TextPage. Args: hashes: (bool) include MD5 hash for each image. xrefs: (bool) try to find the xref for each image. Sets hashes to true. """ doc = page.parent if xrefs and doc.is_pdf: hashes = True if not doc.is_pdf: xrefs = False imginfo = getattr(page, "_image_info", None) if imginfo and not xrefs: return imginfo if not imginfo: tp = page.get_textpage(flags=TEXT_PRESERVE_IMAGES) imginfo = tp.extractIMGINFO(hashes=hashes) del tp if hashes: page._image_info = imginfo if not xrefs or not doc.is_pdf: return imginfo imglist = page.get_images() digests = {} for item in imglist: xref = item[0] pix = Pixmap(doc, xref) digests[pix.digest] = xref del pix for i in range(len(imginfo)): item = imginfo[i] xref = digests.get(item["digest"], 0) item["xref"] = xref imginfo[i] = item return imginfo def get_image_rects(page: 'Page', name, transform=False) -> list: """Return list of image positions on a page. Args: name: (str, list, int) image identification. May be reference name, an item of the page's image list or an xref. transform: (bool) whether to also return the transformation matrix. Returns: A list of pymupdf.Rect objects or tuples of (pymupdf.Rect, pymupdf.Matrix) for all image locations on the page. """ if type(name) in (list, tuple): xref = name[0] elif type(name) is int: xref = name else: imglist = [i for i in page.get_images() if i[7] == name] if imglist == []: raise ValueError("bad image name") elif len(imglist) != 1: raise ValueError("multiple image names found") xref = imglist[0][0] pix = Pixmap(page.parent, xref) # make pixmap of the image to compute MD5 digest = pix.digest del pix infos = page.get_image_info(hashes=True) if not transform: bboxes = [Rect(im["bbox"]) for im in infos if im["digest"] == digest] else: bboxes = [ (Rect(im["bbox"]), Matrix(im["transform"])) for im in infos if im["digest"] == digest ] return bboxes def get_label(page): """Return the label for this PDF page. Args: page: page object. Returns: The label (str) of the page. Errors return an empty string. """ # Jorj McKie, 2021-01-06 labels = page.parent._get_page_labels() if not labels: return "" labels.sort() return utils.get_label_pno(page.number, labels) def get_links(page: 'Page') -> list: """Create a list of all links contained in a PDF page. Notes: see PyMuPDF ducmentation for details. """ CheckParent(page) ln = page.first_link links = [] while ln: nl = utils.getLinkDict(ln, page.parent) links.append(nl) ln = ln.next if links != [] and page.parent.is_pdf: linkxrefs = [x for x in #page.annot_xrefs() JM_get_annot_xref_list2(page) if x[1] == mupdf.PDF_ANNOT_LINK # pylint: disable=no-member ] if len(linkxrefs) == len(links): for i in range(len(linkxrefs)): links[i]["xref"] = linkxrefs[i][0] links[i]["id"] = linkxrefs[i][2] return links def get_pixmap( page: 'Page', *, matrix: matrix_like=Identity, dpi=None, colorspace: Colorspace=None, clip: rect_like=None, alpha: bool=False, annots: bool=True, ) -> 'Pixmap': """Create pixmap of page. Keyword args: matrix: Matrix for transformation (default: Identity). dpi: desired dots per inch. If given, matrix is ignored. colorspace: (str/Colorspace) cmyk, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) whether to include alpha channel annots: (bool) whether to also render annotations """ if colorspace is None: colorspace = csRGB if dpi: zoom = dpi / 72 matrix = Matrix(zoom, zoom) if type(colorspace) is str: if colorspace.upper() == "GRAY": colorspace = csGRAY elif colorspace.upper() == "CMYK": colorspace = csCMYK else: colorspace = csRGB if colorspace.n not in (1, 3, 4): raise ValueError("unsupported colorspace") dl = page.get_displaylist(annots=annots) pix = dl.get_pixmap(matrix=matrix, colorspace=colorspace, alpha=alpha, clip=clip) dl = None if dpi: pix.set_dpi(dpi, dpi) return pix def remove_rotation(self): """Set page rotation to 0 while maintaining visual appearance.""" rot = self.rotation # normalized rotation value if rot == 0: return Identity # nothing to do # need to derotate the page's content mb = self.mediabox # current mediabox if rot == 90: # before derotation, shift content horizontally mat0 = Matrix(1, 0, 0, 1, mb.y1 - mb.x1 - mb.x0 - mb.y0, 0) elif rot == 270: # before derotation, shift content vertically mat0 = Matrix(1, 0, 0, 1, 0, mb.x1 - mb.y1 - mb.y0 - mb.x0) else: # rot = 180 mat0 = Matrix(1, 0, 0, 1, -2 * mb.x0, -2 * mb.y0) # prefix with derotation matrix mat = mat0 * self.derotation_matrix cmd = _format_g(tuple(mat)) + ' cm ' cmd = cmd.encode('utf8') _ = TOOLS._insert_contents(self, cmd, False) # prepend to page contents # swap x- and y-coordinates if rot in (90, 270): x0, y0, x1, y1 = mb mb.x0 = y0 mb.y0 = x0 mb.x1 = y1 mb.y1 = x1 self.set_mediabox(mb) self.set_rotation(0) rot = ~mat # inverse of the derotation matrix for annot in self.annots(): # modify rectangles of annotations r = annot.rect * rot # TODO: only try to set rectangle for applicable annot types annot.set_rect(r) for link in self.get_links(): # modify 'from' rectangles of links r = link["from"] * rot self.delete_link(link) link["from"] = r try: # invalid links remain deleted self.insert_link(link) except Exception: pass for widget in self.widgets(): # modify field rectangles r = widget.rect * rot widget.rect = r widget.update() return rot # the inverse of the generated derotation matrix def cluster_drawings( self, clip=None, drawings=None, x_tolerance: float = 3, y_tolerance: float = 3, final_filter: bool = True, ) -> list: """Join rectangles of neighboring vector graphic items. Args: clip: optional rect-like to restrict the page area to consider. drawings: (optional) output of a previous "get_drawings()". x_tolerance: horizontal neighborhood threshold. y_tolerance: vertical neighborhood threshold. Notes: Vector graphics (also called line-art or drawings) usually consist of independent items like rectangles, lines or curves to jointly form table grid lines or bar, line, pie charts and similar. This method identifies rectangles wrapping these disparate items. Returns: A list of Rect items, each wrapping line-art items that are close enough to be considered forming a common vector graphic. Only "significant" rectangles will be returned, i.e. having both, width and height larger than the tolerance values. """ CheckParent(self) parea = self.rect # the default clipping area if clip is not None: parea = Rect(clip) delta_x = x_tolerance # shorter local name delta_y = y_tolerance # shorter local name if drawings is None: # if we cannot re-use a previous output drawings = self.get_drawings() def are_neighbors(r1, r2): """Detect whether r1, r2 are "neighbors". Items r1, r2 are called neighbors if the minimum distance between their points is less-equal delta. Both parameters must be (potentially invalid) rectangles. """ # normalize rectangles as needed rr1_x0, rr1_x1 = (r1.x0, r1.x1) if r1.x1 > r1.x0 else (r1.x1, r1.x0) rr1_y0, rr1_y1 = (r1.y0, r1.y1) if r1.y1 > r1.y0 else (r1.y1, r1.y0) rr2_x0, rr2_x1 = (r2.x0, r2.x1) if r2.x1 > r2.x0 else (r2.x1, r2.x0) rr2_y0, rr2_y1 = (r2.y0, r2.y1) if r2.y1 > r2.y0 else (r2.y1, r2.y0) if ( 0 or rr1_x1 < rr2_x0 - delta_x or rr1_x0 > rr2_x1 + delta_x or rr1_y1 < rr2_y0 - delta_y or rr1_y0 > rr2_y1 + delta_y ): # Rects do not overlap. return False else: # Rects overlap. return True # exclude graphics not contained in the clip paths = [ p for p in drawings if 1 and p["rect"].x0 >= parea.x0 and p["rect"].x1 <= parea.x1 and p["rect"].y0 >= parea.y0 and p["rect"].y1 <= parea.y1 ] # list of all vector graphic rectangles prects = sorted([p["rect"] for p in paths], key=lambda r: (r.y1, r.x0)) new_rects = [] # the final list of the joined rectangles # ------------------------------------------------------------------------- # The strategy is to identify and join all rects that are neighbors # ------------------------------------------------------------------------- while prects: # the algorithm will empty this list r = +prects[0] # copy of first rectangle repeat = True while repeat: repeat = False for i in range(len(prects) - 1, 0, -1): # from back to front if are_neighbors(prects[i], r): r |= prects[i].tl # include in first rect r |= prects[i].br # include in first rect del prects[i] # delete this rect repeat = True new_rects.append(r) del prects[0] prects = sorted(set(prects), key=lambda r: (r.y1, r.x0)) new_rects = sorted(set(new_rects), key=lambda r: (r.y1, r.x0)) if not final_filter: return new_rects return [r for r in new_rects if r.width > delta_x and r.height > delta_y] def get_fonts(self, full=False): """List of fonts defined in the page object.""" CheckParent(self) return self.parent.get_page_fonts(self.number, full=full) def get_image_bbox(self, name, transform=0): """Get rectangle occupied by image 'name'. 'name' is either an item of the image list, or the referencing name string - elem[7] of the resp. item. Option 'transform' also returns the image transformation matrix. """ CheckParent(self) doc = self.parent if doc.is_closed or doc.is_encrypted: raise ValueError('document closed or encrypted') inf_rect = Rect(1, 1, -1, -1) null_mat = Matrix() if transform: rc = (inf_rect, null_mat) else: rc = inf_rect if type(name) in (list, tuple): if not type(name[-1]) is int: raise ValueError('need item of full page image list') item = name else: imglist = [i for i in doc.get_page_images(self.number, True) if name == i[7]] if len(imglist) == 1: item = imglist[0] elif imglist == []: raise ValueError('bad image name') else: raise ValueError(f"found multiple images named '{name}'.") xref = item[-1] if xref != 0 or transform: try: return self.get_image_rects(item, transform=transform)[0] except Exception: exception_info() return inf_rect pdf_page = self._pdf_page() val = JM_image_reporter(pdf_page) if not bool(val): return rc for v in val: if v[0] != item[-3]: continue q = Quad(v[1]) bbox = q.rect if transform == 0: rc = bbox break hm = Matrix(util_hor_matrix(q.ll, q.lr)) h = abs(q.ll - q.ul) w = abs(q.ur - q.ul) m0 = Matrix(1 / w, 0, 0, 1 / h, 0, 0) m = ~(hm * m0) rc = (bbox, m) break val = rc return val def get_images(self, full=False): """List of images defined in the page object.""" CheckParent(self) return self.parent.get_page_images(self.number, full=full) def get_oc_items(self) -> list: """Get OCGs and OCMDs used in the page's contents. Returns: List of items (name, xref, type), where type is one of "ocg" / "ocmd", and name is the property name. """ rc = [] for pname, xref in self._get_resource_properties(): text = self.parent.xref_object(xref, compressed=True) if "/Type/OCG" in text: octype = "ocg" elif "/Type/OCMD" in text: octype = "ocmd" else: continue rc.append((pname, xref, octype)) return rc def get_svg_image(self, matrix=None, text_as_path=1): """Make SVG image from page.""" CheckParent(self) mediabox = mupdf.fz_bound_page(self.this) ctm = JM_matrix_from_py(matrix) tbounds = mediabox text_option = mupdf.FZ_SVG_TEXT_AS_PATH if text_as_path == 1 else mupdf.FZ_SVG_TEXT_AS_TEXT tbounds = mupdf.fz_transform_rect(tbounds, ctm) res = mupdf.fz_new_buffer(1024) out = mupdf.FzOutput(res) dev = mupdf.fz_new_svg_device( out, tbounds.x1-tbounds.x0, # width tbounds.y1-tbounds.y0, # height text_option, 1, ) mupdf.fz_run_page(self.this, dev, ctm, mupdf.FzCookie()) mupdf.fz_close_device(dev) out.fz_close_output() text = JM_EscapeStrFromBuffer(res) return text def get_textbox( page: Page, rect: rect_like, textpage=None, #: TextPage = None, ) -> str: tp = textpage if tp is None: tp = page.get_textpage() elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rc = tp.extractTextbox(rect) if textpage is None: del tp return rc def get_text(self, *args, **kwargs): return utils.get_text(self, *args, **kwargs) def get_text_blocks(self, *args, **kwargs): return utils.get_text_blocks(self, *args, **kwargs) def get_text_selection(self, *args, **kwargs): return utils.get_text_selection(self, *args, **kwargs) def get_text_words(self, *args, **kwargs): return utils.get_text_words(self, *args, **kwargs) def get_textpage_ocr(self, *args, **kwargs): return utils.get_textpage_ocr(self, *args, **kwargs) def get_textpage(self, clip: rect_like = None, flags: int = 0, matrix=None) -> "TextPage": CheckParent(self) if matrix is None: matrix = Matrix(1, 1) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) try: textpage = self._get_textpage(clip, flags=flags, matrix=matrix) finally: if old_rotation != 0: self.set_rotation(old_rotation) textpage = TextPage(textpage) textpage.parent = weakref.proxy(self) return textpage def get_texttrace(self): CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) page = self.this rc = [] if 1 or g_use_extra: dev = extra.JM_new_texttrace_device(rc) else: dev = JM_new_texttrace_device(rc) prect = mupdf.fz_bound_page(page) dev.ptm = mupdf.FzMatrix(1, 0, 0, -1, 0, prect.y1) mupdf.fz_run_page(page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) mupdf.fz_close_device(dev) if old_rotation != 0: self.set_rotation(old_rotation) return rc def get_xobjects(self): """List of xobjects defined in the page object.""" CheckParent(self) return self.parent.get_page_xobjects(self.number) def insert_font(self, fontname="helv", fontfile=None, fontbuffer=None, set_simple=False, wmode=0, encoding=0): doc = self.parent if doc is None: raise ValueError("orphaned object: parent is None") idx = 0 if fontname.startswith("/"): fontname = fontname[1:] inv_chars = INVALID_NAME_CHARS.intersection(fontname) if inv_chars != set(): raise ValueError(f"bad fontname chars {inv_chars}") font = CheckFont(self, fontname) if font is not None: # font already in font list of page xref = font[0] # this is the xref if CheckFontInfo(doc, xref): # also in our document font list? return xref # yes: we are done # need to build the doc FontInfo entry - done via get_char_widths doc.get_char_widths(xref) return xref #-------------------------------------------------------------------------- # the font is not present for this page #-------------------------------------------------------------------------- bfname = Base14_fontdict.get(fontname.lower(), None) # BaseFont if Base-14 font serif = 0 CJK_number = -1 CJK_list_n = ["china-t", "china-s", "japan", "korea"] CJK_list_s = ["china-ts", "china-ss", "japan-s", "korea-s"] try: CJK_number = CJK_list_n.index(fontname) serif = 0 except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose > 1: exception_info() pass if CJK_number < 0: try: CJK_number = CJK_list_s.index(fontname) serif = 1 except Exception: # Verbose in PyMuPDF/tests. if g_exceptions_verbose > 1: exception_info() pass if fontname.lower() in fitz_fontdescriptors.keys(): import pymupdf_fonts fontbuffer = pymupdf_fonts.myfont(fontname) # make a copy del pymupdf_fonts # install the font for the page if fontfile is not None: if type(fontfile) is str: fontfile_str = fontfile elif hasattr(fontfile, "absolute"): fontfile_str = str(fontfile) elif hasattr(fontfile, "name"): fontfile_str = fontfile.name else: raise ValueError("bad fontfile") else: fontfile_str = None val = self._insertFont(fontname, bfname, fontfile_str, fontbuffer, set_simple, idx, wmode, serif, encoding, CJK_number) if not val: # did not work, error return return val xref = val[0] # xref of installed font fontdict = val[1] if CheckFontInfo(doc, xref): # check again: document already has this font return xref # we are done # need to create document font info doc.get_char_widths(xref, fontdict=fontdict) return xref def insert_htmlbox( page, rect, text, *, css=None, scale_low=0, archive=None, rotate=0, oc=0, opacity=1, overlay=True, _scale_word_width=True, _verbose=False, ) -> tuple: """Insert text with optional HTML tags and stylings into a rectangle. Args: rect: (rect-like) rectangle into which the text should be placed. text: (str) text with optional HTML tags and stylings. css: (str) CSS styling commands. scale_low: (float) force-fit content by scaling it down. Must be in range [0, 1]. If 1, no scaling will take place. If 0, arbitrary down-scaling is acceptable. A value of 0.1 would mean that content may be scaled down by at most 90%. archive: Archive object pointing to locations of used fonts or images rotate: (int) rotate the text in the box by a multiple of 90 degrees. oc: (int) the xref of an OCG / OCMD (Optional Content). opacity: (float) set opacity of inserted content. overlay: (bool) put text on top of page content. _scale_word_width: internal, for testing only. _verbose: internal, for testing only. Returns: A tuple of floats (spare_height, scale). spare_height: The height of the remaining space in below the text, or -1 if we failed to fit. scale: The scaling required; `0 < scale <= 1`. Will be less than `scale_low` if we failed to fit. """ # normalize rotation angle if not rotate % 90 == 0: raise ValueError("bad rotation angle") while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if not 0 <= scale_low <= 1: raise ValueError("'scale_low' must be in [0, 1]") if css is None: css = "" rect = Rect(rect) if rotate in (90, 270): temp_rect = Rect(0, 0, rect.height, rect.width) else: temp_rect = Rect(0, 0, rect.width, rect.height) # use a small border by default mycss = "body {margin:1px;}" + css # append user CSS # either make a story, or accept a given one if isinstance(text, str): # if a string, convert to a Story story = Story(html=text, user_css=mycss, archive=archive) elif isinstance(text, Story): story = text else: raise ValueError("'text' must be a string or a Story") # ---------------------------------------------------------------- # Find a scaling factor that lets our story fit in. Instead of scaling # the text smaller, we instead look at how much bigger the rect needs # to be to fit the text, then reverse the scaling to get how much we # need to scale down the text. # ---------------------------------------------------------------- rect_scale_max = None if scale_low == 0 else 1 / scale_low fit = story.fit_scale( temp_rect, scale_min=1, scale_max=rect_scale_max, flags=mupdf.FZ_PLACE_STORY_FLAG_NO_OVERFLOW if _scale_word_width else 0, verbose=_verbose, ) if not fit.big_enough: # there was no fit scale = 1 / fit.parameter return (-1, scale) # fit.filled is a tuple; we convert it in place to a Rect for # convenience. (fit.rect is already a Rect.) fit.filled = Rect(fit.filled) assert (fit.rect.x0, fit.rect.y0) == (0, 0) assert (fit.filled.x0, fit.filled.y0) == (0, 0) scale = 1 / fit.parameter assert scale >= scale_low, f'{scale_low=} {scale=}' spare_height = max((fit.rect.y1 - fit.filled.y1) * scale, 0) def rect_function(*args): return fit.rect, fit.rect, None # draw story on temp PDF page doc = story.write_with_links(rect_function) # Insert opacity if requested. # For this, we prepend a command to the /Contents. if 0 <= opacity < 1: tpage = doc[0] # load page # generate /ExtGstate for the page alp0 = tpage._set_opacity(CA=opacity, ca=opacity) s = f"/{alp0} gs\n" # generate graphic state command TOOLS._insert_contents(tpage, s.encode(), 0) # put result in target page page.show_pdf_page(rect, doc, 0, rotate=rotate, oc=oc, overlay=overlay) # ------------------------------------------------------------------------- # re-insert links in target rect (show_pdf_page cannot copy annotations) # ------------------------------------------------------------------------- # scaled center point of fit.rect mp1 = (fit.rect.tl + fit.rect.br) / 2 * scale # center point of target rect mp2 = (rect.tl + rect.br) / 2 # compute link positioning matrix: # - move center of scaled-down fit.rect to (0,0) # - rotate # - move (0,0) to center of target rect mat = ( Matrix(scale, 0, 0, scale, -mp1.x, -mp1.y) * Matrix(-rotate) * Matrix(1, 0, 0, 1, mp2.x, mp2.y) ) # copy over links for link in doc[0].get_links(): link["from"] *= mat page.insert_link(link) return spare_height, scale def insert_image( page, rect, *, alpha=-1, filename=None, height=0, keep_proportion=True, mask=None, oc=0, overlay=True, pixmap=None, rotate=0, stream=None, width=0, xref=0, ): """Insert an image for display in a rectangle. Args: rect: (rect_like) position of image on the page. alpha: (int, optional) set to 0 if image has no transparency. filename: (str, Path, file object) image filename. height: (int) keep_proportion: (bool) keep width / height ratio (default). mask: (bytes, optional) image consisting of alpha values to use. oc: (int) xref of OCG or OCMD to declare as Optional Content. overlay: (bool) put in foreground (default) or background. pixmap: (pymupdf.Pixmap) use this as image. rotate: (int) rotate by 0, 90, 180 or 270 degrees. stream: (bytes) use this as image. width: (int) xref: (int) use this as image. 'page' and 'rect' are positional, all other parameters are keywords. If 'xref' is given, that image is used. Other input options are ignored. Else, exactly one of pixmap, stream or filename must be given. 'alpha=0' for non-transparent images improves performance significantly. Affects stream and filename only. Optimum transparent insertions are possible by using filename / stream in conjunction with a 'mask' image of alpha values. Returns: xref (int) of inserted image. Re-use as argument for multiple insertions. """ CheckParent(page) doc = page.parent if not doc.is_pdf: raise ValueError("is no PDF") if xref == 0 and (bool(filename) + bool(stream) + bool(pixmap) != 1): raise ValueError("xref=0 needs exactly one of filename, pixmap, stream") if filename: if type(filename) is str: pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name else: raise ValueError("bad filename") if filename and not os.path.exists(filename): raise FileNotFoundError(f"No such file: '{filename}'") elif stream and type(stream) not in (bytes, bytearray, io.BytesIO): raise ValueError("stream must be bytes-like / BytesIO") elif pixmap and type(pixmap) is not Pixmap: raise ValueError("pixmap must be a Pixmap") if mask and not (stream or filename): raise ValueError("mask requires stream or filename") if mask and type(mask) not in (bytes, bytearray, io.BytesIO): raise ValueError("mask must be bytes-like / BytesIO") while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if rotate not in (0, 90, 180, 270): raise ValueError("bad rotate value") r = Rect(rect) if r.is_empty or r.is_infinite: raise ValueError("rect must be finite and not empty") clip = r * ~page.transformation_matrix # Create a unique image reference name. ilst = [i[7] for i in doc.get_page_images(page.number)] ilst += [i[1] for i in doc.get_page_xobjects(page.number)] ilst += [i[4] for i in doc.get_page_fonts(page.number)] n = "fzImg" # 'pymupdf image' i = 0 _imgname = n + "0" # first name candidate while _imgname in ilst: i += 1 _imgname = n + str(i) # try new name if overlay: page.wrap_contents() # ensure a balanced graphics state digests = doc.InsertedImages xref, digests = page._insert_image( filename=filename, pixmap=pixmap, stream=stream, imask=mask, clip=clip, overlay=overlay, oc=oc, xref=xref, rotate=rotate, keep_proportion=keep_proportion, width=width, height=height, alpha=alpha, _imgname=_imgname, digests=digests, ) if digests is not None: doc.InsertedImages = digests return xref def insert_link(page: 'Page', lnk: dict, mark: bool = True) -> None: """Insert a new link for the current page.""" CheckParent(page) annot = utils.getLinkText(page, lnk) if annot == "": raise ValueError("link kind not supported") page._addAnnot_FromString((annot,)) def insert_text( page: 'Page', point: point_like, text: typing.Union[str, list], *, fontsize: float = 11, lineheight: OptFloat = None, fontname: str = "helv", fontfile: OptStr = None, set_simple: int = 0, encoding: int = 0, color: OptSeq = None, fill: OptSeq = None, border_width: float = 0.05, miter_limit: float = 1, render_mode: int = 0, rotate: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ): img = page.new_shape() rc = img.insert_text( point, text, fontsize=fontsize, lineheight=lineheight, fontname=fontname, fontfile=fontfile, set_simple=set_simple, encoding=encoding, color=color, fill=fill, border_width=border_width, render_mode=render_mode, miter_limit=miter_limit, rotate=rotate, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) if rc >= 0: img.commit(overlay) return rc def insert_textbox( page: 'Page', rect: rect_like, buffer: typing.Union[str, list], *, align: int = 0, border_width: float = 0.05, color: OptSeq = None, encoding: int = 0, expandtabs: int = 1, fill_opacity: float = 1, fill: OptSeq = None, fontfile: OptStr = None, fontname: str = "helv", fontsize: float = 11, lineheight: OptFloat = None, miter_limit: float = 1, morph: OptSeq = None, oc: int = 0, overlay: bool = True, render_mode: int = 0, rotate: int = 0, set_simple: int = 0, stroke_opacity: float = 1, ) -> float: """Insert text into a given rectangle. Notes: Creates a Shape object, uses its same-named method and commits it. Parameters: rect: (rect-like) area to use for text. buffer: text to be inserted fontname: a Base-14 font, font name or '/name' fontfile: name of a font file fontsize: font size lineheight: overwrite the font property color: RGB color triple expandtabs: handles tabulators with string function align: left, center, right, justified rotate: 0, 90, 180, or 270 degrees morph: morph box with a matrix and a fixpoint overlay: put text in foreground or background Returns: unused or deficit rectangle area (float) """ img = page.new_shape() rc = img.insert_textbox( rect, buffer, fontsize=fontsize, lineheight=lineheight, fontname=fontname, fontfile=fontfile, set_simple=set_simple, encoding=encoding, color=color, fill=fill, expandtabs=expandtabs, render_mode=render_mode, miter_limit=miter_limit, border_width=border_width, align=align, rotate=rotate, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) if rc >= 0: img.commit(overlay) return rc @property def is_wrapped(self): """Check if /Contents is in a balanced graphics state.""" return self._count_q_balance() == (0, 0) @property def language(self): """Page language.""" pdfpage = _as_pdf_page(self.this, required=False) if not pdfpage.m_internal: return lang = mupdf.pdf_dict_get_inheritable(pdfpage.obj(), PDF_NAME('Lang')) if not lang.m_internal: return return mupdf.pdf_to_str_buf(lang) def links(self, kinds=None): """ Generator over the links of a page. Args: kinds: (list) link kinds to subselect from. If none, all links are returned. E.g. kinds=[LINK_URI] will only yield URI links. """ all_links = self.get_links() for link in all_links: if kinds is None or link["kind"] in kinds: yield (link) def load_annot(self, ident: typing.Union[str, int]) -> Annot: """Load an annot by name (/NM key) or xref. Args: ident: identifier, either name (str) or xref (int). """ CheckParent(self) if type(ident) is str: xref = 0 name = ident elif type(ident) is int: xref = ident name = None else: raise ValueError("identifier must be a string or integer") val = self._load_annot(name, xref) if not val: return val val.thisown = True val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val return val def load_links(self): """Get first Link.""" CheckParent(self) val = mupdf.fz_load_links( self.this) if not val.m_internal: return val = Link( val) val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val val.xref = 0 val.id = "" if self.parent.is_pdf: xrefs = self.annot_xrefs() xrefs = [x for x in xrefs if x[1] == mupdf.PDF_ANNOT_LINK] if xrefs: link_id = xrefs[0] val.xref = link_id[0] val.id = link_id[2] else: val.xref = 0 val.id = "" return val #---------------------------------------------------------------- # page load widget by xref #---------------------------------------------------------------- def load_widget( self, xref): """Load a widget by its xref.""" CheckParent(self) page = _as_pdf_page(self.this) annot = JM_get_widget_by_xref( page, xref) #log(f'{type(annot)=}') val = annot if not val: return val val.thisown = True val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val widget = Widget() TOOLS._fill_widget(val, widget) val = widget return val @property def mediabox(self): """The MediaBox.""" CheckParent(self) page = self._pdf_page(required=False) if not page.m_internal: rect = mupdf.fz_bound_page( self.this) else: rect = JM_mediabox( page.obj()) return Rect(rect) @property def mediabox_size(self): return Point(self.mediabox.x1, self.mediabox.y1) def new_shape(self): return Shape(self) #@property #def parent( self): # assert self._parent # if self._parent: # return self._parent # return Document( self.this.document()) def read_contents(self): """All /Contents streams concatenated to one bytes object.""" return TOOLS._get_all_contents(self) def refresh(self): """Refresh page after link/annot/widget updates.""" CheckParent(self) doc = self.parent page = doc.reload_page(self) # fixme this looks wrong. self.this = page def replace_image( page: 'Page', xref: int, *, filename=None, pixmap=None, stream=None, ): """Replace the image referred to by xref. Replace the image by changing the object definition stored under xref. This will leave the pages appearance instructions intact, so the new image is being displayed with the same bbox, rotation etc. By providing a small fully transparent image, an effect as if the image had been deleted can be achieved. A typical use may include replacing large images by a smaller version, e.g. with a lower resolution or graylevel instead of colored. Args: xref: the xref of the image to replace. filename, pixmap, stream: exactly one of these must be provided. The meaning being the same as in Page.insert_image. """ doc = page.parent # the owning document if not doc.xref_is_image(xref): raise ValueError("xref not an image") # insert new image anywhere in page if bool(filename) + bool(stream) + bool(pixmap) != 1: raise ValueError("Exactly one of filename/stream/pixmap must be given") new_xref = page.insert_image( page.rect, filename=filename, stream=stream, pixmap=pixmap ) doc.xref_copy(new_xref, xref) # copy over new to old last_contents_xref = page.get_contents()[-1] # new image insertion has created a new /Contents source, # which we will set to spaces now doc.update_stream(last_contents_xref, b" ") page._image_info = None # clear cache of extracted image information @property def rotation(self): """Page rotation.""" CheckParent(self) page = _as_pdf_page(self.this, required=0) if not page.m_internal: return 0 return JM_page_rotation(page) @property def rotation_matrix(self) -> Matrix: """Reflects page rotation.""" return Matrix(TOOLS._rotate_matrix(self)) def run(self, dw, m): """Run page through a device. dw: DeviceWrapper """ CheckParent(self) mupdf.fz_run_page(self.this, dw.device, JM_matrix_from_py(m), mupdf.FzCookie()) def search_for( page, text, *, clip=None, quads=False, flags=None, textpage=None, ) -> list: """Search for a string on a page. Args: text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: a pre-created pymupdf.TextPage Returns: a list of rectangles or quads, each containing one occurrence. """ if flags is None: flags=(0 | TEXT_DEHYPHENATE | TEXT_PRESERVE_WHITESPACE | TEXT_PRESERVE_LIGATURES | TEXT_MEDIABOX_CLIP ) if clip is not None: clip = Rect(clip) CheckParent(page) tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) # create pymupdf.TextPage elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rlist = tp.search(text, quads=quads) if textpage is None: del tp return rlist def set_artbox(self, rect): """Set the ArtBox.""" return self._set_pagebox("ArtBox", rect) def set_bleedbox(self, rect): """Set the BleedBox.""" return self._set_pagebox("BleedBox", rect) def set_contents(self, xref): """Set object at 'xref' as the page's /Contents.""" CheckParent(self) doc = self.parent if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") if xref not in range(1, doc.xref_length()): raise ValueError("bad xref") if not doc.xref_is_stream(xref): raise ValueError("xref is no stream") doc.xref_set_key(self.xref, "Contents", f"{xref:d} 0 R") def set_cropbox(self, rect): """Set the CropBox. Will also change Page.rect.""" return self._set_pagebox("CropBox", rect) def set_language(self, language=None): """Set PDF page default language.""" CheckParent(self) pdfpage = _as_pdf_page(self.this) if not language: mupdf.pdf_dict_del(pdfpage.obj(), PDF_NAME('Lang')) else: lang = mupdf.fz_text_language_from_string(language) assert hasattr(mupdf, 'fz_string_from_text_language2') mupdf.pdf_dict_put_text_string( pdfpage.obj, PDF_NAME('Lang'), mupdf.fz_string_from_text_language2(lang) ) def set_mediabox(self, rect): """Set the MediaBox.""" CheckParent(self) page = self._pdf_page() mediabox = JM_rect_from_py(rect) if (mupdf.fz_is_empty_rect(mediabox) or mupdf.fz_is_infinite_rect(mediabox) ): raise ValueError( MSG_BAD_RECT) mupdf.pdf_dict_put_rect( page.obj(), PDF_NAME('MediaBox'), mediabox) mupdf.pdf_dict_del( page.obj(), PDF_NAME('CropBox')) mupdf.pdf_dict_del( page.obj(), PDF_NAME('ArtBox')) mupdf.pdf_dict_del( page.obj(), PDF_NAME('BleedBox')) mupdf.pdf_dict_del( page.obj(), PDF_NAME('TrimBox')) def set_rotation(self, rotation): """Set page rotation.""" CheckParent(self) page = _as_pdf_page(self.this) rot = JM_norm_rotation(rotation) mupdf.pdf_dict_put_int( page.obj(), PDF_NAME('Rotate'), rot) def set_trimbox(self, rect): """Set the TrimBox.""" return self._set_pagebox("TrimBox", rect) def show_pdf_page( page, rect, docsrc, pno=0, keep_proportion=True, overlay=True, oc=0, rotate=0, clip=None, ) -> int: """Show page number 'pno' of PDF 'docsrc' in rectangle 'rect'. Args: rect: (rect-like) where to place the source image docsrc: (document) source PDF pno: (int) source page number keep_proportion: (bool) do not change width-height-ratio overlay: (bool) put in foreground oc: (xref) make visibility dependent on this OCG / OCMD (which must be defined in the target PDF) rotate: (int) degrees (multiple of 90) clip: (rect-like) part of source page rectangle Returns: xref of inserted object (for reuse) """ def calc_matrix(sr, tr, keep=True, rotate=0): """Calculate transformation matrix from source to target rect. Notes: The product of four matrices in this sequence: (1) translate correct source corner to origin, (2) rotate, (3) scale, (4) translate to target's top-left corner. Args: sr: source rect in PDF (!) coordinate system tr: target rect in PDF coordinate system keep: whether to keep source ratio of width to height rotate: rotation angle in degrees Returns: Transformation matrix. """ # calc center point of source rect smp = (sr.tl + sr.br) / 2.0 # calc center point of target rect tmp = (tr.tl + tr.br) / 2.0 # m moves to (0, 0), then rotates m = Matrix(1, 0, 0, 1, -smp.x, -smp.y) * Matrix(rotate) sr1 = sr * m # resulting source rect to calculate scale factors fw = tr.width / sr1.width # scale the width fh = tr.height / sr1.height # scale the height if keep: fw = fh = min(fw, fh) # take min if keeping aspect ratio m *= Matrix(fw, fh) # concat scale matrix m *= Matrix(1, 0, 0, 1, tmp.x, tmp.y) # concat move to target center return JM_TUPLE(m) CheckParent(page) doc = page.parent if not doc.is_pdf or not docsrc.is_pdf: raise ValueError("is no PDF") if rect.is_empty or rect.is_infinite: raise ValueError("rect must be finite and not empty") while pno < 0: # support negative page numbers pno += docsrc.page_count src_page = docsrc[pno] # load source page tar_rect = rect * ~page.transformation_matrix # target rect in PDF coordinates src_rect = src_page.rect if not clip else src_page.rect & clip # source rect if src_rect.is_empty or src_rect.is_infinite: raise ValueError("clip must be finite and not empty") src_rect = src_rect * ~src_page.transformation_matrix # ... in PDF coord matrix = calc_matrix(src_rect, tar_rect, keep=keep_proportion, rotate=rotate) # list of existing /Form /XObjects ilst = [i[1] for i in doc.get_page_xobjects(page.number)] ilst += [i[7] for i in doc.get_page_images(page.number)] ilst += [i[4] for i in doc.get_page_fonts(page.number)] # create a name not in that list n = "fzFrm" i = 0 _imgname = n + "0" while _imgname in ilst: i += 1 _imgname = n + str(i) isrc = docsrc._graft_id # used as key for graftmaps if doc._graft_id == isrc: raise ValueError("source document must not equal target") # retrieve / make Graftmap for source PDF gmap = doc.Graftmaps.get(isrc, None) if gmap is None: gmap = Graftmap(doc) doc.Graftmaps[isrc] = gmap # take note of generated xref for automatic reuse pno_id = (isrc, pno) # id of docsrc[pno] xref = doc.ShownPages.get(pno_id, 0) if overlay: page.wrap_contents() # ensure a balanced graphics state xref = page._show_pdf_page( src_page, overlay=overlay, matrix=matrix, xref=xref, oc=oc, clip=src_rect, graftmap=gmap, _imgname=_imgname, ) doc.ShownPages[pno_id] = xref return xref @property def transformation_matrix(self): """Page transformation matrix.""" CheckParent(self) ctm = mupdf.FzMatrix() page = self._pdf_page(required=False) if not page.m_internal: return JM_py_from_matrix(ctm) mediabox = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) # fixme: original code passed mediabox=NULL. mupdf.pdf_page_transform(page, mediabox, ctm) val = JM_py_from_matrix(ctm) if self.rotation % 360 == 0: val = Matrix(val) else: val = Matrix(1, 0, 0, -1, 0, self.cropbox.height) return val @property def trimbox(self): """The TrimBox""" rect = self._other_box("TrimBox") if rect is None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) def update_link(page: 'Page', lnk: dict) -> None: """Update a link on the current page.""" CheckParent(page) annot = utils.getLinkText(page, lnk) if annot == "": raise ValueError("link kind not supported") page.parent.update_object(lnk["xref"], annot, page=page) def widgets(self, types=None): """ Generator over the widgets of a page. Args: types: (list) field types to subselect from. If none, all fields are returned. E.g. types=[PDF_WIDGET_TYPE_TEXT] will only yield text fields. """ #for a in self.annot_xrefs(): # log(f'{a=}') widget_xrefs = [a[0] for a in self.annot_xrefs() if a[1] == mupdf.PDF_ANNOT_WIDGET] #log(f'widgets(): {widget_xrefs=}') for xref in widget_xrefs: widget = self.load_widget(xref) if types is None or widget.field_type in types: yield (widget) def wrap_contents(self): """Ensure page is in a balanced graphics state.""" push, pop = self._count_q_balance() # count missing "q"/"Q" commands if push > 0: # prepend required push commands prepend = b"q\n" * push TOOLS._insert_contents(self, prepend, False) if pop > 0: # append required pop commands append = b"\nQ" * pop + b"\n" TOOLS._insert_contents(self, append, True) def write_text( page: 'Page', rect=None, writers=None, overlay=True, color=None, opacity=None, keep_proportion=True, rotate=0, oc=0, ) -> None: """Write the text of one or more pymupdf.TextWriter objects. Args: rect: target rectangle. If None, the union of the text writers is used. writers: one or more pymupdf.TextWriter objects. overlay: put in foreground or background. keep_proportion: maintain aspect ratio of rectangle sides. rotate: arbitrary rotation angle. oc: the xref of an optional content object """ assert isinstance(page, Page) if not writers: raise ValueError("need at least one pymupdf.TextWriter") if type(writers) is TextWriter: if rotate == 0 and rect is None: writers.write_text(page, opacity=opacity, color=color, overlay=overlay) return None else: writers = (writers,) clip = writers[0].text_rect textdoc = Document() tpage = textdoc.new_page(width=page.rect.width, height=page.rect.height) for writer in writers: clip |= writer.text_rect writer.write_text(tpage, opacity=opacity, color=color) if rect is None: rect = clip page.show_pdf_page( rect, textdoc, 0, overlay=overlay, keep_proportion=keep_proportion, rotate=rotate, clip=clip, oc=oc, ) textdoc = None tpage = None @property def xref(self): """PDF xref number of page.""" CheckParent(self) return self.parent.page_xref(self.number) rect = property(bound, doc="page rectangle") # any result of layout analysis is stored here layout_information = None class Pixmap: def __init__(self, *args): """ Pixmap(colorspace, irect, alpha) - empty pixmap. Pixmap(colorspace, src) - copy changing colorspace. Pixmap(src, width, height,[clip]) - scaled copy, float dimensions. Pixmap(src, alpha=1) - copy and add or drop alpha channel. Pixmap(filename) - from an image in a file. Pixmap(image) - from an image in memory (bytes). Pixmap(colorspace, width, height, samples, alpha) - from samples data. Pixmap(PDFdoc, xref) - from an image at xref in a PDF document. """ # Cache for property `self.samples_mv`. Set here so __del_() sees it if # we raise. # self._samples_mv = None # 2024-01-16: Experimental support for a memory-view of the underlying # data. Doesn't seem to make much difference to Pixmap.set_pixel() so # not currently used. self._memory_view = None if 0: pass elif args_match(args, (Colorspace, mupdf.FzColorspace), (mupdf.FzRect, mupdf.FzIrect, IRect, Rect, tuple) ): # create empty pixmap with colorspace and IRect cs, rect = args alpha = 0 pm = mupdf.fz_new_pixmap_with_bbox(cs, JM_irect_from_py(rect), mupdf.FzSeparations(0), alpha) self.this = pm elif args_match(args, (Colorspace, mupdf.FzColorspace), (mupdf.FzRect, mupdf.FzIrect, IRect, Rect, tuple), (int, bool) ): # create empty pixmap with colorspace and IRect cs, rect, alpha = args pm = mupdf.fz_new_pixmap_with_bbox(cs, JM_irect_from_py(rect), mupdf.FzSeparations(0), alpha) self.this = pm elif args_match(args, (Colorspace, mupdf.FzColorspace, type(None)), (Pixmap, mupdf.FzPixmap)): # copy pixmap, converting colorspace cs, spix = args if isinstance(cs, Colorspace): cs = cs.this elif cs is None: cs = mupdf.FzColorspace(None) if isinstance(spix, Pixmap): spix = spix.this if not mupdf.fz_pixmap_colorspace(spix).m_internal: raise ValueError( "source colorspace must not be None") if cs.m_internal: self.this = mupdf.fz_convert_pixmap( spix, cs, mupdf.FzColorspace(), mupdf.FzDefaultColorspaces(None), mupdf.FzColorParams(), 1 ) else: self.this = mupdf.fz_new_pixmap_from_alpha_channel( spix) if not self.this.m_internal: raise RuntimeError( MSG_PIX_NOALPHA) elif args_match(args, (Pixmap, mupdf.FzPixmap), (Pixmap, mupdf.FzPixmap)): # add mask to a pixmap w/o alpha channel spix, mpix = args if isinstance(spix, Pixmap): spix = spix.this if isinstance(mpix, Pixmap): mpix = mpix.this spm = spix mpm = mpix if not spix.m_internal: # intercept NULL for spix: make alpha only pix dst = mupdf.fz_new_pixmap_from_alpha_channel(mpm) if not dst.m_internal: raise RuntimeError( MSG_PIX_NOALPHA) else: dst = mupdf.fz_new_pixmap_from_color_and_mask(spm, mpm) self.this = dst elif (args_match(args, (Pixmap, mupdf.FzPixmap), (float, int), (float, int), None) or args_match(args, (Pixmap, mupdf.FzPixmap), (float, int), (float, int))): # create pixmap as scaled copy of another one if len(args) == 3: spix, w, h = args bbox = mupdf.FzIrect(mupdf.fz_infinite_irect) else: spix, w, h, clip = args bbox = JM_irect_from_py(clip) src_pix = spix.this if isinstance(spix, Pixmap) else spix if not mupdf.fz_is_infinite_irect(bbox): pm = mupdf.fz_scale_pixmap(src_pix, src_pix.x(), src_pix.y(), w, h, bbox) else: pm = mupdf.fz_scale_pixmap(src_pix, src_pix.x(), src_pix.y(), w, h, mupdf.FzIrect(mupdf.fz_infinite_irect)) self.this = pm elif args_match(args, str, (Pixmap, mupdf.FzPixmap)) and args[0] == 'raw': # Special raw construction where we set .this directly. _, pm = args if isinstance(pm, Pixmap): pm = pm.this self.this = pm elif args_match(args, (Pixmap, mupdf.FzPixmap), (int, None)): # Pixmap(struct Pixmap *spix, int alpha=1) # copy pixmap & add / drop the alpha channel spix = args[0] alpha = args[1] if len(args) == 2 else 1 src_pix = spix.this if isinstance(spix, Pixmap) else spix if not _INRANGE(alpha, 0, 1): raise ValueError( "bad alpha value") cs = mupdf.fz_pixmap_colorspace(src_pix) if not cs.m_internal and not alpha: raise ValueError( "cannot drop alpha for 'NULL' colorspace") seps = mupdf.FzSeparations() n = mupdf.fz_pixmap_colorants(src_pix) w = mupdf.fz_pixmap_width(src_pix) h = mupdf.fz_pixmap_height(src_pix) pm = mupdf.fz_new_pixmap(cs, w, h, seps, alpha) pm.m_internal.x = src_pix.m_internal.x pm.m_internal.y = src_pix.m_internal.y pm.m_internal.xres = src_pix.m_internal.xres pm.m_internal.yres = src_pix.m_internal.yres # copy samples data ------------------------------------------ if 1: # We use our pixmap_copy() to get best performance. # test_pixmap.py:test_setalpha(): 3.9s t=0.0062 extra.pixmap_copy( pm.m_internal, src_pix.m_internal, n) elif 1: # Use memoryview. # test_pixmap.py:test_setalpha(): 4.6 t=0.51 src_view = mupdf.fz_pixmap_samples_memoryview( src_pix) pm_view = mupdf.fz_pixmap_samples_memoryview( pm) if src_pix.alpha() == pm.alpha(): # identical samples #memcpy(tptr, sptr, w * h * (n + alpha)); size = w * h * (n + alpha) pm_view[ 0 : size] = src_view[ 0 : size] else: tptr = 0 sptr = 0 # This is a little faster than calling # pm.fz_samples_set(), but still quite slow. E.g. reduces # test_pixmap.py:test_setalpha() from 6.7s to 4.5s. # # t=0.53 pm_stride = pm.stride() pm_n = pm.n() pm_alpha = pm.alpha() src_stride = src_pix.stride() src_n = src_pix.n() #log(f'{pm_stride pm_n src_stride src_n=}') for y in range( h): for x in range( w): pm_i = pm_stride * y + pm_n * x src_i = src_stride * y + src_n * x pm_view[ pm_i : pm_i + n] = src_view[ src_i : src_i + n] if pm_alpha: pm_view[ pm_i + n] = 255 else: # Copy individual bytes from Python. Very slow. # test_pixmap.py:test_setalpha(): 6.89 t=2.601 if src_pix.alpha() == pm.alpha(): # identical samples #memcpy(tptr, sptr, w * h * (n + alpha)); for i in range(w * h * (n + alpha)): mupdf.fz_samples_set(pm, i, mupdf.fz_samples_get(src_pix, i)) else: # t=2.56 tptr = 0 sptr = 0 src_pix_alpha = src_pix.alpha() for i in range(w * h): #memcpy(tptr, sptr, n); for j in range(n): mupdf.fz_samples_set(pm, tptr + j, mupdf.fz_samples_get(src_pix, sptr + j)) tptr += n if pm.alpha(): mupdf.fz_samples_set(pm, tptr, 255) tptr += 1 sptr += n + src_pix_alpha self.this = pm elif args_match(args, (mupdf.FzColorspace, Colorspace), int, int, None, (int, bool)): # create pixmap from samples data cs, w, h, samples, alpha = args if isinstance(cs, Colorspace): cs = cs.this assert isinstance(cs, mupdf.FzColorspace) n = mupdf.fz_colorspace_n(cs) stride = (n + alpha) * w seps = mupdf.FzSeparations() pm = mupdf.fz_new_pixmap(cs, w, h, seps, alpha) if isinstance( samples, (bytes, bytearray)): #log('using mupdf.python_buffer_data()') samples2 = mupdf.python_buffer_data(samples) size = len(samples) else: res = JM_BufferFromBytes(samples) if not res.m_internal: raise ValueError( "bad samples data") size, c = mupdf.fz_buffer_storage(res) samples2 = mupdf.python_buffer_data(samples) # raw swig proxy for `const unsigned char*`. if stride * h != size: raise ValueError( f"bad samples length {w=} {h=} {alpha=} {n=} {stride=} {size=}") mupdf.ll_fz_pixmap_copy_raw( pm.m_internal, samples2) self.this = pm elif args_match(args, None): # create pixmap from filename, file object, pathlib.Path or memory imagedata, = args name = 'name' if hasattr(imagedata, "resolve"): fname = imagedata.__str__() if fname: img = mupdf.fz_new_image_from_file(fname) elif hasattr(imagedata, name): fname = imagedata.name if fname: img = mupdf.fz_new_image_from_file(fname) elif isinstance(imagedata, str): img = mupdf.fz_new_image_from_file(imagedata) else: res = JM_BufferFromBytes(imagedata) if not res.m_internal or not res.m_internal.len: raise ValueError( "bad image data") img = mupdf.fz_new_image_from_buffer(res) # Original code passed null for subarea and ctm, but that's not # possible with MuPDF's python bindings. The equivalent is an # infinite rect and identify matrix scaled by img.w() and img.h(). pm, w, h = mupdf.fz_get_pixmap_from_image( img, mupdf.FzIrect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT), mupdf.FzMatrix( img.w(), 0, 0, img.h(), 0, 0), ) xres, yres = mupdf.fz_image_resolution(img) pm.m_internal.xres = xres pm.m_internal.yres = yres self.this = pm elif args_match(args, (Document, mupdf.FzDocument), int): # Create pixmap from PDF image identified by XREF number doc, xref = args pdf = _as_pdf_document(doc) xreflen = mupdf.pdf_xref_len(pdf) if not _INRANGE(xref, 1, xreflen-1): raise ValueError( MSG_BAD_XREF) ref = mupdf.pdf_new_indirect(pdf, xref, 0) type_ = mupdf.pdf_dict_get(ref, PDF_NAME('Subtype')) if (not mupdf.pdf_name_eq(type_, PDF_NAME('Image')) and not mupdf.pdf_name_eq(type_, PDF_NAME('Alpha')) and not mupdf.pdf_name_eq(type_, PDF_NAME('Luminosity')) ): raise ValueError( MSG_IS_NO_IMAGE) img = mupdf.pdf_load_image(pdf, ref) # Original code passed null for subarea and ctm, but that's not # possible with MuPDF's python bindings. The equivalent is an # infinite rect and identify matrix scaled by img.w() and img.h(). pix, w, h = mupdf.fz_get_pixmap_from_image( img, mupdf.FzIrect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT), mupdf.FzMatrix(img.w(), 0, 0, img.h(), 0, 0), ) self.this = pix else: text = 'Unrecognised args for constructing Pixmap:\n' for arg in args: text += f' {type(arg)}: {arg}\n' raise Exception( text) def __len__(self): return self.size def __repr__(self): if not type(self) is Pixmap: return colorspace = "none" if self.colorspace: colorspace = self.colorspace.this.m_internal.name return f"Pixmap({colorspace}, {self.irect}, {self.alpha})" def _tobytes(self, format_, jpg_quality): ''' Pixmap._tobytes ''' pm = self.this size = mupdf.fz_pixmap_stride(pm) * pm.h() res = mupdf.fz_new_buffer(size) out = mupdf.FzOutput(res) if format_ == 1: mupdf.fz_write_pixmap_as_png(out, pm) elif format_ == 2: mupdf.fz_write_pixmap_as_pnm(out, pm) elif format_ == 3: mupdf.fz_write_pixmap_as_pam(out, pm) elif format_ == 5: mupdf.fz_write_pixmap_as_psd(out, pm) elif format_ == 6: mupdf.fz_write_pixmap_as_ps(out, pm) elif format_ == 7: mupdf.fz_write_pixmap_as_jpeg(out, pm, jpg_quality, 0) else: mupdf.fz_write_pixmap_as_png(out, pm) out.fz_close_output() barray = JM_BinFromBuffer(res) return barray def _writeIMG(self, filename, format_, jpg_quality): pm = self.this if format_ == 1: mupdf.fz_save_pixmap_as_png(pm, filename) elif format_ == 2: mupdf.fz_save_pixmap_as_pnm(pm, filename) elif format_ == 3: mupdf.fz_save_pixmap_as_pam(pm, filename) elif format_ == 5: mupdf.fz_save_pixmap_as_psd(pm, filename) elif format_ == 6: mupdf.fz_save_pixmap_as_ps(pm, filename) elif format_ == 7: mupdf.fz_save_pixmap_as_jpeg(pm, filename, jpg_quality) else: mupdf.fz_save_pixmap_as_png(pm, filename) @property def alpha(self): """Indicates presence of alpha channel.""" return mupdf.fz_pixmap_alpha(self.this) def clear_with(self, value=None, bbox=None): """Fill all color components with same value.""" if value is None: mupdf.fz_clear_pixmap(self.this) elif bbox is None: mupdf.fz_clear_pixmap_with_value(self.this, value) else: JM_clear_pixmap_rect_with_value(self.this, value, JM_irect_from_py(bbox)) def color_count(self, colors=0, clip=None): ''' Return count of each color. ''' pm = self.this rc = JM_color_count( pm, clip) if not colors: return len( rc) return rc def color_topusage(self, clip=None): """Return most frequent color and its usage ratio.""" allpixels = 0 cnt = 0 if clip is not None and self.irect in Rect(clip): clip = self.irect for pixel, count in self.color_count(colors=True,clip=clip).items(): allpixels += count if count > cnt: cnt = count maxpixel = pixel if not allpixels: return (1, bytes([255] * self.n)) return (cnt / allpixels, maxpixel) @property def colorspace(self): """Pixmap Colorspace.""" cs = Colorspace(mupdf.fz_pixmap_colorspace(self.this)) if cs.name == "None": return None return cs def copy(self, src, bbox): """Copy bbox from another Pixmap.""" pm = self.this src_pix = src.this if not mupdf.fz_pixmap_colorspace(src_pix): raise ValueError( "cannot copy pixmap with NULL colorspace") if pm.alpha() != src_pix.alpha(): raise ValueError( "source and target alpha must be equal") mupdf.fz_copy_pixmap_rect(pm, src_pix, JM_irect_from_py(bbox), mupdf.FzDefaultColorspaces(None)) @property def digest(self): """MD5 digest of pixmap (bytes).""" ret = mupdf.fz_md5_pixmap2(self.this) return bytes(ret) def gamma_with(self, gamma): """Apply correction with some float. gamma=1 is a no-op.""" if not mupdf.fz_pixmap_colorspace( self.this): message_warning("colorspace invalid for function") return mupdf.fz_gamma_pixmap( self.this, gamma) @property def h(self): """The height.""" return mupdf.fz_pixmap_height(self.this) def invert_irect(self, bbox=None): """Invert the colors inside a bbox.""" pm = self.this if not mupdf.fz_pixmap_colorspace(pm).m_internal: message_warning("ignored for stencil pixmap") return False r = JM_irect_from_py(bbox) if mupdf.fz_is_infinite_irect(r): mupdf.fz_invert_pixmap(pm) return True mupdf.fz_invert_pixmap_rect(pm, r) return True @property def irect(self): """Pixmap bbox - an IRect object.""" val = mupdf.fz_pixmap_bbox(self.this) return JM_py_from_irect( val) @property def is_monochrome(self): """Check if pixmap is monochrome.""" return mupdf.fz_is_pixmap_monochrome( self.this) @property def is_unicolor(self): ''' Check if pixmap has only one color. ''' pm = self.this n = pm.n() count = pm.w() * pm.h() * n def _pixmap_read_samples(pm, offset, n): ret = list() for i in range(n): ret.append(mupdf.fz_samples_get(pm, offset+i)) return ret for offset in range( 0, count, n): if offset == 0: sample0 = _pixmap_read_samples( pm, 0, n) else: sample = _pixmap_read_samples( pm, offset, n) if sample != sample0: return False return True @property def n(self): """The size of one pixel.""" if g_use_extra: # Setting self.__class__.n gives a small reduction in overhead of # test_general.py:test_2093, e.g. 1.4x -> 1.3x. #return extra.pixmap_n(self.this) def n2(self): return extra.pixmap_n(self.this) self.__class__.n = property(n2) return self.n return mupdf.fz_pixmap_components(self.this) def pdfocr_save(self, filename, compress=1, language=None, tessdata=None): ''' Save pixmap as an OCR-ed PDF page. ''' tessdata = get_tessdata(tessdata) opts = mupdf.FzPdfocrOptions() opts.compress = compress if language: opts.language_set2( language) if tessdata: opts.datadir_set2( tessdata) pix = self.this if isinstance(filename, str): mupdf.fz_save_pixmap_as_pdfocr( pix, filename, 0, opts) else: out = JM_new_output_fileptr( filename) try: mupdf.fz_write_pixmap_as_pdfocr( out, pix, opts) finally: out.fz_close_output() # Avoid MuPDF warning. def pdfocr_tobytes(self, compress=True, language="eng", tessdata=None): """Save pixmap as an OCR-ed PDF page. Args: compress: (bool) compress, default 1 (True). language: (str) language(s) occurring on page, default "eng" (English), multiples like "eng+ger" for English and German. tessdata: (str) folder name of Tesseract's language support. If None we use environment variable TESSDATA_PREFIX or search for Tesseract installation. Notes: On failure, make sure Tesseract is installed and you have set or environment variable "TESSDATA_PREFIX" to the folder containing your Tesseract's language support data. """ tessdata = get_tessdata(tessdata) from io import BytesIO bio = BytesIO() self.pdfocr_save(bio, compress=compress, language=language, tessdata=tessdata) return bio.getvalue() def pil_image(self): """Create a Pillow Image from the Pixmap.""" try: from PIL import Image except ImportError: message("PIL/Pillow not installed") raise cspace = self.colorspace if not cspace: mode = "L" elif cspace.n == 1: mode = "L" if not self.alpha else "LA" elif cspace.n == 3: mode = "RGB" if not self.alpha else "RGBA" else: mode = "CMYK" img = Image.frombytes(mode, (self.width, self.height), self.samples) return img def pil_save(self, *args, **kwargs): """Write to image file using Pillow. An intermediate PIL Image is created, and its "save" method is used to store the image. See Pillow documentation to learn about the meaning of possible positional and keyword parameters. Use this when other output formats are desired. """ img = self.pil_image() if "dpi" not in kwargs.keys(): kwargs["dpi"] = (self.xres, self.yres) img.save(*args, **kwargs) def pil_tobytes(self, *args, **kwargs): """Convert to an image in memory using Pillow. An intermediate PIL Image is created, and its "save" method is used to store the image. See Pillow documentation to learn about the meaning of possible positional or keyword parameters. Use this when other output formats are desired. """ bytes_out = io.BytesIO() img = self.pil_image() if "dpi" not in kwargs.keys(): kwargs["dpi"] = (self.xres, self.yres) img.save(bytes_out, *args, **kwargs) return bytes_out.getvalue() def pixel(self, x, y): """Get color tuple of pixel (x, y). Last item is the alpha if Pixmap.alpha is true.""" if g_use_extra: return extra.pixmap_pixel(self.this.m_internal, x, y) if (0 or x < 0 or x >= self.this.m_internal.w or y < 0 or y >= self.this.m_internal.h ): RAISEPY(MSG_PIXEL_OUTSIDE, PyExc_ValueError) n = self.this.m_internal.n stride = self.this.m_internal.stride i = stride * y + n * x ret = tuple( self.samples_mv[ i: i+n]) return ret @property def samples(self)->bytes: mv = self.samples_mv return bytes( mv) @property def samples_mv(self): ''' Pixmap samples memoryview. ''' # We remember the returned memoryview so that our `__del__()` can # release it; otherwise accessing it after we have been destructed will # fail, possibly crashing Python; this is #4155. # if self._samples_mv is None: self._samples_mv = mupdf.fz_pixmap_samples_memoryview(self.this) return self._samples_mv def _samples_mv_release(self): if self._samples_mv: self._samples_mv.release() @property def samples_ptr(self): return mupdf.fz_pixmap_samples_int(self.this) def save(self, filename, output=None, jpg_quality=95): """Output as image in format determined by filename extension. Args: output: (str) only use to overrule filename extension. Default is PNG. Others are JPEG, JPG, PNM, PGM, PPM, PBM, PAM, PSD, PS. """ valid_formats = { "png": 1, "pnm": 2, "pgm": 2, "ppm": 2, "pbm": 2, "pam": 3, "psd": 5, "ps": 6, "jpg": 7, "jpeg": 7, } if type(filename) is str: pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name if output is None: _, ext = os.path.splitext(filename) output = ext[1:] idx = valid_formats.get(output.lower(), None) if idx is None: raise ValueError(f"Image format {output} not in {tuple(valid_formats.keys())}") if self.alpha and idx in (2, 6, 7): raise ValueError(f"'{output}' cannot have alpha") if self.colorspace and self.colorspace.n > 3 and idx in (1, 2, 4): raise ValueError(f"unsupported colorspace for '{output}'") if idx == 7: self.set_dpi(self.xres, self.yres) return self._writeIMG(filename, idx, jpg_quality) def set_alpha(self, alphavalues=None, premultiply=1, opaque=None, matte=None): """Set alpha channel to values contained in a byte array. If omitted, set alphas to 255. Args: alphavalues: (bytes) with length (width * height) or 'None'. premultiply: (bool, True) premultiply colors with alpha values. opaque: (tuple, length colorspace.n) this color receives opacity 0. matte: (tuple, length colorspace.n)) preblending background color. """ pix = self.this alpha = 0 m = 0 if pix.alpha() == 0: raise ValueError( MSG_PIX_NOALPHA) n = mupdf.fz_pixmap_colorants(pix) w = mupdf.fz_pixmap_width(pix) h = mupdf.fz_pixmap_height(pix) balen = w * h * (n+1) colors = [0, 0, 0, 0] # make this color opaque bgcolor = [0, 0, 0, 0] # preblending background color zero_out = 0 bground = 0 if opaque and isinstance(opaque, (list, tuple)) and len(opaque) == n: for i in range(n): colors[i] = opaque[i] zero_out = 1 if matte and isinstance( matte, (tuple, list)) and len(matte) == n: for i in range(n): bgcolor[i] = matte[i] bground = 1 data = bytes() data_len = 0 if alphavalues: #res = JM_BufferFromBytes(alphavalues) #data_len, data = mupdf.fz_buffer_storage(res) #if data_len < w * h: # THROWMSG("bad alpha values") # fixme: don't seem to need to create an fz_buffer - can # use directly? if isinstance(alphavalues, (bytes, bytearray)): data = alphavalues data_len = len(alphavalues) else: assert 0, f'unexpected type for alphavalues: {type(alphavalues)}' if data_len < w * h: raise ValueError( "bad alpha values") if 1: # Use C implementation for speed. mupdf.Pixmap_set_alpha_helper( balen, n, data_len, zero_out, mupdf.python_buffer_data( data), pix.m_internal, premultiply, bground, colors, bgcolor, ) else: i = k = j = 0 data_fix = 255 while i < balen: alpha = data[k] if zero_out: for j in range(i, i+n): if mupdf.fz_samples_get(pix, j) != colors[j - i]: data_fix = 255 break else: data_fix = 0 if data_len: def fz_mul255( a, b): x = a * b + 128 x += x // 256 return x // 256 if data_fix == 0: mupdf.fz_samples_set(pix, i+n, 0) else: mupdf.fz_samples_set(pix, i+n, alpha) if premultiply and not bground: for j in range(i, i+n): mupdf.fz_samples_set(pix, j, fz_mul255( mupdf.fz_samples_get(pix, j), alpha)) elif bground: for j in range( i, i+n): m = bgcolor[j - i] mupdf.fz_samples_set(pix, j, fz_mul255( mupdf.fz_samples_get(pix, j) - m, alpha)) else: mupdf.fz_samples_set(pix, i+n, data_fix) i += n+1 k += 1 def tobytes(self, output="png", jpg_quality=95): ''' Convert to binary image stream of desired type. ''' valid_formats = { "png": 1, "pnm": 2, "pgm": 2, "ppm": 2, "pbm": 2, "pam": 3, "tga": 4, "tpic": 4, "psd": 5, "ps": 6, 'jpg': 7, 'jpeg': 7, } idx = valid_formats.get(output.lower(), None) if idx is None: raise ValueError(f"Image format {output} not in {tuple(valid_formats.keys())}") if self.alpha and idx in (2, 6, 7): raise ValueError("'{output}' cannot have alpha") if self.colorspace and self.colorspace.n > 3 and idx in (1, 2, 4): raise ValueError(f"unsupported colorspace for '{output}'") if idx == 7: self.set_dpi(self.xres, self.yres) barray = self._tobytes(idx, jpg_quality) return barray def set_dpi(self, xres, yres): """Set resolution in both dimensions.""" pm = self.this pm.m_internal.xres = xres pm.m_internal.yres = yres def set_origin(self, x, y): """Set top-left coordinates.""" pm = self.this pm.m_internal.x = x pm.m_internal.y = y def set_pixel(self, x, y, color): """Set color of pixel (x, y).""" if g_use_extra: return extra.set_pixel(self.this.m_internal, x, y, color) pm = self.this if not _INRANGE(x, 0, pm.w() - 1) or not _INRANGE(y, 0, pm.h() - 1): raise ValueError( MSG_PIXEL_OUTSIDE) n = pm.n() for j in range(n): i = color[j] if not _INRANGE(i, 0, 255): raise ValueError( MSG_BAD_COLOR_SEQ) stride = mupdf.fz_pixmap_stride( pm) i = stride * y + n * x if 0: # Using a cached self._memory_view doesn't actually make much # difference to speed. if not self._memory_view: self._memory_view = self.samples_mv for j in range(n): self._memory_view[i + j] = color[j] else: for j in range(n): pm.fz_samples_set(i + j, color[j]) def set_rect(self, bbox, color): """Set color of all pixels in bbox.""" pm = self.this n = pm.n() c = [] for j in range(n): i = color[j] if not _INRANGE(i, 0, 255): raise ValueError( MSG_BAD_COLOR_SEQ) c.append(i) bbox = JM_irect_from_py(bbox) i = JM_fill_pixmap_rect_with_color(pm, c, bbox) rc = bool(i) return rc def shrink(self, factor): """Divide width and height by 2**factor. E.g. factor=1 shrinks to 25% of original size (in place).""" if factor < 1: message_warning("ignoring shrink factor < 1") return mupdf.fz_subsample_pixmap( self.this, factor) # Pixmap has changed so clear our memory view. self._memory_view = None self._samples_mv_release() @property def size(self): """Pixmap size.""" return mupdf.fz_pixmap_size( self.this) @property def stride(self): """Length of one image line (width * n).""" return self.this.stride() def tint_with(self, black, white): """Tint colors with modifiers for black and white.""" if not self.colorspace or self.colorspace.n > 3: message("warning: colorspace invalid for function") return return mupdf.fz_tint_pixmap( self.this, black, white) @property def w(self): """The width.""" return mupdf.fz_pixmap_width(self.this) def warp(self, quad, width, height): """Return pixmap from a warped quad.""" if not quad.is_convex: raise ValueError("quad must be convex") q = JM_quad_from_py(quad) points = [ q.ul, q.ur, q.lr, q.ll] dst = mupdf.fz_warp_pixmap( self.this, points, width, height) return Pixmap( dst) @property def x(self): """x component of Pixmap origin.""" return mupdf.fz_pixmap_x(self.this) @property def xres(self): """Resolution in x direction.""" return self.this.xres() @property def y(self): """y component of Pixmap origin.""" return mupdf.fz_pixmap_y(self.this) @property def yres(self): """Resolution in y direction.""" return self.this.yres() width = w height = h def __del__(self): if self._samples_mv: self._samples_mv.release() class Point: def __abs__(self): return math.sqrt(self.x * self.x + self.y * self.y) def __add__(self, p): if hasattr(p, "__float__"): return Point(self.x + p, self.y + p) if len(p) != 2: raise ValueError("Point: bad seq len") return Point(self.x + p[0], self.y + p[1]) def __bool__(self): return not (max(self) == min(self) == 0) def __eq__(self, p): if not hasattr(p, "__len__"): return False return len(p) == 2 and not (self - p) def __getitem__(self, i): return (self.x, self.y)[i] def __hash__(self): return hash(tuple(self)) def __init__(self, *args, x=None, y=None): ''' Point() - all zeros Point(x, y) Point(Point) - new copy Point(sequence) - from 'sequence' Explicit keyword args x, y override earlier settings if not None. ''' if not args: self.x = 0.0 self.y = 0.0 elif len(args) > 2: raise ValueError("Point: bad seq len") elif len(args) == 2: self.x = float(args[0]) self.y = float(args[1]) elif len(args) == 1: l = args[0] if isinstance(l, (mupdf.FzPoint, mupdf.fz_point)): self.x = l.x self.y = l.y else: if not hasattr(l, "__getitem__"): raise ValueError("Point: bad args") if len(l) != 2: raise ValueError("Point: bad seq len") self.x = float(l[0]) self.y = float(l[1]) else: raise ValueError("Point: bad seq len") if x is not None: self.x = x if y is not None: self.y = y def __len__(self): return 2 def __mul__(self, m): if hasattr(m, "__float__"): return Point(self.x * m, self.y * m) if hasattr(m, "__getitem__") and len(m) == 2: # dot product return self.x * m[0] + self.y * m[1] p = Point(self) return p.transform(m) def __neg__(self): return Point(-self.x, -self.y) def __nonzero__(self): return not (max(self) == min(self) == 0) def __pos__(self): return Point(self) def __repr__(self): return "Point" + str(tuple(self)) def __setitem__(self, i, v): v = float(v) if i == 0: self.x = v elif i == 1: self.y = v else: raise IndexError("index out of range") return None def __sub__(self, p): if hasattr(p, "__float__"): return Point(self.x - p, self.y - p) if len(p) != 2: raise ValueError("Point: bad seq len") return Point(self.x - p[0], self.y - p[1]) def __truediv__(self, m): if hasattr(m, "__float__"): return Point(self.x * 1./m, self.y * 1./m) m1 = util_invert_matrix(m)[1] if not m1: raise ZeroDivisionError("matrix not invertible") p = Point(self) return p.transform(m1) @property def abs_unit(self): """Unit vector with positive coordinates.""" s = self.x * self.x + self.y * self.y if s < EPSILON: return Point(0,0) s = math.sqrt(s) return Point(abs(self.x) / s, abs(self.y) / s) def distance_to(self, *args): """Return distance to rectangle or another point.""" if not len(args) > 0: raise ValueError("at least one parameter must be given") x = args[0] if len(x) == 2: x = Point(x) elif len(x) == 4: x = Rect(x) else: raise ValueError("arg1 must be point-like or rect-like") if len(args) > 1: unit = args[1] else: unit = "px" u = {"px": (1.,1.), "in": (1.,72.), "cm": (2.54, 72.), "mm": (25.4, 72.)} f = u[unit][0] / u[unit][1] if type(x) is Point: return abs(self - x) * f # from here on, x is a rectangle # as a safeguard, make a finite copy of it r = Rect(x.top_left, x.top_left) r = r | x.bottom_right if self in r: return 0.0 if self.x > r.x1: if self.y >= r.y1: return self.distance_to(r.bottom_right, unit) elif self.y <= r.y0: return self.distance_to(r.top_right, unit) else: return (self.x - r.x1) * f elif r.x0 <= self.x <= r.x1: if self.y >= r.y1: return (self.y - r.y1) * f else: return (r.y0 - self.y) * f else: if self.y >= r.y1: return self.distance_to(r.bottom_left, unit) elif self.y <= r.y0: return self.distance_to(r.top_left, unit) else: return (r.x0 - self.x) * f def transform(self, m): """Replace point by its transformation with matrix-like m.""" if len(m) != 6: raise ValueError("Matrix: bad seq len") self.x, self.y = util_transform_point(self, m) return self @property def unit(self): """Unit vector of the point.""" s = self.x * self.x + self.y * self.y if s < EPSILON: return Point(0,0) s = math.sqrt(s) return Point(self.x / s, self.y / s) __div__ = __truediv__ norm = __abs__ class Quad: def __abs__(self): if self.is_empty: return 0.0 return abs(self.ul - self.ur) * abs(self.ul - self.ll) def __add__(self, q): if hasattr(q, "__float__"): return Quad(self.ul + q, self.ur + q, self.ll + q, self.lr + q) if len(q) != 4: raise ValueError("Quad: bad seq len") return Quad(self.ul + q[0], self.ur + q[1], self.ll + q[2], self.lr + q[3]) def __bool__(self): return not self.is_empty def __contains__(self, x): try: l = x.__len__() except Exception: if g_exceptions_verbose > 1: exception_info() return False if l == 2: return util_point_in_quad(x, self) if l != 4: return False if CheckRect(x): if Rect(x).is_empty: return True return util_point_in_quad(x[:2], self) and util_point_in_quad(x[2:], self) if CheckQuad(x): for i in range(4): if not util_point_in_quad(x[i], self): return False return True return False def __eq__(self, quad): if not hasattr(quad, "__len__"): return False return len(quad) == 4 and ( self.ul == quad[0] and self.ur == quad[1] and self.ll == quad[2] and self.lr == quad[3] ) def __getitem__(self, i): return (self.ul, self.ur, self.ll, self.lr)[i] def __hash__(self): return hash(tuple(self)) def __init__(self, *args, ul=None, ur=None, ll=None, lr=None): ''' Quad() - all zero points Quad(ul, ur, ll, lr) Quad(quad) - new copy Quad(sequence) - from 'sequence' Explicit keyword args ul, ur, ll, lr override earlier settings if not None. ''' if not args: self.ul = self.ur = self.ll = self.lr = Point() elif len(args) > 4: raise ValueError("Quad: bad seq len") elif len(args) == 4: self.ul, self.ur, self.ll, self.lr = map(Point, args) elif len(args) == 1: l = args[0] if isinstance(l, mupdf.FzQuad): self.this = l self.ul, self.ur, self.ll, self.lr = Point(l.ul), Point(l.ur), Point(l.ll), Point(l.lr) elif not hasattr(l, "__getitem__"): raise ValueError("Quad: bad args") elif len(l) != 4: raise ValueError("Quad: bad seq len") else: self.ul, self.ur, self.ll, self.lr = map(Point, l) else: raise ValueError("Quad: bad args") if ul is not None: self.ul = Point(ul) if ur is not None: self.ur = Point(ur) if ll is not None: self.ll = Point(ll) if lr is not None: self.lr = Point(lr) def __len__(self): return 4 def __mul__(self, m): q = Quad(self) q = q.transform(m) return q def __neg__(self): return Quad(-self.ul, -self.ur, -self.ll, -self.lr) def __nonzero__(self): return not self.is_empty def __pos__(self): return Quad(self) def __repr__(self): return "Quad" + str(tuple(self)) def __setitem__(self, i, v): if i == 0: self.ul = Point(v) elif i == 1: self.ur = Point(v) elif i == 2: self.ll = Point(v) elif i == 3: self.lr = Point(v) else: raise IndexError("index out of range") return None def __sub__(self, q): if hasattr(q, "__float__"): return Quad(self.ul - q, self.ur - q, self.ll - q, self.lr - q) if len(q) != 4: raise ValueError("Quad: bad seq len") return Quad(self.ul - q[0], self.ur - q[1], self.ll - q[2], self.lr - q[3]) def __truediv__(self, m): if hasattr(m, "__float__"): im = 1. / m else: im = util_invert_matrix(m)[1] if not im: raise ZeroDivisionError("Matrix not invertible") q = Quad(self) q = q.transform(im) return q @property def is_convex(self): """Check if quad is convex and not degenerate. Notes: Check that for the two diagonals, the other two corners are not on the same side of the diagonal. Returns: True or False. """ m = planish_line(self.ul, self.lr) # puts this diagonal on x-axis p1 = self.ll * m # transform the p2 = self.ur * m # other two points if p1.y * p2.y > 0: return False m = planish_line(self.ll, self.ur) # puts other diagonal on x-axis p1 = self.lr * m # transform the p2 = self.ul * m # remaining points if p1.y * p2.y > 0: return False return True @property def is_empty(self): """Check whether all quad corners are on the same line. This is the case if width or height is zero. """ return self.width < EPSILON or self.height < EPSILON @property def is_infinite(self): """Check whether this is the infinite quad.""" return self.rect.is_infinite @property def is_rectangular(self): """Check if quad is rectangular. Notes: Some rotation matrix can thus transform it into a rectangle. This is equivalent to three corners enclose 90 degrees. Returns: True or False. """ sine = util_sine_between(self.ul, self.ur, self.lr) if abs(sine - 1) > EPSILON: # the sine of the angle return False sine = util_sine_between(self.ur, self.lr, self.ll) if abs(sine - 1) > EPSILON: return False sine = util_sine_between(self.lr, self.ll, self.ul) if abs(sine - 1) > EPSILON: return False return True def morph(self, p, m): """Morph the quad with matrix-like 'm' and point-like 'p'. Return a new quad.""" if self.is_infinite: return INFINITE_QUAD() delta = Matrix(1, 1).pretranslate(p.x, p.y) q = self * ~delta * m * delta return q @property def rect(self): r = Rect() r.x0 = min(self.ul.x, self.ur.x, self.lr.x, self.ll.x) r.y0 = min(self.ul.y, self.ur.y, self.lr.y, self.ll.y) r.x1 = max(self.ul.x, self.ur.x, self.lr.x, self.ll.x) r.y1 = max(self.ul.y, self.ur.y, self.lr.y, self.ll.y) return r def transform(self, m): """Replace quad by its transformation with matrix m.""" if hasattr(m, "__float__"): pass elif len(m) != 6: raise ValueError("Matrix: bad seq len") self.ul *= m self.ur *= m self.ll *= m self.lr *= m return self __div__ = __truediv__ width = property(lambda self: max(abs(self.ul - self.ur), abs(self.ll - self.lr))) height = property(lambda self: max(abs(self.ul - self.ll), abs(self.ur - self.lr))) class Rect: def __abs__(self): if self.is_empty or self.is_infinite: return 0.0 return (self.x1 - self.x0) * (self.y1 - self.y0) def __add__(self, p): if hasattr(p, "__float__"): return Rect(self.x0 + p, self.y0 + p, self.x1 + p, self.y1 + p) if len(p) != 4: raise ValueError("Rect: bad seq len") return Rect(self.x0 + p[0], self.y0 + p[1], self.x1 + p[2], self.y1 + p[3]) def __and__(self, x): if not hasattr(x, "__len__"): raise ValueError("bad operand 2") r1 = Rect(x) r = Rect(self) return r.intersect(r1) def __bool__(self): return not (max(self) == min(self) == 0) def __contains__(self, x): if hasattr(x, "__float__"): return x in tuple(self) l = len(x) if l == 2: return util_is_point_in_rect(x, self) if l == 4: r = INFINITE_RECT() try: r = Rect(x) except Exception: if g_exceptions_verbose > 1: exception_info() r = Quad(x).rect return (self.x0 <= r.x0 <= r.x1 <= self.x1 and self.y0 <= r.y0 <= r.y1 <= self.y1) return False def __eq__(self, rect): if not hasattr(rect, "__len__"): return False return len(rect) == 4 and not (self - rect) def __getitem__(self, i): return (self.x0, self.y0, self.x1, self.y1)[i] def __hash__(self): return hash(tuple(self)) def __init__(self, *args, p0=None, p1=None, x0=None, y0=None, x1=None, y1=None): """ Rect() - all zeros Rect(x0, y0, x1, y1) Rect(top-left, x1, y1) Rect(x0, y0, bottom-right) Rect(top-left, bottom-right) Rect(Rect or IRect) - new copy Rect(sequence) - from 'sequence' Explicit keyword args p0, p1, x0, y0, x1, y1 override earlier settings if not None. """ x0, y0, x1, y1 = util_make_rect( *args, p0=p0, p1=p1, x0=x0, y0=y0, x1=x1, y1=y1) self.x0 = float( x0) self.y0 = float( y0) self.x1 = float( x1) self.y1 = float( y1) def __len__(self): return 4 def __mul__(self, m): if hasattr(m, "__float__"): return Rect(self.x0 * m, self.y0 * m, self.x1 * m, self.y1 * m) r = Rect(self) r = r.transform(m) return r def __neg__(self): return Rect(-self.x0, -self.y0, -self.x1, -self.y1) def __nonzero__(self): return not (max(self) == min(self) == 0) def __or__(self, x): if not hasattr(x, "__len__"): raise ValueError("bad operand 2") r = Rect(self) if len(x) == 2: return r.include_point(x) if len(x) == 4: return r.include_rect(x) raise ValueError("bad operand 2") def __pos__(self): return Rect(self) def __repr__(self): return "Rect" + str(tuple(self)) def __setitem__(self, i, v): v = float(v) if i == 0: self.x0 = v elif i == 1: self.y0 = v elif i == 2: self.x1 = v elif i == 3: self.y1 = v else: raise IndexError("index out of range") return None def __sub__(self, p): if hasattr(p, "__float__"): return Rect(self.x0 - p, self.y0 - p, self.x1 - p, self.y1 - p) if len(p) != 4: raise ValueError("Rect: bad seq len") return Rect(self.x0 - p[0], self.y0 - p[1], self.x1 - p[2], self.y1 - p[3]) def __truediv__(self, m): if hasattr(m, "__float__"): return Rect(self.x0 * 1./m, self.y0 * 1./m, self.x1 * 1./m, self.y1 * 1./m) im = util_invert_matrix(m)[1] if not im: raise ZeroDivisionError(f"Matrix not invertible: {m}") r = Rect(self) r = r.transform(im) return r @property def bottom_left(self): """Bottom-left corner.""" return Point(self.x0, self.y1) @property def bottom_right(self): """Bottom-right corner.""" return Point(self.x1, self.y1) def contains(self, x): """Check if containing point-like or rect-like x.""" return self.__contains__(x) @property def height(self): return max(0, self.y1 - self.y0) def get_area(self, *args) -> float: """Calculate area of rectangle.\nparameter is one of 'px' (default), 'in', 'cm', or 'mm'.""" return _rect_area(self.width, self.height, args) def include_point(self, p): """Extend to include point-like p.""" if len(p) != 2: raise ValueError("Point: bad seq len") self.x0, self.y0, self.x1, self.y1 = util_include_point_in_rect(self, p) return self def include_rect(self, r): """Extend to include rect-like r.""" if len(r) != 4: raise ValueError("Rect: bad seq len") r = Rect(r) if r.is_infinite or self.is_infinite: self.x0, self.y0, self.x1, self.y1 = FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT elif r.is_empty: return self elif self.is_empty: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 else: self.x0, self.y0, self.x1, self.y1 = util_union_rect(self, r) return self def intersect(self, r): """Restrict to common rect with rect-like r.""" if not len(r) == 4: raise ValueError("Rect: bad seq len") r = Rect(r) if r.is_infinite: return self elif self.is_infinite: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 elif r.is_empty: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 elif self.is_empty: return self else: self.x0, self.y0, self.x1, self.y1 = util_intersect_rect(self, r) return self def intersects(self, x): """Check if intersection with rectangle x is not empty.""" rect2 = Rect(x) return (1 and not self.is_empty and not self.is_infinite and not rect2.is_empty and not rect2.is_infinite and self.x0 < rect2.x1 and rect2.x0 < self.x1 and self.y0 < rect2.y1 and rect2.y0 < self.y1 ) @property def is_empty(self): """True if rectangle area is empty.""" return self.x0 >= self.x1 or self.y0 >= self.y1 @property def is_infinite(self): """True if this is the infinite rectangle.""" return self.x0 == self.y0 == FZ_MIN_INF_RECT and self.x1 == self.y1 == FZ_MAX_INF_RECT @property def is_valid(self): """True if rectangle is valid.""" return self.x0 <= self.x1 and self.y0 <= self.y1 def morph(self, p, m): """Morph with matrix-like m and point-like p. Returns a new quad.""" if self.is_infinite: return INFINITE_QUAD() return self.quad.morph(p, m) def norm(self): return math.sqrt(sum([c*c for c in self])) def normalize(self): """Replace rectangle with its finite version.""" if self.x1 < self.x0: self.x0, self.x1 = self.x1, self.x0 if self.y1 < self.y0: self.y0, self.y1 = self.y1, self.y0 return self @property def quad(self): """Return Quad version of rectangle.""" return Quad(self.tl, self.tr, self.bl, self.br) def round(self): """Return the IRect.""" return IRect(util_round_rect(self)) @property def top_left(self): """Top-left corner.""" return Point(self.x0, self.y0) @property def top_right(self): """Top-right corner.""" return Point(self.x1, self.y0) def torect(self, r): """Return matrix that converts to target rect.""" r = Rect(r) if self.is_infinite or self.is_empty or r.is_infinite or r.is_empty: raise ValueError("rectangles must be finite and not empty") return ( Matrix(1, 0, 0, 1, -self.x0, -self.y0) * Matrix(r.width / self.width, r.height / self.height) * Matrix(1, 0, 0, 1, r.x0, r.y0) ) def transform(self, m): """Replace with the transformation by matrix-like m.""" if not len(m) == 6: raise ValueError("Matrix: bad seq len") self.x0, self.y0, self.x1, self.y1 = util_transform_rect(self, m) return self @property def width(self): return max(0, self.x1 - self.x0) __div__ = __truediv__ bl = bottom_left br = bottom_right irect = property(round) tl = top_left tr = top_right class Shape: """Create a new shape.""" @staticmethod def horizontal_angle(C, P): """Return the angle to the horizontal for the connection from C to P. This uses the arcus sine function and resolves its inherent ambiguity by looking up in which quadrant vector S = P - C is located. """ S = Point(P - C).unit # unit vector 'C' -> 'P' alfa = math.asin(abs(S.y)) # absolute angle from horizontal if S.x < 0: # make arcsin result unique if S.y <= 0: # bottom-left alfa = -(math.pi - alfa) else: # top-left alfa = math.pi - alfa else: if S.y >= 0: # top-right pass else: # bottom-right alfa = -alfa return alfa def __init__(self, page: Page): CheckParent(page) self.page = page self.doc = page.parent if not self.doc.is_pdf: raise ValueError("is no PDF") self.height = page.mediabox_size.y self.width = page.mediabox_size.x self.x = page.cropbox_position.x self.y = page.cropbox_position.y self.pctm = page.transformation_matrix # page transf. matrix self.ipctm = ~self.pctm # inverted transf. matrix self.draw_cont = "" self.text_cont = "" self.totalcont = "" self.last_point = None self.rect = None def updateRect(self, x): if self.rect is None: if len(x) == 2: self.rect = Rect(x, x) else: self.rect = Rect(x) else: if len(x) == 2: x = Point(x) self.rect.x0 = min(self.rect.x0, x.x) self.rect.y0 = min(self.rect.y0, x.y) self.rect.x1 = max(self.rect.x1, x.x) self.rect.y1 = max(self.rect.y1, x.y) else: x = Rect(x) self.rect.x0 = min(self.rect.x0, x.x0) self.rect.y0 = min(self.rect.y0, x.y0) self.rect.x1 = max(self.rect.x1, x.x1) self.rect.y1 = max(self.rect.y1, x.y1) def draw_line(self, p1: point_like, p2: point_like) -> Point: """Draw a line between two points.""" p1 = Point(p1) p2 = Point(p2) if not (self.last_point == p1): self.draw_cont += _format_g(JM_TUPLE(p1 * self.ipctm)) + " m\n" self.last_point = p1 self.updateRect(p1) self.draw_cont += _format_g(JM_TUPLE(p2 * self.ipctm)) + " l\n" self.updateRect(p2) self.last_point = p2 return self.last_point def draw_polyline(self, points: list) -> Point: """Draw several connected line segments.""" for i, p in enumerate(points): if i == 0: if not (self.last_point == Point(p)): self.draw_cont += _format_g(JM_TUPLE(Point(p) * self.ipctm)) + " m\n" self.last_point = Point(p) else: self.draw_cont += _format_g(JM_TUPLE(Point(p) * self.ipctm)) + " l\n" self.updateRect(p) self.last_point = Point(points[-1]) return self.last_point def draw_bezier( self, p1: point_like, p2: point_like, p3: point_like, p4: point_like, ) -> Point: """Draw a standard cubic Bezier curve.""" p1 = Point(p1) p2 = Point(p2) p3 = Point(p3) p4 = Point(p4) if not (self.last_point == p1): self.draw_cont += _format_g(JM_TUPLE(p1 * self.ipctm)) + " m\n" args = JM_TUPLE(list(p2 * self.ipctm) + list(p3 * self.ipctm) + list(p4 * self.ipctm)) self.draw_cont += _format_g(args) + " c\n" self.updateRect(p1) self.updateRect(p2) self.updateRect(p3) self.updateRect(p4) self.last_point = p4 return self.last_point def draw_oval(self, tetra: typing.Union[quad_like, rect_like]) -> Point: """Draw an ellipse inside a tetrapod.""" if len(tetra) != 4: raise ValueError("invalid arg length") if hasattr(tetra[0], "__float__"): q = Rect(tetra).quad else: q = Quad(tetra) mt = q.ul + (q.ur - q.ul) * 0.5 mr = q.ur + (q.lr - q.ur) * 0.5 mb = q.ll + (q.lr - q.ll) * 0.5 ml = q.ul + (q.ll - q.ul) * 0.5 if not (self.last_point == ml): self.draw_cont += _format_g(JM_TUPLE(ml * self.ipctm)) + " m\n" self.last_point = ml self.draw_curve(ml, q.ll, mb) self.draw_curve(mb, q.lr, mr) self.draw_curve(mr, q.ur, mt) self.draw_curve(mt, q.ul, ml) self.updateRect(q.rect) self.last_point = ml return self.last_point def draw_circle(self, center: point_like, radius: float) -> Point: """Draw a circle given its center and radius.""" if not radius > EPSILON: raise ValueError("radius must be positive") center = Point(center) p1 = center - (radius, 0) return self.draw_sector(center, p1, 360, fullSector=False) def draw_curve( self, p1: point_like, p2: point_like, p3: point_like, ) -> Point: """Draw a curve between points using one control point.""" kappa = 0.55228474983 p1 = Point(p1) p2 = Point(p2) p3 = Point(p3) k1 = p1 + (p2 - p1) * kappa k2 = p3 + (p2 - p3) * kappa return self.draw_bezier(p1, k1, k2, p3) def draw_sector( self, center: point_like, point: point_like, beta: float, fullSector: bool = True, ) -> Point: """Draw a circle sector.""" center = Point(center) point = Point(point) l3 = lambda a, b: _format_g((a, b)) + " m\n" l4 = lambda a, b, c, d, e, f: _format_g((a, b, c, d, e, f)) + " c\n" l5 = lambda a, b: _format_g((a, b)) + " l\n" betar = math.radians(-beta) w360 = math.radians(math.copysign(360, betar)) * (-1) w90 = math.radians(math.copysign(90, betar)) w45 = w90 / 2 while abs(betar) > 2 * math.pi: betar += w360 # bring angle below 360 degrees if not (self.last_point == point): self.draw_cont += l3(*JM_TUPLE(point * self.ipctm)) self.last_point = point Q = Point(0, 0) # just make sure it exists C = center P = point S = P - C # vector 'center' -> 'point' rad = abs(S) # circle radius if not rad > EPSILON: raise ValueError("radius must be positive") alfa = self.horizontal_angle(center, point) while abs(betar) > abs(w90): # draw 90 degree arcs q1 = C.x + math.cos(alfa + w90) * rad q2 = C.y + math.sin(alfa + w90) * rad Q = Point(q1, q2) # the arc's end point r1 = C.x + math.cos(alfa + w45) * rad / math.cos(w45) r2 = C.y + math.sin(alfa + w45) * rad / math.cos(w45) R = Point(r1, r2) # crossing point of tangents kappah = (1 - math.cos(w45)) * 4 / 3 / abs(R - Q) kappa = kappah * abs(P - Q) cp1 = P + (R - P) * kappa # control point 1 cp2 = Q + (R - Q) * kappa # control point 2 self.draw_cont += l4(*JM_TUPLE( list(cp1 * self.ipctm) + list(cp2 * self.ipctm) + list(Q * self.ipctm) )) betar -= w90 # reduce param angle by 90 deg alfa += w90 # advance start angle by 90 deg P = Q # advance to arc end point # draw (remaining) arc if abs(betar) > 1e-3: # significant degrees left? beta2 = betar / 2 q1 = C.x + math.cos(alfa + betar) * rad q2 = C.y + math.sin(alfa + betar) * rad Q = Point(q1, q2) # the arc's end point r1 = C.x + math.cos(alfa + beta2) * rad / math.cos(beta2) r2 = C.y + math.sin(alfa + beta2) * rad / math.cos(beta2) R = Point(r1, r2) # crossing point of tangents # kappa height is 4/3 of segment height kappah = (1 - math.cos(beta2)) * 4 / 3 / abs(R - Q) # kappa height kappa = kappah * abs(P - Q) / (1 - math.cos(betar)) cp1 = P + (R - P) * kappa # control point 1 cp2 = Q + (R - Q) * kappa # control point 2 self.draw_cont += l4(*JM_TUPLE( list(cp1 * self.ipctm) + list(cp2 * self.ipctm) + list(Q * self.ipctm) )) if fullSector: self.draw_cont += l3(*JM_TUPLE(point * self.ipctm)) self.draw_cont += l5(*JM_TUPLE(center * self.ipctm)) self.draw_cont += l5(*JM_TUPLE(Q * self.ipctm)) self.last_point = Q return self.last_point def draw_rect(self, rect: rect_like, *, radius=None) -> Point: """Draw a rectangle. Args: radius: if not None, the rectangle will have rounded corners. This is the radius of the curvature, given as percentage of the rectangle width or height. Valid are values 0 < v <= 0.5. For a sequence of two values, the corners will have different radii. Otherwise, the percentage will be computed from the shorter side. A value of (0.5, 0.5) will draw an ellipse. """ r = Rect(rect) if radius is None: # standard rectangle self.draw_cont += _format_g(JM_TUPLE( list(r.bl * self.ipctm) + [r.width, r.height] )) + " re\n" self.updateRect(r) self.last_point = r.tl return self.last_point # rounded corners requested. This requires 1 or 2 values, each # with 0 < value <= 0.5 if hasattr(radius, "__float__"): if radius <= 0 or radius > 0.5: raise ValueError(f"bad radius value {radius}.") d = min(r.width, r.height) * radius px = (d, 0) py = (0, d) elif hasattr(radius, "__len__") and len(radius) == 2: rx, ry = radius px = (rx * r.width, 0) py = (0, ry * r.height) if min(rx, ry) <= 0 or max(rx, ry) > 0.5: raise ValueError(f"bad radius value {radius}.") else: raise ValueError(f"bad radius value {radius}.") lp = self.draw_line(r.tl + py, r.bl - py) lp = self.draw_curve(lp, r.bl, r.bl + px) lp = self.draw_line(lp, r.br - px) lp = self.draw_curve(lp, r.br, r.br - py) lp = self.draw_line(lp, r.tr + py) lp = self.draw_curve(lp, r.tr, r.tr - px) lp = self.draw_line(lp, r.tl + px) self.last_point = self.draw_curve(lp, r.tl, r.tl + py) self.updateRect(r) return self.last_point def draw_quad(self, quad: quad_like) -> Point: """Draw a Quad.""" q = Quad(quad) return self.draw_polyline([q.ul, q.ll, q.lr, q.ur, q.ul]) def draw_zigzag( self, p1: point_like, p2: point_like, breadth: float = 2, ) -> Point: """Draw a zig-zagged line from p1 to p2.""" p1 = Point(p1) p2 = Point(p2) S = p2 - p1 # vector start - end rad = abs(S) # distance of points cnt = 4 * int(round(rad / (4 * breadth), 0)) # always take full phases if cnt < 4: raise ValueError("points too close") mb = rad / cnt # revised breadth matrix = Matrix(util_hor_matrix(p1, p2)) # normalize line to x-axis i_mat = ~matrix # get original position points = [] # stores edges for i in range(1, cnt): if i % 4 == 1: # point "above" connection p = Point(i, -1) * mb elif i % 4 == 3: # point "below" connection p = Point(i, 1) * mb else: # ignore others continue points.append(p * i_mat) self.draw_polyline([p1] + points + [p2]) # add start and end points return p2 def draw_squiggle( self, p1: point_like, p2: point_like, breadth=2, ) -> Point: """Draw a squiggly line from p1 to p2.""" p1 = Point(p1) p2 = Point(p2) S = p2 - p1 # vector start - end rad = abs(S) # distance of points cnt = 4 * int(round(rad / (4 * breadth), 0)) # always take full phases if cnt < 4: raise ValueError("points too close") mb = rad / cnt # revised breadth matrix = Matrix(util_hor_matrix(p1, p2)) # normalize line to x-axis i_mat = ~matrix # get original position k = 2.4142135623765633 # y of draw_curve helper point points = [] # stores edges for i in range(1, cnt): if i % 4 == 1: # point "above" connection p = Point(i, -k) * mb elif i % 4 == 3: # point "below" connection p = Point(i, k) * mb else: # else on connection line p = Point(i, 0) * mb points.append(p * i_mat) points = [p1] + points + [p2] cnt = len(points) i = 0 while i + 2 < cnt: self.draw_curve(points[i], points[i + 1], points[i + 2]) i += 2 return p2 # ============================================================================== # Shape.insert_text # ============================================================================== def insert_text( self, point: point_like, buffer: typing.Union[str, list], *, fontsize: float = 11, lineheight: OptFloat = None, fontname: str = "helv", fontfile: OptStr = None, set_simple: bool = 0, encoding: int = 0, color: OptSeq = None, fill: OptSeq = None, render_mode: int = 0, border_width: float = 0.05, miter_limit: float = 1, rotate: int = 0, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> int: # ensure 'text' is a list of strings, worth dealing with if not bool(buffer): return 0 if type(buffer) not in (list, tuple): text = buffer.splitlines() else: text = buffer if not len(text) > 0: return 0 point = Point(point) try: maxcode = max([ord(c) for c in " ".join(text)]) except Exception: exception_info() return 0 # ensure valid 'fontname' fname = fontname if fname.startswith("/"): fname = fname[1:] xref = self.page.insert_font( fontname=fname, fontfile=fontfile, encoding=encoding, set_simple=set_simple ) fontinfo = CheckFontInfo(self.doc, xref) fontdict = fontinfo[1] ordering = fontdict["ordering"] simple = fontdict["simple"] bfname = fontdict["name"] ascender = fontdict["ascender"] descender = fontdict["descender"] if lineheight: lheight = fontsize * lineheight elif ascender - descender <= 1: lheight = fontsize * 1.2 else: lheight = fontsize * (ascender - descender) if maxcode > 255: glyphs = self.doc.get_char_widths(xref, maxcode + 1) else: glyphs = fontdict["glyphs"] tab = [] for t in text: if simple and bfname not in ("Symbol", "ZapfDingbats"): g = None else: g = glyphs tab.append(getTJstr(t, g, simple, ordering)) text = tab color_str = ColorCode(color, "c") fill_str = ColorCode(fill, "f") if not fill and render_mode == 0: # ensure fill color when 0 Tr fill = color fill_str = ColorCode(color, "f") morphing = CheckMorph(morph) rot = rotate if rot % 90 != 0: raise ValueError("bad rotate value") while rot < 0: rot += 360 rot = rot % 360 # text rotate = 0, 90, 270, 180 templ1 = lambda a, b, c, d, e, f, g: f"\nq\n{a}{b}BT\n{c}1 0 0 1 {_format_g((d, e))} Tm\n/{f} {_format_g(g)} Tf " templ2 = lambda a: f"TJ\n0 -{_format_g(a)} TD\n" cmp90 = "0 1 -1 0 0 0 cm\n" # rotates 90 deg counter-clockwise cmm90 = "0 -1 1 0 0 0 cm\n" # rotates 90 deg clockwise cm180 = "-1 0 0 -1 0 0 cm\n" # rotates by 180 deg. height = self.height width = self.width # setting up for standard rotation directions # case rotate = 0 if morphing: m1 = Matrix(1, 0, 0, 1, morph[0].x + self.x, height - morph[0].y - self.y) mat = ~m1 * morph[1] * m1 cm = _format_g(JM_TUPLE(mat)) + " cm\n" else: cm = "" top = height - point.y - self.y # start of 1st char left = point.x + self.x # start of 1. char space = top # space available #headroom = point.y + self.y # distance to page border if rot == 90: left = height - point.y - self.y top = -point.x - self.x cm += cmp90 space = width - abs(top) #headroom = point.x + self.x elif rot == 270: left = -height + point.y + self.y top = point.x + self.x cm += cmm90 space = abs(top) #headroom = width - point.x - self.x elif rot == 180: left = -point.x - self.x top = -height + point.y + self.y cm += cm180 space = abs(point.y + self.y) #headroom = height - point.y - self.y optcont = self.page._get_optional_content(oc) if optcont is not None: bdc = f"/OC /{optcont} BDC\n" emc = "EMC\n" else: bdc = emc = "" alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha is None: alpha = "" else: alpha = f"/{alpha} gs\n" nres = templ1(bdc, alpha, cm, left, top, fname, fontsize) if render_mode > 0: nres += f"{render_mode} Tr " nres += _format_g(border_width * fontsize) + " w " if miter_limit is not None: nres += _format_g(miter_limit) + " M " if color is not None: nres += color_str if fill is not None: nres += fill_str # ========================================================================= # start text insertion # ========================================================================= nres += text[0] nlines = 1 # set output line counter if len(text) > 1: nres += templ2(lheight) # line 1 else: nres += 'TJ' for i in range(1, len(text)): if space < lheight: break # no space left on page if i > 1: nres += "\nT* " nres += text[i] + 'TJ' space -= lheight nlines += 1 nres += f"\nET\n{emc}Q\n" # ========================================================================= # end of text insertion # ========================================================================= # update the /Contents object self.text_cont += nres return nlines # ============================================================================== # Shape.insert_textbox # ============================================================================== def insert_textbox( self, rect: rect_like, buffer: typing.Union[str, list], *, align: int = 0, border_width: float = 0.05, color: OptSeq = None, encoding: int = 0, expandtabs: int = 1, fill_opacity: float = 1, fill: OptSeq = None, fontfile: OptStr = None, fontname: OptStr = "helv", fontsize: float = 11, lineheight: OptFloat = None, miter_limit: float = 1, morph: OptSeq = None, oc: int = 0, render_mode: int = 0, rotate: int = 0, set_simple: bool = 0, stroke_opacity: float = 1, ) -> float: """Insert text into a given rectangle. Args: rect -- the textbox to fill buffer -- text to be inserted fontname -- a Base-14 font, font name or '/name' fontfile -- name of a font file fontsize -- font size lineheight -- overwrite the font property color -- RGB stroke color triple fill -- RGB fill color triple render_mode -- text rendering control border_width -- thickness of glyph borders as percentage of fontsize expandtabs -- handles tabulators with string function align -- left, center, right, justified rotate -- 0, 90, 180, or 270 degrees morph -- morph box with a matrix and a fixpoint Returns: unused or deficit rectangle area (float) """ rect = Rect(rect) if rect.is_empty or rect.is_infinite: raise ValueError("text box must be finite and not empty") color_str = ColorCode(color, "c") fill_str = ColorCode(fill, "f") if fill is None and render_mode == 0: # ensure fill color for 0 Tr fill = color fill_str = ColorCode(color, "f") optcont = self.page._get_optional_content(oc) if optcont is not None: bdc = f"/OC /{optcont} BDC\n" emc = "EMC\n" else: bdc = emc = "" # determine opacity / transparency alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha is None: alpha = "" else: alpha = f"/{alpha} gs\n" if rotate % 90 != 0: raise ValueError("rotate must be multiple of 90") rot = rotate while rot < 0: rot += 360 rot = rot % 360 # is buffer worth of dealing with? if not bool(buffer): return rect.height if rot in (0, 180) else rect.width cmp90 = "0 1 -1 0 0 0 cm\n" # rotates counter-clockwise cmm90 = "0 -1 1 0 0 0 cm\n" # rotates clockwise cm180 = "-1 0 0 -1 0 0 cm\n" # rotates by 180 deg. height = self.height fname = fontname if fname.startswith("/"): fname = fname[1:] xref = self.page.insert_font( fontname=fname, fontfile=fontfile, encoding=encoding, set_simple=set_simple ) fontinfo = CheckFontInfo(self.doc, xref) fontdict = fontinfo[1] ordering = fontdict["ordering"] simple = fontdict["simple"] glyphs = fontdict["glyphs"] bfname = fontdict["name"] ascender = fontdict["ascender"] descender = fontdict["descender"] if lineheight: lheight_factor = lineheight elif ascender - descender <= 1: lheight_factor = 1.2 else: lheight_factor = ascender - descender lheight = fontsize * lheight_factor # create a list from buffer, split into its lines if type(buffer) in (list, tuple): t0 = "\n".join(buffer) else: t0 = buffer maxcode = max([ord(c) for c in t0]) # replace invalid char codes for simple fonts if simple and maxcode > 255: t0 = "".join([c if ord(c) < 256 else "?" for c in t0]) t0 = t0.splitlines() glyphs = self.doc.get_char_widths(xref, maxcode + 1) if simple and bfname not in ("Symbol", "ZapfDingbats"): tj_glyphs = None else: tj_glyphs = glyphs # ---------------------------------------------------------------------- # calculate pixel length of a string # ---------------------------------------------------------------------- def pixlen(x): """Calculate pixel length of x.""" if ordering < 0: return sum([glyphs[ord(c)][1] for c in x]) * fontsize else: return len(x) * fontsize # --------------------------------------------------------------------- if ordering < 0: blen = glyphs[32][1] * fontsize # pixel size of space character else: blen = fontsize text = "" # output buffer if CheckMorph(morph): m1 = Matrix( 1, 0, 0, 1, morph[0].x + self.x, self.height - morph[0].y - self.y ) mat = ~m1 * morph[1] * m1 cm = _format_g(JM_TUPLE(mat)) + " cm\n" else: cm = "" # --------------------------------------------------------------------- # adjust for text orientation / rotation # --------------------------------------------------------------------- progr = 1 # direction of line progress c_pnt = Point(0, fontsize * ascender) # used for line progress if rot == 0: # normal orientation point = rect.tl + c_pnt # line 1 is 'lheight' below top maxwidth = rect.width # pixels available in one line maxheight = rect.height # available text height elif rot == 90: # rotate counter clockwise c_pnt = Point(fontsize * ascender, 0) # progress in x-direction point = rect.bl + c_pnt # line 1 'lheight' away from left maxwidth = rect.height # pixels available in one line maxheight = rect.width # available text height cm += cmp90 elif rot == 180: # text upside down # progress upwards in y direction c_pnt = -Point(0, fontsize * ascender) point = rect.br + c_pnt # line 1 'lheight' above bottom maxwidth = rect.width # pixels available in one line progr = -1 # subtract lheight for next line maxheight =rect.height # available text height cm += cm180 else: # rotate clockwise (270 or -90) # progress from right to left c_pnt = -Point(fontsize * ascender, 0) point = rect.tr + c_pnt # line 1 'lheight' left of right maxwidth = rect.height # pixels available in one line progr = -1 # subtract lheight for next line maxheight = rect.width # available text height cm += cmm90 # ===================================================================== # line loop # ===================================================================== just_tab = [] # 'justify' indicators per line for i, line in enumerate(t0): line_t = line.expandtabs(expandtabs).split(" ") # split into words num_words = len(line_t) lbuff = "" # init line buffer rest = maxwidth # available line pixels # ================================================================= # word loop # ================================================================= for j in range(num_words): word = line_t[j] pl_w = pixlen(word) # pixel len of word if rest >= pl_w: # does it fit on the line? lbuff += word + " " # yes, append word rest -= pl_w + blen # update available line space continue # next word # word doesn't fit - output line (if not empty) if lbuff: lbuff = lbuff.rstrip() + "\n" # line full, append line break text += lbuff # append to total text just_tab.append(True) # can align-justify lbuff = "" # re-init line buffer rest = maxwidth # re-init avail. space if pl_w <= maxwidth: # word shorter than 1 line? lbuff = word + " " # start the line with it rest = maxwidth - pl_w - blen # update free space continue # long word: split across multiple lines - char by char ... if len(just_tab) > 0: just_tab[-1] = False # cannot align-justify for c in word: if pixlen(lbuff) <= maxwidth - pixlen(c): lbuff += c else: # line full lbuff += "\n" # close line text += lbuff # append to text just_tab.append(False) # cannot align-justify lbuff = c # start new line with this char lbuff += " " # finish long word rest = maxwidth - pixlen(lbuff) # long word stored if lbuff: # unprocessed line content? text += lbuff.rstrip() # append to text just_tab.append(False) # cannot align-justify if i < len(t0) - 1: # not the last line? text += "\n" # insert line break # compute used part of the textbox if text.endswith("\n"): text = text[:-1] lb_count = text.count("\n") + 1 # number of lines written # text height = line count * line height plus one descender value text_height = lheight * lb_count - descender * fontsize more = text_height - maxheight # difference to height limit if more > EPSILON: # landed too much outside rect return (-1) * more # return deficit, don't output more = abs(more) if more < EPSILON: more = 0 # don't bother with epsilons nres = f"\nq\n{bdc}{alpha}BT\n" + cm # initialize output buffer templ = lambda a, b, c, d: f"1 0 0 1 {_format_g((a, b))} Tm /{c} {_format_g(d)} Tf " # center, right, justify: output each line with its own specifics text_t = text.splitlines() # split text in lines again just_tab[-1] = False # never justify last line for i, t in enumerate(text_t): spacing = 0 pl = maxwidth - pixlen(t) # length of empty line part pnt = point + c_pnt * (i * lheight_factor) # text start of line if align == 1: # center: right shift by half width if rot in (0, 180): pnt = pnt + Point(pl / 2, 0) * progr else: pnt = pnt - Point(0, pl / 2) * progr elif align == 2: # right: right shift by full width if rot in (0, 180): pnt = pnt + Point(pl, 0) * progr else: pnt = pnt - Point(0, pl) * progr elif align == 3: # justify spaces = t.count(" ") # number of spaces in line if spaces > 0 and just_tab[i]: # if any, and we may justify spacing = pl / spaces # make every space this much larger else: spacing = 0 # keep normal space length top = height - pnt.y - self.y left = pnt.x + self.x if rot == 90: left = height - pnt.y - self.y top = -pnt.x - self.x elif rot == 270: left = -height + pnt.y + self.y top = pnt.x + self.x elif rot == 180: left = -pnt.x - self.x top = -height + pnt.y + self.y nres += templ(left, top, fname, fontsize) if render_mode > 0: nres += f"{render_mode} Tr " nres += _format_g(border_width * fontsize) + " w " if miter_limit is not None: nres += _format_g(miter_limit) + " M " if align == 3: nres += _format_g(spacing) + " Tw " if color is not None: nres += color_str if fill is not None: nres += fill_str nres += f"{getTJstr(t, tj_glyphs, simple, ordering)}TJ\n" nres += f"ET\n{emc}Q\n" self.text_cont += nres self.updateRect(rect) return more def finish( self, width: float = 1, color: OptSeq = (0,), fill: OptSeq = None, lineCap: int = 0, lineJoin: int = 0, dashes: OptStr = None, even_odd: bool = False, morph: OptSeq = None, closePath: bool = True, fill_opacity: float = 1, stroke_opacity: float = 1, oc: int = 0, ) -> None: """Finish the current drawing segment. Notes: Apply colors, opacity, dashes, line style and width, or morphing. Also whether to close the path by connecting last to first point. """ if self.draw_cont == "": # treat empty contents as no-op return if width == 0: # border color makes no sense then color = None elif color is None: # vice versa width = 0 # if color == None and fill == None: # raise ValueError("at least one of 'color' or 'fill' must be given") color_str = ColorCode(color, "c") # ensure proper color string fill_str = ColorCode(fill, "f") # ensure proper fill string optcont = self.page._get_optional_content(oc) if optcont is not None: self.draw_cont = f"/OC /{optcont} BDC\n" + self.draw_cont emc = "EMC\n" else: emc = "" alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha is not None: self.draw_cont = f"/{alpha} gs\n" + self.draw_cont if width != 1 and width != 0: self.draw_cont += _format_g(width) + " w\n" if lineCap != 0: self.draw_cont = f"{lineCap} J\n" + self.draw_cont if lineJoin != 0: self.draw_cont = f"{lineJoin} j\n" + self.draw_cont if dashes not in (None, "", "[] 0"): self.draw_cont = f"{dashes} d\n" + self.draw_cont if closePath: self.draw_cont += "h\n" self.last_point = None if color is not None: self.draw_cont += color_str if fill is not None: self.draw_cont += fill_str if color is not None: if not even_odd: self.draw_cont += "B\n" else: self.draw_cont += "B*\n" else: if not even_odd: self.draw_cont += "f\n" else: self.draw_cont += "f*\n" else: self.draw_cont += "S\n" self.draw_cont += emc if CheckMorph(morph): m1 = Matrix( 1, 0, 0, 1, morph[0].x + self.x, self.height - morph[0].y - self.y ) mat = ~m1 * morph[1] * m1 self.draw_cont = _format_g(JM_TUPLE(mat)) + " cm\n" + self.draw_cont self.totalcont += "\nq\n" + self.draw_cont + "Q\n" self.draw_cont = "" self.last_point = None return def commit(self, overlay: bool = True) -> None: """Update the page's /Contents object with Shape data. The argument controls whether data appear in foreground (default) or background. """ CheckParent(self.page) # doc may have died meanwhile self.totalcont += self.text_cont self.totalcont = self.totalcont.encode() if self.totalcont: if overlay: self.page.wrap_contents() # ensure a balanced graphics state # make /Contents object with dummy stream xref = TOOLS._insert_contents(self.page, b" ", overlay) # update it with potential compression self.doc.update_stream(xref, self.totalcont) self.last_point = None # clean up ... self.rect = None # self.draw_cont = "" # for potential ... self.text_cont = "" # ... self.totalcont = "" # re-use class Story: def __init__( self, html='', user_css=None, em=12, archive=None): buffer_ = mupdf.fz_new_buffer_from_copied_data( html.encode('utf-8')) if archive and not isinstance(archive, Archive): archive = Archive(archive) arch = archive.this if archive else mupdf.FzArchive( None) if hasattr(mupdf, 'FzStoryS'): self.this = mupdf.FzStoryS( buffer_, user_css, em, arch) else: self.this = mupdf.FzStory( buffer_, user_css, em, arch) def add_header_ids(self): ''' Look for `` items in `self` and adds unique `id` attributes if not already present. ''' dom = self.body i = 0 x = dom.find(None, None, None) while x: name = x.tagname if len(name) == 2 and name[0]=="h" and name[1] in "123456": attr = x.get_attribute_value("id") if not attr: id_ = f"h_id_{i}" #log(f"{name=}: setting {id_=}") x.set_attribute("id", id_) i += 1 x = x.find_next(None, None, None) @staticmethod def add_pdf_links(document_or_stream, positions): """ Adds links to PDF document. Args: document_or_stream: A PDF `Document` or raw PDF content, for example an `io.BytesIO` instance. positions: List of `ElementPosition`'s for `document_or_stream`, typically from Story.element_positions(). We raise an exception if two or more positions have same id. Returns: `document_or_stream` if a `Document` instance, otherwise a new `Document` instance. We raise an exception if an `href` in `positions` refers to an internal position `#` but no item in `positions` has `id = name`. """ if isinstance(document_or_stream, Document): document = document_or_stream else: document = Document("pdf", document_or_stream) # Create dict from id to position, which we will use to find # link destinations. # id_to_position = dict() #log(f"positions: {positions}") for position in positions: #log(f"add_pdf_links(): position: {position}") if (position.open_close & 1) and position.id: #log(f"add_pdf_links(): position with id: {position}") if position.id in id_to_position: #log(f"Ignoring duplicate positions with id={position.id!r}") pass else: id_to_position[ position.id] = position # Insert links for all positions that have an `href`. # for position_from in positions: if (position_from.open_close & 1) and position_from.href: #log(f"add_pdf_links(): position with href: {position}") link = dict() link['from'] = Rect(position_from.rect) if position_from.href.startswith("#"): #`...` internal link. target_id = position_from.href[1:] try: position_to = id_to_position[ target_id] except Exception as e: if g_exceptions_verbose > 1: exception_info() raise RuntimeError(f"No destination with id={target_id}, required by position_from: {position_from}") from e # Make link from `position_from`'s rect to top-left of # `position_to`'s rect. if 0: log(f"add_pdf_links(): making link from:") log(f"add_pdf_links(): {position_from}") log(f"add_pdf_links(): to:") log(f"add_pdf_links(): {position_to}") link["kind"] = LINK_GOTO x0, y0, x1, y1 = position_to.rect # This appears to work well with viewers which scroll # to make destination point top-left of window. link["to"] = Point(x0, y0) link["page"] = position_to.page_num - 1 else: # `...` external link. if position_from.href.startswith('name:'): link['kind'] = LINK_NAMED link['name'] = position_from.href[5:] else: link['kind'] = LINK_URI link['uri'] = position_from.href #log(f'Adding link: {position_from.page_num=} {link=}.') document[position_from.page_num - 1].insert_link(link) return document @property def body(self): dom = self.document() return dom.bodytag() def document( self): dom = mupdf.fz_story_document( self.this) return Xml( dom) def draw( self, device, matrix=None): ctm2 = JM_matrix_from_py( matrix) dev = device.this if device else mupdf.FzDevice( None) mupdf.fz_draw_story( self.this, dev, ctm2) def element_positions( self, function, args=None): ''' Trigger a callback function to record where items have been placed. ''' if type(args) is dict: for k in args.keys(): if not (type(k) is str and k.isidentifier()): raise ValueError(f"invalid key '{k}'") else: args = {} if not callable(function) or function.__code__.co_argcount != 1: raise ValueError("callback 'function' must be a callable with exactly one argument") def function2( position): class Position2: pass position2 = Position2() position2.depth = position.depth position2.heading = position.heading position2.id = position.id position2.rect = JM_py_from_rect(position.rect) position2.text = position.text position2.open_close = position.open_close position2.rect_num = position.rectangle_num position2.href = position.href if args: for k, v in args.items(): setattr( position2, k, v) function( position2) mupdf.fz_story_positions( self.this, function2) def place( self, where, flags=0): ''' Wrapper for fz_place_story_flags(). ''' where = JM_rect_from_py( where) filled = mupdf.FzRect() more = mupdf.fz_place_story_flags( self.this, where, filled, flags) return more, JM_py_from_rect( filled) def reset( self): mupdf.fz_reset_story( self.this) def write(self, writer, rectfn, positionfn=None, pagefn=None): dev = None page_num = 0 rect_num = 0 filled = Rect(0, 0, 0, 0) while 1: mediabox, rect, ctm = rectfn(rect_num, filled) rect_num += 1 if mediabox: # new page. page_num += 1 more, filled = self.place( rect) if positionfn: def positionfn2(position): # We add a `.page_num` member to the # `ElementPosition` instance. position.page_num = page_num positionfn(position) self.element_positions(positionfn2) if writer: if mediabox: # new page. if dev: if pagefn: pagefn(page_num, mediabox, dev, 1) writer.end_page() dev = writer.begin_page( mediabox) if pagefn: pagefn(page_num, mediabox, dev, 0) self.draw( dev, ctm) if not more: if pagefn: pagefn( page_num, mediabox, dev, 1) writer.end_page() else: self.draw(None, ctm) if not more: break @staticmethod def write_stabilized(writer, contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True): positions = list() content = None # Iterate until stable. while 1: content_prev = content content = contentfn( positions) stable = False if content == content_prev: stable = True content2 = content story = Story(content2, user_css, em, archive) if add_header_ids: story.add_header_ids() positions = list() def positionfn2(position): #log(f"write_stabilized(): {stable=} {positionfn=} {position=}") positions.append(position) if stable and positionfn: positionfn(position) story.write( writer if stable else None, rectfn, positionfn2, pagefn, ) if stable: break @staticmethod def write_stabilized_with_links(contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True): #log("write_stabilized_with_links()") stream = io.BytesIO() writer = DocumentWriter(stream) positions = [] def positionfn2(position): #log(f"write_stabilized_with_links(): {position=}") positions.append(position) if positionfn: positionfn(position) Story.write_stabilized(writer, contentfn, rectfn, user_css, em, positionfn2, pagefn, archive, add_header_ids) writer.close() stream.seek(0) return Story.add_pdf_links(stream, positions) def write_with_links(self, rectfn, positionfn=None, pagefn=None): #log("write_with_links()") stream = io.BytesIO() writer = DocumentWriter(stream) positions = [] def positionfn2(position): #log(f"write_with_links(): {position=}") positions.append(position) if positionfn: positionfn(position) self.write(writer, rectfn, positionfn=positionfn2, pagefn=pagefn) writer.close() stream.seek(0) return Story.add_pdf_links(stream, positions) class FitResult: ''' The result from a `Story.fit*()` method. Members: `big_enough`: `True` if the fit succeeded. `filled`: Tuple (x0, y0, x1, y1) from the last call to `Story.place()`. This will be wider than .rect if any single word (which we never split) was too wide for .rect. `more`: `False` if the fit succeeded. `numcalls`: Number of calls made to `self.place()`. `parameter`: The successful parameter value, or the largest failing value. `rect`: The pumupdf.Rect created from `parameter`. ''' def __init__(self, big_enough=None, filled=None, more=None, numcalls=None, parameter=None, rect=None): self.big_enough = big_enough self.filled = filled self.more = more self.numcalls = numcalls self.parameter = parameter self.rect = rect def __repr__(self): return ( f' big_enough={self.big_enough}' f' filled={self.filled}' f' more={self.more}' f' numcalls={self.numcalls}' f' parameter={self.parameter}' f' rect={self.rect}' ) def fit(self, fn, pmin=None, pmax=None, delta=0.001, verbose=False, flags=0): ''' Finds optimal rect that contains the story `self`. Returns a `Story.FitResult` instance. On success, the last call to `self.place()` will have been with the returned rectangle, so `self.draw()` can be used directly. Args: :arg fn: A callable taking a floating point `parameter` and returning a `pymupdf.Rect()`. If the rect is empty, we assume the story will not fit and do not call `self.place()`. Must guarantee that `self.place()` behaves monotonically when given rect `fn(parameter`) as `parameter` increases. This usually means that both width and height increase or stay unchanged as `parameter` increases. :arg pmin: Minimum parameter to consider; `None` for -infinity. :arg pmax: Maximum parameter to consider; `None` for +infinity. :arg delta: Maximum error in returned `parameter`. :arg verbose: If true we output diagnostics. :arg flags: Passed to mupdf.fz_place_story_flags(). e.g. zero or `mupdf.FZ_PLACE_STORY_FLAG_NO_OVERFLOW`. ''' def log(text): assert verbose message(f'fit(): {text}') assert isinstance(pmin, (int, float)) or pmin is None assert isinstance(pmax, (int, float)) or pmax is None class State: def __init__(self): self.pmin = pmin self.pmax = pmax self.pmin_result = None self.pmax_result = None self.result = None self.numcalls = 0 if verbose: self.pmin0 = pmin self.pmax0 = pmax state = State() if verbose: log(f'starting. {state.pmin=} {state.pmax=}.') self.reset() def ret(): if state.pmax is not None: if state.last_p != state.pmax: if verbose: log(f'Calling update() with pmax, because was overwritten by later calls.') big_enough = update(state.pmax) assert big_enough result = state.pmax_result else: result = state.pmin_result if state.pmin_result else Story.FitResult(numcalls=state.numcalls) if verbose: log(f'finished. {state.pmin0=} {state.pmax0=} {state.pmax=}: returning {result=}') return result def update(parameter): ''' Evaluates `more, _ = self.place(fn(parameter))`. If `more` is false, then `rect` is big enough to contain `self` and we set `state.pmax=parameter` and return True. Otherwise we set `state.pmin=parameter` and return False. ''' rect = fn(parameter) assert isinstance(rect, Rect), f'{type(rect)=} {rect=}' if rect.is_empty: big_enough = False result = Story.FitResult(parameter=parameter, numcalls=state.numcalls) if verbose: log(f'update(): not calling self.place() because rect is empty.') else: more, filled = self.place(rect, flags) state.numcalls += 1 big_enough = not more result = Story.FitResult( filled=filled, more=more, numcalls=state.numcalls, parameter=parameter, rect=rect, big_enough=big_enough, ) if verbose: log(f'update(): called self.place(): {state.numcalls:>2d}: {more=} {parameter=} {rect=}.') if big_enough: state.pmax = parameter state.pmax_result = result else: state.pmin = parameter state.pmin_result = result state.last_p = parameter return big_enough def opposite(p, direction): ''' Returns same sign as `direction`, larger or smaller than `p` if direction is positive or negative respectively. ''' if p is None or p==0: return direction if direction * p > 0: return 2 * p return -p if state.pmin is None: # Find an initial finite pmin value. if verbose: log(f'finding pmin.') parameter = opposite(state.pmax, -1) while 1: if not update(parameter): break parameter *= 2 else: if update(state.pmin): if verbose: log(f'{state.pmin=} is big enough.') return ret() if state.pmax is None: # Find an initial finite pmax value. if verbose: log(f'finding pmax.') parameter = opposite(state.pmin, +1) while 1: if update(parameter): break parameter *= 2 else: if not update(state.pmax): # No solution possible. state.pmax = None if verbose: log(f'No solution possible {state.pmax=}.') return ret() # Do binary search in pmin..pmax. if verbose: log(f'doing binary search with {state.pmin=} {state.pmax=}.') while 1: if state.pmax - state.pmin < delta: return ret() parameter = (state.pmin + state.pmax) / 2 update(parameter) def fit_scale(self, rect, scale_min=0, scale_max=None, delta=0.001, verbose=False, flags=0): ''' Finds smallest value `scale` in range `scale_min..scale_max` where `scale * rect` is large enough to contain the story `self`. Returns a `Story.FitResult` instance with `.parameter` set to `scale`. :arg width: width of rect. :arg height: height of rect. :arg scale_min: Minimum scale to consider; must be >= 0. :arg scale_max: Maximum scale to consider, must be >= scale_min or `None` for infinite. :arg delta: Maximum error in returned scale. :arg verbose: If true we output diagnostics. :arg flags: Passed to Story.place(). ''' x0, y0, x1, y1 = rect width = x1 - x0 height = y1 - y0 def fn(scale): return Rect(x0, y0, x0 + scale*width, y0 + scale*height) return self.fit(fn, scale_min, scale_max, delta, verbose, flags) def fit_height(self, width, height_min=0, height_max=None, origin=(0, 0), delta=0.001, verbose=False): ''' Finds smallest height in range `height_min..height_max` where a rect with size `(width, height)` is large enough to contain the story `self`. Returns a `Story.FitResult` instance. :arg width: width of rect. :arg height_min: Minimum height to consider; must be >= 0. :arg height_max: Maximum height to consider, must be >= height_min or `None` for infinite. :arg origin: `(x0, y0)` of rect. :arg delta: Maximum error in returned height. :arg verbose: If true we output diagnostics. ''' x0, y0 = origin x1 = x0 + width def fn(height): return Rect(x0, y0, x1, y0+height) return self.fit(fn, height_min, height_max, delta, verbose) def fit_width(self, height, width_min=0, width_max=None, origin=(0, 0), delta=0.001, verbose=False): ''' Finds smallest width in range `width_min..width_max` where a rect with size `(width, height)` is large enough to contain the story `self`. Returns a `Story.FitResult` instance. Returns a `FitResult` instance. :arg height: height of rect. :arg width_min: Minimum width to consider; must be >= 0. :arg width_max: Maximum width to consider, must be >= width_min or `None` for infinite. :arg origin: `(x0, y0)` of rect. :arg delta: Maximum error in returned width. :arg verbose: If true we output diagnostics. ''' x0, y0 = origin y1 = y0 + height def fn(width): return Rect(x0, y0, x0+width, y1) return self.fit(fn, width_min, width_max, delta, verbose) class TextPage: def __init__(self, *args): if args_match(args, mupdf.FzRect): mediabox = args[0] self.this = mupdf.FzStextPage( mediabox) elif args_match(args, mupdf.FzStextPage): self.this = args[0] else: raise Exception(f'Unrecognised args: {args}') self.thisown = True self.parent = None def _extractText(self, format_): this_tpage = self.this res = mupdf.fz_new_buffer(1024) out = mupdf.FzOutput( res) # fixme: mupdfwrap.py thinks fz_output is not copyable, possibly # because there is no .refs member visible and no fz_keep_output() fn, # although there is an fz_drop_output(). So mupdf.fz_new_output_with_buffer() # doesn't convert the returned fz_output* into a mupdf.FzOutput. #out = mupdf.FzOutput(out) if format_ == 1: mupdf.fz_print_stext_page_as_html(out, this_tpage, 0) elif format_ == 3: mupdf.fz_print_stext_page_as_xml(out, this_tpage, 0) elif format_ == 4: mupdf.fz_print_stext_page_as_xhtml(out, this_tpage, 0) else: JM_print_stext_page_as_text(res, this_tpage) out.fz_close_output() text = JM_EscapeStrFromBuffer(res) return text def _getNewBlockList(self, page_dict, raw): JM_make_textpage_dict(self.this, page_dict, raw) def _textpage_dict(self, raw=False): page_dict = {"width": self.rect.width, "height": self.rect.height} self._getNewBlockList(page_dict, raw) return page_dict def extractBLOCKS(self): """Return a list with text block information.""" if 1 or g_use_extra: return extra.extractBLOCKS(self.this) block_n = -1 this_tpage = self.this tp_rect = mupdf.FzRect(this_tpage.m_internal.mediabox) res = mupdf.fz_new_buffer(1024) lines = [] for block in this_tpage: block_n += 1 blockrect = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_TEXT: mupdf.fz_clear_buffer(res) # set text buffer to empty line_n = -1 last_char = 0 for line in block: line_n += 1 linerect = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) for ch in line: cbbox = JM_char_bbox(line, ch) if (not JM_rects_overlap(tp_rect, cbbox) and not mupdf.fz_is_infinite_rect(tp_rect) ): continue JM_append_rune(res, ch.m_internal.c) last_char = ch.m_internal.c linerect = mupdf.fz_union_rect(linerect, cbbox) if last_char != 10 and not mupdf.fz_is_empty_rect(linerect): mupdf.fz_append_byte(res, 10) blockrect = mupdf.fz_union_rect(blockrect, linerect) text = JM_EscapeStrFromBuffer(res) elif (JM_rects_overlap(tp_rect, block.m_internal.bbox) or mupdf.fz_is_infinite_rect(tp_rect) ): img = block.i_image() cs = img.colorspace() text = f"" blockrect = mupdf.fz_union_rect(blockrect, mupdf.FzRect(block.m_internal.bbox)) if not mupdf.fz_is_empty_rect(blockrect): litem = ( blockrect.x0, blockrect.y0, blockrect.x1, blockrect.y1, text, block_n, block.m_internal.type, ) lines.append(litem) return lines def extractDICT(self, cb=None, sort=False) -> dict: """Return page content as a Python dict of images and text spans.""" val = self._textpage_dict(raw=False) if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks return val def extractHTML(self) -> str: """Return page content as a HTML string.""" return self._extractText(1) def extractIMGINFO(self, hashes=0): """Return a list with image meta information.""" block_n = -1 this_tpage = self.this rc = [] for block in this_tpage: block_n += 1 if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_TEXT: continue img = block.i_image() img_size = 0 mask = img.mask() if mask.m_internal: has_mask = True else: has_mask = False compr_buff = mupdf.fz_compressed_image_buffer(img) if compr_buff.m_internal: img_size = compr_buff.fz_compressed_buffer_size() compr_buff = None if hashes: r = mupdf.FzIrect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT) assert mupdf.fz_is_infinite_irect(r) m = mupdf.FzMatrix(img.w(), 0, 0, img.h(), 0, 0) pix, w, h = mupdf.fz_get_pixmap_from_image(img, r, m) digest = mupdf.fz_md5_pixmap2(pix) digest = bytes(digest) if img_size == 0: img_size = img.w() * img.h() * img.n() cs = mupdf.FzColorspace(mupdf.ll_fz_keep_colorspace(img.m_internal.colorspace)) block_dict = dict() block_dict[dictkey_number] = block_n block_dict[dictkey_bbox] = JM_py_from_rect(block.m_internal.bbox) block_dict[dictkey_matrix] = JM_py_from_matrix(block.i_transform()) block_dict[dictkey_width] = img.w() block_dict[dictkey_height] = img.h() block_dict[dictkey_colorspace] = mupdf.fz_colorspace_n(cs) block_dict[dictkey_cs_name] = mupdf.fz_colorspace_name(cs) block_dict[dictkey_xres] = img.xres() block_dict[dictkey_yres] = img.yres() block_dict[dictkey_bpc] = img.bpc() block_dict[dictkey_size] = img_size if hashes: block_dict["digest"] = digest block_dict["has-mask"] = has_mask rc.append(block_dict) return rc def extractJSON(self, cb=None, sort=False) -> str: """Return 'extractDICT' converted to JSON format.""" import base64 import json val = self._textpage_dict(raw=False) class b64encode(json.JSONEncoder): def default(self, s): if type(s) in (bytes, bytearray): return base64.b64encode(s).decode() if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks val = json.dumps(val, separators=(",", ":"), cls=b64encode, indent=1) return val def extractRAWDICT(self, cb=None, sort=False) -> dict: """Return page content as a Python dict of images and text characters.""" val = self._textpage_dict(raw=True) if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks return val def extractRAWJSON(self, cb=None, sort=False) -> str: """Return 'extractRAWDICT' converted to JSON format.""" import base64 import json val = self._textpage_dict(raw=True) class b64encode(json.JSONEncoder): def default(self,s): if type(s) in (bytes, bytearray): return base64.b64encode(s).decode() if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks val = json.dumps(val, separators=(",", ":"), cls=b64encode, indent=1) return val def extractSelection(self, pointa, pointb): a = JM_point_from_py(pointa) b = JM_point_from_py(pointb) found = mupdf.fz_copy_selection(self.this, a, b, 0) return found def extractText(self, sort=False) -> str: """Return simple, bare text on the page.""" if not sort: return self._extractText(0) blocks = self.extractBLOCKS()[:] blocks.sort(key=lambda b: (b[3], b[0])) return "".join([b[4] for b in blocks]) def extractTextbox(self, rect): this_tpage = self.this assert isinstance(this_tpage, mupdf.FzStextPage) area = JM_rect_from_py(rect) found = JM_copy_rectangle(this_tpage, area) rc = PyUnicode_DecodeRawUnicodeEscape(found) return rc def extractWORDS(self, delimiters=None): """Return a list with text word information.""" if 1 or g_use_extra: return extra.extractWORDS(self.this, delimiters) buflen = 0 last_char_rtl = 0 block_n = -1 wbbox = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) # word bbox this_tpage = self.this tp_rect = mupdf.FzRect(this_tpage.m_internal.mediabox) lines = None buff = mupdf.fz_new_buffer(64) lines = [] for block in this_tpage: block_n += 1 if block.m_internal.type != mupdf.FZ_STEXT_BLOCK_TEXT: continue line_n = -1 for line in block: line_n += 1 word_n = 0 # word counter per line mupdf.fz_clear_buffer(buff) # reset word buffer buflen = 0 # reset char counter for ch in line: cbbox = JM_char_bbox(line, ch) if (not JM_rects_overlap(tp_rect, cbbox) and not mupdf.fz_is_infinite_rect(tp_rect) ): continue if buflen == 0 and ch.m_internal.c == 0x200d: # ZERO WIDTH JOINER cannot start a word continue word_delimiter = JM_is_word_delimiter(ch.m_internal.c, delimiters) this_char_rtl = JM_is_rtl_char(ch.m_internal.c) if word_delimiter or this_char_rtl != last_char_rtl: if buflen == 0 and word_delimiter: continue # skip delimiters at line start if not mupdf.fz_is_empty_rect(wbbox): word_n, wbbox = JM_append_word(lines, buff, wbbox, block_n, line_n, word_n) mupdf.fz_clear_buffer(buff) buflen = 0 # reset char counter if word_delimiter: continue # append one unicode character to the word JM_append_rune(buff, ch.m_internal.c) last_char_rtl = this_char_rtl buflen += 1 # enlarge word bbox wbbox = mupdf.fz_union_rect(wbbox, JM_char_bbox(line, ch)) if buflen and not mupdf.fz_is_empty_rect(wbbox): word_n, wbbox = JM_append_word(lines, buff, wbbox, block_n, line_n, word_n) buflen = 0 return lines def extractXHTML(self) -> str: """Return page content as a XHTML string.""" return self._extractText(4) def extractXML(self) -> str: """Return page content as a XML string.""" return self._extractText(3) def poolsize(self): """TextPage current poolsize.""" tpage = self.this pool = mupdf.Pool(tpage.m_internal.pool) size = mupdf.fz_pool_size( pool) pool.m_internal = None # Ensure that pool's destructor does not free the pool. return size @property def rect(self): """Page rectangle.""" this_tpage = self.this mediabox = this_tpage.m_internal.mediabox val = JM_py_from_rect(mediabox) val = Rect(val) return val def search(self, needle, hit_max=0, quads=1): """Locate 'needle' returning rects or quads.""" val = JM_search_stext_page(self.this, needle) if not val: return val items = len(val) for i in range(items): # change entries to quads or rects q = Quad(val[i]) if quads: val[i] = q else: val[i] = q.rect if quads: return val i = 0 # join overlapping rects on the same line while i < items - 1: v1 = val[i] v2 = val[i + 1] if v1.y1 != v2.y1 or (v1 & v2).is_empty: i += 1 continue # no overlap on same line val[i] = v1 | v2 # join rectangles del val[i + 1] # remove v2 items -= 1 # reduce item count return val extractTEXT = extractText class TextWriter: def __init__(self, page_rect, opacity=1, color=None): """Stores text spans for later output on compatible PDF pages.""" self.this = mupdf.fz_new_text() self.opacity = opacity self.color = color self.rect = Rect(page_rect) self.ctm = Matrix(1, 0, 0, -1, 0, self.rect.height) self.ictm = ~self.ctm self.last_point = Point() self.last_point.__doc__ = "Position following last text insertion." self.text_rect = Rect() self.text_rect.__doc__ = "Accumulated area of text spans." self.used_fonts = set() self.thisown = True @property def _bbox(self): val = JM_py_from_rect( mupdf.fz_bound_text( self.this, mupdf.FzStrokeState(None), mupdf.FzMatrix())) val = Rect(val) return val def append(self, pos, text, font=None, fontsize=11, language=None, right_to_left=0, small_caps=0): """Store 'text' at point 'pos' using 'font' and 'fontsize'.""" pos = Point(pos) * self.ictm #log(f'{font=}') if font is None: font = Font("helv") if not font.is_writable: if 0: log(f'{font.this.m_internal.name=}') log(f'{font.this.m_internal.t3matrix=}') log(f'{font.this.m_internal.bbox=}') log(f'{font.this.m_internal.glyph_count=}') log(f'{font.this.m_internal.use_glyph_bbox=}') log(f'{font.this.m_internal.width_count=}') log(f'{font.this.m_internal.width_default=}') log(f'{font.this.m_internal.has_digest=}') log(f'Unsupported font {font.name=}') if mupdf_cppyy: import cppyy log( f'Unsupported font {cppyy.gbl.mupdf_font_name(font.this.m_internal)=}') raise ValueError(f"Unsupported font '{font.name}'.") if right_to_left: text = self.clean_rtl(text) text = "".join(reversed(text)) right_to_left = 0 lang = mupdf.fz_text_language_from_string(language) p = JM_point_from_py(pos) trm = mupdf.fz_make_matrix(fontsize, 0, 0, fontsize, p.x, p.y) markup_dir = 0 wmode = 0 if small_caps == 0: trm = mupdf.fz_show_string( self.this, font.this, trm, text, wmode, right_to_left, markup_dir, lang) else: trm = JM_show_string_cs( self.this, font.this, trm, text, wmode, right_to_left, markup_dir, lang) val = JM_py_from_matrix(trm) self.last_point = Point(val[-2:]) * self.ctm self.text_rect = self._bbox * self.ctm val = self.text_rect, self.last_point if font.flags["mono"] == 1: self.used_fonts.add(font) return val def appendv(self, pos, text, font=None, fontsize=11, language=None, small_caps=False): lheight = fontsize * 1.2 for c in text: self.append(pos, c, font=font, fontsize=fontsize, language=language, small_caps=small_caps) pos.y += lheight return self.text_rect, self.last_point def clean_rtl(self, text): """Revert the sequence of Latin text parts. Text with right-to-left writing direction (Arabic, Hebrew) often contains Latin parts, which are written in left-to-right: numbers, names, etc. For output as PDF text we need *everything* in right-to-left. E.g. an input like " ABCDE FG HIJ KL " will be converted to " JIH GF EDCBA LK ". The Arabic parts remain untouched. Args: text: str Returns: Massaged string. """ if not text: return text # split into words at space boundaries words = text.split(" ") idx = [] for i in range(len(words)): w = words[i] # revert character sequence for Latin only words if not (len(w) < 2 or max([ord(c) for c in w]) > 255): words[i] = "".join(reversed(w)) idx.append(i) # stored index of Latin word # adjacent Latin words must revert their sequence, too idx2 = [] # store indices of adjacent Latin words for i in range(len(idx)): if idx2 == []: # empty yet? idx2.append(idx[i]) # store Latin word number elif idx[i] > idx2[-1] + 1: # large gap to last? if len(idx2) > 1: # at least two consecutives? words[idx2[0] : idx2[-1] + 1] = reversed( words[idx2[0] : idx2[-1] + 1] ) # revert their sequence idx2 = [idx[i]] # re-initialize elif idx[i] == idx2[-1] + 1: # new adjacent Latin word idx2.append(idx[i]) text = " ".join(words) return text def fill_textbox( writer: 'TextWriter', rect: rect_like, text: typing.Union[str, list], pos: point_like = None, font: typing.Optional[Font] = None, fontsize: float = 11, lineheight: OptFloat = None, align: int = 0, warn: bool = None, right_to_left: bool = False, small_caps: bool = False, ) -> tuple: """Fill a rectangle with text. Args: writer: pymupdf.TextWriter object (= "self") rect: rect-like to receive the text. text: string or list/tuple of strings. pos: point-like start position of first word. font: pymupdf.Font object (default pymupdf.Font('helv')). fontsize: the fontsize. lineheight: overwrite the font property align: (int) 0 = left, 1 = center, 2 = right, 3 = justify warn: (bool) text overflow action: none, warn, or exception right_to_left: (bool) indicate right-to-left language. """ rect = Rect(rect) if rect.is_empty: raise ValueError("fill rect must not empty.") if type(font) is not Font: font = Font("helv") def textlen(x): """Return length of a string.""" return font.text_length( x, fontsize=fontsize, small_caps=small_caps ) # abbreviation def char_lengths(x): """Return list of single character lengths for a string.""" return font.char_lengths(x, fontsize=fontsize, small_caps=small_caps) def append_this(pos, text): ret = writer.append( pos, text, font=font, fontsize=fontsize, small_caps=small_caps ) return ret tolerance = fontsize * 0.2 # extra distance to left border space_len = textlen(" ") std_width = rect.width - tolerance std_start = rect.x0 + tolerance def norm_words(width, words): """Cut any word in pieces no longer than 'width'.""" nwords = [] word_lengths = [] for w in words: wl_lst = char_lengths(w) wl = sum(wl_lst) if wl <= width: # nothing to do - copy over nwords.append(w) word_lengths.append(wl) continue # word longer than rect width - split it in parts n = len(wl_lst) while n > 0: wl = sum(wl_lst[:n]) if wl <= width: nwords.append(w[:n]) word_lengths.append(wl) w = w[n:] wl_lst = wl_lst[n:] n = len(wl_lst) else: n -= 1 return nwords, word_lengths def output_justify(start, line): """Justified output of a line.""" # ignore leading / trailing / multiple spaces words = [w for w in line.split(" ") if w != ""] nwords = len(words) if nwords == 0: return if nwords == 1: # single word cannot be justified append_this(start, words[0]) return tl = sum([textlen(w) for w in words]) # total word lengths gaps = nwords - 1 # number of word gaps gapl = (std_width - tl) / gaps # width of each gap for w in words: _, lp = append_this(start, w) # output one word start.x = lp.x + gapl # next start at word end plus gap return asc = font.ascender dsc = font.descender if not lineheight: if asc - dsc <= 1: lheight = 1.2 else: lheight = asc - dsc else: lheight = lineheight LINEHEIGHT = fontsize * lheight # effective line height width = std_width # available horizontal space # starting point of text if pos is not None: pos = Point(pos) else: # default is just below rect top-left pos = rect.tl + (tolerance, fontsize * asc) if pos not in rect: raise ValueError("Text must start in rectangle.") # calculate displacement factor for alignment if align == TEXT_ALIGN_CENTER: factor = 0.5 elif align == TEXT_ALIGN_RIGHT: factor = 1.0 else: factor = 0 # split in lines if just a string was given if type(text) is str: textlines = text.splitlines() else: textlines = [] for line in text: textlines.extend(line.splitlines()) max_lines = int((rect.y1 - pos.y) / LINEHEIGHT) + 1 new_lines = [] # the final list of textbox lines no_justify = [] # no justify for these line numbers for i, line in enumerate(textlines): if line in ("", " "): new_lines.append((line, space_len)) width = rect.width - tolerance no_justify.append((len(new_lines) - 1)) continue if i == 0: width = rect.x1 - pos.x else: width = rect.width - tolerance if right_to_left: # reverses Arabic / Hebrew text front to back line = writer.clean_rtl(line) tl = textlen(line) if tl <= width: # line short enough new_lines.append((line, tl)) no_justify.append((len(new_lines) - 1)) continue # we need to split the line in fitting parts words = line.split(" ") # the words in the line # cut in parts any words that are longer than rect width words, word_lengths = norm_words(width, words) n = len(words) while True: line0 = " ".join(words[:n]) wl = sum(word_lengths[:n]) + space_len * (n - 1) if wl <= width: new_lines.append((line0, wl)) words = words[n:] word_lengths = word_lengths[n:] n = len(words) line0 = None else: n -= 1 if len(words) == 0: break assert n # ------------------------------------------------------------------------- # List of lines created. Each item is (text, tl), where 'tl' is the PDF # output length (float) and 'text' is the text. Except for justified text, # this is output-ready. # ------------------------------------------------------------------------- nlines = len(new_lines) if nlines > max_lines: msg = f"Only fitting {max_lines} of {nlines} lines." if warn is None: pass elif warn: message("Warning: " + msg) else: raise ValueError(msg) start = Point() no_justify += [len(new_lines) - 1] # no justifying of last line for i in range(max_lines): try: line, tl = new_lines.pop(0) except IndexError: if g_exceptions_verbose >= 2: exception_info() break if right_to_left: # Arabic, Hebrew line = "".join(reversed(line)) if i == 0: # may have different start for first line start = pos if align == TEXT_ALIGN_JUSTIFY and i not in no_justify and tl < std_width: output_justify(start, line) start.x = std_start start.y += LINEHEIGHT continue if i > 0 or pos.x == std_start: # left, center, right alignments start.x += (width - tl) * factor append_this(start, line) start.x = std_start start.y += LINEHEIGHT return new_lines # return non-written lines def write_text(self, page, color=None, opacity=-1, overlay=1, morph=None, matrix=None, render_mode=0, oc=0): """Write the text to a PDF page having the TextWriter's page size. Args: page: a PDF page having same size. color: override text color. opacity: override transparency. overlay: put in foreground or background. morph: tuple(Point, Matrix), apply a matrix with a fixpoint. matrix: Matrix to be used instead of 'morph' argument. render_mode: (int) PDF render mode operator 'Tr'. """ CheckParent(page) if abs(self.rect - page.rect) > 1e-3: raise ValueError("incompatible page rect") if morph is not None: if (type(morph) not in (tuple, list) or type(morph[0]) is not Point or type(morph[1]) is not Matrix ): raise ValueError("morph must be (Point, Matrix) or None") if matrix is not None and morph is not None: raise ValueError("only one of matrix, morph is allowed") if getattr(opacity, "__float__", None) is None or opacity == -1: opacity = self.opacity if color is None: color = self.color if 1: pdfpage = page._pdf_page() alpha = 1 if opacity >= 0 and opacity < 1: alpha = opacity ncol = 1 dev_color = [0, 0, 0, 0] if color: ncol, dev_color = JM_color_FromSequence(color) if ncol == 3: colorspace = mupdf.fz_device_rgb() elif ncol == 4: colorspace = mupdf.fz_device_cmyk() else: colorspace = mupdf.fz_device_gray() resources = mupdf.pdf_new_dict(pdfpage.doc(), 5) contents = mupdf.fz_new_buffer(1024) dev = mupdf.pdf_new_pdf_device( pdfpage.doc(), mupdf.FzMatrix(), resources, contents) #log(f'=== {dev_color!r=}') mupdf.fz_fill_text( dev, self.this, mupdf.FzMatrix(), colorspace, dev_color, alpha, mupdf.FzColorParams(mupdf.fz_default_color_params), ) mupdf.fz_close_device( dev) # copy generated resources into the one of the page max_nums = JM_merge_resources( pdfpage, resources) cont_string = JM_EscapeStrFromBuffer( contents) result = (max_nums, cont_string) val = result max_nums = val[0] content = val[1] max_alp, max_font = max_nums old_cont_lines = content.splitlines() optcont = page._get_optional_content(oc) if optcont is not None: bdc = f"/OC /{optcont} BDC" emc = "EMC" else: bdc = emc = "" new_cont_lines = ["q"] if bdc: new_cont_lines.append(bdc) cb = page.cropbox_position if page.rotation in (90, 270): delta = page.rect.height - page.rect.width else: delta = 0 mb = page.mediabox if bool(cb) or mb.y0 != 0 or delta != 0: new_cont_lines.append(f"1 0 0 1 {_format_g((cb.x, cb.y + mb.y0 - delta))} cm") if morph: p = morph[0] * self.ictm delta = Matrix(1, 1).pretranslate(p.x, p.y) matrix = ~delta * morph[1] * delta if morph or matrix: new_cont_lines.append(_format_g(JM_TUPLE(matrix)) + " cm") for line in old_cont_lines: if line.endswith(" cm"): continue if line == "BT": new_cont_lines.append(line) new_cont_lines.append(f"{render_mode:d} Tr") continue if line.endswith(" gs"): alp = int(line.split()[0][4:]) + max_alp line = f"/Alp{alp:d} gs" elif line.endswith(" Tf"): temp = line.split() fsize = float(temp[1]) if render_mode != 0: w = fsize * 0.05 else: w = 1 new_cont_lines.append(_format_g(w) + " w") font = int(temp[0][2:]) + max_font line = " ".join([f"/F{font:d}"] + temp[1:]) elif line.endswith(" rg"): new_cont_lines.append(line.replace("rg", "RG")) elif line.endswith(" g"): new_cont_lines.append(line.replace(" g", " G")) elif line.endswith(" k"): new_cont_lines.append(line.replace(" k", " K")) new_cont_lines.append(line) if emc: new_cont_lines.append(emc) new_cont_lines.append("Q\n") content = "\n".join(new_cont_lines).encode("utf-8") TOOLS._insert_contents(page, content, overlay=overlay) val = None for font in self.used_fonts: repair_mono_font(page, font) return val class IRect: """ IRect() - all zeros IRect(x0, y0, x1, y1) - 4 coordinates IRect(top-left, x1, y1) - point and 2 coordinates IRect(x0, y0, bottom-right) - 2 coordinates and point IRect(top-left, bottom-right) - 2 points IRect(sequ) - new from sequence or rect-like """ def __add__(self, p): return Rect.__add__(self, p).round() def __and__(self, x): return Rect.__and__(self, x).round() def __contains__(self, x): return Rect.__contains__(self, x) def __eq__(self, r): if not hasattr(r, "__len__"): return False return len(r) == 4 and self.x0 == r[0] and self.y0 == r[1] and self.x1 == r[2] and self.y1 == r[3] def __getitem__(self, i): return (self.x0, self.y0, self.x1, self.y1)[i] def __hash__(self): return hash(tuple(self)) def __init__(self, *args, p0=None, p1=None, x0=None, y0=None, x1=None, y1=None): self.x0, self.y0, self.x1, self.y1 = util_make_irect( *args, p0=p0, p1=p1, x0=x0, y0=y0, x1=x1, y1=y1) def __len__(self): return 4 def __mul__(self, m): return Rect.__mul__(self, m).round() def __neg__(self): return IRect(-self.x0, -self.y0, -self.x1, -self.y1) def __or__(self, x): return Rect.__or__(self, x).round() def __pos__(self): return IRect(self) def __repr__(self): return "IRect" + str(tuple(self)) def __setitem__(self, i, v): v = int(v) if i == 0: self.x0 = v elif i == 1: self.y0 = v elif i == 2: self.x1 = v elif i == 3: self.y1 = v else: raise IndexError("index out of range") return None def __sub__(self, p): return Rect.__sub__(self, p).round() def __truediv__(self, m): return Rect.__truediv__(self, m).round() @property def bottom_left(self): """Bottom-left corner.""" return Point(self.x0, self.y1) @property def bottom_right(self): """Bottom-right corner.""" return Point(self.x1, self.y1) @property def height(self): return max(0, self.y1 - self.y0) def contains(self, x): """Check if x is in the rectangle.""" return self.__contains__(x) def get_area(self, *args) -> float: """Calculate area of rectangle.\nparameter is one of 'px' (default), 'in', 'cm', or 'mm'.""" return _rect_area(self.width, self.height, args) def include_point(self, p): """Extend rectangle to include point p.""" rect = self.rect.include_point(p) return rect.irect def include_rect(self, r): """Extend rectangle to include rectangle r.""" rect = self.rect.include_rect(r) return rect.irect def intersect(self, r): """Restrict rectangle to intersection with rectangle r.""" return Rect.intersect(self, r).round() def intersects(self, x): return Rect.intersects(self, x) @property def is_empty(self): """True if rectangle area is empty.""" return self.x0 >= self.x1 or self.y0 >= self.y1 @property def is_infinite(self): """True if rectangle is infinite.""" return self.x0 == self.y0 == FZ_MIN_INF_RECT and self.x1 == self.y1 == FZ_MAX_INF_RECT @property def is_valid(self): """True if rectangle is valid.""" return self.x0 <= self.x1 and self.y0 <= self.y1 def morph(self, p, m): """Morph with matrix-like m and point-like p. Returns a new quad.""" if self.is_infinite: return INFINITE_QUAD() return self.quad.morph(p, m) def norm(self): return math.sqrt(sum([c*c for c in self])) def normalize(self): """Replace rectangle with its valid version.""" if self.x1 < self.x0: self.x0, self.x1 = self.x1, self.x0 if self.y1 < self.y0: self.y0, self.y1 = self.y1, self.y0 return self @property def quad(self): """Return Quad version of rectangle.""" return Quad(self.tl, self.tr, self.bl, self.br) @property def rect(self): return Rect(self) @property def top_left(self): """Top-left corner.""" return Point(self.x0, self.y0) @property def top_right(self): """Top-right corner.""" return Point(self.x1, self.y0) def torect(self, r): """Return matrix that converts to target rect.""" r = Rect(r) if self.is_infinite or self.is_empty or r.is_infinite or r.is_empty: raise ValueError("rectangles must be finite and not empty") return ( Matrix(1, 0, 0, 1, -self.x0, -self.y0) * Matrix(r.width / self.width, r.height / self.height) * Matrix(1, 0, 0, 1, r.x0, r.y0) ) def transform(self, m): return Rect.transform(self, m).round() @property def width(self): return max(0, self.x1 - self.x0) br = bottom_right bl = bottom_left tl = top_left tr = top_right # Data # if 1: _self = sys.modules[__name__] if 1: for _name, _value in mupdf.__dict__.items(): if _name.startswith(('PDF_', 'UCDN_SCRIPT_')): if _name.startswith('PDF_ENUM_NAME_'): # Not a simple enum. pass else: #assert not inspect.isroutine(value) #log(f'importing {_name=} {_value=}.') setattr(_self, _name, _value) #log(f'{getattr( self, name, None)=}') else: # This is slow due to importing inspect, e.g. 0.019 instead of 0.004. for _name, _value in inspect.getmembers(mupdf): if _name.startswith(('PDF_', 'UCDN_SCRIPT_')): if _name.startswith('PDF_ENUM_NAME_'): # Not a simple enum. pass else: #assert not inspect.isroutine(value) #log(f'importing {name}') setattr(_self, _name, _value) #log(f'{getattr( self, name, None)=}') # This is a macro so not preserved in mupdf C++/Python bindings. # PDF_SIGNATURE_DEFAULT_APPEARANCE = (0 | mupdf.PDF_SIGNATURE_SHOW_LABELS | mupdf.PDF_SIGNATURE_SHOW_DN | mupdf.PDF_SIGNATURE_SHOW_DATE | mupdf.PDF_SIGNATURE_SHOW_TEXT_NAME | mupdf.PDF_SIGNATURE_SHOW_GRAPHIC_NAME | mupdf.PDF_SIGNATURE_SHOW_LOGO ) #UCDN_SCRIPT_ADLAM = mupdf.UCDN_SCRIPT_ADLAM #setattr(self, 'UCDN_SCRIPT_ADLAM', mupdf.UCDN_SCRIPT_ADLAM) assert mupdf.UCDN_EAST_ASIAN_H == 1 # Flake8 incorrectly fails next two lines because we've dynamically added # items to self. assert PDF_TX_FIELD_IS_MULTILINE == mupdf.PDF_TX_FIELD_IS_MULTILINE # noqa: F821 assert UCDN_SCRIPT_ADLAM == mupdf.UCDN_SCRIPT_ADLAM # noqa: F821 del _self, _name, _value AnyType = typing.Any Base14_fontnames = ( "Courier", "Courier-Oblique", "Courier-Bold", "Courier-BoldOblique", "Helvetica", "Helvetica-Oblique", "Helvetica-Bold", "Helvetica-BoldOblique", "Times-Roman", "Times-Italic", "Times-Bold", "Times-BoldItalic", "Symbol", "ZapfDingbats", ) Base14_fontdict = {} for f in Base14_fontnames: Base14_fontdict[f.lower()] = f Base14_fontdict["helv"] = "Helvetica" Base14_fontdict["heit"] = "Helvetica-Oblique" Base14_fontdict["hebo"] = "Helvetica-Bold" Base14_fontdict["hebi"] = "Helvetica-BoldOblique" Base14_fontdict["cour"] = "Courier" Base14_fontdict["coit"] = "Courier-Oblique" Base14_fontdict["cobo"] = "Courier-Bold" Base14_fontdict["cobi"] = "Courier-BoldOblique" Base14_fontdict["tiro"] = "Times-Roman" Base14_fontdict["tibo"] = "Times-Bold" Base14_fontdict["tiit"] = "Times-Italic" Base14_fontdict["tibi"] = "Times-BoldItalic" Base14_fontdict["symb"] = "Symbol" Base14_fontdict["zadb"] = "ZapfDingbats" EPSILON = 1e-5 FLT_EPSILON = 1e-5 # largest 32bit integers surviving C float conversion roundtrips # used by MuPDF to define infinite rectangles FZ_MIN_INF_RECT = -0x80000000 FZ_MAX_INF_RECT = 0x7fffff80 JM_annot_id_stem = "fitz" JM_mupdf_warnings_store = [] JM_mupdf_show_errors = 1 JM_mupdf_show_warnings = 0 # ------------------------------------------------------------------------------ # Image recompression constants # ------------------------------------------------------------------------------ FZ_RECOMPRESS_NEVER = mupdf.FZ_RECOMPRESS_NEVER FZ_RECOMPRESS_SAME = mupdf.FZ_RECOMPRESS_SAME FZ_RECOMPRESS_LOSSLESS = mupdf.FZ_RECOMPRESS_LOSSLESS FZ_RECOMPRESS_JPEG = mupdf.FZ_RECOMPRESS_JPEG FZ_RECOMPRESS_J2K = mupdf.FZ_RECOMPRESS_J2K FZ_RECOMPRESS_FAX = mupdf.FZ_RECOMPRESS_FAX FZ_SUBSAMPLE_AVERAGE = mupdf.FZ_SUBSAMPLE_AVERAGE FZ_SUBSAMPLE_BICUBIC = mupdf.FZ_SUBSAMPLE_BICUBIC # ------------------------------------------------------------------------------ # Various PDF Optional Content Flags # ------------------------------------------------------------------------------ PDF_OC_ON = 0 PDF_OC_TOGGLE = 1 PDF_OC_OFF = 2 # ------------------------------------------------------------------------------ # link kinds and link flags # ------------------------------------------------------------------------------ LINK_NONE = 0 LINK_GOTO = 1 LINK_URI = 2 LINK_LAUNCH = 3 LINK_NAMED = 4 LINK_GOTOR = 5 LINK_FLAG_L_VALID = 1 LINK_FLAG_T_VALID = 2 LINK_FLAG_R_VALID = 4 LINK_FLAG_B_VALID = 8 LINK_FLAG_FIT_H = 16 LINK_FLAG_FIT_V = 32 LINK_FLAG_R_IS_ZOOM = 64 SigFlag_SignaturesExist = 1 SigFlag_AppendOnly = 2 STAMP_Approved = 0 STAMP_AsIs = 1 STAMP_Confidential = 2 STAMP_Departmental = 3 STAMP_Experimental = 4 STAMP_Expired = 5 STAMP_Final = 6 STAMP_ForComment = 7 STAMP_ForPublicRelease = 8 STAMP_NotApproved = 9 STAMP_NotForPublicRelease = 10 STAMP_Sold = 11 STAMP_TopSecret = 12 STAMP_Draft = 13 TEXT_ALIGN_LEFT = 0 TEXT_ALIGN_CENTER = 1 TEXT_ALIGN_RIGHT = 2 TEXT_ALIGN_JUSTIFY = 3 TEXT_FONT_SUPERSCRIPT = 1 TEXT_FONT_ITALIC = 2 TEXT_FONT_SERIFED = 4 TEXT_FONT_MONOSPACED = 8 TEXT_FONT_BOLD = 16 TEXT_OUTPUT_TEXT = 0 TEXT_OUTPUT_HTML = 1 TEXT_OUTPUT_JSON = 2 TEXT_OUTPUT_XML = 3 TEXT_OUTPUT_XHTML = 4 TEXT_PRESERVE_LIGATURES = mupdf.FZ_STEXT_PRESERVE_LIGATURES TEXT_PRESERVE_WHITESPACE = mupdf.FZ_STEXT_PRESERVE_WHITESPACE TEXT_PRESERVE_IMAGES = mupdf.FZ_STEXT_PRESERVE_IMAGES TEXT_INHIBIT_SPACES = mupdf.FZ_STEXT_INHIBIT_SPACES TEXT_DEHYPHENATE = mupdf.FZ_STEXT_DEHYPHENATE TEXT_PRESERVE_SPANS = mupdf.FZ_STEXT_PRESERVE_SPANS TEXT_MEDIABOX_CLIP = mupdf.FZ_STEXT_MEDIABOX_CLIP TEXT_USE_CID_FOR_UNKNOWN_UNICODE = mupdf.FZ_STEXT_USE_CID_FOR_UNKNOWN_UNICODE TEXT_COLLECT_STRUCTURE = mupdf.FZ_STEXT_COLLECT_STRUCTURE TEXT_ACCURATE_BBOXES = mupdf.FZ_STEXT_ACCURATE_BBOXES TEXT_COLLECT_VECTORS = mupdf.FZ_STEXT_COLLECT_VECTORS TEXT_IGNORE_ACTUALTEXT = mupdf.FZ_STEXT_IGNORE_ACTUALTEXT TEXT_SEGMENT = mupdf.FZ_STEXT_SEGMENT TEXT_CLIP = mupdf.FZ_STEXT_CLIP if mupdf_version_tuple >= (1, 27, 1): TEXT_LAZY_VECTORS = mupdf.FZ_STEXT_LAZY_VECTORS if mupdf_version_tuple >= (1, 27, 2): TEXT_FUZZY_VECTORS = mupdf.FZ_STEXT_FUZZY_VECTORS TEXT_PARAGRAPH_BREAK = mupdf.FZ_STEXT_PARAGRAPH_BREAK TEXT_TABLE_HUNT = mupdf.FZ_STEXT_TABLE_HUNT TEXT_COLLECT_STYLES = mupdf.FZ_STEXT_COLLECT_STYLES TEXT_USE_GID_FOR_UNKNOWN_UNICODE = mupdf.FZ_STEXT_USE_GID_FOR_UNKNOWN_UNICODE TEXT_CLIP_RECT = mupdf.FZ_STEXT_CLIP_RECT TEXT_ACCURATE_ASCENDERS = mupdf.FZ_STEXT_ACCURATE_ASCENDERS TEXT_ACCURATE_SIDE_BEARINGS = mupdf.FZ_STEXT_ACCURATE_SIDE_BEARINGS # 2025-05-07: Non-standard names preserved for backwards compatibility. TEXT_STEXT_SEGMENT = TEXT_SEGMENT TEXT_CID_FOR_UNKNOWN_UNICODE = TEXT_USE_CID_FOR_UNKNOWN_UNICODE TEXTFLAGS_WORDS = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_BLOCKS = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_DICT = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_RAWDICT = TEXTFLAGS_DICT TEXTFLAGS_SEARCH = (0 | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_HTML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_XHTML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_XML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_TEXT = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) # Simple text encoding options TEXT_ENCODING_LATIN = 0 TEXT_ENCODING_GREEK = 1 TEXT_ENCODING_CYRILLIC = 2 TOOLS_JM_UNIQUE_ID = 0 # colorspace identifiers CS_RGB = 1 CS_GRAY = 2 CS_CMYK = 3 # PDF Blend Modes 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" annot_skel = { "goto1": lambda a, b, c, d, e: f"<>/Rect[{e}]/BS<>/Subtype/Link>>", "goto2": lambda a, b: f"<>/Rect[{b}]/BS<>/Subtype/Link>>", "gotor1": lambda a, b, c, d, e, f, g: f"<>>>/Rect[{g}]/BS<>/Subtype/Link>>", "gotor2": lambda a, b, c: f"<>/Rect[{c}]/BS<>/Subtype/Link>>", "launch": lambda a, b, c: f"<>>>/Rect[{c}]/BS<>/Subtype/Link>>", "uri": lambda a, b: f"<>/Rect[{b}]/BS<>/Subtype/Link>>", "named": lambda a, b: f"<>/Rect[{b}]/BS<>/Subtype/Link>>", } class FileDataError(RuntimeError): """Raised for documents with file structure issues.""" pass class FileNotFoundError(RuntimeError): """Raised if file does not exist.""" pass class EmptyFileError(FileDataError): """Raised when creating documents from zero-length data.""" pass # propagate exception class to C-level code #_set_FileDataError(FileDataError) csRGB = Colorspace(CS_RGB) csGRAY = Colorspace(CS_GRAY) csCMYK = Colorspace(CS_CMYK) # These don't appear to be visible in classic, but are used # internally. # dictkey_align = "align" dictkey_asc = "ascender" dictkey_bidi = "bidi" dictkey_bbox = "bbox" dictkey_blocks = "blocks" dictkey_bpc = "bpc" dictkey_c = "c" dictkey_chars = "chars" dictkey_color = "color" dictkey_colorspace = "colorspace" dictkey_content = "content" dictkey_creationDate = "creationDate" dictkey_cs_name = "cs-name" dictkey_da = "da" dictkey_dashes = "dashes" dictkey_descr = "description" dictkey_desc = "descender" dictkey_dir = "dir" dictkey_effect = "effect" dictkey_ext = "ext" dictkey_filename = "filename" dictkey_fill = "fill" dictkey_flags = "flags" dictkey_char_flags = "char_flags" dictkey_font = "font" dictkey_glyph = "glyph" dictkey_height = "height" dictkey_id = "id" dictkey_image = "image" dictkey_items = "items" dictkey_length = "length" dictkey_lines = "lines" dictkey_matrix = "transform" dictkey_modDate = "modDate" dictkey_name = "name" dictkey_number = "number" dictkey_origin = "origin" dictkey_rect = "rect" dictkey_size = "size" dictkey_smask = "smask" dictkey_spans = "spans" dictkey_stroke = "stroke" dictkey_style = "style" dictkey_subject = "subject" dictkey_text = "text" dictkey_title = "title" dictkey_type = "type" dictkey_ufilename = "ufilename" dictkey_width = "width" dictkey_wmode = "wmode" dictkey_xref = "xref" dictkey_xres = "xres" dictkey_yres = "yres" try: from pymupdf_fonts import fontdescriptors, fontbuffers fitz_fontdescriptors = fontdescriptors.copy() for k in fitz_fontdescriptors.keys(): fitz_fontdescriptors[k]["loader"] = fontbuffers[k] del fontdescriptors, fontbuffers except ImportError: fitz_fontdescriptors = {} symbol_glyphs = ( # Glyph list for the built-in font 'Symbol' (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (32, 0.25), (33, 0.333), (34, 0.713), (35, 0.5), (36, 0.549), (37, 0.833), (38, 0.778), (39, 0.439), (40, 0.333), (41, 0.333), (42, 0.5), (43, 0.549), (44, 0.25), (45, 0.549), (46, 0.25), (47, 0.278), (48, 0.5), (49, 0.5), (50, 0.5), (51, 0.5), (52, 0.5), (53, 0.5), (54, 0.5), (55, 0.5), (56, 0.5), (57, 0.5), (58, 0.278), (59, 0.278), (60, 0.549), (61, 0.549), (62, 0.549), (63, 0.444), (64, 0.549), (65, 0.722), (66, 0.667), (67, 0.722), (68, 0.612), (69, 0.611), (70, 0.763), (71, 0.603), (72, 0.722), (73, 0.333), (74, 0.631), (75, 0.722), (76, 0.686), (77, 0.889), (78, 0.722), (79, 0.722), (80, 0.768), (81, 0.741), (82, 0.556), (83, 0.592), (84, 0.611), (85, 0.69), (86, 0.439), (87, 0.768), (88, 0.645), (89, 0.795), (90, 0.611), (91, 0.333), (92, 0.863), (93, 0.333), (94, 0.658), (95, 0.5), (96, 0.5), (97, 0.631), (98, 0.549), (99, 0.549), (100, 0.494), (101, 0.439), (102, 0.521), (103, 0.411), (104, 0.603), (105, 0.329), (106, 0.603), (107, 0.549), (108, 0.549), (109, 0.576), (110, 0.521), (111, 0.549), (112, 0.549), (113, 0.521), (114, 0.549), (115, 0.603), (116, 0.439), (117, 0.576), (118, 0.713), (119, 0.686), (120, 0.493), (121, 0.686), (122, 0.494), (123, 0.48), (124, 0.2), (125, 0.48), (126, 0.549), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (160, 0.25), (161, 0.62), (162, 0.247), (163, 0.549), (164, 0.167), (165, 0.713), (166, 0.5), (167, 0.753), (168, 0.753), (169, 0.753), (170, 0.753), (171, 1.042), (172, 0.713), (173, 0.603), (174, 0.987), (175, 0.603), (176, 0.4), (177, 0.549), (178, 0.411), (179, 0.549), (180, 0.549), (181, 0.576), (182, 0.494), (183, 0.46), (184, 0.549), (185, 0.549), (186, 0.549), (187, 0.549), (188, 1), (189, 0.603), (190, 1), (191, 0.658), (192, 0.823), (193, 0.686), (194, 0.795), (195, 0.987), (196, 0.768), (197, 0.768), (198, 0.823), (199, 0.768), (200, 0.768), (201, 0.713), (202, 0.713), (203, 0.713), (204, 0.713), (205, 0.713), (206, 0.713), (207, 0.713), (208, 0.768), (209, 0.713), (210, 0.79), (211, 0.79), (212, 0.89), (213, 0.823), (214, 0.549), (215, 0.549), (216, 0.713), (217, 0.603), (218, 0.603), (219, 1.042), (220, 0.987), (221, 0.603), (222, 0.987), (223, 0.603), (224, 0.494), (225, 0.329), (226, 0.79), (227, 0.79), (228, 0.786), (229, 0.713), (230, 0.384), (231, 0.384), (232, 0.384), (233, 0.384), (234, 0.384), (235, 0.384), (236, 0.494), (237, 0.494), (238, 0.494), (239, 0.494), (183, 0.46), (241, 0.329), (242, 0.274), (243, 0.686), (244, 0.686), (245, 0.686), (246, 0.384), (247, 0.549), (248, 0.384), (249, 0.384), (250, 0.384), (251, 0.384), (252, 0.494), (253, 0.494), (254, 0.494), (183, 0.46), ) zapf_glyphs = ( # Glyph list for the built-in font 'ZapfDingbats' (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (32, 0.278), (33, 0.974), (34, 0.961), (35, 0.974), (36, 0.98), (37, 0.719), (38, 0.789), (39, 0.79), (40, 0.791), (41, 0.69), (42, 0.96), (43, 0.939), (44, 0.549), (45, 0.855), (46, 0.911), (47, 0.933), (48, 0.911), (49, 0.945), (50, 0.974), (51, 0.755), (52, 0.846), (53, 0.762), (54, 0.761), (55, 0.571), (56, 0.677), (57, 0.763), (58, 0.76), (59, 0.759), (60, 0.754), (61, 0.494), (62, 0.552), (63, 0.537), (64, 0.577), (65, 0.692), (66, 0.786), (67, 0.788), (68, 0.788), (69, 0.79), (70, 0.793), (71, 0.794), (72, 0.816), (73, 0.823), (74, 0.789), (75, 0.841), (76, 0.823), (77, 0.833), (78, 0.816), (79, 0.831), (80, 0.923), (81, 0.744), (82, 0.723), (83, 0.749), (84, 0.79), (85, 0.792), (86, 0.695), (87, 0.776), (88, 0.768), (89, 0.792), (90, 0.759), (91, 0.707), (92, 0.708), (93, 0.682), (94, 0.701), (95, 0.826), (96, 0.815), (97, 0.789), (98, 0.789), (99, 0.707), (100, 0.687), (101, 0.696), (102, 0.689), (103, 0.786), (104, 0.787), (105, 0.713), (106, 0.791), (107, 0.785), (108, 0.791), (109, 0.873), (110, 0.761), (111, 0.762), (112, 0.762), (113, 0.759), (114, 0.759), (115, 0.892), (116, 0.892), (117, 0.788), (118, 0.784), (119, 0.438), (120, 0.138), (121, 0.277), (122, 0.415), (123, 0.392), (124, 0.392), (125, 0.668), (126, 0.668), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (161, 0.732), (162, 0.544), (163, 0.544), (164, 0.91), (165, 0.667), (166, 0.76), (167, 0.76), (168, 0.776), (169, 0.595), (170, 0.694), (171, 0.626), (172, 0.788), (173, 0.788), (174, 0.788), (175, 0.788), (176, 0.788), (177, 0.788), (178, 0.788), (179, 0.788), (180, 0.788), (181, 0.788), (182, 0.788), (183, 0.788), (184, 0.788), (185, 0.788), (186, 0.788), (187, 0.788), (188, 0.788), (189, 0.788), (190, 0.788), (191, 0.788), (192, 0.788), (193, 0.788), (194, 0.788), (195, 0.788), (196, 0.788), (197, 0.788), (198, 0.788), (199, 0.788), (200, 0.788), (201, 0.788), (202, 0.788), (203, 0.788), (204, 0.788), (205, 0.788), (206, 0.788), (207, 0.788), (208, 0.788), (209, 0.788), (210, 0.788), (211, 0.788), (212, 0.894), (213, 0.838), (214, 1.016), (215, 0.458), (216, 0.748), (217, 0.924), (218, 0.748), (219, 0.918), (220, 0.927), (221, 0.928), (222, 0.928), (223, 0.834), (224, 0.873), (225, 0.828), (226, 0.924), (227, 0.924), (228, 0.917), (229, 0.93), (230, 0.931), (231, 0.463), (232, 0.883), (233, 0.836), (234, 0.836), (235, 0.867), (236, 0.867), (237, 0.696), (238, 0.696), (239, 0.874), (183, 0.788), (241, 0.874), (242, 0.76), (243, 0.946), (244, 0.771), (245, 0.865), (246, 0.771), (247, 0.888), (248, 0.967), (249, 0.888), (250, 0.831), (251, 0.873), (252, 0.927), (253, 0.97), (183, 0.788), (183, 0.788), ) # Functions # def _rect_area(width, height, args): # Used by IRect.get_area() and Rect.get_area(). unit = args[0] if args else 'px' u = {"px": (1, 1), "in": (1.0, 72.0), "cm": (2.54, 72.0), "mm": (25.4, 72.0)} f = (u[unit][0] / u[unit][1]) ** 2 return f * width * height def _read_samples( pixmap, offset, n): # fixme: need to be able to get a sample in one call, as a Python # bytes or similar. ret = [] if not pixmap.samples(): # mupdf.fz_samples_get() gives a segv if pixmap->samples is null. return ret for i in range( n): ret.append( mupdf.fz_samples_get( pixmap, offset + i)) return bytes( ret) def _INRANGE(v, low, high): return low <= v and v <= high def _remove_dest_range(pdf, numbers): pagecount = mupdf.pdf_count_pages(pdf) for i in range(pagecount): n1 = i if n1 in numbers: continue pageref = mupdf.pdf_lookup_page_obj( pdf, i) annots = mupdf.pdf_dict_get( pageref, PDF_NAME('Annots')) if not annots.m_internal: continue len_ = mupdf.pdf_array_len(annots) for j in range(len_ - 1, -1, -1): o = mupdf.pdf_array_get( annots, j) if not mupdf.pdf_name_eq( mupdf.pdf_dict_get( o, PDF_NAME('Subtype')), PDF_NAME('Link')): continue action = mupdf.pdf_dict_get( o, PDF_NAME('A')) dest = mupdf.pdf_dict_get( o, PDF_NAME('Dest')) if action.m_internal: if not mupdf.pdf_name_eq( mupdf.pdf_dict_get( action, PDF_NAME('S')), PDF_NAME('GoTo')): continue dest = mupdf.pdf_dict_get( action, PDF_NAME('D')) pno = -1 if mupdf.pdf_is_array( dest): target = mupdf.pdf_array_get( dest, 0) pno = mupdf.pdf_lookup_page_number( pdf, target) elif mupdf.pdf_is_string( dest): location, _, _ = mupdf.fz_resolve_link( pdf.super(), mupdf.pdf_to_text_string( dest)) pno = location.page if pno < 0: # page number lookup did not work continue n1 = pno if n1 in numbers: mupdf.pdf_array_delete( annots, j) def ASSERT_PDF(cond): assert isinstance(cond, (mupdf.PdfPage, mupdf.PdfDocument)), f'{type(cond)=} {cond=}' if not cond.m_internal: raise Exception(MSG_IS_NO_PDF) def EMPTY_IRECT(): return IRect(FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) def EMPTY_QUAD(): return EMPTY_RECT().quad def EMPTY_RECT(): return Rect(FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) def ENSURE_OPERATION(pdf): if not JM_have_operation(pdf): raise Exception("No journalling operation started") def INFINITE_IRECT(): return IRect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT) def INFINITE_QUAD(): return INFINITE_RECT().quad def INFINITE_RECT(): return Rect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT) def JM_BinFromBuffer(buffer_): ''' Turn fz_buffer into a Python bytes object ''' assert isinstance(buffer_, mupdf.FzBuffer) ret = mupdf.fz_buffer_extract_copy(buffer_) return ret def JM_EscapeStrFromStr(c): # `c` is typically from SWIG which will have converted a `const char*` from # C into a Python `str` using `PyUnicode_DecodeUTF8(carray, static_cast< # Py_ssize_t >(size), "surrogateescape")`. This gives us a Python `str` # with some characters encoded as a \0xdcXY sequence, where `XY` are hex # digits for an invalid byte in the original `const char*`. # # This is actually a reasonable way of representing arbitrary # strings from C, but we want to mimic what PyMuPDF does. It uses # `PyUnicode_DecodeRawUnicodeEscape(c, (Py_ssize_t) strlen(c), "replace")` # which gives a string containing actual unicode characters for any invalid # bytes. # # We mimic this by converting the `str` to a `bytes` with 'surrogateescape' # to recognise \0xdcXY sequences, then convert the individual bytes into a # `str` using `chr()`. # # Would be good to have a more efficient way to do this. # if c is None: return '' assert isinstance(c, str), f'{type(c)=}' b = c.encode('utf8', 'surrogateescape') ret = '' for bb in b: ret += chr(bb) return ret def JM_BufferFromBytes(stream): ''' Make fz_buffer from a PyBytes, PyByteArray or io.BytesIO object. If a text io.BytesIO, we convert to binary by encoding as utf8. ''' if isinstance(stream, (bytes, bytearray)): data = stream elif hasattr(stream, 'getvalue'): data = stream.getvalue() if isinstance(data, str): data = data.encode('utf-8') if not isinstance(data, (bytes, bytearray)): raise Exception(f'.getvalue() returned unexpected type: {type(data)}') else: return mupdf.FzBuffer() return mupdf.fz_new_buffer_from_copied_data(data) def JM_FLOAT_ITEM(obj, idx): if not PySequence_Check(obj): return None return float(obj[idx]) def JM_INT_ITEM(obj, idx): if idx < len(obj): temp = obj[idx] if isinstance(temp, (int, float)): return 0, temp return 1, None def JM_pixmap_from_page(doc, page, ctm, cs, alpha, annots, clip): ''' Pixmap creation directly using a short-lived displaylist, so we can support separations. ''' SPOTS_NONE = 0 SPOTS_OVERPRINT_SIM = 1 SPOTS_FULL = 2 FZ_ENABLE_SPOT_RENDERING = True # fixme: this is a build-time setting in MuPDF's config.h. if FZ_ENABLE_SPOT_RENDERING: spots = SPOTS_OVERPRINT_SIM else: spots = SPOTS_NONE seps = None colorspace = cs matrix = JM_matrix_from_py(ctm) rect = mupdf.fz_bound_page(page) rclip = JM_rect_from_py(clip) rect = mupdf.fz_intersect_rect(rect, rclip) # no-op if clip is not given rect = mupdf.fz_transform_rect(rect, matrix) bbox = mupdf.fz_round_rect(rect) # Pixmap of the document's /OutputIntents ("output intents") oi = mupdf.fz_document_output_intent(doc) # if present and compatible, use it instead of the parameter if oi.m_internal: if mupdf.fz_colorspace_n(oi) == mupdf.fz_colorspace_n(cs): colorspace = mupdf.fz_keep_colorspace(oi) # check if spots rendering is available and if so use separations if spots != SPOTS_NONE: seps = mupdf.fz_page_separations(page) if seps.m_internal: n = mupdf.fz_count_separations(seps) if spots == SPOTS_FULL: for i in range(n): mupdf.fz_set_separation_behavior(seps, i, mupdf.FZ_SEPARATION_SPOT) else: for i in range(n): mupdf.fz_set_separation_behavior(seps, i, mupdf.FZ_SEPARATION_COMPOSITE) elif mupdf.fz_page_uses_overprint(page): # This page uses overprint, so we need an empty # sep object to force the overprint simulation on. seps = mupdf.fz_new_separations(0) elif oi.m_internal and mupdf.fz_colorspace_n(oi) != mupdf.fz_colorspace_n(colorspace): # We have an output intent, and it's incompatible # with the colorspace our device needs. Force the # overprint simulation on, because this ensures that # we 'simulate' the output intent too. seps = mupdf.fz_new_separations(0) pix = mupdf.fz_new_pixmap_with_bbox(colorspace, bbox, seps, alpha) if alpha: mupdf.fz_clear_pixmap(pix) else: mupdf.fz_clear_pixmap_with_value(pix, 0xFF) dev = mupdf.fz_new_draw_device(matrix, pix) if annots: mupdf.fz_run_page(page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) else: mupdf.fz_run_page_contents(page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) mupdf.fz_close_device(dev) return pix def JM_StrAsChar(x): # fixme: should encode, but swig doesn't pass bytes to C as const char*. return x #return x.encode('utf8') def JM_TUPLE(o: typing.Sequence) -> tuple: return tuple(map(lambda x: round(x, 5) if abs(x) >= 1e-4 else 0, o)) def JM_TUPLE3(o: typing.Sequence) -> tuple: return tuple(map(lambda x: round(x, 3) if abs(x) >= 1e-3 else 0, o)) def JM_UnicodeFromStr(s): if s is None: return '' if isinstance(s, bytes): s = s.decode('utf8') assert isinstance(s, str), f'{type(s)=} {s=}' return s def JM_add_annot_id(annot, stem): ''' Add a unique /NM key to an annotation or widget. Append a number to 'stem' such that the result is a unique name. ''' assert isinstance(annot, mupdf.PdfAnnot) page = _pdf_annot_page(annot) annot_obj = mupdf.pdf_annot_obj( annot) names = JM_get_annot_id_list(page) i = 0 while 1: stem_id = f'{JM_annot_id_stem}-{stem}{i}' if stem_id not in names: break i += 1 response = JM_StrAsChar(stem_id) name = mupdf.pdf_new_string( response, len(response)) mupdf.pdf_dict_puts(annot_obj, "NM", name) page.doc().m_internal.resynth_required = 0 def JM_add_oc_object(pdf, ref, xref): ''' Add OC object reference to a dictionary ''' indobj = mupdf.pdf_new_indirect(pdf, xref, 0) if not mupdf.pdf_is_dict(indobj): RAISEPY(MSG_BAD_OC_REF, PyExc_ValueError) type_ = mupdf.pdf_dict_get(indobj, PDF_NAME('Type')) if (mupdf.pdf_objcmp(type_, PDF_NAME('OCG')) == 0 or mupdf.pdf_objcmp(type_, PDF_NAME('OCMD')) == 0 ): mupdf.pdf_dict_put(ref, PDF_NAME('OC'), indobj) else: RAISEPY(MSG_BAD_OC_REF, PyExc_ValueError) def JM_annot_border(annot_obj): dash_py = list() style = None width = -1 clouds = -1 obj = None obj = mupdf.pdf_dict_get( annot_obj, PDF_NAME('Border')) if mupdf.pdf_is_array( obj): width = mupdf.pdf_to_real( mupdf.pdf_array_get( obj, 2)) if mupdf.pdf_array_len( obj) == 4: dash = mupdf.pdf_array_get( obj, 3) for i in range( mupdf.pdf_array_len( dash)): val = mupdf.pdf_to_int( mupdf.pdf_array_get( dash, i)) dash_py.append( val) bs_o = mupdf.pdf_dict_get( annot_obj, PDF_NAME('BS')) if bs_o.m_internal: width = mupdf.pdf_to_real( mupdf.pdf_dict_get( bs_o, PDF_NAME('W'))) style = mupdf.pdf_to_name( mupdf.pdf_dict_get( bs_o, PDF_NAME('S'))) if style == '': style = None obj = mupdf.pdf_dict_get( bs_o, PDF_NAME('D')) if obj.m_internal: for i in range( mupdf.pdf_array_len( obj)): val = mupdf.pdf_to_int( mupdf.pdf_array_get( obj, i)) dash_py.append( val) obj = mupdf.pdf_dict_get( annot_obj, PDF_NAME('BE')) if obj.m_internal: clouds = mupdf.pdf_to_int( mupdf.pdf_dict_get( obj, PDF_NAME('I'))) res = dict() res[ dictkey_width] = width res[ dictkey_dashes] = tuple( dash_py) res[ dictkey_style] = style res[ 'clouds'] = clouds return res def JM_annot_colors(annot_obj): res = dict() bc = list() # stroke colors fc =list() # fill colors o = mupdf.pdf_dict_get(annot_obj, mupdf.PDF_ENUM_NAME_C) if mupdf.pdf_is_array(o): n = mupdf.pdf_array_len(o) for i in range(n): col = mupdf.pdf_to_real( mupdf.pdf_array_get(o, i)) bc.append(col) res[dictkey_stroke] = bc o = mupdf.pdf_dict_gets(annot_obj, "IC") if mupdf.pdf_is_array(o): n = mupdf.pdf_array_len(o) for i in range(n): col = mupdf.pdf_to_real( mupdf.pdf_array_get(o, i)) fc.append(col) res[dictkey_fill] = fc return res def JM_annot_set_border( border, doc, annot_obj): assert isinstance(border, dict) obj = None dashlen = 0 nwidth = border.get( dictkey_width) # new width ndashes = border.get( dictkey_dashes) # new dashes nstyle = border.get( dictkey_style) # new style nclouds = border.get( 'clouds', -1) # new clouds value # get old border properties oborder = JM_annot_border( annot_obj) # delete border-related entries mupdf.pdf_dict_del( annot_obj, PDF_NAME('BS')) mupdf.pdf_dict_del( annot_obj, PDF_NAME('BE')) mupdf.pdf_dict_del( annot_obj, PDF_NAME('Border')) # populate border items: keep old values for any omitted new ones if nwidth < 0: nwidth = oborder.get( dictkey_width) # no new width: keep current if ndashes is None: ndashes = oborder.get( dictkey_dashes) # no new dashes: keep old if nstyle is None: nstyle = oborder.get( dictkey_style) # no new style: keep old if nclouds < 0: nclouds = oborder.get( "clouds", -1) # no new clouds: keep old if isinstance( ndashes, tuple) and len( ndashes) > 0: dashlen = len( ndashes) darr = mupdf.pdf_new_array( doc, dashlen) for d in ndashes: mupdf.pdf_array_push_int( darr, d) mupdf.pdf_dict_putl( annot_obj, darr, PDF_NAME('BS'), PDF_NAME('D')) mupdf.pdf_dict_putl( annot_obj, mupdf.pdf_new_real( nwidth), PDF_NAME('BS'), PDF_NAME('W'), ) if dashlen == 0: obj = JM_get_border_style( nstyle) else: obj = PDF_NAME('D') mupdf.pdf_dict_putl( annot_obj, obj, PDF_NAME('BS'), PDF_NAME('S')) if nclouds > 0: mupdf.pdf_dict_put_dict( annot_obj, PDF_NAME('BE'), 2) obj = mupdf.pdf_dict_get( annot_obj, PDF_NAME('BE')) mupdf.pdf_dict_put( obj, PDF_NAME('S'), PDF_NAME('C')) mupdf.pdf_dict_put_int( obj, PDF_NAME('I'), nclouds) def make_escape(ch): if ch == 92: return "\\u005c" elif 32 <= ch <= 127 or ch == 10: return chr(ch) elif 0xd800 <= ch <= 0xdfff: # orphaned surrogate return "\\ufffd" elif ch <= 0xffff: return f"\\u{ch:04x}" else: return f"\\U{ch:08x}" def JM_append_rune(buff, ch): """ APPEND non-ascii runes in unicode escape format to fz_buffer. """ mupdf.fz_append_string(buff, make_escape(ch)) def JM_append_word(lines, buff, wbbox, block_n, line_n, word_n): ''' Functions for wordlist output ''' s = JM_EscapeStrFromBuffer(buff) litem = ( wbbox.x0, wbbox.y0, wbbox.x1, wbbox.y1, s, block_n, line_n, word_n, ) lines.append(litem) return word_n + 1, mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) # word counter def JM_add_layer_config( pdf, name, creator, ON): ''' Add OC configuration to the PDF catalog ''' ocp = JM_ensure_ocproperties( pdf) configs = mupdf.pdf_dict_get( ocp, PDF_NAME('Configs')) if not mupdf.pdf_is_array( configs): configs = mupdf.pdf_dict_put_array( ocp, PDF_NAME('Configs'), 1) D = mupdf.pdf_new_dict( pdf, 5) mupdf.pdf_dict_put_text_string( D, PDF_NAME('Name'), name) if creator is not None: mupdf.pdf_dict_put_text_string( D, PDF_NAME('Creator'), creator) mupdf.pdf_dict_put( D, PDF_NAME('BaseState'), PDF_NAME('OFF')) onarray = mupdf.pdf_dict_put_array( D, PDF_NAME('ON'), 5) if not ON: pass else: ocgs = mupdf.pdf_dict_get( ocp, PDF_NAME('OCGs')) n = len(ON) for i in range(n): xref = 0 e, xref = JM_INT_ITEM(ON, i) if e == 1: continue ind = mupdf.pdf_new_indirect( pdf, xref, 0) if mupdf.pdf_array_contains( ocgs, ind): mupdf.pdf_array_push( onarray, ind) mupdf.pdf_array_push( configs, D) def JM_char_bbox(line, ch): ''' return rect of char quad ''' q = JM_char_quad(line, ch) r = mupdf.fz_rect_from_quad(q) if not line.m_internal.wmode: return r if r.y1 < r.y0 + ch.m_internal.size: r.y0 = r.y1 - ch.m_internal.size return r def JM_char_font_flags(font, line, ch): flags = 0 if line and ch: flags += detect_super_script(line, ch) flags += mupdf.fz_font_is_italic(font) * TEXT_FONT_ITALIC flags += mupdf.fz_font_is_serif(font) * TEXT_FONT_SERIFED flags += mupdf.fz_font_is_monospaced(font) * TEXT_FONT_MONOSPACED flags += mupdf.fz_font_is_bold(font) * TEXT_FONT_BOLD return flags def JM_char_quad(line, ch): ''' re-compute char quad if ascender/descender values make no sense ''' if 1 and g_use_extra: # This reduces time taken to extract text from PyMuPDF.pdf from 20s to # 15s. return mupdf.FzQuad(extra.JM_char_quad( line.m_internal, ch.m_internal)) assert isinstance(line, mupdf.FzStextLine) assert isinstance(ch, mupdf.FzStextChar) if _globals.skip_quad_corrections: # no special handling return ch.quad if line.m_internal.wmode: # never touch vertical write mode return ch.quad font = mupdf.FzFont(mupdf.ll_fz_keep_font(ch.m_internal.font)) asc = JM_font_ascender(font) dsc = JM_font_descender(font) fsize = ch.m_internal.size asc_dsc = asc - dsc + FLT_EPSILON if asc_dsc >= 1 and _globals.small_glyph_heights == 0: # no problem return mupdf.FzQuad(ch.m_internal.quad) # Re-compute quad with adjusted ascender / descender values: # Move ch->origin to (0,0) and de-rotate quad, then adjust the corners, # re-rotate and move back to ch->origin location. fsize = ch.m_internal.size bbox = mupdf.fz_font_bbox(font) fwidth = bbox.x1 - bbox.x0 if asc < 1e-3: # probably Tesseract glyphless font dsc = -0.1 asc = 0.9 asc_dsc = 1.0 if _globals.small_glyph_heights or asc_dsc < 1: dsc = dsc / asc_dsc asc = asc / asc_dsc asc_dsc = asc - dsc asc = asc * fsize / asc_dsc dsc = dsc * fsize / asc_dsc # Re-compute quad with the adjusted ascender / descender values: # Move ch->origin to (0,0) and de-rotate quad, then adjust the corners, # re-rotate and move back to ch->origin location. c = line.m_internal.dir.x # cosine s = line.m_internal.dir.y # sine trm1 = mupdf.fz_make_matrix(c, -s, s, c, 0, 0) # derotate trm2 = mupdf.fz_make_matrix(c, s, -s, c, 0, 0) # rotate if (c == -1): # left-right flip trm1.d = 1 trm2.d = 1 xlate1 = mupdf.fz_make_matrix(1, 0, 0, 1, -ch.m_internal.origin.x, -ch.m_internal.origin.y) xlate2 = mupdf.fz_make_matrix(1, 0, 0, 1, ch.m_internal.origin.x, ch.m_internal.origin.y) quad = mupdf.fz_transform_quad(mupdf.FzQuad(ch.m_internal.quad), xlate1) # move origin to (0,0) quad = mupdf.fz_transform_quad(quad, trm1) # de-rotate corners # adjust vertical coordinates if c == 1 and quad.ul.y > 0: # up-down flip quad.ul.y = asc quad.ur.y = asc quad.ll.y = dsc quad.lr.y = dsc else: quad.ul.y = -asc quad.ur.y = -asc quad.ll.y = -dsc quad.lr.y = -dsc # adjust horizontal coordinates that are too crazy: # (1) left x must be >= 0 # (2) if bbox width is 0, lookup char advance in font. if quad.ll.x < 0: quad.ll.x = 0 quad.ul.x = 0 cwidth = quad.lr.x - quad.ll.x if cwidth < FLT_EPSILON: glyph = mupdf.fz_encode_character( font, ch.m_internal.c) if glyph: fwidth = mupdf.fz_advance_glyph( font, glyph, line.m_internal.wmode) quad.lr.x = quad.ll.x + fwidth * fsize quad.ur.x = quad.lr.x quad = mupdf.fz_transform_quad(quad, trm2) # rotate back quad = mupdf.fz_transform_quad(quad, xlate2) # translate back return quad def JM_choice_options(annot): ''' return list of choices for list or combo boxes ''' annot_obj = mupdf.pdf_annot_obj( annot.this) opts = mupdf.pdf_choice_widget_options2( annot, 0) n = len( opts) if n == 0: return # wrong widget type optarr = mupdf.pdf_dict_get( annot_obj, PDF_NAME('Opt')) liste = [] for i in range( n): m = mupdf.pdf_array_len( mupdf.pdf_array_get( optarr, i)) if m == 2: val = ( mupdf.pdf_to_text_string( mupdf.pdf_array_get( mupdf.pdf_array_get( optarr, i), 0)), mupdf.pdf_to_text_string( mupdf.pdf_array_get( mupdf.pdf_array_get( optarr, i), 1)), ) liste.append( val) else: val = mupdf.pdf_to_text_string( mupdf.pdf_array_get( optarr, i)) liste.append( val) return liste def JM_clear_pixmap_rect_with_value(dest, value, b): ''' Clear a pixmap rectangle - my version also supports non-alpha pixmaps ''' b = mupdf.fz_intersect_irect(b, mupdf.fz_pixmap_bbox(dest)) w = b.x1 - b.x0 y = b.y1 - b.y0 if w <= 0 or y <= 0: return 0 destspan = dest.stride() destp = destspan * (b.y0 - dest.y()) + dest.n() * (b.x0 - dest.x()) # CMYK needs special handling (and potentially any other subtractive colorspaces) if mupdf.fz_colorspace_n(dest.colorspace()) == 4: value = 255 - value while 1: s = destp for x in range(0, w): mupdf.fz_samples_set(dest, s, 0) s += 1 mupdf.fz_samples_set(dest, s, 0) s += 1 mupdf.fz_samples_set(dest, s, 0) s += 1 mupdf.fz_samples_set(dest, s, value) s += 1 if dest.alpha(): mupdf.fz_samples_set(dest, s, 255) s += 1 destp += destspan if y == 0: break y -= 1 return 1 while 1: s = destp for x in range(w): for k in range(dest.n()-1): mupdf.fz_samples_set(dest, s, value) s += 1 if dest.alpha(): mupdf.fz_samples_set(dest, s, 255) s += 1 else: mupdf.fz_samples_set(dest, s, value) s += 1 destp += destspan if y == 0: break y -= 1 return 1 def JM_color_FromSequence(color): if isinstance(color, (int, float)): # maybe just a single float color = [color] if not isinstance( color, (list, tuple)): return -1, [] if len(color) not in (0, 1, 3, 4): return -1, [] ret = color[:] for i in range(len(ret)): if ret[i] < 0 or ret[i] > 1: ret[i] = 1 return len(ret), ret def JM_color_count( pm, clip): if 1 or g_use_extra: return extra.ll_JM_color_count(pm.m_internal, clip) rc = dict() cnt = 0 irect = mupdf.fz_pixmap_bbox( pm) irect = mupdf.fz_intersect_irect(irect, mupdf.fz_round_rect(JM_rect_from_py(clip))) stride = pm.stride() width = irect.x1 - irect.x0 height = irect.y1 - irect.y0 n = pm.n() substride = width * n s = stride * (irect.y0 - pm.y()) + (irect.x0 - pm.x()) * n oldpix = _read_samples( pm, s, n) cnt = 0 if mupdf.fz_is_empty_irect(irect): return rc for i in range( height): for j in range( 0, substride, n): newpix = _read_samples( pm, s + j, n) if newpix != oldpix: pixel = oldpix c = rc.get( pixel, None) if c is not None: cnt += c rc[ pixel] = cnt cnt = 1 oldpix = newpix else: cnt += 1 s += stride pixel = oldpix c = rc.get( pixel) if c is not None: cnt += c rc[ pixel] = cnt return rc def JM_compress_buffer(inbuffer): ''' compress char* into a new buffer ''' data, compressed_length = mupdf.fz_new_deflated_data_from_buffer( inbuffer, mupdf.FZ_DEFLATE_BEST, ) #log(f'{data compressed_length=}') if not data or compressed_length == 0: return None buf = mupdf.FzBuffer(mupdf.fz_new_buffer_from_data(data, compressed_length)) mupdf.fz_resize_buffer(buf, compressed_length) return buf def JM_copy_rectangle(page, area): need_new_line = 0 buffer = io.StringIO() for block in page: if block.m_internal.type != mupdf.FZ_STEXT_BLOCK_TEXT: continue for line in block: line_had_text = 0 for ch in line: r = JM_char_bbox(line, ch) if JM_rects_overlap(area, r): line_had_text = 1 if need_new_line: buffer.write("\n") need_new_line = 0 buffer.write(make_escape(ch.m_internal.c)) if line_had_text: need_new_line = 1 s = buffer.getvalue() # take over the data return s def JM_convert_to_pdf(doc, fp, tp, rotate): ''' Convert any MuPDF document to a PDF Returns bytes object containing the PDF, created via 'write' function. ''' pdfout = mupdf.PdfDocument() incr = 1 s = fp e = tp if fp > tp: incr = -1 # count backwards s = tp # adjust ... e = fp # ... range rot = JM_norm_rotation(rotate) i = fp while 1: # interpret & write document pages as PDF pages if not _INRANGE(i, s, e): break page = mupdf.fz_load_page(doc, i) mediabox = mupdf.fz_bound_page(page) dev, resources, contents = mupdf.pdf_page_write(pdfout, mediabox) mupdf.fz_run_page(page, dev, mupdf.FzMatrix(), mupdf.FzCookie()) mupdf.fz_close_device(dev) dev = None page_obj = mupdf.pdf_add_page(pdfout, mediabox, rot, resources, contents) mupdf.pdf_insert_page(pdfout, -1, page_obj) i += incr # PDF created - now write it to Python bytearray # prepare write options structure opts = mupdf.PdfWriteOptions() opts.do_garbage = 4 opts.do_compress = 1 opts.do_compress_images = 1 opts.do_compress_fonts = 1 opts.do_sanitize = 1 opts.do_incremental = 0 opts.do_ascii = 0 opts.do_decompress = 0 opts.do_linear = 0 opts.do_clean = 1 opts.do_pretty = 0 res = mupdf.fz_new_buffer(8192) out = mupdf.FzOutput(res) mupdf.pdf_write_document(pdfout, out, opts) out.fz_close_output() c = mupdf.fz_buffer_extract_copy(res) assert isinstance(c, bytes) return c # Copied from MuPDF v1.14 # Create widget def JM_create_widget(doc, page, type, fieldname): old_sigflags = mupdf.pdf_to_int(mupdf.pdf_dict_getp(mupdf.pdf_trailer(doc), "Root/AcroForm/SigFlags")) #log( '*** JM_create_widget()') #log( f'{mupdf.pdf_create_annot_raw=}') #log( f'{page=}') #log( f'{mupdf.PDF_ANNOT_WIDGET=}') annot = mupdf.pdf_create_annot_raw(page, mupdf.PDF_ANNOT_WIDGET) annot_obj = mupdf.pdf_annot_obj(annot) try: JM_set_field_type(doc, annot_obj, type) mupdf.pdf_dict_put_text_string(annot_obj, PDF_NAME('T'), fieldname) if type == mupdf.PDF_WIDGET_TYPE_SIGNATURE: sigflags = old_sigflags | (SigFlag_SignaturesExist | SigFlag_AppendOnly) mupdf.pdf_dict_putl( mupdf.pdf_trailer(doc), mupdf.pdf_new_int(sigflags), PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('SigFlags'), ) # pdf_create_annot will have linked the new widget into the page's # annot array. We also need it linked into the document's form form = mupdf.pdf_dict_getp(mupdf.pdf_trailer(doc), "Root/AcroForm/Fields") if not form.m_internal: form = mupdf.pdf_new_array(doc, 1) mupdf.pdf_dict_putl( mupdf.pdf_trailer(doc), form, PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('Fields'), ) mupdf.pdf_array_push(form, annot_obj) # Cleanup relies on this statement being last except Exception: if g_exceptions_verbose: exception_info() mupdf.pdf_delete_annot(page, annot) if type == mupdf.PDF_WIDGET_TYPE_SIGNATURE: mupdf.pdf_dict_putl( mupdf.pdf_trailer(doc), mupdf.pdf_new_int(old_sigflags), PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('SigFlags'), ) raise return annot def JM_cropbox(page_obj): ''' return a PDF page's CropBox ''' if g_use_extra: return extra.JM_cropbox(page_obj) mediabox = JM_mediabox(page_obj) cropbox = mupdf.pdf_to_rect( mupdf.pdf_dict_get_inheritable(page_obj, PDF_NAME('CropBox')) ) if mupdf.fz_is_infinite_rect(cropbox) or mupdf.fz_is_empty_rect(cropbox): cropbox = mediabox y0 = mediabox.y1 - cropbox.y1 y1 = mediabox.y1 - cropbox.y0 cropbox.y0 = y0 cropbox.y1 = y1 return cropbox def JM_cropbox_size(page_obj): rect = JM_cropbox(page_obj) w = abs(rect.x1 - rect.x0) h = abs(rect.y1 - rect.y0) size = mupdf.fz_make_point(w, h) return size def JM_derotate_page_matrix(page): ''' just the inverse of rotation ''' mp = JM_rotate_page_matrix(page) return mupdf.fz_invert_matrix(mp) def JM_embed_file( pdf, buf, filename, ufilename, desc, compress, ): ''' embed a new file in a PDF (not only /EmbeddedFiles entries) ''' len_ = 0 val = mupdf.pdf_new_dict(pdf, 6) mupdf.pdf_dict_put_dict(val, PDF_NAME('CI'), 4) ef = mupdf.pdf_dict_put_dict(val, PDF_NAME('EF'), 4) mupdf.pdf_dict_put_text_string(val, PDF_NAME('F'), filename) mupdf.pdf_dict_put_text_string(val, PDF_NAME('UF'), ufilename) mupdf.pdf_dict_put_text_string(val, PDF_NAME('Desc'), desc) mupdf.pdf_dict_put(val, PDF_NAME('Type'), PDF_NAME('Filespec')) bs = b' ' f = mupdf.pdf_add_stream( pdf, #mupdf.fz_fz_new_buffer_from_copied_data(bs), mupdf.fz_new_buffer_from_copied_data(bs), mupdf.PdfObj(), 0, ) mupdf.pdf_dict_put(ef, PDF_NAME('F'), f) JM_update_stream(pdf, f, buf, compress) len_, _ = mupdf.fz_buffer_storage(buf) mupdf.pdf_dict_put_int(f, PDF_NAME('DL'), len_) mupdf.pdf_dict_put_int(f, PDF_NAME('Length'), len_) params = mupdf.pdf_dict_put_dict(f, PDF_NAME('Params'), 4) mupdf.pdf_dict_put_int(params, PDF_NAME('Size'), len_) return val def JM_embedded_clean(pdf): ''' perform some cleaning if we have /EmbeddedFiles: (1) remove any /Limits if /Names exists (2) remove any empty /Collection (3) set /PageMode/UseAttachments ''' root = mupdf.pdf_dict_get( mupdf.pdf_trailer( pdf), PDF_NAME('Root')) # remove any empty /Collection entry coll = mupdf.pdf_dict_get(root, PDF_NAME('Collection')) if coll.m_internal and mupdf.pdf_dict_len(coll) == 0: mupdf.pdf_dict_del(root, PDF_NAME('Collection')) efiles = mupdf.pdf_dict_getl( root, PDF_NAME('Names'), PDF_NAME('EmbeddedFiles'), PDF_NAME('Names'), ) if efiles.m_internal: mupdf.pdf_dict_put_name(root, PDF_NAME('PageMode'), "UseAttachments") def JM_EscapeStrFromBuffer(buff): if not buff.m_internal: return '' s = mupdf.fz_buffer_extract_copy(buff) val = PyUnicode_DecodeRawUnicodeEscape(s, errors='replace') return val def JM_ensure_identity(pdf): ''' Store ID in PDF trailer ''' id_ = mupdf.pdf_dict_get( mupdf.pdf_trailer(pdf), PDF_NAME('ID')) if not id_.m_internal: rnd0 = mupdf.fz_memrnd2(16) # Need to convert raw bytes into a str to send to # mupdf.pdf_new_string(). chr() seems to work for this. rnd = '' for i in rnd0: rnd += chr(i) id_ = mupdf.pdf_dict_put_array( mupdf.pdf_trailer( pdf), PDF_NAME('ID'), 2) mupdf.pdf_array_push( id_, mupdf.pdf_new_string( rnd, len(rnd))) mupdf.pdf_array_push( id_, mupdf.pdf_new_string( rnd, len(rnd))) def JM_ensure_ocproperties(pdf): ''' Ensure OCProperties, return /OCProperties key ''' ocp = mupdf.pdf_dict_get(mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')), PDF_NAME('OCProperties')) if ocp.m_internal: return ocp root = mupdf.pdf_dict_get(mupdf.pdf_trailer(pdf), PDF_NAME('Root')) ocp = mupdf.pdf_dict_put_dict(root, PDF_NAME('OCProperties'), 2) mupdf.pdf_dict_put_array(ocp, PDF_NAME('OCGs'), 0) D = mupdf.pdf_dict_put_dict(ocp, PDF_NAME('D'), 5) mupdf.pdf_dict_put_array(D, PDF_NAME('ON'), 0) mupdf.pdf_dict_put_array(D, PDF_NAME('OFF'), 0) mupdf.pdf_dict_put_array(D, PDF_NAME('Order'), 0) mupdf.pdf_dict_put_array(D, PDF_NAME('RBGroups'), 0) return ocp def JM_expand_fname(name): ''' Make /DA string of annotation ''' if not name: return "Helv" if name.startswith("Co"): return "Cour" if name.startswith("co"): return "Cour" if name.startswith("Ti"): return "TiRo" if name.startswith("ti"): return "TiRo" if name.startswith("Sy"): return "Symb" if name.startswith("sy"): return "Symb" if name.startswith("Za"): return "ZaDb" if name.startswith("za"): return "ZaDb" return "Helv" def JM_field_type_text(wtype): ''' String from widget type ''' if wtype == mupdf.PDF_WIDGET_TYPE_BUTTON: return "Button" if wtype == mupdf.PDF_WIDGET_TYPE_CHECKBOX: return "CheckBox" if wtype == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON: return "RadioButton" if wtype == mupdf.PDF_WIDGET_TYPE_TEXT: return "Text" if wtype == mupdf.PDF_WIDGET_TYPE_LISTBOX: return "ListBox" if wtype == mupdf.PDF_WIDGET_TYPE_COMBOBOX: return "ComboBox" if wtype == mupdf.PDF_WIDGET_TYPE_SIGNATURE: return "Signature" return "unknown" def JM_fill_pixmap_rect_with_color(dest, col, b): assert isinstance(dest, mupdf.FzPixmap) # fill a rect with a color tuple b = mupdf.fz_intersect_irect(b, mupdf.fz_pixmap_bbox( dest)) w = b.x1 - b.x0 y = b.y1 - b.y0 if w <= 0 or y <= 0: return 0 destspan = dest.stride() destp = destspan * (b.y0 - dest.y()) + dest.n() * (b.x0 - dest.x()) while 1: s = destp for x in range(w): for i in range( dest.n()): mupdf.fz_samples_set(dest, s, col[i]) s += 1 destp += destspan y -= 1 if y == 0: break return 1 def JM_find_annot_irt(annot): ''' Return the first annotation whose /IRT key ("In Response To") points to annot. Used to remove the response chain of a given annotation. ''' assert isinstance(annot, mupdf.PdfAnnot) irt_annot = None # returning this annot_obj = mupdf.pdf_annot_obj(annot) found = 0 # loop thru MuPDF's internal annots array page = _pdf_annot_page(annot) irt_annot = mupdf.pdf_first_annot(page) while 1: assert isinstance(irt_annot, mupdf.PdfAnnot) if not irt_annot.m_internal: break irt_annot_obj = mupdf.pdf_annot_obj(irt_annot) o = mupdf.pdf_dict_gets(irt_annot_obj, 'IRT') if o.m_internal: if not mupdf.pdf_objcmp(o, annot_obj): found = 1 break irt_annot = mupdf.pdf_next_annot(irt_annot) if found: return irt_annot def JM_font_ascender(font): ''' need own versions of ascender / descender ''' assert isinstance(font, mupdf.FzFont) if _globals.skip_quad_corrections: return 0.8 return mupdf.fz_font_ascender(font) def JM_font_descender(font): ''' need own versions of ascender / descender ''' assert isinstance(font, mupdf.FzFont) if _globals.skip_quad_corrections: return -0.2 ret = mupdf.fz_font_descender(font) return ret def JM_is_word_delimiter(ch, delimiters): """Check if ch is an extra word delimiting character. """ if (0 or ch <= 32 or ch == 160 or 0x202a <= ch <= 0x202e ): # covers any whitespace plus unicodes that switch between # right-to-left and left-to-right languages return True if not delimiters: # no extra delimiters provided return False char = chr(ch) for d in delimiters: if d == char: return True return False def JM_is_rtl_char(ch): if ch < 0x590 or ch > 0x900: return False return True def JM_font_name(font): assert isinstance(font, mupdf.FzFont) name = mupdf.fz_font_name(font) s = name.find('+') if _globals.subset_fontnames or s == -1 or s != 6: return name return name[s + 1:] def JM_gather_fonts(pdf, dict_, fontlist, stream_xref): rc = 1 n = mupdf.pdf_dict_len(dict_) for i in range(n): refname = mupdf.pdf_dict_get_key(dict_, i) fontdict = mupdf.pdf_dict_get_val(dict_, i) if not mupdf.pdf_is_dict(fontdict): mupdf.fz_warn( f"'{mupdf.pdf_to_name(refname)}' is no font dict ({mupdf.pdf_to_num(fontdict)} 0 R)") continue subtype = mupdf.pdf_dict_get(fontdict, mupdf.PDF_ENUM_NAME_Subtype) basefont = mupdf.pdf_dict_get(fontdict, mupdf.PDF_ENUM_NAME_BaseFont) if not basefont.m_internal or mupdf.pdf_is_null(basefont): name = mupdf.pdf_dict_get(fontdict, mupdf.PDF_ENUM_NAME_Name) else: name = basefont encoding = mupdf.pdf_dict_get(fontdict, mupdf.PDF_ENUM_NAME_Encoding) if mupdf.pdf_is_dict(encoding): encoding = mupdf.pdf_dict_get(encoding, mupdf.PDF_ENUM_NAME_BaseEncoding) xref = mupdf.pdf_to_num(fontdict) ext = "n/a" if xref: ext = JM_get_fontextension(pdf, xref) entry = ( xref, ext, mupdf.pdf_to_name(subtype), JM_EscapeStrFromStr(mupdf.pdf_to_name(name)), mupdf.pdf_to_name(refname), mupdf.pdf_to_name(encoding), stream_xref, ) fontlist.append(entry) return rc def JM_gather_forms(doc, dict_: mupdf.PdfObj, imagelist, stream_xref: int): ''' Store info of a /Form xobject in Python list ''' assert isinstance(doc, mupdf.PdfDocument) rc = 1 n = mupdf.pdf_dict_len(dict_) for i in range(n): refname = mupdf.pdf_dict_get_key( dict_, i) imagedict = mupdf.pdf_dict_get_val(dict_, i) if not mupdf.pdf_is_dict(imagedict): mupdf.fz_warn( f"'{mupdf.pdf_to_name(refname)}' is no form dict ({mupdf.pdf_to_num(imagedict)} 0 R)") continue type_ = mupdf.pdf_dict_get(imagedict, PDF_NAME('Subtype')) if not mupdf.pdf_name_eq(type_, PDF_NAME('Form')): continue o = mupdf.pdf_dict_get(imagedict, PDF_NAME('BBox')) m = mupdf.pdf_dict_get(imagedict, PDF_NAME('Matrix')) if m.m_internal: mat = mupdf.pdf_to_matrix(m) else: mat = mupdf.FzMatrix() if o.m_internal: bbox = mupdf.fz_transform_rect( mupdf.pdf_to_rect(o), mat) else: bbox = mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE) xref = mupdf.pdf_to_num(imagedict) entry = ( xref, mupdf.pdf_to_name( refname), stream_xref, JM_py_from_rect(bbox), ) imagelist.append(entry) return rc def JM_gather_images(doc: mupdf.PdfDocument, dict_: mupdf.PdfObj, imagelist, stream_xref: int): ''' Store info of an image in Python list ''' rc = 1 n = mupdf.pdf_dict_len( dict_) for i in range(n): refname = mupdf.pdf_dict_get_key(dict_, i) imagedict = mupdf.pdf_dict_get_val(dict_, i) if not mupdf.pdf_is_dict(imagedict): mupdf.fz_warn(f"'{mupdf.pdf_to_name(refname)}' is no image dict ({mupdf.pdf_to_num(imagedict)} 0 R)") continue type_ = mupdf.pdf_dict_get(imagedict, PDF_NAME('Subtype')) if not mupdf.pdf_name_eq(type_, PDF_NAME('Image')): continue xref = mupdf.pdf_to_num(imagedict) gen = 0 smask = mupdf.pdf_dict_geta(imagedict, PDF_NAME('SMask'), PDF_NAME('Mask')) if smask.m_internal: gen = mupdf.pdf_to_num(smask) filter_ = mupdf.pdf_dict_geta(imagedict, PDF_NAME('Filter'), PDF_NAME('F')) if mupdf.pdf_is_array(filter_): filter_ = mupdf.pdf_array_get(filter_, 0) altcs = mupdf.PdfObj(0) cs = mupdf.pdf_dict_geta(imagedict, PDF_NAME('ColorSpace'), PDF_NAME('CS')) if mupdf.pdf_is_array(cs): cses = cs cs = mupdf.pdf_array_get(cses, 0) if (mupdf.pdf_name_eq(cs, PDF_NAME('DeviceN')) or mupdf.pdf_name_eq(cs, PDF_NAME('Separation')) ): altcs = mupdf.pdf_array_get(cses, 2) if mupdf.pdf_is_array(altcs): altcs = mupdf.pdf_array_get(altcs, 0) width = mupdf.pdf_dict_geta(imagedict, PDF_NAME('Width'), PDF_NAME('W')) height = mupdf.pdf_dict_geta(imagedict, PDF_NAME('Height'), PDF_NAME('H')) bpc = mupdf.pdf_dict_geta(imagedict, PDF_NAME('BitsPerComponent'), PDF_NAME('BPC')) entry = ( xref, gen, mupdf.pdf_to_int(width), mupdf.pdf_to_int(height), mupdf.pdf_to_int(bpc), JM_EscapeStrFromStr(mupdf.pdf_to_name(cs)), JM_EscapeStrFromStr(mupdf.pdf_to_name(altcs)), JM_EscapeStrFromStr(mupdf.pdf_to_name(refname)), JM_EscapeStrFromStr(mupdf.pdf_to_name(filter_)), stream_xref, ) imagelist.append(entry) return rc def JM_get_annot_by_xref(page, xref): ''' retrieve annot by its xref ''' assert isinstance(page, mupdf.PdfPage) found = 0 # loop thru MuPDF's internal annots array annot = mupdf.pdf_first_annot(page) while 1: if not annot.m_internal: break if xref == mupdf.pdf_to_num(mupdf.pdf_annot_obj(annot)): found = 1 break annot = mupdf.pdf_next_annot( annot) if not found: raise Exception(f"xref {xref:d} is not an annot of this page") return annot def JM_get_annot_by_name(page, name): ''' retrieve annot by name (/NM key) ''' assert isinstance(page, mupdf.PdfPage) if not name: return found = 0 # loop thru MuPDF's internal annots and widget arrays annot = mupdf.pdf_first_annot(page) while 1: if not annot.m_internal: break response, len_ = mupdf.pdf_to_string(mupdf.pdf_dict_gets(mupdf.pdf_annot_obj(annot), "NM")) if name == response: found = 1 break annot = mupdf.pdf_next_annot(annot) if not found: raise Exception(f"'{name}' is not an annot of this page") return annot def JM_get_annot_id_list(page): names = [] annots = mupdf.pdf_dict_get( page.obj(), mupdf.PDF_ENUM_NAME_Annots) if not annots.m_internal: return names for i in range( mupdf.pdf_array_len(annots)): annot_obj = mupdf.pdf_array_get(annots, i) name = mupdf.pdf_dict_gets(annot_obj, "NM") if name.m_internal: names.append( mupdf.pdf_to_text_string(name) ) return names def JM_get_annot_xref_list( page_obj): ''' return the xrefs and /NM ids of a page's annots, links and fields ''' if g_use_extra: names = extra.JM_get_annot_xref_list( page_obj) return names names = [] annots = mupdf.pdf_dict_get( page_obj, PDF_NAME('Annots')) n = mupdf.pdf_array_len( annots) for i in range( n): annot_obj = mupdf.pdf_array_get( annots, i) xref = mupdf.pdf_to_num( annot_obj) subtype = mupdf.pdf_dict_get( annot_obj, PDF_NAME('Subtype')) if not subtype.m_internal: continue # subtype is required type_ = mupdf.pdf_annot_type_from_string( mupdf.pdf_to_name( subtype)) if type_ == mupdf.PDF_ANNOT_UNKNOWN: continue # only accept valid annot types id_ = mupdf.pdf_dict_gets( annot_obj, "NM") names.append( (xref, type_, mupdf.pdf_to_text_string( id_))) return names def JM_get_annot_xref_list2(page): page = page._pdf_page(required=False) if not page.m_internal: return list() return JM_get_annot_xref_list( page.obj()) def JM_get_border_style(style): ''' return pdf_obj "border style" from Python str ''' val = mupdf.PDF_ENUM_NAME_S if style is None: return val s = style if s.startswith("b") or s.startswith("B"): val = mupdf.PDF_ENUM_NAME_B elif s.startswith("d") or s.startswith("D"): val = mupdf.PDF_ENUM_NAME_D elif s.startswith("i") or s.startswith("I"): val = mupdf.PDF_ENUM_NAME_I elif s.startswith("u") or s.startswith("U"): val = mupdf.PDF_ENUM_NAME_U elif s.startswith("s") or s.startswith("S"): val = mupdf.PDF_ENUM_NAME_S return val def JM_get_font( fontname, fontfile, fontbuffer, script, lang, ordering, is_bold, is_italic, is_serif, embed, ): ''' return a fz_font from a number of parameters ''' def fertig(font): if not font.m_internal: raise RuntimeError(MSG_FONT_FAILED) # if font allows this, set embedding if not font.m_internal.flags.never_embed: mupdf.fz_set_font_embedding(font, embed) return font index = 0 font = None if fontfile: #goto have_file; font = mupdf.fz_new_font_from_file( None, fontfile, index, 0) return fertig(font) if fontbuffer: #goto have_buffer; res = JM_BufferFromBytes(fontbuffer) font = mupdf.fz_new_font_from_buffer( None, res, index, 0) return fertig(font) if ordering > -1: # goto have_cjk; font = mupdf.fz_new_cjk_font(ordering) return fertig(font) if fontname: # goto have_base14; # Base-14 or a MuPDF builtin font font = mupdf.fz_new_base14_font(fontname) if font.m_internal: return fertig(font) font = mupdf.fz_new_builtin_font(fontname, is_bold, is_italic) return fertig(font) # Check for NOTO font #have_noto:; data, size, index = mupdf.fz_lookup_noto_font( script, lang) font = None if data: font = mupdf.fz_new_font_from_memory( None, data, size, index, 0) if font.m_internal: return fertig(font) font = mupdf.fz_load_fallback_font( script, lang, is_serif, is_bold, is_italic) return fertig(font) def JM_get_fontbuffer(doc, xref): ''' Return the contents of a font file, identified by xref ''' if xref < 1: return o = mupdf.pdf_load_object(doc, xref) desft = mupdf.pdf_dict_get(o, PDF_NAME('DescendantFonts')) if desft.m_internal: obj = mupdf.pdf_resolve_indirect(mupdf.pdf_array_get(desft, 0)) obj = mupdf.pdf_dict_get(obj, PDF_NAME('FontDescriptor')) else: obj = mupdf.pdf_dict_get(o, PDF_NAME('FontDescriptor')) if not obj.m_internal: message(f"invalid font - FontDescriptor missing") return o = obj stream = None obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile')) if obj.m_internal: stream = obj # ext = "pfa" obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile2')) if obj.m_internal: stream = obj # ext = "ttf" obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile3')) if obj.m_internal: stream = obj obj = mupdf.pdf_dict_get(obj, PDF_NAME('Subtype')) if obj.m_internal and not mupdf.pdf_is_name(obj): message("invalid font descriptor subtype") return if mupdf.pdf_name_eq(obj, PDF_NAME('Type1C')): pass # Prev code did: ext = "cff", but this has no effect. elif mupdf.pdf_name_eq(obj, PDF_NAME('CIDFontType0C')): pass # Prev code did: ext = "cid", but this has no effect. elif mupdf.pdf_name_eq(obj, PDF_NAME('OpenType')): pass # Prev code did: ext = "otf", but this has no effect. */ else: message(f'warning: unhandled font type {mupdf.pdf_to_name(obj)!r}') if not stream: message('warning: unhandled font type') return return mupdf.pdf_load_stream(stream) def JM_get_resource_properties(ref): ''' Return the items of Resources/Properties (used for Marked Content) Argument may be e.g. a page object or a Form XObject ''' properties = mupdf.pdf_dict_getl(ref, PDF_NAME('Resources'), PDF_NAME('Properties')) if not properties.m_internal: return () else: n = mupdf.pdf_dict_len(properties) if n < 1: return () rc = [] for i in range(n): key = mupdf.pdf_dict_get_key(properties, i) val = mupdf.pdf_dict_get_val(properties, i) c = mupdf.pdf_to_name(key) xref = mupdf.pdf_to_num(val) rc.append((c, xref)) return rc def JM_get_widget_by_xref( page, xref): ''' retrieve widget by its xref ''' found = False annot = mupdf.pdf_first_widget( page) while annot.m_internal: annot_obj = mupdf.pdf_annot_obj( annot) if xref == mupdf.pdf_to_num( annot_obj): found = True break annot = mupdf.pdf_next_widget( annot) if not found: raise Exception( f"xref {xref} is not a widget of this page") return Annot( annot) def JM_get_widget_properties(annot, Widget): ''' Populate a Python Widget object with the values from a PDF form field. Called by "Page.first_widget" and "Widget.next". ''' #log(f'{type(annot)=}') annot_obj = mupdf.pdf_annot_obj(annot.this) #log( 'Have called mupdf.pdf_annot_obj()') page = _pdf_annot_page(annot.this) pdf = page.doc() tw = annot def SETATTR(key, value): setattr(Widget, key, value) def SETATTR_DROP(mod, key, value): # Original C code for this function deletes if PyObject* is NULL. We # don't have a representation for that in Python - e.g. None is not # represented by NULL. setattr(mod, key, value) #log( '=== + mupdf.pdf_widget_type(tw)') field_type = mupdf.pdf_widget_type(tw.this) #log( '=== - mupdf.pdf_widget_type(tw)') Widget.field_type = field_type if field_type == mupdf.PDF_WIDGET_TYPE_SIGNATURE: if mupdf.pdf_signature_is_signed(pdf, annot_obj): SETATTR("is_signed", True) else: SETATTR("is_signed",False) else: SETATTR("is_signed", None) SETATTR_DROP(Widget, "border_style", JM_UnicodeFromStr(mupdf.pdf_field_border_style(annot_obj))) SETATTR_DROP(Widget, "field_type_string", JM_UnicodeFromStr(JM_field_type_text(field_type))) field_name = mupdf.pdf_load_field_name(annot_obj) SETATTR_DROP(Widget, "field_name", field_name) def pdf_dict_get_inheritable_nonempty_label(node, key): ''' This is a modified version of MuPDF's pdf_dict_get_inheritable(), with some changes: * Returns string from pdf_to_text_string() or None if not found. * Recurses to parent if current node exists but with empty string value. ''' slow = node halfbeat = 11 # Don't start moving slow pointer for a while. while 1: if not node.m_internal: return val = mupdf.pdf_dict_get(node, key) if val.m_internal: label = mupdf.pdf_to_text_string(val) if label: return label node = mupdf.pdf_dict_get(node, PDF_NAME('Parent')) if node.m_internal == slow.m_internal: raise Exception("cycle in resources") halfbeat -= 1 if halfbeat == 0: slow = mupdf.pdf_dict_get(slow, PDF_NAME('Parent')) halfbeat = 2 # In order to address #3950, we use our modified pdf_dict_get_inheritable() # to ignore empty-string child values. label = pdf_dict_get_inheritable_nonempty_label(annot_obj, PDF_NAME('TU')) if label is not None: SETATTR_DROP(Widget, "field_label", label) fvalue = None if field_type == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON: obj = mupdf.pdf_dict_get( annot_obj, PDF_NAME('Parent')) # owning RB group if obj.m_internal: SETATTR_DROP(Widget, "rb_parent", mupdf.pdf_to_num( obj)) obj = mupdf.pdf_dict_get(annot_obj, PDF_NAME('AS')) if obj.m_internal: fvalue = mupdf.pdf_to_name(obj) if not fvalue: fvalue = mupdf.pdf_field_value(annot_obj) SETATTR_DROP(Widget, "field_value", JM_UnicodeFromStr(fvalue)) SETATTR_DROP(Widget, "field_display", mupdf.pdf_field_display(annot_obj)) border_width = mupdf.pdf_to_real(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('BS'), PDF_NAME('W'))) if border_width == 0: border_width = 1 SETATTR_DROP(Widget, "border_width", border_width) obj = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('BS'), PDF_NAME('D')) if mupdf.pdf_is_array(obj): n = mupdf.pdf_array_len(obj) d = [0] * n for i in range(n): d[i] = mupdf.pdf_to_int(mupdf.pdf_array_get(obj, i)) SETATTR_DROP(Widget, "border_dashes", d) SETATTR_DROP(Widget, "text_maxlen", mupdf.pdf_text_widget_max_len(tw.this)) SETATTR_DROP(Widget, "text_format", mupdf.pdf_text_widget_format(tw.this)) obj = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('MK'), PDF_NAME('BG')) if mupdf.pdf_is_array(obj): n = mupdf.pdf_array_len(obj) col = [0] * n for i in range(n): col[i] = mupdf.pdf_to_real(mupdf.pdf_array_get(obj, i)) SETATTR_DROP(Widget, "fill_color", col) obj = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('MK'), PDF_NAME('BC')) if mupdf.pdf_is_array(obj): n = mupdf.pdf_array_len(obj) col = [0] * n for i in range(n): col[i] = mupdf.pdf_to_real(mupdf.pdf_array_get(obj, i)) SETATTR_DROP(Widget, "border_color", col) SETATTR_DROP(Widget, "choice_values", JM_choice_options(annot)) da = mupdf.pdf_to_text_string(mupdf.pdf_dict_get_inheritable(annot_obj, PDF_NAME('DA'))) SETATTR_DROP(Widget, "_text_da", JM_UnicodeFromStr(da)) obj = mupdf.pdf_dict_getl(annot_obj, PDF_NAME('MK'), PDF_NAME('CA')) if obj.m_internal: SETATTR_DROP(Widget, "button_caption", JM_UnicodeFromStr(mupdf.pdf_to_text_string(obj))) SETATTR_DROP(Widget, "field_flags", mupdf.pdf_field_flags(annot_obj)) # call Py method to reconstruct text color, font name, size Widget._parse_da() # extract JavaScript action texts s = mupdf.pdf_dict_get(annot_obj, PDF_NAME('A')) ss = JM_get_script(s) SETATTR_DROP(Widget, "script", ss) SETATTR_DROP(Widget, "script_stroke", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), PDF_NAME('K'))) ) SETATTR_DROP(Widget, "script_format", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), PDF_NAME('F'))) ) SETATTR_DROP(Widget, "script_change", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), PDF_NAME('V'))) ) SETATTR_DROP(Widget, "script_calc", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), PDF_NAME('C'))) ) SETATTR_DROP(Widget, "script_blur", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), mupdf.pdf_new_name('Bl'))) ) SETATTR_DROP(Widget, "script_focus", JM_get_script(mupdf.pdf_dict_getl(annot_obj, PDF_NAME('AA'), mupdf.pdf_new_name('Fo'))) ) def JM_get_fontextension(doc, xref): ''' Return the file extension of a font file, identified by xref ''' if xref < 1: return "n/a" o = mupdf.pdf_load_object(doc, xref) desft = mupdf.pdf_dict_get(o, PDF_NAME('DescendantFonts')) if desft.m_internal: obj = mupdf.pdf_resolve_indirect(mupdf.pdf_array_get(desft, 0)) obj = mupdf.pdf_dict_get(obj, PDF_NAME('FontDescriptor')) else: obj = mupdf.pdf_dict_get(o, PDF_NAME('FontDescriptor')) if not obj.m_internal: return "n/a" # this is a base-14 font o = obj # we have the FontDescriptor obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile')) if obj.m_internal: return "pfa" obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile2')) if obj.m_internal: return "ttf" obj = mupdf.pdf_dict_get(o, PDF_NAME('FontFile3')) if obj.m_internal: obj = mupdf.pdf_dict_get(obj, PDF_NAME('Subtype')) if obj.m_internal and not mupdf.pdf_is_name(obj): message("invalid font descriptor subtype") return "n/a" if mupdf.pdf_name_eq(obj, PDF_NAME('Type1C')): return "cff" elif mupdf.pdf_name_eq(obj, PDF_NAME('CIDFontType0C')): return "cid" elif mupdf.pdf_name_eq(obj, PDF_NAME('OpenType')): return "otf" else: message(f"unhandled font type '{mupdf.pdf_to_name(obj)}'") return "n/a" def JM_get_ocg_arrays_imp(arr): ''' Get OCG arrays from OC configuration Returns dict {"basestate":name, "on":list, "off":list, "rbg":list, "locked":list} ''' list_ = list() if mupdf.pdf_is_array( arr): n = mupdf.pdf_array_len( arr) for i in range(n): obj = mupdf.pdf_array_get( arr, i) item = mupdf.pdf_to_num( obj) if item not in list_: list_.append(item) return list_ def JM_get_ocg_arrays(conf): rc = dict() arr = mupdf.pdf_dict_get( conf, PDF_NAME('ON')) list_ = JM_get_ocg_arrays_imp( arr) if list_: rc["on"] = list_ arr = mupdf.pdf_dict_get( conf, PDF_NAME('OFF')) list_ = JM_get_ocg_arrays_imp( arr) if list_: rc["off"] = list_ arr = mupdf.pdf_dict_get( conf, PDF_NAME('Locked')) list_ = JM_get_ocg_arrays_imp( arr) if list_: rc['locked'] = list_ list_ = list() arr = mupdf.pdf_dict_get( conf, PDF_NAME('RBGroups')) if mupdf.pdf_is_array( arr): n = mupdf.pdf_array_len( arr) for i in range(n): obj = mupdf.pdf_array_get( arr, i) list1 = JM_get_ocg_arrays_imp( obj) list_.append(list1) if list_: rc["rbgroups"] = list_ obj = mupdf.pdf_dict_get( conf, PDF_NAME('BaseState')) if obj.m_internal: state = mupdf.pdf_to_name( obj) rc["basestate"] = state return rc def JM_get_page_labels(liste, nums): n = mupdf.pdf_array_len(nums) for i in range(0, n, 2): key = mupdf.pdf_resolve_indirect( mupdf.pdf_array_get(nums, i)) pno = mupdf.pdf_to_int(key) val = mupdf.pdf_resolve_indirect( mupdf.pdf_array_get(nums, i + 1)) res = JM_object_to_buffer(val, 1, 0) c = mupdf.fz_buffer_extract(res) assert isinstance(c, bytes) c = c.decode('utf-8') liste.append( (pno, c)) def JM_get_script(key): ''' JavaScript extractor Returns either the script source or None. Parameter is a PDF action dictionary, which must have keys /S and /JS. The value of /S must be '/JavaScript'. The value of /JS is returned. ''' if not key.m_internal: return j = mupdf.pdf_dict_get(key, PDF_NAME('S')) jj = mupdf.pdf_to_name(j) if jj == "JavaScript": js = mupdf.pdf_dict_get(key, PDF_NAME('JS')) if not js.m_internal: return else: return if mupdf.pdf_is_string(js): script = JM_UnicodeFromStr(mupdf.pdf_to_text_string(js)) elif mupdf.pdf_is_stream(js): res = mupdf.pdf_load_stream(js) script = JM_EscapeStrFromBuffer(res) else: return if script: # do not return an empty script return script return def JM_have_operation(pdf): ''' Ensure valid journalling state ''' if pdf.m_internal.journal and not mupdf.pdf_undoredo_step(pdf, 0): return 0 return 1 def JM_image_extension(type_): ''' return extension for MuPDF image type ''' if type_ == mupdf.FZ_IMAGE_FAX: return "fax" if type_ == mupdf.FZ_IMAGE_RAW: return "raw" if type_ == mupdf.FZ_IMAGE_FLATE: return "flate" if type_ == mupdf.FZ_IMAGE_LZW: return "lzw" if type_ == mupdf.FZ_IMAGE_RLD: return "rld" if type_ == mupdf.FZ_IMAGE_BMP: return "bmp" if type_ == mupdf.FZ_IMAGE_GIF: return "gif" if type_ == mupdf.FZ_IMAGE_JBIG2: return "jb2" if type_ == mupdf.FZ_IMAGE_JPEG: return "jpeg" if type_ == mupdf.FZ_IMAGE_JPX: return "jpx" if type_ == mupdf.FZ_IMAGE_JXR: return "jxr" if type_ == mupdf.FZ_IMAGE_PNG: return "png" if type_ == mupdf.FZ_IMAGE_PNM: return "pnm" if type_ == mupdf.FZ_IMAGE_TIFF: return "tiff" #if type_ == mupdf.FZ_IMAGE_PSD: return "psd" return "n/a" # fixme: need to avoid using a global for this. g_img_info = None def JM_image_filter(opaque, ctm, name, image): assert isinstance(ctm, mupdf.FzMatrix) r = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) q = mupdf.fz_transform_quad( mupdf.fz_quad_from_rect(r), ctm) q = mupdf.fz_transform_quad( q, g_img_info_matrix) temp = name, JM_py_from_quad(q) g_img_info.append(temp) def JM_image_profile( imagedata, keep_image): ''' Return basic properties of an image provided as bytes or bytearray The function creates an fz_image and optionally returns it. ''' if not imagedata: return None # nothing given len_ = len( imagedata) if len_ < 8: message( "bad image data") return None c = imagedata #log(f'calling mfz_recognize_image_format with {c!r=}') type_ = mupdf.fz_recognize_image_format( c) if type_ == mupdf.FZ_IMAGE_UNKNOWN: return None if keep_image: res = mupdf.fz_new_buffer_from_copied_data( c, len_) else: res = mupdf.fz_new_buffer_from_shared_data( c, len_) image = mupdf.fz_new_image_from_buffer( res) ctm = mupdf.fz_image_orientation_matrix( image) xres, yres = mupdf.fz_image_resolution(image) orientation = mupdf.fz_image_orientation( image) cs_name = mupdf.fz_colorspace_name( image.colorspace()) result = dict() result[ dictkey_width] = image.w() result[ dictkey_height] = image.h() result[ "orientation"] = orientation result[ dictkey_matrix] = JM_py_from_matrix(ctm) result[ dictkey_xres] = xres result[ dictkey_yres] = yres result[ dictkey_colorspace] = image.n() result[ dictkey_bpc] = image.bpc() result[ dictkey_ext] = JM_image_extension(type_) result[ dictkey_cs_name] = cs_name if keep_image: result[ dictkey_image] = image return result def JM_image_reporter(page): doc = page.doc() global g_img_info_matrix g_img_info_matrix = mupdf.FzMatrix() mediabox = mupdf.FzRect() mupdf.pdf_page_transform(page, mediabox, g_img_info_matrix) class SanitizeFilterOptions(mupdf.PdfSanitizeFilterOptions2): def __init__(self): super().__init__() self.use_virtual_image_filter() def image_filter(self, ctx, ctm, name, image, scissor): JM_image_filter(None, mupdf.FzMatrix(ctm), name, image) sanitize_filter_options = SanitizeFilterOptions() filter_options = _make_PdfFilterOptions( instance_forms=1, ascii=1, no_update=1, sanitize=1, sopts=sanitize_filter_options, ) global g_img_info g_img_info = [] mupdf.pdf_filter_page_contents( doc, page, filter_options) rc = tuple(g_img_info) g_img_info = [] return rc def JM_fitz_config(): have_TOFU = not hasattr(mupdf, 'TOFU') have_TOFU_BASE14 = not hasattr(mupdf, 'TOFU_BASE14') have_TOFU_CJK = not hasattr(mupdf, 'TOFU_CJK') have_TOFU_CJK_EXT = not hasattr(mupdf, 'TOFU_CJK_EXT') have_TOFU_CJK_LANG = not hasattr(mupdf, 'TOFU_CJK_LANG') have_TOFU_EMOJI = not hasattr(mupdf, 'TOFU_EMOJI') have_TOFU_HISTORIC = not hasattr(mupdf, 'TOFU_HISTORIC') have_TOFU_SIL = not hasattr(mupdf, 'TOFU_SIL') have_TOFU_SYMBOL = not hasattr(mupdf, 'TOFU_SYMBOL') ret = dict() ret["base14"] = have_TOFU_BASE14 ret["cbz"] = bool(mupdf.FZ_ENABLE_CBZ) ret["epub"] = bool(mupdf.FZ_ENABLE_EPUB) ret["html"] = bool(mupdf.FZ_ENABLE_HTML) ret["icc"] = bool(mupdf.FZ_ENABLE_ICC) ret["img"] = bool(mupdf.FZ_ENABLE_IMG) ret["jpx"] = bool(mupdf.FZ_ENABLE_JPX) ret["js"] = bool(mupdf.FZ_ENABLE_JS) ret["pdf"] = bool(mupdf.FZ_ENABLE_PDF) ret["plotter-cmyk"] = bool(mupdf.FZ_PLOTTERS_CMYK) ret["plotter-g"] = bool(mupdf.FZ_PLOTTERS_G) ret["plotter-n"] = bool(mupdf.FZ_PLOTTERS_N) ret["plotter-rgb"] = bool(mupdf.FZ_PLOTTERS_RGB) ret["py-memory"] = bool(JM_MEMORY) ret["svg"] = bool(mupdf.FZ_ENABLE_SVG) ret["tofu"] = have_TOFU ret["tofu-cjk"] = have_TOFU_CJK ret["tofu-cjk-ext"] = have_TOFU_CJK_EXT ret["tofu-cjk-lang"] = have_TOFU_CJK_LANG ret["tofu-emoji"] = have_TOFU_EMOJI ret["tofu-historic"] = have_TOFU_HISTORIC ret["tofu-sil"] = have_TOFU_SIL ret["tofu-symbol"] = have_TOFU_SYMBOL ret["xps"] = bool(mupdf.FZ_ENABLE_XPS) return ret def JM_insert_contents(pdf, pageref, newcont, overlay): ''' Insert a buffer as a new separate /Contents object of a page. 1. Create a new stream object from buffer 'newcont' 2. If /Contents already is an array, then just prepend or append this object 3. Else, create new array and put old content obj and this object into it. If the page had no /Contents before, just create a 1-item array. ''' contents = mupdf.pdf_dict_get(pageref, PDF_NAME('Contents')) newconts = mupdf.pdf_add_stream(pdf, newcont, mupdf.PdfObj(), 0) xref = mupdf.pdf_to_num(newconts) if mupdf.pdf_is_array(contents): if overlay: # append new object mupdf.pdf_array_push(contents, newconts) else: # prepend new object mupdf.pdf_array_insert(contents, newconts, 0) else: carr = mupdf.pdf_new_array(pdf, 5) if overlay: if contents.m_internal: mupdf.pdf_array_push(carr, contents) mupdf.pdf_array_push(carr, newconts) else: mupdf.pdf_array_push(carr, newconts) if contents.m_internal: mupdf.pdf_array_push(carr, contents) mupdf.pdf_dict_put(pageref, PDF_NAME('Contents'), carr) return xref def JM_insert_font(pdf, bfname, fontfile, fontbuffer, set_simple, idx, wmode, serif, encoding, ordering): ''' Insert a font in a PDF ''' font = None res = None data = None ixref = 0 index = 0 simple = 0 value=None name=None subt=None exto = None ENSURE_OPERATION(pdf) # check for CJK font if ordering > -1: data, size, index = mupdf.fz_lookup_cjk_font(ordering) if data: font = mupdf.fz_new_font_from_memory(None, data, size, index, 0) font_obj = mupdf.pdf_add_cjk_font(pdf, font, ordering, wmode, serif) exto = "n/a" simple = 0 #goto weiter; else: # check for PDF Base-14 font if bfname: data, size = mupdf.fz_lookup_base14_font(bfname) if data: font = mupdf.fz_new_font_from_memory(bfname, data, size, 0, 0) font_obj = mupdf.pdf_add_simple_font(pdf, font, encoding) exto = "n/a" simple = 1 #goto weiter; else: if fontfile: font = mupdf.fz_new_font_from_file(None, fontfile, idx, 0) else: res = JM_BufferFromBytes(fontbuffer) if not res.m_internal: RAISEPY(MSG_FILE_OR_BUFFER, PyExc_ValueError) font = mupdf.fz_new_font_from_buffer(None, res, idx, 0) if not set_simple: font_obj = mupdf.pdf_add_cid_font(pdf, font) simple = 0 else: font_obj = mupdf.pdf_add_simple_font(pdf, font, encoding) simple = 2 #weiter: ; ixref = mupdf.pdf_to_num(font_obj) name = JM_EscapeStrFromStr( mupdf.pdf_to_name( mupdf.pdf_dict_get(font_obj, PDF_NAME('BaseFont')))) subt = JM_UnicodeFromStr( mupdf.pdf_to_name( mupdf.pdf_dict_get( font_obj, PDF_NAME('Subtype')))) if not exto: exto = JM_UnicodeFromStr(JM_get_fontextension(pdf, ixref)) asc = mupdf.fz_font_ascender(font) dsc = mupdf.fz_font_descender(font) value = [ ixref, { "name": name, # base font name "type": subt, # subtype "ext": exto, # file extension "simple": bool(simple), # simple font? "ordering": ordering, # CJK font? "ascender": asc, "descender": dsc, }, ] return value def JM_irect_from_py(r): ''' PySequence to mupdf.FzIrect. Default: infinite irect ''' if isinstance(r, mupdf.FzIrect): return r if isinstance(r, IRect): r = mupdf.FzIrect( r.x0, r.y0, r.x1, r.y1) return r if isinstance(r, Rect): ret = mupdf.FzRect(r.x0, r.y0, r.x1, r.y1) ret = mupdf.FzIrect(ret) # Uses fz_irect_from_rect(). return ret if isinstance(r, mupdf.FzRect): ret = mupdf.FzIrect(r) # Uses fz_irect_from_rect(). return ret if not r or not PySequence_Check(r) or PySequence_Size(r) != 4: return mupdf.FzIrect(mupdf.fz_infinite_irect) f = [0, 0, 0, 0] for i in range(4): f[i] = r[i] if f[i] is None: return mupdf.FzIrect(mupdf.fz_infinite_irect) if f[i] < FZ_MIN_INF_RECT: f[i] = FZ_MIN_INF_RECT if f[i] > FZ_MAX_INF_RECT: f[i] = FZ_MAX_INF_RECT return mupdf.fz_make_irect(f[0], f[1], f[2], f[3]) def JM_listbox_value( annot): ''' ListBox retrieve value ''' # may be single value or array annot_obj = mupdf.pdf_annot_obj( annot) optarr = mupdf.pdf_dict_get( annot_obj, PDF_NAME('V')) if mupdf.pdf_is_string( optarr): # a single string return mupdf.pdf_to_text_string( optarr) # value is an array (may have len 0) n = mupdf.pdf_array_len( optarr) liste = [] # extract a list of strings # each entry may again be an array: take second entry then for i in range( n): elem = mupdf.pdf_array_get( optarr, i) if mupdf.pdf_is_array( elem): elem = mupdf.pdf_array_get( elem, 1) liste.append( JM_UnicodeFromStr( mupdf.pdf_to_text_string( elem))) return liste def JM_make_annot_DA(annot, ncol, col, fontname, fontsize): # PyMuPDF uses a fz_buffer to build up the string, but it's non-trivial to # convert the fz_buffer's `unsigned char*` into a `const char*` suitable # for passing to pdf_dict_put_text_string(). So instead we build up the # string directly in Python. buf = '' if ncol < 1: buf += f'0 g ' elif ncol == 1: buf += f'{col[0]:g} g ' elif ncol == 2: assert 0 elif ncol == 3: buf += f'{col[0]:g} {col[1]:g} {col[2]:g} rg ' else: buf += f'{col[0]:g} {col[1]:g} {col[2]:g} {col[3]:g} k ' buf += f'/{JM_expand_fname(fontname)} {fontsize} Tf' mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(annot), mupdf.PDF_ENUM_NAME_DA, buf) def JM_make_spanlist(line_dict, line, raw, buff, tp_rect): if 1 or g_use_extra: return extra.JM_make_spanlist(line_dict, line, raw, buff, tp_rect) char_list = None span_list = [] mupdf.fz_clear_buffer(buff) span_rect = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) line_rect = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) class char_style: def __init__(self, rhs=None): if rhs: self.size = rhs.size self.flags = rhs.flags self.char_flags = rhs.char_flags self.font = rhs.font self.argb = rhs.argb self.asc = rhs.asc self.desc = rhs.desc self.bidi = rhs.bidi else: self.size = -1 self.flags = -1 self.char_flags = -1 self.font = '' self.argb = -1 self.asc = 0 self.desc = 0 self.bidi = 0 def __str__(self): ret = f'{self.size} {self.flags}' ret += f' {self.char_flags}' ret += f' {self.font} {self.color} {self.asc} {self.desc}' return ret old_style = char_style() style = char_style() span = None span_origin = None for ch in line: # start-trace r = JM_char_bbox(line, ch) if (not JM_rects_overlap(tp_rect, r) and not mupdf.fz_is_infinite_rect(tp_rect) ): continue # Info from: # detect_super_script() # fz_font_is_italic() # fz_font_is_serif() # fz_font_is_monospaced() # fz_font_is_bold() flags = JM_char_font_flags(mupdf.FzFont(mupdf.ll_fz_keep_font(ch.m_internal.font)), line, ch) origin = mupdf.FzPoint(ch.m_internal.origin) style.size = ch.m_internal.size style.flags = flags # FZ_STEXT_SYNTHETIC is per-char, not per-span. style.char_flags = ch.m_internal.flags & ~mupdf.FZ_STEXT_SYNTHETIC style.font = JM_font_name(mupdf.FzFont(mupdf.ll_fz_keep_font(ch.m_internal.font))) style.argb = ch.m_internal.argb style.asc = JM_font_ascender(mupdf.FzFont(mupdf.ll_fz_keep_font(ch.m_internal.font))) style.desc = JM_font_descender(mupdf.FzFont(mupdf.ll_fz_keep_font(ch.m_internal.font))) style.bidi = ch.m_internal.bidi if (style.size != old_style.size or style.flags != old_style.flags or (style.char_flags != old_style.char_flags) or style.argb != old_style.argb or style.font != old_style.font or style.bidi != old_style.bidi ): if old_style.size >= 0: # not first one, output previous if raw: # put character list in the span span[dictkey_chars] = char_list char_list = None else: # put text string in the span span[dictkey_text] = JM_EscapeStrFromBuffer( buff) mupdf.fz_clear_buffer(buff) span[dictkey_origin] = JM_py_from_point(span_origin) span[dictkey_bbox] = JM_py_from_rect(span_rect) line_rect = mupdf.fz_union_rect(line_rect, span_rect) span_list.append( span) span = None span = dict() asc = style.asc desc = style.desc if style.asc < 1e-3: asc = 0.9 desc = -0.1 span[dictkey_size] = style.size span[dictkey_flags] = style.flags span[dictkey_bidi] = style.bidi span[dictkey_char_flags] = style.char_flags span[dictkey_font] = JM_EscapeStrFromStr(style.font) span[dictkey_color] = style.argb & 0xffffff span['alpha'] = style.argb >> 24 span["ascender"] = asc span["descender"] = desc # Need to be careful here - doing 'old_style=style' does a shallow # copy, but we need to keep old_style as a distinct instance. old_style = char_style(style) span_rect = r span_origin = origin span_rect = mupdf.fz_union_rect(span_rect, r) if raw: # make and append a char dict char_dict = dict() char_dict[dictkey_origin] = JM_py_from_point( ch.m_internal.origin) char_dict[dictkey_bbox] = JM_py_from_rect(r) char_dict[dictkey_c] = chr(ch.m_internal.c) char_dict['synthetic'] = bool(ch.m_internal.flags & mupdf.FZ_STEXT_SYNTHETIC) if char_list is None: char_list = [] char_list.append(char_dict) else: # add character byte to buffer JM_append_rune(buff, ch.m_internal.c) # all characters processed, now flush remaining span if span: if raw: span[dictkey_chars] = char_list char_list = None else: span[dictkey_text] = JM_EscapeStrFromBuffer(buff) mupdf.fz_clear_buffer(buff) span[dictkey_origin] = JM_py_from_point(span_origin) span[dictkey_bbox] = JM_py_from_rect(span_rect) if not mupdf.fz_is_empty_rect(span_rect): span_list.append(span) line_rect = mupdf.fz_union_rect(line_rect, span_rect) span = None if not mupdf.fz_is_empty_rect(line_rect): line_dict[dictkey_spans] = span_list else: line_dict[dictkey_spans] = span_list return line_rect def _make_image_dict(img, img_dict): """Populate a dictionary with information extracted from a given image. Used by 'Document.extract_image' and by 'JM_make_image_block'. Both of these functions will add some more specific information. """ img_type = img.fz_compressed_image_type() ext = JM_image_extension(img_type) # compressed image buffer if present, else None ll_cbuf = mupdf.ll_fz_compressed_image_buffer(img.m_internal) if (0 or not ll_cbuf or img_type in (mupdf.FZ_IMAGE_JBIG2, mupdf.FZ_IMAGE_UNKNOWN) or img_type < mupdf.FZ_IMAGE_BMP ): # not an image with a compressed buffer: convert to PNG res = mupdf.fz_new_buffer_from_image_as_png( img, mupdf.FzColorParams(mupdf.fz_default_color_params), ) ext = "png" elif ext == "jpeg" and img.n() == 4: # JPEG with CMYK: invert colors res = mupdf.fz_new_buffer_from_image_as_jpeg( img, mupdf.FzColorParams(mupdf.fz_default_color_params), 95, 1) else: # copy the compressed buffer res = mupdf.FzBuffer(mupdf.ll_fz_keep_buffer(ll_cbuf.buffer)) bytes_ = JM_BinFromBuffer(res) img_dict[dictkey_width] = img.w() img_dict[dictkey_height] = img.h() img_dict[dictkey_ext] = ext img_dict[dictkey_colorspace] = img.n() img_dict[dictkey_xres] = img.xres() img_dict[dictkey_yres] = img.yres() img_dict[dictkey_bpc] = img.bpc() img_dict[dictkey_size] = len(bytes_) img_dict[dictkey_image] = bytes_ def JM_make_image_block(block, block_dict): img = block.i_image() _make_image_dict(img, block_dict) # if the image has a mask, store it as a PNG buffer mask = img.mask() if mask.m_internal: buff = mask.fz_new_buffer_from_image_as_png(mupdf.FzColorParams(mupdf.fz_default_color_params)) block_dict["mask"] = buff.fz_buffer_extract() else: block_dict["mask"] = None block_dict[dictkey_matrix] = JM_py_from_matrix(block.i_transform()) def JM_make_text_block(block, block_dict, raw, buff, tp_rect): if 1 or g_use_extra: return extra.JM_make_text_block(block.m_internal, block_dict, raw, buff.m_internal, tp_rect.m_internal) line_list = [] block_rect = mupdf.FzRect(mupdf.FzRect.Fixed_EMPTY) #log(f'{block=}') for line in block: #log(f'{line=}') if (mupdf.fz_is_empty_rect(mupdf.fz_intersect_rect(tp_rect, mupdf.FzRect(line.m_internal.bbox))) and not mupdf.fz_is_infinite_rect(tp_rect) ): continue line_dict = dict() line_rect = JM_make_spanlist(line_dict, line, raw, buff, tp_rect) block_rect = mupdf.fz_union_rect(block_rect, line_rect) line_dict[dictkey_wmode] = line.m_internal.wmode line_dict[dictkey_dir] = JM_py_from_point(line.m_internal.dir) line_dict[dictkey_bbox] = JM_py_from_rect(line_rect) line_list.append(line_dict) block_dict[dictkey_bbox] = JM_py_from_rect(block_rect) block_dict[dictkey_lines] = line_list def JM_make_textpage_dict(tp, page_dict, raw): if 1 or g_use_extra: return extra.JM_make_textpage_dict(tp.m_internal, page_dict, raw) text_buffer = mupdf.fz_new_buffer(128) block_list = [] tp_rect = mupdf.FzRect(tp.m_internal.mediabox) block_n = -1 #log(f'JM_make_textpage_dict {=tp}') for block in tp: block_n += 1 if (not mupdf.fz_contains_rect(tp_rect, mupdf.FzRect(block.m_internal.bbox)) and not mupdf.fz_is_infinite_rect(tp_rect) and block.m_internal.type == mupdf.FZ_STEXT_BLOCK_IMAGE ): continue if (not mupdf.fz_is_infinite_rect(tp_rect) and mupdf.fz_is_empty_rect(mupdf.fz_intersect_rect(tp_rect, mupdf.FzRect(block.m_internal.bbox))) ): continue block_dict = dict() block_dict[dictkey_number] = block_n block_dict[dictkey_type] = block.m_internal.type if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_IMAGE: block_dict[dictkey_bbox] = JM_py_from_rect(block.m_internal.bbox) JM_make_image_block(block, block_dict) else: JM_make_text_block(block, block_dict, raw, text_buffer, tp_rect) block_list.append(block_dict) page_dict[dictkey_blocks] = block_list def JM_matrix_from_py(m): a = [0, 0, 0, 0, 0, 0] if isinstance(m, mupdf.FzMatrix): return m if isinstance(m, Matrix): return mupdf.FzMatrix(m.a, m.b, m.c, m.d, m.e, m.f) if not m or not PySequence_Check(m) or PySequence_Size(m) != 6: return mupdf.FzMatrix() for i in range(6): a[i] = JM_FLOAT_ITEM(m, i) if a[i] is None: return mupdf.FzRect() return mupdf.FzMatrix(a[0], a[1], a[2], a[3], a[4], a[5]) def JM_mediabox(page_obj): ''' return a PDF page's MediaBox ''' page_mediabox = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) mediabox = mupdf.pdf_to_rect( mupdf.pdf_dict_get_inheritable(page_obj, PDF_NAME('MediaBox')) ) if mupdf.fz_is_empty_rect(mediabox) or mupdf.fz_is_infinite_rect(mediabox): mediabox.x0 = 0 mediabox.y0 = 0 mediabox.x1 = 612 mediabox.y1 = 792 page_mediabox = mupdf.FzRect( mupdf.fz_min(mediabox.x0, mediabox.x1), mupdf.fz_min(mediabox.y0, mediabox.y1), mupdf.fz_max(mediabox.x0, mediabox.x1), mupdf.fz_max(mediabox.y0, mediabox.y1), ) if (page_mediabox.x1 - page_mediabox.x0 < 1 or page_mediabox.y1 - page_mediabox.y0 < 1 ): page_mediabox = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) return page_mediabox def JM_merge_range( doc_des, doc_src, spage, epage, apage, rotate, links, annots, show_progress, graft_map, ): ''' Copy a range of pages (spage, epage) from a source PDF to a specified location (apage) of the target PDF. If spage > epage, the sequence of source pages is reversed. ''' if g_use_extra: return extra.JM_merge_range( doc_des, doc_src, spage, epage, apage, rotate, links, annots, show_progress, graft_map, ) afterpage = apage counter = 0 # copied pages counter total = mupdf.fz_absi(epage - spage) + 1 # total pages to copy if spage < epage: page = spage while page <= epage: page_merge(doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map) counter += 1 if show_progress > 0 and counter % show_progress == 0: message(f"Inserted {counter} of {total} pages.") page += 1 afterpage += 1 else: page = spage while page >= epage: page_merge(doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map) counter += 1 if show_progress > 0 and counter % show_progress == 0: message(f"Inserted {counter} of {total} pages.") page -= 1 afterpage += 1 def JM_merge_resources( page, temp_res): ''' Merge the /Resources object created by a text pdf device into the page. The device may have created multiple /ExtGState/Alp? and /Font/F? objects. These need to be renamed (renumbered) to not overwrite existing page objects from previous executions. Returns the next available numbers n, m for objects /Alp, /F. ''' # page objects /Resources, /Resources/ExtGState, /Resources/Font resources = mupdf.pdf_dict_get(page.obj(), PDF_NAME('Resources')) if not resources.m_internal: resources = mupdf.pdf_dict_put_dict(page.obj(), PDF_NAME('Resources'), 5) main_extg = mupdf.pdf_dict_get(resources, PDF_NAME('ExtGState')) main_fonts = mupdf.pdf_dict_get(resources, PDF_NAME('Font')) # text pdf device objects /ExtGState, /Font temp_extg = mupdf.pdf_dict_get(temp_res, PDF_NAME('ExtGState')) temp_fonts = mupdf.pdf_dict_get(temp_res, PDF_NAME('Font')) max_alp = -1 max_fonts = -1 # Handle /Alp objects if mupdf.pdf_is_dict(temp_extg): # any created at all? n = mupdf.pdf_dict_len(temp_extg) if mupdf.pdf_is_dict(main_extg): # does page have /ExtGState yet? for i in range(mupdf.pdf_dict_len(main_extg)): # get highest number of objects named /Alpxxx alp = mupdf.pdf_to_name( mupdf.pdf_dict_get_key(main_extg, i)) if not alp.startswith('Alp'): continue j = mupdf.fz_atoi(alp[3:]) if j > max_alp: max_alp = j else: # create a /ExtGState for the page main_extg = mupdf.pdf_dict_put_dict(resources, PDF_NAME('ExtGState'), n) max_alp += 1 for i in range(n): # copy over renumbered /Alp objects alp = mupdf.pdf_to_name( mupdf.pdf_dict_get_key( temp_extg, i)) j = mupdf.fz_atoi(alp[3:]) + max_alp text = f'Alp{j}' val = mupdf.pdf_dict_get_val( temp_extg, i) mupdf.pdf_dict_puts(main_extg, text, val) if mupdf.pdf_is_dict(main_fonts): # has page any fonts yet? for i in range(mupdf.pdf_dict_len(main_fonts)): # get max font number font = mupdf.pdf_to_name( mupdf.pdf_dict_get_key( main_fonts, i)) if not font.startswith("F"): continue j = mupdf.fz_atoi(font[1:]) if j > max_fonts: max_fonts = j else: # create a Resources/Font for the page main_fonts = mupdf.pdf_dict_put_dict(resources, PDF_NAME('Font'), 2) max_fonts += 1 for i in range(mupdf.pdf_dict_len(temp_fonts)): # copy renumbered fonts font = mupdf.pdf_to_name( mupdf.pdf_dict_get_key( temp_fonts, i)) j = mupdf.fz_atoi(font[1:]) + max_fonts text = f'F{j}' val = mupdf.pdf_dict_get_val(temp_fonts, i) mupdf.pdf_dict_puts(main_fonts, text, val) return (max_alp, max_fonts) # next available numbers def JM_mupdf_warning( text): ''' redirect MuPDF warnings ''' JM_mupdf_warnings_store.append(text) if JM_mupdf_show_warnings: message(f'MuPDF warning: {text}') def JM_mupdf_error( text): JM_mupdf_warnings_store.append(text) if JM_mupdf_show_errors: message(f'MuPDF error: {text}\n') def JM_new_bbox_device(rc, inc_layers): assert isinstance(rc, list) return JM_new_bbox_device_Device( rc, inc_layers) def JM_new_buffer_from_stext_page(page): ''' make a buffer from an stext_page's text ''' assert isinstance(page, mupdf.FzStextPage) rect = mupdf.FzRect(page.m_internal.mediabox) buf = mupdf.fz_new_buffer(256) for block in page: if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_TEXT: for line in block: for ch in line: if (not JM_rects_overlap(rect, JM_char_bbox(line, ch)) and not mupdf.fz_is_infinite_rect(rect) ): continue mupdf.fz_append_rune(buf, ch.m_internal.c) mupdf.fz_append_byte(buf, ord('\n')) mupdf.fz_append_byte(buf, ord('\n')) return buf def JM_new_javascript(pdf, value): ''' make new PDF action object from JavaScript source Parameters are a PDF document and a Python string. Returns a PDF action object. ''' if value is None: # no argument given return data = JM_StrAsChar(value) if data is None: # not convertible to char* return res = mupdf.fz_new_buffer_from_copied_data(data.encode('utf8')) source = mupdf.pdf_add_stream(pdf, res, mupdf.PdfObj(), 0) newaction = mupdf.pdf_add_new_dict(pdf, 4) mupdf.pdf_dict_put(newaction, PDF_NAME('S'), mupdf.pdf_new_name('JavaScript')) mupdf.pdf_dict_put(newaction, PDF_NAME('JS'), source) return newaction def JM_new_output_fileptr(bio): return JM_new_output_fileptr_Output( bio) def JM_norm_rotation(rotate): ''' # return normalized /Rotate value:one of 0, 90, 180, 270 ''' while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if rotate % 90 != 0: return 0 return rotate def JM_object_to_buffer(what, compress, ascii): res = mupdf.fz_new_buffer(512) out = mupdf.FzOutput(res) mupdf.pdf_print_obj(out, what, compress, ascii) out.fz_close_output() mupdf.fz_terminate_buffer(res) return res def JM_outline_xrefs(obj, xrefs): ''' Return list of outline xref numbers. Recursive function. Arguments: 'obj' first OL item 'xrefs' empty Python list ''' if not obj.m_internal: return xrefs thisobj = obj while thisobj.m_internal: newxref = mupdf.pdf_to_num( thisobj) if newxref in xrefs or mupdf.pdf_dict_get( thisobj, PDF_NAME('Type')).m_internal: # circular ref or top of chain: terminate break xrefs.append( newxref) first = mupdf.pdf_dict_get( thisobj, PDF_NAME('First')) # try go down if mupdf.pdf_is_dict( first): xrefs = JM_outline_xrefs( first, xrefs) thisobj = mupdf.pdf_dict_get( thisobj, PDF_NAME('Next')) # try go next parent = mupdf.pdf_dict_get( thisobj, PDF_NAME('Parent')) # get parent if not mupdf.pdf_is_dict( thisobj): thisobj = parent return xrefs def JM_page_rotation(page): ''' return a PDF page's /Rotate value: one of (0, 90, 180, 270) ''' rotate = 0 obj = mupdf.pdf_dict_get_inheritable( page.obj(), mupdf.PDF_ENUM_NAME_Rotate) rotate = mupdf.pdf_to_int(obj) rotate = JM_norm_rotation(rotate) return rotate def JM_pdf_obj_from_str(doc, src): ''' create PDF object from given string (new in v1.14.0: MuPDF dropped it) ''' # fixme: seems inefficient to convert to bytes instance then make another # copy inside fz_new_buffer_from_copied_data(), but no other way? # buffer_ = mupdf.fz_new_buffer_from_copied_data(bytes(src, 'utf8')) stream = mupdf.fz_open_buffer(buffer_) lexbuf = mupdf.PdfLexbuf(mupdf.PDF_LEXBUF_SMALL) result = mupdf.pdf_parse_stm_obj(doc, stream, lexbuf) return result def JM_pixmap_from_display_list( list_, ctm, cs, alpha, clip, seps, ): ''' Version of fz_new_pixmap_from_display_list (util.c) to also support rendering of only the 'clip' part of the displaylist rectangle ''' assert isinstance(list_, mupdf.FzDisplayList) if seps is None: seps = mupdf.FzSeparations() assert seps is None or isinstance(seps, mupdf.FzSeparations), f'{type(seps)=}: {seps}' rect = mupdf.fz_bound_display_list(list_) matrix = JM_matrix_from_py(ctm) rclip = JM_rect_from_py(clip) rect = mupdf.fz_intersect_rect(rect, rclip) # no-op if clip is not given rect = mupdf.fz_transform_rect(rect, matrix) irect = mupdf.fz_round_rect(rect) assert isinstance( cs, mupdf.FzColorspace) pix = mupdf.fz_new_pixmap_with_bbox(cs, irect, seps, alpha) if alpha: mupdf.fz_clear_pixmap(pix) else: mupdf.fz_clear_pixmap_with_value(pix, 0xFF) if not mupdf.fz_is_infinite_rect(rclip): dev = mupdf.fz_new_draw_device_with_bbox(matrix, pix, irect) mupdf.fz_run_display_list(list_, dev, mupdf.FzMatrix(), rclip, mupdf.FzCookie()) else: dev = mupdf.fz_new_draw_device(matrix, pix) mupdf.fz_run_display_list(list_, dev, mupdf.FzMatrix(), mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE), mupdf.FzCookie()) mupdf.fz_close_device(dev) # Use special raw Pixmap constructor so we don't set alpha to true. return Pixmap( 'raw', pix) def JM_point_from_py(p): ''' PySequence to fz_point. Default: (FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) ''' if isinstance(p, mupdf.FzPoint): return p if isinstance(p, Point): return mupdf.FzPoint(p.x, p.y) if g_use_extra: return extra.JM_point_from_py( p) p0 = mupdf.FzPoint(0, 0) x = JM_FLOAT_ITEM(p, 0) y = JM_FLOAT_ITEM(p, 1) if x is None or y is None: return p0 x = max( x, FZ_MIN_INF_RECT) y = max( y, FZ_MIN_INF_RECT) x = min( x, FZ_MAX_INF_RECT) y = min( y, FZ_MAX_INF_RECT) return mupdf.FzPoint(x, y) def JM_print_stext_page_as_text(res, page): ''' Plain text output. An identical copy of fz_print_stext_page_as_text, but lines within a block are concatenated by space instead a new-line character (which else leads to 2 new-lines). ''' if 1 and g_use_extra: return extra.JM_print_stext_page_as_text(res, page) assert isinstance(res, mupdf.FzBuffer) assert isinstance(page, mupdf.FzStextPage) rect = mupdf.FzRect(page.m_internal.mediabox) last_char = 0 n_blocks = 0 n_lines = 0 n_chars = 0 for n_blocks2, block in enumerate( page): if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_TEXT: for n_lines2, line in enumerate( block): for n_chars2, ch in enumerate( line): pass n_chars += n_chars2 n_lines += n_lines2 n_blocks += n_blocks2 for block in page: if block.m_internal.type == mupdf.FZ_STEXT_BLOCK_TEXT: for line in block: last_char = 0 for ch in line: chbbox = JM_char_bbox(line, ch) if (mupdf.fz_is_infinite_rect(rect) or JM_rects_overlap(rect, chbbox) ): #raw += chr(ch.m_internal.c) last_char = ch.m_internal.c #log(f'{=last_char!r utf!r}') JM_append_rune(res, last_char) if last_char != 10 and last_char > 0: mupdf.fz_append_string(res, "\n") def JM_put_script(annot_obj, key1, key2, value): ''' Create a JavaScript PDF action. Usable for all object types which support PDF actions, even if the argument name suggests annotations. Up to 2 key values can be specified, so JavaScript actions can be stored for '/A' and '/AA/?' keys. ''' key1_obj = mupdf.pdf_dict_get(annot_obj, key1) pdf = mupdf.pdf_get_bound_document(annot_obj) # owning PDF # if no new script given, just delete corresponding key if not value: if key2 is None or not key2.m_internal: mupdf.pdf_dict_del(annot_obj, key1) elif key1_obj.m_internal: mupdf.pdf_dict_del(key1_obj, key2) return # read any existing script as a PyUnicode string if not key2.m_internal or not key1_obj.m_internal: script = JM_get_script(key1_obj) else: script = JM_get_script(mupdf.pdf_dict_get(key1_obj, key2)) # replace old script, if different from new one if value != script: newaction = JM_new_javascript(pdf, value) if not key2.m_internal: mupdf.pdf_dict_put(annot_obj, key1, newaction) else: mupdf.pdf_dict_putl(annot_obj, newaction, key1, key2) def JM_py_from_irect(r): return r.x0, r.y0, r.x1, r.y1 def JM_py_from_matrix(m): return m.a, m.b, m.c, m.d, m.e, m.f def JM_py_from_point(p): return p.x, p.y def JM_py_from_quad(q): ''' PySequence from fz_quad. ''' return ( (q.ul.x, q.ul.y), (q.ur.x, q.ur.y), (q.ll.x, q.ll.y), (q.lr.x, q.lr.y), ) def JM_py_from_rect(r): return r.x0, r.y0, r.x1, r.y1 def JM_quad_from_py(r): if isinstance(r, mupdf.FzQuad): return r # cover all cases of 4-float-sequences if hasattr(r, "__getitem__") and len(r) == 4 and hasattr(r[0], "__float__"): r = mupdf.FzRect(*tuple(r)) if isinstance( r, mupdf.FzRect): return mupdf.fz_quad_from_rect( r) if isinstance( r, Quad): return mupdf.fz_make_quad( r.ul.x, r.ul.y, r.ur.x, r.ur.y, r.ll.x, r.ll.y, r.lr.x, r.lr.y, ) q = mupdf.fz_make_quad(0, 0, 0, 0, 0, 0, 0, 0) p = [0,0,0,0] if not r or not isinstance(r, (tuple, list)) or len(r) != 4: return q if JM_FLOAT_ITEM(r, 0) is None: return mupdf.fz_quad_from_rect(JM_rect_from_py(r)) for i in range(4): if i >= len(r): return q # invalid: cancel the rest obj = r[i] # next point item if not PySequence_Check(obj) or PySequence_Size(obj) != 2: return q # invalid: cancel the rest p[i].x = JM_FLOAT_ITEM(obj, 0) p[i].y = JM_FLOAT_ITEM(obj, 1) if p[i].x is None or p[i].y is None: return q p[i].x = max( p[i].x, FZ_MIN_INF_RECT) p[i].y = max( p[i].y, FZ_MIN_INF_RECT) p[i].x = min( p[i].x, FZ_MAX_INF_RECT) p[i].y = min( p[i].y, FZ_MAX_INF_RECT) q.ul = p[0] q.ur = p[1] q.ll = p[2] q.lr = p[3] return q def JM_read_contents(pageref): ''' Read and concatenate a PDF page's /Contents object(s) in a buffer ''' assert isinstance(pageref, mupdf.PdfObj), f'{type(pageref)}' contents = mupdf.pdf_dict_get(pageref, mupdf.PDF_ENUM_NAME_Contents) if mupdf.pdf_is_array(contents): res = mupdf.FzBuffer(1024) for i in range(mupdf.pdf_array_len(contents)): if i > 0: mupdf.fz_append_byte(res, 32) obj = mupdf.pdf_array_get(contents, i) if mupdf.pdf_is_stream(obj): nres = mupdf.pdf_load_stream(obj) mupdf.fz_append_buffer(res, nres) elif contents.m_internal: res = mupdf.pdf_load_stream(contents) else: res = mupdf.FzBuffer(0) return res def JM_rect_from_py(r): if isinstance(r, mupdf.FzRect): return r if isinstance(r, mupdf.FzIrect): return mupdf.FzRect(r) if isinstance(r, Rect): return mupdf.fz_make_rect(r.x0, r.y0, r.x1, r.y1) if isinstance(r, IRect): return mupdf.fz_make_rect(r.x0, r.y0, r.x1, r.y1) if not r or not PySequence_Check(r) or PySequence_Size(r) != 4: return mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE) f = [0, 0, 0, 0] for i in range(4): f[i] = JM_FLOAT_ITEM(r, i) if f[i] is None: return mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE) if f[i] < FZ_MIN_INF_RECT: f[i] = FZ_MIN_INF_RECT if f[i] > FZ_MAX_INF_RECT: f[i] = FZ_MAX_INF_RECT return mupdf.fz_make_rect(f[0], f[1], f[2], f[3]) def JM_rects_overlap(a, b): if (0 or a.x0 >= b.x1 or a.y0 >= b.y1 or a.x1 <= b.x0 or a.y1 <= b.y0 ): return 0 return 1 def JM_refresh_links( page): ''' refreshes the link and annotation tables of a page ''' if page is None or not page.m_internal: return obj = mupdf.pdf_dict_get( page.obj(), PDF_NAME('Annots')) if obj.m_internal: pdf = page.doc() number = mupdf.pdf_lookup_page_number( pdf, page.obj()) page_mediabox = mupdf.FzRect() page_ctm = mupdf.FzMatrix() mupdf.pdf_page_transform( page, page_mediabox, page_ctm) link = mupdf.pdf_load_link_annots( pdf, page, obj, number, page_ctm) page.m_internal.links = mupdf.ll_fz_keep_link( link.m_internal) def JM_rotate_page_matrix(page): ''' calculate page rotation matrices ''' if not page.m_internal: return mupdf.FzMatrix() # no valid pdf page given rotation = JM_page_rotation(page) #log(f'{rotation=}') if rotation == 0: return mupdf.FzMatrix() # no rotation cb_size = JM_cropbox_size(page.obj()) w = cb_size.x h = cb_size.y #log(f'{=h w}') if rotation == 90: m = mupdf.fz_make_matrix(0, 1, -1, 0, h, 0) elif rotation == 180: m = mupdf.fz_make_matrix(-1, 0, 0, -1, w, h) else: m = mupdf.fz_make_matrix(0, -1, 1, 0, 0, w) #log(f'returning {m=}') return m def JM_search_stext_page(page, needle): if 1 or g_use_extra: return extra.JM_search_stext_page(page.m_internal, needle) rect = mupdf.FzRect(page.m_internal.mediabox) if not needle: return quads = [] class Hits: def __str__(self): return f'Hits(len={self.len} quads={self.quads} hfuzz={self.hfuzz} vfuzz={self.vfuzz}' hits = Hits() hits.len = 0 hits.quads = quads hits.hfuzz = 0.2 # merge kerns but not large gaps hits.vfuzz = 0.1 buffer_ = JM_new_buffer_from_stext_page(page) haystack_string = mupdf.fz_string_from_buffer(buffer_) haystack = 0 begin, end = find_string(haystack_string[haystack:], needle) if begin is None: #goto no_more_matches; return quads begin += haystack end += haystack inside = 0 i = 0 for block in page: if block.m_internal.type != mupdf.FZ_STEXT_BLOCK_TEXT: continue for line in block: for ch in line: i += 1 if not mupdf.fz_is_infinite_rect(rect): r = JM_char_bbox(line, ch) if not JM_rects_overlap(rect, r): #goto next_char; continue while 1: #try_new_match: if not inside: if haystack >= begin: inside = 1 if inside: if haystack < end: on_highlight_char(hits, line, ch) break else: inside = 0 begin, end = find_string(haystack_string[haystack:], needle) if begin is None: #goto no_more_matches; return quads else: #goto try_new_match; begin += haystack end += haystack continue break haystack += 1 #next_char:; assert haystack_string[haystack] == '\n', \ f'{haystack=} {haystack_string[haystack]=}' haystack += 1 assert haystack_string[haystack] == '\n', \ f'{haystack=} {haystack_string[haystack]=}' haystack += 1 #no_more_matches:; return quads def JM_scan_resources(pdf, rsrc, liste, what, stream_xref, tracer): ''' Step through /Resources, looking up image, xobject or font information ''' if mupdf.pdf_mark_obj(rsrc): mupdf.fz_warn('Circular dependencies! Consider page cleaning.') return # Circular dependencies! try: xobj = mupdf.pdf_dict_get(rsrc, mupdf.PDF_ENUM_NAME_XObject) if what == 1: # lookup fonts font = mupdf.pdf_dict_get(rsrc, mupdf.PDF_ENUM_NAME_Font) JM_gather_fonts(pdf, font, liste, stream_xref) elif what == 2: # look up images JM_gather_images(pdf, xobj, liste, stream_xref) elif what == 3: # look up form xobjects JM_gather_forms(pdf, xobj, liste, stream_xref) else: # should never happen return # check if we need to recurse into Form XObjects n = mupdf.pdf_dict_len(xobj) for i in range(n): obj = mupdf.pdf_dict_get_val(xobj, i) if mupdf.pdf_is_stream(obj): sxref = mupdf.pdf_to_num(obj) else: sxref = 0 subrsrc = mupdf.pdf_dict_get(obj, mupdf.PDF_ENUM_NAME_Resources) if subrsrc.m_internal: sxref_t = sxref if sxref_t not in tracer: tracer.append(sxref_t) JM_scan_resources( pdf, subrsrc, liste, what, sxref, tracer) else: mupdf.fz_warn('Circular dependencies! Consider page cleaning.') return finally: mupdf.pdf_unmark_obj(rsrc) def JM_set_choice_options(annot, liste): ''' set ListBox / ComboBox values ''' if not liste: return assert isinstance( liste, (tuple, list)) n = len( liste) if n == 0: return annot_obj = mupdf.pdf_annot_obj( annot) pdf = mupdf.pdf_get_bound_document( annot_obj) optarr = mupdf.pdf_new_array( pdf, n) for i in range(n): val = liste[i] opt = val if isinstance(opt, str): mupdf.pdf_array_push_text_string( optarr, opt) else: assert isinstance( val, (tuple, list)) and len( val) == 2, 'bad choice field list' opt1, opt2 = val assert opt1 and opt2, 'bad choice field list' optarrsub = mupdf.pdf_array_push_array( optarr, 2) mupdf.pdf_array_push_text_string( optarrsub, opt1) mupdf.pdf_array_push_text_string( optarrsub, opt2) mupdf.pdf_dict_put( annot_obj, PDF_NAME('Opt'), optarr) def JM_set_field_type(doc, obj, type): ''' Set the field type ''' setbits = 0 clearbits = 0 typename = None if type == mupdf.PDF_WIDGET_TYPE_BUTTON: typename = PDF_NAME('Btn') setbits = mupdf.PDF_BTN_FIELD_IS_PUSHBUTTON elif type == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON: typename = PDF_NAME('Btn') clearbits = mupdf.PDF_BTN_FIELD_IS_PUSHBUTTON setbits = mupdf.PDF_BTN_FIELD_IS_RADIO elif type == mupdf.PDF_WIDGET_TYPE_CHECKBOX: typename = PDF_NAME('Btn') clearbits = (mupdf.PDF_BTN_FIELD_IS_PUSHBUTTON | mupdf.PDF_BTN_FIELD_IS_RADIO) elif type == mupdf.PDF_WIDGET_TYPE_TEXT: typename = PDF_NAME('Tx') elif type == mupdf.PDF_WIDGET_TYPE_LISTBOX: typename = PDF_NAME('Ch') clearbits = mupdf.PDF_CH_FIELD_IS_COMBO elif type == mupdf.PDF_WIDGET_TYPE_COMBOBOX: typename = PDF_NAME('Ch') setbits = mupdf.PDF_CH_FIELD_IS_COMBO elif type == mupdf.PDF_WIDGET_TYPE_SIGNATURE: typename = PDF_NAME('Sig') if typename is not None and typename.m_internal: mupdf.pdf_dict_put(obj, PDF_NAME('FT'), typename) if setbits != 0 or clearbits != 0: bits = mupdf.pdf_dict_get_int(obj, PDF_NAME('Ff')) bits &= ~clearbits bits |= setbits mupdf.pdf_dict_put_int(obj, PDF_NAME('Ff'), bits) def JM_set_object_value(obj, key, value): ''' Set a PDF dict key to some value ''' eyecatcher = "fitz: replace me!" pdf = mupdf.pdf_get_bound_document(obj) # split PDF key at path seps and take last key part list_ = key.split('/') len_ = len(list_) i = len_ - 1 skey = list_[i] del list_[i] # del the last sub-key len_ = len(list_) # remaining length testkey = mupdf.pdf_dict_getp(obj, key) # check if key already exists if not testkey.m_internal: #No, it will be created here. But we cannot allow this happening if #indirect objects are referenced. So we check all higher level #sub-paths for indirect references. while len_ > 0: t = '/'.join(list_) # next high level if mupdf.pdf_is_indirect(mupdf.pdf_dict_getp(obj, JM_StrAsChar(t))): raise Exception(f"path to '{JM_StrAsChar(skey)}' has indirects") del list_[len_ - 1] # del last sub-key len_ = len(list_) # remaining length # Insert our eyecatcher. Will create all sub-paths in the chain, or # respectively remove old value of key-path. mupdf.pdf_dict_putp(obj, key, mupdf.pdf_new_text_string(eyecatcher)) testkey = mupdf.pdf_dict_getp(obj, key) if not mupdf.pdf_is_string(testkey): raise Exception(f"cannot insert value for '{key}'") temp = mupdf.pdf_to_text_string(testkey) if temp != eyecatcher: raise Exception(f"cannot insert value for '{key}'") # read the result as a string res = JM_object_to_buffer(obj, 1, 0) objstr = JM_EscapeStrFromBuffer(res) # replace 'eyecatcher' by desired 'value' nullval = f"/{skey}({eyecatcher})" newval = f"/{skey} {value}" newstr = objstr.replace(nullval, newval, 1) # make PDF object from resulting string new_obj = JM_pdf_obj_from_str(pdf, newstr) return new_obj def JM_set_ocg_arrays(conf, basestate, on, off, rbgroups, locked): if basestate: mupdf.pdf_dict_put_name( conf, PDF_NAME('BaseState'), basestate) if on is not None: mupdf.pdf_dict_del( conf, PDF_NAME('ON')) if on: arr = mupdf.pdf_dict_put_array( conf, PDF_NAME('ON'), 1) JM_set_ocg_arrays_imp( arr, on) if off is not None: mupdf.pdf_dict_del( conf, PDF_NAME('OFF')) if off: arr = mupdf.pdf_dict_put_array( conf, PDF_NAME('OFF'), 1) JM_set_ocg_arrays_imp( arr, off) if locked is not None: mupdf.pdf_dict_del( conf, PDF_NAME('Locked')) if locked: arr = mupdf.pdf_dict_put_array( conf, PDF_NAME('Locked'), 1) JM_set_ocg_arrays_imp( arr, locked) if rbgroups is not None: mupdf.pdf_dict_del( conf, PDF_NAME('RBGroups')) if rbgroups: arr = mupdf.pdf_dict_put_array( conf, PDF_NAME('RBGroups'), 1) n =len(rbgroups) for i in range(n): item0 = rbgroups[i] obj = mupdf.pdf_array_push_array( arr, 1) JM_set_ocg_arrays_imp( obj, item0) def JM_set_ocg_arrays_imp(arr, list_): ''' Set OCG arrays from dict of Python lists Works with dict like {"basestate":name, "on":list, "off":list, "rbg":list} ''' pdf = mupdf.pdf_get_bound_document(arr) for xref in list_: obj = mupdf.pdf_new_indirect(pdf, xref, 0) mupdf.pdf_array_push(arr, obj) def JM_set_resource_property(ref, name, xref): ''' Insert an item into Resources/Properties (used for Marked Content) Arguments: (1) e.g. page object, Form XObject (2) marked content name (3) xref of the referenced object (insert as indirect reference) ''' pdf = mupdf.pdf_get_bound_document(ref) ind = mupdf.pdf_new_indirect(pdf, xref, 0) if not ind.m_internal: RAISEPY(MSG_BAD_XREF, PyExc_ValueError) resources = mupdf.pdf_dict_get(ref, PDF_NAME('Resources')) if not resources.m_internal: resources = mupdf.pdf_dict_put_dict(ref, PDF_NAME('Resources'), 1) properties = mupdf.pdf_dict_get(resources, PDF_NAME('Properties')) if not properties.m_internal: properties = mupdf.pdf_dict_put_dict(resources, PDF_NAME('Properties'), 1) mupdf.pdf_dict_put(properties, mupdf.pdf_new_name(name), ind) def JM_set_widget_properties(annot, Widget): ''' Update the PDF form field with the properties from a Python Widget object. Called by "Page.add_widget" and "Annot.update_widget". ''' if isinstance( annot, Annot): annot = annot.this assert isinstance( annot, mupdf.PdfAnnot), f'{type(annot)=} {type=}' page = _pdf_annot_page(annot) assert page.m_internal, 'Annot is not bound to a page' annot_obj = mupdf.pdf_annot_obj(annot) pdf = page.doc() def GETATTR(name): return getattr(Widget, name, None) value = GETATTR("field_type") field_type = value # rectangle -------------------------------------------------------------- value = GETATTR("rect") rect = JM_rect_from_py(value) rot_mat = JM_rotate_page_matrix(page) rect = mupdf.fz_transform_rect(rect, rot_mat) mupdf.pdf_set_annot_rect(annot, rect) # fill color ------------------------------------------------------------- value = GETATTR("fill_color") if value and PySequence_Check(value): n = len(value) fill_col = mupdf.pdf_new_array(pdf, n) col = 0 for i in range(n): col = value[i] mupdf.pdf_array_push_real(fill_col, col) mupdf.pdf_field_set_fill_color(annot_obj, fill_col) # dashes ----------------------------------------------------------------- value = GETATTR("border_dashes") if value and PySequence_Check(value): n = len(value) dashes = mupdf.pdf_new_array(pdf, n) for i in range(n): mupdf.pdf_array_push_int(dashes, value[i]) mupdf.pdf_dict_putl(annot_obj, dashes, PDF_NAME('BS'), PDF_NAME('D')) # border color ----------------------------------------------------------- value = GETATTR("border_color") if value and PySequence_Check(value): n = len(value) border_col = mupdf.pdf_new_array(pdf, n) col = 0 for i in range(n): col = value[i] mupdf.pdf_array_push_real(border_col, col) mupdf.pdf_dict_putl(annot_obj, border_col, PDF_NAME('MK'), PDF_NAME('BC')) # entry ignored - may be used later # #int text_format = (int) PyInt_AsLong(GETATTR("text_format")); # # field label ----------------------------------------------------------- value = GETATTR("field_label") if value is not None: label = JM_StrAsChar(value) mupdf.pdf_dict_put_text_string(annot_obj, PDF_NAME('TU'), label) # field name ------------------------------------------------------------- value = GETATTR("field_name") if value is not None: name = JM_StrAsChar(value) old_name = mupdf.pdf_load_field_name(annot_obj) if name != old_name: mupdf.pdf_dict_put_text_string(annot_obj, PDF_NAME('T'), name) # max text len ----------------------------------------------------------- if field_type == mupdf.PDF_WIDGET_TYPE_TEXT: value = GETATTR("text_maxlen") text_maxlen = value if text_maxlen: mupdf.pdf_dict_put_int(annot_obj, PDF_NAME('MaxLen'), text_maxlen) value = GETATTR("field_display") d = value mupdf.pdf_field_set_display(annot_obj, d) # choice values ---------------------------------------------------------- if field_type in (mupdf.PDF_WIDGET_TYPE_LISTBOX, mupdf.PDF_WIDGET_TYPE_COMBOBOX): value = GETATTR("choice_values") JM_set_choice_options(annot, value) # border style ----------------------------------------------------------- value = GETATTR("border_style") val = JM_get_border_style(value) mupdf.pdf_dict_putl(annot_obj, val, PDF_NAME('BS'), PDF_NAME('S')) # border width ----------------------------------------------------------- value = GETATTR("border_width") border_width = value mupdf.pdf_dict_putl( annot_obj, mupdf.pdf_new_real(border_width), PDF_NAME('BS'), PDF_NAME('W'), ) # /DA string ------------------------------------------------------------- value = GETATTR("_text_da") da = JM_StrAsChar(value) mupdf.pdf_dict_put_text_string(annot_obj, PDF_NAME('DA'), da) mupdf.pdf_dict_del(annot_obj, PDF_NAME('DS')) # not supported by MuPDF mupdf.pdf_dict_del(annot_obj, PDF_NAME('RC')) # not supported by MuPDF # field flags ------------------------------------------------------------ field_flags = GETATTR("field_flags") if field_flags is not None: if field_type == mupdf.PDF_WIDGET_TYPE_COMBOBOX: field_flags |= mupdf.PDF_CH_FIELD_IS_COMBO elif field_type == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON: field_flags |= mupdf.PDF_BTN_FIELD_IS_RADIO elif field_type == mupdf.PDF_WIDGET_TYPE_BUTTON: field_flags |= mupdf.PDF_BTN_FIELD_IS_PUSHBUTTON mupdf.pdf_dict_put_int( annot_obj, PDF_NAME('Ff'), field_flags) # button caption --------------------------------------------------------- value = GETATTR("button_caption") ca = JM_StrAsChar(value) if ca: mupdf.pdf_field_set_button_caption(annot_obj, ca) # script (/A) ------------------------------------------------------- value = GETATTR("script") JM_put_script(annot_obj, PDF_NAME('A'), mupdf.PdfObj(), value) # script (/AA/K) ------------------------------------------------------- value = GETATTR("script_stroke") JM_put_script(annot_obj, PDF_NAME('AA'), PDF_NAME('K'), value) # script (/AA/F) ------------------------------------------------------- value = GETATTR("script_format") JM_put_script(annot_obj, PDF_NAME('AA'), PDF_NAME('F'), value) # script (/AA/V) ------------------------------------------------------- value = GETATTR("script_change") JM_put_script(annot_obj, PDF_NAME('AA'), PDF_NAME('V'), value) # script (/AA/C) ------------------------------------------------------- value = GETATTR("script_calc") JM_put_script(annot_obj, PDF_NAME('AA'), PDF_NAME('C'), value) # script (/AA/Bl) ------------------------------------------------------- value = GETATTR("script_blur") JM_put_script(annot_obj, PDF_NAME('AA'), mupdf.pdf_new_name('Bl'), value) # script (/AA/Fo) codespell:ignore -------------------------------------- value = GETATTR("script_focus") JM_put_script(annot_obj, PDF_NAME('AA'), mupdf.pdf_new_name('Fo'), value) # field value ------------------------------------------------------------ value = GETATTR("field_value") # field value text = JM_StrAsChar(value) # convert to text (may fail!) if field_type == mupdf.PDF_WIDGET_TYPE_RADIOBUTTON: if not value: mupdf.pdf_set_field_value(pdf, annot_obj, "Off", 1) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('AS'), "Off") else: # TODO check if another button in the group is ON and if so set it Off onstate = mupdf.pdf_button_field_on_state(annot_obj) if onstate.m_internal: on = mupdf.pdf_to_name(onstate) mupdf.pdf_set_field_value(pdf, annot_obj, on, 1) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('AS'), on) elif text: mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('AS'), text) elif field_type == mupdf.PDF_WIDGET_TYPE_CHECKBOX: onstate = mupdf.pdf_button_field_on_state(annot_obj) on = onstate.pdf_to_name() if value in (True, on) or text == 'Yes': mupdf.pdf_set_field_value(pdf, annot_obj, on, 1) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('AS'), on) mupdf.pdf_dict_put_name(annot_obj, PDF_NAME('V'), on) else: mupdf.pdf_dict_put_name( annot_obj, PDF_NAME('AS'), 'Off') mupdf.pdf_dict_put_name( annot_obj, PDF_NAME('V'), 'Off') else: if text: mupdf.pdf_set_field_value(pdf, annot_obj, text, 1) if field_type in (mupdf.PDF_WIDGET_TYPE_COMBOBOX, mupdf.PDF_WIDGET_TYPE_LISTBOX): mupdf.pdf_dict_del(annot_obj, PDF_NAME('I')) mupdf.pdf_dirty_annot(annot) mupdf.pdf_set_annot_hot(annot, 1) mupdf.pdf_set_annot_active(annot, 1) mupdf.pdf_update_annot(annot) def JM_show_string_cs( text, user_font, trm, s, wmode, bidi_level, markup_dir, language, ): i = 0 while i < len(s): l, ucs = mupdf.fz_chartorune(s[i:]) i += l gid = mupdf.fz_encode_character_sc(user_font, ucs) if gid == 0: gid, font = mupdf.fz_encode_character_with_fallback(user_font, ucs, 0, language) else: font = user_font mupdf.fz_show_glyph(text, font, trm, gid, ucs, wmode, bidi_level, markup_dir, language) adv = mupdf.fz_advance_glyph(font, gid, wmode) if wmode == 0: trm = mupdf.fz_pre_translate(trm, adv, 0) else: trm = mupdf.fz_pre_translate(trm, 0, -adv) return trm def JM_UnicodeFromBuffer(buff): buff_bytes = mupdf.fz_buffer_extract_copy(buff) val = buff_bytes.decode(errors='replace') z = val.find(chr(0)) if z >= 0: val = val[:z] return val def message_warning(text): ''' Generate a warning. ''' message(f'warning: {text}') def JM_update_stream(doc, obj, buffer_, compress): ''' update a stream object compress stream when beneficial ''' if compress: length, _ = mupdf.fz_buffer_storage(buffer_) if length > 30: # ignore small stuff buffer_compressed = JM_compress_buffer(buffer_) assert isinstance(buffer_compressed, mupdf.FzBuffer) if buffer_compressed.m_internal: length_compressed, _ = mupdf.fz_buffer_storage(buffer_compressed) if length_compressed < length: # was it worth the effort? mupdf.pdf_dict_put( obj, mupdf.PDF_ENUM_NAME_Filter, mupdf.PDF_ENUM_NAME_FlateDecode, ) mupdf.pdf_update_stream(doc, obj, buffer_compressed, 1) return mupdf.pdf_update_stream(doc, obj, buffer_, 0) def JM_xobject_from_page(pdfout, fsrcpage, xref, gmap): ''' Make an XObject from a PDF page For a positive xref assume that its object can be used instead ''' assert isinstance(gmap, mupdf.PdfGraftMap), f'{type(gmap)=}' if xref > 0: xobj1 = mupdf.pdf_new_indirect(pdfout, xref, 0) else: srcpage = _as_pdf_page(fsrcpage.this) spageref = srcpage.obj() mediabox = mupdf.pdf_to_rect(mupdf.pdf_dict_get_inheritable(spageref, PDF_NAME('MediaBox'))) # Deep-copy resources object of source page o = mupdf.pdf_dict_get_inheritable(spageref, PDF_NAME('Resources')) if gmap.m_internal: # use graftmap when possible resources = mupdf.pdf_graft_mapped_object(gmap, o) else: resources = mupdf.pdf_graft_object(pdfout, o) # get spgage contents source res = JM_read_contents(spageref) #------------------------------------------------------------- # create XObject representing the source page #------------------------------------------------------------- xobj1 = mupdf.pdf_new_xobject(pdfout, mediabox, mupdf.FzMatrix(), mupdf.PdfObj(0), res) # store spage contents JM_update_stream(pdfout, xobj1, res, 1) # store spage resources mupdf.pdf_dict_put(xobj1, PDF_NAME('Resources'), resources) return xobj1 def PySequence_Check(s): return isinstance(s, (tuple, list)) def PySequence_Size(s): return len(s) # constants: error messages. These are also in extra.i. # MSG_BAD_ANNOT_TYPE = "bad annot type" MSG_BAD_APN = "bad or missing annot AP/N" MSG_BAD_ARG_INK_ANNOT = "arg must be seq of seq of float pairs" MSG_BAD_ARG_POINTS = "bad seq of points" MSG_BAD_BUFFER = "bad type: 'buffer'" MSG_BAD_COLOR_SEQ = "bad color sequence" MSG_BAD_DOCUMENT = "cannot open broken document" MSG_BAD_FILETYPE = "bad filetype" MSG_BAD_LOCATION = "bad location" MSG_BAD_OC_CONFIG = "bad config number" MSG_BAD_OC_LAYER = "bad layer number" MSG_BAD_OC_REF = "bad 'oc' reference" MSG_BAD_PAGEID = "bad page id" MSG_BAD_PAGENO = "bad page number(s)" MSG_BAD_PDFROOT = "PDF has no root" MSG_BAD_RECT = "rect is infinite or empty" MSG_BAD_TEXT = "bad type: 'text'" MSG_BAD_XREF = "bad xref" MSG_COLOR_COUNT_FAILED = "color count failed" MSG_FILE_OR_BUFFER = "need font file or buffer" MSG_FONT_FAILED = "cannot create font" MSG_IS_NO_ANNOT = "is no annotation" MSG_IS_NO_IMAGE = "is no image" MSG_IS_NO_PDF = "is no PDF" MSG_IS_NO_DICT = "object is no PDF dict" MSG_PIX_NOALPHA = "source pixmap has no alpha" MSG_PIXEL_OUTSIDE = "pixel(s) outside image" JM_Exc_FileDataError = 'FileDataError' PyExc_ValueError = 'ValueError' def RAISEPY( msg, exc): #JM_Exc_CurrentException=exc #fz_throw(context, FZ_ERROR_GENERIC, msg) raise Exception( msg) def PyUnicode_DecodeRawUnicodeEscape(s, errors='strict'): # FIXED: handle raw unicode escape sequences if not s: return "" if isinstance(s, str): rc = s.encode("utf8", errors=errors) elif isinstance(s, bytes): rc = s[:] ret = rc.decode('raw_unicode_escape', errors=errors) return ret def CheckColor(c: OptSeq): if c: if ( type(c) not in (list, tuple) or len(c) not in (1, 3, 4) or min(c) < 0 or max(c) > 1 ): raise ValueError("need 1, 3 or 4 color components in range 0 to 1") def CheckFont(page: Page, fontname: str) -> tuple: """Return an entry in the page's font list if reference name matches. """ for f in page.get_fonts(): if f[4] == fontname: return f def CheckFontInfo(doc: Document, xref: int) -> list: """Return a font info if present in the document. """ for f in doc.FontInfos: if xref == f[0]: return f def CheckMarkerArg(quads: typing.Any) -> tuple: if CheckRect(quads): r = Rect(quads) return (r.quad,) if CheckQuad(quads): return (quads,) for q in quads: if not (CheckRect(q) or CheckQuad(q)): raise ValueError("bad quads entry") return quads def CheckMorph(o: typing.Any) -> bool: if not bool(o): return False if not (type(o) in (list, tuple) and len(o) == 2): raise ValueError("morph must be a sequence of length 2") if not (len(o[0]) == 2 and len(o[1]) == 6): raise ValueError("invalid morph param 0") if not o[1][4] == o[1][5] == 0: raise ValueError("invalid morph param 1") return True def CheckParent(o: typing.Any): return if not hasattr(o, "parent") or o.parent is None: raise ValueError(f"orphaned object {type(o)=}: parent is None") def CheckQuad(q: typing.Any) -> bool: """Check whether an object is convex, not empty quad-like. It must be a sequence of 4 number pairs. """ try: q0 = Quad(q) except Exception: if g_exceptions_verbose > 1: exception_info() return False return q0.is_convex def CheckRect(r: typing.Any) -> bool: """Check whether an object is non-degenerate rect-like. It must be a sequence of 4 numbers. """ try: r = Rect(r) except Exception: if g_exceptions_verbose > 1: exception_info() return False return not (r.is_empty or r.is_infinite) def ColorCode(c: typing.Union[list, tuple, float, None], f: str) -> str: if not c: return "" if hasattr(c, "__float__"): c = (c,) CheckColor(c) if len(c) == 1: s = _format_g(c[0]) + " " return s + "G " if f == "c" else s + "g " if len(c) == 3: s = _format_g(tuple(c)) + " " return s + "RG " if f == "c" else s + "rg " s = _format_g(tuple(c)) + " " return s + "K " if f == "c" else s + "k " def Page__add_text_marker(self, quads, annot_type): pdfpage = self._pdf_page() rotation = JM_page_rotation(pdfpage) def final(): if rotation != 0: mupdf.pdf_dict_put_int(pdfpage.obj(), PDF_NAME('Rotate'), rotation) try: if rotation != 0: mupdf.pdf_dict_put_int(pdfpage.obj(), PDF_NAME('Rotate'), 0) annot = mupdf.pdf_create_annot(pdfpage, annot_type) for item in quads: q = JM_quad_from_py(item) mupdf.pdf_add_annot_quad_point(annot, q) mupdf.pdf_update_annot(annot) JM_add_annot_id(annot, "A") final() except Exception: if g_exceptions_verbose: exception_info() final() return return Annot(annot) def PDF_NAME(x): assert isinstance(x, str) ret = getattr(mupdf, f'PDF_ENUM_NAME_{x}') # Note that we return a (swig proxy for) pdf_obj*, not a mupdf.PdfObj. In # the C++ API, the constructor PdfObj::PdfObj(pdf_obj*) is marked as # explicit, but this seems to be ignored by SWIG. If SWIG started to # generate code that respected `explicit`, we would need to do `return # mupdf.PdfObj(ret)`. # # [Compare with extra.i, where we define our own PDF_NAME2() macro that # returns a mupdf::PdfObj.] return ret def UpdateFontInfo(doc: Document, info: typing.Sequence): xref = info[0] found = False for i, fi in enumerate(doc.FontInfos): if fi[0] == xref: found = True break if found: doc.FontInfos[i] = info else: doc.FontInfos.append(info) def args_match(args, *types): ''' Returns true if matches . Each item in is a type or tuple of types. Any of these types will match an item in . `None` will match anything in . `type(None)` will match an arg whose value is `None`. ''' j = 0 for i in range(len(types)): type_ = types[i] if j >= len(args): if isinstance(type_, tuple) and None in type_: # arg is missing but has default value. continue else: return False if type_ is not None and not isinstance(args[j], type_): return False j += 1 if j != len(args): return False return True def calc_image_matrix(width, height, tr, rotate, keep): ''' # compute image insertion matrix ''' trect = JM_rect_from_py(tr) rot = mupdf.fz_rotate(rotate) trw = trect.x1 - trect.x0 trh = trect.y1 - trect.y0 w = trw h = trh if keep: large = max(width, height) fw = width / large fh = height / large else: fw = fh = 1 small = min(fw, fh) if rotate != 0 and rotate != 180: f = fw fw = fh fh = f if fw < 1: if trw / fw > trh / fh: w = trh * small h = trh else: w = trw h = trw / small elif fw != fh: if trw / fw > trh / fh: w = trh / small h = trh else: w = trw h = trw * small else: w = trw h = trh tmp = mupdf.fz_make_point( (trect.x0 + trect.x1) / 2, (trect.y0 + trect.y1) / 2, ) mat = mupdf.fz_make_matrix(1, 0, 0, 1, -0.5, -0.5) mat = mupdf.fz_concat(mat, rot) mat = mupdf.fz_concat(mat, mupdf.fz_scale(w, h)) mat = mupdf.fz_concat(mat, mupdf.fz_translate(tmp.x, tmp.y)) return mat def detect_super_script(line, ch): if line.m_internal.wmode == 0 and line.m_internal.dir.x == 1 and line.m_internal.dir.y == 0: return ch.m_internal.origin.y < line.m_internal.first_char.origin.y - ch.m_internal.size * 0.1 return 0 def dir_str(x): ret = f'{x} {type(x)} ({len(dir(x))}):\n' for i in dir(x): ret += f' {i}\n' return ret def getTJstr(text: str, glyphs: typing.Union[list, tuple, None], simple: bool, ordering: int) -> str: """ Return a PDF string enclosed in [] brackets, suitable for the PDF TJ operator. Notes: The input string is converted to either 2 or 4 hex digits per character. Args: simple: no glyphs: 2-chars, use char codes as the glyph glyphs: 2-chars, use glyphs instead of char codes (Symbol, ZapfDingbats) not simple: ordering < 0: 4-chars, use glyphs not char codes ordering >=0: a CJK font! 4 chars, use char codes as glyphs """ if text.startswith("[<") and text.endswith(">]"): # already done return text if not bool(text): return "[<>]" if simple: # each char or its glyph is coded as a 2-byte hex if glyphs is None: # not Symbol, not ZapfDingbats: use char code otxt = "".join([f"{ord(c):02x}" if ord(c) < 256 else "b7" for c in text]) else: # Symbol or ZapfDingbats: use glyphs otxt = "".join( [f"{glyphs[ord(c)][0]:02x}" if ord(c) < 256 else "b7" for c in text] ) return "[<" + otxt + ">]" # non-simple fonts: each char or its glyph is coded as 4-byte hex if ordering < 0: # not a CJK font: use the glyphs otxt = "".join([f"{glyphs[ord(c)][0]:04x}" for c in text]) else: # CJK: use the char codes otxt = "".join([f"{ord(c):04x}" for c in text]) return "[<" + otxt + ">]" def get_pdf_str(s: str) -> str: """ Return a PDF string depending on its coding. Notes: Returns a string bracketed with either "()" or "<>" for hex values. If only ascii then "(original)" is returned, else if only 8 bit chars then "(original)" with interspersed octal strings \nnn is returned, else a string "" is returned, where [hexstring] is the UTF-16BE encoding of the original. """ if not bool(s): return "()" def make_utf16be(s): r = bytearray([254, 255]) + bytearray(s, "UTF-16BE") return "<" + r.hex() + ">" # brackets indicate hex # The following either returns the original string with mixed-in # octal numbers \nnn for chars outside the ASCII range, or returns # the UTF-16BE BOM version of the string. r = "" for c in s: oc = ord(c) if oc > 255: # shortcut if beyond 8-bit code range return make_utf16be(s) if oc > 31 and oc < 127: # in ASCII range if c in ("(", ")", "\\"): # these need to be escaped r += "\\" r += c continue if oc > 127: # beyond ASCII r += f"\\{oc:03o}" continue # now the white spaces if oc == 8: # backspace r += "\\b" elif oc == 9: # tab r += "\\t" elif oc == 10: # line feed r += "\\n" elif oc == 12: # form feed r += "\\f" elif oc == 13: # carriage return r += "\\r" else: r += "\\267" # unsupported: replace by 0xB7 return "(" + r + ")" def get_tessdata(tessdata=None): """Detect Tesseract language support folder. This function is used to enable OCR via Tesseract even if the language support folder is not specified directly or in environment variable TESSDATA_PREFIX. * If is set we return it directly. * Otherwise we return `os.environ['TESSDATA_PREFIX']` if set. * Otherwise we search for a Tesseract installation and return its language support folder. * Otherwise we raise an exception. """ if tessdata: return tessdata tessdata = os.getenv("TESSDATA_PREFIX") if tessdata: # use environment variable if set return tessdata # Try to locate the tesseract-ocr installation. import subprocess cp = subprocess.run('tesseract --list-langs', shell=1, capture_output=1, check=0, text=True) if cp.returncode == 0: m = re.search('List of available languages in "(.+)"', cp.stdout) if m: tessdata = m.group(1) return tessdata # Windows systems: if sys.platform == "win32": cp = subprocess.run("where tesseract", shell=1, capture_output=1, check=0, text=True) response = cp.stdout.strip() if cp.returncode or not response: raise RuntimeError("No tessdata specified and Tesseract is not installed") dirname = os.path.dirname(response) # path of tesseract.exe tessdata = os.path.join(dirname, "tessdata") # language support if os.path.exists(tessdata): # all ok? return tessdata else: # should not happen! raise RuntimeError(f"No tessdata specified and Tesseract installation has no {tessdata} folder") # Unix-like systems: attempts = list() for path in 'tesseract-ocr', 'tesseract': cp = subprocess.run(f'whereis {path}', shell=1, capture_output=1, check=0, text=True) if cp.returncode == 0: response = cp.stdout.strip().split() if len(response) == 2: # search tessdata in folder structure dirname = response[1] # contains tesseract-ocr installation folder pattern = f"{dirname}/*/tessdata" attempts.append(pattern) tessdatas = glob.glob(pattern) tessdatas.sort() if tessdatas: return tessdatas[-1] if attempts: text = 'No tessdata specified and no match for:\n' for attempt in attempts: text += f' {attempt}' raise RuntimeError(text) else: raise RuntimeError('No tessdata specified and Tesseract is not installed') def css_for_pymupdf_font( fontcode: str, *, CSS: OptStr = None, archive: AnyType = None, name: OptStr = None ) -> str: """Create @font-face items for the given fontcode of pymupdf-fonts. Adds @font-face support for fonts contained in package pymupdf-fonts. Creates a CSS font-family for all fonts starting with string 'fontcode'. Note: The font naming convention in package pymupdf-fonts is "fontcode", where the suffix "sf" is either empty or one of "it", "bo" or "bi". These suffixes thus represent the regular, italic, bold or bold-italic variants of a font. For example, font code "notos" refers to fonts "notos" - "Noto Sans Regular" "notosit" - "Noto Sans Italic" "notosbo" - "Noto Sans Bold" "notosbi" - "Noto Sans Bold Italic" This function creates four CSS @font-face definitions and collectively assigns the font-family name "notos" to them (or the "name" value). All fitting font buffers of the pymupdf-fonts package are placed / added to the archive provided as parameter. To use the font in pymupdf.Story, execute 'set_font(fontcode)'. The correct font weight (bold) or style (italic) will automatically be selected. Expects and returns the CSS source, with the new CSS definitions appended. Args: fontcode: (str) font code for naming the font variants to include. E.g. "fig" adds notos, notosi, notosb, notosbi fonts. A maximum of 4 font variants is accepted. CSS: (str) CSS string to add @font-face definitions to. archive: (Archive, mandatory) where to place the font buffers. name: (str) use this as family-name instead of 'fontcode'. Returns: Modified CSS, with appended @font-face statements for each font variant of fontcode. Fontbuffers associated with "fontcode" will be added to 'archive'. """ # @font-face template string CSSFONT = "\n@font-face {font-family: %s; src: url(%s);%s%s}\n" if not type(archive) is Archive: raise ValueError("'archive' must be an Archive") if CSS is None: CSS = "" # select font codes starting with the pass-in string font_keys = [k for k in fitz_fontdescriptors.keys() if k.startswith(fontcode)] if font_keys == []: raise ValueError(f"No font code '{fontcode}' found in pymupdf-fonts.") if len(font_keys) > 4: raise ValueError("fontcode too short") if name is None: # use this name for font-family name = fontcode for fkey in font_keys: font = fitz_fontdescriptors[fkey] bold = font["bold"] # determine font property italic = font["italic"] # determine font property fbuff = font["loader"]() # load the fontbuffer archive.add(fbuff, fkey) # update the archive bold_text = "font-weight: bold;" if bold else "" italic_text = "font-style: italic;" if italic else "" CSS += CSSFONT % (name, fkey, bold_text, italic_text) return CSS def get_text_length(text: str, fontname: str ="helv", fontsize: float =11, encoding: int =0) -> float: """Calculate length of a string for a built-in font. Args: fontname: name of the font. fontsize: font size points. encoding: encoding to use, 0=Latin (default), 1=Greek, 2=Cyrillic. Returns: (float) length of text. """ fontname = fontname.lower() basename = Base14_fontdict.get(fontname, None) glyphs = None if basename == "Symbol": glyphs = symbol_glyphs if basename == "ZapfDingbats": glyphs = zapf_glyphs if glyphs is not None: w = sum([glyphs[ord(c)][1] if ord(c) < 256 else glyphs[183][1] for c in text]) return w * fontsize if fontname in Base14_fontdict.keys(): return util_measure_string( text, Base14_fontdict[fontname], fontsize, encoding ) if fontname in ( "china-t", "china-s", "china-ts", "china-ss", "japan", "japan-s", "korea", "korea-s", ): return len(text) * fontsize raise ValueError(f"Font '{fontname}' is unsupported") def image_profile(img: ByteString) -> dict: """ Return basic properties of an image. Args: img: bytes, bytearray, io.BytesIO object or an opened image file. Returns: A dictionary with keys width, height, colorspace.n, bpc, type, ext and size, where 'type' is the MuPDF image type (0 to 14) and 'ext' the suitable file extension. """ if type(img) is io.BytesIO: stream = img.getvalue() elif hasattr(img, "read"): stream = img.read() elif type(img) in (bytes, bytearray): stream = img else: raise ValueError("bad argument 'img'") return TOOLS.image_profile(stream) def jm_append_merge(dev): ''' Append current path to list or merge into last path of the list. (1) Append if first path, different item lists or not a 'stroke' version of previous path (2) If new path has the same items, merge its content into previous path and change path["type"] to "fs". (3) If "out" is callable, skip the previous and pass dictionary to it. ''' #log(f'{getattr(dev, "pathdict", None)=}') assert isinstance(dev.out, list) #log( f'{dev.out=}') if callable(dev.method) or dev.method: # function or method # callback. if dev.method is None: # fixme, this surely cannot happen? assert 0 #resp = PyObject_CallFunctionObjArgs(out, dev.pathdict, NULL) else: #log(f'calling {dev.out=} {dev.method=} {dev.pathdict=}') resp = getattr(dev.out, dev.method)(dev.pathdict) if not resp: message("calling cdrawings callback function/method failed!") dev.pathdict = None return def append(): #log(f'jm_append_merge(): clearing dev.pathdict') dev.out.append(dev.pathdict.copy()) dev.pathdict.clear() assert isinstance(dev.out, list) len_ = len(dev.out) # len of output list so far #log(f'{len_=}') if len_ == 0: # always append first path return append() #log(f'{getattr(dev, "pathdict", None)=}') thistype = dev.pathdict[ dictkey_type] #log(f'{thistype=}') if thistype != 's': # if not stroke, then append return append() prev = dev.out[ len_-1] # get prev path #log( f'{prev=}') prevtype = prev[ dictkey_type] #log( f'{prevtype=}') if prevtype != 'f': # if previous not fill, append return append() # last check: there must be the same list of items for "f" and "s". previtems = prev[ dictkey_items] thisitems = dev.pathdict[ dictkey_items] if previtems != thisitems: return append() #rc = PyDict_Merge(prev, dev.pathdict, 0); // merge with no override try: for k, v in dev.pathdict.items(): if k not in prev: prev[k] = v rc = 0 except Exception: if g_exceptions_verbose: exception_info() #raise rc = -1 if rc == 0: prev[ dictkey_type] = 'fs' dev.pathdict.clear() else: message("could not merge stroke and fill path") append() def jm_bbox_add_rect( dev, ctx, rect, code): if not dev.layers: dev.result.append( (code, JM_py_from_rect(rect))) else: dev.result.append( (code, JM_py_from_rect(rect), dev.layer_name)) def jm_bbox_fill_image( dev, ctx, image, ctm, alpha, color_params): r = mupdf.FzRect(mupdf.FzRect.Fixed_UNIT) r = mupdf.ll_fz_transform_rect( r.internal(), ctm) jm_bbox_add_rect( dev, ctx, r, "fill-image") def jm_bbox_fill_image_mask( dev, ctx, image, ctm, colorspace, color, alpha, color_params): try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_transform_rect(mupdf.fz_unit_rect, ctm), "fill-imgmask") except Exception: if g_exceptions_verbose: exception_info() raise def jm_bbox_fill_path( dev, ctx, path, even_odd, ctm, colorspace, color, alpha, color_params): even_odd = True if even_odd else False try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_path(path, None, ctm), "fill-path") except Exception: if g_exceptions_verbose: exception_info() raise def jm_bbox_fill_shade( dev, ctx, shade, ctm, alpha, color_params): try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_shade( shade, ctm), "fill-shade") except Exception: if g_exceptions_verbose: exception_info() raise def jm_bbox_stroke_text( dev, ctx, text, stroke, ctm, *args): try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_text( text, stroke, ctm), "stroke-text") except Exception: if g_exceptions_verbose: exception_info() raise def jm_bbox_fill_text( dev, ctx, text, ctm, *args): try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_text( text, None, ctm), "fill-text") except Exception: if g_exceptions_verbose: exception_info() raise def jm_bbox_ignore_text( dev, ctx, text, ctm): jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_text(text, None, ctm), "ignore-text") def jm_bbox_stroke_path( dev, ctx, path, stroke, ctm, colorspace, color, alpha, color_params): try: jm_bbox_add_rect( dev, ctx, mupdf.ll_fz_bound_path( path, stroke, ctm), "stroke-path") except Exception: if g_exceptions_verbose: exception_info() raise def jm_checkquad(dev): ''' Check whether the last 4 lines represent a quad. Because of how we count, the lines are a polyline already, i.e. last point of a line equals 1st point of next line. So we check for a polygon (last line's end point equals start point). If not true we return 0. ''' #log(f'{getattr(dev, "pathdict", None)=}') items = dev.pathdict[ dictkey_items] len_ = len(items) f = [0] * 8 # coordinates of the 4 corners # fill the 8 floats in f, start from items[-4:] for i in range( 4): # store line start points line = items[ len_ - 4 + i] temp = JM_point_from_py( line[1]) f[i * 2] = temp.x f[i * 2 + 1] = temp.y lp = JM_point_from_py( line[ 2]) if lp.x != f[0] or lp.y != f[1]: # not a polygon! #dev.linecount -= 1 return 0 # we have detected a quad dev.linecount = 0 # reset this # a quad item is ("qu", (ul, ur, ll, lr)), where the tuple items # are pairs of floats representing a quad corner each. # relationship of float array to quad points: # (0, 1) = ul, (2, 3) = ll, (6, 7) = ur, (4, 5) = lr q = mupdf.fz_make_quad(f[0], f[1], f[6], f[7], f[2], f[3], f[4], f[5]) rect = ('qu', JM_py_from_quad(q)) items[ len_ - 4] = rect # replace item -4 by rect del items[ len_ - 3 : len_] # delete remaining 3 items return 1 def jm_checkrect(dev): ''' Check whether the last 3 path items represent a rectangle. Returns 1 if we have modified the path, otherwise 0. ''' #log(f'{getattr(dev, "pathdict", None)=}') dev.linecount = 0 # reset line count orientation = 0 # area orientation of rectangle items = dev.pathdict[ dictkey_items] len_ = len(items) line0 = items[ len_ - 3] ll = JM_point_from_py( line0[ 1]) lr = JM_point_from_py( line0[ 2]) # no need to extract "line1"! line2 = items[ len_ - 1] ur = JM_point_from_py( line2[ 1]) ul = JM_point_from_py( line2[ 2]) # Assumption: # When decomposing rects, MuPDF always starts with a horizontal line, # followed by a vertical line, followed by a horizontal line. # First line: (ll, lr), third line: (ul, ur). # If 1st line is below 3rd line, we record anti-clockwise (+1), else # clockwise (-1) orientation. if (0 or ll.y != lr.y or ll.x != ul.x or ur.y != ul.y or ur.x != lr.x ): return 0 # not a rectangle # we have a rect, replace last 3 "l" items by one "re" item. if ul.y < lr.y: r = mupdf.fz_make_rect(ul.x, ul.y, lr.x, lr.y) orientation = 1 else: r = mupdf.fz_make_rect(ll.x, ll.y, ur.x, ur.y) orientation = -1 rect = ( 're', JM_py_from_rect(r), orientation) items[ len_ - 3] = rect # replace item -3 by rect del items[ len_ - 2 : len_] # delete remaining 2 items return 1 def jm_trace_text( dev, text, type_, ctm, colorspace, color, alpha, seqno): span = text.head while 1: if not span: break jm_trace_text_span( dev, span, type_, ctm, colorspace, color, alpha, seqno) span = span.next def jm_trace_text_span(dev, span, type_, ctm, colorspace, color, alpha, seqno): ''' jm_trace_text_span(fz_context *ctx, PyObject *out, fz_text_span *span, int type, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, size_t seqno) ''' out_font = None assert isinstance( span, mupdf.fz_text_span) span = mupdf.FzTextSpan( span) assert isinstance( ctm, mupdf.fz_matrix) ctm = mupdf.FzMatrix( ctm) fontname = JM_font_name( span.font()) #float rgb[3]; #PyObject *chars = PyTuple_New(span->len); mat = mupdf.fz_concat(span.trm(), ctm) # text transformation matrix dir = mupdf.fz_transform_vector(mupdf.fz_make_point(1, 0), mat) # writing direction fsize = math.sqrt(dir.x * dir.x + dir.y * dir.y) # font size dir = mupdf.fz_normalize_vector(dir) space_adv = 0 asc = JM_font_ascender( span.font()) dsc = JM_font_descender( span.font()) if asc < 1e-3: # probably Tesseract font dsc = -0.1 asc = 0.9 # compute effective ascender / descender ascsize = asc * fsize / (asc - dsc) dscsize = dsc * fsize / (asc - dsc) fflags = 0 # font flags mono = mupdf.fz_font_is_monospaced( span.font()) fflags += mono * TEXT_FONT_MONOSPACED fflags += mupdf.fz_font_is_italic( span.font()) * TEXT_FONT_ITALIC fflags += mupdf.fz_font_is_serif( span.font()) * TEXT_FONT_SERIFED fflags += mupdf.fz_font_is_bold( span.font()) * TEXT_FONT_BOLD last_adv = 0 # walk through characters of span span_bbox = mupdf.FzRect() rot = mupdf.fz_make_matrix(dir.x, dir.y, -dir.y, dir.x, 0, 0) if dir.x == -1: # left-right flip rot.d = 1 chars = [] for i in range( span.m_internal.len): adv = 0 if span.items(i).gid >= 0: adv = mupdf.fz_advance_glyph( span.font(), span.items(i).gid, span.m_internal.wmode) adv *= fsize last_adv = adv if span.items(i).ucs == 32: space_adv = adv char_orig = mupdf.fz_make_point(span.items(i).x, span.items(i).y) char_orig = mupdf.fz_transform_point(char_orig, ctm) m1 = mupdf.fz_make_matrix(1, 0, 0, 1, -char_orig.x, -char_orig.y) m1 = mupdf.fz_concat(m1, rot) m1 = mupdf.fz_concat(m1, mupdf.FzMatrix(1, 0, 0, 1, char_orig.x, char_orig.y)) x0 = char_orig.x x1 = x0 + adv if ( (mat.d > 0 and (dir.x == 1 or dir.x == -1)) or (mat.b != 0 and mat.b == -mat.c) ): # up-down flip y0 = char_orig.y + dscsize y1 = char_orig.y + ascsize else: y0 = char_orig.y - ascsize y1 = char_orig.y - dscsize char_bbox = mupdf.fz_make_rect(x0, y0, x1, y1) char_bbox = mupdf.fz_transform_rect(char_bbox, m1) chars.append( ( span.items(i).ucs, span.items(i).gid, ( char_orig.x, char_orig.y, ), ( char_bbox.x0, char_bbox.y0, char_bbox.x1, char_bbox.y1, ), ) ) if i > 0: span_bbox = mupdf.fz_union_rect(span_bbox, char_bbox) else: span_bbox = char_bbox chars = tuple(chars) if not space_adv: if not (fflags & TEXT_FONT_MONOSPACED): c, out_font = mupdf.fz_encode_character_with_fallback( span.font(), 32, 0, 0) space_adv = mupdf.fz_advance_glyph( span.font(), c, span.m_internal.wmode, ) space_adv *= fsize if not space_adv: space_adv = last_adv else: space_adv = last_adv # for mono, any char width suffices # make the span dictionary span_dict = dict() span_dict[ 'dir'] = JM_py_from_point(dir) span_dict[ 'font'] = JM_EscapeStrFromStr(fontname) span_dict[ 'wmode'] = span.m_internal.wmode span_dict[ 'flags'] =fflags span_dict[ "bidi_lvl"] =span.m_internal.bidi_level span_dict[ "bidi_dir"] = span.m_internal.markup_dir span_dict[ 'ascender'] = asc span_dict[ 'descender'] = dsc span_dict[ 'colorspace'] = 3 if colorspace: rgb = mupdf.fz_convert_color( mupdf.FzColorspace( mupdf.ll_fz_keep_colorspace( colorspace)), color, mupdf.fz_device_rgb(), mupdf.FzColorspace(), mupdf.FzColorParams(), ) rgb = rgb[:3] # mupdf.fz_convert_color() always returns 4 items. else: rgb = (0, 0, 0) if dev.linewidth > 0: # width of character border linewidth = dev.linewidth else: linewidth = fsize * 0.05 # default: 5% of font size #log(f'{dev.linewidth=:.4f} {fsize=:.4f} {linewidth=:.4f}') span_dict[ 'color'] = rgb span_dict[ 'size'] = fsize span_dict[ "opacity"] = alpha span_dict[ "linewidth"] = linewidth span_dict[ "spacewidth"] = space_adv span_dict[ 'type'] = type_ span_dict[ 'bbox'] = JM_py_from_rect(span_bbox) span_dict[ 'layer'] = dev.layer_name span_dict[ "seqno"] = seqno span_dict[ 'chars'] = chars #log(f'{span_dict=}') dev.out.append( span_dict) def jm_lineart_color(colorspace, color): #log(f' ') if colorspace: try: # Need to be careful to use a named Python object to ensure # that the `params` we pass to mupdf.ll_fz_convert_color() is # valid. E.g. doing: # # rgb = mupdf.ll_fz_convert_color(..., mupdf.FzColorParams().internal()) # # - seems to end up with a corrupted `params`. # cs = mupdf.FzColorspace( mupdf.FzColorspace.Fixed_RGB) cp = mupdf.FzColorParams() rgb = mupdf.ll_fz_convert_color( colorspace, color, cs.m_internal, None, cp.internal(), ) except Exception: if g_exceptions_verbose: exception_info() raise return rgb[:3] return () def jm_lineart_drop_device(dev, ctx): if isinstance(dev.out, list): dev.out = [] dev.scissors = [] def jm_lineart_fill_path( dev, ctx, path, even_odd, ctm, colorspace, color, alpha, color_params): #log(f'{getattr(dev, "pathdict", None)=}') #log(f'jm_lineart_fill_path(): {dev.seqno=}') even_odd = True if even_odd else False try: assert isinstance( ctm, mupdf.fz_matrix) dev.ctm = mupdf.FzMatrix( ctm) # fz_concat(ctm, dev_ptm); dev.path_type = trace_device_FILL_PATH jm_lineart_path( dev, ctx, path) if dev.pathdict is None: return #item_count = len(dev.pathdict[ dictkey_items]) #if item_count == 0: # return dev.pathdict[ dictkey_type] ="f" dev.pathdict[ "even_odd"] = even_odd dev.pathdict[ "fill_opacity"] = alpha #log(f'setting dev.pathdict[ "closePath"] to false') #dev.pathdict[ "closePath"] = False dev.pathdict[ "fill"] = jm_lineart_color( colorspace, color) dev.pathdict[ dictkey_rect] = JM_py_from_rect(dev.pathrect) dev.pathdict[ "seqno"] = dev.seqno #jm_append_merge(dev) dev.pathdict[ 'layer'] = dev.layer_name if dev.clips: dev.pathdict[ 'level'] = dev.depth jm_append_merge(dev) dev.seqno += 1 #log(f'jm_lineart_fill_path() end: {getattr(dev, "pathdict", None)=}') except Exception: if g_exceptions_verbose: exception_info() raise # There are 3 text trace types: # 0 - fill text (PDF Tr 0) # 1 - stroke text (PDF Tr 1) # 3 - ignore text (PDF Tr 3) def jm_lineart_fill_text( dev, ctx, text, ctm, colorspace, color, alpha, color_params): if 0: log(f'{type(ctx)=} {ctx=}') log(f'{type(dev)=} {dev=}') log(f'{type(text)=} {text=}') log(f'{type(ctm)=} {ctm=}') log(f'{type(colorspace)=} {colorspace=}') log(f'{type(color)=} {color=}') log(f'{type(alpha)=} {alpha=}') log(f'{type(color_params)=} {color_params=}') jm_trace_text(dev, text, 0, ctm, colorspace, color, alpha, dev.seqno) dev.seqno += 1 def jm_lineart_ignore_text(dev, text, ctm): #log(f'{getattr(dev, "pathdict", None)=}') jm_trace_text(dev, text, 3, ctm, None, None, 1, dev.seqno) dev.seqno += 1 class Walker(mupdf.FzPathWalker2): def __init__(self, dev): super().__init__() self.use_virtual_moveto() self.use_virtual_lineto() self.use_virtual_curveto() self.use_virtual_closepath() self.dev = dev def closepath(self, ctx): # trace_close(). #log(f'Walker(): {self.dev.pathdict=}') try: if self.dev.linecount == 3: if jm_checkrect(self.dev): #log(f'end1: {self.dev.pathdict=}') return self.dev.linecount = 0 # reset # of consec. lines if self.dev.havemove: if self.dev.lastpoint != self.dev.firstpoint: item = ("l", JM_py_from_point(self.dev.lastpoint), JM_py_from_point(self.dev.firstpoint)) self.dev.pathdict[dictkey_items].append(item) self.dev.lastpoint = self.dev.firstpoint self.dev.pathdict["closePath"] = False else: #log('setting self.dev.pathdict[ "closePath"] to true') self.dev.pathdict[ "closePath"] = True #log(f'end2: {self.dev.pathdict=}') self.dev.havemove = 0 except Exception: if g_exceptions_verbose: exception_info() raise def curveto(self, ctx, x1, y1, x2, y2, x3, y3): # trace_curveto(). #log(f'Walker(): {self.dev.pathdict=}') try: self.dev.linecount = 0 # reset # of consec. lines p1 = mupdf.fz_make_point(x1, y1) p2 = mupdf.fz_make_point(x2, y2) p3 = mupdf.fz_make_point(x3, y3) p1 = mupdf.fz_transform_point(p1, self.dev.ctm) p2 = mupdf.fz_transform_point(p2, self.dev.ctm) p3 = mupdf.fz_transform_point(p3, self.dev.ctm) self.dev.pathrect = mupdf.fz_include_point_in_rect(self.dev.pathrect, p1) self.dev.pathrect = mupdf.fz_include_point_in_rect(self.dev.pathrect, p2) self.dev.pathrect = mupdf.fz_include_point_in_rect(self.dev.pathrect, p3) list_ = ( "c", JM_py_from_point(self.dev.lastpoint), JM_py_from_point(p1), JM_py_from_point(p2), JM_py_from_point(p3), ) self.dev.lastpoint = p3 self.dev.pathdict[ dictkey_items].append( list_) except Exception: if g_exceptions_verbose: exception_info() raise def lineto(self, ctx, x, y): # trace_lineto(). #log(f'Walker(): {self.dev.pathdict=}') try: p1 = mupdf.fz_transform_point( mupdf.fz_make_point(x, y), self.dev.ctm) self.dev.pathrect = mupdf.fz_include_point_in_rect( self.dev.pathrect, p1) list_ = ( 'l', JM_py_from_point( self.dev.lastpoint), JM_py_from_point(p1), ) self.dev.lastpoint = p1 items = self.dev.pathdict[ dictkey_items] items.append( list_) self.dev.linecount += 1 # counts consecutive lines if self.dev.linecount == 4 and self.dev.path_type != trace_device_FILL_PATH: # shrink to "re" or "qu" item jm_checkquad(self.dev) except Exception: if g_exceptions_verbose: exception_info() raise def moveto(self, ctx, x, y): # trace_moveto(). if 0 and isinstance(self.dev.pathdict, dict): log(f'self.dev.pathdict:') for n, v in self.dev.pathdict.items(): log(f' {type(n)=} {len(n)=} {n!r} {n}: {v!r}: {v}') #log(f'Walker(): {type(self.dev.pathdict)=} {self.dev.pathdict=}') try: #log(f'{dev.ctm type(dev.ctm)=}') self.dev.lastpoint = mupdf.fz_transform_point( mupdf.fz_make_point(x, y), self.dev.ctm, ) if mupdf.fz_is_infinite_rect( self.dev.pathrect): self.dev.pathrect = mupdf.fz_make_rect( self.dev.lastpoint.x, self.dev.lastpoint.y, self.dev.lastpoint.x, self.dev.lastpoint.y, ) self.dev.firstpoint = self.dev.lastpoint self.dev.havemove = 1 self.dev.linecount = 0 # reset # of consec. lines except Exception: if g_exceptions_verbose: exception_info() raise def jm_lineart_path(dev, ctx, path): ''' Create the "items" list of the path dictionary * either create or empty the path dictionary * reset the end point of the path * reset count of consecutive lines * invoke fz_walk_path(), which create the single items * if no items detected, empty path dict again ''' #log(f'{getattr(dev, "pathdict", None)=}') try: dev.pathrect = mupdf.FzRect( mupdf.FzRect.Fixed_INFINITE) dev.linecount = 0 dev.lastpoint = mupdf.FzPoint( 0, 0) dev.pathdict = dict() dev.pathdict[ dictkey_items] = [] # First time we create a Walker instance is slow, e.g. 0.3s, then later # times run in around 0.01ms. If Walker is defined locally instead of # globally, each time takes 0.3s. # walker = Walker(dev) # Unlike fz_run_page(), fz_path_walker callbacks are not passed # a pointer to the struct, instead they get an arbitrary # void*. The underlying C++ Director callbacks use this void* to # identify the fz_path_walker instance so in turn we need to pass # arg=walker.m_internal. mupdf.fz_walk_path( mupdf.FzPath(mupdf.ll_fz_keep_path(path)), walker, walker.m_internal) # Check if any items were added ... if not dev.pathdict[ dictkey_items]: dev.pathdict = None except Exception: if g_exceptions_verbose: exception_info() raise def jm_lineart_stroke_path( dev, ctx, path, stroke, ctm, colorspace, color, alpha, color_params): #log(f'{dev.pathdict=} {dev.clips=}') try: assert isinstance( ctm, mupdf.fz_matrix) dev.pathfactor = math.sqrt(abs(ctm.a * ctm.d - ctm.b * ctm.c)) dev.ctm = mupdf.FzMatrix( ctm) # fz_concat(ctm, dev_ptm); dev.path_type = trace_device_STROKE_PATH jm_lineart_path( dev, ctx, path) if dev.pathdict is None: return dev.pathdict[ dictkey_type] = 's' dev.pathdict[ 'stroke_opacity'] = alpha dev.pathdict[ 'color'] = jm_lineart_color( colorspace, color) dev.pathdict[ dictkey_width] = dev.pathfactor * stroke.linewidth dev.pathdict[ 'lineCap'] = ( stroke.start_cap, stroke.dash_cap, stroke.end_cap, ) dev.pathdict[ 'lineJoin'] = float(stroke.linejoin) if 'closePath' not in dev.pathdict: #log('setting dev.pathdict["closePath"] to false') dev.pathdict['closePath'] = False # output the "dashes" string if stroke.dash_len: buff = mupdf.fz_new_buffer( 256) mupdf.fz_append_string( buff, "[ ") # left bracket for i in range( stroke.dash_len): # We use mupdf python's SWIG-generated floats_getitem() fn to # access float *stroke.dash_list[]. value = mupdf.floats_getitem( stroke.dash_list, i) # stroke.dash_list[i]. mupdf.fz_append_string( buff, f'{_format_g(dev.pathfactor * value)} ') mupdf.fz_append_string( buff, f'] {_format_g(dev.pathfactor * stroke.dash_phase)}') dev.pathdict[ 'dashes'] = buff else: dev.pathdict[ 'dashes'] = '[] 0' dev.pathdict[ dictkey_rect] = JM_py_from_rect(dev.pathrect) dev.pathdict['layer'] = dev.layer_name dev.pathdict[ 'seqno'] = dev.seqno if dev.clips: dev.pathdict[ 'level'] = dev.depth jm_append_merge(dev) dev.seqno += 1 except Exception: if g_exceptions_verbose: exception_info() raise def jm_lineart_clip_path(dev, ctx, path, even_odd, ctm, scissor): if not dev.clips: return dev.ctm = mupdf.FzMatrix(ctm) # fz_concat(ctm, trace_device_ptm); dev.path_type = trace_device_CLIP_PATH jm_lineart_path(dev, ctx, path) if dev.pathdict is None: return dev.pathdict[ dictkey_type] = 'clip' dev.pathdict[ 'even_odd'] = bool(even_odd) if 'closePath' not in dev.pathdict: #log(f'setting dev.pathdict["closePath"] to False') dev.pathdict['closePath'] = False dev.pathdict['scissor'] = JM_py_from_rect(compute_scissor(dev)) dev.pathdict['level'] = dev.depth dev.pathdict['layer'] = dev.layer_name jm_append_merge(dev) dev.depth += 1 def jm_lineart_clip_stroke_path(dev, ctx, path, stroke, ctm, scissor): if not dev.clips: return dev.ctm = mupdf.FzMatrix(ctm) # fz_concat(ctm, trace_device_ptm); dev.path_type = trace_device_CLIP_STROKE_PATH jm_lineart_path(dev, ctx, path) if dev.pathdict is None: return dev.pathdict['dictkey_type'] = 'clip' dev.pathdict['even_odd'] = None if 'closePath' not in dev.pathdict: #log(f'setting dev.pathdict["closePath"] to False') dev.pathdict['closePath'] = False dev.pathdict['scissor'] = JM_py_from_rect(compute_scissor(dev)) dev.pathdict['level'] = dev.depth dev.pathdict['layer'] = dev.layer_name jm_append_merge(dev) dev.depth += 1 def jm_lineart_clip_stroke_text(dev, ctx, text, stroke, ctm, scissor): if not dev.clips: return compute_scissor(dev) dev.depth += 1 def jm_lineart_clip_text(dev, ctx, text, ctm, scissor): if not dev.clips: return compute_scissor(dev) dev.depth += 1 def jm_lineart_clip_image_mask( dev, ctx, image, ctm, scissor): if not dev.clips: return compute_scissor(dev) dev.depth += 1 def jm_lineart_pop_clip(dev, ctx): if not dev.clips or not dev.scissors: return len_ = len(dev.scissors) if len_ < 1: return del dev.scissors[-1] dev.depth -= 1 def jm_lineart_begin_layer(dev, ctx, name): if name: dev.layer_name = name else: dev.layer_name = "" def jm_lineart_end_layer(dev, ctx): dev.layer_name = "" def jm_lineart_begin_group(dev, ctx, bbox, cs, isolated, knockout, blendmode, alpha): #log(f'{dev.pathdict=} {dev.clips=}') if not dev.clips: return dev.pathdict = { # Py_BuildValue("{s:s,s:N,s:N,s:N,s:s,s:f,s:i,s:N}", "type": "group", "rect": JM_py_from_rect(bbox), "isolated": bool(isolated), "knockout": bool(knockout), "blendmode": mupdf.fz_blendmode_name(blendmode), "opacity": alpha, "level": dev.depth, "layer": dev.layer_name } jm_append_merge(dev) dev.depth += 1 def jm_lineart_end_group(dev, ctx): #log(f'{dev.pathdict=} {dev.clips=}') if not dev.clips: return dev.depth -= 1 def jm_lineart_stroke_text(dev, ctx, text, stroke, ctm, colorspace, color, alpha, color_params): jm_trace_text(dev, text, 1, ctm, colorspace, color, alpha, dev.seqno) dev.seqno += 1 def jm_dev_linewidth( dev, ctx, path, stroke, matrix, colorspace, color, alpha, color_params): dev.linewidth = stroke.linewidth jm_increase_seqno( dev, ctx) def jm_increase_seqno( dev, ctx, *vargs): try: dev.seqno += 1 except Exception: if g_exceptions_verbose: exception_info() raise def planish_line(p1: point_like, p2: point_like) -> Matrix: """Compute matrix which maps line from p1 to p2 to the x-axis, such that it maintains its length and p1 * matrix = Point(0, 0). Args: p1, p2: point_like Returns: Matrix which maps p1 to Point(0, 0) and p2 to a point on the x axis at the same distance to Point(0,0). Will always combine a rotation and a transformation. """ p1 = Point(p1) p2 = Point(p2) return Matrix(util_hor_matrix(p1, p2)) class JM_image_reporter_Filter(mupdf.PdfFilterOptions2): def __init__(self): super().__init__() self.use_virtual_image_filter() def image_filter( self, ctx, ctm, name, image): assert isinstance(ctm, mupdf.fz_matrix) JM_image_filter(self, mupdf.FzMatrix(ctm), name, image) if mupdf_cppyy: # cppyy doesn't appear to treat returned None as nullptr, # resulting in obscure 'python exception' exception. return 0 class JM_new_bbox_device_Device(mupdf.FzDevice2): def __init__(self, result, layers): super().__init__() self.result = result self.layers = layers self.layer_name = "" self.use_virtual_fill_path() self.use_virtual_stroke_path() self.use_virtual_fill_text() self.use_virtual_stroke_text() self.use_virtual_ignore_text() self.use_virtual_fill_shade() self.use_virtual_fill_image() self.use_virtual_fill_image_mask() self.use_virtual_begin_layer() self.use_virtual_end_layer() begin_layer = jm_lineart_begin_layer end_layer = jm_lineart_end_layer fill_path = jm_bbox_fill_path stroke_path = jm_bbox_stroke_path fill_text = jm_bbox_fill_text stroke_text = jm_bbox_stroke_text ignore_text = jm_bbox_ignore_text fill_shade = jm_bbox_fill_shade fill_image = jm_bbox_fill_image fill_image_mask = jm_bbox_fill_image_mask class JM_new_output_fileptr_Output(mupdf.FzOutput2): def __init__(self, bio): super().__init__() self.bio = bio self.use_virtual_write() self.use_virtual_seek() self.use_virtual_tell() self.use_virtual_truncate() def seek( self, ctx, offset, whence): return self.bio.seek( offset, whence) def tell( self, ctx): ret = self.bio.tell() return ret def truncate( self, ctx): return self.bio.truncate() def write(self, ctx, data_raw, data_length): data = mupdf.raw_to_python_bytes(data_raw, data_length) return self.bio.write(data) def compute_scissor(dev): ''' Every scissor of a clip is a sub rectangle of the preceding clip scissor if the clip level is larger. ''' if dev.scissors is None: dev.scissors = list() num_scissors = len(dev.scissors) if num_scissors > 0: last_scissor = dev.scissors[num_scissors-1] scissor = JM_rect_from_py(last_scissor) scissor = mupdf.fz_intersect_rect(scissor, dev.pathrect) else: scissor = dev.pathrect dev.scissors.append(JM_py_from_rect(scissor)) return scissor class JM_new_lineart_device_Device(mupdf.FzDevice2): ''' LINEART device for Python method Page.get_cdrawings() ''' #log(f'JM_new_lineart_device_Device()') def __init__(self, out, clips, method): #log(f'JM_new_lineart_device_Device.__init__()') super().__init__() # fixme: this results in "Unexpected call of unimplemented virtual_fnptrs fn FzDevice2::drop_device().". #self.use_virtual_drop_device() self.use_virtual_fill_path() self.use_virtual_stroke_path() self.use_virtual_clip_path() self.use_virtual_clip_image_mask() self.use_virtual_clip_stroke_path() self.use_virtual_clip_stroke_text() self.use_virtual_clip_text() self.use_virtual_fill_text self.use_virtual_stroke_text self.use_virtual_ignore_text self.use_virtual_fill_shade() self.use_virtual_fill_image() self.use_virtual_fill_image_mask() self.use_virtual_pop_clip() self.use_virtual_begin_group() self.use_virtual_end_group() self.use_virtual_begin_layer() self.use_virtual_end_layer() self.out = out self.seqno = 0 self.depth = 0 self.clips = clips self.method = method self.scissors = None self.layer_name = "" # optional content name self.pathrect = None self.linewidth = 0 self.ptm = mupdf.FzMatrix() self.ctm = mupdf.FzMatrix() self.rot = mupdf.FzMatrix() self.lastpoint = mupdf.FzPoint() self.firstpoint = mupdf.FzPoint() self.havemove = 0 self.pathrect = mupdf.FzRect() self.pathfactor = 0 self.linecount = 0 self.path_type = 0 #drop_device = jm_lineart_drop_device fill_path = jm_lineart_fill_path stroke_path = jm_lineart_stroke_path clip_image_mask = jm_lineart_clip_image_mask clip_path = jm_lineart_clip_path clip_stroke_path = jm_lineart_clip_stroke_path clip_text = jm_lineart_clip_text clip_stroke_text = jm_lineart_clip_stroke_text fill_text = jm_increase_seqno stroke_text = jm_increase_seqno ignore_text = jm_increase_seqno fill_shade = jm_increase_seqno fill_image = jm_increase_seqno fill_image_mask = jm_increase_seqno pop_clip = jm_lineart_pop_clip begin_group = jm_lineart_begin_group end_group = jm_lineart_end_group begin_layer = jm_lineart_begin_layer end_layer = jm_lineart_end_layer class JM_new_texttrace_device(mupdf.FzDevice2): ''' Trace TEXT device for Python method Page.get_texttrace() ''' def __init__(self, out): super().__init__() self.use_virtual_fill_path() self.use_virtual_stroke_path() self.use_virtual_fill_text() self.use_virtual_stroke_text() self.use_virtual_ignore_text() self.use_virtual_fill_shade() self.use_virtual_fill_image() self.use_virtual_fill_image_mask() self.use_virtual_begin_layer() self.use_virtual_end_layer() self.out = out self.seqno = 0 self.depth = 0 self.clips = 0 self.method = None self.seqno = 0 self.pathdict = dict() self.scissors = list() self.linewidth = 0 self.ptm = mupdf.FzMatrix() self.ctm = mupdf.FzMatrix() self.rot = mupdf.FzMatrix() self.lastpoint = mupdf.FzPoint() self.pathrect = mupdf.FzRect() self.pathfactor = 0 self.linecount = 0 self.path_type = 0 self.layer_name = "" fill_path = jm_increase_seqno stroke_path = jm_dev_linewidth fill_text = jm_lineart_fill_text stroke_text = jm_lineart_stroke_text ignore_text = jm_lineart_ignore_text fill_shade = jm_increase_seqno fill_image = jm_increase_seqno fill_image_mask = jm_increase_seqno begin_layer = jm_lineart_begin_layer end_layer = jm_lineart_end_layer def ConversionHeader(i: str, filename: OptStr ="unknown"): t = i.lower() import textwrap html = textwrap.dedent(""" """) xml = textwrap.dedent(f""" """) xhtml = textwrap.dedent(""" """) text = "" json = f'{{"document": "{filename}", "pages": [\n' if t == "html": r = html elif t == "json": r = json elif t == "xml": r = xml elif t == "xhtml": r = xhtml else: r = text return r def ConversionTrailer(i: str): t = i.lower() text = "" json = "]\n}" html = "\n\n" xml = "\n" xhtml = html if t == "html": r = html elif t == "json": r = json elif t == "xml": r = xml elif t == "xhtml": r = xhtml else: r = text return r def annot_preprocess(page: "Page") -> int: """Prepare for annotation insertion on the page. Returns: Old page rotation value. Temporarily sets rotation to 0 when required. """ CheckParent(page) if not page.parent.is_pdf: raise ValueError("is no PDF") old_rotation = page.rotation if old_rotation != 0: page.set_rotation(0) return old_rotation def annot_postprocess(page: "Page", annot: "Annot") -> None: """Clean up after annotation insertion. Set ownership flag and store annotation in page annotation dictionary. """ #annot.parent = weakref.proxy(page) assert isinstance( page, Page) assert isinstance( annot, Annot) annot.parent = page page._annot_refs[id(annot)] = annot annot.thisown = True def canon(c): assert isinstance(c, int) # TODO: proper unicode case folding # TODO: character equivalence (a matches ä, etc) if c == 0xA0 or c == 0x2028 or c == 0x2029: return ord(' ') if c == ord('\r') or c == ord('\n') or c == ord('\t'): return ord(' ') if c >= ord('A') and c <= ord('Z'): return c - ord('A') + ord('a') return c def chartocanon(s): assert isinstance(s, str) n, c = mupdf.fz_chartorune(s) c = canon(c) return n, c def dest_is_valid(o, page_count, page_object_nums, names_list): p = mupdf.pdf_dict_get( o, PDF_NAME('A')) if ( mupdf.pdf_name_eq( mupdf.pdf_dict_get( p, PDF_NAME('S')), PDF_NAME('GoTo') ) and not string_in_names_list( mupdf.pdf_dict_get( p, PDF_NAME('D')), names_list ) ): return 0 p = mupdf.pdf_dict_get( o, PDF_NAME('Dest')) if not p.m_internal: pass elif mupdf.pdf_is_string( p): return string_in_names_list( p, names_list) elif not dest_is_valid_page( mupdf.pdf_array_get( p, 0), page_object_nums, page_count, ): return 0 return 1 def dest_is_valid_page(obj, page_object_nums, pagecount): num = mupdf.pdf_to_num(obj) if num == 0: return 0 for i in range(pagecount): if page_object_nums[i] == num: return 1 return 0 def find_string(s, needle): assert isinstance(s, str) for i in range(len(s)): end = match_string(s[i:], needle) if end is not None: end += i return i, end return None, None def get_pdf_now() -> str: ''' "Now" timestamp in PDF Format ''' import time a = str(abs(time.altzone // 3600)).rjust(2, "0") b = str((abs(time.altzone // 60) % 60)).rjust(2, "0") tz = f"{a}'{b}'" tstamp = time.strftime("D:%Y%m%d%H%M%S", time.localtime()) if time.altzone > 0: tstamp += "-" + tz elif time.altzone < 0: tstamp += "+" + tz else: pass return tstamp class ElementPosition(object): """Convert a dictionary with element position information to an object.""" def __init__(self): pass def make_story_elpos(): return ElementPosition() def get_highlight_selection(page, start: point_like =None, stop: point_like =None, clip: rect_like =None) -> list: """Return rectangles of text lines between two points. Notes: The default of 'start' is top-left of 'clip'. The default of 'stop' is bottom-reight of 'clip'. Args: start: start point_like stop: end point_like, must be 'below' start clip: consider this rect_like only, default is page rectangle Returns: List of line bbox intersections with the area established by the parameters. """ # validate and normalize arguments if clip is None: clip = page.rect clip = Rect(clip) if start is None: start = clip.tl if stop is None: stop = clip.br clip.y0 = start.y clip.y1 = stop.y if clip.is_empty or clip.is_infinite: return [] # extract text of page, clip only, no images, expand ligatures blocks = page.get_text( "dict", flags=0, clip=clip, )["blocks"] lines = [] # will return this list of rectangles for b in blocks: bbox = Rect(b["bbox"]) if bbox.is_infinite or bbox.is_empty: continue for line in b["lines"]: bbox = Rect(line["bbox"]) if bbox.is_infinite or bbox.is_empty: continue lines.append(bbox) if lines == []: # did not select anything return lines lines.sort(key=lambda bbox: bbox.y1) # sort by vertical positions # cut off prefix from first line if start point is close to its top bboxf = lines.pop(0) if bboxf.y0 - start.y <= 0.1 * bboxf.height: # close enough? r = Rect(start.x, bboxf.y0, bboxf.br) # intersection rectangle if not (r.is_empty or r.is_infinite): lines.insert(0, r) # insert again if not empty else: lines.insert(0, bboxf) # insert again if lines == []: # the list might have been emptied return lines # cut off suffix from last line if stop point is close to its bottom bboxl = lines.pop() if stop.y - bboxl.y1 <= 0.1 * bboxl.height: # close enough? r = Rect(bboxl.tl, stop.x, bboxl.y1) # intersection rectangle if not (r.is_empty or r.is_infinite): lines.append(r) # append if not empty else: lines.append(bboxl) # append again return lines def glyph_name_to_unicode(name: str) -> int: """Convenience function accessing unicodedata.""" import unicodedata try: unc = ord(unicodedata.lookup(name)) except Exception: unc = 65533 return unc def hdist(dir, a, b): dx = b.x - a.x dy = b.y - a.y return mupdf.fz_abs(dx * dir.x + dy * dir.y) def make_table(rect: rect_like =(0, 0, 1, 1), cols: int =1, rows: int =1) -> list: """Return a list of (rows x cols) equal sized rectangles. Notes: A utility to fill a given area with table cells of equal size. Args: rect: rect_like to use as the table area rows: number of rows cols: number of columns Returns: A list with items, where each item is a list of PyMuPDF Rect objects of equal sizes. """ rect = Rect(rect) # ensure this is a Rect if rect.is_empty or rect.is_infinite: raise ValueError("rect must be finite and not empty") tl = rect.tl height = rect.height / rows # height of one table cell width = rect.width / cols # width of one table cell delta_h = (width, 0, width, 0) # diff to next right rect delta_v = (0, height, 0, height) # diff to next lower rect r = Rect(tl, tl.x + width, tl.y + height) # first rectangle # make the first row row = [r] for i in range(1, cols): r += delta_h # build next rect to the right row.append(r) # make result, starts with first row rects = [row] for i in range(1, rows): row = rects[i - 1] # take previously appended row nrow = [] # the new row to append for r in row: # for each previous cell add its downward copy nrow.append(r + delta_v) rects.append(nrow) # append new row to result return rects def util_ensure_widget_calc(annot): ''' Ensure that widgets with /AA/C JavaScript are in array AcroForm/CO ''' annot_obj = mupdf.pdf_annot_obj(annot.this) pdf = mupdf.pdf_get_bound_document(annot_obj) PDFNAME_CO = mupdf.pdf_new_name("CO") # = PDF_NAME(CO) acro = mupdf.pdf_dict_getl( # get AcroForm dict mupdf.pdf_trailer(pdf), PDF_NAME('Root'), PDF_NAME('AcroForm'), ) CO = mupdf.pdf_dict_get(acro, PDFNAME_CO) # = AcroForm/CO if not mupdf.pdf_is_array(CO): CO = mupdf.pdf_dict_put_array(acro, PDFNAME_CO, 2) n = mupdf.pdf_array_len(CO) found = 0 xref = mupdf.pdf_to_num(annot_obj) for i in range(n): nxref = mupdf.pdf_to_num(mupdf.pdf_array_get(CO, i)) if xref == nxref: found = 1 break if not found: mupdf.pdf_array_push(CO, mupdf.pdf_new_indirect(pdf, xref, 0)) def util_make_rect( *args, p0=None, p1=None, x0=None, y0=None, x1=None, y1=None): ''' Helper for initialising rectangle classes. 2022-09-02: This is quite different from PyMuPDF's util_make_rect(), which uses `goto` in ways that don't easily translate to Python. Returns (x0, y0, x1, y1) derived from , then override with p0, p1, x0, y0, x1, y1 if they are not None. Accepts following forms for : () returns all zeros. (top-left, bottom-right) (top-left, x1, y1) (x0, y0, bottom-right) (x0, y0, x1, y1) (rect) Where top-left and bottom-right are (x, y) or something with .x, .y members; rect is something with .x0, .y0, .x1, and .y1 members. 2023-11-18: we now override with p0, p1, x0, y0, x1, y1 if not None. ''' def get_xy( arg): if isinstance( arg, (list, tuple)) and len( arg) == 2: return arg[0], arg[1] if isinstance( arg, (Point, mupdf.FzPoint, mupdf.fz_point)): return arg.x, arg.y return None, None def make_tuple( a): if isinstance( a, tuple): return a if isinstance( a, Point): return a.x, a.y elif isinstance( a, (Rect, IRect, mupdf.FzRect, mupdf.fz_rect)): return a.x0, a.y0, a.x1, a.y1 if not isinstance( a, (list, tuple)): a = a, return a def handle_args(): if len(args) == 0: return 0, 0, 0, 0 elif len(args) == 1: arg = args[0] if isinstance( arg, (list, tuple)) and len( arg) == 2: p1, p2 = arg ret = *p1, *p2 assert len(ret) == 4 return ret if isinstance( arg, (list, tuple)) and len( arg) == 3: a, b, c = arg a = make_tuple(a) b = make_tuple(b) c = make_tuple(c) ret = *a, *b, *c assert len(ret) == 4 return ret ret = make_tuple( arg) assert len(ret) == 4, f'{arg=} {ret=}' return ret elif len(args) == 2: ret = get_xy( args[0]) + get_xy( args[1]) assert len(ret) == 4 return ret elif len(args) == 3: x0, y0 = get_xy( args[0]) if (x0, y0) != (None, None): return x0, y0, args[1], args[2] x1, y1 = get_xy( args[2]) if (x1, y1) != (None, None): return args[0], args[1], x1, y1 elif len(args) == 4: return args[0], args[1], args[2], args[3] raise Exception( f'Unrecognised args: {args}') ret_x0, ret_y0, ret_x1, ret_y1 = handle_args() if p0 is not None: ret_x0, ret_y0 = get_xy(p0) if p1 is not None: ret_x1, ret_y1 = get_xy(p1) if x0 is not None: ret_x0 = x0 if y0 is not None: ret_y0 = y0 if x1 is not None: ret_x1 = x1 if y1 is not None: ret_y1 = y1 return ret_x0, ret_y0, ret_x1, ret_y1 def util_make_irect( *args, p0=None, p1=None, x0=None, y0=None, x1=None, y1=None): a, b, c, d = util_make_rect( *args, p0=p0, p1=p1, x0=x0, y0=y0, x1=x1, y1=y1) def convert(x, ceil): if ceil: return int(math.ceil(x)) else: return int(math.floor(x)) a = convert(a, False) b = convert(b, False) c = convert(c, True) d = convert(d, True) return a, b, c, d def util_round_rect( rect): return JM_py_from_irect(mupdf.fz_round_rect(JM_rect_from_py(rect))) def util_transform_rect( rect, matrix): if g_use_extra: return extra.util_transform_rect( rect, matrix) return JM_py_from_rect(mupdf.fz_transform_rect(JM_rect_from_py(rect), JM_matrix_from_py(matrix))) def util_intersect_rect( r1, r2): return JM_py_from_rect( mupdf.fz_intersect_rect( JM_rect_from_py(r1), JM_rect_from_py(r2), ) ) def util_is_point_in_rect( p, r): return mupdf.fz_is_point_inside_rect( JM_point_from_py(p), JM_rect_from_py(r), ) def util_include_point_in_rect( r, p): return JM_py_from_rect( mupdf.fz_include_point_in_rect( JM_rect_from_py(r), JM_point_from_py(p), ) ) def util_point_in_quad( P, Q): p = JM_point_from_py(P) q = JM_quad_from_py(Q) return mupdf.fz_is_point_inside_quad(p, q) def util_transform_point( point, matrix): return JM_py_from_point( mupdf.fz_transform_point( JM_point_from_py(point), JM_matrix_from_py(matrix), ) ) def util_union_rect( r1, r2): return JM_py_from_rect( mupdf.fz_union_rect( JM_rect_from_py(r1), JM_rect_from_py(r2), ) ) def util_concat_matrix( m1, m2): return JM_py_from_matrix( mupdf.fz_concat( JM_matrix_from_py(m1), JM_matrix_from_py(m2), ) ) def util_invert_matrix(matrix): if 0: # Use MuPDF's fz_invert_matrix(). if isinstance( matrix, (tuple, list)): matrix = mupdf.FzMatrix( *matrix) elif isinstance( matrix, mupdf.fz_matrix): matrix = mupdf.FzMatrix( matrix) elif isinstance( matrix, Matrix): matrix = mupdf.FzMatrix( matrix.a, matrix.b, matrix.c, matrix.d, matrix.e, matrix.f) assert isinstance( matrix, mupdf.FzMatrix), f'{type(matrix)=}: {matrix}' ret = mupdf.fz_invert_matrix( matrix) if ret == matrix and (0 or abs( matrix.a - 1) >= sys.float_info.epsilon or abs( matrix.b - 0) >= sys.float_info.epsilon or abs( matrix.c - 0) >= sys.float_info.epsilon or abs( matrix.d - 1) >= sys.float_info.epsilon ): # Inversion not possible. return 1, () return 0, (ret.a, ret.b, ret.c, ret.d, ret.e, ret.f) # Do inversion in python. src = JM_matrix_from_py(matrix) a = src.a det = a * src.d - src.b * src.c if det < -sys.float_info.epsilon or det > sys.float_info.epsilon: dst = mupdf.FzMatrix() rdet = 1 / det dst.a = src.d * rdet dst.b = -src.b * rdet dst.c = -src.c * rdet dst.d = a * rdet a = -src.e * dst.a - src.f * dst.c dst.f = -src.e * dst.b - src.f * dst.d dst.e = a return 0, (dst.a, dst.b, dst.c, dst.d, dst.e, dst.f) return 1, () def util_measure_string( text, fontname, fontsize, encoding): font = mupdf.fz_new_base14_font(fontname) w = 0 pos = 0 while pos < len(text): t, c = mupdf.fz_chartorune(text[pos:]) pos += t if encoding == mupdf.PDF_SIMPLE_ENCODING_GREEK: c = mupdf.fz_iso8859_7_from_unicode(c) elif encoding == mupdf.PDF_SIMPLE_ENCODING_CYRILLIC: c = mupdf.fz_windows_1251_from_unicode(c) else: c = mupdf.fz_windows_1252_from_unicode(c) if c < 0: c = 0xB7 g = mupdf.fz_encode_character(font, c) dw = mupdf.fz_advance_glyph(font, g, 0) w += dw ret = w * fontsize return ret def util_sine_between(C, P, Q): # for points C, P, Q compute the sine between lines CP and QP c = JM_point_from_py(C) p = JM_point_from_py(P) q = JM_point_from_py(Q) s = mupdf.fz_normalize_vector(mupdf.fz_make_point(q.x - p.x, q.y - p.y)) m1 = mupdf.fz_make_matrix(1, 0, 0, 1, -p.x, -p.y) m2 = mupdf.fz_make_matrix(s.x, -s.y, s.y, s.x, 0, 0) m1 = mupdf.fz_concat(m1, m2) c = mupdf.fz_transform_point(c, m1) c = mupdf.fz_normalize_vector(c) return c.y def util_hor_matrix(C, P): ''' Return the matrix that maps two points C, P to the x-axis such that C -> (0,0) and the image of P have the same distance. ''' c = JM_point_from_py(C) p = JM_point_from_py(P) # compute (cosine, sine) of vector P-C with double precision: s = mupdf.fz_normalize_vector(mupdf.fz_make_point(p.x - c.x, p.y - c.y)) m1 = mupdf.fz_make_matrix(1, 0, 0, 1, -c.x, -c.y) m2 = mupdf.fz_make_matrix(s.x, -s.y, s.y, s.x, 0, 0) return JM_py_from_matrix(mupdf.fz_concat(m1, m2)) def match_string(h0, n0): h = 0 n = 0 e = h delta_h, hc = chartocanon(h0[h:]) h += delta_h delta_n, nc = chartocanon(n0[n:]) n += delta_n while hc == nc: e = h if hc == ord(' '): while 1: delta_h, hc = chartocanon(h0[h:]) h += delta_h if hc != ord(' '): break else: delta_h, hc = chartocanon(h0[h:]) h += delta_h if nc == ord(' '): while 1: delta_n, nc = chartocanon(n0[n:]) n += delta_n if nc != ord(' '): break else: delta_n, nc = chartocanon(n0[n:]) n += delta_n return None if nc != 0 else e def on_highlight_char(hits, line, ch): assert hits assert isinstance(line, mupdf.FzStextLine) assert isinstance(ch, mupdf.FzStextChar) vfuzz = ch.m_internal.size * hits.vfuzz hfuzz = ch.m_internal.size * hits.hfuzz ch_quad = JM_char_quad(line, ch) if hits.len > 0: # fixme: end = hits.quads[-1] quad = hits.quads[hits.len - 1] end = JM_quad_from_py(quad) if ( 1 and hdist(line.m_internal.dir, end.lr, ch_quad.ll) < hfuzz and vdist(line.m_internal.dir, end.lr, ch_quad.ll) < vfuzz and hdist(line.m_internal.dir, end.ur, ch_quad.ul) < hfuzz and vdist(line.m_internal.dir, end.ur, ch_quad.ul) < vfuzz ): end.ur = ch_quad.ur end.lr = ch_quad.lr assert hits.quads[-1] == end return hits.quads.append(ch_quad) hits.len += 1 def page_merge(doc_des, doc_src, page_from, page_to, rotate, links, copy_annots, graft_map): ''' Deep-copies a source page to the target. Modified version of function of pdfmerge.c: we also copy annotations, but we skip some subtypes. In addition we rotate output. ''' if g_use_extra: #log( 'Calling C++ extra.page_merge()') return extra.page_merge( doc_des, doc_src, page_from, page_to, rotate, links, copy_annots, graft_map) # list of object types (per page) we want to copy known_page_objs = [ PDF_NAME('Contents'), PDF_NAME('Resources'), PDF_NAME('MediaBox'), PDF_NAME('CropBox'), PDF_NAME('BleedBox'), PDF_NAME('TrimBox'), PDF_NAME('ArtBox'), PDF_NAME('Rotate'), PDF_NAME('UserUnit'), ] page_ref = mupdf.pdf_lookup_page_obj(doc_src, page_from) # make new page dict in dest doc page_dict = mupdf.pdf_new_dict(doc_des, 4) mupdf.pdf_dict_put(page_dict, PDF_NAME('Type'), PDF_NAME('Page')) # copy objects of source page into it for i in range( len(known_page_objs)): obj = mupdf.pdf_dict_get_inheritable( page_ref, known_page_objs[i]) if obj.m_internal: #log(f'{type(graft_map) type(graft_map.this)=}') mupdf.pdf_dict_put( page_dict, known_page_objs[i], mupdf.pdf_graft_mapped_object(graft_map.this, obj)) # Copy annotations, but skip Link, Popup, IRT, Widget types # If selected, remove dict keys P (parent) and Popup if copy_annots: old_annots = mupdf.pdf_dict_get( page_ref, PDF_NAME('Annots')) n = mupdf.pdf_array_len( old_annots) if n > 0: new_annots = mupdf.pdf_dict_put_array( page_dict, PDF_NAME('Annots'), n) for i in range(n): o = mupdf.pdf_array_get( old_annots, i) if not o.m_internal or not mupdf.pdf_is_dict(o): continue # skip non-dict items if mupdf.pdf_dict_gets( o, "IRT").m_internal: continue subtype = mupdf.pdf_dict_get( o, PDF_NAME('Subtype')) if mupdf.pdf_name_eq( subtype, PDF_NAME('Link')): continue if mupdf.pdf_name_eq( subtype, PDF_NAME('Popup')): continue if mupdf.pdf_name_eq(subtype, PDF_NAME('Widget')): continue mupdf.pdf_dict_del( o, PDF_NAME('Popup')) mupdf.pdf_dict_del( o, PDF_NAME('P')) copy_o = mupdf.pdf_graft_mapped_object( graft_map.this, o) annot = mupdf.pdf_new_indirect( doc_des, mupdf.pdf_to_num( copy_o), 0) mupdf.pdf_array_push( new_annots, annot) # rotate the page if rotate != -1: mupdf.pdf_dict_put_int( page_dict, PDF_NAME('Rotate'), rotate) # Now add the page dictionary to dest PDF ref = mupdf.pdf_add_object( doc_des, page_dict) # Insert new page at specified location mupdf.pdf_insert_page( doc_des, page_to, ref) def paper_rect(s: str) -> Rect: """Return a Rect for the paper size indicated in string 's'. Must conform to the argument of method 'PaperSize', which will be invoked. """ width, height = paper_size(s) return Rect(0.0, 0.0, width, height) def paper_size(s: str) -> tuple: """Return a tuple (width, height) for a given paper format string. Notes: 'A4-L' will return (842, 595), the values for A4 landscape. Suffix '-P' and no suffix return the portrait tuple. """ size = s.lower() f = "p" if size.endswith("-l"): f = "l" size = size[:-2] if size.endswith("-p"): size = size[:-2] rc = paper_sizes().get(size, (-1, -1)) if f == "p": return rc return (rc[1], rc[0]) def paper_sizes(): """Known paper formats @ 72 dpi as a dictionary. Key is the format string like "a4" for ISO-A4. Value is the tuple (width, height). Information taken from the following web sites: www.din-formate.de www.din-formate.info/amerikanische-formate.html www.directtools.de/wissen/normen/iso.htm """ return { "a0": (2384, 3370), "a1": (1684, 2384), "a10": (74, 105), "a2": (1191, 1684), "a3": (842, 1191), "a4": (595, 842), "a5": (420, 595), "a6": (298, 420), "a7": (210, 298), "a8": (147, 210), "a9": (105, 147), "b0": (2835, 4008), "b1": (2004, 2835), "b10": (88, 125), "b2": (1417, 2004), "b3": (1001, 1417), "b4": (709, 1001), "b5": (499, 709), "b6": (354, 499), "b7": (249, 354), "b8": (176, 249), "b9": (125, 176), "c0": (2599, 3677), "c1": (1837, 2599), "c10": (79, 113), "c2": (1298, 1837), "c3": (918, 1298), "c4": (649, 918), "c5": (459, 649), "c6": (323, 459), "c7": (230, 323), "c8": (162, 230), "c9": (113, 162), "card-4x6": (288, 432), "card-5x7": (360, 504), "commercial": (297, 684), "executive": (522, 756), "invoice": (396, 612), "ledger": (792, 1224), "legal": (612, 1008), "legal-13": (612, 936), "letter": (612, 792), "monarch": (279, 540), "tabloid-extra": (864, 1296), } def pdf_lookup_page_loc(doc, needle): return mupdf.pdf_lookup_page_loc(doc, needle) def pdfobj_string(o, prefix=''): ''' Returns description of mupdf.PdfObj (wrapper for pdf_obj) . ''' assert 0, 'use mupdf.pdf_debug_obj() ?' ret = '' if mupdf.pdf_is_array(o): l = mupdf.pdf_array_len(o) ret += f'array {l}\n' for i in range(l): oo = mupdf.pdf_array_get(o, i) ret += pdfobj_string(oo, prefix + ' ') ret += '\n' elif mupdf.pdf_is_bool(o): ret += f'bool: {o.array_get_bool()}\n' elif mupdf.pdf_is_dict(o): l = mupdf.pdf_dict_len(o) ret += f'dict {l}\n' for i in range(l): key = mupdf.pdf_dict_get_key(o, i) value = mupdf.pdf_dict_get( o, key) ret += f'{prefix} {key}: ' ret += pdfobj_string( value, prefix + ' ') ret += '\n' elif mupdf.pdf_is_embedded_file(o): ret += f'embedded_file: {o.embedded_file_name()}\n' elif mupdf.pdf_is_indirect(o): ret += f'indirect: ...\n' elif mupdf.pdf_is_int(o): ret += f'int: {mupdf.pdf_to_int(o)}\n' elif mupdf.pdf_is_jpx_image(o): ret += f'jpx_image:\n' elif mupdf.pdf_is_name(o): ret += f'name: {mupdf.pdf_to_name(o)}\n' elif o.pdf_is_null: ret += f'null\n' #elif o.pdf_is_number: # ret += f'number\n' elif o.pdf_is_real: ret += f'real: {o.pdf_to_real()}\n' elif mupdf.pdf_is_stream(o): ret += f'stream\n' elif mupdf.pdf_is_string(o): ret += f'string: {mupdf.pdf_to_string(o)}\n' else: ret += '<>\n' return ret def repair_mono_font(page: "Page", font: "Font") -> None: """Repair character spacing for mono fonts. Notes: Some mono-spaced fonts are displayed with a too large character distance, e.g. "a b c" instead of "abc". This utility adds an entry "/W[0 65535 w]" to the descendent font(s) of font. The float w is taken to be the width of 0x20 (space). This should enforce viewers to use 'w' as the character width. Args: page: pymupdf.Page object. font: pymupdf.Font object. """ if not font.flags["mono"]: # font not flagged as monospaced return None doc = page.parent # the document fontlist = page.get_fonts() # list of fonts on page xrefs = [ # list of objects referring to font f[0] for f in fontlist if (f[3] == font.name and f[4].startswith("F") and f[5].startswith("Identity")) ] if xrefs == []: # our font does not occur return xrefs = set(xrefs) # drop any double counts width = int(round((font.glyph_advance(32) * 1000))) for xref in xrefs: if not TOOLS.set_font_width(doc, xref, width): log(f"Cannot set width for '{font.name}' in xref {xref:d}") def sRGB_to_pdf(srgb: int) -> tuple: """Convert sRGB color code to a PDF color triple. There is **no error checking** for performance reasons! Args: srgb: (int) RRGGBB (red, green, blue), each color in range(255). Returns: Tuple (red, green, blue) each item in interval 0 <= item <= 1. """ t = sRGB_to_rgb(srgb) return t[0] / 255.0, t[1] / 255.0, t[2] / 255.0 def sRGB_to_rgb(srgb: int) -> tuple: """Convert sRGB color code to an RGB color triple. There is **no error checking** for performance reasons! Args: srgb: (int) SSRRGGBB (red, green, blue), each color in range(255). With MuPDF < 1.26, `s` is always 0. Returns: Tuple (red, green, blue) each item in interval 0 <= item <= 255. """ srgb &= 0xffffff r = srgb >> 16 g = (srgb - (r << 16)) >> 8 b = srgb - (r << 16) - (g << 8) return (r, g, b) def string_in_names_list(p, names_list): n = mupdf.pdf_array_len( names_list) if names_list else 0 str_ = mupdf.pdf_to_text_string( p) for i in range(0, n, 2): if mupdf.pdf_to_text_string( mupdf.pdf_array_get( names_list, i)) == str_: return 1 return 0 def strip_outline(doc, outlines, page_count, page_object_nums, names_list): ''' Returns (count, first, prev). ''' first = None count = 0 current = outlines prev = None while current.m_internal: # Strip any children to start with. This takes care of # First / Last / Count for us. nc = strip_outlines(doc, current, page_count, page_object_nums, names_list) if not dest_is_valid(current, page_count, page_object_nums, names_list): if nc == 0: # Outline with invalid dest and no children. Drop it by # pulling the next one in here. next = mupdf.pdf_dict_get(current, PDF_NAME('Next')) if not next.m_internal: # There is no next one to pull in if prev.m_internal: mupdf.pdf_dict_del(prev, PDF_NAME('Next')) elif prev.m_internal: mupdf.pdf_dict_put(prev, PDF_NAME('Next'), next) mupdf.pdf_dict_put(next, PDF_NAME('Prev'), prev) else: mupdf.pdf_dict_del(next, PDF_NAME('Prev')) current = next else: # Outline with invalid dest, but children. Just drop the dest. mupdf.pdf_dict_del(current, PDF_NAME('Dest')) mupdf.pdf_dict_del(current, PDF_NAME('A')) current = mupdf.pdf_dict_get(current, PDF_NAME('Next')) else: # Keep this one if not first or not first.m_internal: first = current prev = current current = mupdf.pdf_dict_get(current, PDF_NAME('Next')) count += 1 return count, first, prev def strip_outlines(doc, outlines, page_count, page_object_nums, names_list): if not outlines.m_internal: return 0 first = mupdf.pdf_dict_get(outlines, PDF_NAME('First')) if not first.m_internal: nc = 0 else: nc, first, last = strip_outline(doc, first, page_count, page_object_nums, names_list) if nc == 0: mupdf.pdf_dict_del(outlines, PDF_NAME('First')) mupdf.pdf_dict_del(outlines, PDF_NAME('Last')) mupdf.pdf_dict_del(outlines, PDF_NAME('Count')) else: old_count = mupdf.pdf_to_int(mupdf.pdf_dict_get(outlines, PDF_NAME('Count'))) mupdf.pdf_dict_put(outlines, PDF_NAME('First'), first) mupdf.pdf_dict_put(outlines, PDF_NAME('Last'), last) mupdf.pdf_dict_put(outlines, PDF_NAME('Count'), mupdf.pdf_new_int(nc if old_count > 0 else -nc)) return nc trace_device_FILL_PATH = 1 trace_device_STROKE_PATH = 2 trace_device_CLIP_PATH = 3 trace_device_CLIP_STROKE_PATH = 4 def unicode_to_glyph_name(ch: int) -> str: """ Convenience function accessing unicodedata. """ import unicodedata try: name = unicodedata.name(chr(ch)) except ValueError: name = ".notdef" return name def vdist(dir, a, b): dx = b.x - a.x dy = b.y - a.y return mupdf.fz_abs(dx * dir.y + dy * dir.x) def apply_pages( path, pagefn, *, pagefn_args=(), pagefn_kwargs=dict(), initfn=None, initfn_args=(), initfn_kwargs=dict(), pages=None, method='single', concurrency=None, _stats=False, ): ''' Returns list of results from `pagefn()`, optionally using concurrency for speed. Args: path: Path of document. pagefn: Function to call for each page; is passed (page, *pagefn_args, **pagefn_kwargs). Return value is added to list that we return. If `method` is not 'single', must be a top-level function - nested functions don't work with concurrency. pagefn_args pagefn_kwargs: Additional args to pass to `pagefn`. Must be picklable. initfn: If true, called once in each worker process; is passed (*initfn_args, **initfn_kwargs). initfn_args initfn_kwargs: Args to pass to initfn. Must be picklable. pages: List of page numbers to process, or None to include all pages. method: 'single' Do not use concurrency. 'mp' Operate concurrently using Python's `multiprocessing` module. 'fork' Operate concurrently using custom implementation with `os.fork()`. Does not work on Windows. concurrency: Number of worker processes to use when operating concurrently. If None, we use the number of available CPUs. _stats: Internal, may change or be removed. If true, we output simple timing diagnostics. Note: We require a file path rather than a Document, because Document instances do not work properly after a fork - internal file descriptor offsets are shared between the parent and child processes. ''' if _stats: t0 = time.time() if method == 'single': if initfn: initfn(*initfn_args, **initfn_kwargs) ret = list() document = Document(path) if pages is None: pages = range(len(document)) for pno in pages: page = document[pno] r = pagefn(page, *pagefn_args, **initfn_kwargs) ret.append(r) else: # Use concurrency. # from . import _apply_pages if pages is None: if _stats: t = time.time() with Document(path) as document: num_pages = len(document) pages = list(range(num_pages)) if _stats: t = time.time() - t log(f'{t:.2f}s: count pages.') if _stats: t = time.time() if method == 'mp': ret = _apply_pages._multiprocessing( path, pages, pagefn, pagefn_args, pagefn_kwargs, initfn, initfn_args, initfn_kwargs, concurrency, _stats, ) elif method == 'fork': ret = _apply_pages._fork( path, pages, pagefn, pagefn_args, pagefn_kwargs, initfn, initfn_args, initfn_kwargs, concurrency, _stats, ) else: assert 0, f'Unrecognised {method=}.' if _stats: t = time.time() - t log(f'{t:.2f}s: work.') if _stats: t = time.time() - t0 log(f'{t:.2f}s: total.') return ret def get_text( path, *, pages=None, method='single', concurrency=None, option='text', clip=None, flags=None, textpage=None, sort=False, delimiters=None, _stats=False, ): ''' Returns list of results from `Page.get_text()`, optionally using concurrency for speed. Args: path: Path of document. pages: List of page numbers to process, or None to include all pages. method: 'single' Do not use concurrency. 'mp' Operate concurrently using Python's `multiprocessing` module. 'fork' Operate concurrently using custom implementation with `os.fork`. Does not work on Windows. concurrency: Number of worker processes to use when operating concurrently. If None, we use the number of available CPUs. option clip flags textpage sort delimiters: Passed to internal calls to `Page.get_text()`. ''' args_dict = dict( option=option, clip=clip, flags=flags, textpage=textpage, sort=sort, delimiters=delimiters, ) return apply_pages( path, Page.get_text, pagefn_kwargs=args_dict, pages=pages, method=method, concurrency=concurrency, _stats=_stats, ) class TOOLS: ''' We use @staticmethod to avoid the need to create an instance of this class. ''' def _derotate_matrix(page): if isinstance(page, mupdf.PdfPage): return JM_py_from_matrix(JM_derotate_page_matrix(page)) else: return JM_py_from_matrix(mupdf.FzMatrix()) @staticmethod def _fill_widget(annot, widget): val = JM_get_widget_properties(annot, widget) widget.rect = Rect(annot.rect) widget.xref = annot.xref widget.parent = annot.parent widget._annot = annot # backpointer to annot object if not widget.script: widget.script = None if not widget.script_stroke: widget.script_stroke = None if not widget.script_format: widget.script_format = None if not widget.script_change: widget.script_change = None if not widget.script_calc: widget.script_calc = None if not widget.script_blur: widget.script_blur = None if not widget.script_focus: widget.script_focus = None return val @staticmethod def _get_all_contents(page): page = _as_pdf_page(page.this) res = JM_read_contents(page.obj()) result = JM_BinFromBuffer( res) return result @staticmethod def _insert_contents(page, newcont, overlay=1): """Add bytes as a new /Contents object for a page, and return its xref.""" pdfpage = _as_pdf_page(page, required=1) contbuf = JM_BufferFromBytes(newcont) xref = JM_insert_contents(pdfpage.doc(), pdfpage.obj(), contbuf, overlay) #fixme: pdfpage->doc->dirty = 1; return xref @staticmethod def _le_annot_parms(annot, p1, p2, fill_color): """Get common parameters for making annot line end symbols. Returns: m: matrix that maps p1, p2 to points L, P on the x-axis im: its inverse L, P: transformed p1, p2 w: line width scol: stroke color string fcol: fill color store_shrink opacity: opacity string (gs command) """ w = annot.border["width"] # line width sc = annot.colors["stroke"] # stroke color if not sc: # black if missing sc = (0,0,0) scol = " ".join(map(str, sc)) + " RG\n" if fill_color: fc = fill_color else: fc = annot.colors["fill"] # fill color if not fc: fc = (1,1,1) # white if missing fcol = " ".join(map(str, fc)) + " rg\n" # nr = annot.rect np1 = p1 # point coord relative to annot rect np2 = p2 # point coord relative to annot rect m = Matrix(util_hor_matrix(np1, np2)) # matrix makes the line horizontal im = ~m # inverted matrix L = np1 * m # converted start (left) point R = np2 * m # converted end (right) point if 0 <= annot.opacity < 1: opacity = "/H gs\n" else: opacity = "" return m, im, L, R, w, scol, fcol, opacity @staticmethod def _le_butt(annot, p1, p2, lr, fill_color): """Make stream commands for butt line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 3 d = shift * max(1, w) M = R if lr else L top = (M + (0, -d/2.)) * im bot = (M + (0, d/2.)) * im ap = f"\nq\n{opacity}{top.x:f} {top.y:f} m\n" ap += f"{bot.x:f} {bot.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + "s\nQ\n" return ap @staticmethod def _le_circle(annot, p1, p2, lr, fill_color): """Make stream commands for circle line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square ap = "q\n" + opacity + TOOLS._oval_string(r.tl * im, r.tr * im, r.br * im, r.bl * im) ap += _format_g(w) + " w\n" ap += scol + fcol + "b\nQ\n" return ap @staticmethod def _le_closedarrow(annot, p1, p2, lr, fill_color): """Make stream commands for closed arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R + (d/2., 0) if lr else L - (d/2., 0) p1 = p2 + (-2*d, -d) if lr else p2 + (2*d, -d) p3 = p2 + (-2*d, d) if lr else p2 + (2*d, d) p1 *= im p2 *= im p3 *= im ap = f"\nq\n{opacity}{p1.x:f} {p1.y:f} m\n" ap += f"{p2.x:f} {p2.y:f} l\n" ap += f"{p3.x:f} {p3.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + fcol + "b\nQ\n" return ap @staticmethod def _le_diamond(annot, p1, p2, lr, fill_color): """Make stream commands for diamond line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square # the square makes line longer by (2*shift - 1)*width p = (r.tl + (r.bl - r.tl) * 0.5) * im ap = f"q\n{opacity}{p.x:f} {p.y:f} m\n" p = (r.tl + (r.tr - r.tl) * 0.5) * im ap += f"{p.x:f} {p.y:f} l\n" p = (r.tr + (r.br - r.tr) * 0.5) * im ap += f"{p.x:f} {p.y:f} l\n" p = (r.br + (r.bl - r.br) * 0.5) * im ap += f"{p.x:f} {p.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + fcol + "b\nQ\n" return ap @staticmethod def _le_openarrow(annot, p1, p2, lr, fill_color): """Make stream commands for open arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R + (d/2., 0) if lr else L - (d/2., 0) p1 = p2 + (-2*d, -d) if lr else p2 + (2*d, -d) p3 = p2 + (-2*d, d) if lr else p2 + (2*d, d) p1 *= im p2 *= im p3 *= im ap = f"\nq\n{opacity}{p1.x:f} {p1.y:f} m\n" ap += f"{p2.x:f} {p2.y:f} l\n" ap += f"{p3.x:f} {p3.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + "S\nQ\n" return ap @staticmethod def _le_rclosedarrow(annot, p1, p2, lr, fill_color): """Make stream commands for right closed arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R - (2*d, 0) if lr else L + (2*d, 0) p1 = p2 + (2*d, -d) if lr else p2 + (-2*d, -d) p3 = p2 + (2*d, d) if lr else p2 + (-2*d, d) p1 *= im p2 *= im p3 *= im ap = f"\nq\n{opacity}{p1.x:f} {p1.y:f} m\n" ap += f"{p2.x:f} {p2.y:f} l\n" ap += f"{p3.x:f} {p3.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + fcol + "b\nQ\n" return ap @staticmethod def _le_ropenarrow(annot, p1, p2, lr, fill_color): """Make stream commands for right open arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R - (d/3., 0) if lr else L + (d/3., 0) p1 = p2 + (2*d, -d) if lr else p2 + (-2*d, -d) p3 = p2 + (2*d, d) if lr else p2 + (-2*d, d) p1 *= im p2 *= im p3 *= im ap = f"\nq\n{opacity}{p1.x:f} {p1.y:f} m\n" ap += f"{p2.x:f} {p2.y:f} l\n" ap += f"{p3.x:f} {p3.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + fcol + "S\nQ\n" return ap @staticmethod def _le_slash(annot, p1, p2, lr, fill_color): """Make stream commands for slash line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) rw = 1.1547 * max(1, w) * 1.0 # makes rect diagonal a 30 deg inclination M = R if lr else L r = Rect(M.x - rw, M.y - 2 * w, M.x + rw, M.y + 2 * w) top = r.tl * im bot = r.br * im ap = f"\nq\n{opacity}{top.x:f} {top.y:f} m\n" ap += f"{bot.x:f} {bot.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + "s\nQ\n" return ap @staticmethod def _le_square(annot, p1, p2, lr, fill_color): """Make stream commands for square line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = TOOLS._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square # the square makes line longer by (2*shift - 1)*width p = r.tl * im ap = f"q\n{opacity}{p.x:f} {p.y:f} m\n" p = r.tr * im ap += f"{p.x:f} {p.y:f} l\n" p = r.br * im ap += f"{p.x:f} {p.y:f} l\n" p = r.bl * im ap += f"{p.x:f} {p.y:f} l\n" ap += _format_g(w) + " w\n" ap += scol + fcol + "b\nQ\n" return ap @staticmethod def _oval_string(p1, p2, p3, p4): """Return /AP string defining an oval within a 4-polygon provided as points """ def bezier(p, q, r): return f"{p.x:f} {p.y:f} {q.x:f} {q.y:f} {r.x:f} {r.y:f} c\n" kappa = 0.55228474983 # magic number ml = p1 + (p4 - p1) * 0.5 # middle points ... mo = p1 + (p2 - p1) * 0.5 # for each ... mr = p2 + (p3 - p2) * 0.5 # polygon ... mu = p4 + (p3 - p4) * 0.5 # side ol1 = ml + (p1 - ml) * kappa # the 8 bezier ol2 = mo + (p1 - mo) * kappa # helper points or1 = mo + (p2 - mo) * kappa or2 = mr + (p2 - mr) * kappa ur1 = mr + (p3 - mr) * kappa ur2 = mu + (p3 - mu) * kappa ul1 = mu + (p4 - mu) * kappa ul2 = ml + (p4 - ml) * kappa # now draw, starting from middle point of left side ap = f"{ml.x:f} {ml.y:f} m\n" ap += bezier(ol1, ol2, mo) ap += bezier(or1, or2, mr) ap += bezier(ur1, ur2, mu) ap += bezier(ul1, ul2, ml) return ap @staticmethod def _parse_da(annot): if g_use_extra: val = extra.Tools_parse_da( annot.this) else: def Tools__parse_da(annot): this_annot = annot.this assert isinstance(this_annot, mupdf.PdfAnnot) this_annot_obj = mupdf.pdf_annot_obj( this_annot) pdf = mupdf.pdf_get_bound_document( this_annot_obj) try: da = mupdf.pdf_dict_get_inheritable( this_annot_obj, PDF_NAME('DA')) if not da.m_internal: trailer = mupdf.pdf_trailer(pdf) da = mupdf.pdf_dict_getl(trailer, PDF_NAME('Root'), PDF_NAME('AcroForm'), PDF_NAME('DA'), ) da_str = mupdf.pdf_to_text_string(da) except Exception: if g_exceptions_verbose: exception_info() return return da_str val = Tools__parse_da(annot) if not val: return ((0,), "", 0) font = "Helv" fsize = 12 col = (0, 0, 0) dat = val.split() # split on any whitespace for i, item in enumerate(dat): if item == "Tf": font = dat[i - 2][1:] fsize = float(dat[i - 1]) dat[i] = dat[i-1] = dat[i-2] = "" continue if item == "g": # unicolor text col = [(float(dat[i - 1]))] dat[i] = dat[i-1] = "" continue if item == "rg": # RGB colored text col = [float(f) for f in dat[i - 3:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = "" continue if item == "k": # CMYK colored text col = [float(f) for f in dat[i - 4:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = dat[i-4] = "" continue val = (col, font, fsize) return val @staticmethod def _reset_widget(annot): this_annot = annot this_annot_obj = mupdf.pdf_annot_obj(this_annot) pdf = mupdf.pdf_get_bound_document(this_annot_obj) mupdf.pdf_field_reset(pdf, this_annot_obj) @staticmethod def _rotate_matrix(page): pdfpage = page._pdf_page(required=False) if not pdfpage.m_internal: return JM_py_from_matrix(mupdf.FzMatrix()) return JM_py_from_matrix(JM_rotate_page_matrix(pdfpage)) @staticmethod def _save_widget(annot, widget): JM_set_widget_properties(annot, widget) def _update_da(annot, da_str): if g_use_extra: extra.Tools_update_da( annot.this, da_str) else: try: this_annot = annot.this assert isinstance(this_annot, mupdf.PdfAnnot) mupdf.pdf_dict_put_text_string(mupdf.pdf_annot_obj(this_annot), PDF_NAME('DA'), da_str) mupdf.pdf_dict_del(mupdf.pdf_annot_obj(this_annot), PDF_NAME('DS')) # /* not supported */ mupdf.pdf_dict_del(mupdf.pdf_annot_obj(this_annot), PDF_NAME('RC')) # /* not supported */ except Exception: if g_exceptions_verbose: exception_info() return return @staticmethod def gen_id(): global TOOLS_JM_UNIQUE_ID TOOLS_JM_UNIQUE_ID += 1 return TOOLS_JM_UNIQUE_ID @staticmethod def glyph_cache_empty(): ''' Empty the glyph cache. ''' mupdf.fz_purge_glyph_cache() @staticmethod def image_profile(stream, keep_image=0): ''' Metadata of an image binary stream. ''' return JM_image_profile(stream, keep_image) @staticmethod def mupdf_display_errors(on=None): ''' Set MuPDF error display to True or False. ''' global JM_mupdf_show_errors if on is not None: JM_mupdf_show_errors = bool(on) return JM_mupdf_show_errors @staticmethod def mupdf_display_warnings(on=None): ''' Set MuPDF warnings display to True or False. ''' global JM_mupdf_show_warnings if on is not None: JM_mupdf_show_warnings = bool(on) return JM_mupdf_show_warnings @staticmethod def mupdf_version(): '''Get version of MuPDF binary build.''' return mupdf.FZ_VERSION @staticmethod def mupdf_warnings(reset=1): ''' Get the MuPDF warnings/errors with optional reset (default). ''' # Get any trailing `... repeated times...` message. mupdf.fz_flush_warnings() ret = '\n'.join( JM_mupdf_warnings_store) if reset: TOOLS.reset_mupdf_warnings() return ret @staticmethod def reset_mupdf_warnings(): global JM_mupdf_warnings_store JM_mupdf_warnings_store = list() @staticmethod def set_aa_level(level): ''' Set anti-aliasing level. ''' mupdf.fz_set_aa_level(level) @staticmethod def set_annot_stem( stem=None): global JM_annot_id_stem if stem is None: return JM_annot_id_stem len_ = len(stem) + 1 if len_ > 50: len_ = 50 JM_annot_id_stem = stem[:50] return JM_annot_id_stem @staticmethod def set_font_width(doc, xref, width): pdf = _as_pdf_document(doc, required=0) if not pdf.m_internal: return False font = mupdf.pdf_load_object(pdf, xref) dfonts = mupdf.pdf_dict_get(font, PDF_NAME('DescendantFonts')) if mupdf.pdf_is_array(dfonts): n = mupdf.pdf_array_len(dfonts) for i in range(n): dfont = mupdf.pdf_array_get(dfonts, i) warray = mupdf.pdf_new_array(pdf, 3) mupdf.pdf_array_push(warray, mupdf.pdf_new_int(0)) mupdf.pdf_array_push(warray, mupdf.pdf_new_int(65535)) mupdf.pdf_array_push(warray, mupdf.pdf_new_int(width)) mupdf.pdf_dict_put(dfont, PDF_NAME('W'), warray) return True @staticmethod def set_graphics_min_line_width(min_line_width): ''' Set the graphics minimum line width. ''' mupdf.fz_set_graphics_min_line_width(min_line_width) @staticmethod def set_icc( on=0): """Set ICC color handling on or off.""" if on: if mupdf.FZ_ENABLE_ICC: mupdf.fz_enable_icc() else: RAISEPY( "MuPDF built w/o ICC support",PyExc_ValueError) elif mupdf.FZ_ENABLE_ICC: mupdf.fz_disable_icc() @staticmethod def set_low_memory( on=None): """Set / unset MuPDF device caching.""" if on is not None: _globals.no_device_caching = bool(on) return _globals.no_device_caching @staticmethod def set_small_glyph_heights(on=None): """Set / unset small glyph heights.""" if on is not None: _globals.small_glyph_heights = bool(on) if g_use_extra: extra.set_small_glyph_heights(_globals.small_glyph_heights) return _globals.small_glyph_heights @staticmethod def set_subset_fontnames(on=None): ''' Set / unset returning fontnames with their subset prefix. ''' if on is not None: _globals.subset_fontnames = bool(on) if g_use_extra: extra.set_subset_fontnames(_globals.subset_fontnames) return _globals.subset_fontnames @staticmethod def show_aa_level(): ''' Show anti-aliasing values. ''' return dict( graphics = mupdf.fz_graphics_aa_level(), text = mupdf.fz_text_aa_level(), graphics_min_line_width = mupdf.fz_graphics_min_line_width(), ) @staticmethod def store_maxsize(): ''' MuPDF store size limit. ''' # fixme: return gctx->store->max. return None @staticmethod def store_shrink(percent): ''' Free 'percent' of current store size. ''' if percent >= 100: mupdf.fz_empty_store() return 0 if percent > 0: mupdf.fz_shrink_store( 100 - percent) # fixme: return gctx->store->size. @staticmethod def store_size(): ''' MuPDF current store size. ''' # fixme: return gctx->store->size. return None @staticmethod def unset_quad_corrections(on=None): ''' Set ascender / descender corrections on or off. ''' if on is not None: _globals.skip_quad_corrections = bool(on) if g_use_extra: extra.set_skip_quad_corrections(_globals.skip_quad_corrections) return _globals.skip_quad_corrections # fixme: also defined at top-level. JM_annot_id_stem = 'fitz' fitz_config = JM_fitz_config() # Callbacks not yet supported with cppyy. if not mupdf_cppyy: mupdf.fz_set_warning_callback(JM_mupdf_warning) mupdf.fz_set_error_callback(JM_mupdf_error) # If there are pending warnings when we exit, we end up in this sequence: # # atexit() # -> mupdf::internal_thread_state::~internal_thread_state() # -> fz_drop_context() # -> fz_flush_warnings() # -> SWIG Director code # -> Python calling JM_mupdf_warning(). # # Unfortunately this causes a SEGV, seemingly because the SWIG Director code has # already been torn down. # # So we use a Python atexit handler to explicitly call fz_flush_warnings(); # this appears to happen early enough for the Director machinery to still # work. So in the sequence above, fz_flush_warnings() will find that there are # no pending warnings and will not attempt to call JM_mupdf_warning(). # def _atexit(): #log( 'PyMuPDF/src/__init__.py:_atexit() called') mupdf.fz_flush_warnings() mupdf.fz_set_warning_callback(None) mupdf.fz_set_error_callback(None) #log( '_atexit() returning') atexit.register( _atexit) # List of (name, red, green, blue) where: # name: upper-case name. # red, green, blue: integer in range 0..255. # from . import _wxcolors _wxcolors = _wxcolors._wxcolors # Dict mapping from name to (red, green, blue). # name: lower-case name. # red, green, blue: float in range 0..1. # pdfcolor = dict() for name, r, g, b in _wxcolors: pdfcolor[name.lower()] = (r/255, g/255, b/255) def colors_pdf_dict(): ''' Returns dict mapping from name to (red, green, blue). name: lower-case name. red, green, blue: float in range 0..1. ''' return pdfcolor def colors_wx_list(): ''' Returns list of (name, red, green, blue) tuples: name: upper-case name. red, green, blue: integers in range 0..255. ''' return _wxcolors def _mupdf_devel(make_links=True): ''' Allows PyMuPDF installation to be used to compile and link programmes that use the MuPDF C/C++ API. Args: make_links: If true, then on non-windows we also create softlinks to any shared libraries that are supplied with a version suffix; this allows them to be used in a link command. For example we create links such as: site-packages/pymupdf/ libmupdf.so -> libmupdf.so.26.7 libmupdfcpp.so -> libmupdfcpp.so.26.7 Returns: (mupdf_include, mupdf_lib). mupdf_include: Path of MuPDF include directory within PyMuPDF install. mupdf_lib Path of MuPDF library directory within PyMuPDF install. ''' import platform log(f'{mupdf_version=}') p = os.path.normpath(f'{__file__}/..') mupdf_include = f'{p}/mupdf-devel/include' if platform.system() == 'Windows': # Separate .lib files are used at build time. mupdf_lib = f'{p}/mupdf-devel/lib' else: # .so files are used for both buildtime and runtime linking. mupdf_lib = p log(f'Within installed PyMuPDF:') log(f' {mupdf_include=}') log(f' {mupdf_lib=}') assert os.path.isdir(mupdf_include), f'Not a directory: {mupdf_include=}.' assert os.path.isdir(mupdf_lib), f'Not a directory: {mupdf_lib=}.' if platform.system() != 'Windows' and make_links: # Make symbolic links within the installed pymupdf module so # that ld can find libmupdf.so etc. This is a bit of a hack, but # necessary because wheels cannot contain symbolic links. # # For example we create `libmupdf.so -> libmupdf.so.24.8`. # # We are careful to only create symlinks for the expected MuPDF # version, in case old .so files from a previous install are still # in place. # log(f'Creating symlinks in {mupdf_lib=} for MuPDF-{mupdf_version} .so files.') regex_suffix = mupdf_version.split('.')[1:3] regex_suffix = '[.]'.join(regex_suffix) mupdf_lib_regex = f'^(lib[^.]+[.]so)[.]{regex_suffix}$' log(f'{mupdf_lib_regex=}.') for leaf in os.listdir(mupdf_lib): m = re.match(mupdf_lib_regex, leaf) if m: pfrom = f'{mupdf_lib}/{m.group(1)}' # os.path.exists() can return false if softlink exists # but points to non-existent file, so we also use # `os.path.islink()`. if os.path.islink(pfrom) or os.path.exists(pfrom): log(f'Removing existing link {pfrom=}.') os.remove(pfrom) log(f'Creating symlink: {pfrom} -> {leaf}') os.symlink(leaf, pfrom) return mupdf_include, mupdf_lib # We cannot import utils earlier because it imports this .py file itself and # uses some pymupdf.* types in function typing. # from . import utils # Use utils.*() fns for some class methods. # recover_bbox_quad = utils.recover_bbox_quad recover_char_quad = utils.recover_char_quad recover_line_quad = utils.recover_line_quad recover_quad = utils.recover_quad recover_span_quad = utils.recover_span_quad from . import table class FitzDeprecation(DeprecationWarning): pass def restore_aliases(): warnings.filterwarnings( "once", category=FitzDeprecation) def showthis(msg, cat, filename, lineno, file=None, line=None): text = warnings.formatwarning(msg, cat, filename, lineno, line=line) s = text.find("FitzDeprecation") if s < 0: log(text) return text = text[s:].splitlines()[0][4:] log(text) warnings.showwarning = showthis def _alias(class_, new_name, legacy_name=None): ''' Adds an alias for a class_ or module item clled .. class_: Class/module to modify; use None for the current module. new_name: String name of existing item, e.g. name of method. legacy_name: Name of legacy object to create in . If None, we generate from by removing underscores and capitalising the next letter. ''' if class_ is None: class_ = sys.modules[__name__] if not legacy_name: legacy_name = '' capitalise_next = False for c in new_name: if c == '_': capitalise_next = True elif capitalise_next: legacy_name += c.upper() capitalise_next = False else: legacy_name += c new_object = getattr( class_, new_name) assert not getattr( class_, legacy_name, None), f'class {class_} already has {legacy_name}' if callable( new_object): def deprecated_function( *args, **kwargs): warnings.warn( f'"{legacy_name=}" removed from {class_} after v1.19.0 - use "{new_name}".', category=FitzDeprecation, ) return new_object( *args, **kwargs) setattr( class_, legacy_name, deprecated_function) deprecated_function.__doc__ = ( f'*** Deprecated and removed in version after v1.19.0 - use "{new_name}". ***\n' f'{new_object.__doc__}' ) else: setattr( class_, legacy_name, new_object) _alias( Annot, 'get_file', 'fileGet') _alias( Annot, 'get_pixmap') _alias( Annot, 'get_sound', 'soundGet') _alias( Annot, 'get_text') _alias( Annot, 'get_textbox') _alias( Annot, 'get_textpage', 'getTextPage') _alias( Annot, 'line_ends') _alias( Annot, 'set_blendmode', 'setBlendMode') _alias( Annot, 'set_border') _alias( Annot, 'set_colors') _alias( Annot, 'set_flags') _alias( Annot, 'set_info') _alias( Annot, 'set_line_ends') _alias( Annot, 'set_name') _alias( Annot, 'set_oc', 'setOC') _alias( Annot, 'set_opacity') _alias( Annot, 'set_rect') _alias( Annot, 'update_file', 'fileUpd') _alias( DisplayList, 'get_pixmap') _alias( DisplayList, 'get_textpage', 'getTextPage') _alias( Document, 'chapter_count') _alias( Document, 'chapter_page_count') _alias( Document, 'convert_to_pdf', 'convertToPDF') _alias( Document, 'copy_page') _alias( Document, 'delete_page') _alias( Document, 'delete_pages', 'deletePageRange') _alias( Document, 'embfile_add', 'embeddedFileAdd') _alias( Document, 'embfile_count', 'embeddedFileCount') _alias( Document, 'embfile_del', 'embeddedFileDel') _alias( Document, 'embfile_get', 'embeddedFileGet') _alias( Document, 'embfile_info', 'embeddedFileInfo') _alias( Document, 'embfile_names', 'embeddedFileNames') _alias( Document, 'embfile_upd', 'embeddedFileUpd') _alias( Document, 'extract_font') _alias( Document, 'extract_image') _alias( Document, 'find_bookmark') _alias( Document, 'fullcopy_page') _alias( Document, 'get_char_widths') _alias( Document, 'get_ocgs', 'getOCGs') _alias( Document, 'get_page_fonts', 'getPageFontList') _alias( Document, 'get_page_images', 'getPageImageList') _alias( Document, 'get_page_pixmap') _alias( Document, 'get_page_text') _alias( Document, 'get_page_xobjects', 'getPageXObjectList') _alias( Document, 'get_sigflags', 'getSigFlags') _alias( Document, 'get_toc', 'getToC') _alias( Document, 'get_xml_metadata') _alias( Document, 'insert_page') _alias( Document, 'insert_pdf', 'insertPDF') _alias( Document, 'is_dirty') _alias( Document, 'is_form_pdf', 'isFormPDF') _alias( Document, 'is_pdf', 'isPDF') _alias( Document, 'is_reflowable') _alias( Document, 'is_repaired') _alias( Document, 'last_location') _alias( Document, 'load_page') _alias( Document, 'make_bookmark') _alias( Document, 'move_page') _alias( Document, 'needs_pass') _alias( Document, 'new_page') _alias( Document, 'next_location') _alias( Document, 'page_count') _alias( Document, 'page_cropbox', 'pageCropBox') _alias( Document, 'page_xref') _alias( Document, 'pdf_catalog', 'PDFCatalog') _alias( Document, 'pdf_trailer', 'PDFTrailer') _alias( Document, 'prev_location', 'previousLocation') _alias( Document, 'resolve_link') _alias( Document, 'search_page_for') _alias( Document, 'set_language') _alias( Document, 'set_metadata') _alias( Document, 'set_toc', 'setToC') _alias( Document, 'set_xml_metadata') _alias( Document, 'update_object') _alias( Document, 'update_stream') _alias( Document, 'xref_is_stream', 'isStream') _alias( Document, 'xref_length') _alias( Document, 'xref_object') _alias( Document, 'xref_stream') _alias( Document, 'xref_stream_raw') _alias( Document, 'xref_xml_metadata', 'metadataXML') _alias( IRect, 'get_area') _alias( IRect, 'get_area', 'getRectArea') _alias( IRect, 'include_point') _alias( IRect, 'include_rect') _alias( IRect, 'is_empty') _alias( IRect, 'is_infinite') _alias( Link, 'is_external') _alias( Link, 'set_border') _alias( Link, 'set_colors') _alias( Matrix, 'is_rectilinear') _alias( Matrix, 'prerotate', 'preRotate') _alias( Matrix, 'prescale', 'preScale') _alias( Matrix, 'preshear', 'preShear') _alias( Matrix, 'pretranslate', 'preTranslate') _alias( None, 'get_pdf_now', 'getPDFnow') _alias( None, 'get_pdf_str', 'getPDFstr') _alias( None, 'get_text_length') _alias( None, 'get_text_length', 'getTextlength') _alias( None, 'image_profile', 'ImageProperties') _alias( None, 'paper_rect', 'PaperRect') _alias( None, 'paper_size', 'PaperSize') _alias( None, 'paper_sizes') _alias( None, 'planish_line') _alias( Outline, 'is_external') _alias( Outline, 'is_open') _alias( Page, 'add_caret_annot') _alias( Page, 'add_circle_annot') _alias( Page, 'add_file_annot') _alias( Page, 'add_freetext_annot') _alias( Page, 'add_highlight_annot') _alias( Page, 'add_ink_annot') _alias( Page, 'add_line_annot') _alias( Page, 'add_polygon_annot') _alias( Page, 'add_polyline_annot') _alias( Page, 'add_rect_annot') _alias( Page, 'add_redact_annot') _alias( Page, 'add_squiggly_annot') _alias( Page, 'add_stamp_annot') _alias( Page, 'add_strikeout_annot') _alias( Page, 'add_text_annot') _alias( Page, 'add_underline_annot') _alias( Page, 'add_widget') _alias( Page, 'clean_contents') _alias( Page, 'cropbox', 'CropBox') _alias( Page, 'cropbox_position', 'CropBoxPosition') _alias( Page, 'delete_annot') _alias( Page, 'delete_link') _alias( Page, 'delete_widget') _alias( Page, 'derotation_matrix') _alias( Page, 'draw_bezier') _alias( Page, 'draw_circle') _alias( Page, 'draw_curve') _alias( Page, 'draw_line') _alias( Page, 'draw_oval') _alias( Page, 'draw_polyline') _alias( Page, 'draw_quad') _alias( Page, 'draw_rect') _alias( Page, 'draw_sector') _alias( Page, 'draw_squiggle') _alias( Page, 'draw_zigzag') _alias( Page, 'first_annot') _alias( Page, 'first_link') _alias( Page, 'first_widget') _alias( Page, 'get_contents') _alias( Page, 'get_displaylist', 'getDisplayList') _alias( Page, 'get_drawings') _alias( Page, 'get_fonts', 'getFontList') _alias( Page, 'get_image_bbox') _alias( Page, 'get_images', 'getImageList') _alias( Page, 'get_links') _alias( Page, 'get_pixmap') _alias( Page, 'get_svg_image', 'getSVGimage') _alias( Page, 'get_text') _alias( Page, 'get_text_blocks') _alias( Page, 'get_text_words') _alias( Page, 'get_textbox') _alias( Page, 'get_textpage', 'getTextPage') _alias( Page, 'insert_font') _alias( Page, 'insert_image') _alias( Page, 'insert_link') _alias( Page, 'insert_text') _alias( Page, 'insert_textbox') _alias( Page, 'is_wrapped', '_isWrapped') _alias( Page, 'load_annot') _alias( Page, 'load_links') _alias( Page, 'mediabox', 'MediaBox') _alias( Page, 'mediabox_size', 'MediaBoxSize') _alias( Page, 'new_shape') _alias( Page, 'read_contents') _alias( Page, 'rotation_matrix') _alias( Page, 'search_for') _alias( Page, 'set_cropbox', 'setCropBox') _alias( Page, 'set_mediabox', 'setMediaBox') _alias( Page, 'set_rotation') _alias( Page, 'show_pdf_page', 'showPDFpage') _alias( Page, 'transformation_matrix') _alias( Page, 'update_link') _alias( Page, 'wrap_contents') _alias( Page, 'write_text') _alias( Pixmap, 'clear_with') _alias( Pixmap, 'copy', 'copyPixmap') _alias( Pixmap, 'gamma_with') _alias( Pixmap, 'invert_irect', 'invertIRect') _alias( Pixmap, 'pil_save', 'pillowWrite') _alias( Pixmap, 'pil_tobytes', 'pillowData') _alias( Pixmap, 'save', 'writeImage') _alias( Pixmap, 'save', 'writePNG') _alias( Pixmap, 'set_alpha') _alias( Pixmap, 'set_dpi', 'setResolution') _alias( Pixmap, 'set_origin') _alias( Pixmap, 'set_pixel') _alias( Pixmap, 'set_rect') _alias( Pixmap, 'tint_with') _alias( Pixmap, 'tobytes', 'getImageData') _alias( Pixmap, 'tobytes', 'getPNGData') _alias( Pixmap, 'tobytes', 'getPNGdata') _alias( Quad, 'is_convex') _alias( Quad, 'is_empty') _alias( Quad, 'is_rectangular') _alias( Rect, 'get_area') _alias( Rect, 'get_area', 'getRectArea') _alias( Rect, 'include_point') _alias( Rect, 'include_rect') _alias( Rect, 'is_empty') _alias( Rect, 'is_infinite') _alias( TextWriter, 'fill_textbox') _alias( TextWriter, 'write_text') _alias( Shape, 'draw_bezier') _alias( Shape, 'draw_circle') _alias( Shape, 'draw_curve') _alias( Shape, 'draw_line') _alias( Shape, 'draw_oval') _alias( Shape, 'draw_polyline') _alias( Shape, 'draw_quad') _alias( Shape, 'draw_rect') _alias( Shape, 'draw_sector') _alias( Shape, 'draw_squiggle') _alias( Shape, 'draw_zigzag') _alias( Shape, 'insert_text') _alias( Shape, 'insert_textbox') if 0: restore_aliases() __version__ = VersionBind __doc__ = ( f'PyMuPDF {VersionBind}: Python bindings for the MuPDF {VersionFitz} library.\n' f'Python {sys.version_info[0]}.{sys.version_info[1]} running on {sys.platform} ({64 if sys.maxsize > 2**32 else 32}-bit).\n' ) ================================================ FILE: src/__main__.py ================================================ # ----------------------------------------------------------------------------- # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # Part of "PyMuPDF", Python bindings for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ----------------------------------------------------------------------------- import argparse import bisect import os import sys import statistics from typing import Dict, List, Set from . import pymupdf def mycenter(x): return (f" {x} ").center(75, "-") def recoverpix(doc, item): """Return image for a given XREF.""" x = item[0] # xref of PDF image s = item[1] # xref of its /SMask if s == 0: # no smask: use direct image output return doc.extract_image(x) def getimage(pix): if pix.colorspace.n != 4: return pix tpix = pymupdf.Pixmap(pymupdf.csRGB, pix) return tpix # we need to reconstruct the alpha channel with the smask pix1 = pymupdf.Pixmap(doc, x) pix2 = pymupdf.Pixmap(doc, s) # create pixmap of the /SMask entry """Sanity check: - both pixmaps must have the same rectangle - both pixmaps must have alpha=0 - pix2 must consist of 1 byte per pixel """ if not (pix1.irect == pix2.irect and pix1.alpha == pix2.alpha == 0 and pix2.n == 1): pymupdf.message(f"Warning: unsupported /SMask {s} for {x}:") pymupdf.message(pix2) pix2 = None return getimage(pix1) # return the pixmap as is pix = pymupdf.Pixmap(pix1) # copy of pix1, with an alpha channel added pix.set_alpha(pix2.samples) # treat pix2.samples as the alpha values pix1 = pix2 = None # free temp pixmaps # we may need to adjust something for CMYK pixmaps here: return getimage(pix) def open_file(filename, password, show=False, pdf=True): """Open and authenticate a document.""" doc = pymupdf.open(filename) if not doc.is_pdf and pdf is True: sys.exit("this command supports PDF files only") rc = -1 if not doc.needs_pass: return doc if password: rc = doc.authenticate(password) if not rc: sys.exit("authentication unsuccessful") if show is True: auth_level = "user" if rc > 2: auth_level = "owner" pymupdf.message(f"authenticated as {auth_level}") else: sys.exit(f"'{doc.name}' requires a password") return doc def print_dict(item): """Print a Python dictionary.""" l = max([len(k) for k in item.keys()]) + 1 for k, v in item.items(): msg = f"{k.rjust(l)}: {v}" pymupdf.message(msg) def print_xref(doc, xref): """Print an object given by XREF number. Simulate the PDF source in "pretty" format. For a stream also print its size. """ pymupdf.message(f"{xref:d} 0 obj") xref_str = doc.xref_object(xref) pymupdf.message(xref_str) if doc.xref_is_stream(xref): temp = xref_str.split() try: idx = temp.index("/Length") + 1 size = temp[idx] if size.endswith("0 R"): size = "unknown" except Exception: size = "unknown" pymupdf.message(f"stream\n...{size} bytes") pymupdf.message("endstream") pymupdf.message("endobj") def get_list(rlist, limit, what="page"): """Transform a page / xref specification into a list of integers. Args ---- rlist: (str) the specification limit: maximum number, i.e. number of pages, number of objects what: a string to be used in error messages Returns ------- A list of integers representing the specification. """ N = str(limit - 1) rlist = rlist.replace("N", N).replace(" ", "") rlist_arr = rlist.split(",") out_list = [] for seq, item in enumerate(rlist_arr): n = seq + 1 if item.isdecimal(): # a single integer i = int(item) if 1 <= i < limit: out_list.append(int(item)) else: sys.exit(f"bad {what} specification at item {n:d}") continue try: # this must be a range now, and all of the following must work: i1, i2 = item.split("-") # will fail if not 2 items produced i1 = int(i1) # will fail on non-integers i2 = int(i2) except Exception: sys.exit(f"bad {what} range specification at item {n:d}") if not (1 <= i1 < limit and 1 <= i2 < limit): sys.exit(f"bad {what} range specification at item {n:d}") if i1 == i2: # just in case: a range of equal numbers out_list.append(i1) continue if i1 < i2: # first less than second out_list += list(range(i1, i2 + 1)) else: # first larger than second out_list += list(range(i1, i2 - 1, -1)) return out_list def show(args): doc = open_file(args.input, args.password, True) size = os.path.getsize(args.input) / 1024 flag = "KB" if size > 1000: size /= 1024 flag = "MB" size = round(size, 1) meta = doc.metadata # pylint: disable=no-member pymupdf.message( "'%s', pages: %i, objects: %i, %g %s, %s, encryption: %s" % ( args.input, doc.page_count, doc.xref_length() - 1, size, flag, meta["format"], meta["encryption"], ) ) n = doc.is_form_pdf if n > 0: s = doc.get_sigflags() sign_str = "" if s != 3: sign_str = "not " pymupdf.message(f"document contains {n} root form fields and is {sign_str}signed") n = doc.embfile_count() if n > 0: pymupdf.message(f"document contains {n:d} embedded files") pymupdf.message() if args.catalog: pymupdf.message(mycenter("PDF catalog")) xref = doc.pdf_catalog() print_xref(doc, xref) pymupdf.message() if args.metadata: pymupdf.message(mycenter("PDF metadata")) print_dict(doc.metadata) # pylint: disable=no-member pymupdf.message() if args.xrefs: pymupdf.message(mycenter("object information")) xrefl = get_list(args.xrefs, doc.xref_length(), what="xref") for xref in xrefl: print_xref(doc, xref) pymupdf.message() if args.pages: pymupdf.message(mycenter("page information")) pagel = get_list(args.pages, doc.page_count + 1) for pno in pagel: n = pno - 1 xref = doc.page_xref(n) pymupdf.message(f"Page {pno:d}:") print_xref(doc, xref) pymupdf.message() if args.trailer: pymupdf.message(mycenter("PDF trailer")) pymupdf.message(doc.pdf_trailer()) pymupdf.message() doc.close() def clean(args): doc = open_file(args.input, args.password, pdf=True) encryption = args.encryption encrypt = ("keep", "none", "rc4-40", "rc4-128", "aes-128", "aes-256").index( encryption ) if not args.pages: # simple cleaning doc.save( args.output, garbage=args.garbage, deflate=args.compress, pretty=args.pretty, clean=args.sanitize, ascii=args.ascii, linear=args.linear, encryption=encrypt, owner_pw=args.owner, user_pw=args.user, permissions=args.permission, ) return # create sub document from page numbers pages = get_list(args.pages, doc.page_count + 1) outdoc = pymupdf.open() for pno in pages: n = pno - 1 outdoc.insert_pdf(doc, from_page=n, to_page=n) outdoc.save( args.output, garbage=args.garbage, deflate=args.compress, pretty=args.pretty, clean=args.sanitize, ascii=args.ascii, linear=args.linear, encryption=encrypt, owner_pw=args.owner, user_pw=args.user, permissions=args.permission, ) doc.close() outdoc.close() return def doc_join(args): """Join pages from several PDF documents.""" doc_list = args.input # a list of input PDFs doc = pymupdf.open() # output PDF for src_item in doc_list: # process one input PDF src_list = src_item.split(",") password = src_list[1] if len(src_list) > 1 else None src = open_file(src_list[0], password, pdf=True) pages = ",".join(src_list[2:]) # get 'pages' specifications if pages: # if anything there, retrieve a list of desired pages page_list = get_list(",".join(src_list[2:]), src.page_count + 1) else: # take all pages page_list = range(1, src.page_count + 1) for i in page_list: doc.insert_pdf(src, from_page=i - 1, to_page=i - 1) # copy each source page src.close() doc.save(args.output, garbage=4, deflate=True) doc.close() def embedded_copy(args): """Copy embedded files between PDFs.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( not args.output or args.output == args.input ): sys.exit("cannot save PDF incrementally") src = open_file(args.source, args.pwdsource) names = set(args.name) if args.name else set() src_names = set(src.embfile_names()) if names: if not names <= src_names: sys.exit("not all names are contained in source") else: names = src_names if not names: sys.exit("nothing to copy") intersect = names & set(doc.embfile_names()) # any equal name already in target? if intersect: sys.exit(f"following names already exist in receiving PDF: {str(intersect)}") for item in names: info = src.embfile_info(item) buff = src.embfile_get(item) doc.embfile_add( item, buff, filename=info["filename"], ufilename=info["ufilename"], desc=info["desc"], ) pymupdf.message(f"copied entry '{item}' from '{src.name}'") src.close() if args.output and args.output != args.input: doc.save(args.output, garbage=3) else: doc.saveIncr() doc.close() def embedded_del(args): """Delete an embedded file entry.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( not args.output or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_del(args.name) except (ValueError, pymupdf.mupdf.FzErrorBase) as e: sys.exit(f'no such embedded file {args.name!r}: {e}') if not args.output or args.output == args.input: doc.saveIncr() else: doc.save(args.output, garbage=1) doc.close() def embedded_get(args): """Retrieve contents of an embedded file.""" doc = open_file(args.input, args.password, pdf=True) try: stream = doc.embfile_get(args.name) d = doc.embfile_info(args.name) except (ValueError, pymupdf.mupdf.FzErrorBase) as e: sys.exit(f'no such embedded file {args.name!r}: {e}') filename = args.output if args.output else d["filename"] if not args.unsafe and not args.output: if os.path.exists(filename): sys.exit(f'refusing to overwrite existing file with stored name: {filename}') filename_abs = os.path.abspath(filename) if not filename_abs.startswith(os.getcwd() + os.sep): sys.exit(f'refusing to write stored name outside current directory: {filename}') with open(filename, "wb") as output: output.write(stream) pymupdf.message(f"saved entry '{args.name}' as '{filename}'") doc.close() def embedded_add(args): """Insert a new embedded file.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( args.output is None or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_del(args.name) sys.exit(f"entry '{args.name}' already exists") except Exception: pass if not os.path.exists(args.path) or not os.path.isfile(args.path): sys.exit(f"no such file '{args.path}'") with open(args.path, "rb") as f: stream = f.read() filename = args.path ufilename = filename if not args.desc: desc = filename else: desc = args.desc doc.embfile_add( args.name, stream, filename=filename, ufilename=ufilename, desc=desc ) if not args.output or args.output == args.input: doc.saveIncr() else: doc.save(args.output, garbage=3) doc.close() def embedded_upd(args): """Update contents or metadata of an embedded file.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( args.output is None or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_info(args.name) except Exception: sys.exit(f"no such embedded file '{args.name}'") if ( args.path is not None and os.path.exists(args.path) and os.path.isfile(args.path) ): with open(args.path, "rb") as f: stream = f.read() else: stream = None if args.filename: filename = args.filename else: filename = None if args.ufilename: ufilename = args.ufilename elif args.filename: ufilename = args.filename else: ufilename = None if args.desc: desc = args.desc else: desc = None doc.embfile_upd( args.name, stream, filename=filename, ufilename=ufilename, desc=desc ) if args.output is None or args.output == args.input: doc.saveIncr() else: doc.save(args.output, garbage=3) doc.close() def embedded_list(args): """List embedded files.""" doc = open_file(args.input, args.password, pdf=True) names = doc.embfile_names() if args.name is not None: if args.name not in names: sys.exit(f"no such embedded file '{args.name}'") else: pymupdf.message() plural = "" if len(names) > 1: plural = "s" pymupdf.message(f"printing 1 of {len(names):d} embedded file{plural}:") pymupdf.message() print_dict(doc.embfile_info(args.name)) pymupdf.message() return if not names: pymupdf.message(f"'{doc.name}' contains no embedded files") return if len(names) > 1: msg = f"'{doc.name}' contains the following {len(names):d} embedded files" else: msg = f"'{doc.name}' contains the following embedded file" pymupdf.message(msg) pymupdf.message() for name in names: if not args.detail: pymupdf.message(name) continue _ = doc.embfile_info(name) print_dict(doc.embfile_info(name)) pymupdf.message() doc.close() def extract_objects(args): """Extract images and / or fonts from a PDF.""" if not args.fonts and not args.images: sys.exit("neither fonts nor images requested") doc = open_file(args.input, args.password, pdf=True) if args.pages: pages = get_list(args.pages, doc.page_count + 1) else: pages = range(1, doc.page_count + 1) if not args.output: out_dir = os.path.abspath(os.curdir) else: out_dir = args.output if not (os.path.exists(out_dir) and os.path.isdir(out_dir)): sys.exit(f"output directory {out_dir} does not exist") font_xrefs = set() # already saved fonts image_xrefs = set() # already saved images for pno in pages: if args.fonts: itemlist = doc.get_page_fonts(pno - 1) for item in itemlist: xref = item[0] if xref not in font_xrefs: font_xrefs.add(xref) fontname, ext, _, buffer = doc.extract_font(xref) if ext == "n/a" or not buffer: continue outname = os.path.join( out_dir, f"{fontname.replace(' ', '-')}-{xref}.{ext}" ) with open(outname, "wb") as outfile: outfile.write(buffer) buffer = None if args.images: itemlist = doc.get_page_images(pno - 1) for item in itemlist: xref = item[0] if xref not in image_xrefs: image_xrefs.add(xref) pix = recoverpix(doc, item) if type(pix) is dict: ext = pix["ext"] imgdata = pix["image"] outname = os.path.join(out_dir, f"img-{xref:d}.{ext}") with open(outname, "wb") as outfile: outfile.write(imgdata) else: outname = os.path.join(out_dir, f"img-{xref:d}.png") pix2 = ( pix if pix.colorspace.n < 4 else pymupdf.Pixmap(pymupdf.csRGB, pix) ) pix2.save(outname) if args.fonts: pymupdf.message(f"saved {len(font_xrefs):d} fonts to '{out_dir}'") if args.images: pymupdf.message(f"saved {len(image_xrefs):d} images to '{out_dir}'") doc.close() def page_simple(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) text = page.get_text("text", flags=flags) if not text: if not skip_empty: textout.write(eop) # write formfeed return textout.write(text.encode("utf8", errors="surrogatepass")) textout.write(eop) return def page_blocksort(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) blocks = page.get_text("blocks", flags=flags) if blocks == []: if not skip_empty: textout.write(eop) # write formfeed return blocks.sort(key=lambda b: (b[3], b[0])) for b in blocks: textout.write(b[4].encode("utf8", errors="surrogatepass")) textout.write(eop) return def page_layout(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) # -------------------------------------------------------------------- def find_line_index(values: List[int], value: int) -> int: """Find the right row coordinate. Args: values: (list) y-coordinates of rows. value: (int) lookup for this value (y-origin of char). Returns: y-ccordinate of appropriate line for value. """ i = bisect.bisect_right(values, value) if i: return values[i - 1] raise RuntimeError(f"Line for {value:g} not found in {values}") # -------------------------------------------------------------------- def curate_rows(rows: Set[int], GRID) -> List: rows = list(rows) rows.sort() # sort ascending nrows = [rows[0]] for h in rows[1:]: if h >= nrows[-1] + GRID: # only keep significant differences nrows.append(h) return nrows # curated list of line bottom coordinates def process_blocks(blocks: List[Dict], page: pymupdf.Page): rows = set() page_width = page.rect.width page_height = page.rect.height rowheight = page_height left = page_width right = 0 chars = [] for block in blocks: for line in block["lines"]: if line["dir"] != (1, 0): # ignore non-horizontal text continue x0, y0, x1, y1 = line["bbox"] if y1 < 0 or y0 > page.rect.height: # ignore if outside CropBox continue # upd row height height = y1 - y0 if rowheight > height: rowheight = height for span in line["spans"]: if span["size"] <= fontsize: continue for c in span["chars"]: x0, _, x1, _ = c["bbox"] cwidth = x1 - x0 ox, oy = c["origin"] oy = int(round(oy)) rows.add(oy) ch = c["c"] if left > ox and ch != " ": left = ox # update left coordinate if right < x1: right = x1 # update right coordinate # handle ligatures: if cwidth == 0 and chars != []: # potential ligature old_ch, old_ox, old_oy, old_cwidth = chars[-1] if old_oy == oy: # ligature if old_ch != chr(0xFB00): # previous "ff" char lig? lig = joinligature(old_ch + ch) # no # convert to one of the 3-char ligatures: elif ch == "i": lig = chr(0xFB03) # "ffi" elif ch == "l": lig = chr(0xFB04) # "ffl" else: # something wrong, leave old char in place lig = old_ch chars[-1] = (lig, old_ox, old_oy, old_cwidth) continue chars.append((ch, ox, oy, cwidth)) # all chars on page return chars, rows, left, right, rowheight def joinligature(lig: str) -> str: """Return ligature character for a given pair / triple of characters. Args: lig: (str) 2/3 characters, e.g. "ff" Returns: Ligature, e.g. "ff" -> chr(0xFB00) """ if lig == "ff": return chr(0xFB00) elif lig == "fi": return chr(0xFB01) elif lig == "fl": return chr(0xFB02) elif lig == "ffi": return chr(0xFB03) elif lig == "ffl": return chr(0xFB04) elif lig == "ft": return chr(0xFB05) elif lig == "st": return chr(0xFB06) return lig # -------------------------------------------------------------------- def make_textline(left, slot, minslot, lchars): """Produce the text of one output line. Args: left: (float) left most coordinate used on page slot: (float) avg width of one character in any font in use. minslot: (float) min width for the characters in this line. chars: (list[tuple]) characters of this line. Returns: text: (str) text string for this line """ text = "" # we output this old_char = "" old_x1 = 0 # end coordinate of last char old_ox = 0 # x-origin of last char if minslot <= pymupdf.EPSILON: raise RuntimeError(f"program error: minslot too small = {minslot:g}") for c in lchars: # loop over characters char, ox, _, cwidth = c ox = ox - left # its (relative) start coordinate x1 = ox + cwidth # ending coordinate # eliminate overprint effect if old_char == char and ox - old_ox <= cwidth * 0.2: continue # omit spaces overlapping previous char if char == " " and (old_x1 - ox) / cwidth > 0.8: continue old_char = char # close enough to previous? if ox < old_x1 + minslot: # assume char adjacent to previous text += char # append to output old_x1 = x1 # new end coord old_ox = ox # new origin.x continue # else next char starts after some gap: # fill in right number of spaces, so char is positioned # in the right slot of the line if char == " ": # rest relevant for non-space only continue delta = int(ox / slot) - len(text) if ox > old_x1 and delta > 1: text += " " * delta # now append char text += char old_x1 = x1 # new end coordinate old_ox = ox # new origin return text.rstrip() # extract page text by single characters ("rawdict") blocks = page.get_text("rawdict", flags=flags)["blocks"] chars, rows, left, right, rowheight = process_blocks(blocks, page) if chars == []: if not skip_empty: textout.write(eop) # write formfeed return # compute list of line coordinates - ignoring small (GRID) differences rows = curate_rows(rows, GRID) # sort all chars by x-coordinates, so every line will receive char info, # sorted from left to right. chars.sort(key=lambda c: c[1]) # populate the lines with their char info lines = {} # key: y1-ccordinate, value: char list for c in chars: _, _, oy, _ = c y = find_line_index(rows, oy) # y-coord of the right line lchars = lines.get(y, []) # read line chars so far lchars.append(c) # append this char lines[y] = lchars # write back to line # ensure line coordinates are ascending keys = list(lines.keys()) keys.sort() # ------------------------------------------------------------------------- # Compute "char resolution" for the page: the char width corresponding to # 1 text char position on output - call it 'slot'. # For each line, compute median of its char widths. The minimum across all # lines is 'slot'. # The minimum char width of each line is used to determine if spaces must # be inserted in between two characters. # ------------------------------------------------------------------------- slot = right - left minslots = {} for k in keys: lchars = lines[k] ccount = len(lchars) if ccount < 2: minslots[k] = 1 continue widths = [c[3] for c in lchars] widths.sort() this_slot = statistics.median(widths) # take median value if this_slot < slot: slot = this_slot minslots[k] = widths[0] # compute line advance in text output rowheight = rowheight * (rows[-1] - rows[0]) / (rowheight * len(rows)) * 1.2 rowpos = rows[0] # first line positioned here textout.write(b"\n") for k in keys: # walk through the lines while rowpos < k: # honor distance between lines textout.write(b"\n") rowpos += rowheight text = make_textline(left, slot, minslots[k], lines[k]) textout.write((text + "\n").encode("utf8", errors="surrogatepass")) rowpos = k + rowheight textout.write(eop) # write formfeed def gettext(args): doc = open_file(args.input, args.password, pdf=False) pagel = get_list(args.pages, doc.page_count + 1) output = args.output if output is None: filename, _ = os.path.splitext(doc.name) output = filename + ".txt" with open(output, "wb") as textout: flags = pymupdf.TEXT_PRESERVE_LIGATURES | pymupdf.TEXT_PRESERVE_WHITESPACE if args.convert_white: flags ^= pymupdf.TEXT_PRESERVE_WHITESPACE if args.noligatures: flags ^= pymupdf.TEXT_PRESERVE_LIGATURES if args.extra_spaces: flags ^= pymupdf.TEXT_INHIBIT_SPACES func = { "simple": page_simple, "blocks": page_blocksort, "layout": page_layout, } for pno in pagel: page = doc[pno - 1] func[args.mode]( page, textout, args.grid, args.fontsize, args.noformfeed, args.skip_empty, flags=flags, ) def _internal(args): pymupdf.message('This is from PyMuPDF message().') pymupdf.log('This is from PyMuPDF log().') def main(): """Define command configurations.""" parser = argparse.ArgumentParser( prog="pymupdf", description=mycenter("Basic PyMuPDF Functions"), ) subps = parser.add_subparsers( title="Subcommands", help="Enter 'command -h' for subcommand specific help" ) # ------------------------------------------------------------------------- # 'show' command # ------------------------------------------------------------------------- ps_show = subps.add_parser("show", description=mycenter("display PDF information")) ps_show.add_argument("input", type=str, help="PDF filename") ps_show.add_argument("-password", help="password") ps_show.add_argument("-catalog", action="store_true", help="show PDF catalog") ps_show.add_argument("-trailer", action="store_true", help="show PDF trailer") ps_show.add_argument("-metadata", action="store_true", help="show PDF metadata") ps_show.add_argument( "-xrefs", type=str, help="show selected objects, format: 1,5-7,N" ) ps_show.add_argument( "-pages", type=str, help="show selected pages, format: 1,5-7,50-N" ) ps_show.set_defaults(func=show) # ------------------------------------------------------------------------- # 'clean' command # ------------------------------------------------------------------------- ps_clean = subps.add_parser( "clean", description=mycenter("optimize PDF, or create sub-PDF if pages given") ) ps_clean.add_argument("input", type=str, help="PDF filename") ps_clean.add_argument("output", type=str, help="output PDF filename") ps_clean.add_argument("-password", help="password") ps_clean.add_argument( "-encryption", help="encryption method", choices=("keep", "none", "rc4-40", "rc4-128", "aes-128", "aes-256"), default="none", ) ps_clean.add_argument("-owner", type=str, help="owner password") ps_clean.add_argument("-user", type=str, help="user password") ps_clean.add_argument( "-garbage", type=int, help="garbage collection level", choices=range(5), default=0, ) ps_clean.add_argument( "-compress", action="store_true", default=False, help="compress (deflate) output", ) ps_clean.add_argument( "-ascii", action="store_true", default=False, help="ASCII encode binary data" ) ps_clean.add_argument( "-linear", action="store_true", default=False, help="format for fast web display", ) ps_clean.add_argument( "-permission", type=int, default=-1, help="integer with permission levels" ) ps_clean.add_argument( "-sanitize", action="store_true", default=False, help="sanitize / clean contents", ) ps_clean.add_argument( "-pretty", action="store_true", default=False, help="prettify PDF structure" ) ps_clean.add_argument( "-pages", help="output selected pages pages, format: 1,5-7,50-N" ) ps_clean.set_defaults(func=clean) # ------------------------------------------------------------------------- # 'join' command # ------------------------------------------------------------------------- ps_join = subps.add_parser( "join", description=mycenter("join PDF documents"), epilog="specify each input as 'filename[,password[,pages]]'", ) ps_join.add_argument("input", nargs="*", help="input filenames") ps_join.add_argument("-output", required=True, help="output filename") ps_join.set_defaults(func=doc_join) # ------------------------------------------------------------------------- # 'extract' command # ------------------------------------------------------------------------- ps_extract = subps.add_parser( "extract", description=mycenter("extract images and fonts to disk") ) ps_extract.add_argument("input", type=str, help="PDF filename") ps_extract.add_argument("-images", action="store_true", help="extract images") ps_extract.add_argument("-fonts", action="store_true", help="extract fonts") ps_extract.add_argument( "-output", help="folder to receive output, defaults to current" ) ps_extract.add_argument("-password", help="password") ps_extract.add_argument( "-pages", type=str, help="consider these pages only, format: 1,5-7,50-N" ) ps_extract.set_defaults(func=extract_objects) # ------------------------------------------------------------------------- # 'embed-info' # ------------------------------------------------------------------------- ps_show = subps.add_parser( "embed-info", description=mycenter("list embedded files") ) ps_show.add_argument("input", help="PDF filename") ps_show.add_argument("-name", help="if given, report only this one") ps_show.add_argument("-detail", action="store_true", help="detail information") ps_show.add_argument("-password", help="password") ps_show.set_defaults(func=embedded_list) # ------------------------------------------------------------------------- # 'embed-add' command # ------------------------------------------------------------------------- ps_embed_add = subps.add_parser( "embed-add", description=mycenter("add embedded file") ) ps_embed_add.add_argument("input", help="PDF filename") ps_embed_add.add_argument("-password", help="password") ps_embed_add.add_argument( "-output", help="output PDF filename, incremental save if none" ) ps_embed_add.add_argument("-name", required=True, help="name of new entry") ps_embed_add.add_argument("-path", required=True, help="path to data for new entry") ps_embed_add.add_argument("-desc", help="description of new entry") ps_embed_add.set_defaults(func=embedded_add) # ------------------------------------------------------------------------- # 'embed-del' command # ------------------------------------------------------------------------- ps_embed_del = subps.add_parser( "embed-del", description=mycenter("delete embedded file") ) ps_embed_del.add_argument("input", help="PDF filename") ps_embed_del.add_argument("-password", help="password") ps_embed_del.add_argument( "-output", help="output PDF filename, incremental save if none" ) ps_embed_del.add_argument("-name", required=True, help="name of entry to delete") ps_embed_del.set_defaults(func=embedded_del) # ------------------------------------------------------------------------- # 'embed-upd' command # ------------------------------------------------------------------------- ps_embed_upd = subps.add_parser( "embed-upd", description=mycenter("update embedded file"), epilog="except '-name' all parameters are optional", ) ps_embed_upd.add_argument("input", help="PDF filename") ps_embed_upd.add_argument("-name", required=True, help="name of entry") ps_embed_upd.add_argument("-password", help="password") ps_embed_upd.add_argument( "-output", help="Output PDF filename, incremental save if none" ) ps_embed_upd.add_argument("-path", help="path to new data for entry") ps_embed_upd.add_argument("-filename", help="new filename to store in entry") ps_embed_upd.add_argument( "-ufilename", help="new unicode filename to store in entry" ) ps_embed_upd.add_argument("-desc", help="new description to store in entry") ps_embed_upd.set_defaults(func=embedded_upd) # ------------------------------------------------------------------------- # 'embed-extract' command # ------------------------------------------------------------------------- ps_embed_extract = subps.add_parser( "embed-extract", description=mycenter("extract embedded file to disk") ) ps_embed_extract.add_argument("input", type=str, help="PDF filename") ps_embed_extract.add_argument("-name", required=True, help="name of entry") ps_embed_extract.add_argument("-password", help="password") ps_embed_extract.add_argument("-unsafe", default=False, action="store_true", help="allow write to stored name even if an existing file or outside current directory" ) ps_embed_extract.add_argument( "-output", help="output filename, default is stored name" ) ps_embed_extract.set_defaults(func=embedded_get) # ------------------------------------------------------------------------- # 'embed-copy' command # ------------------------------------------------------------------------- ps_embed_copy = subps.add_parser( "embed-copy", description=mycenter("copy embedded files between PDFs") ) ps_embed_copy.add_argument("input", type=str, help="PDF to receive embedded files") ps_embed_copy.add_argument("-password", help="password of input") ps_embed_copy.add_argument( "-output", help="output PDF, incremental save to 'input' if omitted" ) ps_embed_copy.add_argument( "-source", required=True, help="copy embedded files from here" ) ps_embed_copy.add_argument("-pwdsource", help="password of 'source' PDF") ps_embed_copy.add_argument( "-name", nargs="*", help="restrict copy to these entries" ) ps_embed_copy.set_defaults(func=embedded_copy) # ------------------------------------------------------------------------- # 'textlayout' command # ------------------------------------------------------------------------- ps_gettext = subps.add_parser( "gettext", description=mycenter("extract text in various formatting modes") ) ps_gettext.add_argument("input", type=str, help="input document filename") ps_gettext.add_argument("-password", help="password for input document") ps_gettext.add_argument( "-mode", type=str, help="mode: simple, block sort, or layout (default)", choices=("simple", "blocks", "layout"), default="layout", ) ps_gettext.add_argument( "-pages", type=str, help="select pages, format: 1,5-7,50-N", default="1-N", ) ps_gettext.add_argument( "-noligatures", action="store_true", help="expand ligature characters (default False)", default=False, ) ps_gettext.add_argument( "-convert-white", action="store_true", help="convert whitespace characters to white (default False)", default=False, ) ps_gettext.add_argument( "-extra-spaces", action="store_true", help="fill gaps with spaces (default False)", default=False, ) ps_gettext.add_argument( "-noformfeed", action="store_true", help="write linefeeds, no formfeeds (default False)", default=False, ) ps_gettext.add_argument( "-skip-empty", action="store_true", help="suppress pages with no text (default False)", default=False, ) ps_gettext.add_argument( "-output", help="store text in this file (default inputfilename.txt)", ) ps_gettext.add_argument( "-grid", type=float, help="merge lines if closer than this (default 2)", default=2, ) ps_gettext.add_argument( "-fontsize", type=float, help="only include text with a larger fontsize (default 3)", default=3, ) ps_gettext.set_defaults(func=gettext) # ------------------------------------------------------------------------- # '_internal' command # ------------------------------------------------------------------------- ps_internal = subps.add_parser( "internal", description=mycenter("internal testing") ) ps_internal.set_defaults(func=_internal) # ------------------------------------------------------------------------- # start program # ------------------------------------------------------------------------- args = parser.parse_args() # create parameter arguments class if not hasattr(args, "func"): # no function selected parser.print_help() # so print top level help else: args.func(args) # execute requested command if __name__ == "__main__": main() ================================================ FILE: src/_apply_pages.py ================================================ import multiprocessing import os import time import pymupdf # Support for concurrent processing of document pages. # class _worker_State: pass _worker_state = _worker_State() def _worker_init( path, initfn, initfn_args, initfn_kwargs, pagefn, pagefn_args, pagefn_kwargs, stats, ): # pylint: disable=attribute-defined-outside-init _worker_state.path = path _worker_state.pagefn = pagefn _worker_state.pagefn_args = pagefn_args _worker_state.pagefn_kwargs = pagefn_kwargs _worker_state.stats = stats _worker_state.document = None if initfn: initfn(*initfn_args, **initfn_kwargs) def _stats_write(t, label): t = time.time() - t if t >= 10: pymupdf.log(f'{os.getpid()=}: {t:2f}s: {label}.') # pylint: disable=c-extension-no-member def _worker_fn(page_number): # Create Document from filename if we haven't already done so. if not _worker_state.document: if _worker_state.stats: t = time.time() _worker_state.document = pymupdf.Document(_worker_state.path) # pylint: disable=c-extension-no-member,attribute-defined-outside-init if _worker_state.stats: _stats_write(t, 'pymupdf.Document()') if _worker_state.stats: t = time.time() page = _worker_state.document[page_number] if _worker_state.stats: _stats_write(t, '_worker_state.document[page_number]') if _worker_state.stats: t = time.time() ret = _worker_state.pagefn( page, *_worker_state.pagefn_args, **_worker_state.pagefn_kwargs, ) if _worker_state.stats: _stats_write(t, '_worker_state.pagefn()') return ret def _multiprocessing( path, pages, pagefn, pagefn_args, pagefn_kwargs, initfn, initfn_args, initfn_kwargs, concurrency, stats, ): #print(f'_worker_mp(): {concurrency=}', flush=1) with multiprocessing.Pool( concurrency, _worker_init, ( path, initfn, initfn_args, initfn_kwargs, pagefn, pagefn_args, pagefn_kwargs, stats, ), ) as pool: result = pool.map_async(_worker_fn, pages) return result.get() def _fork( path, pages, pagefn, pagefn_args, pagefn_kwargs, initfn, initfn_args, initfn_kwargs, concurrency, stats, ): verbose = 0 if concurrency is None: concurrency = multiprocessing.cpu_count() # We write page numbers to `queue_down` and read `(page_num, text)` from # `queue_up`. Workers each repeatedly read the next available page number # from `queue_down`, extract the text and write it onto `queue_up`. # # This is better than pre-allocating a subset of pages to each worker # because it ensures there will never be idle workers until we are near the # end with fewer pages left than workers. # queue_down = multiprocessing.Queue() queue_up = multiprocessing.Queue() def childfn(): document = None if verbose: pymupdf.log(f'{os.getpid()=}: {initfn=} {initfn_args=}') _worker_init( path, initfn, initfn_args, initfn_kwargs, pagefn, pagefn_args, pagefn_kwargs, stats, ) while 1: if verbose: pymupdf.log(f'{os.getpid()=}: calling get().') page_num = queue_down.get() if verbose: pymupdf.log(f'{os.getpid()=}: {page_num=}.') if page_num is None: break try: if not document: if stats: t = time.time() document = pymupdf.Document(path) # pylint: disable=c-extension-no-member if stats: _stats_write(t, 'pymupdf.Document(path)') if stats: t = time.time() page = document[page_num] if stats: _stats_write(t, 'document[page_num]') if verbose: pymupdf.log(f'{os.getpid()=}: {_worker_state=}') if stats: t = time.time() ret = pagefn( page, *_worker_state.pagefn_args, **_worker_state.pagefn_kwargs, ) if stats: _stats_write(t, f'{page_num=} pagefn()') except Exception as e: if verbose: pymupdf.log(f'{os.getpid()=}: exception {e=}') ret = e if verbose: pymupdf.log(f'{os.getpid()=}: sending {page_num=} {ret=}') queue_up.put( (page_num, ret) ) error = None pids = list() try: # Start child processes. if stats: t = time.time() for i in range(concurrency): p = os.fork() # pylint: disable=no-member if p == 0: # Child process. try: try: childfn() except Exception as e: pymupdf.log(f'{os.getpid()=}: childfn() => {e=}') # pylint: disable=c-extension-no-member raise finally: if verbose: pymupdf.log(f'{os.getpid()=}: calling os._exit(0)') os._exit(0) pids.append(p) if stats: _stats_write(t, 'create child processes') # Send page numbers. if stats: t = time.time() if verbose: pymupdf.log(f'Sending page numbers.') for page_num in range(len(pages)): queue_down.put(page_num) if stats: _stats_write(t, 'Send page numbers') # Collect results. We give up if any worker sends an exception instead # of text, but this hasn't been tested. ret = [None] * len(pages) for i in range(len(pages)): page_num, text = queue_up.get() if verbose: pymupdf.log(f'{page_num=} {len(text)=}') assert ret[page_num] is None if isinstance(text, Exception): if not error: error = text break ret[page_num] = text # Close queue. This should cause exception in workers and terminate # them, but on macos-arm64 this does not seem to happen, so we also # send None, which makes workers terminate. for i in range(concurrency): queue_down.put(None) if verbose: pymupdf.log(f'Closing queues.') queue_down.close() if error: raise error if verbose: pymupdf.log(f'After concurrent, returning {len(ret)=}') return ret finally: # Join all child processes. if stats: t = time.time() for pid in pids: if verbose: pymupdf.log(f'waiting for {pid=}.') e = os.waitpid(pid, 0) if verbose: pymupdf.log(f'{pid=} => {e=}') if stats: _stats_write(t, 'Join all child proceses') ================================================ FILE: src/_wxcolors.py ================================================ _wxcolors = [ ("ALICEBLUE", 240, 248, 255), ("ANTIQUEWHITE", 250, 235, 215), ("ANTIQUEWHITE1", 255, 239, 219), ("ANTIQUEWHITE2", 238, 223, 204), ("ANTIQUEWHITE3", 205, 192, 176), ("ANTIQUEWHITE4", 139, 131, 120), ("AQUA", 0, 255, 255), ("AQUAMARINE", 127, 255, 212), ("AQUAMARINE1", 127, 255, 212), ("AQUAMARINE2", 118, 238, 198), ("AQUAMARINE3", 102, 205, 170), ("AQUAMARINE4", 69, 139, 116), ("AZURE", 240, 255, 255), ("AZURE1", 240, 255, 255), ("AZURE2", 224, 238, 238), ("AZURE3", 193, 205, 205), ("AZURE4", 131, 139, 139), ("BEIGE", 245, 245, 220), ("BISQUE", 255, 228, 196), ("BISQUE1", 255, 228, 196), ("BISQUE2", 238, 213, 183), ("BISQUE3", 205, 183, 158), ("BISQUE4", 139, 125, 107), ("BLACK", 0, 0, 0), ("BLANCHEDALMOND", 255, 235, 205), ("BLUE", 0, 0, 255), ("BLUE1", 0, 0, 255), ("BLUE2", 0, 0, 238), ("BLUE3", 0, 0, 205), ("BLUE4", 0, 0, 139), ("BLUEVIOLET", 138, 43, 226), ("BROWN", 165, 42, 42), ("BROWN1", 255, 64, 64), ("BROWN2", 238, 59, 59), ("BROWN3", 205, 51, 51), ("BROWN4", 139, 35, 35), ("BURLYWOOD", 222, 184, 135), ("BURLYWOOD1", 255, 211, 155), ("BURLYWOOD2", 238, 197, 145), ("BURLYWOOD3", 205, 170, 125), ("BURLYWOOD4", 139, 115, 85), ("CADETBLUE", 95, 158, 160), ("CADETBLUE1", 152, 245, 255), ("CADETBLUE2", 142, 229, 238), ("CADETBLUE3", 122, 197, 205), ("CADETBLUE4", 83, 134, 139), ("CHARTREUSE", 127, 255, 0), ("CHARTREUSE1", 127, 255, 0), ("CHARTREUSE2", 118, 238, 0), ("CHARTREUSE3", 102, 205, 0), ("CHARTREUSE4", 69, 139, 0), ("CHOCOLATE", 210, 105, 30), ("CHOCOLATE1", 255, 127, 36), ("CHOCOLATE2", 238, 118, 33), ("CHOCOLATE3", 205, 102, 29), ("CHOCOLATE4", 139, 69, 19), ("COFFEE", 156, 79, 0), ("CORAL", 255, 127, 80), ("CORAL1", 255, 114, 86), ("CORAL2", 238, 106, 80), ("CORAL3", 205, 91, 69), ("CORAL4", 139, 62, 47), ("CORNFLOWERBLUE", 100, 149, 237), ("CORNSILK", 255, 248, 220), ("CORNSILK1", 255, 248, 220), ("CORNSILK2", 238, 232, 205), ("CORNSILK3", 205, 200, 177), ("CORNSILK4", 139, 136, 120), ("CRIMSON", 220, 20, 60), ("CYAN", 0, 255, 255), ("CYAN1", 0, 255, 255), ("CYAN2", 0, 238, 238), ("CYAN3", 0, 205, 205), ("CYAN4", 0, 139, 139), ("DARKBLUE", 0, 0, 139), ("DARKCYAN", 0, 139, 139), ("DARKGOLDENROD", 184, 134, 11), ("DARKGOLDENROD1", 255, 185, 15), ("DARKGOLDENROD2", 238, 173, 14), ("DARKGOLDENROD3", 205, 149, 12), ("DARKGOLDENROD4", 139, 101, 8), ("DARKGRAY", 169, 169, 169), ("DARKGREEN", 0, 100, 0), ("DARKGREY", 169, 169, 169), ("DARKKHAKI", 189, 183, 107), ("DARKMAGENTA", 139, 0, 139), ("DARKOLIVEGREEN", 85, 107, 47), ("DARKOLIVEGREEN1", 202, 255, 112), ("DARKOLIVEGREEN2", 188, 238, 104), ("DARKOLIVEGREEN3", 162, 205, 90), ("DARKOLIVEGREEN4", 110, 139, 61), ("DARKORANGE", 255, 140, 0), ("DARKORANGE1", 255, 127, 0), ("DARKORANGE2", 238, 118, 0), ("DARKORANGE3", 205, 102, 0), ("DARKORANGE4", 139, 69, 0), ("DARKORCHID", 153, 50, 204), ("DARKORCHID1", 191, 62, 255), ("DARKORCHID2", 178, 58, 238), ("DARKORCHID3", 154, 50, 205), ("DARKORCHID4", 104, 34, 139), ("DARKRED", 139, 0, 0), ("DARKSALMON", 233, 150, 122), ("DARKSEAGREEN", 143, 188, 143), ("DARKSEAGREEN1", 193, 255, 193), ("DARKSEAGREEN2", 180, 238, 180), ("DARKSEAGREEN3", 155, 205, 155), ("DARKSEAGREEN4", 105, 139, 105), ("DARKSLATEBLUE", 72, 61, 139), ("DARKSLATEGRAY", 47, 79, 79), ("DARKSLATEGREY", 47, 79, 79), ("DARKTURQUOISE", 0, 206, 209), ("DARKVIOLET", 148, 0, 211), ("DEEPPINK", 255, 20, 147), ("DEEPPINK1", 255, 20, 147), ("DEEPPINK2", 238, 18, 137), ("DEEPPINK3", 205, 16, 118), ("DEEPPINK4", 139, 10, 80), ("DEEPSKYBLUE", 0, 191, 255), ("DEEPSKYBLUE1", 0, 191, 255), ("DEEPSKYBLUE2", 0, 178, 238), ("DEEPSKYBLUE3", 0, 154, 205), ("DEEPSKYBLUE4", 0, 104, 139), ("DIMGRAY", 105, 105, 105), ("DIMGREY", 105, 105, 105), ("DODGERBLUE", 30, 144, 255), ("DODGERBLUE1", 30, 144, 255), ("DODGERBLUE2", 28, 134, 238), ("DODGERBLUE3", 24, 116, 205), ("DODGERBLUE4", 16, 78, 139), ("FIREBRICK", 178, 34, 34), ("FIREBRICK1", 255, 48, 48), ("FIREBRICK2", 238, 44, 44), ("FIREBRICK3", 205, 38, 38), ("FIREBRICK4", 139, 26, 26), ("FLORALWHITE", 255, 250, 240), ("FORESTGREEN", 34, 139, 34), ("FUCHSIA", 255, 0, 255), ("GAINSBORO", 220, 220, 220), ("GHOSTWHITE", 248, 248, 255), ("GOLD", 255, 215, 0), ("GOLD1", 255, 215, 0), ("GOLD2", 238, 201, 0), ("GOLD3", 205, 173, 0), ("GOLD4", 139, 117, 0), ("GOLDENROD", 218, 165, 32), ("GOLDENROD1", 255, 193, 37), ("GOLDENROD2", 238, 180, 34), ("GOLDENROD3", 205, 155, 29), ("GOLDENROD4", 139, 105, 20), ("GRAY", 190, 190, 190), ("GRAY0", 0, 0, 0), ("GRAY1", 3, 3, 3), ("GRAY10", 26, 26, 26), ("GRAY100", 255, 255, 255), ("GRAY11", 28, 28, 28), ("GRAY12", 31, 31, 31), ("GRAY13", 33, 33, 33), ("GRAY14", 36, 36, 36), ("GRAY15", 38, 38, 38), ("GRAY16", 41, 41, 41), ("GRAY17", 43, 43, 43), ("GRAY18", 46, 46, 46), ("GRAY19", 48, 48, 48), ("GRAY2", 5, 5, 5), ("GRAY20", 51, 51, 51), ("GRAY21", 54, 54, 54), ("GRAY22", 56, 56, 56), ("GRAY23", 59, 59, 59), ("GRAY24", 61, 61, 61), ("GRAY25", 64, 64, 64), ("GRAY26", 66, 66, 66), ("GRAY27", 69, 69, 69), ("GRAY28", 71, 71, 71), ("GRAY29", 74, 74, 74), ("GRAY3", 8, 8, 8), ("GRAY30", 77, 77, 77), ("GRAY31", 79, 79, 79), ("GRAY32", 82, 82, 82), ("GRAY33", 84, 84, 84), ("GRAY34", 87, 87, 87), ("GRAY35", 89, 89, 89), ("GRAY36", 92, 92, 92), ("GRAY37", 94, 94, 94), ("GRAY38", 97, 97, 97), ("GRAY39", 99, 99, 99), ("GRAY4", 10, 10, 10), ("GRAY40", 102, 102, 102), ("GRAY41", 105, 105, 105), ("GRAY42", 107, 107, 107), ("GRAY43", 110, 110, 110), ("GRAY44", 112, 112, 112), ("GRAY45", 115, 115, 115), ("GRAY46", 117, 117, 117), ("GRAY47", 120, 120, 120), ("GRAY48", 122, 122, 122), ("GRAY49", 125, 125, 125), ("GRAY5", 13, 13, 13), ("GRAY50", 127, 127, 127), ("GRAY51", 130, 130, 130), ("GRAY52", 133, 133, 133), ("GRAY53", 135, 135, 135), ("GRAY54", 138, 138, 138), ("GRAY55", 140, 140, 140), ("GRAY56", 143, 143, 143), ("GRAY57", 145, 145, 145), ("GRAY58", 148, 148, 148), ("GRAY59", 150, 150, 150), ("GRAY6", 15, 15, 15), ("GRAY60", 153, 153, 153), ("GRAY61", 156, 156, 156), ("GRAY62", 158, 158, 158), ("GRAY63", 161, 161, 161), ("GRAY64", 163, 163, 163), ("GRAY65", 166, 166, 166), ("GRAY66", 168, 168, 168), ("GRAY67", 171, 171, 171), ("GRAY68", 173, 173, 173), ("GRAY69", 176, 176, 176), ("GRAY7", 18, 18, 18), ("GRAY70", 179, 179, 179), ("GRAY71", 181, 181, 181), ("GRAY72", 184, 184, 184), ("GRAY73", 186, 186, 186), ("GRAY74", 189, 189, 189), ("GRAY75", 191, 191, 191), ("GRAY76", 194, 194, 194), ("GRAY77", 196, 196, 196), ("GRAY78", 199, 199, 199), ("GRAY79", 201, 201, 201), ("GRAY8", 20, 20, 20), ("GRAY80", 204, 204, 204), ("GRAY81", 207, 207, 207), ("GRAY82", 209, 209, 209), ("GRAY83", 212, 212, 212), ("GRAY84", 214, 214, 214), ("GRAY85", 217, 217, 217), ("GRAY86", 219, 219, 219), ("GRAY87", 222, 222, 222), ("GRAY88", 224, 224, 224), ("GRAY89", 227, 227, 227), ("GRAY9", 23, 23, 23), ("GRAY90", 229, 229, 229), ("GRAY91", 232, 232, 232), ("GRAY92", 235, 235, 235), ("GRAY93", 237, 237, 237), ("GRAY94", 240, 240, 240), ("GRAY95", 242, 242, 242), ("GRAY96", 245, 245, 245), ("GRAY97", 247, 247, 247), ("GRAY98", 250, 250, 250), ("GRAY99", 252, 252, 252), ("GREEN YELLOW", 173, 255, 47), ("GREEN", 0, 255, 0), ("GREEN1", 0, 255, 0), ("GREEN2", 0, 238, 0), ("GREEN3", 0, 205, 0), ("GREEN4", 0, 139, 0), ("GREENYELLOW", 173, 255, 47), ("GREY", 128, 128, 128), ("HONEYDEW", 240, 255, 240), ("HONEYDEW1", 240, 255, 240), ("HONEYDEW2", 224, 238, 224), ("HONEYDEW3", 193, 205, 193), ("HONEYDEW4", 131, 139, 131), ("HOTPINK", 255, 105, 180), ("HOTPINK1", 255, 110, 180), ("HOTPINK2", 238, 106, 167), ("HOTPINK3", 205, 96, 144), ("HOTPINK4", 139, 58, 98), ("INDIANRED", 205, 92, 92), ("INDIANRED1", 255, 106, 106), ("INDIANRED2", 238, 99, 99), ("INDIANRED3", 205, 85, 85), ("INDIANRED4", 139, 58, 58), ("INDIGO", 75, 0, 130), ("IVORY", 255, 255, 240), ("IVORY1", 255, 255, 240), ("IVORY2", 238, 238, 224), ("IVORY3", 205, 205, 193), ("IVORY4", 139, 139, 131), ("KHAKI", 240, 230, 140), ("KHAKI1", 255, 246, 143), ("KHAKI2", 238, 230, 133), ("KHAKI3", 205, 198, 115), ("KHAKI4", 139, 134, 78), ("LAVENDER", 230, 230, 250), ("LAVENDERBLUSH", 255, 240, 245), ("LAVENDERBLUSH1", 255, 240, 245), ("LAVENDERBLUSH2", 238, 224, 229), ("LAVENDERBLUSH3", 205, 193, 197), ("LAVENDERBLUSH4", 139, 131, 134), ("LAWNGREEN", 124, 252, 0), ("LEMONCHIFFON", 255, 250, 205), ("LEMONCHIFFON1", 255, 250, 205), ("LEMONCHIFFON2", 238, 233, 191), ("LEMONCHIFFON3", 205, 201, 165), ("LEMONCHIFFON4", 139, 137, 112), ("LIGHTBLUE", 173, 216, 230), ("LIGHTBLUE1", 191, 239, 255), ("LIGHTBLUE2", 178, 223, 238), ("LIGHTBLUE3", 154, 192, 205), ("LIGHTBLUE4", 104, 131, 139), ("LIGHTCORAL", 240, 128, 128), ("LIGHTCYAN", 224, 255, 255), ("LIGHTCYAN1", 224, 255, 255), ("LIGHTCYAN2", 209, 238, 238), ("LIGHTCYAN3", 180, 205, 205), ("LIGHTCYAN4", 122, 139, 139), ("LIGHTGOLDENROD", 238, 221, 130), ("LIGHTGOLDENROD1", 255, 236, 139), ("LIGHTGOLDENROD2", 238, 220, 130), ("LIGHTGOLDENROD3", 205, 190, 112), ("LIGHTGOLDENROD4", 139, 129, 76), ("LIGHTGOLDENRODYELLOW", 250, 250, 210), ("LIGHTGRAY", 211, 211, 211), ("LIGHTGREEN", 144, 238, 144), ("LIGHTGREY", 211, 211, 211), ("LIGHTPINK", 255, 182, 193), ("LIGHTPINK1", 255, 174, 185), ("LIGHTPINK2", 238, 162, 173), ("LIGHTPINK3", 205, 140, 149), ("LIGHTPINK4", 139, 95, 101), ("LIGHTSALMON", 255, 160, 122), ("LIGHTSALMON1", 255, 160, 122), ("LIGHTSALMON2", 238, 149, 114), ("LIGHTSALMON3", 205, 129, 98), ("LIGHTSALMON4", 139, 87, 66), ("LIGHTSEAGREEN", 32, 178, 170), ("LIGHTSKYBLUE", 135, 206, 250), ("LIGHTSKYBLUE1", 176, 226, 255), ("LIGHTSKYBLUE2", 164, 211, 238), ("LIGHTSKYBLUE3", 141, 182, 205), ("LIGHTSKYBLUE4", 96, 123, 139), ("LIGHTSLATEBLUE", 132, 112, 255), ("LIGHTSLATEGRAY", 119, 136, 153), ("LIGHTSLATEGREY", 119, 136, 153), ("LIGHTSTEELBLUE", 176, 196, 222), ("LIGHTSTEELBLUE1", 202, 225, 255), ("LIGHTSTEELBLUE2", 188, 210, 238), ("LIGHTSTEELBLUE3", 162, 181, 205), ("LIGHTSTEELBLUE4", 110, 123, 139), ("LIGHTYELLOW", 255, 255, 224), ("LIGHTYELLOW1", 255, 255, 224), ("LIGHTYELLOW2", 238, 238, 209), ("LIGHTYELLOW3", 205, 205, 180), ("LIGHTYELLOW4", 139, 139, 122), ("LIME", 0, 255, 0), ("LIMEGREEN", 50, 205, 50), ("LINEN", 250, 240, 230), ("MAGENTA", 255, 0, 255), ("MAGENTA1", 255, 0, 255), ("MAGENTA2", 238, 0, 238), ("MAGENTA3", 205, 0, 205), ("MAGENTA4", 139, 0, 139), ("MAROON", 176, 48, 96), ("MAROON1", 255, 52, 179), ("MAROON2", 238, 48, 167), ("MAROON3", 205, 41, 144), ("MAROON4", 139, 28, 98), ("MEDIUMAQUAMARINE", 102, 205, 170), ("MEDIUMBLUE", 0, 0, 205), ("MEDIUMORCHID", 186, 85, 211), ("MEDIUMORCHID1", 224, 102, 255), ("MEDIUMORCHID2", 209, 95, 238), ("MEDIUMORCHID3", 180, 82, 205), ("MEDIUMORCHID4", 122, 55, 139), ("MEDIUMPURPLE", 147, 112, 219), ("MEDIUMPURPLE1", 171, 130, 255), ("MEDIUMPURPLE2", 159, 121, 238), ("MEDIUMPURPLE3", 137, 104, 205), ("MEDIUMPURPLE4", 93, 71, 139), ("MEDIUMSEAGREEN", 60, 179, 113), ("MEDIUMSLATEBLUE", 123, 104, 238), ("MEDIUMSPRINGGREEN", 0, 250, 154), ("MEDIUMTURQUOISE", 72, 209, 204), ("MEDIUMVIOLETRED", 199, 21, 133), ("MIDNIGHTBLUE", 25, 25, 112), ("MINTCREAM", 245, 255, 250), ("MISTYROSE", 255, 228, 225), ("MISTYROSE1", 255, 228, 225), ("MISTYROSE2", 238, 213, 210), ("MISTYROSE3", 205, 183, 181), ("MISTYROSE4", 139, 125, 123), ("MOCCASIN", 255, 228, 181), ("MUPDFBLUE", 37, 114, 172), ("NAVAJOWHITE", 255, 222, 173), ("NAVAJOWHITE1", 255, 222, 173), ("NAVAJOWHITE2", 238, 207, 161), ("NAVAJOWHITE3", 205, 179, 139), ("NAVAJOWHITE4", 139, 121, 94), ("NAVY", 0, 0, 128), ("NAVYBLUE", 0, 0, 128), ("OLDLACE", 253, 245, 230), ("OLIVE", 128, 128, 0), ("OLIVEDRAB", 107, 142, 35), ("OLIVEDRAB1", 192, 255, 62), ("OLIVEDRAB2", 179, 238, 58), ("OLIVEDRAB3", 154, 205, 50), ("OLIVEDRAB4", 105, 139, 34), ("ORANGE", 255, 165, 0), ("ORANGE1", 255, 165, 0), ("ORANGE2", 238, 154, 0), ("ORANGE3", 205, 133, 0), ("ORANGE4", 139, 90, 0), ("ORANGERED", 255, 69, 0), ("ORANGERED1", 255, 69, 0), ("ORANGERED2", 238, 64, 0), ("ORANGERED3", 205, 55, 0), ("ORANGERED4", 139, 37, 0), ("ORCHID", 218, 112, 214), ("ORCHID1", 255, 131, 250), ("ORCHID2", 238, 122, 233), ("ORCHID3", 205, 105, 201), ("ORCHID4", 139, 71, 137), ("PALEGOLDENROD", 238, 232, 170), ("PALEGREEN", 152, 251, 152), ("PALEGREEN1", 154, 255, 154), ("PALEGREEN2", 144, 238, 144), ("PALEGREEN3", 124, 205, 124), ("PALEGREEN4", 84, 139, 84), ("PALETURQUOISE", 175, 238, 238), ("PALETURQUOISE1", 187, 255, 255), ("PALETURQUOISE2", 174, 238, 238), ("PALETURQUOISE3", 150, 205, 205), ("PALETURQUOISE4", 102, 139, 139), ("PALEVIOLETRED", 219, 112, 147), ("PALEVIOLETRED1", 255, 130, 171), ("PALEVIOLETRED2", 238, 121, 159), ("PALEVIOLETRED3", 205, 104, 137), ("PALEVIOLETRED4", 139, 71, 93), ("PAPAYAWHIP", 255, 239, 213), ("PEACHPUFF", 255, 218, 185), ("PEACHPUFF1", 255, 218, 185), ("PEACHPUFF2", 238, 203, 173), ("PEACHPUFF3", 205, 175, 149), ("PEACHPUFF4", 139, 119, 101), ("PERU", 205, 133, 63), ("PINK", 255, 192, 203), ("PINK1", 255, 181, 197), ("PINK2", 238, 169, 184), ("PINK3", 205, 145, 158), ("PINK4", 139, 99, 108), ("PLUM", 221, 160, 221), ("PLUM1", 255, 187, 255), ("PLUM2", 238, 174, 238), ("PLUM3", 205, 150, 205), ("PLUM4", 139, 102, 139), ("POWDERBLUE", 176, 224, 230), ("PURPLE", 160, 32, 240), ("PURPLE1", 155, 48, 255), ("PURPLE2", 145, 44, 238), ("PURPLE3", 125, 38, 205), ("PURPLE4", 85, 26, 139), ("PY_COLOR", 240, 255, 210), ("RED", 255, 0, 0), ("RED1", 255, 0, 0), ("RED2", 238, 0, 0), ("RED3", 205, 0, 0), ("RED4", 139, 0, 0), ("ROSYBROWN", 188, 143, 143), ("ROSYBROWN1", 255, 193, 193), ("ROSYBROWN2", 238, 180, 180), ("ROSYBROWN3", 205, 155, 155), ("ROSYBROWN4", 139, 105, 105), ("ROYALBLUE", 65, 105, 225), ("ROYALBLUE1", 72, 118, 255), ("ROYALBLUE2", 67, 110, 238), ("ROYALBLUE3", 58, 95, 205), ("ROYALBLUE4", 39, 64, 139), ("SADDLEBROWN", 139, 69, 19), ("SALMON", 250, 128, 114), ("SALMON1", 255, 140, 105), ("SALMON2", 238, 130, 98), ("SALMON3", 205, 112, 84), ("SALMON4", 139, 76, 57), ("SANDYBROWN", 244, 164, 96), ("SEAGREEN", 46, 139, 87), ("SEAGREEN1", 84, 255, 159), ("SEAGREEN2", 78, 238, 148), ("SEAGREEN3", 67, 205, 128), ("SEAGREEN4", 46, 139, 87), ("SEASHELL", 255, 245, 238), ("SEASHELL1", 255, 245, 238), ("SEASHELL2", 238, 229, 222), ("SEASHELL3", 205, 197, 191), ("SEASHELL4", 139, 134, 130), ("SIENNA", 160, 82, 45), ("SIENNA1", 255, 130, 71), ("SIENNA2", 238, 121, 66), ("SIENNA3", 205, 104, 57), ("SIENNA4", 139, 71, 38), ("SILVER", 192, 192, 192), ("SKYBLUE", 135, 206, 235), ("SKYBLUE1", 135, 206, 255), ("SKYBLUE2", 126, 192, 238), ("SKYBLUE3", 108, 166, 205), ("SKYBLUE4", 74, 112, 139), ("SLATEBLUE", 106, 90, 205), ("SLATEBLUE1", 131, 111, 255), ("SLATEBLUE2", 122, 103, 238), ("SLATEBLUE3", 105, 89, 205), ("SLATEBLUE4", 71, 60, 139), ("SLATEGRAY", 112, 128, 144), ("SLATEGREY", 112, 128, 144), ("SNOW", 255, 250, 250), ("SNOW1", 255, 250, 250), ("SNOW2", 238, 233, 233), ("SNOW3", 205, 201, 201), ("SNOW4", 139, 137, 137), ("SPRINGGREEN", 0, 255, 127), ("SPRINGGREEN1", 0, 255, 127), ("SPRINGGREEN2", 0, 238, 118), ("SPRINGGREEN3", 0, 205, 102), ("SPRINGGREEN4", 0, 139, 69), ("STEELBLUE", 70, 130, 180), ("STEELBLUE1", 99, 184, 255), ("STEELBLUE2", 92, 172, 238), ("STEELBLUE3", 79, 148, 205), ("STEELBLUE4", 54, 100, 139), ("TAN", 210, 180, 140), ("TAN1", 255, 165, 79), ("TAN2", 238, 154, 73), ("TAN3", 205, 133, 63), ("TAN4", 139, 90, 43), ("TEAL", 0, 128, 128), ("THISTLE", 216, 191, 216), ("THISTLE1", 255, 225, 255), ("THISTLE2", 238, 210, 238), ("THISTLE3", 205, 181, 205), ("THISTLE4", 139, 123, 139), ("TOMATO", 255, 99, 71), ("TOMATO1", 255, 99, 71), ("TOMATO2", 238, 92, 66), ("TOMATO3", 205, 79, 57), ("TOMATO4", 139, 54, 38), ("TURQUOISE", 64, 224, 208), ("TURQUOISE1", 0, 245, 255), ("TURQUOISE2", 0, 229, 238), ("TURQUOISE3", 0, 197, 205), ("TURQUOISE4", 0, 134, 139), ("VIOLET", 238, 130, 238), ("VIOLETRED", 208, 32, 144), ("VIOLETRED1", 255, 62, 150), ("VIOLETRED2", 238, 58, 140), ("VIOLETRED3", 205, 50, 120), ("VIOLETRED4", 139, 34, 82), ("WHEAT", 245, 222, 179), ("WHEAT1", 255, 231, 186), ("WHEAT2", 238, 216, 174), ("WHEAT3", 205, 186, 150), ("WHEAT4", 139, 126, 102), ("WHITE", 255, 255, 255), ("WHITESMOKE", 245, 245, 245), ("YELLOW", 255, 255, 0), ("YELLOW1", 255, 255, 0), ("YELLOW2", 238, 238, 0), ("YELLOW3", 205, 205, 0), ("YELLOW4", 139, 139, 0), ("YELLOWGREEN", 154, 205, 50), ] ================================================ FILE: src/extra.i ================================================ %pythoncode %{ # pylint: disable=all %} %begin %{ #define SWIG_PYTHON_INTERPRETER_NO_DEBUG /* This seems to be necessary on some Windows machines with Py_LIMITED_API, otherwise compilation can fail because free() and malloc() are not declared. */ #include %} %init %{ /* Initialise some globals that require Python functions. [Prior to 2023-08-18 we initialised these global variables inline, but this causes a SEGV on Windows with Python-3.10 for `dictkey_c` (actually any string of length 1 failed).] */ dictkey_align = PyUnicode_InternFromString("align"); dictkey_ascender = PyUnicode_InternFromString("ascender"); dictkey_bidi = PyUnicode_InternFromString("bidi"); dictkey_bbox = PyUnicode_InternFromString("bbox"); dictkey_blocks = PyUnicode_InternFromString("blocks"); dictkey_bpc = PyUnicode_InternFromString("bpc"); dictkey_c = PyUnicode_InternFromString("c"); dictkey_chars = PyUnicode_InternFromString("chars"); dictkey_color = PyUnicode_InternFromString("color"); dictkey_colorspace = PyUnicode_InternFromString("colorspace"); dictkey_content = PyUnicode_InternFromString("content"); dictkey_creationDate = PyUnicode_InternFromString("creationDate"); dictkey_cs_name = PyUnicode_InternFromString("cs-name"); dictkey_da = PyUnicode_InternFromString("da"); dictkey_dashes = PyUnicode_InternFromString("dashes"); dictkey_desc = PyUnicode_InternFromString("descender"); dictkey_descender = PyUnicode_InternFromString("descender"); dictkey_dir = PyUnicode_InternFromString("dir"); dictkey_effect = PyUnicode_InternFromString("effect"); dictkey_ext = PyUnicode_InternFromString("ext"); dictkey_filename = PyUnicode_InternFromString("filename"); dictkey_fill = PyUnicode_InternFromString("fill"); dictkey_flags = PyUnicode_InternFromString("flags"); dictkey_char_flags = PyUnicode_InternFromString("char_flags"); /* Only used with mupdf >= 1.25.2. */ dictkey_font = PyUnicode_InternFromString("font"); dictkey_glyph = PyUnicode_InternFromString("glyph"); dictkey_height = PyUnicode_InternFromString("height"); dictkey_id = PyUnicode_InternFromString("id"); dictkey_image = PyUnicode_InternFromString("image"); dictkey_items = PyUnicode_InternFromString("items"); dictkey_length = PyUnicode_InternFromString("length"); dictkey_lines = PyUnicode_InternFromString("lines"); dictkey_matrix = PyUnicode_InternFromString("transform"); dictkey_modDate = PyUnicode_InternFromString("modDate"); dictkey_name = PyUnicode_InternFromString("name"); dictkey_number = PyUnicode_InternFromString("number"); dictkey_origin = PyUnicode_InternFromString("origin"); dictkey_rect = PyUnicode_InternFromString("rect"); dictkey_size = PyUnicode_InternFromString("size"); dictkey_smask = PyUnicode_InternFromString("smask"); dictkey_spans = PyUnicode_InternFromString("spans"); dictkey_stroke = PyUnicode_InternFromString("stroke"); dictkey_style = PyUnicode_InternFromString("style"); dictkey_subject = PyUnicode_InternFromString("subject"); dictkey_text = PyUnicode_InternFromString("text"); dictkey_title = PyUnicode_InternFromString("title"); dictkey_type = PyUnicode_InternFromString("type"); dictkey_ufilename = PyUnicode_InternFromString("ufilename"); dictkey_width = PyUnicode_InternFromString("width"); dictkey_wmode = PyUnicode_InternFromString("wmode"); dictkey_xref = PyUnicode_InternFromString("xref"); dictkey_xres = PyUnicode_InternFromString("xres"); dictkey_yres = PyUnicode_InternFromString("yres"); %} %include std_string.i %include exception.i %exception { try { $action } /* this might not be ok on windows. catch (Swig::DirectorException &e) { SWIG_fail; }*/ catch(std::exception& e) { SWIG_exception(SWIG_RuntimeError, e.what()); } catch(...) { SWIG_exception(SWIG_RuntimeError, "Unknown exception"); } } %{ #include "mupdf/classes2.h" #include "mupdf/exceptions.h" #include "mupdf/internal.h" #include #include #define MAKE_MUPDF_VERSION_INT(major, minor, patch) ((major << 16) + (minor << 8) + (patch << 0)) #define MUPDF_VERSION_INT MAKE_MUPDF_VERSION_INT(FZ_VERSION_MAJOR, FZ_VERSION_MINOR, FZ_VERSION_PATCH) #define MUPDF_VERSION_GE(major, minor, patch) \ MUPDF_VERSION_INT >= MAKE_MUPDF_VERSION_INT(major, minor, patch) /* Define a wrapper for PDF_NAME that returns a mupdf::PdfObj instead of a pdf_obj*. This avoids implicit construction of a mupdf::PdfObj, which is deliberately prohibited (with `explicit` on constructors) by recent MuPDF. */ #define PDF_NAME2(X) mupdf::PdfObj(PDF_NAME(X)) /* Returns equivalent of `repr(x)`. */ static std::string repr(PyObject* x) { PyObject* repr = PyObject_Repr(x); PyObject* repr_str = PyUnicode_AsEncodedString(repr, "utf-8", "~E~"); #ifdef Py_LIMITED_API const char* repr_str_s = PyBytes_AsString(repr_str); #else const char* repr_str_s = PyBytes_AS_STRING(repr_str); #endif std::string ret = repr_str_s; Py_DECREF(repr_str); Py_DECREF(repr); return ret; } #ifdef Py_LIMITED_API static PyObject* PySequence_ITEM(PyObject* o, Py_ssize_t i) { return PySequence_GetItem(o, i); } static const char* PyUnicode_AsUTF8(PyObject* o) { static PyObject* string = nullptr; Py_XDECREF(string); string = PyUnicode_AsUTF8String(o); return PyBytes_AsString(string); } #endif /* These are also in pymupdf/__init__.py. */ const char MSG_BAD_ANNOT_TYPE[] = "bad annot type"; const char MSG_BAD_APN[] = "bad or missing annot AP/N"; const char MSG_BAD_ARG_INK_ANNOT[] = "arg must be seq of seq of float pairs"; const char MSG_BAD_ARG_POINTS[] = "bad seq of points"; const char MSG_BAD_BUFFER[] = "bad type: 'buffer'"; const char MSG_BAD_COLOR_SEQ[] = "bad color sequence"; const char MSG_BAD_DOCUMENT[] = "cannot open broken document"; const char MSG_BAD_FILETYPE[] = "bad filetype"; const char MSG_BAD_LOCATION[] = "bad location"; const char MSG_BAD_OC_CONFIG[] = "bad config number"; const char MSG_BAD_OC_LAYER[] = "bad layer number"; const char MSG_BAD_OC_REF[] = "bad 'oc' reference"; const char MSG_BAD_PAGEID[] = "bad page id"; const char MSG_BAD_PAGENO[] = "bad page number(s)"; const char MSG_BAD_PDFROOT[] = "PDF has no root"; const char MSG_BAD_RECT[] = "rect is infinite or empty"; const char MSG_BAD_TEXT[] = "bad type: 'text'"; const char MSG_BAD_XREF[] = "bad xref"; const char MSG_COLOR_COUNT_FAILED[] = "color count failed"; const char MSG_FILE_OR_BUFFER[] = "need font file or buffer"; const char MSG_FONT_FAILED[] = "cannot create font"; const char MSG_IS_NO_ANNOT[] = "is no annotation"; const char MSG_IS_NO_IMAGE[] = "is no image"; const char MSG_IS_NO_PDF[] = "is no PDF"; const char MSG_IS_NO_DICT[] = "object is no PDF dict"; const char MSG_PIX_NOALPHA[] = "source pixmap has no alpha"; const char MSG_PIXEL_OUTSIDE[] = "pixel(s) outside image"; #define JM_BOOL(x) PyBool_FromLong((long) (x)) static PyObject *JM_UnicodeFromStr(const char *c); #ifdef _WIN32 /* These functions are not provided on Windows. */ int vasprintf(char** str, const char* fmt, va_list ap) { va_list ap2; va_copy(ap2, ap); int len = vsnprintf(nullptr, 0, fmt, ap2); va_end(ap2); char* buffer = (char*) malloc(len + 1); if (!buffer) { *str = nullptr; return -1; } va_copy(ap2, ap); int len2 = vsnprintf(buffer, len + 1, fmt, ap2); va_end(ap2); assert(len2 == len); *str = buffer; return len; } int asprintf(char** str, const char* fmt, ...) { va_list ap; va_start(ap, fmt); int ret = vasprintf(str, fmt, ap); va_end(ap); return ret; } #endif static void messagev(const char* format, va_list va) { static PyObject* pymupdf_module = PyImport_ImportModule("pymupdf"); static PyObject* message_fn = PyObject_GetAttrString(pymupdf_module, "message"); char* text; vasprintf(&text, format, va); PyObject* text_py = PyString_FromString(text); PyObject* args = PyTuple_Pack(1, text_py); PyObject* ret = PyObject_CallObject(message_fn, args); Py_XDECREF(ret); Py_XDECREF(args); Py_XDECREF(text_py); free(text); } static void messagef(const char* format, ...) { va_list args; va_start(args, format); messagev(format, args); va_end(args); } PyObject* JM_EscapeStrFromStr(const char* c) { if (!c) return PyUnicode_FromString(""); PyObject* val = PyUnicode_DecodeRawUnicodeEscape(c, (Py_ssize_t) strlen(c), "replace"); if (!val) { val = PyUnicode_FromString(""); PyErr_Clear(); } return val; } PyObject* JM_EscapeStrFromBuffer(fz_buffer* buff) { if (!buff) return PyUnicode_FromString(""); unsigned char* s = nullptr; size_t len = mupdf::ll_fz_buffer_storage(buff, &s); PyObject* val = PyUnicode_DecodeRawUnicodeEscape((const char*) s, (Py_ssize_t) len, "replace"); if (!val) { val = PyUnicode_FromString(""); PyErr_Clear(); } return val; } //---------------------------------------------------------------------------- // Deep-copies a source page to the target. // Modified version of function of pdfmerge.c: we also copy annotations, but // we skip some subtypes. In addition we rotate output. //---------------------------------------------------------------------------- static void page_merge( mupdf::PdfDocument& doc_des, mupdf::PdfDocument& doc_src, int page_from, int page_to, int rotate, int links, int copy_annots, mupdf::PdfGraftMap& graft_map ) { // list of object types (per page) we want to copy /* Fixme: on linux these get destructed /after/ mupdf/platform/c++/implementation/internal.cpp:s_thread_state, which causes problems - s_thread_state::m_ctx will have been freed. We have a hack that sets s_thread_state::m_ctx when destructed, so it mostly works when s_thread_state.get_context() is called after destruction, but this causes memento leaks and is clearly incorrect. Perhaps we could use pdf_obj* known_page_objs[] = {...} and create PdfObj wrappers as used - this would avoid any cleanup at exit. And it's a general solution to problem of ordering of cleanup of globals. */ static pdf_obj* known_page_objs[] = { PDF_NAME(Contents), PDF_NAME(Resources), PDF_NAME(MediaBox), PDF_NAME(CropBox), PDF_NAME(BleedBox), PDF_NAME(TrimBox), PDF_NAME(ArtBox), PDF_NAME(Rotate), PDF_NAME(UserUnit) }; int known_page_objs_num = sizeof(known_page_objs) / sizeof(known_page_objs[0]); mupdf::PdfObj page_ref = mupdf::pdf_lookup_page_obj(doc_src, page_from); // make new page dict in dest doc mupdf::PdfObj page_dict = mupdf::pdf_new_dict(doc_des, 4); mupdf::pdf_dict_put(page_dict, PDF_NAME2(Type), PDF_NAME2(Page)); for (int i = 0; i < known_page_objs_num; ++i) { mupdf::PdfObj known_page_obj(known_page_objs[i]); mupdf::PdfObj obj = mupdf::pdf_dict_get_inheritable(page_ref, known_page_obj); if (obj.m_internal) { mupdf::pdf_dict_put( page_dict, known_page_obj, mupdf::pdf_graft_mapped_object(graft_map, obj) ); } } // Copy annotations, but skip Link, Popup, IRT, Widget types // If selected, remove dict keys P (parent) and Popup if (copy_annots) { mupdf::PdfObj old_annots = mupdf::pdf_dict_get(page_ref, PDF_NAME2(Annots)); int n = mupdf::pdf_array_len(old_annots); if (n > 0) { mupdf::PdfObj new_annots = mupdf::pdf_dict_put_array(page_dict, PDF_NAME2(Annots), n); for (int i = 0; i < n; i++) { mupdf::PdfObj o = mupdf::pdf_array_get(old_annots, i); if (!o.m_internal || !mupdf::pdf_is_dict(o)) // skip non-dict items { continue; // skip invalid/null/non-dict items } if (mupdf::pdf_dict_get(o, PDF_NAME2(IRT)).m_internal) continue; mupdf::PdfObj subtype = mupdf::pdf_dict_get(o, PDF_NAME2(Subtype)); if (mupdf::pdf_name_eq(subtype, PDF_NAME2(Link))) continue; if (mupdf::pdf_name_eq(subtype, PDF_NAME2(Popup))) continue; if (mupdf::pdf_name_eq(subtype, PDF_NAME2(Widget))) continue; mupdf::pdf_dict_del(o, PDF_NAME2(Popup)); mupdf::pdf_dict_del(o, PDF_NAME2(P)); mupdf::PdfObj copy_o = mupdf::pdf_graft_mapped_object(graft_map, o); mupdf::PdfObj annot = mupdf::pdf_new_indirect( doc_des, mupdf::pdf_to_num(copy_o), 0 ); mupdf::pdf_array_push(new_annots, annot); } } } // rotate the page if (rotate != -1) { mupdf::pdf_dict_put_int(page_dict, PDF_NAME2(Rotate), rotate); } // Now add the page dictionary to dest PDF mupdf::PdfObj ref = mupdf::pdf_add_object(doc_des, page_dict); // Insert new page at specified location mupdf::pdf_insert_page(doc_des, page_to, ref); } //----------------------------------------------------------------------------- // Copy a range of pages (spage, epage) from a source PDF to a specified // location (apage) of the target PDF. // If spage > epage, the sequence of source pages is reversed. //----------------------------------------------------------------------------- static void JM_merge_range( mupdf::PdfDocument& doc_des, mupdf::PdfDocument& doc_src, int spage, int epage, int apage, int rotate, int links, int annots, int show_progress, mupdf::PdfGraftMap& graft_map ) { int afterpage = apage; int counter = 0; // copied pages counter int total = mupdf::ll_fz_absi(epage - spage) + 1; // total pages to copy if (spage < epage) { for (int page = spage; page <= epage; page++, afterpage++) { page_merge(doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map); counter++; if (show_progress > 0 && counter % show_progress == 0) { messagef("Inserted %i of %i pages.", counter, total); } } } else { for (int page = spage; page >= epage; page--, afterpage++) { page_merge(doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map); counter++; if (show_progress > 0 && counter % show_progress == 0) { messagef("Inserted %i of %i pages.", counter, total); } } } } static bool JM_have_operation(mupdf::PdfDocument& pdf) { // Ensure valid journalling state if (pdf.m_internal->journal and !mupdf::pdf_undoredo_step(pdf, 0)) { return 0; } return 1; } static void JM_ensure_operation(mupdf::PdfDocument& pdf) { if (!JM_have_operation(pdf)) { throw std::runtime_error("No journalling operation started"); } } static void FzDocument_insert_pdf( mupdf::FzDocument& doc, mupdf::FzDocument& src, int from_page, int to_page, int start_at, int rotate, int links, int annots, int show_progress, int final, mupdf::PdfGraftMap& graft_map ) { //std::cerr << __FILE__ << ":" << __LINE__ << ":" << __FUNCTION__ << "\n"; mupdf::PdfDocument pdfout = mupdf::pdf_specifics(doc); mupdf::PdfDocument pdfsrc = mupdf::pdf_specifics(src); int outCount = mupdf::fz_count_pages(doc); int srcCount = mupdf::fz_count_pages(src); // local copies of page numbers int fp = from_page; int tp = to_page; int sa = start_at; // normalize page numbers fp = std::max(fp, 0); // -1 = first page fp = std::min(fp, srcCount - 1); // but do not exceed last page if (tp < 0) tp = srcCount - 1; // -1 = last page tp = std::min(tp, srcCount - 1); // but do not exceed last page if (sa < 0) sa = outCount; // -1 = behind last page sa = std::min(sa, outCount); // but that is also the limit if (!pdfout.m_internal || !pdfsrc.m_internal) { throw std::runtime_error("source or target not a PDF"); } JM_ensure_operation(pdfout); JM_merge_range(pdfout, pdfsrc, fp, tp, sa, rotate, links, annots, show_progress, graft_map); } static int page_xref(mupdf::FzDocument& this_doc, int pno) { int page_count = mupdf::fz_count_pages(this_doc); int n = pno; while (n < 0) { n += page_count; } mupdf::PdfDocument pdf = mupdf::pdf_specifics(this_doc); assert(pdf.m_internal); int xref = 0; if (n >= page_count) { throw std::runtime_error(MSG_BAD_PAGENO);//, PyExc_ValueError); } xref = mupdf::pdf_to_num(mupdf::pdf_lookup_page_obj(pdf, n)); return xref; } static void _newPage(mupdf::PdfDocument& pdf, int pno=-1, float width=595, float height=842) { if (!pdf.m_internal) { throw std::runtime_error("is no PDF"); } mupdf::FzRect mediabox(0, 0, width, height); if (pno < -1) { throw std::runtime_error("bad page number(s)"); // Should somehow be Python ValueError } JM_ensure_operation(pdf); // create /Resources and /Contents objects mupdf::PdfObj resources = mupdf::pdf_add_new_dict(pdf, 1); mupdf::FzBuffer contents; mupdf::PdfObj page_obj = mupdf::pdf_add_page(pdf, mediabox, 0, resources, contents); mupdf::pdf_insert_page(pdf, pno, page_obj); } static void _newPage(mupdf::FzDocument& self, int pno=-1, float width=595, float height=842) { mupdf::PdfDocument pdf = mupdf::pdf_specifics(self); _newPage(pdf, pno, width, height); } //------------------------------------------------------------------------ // return the annotation names (list of /NM entries) //------------------------------------------------------------------------ static std::vector< std::string> JM_get_annot_id_list(mupdf::PdfPage& page) { std::vector< std::string> names; mupdf::PdfObj annots = mupdf::pdf_dict_get(page.obj(), PDF_NAME2(Annots)); if (!annots.m_internal) return names; int n = mupdf::pdf_array_len(annots); for (int i = 0; i < n; i++) { mupdf::PdfObj annot_obj = mupdf::pdf_array_get(annots, i); mupdf::PdfObj name = mupdf::pdf_dict_gets(annot_obj, "NM"); if (name.m_internal) { names.push_back(mupdf::pdf_to_text_string(name)); } } return names; } //------------------------------------------------------------------------ // Add a unique /NM key to an annotation or widget. // Append a number to 'stem' such that the result is a unique name. //------------------------------------------------------------------------ static void JM_add_annot_id(mupdf::PdfAnnot& annot, const char* stem) { mupdf::PdfPage page = mupdf::pdf_annot_page(annot); mupdf::PdfObj annot_obj = mupdf::pdf_annot_obj(annot); std::vector< std::string> names = JM_get_annot_id_list(page); char* stem_id = nullptr; for (int i=0; ; ++i) { free(stem_id); asprintf(&stem_id, "fitz-%s%d", stem, i); if (std::find(names.begin(), names.end(), stem_id) == names.end()) { break; } } mupdf::PdfObj name = mupdf::pdf_new_string(stem_id, strlen(stem_id)); free(stem_id); mupdf::pdf_dict_puts(annot_obj, "NM", name); page.m_internal->doc->resynth_required = 0; } //---------------------------------------------------------------- // page add_caret_annot //---------------------------------------------------------------- static mupdf::PdfAnnot _add_caret_annot(mupdf::PdfPage& page, mupdf::FzPoint& point) { mupdf::PdfAnnot annot = mupdf::pdf_create_annot(page, ::PDF_ANNOT_CARET); mupdf::FzPoint p = point; mupdf::FzRect r = mupdf::pdf_annot_rect(annot); r = mupdf::fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0); mupdf::pdf_set_annot_rect(annot, r); mupdf::pdf_update_annot(annot); JM_add_annot_id(annot, "A"); return annot; } static mupdf::PdfAnnot _add_caret_annot(mupdf::FzPage& page, mupdf::FzPoint& point) { mupdf::PdfPage pdf_page = mupdf::pdf_page_from_fz_page(page); return _add_caret_annot(pdf_page, point); } static const char* Tools_parse_da(mupdf::PdfAnnot& this_annot) { const char* da_str = nullptr; mupdf::PdfObj this_annot_obj = mupdf::pdf_annot_obj(this_annot); mupdf::PdfDocument pdf = mupdf::pdf_get_bound_document(this_annot_obj); try { mupdf::PdfObj da = mupdf::pdf_dict_get_inheritable(this_annot_obj, PDF_NAME2(DA)); if (!da.m_internal) { mupdf::PdfObj trailer = mupdf::pdf_trailer(pdf); da = mupdf::pdf_dict_getl( &trailer, PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(DA), nullptr ); } da_str = mupdf::pdf_to_text_string(da); } catch (std::exception&) { return nullptr; } return da_str; } //---------------------------------------------------------------------------- // Turn fz_buffer into a Python bytes object //---------------------------------------------------------------------------- static PyObject* JM_BinFromBuffer(fz_buffer* buffer) { if (!buffer) { return PyBytes_FromStringAndSize("", 0); } unsigned char* c = nullptr; size_t len = mupdf::ll_fz_buffer_storage(buffer, &c); return PyBytes_FromStringAndSize((const char*) c, len); } static PyObject* JM_BinFromBuffer(mupdf::FzBuffer& buffer) { return JM_BinFromBuffer( buffer.m_internal); } static PyObject* Annot_getAP(mupdf::PdfAnnot& annot) { mupdf::PdfObj annot_obj = mupdf::pdf_annot_obj(annot); mupdf::PdfObj ap = mupdf::pdf_dict_getl( &annot_obj, PDF_NAME(AP), PDF_NAME(N), nullptr ); if (mupdf::pdf_is_stream(ap)) { mupdf::FzBuffer res = mupdf::pdf_load_stream(ap); return JM_BinFromBuffer(res); } return PyBytes_FromStringAndSize("", 0); } void Tools_update_da(mupdf::PdfAnnot& this_annot, const char* da_str) { mupdf::PdfObj this_annot_obj = mupdf::pdf_annot_obj(this_annot); mupdf::pdf_dict_put_text_string(this_annot_obj, PDF_NAME2(DA), da_str); mupdf::pdf_dict_del(this_annot_obj, PDF_NAME2(DS)); /* not supported */ mupdf::pdf_dict_del(this_annot_obj, PDF_NAME2(RC)); /* not supported */ } static int jm_float_item(PyObject* obj, Py_ssize_t idx, double* result) { PyObject* temp = PySequence_ITEM(obj, idx); if (!temp) return 1; *result = PyFloat_AsDouble(temp); Py_DECREF(temp); if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } static mupdf::FzPoint JM_point_from_py(PyObject* p) { fz_point p0 = fz_make_point(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT); if (!p || !PySequence_Check(p) || PySequence_Size(p) != 2) { return p0; } double x; double y; if (jm_float_item(p, 0, &x) == 1) return p0; if (jm_float_item(p, 1, &y) == 1) return p0; if (x < FZ_MIN_INF_RECT) x = FZ_MIN_INF_RECT; if (y < FZ_MIN_INF_RECT) y = FZ_MIN_INF_RECT; if (x > FZ_MAX_INF_RECT) x = FZ_MAX_INF_RECT; if (y > FZ_MAX_INF_RECT) y = FZ_MAX_INF_RECT; return fz_make_point(x, y); } static int s_list_append_drop(PyObject* list, PyObject* item) { if (!list || !PyList_Check(list) || !item) { return -2; } int rc = PyList_Append(list, item); Py_DECREF(item); return rc; } static int LIST_APPEND_DROP(PyObject *list, PyObject *item) { if (!list || !PyList_Check(list) || !item) return -2; int rc = PyList_Append(list, item); Py_DECREF(item); return rc; } static int LIST_APPEND(PyObject *list, PyObject *item) { if (!list || !PyList_Check(list) || !item) return -2; int rc = PyList_Append(list, item); return rc; } static int DICT_SETITEM_DROP(PyObject *dict, PyObject *key, PyObject *value) { if (!dict || !PyDict_Check(dict) || !key || !value) return -2; int rc = PyDict_SetItem(dict, key, value); Py_DECREF(value); return rc; } static int DICT_SETITEMSTR_DROP(PyObject *dict, const char *key, PyObject *value) { if (!dict || !PyDict_Check(dict) || !key || !value) return -2; int rc = PyDict_SetItemString(dict, key, value); Py_DECREF(value); return rc; } //----------------------------------------------------------------------------- // Functions converting between PySequences and pymupdf geometry objects //----------------------------------------------------------------------------- static int jm_init_item(PyObject* obj, Py_ssize_t idx, int* result) { PyObject* temp = PySequence_ITEM(obj, idx); if (!temp) { return 1; } if (PyLong_Check(temp)) { *result = (int) PyLong_AsLong(temp); Py_DECREF(temp); } else if (PyFloat_Check(temp)) { *result = (int) PyFloat_AsDouble(temp); Py_DECREF(temp); } else { Py_DECREF(temp); return 1; } if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } // TODO: ------------------------------------------------------------------ // This is a temporary solution and should be replaced by a C++ extension: // There is no way in Python specify an array of fz_point - as is required // for function pdf_set_annot_callout_line(). static void JM_set_annot_callout_line(mupdf::PdfAnnot& annot, PyObject *callout, int count) { fz_point points[3]; mupdf::FzPoint p; for (int i = 0; i < count; i++) { p = JM_point_from_py(PyTuple_GetItem(callout, (Py_ssize_t) i)); points[i] = fz_make_point(p.x, p.y); } mupdf::pdf_set_annot_callout_line(annot, points, count); } //---------------------------------------------------------------------------- // Return list of outline xref numbers. Recursive function. Arguments: // 'obj' first OL item // 'xrefs' empty Python list //---------------------------------------------------------------------------- static PyObject* JM_outline_xrefs(mupdf::PdfObj obj, PyObject* xrefs) { if (!obj.m_internal) { return xrefs; } PyObject* newxref = nullptr; mupdf::PdfObj thisobj = obj; while (thisobj.m_internal) { int nxr = mupdf::pdf_to_num(thisobj); newxref = PyLong_FromLong((long) nxr); if (PySequence_Contains(xrefs, newxref) or mupdf::pdf_dict_get(thisobj, PDF_NAME2(Type)).m_internal ) { // circular ref or top of chain: terminate Py_DECREF(newxref); break; } s_list_append_drop(xrefs, newxref); mupdf::PdfObj first = mupdf::pdf_dict_get(thisobj, PDF_NAME2(First)); // try go down if (mupdf::pdf_is_dict(first)) { xrefs = JM_outline_xrefs(first, xrefs); } thisobj = mupdf::pdf_dict_get(thisobj, PDF_NAME2(Next)); // try go next mupdf::PdfObj parent = mupdf::pdf_dict_get(thisobj, PDF_NAME2(Parent)); // get parent if (!mupdf::pdf_is_dict(thisobj)) { thisobj = parent; } } return xrefs; } PyObject* dictkey_align = NULL; PyObject* dictkey_ascender = NULL; PyObject* dictkey_bidi = NULL; PyObject* dictkey_bbox = NULL; PyObject* dictkey_blocks = NULL; PyObject* dictkey_bpc = NULL; PyObject* dictkey_c = NULL; PyObject* dictkey_chars = NULL; PyObject* dictkey_color = NULL; PyObject* dictkey_colorspace = NULL; PyObject* dictkey_content = NULL; PyObject* dictkey_creationDate = NULL; PyObject* dictkey_cs_name = NULL; PyObject* dictkey_da = NULL; PyObject* dictkey_dashes = NULL; PyObject* dictkey_desc = NULL; PyObject* dictkey_descender = NULL; PyObject* dictkey_dir = NULL; PyObject* dictkey_effect = NULL; PyObject* dictkey_ext = NULL; PyObject* dictkey_filename = NULL; PyObject* dictkey_fill = NULL; PyObject* dictkey_flags = NULL; PyObject* dictkey_char_bidi = NULL; PyObject* dictkey_char_flags = NULL; PyObject* dictkey_font = NULL; PyObject* dictkey_glyph = NULL; PyObject* dictkey_height = NULL; PyObject* dictkey_id = NULL; PyObject* dictkey_image = NULL; PyObject* dictkey_items = NULL; PyObject* dictkey_length = NULL; PyObject* dictkey_lines = NULL; PyObject* dictkey_matrix = NULL; PyObject* dictkey_modDate = NULL; PyObject* dictkey_name = NULL; PyObject* dictkey_number = NULL; PyObject* dictkey_origin = NULL; PyObject* dictkey_rect = NULL; PyObject* dictkey_size = NULL; PyObject* dictkey_smask = NULL; PyObject* dictkey_spans = NULL; PyObject* dictkey_stroke = NULL; PyObject* dictkey_style = NULL; PyObject* dictkey_subject = NULL; PyObject* dictkey_text = NULL; PyObject* dictkey_title = NULL; PyObject* dictkey_type = NULL; PyObject* dictkey_ufilename = NULL; PyObject* dictkey_width = NULL; PyObject* dictkey_wmode = NULL; PyObject* dictkey_xref = NULL; PyObject* dictkey_xres = NULL; PyObject* dictkey_yres = NULL; static int dict_setitem_drop(PyObject* dict, PyObject* key, PyObject* value) { if (!dict || !PyDict_Check(dict) || !key || !value) { return -2; } int rc = PyDict_SetItem(dict, key, value); Py_DECREF(value); return rc; } static int dict_setitemstr_drop(PyObject* dict, const char* key, PyObject* value) { if (!dict || !PyDict_Check(dict) || !key || !value) { return -2; } int rc = PyDict_SetItemString(dict, key, value); Py_DECREF(value); return rc; } static void Document_extend_toc_items(mupdf::PdfDocument& pdf, PyObject* items) { PyObject* item=nullptr; PyObject* itemdict=nullptr; PyObject* xrefs=nullptr; PyObject* bold = PyUnicode_FromString("bold"); PyObject* italic = PyUnicode_FromString("italic"); PyObject* collapse = PyUnicode_FromString("collapse"); PyObject* zoom = PyUnicode_FromString("zoom"); try { /* Need to define these things early because later code uses `goto`; otherwise we get compiler warnings 'jump bypasses variable initialization' */ int xref = 0; mupdf::PdfObj root; mupdf::PdfObj olroot; mupdf::PdfObj first; Py_ssize_t n; Py_ssize_t m; root = mupdf::pdf_dict_get(mupdf::pdf_trailer(pdf), PDF_NAME2(Root)); if (!root.m_internal) goto end; olroot = mupdf::pdf_dict_get(root, PDF_NAME2(Outlines)); if (!olroot.m_internal) goto end; first = mupdf::pdf_dict_get(olroot, PDF_NAME2(First)); if (!first.m_internal) goto end; xrefs = PyList_New(0); // pre-allocate an empty list xrefs = JM_outline_xrefs(first, xrefs); n = PySequence_Size(xrefs); m = PySequence_Size(items); if (!n) goto end; if (n != m) { throw std::runtime_error("internal error finding outline xrefs"); } // update all TOC item dictionaries for (int i = 0; i < n; i++) { jm_init_item(xrefs, i, &xref); item = PySequence_ITEM(items, i); itemdict = PySequence_ITEM(item, 3); if (!itemdict || !PyDict_Check(itemdict)) { throw std::runtime_error("need non-simple TOC format"); } PyDict_SetItem(itemdict, dictkey_xref, PySequence_ITEM(xrefs, i)); mupdf::PdfObj bm = mupdf::pdf_load_object(pdf, xref); int flags = mupdf::pdf_to_int(mupdf::pdf_dict_get(bm, PDF_NAME2(F))); if (flags == 1) { PyDict_SetItem(itemdict, italic, Py_True); } else if (flags == 2) { PyDict_SetItem(itemdict, bold, Py_True); } else if (flags == 3) { PyDict_SetItem(itemdict, italic, Py_True); PyDict_SetItem(itemdict, bold, Py_True); } int count = mupdf::pdf_to_int(mupdf::pdf_dict_get(bm, PDF_NAME2(Count))); if (count < 0) { PyDict_SetItem(itemdict, collapse, Py_True); } else if (count > 0) { PyDict_SetItem(itemdict, collapse, Py_False); } mupdf::PdfObj col = mupdf::pdf_dict_get(bm, PDF_NAME2(C)); if (mupdf::pdf_is_array(col) && mupdf::pdf_array_len(col) == 3) { PyObject* color = PyTuple_New(3); PyTuple_SET_ITEM(color, 0, Py_BuildValue("f", mupdf::pdf_to_real(mupdf::pdf_array_get(col, 0)))); PyTuple_SET_ITEM(color, 1, Py_BuildValue("f", mupdf::pdf_to_real(mupdf::pdf_array_get(col, 1)))); PyTuple_SET_ITEM(color, 2, Py_BuildValue("f", mupdf::pdf_to_real(mupdf::pdf_array_get(col, 2)))); dict_setitem_drop(itemdict, dictkey_color, color); } float z=0; mupdf::PdfObj obj = mupdf::pdf_dict_get(bm, PDF_NAME2(Dest)); if (!obj.m_internal || !mupdf::pdf_is_array(obj)) { obj = mupdf::pdf_dict_getl(&bm, PDF_NAME(A), PDF_NAME(D), nullptr); } if (mupdf::pdf_is_array(obj) && mupdf::pdf_array_len(obj) == 5) { z = mupdf::pdf_to_real(mupdf::pdf_array_get(obj, 4)); } dict_setitem_drop(itemdict, zoom, Py_BuildValue("f", z)); PyList_SetItem(item, 3, itemdict); PyList_SetItem(items, i, item); } end:; } catch (std::exception&) { } Py_CLEAR(xrefs); Py_CLEAR(bold); Py_CLEAR(italic); Py_CLEAR(collapse); Py_CLEAR(zoom); } static void Document_extend_toc_items(mupdf::FzDocument& document, PyObject* items) { mupdf::PdfDocument pdf = mupdf::pdf_document_from_fz_document(document); return Document_extend_toc_items(pdf, items); } //----------------------------------------------------------------------------- // PySequence from fz_rect //----------------------------------------------------------------------------- static PyObject* JM_py_from_rect(fz_rect r) { return Py_BuildValue("ffff", r.x0, r.y0, r.x1, r.y1); } static PyObject* JM_py_from_rect(mupdf::FzRect r) { return JM_py_from_rect(*r.internal()); } //----------------------------------------------------------------------------- // PySequence from fz_point //----------------------------------------------------------------------------- static PyObject* JM_py_from_point(fz_point p) { return Py_BuildValue("ff", p.x, p.y); } //----------------------------------------------------------------------------- // PySequence from fz_quad. //----------------------------------------------------------------------------- static PyObject * JM_py_from_quad(fz_quad q) { return Py_BuildValue("((f,f),(f,f),(f,f),(f,f))", q.ul.x, q.ul.y, q.ur.x, q.ur.y, q.ll.x, q.ll.y, q.lr.x, q.lr.y); } //---------------------------------------------------------------- // annotation rectangle //---------------------------------------------------------------- static mupdf::FzRect Annot_rect(mupdf::PdfAnnot& annot) { mupdf::FzRect rect = mupdf::pdf_bound_annot(annot); return rect; } static PyObject* Annot_rect3(mupdf::PdfAnnot& annot) { fz_rect rect = mupdf::ll_pdf_bound_annot(annot.m_internal); return JM_py_from_rect(rect); } //----------------------------------------------------------------------------- // PySequence to fz_rect. Default: infinite rect //----------------------------------------------------------------------------- static fz_rect JM_rect_from_py(PyObject* r) { if (!r || !PySequence_Check(r) || PySequence_Size(r) != 4) { return *mupdf::FzRect(mupdf::FzRect::Fixed_INFINITE).internal();// fz_infinite_rect; } double f[4]; for (int i = 0; i < 4; i++) { if (jm_float_item(r, i, &f[i]) == 1) { return *mupdf::FzRect(mupdf::FzRect::Fixed_INFINITE).internal(); } if (f[i] < FZ_MIN_INF_RECT) f[i] = FZ_MIN_INF_RECT; if (f[i] > FZ_MAX_INF_RECT) f[i] = FZ_MAX_INF_RECT; } return mupdf::ll_fz_make_rect( (float) f[0], (float) f[1], (float) f[2], (float) f[3] ); } //----------------------------------------------------------------------------- // PySequence to fz_matrix. Default: fz_identity //----------------------------------------------------------------------------- static fz_matrix JM_matrix_from_py(PyObject* m) { double a[6]; if (!m || !PySequence_Check(m) || PySequence_Size(m) != 6) { return fz_identity; } for (int i = 0; i < 6; i++) { if (jm_float_item(m, i, &a[i]) == 1) { return *mupdf::FzMatrix().internal(); } } return mupdf::ll_fz_make_matrix( (float) a[0], (float) a[1], (float) a[2], (float) a[3], (float) a[4], (float) a[5] ); } PyObject* util_transform_rect(PyObject* rect, PyObject* matrix) { return JM_py_from_rect( mupdf::ll_fz_transform_rect( JM_rect_from_py(rect), JM_matrix_from_py(matrix) ) ); } //---------------------------------------------------------------------------- // return normalized /Rotate value:one of 0, 90, 180, 270 //---------------------------------------------------------------------------- static int JM_norm_rotation(int rotate) { while (rotate < 0) rotate += 360; while (rotate >= 360) rotate -= 360; if (rotate % 90 != 0) return 0; return rotate; } //---------------------------------------------------------------------------- // return a PDF page's /Rotate value: one of (0, 90, 180, 270) //---------------------------------------------------------------------------- static int JM_page_rotation(mupdf::PdfPage& page) { int rotate = 0; rotate = mupdf::pdf_to_int( mupdf::pdf_dict_get_inheritable(page.obj(), PDF_NAME2(Rotate)) ); rotate = JM_norm_rotation(rotate); return rotate; } //---------------------------------------------------------------------------- // return a PDF page's MediaBox //---------------------------------------------------------------------------- static mupdf::FzRect JM_mediabox(mupdf::PdfObj& page_obj) { mupdf::FzRect mediabox = mupdf::pdf_to_rect( mupdf::pdf_dict_get_inheritable(page_obj, PDF_NAME2(MediaBox)) ); if (mupdf::fz_is_empty_rect(mediabox) || mupdf::fz_is_infinite_rect(mediabox)) { mediabox.x0 = 0; mediabox.y0 = 0; mediabox.x1 = 612; mediabox.y1 = 792; } mupdf::FzRect page_mediabox; page_mediabox.x0 = mupdf::fz_min(mediabox.x0, mediabox.x1); page_mediabox.y0 = mupdf::fz_min(mediabox.y0, mediabox.y1); page_mediabox.x1 = mupdf::fz_max(mediabox.x0, mediabox.x1); page_mediabox.y1 = mupdf::fz_max(mediabox.y0, mediabox.y1); if (0 || page_mediabox.x1 - page_mediabox.x0 < 1 || page_mediabox.y1 - page_mediabox.y0 < 1 ) { page_mediabox = *mupdf::FzRect(mupdf::FzRect::Fixed_UNIT).internal(); //fz_unit_rect; } return page_mediabox; } //---------------------------------------------------------------------------- // return a PDF page's CropBox //---------------------------------------------------------------------------- mupdf::FzRect JM_cropbox(mupdf::PdfObj& page_obj) { mupdf::FzRect mediabox = JM_mediabox(page_obj); mupdf::FzRect cropbox = mupdf::pdf_to_rect( mupdf::pdf_dict_get_inheritable(page_obj, PDF_NAME2(CropBox)) ); if (mupdf::fz_is_infinite_rect(cropbox) || mupdf::fz_is_empty_rect(cropbox)) { cropbox = mediabox; } float y0 = mediabox.y1 - cropbox.y1; float y1 = mediabox.y1 - cropbox.y0; cropbox.y0 = y0; cropbox.y1 = y1; return cropbox; } //---------------------------------------------------------------------------- // calculate width and height of the UNROTATED page //---------------------------------------------------------------------------- static mupdf::FzPoint JM_cropbox_size(mupdf::PdfObj& page_obj) { mupdf::FzPoint size; mupdf::FzRect rect = JM_cropbox(page_obj); float w = (rect.x0 < rect.x1) ? rect.x1 - rect.x0 : rect.x0 - rect.x1; float h = (rect.y0 < rect.y1) ? rect.y1 - rect.y0 : rect.y0 - rect.y1; size = fz_make_point(w, h); return size; } //---------------------------------------------------------------------------- // calculate page rotation matrices //---------------------------------------------------------------------------- static mupdf::FzMatrix JM_rotate_page_matrix(mupdf::PdfPage& page) { if (!page.m_internal) { return *mupdf::FzMatrix().internal(); // no valid pdf page given } int rotation = JM_page_rotation(page); if (rotation == 0) { return *mupdf::FzMatrix().internal(); // no rotation } auto po = page.obj(); mupdf::FzPoint cb_size = JM_cropbox_size(po); float w = cb_size.x; float h = cb_size.y; mupdf::FzMatrix m; if (rotation == 90) { m = mupdf::fz_make_matrix(0, 1, -1, 0, h, 0); } else if (rotation == 180) { m = mupdf::fz_make_matrix(-1, 0, 0, -1, w, h); } else { m = mupdf::fz_make_matrix(0, -1, 1, 0, 0, w); } return m; } static mupdf::FzMatrix JM_derotate_page_matrix(mupdf::PdfPage& page) { // just the inverse of rotation return mupdf::fz_invert_matrix(JM_rotate_page_matrix(page)); } //----------------------------------------------------------------------------- // PySequence from fz_matrix //----------------------------------------------------------------------------- static PyObject* JM_py_from_matrix(mupdf::FzMatrix m) { return Py_BuildValue("ffffff", m.a, m.b, m.c, m.d, m.e, m.f); } static mupdf::FzMatrix Page_derotate_matrix(mupdf::PdfPage& pdfpage) { if (!pdfpage.m_internal) { return mupdf::FzMatrix(); } return JM_derotate_page_matrix(pdfpage); } static mupdf::FzMatrix Page_derotate_matrix(mupdf::FzPage& page) { mupdf::PdfPage pdf_page = mupdf::pdf_page_from_fz_page(page); return Page_derotate_matrix(pdf_page); } static PyObject *lll_JM_get_annot_xref_list(pdf_obj *page_obj) { fz_context* ctx = mupdf::internal_context_get(); PyObject *names = PyList_New(0); pdf_obj *id, *subtype, *annots, *annot_obj; int xref, type, i, n; fz_try(ctx) { annots = pdf_dict_get(ctx, page_obj, PDF_NAME(Annots)); n = pdf_array_len(ctx, annots); for (i = 0; i < n; i++) { annot_obj = pdf_array_get(ctx, annots, i); xref = pdf_to_num(ctx, annot_obj); subtype = pdf_dict_get(ctx, annot_obj, PDF_NAME(Subtype)); if (!subtype) { continue; // subtype is required } type = pdf_annot_type_from_string(ctx, pdf_to_name(ctx, subtype)); if (type == PDF_ANNOT_UNKNOWN) { continue; // only accept valid annot types } id = pdf_dict_gets(ctx, annot_obj, "NM"); LIST_APPEND_DROP(names, Py_BuildValue("iis", xref, type, pdf_to_text_string(ctx, id))); } } fz_catch(ctx) { return names; } return names; } //------------------------------------------------------------------------ // return the xrefs and /NM ids of a page's annots, links and fields //------------------------------------------------------------------------ static PyObject* JM_get_annot_xref_list(const mupdf::PdfObj& page_obj) { if (!page_obj.m_internal) { PyObject* names = PyList_New(0); return names; } return lll_JM_get_annot_xref_list( page_obj.m_internal); } static mupdf::FzBuffer JM_object_to_buffer(const mupdf::PdfObj& what, int compress, int ascii) { mupdf::FzBuffer res = mupdf::fz_new_buffer(512); mupdf::FzOutput out(res); mupdf::pdf_print_obj(out, what, compress, ascii); out.fz_close_output(); mupdf::fz_terminate_buffer(res); return res; } static PyObject* JM_EscapeStrFromBuffer(mupdf::FzBuffer& buff) { if (!buff.m_internal) { return PyUnicode_FromString(""); } unsigned char* s = nullptr; size_t len = mupdf::fz_buffer_storage(buff, &s); PyObject* val = PyUnicode_DecodeRawUnicodeEscape((const char*) s, (Py_ssize_t) len, "replace"); if (!val) { val = PyUnicode_FromString(""); PyErr_Clear(); } return val; } static PyObject* xref_object(mupdf::PdfDocument& pdf, int xref, int compressed=0, int ascii=0) { if (!pdf.m_internal) { throw std::runtime_error(MSG_IS_NO_PDF); } int xreflen = mupdf::pdf_xref_len(pdf); if ((xref < 1 || xref >= xreflen) and xref != -1) { throw std::runtime_error(MSG_BAD_XREF); } mupdf::PdfObj obj = (xref > 0) ? mupdf::pdf_load_object(pdf, xref) : mupdf::pdf_trailer(pdf); mupdf::FzBuffer res = JM_object_to_buffer(mupdf::pdf_resolve_indirect(obj), compressed, ascii); PyObject* text = JM_EscapeStrFromBuffer(res); return text; } static PyObject* xref_object(mupdf::FzDocument& document, int xref, int compressed=0, int ascii=0) { mupdf::PdfDocument pdf = mupdf::pdf_document_from_fz_document(document); return xref_object(pdf, xref, compressed, ascii); } //------------------------------------- // fz_output for Python file objects //------------------------------------- static PyObject* Link_is_external(mupdf::FzLink& this_link) { const char* uri = this_link.m_internal->uri; if (!uri) { return PyBool_FromLong(0); } bool ret = mupdf::fz_is_external_link(uri); return PyBool_FromLong((long) ret); } static mupdf::FzLink Link_next(mupdf::FzLink& this_link) { return this_link.next(); } //----------------------------------------------------------------------------- // create PDF object from given string //----------------------------------------------------------------------------- static pdf_obj *lll_JM_pdf_obj_from_str(fz_context *ctx, pdf_document *doc, const char *src) { pdf_obj *result = NULL; pdf_lexbuf lexbuf; fz_stream *stream = fz_open_memory(ctx, (unsigned char *)src, strlen(src)); pdf_lexbuf_init(ctx, &lexbuf, PDF_LEXBUF_SMALL); fz_try(ctx) { result = pdf_parse_stm_obj(ctx, doc, stream, &lexbuf); } fz_always(ctx) { pdf_lexbuf_fin(ctx, &lexbuf); fz_drop_stream(ctx, stream); } fz_catch(ctx) { mupdf::internal_throw_exception(ctx); } return result; } /*********************************************************************/ // Page._addAnnot_FromString // Add new links provided as an array of string object definitions. /*********************************************************************/ PyObject* Page_addAnnot_FromString(mupdf::PdfPage& page, PyObject* linklist) { PyObject* txtpy = nullptr; int lcount = (int) PySequence_Size(linklist); // link count //printf("Page_addAnnot_FromString(): lcount=%i\n", lcount); if (lcount < 1) { Py_RETURN_NONE; } try { // insert links from the provided sources if (!page.m_internal) { throw std::runtime_error(MSG_IS_NO_PDF); } if (!mupdf::pdf_dict_get(page.obj(), PDF_NAME2(Annots)).m_internal) { mupdf::pdf_dict_put_array(page.obj(), PDF_NAME2(Annots), lcount); } mupdf::PdfObj annots = mupdf::pdf_dict_get(page.obj(), PDF_NAME2(Annots)); mupdf::PdfDocument doc = page.doc(); //printf("lcount=%i\n", lcount); fz_context* ctx = mupdf::internal_context_get(); for (int i = 0; i < lcount; i++) { const char* text = nullptr; txtpy = PySequence_ITEM(linklist, (Py_ssize_t) i); text = PyUnicode_AsUTF8(txtpy); Py_CLEAR(txtpy); if (!text) { messagef("skipping bad link / annot item %i.", i); continue; } try { pdf_obj* obj = lll_JM_pdf_obj_from_str(ctx, doc.m_internal, text); pdf_obj* annot = pdf_add_object_drop( ctx, doc.m_internal, obj ); pdf_obj* ind_obj = pdf_new_indirect(ctx, doc.m_internal, pdf_to_num(ctx, annot), 0); pdf_array_push_drop(ctx, annots.m_internal, ind_obj); pdf_drop_obj(ctx, annot); } catch (std::exception&) { messagef("skipping bad link / annot item %i.", i); } } } catch (std::exception&) { PyErr_Clear(); return nullptr; } Py_RETURN_NONE; } PyObject* Page_addAnnot_FromString(mupdf::FzPage& page, PyObject* linklist) { mupdf::PdfPage pdf_page = mupdf::pdf_page_from_fz_page(page); return Page_addAnnot_FromString(pdf_page, linklist); } static int page_count_fz2(void* document) { mupdf::FzDocument* document2 = (mupdf::FzDocument*) document; return mupdf::fz_count_pages(*document2); } static int page_count_fz(mupdf::FzDocument& document) { return mupdf::fz_count_pages(document); } static int page_count_pdf(mupdf::PdfDocument& pdf) { mupdf::FzDocument document = pdf.super(); return page_count_fz(document); } static int page_count(mupdf::FzDocument& document) { return mupdf::fz_count_pages(document); } static int page_count(mupdf::PdfDocument& pdf) { mupdf::FzDocument document = pdf.super(); return page_count(document); } static PyObject* page_annot_xrefs(mupdf::FzDocument& document, mupdf::PdfDocument& pdf, int pno) { int page_count = mupdf::fz_count_pages(document); int n = pno; while (n < 0) { n += page_count; } PyObject* annots = nullptr; if (n >= page_count) { throw std::runtime_error(MSG_BAD_PAGENO); } if (!pdf.m_internal) { throw std::runtime_error(MSG_IS_NO_PDF); } annots = JM_get_annot_xref_list(mupdf::pdf_lookup_page_obj(pdf, n)); return annots; } static PyObject* page_annot_xrefs(mupdf::FzDocument& document, int pno) { mupdf::PdfDocument pdf = mupdf::pdf_specifics(document); return page_annot_xrefs(document, pdf, pno); } static PyObject* page_annot_xrefs(mupdf::PdfDocument& pdf, int pno) { mupdf::FzDocument document = pdf.super(); return page_annot_xrefs(document, pdf, pno); } static bool Outline_is_external(mupdf::FzOutline* outline) { if (!outline->m_internal->uri) { return false; } return mupdf::ll_fz_is_external_link(outline->m_internal->uri); } int ll_fz_absi(int i) { return mupdf::ll_fz_absi(i); } enum { TEXT_FONT_SUPERSCRIPT = 1, TEXT_FONT_ITALIC = 2, TEXT_FONT_SERIFED = 4, TEXT_FONT_MONOSPACED = 8, TEXT_FONT_BOLD = 16, }; int g_skip_quad_corrections = 0; int g_subset_fontnames = 0; int g_small_glyph_heights = 0; void set_skip_quad_corrections(int on) { g_skip_quad_corrections = on; } void set_subset_fontnames(int on) { g_subset_fontnames = on; } void set_small_glyph_heights(int on) { g_small_glyph_heights = on; } struct jm_lineart_device { fz_device super; PyObject* out = {}; PyObject* method = {}; PyObject* pathdict = {}; PyObject* scissors = {}; float pathfactor = {}; fz_matrix ctm = {}; fz_matrix ptm = {}; fz_matrix rot = {}; fz_point lastpoint = {}; fz_point firstpoint = {}; int havemove = 0; fz_rect pathrect = {}; int clips = {}; int linecount = {}; int path_type = {}; long depth = {}; size_t seqno = {}; char* layer_name; }; static void jm_lineart_drop_device(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (PyList_Check(dev->out)) { Py_CLEAR(dev->out); } Py_CLEAR(dev->method); Py_CLEAR(dev->scissors); mupdf::ll_fz_free(dev->layer_name); dev->layer_name = nullptr; } typedef jm_lineart_device jm_tracedraw_device; // need own versions of ascender / descender static float JM_font_ascender(fz_font* font) { if (g_skip_quad_corrections) { return 0.8f; } return mupdf::ll_fz_font_ascender(font); } static float JM_font_descender(fz_font* font) { if (g_skip_quad_corrections) { return -0.2f; } return mupdf::ll_fz_font_descender(font); } //---------------------------------------------------------------- // Return true if character is considered to be a word delimiter //---------------------------------------------------------------- static int JM_is_word_delimiter(int c, PyObject *delimiters) { if (c <= 32 || c == 160) return 1; // a standard delimiter if (0x202a <= c && c <= 0x202e) { return 1; // change between writing directions } // extra delimiters must be a non-empty sequence if (!delimiters || PyObject_Not(delimiters) || !PySequence_Check(delimiters)) { return 0; } // convert to tuple for easier looping PyObject *delims = PySequence_Tuple(delimiters); if (!delims) { PyErr_Clear(); return 0; } // Make 1-char PyObject from character given as integer PyObject *cchar = Py_BuildValue("C", c); // single character PyObject Py_ssize_t i, len = PyTuple_Size(delims); for (i = 0; i < len; i++) { int rc = PyUnicode_Compare(cchar, PyTuple_GET_ITEM(delims, i)); if (rc == 0) { // equal to a delimiter character Py_DECREF(cchar); Py_DECREF(delims); PyErr_Clear(); return 1; } } Py_DECREF(delims); PyErr_Clear(); return 0; } static int JM_is_rtl_char(int c) { if (c < 0x590 || c > 0x900) return 0; return 1; } static const char* JM_font_name(fz_font* font) { const char* name = mupdf::ll_fz_font_name(font); const char* s = strchr(name, '+'); if (g_subset_fontnames || !s || s-name != 6) { return name; } return s + 1; } static void jm_trace_text_span( jm_tracedraw_device* dev, fz_text_span* span, int type, fz_matrix ctm, fz_colorspace* colorspace, const float* color, float alpha, size_t seqno, const fz_stroke_state* stroke ) { //printf("extra.jm_trace_text_span(): seqno=%zi\n", seqno); //fz_matrix join = mupdf::ll_fz_concat(span->trm, ctm); //double fsize = sqrt(fabs((double) span->trm.a * (double) span->trm.d)); fz_matrix mat = mupdf::ll_fz_concat(span->trm, ctm); // text transformation matrix fz_point dir = mupdf::ll_fz_transform_vector(mupdf::ll_fz_make_point(1, 0), mat); // writing direction double fsize = sqrt(dir.x * dir.x + dir.y * dir.y); // font size dir = mupdf::ll_fz_normalize_vector(dir); // compute effective ascender / descender double asc = (double) JM_font_ascender(span->font); double dsc = (double) JM_font_descender(span->font); if (asc < 1e-3) { // probably Tesseract font dsc = -0.1; asc = 0.9; } double ascsize = asc * fsize / (asc - dsc); double dscsize = dsc * fsize / (asc - dsc); int fflags = 0; // font flags int mono = mupdf::ll_fz_font_is_monospaced(span->font); fflags += mono * TEXT_FONT_MONOSPACED; fflags += mupdf::ll_fz_font_is_italic(span->font) * TEXT_FONT_ITALIC; fflags += mupdf::ll_fz_font_is_serif(span->font) * TEXT_FONT_SERIFED; fflags += mupdf::ll_fz_font_is_bold(span->font) * TEXT_FONT_BOLD; // walk through characters of span fz_matrix rot = mupdf::ll_fz_make_matrix(dir.x, dir.y, -dir.y, dir.x, 0, 0); if (dir.x == -1) { // left-right flip rot.d = 1; } PyObject* chars = PyTuple_New(span->len); double space_adv = 0; double last_adv = 0; fz_rect span_bbox; for (int i = 0; i < span->len; i++) { double adv = 0; if (span->items[i].gid >= 0) { adv = (double) mupdf::ll_fz_advance_glyph(span->font, span->items[i].gid, span->wmode); } adv *= fsize; last_adv = adv; if (span->items[i].ucs == 32) { space_adv = adv; } fz_point char_orig; char_orig = fz_make_point(span->items[i].x, span->items[i].y); char_orig = fz_transform_point(char_orig, ctm); fz_matrix m1 = mupdf::ll_fz_make_matrix(1, 0, 0, 1, -char_orig.x, -char_orig.y); m1 = mupdf::ll_fz_concat(m1, rot); m1 = mupdf::ll_fz_concat(m1, mupdf::ll_fz_make_matrix(1, 0, 0, 1, char_orig.x, char_orig.y)); float x0 = char_orig.x; float x1 = x0 + adv; float y0; float y1; if ( (mat.d > 0 && (dir.x == 1 || dir.x == -1)) || (mat.b !=0 && mat.b == -mat.c) ) // up-down flip { // up-down flip y0 = char_orig.y + dscsize; y1 = char_orig.y + ascsize; } else { y0 = char_orig.y - ascsize; y1 = char_orig.y - dscsize; } fz_rect char_bbox = mupdf::ll_fz_make_rect(x0, y0, x1, y1); char_bbox = mupdf::ll_fz_transform_rect(char_bbox, m1); PyTuple_SET_ITEM( chars, (Py_ssize_t) i, Py_BuildValue( "ii(ff)(ffff)", span->items[i].ucs, span->items[i].gid, char_orig.x, char_orig.y, char_bbox.x0, char_bbox.y0, char_bbox.x1, char_bbox.y1 ) ); if (i > 0) { span_bbox = mupdf::ll_fz_union_rect(span_bbox, char_bbox); } else { span_bbox = char_bbox; } } if (!space_adv) { if (!(fflags & TEXT_FONT_MONOSPACED)) { fz_font* out_font = nullptr; space_adv = mupdf::ll_fz_advance_glyph( span->font, mupdf::ll_fz_encode_character_with_fallback(span->font, 32, 0, 0, &out_font), span->wmode ); space_adv *= fsize; if (!space_adv) { space_adv = last_adv; } } else { space_adv = last_adv; // for mono any char width suffices } } // make the span dictionary PyObject* span_dict = PyDict_New(); dict_setitemstr_drop(span_dict, "dir", JM_py_from_point(dir)); dict_setitem_drop(span_dict, dictkey_font, JM_EscapeStrFromStr(JM_font_name(span->font))); dict_setitem_drop(span_dict, dictkey_wmode, PyLong_FromLong((long) span->wmode)); dict_setitem_drop(span_dict, dictkey_flags, PyLong_FromLong((long) fflags)); dict_setitemstr_drop(span_dict, "bidi_lvl", PyLong_FromLong((long) span->bidi_level)); dict_setitemstr_drop(span_dict, "bidi_dir", PyLong_FromLong((long) span->markup_dir)); dict_setitem_drop(span_dict, dictkey_ascender, PyFloat_FromDouble(asc)); dict_setitem_drop(span_dict, dictkey_descender, PyFloat_FromDouble(dsc)); dict_setitem_drop(span_dict, dictkey_colorspace, PyLong_FromLong(3)); float rgb[3]; if (colorspace) { mupdf::ll_fz_convert_color( colorspace, color, mupdf::ll_fz_device_rgb(), rgb, nullptr, fz_default_color_params ); } else { rgb[0] = rgb[1] = rgb[2] = 0; } if (0) { std::cout << " fsize=" << fsize; if (stroke) { std::cout << " linewidth=" << stroke->linewidth; } std::cout << "\n"; } dict_setitem_drop(span_dict, dictkey_color, Py_BuildValue("fff", rgb[0], rgb[1], rgb[2])); dict_setitem_drop(span_dict, dictkey_size, PyFloat_FromDouble(fsize)); dict_setitemstr_drop(span_dict, "opacity", PyFloat_FromDouble((double) alpha)); if (stroke) dict_setitemstr_drop(span_dict, "linewidth", PyFloat_FromDouble((double) stroke->linewidth)); else dict_setitemstr_drop(span_dict, "linewidth", Py_None); dict_setitemstr_drop(span_dict, "spacewidth", PyFloat_FromDouble(space_adv)); dict_setitem_drop(span_dict, dictkey_type, PyLong_FromLong((long) type)); dict_setitem_drop(span_dict, dictkey_bbox, JM_py_from_rect(span_bbox)); dict_setitemstr_drop(span_dict, "layer", JM_UnicodeFromStr(dev->layer_name)); dict_setitemstr_drop(span_dict, "seqno", PyLong_FromSize_t(seqno)); dict_setitem_drop(span_dict, dictkey_chars, chars); //std::cout << "span_dict=" << repr(span_dict) << "\n"; s_list_append_drop(dev->out, span_dict); } static inline void jm_increase_seqno(fz_context* ctx, fz_device* dev_) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; dev->seqno += 1; } static void jm_fill_path( fz_context* ctx, fz_device* dev, const fz_path*, int even_odd, fz_matrix, fz_colorspace*, const float* color, float alpha, fz_color_params ) { jm_increase_seqno(ctx, dev); } static void jm_fill_shade( fz_context* ctx, fz_device* dev, fz_shade* shd, fz_matrix ctm, float alpha, fz_color_params color_params ) { jm_increase_seqno(ctx, dev); } static void jm_fill_image( fz_context* ctx, fz_device* dev, fz_image* img, fz_matrix ctm, float alpha, fz_color_params color_params ) { jm_increase_seqno(ctx, dev); } static void jm_fill_image_mask( fz_context* ctx, fz_device* dev, fz_image* img, fz_matrix ctm, fz_colorspace* cs, const float* color, float alpha, fz_color_params color_params ) { jm_increase_seqno(ctx, dev); } static void jm_stroke_path( fz_context* ctx, fz_device* dev_, const fz_path* path, const fz_stroke_state* stroke, fz_matrix ctm, fz_colorspace* colorspace, const float* color, float alpha, fz_color_params color_params ) { jm_increase_seqno(ctx, dev_); } static void jm_trace_text( jm_tracedraw_device* dev, const fz_text* text, int type, fz_matrix ctm, fz_colorspace* colorspace, const float* color, float alpha, size_t seqno, const fz_stroke_state* stroke ) { fz_text_span* span; for (span = text->head; span; span = span->next) { jm_trace_text_span(dev, span, type, ctm, colorspace, color, alpha, seqno, stroke); } } /*--------------------------------------------------------- There are 3 text trace types: 0 - fill text (PDF Tr 0) 1 - stroke text (PDF Tr 1) 3 - ignore text (PDF Tr 3) ---------------------------------------------------------*/ static void jm_tracedraw_fill_text( fz_context* ctx, fz_device* dev_, const fz_text* text, fz_matrix ctm, fz_colorspace* colorspace, const float* color, float alpha, fz_color_params color_params ) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; jm_trace_text(dev, text, 0, ctm, colorspace, color, alpha, dev->seqno, NULL); dev->seqno += 1; } static void jm_tracedraw_stroke_text( fz_context* ctx, fz_device* dev_, const fz_text* text, const fz_stroke_state* stroke, fz_matrix ctm, fz_colorspace* colorspace, const float* color, float alpha, fz_color_params color_params ) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; jm_trace_text(dev, text, 1, ctm, colorspace, color, alpha, dev->seqno, stroke); dev->seqno += 1; } static void jm_tracedraw_ignore_text( fz_context* ctx, fz_device* dev_, const fz_text* text, fz_matrix ctm ) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; jm_trace_text(dev, text, 3, ctm, nullptr, nullptr, 1, dev->seqno, NULL); dev->seqno += 1; } static void jm_lineart_begin_layer(fz_context *ctx, fz_device *dev_, const char *name) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; mupdf::ll_fz_free(dev->layer_name); dev->layer_name = mupdf::ll_fz_strdup(name); } static void jm_lineart_end_layer(fz_context *ctx, fz_device *dev_) { jm_tracedraw_device* dev = (jm_tracedraw_device*) dev_; mupdf::ll_fz_free(dev->layer_name); dev->layer_name = nullptr; } mupdf::FzDevice JM_new_texttrace_device(PyObject* out) { mupdf::FzDevice device(sizeof(jm_tracedraw_device)); jm_tracedraw_device* dev = (jm_tracedraw_device*) device.m_internal; dev->super.close_device = nullptr; dev->super.drop_device = jm_lineart_drop_device; dev->super.fill_path = jm_fill_path; dev->super.stroke_path = jm_stroke_path; dev->super.clip_path = nullptr; dev->super.clip_stroke_path = nullptr; dev->super.fill_text = jm_tracedraw_fill_text; dev->super.stroke_text = jm_tracedraw_stroke_text; dev->super.clip_text = nullptr; dev->super.clip_stroke_text = nullptr; dev->super.ignore_text = jm_tracedraw_ignore_text; dev->super.fill_shade = jm_fill_shade; dev->super.fill_image = jm_fill_image; dev->super.fill_image_mask = jm_fill_image_mask; dev->super.clip_image_mask = nullptr; dev->super.pop_clip = nullptr; dev->super.begin_mask = nullptr; dev->super.end_mask = nullptr; dev->super.begin_group = nullptr; dev->super.end_group = nullptr; dev->super.begin_tile = nullptr; dev->super.end_tile = nullptr; dev->super.begin_layer = jm_lineart_begin_layer; dev->super.end_layer = jm_lineart_end_layer; dev->super.begin_structure = nullptr; dev->super.end_structure = nullptr; dev->super.begin_metatext = nullptr; dev->super.end_metatext = nullptr; dev->super.render_flags = nullptr; dev->super.set_default_colorspaces = nullptr; Py_XINCREF(out); dev->out = out; dev->seqno = 0; return device; } static fz_quad JM_char_quad(fz_stext_line *line, fz_stext_char *ch) { if (g_skip_quad_corrections) { // no special handling return ch->quad; } if (line->wmode) { // never touch vertical write mode return ch->quad; } fz_font *font = ch->font; float asc = JM_font_ascender(font); float dsc = JM_font_descender(font); float c, s, fsize = ch->size; float asc_dsc = asc - dsc + FLT_EPSILON; if (asc_dsc >= 1 && g_small_glyph_heights == 0) { // no problem return ch->quad; } if (asc < 1e-3) { // probably Tesseract glyphless font dsc = -0.1f; asc = 0.9f; asc_dsc = 1.0f; } if (g_small_glyph_heights || asc_dsc < 1) { dsc = dsc / asc_dsc; asc = asc / asc_dsc; } asc_dsc = asc - dsc; asc = asc * fsize / asc_dsc; dsc = dsc * fsize / asc_dsc; /* ------------------------------ Re-compute quad with the adjusted ascender / descender values: Move ch->origin to (0,0) and de-rotate quad, then adjust the corners, re-rotate and move back to ch->origin location. ------------------------------ */ fz_matrix trm1, trm2, xlate1, xlate2; fz_quad quad; c = line->dir.x; // cosine s = line->dir.y; // sine trm1 = mupdf::ll_fz_make_matrix(c, -s, s, c, 0, 0); // derotate trm2 = mupdf::ll_fz_make_matrix(c, s, -s, c, 0, 0); // rotate if (c == -1) { // left-right flip trm1.d = 1; trm2.d = 1; } xlate1 = mupdf::ll_fz_make_matrix(1, 0, 0, 1, -ch->origin.x, -ch->origin.y); xlate2 = mupdf::ll_fz_make_matrix(1, 0, 0, 1, ch->origin.x, ch->origin.y); quad = mupdf::ll_fz_transform_quad(ch->quad, xlate1); // move origin to (0,0) quad = mupdf::ll_fz_transform_quad(quad, trm1); // de-rotate corners // adjust vertical coordinates if (c == 1 && quad.ul.y > 0) { // up-down flip quad.ul.y = asc; quad.ur.y = asc; quad.ll.y = dsc; quad.lr.y = dsc; } else { quad.ul.y = -asc; quad.ur.y = -asc; quad.ll.y = -dsc; quad.lr.y = -dsc; } // adjust horizontal coordinates that are too crazy: // (1) left x must be >= 0 // (2) if bbox width is 0, lookup char advance in font. if (quad.ll.x < 0) { quad.ll.x = 0; quad.ul.x = 0; } float cwidth = quad.lr.x - quad.ll.x; if (cwidth < FLT_EPSILON) { int glyph = mupdf::ll_fz_encode_character( font, ch->c); if (glyph) { float fwidth = mupdf::ll_fz_advance_glyph( font, glyph, line->wmode); quad.lr.x = quad.ll.x + fwidth * fsize; quad.ur.x = quad.lr.x; } } quad = mupdf::ll_fz_transform_quad(quad, trm2); // rotate back quad = mupdf::ll_fz_transform_quad(quad, xlate2); // translate back return quad; } static fz_rect JM_char_bbox(fz_stext_line* line, fz_stext_char* ch) { fz_rect r = mupdf::ll_fz_rect_from_quad(JM_char_quad( line, ch)); if (!line->wmode) { return r; } if (r.y1 < r.y0 + ch->size) { r.y0 = r.y1 - ch->size; } return r; } fz_rect JM_char_bbox(const mupdf::FzStextLine& line, const mupdf::FzStextChar& ch) { return JM_char_bbox( line.m_internal, ch.m_internal); } static int JM_rects_overlap(const fz_rect a, const fz_rect b) { if (0 || a.x0 >= b.x1 || a.y0 >= b.y1 || a.x1 <= b.x0 || a.y1 <= b.y0 ) return 0; return 1; } // void JM_append_rune(fz_buffer *buff, int ch); //----------------------------------------------------------------------------- // Plain text output. An identical copy of fz_print_stext_page_as_text, // but lines within a block are concatenated by space instead a new-line // character (which else leads to 2 new-lines). //----------------------------------------------------------------------------- void _as_text(fz_stext_block *block, mupdf::FzBuffer& res, mupdf::FzStextPage& page) { /* Recursive function for output by blocks as identified by the MuPDF SEGMENT logic. The recursion happens when we encounter a structure block. */ fz_rect rect = page.m_internal->mediabox; int last_char; fz_stext_line *line; fz_stext_char *ch; while (block) { switch (block->type) { case FZ_STEXT_BLOCK_STRUCT: if (block->u.s.down) { _as_text(block->u.s.down->first_block, res, page); } break; case FZ_STEXT_BLOCK_TEXT: last_char = 0; for (line = block->u.t.first_line; line; line = line->next) { for (ch = line->first_char; ch; ch = ch->next) { fz_rect chbbox = JM_char_bbox( line, ch); if (mupdf::ll_fz_is_infinite_rect(rect) || JM_rects_overlap(rect, chbbox)) { last_char = ch->c; JM_append_rune(res.m_internal, last_char); } } if (last_char != 10 && last_char > 0) { mupdf::ll_fz_append_string(res.m_internal, "\n"); last_char = 10; } } if (last_char != 10 && last_char > 0) { mupdf::ll_fz_append_string(res.m_internal, "\n"); last_char = 10; } break; } block = block->next; } } void JM_print_stext_page_as_text(mupdf::FzBuffer& res, mupdf::FzStextPage& page) { fz_stext_block *block = page.m_internal->first_block; _as_text(block, res, page); } // path_type is one of: #define FILL_PATH 1 #define STROKE_PATH 2 #define CLIP_PATH 3 #define CLIP_STROKE_PATH 4 // Every scissor of a clip is a sub rectangle of the preceding clip scissor if // the clip level is larger. static fz_rect compute_scissor(jm_lineart_device *dev) { PyObject *last_scissor = NULL; fz_rect scissor; if (!dev->scissors) { dev->scissors = PyList_New(0); } Py_ssize_t num_scissors = PyList_Size(dev->scissors); if (num_scissors > 0) { last_scissor = PyList_GET_ITEM(dev->scissors, num_scissors-1); scissor = JM_rect_from_py(last_scissor); scissor = fz_intersect_rect(scissor, dev->pathrect); } else { scissor = dev->pathrect; } LIST_APPEND_DROP(dev->scissors, JM_py_from_rect(scissor)); return scissor; } /* -------------------------------------------------------------------------- Check whether the last 4 lines represent a quad. Because of how we count, the lines are a polyline already, i.e. last point of a line equals 1st point of next line. So we check for a polygon (last line's end point equals start point). If not true we return 0. -------------------------------------------------------------------------- */ static int jm_checkquad(jm_lineart_device* dev) { PyObject *items = PyDict_GetItem(dev->pathdict, dictkey_items); Py_ssize_t i, len = PyList_Size(items); float f[8]; // coordinates of the 4 corners mupdf::FzPoint temp, lp; // line = (temp, lp) PyObject *rect; PyObject *line; // fill the 8 floats in f, start from items[-4:] for (i = 0; i < 4; i++) { // store line start points line = PyList_GET_ITEM(items, len - 4 + i); temp = JM_point_from_py(PyTuple_GET_ITEM(line, 1)); f[i * 2] = temp.x; f[i * 2 + 1] = temp.y; lp = JM_point_from_py(PyTuple_GET_ITEM(line, 2)); } if (lp.x != f[0] || lp.y != f[1]) { // not a polygon! //dev_linecount -= 1; return 0; } // we have detected a quad dev->linecount = 0; // reset this // a quad item is ("qu", (ul, ur, ll, lr)), where the tuple items // are pairs of floats representing a quad corner each. rect = PyTuple_New(2); PyTuple_SET_ITEM(rect, 0, PyUnicode_FromString("qu")); /* ---------------------------------------------------- * relationship of float array to quad points: * (0, 1) = ul, (2, 3) = ll, (6, 7) = ur, (4, 5) = lr ---------------------------------------------------- */ fz_quad q = fz_make_quad(f[0], f[1], f[6], f[7], f[2], f[3], f[4], f[5]); PyTuple_SET_ITEM(rect, 1, JM_py_from_quad(q)); PyList_SetItem(items, len - 4, rect); // replace item -4 by rect PyList_SetSlice(items, len - 3, len, NULL); // delete remaining 3 items return 1; } /* -------------------------------------------------------------------------- Check whether the last 3 path items represent a rectangle. Line 1 and 3 must be horizontal, line 2 must be vertical. Returns 1 if we have modified the path, otherwise 0. -------------------------------------------------------------------------- */ static int jm_checkrect(jm_lineart_device* dev) { dev->linecount = 0; // reset line count long orientation = 0; // area orientation of rectangle mupdf::FzPoint ll, lr, ur, ul; mupdf::FzRect r; PyObject *rect; PyObject *line0, *line2; PyObject *items = PyDict_GetItem(dev->pathdict, dictkey_items); Py_ssize_t len = PyList_Size(items); line0 = PyList_GET_ITEM(items, len - 3); ll = JM_point_from_py(PyTuple_GET_ITEM(line0, 1)); lr = JM_point_from_py(PyTuple_GET_ITEM(line0, 2)); // no need to extract "line1"! line2 = PyList_GET_ITEM(items, len - 1); ur = JM_point_from_py(PyTuple_GET_ITEM(line2, 1)); ul = JM_point_from_py(PyTuple_GET_ITEM(line2, 2)); /* --------------------------------------------------------------------- Assumption: When decomposing rects, MuPDF always starts with a horizontal line, followed by a vertical line, followed by a horizontal line. First line: (ll, lr), third line: (ul, ur). If 1st line is below 3rd line, we record anti-clockwise (+1), else clockwise (-1) orientation. --------------------------------------------------------------------- */ if (ll.y != lr.y || ll.x != ul.x || ur.y != ul.y || ur.x != lr.x) { goto drop_out; // not a rectangle } // we have a rect, replace last 3 "l" items by one "re" item. if (ul.y < lr.y) { r = fz_make_rect(ul.x, ul.y, lr.x, lr.y); orientation = 1; } else { r = fz_make_rect(ll.x, ll.y, ur.x, ur.y); orientation = -1; } rect = PyTuple_New(3); PyTuple_SET_ITEM(rect, 0, PyUnicode_FromString("re")); PyTuple_SET_ITEM(rect, 1, JM_py_from_rect(r)); PyTuple_SET_ITEM(rect, 2, PyLong_FromLong(orientation)); PyList_SetItem(items, len - 3, rect); // replace item -3 by rect PyList_SetSlice(items, len - 2, len, NULL); // delete remaining 2 items return 1; drop_out:; return 0; } static PyObject * jm_lineart_color(fz_colorspace *colorspace, const float *color) { float rgb[3]; if (colorspace) { mupdf::ll_fz_convert_color(colorspace, color, mupdf::ll_fz_device_rgb(), rgb, NULL, fz_default_color_params); return Py_BuildValue("fff", rgb[0], rgb[1], rgb[2]); } return PyTuple_New(0); } static void trace_moveto(fz_context *ctx, void *dev_, float x, float y) { jm_lineart_device* dev = (jm_lineart_device*) dev_; dev->lastpoint = mupdf::ll_fz_transform_point(fz_make_point(x, y), dev->ctm); if (mupdf::ll_fz_is_infinite_rect(dev->pathrect)) { dev->pathrect = mupdf::ll_fz_make_rect( dev->lastpoint.x, dev->lastpoint.y, dev->lastpoint.x, dev->lastpoint.y ); } dev->firstpoint = dev->lastpoint; dev->havemove = 1; dev->linecount = 0; // reset # of consec. lines } static void trace_lineto(fz_context *ctx, void *dev_, float x, float y) { jm_lineart_device* dev = (jm_lineart_device*) dev_; fz_point p1 = fz_transform_point(fz_make_point(x, y), dev->ctm); dev->pathrect = fz_include_point_in_rect(dev->pathrect, p1); PyObject *list = PyTuple_New(3); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("l")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev->lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(p1)); dev->lastpoint = p1; PyObject *items = PyDict_GetItem(dev->pathdict, dictkey_items); LIST_APPEND_DROP(items, list); dev->linecount += 1; // counts consecutive lines if (dev->linecount == 4 && dev->path_type != FILL_PATH) { // shrink to "re" or "qu" item jm_checkquad(dev); } } static void trace_curveto(fz_context *ctx, void *dev_, float x1, float y1, float x2, float y2, float x3, float y3) { jm_lineart_device* dev = (jm_lineart_device*) dev_; dev->linecount = 0; // reset # of consec. lines fz_point p1 = fz_make_point(x1, y1); fz_point p2 = fz_make_point(x2, y2); fz_point p3 = fz_make_point(x3, y3); p1 = fz_transform_point(p1, dev->ctm); p2 = fz_transform_point(p2, dev->ctm); p3 = fz_transform_point(p3, dev->ctm); dev->pathrect = fz_include_point_in_rect(dev->pathrect, p1); dev->pathrect = fz_include_point_in_rect(dev->pathrect, p2); dev->pathrect = fz_include_point_in_rect(dev->pathrect, p3); PyObject *list = PyTuple_New(5); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("c")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev->lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(p1)); PyTuple_SET_ITEM(list, 3, JM_py_from_point(p2)); PyTuple_SET_ITEM(list, 4, JM_py_from_point(p3)); dev->lastpoint = p3; PyObject *items = PyDict_GetItem(dev->pathdict, dictkey_items); LIST_APPEND_DROP(items, list); } static void trace_close(fz_context *ctx, void *dev_) { jm_lineart_device* dev = (jm_lineart_device*) dev_; if (dev->linecount == 3) { if (jm_checkrect(dev)) { return; } } dev->linecount = 0; // reset # of consec. lines if (dev->havemove) { if (dev->firstpoint.x != dev->lastpoint.x || dev->firstpoint.y != dev->lastpoint.y) { PyObject *list = PyTuple_New(3); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("l")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev->lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(dev->firstpoint)); dev->lastpoint = dev->firstpoint; PyObject *items = PyDict_GetItem(dev->pathdict, dictkey_items); LIST_APPEND_DROP(items, list); } dev->havemove = 0; DICT_SETITEMSTR_DROP(dev->pathdict, "closePath", JM_BOOL(0)); } else { DICT_SETITEMSTR_DROP(dev->pathdict, "closePath", JM_BOOL(1)); } } static const fz_path_walker trace_path_walker = { trace_moveto, trace_lineto, trace_curveto, trace_close }; /* --------------------------------------------------------------------- Create the "items" list of the path dictionary * either create or empty the path dictionary * reset the end point of the path * reset count of consecutive lines * invoke fz_walk_path(), which create the single items * if no items detected, empty path dict again --------------------------------------------------------------------- */ static void jm_lineart_path(jm_lineart_device *dev, const fz_path *path) { dev->pathrect = fz_infinite_rect; dev->linecount = 0; dev->lastpoint = fz_make_point(0, 0); dev->firstpoint = fz_make_point(0, 0); if (dev->pathdict) { Py_CLEAR(dev->pathdict); } dev->pathdict = PyDict_New(); DICT_SETITEM_DROP(dev->pathdict, dictkey_items, PyList_New(0)); mupdf::ll_fz_walk_path(path, &trace_path_walker, dev); // Check if any items were added ... if (!PyDict_GetItem(dev->pathdict, dictkey_items) || !PyList_Size(PyDict_GetItem(dev->pathdict, dictkey_items))) { Py_CLEAR(dev->pathdict); } } //--------------------------------------------------------------------------- // Append current path to list or merge into last path of the list. // (1) Append if first path, different item lists or not a 'stroke' version // of previous path // (2) If new path has the same items, merge its content into previous path // and change path["type"] to "fs". // (3) If "out" is callable, skip the previous and pass dictionary to it. //--------------------------------------------------------------------------- static void // todo: remove `method` arg - it is dev->method. jm_append_merge(jm_lineart_device *dev) { Py_ssize_t len; int rc; PyObject *prev; PyObject *previtems; PyObject *thisitems; const char *thistype; const char *prevtype; if (PyCallable_Check(dev->out) || dev->method != Py_None) { // function or method goto callback; } len = PyList_Size(dev->out); // len of output list so far if (len == 0) { // always append first path goto append; } thistype = PyUnicode_AsUTF8(PyDict_GetItem(dev->pathdict, dictkey_type)); if (strcmp(thistype, "s") != 0) { // if not stroke, then append goto append; } prev = PyList_GET_ITEM(dev->out, len - 1); // get prev path prevtype = PyUnicode_AsUTF8(PyDict_GetItem(prev, dictkey_type)); if (strcmp(prevtype, "f") != 0) { // if previous not fill, append goto append; } // last check: there must be the same list of items for "f" and "s". previtems = PyDict_GetItem(prev, dictkey_items); thisitems = PyDict_GetItem(dev->pathdict, dictkey_items); if (PyObject_RichCompareBool(previtems, thisitems, Py_NE)) { goto append; } rc = PyDict_Merge(prev, dev->pathdict, 0); // merge, do not override if (rc == 0) { DICT_SETITEM_DROP(prev, dictkey_type, PyUnicode_FromString("fs")); goto postappend; } else { messagef("could not merge stroke and fill path"); goto append; } append:; //printf("Appending to dev->out. len(dev->out)=%zi\n", PyList_Size(dev->out)); PyList_Append(dev->out, dev->pathdict); postappend:; Py_CLEAR(dev->pathdict); return; callback:; // callback function or method PyObject *resp = NULL; if (dev->method == Py_None) { resp = PyObject_CallFunctionObjArgs(dev->out, dev->pathdict, NULL); } else { resp = PyObject_CallMethodObjArgs(dev->out, dev->method, dev->pathdict, NULL); } if (resp) { Py_DECREF(resp); } else { messagef("calling cdrawings callback function/method failed!"); PyErr_Clear(); } Py_CLEAR(dev->pathdict); return; } static void jm_lineart_fill_path(fz_context *ctx, fz_device *dev_, const fz_path *path, int even_odd, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *) dev_; //printf("extra.jm_lineart_fill_path(): dev->seqno=%zi\n", dev->seqno); dev->ctm = ctm; //fz_concat(ctm, trace_device_ptm); dev->path_type = FILL_PATH; jm_lineart_path(dev, path); if (!dev->pathdict) { return; } DICT_SETITEM_DROP(dev->pathdict, dictkey_type, PyUnicode_FromString("f")); DICT_SETITEMSTR_DROP(dev->pathdict, "even_odd", JM_BOOL(even_odd)); DICT_SETITEMSTR_DROP(dev->pathdict, "fill_opacity", Py_BuildValue("f", alpha)); DICT_SETITEMSTR_DROP(dev->pathdict, "fill", jm_lineart_color(colorspace, color)); DICT_SETITEM_DROP(dev->pathdict, dictkey_rect, JM_py_from_rect(dev->pathrect)); DICT_SETITEMSTR_DROP(dev->pathdict, "seqno", PyLong_FromSize_t(dev->seqno)); DICT_SETITEMSTR_DROP(dev->pathdict, "layer", JM_UnicodeFromStr(dev->layer_name)); if (dev->clips) { DICT_SETITEMSTR_DROP(dev->pathdict, "level", PyLong_FromLong(dev->depth)); } jm_append_merge(dev); dev->seqno += 1; } static void jm_lineart_stroke_path(fz_context *ctx, fz_device *dev_, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *)dev_; //printf("extra.jm_lineart_stroke_path(): dev->seqno=%zi\n", dev->seqno); int i; dev->pathfactor = sqrtf(fabsf(ctm.a * ctm.d - ctm.b * ctm.c)); dev->ctm = ctm; // fz_concat(ctm, trace_device_ptm); dev->path_type = STROKE_PATH; jm_lineart_path(dev, path); if (!dev->pathdict) { return; } DICT_SETITEM_DROP(dev->pathdict, dictkey_type, PyUnicode_FromString("s")); DICT_SETITEMSTR_DROP(dev->pathdict, "stroke_opacity", Py_BuildValue("f", alpha)); DICT_SETITEMSTR_DROP(dev->pathdict, "color", jm_lineart_color(colorspace, color)); DICT_SETITEM_DROP(dev->pathdict, dictkey_width, Py_BuildValue("f", dev->pathfactor * stroke->linewidth)); DICT_SETITEMSTR_DROP(dev->pathdict, "lineCap", Py_BuildValue("iii", stroke->start_cap, stroke->dash_cap, stroke->end_cap)); DICT_SETITEMSTR_DROP(dev->pathdict, "lineJoin", Py_BuildValue("f", (float)stroke->linejoin)); if (!PyDict_GetItemString(dev->pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev->pathdict, "closePath", JM_BOOL(0)); } // output the "dashes" string if (stroke->dash_len) { mupdf::FzBuffer buff(256); mupdf::fz_append_string(buff, "[ "); // left bracket for (i = 0; i < stroke->dash_len; i++) { fz_append_printf(ctx, buff.m_internal, "%g ", dev->pathfactor * stroke->dash_list[i]); } fz_append_printf(ctx, buff.m_internal, "] %g", dev->pathfactor * stroke->dash_phase); DICT_SETITEMSTR_DROP(dev->pathdict, "dashes", JM_EscapeStrFromBuffer(buff)); } else { DICT_SETITEMSTR_DROP(dev->pathdict, "dashes", PyUnicode_FromString("[] 0")); } DICT_SETITEM_DROP(dev->pathdict, dictkey_rect, JM_py_from_rect(dev->pathrect)); DICT_SETITEMSTR_DROP(dev->pathdict, "layer", JM_UnicodeFromStr(dev->layer_name)); DICT_SETITEMSTR_DROP(dev->pathdict, "seqno", PyLong_FromSize_t(dev->seqno)); if (dev->clips) { DICT_SETITEMSTR_DROP(dev->pathdict, "level", PyLong_FromLong(dev->depth)); } // output the dict - potentially merging it with a previous fill_path twin jm_append_merge(dev); dev->seqno += 1; } static void jm_lineart_clip_path(fz_context *ctx, fz_device *dev_, const fz_path *path, int even_odd, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; dev->ctm = ctm; //fz_concat(ctm, trace_device_ptm); dev->path_type = CLIP_PATH; jm_lineart_path(dev, path); if (!dev->pathdict) { return; } DICT_SETITEM_DROP(dev->pathdict, dictkey_type, PyUnicode_FromString("clip")); DICT_SETITEMSTR_DROP(dev->pathdict, "even_odd", JM_BOOL(even_odd)); if (!PyDict_GetItemString(dev->pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev->pathdict, "closePath", JM_BOOL(0)); } DICT_SETITEMSTR_DROP(dev->pathdict, "scissor", JM_py_from_rect(compute_scissor(dev))); DICT_SETITEMSTR_DROP(dev->pathdict, "level", PyLong_FromLong(dev->depth)); DICT_SETITEMSTR_DROP(dev->pathdict, "layer", JM_UnicodeFromStr(dev->layer_name)); jm_append_merge(dev); dev->depth++; } static void jm_lineart_clip_stroke_path(fz_context *ctx, fz_device *dev_, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; dev->ctm = ctm; //fz_concat(ctm, trace_device_ptm); dev->path_type = CLIP_STROKE_PATH; jm_lineart_path(dev, path); if (!dev->pathdict) { return; } DICT_SETITEM_DROP(dev->pathdict, dictkey_type, PyUnicode_FromString("clip")); DICT_SETITEMSTR_DROP(dev->pathdict, "even_odd", Py_BuildValue("s", NULL)); if (!PyDict_GetItemString(dev->pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev->pathdict, "closePath", JM_BOOL(0)); } DICT_SETITEMSTR_DROP(dev->pathdict, "scissor", JM_py_from_rect(compute_scissor(dev))); DICT_SETITEMSTR_DROP(dev->pathdict, "level", PyLong_FromLong(dev->depth)); DICT_SETITEMSTR_DROP(dev->pathdict, "layer", JM_UnicodeFromStr(dev->layer_name)); jm_append_merge(dev); dev->depth++; } static void jm_lineart_clip_stroke_text(fz_context *ctx, fz_device *dev_, const fz_text *text, const fz_stroke_state *stroke, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; compute_scissor(dev); dev->depth++; } static void jm_lineart_clip_text(fz_context *ctx, fz_device *dev_, const fz_text *text, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; compute_scissor(dev); dev->depth++; } static void jm_lineart_clip_image_mask(fz_context *ctx, fz_device *dev_, fz_image *image, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; compute_scissor(dev); dev->depth++; } static void jm_lineart_pop_clip(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; if (!dev->scissors) return; Py_ssize_t len = PyList_Size(dev->scissors); if (len < 1) return; PyList_SetSlice(dev->scissors, len - 1, len, NULL); dev->depth--; } static void jm_lineart_begin_group(fz_context *ctx, fz_device *dev_, fz_rect bbox, fz_colorspace *cs, int isolated, int knockout, int blendmode, float alpha) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; dev->pathdict = Py_BuildValue("{s:s,s:N,s:N,s:N,s:s,s:f,s:i,s:N}", "type", "group", "rect", JM_py_from_rect(bbox), "isolated", JM_BOOL(isolated), "knockout", JM_BOOL(knockout), "blendmode", fz_blendmode_name(blendmode), "opacity", alpha, "level", dev->depth, "layer", JM_UnicodeFromStr(dev->layer_name) ); jm_append_merge(dev); dev->depth++; } static void jm_lineart_end_group(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; dev->depth--; } static void jm_lineart_fill_text(fz_context *ctx, fz_device *dev, const fz_text *, fz_matrix, fz_colorspace *, const float *color, float alpha, fz_color_params) { jm_increase_seqno(ctx, dev); } static void jm_lineart_stroke_text(fz_context *ctx, fz_device *dev, const fz_text *, const fz_stroke_state *, fz_matrix, fz_colorspace *, const float *color, float alpha, fz_color_params) { jm_increase_seqno(ctx, dev); } static void jm_lineart_fill_shade(fz_context *ctx, fz_device *dev, fz_shade *shd, fz_matrix ctm, float alpha, fz_color_params color_params) { jm_increase_seqno(ctx, dev); } static void jm_lineart_fill_image(fz_context *ctx, fz_device *dev, fz_image *img, fz_matrix ctm, float alpha, fz_color_params color_params) { jm_increase_seqno(ctx, dev); } static void jm_lineart_fill_image_mask(fz_context *ctx, fz_device *dev, fz_image *img, fz_matrix ctm, fz_colorspace *, const float *color, float alpha, fz_color_params color_params) { jm_increase_seqno(ctx, dev); } static void jm_lineart_ignore_text(fz_context *ctx, fz_device *dev, const fz_text *, fz_matrix) { jm_increase_seqno(ctx, dev); } //------------------------------------------------------------------- // LINEART device for Python method Page.get_cdrawings() //------------------------------------------------------------------- mupdf::FzDevice JM_new_lineart_device(PyObject *out, int clips, PyObject *method) { //printf("extra.JM_new_lineart_device()\n"); jm_lineart_device* dev = (jm_lineart_device*) mupdf::ll_fz_new_device_of_size(sizeof(jm_lineart_device)); dev->super.close_device = NULL; dev->super.drop_device = jm_lineart_drop_device; dev->super.fill_path = jm_lineart_fill_path; dev->super.stroke_path = jm_lineart_stroke_path; dev->super.clip_path = jm_lineart_clip_path; dev->super.clip_stroke_path = jm_lineart_clip_stroke_path; dev->super.fill_text = jm_lineart_fill_text; dev->super.stroke_text = jm_lineart_stroke_text; dev->super.clip_text = jm_lineart_clip_text; dev->super.clip_stroke_text = jm_lineart_clip_stroke_text; dev->super.ignore_text = jm_lineart_ignore_text; dev->super.fill_shade = jm_lineart_fill_shade; dev->super.fill_image = jm_lineart_fill_image; dev->super.fill_image_mask = jm_lineart_fill_image_mask; dev->super.clip_image_mask = jm_lineart_clip_image_mask; dev->super.pop_clip = jm_lineart_pop_clip; dev->super.begin_mask = NULL; dev->super.end_mask = NULL; dev->super.begin_group = jm_lineart_begin_group; dev->super.end_group = jm_lineart_end_group; dev->super.begin_tile = NULL; dev->super.end_tile = NULL; dev->super.begin_layer = jm_lineart_begin_layer; dev->super.end_layer = jm_lineart_end_layer; dev->super.begin_structure = NULL; dev->super.end_structure = NULL; dev->super.begin_metatext = NULL; dev->super.end_metatext = NULL; dev->super.render_flags = NULL; dev->super.set_default_colorspaces = NULL; if (PyList_Check(out)) { Py_INCREF(out); } Py_INCREF(method); dev->out = out; dev->seqno = 0; dev->depth = 0; dev->clips = clips; dev->method = method; dev->pathdict = nullptr; return mupdf::FzDevice(&dev->super); } PyObject* get_cdrawings(mupdf::FzPage& page, PyObject *extended=NULL, PyObject *callback=NULL, PyObject *method=NULL) { //fz_page *page = (fz_page *) $self; //fz_device *dev = NULL; PyObject *rc = NULL; int clips = PyObject_IsTrue(extended); mupdf::FzDevice dev; if (PyCallable_Check(callback) || method != Py_None) { dev = JM_new_lineart_device(callback, clips, method); } else { rc = PyList_New(0); dev = JM_new_lineart_device(rc, clips, method); } mupdf::FzRect prect = mupdf::fz_bound_page(page); ((jm_lineart_device*) dev.m_internal)->ptm = mupdf::ll_fz_make_matrix(1, 0, 0, -1, 0, prect.y1); mupdf::FzCookie cookie; mupdf::FzMatrix identity; mupdf::fz_run_page( page, dev, *identity.internal(), cookie); mupdf::fz_close_device( dev); if (PyCallable_Check(callback) || method != Py_None) { Py_RETURN_NONE; } return rc; } static int detect_super_script(fz_stext_line *line, fz_stext_char *ch) { if (line->wmode == 0 && line->dir.x == 1 && line->dir.y == 0) { return ch->origin.y < line->first_char->origin.y - ch->size * 0.1f; } return 0; } static int JM_char_font_flags(fz_font *font, fz_stext_line *line, fz_stext_char *ch) { int flags = detect_super_script(line, ch); flags += mupdf::ll_fz_font_is_italic(font) * TEXT_FONT_ITALIC; flags += mupdf::ll_fz_font_is_serif(font) * TEXT_FONT_SERIFED; flags += mupdf::ll_fz_font_is_monospaced(font) * TEXT_FONT_MONOSPACED; flags += mupdf::ll_fz_font_is_bold(font) * TEXT_FONT_BOLD; return flags; } //--------------------------------------------------------------------------- // APPEND non-ascii runes in unicode escape format to fz_buffer //--------------------------------------------------------------------------- void JM_append_rune(fz_buffer *buff, int ch) { char text[32]; if (ch == 92) // prevent accidental "\u", "\U" sequences { mupdf::ll_fz_append_string(buff, "\\u005c"); } else if ((ch >= 32 && ch <= 127) || ch == 10) { mupdf::ll_fz_append_byte(buff, ch); } else if (ch >= 0xd800 && ch <= 0xdfff) // orphaned surrogate Unicodes { mupdf::ll_fz_append_string(buff, "\\ufffd"); } else if (ch <= 0xffff) { // 4 hex digits snprintf(text, sizeof(text), "\\u%04x", ch); mupdf::ll_fz_append_string(buff, text); } else { // 8 hex digits snprintf(text, sizeof(text), "\\U%08x", ch); mupdf::ll_fz_append_string(buff, text); } } mupdf::FzRect JM_make_spanlist( PyObject *line_dict, mupdf::FzStextLine& line, int raw, mupdf::FzBuffer& buff, mupdf::FzRect& tp_rect ) { PyObject *span = NULL, *char_list = NULL, *char_dict; PyObject *span_list = PyList_New(0); mupdf::fz_clear_buffer(buff); fz_rect span_rect = fz_empty_rect; fz_rect line_rect = fz_empty_rect; fz_point span_origin = {0, 0}; struct char_style { float size = -1; unsigned flags = 0; /* From mupdf:include/mupdf/fitz/structured-text.h:fz_stext_char::flags, which uses anonymous enum values: FZ_STEXT_STRIKEOUT = 1, FZ_STEXT_UNDERLINE = 2, FZ_STEXT_SYNTHETIC = 4, FZ_STEXT_FILLED = 16, FZ_STEXT_STROKED = 32, FZ_STEXT_CLIPPED = 64 */ unsigned char_flags = 0; const char *font = ""; unsigned argb = 0; float asc = 0; float desc = 0; uint16_t bidi = 0; }; char_style old_style; char_style style; for (mupdf::FzStextChar ch: line) { fz_rect r = JM_char_bbox(line, ch); if (!JM_rects_overlap(*tp_rect.internal(), r) && !fz_is_infinite_rect(tp_rect)) { continue; } /* Info from: detect_super_script() fz_font_is_italic() fz_font_is_serif() fz_font_is_monospaced() fz_font_is_bold() */ int flags = JM_char_font_flags( ch.m_internal->font, line.m_internal, ch.m_internal); fz_point origin = ch.m_internal->origin; style.size = ch.m_internal->size; style.flags = flags; /* FZ_STEXT_SYNTHETIC is per-char, not per-span. */ style.char_flags = ch.m_internal->flags & ~FZ_STEXT_SYNTHETIC; style.font = JM_font_name(ch.m_internal->font); style.argb = ch.m_internal->argb; style.asc = JM_font_ascender(ch.m_internal->font); style.desc = JM_font_descender(ch.m_internal->font); if (0 || style.size != old_style.size || style.flags != old_style.flags || style.char_flags != old_style.char_flags || style.argb != old_style.argb || strcmp(style.font, old_style.font) != 0 || style.bidi != old_style.bidi ) { if (old_style.size >= 0) { // not first one, output previous if (raw) { // put character list in the span DICT_SETITEM_DROP(span, dictkey_chars, char_list); char_list = NULL; } else { // put text string in the span DICT_SETITEM_DROP(span, dictkey_text, JM_EscapeStrFromBuffer(buff)); mupdf::fz_clear_buffer(buff); } DICT_SETITEM_DROP(span, dictkey_origin, JM_py_from_point(span_origin)); DICT_SETITEM_DROP(span, dictkey_bbox, JM_py_from_rect(span_rect)); line_rect = mupdf::ll_fz_union_rect(line_rect, span_rect); LIST_APPEND_DROP(span_list, span); span = NULL; } span = PyDict_New(); float asc = style.asc, desc = style.desc; if (style.asc < 1e-3) { asc = 0.9f; desc = -0.1f; } DICT_SETITEM_DROP(span, dictkey_size, Py_BuildValue("f", style.size)); DICT_SETITEM_DROP(span, dictkey_flags, Py_BuildValue("I", style.flags)); DICT_SETITEM_DROP(span, dictkey_bidi, Py_BuildValue("I", style.bidi)); DICT_SETITEM_DROP(span, dictkey_char_flags, Py_BuildValue("I", style.char_flags)); DICT_SETITEM_DROP(span, dictkey_font, JM_EscapeStrFromStr(style.font)); DICT_SETITEM_DROP(span, dictkey_color, Py_BuildValue("I", style.argb & 0xffffff)); DICT_SETITEMSTR_DROP(span, "alpha", Py_BuildValue("I", style.argb >> 24)); DICT_SETITEMSTR_DROP(span, "ascender", Py_BuildValue("f", asc)); DICT_SETITEMSTR_DROP(span, "descender", Py_BuildValue("f", desc)); old_style = style; span_rect = r; span_origin = origin; } span_rect = mupdf::ll_fz_union_rect(span_rect, r); if (raw) { // make and append a char dict char_dict = PyDict_New(); DICT_SETITEM_DROP(char_dict, dictkey_origin, JM_py_from_point(ch.m_internal->origin)); DICT_SETITEM_DROP(char_dict, dictkey_bbox, JM_py_from_rect(r)); DICT_SETITEM_DROP(char_dict, dictkey_c, Py_BuildValue("C", ch.m_internal->c)); DICT_SETITEMSTR_DROP(char_dict, "synthetic", Py_BuildValue("O", (ch.m_internal->flags & FZ_STEXT_SYNTHETIC) ? Py_True : Py_False)); if (!char_list) { char_list = PyList_New(0); } LIST_APPEND_DROP(char_list, char_dict); } else { // add character byte to buffer JM_append_rune(buff.m_internal, ch.m_internal->c); } } // all characters processed, now flush remaining span if (span) { if (raw) { DICT_SETITEM_DROP(span, dictkey_chars, char_list); char_list = NULL; } else { DICT_SETITEM_DROP(span, dictkey_text, JM_EscapeStrFromBuffer(buff)); mupdf::fz_clear_buffer(buff); } DICT_SETITEM_DROP(span, dictkey_origin, JM_py_from_point(span_origin)); DICT_SETITEM_DROP(span, dictkey_bbox, JM_py_from_rect(span_rect)); if (!fz_is_empty_rect(span_rect)) { LIST_APPEND_DROP(span_list, span); line_rect = fz_union_rect(line_rect, span_rect); } else { Py_DECREF(span); } span = NULL; } if (!mupdf::fz_is_empty_rect(line_rect)) { DICT_SETITEM_DROP(line_dict, dictkey_spans, span_list); } else { DICT_SETITEM_DROP(line_dict, dictkey_spans, span_list); } return line_rect; } //----------------------------------------------------------------------------- // Functions for wordlist output //----------------------------------------------------------------------------- int JM_append_word( PyObject* lines, fz_buffer* buff, fz_rect* wbbox, int block_n, int line_n, int word_n ) { PyObject* s = JM_EscapeStrFromBuffer(buff); PyObject* litem = Py_BuildValue( "ffffOiii", wbbox->x0, wbbox->y0, wbbox->x1, wbbox->y1, s, block_n, line_n, word_n ); LIST_APPEND_DROP(lines, litem); Py_DECREF(s); *wbbox = fz_empty_rect; return word_n + 1; // word counter } int _as_words(fz_stext_block *block, mupdf::FzBuffer& buff, fz_rect tp_rect, PyObject *lines, int block_n, PyObject *delimiters) { /* 'buff' is intermediate storage for composing a word. Used as parameter only for avoiding repeated allocation of an FzBuffer.*/ int line_n; fz_stext_line *line; fz_stext_char *ch; fz_rect wbbox, blockrect; while (block) { switch (block->type) { case FZ_STEXT_BLOCK_STRUCT: if (block->u.s.down) { block_n = _as_words(block->u.s.down->first_block, buff, tp_rect, lines, block_n, delimiters); } break; case FZ_STEXT_BLOCK_TEXT: block_n++; blockrect = block->bbox; wbbox = fz_empty_rect; line_n = -1; for (line = block->u.t.first_line; line; line = line->next) { line_n++; int word_n = 0; // word counter per line mupdf::fz_clear_buffer(buff); // reset word buffer int last_char_rtl = 0; // was last character RTL? for (ch = line->first_char; ch; ch = ch->next) { mupdf::FzRect cbbox = JM_char_bbox(line, ch); if (!JM_rects_overlap(tp_rect, *cbbox.internal()) && !fz_is_infinite_rect(tp_rect)) { continue; } // prevent Unicode ZWJ 0x200d to start a word if (mupdf::fz_buffer_storage(buff, NULL) == 0 && ch->c == 0x200d) { continue; } int word_delimiter = JM_is_word_delimiter(ch->c, delimiters); int this_char_rtl = JM_is_rtl_char(ch->c); if (word_delimiter || this_char_rtl != last_char_rtl) { if (mupdf::fz_buffer_storage(buff, NULL) == 0 && word_delimiter) { continue; // skip delimiters at line start } if (!fz_is_empty_rect(wbbox)) { word_n = JM_append_word( lines, buff.m_internal, &wbbox, block_n, line_n, word_n ); } mupdf::fz_clear_buffer(buff); if (word_delimiter) continue; } // append one unicode character to the word JM_append_rune(buff.m_internal, ch->c); last_char_rtl = this_char_rtl; // enlarge word bbox wbbox = fz_union_rect(wbbox, JM_char_bbox(line, ch)); } if (mupdf::fz_buffer_storage(buff, NULL) && !fz_is_empty_rect(wbbox)) { word_n = JM_append_word( lines, buff.m_internal, &wbbox, block_n, line_n, word_n ); } mupdf::fz_clear_buffer(buff); } break; } block = block->next; } return block_n; } PyObject* extractWORDS(mupdf::FzStextPage& this_tpage, PyObject *delimiters) { int block_n = -1; fz_rect tp_rect = this_tpage.m_internal->mediabox; PyObject *lines = NULL; mupdf::FzBuffer buff = mupdf::fz_new_buffer(64); lines = PyList_New(0); mupdf::FzStextBlock block = this_tpage.m_internal->first_block; block_n = _as_words(block.m_internal, buff, tp_rect, lines, block_n, delimiters); return lines; } struct ScopedPyObject /* PyObject* wrapper, destructor calls Py_CLEAR() unless `release()` has been called. */ { ScopedPyObject(PyObject* rhs=nullptr) : m_pyobject(rhs) {} PyObject*& get() { return m_pyobject; } ScopedPyObject& operator= (PyObject* rhs) { Py_CLEAR(m_pyobject); m_pyobject = rhs; return *this; } PyObject* release() { PyObject* ret = m_pyobject; m_pyobject = nullptr; return ret; } ~ScopedPyObject() { Py_CLEAR(m_pyobject); } PyObject* m_pyobject = nullptr; }; int _as_blocks(fz_stext_block *block, fz_rect tp_rect, PyObject *lines, int block_n) { /* Recursive function for output by blocks as identified by the MuPDF SEGMENT logic. Recursion happens on encountering a structure block. In addition to the previous support of text and image, we now also support vector blocks. */ PyObject *text = NULL; fz_rect blockrect; mupdf::FzBuffer res; int last_char; while (block) { switch (block->type) { case FZ_STEXT_BLOCK_STRUCT: if (block->u.s.down) { block_n = _as_blocks(block->u.s.down->first_block, tp_rect, lines, block_n); } break; case FZ_STEXT_BLOCK_TEXT: blockrect = fz_empty_rect; res = mupdf::fz_new_buffer(1024); last_char = 10; for (fz_stext_line* line = block->u.t.first_line; line; line = line->next) { fz_rect linerect = fz_empty_rect; for (fz_stext_char* ch = line->first_char; ch; ch = ch->next) { fz_rect cbbox = JM_char_bbox(line, ch); if (!JM_rects_overlap(tp_rect, cbbox) && !fz_is_infinite_rect(tp_rect)) { continue; } JM_append_rune(res.m_internal, ch->c); last_char = ch->c; linerect = fz_union_rect(linerect, cbbox); } if (last_char != 10 && !fz_is_empty_rect(linerect)) { JM_append_rune(res.m_internal, 10); } blockrect = fz_union_rect(blockrect, linerect); } text = JM_EscapeStrFromBuffer(res); break; case FZ_STEXT_BLOCK_IMAGE: if (fz_contains_rect(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { blockrect = block->bbox; fz_image *img = block->u.i.image; fz_colorspace *cs = img->colorspace; text = PyUnicode_FromFormat( "\n", mupdf::ll_fz_colorspace_name(cs), img->w, img->h, img->bpc ); } break; case FZ_STEXT_BLOCK_VECTOR: if (JM_rects_overlap(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { blockrect = block->bbox; int alpha = (int) (block->u.v.argb >> 24); int color = (int) (block->u.v.argb & 0xffffff); text = PyUnicode_FromFormat( "\n\n", (block->u.v.flags & FZ_STEXT_VECTOR_IS_STROKED) ? "stroked" : "filled", color, alpha, (block->u.v.flags & FZ_STEXT_VECTOR_IS_RECTANGLE) ? "true":"false", (block->u.v.flags & FZ_STEXT_VECTOR_CONTINUES) ? "true":"false"); } break; } if (text) { block_n += 1; PyObject *litem = PyTuple_New(7); PyTuple_SET_ITEM(litem, 0, Py_BuildValue("f", blockrect.x0)); PyTuple_SET_ITEM(litem, 1, Py_BuildValue("f", blockrect.y0)); PyTuple_SET_ITEM(litem, 2, Py_BuildValue("f", blockrect.x1)); PyTuple_SET_ITEM(litem, 3, Py_BuildValue("f", blockrect.y1)); PyTuple_SET_ITEM(litem, 4, Py_BuildValue("O", text)); PyTuple_SET_ITEM(litem, 5, Py_BuildValue("i", block_n)); PyTuple_SET_ITEM(litem, 6, Py_BuildValue("i", block->type)); LIST_APPEND(lines, litem); } text = NULL; block = block->next; } return block_n; } PyObject* extractBLOCKS(mupdf::FzStextPage& self) { fz_stext_page *this_tpage = self.m_internal; fz_rect tp_rect = this_tpage->mediabox; ScopedPyObject lines(PyList_New(0)); int block_n = -1; fz_stext_block *block = this_tpage->first_block; block_n = _as_blocks(block, tp_rect, lines.get(), block_n); return lines.release(); } #define EMPTY_STRING PyUnicode_FromString("") static PyObject *JM_UnicodeFromStr(const char *c) { if (!c) return EMPTY_STRING; PyObject *val = Py_BuildValue("s", c); if (!val) { val = EMPTY_STRING; PyErr_Clear(); } return val; } PyObject* link_uri(mupdf::FzLink& link) { return JM_UnicodeFromStr( link.m_internal->uri); } fz_stext_page* page_get_textpage( mupdf::FzPage& self, PyObject* clip, int flags, PyObject* matrix ) { fz_context* ctx = mupdf::internal_context_get(); fz_stext_page *tpage=NULL; fz_page *page = self.m_internal; fz_device *dev = NULL; fz_stext_options options; memset(&options, 0, sizeof options); options.flags = flags; fz_try(ctx) { // Default to page's rect if `clip` not specified, for #2048. fz_rect rect = (clip==Py_None) ? fz_bound_page(ctx, page) : JM_rect_from_py(clip); fz_matrix ctm = JM_matrix_from_py(matrix); tpage = fz_new_stext_page(ctx, rect); dev = fz_new_stext_device(ctx, tpage, &options); fz_run_page(ctx, page, dev, ctm, NULL); fz_close_device(ctx, dev); } fz_always(ctx) { fz_drop_device(ctx, dev); } fz_catch(ctx) { mupdf::internal_throw_exception(ctx); } return tpage; } // return extension for pymupdf image type const char *JM_image_extension(int type) { switch (type) { case(FZ_IMAGE_RAW): return "raw"; case(FZ_IMAGE_FLATE): return "flate"; case(FZ_IMAGE_LZW): return "lzw"; case(FZ_IMAGE_RLD): return "rld"; case(FZ_IMAGE_BMP): return "bmp"; case(FZ_IMAGE_GIF): return "gif"; case(FZ_IMAGE_JBIG2): return "jb2"; case(FZ_IMAGE_JPEG): return "jpeg"; case(FZ_IMAGE_JPX): return "jpx"; case(FZ_IMAGE_JXR): return "jxr"; case(FZ_IMAGE_PNG): return "png"; case(FZ_IMAGE_PNM): return "pnm"; case(FZ_IMAGE_TIFF): return "tiff"; default: return "n/a"; } } void JM_make_image_block(fz_stext_block *block, PyObject *block_dict) { fz_context* ctx = mupdf::internal_context_get(); fz_image *image = block->u.i.image; fz_buffer *buf = NULL, *freebuf = NULL, *mask_buf = NULL; fz_compressed_buffer *buffer = fz_compressed_image_buffer(ctx, image); fz_var(buf); fz_var(freebuf); fz_var(mask_buf); int n = fz_colorspace_n(ctx, image->colorspace); int w = image->w; int h = image->h; const char *ext = ""; int type = FZ_IMAGE_UNKNOWN; if (buffer) { type = buffer->params.type; ext = JM_image_extension(type); } if (type < FZ_IMAGE_BMP || type == FZ_IMAGE_JBIG2) type = FZ_IMAGE_UNKNOWN; PyObject *bytes = NULL; fz_var(bytes); PyObject *mask_bytes = NULL; fz_var(mask_bytes); fz_try(ctx) { if (!buffer || type == FZ_IMAGE_UNKNOWN) { buf = freebuf = fz_new_buffer_from_image_as_png(ctx, image, fz_default_color_params); ext = "png"; } else if (n == 4 && strcmp(ext, "jpeg") == 0) // JPEG CMYK needs another step { buf = freebuf = fz_new_buffer_from_image_as_jpeg(ctx, image, fz_default_color_params, 95, 1); } else { buf = buffer->buffer; } bytes = JM_BinFromBuffer(buf); if (image->mask) { mask_buf = fz_new_buffer_from_image_as_png(ctx, image->mask, fz_default_color_params); mask_bytes = JM_BinFromBuffer(mask_buf); } else { mask_bytes = Py_BuildValue("s", NULL); } } fz_always(ctx) { if (!bytes) bytes = PyBytes_FromString(""); DICT_SETITEM_DROP(block_dict, dictkey_width, Py_BuildValue("i", w)); DICT_SETITEM_DROP(block_dict, dictkey_height, Py_BuildValue("i", h)); DICT_SETITEM_DROP(block_dict, dictkey_ext, Py_BuildValue("s", ext)); DICT_SETITEM_DROP(block_dict, dictkey_colorspace, Py_BuildValue("i", n)); DICT_SETITEM_DROP(block_dict, dictkey_xres, Py_BuildValue("i", image->xres)); DICT_SETITEM_DROP(block_dict, dictkey_yres, Py_BuildValue("i", image->xres)); DICT_SETITEM_DROP(block_dict, dictkey_bpc, Py_BuildValue("i", (int) image->bpc)); DICT_SETITEM_DROP(block_dict, dictkey_matrix, JM_py_from_matrix(block->u.i.transform)); DICT_SETITEM_DROP(block_dict, dictkey_size, Py_BuildValue("n", PyBytes_Size(bytes))); DICT_SETITEM_DROP(block_dict, dictkey_image, bytes); DICT_SETITEMSTR_DROP(block_dict, "mask", mask_bytes); fz_drop_buffer(ctx, mask_buf); fz_drop_buffer(ctx, freebuf); } fz_catch(ctx) { fz_ignore_error(ctx); } return; } void JM_make_vector_block(fz_stext_block *block, PyObject *block_dict) { DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); DICT_SETITEMSTR_DROP(block_dict, "stroked", JM_BOOL(block->u.v.flags & FZ_STEXT_VECTOR_IS_STROKED)); DICT_SETITEMSTR_DROP(block_dict, "isrect", JM_BOOL(block->u.v.flags & FZ_STEXT_VECTOR_IS_RECTANGLE)); DICT_SETITEMSTR_DROP(block_dict, "continues", JM_BOOL(block->u.v.flags & FZ_STEXT_VECTOR_CONTINUES)); int color = (int) block->u.v.argb & 0xffffff; // extract color components int alpha = block->u.v.argb >> 24; // extract alpha value DICT_SETITEM_DROP(block_dict, dictkey_color, Py_BuildValue("i", color)); DICT_SETITEMSTR_DROP(block_dict, "alpha", Py_BuildValue("i", alpha)); return; } void JM_make_grid_block(fz_stext_block *block, PyObject *block_dict) { Py_ssize_t i; PyObject *pos; DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEMSTR_DROP(block_dict, "max_uncertain", Py_BuildValue("ii", block->u.b.xs->max_uncertainty, block->u.b.ys->max_uncertainty)); // x coordinates with uncertainties pos = PyList_New((size_t) block->u.b.xs->len); for (i = 0; i < block->u.b.xs->len; i++) { PyList_SetItem(pos, i, Py_BuildValue("fi", block->u.b.xs->list[i].pos, block->u.b.xs->list[i].uncertainty)); } DICT_SETITEMSTR_DROP(block_dict, "xpos", pos); // y coordinates with uncertainties pos = PyList_New((size_t) block->u.b.ys->len); for (i = 0; i < block->u.b.ys->len; i++) { PyList_SetItem(pos, i, Py_BuildValue("fi", block->u.b.ys->list[i].pos, block->u.b.ys->list[i].uncertainty)); } DICT_SETITEMSTR_DROP(block_dict, "ypos", pos); return; } void make_table_dict(fz_stext_page *tp, PyObject *table_dict, PyObject *bbox) { fz_rect bounds = JM_rect_from_py(bbox); fz_stext_block *block; try { block = mupdf::ll_fz_find_table_within_bounds(tp, bounds); } catch (std::exception&) { /* Ignore failure to find a table structure. */ return; } // Check if a table structure was found if (block && block->type == FZ_STEXT_BLOCK_GRID) { JM_make_grid_block(block, table_dict); } } static void JM_make_text_block(fz_stext_block *block, PyObject *block_dict, int raw, fz_buffer *buff, fz_rect tp_rect) { fz_stext_line *line; PyObject *line_list = PyList_New(0), *line_dict; fz_rect block_rect = fz_empty_rect; for (line = block->u.t.first_line; line; line = line->next) { if (fz_is_empty_rect(fz_intersect_rect(tp_rect, line->bbox)) && !fz_is_infinite_rect(tp_rect)) { continue; } line_dict = PyDict_New(); mupdf::FzStextLine line2(line); mupdf::FzBuffer buff2( mupdf::ll_fz_keep_buffer( buff)); mupdf::FzRect tp_rect2( tp_rect); mupdf::FzRect line_rect2 = JM_make_spanlist( line_dict, line2, raw, buff2, tp_rect2 ); fz_rect& line_rect = *line_rect2.internal(); block_rect = fz_union_rect(block_rect, line_rect); DICT_SETITEM_DROP(line_dict, dictkey_wmode, Py_BuildValue("i", line->wmode)); DICT_SETITEM_DROP(line_dict, dictkey_dir, JM_py_from_point(line->dir)); DICT_SETITEM_DROP(line_dict, dictkey_bbox, JM_py_from_rect(line_rect)); LIST_APPEND_DROP(line_list, line_dict); } DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block_rect)); DICT_SETITEM_DROP(block_dict, dictkey_lines, line_list); return; } void JM_make_struct_block(fz_stext_block *block, PyObject *block_dict) { DICT_SETITEMSTR_DROP(block_dict, "index", Py_BuildValue("i",block->u.s.index)); if (block->u.s.down) { DICT_SETITEMSTR_DROP(block_dict, "raw", Py_BuildValue("s",block->u.s.down->raw)); DICT_SETITEMSTR_DROP(block_dict, "std", Py_BuildValue("s",fz_structure_to_string(block->u.s.down->standard))); } } int _as_dict(PyObject *block_list, fz_stext_block *block, fz_buffer *text_buffer, int raw, fz_rect tp_rect, int block_n) { /* Recursive function for output by blocks as identified by the MuPDF SEGMENT logic. */ PyObject *block_dict; while (block) { switch (block->type) { case FZ_STEXT_BLOCK_STRUCT: if (block->u.s.down && block->u.s.down->first_block) { block_n++; block_dict = PyDict_New(); DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); JM_make_struct_block(block, block_dict); PyObject *subblocks = PyList_New(0); block_n = _as_dict(subblocks, block->u.s.down->first_block, text_buffer, raw, tp_rect, block_n); DICT_SETITEM_DROP(block_dict, dictkey_blocks, subblocks); LIST_APPEND_DROP(block_list, block_dict); } break; case FZ_STEXT_BLOCK_TEXT: if (JM_rects_overlap(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { block_dict = PyDict_New(); block_n++; DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); DICT_SETITEMSTR_DROP(block_dict, "flags", Py_BuildValue("i", block->u.t.flags)); JM_make_text_block(block, block_dict, raw, text_buffer, tp_rect); LIST_APPEND_DROP(block_list, block_dict); } break; case FZ_STEXT_BLOCK_IMAGE: if (fz_contains_rect(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { block_dict = PyDict_New(); block_n++; DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); JM_make_image_block(block, block_dict); LIST_APPEND_DROP(block_list, block_dict); } break; case FZ_STEXT_BLOCK_VECTOR: if (JM_rects_overlap(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { block_dict = PyDict_New(); block_n++; DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); JM_make_vector_block(block, block_dict); LIST_APPEND_DROP(block_list, block_dict); } break; case FZ_STEXT_BLOCK_GRID: if (JM_rects_overlap(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { block_dict = PyDict_New(); block_n++; DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); JM_make_grid_block(block, block_dict); LIST_APPEND_DROP(block_list, block_dict); } break; } block = block->next; } return block_n; } void JM_make_textpage_dict(fz_stext_page *tp, PyObject *page_dict, int raw) { fz_context* ctx = mupdf::internal_context_get(); fz_stext_block *block; fz_buffer *text_buffer = fz_new_buffer(ctx, 128); PyObject *block_list = PyList_New(0); fz_rect tp_rect = tp->mediabox; block = tp->first_block; int block_n = -1; block_n = _as_dict(block_list, block, text_buffer, raw, tp_rect, block_n); DICT_SETITEM_DROP(page_dict, dictkey_blocks, block_list); fz_drop_buffer(ctx, text_buffer); } //----------------------------------------------------------------- // get one pixel as a list //----------------------------------------------------------------- PyObject *pixmap_pixel(fz_pixmap* pm, int x, int y) { fz_context* ctx = mupdf::internal_context_get(); PyObject *p = NULL; if (0 || x < 0 || x >= pm->w || y < 0 || y >= pm->h ) { throw std::range_error( MSG_PIXEL_OUTSIDE); } int n = pm->n; int stride = fz_pixmap_stride(ctx, pm); int i = stride * y + n * x; p = PyTuple_New(n); for (int j = 0; j < n; j++) { PyTuple_SET_ITEM(p, j, Py_BuildValue("i", pm->samples[i + j])); } return p; } int pixmap_n(mupdf::FzPixmap& pixmap) { return mupdf::fz_pixmap_components( pixmap); } static int JM_INT_ITEM(PyObject *obj, Py_ssize_t idx, int *result) { PyObject *temp = PySequence_ITEM(obj, idx); if (!temp) return 1; if (PyLong_Check(temp)) { *result = (int) PyLong_AsLong(temp); Py_DECREF(temp); } else if (PyFloat_Check(temp)) { *result = (int) PyFloat_AsDouble(temp); Py_DECREF(temp); } else { Py_DECREF(temp); return 1; } if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } PyObject *set_pixel(fz_pixmap* pm, int x, int y, PyObject *color) { fz_context* ctx = mupdf::internal_context_get(); if (0 || x < 0 || x >= pm->w || y < 0 || y >= pm->h ) { throw std::range_error( MSG_PIXEL_OUTSIDE); } int n = pm->n; if (!PySequence_Check(color) || PySequence_Size(color) != n) { throw std::range_error(MSG_BAD_COLOR_SEQ); } int i, j; unsigned char c[5]; for (j = 0; j < n; j++) { if (JM_INT_ITEM(color, j, &i) == 1) { throw std::range_error(MSG_BAD_COLOR_SEQ); } if (i < 0 or i >= 256) { throw std::range_error(MSG_BAD_COLOR_SEQ); } c[j] = (unsigned char) i; } int stride = fz_pixmap_stride(ctx, pm); i = stride * y + n * x; for (j = 0; j < n; j++) { pm->samples[i + j] = c[j]; } Py_RETURN_NONE; } //------------------------------------------- // make a buffer from an stext_page's text //------------------------------------------- fz_buffer * JM_new_buffer_from_stext_page(fz_stext_page *page) { fz_context* ctx = mupdf::internal_context_get(); fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_rect rect = page->mediabox; fz_buffer *buf = NULL; fz_try(ctx) { buf = fz_new_buffer(ctx, 256); for (block = page->first_block; block; block = block->next) { if (block->type == FZ_STEXT_BLOCK_TEXT) { for (line = block->u.t.first_line; line; line = line->next) { for (ch = line->first_char; ch; ch = ch->next) { if (!JM_rects_overlap(rect, JM_char_bbox(line, ch)) && !fz_is_infinite_rect(rect)) { continue; } fz_append_rune(ctx, buf, ch->c); } fz_append_byte(ctx, buf, '\n'); } fz_append_byte(ctx, buf, '\n'); } } } fz_catch(ctx) { fz_drop_buffer(ctx, buf); mupdf::internal_throw_exception(ctx); } return buf; } static inline int canon(int c) { /* TODO: proper unicode case folding */ /* TODO: character equivalence (a matches ä, etc) */ if (c == 0xA0 || c == 0x2028 || c == 0x2029) return ' '; if (c == '\r' || c == '\n' || c == '\t') return ' '; if (c >= 'A' && c <= 'Z') return c - 'A' + 'a'; return c; } static inline int chartocanon(int *c, const char *s) { int n = fz_chartorune(c, s); *c = canon(*c); return n; } static const char *match_string(const char *h, const char *n) { int hc, nc; const char *e = h; h += chartocanon(&hc, h); n += chartocanon(&nc, n); while (hc == nc) { e = h; if (hc == ' ') do h += chartocanon(&hc, h); while (hc == ' '); else h += chartocanon(&hc, h); if (nc == ' ') do n += chartocanon(&nc, n); while (nc == ' '); else n += chartocanon(&nc, n); } return nc == 0 ? e : NULL; } static const char *find_string(const char *s, const char *needle, const char **endp) { const char *end; while (*s) { end = match_string(s, needle); if (end) { *endp = end; return s; } ++s; } *endp = NULL; return NULL; } struct highlight { Py_ssize_t len; PyObject *quads; float hfuzz, vfuzz; }; static int JM_FLOAT_ITEM(PyObject *obj, Py_ssize_t idx, double *result) { PyObject *temp = PySequence_ITEM(obj, idx); if (!temp) return 1; *result = PyFloat_AsDouble(temp); Py_DECREF(temp); if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } //----------------------------------------------------------------------------- // fz_quad from PySequence. Four floats are treated as rect. // Else must be four pairs of floats. //----------------------------------------------------------------------------- static fz_quad JM_quad_from_py(PyObject *r) { fz_quad q = fz_make_quad(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT); fz_point p[4]; double test, x, y; Py_ssize_t i; PyObject *obj = NULL; if (!r || !PySequence_Check(r) || PySequence_Size(r) != 4) return q; if (JM_FLOAT_ITEM(r, 0, &test) == 0) return fz_quad_from_rect(JM_rect_from_py(r)); for (i = 0; i < 4; i++) { obj = PySequence_ITEM(r, i); // next point item if (!obj || !PySequence_Check(obj) || PySequence_Size(obj) != 2) goto exit_result; // invalid: cancel the rest if (JM_FLOAT_ITEM(obj, 0, &x) == 1) goto exit_result; if (JM_FLOAT_ITEM(obj, 1, &y) == 1) goto exit_result; if (x < FZ_MIN_INF_RECT) x = FZ_MIN_INF_RECT; if (y < FZ_MIN_INF_RECT) y = FZ_MIN_INF_RECT; if (x > FZ_MAX_INF_RECT) x = FZ_MAX_INF_RECT; if (y > FZ_MAX_INF_RECT) y = FZ_MAX_INF_RECT; p[i] = fz_make_point((float) x, (float) y); Py_CLEAR(obj); } q.ul = p[0]; q.ur = p[1]; q.ll = p[2]; q.lr = p[3]; return q; exit_result:; Py_CLEAR(obj); return q; } static float hdist(fz_point *dir, fz_point *a, fz_point *b) { float dx = b->x - a->x; float dy = b->y - a->y; return fz_abs(dx * dir->x + dy * dir->y); } static float vdist(fz_point *dir, fz_point *a, fz_point *b) { float dx = b->x - a->x; float dy = b->y - a->y; return fz_abs(dx * dir->y + dy * dir->x); } static void on_highlight_char(fz_context *ctx, void *arg, fz_stext_line *line, fz_stext_char *ch) { struct highlight* hits = (struct highlight*) arg; float vfuzz = ch->size * hits->vfuzz; float hfuzz = ch->size * hits->hfuzz; fz_quad ch_quad = JM_char_quad(line, ch); if (hits->len > 0) { PyObject *quad = PySequence_ITEM(hits->quads, hits->len - 1); fz_quad end = JM_quad_from_py(quad); Py_DECREF(quad); if (hdist(&line->dir, &end.lr, &ch_quad.ll) < hfuzz && vdist(&line->dir, &end.lr, &ch_quad.ll) < vfuzz && hdist(&line->dir, &end.ur, &ch_quad.ul) < hfuzz && vdist(&line->dir, &end.ur, &ch_quad.ul) < vfuzz) { end.ur = ch_quad.ur; end.lr = ch_quad.lr; quad = JM_py_from_quad(end); PyList_SetItem(hits->quads, hits->len - 1, quad); return; } } LIST_APPEND_DROP(hits->quads, JM_py_from_quad(ch_quad)); hits->len++; } PyObject* JM_search_stext_page(fz_stext_page *page, const char *needle) { fz_context* ctx = mupdf::internal_context_get(); struct highlight hits; fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_buffer *buffer = NULL; const char *haystack, *begin, *end; fz_rect rect = page->mediabox; int c, inside; if (strlen(needle) == 0) Py_RETURN_NONE; PyObject *quads = PyList_New(0); hits.len = 0; hits.quads = quads; hits.hfuzz = 0.2f; /* merge kerns but not large gaps */ hits.vfuzz = 0.1f; fz_try(ctx) { buffer = JM_new_buffer_from_stext_page( page); haystack = fz_string_from_buffer(ctx, buffer); begin = find_string(haystack, needle, &end); if (!begin) goto no_more_matches; inside = 0; for (block = page->first_block; block; block = block->next) { if (block->type != FZ_STEXT_BLOCK_TEXT) { continue; } for (line = block->u.t.first_line; line; line = line->next) { for (ch = line->first_char; ch; ch = ch->next) { if (!fz_is_infinite_rect(rect) && !JM_rects_overlap(rect, JM_char_bbox(line, ch))) { goto next_char; } try_new_match: if (!inside) { if (haystack >= begin) inside = 1; } if (inside) { if (haystack < end) { on_highlight_char(ctx, &hits, line, ch); } else { inside = 0; begin = find_string(haystack, needle, &end); if (!begin) goto no_more_matches; else goto try_new_match; } } haystack += fz_chartorune(&c, haystack); next_char:; } assert(*haystack == '\n'); ++haystack; } assert(*haystack == '\n'); ++haystack; } no_more_matches:; } fz_always(ctx) fz_drop_buffer(ctx, buffer); fz_catch(ctx) mupdf::internal_throw_exception(ctx); return quads; } void pixmap_copy( fz_pixmap* pm, const fz_pixmap* src, int n) { assert(pm->w == src->w); assert(pm->h == src->h); assert(n <= pm->n); assert(n <= src->n); if (pm->n == src->n) { // identical samples assert(pm->stride == src->stride); memcpy(pm->samples, src->samples, pm->w * pm->h * pm->n); } else { int nn; int do_alpha; if (pm->n > src->n) { assert(pm->n == src->n + 1); nn = src->n; assert(!src->alpha); assert(pm->alpha); do_alpha = 1; } else { assert(src->n == pm->n + 1); nn = pm->n; assert(src->alpha); assert(!pm->alpha); do_alpha = 0; } for (int y=0; yh; ++y) { for (int x=0; xw; ++x) { memcpy( pm->samples + pm->stride * y + pm->n * x, src->samples + src->stride * y + src->n * x, nn ); if (do_alpha) { pm->samples[pm->stride * y + pm->n * x + pm->n-1] = 255; } } } } } PyObject* ll_JM_color_count(fz_pixmap *pm, PyObject *clip) { fz_context* ctx = mupdf::internal_context_get(); PyObject* rc = PyDict_New(); fz_irect irect = fz_pixmap_bbox(ctx, pm); irect = fz_intersect_irect(irect, fz_round_rect(JM_rect_from_py(clip))); if (fz_is_empty_irect(irect)) { return rc; } size_t stride = pm->stride; size_t width = irect.x1 - irect.x0; size_t height = irect.y1 - irect.y0; size_t n = (size_t) pm->n; size_t substride = width * n; unsigned char* s = pm->samples + stride * (irect.y0 - pm->y) + n * (irect.x0 - pm->x); // Cache previous pixel. char oldpix[10]; assert(n <= sizeof(oldpix)); memcpy(oldpix, s, n); long cnt = 0; for (size_t i = 0; i < height; i++) { for (size_t j = 0; j < substride; j += n) { const char* newpix = (const char*) s + j; if (memcmp(oldpix, newpix, n)) { /* Pixel differs from previous pixel, so update results with last run of pixels. We get a PyObject representation of pixel so we can look up in Python dict . */ PyObject* pixel = PyBytes_FromStringAndSize(&oldpix[0], n); PyObject* c = PyDict_GetItem(rc, pixel); if (c) cnt += PyLong_AsLong(c); DICT_SETITEM_DROP(rc, pixel, PyLong_FromLong(cnt)); Py_DECREF(pixel); /* Start next run of identical pixels. */ cnt = 1; memcpy(oldpix, newpix, n); } else { cnt += 1; } } s += stride; } /* Update results with last pixel. */ PyObject* pixel = PyBytes_FromStringAndSize(&oldpix[0], n); PyObject* c = PyDict_GetItem(rc, pixel); if (c) cnt += PyLong_AsLong(c); DICT_SETITEM_DROP(rc, pixel, PyLong_FromLong(cnt)); Py_DECREF(pixel); PyErr_Clear(); return rc; } %} /* Declarations for functions defined above. */ void page_merge( mupdf::PdfDocument& doc_des, mupdf::PdfDocument& doc_src, int page_from, int page_to, int rotate, int links, int copy_annots, mupdf::PdfGraftMap& graft_map ); void JM_merge_range( mupdf::PdfDocument& doc_des, mupdf::PdfDocument& doc_src, int spage, int epage, int apage, int rotate, int links, int annots, int show_progress, mupdf::PdfGraftMap& graft_map ); void FzDocument_insert_pdf( mupdf::FzDocument& doc, mupdf::FzDocument& src, int from_page, int to_page, int start_at, int rotate, int links, int annots, int show_progress, int final, mupdf::PdfGraftMap& graft_map ); int page_xref(mupdf::FzDocument& this_doc, int pno); void _newPage(mupdf::FzDocument& self, int pno=-1, float width=595, float height=842); void _newPage(mupdf::PdfDocument& self, int pno=-1, float width=595, float height=842); void JM_add_annot_id(mupdf::PdfAnnot& annot, const char* stem); void JM_set_annot_callout_line(mupdf::PdfAnnot& annot, PyObject *callout, int count); std::vector< std::string> JM_get_annot_id_list(mupdf::PdfPage& page); mupdf::PdfAnnot _add_caret_annot(mupdf::PdfPage& self, mupdf::FzPoint& point); mupdf::PdfAnnot _add_caret_annot(mupdf::FzPage& self, mupdf::FzPoint& point); const char* Tools_parse_da(mupdf::PdfAnnot& this_annot); PyObject* Annot_getAP(mupdf::PdfAnnot& annot); void Tools_update_da(mupdf::PdfAnnot& this_annot, const char* da_str); mupdf::FzPoint JM_point_from_py(PyObject* p); mupdf::FzRect Annot_rect(mupdf::PdfAnnot& annot); PyObject* util_transform_rect(PyObject* rect, PyObject* matrix); PyObject* Annot_rect3(mupdf::PdfAnnot& annot); mupdf::FzMatrix Page_derotate_matrix(mupdf::PdfPage& pdfpage); mupdf::FzMatrix Page_derotate_matrix(mupdf::FzPage& pdfpage); PyObject* JM_get_annot_xref_list(const mupdf::PdfObj& page_obj); PyObject* xref_object(mupdf::PdfDocument& pdf, int xref, int compressed=0, int ascii=0); PyObject* xref_object(mupdf::FzDocument& document, int xref, int compressed=0, int ascii=0); PyObject* Link_is_external(mupdf::FzLink& this_link); PyObject* Page_addAnnot_FromString(mupdf::PdfPage& page, PyObject* linklist); PyObject* Page_addAnnot_FromString(mupdf::FzPage& page, PyObject* linklist); mupdf::FzLink Link_next(mupdf::FzLink& this_link); static int page_count_fz2(void* document); int page_count_fz(mupdf::FzDocument& document); int page_count_pdf(mupdf::PdfDocument& pdf); int page_count(mupdf::FzDocument& document); int page_count(mupdf::PdfDocument& pdf); PyObject* page_annot_xrefs(mupdf::PdfDocument& pdf, int pno); PyObject* page_annot_xrefs(mupdf::FzDocument& document, int pno); bool Outline_is_external(mupdf::FzOutline* outline); void Document_extend_toc_items(mupdf::PdfDocument& pdf, PyObject* items); void Document_extend_toc_items(mupdf::FzDocument& document, PyObject* items); int ll_fz_absi(int i); mupdf::FzDevice JM_new_texttrace_device(PyObject* out); fz_rect JM_char_bbox(const mupdf::FzStextLine& line, const mupdf::FzStextChar& ch); static fz_quad JM_char_quad( fz_stext_line *line, fz_stext_char *ch); void JM_print_stext_page_as_text(mupdf::FzBuffer& res, mupdf::FzStextPage& page); void set_skip_quad_corrections(int on); void set_subset_fontnames(int on); void set_small_glyph_heights(int on); mupdf::FzRect JM_cropbox(mupdf::PdfObj& page_obj); PyObject* get_cdrawings(mupdf::FzPage& page, PyObject *extended=NULL, PyObject *callback=NULL, PyObject *method=NULL); mupdf::FzRect JM_make_spanlist( PyObject *line_dict, mupdf::FzStextLine& line, int raw, mupdf::FzBuffer& buff, mupdf::FzRect& tp_rect ); PyObject* extractWORDS(mupdf::FzStextPage& this_tpage, PyObject *delimiters); PyObject* extractBLOCKS(mupdf::FzStextPage& self); PyObject* link_uri(mupdf::FzLink& link); fz_stext_page* page_get_textpage( mupdf::FzPage& self, PyObject* clip, int flags, PyObject* matrix ); void make_table_dict(fz_stext_page *tp, PyObject *table_dict, PyObject *bbox); void JM_make_textpage_dict(fz_stext_page *tp, PyObject *page_dict, int raw); PyObject *pixmap_pixel(fz_pixmap* pm, int x, int y); int pixmap_n(mupdf::FzPixmap& pixmap); PyObject* JM_search_stext_page(fz_stext_page *page, const char *needle); PyObject *set_pixel(fz_pixmap* pm, int x, int y, PyObject *color); /* Copies from to , which must have same width and height. pm->n - src->n must be -1, 0 or +1. If -1, must have alpha and must not have alpha, and we copy the non-alpha bytes. If +1 must not have alpha and must have alpha and we set 's alpha bytes all to 255.*/ void pixmap_copy(fz_pixmap* pm, const fz_pixmap* src, int n); PyObject* ll_JM_color_count(fz_pixmap *pm, PyObject *clip); ================================================ FILE: src/fitz___init__.py ================================================ # pylint: disable=wildcard-import,unused-import,unused-wildcard-import,no-name-in-module from pymupdf import * from pymupdf import _as_fz_document from pymupdf import _as_fz_page from pymupdf import _as_pdf_document from pymupdf import _as_pdf_page from pymupdf import _log_items from pymupdf import _log_items_active from pymupdf import _log_items_clear from pymupdf import __version__ from pymupdf import __doc__ from pymupdf import _globals from pymupdf import _g_out_message ================================================ FILE: src/fitz_table.py ================================================ # pylint: disable=wildcard-import,unused-wildcard-import from pymupdf.table import * ================================================ FILE: src/fitz_utils.py ================================================ # pylint: disable=wildcard-import,unused-wildcard-import from pymupdf.utils import * ================================================ FILE: src/pipcl.py ================================================ ''' Python packaging operations, including PEP-517 support, for use by a `setup.py` script. Overview: The intention is to take care of as many packaging details as possible so that setup.py contains only project-specific information, while also giving as much flexibility as possible. For example we provide a function `build_extension()` that can be used to build a SWIG extension, but we also give access to the located compiler/linker so that a `setup.py` script can take over the details itself. Doctests: Doctest strings are provided in some comments. Test in the usual way with: python -m doctest pipcl.py Test specific functions/classes with: python pipcl.py --doctest run_if ... If no functions or classes are specified, this tests everything. Graal: For Graal we require that PIPCL_GRAAL_PYTHON is set to non-graal Python (we build for non-graal except with Graal Python's include paths and library directory). ''' import base64 import codecs import difflib import glob import hashlib import inspect import io import os import pickle import platform import re import shlex import shutil import site import subprocess import sys import sysconfig import tarfile import textwrap import time import zipfile import wdev class Package: ''' Our constructor takes a definition of a Python package similar to that passed to `distutils.core.setup()` or `setuptools.setup()` (name, version, summary etc) plus callbacks for building, getting a list of sdist filenames, and cleaning. We provide methods that can be used to implement a Python package's `setup.py` supporting PEP-517. We also support basic command line handling for use with a legacy (pre-PEP-517) pip, as implemented by legacy distutils/setuptools and described in: https://pip.pypa.io/en/stable/reference/build-system/setup-py/ The file pyproject.toml must exist; this is checked if/when fn_build() is called. Here is a `doctest` example of using pipcl to create a SWIG extension module. Requires `swig`. Create an empty test directory: >>> import os >>> import shutil >>> shutil.rmtree('pipcl_test', ignore_errors=1) >>> os.mkdir('pipcl_test') Create a `setup.py` which uses `pipcl` to define an extension module. >>> import textwrap >>> with open('pipcl_test/setup.py', 'w') as f: ... _ = f.write(textwrap.dedent(""" ... import sys ... import pipcl ... ... def build(): ... so_leaf = pipcl.build_extension( ... name = 'foo', ... path_i = 'foo.i', ... outdir = 'build', ... source_extra = 'wibble.c', ... ) ... return [ ... ('build/foo.py', 'foo/__init__.py'), ... ('cli.py', 'foo/__main__.py'), ... (f'build/{so_leaf}', f'foo/'), ... ('README', '$dist-info/'), ... (b'Hello world', 'foo/hw.txt'), ... ] ... ... def sdist(): ... return [ ... 'pyproject.toml', ... 'foo.i', ... 'bar.i', ... 'wibble.c', ... 'setup.py', ... 'pipcl.py', ... 'wdev.py', ... 'README', ... (b'Hello word2', 'hw2.txt'), ... ] ... ... p = pipcl.Package( ... name = 'foo', ... version = '1.2.3', ... fn_build = build, ... fn_sdist = sdist, ... entry_points = ( ... { 'console_scripts': [ ... 'foo_cli = foo.__main__:main', ... ], ... }), ... ) ... ... build_wheel = p.build_wheel ... build_sdist = p.build_sdist ... ... # Handle old-style setup.py command-line usage: ... if __name__ == '__main__': ... p.handle_argv(sys.argv) ... """)) Create the files required by the above `setup.py` - the SWIG `.i` input file, the README file, and copies of `pipcl.py` and `wdev.py`. >>> with open('pipcl_test/foo.i', 'w') as f: ... _ = f.write(textwrap.dedent(""" ... %include bar.i ... %{ ... #include ... #include ... int bar(const char* text) ... { ... printf("bar(): text: %s\\\\n", text); ... int len = (int) strlen(text); ... printf("bar(): len=%i\\\\n", len); ... fflush(stdout); ... return len; ... } ... %} ... int bar(const char* text); ... """)) >>> with open('pipcl_test/bar.i', 'w') as f: ... _ = f.write( '\\n') >>> with open('pipcl_test/wibble.c', 'w') as f: ... _ = f.write( '\\n') >>> with open('pipcl_test/pyproject.toml', 'w') as f: ... pass >>> with open('pipcl_test/README', 'w') as f: ... _ = f.write(textwrap.dedent(""" ... This is Foo. ... """)) >>> with open('pipcl_test/cli.py', 'w') as f: ... _ = f.write(textwrap.dedent(""" ... def main(): ... print('pipcl_test:main().') ... if __name__ == '__main__': ... main() ... """)) >>> root = os.path.dirname(__file__) >>> _ = shutil.copy2(f'{root}/pipcl.py', 'pipcl_test/pipcl.py') >>> _ = shutil.copy2(f'{root}/wdev.py', 'pipcl_test/wdev.py') Use `setup.py`'s command-line interface to build and install the extension module into root `pipcl_test/install`. >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py --root install install', ... shell=1, check=1) The actual install directory depends on `sysconfig.get_path('platlib')`: >>> if windows(): ... install_dir = 'pipcl_test/install' ... else: ... install_dir = f'pipcl_test/install/{sysconfig.get_path("platlib").lstrip(os.sep)}' >>> assert os.path.isfile( f'{install_dir}/foo/__init__.py') Create a test script which asserts that Python function call `foo.bar(s)` returns the length of `s`, and run it with `PYTHONPATH` set to the install directory: >>> with open('pipcl_test/test.py', 'w') as f: ... _ = f.write(textwrap.dedent(""" ... import sys ... import foo ... text = 'hello' ... print(f'test.py: calling foo.bar() with text={text!r}') ... sys.stdout.flush() ... l = foo.bar(text) ... print(f'test.py: foo.bar() returned: {l}') ... assert l == len(text) ... """)) >>> r = subprocess.run( ... f'{sys.executable} pipcl_test/test.py', ... shell=1, check=1, text=1, ... stdout=subprocess.PIPE, stderr=subprocess.STDOUT, ... env=os.environ | dict(PYTHONPATH=install_dir), ... ) >>> print(r.stdout) test.py: calling foo.bar() with text='hello' bar(): text: hello bar(): len=5 test.py: foo.bar() returned: 5 Check that building sdist and wheel succeeds. For now we don't attempt to check that the sdist and wheel actually work. >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py sdist', ... shell=1, check=1) >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py bdist_wheel', ... shell=1, check=1) Check that rebuild does nothing. >>> t0 = os.path.getmtime('pipcl_test/build/foo.py') >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py bdist_wheel', ... shell=1, check=1) >>> t = os.path.getmtime('pipcl_test/build/foo.py') >>> assert t == t0 Check that touching bar.i forces rebuild. >>> os.utime('pipcl_test/bar.i') >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py bdist_wheel', ... shell=1, check=1) >>> t = os.path.getmtime('pipcl_test/build/foo.py') >>> assert t > t0 Check that touching foo.i.cpp does not run swig, but does recompile/link. >>> t0 = time.time() >>> os.utime('pipcl_test/build/foo.i.cpp') >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py bdist_wheel', ... shell=1, check=1) >>> assert os.path.getmtime('pipcl_test/build/foo.py') <= t0 >>> so = glob.glob('pipcl_test/build/*.so') >>> assert len(so) == 1 >>> so = so[0] >>> assert os.path.getmtime(so) > t0 Check that touching wibble.c does not run swig, but does recompile/link. >>> t0 = time.time() >>> os.utime('pipcl_test/wibble.c') >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} setup.py bdist_wheel', ... shell=1, check=1) >>> assert os.path.getmtime('pipcl_test/build/foo.py') <= t0 >>> so = glob.glob('pipcl_test/build/*.so') >>> assert len(so) == 1 >>> so = so[0] >>> assert os.path.getmtime(so) > t0 Check `entry_points` causes creation of command `foo_cli` when we install from our wheel using pip. [As of 2024-02-24 using pipcl's CLI interface directly with `setup.py install` does not support entry points.] >>> print('Creating venv.', file=sys.stderr) >>> _ = subprocess.run( ... f'cd pipcl_test && {sys.executable} -m venv pylocal', ... shell=1, check=1) >>> print('Installing from wheel into venv using pip.', file=sys.stderr) >>> _ = subprocess.run( ... f'. pipcl_test/pylocal/bin/activate && pip install pipcl_test/dist/*.whl', ... shell=1, check=1) >>> print('Running foo_cli.', file=sys.stderr) >>> _ = subprocess.run( ... f'. pipcl_test/pylocal/bin/activate && foo_cli', ... shell=1, check=1) Wheels and sdists Wheels: We generate wheels according to: https://packaging.python.org/specifications/binary-distribution-format/ * `{name}-{version}.dist-info/RECORD` uses sha256 hashes. * We do not generate other `RECORD*` files such as `RECORD.jws` or `RECORD.p7s`. * `{name}-{version}.dist-info/WHEEL` has: * `Wheel-Version: 1.0` * `Root-Is-Purelib: false` * No support for signed wheels. Sdists: We generate sdist's according to: https://packaging.python.org/specifications/source-distribution-format/ ''' def __init__(self, name, version, *, platform = None, supported_platform = None, summary = None, description = None, description_content_type = None, keywords = None, home_page = None, download_url = None, author = None, author_email = None, maintainer = None, maintainer_email = None, license = None, classifier = None, requires_dist = None, requires_python = None, requires_external = None, project_url = None, provides_extra = None, entry_points = None, root = None, fn_build = None, fn_clean = None, fn_sdist = None, tag_python = None, tag_abi = None, tag_platform = None, py_limited_api = None, wheel_compression = zipfile.ZIP_DEFLATED, wheel_compresslevel = None, ): ''' The initial args before `entry_points` define the package metadata and closely follow the definitions in: https://packaging.python.org/specifications/core-metadata/ Args: name: Used for metadata `Name`. A string, the name of the Python package. version: Used for metadata `Version`. A string, the version of the Python package. Also see PEP-440 `Version Identification and Dependency Specification`. platform: Used for metadata `Platform`. A string or list of strings. supported_platform: Used for metadata `Supported-Platform`. A string or list of strings. summary: Used for metadata `Summary`. A string, short description of the package. description: Used for metadata `Description`. A string. If contains newlines, a detailed description of the package. Otherwise the path of a file containing the detailed description of the package. description_content_type: Used for metadata `Description-Content-Type`. A string describing markup of `description` arg. For example `text/markdown; variant=GFM`. keywords: Used for metadata `Keywords`. A string containing comma-separated keywords. home_page: Used for metadata `Home-page`. URL of home page. download_url: Used for metadata `Download-URL`. Where this version can be downloaded from. author: Used for metadata `Author`. Author. author_email: Used for metadata `Author-email`. Author email. maintainer: Used for metadata `Maintainer`. Maintainer. maintainer_email: Used for metadata `Maintainer-email`. Maintainer email. license: Used for metadata `License`. A string containing the license text. Written into metadata file `COPYING`. Is also written into metadata itself if not multi-line. classifier: Used for metadata `Classifier`. A string or list of strings. Also see: * https://pypi.org/pypi?%3Aaction=list_classifiers * https://pypi.org/classifiers/ requires_dist: Used for metadata `Requires-Dist`. A string or list of strings, Python packages required at runtime. None items are ignored. requires_python: Used for metadata `Requires-Python`. A string or list of strings. requires_external: Used for metadata `Requires-External`. A string or list of strings. project_url: Used for metadata `Project-URL`. A string or list of strings, each of the form: `{name}, {url}`. provides_extra: Used for metadata `Provides-Extra`. A string or list of strings. entry_points: String or dict specifying *.dist-info/entry_points.txt, for example: ``` [console_scripts] foo_cli = foo.__main__:main ``` or: { 'console_scripts': [ 'foo_cli = foo.__main__:main', ], } See: https://packaging.python.org/en/latest/specifications/entry-points/ root: Root of package, defaults to current directory. fn_build: A function taking no args, or a single `config_settings` dict arg (as described in PEP-517), that builds the package. Should return a list of items; each item should be a tuple `(from_, to_)`, or a single string `path` which is treated as the tuple `(path, path)`. `from_` can be a string or a `bytes`. If a string it should be the path to a file; a relative path is treated as relative to `root`. If a `bytes` it is the contents of the file to be added. `to_` identifies what the file should be called within a wheel or when installing. If `to_` is empty or `/` we set it to the leaf of `from_` (`from_` must not be a `bytes`) - i.e. we place the file in the root directory of the wheel; otherwise if `to_` ends with `/` the leaf of `from_` is appended to it (and `from_` must not be a `bytes`). Initial `$dist-info/` in `_to` is replaced by `{name}-{version}.dist-info/`; this is useful for license files etc. Initial `$data/` in `_to` is replaced by `{name}-{version}.data/`. We do not enforce particular subdirectories, instead it is up to `fn_build()` to specify specific subdirectories such as `purelib`, `headers`, `scripts`, `data` etc. If we are building a wheel (e.g. `python setup.py bdist_wheel`, or PEP-517 pip calls `self.build_wheel()`), we add file `from_` to the wheel archive with name `to_`. If we are installing (e.g. `install` command in the argv passed to `self.handle_argv()`), then we copy `from_` to `{sitepackages}/{to_}`, where `sitepackages` is the installation directory, the default being `sysconfig.get_path('platlib')` e.g. `myvenv/lib/python3.9/site-packages/`. When calling this function, we assert that the file pyproject.toml exists in the current directory. (We do this here rather than in pipcl.Package's constructor, as otherwise importing setup.py from non-package-related code could fail.) fn_clean: A function taking a single arg `all_` that cleans generated files. `all_` is true iff `--all` is in argv. For safety and convenience, can also returns a list of files/directory paths to be deleted. Relative paths are interpreted as relative to `root`. All paths are asserted to be within `root`. fn_sdist: A function taking no args, or a single `config_settings` dict arg (as described in PEP517), that returns a list of items to be copied into the sdist. The list should be in the same format as returned by `fn_build`. It can be convenient to use `pipcl.git_items()`. The specification for sdists requires that the list contains `pyproject.toml`; we enforce this with a Python assert. tag_python: First element of wheel tag defined in PEP-425. If None we use `cp{version}`. For example if code works with any Python version, one can use 'py3'. tag_abi: Second element of wheel tag defined in PEP-425. If None we use `none`. tag_platform: Third element of wheel tag defined in PEP-425. Default is `os.environ('AUDITWHEEL_PLAT')` if set, otherwise derived from `sysconfig.get_platform()` (was `setuptools.distutils.util.get_platform(), before that `distutils.util.get_platform()` as specified in the PEP), e.g. `openbsd_7_0_amd64`. For pure python packages use: `tag_platform=any` py_limited_api: If true we build wheels that use the Python Limited API. We use the version of `sys.executable` to define `Py_LIMITED_API` when compiling extensions, and use ABI tag `abi3` in the wheel name if argument `tag_abi` is None. wheel_compression: Used as `zipfile.ZipFile()`'s `compression` parameter when creating wheels. wheel_compresslevel: Used as `zipfile.ZipFile()`'s `compresslevel` parameter when creating wheels. Occurrences of `None` in lists are ignored. ''' assert name assert version def assert_str( v): if v is not None: assert isinstance( v, str), f'Not a string: {v!r}' def assert_str_or_multi( v): if v is not None: assert isinstance( v, (str, tuple, list)), f'Not a string, tuple or list: {v!r}' assert_str( name) assert_str( version) assert_str_or_multi( platform) assert_str_or_multi( supported_platform) assert_str( summary) assert_str( description) assert_str( description_content_type) assert_str( keywords) assert_str( home_page) assert_str( download_url) assert_str( author) assert_str( author_email) assert_str( maintainer) assert_str( maintainer_email) assert_str( license) assert_str_or_multi( classifier) assert_str_or_multi( requires_dist) assert_str( requires_python) assert_str_or_multi( requires_external) assert_str_or_multi( project_url) assert_str_or_multi( provides_extra) assert re.match('^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])\\Z', name, re.IGNORECASE), ( f'Invalid package name' f' (https://packaging.python.org/en/latest/specifications/name-normalization/)' f': {name!r}' ) # https://packaging.python.org/en/latest/specifications/core-metadata/. assert re.match('([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$', name, re.IGNORECASE), \ f'Bad name: {name!r}' _assert_version_pep_440(version) # https://packaging.python.org/en/latest/specifications/binary-distribution-format/ if tag_python: assert '-' not in tag_python if tag_abi: assert '-' not in tag_abi if tag_platform: assert '-' not in tag_platform self.name = name self.version = version self.platform = platform self.supported_platform = supported_platform self.summary = summary self.description = description self.description_content_type = description_content_type self.keywords = keywords self.home_page = home_page self.download_url = download_url self.author = author self.author_email = author_email self.maintainer = maintainer self.maintainer_email = maintainer_email self.license = license self.classifier = classifier self.requires_dist = requires_dist self.requires_python = requires_python self.requires_external = requires_external self.project_url = project_url self.provides_extra = provides_extra self.entry_points = entry_points self.root = os.path.abspath(root if root else os.getcwd()) self.fn_build = fn_build self.fn_clean = fn_clean self.fn_sdist = fn_sdist self.tag_python_ = tag_python self.tag_abi_ = tag_abi self.tag_platform_ = tag_platform self.py_limited_api = py_limited_api self.wheel_compression = wheel_compression self.wheel_compresslevel = wheel_compresslevel # If true and we are building for graal, we set PIPCL_PYTHON_CONFIG to # a command that will print includes/libs from graal_py's sysconfig. # self.graal_legacy_python_config = True def build_wheel(self, wheel_directory, config_settings=None, metadata_directory=None, ): ''' A PEP-517 `build_wheel()` function. Also called by `handle_argv()` to handle the `bdist_wheel` command. Returns leafname of generated wheel within `wheel_directory`. ''' log2( f' wheel_directory={wheel_directory!r}' f' config_settings={config_settings!r}' f' metadata_directory={metadata_directory!r}' ) if os.environ.get('CIBUILDWHEEL') == '1': # Don't special-case graal builds when running under cibuildwheel. pass elif sys.implementation.name == 'graalpy': # We build for Graal by building a native Python wheel with Graal # Python's include paths and library directory. We then rename the # wheel to contain graal's tag etc. # log0(f'### Graal build: deferring to cpython.') python_native = os.environ.get('PIPCL_GRAAL_PYTHON') assert python_native, f'Graal build requires that PIPCL_GRAAL_PYTHON is set.' env_extra = dict( PIPCL_SYSCONFIG_PATH_include = sysconfig.get_path('include'), PIPCL_SYSCONFIG_PATH_platinclude = sysconfig.get_path('platinclude'), PIPCL_SYSCONFIG_CONFIG_VAR_LIBDIR = sysconfig.get_config_var('LIBDIR'), ) # Tell native build to run pipcl.py itself to get python-config # information about include paths etc. if self.graal_legacy_python_config: env_extra['PIPCL_PYTHON_CONFIG'] = f'{python_native} {os.path.abspath(__file__)} --graal-legacy-python-config' # Create venv. venv_name = os.environ.get('PIPCL_GRAAL_NATIVE_VENV') if venv_name: log1(f'Graal using pre-existing {venv_name=}') else: venv_name = 'venv-pipcl-graal-native' run(f'{shlex.quote(python_native)} -m venv {venv_name}') log1(f'Graal using {venv_name=}') newfiles = NewFiles(f'{wheel_directory}/*.whl') run( f'. {venv_name}/bin/activate && python setup.py --dist-dir {shlex.quote(wheel_directory)} bdist_wheel', env_extra = env_extra, prefix = f'pipcl.py graal {python_native}: ', ) wheel = newfiles.get_one() wheel_leaf = os.path.basename(wheel) python_major_minor = run(f'{shlex.quote(python_native)} -c "import platform; import sys; sys.stdout.write(str().join(platform.python_version_tuple()[:2]))"', capture=1) cpabi = f'cp{python_major_minor}-abi3' assert cpabi in wheel_leaf, f'Expected wheel to be for {cpabi=}, but {wheel=}.' graalpy_ext_suffix = sysconfig.get_config_var('EXT_SUFFIX') log1(f'{graalpy_ext_suffix=}') m = re.match(r'\.graalpy(\d+[^\-]*)-(\d+)', graalpy_ext_suffix) gpver = m[1] cpver = m[2] graalpy_wheel_tag = f'graalpy{cpver}-graalpy{gpver}_{cpver}_native' name = wheel_leaf.replace(cpabi, graalpy_wheel_tag) destination = f'{wheel_directory}/{name}' log0(f'### Graal build: copying {wheel=} to {destination=}') # Copying results in two wheels which appears to confuse pip, showing: # Found multiple .whl files; unspecified behaviour. Will call build_wheel. os.rename(wheel, destination) log1(f'Returning {name=}.') return name wheel_name = self.wheel_name() path = f'{wheel_directory}/{wheel_name}' # Do a build and get list of files to copy into the wheel. # items = list() if self.fn_build: items = self._call_fn_build(config_settings) log2(f'Creating wheel: {path}') os.makedirs(wheel_directory, exist_ok=True) record = _Record() with zipfile.ZipFile(path, 'w', self.wheel_compression, self.wheel_compresslevel) as z: def add(from_, to_): if isinstance(from_, str): z.write(from_, to_) record.add_file(from_, to_) elif isinstance(from_, bytes): z.writestr(to_, from_) record.add_content(from_, to_) else: assert 0 def add_str(content, to_): add(content.encode('utf8'), to_) dist_info_dir = self._dist_info_dir() # Add the files returned by fn_build(). # for item in items: from_, (to_abs, to_rel) = self._fromto(item) add(from_, to_rel) # Add -.dist-info/WHEEL. # add_str( f'Wheel-Version: 1.0\n' f'Generator: pipcl\n' f'Root-Is-Purelib: false\n' f'Tag: {self.wheel_tag_string()}\n' , f'{dist_info_dir}/WHEEL', ) # Add -.dist-info/METADATA. # add_str(self._metainfo(), f'{dist_info_dir}/METADATA') # Add -.dist-info/COPYING. if self.license: add_str(self.license, f'{dist_info_dir}/COPYING') # Add -.dist-info/entry_points.txt. entry_points_text = self._entry_points_text() if entry_points_text: add_str(entry_points_text, f'{dist_info_dir}/entry_points.txt') # Update -.dist-info/RECORD. This must be last. # z.writestr(f'{dist_info_dir}/RECORD', record.get(f'{dist_info_dir}/RECORD')) st = os.stat(path) log1( f'Have created wheel size={st.st_size:,}: {path}') if g_verbose >= 2: with zipfile.ZipFile(path, compression=self.wheel_compression) as z: log2(f'Contents are:') for zi in sorted(z.infolist(), key=lambda z: z.filename): log2(f' {zi.file_size: 10,d} {zi.filename}') return os.path.basename(path) def build_sdist(self, sdist_directory, formats, config_settings=None, ): ''' A PEP-517 `build_sdist()` function. Also called by `handle_argv()` to handle the `sdist` command. Returns leafname of generated archive within `sdist_directory`. ''' assert self.fn_sdist, f'fn_sdist() not provided.' log2( f' sdist_directory={sdist_directory!r}' f' formats={formats!r}' f' config_settings={config_settings!r}' ) if formats and formats != 'gztar': raise Exception( f'Unsupported: formats={formats}') items = list() if inspect.signature(self.fn_sdist).parameters: items = self.fn_sdist(config_settings) else: items = self.fn_sdist() prefix = f'{_normalise2(self.name)}-{self.version}' os.makedirs(sdist_directory, exist_ok=True) tarpath = f'{sdist_directory}/{prefix}.tar.gz' log2(f'Creating sdist: {tarpath}') with tarfile.open(tarpath, 'w:gz') as tar: names_in_tar = list() def check_name(name): if name in names_in_tar: raise Exception(f'Name specified twice: {name}') names_in_tar.append(name) def add(from_, name): check_name(name) if isinstance(from_, str): log2( f'Adding file: {os.path.relpath(from_)} => {name}') tar.add( from_, f'{prefix}/{name}', recursive=False) elif isinstance(from_, bytes): log2( f'Adding: {name}') ti = tarfile.TarInfo(f'{prefix}/{name}') ti.size = len(from_) ti.mtime = time.time() tar.addfile(ti, io.BytesIO(from_)) else: assert 0 def add_string(text, name): textb = text.encode('utf8') return add(textb, name) found_pyproject_toml = False for item in items: from_, (to_abs, to_rel) = self._fromto(item) if isinstance(from_, bytes): add(from_, to_rel) else: if from_.startswith(f'{os.path.abspath(sdist_directory)}/'): # Source files should not be inside . assert 0, f'Path is inside sdist_directory={sdist_directory}: {from_!r}' assert os.path.exists(from_), f'Path does not exist: {from_!r}' assert os.path.isfile(from_), f'Path is not a file: {from_!r}' add(from_, to_rel) if to_rel == 'pyproject.toml': found_pyproject_toml = True assert found_pyproject_toml, f'Cannot create sdist because file not specified: pyproject.toml' # Always add a PKG-INFO file. add_string(self._metainfo(), 'PKG-INFO') if self.license: if 'COPYING' in names_in_tar: log2(f'Not writing .license because file already in sdist: COPYING') else: add_string(self.license, 'COPYING') log1( f'Have created sdist: {tarpath}') return os.path.basename(tarpath) def wheel_tag_string(self): ''' Returns --. ''' return f'{self.tag_python()}-{self.tag_abi()}-{self.tag_platform()}' def tag_python(self): ''' Get two-digit python version, e.g. 'cp3.8' for python-3.8.6. ''' if self.tag_python_: ret = self.tag_python_ else: ret = 'cp' + ''.join(platform.python_version().split('.')[:2]) assert '-' not in ret return ret def tag_abi(self): ''' ABI tag. ''' Py_GIL_DISABLED = sysconfig.get_config_var('Py_GIL_DISABLED') if self.tag_abi_: return self.tag_abi_ elif self.py_limited_api: assert Py_GIL_DISABLED != 1, \ f'py_limited_api and Py_GIL_DISABLED are not supported together as of 2026-02-20, e.g. see PEP 803 and PEP 809.' return 'abi3' elif Py_GIL_DISABLED == 1: ret = '' ret += 'cp' ret += ''.join(platform.python_version().split('.')[:2]) ret += 't' return ret else: return 'none' def tag_platform(self): ''' Find platform tag used in wheel filename. ''' ret = self.tag_platform_ log0(f'From self.tag_platform_: {ret=}.') if not ret: # Prefer this to PEP-425. Appears to be undocumented, # but set in manylinux docker images and appears # to be used by cibuildwheel and auditwheel, e.g. # https://github.com/rapidsai/shared-action-workflows/issues/80 ret = os.environ.get( 'AUDITWHEEL_PLAT') log0(f'From AUDITWHEEL_PLAT: {ret=}.') if not ret: # Notes: # # PEP-425. On Linux gives `linux_x86_64` which is rejected by # pypi.org. # # On local MacOS/arm64 mac-mini have seen sysconfig.get_platform() # unhelpfully return `macosx-10.9-universal2` if `python3` is the # system Python /usr/bin/python3; this happens if we source `. # /etc/profile`. # ret = sysconfig.get_platform() ret = ret.replace('-', '_').replace('.', '_').lower() log0(f'From sysconfig.get_platform(): {ret=}.') ret = _macos_fixup_platform_tag(ret) log0( f'tag_platform(): returning {ret=}.') assert '-' not in ret return ret def wheel_name(self): ret = f'{_normalise2(self.name)}-{self.version}-{self.tag_python()}-{self.tag_abi()}-{self.tag_platform()}.whl' assert ret.count('-') == 4, f'Expected 4 dash characters in {ret=}.' return ret def wheel_name_match(self, wheel): ''' Returns true if `wheel` matches our wheel. We basically require the name to be the same, except that we accept platform tags that contain extra items (see pep-0600/), for example we return true with: self: foo-cp38-none-manylinux2014_x86_64.whl wheel: foo-cp38-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl ''' log2(f'{wheel=}') assert wheel.endswith('.whl') wheel2 = wheel[:-len('.whl')] name, version, tag_python, tag_abi, tag_platform = wheel2.split('-') py_limited_api_compatible = False if self.py_limited_api and tag_abi == 'abi3': # Allow lower tag_python number. m = re.match('cp([0-9]+)', tag_python) tag_python_int = int(m.group(1)) m = re.match('cp([0-9]+)', self.tag_python()) tag_python_int_self = int(m.group(1)) if tag_python_int <= tag_python_int_self: # This wheel uses Python stable ABI same or older than ours, so # we can use it. log2(f'py_limited_api; {tag_python=} compatible with {self.tag_python()=}.') py_limited_api_compatible = True log2(f'{_normalise2(self.name) == name=}') log2(f'{self.version == version=}') log2(f'{self.tag_python() == tag_python=} {self.tag_python()=} {tag_python=}') log2(f'{py_limited_api_compatible=}') log2(f'{self.tag_abi() == tag_abi=}') log2(f'{self.tag_platform() in tag_platform.split(".")=}') log2(f'{self.tag_platform()=}') log2(f'{tag_platform.split(".")=}') ret = (1 and _normalise2(self.name) == name and self.version == version and (self.tag_python() == tag_python or py_limited_api_compatible) and self.tag_abi() == tag_abi and self.tag_platform() in tag_platform.split('.') ) log2(f'Returning {ret=}.') return ret def _entry_points_text(self): if self.entry_points: if isinstance(self.entry_points, str): return self.entry_points ret = '' for key, values in self.entry_points.items(): ret += f'[{key}]\n' for value in values: ret += f'{value}\n' return ret def _call_fn_build( self, config_settings=None): assert self.fn_build assert os.path.isfile('pyproject.toml'), ( 'Cannot create package because file does not exist: pyproject.toml' ) log2(f'calling self.fn_build={self.fn_build}') if inspect.signature(self.fn_build).parameters: ret = self.fn_build(config_settings) else: ret = self.fn_build() assert isinstance( ret, (list, tuple)), \ f'Expected list/tuple from {self.fn_build} but got: {ret!r}' # Check that any extensions that we have built, have same # py_limited_api value. If package is marked with py_limited_api=True # then non-py_limited_api extensions seem to fail at runtime on # Windows. # # (We could possibly allow package py_limited_api=False and extensions # py_limited_api=True, but haven't tested this, and it seems simpler to # be strict.) for item in ret: from_, (to_abs, to_rel) = self._fromto(item) from_abs = os.path.abspath(from_) is_py_limited_api = _extensions_to_py_limited_api.get(from_abs) if is_py_limited_api is not None: assert bool(self.py_limited_api) == bool(is_py_limited_api), ( f'Extension was built with' f' py_limited_api={is_py_limited_api} but pipcl.Package' f' name={self.name!r} has' f' py_limited_api={self.py_limited_api}:' f' {from_abs!r}' ) return ret def _argv_clean(self, all_): ''' Called by `handle_argv()`. ''' if not self.fn_clean: return paths = self.fn_clean(all_) if paths: if isinstance(paths, str): paths = paths, for path in paths: if not os.path.isabs(path): path = ps.path.join(self.root, path) path = os.path.abspath(path) assert path.startswith(self.root+os.sep), \ f'path={path!r} does not start with root={self.root+os.sep!r}' log(f'Removing: {path}') shutil.rmtree(path, ignore_errors=True) def install(self, record_path=None, root=None): ''' Called by `handle_argv()` to handle `install` command.. ''' log2( f'{record_path=} {root=}') # Do a build and get list of files to install. # items = list() if self.fn_build: items = self._call_fn_build( dict()) root2 = install_dir(root) log2( f'{root2=}') log1( f'Installing into: {root2!r}') dist_info_dir = self._dist_info_dir() if not record_path: record_path = f'{root2}/{dist_info_dir}/RECORD' record = _Record() def add_file(from_, to_abs, to_rel): os.makedirs( os.path.dirname( to_abs), exist_ok=True) if isinstance(from_, bytes): log2(f'Copying content into {to_abs}.') with open(to_abs, 'wb') as f: f.write(from_) record.add_content(from_, to_rel) else: log0(f'{from_=}') log2(f'Copying from {os.path.relpath(from_, self.root)} to {to_abs}') shutil.copy2( from_, to_abs) record.add_file(from_, to_rel) def add_str(content, to_abs, to_rel): log2( f'Writing to: {to_abs}') os.makedirs( os.path.dirname( to_abs), exist_ok=True) with open( to_abs, 'w') as f: f.write( content) record.add_content(content, to_rel) for item in items: from_, (to_abs, to_rel) = self._fromto(item) log0(f'{from_=} {to_abs=} {to_rel=}') to_abs2 = f'{root2}/{to_rel}' add_file( from_, to_abs2, to_rel) add_str( self._metainfo(), f'{root2}/{dist_info_dir}/METADATA', f'{dist_info_dir}/METADATA') if self.license: add_str( self.license, f'{root2}/{dist_info_dir}/COPYING', f'{dist_info_dir}/COPYING') entry_points_text = self._entry_points_text() if entry_points_text: add_str( entry_points_text, f'{root2}/{dist_info_dir}/entry_points.txt', f'{dist_info_dir}/entry_points.txt', ) log2( f'Writing to: {record_path}') with open(record_path, 'w') as f: f.write(record.get()) log2(f'Finished.') def _argv_dist_info(self, root): ''' Called by `handle_argv()`. There doesn't seem to be any documentation for `setup.py dist_info`, but it appears to be like `egg_info` except it writes to a slightly different directory. ''' if root is None: root = f'{normalise2(self.name)}-{self.version}.dist-info' self._write_info(f'{root}/METADATA') if self.license: with open( f'{root}/COPYING', 'w') as f: f.write( self.license) def _argv_egg_info(self, egg_base): ''' Called by `handle_argv()`. ''' if egg_base is None: egg_base = '.' self._write_info(f'{egg_base}/.egg-info') def _write_info(self, dirpath=None): ''' Writes egg/dist info to files in directory `dirpath` or `self.root` if `None`. ''' if dirpath is None: dirpath = self.root log2(f'Creating files in directory {dirpath}') os.makedirs(dirpath, exist_ok=True) with open(os.path.join(dirpath, 'PKG-INFO'), 'w') as f: f.write(self._metainfo()) # These don't seem to be required? # #with open(os.path.join(dirpath, 'SOURCES.txt', 'w') as f: # pass #with open(os.path.join(dirpath, 'dependency_links.txt', 'w') as f: # pass #with open(os.path.join(dirpath, 'top_level.txt', 'w') as f: # f.write(f'{self.name}\n') #with open(os.path.join(dirpath, 'METADATA', 'w') as f: # f.write(self._metainfo()) def handle_argv(self, argv): ''' Attempt to handles old-style (pre PEP-517) command line passed by old releases of pip to a `setup.py` script, and manual running of `setup.py`. This is partial support at best. ''' global g_verbose #log2(f'argv: {argv}') class ArgsRaise: pass class Args: ''' Iterates over argv items. ''' def __init__( self, argv): self.items = iter( argv) def next( self, eof=ArgsRaise): ''' Returns next arg. If no more args, we return or raise an exception if is ArgsRaise. ''' try: return next( self.items) except StopIteration: if eof is ArgsRaise: raise Exception('Not enough args') return eof command = None opt_all = None opt_dist_dir = 'dist' opt_egg_base = None opt_formats = None opt_install_headers = None opt_record = None opt_root = None args = Args(argv[1:]) while 1: arg = args.next(None) if arg is None: break elif arg in ('-h', '--help', '--help-commands'): log0(textwrap.dedent(''' Usage: [...] [...] Commands: bdist_wheel Creates a wheel called /--
.whl, where is "dist" or as specified by --dist-dir, and
encodes ABI and platform etc. clean Cleans build files. dist_info Creates files in -.dist-info/ or directory specified by --egg-base. egg_info Creates files in .egg-info/ or directory directory specified by --egg-base. install Builds and installs. Writes installation information to if --record was specified. sdist Make a source distribution: /-.tar.gz Options: --all Used by "clean". --compile Ignored. --dist-dir | -d Default is "dist". --egg-base Used by "egg_info". --formats Used by "sdist". --install-headers Ignored. --python-tag Ignored. --record Used by "install". --root Used by "install". --single-version-externally-managed Ignored. --verbose -v Extra diagnostics. Other: windows-vs [-y ] [-v ] [-g ] [--verbose] Windows only; looks for matching Python. ''')) return elif arg in ('bdist_wheel', 'clean', 'dist_info', 'egg_info', 'install', 'sdist'): assert command is None, 'Two commands specified: {command} and {arg}.' command = arg elif arg in ('windows-vs', 'windows-python', 'show-sysconfig'): assert command is None, 'Two commands specified: {command} and {arg}.' command = arg elif arg == '--all': opt_all = True elif arg == '--compile': pass elif arg == '--dist-dir' or arg == '-d': opt_dist_dir = args.next() elif arg == '--egg-base': opt_egg_base = args.next() elif arg == '--formats': opt_formats = args.next() elif arg == '--install-headers': opt_install_headers = args.next() elif arg == '--python-tag': pass elif arg == '--record': opt_record = args.next() elif arg == '--root': opt_root = args.next() elif arg == '--single-version-externally-managed': pass elif arg == '--verbose' or arg == '-v': g_verbose += 1 else: raise Exception(f'Unrecognised arg: {arg}') assert command, 'No command specified' log1(f'Handling command={command}') if 0: pass elif command == 'bdist_wheel': self.build_wheel(opt_dist_dir) elif command == 'clean': self._argv_clean(opt_all) elif command == 'dist_info': self._argv_dist_info(opt_egg_base) elif command == 'egg_info': self._argv_egg_info(opt_egg_base) elif command == 'install': self.install(opt_record, opt_root) elif command == 'sdist': self.build_sdist(opt_dist_dir, opt_formats) elif command == 'windows-python': version = None while 1: arg = args.next(None) if arg is None: break elif arg == '-v': version = args.next() elif arg == '--verbose': g_verbose += 1 else: assert 0, f'Unrecognised {arg=}' python = wdev.WindowsPython(version=version) print(f'Python is:\n{python.description_ml(" ")}') elif command == 'windows-vs': grade = None version = None year = None while 1: arg = args.next(None) if arg is None: break elif arg == '-g': grade = args.next() elif arg == '-v': version = args.next() elif arg == '-y': year = args.next() elif arg == '--verbose': g_verbose += 1 else: assert 0, f'Unrecognised {arg=}' vs = wdev.WindowsVS(year=year, grade=grade, version=version) print(f'Visual Studio is:\n{vs.description_ml(" ")}') elif command == 'show-sysconfig': show_sysconfig() for mod in platform, sys: log0(f'{mod.__name__}:') for n in dir(mod): if n.startswith('_'): continue log0(f'{mod.__name__}.{n}') if mod is platform and n == 'uname': continue if mod is platform and n == 'pdb': continue if mod is sys and n in ('breakpointhook', 'exit'): # We don't want to call these. continue v = getattr(mod, n) if callable(v): try: v = v() except Exception: pass else: #print(f'{n=}', flush=1) try: print(f' {mod.__name__}.{n}()={v!r}') except Exception: print(f' Failed to print value of {mod.__name__}.{n}().') else: try: print(f' {mod.__name__}.{n}={v!r}') except Exception: print(f' Failed to print value of {mod.__name__}.{n}.') else: assert 0, f'Unrecognised command: {command}' log2(f'Finished handling command: {command}') def __str__(self): return ('{' f'name={self.name!r}' f' version={self.version!r}' f' platform={self.platform!r}' f' supported_platform={self.supported_platform!r}' f' summary={self.summary!r}' f' description={self.description!r}' f' description_content_type={self.description_content_type!r}' f' keywords={self.keywords!r}' f' home_page={self.home_page!r}' f' download_url={self.download_url!r}' f' author={self.author!r}' f' author_email={self.author_email!r}' f' maintainer={self.maintainer!r}' f' maintainer_email={self.maintainer_email!r}' f' license={self.license!r}' f' classifier={self.classifier!r}' f' requires_dist={self.requires_dist!r}' f' requires_python={self.requires_python!r}' f' requires_external={self.requires_external!r}' f' project_url={self.project_url!r}' f' provides_extra={self.provides_extra!r}' f' root={self.root!r}' f' fn_build={self.fn_build!r}' f' fn_sdist={self.fn_sdist!r}' f' fn_clean={self.fn_clean!r}' f' tag_python={self.tag_python_!r}' f' tag_abi={self.tag_abi_!r}' f' tag_platform={self.tag_platform_!r}' '}' ) def _dist_info_dir( self): return f'{_normalise2(self.name)}-{self.version}.dist-info' def _metainfo(self): ''' Returns text for `.egg-info/PKG-INFO` file, or `PKG-INFO` in an sdist `.tar.gz` file, or `...dist-info/METADATA` in a wheel. ''' # 2021-04-30: Have been unable to get multiline content working on # test.pypi.org so we currently put the description as the body after # all the other headers. # ret = [''] def add(key, value): if value is None: return if isinstance( value, (tuple, list)): for v in value: if v is not None: add( key, v) return if key == 'License' and '\n' in value: # This is ok because we write `self.license` into # *.dist-info/COPYING. # log1( f'Omitting license because contains newline(s).') return assert '\n' not in value, f'key={key} value contains newline: {value!r}' if key == 'Project-URL': assert value.count(',') == 1, f'For {key=}, should have one comma in {value!r}.' ret[0] += f'{key}: {value}\n' #add('Description', self.description) add('Metadata-Version', '2.1') # These names are from: # https://packaging.python.org/specifications/core-metadata/ # for name in ( 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description-Content-Type', 'Keywords', 'Home-page', 'Download-URL', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License', 'Classifier', 'Requires-Dist', 'Requires-Python', 'Requires-External', 'Project-URL', 'Provides-Extra', ): identifier = name.lower().replace( '-', '_') add( name, getattr( self, identifier)) ret = ret[0] # Append description as the body if self.description: if '\n' in self.description: description_text = self.description.strip() else: with open(self.description) as f: description_text = f.read() ret += '\n' # Empty line separates headers from body. ret += description_text ret += '\n' return ret def _path_relative_to_root(self, path, assert_within_root=True): ''' Returns `(path_abs, path_rel)`, where `path_abs` is absolute path and `path_rel` is relative to `self.root`. Interprets `path` as relative to `self.root` if not absolute. We use `os.path.realpath()` to resolve any links. if `assert_within_root` is true, assert-fails if `path` is not within `self.root`. ''' if os.path.isabs(path): p = path else: p = os.path.join(self.root, path) p = os.path.realpath(os.path.abspath(p)) if assert_within_root: assert p.startswith(self.root+os.sep) or p == self.root, \ f'Path not within root={self.root+os.sep!r}: {path=} {p=}' p_rel = os.path.relpath(p, self.root) return p, p_rel def _fromto(self, p): ''' Returns `(from_, (to_abs, to_rel))`. If `p` is a string we convert to `(p, p)`. Otherwise we assert that `p` is a tuple `(from_, to_)` where `from_` is str/bytes and `to_` is str. If `from_` is a bytes it is contents of file to add, otherwise the path of an existing file; non-absolute paths are assumed to be relative to `self.root`. If `to_` is empty or `/` we set it to the leaf of `from_` (which must be a str) - i.e. we place the file in the root directory of the wheel; otherwise if `to_` ends with `/` we append the leaf of `from_` (which must be a str). If `to_` starts with `$dist-info/`, we replace this with `self._dist_info_dir()`. If `to_` starts with `$data/`, we replace this with `{self.name}-{self.version}.data/`. We assert that `to_abs` is `within self.root`. `to_rel` is derived from the `to_abs` and is relative to self.root`. ''' ret = None if isinstance(p, str): p = p, p assert isinstance(p, tuple) and len(p) == 2 from_, to_ = p assert isinstance(from_, (str, bytes)) assert isinstance(to_, str) if to_ == '/' or to_ == '': to_ = os.path.basename(from_) elif to_.endswith('/'): to_ += os.path.basename(from_) prefix = '$dist-info/' if to_.startswith( prefix): to_ = f'{self._dist_info_dir()}/{to_[ len(prefix):]}' prefix = '$data/' if to_.startswith( prefix): to_ = f'{_normalise2(self.name)}-{self.version}.data/{to_[ len(prefix):]}' if isinstance(from_, str): from_, _ = self._path_relative_to_root( from_, assert_within_root=False) to_ = self._path_relative_to_root(to_) assert isinstance(from_, (str, bytes)) log2(f'returning {from_=} {to_=}') return from_, to_ _extensions_to_py_limited_api = dict() def build_extension( name, path_i, outdir, *, builddir=None, includes=None, defines=None, libpaths=None, libs=None, optimise=True, debug=False, compiler_extra='', linker_extra='', swig=None, cpp=True, source_extra=None, prerequisites_swig=None, prerequisites_compile=None, prerequisites_link=None, infer_swig_includes=True, py_limited_api=False, ): ''' Builds a Python extension module using SWIG. Works on Windows, Linux, MacOS and OpenBSD. On Unix, sets rpath when linking shared libraries. Args: name: Name of generated extension module. path_i: Path of input SWIG `.i` file. Internally we use swig to generate a corresponding `.c` or `.cpp` file. outdir: Output directory for generated files: * `{outdir}/{name}.py` * `{outdir}/_{name}.so` # Unix * `{outdir}/_{name}.*.pyd` # Windows We return the leafname of the `.so` or `.pyd` file. builddir: Where to put intermediate files, for example the .cpp file generated by swig and `.d` dependency files. Default is `outdir`. includes: A string, or a sequence of extra include directories to be prefixed with `-I`. defines: A string, or a sequence of extra preprocessor defines to be prefixed with `-D`. libpaths A string, or a sequence of library paths to be prefixed with `/LIBPATH:` on Windows or `-L` on Unix. libs A string, or a sequence of library names. Each item is prefixed with `-l` on non-Windows. optimise: Whether to use compiler optimisations and define NDEBUG. debug: Whether to build with debug symbols. compiler_extra: Extra compiler flags. Can be None. linker_extra: Extra linker flags. Can be None. swig: Swig command; if false we use 'swig'. cpp: If true we tell SWIG to generate C++ code instead of C. source_extra: Extra source files to build into the shared library, prerequisites_swig: prerequisites_compile: prerequisites_link: [These are mainly for use on Windows. On other systems we automatically generate dynamic dependencies using swig/compile/link commands' `-MD` and `-MF` args.] Sequences of extra input files/directories that should force running of swig, compile or link commands if they are newer than any existing generated SWIG `.i` file, compiled object file or shared library file. If present, the first occurrence of `True` or `False` forces re-run or no re-run. Any occurrence of None is ignored. If an item is a directory path we look for newest file within the directory tree. If not a sequence, we convert into a single-item list. prerequisites_swig We use swig's -MD and -MF args to generate dynamic dependencies automatically, so this is not usually required. prerequisites_compile prerequisites_link On non-Windows we use cc's -MF and -MF args to generate dynamic dependencies so this is not usually required. infer_swig_includes: If true, we extract `-I` and `-I ` args from `compile_extra` (also `/I` on windows) and use them with swig so that it can see the same header files as C/C++. This is useful when using enviromment variables such as `CC` and `CXX` to set `compile_extra`. py_limited_api: If true we build for current Python's limited API / stable ABI. Note that we will assert false if this extension is added to a pipcl.Package that has a different , because on Windows importing a non-py_limited_api extension inside a py_limited=True package fails. Returns the leafname of the generated library file within `outdir`, e.g. `_{name}.so` on Unix or `_{name}.cp311-win_amd64.pyd` on Windows. ''' if compiler_extra is None: compiler_extra = '' if linker_extra is None: linker_extra = '' if builddir is None: builddir = outdir if not swig: swig = 'swig' if source_extra is None: source_extra = list() if isinstance(source_extra, str): source_extra = [source_extra] includes_text = _flags( includes, '-I') defines_text = _flags( defines, '-D') libpaths_text = _flags( libpaths, '/LIBPATH:', '"') if windows() else _flags( libpaths, '-L') libs_text = _flags( libs, '' if windows() else '-l') path_cpp = f'{builddir}/{os.path.basename(path_i)}' path_cpp += '.cpp' if cpp else '.c' os.makedirs( outdir, exist_ok=True) # Run SWIG. # if infer_swig_includes: # Extract include flags from `compiler_extra`. swig_includes_extra = '' compiler_extra_items = shlex.split(compiler_extra) i = 0 while i < len(compiler_extra_items): item = compiler_extra_items[i] # Swig doesn't seem to like a space after `I`. if item == '-I' or (windows() and item == '/I'): swig_includes_extra += f' -I{compiler_extra_items[i+1]}' i += 1 elif item.startswith('-I') or (windows() and item.startswith('/I')): swig_includes_extra += f' -I{compiler_extra_items[i][2:]}' i += 1 swig_includes_extra = swig_includes_extra.strip() deps_path = f'{path_cpp}.d' prerequisites_swig2 = _get_prerequisites( deps_path) run_if( f''' {swig} -Wall {"-c++" if cpp else ""} -python -module {name} -outdir {outdir} -o {path_cpp} -MD -MF {deps_path} {includes_text} {swig_includes_extra} {path_i} ''' , path_cpp, path_i, prerequisites_swig, prerequisites_swig2, ) if pyodide(): so_suffix = '.so' log0(f'pyodide: PEP-3149 suffix untested, so omitting. {_so_suffix()=}.') else: so_suffix = _so_suffix(use_so_versioning = not py_limited_api) path_so_leaf = f'_{name}{so_suffix}' path_so = f'{outdir}/{path_so_leaf}' py_limited_api2 = current_py_limited_api() if py_limited_api else None compiler_command, pythonflags = base_compiler(cpp=cpp) linker_command, _ = base_linker(cpp=cpp) # setuptools on Linux seems to use slightly different compile flags: # # -fwrapv -O3 -Wall -O2 -g0 -DPY_CALL_TRAMPOLINE # general_flags = '' if windows(): permissive = '/permissive-' EHsc = '/EHsc' T = '/Tp' if cpp else '/Tc' optimise2 = '/DNDEBUG /O2' if optimise else '/D_DEBUG' debug2 = '/Zi' if debug else '' py_limited_api3 = f'/DPy_LIMITED_API={py_limited_api2}' if py_limited_api2 else '' else: if debug: general_flags += '/Zi' if windows() else ' -g' if optimise: general_flags += ' /DNDEBUG /O2' if windows() else ' -O2 -DNDEBUG' py_limited_api3 = f'-DPy_LIMITED_API={py_limited_api2}' if py_limited_api2 else '' if windows(): pass elif darwin(): # MacOS's linker does not like `-z origin`. rpath_flag = "-Wl,-rpath,@loader_path/" # Avoid `Undefined symbols for ... "_PyArg_UnpackTuple" ...'. general_flags += ' -undefined dynamic_lookup' elif pyodide(): # Setting `-Wl,-rpath,'$ORIGIN',-z,origin` gives: # emcc: warning: ignoring unsupported linker flag: `-rpath` [-Wlinkflags] # wasm-ld: error: unknown -z value: origin # rpath_flag = "-Wl,-rpath,'$ORIGIN'" else: rpath_flag = "-Wl,-rpath,'$ORIGIN',-z,origin" # Fun fact - on Linux, if the -L and -l options are before '{path_cpp}' # they seem to be ignored... # path_os = list() for path_source in [path_cpp] + source_extra: path_o = f'{path_source}.obj' if windows() else f'{path_source}.o' path_os.append(path_o) prerequisites_path = f'{path_o}.d' if windows(): compiler_command2 = f''' {compiler_command} # General: /c # Compiles without linking. {EHsc} # Enable "Standard C++ exception handling". #/MD # Creates a multithreaded DLL using MSVCRT.lib. {'/MDd' if debug else '/MD'} # Input/output files: {T}{path_source} # /Tp specifies C++ source file. /Fo{path_o} # Output file. codespell:ignore # Include paths: {includes_text} {pythonflags.includes} # Include path for Python headers. # Code generation: {optimise2} {debug2} {permissive} # Set standard-conformance mode. # Diagnostics: #/FC # Display full path of source code files passed to cl.exe in diagnostic text. /W3 # Sets which warning level to output. /W3 is IDE default. /diagnostics:caret # Controls the format of diagnostic messages. /nologo # {defines_text} {compiler_extra} {py_limited_api3} ''' else: compiler_command2 = f''' {compiler_command} -fPIC {general_flags.strip()} {pythonflags.includes} {includes_text} {defines_text} -MD -MF {prerequisites_path} -c {path_source} -o {path_o} {compiler_extra} {py_limited_api3} ''' run_if( compiler_command2, path_o, path_source, [path_source] + _get_prerequisites(prerequisites_path), ) # Link prerequisites_path = f'{path_so}.d' if windows(): debug2 = '/DEBUG' if debug else '' base, _ = os.path.splitext(path_so_leaf) command2 = f''' {linker_command} /DLL # Builds a DLL. /EXPORT:PyInit__{name} # Exports a function. /IMPLIB:{base}.lib # Overrides the default import library name. {libpaths_text} {pythonflags.ldflags} /OUT:{path_so} # Specifies the output file name. {debug2} /nologo {libs_text} {' '.join(path_os)} {linker_extra} ''' elif pyodide(): command2 = f''' {linker_command} -MD -MF {prerequisites_path} -o {path_so} {' '.join(path_os)} {libpaths_text} {libs_text} {linker_extra} {pythonflags.ldflags} {rpath_flag} ''' else: command2 = f''' {linker_command} -shared {general_flags.strip()} -MD -MF {prerequisites_path} -o {path_so} {' '.join(path_os)} {libpaths_text} {libs_text} {linker_extra} {pythonflags.ldflags} {rpath_flag} {py_limited_api3} ''' link_was_run = run_if( command2, path_so, path_cpp, *path_os, *_get_prerequisites(f'{path_so}.d'), ) if link_was_run and darwin(): # We need to patch up references to shared libraries in `libs`. sublibraries = list() for lib in () if libs is None else libs: for libpath in libpaths: found = list() for suffix in '.so', '.dylib': path = f'{libpath}/lib{os.path.basename(lib)}{suffix}' if os.path.exists( path): found.append( path) if found: assert len(found) == 1, f'More than one file matches lib={lib!r}: {found}' sublibraries.append( found[0]) break else: log2(f'Warning: can not find path of lib={lib!r} in libpaths={libpaths}') macos_patch( path_so, *sublibraries) #run(f'ls -l {path_so}', check=0) #run(f'file {path_so}', check=0) _extensions_to_py_limited_api[os.path.abspath(path_so)] = py_limited_api return path_so_leaf # Functions that might be useful. # def base_compiler(vs=None, pythonflags=None, cpp=False, use_env=True): ''' Returns basic compiler command and PythonFlags. Args: vs: Windows only. A `wdev.WindowsVS` instance or None to use default `wdev.WindowsVS` instance. pythonflags: A `pipcl.PythonFlags` instance or None to use default `pipcl.PythonFlags` instance. cpp: If true we return C++ compiler command instead of C. On Windows this has no effect - we always return `cl.exe`. use_env: If true we return '$CC' or '$CXX' if the corresponding environmental variable is set (without evaluating with `getenv()` or `os.environ`). Returns `(cc, pythonflags)`: cc: C or C++ command. On Windows this is of the form `{vs.vcvars}&&{vs.cl}`; otherwise it is typically `cc` or `c++`. pythonflags: The `pythonflags` arg or a new `pipcl.PythonFlags` instance. ''' if not pythonflags: pythonflags = PythonFlags() cc = None if use_env: if cpp: if os.environ.get( 'CXX'): cc = '$CXX' else: if os.environ.get( 'CC'): cc = '$CC' if cc: pass elif windows(): if not vs: vs = wdev.WindowsVS() cc = f'"{vs.vcvars}"&&"{vs.cl}"' elif wasm(): cc = 'em++' if cpp else 'emcc' else: cc = 'c++' if cpp else 'cc' cc = macos_add_cross_flags( cc) return cc, pythonflags def base_linker(vs=None, pythonflags=None, cpp=False, use_env=True): ''' Returns basic linker command. Args: vs: Windows only. A `wdev.WindowsVS` instance or None to use default `wdev.WindowsVS` instance. pythonflags: A `pipcl.PythonFlags` instance or None to use default `pipcl.PythonFlags` instance. cpp: If true we return C++ linker command instead of C. On Windows this has no effect - we always return `link.exe`. use_env: If true we use `os.environ['LD']` if set. Returns `(linker, pythonflags)`: linker: Linker command. On Windows this is of the form `{vs.vcvars}&&{vs.link}`; otherwise it is typically `cc` or `c++`. pythonflags: The `pythonflags` arg or a new `pipcl.PythonFlags` instance. ''' if not pythonflags: pythonflags = PythonFlags() linker = None if use_env: if os.environ.get( 'LD'): linker = '$LD' if linker: pass elif windows(): if not vs: vs = wdev.WindowsVS() linker = f'"{vs.vcvars}"&&"{vs.link}"' elif wasm(): linker = 'em++' if cpp else 'emcc' else: linker = 'c++' if cpp else 'cc' linker = macos_add_cross_flags( linker) return linker, pythonflags def git_info( directory): ''' Returns `(sha, comment, diff, branch)`, all items are str or None if not available. directory: Root of git checkout. ''' sha, comment, diff, branch = None, None, None, None e, out = run( f'cd {directory} && (PAGER= git show --pretty=oneline|head -n 1 && git diff)', capture=1, check=0 ) if not e: sha, _ = out.split(' ', 1) comment, diff = _.split('\n', 1) e, out = run( f'cd {directory} && git rev-parse --abbrev-ref HEAD', capture=1, check=0 ) if not e: branch = out.strip() log1(f'git_info(): directory={directory!r} returning branch={branch!r} sha={sha!r} comment={comment!r}') return sha, comment, diff, branch def git_items( directory, submodules=False): ''' Returns list of paths for all files known to git within a `directory`. Args: directory: Must be somewhere within a git checkout. submodules: If true we also include git submodules. Returns: A list of paths for all files known to git within `directory`. Each path is relative to `directory`. `directory` must be somewhere within a git checkout. We run a `git ls-files` command internally. This function can be useful for the `fn_sdist()` callback. ''' command = 'cd ' + directory + ' && git ls-files' if submodules: command += ' --recurse-submodules' log1(f'Running {command=}') text = subprocess.check_output( command, shell=True) ret = [] for path in text.decode('utf8').strip().split( '\n'): path2 = os.path.join(directory, path) # Sometimes git ls-files seems to list empty/non-existent directories # within submodules. # if not os.path.exists(path2): log2(f'Ignoring git ls-files item that does not exist: {path2}') elif os.path.isdir(path2): log2(f'Ignoring git ls-files item that is actually a directory: {path2}') else: ret.append(path) return ret def git_get( local, *, remote=None, branch=None, tag=None, text=None, depth=1, env_extra=None, update=True, submodules=True, ): ''' Creates/updates local checkout of remote repository and returns absolute path of . If is set but does not start with 'git:', it is assumed to be an up to date local checkout, and we return absolute path of without doing any git operations. Args: local: Local directory. Created and/or updated using `git clone` and `git fetch` etc. remote: Remote git repostitory, for example 'https://github.com/ArtifexSoftware/mupdf.git'. Can be overridden by . branch: Branch to use; can be overridden by . tag: Tag to use; can be overridden by . text: If None or empty: Ignored. If starts with 'git:': The remaining text should be a command-line style string containing some or all of these args: --branch --tag These overrides , and . Otherwise: is assumed to be a local directory, and we simply return it as an absolute path without doing any git operations. For example these all clone/update/branch master of https://foo.bar/qwerty.git to local checkout 'foo-local': git_get('foo-local', remote='https://foo.bar/qwerty.git', branch='master') git_get('foo-local', text='git:--branch master https://foo.bar/qwerty.git') git_get('foo-local', text='git:--branch master', remote='https://foo.bar/qwerty.git') git_get('foo-local', text='git:', branch='master', remote='https://foo.bar/qwerty.git') depth: Depth of local checkout when cloning and fetching, or None. env_extra: Dict of extra name=value environment variables to use whenever we run git. update: If false we do not update existing repository. Might be useful if testing without network access. submodules: If true, we clone with `--recursive --shallow-submodules` and run `git submodule update --init --recursive` before returning. ''' log0(f'{remote=} {local=} {branch=} {tag=} {text=}') if text: if text.startswith('git:'): args = iter(shlex.split(text[len('git:'):])) while 1: try: arg = next(args) except StopIteration: break if arg == '--branch': branch = next(args) tag = None elif arg == '--tag': tag = next(args) branch = None else: remote = arg assert remote, f' unset and no remote specified in {text=}.' assert branch or tag, f' and unset and no branch/tag specified in {text=}.' else: log0(f'Using local directory {text!r}.') return os.path.abspath(text) assert (branch and not tag) or (not branch and tag), f'Must specify exactly one of and ; {branch=} {tag=}.' depth_arg = f' --depth {depth}' if depth else '' def do_update(): # This seems to pull in the entire repository. log0(f'do_update(): attempting to update {local=}.') # Remove any local changes. run(f'cd {local} && git reset --hard', env_extra=env_extra) if tag: # `-u` avoids `fatal: Refusing to fetch into current branch`. # Using '+' and `revs/tags/` prefix seems to avoid errors like: # error: cannot update ref 'refs/heads/v3.16.44': # trying to write non-commit object # 06c4ae5fe39a03b37a25a8b95214d9f8f8a867b8 to branch # 'refs/heads/v3.16.44' # run(f'cd {local} && git fetch -fuv{depth_arg} {remote} +refs/tags/{tag}:refs/tags/{tag}', env_extra=env_extra) run(f'cd {local} && git checkout {tag}', env_extra=env_extra) if branch: # `-u` avoids `fatal: Refusing to fetch into current branch`. run(f'cd {local} && git fetch -fuv{depth_arg} {remote} {branch}:{branch}', env_extra=env_extra) run(f'cd {local} && git checkout {branch}', env_extra=env_extra) do_clone = True if os.path.isdir(f'{local}/.git'): if update: # Try to update existing checkout. try: do_update() do_clone = False except Exception as e: log0(f'Failed to update existing checkout {local}: {e}') else: do_clone = False if do_clone: # No existing git checkout, so do a fresh clone. #_fs_remove(local) log0(f'Cloning to: {local}') command = f'git clone --config core.longpaths=true{depth_arg}' if submodules: command += f' --recursive --shallow-submodules' if branch: command += f' -b {branch}' if tag: command += f' -b {tag}' command += f' {remote} {local}' run(command, env_extra=env_extra) do_update() if submodules: run(f'cd {local} && git submodule update --init --recursive', env_extra=env_extra) # Show sha of checkout. run( f'cd {local} && git show --pretty=oneline|head -n 1', check=False) return os.path.abspath(local) def run( command, *, capture=False, check=1, verbose=1, env=None, env_extra=None, timeout=None, caller=1, prefix=None, encoding=None, # System default. errors='backslashreplace', ): ''' Runs a command using `subprocess.run()`. Args: command: A string, the command to run. Multiple lines in `command` are treated as a single command. * If a line starts with `#` it is discarded. * If a line contains ` #`, the trailing text is discarded. When running the command on Windows, newlines are replaced by spaces; otherwise each line is terminated by a backslash character. capture: If true, we include the command's output in our return value. check: If true we raise an exception on error; otherwise we include the command's returncode in our return value. verbose: If true we show the command. env: None or dict to use instead of . env_extra: None or dict to add to or . timeout: If not None, timeout in seconds; passed directly to subprocess.run(). Note that on MacOS subprocess.run() seems to leave processes running if timeout expires. prefix: String prefix for each line of output. If true: * We run command with stdout=subprocess.PIPE and stderr=subprocess.STDOUT, repetaedly reading the command's output and writing it to stdout with . * We do not support , which must be None. Returns: check capture Return -------------------------- false false returncode false true (returncode, output) true false None or raise exception true true output or raise exception ''' if env is None: env = os.environ if env_extra: env = env.copy() if env_extra: env.update(env_extra) lines = _command_lines( command) if verbose: text = f'Running:' nl = '\n ' text += f' {nl.join(lines)}' if env_extra: text += f'\nwith:\n' for k in sorted(env_extra.keys()): text += f' {k}={shlex.quote(env_extra[k])}\n' log1(text, caller=caller+1) sep = ' ' if windows() else ' \\\n' command2 = sep.join( lines) if prefix: assert not timeout, f'Timeout not supported with prefix.' child = subprocess.Popen( command2, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding=encoding, errors=errors, env=env, ) if capture: capture_text = '' decoder = codecs.getincrementaldecoder(child.stdout.encoding)(errors) line_start = True while 1: raw = os.read( child.stdout.fileno(), 10000) text = decoder.decode(raw, final=not raw) if capture: capture_text += text lines = text.split('\n') for i, line in enumerate(lines): if line_start: sys.stdout.write(prefix) line_start = False sys.stdout.write(line) if i < len(lines) - 1: sys.stdout.write('\n') line_start = True sys.stdout.flush() if not raw: break if not line_start: sys.stdout.write('\n') e = child.wait() if check and e: raise subprocess.CalledProcessError(e, command2, capture_text if capture else None) if check: return capture_text if capture else None else: return (e, capture_text) if capture else e else: cp = subprocess.run( command2, shell=True, stdout=subprocess.PIPE if capture else None, stderr=subprocess.STDOUT if capture else None, check=check, encoding=encoding, errors=errors, env=env, timeout=timeout, ) if check: return cp.stdout if capture else None else: return (cp.returncode, cp.stdout) if capture else cp.returncode def darwin(): return sys.platform.startswith( 'darwin') def windows(): return platform.system() == 'Windows' def wasm(): return os.environ.get( 'OS') in ('wasm', 'wasm-mt') def pyodide(): return os.environ.get( 'PYODIDE') == '1' def linux(): return platform.system() == 'Linux' def openbsd(): return platform.system() == 'OpenBSD' def show_system(): ''' Show useful information about the system plus argv and environ. Omits os.environ if $PIPCL_SHOW_ENV is '0'. ''' def log(text): log0(text, caller=3) #log(f'{__file__=}') #log(f'{__name__=}') log(f'{os.getcwd()=}') log(f'{platform.machine()=}') log(f'{platform.platform()=}') log(f'{platform.python_implementation()=}') log(f'{platform.python_version()=}') log(f'{platform.system()=}') if sys.implementation.name != 'graalpy': log(f'{platform.uname()=}') log(f'{sys.executable=}') log(f'{sys.version=}') log(f'{sys.version_info=}') log(f'{list(sys.version_info)=}') log(f'{sysconfig.get_config_var("Py_GIL_DISABLED")=}') try: log(f'{sys._is_gil_enabled()=}') except AttributeError: log(f'sys._is_gil_enabled() => AttributeError') log(f'CPU bits: {cpu_bits()}') log(f'sys.argv ({len(sys.argv)}):') for i, arg in enumerate(sys.argv): log(f' {i}: {arg!r}') PIPCL_SHOW_ENV = os.environ.get('PIPCL_SHOW_ENV') if PIPCL_SHOW_ENV == '0': log(f'[Not showing os.environ because {PIPCL_SHOW_ENV=}.]') else: log(f'os.environ ({len(os.environ)}):') for k in sorted( os.environ.keys()): v = os.environ[ k] if 'BEGIN OPENSSH PRIVATE KEY' in v: # Don't show private keys. log(f' {k} ****') else: log( f' {k}: {v!r}') class PythonFlags: ''' Compile/link flags for the current python, for example the include path needed to get `Python.h`. The 'PIPCL_PYTHON_CONFIG' environment variable allows to override the location of the python-config executable. Members: .includes: String containing compiler flags for include paths. .ldflags: String containing linker flags for library paths. ''' def __init__(self): # Experimental detection of python flags from sysconfig.*() instead of # python-config command. includes_, ldflags_ = sysconfig_python_flags() if pyodide(): _include_dir = os.environ[ 'PYO3_CROSS_INCLUDE_DIR'] _lib_dir = os.environ[ 'PYO3_CROSS_LIB_DIR'] self.includes = f'-I {_include_dir}' self.ldflags = f'-L {_lib_dir}' elif 0: self.includes = includes_ self.ldflags = ldflags_ elif windows(): wp = wdev.WindowsPython() self.includes = f'/I"{wp.include}"' self.ldflags = f'/LIBPATH:"{wp.libs}"' elif pyodide(): _include_dir = os.environ[ 'PYO3_CROSS_INCLUDE_DIR'] _lib_dir = os.environ[ 'PYO3_CROSS_LIB_DIR'] self.includes = f'-I {_include_dir}' self.ldflags = f'-L {_lib_dir}' else: python_config = os.environ.get("PIPCL_PYTHON_CONFIG") if not python_config: # We use python-config which appears to work better than pkg-config # because it copes with multiple installed python's, e.g. # manylinux_2014's /opt/python/cp*-cp*/bin/python*. # # But... on non-macos it seems that we should not attempt to specify # libpython on the link command. The manylinux docker containers # don't actually contain libpython.so, and it seems that this # deliberate. And the link command runs ok. # python_exe = os.path.realpath( sys.executable) if darwin(): # Basic install of dev tools with `xcode-select --install` doesn't # seem to provide a `python3-config` or similar, but there is a # `python-config.py` accessible via sysconfig. # # We try different possibilities and use the last one that # works. # python_config = None for pc in ( f'python3-config', f'{sys.executable} {sysconfig.get_config_var("srcdir")}/python-config.py', f'{python_exe}-config', ): e = subprocess.run( f'{pc} --includes', shell=1, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=0, ).returncode log2(f'{e=} from {pc!r}.') if e == 0: python_config = pc assert python_config, f'Cannot find python-config' else: python_config = f'{python_exe}-config' log2(f'Using {python_config=}.') try: self.includes = run( f'{python_config} --includes', capture=1, verbose=0).strip() except Exception as e: raise Exception('We require python development tools to be installed.') from e self.ldflags = run( f'{python_config} --ldflags', capture=1, verbose=0).strip() if linux(): # It seems that with python-3.10 on Linux, we can get an # incorrect -lcrypt flag that on some systems (e.g. WSL) # causes: # # ImportError: libcrypt.so.2: cannot open shared object file: No such file or directory # ldflags2 = self.ldflags.replace(' -lcrypt ', ' ') if ldflags2 != self.ldflags: log2(f'### Have removed `-lcrypt` from ldflags: {self.ldflags!r} -> {ldflags2!r}') self.ldflags = ldflags2 if 0: log1(f'{self.includes=}') log1(f' {includes_=}') log1(f'{self.ldflags=}') log1(f' {ldflags_=}') def macos_add_cross_flags(command): ''' If running on MacOS and environment variables ARCHFLAGS is set (indicating we are cross-building, e.g. for arm64), returns `command` with extra flags appended. Otherwise returns unchanged `command`. ''' if darwin(): archflags = os.environ.get( 'ARCHFLAGS') if archflags: command = f'{command} {archflags}' log2(f'Appending ARCHFLAGS to command: {command}') return command return command def macos_patch( library, *sublibraries): ''' If running on MacOS, patches `library` so that all references to items in `sublibraries` are changed to `@rpath/{leafname}`. Does nothing on other platforms. library: Path of shared library. sublibraries: List of paths of shared libraries; these have typically been specified with `-l` when `library` was created. ''' log2( f'macos_patch(): library={library} sublibraries={sublibraries}') if not darwin(): return if not sublibraries: return subprocess.run( f'otool -L {library}', shell=1, check=1) command = 'install_name_tool' names = [] for sublibrary in sublibraries: name = subprocess.run( f'otool -D {sublibrary}', shell=1, check=1, capture_output=1, encoding='utf8', ).stdout.strip() name = name.split('\n') assert len(name) == 2 and name[0] == f'{sublibrary}:', f'{name=}' name = name[1] # strip trailing so_name. leaf = os.path.basename(name) m = re.match('^(.+[.]((so)|(dylib)))[0-9.]*$', leaf) assert m log2(f'Changing {leaf=} to {m.group(1)}') leaf = m.group(1) command += f' -change {name} @rpath/{leaf}' command += f' {library}' log2( f'Running: {command}') subprocess.run( command, shell=1, check=1) subprocess.run( f'otool -L {library}', shell=1, check=1) def _macos_fixup_platform_tag(tag): ''' Patch up platform tag on MacOS. E.g. `foo-1.2.3-cp311-none-macosx_13_x86_64.whl` causes `pip` to fail with: `not a supported wheel on this platform`. We seem to need to add `_0` to the OS version. (This is documented at https://packaging.python.org/en/latest/specifications/platform-compatibility-tags/#macos). And with graal we need to replace trailing `universal2` with x86_64 or arm64. On non-graal this causes problems because non-universal platform tags seem more restricted than platform tags from sysconfig.get_platform(). For example: pip install ...-macosx_10_13_arm64.whl ERROR: ...-macosx_10_13_arm64.whl is not a supported wheel on this platform. pip install ...-macosx_10_13_universal2.whl Ok. ''' m = re.match( '^macosx_([0-9_]+)_([^0-9].+)$', tag) if not m: return tag a = m.group(1) if '_' not in a: a += '_0' b = m.group(2) if sys.implementation.name == 'graalpy' and b == 'universal2': # Replace 'universal2' with x86_64 or arm64. b = platform.machine() ret = f'macosx_{a}_{b}' #log0(f'Changing from {tag=} to {ret=}.') return ret # Internal helpers. # def _command_lines( command): ''' Process multiline command by running through `textwrap.dedent()`, removes comments (lines starting with `#` or ` #` until end of line), removes entirely blank lines. Returns list of lines. ''' command = textwrap.dedent( command) lines = [] for line in command.split( '\n'): if line.startswith( '#'): h = 0 else: h = line.find( ' #') if h >= 0: line = line[:h] if line.strip(): lines.append(line.rstrip()) return lines def cpu_bits(): return int.bit_length(sys.maxsize+1) def _cpu_name(): ''' Returns `x32` or `x64` depending on Python build. ''' #log(f'sys.maxsize={hex(sys.maxsize)}') return f'x{32 if sys.maxsize == 2**31 - 1 else 64}' def run_if( command, out, *prerequisites, caller=1): ''' Runs a command only if the output file is not up to date. Args: command: The command to run. We write this and a hash of argv[0] into a file .cmd so that we know to run a command if the command itself has changed. out: Path of the output file. prerequisites: List of prerequisite paths or true/false/None items. If an item is None it is ignored, otherwise if an item is not a string we immediately return it cast to a bool. We recurse into directories, effectively using the newest file in the directory. Returns: True if we ran the command, otherwise None. If the output file does not exist, the command is run: >>> verbose(1) 1 >>> log_line_numbers(0) >>> out = 'run_if_test_out' >>> if os.path.exists( out): ... os.remove( out) >>> if os.path.exists( f'{out}.cmd'): ... os.remove( f'{out}.cmd') >>> run_if( f'touch {out}', out, caller=0) pipcl.py:run_if(): Running command because: File does not exist: 'run_if_test_out' pipcl.py:run_if(): Running: touch run_if_test_out True If we repeat, the output file will be up to date so the command is not run: >>> run_if( f'touch {out}', out, caller=0) pipcl.py:run_if(): Not running command because up to date: 'run_if_test_out' If we change the command, the command is run: >>> run_if( f'touch {out};', out, caller=0) pipcl.py:run_if(): Running command because: Command has changed: pipcl.py:run_if(): @@ -1,2 +1,2 @@ pipcl.py:run_if(): touch pipcl.py:run_if(): -run_if_test_out pipcl.py:run_if(): +run_if_test_out; pipcl.py:run_if(): pipcl.py:run_if(): Running: touch run_if_test_out; True If we add a prerequisite that is newer than the output, the command is run: >>> time.sleep(1) >>> prerequisite = 'run_if_test_prerequisite' >>> run( f'touch {prerequisite}', caller=0) pipcl.py:run(): Running: touch run_if_test_prerequisite >>> run_if( f'touch {out}', out, prerequisite, caller=0) pipcl.py:run_if(): Running command because: Command has changed: pipcl.py:run_if(): @@ -1,2 +1,2 @@ pipcl.py:run_if(): touch pipcl.py:run_if(): -run_if_test_out; pipcl.py:run_if(): +run_if_test_out pipcl.py:run_if(): pipcl.py:run_if(): Running: touch run_if_test_out True If we repeat, the output will be newer than the prerequisite, so the command is not run: >>> run_if( f'touch {out}', out, prerequisite, caller=0) pipcl.py:run_if(): Not running command because up to date: 'run_if_test_out' We detect changes to the contents of argv[0]: Create a shell script and run it: >>> _ = subprocess.run('rm run_if_test_argv0.* 1>/dev/null 2>/dev/null || true', shell=1) >>> with open('run_if_test_argv0.sh', 'w') as f: ... print('#! /bin/sh', file=f) ... print('echo hello world > run_if_test_argv0.out', file=f) >>> _ = subprocess.run(f'chmod u+x run_if_test_argv0.sh', shell=1) >>> run_if( f'./run_if_test_argv0.sh', f'run_if_test_argv0.out', caller=0) pipcl.py:run_if(): Running command because: File does not exist: 'run_if_test_argv0.out' pipcl.py:run_if(): Running: ./run_if_test_argv0.sh True Running it a second time does nothing: >>> run_if( f'./run_if_test_argv0.sh', f'run_if_test_argv0.out', caller=0) pipcl.py:run_if(): Not running command because up to date: 'run_if_test_argv0.out' Modify the script. >>> with open('run_if_test_argv0.sh', 'a') as f: ... print('\\necho hello >> run_if_test_argv0.out', file=f) And now it is run because the hash of argv[0] has changed: >>> run_if( f'./run_if_test_argv0.sh', f'run_if_test_argv0.out', caller=0) pipcl.py:run_if(): Running command because: arg0 hash has changed. pipcl.py:run_if(): Running: ./run_if_test_argv0.sh True ''' doit = False # Path of file containing pickle data for command and hash of command's # first arg. cmd_path = f'{out}.cmd' def hash_get(path): try: with open(path, 'rb') as f: return hashlib.md5(f.read()).hexdigest() except Exception as e: #log(f'Failed to get hash of {path=}: {e}') return None command_args = shlex.split(command or '') command_arg0_path = fs_find_in_paths(command_args[0]) command_arg0_hash = hash_get(command_arg0_path) cmd_args, cmd_arg0_hash = (None, None) if os.path.isfile(cmd_path): with open(cmd_path, 'rb') as f: try: cmd_args, cmd_arg0_hash = pickle.load(f) except Exception as e: #log(f'pickle.load() failed with {cmd_path=}: {e}') pass if not doit: # Set doit if outfile does not exist. out_mtime = _fs_mtime( out) if out_mtime == 0: doit = f'File does not exist: {out!r}' if not doit: # Set doit if command has changed. if command_args != cmd_args: if cmd_args is None: doit = 'No previous command stored' else: doit = f'Command has changed' if 0: doit += f':\n {cmd!r}\n {command!r}' if 0: doit += f'\nbefore:\n' doit += textwrap.indent(cmd, ' ') doit += f'\nafter:\n' doit += textwrap.indent(command, ' ') if 1: # Show diff based on commands split into pseudo lines by # shlex.split(). doit += ':\n' lines = difflib.unified_diff( cmd_args, command_args, lineterm='', ) # Skip initial lines. assert next(lines) == '--- ' assert next(lines) == '+++ ' for line in lines: doit += f' {line}\n' if not doit: # Set doit if argv[0] hash has changed. #print(f'{cmd_arg0_hash=} {command_arg0_hash=}', file=sys.stderr) if command_arg0_hash != cmd_arg0_hash: doit = f'arg0 hash has changed.' #doit = f'arg0 hash has changed from {cmd_arg0_hash=} to {command_arg0_hash=}..' if not doit: # See whether any prerequisites are newer than target. def _make_prerequisites(p): if isinstance( p, (list, tuple)): return list(p) else: return [p] prerequisites_all = list() for p in prerequisites: prerequisites_all += _make_prerequisites( p) if 0: log2( 'prerequisites_all:', caller=caller+1) for i in prerequisites_all: log2( f' {i!r}', caller=caller+1) pre_mtime = 0 pre_path = None for prerequisite in prerequisites_all: if isinstance( prerequisite, str): mtime = _fs_mtime_newest( prerequisite) if mtime >= pre_mtime: pre_mtime = mtime pre_path = prerequisite elif prerequisite is None: pass elif prerequisite: doit = str(prerequisite) break if not doit: if pre_mtime > out_mtime: doit = f'Prerequisite is new: {os.path.abspath(pre_path)!r}' if doit: # Remove `cmd_path` before we run the command, so any failure # will force rerun next time. # try: os.remove( cmd_path) except Exception: pass log1( f'Running command because: {doit}', caller=caller+1) run( command, caller=caller+1) # Write the command we ran, into `cmd_path`. with open(cmd_path, 'wb') as f: pickle.dump((command_args, command_arg0_hash), f) return True else: log1( f'Not running command because up to date: {out!r}', caller=caller+1) if 0: log2( f'out_mtime={time.ctime(out_mtime)} pre_mtime={time.ctime(pre_mtime)}.' f' pre_path={pre_path!r}: returning {ret!r}.' ) def fs_find_in_paths( name, paths=None, verbose=False): ''' Looks for `name` in paths and returns complete path. `paths` is list/tuple or `os.pathsep`-separated string; if `None` we use `$PATH`. If `name` contains `/`, we return `name` itself if it is a file or None, regardless of . ''' if '/' in name: return name if os.path.isfile( name) else None if paths is None: paths = os.environ.get( 'PATH', '') if verbose: log('From os.environ["PATH"]: {paths=}') if isinstance( paths, str): paths = paths.split( os.pathsep) if verbose: log('After split: {paths=}') for path in paths: p = os.path.join( path, name) if verbose: log('Checking {p=}') if os.path.isfile( p): if verbose: log('Returning because is file: {p!r}') return p if verbose: log('Returning None because not found: {name!r}') def _get_prerequisites(path): ''' Returns list of prerequisites from Makefile-style dependency file, e.g. created by `cc -MD -MF `. ''' ret = list() if os.path.isfile(path): with open(path) as f: for line in f: for item in line.split(): if item.endswith( (':', '\\')): continue ret.append( item) return ret def _fs_mtime_newest( path): ''' path: If a file, returns mtime of the file. If a directory, returns mtime of newest file anywhere within directory tree. Otherwise returns 0. ''' ret = 0 if os.path.isdir( path): for dirpath, dirnames, filenames in os.walk( path): for filename in filenames: path = os.path.join( dirpath, filename) ret = max( ret, _fs_mtime( path)) else: ret = _fs_mtime( path) return ret def _flags( items, prefix='', quote=''): ''' Turns sequence into string, prefixing/quoting each item. ''' if not items: return '' if isinstance( items, str): items = items, ret = '' for item in items: if ret: ret += ' ' ret += f'{prefix}{quote}{item}{quote}' return ret.strip() def _fs_mtime( filename, default=0): ''' Returns mtime of file, or `default` if error - e.g. doesn't exist. ''' try: return os.path.getmtime( filename) except OSError: return default def _normalise(name): # https://packaging.python.org/en/latest/specifications/name-normalization/#name-normalization return re.sub(r"[-_.]+", "-", name).lower() def _normalise2(name): # https://packaging.python.org/en/latest/specifications/binary-distribution-format/ return _normalise(name).replace('-', '_') def _assert_version_pep_440(version): assert re.match( r'^([1-9][0-9]*!)?(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))*((a|b|rc)(0|[1-9][0-9]*))?(\.post(0|[1-9][0-9]*))?(\.dev(0|[1-9][0-9]*))?$', version, ), \ f'Bad version: {version!r}.' g_verbose = int(os.environ.get('PIPCL_VERBOSE', '1')) def verbose(level=None): ''' Sets verbose level if `level` is not None. Returns verbose level. ''' global g_verbose if level is not None: g_verbose = level return g_verbose g_log_line_numbers = True def log_line_numbers(yes): ''' Sets whether to include line numbers; helps with doctest. ''' global g_log_line_numbers g_log_line_numbers = bool(yes) def log(text='', caller=1): _log(text, 0, caller+1) def log0(text='', caller=1): _log(text, 0, caller+1) def log1(text='', caller=1): _log(text, 1, caller+1) def log2(text='', caller=1): _log(text, 2, caller+1) def _log(text, level, caller): ''' Logs lines with prefix, if is lower or equal to . ''' if level <= g_verbose: fr = inspect.stack(context=0)[caller] filename = relpath(fr.filename) for line in text.split('\n'): if g_log_line_numbers: print(f'{filename}:{fr.lineno}:{fr.function}(): {line}', file=sys.stdout, flush=1) else: print(f'{filename}:{fr.function}(): {line}', file=sys.stdout, flush=1) def relpath(path, start=None, allow_up=True): ''' A safe alternative to os.path.relpath(), avoiding an exception on Windows if the drive needs to change - in this case we use os.path.abspath(). Args: path: Path to be processed. start: Start directory or current directory if None. allow_up: If false we return absolute path is is not within . ''' if windows(): try: ret = os.path.relpath(path, start) except ValueError: # os.path.relpath() fails if trying to change drives. ret = os.path.abspath(path) else: ret = os.path.relpath(path, start) if not allow_up and ret.startswith('../') or ret.startswith('..\\'): ret = os.path.abspath(path) return ret def _so_suffix(use_so_versioning=True): ''' Filename suffix for shared libraries is defined in pep-3149. The pep claims to only address posix systems, but the recommended sysconfig.get_config_var('EXT_SUFFIX') also seems to give the right string on Windows. If use_so_versioning is false, we return only the last component of the suffix, which removes any version number, for example changing `.cp312-win_amd64.pyd` to `.pyd`. ''' # Example values: # linux: .cpython-311-x86_64-linux-gnu.so # macos: .cpython-311-darwin.so # openbsd: .cpython-310.so # windows .cp311-win_amd64.pyd # # Only Linux and Windows seem to identify the cpu. For example shared # libraries in numpy-1.25.2-cp311-cp311-macosx_11_0_arm64.whl are called # things like `numpy/core/_simd.cpython-311-darwin.so`. # ret = sysconfig.get_config_var('EXT_SUFFIX') if not use_so_versioning: # Use last component only. ret = os.path.splitext(ret)[1] return ret def get_soname(path): ''' If we are on Linux and `path` is softlink and points to a shared library for which `objdump -p` contains 'SONAME', return the pointee. Otherwise return `path`. Useful if Linux shared libraries have been created with `-Wl,-soname,...`, where we need to embed the versioned library. ''' if linux() and os.path.islink(path): path2 = os.path.realpath(path) if subprocess.run(f'objdump -p {path2}|grep SONAME', shell=1, check=0).returncode == 0: return path2 elif openbsd(): # Return newest .so with version suffix. sos = glob.glob(f'{path}.*') log1(f'{sos=}') sos2 = list() for so in sos: suffix = so[len(path):] if not suffix or re.match('^[.][0-9.]*[0-9]$', suffix): sos2.append(so) sos2.sort(key=lambda p: os.path.getmtime(p)) log1(f'{sos2=}') return sos2[-1] return path def current_py_limited_api(): ''' Returns value of PyLIMITED_API to build for current Python. ''' a, b = map(int, platform.python_version().split('.')[:2]) return f'0x{a:02x}{b:02x}0000' def install_dir(root=None): ''' Returns install directory used by `install()`. This will be `sysconfig.get_path('platlib')`, modified by `root` if not None. ''' # todo: for pure-python we should use sysconfig.get_path('purelib') ? root2 = sysconfig.get_path('platlib') if root: if windows(): # If we are in a venv, `sysconfig.get_path('platlib')` # can be absolute, e.g. # `C:\\...\\venv-pypackage-3.11.1-64\\Lib\\site-packages`, so it's # not clear how to append it to `root`. So we just use `root`. return root else: # E.g. if `root` is `install' and `sysconfig.get_path('platlib')` # is `/usr/local/lib/python3.9/site-packages`, we set `root2` to # `install/usr/local/lib/python3.9/site-packages`. # return os.path.join( root, root2.lstrip( os.sep)) else: return root2 class _Record: ''' Internal - builds up text suitable for writing to a RECORD item, e.g. within a wheel. ''' def __init__(self): self.text = '' def add_content(self, content, to_, verbose=True): if isinstance(content, str): content = content.encode('utf8') # Specification for the line we write is supposed to be in # https://packaging.python.org/en/latest/specifications/binary-distribution-format # but it's not very clear. # h = hashlib.sha256(content) digest = h.digest() digest = base64.urlsafe_b64encode(digest) digest = digest.rstrip(b'=') digest = digest.decode('utf8') self.text += f'{to_},sha256={digest},{len(content)}\n' if verbose: log2(f'Adding {to_}') def add_file(self, from_, to_): log1(f'Adding file: {os.path.relpath(from_)} => {to_}') with open(from_, 'rb') as f: content = f.read() self.add_content(content, to_, verbose=False) def get(self, record_path=None): ''' Returns contents of the RECORD file. If `record_path` is specified we append a final line `,,`; this can be used to include the RECORD file itself in the contents, with empty hash and size fields. ''' ret = self.text if record_path: ret += f'{record_path},,\n' return ret class NewFiles: ''' Detects new/modified/updated files matching a glob pattern. Useful for detecting wheels created by pip or cubuildwheel etc. ''' def __init__(self, glob_pattern): # Find current matches of . self.glob_pattern = glob_pattern self.items0 = self._items() def get(self): ''' Returns list of new matches of - paths of files that were not present previously, or have different mtimes or have different contents. ''' ret = list() items = self._items() for path, id_ in items.items(): id0 = self.items0.get(path) if id0 != id_: ret.append(path) return ret def get_n(self, n): ''' Returns new files matching , asserting that there are exactly . ''' ret = self.get() assert len(ret) == n, f'{len(ret)=}: {ret}' return ret def get_one(self): ''' Returns new match of , asserting that there is exactly one. ''' return self.get_n(1)[0] def _file_id(self, path): mtime = os.stat(path).st_mtime with open(path, 'rb') as f: content = f.read() hash_ = hashlib.md5(content).digest() # With python >= 3.11 we can do: #hash_ = hashlib.file_digest(f, hashlib.md5).digest() return mtime, hash_ def _items(self): ret = dict() for path in glob.glob(self.glob_pattern): if os.path.isfile(path): ret[path] = self._file_id(path) return ret def swig_get(swig, quick, swig_local='pipcl-swig-git'): ''' Returns or a new swig binary. If is true and starts with 'git:' (not Windows), the remaining text is passed to git_get() and we clone/update/build swig, and return the built binary. We default to the main swig repository, branch master, so for example 'git:' will return the latest swig from branch master. Otherwise we simply return . Args: swig: If starts with 'git:', passed as arg to git_get(). quick: If true, we do not update/build local checkout if the binary is already present. swig_local: path to use for checkout. ''' if swig and swig.startswith('git:'): assert platform.system() != 'Windows', f'Cannot build swig on Windows.' # Note that {swig_local}/install/bin/swig doesn't work on MacOS because # {swig_local}/INSTALL is a file and the fs is case-insensitive. swig_binary = f'{swig_local}/install-dir/bin/swig' if quick and os.path.isfile(swig_binary): log1(f'{quick=} and {swig_binary=} already exists, so not downloading/building.') else: if darwin(): run(f'brew install automake') run(f'brew install pcre2') run(f'brew install bison') # Default bison doesn't work, and Brew's bison is not added to $PATH. # # > bison is keg-only, which means it was not symlinked into /opt/homebrew, # > because macOS already provides this software and installing another version in # > parallel can cause all kinds of trouble. # > # > If you need to have bison first in your PATH, run: # > echo 'export PATH="/opt/homebrew/opt/bison/bin:$PATH"' >> ~/.zshrc # swig_env_extra = dict() macos_add_brew_path('bison', swig_env_extra) run(f'which bison') run(f'which bison', env_extra=swig_env_extra) # Building swig requires bison>=3.5. bison_ok = 0 e, text = run(f'bison --version', capture=1, check=0, env_extra=swig_env_extra) if not e: log(textwrap.indent(text, ' ')) m = re.search('bison (GNU Bison) ([0-9]+)[.]([0-9]+)', text) if m: assert m, f'Unexpected output from `bison --version`: {text!r}' version_tuple = int(m.group(1)), int(m.group2()) if version_tuple >= (3, 5): bison_ok = 1 if not bison_ok: if 0: # Use git checkout. Fails to find scan-code.c. Presumably # something wrong with ./bootstrap? log(f'Cloning/fetching/build/installing bison.') bison_git = git_get( 'pipcl-bison-git', remote='https://git.savannah.gnu.org/git/bison.git', #branch='master', tag='v3.5.4', submodules=0, # recursive update fails. ) run(f'cd {bison_git} && git submodule update --init', prefix='bison git submodule update --init: ') run(f'cd {bison_git} && ./bootstrap', prefix='bison bootstrap: ') run(f'cd {bison_git} && ./configure', prefix='bison configure: ') run(f'cd {bison_git} && make', prefix='bison make: ') run(f'cd {bison_git} && sudo make install', prefix='bison make install: ') else: bison_version = 'bison-3.5.4' if not os.path.exists(f'{bison_version}.tar.gz'): run( f'wget -O {bison_version}.tar.gz-0 http://www.mirrorservice.org/sites/ftp.gnu.org/gnu/bison/{bison_version}.tar.gz', prefix='bison wget: ', ) os.rename(f'{bison_version}.tar.gz-0', f'{bison_version}.tar.gz') if not os.path.exists(f'{bison_version}'): run(f'tar -xzf {bison_version}.tar.gz', prefix='bison extract: ') run(f'cd {bison_version} && ./configure', prefix='bison configure: ') run(f'cd {bison_version} && make', prefix='bison make: ') run(f'cd {bison_version} && sudo make install', prefix='bison make install: ') # Clone swig. swig_env_extra = None swig_local = git_get( swig_local, text=swig, remote='https://github.com/swig/swig.git', branch='master', ) # Build swig. run(f'cd {swig_local} && ./autogen.sh', env_extra=swig_env_extra) run(f'cd {swig_local} && ./configure --prefix={swig_local}/install-dir', env_extra=swig_env_extra) run(f'cd {swig_local} && make', env_extra=swig_env_extra) run(f'cd {swig_local} && make install', env_extra=swig_env_extra) assert os.path.isfile(swig_binary) return swig_binary else: return swig def macos_add_brew_path(package, env=None, gnubin=True): ''' Adds path(s) for Brew 's binaries to env['PATH']. We assert-fail if the relevant directory does no exist. Args: package: Name of package. We get of installed package by running `brew --prefix `. env: The environment dict to modify. If None we use os.environ. If PATH is not in , we first copy os.environ['PATH'] into . gnubin: If true, we also add path to gnu binaries if it exists, /libexe/gnubin. ''' if not darwin(): return if env is None: env = os.environ if 'PATH' not in env: env['PATH'] = os.environ['PATH'] package_root = run(f'brew --prefix {package}', capture=1).strip() log(f'{package=} {package_root=}') def add(path): log(f'{path=}') if os.path.isdir(path): log(f'Prepending to $PATH: {path}') PATH = env['PATH'] env['PATH'] = f'{path}:{PATH}' return 1 else: log(f'Not a directory: {path=}') return 0 n = 0 n += add(f'{package_root}/bin') if gnubin: n += add(f'{package_root}/libexec/gnubin') assert n, f'Failed to add to $PATH, {package=} {gnubin=}.' def _show_dict(d): ret = '' for n in sorted(d.keys()): v = d[n] ret += f' {n}: {v!r}\n' return ret def show_sysconfig(): ''' Shows contents of sysconfig.get_paths() and sysconfig.get_config_vars() dicts. ''' import sysconfig paths = sysconfig.get_paths() log0(f'show_sysconfig().') log0(f'sysconfig.get_paths():\n{_show_dict(sysconfig.get_paths())}') log0(f'sysconfig.get_config_vars():\n{_show_dict(sysconfig.get_config_vars())}') def sysconfig_python_flags(): ''' Returns include paths and library directory for Python. Uses sysconfig.*(), overridden by environment variables PIPCL_SYSCONFIG_PATH_include, PIPCL_SYSCONFIG_PATH_platinclude and PIPCL_SYSCONFIG_CONFIG_VAR_LIBDIR if set. ''' include1_ = os.environ.get('PIPCL_SYSCONFIG_PATH_include') or sysconfig.get_path('include') include2_ = os.environ.get('PIPCL_SYSCONFIG_PATH_platinclude') or sysconfig.get_path('platinclude') ldflags_ = os.environ.get('PIPCL_SYSCONFIG_CONFIG_VAR_LIBDIR') or sysconfig.get_config_var('LIBDIR') includes_ = [include1_] if include2_ != include1_: includes_.append(include2_) if windows(): includes_ = [f'/I"{i}"' for i in includes_] ldflags_ = f'/LIBPATH:"{ldflags_}"' else: includes_ = [f'-I {i}' for i in includes_] ldflags_ = f'-L {ldflags_}' includes_ = ' '.join(includes_) return includes_, ldflags_ def venv_in(path=None): ''' If path is None, returns true if we are in a venv. Otherwise returns true only if we are in venv . ''' if path: return os.path.abspath(sys.prefix) == os.path.abspath(path) else: return sys.prefix != sys.base_prefix def venv_run(args, path, recreate=True, clean=False): ''' Runs Python command inside venv and returns termination code. Args: args: List of args or string command. path: Path of venv directory. recreate: If false we do not run ` -m venv ` if already exists. This avoids a delay in the common case where is already set up, but fails if exists but does not contain a valid venv. clean: If true we first delete . ''' if clean: log(f'Removing any existing venv {path}.') assert path.startswith('venv-') shutil.rmtree(path, ignore_errors=1) if recreate or not os.path.isdir(path): run(f'{sys.executable} -m venv {path}') if isinstance(args, str): args_string = args elif platform.system() == 'Windows': # shlex not reliable on Windows so we use Use crude quoting with "...". args_string = '' for i, arg in enumerate(args): assert '"' not in arg if i: args_string += ' ' args_string += f'"{arg}"' else: args_string = shlex.join(args) if platform.system() == 'Windows': command = f'{path}\\Scripts\\activate && python {args_string}' else: command = f'. {path}/bin/activate && python {args_string}' e = run(command, check=0) return e if __name__ == '__main__': # Internal-only limited command line support, used if # graal_legacy_python_config is true. # includes, ldflags = sysconfig_python_flags() if sys.argv[1] == '--doctest': import doctest if sys.argv[2:]: for f in sys.argv[2:]: ff = globals()[f] doctest.run_docstring_examples(ff, globals()) else: doctest.testmod(None) elif sys.argv[1:] == ['--graal-legacy-python-config', '--includes']: print(includes) elif sys.argv[1:] == ['--graal-legacy-python-config', '--ldflags']: print(ldflags) else: assert 0, f'Expected `--graal-legacy-python-config --includes|--ldflags` but {sys.argv=}' ================================================ FILE: src/pymupdf.py ================================================ # pylint: disable=wildcard-import,unused-import from . import * ================================================ FILE: src/table.py ================================================ """ Copyright (C) 2023 Artifex Software, Inc. This file is part of PyMuPDF. PyMuPDF 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. PyMuPDF 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 Alternative licensing terms are available from the licensor. For commercial licensing, see or contact Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco, CA 94129, USA, for further information. --------------------------------------------------------------------- Portions of this code have been ported from pdfplumber, see https://pypi.org/project/pdfplumber/. The ported code is under the following MIT license: --------------------------------------------------------------------- The MIT License (MIT) Copyright (c) 2015, Jeremy Singer-Vine Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------------------- Also see here: https://github.com/jsvine/pdfplumber/blob/stable/LICENSE.txt --------------------------------------------------------------------- The porting mainly pertains to files "table.py" and relevant parts of "utils/text.py" within pdfplumber's repository on Github. With respect to "text.py", we have removed functions or features that are not used by table processing. Examples are: * the text search function * simple text extraction * text extraction by lines Original pdfplumber code does neither detect, nor identify table headers. This PyMuPDF port adds respective code to the 'Table' class as method '_get_header'. This is implemented as new class TableHeader with the properties: * bbox: A tuple for the header's bbox * cells: A tuple for each bbox of a column header * names: A list of strings with column header text * external: A bool indicating whether the header is outside the table cells. """ import inspect import itertools import string import html from collections.abc import Sequence from dataclasses import dataclass from operator import itemgetter import weakref import pymupdf from pymupdf import mupdf # ------------------------------------------------------------------- # Start of PyMuPDF interface code # ------------------------------------------------------------------- # pylint: disable=no-name-in-module EDGES = [] # vector graphics from PyMuPDF CHARS = [] # text characters from PyMuPDF TEXTPAGE = None # textpage for cell text extraction TEXT_BOLD = mupdf.FZ_STEXT_BOLD TEXT_STRIKEOUT = mupdf.FZ_STEXT_STRIKEOUT FLAGS = ( 0 | pymupdf.TEXTFLAGS_TEXT | pymupdf.TEXT_COLLECT_STYLES | pymupdf.TEXT_ACCURATE_BBOXES | pymupdf.TEXT_MEDIABOX_CLIP ) # needed by mupdf function fz_find_table_within_bounds(). TABLE_DETECTOR_FLAGS = ( 0 | pymupdf.TEXT_ACCURATE_BBOXES | pymupdf.TEXT_SEGMENT | pymupdf.TEXT_COLLECT_VECTORS | pymupdf.TEXT_MEDIABOX_CLIP ) white_spaces = set(string.whitespace) # for checking white space only cells def rect_in_rect(inner, outer): """Check whether rectangle 'inner' is fully inside rectangle 'outer'.""" return ( 1 and inner[0] >= outer[0] and inner[1] >= outer[1] and inner[2] <= outer[2] and inner[3] <= outer[3] ) def chars_in_rect(CHARS, rect): """Check whether any of the chars in CHAR are inside rectangle 'rect'.""" return any( 1 and rect[0] <= c["x0"] and c["x1"] <= rect[2] and rect[1] <= c["y0"] and rect[3] >= c["y1"] for c in CHARS ) def _iou(r1, r2): """Compute intersection over union of two rectangles.""" ix = max(0, min(r1[2], r2[2]) - max(r1[0], r2[0])) iy = max(0, min(r1[3], r2[3]) - max(r1[1], r2[1])) intersection = ix * iy # intersection area if not intersection: return 0 area1 = (r1[2] - r1[0]) * (r1[3] - r1[1]) area2 = (r2[2] - r2[0]) * (r2[3] - r2[1]) return intersection / (area1 + area2 - intersection) def intersects_words_h(bbox, y, word_rects) -> bool: """Check whether any of the words in bbox are cut through by horizontal line y. """ return any(r.y0 < y < r.y1 for r in word_rects if rect_in_rect(r, bbox)) def get_table_dict_from_rect(textpage, rect): """Extract MuPDF table structure information from a given rectangle.""" table_dict = {} pymupdf.extra.make_table_dict(textpage.this.m_internal, table_dict, rect) return table_dict def make_table_from_bbox(textpage, word_rects, rect): """Detect table structure within a given rectangle.""" cells = [] # table cells as (x0,y0,x1,y1) tuples # calls fz_find_table_within_bounds block = get_table_dict_from_rect(textpage, rect) # No table structure found if not a grid block if block.get("type") != mupdf.FZ_STEXT_BLOCK_GRID: return cells bbox = pymupdf.Rect(block["bbox"]) # resulting table bbox # lists of (pos,uncertainty) tuples xpos = sorted(block["xpos"], key=lambda x: x[0]) ypos = sorted(block["ypos"], key=lambda y: y[0]) # maximum uncertainties in x and y directions xmaxu, ymaxu = block["max_uncertain"] # Modify ypos to remove uncertain positions, and y positions # that cut through words. nypos = [] for y, yunc in ypos: if yunc > 0: # allow no uncertain y values continue if intersects_words_h(bbox, y, word_rects): continue # allow no y that cuts through words if nypos and (y - nypos[-1] < 3): nypos[-1] = y # snap close positions else: nypos.append(y) # New max y uncertainty: 35% of remaining y positions. # Omit x positions that intersect too many words, otherwise # only remove x for the affected cells. ymaxu = max(0, round((len(nypos) - 2) * 0.35)) # Exclude x positions with too high uncertainty # (we allow more uncertainty in x direction) nxpos = [x[0] for x in xpos if x[1] <= ymaxu] if bbox.x1 > nxpos[-1] + 3: nxpos.append(bbox.x1) # ensure right table border # Compose cells from the remaining x and y positions. for i in range(len(nypos) - 1): row_box = pymupdf.Rect(bbox.x0, nypos[i], bbox.x1, nypos[i + 1]) # Sub-select words in this row and sort them by left coordinate row_words = sorted( [r for r in word_rects if rect_in_rect(r, row_box)], key=lambda r: r.x0 ) # Sub-select x values that do not cut through words this_xpos = [x for x in nxpos if not any(r.x0 < x < r.x1 for r in row_words)] for j in range(len(this_xpos) - 1): cell = pymupdf.Rect(this_xpos[j], nypos[i], this_xpos[j + 1], nypos[i + 1]) if not cell.is_empty: # valid cell cells.append(tuple(cell)) # Add new table to TableFinder tables return cells def extract_cells(textpage, cell, markdown=False): """Extract text from a rect-like 'cell' as plain or MD styled text. This function should ultimately be used to extract text from a table cell. Markdown output will only work correctly if extraction flag bit TEXT_COLLECT_STYLES is set. Args: textpage: A PyMuPDF TextPage object. Must have been created with TEXTFLAGS_TEXT | TEXT_COLLECT_STYLES. cell: A tuple (x0, y0, x1, y1) defining the cell's bbox. markdown: If True, return text formatted for Markdown. Returns: A string with the text extracted from the cell. """ text = "" for block in textpage.extractRAWDICT()["blocks"]: if block["type"] != 0: continue block_bbox = block["bbox"] if ( 0 or block_bbox[0] > cell[2] or block_bbox[2] < cell[0] or block_bbox[1] > cell[3] or block_bbox[3] < cell[1] ): continue # skip block outside cell for line in block["lines"]: lbbox = line["bbox"] if ( 0 or lbbox[0] > cell[2] or lbbox[2] < cell[0] or lbbox[1] > cell[3] or lbbox[3] < cell[1] ): continue # skip line outside cell if text: # must be a new line in the cell text += "
" if markdown else "\n" # strikeout detection only works with horizontal text horizontal = line["dir"] == (0, 1) or line["dir"] == (1, 0) for span in line["spans"]: sbbox = span["bbox"] if ( 0 or sbbox[0] > cell[2] or sbbox[2] < cell[0] or sbbox[1] > cell[3] or sbbox[3] < cell[1] ): continue # skip spans outside cell # only include chars with more than 50% bbox overlap span_text = "" for char in span["chars"]: this_char = char["c"] bbox = pymupdf.Rect(char["bbox"]) if abs(bbox & cell) > 0.5 * abs(bbox): span_text += this_char elif this_char in white_spaces: span_text += " " if not span_text: continue # skip empty span if not markdown: # no MD styling text += span_text continue prefix = "" suffix = "" if horizontal and span["char_flags"] & TEXT_STRIKEOUT: prefix += "~~" suffix = "~~" + suffix if span["char_flags"] & TEXT_BOLD: prefix += "**" suffix = "**" + suffix if span["flags"] & pymupdf.TEXT_FONT_ITALIC: prefix += "_" suffix = "_" + suffix if span["flags"] & pymupdf.TEXT_FONT_MONOSPACED: prefix += "`" suffix = "`" + suffix if len(span["chars"]) > 2: span_text = span_text.rstrip() # if span continues previous styling: extend cell text if (ls := len(suffix)) and text.endswith(suffix): text = text[:-ls] + span_text + suffix else: # append the span with new styling if not span_text.strip(): text += " " else: text += prefix + span_text + suffix return text.strip() # ------------------------------------------------------------------- # End of PyMuPDF interface code # ------------------------------------------------------------------- class UnsetFloat(float): pass NON_NEGATIVE_SETTINGS = [ "snap_tolerance", "snap_x_tolerance", "snap_y_tolerance", "join_tolerance", "join_x_tolerance", "join_y_tolerance", "edge_min_length", "min_words_vertical", "min_words_horizontal", "intersection_tolerance", "intersection_x_tolerance", "intersection_y_tolerance", ] TABLE_STRATEGIES = ["lines", "lines_strict", "text", "explicit"] UNSET = UnsetFloat(0) DEFAULT_SNAP_TOLERANCE = 3 DEFAULT_JOIN_TOLERANCE = 3 DEFAULT_MIN_WORDS_VERTICAL = 3 DEFAULT_MIN_WORDS_HORIZONTAL = 1 DEFAULT_X_TOLERANCE = 3 DEFAULT_Y_TOLERANCE = 3 DEFAULT_X_DENSITY = 7.25 DEFAULT_Y_DENSITY = 13 bbox_getter = itemgetter("x0", "top", "x1", "bottom") LIGATURES = { "ff": "ff", "ffi": "ffi", "ffl": "ffl", "fi": "fi", "fl": "fl", "st": "st", "ſt": "st", } def to_list(collection) -> list: if isinstance(collection, list): return collection elif isinstance(collection, Sequence): return list(collection) elif hasattr(collection, "to_dict"): res = collection.to_dict("records") # pragma: nocover return res else: return list(collection) class TextMap: """ A TextMap maps each unicode character in the text to an individual `char` object (or, in the case of layout-implied whitespace, `None`). """ def __init__(self, tuples=None) -> None: self.tuples = tuples self.as_string = "".join(map(itemgetter(0), tuples)) def match_to_dict( self, m, main_group: int = 0, return_groups: bool = True, return_chars: bool = True, ) -> dict: subset = self.tuples[m.start(main_group) : m.end(main_group)] chars = [c for (text, c) in subset if c is not None] x0, top, x1, bottom = objects_to_bbox(chars) result = { "text": m.group(main_group), "x0": x0, "top": top, "x1": x1, "bottom": bottom, } if return_groups: result["groups"] = m.groups() if return_chars: result["chars"] = chars return result class WordMap: """ A WordMap maps words->chars. """ def __init__(self, tuples) -> None: self.tuples = tuples def to_textmap( self, layout: bool = False, layout_width=0, layout_height=0, layout_width_chars: int = 0, layout_height_chars: int = 0, x_density=DEFAULT_X_DENSITY, y_density=DEFAULT_Y_DENSITY, x_shift=0, y_shift=0, y_tolerance=DEFAULT_Y_TOLERANCE, use_text_flow: bool = False, presorted: bool = False, expand_ligatures: bool = True, ) -> TextMap: """ Given a list of (word, chars) tuples (i.e., a WordMap), return a list of (char-text, char) tuples (i.e., a TextMap) that can be used to mimic the structural layout of the text on the page(s), using the following approach: - Sort the words by (doctop, x0) if not already sorted. - Calculate the initial doctop for the starting page. - Cluster the words by doctop (taking `y_tolerance` into account), and iterate through them. - For each cluster, calculate the distance between that doctop and the initial doctop, in points, minus `y_shift`. Divide that distance by `y_density` to calculate the minimum number of newlines that should come before this cluster. Append that number of newlines *minus* the number of newlines already appended, with a minimum of one. - Then for each cluster, iterate through each word in it. Divide each word's x0, minus `x_shift`, by `x_density` to calculate the minimum number of characters that should come before this cluster. Append that number of spaces *minus* the number of characters and spaces already appended, with a minimum of one. Then append the word's text. - At the termination of each line, add more spaces if necessary to mimic `layout_width`. - Finally, add newlines to the end if necessary to mimic to `layout_height`. Note: This approach currently works best for horizontal, left-to-right text, but will display all words regardless of orientation. There is room for improvement in better supporting right-to-left text, as well as vertical text. """ _textmap = [] if not len(self.tuples): return TextMap(_textmap) expansions = LIGATURES if expand_ligatures else {} if layout: if layout_width_chars: if layout_width: raise ValueError( "`layout_width` and `layout_width_chars` cannot both be set." ) else: layout_width_chars = int(round(layout_width / x_density)) if layout_height_chars: if layout_height: raise ValueError( "`layout_height` and `layout_height_chars` cannot both be set." ) else: layout_height_chars = int(round(layout_height / y_density)) blank_line = [(" ", None)] * layout_width_chars else: blank_line = [] num_newlines = 0 words_sorted_doctop = ( self.tuples if presorted or use_text_flow else sorted(self.tuples, key=lambda x: float(x[0]["doctop"])) ) first_word = words_sorted_doctop[0][0] doctop_start = first_word["doctop"] - first_word["top"] for i, ws in enumerate( cluster_objects( words_sorted_doctop, lambda x: float(x[0]["doctop"]), y_tolerance ) ): y_dist = ( (ws[0][0]["doctop"] - (doctop_start + y_shift)) / y_density if layout else 0 ) num_newlines_prepend = max( # At least one newline, unless this iis the first line int(i > 0), # ... or as many as needed to get the imputed "distance" from the top round(y_dist) - num_newlines, ) for i in range(num_newlines_prepend): if not len(_textmap) or _textmap[-1][0] == "\n": _textmap += blank_line _textmap.append(("\n", None)) num_newlines += num_newlines_prepend line_len = 0 line_words_sorted_x0 = ( ws if presorted or use_text_flow else sorted(ws, key=lambda x: float(x[0]["x0"])) ) for word, chars in line_words_sorted_x0: x_dist = (word["x0"] - x_shift) / x_density if layout else 0 num_spaces_prepend = max(min(1, line_len), round(x_dist) - line_len) _textmap += [(" ", None)] * num_spaces_prepend line_len += num_spaces_prepend for c in chars: letters = expansions.get(c["text"], c["text"]) for letter in letters: _textmap.append((letter, c)) line_len += 1 # Append spaces at end of line if layout: _textmap += [(" ", None)] * (layout_width_chars - line_len) # Append blank lines at end of text if layout: num_newlines_append = layout_height_chars - (num_newlines + 1) for i in range(num_newlines_append): if i > 0: _textmap += blank_line _textmap.append(("\n", None)) # Remove terminal newline if _textmap[-1] == ("\n", None): _textmap = _textmap[:-1] return TextMap(_textmap) class WordExtractor: def __init__( self, x_tolerance=DEFAULT_X_TOLERANCE, y_tolerance=DEFAULT_Y_TOLERANCE, keep_blank_chars: bool = False, use_text_flow=False, horizontal_ltr=True, # Should words be read left-to-right? vertical_ttb=False, # Should vertical words be read top-to-bottom? extra_attrs=None, split_at_punctuation=False, expand_ligatures=True, ): self.x_tolerance = x_tolerance self.y_tolerance = y_tolerance self.keep_blank_chars = keep_blank_chars self.use_text_flow = use_text_flow self.horizontal_ltr = horizontal_ltr self.vertical_ttb = vertical_ttb self.extra_attrs = [] if extra_attrs is None else extra_attrs # Note: string.punctuation = '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~' self.split_at_punctuation = ( string.punctuation if split_at_punctuation is True else (split_at_punctuation or "") ) self.expansions = LIGATURES if expand_ligatures else {} def merge_chars(self, ordered_chars: list): x0, top, x1, bottom = objects_to_bbox(ordered_chars) doctop_adj = ordered_chars[0]["doctop"] - ordered_chars[0]["top"] upright = ordered_chars[0]["upright"] direction = 1 if (self.horizontal_ltr if upright else self.vertical_ttb) else -1 matrix = ordered_chars[0]["matrix"] rotation = 0 if not upright and matrix[1] < 0: ordered_chars = reversed(ordered_chars) rotation = 270 if matrix[0] < 0 and matrix[3] < 0: rotation = 180 elif matrix[1] > 0: rotation = 90 word = { "text": "".join( self.expansions.get(c["text"], c["text"]) for c in ordered_chars ), "x0": x0, "x1": x1, "top": top, "doctop": top + doctop_adj, "bottom": bottom, "upright": upright, "direction": direction, "rotation": rotation, } for key in self.extra_attrs: word[key] = ordered_chars[0][key] return word def char_begins_new_word( self, prev_char, curr_char, ) -> bool: """This method takes several factors into account to determine if `curr_char` represents the beginning of a new word: - Whether the text is "upright" (i.e., non-rotated) - Whether the user has specified that horizontal text runs left-to-right (default) or right-to-left, as represented by self.horizontal_ltr - Whether the user has specified that vertical text the text runs top-to-bottom (default) or bottom-to-top, as represented by self.vertical_ttb - The x0, top, x1, and bottom attributes of prev_char and curr_char - The self.x_tolerance and self.y_tolerance settings. Note: In this case, x/y refer to those directions for non-rotated text. For vertical text, they are flipped. A more accurate terminology might be "*intra*line character distance tolerance" and "*inter*line character distance tolerance" An important note: The *intra*line distance is measured from the *end* of the previous character to the *beginning* of the current character, while the *inter*line distance is measured from the *top* of the previous character to the *top* of the next character. The reasons for this are partly repository-historical, and partly logical, as successive text lines' bounding boxes often overlap slightly (and we don't want that overlap to be interpreted as the two lines being the same line). The upright-ness of the character determines the attributes to compare, while horizontal_ltr/vertical_ttb determine the direction of the comparison. """ # Note: Due to the grouping step earlier in the process, # curr_char["upright"] will always equal prev_char["upright"]. if curr_char["upright"]: x = self.x_tolerance y = self.y_tolerance ay = prev_char["top"] cy = curr_char["top"] if self.horizontal_ltr: ax = prev_char["x0"] bx = prev_char["x1"] cx = curr_char["x0"] else: ax = -prev_char["x1"] bx = -prev_char["x0"] cx = -curr_char["x1"] else: x = self.y_tolerance y = self.x_tolerance ay = prev_char["x0"] cy = curr_char["x0"] if self.vertical_ttb: ax = prev_char["top"] bx = prev_char["bottom"] cx = curr_char["top"] else: ax = -prev_char["bottom"] bx = -prev_char["top"] cx = -curr_char["bottom"] return bool( # Intraline test (cx < ax) or (cx > bx + x) # Interline test or (cy > ay + y) ) def iter_chars_to_words(self, ordered_chars): current_word: list = [] def start_next_word(new_char=None): nonlocal current_word if current_word: yield current_word current_word = [] if new_char is None else [new_char] for char in ordered_chars: text = char["text"] if not self.keep_blank_chars and text.isspace(): yield from start_next_word(None) elif text in self.split_at_punctuation: yield from start_next_word(char) yield from start_next_word(None) elif current_word and self.char_begins_new_word(current_word[-1], char): yield from start_next_word(char) else: current_word.append(char) # Finally, after all chars processed if current_word: yield current_word def iter_sort_chars(self, chars): def upright_key(x) -> int: return -int(x["upright"]) for upright_cluster in cluster_objects(list(chars), upright_key, 0): upright = upright_cluster[0]["upright"] cluster_key = "doctop" if upright else "x0" # Cluster by line subclusters = cluster_objects( upright_cluster, itemgetter(cluster_key), self.y_tolerance ) for sc in subclusters: # Sort within line sort_key = "x0" if upright else "doctop" to_yield = sorted(sc, key=itemgetter(sort_key)) # Reverse order if necessary if not (self.horizontal_ltr if upright else self.vertical_ttb): yield from reversed(to_yield) else: yield from to_yield def iter_extract_tuples(self, chars): ordered_chars = chars if self.use_text_flow else self.iter_sort_chars(chars) grouping_key = itemgetter("upright", *self.extra_attrs) grouped_chars = itertools.groupby(ordered_chars, grouping_key) for keyvals, char_group in grouped_chars: for word_chars in self.iter_chars_to_words(char_group): yield (self.merge_chars(word_chars), word_chars) def extract_wordmap(self, chars) -> WordMap: return WordMap(list(self.iter_extract_tuples(chars))) def extract_words(self, chars: list) -> list: words = list(word for word, word_chars in self.iter_extract_tuples(chars)) return words def extract_words(chars: list, **kwargs) -> list: return WordExtractor(**kwargs).extract_words(chars) TEXTMAP_KWARGS = inspect.signature(WordMap.to_textmap).parameters.keys() WORD_EXTRACTOR_KWARGS = inspect.signature(WordExtractor).parameters.keys() def chars_to_textmap(chars: list, **kwargs) -> TextMap: kwargs.update({"presorted": True}) extractor = WordExtractor( **{k: kwargs[k] for k in WORD_EXTRACTOR_KWARGS if k in kwargs} ) wordmap = extractor.extract_wordmap(chars) textmap = wordmap.to_textmap( **{k: kwargs[k] for k in TEXTMAP_KWARGS if k in kwargs} ) return textmap def extract_text(chars: list, **kwargs) -> str: chars = to_list(chars) if len(chars) == 0: return "" if kwargs.get("layout"): return chars_to_textmap(chars, **kwargs).as_string else: y_tolerance = kwargs.get("y_tolerance", DEFAULT_Y_TOLERANCE) extractor = WordExtractor( **{k: kwargs[k] for k in WORD_EXTRACTOR_KWARGS if k in kwargs} ) words = extractor.extract_words(chars) if words: rotation = words[0]["rotation"] # rotation cannot change within a cell else: rotation = 0 if rotation == 90: words.sort(key=lambda w: (w["x1"], -w["top"])) lines = " ".join([w["text"] for w in words]) elif rotation == 270: words.sort(key=lambda w: (-w["x1"], w["top"])) lines = " ".join([w["text"] for w in words]) else: lines = cluster_objects(words, itemgetter("doctop"), y_tolerance) lines = "\n".join(" ".join(word["text"] for word in line) for line in lines) if rotation == 180: # needs extra treatment lines = "".join([(c if c != "\n" else " ") for c in reversed(lines)]) return lines def collate_line( line_chars: list, tolerance=DEFAULT_X_TOLERANCE, ) -> str: coll = "" last_x1 = None for char in sorted(line_chars, key=itemgetter("x0")): if (last_x1 is not None) and (char["x0"] > (last_x1 + tolerance)): coll += " " last_x1 = char["x1"] coll += char["text"] return coll def dedupe_chars(chars: list, tolerance=1) -> list: """ Removes duplicate chars — those sharing the same text, fontname, size, and positioning (within `tolerance`) as other characters in the set. """ key = itemgetter("fontname", "size", "upright", "text") pos_key = itemgetter("doctop", "x0") def yield_unique_chars(chars: list): sorted_chars = sorted(chars, key=key) for grp, grp_chars in itertools.groupby(sorted_chars, key=key): for y_cluster in cluster_objects( list(grp_chars), itemgetter("doctop"), tolerance ): for x_cluster in cluster_objects( y_cluster, itemgetter("x0"), tolerance ): yield sorted(x_cluster, key=pos_key)[0] deduped = yield_unique_chars(chars) return sorted(deduped, key=chars.index) def line_to_edge(line): edge = dict(line) edge["orientation"] = "h" if (line["top"] == line["bottom"]) else "v" return edge def rect_to_edges(rect) -> list: top, bottom, left, right = [dict(rect) for x in range(4)] top.update( { "object_type": "rect_edge", "height": 0, "y0": rect["y1"], "bottom": rect["top"], "orientation": "h", } ) bottom.update( { "object_type": "rect_edge", "height": 0, "y1": rect["y0"], "top": rect["top"] + rect["height"], "doctop": rect["doctop"] + rect["height"], "orientation": "h", } ) left.update( { "object_type": "rect_edge", "width": 0, "x1": rect["x0"], "orientation": "v", } ) right.update( { "object_type": "rect_edge", "width": 0, "x0": rect["x1"], "orientation": "v", } ) return [top, bottom, left, right] def curve_to_edges(curve) -> list: point_pairs = zip(curve["pts"], curve["pts"][1:]) return [ { "object_type": "curve_edge", "x0": min(p0[0], p1[0]), "x1": max(p0[0], p1[0]), "top": min(p0[1], p1[1]), "doctop": min(p0[1], p1[1]) + (curve["doctop"] - curve["top"]), "bottom": max(p0[1], p1[1]), "width": abs(p0[0] - p1[0]), "height": abs(p0[1] - p1[1]), "orientation": "v" if p0[0] == p1[0] else ("h" if p0[1] == p1[1] else None), } for p0, p1 in point_pairs ] def obj_to_edges(obj) -> list: t = obj["object_type"] if "_edge" in t: return [obj] elif t == "line": return [line_to_edge(obj)] else: return {"rect": rect_to_edges, "curve": curve_to_edges}[t](obj) def filter_edges( edges, orientation=None, edge_type=None, min_length=1, ) -> list: if orientation not in ("v", "h", None): raise ValueError("Orientation must be 'v' or 'h'") def test(e) -> bool: dim = "height" if e["orientation"] == "v" else "width" et_correct = e["object_type"] == edge_type if edge_type is not None else True orient_correct = orientation is None or e["orientation"] == orientation return bool(et_correct and orient_correct and (e[dim] >= min_length)) return list(filter(test, edges)) def cluster_list(xs, tolerance=0) -> list: if tolerance == 0: return [[x] for x in sorted(xs)] if len(xs) < 2: return [[x] for x in sorted(xs)] groups = [] xs = list(sorted(xs)) current_group = [xs[0]] last = xs[0] for x in xs[1:]: if x <= (last + tolerance): current_group.append(x) else: groups.append(current_group) current_group = [x] last = x groups.append(current_group) return groups def make_cluster_dict(values, tolerance) -> dict: clusters = cluster_list(list(set(values)), tolerance) nested_tuples = [ [(val, i) for val in value_cluster] for i, value_cluster in enumerate(clusters) ] return dict(itertools.chain(*nested_tuples)) def cluster_objects(xs, key_fn, tolerance) -> list: if not callable(key_fn): key_fn = itemgetter(key_fn) values = map(key_fn, xs) cluster_dict = make_cluster_dict(values, tolerance) get_0, get_1 = itemgetter(0), itemgetter(1) cluster_tuples = sorted(((x, cluster_dict.get(key_fn(x))) for x in xs), key=get_1) grouped = itertools.groupby(cluster_tuples, key=get_1) return [list(map(get_0, v)) for k, v in grouped] def move_object(obj, axis: str, value): assert axis in ("h", "v") if axis == "h": new_items = [ ("x0", obj["x0"] + value), ("x1", obj["x1"] + value), ] if axis == "v": new_items = [ ("top", obj["top"] + value), ("bottom", obj["bottom"] + value), ] if "doctop" in obj: new_items += [("doctop", obj["doctop"] + value)] if "y0" in obj: new_items += [ ("y0", obj["y0"] - value), ("y1", obj["y1"] - value), ] return obj.__class__(tuple(obj.items()) + tuple(new_items)) def snap_objects(objs, attr: str, tolerance) -> list: axis = {"x0": "h", "x1": "h", "top": "v", "bottom": "v"}[attr] list_objs = list(objs) clusters = cluster_objects(list_objs, itemgetter(attr), tolerance) avgs = [sum(map(itemgetter(attr), cluster)) / len(cluster) for cluster in clusters] snapped_clusters = [ [move_object(obj, axis, avg - obj[attr]) for obj in cluster] for cluster, avg in zip(clusters, avgs) ] return list(itertools.chain(*snapped_clusters)) def snap_edges( edges, x_tolerance=DEFAULT_SNAP_TOLERANCE, y_tolerance=DEFAULT_SNAP_TOLERANCE, ): """ Given a list of edges, snap any within `tolerance` pixels of one another to their positional average. """ by_orientation = {"v": [], "h": []} for e in edges: by_orientation[e["orientation"]].append(e) snapped_v = snap_objects(by_orientation["v"], "x0", x_tolerance) snapped_h = snap_objects(by_orientation["h"], "top", y_tolerance) return snapped_v + snapped_h def resize_object(obj, key: str, value): assert key in ("x0", "x1", "top", "bottom") old_value = obj[key] diff = value - old_value new_items = [ (key, value), ] if key == "x0": assert value <= obj["x1"] new_items.append(("width", obj["x1"] - value)) elif key == "x1": assert value >= obj["x0"] new_items.append(("width", value - obj["x0"])) elif key == "top": assert value <= obj["bottom"] new_items.append(("doctop", obj["doctop"] + diff)) new_items.append(("height", obj["height"] - diff)) if "y1" in obj: new_items.append(("y1", obj["y1"] - diff)) elif key == "bottom": assert value >= obj["top"] new_items.append(("height", obj["height"] + diff)) if "y0" in obj: new_items.append(("y0", obj["y0"] - diff)) return obj.__class__(tuple(obj.items()) + tuple(new_items)) def join_edge_group(edges, orientation: str, tolerance=DEFAULT_JOIN_TOLERANCE): """ Given a list of edges along the same infinite line, join those that are within `tolerance` pixels of one another. """ if orientation == "h": min_prop, max_prop = "x0", "x1" elif orientation == "v": min_prop, max_prop = "top", "bottom" else: raise ValueError("Orientation must be 'v' or 'h'") sorted_edges = list(sorted(edges, key=itemgetter(min_prop))) joined = [sorted_edges[0]] for e in sorted_edges[1:]: last = joined[-1] if e[min_prop] <= (last[max_prop] + tolerance): if e[max_prop] > last[max_prop]: # Extend current edge to new extremity joined[-1] = resize_object(last, max_prop, e[max_prop]) else: # Edge is separate from previous edges joined.append(e) return joined def merge_edges( edges, snap_x_tolerance, snap_y_tolerance, join_x_tolerance, join_y_tolerance, ): """ Using the `snap_edges` and `join_edge_group` methods above, merge a list of edges into a more "seamless" list. """ def get_group(edge): if edge["orientation"] == "h": return ("h", edge["top"]) else: return ("v", edge["x0"]) if snap_x_tolerance > 0 or snap_y_tolerance > 0: edges = snap_edges(edges, snap_x_tolerance, snap_y_tolerance) _sorted = sorted(edges, key=get_group) edge_groups = itertools.groupby(_sorted, key=get_group) edge_gen = ( join_edge_group( items, k[0], (join_x_tolerance if k[0] == "h" else join_y_tolerance) ) for k, items in edge_groups ) edges = list(itertools.chain(*edge_gen)) return edges def bbox_to_rect(bbox) -> dict: """ Return the rectangle (i.e a dict with keys "x0", "top", "x1", "bottom") for an object. """ return {"x0": bbox[0], "top": bbox[1], "x1": bbox[2], "bottom": bbox[3]} def objects_to_rect(objects) -> dict: """ Given an iterable of objects, return the smallest rectangle (i.e. a dict with "x0", "top", "x1", and "bottom" keys) that contains them all. """ return bbox_to_rect(objects_to_bbox(objects)) def merge_bboxes(bboxes): """ Given an iterable of bounding boxes, return the smallest bounding box that contains them all. """ x0, top, x1, bottom = zip(*bboxes) return (min(x0), min(top), max(x1), max(bottom)) def objects_to_bbox(objects): """ Given an iterable of objects, return the smallest bounding box that contains them all. """ return merge_bboxes(map(bbox_getter, objects)) def words_to_edges_h(words, word_threshold: int = DEFAULT_MIN_WORDS_HORIZONTAL): """ Find (imaginary) horizontal lines that connect the tops of at least `word_threshold` words. """ by_top = cluster_objects(words, itemgetter("top"), 1) large_clusters = filter(lambda x: len(x) >= word_threshold, by_top) rects = list(map(objects_to_rect, large_clusters)) if len(rects) == 0: return [] min_x0 = min(map(itemgetter("x0"), rects)) max_x1 = max(map(itemgetter("x1"), rects)) edges = [] for r in rects: edges += [ # Top of text { "x0": min_x0, "x1": max_x1, "top": r["top"], "bottom": r["top"], "width": max_x1 - min_x0, "orientation": "h", }, # For each detected row, we also add the 'bottom' line. This will # generate extra edges, (some will be redundant with the next row # 'top' line), but this catches the last row of every table. { "x0": min_x0, "x1": max_x1, "top": r["bottom"], "bottom": r["bottom"], "width": max_x1 - min_x0, "orientation": "h", }, ] return edges def get_bbox_overlap(a, b): a_left, a_top, a_right, a_bottom = a b_left, b_top, b_right, b_bottom = b o_left = max(a_left, b_left) o_right = min(a_right, b_right) o_bottom = min(a_bottom, b_bottom) o_top = max(a_top, b_top) o_width = o_right - o_left o_height = o_bottom - o_top if o_height >= 0 and o_width >= 0 and o_height + o_width > 0: return (o_left, o_top, o_right, o_bottom) else: return None def words_to_edges_v(words, word_threshold: int = DEFAULT_MIN_WORDS_VERTICAL): """ Find (imaginary) vertical lines that connect the left, right, or center of at least `word_threshold` words. """ # Find words that share the same left, right, or centerpoints by_x0 = cluster_objects(words, itemgetter("x0"), 1) by_x1 = cluster_objects(words, itemgetter("x1"), 1) def get_center(word): return float(word["x0"] + word["x1"]) / 2 by_center = cluster_objects(words, get_center, 1) clusters = by_x0 + by_x1 + by_center # Find the points that align with the most words sorted_clusters = sorted(clusters, key=lambda x: -len(x)) large_clusters = filter(lambda x: len(x) >= word_threshold, sorted_clusters) # For each of those points, find the bboxes fitting all matching words bboxes = list(map(objects_to_bbox, large_clusters)) # Iterate through those bboxes, condensing overlapping bboxes condensed_bboxes = [] for bbox in bboxes: overlap = any(get_bbox_overlap(bbox, c) for c in condensed_bboxes) if not overlap: condensed_bboxes.append(bbox) if not condensed_bboxes: return [] condensed_rects = map(bbox_to_rect, condensed_bboxes) sorted_rects = list(sorted(condensed_rects, key=itemgetter("x0"))) max_x1 = max(map(itemgetter("x1"), sorted_rects)) min_top = min(map(itemgetter("top"), sorted_rects)) max_bottom = max(map(itemgetter("bottom"), sorted_rects)) return [ { "x0": b["x0"], "x1": b["x0"], "top": min_top, "bottom": max_bottom, "height": max_bottom - min_top, "orientation": "v", } for b in sorted_rects ] + [ { "x0": max_x1, "x1": max_x1, "top": min_top, "bottom": max_bottom, "height": max_bottom - min_top, "orientation": "v", } ] def edges_to_intersections(edges, x_tolerance=1, y_tolerance=1) -> dict: """ Given a list of edges, return the points at which they intersect within `tolerance` pixels. """ intersections = {} v_edges, h_edges = [ list(filter(lambda x: x["orientation"] == o, edges)) for o in ("v", "h") ] for v in sorted(v_edges, key=itemgetter("x0", "top")): for h in sorted(h_edges, key=itemgetter("top", "x0")): if ( (v["top"] <= (h["top"] + y_tolerance)) and (v["bottom"] >= (h["top"] - y_tolerance)) and (v["x0"] >= (h["x0"] - x_tolerance)) and (v["x0"] <= (h["x1"] + x_tolerance)) ): vertex = (v["x0"], h["top"]) if vertex not in intersections: intersections[vertex] = {"v": [], "h": []} intersections[vertex]["v"].append(v) intersections[vertex]["h"].append(h) return intersections def obj_to_bbox(obj): """ Return the bounding box for an object. """ return bbox_getter(obj) def intersections_to_cells(intersections): """ Given a list of points (`intersections`), return all rectangular "cells" that those points describe. `intersections` should be a dictionary with (x0, top) tuples as keys, and a list of edge objects as values. The edge objects should correspond to the edges that touch the intersection. """ def edge_connects(p1, p2) -> bool: def edges_to_set(edges): return set(map(obj_to_bbox, edges)) if p1[0] == p2[0]: common = edges_to_set(intersections[p1]["v"]).intersection( edges_to_set(intersections[p2]["v"]) ) if len(common): return True if p1[1] == p2[1]: common = edges_to_set(intersections[p1]["h"]).intersection( edges_to_set(intersections[p2]["h"]) ) if len(common): return True return False points = list(sorted(intersections.keys())) n_points = len(points) def find_smallest_cell(points, i: int): if i == n_points - 1: return None pt = points[i] rest = points[i + 1 :] # Get all the points directly below and directly right below = [x for x in rest if x[0] == pt[0]] right = [x for x in rest if x[1] == pt[1]] for below_pt in below: if not edge_connects(pt, below_pt): continue for right_pt in right: if not edge_connects(pt, right_pt): continue bottom_right = (right_pt[0], below_pt[1]) if ( (bottom_right in intersections) and edge_connects(bottom_right, right_pt) and edge_connects(bottom_right, below_pt) ): return (pt[0], pt[1], bottom_right[0], bottom_right[1]) return None cell_gen = (find_smallest_cell(points, i) for i in range(len(points))) return list(filter(None, cell_gen)) def cells_to_tables(page, cells) -> list: """ Given a list of bounding boxes (`cells`), return a list of tables that hold those cells most simply (and contiguously). """ def bbox_to_corners(bbox) -> tuple: x0, top, x1, bottom = bbox return ((x0, top), (x0, bottom), (x1, top), (x1, bottom)) remaining_cells = list(cells) # Iterate through the cells found above, and assign them # to contiguous tables current_corners = set() current_cells = [] tables = [] while len(remaining_cells): initial_cell_count = len(current_cells) for cell in list(remaining_cells): cell_corners = bbox_to_corners(cell) # If we're just starting a table ... if len(current_cells) == 0: # ... immediately assign it to the empty group current_corners |= set(cell_corners) current_cells.append(cell) remaining_cells.remove(cell) else: # How many corners does this table share with the current group? corner_count = sum(c in current_corners for c in cell_corners) # If touching on at least one corner... if corner_count > 0: # ... assign it to the current group current_corners |= set(cell_corners) current_cells.append(cell) remaining_cells.remove(cell) # If this iteration did not find any more cells to append... if len(current_cells) == initial_cell_count: # ... start a new cell group tables.append(list(current_cells)) current_corners.clear() current_cells.clear() # Once we have exhausting the list of cells ... # ... and we have a cell group that has not been stored if len(current_cells): # ... store it. tables.append(list(current_cells)) # PyMuPDF modification: # Remove tables without text or having only 1 column for i in range(len(tables) - 1, -1, -1): r = pymupdf.EMPTY_RECT() x1_vals = set() x0_vals = set() for c in tables[i]: r |= c x1_vals.add(c[2]) x0_vals.add(c[0]) if ( len(x1_vals) < 2 or len(x0_vals) < 2 or white_spaces.issuperset( page.get_textbox( r, textpage=TEXTPAGE, ) ) ): del tables[i] # Sort the tables top-to-bottom-left-to-right based on the value of the # topmost-and-then-leftmost coordinate of a table. _sorted = sorted(tables, key=lambda t: min((c[1], c[0]) for c in t)) return _sorted class CellGroup: def __init__(self, cells): self.cells = cells self.bbox = ( min(map(itemgetter(0), filter(None, cells))), min(map(itemgetter(1), filter(None, cells))), max(map(itemgetter(2), filter(None, cells))), max(map(itemgetter(3), filter(None, cells))), ) class TableRow(CellGroup): pass class TableHeader: """PyMuPDF extension containing the identified table header.""" def __init__(self, bbox, cells, names, above): self.bbox = bbox self.cells = cells self.names = names self.external = above class Table: def __init__(self, page, cells): self.page = page self.textpage = None self.cells = cells self.header = self._get_header() # PyMuPDF extension @property def bbox(self): c = self.cells return ( min(map(itemgetter(0), c)), min(map(itemgetter(1), c)), max(map(itemgetter(2), c)), max(map(itemgetter(3), c)), ) @property def rows(self) -> list: _sorted = sorted(self.cells, key=itemgetter(1, 0)) xs = list(sorted(set(map(itemgetter(0), self.cells)))) rows = [] for y, row_cells in itertools.groupby(_sorted, itemgetter(1)): xdict = {cell[0]: cell for cell in row_cells} row = TableRow([xdict.get(x) for x in xs]) rows.append(row) return rows @property def row_count(self) -> int: # PyMuPDF extension return len(self.rows) @property def col_count(self) -> int: # PyMuPDF extension return max([len(r.cells) for r in self.rows]) def extract(self, **kwargs) -> list: chars = CHARS table_arr = [] def char_in_bbox(char, bbox) -> bool: v_mid = (char["top"] + char["bottom"]) / 2 h_mid = (char["x0"] + char["x1"]) / 2 x0, top, x1, bottom = bbox return bool( (h_mid >= x0) and (h_mid < x1) and (v_mid >= top) and (v_mid < bottom) ) for row in self.rows: arr = [] row_chars = [char for char in chars if char_in_bbox(char, row.bbox)] for cell in row.cells: if cell is None: cell_text = None else: cell_chars = [ char for char in row_chars if char_in_bbox(char, cell) ] if len(cell_chars): kwargs["x_shift"] = cell[0] kwargs["y_shift"] = cell[1] if "layout" in kwargs: kwargs["layout_width"] = cell[2] - cell[0] kwargs["layout_height"] = cell[3] - cell[1] cell_text = extract_text(cell_chars, **kwargs) else: cell_text = "" arr.append(cell_text) table_arr.append(arr) return table_arr def to_markdown(self, clean=False, fill_empty=True): """Output table content as a string in Github-markdown format. If "clean" then markdown syntax is removed from cell content. If "fill_empty" then cell content None is replaced by the values above (columns) or left (rows) in an effort to approximate row and columns spans. """ output = "|" rows = self.row_count cols = self.col_count # cell coordinates cell_boxes = [[c for c in r.cells] for r in self.rows] # cell text strings cells = [[None for i in range(cols)] for j in range(rows)] for i, row in enumerate(cell_boxes): for j, cell in enumerate(row): if cell is not None: cells[i][j] = extract_cells( self.textpage, cell_boxes[i][j], markdown=True ) if fill_empty: # fill "None" cells where possible # for rows, copy content from left to right for j in range(rows): for i in range(cols - 1): if cells[j][i + 1] is None: cells[j][i + 1] = cells[j][i] # for columns, copy top to bottom for i in range(cols): for j in range(rows - 1): if cells[j + 1][i] is None: cells[j + 1][i] = cells[j][i] # generate header string and MD separator for i, name in enumerate(self.header.names): if not name: # generate a name if empty name = f"Col{i+1}" name = name.replace("\n", "
") # use HTML line breaks if clean: # remove sensitive syntax name = html.escape(name.replace("-", "-")) output += name + "|" output += "\n" # insert GitHub header line separator output += "|" + "|".join("---" for i in range(self.col_count)) + "|\n" # skip first row in details if header is part of the table j = 0 if self.header.external else 1 # iterate over detail rows for row in cells[j:]: line = "|" for i, cell in enumerate(row): # replace None cells with empty string # use HTML line break tag if cell is None: cell = "" if clean: # remove sensitive syntax cell = html.escape(cell.replace("-", "-")) line += cell + "|" line += "\n" output += line return output + "\n" def to_pandas(self, **kwargs): """Return a pandas DataFrame version of the table.""" try: import pandas as pd except ModuleNotFoundError: pymupdf.message("Package 'pandas' is not installed") raise pd_dict = {} extract = self.extract() hdr = self.header names = self.header.names hdr_len = len(names) # ensure uniqueness of column names for i in range(hdr_len): name = names[i] if not name: names[i] = f"Col{i}" if hdr_len != len(set(names)): for i in range(hdr_len): name = names[i] if name != f"Col{i}": names[i] = f"{i}-{name}" if not hdr.external: # header is part of 'extract' extract = extract[1:] for i in range(hdr_len): key = names[i] value = [] for j in range(len(extract)): value.append(extract[j][i]) pd_dict[key] = value return pd.DataFrame(pd_dict) def _get_header(self, y_tolerance=3): """Identify the table header. *** PyMuPDF extension. *** Starting from the first line above the table upwards, check if it qualifies to be part of the table header. Criteria include: * A one-line table never has an extra header. * Column borders must not intersect any word. If this happens, all text of this line and above of it is ignored. * No excess inter-line distance: If a line further up has a distance of more than 1.5 times of its font size, it will be ignored and all lines above of it. * Must have same text properties. * Starting with the top table line, a bold text property cannot change back to non-bold. If not all criteria are met (or there is no text above the table), the first table row is assumed to be the header. """ page = self.page y_delta = y_tolerance def top_row_bg_color(self): """ Compare top row background color with color of same-sized bbox above. If different, return True indicating that the original table top row is already the header. """ bbox0 = pymupdf.Rect(self.rows[0].bbox) bboxt = bbox0 + (0, -bbox0.height, 0, -bbox0.height) # area above top_color0 = page.get_pixmap(clip=bbox0).color_topusage()[1] top_colort = page.get_pixmap(clip=bboxt).color_topusage()[1] if top_color0 != top_colort: return True # top row is header return False def row_has_bold(bbox): """Check if a row contains some bold text. If e.g. true for the top row, then it will be used as (internal) column header row if any of the following is true: * the previous (above) text line has no bold span * the second table row text has no bold span Returns True if any spans are bold else False. """ return any( c["bold"] for c in CHARS if rect_in_rect((c["x0"], c["y0"], c["x1"], c["y1"]), bbox) ) try: row = self.rows[0] cells = row.cells bbox = pymupdf.Rect(row.bbox) except IndexError: # this table has no rows return None # return this if we determine that the top row is the header header_top_row = TableHeader(bbox, cells, self.extract()[0], False) # 1-line tables have no extra header if len(self.rows) < 2: return header_top_row # 1-column tables have no extra header if len(cells) < 2: return header_top_row # assume top row is the header if second row is empty row2 = self.rows[1] # second row if all(c is None for c in row2.cells): # no valid cell bboxes in row2 return header_top_row # Special check: is top row bold? top_row_bold = row_has_bold(bbox) # assume top row is header if it is bold and any cell # of 2nd row is non-bold if top_row_bold and not row_has_bold(row2.bbox): return header_top_row if top_row_bg_color(self): # if area above top row has a different background color, # then top row is already the header return header_top_row # column coordinates (x1 values) in top row col_x = [c[2] if c is not None else None for c in cells[:-1]] # clip = page area above the table # We will inspect this area for text qualifying as column header. clip = +bbox # take row 0 bbox clip.y0 = 0 # start at top of page clip.y1 = bbox.y0 # end at top of table blocks = page.get_text("dict", clip=clip, flags=pymupdf.TEXTFLAGS_TEXT)[ "blocks" ] # non-empty, non-superscript spans above table, sorted descending by y1 spans = sorted( [ s for b in blocks for l in b["lines"] for s in l["spans"] if not ( white_spaces.issuperset(s["text"]) or s["flags"] & pymupdf.TEXT_FONT_SUPERSCRIPT ) ], key=lambda s: s["bbox"][3], reverse=True, ) select = [] # y1 coordinates above, sorted descending line_heights = [] # line heights above, sorted descending line_bolds = [] # bold indicator per line above, same sorting # walk through the spans and fill above 3 lists for i in range(len(spans)): s = spans[i] y1 = s["bbox"][3] # span bottom h = y1 - s["bbox"][1] # span bbox height bold = s["flags"] & pymupdf.TEXT_FONT_BOLD # use first item to start the lists if i == 0: select.append(y1) line_heights.append(h) line_bolds.append(bold) continue # get previous items from the 3 lists y0 = select[-1] h0 = line_heights[-1] bold0 = line_bolds[-1] if bold0 and not bold: break # stop if switching from bold to non-bold # if fitting in height of previous span, modify bbox if y0 - y1 <= y_delta or abs((y0 - h0) - s["bbox"][1]) <= y_delta: s["bbox"] = (s["bbox"][0], y0 - h0, s["bbox"][2], y0) spans[i] = s if bold: line_bolds[-1] = bold continue elif y0 - y1 > 1.5 * h0: break # stop if distance to previous line too large select.append(y1) line_heights.append(h) line_bolds.append(bold) if select == []: # nothing above the table? return header_top_row select = select[:5] # accept up to 5 lines for an external header # assume top row as header if text above is too far away if bbox.y0 - select[0] >= line_heights[0]: return header_top_row # accept top row as header if bold, but line above is not if top_row_bold and not line_bolds[0]: return header_top_row if spans == []: # nothing left above the table, return top row return header_top_row # re-compute clip above table nclip = pymupdf.EMPTY_RECT() for s in [s for s in spans if s["bbox"][3] >= select[-1]]: nclip |= s["bbox"] if not nclip.is_empty: clip = nclip clip.y1 = bbox.y0 # make sure we still include every word above # Confirm that no word in clip is intersecting a column separator word_rects = [pymupdf.Rect(w[:4]) for w in page.get_text("words", clip=clip)] word_tops = sorted(list(set([r[1] for r in word_rects])), reverse=True) select = [] # exclude lines with words that intersect a column border for top in word_tops: intersecting = [ (x, r) for x in col_x if x is not None for r in word_rects if r[1] == top and r[0] < x and r[2] > x ] if intersecting == []: select.append(top) else: # detected a word crossing a column border break if select == []: # nothing left over: return first row return header_top_row hdr_bbox = +clip # compute the header cells hdr_bbox.y0 = select[-1] # hdr_bbox top is smallest top coord of words hdr_cells = [ (c[0], hdr_bbox.y0, c[2], hdr_bbox.y1) if c is not None else None for c in cells ] # adjust left/right of header bbox hdr_bbox.x0 = self.bbox[0] hdr_bbox.x1 = self.bbox[2] # column names: no line breaks, no excess spaces hdr_names = [ ( page.get_textbox(c).replace("\n", " ").replace(" ", " ").strip() if c is not None else "" ) for c in hdr_cells ] return TableHeader(tuple(hdr_bbox), hdr_cells, hdr_names, True) @dataclass class TableSettings: vertical_strategy: str = "lines" horizontal_strategy: str = "lines" explicit_vertical_lines: list = None explicit_horizontal_lines: list = None snap_tolerance: float = DEFAULT_SNAP_TOLERANCE snap_x_tolerance: float = UNSET snap_y_tolerance: float = UNSET join_tolerance: float = DEFAULT_JOIN_TOLERANCE join_x_tolerance: float = UNSET join_y_tolerance: float = UNSET edge_min_length: float = 3 min_words_vertical: float = DEFAULT_MIN_WORDS_VERTICAL min_words_horizontal: float = DEFAULT_MIN_WORDS_HORIZONTAL intersection_tolerance: float = 3 intersection_x_tolerance: float = UNSET intersection_y_tolerance: float = UNSET text_settings: dict = None def __post_init__(self) -> "TableSettings": """Clean up user-provided table settings. Validates that the table settings provided consists of acceptable values and returns a cleaned up version. The cleaned up version fills out the missing values with the default values in the provided settings. TODO: Can be further used to validate that the values are of the correct type. For example, raising a value error when a non-boolean input is provided for the key ``keep_blank_chars``. :param table_settings: User-provided table settings. :returns: A cleaned up version of the user-provided table settings. :raises ValueError: When an unrecognised key is provided. """ for setting in NON_NEGATIVE_SETTINGS: if (getattr(self, setting) or 0) < 0: raise ValueError(f"Table setting '{setting}' cannot be negative") for orientation in ["horizontal", "vertical"]: strategy = getattr(self, orientation + "_strategy") if strategy not in TABLE_STRATEGIES: raise ValueError( f"{orientation}_strategy must be one of" f'{{{",".join(TABLE_STRATEGIES)}}}' ) if self.text_settings is None: self.text_settings = {} # This next section is for backwards compatibility for attr in ["x_tolerance", "y_tolerance"]: if attr not in self.text_settings: self.text_settings[attr] = self.text_settings.get("tolerance", 3) if "tolerance" in self.text_settings: del self.text_settings["tolerance"] # End of that section for attr, fallback in [ ("snap_x_tolerance", "snap_tolerance"), ("snap_y_tolerance", "snap_tolerance"), ("join_x_tolerance", "join_tolerance"), ("join_y_tolerance", "join_tolerance"), ("intersection_x_tolerance", "intersection_tolerance"), ("intersection_y_tolerance", "intersection_tolerance"), ]: if getattr(self, attr) is UNSET: setattr(self, attr, getattr(self, fallback)) return self @classmethod def resolve(cls, settings=None): if settings is None: return cls() elif isinstance(settings, cls): return settings elif isinstance(settings, dict): core_settings = {} text_settings = {} for k, v in settings.items(): if k[:5] == "text_": text_settings[k[5:]] = v else: core_settings[k] = v core_settings["text_settings"] = text_settings return cls(**core_settings) else: raise ValueError(f"Cannot resolve settings: {settings}") class TableFinder: """ Given a PDF page, find plausible table structures. Largely borrowed from Anssi Nurminen's master's thesis: http://dspace.cc.tut.fi/dpub/bitstream/handle/123456789/21520/Nurminen.pdf?sequence=3 ... and inspired by Tabula: https://github.com/tabulapdf/tabula-extractor/issues/16 """ def __init__(self, page, settings=None): self.page = weakref.proxy(page) self.textpage = None self.settings = TableSettings.resolve(settings) self.edges = self.get_edges() self.intersections = edges_to_intersections( self.edges, self.settings.intersection_x_tolerance, self.settings.intersection_y_tolerance, ) self.cells = intersections_to_cells(self.intersections) self.tables = [ Table(self.page, cell_group) for cell_group in cells_to_tables(self.page, self.cells) ] def get_edges(self) -> list: settings = self.settings for orientation in ["vertical", "horizontal"]: strategy = getattr(settings, orientation + "_strategy") if strategy == "explicit": lines = getattr(settings, "explicit_" + orientation + "_lines") if len(lines) < 2: raise ValueError( f"If {orientation}_strategy == 'explicit', " f"explicit_{orientation}_lines " f"must be specified as a list/tuple of two or more " f"floats/ints." ) v_strat = settings.vertical_strategy h_strat = settings.horizontal_strategy if v_strat == "text" or h_strat == "text": words = extract_words(CHARS, **(settings.text_settings or {})) else: words = [] v_explicit = [] for desc in settings.explicit_vertical_lines or []: if isinstance(desc, dict): for e in obj_to_edges(desc): if e["orientation"] == "v": v_explicit.append(e) else: v_explicit.append( { "x0": desc, "x1": desc, "top": self.page.rect[1], "bottom": self.page.rect[3], "height": self.page.rect[3] - self.page.rect[1], "orientation": "v", } ) if v_strat == "lines": v_base = filter_edges(EDGES, "v") elif v_strat == "lines_strict": v_base = filter_edges(EDGES, "v", edge_type="line") elif v_strat == "text": v_base = words_to_edges_v(words, word_threshold=settings.min_words_vertical) elif v_strat == "explicit": v_base = [] else: v_base = [] v = v_base + v_explicit h_explicit = [] for desc in settings.explicit_horizontal_lines or []: if isinstance(desc, dict): for e in obj_to_edges(desc): if e["orientation"] == "h": h_explicit.append(e) else: h_explicit.append( { "x0": self.page.rect[0], "x1": self.page.rect[2], "width": self.page.rect[2] - self.page.rect[0], "top": desc, "bottom": desc, "orientation": "h", } ) if h_strat == "lines": h_base = filter_edges(EDGES, "h") elif h_strat == "lines_strict": h_base = filter_edges(EDGES, "h", edge_type="line") elif h_strat == "text": h_base = words_to_edges_h( words, word_threshold=settings.min_words_horizontal ) elif h_strat == "explicit": h_base = [] else: h_base = [] h = h_base + h_explicit edges = list(v) + list(h) edges = merge_edges( edges, snap_x_tolerance=settings.snap_x_tolerance, snap_y_tolerance=settings.snap_y_tolerance, join_x_tolerance=settings.join_x_tolerance, join_y_tolerance=settings.join_y_tolerance, ) return filter_edges(edges, min_length=settings.edge_min_length) def __getitem__(self, i): tcount = len(self.tables) if i >= tcount: raise IndexError("table not on page") while i < 0: i += tcount return self.tables[i] """ Start of PyMuPDF interface code. The following functions are executed when "page.find_tables()" is called. * make_chars: Fills the CHARS list with text character information extracted via "rawdict" text extraction. Items in CHARS are formatted as expected by the table code. * make_edges: Fills the EDGES list with vector graphic information extracted via "get_drawings". Items in EDGES are formatted as expected by the table code. The lists CHARS and EDGES are used to replace respective document access of pdfplumber or, respectively pdfminer. The table code has been modified to use these lists instead of accessing page information themselves. """ # ----------------------------------------------------------------------------- # Extract all page characters to fill the CHARS list # ----------------------------------------------------------------------------- def make_chars(page, clip=None): """Extract text as "rawdict" to fill CHARS.""" page_number = page.number + 1 page_height = page.rect.height ctm = page.transformation_matrix TEXTPAGE = page.get_textpage(clip=clip, flags=FLAGS) blocks = page.get_text("rawdict", textpage=TEXTPAGE)["blocks"] doctop_base = page_height * page.number for block in blocks: for line in block["lines"]: ldir = line["dir"] # = (cosine, sine) of angle ldir = (round(ldir[0], 4), round(ldir[1], 4)) matrix = pymupdf.Matrix(ldir[0], -ldir[1], ldir[1], ldir[0], 0, 0) if ldir[1] == 0: upright = True else: upright = False for span in sorted(line["spans"], key=lambda s: s["bbox"][0]): fontname = span["font"] fontsize = span["size"] span_bold = bool( span["flags"] & pymupdf.TEXT_FONT_BOLD or span["char_flags"] & 8 ) color = pymupdf.sRGB_to_pdf(span["color"]) for char in sorted(span["chars"], key=lambda c: c["bbox"][0]): bbox = pymupdf.Rect(char["bbox"]) bbox_ctm = bbox * ctm origin = pymupdf.Point(char["origin"]) * ctm matrix.e = origin.x matrix.f = origin.y text = char["c"] char_dict = { "adv": bbox.x1 - bbox.x0 if upright else bbox.y1 - bbox.y0, "bottom": bbox.y1, "doctop": bbox.y0 + doctop_base, "fontname": fontname, "height": bbox.y1 - bbox.y0, "matrix": tuple(matrix), "ncs": "DeviceRGB", "non_stroking_color": color, "non_stroking_pattern": None, "object_type": "char", "page_number": page_number, "size": fontsize if upright else bbox.y1 - bbox.y0, "stroking_color": color, "stroking_pattern": None, "bold": span_bold, "text": text, "top": bbox.y0, "upright": upright, "width": bbox.x1 - bbox.x0, "x0": bbox.x0, "x1": bbox.x1, "y0": bbox_ctm.y0, "y1": bbox_ctm.y1, } CHARS.append(char_dict) return TEXTPAGE # ------------------------------------------------------------------------ # Extract all page vector graphics to fill the EDGES list. # We are ignoring Bézier curves completely and are converting everything # else to lines. # ------------------------------------------------------------------------ def make_edges(page, clip=None, tset=None, paths=None, add_lines=None, add_boxes=None): snap_x = tset.snap_x_tolerance snap_y = tset.snap_y_tolerance min_length = tset.edge_min_length lines_strict = ( tset.vertical_strategy == "lines_strict" or tset.horizontal_strategy == "lines_strict" ) page_height = page.rect.height doctop_basis = page.number * page_height page_number = page.number + 1 prect = page.rect if page.rotation in (90, 270): w, h = prect.br prect = pymupdf.Rect(0, 0, h, w) if clip is not None: clip = pymupdf.Rect(clip) else: clip = prect def are_neighbors(r1, r2): """Detect whether r1, r2 are neighbors. Defined as: The minimum distance between points of r1 and points of r2 is not larger than some delta. This check supports empty rect-likes and thus also lines. Note: This type of check is MUCH faster than native Rect containment checks. """ if ( # check if x-coordinates of r1 are within those of r2 r2.x0 - snap_x <= r1.x0 <= r2.x1 + snap_x or r2.x0 - snap_x <= r1.x1 <= r2.x1 + snap_x ) and ( # ... same for y-coordinates r2.y0 - snap_y <= r1.y0 <= r2.y1 + snap_y or r2.y0 - snap_y <= r1.y1 <= r2.y1 + snap_y ): return True # same check with r1 / r2 exchanging their roles (this is necessary!) if ( r1.x0 - snap_x <= r2.x0 <= r1.x1 + snap_x or r1.x0 - snap_x <= r2.x1 <= r1.x1 + snap_x ) and ( r1.y0 - snap_y <= r2.y0 <= r1.y1 + snap_y or r1.y0 - snap_y <= r2.y1 <= r1.y1 + snap_y ): return True return False def clean_graphics(npaths=None): """Detect and join rectangles of "connected" vector graphics.""" if npaths is None: allpaths = page.get_drawings() else: # accept passed-in vector graphics allpaths = npaths[:] # paths relevant for table detection paths = [] for p in allpaths: # If only looking at lines, we ignore fill-only paths, # except simulated lines (i.e. small width or height). if ( lines_strict and p["type"] == "f" and p["rect"].width > snap_x and p["rect"].height > snap_y ): continue paths.append(p) # start with all vector graphics rectangles prects = sorted(set([p["rect"] for p in paths]), key=lambda r: (r.y1, r.x0)) new_rects = [] # the final list of joined rectangles # ---------------------------------------------------------------- # Strategy: Join rectangles that "almost touch" each other. # Extend first rectangle with any other that is a "neighbor". # Then move it to the final list and continue with the rest. # ---------------------------------------------------------------- while prects: # the algorithm will empty this list prect0 = prects[0] # copy of first rectangle (performance reasons!) repeat = True while repeat: # this loop extends first rect in list repeat = False # set to true again if some other rect touches for i in range(len(prects) - 1, 0, -1): # run backwards if are_neighbors(prect0, prects[i]): # close enough to rect 0? prect0 |= prects[i].tl # extend rect 0 prect0 |= prects[i].br # extend rect 0 del prects[i] # delete this rect repeat = True # keep checking the rest # move rect 0 over to result list if there is some text in it if chars_in_rect(CHARS, prect0): # contains text, so accept it as a table bbox candidate new_rects.append(prect0) del prects[0] # remove from rect list return new_rects, paths bboxes, paths = clean_graphics(npaths=paths) def is_parallel(p1, p2): """Check if line is roughly axis-parallel.""" if abs(p1.x - p2.x) <= snap_x or abs(p1.y - p2.y) <= snap_y: return True return False def make_line(p, p1, p2, clip): """Given 2 points, make a line dictionary for table detection.""" if not is_parallel(p1, p2): # only accepting axis-parallel lines return {} # compute the extremal values x0 = min(p1.x, p2.x) x1 = max(p1.x, p2.x) y0 = min(p1.y, p2.y) y1 = max(p1.y, p2.y) # check for outside clip if x0 > clip.x1 or x1 < clip.x0 or y0 > clip.y1 or y1 < clip.y0: return {} if x0 < clip.x0: x0 = clip.x0 # adjust to clip boundary if x1 > clip.x1: x1 = clip.x1 # adjust to clip boundary if y0 < clip.y0: y0 = clip.y0 # adjust to clip boundary if y1 > clip.y1: y1 = clip.y1 # adjust to clip boundary width = x1 - x0 # from adjusted values height = y1 - y0 # from adjusted values if width == height == 0: return {} # nothing left to deal with line_dict = { "x0": x0, "y0": page_height - y0, "x1": x1, "y1": page_height - y1, "width": width, "height": height, "pts": [(x0, y0), (x1, y1)], "linewidth": p["width"], "stroke": True, "fill": False, "evenodd": False, "stroking_color": p["color"] if p["color"] else p["fill"], "non_stroking_color": None, "object_type": "line", "page_number": page_number, "stroking_pattern": None, "non_stroking_pattern": None, "top": y0, "bottom": y1, "doctop": y0 + doctop_basis, } return line_dict for p in paths: items = p["items"] # items in this path # if 'closePath', add a line from last to first point if p["closePath"] and items[0][0] == "l" and items[-1][0] == "l": items.append(("l", items[-1][2], items[0][1])) for i in items: if i[0] not in ("l", "re", "qu"): continue # ignore anything else if i[0] == "l": # a line p1, p2 = i[1:] line_dict = make_line(p, p1, p2, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) elif i[0] == "re": # A rectangle: decompose into 4 lines, but filter out # the ones that simulate a line rect = i[1].normalize() # normalize the rectangle if ( rect.width <= min_length and rect.width < rect.height ): # simulates a vertical line x = abs(rect.x1 + rect.x0) / 2 # take middle value for x p1 = pymupdf.Point(x, rect.y0) p2 = pymupdf.Point(x, rect.y1) line_dict = make_line(p, p1, p2, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) continue if ( rect.height <= min_length and rect.height < rect.width ): # simulates a horizontal line y = abs(rect.y1 + rect.y0) / 2 # take middle value for y p1 = pymupdf.Point(rect.x0, y) p2 = pymupdf.Point(rect.x1, y) line_dict = make_line(p, p1, p2, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) continue line_dict = make_line(p, rect.tl, rect.bl, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, rect.bl, rect.br, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, rect.br, rect.tr, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, rect.tr, rect.tl, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) else: # must be a quad # we convert it into (up to) 4 lines ul, ur, ll, lr = i[1] line_dict = make_line(p, ul, ll, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, ll, lr, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, lr, ur, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(p, ur, ul, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) path = {"color": (0, 0, 0), "fill": None, "width": 1} for bbox in bboxes: # add the border lines for all enveloping bboxes line_dict = make_line(path, bbox.tl, bbox.tr, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, bbox.bl, bbox.br, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, bbox.tl, bbox.bl, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, bbox.tr, bbox.br, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) if add_lines is not None: # add user-specified lines assert isinstance(add_lines, (tuple, list)) else: add_lines = [] for p1, p2 in add_lines: p1 = pymupdf.Point(p1) p2 = pymupdf.Point(p2) line_dict = make_line(path, p1, p2, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) if add_boxes is not None: # add user-specified rectangles assert isinstance(add_boxes, (tuple, list)) else: add_boxes = [] for box in add_boxes: r = pymupdf.Rect(box) line_dict = make_line(path, r.tl, r.bl, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, r.bl, r.br, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, r.br, r.tr, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) line_dict = make_line(path, r.tr, r.tl, clip) if line_dict: EDGES.append(line_to_edge(line_dict)) def page_rotation_set0(page): """Nullify page rotation. To correctly detect tables, page rotation must be zero. This function performs the necessary adjustments and returns information for reverting this changes. """ mediabox = page.mediabox rot = page.rotation # contains normalized rotation value # need to derotate the page's content mb = page.mediabox # current mediabox if rot == 90: # before derotation, shift content horizontally mat0 = pymupdf.Matrix(1, 0, 0, 1, mb.y1 - mb.x1 - mb.x0 - mb.y0, 0) elif rot == 270: # before derotation, shift content vertically mat0 = pymupdf.Matrix(1, 0, 0, 1, 0, mb.x1 - mb.y1 - mb.y0 - mb.x0) else: mat0 = pymupdf.Matrix(1, 0, 0, 1, -2 * mb.x0, -2 * mb.y0) # prefix with derotation matrix mat = mat0 * page.derotation_matrix cmd = b"%g %g %g %g %g %g cm " % tuple(mat) xref = pymupdf.TOOLS._insert_contents(page, cmd, 0) # swap x- and y-coordinates if rot in (90, 270): x0, y0, x1, y1 = mb mb.x0 = y0 mb.y0 = x0 mb.x1 = y1 mb.y1 = x1 page.set_mediabox(mb) page.set_rotation(0) # refresh the page to apply these changes doc = page.parent pno = page.number page = doc[pno] return page, xref, rot, mediabox def page_rotation_reset(page, xref, rot, mediabox): """Reset page rotation to original values. To be used before we return tables.""" doc = page.parent # document of the page doc.update_stream(xref, b" ") # remove de-rotation matrix page.set_mediabox(mediabox) # set mediabox to old value page.set_rotation(rot) # set rotation to old value pno = page.number page = doc[pno] # update page info return page def find_tables( page, clip=None, vertical_strategy: str = "lines", horizontal_strategy: str = "lines", vertical_lines: list = None, horizontal_lines: list = None, snap_tolerance: float = DEFAULT_SNAP_TOLERANCE, snap_x_tolerance: float = None, snap_y_tolerance: float = None, join_tolerance: float = DEFAULT_JOIN_TOLERANCE, join_x_tolerance: float = None, join_y_tolerance: float = None, edge_min_length: float = 3, min_words_vertical: float = DEFAULT_MIN_WORDS_VERTICAL, min_words_horizontal: float = DEFAULT_MIN_WORDS_HORIZONTAL, intersection_tolerance: float = 3, intersection_x_tolerance: float = None, intersection_y_tolerance: float = None, text_tolerance=3, text_x_tolerance=3, text_y_tolerance=3, strategy=None, # offer abbreviation add_lines=None, # user-specified lines add_boxes=None, # user-specified rectangles paths=None, # accept vector graphics as parameter ): pymupdf._warn_layout_once() CHARS.clear() EDGES.clear() TEXTPAGE = None old_small = bool(pymupdf.TOOLS.set_small_glyph_heights()) # save old value pymupdf.TOOLS.set_small_glyph_heights(True) # we need minimum bboxes if page.rotation != 0: page, old_xref, old_rot, old_mediabox = page_rotation_set0(page) else: old_xref, old_rot, old_mediabox = None, None, None if snap_x_tolerance is None: snap_x_tolerance = UNSET if snap_y_tolerance is None: snap_y_tolerance = UNSET if join_x_tolerance is None: join_x_tolerance = UNSET if join_y_tolerance is None: join_y_tolerance = UNSET if intersection_x_tolerance is None: intersection_x_tolerance = UNSET if intersection_y_tolerance is None: intersection_y_tolerance = UNSET if strategy is not None: vertical_strategy = strategy horizontal_strategy = strategy settings = { "vertical_strategy": vertical_strategy, "horizontal_strategy": horizontal_strategy, "explicit_vertical_lines": vertical_lines, "explicit_horizontal_lines": horizontal_lines, "snap_tolerance": snap_tolerance, "snap_x_tolerance": snap_x_tolerance, "snap_y_tolerance": snap_y_tolerance, "join_tolerance": join_tolerance, "join_x_tolerance": join_x_tolerance, "join_y_tolerance": join_y_tolerance, "edge_min_length": edge_min_length, "min_words_vertical": min_words_vertical, "min_words_horizontal": min_words_horizontal, "intersection_tolerance": intersection_tolerance, "intersection_x_tolerance": intersection_x_tolerance, "intersection_y_tolerance": intersection_y_tolerance, "text_tolerance": text_tolerance, "text_x_tolerance": text_x_tolerance, "text_y_tolerance": text_y_tolerance, } old_quad_corrections = pymupdf.TOOLS.unset_quad_corrections() try: page.get_layout() if page.layout_information: pymupdf.TOOLS.unset_quad_corrections(True) boxes = [ pymupdf.Rect(b[:4]) for b in page.layout_information if b[-1] == "table" ] else: boxes = [] if boxes: # layout did find some tables pass elif page.layout_information is not None: # layout was executed but found no tables # make sure we exit quickly with an empty TableFinder tbf = TableFinder(page) return tbf tset = TableSettings.resolve(settings=settings) page.table_settings = tset TEXTPAGE = make_chars(page, clip=clip) # create character list of page make_edges( page, clip=clip, tset=tset, paths=paths, add_lines=add_lines, add_boxes=add_boxes, ) # create lines and curves tbf = TableFinder(page, settings=tset) tbf.textpage = TEXTPAGE # store textpage for later use if boxes: # only keep Finder tables that match a layout box tbf.tables = [ tab for tab in tbf.tables if any(_iou(tab.bbox, r) >= 0.6 for r in boxes) ] # build the complementary list of layout table boxes my_boxes = [ r for r in boxes if all(_iou(r, tab.bbox) < 0.6 for tab in tbf.tables) ] if my_boxes: word_rects = [pymupdf.Rect(w[:4]) for w in TEXTPAGE.extractWORDS()] tp2 = page.get_textpage(flags=TABLE_DETECTOR_FLAGS) for rect in my_boxes: cells = make_table_from_bbox(tp2, word_rects, rect) # pylint: disable=E0606 tbf.tables.append(Table(page, cells)) except Exception as e: pymupdf.message("find_tables: exception occurred: %s" % str(e)) return None finally: pymupdf.TOOLS.set_small_glyph_heights(old_small) if old_xref is not None: page = page_rotation_reset(page, old_xref, old_rot, old_mediabox) pymupdf.TOOLS.unset_quad_corrections(old_quad_corrections) for table in tbf.tables: table.textpage = TEXTPAGE return tbf ================================================ FILE: src/utils.py ================================================ # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ import math import typing import weakref try: from . import pymupdf except Exception: import pymupdf _format_g = pymupdf.format_g g_exceptions_verbose = pymupdf.g_exceptions_verbose point_like = "point_like" rect_like = "rect_like" matrix_like = "matrix_like" quad_like = "quad_like" # ByteString is gone from typing in 3.14. # collections.abc.Buffer available from 3.12 only try: ByteString = typing.ByteString except AttributeError: # pylint: disable=unsupported-binary-operation ByteString = bytes | bytearray | memoryview AnyType = typing.Any OptInt = typing.Union[int, None] OptFloat = typing.Optional[float] OptStr = typing.Optional[str] OptDict = typing.Optional[dict] OptBytes = typing.Optional[ByteString] OptSeq = typing.Optional[typing.Sequence] """ This is a collection of functions to extend PyMupdf. """ def get_text_blocks( page: pymupdf.Page, clip: rect_like = None, flags: OptInt = None, textpage: pymupdf.TextPage = None, sort: bool = False, ) -> list: """Return the text blocks on a page. Notes: Lines in a block are concatenated with line breaks. Args: flags: (int) control the amount of data parsed into the textpage. Returns: A list of the blocks. Each item contains the containing rectangle coordinates, text lines, running block number and block type. """ pymupdf.CheckParent(page) if flags is None: flags = pymupdf.TEXTFLAGS_BLOCKS tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") blocks = tp.extractBLOCKS() if textpage is None: del tp if sort: blocks.sort(key=lambda b: (b[3], b[0])) return blocks def get_text_words( page: pymupdf.Page, clip: rect_like = None, flags: OptInt = None, textpage: pymupdf.TextPage = None, sort: bool = False, delimiters=None, tolerance=3, ) -> list: """Return the text words as a list with the bbox for each word. Args: page: pymupdf.Page clip: (rect-like) area on page to consider flags: (int) control the amount of data parsed into the textpage. textpage: (pymupdf.TextPage) either passed-in or None. sort: (bool) sort the words in reading sequence. delimiters: (str,list) characters to use as word delimiters. tolerance: (float) consider words to be part of the same line if top or bottom coordinate are not larger than this. Relevant only if sort=True. Returns: Word tuples (x0, y0, x1, y1, "word", bno, lno, wno). """ def sort_words(words): """Sort words line-wise, forgiving small deviations.""" words.sort(key=lambda w: (w[3], w[0])) nwords = [] # final word list line = [words[0]] # collects words roughly in same line lrect = pymupdf.Rect(words[0][:4]) # start the line rectangle for w in words[1:]: wrect = pymupdf.Rect(w[:4]) if ( abs(wrect.y0 - lrect.y0) <= tolerance or abs(wrect.y1 - lrect.y1) <= tolerance ): line.append(w) lrect |= wrect else: line.sort(key=lambda w: w[0]) # sort words in line l-t-r nwords.extend(line) # append to final words list line = [w] # start next line lrect = wrect # start next line rect line.sort(key=lambda w: w[0]) # sort words in line l-t-r nwords.extend(line) # append to final words list return nwords pymupdf.CheckParent(page) if flags is None: flags = pymupdf.TEXTFLAGS_WORDS tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") words = tp.extractWORDS(delimiters) # if textpage was given, we subselect the words in clip if textpage is not None and clip is not None: # sub-select words contained in clip clip = pymupdf.Rect(clip) words = [ w for w in words if abs(clip & w[:4]) >= 0.5 * abs(pymupdf.Rect(w[:4])) ] if textpage is None: del tp if words and sort: # advanced sort if any words found words = sort_words(words) return words def get_sorted_text( page: pymupdf.Page, clip: rect_like = None, flags: OptInt = None, textpage: pymupdf.TextPage = None, tolerance=3, ) -> str: """Extract plain text avoiding unacceptable line breaks. Text contained in clip will be sorted in reading sequence. Some effort is also spent to simulate layout vertically and horizontally. Args: page: pymupdf.Page clip: (rect-like) only consider text inside flags: (int) text extraction flags textpage: pymupdf.TextPage tolerance: (float) consider words to be on the same line if their top or bottom coordinates do not differ more than this. Notes: If a TextPage is provided, all text is checked for being inside clip with at least 50% of its bbox. This allows to use some "global" TextPage in conjunction with sub- selecting words in parts of the defined TextPage rectangle. Returns: A text string in reading sequence. Left indentation of each line, inter-line and inter-word distances strive to reflect the layout. """ def line_text(clip, line): """Create the string of one text line. We are trying to simulate some horizontal layout here, too. Args: clip: (pymupdf.Rect) the area from which all text is being read. line: (list) word tuples (rect, text) contained in the line Returns: Text in this line. Generated from words in 'line'. Distance from predecessor is translated to multiple spaces, thus simulating text indentations and large horizontal distances. """ line.sort(key=lambda w: w[0].x0) ltext = "" # text in the line x1 = clip.x0 # end coordinate of ltext lrect = pymupdf.EMPTY_RECT() # bbox of this line for r, t in line: lrect |= r # update line bbox # convert distance to previous word to multiple spaces dist = max( int(round((r.x0 - x1) / r.width * len(t))), 0 if (x1 == clip.x0 or r.x0 <= x1) else 1, ) # number of space characters ltext += " " * dist + t # append word string x1 = r.x1 # update new end position return ltext # Extract words in correct sequence first. words = [ (pymupdf.Rect(w[:4]), w[4]) for w in get_text_words( page, clip=clip, flags=flags, textpage=textpage, sort=True, tolerance=tolerance, ) ] if not words: # no text present return "" totalbox = pymupdf.EMPTY_RECT() # area covering all text for wr, text in words: totalbox |= wr lines = [] # list of reconstituted lines line = [words[0]] # current line lrect = words[0][0] # the line's rectangle # walk through the words for wr, text in words[1:]: # start with second word w0r, _ = line[-1] # read previous word in current line # if this word matches top or bottom of the line, append it if abs(lrect.y0 - wr.y0) <= tolerance or abs(lrect.y1 - wr.y1) <= tolerance: line.append((wr, text)) lrect |= wr else: # output current line and re-initialize ltext = line_text(totalbox, line) lines.append((lrect, ltext)) line = [(wr, text)] lrect = wr # also append unfinished last line ltext = line_text(totalbox, line) lines.append((lrect, ltext)) # sort all lines vertically lines.sort(key=lambda l: (l[0].y1)) text = lines[0][1] # text of first line y1 = lines[0][0].y1 # its bottom coordinate for lrect, ltext in lines[1:]: distance = min(int(round((lrect.y0 - y1) / lrect.height)), 5) breaks = "\n" * (distance + 1) text += breaks + ltext y1 = lrect.y1 # return text in clip return text def get_textbox( page: pymupdf.Page, rect: rect_like, textpage: pymupdf.TextPage = None, ) -> str: tp = textpage if tp is None: tp = page.get_textpage() elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rc = tp.extractTextbox(rect) if textpage is None: del tp return rc def get_text_selection( page: pymupdf.Page, p1: point_like, p2: point_like, clip: rect_like = None, textpage: pymupdf.TextPage = None, ): pymupdf.CheckParent(page) tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=pymupdf.TEXT_DEHYPHENATE) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rc = tp.extractSelection(p1, p2) if textpage is None: del tp return rc def get_textpage_ocr( page: pymupdf.Page, flags: int = 0, language: str = "eng", dpi: int = 72, full: bool = False, tessdata: str = None, ) -> pymupdf.TextPage: """Create a Textpage from the OCR version of the page. OCR can be executed for the full page image, or (the default) only for areas that are not covered by readable digital text. Args: flags: (int) control content becoming part of the result. language: (str) specify expected language(s). Default is "eng" (English). dpi: (int) resolution in dpi, default 72. full: (bool) whether to OCR the full page, or to keep legible text tessdata: (str) path to Tesseract language data files. If None, the built-in function is used to find the path. """ pymupdf.CheckParent(page) tessdata = pymupdf.get_tessdata(tessdata) # Ensure 0xFFFD is not suppressed flags = ( flags & ~pymupdf.TEXT_USE_CID_FOR_UNKNOWN_UNICODE # pylint: disable=no-member & ~pymupdf.TEXT_USE_GID_FOR_UNKNOWN_UNICODE # pylint: disable=no-member ) def full_ocr(page, dpi, language, flags): """Perform OCR for the full page image.""" pix = page.get_pixmap(dpi=dpi) # create a 1-page PDF with an OCR text layer. ocr_pdf = pymupdf.Document( stream=pix.pdfocr_tobytes( compress=False, language=language, tessdata=tessdata, ), ) ocr_page = ocr_pdf.load_page(0) unzoom = page.rect.width / ocr_page.rect.width ctm = pymupdf.Matrix(unzoom, unzoom) * page.derotation_matrix tpage = ocr_page.get_textpage(flags=flags, matrix=ctm) # associate the textpage with the original page tpage.parent = weakref.proxy(page) return tpage def partial_ocr(page, dpi, language, flags): """Perform OCR for parts of the page without legible text. We create a temporary PDF for which we can freely redact text. """ doc = page.parent # make temporary PDF with the passed-in page temp_pdf = pymupdf.open() temp_pdf.insert_pdf(doc, from_page=page.number, to_page=page.number) temp_page = temp_pdf.load_page(0) temp_page.remove_rotation() # avoid OCR problems with rotated pages # extract text bboxes from the page tp = temp_page.get_textpage(flags=flags) blocks = tp.extractDICT()["blocks"] """ For partial OCR we need a TextPage that contains legible text only. Illegible text must be passed to the OCR engine. """ # Select spans with illegible text. If present, remove them first. fffd_spans = [ s["bbox"] for b in blocks if b["type"] == 0 for l in b["lines"] for s in l["spans"] if chr(0xFFFD) in s["text"] ] if fffd_spans: for bbox in fffd_spans: temp_page.add_redact_annot(bbox) temp_page.apply_redactions( images=pymupdf.PDF_REDACT_IMAGE_NONE, # pylint: disable=no-member graphics=pymupdf.PDF_REDACT_LINE_ART_NONE, # pylint: disable=no-member text=pymupdf.PDF_REDACT_TEXT_REMOVE, # pylint: disable=no-member ) # Extract text again, now without the unreadable spans. tp = temp_page.get_textpage(flags=flags) blocks = tp.extractDICT()["blocks"] # We also need a fresh copy of the original page. temp_pdf.insert_pdf(doc, from_page=page.number, to_page=page.number) temp_page = temp_pdf.load_page(-1) temp_page.remove_rotation() # avoid OCR problems with rotated pages span_bboxes = [ s["bbox"] for b in blocks if b["type"] == 0 for l in b["lines"] for s in l["spans"] if not chr(0xFFFD) in s["text"] ] # Remove digital text by redacting the span bboxes. # Then OCR the remainder of the page. for bbox in span_bboxes: temp_page.add_redact_annot(bbox) # only remove text, no images, no vectors temp_page.apply_redactions( images=pymupdf.PDF_REDACT_IMAGE_NONE, # pylint: disable=no-member graphics=pymupdf.PDF_REDACT_LINE_ART_NONE, # pylint: disable=no-member text=pymupdf.PDF_REDACT_TEXT_REMOVE, # pylint: disable=no-member ) pix = temp_page.get_pixmap(dpi=dpi) # matrix = pymupdf.Rect(pix.irect).torect(page.rect) # OCR the redacted page ocr_pdf = pymupdf.open( stream=pix.pdfocr_tobytes( compress=False, language=language, tessdata=tessdata, ), ) ocr_page = ocr_pdf[0] # Extend the original textpage with OCR-ed text. ocr_page.extend_textpage(tp, flags=pymupdf.TEXT_ACCURATE_BBOXES) # associate the textpage with the original page tp.parent = weakref.proxy(page) return tp # if OCR for the full page, OCR its pixmap @ desired dpi if full: return full_ocr(page, dpi, language, flags) # For partial OCR, make a normal textpage, then extend it with text that # is OCRed from the rest of page. return partial_ocr(page, dpi, language, flags) def get_text( page: pymupdf.Page, option: str = "text", *, clip: rect_like = None, flags: OptInt = None, textpage: pymupdf.TextPage = None, sort: bool = False, delimiters=None, tolerance=3, ): """Extract text from a page or an annotation. This is a unifying wrapper for various methods of the pymupdf.TextPage class. Args: option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. clip: (rect-like) restrict output to this area. flags: bit switches to e.g. exclude images or decompose ligatures. textpage: reuse this pymupdf.TextPage and make no new one. If specified, 'flags' and 'clip' are ignored. Returns: the output of methods get_text_words / get_text_blocks or pymupdf.TextPage methods extractText, extractHTML, extractDICT, extractJSON, extractRAWDICT, extractXHTML or etractXML respectively. Default and misspelling choice is "text". """ formats = { "text": pymupdf.TEXTFLAGS_TEXT, "html": pymupdf.TEXTFLAGS_HTML, "json": pymupdf.TEXTFLAGS_DICT, "rawjson": pymupdf.TEXTFLAGS_RAWDICT, "xml": pymupdf.TEXTFLAGS_XML, "xhtml": pymupdf.TEXTFLAGS_XHTML, "dict": pymupdf.TEXTFLAGS_DICT, "rawdict": pymupdf.TEXTFLAGS_RAWDICT, "words": pymupdf.TEXTFLAGS_WORDS, "blocks": pymupdf.TEXTFLAGS_BLOCKS, } option = option.lower() assert option in formats if option not in formats: option = "text" if flags is None: flags = formats[option] if option == "words": return get_text_words( page, clip=clip, flags=flags, textpage=textpage, sort=sort, delimiters=delimiters, ) if option == "blocks": return get_text_blocks( page, clip=clip, flags=flags, textpage=textpage, sort=sort ) if option == "text" and sort: return get_sorted_text( page, clip=clip, flags=flags, textpage=textpage, tolerance=tolerance, ) pymupdf.CheckParent(page) cb = None if option in ("html", "xml", "xhtml"): # no clipping for MuPDF functions clip = page.cropbox if clip is not None: clip = pymupdf.Rect(clip) cb = None elif type(page) is pymupdf.Page: cb = page.cropbox # pymupdf.TextPage with or without images tp = textpage #pymupdf.exception_info() if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") #pymupdf.log( '{option=}') if option == "json": t = tp.extractJSON(cb=cb, sort=sort) elif option == "rawjson": t = tp.extractRAWJSON(cb=cb, sort=sort) elif option == "dict": t = tp.extractDICT(cb=cb, sort=sort) elif option == "rawdict": t = tp.extractRAWDICT(cb=cb, sort=sort) elif option == "html": t = tp.extractHTML() elif option == "xml": t = tp.extractXML() elif option == "xhtml": t = tp.extractXHTML() else: t = tp.extractText(sort=sort) if textpage is None: del tp return t def getLinkDict(ln, document=None) -> dict: if isinstance(ln, pymupdf.Outline): dest = ln.destination(document) elif isinstance(ln, pymupdf.Link): dest = ln.dest else: assert 0, f'Unexpected {type(ln)=}.' nl = {"kind": dest.kind, "xref": 0} try: if hasattr(ln, 'rect'): nl["from"] = ln.rect except Exception: # This seems to happen quite often in PyMuPDF/tests. if g_exceptions_verbose >= 2: pymupdf.exception_info() pass pnt = pymupdf.Point(0, 0) if dest.flags & pymupdf.LINK_FLAG_L_VALID: pnt.x = dest.lt.x if dest.flags & pymupdf.LINK_FLAG_T_VALID: pnt.y = dest.lt.y if dest.kind == pymupdf.LINK_URI: nl["uri"] = dest.uri elif dest.kind == pymupdf.LINK_GOTO: nl["page"] = dest.page nl["to"] = pnt if dest.flags & pymupdf.LINK_FLAG_R_IS_ZOOM: nl["zoom"] = dest.rb.x else: nl["zoom"] = 0.0 elif dest.kind == pymupdf.LINK_GOTOR: nl["file"] = dest.file_spec.replace("\\", "/") nl["page"] = dest.page if dest.page < 0: nl["to"] = dest.dest else: nl["to"] = pnt if dest.flags & pymupdf.LINK_FLAG_R_IS_ZOOM: nl["zoom"] = dest.rb.x else: nl["zoom"] = 0.0 elif dest.kind == pymupdf.LINK_LAUNCH: nl["file"] = dest.file_spec.replace("\\", "/") elif dest.kind == pymupdf.LINK_NAMED: # The dicts should not have same key(s). assert not (dest.named.keys() & nl.keys()) nl.update(dest.named) if 'to' in nl: nl['to'] = pymupdf.Point(nl['to']) else: nl["page"] = dest.page return nl def getDestStr(xref: int, ddict: dict) -> str: """Calculate the PDF action string. Notes: Supports Link annotations and outline items (bookmarks). """ if not ddict: return "" str_goto = lambda a, b, c, d: f"/A<>" str_gotor1 = lambda a, b, c, d, e, f: f"/A<>>>" str_gotor2 = lambda a, b, c: f"/A<>>>" str_launch = lambda a, b: f"/A<>>>" str_uri = lambda a: f"/A<>" if type(ddict) in (int, float): dest = str_goto(xref, 0, ddict, 0) return dest d_kind = ddict.get("kind", pymupdf.LINK_NONE) if d_kind == pymupdf.LINK_NONE: return "" if ddict["kind"] == pymupdf.LINK_GOTO: d_zoom = ddict.get("zoom", 0) to = ddict.get("to", pymupdf.Point(0, 0)) d_left, d_top = to dest = str_goto(xref, d_left, d_top, d_zoom) return dest if ddict["kind"] == pymupdf.LINK_URI: dest = str_uri(pymupdf.get_pdf_str(ddict["uri"]),) return dest if ddict["kind"] == pymupdf.LINK_LAUNCH: fspec = pymupdf.get_pdf_str(ddict["file"]) dest = str_launch(fspec, fspec) return dest if ddict["kind"] == pymupdf.LINK_GOTOR and ddict["page"] < 0: fspec = pymupdf.get_pdf_str(ddict["file"]) dest = str_gotor2(pymupdf.get_pdf_str(ddict["to"]), fspec, fspec) return dest if ddict["kind"] == pymupdf.LINK_GOTOR and ddict["page"] >= 0: fspec = pymupdf.get_pdf_str(ddict["file"]) dest = str_gotor1( ddict["page"], ddict["to"].x, ddict["to"].y, ddict["zoom"], fspec, fspec, ) return dest return "" def getLinkText(page: pymupdf.Page, lnk: dict) -> str: # -------------------------------------------------------------------------- # define skeletons for /Annots object texts # -------------------------------------------------------------------------- ctm = page.transformation_matrix ictm = ~ctm r = lnk["from"] rect = _format_g(tuple(r * ictm)) annot = "" if lnk["kind"] == pymupdf.LINK_GOTO: if lnk["page"] >= 0: txt = pymupdf.annot_skel["goto1"] # annot_goto pno = lnk["page"] xref = page.parent.page_xref(pno) pnt = lnk.get("to", pymupdf.Point(0, 0)) # destination point dest_page = page.parent[pno] dest_ctm = dest_page.transformation_matrix dest_ictm = ~dest_ctm ipnt = pnt * dest_ictm annot = txt(xref, ipnt.x, ipnt.y, lnk.get("zoom", 0), rect) else: txt = pymupdf.annot_skel["goto2"] # annot_goto_n annot = txt(pymupdf.get_pdf_str(lnk["to"]), rect) elif lnk["kind"] == pymupdf.LINK_GOTOR: if lnk["page"] >= 0: txt = pymupdf.annot_skel["gotor1"] # annot_gotor pnt = lnk.get("to", pymupdf.Point(0, 0)) # destination point if type(pnt) is not pymupdf.Point: pnt = pymupdf.Point(0, 0) annot = txt( lnk["page"], pnt.x, pnt.y, lnk.get("zoom", 0), lnk["file"], lnk["file"], rect, ) else: txt = pymupdf.annot_skel["gotor2"] # annot_gotor_n annot = txt(pymupdf.get_pdf_str(lnk["to"]), lnk["file"], rect) elif lnk["kind"] == pymupdf.LINK_LAUNCH: txt = pymupdf.annot_skel["launch"] # annot_launch annot = txt(lnk["file"], lnk["file"], rect) elif lnk["kind"] == pymupdf.LINK_URI: txt = pymupdf.annot_skel["uri"] # txt = annot_uri annot = txt(lnk["uri"], rect) elif lnk["kind"] == pymupdf.LINK_NAMED: txt = pymupdf.annot_skel["named"] # annot_named lname = lnk.get("name") # check presence of key if lname is None: # if missing, fall back to alternative lname = lnk["nameddest"] annot = txt(lname, rect) if not annot: return annot # add a /NM PDF key to the object definition link_names = dict( # existing ids and their xref [(x[0], x[2]) for x in page.annot_xrefs() if x[1] == pymupdf.PDF_ANNOT_LINK] # pylint: disable=no-member ) old_name = lnk.get("id", "") # id value in the argument if old_name and (lnk["xref"], old_name) in link_names.items(): name = old_name # no new name if this is an update only else: i = 0 stem = pymupdf.TOOLS.set_annot_stem() + "-L%i" while True: name = stem % i if name not in link_names.values(): break i += 1 # add /NM key to object definition annot = annot.replace(f"/Link", f"/Link/NM({name})") return annot # ---------------------------------------------------------------------- # Name: wx.lib.colourdb.py # Purpose: Adds a bunch of colour names and RGB values to the # colour database so they can be found by name # # Author: Robin Dunn # # Created: 13-March-2001 # Copyright: (c) 2001-2017 by Total Control Software # Licence: wxWindows license # Tags: phoenix-port, unittest, documented # ---------------------------------------------------------------------- def getColorList() -> list: """ Returns a list of upper-case colour names. :rtype: list of strings """ return [name for name, r, g, b in pymupdf.colors_wx_list()] def getColorInfoList() -> list: """ Returns list of (name, red, gree, blue) tuples, where: name: upper-case color name. read, green, blue: integers in range 0..255. :rtype: list of tuples """ return pymupdf.colors_wx_list() def getColor(name: str) -> tuple: """Retrieve RGB color in PDF format by name. Returns: a triple of floats in range 0 to 1. In case of name-not-found, "white" is returned. """ return pymupdf.colors_pdf_dict().get(name.lower(), (1, 1, 1)) def getColorHSV(name: str) -> tuple: """Retrieve the hue, saturation, value triple of a color name. Returns: a triple (degree, percent, percent). If not found (-1, -1, -1) is returned. """ try: x = getColorInfoList()[getColorList().index(name.upper())] except Exception: if g_exceptions_verbose: pymupdf.exception_info() return (-1, -1, -1) r = x[1] / 255.0 g = x[2] / 255.0 b = x[3] / 255.0 cmax = max(r, g, b) V = round(cmax * 100, 1) cmin = min(r, g, b) delta = cmax - cmin if delta == 0: hue = 0 elif cmax == r: hue = 60.0 * (((g - b) / delta) % 6) elif cmax == g: hue = 60.0 * (((b - r) / delta) + 2) else: hue = 60.0 * (((r - g) / delta) + 4) H = int(round(hue)) if cmax == 0: sat = 0 else: sat = delta / cmax S = int(round(sat * 100)) return (H, S, V) def _get_font_properties(doc: pymupdf.Document, xref: int) -> tuple: fontname, ext, stype, buffer = doc.extract_font(xref) asc = 0.8 dsc = -0.2 if ext == "": return fontname, ext, stype, asc, dsc if buffer: try: font = pymupdf.Font(fontbuffer=buffer) asc = font.ascender dsc = font.descender bbox = font.bbox if asc - dsc < 1: if bbox.y0 < dsc: dsc = bbox.y0 asc = 1 - dsc except Exception: pymupdf.exception_info() asc *= 1.2 dsc *= 1.2 return fontname, ext, stype, asc, dsc if ext != "n/a": try: font = pymupdf.Font(fontname) asc = font.ascender dsc = font.descender except Exception: pymupdf.exception_info() asc *= 1.2 dsc *= 1.2 else: asc *= 1.2 dsc *= 1.2 return fontname, ext, stype, asc, dsc def _show_fz_text( text): #if mupdf_cppyy: # assert isinstance( text, cppyy.gbl.mupdf.Text) #else: # assert isinstance( text, mupdf.Text) num_spans = 0 num_chars = 0 span = text.m_internal.head while 1: if not span: break num_spans += 1 num_chars += span.len span = span.next return f'num_spans={num_spans} num_chars={num_chars}' """ Handle page labels for PDF documents. Reading ------- * compute the label of a page * find page number(s) having the given label. Writing ------- Supports setting (defining) page labels for PDF documents. A big Thank You goes to WILLIAM CHAPMAN who contributed the idea and significant parts of the following code during late December 2020 through early January 2021. """ def rule_dict(item): """Make a Python dict from a PDF page label rule. Args: item -- a tuple (pno, rule) with the start page number and the rule string like <>. Returns: A dict like {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. """ # Jorj McKie, 2021-01-06 pno, rule = item rule = rule[2:-2].split("/")[1:] # strip "<<" and ">>" d = {"startpage": pno, "prefix": "", "firstpagenum": 1} skip = False for i, item in enumerate(rule): # pylint: disable=redefined-argument-from-local if skip: # this item has already been processed skip = False # deactivate skipping again continue if item == "S": # style specification d["style"] = rule[i + 1] # next item has the style skip = True # do not process next item again continue if item.startswith("P"): # prefix specification: extract the string x = item[1:].replace("(", "").replace(")", "") d["prefix"] = x continue if item.startswith("St"): # start page number specification x = int(item[2:]) d["firstpagenum"] = x return d def get_label_pno(pgNo, labels): """Return the label for this page number. Args: pgNo: page number, 0-based. labels: result of doc._get_page_labels(). Returns: The label (str) of the page number. Errors return an empty string. """ # Jorj McKie, 2021-01-06 item = [x for x in labels if x[0] <= pgNo][-1] rule = rule_dict(item) prefix = rule.get("prefix", "") style = rule.get("style", "") # make sure we start at 0 when enumerating the alphabet delta = -1 if style in ("a", "A") else 0 pagenumber = pgNo - rule["startpage"] + rule["firstpagenum"] + delta return construct_label(style, prefix, pagenumber) def construct_label(style, prefix, pno) -> str: """Construct a label based on style, prefix and page number.""" # William Chapman, 2021-01-06 n_str = "" if style == "D": n_str = str(pno) elif style == "r": n_str = integerToRoman(pno).lower() elif style == "R": n_str = integerToRoman(pno).upper() elif style == "a": n_str = integerToLetter(pno).lower() elif style == "A": n_str = integerToLetter(pno).upper() result = prefix + n_str return result def integerToLetter(i) -> str: """Returns letter sequence string for integer i.""" # William Chapman, Jorj McKie, 2021-01-06 import string ls = string.ascii_uppercase n, a = 1, i while pow(26, n) <= a: a -= int(math.pow(26, n)) n += 1 str_t = "" for j in reversed(range(n)): f, g = divmod(a, int(math.pow(26, j))) str_t += ls[f] a = g return str_t def integerToRoman(num: int) -> str: """Return roman numeral for an integer.""" # William Chapman, Jorj McKie, 2021-01-06 roman = ( (1000, "M"), (900, "CM"), (500, "D"), (400, "CD"), (100, "C"), (90, "XC"), (50, "L"), (40, "XL"), (10, "X"), (9, "IX"), (5, "V"), (4, "IV"), (1, "I"), ) def roman_num(num): for r, ltr in roman: x, _ = divmod(num, r) yield ltr * x num -= r * x if num <= 0: break return "".join([a for a in roman_num(num)]) # ------------------------------------------------------------------- # Functions to recover the quad contained in a text extraction bbox # ------------------------------------------------------------------- def recover_bbox_quad(line_dir: tuple, span: dict, bbox: tuple) -> pymupdf.Quad: """Compute the quad located inside the bbox. The bbox may be any of the resp. tuples occurring inside the given span. Args: line_dir: (tuple) 'line["dir"]' of the owning line or None. span: (dict) the span. May be from get_texttrace() method. bbox: (tuple) the bbox of the span or any of its characters. Returns: The quad which is wrapped by the bbox. """ if line_dir is None: line_dir = span["dir"] cos, sin = line_dir bbox = pymupdf.Rect(bbox) # make it a rect if pymupdf.TOOLS.set_small_glyph_heights(): # ==> just fontsize as height d = 1 else: d = span["ascender"] - span["descender"] height = d * span["size"] # the quad's rectangle height # The following are distances from the bbox corners, at which we find the # respective quad points. The computation depends on in which quadrant the # text writing angle is located. hs = height * sin hc = height * cos if hc >= 0 and hs <= 0: # quadrant 1 ul = bbox.bl - (0, hc) ur = bbox.tr + (hs, 0) ll = bbox.bl - (hs, 0) lr = bbox.tr + (0, hc) elif hc <= 0 and hs <= 0: # quadrant 2 ul = bbox.br + (hs, 0) ur = bbox.tl - (0, hc) ll = bbox.br + (0, hc) lr = bbox.tl - (hs, 0) elif hc <= 0 and hs >= 0: # quadrant 3 ul = bbox.tr - (0, hc) ur = bbox.bl + (hs, 0) ll = bbox.tr - (hs, 0) lr = bbox.bl + (0, hc) else: # quadrant 4 ul = bbox.tl + (hs, 0) ur = bbox.br - (0, hc) ll = bbox.tl + (0, hc) lr = bbox.br - (hs, 0) return pymupdf.Quad(ul, ur, ll, lr) def recover_quad(line_dir: tuple, span: dict) -> pymupdf.Quad: """Recover the quadrilateral of a text span. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: the span. Returns: The quadrilateral enveloping the span's text. """ if type(line_dir) is not tuple or len(line_dir) != 2: raise ValueError("bad line dir argument") if type(span) is not dict: raise ValueError("bad span argument") return recover_bbox_quad(line_dir, span, span["bbox"]) def recover_line_quad(line: dict, spans: list = None) -> pymupdf.Quad: """Calculate the line quad for 'dict' / 'rawdict' text extractions. The lower quad points are those of the first, resp. last span quad. The upper points are determined by the maximum span quad height. From this, compute a rect with bottom-left in (0, 0), convert this to a quad and rotate and shift back to cover the text of the spans. Args: spans: (list, optional) sub-list of spans to consider. Returns: pymupdf.Quad covering selected spans. """ if spans is None: # no sub-selection spans = line["spans"] # all spans if len(spans) == 0: raise ValueError("bad span list") line_dir = line["dir"] # text direction cos, sin = line_dir q0 = recover_quad(line_dir, spans[0]) # quad of first span if len(spans) > 1: # get quad of last span q1 = recover_quad(line_dir, spans[-1]) else: q1 = q0 # last = first line_ll = q0.ll # lower-left of line quad line_lr = q1.lr # lower-right of line quad mat0 = pymupdf.planish_line(line_ll, line_lr) # map base line to x-axis such that line_ll goes to (0, 0) x_lr = line_lr * mat0 small = pymupdf.TOOLS.set_small_glyph_heights() # small glyph heights? h = max( [s["size"] * (1 if small else (s["ascender"] - s["descender"])) for s in spans] ) line_rect = pymupdf.Rect(0, -h, x_lr.x, 0) # line rectangle line_quad = line_rect.quad # make it a quad and: line_quad *= ~mat0 return line_quad def recover_span_quad(line_dir: tuple, span: dict, chars: list = None) -> pymupdf.Quad: """Calculate the span quad for 'dict' / 'rawdict' text extractions. Notes: There are two execution paths: 1. For the full span quad, the result of 'recover_quad' is returned. 2. For the quad of a sub-list of characters, the char quads are computed and joined. This is only supported for the "rawdict" extraction option. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: (dict) the span. chars: (list, optional) sub-list of characters to consider. Returns: pymupdf.Quad covering selected characters. """ if line_dir is None: # must be a span from get_texttrace() line_dir = span["dir"] if chars is None: # no sub-selection return recover_quad(line_dir, span) if "chars" not in span.keys(): raise ValueError("need 'rawdict' option to sub-select chars") q0 = recover_char_quad(line_dir, span, chars[0]) # quad of first char if len(chars) > 1: # get quad of last char q1 = recover_char_quad(line_dir, span, chars[-1]) else: q1 = q0 # last = first span_ll = q0.ll # lower-left of span quad span_lr = q1.lr # lower-right of span quad mat0 = pymupdf.planish_line(span_ll, span_lr) # map base line to x-axis such that span_ll goes to (0, 0) x_lr = span_lr * mat0 small = pymupdf.TOOLS.set_small_glyph_heights() # small glyph heights? h = span["size"] * (1 if small else (span["ascender"] - span["descender"])) span_rect = pymupdf.Rect(0, -h, x_lr.x, 0) # line rectangle span_quad = span_rect.quad # make it a quad and: span_quad *= ~mat0 # rotate back and shift back return span_quad def recover_char_quad(line_dir: tuple, span: dict, char: dict) -> pymupdf.Quad: """Recover the quadrilateral of a text character. This requires the "rawdict" option of text extraction. Args: line_dir: (tuple) 'line["dir"]' of the span's line. span: (dict) the span dict. char: (dict) the character dict. Returns: The quadrilateral enveloping the character. """ if line_dir is None: line_dir = span["dir"] if type(line_dir) is not tuple or len(line_dir) != 2: raise ValueError("bad line dir argument") if type(span) is not dict: raise ValueError("bad span argument") if type(char) is dict: bbox = pymupdf.Rect(char["bbox"]) elif type(char) is tuple: bbox = pymupdf.Rect(char[3]) else: raise ValueError("bad span argument") return recover_bbox_quad(line_dir, span, bbox) ================================================ FILE: src/wdev.py ================================================ ''' Finds locations of Windows command-line development tools. ''' import os import platform import glob import re import subprocess import sys import sysconfig import textwrap import pipcl class WindowsVS: r''' Windows only. Finds locations of Visual Studio command-line tools. Assumes VS2019-style paths. Members and example values:: .year: 2019 .grade: Community .version: 14.28.29910 .directory: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community .vcvars: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat .cl: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.28.29910\bin\Hostx64\x64\cl.exe .link: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.28.29910\bin\Hostx64\x64\link.exe .csc: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\Roslyn\csc.exe .msbuild: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\MSBuild.exe .devenv: C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\devenv.com `.csc` is C# compiler; will be None if not found. ''' def __init__( self, *, year=None, grade=None, version=None, cpu=None, directory=None, verbose=False, ): ''' Args: year: None or, for example, `2019`. If None we use environment variable WDEV_VS_YEAR if set. grade: None or, for example, one of: * `Community` * `Professional` * `Enterprise` If None we use environment variable WDEV_VS_GRADE if set. version: None or, for example: `14.28.29910`. If None we use environment variable WDEV_VS_VERSION if set. cpu: None or a `WindowsCpu` instance. directory: Ignore year, grade, version and cpu and use this directory directly. verbose: . ''' if year is not None: year = str(year) # Allow specification as a number. def default(value, name): if value is None: name2 = f'WDEV_VS_{name.upper()}' value = os.environ.get(name2) if value is not None: _log(f'Setting {name} from environment variable {name2}: {value!r}') return value try: year = default(year, 'year') grade = default(grade, 'grade') version = default(version, 'version') if not cpu: cpu = WindowsCpu() if not directory: # Find `directory`. # pattern = _vs_pattern(year, grade) directories = glob.glob( pattern) if verbose: _log( f'Matches for: {pattern=}') _log( f'{directories=}') assert directories, f'No match found for {pattern=}.' directories.sort() directory = directories[-1] # Find `devenv`. # devenv = f'{directory}\\Common7\\IDE\\devenv.com' assert os.path.isfile( devenv), f'Does not exist: {devenv}' # Extract `year` and `grade` from `directory`. # # We use r'...' for regex strings because an extra level of escaping is # required for backslashes. # regex = rf'^C:\\Program Files.*\\Microsoft Visual Studio\\([^\\]+)\\([^\\]+)' m = re.match( regex, directory) assert m, f'No match: {regex=} {directory=}' year2 = m.group(1) grade2 = m.group(2) if year: assert year2 == year else: year = year2 if grade: assert grade2 == grade else: grade = grade2 # Find vcvars.bat. # vcvars = f'{directory}\\VC\\Auxiliary\\Build\\vcvars{cpu.bits}.bat' assert os.path.isfile( vcvars), f'No match for: {vcvars}' # Find cl.exe. # cl_pattern = f'{directory}\\VC\\Tools\\MSVC\\{version if version else "*"}\\bin\\Host{cpu.windows_name}\\{cpu.windows_name}\\cl.exe' cl_s = glob.glob( cl_pattern) assert cl_s, f'No match for: {cl_pattern}' cl_s.sort() cl = cl_s[ -1] # Extract `version` from cl.exe's path. # m = re.search( rf'\\VC\\Tools\\MSVC\\([^\\]+)\\bin\\Host{cpu.windows_name}\\{cpu.windows_name}\\cl.exe$', cl) assert m version2 = m.group(1) if version: assert version2 == version else: version = version2 assert version # Find link.exe. # link_pattern = f'{directory}\\VC\\Tools\\MSVC\\{version}\\bin\\Host{cpu.windows_name}\\{cpu.windows_name}\\link.exe' link_s = glob.glob( link_pattern) assert link_s, f'No match for: {link_pattern}' link_s.sort() link = link_s[ -1] # Find csc.exe. # csc = None for dirpath, dirnames, filenames in os.walk(directory): for filename in filenames: if filename == 'csc.exe': csc = os.path.join(dirpath, filename) #_log(f'{csc=}') #break # Find MSBuild.exe. # msbuild = None for dirpath, dirnames, filenames in os.walk(directory): for filename in filenames: if filename == 'MSBuild.exe': msbuild = os.path.join(dirpath, filename) #_log(f'{csc=}') #break self.cl = cl self.devenv = devenv self.directory = directory self.grade = grade self.link = link self.csc = csc self.msbuild = msbuild self.vcvars = vcvars self.version = version self.year = year self.cpu = cpu except Exception as e: raise Exception( f'Unable to find Visual Studio {year=} {grade=} {version=} {cpu=} {directory=}') from e def description_ml( self, indent=''): ''' Return multiline description of `self`. ''' ret = textwrap.dedent(f''' year: {self.year} grade: {self.grade} version: {self.version} directory: {self.directory} vcvars: {self.vcvars} cl: {self.cl} link: {self.link} csc: {self.csc} msbuild: {self.msbuild} devenv: {self.devenv} cpu: {self.cpu} ''') return textwrap.indent( ret, indent) def __repr__( self): items = list() for name in ( 'year', 'grade', 'version', 'directory', 'vcvars', 'cl', 'link', 'csc', 'msbuild', 'devenv', 'cpu', ): items.append(f'{name}={getattr(self, name)!r}') return ' '.join(items) def _vs_pattern(year=None, grade=None): return f'C:\\Program Files*\\Microsoft Visual Studio\\{year if year else "2*"}\\{grade if grade else "*"}' def windows_vs_multiple(year=None, grade=None, verbose=0): ''' Returns list of WindowsVS instances. ''' ret = list() directories = glob.glob(_vs_pattern(year, grade)) for directory in directories: vs = WindowsVS(directory=directory) if verbose: _log(vs.description_ml()) ret.append(vs) return ret class WindowsCpu: ''' For Windows only. Paths and names that depend on cpu. Members: .bits 32 or 64. .windows_subdir Empty string or `x64/`. .windows_name `x86` or `x64`. .windows_config `x64` or `Win32`, e.g. for use in `/Build Release|x64`. .windows_suffix `64` or empty string. ''' def __init__(self, name=None): if not name: name = _cpu_name() self.name = name if name == 'x32': self.bits = 32 self.windows_subdir = '' self.windows_name = 'x86' self.windows_config = 'Win32' self.windows_suffix = '' elif name == 'x64': self.bits = 64 self.windows_subdir = 'x64/' self.windows_name = 'x64' self.windows_config = 'x64' self.windows_suffix = '64' else: assert 0, f'Unrecognised cpu name: {name}' def __repr__(self): return self.name class WindowsPython: ''' Windows only. Information about installed Python with specific word size and version. Defaults to the currently-running Python. Members: .path: Path of python binary. .version: `{major}.{minor}`, e.g. `3.9` or `3.11`. Same as `version` passed to `__init__()` if not None, otherwise the inferred version. .include: Python include path. .cpu: A `WindowsCpu` instance, same as `cpu` passed to `__init__()` if not None, otherwise the inferred cpu. We parse the output from `py -0p` to find all available python installations. ''' def __init__( self, cpu=None, version=None, verbose=True): ''' Args: cpu: A WindowsCpu instance. If None, we use whatever we are running on. version: Two-digit Python version as a string such as `3.8`. If None we use current Python's version. verbose: If true we show diagnostics. ''' if cpu is None: cpu = WindowsCpu(_cpu_name()) if version is None: version = '.'.join(platform.python_version().split('.')[:2]) _log(f'Looking for Python {version=} {cpu.bits=}.') if '.'.join(platform.python_version().split('.')[:2]) == version: # Current python matches, so use it directly. This avoids problems # on Github where experimental python-3.13 was not available via # `py`, and is kept here in case a similar problems happens with # future Python versions. _log(f'{cpu=} {version=}: using {sys.executable=}.') self.path = sys.executable self.version = version self.cpu = cpu self.include = sysconfig.get_path('include') else: command = 'py -0p' if verbose: _log(f'{cpu=} {version=}: Running: {command}') text = subprocess.check_output( command, shell=True, text=True) for line in text.split('\n'): #_log( f' {line}') if m := re.match( '^ *-V:([0-9.]+)(-32)? ([*])? +(.+)$', line): version2 = m.group(1) bits = 32 if m.group(2) else 64 current = m.group(3) path = m.group(4).strip() elif m := re.match( '^ *-([0-9.]+)-((32)|(64)) +(.+)$', line): version2 = m.group(1) bits = int(m.group(2)) path = m.group(5).strip() else: if verbose: _log( f'No match for {line=}') continue if verbose: _log( f'{version2=} {bits=} {path=} from {line=}.') if bits != cpu.bits or version2 != version: continue root = os.path.dirname(path) if not os.path.exists(path): # Sometimes it seems that the specified .../python.exe does not exist, # and we have to change it to .../python.exe. # assert path.endswith('.exe'), f'path={path!r}' path2 = f'{path[:-4]}{version}.exe' _log( f'Python {path!r} does not exist; changed to: {path2!r}') assert os.path.exists( path2) path = path2 self.path = path self.version = version self.cpu = cpu command = f'{self.path} -c "import sysconfig; print(sysconfig.get_path(\'include\'))"' _log(f'Finding Python include path by running {command=}.') self.include = subprocess.check_output(command, shell=True, text=True).strip() _log(f'Python include path is {self.include=}.') #_log( f'pipcl.py:WindowsPython():\n{self.description_ml(" ")}') break else: _log(f'Failed to find python matching cpu={cpu}.') _log(f'Output from {command!r} was:\n{text}') raise Exception( f'Failed to find python matching cpu={cpu} {version=}.') # Oddly there doesn't seem to be a # `sysconfig.get_path('libs')`, but it seems to be next # to `includes`: self.libs = os.path.abspath(f'{self.include}/../libs') _log( f'WindowsPython:\n{self.description_ml(" ")}') def description_ml(self, indent=''): ret = textwrap.dedent(f''' path: {self.path} version: {self.version} cpu: {self.cpu} include: {self.include} libs: {self.libs} ''') return textwrap.indent( ret, indent) def __repr__(self): return f'path={self.path!r} version={self.version!r} cpu={self.cpu!r} include={self.include!r} libs={self.libs!r}' # Internal helpers. # def _cpu_name(): ''' Returns `x32` or `x64` depending on Python build. ''' #log(f'sys.maxsize={hex(sys.maxsize)}') return f'x{32 if sys.maxsize == 2**31 - 1 else 64}' def _log(text='', caller=1): ''' Logs lines with prefix. ''' pipcl.log1(text, caller+1) ================================================ FILE: src_classic/__init__.py ================================================ # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ import sys import glob import os if os.path.exists( 'fitz/__init__.py'): if not glob.glob( 'fitz/_fitz*'): print( '#' * 40) print( '# Warning: current directory appears to contain an incomplete') print( '# fitz/ installation directory so "import fitz" may fail.') print( '# This can happen if current directory is a PyMuPDF source tree.') print( '# Suggest changing to a different current directory.') print( '#' * 40) def message(text=''): print(text) from fitz_old.fitz_old import * # Allow this to work: # import fitz_old as fitz # fitz.fitz.TEXT_ALIGN_CENTER # fitz = fitz_old # define the supported colorspaces for convenience fitz_old.csRGB = fitz_old.Colorspace(fitz_old.CS_RGB) fitz_old.csGRAY = fitz_old.Colorspace(fitz_old.CS_GRAY) fitz_old.csCMYK = fitz_old.Colorspace(fitz_old.CS_CMYK) csRGB = fitz_old.csRGB csGRAY = fitz_old.csGRAY csCMYK = fitz_old.csCMYK # create the TOOLS object. # # Unfortunately it seems that this is never be destructed even if we use an # atexit() handler, which makes MuPDF's Memento list it as a leak. In fitz_old.i # we use Memento_startLeaking()/Memento_stopLeaking() when allocating # the Tools instance so at least the leak is marked as known. # TOOLS = fitz_old.Tools() TOOLS.thisown = True fitz_old.TOOLS = TOOLS # This atexit handler runs, but doesn't cause ~Tools() to be run. # import atexit def cleanup_tools(TOOLS): # print(f'cleanup_tools: TOOLS={TOOLS} id(TOOLS)={id(TOOLS)}') # print(f'TOOLS.thisown={TOOLS.thisown}') del TOOLS del fitz_old.TOOLS atexit.register(cleanup_tools, TOOLS) # Require that MuPDF matches fitz_old.TOOLS.mupdf_version(); also allow use with # next minor version (e.g. 1.21.2 => 1.22), so we can test with mupdf master. # def v_str_to_tuple(s): return tuple(map(int, s.split('.'))) def v_tuple_to_string(t): return '.'.join(map(str, t)) mupdf_version_tuple = v_str_to_tuple(fitz_old.TOOLS.mupdf_version()) mupdf_version_tuple_required = v_str_to_tuple(fitz_old.VersionFitz) mupdf_version_tuple_required_prev = (mupdf_version_tuple_required[0], mupdf_version_tuple_required[1]-1) mupdf_version_tuple_required_next = (mupdf_version_tuple_required[0], mupdf_version_tuple_required[1]+1) # copy functions in 'utils' to their respective fitz classes import fitz_old.utils from .table import find_tables # ------------------------------------------------------------------------------ # General # ------------------------------------------------------------------------------ fitz_old.recover_quad = fitz_old.utils.recover_quad fitz_old.recover_bbox_quad = fitz_old.utils.recover_bbox_quad fitz_old.recover_line_quad = fitz_old.utils.recover_line_quad fitz_old.recover_span_quad = fitz_old.utils.recover_span_quad fitz_old.recover_char_quad = fitz_old.utils.recover_char_quad # ------------------------------------------------------------------------------ # Document # ------------------------------------------------------------------------------ fitz_old.open = fitz_old.Document fitz_old.Document._do_links = fitz_old.utils.do_links fitz_old.Document.del_toc_item = fitz_old.utils.del_toc_item fitz_old.Document.get_char_widths = fitz_old.utils.get_char_widths fitz_old.Document.get_ocmd = fitz_old.utils.get_ocmd fitz_old.Document.get_page_labels = fitz_old.utils.get_page_labels fitz_old.Document.get_page_numbers = fitz_old.utils.get_page_numbers fitz_old.Document.get_page_pixmap = fitz_old.utils.get_page_pixmap fitz_old.Document.get_page_text = fitz_old.utils.get_page_text fitz_old.Document.get_toc = fitz_old.utils.get_toc fitz_old.Document.has_annots = fitz_old.utils.has_annots fitz_old.Document.has_links = fitz_old.utils.has_links fitz_old.Document.insert_page = fitz_old.utils.insert_page fitz_old.Document.new_page = fitz_old.utils.new_page fitz_old.Document.scrub = fitz_old.utils.scrub fitz_old.Document.search_page_for = fitz_old.utils.search_page_for fitz_old.Document.set_metadata = fitz_old.utils.set_metadata fitz_old.Document.set_ocmd = fitz_old.utils.set_ocmd fitz_old.Document.set_page_labels = fitz_old.utils.set_page_labels fitz_old.Document.set_toc = fitz_old.utils.set_toc fitz_old.Document.set_toc_item = fitz_old.utils.set_toc_item fitz_old.Document.tobytes = fitz_old.Document.write fitz_old.Document.subset_fonts = fitz_old.utils.subset_fonts fitz_old.Document.get_oc = fitz_old.utils.get_oc fitz_old.Document.set_oc = fitz_old.utils.set_oc fitz_old.Document.xref_copy = fitz_old.utils.xref_copy # ------------------------------------------------------------------------------ # Page # ------------------------------------------------------------------------------ fitz_old.Page.apply_redactions = fitz_old.utils.apply_redactions fitz_old.Page.delete_widget = fitz_old.utils.delete_widget fitz_old.Page.draw_bezier = fitz_old.utils.draw_bezier fitz_old.Page.draw_circle = fitz_old.utils.draw_circle fitz_old.Page.draw_curve = fitz_old.utils.draw_curve fitz_old.Page.draw_line = fitz_old.utils.draw_line fitz_old.Page.draw_oval = fitz_old.utils.draw_oval fitz_old.Page.draw_polyline = fitz_old.utils.draw_polyline fitz_old.Page.draw_quad = fitz_old.utils.draw_quad fitz_old.Page.draw_rect = fitz_old.utils.draw_rect fitz_old.Page.draw_sector = fitz_old.utils.draw_sector fitz_old.Page.draw_squiggle = fitz_old.utils.draw_squiggle fitz_old.Page.draw_zigzag = fitz_old.utils.draw_zigzag fitz_old.Page.get_links = fitz_old.utils.get_links fitz_old.Page.get_pixmap = fitz_old.utils.get_pixmap fitz_old.Page.get_text = fitz_old.utils.get_text fitz_old.Page.get_image_info = fitz_old.utils.get_image_info fitz_old.Page.get_text_blocks = fitz_old.utils.get_text_blocks fitz_old.Page.get_text_selection = fitz_old.utils.get_text_selection fitz_old.Page.get_text_words = fitz_old.utils.get_text_words fitz_old.Page.get_textbox = fitz_old.utils.get_textbox fitz_old.Page.insert_image = fitz_old.utils.insert_image fitz_old.Page.insert_link = fitz_old.utils.insert_link fitz_old.Page.insert_text = fitz_old.utils.insert_text fitz_old.Page.insert_textbox = fitz_old.utils.insert_textbox fitz_old.Page.new_shape = lambda x: fitz_old.utils.Shape(x) fitz_old.Page.search_for = fitz_old.utils.search_for fitz_old.Page.show_pdf_page = fitz_old.utils.show_pdf_page fitz_old.Page.update_link = fitz_old.utils.update_link fitz_old.Page.write_text = fitz_old.utils.write_text fitz_old.Page.get_label = fitz_old.utils.get_label fitz_old.Page.get_image_rects = fitz_old.utils.get_image_rects fitz_old.Page.get_textpage_ocr = fitz_old.utils.get_textpage_ocr fitz_old.Page.delete_image = fitz_old.utils.delete_image fitz_old.Page.replace_image = fitz_old.utils.replace_image fitz_old.Page.find_tables = find_tables # ------------------------------------------------------------------------ # Annot # ------------------------------------------------------------------------ fitz_old.Annot.get_text = fitz_old.utils.get_text fitz_old.Annot.get_textbox = fitz_old.utils.get_textbox # ------------------------------------------------------------------------ # Rect and IRect # ------------------------------------------------------------------------ fitz_old.Rect.get_area = fitz_old.utils.get_area fitz_old.IRect.get_area = fitz_old.utils.get_area # ------------------------------------------------------------------------ # TextWriter # ------------------------------------------------------------------------ fitz_old.TextWriter.fill_textbox = fitz_old.utils.fill_textbox class FitzDeprecation(DeprecationWarning): pass def restore_aliases(): import warnings warnings.filterwarnings( "once", category=FitzDeprecation, ) def showthis(msg, cat, filename, lineno, file=None, line=None): text = warnings.formatwarning(msg, cat, filename, lineno, line=line) s = text.find("FitzDeprecation") if s < 0: print(text, file=sys.stderr) return text = text[s:].splitlines()[0][4:] print(text, file=sys.stderr) warnings.showwarning = showthis def _alias(fitz_class, old, new): fname = getattr(fitz_class, new) r = str(fitz_class)[1:-1] objname = " ".join(r.split()[:2]) objname = objname.replace("fitz_old.fitz_old.", "") objname = objname.replace("fitz_old.utils.", "") if callable(fname): def deprecated_function(*args, **kw): msg = "'%s' removed from %s after v1.19 - use '%s'." % ( old, objname, new, ) if not VersionBind.startswith("1.18"): warnings.warn(msg, category=FitzDeprecation) return fname(*args, **kw) setattr(fitz_class, old, deprecated_function) else: if type(fname) is property: setattr(fitz_class, old, property(fname.fget)) else: setattr(fitz_class, old, fname) eigen = getattr(fitz_class, old) x = fname.__doc__ if not x: x = "" try: if callable(fname) or type(fname) is property: eigen.__doc__ = ( "*** Deprecated and removed after v1.19 - use '%s'. ***\n" % new + x ) except: pass # deprecated Document aliases _alias(fitz_old.Document, "chapterCount", "chapter_count") _alias(fitz_old.Document, "chapterPageCount", "chapter_page_count") _alias(fitz_old.Document, "convertToPDF", "convert_to_pdf") _alias(fitz_old.Document, "copyPage", "copy_page") _alias(fitz_old.Document, "deletePage", "delete_page") _alias(fitz_old.Document, "deletePageRange", "delete_pages") _alias(fitz_old.Document, "embeddedFileAdd", "embfile_add") _alias(fitz_old.Document, "embeddedFileCount", "embfile_count") _alias(fitz_old.Document, "embeddedFileDel", "embfile_del") _alias(fitz_old.Document, "embeddedFileGet", "embfile_get") _alias(fitz_old.Document, "embeddedFileInfo", "embfile_info") _alias(fitz_old.Document, "embeddedFileNames", "embfile_names") _alias(fitz_old.Document, "embeddedFileUpd", "embfile_upd") _alias(fitz_old.Document, "extractFont", "extract_font") _alias(fitz_old.Document, "extractImage", "extract_image") _alias(fitz_old.Document, "findBookmark", "find_bookmark") _alias(fitz_old.Document, "fullcopyPage", "fullcopy_page") _alias(fitz_old.Document, "getCharWidths", "get_char_widths") _alias(fitz_old.Document, "getOCGs", "get_ocgs") _alias(fitz_old.Document, "getPageFontList", "get_page_fonts") _alias(fitz_old.Document, "getPageImageList", "get_page_images") _alias(fitz_old.Document, "getPagePixmap", "get_page_pixmap") _alias(fitz_old.Document, "getPageText", "get_page_text") _alias(fitz_old.Document, "getPageXObjectList", "get_page_xobjects") _alias(fitz_old.Document, "getSigFlags", "get_sigflags") _alias(fitz_old.Document, "getToC", "get_toc") _alias(fitz_old.Document, "getXmlMetadata", "get_xml_metadata") _alias(fitz_old.Document, "insertPage", "insert_page") _alias(fitz_old.Document, "insertPDF", "insert_pdf") _alias(fitz_old.Document, "isDirty", "is_dirty") _alias(fitz_old.Document, "isFormPDF", "is_form_pdf") _alias(fitz_old.Document, "isPDF", "is_pdf") _alias(fitz_old.Document, "isReflowable", "is_reflowable") _alias(fitz_old.Document, "isRepaired", "is_repaired") _alias(fitz_old.Document, "isStream", "xref_is_stream") _alias(fitz_old.Document, "is_stream", "xref_is_stream") _alias(fitz_old.Document, "lastLocation", "last_location") _alias(fitz_old.Document, "loadPage", "load_page") _alias(fitz_old.Document, "makeBookmark", "make_bookmark") _alias(fitz_old.Document, "metadataXML", "xref_xml_metadata") _alias(fitz_old.Document, "movePage", "move_page") _alias(fitz_old.Document, "needsPass", "needs_pass") _alias(fitz_old.Document, "newPage", "new_page") _alias(fitz_old.Document, "nextLocation", "next_location") _alias(fitz_old.Document, "pageCount", "page_count") _alias(fitz_old.Document, "pageCropBox", "page_cropbox") _alias(fitz_old.Document, "pageXref", "page_xref") _alias(fitz_old.Document, "PDFCatalog", "pdf_catalog") _alias(fitz_old.Document, "PDFTrailer", "pdf_trailer") _alias(fitz_old.Document, "previousLocation", "prev_location") _alias(fitz_old.Document, "resolveLink", "resolve_link") _alias(fitz_old.Document, "searchPageFor", "search_page_for") _alias(fitz_old.Document, "setLanguage", "set_language") _alias(fitz_old.Document, "setMetadata", "set_metadata") _alias(fitz_old.Document, "setToC", "set_toc") _alias(fitz_old.Document, "setXmlMetadata", "set_xml_metadata") _alias(fitz_old.Document, "updateObject", "update_object") _alias(fitz_old.Document, "updateStream", "update_stream") _alias(fitz_old.Document, "xrefLength", "xref_length") _alias(fitz_old.Document, "xrefObject", "xref_object") _alias(fitz_old.Document, "xrefStream", "xref_stream") _alias(fitz_old.Document, "xrefStreamRaw", "xref_stream_raw") # deprecated Page aliases _alias(fitz_old.Page, "_isWrapped", "is_wrapped") _alias(fitz_old.Page, "addCaretAnnot", "add_caret_annot") _alias(fitz_old.Page, "addCircleAnnot", "add_circle_annot") _alias(fitz_old.Page, "addFileAnnot", "add_file_annot") _alias(fitz_old.Page, "addFreetextAnnot", "add_freetext_annot") _alias(fitz_old.Page, "addHighlightAnnot", "add_highlight_annot") _alias(fitz_old.Page, "addInkAnnot", "add_ink_annot") _alias(fitz_old.Page, "addLineAnnot", "add_line_annot") _alias(fitz_old.Page, "addPolygonAnnot", "add_polygon_annot") _alias(fitz_old.Page, "addPolylineAnnot", "add_polyline_annot") _alias(fitz_old.Page, "addRectAnnot", "add_rect_annot") _alias(fitz_old.Page, "addRedactAnnot", "add_redact_annot") _alias(fitz_old.Page, "addSquigglyAnnot", "add_squiggly_annot") _alias(fitz_old.Page, "addStampAnnot", "add_stamp_annot") _alias(fitz_old.Page, "addStrikeoutAnnot", "add_strikeout_annot") _alias(fitz_old.Page, "addTextAnnot", "add_text_annot") _alias(fitz_old.Page, "addUnderlineAnnot", "add_underline_annot") _alias(fitz_old.Page, "addWidget", "add_widget") _alias(fitz_old.Page, "cleanContents", "clean_contents") _alias(fitz_old.Page, "CropBox", "cropbox") _alias(fitz_old.Page, "CropBoxPosition", "cropbox_position") _alias(fitz_old.Page, "deleteAnnot", "delete_annot") _alias(fitz_old.Page, "deleteLink", "delete_link") _alias(fitz_old.Page, "deleteWidget", "delete_widget") _alias(fitz_old.Page, "derotationMatrix", "derotation_matrix") _alias(fitz_old.Page, "drawBezier", "draw_bezier") _alias(fitz_old.Page, "drawCircle", "draw_circle") _alias(fitz_old.Page, "drawCurve", "draw_curve") _alias(fitz_old.Page, "drawLine", "draw_line") _alias(fitz_old.Page, "drawOval", "draw_oval") _alias(fitz_old.Page, "drawPolyline", "draw_polyline") _alias(fitz_old.Page, "drawQuad", "draw_quad") _alias(fitz_old.Page, "drawRect", "draw_rect") _alias(fitz_old.Page, "drawSector", "draw_sector") _alias(fitz_old.Page, "drawSquiggle", "draw_squiggle") _alias(fitz_old.Page, "drawZigzag", "draw_zigzag") _alias(fitz_old.Page, "firstAnnot", "first_annot") _alias(fitz_old.Page, "firstLink", "first_link") _alias(fitz_old.Page, "firstWidget", "first_widget") _alias(fitz_old.Page, "getContents", "get_contents") _alias(fitz_old.Page, "getDisplayList", "get_displaylist") _alias(fitz_old.Page, "getDrawings", "get_drawings") _alias(fitz_old.Page, "getFontList", "get_fonts") _alias(fitz_old.Page, "getImageBbox", "get_image_bbox") _alias(fitz_old.Page, "getImageList", "get_images") _alias(fitz_old.Page, "getLinks", "get_links") _alias(fitz_old.Page, "getPixmap", "get_pixmap") _alias(fitz_old.Page, "getSVGimage", "get_svg_image") _alias(fitz_old.Page, "getText", "get_text") _alias(fitz_old.Page, "getTextBlocks", "get_text_blocks") _alias(fitz_old.Page, "getTextbox", "get_textbox") _alias(fitz_old.Page, "getTextPage", "get_textpage") _alias(fitz_old.Page, "getTextWords", "get_text_words") _alias(fitz_old.Page, "insertFont", "insert_font") _alias(fitz_old.Page, "insertImage", "insert_image") _alias(fitz_old.Page, "insertLink", "insert_link") _alias(fitz_old.Page, "insertText", "insert_text") _alias(fitz_old.Page, "insertTextbox", "insert_textbox") _alias(fitz_old.Page, "loadAnnot", "load_annot") _alias(fitz_old.Page, "loadLinks", "load_links") _alias(fitz_old.Page, "MediaBox", "mediabox") _alias(fitz_old.Page, "MediaBoxSize", "mediabox_size") _alias(fitz_old.Page, "newShape", "new_shape") _alias(fitz_old.Page, "readContents", "read_contents") _alias(fitz_old.Page, "rotationMatrix", "rotation_matrix") _alias(fitz_old.Page, "searchFor", "search_for") _alias(fitz_old.Page, "setCropBox", "set_cropbox") _alias(fitz_old.Page, "setMediaBox", "set_mediabox") _alias(fitz_old.Page, "setRotation", "set_rotation") _alias(fitz_old.Page, "showPDFpage", "show_pdf_page") _alias(fitz_old.Page, "transformationMatrix", "transformation_matrix") _alias(fitz_old.Page, "updateLink", "update_link") _alias(fitz_old.Page, "wrapContents", "wrap_contents") _alias(fitz_old.Page, "writeText", "write_text") # deprecated Shape aliases _alias(fitz_old.utils.Shape, "drawBezier", "draw_bezier") _alias(fitz_old.utils.Shape, "drawCircle", "draw_circle") _alias(fitz_old.utils.Shape, "drawCurve", "draw_curve") _alias(fitz_old.utils.Shape, "drawLine", "draw_line") _alias(fitz_old.utils.Shape, "drawOval", "draw_oval") _alias(fitz_old.utils.Shape, "drawPolyline", "draw_polyline") _alias(fitz_old.utils.Shape, "drawQuad", "draw_quad") _alias(fitz_old.utils.Shape, "drawRect", "draw_rect") _alias(fitz_old.utils.Shape, "drawSector", "draw_sector") _alias(fitz_old.utils.Shape, "drawSquiggle", "draw_squiggle") _alias(fitz_old.utils.Shape, "drawZigzag", "draw_zigzag") _alias(fitz_old.utils.Shape, "insertText", "insert_text") _alias(fitz_old.utils.Shape, "insertTextbox", "insert_textbox") # deprecated Annot aliases _alias(fitz_old.Annot, "getText", "get_text") _alias(fitz_old.Annot, "getTextbox", "get_textbox") _alias(fitz_old.Annot, "fileGet", "get_file") _alias(fitz_old.Annot, "fileUpd", "update_file") _alias(fitz_old.Annot, "getPixmap", "get_pixmap") _alias(fitz_old.Annot, "getTextPage", "get_textpage") _alias(fitz_old.Annot, "lineEnds", "line_ends") _alias(fitz_old.Annot, "setBlendMode", "set_blendmode") _alias(fitz_old.Annot, "setBorder", "set_border") _alias(fitz_old.Annot, "setColors", "set_colors") _alias(fitz_old.Annot, "setFlags", "set_flags") _alias(fitz_old.Annot, "setInfo", "set_info") _alias(fitz_old.Annot, "setLineEnds", "set_line_ends") _alias(fitz_old.Annot, "setName", "set_name") _alias(fitz_old.Annot, "setOpacity", "set_opacity") _alias(fitz_old.Annot, "setRect", "set_rect") _alias(fitz_old.Annot, "setOC", "set_oc") _alias(fitz_old.Annot, "soundGet", "get_sound") # deprecated TextWriter aliases _alias(fitz_old.TextWriter, "writeText", "write_text") _alias(fitz_old.TextWriter, "fillTextbox", "fill_textbox") # deprecated DisplayList aliases _alias(fitz_old.DisplayList, "getPixmap", "get_pixmap") _alias(fitz_old.DisplayList, "getTextPage", "get_textpage") # deprecated Pixmap aliases _alias(fitz_old.Pixmap, "setAlpha", "set_alpha") _alias(fitz_old.Pixmap, "gammaWith", "gamma_with") _alias(fitz_old.Pixmap, "tintWith", "tint_with") _alias(fitz_old.Pixmap, "clearWith", "clear_with") _alias(fitz_old.Pixmap, "copyPixmap", "copy") _alias(fitz_old.Pixmap, "getImageData", "tobytes") _alias(fitz_old.Pixmap, "getPNGData", "tobytes") _alias(fitz_old.Pixmap, "getPNGdata", "tobytes") _alias(fitz_old.Pixmap, "writeImage", "save") _alias(fitz_old.Pixmap, "writePNG", "save") _alias(fitz_old.Pixmap, "pillowWrite", "pil_save") _alias(fitz_old.Pixmap, "pillowData", "pil_tobytes") _alias(fitz_old.Pixmap, "invertIRect", "invert_irect") _alias(fitz_old.Pixmap, "setPixel", "set_pixel") _alias(fitz_old.Pixmap, "setOrigin", "set_origin") _alias(fitz_old.Pixmap, "setRect", "set_rect") _alias(fitz_old.Pixmap, "setResolution", "set_dpi") # deprecated geometry aliases _alias(fitz_old.Rect, "getArea", "get_area") _alias(fitz_old.IRect, "getArea", "get_area") _alias(fitz_old.Rect, "getRectArea", "get_area") _alias(fitz_old.IRect, "getRectArea", "get_area") _alias(fitz_old.Rect, "includePoint", "include_point") _alias(fitz_old.IRect, "includePoint", "include_point") _alias(fitz_old.Rect, "includeRect", "include_rect") _alias(fitz_old.IRect, "includeRect", "include_rect") _alias(fitz_old.Rect, "isInfinite", "is_infinite") _alias(fitz_old.IRect, "isInfinite", "is_infinite") _alias(fitz_old.Rect, "isEmpty", "is_empty") _alias(fitz_old.IRect, "isEmpty", "is_empty") _alias(fitz_old.Quad, "isEmpty", "is_empty") _alias(fitz_old.Quad, "isRectangular", "is_rectangular") _alias(fitz_old.Quad, "isConvex", "is_convex") _alias(fitz_old.Matrix, "isRectilinear", "is_rectilinear") _alias(fitz_old.Matrix, "preRotate", "prerotate") _alias(fitz_old.Matrix, "preScale", "prescale") _alias(fitz_old.Matrix, "preShear", "preshear") _alias(fitz_old.Matrix, "preTranslate", "pretranslate") # deprecated other aliases _alias(fitz_old.Outline, "isExternal", "is_external") _alias(fitz_old.Outline, "isOpen", "is_open") _alias(fitz_old.Link, "isExternal", "is_external") _alias(fitz_old.Link, "setBorder", "set_border") _alias(fitz_old.Link, "setColors", "set_colors") _alias(fitz, "getPDFstr", "get_pdf_str") _alias(fitz, "getPDFnow", "get_pdf_now") _alias(fitz, "PaperSize", "paper_size") _alias(fitz, "PaperRect", "paper_rect") _alias(fitz, "paperSizes", "paper_sizes") _alias(fitz, "ImageProperties", "image_profile") _alias(fitz, "planishLine", "planish_line") _alias(fitz, "getTextLength", "get_text_length") _alias(fitz, "getTextlength", "get_text_length") fitz_old.__doc__ = """ PyMuPDF %s: Python bindings for the MuPDF %s library. Version date: %s. Built for Python %i.%i on %s (%i-bit). """ % ( fitz_old.VersionBind, fitz_old.VersionFitz, fitz_old.VersionDate, sys.version_info[0], sys.version_info[1], sys.platform, 64 if sys.maxsize > 2**32 else 32, ) if VersionBind.startswith("1.19"): # don't generate aliases after v1.19.* restore_aliases() pdfcolor = dict( [ (k, (r / 255, g / 255, b / 255)) for k, (r, g, b) in fitz_old.utils.getColorInfoDict().items() ] ) __version__ = fitz_old.VersionBind ================================================ FILE: src_classic/__main__.py ================================================ # ----------------------------------------------------------------------------- # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # Part of "PyMuPDF", Python bindings for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ----------------------------------------------------------------------------- import argparse import bisect import os import sys import statistics from typing import Dict, List, Set, Tuple import fitz from fitz.fitz import ( TEXT_INHIBIT_SPACES, TEXT_PRESERVE_LIGATURES, TEXT_PRESERVE_WHITESPACE, ) mycenter = lambda x: (" %s " % x).center(75, "-") def recoverpix(doc, item): """Return image for a given XREF.""" x = item[0] # xref of PDF image s = item[1] # xref of its /SMask if s == 0: # no smask: use direct image output return doc.extract_image(x) def getimage(pix): if pix.colorspace.n != 4: return pix tpix = fitz.Pixmap(fitz.csRGB, pix) return tpix # we need to reconstruct the alpha channel with the smask pix1 = fitz.Pixmap(doc, x) pix2 = fitz.Pixmap(doc, s) # create pixmap of the /SMask entry """Sanity check: - both pixmaps must have the same rectangle - both pixmaps must have alpha=0 - pix2 must consist of 1 byte per pixel """ if not (pix1.irect == pix2.irect and pix1.alpha == pix2.alpha == 0 and pix2.n == 1): print("Warning: unsupported /SMask %i for %i:" % (s, x)) print(pix2) pix2 = None return getimage(pix1) # return the pixmap as is pix = fitz.Pixmap(pix1) # copy of pix1, with an alpha channel added pix.set_alpha(pix2.samples) # treat pix2.samples as the alpha values pix1 = pix2 = None # free temp pixmaps # we may need to adjust something for CMYK pixmaps here: return getimage(pix) def open_file(filename, password, show=False, pdf=True): """Open and authenticate a document.""" doc = fitz.open(filename) if not doc.is_pdf and pdf is True: sys.exit("this command supports PDF files only") rc = -1 if not doc.needs_pass: return doc if password: rc = doc.authenticate(password) if not rc: sys.exit("authentication unsuccessful") if show is True: print("authenticated as %s" % "owner" if rc > 2 else "user") else: sys.exit("'%s' requires a password" % doc.name) return doc def print_dict(item): """Print a Python dictionary.""" l = max([len(k) for k in item.keys()]) + 1 for k, v in item.items(): msg = "%s: %s" % (k.rjust(l), v) print(msg) return def print_xref(doc, xref): """Print an object given by XREF number. Simulate the PDF source in "pretty" format. For a stream also print its size. """ print("%i 0 obj" % xref) xref_str = doc.xref_object(xref) print(xref_str) if doc.xref_is_stream(xref): temp = xref_str.split() try: idx = temp.index("/Length") + 1 size = temp[idx] if size.endswith("0 R"): size = "unknown" except: size = "unknown" print("stream\n...%s bytes" % size) print("endstream") print("endobj") def get_list(rlist, limit, what="page"): """Transform a page / xref specification into a list of integers. Args ---- rlist: (str) the specification limit: maximum number, i.e. number of pages, number of objects what: a string to be used in error messages Returns ------- A list of integers representing the specification. """ N = str(limit - 1) rlist = rlist.replace("N", N).replace(" ", "") rlist_arr = rlist.split(",") out_list = [] for seq, item in enumerate(rlist_arr): n = seq + 1 if item.isdecimal(): # a single integer i = int(item) if 1 <= i < limit: out_list.append(int(item)) else: sys.exit("bad %s specification at item %i" % (what, n)) continue try: # this must be a range now, and all of the following must work: i1, i2 = item.split("-") # will fail if not 2 items produced i1 = int(i1) # will fail on non-integers i2 = int(i2) except: sys.exit("bad %s range specification at item %i" % (what, n)) if not (1 <= i1 < limit and 1 <= i2 < limit): sys.exit("bad %s range specification at item %i" % (what, n)) if i1 == i2: # just in case: a range of equal numbers out_list.append(i1) continue if i1 < i2: # first less than second out_list += list(range(i1, i2 + 1)) else: # first larger than second out_list += list(range(i1, i2 - 1, -1)) return out_list def show(args): doc = open_file(args.input, args.password, True) size = os.path.getsize(args.input) / 1024 flag = "KB" if size > 1000: size /= 1024 flag = "MB" size = round(size, 1) meta = doc.metadata print( "'%s', pages: %i, objects: %i, %g %s, %s, encryption: %s" % ( args.input, doc.page_count, doc.xref_length() - 1, size, flag, meta["format"], meta["encryption"], ) ) n = doc.is_form_pdf if n > 0: s = doc.get_sigflags() print( "document contains %i root form fields and is %ssigned" % (n, "not " if s != 3 else "") ) n = doc.embfile_count() if n > 0: print("document contains %i embedded files" % n) print() if args.catalog: print(mycenter("PDF catalog")) xref = doc.pdf_catalog() print_xref(doc, xref) print() if args.metadata: print(mycenter("PDF metadata")) print_dict(doc.metadata) print() if args.xrefs: print(mycenter("object information")) xrefl = get_list(args.xrefs, doc.xref_length(), what="xref") for xref in xrefl: print_xref(doc, xref) print() if args.pages: print(mycenter("page information")) pagel = get_list(args.pages, doc.page_count + 1) for pno in pagel: n = pno - 1 xref = doc.page_xref(n) print("Page %i:" % pno) print_xref(doc, xref) print() if args.trailer: print(mycenter("PDF trailer")) print(doc.pdf_trailer()) print() doc.close() def clean(args): doc = open_file(args.input, args.password, pdf=True) encryption = args.encryption encrypt = ("keep", "none", "rc4-40", "rc4-128", "aes-128", "aes-256").index( encryption ) if not args.pages: # simple cleaning doc.save( args.output, garbage=args.garbage, deflate=args.compress, pretty=args.pretty, clean=args.sanitize, ascii=args.ascii, linear=args.linear, encryption=encrypt, owner_pw=args.owner, user_pw=args.user, permissions=args.permission, ) return # create sub document from page numbers pages = get_list(args.pages, doc.page_count + 1) outdoc = fitz.open() for pno in pages: n = pno - 1 outdoc.insert_pdf(doc, from_page=n, to_page=n) outdoc.save( args.output, garbage=args.garbage, deflate=args.compress, pretty=args.pretty, clean=args.sanitize, ascii=args.ascii, linear=args.linear, encryption=encrypt, owner_pw=args.owner, user_pw=args.user, permissions=args.permission, ) doc.close() outdoc.close() return def doc_join(args): """Join pages from several PDF documents.""" doc_list = args.input # a list of input PDFs doc = fitz.open() # output PDF for src_item in doc_list: # process one input PDF src_list = src_item.split(",") password = src_list[1] if len(src_list) > 1 else None src = open_file(src_list[0], password, pdf=True) pages = ",".join(src_list[2:]) # get 'pages' specifications if pages: # if anything there, retrieve a list of desired pages page_list = get_list(",".join(src_list[2:]), src.page_count + 1) else: # take all pages page_list = range(1, src.page_count + 1) for i in page_list: doc.insert_pdf(src, from_page=i - 1, to_page=i - 1) # copy each source page src.close() doc.save(args.output, garbage=4, deflate=True) doc.close() def embedded_copy(args): """Copy embedded files between PDFs.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( not args.output or args.output == args.input ): sys.exit("cannot save PDF incrementally") src = open_file(args.source, args.pwdsource) names = set(args.name) if args.name else set() src_names = set(src.embfile_names()) if names: if not names <= src_names: sys.exit("not all names are contained in source") else: names = src_names if not names: sys.exit("nothing to copy") intersect = names & set(doc.embfile_names()) # any equal name already in target? if intersect: sys.exit("following names already exist in receiving PDF: %s" % str(intersect)) for item in names: info = src.embfile_info(item) buff = src.embfile_get(item) doc.embfile_add( item, buff, filename=info["filename"], ufilename=info["ufilename"], desc=info["desc"], ) print("copied entry '%s' from '%s'" % (item, src.name)) src.close() if args.output and args.output != args.input: doc.save(args.output, garbage=3) else: doc.saveIncr() doc.close() def embedded_del(args): """Delete an embedded file entry.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( not args.output or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_del(args.name) except ValueError: sys.exit("no such embedded file '%s'" % args.name) if not args.output or args.output == args.input: doc.save_incr() else: doc.save(args.output, garbage=1) doc.close() def embedded_get(args): """Retrieve contents of an embedded file.""" doc = open_file(args.input, args.password, pdf=True) try: stream = doc.embfile_get(args.name) d = doc.embfile_info(args.name) except ValueError: sys.exit("no such embedded file '%s'" % args.name) filename = args.output if args.output else d["filename"] output = open(filename, "wb") output.write(stream) output.close() print("saved entry '%s' as '%s'" % (args.name, filename)) doc.close() def embedded_add(args): """Insert a new embedded file.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( args.output is None or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_del(args.name) sys.exit("entry '%s' already exists" % args.name) except: pass if not os.path.exists(args.path) or not os.path.isfile(args.path): sys.exit("no such file '%s'" % args.path) stream = open(args.path, "rb").read() filename = args.path ufilename = filename if not args.desc: desc = filename else: desc = args.desc doc.embfile_add( args.name, stream, filename=filename, ufilename=ufilename, desc=desc ) if not args.output or args.output == args.input: doc.saveIncr() else: doc.save(args.output, garbage=3) doc.close() def embedded_upd(args): """Update contents or metadata of an embedded file.""" doc = open_file(args.input, args.password, pdf=True) if not doc.can_save_incrementally() and ( args.output is None or args.output == args.input ): sys.exit("cannot save PDF incrementally") try: doc.embfile_info(args.name) except: sys.exit("no such embedded file '%s'" % args.name) if ( args.path is not None and os.path.exists(args.path) and os.path.isfile(args.path) ): stream = open(args.path, "rb").read() else: stream = None if args.filename: filename = args.filename else: filename = None if args.ufilename: ufilename = args.ufilename elif args.filename: ufilename = args.filename else: ufilename = None if args.desc: desc = args.desc else: desc = None doc.embfile_upd( args.name, stream, filename=filename, ufilename=ufilename, desc=desc ) if args.output is None or args.output == args.input: doc.saveIncr() else: doc.save(args.output, garbage=3) doc.close() def embedded_list(args): """List embedded files.""" doc = open_file(args.input, args.password, pdf=True) names = doc.embfile_names() if args.name is not None: if args.name not in names: sys.exit("no such embedded file '%s'" % args.name) else: print() print( "printing 1 of %i embedded file%s:" % (len(names), "s" if len(names) > 1 else "") ) print() print_dict(doc.embfile_info(args.name)) print() return if not names: print("'%s' contains no embedded files" % doc.name) return if len(names) > 1: msg = "'%s' contains the following %i embedded files" % (doc.name, len(names)) else: msg = "'%s' contains the following embedded file" % doc.name print(msg) print() for name in names: if not args.detail: print(name) continue _ = doc.embfile_info(name) print_dict(doc.embfile_info(name)) print() doc.close() def extract_objects(args): """Extract images and / or fonts from a PDF.""" if not args.fonts and not args.images: sys.exit("neither fonts nor images requested") doc = open_file(args.input, args.password, pdf=True) if args.pages: pages = get_list(args.pages, doc.page_count + 1) else: pages = range(1, doc.page_count + 1) if not args.output: out_dir = os.path.abspath(os.curdir) else: out_dir = args.output if not (os.path.exists(out_dir) and os.path.isdir(out_dir)): sys.exit("output directory %s does not exist" % out_dir) font_xrefs = set() # already saved fonts image_xrefs = set() # already saved images for pno in pages: if args.fonts: itemlist = doc.get_page_fonts(pno - 1) for item in itemlist: xref = item[0] if xref not in font_xrefs: font_xrefs.add(xref) fontname, ext, _, buffer = doc.extract_font(xref) if ext == "n/a" or not buffer: continue outname = os.path.join( out_dir, f"{fontname.replace(' ', '-')}-{xref}.{ext}" ) outfile = open(outname, "wb") outfile.write(buffer) outfile.close() buffer = None if args.images: itemlist = doc.get_page_images(pno - 1) for item in itemlist: xref = item[0] if xref not in image_xrefs: image_xrefs.add(xref) pix = recoverpix(doc, item) if type(pix) is dict: ext = pix["ext"] imgdata = pix["image"] outname = os.path.join(out_dir, "img-%i.%s" % (xref, ext)) outfile = open(outname, "wb") outfile.write(imgdata) outfile.close() else: outname = os.path.join(out_dir, "img-%i.png" % xref) pix2 = ( pix if pix.colorspace.n < 4 else fitz.Pixmap(fitz.csRGB, pix) ) pix2.save(outname) if args.fonts: print("saved %i fonts to '%s'" % (len(font_xrefs), out_dir)) if args.images: print("saved %i images to '%s'" % (len(image_xrefs), out_dir)) doc.close() def page_simple(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) text = page.get_text("text", flags=flags) if not text: if not skip_empty: textout.write(eop) # write formfeed return textout.write(text.encode("utf8", errors="surrogatepass")) textout.write(eop) return def page_blocksort(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) blocks = page.get_text("blocks", flags=flags) if blocks == []: if not skip_empty: textout.write(eop) # write formfeed return blocks.sort(key=lambda b: (b[3], b[0])) for b in blocks: textout.write(b[4].encode("utf8", errors="surrogatepass")) textout.write(eop) return def page_layout(page, textout, GRID, fontsize, noformfeed, skip_empty, flags): eop = b"\n" if noformfeed else bytes([12]) # -------------------------------------------------------------------- def find_line_index(values: List[int], value: int) -> int: """Find the right row coordinate. Args: values: (list) y-coordinates of rows. value: (int) lookup for this value (y-origin of char). Returns: y-ccordinate of appropriate line for value. """ i = bisect.bisect_right(values, value) if i: return values[i - 1] raise RuntimeError("Line for %g not found in %s" % (value, values)) # -------------------------------------------------------------------- def curate_rows(rows: Set[int], GRID) -> List: rows = list(rows) rows.sort() # sort ascending nrows = [rows[0]] for h in rows[1:]: if h >= nrows[-1] + GRID: # only keep significant differences nrows.append(h) return nrows # curated list of line bottom coordinates def process_blocks(blocks: List[Dict], page: fitz.Page): rows = set() page_width = page.rect.width page_height = page.rect.height rowheight = page_height left = page_width right = 0 chars = [] for block in blocks: for line in block["lines"]: if line["dir"] != (1, 0): # ignore non-horizontal text continue x0, y0, x1, y1 = line["bbox"] if y1 < 0 or y0 > page.rect.height: # ignore if outside CropBox continue # upd row height height = y1 - y0 if rowheight > height: rowheight = height for span in line["spans"]: if span["size"] <= fontsize: continue for c in span["chars"]: x0, _, x1, _ = c["bbox"] cwidth = x1 - x0 ox, oy = c["origin"] oy = int(round(oy)) rows.add(oy) ch = c["c"] if left > ox and ch != " ": left = ox # update left coordinate if right < x1: right = x1 # update right coordinate # handle ligatures: if cwidth == 0 and chars != []: # potential ligature old_ch, old_ox, old_oy, old_cwidth = chars[-1] if old_oy == oy: # ligature if old_ch != chr(0xFB00): # previous "ff" char lig? lig = joinligature(old_ch + ch) # no # convert to one of the 3-char ligatures: elif ch == "i": lig = chr(0xFB03) # "ffi" elif ch == "l": lig = chr(0xFB04) # "ffl" else: # something wrong, leave old char in place lig = old_ch chars[-1] = (lig, old_ox, old_oy, old_cwidth) continue chars.append((ch, ox, oy, cwidth)) # all chars on page return chars, rows, left, right, rowheight def joinligature(lig: str) -> str: """Return ligature character for a given pair / triple of characters. Args: lig: (str) 2/3 characters, e.g. "ff" Returns: Ligature, e.g. "ff" -> chr(0xFB00) """ if lig == "ff": return chr(0xFB00) elif lig == "fi": return chr(0xFB01) elif lig == "fl": return chr(0xFB02) elif lig == "ffi": return chr(0xFB03) elif lig == "ffl": return chr(0xFB04) elif lig == "ft": return chr(0xFB05) elif lig == "st": return chr(0xFB06) return lig # -------------------------------------------------------------------- def make_textline(left, slot, minslot, lchars): """Produce the text of one output line. Args: left: (float) left most coordinate used on page slot: (float) avg width of one character in any font in use. minslot: (float) min width for the characters in this line. chars: (list[tuple]) characters of this line. Returns: text: (str) text string for this line """ text = "" # we output this old_char = "" old_x1 = 0 # end coordinate of last char old_ox = 0 # x-origin of last char if minslot <= fitz.EPSILON: raise RuntimeError("program error: minslot too small = %g" % minslot) for c in lchars: # loop over characters char, ox, _, cwidth = c ox = ox - left # its (relative) start coordinate x1 = ox + cwidth # ending coordinate # eliminate overprint effect if old_char == char and ox - old_ox <= cwidth * 0.2: continue # omit spaces overlapping previous char if char == " " and (old_x1 - ox) / cwidth > 0.8: continue old_char = char # close enough to previous? if ox < old_x1 + minslot: # assume char adjacent to previous text += char # append to output old_x1 = x1 # new end coord old_ox = ox # new origin.x continue # else next char starts after some gap: # fill in right number of spaces, so char is positioned # in the right slot of the line if char == " ": # rest relevant for non-space only continue delta = int(ox / slot) - len(text) if ox > old_x1 and delta > 1: text += " " * delta # now append char text += char old_x1 = x1 # new end coordinate old_ox = ox # new origin return text.rstrip() # extract page text by single characters ("rawdict") blocks = page.get_text("rawdict", flags=flags)["blocks"] chars, rows, left, right, rowheight = process_blocks(blocks, page) if chars == []: if not skip_empty: textout.write(eop) # write formfeed return # compute list of line coordinates - ignoring small (GRID) differences rows = curate_rows(rows, GRID) # sort all chars by x-coordinates, so every line will receive char info, # sorted from left to right. chars.sort(key=lambda c: c[1]) # populate the lines with their char info lines = {} # key: y1-ccordinate, value: char list for c in chars: _, _, oy, _ = c y = find_line_index(rows, oy) # y-coord of the right line lchars = lines.get(y, []) # read line chars so far lchars.append(c) # append this char lines[y] = lchars # write back to line # ensure line coordinates are ascending keys = list(lines.keys()) keys.sort() # ------------------------------------------------------------------------- # Compute "char resolution" for the page: the char width corresponding to # 1 text char position on output - call it 'slot'. # For each line, compute median of its char widths. The minimum across all # lines is 'slot'. # The minimum char width of each line is used to determine if spaces must # be inserted in between two characters. # ------------------------------------------------------------------------- slot = right - left minslots = {} for k in keys: lchars = lines[k] ccount = len(lchars) if ccount < 2: minslots[k] = 1 continue widths = [c[3] for c in lchars] widths.sort() this_slot = statistics.median(widths) # take median value if this_slot < slot: slot = this_slot minslots[k] = widths[0] # compute line advance in text output rowheight = rowheight * (rows[-1] - rows[0]) / (rowheight * len(rows)) * 1.2 rowpos = rows[0] # first line positioned here textout.write(b"\n") for k in keys: # walk through the lines while rowpos < k: # honor distance between lines textout.write(b"\n") rowpos += rowheight text = make_textline(left, slot, minslots[k], lines[k]) textout.write((text + "\n").encode("utf8", errors="surrogatepass")) rowpos = k + rowheight textout.write(eop) # write formfeed def gettext(args): doc = open_file(args.input, args.password, pdf=False) pagel = get_list(args.pages, doc.page_count + 1) output = args.output if output == None: filename, _ = os.path.splitext(doc.name) output = filename + ".txt" textout = open(output, "wb") flags = TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE if args.convert_white: flags ^= TEXT_PRESERVE_WHITESPACE if args.noligatures: flags ^= TEXT_PRESERVE_LIGATURES if args.extra_spaces: flags ^= TEXT_INHIBIT_SPACES func = { "simple": page_simple, "blocks": page_blocksort, "layout": page_layout, } for pno in pagel: page = doc[pno - 1] func[args.mode]( page, textout, args.grid, args.fontsize, args.noformfeed, args.skip_empty, flags=flags, ) textout.close() def main(): """Define command configurations.""" parser = argparse.ArgumentParser( prog="fitz", description=mycenter("Basic PyMuPDF Functions"), ) subps = parser.add_subparsers( title="Subcommands", help="Enter 'command -h' for subcommand specific help" ) # ------------------------------------------------------------------------- # 'show' command # ------------------------------------------------------------------------- ps_show = subps.add_parser("show", description=mycenter("display PDF information")) ps_show.add_argument("input", type=str, help="PDF filename") ps_show.add_argument("-password", help="password") ps_show.add_argument("-catalog", action="store_true", help="show PDF catalog") ps_show.add_argument("-trailer", action="store_true", help="show PDF trailer") ps_show.add_argument("-metadata", action="store_true", help="show PDF metadata") ps_show.add_argument( "-xrefs", type=str, help="show selected objects, format: 1,5-7,N" ) ps_show.add_argument( "-pages", type=str, help="show selected pages, format: 1,5-7,50-N" ) ps_show.set_defaults(func=show) # ------------------------------------------------------------------------- # 'clean' command # ------------------------------------------------------------------------- ps_clean = subps.add_parser( "clean", description=mycenter("optimize PDF, or create sub-PDF if pages given") ) ps_clean.add_argument("input", type=str, help="PDF filename") ps_clean.add_argument("output", type=str, help="output PDF filename") ps_clean.add_argument("-password", help="password") ps_clean.add_argument( "-encryption", help="encryption method", choices=("keep", "none", "rc4-40", "rc4-128", "aes-128", "aes-256"), default="none", ) ps_clean.add_argument("-owner", type=str, help="owner password") ps_clean.add_argument("-user", type=str, help="user password") ps_clean.add_argument( "-garbage", type=int, help="garbage collection level", choices=range(5), default=0, ) ps_clean.add_argument( "-compress", action="store_true", default=False, help="compress (deflate) output", ) ps_clean.add_argument( "-ascii", action="store_true", default=False, help="ASCII encode binary data" ) ps_clean.add_argument( "-linear", action="store_true", default=False, help="format for fast web display", ) ps_clean.add_argument( "-permission", type=int, default=-1, help="integer with permission levels" ) ps_clean.add_argument( "-sanitize", action="store_true", default=False, help="sanitize / clean contents", ) ps_clean.add_argument( "-pretty", action="store_true", default=False, help="prettify PDF structure" ) ps_clean.add_argument( "-pages", help="output selected pages pages, format: 1,5-7,50-N" ) ps_clean.set_defaults(func=clean) # ------------------------------------------------------------------------- # 'join' command # ------------------------------------------------------------------------- ps_join = subps.add_parser( "join", description=mycenter("join PDF documents"), epilog="specify each input as 'filename[,password[,pages]]'", ) ps_join.add_argument("input", nargs="*", help="input filenames") ps_join.add_argument("-output", required=True, help="output filename") ps_join.set_defaults(func=doc_join) # ------------------------------------------------------------------------- # 'extract' command # ------------------------------------------------------------------------- ps_extract = subps.add_parser( "extract", description=mycenter("extract images and fonts to disk") ) ps_extract.add_argument("input", type=str, help="PDF filename") ps_extract.add_argument("-images", action="store_true", help="extract images") ps_extract.add_argument("-fonts", action="store_true", help="extract fonts") ps_extract.add_argument( "-output", help="folder to receive output, defaults to current" ) ps_extract.add_argument("-password", help="password") ps_extract.add_argument( "-pages", type=str, help="consider these pages only, format: 1,5-7,50-N" ) ps_extract.set_defaults(func=extract_objects) # ------------------------------------------------------------------------- # 'embed-info' # ------------------------------------------------------------------------- ps_show = subps.add_parser( "embed-info", description=mycenter("list embedded files") ) ps_show.add_argument("input", help="PDF filename") ps_show.add_argument("-name", help="if given, report only this one") ps_show.add_argument("-detail", action="store_true", help="detail information") ps_show.add_argument("-password", help="password") ps_show.set_defaults(func=embedded_list) # ------------------------------------------------------------------------- # 'embed-add' command # ------------------------------------------------------------------------- ps_embed_add = subps.add_parser( "embed-add", description=mycenter("add embedded file") ) ps_embed_add.add_argument("input", help="PDF filename") ps_embed_add.add_argument("-password", help="password") ps_embed_add.add_argument( "-output", help="output PDF filename, incremental save if none" ) ps_embed_add.add_argument("-name", required=True, help="name of new entry") ps_embed_add.add_argument("-path", required=True, help="path to data for new entry") ps_embed_add.add_argument("-desc", help="description of new entry") ps_embed_add.set_defaults(func=embedded_add) # ------------------------------------------------------------------------- # 'embed-del' command # ------------------------------------------------------------------------- ps_embed_del = subps.add_parser( "embed-del", description=mycenter("delete embedded file") ) ps_embed_del.add_argument("input", help="PDF filename") ps_embed_del.add_argument("-password", help="password") ps_embed_del.add_argument( "-output", help="output PDF filename, incremental save if none" ) ps_embed_del.add_argument("-name", required=True, help="name of entry to delete") ps_embed_del.set_defaults(func=embedded_del) # ------------------------------------------------------------------------- # 'embed-upd' command # ------------------------------------------------------------------------- ps_embed_upd = subps.add_parser( "embed-upd", description=mycenter("update embedded file"), epilog="except '-name' all parameters are optional", ) ps_embed_upd.add_argument("input", help="PDF filename") ps_embed_upd.add_argument("-name", required=True, help="name of entry") ps_embed_upd.add_argument("-password", help="password") ps_embed_upd.add_argument( "-output", help="Output PDF filename, incremental save if none" ) ps_embed_upd.add_argument("-path", help="path to new data for entry") ps_embed_upd.add_argument("-filename", help="new filename to store in entry") ps_embed_upd.add_argument( "-ufilename", help="new unicode filename to store in entry" ) ps_embed_upd.add_argument("-desc", help="new description to store in entry") ps_embed_upd.set_defaults(func=embedded_upd) # ------------------------------------------------------------------------- # 'embed-extract' command # ------------------------------------------------------------------------- ps_embed_extract = subps.add_parser( "embed-extract", description=mycenter("extract embedded file to disk") ) ps_embed_extract.add_argument("input", type=str, help="PDF filename") ps_embed_extract.add_argument("-name", required=True, help="name of entry") ps_embed_extract.add_argument("-password", help="password") ps_embed_extract.add_argument( "-output", help="output filename, default is stored name" ) ps_embed_extract.set_defaults(func=embedded_get) # ------------------------------------------------------------------------- # 'embed-copy' command # ------------------------------------------------------------------------- ps_embed_copy = subps.add_parser( "embed-copy", description=mycenter("copy embedded files between PDFs") ) ps_embed_copy.add_argument("input", type=str, help="PDF to receive embedded files") ps_embed_copy.add_argument("-password", help="password of input") ps_embed_copy.add_argument( "-output", help="output PDF, incremental save to 'input' if omitted" ) ps_embed_copy.add_argument( "-source", required=True, help="copy embedded files from here" ) ps_embed_copy.add_argument("-pwdsource", help="password of 'source' PDF") ps_embed_copy.add_argument( "-name", nargs="*", help="restrict copy to these entries" ) ps_embed_copy.set_defaults(func=embedded_copy) # ------------------------------------------------------------------------- # 'textlayout' command # ------------------------------------------------------------------------- ps_gettext = subps.add_parser( "gettext", description=mycenter("extract text in various formatting modes") ) ps_gettext.add_argument("input", type=str, help="input document filename") ps_gettext.add_argument("-password", help="password for input document") ps_gettext.add_argument( "-mode", type=str, help="mode: simple, block sort, or layout (default)", choices=("simple", "blocks", "layout"), default="layout", ) ps_gettext.add_argument( "-pages", type=str, help="select pages, format: 1,5-7,50-N", default="1-N", ) ps_gettext.add_argument( "-noligatures", action="store_true", help="expand ligature characters (default False)", default=False, ) ps_gettext.add_argument( "-convert-white", action="store_true", help="convert whitespace characters to white (default False)", default=False, ) ps_gettext.add_argument( "-extra-spaces", action="store_true", help="fill gaps with spaces (default False)", default=False, ) ps_gettext.add_argument( "-noformfeed", action="store_true", help="write linefeeds, no formfeeds (default False)", default=False, ) ps_gettext.add_argument( "-skip-empty", action="store_true", help="suppress pages with no text (default False)", default=False, ) ps_gettext.add_argument( "-output", help="store text in this file (default inputfilename.txt)", ) ps_gettext.add_argument( "-grid", type=float, help="merge lines if closer than this (default 2)", default=2, ) ps_gettext.add_argument( "-fontsize", type=float, help="only include text with a larger fontsize (default 3)", default=3, ) ps_gettext.set_defaults(func=gettext) # ------------------------------------------------------------------------- # start program # ------------------------------------------------------------------------- args = parser.parse_args() # create parameter arguments class if not hasattr(args, "func"): # no function selected parser.print_help() # so print top level help else: args.func(args) # execute requested command if __name__ == "__main__": main() ================================================ FILE: src_classic/_config.h ================================================ // Copyright (C) 2004-2021 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 // // Alternative licensing terms are available from the licensor. // For commercial licensing, see or contact // Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco, // CA 94129, USA, for further information. #ifndef FZ_CONFIG_H #define FZ_CONFIG_H /** Enable the following for spot (and hence overprint/overprint simulation) capable rendering. This forces FZ_PLOTTERS_N on. */ /* #define FZ_ENABLE_SPOT_RENDERING 1 */ /** Choose which plotters we need. By default we build all the plotters in. To avoid building plotters in that aren't needed, define the unwanted FZ_PLOTTERS_... define to 0. */ /* #define FZ_PLOTTERS_G 1 */ /* #define FZ_PLOTTERS_RGB 1 */ /* #define FZ_PLOTTERS_CMYK 1 */ /* #define FZ_PLOTTERS_N 1 */ /** Choose which document agents to include. By default all are enabled. To avoid building unwanted ones, define FZ_ENABLE_... to 0. */ /* #define FZ_ENABLE_PDF 1 */ /* #define FZ_ENABLE_XPS 1 */ /* #define FZ_ENABLE_SVG 1 */ /* #define FZ_ENABLE_CBZ 1 */ /* #define FZ_ENABLE_IMG 1 */ /* #define FZ_ENABLE_HTML 1 */ /* #define FZ_ENABLE_EPUB 1 */ /** Choose which document writers to include. By default all are enabled. To avoid building unwanted ones, define FZ_ENABLE_..._OUTPUT to 0. */ /* #define FZ_ENABLE_OCR_OUTPUT 1 */ /* #define FZ_ENABLE_DOCX_OUTPUT 1 */ /* #define FZ_ENABLE_ODT_OUTPUT 1 */ /** Choose whether to enable ICC color profiles. */ /* #define FZ_ENABLE_ICC 1 */ /** Choose whether to enable JPEG2000 decoding. By default, it is enabled, but due to frequent security issues with the third party libraries we support disabling it with this flag. */ /* #define FZ_ENABLE_JPX 1 */ /** Choose whether to enable JavaScript. By default JavaScript is enabled both for mutool and PDF interactivity. */ /* #define FZ_ENABLE_JS 1 */ /** Choose which fonts to include. By default we include the base 14 PDF fonts, DroidSansFallback from Android for CJK, and Charis SIL from SIL for epub/html. Enable the following defines to AVOID including unwanted fonts. */ /* To avoid all noto fonts except CJK, enable: */ /* #define TOFU */ /* To skip the CJK font, enable: (this implicitly enables TOFU_CJK_EXT * and TOFU_CJK_LANG) */ /* #define TOFU_CJK */ /* To skip CJK Extension A, enable: (this implicitly enables * TOFU_CJK_LANG) */ #define TOFU_CJK_EXT 1 /* To skip CJK language specific fonts, enable: */ /* #define TOFU_CJK_LANG */ /* To skip the Emoji font, enable: */ /* #define TOFU_EMOJI */ /* To skip the ancient/historic scripts, enable: */ /* #define TOFU_HISTORIC */ /* To skip the symbol font, enable: */ /* #define TOFU_SYMBOL */ /* To skip the SIL fonts, enable: */ /* #define TOFU_SIL */ /* To skip the Base14 fonts, enable: */ /* #define TOFU_BASE14 */ /* (You probably really don't want to do that except for measurement * purposes!) */ /* ---------- DO NOT EDIT ANYTHING UNDER THIS LINE ---------- */ #ifndef FZ_ENABLE_SPOT_RENDERING #define FZ_ENABLE_SPOT_RENDERING 1 #endif #if FZ_ENABLE_SPOT_RENDERING #undef FZ_PLOTTERS_N #define FZ_PLOTTERS_N 1 #endif /* FZ_ENABLE_SPOT_RENDERING */ #ifndef FZ_PLOTTERS_G #define FZ_PLOTTERS_G 1 #endif /* FZ_PLOTTERS_G */ #ifndef FZ_PLOTTERS_RGB #define FZ_PLOTTERS_RGB 1 #endif /* FZ_PLOTTERS_RGB */ #ifndef FZ_PLOTTERS_CMYK #define FZ_PLOTTERS_CMYK 1 #endif /* FZ_PLOTTERS_CMYK */ #ifndef FZ_PLOTTERS_N #define FZ_PLOTTERS_N 1 #endif /* FZ_PLOTTERS_N */ /* We need at least 1 plotter defined */ #if FZ_PLOTTERS_G == 0 && FZ_PLOTTERS_RGB == 0 && FZ_PLOTTERS_CMYK == 0 #undef FZ_PLOTTERS_N #define FZ_PLOTTERS_N 1 #endif #ifndef FZ_ENABLE_PDF #define FZ_ENABLE_PDF 1 #endif /* FZ_ENABLE_PDF */ #ifndef FZ_ENABLE_XPS #define FZ_ENABLE_XPS 1 #endif /* FZ_ENABLE_XPS */ #ifndef FZ_ENABLE_SVG #define FZ_ENABLE_SVG 1 #endif /* FZ_ENABLE_SVG */ #ifndef FZ_ENABLE_CBZ #define FZ_ENABLE_CBZ 1 #endif /* FZ_ENABLE_CBZ */ #ifndef FZ_ENABLE_IMG #define FZ_ENABLE_IMG 1 #endif /* FZ_ENABLE_IMG */ #ifndef FZ_ENABLE_HTML #define FZ_ENABLE_HTML 1 #endif /* FZ_ENABLE_HTML */ #ifndef FZ_ENABLE_EPUB #define FZ_ENABLE_EPUB 1 #endif /* FZ_ENABLE_EPUB */ #ifndef FZ_ENABLE_OCR_OUTPUT #define FZ_ENABLE_OCR_OUTPUT 1 #endif /* FZ_ENABLE_OCR_OUTPUT */ #ifndef FZ_ENABLE_ODT_OUTPUT #define FZ_ENABLE_ODT_OUTPUT 1 #endif /* FZ_ENABLE_ODT_OUTPUT */ #ifndef FZ_ENABLE_DOCX_OUTPUT #define FZ_ENABLE_DOCX_OUTPUT 1 #endif /* FZ_ENABLE_DOCX_OUTPUT */ #ifndef FZ_ENABLE_JPX #define FZ_ENABLE_JPX 1 #endif /* FZ_ENABLE_JPX */ #ifndef FZ_ENABLE_JS #define FZ_ENABLE_JS 1 #endif /* FZ_ENABLE_JS */ #ifndef FZ_ENABLE_ICC #define FZ_ENABLE_ICC 1 #endif /* FZ_ENABLE_ICC */ /* If Epub and HTML are both disabled, disable SIL fonts */ #if FZ_ENABLE_HTML == 0 && FZ_ENABLE_EPUB == 0 #undef TOFU_SIL #define TOFU_SIL #endif #if !defined(HAVE_LEPTONICA) || !defined(HAVE_TESSERACT) #ifndef OCR_DISABLED #define OCR_DISABLED #endif #endif #endif /* FZ_CONFIG_H */ ================================================ FILE: src_classic/fitz_old.i ================================================ %module fitz %pythonbegin %{ %} //------------------------------------------------------------------------ // SWIG macros: handle fitz exceptions //------------------------------------------------------------------------ %define FITZEXCEPTION(meth, cond) %exception meth { $action if (cond) { return JM_ReturnException(gctx); } } %enddef %define FITZEXCEPTION2(meth, cond) %exception meth { $action if (cond) { const char *msg = fz_caught_message(gctx); if (strcmp(msg, MSG_BAD_FILETYPE) == 0) { PyErr_SetString(PyExc_ValueError, msg); } else { PyErr_SetString(JM_Exc_FileDataError, MSG_BAD_DOCUMENT); } return NULL; } } %enddef //------------------------------------------------------------------------ // SWIG macro: check that a document is not closed / encrypted //------------------------------------------------------------------------ %define CLOSECHECK(meth, doc) %pythonprepend meth %{doc if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted")%} %enddef %define CLOSECHECK0(meth, doc) %pythonprepend meth%{doc if self.is_closed: raise ValueError("document closed")%} %enddef //------------------------------------------------------------------------ // SWIG macro: check if object has a valid parent //------------------------------------------------------------------------ %define PARENTCHECK(meth, doc) %pythonprepend meth %{doc CheckParent(self)%} %enddef //------------------------------------------------------------------------ // SWIG macro: ensure object still exists //------------------------------------------------------------------------ %define ENSURE_OWNERSHIP(meth, doc) %pythonprepend meth %{doc EnsureOwnership(self)%} %enddef %include "mupdf/fitz/version.h" %{ #define MEMDEBUG 0 #if MEMDEBUG == 1 #define DEBUGMSG1(x) PySys_WriteStderr("[DEBUG] free %s ", x) #define DEBUGMSG2 PySys_WriteStderr("... done!\n") #else #define DEBUGMSG1(x) #define DEBUGMSG2 #endif #ifndef FLT_EPSILON #define FLT_EPSILON 1e-5 #endif #define SWIG_FILE_WITH_INIT // JM_MEMORY controls what allocators we tell MuPDF to use when we call // fz_new_context(): // // JM_MEMORY=0: MuPDF uses malloc()/free(). // JM_MEMORY=1: MuPDF uses PyMem_Malloc()/PyMem_Free(). // // There are also a small number of places where we call malloc() or // PyMem_Malloc() ourselves, depending on JM_MEMORY. // #define JM_MEMORY 0 #if JM_MEMORY == 1 #define JM_Alloc(type, len) PyMem_New(type, len) #define JM_Free(x) PyMem_Del(x) #else #define JM_Alloc(type, len) (type *) malloc(sizeof(type)*len) #define JM_Free(x) free(x) #endif #define EMPTY_STRING PyUnicode_FromString("") #define EXISTS(x) (x != NULL && PyObject_IsTrue(x)==1) #define RAISEPY(context, msg, exc) {JM_Exc_CurrentException=exc; fz_throw(context, FZ_ERROR_GENERIC, msg);} #define ASSERT_PDF(cond) if (cond == NULL) RAISEPY(gctx, MSG_IS_NO_PDF, PyExc_RuntimeError) #define ENSURE_OPERATION(ctx, pdf) if (!JM_have_operation(ctx, pdf)) RAISEPY(ctx, "No journalling operation started", PyExc_RuntimeError) #define INRANGE(v, low, high) ((low) <= v && v <= (high)) #define JM_BOOL(x) PyBool_FromLong((long) (x)) #define JM_PyErr_Clear if (PyErr_Occurred()) PyErr_Clear() #define JM_StrAsChar(x) (char *)PyUnicode_AsUTF8(x) #define JM_BinFromChar(x) PyBytes_FromString(x) #define JM_BinFromCharSize(x, y) PyBytes_FromStringAndSize(x, (Py_ssize_t) y) #include #include #include // freetype includes >> -------------------------------------------------- #include #include FT_FREETYPE_H #ifdef FT_FONT_FORMATS_H #include FT_FONT_FORMATS_H #else #include FT_XFREE86_H #endif #include FT_TRUETYPE_TABLES_H #ifndef FT_SFNT_HEAD #define FT_SFNT_HEAD ft_sfnt_head #endif // << freetype includes -------------------------------------------------- void JM_delete_widget(fz_context *ctx, pdf_page *page, pdf_annot *annot); static void JM_get_page_labels(fz_context *ctx, PyObject *liste, pdf_obj *nums); static int DICT_SETITEMSTR_DROP(PyObject *dict, const char *key, PyObject *value); static int LIST_APPEND_DROP(PyObject *list, PyObject *item); static int LIST_APPEND_DROP(PyObject *list, PyObject *item); static fz_irect JM_irect_from_py(PyObject *r); static fz_matrix JM_matrix_from_py(PyObject *m); static fz_point JM_normalize_vector(float x, float y); static fz_point JM_point_from_py(PyObject *p); static fz_quad JM_quad_from_py(PyObject *r); static fz_rect JM_rect_from_py(PyObject *r); static int JM_FLOAT_ITEM(PyObject *obj, Py_ssize_t idx, double *result); static int JM_INT_ITEM(PyObject *obj, Py_ssize_t idx, int *result); static PyObject *JM_py_from_irect(fz_irect r); static PyObject *JM_py_from_matrix(fz_matrix m); static PyObject *JM_py_from_point(fz_point p); static PyObject *JM_py_from_quad(fz_quad q); static PyObject *JM_py_from_rect(fz_rect r); static void show(const char* prefix, PyObject* obj); // additional headers ---------------------------------------------- #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR == 23 && FZ_VERSION_PATCH < 8 pdf_obj *pdf_lookup_page_loc(fz_context *ctx, pdf_document *doc, int needle, pdf_obj **parentp, int *indexp); fz_pixmap *fz_scale_pixmap(fz_context *ctx, fz_pixmap *src, float x, float y, float w, float h, const fz_irect *clip); int fz_pixmap_size(fz_context *ctx, fz_pixmap *src); void fz_subsample_pixmap(fz_context *ctx, fz_pixmap *tile, int factor); void fz_copy_pixmap_rect(fz_context *ctx, fz_pixmap *dest, fz_pixmap *src, fz_irect b, const fz_default_colorspaces *default_cs); void fz_write_pixmap_as_jpeg(fz_context *ctx, fz_output *out, fz_pixmap *pix, int jpg_quality); #endif static const float JM_font_ascender(fz_context *ctx, fz_font *font); static const float JM_font_descender(fz_context *ctx, fz_font *font); // end of additional headers -------------------------------------------- static PyObject *JM_mupdf_warnings_store; static int JM_mupdf_show_errors; static int JM_mupdf_show_warnings; static PyObject *JM_Exc_FileDataError; static PyObject *JM_Exc_CurrentException; %} //------------------------------------------------------------------------ // global context //------------------------------------------------------------------------ %init %{ #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 /* Stop Memento backtraces if we reach the Python interpreter. `cfunction_call()` isn't the only way that Python calls C though, so we might need extra calls to Memento_addBacktraceLimitFnname(). We put this inside `#ifdef MEMENTO` because memento.h's disabling macro causes "warning: statement with no effect" from cc. */ #ifdef MEMENTO Memento_addBacktraceLimitFnname("cfunction_call"); #endif #endif /* We end up with Memento leaks from fz_new_context()'s allocs even when our atexit handler calls fz_drop_context(), so remove these from Memento's accounting. */ Memento_startLeaking(); #if JM_MEMORY == 1 gctx = fz_new_context(&JM_Alloc_Context, NULL, FZ_STORE_DEFAULT); #else gctx = fz_new_context(NULL, NULL, FZ_STORE_DEFAULT); #endif Memento_stopLeaking(); if(!gctx) { PyErr_SetString(PyExc_RuntimeError, "Fatal error: cannot create global context."); return NULL; } fz_register_document_handlers(gctx); //------------------------------------------------------------------------ // START redirect stdout/stderr //------------------------------------------------------------------------ JM_mupdf_warnings_store = PyList_New(0); JM_mupdf_show_errors = 1; JM_mupdf_show_warnings = 0; char user[] = "PyMuPDF"; fz_set_warning_callback(gctx, JM_mupdf_warning, &user); fz_set_error_callback(gctx, JM_mupdf_error, &user); JM_Exc_FileDataError = NULL; JM_Exc_CurrentException = PyExc_RuntimeError; //------------------------------------------------------------------------ // STOP redirect stdout/stderr //------------------------------------------------------------------------ // init global constants //------------------------------------------------------------------------ dictkey_align = PyUnicode_InternFromString("align"); dictkey_ascender = PyUnicode_InternFromString("ascender"); dictkey_bbox = PyUnicode_InternFromString("bbox"); dictkey_blocks = PyUnicode_InternFromString("blocks"); dictkey_bpc = PyUnicode_InternFromString("bpc"); dictkey_c = PyUnicode_InternFromString("c"); dictkey_chars = PyUnicode_InternFromString("chars"); dictkey_color = PyUnicode_InternFromString("color"); dictkey_colorspace = PyUnicode_InternFromString("colorspace"); dictkey_content = PyUnicode_InternFromString("content"); dictkey_creationDate = PyUnicode_InternFromString("creationDate"); dictkey_cs_name = PyUnicode_InternFromString("cs-name"); dictkey_da = PyUnicode_InternFromString("da"); dictkey_dashes = PyUnicode_InternFromString("dashes"); dictkey_desc = PyUnicode_InternFromString("desc"); dictkey_desc = PyUnicode_InternFromString("descender"); dictkey_descender = PyUnicode_InternFromString("descender"); dictkey_dir = PyUnicode_InternFromString("dir"); dictkey_effect = PyUnicode_InternFromString("effect"); dictkey_ext = PyUnicode_InternFromString("ext"); dictkey_filename = PyUnicode_InternFromString("filename"); dictkey_fill = PyUnicode_InternFromString("fill"); dictkey_flags = PyUnicode_InternFromString("flags"); dictkey_font = PyUnicode_InternFromString("font"); dictkey_glyph = PyUnicode_InternFromString("glyph"); dictkey_height = PyUnicode_InternFromString("height"); dictkey_id = PyUnicode_InternFromString("id"); dictkey_image = PyUnicode_InternFromString("image"); dictkey_items = PyUnicode_InternFromString("items"); dictkey_length = PyUnicode_InternFromString("length"); dictkey_lines = PyUnicode_InternFromString("lines"); dictkey_matrix = PyUnicode_InternFromString("transform"); dictkey_modDate = PyUnicode_InternFromString("modDate"); dictkey_name = PyUnicode_InternFromString("name"); dictkey_number = PyUnicode_InternFromString("number"); dictkey_origin = PyUnicode_InternFromString("origin"); dictkey_rect = PyUnicode_InternFromString("rect"); dictkey_size = PyUnicode_InternFromString("size"); dictkey_smask = PyUnicode_InternFromString("smask"); dictkey_spans = PyUnicode_InternFromString("spans"); dictkey_stroke = PyUnicode_InternFromString("stroke"); dictkey_style = PyUnicode_InternFromString("style"); dictkey_subject = PyUnicode_InternFromString("subject"); dictkey_text = PyUnicode_InternFromString("text"); dictkey_title = PyUnicode_InternFromString("title"); dictkey_type = PyUnicode_InternFromString("type"); dictkey_ufilename = PyUnicode_InternFromString("ufilename"); dictkey_width = PyUnicode_InternFromString("width"); dictkey_wmode = PyUnicode_InternFromString("wmode"); dictkey_xref = PyUnicode_InternFromString("xref"); dictkey_xres = PyUnicode_InternFromString("xres"); dictkey_yres = PyUnicode_InternFromString("yres"); atexit( cleanup); %} %header %{ fz_context *gctx; static void cleanup() { fz_drop_context( gctx); } static int JM_UNIQUE_ID = 0; struct DeviceWrapper { fz_device *device; fz_display_list *list; }; %} //------------------------------------------------------------------------ // include version information and several other helpers //------------------------------------------------------------------------ %pythoncode %{ import sys import io import math import os import weakref import hashlib import typing import binascii import re import tarfile import zipfile import pathlib import string # PDF names must not contain these characters: INVALID_NAME_CHARS = set(string.whitespace + "()<>[]{}/%" + chr(0)) TESSDATA_PREFIX = os.getenv("TESSDATA_PREFIX") point_like = "point_like" rect_like = "rect_like" matrix_like = "matrix_like" quad_like = "quad_like" # ByteString is gone from typing in 3.14. # collections.abc.Buffer available from 3.12 only try: ByteString = typing.ByteString except AttributeError: ByteString = bytes | bytearray | memoryview AnyType = typing.Any OptInt = typing.Union[int, None] OptFloat = typing.Optional[float] OptStr = typing.Optional[str] OptDict = typing.Optional[dict] OptBytes = typing.Optional[ByteString] OptSeq = typing.Optional[typing.Sequence] try: from pymupdf_fonts import fontdescriptors, fontbuffers fitz_fontdescriptors = fontdescriptors.copy() for k in fitz_fontdescriptors.keys(): fitz_fontdescriptors[k]["loader"] = fontbuffers[k] del fontdescriptors, fontbuffers except ImportError: fitz_fontdescriptors = {} %} %include version.i %include helper-git-versions.i %include helper-defines.i %include helper-globals.i %include helper-geo-c.i %include helper-other.i %include helper-pixmap.i %include helper-geo-py.i %include helper-annot.i %include helper-fields.i %include helper-python.i %include helper-portfolio.i %include helper-select.i %include helper-stext.i %include helper-xobject.i %include helper-pdfinfo.i %include helper-convert.i %include helper-fileobj.i %include helper-devices.i %{ // Declaring these structs here prevents gcc from generating warnings like: // // warning: 'struct Document' declared inside parameter list will not be visible outside of this definition or declaration // struct Colorspace; struct Document; struct Font; struct Graftmap; struct TextPage; struct TextWriter; struct DocumentWriter; struct Xml; struct Archive; struct Story; %} //------------------------------------------------------------------------ // fz_document //------------------------------------------------------------------------ struct Document { %extend { ~Document() { DEBUGMSG1("Document"); fz_document *this_doc = (fz_document *) $self; fz_drop_document(gctx, this_doc); DEBUGMSG2; } FITZEXCEPTION2(Document, !result) %pythonprepend Document %{ """Creates a document. Use 'open' as a synonym. Notes: Basic usages: open() - new PDF document open(filename) - string, pathlib.Path, or file object. open(filename, fileype=type) - overwrite filename extension. open(type, buffer) - type: extension, buffer: bytes object. open(stream=buffer, filetype=type) - keyword version of previous. Parameters rect, width, height, fontsize: layout reflowable document on open (e.g. EPUB). Ignored if n/a. """ self.is_closed = False self.is_encrypted = False self.isEncrypted = False self.metadata = None self.FontInfos = [] self.Graftmaps = {} self.ShownPages = {} self.InsertedImages = {} self._page_refs = weakref.WeakValueDictionary() if not filename or type(filename) is str: pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name else: msg = "bad filename" raise TypeError(msg) if stream != None: if type(stream) is bytes: self.stream = stream elif type(stream) is bytearray: self.stream = bytes(stream) elif type(stream) is io.BytesIO: self.stream = stream.getvalue() else: msg = "bad type: 'stream'" raise TypeError(msg) stream = self.stream if not (filename or filetype): filename = "pdf" else: self.stream = None if filename and self.stream == None: self.name = filename from_file = True else: from_file = False self.name = "" if from_file: if not os.path.exists(filename): msg = f"no such file: '{filename}'" raise FileNotFoundError(msg) elif not os.path.isfile(filename): msg = f"'{filename}' is no file" raise FileDataError(msg) if from_file and os.path.getsize(filename) == 0 or type(self.stream) is bytes and len(self.stream) == 0: msg = "cannot open empty document" raise EmptyFileError(msg) %} %pythonappend Document %{ if self.thisown: self._graft_id = TOOLS.gen_id() if self.needs_pass is True: self.is_encrypted = True self.isEncrypted = True else: # we won't init until doc is decrypted self.init_doc() # the following hack detects invalid/empty SVG files, which else may lead # to interpreter crashes if filename and filename.lower().endswith("svg") or filetype and "svg" in filetype.lower(): try: _ = self.convert_to_pdf() # this seems to always work except: raise FileDataError("cannot open broken document") from None %} Document(const char *filename=NULL, PyObject *stream=NULL, const char *filetype=NULL, PyObject *rect=NULL, float width=0, float height=0, float fontsize=11) { int old_msg_option = JM_mupdf_show_errors; JM_mupdf_show_errors = 0; fz_document *doc = NULL; const fz_document_handler *handler; char *c = NULL; char *magic = NULL; size_t len = 0; fz_stream *data = NULL; float w = width, h = height; fz_rect r = JM_rect_from_py(rect); if (!fz_is_infinite_rect(r)) { w = r.x1 - r.x0; h = r.y1 - r.y0; } fz_try(gctx) { if (stream != Py_None) { // stream given, **MUST** be bytes! c = PyBytes_AS_STRING(stream); // just a pointer, no new obj len = (size_t) PyBytes_Size(stream); data = fz_open_memory(gctx, (const unsigned char *) c, len); magic = (char *)filename; if (!magic) magic = (char *)filetype; handler = fz_recognize_document(gctx, magic); if (!handler) { RAISEPY(gctx, MSG_BAD_FILETYPE, PyExc_ValueError); } doc = fz_open_document_with_stream(gctx, magic, data); } else { if (filename && strlen(filename)) { if (!filetype || strlen(filetype) == 0) { doc = fz_open_document(gctx, filename); } else { handler = fz_recognize_document(gctx, filetype); if (!handler) { RAISEPY(gctx, MSG_BAD_FILETYPE, PyExc_ValueError); } #if FZ_VERSION_MINOR >= 24 if (handler->open) { fz_stream* filename_stream = fz_open_file(gctx, filename); fz_try(gctx) { doc = handler->open(gctx, filename_stream, NULL, NULL); } fz_always(gctx) { fz_drop_stream(gctx, filename_stream); } fz_catch(gctx) { fz_rethrow(gctx); } } #else if (handler->open) { doc = handler->open(gctx, filename); } else if (handler->open_with_stream) { data = fz_open_file(gctx, filename); doc = handler->open_with_stream(gctx, data); } #endif } } else { pdf_document *pdf = pdf_create_document(gctx); doc = (fz_document *) pdf; } } } fz_always(gctx) { fz_drop_stream(gctx, data); } fz_catch(gctx) { JM_mupdf_show_errors = old_msg_option; return NULL; } if (w > 0 && h > 0) { fz_layout_document(gctx, doc, w, h, fontsize); } else if (fz_is_document_reflowable(gctx, doc)) { fz_layout_document(gctx, doc, 400, 600, 11); } return (struct Document *) doc; } FITZEXCEPTION(load_page, !result) %pythonprepend load_page %{ """Load a page. 'page_id' is either a 0-based page number or a tuple (chapter, pno), with chapter number and page number within that chapter. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if page_id is None: page_id = 0 if page_id not in self: raise ValueError("page not in document") if type(page_id) is int and page_id < 0: np = self.page_count while page_id < 0: page_id += np %} %pythonappend load_page %{ val.thisown = True val.parent = weakref.proxy(self) self._page_refs[id(val)] = val val._annot_refs = weakref.WeakValueDictionary() val.number = page_id %} struct Page * load_page(PyObject *page_id) { fz_page *page = NULL; fz_document *doc = (fz_document *) $self; int pno = 0, chapter = 0; fz_try(gctx) { if (PySequence_Check(page_id)) { if (JM_INT_ITEM(page_id, 0, &chapter) == 1) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } if (JM_INT_ITEM(page_id, 1, &pno) == 1) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } page = fz_load_chapter_page(gctx, doc, chapter, pno); } else { pno = (int) PyLong_AsLong(page_id); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } page = fz_load_page(gctx, doc, pno); } } fz_catch(gctx) { PyErr_Clear(); return NULL; } PyErr_Clear(); return (struct Page *) page; } FITZEXCEPTION(_remove_links_to, !result) PyObject *_remove_links_to(PyObject *numbers) { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); remove_dest_range(gctx, pdf, numbers); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } CLOSECHECK0(_loadOutline, """Load first outline.""") struct Outline *_loadOutline() { fz_outline *ol = NULL; fz_document *doc = (fz_document *) $self; fz_try(gctx) { ol = fz_load_outline(gctx, doc); } fz_catch(gctx) { return NULL; } return (struct Outline *) ol; } void _dropOutline(struct Outline *ol) { DEBUGMSG1("Outline"); fz_outline *this_ol = (fz_outline *) ol; fz_drop_outline(gctx, this_ol); DEBUGMSG2; } FITZEXCEPTION(_insert_font, !result) CLOSECHECK0(_insert_font, """Utility: insert font from file or binary.""") PyObject * _insert_font(char *fontfile=NULL, PyObject *fontbuffer=NULL) { PyObject *value=NULL; pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); fz_try(gctx) { ASSERT_PDF(pdf); if (!fontfile && !EXISTS(fontbuffer)) { RAISEPY(gctx, MSG_FILE_OR_BUFFER, PyExc_ValueError); } value = JM_insert_font(gctx, pdf, NULL, fontfile, fontbuffer, 0, 0, 0, 0, 0, -1); } fz_catch(gctx) { return NULL; } return value; } FITZEXCEPTION(get_outline_xrefs, !result) CLOSECHECK0(get_outline_xrefs, """Get list of outline xref numbers.""") PyObject * get_outline_xrefs() { PyObject *xrefs = PyList_New(0); pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); if (!pdf) { return xrefs; } fz_try(gctx) { pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); if (!root) goto finished; pdf_obj *olroot = pdf_dict_get(gctx, root, PDF_NAME(Outlines)); if (!olroot) goto finished; pdf_obj *first = pdf_dict_get(gctx, olroot, PDF_NAME(First)); if (!first) goto finished; xrefs = JM_outline_xrefs(gctx, first, xrefs); finished:; } fz_catch(gctx) { Py_DECREF(xrefs); return NULL; } return xrefs; } FITZEXCEPTION(xref_get_keys, !result) CLOSECHECK0(xref_get_keys, """Get the keys of PDF dict object at 'xref'. Use -1 for the PDF trailer.""") PyObject * xref_get_keys(int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); pdf_obj *obj=NULL; PyObject *rc = NULL; int i, n; fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref > 0) { obj = pdf_load_object(gctx, pdf, xref); } else { obj = pdf_trailer(gctx, pdf); } n = pdf_dict_len(gctx, obj); rc = PyTuple_New(n); if (!n) goto finished; for (i = 0; i < n; i++) { const char *key = pdf_to_name(gctx, pdf_dict_get_key(gctx, obj, i)); PyTuple_SET_ITEM(rc, i, Py_BuildValue("s", key)); } finished:; } fz_always(gctx) { if (xref > 0) { pdf_drop_obj(gctx, obj); } } fz_catch(gctx) { return NULL; } return rc; } FITZEXCEPTION(xref_get_key, !result) CLOSECHECK0(xref_get_key, """Get PDF dict key value of object at 'xref'.""") PyObject * xref_get_key(int xref, const char *key) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); pdf_obj *obj=NULL, *subobj=NULL; PyObject *rc = NULL; fz_buffer *res = NULL; PyObject *text = NULL; fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref > 0) { obj = pdf_load_object(gctx, pdf, xref); } else { obj = pdf_trailer(gctx, pdf); } if (!obj) { goto not_found; } subobj = pdf_dict_getp(gctx, obj, key); if (!subobj) { goto not_found; } char *type; if (pdf_is_indirect(gctx, subobj)) { type = "xref"; text = PyUnicode_FromFormat("%i 0 R", pdf_to_num(gctx, subobj)); } else if (pdf_is_array(gctx, subobj)) { type = "array"; } else if (pdf_is_dict(gctx, subobj)) { type = "dict"; } else if (pdf_is_int(gctx, subobj)) { type = "int"; text = PyUnicode_FromFormat("%i", pdf_to_int(gctx, subobj)); } else if (pdf_is_real(gctx, subobj)) { type = "float"; } else if (pdf_is_null(gctx, subobj)) { type = "null"; text = PyUnicode_FromString("null"); } else if (pdf_is_bool(gctx, subobj)) { type = "bool"; if (pdf_to_bool(gctx, subobj)) { text = PyUnicode_FromString("true"); } else { text = PyUnicode_FromString("false"); } } else if (pdf_is_name(gctx, subobj)) { type = "name"; text = PyUnicode_FromFormat("/%s", pdf_to_name(gctx, subobj)); } else if (pdf_is_string(gctx, subobj)) { type = "string"; text = JM_UnicodeFromStr(pdf_to_text_string(gctx, subobj)); } else { type = "unknown"; } if (!text) { res = JM_object_to_buffer(gctx, subobj, 1, 0); text = JM_UnicodeFromBuffer(gctx, res); } rc = Py_BuildValue("sO", type, text); Py_DECREF(text); goto finished; not_found:; rc = Py_BuildValue("ss", "null", "null"); finished:; } fz_always(gctx) { if (xref > 0) { pdf_drop_obj(gctx, obj); } fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return rc; } FITZEXCEPTION(xref_set_key, !result) %pythonprepend xref_set_key %{ """Set the value of a PDF dictionary key.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not key or not isinstance(key, str) or INVALID_NAME_CHARS.intersection(key) not in (set(), {"/"}): raise ValueError("bad 'key'") if not isinstance(value, str) or not value or value[0] == "/" and INVALID_NAME_CHARS.intersection(value[1:]) != set(): raise ValueError("bad 'value'") %} PyObject * xref_set_key(int xref, const char *key, char *value) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); pdf_obj *obj = NULL, *new_obj = NULL; int i, n; fz_try(gctx) { ASSERT_PDF(pdf); if (!key || strlen(key) == 0) { RAISEPY(gctx, "bad 'key'", PyExc_ValueError); } if (!value || strlen(value) == 0) { RAISEPY(gctx, "bad 'value'", PyExc_ValueError); } int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref != -1) { obj = pdf_load_object(gctx, pdf, xref); } else { obj = pdf_trailer(gctx, pdf); } // if val=="null" and no path hierarchy, delete "key" from object // chr(47) = "/" if (strcmp(value, "null") == 0 && strchr(key, 47) == NULL) { pdf_dict_dels(gctx, obj, key); goto finished; } new_obj = JM_set_object_value(gctx, obj, key, value); if (!new_obj) { goto finished; // did not work: skip update } if (xref != -1) { pdf_drop_obj(gctx, obj); obj = NULL; pdf_update_object(gctx, pdf, xref, new_obj); } else { n = pdf_dict_len(gctx, new_obj); for (i = 0; i < n; i++) { pdf_dict_put(gctx, obj, pdf_dict_get_key(gctx, new_obj, i), pdf_dict_get_val(gctx, new_obj, i)); } } finished:; } fz_always(gctx) { if (xref != -1) { pdf_drop_obj(gctx, obj); } pdf_drop_obj(gctx, new_obj); PyErr_Clear(); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_extend_toc_items, !result) CLOSECHECK0(_extend_toc_items, """Add color info to all items of an extended TOC list.""") PyObject * _extend_toc_items(PyObject *items) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *)$self); pdf_obj *bm, *col, *obj; int count, flags; PyObject *item=NULL, *itemdict=NULL, *xrefs, *bold, *italic, *collapse, *zoom; zoom = PyUnicode_FromString("zoom"); bold = PyUnicode_FromString("bold"); italic = PyUnicode_FromString("italic"); collapse = PyUnicode_FromString("collapse"); fz_try(gctx) { pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); if (!root) goto finished; pdf_obj *olroot = pdf_dict_get(gctx, root, PDF_NAME(Outlines)); if (!olroot) goto finished; pdf_obj *first = pdf_dict_get(gctx, olroot, PDF_NAME(First)); if (!first) goto finished; xrefs = PyList_New(0); // pre-allocate an empty list xrefs = JM_outline_xrefs(gctx, first, xrefs); Py_ssize_t i, n = PySequence_Size(xrefs), m = PySequence_Size(items); if (!n) goto finished; if (n != m) { RAISEPY(gctx, "internal error finding outline xrefs", PyExc_IndexError); } int xref; // update all TOC item dictionaries for (i = 0; i < n; i++) { JM_INT_ITEM(xrefs, i, &xref); item = PySequence_ITEM(items, i); itemdict = PySequence_ITEM(item, 3); if (!itemdict || !PyDict_Check(itemdict)) { RAISEPY(gctx, "need non-simple TOC format", PyExc_ValueError); } PyDict_SetItem(itemdict, dictkey_xref, PySequence_ITEM(xrefs, i)); bm = pdf_load_object(gctx, pdf, xref); flags = pdf_to_int(gctx, (pdf_dict_get(gctx, bm, PDF_NAME(F)))); if (flags == 1) { PyDict_SetItem(itemdict, italic, Py_True); } else if (flags == 2) { PyDict_SetItem(itemdict, bold, Py_True); } else if (flags == 3) { PyDict_SetItem(itemdict, italic, Py_True); PyDict_SetItem(itemdict, bold, Py_True); } count = pdf_to_int(gctx, (pdf_dict_get(gctx, bm, PDF_NAME(Count)))); if (count < 0) { PyDict_SetItem(itemdict, collapse, Py_True); } else if (count > 0) { PyDict_SetItem(itemdict, collapse, Py_False); } col = pdf_dict_get(gctx, bm, PDF_NAME(C)); if (pdf_is_array(gctx, col) && pdf_array_len(gctx, col) == 3) { PyObject *color = PyTuple_New(3); PyTuple_SET_ITEM(color, 0, Py_BuildValue("f", pdf_to_real(gctx, pdf_array_get(gctx, col, 0)))); PyTuple_SET_ITEM(color, 1, Py_BuildValue("f", pdf_to_real(gctx, pdf_array_get(gctx, col, 1)))); PyTuple_SET_ITEM(color, 2, Py_BuildValue("f", pdf_to_real(gctx, pdf_array_get(gctx, col, 2)))); DICT_SETITEM_DROP(itemdict, dictkey_color, color); } float z=0; obj = pdf_dict_get(gctx, bm, PDF_NAME(Dest)); if (!obj || !pdf_is_array(gctx, obj)) { obj = pdf_dict_getl(gctx, bm, PDF_NAME(A), PDF_NAME(D), NULL); } if (pdf_is_array(gctx, obj) && pdf_array_len(gctx, obj) == 5) { z = pdf_to_real(gctx, pdf_array_get(gctx, obj, 4)); } DICT_SETITEM_DROP(itemdict, zoom, Py_BuildValue("f", z)); PyList_SetItem(item, 3, itemdict); PyList_SetItem(items, i, item); pdf_drop_obj(gctx, bm); bm = NULL; } finished:; } fz_always(gctx) { Py_CLEAR(xrefs); Py_CLEAR(bold); Py_CLEAR(italic); Py_CLEAR(collapse); Py_CLEAR(zoom); pdf_drop_obj(gctx, bm); PyErr_Clear(); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // EmbeddedFiles utility functions //---------------------------------------------------------------- FITZEXCEPTION(_embfile_names, !result) CLOSECHECK0(_embfile_names, """Get list of embedded file names.""") PyObject *_embfile_names(PyObject *namelist) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); fz_try(gctx) { ASSERT_PDF(pdf); PyObject *val; pdf_obj *names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); if (pdf_is_array(gctx, names)) { int i, n = pdf_array_len(gctx, names); for (i=0; i < n; i+=2) { val = JM_EscapeStrFromStr(pdf_to_text_string(gctx, pdf_array_get(gctx, names, i))); LIST_APPEND_DROP(namelist, val); } } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_embfile_del, !result) PyObject *_embfile_del(int idx) { fz_try(gctx) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); pdf_obj *names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); pdf_array_delete(gctx, names, idx + 1); pdf_array_delete(gctx, names, idx); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_embfile_info, !result) PyObject *_embfile_info(int idx, PyObject *infodict) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); char *name; int xref = 0, ci_xref=0; fz_try(gctx) { pdf_obj *names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); pdf_obj *o = pdf_array_get(gctx, names, 2*idx+1); pdf_obj *ci = pdf_dict_get(gctx, o, PDF_NAME(CI)); if (ci) { ci_xref = pdf_to_num(gctx, ci); } DICT_SETITEMSTR_DROP(infodict, "collection", Py_BuildValue("i", ci_xref)); name = (char *) pdf_to_text_string(gctx, pdf_dict_get(gctx, o, PDF_NAME(F))); DICT_SETITEM_DROP(infodict, dictkey_filename, JM_EscapeStrFromStr(name)); name = (char *) pdf_to_text_string(gctx, pdf_dict_get(gctx, o, PDF_NAME(UF))); DICT_SETITEM_DROP(infodict, dictkey_ufilename, JM_EscapeStrFromStr(name)); name = (char *) pdf_to_text_string(gctx, pdf_dict_get(gctx, o, PDF_NAME(Desc))); DICT_SETITEM_DROP(infodict, dictkey_desc, JM_UnicodeFromStr(name)); int len = -1, DL = -1; pdf_obj *fileentry = pdf_dict_getl(gctx, o, PDF_NAME(EF), PDF_NAME(F), NULL); xref = pdf_to_num(gctx, fileentry); o = pdf_dict_get(gctx, fileentry, PDF_NAME(Length)); if (o) len = pdf_to_int(gctx, o); o = pdf_dict_get(gctx, fileentry, PDF_NAME(DL)); if (o) { DL = pdf_to_int(gctx, o); } else { o = pdf_dict_getl(gctx, fileentry, PDF_NAME(Params), PDF_NAME(Size), NULL); if (o) DL = pdf_to_int(gctx, o); } DICT_SETITEM_DROP(infodict, dictkey_size, Py_BuildValue("i", DL)); DICT_SETITEM_DROP(infodict, dictkey_length, Py_BuildValue("i", len)); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } FITZEXCEPTION(_embfile_upd, !result) PyObject *_embfile_upd(int idx, PyObject *buffer = NULL, char *filename = NULL, char *ufilename = NULL, char *desc = NULL) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); fz_buffer *res = NULL; fz_var(res); int xref = 0; fz_try(gctx) { pdf_obj *names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); pdf_obj *entry = pdf_array_get(gctx, names, 2*idx+1); pdf_obj *filespec = pdf_dict_getl(gctx, entry, PDF_NAME(EF), PDF_NAME(F), NULL); if (!filespec) { RAISEPY(gctx, "bad PDF: no /EF object", JM_Exc_FileDataError); } res = JM_BufferFromBytes(gctx, buffer); if (EXISTS(buffer) && !res) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_TypeError); } if (res && buffer != Py_None) { JM_update_stream(gctx, pdf, filespec, res, 1); // adjust /DL and /Size parameters int64_t len = (int64_t) fz_buffer_storage(gctx, res, NULL); pdf_obj *l = pdf_new_int(gctx, len); pdf_dict_put(gctx, filespec, PDF_NAME(DL), l); pdf_dict_putl(gctx, filespec, l, PDF_NAME(Params), PDF_NAME(Size), NULL); } xref = pdf_to_num(gctx, filespec); if (filename) pdf_dict_put_text_string(gctx, entry, PDF_NAME(F), filename); if (ufilename) pdf_dict_put_text_string(gctx, entry, PDF_NAME(UF), ufilename); if (desc) pdf_dict_put_text_string(gctx, entry, PDF_NAME(Desc), desc); } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) return NULL; return Py_BuildValue("i", xref); } FITZEXCEPTION(_embeddedFileGet, !result) PyObject *_embeddedFileGet(int idx) { fz_document *doc = (fz_document *) $self; PyObject *cont = NULL; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); fz_buffer *buf = NULL; fz_var(buf); fz_try(gctx) { pdf_obj *names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); pdf_obj *entry = pdf_array_get(gctx, names, 2*idx+1); pdf_obj *filespec = pdf_dict_getl(gctx, entry, PDF_NAME(EF), PDF_NAME(F), NULL); buf = pdf_load_stream(gctx, filespec); cont = JM_BinFromBuffer(gctx, buf); } fz_always(gctx) { fz_drop_buffer(gctx, buf); } fz_catch(gctx) { return NULL; } return cont; } FITZEXCEPTION(_embfile_add, !result) PyObject *_embfile_add(const char *name, PyObject *buffer, char *filename=NULL, char *ufilename=NULL, char *desc=NULL) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); fz_buffer *data = NULL; fz_var(data); pdf_obj *names = NULL; int xref = 0; // xref of file entry fz_try(gctx) { ASSERT_PDF(pdf); data = JM_BufferFromBytes(gctx, buffer); if (!data) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_TypeError); } names = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); if (!pdf_is_array(gctx, names)) { pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); names = pdf_new_array(gctx, pdf, 6); // an even number! pdf_dict_putl_drop(gctx, root, names, PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); } pdf_obj *fileentry = JM_embed_file(gctx, pdf, data, filename, ufilename, desc, 1); xref = pdf_to_num(gctx, pdf_dict_getl(gctx, fileentry, PDF_NAME(EF), PDF_NAME(F), NULL)); pdf_array_push_drop(gctx, names, pdf_new_text_string(gctx, name)); pdf_array_push_drop(gctx, names, fileentry); } fz_always(gctx) { fz_drop_buffer(gctx, data); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } %pythoncode %{ def embfile_names(self) -> list: """Get list of names of EmbeddedFiles.""" filenames = [] self._embfile_names(filenames) return filenames def _embeddedFileIndex(self, item: typing.Union[int, str]) -> int: filenames = self.embfile_names() msg = "'%s' not in EmbeddedFiles array." % str(item) if item in filenames: idx = filenames.index(item) elif item in range(len(filenames)): idx = item else: raise ValueError(msg) return idx def embfile_count(self) -> int: """Get number of EmbeddedFiles.""" return len(self.embfile_names()) def embfile_del(self, item: typing.Union[int, str]): """Delete an entry from EmbeddedFiles. Notes: The argument must be name or index of an EmbeddedFiles item. Physical deletion of data will happen on save to a new file with appropriate garbage option. Args: item: name or number of item. Returns: None """ idx = self._embeddedFileIndex(item) return self._embfile_del(idx) def embfile_info(self, item: typing.Union[int, str]) -> dict: """Get information of an item in the EmbeddedFiles array. Args: item: number or name of item. Returns: Information dictionary. """ idx = self._embeddedFileIndex(item) infodict = {"name": self.embfile_names()[idx]} xref = self._embfile_info(idx, infodict) t, date = self.xref_get_key(xref, "Params/CreationDate") if t != "null": infodict["creationDate"] = date t, date = self.xref_get_key(xref, "Params/ModDate") if t != "null": infodict["modDate"] = date t, md5 = self.xref_get_key(xref, "Params/CheckSum") if t != "null": infodict["checksum"] = binascii.hexlify(md5.encode()).decode() return infodict def embfile_get(self, item: typing.Union[int, str]) -> bytes: """Get the content of an item in the EmbeddedFiles array. Args: item: number or name of item. Returns: (bytes) The file content. """ idx = self._embeddedFileIndex(item) return self._embeddedFileGet(idx) def embfile_upd(self, item: typing.Union[int, str], buffer: OptBytes =None, filename: OptStr =None, ufilename: OptStr =None, desc: OptStr =None,) -> None: """Change an item of the EmbeddedFiles array. Notes: Only provided parameters are changed. If all are omitted, the method is a no-op. Args: item: number or name of item. buffer: (binary data) the new file content. filename: (str) the new file name. ufilename: (unicode) the new filen ame. desc: (str) the new description. """ idx = self._embeddedFileIndex(item) xref = self._embfile_upd(idx, buffer=buffer, filename=filename, ufilename=ufilename, desc=desc) date = get_pdf_now() self.xref_set_key(xref, "Params/ModDate", get_pdf_str(date)) return xref def embfile_add(self, name: str, buffer: ByteString, filename: OptStr =None, ufilename: OptStr =None, desc: OptStr =None,) -> None: """Add an item to the EmbeddedFiles array. Args: name: name of the new item, must not already exist. buffer: (binary data) the file content. filename: (str) the file name, default: the name ufilename: (unicode) the file name, default: filename desc: (str) the description. """ filenames = self.embfile_names() msg = "Name '%s' already exists." % str(name) if name in filenames: raise ValueError(msg) if filename is None: filename = name if ufilename is None: ufilename = unicode(filename, "utf8") if str is bytes else filename if desc is None: desc = name xref = self._embfile_add(name, buffer=buffer, filename=filename, ufilename=ufilename, desc=desc) date = get_pdf_now() self.xref_set_key(xref, "Type", "/EmbeddedFile") self.xref_set_key(xref, "Params/CreationDate", get_pdf_str(date)) self.xref_set_key(xref, "Params/ModDate", get_pdf_str(date)) return xref %} FITZEXCEPTION(convert_to_pdf, !result) %pythonprepend convert_to_pdf %{ """Convert document to a PDF, selecting page range and optional rotation. Output bytes object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") %} PyObject *convert_to_pdf(int from_page=0, int to_page=-1, int rotate=0) { PyObject *doc = NULL; fz_document *fz_doc = (fz_document *) $self; fz_try(gctx) { int fp = from_page, tp = to_page, srcCount = fz_count_pages(gctx, fz_doc); if (fp < 0) fp = 0; if (fp > srcCount - 1) fp = srcCount - 1; if (tp < 0) tp = srcCount - 1; if (tp > srcCount - 1) tp = srcCount - 1; Py_ssize_t len0 = PyList_Size(JM_mupdf_warnings_store); doc = JM_convert_to_pdf(gctx, fz_doc, fp, tp, rotate); Py_ssize_t len1 = PyList_Size(JM_mupdf_warnings_store); Py_ssize_t i = len0; while (i < len1) { PySys_WriteStderr("%s\n", JM_StrAsChar(PyList_GetItem(JM_mupdf_warnings_store, i))); i++; } } fz_catch(gctx) { return NULL; } if (doc) { return doc; } Py_RETURN_NONE; } FITZEXCEPTION(page_count, !result) CLOSECHECK0(page_count, """Number of pages.""") %pythoncode%{@property%} PyObject *page_count() { PyObject *ret; fz_try(gctx) { ret = PyLong_FromLong((long) fz_count_pages(gctx, (fz_document *) $self)); } fz_catch(gctx) { PyErr_Clear(); return NULL; } return ret; } FITZEXCEPTION(chapter_count, !result) CLOSECHECK0(chapter_count, """Number of chapters.""") %pythoncode%{@property%} PyObject *chapter_count() { PyObject *ret; fz_try(gctx) { ret = PyLong_FromLong((long) fz_count_chapters(gctx, (fz_document *) $self)); } fz_catch(gctx) { return NULL; } return ret; } FITZEXCEPTION(last_location, !result) CLOSECHECK0(last_location, """Id (chapter, page) of last page.""") %pythoncode%{@property%} PyObject *last_location() { fz_document *this_doc = (fz_document *) $self; fz_location last_loc; fz_try(gctx) { last_loc = fz_last_page(gctx, this_doc); } fz_catch(gctx) { return NULL; } return Py_BuildValue("ii", last_loc.chapter, last_loc.page); } FITZEXCEPTION(chapter_page_count, !result) CLOSECHECK0(chapter_page_count, """Page count of chapter.""") PyObject *chapter_page_count(int chapter) { long pages = 0; fz_try(gctx) { int chapters = fz_count_chapters(gctx, (fz_document *) $self); if (chapter < 0 || chapter >= chapters) { RAISEPY(gctx, "bad chapter number", PyExc_ValueError); } pages = (long) fz_count_chapter_pages(gctx, (fz_document *) $self, chapter); } fz_catch(gctx) { return NULL; } return PyLong_FromLong(pages); } FITZEXCEPTION(prev_location, !result) %pythonprepend prev_location %{ """Get (chapter, page) of previous page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(page_id) is int: page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") if page_id == (0, 0): return () %} PyObject *prev_location(PyObject *page_id) { fz_document *this_doc = (fz_document *) $self; fz_location prev_loc, loc; PyObject *val; int pno; fz_try(gctx) { val = PySequence_GetItem(page_id, 0); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } int chapter = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } val = PySequence_GetItem(page_id, 1); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } pno = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } loc = fz_make_location(chapter, pno); prev_loc = fz_previous_page(gctx, this_doc, loc); } fz_catch(gctx) { PyErr_Clear(); return NULL; } return Py_BuildValue("ii", prev_loc.chapter, prev_loc.page); } FITZEXCEPTION(next_location, !result) %pythonprepend next_location %{ """Get (chapter, page) of next page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(page_id) is int: page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") if tuple(page_id) == self.last_location: return () %} PyObject *next_location(PyObject *page_id) { fz_document *this_doc = (fz_document *) $self; fz_location next_loc, loc; PyObject *val; int pno; fz_try(gctx) { val = PySequence_GetItem(page_id, 0); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } int chapter = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } val = PySequence_GetItem(page_id, 1); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } pno = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } loc = fz_make_location(chapter, pno); next_loc = fz_next_page(gctx, this_doc, loc); } fz_catch(gctx) { PyErr_Clear(); return NULL; } return Py_BuildValue("ii", next_loc.chapter, next_loc.page); } FITZEXCEPTION(location_from_page_number, !result) CLOSECHECK0(location_from_page_number, """Convert pno to (chapter, page).""") PyObject *location_from_page_number(int pno) { fz_document *this_doc = (fz_document *) $self; fz_location loc = fz_make_location(-1, -1); int page_count = fz_count_pages(gctx, this_doc); while (pno < 0) pno += page_count; fz_try(gctx) { if (pno >= page_count) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } loc = fz_location_from_page_number(gctx, this_doc, pno); } fz_catch(gctx) { return NULL; } return Py_BuildValue("ii", loc.chapter, loc.page); } FITZEXCEPTION(page_number_from_location, !result) %pythonprepend page_number_from_location%{ """Convert (chapter, pno) to page number.""" if type(page_id) is int: np = self.page_count while page_id < 0: page_id += np page_id = (0, page_id) if page_id not in self: raise ValueError("page id not in document") %} PyObject *page_number_from_location(PyObject *page_id) { fz_document *this_doc = (fz_document *) $self; fz_location loc; long page_n = -1; PyObject *val; int pno; fz_try(gctx) { val = PySequence_GetItem(page_id, 0); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } int chapter = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } val = PySequence_GetItem(page_id, 1); if (!val) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } pno = (int) PyLong_AsLong(val); Py_DECREF(val); if (PyErr_Occurred()) { RAISEPY(gctx, MSG_BAD_PAGEID, PyExc_ValueError); } loc = fz_make_location(chapter, pno); page_n = (long) fz_page_number_from_location(gctx, this_doc, loc); } fz_catch(gctx) { PyErr_Clear(); return NULL; } return PyLong_FromLong(page_n); } FITZEXCEPTION(_getMetadata, !result) CLOSECHECK0(_getMetadata, """Get metadata.""") PyObject * _getMetadata(const char *key) { PyObject *res = NULL; fz_document *doc = (fz_document *) $self; int vsize; char *value; fz_try(gctx) { vsize = fz_lookup_metadata(gctx, doc, key, NULL, 0)+1; if(vsize > 1) { value = JM_Alloc(char, vsize); fz_lookup_metadata(gctx, doc, key, value, vsize); res = JM_UnicodeFromStr(value); JM_Free(value); } else { res = EMPTY_STRING; } } fz_always(gctx) { PyErr_Clear(); } fz_catch(gctx) { return EMPTY_STRING; } return res; } CLOSECHECK0(needs_pass, """Indicate password required.""") %pythoncode%{@property%} PyObject *needs_pass() { return JM_BOOL(fz_needs_password(gctx, (fz_document *) $self)); } %pythoncode%{@property%} CLOSECHECK0(language, """Document language.""") PyObject *language() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_NONE; fz_text_language lang = pdf_document_language(gctx, pdf); char buf[8]; if (lang == FZ_LANG_UNSET) Py_RETURN_NONE; return PyUnicode_FromString(fz_string_from_text_language(buf, lang)); } FITZEXCEPTION(set_language, !result) PyObject *set_language(char *language=NULL) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); fz_text_language lang; if (!language) lang = FZ_LANG_UNSET; else lang = fz_text_language_from_string(language); pdf_set_document_language(gctx, pdf, lang); } fz_catch(gctx) { return NULL; } Py_RETURN_TRUE; } %pythonprepend resolve_link %{ """Calculate internal link destination. Args: uri: (str) some Link.uri chapters: (bool) whether to use (chapter, page) format Returns: (page_id, x, y) where x, y are point coordinates on the page. page_id is either page number (if chapters=0), or (chapter, pno). """ %} PyObject *resolve_link(char *uri=NULL, int chapters=0) { if (!uri) { if (chapters) return Py_BuildValue("(ii)ff", -1, -1, 0, 0); return Py_BuildValue("iff", -1, 0, 0); } fz_document *this_doc = (fz_document *) $self; float xp = 0, yp = 0; fz_location loc = {0, 0}; fz_try(gctx) { loc = fz_resolve_link(gctx, (fz_document *) $self, uri, &xp, &yp); } fz_catch(gctx) { if (chapters) return Py_BuildValue("(ii)ff", -1, -1, 0, 0); return Py_BuildValue("iff", -1, 0, 0); } if (chapters) return Py_BuildValue("(ii)ff", loc.chapter, loc.page, xp, yp); int pno = fz_page_number_from_location(gctx, this_doc, loc); return Py_BuildValue("iff", pno, xp, yp); } FITZEXCEPTION(layout, !result) CLOSECHECK(layout, """Re-layout a reflowable document.""") %pythonappend layout %{ self._reset_page_refs() self.init_doc()%} PyObject *layout(PyObject *rect = NULL, float width = 0, float height = 0, float fontsize = 11) { fz_document *doc = (fz_document *) $self; if (!fz_is_document_reflowable(gctx, doc)) Py_RETURN_NONE; fz_try(gctx) { float w = width, h = height; fz_rect r = JM_rect_from_py(rect); if (!fz_is_infinite_rect(r)) { w = r.x1 - r.x0; h = r.y1 - r.y0; } if (w <= 0.0f || h <= 0.0f) { RAISEPY(gctx, "bad page size", PyExc_ValueError); } fz_layout_document(gctx, doc, w, h, fontsize); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(make_bookmark, !result) CLOSECHECK(make_bookmark, """Make a page pointer before layouting document.""") PyObject *make_bookmark(PyObject *loc) { fz_document *doc = (fz_document *) $self; fz_location location; fz_bookmark mark; fz_try(gctx) { if (JM_INT_ITEM(loc, 0, &location.chapter) == 1) { RAISEPY(gctx, MSG_BAD_LOCATION, PyExc_ValueError); } if (JM_INT_ITEM(loc, 1, &location.page) == 1) { RAISEPY(gctx, MSG_BAD_LOCATION, PyExc_ValueError); } mark = fz_make_bookmark(gctx, doc, location); if (!mark) { RAISEPY(gctx, MSG_BAD_LOCATION, PyExc_ValueError); } } fz_catch(gctx) { return NULL; } return PyLong_FromVoidPtr((void *) mark); } FITZEXCEPTION(find_bookmark, !result) CLOSECHECK(find_bookmark, """Find new location after layouting a document.""") PyObject *find_bookmark(PyObject *bm) { fz_document *doc = (fz_document *) $self; fz_location location; fz_try(gctx) { intptr_t mark = (intptr_t) PyLong_AsVoidPtr(bm); location = fz_lookup_bookmark(gctx, doc, mark); } fz_catch(gctx) { return NULL; } return Py_BuildValue("ii", location.chapter, location.page); } CLOSECHECK0(is_reflowable, """Check if document is layoutable.""") %pythoncode%{@property%} PyObject *is_reflowable() { return JM_BOOL(fz_is_document_reflowable(gctx, (fz_document *) $self)); } FITZEXCEPTION(_deleteObject, !result) CLOSECHECK0(_deleteObject, """Delete object.""") PyObject *_deleteObject(int xref) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); fz_try(gctx) { ASSERT_PDF(pdf); if (!INRANGE(xref, 1, pdf_xref_len(gctx, pdf)-1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } pdf_delete_object(gctx, pdf, xref); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(pdf_catalog, !result) CLOSECHECK0(pdf_catalog, """Get xref of PDF catalog.""") PyObject *pdf_catalog() { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); int xref = 0; if (!pdf) return Py_BuildValue("i", xref); fz_try(gctx) { pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); xref = pdf_to_num(gctx, root); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } FITZEXCEPTION(_getPDFfileid, !result) CLOSECHECK0(_getPDFfileid, """Get PDF file id.""") PyObject *_getPDFfileid() { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); if (!pdf) Py_RETURN_NONE; PyObject *idlist = PyList_New(0); fz_buffer *buffer = NULL; unsigned char *hex; pdf_obj *o; int n, i, len; PyObject *bytes; fz_try(gctx) { pdf_obj *identity = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(ID)); if (identity) { n = pdf_array_len(gctx, identity); for (i = 0; i < n; i++) { o = pdf_array_get(gctx, identity, i); len = (int) pdf_to_str_len(gctx, o); buffer = fz_new_buffer(gctx, 2 * len); fz_buffer_storage(gctx, buffer, &hex); hexlify(len, (unsigned char *) pdf_to_text_string(gctx, o), hex); LIST_APPEND_DROP(idlist, JM_UnicodeFromStr(hex)); Py_CLEAR(bytes); fz_drop_buffer(gctx, buffer); buffer = NULL; } } } fz_catch(gctx) { fz_drop_buffer(gctx, buffer); } return idlist; } CLOSECHECK0(version_count, """Count versions of PDF document.""") %pythoncode%{@property%} PyObject *version_count() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) return Py_BuildValue("i", 0); return Py_BuildValue("i", pdf_count_versions(gctx, pdf)); } CLOSECHECK0(is_pdf, """Check for PDF.""") %pythoncode%{@property%} PyObject *is_pdf() { if (pdf_specifics(gctx, (fz_document *) $self)) Py_RETURN_TRUE; else Py_RETURN_FALSE; } #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR <= 21 /* The underlying struct members that these methods give access to, are not available. */ CLOSECHECK0(has_xref_streams, """Check if xref table is a stream.""") %pythoncode%{@property%} PyObject *has_xref_streams() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; if (pdf->has_xref_streams) Py_RETURN_TRUE; Py_RETURN_FALSE; } CLOSECHECK0(has_old_style_xrefs, """Check if xref table is old style.""") %pythoncode%{@property%} PyObject *has_old_style_xrefs() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; if (pdf->has_old_style_xrefs) Py_RETURN_TRUE; Py_RETURN_FALSE; } #endif CLOSECHECK0(is_dirty, """True if PDF has unsaved changes.""") %pythoncode%{@property%} PyObject *is_dirty() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; return JM_BOOL(pdf_has_unsaved_changes(gctx, pdf)); } CLOSECHECK0(can_save_incrementally, """Check whether incremental saves are possible.""") PyObject *can_save_incrementally() { pdf_document *pdf = pdf_document_from_fz_document(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; // gracefully handle non-PDF return JM_BOOL(pdf_can_be_saved_incrementally(gctx, pdf)); } CLOSECHECK0(is_fast_webaccess, """Check whether we have a linearized PDF.""") %pythoncode%{@property%} PyObject *is_fast_webaccess() { pdf_document *pdf = pdf_document_from_fz_document(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; // gracefully handle non-PDF return JM_BOOL(pdf_doc_was_linearized(gctx, pdf)); } CLOSECHECK0(is_repaired, """Check whether PDF was repaired.""") %pythoncode%{@property%} PyObject *is_repaired() { pdf_document *pdf = pdf_document_from_fz_document(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; // gracefully handle non-PDF return JM_BOOL(pdf_was_repaired(gctx, pdf)); } FITZEXCEPTION(save_snapshot, !result) %pythonprepend save_snapshot %{ """Save a file snapshot suitable for journalling.""" if self.is_closed: raise ValueError("doc is closed") if type(filename) == str: pass elif hasattr(filename, "open"): # assume: pathlib.Path filename = str(filename) elif hasattr(filename, "name"): # assume: file object filename = filename.name else: raise ValueError("filename must be str, Path or file object") if filename == self.name: raise ValueError("cannot snapshot to original") %} PyObject *save_snapshot(const char *filename) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); pdf_save_snapshot(gctx, pdf, filename); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } CLOSECHECK0(authenticate, """Decrypt document.""") %pythonappend authenticate %{ if val: # the doc is decrypted successfully and we init the outline self.is_encrypted = False self.isEncrypted = False self.init_doc() self.thisown = True %} PyObject *authenticate(char *password) { return Py_BuildValue("i", fz_authenticate_password(gctx, (fz_document *) $self, (const char *) password)); } //------------------------------------------------------------------ // save a PDF //------------------------------------------------------------------ FITZEXCEPTION(save, !result) %pythonprepend save %{ """Save PDF to file, pathlib.Path or file pointer.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if type(filename) == str: pass elif hasattr(filename, "open"): # assume: pathlib.Path filename = str(filename) elif hasattr(filename, "name"): # assume: file object filename = filename.name elif not hasattr(filename, "seek"): # assume file object raise ValueError("filename must be str, Path or file object") if filename == self.name and not incremental: raise ValueError("save to original must be incremental") if self.page_count < 1: raise ValueError("cannot save with zero pages") if incremental: if self.name != filename or self.stream: raise ValueError("incremental needs original file") if user_pw and len(user_pw) > 40 or owner_pw and len(owner_pw) > 40: raise ValueError("password length must not exceed 40") %} PyObject * save(PyObject *filename, int garbage=0, int clean=0, int deflate=0, int deflate_images=0, int deflate_fonts=0, int incremental=0, int ascii=0, int expand=0, int linear=0, int no_new_id=0, int appearance=0, int pretty=0, int encryption=1, int permissions=4095, char *owner_pw=NULL, char *user_pw=NULL) { pdf_write_options opts = pdf_default_write_options; opts.do_incremental = incremental; opts.do_ascii = ascii; opts.do_compress = deflate; opts.do_compress_images = deflate_images; opts.do_compress_fonts = deflate_fonts; opts.do_decompress = expand; opts.do_garbage = garbage; opts.do_pretty = pretty; opts.do_linear = linear; opts.do_clean = clean; opts.do_sanitize = clean; opts.dont_regenerate_id = no_new_id; opts.do_appearance = appearance; opts.do_encrypt = encryption; opts.permissions = permissions; if (owner_pw) { memcpy(&opts.opwd_utf8, owner_pw, strlen(owner_pw)+1); } else if (user_pw) { memcpy(&opts.opwd_utf8, user_pw, strlen(user_pw)+1); } if (user_pw) { memcpy(&opts.upwd_utf8, user_pw, strlen(user_pw)+1); } fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); fz_output *out = NULL; fz_try(gctx) { ASSERT_PDF(pdf); pdf->resynth_required = 0; JM_embedded_clean(gctx, pdf); if (no_new_id == 0) { JM_ensure_identity(gctx, pdf); } if (PyUnicode_Check(filename)) { pdf_save_document(gctx, pdf, JM_StrAsChar(filename), &opts); } else { out = JM_new_output_fileptr(gctx, filename); pdf_write_document(gctx, pdf, out, &opts); } } fz_always(gctx) { fz_drop_output(gctx, out); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def write(self, garbage=False, clean=False, deflate=False, deflate_images=False, deflate_fonts=False, incremental=False, ascii=False, expand=False, linear=False, no_new_id=False, appearance=False, pretty=False, encryption=1, permissions=4095, owner_pw=None, user_pw=None): from io import BytesIO bio = BytesIO() self.save(bio, garbage=garbage, clean=clean, no_new_id=no_new_id, appearance=appearance, deflate=deflate, deflate_images=deflate_images, deflate_fonts=deflate_fonts, incremental=incremental, ascii=ascii, expand=expand, linear=linear, pretty=pretty, encryption=encryption, permissions=permissions, owner_pw=owner_pw, user_pw=user_pw) return bio.getvalue() %} //---------------------------------------------------------------- // Insert pages from a source PDF into this PDF. // For reconstructing the links (_do_links method), we must save the // insertion point (start_at) if it was specified as -1. //---------------------------------------------------------------- FITZEXCEPTION(insert_pdf, !result) %pythonprepend insert_pdf %{ """Insert a page range from another PDF. Args: docsrc: PDF to copy from. Must be different object, but may be same file. from_page: (int) first source page to copy, 0-based, default 0. to_page: (int) last source page to copy, 0-based, default last page. start_at: (int) from_page will become this page number in target. rotate: (int) rotate copied pages, default -1 is no change. links: (int/bool) whether to also copy links. annots: (int/bool) whether to also copy annotations. show_progress: (int) progress message interval, 0 is no messages. final: (bool) indicates last insertion from this source PDF. _gmap: internal use only Copy sequence reversed if from_page > to_page.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self._graft_id == docsrc._graft_id: raise ValueError("source and target cannot be same object") sa = start_at if sa < 0: sa = self.page_count if len(docsrc) > show_progress > 0: inname = os.path.basename(docsrc.name) if not inname: inname = "memory PDF" outname = os.path.basename(self.name) if not outname: outname = "memory PDF" print("Inserting '%s' at '%s'" % (inname, outname)) # retrieve / make a Graftmap to avoid duplicate objects isrt = docsrc._graft_id _gmap = self.Graftmaps.get(isrt, None) if _gmap is None: _gmap = Graftmap(self) self.Graftmaps[isrt] = _gmap %} %pythonappend insert_pdf %{ self._reset_page_refs() if links: self._do_links(docsrc, from_page = from_page, to_page = to_page, start_at = sa) if final == 1: self.Graftmaps[isrt] = None%} PyObject * insert_pdf(struct Document *docsrc, int from_page=-1, int to_page=-1, int start_at=-1, int rotate=-1, int links=1, int annots=1, int show_progress=0, int final = 1, struct Graftmap *_gmap=NULL) { fz_document *doc = (fz_document *) $self; fz_document *src = (fz_document *) docsrc; pdf_document *pdfout = pdf_specifics(gctx, doc); pdf_document *pdfsrc = pdf_specifics(gctx, src); int outCount = fz_count_pages(gctx, doc); int srcCount = fz_count_pages(gctx, src); // local copies of page numbers int fp = from_page, tp = to_page, sa = start_at; // normalize page numbers fp = Py_MAX(fp, 0); // -1 = first page fp = Py_MIN(fp, srcCount - 1); // but do not exceed last page if (tp < 0) tp = srcCount - 1; // -1 = last page tp = Py_MIN(tp, srcCount - 1); // but do not exceed last page if (sa < 0) sa = outCount; // -1 = behind last page sa = Py_MIN(sa, outCount); // but that is also the limit fz_try(gctx) { if (!pdfout || !pdfsrc) { RAISEPY(gctx, "source or target not a PDF", PyExc_TypeError); } ENSURE_OPERATION(gctx, pdfout); JM_merge_range(gctx, pdfout, pdfsrc, fp, tp, sa, rotate, links, annots, show_progress, (pdf_graft_map *) _gmap); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def insert_file(self, infile, from_page=-1, to_page=-1, start_at=-1, rotate=-1, links=True, annots=True,show_progress=0, final=1): """Insert an arbitrary supported document to an existing PDF. The infile may be given as a filename, a Document or a Pixmap. Other paramters - where applicable - equal those of insert_pdf(). """ src = None if isinstance(infile, Pixmap): if infile.colorspace.n > 3: infile = Pixmap(csRGB, infile) src = Document("png", infile.tobytes()) elif isinstance(infile, Document): src = infile else: src = Document(infile) if not src: raise ValueError("bad infile parameter") if not src.is_pdf: pdfbytes = src.convert_to_pdf() src = Document("pdf", pdfbytes) return self.insert_pdf(src, from_page=from_page, to_page=to_page, start_at=start_at, rotate=rotate,links=links, annots=annots, show_progress=show_progress, final=final) %} //------------------------------------------------------------------ // Create and insert a new page (PDF) //------------------------------------------------------------------ FITZEXCEPTION(_newPage, !result) CLOSECHECK(_newPage, """Make a new PDF page.""") %pythonappend _newPage %{self._reset_page_refs()%} PyObject *_newPage(int pno=-1, float width=595, float height=842) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_rect mediabox = fz_unit_rect; mediabox.x1 = width; mediabox.y1 = height; pdf_obj *resources = NULL, *page_obj = NULL; fz_buffer *contents = NULL; fz_var(contents); fz_var(page_obj); fz_var(resources); fz_try(gctx) { ASSERT_PDF(pdf); if (pno < -1) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } ENSURE_OPERATION(gctx, pdf); // create /Resources and /Contents objects resources = pdf_add_new_dict(gctx, pdf, 1); page_obj = pdf_add_page(gctx, pdf, mediabox, 0, resources, contents); pdf_insert_page(gctx, pdf, pno, page_obj); } fz_always(gctx) { fz_drop_buffer(gctx, contents); pdf_drop_obj(gctx, page_obj); pdf_drop_obj(gctx, resources); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // Create sub-document to keep only selected pages. // Parameter is a Python sequence of the wanted page numbers. //------------------------------------------------------------------ FITZEXCEPTION(select, !result) %pythonprepend select %{"""Build sub-pdf with page numbers in the list.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: raise ValueError("is no PDF") if not hasattr(pyliste, "__getitem__"): raise ValueError("sequence required") if len(pyliste) == 0 or min(pyliste) not in range(len(self)) or max(pyliste) not in range(len(self)): raise ValueError("bad page number(s)") pyliste = tuple(pyliste)%} %pythonappend select %{self._reset_page_refs()%} PyObject *select(PyObject *pyliste) { // preparatory stuff: // (1) get underlying pdf document, // (2) transform Python list into integer array pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); int *pages = NULL; fz_try(gctx) { // call retainpages (code copy of fz_clean_file.c) int i, len = (int) PyTuple_Size(pyliste); pages = fz_realloc_array(gctx, pages, len, int); for (i = 0; i < len; i++) { pages[i] = (int) PyLong_AsLong(PyTuple_GET_ITEM(pyliste, (Py_ssize_t) i)); } pdf_rearrange_pages(gctx, pdf, len, pages); if (pdf->rev_page_map) { pdf_drop_page_tree(gctx, pdf); } } fz_always(gctx) { fz_free(gctx, pages); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // remove one page //------------------------------------------------------------------ FITZEXCEPTION(_delete_page, !result) PyObject *_delete_page(int pno) { fz_try(gctx) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); pdf_delete_page(gctx, pdf, pno); if (pdf->rev_page_map) { pdf_drop_page_tree(gctx, pdf); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // get document permissions //------------------------------------------------------------------ %pythoncode%{@property%} %pythonprepend permissions %{ """Document permissions.""" if self.is_encrypted: return 0 %} PyObject *permissions() { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_document_from_fz_document(gctx, doc); // for PDF return result of standard function if (pdf) return Py_BuildValue("i", pdf_document_permissions(gctx, pdf)); // otherwise simulate the PDF return value int perm = (int) 0xFFFFFFFC; // all permissions granted // now switch off where needed if (!fz_has_permission(gctx, doc, FZ_PERMISSION_PRINT)) perm = perm ^ PDF_PERM_PRINT; if (!fz_has_permission(gctx, doc, FZ_PERMISSION_EDIT)) perm = perm ^ PDF_PERM_MODIFY; if (!fz_has_permission(gctx, doc, FZ_PERMISSION_COPY)) perm = perm ^ PDF_PERM_COPY; if (!fz_has_permission(gctx, doc, FZ_PERMISSION_ANNOTATE)) perm = perm ^ PDF_PERM_ANNOTATE; return Py_BuildValue("i", perm); } FITZEXCEPTION(journal_enable, !result) CLOSECHECK(journal_enable, """Activate document journalling.""") PyObject *journal_enable() { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); pdf_enable_journal(gctx, pdf); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(journal_start_op, !result) CLOSECHECK(journal_start_op, """Begin a journalling operation.""") PyObject *journal_start_op(const char *name=NULL) { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); if (!pdf->journal) { RAISEPY(gctx, "Journalling not enabled", PyExc_RuntimeError); } if (name) { pdf_begin_operation(gctx, pdf, name); } else { pdf_begin_implicit_operation(gctx, pdf); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(journal_stop_op, !result) CLOSECHECK(journal_stop_op, """End a journalling operation.""") PyObject *journal_stop_op() { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); pdf_end_operation(gctx, pdf); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(journal_position, !result) CLOSECHECK(journal_position, """Show journalling state.""") PyObject *journal_position() { int rc, steps=0; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); rc = pdf_undoredo_state(gctx, pdf, &steps); } fz_catch(gctx) { return NULL; } return Py_BuildValue("ii", rc, steps); } FITZEXCEPTION(journal_op_name, !result) CLOSECHECK(journal_op_name, """Show operation name for given step.""") PyObject *journal_op_name(int step) { const char *name=NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); name = pdf_undoredo_step(gctx, pdf, step); } fz_catch(gctx) { return NULL; } if (name) { return PyUnicode_FromString(name); } else { Py_RETURN_NONE; } } FITZEXCEPTION(journal_can_do, !result) CLOSECHECK(journal_can_do, """Show if undo and / or redo are possible.""") PyObject *journal_can_do() { int undo=0, redo=0; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); undo = pdf_can_undo(gctx, pdf); redo = pdf_can_redo(gctx, pdf); } fz_catch(gctx) { return NULL; } return Py_BuildValue("{s:N,s:N}", "undo", JM_BOOL(undo), "redo", JM_BOOL(redo)); } FITZEXCEPTION(journal_undo, !result) CLOSECHECK(journal_undo, """Move backwards in the journal.""") PyObject *journal_undo() { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); pdf_undo(gctx, pdf); } fz_catch(gctx) { return NULL; } Py_RETURN_TRUE; } FITZEXCEPTION(journal_redo, !result) CLOSECHECK(journal_redo, """Move forward in the journal.""") PyObject *journal_redo() { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); pdf_redo(gctx, pdf); } fz_catch(gctx) { return NULL; } Py_RETURN_TRUE; } FITZEXCEPTION(journal_save, !result) CLOSECHECK(journal_save, """Save journal to a file.""") PyObject *journal_save(PyObject *filename) { fz_output *out = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); if (PyUnicode_Check(filename)) { pdf_save_journal(gctx, pdf, (const char *) PyUnicode_AsUTF8(filename)); } else { out = JM_new_output_fileptr(gctx, filename); pdf_write_journal(gctx, pdf, out); } } fz_always(gctx) { fz_drop_output(gctx, out); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(journal_load, !result) CLOSECHECK(journal_load, """Load a journal from a file.""") PyObject *journal_load(PyObject *filename) { fz_buffer *res = NULL; fz_stream *stm = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); if (PyUnicode_Check(filename)) { pdf_load_journal(gctx, pdf, PyUnicode_AsUTF8(filename)); } else { res = JM_BufferFromBytes(gctx, filename); stm = fz_open_buffer(gctx, res); pdf_deserialise_journal(gctx, pdf, stm); } if (!pdf->journal) { RAISEPY(gctx, "Journal and document do not match", JM_Exc_FileDataError); } } fz_always(gctx) { fz_drop_stream(gctx, stm); fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(journal_is_enabled, !result) CLOSECHECK(journal_is_enabled, """Check if journalling is enabled.""") PyObject *journal_is_enabled() { int enabled = 0; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); enabled = pdf && pdf->journal; } fz_catch(gctx) { return NULL; } return JM_BOOL(enabled); } FITZEXCEPTION(_get_char_widths, !result) CLOSECHECK(_get_char_widths, """Return list of glyphs and glyph widths of a font.""") PyObject *_get_char_widths(int xref, char *bfname, char *ext, int ordering, int limit, int idx = 0) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); PyObject *wlist = NULL; int i, glyph, mylimit; mylimit = limit; if (mylimit < 256) mylimit = 256; const unsigned char *data; int size, index; fz_font *font = NULL; fz_buffer *buf = NULL; fz_try(gctx) { ASSERT_PDF(pdf); if (ordering >= 0) { data = fz_lookup_cjk_font(gctx, ordering, &size, &index); font = fz_new_font_from_memory(gctx, NULL, data, size, index, 0); goto weiter; } data = fz_lookup_base14_font(gctx, bfname, &size); if (data) { font = fz_new_font_from_memory(gctx, bfname, data, size, 0, 0); goto weiter; } buf = JM_get_fontbuffer(gctx, pdf, xref); if (!buf) { fz_throw(gctx, FZ_ERROR_GENERIC, "font at xref %d is not supported", xref); } font = fz_new_font_from_buffer(gctx, NULL, buf, idx, 0); weiter:; wlist = PyList_New(0); float adv; for (i = 0; i < mylimit; i++) { glyph = fz_encode_character(gctx, font, i); adv = fz_advance_glyph(gctx, font, glyph, 0); if (ordering >= 0) { glyph = i; } if (glyph > 0) { LIST_APPEND_DROP(wlist, Py_BuildValue("if", glyph, adv)); } else { LIST_APPEND_DROP(wlist, Py_BuildValue("if", glyph, 0.0)); } } } fz_always(gctx) { fz_drop_buffer(gctx, buf); fz_drop_font(gctx, font); } fz_catch(gctx) { return NULL; } return wlist; } FITZEXCEPTION(page_xref, !result) CLOSECHECK0(page_xref, """Get xref of page number.""") PyObject *page_xref(int pno) { fz_document *this_doc = (fz_document *) $self; int page_count = fz_count_pages(gctx, this_doc); int n = pno; while (n < 0) n += page_count; pdf_document *pdf = pdf_specifics(gctx, this_doc); int xref = 0; fz_try(gctx) { if (n >= page_count) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } ASSERT_PDF(pdf); xref = pdf_to_num(gctx, pdf_lookup_page_obj(gctx, pdf, n)); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } FITZEXCEPTION(page_annot_xrefs, !result) CLOSECHECK0(page_annot_xrefs, """Get list annotations of page number.""") PyObject *page_annot_xrefs(int pno) { fz_document *this_doc = (fz_document *) $self; int page_count = fz_count_pages(gctx, this_doc); int n = pno; while (n < 0) n += page_count; pdf_document *pdf = pdf_specifics(gctx, this_doc); PyObject *annots = NULL; fz_try(gctx) { if (n >= page_count) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } ASSERT_PDF(pdf); annots = JM_get_annot_xref_list(gctx, pdf_lookup_page_obj(gctx, pdf, n)); } fz_catch(gctx) { return NULL; } return annots; } FITZEXCEPTION(page_cropbox, !result) CLOSECHECK0(page_cropbox, """Get CropBox of page number (without loading page).""") %pythonappend page_cropbox %{val = Rect(JM_TUPLE3(val))%} PyObject *page_cropbox(int pno) { fz_document *this_doc = (fz_document *) $self; int page_count = fz_count_pages(gctx, this_doc); int n = pno; while (n < 0) n += page_count; pdf_obj *pageref = NULL; fz_var(pageref); pdf_document *pdf = pdf_specifics(gctx, this_doc); fz_try(gctx) { if (n >= page_count) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } ASSERT_PDF(pdf); pageref = pdf_lookup_page_obj(gctx, pdf, n); } fz_catch(gctx) { return NULL; } return JM_py_from_rect(JM_cropbox(gctx, pageref)); } FITZEXCEPTION(_getPageInfo, !result) CLOSECHECK(_getPageInfo, """List fonts, images, XObjects used on a page.""") PyObject *_getPageInfo(int pno, int what) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); pdf_obj *pageref, *rsrc; PyObject *liste = NULL, *tracer = NULL; fz_var(liste); fz_var(tracer); fz_try(gctx) { int page_count = fz_count_pages(gctx, doc); int n = pno; // pno < 0 is allowed while (n < 0) n += page_count; // make it non-negative if (n >= page_count) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } ASSERT_PDF(pdf); pageref = pdf_lookup_page_obj(gctx, pdf, n); rsrc = pdf_dict_get_inheritable(gctx, pageref, PDF_NAME(Resources)); liste = PyList_New(0); tracer = PyList_New(0); if (rsrc) { JM_scan_resources(gctx, pdf, rsrc, liste, what, 0, tracer); } } fz_always(gctx) { Py_CLEAR(tracer); } fz_catch(gctx) { Py_CLEAR(liste); return NULL; } return liste; } FITZEXCEPTION(extract_font, !result) CLOSECHECK(extract_font, """Get a font by xref. Returns a tuple or dictionary.""") PyObject *extract_font(int xref=0, int info_only=0, PyObject *named=NULL) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); } fz_catch(gctx) { return NULL; } fz_buffer *buffer = NULL; pdf_obj *obj, *basefont, *bname; PyObject *bytes = NULL; char *ext = NULL; PyObject *rc; fz_try(gctx) { obj = pdf_load_object(gctx, pdf, xref); pdf_obj *type = pdf_dict_get(gctx, obj, PDF_NAME(Type)); pdf_obj *subtype = pdf_dict_get(gctx, obj, PDF_NAME(Subtype)); if(pdf_name_eq(gctx, type, PDF_NAME(Font)) && strncmp(pdf_to_name(gctx, subtype), "CIDFontType", 11) != 0) { basefont = pdf_dict_get(gctx, obj, PDF_NAME(BaseFont)); if (!basefont || pdf_is_null(gctx, basefont)) { bname = pdf_dict_get(gctx, obj, PDF_NAME(Name)); } else { bname = basefont; } ext = JM_get_fontextension(gctx, pdf, xref); if (strcmp(ext, "n/a") != 0 && !info_only) { buffer = JM_get_fontbuffer(gctx, pdf, xref); bytes = JM_BinFromBuffer(gctx, buffer); fz_drop_buffer(gctx, buffer); } else { bytes = Py_BuildValue("y", ""); } if (PyObject_Not(named)) { rc = PyTuple_New(4); PyTuple_SET_ITEM(rc, 0, JM_EscapeStrFromStr(pdf_to_name(gctx, bname))); PyTuple_SET_ITEM(rc, 1, JM_UnicodeFromStr(ext)); PyTuple_SET_ITEM(rc, 2, JM_UnicodeFromStr(pdf_to_name(gctx, subtype))); PyTuple_SET_ITEM(rc, 3, bytes); } else { rc = PyDict_New(); DICT_SETITEM_DROP(rc, dictkey_name, JM_EscapeStrFromStr(pdf_to_name(gctx, bname))); DICT_SETITEM_DROP(rc, dictkey_ext, JM_UnicodeFromStr(ext)); DICT_SETITEM_DROP(rc, dictkey_type, JM_UnicodeFromStr(pdf_to_name(gctx, subtype))); DICT_SETITEM_DROP(rc, dictkey_content, bytes); } } else { if (PyObject_Not(named)) { rc = Py_BuildValue("sssy", "", "", "", ""); } else { rc = PyDict_New(); DICT_SETITEM_DROP(rc, dictkey_name, Py_BuildValue("s", "")); DICT_SETITEM_DROP(rc, dictkey_ext, Py_BuildValue("s", "")); DICT_SETITEM_DROP(rc, dictkey_type, Py_BuildValue("s", "")); DICT_SETITEM_DROP(rc, dictkey_content, Py_BuildValue("y", "")); } } } fz_always(gctx) { pdf_drop_obj(gctx, obj); JM_PyErr_Clear; } fz_catch(gctx) { if (PyObject_Not(named)) { rc = Py_BuildValue("sssy", "invalid-name", "", "", ""); } else { rc = PyDict_New(); DICT_SETITEM_DROP(rc, dictkey_name, Py_BuildValue("s", "invalid-name")); DICT_SETITEM_DROP(rc, dictkey_ext, Py_BuildValue("s", "")); DICT_SETITEM_DROP(rc, dictkey_type, Py_BuildValue("s", "")); DICT_SETITEM_DROP(rc, dictkey_content, Py_BuildValue("y", "")); } } return rc; } FITZEXCEPTION(extract_image, !result) CLOSECHECK(extract_image, """Get image by xref. Returns a dictionary.""") PyObject *extract_image(int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); pdf_obj *obj = NULL; fz_buffer *res = NULL; fz_image *img = NULL; PyObject *rc = NULL; const char *ext = NULL; const char *cs_name = NULL; int img_type = 0, xres, yres, colorspace; int smask = 0, width, height, bpc; fz_compressed_buffer *cbuf = NULL; fz_var(img); fz_var(res); fz_var(obj); fz_try(gctx) { ASSERT_PDF(pdf); if (!INRANGE(xref, 1, pdf_xref_len(gctx, pdf)-1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } obj = pdf_new_indirect(gctx, pdf, xref, 0); pdf_obj *subtype = pdf_dict_get(gctx, obj, PDF_NAME(Subtype)); if (!pdf_name_eq(gctx, subtype, PDF_NAME(Image))) { RAISEPY(gctx, "not an image", PyExc_ValueError); } pdf_obj *o = pdf_dict_geta(gctx, obj, PDF_NAME(SMask), PDF_NAME(Mask)); if (o) smask = pdf_to_num(gctx, o); if (pdf_is_jpx_image(gctx, obj)) { img_type = FZ_IMAGE_JPX; res = pdf_load_stream(gctx, obj); ext = "jpx"; } if (JM_is_jbig2_image(gctx, obj)) { img_type = FZ_IMAGE_JBIG2; res = pdf_load_stream(gctx, obj); ext = "jb2"; } if (img_type == FZ_IMAGE_UNKNOWN) { res = pdf_load_raw_stream(gctx, obj); unsigned char *c = NULL; fz_buffer_storage(gctx, res, &c); img_type = fz_recognize_image_format(gctx, c); ext = JM_image_extension(img_type); } if (img_type == FZ_IMAGE_UNKNOWN) { fz_drop_buffer(gctx, res); res = NULL; img = pdf_load_image(gctx, pdf, obj); cbuf = fz_compressed_image_buffer(gctx, img); if (cbuf && cbuf->params.type != FZ_IMAGE_RAW && cbuf->params.type != FZ_IMAGE_FAX && cbuf->params.type != FZ_IMAGE_FLATE && cbuf->params.type != FZ_IMAGE_LZW && cbuf->params.type != FZ_IMAGE_RLD) { img_type = cbuf->params.type; ext = JM_image_extension(img_type); res = cbuf->buffer; } else { res = fz_new_buffer_from_image_as_png(gctx, img, fz_default_color_params); ext = "png"; } } else { img = fz_new_image_from_buffer(gctx, res); } fz_image_resolution(img, &xres, &yres); width = img->w; height = img->h; colorspace = img->n; bpc = img->bpc; cs_name = fz_colorspace_name(gctx, img->colorspace); rc = PyDict_New(); DICT_SETITEM_DROP(rc, dictkey_ext, JM_UnicodeFromStr(ext)); DICT_SETITEM_DROP(rc, dictkey_smask, Py_BuildValue("i", smask)); DICT_SETITEM_DROP(rc, dictkey_width, Py_BuildValue("i", width)); DICT_SETITEM_DROP(rc, dictkey_height, Py_BuildValue("i", height)); DICT_SETITEM_DROP(rc, dictkey_colorspace, Py_BuildValue("i", colorspace)); DICT_SETITEM_DROP(rc, dictkey_bpc, Py_BuildValue("i", bpc)); DICT_SETITEM_DROP(rc, dictkey_xres, Py_BuildValue("i", xres)); DICT_SETITEM_DROP(rc, dictkey_yres, Py_BuildValue("i", yres)); DICT_SETITEM_DROP(rc, dictkey_cs_name, JM_UnicodeFromStr(cs_name)); DICT_SETITEM_DROP(rc, dictkey_image, JM_BinFromBuffer(gctx, res)); } fz_always(gctx) { fz_drop_image(gctx, img); if (!cbuf) fz_drop_buffer(gctx, res); pdf_drop_obj(gctx, obj); } fz_catch(gctx) { Py_CLEAR(rc); fz_warn(gctx, "%s", fz_caught_message(gctx)); Py_RETURN_FALSE; } if (!rc) Py_RETURN_NONE; return rc; } //------------------------------------------------------------------ // Delete all bookmarks (table of contents) // returns list of deleted (now available) xref numbers //------------------------------------------------------------------ CLOSECHECK(_delToC, """Delete the TOC.""") %pythonappend _delToC %{self.init_doc()%} PyObject *_delToC() { PyObject *xrefs = PyList_New(0); // create Python list pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) return xrefs; // not a pdf pdf_obj *root, *olroot, *first; int xref_count, olroot_xref, i, xref; // get the main root root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); // get the outline root olroot = pdf_dict_get(gctx, root, PDF_NAME(Outlines)); if (!olroot) return xrefs; // no outlines or some problem first = pdf_dict_get(gctx, olroot, PDF_NAME(First)); // first outline xrefs = JM_outline_xrefs(gctx, first, xrefs); xref_count = (int) PyList_Size(xrefs); olroot_xref = pdf_to_num(gctx, olroot); // delete OL root pdf_delete_object(gctx, pdf, olroot_xref); // delete OL root pdf_dict_del(gctx, root, PDF_NAME(Outlines)); // delete OL root for (i = 0; i < xref_count; i++) { JM_INT_ITEM(xrefs, i, &xref); pdf_delete_object(gctx, pdf, xref); // delete outline item } LIST_APPEND_DROP(xrefs, Py_BuildValue("i", olroot_xref)); return xrefs; } //------------------------------------------------------------------ // Check: is xref a stream object? //------------------------------------------------------------------ CLOSECHECK0(xref_is_stream, """Check if xref is a stream object.""") PyObject *xref_is_stream(int xref=0) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; // not a PDF return JM_BOOL(pdf_obj_num_is_stream(gctx, pdf, xref)); } //------------------------------------------------------------------ // Return or set NeedAppearances //------------------------------------------------------------------ %pythonprepend need_appearances %{"""Get/set the NeedAppearances value.""" if self.is_closed: raise ValueError("document closed") if not self.is_form_pdf: return None %} PyObject *need_appearances(PyObject *value=NULL) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); int oldval = -1; pdf_obj *app = NULL; char appkey[] = "NeedAppearances"; fz_try(gctx) { pdf_obj *form = pdf_dict_getp(gctx, pdf_trailer(gctx, pdf), "Root/AcroForm"); app = pdf_dict_gets(gctx, form, appkey); if (pdf_is_bool(gctx, app)) { oldval = pdf_to_bool(gctx, app); } if (EXISTS(value)) { pdf_dict_puts_drop(gctx, form, appkey, PDF_TRUE); } else if (value == Py_False) { pdf_dict_puts_drop(gctx, form, appkey, PDF_FALSE); } } fz_catch(gctx) { Py_RETURN_NONE; } if (value != Py_None) { return value; } if (oldval >= 0) { return JM_BOOL(oldval); } Py_RETURN_NONE; } //------------------------------------------------------------------ // Return the /SigFlags value //------------------------------------------------------------------ CLOSECHECK0(get_sigflags, """Get the /SigFlags value.""") int get_sigflags() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) return -1; // not a PDF int sigflag = -1; fz_try(gctx) { pdf_obj *sigflags = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(SigFlags), NULL); if (sigflags) { sigflag = (int) pdf_to_int(gctx, sigflags); } } fz_catch(gctx) { return -1; // any problem } return sigflag; } //------------------------------------------------------------------ // Check: is this an AcroForm with at least one field? //------------------------------------------------------------------ CLOSECHECK0(is_form_pdf, """Either False or PDF field count.""") %pythoncode%{@property%} PyObject *is_form_pdf() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_FALSE; // not a PDF int count = -1; // init count fz_try(gctx) { pdf_obj *fields = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(Fields), NULL); if (pdf_is_array(gctx, fields)) { count = pdf_array_len(gctx, fields); } } fz_catch(gctx) { Py_RETURN_FALSE; } if (count >= 0) { return Py_BuildValue("i", count); } else { Py_RETURN_FALSE; } } //------------------------------------------------------------------ // Return the list of field font resource names //------------------------------------------------------------------ CLOSECHECK0(FormFonts, """Get list of field font resource names.""") %pythoncode%{@property%} PyObject *FormFonts() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_NONE; // not a PDF pdf_obj *fonts = NULL; PyObject *liste = PyList_New(0); fz_var(liste); fz_try(gctx) { fonts = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(DR), PDF_NAME(Font), NULL); if (fonts && pdf_is_dict(gctx, fonts)) // fonts exist { int i, n = pdf_dict_len(gctx, fonts); for (i = 0; i < n; i++) { pdf_obj *f = pdf_dict_get_key(gctx, fonts, i); LIST_APPEND_DROP(liste, JM_UnicodeFromStr(pdf_to_name(gctx, f))); } } } fz_catch(gctx) { Py_DECREF(liste); Py_RETURN_NONE; // any problem yields None } return liste; } //------------------------------------------------------------------ // Add a field font //------------------------------------------------------------------ FITZEXCEPTION(_addFormFont, !result) CLOSECHECK(_addFormFont, """Add new form font.""") PyObject *_addFormFont(char *name, char *font) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_NONE; // not a PDF pdf_obj *fonts = NULL; fz_try(gctx) { fonts = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(DR), PDF_NAME(Font), NULL); if (!fonts || !pdf_is_dict(gctx, fonts)) { RAISEPY(gctx, "PDF has no form fonts yet", PyExc_RuntimeError); } pdf_obj *k = pdf_new_name(gctx, (const char *) name); pdf_obj *v = JM_pdf_obj_from_str(gctx, pdf, font); pdf_dict_put(gctx, fonts, k, v); } fz_catch(gctx) NULL; Py_RETURN_NONE; } //------------------------------------------------------------------ // Get Xref Number of Outline Root, create it if missing //------------------------------------------------------------------ FITZEXCEPTION(_getOLRootNumber, !result) CLOSECHECK(_getOLRootNumber, """Get xref of Outline Root, create it if missing.""") PyObject *_getOLRootNumber() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); pdf_obj *ind_obj = NULL; pdf_obj *olroot2 = NULL; int ret; fz_var(ind_obj); fz_var(olroot2); fz_try(gctx) { ASSERT_PDF(pdf); // get main root pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); // get outline root pdf_obj *olroot = pdf_dict_get(gctx, root, PDF_NAME(Outlines)); if (!olroot) { olroot2 = pdf_new_dict(gctx, pdf, 4); pdf_dict_put(gctx, olroot2, PDF_NAME(Type), PDF_NAME(Outlines)); ind_obj = pdf_add_object(gctx, pdf, olroot2); pdf_dict_put(gctx, root, PDF_NAME(Outlines), ind_obj); olroot = pdf_dict_get(gctx, root, PDF_NAME(Outlines)); } ret = pdf_to_num(gctx, olroot); } fz_always(gctx) { pdf_drop_obj(gctx, ind_obj); pdf_drop_obj(gctx, olroot2); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", ret); } //------------------------------------------------------------------ // Get a new Xref number //------------------------------------------------------------------ FITZEXCEPTION(get_new_xref, !result) CLOSECHECK(get_new_xref, """Make a new xref.""") PyObject *get_new_xref() { int xref = 0; fz_try(gctx) { fz_document *doc = (fz_document *) $self; pdf_document *pdf = pdf_specifics(gctx, doc); ASSERT_PDF(pdf); ENSURE_OPERATION(gctx, pdf); xref = pdf_create_object(gctx, pdf); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } //------------------------------------------------------------------ // Get Length of XREF table //------------------------------------------------------------------ FITZEXCEPTION(xref_length, !result) CLOSECHECK0(xref_length, """Get length of xref table.""") PyObject *xref_length() { int xreflen = 0; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (pdf) xreflen = pdf_xref_len(gctx, pdf); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xreflen); } //------------------------------------------------------------------ // Get XML Metadata //------------------------------------------------------------------ CLOSECHECK0(get_xml_metadata, """Get document XML metadata.""") PyObject *get_xml_metadata() { PyObject *rc = NULL; fz_buffer *buff = NULL; pdf_obj *xml = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (pdf) { xml = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(Metadata), NULL); } if (xml) { buff = pdf_load_stream(gctx, xml); rc = JM_UnicodeFromBuffer(gctx, buff); } else { rc = EMPTY_STRING; } } fz_always(gctx) { fz_drop_buffer(gctx, buff); PyErr_Clear(); } fz_catch(gctx) { return EMPTY_STRING; } return rc; } //------------------------------------------------------------------ // Get XML Metadata xref //------------------------------------------------------------------ FITZEXCEPTION(xref_xml_metadata, !result) CLOSECHECK0(xref_xml_metadata, """Get xref of document XML metadata.""") PyObject *xref_xml_metadata() { int xref = 0; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); ASSERT_PDF(pdf); pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); if (!root) { RAISEPY(gctx, MSG_BAD_PDFROOT, JM_Exc_FileDataError); } pdf_obj *xml = pdf_dict_get(gctx, root, PDF_NAME(Metadata)); if (xml) xref = pdf_to_num(gctx, xml); } fz_catch(gctx) {;} return Py_BuildValue("i", xref); } //------------------------------------------------------------------ // Delete XML Metadata //------------------------------------------------------------------ FITZEXCEPTION(del_xml_metadata, !result) CLOSECHECK(del_xml_metadata, """Delete XML metadata.""") PyObject *del_xml_metadata() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); if (root) pdf_dict_del(gctx, root, PDF_NAME(Metadata)); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // Set XML-based Metadata //------------------------------------------------------------------ FITZEXCEPTION(set_xml_metadata, !result) CLOSECHECK(set_xml_metadata, """Store XML document level metadata.""") PyObject *set_xml_metadata(char *metadata) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_buffer *res = NULL; fz_try(gctx) { ASSERT_PDF(pdf); pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); if (!root) { RAISEPY(gctx, MSG_BAD_PDFROOT, JM_Exc_FileDataError); } res = fz_new_buffer_from_copied_data(gctx, (const unsigned char *) metadata, strlen(metadata)); pdf_obj *xml = pdf_dict_get(gctx, root, PDF_NAME(Metadata)); if (xml) { JM_update_stream(gctx, pdf, xml, res, 0); } else { xml = pdf_add_stream(gctx, pdf, res, NULL, 0); pdf_dict_put(gctx, xml, PDF_NAME(Type), PDF_NAME(Metadata)); pdf_dict_put(gctx, xml, PDF_NAME(Subtype), PDF_NAME(XML)); pdf_dict_put_drop(gctx, root, PDF_NAME(Metadata), xml); } } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // Get Object String of xref //------------------------------------------------------------------ FITZEXCEPTION(xref_object, !result) CLOSECHECK0(xref_object, """Get xref object source as a string.""") PyObject *xref_object(int xref, int compressed=0, int ascii=0) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); pdf_obj *obj = NULL; PyObject *text = NULL; fz_buffer *res=NULL; fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref > 0) { obj = pdf_load_object(gctx, pdf, xref); } else { obj = pdf_trailer(gctx, pdf); } res = JM_object_to_buffer(gctx, pdf_resolve_indirect(gctx, obj), compressed, ascii); text = JM_EscapeStrFromBuffer(gctx, res); } fz_always(gctx) { if (xref > 0) { pdf_drop_obj(gctx, obj); } fz_drop_buffer(gctx, res); } fz_catch(gctx) return EMPTY_STRING; return text; } %pythoncode %{ def pdf_trailer(self, compressed: bool=False, ascii:bool=False)->str: """Get PDF trailer as a string.""" return self.xref_object(-1, compressed=compressed, ascii=ascii)%} //------------------------------------------------------------------ // Get compressed stream of an object by xref // Py_RETURN_NONE if not stream //------------------------------------------------------------------ FITZEXCEPTION(xref_stream_raw, !result) CLOSECHECK(xref_stream_raw, """Get xref stream without decompression.""") PyObject *xref_stream_raw(int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); PyObject *r = NULL; pdf_obj *obj = NULL; fz_var(obj); fz_buffer *res = NULL; fz_var(res); fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref >= 0) { obj = pdf_new_indirect(gctx, pdf, xref, 0); } else { obj = pdf_trailer(gctx, pdf); } if (pdf_is_stream(gctx, obj)) { res = pdf_load_raw_stream_number(gctx, pdf, xref); r = JM_BinFromBuffer(gctx, res); } } fz_always(gctx) { fz_drop_buffer(gctx, res); if (xref >= 0) { pdf_drop_obj(gctx, obj); } } fz_catch(gctx) { Py_CLEAR(r); return NULL; } if (!r) Py_RETURN_NONE; return r; } //------------------------------------------------------------------ // Get decompressed stream of an object by xref // Py_RETURN_NONE if not stream //------------------------------------------------------------------ FITZEXCEPTION(xref_stream, !result) CLOSECHECK(xref_stream, """Get decompressed xref stream.""") PyObject *xref_stream(int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); PyObject *r = Py_None; pdf_obj *obj = NULL; fz_var(obj); fz_buffer *res = NULL; fz_var(res); fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1) && xref != -1) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } if (xref >= 0) { obj = pdf_new_indirect(gctx, pdf, xref, 0); } else { obj = pdf_trailer(gctx, pdf); } if (pdf_is_stream(gctx, obj)) { res = pdf_load_stream_number(gctx, pdf, xref); r = JM_BinFromBuffer(gctx, res); } } fz_always(gctx) { fz_drop_buffer(gctx, res); if (xref >= 0) { pdf_drop_obj(gctx, obj); } } fz_catch(gctx) { Py_CLEAR(r); return NULL; } return r; } //------------------------------------------------------------------ // Update an Xref number with a new object given as a string //------------------------------------------------------------------ FITZEXCEPTION(update_object, !result) CLOSECHECK(update_object, """Replace object definition source.""") PyObject *update_object(int xref, char *text, struct Page *page = NULL) { pdf_obj *new_obj; pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } ENSURE_OPERATION(gctx, pdf); // create new object with passed-in string new_obj = JM_pdf_obj_from_str(gctx, pdf, text); pdf_update_object(gctx, pdf, xref, new_obj); pdf_drop_obj(gctx, new_obj); if (page) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) page); JM_refresh_links(gctx, pdfpage); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // Update a stream identified by its xref //------------------------------------------------------------------ FITZEXCEPTION(update_stream, !result) CLOSECHECK(update_stream, """Replace xref stream part.""") PyObject *update_stream(int xref=0, PyObject *stream=NULL, int new=1, int compress=1) { pdf_obj *obj = NULL; fz_var(obj); fz_buffer *res = NULL; fz_var(res); pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } ENSURE_OPERATION(gctx, pdf); // get the object obj = pdf_new_indirect(gctx, pdf, xref, 0); if (!pdf_is_dict(gctx, obj)) { RAISEPY(gctx, MSG_IS_NO_DICT, PyExc_ValueError); } res = JM_BufferFromBytes(gctx, stream); if (!res) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_TypeError); } JM_update_stream(gctx, pdf, obj, res, compress); } fz_always(gctx) { fz_drop_buffer(gctx, res); pdf_drop_obj(gctx, obj); } fz_catch(gctx) return NULL; Py_RETURN_NONE; } //------------------------------------------------------------------ // create / refresh the page map //------------------------------------------------------------------ FITZEXCEPTION(_make_page_map, !result) CLOSECHECK0(_make_page_map, """Make an array page number -> page object.""") PyObject *_make_page_map() { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); if (!pdf) Py_RETURN_NONE; fz_try(gctx) { pdf_drop_page_tree(gctx, pdf); pdf_load_page_tree(gctx, pdf); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", pdf->map_page_count); } //------------------------------------------------------------------ // full (deep) copy of one page //------------------------------------------------------------------ FITZEXCEPTION(fullcopy_page, !result) CLOSECHECK0(fullcopy_page, """Make a full page duplicate.""") %pythonappend fullcopy_page %{self._reset_page_refs()%} PyObject *fullcopy_page(int pno, int to = -1) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); int page_count = pdf_count_pages(gctx, pdf); fz_buffer *res = NULL, *nres=NULL; fz_buffer *contents_buffer = NULL; fz_var(pdf); fz_var(res); fz_var(nres); fz_var(contents_buffer); fz_try(gctx) { ASSERT_PDF(pdf); if (!INRANGE(pno, 0, page_count - 1) || !INRANGE(to, -1, page_count - 1)) { RAISEPY(gctx, MSG_BAD_PAGENO, PyExc_ValueError); } pdf_obj *page1 = pdf_resolve_indirect(gctx, pdf_lookup_page_obj(gctx, pdf, pno)); pdf_obj *page2 = pdf_deep_copy_obj(gctx, page1); pdf_obj *old_annots = pdf_dict_get(gctx, page2, PDF_NAME(Annots)); // copy annotations, but remove Popup and IRT types if (old_annots) { int i, n = pdf_array_len(gctx, old_annots); pdf_obj *new_annots = pdf_new_array(gctx, pdf, n); for (i = 0; i < n; i++) { pdf_obj *o = pdf_array_get(gctx, old_annots, i); pdf_obj *subtype = pdf_dict_get(gctx, o, PDF_NAME(Subtype)); if (pdf_name_eq(gctx, subtype, PDF_NAME(Popup))) continue; if (pdf_dict_gets(gctx, o, "IRT")) continue; pdf_obj *copy_o = pdf_deep_copy_obj(gctx, pdf_resolve_indirect(gctx, o)); int xref = pdf_create_object(gctx, pdf); pdf_update_object(gctx, pdf, xref, copy_o); pdf_drop_obj(gctx, copy_o); copy_o = pdf_new_indirect(gctx, pdf, xref, 0); pdf_dict_del(gctx, copy_o, PDF_NAME(Popup)); pdf_dict_del(gctx, copy_o, PDF_NAME(P)); pdf_array_push_drop(gctx, new_annots, copy_o); } pdf_dict_put_drop(gctx, page2, PDF_NAME(Annots), new_annots); } // copy the old contents stream(s) res = JM_read_contents(gctx, page1); // create new /Contents object for page2 if (res) { contents_buffer = fz_new_buffer_from_copied_data(gctx, " ", 1); pdf_obj *contents = pdf_add_stream(gctx, pdf, contents_buffer, NULL, 0); JM_update_stream(gctx, pdf, contents, res, 1); pdf_dict_put_drop(gctx, page2, PDF_NAME(Contents), contents); } // now insert target page, making sure it is an indirect object int xref = pdf_create_object(gctx, pdf); // get new xref pdf_update_object(gctx, pdf, xref, page2); // store new page pdf_drop_obj(gctx, page2); // give up this object for now page2 = pdf_new_indirect(gctx, pdf, xref, 0); // reread object pdf_insert_page(gctx, pdf, to, page2); // and store the page pdf_drop_obj(gctx, page2); } fz_always(gctx) { pdf_drop_page_tree(gctx, pdf); fz_drop_buffer(gctx, res); fz_drop_buffer(gctx, nres); fz_drop_buffer(gctx, contents_buffer); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // move or copy one page //------------------------------------------------------------------ FITZEXCEPTION(_move_copy_page, !result) CLOSECHECK0(_move_copy_page, """Move or copy a PDF page reference.""") %pythonappend _move_copy_page %{self._reset_page_refs()%} PyObject *_move_copy_page(int pno, int nb, int before, int copy) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); int i1, i2, pos, count, same = 0; pdf_obj *parent1 = NULL, *parent2 = NULL, *parent = NULL; pdf_obj *kids1, *kids2; fz_try(gctx) { ASSERT_PDF(pdf); // get the two page objects ----------------------------------- // locate the /Kids arrays and indices in each pdf_obj *page1 = pdf_lookup_page_loc(gctx, pdf, pno, &parent1, &i1); kids1 = pdf_dict_get(gctx, parent1, PDF_NAME(Kids)); pdf_obj *page2 = pdf_lookup_page_loc(gctx, pdf, nb, &parent2, &i2); (void) page2; kids2 = pdf_dict_get(gctx, parent2, PDF_NAME(Kids)); if (before) // calc index of source page in target /Kids pos = i2; else pos = i2 + 1; // same /Kids array? ------------------------------------------ same = pdf_objcmp(gctx, kids1, kids2); // put source page in target /Kids array ---------------------- if (!copy && same != 0) // update parent in page object { pdf_dict_put(gctx, page1, PDF_NAME(Parent), parent2); } pdf_array_insert(gctx, kids2, page1, pos); if (same != 0) // different /Kids arrays ---------------------- { parent = parent2; while (parent) // increase /Count objects in parents { count = pdf_dict_get_int(gctx, parent, PDF_NAME(Count)); pdf_dict_put_int(gctx, parent, PDF_NAME(Count), count + 1); parent = pdf_dict_get(gctx, parent, PDF_NAME(Parent)); } if (!copy) // delete original item { pdf_array_delete(gctx, kids1, i1); parent = parent1; while (parent) // decrease /Count objects in parents { count = pdf_dict_get_int(gctx, parent, PDF_NAME(Count)); pdf_dict_put_int(gctx, parent, PDF_NAME(Count), count - 1); parent = pdf_dict_get(gctx, parent, PDF_NAME(Parent)); } } } else { // same /Kids array if (copy) { // source page is copied parent = parent2; while (parent) // increase /Count object in parents { count = pdf_dict_get_int(gctx, parent, PDF_NAME(Count)); pdf_dict_put_int(gctx, parent, PDF_NAME(Count), count + 1); parent = pdf_dict_get(gctx, parent, PDF_NAME(Parent)); } } else { if (i1 < pos) pdf_array_delete(gctx, kids1, i1); else pdf_array_delete(gctx, kids1, i1 + 1); } } if (pdf->rev_page_map) { // page map no longer valid: drop it pdf_drop_page_tree(gctx, pdf); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_remove_toc_item, !result) PyObject *_remove_toc_item(int xref) { // "remove" bookmark by letting it point to nowhere pdf_obj *item = NULL, *color; int i; pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { item = pdf_new_indirect(gctx, pdf, xref, 0); pdf_dict_del(gctx, item, PDF_NAME(Dest)); pdf_dict_del(gctx, item, PDF_NAME(A)); color = pdf_new_array(gctx, pdf, 3); for (i=0; i < 3; i++) { pdf_array_push_real(gctx, color, 0.8); } pdf_dict_put_drop(gctx, item, PDF_NAME(C), color); } fz_always(gctx) { pdf_drop_obj(gctx, item); } fz_catch(gctx){ return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_update_toc_item, !result) PyObject *_update_toc_item(int xref, char *action=NULL, char *title=NULL, int flags=0, PyObject *collapse=NULL, PyObject *color=NULL) { // "update" bookmark by letting it point to nowhere pdf_obj *item = NULL; pdf_obj *obj = NULL; Py_ssize_t i; double f; pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); fz_try(gctx) { item = pdf_new_indirect(gctx, pdf, xref, 0); if (title) { pdf_dict_put_text_string(gctx, item, PDF_NAME(Title), title); } if (action) { pdf_dict_del(gctx, item, PDF_NAME(Dest)); obj = JM_pdf_obj_from_str(gctx, pdf, action); pdf_dict_put_drop(gctx, item, PDF_NAME(A), obj); } pdf_dict_put_int(gctx, item, PDF_NAME(F), flags); if (EXISTS(color)) { pdf_obj *c = pdf_new_array(gctx, pdf, 3); for (i = 0; i < 3; i++) { JM_FLOAT_ITEM(color, i, &f); pdf_array_push_real(gctx, c, f); } pdf_dict_put_drop(gctx, item, PDF_NAME(C), c); } else if (color != Py_None) { pdf_dict_del(gctx, item, PDF_NAME(C)); } if (collapse != Py_None) { if (pdf_dict_get(gctx, item, PDF_NAME(Count))) { i = pdf_dict_get_int(gctx, item, PDF_NAME(Count)); if ((i < 0 && collapse == Py_False) || (i > 0 && collapse == Py_True)) { i = i * (-1); pdf_dict_put_int(gctx, item, PDF_NAME(Count), i); } } } } fz_always(gctx) { pdf_drop_obj(gctx, item); } fz_catch(gctx){ return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // PDF page label getting / setting //------------------------------------------------------------------ FITZEXCEPTION(_get_page_labels, !result) PyObject * _get_page_labels() { pdf_obj *obj, *nums, *kids; PyObject *rc = NULL; int i, n; pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); pdf_obj *pagelabels = NULL; fz_var(pagelabels); fz_try(gctx) { ASSERT_PDF(pdf); rc = PyList_New(0); pagelabels = pdf_new_name(gctx, "PageLabels"); obj = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), pagelabels, NULL); if (!obj) { goto finished; } // simple case: direct /Nums object nums = pdf_resolve_indirect(gctx, pdf_dict_get(gctx, obj, PDF_NAME(Nums))); if (nums) { JM_get_page_labels(gctx, rc, nums); goto finished; } // case: /Kids/Nums nums = pdf_resolve_indirect(gctx, pdf_dict_getl(gctx, obj, PDF_NAME(Kids), PDF_NAME(Nums), NULL) ); if (nums) { JM_get_page_labels(gctx, rc, nums); goto finished; } // case: /Kids is an array of multiple /Nums kids = pdf_resolve_indirect(gctx, pdf_dict_get(gctx, obj, PDF_NAME(Kids))); if (!kids || !pdf_is_array(gctx, kids)) { goto finished; } n = pdf_array_len(gctx, kids); for (i = 0; i < n; i++) { nums = pdf_resolve_indirect(gctx, pdf_dict_get(gctx, pdf_array_get(gctx, kids, i), PDF_NAME(Nums))); JM_get_page_labels(gctx, rc, nums); } finished:; } fz_always(gctx) { PyErr_Clear(); pdf_drop_obj(gctx, pagelabels); } fz_catch(gctx){ Py_CLEAR(rc); return NULL; } return rc; } FITZEXCEPTION(_set_page_labels, !result) %pythonappend _set_page_labels %{ xref = self.pdf_catalog() text = self.xref_object(xref, compressed=True) text = text.replace("/Nums[]", "/Nums[%s]" % labels) self.update_object(xref, text)%} PyObject * _set_page_labels(char *labels) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) $self); pdf_obj *pagelabels = NULL; fz_var(pagelabels); fz_try(gctx) { ASSERT_PDF(pdf); pagelabels = pdf_new_name(gctx, "PageLabels"); pdf_obj *root = pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)); pdf_dict_del(gctx, root, pagelabels); pdf_dict_putl_drop(gctx, root, pdf_new_array(gctx, pdf, 0), pagelabels, PDF_NAME(Nums), NULL); } fz_always(gctx) { PyErr_Clear(); pdf_drop_obj(gctx, pagelabels); } fz_catch(gctx){ return NULL; } Py_RETURN_NONE; } //------------------------------------------------------------------ // PDF Optional Content functions //------------------------------------------------------------------ FITZEXCEPTION(get_layers, !result) CLOSECHECK0(get_layers, """Show optional OC layers.""") PyObject * get_layers() { PyObject *rc = NULL; pdf_layer_config info = {NULL, NULL}; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); int i, n = pdf_count_layer_configs(gctx, pdf); if (n == 1) { pdf_obj *obj = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(OCProperties), PDF_NAME(Configs), NULL); if (!pdf_is_array(gctx, obj)) n = 0; } rc = PyTuple_New(n); for (i = 0; i < n; i++) { pdf_layer_config_info(gctx, pdf, i, &info); PyObject *item = Py_BuildValue("{s:i,s:s,s:s}", "number", i, "name", info.name, "creator", info.creator); PyTuple_SET_ITEM(rc, i, item); info.name = NULL; info.creator = NULL; } } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } return rc; } FITZEXCEPTION(switch_layer, !result) CLOSECHECK0(switch_layer, """Activate an OC layer.""") PyObject * switch_layer(int config, int as_default=0) { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); pdf_obj *cfgs = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(OCProperties), PDF_NAME(Configs), NULL); if (!pdf_is_array(gctx, cfgs) || !pdf_array_len(gctx, cfgs)) { if (config < 1) goto finished; RAISEPY(gctx, MSG_BAD_OC_LAYER, PyExc_ValueError); } if (config < 0) goto finished; pdf_select_layer_config(gctx, pdf, config); if (as_default) { pdf_set_layer_config_as_default(gctx, pdf); pdf_read_ocg(gctx, pdf); } finished:; } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(get_layer, !result) CLOSECHECK0(get_layer, """Content of ON, OFF, RBGroups of an OC layer.""") PyObject * get_layer(int config=-1) { PyObject *rc; pdf_obj *obj = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); pdf_obj *ocp = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(OCProperties), NULL); if (!ocp) { rc = Py_BuildValue("s", NULL); goto finished; } if (config == -1) { obj = pdf_dict_get(gctx, ocp, PDF_NAME(D)); } else { obj = pdf_array_get(gctx, pdf_dict_get(gctx, ocp, PDF_NAME(Configs)), config); } if (!obj) { RAISEPY(gctx, MSG_BAD_OC_CONFIG, PyExc_ValueError); } rc = JM_get_ocg_arrays(gctx, obj); finished:; } fz_catch(gctx) { Py_CLEAR(rc); PyErr_Clear(); return NULL; } return rc; } FITZEXCEPTION(set_layer, !result) %pythonprepend set_layer %{"""Set the PDF keys /ON, /OFF, /RBGroups of an OC layer.""" if self.is_closed: raise ValueError("document closed") ocgs = set(self.get_ocgs().keys()) if ocgs == set(): raise ValueError("document has no optional content") if on: if type(on) not in (list, tuple): raise ValueError("bad type: 'on'") s = set(on).difference(ocgs) if s != set(): raise ValueError("bad OCGs in 'on': %s" % s) if off: if type(off) not in (list, tuple): raise ValueError("bad type: 'off'") s = set(off).difference(ocgs) if s != set(): raise ValueError("bad OCGs in 'off': %s" % s) if locked: if type(locked) not in (list, tuple): raise ValueError("bad type: 'locked'") s = set(locked).difference(ocgs) if s != set(): raise ValueError("bad OCGs in 'locked': %s" % s) if rbgroups: if type(rbgroups) not in (list, tuple): raise ValueError("bad type: 'rbgroups'") for x in rbgroups: if not type(x) in (list, tuple): raise ValueError("bad RBGroup '%s'" % x) s = set(x).difference(ocgs) if s != set(): raise ValueError("bad OCGs in RBGroup: %s" % s) if basestate: basestate = str(basestate).upper() if basestate == "UNCHANGED": basestate = "Unchanged" if basestate not in ("ON", "OFF", "Unchanged"): raise ValueError("bad 'basestate'") %} PyObject * set_layer(int config, const char *basestate=NULL, PyObject *on=NULL, PyObject *off=NULL, PyObject *rbgroups=NULL, PyObject *locked=NULL) { pdf_obj *obj = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); pdf_obj *ocp = pdf_dict_getl(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(OCProperties), NULL); if (!ocp) { goto finished; } if (config == -1) { obj = pdf_dict_get(gctx, ocp, PDF_NAME(D)); } else { obj = pdf_array_get(gctx, pdf_dict_get(gctx, ocp, PDF_NAME(Configs)), config); } if (!obj) { RAISEPY(gctx, MSG_BAD_OC_CONFIG, PyExc_ValueError); } JM_set_ocg_arrays(gctx, obj, basestate, on, off, rbgroups, locked); pdf_read_ocg(gctx, pdf); finished:; } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(add_layer, !result) CLOSECHECK0(add_layer, """Add a new OC layer.""") PyObject *add_layer(char *name, char *creator=NULL, PyObject *on=NULL) { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); JM_add_layer_config(gctx, pdf, name, creator, on); pdf_read_ocg(gctx, pdf); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(layer_ui_configs, !result) CLOSECHECK0(layer_ui_configs, """Show OC visibility status modifiable by user.""") PyObject *layer_ui_configs() { typedef struct { const char *text; int depth; pdf_layer_config_ui_type type; int selected; int locked; } pdf_layer_config_ui; PyObject *rc = NULL; fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); pdf_layer_config_ui info; int i, n = pdf_count_layer_config_ui(gctx, pdf); rc = PyTuple_New(n); char *type = NULL; for (i = 0; i < n; i++) { pdf_layer_config_ui_info(gctx, pdf, i, (void *) &info); switch (info.type) { case (1): type = "checkbox"; break; case (2): type = "radiobox"; break; default: type = "label"; break; } PyObject *item = Py_BuildValue("{s:i,s:N,s:i,s:s,s:N,s:N}", "number", i, "text", JM_UnicodeFromStr(info.text), "depth", info.depth, "type", type, "on", JM_BOOL(info.selected), "locked", JM_BOOL(info.locked)); PyTuple_SET_ITEM(rc, i, item); } } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } return rc; } FITZEXCEPTION(set_layer_ui_config, !result) CLOSECHECK0(set_layer_ui_config, ) %pythonprepend set_layer_ui_config %{ """Set / unset OC intent configuration.""" # The user might have given the name instead of sequence number, # so select by that name and continue with corresp. number if isinstance(number, str): select = [ui["number"] for ui in self.layer_ui_configs() if ui["text"] == number] if select == []: raise ValueError(f"bad OCG '{number}'.") number = select[0] # this is the number for the name %} PyObject *set_layer_ui_config(int number, int action=0) { fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); switch (action) { case (1): pdf_toggle_layer_config_ui(gctx, pdf, number); break; case (2): pdf_deselect_layer_config_ui(gctx, pdf, number); break; default: pdf_select_layer_config_ui(gctx, pdf, number); break; } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(get_ocgs, !result) CLOSECHECK0(get_ocgs, """Show existing optional content groups.""") PyObject * get_ocgs() { PyObject *rc = NULL; pdf_obj *ci = pdf_new_name(gctx, "CreatorInfo"); fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); pdf_obj *ocgs = pdf_dict_getl(gctx, pdf_dict_get(gctx, pdf_trailer(gctx, pdf), PDF_NAME(Root)), PDF_NAME(OCProperties), PDF_NAME(OCGs), NULL); rc = PyDict_New(); if (!pdf_is_array(gctx, ocgs)) goto fertig; int i, n = pdf_array_len(gctx, ocgs); for (i = 0; i < n; i++) { pdf_obj *ocg = pdf_array_get(gctx, ocgs, i); int xref = pdf_to_num(gctx, ocg); const char *name = pdf_to_text_string(gctx, pdf_dict_get(gctx, ocg, PDF_NAME(Name))); pdf_obj *obj = pdf_dict_getl(gctx, ocg, PDF_NAME(Usage), ci, PDF_NAME(Subtype), NULL); const char *usage = NULL; if (obj) usage = pdf_to_name(gctx, obj); PyObject *intents = PyList_New(0); pdf_obj *intent = pdf_dict_get(gctx, ocg, PDF_NAME(Intent)); if (intent) { if (pdf_is_name(gctx, intent)) { LIST_APPEND_DROP(intents, Py_BuildValue("s", pdf_to_name(gctx, intent))); } else if (pdf_is_array(gctx, intent)) { int j, m = pdf_array_len(gctx, intent); for (j = 0; j < m; j++) { pdf_obj *o = pdf_array_get(gctx, intent, j); if (pdf_is_name(gctx, o)) LIST_APPEND_DROP(intents, Py_BuildValue("s", pdf_to_name(gctx, o))); } } } int hidden = pdf_is_ocg_hidden(gctx, pdf, NULL, usage, ocg); PyObject *item = Py_BuildValue("{s:s,s:O,s:O,s:s}", "name", name, "intent", intents, "on", JM_BOOL(!hidden), "usage", usage); Py_DECREF(intents); PyObject *temp = Py_BuildValue("i", xref); DICT_SETITEM_DROP(rc, temp, item); Py_DECREF(temp); } fertig:; } fz_always(gctx) { pdf_drop_obj(gctx, ci); } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } return rc; } FITZEXCEPTION(add_ocg, !result) CLOSECHECK0(add_ocg, """Add new optional content group.""") PyObject * add_ocg(char *name, int config=-1, int on=1, PyObject *intent=NULL, const char *usage=NULL) { int xref = 0; pdf_obj *obj = NULL, *cfg = NULL; pdf_obj *indocg = NULL; pdf_obj *ocg = NULL; pdf_obj *ci_name = NULL; fz_var(indocg); fz_var(ocg); fz_var(ci_name); fz_try(gctx) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) self); ASSERT_PDF(pdf); // ------------------------------ // make the OCG // ------------------------------ ocg = pdf_add_new_dict(gctx, pdf, 3); pdf_dict_put(gctx, ocg, PDF_NAME(Type), PDF_NAME(OCG)); pdf_dict_put_text_string(gctx, ocg, PDF_NAME(Name), name); pdf_obj *intents = pdf_dict_put_array(gctx, ocg, PDF_NAME(Intent), 2); if (!EXISTS(intent)) { pdf_array_push(gctx, intents, PDF_NAME(View)); } else if (!PyUnicode_Check(intent)) { int i, n = PySequence_Size(intent); for (i = 0; i < n; i++) { PyObject *item = PySequence_ITEM(intent, i); char *c = JM_StrAsChar(item); if (c) { pdf_array_push_drop(gctx, intents, pdf_new_name(gctx, c)); } Py_DECREF(item); } } else { char *c = JM_StrAsChar(intent); if (c) { pdf_array_push_drop(gctx, intents, pdf_new_name(gctx, c)); } } pdf_obj *use_for = pdf_dict_put_dict(gctx, ocg, PDF_NAME(Usage), 3); ci_name = pdf_new_name(gctx, "CreatorInfo"); pdf_obj *cre_info = pdf_dict_put_dict(gctx, use_for, ci_name, 2); pdf_dict_put_text_string(gctx, cre_info, PDF_NAME(Creator), "PyMuPDF"); if (usage) { pdf_dict_put_name(gctx, cre_info, PDF_NAME(Subtype), usage); } else { pdf_dict_put_name(gctx, cre_info, PDF_NAME(Subtype), "Artwork"); } indocg = pdf_add_object(gctx, pdf, ocg); // ------------------------------ // Insert OCG in the right config // ------------------------------ pdf_obj *ocp = JM_ensure_ocproperties(gctx, pdf); obj = pdf_dict_get(gctx, ocp, PDF_NAME(OCGs)); pdf_array_push(gctx, obj, indocg); if (config > -1) { obj = pdf_dict_get(gctx, ocp, PDF_NAME(Configs)); if (!pdf_is_array(gctx, obj)) { RAISEPY(gctx, MSG_BAD_OC_CONFIG, PyExc_ValueError); } cfg = pdf_array_get(gctx, obj, config); if (!cfg) { RAISEPY(gctx, MSG_BAD_OC_CONFIG, PyExc_ValueError); } } else { cfg = pdf_dict_get(gctx, ocp, PDF_NAME(D)); } obj = pdf_dict_get(gctx, cfg, PDF_NAME(Order)); if (!obj) { obj = pdf_dict_put_array(gctx, cfg, PDF_NAME(Order), 1); } pdf_array_push(gctx, obj, indocg); if (on) { obj = pdf_dict_get(gctx, cfg, PDF_NAME(ON)); if (!obj) { obj = pdf_dict_put_array(gctx, cfg, PDF_NAME(ON), 1); } } else { obj = pdf_dict_get(gctx, cfg, PDF_NAME(OFF)); if (!obj) { obj = pdf_dict_put_array(gctx, cfg, PDF_NAME(OFF), 1); } } pdf_array_push(gctx, obj, indocg); // let MuPDF take note: re-read OCProperties pdf_read_ocg(gctx, pdf); xref = pdf_to_num(gctx, indocg); } fz_always(gctx) { pdf_drop_obj(gctx, indocg); pdf_drop_obj(gctx, ocg); pdf_drop_obj(gctx, ci_name); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } struct Annot; void internal_keep_annot(struct Annot* annot) { pdf_keep_annot(gctx, (pdf_annot*) annot); } //------------------------------------------------------------------ // Initialize document: set outline and metadata properties //------------------------------------------------------------------ %pythoncode %{ def init_doc(self): if self.is_encrypted: raise ValueError("cannot initialize - document still encrypted") self._outline = self._loadOutline() if self._outline: self._outline.thisown = True self.metadata = dict([(k,self._getMetadata(v)) for k,v in {'format':'format', 'title':'info:Title', 'author':'info:Author','subject':'info:Subject', 'keywords':'info:Keywords','creator':'info:Creator', 'producer':'info:Producer', 'creationDate':'info:CreationDate', 'modDate':'info:ModDate', 'trapped':'info:Trapped'}.items()]) self.metadata['encryption'] = None if self._getMetadata('encryption')=='None' else self._getMetadata('encryption') outline = property(lambda self: self._outline) def get_page_fonts(self, pno: int, full: bool =False) -> list: """Retrieve a list of fonts used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () if type(pno) is not int: try: pno = pno.number except: raise ValueError("need a Page or page number") val = self._getPageInfo(pno, 1) if full is False: return [v[:-1] for v in val] return val def get_page_images(self, pno: int, full: bool =False) -> list: """Retrieve a list of images used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () if type(pno) is not int: try: pno = pno.number except: raise ValueError("need a Page or page number") val = self._getPageInfo(pno, 2) if full is False: return [v[:-1] for v in val] return val def get_page_xobjects(self, pno: int) -> list: """Retrieve a list of XObjects used on a page. """ if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if not self.is_pdf: return () if type(pno) is not int: try: pno = pno.number except: raise ValueError("need a Page or page number") val = self._getPageInfo(pno, 3) rc = [(v[0], v[1], v[2], Rect(v[3])) for v in val] return rc def xref_is_image(self, xref): """Check if xref is an image object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Subtype")[1] == "/Image": return True return False def xref_is_font(self, xref): """Check if xref is a font object.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Type")[1] == "/Font": return True return False def xref_is_xobject(self, xref): """Check if xref is a form xobject.""" if self.is_closed or self.is_encrypted: raise ValueError("document closed or encrypted") if self.xref_get_key(xref, "Subtype")[1] == "/Form": return True return False def copy_page(self, pno: int, to: int =-1): """Copy a page within a PDF document. This will only create another reference of the same page object. Args: pno: source page number to: put before this page, '-1' means after last page. """ if self.is_closed: raise ValueError("document closed") page_count = len(self) if ( pno not in range(page_count) or to not in range(-1, page_count) ): raise ValueError("bad page number(s)") before = 1 copy = 1 if to == -1: to = page_count - 1 before = 0 return self._move_copy_page(pno, to, before, copy) def move_page(self, pno: int, to: int =-1): """Move a page within a PDF document. Args: pno: source page number. to: put before this page, '-1' means after last page. """ if self.is_closed: raise ValueError("document closed") page_count = len(self) if ( pno not in range(page_count) or to not in range(-1, page_count) ): raise ValueError("bad page number(s)") before = 1 copy = 0 if to == -1: to = page_count - 1 before = 0 return self._move_copy_page(pno, to, before, copy) def delete_page(self, pno: int =-1): """ Delete one page from a PDF. """ if not self.is_pdf: raise ValueError("is no PDF") if self.is_closed: raise ValueError("document closed") page_count = self.page_count while pno < 0: pno += page_count if pno >= page_count: raise ValueError("bad page number(s)") # remove TOC bookmarks pointing to deleted page toc = self.get_toc() ol_xrefs = self.get_outline_xrefs() for i, item in enumerate(toc): if item[2] == pno + 1: self._remove_toc_item(ol_xrefs[i]) self._remove_links_to(frozenset((pno,))) self._delete_page(pno) self._reset_page_refs() def delete_pages(self, *args, **kw): """Delete pages from a PDF. Args: Either keywords 'from_page'/'to_page', or two integers to specify the first/last page to delete. Or a list/tuple/range object, which can contain arbitrary page numbers. """ if not self.is_pdf: raise ValueError("is no PDF") if self.is_closed: raise ValueError("document closed") page_count = self.page_count # page count of document f = t = -1 if kw: # check if keywords were used if args: # then no positional args are allowed raise ValueError("cannot mix keyword and positional argument") f = kw.get("from_page", -1) # first page to delete t = kw.get("to_page", -1) # last page to delete while f < 0: f += page_count while t < 0: t += page_count if not f <= t < page_count: raise ValueError("bad page number(s)") numbers = tuple(range(f, t + 1)) else: if len(args) > 2 or args == []: raise ValueError("need 1 or 2 positional arguments") if len(args) == 2: f, t = args if not (type(f) is int and type(t) is int): raise ValueError("both arguments must be int") if f > t: f, t = t, f if not f <= t < page_count: raise ValueError("bad page number(s)") numbers = tuple(range(f, t + 1)) else: r = args[0] if type(r) not in (int, range, list, tuple): raise ValueError("need int or sequence if one argument") numbers = tuple(r) numbers = list(map(int, set(numbers))) # ensure unique integers if numbers == []: print("nothing to delete") return numbers.sort() if numbers[0] < 0 or numbers[-1] >= page_count: raise ValueError("bad page number(s)") frozen_numbers = frozenset(numbers) toc = self.get_toc() for i, xref in enumerate(self.get_outline_xrefs()): if toc[i][2] - 1 in frozen_numbers: self._remove_toc_item(xref) # remove target in PDF object self._remove_links_to(frozen_numbers) for i in reversed(numbers): # delete pages, last to first self._delete_page(i) self._reset_page_refs() def saveIncr(self): """ Save PDF incrementally""" return self.save(self.name, incremental=True, encryption=PDF_ENCRYPT_KEEP) def ez_save(self, filename, garbage=3, clean=False, deflate=True, deflate_images=True, deflate_fonts=True, incremental=False, ascii=False, expand=False, linear=False, pretty=False, encryption=1, permissions=4095, owner_pw=None, user_pw=None, no_new_id=True): """ Save PDF using some different defaults""" return self.save(filename, garbage=garbage, clean=clean, deflate=deflate, deflate_images=deflate_images, deflate_fonts=deflate_fonts, incremental=incremental, ascii=ascii, expand=expand, linear=linear, pretty=pretty, encryption=encryption, permissions=permissions, owner_pw=owner_pw, user_pw=user_pw, no_new_id=no_new_id,) def reload_page(self, page: "struct Page *") -> "struct Page *": """Make a fresh copy of a page.""" old_annots = {} # copy annot references to here pno = page.number # save the page number for k, v in page._annot_refs.items(): # save the annot dictionary # We need to call pdf_keep_annot() here, otherwise `v`'s # refcount can reach zero even if there is an external # reference. self.internal_keep_annot(v) old_annots[k] = v page._erase() # remove the page page = None TOOLS.store_shrink(100) page = self.load_page(pno) # reload the page # copy annot refs over to the new dictionary page_proxy = weakref.proxy(page) for k, v in old_annots.items(): annot = old_annots[k] annot.parent = page_proxy # refresh parent to new page page._annot_refs[k] = annot return page @property def pagemode(self) -> str: """Return the PDF PageMode value. """ xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "PageMode") if rc[0] == "null": return "UseNone" if rc[0] == "name": return rc[1][1:] return "UseNone" def set_pagemode(self, pagemode: str): """Set the PDF PageMode value.""" valid = ("UseNone", "UseOutlines", "UseThumbs", "FullScreen", "UseOC", "UseAttachments") xref = self.pdf_catalog() if xref == 0: raise ValueError("not a PDF") if not pagemode: raise ValueError("bad PageMode value") if pagemode[0] == "/": pagemode = pagemode[1:] for v in valid: if pagemode.lower() == v.lower(): self.xref_set_key(xref, "PageMode", f"/{v}") return True raise ValueError("bad PageMode value") @property def pagelayout(self) -> str: """Return the PDF PageLayout value. """ xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "PageLayout") if rc[0] == "null": return "SinglePage" if rc[0] == "name": return rc[1][1:] return "SinglePage" def set_pagelayout(self, pagelayout: str): """Set the PDF PageLayout value.""" valid = ("SinglePage", "OneColumn", "TwoColumnLeft", "TwoColumnRight", "TwoPageLeft", "TwoPageRight") xref = self.pdf_catalog() if xref == 0: raise ValueError("not a PDF") if not pagelayout: raise ValueError("bad PageLayout value") if pagelayout[0] == "/": pagelayout = pagelayout[1:] for v in valid: if pagelayout.lower() == v.lower(): self.xref_set_key(xref, "PageLayout", f"/{v}") return True raise ValueError("bad PageLayout value") @property def markinfo(self) -> dict: """Return the PDF MarkInfo value.""" xref = self.pdf_catalog() if xref == 0: return None rc = self.xref_get_key(xref, "MarkInfo") if rc[0] == "null": return {} if rc[0] == "xref": xref = int(rc[1].split()[0]) val = self.xref_object(xref, compressed=True) elif rc[0] == "dict": val = rc[1] else: val = None if val == None or not (val[:2] == "<<" and val[-2:] == ">>"): return {} valid = {"Marked": False, "UserProperties": False, "Suspects": False} val = val[2:-2].split("/") for v in val[1:]: try: key, value = v.split() except: return valid if value == "true": valid[key] = True return valid def set_markinfo(self, markinfo: dict) -> bool: """Set the PDF MarkInfo values.""" xref = self.pdf_catalog() if xref == 0: raise ValueError("not a PDF") if not markinfo or not isinstance(markinfo, dict): return False valid = {"Marked": False, "UserProperties": False, "Suspects": False} if not set(valid.keys()).issuperset(markinfo.keys()): badkeys = f"bad MarkInfo key(s): {set(markinfo.keys()).difference(valid.keys())}" raise ValueError(badkeys) pdfdict = "<<" valid.update(markinfo) for key, value in valid.items(): value=str(value).lower() if not value in ("true", "false"): raise ValueError(f"bad key value '{key}': '{value}'") pdfdict += f"/{key} {value}" pdfdict += ">>" self.xref_set_key(xref, "MarkInfo", pdfdict) return True def __repr__(self) -> str: m = "closed " if self.is_closed else "" if self.stream is None: if self.name == "": return m + "Document()" % self._graft_id return m + "Document('%s')" % (self.name,) return m + "Document('%s', )" % (self.name, self._graft_id) def __contains__(self, loc) -> bool: if type(loc) is int: if loc < self.page_count: return True return False if type(loc) not in (tuple, list) or len(loc) != 2: return False chapter, pno = loc if (type(chapter) != int or chapter < 0 or chapter >= self.chapter_count ): return False if (type(pno) != int or pno < 0 or pno >= self.chapter_page_count(chapter) ): return False return True def __getitem__(self, i: int =0)->"Page": assert isinstance(i, int) or (isinstance(i, tuple) and len(i) == 2 and all(isinstance(x, int) for x in i)) if i not in self: raise IndexError("page not in document") return self.load_page(i) def __delitem__(self, i: AnyType)->None: if not self.is_pdf: raise ValueError("is no PDF") if type(i) is int: return self.delete_page(i) if type(i) in (list, tuple, range): return self.delete_pages(i) if type(i) is not slice: raise ValueError("bad argument type") pc = self.page_count start = i.start if i.start else 0 stop = i.stop if i.stop else pc step = i.step if i.step else 1 while start < 0: start += pc if start >= pc: raise ValueError("bad page number(s)") while stop < 0: stop += pc if stop > pc: raise ValueError("bad page number(s)") return self.delete_pages(range(start, stop, step)) def pages(self, start: OptInt =None, stop: OptInt =None, step: OptInt =None): """Return a generator iterator over a page range. Arguments have the same meaning as for the range() built-in. """ # set the start value start = start or 0 while start < 0: start += self.page_count if start not in range(self.page_count): raise ValueError("bad start page number") # set the stop value stop = stop if stop is not None and stop <= self.page_count else self.page_count # set the step value if step == 0: raise ValueError("arg 3 must not be zero") if step is None: if start > stop: step = -1 else: step = 1 for pno in range(start, stop, step): yield (self.load_page(pno)) def __len__(self) -> int: return self.page_count def _forget_page(self, page: "struct Page *"): """Remove a page from document page dict.""" pid = id(page) if pid in self._page_refs: self._page_refs[pid] = None def _reset_page_refs(self): """Invalidate all pages in document dictionary.""" if getattr(self, "is_closed", True): return for page in self._page_refs.values(): if page: page._erase() page = None self._page_refs.clear() def _cleanup(self): self._reset_page_refs() for k in self.Graftmaps.keys(): self.Graftmaps[k] = None self.Graftmaps = {} self.ShownPages = {} self.InsertedImages = {} self.FontInfos = [] self.metadata = None self.stream = None self.is_closed = True def close(self): """Close the document.""" if getattr(self, "is_closed", False): raise ValueError("document closed") self._cleanup() if getattr(self, "thisown", False): self.__swig_destroy__(self) return else: raise RuntimeError("document object unavailable") def __del__(self): if not type(self) is Document: return self._cleanup() if getattr(self, "thisown", False): self.__swig_destroy__(self) def __enter__(self): return self def __exit__(self, *args): self.close() %} } }; /*****************************************************************************/ // fz_page /*****************************************************************************/ %nodefaultctor; struct Page { %extend { ~Page() { DEBUGMSG1("Page"); fz_page *this_page = (fz_page *) $self; fz_drop_page(gctx, this_page); DEBUGMSG2; } //---------------------------------------------------------------- // bound() //---------------------------------------------------------------- FITZEXCEPTION(bound, !result) PARENTCHECK(bound, """Get page rectangle.""") %pythonappend bound %{ val = Rect(val) if val.is_infinite and self.parent.is_pdf: cb = self.cropbox w, h = cb.width, cb.height if self.rotation not in (0, 180): w, h = h, w val = Rect(0, 0, w, h) msg = TOOLS.mupdf_warnings(reset=False).splitlines()[-1] print(msg, file=sys.stderr) %} PyObject *bound() { fz_rect rect = fz_infinite_rect; fz_try(gctx) { rect = fz_bound_page(gctx, (fz_page *) $self); } fz_catch(gctx) { ; } return JM_py_from_rect(rect); } %pythoncode %{rect = property(bound, doc="page rectangle")%} //---------------------------------------------------------------- // Page.get_image_bbox //---------------------------------------------------------------- %pythonprepend get_image_bbox %{ """Get rectangle occupied by image 'name'. 'name' is either an item of the image list, or the referencing name string - elem[7] of the resp. item. Option 'transform' also returns the image transformation matrix. """ CheckParent(self) doc = self.parent if doc.is_closed or doc.is_encrypted: raise ValueError("document closed or encrypted") inf_rect = Rect(1, 1, -1, -1) null_mat = Matrix() if transform: rc = (inf_rect, null_mat) else: rc = inf_rect if type(name) in (list, tuple): if not type(name[-1]) is int: raise ValueError("need item of full page image list") item = name else: imglist = [i for i in doc.get_page_images(self.number, True) if name == i[7]] if len(imglist) == 1: item = imglist[0] elif imglist == []: raise ValueError("bad image name") else: raise ValueError("found multiple images named '%s'." % name) xref = item[-1] if xref != 0 or transform == True: try: return self.get_image_rects(item, transform=transform)[0] except: return inf_rect %} %pythonappend get_image_bbox %{ if not bool(val): return rc for v in val: if v[0] != item[-3]: continue q = Quad(v[1]) bbox = q.rect if transform == 0: rc = bbox break hm = Matrix(util_hor_matrix(q.ll, q.lr)) h = abs(q.ll - q.ul) w = abs(q.ur - q.ul) m0 = Matrix(1 / w, 0, 0, 1 / h, 0, 0) m = ~(hm * m0) rc = (bbox, m) break val = rc%} PyObject * get_image_bbox(PyObject *name, int transform=0) { pdf_page *pdf_page = pdf_page_from_fz_page(gctx, (fz_page *) $self); PyObject *rc =NULL; fz_try(gctx) { rc = JM_image_reporter(gctx, pdf_page); } fz_catch(gctx) { Py_RETURN_NONE; } return rc; } //---------------------------------------------------------------- // run() //---------------------------------------------------------------- FITZEXCEPTION(run, !result) PARENTCHECK(run, """Run page through a device.""") PyObject *run(struct DeviceWrapper *dw, PyObject *m) { fz_try(gctx) { fz_run_page(gctx, (fz_page *) $self, dw->device, JM_matrix_from_py(m), NULL); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // Page.extend_textpage //---------------------------------------------------------------- FITZEXCEPTION(extend_textpage, !result) PyObject * extend_textpage(struct TextPage *tpage, int flags=0, PyObject *matrix=NULL) { fz_page *page = (fz_page *) $self; fz_stext_page *tp = (fz_stext_page *) tpage; fz_device *dev = NULL; fz_stext_options options; memset(&options, 0, sizeof options); options.flags = flags; fz_try(gctx) { fz_matrix ctm = JM_matrix_from_py(matrix); dev = fz_new_stext_device(gctx, tp, &options); fz_run_page(gctx, page, dev, ctm, NULL); fz_close_device(gctx, dev); } fz_always(gctx) { fz_drop_device(gctx, dev); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // Page.get_textpage //---------------------------------------------------------------- FITZEXCEPTION(_get_textpage, !result) %pythonappend _get_textpage %{val.thisown = True%} struct TextPage * _get_textpage(PyObject *clip=NULL, int flags=0, PyObject *matrix=NULL) { fz_stext_page *tpage=NULL; fz_page *page = (fz_page *) $self; fz_device *dev = NULL; fz_stext_options options; memset(&options, 0, sizeof options); options.flags = flags; fz_try(gctx) { // Default to page's rect if `clip` not specified, for #2048. fz_rect rect = (clip==Py_None) ? fz_bound_page(gctx, page) : JM_rect_from_py(clip); fz_matrix ctm = JM_matrix_from_py(matrix); tpage = fz_new_stext_page(gctx, rect); dev = fz_new_stext_device(gctx, tpage, &options); fz_run_page(gctx, page, dev, ctm, NULL); fz_close_device(gctx, dev); } fz_always(gctx) { fz_drop_device(gctx, dev); } fz_catch(gctx) { return NULL; } return (struct TextPage *) tpage; } %pythoncode %{ def get_textpage(self, clip: rect_like = None, flags: int = 0, matrix=None) -> "TextPage": CheckParent(self) if matrix is None: matrix = Matrix(1, 1) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) try: textpage = self._get_textpage(clip, flags=flags, matrix=matrix) finally: if old_rotation != 0: self.set_rotation(old_rotation) textpage.parent = weakref.proxy(self) return textpage %} /* ****************** currently inactive //---------------------------------------------------------------- // Page._get_textpage_ocr //---------------------------------------------------------------- FITZEXCEPTION(_get_textpage_ocr, !result) %pythonappend _get_textpage_ocr %{val.thisown = True%} struct TextPage * _get_textpage_ocr(PyObject *clip=NULL, int flags=0, const char *language=NULL, const char *tessdata=NULL) { fz_stext_page *textpage=NULL; fz_try(gctx) { fz_rect rect = JM_rect_from_py(clip); textpage = JM_new_stext_page_ocr_from_page(gctx, (fz_page *) $self, rect, flags, language, tessdata); } fz_catch(gctx) { return NULL; } return (struct TextPage *) textpage; } ************************* */ //---------------------------------------------------------------- // Page.language //---------------------------------------------------------------- %pythoncode%{@property%} %pythonprepend language %{"""Page language."""%} PyObject *language() { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!pdfpage) Py_RETURN_NONE; pdf_obj *lang = pdf_dict_get_inheritable(gctx, pdfpage->obj, PDF_NAME(Lang)); if (!lang) Py_RETURN_NONE; return Py_BuildValue("s", pdf_to_str_buf(gctx, lang)); } //---------------------------------------------------------------- // Page.set_language //---------------------------------------------------------------- FITZEXCEPTION(set_language, !result) PARENTCHECK(set_language, """Set PDF page default language.""") PyObject *set_language(char *language=NULL) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(pdfpage); fz_text_language lang; char buf[8]; if (!language) { pdf_dict_del(gctx, pdfpage->obj, PDF_NAME(Lang)); } else { lang = fz_text_language_from_string(language); pdf_dict_put_text_string(gctx, pdfpage->obj, PDF_NAME(Lang), fz_string_from_text_language(buf, lang)); } } fz_catch(gctx) { return NULL; } Py_RETURN_TRUE; } //---------------------------------------------------------------- // Page.get_svg_image //---------------------------------------------------------------- FITZEXCEPTION(get_svg_image, !result) PARENTCHECK(get_svg_image, """Make SVG image from page.""") PyObject *get_svg_image(PyObject *matrix = NULL, int text_as_path=1) { fz_rect mediabox = fz_bound_page(gctx, (fz_page *) $self); fz_device *dev = NULL; fz_buffer *res = NULL; PyObject *text = NULL; fz_matrix ctm = JM_matrix_from_py(matrix); fz_output *out = NULL; fz_var(out); fz_var(dev); fz_var(res); fz_rect tbounds = mediabox; int text_option = (text_as_path == 1) ? FZ_SVG_TEXT_AS_PATH : FZ_SVG_TEXT_AS_TEXT; tbounds = fz_transform_rect(tbounds, ctm); fz_try(gctx) { res = fz_new_buffer(gctx, 1024); out = fz_new_output_with_buffer(gctx, res); dev = fz_new_svg_device(gctx, out, tbounds.x1-tbounds.x0, // width tbounds.y1-tbounds.y0, // height text_option, 1); fz_run_page(gctx, (fz_page *) $self, dev, ctm, NULL); fz_close_device(gctx, dev); text = JM_EscapeStrFromBuffer(gctx, res); } fz_always(gctx) { fz_drop_device(gctx, dev); fz_drop_output(gctx, out); fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return text; } //---------------------------------------------------------------- // page set opacity //---------------------------------------------------------------- FITZEXCEPTION(_set_opacity, !result) %pythonprepend _set_opacity %{ if CA >= 1 and ca >= 1 and blendmode == None: return None tCA = int(round(max(CA , 0) * 100)) if tCA >= 100: tCA = 99 tca = int(round(max(ca, 0) * 100)) if tca >= 100: tca = 99 gstate = "fitzca%02i%02i" % (tCA, tca) %} PyObject * _set_opacity(char *gstate=NULL, float CA=1, float ca=1, char *blendmode=NULL) { if (!gstate) Py_RETURN_NONE; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(page); pdf_obj *resources = pdf_dict_get(gctx, page->obj, PDF_NAME(Resources)); if (!resources) { resources = pdf_dict_put_dict(gctx, page->obj, PDF_NAME(Resources), 2); } pdf_obj *extg = pdf_dict_get(gctx, resources, PDF_NAME(ExtGState)); if (!extg) { extg = pdf_dict_put_dict(gctx, resources, PDF_NAME(ExtGState), 2); } int i, n = pdf_dict_len(gctx, extg); for (i = 0; i < n; i++) { pdf_obj *o1 = pdf_dict_get_key(gctx, extg, i); char *name = (char *) pdf_to_name(gctx, o1); if (strcmp(name, gstate) == 0) goto finished; } pdf_obj *opa = pdf_new_dict(gctx, page->doc, 3); pdf_dict_put_real(gctx, opa, PDF_NAME(CA), (double) CA); pdf_dict_put_real(gctx, opa, PDF_NAME(ca), (double) ca); pdf_dict_puts_drop(gctx, extg, gstate, opa); finished:; } fz_always(gctx) { } fz_catch(gctx) { return NULL; } return Py_BuildValue("s", gstate); } //---------------------------------------------------------------- // page add_caret_annot //---------------------------------------------------------------- FITZEXCEPTION(_add_caret_annot, !result) struct Annot * _add_caret_annot(PyObject *point) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; fz_try(gctx) { annot = pdf_create_annot(gctx, page, PDF_ANNOT_CARET); if (point) { fz_point p = JM_point_from_py(point); fz_rect r = pdf_annot_rect(gctx, annot); r = fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0); pdf_set_annot_rect(gctx, annot, r); } pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addRedactAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_redact_annot, !result) struct Annot * _add_redact_annot(PyObject *quad, PyObject *text=NULL, PyObject *da_str=NULL, int align=0, PyObject *fill=NULL, PyObject *text_color=NULL) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; float fcol[4] = { 1, 1, 1, 0}; int nfcol = 0, i; fz_try(gctx) { annot = pdf_create_annot(gctx, page, PDF_ANNOT_REDACT); pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_quad q = JM_quad_from_py(quad); fz_rect r = fz_rect_from_quad(q); // TODO calculate de-rotated rect pdf_set_annot_rect(gctx, annot, r); if (EXISTS(fill)) { JM_color_FromSequence(fill, &nfcol, fcol); pdf_obj *arr = pdf_new_array(gctx, page->doc, nfcol); for (i = 0; i < nfcol; i++) { pdf_array_push_real(gctx, arr, fcol[i]); } pdf_dict_put_drop(gctx, annot_obj, PDF_NAME(IC), arr); } if (EXISTS(text)) { const char *otext = PyUnicode_AsUTF8(text); pdf_dict_puts_drop(gctx, annot_obj, "OverlayText", pdf_new_text_string(gctx, otext)); pdf_dict_put_text_string(gctx,annot_obj, PDF_NAME(DA), PyUnicode_AsUTF8(da_str)); pdf_dict_put_int(gctx, annot_obj, PDF_NAME(Q), (int64_t) align); } pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addLineAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_line_annot, !result) struct Annot * _add_line_annot(PyObject *p1, PyObject *p2) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; fz_try(gctx) { ASSERT_PDF(page); annot = pdf_create_annot(gctx, page, PDF_ANNOT_LINE); fz_point a = JM_point_from_py(p1); fz_point b = JM_point_from_py(p2); pdf_set_annot_line(gctx, annot, a, b); pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addTextAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_text_annot, !result) struct Annot * _add_text_annot(PyObject *point, char *text, char *icon=NULL) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; fz_rect r; fz_point p = JM_point_from_py(point); fz_var(annot); fz_try(gctx) { ASSERT_PDF(page); annot = pdf_create_annot(gctx, page, PDF_ANNOT_TEXT); r = pdf_annot_rect(gctx, annot); r = fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0); pdf_set_annot_rect(gctx, annot, r); pdf_set_annot_contents(gctx, annot, text); if (icon) { pdf_set_annot_icon_name(gctx, annot, icon); } pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addInkAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_ink_annot, !result) struct Annot * _add_ink_annot(PyObject *list) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; PyObject *p = NULL, *sublist = NULL; pdf_obj *inklist = NULL, *stroke = NULL; fz_matrix ctm, inv_ctm; fz_point point; fz_var(annot); fz_try(gctx) { ASSERT_PDF(page); if (!PySequence_Check(list)) { RAISEPY(gctx, MSG_BAD_ARG_INK_ANNOT, PyExc_ValueError); } pdf_page_transform(gctx, page, NULL, &ctm); inv_ctm = fz_invert_matrix(ctm); annot = pdf_create_annot(gctx, page, PDF_ANNOT_INK); pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); Py_ssize_t i, j, n0 = PySequence_Size(list), n1; inklist = pdf_new_array(gctx, page->doc, n0); for (j = 0; j < n0; j++) { sublist = PySequence_ITEM(list, j); n1 = PySequence_Size(sublist); stroke = pdf_new_array(gctx, page->doc, 2 * n1); for (i = 0; i < n1; i++) { p = PySequence_ITEM(sublist, i); if (!PySequence_Check(p) || PySequence_Size(p) != 2) { RAISEPY(gctx, MSG_BAD_ARG_INK_ANNOT, PyExc_ValueError); } point = fz_transform_point(JM_point_from_py(p), inv_ctm); Py_CLEAR(p); pdf_array_push_real(gctx, stroke, point.x); pdf_array_push_real(gctx, stroke, point.y); } pdf_array_push_drop(gctx, inklist, stroke); stroke = NULL; Py_CLEAR(sublist); } pdf_dict_put_drop(gctx, annot_obj, PDF_NAME(InkList), inklist); inklist = NULL; pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { Py_CLEAR(p); Py_CLEAR(sublist); return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addStampAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_stamp_annot, !result) struct Annot * _add_stamp_annot(PyObject *rect, int stamp=0) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; pdf_obj *stamp_id[] = {PDF_NAME(Approved), PDF_NAME(AsIs), PDF_NAME(Confidential), PDF_NAME(Departmental), PDF_NAME(Experimental), PDF_NAME(Expired), PDF_NAME(Final), PDF_NAME(ForComment), PDF_NAME(ForPublicRelease), PDF_NAME(NotApproved), PDF_NAME(NotForPublicRelease), PDF_NAME(Sold), PDF_NAME(TopSecret), PDF_NAME(Draft)}; int n = nelem(stamp_id); pdf_obj *name = stamp_id[0]; fz_try(gctx) { ASSERT_PDF(page); fz_rect r = JM_rect_from_py(rect); if (fz_is_infinite_rect(r) || fz_is_empty_rect(r)) { RAISEPY(gctx, MSG_BAD_RECT, PyExc_ValueError); } if (INRANGE(stamp, 0, n-1)) { name = stamp_id[stamp]; } annot = pdf_create_annot(gctx, page, PDF_ANNOT_STAMP); pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_set_annot_rect(gctx, annot, r); pdf_dict_put(gctx, annot_obj, PDF_NAME(Name), name); pdf_set_annot_contents(gctx, annot, pdf_dict_get_name(gctx, annot_obj, PDF_NAME(Name))); pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addFileAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_file_annot, !result) struct Annot * _add_file_annot(PyObject *point, PyObject *buffer, char *filename, char *ufilename=NULL, char *desc=NULL, char *icon=NULL) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; char *uf = ufilename, *d = desc; if (!ufilename) uf = filename; if (!desc) d = filename; fz_buffer *filebuf = NULL; fz_rect r; fz_point p = JM_point_from_py(point); fz_var(filebuf); fz_try(gctx) { ASSERT_PDF(page); filebuf = JM_BufferFromBytes(gctx, buffer); if (!filebuf) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_TypeError); } annot = pdf_create_annot(gctx, page, PDF_ANNOT_FILE_ATTACHMENT); pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); r = pdf_annot_rect(gctx, annot); r = fz_make_rect(p.x, p.y, p.x + r.x1 - r.x0, p.y + r.y1 - r.y0); pdf_set_annot_rect(gctx, annot, r); int flags = PDF_ANNOT_IS_PRINT; pdf_set_annot_flags(gctx, annot, flags); if (icon) pdf_set_annot_icon_name(gctx, annot, icon); pdf_obj *val = JM_embed_file(gctx, page->doc, filebuf, filename, uf, d, 1); pdf_dict_put_drop(gctx, annot_obj, PDF_NAME(FS), val); pdf_dict_put_text_string(gctx, annot_obj, PDF_NAME(Contents), filename); pdf_update_annot(gctx, annot); pdf_set_annot_rect(gctx, annot, r); pdf_set_annot_flags(gctx, annot, flags); JM_add_annot_id(gctx, annot, "A"); } fz_always(gctx) { fz_drop_buffer(gctx, filebuf); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page: add a text marker annotation //---------------------------------------------------------------- FITZEXCEPTION(_add_text_marker, !result) %pythonprepend _add_text_marker %{ CheckParent(self) if not self.parent.is_pdf: raise ValueError("is no PDF")%} %pythonappend _add_text_marker %{ if not val: return None val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val%} struct Annot * _add_text_marker(PyObject *quads, int annot_type) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; PyObject *item = NULL; int rotation = JM_page_rotation(gctx, pdfpage); fz_quad q; fz_var(annot); fz_var(item); fz_try(gctx) { if (rotation != 0) { pdf_dict_put_int(gctx, pdfpage->obj, PDF_NAME(Rotate), 0); } annot = pdf_create_annot(gctx, pdfpage, annot_type); Py_ssize_t i, len = PySequence_Size(quads); for (i = 0; i < len; i++) { item = PySequence_ITEM(quads, i); q = JM_quad_from_py(item); Py_DECREF(item); pdf_add_annot_quad_point(gctx, annot, q); } pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_always(gctx) { if (rotation != 0) { pdf_dict_put_int(gctx, pdfpage->obj, PDF_NAME(Rotate), rotation); } } fz_catch(gctx) { pdf_drop_annot(gctx, annot); return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page: add circle or rectangle annotation //---------------------------------------------------------------- FITZEXCEPTION(_add_square_or_circle, !result) struct Annot * _add_square_or_circle(PyObject *rect, int annot_type) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; fz_try(gctx) { fz_rect r = JM_rect_from_py(rect); if (fz_is_infinite_rect(r) || fz_is_empty_rect(r)) { RAISEPY(gctx, MSG_BAD_RECT, PyExc_ValueError); } annot = pdf_create_annot(gctx, page, annot_type); pdf_set_annot_rect(gctx, annot, r); pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page: add multiline annotation //---------------------------------------------------------------- FITZEXCEPTION(_add_multiline, !result) struct Annot * _add_multiline(PyObject *points, int annot_type) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *annot = NULL; fz_try(gctx) { Py_ssize_t i, n = PySequence_Size(points); if (n < 2) { RAISEPY(gctx, MSG_BAD_ARG_POINTS, PyExc_ValueError); } annot = pdf_create_annot(gctx, page, annot_type); for (i = 0; i < n; i++) { PyObject *p = PySequence_ITEM(points, i); if (PySequence_Size(p) != 2) { Py_DECREF(p); RAISEPY(gctx, MSG_BAD_ARG_POINTS, PyExc_ValueError); } fz_point point = JM_point_from_py(p); Py_DECREF(p); pdf_add_annot_vertex(gctx, annot, point); } pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page addFreetextAnnot //---------------------------------------------------------------- FITZEXCEPTION(_add_freetext_annot, !result) %pythonappend _add_freetext_annot %{ ap = val._getAP() BT = ap.find(b"BT") ET = ap.find(b"ET") + 2 ap = ap[BT:ET] w = rect[2]-rect[0] h = rect[3]-rect[1] if rotate in (90, -90, 270): w, h = h, w re = b"0 0 %g %g re" % (w, h) ap = re + b"\nW\nn\n" + ap ope = None bwidth = b"" fill_string = ColorCode(fill_color, "f").encode() if fill_string: fill_string += b"\n" ope = b"f" stroke_string = ColorCode(border_color, "c").encode() if stroke_string: stroke_string += b"\n" bwidth = b"1 w\n" ope = b"S" if fill_string and stroke_string: ope = b"B" if ope != None: ap = bwidth + fill_string + stroke_string + re + b"\n" + ope + b"\n" + ap val._setAP(ap) %} struct Annot * _add_freetext_annot(PyObject *rect, char *text, float fontsize=11, char *fontname=NULL, PyObject *text_color=NULL, PyObject *fill_color=NULL, PyObject *border_color=NULL, int align=0, int rotate=0) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); float fcol[4] = {1, 1, 1, 1}; // fill color: white int nfcol = 0; JM_color_FromSequence(fill_color, &nfcol, fcol); float tcol[4] = {0, 0, 0, 0}; // std. text color: black int ntcol = 0; JM_color_FromSequence(text_color, &ntcol, tcol); fz_rect r = JM_rect_from_py(rect); pdf_annot *annot = NULL; fz_try(gctx) { if (fz_is_infinite_rect(r) || fz_is_empty_rect(r)) { RAISEPY(gctx, MSG_BAD_RECT, PyExc_ValueError); } annot = pdf_create_annot(gctx, page, PDF_ANNOT_FREE_TEXT); pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_set_annot_contents(gctx, annot, text); pdf_set_annot_rect(gctx, annot, r); pdf_dict_put_int(gctx, annot_obj, PDF_NAME(Rotate), rotate); pdf_dict_put_int(gctx, annot_obj, PDF_NAME(Q), align); if (nfcol > 0) { pdf_set_annot_color(gctx, annot, nfcol, fcol); } // insert the default appearance string JM_make_annot_DA(gctx, annot, ntcol, tcol, fontname, fontsize); pdf_update_annot(gctx, annot); JM_add_annot_id(gctx, annot, "A"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } %pythoncode %{ @property def rotation_matrix(self) -> Matrix: """Reflects page rotation.""" return Matrix(TOOLS._rotate_matrix(self)) @property def derotation_matrix(self) -> Matrix: """Reflects page de-rotation.""" return Matrix(TOOLS._derotate_matrix(self)) def add_caret_annot(self, point: point_like) -> "struct Annot *": """Add a 'Caret' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_caret_annot(point) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_strikeout_annot(self, quads=None, start=None, stop=None, clip=None) -> "struct Annot *": """Add a 'StrikeOut' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, PDF_ANNOT_STRIKE_OUT) def add_underline_annot(self, quads=None, start=None, stop=None, clip=None) -> "struct Annot *": """Add a 'Underline' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, PDF_ANNOT_UNDERLINE) def add_squiggly_annot(self, quads=None, start=None, stop=None, clip=None) -> "struct Annot *": """Add a 'Squiggly' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, PDF_ANNOT_SQUIGGLY) def add_highlight_annot(self, quads=None, start=None, stop=None, clip=None) -> "struct Annot *": """Add a 'Highlight' annotation.""" if quads is None: q = get_highlight_selection(self, start=start, stop=stop, clip=clip) else: q = CheckMarkerArg(quads) return self._add_text_marker(q, PDF_ANNOT_HIGHLIGHT) def add_rect_annot(self, rect: rect_like) -> "struct Annot *": """Add a 'Square' (rectangle) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_square_or_circle(rect, PDF_ANNOT_SQUARE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_circle_annot(self, rect: rect_like) -> "struct Annot *": """Add a 'Circle' (ellipse, oval) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_square_or_circle(rect, PDF_ANNOT_CIRCLE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_text_annot(self, point: point_like, text: str, icon: str ="Note") -> "struct Annot *": """Add a 'Text' (sticky note) annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_text_annot(point, text, icon=icon) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_line_annot(self, p1: point_like, p2: point_like) -> "struct Annot *": """Add a 'Line' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_line_annot(p1, p2) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_polyline_annot(self, points: list) -> "struct Annot *": """Add a 'PolyLine' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_multiline(points, PDF_ANNOT_POLY_LINE) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_polygon_annot(self, points: list) -> "struct Annot *": """Add a 'Polygon' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_multiline(points, PDF_ANNOT_POLYGON) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_stamp_annot(self, rect: rect_like, stamp: int =0) -> "struct Annot *": """Add a ('rubber') 'Stamp' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_stamp_annot(rect, stamp) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_ink_annot(self, handwriting: list) -> "struct Annot *": """Add a 'Ink' ('handwriting') annotation. The argument must be a list of lists of point_likes. """ old_rotation = annot_preprocess(self) try: annot = self._add_ink_annot(handwriting) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_file_annot(self, point: point_like, buffer: ByteString, filename: str, ufilename: OptStr =None, desc: OptStr =None, icon: OptStr =None) -> "struct Annot *": """Add a 'FileAttachment' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_file_annot(point, buffer, filename, ufilename=ufilename, desc=desc, icon=icon) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_freetext_annot(self, rect: rect_like, text: str, fontsize: float =11, fontname: OptStr =None, border_color: OptSeq =None, text_color: OptSeq =None, fill_color: OptSeq =None, align: int =0, rotate: int =0) -> "struct Annot *": """Add a 'FreeText' annotation.""" old_rotation = annot_preprocess(self) try: annot = self._add_freetext_annot(rect, text, fontsize=fontsize, fontname=fontname, border_color=border_color,text_color=text_color, fill_color=fill_color, align=align, rotate=rotate) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) return annot def add_redact_annot(self, quad, text: OptStr =None, fontname: OptStr =None, fontsize: float =11, align: int =0, fill: OptSeq =None, text_color: OptSeq =None, cross_out: bool =True) -> "struct Annot *": """Add a 'Redact' annotation.""" da_str = None if text: CheckColor(fill) CheckColor(text_color) if not fontname: fontname = "Helv" if not fontsize: fontsize = 11 if not text_color: text_color = (0, 0, 0) if hasattr(text_color, "__float__"): text_color = (text_color, text_color, text_color) if len(text_color) > 3: text_color = text_color[:3] fmt = "{:g} {:g} {:g} rg /{f:s} {s:g} Tf" da_str = fmt.format(*text_color, f=fontname, s=fontsize) if fill is None: fill = (1, 1, 1) if fill: if hasattr(fill, "__float__"): fill = (fill, fill, fill) if len(fill) > 3: fill = fill[:3] old_rotation = annot_preprocess(self) try: annot = self._add_redact_annot(quad, text=text, da_str=da_str, align=align, fill=fill) finally: if old_rotation != 0: self.set_rotation(old_rotation) annot_postprocess(self, annot) #------------------------------------------------------------- # change appearance to show a crossed-out rectangle #------------------------------------------------------------- if cross_out: ap_tab = annot._getAP().splitlines()[:-1] # get the 4 commands only _, LL, LR, UR, UL = ap_tab ap_tab.append(LR) ap_tab.append(LL) ap_tab.append(UR) ap_tab.append(LL) ap_tab.append(UL) ap_tab.append(b"S") ap = b"\n".join(ap_tab) annot._setAP(ap, 0) return annot %} //---------------------------------------------------------------- // page load annot by name or xref //---------------------------------------------------------------- FITZEXCEPTION(_load_annot, !result) struct Annot * _load_annot(char *name, int xref) { pdf_annot *annot = NULL; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(page); if (xref == 0) annot = JM_get_annot_by_name(gctx, page, name); else annot = JM_get_annot_by_xref(gctx, page, xref); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page load widget by xref //---------------------------------------------------------------- FITZEXCEPTION(load_widget, !result) %pythonprepend load_widget %{ """Load a widget by its xref.""" CheckParent(self) %} %pythonappend load_widget %{ if not val: return val val.thisown = True val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val widget = Widget() TOOLS._fill_widget(val, widget) val = widget %} struct Annot * load_widget(int xref) { pdf_annot *annot = NULL; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(page); annot = JM_get_widget_by_xref(gctx, page, xref); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // page list Resource/Properties //---------------------------------------------------------------- FITZEXCEPTION(_get_resource_properties, !result) PyObject * _get_resource_properties() { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); PyObject *rc; fz_try(gctx) { ASSERT_PDF(page); rc = JM_get_resource_properties(gctx, page->obj); } fz_catch(gctx) { return NULL; } return rc; } //---------------------------------------------------------------- // page list Resource/Properties //---------------------------------------------------------------- FITZEXCEPTION(_set_resource_property, !result) PyObject * _set_resource_property(char *name, int xref) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(page); JM_set_resource_property(gctx, page->obj, name, xref); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def _get_optional_content(self, oc: OptInt) -> OptStr: if oc == None or oc == 0: return None doc = self.parent check = doc.xref_object(oc, compressed=True) if not ("/Type/OCG" in check or "/Type/OCMD" in check): raise ValueError("bad optional content: 'oc'") props = {} for p, x in self._get_resource_properties(): props[x] = p if oc in props.keys(): return props[oc] i = 0 mc = "MC%i" % i while mc in props.values(): i += 1 mc = "MC%i" % i self._set_resource_property(mc, oc) return mc def get_oc_items(self) -> list: """Get OCGs and OCMDs used in the page's contents. Returns: List of items (name, xref, type), where type is one of "ocg" / "ocmd", and name is the property name. """ rc = [] for pname, xref in self._get_resource_properties(): text = self.parent.xref_object(xref, compressed=True) if "/Type/OCG" in text: octype = "ocg" elif "/Type/OCMD" in text: octype = "ocmd" else: continue rc.append((pname, xref, octype)) return rc %} //---------------------------------------------------------------- // page get list of annot names //---------------------------------------------------------------- PARENTCHECK(annot_names, """List of names of annotations, fields and links.""") PyObject *annot_names() { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) { PyObject *rc = PyList_New(0); return rc; } return JM_get_annot_id_list(gctx, page); } //---------------------------------------------------------------- // page retrieve list of annotation xrefs //---------------------------------------------------------------- PARENTCHECK(annot_xrefs,"""List of xref numbers of annotations, fields and links.""") PyObject *annot_xrefs() { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) { PyObject *rc = PyList_New(0); return rc; } return JM_get_annot_xref_list(gctx, page->obj); } %pythoncode %{ def load_annot(self, ident: typing.Union[str, int]) -> "struct Annot *": """Load an annot by name (/NM key) or xref. Args: ident: identifier, either name (str) or xref (int). """ CheckParent(self) if type(ident) is str: xref = 0 name = ident elif type(ident) is int: xref = ident name = None else: raise ValueError("identifier must be string or integer") val = self._load_annot(name, xref) if not val: return val val.thisown = True val.parent = weakref.proxy(self) self._annot_refs[id(val)] = val return val #--------------------------------------------------------------------- # page addWidget #--------------------------------------------------------------------- def add_widget(self, widget: Widget) -> "struct Annot *": """Add a 'Widget' (form field).""" CheckParent(self) doc = self.parent if not doc.is_pdf: raise ValueError("is no PDF") widget._validate() annot = self._addWidget(widget.field_type, widget.field_name) if not annot: return None annot.thisown = True annot.parent = weakref.proxy(self) # owning page object self._annot_refs[id(annot)] = annot widget.parent = annot.parent widget._annot = annot widget.update() return annot %} FITZEXCEPTION(_addWidget, !result) struct Annot *_addWidget(int field_type, char *field_name) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_document *pdf = page->doc; pdf_annot *annot = NULL; fz_var(annot); fz_try(gctx) { annot = JM_create_widget(gctx, pdf, page, field_type, field_name); if (!annot) { RAISEPY(gctx, "cannot create widget", PyExc_RuntimeError); } JM_add_annot_id(gctx, annot, "W"); } fz_catch(gctx) { return NULL; } return (struct Annot *) annot; } //---------------------------------------------------------------- // Page.get_displaylist //---------------------------------------------------------------- FITZEXCEPTION(get_displaylist, !result) %pythonprepend get_displaylist %{ """Make a DisplayList from the page for Pixmap generation. Include (default) or exclude annotations.""" CheckParent(self) %} %pythonappend get_displaylist %{val.thisown = True%} struct DisplayList *get_displaylist(int annots=1) { fz_display_list *dl = NULL; fz_try(gctx) { if (annots) { dl = fz_new_display_list_from_page(gctx, (fz_page *) $self); } else { dl = fz_new_display_list_from_page_contents(gctx, (fz_page *) $self); } } fz_catch(gctx) { return NULL; } return (struct DisplayList *) dl; } //---------------------------------------------------------------- // Page.get_drawings //---------------------------------------------------------------- %pythoncode %{ def get_drawings(self, extended: bool = False) -> list: """Retrieve vector graphics. The extended version includes clips. Note: For greater comfort, this method converts point-like, rect-like, quad-like tuples of the C version to respective Point / Rect / Quad objects. It also adds default items that are missing in original path types. """ allkeys = ( "closePath", "fill", "color", "width", "lineCap", "lineJoin", "dashes", "stroke_opacity", "fill_opacity", "even_odd", ) val = self.get_cdrawings(extended=extended) for i in range(len(val)): npath = val[i] if not npath["type"].startswith("clip"): npath["rect"] = Rect(npath["rect"]) else: npath["scissor"] = Rect(npath["scissor"]) if npath["type"]!="group": items = npath["items"] newitems = [] for item in items: cmd = item[0] rest = item[1:] if cmd == "re": item = ("re", Rect(rest[0]).normalize(), rest[1]) elif cmd == "qu": item = ("qu", Quad(rest[0])) else: item = tuple([cmd] + [Point(i) for i in rest]) newitems.append(item) npath["items"] = newitems if npath["type"] in ("f", "s"): for k in allkeys: npath[k] = npath.get(k) val[i] = npath return val class Drawpath(object): """Reflects a path dictionary from get_cdrawings().""" def __init__(self, **args): self.__dict__.update(args) class Drawpathlist(object): """List of Path objects representing get_cdrawings() output.""" def __init__(self): self.paths = [] self.path_count = 0 self.group_count = 0 self.clip_count = 0 self.fill_count = 0 self.stroke_count = 0 self.fillstroke_count = 0 def append(self, path): self.paths.append(path) self.path_count += 1 if path.type == "clip": self.clip_count += 1 elif path.type == "group": self.group_count += 1 elif path.type == "f": self.fill_count += 1 elif path.type == "s": self.stroke_count += 1 elif path.type == "fs": self.fillstroke_count += 1 def clip_parents(self, i): """Return list of parent clip paths. Args: i: (int) return parents of this path. Returns: List of the clip parents.""" if i >= self.path_count: raise IndexError("bad path index") while i < 0: i += self.path_count lvl = self.paths[i].level clips = list( # clip paths before identified one reversed( [ p for p in self.paths[:i] if p.type == "clip" and p.level < lvl ] ) ) if clips == []: # none found: empty list return [] nclips = [clips[0]] # init return list for p in clips[1:]: if p.level >= nclips[-1].level: continue # only accept smaller clip levels nclips.append(p) return nclips def group_parents(self, i): """Return list of parent group paths. Args: i: (int) return parents of this path. Returns: List of the group parents.""" if i >= self.path_count: raise IndexError("bad path index") while i < 0: i += self.path_count lvl = self.paths[i].level groups = list( # group paths before identified one reversed( [ p for p in self.paths[:i] if p.type == "group" and p.level < lvl ] ) ) if groups == []: # none found: empty list return [] ngroups = [groups[0]] # init return list for p in groups[1:]: if p.level >= ngroups[-1].level: continue # only accept smaller group levels ngroups.append(p) return ngroups def __getitem__(self, item): return self.paths.__getitem__(item) def __len__(self): return self.paths.__len__() def get_lineart(self) -> object: """Get page drawings paths. Note: For greater comfort, this method converts point-like, rect-like, quad-like tuples of the C version to respective Point / Rect / Quad objects. Also adds default items that are missing in original path types. In contrast to get_drawings(), this output is an object. """ val = self.get_cdrawings(extended=True) paths = self.Drawpathlist() for path in val: npath = self.Drawpath(**path) if npath.type != "clip": npath.rect = Rect(path["rect"]) else: npath.scissor = Rect(path["scissor"]) if npath.type != "group": items = path["items"] newitems = [] for item in items: cmd = item[0] rest = item[1:] if cmd == "re": item = ("re", Rect(rest[0]).normalize(), rest[1]) elif cmd == "qu": item = ("qu", Quad(rest[0])) else: item = tuple([cmd] + [Point(i) for i in rest]) newitems.append(item) npath.items = newitems if npath.type == "f": npath.stroke_opacity = None npath.dashes = None npath.lineJoin = None npath.lineCap = None npath.color = None npath.width = None paths.append(npath) val = None return paths %} FITZEXCEPTION(get_cdrawings, !result) %pythonprepend get_cdrawings %{ """Extract vector graphics ("line art") from the page.""" CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) %} %pythonappend get_cdrawings %{ if old_rotation != 0: self.set_rotation(old_rotation) %} PyObject * get_cdrawings(PyObject *extended=NULL, PyObject *callback=NULL, PyObject *method=NULL) { fz_page *page = (fz_page *) $self; fz_device *dev = NULL; PyObject *rc = NULL; int clips = PyObject_IsTrue(extended); fz_var(rc); fz_try(gctx) { fz_rect prect = fz_bound_page(gctx, page); trace_device_ptm = fz_make_matrix(1, 0, 0, -1, 0, prect.y1); if (PyCallable_Check(callback) || method != Py_None) { dev = JM_new_lineart_device(gctx, callback, clips, method); } else { rc = PyList_New(0); dev = JM_new_lineart_device(gctx, rc, clips, method); } fz_run_page(gctx, page, dev, fz_identity, NULL); fz_close_device(gctx, dev); } fz_always(gctx) { fz_drop_device(gctx, dev); } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } if (PyCallable_Check(callback) || method != Py_None) { Py_RETURN_NONE; } return rc; } FITZEXCEPTION(get_bboxlog, !result) %pythonprepend get_bboxlog %{ CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) %} %pythonappend get_bboxlog %{ if old_rotation != 0: self.set_rotation(old_rotation) %} PyObject * get_bboxlog(PyObject *layers=NULL) { fz_page *page = (fz_page *) $self; fz_device *dev = NULL; PyObject *rc = PyList_New(0); int inc_layers = PyObject_IsTrue(layers); fz_try(gctx) { dev = JM_new_bbox_device(gctx, rc, inc_layers); fz_run_page(gctx, page, dev, fz_identity, NULL); fz_close_device(gctx, dev); } fz_always(gctx) { fz_drop_device(gctx, dev); } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } return rc; } FITZEXCEPTION(get_texttrace, !result) %pythonprepend get_texttrace %{ CheckParent(self) old_rotation = self.rotation if old_rotation != 0: self.set_rotation(0) %} %pythonappend get_texttrace %{ if old_rotation != 0: self.set_rotation(old_rotation) %} PyObject * get_texttrace() { fz_page *page = (fz_page *) $self; fz_device *dev = NULL; PyObject *rc = PyList_New(0); fz_try(gctx) { dev = JM_new_texttrace_device(gctx, rc); fz_rect prect = fz_bound_page(gctx, page); trace_device_rot = fz_identity; trace_device_ptm = fz_make_matrix(1, 0, 0, -1, 0, prect.y1); fz_run_page(gctx, page, dev, fz_identity, NULL); fz_close_device(gctx, dev); } fz_always(gctx) { fz_drop_device(gctx, dev); } fz_catch(gctx) { Py_CLEAR(rc); return NULL; } return rc; } //---------------------------------------------------------------- // Page apply redactions //---------------------------------------------------------------- FITZEXCEPTION(_apply_redactions, !result) PyObject *_apply_redactions(int images=PDF_REDACT_IMAGE_PIXELS) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); int success = 0; pdf_redact_options opts = {0}; opts.black_boxes = 0; // no black boxes opts.image_method = images; // how to treat images fz_try(gctx) { ASSERT_PDF(page); success = pdf_redact_page(gctx, page->doc, page, &opts); } fz_catch(gctx) { return NULL; } return JM_BOOL(success); } //---------------------------------------------------------------- // Page._makePixmap //---------------------------------------------------------------- FITZEXCEPTION(_makePixmap, !result) struct Pixmap * _makePixmap(struct Document *doc, PyObject *ctm, struct Colorspace *cs, int alpha=0, int annots=1, PyObject *clip=NULL) { fz_pixmap *pix = NULL; fz_try(gctx) { pix = JM_pixmap_from_page(gctx, (fz_document *) doc, (fz_page *) $self, ctm, (fz_colorspace *) cs, alpha, annots, clip); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pix; } //---------------------------------------------------------------- // Page.set_mediabox //---------------------------------------------------------------- FITZEXCEPTION(set_mediabox, !result) PARENTCHECK(set_mediabox, """Set the MediaBox.""") PyObject *set_mediabox(PyObject *rect) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); fz_try(gctx) { ASSERT_PDF(page); fz_rect mediabox = JM_rect_from_py(rect); if (fz_is_empty_rect(mediabox) || fz_is_infinite_rect(mediabox)) { RAISEPY(gctx, MSG_BAD_RECT, PyExc_ValueError); } pdf_dict_put_rect(gctx, page->obj, PDF_NAME(MediaBox), mediabox); pdf_dict_del(gctx, page->obj, PDF_NAME(CropBox)); pdf_dict_del(gctx, page->obj, PDF_NAME(ArtBox)); pdf_dict_del(gctx, page->obj, PDF_NAME(BleedBox)); pdf_dict_del(gctx, page->obj, PDF_NAME(TrimBox)); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // Page.load_links() //---------------------------------------------------------------- PARENTCHECK(load_links, """Get first Link.""") %pythonappend load_links %{ if val: val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val if self.parent.is_pdf: link_id = [x for x in self.annot_xrefs() if x[1] == PDF_ANNOT_LINK][0] val.xref = link_id[0] val.id = link_id[2] else: val.xref = 0 val.id = "" %} struct Link *load_links() { fz_link *l = NULL; fz_try(gctx) { l = fz_load_links(gctx, (fz_page *) $self); } fz_catch(gctx) { return NULL; } return (struct Link *) l; } %pythoncode %{first_link = property(load_links, doc="First link on page")%} //---------------------------------------------------------------- // Page.first_annot //---------------------------------------------------------------- PARENTCHECK(first_annot, """First annotation.""") %pythonappend first_annot %{ if val: val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val %} %pythoncode %{@property%} struct Annot *first_annot() { pdf_annot *annot = NULL; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (page) { annot = pdf_first_annot(gctx, page); if (annot) pdf_keep_annot(gctx, annot); } return (struct Annot *) annot; } //---------------------------------------------------------------- // first_widget //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(first_widget, """First widget/field.""") %pythonappend first_widget %{ if val: val.thisown = True val.parent = weakref.proxy(self) # owning page object self._annot_refs[id(val)] = val widget = Widget() TOOLS._fill_widget(val, widget) val = widget %} struct Annot *first_widget() { pdf_annot *annot = NULL; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (page) { annot = pdf_first_widget(gctx, page); if (annot) pdf_keep_annot(gctx, annot); } return (struct Annot *) annot; } //---------------------------------------------------------------- // Page.delete_link() - delete link //---------------------------------------------------------------- PARENTCHECK(delete_link, """Delete a Link.""") %pythonappend delete_link %{ if linkdict["xref"] == 0: return try: linkid = linkdict["id"] linkobj = self._annot_refs[linkid] linkobj._erase() except: pass %} void delete_link(PyObject *linkdict) { if (!PyDict_Check(linkdict)) return; // have no dictionary fz_try(gctx) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) goto finished; // have no PDF int xref = (int) PyInt_AsLong(PyDict_GetItem(linkdict, dictkey_xref)); if (xref < 1) goto finished; // invalid xref pdf_obj *annots = pdf_dict_get(gctx, page->obj, PDF_NAME(Annots)); if (!annots) goto finished; // have no annotations int len = pdf_array_len(gctx, annots); if (len == 0) goto finished; int i, oxref = 0; for (i = 0; i < len; i++) { oxref = pdf_to_num(gctx, pdf_array_get(gctx, annots, i)); if (xref == oxref) break; // found xref in annotations } if (xref != oxref) goto finished; // xref not in annotations pdf_array_delete(gctx, annots, i); // delete entry in annotations pdf_delete_object(gctx, page->doc, xref); // delete link obj pdf_dict_put(gctx, page->obj, PDF_NAME(Annots), annots); JM_refresh_links(gctx, page); finished:; } fz_catch(gctx) {;} } //---------------------------------------------------------------- // Page.delete_annot() - delete annotation and return the next one //---------------------------------------------------------------- %pythonprepend delete_annot %{ """Delete annot and return next one.""" CheckParent(self) CheckParent(annot)%} %pythonappend delete_annot %{ if val: val.thisown = True val.parent = weakref.proxy(self) # owning page object val.parent._annot_refs[id(val)] = val %} struct Annot *delete_annot(struct Annot *annot) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_annot *irt_annot = NULL; while (1) { // first loop through all /IRT annots and remove them irt_annot = JM_find_annot_irt(gctx, (pdf_annot *) annot); if (!irt_annot) // no more there break; pdf_delete_annot(gctx, page, irt_annot); } pdf_annot *nextannot = pdf_next_annot(gctx, (pdf_annot *) annot); // store next pdf_delete_annot(gctx, page, (pdf_annot *) annot); if (nextannot) { nextannot = pdf_keep_annot(gctx, nextannot); } return (struct Annot *) nextannot; } //---------------------------------------------------------------- // mediabox: get the /MediaBox (PDF only) //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(mediabox, """The MediaBox.""") %pythonappend mediabox %{val = Rect(JM_TUPLE3(val))%} PyObject *mediabox() { fz_rect rect = fz_infinite_rect; fz_try(gctx) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) { rect = fz_bound_page(gctx, (fz_page *) $self); } else { rect = JM_mediabox(gctx, page->obj); } } fz_catch(gctx) {;} return JM_py_from_rect(rect); } //---------------------------------------------------------------- // cropbox: get the /CropBox (PDF only) //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(cropbox, """The CropBox.""") %pythonappend cropbox %{val = Rect(JM_TUPLE3(val))%} PyObject *cropbox() { fz_rect rect = fz_infinite_rect; fz_try(gctx) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) { rect = fz_bound_page(gctx, (fz_page *) $self); } else { rect = JM_cropbox(gctx, page->obj); } } fz_catch(gctx) {;} return JM_py_from_rect(rect); } PyObject *_other_box(const char *boxtype) { fz_rect rect = fz_infinite_rect; fz_try(gctx) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (page) { pdf_obj *obj = pdf_dict_gets(gctx, page->obj, boxtype); if (pdf_is_array(gctx, obj)) { rect = pdf_to_rect(gctx, obj); } } } fz_catch(gctx) {;} if (fz_is_infinite_rect(rect)) { Py_RETURN_NONE; } return JM_py_from_rect(rect); } //---------------------------------------------------------------- // CropBox position: x0, y0 of /CropBox //---------------------------------------------------------------- %pythoncode %{ @property def cropbox_position(self): return self.cropbox.tl @property def artbox(self): """The ArtBox""" rect = self._other_box("ArtBox") if rect == None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) @property def trimbox(self): """The TrimBox""" rect = self._other_box("TrimBox") if rect == None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) @property def bleedbox(self): """The BleedBox""" rect = self._other_box("BleedBox") if rect == None: return self.cropbox mb = self.mediabox return Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) def _set_pagebox(self, boxtype, rect): doc = self.parent if doc == None: raise ValueError("orphaned object: parent is None") if not doc.is_pdf: raise ValueError("is no PDF") valid_boxes = ("CropBox", "BleedBox", "TrimBox", "ArtBox") if boxtype not in valid_boxes: raise ValueError("bad boxtype") rect = Rect(rect) mb = self.mediabox rect = Rect(rect[0], mb.y1 - rect[3], rect[2], mb.y1 - rect[1]) if not (mb.x0 <= rect.x0 < rect.x1 <= mb.x1 and mb.y0 <= rect.y0 < rect.y1 <= mb.y1): raise ValueError(f"{boxtype} not in MediaBox") doc.xref_set_key(self.xref, boxtype, "[%g %g %g %g]" % tuple(rect)) def set_cropbox(self, rect): """Set the CropBox. Will also change Page.rect.""" return self._set_pagebox("CropBox", rect) def set_artbox(self, rect): """Set the ArtBox.""" return self._set_pagebox("ArtBox", rect) def set_bleedbox(self, rect): """Set the BleedBox.""" return self._set_pagebox("BleedBox", rect) def set_trimbox(self, rect): """Set the TrimBox.""" return self._set_pagebox("TrimBox", rect) %} //---------------------------------------------------------------- // rotation - return page rotation //---------------------------------------------------------------- PARENTCHECK(rotation, """Page rotation.""") %pythoncode %{@property%} int rotation() { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) return 0; return JM_page_rotation(gctx, page); } /*********************************************************************/ // set_rotation() - set page rotation /*********************************************************************/ FITZEXCEPTION(set_rotation, !result) PARENTCHECK(set_rotation, """Set page rotation.""") PyObject *set_rotation(int rotation) { fz_try(gctx) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); ASSERT_PDF(page); int rot = JM_norm_rotation(rotation); pdf_dict_put_int(gctx, page->obj, PDF_NAME(Rotate), (int64_t) rot); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } /*********************************************************************/ // Page._addAnnot_FromString // Add new links provided as an array of string object definitions. /*********************************************************************/ FITZEXCEPTION(_addAnnot_FromString, !result) PARENTCHECK(_addAnnot_FromString, """Add links from list of object sources.""") PyObject *_addAnnot_FromString(PyObject *linklist) { pdf_obj *annots, *annot, *ind_obj; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); PyObject *txtpy = NULL; char *text = NULL; Py_ssize_t lcount = PyTuple_Size(linklist); // link count if (lcount < 1) Py_RETURN_NONE; Py_ssize_t i = -1; fz_var(text); // insert links from the provided sources fz_try(gctx) { ASSERT_PDF(page); if (!PyTuple_Check(linklist)) { RAISEPY(gctx, "bad 'linklist' argument", PyExc_ValueError); } if (!pdf_dict_get(gctx, page->obj, PDF_NAME(Annots))) { pdf_dict_put_array(gctx, page->obj, PDF_NAME(Annots), lcount); } annots = pdf_dict_get(gctx, page->obj, PDF_NAME(Annots)); for (i = 0; i < lcount; i++) { fz_try(gctx) { for (; i < lcount; i++) { text = JM_StrAsChar(PyTuple_GET_ITEM(linklist, i)); if (!text) { PySys_WriteStderr("skipping bad link / annot item %zi.\n", i); continue; } annot = pdf_add_object_drop(gctx, page->doc, JM_pdf_obj_from_str(gctx, page->doc, text)); ind_obj = pdf_new_indirect(gctx, page->doc, pdf_to_num(gctx, annot), 0); pdf_array_push_drop(gctx, annots, ind_obj); pdf_drop_obj(gctx, annot); } } fz_catch(gctx) { PySys_WriteStderr("skipping bad link / annot item %zi.\n", i); } } } fz_catch(gctx) { PyErr_Clear(); return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // Page clean contents stream //---------------------------------------------------------------- FITZEXCEPTION(clean_contents, !result) %pythonprepend clean_contents %{"""Clean page /Contents into one object.""" CheckParent(self) if not sanitize and not self.is_wrapped: self.wrap_contents()%} PyObject *clean_contents(int sanitize=1) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) { Py_RETURN_NONE; } #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 pdf_filter_factory list[2] = { 0 }; pdf_sanitize_filter_options sopts = { 0 }; pdf_filter_options filter = { 1, // recurse: true 0, // instance forms 0, // do not ascii-escape binary data 0, // no_update NULL, // end_page_opaque NULL, // end page list, // filters }; if (sanitize) { list[0].filter = pdf_new_sanitize_filter; list[0].options = &sopts; } #else pdf_filter_options filter = { NULL, // opaque NULL, // image filter NULL, // text filter NULL, // after text NULL, // end page 1, // recurse: true 1, // instance forms 1, // sanitize plus filtering 0 // do not ascii-escape binary data }; filter.sanitize = sanitize; #endif fz_try(gctx) { pdf_filter_page_contents(gctx, page->doc, page, &filter); } fz_catch(gctx) { Py_RETURN_NONE; } Py_RETURN_NONE; } //---------------------------------------------------------------- // Show a PDF page //---------------------------------------------------------------- FITZEXCEPTION(_show_pdf_page, !result) PyObject *_show_pdf_page(struct Page *fz_srcpage, int overlay=1, PyObject *matrix=NULL, int xref=0, int oc=0, PyObject *clip = NULL, struct Graftmap *graftmap = NULL, char *_imgname = NULL) { pdf_obj *xobj1=NULL, *xobj2=NULL, *resources; fz_buffer *res=NULL, *nres=NULL; fz_rect cropbox = JM_rect_from_py(clip); fz_matrix mat = JM_matrix_from_py(matrix); int rc_xref = xref; fz_var(xobj1); fz_var(xobj2); fz_try(gctx) { pdf_page *tpage = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_obj *tpageref = tpage->obj; pdf_document *pdfout = tpage->doc; // target PDF ENSURE_OPERATION(gctx, pdfout); //------------------------------------------------------------- // convert the source page to a Form XObject //------------------------------------------------------------- xobj1 = JM_xobject_from_page(gctx, pdfout, (fz_page *) fz_srcpage, xref, (pdf_graft_map *) graftmap); if (!rc_xref) rc_xref = pdf_to_num(gctx, xobj1); //------------------------------------------------------------- // create referencing XObject (controls display on target page) //------------------------------------------------------------- // fill reference to xobj1 into the /Resources //------------------------------------------------------------- pdf_obj *subres1 = pdf_new_dict(gctx, pdfout, 5); pdf_dict_puts(gctx, subres1, "fullpage", xobj1); pdf_obj *subres = pdf_new_dict(gctx, pdfout, 5); pdf_dict_put_drop(gctx, subres, PDF_NAME(XObject), subres1); res = fz_new_buffer(gctx, 20); fz_append_string(gctx, res, "/fullpage Do"); xobj2 = pdf_new_xobject(gctx, pdfout, cropbox, mat, subres, res); if (oc > 0) { JM_add_oc_object(gctx, pdfout, pdf_resolve_indirect(gctx, xobj2), oc); } pdf_drop_obj(gctx, subres); fz_drop_buffer(gctx, res); //------------------------------------------------------------- // update target page with xobj2: //------------------------------------------------------------- // 1. insert Xobject in Resources //------------------------------------------------------------- resources = pdf_dict_get_inheritable(gctx, tpageref, PDF_NAME(Resources)); subres = pdf_dict_get(gctx, resources, PDF_NAME(XObject)); if (!subres) { subres = pdf_dict_put_dict(gctx, resources, PDF_NAME(XObject), 5); } pdf_dict_puts(gctx, subres, _imgname, xobj2); //------------------------------------------------------------- // 2. make and insert new Contents object //------------------------------------------------------------- nres = fz_new_buffer(gctx, 50); // buffer for Do-command fz_append_string(gctx, nres, " q /"); // Do-command fz_append_string(gctx, nres, _imgname); fz_append_string(gctx, nres, " Do Q "); JM_insert_contents(gctx, pdfout, tpageref, nres, overlay); fz_drop_buffer(gctx, nres); } fz_always(gctx) { pdf_drop_obj(gctx, xobj1); pdf_drop_obj(gctx, xobj2); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", rc_xref); } //---------------------------------------------------------------- // insert an image //---------------------------------------------------------------- FITZEXCEPTION(_insert_image, !result) PyObject * _insert_image(char *filename=NULL, struct Pixmap *pixmap=NULL, PyObject *stream=NULL, PyObject *imask=NULL, PyObject *clip=NULL, int overlay=1, int rotate=0, int keep_proportion=1, int oc=0, int width=0, int height=0, int xref=0, int alpha=-1, const char *_imgname=NULL, PyObject *digests=NULL) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_document *pdf = page->doc; float w = width, h = height; fz_pixmap *pm = NULL; fz_pixmap *pix = NULL; fz_image *mask = NULL, *zimg = NULL, *image = NULL, *freethis = NULL; pdf_obj *resources, *xobject, *ref; fz_buffer *nres = NULL, *imgbuf = NULL, *maskbuf = NULL; fz_compressed_buffer *cbuf1 = NULL; int xres, yres, bpc, img_xref = xref, rc_digest = 0; unsigned char digest[16]; PyObject *md5_py = NULL, *temp; const char *template = "\nq\n%g %g %g %g %g %g cm\n/%s Do\nQ\n"; fz_try(gctx) { if (xref > 0) { ref = pdf_new_indirect(gctx, pdf, xref, 0); w = pdf_to_int(gctx, pdf_dict_geta(gctx, ref, PDF_NAME(Width), PDF_NAME(W))); h = pdf_to_int(gctx, pdf_dict_geta(gctx, ref, PDF_NAME(Height), PDF_NAME(H))); if ((w + h) == 0) { RAISEPY(gctx, MSG_IS_NO_IMAGE, PyExc_ValueError); } goto have_xref; } if (EXISTS(stream)) { imgbuf = JM_BufferFromBytes(gctx, stream); goto have_stream; } if (filename) { imgbuf = fz_read_file(gctx, filename); goto have_stream; } // process pixmap --------------------------------- fz_pixmap *arg_pix = (fz_pixmap *) pixmap; w = arg_pix->w; h = arg_pix->h; fz_md5_pixmap(gctx, arg_pix, digest); md5_py = PyBytes_FromStringAndSize(digest, 16); temp = PyDict_GetItem(digests, md5_py); if (temp) { img_xref = (int) PyLong_AsLong(temp); ref = pdf_new_indirect(gctx, page->doc, img_xref, 0); goto have_xref; } if (arg_pix->alpha == 0) { image = fz_new_image_from_pixmap(gctx, arg_pix, NULL); } else { pm = fz_convert_pixmap(gctx, arg_pix, NULL, NULL, NULL, fz_default_color_params, 1); pm->alpha = 0; pm->colorspace = NULL; mask = fz_new_image_from_pixmap(gctx, pm, NULL); image = fz_new_image_from_pixmap(gctx, arg_pix, mask); } goto have_image; // process stream --------------------------------- have_stream:; fz_md5 state; fz_md5_init(&state); fz_md5_update(&state, imgbuf->data, imgbuf->len); if (imask != Py_None) { maskbuf = JM_BufferFromBytes(gctx, imask); fz_md5_update(&state, maskbuf->data, maskbuf->len); } fz_md5_final(&state, digest); md5_py = PyBytes_FromStringAndSize(digest, 16); temp = PyDict_GetItem(digests, md5_py); if (temp) { img_xref = (int) PyLong_AsLong(temp); ref = pdf_new_indirect(gctx, page->doc, img_xref, 0); w = pdf_to_int(gctx, pdf_dict_geta(gctx, ref, PDF_NAME(Width), PDF_NAME(W))); h = pdf_to_int(gctx, pdf_dict_geta(gctx, ref, PDF_NAME(Height), PDF_NAME(H))); goto have_xref; } image = fz_new_image_from_buffer(gctx, imgbuf); w = image->w; h = image->h; if (imask == Py_None) { goto have_image; } cbuf1 = fz_compressed_image_buffer(gctx, image); if (!cbuf1) { RAISEPY(gctx, "uncompressed image cannot have mask", PyExc_ValueError); } bpc = image->bpc; fz_colorspace *colorspace = image->colorspace; fz_image_resolution(image, &xres, &yres); mask = fz_new_image_from_buffer(gctx, maskbuf); zimg = fz_new_image_from_compressed_buffer(gctx, w, h, bpc, colorspace, xres, yres, 1, 0, NULL, NULL, cbuf1, mask); freethis = image; image = zimg; zimg = NULL; goto have_image; have_image:; ref = pdf_add_image(gctx, pdf, image); if (oc) { JM_add_oc_object(gctx, pdf, ref, oc); } img_xref = pdf_to_num(gctx, ref); DICT_SETITEM_DROP(digests, md5_py, Py_BuildValue("i", img_xref)); rc_digest = 1; have_xref:; resources = pdf_dict_get_inheritable(gctx, page->obj, PDF_NAME(Resources)); if (!resources) { resources = pdf_dict_put_dict(gctx, page->obj, PDF_NAME(Resources), 2); } xobject = pdf_dict_get(gctx, resources, PDF_NAME(XObject)); if (!xobject) { xobject = pdf_dict_put_dict(gctx, resources, PDF_NAME(XObject), 2); } fz_matrix mat = calc_image_matrix(w, h, clip, rotate, keep_proportion); pdf_dict_puts_drop(gctx, xobject, _imgname, ref); nres = fz_new_buffer(gctx, 50); fz_append_printf(gctx, nres, template, mat.a, mat.b, mat.c, mat.d, mat.e, mat.f, _imgname); JM_insert_contents(gctx, pdf, page->obj, nres, overlay); } fz_always(gctx) { if (freethis) { fz_drop_image(gctx, freethis); } else { fz_drop_image(gctx, image); } fz_drop_image(gctx, mask); fz_drop_image(gctx, zimg); fz_drop_pixmap(gctx, pix); fz_drop_pixmap(gctx, pm); fz_drop_buffer(gctx, imgbuf); fz_drop_buffer(gctx, maskbuf); fz_drop_buffer(gctx, nres); } fz_catch(gctx) { return NULL; } if (rc_digest) { return Py_BuildValue("iO", img_xref, digests); } else { return Py_BuildValue("iO", img_xref, Py_None); } } //---------------------------------------------------------------- // Page.refresh() //---------------------------------------------------------------- %pythoncode %{ def refresh(self): doc = self.parent page = doc.reload_page(self) self = page %} //---------------------------------------------------------------- // insert font //---------------------------------------------------------------- %pythoncode %{ def insert_font(self, fontname="helv", fontfile=None, fontbuffer=None, set_simple=False, wmode=0, encoding=0): doc = self.parent if doc is None: raise ValueError("orphaned object: parent is None") idx = 0 if fontname.startswith("/"): fontname = fontname[1:] inv_chars = INVALID_NAME_CHARS.intersection(fontname) if inv_chars != set(): raise ValueError(f"bad fontname chars {inv_chars}") font = CheckFont(self, fontname) if font is not None: # font already in font list of page xref = font[0] # this is the xref if CheckFontInfo(doc, xref): # also in our document font list? return xref # yes: we are done # need to build the doc FontInfo entry - done via get_char_widths doc.get_char_widths(xref) return xref #-------------------------------------------------------------------------- # the font is not present for this page #-------------------------------------------------------------------------- bfname = Base14_fontdict.get(fontname.lower(), None) # BaseFont if Base-14 font serif = 0 CJK_number = -1 CJK_list_n = ["china-t", "china-s", "japan", "korea"] CJK_list_s = ["china-ts", "china-ss", "japan-s", "korea-s"] try: CJK_number = CJK_list_n.index(fontname) serif = 0 except: pass if CJK_number < 0: try: CJK_number = CJK_list_s.index(fontname) serif = 1 except: pass if fontname.lower() in fitz_fontdescriptors.keys(): import pymupdf_fonts fontbuffer = pymupdf_fonts.myfont(fontname) # make a copy del pymupdf_fonts # install the font for the page if fontfile != None: if type(fontfile) is str: fontfile_str = fontfile elif hasattr(fontfile, "absolute"): fontfile_str = str(fontfile) elif hasattr(fontfile, "name"): fontfile_str = fontfile.name else: raise ValueError("bad fontfile") else: fontfile_str = None val = self._insertFont(fontname, bfname, fontfile_str, fontbuffer, set_simple, idx, wmode, serif, encoding, CJK_number) if not val: # did not work, error return return val xref = val[0] # xref of installed font fontdict = val[1] if CheckFontInfo(doc, xref): # check again: document already has this font return xref # we are done # need to create document font info doc.get_char_widths(xref, fontdict=fontdict) return xref %} FITZEXCEPTION(_insertFont, !result) PyObject *_insertFont(char *fontname, char *bfname, char *fontfile, PyObject *fontbuffer, int set_simple, int idx, int wmode, int serif, int encoding, int ordering) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); pdf_document *pdf; pdf_obj *resources, *fonts, *font_obj; PyObject *value; fz_try(gctx) { ASSERT_PDF(page); pdf = page->doc; value = JM_insert_font(gctx, pdf, bfname, fontfile,fontbuffer, set_simple, idx, wmode, serif, encoding, ordering); // get the objects /Resources, /Resources/Font resources = pdf_dict_get_inheritable(gctx, page->obj, PDF_NAME(Resources)); fonts = pdf_dict_get(gctx, resources, PDF_NAME(Font)); if (!fonts) { // page has no fonts yet fonts = pdf_new_dict(gctx, pdf, 5); pdf_dict_putl_drop(gctx, page->obj, fonts, PDF_NAME(Resources), PDF_NAME(Font), NULL); } // store font in resources and fonts objects will contain named reference to font int xref = 0; JM_INT_ITEM(value, 0, &xref); if (!xref) { RAISEPY(gctx, "cannot insert font", PyExc_RuntimeError); } font_obj = pdf_new_indirect(gctx, pdf, xref, 0); pdf_dict_puts_drop(gctx, fonts, fontname, font_obj); } fz_always(gctx) { ; } fz_catch(gctx) { return NULL; } return value; } //---------------------------------------------------------------- // Get page transformation matrix //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(transformation_matrix, """Page transformation matrix.""") %pythonappend transformation_matrix %{ if self.rotation % 360 == 0: val = Matrix(val) else: val = Matrix(1, 0, 0, -1, 0, self.cropbox.height) %} PyObject *transformation_matrix() { fz_matrix ctm = fz_identity; pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); if (!page) return JM_py_from_matrix(ctm); fz_try(gctx) { pdf_page_transform(gctx, page, NULL, &ctm); } fz_catch(gctx) {;} return JM_py_from_matrix(ctm); } //---------------------------------------------------------------- // Page Get list of contents objects //---------------------------------------------------------------- FITZEXCEPTION(get_contents, !result) PARENTCHECK(get_contents, """Get xrefs of /Contents objects.""") PyObject *get_contents() { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) $self); PyObject *list = NULL; pdf_obj *contents = NULL, *icont = NULL; int i, xref; size_t n = 0; fz_try(gctx) { ASSERT_PDF(page); contents = pdf_dict_get(gctx, page->obj, PDF_NAME(Contents)); if (pdf_is_array(gctx, contents)) { n = pdf_array_len(gctx, contents); list = PyList_New(n); for (i = 0; i < n; i++) { icont = pdf_array_get(gctx, contents, i); xref = pdf_to_num(gctx, icont); PyList_SET_ITEM(list, i, Py_BuildValue("i", xref)); } } else if (contents) { list = PyList_New(1); xref = pdf_to_num(gctx, contents); PyList_SET_ITEM(list, 0, Py_BuildValue("i", xref)); } } fz_catch(gctx) { return NULL; } if (list) { return list; } return PyList_New(0); } //---------------------------------------------------------------- // //---------------------------------------------------------------- %pythoncode %{ def set_contents(self, xref: int)->None: """Set object at 'xref' as the page's /Contents.""" CheckParent(self) doc = self.parent if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") if not xref in range(1, doc.xref_length()): raise ValueError("bad xref") if not doc.xref_is_stream(xref): raise ValueError("xref is no stream") doc.xref_set_key(self.xref, "Contents", "%i 0 R" % xref) @property def is_wrapped(self): """Check if /Contents is wrapped with string pair "q" / "Q".""" if getattr(self, "was_wrapped", False): # costly checks only once return True cont = self.read_contents().split() if cont == []: # no contents treated as okay self.was_wrapped = True return True if cont[0] != b"q" or cont[-1] != b"Q": return False # potential "geometry" issue self.was_wrapped = True # cheap check next time return True def wrap_contents(self): if self.is_wrapped: # avoid unnecessary wrapping return TOOLS._insert_contents(self, b"q\n", False) TOOLS._insert_contents(self, b"\nQ", True) self.was_wrapped = True # indicate not needed again def links(self, kinds=None): """ Generator over the links of a page. Args: kinds: (list) link kinds to subselect from. If none, all links are returned. E.g. kinds=[LINK_URI] will only yield URI links. """ all_links = self.get_links() for link in all_links: if kinds is None or link["kind"] in kinds: yield (link) def annots(self, types=None): """ Generator over the annotations of a page. Args: types: (list) annotation types to subselect from. If none, all annotations are returned. E.g. types=[PDF_ANNOT_LINE] will only yield line annotations. """ skip_types = (PDF_ANNOT_LINK, PDF_ANNOT_POPUP, PDF_ANNOT_WIDGET) if not hasattr(types, "__getitem__"): annot_xrefs = [a[0] for a in self.annot_xrefs() if a[1] not in skip_types] else: annot_xrefs = [a[0] for a in self.annot_xrefs() if a[1] in types and a[1] not in skip_types] for xref in annot_xrefs: annot = self.load_annot(xref) annot._yielded=True yield annot def widgets(self, types=None): """ Generator over the widgets of a page. Args: types: (list) field types to subselect from. If none, all fields are returned. E.g. types=[PDF_WIDGET_TYPE_TEXT] will only yield text fields. """ widget_xrefs = [a[0] for a in self.annot_xrefs() if a[1] == PDF_ANNOT_WIDGET] for xref in widget_xrefs: widget = self.load_widget(xref) if types == None or widget.field_type in types: yield (widget) def __str__(self): CheckParent(self) x = self.parent.name if self.parent.stream is not None: x = "" % (self.parent._graft_id,) if x == "": x = "" % self.parent._graft_id return "page %s of %s" % (self.number, x) def __repr__(self): CheckParent(self) x = self.parent.name if self.parent.stream is not None: x = "" % (self.parent._graft_id,) if x == "": x = "" % self.parent._graft_id return "page %s of %s" % (self.number, x) def _reset_annot_refs(self): """Invalidate / delete all annots of this page.""" for annot in self._annot_refs.values(): if annot: annot._erase() self._annot_refs.clear() @property def xref(self): """PDF xref number of page.""" CheckParent(self) return self.parent.page_xref(self.number) def _erase(self): self._reset_annot_refs() self._image_infos = None try: self.parent._forget_page(self) except: pass if getattr(self, "thisown", False): self.__swig_destroy__(self) self.parent = None self.number = None def __del__(self): self._erase() def get_fonts(self, full=False): """List of fonts defined in the page object.""" CheckParent(self) return self.parent.get_page_fonts(self.number, full=full) def get_images(self, full=False): """List of images defined in the page object.""" CheckParent(self) ret = self.parent.get_page_images(self.number, full=full) return ret def get_xobjects(self): """List of xobjects defined in the page object.""" CheckParent(self) return self.parent.get_page_xobjects(self.number) def read_contents(self): """All /Contents streams concatenated to one bytes object.""" return TOOLS._get_all_contents(self) @property def mediabox_size(self): return Point(self.mediabox.x1, self.mediabox.y1) %} } }; %clearnodefaultctor; //------------------------------------------------------------------------ // Pixmap //------------------------------------------------------------------------ struct Pixmap { %extend { ~Pixmap() { DEBUGMSG1("Pixmap"); fz_pixmap *this_pix = (fz_pixmap *) $self; fz_drop_pixmap(gctx, this_pix); DEBUGMSG2; } FITZEXCEPTION(Pixmap, !result) %pythonprepend Pixmap %{"""Pixmap(colorspace, irect, alpha) - empty pixmap. Pixmap(colorspace, src) - copy changing colorspace. Pixmap(src, width, height,[clip]) - scaled copy, float dimensions. Pixmap(src, alpha=True) - copy adding / dropping alpha. Pixmap(source, mask) - from a non-alpha and a mask pixmap. Pixmap(file) - from an image file. Pixmap(memory) - from an image in memory (bytes). Pixmap(colorspace, width, height, samples, alpha) - from samples data. Pixmap(PDFdoc, xref) - from an image xref in a PDF document. """%} //---------------------------------------------------------------- // create empty pixmap with colorspace and IRect //---------------------------------------------------------------- Pixmap(struct Colorspace *cs, PyObject *bbox, int alpha = 0) { fz_pixmap *pm = NULL; fz_try(gctx) { pm = fz_new_pixmap_with_bbox(gctx, (fz_colorspace *) cs, JM_irect_from_py(bbox), NULL, alpha); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // copy pixmap, converting colorspace //---------------------------------------------------------------- Pixmap(struct Colorspace *cs, struct Pixmap *spix) { fz_pixmap *pm = NULL; fz_try(gctx) { if (!fz_pixmap_colorspace(gctx, (fz_pixmap *) spix)) { RAISEPY(gctx, "source colorspace must not be None", PyExc_ValueError); } fz_colorspace *cspace = NULL; if (cs) { cspace = (fz_colorspace *) cs; } if (cspace) { pm = fz_convert_pixmap(gctx, (fz_pixmap *) spix, cspace, NULL, NULL, fz_default_color_params, 1); } else { pm = fz_new_pixmap_from_alpha_channel(gctx, (fz_pixmap *) spix); if (!pm) { RAISEPY(gctx, MSG_PIX_NOALPHA, PyExc_RuntimeError); } } } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // add mask to a pixmap w/o alpha channel //---------------------------------------------------------------- Pixmap(struct Pixmap *spix, struct Pixmap *mpix) { fz_pixmap *dst = NULL; fz_pixmap *spm = (fz_pixmap *) spix; fz_pixmap *mpm = (fz_pixmap *) mpix; fz_try(gctx) { if (!spix) { // intercept NULL for spix: make alpha only pix dst = fz_new_pixmap_from_alpha_channel(gctx, mpm); if (!dst) { RAISEPY(gctx, MSG_PIX_NOALPHA, PyExc_RuntimeError); } } else { dst = fz_new_pixmap_from_color_and_mask(gctx, spm, mpm); } } fz_catch(gctx) { return NULL; } return (struct Pixmap *) dst; } //---------------------------------------------------------------- // create pixmap as scaled copy of another one //---------------------------------------------------------------- Pixmap(struct Pixmap *spix, float w, float h, PyObject *clip=NULL) { fz_pixmap *pm = NULL; fz_pixmap *src_pix = (fz_pixmap *) spix; fz_try(gctx) { fz_irect bbox = JM_irect_from_py(clip); if (clip != Py_None && (fz_is_infinite_irect(bbox) || fz_is_empty_irect(bbox))) { RAISEPY(gctx, "bad clip parameter", PyExc_ValueError); } if (!fz_is_infinite_irect(bbox)) { pm = fz_scale_pixmap(gctx, src_pix, src_pix->x, src_pix->y, w, h, &bbox); } else { pm = fz_scale_pixmap(gctx, src_pix, src_pix->x, src_pix->y, w, h, NULL); } } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // copy pixmap & add / drop the alpha channel //---------------------------------------------------------------- Pixmap(struct Pixmap *spix, int alpha=1) { fz_pixmap *pm = NULL, *src_pix = (fz_pixmap *) spix; int n, w, h, i; fz_separations *seps = NULL; fz_try(gctx) { if (!INRANGE(alpha, 0, 1)) { RAISEPY(gctx, "bad alpha value", PyExc_ValueError); } fz_colorspace *cs = fz_pixmap_colorspace(gctx, src_pix); if (!cs && !alpha) { RAISEPY(gctx, "cannot drop alpha for 'NULL' colorspace", PyExc_ValueError); } n = fz_pixmap_colorants(gctx, src_pix); w = fz_pixmap_width(gctx, src_pix); h = fz_pixmap_height(gctx, src_pix); pm = fz_new_pixmap(gctx, cs, w, h, seps, alpha); pm->x = src_pix->x; pm->y = src_pix->y; pm->xres = src_pix->xres; pm->yres = src_pix->yres; // copy samples data ------------------------------------------ unsigned char *sptr = src_pix->samples; unsigned char *tptr = pm->samples; if (src_pix->alpha == pm->alpha) { // identical samples memcpy(tptr, sptr, w * h * (n + alpha)); } else { for (i = 0; i < w * h; i++) { memcpy(tptr, sptr, n); tptr += n; if (pm->alpha) { tptr[0] = 255; tptr++; } sptr += n + src_pix->alpha; } } } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // create pixmap from samples data //---------------------------------------------------------------- Pixmap(struct Colorspace *cs, int w, int h, PyObject *samples, int alpha=0) { int n = fz_colorspace_n(gctx, (fz_colorspace *) cs); int stride = (n + alpha) * w; fz_separations *seps = NULL; fz_buffer *res = NULL; fz_pixmap *pm = NULL; fz_try(gctx) { size_t size = 0; unsigned char *c = NULL; res = JM_BufferFromBytes(gctx, samples); if (!res) { RAISEPY(gctx, "bad samples data", PyExc_ValueError); } size = fz_buffer_storage(gctx, res, &c); if (stride * h != size) { RAISEPY(gctx, "bad samples length", PyExc_ValueError); } pm = fz_new_pixmap(gctx, (fz_colorspace *) cs, w, h, seps, alpha); memcpy(pm->samples, c, size); } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // create pixmap from filename, file object, pathlib.Path or memory //---------------------------------------------------------------- Pixmap(PyObject *imagedata) { fz_buffer *res = NULL; fz_image *img = NULL; fz_pixmap *pm = NULL; PyObject *fname = NULL; PyObject *name = PyUnicode_FromString("name"); fz_try(gctx) { if (PyObject_HasAttrString(imagedata, "resolve")) { fname = PyObject_CallMethod(imagedata, "__str__", NULL); if (fname) { img = fz_new_image_from_file(gctx, JM_StrAsChar(fname)); } } else if (PyObject_HasAttr(imagedata, name)) { fname = PyObject_GetAttr(imagedata, name); if (fname) { img = fz_new_image_from_file(gctx, JM_StrAsChar(fname)); } } else if (PyUnicode_Check(imagedata)) { img = fz_new_image_from_file(gctx, JM_StrAsChar(imagedata)); } else { res = JM_BufferFromBytes(gctx, imagedata); if (!res || !fz_buffer_storage(gctx, res, NULL)) { RAISEPY(gctx, "bad image data", PyExc_ValueError); } img = fz_new_image_from_buffer(gctx, res); } pm = fz_get_pixmap_from_image(gctx, img, NULL, NULL, NULL, NULL); int xres, yres; fz_image_resolution(img, &xres, &yres); pm->xres = xres; pm->yres = yres; } fz_always(gctx) { Py_CLEAR(fname); Py_CLEAR(name); fz_drop_image(gctx, img); fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pm; } //---------------------------------------------------------------- // Create pixmap from PDF image identified by XREF number //---------------------------------------------------------------- Pixmap(struct Document *doc, int xref) { fz_image *img = NULL; fz_pixmap *pix = NULL; pdf_obj *ref = NULL; pdf_obj *type; pdf_document *pdf = pdf_specifics(gctx, (fz_document *) doc); fz_try(gctx) { ASSERT_PDF(pdf); int xreflen = pdf_xref_len(gctx, pdf); if (!INRANGE(xref, 1, xreflen-1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } ref = pdf_new_indirect(gctx, pdf, xref, 0); type = pdf_dict_get(gctx, ref, PDF_NAME(Subtype)); if (!pdf_name_eq(gctx, type, PDF_NAME(Image)) && !pdf_name_eq(gctx, type, PDF_NAME(Alpha)) && !pdf_name_eq(gctx, type, PDF_NAME(Luminosity))) { RAISEPY(gctx, MSG_IS_NO_IMAGE, PyExc_ValueError); } img = pdf_load_image(gctx, pdf, ref); pix = fz_get_pixmap_from_image(gctx, img, NULL, NULL, NULL, NULL); } fz_always(gctx) { fz_drop_image(gctx, img); pdf_drop_obj(gctx, ref); } fz_catch(gctx) { fz_drop_pixmap(gctx, pix); return NULL; } return (struct Pixmap *) pix; } //---------------------------------------------------------------- // warp //---------------------------------------------------------------- FITZEXCEPTION(warp, !result) %pythonprepend warp %{ """Return pixmap from a warped quad.""" EnsureOwnership(self) if not quad.is_convex: raise ValueError("quad must be convex")%} struct Pixmap *warp(PyObject *quad, int width, int height) { fz_point points[4]; fz_quad q = JM_quad_from_py(quad); fz_pixmap *dst = NULL; points[0] = q.ul; points[1] = q.ur; points[2] = q.lr; points[3] = q.ll; fz_try(gctx) { dst = fz_warp_pixmap(gctx, (fz_pixmap *) $self, points, width, height); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) dst; } //---------------------------------------------------------------- // shrink //---------------------------------------------------------------- ENSURE_OWNERSHIP(shrink, """Divide width and height by 2**factor. E.g. factor=1 shrinks to 25% of original size (in place).""") void shrink(int factor) { if (factor < 1) { JM_Warning("ignoring shrink factor < 1"); return; } fz_subsample_pixmap(gctx, (fz_pixmap *) $self, factor); } //---------------------------------------------------------------- // apply gamma correction //---------------------------------------------------------------- ENSURE_OWNERSHIP(gamma_with, """Apply correction with some float. gamma=1 is a no-op.""") void gamma_with(float gamma) { if (!fz_pixmap_colorspace(gctx, (fz_pixmap *) $self)) { JM_Warning("colorspace invalid for function"); return; } fz_gamma_pixmap(gctx, (fz_pixmap *) $self, gamma); } //---------------------------------------------------------------- // tint pixmap with color //---------------------------------------------------------------- %pythonprepend tint_with %{"""Tint colors with modifiers for black and white.""" EnsureOwnership(self) if not self.colorspace or self.colorspace.n > 3: print("warning: colorspace invalid for function") return%} void tint_with(int black, int white) { fz_tint_pixmap(gctx, (fz_pixmap *) $self, black, white); } //----------------------------------------------------------------- // clear all of pixmap samples to 0x00 */ //----------------------------------------------------------------- ENSURE_OWNERSHIP(clear_with, """Fill all color components with same value.""") void clear_with() { fz_clear_pixmap(gctx, (fz_pixmap *) $self); } //----------------------------------------------------------------- // clear total pixmap with value */ //----------------------------------------------------------------- void clear_with(int value) { fz_clear_pixmap_with_value(gctx, (fz_pixmap *) $self, value); } //----------------------------------------------------------------- // clear pixmap rectangle with value //----------------------------------------------------------------- void clear_with(int value, PyObject *bbox) { JM_clear_pixmap_rect_with_value(gctx, (fz_pixmap *) $self, value, JM_irect_from_py(bbox)); } //----------------------------------------------------------------- // copy pixmaps //----------------------------------------------------------------- FITZEXCEPTION(copy, !result) ENSURE_OWNERSHIP(copy, """Copy bbox from another Pixmap.""") PyObject *copy(struct Pixmap *src, PyObject *bbox) { fz_try(gctx) { fz_pixmap *pm = (fz_pixmap *) $self, *src_pix = (fz_pixmap *) src; if (!fz_pixmap_colorspace(gctx, src_pix)) { RAISEPY(gctx, "cannot copy pixmap with NULL colorspace", PyExc_ValueError); } if (pm->alpha != src_pix->alpha) { RAISEPY(gctx, "source and target alpha must be equal", PyExc_ValueError); } fz_copy_pixmap_rect(gctx, pm, src_pix, JM_irect_from_py(bbox), NULL); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //----------------------------------------------------------------- // set alpha values //----------------------------------------------------------------- FITZEXCEPTION(set_alpha, !result) ENSURE_OWNERSHIP(set_alpha, """Set alpha channel to values contained in a byte array. If None, all alphas are 255. Args: alphavalues: (bytes) with length (width * height) or 'None'. premultiply: (bool, True) premultiply colors with alpha values. opaque: (tuple, length colorspace.n) this color receives opacity 0. matte: (tuple, length colorspace.n) preblending background color. """) PyObject *set_alpha(PyObject *alphavalues=NULL, int premultiply=1, PyObject *opaque=NULL, PyObject *matte=NULL) { fz_buffer *res = NULL; fz_pixmap *pix = (fz_pixmap *) $self; unsigned char alpha = 0, m = 0; fz_try(gctx) { if (pix->alpha == 0) { RAISEPY(gctx, MSG_PIX_NOALPHA, PyExc_ValueError); } size_t i, k, j; size_t n = fz_pixmap_colorants(gctx, pix); size_t w = (size_t) fz_pixmap_width(gctx, pix); size_t h = (size_t) fz_pixmap_height(gctx, pix); size_t balen = w * h * (n+1); int colors[4]; // make this color opaque int bgcolor[4]; // preblending background color int zero_out = 0, bground = 0; if (opaque && PySequence_Check(opaque) && PySequence_Size(opaque) == n) { for (i = 0; i < n; i++) { if (JM_INT_ITEM(opaque, i, &colors[i]) == 1) { RAISEPY(gctx, "bad opaque components", PyExc_ValueError); } } zero_out = 1; } if (matte && PySequence_Check(matte) && PySequence_Size(matte) == n) { for (i = 0; i < n; i++) { if (JM_INT_ITEM(matte, i, &bgcolor[i]) == 1) { RAISEPY(gctx, "bad matte components", PyExc_ValueError); } } bground = 1; } unsigned char *data = NULL; size_t data_len = 0; if (alphavalues && PyObject_IsTrue(alphavalues)) { res = JM_BufferFromBytes(gctx, alphavalues); data_len = fz_buffer_storage(gctx, res, &data); if (data_len < w * h) { RAISEPY(gctx, "bad alpha values", PyExc_ValueError); } } i = k = j = 0; int data_fix = 255; while (i < balen) { alpha = data[k]; if (zero_out) { for (j = i; j < i+n; j++) { if (pix->samples[j] != (unsigned char) colors[j - i]) { data_fix = 255; break; } else { data_fix = 0; } } } if (data_len) { if (data_fix == 0) { pix->samples[i+n] = 0; } else { pix->samples[i+n] = alpha; } if (premultiply && !bground) { for (j = i; j < i+n; j++) { pix->samples[j] = fz_mul255(pix->samples[j], alpha); } } else if (bground) { for (j = i; j < i+n; j++) { m = (unsigned char) bgcolor[j - i]; pix->samples[j] = m + fz_mul255((pix->samples[j] - m), alpha); } } } else { pix->samples[i+n] = data_fix; } i += n+1; k += 1; } } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //----------------------------------------------------------------- // Pixmap._tobytes //----------------------------------------------------------------- FITZEXCEPTION(_tobytes, !result) PyObject *_tobytes(int format, int jpg_quality) { fz_output *out = NULL; fz_buffer *res = NULL; PyObject *barray = NULL; fz_pixmap *pm = (fz_pixmap *) $self; fz_try(gctx) { size_t size = fz_pixmap_stride(gctx, pm) * pm->h; res = fz_new_buffer(gctx, size); out = fz_new_output_with_buffer(gctx, res); switch(format) { case(1): fz_write_pixmap_as_png(gctx, out, pm); break; case(2): fz_write_pixmap_as_pnm(gctx, out, pm); break; case(3): fz_write_pixmap_as_pam(gctx, out, pm); break; case(5): // Adobe Photoshop Document fz_write_pixmap_as_psd(gctx, out, pm); break; case(6): // Postscript format fz_write_pixmap_as_ps(gctx, out, pm); break; #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 case(7): // JPEG format #if FZ_VERSION_MINOR < 24 fz_write_pixmap_as_jpeg(gctx, out, pm, jpg_quality); #else fz_write_pixmap_as_jpeg(gctx, out, pm, jpg_quality, 0 /*invert_cmyk*/); #endif break; #endif default: fz_write_pixmap_as_png(gctx, out, pm); break; } barray = JM_BinFromBuffer(gctx, res); } fz_always(gctx) { fz_drop_output(gctx, out); fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return barray; } %pythoncode %{ def tobytes(self, output="png", jpg_quality=95): """Convert to binary image stream of desired type. Can be used as input to GUI packages like tkinter. Args: output: (str) image type, default is PNG. Others are JPG, JPEG, PNM, PGM, PPM, PBM, PAM, PSD, PS. Returns: Bytes object. """ EnsureOwnership(self) valid_formats = {"png": 1, "pnm": 2, "pgm": 2, "ppm": 2, "pbm": 2, "pam": 3, "psd": 5, "ps": 6, "jpg": 7, "jpeg": 7} idx = valid_formats.get(output.lower(), None) if idx==None: raise ValueError(f"Image format {output} not in {tuple(valid_formats.keys())}") if self.alpha and idx in (2, 6, 7): raise ValueError("'%s' cannot have alpha" % output) if self.colorspace and self.colorspace.n > 3 and idx in (1, 2, 4): raise ValueError("unsupported colorspace for '%s'" % output) if idx == 7: self.set_dpi(self.xres, self.yres) barray = self._tobytes(idx, jpg_quality) return barray %} //----------------------------------------------------------------- // output as PDF-OCR //----------------------------------------------------------------- FITZEXCEPTION(pdfocr_save, !result) %pythonprepend pdfocr_save %{ """Save pixmap as an OCR-ed PDF page.""" EnsureOwnership(self) if not os.getenv("TESSDATA_PREFIX") and not tessdata: raise RuntimeError("No OCR support: TESSDATA_PREFIX not set") %} ENSURE_OWNERSHIP(pdfocr_save, ) PyObject *pdfocr_save(PyObject *filename, int compress=1, char *language=NULL, char *tessdata=NULL) { fz_pdfocr_options opts; memset(&opts, 0, sizeof opts); opts.compress = compress; if (language) { fz_strlcpy(opts.language, language, sizeof(opts.language)); } if (tessdata) { fz_strlcpy(opts.datadir, tessdata, sizeof(opts.language)); } fz_output *out = NULL; fz_pixmap *pix = (fz_pixmap *) $self; fz_try(gctx) { if (PyUnicode_Check(filename)) { fz_save_pixmap_as_pdfocr(gctx, pix, (char *) PyUnicode_AsUTF8(filename), 0, &opts); } else { out = JM_new_output_fileptr(gctx, filename); fz_write_pixmap_as_pdfocr(gctx, out, pix, &opts); } } fz_always(gctx) { fz_drop_output(gctx, out); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def pdfocr_tobytes(self, compress=True, language="eng", tessdata=None): """Save pixmap as an OCR-ed PDF page. Args: compress: (bool) compress, default 1 (True). language: (str) language(s) occurring on page, default "eng" (English), multiples like "eng+ger" for English and German. tessdata: (str) folder name of Tesseract's language support. Must be given if environment variable TESSDATA_PREFIX is not set. Notes: On failure, make sure Tesseract is installed and you have set the environment variable "TESSDATA_PREFIX" to the folder containing your Tesseract's language support data. """ if not os.getenv("TESSDATA_PREFIX") and not tessdata: raise RuntimeError("No OCR support: TESSDATA_PREFIX not set") EnsureOwnership(self) from io import BytesIO bio = BytesIO() self.pdfocr_save(bio, compress=compress, language=language, tessdata=tessdata) return bio.getvalue() %} //----------------------------------------------------------------- // _writeIMG //----------------------------------------------------------------- FITZEXCEPTION(_writeIMG, !result) PyObject *_writeIMG(char *filename, int format, int jpg_quality) { fz_try(gctx) { fz_pixmap *pm = (fz_pixmap *) $self; switch(format) { case(1): fz_save_pixmap_as_png(gctx, pm, filename); break; case(2): fz_save_pixmap_as_pnm(gctx, pm, filename); break; case(3): fz_save_pixmap_as_pam(gctx, pm, filename); break; case(5): // Adobe Photoshop Document fz_save_pixmap_as_psd(gctx, pm, filename); break; case(6): // Postscript fz_save_pixmap_as_ps(gctx, pm, filename, 0); break; #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 case(7): // JPEG fz_save_pixmap_as_jpeg(gctx, pm, filename, jpg_quality); break; #endif default: fz_save_pixmap_as_png(gctx, pm, filename); break; } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def save(self, filename, output=None, jpg_quality=95): """Output as image in format determined by filename extension. Args: output: (str) only use to overrule filename extension. Default is PNG. Others are JPEG, JPG, PNM, PGM, PPM, PBM, PAM, PSD, PS. """ EnsureOwnership(self) valid_formats = {"png": 1, "pnm": 2, "pgm": 2, "ppm": 2, "pbm": 2, "pam": 3, "psd": 5, "ps": 6, "jpg": 7, "jpeg": 7} if type(filename) is str: pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name if output is None: _, ext = os.path.splitext(filename) output = ext[1:] idx = valid_formats.get(output.lower(), None) if idx == None: raise ValueError(f"Image format {output} not in {tuple(valid_formats.keys())}") if self.alpha and idx in (2, 6, 7): raise ValueError("'%s' cannot have alpha" % output) if self.colorspace and self.colorspace.n > 3 and idx in (1, 2, 4): raise ValueError("unsupported colorspace for '%s'" % output) if idx == 7: self.set_dpi(self.xres, self.yres) return self._writeIMG(filename, idx, jpg_quality) def pil_save(self, *args, unmultiply=False, **kwargs): """Write to image file using Pillow. Args are passed to Pillow's Image.save method, see their documentation. Use instead of save when other output formats are desired. :arg bool unmultiply: generates Pillow mode "RGBa" instead of "RGBA". Relevant for colorspace RGB with alpha only. """ EnsureOwnership(self) try: from PIL import Image except ImportError: print("Pillow not installed") raise cspace = self.colorspace if cspace is None: mode = "L" elif cspace.n == 1: mode = "L" if self.alpha == 0 else "LA" elif cspace.n == 3: mode = "RGB" if self.alpha == 0 else "RGBA" if mode == "RGBA" and unmultiply: mode = "RGBa" else: mode = "CMYK" img = Image.frombytes(mode, (self.width, self.height), self.samples) if "dpi" not in kwargs.keys(): kwargs["dpi"] = (self.xres, self.yres) img.save(*args, **kwargs) def pil_tobytes(self, *args, unmultiply=False, **kwargs): """Convert to binary image stream using pillow. Args are passed to Pillow's Image.save method, see their documentation. Use instead of 'tobytes' when other output formats are needed. """ EnsureOwnership(self) from io import BytesIO bytes_out = BytesIO() self.pil_save(bytes_out, *args, unmultiply=unmultiply, **kwargs) return bytes_out.getvalue() %} //----------------------------------------------------------------- // invert_irect //----------------------------------------------------------------- %pythonprepend invert_irect %{"""Invert the colors inside a bbox."""%} PyObject *invert_irect(PyObject *bbox = NULL) { fz_pixmap *pm = (fz_pixmap *) $self; if (!fz_pixmap_colorspace(gctx, pm)) { JM_Warning("ignored for stencil pixmap"); return JM_BOOL(0); } fz_irect r = JM_irect_from_py(bbox); if (fz_is_infinite_irect(r)) r = fz_pixmap_bbox(gctx, pm); return JM_BOOL(JM_invert_pixmap_rect(gctx, pm, r)); } //----------------------------------------------------------------- // get one pixel as a list //----------------------------------------------------------------- FITZEXCEPTION(pixel, !result) ENSURE_OWNERSHIP(pixel, """Get color tuple of pixel (x, y). Includes alpha byte if applicable.""") PyObject *pixel(int x, int y) { PyObject *p = NULL; fz_try(gctx) { fz_pixmap *pm = (fz_pixmap *) $self; if (!INRANGE(x, 0, pm->w - 1) || !INRANGE(y, 0, pm->h - 1)) { RAISEPY(gctx, MSG_PIXEL_OUTSIDE, PyExc_ValueError); } int n = pm->n; int stride = fz_pixmap_stride(gctx, pm); int j, i = stride * y + n * x; p = PyTuple_New(n); for (j = 0; j < n; j++) { PyTuple_SET_ITEM(p, j, Py_BuildValue("i", pm->samples[i + j])); } } fz_catch(gctx) { return NULL; } return p; } //----------------------------------------------------------------- // Set one pixel to a given color tuple //----------------------------------------------------------------- FITZEXCEPTION(set_pixel, !result) ENSURE_OWNERSHIP(set_pixel, """Set color of pixel (x, y).""") PyObject *set_pixel(int x, int y, PyObject *color) { fz_try(gctx) { fz_pixmap *pm = (fz_pixmap *) $self; if (!INRANGE(x, 0, pm->w - 1) || !INRANGE(y, 0, pm->h - 1)) { RAISEPY(gctx, MSG_PIXEL_OUTSIDE, PyExc_ValueError); } int n = pm->n; if (!PySequence_Check(color) || PySequence_Size(color) != n) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } int i, j; unsigned char c[5]; for (j = 0; j < n; j++) { if (JM_INT_ITEM(color, j, &i) == 1) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } if (!INRANGE(i, 0, 255)) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } c[j] = (unsigned char) i; } int stride = fz_pixmap_stride(gctx, pm); i = stride * y + n * x; for (j = 0; j < n; j++) { pm->samples[i + j] = c[j]; } } fz_catch(gctx) { PyErr_Clear(); return NULL; } Py_RETURN_NONE; } //----------------------------------------------------------------- // Set Pixmap origin //----------------------------------------------------------------- ENSURE_OWNERSHIP(set_origin, """Set top-left coordinates.""") PyObject *set_origin(int x, int y) { fz_pixmap *pm = (fz_pixmap *) $self; pm->x = x; pm->y = y; Py_RETURN_NONE; } ENSURE_OWNERSHIP(set_dpi, """Set resolution in both dimensions.""") PyObject *set_dpi(int xres, int yres) { fz_pixmap *pm = (fz_pixmap *) $self; pm->xres = xres; pm->yres = yres; Py_RETURN_NONE; } //----------------------------------------------------------------- // Set a rect to a given color tuple //----------------------------------------------------------------- FITZEXCEPTION(set_rect, !result) ENSURE_OWNERSHIP(set_rect, """Set color of all pixels in bbox.""") PyObject *set_rect(PyObject *bbox, PyObject *color) { PyObject *rc = NULL; fz_try(gctx) { fz_pixmap *pm = (fz_pixmap *) $self; Py_ssize_t j, n = (Py_ssize_t) pm->n; if (!PySequence_Check(color) || PySequence_Size(color) != n) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } unsigned char c[5]; int i; for (j = 0; j < n; j++) { if (JM_INT_ITEM(color, j, &i) == 1) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } if (!INRANGE(i, 0, 255)) { RAISEPY(gctx, MSG_BAD_COLOR_SEQ, PyExc_ValueError); } c[j] = (unsigned char) i; } i = JM_fill_pixmap_rect_with_color(gctx, pm, c, JM_irect_from_py(bbox)); rc = JM_BOOL(i); } fz_catch(gctx) { PyErr_Clear(); return NULL; } return rc; } //----------------------------------------------------------------- // check if monochrome //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(is_monochrome, """Check if pixmap is monochrome.""") PyObject *is_monochrome() { return JM_BOOL(fz_is_pixmap_monochrome(gctx, (fz_pixmap *) $self)); } //----------------------------------------------------------------- // check if unicolor (only one color there) //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(is_unicolor, """Check if pixmap has only one color.""") PyObject *is_unicolor() { fz_pixmap *pm = (fz_pixmap *) $self; size_t i, n = pm->n, count = pm->w * pm->h * n; unsigned char *s = pm->samples; for (i = n; i < count; i += n) { if (memcmp(s, s + i, n) != 0) { Py_RETURN_FALSE; } } Py_RETURN_TRUE; } //----------------------------------------------------------------- // count each pixmap color //----------------------------------------------------------------- FITZEXCEPTION(color_count, !result) ENSURE_OWNERSHIP(color_count, """Return count of each color.""") PyObject *color_count(int colors=0, PyObject *clip=NULL) { fz_pixmap *pm = (fz_pixmap *) $self; PyObject *rc = NULL; fz_try(gctx) { rc = JM_color_count(gctx, pm, clip); if (!rc) { RAISEPY(gctx, MSG_COLOR_COUNT_FAILED, PyExc_RuntimeError); } } fz_catch(gctx) { return NULL; } if (!colors) { Py_ssize_t len = PyDict_Size(rc); Py_DECREF(rc); return PyLong_FromSsize_t(len); } return rc; } %pythoncode %{ def color_topusage(self, clip=None): """Return most frequent color and its usage ratio.""" EnsureOwnership(self) allpixels = 0 cnt = 0 if clip != None and self.irect in Rect(clip): clip = self.irect for pixel, count in self.color_count(colors=True,clip=clip).items(): allpixels += count if count > cnt: cnt = count maxpixel = pixel if not allpixels: return (1, bytes([255] * self.n)) return (cnt / allpixels, maxpixel) %} //----------------------------------------------------------------- // MD5 digest of pixmap //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(digest, """MD5 digest of pixmap (bytes).""") PyObject *digest() { unsigned char digest[16]; fz_md5_pixmap(gctx, (fz_pixmap *) $self, digest); return PyBytes_FromStringAndSize(digest, 16); } //----------------------------------------------------------------- // get length of one image row //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(stride, """Length of one image line (width * n).""") PyObject *stride() { return PyLong_FromSize_t((size_t) fz_pixmap_stride(gctx, (fz_pixmap *) $self)); } //----------------------------------------------------------------- // x, y, width, height, xres, yres, n //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(xres, """Resolution in x direction.""") int xres() { fz_pixmap *this_pix = (fz_pixmap *) $self; return this_pix->xres; } %pythoncode %{@property%} ENSURE_OWNERSHIP(yres, """Resolution in y direction.""") int yres() { fz_pixmap *this_pix = (fz_pixmap *) $self; return this_pix->yres; } %pythoncode %{@property%} ENSURE_OWNERSHIP(w, """The width.""") PyObject *w() { return PyLong_FromSize_t((size_t) fz_pixmap_width(gctx, (fz_pixmap *) $self)); } %pythoncode %{@property%} ENSURE_OWNERSHIP(h, """The height.""") PyObject *h() { return PyLong_FromSize_t((size_t) fz_pixmap_height(gctx, (fz_pixmap *) $self)); } %pythoncode %{@property%} ENSURE_OWNERSHIP(x, """x component of Pixmap origin.""") int x() { return fz_pixmap_x(gctx, (fz_pixmap *) $self); } %pythoncode %{@property%} ENSURE_OWNERSHIP(y, """y component of Pixmap origin.""") int y() { return fz_pixmap_y(gctx, (fz_pixmap *) $self); } %pythoncode %{@property%} ENSURE_OWNERSHIP(n, """The size of one pixel.""") int n() { return fz_pixmap_components(gctx, (fz_pixmap *) $self); } //----------------------------------------------------------------- // check alpha channel //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(alpha, """Indicates presence of alpha channel.""") int alpha() { return fz_pixmap_alpha(gctx, (fz_pixmap *) $self); } //----------------------------------------------------------------- // get colorspace of pixmap //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(colorspace, """Pixmap Colorspace.""") struct Colorspace *colorspace() { return (struct Colorspace *) fz_pixmap_colorspace(gctx, (fz_pixmap *) $self); } //----------------------------------------------------------------- // return irect of pixmap //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(irect, """Pixmap bbox - an IRect object.""") %pythonappend irect %{val = IRect(val)%} PyObject *irect() { return JM_py_from_irect(fz_pixmap_bbox(gctx, (fz_pixmap *) $self)); } //----------------------------------------------------------------- // return size of pixmap //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(size, """Pixmap size.""") PyObject *size() { return PyLong_FromSize_t(fz_pixmap_size(gctx, (fz_pixmap *) $self)); } //----------------------------------------------------------------- // samples //----------------------------------------------------------------- %pythoncode %{@property%} ENSURE_OWNERSHIP(samples_mv, """Pixmap samples memoryview.""") PyObject *samples_mv() { fz_pixmap *pm = (fz_pixmap *) $self; Py_ssize_t s = (Py_ssize_t) pm->w; s *= pm->h; s *= pm->n; return PyMemoryView_FromMemory((char *) pm->samples, s, PyBUF_READ); } %pythoncode %{@property%} ENSURE_OWNERSHIP(samples_ptr, """Pixmap samples pointer.""") PyObject *samples_ptr() { fz_pixmap *pm = (fz_pixmap *) $self; return PyLong_FromVoidPtr((void *) pm->samples); } %pythoncode %{ @property def samples(self)->bytes: return bytes(self.samples_mv) width = w height = h def __len__(self): return self.size def __repr__(self): EnsureOwnership(self) if not type(self) is Pixmap: return if self.colorspace: return "Pixmap(%s, %s, %s)" % (self.colorspace.name, self.irect, self.alpha) else: return "Pixmap(%s, %s, %s)" % ('None', self.irect, self.alpha) def __enter__(self): return self def __exit__(self, *args): if getattr(self, "thisown", False): self.__swig_destroy__(self) def __del__(self): if not type(self) is Pixmap: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; /* fz_colorspace */ struct Colorspace { %extend { ~Colorspace() { DEBUGMSG1("Colorspace"); fz_colorspace *this_cs = (fz_colorspace *) $self; fz_drop_colorspace(gctx, this_cs); DEBUGMSG2; } %pythonprepend Colorspace %{"""Supported are GRAY, RGB and CMYK."""%} Colorspace(int type) { fz_colorspace *cs = NULL; switch(type) { case CS_GRAY: cs = fz_device_gray(gctx); break; case CS_CMYK: cs = fz_device_cmyk(gctx); break; case CS_RGB: default: cs = fz_device_rgb(gctx); break; } fz_keep_colorspace(gctx, cs); return (struct Colorspace *) cs; } //----------------------------------------------------------------- // number of bytes to define color of one pixel //----------------------------------------------------------------- %pythoncode %{@property%} %pythonprepend n %{"""Size of one pixel."""%} PyObject *n() { return Py_BuildValue("i", fz_colorspace_n(gctx, (fz_colorspace *) $self)); } //----------------------------------------------------------------- // name of colorspace //----------------------------------------------------------------- PyObject *_name() { return JM_UnicodeFromStr(fz_colorspace_name(gctx, (fz_colorspace *) $self)); } %pythoncode %{ @property def name(self): """Name of the Colorspace.""" if self.n == 1: return csGRAY._name() elif self.n == 3: return csRGB._name() elif self.n == 4: return csCMYK._name() return self._name() def __repr__(self): x = ("", "GRAY", "", "RGB", "CMYK")[self.n] return "Colorspace(CS_%s) - %s" % (x, self.name) %} } }; /* fz_device wrapper */ %rename(Device) DeviceWrapper; struct DeviceWrapper { %extend { FITZEXCEPTION(DeviceWrapper, !result) DeviceWrapper(struct Pixmap *pm, PyObject *clip) { struct DeviceWrapper *dw = NULL; fz_try(gctx) { dw = (struct DeviceWrapper *)calloc(1, sizeof(struct DeviceWrapper)); fz_irect bbox = JM_irect_from_py(clip); if (fz_is_infinite_irect(bbox)) dw->device = fz_new_draw_device(gctx, fz_identity, (fz_pixmap *) pm); else dw->device = fz_new_draw_device_with_bbox(gctx, fz_identity, (fz_pixmap *) pm, &bbox); } fz_catch(gctx) { return NULL; } return dw; } DeviceWrapper(struct DisplayList *dl) { struct DeviceWrapper *dw = NULL; fz_try(gctx) { dw = (struct DeviceWrapper *)calloc(1, sizeof(struct DeviceWrapper)); dw->device = fz_new_list_device(gctx, (fz_display_list *) dl); dw->list = (fz_display_list *) dl; fz_keep_display_list(gctx, (fz_display_list *) dl); } fz_catch(gctx) { return NULL; } return dw; } DeviceWrapper(struct TextPage *tp, int flags = 0) { struct DeviceWrapper *dw = NULL; fz_try(gctx) { dw = (struct DeviceWrapper *)calloc(1, sizeof(struct DeviceWrapper)); fz_stext_options opts = { 0 }; opts.flags = flags; dw->device = fz_new_stext_device(gctx, (fz_stext_page *) tp, &opts); } fz_catch(gctx) { return NULL; } return dw; } ~DeviceWrapper() { fz_display_list *list = $self->list; DEBUGMSG1("Device"); fz_close_device(gctx, $self->device); fz_drop_device(gctx, $self->device); DEBUGMSG2; if(list) { DEBUGMSG1("DisplayList after Device"); fz_drop_display_list(gctx, list); DEBUGMSG2; } } } }; //------------------------------------------------------------------------ // fz_outline //------------------------------------------------------------------------ %nodefaultctor; struct Outline { %immutable; %extend { ~Outline() { DEBUGMSG1("Outline"); fz_outline *this_ol = (fz_outline *) $self; fz_drop_outline(gctx, this_ol); DEBUGMSG2; } %pythoncode %{@property%} PyObject *uri() { fz_outline *ol = (fz_outline *) $self; return JM_UnicodeFromStr(ol->uri); } /* `%newobject foo;` is equivalent to wrapping C fn in python like: ret = _foo() ret.thisown=true return ret. */ %newobject next; %pythoncode %{@property%} struct Outline *next() { fz_outline *ol = (fz_outline *) $self; fz_outline *next_ol = ol->next; if (!next_ol) return NULL; next_ol = fz_keep_outline(gctx, next_ol); return (struct Outline *) next_ol; } %newobject down; %pythoncode %{@property%} struct Outline *down() { fz_outline *ol = (fz_outline *) $self; fz_outline *down_ol = ol->down; if (!down_ol) return NULL; down_ol = fz_keep_outline(gctx, down_ol); return (struct Outline *) down_ol; } %pythoncode %{@property%} PyObject *is_external() { fz_outline *ol = (fz_outline *) $self; if (!ol->uri) Py_RETURN_FALSE; return JM_BOOL(fz_is_external_link(gctx, ol->uri)); } %pythoncode %{@property%} int page() { fz_outline *ol = (fz_outline *) $self; return ol->page.page; } %pythoncode %{@property%} float x() { fz_outline *ol = (fz_outline *) $self; return ol->x; } %pythoncode %{@property%} float y() { fz_outline *ol = (fz_outline *) $self; return ol->y; } %pythoncode %{@property%} PyObject *title() { fz_outline *ol = (fz_outline *) $self; return JM_UnicodeFromStr(ol->title); } %pythoncode %{@property%} PyObject *is_open() { fz_outline *ol = (fz_outline *) $self; return JM_BOOL(ol->is_open); } %pythoncode %{ @property def dest(self): '''outline destination details''' return linkDest(self, None) def __del__(self): if not isinstance(self, Outline): return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; %clearnodefaultctor; //------------------------------------------------------------------------ // Annotation //------------------------------------------------------------------------ %nodefaultctor; struct Annot { %extend { ~Annot() { DEBUGMSG1("Annot"); pdf_annot *this_annot = (pdf_annot *) $self; pdf_drop_annot(gctx, this_annot); DEBUGMSG2; } //---------------------------------------------------------------- // annotation rectangle //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(rect, """annotation rectangle""") %pythonappend rect %{ val = Rect(val) val *= self.parent.derotation_matrix %} PyObject * rect() { fz_rect r = pdf_bound_annot(gctx, (pdf_annot *) $self); return JM_py_from_rect(r); } %pythoncode %{@property%} PARENTCHECK(rect_delta, """annotation delta values to rectangle""") PyObject * rect_delta() { PyObject *rc=NULL; float d; fz_try(gctx) { pdf_obj *annot_obj = pdf_annot_obj(gctx, (pdf_annot *) $self); pdf_obj *arr = pdf_dict_get(gctx, annot_obj, PDF_NAME(RD)); int i, n = pdf_array_len(gctx, arr); if (n != 4) { rc = Py_BuildValue("s", NULL); } else { rc = PyTuple_New(4); for (i = 0; i < n; i++) { d = pdf_to_real(gctx, pdf_array_get(gctx, arr, i)); if (i == 2 || i == 3) d *= -1; PyTuple_SET_ITEM(rc, i, Py_BuildValue("f", d)); } } } fz_catch(gctx) { Py_RETURN_NONE; } return rc; } //---------------------------------------------------------------- // annotation xref number //---------------------------------------------------------------- PARENTCHECK(xref, """annotation xref""") %pythoncode %{@property%} PyObject *xref() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); return Py_BuildValue("i", pdf_to_num(gctx, annot_obj)); } //---------------------------------------------------------------- // annotation get IRT xref number //---------------------------------------------------------------- PARENTCHECK(irt_xref, """annotation IRT xref""") %pythoncode %{@property%} PyObject *irt_xref() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *irt = pdf_dict_get(gctx, annot_obj, PDF_NAME(IRT)); if (!irt) return PyLong_FromLong(0); return PyLong_FromLong((long) pdf_to_num(gctx, irt)); } //---------------------------------------------------------------- // annotation set IRT xref number //---------------------------------------------------------------- FITZEXCEPTION(set_irt_xref, !result) PARENTCHECK(set_irt_xref, """Set annotation IRT xref""") PyObject *set_irt_xref(int xref) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_page *page = pdf_annot_page(gctx, annot); if (!INRANGE(xref, 1, pdf_xref_len(gctx, page->doc) - 1)) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } pdf_obj *irt = pdf_new_indirect(gctx, page->doc, xref, 0); pdf_obj *subt = pdf_dict_get(gctx, irt, PDF_NAME(Subtype)); int irt_subt = pdf_annot_type_from_string(gctx, pdf_to_name(gctx, subt)); if (irt_subt < 0) { pdf_drop_obj(gctx, irt); RAISEPY(gctx, MSG_IS_NO_ANNOT, PyExc_ValueError); } pdf_dict_put_drop(gctx, annot_obj, PDF_NAME(IRT), irt); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation get AP/N Matrix //---------------------------------------------------------------- PARENTCHECK(apn_matrix, """annotation appearance matrix""") %pythonappend apn_matrix %{val = Matrix(val)%} %pythoncode %{@property%} PyObject * apn_matrix() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!ap) return JM_py_from_matrix(fz_identity); fz_matrix mat = pdf_dict_get_matrix(gctx, ap, PDF_NAME(Matrix)); return JM_py_from_matrix(mat); } //---------------------------------------------------------------- // annotation get AP/N BBox //---------------------------------------------------------------- PARENTCHECK(apn_bbox, """annotation appearance bbox""") %pythonappend apn_bbox %{ val = Rect(val) * self.parent.transformation_matrix val *= self.parent.derotation_matrix%} %pythoncode %{@property%} PyObject * apn_bbox() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!ap) return JM_py_from_rect(fz_infinite_rect); fz_rect rect = pdf_dict_get_rect(gctx, ap, PDF_NAME(BBox)); return JM_py_from_rect(rect); } //---------------------------------------------------------------- // annotation set AP/N Matrix //---------------------------------------------------------------- FITZEXCEPTION(set_apn_matrix, !result) PARENTCHECK(set_apn_matrix, """Set annotation appearance matrix.""") PyObject * set_apn_matrix(PyObject *matrix) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_try(gctx) { pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!ap) { RAISEPY(gctx, MSG_BAD_APN, PyExc_RuntimeError); } fz_matrix mat = JM_matrix_from_py(matrix); pdf_dict_put_matrix(gctx, ap, PDF_NAME(Matrix), mat); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation set AP/N BBox //---------------------------------------------------------------- FITZEXCEPTION(set_apn_bbox, !result) %pythonprepend set_apn_bbox %{ """Set annotation appearance bbox.""" CheckParent(self) page = self.parent rot = page.rotation_matrix mat = page.transformation_matrix bbox *= rot * ~mat %} PyObject * set_apn_bbox(PyObject *bbox) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_try(gctx) { pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!ap) { RAISEPY(gctx, MSG_BAD_APN, PyExc_RuntimeError); } fz_rect rect = JM_rect_from_py(bbox); pdf_dict_put_rect(gctx, ap, PDF_NAME(BBox), rect); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation show blend mode (/BM) //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(blendmode, """annotation BlendMode""") PyObject *blendmode() { PyObject *blend_mode = NULL; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *obj, *obj1, *obj2; obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(BM)); if (obj) { blend_mode = JM_UnicodeFromStr(pdf_to_name(gctx, obj)); goto finished; } // loop through the /AP/N/Resources/ExtGState objects obj = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), PDF_NAME(Resources), PDF_NAME(ExtGState), NULL); if (pdf_is_dict(gctx, obj)) { int i, j, m, n = pdf_dict_len(gctx, obj); for (i = 0; i < n; i++) { obj1 = pdf_dict_get_val(gctx, obj, i); if (pdf_is_dict(gctx, obj1)) { m = pdf_dict_len(gctx, obj1); for (j = 0; j < m; j++) { obj2 = pdf_dict_get_key(gctx, obj1, j); if (pdf_objcmp(gctx, obj2, PDF_NAME(BM)) == 0) { blend_mode = JM_UnicodeFromStr(pdf_to_name(gctx, pdf_dict_get_val(gctx, obj1, j))); goto finished; } } } } } finished:; } fz_catch(gctx) { Py_RETURN_NONE; } if (blend_mode) return blend_mode; Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation set blend mode (/BM) //---------------------------------------------------------------- FITZEXCEPTION(set_blendmode, !result) PARENTCHECK(set_blendmode, """Set annotation BlendMode.""") PyObject * set_blendmode(char *blend_mode) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(BM), blend_mode); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation get optional content //---------------------------------------------------------------- FITZEXCEPTION(get_oc, !result) PARENTCHECK(get_oc, """Get annotation optional content reference.""") PyObject *get_oc() { int oc = 0; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(OC)); if (obj) { oc = pdf_to_num(gctx, obj); } } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", oc); } //---------------------------------------------------------------- // annotation set open //---------------------------------------------------------------- FITZEXCEPTION(set_open, !result) PARENTCHECK(set_open, """Set 'open' status of annotation or its Popup.""") PyObject *set_open(int is_open) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_set_annot_is_open(gctx, annot, is_open); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation inquiry: is open //---------------------------------------------------------------- FITZEXCEPTION(is_open, !result) PARENTCHECK(is_open, """Get 'open' status of annotation or its Popup.""") %pythoncode %{@property%} PyObject * is_open() { int is_open; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; is_open = pdf_annot_is_open(gctx, annot); } fz_catch(gctx) { return NULL; } return JM_BOOL(is_open); } //---------------------------------------------------------------- // annotation inquiry: has Popup //---------------------------------------------------------------- FITZEXCEPTION(has_popup, !result) PARENTCHECK(has_popup, """Check if annotation has a Popup.""") %pythoncode %{@property%} PyObject * has_popup() { int has_popup = 0; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(Popup)); if (obj) has_popup = 1; } fz_catch(gctx) { return NULL; } return JM_BOOL(has_popup); } //---------------------------------------------------------------- // annotation set Popup //---------------------------------------------------------------- FITZEXCEPTION(set_popup, !result) PARENTCHECK(set_popup, """Create annotation 'Popup' or update rectangle.""") PyObject * set_popup(PyObject *rect) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_page *pdfpage = pdf_annot_page(gctx, annot); fz_matrix rot = JM_rotate_page_matrix(gctx, pdfpage); fz_rect r = fz_transform_rect(JM_rect_from_py(rect), rot); pdf_set_annot_popup(gctx, annot, r); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation Popup rectangle //---------------------------------------------------------------- FITZEXCEPTION(popup_rect, !result) PARENTCHECK(popup_rect, """annotation 'Popup' rectangle""") %pythoncode %{@property%} %pythonappend popup_rect %{ val = Rect(val) * self.parent.transformation_matrix val *= self.parent.derotation_matrix%} PyObject * popup_rect() { fz_rect rect = fz_infinite_rect; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(Popup)); if (obj) { rect = pdf_dict_get_rect(gctx, obj, PDF_NAME(Rect)); } } fz_catch(gctx) { return NULL; } return JM_py_from_rect(rect); } //---------------------------------------------------------------- // annotation Popup xref //---------------------------------------------------------------- FITZEXCEPTION(popup_xref, !result) PARENTCHECK(popup_xref, """annotation 'Popup' xref""") %pythoncode %{@property%} PyObject * popup_xref() { int xref = 0; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(Popup)); if (obj) { xref = pdf_to_num(gctx, obj); } } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } //---------------------------------------------------------------- // annotation set optional content //---------------------------------------------------------------- FITZEXCEPTION(set_oc, !result) PARENTCHECK(set_oc, """Set / remove annotation OC xref.""") PyObject * set_oc(int oc=0) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); if (!oc) { pdf_dict_del(gctx, annot_obj, PDF_NAME(OC)); } else { JM_add_oc_object(gctx, pdf_get_bound_document(gctx, annot_obj), annot_obj, oc); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode%{@property%} %pythonprepend language %{"""annotation language"""%} PyObject *language() { pdf_annot *this_annot = (pdf_annot *) $self; fz_text_language lang = pdf_annot_language(gctx, this_annot); char buf[8]; if (lang == FZ_LANG_UNSET) Py_RETURN_NONE; return Py_BuildValue("s", fz_string_from_text_language(buf, lang)); } //---------------------------------------------------------------- // annotation set language (/Lang) //---------------------------------------------------------------- FITZEXCEPTION(set_language, !result) PARENTCHECK(set_language, """Set annotation language.""") PyObject *set_language(char *language=NULL) { pdf_annot *this_annot = (pdf_annot *) $self; fz_try(gctx) { fz_text_language lang; if (!language) lang = FZ_LANG_UNSET; else lang = fz_text_language_from_string(language); pdf_set_annot_language(gctx, this_annot, lang); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation get decompressed appearance stream source //---------------------------------------------------------------- FITZEXCEPTION(_getAP, !result) PyObject * _getAP() { PyObject *r = NULL; fz_buffer *res = NULL; fz_var(res); fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (pdf_is_stream(gctx, ap)) res = pdf_load_stream(gctx, ap); if (res) { r = JM_BinFromBuffer(gctx, res); } } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { Py_RETURN_NONE; } if (!r) Py_RETURN_NONE; return r; } //---------------------------------------------------------------- // annotation update /AP stream //---------------------------------------------------------------- FITZEXCEPTION(_setAP, !result) PyObject * _setAP(PyObject *buffer, int rect=0) { fz_buffer *res = NULL; fz_var(res); fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_page *page = pdf_annot_page(gctx, annot); pdf_obj *apobj = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!apobj) { RAISEPY(gctx, MSG_BAD_APN, PyExc_RuntimeError); } if (!pdf_is_stream(gctx, apobj)) { RAISEPY(gctx, MSG_BAD_APN, PyExc_RuntimeError); } res = JM_BufferFromBytes(gctx, buffer); if (!res) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_ValueError); } JM_update_stream(gctx, page->doc, apobj, res, 1); if (rect) { fz_rect bbox = pdf_dict_get_rect(gctx, annot_obj, PDF_NAME(Rect)); pdf_dict_put_rect(gctx, apobj, PDF_NAME(BBox), bbox); } } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // redaction annotation get values //---------------------------------------------------------------- FITZEXCEPTION(_get_redact_values, !result) %pythonappend _get_redact_values %{ if not val: return val val["rect"] = self.rect text_color, fontname, fontsize = TOOLS._parse_da(self) val["text_color"] = text_color val["fontname"] = fontname val["fontsize"] = fontsize fill = self.colors["fill"] val["fill"] = fill %} PyObject * _get_redact_values() { pdf_annot *annot = (pdf_annot *) $self; if (pdf_annot_type(gctx, annot) != PDF_ANNOT_REDACT) Py_RETURN_NONE; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); PyObject *values = PyDict_New(); pdf_obj *obj = NULL; const char *text = NULL; fz_try(gctx) { obj = pdf_dict_gets(gctx, annot_obj, "RO"); if (obj) { JM_Warning("Ignoring redaction key '/RO'."); int xref = pdf_to_num(gctx, obj); DICT_SETITEM_DROP(values, dictkey_xref, Py_BuildValue("i", xref)); } obj = pdf_dict_gets(gctx, annot_obj, "OverlayText"); if (obj) { text = pdf_to_text_string(gctx, obj); DICT_SETITEM_DROP(values, dictkey_text, JM_UnicodeFromStr(text)); } else { DICT_SETITEM_DROP(values, dictkey_text, Py_BuildValue("s", "")); } obj = pdf_dict_get(gctx, annot_obj, PDF_NAME(Q)); int align = 0; if (obj) { align = pdf_to_int(gctx, obj); } DICT_SETITEM_DROP(values, dictkey_align, Py_BuildValue("i", align)); } fz_catch(gctx) { Py_DECREF(values); return NULL; } return values; } //---------------------------------------------------------------- // annotation get TextPage //---------------------------------------------------------------- %pythonappend get_textpage %{ if val: val.thisown = True %} FITZEXCEPTION(get_textpage, !result) PARENTCHECK(get_textpage, """Make annotation TextPage.""") struct TextPage * get_textpage(PyObject *clip=NULL, int flags = 0) { fz_stext_page *textpage=NULL; fz_stext_options options = { 0 }; options.flags = flags; fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; textpage = pdf_new_stext_page_from_annot(gctx, annot, &options); } fz_catch(gctx) { return NULL; } return (struct TextPage *) textpage; } //---------------------------------------------------------------- // annotation set name //---------------------------------------------------------------- FITZEXCEPTION(set_name, !result) PARENTCHECK(set_name, """Set /Name (icon) of annotation.""") PyObject * set_name(char *name) { fz_try(gctx) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(Name), name); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation set rectangle //---------------------------------------------------------------- PARENTCHECK(set_rect, """Set annotation rectangle.""") FITZEXCEPTION(set_rect, !result) PyObject * set_rect(PyObject *rect) { pdf_annot *annot = (pdf_annot *) $self; int type = pdf_annot_type(gctx, annot); int err_source = 0; // what raised the error fz_var(err_source); fz_try(gctx) { pdf_page *pdfpage = pdf_annot_page(gctx, annot); fz_matrix rot = JM_rotate_page_matrix(gctx, pdfpage); fz_rect r = fz_transform_rect(JM_rect_from_py(rect), rot); if (fz_is_empty_rect(r) || fz_is_infinite_rect(r)) { RAISEPY(gctx, MSG_BAD_RECT, PyExc_ValueError); } err_source = 1; // indicate that error was from MuPDF pdf_set_annot_rect(gctx, annot, r); } fz_catch(gctx) { if (err_source == 0) { return NULL; } PySys_WriteStderr("cannot set rect: '%s'\n", fz_caught_message(gctx)); Py_RETURN_FALSE; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation set rotation //---------------------------------------------------------------- PARENTCHECK(set_rotation, """Set annotation rotation.""") PyObject * set_rotation(int rotate=0) { pdf_annot *annot = (pdf_annot *) $self; int type = pdf_annot_type(gctx, annot); switch (type) { case PDF_ANNOT_CARET: break; case PDF_ANNOT_CIRCLE: break; case PDF_ANNOT_FREE_TEXT: break; case PDF_ANNOT_FILE_ATTACHMENT: break; case PDF_ANNOT_INK: break; case PDF_ANNOT_LINE: break; case PDF_ANNOT_POLY_LINE: break; case PDF_ANNOT_POLYGON: break; case PDF_ANNOT_SQUARE: break; case PDF_ANNOT_STAMP: break; case PDF_ANNOT_TEXT: break; default: Py_RETURN_NONE; } int rot = rotate; while (rot < 0) rot += 360; while (rot >= 360) rot -= 360; if (type == PDF_ANNOT_FREE_TEXT && rot % 90 != 0) rot = 0; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_dict_put_int(gctx, annot_obj, PDF_NAME(Rotate), rot); Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation get rotation //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(rotation, """annotation rotation""") int rotation() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_obj *rotation = pdf_dict_get(gctx, annot_obj, PDF_NAME(Rotate)); if (!rotation) return -1; return pdf_to_int(gctx, rotation); } //---------------------------------------------------------------- // annotation vertices (for "Line", "Polgon", "Ink", etc. //---------------------------------------------------------------- PARENTCHECK(vertices, """annotation vertex points""") %pythoncode %{@property%} PyObject *vertices() { PyObject *res = NULL, *res1 = NULL; pdf_obj *o, *o1; pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_page *page = pdf_annot_page(gctx, annot); int i, j; fz_point point; // point object to work with fz_matrix page_ctm; // page transformation matrix pdf_page_transform(gctx, page, NULL, &page_ctm); fz_matrix derot = JM_derotate_page_matrix(gctx, page); page_ctm = fz_concat(page_ctm, derot); //---------------------------------------------------------------- // The following objects occur in different annotation types. // So we are sure that (!o) occurs at most once. // Every pair of floats is one point, that needs to be separately // transformed with the page transformation matrix. //---------------------------------------------------------------- o = pdf_dict_get(gctx, annot_obj, PDF_NAME(Vertices)); if (o) goto weiter; o = pdf_dict_get(gctx, annot_obj, PDF_NAME(L)); if (o) goto weiter; o = pdf_dict_get(gctx, annot_obj, PDF_NAME(QuadPoints)); if (o) goto weiter; o = pdf_dict_gets(gctx, annot_obj, "CL"); if (o) goto weiter; o = pdf_dict_get(gctx, annot_obj, PDF_NAME(InkList)); if (o) goto inklist; Py_RETURN_NONE; // handle lists with 1-level depth -------------------------------- weiter:; res = PyList_New(0); // create Python list for (i = 0; i < pdf_array_len(gctx, o); i += 2) { point.x = pdf_to_real(gctx, pdf_array_get(gctx, o, i)); point.y = pdf_to_real(gctx, pdf_array_get(gctx, o, i+1)); point = fz_transform_point(point, page_ctm); LIST_APPEND_DROP(res, Py_BuildValue("ff", point.x, point.y)); } return res; // InkList has 2-level lists -------------------------------------- inklist:; res = PyList_New(0); for (i = 0; i < pdf_array_len(gctx, o); i++) { res1 = PyList_New(0); o1 = pdf_array_get(gctx, o, i); for (j = 0; j < pdf_array_len(gctx, o1); j += 2) { point.x = pdf_to_real(gctx, pdf_array_get(gctx, o1, j)); point.y = pdf_to_real(gctx, pdf_array_get(gctx, o1, j+1)); point = fz_transform_point(point, page_ctm); LIST_APPEND_DROP(res1, Py_BuildValue("ff", point.x, point.y)); } LIST_APPEND_DROP(res, res1); } return res; } //---------------------------------------------------------------- // annotation colors //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(colors, """Color definitions.""") PyObject *colors() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); return JM_annot_colors(gctx, annot_obj); } //---------------------------------------------------------------- // annotation update appearance //---------------------------------------------------------------- PyObject *_update_appearance(float opacity=-1, char *blend_mode=NULL, PyObject *fill_color=NULL, int rotate = -1) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_page *page = pdf_annot_page(gctx, annot); pdf_document *pdf = page->doc; int type = pdf_annot_type(gctx, annot); float fcol[4] = {1,1,1,1}; // std fill color: white int i, nfcol = 0; // number of color components JM_color_FromSequence(fill_color, &nfcol, fcol); fz_try(gctx) { // remove fill color from unsupported annots // or if so requested if ((type != PDF_ANNOT_SQUARE && type != PDF_ANNOT_CIRCLE && type != PDF_ANNOT_LINE && type != PDF_ANNOT_POLY_LINE && type != PDF_ANNOT_POLYGON ) || nfcol == 0 ) { pdf_dict_del(gctx, annot_obj, PDF_NAME(IC)); } else if (nfcol > 0) { pdf_set_annot_interior_color(gctx, annot, nfcol, fcol); } int insert_rot = (rotate >= 0) ? 1 : 0; switch (type) { case PDF_ANNOT_CARET: case PDF_ANNOT_CIRCLE: case PDF_ANNOT_FREE_TEXT: case PDF_ANNOT_FILE_ATTACHMENT: case PDF_ANNOT_INK: case PDF_ANNOT_LINE: case PDF_ANNOT_POLY_LINE: case PDF_ANNOT_POLYGON: case PDF_ANNOT_SQUARE: case PDF_ANNOT_STAMP: case PDF_ANNOT_TEXT: break; default: insert_rot = 0; } if (insert_rot) { pdf_dict_put_int(gctx, annot_obj, PDF_NAME(Rotate), rotate); } pdf_dirty_annot(gctx, annot); pdf_update_annot(gctx, annot); // let MuPDF update pdf->resynth_required = 0; // insert fill color if (type == PDF_ANNOT_FREE_TEXT) { if (nfcol > 0) { pdf_set_annot_color(gctx, annot, nfcol, fcol); } } else if (nfcol > 0) { pdf_obj *col = pdf_new_array(gctx, page->doc, nfcol); for (i = 0; i < nfcol; i++) { pdf_array_push_real(gctx, col, fcol[i]); } pdf_dict_put_drop(gctx,annot_obj, PDF_NAME(IC), col); } } fz_catch(gctx) { PySys_WriteStderr("cannot update annot: '%s'\n", fz_caught_message(gctx)); Py_RETURN_FALSE; } if ((opacity < 0 || opacity >= 1) && !blend_mode) // no opacity, no blend_mode goto normal_exit; fz_try(gctx) { // create or update /ExtGState pdf_obj *ap = pdf_dict_getl(gctx, annot_obj, PDF_NAME(AP), PDF_NAME(N), NULL); if (!ap) { // should never happen RAISEPY(gctx, MSG_BAD_APN, PyExc_RuntimeError); } pdf_obj *resources = pdf_dict_get(gctx, ap, PDF_NAME(Resources)); if (!resources) { // no Resources yet: make one resources = pdf_dict_put_dict(gctx, ap, PDF_NAME(Resources), 2); } pdf_obj *alp0 = pdf_new_dict(gctx, page->doc, 3); if (opacity >= 0 && opacity < 1) { pdf_dict_put_real(gctx, alp0, PDF_NAME(CA), (double) opacity); pdf_dict_put_real(gctx, alp0, PDF_NAME(ca), (double) opacity); pdf_dict_put_real(gctx, annot_obj, PDF_NAME(CA), (double) opacity); } if (blend_mode) { pdf_dict_put_name(gctx, alp0, PDF_NAME(BM), blend_mode); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(BM), blend_mode); } pdf_obj *extg = pdf_dict_get(gctx, resources, PDF_NAME(ExtGState)); if (!extg) { // no ExtGState yet: make one extg = pdf_dict_put_dict(gctx, resources, PDF_NAME(ExtGState), 2); } pdf_dict_put_drop(gctx, extg, PDF_NAME(H), alp0); } fz_catch(gctx) { PySys_WriteStderr("cannot set opacity or blend mode\n"); Py_RETURN_FALSE; } normal_exit:; Py_RETURN_TRUE; } %pythoncode %{ def update(self, blend_mode: OptStr =None, opacity: OptFloat =None, fontsize: float =0, fontname: OptStr =None, text_color: OptSeq =None, border_color: OptSeq =None, fill_color: OptSeq =None, cross_out: bool =True, rotate: int =-1, ): """Update annot appearance. Notes: Depending on the annot type, some parameters make no sense, while others are only available in this method to achieve the desired result. This is especially true for 'FreeText' annots. Args: blend_mode: set the blend mode, all annotations. opacity: set the opacity, all annotations. fontsize: set fontsize, 'FreeText' only. fontname: set the font, 'FreeText' only. border_color: set border color, 'FreeText' only. text_color: set text color, 'FreeText' only. fill_color: set fill color, all annotations. cross_out: draw diagonal lines, 'Redact' only. rotate: set rotation, 'FreeText' and some others. """ CheckParent(self) def color_string(cs, code): """Return valid PDF color operator for a given color sequence. """ cc = ColorCode(cs, code) if not cc: return b"" return (cc + "\n").encode() annot_type = self.type[0] # get the annot type dt = self.border.get("dashes", None) # get the dashes spec bwidth = self.border.get("width", -1) # get border line width stroke = self.colors["stroke"] # get the stroke color if fill_color != None: # change of fill color requested fill = fill_color else: # put in current annot value fill = self.colors["fill"] rect = None # self.rect # prevent MuPDF fiddling with it apnmat = self.apn_matrix # prevent MuPDF fiddling with it if rotate != -1: # sanitize rotation value while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if annot_type == PDF_ANNOT_FREE_TEXT and rotate % 90 != 0: rotate = 0 #------------------------------------------------------------------ # handle opacity and blend mode #------------------------------------------------------------------ if blend_mode is None: blend_mode = self.blendmode if not hasattr(opacity, "__float__"): opacity = self.opacity if 0 <= opacity < 1 or blend_mode is not None: opa_code = "/H gs\n" # then we must reference this 'gs' else: opa_code = "" if annot_type == PDF_ANNOT_FREE_TEXT: CheckColor(border_color) CheckColor(text_color) CheckColor(fill_color) tcol, fname, fsize = TOOLS._parse_da(self) # read and update default appearance as necessary update_default_appearance = False if fsize <= 0: fsize = 12 update_default_appearance = True if text_color is not None: tcol = text_color update_default_appearance = True if fontname is not None: fname = fontname update_default_appearance = True if fontsize > 0: fsize = fontsize update_default_appearance = True if update_default_appearance: da_str = "" if len(tcol) == 3: fmt = "{:g} {:g} {:g} rg /{f:s} {s:g} Tf" elif len(tcol) == 1: fmt = "{:g} g /{f:s} {s:g} Tf" elif len(tcol) == 4: fmt = "{:g} {:g} {:g} {:g} k /{f:s} {s:g} Tf" da_str = fmt.format(*tcol, f=fname, s=fsize) TOOLS._update_da(self, da_str) #------------------------------------------------------------------ # now invoke MuPDF to update the annot appearance #------------------------------------------------------------------ val = self._update_appearance( opacity=opacity, blend_mode=blend_mode, fill_color=fill, rotate=rotate, ) if val == False: raise RuntimeError("Error updating annotation.") bfill = color_string(fill, "f") bstroke = color_string(stroke, "c") p_ctm = self.parent.transformation_matrix imat = ~p_ctm # inverse page transf. matrix if dt: dashes = "[" + " ".join(map(str, dt)) + "] 0 d\n" dashes = dashes.encode("utf-8") else: dashes = None if self.line_ends: line_end_le, line_end_ri = self.line_ends else: line_end_le, line_end_ri = 0, 0 # init line end codes # read contents as created by MuPDF ap = self._getAP() ap_tab = ap.splitlines() # split in single lines ap_updated = False # assume we did nothing if annot_type == PDF_ANNOT_REDACT: if cross_out: # create crossed-out rect ap_updated = True ap_tab = ap_tab[:-1] _, LL, LR, UR, UL = ap_tab ap_tab.append(LR) ap_tab.append(LL) ap_tab.append(UR) ap_tab.append(LL) ap_tab.append(UL) ap_tab.append(b"S") if bwidth > 0 or bstroke != b"": ap_updated = True ntab = [b"%g w" % bwidth] if bwidth > 0 else [] for line in ap_tab: if line.endswith(b"w"): continue if line.endswith(b"RG") and bstroke != b"": line = bstroke[:-1] ntab.append(line) ap_tab = ntab ap = b"\n".join(ap_tab) if annot_type == PDF_ANNOT_FREE_TEXT: BT = ap.find(b"BT") ET = ap.find(b"ET") + 2 ap = ap[BT:ET] w, h = self.rect.width, self.rect.height if rotate in (90, 270) or not (apnmat.b == apnmat.c == 0): w, h = h, w re = b"0 0 %g %g re" % (w, h) ap = re + b"\nW\nn\n" + ap ope = None fill_string = color_string(fill, "f") if fill_string: ope = b"f" stroke_string = color_string(border_color, "c") if stroke_string and bwidth > 0: ope = b"S" bwidth = b"%g w\n" % bwidth else: bwidth = stroke_string = b"" if fill_string and stroke_string: ope = b"B" if ope != None: ap = bwidth + fill_string + stroke_string + re + b"\n" + ope + b"\n" + ap if dashes != None: # handle dashes ap = dashes + b"\n" + ap dashes = None ap_updated = True if annot_type in (PDF_ANNOT_POLYGON, PDF_ANNOT_POLY_LINE): ap = b"\n".join(ap_tab[:-1]) + b"\n" ap_updated = True if bfill != b"": if annot_type == PDF_ANNOT_POLYGON: ap = ap + bfill + b"b" # close, fill, and stroke elif annot_type == PDF_ANNOT_POLY_LINE: ap = ap + b"S" # stroke else: if annot_type == PDF_ANNOT_POLYGON: ap = ap + b"s" # close and stroke elif annot_type == PDF_ANNOT_POLY_LINE: ap = ap + b"S" # stroke if dashes is not None: # handle dashes ap = dashes + ap # reset dashing - only applies for LINE annots with line ends given ap = ap.replace(b"\nS\n", b"\nS\n[] 0 d\n", 1) ap_updated = True if opa_code: ap = opa_code.encode("utf-8") + ap ap_updated = True ap = b"q\n" + ap + b"\nQ\n" #---------------------------------------------------------------------- # the following handles line end symbols for 'Polygon' and 'Polyline' #---------------------------------------------------------------------- if line_end_le + line_end_ri > 0 and annot_type in (PDF_ANNOT_POLYGON, PDF_ANNOT_POLY_LINE): le_funcs = (None, TOOLS._le_square, TOOLS._le_circle, TOOLS._le_diamond, TOOLS._le_openarrow, TOOLS._le_closedarrow, TOOLS._le_butt, TOOLS._le_ropenarrow, TOOLS._le_rclosedarrow, TOOLS._le_slash) le_funcs_range = range(1, len(le_funcs)) d = 2 * max(1, self.border["width"]) rect = self.rect + (-d, -d, d, d) ap_updated = True points = self.vertices if line_end_le in le_funcs_range: p1 = Point(points[0]) * imat p2 = Point(points[1]) * imat left = le_funcs[line_end_le](self, p1, p2, False, fill_color) ap += left.encode() if line_end_ri in le_funcs_range: p1 = Point(points[-2]) * imat p2 = Point(points[-1]) * imat left = le_funcs[line_end_ri](self, p1, p2, True, fill_color) ap += left.encode() if ap_updated: if rect: # rect modified here? self.set_rect(rect) self._setAP(ap, rect=1) else: self._setAP(ap, rect=0) #------------------------------- # handle annotation rotations #------------------------------- if annot_type not in ( # only these types are supported PDF_ANNOT_CARET, PDF_ANNOT_CIRCLE, PDF_ANNOT_FILE_ATTACHMENT, PDF_ANNOT_INK, PDF_ANNOT_LINE, PDF_ANNOT_POLY_LINE, PDF_ANNOT_POLYGON, PDF_ANNOT_SQUARE, PDF_ANNOT_STAMP, PDF_ANNOT_TEXT, ): return rot = self.rotation # get value from annot object if rot == -1: # nothing to change return M = (self.rect.tl + self.rect.br) / 2 # center of annot rect if rot == 0: # undo rotations if abs(apnmat - Matrix(1, 1)) < 1e-5: return # matrix already is a no-op quad = self.rect.morph(M, ~apnmat) # derotate rect self.set_rect(quad.rect) self.set_apn_matrix(Matrix(1, 1)) # appearance matrix = no-op return mat = Matrix(rot) quad = self.rect.morph(M, mat) self.set_rect(quad.rect) self.set_apn_matrix(apnmat * mat) %} //---------------------------------------------------------------- // annotation set colors //---------------------------------------------------------------- %pythoncode %{ def set_colors(self, colors=None, stroke=None, fill=None): """Set 'stroke' and 'fill' colors. Use either a dict or the direct arguments. """ CheckParent(self) doc = self.parent.parent if type(colors) is not dict: colors = {"fill": fill, "stroke": stroke} fill = colors.get("fill") stroke = colors.get("stroke") fill_annots = (PDF_ANNOT_CIRCLE, PDF_ANNOT_SQUARE, PDF_ANNOT_LINE, PDF_ANNOT_POLY_LINE, PDF_ANNOT_POLYGON, PDF_ANNOT_REDACT,) if stroke in ([], ()): doc.xref_set_key(self.xref, "C", "[]") elif stroke is not None: if hasattr(stroke, "__float__"): stroke = [float(stroke)] CheckColor(stroke) if len(stroke) == 1: s = "[%g]" % stroke[0] elif len(stroke) == 3: s = "[%g %g %g]" % tuple(stroke) else: s = "[%g %g %g %g]" % tuple(stroke) doc.xref_set_key(self.xref, "C", s) if fill and self.type[0] not in fill_annots: print("Warning: fill color ignored for annot type '%s'." % self.type[1]) return if fill in ([], ()): doc.xref_set_key(self.xref, "IC", "[]") elif fill is not None: if hasattr(fill, "__float__"): fill = [float(fill)] CheckColor(fill) if len(fill) == 1: s = "[%g]" % fill[0] elif len(fill) == 3: s = "[%g %g %g]" % tuple(fill) else: s = "[%g %g %g %g]" % tuple(fill) doc.xref_set_key(self.xref, "IC", s) %} //---------------------------------------------------------------- // annotation line_ends //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(line_ends, """Line end codes.""") PyObject * line_ends() { pdf_annot *annot = (pdf_annot *) $self; // return nothing for invalid annot types if (!pdf_annot_has_line_ending_styles(gctx, annot)) Py_RETURN_NONE; int lstart = (int) pdf_annot_line_start_style(gctx, annot); int lend = (int) pdf_annot_line_end_style(gctx, annot); return Py_BuildValue("ii", lstart, lend); } //---------------------------------------------------------------- // annotation set line ends //---------------------------------------------------------------- PARENTCHECK(set_line_ends, """Set line end codes.""") void set_line_ends(int start, int end) { pdf_annot *annot = (pdf_annot *) $self; if (pdf_annot_has_line_ending_styles(gctx, annot)) pdf_set_annot_line_ending_styles(gctx, annot, start, end); else JM_Warning("bad annot type for line ends"); } //---------------------------------------------------------------- // annotation type //---------------------------------------------------------------- PARENTCHECK(type, """annotation type""") %pythoncode %{@property%} PyObject *type() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); int type = pdf_annot_type(gctx, annot); const char *c = pdf_string_from_annot_type(gctx, type); pdf_obj *o = pdf_dict_gets(gctx, annot_obj, "IT"); if (!o || !pdf_is_name(gctx, o)) return Py_BuildValue("is", type, c); // no IT entry const char *it = pdf_to_name(gctx, o); return Py_BuildValue("iss", type, c, it); } //---------------------------------------------------------------- // annotation opacity //---------------------------------------------------------------- PARENTCHECK(opacity, """Opacity.""") %pythoncode %{@property%} PyObject *opacity() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); double opy = -1; pdf_obj *ca = pdf_dict_get(gctx, annot_obj, PDF_NAME(CA)); if (pdf_is_number(gctx, ca)) opy = pdf_to_real(gctx, ca); return Py_BuildValue("f", opy); } //---------------------------------------------------------------- // annotation set opacity //---------------------------------------------------------------- PARENTCHECK(set_opacity, """Set opacity.""") void set_opacity(float opacity) { pdf_annot *annot = (pdf_annot *) $self; if (!INRANGE(opacity, 0.0f, 1.0f)) { pdf_set_annot_opacity(gctx, annot, 1); return; } pdf_set_annot_opacity(gctx, annot, opacity); if (opacity < 1.0f) { pdf_page *page = pdf_annot_page(gctx, annot); page->transparency = 1; } } //---------------------------------------------------------------- // annotation get attached file info //---------------------------------------------------------------- %pythoncode %{@property%} FITZEXCEPTION(file_info, !result) PARENTCHECK(file_info, """Attached file information.""") PyObject *file_info() { PyObject *res = PyDict_New(); // create Python dict char *filename = NULL; char *desc = NULL; int length = -1, size = -1; pdf_obj *stream = NULL, *o = NULL, *fs = NULL; pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_try(gctx) { int type = (int) pdf_annot_type(gctx, annot); if (type != PDF_ANNOT_FILE_ATTACHMENT) { RAISEPY(gctx, MSG_BAD_ANNOT_TYPE, PyExc_TypeError); } stream = pdf_dict_getl(gctx, annot_obj, PDF_NAME(FS), PDF_NAME(EF), PDF_NAME(F), NULL); if (!stream) { RAISEPY(gctx, "bad PDF: file entry not found", JM_Exc_FileDataError); } } fz_catch(gctx) { return NULL; } fs = pdf_dict_get(gctx, annot_obj, PDF_NAME(FS)); o = pdf_dict_get(gctx, fs, PDF_NAME(UF)); if (o) { filename = (char *) pdf_to_text_string(gctx, o); } else { o = pdf_dict_get(gctx, fs, PDF_NAME(F)); if (o) filename = (char *) pdf_to_text_string(gctx, o); } o = pdf_dict_get(gctx, fs, PDF_NAME(Desc)); if (o) desc = (char *) pdf_to_text_string(gctx, o); o = pdf_dict_get(gctx, stream, PDF_NAME(Length)); if (o) length = pdf_to_int(gctx, o); o = pdf_dict_getl(gctx, stream, PDF_NAME(Params), PDF_NAME(Size), NULL); if (o) size = pdf_to_int(gctx, o); DICT_SETITEM_DROP(res, dictkey_filename, JM_EscapeStrFromStr(filename)); DICT_SETITEM_DROP(res, dictkey_desc, JM_UnicodeFromStr(desc)); DICT_SETITEM_DROP(res, dictkey_length, Py_BuildValue("i", length)); DICT_SETITEM_DROP(res, dictkey_size, Py_BuildValue("i", size)); return res; } //---------------------------------------------------------------- // annotation get attached file content //---------------------------------------------------------------- FITZEXCEPTION(get_file, !result) PARENTCHECK(get_file, """Retrieve attached file content.""") PyObject * get_file() { PyObject *res = NULL; pdf_obj *stream = NULL; fz_buffer *buf = NULL; pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_var(buf); fz_try(gctx) { int type = (int) pdf_annot_type(gctx, annot); if (type != PDF_ANNOT_FILE_ATTACHMENT) { RAISEPY(gctx, MSG_BAD_ANNOT_TYPE, PyExc_TypeError); } stream = pdf_dict_getl(gctx, annot_obj, PDF_NAME(FS), PDF_NAME(EF), PDF_NAME(F), NULL); if (!stream) { RAISEPY(gctx, "bad PDF: file entry not found", JM_Exc_FileDataError); } buf = pdf_load_stream(gctx, stream); res = JM_BinFromBuffer(gctx, buf); } fz_always(gctx) { fz_drop_buffer(gctx, buf); } fz_catch(gctx) { return NULL; } return res; } //---------------------------------------------------------------- // annotation get attached sound stream //---------------------------------------------------------------- FITZEXCEPTION(get_sound, !result) PARENTCHECK(get_sound, """Retrieve sound stream.""") PyObject * get_sound() { PyObject *res = NULL; PyObject *stream = NULL; fz_buffer *buf = NULL; pdf_obj *obj = NULL; pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_var(buf); fz_try(gctx) { int type = (int) pdf_annot_type(gctx, annot); pdf_obj *sound = pdf_dict_get(gctx, annot_obj, PDF_NAME(Sound)); if (type != PDF_ANNOT_SOUND || !sound) { RAISEPY(gctx, MSG_BAD_ANNOT_TYPE, PyExc_TypeError); } if (pdf_dict_get(gctx, sound, PDF_NAME(F))) { RAISEPY(gctx, "unsupported sound stream", JM_Exc_FileDataError); } res = PyDict_New(); obj = pdf_dict_get(gctx, sound, PDF_NAME(R)); if (obj) { DICT_SETITEMSTR_DROP(res, "rate", Py_BuildValue("f", pdf_to_real(gctx, obj))); } obj = pdf_dict_get(gctx, sound, PDF_NAME(C)); if (obj) { DICT_SETITEMSTR_DROP(res, "channels", Py_BuildValue("i", pdf_to_int(gctx, obj))); } obj = pdf_dict_get(gctx, sound, PDF_NAME(B)); if (obj) { DICT_SETITEMSTR_DROP(res, "bps", Py_BuildValue("i", pdf_to_int(gctx, obj))); } obj = pdf_dict_get(gctx, sound, PDF_NAME(E)); if (obj) { DICT_SETITEMSTR_DROP(res, "encoding", Py_BuildValue("s", pdf_to_name(gctx, obj))); } obj = pdf_dict_gets(gctx, sound, "CO"); if (obj) { DICT_SETITEMSTR_DROP(res, "compression", Py_BuildValue("s", pdf_to_name(gctx, obj))); } buf = pdf_load_stream(gctx, sound); stream = JM_BinFromBuffer(gctx, buf); DICT_SETITEMSTR_DROP(res, "stream", stream); } fz_always(gctx) { fz_drop_buffer(gctx, buf); } fz_catch(gctx) { Py_CLEAR(res); return NULL; } return res; } //---------------------------------------------------------------- // annotation update attached file //---------------------------------------------------------------- FITZEXCEPTION(update_file, !result) %pythonprepend update_file %{"""Update attached file.""" CheckParent(self)%} PyObject * update_file(PyObject *buffer=NULL, char *filename=NULL, char *ufilename=NULL, char *desc=NULL) { pdf_document *pdf = NULL; // to be filled in fz_buffer *res = NULL; // for compressed content pdf_obj *stream = NULL, *fs = NULL; pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); fz_try(gctx) { pdf = pdf_get_bound_document(gctx, annot_obj); // the owning PDF int type = (int) pdf_annot_type(gctx, annot); if (type != PDF_ANNOT_FILE_ATTACHMENT) { RAISEPY(gctx, MSG_BAD_ANNOT_TYPE, PyExc_TypeError); } stream = pdf_dict_getl(gctx, annot_obj, PDF_NAME(FS), PDF_NAME(EF), PDF_NAME(F), NULL); // the object for file content if (!stream) { RAISEPY(gctx, "bad PDF: no /EF object", JM_Exc_FileDataError); } fs = pdf_dict_get(gctx, annot_obj, PDF_NAME(FS)); // file content given res = JM_BufferFromBytes(gctx, buffer); if (buffer && !res) { RAISEPY(gctx, MSG_BAD_BUFFER, PyExc_ValueError); } if (res) { JM_update_stream(gctx, pdf, stream, res, 1); // adjust /DL and /Size parameters int64_t len = (int64_t) fz_buffer_storage(gctx, res, NULL); pdf_obj *l = pdf_new_int(gctx, len); pdf_dict_put(gctx, stream, PDF_NAME(DL), l); pdf_dict_putl(gctx, stream, l, PDF_NAME(Params), PDF_NAME(Size), NULL); } if (filename) { pdf_dict_put_text_string(gctx, stream, PDF_NAME(F), filename); pdf_dict_put_text_string(gctx, fs, PDF_NAME(F), filename); pdf_dict_put_text_string(gctx, stream, PDF_NAME(UF), filename); pdf_dict_put_text_string(gctx, fs, PDF_NAME(UF), filename); pdf_dict_put_text_string(gctx, annot_obj, PDF_NAME(Contents), filename); } if (ufilename) { pdf_dict_put_text_string(gctx, stream, PDF_NAME(UF), ufilename); pdf_dict_put_text_string(gctx, fs, PDF_NAME(UF), ufilename); } if (desc) { pdf_dict_put_text_string(gctx, stream, PDF_NAME(Desc), desc); pdf_dict_put_text_string(gctx, fs, PDF_NAME(Desc), desc); } } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation info //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(info, """Various information details.""") PyObject *info() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); PyObject *res = PyDict_New(); pdf_obj *o; DICT_SETITEM_DROP(res, dictkey_content, JM_UnicodeFromStr(pdf_annot_contents(gctx, annot))); o = pdf_dict_get(gctx, annot_obj, PDF_NAME(Name)); DICT_SETITEM_DROP(res, dictkey_name, JM_UnicodeFromStr(pdf_to_name(gctx, o))); // Title (= author) o = pdf_dict_get(gctx, annot_obj, PDF_NAME(T)); DICT_SETITEM_DROP(res, dictkey_title, JM_UnicodeFromStr(pdf_to_text_string(gctx, o))); // CreationDate o = pdf_dict_gets(gctx, annot_obj, "CreationDate"); DICT_SETITEM_DROP(res, dictkey_creationDate, JM_UnicodeFromStr(pdf_to_text_string(gctx, o))); // ModDate o = pdf_dict_get(gctx, annot_obj, PDF_NAME(M)); DICT_SETITEM_DROP(res, dictkey_modDate, JM_UnicodeFromStr(pdf_to_text_string(gctx, o))); // Subj o = pdf_dict_gets(gctx, annot_obj, "Subj"); DICT_SETITEM_DROP(res, dictkey_subject, Py_BuildValue("s",pdf_to_text_string(gctx, o))); // Identification (PDF key /NM) o = pdf_dict_gets(gctx, annot_obj, "NM"); DICT_SETITEM_DROP(res, dictkey_id, JM_UnicodeFromStr(pdf_to_text_string(gctx, o))); return res; } //---------------------------------------------------------------- // annotation set information //---------------------------------------------------------------- FITZEXCEPTION(set_info, !result) %pythonprepend set_info %{ """Set various properties.""" CheckParent(self) if type(info) is dict: # build the args from the dictionary content = info.get("content", None) title = info.get("title", None) creationDate = info.get("creationDate", None) modDate = info.get("modDate", None) subject = info.get("subject", None) info = None %} PyObject * set_info(PyObject *info=NULL, char *content=NULL, char *title=NULL, char *creationDate=NULL, char *modDate=NULL, char *subject=NULL) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); // use this to indicate a 'markup' annot type int is_markup = pdf_annot_has_author(gctx, annot); fz_try(gctx) { // contents if (content) pdf_set_annot_contents(gctx, annot, content); if (is_markup) { // title (= author) if (title) pdf_set_annot_author(gctx, annot, title); // creation date if (creationDate) pdf_dict_put_text_string(gctx, annot_obj, PDF_NAME(CreationDate), creationDate); // mod date if (modDate) pdf_dict_put_text_string(gctx, annot_obj, PDF_NAME(M), modDate); // subject if (subject) pdf_dict_puts_drop(gctx, annot_obj, "Subj", pdf_new_text_string(gctx, subject)); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // annotation border //---------------------------------------------------------------- %pythoncode %{@property%} %pythonprepend border %{ """Border information.""" CheckParent(self) atype = self.type[0] if atype not in (PDF_ANNOT_CIRCLE, PDF_ANNOT_FREE_TEXT, PDF_ANNOT_INK, PDF_ANNOT_LINE, PDF_ANNOT_POLY_LINE,PDF_ANNOT_POLYGON, PDF_ANNOT_SQUARE): return {} %} PyObject *border() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); return JM_annot_border(gctx, annot_obj); } //---------------------------------------------------------------- // set annotation border //---------------------------------------------------------------- %pythonprepend set_border %{ """Set border properties. Either a dict, or direct arguments width, style, dashes or clouds.""" CheckParent(self) atype, atname = self.type[:2] # annotation type if atype not in (PDF_ANNOT_CIRCLE, PDF_ANNOT_FREE_TEXT, PDF_ANNOT_INK, PDF_ANNOT_LINE, PDF_ANNOT_POLY_LINE,PDF_ANNOT_POLYGON, PDF_ANNOT_SQUARE): print(f"Cannot set border for '{atname}'.") return None if not atype in (PDF_ANNOT_CIRCLE, PDF_ANNOT_FREE_TEXT,PDF_ANNOT_POLYGON, PDF_ANNOT_SQUARE): if clouds > 0: print(f"Cannot set cloudy border for '{atname}'.") clouds = -1 # do not set border effect if type(border) is not dict: border = {"width": width, "style": style, "dashes": dashes, "clouds": clouds} border.setdefault("width", -1) border.setdefault("style", None) border.setdefault("dashes", None) border.setdefault("clouds", -1) if border["width"] == None: border["width"] = -1 if border["clouds"] == None: border["clouds"] = -1 if hasattr(border["dashes"], "__getitem__"): # ensure sequence items are integers border["dashes"] = tuple(border["dashes"]) for item in border["dashes"]: if not isinstance(item, int): border["dashes"] = None break %} PyObject * set_border(PyObject *border=NULL, float width=-1, char *style=NULL, PyObject *dashes=NULL, int clouds=-1) { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_document *pdf = pdf_get_bound_document(gctx, annot_obj); return JM_annot_set_border(gctx, border, pdf, annot_obj); } //---------------------------------------------------------------- // annotation flags //---------------------------------------------------------------- %pythoncode %{@property%} PARENTCHECK(flags, """Flags field.""") int flags() { pdf_annot *annot = (pdf_annot *) $self; return pdf_annot_flags(gctx, annot); } //---------------------------------------------------------------- // annotation clean contents //---------------------------------------------------------------- FITZEXCEPTION(clean_contents, !result) PARENTCHECK(clean_contents, """Clean appearance contents stream.""") PyObject *clean_contents(int sanitize=1) { pdf_annot *annot = (pdf_annot *) $self; pdf_document *pdf = pdf_get_bound_document(gctx, pdf_annot_obj(gctx, annot)); #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 pdf_filter_factory list[2] = { 0 }; pdf_sanitize_filter_options sopts = { 0 }; pdf_filter_options filter = { 1, // recurse: true 0, // instance forms 0, // do not ascii-escape binary data 0, // no_update NULL, // end_page_opaque NULL, // end page list, // filters }; if (sanitize) { list[0].filter = pdf_new_sanitize_filter; list[0].options = &sopts; } #else pdf_filter_options filter = { NULL, // opaque NULL, // image filter NULL, // text filter NULL, // after text NULL, // end page 1, // recurse: true 1, // instance forms 1, // sanitize, 0 // do not ascii-escape binary data }; filter.sanitize = sanitize; #endif fz_try(gctx) { pdf_filter_annot_contents(gctx, pdf, annot, &filter); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // set annotation flags //---------------------------------------------------------------- PARENTCHECK(set_flags, """Set annotation flags.""") void set_flags(int flags) { pdf_annot *annot = (pdf_annot *) $self; pdf_set_annot_flags(gctx, annot, flags); } //---------------------------------------------------------------- // annotation delete responses //---------------------------------------------------------------- FITZEXCEPTION(delete_responses, !result) PARENTCHECK(delete_responses, """Delete 'Popup' and responding annotations.""") PyObject * delete_responses() { pdf_annot *annot = (pdf_annot *) $self; pdf_obj *annot_obj = pdf_annot_obj(gctx, annot); pdf_page *page = pdf_annot_page(gctx, annot); pdf_annot *irt_annot = NULL; fz_try(gctx) { while (1) { irt_annot = JM_find_annot_irt(gctx, annot); if (!irt_annot) break; pdf_delete_annot(gctx, page, irt_annot); } pdf_dict_del(gctx, annot_obj, PDF_NAME(Popup)); pdf_obj *annots = pdf_dict_get(gctx, page->obj, PDF_NAME(Annots)); int i, n = pdf_array_len(gctx, annots), found = 0; for (i = n - 1; i >= 0; i--) { pdf_obj *o = pdf_array_get(gctx, annots, i); pdf_obj *p = pdf_dict_get(gctx, o, PDF_NAME(Parent)); if (!p) continue; if (!pdf_objcmp(gctx, p, annot_obj)) { pdf_array_delete(gctx, annots, i); found = 1; } } if (found > 0) { pdf_dict_put(gctx, page->obj, PDF_NAME(Annots), annots); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // next annotation //---------------------------------------------------------------- PARENTCHECK(next, """Next annotation.""") %pythonappend next %{ if not val: return None val.thisown = True val.parent = self.parent # copy owning page object from previous annot val.parent._annot_refs[id(val)] = val if val.type[0] == PDF_ANNOT_WIDGET: widget = Widget() TOOLS._fill_widget(val, widget) val = widget %} %pythoncode %{@property%} struct Annot *next() { pdf_annot *this_annot = (pdf_annot *) $self; int type = pdf_annot_type(gctx, this_annot); pdf_annot *annot; if (type != PDF_ANNOT_WIDGET) { annot = pdf_next_annot(gctx, this_annot); } else { annot = pdf_next_widget(gctx, this_annot); } if (annot) pdf_keep_annot(gctx, annot); return (struct Annot *) annot; } //---------------------------------------------------------------- // annotation pixmap //---------------------------------------------------------------- FITZEXCEPTION(get_pixmap, !result) %pythonprepend get_pixmap %{"""annotation Pixmap""" CheckParent(self) cspaces = {"gray": csGRAY, "rgb": csRGB, "cmyk": csCMYK} if type(colorspace) is str: colorspace = cspaces.get(colorspace.lower(), None) if dpi: matrix = Matrix(dpi / 72, dpi / 72) %} %pythonappend get_pixmap %{ val.thisown = True if dpi: val.set_dpi(dpi, dpi) %} struct Pixmap * get_pixmap(PyObject *matrix = NULL, PyObject *dpi=NULL, struct Colorspace *colorspace = NULL, int alpha = 0) { fz_matrix ctm = JM_matrix_from_py(matrix); fz_colorspace *cs = (fz_colorspace *) colorspace; fz_pixmap *pix = NULL; if (!cs) { cs = fz_device_rgb(gctx); } fz_try(gctx) { pix = pdf_new_pixmap_from_annot(gctx, (pdf_annot *) $self, ctm, cs, NULL, alpha); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pix; } %pythoncode %{ def _erase(self): self.__swig_destroy__(self) self.parent = None def __str__(self): CheckParent(self) return "'%s' annotation on %s" % (self.type[1], str(self.parent)) def __repr__(self): CheckParent(self) return "'%s' annotation on %s" % (self.type[1], str(self.parent)) def __del__(self): if self.parent is None: return self._erase()%} } }; %clearnodefaultctor; //------------------------------------------------------------------------ // fz_link //------------------------------------------------------------------------ %nodefaultctor; struct Link { %immutable; %extend { ~Link() { DEBUGMSG1("Link"); fz_link *this_link = (fz_link *) $self; fz_drop_link(gctx, this_link); DEBUGMSG2; } PyObject *_border(struct Document *doc, int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) doc); if (!pdf) Py_RETURN_NONE; pdf_obj *link_obj = pdf_new_indirect(gctx, pdf, xref, 0); if (!link_obj) Py_RETURN_NONE; PyObject *b = JM_annot_border(gctx, link_obj); pdf_drop_obj(gctx, link_obj); return b; } PyObject *_setBorder(PyObject *border, struct Document *doc, int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) doc); if (!pdf) Py_RETURN_NONE; pdf_obj *link_obj = pdf_new_indirect(gctx, pdf, xref, 0); if (!link_obj) Py_RETURN_NONE; PyObject *b = JM_annot_set_border(gctx, border, pdf, link_obj); pdf_drop_obj(gctx, link_obj); return b; } FITZEXCEPTION(_colors, !result) PyObject *_colors(struct Document *doc, int xref) { pdf_document *pdf = pdf_specifics(gctx, (fz_document *) doc); if (!pdf) Py_RETURN_NONE; PyObject *b = NULL; pdf_obj *link_obj; fz_try(gctx) { link_obj = pdf_new_indirect(gctx, pdf, xref, 0); if (!link_obj) { RAISEPY(gctx, MSG_BAD_XREF, PyExc_ValueError); } b = JM_annot_colors(gctx, link_obj); } fz_always(gctx) { pdf_drop_obj(gctx, link_obj); } fz_catch(gctx) { return NULL; } return b; } %pythoncode %{ @property def border(self): return self._border(self.parent.parent.this, self.xref) @property def flags(self)->int: CheckParent(self) doc = self.parent.parent if not doc.is_pdf: return 0 f = doc.xref_get_key(self.xref, "F") if f[1] != "null": return int(f[1]) return 0 def set_flags(self, flags): CheckParent(self) doc = self.parent.parent if not doc.is_pdf: raise ValueError("is no PDF") if not type(flags) is int: raise ValueError("bad 'flags' value") doc.xref_set_key(self.xref, "F", str(flags)) return None def set_border(self, border=None, width=0, dashes=None, style=None): if type(border) is not dict: border = {"width": width, "style": style, "dashes": dashes} return self._setBorder(border, self.parent.parent.this, self.xref) @property def colors(self): return self._colors(self.parent.parent.this, self.xref) def set_colors(self, colors=None, stroke=None, fill=None): """Set border colors.""" CheckParent(self) doc = self.parent.parent if type(colors) is not dict: colors = {"fill": fill, "stroke": stroke} fill = colors.get("fill") stroke = colors.get("stroke") if fill is not None: print("warning: links have no fill color") if stroke in ([], ()): doc.xref_set_key(self.xref, "C", "[]") return if hasattr(stroke, "__float__"): stroke = [float(stroke)] CheckColor(stroke) if len(stroke) == 1: s = "[%g]" % stroke[0] elif len(stroke) == 3: s = "[%g %g %g]" % tuple(stroke) else: s = "[%g %g %g %g]" % tuple(stroke) doc.xref_set_key(self.xref, "C", s) %} %pythoncode %{@property%} PARENTCHECK(uri, """Uri string.""") PyObject *uri() { fz_link *this_link = (fz_link *) $self; return JM_UnicodeFromStr(this_link->uri); } %pythoncode %{@property%} PARENTCHECK(is_external, """Flag the link as external.""") PyObject *is_external() { fz_link *this_link = (fz_link *) $self; if (!this_link->uri) Py_RETURN_FALSE; return JM_BOOL(fz_is_external_link(gctx, this_link->uri)); } %pythoncode %{ page = -1 @property def dest(self): """Create link destination details.""" if hasattr(self, "parent") and self.parent is None: raise ValueError("orphaned object: parent is None") if self.parent.parent.is_closed or self.parent.parent.is_encrypted: raise ValueError("document closed or encrypted") doc = self.parent.parent if self.is_external or self.uri.startswith("#"): uri = None else: uri = doc.resolve_link(self.uri) return linkDest(self, uri) %} PARENTCHECK(rect, """Rectangle ('hot area').""") %pythoncode %{@property%} %pythonappend rect %{val = Rect(val)%} PyObject *rect() { fz_link *this_link = (fz_link *) $self; return JM_py_from_rect(this_link->rect); } //---------------------------------------------------------------- // next link //---------------------------------------------------------------- // we need to increase the link refs number // so that it will not be freed when the head is dropped PARENTCHECK(next, """Next link.""") %pythonappend next %{ if val: val.thisown = True val.parent = self.parent # copy owning page from prev link val.parent._annot_refs[id(val)] = val if self.xref > 0: # prev link has an xref link_xrefs = [x[0] for x in self.parent.annot_xrefs() if x[1] == PDF_ANNOT_LINK] link_ids = [x[2] for x in self.parent.annot_xrefs() if x[1] == PDF_ANNOT_LINK] idx = link_xrefs.index(self.xref) val.xref = link_xrefs[idx + 1] val.id = link_ids[idx + 1] else: val.xref = 0 val.id = "" %} %pythoncode %{@property%} struct Link *next() { fz_link *this_link = (fz_link *) $self; fz_link *next_link = this_link->next; if (!next_link) return NULL; next_link = fz_keep_link(gctx, next_link); return (struct Link *) next_link; } %pythoncode %{ def _erase(self): self.__swig_destroy__(self) self.parent = None def __str__(self): CheckParent(self) return "link on " + str(self.parent) def __repr__(self): CheckParent(self) return "link on " + str(self.parent) def __del__(self): self._erase()%} } }; %clearnodefaultctor; //------------------------------------------------------------------------ // fz_display_list //------------------------------------------------------------------------ struct DisplayList { %extend { ~DisplayList() { DEBUGMSG1("DisplayList"); fz_display_list *this_dl = (fz_display_list *) $self; fz_drop_display_list(gctx, this_dl); DEBUGMSG2; } FITZEXCEPTION(DisplayList, !result) DisplayList(PyObject *mediabox) { fz_display_list *dl = NULL; fz_try(gctx) { dl = fz_new_display_list(gctx, JM_rect_from_py(mediabox)); } fz_catch(gctx) { return NULL; } return (struct DisplayList *) dl; } FITZEXCEPTION(run, !result) PyObject *run(struct DeviceWrapper *dw, PyObject *m, PyObject *area) { fz_try(gctx) { fz_run_display_list(gctx, (fz_display_list *) $self, dw->device, JM_matrix_from_py(m), JM_rect_from_py(area), NULL); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------------------------------------- // DisplayList.rect //---------------------------------------------------------------- %pythoncode%{@property%} %pythonappend rect %{val = Rect(val)%} PyObject *rect() { return JM_py_from_rect(fz_bound_display_list(gctx, (fz_display_list *) $self)); } //---------------------------------------------------------------- // DisplayList.get_pixmap //---------------------------------------------------------------- FITZEXCEPTION(get_pixmap, !result) %pythonappend get_pixmap %{val.thisown = True%} struct Pixmap *get_pixmap(PyObject *matrix=NULL, struct Colorspace *colorspace=NULL, int alpha=0, PyObject *clip=NULL) { fz_colorspace *cs = NULL; fz_pixmap *pix = NULL; if (colorspace) cs = (fz_colorspace *) colorspace; else cs = fz_device_rgb(gctx); fz_try(gctx) { pix = JM_pixmap_from_display_list(gctx, (fz_display_list *) $self, matrix, cs, alpha, clip, NULL); } fz_catch(gctx) { return NULL; } return (struct Pixmap *) pix; } //---------------------------------------------------------------- // DisplayList.get_textpage //---------------------------------------------------------------- FITZEXCEPTION(get_textpage, !result) %pythonappend get_textpage %{val.thisown = True%} struct TextPage *get_textpage(int flags = 3) { fz_display_list *this_dl = (fz_display_list *) $self; fz_stext_page *tp = NULL; fz_try(gctx) { fz_stext_options stext_options = { 0 }; stext_options.flags = flags; tp = fz_new_stext_page_from_display_list(gctx, this_dl, &stext_options); } fz_catch(gctx) { return NULL; } return (struct TextPage *) tp; } %pythoncode %{ def __del__(self): if not type(self) is DisplayList: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // fz_stext_page //------------------------------------------------------------------------ struct TextPage { %extend { ~TextPage() { DEBUGMSG1("TextPage"); fz_stext_page *this_tp = (fz_stext_page *) $self; fz_drop_stext_page(gctx, this_tp); DEBUGMSG2; } FITZEXCEPTION(TextPage, !result) %pythonappend TextPage %{self.thisown=True%} TextPage(PyObject *mediabox) { fz_stext_page *tp = NULL; fz_try(gctx) { tp = fz_new_stext_page(gctx, JM_rect_from_py(mediabox)); } fz_catch(gctx) { return NULL; } return (struct TextPage *) tp; } //---------------------------------------------------------------- // method search() //---------------------------------------------------------------- FITZEXCEPTION(search, !result) %pythonprepend search %{"""Locate 'needle' returning rects or quads."""%} %pythonappend search %{ if not val: return val items = len(val) for i in range(items): # change entries to quads or rects q = Quad(val[i]) if quads: val[i] = q else: val[i] = q.rect if quads: return val i = 0 # join overlapping rects on the same line while i < items - 1: v1 = val[i] v2 = val[i + 1] if v1.y1 != v2.y1 or (v1 & v2).is_empty: i += 1 continue # no overlap on same line val[i] = v1 | v2 # join rectangles del val[i + 1] # remove v2 items -= 1 # reduce item count %} PyObject *search(const char *needle, int hit_max=0, int quads=1) { PyObject *liste = NULL; fz_try(gctx) { liste = JM_search_stext_page(gctx, (fz_stext_page *) $self, needle); } fz_catch(gctx) { return NULL; } return liste; } //---------------------------------------------------------------- // Get list of all blocks with block type and bbox as a Python list //---------------------------------------------------------------- FITZEXCEPTION(_getNewBlockList, !result) PyObject * _getNewBlockList(PyObject *page_dict, int raw) { fz_try(gctx) { JM_make_textpage_dict(gctx, (fz_stext_page *) $self, page_dict, raw); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def _textpage_dict(self, raw=False): page_dict = {"width": self.rect.width, "height": self.rect.height} self._getNewBlockList(page_dict, raw) return page_dict %} //---------------------------------------------------------------- // Get image meta information as a Python dictionary //---------------------------------------------------------------- FITZEXCEPTION(extractIMGINFO, !result) %pythonprepend extractIMGINFO %{"""Return a list with image meta information."""%} PyObject * extractIMGINFO(int hashes=0) { fz_stext_block *block; int block_n = -1; fz_stext_page *this_tpage = (fz_stext_page *) $self; PyObject *rc = NULL, *block_dict = NULL; fz_pixmap *pix = NULL; fz_try(gctx) { rc = PyList_New(0); for (block = this_tpage->first_block; block; block = block->next) { block_n++; if (block->type == FZ_STEXT_BLOCK_TEXT) { continue; } unsigned char digest[16]; fz_image *img = block->u.i.image; Py_ssize_t img_size = 0; fz_compressed_buffer *cbuff = fz_compressed_image_buffer(gctx, img); if (cbuff) { img_size = (Py_ssize_t) cbuff->buffer->len; } if (hashes) { pix = fz_get_pixmap_from_image(gctx, img, NULL, NULL, NULL, NULL); if (img_size == 0) { img_size = (Py_ssize_t) pix->w * pix->h * pix->n; } fz_md5_pixmap(gctx, pix, digest); fz_drop_pixmap(gctx, pix); pix = NULL; } fz_colorspace *cs = img->colorspace; block_dict = PyDict_New(); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); DICT_SETITEM_DROP(block_dict, dictkey_matrix, JM_py_from_matrix(block->u.i.transform)); DICT_SETITEM_DROP(block_dict, dictkey_width, Py_BuildValue("i", img->w)); DICT_SETITEM_DROP(block_dict, dictkey_height, Py_BuildValue("i", img->h)); DICT_SETITEM_DROP(block_dict, dictkey_colorspace, Py_BuildValue("i", fz_colorspace_n(gctx, cs))); DICT_SETITEM_DROP(block_dict, dictkey_cs_name, Py_BuildValue("s", fz_colorspace_name(gctx, cs))); DICT_SETITEM_DROP(block_dict, dictkey_xres, Py_BuildValue("i", img->xres)); DICT_SETITEM_DROP(block_dict, dictkey_yres, Py_BuildValue("i", img->xres)); DICT_SETITEM_DROP(block_dict, dictkey_bpc, Py_BuildValue("i", (int) img->bpc)); DICT_SETITEM_DROP(block_dict, dictkey_size, Py_BuildValue("n", img_size)); if (hashes) { DICT_SETITEMSTR_DROP(block_dict, "digest", PyBytes_FromStringAndSize(digest, 16)); } LIST_APPEND_DROP(rc, block_dict); } } fz_always(gctx) { } fz_catch(gctx) { Py_CLEAR(rc); Py_CLEAR(block_dict); fz_drop_pixmap(gctx, pix); return NULL; } return rc; } //---------------------------------------------------------------- // Get text blocks with their bbox and concatenated lines // as a Python list //---------------------------------------------------------------- FITZEXCEPTION(extractBLOCKS, !result) %pythonprepend extractBLOCKS %{"""Return a list with text block information."""%} PyObject * extractBLOCKS() { fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; int block_n = -1; PyObject *text = NULL, *litem; fz_buffer *res = NULL; fz_var(res); fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_rect tp_rect = this_tpage->mediabox; PyObject *lines = NULL; fz_try(gctx) { res = fz_new_buffer(gctx, 1024); lines = PyList_New(0); for (block = this_tpage->first_block; block; block = block->next) { block_n++; fz_rect blockrect = fz_empty_rect; if (block->type == FZ_STEXT_BLOCK_TEXT) { fz_clear_buffer(gctx, res); // set text buffer to empty int line_n = -1; int last_char = 0; for (line = block->u.t.first_line; line; line = line->next) { line_n++; fz_rect linerect = fz_empty_rect; for (ch = line->first_char; ch; ch = ch->next) { fz_rect cbbox = JM_char_bbox(gctx, line, ch); if (!JM_rects_overlap(tp_rect, cbbox) && !fz_is_infinite_rect(tp_rect)) { continue; } JM_append_rune(gctx, res, ch->c); last_char = ch->c; linerect = fz_union_rect(linerect, cbbox); } if (last_char != 10 && !fz_is_empty_rect(linerect)) { fz_append_byte(gctx, res, 10); } blockrect = fz_union_rect(blockrect, linerect); } text = JM_EscapeStrFromBuffer(gctx, res); } else if (JM_rects_overlap(tp_rect, block->bbox) || fz_is_infinite_rect(tp_rect)) { fz_image *img = block->u.i.image; fz_colorspace *cs = img->colorspace; text = PyUnicode_FromFormat("", fz_colorspace_name(gctx, cs), img->w, img->h, img->bpc); blockrect = fz_union_rect(blockrect, block->bbox); } if (!fz_is_empty_rect(blockrect)) { litem = PyTuple_New(7); PyTuple_SET_ITEM(litem, 0, Py_BuildValue("f", blockrect.x0)); PyTuple_SET_ITEM(litem, 1, Py_BuildValue("f", blockrect.y0)); PyTuple_SET_ITEM(litem, 2, Py_BuildValue("f", blockrect.x1)); PyTuple_SET_ITEM(litem, 3, Py_BuildValue("f", blockrect.y1)); PyTuple_SET_ITEM(litem, 4, Py_BuildValue("O", text)); PyTuple_SET_ITEM(litem, 5, Py_BuildValue("i", block_n)); PyTuple_SET_ITEM(litem, 6, Py_BuildValue("i", block->type)); LIST_APPEND_DROP(lines, litem); } Py_CLEAR(text); } } fz_always(gctx) { fz_drop_buffer(gctx, res); PyErr_Clear(); } fz_catch(gctx) { Py_CLEAR(lines); return NULL; } return lines; } //---------------------------------------------------------------- // Get text words with their bbox //---------------------------------------------------------------- FITZEXCEPTION(extractWORDS, !result) %pythonprepend extractWORDS %{"""Return a list with text word information."""%} PyObject * extractWORDS(PyObject *delimiters=NULL) { fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_buffer *buff = NULL; fz_var(buff); size_t buflen = 0; int block_n = -1, line_n, word_n; fz_rect wbbox = fz_empty_rect; // word bbox fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_rect tp_rect = this_tpage->mediabox; int word_delimiter = 0; PyObject *lines = NULL; fz_try(gctx) { buff = fz_new_buffer(gctx, 64); lines = PyList_New(0); for (block = this_tpage->first_block; block; block = block->next) { block_n++; if (block->type != FZ_STEXT_BLOCK_TEXT) { continue; } line_n = -1; for (line = block->u.t.first_line; line; line = line->next) { line_n++; word_n = 0; // word counter per line fz_clear_buffer(gctx, buff); // reset word buffer buflen = 0; // reset char counter for (ch = line->first_char; ch; ch = ch->next) { fz_rect cbbox = JM_char_bbox(gctx, line, ch); if (!JM_rects_overlap(tp_rect, cbbox) && !fz_is_infinite_rect(tp_rect)) { continue; } word_delimiter = JM_is_word_delimiter(ch->c, delimiters); if (word_delimiter) { if (buflen == 0) continue; // skip spaces at line start if (!fz_is_empty_rect(wbbox)) { // output word word_n = JM_append_word(gctx, lines, buff, &wbbox, block_n, line_n, word_n); } fz_clear_buffer(gctx, buff); buflen = 0; // reset char counter continue; } // append one unicode character to the word JM_append_rune(gctx, buff, ch->c); buflen++; // enlarge word bbox wbbox = fz_union_rect(wbbox, JM_char_bbox(gctx, line, ch)); } if (buflen && !fz_is_empty_rect(wbbox)) { word_n = JM_append_word(gctx, lines, buff, &wbbox, block_n, line_n, word_n); } fz_clear_buffer(gctx, buff); buflen = 0; } } } fz_always(gctx) { fz_drop_buffer(gctx, buff); PyErr_Clear(); } fz_catch(gctx) { return NULL; } return lines; } //---------------------------------------------------------------- // TextPage poolsize //---------------------------------------------------------------- %pythonprepend poolsize %{"""TextPage current poolsize."""%} PyObject *poolsize() { fz_stext_page *tpage = (fz_stext_page *) $self; size_t size = fz_pool_size(gctx, tpage->pool); return PyLong_FromSize_t(size); } //---------------------------------------------------------------- // TextPage rectangle //---------------------------------------------------------------- %pythoncode %{@property%} %pythonprepend rect %{"""TextPage rectangle."""%} %pythonappend rect %{val = Rect(val)%} PyObject *rect() { fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_rect mediabox = this_tpage->mediabox; return JM_py_from_rect(mediabox); } //---------------------------------------------------------------- // method _extractText() //---------------------------------------------------------------- FITZEXCEPTION(_extractText, !result) %newobject _extractText; PyObject *_extractText(int format) { fz_buffer *res = NULL; fz_output *out = NULL; PyObject *text = NULL; fz_var(res); fz_var(out); fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_try(gctx) { res = fz_new_buffer(gctx, 1024); out = fz_new_output_with_buffer(gctx, res); switch(format) { case(1): fz_print_stext_page_as_html(gctx, out, this_tpage, 0); break; case(3): fz_print_stext_page_as_xml(gctx, out, this_tpage, 0); break; case(4): fz_print_stext_page_as_xhtml(gctx, out, this_tpage, 0); break; default: JM_print_stext_page_as_text(gctx, res, this_tpage); break; } text = JM_EscapeStrFromBuffer(gctx, res); } fz_always(gctx) { fz_drop_buffer(gctx, res); fz_drop_output(gctx, out); } fz_catch(gctx) { return NULL; } return text; } //---------------------------------------------------------------- // method extractTextbox() //---------------------------------------------------------------- FITZEXCEPTION(extractTextbox, !result) PyObject *extractTextbox(PyObject *rect) { fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_rect area = JM_rect_from_py(rect); PyObject *rc = NULL; fz_try(gctx) { rc = JM_copy_rectangle(gctx, this_tpage, area); } fz_catch(gctx) { return NULL; } return rc; } //---------------------------------------------------------------- // method extractSelection() //---------------------------------------------------------------- PyObject *extractSelection(PyObject *pointa, PyObject *pointb) { fz_stext_page *this_tpage = (fz_stext_page *) $self; fz_point a = JM_point_from_py(pointa); fz_point b = JM_point_from_py(pointb); char *found = fz_copy_selection(gctx, this_tpage, a, b, 0); PyObject *rc = NULL; if (found) { rc = PyUnicode_FromString(found); JM_Free(found); } else { rc = EMPTY_STRING; } return rc; } %pythoncode %{ def extractText(self, sort=False) -> str: """Return simple, bare text on the page.""" if sort is False: return self._extractText(0) blocks = self.extractBLOCKS()[:] blocks.sort(key=lambda b: (b[3], b[0])) return "".join([b[4] for b in blocks]) def extractHTML(self) -> str: """Return page content as a HTML string.""" return self._extractText(1) def extractJSON(self, cb=None, sort=False) -> str: """Return 'extractDICT' converted to JSON format.""" import base64, json val = self._textpage_dict(raw=False) class b64encode(json.JSONEncoder): def default(self, s): if type(s) in (bytes, bytearray): return base64.b64encode(s).decode() if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort is True: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks val = json.dumps(val, separators=(",", ":"), cls=b64encode, indent=1) return val def extractRAWJSON(self, cb=None, sort=False) -> str: """Return 'extractRAWDICT' converted to JSON format.""" import base64, json val = self._textpage_dict(raw=True) class b64encode(json.JSONEncoder): def default(self,s): if type(s) in (bytes, bytearray): return base64.b64encode(s).decode() if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort is True: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks val = json.dumps(val, separators=(",", ":"), cls=b64encode, indent=1) return val def extractXML(self) -> str: """Return page content as a XML string.""" return self._extractText(3) def extractXHTML(self) -> str: """Return page content as a XHTML string.""" return self._extractText(4) def extractDICT(self, cb=None, sort=False) -> dict: """Return page content as a Python dict of images and text spans.""" val = self._textpage_dict(raw=False) if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort is True: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks return val def extractRAWDICT(self, cb=None, sort=False) -> dict: """Return page content as a Python dict of images and text characters.""" val = self._textpage_dict(raw=True) if cb is not None: val["width"] = cb.width val["height"] = cb.height if sort is True: blocks = val["blocks"] blocks.sort(key=lambda b: (b["bbox"][3], b["bbox"][0])) val["blocks"] = blocks return val def __del__(self): if not type(self) is TextPage: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // Graftmap - only used internally for inter-PDF object copy operations //------------------------------------------------------------------------ struct Graftmap { %extend { ~Graftmap() { DEBUGMSG1("Graftmap"); pdf_graft_map *this_gm = (pdf_graft_map *) $self; pdf_drop_graft_map(gctx, this_gm); DEBUGMSG2; } FITZEXCEPTION(Graftmap, !result) Graftmap(struct Document *doc) { pdf_graft_map *map = NULL; fz_try(gctx) { pdf_document *dst = pdf_specifics(gctx, (fz_document *) doc); ASSERT_PDF(dst); map = pdf_new_graft_map(gctx, dst); } fz_catch(gctx) { return NULL; } return (struct Graftmap *) map; } %pythoncode %{ def __del__(self): if not type(self) is Graftmap: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // TextWriter //------------------------------------------------------------------------ struct TextWriter { %extend { ~TextWriter() { DEBUGMSG1("TextWriter"); fz_text *this_tw = (fz_text *) $self; fz_drop_text(gctx, this_tw); DEBUGMSG2; } FITZEXCEPTION(TextWriter, !result) %pythonprepend TextWriter %{"""Stores text spans for later output on compatible PDF pages."""%} %pythonappend TextWriter %{ self.opacity = opacity self.color = color self.rect = Rect(page_rect) self.ctm = Matrix(1, 0, 0, -1, 0, self.rect.height) self.ictm = ~self.ctm self.last_point = Point() self.last_point.__doc__ = "Position following last text insertion." self.text_rect = Rect() self.text_rect.__doc__ = "Accumulated area of text spans." self.used_fonts = set() self.thisown = True %} TextWriter(PyObject *page_rect, float opacity=1, PyObject *color=NULL ) { fz_text *text = NULL; fz_try(gctx) { text = fz_new_text(gctx); } fz_catch(gctx) { return NULL; } return (struct TextWriter *) text; } FITZEXCEPTION(append, !result) %pythonprepend append %{ """Store 'text' at point 'pos' using 'font' and 'fontsize'.""" pos = Point(pos) * self.ictm if font is None: font = Font("helv") if not font.is_writable: raise ValueError("Unsupported font '%s'." % font.name) if right_to_left: text = self.clean_rtl(text) text = "".join(reversed(text)) right_to_left = 0 %} %pythonappend append %{ self.last_point = Point(val[-2:]) * self.ctm self.text_rect = self._bbox * self.ctm val = self.text_rect, self.last_point if font.flags["mono"] == 1: self.used_fonts.add(font) %} PyObject * append(PyObject *pos, char *text, struct Font *font=NULL, float fontsize=11, char *language=NULL, int right_to_left=0, int small_caps=0) { fz_text_language lang = fz_text_language_from_string(language); fz_point p = JM_point_from_py(pos); fz_matrix trm = fz_make_matrix(fontsize, 0, 0, fontsize, p.x, p.y); int markup_dir = 0, wmode = 0; fz_try(gctx) { if (small_caps == 0) { trm = fz_show_string(gctx, (fz_text *) $self, (fz_font *) font, trm, text, wmode, right_to_left, markup_dir, lang); } else { trm = JM_show_string_cs(gctx, (fz_text *) $self, (fz_font *) font, trm, text, wmode, right_to_left, markup_dir, lang); } } fz_catch(gctx) { return NULL; } return JM_py_from_matrix(trm); } %pythoncode %{ def appendv(self, pos, text, font=None, fontsize=11, language=None, small_caps=False): """Append text in vertical write mode.""" lheight = fontsize * 1.2 for c in text: self.append(pos, c, font=font, fontsize=fontsize, language=language, small_caps=small_caps) pos.y += lheight return self.text_rect, self.last_point def clean_rtl(self, text): """Revert the sequence of Latin text parts. Text with right-to-left writing direction (Arabic, Hebrew) often contains Latin parts, which are written in left-to-right: numbers, names, etc. For output as PDF text we need *everything* in right-to-left. E.g. an input like " ABCDE FG HIJ KL " will be converted to " JIH GF EDCBA LK ". The Arabic parts remain untouched. Args: text: str Returns: Massaged string. """ if not text: return text # split into words at space boundaries words = text.split(" ") idx = [] for i in range(len(words)): w = words[i] # revert character sequence for Latin only words if not (len(w) < 2 or max([ord(c) for c in w]) > 255): words[i] = "".join(reversed(w)) idx.append(i) # stored index of Latin word # adjacent Latin words must revert their sequence, too idx2 = [] # store indices of adjacent Latin words for i in range(len(idx)): if idx2 == []: # empty yet? idx2.append(idx[i]) # store Latin word number elif idx[i] > idx2[-1] + 1: # large gap to last? if len(idx2) > 1: # at least two consecutives? words[idx2[0] : idx2[-1] + 1] = reversed( words[idx2[0] : idx2[-1] + 1] ) # revert their sequence idx2 = [idx[i]] # re-initialize elif idx[i] == idx2[-1] + 1: # new adjacent Latin word idx2.append(idx[i]) text = " ".join(words) return text %} %pythoncode %{@property%} %pythonappend _bbox%{val = Rect(val)%} PyObject *_bbox() { return JM_py_from_rect(fz_bound_text(gctx, (fz_text *) $self, NULL, fz_identity)); } FITZEXCEPTION(write_text, !result) %pythonprepend write_text%{ """Write the text to a PDF page having the TextWriter's page size. Args: page: a PDF page having same size. color: override text color. opacity: override transparency. overlay: put in foreground or background. morph: tuple(Point, Matrix), apply a matrix with a fixpoint. matrix: Matrix to be used instead of 'morph' argument. render_mode: (int) PDF render mode operator 'Tr'. """ CheckParent(page) if abs(self.rect - page.rect) > 1e-3: raise ValueError("incompatible page rect") if morph != None: if (type(morph) not in (tuple, list) or type(morph[0]) is not Point or type(morph[1]) is not Matrix ): raise ValueError("morph must be (Point, Matrix) or None") if matrix != None and morph != None: raise ValueError("only one of matrix, morph is allowed") if getattr(opacity, "__float__", None) is None or opacity == -1: opacity = self.opacity if color is None: color = self.color %} %pythonappend write_text%{ max_nums = val[0] content = val[1] max_alp, max_font = max_nums old_cont_lines = content.splitlines() optcont = page._get_optional_content(oc) if optcont != None: bdc = "/OC /%s BDC" % optcont emc = "EMC" else: bdc = emc = "" new_cont_lines = ["q"] if bdc: new_cont_lines.append(bdc) cb = page.cropbox_position if page.rotation in (90, 270): delta = page.rect.height - page.rect.width else: delta = 0 mb = page.mediabox if bool(cb) or mb.y0 != 0 or delta != 0: new_cont_lines.append("1 0 0 1 %g %g cm" % (cb.x, cb.y + mb.y0 - delta)) if morph: p = morph[0] * self.ictm delta = Matrix(1, 1).pretranslate(p.x, p.y) matrix = ~delta * morph[1] * delta if morph or matrix: new_cont_lines.append("%g %g %g %g %g %g cm" % JM_TUPLE(matrix)) for line in old_cont_lines: if line.endswith(" cm"): continue if line == "BT": new_cont_lines.append(line) new_cont_lines.append("%i Tr" % render_mode) continue if line.endswith(" gs"): alp = int(line.split()[0][4:]) + max_alp line = "/Alp%i gs" % alp elif line.endswith(" Tf"): temp = line.split() fsize = float(temp[1]) if render_mode != 0: w = fsize * 0.05 else: w = 1 new_cont_lines.append("%g w" % w) font = int(temp[0][2:]) + max_font line = " ".join(["/F%i" % font] + temp[1:]) elif line.endswith(" rg"): new_cont_lines.append(line.replace("rg", "RG")) elif line.endswith(" g"): new_cont_lines.append(line.replace(" g", " G")) elif line.endswith(" k"): new_cont_lines.append(line.replace(" k", " K")) new_cont_lines.append(line) if emc: new_cont_lines.append(emc) new_cont_lines.append("Q\n") content = "\n".join(new_cont_lines).encode("utf-8") TOOLS._insert_contents(page, content, overlay=overlay) val = None for font in self.used_fonts: repair_mono_font(page, font) %} PyObject *write_text(struct Page *page, PyObject *color=NULL, float opacity=-1, int overlay=1, PyObject *morph=NULL, PyObject *matrix=NULL, int render_mode=0, int oc=0) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) page); pdf_obj *resources = NULL; fz_buffer *contents = NULL; fz_device *dev = NULL; PyObject *result = NULL, *max_nums, *cont_string; float alpha = 1; if (opacity >= 0 && opacity < 1) alpha = opacity; fz_colorspace *colorspace; int ncol = 1; float dev_color[4] = {0, 0, 0, 0}; if (EXISTS(color)) { JM_color_FromSequence(color, &ncol, dev_color); } switch(ncol) { case 3: colorspace = fz_device_rgb(gctx); break; case 4: colorspace = fz_device_cmyk(gctx); break; default: colorspace = fz_device_gray(gctx); break; } fz_var(contents); fz_var(resources); fz_var(dev); fz_try(gctx) { ASSERT_PDF(pdfpage); resources = pdf_new_dict(gctx, pdfpage->doc, 5); contents = fz_new_buffer(gctx, 1024); dev = pdf_new_pdf_device(gctx, pdfpage->doc, fz_identity, resources, contents); fz_fill_text(gctx, dev, (fz_text *) $self, fz_identity, colorspace, dev_color, alpha, fz_default_color_params); fz_close_device(gctx, dev); // copy generated resources into the one of the page max_nums = JM_merge_resources(gctx, pdfpage, resources); cont_string = JM_EscapeStrFromBuffer(gctx, contents); result = Py_BuildValue("OO", max_nums, cont_string); Py_DECREF(cont_string); Py_DECREF(max_nums); } fz_always(gctx) { fz_drop_buffer(gctx, contents); pdf_drop_obj(gctx, resources); fz_drop_device(gctx, dev); } fz_catch(gctx) { return NULL; } return result; } %pythoncode %{ def __del__(self): if not type(self) is TextWriter: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // Font //------------------------------------------------------------------------ struct Font { %extend { ~Font() { DEBUGMSG1("Font"); fz_font *this_font = (fz_font *) $self; fz_drop_font(gctx, this_font); DEBUGMSG2; } FITZEXCEPTION(Font, !result) %pythonprepend Font %{ if fontbuffer: if hasattr(fontbuffer, "getvalue"): fontbuffer = fontbuffer.getvalue() elif isinstance(fontbuffer, bytearray): fontbuffer = bytes(fontbuffer) if not isinstance(fontbuffer, bytes): raise ValueError("bad type: 'fontbuffer'") if isinstance(fontname, str): fname_lower = fontname.lower() if "/" in fname_lower or "\\" in fname_lower or "." in fname_lower: print("Warning: did you mean a fontfile?") if fname_lower in ("cjk", "china-t", "china-ts"): ordering = 0 elif fname_lower.startswith("china-s"): ordering = 1 elif fname_lower.startswith("korea"): ordering = 3 elif fname_lower.startswith("japan"): ordering = 2 elif fname_lower in fitz_fontdescriptors.keys(): import pymupdf_fonts # optional fonts fontbuffer = pymupdf_fonts.myfont(fname_lower) # make a copy fontname = None # ensure using fontbuffer only del pymupdf_fonts # remove package again elif ordering < 0: fontname = Base14_fontdict.get(fontname, fontname) %} %pythonappend Font %{self.thisown = True%} Font(char *fontname=NULL, char *fontfile=NULL, PyObject *fontbuffer=NULL, int script=0, char *language=NULL, int ordering=-1, int is_bold=0, int is_italic=0, int is_serif=0, int embed=1) { fz_font *font = NULL; fz_try(gctx) { fz_text_language lang = fz_text_language_from_string(language); font = JM_get_font(gctx, fontname, fontfile, fontbuffer, script, lang, ordering, is_bold, is_italic, is_serif, embed); } fz_catch(gctx) { return NULL; } return (struct Font *) font; } %pythonprepend glyph_advance %{"""Return the glyph width of a unicode (font size 1)."""%} PyObject *glyph_advance(int chr, char *language=NULL, int script=0, int wmode=0, int small_caps=0) { fz_font *font, *thisfont = (fz_font *) $self; int gid; fz_text_language lang = fz_text_language_from_string(language); if (small_caps) { gid = fz_encode_character_sc(gctx, thisfont, chr); if (gid >= 0) font = thisfont; } else { gid = fz_encode_character_with_fallback(gctx, thisfont, chr, script, lang, &font); } return PyFloat_FromDouble((double) fz_advance_glyph(gctx, font, gid, wmode)); } FITZEXCEPTION(text_length, !result) %pythonprepend text_length %{"""Return length of unicode 'text' under a fontsize."""%} PyObject *text_length(PyObject *text, double fontsize=11, char *language=NULL, int script=0, int wmode=0, int small_caps=0) { fz_font *font=NULL, *thisfont = (fz_font *) $self; fz_text_language lang = fz_text_language_from_string(language); double rc = 0; int gid; fz_try(gctx) { if (!PyUnicode_Check(text) || PyUnicode_READY(text) != 0) { RAISEPY(gctx, MSG_BAD_TEXT, PyExc_TypeError); } Py_ssize_t i, len = PyUnicode_GET_LENGTH(text); int kind = PyUnicode_KIND(text); void *data = PyUnicode_DATA(text); for (i = 0; i < len; i++) { int c = PyUnicode_READ(kind, data, i); if (small_caps) { gid = fz_encode_character_sc(gctx, thisfont, c); if (gid >= 0) font = thisfont; } else { gid = fz_encode_character_with_fallback(gctx,thisfont, c, script, lang, &font); } rc += (double) fz_advance_glyph(gctx, font, gid, wmode); } } fz_catch(gctx) { PyErr_Clear(); return NULL; } rc *= fontsize; return PyFloat_FromDouble(rc); } FITZEXCEPTION(char_lengths, !result) %pythonprepend char_lengths %{"""Return tuple of char lengths of unicode 'text' under a fontsize."""%} PyObject *char_lengths(PyObject *text, double fontsize=11, char *language=NULL, int script=0, int wmode=0, int small_caps=0) { fz_font *font, *thisfont = (fz_font *) $self; fz_text_language lang = fz_text_language_from_string(language); PyObject *rc = NULL; int gid; fz_try(gctx) { if (!PyUnicode_Check(text) || PyUnicode_READY(text) != 0) { RAISEPY(gctx, MSG_BAD_TEXT, PyExc_TypeError); } Py_ssize_t i, len = PyUnicode_GET_LENGTH(text); int kind = PyUnicode_KIND(text); void *data = PyUnicode_DATA(text); rc = PyTuple_New(len); for (i = 0; i < len; i++) { int c = PyUnicode_READ(kind, data, i); if (small_caps) { gid = fz_encode_character_sc(gctx, thisfont, c); if (gid >= 0) font = thisfont; } else { gid = fz_encode_character_with_fallback(gctx,thisfont, c, script, lang, &font); } PyTuple_SET_ITEM(rc, i, PyFloat_FromDouble(fontsize * (double) fz_advance_glyph(gctx, font, gid, wmode))); } } fz_catch(gctx) { PyErr_Clear(); Py_CLEAR(rc); return NULL; } return rc; } %pythonprepend glyph_bbox %{"""Return the glyph bbox of a unicode (font size 1)."""%} %pythonappend glyph_bbox %{val = Rect(val)%} PyObject *glyph_bbox(int chr, char *language=NULL, int script=0, int small_caps=0) { fz_font *font, *thisfont = (fz_font *) $self; int gid; fz_text_language lang = fz_text_language_from_string(language); if (small_caps) { gid = fz_encode_character_sc(gctx, thisfont, chr); if (gid >= 0) font = thisfont; } else { gid = fz_encode_character_with_fallback(gctx, thisfont, chr, script, lang, &font); } return JM_py_from_rect(fz_bound_glyph(gctx, font, gid, fz_identity)); } %pythonprepend has_glyph %{"""Check whether font has a glyph for this unicode."""%} PyObject *has_glyph(int chr, char *language=NULL, int script=0, int fallback=0, int small_caps=0) { fz_font *font, *thisfont = (fz_font *) $self; fz_text_language lang; int gid = 0; if (fallback) { lang = fz_text_language_from_string(language); gid = fz_encode_character_with_fallback(gctx, (fz_font *) $self, chr, script, lang, &font); } else { if (!small_caps) { gid = fz_encode_character(gctx, thisfont, chr); } else { gid = fz_encode_character_sc(gctx, thisfont, chr); } } return Py_BuildValue("i", gid); } %pythoncode %{ def valid_codepoints(self): from array import array gc = self.glyph_count cp = array("l", (0,) * gc) arr = cp.buffer_info() self._valid_unicodes(arr) return array("l", sorted(set(cp))[1:]) %} void _valid_unicodes(PyObject *arr) { fz_font *font = (fz_font *) $self; PyObject *temp = PySequence_ITEM(arr, 0); void *ptr = PyLong_AsVoidPtr(temp); JM_valid_chars(gctx, font, ptr); Py_DECREF(temp); } %pythoncode %{@property%} PyObject *flags() { fz_font_flags_t *f = fz_font_flags((fz_font *) $self); if (!f) Py_RETURN_NONE; return Py_BuildValue( "{s:N,s:N,s:N,s:N,s:N,s:N,s:N,s:N,s:N,s:N,s:N,s:N" #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 ",s:N,s:N" #endif "}", "mono", JM_BOOL(f->is_mono), "serif", JM_BOOL(f->is_serif), "bold", JM_BOOL(f->is_bold), "italic", JM_BOOL(f->is_italic), "substitute", JM_BOOL(f->ft_substitute), "stretch", JM_BOOL(f->ft_stretch), "fake-bold", JM_BOOL(f->fake_bold), "fake-italic", JM_BOOL(f->fake_italic), "opentype", JM_BOOL(f->has_opentype), "invalid-bbox", JM_BOOL(f->invalid_bbox), "cjk", JM_BOOL(f->cjk), "cjk-lang", (f->cjk ? PyLong_FromUnsignedLong((unsigned long) f->cjk_lang) : Py_BuildValue("s",NULL)) #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 , "embed", JM_BOOL(f->embed), "never-embed", JM_BOOL(f->never_embed) #endif ); } %pythoncode %{@property%} PyObject *is_bold() { fz_font *font = (fz_font *) $self; if (fz_font_is_bold(gctx,font)) { Py_RETURN_TRUE; } Py_RETURN_FALSE; } %pythoncode %{@property%} PyObject *is_serif() { fz_font *font = (fz_font *) $self; if (fz_font_is_serif(gctx,font)) { Py_RETURN_TRUE; } Py_RETURN_FALSE; } %pythoncode %{@property%} PyObject *is_italic() { fz_font *font = (fz_font *) $self; if (fz_font_is_italic(gctx,font)) { Py_RETURN_TRUE; } Py_RETURN_FALSE; } %pythoncode %{@property%} PyObject *is_monospaced() { fz_font *font = (fz_font *) $self; if (fz_font_is_monospaced(gctx,font)) { Py_RETURN_TRUE; } Py_RETURN_FALSE; } /* temporarily disabled * PyObject *is_writable() * { * fz_font *font = (fz_font *) $self; * if (fz_font_t3_procs(gctx, font) || * fz_font_flags(font)->ft_substitute || * !pdf_font_writing_supported(font)) { * Py_RETURN_FALSE; * } * Py_RETURN_TRUE; * } */ %pythoncode %{@property%} PyObject *name() { return JM_UnicodeFromStr(fz_font_name(gctx, (fz_font *) $self)); } %pythoncode %{@property%} int glyph_count() { fz_font *this_font = (fz_font *) $self; return this_font->glyph_count; } %pythoncode %{@property%} PyObject *buffer() { fz_font *this_font = (fz_font *) $self; unsigned char *data = NULL; size_t len = fz_buffer_storage(gctx, this_font->buffer, &data); return JM_BinFromCharSize(data, len); } %pythoncode %{@property%} %pythonappend bbox%{val = Rect(val)%} PyObject *bbox() { fz_font *this_font = (fz_font *) $self; return JM_py_from_rect(fz_font_bbox(gctx, this_font)); } %pythoncode %{@property%} %pythonprepend ascender %{"""Return the glyph ascender value."""%} float ascender() { return fz_font_ascender(gctx, (fz_font *) $self); } %pythoncode %{@property%} %pythonprepend descender %{"""Return the glyph descender value."""%} float descender() { return fz_font_descender(gctx, (fz_font *) $self); } %pythoncode %{ @property def is_writable(self): return True def glyph_name_to_unicode(self, name): """Return the unicode for a glyph name.""" return glyph_name_to_unicode(name) def unicode_to_glyph_name(self, ch): """Return the glyph name for a unicode.""" return unicode_to_glyph_name(ch) def __repr__(self): return "Font('%s')" % self.name def __del__(self): if not type(self) is Font: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // DocumentWriter //------------------------------------------------------------------------ struct DocumentWriter { %extend { ~DocumentWriter() { // need this structure to free any fz_output the writer may have typedef struct { // copied from pdf_write.c fz_document_writer super; pdf_document *pdf; pdf_write_options opts; fz_output *out; fz_rect mediabox; pdf_obj *resources; fz_buffer *contents; } pdf_writer; fz_document_writer *writer_fz = (fz_document_writer *) $self; fz_output *out = NULL; pdf_writer *writer_pdf = (pdf_writer *) writer_fz; if (writer_pdf) { out = writer_pdf->out; if (out) { DEBUGMSG1("Output of DocumentWriter"); fz_drop_output(gctx, out); writer_pdf->out = NULL; DEBUGMSG2; } } DEBUGMSG1("DocumentWriter"); fz_drop_document_writer( gctx, writer_fz); DEBUGMSG2; } FITZEXCEPTION(DocumentWriter, !result) %pythonprepend DocumentWriter %{ if type(path) is str: pass elif hasattr(path, "absolute"): path = str(path) elif hasattr(path, "name"): path = path.name if options==None: options="" %} %pythonappend DocumentWriter %{ %} DocumentWriter( PyObject* path, const char* options=NULL) { fz_output *out = NULL; fz_document_writer* ret=NULL; fz_try(gctx) { if (PyUnicode_Check(path)) { ret = fz_new_pdf_writer( gctx, PyUnicode_AsUTF8(path), options); } else { out = JM_new_output_fileptr(gctx, path); ret = fz_new_pdf_writer_with_output(gctx, out, options); } } fz_catch(gctx) { return NULL; } return (struct DocumentWriter*) ret; } struct DeviceWrapper* begin_page( PyObject* mediabox) { fz_rect mediabox2 = JM_rect_from_py(mediabox); fz_device* device = fz_begin_page( gctx, (fz_document_writer*) $self, mediabox2); struct DeviceWrapper* device_wrapper = (struct DeviceWrapper*) calloc(1, sizeof(struct DeviceWrapper)) ; device_wrapper->device = device; device_wrapper->list = NULL; return device_wrapper; } void end_page() { fz_end_page( gctx, (fz_document_writer*) $self); } void close() { fz_document_writer *writer = (fz_document_writer*) $self; fz_close_document_writer( gctx, writer); } %pythoncode %{ def __del__(self): if not type(self) is DocumentWriter: return if getattr(self, "thisown", False): self.__swig_destroy__(self) def __enter__(self): return self def __exit__(self, *args): self.close() %} } }; //------------------------------------------------------------------------ // Archive //------------------------------------------------------------------------ struct Archive { %extend { ~Archive() { DEBUGMSG1("Archive"); fz_drop_archive( gctx, (fz_archive *) $self); DEBUGMSG2; } FITZEXCEPTION(Archive, !result) %pythonprepend Archive %{ self._subarchives = [] %} %pythonappend Archive %{ self.thisown = True if args != (): self.add(*args) %} //--------------------------------------- // new empty archive //--------------------------------------- Archive(struct Archive *a0=NULL, const char *path=NULL) { fz_archive *arch=NULL; fz_try(gctx) { arch = fz_new_multi_archive(gctx); } fz_catch(gctx) { return NULL; } return (struct Archive *) arch; } Archive(PyObject *a0=NULL, const char *path=NULL) { fz_archive *arch=NULL; fz_try(gctx) { arch = fz_new_multi_archive(gctx); } fz_catch(gctx) { return NULL; } return (struct Archive *) arch; } FITZEXCEPTION(has_entry, !result) PyObject *has_entry(const char *name) { fz_archive *arch = (fz_archive *) $self; int ret = 0; fz_try(gctx) { ret = fz_has_archive_entry(gctx, arch, name); } fz_catch(gctx) { return NULL; } return JM_BOOL(ret); } FITZEXCEPTION(read_entry, !result) PyObject *read_entry(const char *name) { fz_archive *arch = (fz_archive *) $self; PyObject *ret = NULL; fz_buffer *buff = NULL; fz_try(gctx) { buff = fz_read_archive_entry(gctx, arch, name); ret = JM_BinFromBuffer(gctx, buff); } fz_always(gctx) { fz_drop_buffer(gctx, buff); } fz_catch(gctx) { return NULL; } return ret; } //-------------------------------------- // add dir //-------------------------------------- FITZEXCEPTION(_add_dir, !result) PyObject *_add_dir(const char *folder, const char *path=NULL) { fz_archive *arch = (fz_archive *) $self; fz_archive *sub = NULL; fz_try(gctx) { sub = fz_open_directory(gctx, folder); fz_mount_multi_archive(gctx, arch, sub, path); } fz_always(gctx) { fz_drop_archive(gctx, sub); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------- // add archive //---------------------------------- FITZEXCEPTION(_add_arch, !result) PyObject *_add_arch(struct Archive *subarch, const char *path=NULL) { fz_archive *arch = (fz_archive *) $self; fz_archive *sub = (fz_archive *) subarch; fz_try(gctx) { fz_mount_multi_archive(gctx, arch, sub, path); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------- // add ZIP/TAR from file //---------------------------------- FITZEXCEPTION(_add_ziptarfile, !result) PyObject *_add_ziptarfile(const char *filepath, int type, const char *path=NULL) { fz_archive *arch = (fz_archive *) $self; fz_archive *sub = NULL; fz_try(gctx) { if (type==1) { sub = fz_open_zip_archive(gctx, filepath); } else { sub = fz_open_tar_archive(gctx, filepath); } fz_mount_multi_archive(gctx, arch, sub, path); } fz_always(gctx) { fz_drop_archive(gctx, sub); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------- // add ZIP/TAR from memory //---------------------------------- FITZEXCEPTION(_add_ziptarmemory, !result) PyObject *_add_ziptarmemory(PyObject *memory, int type, const char *path=NULL) { fz_archive *arch = (fz_archive *) $self; fz_archive *sub = NULL; fz_stream *stream = NULL; fz_buffer *buff = NULL; fz_try(gctx) { buff = JM_BufferFromBytes(gctx, memory); stream = fz_open_buffer(gctx, buff); if (type==1) { sub = fz_open_zip_archive_with_stream(gctx, stream); } else { sub = fz_open_tar_archive_with_stream(gctx, stream); } fz_mount_multi_archive(gctx, arch, sub, path); } fz_always(gctx) { fz_drop_stream(gctx, stream); fz_drop_buffer(gctx, buff); fz_drop_archive(gctx, sub); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } //---------------------------------- // add "tree" item //---------------------------------- FITZEXCEPTION(_add_treeitem, !result) PyObject *_add_treeitem(PyObject *memory, const char *name, const char *path=NULL) { fz_archive *arch = (fz_archive *) $self; fz_archive *sub = NULL; fz_buffer *buff = NULL; int drop_sub = 0; fz_try(gctx) { buff = JM_BufferFromBytes(gctx, memory); sub = JM_last_tree(gctx, arch, path); if (!sub) { sub = fz_new_tree_archive(gctx, NULL); drop_sub = 1; } fz_tree_archive_add_buffer(gctx, sub, name, buff); if (drop_sub) { fz_mount_multi_archive(gctx, arch, sub, path); } } fz_always(gctx) { fz_drop_buffer(gctx, buff); if (drop_sub) { fz_drop_archive(gctx, sub); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def add(self, content, path=None): """Add a sub-archive. Args: content: content to be added. May be one of Archive, folder name, file name, raw bytes (bytes, bytearray), zipfile, tarfile, or a sequence of any of these types. path: (str) a "virtual" path name, under which the elements of content can be retrieved. Use it to e.g. cope with duplicate element names. """ bin_ok = lambda x: isinstance(x, (bytes, bytearray, io.BytesIO)) entries = [] mount = None fmt = None def make_subarch(): subarch = {"fmt": fmt, "entries": entries, "path": mount} if fmt != "tree" or self._subarchives == []: self._subarchives.append(subarch) else: ltree = self._subarchives[-1] if ltree["fmt"] != "tree" or ltree["path"] != subarch["path"]: self._subarchives.append(subarch) else: ltree["entries"].extend(subarch["entries"]) self._subarchives[-1] = ltree return if isinstance(content, zipfile.ZipFile): fmt = "zip" entries = content.namelist() mount = path filename = getattr(content, "filename", None) fp = getattr(content, "fp", None) if filename: self._add_ziptarfile(filename, 1, path) else: self._add_ziptarmemory(fp.getvalue(), 1, path) return make_subarch() if isinstance(content, tarfile.TarFile): fmt = "tar" entries = content.getnames() mount = path filename = getattr(content.fileobj, "name", None) fp = content.fileobj if not isinstance(fp, io.BytesIO) and not filename: fp = fp.fileobj if filename: self._add_ziptarfile(filename, 0, path) else: self._add_ziptarmemory(fp.getvalue(), 0, path) return make_subarch() if isinstance(content, Archive): fmt = "multi" mount = path self._add_arch(content, path) return make_subarch() if bin_ok(content): if not (path and type(path) is str): raise ValueError("need name for binary content") fmt = "tree" mount = None entries = [path] self._add_treeitem(content, path) return make_subarch() if hasattr(content, "name"): content = content.name elif isinstance(content, pathlib.Path): content = str(content) if os.path.isdir(str(content)): a0 = str(content) fmt = "dir" mount = path entries = os.listdir(a0) self._add_dir(a0, path) return make_subarch() if os.path.isfile(str(content)): if not (path and type(path) is str): raise ValueError("need name for binary content") a0 = str(content) _ = open(a0, "rb") ff = _.read() _.close() fmt = "tree" mount = None entries = [path] self._add_treeitem(ff, path) return make_subarch() if type(content) is str or not getattr(content, "__getitem__", None): raise ValueError("bad archive content") #---------------------------------------- # handling sequence types here #---------------------------------------- if len(content) == 2: # covers the tree item plus path data, name = content if bin_ok(data) or os.path.isfile(str(data)): if not type(name) is str: raise ValueError(f"bad item name {name}") mount = path fmt = "tree" if bin_ok(data): self._add_treeitem(data, name, path=mount) else: _ = open(str(data), "rb") ff = _.read() _.close() seld._add_treeitem(ff, name, path=mount) entries = [name] return make_subarch() # deal with sequence of disparate items for item in content: self.add(item, path) __doc__ = """Archive(dirname [, path]) - from folder Archive(file [, path]) - from file name or object Archive(data, name) - from memory item Archive() - empty archive Archive(archive [, path]) - from archive """ @property def entry_list(self): """List of sub archives.""" return self._subarchives def __repr__(self): return f"Archive, sub-archives: {len(self._subarchives)}" def __del__(self): if not type(self) is Archive: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // Xml //------------------------------------------------------------------------ struct Xml { %extend { ~Xml() { DEBUGMSG1("Xml"); fz_drop_xml( gctx, (fz_xml*) $self); DEBUGMSG2; } FITZEXCEPTION(Xml, !result) Xml(fz_xml* xml) { fz_keep_xml( gctx, xml); return (struct Xml*) xml; } Xml(const char *html) { fz_buffer *buff = NULL; fz_xml *ret = NULL; fz_try(gctx) { buff = fz_new_buffer_from_copied_data(gctx, html, strlen(html)+1); ret = fz_parse_xml_from_html5(gctx, buff); } fz_always(gctx) { fz_drop_buffer(gctx, buff); } fz_catch(gctx) { return NULL; } fz_keep_xml(gctx, ret); return (struct Xml*) ret; } %pythoncode %{@property%} FITZEXCEPTION (root, !result) struct Xml* root() { fz_xml* ret = NULL; fz_try(gctx) { ret = fz_xml_root((fz_xml_doc *) $self); } fz_catch(gctx) { return NULL; } return (struct Xml*) ret; } FITZEXCEPTION (bodytag, !result) struct Xml* bodytag() { fz_xml* ret = NULL; fz_try(gctx) { ret = fz_keep_xml( gctx, fz_dom_body( gctx, (fz_xml *) $self)); } fz_catch(gctx) { return NULL; } return (struct Xml*) ret; } FITZEXCEPTION (append_child, !result) PyObject *append_child( struct Xml* child) { fz_try(gctx) { fz_dom_append_child( gctx, (fz_xml *) $self, (fz_xml *) child); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION (create_text_node, !result) struct Xml* create_text_node( const char *text) { fz_xml* ret = NULL; fz_try(gctx) { ret = fz_dom_create_text_node( gctx,(fz_xml *) $self, text); } fz_catch(gctx) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } FITZEXCEPTION (create_element, !result) struct Xml* create_element( const char *tag) { fz_xml* ret = NULL; fz_try(gctx) { ret = fz_dom_create_element( gctx, (fz_xml *)$self, tag); } fz_catch(gctx) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } struct Xml *find(const char *tag, const char *att, const char *match) { fz_xml* ret=NULL; ret = fz_dom_find( gctx, (fz_xml *)$self, tag, att, match); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } struct Xml *find_next( const char *tag, const char *att, const char *match) { fz_xml* ret=NULL; ret = fz_dom_find_next( gctx, (fz_xml *)$self, tag, att, match); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } %pythoncode %{@property%} struct Xml *next() { fz_xml* ret=NULL; ret = fz_dom_next( gctx, (fz_xml *)$self); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } %pythoncode %{@property%} struct Xml *previous() { fz_xml* ret=NULL; ret = fz_dom_previous( gctx, (fz_xml *)$self); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } FITZEXCEPTION (set_attribute, !result) PyObject *set_attribute(const char *key, const char *value) { fz_try(gctx) { if (strlen(key)==0) { RAISEPY(gctx, "key must not be empty", PyExc_ValueError); } fz_dom_add_attribute(gctx, (fz_xml *)$self, key, value); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION (remove_attribute, !result) PyObject *remove_attribute(const char *key) { fz_try(gctx) { if (strlen(key)==0) { RAISEPY(gctx, "key must not be empty", PyExc_ValueError); } fz_xml *elt = (fz_xml *)$self; fz_dom_remove_attribute(gctx, elt, key); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION (get_attribute_value, !result) PyObject *get_attribute_value(const char *key) { const char *ret=NULL; fz_try(gctx) { if (strlen(key)==0) { RAISEPY(gctx, "key must not be empty", PyExc_ValueError); } fz_xml *elt = (fz_xml *)$self; ret=fz_dom_attribute(gctx, elt, key); } fz_catch(gctx) { return NULL; } return Py_BuildValue("s", ret); } FITZEXCEPTION (get_attributes, !result) PyObject *get_attributes() { fz_xml *this = (fz_xml *) $self; if (fz_xml_text(this)) { // text node has none Py_RETURN_NONE; } PyObject *result=PyDict_New(); fz_try(gctx) { int i=0; const char *key=NULL; const char *val=NULL; while (1) { val = fz_dom_get_attribute(gctx, this, i, &key); if (!val || !key) { break; } PyObject *temp = Py_BuildValue("s",val); PyDict_SetItemString(result, key, temp); Py_DECREF(temp); i += 1; } } fz_catch(gctx) { Py_DECREF(result); return NULL; } return result; } FITZEXCEPTION (insert_before, !result) PyObject *insert_before(struct Xml *node) { fz_xml *existing = (fz_xml *) $self; fz_xml *what = (fz_xml *) node; fz_try(gctx) { fz_dom_insert_before(gctx, existing, what); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION (insert_after, !result) PyObject *insert_after(struct Xml *node) { fz_xml *existing = (fz_xml *) $self; fz_xml *what = (fz_xml *) node; fz_try(gctx) { fz_dom_insert_after(gctx, existing, what); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION (clone, !result) struct Xml* clone() { fz_xml* ret = NULL; fz_try(gctx) { ret = fz_dom_clone( gctx, (fz_xml *)$self); } fz_catch(gctx) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } %pythoncode %{@property%} struct Xml *parent() { fz_xml* ret = NULL; ret = fz_dom_parent( gctx, (fz_xml *)$self); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } %pythoncode %{@property%} struct Xml *first_child() { fz_xml* ret = NULL; fz_xml *this = (fz_xml *)$self; if (fz_xml_text(this)) { // a text node has no child return NULL; } ret = fz_dom_first_child( gctx, (fz_xml *)$self); if (!ret) { return NULL; } fz_keep_xml( gctx, ret); return (struct Xml*) ret; } FITZEXCEPTION (remove, !result) PyObject *remove() { fz_try(gctx) { fz_dom_remove( gctx, (fz_xml *)$self); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{@property%} PyObject *text() { return Py_BuildValue("s", fz_xml_text((fz_xml *)$self)); } %pythoncode %{@property%} PyObject *tagname() { return Py_BuildValue("s", fz_xml_tag((fz_xml *)$self)); } %pythoncode %{ def _get_node_tree(self): def show_node(node, items, shift): while node != None: if node.is_text: items.append((shift, f'"{node.text}"')) node = node.next continue items.append((shift, f"({node.tagname}")) for k, v in node.get_attributes().items(): items.append((shift, f"={k} '{v}'")) child = node.first_child if child: items = show_node(child, items, shift + 1) items.append((shift, f"){node.tagname}")) node = node.next return items shift = 0 items = [] items = show_node(self, items, shift) return items def debug(self): """Print a list of the node tree below self.""" items = self._get_node_tree() for item in items: print(" " * item[0] + item[1].replace("\n", "\\n")) @property def is_text(self): """Check if this is a text node.""" return self.text != None @property def last_child(self): """Return last child node.""" child = self.first_child if child==None: return None while True: if child.next == None: return child child = child.next @staticmethod def color_text(color): if type(color) is str: return color if type(color) is int: return f"rgb({sRGB_to_rgb(color)})" if type(color) in (tuple, list): return f"rgb{tuple(color)}" return color def add_number_list(self, start=1, numtype=None): """Add numbered list ("ol" tag)""" child = self.create_element("ol") if start > 1: child.set_attribute("start", str(start)) if numtype != None: child.set_attribute("type", numtype) self.append_child(child) return child def add_description_list(self): """Add description list ("dl" tag)""" child = self.create_element("dl") self.append_child(child) return child def add_image(self, name, width=None, height=None, imgfloat=None, align=None): """Add image node (tag "img").""" child = self.create_element("img") if width != None: child.set_attribute("width", f"{width}") if height != None: child.set_attribute("height", f"{height}") if imgfloat != None: child.set_attribute("style", f"float: {imgfloat}") if align != None: child.set_attribute("align", f"{align}") child.set_attribute("src", f"{name}") self.append_child(child) return child def add_bullet_list(self): """Add bulleted list ("ul" tag)""" child = self.create_element("ul") self.append_child(child) return child def add_list_item(self): """Add item ("li" tag) under a (numbered or bulleted) list.""" if self.tagname not in ("ol", "ul"): raise ValueError("cannot add list item to", self.tagname) child = self.create_element("li") self.append_child(child) return child def add_span(self): child = self.create_element("span") self.append_child(child) return child def add_paragraph(self): """Add "p" tag""" child = self.create_element("p") if self.tagname != "p": self.append_child(child) else: self.parent.append_child(child) return child def add_header(self, level=1): """Add header tag""" if level not in range(1, 7): raise ValueError("Header level must be in [1, 6]") this_tag = self.tagname new_tag = f"h{level}" child = self.create_element(new_tag) prev = self if this_tag not in ("h1", "h2", "h3", "h4", "h5", "h6", "p"): self.append_child(child) return child self.parent.append_child(child) return child def add_division(self): """Add "div" tag""" child = self.create_element("div") self.append_child(child) return child def add_horizontal_line(self): """Add horizontal line ("hr" tag)""" child = self.create_element("hr") self.append_child(child) return child def add_link(self, href, text=None): """Add a hyperlink ("a" tag)""" child = self.create_element("a") if not isinstance(text, str): text = href child.set_attribute("href", href) child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev == None: prev = self prev.append_child(child) return self def add_code(self, text=None): """Add a "code" tag""" child = self.create_element("code") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev == None: prev = self prev.append_child(child) return self add_var = add_code add_samp = add_code add_kbd = add_code def add_superscript(self, text=None): """Add a superscript ("sup" tag)""" child = self.create_element("sup") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev == None: prev = self prev.append_child(child) return self def add_subscript(self, text=None): """Add a subscript ("sub" tag)""" child = self.create_element("sub") if type(text) is str: child.append_child(self.create_text_node(text)) prev = self.span_bottom() if prev == None: prev = self prev.append_child(child) return self def add_codeblock(self): """Add monospaced lines ("pre" node)""" child = self.create_element("pre") self.append_child(child) return child def span_bottom(self): """Find deepest level in stacked spans.""" parent = self child = self.last_child if child == None: return None while child.is_text: child = child.previous if child == None: break if child == None or child.tagname != "span": return None while True: if child == None: return parent if child.tagname in ("a", "sub","sup","body") or child.is_text: child = child.next continue if child.tagname == "span": parent = child child = child.first_child else: return parent def append_styled_span(self, style): span = self.create_element("span") span.add_style(style) prev = self.span_bottom() if prev == None: prev = self prev.append_child(span) return prev def set_margins(self, val): """Set margin values via CSS style""" text = "margins: %s" % val self.append_styled_span(text) return self def set_font(self, font): """Set font-family name via CSS style""" text = "font-family: %s" % font self.append_styled_span(text) return self def set_color(self, color): """Set text color via CSS style""" text = f"color: %s" % self.color_text(color) self.append_styled_span(text) return self def set_columns(self, cols): """Set number of text columns via CSS style""" text = f"columns: {cols}" self.append_styled_span(text) return self def set_bgcolor(self, color): """Set background color via CSS style""" text = f"background-color: %s" % self.color_text(color) self.add_style(text) # does not work on span level return self def set_opacity(self, opacity): """Set opacity via CSS style""" text = f"opacity: {opacity}" self.append_styled_span(text) return self def set_align(self, align): """Set text alignment via CSS style""" text = "text-align: %s" if isinstance( align, str): t = align elif align == TEXT_ALIGN_LEFT: t = "left" elif align == TEXT_ALIGN_CENTER: t = "center" elif align == TEXT_ALIGN_RIGHT: t = "right" elif align == TEXT_ALIGN_JUSTIFY: t = "justify" else: raise ValueError(f"Unrecognised align={align}") text = text % t self.add_style(text) return self def set_underline(self, val="underline"): text = "text-decoration: %s" % val self.append_styled_span(text) return self def set_pagebreak_before(self): """Insert a page break before this node.""" text = "page-break-before: always" self.add_style(text) return self def set_pagebreak_after(self): """Insert a page break after this node.""" text = "page-break-after: always" self.add_style(text) return self def set_fontsize(self, fontsize): """Set font size name via CSS style""" if type(fontsize) is str: px="" else: px="px" text = f"font-size: {fontsize}{px}" self.append_styled_span(text) return self def set_lineheight(self, lineheight): """Set line height name via CSS style - block-level only.""" text = f"line-height: {lineheight}" self.add_style(text) return self def set_leading(self, leading): """Set inter-line spacing value via CSS style - block-level only.""" text = f"-mupdf-leading: {leading}" self.add_style(text) return self def set_word_spacing(self, spacing): """Set inter-word spacing value via CSS style""" text = f"word-spacing: {spacing}" self.append_styled_span(text) return self def set_letter_spacing(self, spacing): """Set inter-letter spacing value via CSS style""" text = f"letter-spacing: {spacing}" self.append_styled_span(text) return self def set_text_indent(self, indent): """Set text indentation name via CSS style - block-level only.""" text = f"text-indent: {indent}" self.add_style(text) return self def set_bold(self, val=True): """Set bold on / off via CSS style""" if val: val="bold" else: val="normal" text = "font-weight: %s" % val self.append_styled_span(text) return self def set_italic(self, val=True): """Set italic on / off via CSS style""" if val: val="italic" else: val="normal" text = "font-style: %s" % val self.append_styled_span(text) return self def set_properties( self, align=None, bgcolor=None, bold=None, color=None, columns=None, font=None, fontsize=None, indent=None, italic=None, leading=None, letter_spacing=None, lineheight=None, margins=None, pagebreak_after=None, pagebreak_before=None, word_spacing=None, unqid=None, cls=None, ): """Set any or all properties of a node. To be used for existing nodes preferrably. """ root = self.root temp = root.add_division() if align is not None: temp.set_align(align) if bgcolor is not None: temp.set_bgcolor(bgcolor) if bold is not None: temp.set_bold(bold) if color is not None: temp.set_color(color) if columns is not None: temp.set_columns(columns) if font is not None: temp.set_font(font) if fontsize is not None: temp.set_fontsize(fontsize) if indent is not None: temp.set_text_indent(indent) if italic is not None: temp.set_italic(italic) if leading is not None: temp.set_leading(leading) if letter_spacing is not None: temp.set_letter_spacing(letter_spacing) if lineheight is not None: temp.set_lineheight(lineheight) if margins is not None: temp.set_margins(margins) if pagebreak_after is not None: temp.set_pagebreak_after() if pagebreak_before is not None: temp.set_pagebreak_before() if word_spacing is not None: temp.set_word_spacing(word_spacing) if unqid is not None: self.set_id(unqid) if cls is not None: self.add_class(cls) styles = [] top_style = temp.get_attribute_value("style") if top_style is not None: styles.append(top_style) child = temp.first_child while child: styles.append(child.get_attribute_value("style")) child = child.first_child self.set_attribute("style", ";".join(styles)) temp.remove() return self def set_id(self, unique): """Set a unique id.""" # check uniqueness tagname = self.tagname root = self.root if root.find(None, "id", unique): raise ValueError(f"id '{unique}' already exists") self.set_attribute("id", unique) return self def add_text(self, text): """Add text. Line breaks are honored.""" lines = text.splitlines() line_count = len(lines) prev = self.span_bottom() if prev == None: prev = self for i, line in enumerate(lines): prev.append_child(self.create_text_node(line)) if i < line_count - 1: prev.append_child(self.create_element("br")) return self def add_style(self, text): """Set some style via CSS style. Replaces complete style spec.""" style = self.get_attribute_value("style") if style != None and text in style: return self self.remove_attribute("style") if style == None: style = text else: style += ";" + text self.set_attribute("style", style) return self def add_class(self, text): """Set some class via CSS. Replaces complete class spec.""" cls = self.get_attribute_value("class") if cls != None and text in cls: return self self.remove_attribute("class") if cls == None: cls = text else: cls += " " + text self.set_attribute("class", cls) return self def insert_text(self, text): lines = text.splitlines() line_count = len(lines) for i, line in enumerate(lines): self.append_child(self.create_text_node(line)) if i < line_count - 1: self.append_child(self.create_element("br")) return self def __enter__(self): return self def __exit__(self, *args): pass def __del__(self): if not type(self) is Xml: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // Story //------------------------------------------------------------------------ struct Story { %extend { ~Story() { DEBUGMSG1("Story"); fz_story *this_story = (fz_story *) $self; fz_drop_story(gctx, this_story); DEBUGMSG2; } FITZEXCEPTION(Story, !result) %pythonprepend Story %{ if archive != None and isinstance(archive, Archive) == False: archive = Archive(archive) %} Story(const char* html=NULL, const char *user_css=NULL, double em=12, struct Archive *archive=NULL) { fz_story* story = NULL; fz_buffer *buffer = NULL; fz_archive* arch = NULL; fz_var(story); fz_var(buffer); const char *html2=""; if (html) { html2=html; } fz_try(gctx) { buffer = fz_new_buffer_from_copied_data(gctx, html2, strlen(html2)+1); if (archive) { arch = (fz_archive *) archive; } story = fz_new_story(gctx, buffer, user_css, em, arch); } fz_always(gctx) { fz_drop_buffer(gctx, buffer); } fz_catch(gctx) { return NULL; } struct Story* ret = (struct Story *) story; return ret; } FITZEXCEPTION(reset, !result) PyObject* reset() { fz_try(gctx) { fz_reset_story(gctx, (fz_story *)$self); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(place, !result) PyObject* place( PyObject* where) { PyObject* ret = NULL; fz_try(gctx) { fz_rect where2 = JM_rect_from_py(where); fz_rect filled; int more = fz_place_story( gctx, (fz_story*) $self, where2, &filled); ret = PyTuple_New(2); PyTuple_SET_ITEM( ret, 0, Py_BuildValue( "i", more)); PyTuple_SET_ITEM( ret, 1, JM_py_from_rect( filled)); } fz_catch(gctx) { return NULL; } return ret; } FITZEXCEPTION(draw, !result) PyObject* draw( struct DeviceWrapper* device, PyObject* matrix=NULL) { fz_try(gctx) { fz_matrix ctm2 = JM_matrix_from_py( matrix); fz_device *dev = (device) ? device->device : NULL; fz_draw_story( gctx, (fz_story*) $self, dev, ctm2); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(document, !result) struct Xml* document() { fz_xml* dom=NULL; fz_try(gctx) { dom = fz_story_document( gctx, (fz_story*) $self); } fz_catch(gctx) { return NULL; } fz_keep_xml( gctx, dom); return (struct Xml*) dom; } FITZEXCEPTION(element_positions, !result) %pythonprepend element_positions %{ """Trigger a callback function to record where items have been placed. Args: function: a function accepting exactly one argument. args: an optional dictionary for passing additional data. """ if type(args) is dict: for k in args.keys(): if not (type(k) is str and k.isidentifier()): raise ValueError(f"invalid key '{k}'") else: args = {} if not callable(function) or function.__code__.co_argcount != 1: raise ValueError("callback 'function' must be a callable with exactly one argument") %} PyObject* element_positions(PyObject *function, PyObject *args) { PyObject *callarg=NULL; fz_try(gctx) { callarg = Py_BuildValue("OO", function, args); fz_story_positions(gctx, (fz_story *) $self, Story_Callback, callarg); } fz_always(gctx) { Py_CLEAR(callarg); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythoncode %{ def write(self, writer, rectfn, positionfn=None, pagefn=None): dev = None page_num = 0 rect_num = 0 filled = Rect(0, 0, 0, 0) while 1: mediabox, rect, ctm = rectfn(rect_num, filled) rect_num += 1 if mediabox: # new page. page_num += 1 more, filled = self.place( rect) #print(f"write(): positionfn={positionfn}") if positionfn: def positionfn2(position): # We add a `.page_num` member to the # `ElementPosition` instance. position.page_num = page_num #print(f"write(): position={position}") positionfn(position) self.element_positions(positionfn2, {}) if writer: if mediabox: # new page. if dev: if pagefn: pagefn(page_num, medibox, dev, 1) writer.end_page() dev = writer.begin_page( mediabox) if pagefn: pagefn(page_num, mediabox, dev, 0) self.draw( dev, ctm) if not more: if pagefn: pagefn( page_num, mediabox, dev, 1) writer.end_page() else: self.draw(None, ctm) if not more: break @staticmethod def write_stabilized(writer, contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True): positions = list() content = None # Iterate until stable. while 1: content_prev = content content = contentfn( positions) stable = False if content == content_prev: stable = True content2 = content story = Story(content2, user_css, em, archive) if add_header_ids: story.add_header_ids() positions = list() def positionfn2(position): #print(f"write_stabilized(): stable={stable} positionfn={positionfn} position={position}") positions.append(position) if stable and positionfn: positionfn(position) story.write( writer if stable else None, rectfn, positionfn2, pagefn, ) if stable: break def add_header_ids(self): ''' Look for `` items in `self` and adds unique `id` attributes if not already present. ''' dom = self.body i = 0 x = dom.find(None, None, None) while x: name = x.tagname if len(name) == 2 and name[0]=="h" and name[1] in "123456": attr = x.get_attribute_value("id") if not attr: id_ = f"h_id_{i}" #print(f"name={name}: setting id={id_}") x.set_attribute("id", id_) i += 1 x = x.find_next(None, None, None) def write_with_links(self, rectfn, positionfn=None, pagefn=None): #print("write_with_links()") stream = io.BytesIO() writer = DocumentWriter(stream) positions = [] def positionfn2(position): #print(f"write_with_links(): position={position}") positions.append(position) if positionfn: positionfn(position) self.write(writer, rectfn, positionfn=positionfn2, pagefn=pagefn) writer.close() stream.seek(0) return Story.add_pdf_links(stream, positions) @staticmethod def write_stabilized_with_links(contentfn, rectfn, user_css=None, em=12, positionfn=None, pagefn=None, archive=None, add_header_ids=True): #print("write_stabilized_with_links()") stream = io.BytesIO() writer = DocumentWriter(stream) positions = [] def positionfn2(position): #print(f"write_stabilized_with_links(): position={position}") positions.append(position) if positionfn: positionfn(position) Story.write_stabilized(writer, contentfn, rectfn, user_css, em, positionfn2, pagefn, archive, add_header_ids) writer.close() stream.seek(0) return Story.add_pdf_links(stream, positions) @staticmethod def add_pdf_links(document_or_stream, positions): """ Adds links to PDF document. Args: document_or_stream: A PDF `Document` or raw PDF content, for example an `io.BytesIO` instance. positions: List of `ElementPosition`'s for `document_or_stream`, typically from Story.element_positions(). We raise an exception if two or more positions have same id. Returns: `document_or_stream` if a `Document` instance, otherwise a new `Document` instance. We raise an exception if an `href` in `positions` refers to an internal position `#` but no item in `postions` has `id = name`. """ if isinstance(document_or_stream, Document): document = document_or_stream else: document = Document("pdf", document_or_stream) # Create dict from id to position, which we will use to find # link destinations. # id_to_position = dict() #print(f"positions: {positions}") for position in positions: #print(f"add_pdf_links(): position: {position}") if (position.open_close & 1) and position.id: #print(f"add_pdf_links(): position with id: {position}") if position.id in id_to_position: #print(f"Ignoring duplicate positions with id={position.id!r}") pass else: id_to_position[ position.id] = position # Insert links for all positions that have an `href` starting # with '#'. # for position_from in positions: if ((position_from.open_close & 1) and position_from.href and position_from.href.startswith("#") ): # This is a `...` internal link. #print(f"add_pdf_links(): position with href: {position}") target_id = position_from.href[1:] try: position_to = id_to_position[ target_id] except Exception as e: raise RuntimeError(f"No destination with id={target_id}, required by position_from: {position_from}") # Make link from `position_from`'s rect to top-left of # `position_to`'s rect. if 0: print(f"add_pdf_links(): making link from:") print(f"add_pdf_links(): {position_from}") print(f"add_pdf_links(): to:") print(f"add_pdf_links(): {position_to}") link = dict() link["kind"] = LINK_GOTO link["from"] = Rect(position_from.rect) x0, y0, x1, y1 = position_to.rect # This appears to work well with viewers which scroll # to make destination point top-left of window. link["to"] = Point(x0, y0) link["page"] = position_to.page_num - 1 document[position_from.page_num - 1].insert_link(link) return document @property def body(self): dom = self.document() return dom.bodytag() def __del__(self): if not type(self) is Story: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; //------------------------------------------------------------------------ // Tools - a collection of tools and utilities //------------------------------------------------------------------------ struct Tools { %extend { Tools() { /* It looks like global objects are never destructed when running with SWIG, so we use Memento_startLeaking()/Memento_stopLeaking(). */ Memento_startLeaking(); void* p = malloc( sizeof(struct Tools)); Memento_stopLeaking(); //fprintf(stderr, "Tools constructor p=%p\n", p); return (struct Tools*) p; } ~Tools() { /* This is not called. */ struct Tools* p = (struct Tools*) $self; //fprintf(stderr, "~Tools() p=%p\n", p); free(p); } %pythonprepend gen_id %{"""Return a unique positive integer."""%} PyObject *gen_id() { JM_UNIQUE_ID += 1; if (JM_UNIQUE_ID < 0) JM_UNIQUE_ID = 1; return Py_BuildValue("i", JM_UNIQUE_ID); } FITZEXCEPTION(set_icc, !result) %pythonprepend set_icc %{"""Set ICC color handling on or off."""%} PyObject *set_icc(int on=0) { fz_try(gctx) { if (on) { if (FZ_ENABLE_ICC) fz_enable_icc(gctx); else { RAISEPY(gctx, "MuPDF built w/o ICC support",PyExc_ValueError); } } else if (FZ_ENABLE_ICC) { fz_disable_icc(gctx); } } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } %pythonprepend set_annot_stem %{"""Get / set id prefix for annotations."""%} char *set_annot_stem(char *stem=NULL) { if (!stem) { return JM_annot_id_stem; } size_t len = strlen(stem) + 1; if (len > 50) len = 50; memcpy(&JM_annot_id_stem, stem, len); return JM_annot_id_stem; } %pythonprepend set_small_glyph_heights %{"""Set / unset small glyph heights."""%} PyObject *set_small_glyph_heights(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(small_glyph_heights); } if (PyObject_IsTrue(on)) { small_glyph_heights = 1; } else { small_glyph_heights = 0; } return JM_BOOL(small_glyph_heights); } %pythonprepend set_subset_fontnames %{"""Set / unset returning fontnames with their subset prefix."""%} PyObject *set_subset_fontnames(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(subset_fontnames); } if (PyObject_IsTrue(on)) { subset_fontnames = 1; } else { subset_fontnames = 0; } return JM_BOOL(subset_fontnames); } %pythonprepend set_low_memory %{"""Set / unset MuPDF device caching."""%} PyObject *set_low_memory(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(no_device_caching); } if (PyObject_IsTrue(on)) { no_device_caching = 1; } else { no_device_caching = 0; } return JM_BOOL(no_device_caching); } %pythonprepend unset_quad_corrections %{"""Set ascender / descender corrections on or off."""%} PyObject *unset_quad_corrections(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(skip_quad_corrections); } if (PyObject_IsTrue(on)) { skip_quad_corrections = 1; } else { skip_quad_corrections = 0; } return JM_BOOL(skip_quad_corrections); } %pythonprepend store_shrink %{"""Free 'percent' of current store size."""%} PyObject *store_shrink(int percent) { if (percent >= 100) { fz_empty_store(gctx); return Py_BuildValue("i", 0); } if (percent > 0) fz_shrink_store(gctx, 100 - percent); return Py_BuildValue("i", (int) gctx->store->size); } %pythoncode%{@property%} %pythonprepend store_size %{"""MuPDF current store size."""%} PyObject *store_size() { return Py_BuildValue("i", (int) gctx->store->size); } %pythoncode%{@property%} %pythonprepend store_maxsize %{"""MuPDF store size limit."""%} PyObject *store_maxsize() { return Py_BuildValue("i", (int) gctx->store->max); } %pythonprepend show_aa_level %{"""Show anti-aliasing values."""%} %pythonappend show_aa_level %{ temp = {"graphics": val[0], "text": val[1], "graphics_min_line_width": val[2]} val = temp%} PyObject *show_aa_level() { return Py_BuildValue("iif", fz_graphics_aa_level(gctx), fz_text_aa_level(gctx), fz_graphics_min_line_width(gctx)); } %pythonprepend set_aa_level %{"""Set anti-aliasing level."""%} void set_aa_level(int level) { fz_set_aa_level(gctx, level); } %pythonprepend set_graphics_min_line_width %{"""Set the graphics minimum line width."""%} void set_graphics_min_line_width(float min_line_width) { fz_set_graphics_min_line_width(gctx, min_line_width); } FITZEXCEPTION(image_profile, !result) %pythonprepend image_profile %{"""Metadata of an image binary stream."""%} PyObject *image_profile(PyObject *stream, int keep_image=0) { PyObject *rc = NULL; fz_try(gctx) { rc = JM_image_profile(gctx, stream, keep_image); } fz_catch(gctx) { return NULL; } return rc; } PyObject *_rotate_matrix(struct Page *page) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) page); if (!pdfpage) return JM_py_from_matrix(fz_identity); return JM_py_from_matrix(JM_rotate_page_matrix(gctx, pdfpage)); } PyObject *_derotate_matrix(struct Page *page) { pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) page); if (!pdfpage) return JM_py_from_matrix(fz_identity); return JM_py_from_matrix(JM_derotate_page_matrix(gctx, pdfpage)); } %pythoncode%{@property%} %pythonprepend fitz_config %{"""PyMuPDF configuration parameters."""%} PyObject *fitz_config() { return JM_fitz_config(); } %pythonprepend glyph_cache_empty %{"""Empty the glyph cache."""%} void glyph_cache_empty() { fz_purge_glyph_cache(gctx); } FITZEXCEPTION(_fill_widget, !result) %pythonappend _fill_widget %{ widget.rect = Rect(annot.rect) widget.xref = annot.xref widget.parent = annot.parent widget._annot = annot # backpointer to annot object if not widget.script: widget.script = None if not widget.script_stroke: widget.script_stroke = None if not widget.script_format: widget.script_format = None if not widget.script_change: widget.script_change = None if not widget.script_calc: widget.script_calc = None if not widget.script_blur: widget.script_blur = None if not widget.script_focus: widget.script_focus = None %} PyObject *_fill_widget(struct Annot *annot, PyObject *widget) { fz_try(gctx) { JM_get_widget_properties(gctx, (pdf_annot *) annot, widget); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_save_widget, !result) PyObject *_save_widget(struct Annot *annot, PyObject *widget) { fz_try(gctx) { JM_set_widget_properties(gctx, (pdf_annot *) annot, widget); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_reset_widget, !result) PyObject *_reset_widget(struct Annot *annot) { fz_try(gctx) { pdf_annot *this_annot = (pdf_annot *) annot; pdf_obj *this_annot_obj = pdf_annot_obj(gctx, this_annot); pdf_document *pdf = pdf_get_bound_document(gctx, this_annot_obj); pdf_field_reset(gctx, pdf, this_annot_obj); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } // Ensure that widgets with a /AA/C JavaScript are in AcroForm/CO FITZEXCEPTION(_ensure_widget_calc, !result) PyObject *_ensure_widget_calc(struct Annot *annot) { pdf_obj *PDFNAME_CO=NULL; fz_try(gctx) { pdf_obj *annot_obj = pdf_annot_obj(gctx, (pdf_annot *) annot); pdf_document *pdf = pdf_get_bound_document(gctx, annot_obj); PDFNAME_CO = pdf_new_name(gctx, "CO"); // = PDF_NAME(CO) pdf_obj *acro = pdf_dict_getl(gctx, // get AcroForm dict pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), NULL); pdf_obj *CO = pdf_dict_get(gctx, acro, PDFNAME_CO); // = AcroForm/CO if (!CO) { CO = pdf_dict_put_array(gctx, acro, PDFNAME_CO, 2); } int i, n = pdf_array_len(gctx, CO); int xref, nxref, found = 0; xref = pdf_to_num(gctx, annot_obj); for (i = 0; i < n; i++) { nxref = pdf_to_num(gctx, pdf_array_get(gctx, CO, i)); if (xref == nxref) { found = 1; break; } } if (!found) { pdf_array_push_drop(gctx, CO, pdf_new_indirect(gctx, pdf, xref, 0)); } } fz_always(gctx) { pdf_drop_obj(gctx, PDFNAME_CO); } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_parse_da, !result) %pythonappend _parse_da %{ if not val: return ((0,), "", 0) font = "Helv" fsize = 12 col = (0, 0, 0) dat = val.split() # split on any whitespace for i, item in enumerate(dat): if item == "Tf": font = dat[i - 2][1:] fsize = float(dat[i - 1]) dat[i] = dat[i-1] = dat[i-2] = "" continue if item == "g": # unicolor text col = [(float(dat[i - 1]))] dat[i] = dat[i-1] = "" continue if item == "rg": # RGB colored text col = [float(f) for f in dat[i - 3:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = "" continue if item == "k": # CMYK colored text col = [float(f) for f in dat[i - 4:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = dat[i-4] = "" continue val = (col, font, fsize) %} PyObject *_parse_da(struct Annot *annot) { char *da_str = NULL; pdf_annot *this_annot = (pdf_annot *) annot; pdf_obj *this_annot_obj = pdf_annot_obj(gctx, this_annot); pdf_document *pdf = pdf_get_bound_document(gctx, this_annot_obj); fz_try(gctx) { pdf_obj *da = pdf_dict_get_inheritable(gctx, this_annot_obj, PDF_NAME(DA)); if (!da) { pdf_obj *trailer = pdf_trailer(gctx, pdf); da = pdf_dict_getl(gctx, trailer, PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(DA), NULL); } da_str = (char *) pdf_to_text_string(gctx, da); } fz_catch(gctx) { return NULL; } return JM_UnicodeFromStr(da_str); } FITZEXCEPTION(_update_da, !result) PyObject *_update_da(struct Annot *annot, char *da_str) { fz_try(gctx) { pdf_annot *this_annot = (pdf_annot *) annot; pdf_obj *this_annot_obj = pdf_annot_obj(gctx, this_annot); pdf_dict_put_text_string(gctx, this_annot_obj, PDF_NAME(DA), da_str); pdf_dict_del(gctx, this_annot_obj, PDF_NAME(DS)); /* not supported */ pdf_dict_del(gctx, this_annot_obj, PDF_NAME(RC)); /* not supported */ } fz_catch(gctx) { return NULL; } Py_RETURN_NONE; } FITZEXCEPTION(_get_all_contents, !result) %pythonprepend _get_all_contents %{"""Concatenate all /Contents objects of a page into a bytes object."""%} PyObject *_get_all_contents(struct Page *fzpage) { pdf_page *page = pdf_page_from_fz_page(gctx, (fz_page *) fzpage); fz_buffer *res = NULL; PyObject *result = NULL; fz_try(gctx) { ASSERT_PDF(page); res = JM_read_contents(gctx, page->obj); result = JM_BinFromBuffer(gctx, res); } fz_always(gctx) { fz_drop_buffer(gctx, res); } fz_catch(gctx) { return NULL; } return result; } FITZEXCEPTION(_insert_contents, !result) %pythonprepend _insert_contents %{"""Add bytes as a new /Contents object for a page, and return its xref."""%} PyObject *_insert_contents(struct Page *page, PyObject *newcont, int overlay=1) { fz_buffer *contbuf = NULL; int xref = 0; pdf_page *pdfpage = pdf_page_from_fz_page(gctx, (fz_page *) page); fz_try(gctx) { ASSERT_PDF(pdfpage); ENSURE_OPERATION(gctx, pdfpage->doc); contbuf = JM_BufferFromBytes(gctx, newcont); xref = JM_insert_contents(gctx, pdfpage->doc, pdfpage->obj, contbuf, overlay); } fz_always(gctx) { fz_drop_buffer(gctx, contbuf); } fz_catch(gctx) { return NULL; } return Py_BuildValue("i", xref); } %pythonprepend mupdf_version %{"""Get version of MuPDF binary build."""%} PyObject *mupdf_version() { return Py_BuildValue("s", FZ_VERSION); } %pythonprepend mupdf_warnings %{"""Get the MuPDF warnings/errors with optional reset (default)."""%} %pythonappend mupdf_warnings %{ val = "\n".join(val) if reset: self.reset_mupdf_warnings()%} PyObject *mupdf_warnings(int reset=1) { Py_INCREF(JM_mupdf_warnings_store); return JM_mupdf_warnings_store; } int _int_from_language(char *language) { return fz_text_language_from_string(language); } %pythonprepend reset_mupdf_warnings %{"""Empty the MuPDF warnings/errors store."""%} void reset_mupdf_warnings() { Py_CLEAR(JM_mupdf_warnings_store); JM_mupdf_warnings_store = PyList_New(0); } %pythonprepend mupdf_display_errors %{"""Set MuPDF error display to True or False."""%} PyObject *mupdf_display_errors(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(JM_mupdf_show_errors); } if (PyObject_IsTrue(on)) { JM_mupdf_show_errors = 1; } else { JM_mupdf_show_errors = 0; } return JM_BOOL(JM_mupdf_show_errors); } %pythonprepend mupdf_display_warnings %{"""Set MuPDF warnings display to True or False."""%} PyObject *mupdf_display_warnings(PyObject *on=NULL) { if (!on || on == Py_None) { return JM_BOOL(JM_mupdf_show_warnings); } if (PyObject_IsTrue(on)) { JM_mupdf_show_warnings = 1; } else { JM_mupdf_show_warnings = 0; } return JM_BOOL(JM_mupdf_show_warnings); } %pythoncode %{ def _le_annot_parms(self, annot, p1, p2, fill_color): """Get common parameters for making annot line end symbols. Returns: m: matrix that maps p1, p2 to points L, P on the x-axis im: its inverse L, P: transformed p1, p2 w: line width scol: stroke color string fcol: fill color store_shrink opacity: opacity string (gs command) """ w = annot.border["width"] # line width sc = annot.colors["stroke"] # stroke color if not sc: # black if missing sc = (0,0,0) scol = " ".join(map(str, sc)) + " RG\n" if fill_color: fc = fill_color else: fc = annot.colors["fill"] # fill color if not fc: fc = (1,1,1) # white if missing fcol = " ".join(map(str, fc)) + " rg\n" # nr = annot.rect np1 = p1 # point coord relative to annot rect np2 = p2 # point coord relative to annot rect m = Matrix(util_hor_matrix(np1, np2)) # matrix makes the line horizontal im = ~m # inverted matrix L = np1 * m # converted start (left) point R = np2 * m # converted end (right) point if 0 <= annot.opacity < 1: opacity = "/H gs\n" else: opacity = "" return m, im, L, R, w, scol, fcol, opacity def _oval_string(self, p1, p2, p3, p4): """Return /AP string defining an oval within a 4-polygon provided as points """ def bezier(p, q, r): f = "%f %f %f %f %f %f c\n" return f % (p.x, p.y, q.x, q.y, r.x, r.y) kappa = 0.55228474983 # magic number ml = p1 + (p4 - p1) * 0.5 # middle points ... mo = p1 + (p2 - p1) * 0.5 # for each ... mr = p2 + (p3 - p2) * 0.5 # polygon ... mu = p4 + (p3 - p4) * 0.5 # side ol1 = ml + (p1 - ml) * kappa # the 8 bezier ol2 = mo + (p1 - mo) * kappa # helper points or1 = mo + (p2 - mo) * kappa or2 = mr + (p2 - mr) * kappa ur1 = mr + (p3 - mr) * kappa ur2 = mu + (p3 - mu) * kappa ul1 = mu + (p4 - mu) * kappa ul2 = ml + (p4 - ml) * kappa # now draw, starting from middle point of left side ap = "%f %f m\n" % (ml.x, ml.y) ap += bezier(ol1, ol2, mo) ap += bezier(or1, or2, mr) ap += bezier(ur1, ur2, mu) ap += bezier(ul1, ul2, ml) return ap def _le_diamond(self, annot, p1, p2, lr, fill_color): """Make stream commands for diamond line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square # the square makes line longer by (2*shift - 1)*width p = (r.tl + (r.bl - r.tl) * 0.5) * im ap = "q\n%s%f %f m\n" % (opacity, p.x, p.y) p = (r.tl + (r.tr - r.tl) * 0.5) * im ap += "%f %f l\n" % (p.x, p.y) p = (r.tr + (r.br - r.tr) * 0.5) * im ap += "%f %f l\n" % (p.x, p.y) p = (r.br + (r.bl - r.br) * 0.5) * im ap += "%f %f l\n" % (p.x, p.y) ap += "%g w\n" % w ap += scol + fcol + "b\nQ\n" return ap def _le_square(self, annot, p1, p2, lr, fill_color): """Make stream commands for square line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square # the square makes line longer by (2*shift - 1)*width p = r.tl * im ap = "q\n%s%f %f m\n" % (opacity, p.x, p.y) p = r.tr * im ap += "%f %f l\n" % (p.x, p.y) p = r.br * im ap += "%f %f l\n" % (p.x, p.y) p = r.bl * im ap += "%f %f l\n" % (p.x, p.y) ap += "%g w\n" % w ap += scol + fcol + "b\nQ\n" return ap def _le_circle(self, annot, p1, p2, lr, fill_color): """Make stream commands for circle line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 # 2*shift*width = length of square edge d = shift * max(1, w) M = R - (d/2., 0) if lr else L + (d/2., 0) r = Rect(M, M) + (-d, -d, d, d) # the square ap = "q\n" + opacity + self._oval_string(r.tl * im, r.tr * im, r.br * im, r.bl * im) ap += "%g w\n" % w ap += scol + fcol + "b\nQ\n" return ap def _le_butt(self, annot, p1, p2, lr, fill_color): """Make stream commands for butt line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 3 d = shift * max(1, w) M = R if lr else L top = (M + (0, -d/2.)) * im bot = (M + (0, d/2.)) * im ap = "\nq\n%s%f %f m\n" % (opacity, top.x, top.y) ap += "%f %f l\n" % (bot.x, bot.y) ap += "%g w\n" % w ap += scol + "s\nQ\n" return ap def _le_slash(self, annot, p1, p2, lr, fill_color): """Make stream commands for slash line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) rw = 1.1547 * max(1, w) * 1.0 # makes rect diagonal a 30 deg inclination M = R if lr else L r = Rect(M.x - rw, M.y - 2 * w, M.x + rw, M.y + 2 * w) top = r.tl * im bot = r.br * im ap = "\nq\n%s%f %f m\n" % (opacity, top.x, top.y) ap += "%f %f l\n" % (bot.x, bot.y) ap += "%g w\n" % w ap += scol + "s\nQ\n" return ap def _le_openarrow(self, annot, p1, p2, lr, fill_color): """Make stream commands for open arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R + (d/2., 0) if lr else L - (d/2., 0) p1 = p2 + (-2*d, -d) if lr else p2 + (2*d, -d) p3 = p2 + (-2*d, d) if lr else p2 + (2*d, d) p1 *= im p2 *= im p3 *= im ap = "\nq\n%s%f %f m\n" % (opacity, p1.x, p1.y) ap += "%f %f l\n" % (p2.x, p2.y) ap += "%f %f l\n" % (p3.x, p3.y) ap += "%g w\n" % w ap += scol + "S\nQ\n" return ap def _le_closedarrow(self, annot, p1, p2, lr, fill_color): """Make stream commands for closed arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R + (d/2., 0) if lr else L - (d/2., 0) p1 = p2 + (-2*d, -d) if lr else p2 + (2*d, -d) p3 = p2 + (-2*d, d) if lr else p2 + (2*d, d) p1 *= im p2 *= im p3 *= im ap = "\nq\n%s%f %f m\n" % (opacity, p1.x, p1.y) ap += "%f %f l\n" % (p2.x, p2.y) ap += "%f %f l\n" % (p3.x, p3.y) ap += "%g w\n" % w ap += scol + fcol + "b\nQ\n" return ap def _le_ropenarrow(self, annot, p1, p2, lr, fill_color): """Make stream commands for right open arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R - (d/3., 0) if lr else L + (d/3., 0) p1 = p2 + (2*d, -d) if lr else p2 + (-2*d, -d) p3 = p2 + (2*d, d) if lr else p2 + (-2*d, d) p1 *= im p2 *= im p3 *= im ap = "\nq\n%s%f %f m\n" % (opacity, p1.x, p1.y) ap += "%f %f l\n" % (p2.x, p2.y) ap += "%f %f l\n" % (p3.x, p3.y) ap += "%g w\n" % w ap += scol + fcol + "S\nQ\n" return ap def _le_rclosedarrow(self, annot, p1, p2, lr, fill_color): """Make stream commands for right closed arrow line end symbol. "lr" denotes left (False) or right point. """ m, im, L, R, w, scol, fcol, opacity = self._le_annot_parms(annot, p1, p2, fill_color) shift = 2.5 d = shift * max(1, w) p2 = R - (2*d, 0) if lr else L + (2*d, 0) p1 = p2 + (2*d, -d) if lr else p2 + (-2*d, -d) p3 = p2 + (2*d, d) if lr else p2 + (-2*d, d) p1 *= im p2 *= im p3 *= im ap = "\nq\n%s%f %f m\n" % (opacity, p1.x, p1.y) ap += "%f %f l\n" % (p2.x, p2.y) ap += "%f %f l\n" % (p3.x, p3.y) ap += "%g w\n" % w ap += scol + fcol + "b\nQ\n" return ap def __del__(self): if not type(self) is Tools: return if getattr(self, "thisown", False): self.__swig_destroy__(self) %} } }; ================================================ FILE: src_classic/helper-annot.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //------------------------------------------------------------------------ // return pdf_obj "border style" from Python str //------------------------------------------------------------------------ pdf_obj *JM_get_border_style(fz_context *ctx, PyObject *style) { pdf_obj *val = PDF_NAME(S); if (!style) return val; char *s = JM_StrAsChar(style); JM_PyErr_Clear; if (!s) return val; if (!strncmp(s, "b", 1) || !strncmp(s, "B", 1)) val = PDF_NAME(B); else if (!strncmp(s, "d", 1) || !strncmp(s, "D", 1)) val = PDF_NAME(D); else if (!strncmp(s, "i", 1) || !strncmp(s, "I", 1)) val = PDF_NAME(I); else if (!strncmp(s, "u", 1) || !strncmp(s, "U", 1)) val = PDF_NAME(U); else if (!strncmp(s, "s", 1) || !strncmp(s, "S", 1)) val = PDF_NAME(S); return val; } //------------------------------------------------------------------------ // Make /DA string of annotation //------------------------------------------------------------------------ const char *JM_expand_fname(const char **name) { if (!*name) return "Helv"; if (!strncmp(*name, "Co", 2)) return "Cour"; if (!strncmp(*name, "co", 2)) return "Cour"; if (!strncmp(*name, "Ti", 2)) return "TiRo"; if (!strncmp(*name, "ti", 2)) return "TiRo"; if (!strncmp(*name, "Sy", 2)) return "Symb"; if (!strncmp(*name, "sy", 2)) return "Symb"; if (!strncmp(*name, "Za", 2)) return "ZaDb"; if (!strncmp(*name, "za", 2)) return "ZaDb"; return "Helv"; } void JM_make_annot_DA(fz_context *ctx, pdf_annot *annot, int ncol, float col[4], const char *fontname, float fontsize) { fz_buffer *buf = NULL; fz_try(ctx) { buf = fz_new_buffer(ctx, 50); if (ncol <= 1) fz_append_printf(ctx, buf, "%g g ", col[0]); else if (ncol < 4) fz_append_printf(ctx, buf, "%g %g %g rg ", col[0], col[1], col[2]); else fz_append_printf(ctx, buf, "%g %g %g %g k ", col[0], col[1], col[2], col[3]); fz_append_printf(ctx, buf, "/%s %g Tf", JM_expand_fname(&fontname), fontsize); unsigned char *da = NULL; size_t len = fz_buffer_storage(ctx, buf, &da); pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); pdf_dict_put_string(ctx, annot_obj, PDF_NAME(DA), (const char *) da, len); } fz_always(ctx) fz_drop_buffer(ctx, buf); fz_catch(ctx) fz_rethrow(ctx); return; } //------------------------------------------------------------------------ // refreshes the link and annotation tables of a page //------------------------------------------------------------------------ void JM_refresh_links(fz_context *ctx, pdf_page *page) { if (!page) return; fz_try(ctx) { pdf_obj *obj = pdf_dict_get(ctx, page->obj, PDF_NAME(Annots)); if (obj) { pdf_document *pdf = page->doc; int number = pdf_lookup_page_number(ctx, pdf, page->obj); fz_rect page_mediabox; fz_matrix page_ctm; pdf_page_transform(ctx, page, &page_mediabox, &page_ctm); page->links = pdf_load_link_annots(ctx, pdf, page, obj, number, page_ctm); } } fz_catch(ctx) { fz_rethrow(ctx); } return; } PyObject *JM_annot_border(fz_context *ctx, pdf_obj *annot_obj) { PyObject *res = PyDict_New(); PyObject *dash_py = PyList_New(0); PyObject *val; int i; const char *style = NULL; float width = -1.0f; int clouds = -1; pdf_obj *obj = NULL; obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(Border)); if (pdf_is_array(ctx, obj)) { width = pdf_to_real(ctx, pdf_array_get(ctx, obj, 2)); if (pdf_array_len(ctx, obj) == 4) { pdf_obj *dash = pdf_array_get(ctx, obj, 3); for (i = 0; i < pdf_array_len(ctx, dash); i++) { val = Py_BuildValue("i", pdf_to_int(ctx, pdf_array_get(ctx, dash, i))); LIST_APPEND_DROP(dash_py, val); } } } pdf_obj *bs_o = pdf_dict_get(ctx, annot_obj, PDF_NAME(BS)); if (bs_o) { width = pdf_to_real(ctx, pdf_dict_get(ctx, bs_o, PDF_NAME(W))); style = pdf_to_name(ctx, pdf_dict_get(ctx, bs_o, PDF_NAME(S))); if (style && strcmp(style, "") == 0) { style = NULL; } obj = pdf_dict_get(ctx, bs_o, PDF_NAME(D)); if (obj) { for (i = 0; i < pdf_array_len(ctx, obj); i++) { val = Py_BuildValue("i", pdf_to_int(ctx, pdf_array_get(ctx, obj, i))); LIST_APPEND_DROP(dash_py, val); } } } obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(BE)); if (obj) { clouds = pdf_to_int(ctx, pdf_dict_get(ctx, obj, PDF_NAME(I))); } val = PySequence_Tuple(dash_py); Py_CLEAR(dash_py); DICT_SETITEM_DROP(res, dictkey_width, Py_BuildValue("f", width)); DICT_SETITEM_DROP(res, dictkey_dashes, val); DICT_SETITEM_DROP(res, dictkey_style, Py_BuildValue("s", style)); DICT_SETITEMSTR_DROP(res, "clouds", Py_BuildValue("i", clouds)); return res; } PyObject *JM_annot_set_border(fz_context *ctx, PyObject *border, pdf_document *doc, pdf_obj *annot_obj) { if (!PyDict_Check(border)) { JM_Warning("arg must be a dict"); Py_RETURN_NONE; // not a dict } pdf_obj *obj = NULL; Py_ssize_t i = 0, dashlen = 0; int d; double nwidth = PyFloat_AsDouble(PyDict_GetItem(border, dictkey_width)); // new width PyObject *ndashes = PyDict_GetItem(border, dictkey_dashes); // new dashes PyObject *nstyle = PyDict_GetItem(border, dictkey_style); // new style int nclouds = (int) PyLong_AsLong(PyDict_GetItemString(border, "clouds")); // new clouds value // get old border properties PyObject *oborder = JM_annot_border(ctx, annot_obj); // delete border-related entries pdf_dict_del(ctx, annot_obj, PDF_NAME(BS)); pdf_dict_del(ctx, annot_obj, PDF_NAME(BE)); pdf_dict_del(ctx, annot_obj, PDF_NAME(Border)); // populate border items: keep old values for any omitted new ones if (nwidth < 0) nwidth = PyFloat_AsDouble(PyDict_GetItem(oborder, dictkey_width)); // no new width: keep current if (ndashes == Py_None) ndashes = PyDict_GetItem(oborder, dictkey_dashes); // no new dashes: keep old if (nstyle == Py_None) nstyle = PyDict_GetItem(oborder, dictkey_style); // no new style: keep old if (nclouds < 0) nclouds = (int) PyLong_AsLong(PyDict_GetItemString(oborder, "clouds")); // no new clouds: keep old if (ndashes && PyTuple_Check(ndashes) && PyTuple_Size(ndashes) > 0) { dashlen = PyTuple_Size(ndashes); pdf_obj *darr = pdf_new_array(ctx, doc, dashlen); for (i = 0; i < dashlen; i++) { d = (int) PyLong_AsLong(PyTuple_GetItem(ndashes, i)); pdf_array_push_int(ctx, darr, (int64_t) d); } pdf_dict_putl_drop(ctx, annot_obj, darr, PDF_NAME(BS), PDF_NAME(D), NULL); } pdf_dict_putl_drop(ctx, annot_obj, pdf_new_real(ctx, (float) nwidth), PDF_NAME(BS), PDF_NAME(W), NULL); if (dashlen == 0) { obj = JM_get_border_style(ctx, nstyle); } else { obj = PDF_NAME(D); } pdf_dict_putl_drop(ctx, annot_obj, obj, PDF_NAME(BS), PDF_NAME(S), NULL); if (nclouds > 0) { pdf_dict_put_dict(ctx, annot_obj, PDF_NAME(BE), 2); pdf_obj *obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(BE)); pdf_dict_put(ctx, obj, PDF_NAME(S), PDF_NAME(C)); pdf_dict_put_int(ctx, obj, PDF_NAME(I), (int64_t) nclouds); } PyErr_Clear(); Py_RETURN_NONE; } PyObject *JM_annot_colors(fz_context *ctx, pdf_obj *annot_obj) { PyObject *res = PyDict_New(); PyObject *color = NULL; int i, n; float col; pdf_obj *o = NULL; o = pdf_dict_get(ctx, annot_obj, PDF_NAME(C)); if (pdf_is_array(ctx, o)) { n = pdf_array_len(ctx, o); color = PyTuple_New((Py_ssize_t) n); for (i = 0; i < n; i++) { col = pdf_to_real(ctx, pdf_array_get(ctx, o, i)); PyTuple_SET_ITEM(color, i, Py_BuildValue("f", col)); } DICT_SETITEM_DROP(res, dictkey_stroke, color); } else { DICT_SETITEM_DROP(res, dictkey_stroke, Py_BuildValue("s", NULL)); } o = pdf_dict_get(ctx, annot_obj, PDF_NAME(IC)); if (pdf_is_array(ctx, o)) { n = pdf_array_len(ctx, o); color = PyTuple_New((Py_ssize_t) n); for (i = 0; i < n; i++) { col = pdf_to_real(ctx, pdf_array_get(ctx, o, i)); PyTuple_SET_ITEM(color, i, Py_BuildValue("f", col)); } DICT_SETITEM_DROP(res, dictkey_fill, color); } else { DICT_SETITEM_DROP(res, dictkey_fill, Py_BuildValue("s", NULL)); } return res; } //------------------------------------------------------------------------ // Return the first annotation whose /IRT key ("In Response To") points to // annot. Used to remove the response chain of a given annotation. //------------------------------------------------------------------------ pdf_annot *JM_find_annot_irt(fz_context *ctx, pdf_annot *annot) { pdf_annot *irt_annot = NULL; // returning this pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); pdf_obj *o = NULL; int found = 0; fz_try(ctx) { // loop thru MuPDF's internal annots array pdf_page *page = pdf_annot_page(ctx, annot); irt_annot = pdf_first_annot(ctx, page); while (irt_annot) { pdf_obj *irt_annot_obj = pdf_annot_obj(ctx, irt_annot); o = pdf_dict_gets(ctx, irt_annot_obj, "IRT"); if (o) { if (!pdf_objcmp(ctx, o, annot_obj)) { found = 1; break; } } irt_annot = pdf_next_annot(ctx, irt_annot); } } fz_catch(ctx) {;} if (found) return pdf_keep_annot(ctx, irt_annot); return NULL; } //------------------------------------------------------------------------ // return the annotation names (list of /NM entries) //------------------------------------------------------------------------ PyObject *JM_get_annot_id_list(fz_context *ctx, pdf_page *page) { PyObject *names = PyList_New(0); pdf_obj *annot_obj = NULL; pdf_obj *annots = pdf_dict_get(ctx, page->obj, PDF_NAME(Annots)); pdf_obj *name = NULL; if (!annots) return names; fz_try(ctx) { int i, n = pdf_array_len(ctx, annots); for (i = 0; i < n; i++) { annot_obj = pdf_array_get(ctx, annots, i); name = pdf_dict_gets(ctx, annot_obj, "NM"); if (name) { LIST_APPEND_DROP(names, Py_BuildValue("s", pdf_to_text_string(ctx, name))); } } } fz_catch(ctx) { return names; } return names; } //------------------------------------------------------------------------ // return the xrefs and /NM ids of a page's annots, links and fields //------------------------------------------------------------------------ PyObject *JM_get_annot_xref_list(fz_context *ctx, pdf_obj *page_obj) { PyObject *names = PyList_New(0); pdf_obj *id, *subtype, *annots, *annot_obj; int xref, type, i, n; fz_try(ctx) { annots = pdf_dict_get(ctx, page_obj, PDF_NAME(Annots)); n = pdf_array_len(ctx, annots); for (i = 0; i < n; i++) { annot_obj = pdf_array_get(ctx, annots, i); xref = pdf_to_num(ctx, annot_obj); subtype = pdf_dict_get(ctx, annot_obj, PDF_NAME(Subtype)); if (!subtype) { continue; // subtype is required } type = pdf_annot_type_from_string(ctx, pdf_to_name(ctx, subtype)); if (type == PDF_ANNOT_UNKNOWN) { continue; // only accept valid annot types } id = pdf_dict_gets(ctx, annot_obj, "NM"); LIST_APPEND_DROP(names, Py_BuildValue("iis", xref, type, pdf_to_text_string(ctx, id))); } } fz_catch(ctx) { return names; } return names; } //------------------------------------------------------------------------ // Add a unique /NM key to an annotation or widget. // Append a number to 'stem' such that the result is a unique name. //------------------------------------------------------------------------ static char JM_annot_id_stem[50] = "fitz"; void JM_add_annot_id(fz_context *ctx, pdf_annot *annot, char *stem) { fz_try(ctx) { PyObject *names = NULL; pdf_page *page = pdf_annot_page(ctx, annot); pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); names = JM_get_annot_id_list(ctx, page); int i = 0; PyObject *stem_id = NULL; while (1) { stem_id = PyUnicode_FromFormat("%s-%s%d", JM_annot_id_stem, stem, i); if (!PySequence_Contains(names, stem_id)) break; i += 1; Py_DECREF(stem_id); } char *response = JM_StrAsChar(stem_id); pdf_obj *name = pdf_new_string(ctx, (const char *) response, strlen(response)); pdf_dict_puts_drop(ctx, annot_obj, "NM", name); Py_CLEAR(stem_id); Py_CLEAR(names); page->doc->resynth_required = 0; } fz_catch(ctx) { fz_rethrow(ctx); } } //------------------------------------------------------------------------ // retrieve annot by name (/NM key) //------------------------------------------------------------------------ pdf_annot *JM_get_annot_by_name(fz_context *ctx, pdf_page *page, char *name) { if (!name || strlen(name) == 0) { return NULL; } pdf_annot *annot = NULL; int found = 0; size_t len = 0; fz_try(ctx) { // loop thru MuPDF's internal annots and widget arrays annot = pdf_first_annot(ctx, page); while (annot) { pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); const char *response = pdf_to_string(ctx, pdf_dict_gets(ctx, annot_obj, "NM"), &len); if (strcmp(name, response) == 0) { found = 1; break; } annot = pdf_next_annot(ctx, annot); } if (!found) { fz_throw(ctx, FZ_ERROR_GENERIC, "'%s' is not an annot of this page", name); } } fz_catch(ctx) { fz_rethrow(ctx); } return pdf_keep_annot(ctx, annot); } //------------------------------------------------------------------------ // retrieve annot by its xref //------------------------------------------------------------------------ pdf_annot *JM_get_annot_by_xref(fz_context *ctx, pdf_page *page, int xref) { pdf_annot *annot = NULL; int found = 0; fz_try(ctx) { // loop thru MuPDF's internal annots array annot = pdf_first_annot(ctx, page); while (annot) { pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); if (xref == pdf_to_num(ctx, annot_obj)) { found = 1; break; } annot = pdf_next_annot(ctx, annot); } if (!found) { fz_throw(ctx, FZ_ERROR_GENERIC, "xref %d is not an annot of this page", xref); } } fz_catch(ctx) { fz_rethrow(ctx); } return pdf_keep_annot(ctx, annot); } //------------------------------------------------------------------------ // retrieve widget by its xref //------------------------------------------------------------------------ pdf_annot *JM_get_widget_by_xref(fz_context *ctx, pdf_page *page, int xref) { pdf_annot *annot = NULL; int found = 0; fz_try(ctx) { // loop thru MuPDF's internal annots array annot = pdf_first_widget(ctx, page); while (annot) { pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); if (xref == pdf_to_num(ctx, annot_obj)) { found = 1; break; } annot = pdf_next_widget(ctx, annot); } if (!found) { fz_throw(ctx, FZ_ERROR_GENERIC, "xref %d is not a widget of this page", xref); } } fz_catch(ctx) { fz_rethrow(ctx); } return pdf_keep_annot(ctx, annot); } %} ================================================ FILE: src_classic/helper-convert.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //----------------------------------------------------------------------------- // Convert any MuPDF document to a PDF // Returns bytes object containing the PDF, created via 'write' function. //----------------------------------------------------------------------------- PyObject *JM_convert_to_pdf(fz_context *ctx, fz_document *doc, int fp, int tp, int rotate) { pdf_document *pdfout = pdf_create_document(ctx); // new PDF document int i, incr = 1, s = fp, e = tp; if (fp > tp) { incr = -1; // count backwards s = tp; // adjust ... e = fp; // ... range } fz_rect mediabox; int rot = JM_norm_rotation(rotate); fz_device *dev = NULL; fz_buffer *contents = NULL; pdf_obj *resources = NULL; fz_page *page=NULL; fz_var(dev); fz_var(contents); fz_var(resources); fz_var(page); for (i = fp; INRANGE(i, s, e); i += incr) { // interpret & write document pages as PDF pages fz_try(ctx) { page = fz_load_page(ctx, doc, i); mediabox = fz_bound_page(ctx, page); dev = pdf_page_write(ctx, pdfout, mediabox, &resources, &contents); fz_run_page(ctx, page, dev, fz_identity, NULL); fz_close_device(ctx, dev); fz_drop_device(ctx, dev); dev = NULL; pdf_obj *page_obj = pdf_add_page(ctx, pdfout, mediabox, rot, resources, contents); pdf_insert_page(ctx, pdfout, -1, page_obj); pdf_drop_obj(ctx, page_obj); } fz_always(ctx) { pdf_drop_obj(ctx, resources); fz_drop_buffer(ctx, contents); fz_drop_device(ctx, dev); fz_drop_page(ctx, page); page = NULL; dev = NULL; contents = NULL; resources = NULL; } fz_catch(ctx) { fz_rethrow(ctx); } } // PDF created - now write it to Python bytearray PyObject *r = NULL; fz_output *out = NULL; fz_buffer *res = NULL; // prepare write options structure pdf_write_options opts = { 0 }; opts.do_garbage = 4; opts.do_compress = 1; opts.do_compress_images = 1; opts.do_compress_fonts = 1; opts.do_sanitize = 1; opts.do_incremental = 0; opts.do_ascii = 0; opts.do_decompress = 0; opts.do_linear = 0; opts.do_clean = 1; opts.do_pretty = 0; fz_try(ctx) { res = fz_new_buffer(ctx, 8192); out = fz_new_output_with_buffer(ctx, res); pdf_write_document(ctx, pdfout, out, &opts); unsigned char *c = NULL; size_t len = fz_buffer_storage(ctx, res, &c); r = PyBytes_FromStringAndSize((const char *) c, (Py_ssize_t) len); } fz_always(ctx) { pdf_drop_document(ctx, pdfout); fz_drop_output(ctx, out); fz_drop_buffer(ctx, res); } fz_catch(ctx) { fz_rethrow(ctx); } return r; } %} ================================================ FILE: src_classic/helper-defines.i ================================================ %inline %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //---------------------------------------------------------------------------- // general //---------------------------------------------------------------------------- #define EPSILON 1e-5 //---------------------------------------------------------------------------- // annotation types //---------------------------------------------------------------------------- #define PDF_ANNOT_TEXT 0 #define PDF_ANNOT_LINK 1 #define PDF_ANNOT_FREE_TEXT 2 #define PDF_ANNOT_LINE 3 #define PDF_ANNOT_SQUARE 4 #define PDF_ANNOT_CIRCLE 5 #define PDF_ANNOT_POLYGON 6 #define PDF_ANNOT_POLY_LINE 7 #define PDF_ANNOT_HIGHLIGHT 8 #define PDF_ANNOT_UNDERLINE 9 #define PDF_ANNOT_SQUIGGLY 10 #define PDF_ANNOT_STRIKE_OUT 11 #define PDF_ANNOT_REDACT 12 #define PDF_ANNOT_STAMP 13 #define PDF_ANNOT_CARET 14 #define PDF_ANNOT_INK 15 #define PDF_ANNOT_POPUP 16 #define PDF_ANNOT_FILE_ATTACHMENT 17 #define PDF_ANNOT_SOUND 18 #define PDF_ANNOT_MOVIE 19 #define PDF_ANNOT_RICH_MEDIA 20 #define PDF_ANNOT_WIDGET 21 #define PDF_ANNOT_SCREEN 22 #define PDF_ANNOT_PRINTER_MARK 23 #define PDF_ANNOT_TRAP_NET 24 #define PDF_ANNOT_WATERMARK 25 #define PDF_ANNOT_3D 26 #define PDF_ANNOT_PROJECTION 27 #define PDF_ANNOT_UNKNOWN -1 //------------------------ // redaction annot options //------------------------ #define PDF_REDACT_IMAGE_NONE 0 #define PDF_REDACT_IMAGE_REMOVE 1 #define PDF_REDACT_IMAGE_PIXELS 2 //---------------------------------------------------------------------------- // annotation flag bits //---------------------------------------------------------------------------- #define PDF_ANNOT_IS_INVISIBLE 1 << (1-1) #define PDF_ANNOT_IS_HIDDEN 1 << (2-1) #define PDF_ANNOT_IS_PRINT 1 << (3-1) #define PDF_ANNOT_IS_NO_ZOOM 1 << (4-1) #define PDF_ANNOT_IS_NO_ROTATE 1 << (5-1) #define PDF_ANNOT_IS_NO_VIEW 1 << (6-1) #define PDF_ANNOT_IS_READ_ONLY 1 << (7-1) #define PDF_ANNOT_IS_LOCKED 1 << (8-1) #define PDF_ANNOT_IS_TOGGLE_NO_VIEW 1 << (9-1) #define PDF_ANNOT_IS_LOCKED_CONTENTS 1 << (10-1) //---------------------------------------------------------------------------- // annotation line ending styles //---------------------------------------------------------------------------- #define PDF_ANNOT_LE_NONE 0 #define PDF_ANNOT_LE_SQUARE 1 #define PDF_ANNOT_LE_CIRCLE 2 #define PDF_ANNOT_LE_DIAMOND 3 #define PDF_ANNOT_LE_OPEN_ARROW 4 #define PDF_ANNOT_LE_CLOSED_ARROW 5 #define PDF_ANNOT_LE_BUTT 6 #define PDF_ANNOT_LE_R_OPEN_ARROW 7 #define PDF_ANNOT_LE_R_CLOSED_ARROW 8 #define PDF_ANNOT_LE_SLASH 9 //---------------------------------------------------------------------------- // annotation field (widget) types //---------------------------------------------------------------------------- #define PDF_WIDGET_TYPE_UNKNOWN 0 #define PDF_WIDGET_TYPE_BUTTON 1 #define PDF_WIDGET_TYPE_CHECKBOX 2 #define PDF_WIDGET_TYPE_COMBOBOX 3 #define PDF_WIDGET_TYPE_LISTBOX 4 #define PDF_WIDGET_TYPE_RADIOBUTTON 5 #define PDF_WIDGET_TYPE_SIGNATURE 6 #define PDF_WIDGET_TYPE_TEXT 7 //---------------------------------------------------------------------------- // annotation text widget subtypes //---------------------------------------------------------------------------- #define PDF_WIDGET_TX_FORMAT_NONE 0 #define PDF_WIDGET_TX_FORMAT_NUMBER 1 #define PDF_WIDGET_TX_FORMAT_SPECIAL 2 #define PDF_WIDGET_TX_FORMAT_DATE 3 #define PDF_WIDGET_TX_FORMAT_TIME 4 //---------------------------------------------------------------------------- // annotation widget flags //---------------------------------------------------------------------------- // Common to all field types #define PDF_FIELD_IS_READ_ONLY 1 #define PDF_FIELD_IS_REQUIRED 1 << 1 #define PDF_FIELD_IS_NO_EXPORT 1 << 2 // Text fields #define PDF_TX_FIELD_IS_MULTILINE 1 << 12 #define PDF_TX_FIELD_IS_PASSWORD 1 << 13 #define PDF_TX_FIELD_IS_FILE_SELECT 1 << 20 #define PDF_TX_FIELD_IS_DO_NOT_SPELL_CHECK 1 << 22 #define PDF_TX_FIELD_IS_DO_NOT_SCROLL 1 << 23 #define PDF_TX_FIELD_IS_COMB 1 << 24 #define PDF_TX_FIELD_IS_RICH_TEXT 1 << 25 // Button fields #define PDF_BTN_FIELD_IS_NO_TOGGLE_TO_OFF 1 << 14 #define PDF_BTN_FIELD_IS_RADIO 1 << 15 #define PDF_BTN_FIELD_IS_PUSHBUTTON 1 << 16 #define PDF_BTN_FIELD_IS_RADIOS_IN_UNISON 1 << 25 // Choice fields #define PDF_CH_FIELD_IS_COMBO 1 << 17 #define PDF_CH_FIELD_IS_EDIT 1 << 18 #define PDF_CH_FIELD_IS_SORT 1 << 19 #define PDF_CH_FIELD_IS_MULTI_SELECT 1 << 21 #define PDF_CH_FIELD_IS_DO_NOT_SPELL_CHECK 1 << 22 #define PDF_CH_FIELD_IS_COMMIT_ON_SEL_CHANGE 1 << 25 // Signature fields errors #define PDF_SIGNATURE_ERROR_OKAY 0 #define PDF_SIGNATURE_ERROR_NO_SIGNATURES 1 #define PDF_SIGNATURE_ERROR_NO_CERTIFICATE 2 #define PDF_SIGNATURE_ERROR_DIGEST_FAILURE 3 #define PDF_SIGNATURE_ERROR_SELF_SIGNED 4 #define PDF_SIGNATURE_ERROR_SELF_SIGNED_IN_CHAIN 5 #define PDF_SIGNATURE_ERROR_NOT_TRUSTED 6 #define PDF_SIGNATURE_ERROR_UNKNOWN 7 // Signature appearances #define PDF_SIGNATURE_SHOW_LABELS 1 #define PDF_SIGNATURE_SHOW_DN 2 #define PDF_SIGNATURE_SHOW_DATE 4 #define PDF_SIGNATURE_SHOW_TEXT_NAME 8 #define PDF_SIGNATURE_SHOW_GRAPHIC_NAME 16 #define PDF_SIGNATURE_SHOW_LOGO 32 #define PDF_SIGNATURE_DEFAULT_APPEARANCE ( \ PDF_SIGNATURE_SHOW_LABELS | \ PDF_SIGNATURE_SHOW_DN | \ PDF_SIGNATURE_SHOW_DATE | \ PDF_SIGNATURE_SHOW_TEXT_NAME | \ PDF_SIGNATURE_SHOW_GRAPHIC_NAME | \ PDF_SIGNATURE_SHOW_LOGO ) //---------------------------------------------------------------------------- // colorspace identifiers //---------------------------------------------------------------------------- #define CS_RGB 1 #define CS_GRAY 2 #define CS_CMYK 3 //---------------------------------------------------------------------------- // PDF encryption algorithms //---------------------------------------------------------------------------- #define PDF_ENCRYPT_KEEP 0 #define PDF_ENCRYPT_NONE 1 #define PDF_ENCRYPT_RC4_40 2 #define PDF_ENCRYPT_RC4_128 3 #define PDF_ENCRYPT_AES_128 4 #define PDF_ENCRYPT_AES_256 5 #define PDF_ENCRYPT_UNKNOWN 6 //---------------------------------------------------------------------------- // PDF permission codes //---------------------------------------------------------------------------- #define PDF_PERM_PRINT 1 << 2 #define PDF_PERM_MODIFY 1 << 3 #define PDF_PERM_COPY 1 << 4 #define PDF_PERM_ANNOTATE 1 << 5 #define PDF_PERM_FORM 1 << 8 #define PDF_PERM_ACCESSIBILITY 1 << 9 #define PDF_PERM_ASSEMBLE 1 << 10 #define PDF_PERM_PRINT_HQ 1 << 11 //---------------------------------------------------------------------------- // PDF Blend Modes //---------------------------------------------------------------------------- #define PDF_BM_Color "Color" #define PDF_BM_ColorBurn "ColorBurn" #define PDF_BM_ColorDodge "ColorDodge" #define PDF_BM_Darken "Darken" #define PDF_BM_Difference "Difference" #define PDF_BM_Exclusion "Exclusion" #define PDF_BM_HardLight "HardLight" #define PDF_BM_Hue "Hue" #define PDF_BM_Lighten "Lighten" #define PDF_BM_Luminosity "Luminosity" #define PDF_BM_Multiply "Multiply" #define PDF_BM_Normal "Normal" #define PDF_BM_Overlay "Overlay" #define PDF_BM_Saturation "Saturation" #define PDF_BM_Screen "Screen" #define PDF_BM_SoftLight "Softlight" // General text flags #define TEXT_FONT_SUPERSCRIPT 1 #define TEXT_FONT_ITALIC 2 #define TEXT_FONT_SERIFED 4 #define TEXT_FONT_MONOSPACED 8 #define TEXT_FONT_BOLD 16 // UCDN Script codes #define UCDN_SCRIPT_COMMON 0 #define UCDN_SCRIPT_LATIN 1 #define UCDN_SCRIPT_GREEK 2 #define UCDN_SCRIPT_CYRILLIC 3 #define UCDN_SCRIPT_ARMENIAN 4 #define UCDN_SCRIPT_HEBREW 5 #define UCDN_SCRIPT_ARABIC 6 #define UCDN_SCRIPT_SYRIAC 7 #define UCDN_SCRIPT_THAANA 8 #define UCDN_SCRIPT_DEVANAGARI 9 #define UCDN_SCRIPT_BENGALI 10 #define UCDN_SCRIPT_GURMUKHI 11 #define UCDN_SCRIPT_GUJARATI 12 #define UCDN_SCRIPT_ORIYA 13 #define UCDN_SCRIPT_TAMIL 14 #define UCDN_SCRIPT_TELUGU 15 #define UCDN_SCRIPT_KANNADA 16 #define UCDN_SCRIPT_MALAYALAM 17 #define UCDN_SCRIPT_SINHALA 18 #define UCDN_SCRIPT_THAI 19 #define UCDN_SCRIPT_LAO 20 #define UCDN_SCRIPT_TIBETAN 21 #define UCDN_SCRIPT_MYANMAR 22 #define UCDN_SCRIPT_GEORGIAN 23 #define UCDN_SCRIPT_HANGUL 24 #define UCDN_SCRIPT_ETHIOPIC 25 #define UCDN_SCRIPT_CHEROKEE 26 #define UCDN_SCRIPT_CANADIAN_ABORIGINAL 27 #define UCDN_SCRIPT_OGHAM 28 #define UCDN_SCRIPT_RUNIC 29 #define UCDN_SCRIPT_KHMER 30 #define UCDN_SCRIPT_MONGOLIAN 31 #define UCDN_SCRIPT_HIRAGANA 32 #define UCDN_SCRIPT_KATAKANA 33 #define UCDN_SCRIPT_BOPOMOFO 34 #define UCDN_SCRIPT_HAN 35 #define UCDN_SCRIPT_YI 36 #define UCDN_SCRIPT_OLD_ITALIC 37 #define UCDN_SCRIPT_GOTHIC 38 #define UCDN_SCRIPT_DESERET 39 #define UCDN_SCRIPT_INHERITED 40 #define UCDN_SCRIPT_TAGALOG 41 #define UCDN_SCRIPT_HANUNOO 42 #define UCDN_SCRIPT_BUHID 43 #define UCDN_SCRIPT_TAGBANWA 44 #define UCDN_SCRIPT_LIMBU 45 #define UCDN_SCRIPT_TAI_LE 46 #define UCDN_SCRIPT_LINEAR_B 47 #define UCDN_SCRIPT_UGARITIC 48 #define UCDN_SCRIPT_SHAVIAN 49 #define UCDN_SCRIPT_OSMANYA 50 #define UCDN_SCRIPT_CYPRIOT 51 #define UCDN_SCRIPT_BRAILLE 52 #define UCDN_SCRIPT_BUGINESE 53 #define UCDN_SCRIPT_COPTIC 54 #define UCDN_SCRIPT_NEW_TAI_LUE 55 #define UCDN_SCRIPT_GLAGOLITIC 56 #define UCDN_SCRIPT_TIFINAGH 57 #define UCDN_SCRIPT_SYLOTI_NAGRI 58 #define UCDN_SCRIPT_OLD_PERSIAN 59 #define UCDN_SCRIPT_KHAROSHTHI 60 #define UCDN_SCRIPT_BALINESE 61 #define UCDN_SCRIPT_CUNEIFORM 62 #define UCDN_SCRIPT_PHOENICIAN 63 #define UCDN_SCRIPT_PHAGS_PA 64 #define UCDN_SCRIPT_NKO 65 #define UCDN_SCRIPT_SUNDANESE 66 #define UCDN_SCRIPT_LEPCHA 67 #define UCDN_SCRIPT_OL_CHIKI 68 #define UCDN_SCRIPT_VAI 69 #define UCDN_SCRIPT_SAURASHTRA 70 #define UCDN_SCRIPT_KAYAH_LI 71 #define UCDN_SCRIPT_REJANG 72 #define UCDN_SCRIPT_LYCIAN 73 #define UCDN_SCRIPT_CARIAN 74 #define UCDN_SCRIPT_LYDIAN 75 #define UCDN_SCRIPT_CHAM 76 #define UCDN_SCRIPT_TAI_THAM 77 #define UCDN_SCRIPT_TAI_VIET 78 #define UCDN_SCRIPT_AVESTAN 79 #define UCDN_SCRIPT_EGYPTIAN_HIEROGLYPHS 80 #define UCDN_SCRIPT_SAMARITAN 81 #define UCDN_SCRIPT_LISU 82 #define UCDN_SCRIPT_BAMUM 83 #define UCDN_SCRIPT_JAVANESE 84 #define UCDN_SCRIPT_MEETEI_MAYEK 85 #define UCDN_SCRIPT_IMPERIAL_ARAMAIC 86 #define UCDN_SCRIPT_OLD_SOUTH_ARABIAN 87 #define UCDN_SCRIPT_INSCRIPTIONAL_PARTHIAN 88 #define UCDN_SCRIPT_INSCRIPTIONAL_PAHLAVI 89 #define UCDN_SCRIPT_OLD_TURKIC 90 #define UCDN_SCRIPT_KAITHI 91 #define UCDN_SCRIPT_BATAK 92 #define UCDN_SCRIPT_BRAHMI 93 #define UCDN_SCRIPT_MANDAIC 94 #define UCDN_SCRIPT_CHAKMA 95 #define UCDN_SCRIPT_MEROITIC_CURSIVE 96 #define UCDN_SCRIPT_MEROITIC_HIEROGLYPHS 97 #define UCDN_SCRIPT_MIAO 98 #define UCDN_SCRIPT_SHARADA 99 #define UCDN_SCRIPT_SORA_SOMPENG 100 #define UCDN_SCRIPT_TAKRI 101 #define UCDN_SCRIPT_UNKNOWN 102 #define UCDN_SCRIPT_BASSA_VAH 103 #define UCDN_SCRIPT_CAUCASIAN_ALBANIAN 104 #define UCDN_SCRIPT_DUPLOYAN 105 #define UCDN_SCRIPT_ELBASAN 106 #define UCDN_SCRIPT_GRANTHA 107 #define UCDN_SCRIPT_KHOJKI 108 #define UCDN_SCRIPT_KHUDAWADI 109 #define UCDN_SCRIPT_LINEAR_A 110 #define UCDN_SCRIPT_MAHAJANI 111 #define UCDN_SCRIPT_MANICHAEAN 112 #define UCDN_SCRIPT_MENDE_KIKAKUI 113 #define UCDN_SCRIPT_MODI 114 #define UCDN_SCRIPT_MRO 115 #define UCDN_SCRIPT_NABATAEAN 116 #define UCDN_SCRIPT_OLD_NORTH_ARABIAN 117 #define UCDN_SCRIPT_OLD_PERMIC 118 #define UCDN_SCRIPT_PAHAWH_HMONG 119 #define UCDN_SCRIPT_PALMYRENE 120 #define UCDN_SCRIPT_PAU_CIN_HAU 121 #define UCDN_SCRIPT_PSALTER_PAHLAVI 122 #define UCDN_SCRIPT_SIDDHAM 123 #define UCDN_SCRIPT_TIRHUTA 124 #define UCDN_SCRIPT_WARANG_CITI 125 #define UCDN_SCRIPT_AHOM 126 #define UCDN_SCRIPT_ANATOLIAN_HIEROGLYPHS 127 #define UCDN_SCRIPT_HATRAN 128 #define UCDN_SCRIPT_MULTANI 129 #define UCDN_SCRIPT_OLD_HUNGARIAN 130 #define UCDN_SCRIPT_SIGNWRITING 131 #define UCDN_SCRIPT_ADLAM 132 #define UCDN_SCRIPT_BHAIKSUKI 133 #define UCDN_SCRIPT_MARCHEN 134 #define UCDN_SCRIPT_NEWA 135 #define UCDN_SCRIPT_OSAGE 136 #define UCDN_SCRIPT_TANGUT 137 #define UCDN_SCRIPT_MASARAM_GONDI 138 #define UCDN_SCRIPT_NUSHU 139 #define UCDN_SCRIPT_SOYOMBO 140 #define UCDN_SCRIPT_ZANABAZAR_SQUARE 141 #define UCDN_SCRIPT_DOGRA 142 #define UCDN_SCRIPT_GUNJALA_GONDI 143 #define UCDN_SCRIPT_HANIFI_ROHINGYA 144 #define UCDN_SCRIPT_MAKASAR 145 #define UCDN_SCRIPT_MEDEFAIDRIN 146 #define UCDN_SCRIPT_OLD_SOGDIAN 147 #define UCDN_SCRIPT_SOGDIAN 148 #define UCDN_SCRIPT_ELYMAIC 149 #define UCDN_SCRIPT_NANDINAGARI 150 #define UCDN_SCRIPT_NYIAKENG_PUACHUE_HMONG 151 #define UCDN_SCRIPT_WANCHO 152 // exceptions PyObject *_set_FileDataError(PyObject *value) { if (!value) { Py_RETURN_FALSE; } JM_Exc_FileDataError = value; Py_RETURN_TRUE; } //------------------------------------------------------------------- // minor tools //------------------------------------------------------------------- PyObject *util_sine_between(PyObject *C, PyObject *P, PyObject *Q) { // for points C, P, Q compute the sine between lines CP and QP fz_point c = JM_point_from_py(C); fz_point p = JM_point_from_py(P); fz_point q = JM_point_from_py(Q); fz_point s = JM_normalize_vector(q.x - p.x, q.y - p.y); fz_matrix m1 = fz_make_matrix(1, 0, 0, 1, -p.x, -p.y); fz_matrix m2 = fz_make_matrix(s.x, -s.y, s.y, s.x, 0, 0); m1 = fz_concat(m1, m2); c = fz_transform_point(c, m1); c = JM_normalize_vector(c.x, c.y); return Py_BuildValue("f", c.y); } // Return the matrix that maps two points C, P to the x-axis such that // C -> (0,0) and the image of P have the same distance. PyObject *util_hor_matrix(PyObject *C, PyObject *P) { fz_point c = JM_point_from_py(C); fz_point p = JM_point_from_py(P); // compute (cosine, sine) of vector P-C with double precision: fz_point s = JM_normalize_vector(p.x - c.x, p.y - c.y); fz_matrix m1 = fz_make_matrix(1, 0, 0, 1, -c.x, -c.y); fz_matrix m2 = fz_make_matrix(s.x, -s.y, s.y, s.x, 0, 0); return JM_py_from_matrix(fz_concat(m1, m2)); } struct Annot; // Ensure that widgets with /AA/C JavaScript are in array AcroForm/CO struct Annot; PyObject *util_ensure_widget_calc(struct Annot *annot) { pdf_obj *PDFNAME_CO=NULL; fz_try(gctx) { pdf_obj *annot_obj = pdf_annot_obj(gctx, (pdf_annot *) annot); pdf_document *pdf = pdf_get_bound_document(gctx, annot_obj); PDFNAME_CO = pdf_new_name(gctx, "CO"); // = PDF_NAME(CO) pdf_obj *acro = pdf_dict_getl(gctx, // get AcroForm dict pdf_trailer(gctx, pdf), PDF_NAME(Root), PDF_NAME(AcroForm), NULL); pdf_obj *CO = pdf_dict_get(gctx, acro, PDFNAME_CO); // = AcroForm/CO if (!CO) { CO = pdf_dict_put_array(gctx, acro, PDFNAME_CO, 2); } int i, n = pdf_array_len(gctx, CO); int xref, nxref, found = 0; xref = pdf_to_num(gctx, annot_obj); for (i = 0; i < n; i++) { nxref = pdf_to_num(gctx, pdf_array_get(gctx, CO, i)); if (xref == nxref) { found = 1; break; } } if (!found) { pdf_array_push_drop(gctx, CO, pdf_new_indirect(gctx, pdf, xref, 0)); } } fz_always(gctx) { pdf_drop_obj(gctx, PDFNAME_CO); } fz_catch(gctx) { PyErr_SetString(PyExc_RuntimeError, fz_caught_message(gctx)); return NULL; } Py_RETURN_NONE; } //----------------------------------------------------------- // Compute Rect coordinates using different alternatives //----------------------------------------------------------- PyObject *util_make_rect(PyObject *a) { Py_ssize_t i, n = PyTuple_GET_SIZE(a); PyObject *p1, *p2, *l = a; char *msg = "Rect: bad args"; double c[4] = { 0, 0, 0, 0 }; switch (n) { case 0: goto exit_normal; case 1: goto size1; case 2: goto size2; case 3: goto size31; case 4: goto size4; default: msg = "Rect: bad seq len"; goto exit_error; } size4:; for (i = 0; i < 4; i++) { if (JM_FLOAT_ITEM(l, i, &c[i]) == 1) { goto exit_error; } } goto exit_normal; size1:; l = PyTuple_GET_ITEM(a, 0); if (!PySequence_Check(l) || PySequence_Size(l) != 4) { msg = "Rect: bad seq len"; goto exit_error; } goto size4; size2:; msg = "Rect: bad args"; p1 = PyTuple_GET_ITEM(a, 0); p2 = PyTuple_GET_ITEM(a, 1); if (!PySequence_Check(p1) || PySequence_Size(p1) != 2) { goto exit_error; } if (!PySequence_Check(p2) || PySequence_Size(p2) != 2) { goto exit_error; } if (JM_FLOAT_ITEM(p1, 0, &c[0]) == 1) goto exit_error; if (JM_FLOAT_ITEM(p1, 1, &c[1]) == 1) goto exit_error; if (JM_FLOAT_ITEM(p2, 0, &c[2]) == 1) goto exit_error; if (JM_FLOAT_ITEM(p2, 1, &c[3]) == 1) goto exit_error; goto exit_normal; size31:; p1 = PyTuple_GET_ITEM(a, 0); if (PySequence_Check(p1)) goto size32; if (JM_FLOAT_ITEM(a, 0, &c[0]) == 1) goto exit_error; if (JM_FLOAT_ITEM(a, 1, &c[1]) == 1) goto exit_error; p2 = PyTuple_GET_ITEM(a, 2); if (!PySequence_Check(p2) || PySequence_Size(p2) != 2) { goto exit_error; } if (JM_FLOAT_ITEM(p2, 0, &c[2]) == 1) goto exit_error; if (JM_FLOAT_ITEM(p2, 1, &c[3]) == 1) goto exit_error; goto exit_normal; size32:; if (PySequence_Size(p1) != 2) goto exit_error; if (JM_FLOAT_ITEM(p1, 0, &c[0]) == 1) goto exit_error; if (JM_FLOAT_ITEM(p1, 1, &c[1]) == 1) goto exit_error; if (JM_FLOAT_ITEM(a, 1, &c[2]) == 1) goto exit_error; if (JM_FLOAT_ITEM(a, 2, &c[3]) == 1) goto exit_error; goto exit_normal; exit_normal:; for (i = 0; i < 4; i++) { if (c[i] < FZ_MIN_INF_RECT) c[i] = FZ_MIN_INF_RECT; if (c[i] > FZ_MAX_INF_RECT) c[i] = FZ_MAX_INF_RECT; } return Py_BuildValue("dddd", c[0], c[1], c[2], c[3]); exit_error:; PyErr_SetString(PyExc_ValueError, msg); return NULL; } //----------------------------------------------------------- // Compute IRect coordinates using different alternatives //----------------------------------------------------------- PyObject *util_make_irect(PyObject *a) { Py_ssize_t i, n = PyTuple_GET_SIZE(a); PyObject *p1, *p2, *l = a; char *msg = "IRect: bad args"; int c[4] = { 0, 0, 0, 0 }; switch (n) { case 0: goto exit_normal; case 1: goto size1; case 2: goto size2; case 3: goto size31; case 4: goto size4; default: msg = "IRect: bad seq len"; goto exit_error; } size4:; for (i = 0; i < 4; i++) { if (JM_INT_ITEM(l, i, &c[i]) == 1) { goto exit_error; } } goto exit_normal; size1:; l = PyTuple_GET_ITEM(a, 0); if (!PySequence_Check(l) || PySequence_Size(l) != 4) { msg = "IRect: bad seq len"; goto exit_error; } goto size4; size2:; p1 = PyTuple_GET_ITEM(a, 0); p2 = PyTuple_GET_ITEM(a, 1); if (!PySequence_Check(p1) || PySequence_Size(p1) != 2) { goto exit_error; } if (!PySequence_Check(p2) || PySequence_Size(p2) != 2) { goto exit_error; } msg = "IRect: bad int values"; if (JM_INT_ITEM(p1, 0, &c[0]) == 1) goto exit_error; if (JM_INT_ITEM(p1, 1, &c[1]) == 1) goto exit_error; if (JM_INT_ITEM(p2, 0, &c[2]) == 1) goto exit_error; if (JM_INT_ITEM(p2, 1, &c[3]) == 1) goto exit_error; goto exit_normal; size31:; p1 = PyTuple_GET_ITEM(a, 0); if (PySequence_Check(p1)) goto size32; if (JM_INT_ITEM(a, 0, &c[0]) == 1) goto exit_error; if (JM_INT_ITEM(a, 1, &c[1]) == 1) goto exit_error; p2 = PyTuple_GET_ITEM(a, 2); if (!PySequence_Check(p2) || PySequence_Size(p2) != 2) { goto exit_error; } if (JM_INT_ITEM(p2, 0, &c[2]) == 1) goto exit_error; if (JM_INT_ITEM(p2, 1, &c[3]) == 1) goto exit_error; goto exit_normal; size32:; if (PySequence_Size(p1) != 2) goto exit_error; if (JM_INT_ITEM(p1, 0, &c[0]) == 1) goto exit_error; if (JM_INT_ITEM(p1, 1, &c[1]) == 1) goto exit_error; if (JM_INT_ITEM(a, 1, &c[2]) == 1) goto exit_error; if (JM_INT_ITEM(a, 2, &c[3]) == 1) goto exit_error; goto exit_normal; exit_normal:; for (i = 0; i < 4; i++) { if (c[i] < FZ_MIN_INF_RECT) c[i] = FZ_MIN_INF_RECT; if (c[i] > FZ_MAX_INF_RECT) c[i] = FZ_MAX_INF_RECT; } return Py_BuildValue("iiii", c[0], c[1], c[2], c[3]); exit_error:; PyErr_SetString(PyExc_ValueError, msg); return NULL; } PyObject *util_round_rect(PyObject *rect) { return JM_py_from_irect(fz_round_rect(JM_rect_from_py(rect))); } PyObject *util_transform_rect(PyObject *rect, PyObject *matrix) { return JM_py_from_rect(fz_transform_rect(JM_rect_from_py(rect), JM_matrix_from_py(matrix))); } PyObject *util_intersect_rect(PyObject *r1, PyObject *r2) { return JM_py_from_rect(fz_intersect_rect(JM_rect_from_py(r1), JM_rect_from_py(r2))); } PyObject *util_is_point_in_rect(PyObject *p, PyObject *r) { return JM_BOOL(fz_is_point_inside_rect(JM_point_from_py(p), JM_rect_from_py(r))); } PyObject *util_include_point_in_rect(PyObject *r, PyObject *p) { return JM_py_from_rect(fz_include_point_in_rect(JM_rect_from_py(r), JM_point_from_py(p))); } PyObject *util_point_in_quad(PyObject *P, PyObject *Q) { fz_point p = JM_point_from_py(P); fz_quad q = JM_quad_from_py(Q); return JM_BOOL(fz_is_point_inside_quad(p, q)); } PyObject *util_transform_point(PyObject *point, PyObject *matrix) { return JM_py_from_point(fz_transform_point(JM_point_from_py(point), JM_matrix_from_py(matrix))); } PyObject *util_union_rect(PyObject *r1, PyObject *r2) { return JM_py_from_rect(fz_union_rect(JM_rect_from_py(r1), JM_rect_from_py(r2))); } PyObject *util_concat_matrix(PyObject *m1, PyObject *m2) { return JM_py_from_matrix(fz_concat(JM_matrix_from_py(m1), JM_matrix_from_py(m2))); } PyObject *util_invert_matrix(PyObject *matrix) { fz_matrix src = JM_matrix_from_py(matrix); float a = src.a; float det = a * src.d - src.b * src.c; if (det < -FLT_EPSILON || det > FLT_EPSILON) { fz_matrix dst; float rdet = 1 / det; dst.a = src.d * rdet; dst.b = -src.b * rdet; dst.c = -src.c * rdet; dst.d = a * rdet; a = -src.e * dst.a - src.f * dst.c; dst.f = -src.e * dst.b - src.f * dst.d; dst.e = a; return Py_BuildValue("iN", 0, JM_py_from_matrix(dst)); } return Py_BuildValue("(i, ())", 1); } PyObject *util_measure_string(const char *text, const char *fontname, double fontsize, int encoding) { double w = 0; fz_font *font = NULL; fz_try(gctx) { font = fz_new_base14_font(gctx, fontname); while (*text) { int c, g; text += fz_chartorune(&c, text); switch (encoding) { case PDF_SIMPLE_ENCODING_GREEK: c = fz_iso8859_7_from_unicode(c); break; case PDF_SIMPLE_ENCODING_CYRILLIC: c = fz_windows_1251_from_unicode(c); break; default: c = fz_windows_1252_from_unicode(c); break; } if (c < 0) c = 0xB7; g = fz_encode_character(gctx, font, c); w += (double) fz_advance_glyph(gctx, font, g, 0); } } fz_always(gctx) { fz_drop_font(gctx, font); } fz_catch(gctx) { return PyFloat_FromDouble(0); } return PyFloat_FromDouble(w * fontsize); } %} %{ // Global Constants - Python dictionary keys PyObject *dictkey_align; PyObject *dictkey_ascender; PyObject *dictkey_bbox; PyObject *dictkey_blocks; PyObject *dictkey_bpc; PyObject *dictkey_c; PyObject *dictkey_chars; PyObject *dictkey_color; PyObject *dictkey_colorspace; PyObject *dictkey_content; PyObject *dictkey_creationDate; PyObject *dictkey_cs_name; PyObject *dictkey_da; PyObject *dictkey_dashes; PyObject *dictkey_desc; PyObject *dictkey_descender; PyObject *dictkey_dir; PyObject *dictkey_effect; PyObject *dictkey_ext; PyObject *dictkey_filename; PyObject *dictkey_fill; PyObject *dictkey_flags; PyObject *dictkey_font; PyObject *dictkey_glyph; PyObject *dictkey_height; PyObject *dictkey_id; PyObject *dictkey_image; PyObject *dictkey_items; PyObject *dictkey_length; PyObject *dictkey_lines; PyObject *dictkey_matrix; PyObject *dictkey_modDate; PyObject *dictkey_name; PyObject *dictkey_number; PyObject *dictkey_origin; PyObject *dictkey_rect; PyObject *dictkey_size; PyObject *dictkey_smask; PyObject *dictkey_spans; PyObject *dictkey_stroke; PyObject *dictkey_style; PyObject *dictkey_subject; PyObject *dictkey_text; PyObject *dictkey_title; PyObject *dictkey_type; PyObject *dictkey_ufilename; PyObject *dictkey_width; PyObject *dictkey_wmode; PyObject *dictkey_xref; PyObject *dictkey_xres; PyObject *dictkey_yres; %} ================================================ FILE: src_classic/helper-devices.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ typedef struct { fz_device super; PyObject *out; size_t seqno; long depth; int clips; PyObject *method; } jm_lineart_device; static PyObject *dev_pathdict = NULL; static PyObject *scissors = NULL; static float dev_linewidth = 0; // border width if present static fz_matrix trace_device_ptm; // page transformation matrix static fz_matrix trace_device_ctm; // trace device matrix static fz_matrix trace_device_rot; static fz_point dev_lastpoint = {0, 0}; static fz_point dev_firstpoint = {0, 0}; static int dev_havemove = 0; static fz_rect dev_pathrect; static float dev_pathfactor = 0; static int dev_linecount = 0; static char *layer_name=NULL; // optional content name static int path_type = 0; // one of the following values: #define FILL_PATH 1 #define STROKE_PATH 2 #define CLIP_PATH 3 #define CLIP_STROKE_PATH 4 static void trace_device_reset() { Py_CLEAR(dev_pathdict); Py_CLEAR(scissors); layer_name = NULL; dev_linewidth = 0; trace_device_ptm = fz_identity; trace_device_ctm = fz_identity; trace_device_rot = fz_identity; dev_lastpoint.x = 0; dev_lastpoint.y = 0; dev_firstpoint.x = 0; dev_firstpoint.y = 0; dev_pathrect.x0 = 0; dev_pathrect.y0 = 0; dev_pathrect.x1 = 0; dev_pathrect.y1 = 0; dev_pathfactor = 0; dev_linecount = 0; path_type = 0; } // Every scissor of a clip is a sub rectangle of the preceeding clip // scissor if the clip level is larger. static fz_rect compute_scissor() { PyObject *last_scissor = NULL; fz_rect scissor; if (!scissors) { scissors = PyList_New(0); } Py_ssize_t num_scissors = PyList_Size(scissors); if (num_scissors > 0) { last_scissor = PyList_GET_ITEM(scissors, num_scissors-1); scissor = JM_rect_from_py(last_scissor); scissor = fz_intersect_rect(scissor, dev_pathrect); } else { scissor = dev_pathrect; } LIST_APPEND_DROP(scissors, JM_py_from_rect(scissor)); return scissor; } static void jm_increase_seqno(fz_context *ctx, fz_device *dev_, ...) { jm_lineart_device *dev = (jm_lineart_device *) dev_; dev->seqno += 1; } /* -------------------------------------------------------------------------- Check whether the last 4 lines represent a quad. Because of how we count, the lines are a polyline already, i.e. last point of a line equals 1st point of next line. So we check for a polygon (last line's end point equals start point). If not true we return 0. -------------------------------------------------------------------------- */ static int jm_checkquad() { PyObject *items = PyDict_GetItem(dev_pathdict, dictkey_items); Py_ssize_t i, len = PyList_Size(items); float f[8]; // coordinates of the 4 corners fz_point temp, lp; // line = (temp, lp) PyObject *rect; PyObject *line; // fill the 8 floats in f, start from items[-4:] for (i = 0; i < 4; i++) { // store line start points line = PyList_GET_ITEM(items, len - 4 + i); temp = JM_point_from_py(PyTuple_GET_ITEM(line, 1)); f[i * 2] = temp.x; f[i * 2 + 1] = temp.y; lp = JM_point_from_py(PyTuple_GET_ITEM(line, 2)); } if (lp.x != f[0] || lp.y != f[1]) { // not a polygon! //dev_linecount -= 1; return 0; } // we have detected a quad dev_linecount = 0; // reset this // a quad item is ("qu", (ul, ur, ll, lr)), where the tuple items // are pairs of floats representing a quad corner each. rect = PyTuple_New(2); PyTuple_SET_ITEM(rect, 0, PyUnicode_FromString("qu")); /* ---------------------------------------------------- * relationship of float array to quad points: * (0, 1) = ul, (2, 3) = ll, (6, 7) = ur, (4, 5) = lr ---------------------------------------------------- */ fz_quad q = fz_make_quad(f[0], f[1], f[6], f[7], f[2], f[3], f[4], f[5]); PyTuple_SET_ITEM(rect, 1, JM_py_from_quad(q)); PyList_SetItem(items, len - 4, rect); // replace item -4 by rect PyList_SetSlice(items, len - 3, len, NULL); // delete remaining 3 items return 1; } /* -------------------------------------------------------------------------- Check whether the last 3 path items represent a rectangle. Line 1 and 3 must be horizontal, line 2 must be vertical. Returns 1 if we have modified the path, otherwise 0. -------------------------------------------------------------------------- */ static int jm_checkrect() { dev_linecount = 0; // reset line count long orientation = 0; // area orientation of rectangle fz_point ll, lr, ur, ul; fz_rect r; PyObject *rect; PyObject *line0, *line2; PyObject *items = PyDict_GetItem(dev_pathdict, dictkey_items); Py_ssize_t len = PyList_Size(items); line0 = PyList_GET_ITEM(items, len - 3); ll = JM_point_from_py(PyTuple_GET_ITEM(line0, 1)); lr = JM_point_from_py(PyTuple_GET_ITEM(line0, 2)); // no need to extract "line1"! line2 = PyList_GET_ITEM(items, len - 1); ur = JM_point_from_py(PyTuple_GET_ITEM(line2, 1)); ul = JM_point_from_py(PyTuple_GET_ITEM(line2, 2)); /* --------------------------------------------------------------------- Assumption: When decomposing rects, MuPDF always starts with a horizontal line, followed by a vertical line, followed by a horizontal line. First line: (ll, lr), third line: (ul, ur). If 1st line is below 3rd line, we record anti-clockwise (+1), else clockwise (-1) orientation. --------------------------------------------------------------------- */ if (ll.y != lr.y || ll.x != ul.x || ur.y != ul.y || ur.x != lr.x) { goto drop_out; // not a rectangle } // we have a rect, replace last 3 "l" items by one "re" item. if (ul.y < lr.y) { r = fz_make_rect(ul.x, ul.y, lr.x, lr.y); orientation = 1; } else { r = fz_make_rect(ll.x, ll.y, ur.x, ur.y); orientation = -1; } rect = PyTuple_New(3); PyTuple_SET_ITEM(rect, 0, PyUnicode_FromString("re")); PyTuple_SET_ITEM(rect, 1, JM_py_from_rect(r)); PyTuple_SET_ITEM(rect, 2, PyLong_FromLong(orientation)); PyList_SetItem(items, len - 3, rect); // replace item -3 by rect PyList_SetSlice(items, len - 2, len, NULL); // delete remaining 2 items return 1; drop_out:; return 0; } static PyObject * jm_lineart_color(fz_context *ctx, fz_colorspace *colorspace, const float *color) { float rgb[3]; if (colorspace) { fz_convert_color(ctx, colorspace, color, fz_device_rgb(ctx), rgb, NULL, fz_default_color_params); return Py_BuildValue("fff", rgb[0], rgb[1], rgb[2]); } return PyTuple_New(0); } static void trace_moveto(fz_context *ctx, void *dev_, float x, float y) { dev_lastpoint = fz_transform_point(fz_make_point(x, y), trace_device_ctm); if (fz_is_infinite_rect(dev_pathrect)) { dev_pathrect = fz_make_rect(dev_lastpoint.x, dev_lastpoint.y, dev_lastpoint.x, dev_lastpoint.y); } dev_firstpoint = dev_lastpoint; dev_havemove = 1; dev_linecount = 0; // reset # of consec. lines } static void trace_lineto(fz_context *ctx, void *dev_, float x, float y) { fz_point p1 = fz_transform_point(fz_make_point(x, y), trace_device_ctm); dev_pathrect = fz_include_point_in_rect(dev_pathrect, p1); PyObject *list = PyTuple_New(3); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("l")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev_lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(p1)); dev_lastpoint = p1; PyObject *items = PyDict_GetItem(dev_pathdict, dictkey_items); LIST_APPEND_DROP(items, list); dev_linecount += 1; // counts consecutive lines if (dev_linecount == 4 && path_type != FILL_PATH) { // shrink to "re" or "qu" item jm_checkquad(); } } static void trace_curveto(fz_context *ctx, void *dev_, float x1, float y1, float x2, float y2, float x3, float y3) { dev_linecount = 0; // reset # of consec. lines fz_point p1 = fz_make_point(x1, y1); fz_point p2 = fz_make_point(x2, y2); fz_point p3 = fz_make_point(x3, y3); p1 = fz_transform_point(p1, trace_device_ctm); p2 = fz_transform_point(p2, trace_device_ctm); p3 = fz_transform_point(p3, trace_device_ctm); dev_pathrect = fz_include_point_in_rect(dev_pathrect, p1); dev_pathrect = fz_include_point_in_rect(dev_pathrect, p2); dev_pathrect = fz_include_point_in_rect(dev_pathrect, p3); PyObject *list = PyTuple_New(5); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("c")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev_lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(p1)); PyTuple_SET_ITEM(list, 3, JM_py_from_point(p2)); PyTuple_SET_ITEM(list, 4, JM_py_from_point(p3)); dev_lastpoint = p3; PyObject *items = PyDict_GetItem(dev_pathdict, dictkey_items); LIST_APPEND_DROP(items, list); } static void trace_close(fz_context *ctx, void *dev_) { if (dev_linecount == 3) { if (jm_checkrect()) { return; } } dev_linecount = 0; // reset # of consec. lines if (dev_havemove) { if (dev_firstpoint.x != dev_lastpoint.x || dev_firstpoint.y != dev_lastpoint.y) { PyObject *list = PyTuple_New(3); PyTuple_SET_ITEM(list, 0, PyUnicode_FromString("l")); PyTuple_SET_ITEM(list, 1, JM_py_from_point(dev_lastpoint)); PyTuple_SET_ITEM(list, 2, JM_py_from_point(dev_firstpoint)); dev_lastpoint = dev_firstpoint; PyObject *items = PyDict_GetItem(dev_pathdict, dictkey_items); LIST_APPEND_DROP(items, list); } dev_havemove = 0; DICT_SETITEMSTR_DROP(dev_pathdict, "closePath", JM_BOOL(0)); } else { DICT_SETITEMSTR_DROP(dev_pathdict, "closePath", JM_BOOL(1)); } } static const fz_path_walker trace_path_walker = { trace_moveto, trace_lineto, trace_curveto, trace_close }; /* --------------------------------------------------------------------- Create the "items" list of the path dictionary * either create or empty the path dictionary * reset the end point of the path * reset count of consecutive lines * invoke fz_walk_path(), which create the single items * if no items detected, empty path dict again --------------------------------------------------------------------- */ static void jm_lineart_path(fz_context *ctx, jm_lineart_device *dev, const fz_path *path) { dev_pathrect = fz_infinite_rect; dev_linecount = 0; dev_lastpoint = fz_make_point(0, 0); if (dev_pathdict) { Py_CLEAR(dev_pathdict); } dev_pathdict = PyDict_New(); DICT_SETITEM_DROP(dev_pathdict, dictkey_items, PyList_New(0)); fz_walk_path(ctx, path, &trace_path_walker, dev); // Check if any items were added ... if (!PyDict_GetItem(dev_pathdict, dictkey_items) || !PyList_Size(PyDict_GetItem(dev_pathdict, dictkey_items))) { Py_CLEAR(dev_pathdict); } } //--------------------------------------------------------------------------- // Append current path to list or merge into last path of the list. // (1) Append if first path, different item lists or not a 'stroke' version // of previous path // (2) If new path has the same items, merge its content into previous path // and change path["type"] to "fs". // (3) If "out" is callable, skip the previous and pass dictionary to it. //--------------------------------------------------------------------------- static void jm_append_merge(PyObject *out, PyObject *method) { if (PyCallable_Check(out) || method != Py_None) { // function or method goto callback; } Py_ssize_t len = PyList_Size(out); // len of output list so far if (len == 0) { // always append first path goto append; } const char *thistype = PyUnicode_AsUTF8(PyDict_GetItem(dev_pathdict, dictkey_type)); if (strcmp(thistype, "s") != 0) { // if not stroke, then append goto append; } PyObject *prev = PyList_GET_ITEM(out, len - 1); // get prev path const char *prevtype = PyUnicode_AsUTF8(PyDict_GetItem(prev, dictkey_type)); if (strcmp(prevtype, "f") != 0) { // if previous not fill, append goto append; } // last check: there must be the same list of items for "f" and "s". PyObject *previtems = PyDict_GetItem(prev, dictkey_items); PyObject *thisitems = PyDict_GetItem(dev_pathdict, dictkey_items); if (PyObject_RichCompareBool(previtems, thisitems, Py_NE)) { goto append; } int rc = PyDict_Merge(prev, dev_pathdict, 0); // merge with no override if (rc == 0) { DICT_SETITEM_DROP(prev, dictkey_type, PyUnicode_FromString("fs")); goto postappend; } else { PySys_WriteStderr("could not merge stroke and fill path"); goto append; } append:; PyList_Append(out, dev_pathdict); postappend:; Py_CLEAR(dev_pathdict); return; callback:; // callback function or method PyObject *resp = NULL; if (method == Py_None) { resp = PyObject_CallFunctionObjArgs(out, dev_pathdict, NULL); } else { resp = PyObject_CallMethodObjArgs(out, method, dev_pathdict, NULL); } if (resp) { Py_DECREF(resp); } else { PySys_WriteStderr("calling cdrawings callback function/method failed!"); PyErr_Clear(); } Py_CLEAR(dev_pathdict); return; } static void jm_lineart_fill_path(fz_context *ctx, fz_device *dev_, const fz_path *path, int even_odd, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *) dev_; PyObject *out = dev->out; trace_device_ctm = ctm; //fz_concat(ctm, trace_device_ptm); path_type = FILL_PATH; jm_lineart_path(ctx, dev, path); if (!dev_pathdict) { return; } DICT_SETITEM_DROP(dev_pathdict, dictkey_type, PyUnicode_FromString("f")); DICT_SETITEMSTR_DROP(dev_pathdict, "even_odd", JM_BOOL(even_odd)); DICT_SETITEMSTR_DROP(dev_pathdict, "fill_opacity", Py_BuildValue("f", alpha)); DICT_SETITEMSTR_DROP(dev_pathdict, "fill", jm_lineart_color(ctx, colorspace, color)); DICT_SETITEM_DROP(dev_pathdict, dictkey_rect, JM_py_from_rect(dev_pathrect)); DICT_SETITEMSTR_DROP(dev_pathdict, "seqno", PyLong_FromSize_t(dev->seqno)); DICT_SETITEMSTR_DROP(dev_pathdict, "layer", JM_UnicodeFromStr(layer_name)); if (dev->clips) { DICT_SETITEMSTR_DROP(dev_pathdict, "level", PyLong_FromLong(dev->depth)); } jm_append_merge(out, dev->method); dev->seqno += 1; } static void jm_lineart_stroke_path(fz_context *ctx, fz_device *dev_, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *)dev_; PyObject *out = dev->out; int i; dev_pathfactor = 1; if (fz_abs(ctm.a) == fz_abs(ctm.d)) { dev_pathfactor = fz_abs(ctm.a); } trace_device_ctm = ctm; // fz_concat(ctm, trace_device_ptm); path_type = STROKE_PATH; jm_lineart_path(ctx, dev, path); if (!dev_pathdict) { return; } DICT_SETITEM_DROP(dev_pathdict, dictkey_type, PyUnicode_FromString("s")); DICT_SETITEMSTR_DROP(dev_pathdict, "stroke_opacity", Py_BuildValue("f", alpha)); DICT_SETITEMSTR_DROP(dev_pathdict, "color", jm_lineart_color(ctx, colorspace, color)); DICT_SETITEM_DROP(dev_pathdict, dictkey_width, Py_BuildValue("f", dev_pathfactor * stroke->linewidth)); DICT_SETITEMSTR_DROP(dev_pathdict, "lineCap", Py_BuildValue("iii", stroke->start_cap, stroke->dash_cap, stroke->end_cap)); DICT_SETITEMSTR_DROP(dev_pathdict, "lineJoin", Py_BuildValue("f", dev_pathfactor * stroke->linejoin)); if (!PyDict_GetItemString(dev_pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev_pathdict, "closePath", JM_BOOL(0)); } // output the "dashes" string if (stroke->dash_len) { fz_buffer *buff = fz_new_buffer(ctx, 256); fz_append_string(ctx, buff, "[ "); // left bracket for (i = 0; i < stroke->dash_len; i++) { fz_append_printf(ctx, buff, "%g ", dev_pathfactor * stroke->dash_list[i]); } fz_append_printf(ctx, buff, "] %g", dev_pathfactor * stroke->dash_phase); DICT_SETITEMSTR_DROP(dev_pathdict, "dashes", JM_EscapeStrFromBuffer(ctx, buff)); fz_drop_buffer(ctx, buff); } else { DICT_SETITEMSTR_DROP(dev_pathdict, "dashes", PyUnicode_FromString("[] 0")); } DICT_SETITEM_DROP(dev_pathdict, dictkey_rect, JM_py_from_rect(dev_pathrect)); DICT_SETITEMSTR_DROP(dev_pathdict, "layer", JM_UnicodeFromStr(layer_name)); DICT_SETITEMSTR_DROP(dev_pathdict, "seqno", PyLong_FromSize_t(dev->seqno)); if (dev->clips) { DICT_SETITEMSTR_DROP(dev_pathdict, "level", PyLong_FromLong(dev->depth)); } // output the dict - potentially merging it with a previous fill_path twin jm_append_merge(out, dev->method); dev->seqno += 1; } static void jm_lineart_clip_path(fz_context *ctx, fz_device *dev_, const fz_path *path, int even_odd, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; trace_device_ctm = ctm; //fz_concat(ctm, trace_device_ptm); path_type = CLIP_PATH; jm_lineart_path(ctx, dev, path); if (!dev_pathdict) { return; } DICT_SETITEM_DROP(dev_pathdict, dictkey_type, PyUnicode_FromString("clip")); DICT_SETITEMSTR_DROP(dev_pathdict, "even_odd", JM_BOOL(even_odd)); if (!PyDict_GetItemString(dev_pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev_pathdict, "closePath", JM_BOOL(0)); } DICT_SETITEMSTR_DROP(dev_pathdict, "scissor", JM_py_from_rect(compute_scissor())); DICT_SETITEMSTR_DROP(dev_pathdict, "level", PyLong_FromLong(dev->depth)); DICT_SETITEMSTR_DROP(dev_pathdict, "layer", JM_UnicodeFromStr(layer_name)); jm_append_merge(out, dev->method); dev->depth++; } static void jm_lineart_clip_stroke_path(fz_context *ctx, fz_device *dev_, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; trace_device_ctm = ctm; //fz_concat(ctm, trace_device_ptm); path_type = CLIP_STROKE_PATH; jm_lineart_path(ctx, dev, path); if (!dev_pathdict) { return; } DICT_SETITEM_DROP(dev_pathdict, dictkey_type, PyUnicode_FromString("clip")); DICT_SETITEMSTR_DROP(dev_pathdict, "even_odd", Py_BuildValue("s", NULL)); if (!PyDict_GetItemString(dev_pathdict, "closePath")) { DICT_SETITEMSTR_DROP(dev_pathdict, "closePath", JM_BOOL(0)); } DICT_SETITEMSTR_DROP(dev_pathdict, "scissor", JM_py_from_rect(compute_scissor())); DICT_SETITEMSTR_DROP(dev_pathdict, "level", PyLong_FromLong(dev->depth)); DICT_SETITEMSTR_DROP(dev_pathdict, "layer", JM_UnicodeFromStr(layer_name)); jm_append_merge(out, dev->method); dev->depth++; } static void jm_lineart_clip_stroke_text(fz_context *ctx, fz_device *dev_, const fz_text *text, const fz_stroke_state *stroke, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; compute_scissor(); dev->depth++; } static void jm_lineart_clip_text(fz_context *ctx, fz_device *dev_, const fz_text *text, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; compute_scissor(); dev->depth++; } static void jm_lineart_clip_image_mask(fz_context *ctx, fz_device *dev_, fz_image *image, fz_matrix ctm, fz_rect scissor) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; compute_scissor(); dev->depth++; } static void jm_lineart_pop_clip(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; if (!scissors) return; Py_ssize_t len = PyList_Size(scissors); if (len < 1) return; PyList_SetSlice(scissors, len - 1, len, NULL); dev->depth--; } static void jm_lineart_begin_layer(fz_context *ctx, fz_device *dev_, const char *name) { layer_name = fz_strdup(ctx, name); } static void jm_lineart_end_layer(fz_context *ctx, fz_device *dev_) { fz_free(ctx, layer_name); layer_name = NULL; } static void jm_lineart_begin_group(fz_context *ctx, fz_device *dev_, fz_rect bbox, fz_colorspace *cs, int isolated, int knockout, int blendmode, float alpha) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; PyObject *out = dev->out; dev_pathdict = Py_BuildValue("{s:s,s:N,s:N,s:N,s:s,s:f,s:i,s:N}", "type", "group", "rect", JM_py_from_rect(bbox), "isolated", JM_BOOL(isolated), "knockout", JM_BOOL(knockout), "blendmode", fz_blendmode_name(blendmode), "opacity", alpha, "level", dev->depth, "layer", JM_UnicodeFromStr(layer_name) ); jm_append_merge(out, dev->method); dev->depth++; } static void jm_lineart_end_group(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (!dev->clips) return; dev->depth--; } static void jm_dev_linewidth(fz_context *ctx, fz_device *dev_, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { dev_linewidth = stroke->linewidth; jm_increase_seqno(ctx, dev_); } static void jm_trace_text_span(fz_context *ctx, PyObject *out, fz_text_span *span, int type, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, size_t seqno) { fz_font *out_font = NULL; int i; const char *fontname = JM_font_name(ctx, span->font); float rgb[3]; PyObject *chars = PyTuple_New(span->len); fz_matrix mat = fz_concat(span->trm, ctm); // text transformation matrix fz_point dir = fz_transform_vector(fz_make_point(1, 0), mat); // writing direction double fsize = sqrt(dir.x * dir.x + dir.y * dir.y); dir = fz_normalize_vector(dir); double linewidth, adv, asc, dsc; double space_adv = 0; float x0, y0, x1, y1; asc = (double) JM_font_ascender(ctx, span->font); dsc = (double) JM_font_descender(ctx, span->font); if (asc < 1e-3) { // probably Tesseract font dsc = -0.1; asc = 0.9; } // compute effective ascender / descender double ascsize = asc * fsize / (asc - dsc); double dscsize = dsc * fsize / (asc - dsc); int fflags = 0; // font flags int mono = fz_font_is_monospaced(ctx, span->font); fflags += mono * TEXT_FONT_MONOSPACED; fflags += fz_font_is_italic(ctx, span->font) * TEXT_FONT_ITALIC; fflags += fz_font_is_serif(ctx, span->font) * TEXT_FONT_SERIFED; fflags += fz_font_is_bold(ctx, span->font) * TEXT_FONT_BOLD; if (dev_linewidth > 0) { // width of character border linewidth = (double) dev_linewidth; } else { linewidth = fsize * 0.05; // default: 5% of font size } fz_point char_orig; double last_adv = 0; // walk through characters of span fz_rect span_bbox; fz_matrix rot = fz_make_matrix(dir.x, dir.y, -dir.y, dir.x, 0, 0); if (dir.x == -1) { // left-right flip rot.d = 1; } //PySys_WriteStdout("mat: (%g, %g, %g, %g)\n", mat.a, mat.b, mat.c, mat.d); //PySys_WriteStdout("rot: (%g, %g, %g, %g)\n", rot.a, rot.b, rot.c, rot.d); for (i = 0; i < span->len; i++) { adv = 0; if (span->items[i].gid >= 0) { adv = (double) fz_advance_glyph(ctx, span->font, span->items[i].gid, span->wmode); } adv *= fsize; last_adv = adv; if (span->items[i].ucs == 32) { space_adv = adv; } char_orig = fz_make_point(span->items[i].x, span->items[i].y); char_orig = fz_transform_point(char_orig, ctm); fz_matrix m1 = fz_make_matrix(1, 0, 0, 1, -char_orig.x, -char_orig.y); m1 = fz_concat(m1, rot); m1 = fz_concat(m1, fz_make_matrix(1, 0, 0, 1, char_orig.x, char_orig.y)); x0 = char_orig.x; x1 = x0 + adv; if (mat.d > 0 && (dir.x == 1 || dir.x == -1) || mat.b !=0 && mat.b == -mat.c) { // up-down flip y0 = char_orig.y + dscsize; y1 = char_orig.y + ascsize; } else { y0 = char_orig.y - ascsize; y1 = char_orig.y - dscsize; } fz_rect char_bbox = fz_make_rect(x0, y0, x1, y1); char_bbox = fz_transform_rect(char_bbox, m1); PyTuple_SET_ITEM(chars, (Py_ssize_t) i, Py_BuildValue("ii(ff)(ffff)", span->items[i].ucs, span->items[i].gid, char_orig.x, char_orig.y, char_bbox.x0, char_bbox.y0, char_bbox.x1, char_bbox.y1)); if (i > 0) { span_bbox = fz_union_rect(span_bbox, char_bbox); } else { span_bbox = char_bbox; } } if (!space_adv) { if (!mono) { space_adv = fz_advance_glyph(ctx, span->font, fz_encode_character_with_fallback(ctx, span->font, 32, 0, 0, &out_font), span->wmode); space_adv *= fsize; if (!space_adv) { space_adv = last_adv; } } else { space_adv = last_adv; // for mono, any char width suffices } } // make the span dictionary PyObject *span_dict = PyDict_New(); DICT_SETITEMSTR_DROP(span_dict, "dir", JM_py_from_point(dir)); DICT_SETITEM_DROP(span_dict, dictkey_font, JM_EscapeStrFromStr(fontname)); DICT_SETITEM_DROP(span_dict, dictkey_wmode, PyLong_FromLong((long) span->wmode)); DICT_SETITEM_DROP(span_dict, dictkey_flags, PyLong_FromLong((long) fflags)); DICT_SETITEMSTR_DROP(span_dict, "bidi_lvl", PyLong_FromLong((long) span->bidi_level)); DICT_SETITEMSTR_DROP(span_dict, "bidi_dir", PyLong_FromLong((long) span->markup_dir)); DICT_SETITEM_DROP(span_dict, dictkey_ascender, PyFloat_FromDouble(asc)); DICT_SETITEM_DROP(span_dict, dictkey_descender, PyFloat_FromDouble(dsc)); DICT_SETITEM_DROP(span_dict, dictkey_colorspace, PyLong_FromLong(3)); if (colorspace) { fz_convert_color(ctx, colorspace, color, fz_device_rgb(ctx), rgb, NULL, fz_default_color_params); } else { rgb[0] = rgb[1] = rgb[2] = 0; } DICT_SETITEM_DROP(span_dict, dictkey_color, Py_BuildValue("fff", rgb[0], rgb[1], rgb[2])); DICT_SETITEM_DROP(span_dict, dictkey_size, PyFloat_FromDouble(fsize)); DICT_SETITEMSTR_DROP(span_dict, "opacity", PyFloat_FromDouble((double) alpha)); DICT_SETITEMSTR_DROP(span_dict, "linewidth", PyFloat_FromDouble((double) linewidth)); DICT_SETITEMSTR_DROP(span_dict, "spacewidth", PyFloat_FromDouble(space_adv)); DICT_SETITEM_DROP(span_dict, dictkey_type, PyLong_FromLong((long) type)); DICT_SETITEM_DROP(span_dict, dictkey_bbox, JM_py_from_rect(span_bbox)); DICT_SETITEMSTR_DROP(span_dict, "layer", JM_UnicodeFromStr(layer_name)); DICT_SETITEMSTR_DROP(span_dict, "seqno", PyLong_FromSize_t(seqno)); DICT_SETITEM_DROP(span_dict, dictkey_chars, chars); LIST_APPEND_DROP(out, span_dict); } static void jm_trace_text(fz_context *ctx, PyObject *out, const fz_text *text, int type, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, size_t seqno) { fz_text_span *span; for (span = text->head; span; span = span->next) jm_trace_text_span(ctx, out, span, type, ctm, colorspace, color, alpha, seqno); } /*--------------------------------------------------------- There are 3 text trace types: 0 - fill text (PDF Tr 0) 1 - stroke text (PDF Tr 1) 3 - ignore text (PDF Tr 3) ---------------------------------------------------------*/ static void jm_lineart_fill_text(fz_context *ctx, fz_device *dev_, const fz_text *text, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *)dev_; PyObject *out = dev->out; jm_trace_text(ctx, out, text, 0, ctm, colorspace, color, alpha, dev->seqno); dev->seqno += 1; } static void jm_lineart_stroke_text(fz_context *ctx, fz_device *dev_, const fz_text *text, const fz_stroke_state *stroke, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_lineart_device *dev = (jm_lineart_device *)dev_; PyObject *out = dev->out; jm_trace_text(ctx, out, text, 1, ctm, colorspace, color, alpha, dev->seqno); dev->seqno += 1; } static void jm_lineart_ignore_text(fz_context *ctx, fz_device *dev_, const fz_text *text, fz_matrix ctm) { jm_lineart_device *dev = (jm_lineart_device *)dev_; PyObject *out = dev->out; jm_trace_text(ctx, out, text, 3, ctm, NULL, NULL, 1, dev->seqno); dev->seqno += 1; } static void jm_lineart_drop_device(fz_context *ctx, fz_device *dev_) { jm_lineart_device *dev = (jm_lineart_device *)dev_; if (PyList_Check(dev->out)) { Py_CLEAR(dev->out); } Py_CLEAR(dev->method); Py_CLEAR(scissors); } //------------------------------------------------------------------- // LINEART device for Python method Page.get_cdrawings() //------------------------------------------------------------------- fz_device *JM_new_lineart_device(fz_context *ctx, PyObject *out, int clips, PyObject *method) { jm_lineart_device *dev = fz_new_derived_device(ctx, jm_lineart_device); dev->super.close_device = NULL; dev->super.drop_device = jm_lineart_drop_device; dev->super.fill_path = jm_lineart_fill_path; dev->super.stroke_path = jm_lineart_stroke_path; dev->super.clip_path = jm_lineart_clip_path; dev->super.clip_stroke_path = jm_lineart_clip_stroke_path; dev->super.fill_text = jm_increase_seqno; dev->super.stroke_text = jm_increase_seqno; dev->super.clip_text = jm_lineart_clip_text; dev->super.clip_stroke_text = jm_lineart_clip_stroke_text; dev->super.ignore_text = jm_increase_seqno; dev->super.fill_shade = jm_increase_seqno; dev->super.fill_image = jm_increase_seqno; dev->super.fill_image_mask = jm_increase_seqno; dev->super.clip_image_mask = jm_lineart_clip_image_mask; dev->super.pop_clip = jm_lineart_pop_clip; dev->super.begin_mask = NULL; dev->super.end_mask = NULL; dev->super.begin_group = jm_lineart_begin_group; dev->super.end_group = jm_lineart_end_group; dev->super.begin_tile = NULL; dev->super.end_tile = NULL; dev->super.begin_layer = jm_lineart_begin_layer; dev->super.end_layer = jm_lineart_end_layer; dev->super.begin_structure = NULL; dev->super.end_structure = NULL; dev->super.begin_metatext = NULL; dev->super.end_metatext = NULL; dev->super.render_flags = NULL; dev->super.set_default_colorspaces = NULL; if (PyList_Check(out)) { Py_INCREF(out); } Py_INCREF(method); dev->out = out; dev->seqno = 0; dev->depth = 0; dev->clips = clips; dev->method = method; trace_device_reset(); return (fz_device *)dev; } //------------------------------------------------------------------- // Trace TEXT device for Python method Page.get_texttrace() //------------------------------------------------------------------- fz_device *JM_new_texttrace_device(fz_context *ctx, PyObject *out) { jm_lineart_device *dev = fz_new_derived_device(ctx, jm_lineart_device); dev->super.close_device = NULL; dev->super.drop_device = jm_lineart_drop_device; dev->super.fill_path = jm_increase_seqno; dev->super.stroke_path = jm_dev_linewidth; dev->super.clip_path = NULL; dev->super.clip_stroke_path = NULL; dev->super.fill_text = jm_lineart_fill_text; dev->super.stroke_text = jm_lineart_stroke_text; dev->super.clip_text = NULL; dev->super.clip_stroke_text = NULL; dev->super.ignore_text = jm_lineart_ignore_text; dev->super.fill_shade = jm_increase_seqno; dev->super.fill_image = jm_increase_seqno; dev->super.fill_image_mask = jm_increase_seqno; dev->super.clip_image_mask = NULL; dev->super.pop_clip = NULL; dev->super.begin_mask = NULL; dev->super.end_mask = NULL; dev->super.begin_group = NULL; dev->super.end_group = NULL; dev->super.begin_tile = NULL; dev->super.end_tile = NULL; dev->super.begin_layer = jm_lineart_begin_layer; dev->super.end_layer = jm_lineart_end_layer; dev->super.begin_structure = NULL; dev->super.end_structure = NULL; dev->super.begin_metatext = NULL; dev->super.end_metatext = NULL; dev->super.render_flags = NULL; dev->super.set_default_colorspaces = NULL; if (PyList_Check(out)) { Py_XINCREF(out); } dev->out = out; dev->seqno = 0; dev->depth = 0; dev->clips = 0; dev->method = NULL; trace_device_reset(); return (fz_device *)dev; } //------------------------------------------------------------------- // BBOX device //------------------------------------------------------------------- typedef struct jm_bbox_device_s { fz_device super; PyObject *result; int layers; } jm_bbox_device; static void jm_bbox_add_rect(fz_context *ctx, fz_device *dev, fz_rect rect, char *code) { jm_bbox_device *bdev = (jm_bbox_device *)dev; if (!bdev->layers) { LIST_APPEND_DROP(bdev->result, Py_BuildValue("sN", code, JM_py_from_rect(rect))); } else { LIST_APPEND_DROP(bdev->result, Py_BuildValue("sNN", code, JM_py_from_rect(rect), JM_UnicodeFromStr(layer_name))); } } static void jm_bbox_fill_path(fz_context *ctx, fz_device *dev, const fz_path *path, int even_odd, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_bbox_add_rect(ctx, dev, fz_bound_path(ctx, path, NULL, ctm), "fill-path"); } static void jm_bbox_stroke_path(fz_context *ctx, fz_device *dev, const fz_path *path, const fz_stroke_state *stroke, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_bbox_add_rect(ctx, dev, fz_bound_path(ctx, path, stroke, ctm), "stroke-path"); } static void jm_bbox_fill_text(fz_context *ctx, fz_device *dev, const fz_text *text, fz_matrix ctm, ...) { jm_bbox_add_rect(ctx, dev, fz_bound_text(ctx, text, NULL, ctm), "fill-text"); } static void jm_bbox_ignore_text(fz_context *ctx, fz_device *dev, const fz_text *text, fz_matrix ctm) { jm_bbox_add_rect(ctx, dev, fz_bound_text(ctx, text, NULL, ctm), "ignore-text"); } static void jm_bbox_stroke_text(fz_context *ctx, fz_device *dev, const fz_text *text, const fz_stroke_state *stroke, fz_matrix ctm, ...) { jm_bbox_add_rect(ctx, dev, fz_bound_text(ctx, text, stroke, ctm), "stroke-text"); } static void jm_bbox_fill_shade(fz_context *ctx, fz_device *dev, fz_shade *shade, fz_matrix ctm, float alpha, fz_color_params color_params) { jm_bbox_add_rect(ctx, dev, fz_bound_shade(ctx, shade, ctm), "fill-shade"); } static void jm_bbox_fill_image(fz_context *ctx, fz_device *dev, fz_image *image, fz_matrix ctm, float alpha, fz_color_params color_params) { jm_bbox_add_rect(ctx, dev, fz_transform_rect(fz_unit_rect, ctm), "fill-image"); } static void jm_bbox_fill_image_mask(fz_context *ctx, fz_device *dev, fz_image *image, fz_matrix ctm, fz_colorspace *colorspace, const float *color, float alpha, fz_color_params color_params) { jm_bbox_add_rect(ctx, dev, fz_transform_rect(fz_unit_rect, ctm), "fill-imgmask"); } fz_device * JM_new_bbox_device(fz_context *ctx, PyObject *result, int layers) { jm_bbox_device *dev = fz_new_derived_device(ctx, jm_bbox_device); dev->super.fill_path = jm_bbox_fill_path; dev->super.stroke_path = jm_bbox_stroke_path; dev->super.clip_path = NULL; dev->super.clip_stroke_path = NULL; dev->super.fill_text = jm_bbox_fill_text; dev->super.stroke_text = jm_bbox_stroke_text; dev->super.clip_text = NULL; dev->super.clip_stroke_text = NULL; dev->super.ignore_text = jm_bbox_ignore_text; dev->super.fill_shade = jm_bbox_fill_shade; dev->super.fill_image = jm_bbox_fill_image; dev->super.fill_image_mask = jm_bbox_fill_image_mask; dev->super.clip_image_mask = NULL; dev->super.pop_clip = NULL; dev->super.begin_mask = NULL; dev->super.end_mask = NULL; dev->super.begin_group = NULL; dev->super.end_group = NULL; dev->super.begin_tile = NULL; dev->super.end_tile = NULL; dev->super.begin_layer = jm_lineart_begin_layer; dev->super.end_layer = jm_lineart_end_layer; dev->super.begin_structure = NULL; dev->super.end_structure = NULL; dev->super.begin_metatext = NULL; dev->super.end_metatext = NULL; dev->super.render_flags = NULL; dev->super.set_default_colorspaces = NULL; dev->result = result; dev->layers = layers; trace_device_reset(); return (fz_device *)dev; } %} ================================================ FILE: src_classic/helper-fields.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ #define SETATTR(a, v) PyObject_SetAttrString(Widget, a, v) #define GETATTR(a) PyObject_GetAttrString(Widget, a) #define CALLATTR(m, p) PyObject_CallMethod(Widget, m, p) static void SETATTR_DROP(PyObject *mod, const char *attr, PyObject *value) { if (!value) PyObject_DelAttrString(mod, attr); else { PyObject_SetAttrString(mod, attr, value); Py_DECREF(value); } } //----------------------------------------------------------------------------- // Functions dealing with PDF form fields (widgets) //----------------------------------------------------------------------------- enum { SigFlag_SignaturesExist = 1, SigFlag_AppendOnly = 2 }; // make new PDF action object from JavaScript source // Parameters are a PDF document and a Python string. // Returns a PDF action object. //----------------------------------------------------------------------------- pdf_obj * JM_new_javascript(fz_context *ctx, pdf_document *pdf, PyObject *value) { fz_buffer *res = NULL; if (!PyObject_IsTrue(value)) // no argument given return NULL; char *data = JM_StrAsChar(value); if (!data) // not convertible to char* return NULL; res = fz_new_buffer_from_copied_data(ctx, data, strlen(data)); pdf_obj *source = pdf_add_stream(ctx, pdf, res, NULL, 0); pdf_obj *newaction = pdf_add_new_dict(ctx, pdf, 4); pdf_dict_put(ctx, newaction, PDF_NAME(S), pdf_new_name(ctx, "JavaScript")); pdf_dict_put(ctx, newaction, PDF_NAME(JS), source); fz_drop_buffer(ctx, res); return pdf_keep_obj(ctx, newaction); } // JavaScript extractor // Returns either the script source or None. Parameter is a PDF action // dictionary, which must have keys /S and /JS. The value of /S must be // '/JavaScript'. The value of /JS is returned. //----------------------------------------------------------------------------- PyObject * JM_get_script(fz_context *ctx, pdf_obj *key) { pdf_obj *js = NULL; fz_buffer *res = NULL; PyObject *script = NULL; if (!key) Py_RETURN_NONE; if (!strcmp(pdf_to_name(ctx, pdf_dict_get(ctx, key, PDF_NAME(S))), "JavaScript")) { js = pdf_dict_get(ctx, key, PDF_NAME(JS)); } if (!js) Py_RETURN_NONE; if (pdf_is_string(ctx, js)) { script = JM_UnicodeFromStr(pdf_to_text_string(ctx, js)); } else if (pdf_is_stream(ctx, js)) { res = pdf_load_stream(ctx, js); script = JM_EscapeStrFromBuffer(ctx, res); fz_drop_buffer(ctx, res); } else { Py_RETURN_NONE; } if (PyObject_IsTrue(script)) { // do not return an empty script return script; } Py_CLEAR(script); Py_RETURN_NONE; } // Create a JavaScript PDF action. // Usable for all object types which support PDF actions, even if the // argument name suggests annotations. Up to 2 key values can be specified, so // JavaScript actions can be stored for '/A' and '/AA/?' keys. //----------------------------------------------------------------------------- void JM_put_script(fz_context *ctx, pdf_obj *annot_obj, pdf_obj *key1, pdf_obj *key2, PyObject *value) { PyObject *script = NULL; pdf_obj *key1_obj = pdf_dict_get(ctx, annot_obj, key1); pdf_document *pdf = pdf_get_bound_document(ctx, annot_obj); // owning PDF // if no new script given, just delete corresponding key if (!value || !PyObject_IsTrue(value)) { if (!key2) { pdf_dict_del(ctx, annot_obj, key1); } else if (key1_obj) { pdf_dict_del(ctx, key1_obj, key2); } return; } // read any existing script as a PyUnicode string if (!key2 || !key1_obj) { script = JM_get_script(ctx, key1_obj); } else { script = JM_get_script(ctx, pdf_dict_get(ctx, key1_obj, key2)); } // replace old script, if different from new one if (!PyObject_RichCompareBool(value, script, Py_EQ)) { pdf_obj *newaction = JM_new_javascript(ctx, pdf, value); if (!key2) { pdf_dict_put_drop(ctx, annot_obj, key1, newaction); } else { pdf_dict_putl_drop(ctx, annot_obj, newaction, key1, key2, NULL); } } Py_XDECREF(script); return; } /* // Execute a JavaScript action for annot or field. //----------------------------------------------------------------------------- PyObject * JM_exec_script(fz_context *ctx, pdf_obj *annot_obj, pdf_obj *key1, pdf_obj *key2) { PyObject *script = NULL; char *code = NULL; fz_try(ctx) { pdf_document *pdf = pdf_get_bound_document(ctx, annot_obj); char buf[100]; if (!key2) { script = JM_get_script(ctx, key1_obj); } else { script = JM_get_script(ctx, pdf_dict_get(ctx, key1_obj, key2)); } code = JM_StrAsChar(script); fz_snprintf(buf, sizeof buf, "%d/A", pdf_to_num(ctx, annot_obj)); pdf_js_execute(pdf->js, buf, code); } fz_always(ctx) { Py_XDECREF(string); } fz_catch(ctx) { Py_RETURN_FALSE; } Py_RETURN_TRUE; } */ // String from widget type //----------------------------------------------------------------------------- char *JM_field_type_text(int wtype) { switch(wtype) { case(PDF_WIDGET_TYPE_BUTTON): return "Button"; case(PDF_WIDGET_TYPE_CHECKBOX): return "CheckBox"; case(PDF_WIDGET_TYPE_RADIOBUTTON): return "RadioButton"; case(PDF_WIDGET_TYPE_TEXT): return "Text"; case(PDF_WIDGET_TYPE_LISTBOX): return "ListBox"; case(PDF_WIDGET_TYPE_COMBOBOX): return "ComboBox"; case(PDF_WIDGET_TYPE_SIGNATURE): return "Signature"; default: return "unknown"; } } // Set the field type //----------------------------------------------------------------------------- void JM_set_field_type(fz_context *ctx, pdf_document *doc, pdf_obj *obj, int type) { int setbits = 0; int clearbits = 0; pdf_obj *typename = NULL; switch(type) { case PDF_WIDGET_TYPE_BUTTON: typename = PDF_NAME(Btn); setbits = PDF_BTN_FIELD_IS_PUSHBUTTON; break; case PDF_WIDGET_TYPE_RADIOBUTTON: typename = PDF_NAME(Btn); clearbits = PDF_BTN_FIELD_IS_PUSHBUTTON; setbits = PDF_BTN_FIELD_IS_RADIO; break; case PDF_WIDGET_TYPE_CHECKBOX: typename = PDF_NAME(Btn); clearbits = (PDF_BTN_FIELD_IS_PUSHBUTTON|PDF_BTN_FIELD_IS_RADIO); break; case PDF_WIDGET_TYPE_TEXT: typename = PDF_NAME(Tx); break; case PDF_WIDGET_TYPE_LISTBOX: typename = PDF_NAME(Ch); clearbits = PDF_CH_FIELD_IS_COMBO; break; case PDF_WIDGET_TYPE_COMBOBOX: typename = PDF_NAME(Ch); setbits = PDF_CH_FIELD_IS_COMBO; break; case PDF_WIDGET_TYPE_SIGNATURE: typename = PDF_NAME(Sig); break; } if (typename) pdf_dict_put_drop(ctx, obj, PDF_NAME(FT), typename); if (setbits != 0 || clearbits != 0) { int bits = pdf_dict_get_int(ctx, obj, PDF_NAME(Ff)); bits &= ~clearbits; bits |= setbits; pdf_dict_put_int(ctx, obj, PDF_NAME(Ff), bits); } } // Copied from MuPDF v1.14 // Create widget. // Returns a kept reference to a pdf_annot - caller must drop it. //----------------------------------------------------------------------------- pdf_annot *JM_create_widget(fz_context *ctx, pdf_document *doc, pdf_page *page, int type, char *fieldname) { pdf_obj *form = NULL; int old_sigflags = pdf_to_int(ctx, pdf_dict_getp(ctx, pdf_trailer(ctx, doc), "Root/AcroForm/SigFlags")); pdf_annot *annot = pdf_create_annot_raw(ctx, page, PDF_ANNOT_WIDGET); // returns a kept reference. pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); fz_try(ctx) { JM_set_field_type(ctx, doc, annot_obj, type); pdf_dict_put_text_string(ctx, annot_obj, PDF_NAME(T), fieldname); if (type == PDF_WIDGET_TYPE_SIGNATURE) { int sigflags = (old_sigflags | (SigFlag_SignaturesExist|SigFlag_AppendOnly)); pdf_dict_putl_drop(ctx, pdf_trailer(ctx, doc), pdf_new_int(ctx, sigflags), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(SigFlags), NULL); } /* pdf_create_annot will have linked the new widget into the page's annot array. We also need it linked into the document's form */ form = pdf_dict_getp(ctx, pdf_trailer(ctx, doc), "Root/AcroForm/Fields"); if (!form) { form = pdf_new_array(ctx, doc, 1); pdf_dict_putl_drop(ctx, pdf_trailer(ctx, doc), form, PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(Fields), NULL); } pdf_array_push(ctx, form, annot_obj); // Cleanup relies on this statement being last } fz_catch(ctx) { pdf_delete_annot(ctx, page, annot); if (type == PDF_WIDGET_TYPE_SIGNATURE) { pdf_dict_putl_drop(ctx, pdf_trailer(ctx, doc), pdf_new_int(ctx, old_sigflags), PDF_NAME(Root), PDF_NAME(AcroForm), PDF_NAME(SigFlags), NULL); } fz_rethrow(ctx); } return annot; } // PushButton get state //----------------------------------------------------------------------------- PyObject *JM_pushbtn_state(fz_context *ctx, pdf_annot *annot) { // pushed buttons do not reflect status changes in the PDF // always reflect them as untouched Py_RETURN_FALSE; } // Text field retrieve value //----------------------------------------------------------------------------- PyObject *JM_text_value(fz_context *ctx, pdf_annot *annot) { const char *text = NULL; fz_var(text); fz_try(ctx) { pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); text = pdf_field_value(ctx, annot_obj); } fz_catch(ctx) Py_RETURN_NONE; return JM_UnicodeFromStr(text); } // ListBox retrieve value //----------------------------------------------------------------------------- PyObject *JM_listbox_value(fz_context *ctx, pdf_annot *annot) { int i = 0, n = 0; // may be single value or array pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); pdf_obj *optarr = pdf_dict_get(ctx, annot_obj, PDF_NAME(V)); if (pdf_is_string(ctx, optarr)) // a single string return PyString_FromString(pdf_to_text_string(ctx, optarr)); // value is an array (may have len 0) n = pdf_array_len(ctx, optarr); PyObject *liste = PyList_New(0); // extract a list of strings // each entry may again be an array: take second entry then for (i = 0; i < n; i++) { pdf_obj *elem = pdf_array_get(ctx, optarr, i); if (pdf_is_array(ctx, elem)) elem = pdf_array_get(ctx, elem, 1); LIST_APPEND_DROP(liste, JM_UnicodeFromStr(pdf_to_text_string(ctx, elem))); } return liste; } // ComboBox retrieve value //----------------------------------------------------------------------------- PyObject *JM_combobox_value(fz_context *ctx, pdf_annot *annot) { // combobox treated like listbox return JM_listbox_value(ctx, annot); } // Signature field retrieve value PyObject *JM_signature_value(fz_context *ctx, pdf_annot *annot) { // signatures are currently not supported Py_RETURN_NONE; } // retrieve ListBox / ComboBox choice values //----------------------------------------------------------------------------- PyObject *JM_choice_options(fz_context *ctx, pdf_annot *annot) { // return list of choices for list or combo boxes pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); PyObject *val; int n = pdf_choice_widget_options(ctx, annot, 0, NULL); if (n == 0) Py_RETURN_NONE; // wrong widget type pdf_obj *optarr = pdf_dict_get(ctx, annot_obj, PDF_NAME(Opt)); int i, m; PyObject *liste = PyList_New(0); for (i = 0; i < n; i++) { m = pdf_array_len(ctx, pdf_array_get(ctx, optarr, i)); if (m == 2) { val = Py_BuildValue("ss", pdf_to_text_string(ctx, pdf_array_get(ctx, pdf_array_get(ctx, optarr, i), 0)), pdf_to_text_string(ctx, pdf_array_get(ctx, pdf_array_get(ctx, optarr, i), 1))); LIST_APPEND_DROP(liste, val); } else { val = JM_UnicodeFromStr(pdf_to_text_string(ctx, pdf_array_get(ctx, optarr, i))); LIST_APPEND_DROP(liste, val); } } return liste; } // set ListBox / ComboBox values //----------------------------------------------------------------------------- void JM_set_choice_options(fz_context *ctx, pdf_annot *annot, PyObject *liste) { if (!liste) return; if (!PySequence_Check(liste)) return; Py_ssize_t i, n = PySequence_Size(liste); if (n < 1) return; PyObject *tuple = PySequence_Tuple(liste); PyObject *val = NULL, *val1 = NULL, *val2 = NULL; pdf_obj *optarrsub = NULL, *optarr = NULL, *annot_obj = NULL; pdf_document *pdf = NULL; const char *opt = NULL, *opt1 = NULL, *opt2 = NULL; fz_try(ctx) { annot_obj = pdf_annot_obj(ctx, annot); pdf = pdf_get_bound_document(ctx, annot_obj); optarr = pdf_new_array(ctx, pdf, (int) n); for (i = 0; i < n; i++) { val = PyTuple_GET_ITEM(tuple, i); opt = PyUnicode_AsUTF8(val); if (opt) { pdf_array_push_text_string(ctx, optarr, opt); } else { if (!PySequence_Check(val) || PySequence_Size(val) != 2) { RAISEPY(ctx, "bad choice field list", PyExc_ValueError); } val1 = PySequence_GetItem(val, 0); opt1 = PyUnicode_AsUTF8(val1); if (!opt1) { RAISEPY(ctx, "bad choice field list", PyExc_ValueError); } val2 = PySequence_GetItem(val, 1); opt2 = PyUnicode_AsUTF8(val2); if (!opt2) { RAISEPY(ctx, "bad choice field list", PyExc_ValueError); }; Py_CLEAR(val1); Py_CLEAR(val2); optarrsub = pdf_array_push_array(ctx, optarr, 2); pdf_array_push_text_string(ctx, optarrsub, opt1); pdf_array_push_text_string(ctx, optarrsub, opt2); } } pdf_dict_put_drop(ctx, annot_obj, PDF_NAME(Opt), optarr); } fz_always(ctx) { Py_CLEAR(tuple); Py_CLEAR(val1); Py_CLEAR(val2); PyErr_Clear(); } fz_catch(ctx) { fz_rethrow(ctx); } return; } //----------------------------------------------------------------------------- // Populate a Python Widget object with the values from a PDF form field. // Called by "Page.firstWidget" and "Widget.next". //----------------------------------------------------------------------------- void JM_get_widget_properties(fz_context *ctx, pdf_annot *annot, PyObject *Widget) { pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); pdf_page *page = pdf_annot_page(ctx, annot); pdf_document *pdf = page->doc; pdf_annot *tw = annot; pdf_obj *obj = NULL; Py_ssize_t i = 0, n = 0; fz_try(ctx) { int field_type = pdf_widget_type(ctx, tw); SETATTR_DROP(Widget, "field_type", Py_BuildValue("i", field_type)); if (field_type == PDF_WIDGET_TYPE_SIGNATURE) { if (pdf_signature_is_signed(ctx, pdf, annot_obj)) { SETATTR("is_signed", Py_True); } else { SETATTR("is_signed", Py_False); } } else { SETATTR("is_signed", Py_None); } SETATTR_DROP(Widget, "border_style", JM_UnicodeFromStr(pdf_field_border_style(ctx, annot_obj))); SETATTR_DROP(Widget, "field_type_string", JM_UnicodeFromStr(JM_field_type_text(field_type))); #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR <= 22 char *field_name = pdf_field_name(ctx, annot_obj); #else char *field_name = pdf_load_field_name(ctx, annot_obj); #endif SETATTR_DROP(Widget, "field_name", JM_UnicodeFromStr(field_name)); JM_Free(field_name); const char *label = NULL; obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(TU)); if (obj) label = pdf_to_text_string(ctx, obj); SETATTR_DROP(Widget, "field_label", JM_UnicodeFromStr(label)); const char *fvalue = NULL; if (field_type == PDF_WIDGET_TYPE_RADIOBUTTON) { obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(Parent)); // owning RB group if (obj) { SETATTR_DROP(Widget, "rb_parent", Py_BuildValue("i", pdf_to_num(ctx, obj))); } obj = pdf_dict_get(ctx, annot_obj, PDF_NAME(AS)); if (obj) { fvalue = pdf_to_name(ctx, obj); } } if (!fvalue) { fvalue = pdf_field_value(ctx, annot_obj); } SETATTR_DROP(Widget, "field_value", JM_UnicodeFromStr(fvalue)); SETATTR_DROP(Widget, "field_display", Py_BuildValue("i", pdf_field_display(ctx, annot_obj))); float border_width = pdf_to_real(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(BS), PDF_NAME(W), NULL)); if (border_width == 0) border_width = 1; SETATTR_DROP(Widget, "border_width", Py_BuildValue("f", border_width)); obj = pdf_dict_getl(ctx, annot_obj, PDF_NAME(BS), PDF_NAME(D), NULL); if (pdf_is_array(ctx, obj)) { n = (Py_ssize_t) pdf_array_len(ctx, obj); PyObject *d = PyList_New(n); for (i = 0; i < n; i++) { PyList_SET_ITEM(d, i, Py_BuildValue("i", pdf_to_int(ctx, pdf_array_get(ctx, obj, (int) i)))); } SETATTR_DROP(Widget, "border_dashes", d); } SETATTR_DROP(Widget, "text_maxlen", Py_BuildValue("i", pdf_text_widget_max_len(ctx, tw))); SETATTR_DROP(Widget, "text_format", Py_BuildValue("i", pdf_text_widget_format(ctx, tw))); obj = pdf_dict_getl(ctx, annot_obj, PDF_NAME(MK), PDF_NAME(BG), NULL); if (pdf_is_array(ctx, obj)) { n = (Py_ssize_t) pdf_array_len(ctx, obj); PyObject *col = PyList_New(n); for (i = 0; i < n; i++) { PyList_SET_ITEM(col, i, Py_BuildValue("f", pdf_to_real(ctx, pdf_array_get(ctx, obj, (int) i)))); } SETATTR_DROP(Widget, "fill_color", col); } obj = pdf_dict_getl(ctx, annot_obj, PDF_NAME(MK), PDF_NAME(BC), NULL); if (pdf_is_array(ctx, obj)) { n = (Py_ssize_t) pdf_array_len(ctx, obj); PyObject *col = PyList_New(n); for (i = 0; i < n; i++) { PyList_SET_ITEM(col, i, Py_BuildValue("f", pdf_to_real(ctx, pdf_array_get(ctx, obj, (int) i)))); } SETATTR_DROP(Widget, "border_color", col); } SETATTR_DROP(Widget, "choice_values", JM_choice_options(ctx, annot)); const char *da = pdf_to_text_string(ctx, pdf_dict_get_inheritable(ctx, annot_obj, PDF_NAME(DA))); SETATTR_DROP(Widget, "_text_da", JM_UnicodeFromStr(da)); obj = pdf_dict_getl(ctx, annot_obj, PDF_NAME(MK), PDF_NAME(CA), NULL); if (obj) { SETATTR_DROP(Widget, "button_caption", JM_UnicodeFromStr((char *)pdf_to_text_string(ctx, obj))); } SETATTR_DROP(Widget, "field_flags", Py_BuildValue("i", pdf_field_flags(ctx, annot_obj))); // call Py method to reconstruct text color, font name, size PyObject *call = CALLATTR("_parse_da", NULL); Py_XDECREF(call); // extract JavaScript action texts SETATTR_DROP(Widget, "script", JM_get_script(ctx, pdf_dict_get(ctx, annot_obj, PDF_NAME(A)))); SETATTR_DROP(Widget, "script_stroke", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(K), NULL))); SETATTR_DROP(Widget, "script_format", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(F), NULL))); SETATTR_DROP(Widget, "script_change", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(V), NULL))); SETATTR_DROP(Widget, "script_calc", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(C), NULL))); SETATTR_DROP(Widget, "script_blur", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), pdf_new_name(ctx, "Bl"), NULL))); SETATTR_DROP(Widget, "script_focus", JM_get_script(ctx, pdf_dict_getl(ctx, annot_obj, PDF_NAME(AA), pdf_new_name(ctx, "Fo"), NULL))); } fz_always(ctx) PyErr_Clear(); fz_catch(ctx) fz_rethrow(ctx); return; } //----------------------------------------------------------------------------- // Update the PDF form field with the properties from a Python Widget object. // Called by "Page.addWidget" and "Annot.updateWidget". //----------------------------------------------------------------------------- void JM_set_widget_properties(fz_context *ctx, pdf_annot *annot, PyObject *Widget) { pdf_page *page = pdf_annot_page(ctx, annot); pdf_obj *annot_obj = pdf_annot_obj(ctx, annot); pdf_document *pdf = page->doc; fz_rect rect; pdf_obj *fill_col = NULL, *border_col = NULL; pdf_obj *dashes = NULL; Py_ssize_t i, n = 0; int d; PyObject *value = GETATTR("field_type"); int field_type = (int) PyInt_AsLong(value); Py_DECREF(value); // rectangle -------------------------------------------------------------- value = GETATTR("rect"); rect = JM_rect_from_py(value); Py_XDECREF(value); fz_matrix rot_mat = JM_rotate_page_matrix(ctx, page); rect = fz_transform_rect(rect, rot_mat); pdf_set_annot_rect(ctx, annot, rect); // fill color ------------------------------------------------------------- value = GETATTR("fill_color"); if (value && PySequence_Check(value)) { n = PySequence_Size(value); fill_col = pdf_new_array(ctx, pdf, n); double col = 0; for (i = 0; i < n; i++) { JM_FLOAT_ITEM(value, i, &col); pdf_array_push_real(ctx, fill_col, col); } pdf_field_set_fill_color(ctx, annot_obj, fill_col); pdf_drop_obj(ctx, fill_col); } Py_XDECREF(value); // dashes ----------------------------------------------------------------- value = GETATTR("border_dashes"); if (value && PySequence_Check(value)) { n = PySequence_Size(value); dashes = pdf_new_array(ctx, pdf, n); for (i = 0; i < n; i++) { pdf_array_push_int(ctx, dashes, (int64_t) PyInt_AsLong(PySequence_ITEM(value, i))); } pdf_dict_putl_drop(ctx, annot_obj, dashes, PDF_NAME(BS), PDF_NAME(D), NULL); } Py_XDECREF(value); // border color ----------------------------------------------------------- value = GETATTR("border_color"); if (value && PySequence_Check(value)) { n = PySequence_Size(value); border_col = pdf_new_array(ctx, pdf, n); double col = 0; for (i = 0; i < n; i++) { JM_FLOAT_ITEM(value, i, &col); pdf_array_push_real(ctx, border_col, col); } pdf_dict_putl_drop(ctx, annot_obj, border_col, PDF_NAME(MK), PDF_NAME(BC), NULL); } Py_XDECREF(value); // entry ignored - may be used later /* int text_format = (int) PyInt_AsLong(GETATTR("text_format")); */ // field label ----------------------------------------------------------- value = GETATTR("field_label"); if (value != Py_None) { char *label = JM_StrAsChar(value); pdf_dict_put_text_string(ctx, annot_obj, PDF_NAME(TU), label); } Py_XDECREF(value); // field name ------------------------------------------------------------- value = GETATTR("field_name"); if (value != Py_None) { char *name = JM_StrAsChar(value); #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR <= 22 char *old_name = pdf_field_name(ctx, annot_obj); #else char *old_name = pdf_load_field_name(ctx, annot_obj); #endif if (strcmp(name, old_name) != 0) { pdf_dict_put_text_string(ctx, annot_obj, PDF_NAME(T), name); } JM_Free(old_name); } Py_XDECREF(value); // max text len ----------------------------------------------------------- if (field_type == PDF_WIDGET_TYPE_TEXT) { value = GETATTR("text_maxlen"); int text_maxlen = (int) PyInt_AsLong(value); if (text_maxlen) { pdf_dict_put_int(ctx, annot_obj, PDF_NAME(MaxLen), text_maxlen); } Py_XDECREF(value); } value = GETATTR("field_display"); d = (int) PyInt_AsLong(value); Py_XDECREF(value); pdf_field_set_display(ctx, annot_obj, d); // choice values ---------------------------------------------------------- if (field_type == PDF_WIDGET_TYPE_LISTBOX || field_type == PDF_WIDGET_TYPE_COMBOBOX) { value = GETATTR("choice_values"); JM_set_choice_options(ctx, annot, value); Py_XDECREF(value); } // border style ----------------------------------------------------------- value = GETATTR("border_style"); pdf_obj *val = JM_get_border_style(ctx, value); Py_XDECREF(value); pdf_dict_putl_drop(ctx, annot_obj, val, PDF_NAME(BS), PDF_NAME(S), NULL); // border width ----------------------------------------------------------- value = GETATTR("border_width"); float border_width = (float) PyFloat_AsDouble(value); Py_XDECREF(value); pdf_dict_putl_drop(ctx, annot_obj, pdf_new_real(ctx, border_width), PDF_NAME(BS), PDF_NAME(W), NULL); // /DA string ------------------------------------------------------------- value = GETATTR("_text_da"); char *da = JM_StrAsChar(value); Py_XDECREF(value); pdf_dict_put_text_string(ctx, annot_obj, PDF_NAME(DA), da); pdf_dict_del(ctx, annot_obj, PDF_NAME(DS)); /* not supported by MuPDF */ pdf_dict_del(ctx, annot_obj, PDF_NAME(RC)); /* not supported by MuPDF */ // field flags ------------------------------------------------------------ value = GETATTR("field_flags"); int field_flags = (int) PyInt_AsLong(value); Py_XDECREF(value); if (!PyErr_Occurred()) { if (field_type == PDF_WIDGET_TYPE_COMBOBOX) { field_flags |= PDF_CH_FIELD_IS_COMBO; } else if (field_type == PDF_WIDGET_TYPE_RADIOBUTTON) { field_flags |= PDF_BTN_FIELD_IS_RADIO; } else if (field_type == PDF_WIDGET_TYPE_BUTTON) { field_flags |= PDF_BTN_FIELD_IS_PUSHBUTTON; } pdf_dict_put_int(ctx, annot_obj, PDF_NAME(Ff), field_flags); } // button caption --------------------------------------------------------- value = GETATTR("button_caption"); char *ca = JM_StrAsChar(value); if (ca) { pdf_field_set_button_caption(ctx, annot_obj, ca); } Py_XDECREF(value); // script (/A) ------------------------------------------------------- value = GETATTR("script"); JM_put_script(ctx, annot_obj, PDF_NAME(A), NULL, value); Py_CLEAR(value); // script (/AA/K) ------------------------------------------------------- value = GETATTR("script_stroke"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(K), value); Py_CLEAR(value); // script (/AA/F) ------------------------------------------------------- value = GETATTR("script_format"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(F), value); Py_CLEAR(value); // script (/AA/V) ------------------------------------------------------- value = GETATTR("script_change"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(V), value); Py_CLEAR(value); // script (/AA/C) ------------------------------------------------------- value = GETATTR("script_calc"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), PDF_NAME(C), value); Py_CLEAR(value); // script (/AA/Bl) ------------------------------------------------------ value = GETATTR("script_blur"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), pdf_new_name(ctx, "Bl"), value); Py_CLEAR(value); // script (/AA/Fo) ------------------------------------------------------ value = GETATTR("script_focus"); JM_put_script(ctx, annot_obj, PDF_NAME(AA), pdf_new_name(ctx, "Fo"), value); Py_CLEAR(value); // field value ------------------------------------------------------------ value = GETATTR("field_value"); // field value char *text = JM_StrAsChar(value); // convert to text (may fail!) switch(field_type) { case PDF_WIDGET_TYPE_RADIOBUTTON: if (PyObject_RichCompareBool(value, Py_False, Py_EQ)) { pdf_set_field_value(ctx, pdf, annot_obj, "Off", 1); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(AS), "Off"); } else { pdf_obj *onstate = pdf_button_field_on_state(ctx, annot_obj); if (onstate) { const char *on = pdf_to_name(ctx, onstate); pdf_set_field_value(ctx, pdf, annot_obj, on, 1); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(AS), on); } else if (text) { pdf_dict_put_name(gctx, annot_obj, PDF_NAME(AS), text); } } break; case PDF_WIDGET_TYPE_CHECKBOX: // will always be "Yes" or "Off" if (PyObject_RichCompareBool(value, Py_True, Py_EQ) || text && strcmp(text, "Yes")==0) { pdf_dict_put_name(gctx, annot_obj, PDF_NAME(AS), "Yes"); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(V), "Yes"); } else { pdf_dict_put_name(gctx, annot_obj, PDF_NAME(AS), "Off"); pdf_dict_put_name(gctx, annot_obj, PDF_NAME(V), "Off"); } break; default: if (text) { pdf_set_field_value(ctx, pdf, annot_obj, (const char *)text, 1); if (field_type == PDF_WIDGET_TYPE_COMBOBOX || field_type == PDF_WIDGET_TYPE_LISTBOX) { pdf_dict_del(ctx, annot_obj, PDF_NAME(I)); } } } Py_CLEAR(value); PyErr_Clear(); pdf_dirty_annot(ctx, annot); pdf_set_annot_hot(ctx, annot, 1); pdf_set_annot_active(ctx, annot, 1); pdf_update_annot(ctx, annot); } #undef SETATTR #undef GETATTR #undef CALLATTR %} %pythoncode %{ #------------------------------------------------------------------------------ # Class describing a PDF form field ("widget") #------------------------------------------------------------------------------ class Widget(object): def __init__(self): self.thisown = True self.border_color = None self.border_style = "S" self.border_width = 0 self.border_dashes = None self.choice_values = None # choice fields only self.rb_parent = None # radio buttons only: xref of owning parent self.field_name = None # field name self.field_label = None # field label self.field_value = None self.field_flags = 0 self.field_display = 0 self.field_type = 0 # valid range 1 through 7 self.field_type_string = None # field type as string self.fill_color = None self.button_caption = None # button caption self.is_signed = None # True / False if signature self.text_color = (0, 0, 0) self.text_font = "Helv" self.text_fontsize = 0 self.text_maxlen = 0 # text fields only self.text_format = 0 # text fields only self._text_da = "" # /DA = default apparance self.script = None # JavaScript (/A) self.script_stroke = None # JavaScript (/AA/K) self.script_format = None # JavaScript (/AA/F) self.script_change = None # JavaScript (/AA/V) self.script_calc = None # JavaScript (/AA/C) self.script_blur = None # JavaScript (/AA/Bl) self.script_focus = None # JavaScript (/AA/Fo) self.rect = None # annot value self.xref = 0 # annot value def _validate(self): """Validate the class entries. """ if (self.rect.is_infinite or self.rect.is_empty ): raise ValueError("bad rect") if not self.field_name: raise ValueError("field name missing") if self.field_label == "Unnamed": self.field_label = None CheckColor(self.border_color) CheckColor(self.fill_color) if not self.text_color: self.text_color = (0, 0, 0) CheckColor(self.text_color) if not self.border_width: self.border_width = 0 if not self.text_fontsize: self.text_fontsize = 0 self.border_style = self.border_style.upper()[0:1] # standardize content of JavaScript entries btn_type = self.field_type in ( PDF_WIDGET_TYPE_BUTTON, PDF_WIDGET_TYPE_CHECKBOX, PDF_WIDGET_TYPE_RADIOBUTTON ) if not self.script: self.script = None elif type(self.script) is not str: raise ValueError("script content must be a string") # buttons cannot have the following script actions if btn_type or not self.script_calc: self.script_calc = None elif type(self.script_calc) is not str: raise ValueError("script_calc content must be a string") if btn_type or not self.script_change: self.script_change = None elif type(self.script_change) is not str: raise ValueError("script_change content must be a string") if btn_type or not self.script_format: self.script_format = None elif type(self.script_format) is not str: raise ValueError("script_format content must be a string") if btn_type or not self.script_stroke: self.script_stroke = None elif type(self.script_stroke) is not str: raise ValueError("script_stroke content must be a string") if btn_type or not self.script_blur: self.script_blur = None elif type(self.script_blur) is not str: raise ValueError("script_blur content must be a string") if btn_type or not self.script_focus: self.script_focus = None elif type(self.script_focus) is not str: raise ValueError("script_focus content must be a string") self._checker() # any field_type specific checks def _adjust_font(self): """Ensure text_font is correctly spelled if empty or from our list. Otherwise assume the font is in an existing field. """ if not self.text_font: self.text_font = "Helv" return doc = self.parent.parent for f in doc.FormFonts + ["Cour", "TiRo", "Helv", "ZaDb"]: if self.text_font.lower() == f.lower(): self.text_font = f return self.text_font = "Helv" return def _parse_da(self): """Extract font name, size and color from default appearance string (/DA object). Equivalent to 'pdf_parse_default_appearance' function in MuPDF's 'pdf-annot.c'. """ if not self._text_da: return font = "Helv" fsize = 0 col = (0, 0, 0) dat = self._text_da.split() # split on any whitespace for i, item in enumerate(dat): if item == "Tf": font = dat[i - 2][1:] fsize = float(dat[i - 1]) dat[i] = dat[i-1] = dat[i-2] = "" continue if item == "g": # unicolor text col = [(float(dat[i - 1]))] dat[i] = dat[i-1] = "" continue if item == "rg": # RGB colored text col = [float(f) for f in dat[i - 3:i]] dat[i] = dat[i-1] = dat[i-2] = dat[i-3] = "" continue self.text_font = font self.text_fontsize = fsize self.text_color = col self._text_da = "" return def _checker(self): """Any widget type checks. """ if self.field_type not in range(1, 8): raise ValueError("bad field type") # if setting a radio button to ON, first set Off all buttons # in the group - this is not done by MuPDF: if self.field_type == PDF_WIDGET_TYPE_RADIOBUTTON and self.field_value not in (False, "Off") and hasattr(self, "parent"): # so we are about setting this button to ON/True # check other buttons in same group and set them to 'Off' doc = self.parent.parent kids_type, kids_value = doc.xref_get_key(self.xref, "Parent/Kids") if kids_type == "array": xrefs = tuple(map(int, kids_value[1:-1].replace("0 R","").split())) for xref in xrefs: if xref != self.xref: doc.xref_set_key(xref, "AS", "/Off") # the calling method will now set the intended button to on and # will find everything prepared for correct functioning. def update(self): """Reflect Python object in the PDF. """ doc = self.parent.parent self._validate() self._adjust_font() # ensure valid text_font name # now create the /DA string self._text_da = "" if len(self.text_color) == 3: fmt = "{:g} {:g} {:g} rg /{f:s} {s:g} Tf" + self._text_da elif len(self.text_color) == 1: fmt = "{:g} g /{f:s} {s:g} Tf" + self._text_da elif len(self.text_color) == 4: fmt = "{:g} {:g} {:g} {:g} k /{f:s} {s:g} Tf" + self._text_da self._text_da = fmt.format(*self.text_color, f=self.text_font, s=self.text_fontsize) # if widget has a '/AA/C' script, make sure it is in the '/CO' # array of the '/AcroForm' dictionary. if self.script_calc: # there is a "calculation" script: # make sure we are in the /CO array util_ensure_widget_calc(self._annot) # finally update the widget TOOLS._save_widget(self._annot, self) self._text_da = "" def button_states(self): """Return the on/off state names for button widgets. A button may have 'normal' or 'pressed down' appearances. While the 'Off' state is usually called like this, the 'On' state is often given a name relating to the functional context. """ if self.field_type not in (2, 5): return None # no button type if hasattr(self, "parent"): # field already exists on page doc = self.parent.parent else: return None xref = self.xref states = {"normal": None, "down": None} APN = doc.xref_get_key(xref, "AP/N") if APN[0] == "dict": nstates = [] APN = APN[1][2:-2] apnt = APN.split("/")[1:] for x in apnt: nstates.append(x.split()[0]) states["normal"] = nstates if APN[0] == "xref": nstates = [] nxref = int(APN[1].split(" ")[0]) APN = doc.xref_object(nxref) apnt = APN.split("/")[1:] for x in apnt: nstates.append(x.split()[0]) states["normal"] = nstates APD = doc.xref_get_key(xref, "AP/D") if APD[0] == "dict": dstates = [] APD = APD[1][2:-2] apdt = APD.split("/")[1:] for x in apdt: dstates.append(x.split()[0]) states["down"] = dstates if APD[0] == "xref": dstates = [] dxref = int(APD[1].split(" ")[0]) APD = doc.xref_object(dxref) apdt = APD.split("/")[1:] for x in apdt: dstates.append(x.split()[0]) states["down"] = dstates return states def on_state(self): """Return the "On" value for button widgets. This is useful for radio buttons mainly. Checkboxes will always return "Yes". Radio buttons will return the string that is unequal to "Off" as returned by method button_states(). If the radio button is new / being created, it does not yet have an "On" value. In this case, a warning is shown and True is returned. """ if self.field_type not in (2, 5): return None # no checkbox or radio button if self.field_type == 2: return "Yes" bstate = self.button_states() if bstate==None: bstate = {} for k in bstate.keys(): for v in bstate[k]: if v != "Off": return v print("warning: radio button has no 'On' value.") return True def reset(self): """Reset the field value to its default. """ TOOLS._reset_widget(self._annot) def __repr__(self): return "'%s' widget on %s" % (self.field_type_string, str(self.parent)) def __del__(self): if hasattr(self, "_annot"): del self._annot @property def next(self): return self._annot.next %} ================================================ FILE: src_classic/helper-fileobj.i ================================================ %{ //------------------------------------- // fz_output for Python file objects //------------------------------------- static void JM_bytesio_write(fz_context *ctx, void *opaque, const void *data, size_t len) { // bio.write(bytes object) PyObject *bio = opaque, *b, *name, *rc; fz_try(ctx){ b = PyBytes_FromStringAndSize((const char *) data, (Py_ssize_t) len); name = PyUnicode_FromString("write"); PyObject_CallMethodObjArgs(bio, name, b, NULL); rc = PyErr_Occurred(); if (rc) { RAISEPY(ctx, "could not write to Py file obj", rc); } } fz_always(ctx) { Py_XDECREF(b); Py_XDECREF(name); Py_XDECREF(rc); PyErr_Clear(); } fz_catch(ctx) { fz_rethrow(ctx); } } static void JM_bytesio_truncate(fz_context *ctx, void *opaque) { // bio.truncate(bio.tell()) !!! PyObject *bio = opaque, *trunc = NULL, *tell = NULL, *rctell= NULL, *rc = NULL; fz_try(ctx) { trunc = PyUnicode_FromString("truncate"); tell = PyUnicode_FromString("tell"); rctell = PyObject_CallMethodObjArgs(bio, tell, NULL); PyObject_CallMethodObjArgs(bio, trunc, rctell, NULL); rc = PyErr_Occurred(); if (rc) { RAISEPY(ctx, "could not truncate Py file obj", rc); } } fz_always(ctx) { Py_XDECREF(tell); Py_XDECREF(trunc); Py_XDECREF(rc); Py_XDECREF(rctell); PyErr_Clear(); } fz_catch(ctx) { fz_rethrow(ctx); } } static int64_t JM_bytesio_tell(fz_context *ctx, void *opaque) { // returns bio.tell() -> int PyObject *bio = opaque, *rc = NULL, *name = NULL; int64_t pos = 0; fz_try(ctx) { name = PyUnicode_FromString("tell"); rc = PyObject_CallMethodObjArgs(bio, name, NULL); if (!rc) { RAISEPY(ctx, "could not tell Py file obj", PyErr_Occurred()); } pos = (int64_t) PyLong_AsUnsignedLongLong(rc); } fz_always(ctx) { Py_XDECREF(name); Py_XDECREF(rc); PyErr_Clear(); } fz_catch(ctx) { fz_rethrow(ctx); } return pos; } static void JM_bytesio_seek(fz_context *ctx, void *opaque, int64_t off, int whence) { // bio.seek(off, whence=0) PyObject *bio = opaque, *rc = NULL, *name = NULL, *pos = NULL; fz_try(ctx) { name = PyUnicode_FromString("seek"); pos = PyLong_FromUnsignedLongLong((unsigned long long) off); PyObject_CallMethodObjArgs(bio, name, pos, whence, NULL); rc = PyErr_Occurred(); if (rc) { RAISEPY(ctx, "could not seek Py file obj", rc); } } fz_always(ctx) { Py_XDECREF(rc); Py_XDECREF(name); Py_XDECREF(pos); PyErr_Clear(); } fz_catch(ctx) { fz_rethrow(ctx); } } fz_output * JM_new_output_fileptr(fz_context *ctx, PyObject *bio) { fz_output *out = fz_new_output(ctx, 0, bio, JM_bytesio_write, NULL, NULL); out->seek = JM_bytesio_seek; out->tell = JM_bytesio_tell; out->truncate = JM_bytesio_truncate; return out; } %} ================================================ FILE: src_classic/helper-geo-c.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //----------------------------------------------------------------------------- // Functions converting betwenn PySequences and fitz geometry objects //----------------------------------------------------------------------------- static int JM_INT_ITEM(PyObject *obj, Py_ssize_t idx, int *result) { PyObject *temp = PySequence_ITEM(obj, idx); if (!temp) return 1; if (PyLong_Check(temp)) { *result = (int) PyLong_AsLong(temp); Py_DECREF(temp); } else if (PyFloat_Check(temp)) { *result = (int) PyFloat_AsDouble(temp); Py_DECREF(temp); } else { Py_DECREF(temp); return 1; } if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } static int JM_FLOAT_ITEM(PyObject *obj, Py_ssize_t idx, double *result) { PyObject *temp = PySequence_ITEM(obj, idx); if (!temp) return 1; *result = PyFloat_AsDouble(temp); Py_DECREF(temp); if (PyErr_Occurred()) { PyErr_Clear(); return 1; } return 0; } static fz_point JM_normalize_vector(float x, float y) { double px = x, py = y, len = (double) (x * x + y * y); if (len != 0) { len = sqrt(len); px /= len; py /= len; } return fz_make_point((float) px, (float) py); } //----------------------------------------------------------------------------- // PySequence to fz_rect. Default: infinite rect //----------------------------------------------------------------------------- static fz_rect JM_rect_from_py(PyObject *r) { if (!r || !PySequence_Check(r) || PySequence_Size(r) != 4) return fz_infinite_rect; Py_ssize_t i; double f[4]; for (i = 0; i < 4; i++) { if (JM_FLOAT_ITEM(r, i, &f[i]) == 1) return fz_infinite_rect; if (f[i] < FZ_MIN_INF_RECT) f[i] = FZ_MIN_INF_RECT; if (f[i] > FZ_MAX_INF_RECT) f[i] = FZ_MAX_INF_RECT; } return fz_make_rect((float) f[0], (float) f[1], (float) f[2], (float) f[3]); } //----------------------------------------------------------------------------- // PySequence from fz_rect //----------------------------------------------------------------------------- static PyObject * JM_py_from_rect(fz_rect r) { return Py_BuildValue("ffff", r.x0, r.y0, r.x1, r.y1); } //----------------------------------------------------------------------------- // PySequence to fz_irect. Default: infinite irect //----------------------------------------------------------------------------- static fz_irect JM_irect_from_py(PyObject *r) { if (!r || !PySequence_Check(r) || PySequence_Size(r) != 4) return fz_infinite_irect; int x[4]; Py_ssize_t i; for (i = 0; i < 4; i++) { if (JM_INT_ITEM(r, i, &x[i]) == 1) return fz_infinite_irect; if (x[i] < FZ_MIN_INF_RECT) x[i] = FZ_MIN_INF_RECT; if (x[i] > FZ_MAX_INF_RECT) x[i] = FZ_MAX_INF_RECT; } return fz_make_irect(x[0], x[1], x[2], x[3]); } //----------------------------------------------------------------------------- // PySequence from fz_irect //----------------------------------------------------------------------------- static PyObject * JM_py_from_irect(fz_irect r) { return Py_BuildValue("iiii", r.x0, r.y0, r.x1, r.y1); } //----------------------------------------------------------------------------- // PySequence to fz_point. Default: (FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) //----------------------------------------------------------------------------- static fz_point JM_point_from_py(PyObject *p) { fz_point p0 = fz_make_point(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT); double x, y; if (!p || !PySequence_Check(p) || PySequence_Size(p) != 2) return p0; if (JM_FLOAT_ITEM(p, 0, &x) == 1) return p0; if (JM_FLOAT_ITEM(p, 1, &y) == 1) return p0; if (x < FZ_MIN_INF_RECT) x = FZ_MIN_INF_RECT; if (y < FZ_MIN_INF_RECT) y = FZ_MIN_INF_RECT; if (x > FZ_MAX_INF_RECT) x = FZ_MAX_INF_RECT; if (y > FZ_MAX_INF_RECT) y = FZ_MAX_INF_RECT; return fz_make_point((float) x, (float) y); } //----------------------------------------------------------------------------- // PySequence from fz_point //----------------------------------------------------------------------------- static PyObject * JM_py_from_point(fz_point p) { return Py_BuildValue("ff", p.x, p.y); } //----------------------------------------------------------------------------- // PySequence to fz_matrix. Default: fz_identity //----------------------------------------------------------------------------- static fz_matrix JM_matrix_from_py(PyObject *m) { Py_ssize_t i; double a[6]; if (!m || !PySequence_Check(m) || PySequence_Size(m) != 6) return fz_identity; for (i = 0; i < 6; i++) if (JM_FLOAT_ITEM(m, i, &a[i]) == 1) return fz_identity; return fz_make_matrix((float) a[0], (float) a[1], (float) a[2], (float) a[3], (float) a[4], (float) a[5]); } //----------------------------------------------------------------------------- // PySequence from fz_matrix //----------------------------------------------------------------------------- static PyObject * JM_py_from_matrix(fz_matrix m) { return Py_BuildValue("ffffff", m.a, m.b, m.c, m.d, m.e, m.f); } //----------------------------------------------------------------------------- // fz_quad from PySequence. Four floats are treated as rect. // Else must be four pairs of floats. //----------------------------------------------------------------------------- static fz_quad JM_quad_from_py(PyObject *r) { fz_quad q = fz_make_quad(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT); fz_point p[4]; double test, x, y; Py_ssize_t i; PyObject *obj = NULL; if (!r || !PySequence_Check(r) || PySequence_Size(r) != 4) return q; if (JM_FLOAT_ITEM(r, 0, &test) == 0) return fz_quad_from_rect(JM_rect_from_py(r)); for (i = 0; i < 4; i++) { obj = PySequence_ITEM(r, i); // next point item if (!obj || !PySequence_Check(obj) || PySequence_Size(obj) != 2) goto exit_result; // invalid: cancel the rest if (JM_FLOAT_ITEM(obj, 0, &x) == 1) goto exit_result; if (JM_FLOAT_ITEM(obj, 1, &y) == 1) goto exit_result; if (x < FZ_MIN_INF_RECT) x = FZ_MIN_INF_RECT; if (y < FZ_MIN_INF_RECT) y = FZ_MIN_INF_RECT; if (x > FZ_MAX_INF_RECT) x = FZ_MAX_INF_RECT; if (y > FZ_MAX_INF_RECT) y = FZ_MAX_INF_RECT; p[i] = fz_make_point((float) x, (float) y); Py_CLEAR(obj); } q.ul = p[0]; q.ur = p[1]; q.ll = p[2]; q.lr = p[3]; return q; exit_result:; Py_CLEAR(obj); return q; } //----------------------------------------------------------------------------- // PySequence from fz_quad. //----------------------------------------------------------------------------- static PyObject * JM_py_from_quad(fz_quad q) { return Py_BuildValue("((f,f),(f,f),(f,f),(f,f))", q.ul.x, q.ul.y, q.ur.x, q.ur.y, q.ll.x, q.ll.y, q.lr.x, q.lr.y); } %} ================================================ FILE: src_classic/helper-geo-py.i ================================================ %pythoncode %{ # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ # largest 32bit integers surviving C float conversion roundtrips # used by MuPDF to define infinite rectangles FZ_MIN_INF_RECT = -0x80000000 FZ_MAX_INF_RECT = 0x7fffff80 class Matrix(object): """Matrix() - all zeros Matrix(a, b, c, d, e, f) Matrix(zoom-x, zoom-y) - zoom Matrix(shear-x, shear-y, 1) - shear Matrix(degree) - rotate Matrix(Matrix) - new copy Matrix(sequence) - from 'sequence'""" def __init__(self, *args): if not args: self.a = self.b = self.c = self.d = self.e = self.f = 0.0 return None if len(args) > 6: raise ValueError("Matrix: bad seq len") if len(args) == 6: # 6 numbers self.a, self.b, self.c, self.d, self.e, self.f = map(float, args) return None if len(args) == 1: # either an angle or a sequ if hasattr(args[0], "__float__"): theta = math.radians(args[0]) c = round(math.cos(theta), 12) s = round(math.sin(theta), 12) self.a = self.d = c self.b = s self.c = -s self.e = self.f = 0.0 return None else: self.a, self.b, self.c, self.d, self.e, self.f = map(float, args[0]) return None if len(args) == 2 or len(args) == 3 and args[2] == 0: self.a, self.b, self.c, self.d, self.e, self.f = float(args[0]), \ 0.0, 0.0, float(args[1]), 0.0, 0.0 return None if len(args) == 3 and args[2] == 1: self.a, self.b, self.c, self.d, self.e, self.f = 1.0, \ float(args[1]), float(args[0]), 1.0, 0.0, 0.0 return None raise ValueError("Matrix: bad args") def invert(self, src=None): """Calculate the inverted matrix. Return 0 if successful and replace current one. Else return 1 and do nothing. """ if src is None: dst = util_invert_matrix(self) else: dst = util_invert_matrix(src) if dst[0] == 1: return 1 self.a, self.b, self.c, self.d, self.e, self.f = dst[1] return 0 def pretranslate(self, tx, ty): """Calculate pre translation and replace current matrix.""" tx = float(tx) ty = float(ty) self.e += tx * self.a + ty * self.c self.f += tx * self.b + ty * self.d return self def prescale(self, sx, sy): """Calculate pre scaling and replace current matrix.""" sx = float(sx) sy = float(sy) self.a *= sx self.b *= sx self.c *= sy self.d *= sy return self def preshear(self, h, v): """Calculate pre shearing and replace current matrix.""" h = float(h) v = float(v) a, b = self.a, self.b self.a += v * self.c self.b += v * self.d self.c += h * a self.d += h * b return self def prerotate(self, theta): """Calculate pre rotation and replace current matrix.""" theta = float(theta) while theta < 0: theta += 360 while theta >= 360: theta -= 360 if abs(0 - theta) < EPSILON: pass elif abs(90.0 - theta) < EPSILON: a = self.a b = self.b self.a = self.c self.b = self.d self.c = -a self.d = -b elif abs(180.0 - theta) < EPSILON: self.a = -self.a self.b = -self.b self.c = -self.c self.d = -self.d elif abs(270.0 - theta) < EPSILON: a = self.a b = self.b self.a = -self.c self.b = -self.d self.c = a self.d = b else: rad = math.radians(theta) s = math.sin(rad) c = math.cos(rad) a = self.a b = self.b self.a = c * a + s * self.c self.b = c * b + s * self.d self.c =-s * a + c * self.c self.d =-s * b + c * self.d return self def concat(self, one, two): """Multiply two matrices and replace current one.""" if not len(one) == len(two) == 6: raise ValueError("Matrix: bad seq len") self.a, self.b, self.c, self.d, self.e, self.f = util_concat_matrix(one, two) return self def __getitem__(self, i): return (self.a, self.b, self.c, self.d, self.e, self.f)[i] def __setitem__(self, i, v): v = float(v) if i == 0: self.a = v elif i == 1: self.b = v elif i == 2: self.c = v elif i == 3: self.d = v elif i == 4: self.e = v elif i == 5: self.f = v else: raise IndexError("index out of range") return def __len__(self): return 6 def __repr__(self): return "Matrix" + str(tuple(self)) def __invert__(self): """Calculate inverted matrix.""" m1 = Matrix() m1.invert(self) return m1 __inv__ = __invert__ def __mul__(self, m): if hasattr(m, "__float__"): return Matrix(self.a * m, self.b * m, self.c * m, self.d * m, self.e * m, self.f * m) m1 = Matrix(1,1) return m1.concat(self, m) def __truediv__(self, m): if hasattr(m, "__float__"): return Matrix(self.a * 1./m, self.b * 1./m, self.c * 1./m, self.d * 1./m, self.e * 1./m, self.f * 1./m) m1 = util_invert_matrix(m)[1] if not m1: raise ZeroDivisionError("matrix not invertible") m2 = Matrix(1,1) return m2.concat(self, m1) __div__ = __truediv__ def __add__(self, m): if hasattr(m, "__float__"): return Matrix(self.a + m, self.b + m, self.c + m, self.d + m, self.e + m, self.f + m) if len(m) != 6: raise ValueError("Matrix: bad seq len") return Matrix(self.a + m[0], self.b + m[1], self.c + m[2], self.d + m[3], self.e + m[4], self.f + m[5]) def __sub__(self, m): if hasattr(m, "__float__"): return Matrix(self.a - m, self.b - m, self.c - m, self.d - m, self.e - m, self.f - m) if len(m) != 6: raise ValueError("Matrix: bad seq len") return Matrix(self.a - m[0], self.b - m[1], self.c - m[2], self.d - m[3], self.e - m[4], self.f - m[5]) def __pos__(self): return Matrix(self) def __neg__(self): return Matrix(-self.a, -self.b, -self.c, -self.d, -self.e, -self.f) def __bool__(self): return not (max(self) == min(self) == 0) def __nonzero__(self): return not (max(self) == min(self) == 0) def __eq__(self, mat): if not hasattr(mat, "__len__"): return False return len(mat) == 6 and bool(self - mat) is False def __abs__(self): return math.sqrt(sum([c*c for c in self])) norm = __abs__ @property def is_rectilinear(self): """True if rectangles are mapped to rectangles.""" return (abs(self.b) < EPSILON and abs(self.c) < EPSILON) or \ (abs(self.a) < EPSILON and abs(self.d) < EPSILON); class IdentityMatrix(Matrix): """Identity matrix [1, 0, 0, 1, 0, 0]""" def __init__(self): Matrix.__init__(self, 1.0, 1.0) def __setattr__(self, name, value): if name in "ad": self.__dict__[name] = 1.0 elif name in "bcef": self.__dict__[name] = 0.0 else: self.__dict__[name] = value def checkargs(*args): raise NotImplementedError("Identity is readonly") prerotate = checkargs preshear = checkargs prescale = checkargs pretranslate = checkargs concat = checkargs invert = checkargs def __repr__(self): return "IdentityMatrix(1.0, 0.0, 0.0, 1.0, 0.0, 0.0)" def __hash__(self): return hash((1,0,0,1,0,0)) Identity = IdentityMatrix() class Point(object): """Point() - all zeros\nPoint(x, y)\nPoint(Point) - new copy\nPoint(sequence) - from 'sequence'""" def __init__(self, *args): if not args: self.x = 0.0 self.y = 0.0 return None if len(args) > 2: raise ValueError("Point: bad seq len") if len(args) == 2: self.x = float(args[0]) self.y = float(args[1]) return None if len(args) == 1: l = args[0] if hasattr(l, "__getitem__") is False: raise ValueError("Point: bad args") if len(l) != 2: raise ValueError("Point: bad seq len") self.x = float(l[0]) self.y = float(l[1]) return None raise ValueError("Point: bad args") def transform(self, m): """Replace point by its transformation with matrix-like m.""" if len(m) != 6: raise ValueError("Matrix: bad seq len") self.x, self.y = util_transform_point(self, m) return self @property def unit(self): """Unit vector of the point.""" s = self.x * self.x + self.y * self.y if s < EPSILON: return Point(0,0) s = math.sqrt(s) return Point(self.x / s, self.y / s) @property def abs_unit(self): """Unit vector with positive coordinates.""" s = self.x * self.x + self.y * self.y if s < EPSILON: return Point(0,0) s = math.sqrt(s) return Point(abs(self.x) / s, abs(self.y) / s) def distance_to(self, *args): """Return distance to rectangle or another point.""" if not len(args) > 0: raise ValueError("at least one parameter must be given") x = args[0] if len(x) == 2: x = Point(x) elif len(x) == 4: x = Rect(x) else: raise ValueError("arg1 must be point-like or rect-like") if len(args) > 1: unit = args[1] else: unit = "px" u = {"px": (1.,1.), "in": (1.,72.), "cm": (2.54, 72.), "mm": (25.4, 72.)} f = u[unit][0] / u[unit][1] if type(x) is Point: return abs(self - x) * f # from here on, x is a rectangle # as a safeguard, make a finite copy of it r = Rect(x.top_left, x.top_left) r = r | x.bottom_right if self in r: return 0.0 if self.x > r.x1: if self.y >= r.y1: return self.distance_to(r.bottom_right, unit) elif self.y <= r.y0: return self.distance_to(r.top_right, unit) else: return (self.x - r.x1) * f elif r.x0 <= self.x <= r.x1: if self.y >= r.y1: return (self.y - r.y1) * f else: return (r.y0 - self.y) * f else: if self.y >= r.y1: return self.distance_to(r.bottom_left, unit) elif self.y <= r.y0: return self.distance_to(r.top_left, unit) else: return (r.x0 - self.x) * f def __getitem__(self, i): return (self.x, self.y)[i] def __len__(self): return 2 def __setitem__(self, i, v): v = float(v) if i == 0: self.x = v elif i == 1: self.y = v else: raise IndexError("index out of range") return None def __repr__(self): return "Point" + str(tuple(self)) def __pos__(self): return Point(self) def __neg__(self): return Point(-self.x, -self.y) def __bool__(self): return not (max(self) == min(self) == 0) def __nonzero__(self): return not (max(self) == min(self) == 0) def __eq__(self, p): if not hasattr(p, "__len__"): return False return len(p) == 2 and bool(self - p) is False def __abs__(self): return math.sqrt(self.x * self.x + self.y * self.y) norm = __abs__ def __add__(self, p): if hasattr(p, "__float__"): return Point(self.x + p, self.y + p) if len(p) != 2: raise ValueError("Point: bad seq len") return Point(self.x + p[0], self.y + p[1]) def __sub__(self, p): if hasattr(p, "__float__"): return Point(self.x - p, self.y - p) if len(p) != 2: raise ValueError("Point: bad seq len") return Point(self.x - p[0], self.y - p[1]) def __mul__(self, m): if hasattr(m, "__float__"): return Point(self.x * m, self.y * m) p = Point(self) return p.transform(m) def __truediv__(self, m): if hasattr(m, "__float__"): return Point(self.x * 1./m, self.y * 1./m) m1 = util_invert_matrix(m)[1] if not m1: raise ZeroDivisionError("matrix not invertible") p = Point(self) return p.transform(m1) __div__ = __truediv__ def __hash__(self): return hash(tuple(self)) class Rect(object): """Rect() - all zeros Rect(x0, y0, x1, y1) - 4 coordinates Rect(top-left, x1, y1) - point and 2 coordinates Rect(x0, y0, bottom-right) - 2 coordinates and point Rect(top-left, bottom-right) - 2 points Rect(sequ) - new from sequence or rect-like """ def __init__(self, *args): self.x0, self.y0, self.x1, self.y1 = util_make_rect(args) return None def normalize(self): """Replace rectangle with its valid version.""" if self.x1 < self.x0: self.x0, self.x1 = self.x1, self.x0 if self.y1 < self.y0: self.y0, self.y1 = self.y1, self.y0 return self @property def is_empty(self): """True if rectangle area is empty.""" return self.x0 >= self.x1 or self.y0 >= self.y1 @property def is_valid(self): """True if rectangle is valid.""" return self.x0 <= self.x1 and self.y0 <= self.y1 @property def is_infinite(self): """True if this is the infinite rectangle.""" return self.x0 == self.y0 == FZ_MIN_INF_RECT and self.x1 == self.y1 == FZ_MAX_INF_RECT @property def top_left(self): """Top-left corner.""" return Point(self.x0, self.y0) @property def top_right(self): """Top-right corner.""" return Point(self.x1, self.y0) @property def bottom_left(self): """Bottom-left corner.""" return Point(self.x0, self.y1) @property def bottom_right(self): """Bottom-right corner.""" return Point(self.x1, self.y1) tl = top_left tr = top_right bl = bottom_left br = bottom_right @property def quad(self): """Return Quad version of rectangle.""" return Quad(self.tl, self.tr, self.bl, self.br) def torect(self, r): """Return matrix that converts to target rect.""" r = Rect(r) if self.is_infinite or self.is_empty or r.is_infinite or r.is_empty: raise ValueError("rectangles must be finite and not empty") return ( Matrix(1, 0, 0, 1, -self.x0, -self.y0) * Matrix(r.width / self.width, r.height / self.height) * Matrix(1, 0, 0, 1, r.x0, r.y0) ) def morph(self, p, m): """Morph with matrix-like m and point-like p. Returns a new quad.""" if self.is_infinite: return INFINITE_QUAD() return self.quad.morph(p, m) def round(self): """Return the IRect.""" return IRect(util_round_rect(self)) irect = property(round) width = property(lambda self: self.x1 - self.x0 if self.x1 > self.x0 else 0) height = property(lambda self: self.y1 - self.y0 if self.y1 > self.y0 else 0) def include_point(self, p): """Extend to include point-like p.""" if len(p) != 2: raise ValueError("Point: bad seq len") self.x0, self.y0, self.x1, self.y1 = util_include_point_in_rect(self, p) return self def include_rect(self, r): """Extend to include rect-like r.""" if len(r) != 4: raise ValueError("Rect: bad seq len") r = Rect(r) if r.is_infinite or self.is_infinite: self.x0, self.y0, self.x1, self.y1 = FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT elif r.is_empty: return self elif self.is_empty: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 else: self.x0, self.y0, self.x1, self.y1 = util_union_rect(self, r) return self def intersect(self, r): """Restrict to common rect with rect-like r.""" if not len(r) == 4: raise ValueError("Rect: bad seq len") r = Rect(r) if r.is_infinite: return self elif self.is_infinite: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 elif r.is_empty: self.x0, self.y0, self.x1, self.y1 = r.x0, r.y0, r.x1, r.y1 elif self.is_empty: return self else: self.x0, self.y0, self.x1, self.y1 = util_intersect_rect(self, r) return self def contains(self, x): """Check if containing point-like or rect-like x.""" return self.__contains__(x) def transform(self, m): """Replace with the transformation by matrix-like m.""" if not len(m) == 6: raise ValueError("Matrix: bad seq len") self.x0, self.y0, self.x1, self.y1 = util_transform_rect(self, m) return self def __getitem__(self, i): return (self.x0, self.y0, self.x1, self.y1)[i] def __len__(self): return 4 def __setitem__(self, i, v): v = float(v) if i == 0: self.x0 = v elif i == 1: self.y0 = v elif i == 2: self.x1 = v elif i == 3: self.y1 = v else: raise IndexError("index out of range") return None def __repr__(self): return "Rect" + str(tuple(self)) def __pos__(self): return Rect(self) def __neg__(self): return Rect(-self.x0, -self.y0, -self.x1, -self.y1) def __bool__(self): return not self.x0 == self.y0 == self.x1 == self.y1 == 0 def __nonzero__(self): return not self.x0 == self.y0 == self.x1 == self.y1 == 0 def __eq__(self, r): if not hasattr(r, "__len__"): return False return len(r) == 4 and self.x0 == r[0] and self.y0 == r[1] and self.x1 == r[2] and self.y1 == r[3] def __abs__(self): if self.is_infinite or not self.is_valid: return 0.0 return self.width * self.height def norm(self): return math.sqrt(sum([c*c for c in self])) def __add__(self, p): if hasattr(p, "__float__"): return Rect(self.x0 + p, self.y0 + p, self.x1 + p, self.y1 + p) if len(p) != 4: raise ValueError("Rect: bad seq len") return Rect(self.x0 + p[0], self.y0 + p[1], self.x1 + p[2], self.y1 + p[3]) def __sub__(self, p): if hasattr(p, "__float__"): return Rect(self.x0 - p, self.y0 - p, self.x1 - p, self.y1 - p) if len(p) != 4: raise ValueError("Rect: bad seq len") return Rect(self.x0 - p[0], self.y0 - p[1], self.x1 - p[2], self.y1 - p[3]) def __mul__(self, m): if hasattr(m, "__float__"): return Rect(self.x0 * m, self.y0 * m, self.x1 * m, self.y1 * m) r = Rect(self) r = r.transform(m) return r def __truediv__(self, m): if hasattr(m, "__float__"): return Rect(self.x0 * 1./m, self.y0 * 1./m, self.x1 * 1./m, self.y1 * 1./m) im = util_invert_matrix(m)[1] if not im: raise ZeroDivisionError("Matrix not invertible") r = Rect(self) r = r.transform(im) return r __div__ = __truediv__ def __contains__(self, x): if hasattr(x, "__float__"): return x in tuple(self) l = len(x) if l == 2: return util_is_point_in_rect(x, self) if l == 4: r = INFINITE_RECT() try: r = Rect(x) except: r = Quad(x).rect return (self.x0 <= r.x0 <= r.x1 <= self.x1 and self.y0 <= r.y0 <= r.y1 <= self.y1) return False def __or__(self, x): if not hasattr(x, "__len__"): raise ValueError("bad type op 2") r = Rect(self) if len(x) == 2: return r.include_point(x) if len(x) == 4: return r.include_rect(x) raise ValueError("bad type op 2") def __and__(self, x): if not hasattr(x, "__len__") or len(x) != 4: raise ValueError("bad type op 2") r = Rect(self) return r.intersect(x) def intersects(self, x): """Check if intersection with rectangle x is not empty.""" r1 = Rect(x) if self.is_empty or self.is_infinite or r1.is_empty or r1.is_infinite: return False r = Rect(self) if r.intersect(r1).is_empty: return False return True def __hash__(self): return hash(tuple(self)) class IRect(object): """IRect() - all zeros IRect(x0, y0, x1, y1) - 4 coordinates IRect(top-left, x1, y1) - point and 2 coordinates IRect(x0, y0, bottom-right) - 2 coordinates and point IRect(top-left, bottom-right) - 2 points IRect(sequ) - new from sequence or rect-like """ def __init__(self, *args): self.x0, self.y0, self.x1, self.y1 = util_make_irect(args) return None def normalize(self): """Replace rectangle with its valid version.""" if self.x1 < self.x0: self.x0, self.x1 = self.x1, self.x0 if self.y1 < self.y0: self.y0, self.y1 = self.y1, self.y0 return self @property def is_empty(self): """True if rectangle area is empty.""" return self.x0 >= self.x1 or self.y0 >= self.y1 @property def is_valid(self): """True if rectangle is valid.""" return self.x0 <= self.x1 and self.y0 <= self.y1 @property def is_infinite(self): """True if rectangle is infinite.""" return self.x0 == self.y0 == FZ_MIN_INF_RECT and self.x1 == self.y1 == FZ_MAX_INF_RECT @property def top_left(self): """Top-left corner.""" return Point(self.x0, self.y0) @property def top_right(self): """Top-right corner.""" return Point(self.x1, self.y0) @property def bottom_left(self): """Bottom-left corner.""" return Point(self.x0, self.y1) @property def bottom_right(self): """Bottom-right corner.""" return Point(self.x1, self.y1) tl = top_left tr = top_right bl = bottom_left br = bottom_right @property def quad(self): """Return Quad version of rectangle.""" return Quad(self.tl, self.tr, self.bl, self.br) def torect(self, r): """Return matrix that converts to target rect.""" r = Rect(r) if self.is_infinite or self.is_empty or r.is_infinite or r.is_empty: raise ValueError("rectangles must be finite and not empty") return ( Matrix(1, 0, 0, 1, -self.x0, -self.y0) * Matrix(r.width / self.width, r.height / self.height) * Matrix(1, 0, 0, 1, r.x0, r.y0) ) def morph(self, p, m): """Morph with matrix-like m and point-like p. Returns a new quad.""" if self.is_infinite: return INFINITE_QUAD() return self.quad.morph(p, m) @property def rect(self): return Rect(self) width = property(lambda self: self.x1 - self.x0 if self.x1 > self.x0 else 0) height = property(lambda self: self.y1 - self.y0 if self.y1 > self.y0 else 0) def include_point(self, p): """Extend rectangle to include point p.""" rect = self.rect.include_point(p) return rect.irect def include_rect(self, r): """Extend rectangle to include rectangle r.""" rect = self.rect.include_rect(r) return rect.irect def intersect(self, r): """Restrict rectangle to intersection with rectangle r.""" rect = self.rect.intersect(r) return rect.irect def __getitem__(self, i): return (self.x0, self.y0, self.x1, self.y1)[i] def __len__(self): return 4 def __setitem__(self, i, v): v = int(v) if i == 0: self.x0 = v elif i == 1: self.y0 = v elif i == 2: self.x1 = v elif i == 3: self.y1 = v else: raise IndexError("index out of range") return None def __repr__(self): return "IRect" + str(tuple(self)) def __pos__(self): return IRect(self) def __neg__(self): return IRect(-self.x0, -self.y0, -self.x1, -self.y1) def __bool__(self): return not self.x0 == self.y0 == self.x1 == self.y1 == 0 def __nonzero__(self): return not self.x0 == self.y0 == self.x1 == self.y1 == 0 def __eq__(self, r): if not hasattr(r, "__len__"): return False return len(r) == 4 and self.x0 == r[0] and self.y0 == r[1] and self.x1 == r[2] and self.y1 == r[3] def __abs__(self): if self.is_infinite or not self.is_valid: return 0 return self.width * self.height def norm(self): return math.sqrt(sum([c*c for c in self])) def __add__(self, p): return Rect.__add__(self, p).round() def __sub__(self, p): return Rect.__sub__(self, p).round() def transform(self, m): return Rect.transform(self, m).round() def __mul__(self, m): return Rect.__mul__(self, m).round() def __truediv__(self, m): return Rect.__truediv__(self, m).round() __div__ = __truediv__ def __contains__(self, x): return Rect.__contains__(self, x) def __or__(self, x): return Rect.__or__(self, x).round() def __and__(self, x): return Rect.__and__(self, x).round() def intersects(self, x): return Rect.intersects(self, x) def __hash__(self): return hash(tuple(self)) class Quad(object): """Quad() - all zero points\nQuad(ul, ur, ll, lr)\nQuad(quad) - new copy\nQuad(sequence) - from 'sequence'""" def __init__(self, *args): if not args: self.ul = self.ur = self.ll = self.lr = Point() return None if len(args) > 4: raise ValueError("Quad: bad seq len") if len(args) == 4: self.ul, self.ur, self.ll, self.lr = map(Point, args) return None if len(args) == 1: l = args[0] if hasattr(l, "__getitem__") is False: raise ValueError("Quad: bad args") if len(l) != 4: raise ValueError("Quad: bad seq len") self.ul, self.ur, self.ll, self.lr = map(Point, l) return None raise ValueError("Quad: bad args") @property def is_rectangular(self)->bool: """Check if quad is rectangular. Notes: Some rotation matrix can thus transform it into a rectangle. This is equivalent to three corners enclose 90 degrees. Returns: True or False. """ sine = util_sine_between(self.ul, self.ur, self.lr) if abs(sine - 1) > EPSILON: # the sine of the angle return False sine = util_sine_between(self.ur, self.lr, self.ll) if abs(sine - 1) > EPSILON: return False sine = util_sine_between(self.lr, self.ll, self.ul) if abs(sine - 1) > EPSILON: return False return True @property def is_convex(self)->bool: """Check if quad is convex and not degenerate. Notes: Check that for the two diagonals, the other two corners are not on the same side of the diagonal. Returns: True or False. """ m = planish_line(self.ul, self.lr) # puts this diagonal on x-axis p1 = self.ll * m # transform the p2 = self.ur * m # other two points if p1.y * p2.y > 0: return False m = planish_line(self.ll, self.ur) # puts other diagonal on x-axis p1 = self.lr * m # tranform the p2 = self.ul * m # remaining points if p1.y * p2.y > 0: return False return True width = property(lambda self: max(abs(self.ul - self.ur), abs(self.ll - self.lr))) height = property(lambda self: max(abs(self.ul - self.ll), abs(self.ur - self.lr))) @property def is_empty(self): """Check whether all quad corners are on the same line. This is the case if width or height is zero. """ return self.width < EPSILON or self.height < EPSILON @property def is_infinite(self): """Check whether this is the infinite quad.""" return self.rect.is_infinite @property def rect(self): r = Rect() r.x0 = min(self.ul.x, self.ur.x, self.lr.x, self.ll.x) r.y0 = min(self.ul.y, self.ur.y, self.lr.y, self.ll.y) r.x1 = max(self.ul.x, self.ur.x, self.lr.x, self.ll.x) r.y1 = max(self.ul.y, self.ur.y, self.lr.y, self.ll.y) return r def __contains__(self, x): try: l = x.__len__() except: return False if l == 2: return util_point_in_quad(x, self) if l != 4: return False if CheckRect(x): if Rect(x).is_empty: return True return util_point_in_quad(x[:2], self) and util_point_in_quad(x[2:], self) if CheckQuad(x): for i in range(4): if not util_point_in_quad(x[i], self): return False return True return False def __getitem__(self, i): return (self.ul, self.ur, self.ll, self.lr)[i] def __len__(self): return 4 def __setitem__(self, i, v): if i == 0: self.ul = Point(v) elif i == 1: self.ur = Point(v) elif i == 2: self.ll = Point(v) elif i == 3: self.lr = Point(v) else: raise IndexError("index out of range") return None def __repr__(self): return "Quad" + str(tuple(self)) def __pos__(self): return Quad(self) def __neg__(self): return Quad(-self.ul, -self.ur, -self.ll, -self.lr) def __bool__(self): return not self.is_empty def __nonzero__(self): return not self.is_empty def __eq__(self, quad): if not hasattr(quad, "__len__"): return False return len(quad) == 4 and ( self.ul == quad[0] and self.ur == quad[1] and self.ll == quad[2] and self.lr == quad[3] ) def __abs__(self): if self.is_empty: return 0.0 return abs(self.ul - self.ur) * abs(self.ul - self.ll) def morph(self, p, m): """Morph the quad with matrix-like 'm' and point-like 'p'. Return a new quad.""" if self.is_infinite: return INFINITE_QUAD() delta = Matrix(1, 1).pretranslate(p.x, p.y) q = self * ~delta * m * delta return q def transform(self, m): """Replace quad by its transformation with matrix m.""" if hasattr(m, "__float__"): pass elif len(m) != 6: raise ValueError("Matrix: bad seq len") self.ul *= m self.ur *= m self.ll *= m self.lr *= m return self def __mul__(self, m): q = Quad(self) q = q.transform(m) return q def __add__(self, q): if hasattr(q, "__float__"): return Quad(self.ul + q, self.ur + q, self.ll + q, self.lr + q) if len(p) != 4: raise ValueError("Quad: bad seq len") return Quad(self.ul + q[0], self.ur + q[1], self.ll + q[2], self.lr + q[3]) def __sub__(self, q): if hasattr(q, "__float__"): return Quad(self.ul - q, self.ur - q, self.ll - q, self.lr - q) if len(p) != 4: raise ValueError("Quad: bad seq len") return Quad(self.ul - q[0], self.ur - q[1], self.ll - q[2], self.lr - q[3]) def __truediv__(self, m): if hasattr(m, "__float__"): im = 1. / m else: im = util_invert_matrix(m)[1] if not im: raise ZeroDivisionError("Matrix not invertible") q = Quad(self) q = q.transform(im) return q __div__ = __truediv__ def __hash__(self): return hash(tuple(self)) # some special geometry objects def EMPTY_RECT(): return Rect(FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) def INFINITE_RECT(): return Rect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT) def EMPTY_IRECT(): return IRect(FZ_MAX_INF_RECT, FZ_MAX_INF_RECT, FZ_MIN_INF_RECT, FZ_MIN_INF_RECT) def INFINITE_IRECT(): return IRect(FZ_MIN_INF_RECT, FZ_MIN_INF_RECT, FZ_MAX_INF_RECT, FZ_MAX_INF_RECT) def INFINITE_QUAD(): return INFINITE_RECT().quad def EMPTY_QUAD(): return EMPTY_RECT().quad %} ================================================ FILE: src_classic/helper-globals.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ // Global switches // Switch for device hints = no cache static int no_device_caching = 0; // Switch for computing glyph of fontsize height static int small_glyph_heights = 0; // Switch for returning fontnames including subset prefix static int subset_fontnames = 0; // Unset ascender / descender corrections static int skip_quad_corrections = 0; // constants: error messages static const char MSG_BAD_ANNOT_TYPE[] = "bad annot type"; static const char MSG_BAD_APN[] = "bad or missing annot AP/N"; static const char MSG_BAD_ARG_INK_ANNOT[] = "arg must be seq of seq of float pairs"; static const char MSG_BAD_ARG_POINTS[] = "bad seq of points"; static const char MSG_BAD_BUFFER[] = "bad type: 'buffer'"; static const char MSG_BAD_COLOR_SEQ[] = "bad color sequence"; static const char MSG_BAD_DOCUMENT[] = "cannot open broken document"; static const char MSG_BAD_FILETYPE[] = "bad filetype"; static const char MSG_BAD_LOCATION[] = "bad location"; static const char MSG_BAD_OC_CONFIG[] = "bad config number"; static const char MSG_BAD_OC_LAYER[] = "bad layer number"; static const char MSG_BAD_OC_REF[] = "bad 'oc' reference"; static const char MSG_BAD_PAGEID[] = "bad page id"; static const char MSG_BAD_PAGENO[] = "bad page number(s)"; static const char MSG_BAD_PDFROOT[] = "PDF has no root"; static const char MSG_BAD_RECT[] = "rect is infinite or empty"; static const char MSG_BAD_TEXT[] = "bad type: 'text'"; static const char MSG_BAD_XREF[] = "bad xref"; static const char MSG_COLOR_COUNT_FAILED[] = "color count failed"; static const char MSG_FILE_OR_BUFFER[] = "need font file or buffer"; static const char MSG_FONT_FAILED[] = "cannot create font"; static const char MSG_IS_NO_ANNOT[] = "is no annotation"; static const char MSG_IS_NO_IMAGE[] = "is no image"; static const char MSG_IS_NO_PDF[] = "is no PDF"; static const char MSG_IS_NO_DICT[] = "object is no PDF dict"; static const char MSG_PIX_NOALPHA[] = "source pixmap has no alpha"; static const char MSG_PIXEL_OUTSIDE[] = "pixel(s) outside image"; %} ================================================ FILE: src_classic/helper-other.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ fz_buffer *JM_object_to_buffer(fz_context *ctx, pdf_obj *val, int a, int b); PyObject *JM_EscapeStrFromBuffer(fz_context *ctx, fz_buffer *buff); pdf_obj *JM_pdf_obj_from_str(fz_context *ctx, pdf_document *doc, char *src); // exception handling void *JM_ReturnException(fz_context *ctx) { PyErr_SetString(JM_Exc_CurrentException, fz_caught_message(ctx)); JM_Exc_CurrentException = PyExc_RuntimeError; return NULL; } static int LIST_APPEND_DROP(PyObject *list, PyObject *item) { if (!list || !PyList_Check(list) || !item) return -2; int rc = PyList_Append(list, item); Py_DECREF(item); return rc; } static int DICT_SETITEM_DROP(PyObject *dict, PyObject *key, PyObject *value) { if (!dict || !PyDict_Check(dict) || !key || !value) return -2; int rc = PyDict_SetItem(dict, key, value); Py_DECREF(value); return rc; } static int DICT_SETITEMSTR_DROP(PyObject *dict, const char *key, PyObject *value) { if (!dict || !PyDict_Check(dict) || !key || !value) return -2; int rc = PyDict_SetItemString(dict, key, value); Py_DECREF(value); return rc; } //-------------------------------------- // Ensure valid journalling state //-------------------------------------- int JM_have_operation(fz_context *ctx, pdf_document *pdf) { if (pdf->journal && !pdf_undoredo_step(ctx, pdf, 0)) { return 0; } return 1; } //---------------------------------- // Set a PDF dict key to some value //---------------------------------- static pdf_obj *JM_set_object_value(fz_context *ctx, pdf_obj *obj, const char *key, char *value) { fz_buffer *res = NULL; pdf_obj *new_obj = NULL, *testkey = NULL; PyObject *skey = PyUnicode_FromString(key); // Python version of dict key PyObject *slash = PyUnicode_FromString("/"); // PDF path separator PyObject *list = NULL, *newval=NULL, *newstr=NULL, *nullval=NULL; const char eyecatcher[] = "fitz: replace me!"; pdf_document *pdf = NULL; fz_try(ctx) { pdf = pdf_get_bound_document(ctx, obj); // split PDF key at path seps and take last key part list = PyUnicode_Split(skey, slash, -1); Py_ssize_t len = PySequence_Size(list); Py_ssize_t i = len - 1; Py_DECREF(skey); skey = PySequence_GetItem(list, i); PySequence_DelItem(list, i); // del the last sub-key len = PySequence_Size(list); // remaining length testkey = pdf_dict_getp(ctx, obj, key); // check if key already exists if (!testkey) { /*----------------------------------------------------------------- No, it will be created here. But we cannot allow this happening if indirect objects are referenced. So we check all higher level sub-paths for indirect references. -----------------------------------------------------------------*/ while (len > 0) { PyObject *t = PyUnicode_Join(slash, list); // next high level if (pdf_is_indirect(ctx, pdf_dict_getp(ctx, obj, JM_StrAsChar(t)))) { Py_DECREF(t); fz_throw(ctx, FZ_ERROR_GENERIC, "path to '%s' has indirects", JM_StrAsChar(skey)); } PySequence_DelItem(list, len - 1); // del last sub-key len = PySequence_Size(list); // remaining length Py_DECREF(t); } } // Insert our eyecatcher. Will create all sub-paths in the chain, or // respectively remove old value of key-path. pdf_dict_putp_drop(ctx, obj, key, pdf_new_text_string(ctx, eyecatcher)); testkey = pdf_dict_getp(ctx, obj, key); if (!pdf_is_string(ctx, testkey)) { fz_throw(ctx, FZ_ERROR_GENERIC, "cannot insert value for '%s'", key); } const char *temp = pdf_to_text_string(ctx, testkey); if (strcmp(temp, eyecatcher) != 0) { fz_throw(ctx, FZ_ERROR_GENERIC, "cannot insert value for '%s'", key); } // read the result as a string res = JM_object_to_buffer(ctx, obj, 1, 0); PyObject *objstr = JM_EscapeStrFromBuffer(ctx, res); // replace 'eyecatcher' by desired 'value' nullval = PyUnicode_FromFormat("/%s(%s)", JM_StrAsChar(skey), eyecatcher); newval = PyUnicode_FromFormat("/%s %s", JM_StrAsChar(skey), value); newstr = PyUnicode_Replace(objstr, nullval, newval, 1); // make PDF object from resulting string new_obj = JM_pdf_obj_from_str(ctx, pdf, JM_StrAsChar(newstr)); } fz_always(ctx) { fz_drop_buffer(ctx, res); Py_CLEAR(skey); Py_CLEAR(slash); Py_CLEAR(list); Py_CLEAR(newval); Py_CLEAR(newstr); Py_CLEAR(nullval); } fz_catch(ctx) { fz_rethrow(ctx); } return new_obj; } static void JM_get_page_labels(fz_context *ctx, PyObject *liste, pdf_obj *nums) { int pno, i, n = pdf_array_len(ctx, nums); char *c = NULL; pdf_obj *val; fz_buffer *res = NULL; for (i = 0; i < n; i += 2) { pdf_obj *key = pdf_resolve_indirect(ctx, pdf_array_get(ctx, nums, i)); pno = pdf_to_int(ctx, key); val = pdf_resolve_indirect(ctx, pdf_array_get(ctx, nums, i + 1)); res = JM_object_to_buffer(ctx, val, 1, 0); fz_buffer_storage(ctx, res, &c); LIST_APPEND_DROP(liste, Py_BuildValue("is", pno, c)); fz_drop_buffer(ctx, res); } } PyObject *JM_EscapeStrFromBuffer(fz_context *ctx, fz_buffer *buff) { if (!buff) return EMPTY_STRING; unsigned char *s = NULL; size_t len = fz_buffer_storage(ctx, buff, &s); PyObject *val = PyUnicode_DecodeRawUnicodeEscape((const char *) s, (Py_ssize_t) len, "replace"); if (!val) { val = EMPTY_STRING; PyErr_Clear(); } return val; } PyObject *JM_UnicodeFromBuffer(fz_context *ctx, fz_buffer *buff) { unsigned char *s = NULL; Py_ssize_t len = (Py_ssize_t) fz_buffer_storage(ctx, buff, &s); PyObject *val = PyUnicode_DecodeUTF8((const char *) s, len, "replace"); if (!val) { val = EMPTY_STRING; PyErr_Clear(); } return val; } PyObject *JM_UnicodeFromStr(const char *c) { if (!c) return EMPTY_STRING; PyObject *val = Py_BuildValue("s", c); if (!val) { val = EMPTY_STRING; PyErr_Clear(); } return val; } PyObject *JM_EscapeStrFromStr(const char *c) { if (!c) return EMPTY_STRING; PyObject *val = PyUnicode_DecodeRawUnicodeEscape(c, (Py_ssize_t) strlen(c), "replace"); if (!val) { val = EMPTY_STRING; PyErr_Clear(); } return val; } // list of valid unicodes of a fz_font void JM_valid_chars(fz_context *ctx, fz_font *font, void *arr) { FT_Face face = font->ft_face; FT_ULong ucs; FT_UInt gid; long *table = (long *)arr; fz_lock(ctx, FZ_LOCK_FREETYPE); ucs = FT_Get_First_Char(face, &gid); while (gid > 0) { if (gid < (FT_ULong)face->num_glyphs && face->num_glyphs > 0) table[gid] = (long)ucs; ucs = FT_Get_Next_Char(face, ucs, &gid); } fz_unlock(ctx, FZ_LOCK_FREETYPE); return; } // redirect MuPDF warnings void JM_mupdf_warning(void *user, const char *message) { LIST_APPEND_DROP(JM_mupdf_warnings_store, JM_EscapeStrFromStr(message)); if (JM_mupdf_show_warnings) { PySys_WriteStderr("mupdf: %s\n", message); } } // redirect MuPDF errors void JM_mupdf_error(void *user, const char *message) { LIST_APPEND_DROP(JM_mupdf_warnings_store, JM_EscapeStrFromStr(message)); if (JM_mupdf_show_errors) { PySys_WriteStderr("mupdf: %s\n", message); } } // a simple tracer void JM_TRACE(const char *id) { PySys_WriteStdout("%s\n", id); } // put a warning on Python-stdout void JM_Warning(const char *id) { PySys_WriteStdout("warning: %s\n", id); } #if JM_MEMORY == 1 //----------------------------------------------------------------------------- // The following 3 functions replace MuPDF standard memory allocation. // This will ensure, that MuPDF memory handling becomes part of Python's // memory management. //----------------------------------------------------------------------------- static void *JM_Py_Malloc(void *opaque, size_t size) { void *mem = PyMem_Malloc((Py_ssize_t) size); if (mem) return mem; fz_throw(gctx, FZ_ERROR_MEMORY, "malloc of %zu bytes failed", size); } static void *JM_Py_Realloc(void *opaque, void *old, size_t size) { void *mem = PyMem_Realloc(old, (Py_ssize_t) size); if (mem) return mem; fz_throw(gctx, FZ_ERROR_MEMORY, "realloc of %zu bytes failed", size); } static void JM_PY_Free(void *opaque, void *ptr) { PyMem_Free(ptr); } const fz_alloc_context JM_Alloc_Context = { NULL, JM_Py_Malloc, JM_Py_Realloc, JM_PY_Free }; #endif PyObject *JM_fitz_config() { #if defined(TOFU) #define have_TOFU JM_BOOL(0) #else #define have_TOFU JM_BOOL(1) #endif #if defined(TOFU_CJK) #define have_TOFU_CJK JM_BOOL(0) #else #define have_TOFU_CJK JM_BOOL(1) #endif #if defined(TOFU_CJK_EXT) #define have_TOFU_CJK_EXT JM_BOOL(0) #else #define have_TOFU_CJK_EXT JM_BOOL(1) #endif #if defined(TOFU_CJK_LANG) #define have_TOFU_CJK_LANG JM_BOOL(0) #else #define have_TOFU_CJK_LANG JM_BOOL(1) #endif #if defined(TOFU_EMOJI) #define have_TOFU_EMOJI JM_BOOL(0) #else #define have_TOFU_EMOJI JM_BOOL(1) #endif #if defined(TOFU_HISTORIC) #define have_TOFU_HISTORIC JM_BOOL(0) #else #define have_TOFU_HISTORIC JM_BOOL(1) #endif #if defined(TOFU_SYMBOL) #define have_TOFU_SYMBOL JM_BOOL(0) #else #define have_TOFU_SYMBOL JM_BOOL(1) #endif #if defined(TOFU_SIL) #define have_TOFU_SIL JM_BOOL(0) #else #define have_TOFU_SIL JM_BOOL(1) #endif #if defined(TOFU_BASE14) #define have_TOFU_BASE14 JM_BOOL(0) #else #define have_TOFU_BASE14 JM_BOOL(1) #endif PyObject *dict = PyDict_New(); DICT_SETITEMSTR_DROP(dict, "plotter-g", JM_BOOL(FZ_PLOTTERS_G)); DICT_SETITEMSTR_DROP(dict, "plotter-rgb", JM_BOOL(FZ_PLOTTERS_RGB)); DICT_SETITEMSTR_DROP(dict, "plotter-cmyk", JM_BOOL(FZ_PLOTTERS_CMYK)); DICT_SETITEMSTR_DROP(dict, "plotter-n", JM_BOOL(FZ_PLOTTERS_N)); DICT_SETITEMSTR_DROP(dict, "pdf", JM_BOOL(FZ_ENABLE_PDF)); DICT_SETITEMSTR_DROP(dict, "xps", JM_BOOL(FZ_ENABLE_XPS)); DICT_SETITEMSTR_DROP(dict, "svg", JM_BOOL(FZ_ENABLE_SVG)); DICT_SETITEMSTR_DROP(dict, "cbz", JM_BOOL(FZ_ENABLE_CBZ)); DICT_SETITEMSTR_DROP(dict, "img", JM_BOOL(FZ_ENABLE_IMG)); DICT_SETITEMSTR_DROP(dict, "html", JM_BOOL(FZ_ENABLE_HTML)); DICT_SETITEMSTR_DROP(dict, "epub", JM_BOOL(FZ_ENABLE_EPUB)); DICT_SETITEMSTR_DROP(dict, "jpx", JM_BOOL(FZ_ENABLE_JPX)); DICT_SETITEMSTR_DROP(dict, "js", JM_BOOL(FZ_ENABLE_JS)); DICT_SETITEMSTR_DROP(dict, "tofu", have_TOFU); DICT_SETITEMSTR_DROP(dict, "tofu-cjk", have_TOFU_CJK); DICT_SETITEMSTR_DROP(dict, "tofu-cjk-ext", have_TOFU_CJK_EXT); DICT_SETITEMSTR_DROP(dict, "tofu-cjk-lang", have_TOFU_CJK_LANG); DICT_SETITEMSTR_DROP(dict, "tofu-emoji", have_TOFU_EMOJI); DICT_SETITEMSTR_DROP(dict, "tofu-historic", have_TOFU_HISTORIC); DICT_SETITEMSTR_DROP(dict, "tofu-symbol", have_TOFU_SYMBOL); DICT_SETITEMSTR_DROP(dict, "tofu-sil", have_TOFU_SIL); DICT_SETITEMSTR_DROP(dict, "icc", JM_BOOL(FZ_ENABLE_ICC)); DICT_SETITEMSTR_DROP(dict, "base14", have_TOFU_BASE14); DICT_SETITEMSTR_DROP(dict, "py-memory", JM_BOOL(JM_MEMORY)); return dict; } //---------------------------------------------------------------------------- // Update a color float array with values from a Python sequence. // Any error condition is treated as a no-op. //---------------------------------------------------------------------------- void JM_color_FromSequence(PyObject *color, int *n, float col[4]) { if (!color || color == Py_None) { *n = -1; return; } if (PyFloat_Check(color)) { // maybe just a single float *n = 1; float c = (float) PyFloat_AsDouble(color); if (!INRANGE(c, 0, 1)) { c = 1; } col[0] = c; return; } if (!PySequence_Check(color)) { *n = -1; return; } int len = (int) PySequence_Size(color), rc; if (len == 0) { *n = 0; return; } if (!INRANGE(len, 1, 4) || len == 2) { *n = -1; return; } double mcol[4] = {0,0,0,0}; // local color storage Py_ssize_t i; for (i = 0; i < len; i++) { rc = JM_FLOAT_ITEM(color, i, &mcol[i]); if (!INRANGE(mcol[i], 0, 1) || rc == 1) mcol[i] = 1; } *n = len; for (i = 0; i < len; i++) col[i] = (float) mcol[i]; return; } // return extension for fitz image type const char *JM_image_extension(int type) { switch (type) { case(FZ_IMAGE_FAX): return "fax"; case(FZ_IMAGE_RAW): return "raw"; case(FZ_IMAGE_FLATE): return "flate"; case(FZ_IMAGE_LZW): return "lzw"; case(FZ_IMAGE_RLD): return "rld"; case(FZ_IMAGE_BMP): return "bmp"; case(FZ_IMAGE_GIF): return "gif"; case(FZ_IMAGE_JBIG2): return "jb2"; case(FZ_IMAGE_JPEG): return "jpeg"; case(FZ_IMAGE_JPX): return "jpx"; case(FZ_IMAGE_JXR): return "jxr"; case(FZ_IMAGE_PNG): return "png"; case(FZ_IMAGE_PNM): return "pnm"; case(FZ_IMAGE_TIFF): return "tiff"; // case(FZ_IMAGE_PSD): return "psd"; case(FZ_IMAGE_UNKNOWN): return "n/a"; default: return "n/a"; } } //---------------------------------------------------------------------------- // Turn fz_buffer into a Python bytes object //---------------------------------------------------------------------------- PyObject *JM_BinFromBuffer(fz_context *ctx, fz_buffer *buffer) { if (!buffer) { return PyBytes_FromString(""); } unsigned char *c = NULL; size_t len = fz_buffer_storage(ctx, buffer, &c); return PyBytes_FromStringAndSize((const char *) c, (Py_ssize_t) len); } //---------------------------------------------------------------------------- // Turn fz_buffer into a Python bytearray object //---------------------------------------------------------------------------- PyObject *JM_BArrayFromBuffer(fz_context *ctx, fz_buffer *buffer) { if (!buffer) { return PyByteArray_FromStringAndSize("", 0); } unsigned char *c = NULL; size_t len = fz_buffer_storage(ctx, buffer, &c); return PyByteArray_FromStringAndSize((const char *) c, (Py_ssize_t) len); } //---------------------------------------------------------------------------- // compress char* into a new buffer //---------------------------------------------------------------------------- fz_buffer *JM_compress_buffer(fz_context *ctx, fz_buffer *inbuffer) { fz_buffer *buf = NULL; fz_try(ctx) { size_t compressed_length = 0; unsigned char *data = fz_new_deflated_data_from_buffer(ctx, &compressed_length, inbuffer, FZ_DEFLATE_BEST); if (data == NULL || compressed_length == 0) return NULL; buf = fz_new_buffer_from_data(ctx, data, compressed_length); fz_resize_buffer(ctx, buf, compressed_length); } fz_catch(ctx) { fz_drop_buffer(ctx, buf); fz_rethrow(ctx); } return buf; } //---------------------------------------------------------------------------- // update a stream object // compress stream when beneficial //---------------------------------------------------------------------------- void JM_update_stream(fz_context *ctx, pdf_document *doc, pdf_obj *obj, fz_buffer *buffer, int compress) { fz_buffer *nres = NULL; size_t len = fz_buffer_storage(ctx, buffer, NULL); size_t nlen = len; if (compress == 1 && len > 30) { // ignore small stuff nres = JM_compress_buffer(ctx, buffer); nlen = fz_buffer_storage(ctx, nres, NULL); } if (nlen < len && nres && compress==1) { // was it worth the effort? pdf_dict_put(ctx, obj, PDF_NAME(Filter), PDF_NAME(FlateDecode)); pdf_update_stream(ctx, doc, obj, nres, 1); } else { pdf_update_stream(ctx, doc, obj, buffer, 0); } fz_drop_buffer(ctx, nres); } //----------------------------------------------------------------------------- // return hex characters for n characters in input 'in' //----------------------------------------------------------------------------- void hexlify(int n, unsigned char *in, unsigned char *out) { const unsigned char hdigit[17] = "0123456789abcedf"; int i, i1, i2; for (i = 0; i < n; i++) { i1 = in[i]>>4; i2 = in[i] - i1*16; out[2*i] = hdigit[i1]; out[2*i + 1] = hdigit[i2]; } out[2*n] = 0; } //---------------------------------------------------------------------------- // Make fz_buffer from a PyBytes, PyByteArray, or io.BytesIO object //---------------------------------------------------------------------------- fz_buffer *JM_BufferFromBytes(fz_context *ctx, PyObject *stream) { char *c = NULL; PyObject *mybytes = NULL; size_t len = 0; fz_buffer *res = NULL; fz_var(res); fz_try(ctx) { if (PyBytes_Check(stream)) { c = PyBytes_AS_STRING(stream); len = (size_t) PyBytes_GET_SIZE(stream); } else if (PyByteArray_Check(stream)) { c = PyByteArray_AS_STRING(stream); len = (size_t) PyByteArray_GET_SIZE(stream); } else if (PyObject_HasAttrString(stream, "getvalue")) { // we assume here that this delivers what we expect mybytes = PyObject_CallMethod(stream, "getvalue", NULL); c = PyBytes_AS_STRING(mybytes); len = (size_t) PyBytes_GET_SIZE(mybytes); } // if none of the above, c is NULL and we return an empty buffer if (c) { res = fz_new_buffer_from_copied_data(ctx, (const unsigned char *) c, len); } else { res = fz_new_buffer(ctx, 1); fz_append_byte(ctx, res, 10); } fz_terminate_buffer(ctx, res); } fz_always(ctx) { Py_CLEAR(mybytes); PyErr_Clear(); } fz_catch(ctx) { fz_drop_buffer(ctx, res); fz_rethrow(ctx); } return res; } //---------------------------------------------------------------------------- // Deep-copies a source page to the target. // Modified version of function of pdfmerge.c: we also copy annotations, but // we skip some subtypes. In addition we rotate output. //---------------------------------------------------------------------------- static void page_merge(fz_context *ctx, pdf_document *doc_des, pdf_document *doc_src, int page_from, int page_to, int rotate, int links, int copy_annots, pdf_graft_map *graft_map) { pdf_obj *page_ref = NULL; pdf_obj *page_dict = NULL; pdf_obj *obj = NULL, *ref = NULL; // list of object types (per page) we want to copy static pdf_obj * const known_page_objs[] = { PDF_NAME(Contents), PDF_NAME(Resources), PDF_NAME(MediaBox), PDF_NAME(CropBox), PDF_NAME(BleedBox), PDF_NAME(TrimBox), PDF_NAME(ArtBox), PDF_NAME(Rotate), PDF_NAME(UserUnit) }; int i, n; fz_var(ref); fz_var(page_dict); fz_try(ctx) { page_ref = pdf_lookup_page_obj(ctx, doc_src, page_from); // make new page dict in dest doc page_dict = pdf_new_dict(ctx, doc_des, 4); pdf_dict_put(ctx, page_dict, PDF_NAME(Type), PDF_NAME(Page)); for (i = 0; i < (int) nelem(known_page_objs); i++) { obj = pdf_dict_get_inheritable(ctx, page_ref, known_page_objs[i]); if (obj != NULL) { pdf_dict_put_drop(ctx, page_dict, known_page_objs[i], pdf_graft_mapped_object(ctx, graft_map, obj)); } } // Copy annotations, but skip Link, Popup, IRT, Widget types // If selected, remove dict keys P (parent) and Popup if (copy_annots) { pdf_obj *old_annots = pdf_dict_get(ctx, page_ref, PDF_NAME(Annots)); n = pdf_array_len(ctx, old_annots); if (n > 0) { pdf_obj *new_annots = pdf_dict_put_array(ctx, page_dict, PDF_NAME(Annots), n); for (i = 0; i < n; i++) { pdf_obj *o = pdf_array_get(ctx, old_annots, i); if (!pdf_is_dict(ctx, o)) continue; // skip non-dict items if (pdf_dict_get(ctx, o, PDF_NAME(IRT))) continue; pdf_obj *subtype = pdf_dict_get(ctx, o, PDF_NAME(Subtype)); if (pdf_name_eq(ctx, subtype, PDF_NAME(Link))) continue; if (pdf_name_eq(ctx, subtype, PDF_NAME(Popup))) continue; if (pdf_name_eq(ctx, subtype, PDF_NAME(Widget))) continue; pdf_dict_del(ctx, o, PDF_NAME(Popup)); pdf_dict_del(ctx, o, PDF_NAME(P)); pdf_obj *copy_o = pdf_graft_mapped_object(ctx, graft_map, o); pdf_obj *annot = pdf_new_indirect(ctx, doc_des, pdf_to_num(ctx, copy_o), 0); pdf_array_push_drop(ctx, new_annots, annot); pdf_drop_obj(ctx, copy_o); } } } // rotate the page if (rotate != -1) { pdf_dict_put_int(ctx, page_dict, PDF_NAME(Rotate), (int64_t) rotate); } // Now add the page dictionary to dest PDF ref = pdf_add_object(ctx, doc_des, page_dict); // Insert new page at specified location pdf_insert_page(ctx, doc_des, page_to, ref); } fz_always(ctx) { pdf_drop_obj(ctx, page_dict); pdf_drop_obj(ctx, ref); } fz_catch(ctx) { fz_rethrow(ctx); } } //----------------------------------------------------------------------------- // Copy a range of pages (spage, epage) from a source PDF to a specified // location (apage) of the target PDF. // If spage > epage, the sequence of source pages is reversed. //----------------------------------------------------------------------------- void JM_merge_range(fz_context *ctx, pdf_document *doc_des, pdf_document *doc_src, int spage, int epage, int apage, int rotate, int links, int annots, int show_progress, pdf_graft_map *graft_map) { int page, afterpage; afterpage = apage; int counter = 0; // copied pages counter int total = fz_absi(epage - spage) + 1; // total pages to copy fz_try(ctx) { if (spage < epage) { for (page = spage; page <= epage; page++, afterpage++) { page_merge(ctx, doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map); counter++; if (show_progress > 0 && counter % show_progress == 0) { PySys_WriteStdout("Inserted %i of %i pages.\n", counter, total); } } } else { for (page = spage; page >= epage; page--, afterpage++) { page_merge(ctx, doc_des, doc_src, page, afterpage, rotate, links, annots, graft_map); counter++; if (show_progress > 0 && counter % show_progress == 0) { PySys_WriteStdout("Inserted %i of %i pages.\n", counter, total); } } } } fz_catch(ctx) { fz_rethrow(ctx); } } //---------------------------------------------------------------------------- // Return list of outline xref numbers. Recursive function. Arguments: // 'obj' first OL item // 'xrefs' empty Python list //---------------------------------------------------------------------------- PyObject *JM_outline_xrefs(fz_context *ctx, pdf_obj *obj, PyObject *xrefs) { pdf_obj *first, *parent, *thisobj; if (!obj) return xrefs; PyObject *newxref = NULL; thisobj = obj; while (thisobj) { newxref = PyLong_FromLong((long) pdf_to_num(ctx, thisobj)); if (PySequence_Contains(xrefs, newxref) || pdf_dict_get(ctx, thisobj, PDF_NAME(Type))) { // circular ref or top of chain: terminate Py_DECREF(newxref); break; } LIST_APPEND_DROP(xrefs, newxref); first = pdf_dict_get(ctx, thisobj, PDF_NAME(First)); // try go down if (pdf_is_dict(ctx, first)) xrefs = JM_outline_xrefs(ctx, first, xrefs); thisobj = pdf_dict_get(ctx, thisobj, PDF_NAME(Next)); // try go next parent = pdf_dict_get(ctx, thisobj, PDF_NAME(Parent)); // get parent if (!pdf_is_dict(ctx, thisobj)) { thisobj = parent; } } return xrefs; } //------------------------------------------------------------------- // Return the contents of a font file, identified by xref //------------------------------------------------------------------- fz_buffer *JM_get_fontbuffer(fz_context *ctx, pdf_document *doc, int xref) { if (xref < 1) return NULL; pdf_obj *o, *obj = NULL, *desft, *stream = NULL; o = pdf_load_object(ctx, doc, xref); desft = pdf_dict_get(ctx, o, PDF_NAME(DescendantFonts)); if (desft) { obj = pdf_resolve_indirect(ctx, pdf_array_get(ctx, desft, 0)); obj = pdf_dict_get(ctx, obj, PDF_NAME(FontDescriptor)); } else { obj = pdf_dict_get(ctx, o, PDF_NAME(FontDescriptor)); } if (!obj) { pdf_drop_obj(ctx, o); PySys_WriteStdout("invalid font - FontDescriptor missing"); return NULL; } pdf_drop_obj(ctx, o); o = obj; obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile)); if (obj) stream = obj; // ext = "pfa" obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile2)); if (obj) stream = obj; // ext = "ttf" obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile3)); if (obj) { stream = obj; obj = pdf_dict_get(ctx, obj, PDF_NAME(Subtype)); if (obj && !pdf_is_name(ctx, obj)) { PySys_WriteStdout("invalid font descriptor subtype"); return NULL; } if (pdf_name_eq(ctx, obj, PDF_NAME(Type1C))) ; /*Prev code did: ext = "cff", but this has no effect. */ else if (pdf_name_eq(ctx, obj, PDF_NAME(CIDFontType0C))) ; /*Prev code did: ext = "cid", but this has no effect. */ else if (pdf_name_eq(ctx, obj, PDF_NAME(OpenType))) ; /*Prev code did: ext = "otf", but this has no effect. */ else PySys_WriteStdout("warning: unhandled font type '%s'", pdf_to_name(ctx, obj)); } if (!stream) { PySys_WriteStdout("warning: unhandled font type"); return NULL; } return pdf_load_stream(ctx, stream); } //----------------------------------------------------------------------------- // Return the file extension of a font file, identified by xref //----------------------------------------------------------------------------- char *JM_get_fontextension(fz_context *ctx, pdf_document *doc, int xref) { if (xref < 1) return "n/a"; pdf_obj *o, *obj = NULL, *desft; o = pdf_load_object(ctx, doc, xref); desft = pdf_dict_get(ctx, o, PDF_NAME(DescendantFonts)); if (desft) { obj = pdf_resolve_indirect(ctx, pdf_array_get(ctx, desft, 0)); obj = pdf_dict_get(ctx, obj, PDF_NAME(FontDescriptor)); } else { obj = pdf_dict_get(ctx, o, PDF_NAME(FontDescriptor)); } pdf_drop_obj(ctx, o); if (!obj) return "n/a"; // this is a base-14 font o = obj; // we have the FontDescriptor obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile)); if (obj) return "pfa"; obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile2)); if (obj) return "ttf"; obj = pdf_dict_get(ctx, o, PDF_NAME(FontFile3)); if (obj) { obj = pdf_dict_get(ctx, obj, PDF_NAME(Subtype)); if (obj && !pdf_is_name(ctx, obj)) { PySys_WriteStdout("invalid font descriptor subtype"); return "n/a"; } if (pdf_name_eq(ctx, obj, PDF_NAME(Type1C))) return "cff"; else if (pdf_name_eq(ctx, obj, PDF_NAME(CIDFontType0C))) return "cid"; else if (pdf_name_eq(ctx, obj, PDF_NAME(OpenType))) return "otf"; else PySys_WriteStdout("unhandled font type '%s'", pdf_to_name(ctx, obj)); } return "n/a"; } //----------------------------------------------------------------------------- // create PDF object from given string (new in v1.14.0: MuPDF dropped it) //----------------------------------------------------------------------------- pdf_obj *JM_pdf_obj_from_str(fz_context *ctx, pdf_document *doc, char *src) { pdf_obj *result = NULL; pdf_lexbuf lexbuf; fz_stream *stream = fz_open_memory(ctx, (unsigned char *)src, strlen(src)); pdf_lexbuf_init(ctx, &lexbuf, PDF_LEXBUF_SMALL); fz_try(ctx) { result = pdf_parse_stm_obj(ctx, doc, stream, &lexbuf); } fz_always(ctx) { pdf_lexbuf_fin(ctx, &lexbuf); fz_drop_stream(ctx, stream); } fz_catch(ctx) { fz_rethrow(ctx); } return result; } //---------------------------------------------------------------------------- // return normalized /Rotate value:one of 0, 90, 180, 270 //---------------------------------------------------------------------------- int JM_norm_rotation(int rotate) { while (rotate < 0) rotate += 360; while (rotate >= 360) rotate -= 360; if (rotate % 90 != 0) return 0; return rotate; } //---------------------------------------------------------------------------- // return a PDF page's /Rotate value: one of (0, 90, 180, 270) //---------------------------------------------------------------------------- int JM_page_rotation(fz_context *ctx, pdf_page *page) { int rotate = 0; fz_try(ctx) { rotate = pdf_to_int(ctx, pdf_dict_get_inheritable(ctx, page->obj, PDF_NAME(Rotate))); rotate = JM_norm_rotation(rotate); } fz_catch(ctx) return 0; return rotate; } //---------------------------------------------------------------------------- // return a PDF page's MediaBox //---------------------------------------------------------------------------- fz_rect JM_mediabox(fz_context *ctx, pdf_obj *page_obj) { fz_rect mediabox, page_mediabox; mediabox = pdf_to_rect(ctx, pdf_dict_get_inheritable(ctx, page_obj, PDF_NAME(MediaBox))); if (fz_is_empty_rect(mediabox) || fz_is_infinite_rect(mediabox)) { mediabox.x0 = 0; mediabox.y0 = 0; mediabox.x1 = 612; mediabox.y1 = 792; } page_mediabox.x0 = fz_min(mediabox.x0, mediabox.x1); page_mediabox.y0 = fz_min(mediabox.y0, mediabox.y1); page_mediabox.x1 = fz_max(mediabox.x0, mediabox.x1); page_mediabox.y1 = fz_max(mediabox.y0, mediabox.y1); if (page_mediabox.x1 - page_mediabox.x0 < 1 || page_mediabox.y1 - page_mediabox.y0 < 1) page_mediabox = fz_unit_rect; return page_mediabox; } //---------------------------------------------------------------------------- // return a PDF page's CropBox //---------------------------------------------------------------------------- fz_rect JM_cropbox(fz_context *ctx, pdf_obj *page_obj) { fz_rect mediabox = JM_mediabox(ctx, page_obj); fz_rect cropbox = pdf_to_rect(ctx, pdf_dict_get_inheritable(ctx, page_obj, PDF_NAME(CropBox))); if (fz_is_infinite_rect(cropbox) || fz_is_empty_rect(cropbox)) cropbox = mediabox; float y0 = mediabox.y1 - cropbox.y1; float y1 = mediabox.y1 - cropbox.y0; cropbox.y0 = y0; cropbox.y1 = y1; return cropbox; } //---------------------------------------------------------------------------- // calculate width and height of the UNROTATED page //---------------------------------------------------------------------------- fz_point JM_cropbox_size(fz_context *ctx, pdf_obj *page_obj) { fz_point size; fz_try(ctx) { fz_rect rect = JM_cropbox(ctx, page_obj); float w = (rect.x0 < rect.x1 ? rect.x1 - rect.x0 : rect.x0 - rect.x1); float h = (rect.y0 < rect.y1 ? rect.y1 - rect.y0 : rect.y0 - rect.y1); size = fz_make_point(w, h); } fz_catch(ctx) fz_rethrow(ctx); return size; } //---------------------------------------------------------------------------- // calculate page rotation matrices //---------------------------------------------------------------------------- fz_matrix JM_rotate_page_matrix(fz_context *ctx, pdf_page *page) { if (!page) return fz_identity; // no valid pdf page given int rotation = JM_page_rotation(ctx, page); if (rotation == 0) return fz_identity; // no rotation fz_matrix m; fz_point cb_size = JM_cropbox_size(ctx, page->obj); float w = cb_size.x; float h = cb_size.y; if (rotation == 90) m = fz_make_matrix(0, 1, -1, 0, h, 0); else if (rotation == 180) m = fz_make_matrix(-1, 0, 0, -1, w, h); else m = fz_make_matrix(0, -1, 1, 0, 0, w); return m; } fz_matrix JM_derotate_page_matrix(fz_context *ctx, pdf_page *page) { // just the inverse of rotation return fz_invert_matrix(JM_rotate_page_matrix(ctx, page)); } //----------------------------------------------------------------------------- // Insert a font in a PDF //----------------------------------------------------------------------------- PyObject * JM_insert_font(fz_context *ctx, pdf_document *pdf, char *bfname, char *fontfile, PyObject *fontbuffer, int set_simple, int idx, int wmode, int serif, int encoding, int ordering) { pdf_obj *font_obj = NULL; fz_font *font = NULL; fz_buffer *res = NULL; const unsigned char *data = NULL; int size, ixref = 0, index = 0, simple = 0; PyObject *value=NULL, *name=NULL, *subt=NULL, *exto = NULL; fz_var(exto); fz_var(name); fz_var(subt); fz_var(res); fz_var(font); fz_var(font_obj); fz_try(ctx) { ENSURE_OPERATION(ctx, pdf); //------------------------------------------------------------- // check for CJK font //------------------------------------------------------------- if (ordering > -1) { data = fz_lookup_cjk_font(ctx, ordering, &size, &index); } if (data) { font = fz_new_font_from_memory(ctx, NULL, data, size, index, 0); font_obj = pdf_add_cjk_font(ctx, pdf, font, ordering, wmode, serif); exto = JM_UnicodeFromStr("n/a"); simple = 0; goto weiter; } //------------------------------------------------------------- // check for PDF Base-14 font //------------------------------------------------------------- if (bfname) { data = fz_lookup_base14_font(ctx, bfname, &size); } if (data) { font = fz_new_font_from_memory(ctx, bfname, data, size, 0, 0); font_obj = pdf_add_simple_font(ctx, pdf, font, encoding); exto = JM_UnicodeFromStr("n/a"); simple = 1; goto weiter; } if (fontfile) { font = fz_new_font_from_file(ctx, NULL, fontfile, idx, 0); } else { res = JM_BufferFromBytes(ctx, fontbuffer); if (!res) { RAISEPY(ctx, MSG_FILE_OR_BUFFER, PyExc_ValueError); } font = fz_new_font_from_buffer(ctx, NULL, res, idx, 0); } if (!set_simple) { font_obj = pdf_add_cid_font(ctx, pdf, font); simple = 0; } else { font_obj = pdf_add_simple_font(ctx, pdf, font, encoding); simple = 2; } weiter: ; ixref = pdf_to_num(ctx, font_obj); name = JM_EscapeStrFromStr(pdf_to_name(ctx, pdf_dict_get(ctx, font_obj, PDF_NAME(BaseFont)))); subt = JM_UnicodeFromStr(pdf_to_name(ctx, pdf_dict_get(ctx, font_obj, PDF_NAME(Subtype)))); if (!exto) exto = JM_UnicodeFromStr(JM_get_fontextension(ctx, pdf, ixref)); float asc = fz_font_ascender(ctx, font); float dsc = fz_font_descender(ctx, font); value = Py_BuildValue("[i,{s:O,s:O,s:O,s:O,s:i,s:f,s:f}]", ixref, "name", name, // base font name "type", subt, // subtype "ext", exto, // file extension "simple", JM_BOOL(simple), // simple font? "ordering", ordering, // CJK font? "ascender", asc, "descender", dsc ); } fz_always(ctx) { Py_CLEAR(exto); Py_CLEAR(name); Py_CLEAR(subt); fz_drop_buffer(ctx, res); fz_drop_font(ctx, font); pdf_drop_obj(ctx, font_obj); } fz_catch(ctx) { fz_rethrow(ctx); } return value; } //----------------------------------------------------------------------------- // compute image insertion matrix //----------------------------------------------------------------------------- fz_matrix calc_image_matrix(int width, int height, PyObject *tr, int rotate, int keep) { float large, small, fw, fh, trw, trh, f, w, h; fz_rect trect = JM_rect_from_py(tr); fz_matrix rot = fz_rotate((float) rotate); trw = trect.x1 - trect.x0; trh = trect.y1 - trect.y0; w = trw; h = trh; if (keep) { large = (float) Py_MAX(width, height); fw = (float) width / large; fh = (float) height / large; } else { fw = fh = 1; } small = Py_MIN(fw, fh); if (rotate != 0 && rotate != 180) { f = fw; fw = fh; fh = f; } if (fw < 1) { if ((trw / fw) > (trh / fh)) { w = trh * small; h = trh; } else { w = trw; h = trw / small; } } else if (fw != fh) { if ((trw / fw) > (trh / fh)) { w = trh / small; h = trh; } else { w = trw; h = trw * small; } } else { w = trw; h = trh; } fz_point tmp = fz_make_point((trect.x0 + trect.x1) / 2, (trect.y0 + trect.y1) / 2); fz_matrix mat = fz_make_matrix(1, 0, 0, 1, -0.5, -0.5); mat = fz_concat(mat, rot); mat = fz_concat(mat, fz_scale(w, h)); mat = fz_concat(mat, fz_translate(tmp.x, tmp.y)); return mat; } // -------------------------------------------------------- // Callback function for the Story class // -------------------------------------------------------- static PyObject *make_story_elpos = NULL; // Py function returning object void Story_Callback(fz_context *ctx, void *opaque, fz_story_element_position *pos) { #define SETATTR(a, v) PyObject_SetAttrString(arg, a, v);Py_DECREF(v) // ------------------------------------------------------------------------ // 'opaque' is a tuple (userfunc, userdict), where 'userfunc' is a function // in the user's script and 'userdict' is a dictionary containing any // additional parameters of the user // userfunc will be called with the joined info of userdict and pos. // ------------------------------------------------------------------------ PyObject *callarg = (PyObject *) opaque; PyObject *userfunc = PyTuple_GET_ITEM(callarg, 0); PyObject *userdict = PyTuple_GET_ITEM(callarg, 1); PyObject *this_module = PyImport_AddModule("fitz"); // get our module if (!make_story_elpos) { // locate ElementPosition maker once make_story_elpos = Py_BuildValue("s", "make_story_elpos"); } // get access to ElementPosition() object PyObject *arg = PyObject_CallMethodObjArgs(this_module, make_story_elpos, NULL); Py_INCREF(arg); SETATTR("depth", Py_BuildValue("i", pos->depth)); SETATTR("heading", Py_BuildValue("i", pos->heading)); SETATTR("id", Py_BuildValue("s", pos->id)); SETATTR("rect", JM_py_from_rect(pos->rect)); SETATTR("text", Py_BuildValue("s", pos->text)); SETATTR("open_close", Py_BuildValue("i", pos->open_close)); SETATTR("rect_num", Py_BuildValue("i", pos->rectangle_num)); SETATTR("href", Py_BuildValue("s", pos->href)); // iterate over userdict items and set their attributes PyObject *pkey = NULL; PyObject *pval = NULL; Py_ssize_t ppos = 0; while (PyDict_Next(userdict, &ppos, &pkey, &pval)) { PyObject_SetAttr(arg, pkey, pval); } PyObject_CallFunctionObjArgs(userfunc, arg, NULL); #undef SETATTR } // ----------------------------------------------------------- // Return last archive if it is a tree and mount points match // ----------------------------------------------------------- fz_archive *JM_last_tree(fz_context *ctx, fz_archive *arch, const char *mount) { typedef struct { fz_archive *arch; char *dir; } multi_archive_entry; typedef struct { fz_archive super; int len; int max; multi_archive_entry *sub; } fz_multi_archive; if (!arch) { return NULL; } fz_multi_archive *multi = (fz_multi_archive *) arch; if (multi->len == 0) { // archive is empty return NULL; } int i = multi->len - 1; // read last sub archive multi_archive_entry *e = &multi->sub[i]; fz_archive *arch_ = e->arch; const char *mount_ = e->dir; const char *fmt = fz_archive_format(ctx, arch_); if (strcmp(fmt, "tree") != 0) { // not a tree archive return NULL; } if ((mount_ && mount && strcmp(mount, mount_) == 0) || (!mount && !mount_)) { // last sub archive is eligible! return arch_; } return NULL; } fz_archive *JM_archive_from_py(fz_context *ctx, fz_archive *arch, PyObject *path, const char *mount, int *drop_sub) { fz_stream *stream = NULL; fz_buffer *buff = NULL; *drop_sub = 1; fz_archive *sub = NULL; const char *my_mount = mount; fz_try(ctx) { // tree archive: tuple of memory items // check if we can add to last sub-archive sub = JM_last_tree(ctx, arch, my_mount); if (!sub) { sub = fz_new_tree_archive(ctx, NULL); } else { *drop_sub = 0; // never drop last sub-archive } // a single tree item if (PyBytes_Check(path) || PyByteArray_Check(path) || PyObject_HasAttrString(path, "getvalue")) { buff = JM_BufferFromBytes(ctx, path); fz_tree_archive_add_buffer(ctx, sub, mount, buff); goto finished; } // a tuple of tree items Py_ssize_t i, n = PyTuple_Size(path); for (i = 0; i < n; i++) { PyObject *item = PyTuple_GET_ITEM(path, i); PyObject *i0 = PySequence_GetItem(item, 0); // data PyObject *i1 = PySequence_GetItem(item, 1); // name buff = JM_BufferFromBytes(ctx, i0); fz_tree_archive_add_buffer(ctx, sub, PyUnicode_AsUTF8(i1), buff); fz_drop_buffer(ctx, buff); Py_DECREF(i0); Py_DECREF(i1); } buff = NULL; goto finished; finished:; } fz_always(ctx) { fz_drop_buffer(ctx, buff); fz_drop_stream(ctx, stream); } fz_catch(ctx) { fz_rethrow(ctx); } return sub; } int JM_rects_overlap(const fz_rect a, const fz_rect b) { if (0 || a.x0 >= b.x1 || a.y0 >= b.y1 || a.x1 <= b.x0 || a.y1 <= b.y0 ) return 0; return 1; } //----------------------------------------------------------------------------- // dummy structure for various tools and utilities //----------------------------------------------------------------------------- struct Tools {int index;}; typedef struct fz_item fz_item; struct fz_item { void *key; fz_storable *val; size_t size; fz_item *next; fz_item *prev; fz_store *store; const fz_store_type *type; }; struct fz_store { int refs; /* Every item in the store is kept in a doubly linked list, ordered * by usage (so LRU entries are at the end). */ fz_item *head; fz_item *tail; /* We have a hash table that allows to quickly find a subset of the * entries (those whose keys are indirect objects). */ fz_hash_table *hash; /* We keep track of the size of the store, and keep it below max. */ size_t max; size_t size; int defer_reap_count; int needs_reaping; }; %} ================================================ FILE: src_classic/helper-pdfinfo.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //------------------------------------------------------------------------ // Store ID in PDF trailer //------------------------------------------------------------------------ void JM_ensure_identity(fz_context *ctx, pdf_document *pdf) { unsigned char rnd[16]; pdf_obj *id; id = pdf_dict_get(ctx, pdf_trailer(ctx, pdf), PDF_NAME(ID)); if (!id) { fz_memrnd(ctx, rnd, nelem(rnd)); id = pdf_dict_put_array(ctx, pdf_trailer(ctx, pdf), PDF_NAME(ID), 2); pdf_array_push_drop(ctx, id, pdf_new_string(ctx, (char *) rnd + 0, nelem(rnd))); pdf_array_push_drop(ctx, id, pdf_new_string(ctx, (char *) rnd + 0, nelem(rnd))); } } //------------------------------------------------------------------------ // Ensure OCProperties, return /OCProperties key //------------------------------------------------------------------------ pdf_obj * JM_ensure_ocproperties(fz_context *ctx, pdf_document *pdf) { pdf_obj *D, *ocp; fz_try(ctx) { ocp = pdf_dict_get(ctx, pdf_dict_get(ctx, pdf_trailer(ctx, pdf), PDF_NAME(Root)), PDF_NAME(OCProperties)); if (ocp) goto finished; pdf_obj *root = pdf_dict_get(ctx, pdf_trailer(ctx, pdf), PDF_NAME(Root)); ocp = pdf_dict_put_dict(ctx, root, PDF_NAME(OCProperties), 2); pdf_dict_put_array(ctx, ocp, PDF_NAME(OCGs), 0); D = pdf_dict_put_dict(ctx, ocp, PDF_NAME(D), 5); pdf_dict_put_array(ctx, D, PDF_NAME(ON), 0); pdf_dict_put_array(ctx, D, PDF_NAME(OFF), 0); pdf_dict_put_array(ctx, D, PDF_NAME(Order), 0); pdf_dict_put_array(ctx, D, PDF_NAME(RBGroups), 0); finished:; } fz_catch(ctx) { fz_rethrow(ctx); } return ocp; } //------------------------------------------------------------------------ // Add OC configuration to the PDF catalog //------------------------------------------------------------------------ void JM_add_layer_config(fz_context *ctx, pdf_document *pdf, char *name, char *creator, PyObject *ON) { pdf_obj *D, *ocp, *configs; fz_try(ctx) { ocp = JM_ensure_ocproperties(ctx, pdf); configs = pdf_dict_get(ctx, ocp, PDF_NAME(Configs)); if (!pdf_is_array(ctx, configs)) { configs = pdf_dict_put_array(ctx,ocp, PDF_NAME(Configs), 1); } D = pdf_new_dict(ctx, pdf, 5); pdf_dict_put_text_string(ctx, D, PDF_NAME(Name), name); if (creator) { pdf_dict_put_text_string(ctx, D, PDF_NAME(Creator), creator); } pdf_dict_put(ctx, D, PDF_NAME(BaseState), PDF_NAME(OFF)); pdf_obj *onarray = pdf_dict_put_array(ctx, D, PDF_NAME(ON), 5); if (!EXISTS(ON) || !PySequence_Check(ON) || !PySequence_Size(ON)) { ; } else { pdf_obj *ocgs = pdf_dict_get(ctx, ocp, PDF_NAME(OCGs)); int i, n = PySequence_Size(ON); for (i = 0; i < n; i++) { int xref = 0; if (JM_INT_ITEM(ON, (Py_ssize_t) i, &xref) == 1) continue; pdf_obj *ind = pdf_new_indirect(ctx, pdf, xref, 0); if (pdf_array_contains(ctx, ocgs, ind)) { pdf_array_push_drop(ctx, onarray, ind); } else { pdf_drop_obj(ctx, ind); } } } pdf_array_push_drop(ctx, configs, D); } fz_catch(ctx) { fz_rethrow(ctx); } } //------------------------------------------------------------------------ // Get OCG arrays from OC configuration // Returns dict // {"basestate":name, "on":list, "off":list, "rbg":list, "locked":list} //------------------------------------------------------------------------ static PyObject * JM_get_ocg_arrays_imp(fz_context *ctx, pdf_obj *arr) { int i, n; PyObject *list = PyList_New(0), *item = NULL; pdf_obj *obj = NULL; if (pdf_is_array(ctx, arr)) { n = pdf_array_len(ctx, arr); for (i = 0; i < n; i++) { obj = pdf_array_get(ctx, arr, i); item = Py_BuildValue("i", pdf_to_num(ctx, obj)); if (!PySequence_Contains(list, item)) { LIST_APPEND_DROP(list, item); } else { Py_DECREF(item); } } } return list; } PyObject * JM_get_ocg_arrays(fz_context *ctx, pdf_obj *conf) { PyObject *rc = PyDict_New(), *list = NULL, *list1 = NULL; int i, n; pdf_obj *arr = NULL, *obj = NULL; fz_try(ctx) { arr = pdf_dict_get(ctx, conf, PDF_NAME(ON)); list = JM_get_ocg_arrays_imp(ctx, arr); if (PySequence_Size(list)) { PyDict_SetItemString(rc, "on", list); } Py_DECREF(list); arr = pdf_dict_get(ctx, conf, PDF_NAME(OFF)); list = JM_get_ocg_arrays_imp(ctx, arr); if (PySequence_Size(list)) { PyDict_SetItemString(rc, "off", list); } Py_DECREF(list); arr = pdf_dict_get(ctx, conf, PDF_NAME(Locked)); list = JM_get_ocg_arrays_imp(ctx, arr); if (PySequence_Size(list)) { PyDict_SetItemString(rc, "locked", list); } Py_DECREF(list); list = PyList_New(0); arr = pdf_dict_get(ctx, conf, PDF_NAME(RBGroups)); if (pdf_is_array(ctx, arr)) { n = pdf_array_len(ctx, arr); for (i = 0; i < n; i++) { obj = pdf_array_get(ctx, arr, i); list1 = JM_get_ocg_arrays_imp(ctx, obj); LIST_APPEND_DROP(list, list1); } } if (PySequence_Size(list)) { PyDict_SetItemString(rc, "rbgroups", list); } Py_DECREF(list); obj = pdf_dict_get(ctx, conf, PDF_NAME(BaseState)); if (obj) { PyObject *state = NULL; state = Py_BuildValue("s", pdf_to_name(ctx, obj)); PyDict_SetItemString(rc, "basestate", state); Py_DECREF(state); } } fz_always(ctx) { } fz_catch(ctx) { Py_CLEAR(rc); PyErr_Clear(); fz_rethrow(ctx); } return rc; } //------------------------------------------------------------------------ // Set OCG arrays from dict of Python lists // Works with dict like {"basestate":name, "on":list, "off":list, "rbg":list} //------------------------------------------------------------------------ static void JM_set_ocg_arrays_imp(fz_context *ctx, pdf_obj *arr, PyObject *list) { int i, n = PySequence_Size(list); pdf_obj *obj = NULL; pdf_document *pdf = pdf_get_bound_document(ctx, arr); for (i = 0; i < n; i++) { int xref = 0; if (JM_INT_ITEM(list, i, &xref) == 1) continue; obj = pdf_new_indirect(ctx, pdf, xref, 0); pdf_array_push_drop(ctx, arr, obj); } return; } static void JM_set_ocg_arrays(fz_context *ctx, pdf_obj *conf, const char *basestate, PyObject *on, PyObject *off, PyObject *rbgroups, PyObject *locked) { int i, n; pdf_obj *arr = NULL, *obj = NULL; fz_try(ctx) { if (basestate) { pdf_dict_put_name(ctx, conf, PDF_NAME(BaseState), basestate); } if (on != Py_None) { pdf_dict_del(ctx, conf, PDF_NAME(ON)); if (PySequence_Size(on)) { arr = pdf_dict_put_array(ctx, conf, PDF_NAME(ON), 1); JM_set_ocg_arrays_imp(ctx, arr, on); } } if (off != Py_None) { pdf_dict_del(ctx, conf, PDF_NAME(OFF)); if (PySequence_Size(off)) { arr = pdf_dict_put_array(ctx, conf, PDF_NAME(OFF), 1); JM_set_ocg_arrays_imp(ctx, arr, off); } } if (locked != Py_None) { pdf_dict_del(ctx, conf, PDF_NAME(Locked)); if (PySequence_Size(locked)) { arr = pdf_dict_put_array(ctx, conf, PDF_NAME(Locked), 1); JM_set_ocg_arrays_imp(ctx, arr, locked); } } if (rbgroups != Py_None) { pdf_dict_del(ctx, conf, PDF_NAME(RBGroups)); if (PySequence_Size(rbgroups)) { arr = pdf_dict_put_array(ctx, conf, PDF_NAME(RBGroups), 1); n = PySequence_Size(rbgroups); for (i = 0; i < n; i++) { PyObject *item0 = PySequence_ITEM(rbgroups, i); obj = pdf_array_push_array(ctx, arr, 1); JM_set_ocg_arrays_imp(ctx, obj, item0); Py_DECREF(item0); } } } } fz_catch(ctx) { fz_rethrow(ctx); } return; } //------------------------------------------------------------------------ // Return the items of Resources/Properties (used for Marked Content) // Argument may be e.g. a page object or a Form XObject //------------------------------------------------------------------------ PyObject * JM_get_resource_properties(fz_context *ctx, pdf_obj *ref) { PyObject *rc = NULL; fz_try(ctx) { pdf_obj *properties = pdf_dict_getl(ctx, ref, PDF_NAME(Resources), PDF_NAME(Properties), NULL); if (!properties) { rc = PyTuple_New(0); } else { int i, n = pdf_dict_len(ctx, properties); if (n < 1) { rc = PyTuple_New(0); goto finished; } rc = PyTuple_New(n); for (i = 0; i < n; i++) { pdf_obj *key = pdf_dict_get_key(ctx, properties, i); pdf_obj *val = pdf_dict_get_val(ctx, properties, i); const char *c = pdf_to_name(ctx, key); int xref = pdf_to_num(ctx, val); PyTuple_SET_ITEM(rc, i, Py_BuildValue("si", c, xref)); } } finished:; } fz_catch(ctx) { Py_CLEAR(rc); fz_rethrow(ctx); } return rc; } //------------------------------------------------------------------------ // Insert an item into Resources/Properties (used for Marked Content) // Arguments: // (1) e.g. page object, Form XObject // (2) marked content name // (3) xref of the referenced object (insert as indirect reference) //------------------------------------------------------------------------ void JM_set_resource_property(fz_context *ctx, pdf_obj *ref, const char *name, int xref) { pdf_obj *ind = NULL; pdf_obj *properties = NULL; pdf_document *pdf = pdf_get_bound_document(ctx, ref); pdf_obj *name2 = NULL; fz_var(ind); fz_var(name2); fz_try(ctx) { ind = pdf_new_indirect(ctx, pdf, xref, 0); if (!ind) { RAISEPY(ctx, MSG_BAD_XREF, PyExc_ValueError); } pdf_obj *resources = pdf_dict_get(ctx, ref, PDF_NAME(Resources)); if (!resources) { resources = pdf_dict_put_dict(ctx, ref, PDF_NAME(Resources), 1); } properties = pdf_dict_get(ctx, resources, PDF_NAME(Properties)); if (!properties) { properties = pdf_dict_put_dict(ctx, resources, PDF_NAME(Properties), 1); } name2 = pdf_new_name(ctx, name); pdf_dict_put(ctx, properties, name2, ind); } fz_always(ctx) { pdf_drop_obj(ctx, ind); pdf_drop_obj(ctx, name2); } fz_catch(ctx) { fz_rethrow(ctx); } return; } //------------------------------------------------------------------------ // Add OC object reference to a dictionary //------------------------------------------------------------------------ void JM_add_oc_object(fz_context *ctx, pdf_document *pdf, pdf_obj *ref, int xref) { pdf_obj *indobj = NULL; fz_try(ctx) { indobj = pdf_new_indirect(ctx, pdf, xref, 0); if (!pdf_is_dict(ctx, indobj)) { RAISEPY(ctx, MSG_BAD_OC_REF, PyExc_ValueError); } pdf_obj *type = pdf_dict_get(ctx, indobj, PDF_NAME(Type)); if (pdf_objcmp(ctx, type, PDF_NAME(OCG)) == 0 || pdf_objcmp(ctx, type, PDF_NAME(OCMD)) == 0) { pdf_dict_put(ctx, ref, PDF_NAME(OC), indobj); } else { RAISEPY(ctx, MSG_BAD_OC_REF, PyExc_ValueError); } } fz_always(ctx) { pdf_drop_obj(ctx, indobj); } fz_catch(ctx) { fz_rethrow(ctx); } } //------------------------------------------------------------------------- // Store info of a font in Python list //------------------------------------------------------------------------- int JM_gather_fonts(fz_context *ctx, pdf_document *pdf, pdf_obj *dict, PyObject *fontlist, int stream_xref) { int i, n, rc = 1; n = pdf_dict_len(ctx, dict); for (i = 0; i < n; i++) { pdf_obj *fontdict = NULL; pdf_obj *subtype = NULL; pdf_obj *basefont = NULL; pdf_obj *name = NULL; pdf_obj *refname = NULL; pdf_obj *encoding = NULL; refname = pdf_dict_get_key(ctx, dict, i); fontdict = pdf_dict_get_val(ctx, dict, i); if (!pdf_is_dict(ctx, fontdict)) { fz_warn(ctx, "'%s' is no font dict (%d 0 R)", pdf_to_name(ctx, refname), pdf_to_num(ctx, fontdict)); continue; } subtype = pdf_dict_get(ctx, fontdict, PDF_NAME(Subtype)); basefont = pdf_dict_get(ctx, fontdict, PDF_NAME(BaseFont)); if (!basefont || pdf_is_null(ctx, basefont)) { name = pdf_dict_get(ctx, fontdict, PDF_NAME(Name)); } else { name = basefont; } encoding = pdf_dict_get(ctx, fontdict, PDF_NAME(Encoding)); if (pdf_is_dict(ctx, encoding)) { encoding = pdf_dict_get(ctx, encoding, PDF_NAME(BaseEncoding)); } int xref = pdf_to_num(ctx, fontdict); char *ext = "n/a"; if (xref) { ext = JM_get_fontextension(ctx, pdf, xref); } PyObject *entry = PyTuple_New(7); PyTuple_SET_ITEM(entry, 0, Py_BuildValue("i", xref)); PyTuple_SET_ITEM(entry, 1, Py_BuildValue("s", ext)); PyTuple_SET_ITEM(entry, 2, Py_BuildValue("s", pdf_to_name(ctx, subtype))); PyTuple_SET_ITEM(entry, 3, JM_EscapeStrFromStr(pdf_to_name(ctx, name))); PyTuple_SET_ITEM(entry, 4, Py_BuildValue("s", pdf_to_name(ctx, refname))); PyTuple_SET_ITEM(entry, 5, Py_BuildValue("s", pdf_to_name(ctx, encoding))); PyTuple_SET_ITEM(entry, 6, Py_BuildValue("i", stream_xref)); LIST_APPEND_DROP(fontlist, entry); } return rc; } //------------------------------------------------------------------------- // Store info of an image in Python list //------------------------------------------------------------------------- int JM_gather_images(fz_context *ctx, pdf_document *doc, pdf_obj *dict, PyObject *imagelist, int stream_xref) { int i, n, rc = 1; n = pdf_dict_len(ctx, dict); for (i = 0; i < n; i++) { pdf_obj *imagedict, *smask; pdf_obj *refname = NULL; pdf_obj *type; pdf_obj *width; pdf_obj *height; pdf_obj *bpc = NULL; pdf_obj *filter = NULL; pdf_obj *cs = NULL; pdf_obj *altcs; refname = pdf_dict_get_key(ctx, dict, i); imagedict = pdf_dict_get_val(ctx, dict, i); if (!pdf_is_dict(ctx, imagedict)) { fz_warn(ctx, "'%s' is no image dict (%d 0 R)", pdf_to_name(ctx, refname), pdf_to_num(ctx, imagedict)); continue; } type = pdf_dict_get(ctx, imagedict, PDF_NAME(Subtype)); if (!pdf_name_eq(ctx, type, PDF_NAME(Image))) continue; int xref = pdf_to_num(ctx, imagedict); int gen = 0; smask = pdf_dict_geta(ctx, imagedict, PDF_NAME(SMask), PDF_NAME(Mask)); if (smask) gen = pdf_to_num(ctx, smask); filter = pdf_dict_geta(ctx, imagedict, PDF_NAME(Filter), PDF_NAME(F)); if (pdf_is_array(ctx, filter)) { filter = pdf_array_get(ctx, filter, 0); } altcs = NULL; cs = pdf_dict_geta(ctx, imagedict, PDF_NAME(ColorSpace), PDF_NAME(CS)); if (pdf_is_array(ctx, cs)) { pdf_obj *cses = cs; cs = pdf_array_get(ctx, cses, 0); if (pdf_name_eq(ctx, cs, PDF_NAME(DeviceN)) || pdf_name_eq(ctx, cs, PDF_NAME(Separation))) { altcs = pdf_array_get(ctx, cses, 2); if (pdf_is_array(ctx, altcs)) { altcs = pdf_array_get(ctx, altcs, 0); } } } width = pdf_dict_geta(ctx, imagedict, PDF_NAME(Width), PDF_NAME(W)); height = pdf_dict_geta(ctx, imagedict, PDF_NAME(Height), PDF_NAME(H)); bpc = pdf_dict_geta(ctx, imagedict, PDF_NAME(BitsPerComponent), PDF_NAME(BPC)); PyObject *entry = PyTuple_New(10); PyTuple_SET_ITEM(entry, 0, Py_BuildValue("i", xref)); PyTuple_SET_ITEM(entry, 1, Py_BuildValue("i", gen)); PyTuple_SET_ITEM(entry, 2, Py_BuildValue("i", pdf_to_int(ctx, width))); PyTuple_SET_ITEM(entry, 3, Py_BuildValue("i", pdf_to_int(ctx, height))); PyTuple_SET_ITEM(entry, 4, Py_BuildValue("i", pdf_to_int(ctx, bpc))); PyTuple_SET_ITEM(entry, 5, JM_EscapeStrFromStr(pdf_to_name(ctx, cs))); PyTuple_SET_ITEM(entry, 6, JM_EscapeStrFromStr(pdf_to_name(ctx, altcs))); PyTuple_SET_ITEM(entry, 7, JM_EscapeStrFromStr(pdf_to_name(ctx, refname))); PyTuple_SET_ITEM(entry, 8, JM_EscapeStrFromStr(pdf_to_name(ctx, filter))); PyTuple_SET_ITEM(entry, 9, Py_BuildValue("i", stream_xref)); LIST_APPEND_DROP(imagelist, entry); } return rc; } //------------------------------------------------------------------------- // Store info of a /Form xobject in Python list //------------------------------------------------------------------------- int JM_gather_forms(fz_context *ctx, pdf_document *doc, pdf_obj *dict, PyObject *imagelist, int stream_xref) { int i, rc = 1, n = pdf_dict_len(ctx, dict); fz_rect bbox; fz_matrix mat; pdf_obj *o = NULL, *m = NULL; for (i = 0; i < n; i++) { pdf_obj *imagedict; pdf_obj *refname = NULL; pdf_obj *type; refname = pdf_dict_get_key(ctx, dict, i); imagedict = pdf_dict_get_val(ctx, dict, i); if (!pdf_is_dict(ctx, imagedict)) { fz_warn(ctx, "'%s' is no form dict (%d 0 R)", pdf_to_name(ctx, refname), pdf_to_num(ctx, imagedict)); continue; } type = pdf_dict_get(ctx, imagedict, PDF_NAME(Subtype)); if (!pdf_name_eq(ctx, type, PDF_NAME(Form))) continue; o = pdf_dict_get(ctx, imagedict, PDF_NAME(BBox)); m = pdf_dict_get(ctx, imagedict, PDF_NAME(Matrix)); if (m) { mat = pdf_to_matrix(ctx, m); } else { mat = fz_identity; } if (o) { bbox = fz_transform_rect(pdf_to_rect(ctx, o), mat); } else { bbox = fz_infinite_rect; } int xref = pdf_to_num(ctx, imagedict); PyObject *entry = PyTuple_New(4); PyTuple_SET_ITEM(entry, 0, Py_BuildValue("i", xref)); PyTuple_SET_ITEM(entry, 1, Py_BuildValue("s", pdf_to_name(ctx, refname))); PyTuple_SET_ITEM(entry, 2, Py_BuildValue("i", stream_xref)); PyTuple_SET_ITEM(entry, 3, JM_py_from_rect(bbox)); LIST_APPEND_DROP(imagelist, entry); } return rc; } //------------------------------------------------------------------------- // Step through /Resources, looking up image, xobject or font information //------------------------------------------------------------------------- void JM_scan_resources(fz_context *ctx, pdf_document *pdf, pdf_obj *rsrc, PyObject *liste, int what, int stream_xref, PyObject *tracer) { pdf_obj *font, *xobj, *subrsrc; int i, n, sxref; if (pdf_mark_obj(ctx, rsrc)) { fz_warn(ctx, "Circular dependencies! Consider page cleaning."); return; // Circular dependencies! } fz_try(ctx) { xobj = pdf_dict_get(ctx, rsrc, PDF_NAME(XObject)); if (what == 1) { // lookup fonts font = pdf_dict_get(ctx, rsrc, PDF_NAME(Font)); JM_gather_fonts(ctx, pdf, font, liste, stream_xref); } else if (what == 2) { // look up images JM_gather_images(ctx, pdf, xobj, liste, stream_xref); } else if (what == 3) { // look up form xobjects JM_gather_forms(ctx, pdf, xobj, liste, stream_xref); } else { // should never happen goto finished; } // check if we need to recurse into Form XObjects n = pdf_dict_len(ctx, xobj); for (i = 0; i < n; i++) { pdf_obj *obj = pdf_dict_get_val(ctx, xobj, i); if (pdf_is_stream(ctx, obj)) { sxref = pdf_to_num(ctx, obj); } else { sxref = 0; } subrsrc = pdf_dict_get(ctx, obj, PDF_NAME(Resources)); if (subrsrc) { PyObject *sxref_t = Py_BuildValue("i", sxref); if (PySequence_Contains(tracer, sxref_t) == 0) { LIST_APPEND_DROP(tracer, sxref_t); JM_scan_resources(ctx, pdf, subrsrc, liste, what, sxref, tracer); } else { Py_DECREF(sxref_t); PyErr_Clear(); fz_warn(ctx, "Circular dependencies! Consider page cleaning."); goto finished; } } } finished:; } fz_always(ctx) { pdf_unmark_obj(ctx, rsrc); } fz_catch(ctx) { fz_rethrow(ctx); } } %} ================================================ FILE: src_classic/helper-pixmap.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //----------------------------------------------------------------------------- // pixmap helper functions //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // Clear a pixmap rectangle - my version also supports non-alpha pixmaps //----------------------------------------------------------------------------- int JM_clear_pixmap_rect_with_value(fz_context *ctx, fz_pixmap *dest, int value, fz_irect b) { unsigned char *destp; int x, y, w, k, destspan; b = fz_intersect_irect(b, fz_pixmap_bbox(ctx, dest)); w = b.x1 - b.x0; y = b.y1 - b.y0; if (w <= 0 || y <= 0) return 0; destspan = dest->stride; destp = dest->samples + (unsigned int)(destspan * (b.y0 - dest->y) + dest->n * (b.x0 - dest->x)); /* CMYK needs special handling (and potentially any other subtractive colorspaces) */ if (fz_colorspace_n(ctx, dest->colorspace) == 4) { value = 255 - value; do { unsigned char *s = destp; for (x = 0; x < w; x++) { *s++ = 0; *s++ = 0; *s++ = 0; *s++ = value; if (dest->alpha) *s++ = 255; } destp += destspan; } while (--y); return 1; } do { unsigned char *s = destp; for (x = 0; x < w; x++) { for (k = 0; k < dest->n - 1; k++) *s++ = value; if (dest->alpha) *s++ = 255; else *s++ = value; } destp += destspan; } while (--y); return 1; } //----------------------------------------------------------------------------- // fill a rect with a color tuple //----------------------------------------------------------------------------- int JM_fill_pixmap_rect_with_color(fz_context *ctx, fz_pixmap *dest, unsigned char col[5], fz_irect b) { unsigned char *destp; int x, y, w, i, destspan; b = fz_intersect_irect(b, fz_pixmap_bbox(ctx, dest)); w = b.x1 - b.x0; y = b.y1 - b.y0; if (w <= 0 || y <= 0) return 0; destspan = dest->stride; destp = dest->samples + (unsigned int)(destspan * (b.y0 - dest->y) + dest->n * (b.x0 - dest->x)); do { unsigned char *s = destp; for (x = 0; x < w; x++) { for (i = 0; i < dest->n; i++) *s++ = col[i]; } destp += destspan; } while (--y); return 1; } //----------------------------------------------------------------------------- // invert a rectangle - also supports non-alpha pixmaps //----------------------------------------------------------------------------- int JM_invert_pixmap_rect(fz_context *ctx, fz_pixmap *dest, fz_irect b) { unsigned char *destp; int x, y, w, i, destspan; b = fz_intersect_irect(b, fz_pixmap_bbox(ctx, dest)); w = b.x1 - b.x0; y = b.y1 - b.y0; if (w <= 0 || y <= 0) return 0; destspan = dest->stride; destp = dest->samples + (unsigned int)(destspan * (b.y0 - dest->y) + dest->n * (b.x0 - dest->x)); int n0 = dest->n - dest->alpha; do { unsigned char *s = destp; for (x = 0; x < w; x++) { for (i = 0; i < n0; i++) { *s = 255 - *s; s++; } if (dest->alpha) s++; } destp += destspan; } while (--y); return 1; } int JM_is_jbig2_image(fz_context *ctx, pdf_obj *dict) { // fixme: should we remove this function? return 0; /* pdf_obj *filter; int i, n; filter = pdf_dict_get(ctx, dict, PDF_NAME(Filter)); if (pdf_name_eq(ctx, filter, PDF_NAME(JBIG2Decode))) return 1; n = pdf_array_len(ctx, filter); for (i = 0; i < n; i++) if (pdf_name_eq(ctx, pdf_array_get(ctx, filter, i), PDF_NAME(JBIG2Decode))) return 1; return 0; */ } //----------------------------------------------------------------------------- // Return basic properties of an image provided as bytes or bytearray // The function creates an fz_image and optionally returns it. //----------------------------------------------------------------------------- PyObject *JM_image_profile(fz_context *ctx, PyObject *imagedata, int keep_image) { if (!EXISTS(imagedata)) { Py_RETURN_NONE; // nothing given } fz_image *image = NULL; fz_buffer *res = NULL; PyObject *result = NULL; unsigned char *c = NULL; Py_ssize_t len = 0; if (PyBytes_Check(imagedata)) { c = PyBytes_AS_STRING(imagedata); len = PyBytes_GET_SIZE(imagedata); } else if (PyByteArray_Check(imagedata)) { c = PyByteArray_AS_STRING(imagedata); len = PyByteArray_GET_SIZE(imagedata); } else { PySys_WriteStderr("bad image data\n"); Py_RETURN_NONE; } if (len < 8) { PySys_WriteStderr("bad image data\n"); Py_RETURN_NONE; } int type = fz_recognize_image_format(ctx, c); if (type == FZ_IMAGE_UNKNOWN) { Py_RETURN_NONE; } fz_try(ctx) { if (keep_image) { res = fz_new_buffer_from_copied_data(ctx, c, (size_t) len); } else { res = fz_new_buffer_from_shared_data(ctx, c, (size_t) len); } image = fz_new_image_from_buffer(ctx, res); int xres, yres, orientation; fz_matrix ctm = fz_image_orientation_matrix(ctx, image); fz_image_resolution(image, &xres, &yres); orientation = (int) fz_image_orientation(ctx, image); const char *cs_name = fz_colorspace_name(ctx, image->colorspace); result = PyDict_New(); DICT_SETITEM_DROP(result, dictkey_width, Py_BuildValue("i", image->w)); DICT_SETITEM_DROP(result, dictkey_height, Py_BuildValue("i", image->h)); DICT_SETITEMSTR_DROP(result, "orientation", Py_BuildValue("i", orientation)); DICT_SETITEM_DROP(result, dictkey_matrix, JM_py_from_matrix(ctm)); DICT_SETITEM_DROP(result, dictkey_xres, Py_BuildValue("i", xres)); DICT_SETITEM_DROP(result, dictkey_yres, Py_BuildValue("i", yres)); DICT_SETITEM_DROP(result, dictkey_colorspace, Py_BuildValue("i", image->n)); DICT_SETITEM_DROP(result, dictkey_bpc, Py_BuildValue("i", image->bpc)); DICT_SETITEM_DROP(result, dictkey_ext, Py_BuildValue("s", JM_image_extension(type))); DICT_SETITEM_DROP(result, dictkey_cs_name, Py_BuildValue("s", cs_name)); if (keep_image) { DICT_SETITEM_DROP(result, dictkey_image, PyLong_FromVoidPtr((void *) fz_keep_image(ctx, image))); } } fz_always(ctx) { if (!keep_image) { fz_drop_image(ctx, image); } else { fz_drop_buffer(ctx, res); // drop the buffer copy } } fz_catch(ctx) { Py_CLEAR(result); fz_rethrow(ctx); } PyErr_Clear(); return result; } //---------------------------------------------------------------------------- // Version of fz_new_pixmap_from_display_list (util.c) to also support // rendering of only the 'clip' part of the displaylist rectangle //---------------------------------------------------------------------------- fz_pixmap * JM_pixmap_from_display_list(fz_context *ctx, fz_display_list *list, PyObject *ctm, fz_colorspace *cs, int alpha, PyObject *clip, fz_separations *seps ) { fz_rect rect = fz_bound_display_list(ctx, list); fz_matrix matrix = JM_matrix_from_py(ctm); fz_pixmap *pix = NULL; fz_var(pix); fz_device *dev = NULL; fz_var(dev); fz_rect rclip = JM_rect_from_py(clip); rect = fz_intersect_rect(rect, rclip); // no-op if clip is not given rect = fz_transform_rect(rect, matrix); fz_irect irect = fz_round_rect(rect); pix = fz_new_pixmap_with_bbox(ctx, cs, irect, seps, alpha); if (alpha) fz_clear_pixmap(ctx, pix); else fz_clear_pixmap_with_value(ctx, pix, 0xFF); fz_try(ctx) { if (!fz_is_infinite_rect(rclip)) { dev = fz_new_draw_device_with_bbox(ctx, matrix, pix, &irect); fz_run_display_list(ctx, list, dev, fz_identity, rclip, NULL); } else { dev = fz_new_draw_device(ctx, matrix, pix); fz_run_display_list(ctx, list, dev, fz_identity, fz_infinite_rect, NULL); } fz_close_device(ctx, dev); } fz_always(ctx) { fz_drop_device(ctx, dev); } fz_catch(ctx) { fz_drop_pixmap(ctx, pix); fz_rethrow(ctx); } return pix; } //---------------------------------------------------------------------------- // Pixmap creation directly using a short-lived displaylist, so we can support // separations. //---------------------------------------------------------------------------- fz_pixmap * JM_pixmap_from_page(fz_context *ctx, fz_document *doc, fz_page *page, PyObject *ctm, fz_colorspace *cs, int alpha, int annots, PyObject *clip ) { enum { SPOTS_NONE, SPOTS_OVERPRINT_SIM, SPOTS_FULL }; int spots; if (FZ_ENABLE_SPOT_RENDERING) spots = SPOTS_OVERPRINT_SIM; else spots = SPOTS_NONE; fz_separations *seps = NULL; fz_pixmap *pix = NULL; fz_colorspace *oi = NULL; fz_var(oi); fz_colorspace *colorspace = cs; fz_rect rect; fz_irect bbox; fz_device *dev = NULL; fz_var(dev); fz_matrix matrix = JM_matrix_from_py(ctm); rect = fz_bound_page(ctx, page); fz_rect rclip = JM_rect_from_py(clip); rect = fz_intersect_rect(rect, rclip); // no-op if clip is not given rect = fz_transform_rect(rect, matrix); bbox = fz_round_rect(rect); fz_try(ctx) { // Pixmap of the document's /OutputIntents ("output intents") oi = fz_document_output_intent(ctx, doc); // if present and compatible, use it instead of the parameter if (oi) { if (fz_colorspace_n(ctx, oi) == fz_colorspace_n(ctx, cs)) { colorspace = fz_keep_colorspace(ctx, oi); } } // check if spots rendering is available and if so use separations if (spots != SPOTS_NONE) { seps = fz_page_separations(ctx, page); if (seps) { int i, n = fz_count_separations(ctx, seps); if (spots == SPOTS_FULL) for (i = 0; i < n; i++) fz_set_separation_behavior(ctx, seps, i, FZ_SEPARATION_SPOT); else for (i = 0; i < n; i++) fz_set_separation_behavior(ctx, seps, i, FZ_SEPARATION_COMPOSITE); } else if (fz_page_uses_overprint(ctx, page)) { /* This page uses overprint, so we need an empty * sep object to force the overprint simulation on. */ seps = fz_new_separations(ctx, 0); } else if (oi && fz_colorspace_n(ctx, oi) != fz_colorspace_n(ctx, colorspace)) { /* We have an output intent, and it's incompatible * with the colorspace our device needs. Force the * overprint simulation on, because this ensures that * we 'simulate' the output intent too. */ seps = fz_new_separations(ctx, 0); } } pix = fz_new_pixmap_with_bbox(ctx, colorspace, bbox, seps, alpha); if (alpha) { fz_clear_pixmap(ctx, pix); } else { fz_clear_pixmap_with_value(ctx, pix, 0xFF); } dev = fz_new_draw_device(ctx, matrix, pix); if (annots) { fz_run_page(ctx, page, dev, fz_identity, NULL); } else { fz_run_page_contents(ctx, page, dev, fz_identity, NULL); } fz_close_device(ctx, dev); } fz_always(ctx) { fz_drop_device(ctx, dev); fz_drop_separations(ctx, seps); fz_drop_colorspace(ctx, oi); } fz_catch(ctx) { fz_rethrow(ctx); } return pix; } PyObject *JM_color_count(fz_context *ctx, fz_pixmap *pm, PyObject *clip) { PyObject *rc = PyDict_New(), *pixel=NULL, *c=NULL; long cnt=0; fz_irect irect = fz_pixmap_bbox(ctx, pm); irect = fz_intersect_irect(irect, fz_round_rect(JM_rect_from_py(clip))); size_t stride = pm->stride; size_t width = irect.x1 - irect.x0, height = irect.y1 - irect.y0; size_t i, j, n = (size_t) pm->n, substride = width * n; unsigned char *s = pm->samples + stride * (irect.y0 - pm->y) + (irect.x0 - pm->x) * n; unsigned char oldpix[10], newpix[10]; memcpy(oldpix, s, n); cnt = 0; fz_try(ctx) { if (fz_is_empty_irect(irect)) goto finished; for (i = 0; i < height; i++) { for (j = 0; j < substride; j += n) { memcpy(newpix, s + j, n); if (memcmp(oldpix, newpix,n) != 0) { pixel = PyBytes_FromStringAndSize(oldpix, n); c = PyDict_GetItem(rc, pixel); if (c) cnt += PyLong_AsLong(c); DICT_SETITEM_DROP(rc, pixel, PyLong_FromLong(cnt)); Py_DECREF(pixel); cnt = 1; memcpy(oldpix, newpix, n); } else { cnt += 1; } } s += stride; } pixel = PyBytes_FromStringAndSize(oldpix, n); c = PyDict_GetItem(rc, pixel); if (c) cnt += PyLong_AsLong(c); DICT_SETITEM_DROP(rc, pixel, PyLong_FromLong(cnt)); Py_DECREF(pixel); finished:; } fz_catch(ctx) { Py_CLEAR(rc); fz_rethrow(ctx); } PyErr_Clear(); return rc; } %} ================================================ FILE: src_classic/helper-portfolio.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //----------------------------------------------------------------------------- // perform some cleaning if we have /EmbeddedFiles: // (1) remove any /Limits if /Names exists // (2) remove any empty /Collection // (3) set /PageMode/UseAttachments //----------------------------------------------------------------------------- void JM_embedded_clean(fz_context *ctx, pdf_document *pdf) { pdf_obj *root = pdf_dict_get(ctx, pdf_trailer(ctx, pdf), PDF_NAME(Root)); // remove any empty /Collection entry pdf_obj *coll = pdf_dict_get(ctx, root, PDF_NAME(Collection)); if (coll && pdf_dict_len(ctx, coll) == 0) pdf_dict_del(ctx, root, PDF_NAME(Collection)); pdf_obj *efiles = pdf_dict_getl(ctx, root, PDF_NAME(Names), PDF_NAME(EmbeddedFiles), PDF_NAME(Names), NULL); if (efiles) { pdf_dict_put_name(ctx, root, PDF_NAME(PageMode), "UseAttachments"); } return; } //----------------------------------------------------------------------------- // embed a new file in a PDF (not only /EmbeddedFiles entries) //----------------------------------------------------------------------------- pdf_obj *JM_embed_file(fz_context *ctx, pdf_document *pdf, fz_buffer *buf, char *filename, char *ufilename, char *desc, int compress) { size_t len = 0; pdf_obj *ef, *f, *params, *val = NULL; fz_buffer *buff2 = NULL; fz_var(buff2); fz_try(ctx) { val = pdf_new_dict(ctx, pdf, 6); pdf_dict_put_dict(ctx, val, PDF_NAME(CI), 4); ef = pdf_dict_put_dict(ctx, val, PDF_NAME(EF), 4); pdf_dict_put_text_string(ctx, val, PDF_NAME(F), filename); pdf_dict_put_text_string(ctx, val, PDF_NAME(UF), ufilename); pdf_dict_put_text_string(ctx, val, PDF_NAME(Desc), desc); pdf_dict_put(ctx, val, PDF_NAME(Type), PDF_NAME(Filespec)); buff2 = fz_new_buffer_from_copied_data(ctx, " ", 1); f = pdf_add_stream(ctx, pdf, buff2, NULL, 0); pdf_dict_put_drop(ctx, ef, PDF_NAME(F), f); JM_update_stream(ctx, pdf, f, buf, compress); len = fz_buffer_storage(ctx, buf, NULL); pdf_dict_put_int(ctx, f, PDF_NAME(DL), len); pdf_dict_put_int(ctx, f, PDF_NAME(Length), len); params = pdf_dict_put_dict(ctx, f, PDF_NAME(Params), 4); pdf_dict_put_int(ctx, params, PDF_NAME(Size), len); } fz_always(ctx) { fz_drop_buffer(ctx, buff2); } fz_catch(ctx) { fz_rethrow(ctx); } return val; } %} ================================================ FILE: src_classic/helper-python.i ================================================ %pythoncode %{ # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ # ------------------------------------------------------------------------------ # Various PDF Optional Content Flags # ------------------------------------------------------------------------------ PDF_OC_ON = 0 PDF_OC_TOGGLE = 1 PDF_OC_OFF = 2 # ------------------------------------------------------------------------------ # link kinds and link flags # ------------------------------------------------------------------------------ LINK_NONE = 0 LINK_GOTO = 1 LINK_URI = 2 LINK_LAUNCH = 3 LINK_NAMED = 4 LINK_GOTOR = 5 LINK_FLAG_L_VALID = 1 LINK_FLAG_T_VALID = 2 LINK_FLAG_R_VALID = 4 LINK_FLAG_B_VALID = 8 LINK_FLAG_FIT_H = 16 LINK_FLAG_FIT_V = 32 LINK_FLAG_R_IS_ZOOM = 64 # ------------------------------------------------------------------------------ # Text handling flags # ------------------------------------------------------------------------------ TEXT_ALIGN_LEFT = 0 TEXT_ALIGN_CENTER = 1 TEXT_ALIGN_RIGHT = 2 TEXT_ALIGN_JUSTIFY = 3 TEXT_OUTPUT_TEXT = 0 TEXT_OUTPUT_HTML = 1 TEXT_OUTPUT_JSON = 2 TEXT_OUTPUT_XML = 3 TEXT_OUTPUT_XHTML = 4 TEXT_PRESERVE_LIGATURES = 1 TEXT_PRESERVE_WHITESPACE = 2 TEXT_PRESERVE_IMAGES = 4 TEXT_INHIBIT_SPACES = 8 TEXT_DEHYPHENATE = 16 TEXT_PRESERVE_SPANS = 32 TEXT_MEDIABOX_CLIP = 64 TEXT_CID_FOR_UNKNOWN_UNICODE = 128 TEXTFLAGS_WORDS = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_BLOCKS = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_DICT = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_RAWDICT = TEXTFLAGS_DICT TEXTFLAGS_SEARCH = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_DEHYPHENATE | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_HTML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_XHTML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_PRESERVE_IMAGES | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_XML = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_CID_FOR_UNKNOWN_UNICODE ) TEXTFLAGS_TEXT = (0 | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP | TEXT_CID_FOR_UNKNOWN_UNICODE ) # ------------------------------------------------------------------------------ # Simple text encoding options # ------------------------------------------------------------------------------ TEXT_ENCODING_LATIN = 0 TEXT_ENCODING_GREEK = 1 TEXT_ENCODING_CYRILLIC = 2 # ------------------------------------------------------------------------------ # Stamp annotation icon numbers # ------------------------------------------------------------------------------ STAMP_Approved = 0 STAMP_AsIs = 1 STAMP_Confidential = 2 STAMP_Departmental = 3 STAMP_Experimental = 4 STAMP_Expired = 5 STAMP_Final = 6 STAMP_ForComment = 7 STAMP_ForPublicRelease = 8 STAMP_NotApproved = 9 STAMP_NotForPublicRelease = 10 STAMP_Sold = 11 STAMP_TopSecret = 12 STAMP_Draft = 13 # ------------------------------------------------------------------------------ # Base 14 font names and dictionary # ------------------------------------------------------------------------------ Base14_fontnames = ( "Courier", "Courier-Oblique", "Courier-Bold", "Courier-BoldOblique", "Helvetica", "Helvetica-Oblique", "Helvetica-Bold", "Helvetica-BoldOblique", "Times-Roman", "Times-Italic", "Times-Bold", "Times-BoldItalic", "Symbol", "ZapfDingbats", ) Base14_fontdict = {} for f in Base14_fontnames: Base14_fontdict[f.lower()] = f del f Base14_fontdict["helv"] = "Helvetica" Base14_fontdict["heit"] = "Helvetica-Oblique" Base14_fontdict["hebo"] = "Helvetica-Bold" Base14_fontdict["hebi"] = "Helvetica-BoldOblique" Base14_fontdict["cour"] = "Courier" Base14_fontdict["coit"] = "Courier-Oblique" Base14_fontdict["cobo"] = "Courier-Bold" Base14_fontdict["cobi"] = "Courier-BoldOblique" Base14_fontdict["tiro"] = "Times-Roman" Base14_fontdict["tibo"] = "Times-Bold" Base14_fontdict["tiit"] = "Times-Italic" Base14_fontdict["tibi"] = "Times-BoldItalic" Base14_fontdict["symb"] = "Symbol" Base14_fontdict["zadb"] = "ZapfDingbats" annot_skel = { "goto1": "<>/Rect[%s]/BS<>/Subtype/Link>>", "goto2": "<>/Rect[%s]/BS<>/Subtype/Link>>", "gotor1": "<>>>/Rect[%s]/BS<>/Subtype/Link>>", "gotor2": "<>/Rect[%s]/BS<>/Subtype/Link>>", "launch": "<>>>/Rect[%s]/BS<>/Subtype/Link>>", "uri": "<>/Rect[%s]/BS<>/Subtype/Link>>", "named": "<>/Rect[%s]/BS<>/Subtype/Link>>", } class FileDataError(RuntimeError): """Raised for documents with file structure issues.""" pass class FileNotFoundError(RuntimeError): """Raised if file does not exist.""" pass class EmptyFileError(FileDataError): """Raised when creating documents from zero-length data.""" pass # propagate exception class to C-level code _set_FileDataError(FileDataError) def css_for_pymupdf_font( fontcode: str, *, CSS: OptStr = None, archive: AnyType = None, name: OptStr = None ) -> str: """Create @font-face items for the given fontcode of pymupdf-fonts. Adds @font-face support for fonts contained in package pymupdf-fonts. Creates a CSS font-family for all fonts starting with string 'fontcode'. Note: The font naming convention in package pymupdf-fonts is "fontcode", where the suffix "sf" is either empty or one of "it", "bo" or "bi". These suffixes thus represent the regular, italic, bold or bold-italic variants of a font. For example, font code "notos" refers to fonts "notos" - "Noto Sans Regular" "notosit" - "Noto Sans Italic" "notosbo" - "Noto Sans Bold" "notosbi" - "Noto Sans Bold Italic" This function creates four CSS @font-face definitions and collectively assigns the font-family name "notos" to them (or the "name" value). All fitting font buffers of the pymupdf-fonts package are placed / added to the archive provided as parameter. To use the font in fitz.Story, execute 'set_font(fontcode)'. The correct font weight (bold) or style (italic) will automatically be selected. Expects and returns the CSS source, with the new CSS definitions appended. Args: fontcode: (str) font code for naming the font variants to include. E.g. "fig" adds notos, notosi, notosb, notosbi fonts. A maximum of 4 font variants is accepted. CSS: (str) CSS string to add @font-face definitions to. archive: (Archive, mandatory) where to place the font buffers. name: (str) use this as family-name instead of 'fontcode'. Returns: Modified CSS, with appended @font-face statements for each font variant of fontcode. Fontbuffers associated with "fontcode" will be added to 'archive'. """ # @font-face template string CSSFONT = "\n@font-face {font-family: %s; src: url(%s);%s%s}\n" if not type(archive) is Archive: raise ValueError("'archive' must be an Archive") if CSS == None: CSS = "" # select font codes starting with the pass-in string font_keys = [k for k in fitz_fontdescriptors.keys() if k.startswith(fontcode)] if font_keys == []: raise ValueError(f"No font code '{fontcode}' found in pymupdf-fonts.") if len(font_keys) > 4: raise ValueError("fontcode too short") if name == None: # use this name for font-family name = fontcode for fkey in font_keys: font = fitz_fontdescriptors[fkey] bold = font["bold"] # determine font property italic = font["italic"] # determine font property fbuff = font["loader"]() # load the fontbuffer archive.add(fbuff, fkey) # update the archive bold_text = "font-weight: bold;" if bold else "" italic_text = "font-style: italic;" if italic else "" CSS += CSSFONT % (name, fkey, bold_text, italic_text) return CSS def get_text_length(text: str, fontname: str ="helv", fontsize: float =11, encoding: int =0) -> float: """Calculate length of a string for a built-in font. Args: fontname: name of the font. fontsize: font size points. encoding: encoding to use, 0=Latin (default), 1=Greek, 2=Cyrillic. Returns: (float) length of text. """ fontname = fontname.lower() basename = Base14_fontdict.get(fontname, None) glyphs = None if basename == "Symbol": glyphs = symbol_glyphs if basename == "ZapfDingbats": glyphs = zapf_glyphs if glyphs is not None: w = sum([glyphs[ord(c)][1] if ord(c) < 256 else glyphs[183][1] for c in text]) return w * fontsize if fontname in Base14_fontdict.keys(): return util_measure_string( text, Base14_fontdict[fontname], fontsize, encoding ) if fontname in ( "china-t", "china-s", "china-ts", "china-ss", "japan", "japan-s", "korea", "korea-s", ): return len(text) * fontsize raise ValueError("Font '%s' is unsupported" % fontname) # ------------------------------------------------------------------------------ # Glyph list for the built-in font 'ZapfDingbats' # ------------------------------------------------------------------------------ zapf_glyphs = ( (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (32, 0.278), (33, 0.974), (34, 0.961), (35, 0.974), (36, 0.98), (37, 0.719), (38, 0.789), (39, 0.79), (40, 0.791), (41, 0.69), (42, 0.96), (43, 0.939), (44, 0.549), (45, 0.855), (46, 0.911), (47, 0.933), (48, 0.911), (49, 0.945), (50, 0.974), (51, 0.755), (52, 0.846), (53, 0.762), (54, 0.761), (55, 0.571), (56, 0.677), (57, 0.763), (58, 0.76), (59, 0.759), (60, 0.754), (61, 0.494), (62, 0.552), (63, 0.537), (64, 0.577), (65, 0.692), (66, 0.786), (67, 0.788), (68, 0.788), (69, 0.79), (70, 0.793), (71, 0.794), (72, 0.816), (73, 0.823), (74, 0.789), (75, 0.841), (76, 0.823), (77, 0.833), (78, 0.816), (79, 0.831), (80, 0.923), (81, 0.744), (82, 0.723), (83, 0.749), (84, 0.79), (85, 0.792), (86, 0.695), (87, 0.776), (88, 0.768), (89, 0.792), (90, 0.759), (91, 0.707), (92, 0.708), (93, 0.682), (94, 0.701), (95, 0.826), (96, 0.815), (97, 0.789), (98, 0.789), (99, 0.707), (100, 0.687), (101, 0.696), (102, 0.689), (103, 0.786), (104, 0.787), (105, 0.713), (106, 0.791), (107, 0.785), (108, 0.791), (109, 0.873), (110, 0.761), (111, 0.762), (112, 0.762), (113, 0.759), (114, 0.759), (115, 0.892), (116, 0.892), (117, 0.788), (118, 0.784), (119, 0.438), (120, 0.138), (121, 0.277), (122, 0.415), (123, 0.392), (124, 0.392), (125, 0.668), (126, 0.668), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (183, 0.788), (161, 0.732), (162, 0.544), (163, 0.544), (164, 0.91), (165, 0.667), (166, 0.76), (167, 0.76), (168, 0.776), (169, 0.595), (170, 0.694), (171, 0.626), (172, 0.788), (173, 0.788), (174, 0.788), (175, 0.788), (176, 0.788), (177, 0.788), (178, 0.788), (179, 0.788), (180, 0.788), (181, 0.788), (182, 0.788), (183, 0.788), (184, 0.788), (185, 0.788), (186, 0.788), (187, 0.788), (188, 0.788), (189, 0.788), (190, 0.788), (191, 0.788), (192, 0.788), (193, 0.788), (194, 0.788), (195, 0.788), (196, 0.788), (197, 0.788), (198, 0.788), (199, 0.788), (200, 0.788), (201, 0.788), (202, 0.788), (203, 0.788), (204, 0.788), (205, 0.788), (206, 0.788), (207, 0.788), (208, 0.788), (209, 0.788), (210, 0.788), (211, 0.788), (212, 0.894), (213, 0.838), (214, 1.016), (215, 0.458), (216, 0.748), (217, 0.924), (218, 0.748), (219, 0.918), (220, 0.927), (221, 0.928), (222, 0.928), (223, 0.834), (224, 0.873), (225, 0.828), (226, 0.924), (227, 0.924), (228, 0.917), (229, 0.93), (230, 0.931), (231, 0.463), (232, 0.883), (233, 0.836), (234, 0.836), (235, 0.867), (236, 0.867), (237, 0.696), (238, 0.696), (239, 0.874), (183, 0.788), (241, 0.874), (242, 0.76), (243, 0.946), (244, 0.771), (245, 0.865), (246, 0.771), (247, 0.888), (248, 0.967), (249, 0.888), (250, 0.831), (251, 0.873), (252, 0.927), (253, 0.97), (183, 0.788), (183, 0.788), ) # ------------------------------------------------------------------------------ # Glyph list for the built-in font 'Symbol' # ------------------------------------------------------------------------------ symbol_glyphs = ( (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (32, 0.25), (33, 0.333), (34, 0.713), (35, 0.5), (36, 0.549), (37, 0.833), (38, 0.778), (39, 0.439), (40, 0.333), (41, 0.333), (42, 0.5), (43, 0.549), (44, 0.25), (45, 0.549), (46, 0.25), (47, 0.278), (48, 0.5), (49, 0.5), (50, 0.5), (51, 0.5), (52, 0.5), (53, 0.5), (54, 0.5), (55, 0.5), (56, 0.5), (57, 0.5), (58, 0.278), (59, 0.278), (60, 0.549), (61, 0.549), (62, 0.549), (63, 0.444), (64, 0.549), (65, 0.722), (66, 0.667), (67, 0.722), (68, 0.612), (69, 0.611), (70, 0.763), (71, 0.603), (72, 0.722), (73, 0.333), (74, 0.631), (75, 0.722), (76, 0.686), (77, 0.889), (78, 0.722), (79, 0.722), (80, 0.768), (81, 0.741), (82, 0.556), (83, 0.592), (84, 0.611), (85, 0.69), (86, 0.439), (87, 0.768), (88, 0.645), (89, 0.795), (90, 0.611), (91, 0.333), (92, 0.863), (93, 0.333), (94, 0.658), (95, 0.5), (96, 0.5), (97, 0.631), (98, 0.549), (99, 0.549), (100, 0.494), (101, 0.439), (102, 0.521), (103, 0.411), (104, 0.603), (105, 0.329), (106, 0.603), (107, 0.549), (108, 0.549), (109, 0.576), (110, 0.521), (111, 0.549), (112, 0.549), (113, 0.521), (114, 0.549), (115, 0.603), (116, 0.439), (117, 0.576), (118, 0.713), (119, 0.686), (120, 0.493), (121, 0.686), (122, 0.494), (123, 0.48), (124, 0.2), (125, 0.48), (126, 0.549), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (183, 0.46), (160, 0.25), (161, 0.62), (162, 0.247), (163, 0.549), (164, 0.167), (165, 0.713), (166, 0.5), (167, 0.753), (168, 0.753), (169, 0.753), (170, 0.753), (171, 1.042), (172, 0.713), (173, 0.603), (174, 0.987), (175, 0.603), (176, 0.4), (177, 0.549), (178, 0.411), (179, 0.549), (180, 0.549), (181, 0.576), (182, 0.494), (183, 0.46), (184, 0.549), (185, 0.549), (186, 0.549), (187, 0.549), (188, 1), (189, 0.603), (190, 1), (191, 0.658), (192, 0.823), (193, 0.686), (194, 0.795), (195, 0.987), (196, 0.768), (197, 0.768), (198, 0.823), (199, 0.768), (200, 0.768), (201, 0.713), (202, 0.713), (203, 0.713), (204, 0.713), (205, 0.713), (206, 0.713), (207, 0.713), (208, 0.768), (209, 0.713), (210, 0.79), (211, 0.79), (212, 0.89), (213, 0.823), (214, 0.549), (215, 0.549), (216, 0.713), (217, 0.603), (218, 0.603), (219, 1.042), (220, 0.987), (221, 0.603), (222, 0.987), (223, 0.603), (224, 0.494), (225, 0.329), (226, 0.79), (227, 0.79), (228, 0.786), (229, 0.713), (230, 0.384), (231, 0.384), (232, 0.384), (233, 0.384), (234, 0.384), (235, 0.384), (236, 0.494), (237, 0.494), (238, 0.494), (239, 0.494), (183, 0.46), (241, 0.329), (242, 0.274), (243, 0.686), (244, 0.686), (245, 0.686), (246, 0.384), (247, 0.549), (248, 0.384), (249, 0.384), (250, 0.384), (251, 0.384), (252, 0.494), (253, 0.494), (254, 0.494), (183, 0.46), ) class linkDest(object): """link or outline destination details""" def __init__(self, obj, rlink): isExt = obj.is_external isInt = not isExt self.dest = "" self.fileSpec = "" self.flags = 0 self.isMap = False self.isUri = False self.kind = LINK_NONE self.lt = Point(0, 0) self.named = "" self.newWindow = "" self.page = obj.page self.rb = Point(0, 0) self.uri = obj.uri if rlink and not self.uri.startswith("#"): self.uri = "#page=%i&zoom=0,%g,%g" % (rlink[0] + 1, rlink[1], rlink[2]) if obj.is_external: self.page = -1 self.kind = LINK_URI if not self.uri: self.page = -1 self.kind = LINK_NONE if isInt and self.uri: self.uri = self.uri.replace("&zoom=nan", "&zoom=0") if self.uri.startswith("#"): self.named = "" self.kind = LINK_GOTO m = re.match('^#page=([0-9]+)&zoom=([0-9.]+),(-?[0-9.]+),(-?[0-9.]+)$', self.uri) if m: self.page = int(m.group(1)) - 1 self.lt = Point(float((m.group(3))), float(m.group(4))) self.flags = self.flags | LINK_FLAG_L_VALID | LINK_FLAG_T_VALID else: m = re.match('^#page=([0-9]+)$', self.uri) if m: self.page = int(m.group(1)) - 1 else: self.kind = LINK_NAMED self.named = self.uri[1:] else: self.kind = LINK_NAMED self.named = self.uri if obj.is_external: if self.uri.startswith(("http://", "https://", "mailto:", "ftp://")): self.isUri = True self.kind = LINK_URI elif self.uri.startswith("file://"): self.fileSpec = self.uri[7:] self.isUri = False self.uri = "" self.kind = LINK_LAUNCH ftab = self.fileSpec.split("#") if len(ftab) == 2: if ftab[1].startswith("page="): self.kind = LINK_GOTOR self.fileSpec = ftab[0] self.page = int(ftab[1][5:]) - 1 else: self.isUri = True self.kind = LINK_LAUNCH # ------------------------------------------------------------------------------- # "Now" timestamp in PDF Format # ------------------------------------------------------------------------------- def get_pdf_now() -> str: import time tz = "%s'%s'" % ( str(abs(time.altzone // 3600)).rjust(2, "0"), str((abs(time.altzone // 60) % 60)).rjust(2, "0"), ) tstamp = time.strftime("D:%Y%m%d%H%M%S", time.localtime()) if time.altzone > 0: tstamp += "-" + tz elif time.altzone < 0: tstamp += "+" + tz else: pass return tstamp def get_pdf_str(s: str) -> str: """ Return a PDF string depending on its coding. Notes: Returns a string bracketed with either "()" or "<>" for hex values. If only ascii then "(original)" is returned, else if only 8 bit chars then "(original)" with interspersed octal strings \nnn is returned, else a string "" is returned, where [hexstring] is the UTF-16BE encoding of the original. """ if not bool(s): return "()" def make_utf16be(s): r = bytearray([254, 255]) + bytearray(s, "UTF-16BE") return "<" + r.hex() + ">" # brackets indicate hex # The following either returns the original string with mixed-in # octal numbers \nnn for chars outside the ASCII range, or returns # the UTF-16BE BOM version of the string. r = "" for c in s: oc = ord(c) if oc > 255: # shortcut if beyond 8-bit code range return make_utf16be(s) if oc > 31 and oc < 127: # in ASCII range if c in ("(", ")", "\\"): # these need to be escaped r += "\\" r += c continue if oc > 127: # beyond ASCII r += "\\%03o" % oc continue # now the white spaces if oc == 8: # backspace r += "\\b" elif oc == 9: # tab r += "\\t" elif oc == 10: # line feed r += "\\n" elif oc == 12: # form feed r += "\\f" elif oc == 13: # carriage return r += "\\r" else: r += "\\267" # unsupported: replace by 0xB7 return "(" + r + ")" def getTJstr(text: str, glyphs: typing.Union[list, tuple, None], simple: bool, ordering: int) -> str: """ Return a PDF string enclosed in [] brackets, suitable for the PDF TJ operator. Notes: The input string is converted to either 2 or 4 hex digits per character. Args: simple: no glyphs: 2-chars, use char codes as the glyph glyphs: 2-chars, use glyphs instead of char codes (Symbol, ZapfDingbats) not simple: ordering < 0: 4-chars, use glyphs not char codes ordering >=0: a CJK font! 4 chars, use char codes as glyphs """ if text.startswith("[<") and text.endswith(">]"): # already done return text if not bool(text): return "[<>]" if simple: # each char or its glyph is coded as a 2-byte hex if glyphs is None: # not Symbol, not ZapfDingbats: use char code otxt = "".join(["%02x" % ord(c) if ord(c) < 256 else "b7" for c in text]) else: # Symbol or ZapfDingbats: use glyphs otxt = "".join( ["%02x" % glyphs[ord(c)][0] if ord(c) < 256 else "b7" for c in text] ) return "[<" + otxt + ">]" # non-simple fonts: each char or its glyph is coded as 4-byte hex if ordering < 0: # not a CJK font: use the glyphs otxt = "".join(["%04x" % glyphs[ord(c)][0] for c in text]) else: # CJK: use the char codes otxt = "".join(["%04x" % ord(c) for c in text]) return "[<" + otxt + ">]" def paper_sizes(): """Known paper formats @ 72 dpi as a dictionary. Key is the format string like "a4" for ISO-A4. Value is the tuple (width, height). Information taken from the following web sites: www.din-formate.de www.din-formate.info/amerikanische-formate.html www.directtools.de/wissen/normen/iso.htm """ return { "a0": (2384, 3370), "a1": (1684, 2384), "a10": (74, 105), "a2": (1191, 1684), "a3": (842, 1191), "a4": (595, 842), "a5": (420, 595), "a6": (298, 420), "a7": (210, 298), "a8": (147, 210), "a9": (105, 147), "b0": (2835, 4008), "b1": (2004, 2835), "b10": (88, 125), "b2": (1417, 2004), "b3": (1001, 1417), "b4": (709, 1001), "b5": (499, 709), "b6": (354, 499), "b7": (249, 354), "b8": (176, 249), "b9": (125, 176), "c0": (2599, 3677), "c1": (1837, 2599), "c10": (79, 113), "c2": (1298, 1837), "c3": (918, 1298), "c4": (649, 918), "c5": (459, 649), "c6": (323, 459), "c7": (230, 323), "c8": (162, 230), "c9": (113, 162), "card-4x6": (288, 432), "card-5x7": (360, 504), "commercial": (297, 684), "executive": (522, 756), "invoice": (396, 612), "ledger": (792, 1224), "legal": (612, 1008), "legal-13": (612, 936), "letter": (612, 792), "monarch": (279, 540), "tabloid-extra": (864, 1296), } def paper_size(s: str) -> tuple: """Return a tuple (width, height) for a given paper format string. Notes: 'A4-L' will return (842, 595), the values for A4 landscape. Suffix '-P' and no suffix return the portrait tuple. """ size = s.lower() f = "p" if size.endswith("-l"): f = "l" size = size[:-2] if size.endswith("-p"): size = size[:-2] rc = paper_sizes().get(size, (-1, -1)) if f == "p": return rc return (rc[1], rc[0]) def paper_rect(s: str) -> Rect: """Return a Rect for the paper size indicated in string 's'. Must conform to the argument of method 'PaperSize', which will be invoked. """ width, height = paper_size(s) return Rect(0.0, 0.0, width, height) def CheckParent(o: typing.Any): if getattr(o, "parent", None) == None: raise ValueError("orphaned object: parent is None") def EnsureOwnership(o: typing.Any): if not getattr(o, "thisown", False): raise RuntimeError("object destroyed") def CheckColor(c: OptSeq): if c: if ( type(c) not in (list, tuple) or len(c) not in (1, 3, 4) or min(c) < 0 or max(c) > 1 ): raise ValueError("need 1, 3 or 4 color components in range 0 to 1") def ColorCode(c: typing.Union[list, tuple, float, None], f: str) -> str: if not c: return "" if hasattr(c, "__float__"): c = (c,) CheckColor(c) if len(c) == 1: s = "%g " % c[0] return s + "G " if f == "c" else s + "g " if len(c) == 3: s = "%g %g %g " % tuple(c) return s + "RG " if f == "c" else s + "rg " s = "%g %g %g %g " % tuple(c) return s + "K " if f == "c" else s + "k " def JM_TUPLE(o: typing.Sequence) -> tuple: return tuple(map(lambda x: round(x, 5) if abs(x) >= 1e-4 else 0, o)) def JM_TUPLE3(o: typing.Sequence) -> tuple: return tuple(map(lambda x: round(x, 3) if abs(x) >= 1e-3 else 0, o)) def CheckRect(r: typing.Any) -> bool: """Check whether an object is non-degenerate rect-like. It must be a sequence of 4 numbers. """ try: r = Rect(r) except: return False return not (r.is_empty or r.is_infinite) def CheckQuad(q: typing.Any) -> bool: """Check whether an object is convex, not empty quad-like. It must be a sequence of 4 number pairs. """ try: q0 = Quad(q) except: return False return q0.is_convex def CheckMarkerArg(quads: typing.Any) -> tuple: if CheckRect(quads): r = Rect(quads) return (r.quad,) if CheckQuad(quads): return (quads,) for q in quads: if not (CheckRect(q) or CheckQuad(q)): raise ValueError("bad quads entry") return quads def CheckMorph(o: typing.Any) -> bool: if not bool(o): return False if not (type(o) in (list, tuple) and len(o) == 2): raise ValueError("morph must be a sequence of length 2") if not (len(o[0]) == 2 and len(o[1]) == 6): raise ValueError("invalid morph parm 0") if not o[1][4] == o[1][5] == 0: raise ValueError("invalid morph parm 1") return True def CheckFont(page: "struct Page *", fontname: str) -> tuple: """Return an entry in the page's font list if reference name matches. """ for f in page.get_fonts(): if f[4] == fontname: return f def CheckFontInfo(doc: "struct Document *", xref: int) -> list: """Return a font info if present in the document. """ for f in doc.FontInfos: if xref == f[0]: return f def UpdateFontInfo(doc: "struct Document *", info: typing.Sequence): xref = info[0] found = False for i, fi in enumerate(doc.FontInfos): if fi[0] == xref: found = True break if found: doc.FontInfos[i] = info else: doc.FontInfos.append(info) def DUMMY(*args, **kw): return def planish_line(p1: point_like, p2: point_like) -> Matrix: """Compute matrix which maps line from p1 to p2 to the x-axis, such that it maintains its length and p1 * matrix = Point(0, 0). Args: p1, p2: point_like Returns: Matrix which maps p1 to Point(0, 0) and p2 to a point on the x axis at the same distance to Point(0,0). Will always combine a rotation and a transformation. """ p1 = Point(p1) p2 = Point(p2) return Matrix(util_hor_matrix(p1, p2)) def image_profile(img: ByteString) -> dict: """ Return basic properties of an image. Args: img: bytes, bytearray, io.BytesIO object or an opened image file. Returns: A dictionary with keys width, height, colorspace.n, bpc, type, ext and size, where 'type' is the MuPDF image type (0 to 14) and 'ext' the suitable file extension. """ if type(img) is io.BytesIO: stream = img.getvalue() elif hasattr(img, "read"): stream = img.read() elif type(img) in (bytes, bytearray): stream = img else: raise ValueError("bad argument 'img'") return TOOLS.image_profile(stream) def ConversionHeader(i: str, filename: OptStr ="unknown"): t = i.lower() html = """ \n""" xml = ( """ \n""" % filename ) xhtml = """ \n""" text = "" json = '{"document": "%s", "pages": [\n' % filename if t == "html": r = html elif t == "json": r = json elif t == "xml": r = xml elif t == "xhtml": r = xhtml else: r = text return r def ConversionTrailer(i: str): t = i.lower() text = "" json = "]\n}" html = "\n\n" xml = "\n" xhtml = html if t == "html": r = html elif t == "json": r = json elif t == "xml": r = xml elif t == "xhtml": r = xhtml else: r = text return r class ElementPosition(object): """Convert a dictionary with element position information to an object.""" def __init__(self): pass def __str__(self): ret = "" for n, v in self.__dict__.items(): ret += f" {n}={v!r}" return ret def make_story_elpos(): return ElementPosition() def get_highlight_selection(page, start: point_like =None, stop: point_like =None, clip: rect_like =None) -> list: """Return rectangles of text lines between two points. Notes: The default of 'start' is top-left of 'clip'. The default of 'stop' is bottom-reight of 'clip'. Args: start: start point_like stop: end point_like, must be 'below' start clip: consider this rect_like only, default is page rectangle Returns: List of line bbox intersections with the area established by the parameters. """ # validate and normalize arguments if clip is None: clip = page.rect clip = Rect(clip) if start is None: start = clip.tl if stop is None: stop = clip.br clip.y0 = start.y clip.y1 = stop.y if clip.is_empty or clip.is_infinite: return [] # extract text of page, clip only, no images, expand ligatures blocks = page.get_text( "dict", flags=0, clip=clip, )["blocks"] lines = [] # will return this list of rectangles for b in blocks: bbox = Rect(b["bbox"]) if bbox.is_infinite or bbox.is_empty: continue for line in b["lines"]: bbox = Rect(line["bbox"]) if bbox.is_infinite or bbox.is_empty: continue lines.append(bbox) if lines == []: # did not select anything return lines lines.sort(key=lambda bbox: bbox.y1) # sort by vertical positions # cut off prefix from first line if start point is close to its top bboxf = lines.pop(0) if bboxf.y0 - start.y <= 0.1 * bboxf.height: # close enough? r = Rect(start.x, bboxf.y0, bboxf.br) # intersection rectangle if not (r.is_empty or r.is_infinite): lines.insert(0, r) # insert again if not empty else: lines.insert(0, bboxf) # insert again if lines == []: # the list might have been emptied return lines # cut off suffix from last line if stop point is close to its bottom bboxl = lines.pop() if stop.y - bboxl.y1 <= 0.1 * bboxl.height: # close enough? r = Rect(bboxl.tl, stop.x, bboxl.y1) # intersection rectangle if not (r.is_empty or r.is_infinite): lines.append(r) # append if not empty else: lines.append(bboxl) # append again return lines def annot_preprocess(page: "Page") -> int: """Prepare for annotation insertion on the page. Returns: Old page rotation value. Temporarily sets rotation to 0 when required. """ CheckParent(page) if not page.parent.is_pdf: raise ValueError("is no PDF") old_rotation = page.rotation if old_rotation != 0: page.set_rotation(0) return old_rotation def annot_postprocess(page: "Page", annot: "Annot") -> None: """Clean up after annotation inertion. Set ownership flag and store annotation in page annotation dictionary. """ annot.parent = weakref.proxy(page) page._annot_refs[id(annot)] = annot annot.thisown = True def sRGB_to_rgb(srgb: int) -> tuple: """Convert sRGB color code to an RGB color triple. There is **no error checking** for performance reasons! Args: srgb: (int) RRGGBB (red, green, blue), each color in range(255). Returns: Tuple (red, green, blue) each item in intervall 0 <= item <= 255. """ r = srgb >> 16 g = (srgb - (r << 16)) >> 8 b = srgb - (r << 16) - (g << 8) return (r, g, b) def sRGB_to_pdf(srgb: int) -> tuple: """Convert sRGB color code to a PDF color triple. There is **no error checking** for performance reasons! Args: srgb: (int) RRGGBB (red, green, blue), each color in range(255). Returns: Tuple (red, green, blue) each item in intervall 0 <= item <= 1. """ t = sRGB_to_rgb(srgb) return t[0] / 255.0, t[1] / 255.0, t[2] / 255.0 def make_table(rect: rect_like =(0, 0, 1, 1), cols: int =1, rows: int =1) -> list: """Return a list of (rows x cols) equal sized rectangles. Notes: A utility to fill a given area with table cells of equal size. Args: rect: rect_like to use as the table area rows: number of rows cols: number of columns Returns: A list with items, where each item is a list of PyMuPDF Rect objects of equal sizes. """ rect = Rect(rect) # ensure this is a Rect if rect.is_empty or rect.is_infinite: raise ValueError("rect must be finite and not empty") tl = rect.tl height = rect.height / rows # height of one table cell width = rect.width / cols # width of one table cell delta_h = (width, 0, width, 0) # diff to next right rect delta_v = (0, height, 0, height) # diff to next lower rect r = Rect(tl, tl.x + width, tl.y + height) # first rectangle # make the first row row = [r] for i in range(1, cols): r += delta_h # build next rect to the right row.append(r) # make result, starts with first row rects = [row] for i in range(1, rows): row = rects[i - 1] # take previously appended row nrow = [] # the new row to append for r in row: # for each previous cell add its downward copy nrow.append(r + delta_v) rects.append(nrow) # append new row to result return rects def repair_mono_font(page: "Page", font: "Font") -> None: """Repair character spacing for mono fonts. Notes: Some mono-spaced fonts are displayed with a too large character width, e.g. "a b c" instead of "abc". This utility adds an entry "/DW w" to the descendent font of font. The int w is taken to be the first width > 0 of the font's unicodes. This should enforce viewers to use 'w' as the character width. Args: page: fitz.Page object. font: fitz.Font object. """ def set_font_width(doc, xref, width): df = doc.xref_get_key(xref, "DescendantFonts") if df[0] != "array": return False df_xref = int(df[1][1:-1].replace("0 R","")) W = doc.xref_get_key(df_xref, "W") if W[1] != "null": doc.xref_set_key(df_xref, "W", "null") doc.xref_set_key(df_xref, "DW", str(width)) return True if not font.flags["mono"]: # font not flagged as monospaced return None doc = page.parent # the document fontlist = page.get_fonts() # list of fonts on page xrefs = [ # list of objects referring to font f[0] for f in fontlist if (f[3] == font.name and f[4].startswith("F") and f[5].startswith("Identity")) ] if xrefs == []: # our font does not occur return xrefs = set(xrefs) # drop any double counts maxadv = max([font.glyph_advance(cp) for cp in font.valid_codepoints()[:3]]) width = int(round((maxadv * 1000))) for xref in xrefs: if not set_font_width(doc, xref, width): print("Cannot set width for '%s' in xref %i" % (font.name, xref)) # Adobe Glyph List functions import base64, gzip _adobe_glyphs = {} _adobe_unicodes = {} def unicode_to_glyph_name(ch: int) -> str: if _adobe_glyphs == {}: for line in _get_glyph_text(): if line.startswith("#"): continue name, unc = line.split(";") uncl = unc.split() for unc in uncl: c = int(unc[:4], base=16) _adobe_glyphs[c] = name return _adobe_glyphs.get(ch, ".notdef") def glyph_name_to_unicode(name: str) -> int: if _adobe_unicodes == {}: for line in _get_glyph_text(): if line.startswith("#"): continue gname, unc = line.split(";") c = int(unc[:4], base=16) _adobe_unicodes[gname] = c return _adobe_unicodes.get(name, 65533) def adobe_glyph_names() -> tuple: if _adobe_unicodes == {}: for line in _get_glyph_text(): if line.startswith("#"): continue gname, unc = line.split(";") c = int("0x" + unc[:4], base=16) _adobe_unicodes[gname] = c return tuple(_adobe_unicodes.keys()) def adobe_glyph_unicodes() -> tuple: if _adobe_unicodes == {}: for line in _get_glyph_text(): if line.startswith("#"): continue gname, unc = line.split(";") c = int("0x" + unc[:4], base=16) _adobe_unicodes[gname] = c return tuple(_adobe_unicodes.values()) def _get_glyph_text() -> bytes: return gzip.decompress(base64.b64decode( b'H4sIABmRaF8C/7W9SZfjRpI1useviPP15utzqroJgBjYWhEkKGWVlKnOoapVO0YQEYSCJE' b'IcMhT569+9Ppibg8xevHdeSpmEXfPBfDZ3N3f/t7u//r//k/zb3WJ4eTv2T9vzXTaZZH/N' b'Junsbr4Z7ru7/7s9n1/+6z//8/X19T/WRP7jYdj/57//R/Jv8Pax2/Sn87G/v5z74XC3Pm' b'zuLqfurj/cnYbL8aEzyH1/WB/f7h6H4/70l7vX/ry9G47wzK/hcr7bD5v+sX9YM4i/3K2P' b'3d1Ld9z353O3uXs5Dl/7DT7O2/UZ/3Tw9zjsdsNrf3i6exgOm57eTsbbvjv/1w2xTnfDo5' b'fnYdjA3eV0vjt25zXkRJB36/vhKwN+kEw4DOf+ofsLuP3pboewGISO7bAxPkUU+EaUD7t1' b'v++O/3FTCESmcsILgQRuLhDs/w857lz6NsPDZd8dzmtfSP85HO8GcI53+/W5O/br3QkeJa' b'9NERmPKgE2Ue+73vgj97Ded5TH1pPDEFCT4/35RFFtAMORMezXb3dwiioCsYe77rABjjCO' b'jHs/nLs7mx3wuYFYX+HsEQyTfHg/DY/nVxa0rzmnl+6BVQfeegTyemSlOdjqczqJ0J9/ev' b'fp7tOH1ed/zj+2d/j+9eOHf7xbtsu75jcw27vFh19/+/jux58+3/304edl+/HT3fz9kq3i' b'w/vPH981Xz5/APR/5p/g9/+Qhb+/3bX/8+vH9tOnuw8f79798uvP7xAcwv84f//5XfvpL/' b'D97v3i5y/Ld+9//Msdgrh7/+Hz3c/vfnn3GQ4/f/iLifja492HFbz+0n5c/ARg3rz7+d3n' b'30ycq3ef3zO+FSKc3/06//j53eLLz/OPd79++fjrh0/tHRIHr8t3nxY/z9/90i7/AxIg1r' b'v2H+37z3effpr//PPN1CIF47Q2LUSdNz+3NjakdvnuY7v4/BcEGb4WyEPI+DMT++nXdvEO' b'n8iWFomaf/ztL8wZhPqp/e8vcAbm3XL+y/xHpPH/xlnDejXKHJTQ4svH9hdK/mF19+lL8+' b'nzu89fPrd3P374sDSZ/qn9+I93i/bTD/D+8wcWxOruy6f2L4jl89xEjkCQaZ9+4Hfz5dM7' b'k33v3n9uP3788uvndx/e/zu8/vThn8ggSDqH56XJ6Q/vTZKRVx8+/sZgmRemIP5y98+fWu' b'Ao8vc+z+bMjE/Iu8Vn7RBxIis/q7TevW9//Pndj+37RWuz/AND+ue7T+2/o+zefaKTdzbq' b'f84R7xeTdJYYJLOf7z4xq11N/osp2bt3q7v58h/vKLxzjtrw6Z2rOSbzFj+5rEd7+P84UL' b'xH8/6vO/lj2/6Pu7eX7d3P6C3Y2tb3u+7ua3dkA/yvu+w/JqyV6GeUt0/dy7nb36MjySZ/' b'MUMO3Hz5+LNycsdx54SB5wmN/XJvRh0z/vz1/PaCf4Zhd/rP9dPur/j7eDDtfIV+dX3+r7' b'vz63B36vb9w7AbDn/ddLseown7kr7bbU4YIhD6/03//e7JiM0O669/vbyg1/hPdKLd8WGN' b'PmnXoSs52h5200OGk/WW/fvdl0NvhpHTw3q3Pt59Xe8uCOARA8ydCcX433Z/rjfonfbrnf' b'hP5j9MJtM0mbf4XZT4XT9czt0Pk3S1ALFfPxyHA6g2A3WCz90Pq6qFO+dsskjdtzAB3B+7' b'rwwDeWi/reu0nbcOeMBostv1Dz9MpsuJwzbD+b5DcuGuKR32dFx/pcfGO9oOw7MZlAj64M' b'/9bmOAaTJ/WFuJF0t898eHXfdDNmV4JC77x133J8XONCDiTTWq5JkvNMMLNY9C1ZLNa82R' b'rIki9ULP50AZ/6pczOyn92DSE3IqRSZs7nc2+gmqKMi+O3an/sQkTQOpszcLsBTnsg2gSE' b'f/KskTQ4YaANrFPFn4b/ELIEo/Iu2jQkbg/QEtEJXe1Y6MtWP3sl3/MMlnqf08D4cBaclr' b'5KzEzHTuyXhZPyCXVhkcD0/DoXsmEwEfoWVQqsJ+Sg2eW9qniOGQFqHh3n+XCNMWCMLJ3b' b'c4BPB2vz5CYenXkKjI06Rhu8mSJlSxKmmQX+uHB6g1jC0ztEQ+TRqdISmC6A46TLiH/sfM' b'wBczE0mo4WrXHzoJpUyaKCvglLnpJC1XiEWSBN55eIHcDChLFpQ4TxZrHWkL2mUXwl6Yto' b'N6OLefEmyRLHy7mizwDT1yt1szryqhfCOa1AJJBtKVZFRtCd8WU3pATvFrbr5cHlo6Dome' b'tzoF0xmAbn3/vF2fgKgcbhbkKCCrCKBYETp0uZt+2siJ5pSGc92+kOVgbLVIOREE/rw+jc' b'JfNGSxGWBysYMmOzxrCU3qelSBOUV1VQCf456kXEGaqB4gykGJUKTJQupBnixZ9NNk+S+2' b'ihS/0kkCjOoD6ccjhCO3niVLKfYW367Y0xY90TIU6MwSVkRfVdMM6HFYsxzpPGobc0NLrV' b'4ky6htQIoOA9rLmWTeIupuh6aRZaij5vPp2LH15zO49PmEMH1niBrcCCWd60KgH00/Bmgp' b'kM8t9NzL/mm930scS/j7XYuHlr2MGiXkiwoDQvnESoFVyfKEarx1uSGFA7ehkULobywiRP' b'BNiqgAcbOCo9MFRwtGp1GVn6wSDuzTImllwJ65b2mcAPyAjZxvfcTpHN+2xC0bZboApKt6' b'joBDPZhbIgyyEeD7B7Sx9kZ1qTWqKgeUkvZ66MUI1N4eejGytzeG3kgUP/QumFyVWyD1+E' b'pSja9NICVYYqbrSkvzJV2Xo0WhQfIedV+EsGU0rd23hAogyuUKtNZ7kBjOxTEPBT9LS/Cv' b'BlfE32OqDgVzo+JFfWt3uqkhATv4OEhYCFtGXrRhR/jCY7Is4kuCVWavQ0QdiVoDqoiute' b'kS9K0eFjpDy3E8nc75EdVjKGbtgVmg+1KkWtQAVp/hpaPQM1SNl1O/YwryWeEJUS3gUkeb' b'wTnzDLP+DdtgG0jtClLrXh86SHu6mQoIb1r5HM1KWjmksEN7xQ9VsjVpEQ1ezvA7gUqMD+' b'97RcpruAv3Le0G8V2Oww/ZBDpq+40xQxPBh2/G6D1BqRSiKq7YJ5TJKjTdJlnpDjptk1U0' b'phVwrbvkabJy/S5Ut1UPnyELqgwIovM1Cm6jCoGgMDERdp6sJJ/K5EeKViU/Nqc/Lutj90' b'OeYwD8UVS6Kb7RNzMrc/sZhqsZmYenfh3EnCc/StfWJj9KniAe0WFSKFE/hpxYWEK0k5TA' b'wIh806Z72+hRd37UjZ50NJBBxu16o3UD+N1iHrjZ7LpRfab42+5KJ5gZH5eX8+WomxFq+Y' b'++BBALJnWqVgGIRywArlFjJgefUXkgf/142NpPKQ84le/KfdtYs1kD2gjLDJ0mP7Hg6uSn' b'tEb8P2TFYmW+p/xGo+B3kfK7SX7CQF4ZPE1++lUKGh3sT+tbAx3G5J/WN5WyDIzj5tQ/ae' b'cZYrMDKqraT6b8fWshK2gxGcINBb+0hBQ8uuifpPuHY4SlmwhqwU+qg6frKFcRttbIphPQ' b'R9WCwJesxfcF85bjZb9bX84siFWEiBYBh98kv1AF3jHTZ8k7PUvMVsm7v0F+TCjefdF4m7' b'wTJWDpvmXIAeBbSrZI3on2gcBCFrWWCAN8BEhYRFXlK5N3elStQapRdRVIP8hQ0huaNirZ' b'u6sBmN5NW8wn5kvaoqNFjZgn77qrpQeIFrXXInn3eFw/o62hZ8IU7Z2M0Qv3LREDiNQOJK' b'vXQZEej8mQoT9th+NZO0TxyYCL+ukInW4UZFS14AO1SrX3Jnk36ByH4DIyMjMHO/jMzJfq' b'MEsDhNLI0VCJyIAEUiopfEt7xzj2zk2XU9T0d9GQxPrzbdufT9GgMPWgrwuaWSZ/Y02eJ3' b'+L5nZp8rdQ+VaWkPaJucrfok6uTv42mog1yd+ijEP4kpx58ndG2SR/V0NNkfz976E/WiZ/' b'X99DZ3/uoxF+AtjV1Nx8q8JEqDd7qhkZYwUmB/byYoqG7OuuvwX63cnibJH8XQa0Gt8yoO' b'UlKJ9v0JT/Ho9fZKuWgX7i7/FYPwUQLU2skr9vdTKh0/19q9UBhOgHI0gSjz0QU8+WUGx/' b'jwoFJTAgF5SXemIhmYEhH066cZUEfEE2yc8syEXyM3s9aIU//4yuEtXlZ6815DN87+83Jq' b'fh3OdavsR3yDVyJNdSS8STlByRjPISnlz/szJfgWNp8VoGUoZiqH8/969RViOG35kMcOJs' b'RBqibJwnP0fZCI9+gol2Y79l3IBnya9F8gvza5n8oip+mfxihVqVUD7tt0yJVwRchW+TX0' b'ImZckvekjEGPeLSjJ0nV+iejSdJr9EMkMGEQvfVHGMioqq/cuFhbVI3lPWNnlvynaevPdl' b'Os2T974coS++D+WIye77IGJuibgc0dG8j8uRnqKkTA0tHsrkPSv4rnuk69kyeY+yEBW2Tt' b'6bQmvwGxUa4tGFBv3ofZQBSNjwqnMI8UiOgOmXJJep+5Y5AQCTQ8vkA3NolXzARD8tMvxK' b'qc+TD37AX+buWwIAACXpGM1y0I048Nbwi+C8ioAS+eBzH7J9YK7Bw8aPCTPIE8pgaglRG5' b'YR4KsW6t2HmysAy1oz/LxzmWlUD8Vx8JLgCPXzKWgAH3T/jXRhfPKVrJgYUlSXBcigutDv' b'rXxSsEROTCkjCMiMz1JUDQCnajBhkaqxAhD1zwXoPeodVNIPkQ7Skj6yUDBImU/J3LmllR' b'BtZiHJ0IWlo6x0IfrsahmsVlVtHvWMEcFdKTzwLroNeugP8WICa2u8mMDA9t3T2iWOn7rb' b'd1w/LmCKbejjcDnoalzNLX7uzzutF1ULh3v1BrV031vx8pkQwqZz3VrhQjV6CCNKFtuGJc' b'J+CXy7FQn0rh9c3zxhZTbfMqVtHSDFTRe+D0CUduDXzrX6WJH2vUThvn0GM8sNoOYxU+9B' b'4iuSX+EZWf+rFMw0+TU0X/B111iUya+R0rwCHaldcwA3p7hzeLXr2/ywCsMccRkI8fevR1' b'3P8+RXnf9Qtn49Gac1P3QmkOOSg+//ZnLS5L9DEsrkv6OQwBT3afKR7rPkY6R7LkD7bmCa' b'fPS9XVHjW8Ya5MXHEEsFIhpVyFb9RzoBqXOyNrRvkMU8kKIiFJAj1s4QiJqjgL0dmCdIRt' b'jbKlcLknFrTJFEPRoVbfIxyhXwJVf8tw8E/ut0hJ0uLx2tXMBryuQTczFPPq24YzeZYHqP' b'/hJU5qh0Sir31ITU1FM1qcJRufFXOiozVOV5JpTa+zO8mXdJnoncxM4YUpElI+VdlimozL' b'ssycu8SxQaKC81OltQXuqS6cu81IUJxUtdVKS81MWSlJe6oJyZl7poQOXisiUlLlekxOWc' b'lJe6YPqmIvWMlJe6pNRTL3XJtE+91IWhvNQlZZl6qUtKPfWylCyHqZelNPF5WUrmxFRkYe' b'yFl6Wgv0JykPlZSA4yzwrJQaa9EFmQPmll/ls3EYqw3r/0vsvHAPTJN8XSf0ceSgdKS0BB' b'qAaLzH7YvvITvb/51OsBtYVubaNDutDSa0vIXJTlGzX9jDU6kmtiaN/2WOU8GTmDt7gzhf' b'jR+jzSF2+AVgT05AxBbB9iCIUVzdcQ+zZy0SB5236vlk6Rov7JrLTOUYD9nyIAqkHUa4A7' b'PJ7Ha3DwLn0JXJwZlszn5slndhbT5POaSiyGgM92wQ6p+yzFCzQUHDLsc8j/mSVirR49/+' b'e4/6WnKHfnhpZCWCSfow1iOL+5+Tunw1AEiL07n6KNW8i6dbv3NT7d0LbgJ/WxCRQp8ymD' b'Lmlkh4SJqNWgXJIfzwyh4n/WvTemB5+jcoAIesERk97PUEgee6OwNwtDnXrW1npqiPPrQC' b'Gr5POxg47h1WhiCDtKH5Sxz6d4Z7EB4gsY4b12O7XkD+brIFSafGFxF8kXmY7M3bfkBwA/' b'uUCxfJHJRY5vKfa5JcJEotGA1INSoxID3aoUIWCl6aPufNEj9RSk0vQXgfQ+llXAJOYsYJ' b'KCmcKU2cAkwC7WlMm5NtUpAihpoTxKk4e0MnuYuW9xC0Cr9JiefPGThJX99Gofpn9fRpME' b'iqknCVB0v4wnCegqvkSThBZ0PElg9mpIZwTy7EpTgYxab6wgmGQIGvGX6zXS1oNK1a3oUj' b'cRZKWo7Cwr2SacF55I2T8Jy+QM03p6298PO+nAcnEgi6lN6jG9ntqMwRuBTb2bwIuEkPkI' b'0mhNnVI0/i/jheQJMd8ikR7MG9bcJdb9WBvga+MTlJGfv2MY+hLNJCoPSFWfJv9goy6Tf4' b'T22ST/UHUHU5N/RBOFDHS02gEHrsdpwIuKCuFG2yd18g9JHHi+rmFK90+KUSX/9KLWWfLP' b'INLCEjJSQ+5/qipSk1QjBKZq/1RJqOvkn77q15Pkn5GIiFNEqpL/oRh18j8h6mXyPzqmBU' b'gd0zz5n2ikz+Ges5tZm/xPFA8ClXjq5DfGM0t+k6506b6lwRPQpY6x5bcgVWuJkCFl8luo' b'sSljuOpuVsC06K2hpY+YJr9hHqA714bI5Va3h+B9hqLl/+aLP7efvktZQSi9wzEtQOu6Xo' b'GOhkfonL9FuYYsklzDt68wFOByuu+fdAbNHXbLYGJB3q4/n3e6LkNREfiWrzr5F8tpnvwr' b'Mq8qQfsRZ5aIGVa1dN8y/K8ASJE5whVZ2s4myb/sonPVmC9ReBztS2aWJf+KWmAF+ub2RE' b'3GDa23BW7VGoi+7XRa5gTGO2qLlKiO0vi7Gafl3Ih0kfxLazqzafKvqGgRsxQtv/2uVFMk' b'tEmEvrFe33cYbXZoTzM06bVvLC1Zm+4rnM0mxJ8uv6+P6zPczWtLH/eXZ65RzA1/v0Z3qc' b'C8BXi8yML5JAf9dYD2QwU4RNq0Gncx5hGooqbre2Zlb87D7NfHZ121VxFXBYhhVScUyb8f' b'Xob98Dj8kNN+ay2G2Ln7FkvnlQN0vqcO03ZLlcPEENs7igySfPBipgJRZAsZiZO6vJxYQl' b'Q4TEXWNwyxC41qq+SlZoghdqXRyBB5pjlict0kvkZAczefJoKH/T2qelpZyFKT1FFDRLoS' b'KJx3LtkMXCRBYzUABm0XwJQ+Qi7nyAG9pgzuZrN+VnWsIuTqKPJB6aFQ9G7OTfMAB70Rgu' b'iMSw0ZlidBmxaBWh4WF5G73fNw7FDvcq7srrvgAZE89v2EO/g/QOzCkvVsmtL4aGrIdII+' b'yFqqe7K2xs6enFlFwJHZxFrJeDK11p+ezOyevCdzu7ftyantXjxZ2A7Ok6XdhPdkZbfaPV' b'nbzVpPzqwpnCPzibVj82RqzdY8mdmNAk/mdg3Uk1NrU+bJwhqLebK000xPVnYm4snaWgZ6' b'cma3Wh05ndiJmCdTa9LsycxO/T2Z22m/J6fWLsaThR2kPVnaGbsnK2vw5snaGo94cmZtTB' b'xZTKwxkidTayDrycxaH3kyt1aWnpxao1VPFtZaxJOlHeg9Wdk9fk/WdlPUkzO73ebIcmKn' b'qJ5M7Ua0JzOrLnsyp8WNSFVOSYpUZeEarSMpVS4FWlKqXNJbUqpc0ltSqlxCrihVLiFXlK' b'qQoCpKlUvyK+ZVLsmvmFe5JL8yUknyKyOVJL8yUknyKyOVJL8yUkn51kYqyY2aUuVSvjWl' b'mkrya0o1FZlrSjWV5NeUairJrynVVJJfU6qpJL+mVFNJb02pppLeGaWaSnpnlGoq6Z0ZqS' b'S9MyOVpHdmpJL0zoxUkt6ZkUrSOzNSSXpnlGomCZxRqsInEADJXEhTglMhKVVRCEmpilJI' b'SlVUQlKqohaSUhUzISlVMReSUhWNkEYqn8A0NVL5FKWmdU9WQpZ2DuDJyppoerK2xjmORM' b'ai8ovMJmMLCcpkbCnJNxlbBZIRVT75NbpNBFUJaUL26a2NVEub3gy5nE1cg8y5MDxx4mO4' b'JWHLrqhyVs6ynAsJ4UvXrkGyVpTlRMicZCrklGQmZEEyF7IkORWyIlkIyYjKUsgZycqRU9' b'aKsqyFNELOhKQYbnAhyZDdeEGSQWVeyCmLsswyIRlUlgvJBGZTIRlyVgjJBGalkExgJkKm' b'TGAmQnKYLjMRksN0mc2FNFKJzJmRaiGkkWoppJGqFdJIJQnkMF3mEyEpVS7p5TBd5pJeDt' b'NlLunlMF3mkl4O02Uu6eUwXeaSXg7TZS7p5TBd5pJeDtNlLunNjVSSXo6t5VSE5NhaTkVI' b'jq3lVITk2FpORUiOreVUhGTrK6ciJOt5ORUh2dzKqUjFwbScilSFEUOkKowYUgqFEUNKoT' b'BiSCkURgwphcKIIaXAwbQsJIEcTMtCEsjBtCwkgZURw+dkwZ6qnE+FZFBVKySDqkshGdSs' b'FpIJnHsxClOfq5mQTFEtjk19nqVCMkXNXEgGtfRCFqYElz6fUQ+ohXrHJUuhaLyQJRNYLH' b'yRoZ2DXE6EpONlKmRJMhOyIhn8MqjlVMgZSRGDWVcsSyFTkpWQGclayJzkTEgjlSShMlI1' b'QhqpFkIaqZZCGqkkvZWRymd7ySG+aCW97EWLVtLLIb5oJb0c4otW0sshvmglvRzii1bSyy' b'G+aCW9HOKLVtLL/rloJb0c4otW0jszUkl60T+vmiyQBUmf/Ap97KqZBpJc6UUrdm7FaiIk' b'xVilQlKMlU9ghQ5q1Ug3UnGYKJqpkExvE7imIpVCMqJGxOAwUTS1kIyoqYRkehsvVc1hom' b'gyIVkKTSokS6HJhaRUi+CYUi2CYyPGTEgjhq8bdW7i9XWjnpqIVkIyooWXasZONXN+yzRD' b'B5WlTicHiSLLUjdBK9McXVCWujlXmRY04p9kCyGnJJdCFiRbR7LRYSh3jvO0NCOsczydcS' b'qUUWa/kcHqqldniiRanAG57Y/rp/Vh/UPOk7jraNoPifuwMsL5Sa+XRiBU76bYnKrGR5UR' b'dK9iNp5V1MbDeF2IXTpvUlnfMwwz0PSHRyA7h61ogQ4M/517jTZE990mAhcER7ZUTNKNlS' b'aqVP14pWkagSoxdP28PuOvybd5Fsjtevf42m/O2x9WKy5ByDoAR5Fd9+i6THxJMqldgN6s' b'n7rT1iwGvrJpWVdx6uvWgNv1/tvalFIIJB9xRh6ngW0WM4LHYsQZeawt24olwu/WyGyR1a' b'VtzzWYkVjZiDMK3bOfT5fjWnxxLA9w7GU10bxxRVjlmjuqECubCS8oqpDPmc3SP7hIeQqo' b'SdHLFg2Vfdxu1/1xWe9+yDJqDu64PXsdfdx+DlY4bg+mXm6lHrR/6Y6n9WHzAxdWAqmdTR' b'TuV2eN22BPjyw7qFbIHD48aWBK4Hm7PjxvL+ftGhWWRlHAuHaYcVWFn/fH9cNzdza2uJgt' b'1FeoN5lHxnEiq7jmCiN6ml3DytfUxWSiyPLMuba+QRuZuOxsrDDRgg/DGY575m2NNnG4bN' b'bns1/Eo2J1uJy+sjTDYm0A/VpfQHS/BzRcdoACfVmj2ML684TIsTv8kPFAwPploFgv0Uo9' b's1Bwu0rJ/v7lBbm6qlcrfh6H9cO2OyGXqSSS/lPqTa2B4Yi+74nFwWQZnJ1ht3sT9xDyuO' b'7UQiLbPpEAoJ8/PiAnuRJocpWdj9nbTNvZnJi50YF6RnSjQ2NpOXmNqnk8Dq/3w5n1fTa1' b'5GZ92m6GV9oeUI/xkC1NXmQhkCtRXm8i2OWFgAt5c79zgS+ngriwl7kgLujlRBAf8jITyA' b'S89AHbMGZ5IF0gs1mAfChUqD32uu2RGRDRuUNZb4i79ecioAzQoVlATZgOzgN8eXGYS+cW' b'Jf2t+xM1hPocES/fJJBIlUq2Q9x+TMYrWARHB3r0qeH6gsclNQ6TFGeKjgJdKQYE//r2Q1' b'bNWgUyKierT4zBJSqXmWfeCmSrxFQQqREuH02hzVJPbEyhFYG8PzHIeS0ISuJ+PQJ9zpUa' b'GB5dHVhIcJL4yiMis0OMTmAKBWGdHvrebm5wr7HVQLRf5jjeTLjStHZogzj2LzRg4+zQEv' b'5Yhmnx9gio0rxSh2mtYoxp1YLLJife8HZ65mgyF2q9456JjKRUDT3nBoY+B60yS0No0WAU' b'gnVjUcuFIAuh0zYKo5ivrkq2pdPb/uU8mCFAdWZoIWcesEAV9/nHPuUcGYaTKfGgjwo5Bs' b'5F6aFTkmrAI9vroeRptdPSQe0kvUNQ5y33B0OgnF5ervRRdPCXW9pihHttMQK1tgjGV2rk' b'Wz9Icdk4ugqH2frWH9wM8o0KD4sxqCMTg4oWBlf33KPFjxoNoYDcYyT2RvKFIqOaTNxJkv' b'FbyTq3tOSA4auKWk1In51aAb3gXivCS3KPbBz0doxaBRBVZhiD78N2ZprcRxeb5IaW8Qlu' b'O+pyp/7PcwcnWyoKGGXLEoF2D+sLO4ospzO9RYhQaRriNdGaZKxLohMGNtYhZ8ajSvOM9E' b'iXRM9qwG4/8r6YrYRzGnYY1DfCmhgZDsMQT2oWaJH3nc5HxqjtMljQ3dmur9xbU4LGQOuR' b'FRQTdLYzCc4h0kCGiYUBg0JvSGjZobahJt9vdb1akvY1xhC6yjgg1BkC9nh7gZLsdVaS1g' b'klvUMurHcPKDVzIh551B82eq4Ine6+V+YCTMEONdtXIJ6SNwBKCHVuQ6R0CAaHl6E/nKHv' b'QEF1SjBn+YbNEcSzzW93pOfpNVd5xqzfscF5uKAYY106/d/4WqtuvuPO69dp+r850CH55P' b'CWO8aipEU/G3jGo2ZmlnnsHs4em7vAjNvrzGnmN9g6a13Om57cFZm5u8Ch/Q7uH9kpZKXP' b'geDMZd3pjG4kK9nySZrb98bpmireVbqCRyehEUeLOR270EyTLYdn9E0Zs09fU1SBHlBTsw' b'JT4/toigdfwz1XNXrXP6ZI9aCrP7J20NUftMw70Gr+CLM8RIuy7oyWgnmrIey5yUnVBPL+' b'TH4egH2/IZIpRPfCyqsfajV2fqHnNAC6klUWtrUTYiwVbeVoFeIE0Y4iSTRDRFko0MqiES' b'1MnehGh8Gu0YAVZ6Ihq++tNBQNipF/E3fbJlGDRCTLCLGxNBFmC2weYVE8cRA2keju3frU' b'sk7CVRvW8iVrLeQMaUpLycKWcriKWc4OJ43RzXCBwm55JXn95imKbu6wGzHk5GECcbCj/B' b'yyiNlYjdzWuiCchiu5UEEvuh3A40W3A9KY/p251Jm5bxM/R3au9VtoQPCYtx+pss4Mdure' b'TJfcJg/Uh/LkQVsKloDVOIY58YPc01fh2yuNxLXSaOmgNJLehWPeNcjDhoP3YaP00jrVuM' b'v9icb8GkXkUC9TkPFysv0Lj0M+IMbh0a4lO0uwbFHZT11mCwu5KmIo9GZP3bGjEg3/Dfzr' b'pVskQe6kW+JbriLEFOlhfBXhDJDoapklwr2D5F6OO472iMRdQdiYr3AFIenQucGdRNjUnn' b'BpgQDGE5dV+dU/cXGHeZBb+vDoK9lyZRDdvtqJgYbd5nR+49JM5YLRdRNuotM/0PAetMIz' b'a0j72mEIXT0cEOoHAZ27U9C3b1NckvPwzLkHJtxpbsjAn1YE/vfLFVeRE82xnm+YCxdkaC' b'vpykR8+3LFBVnfv1yRWUUDa1bDbd9deEbKVA6/LpVVgWMGN2Gkwhj5KGeeEZbL5x6Kw2B1' b'2w4ImlM4M8hO5h7xQG2BPjhxnobOA0yku/EQrhnPVSpKh4/S4OBxClwoQX4HjKR36GUUKM' b'QRXbZx3/vL7ty/7N7Q2c0qh6FxgZo56mV34VrjrPD0AL1pZ+pWjs7dobxTnWMalw+MysMe' b'daKYsnQo3DTRTTxblMnofJBrqkuFu74HjW3XUXkzDZk6/Xr3tcM8iOPAIrPQhnfW7whMLM' b'Bp0tEiqUXkMBUx1Nbd5Z4TPvt1uvRnJ6yG3DIPbUoe9g/omUOXM0eTjHQ1+HJr6soRpNHH' b'JdgdD+ZoywQjn/nc88TX+vjGbfJUIAk2dc64AqCciH5TWNqqmlTome12xXCZjnkOp1Dmsj' b'buEdqTedxIceNLriBTkA4vEn2Ib1UuvEM/H574wNQS99JCqodtUwtFy0LOp78NT4szjVlu' b'ndyFK9ngkqS75MxCds1HhxgxXHgNsRd0XZxDUJrD0/HCdJp1c75NMFyOnLA8Hc36E1Qo82' b'DBAILG5o6YL3h5ETQqRzct78ChZuBoHsZmk7XkYs5rVNJA88Q7R09LLhcp2WmgM9JZoHPS' b'eaCnpKdCm9irldA/89JRKhCWbnnhDNQeT77nAf1JIfQHngadSHDtJ15VzKHJ0Z952XJaBZ' b'pnbUJmrHidoSlaSzLtqZA/GlLS+pOJS2T52fide/L9nPmaimgfjWcpg0+8b20i6fzEq1cm' b'gWvTIdn2ycop2frpi0mHRPbpN1MqUohfTGQS+j9MaMwF9/QGFYtZIE/rw4m6voZQKR+pXR' b'BDrRtN700ejeBoaTa75utdsTRmy2ba8gYehZvfcKADNvG+DEd7vsF3aqZCBdWL5Q9Pz08B' b'QtbJJBTFcLx863p7FyZChALQnalWcGkGnqHpvXELM6ONvqGMOk4F/HJEIA9vzGDUwrejuV' b'Ob+ZiSWrEvX9H0CMS9ZxmHj45VJNwaLafJJlLiSavFqBLkJtgIGNItTZnveImvaYmNl/ig' b'RAEd2wtMErdyZsxAomUzjzxxDWSSTdy32bmZZClJtSJWGjosiJFW05+S3tX0x0S8CyuVFG' b'5nl/ty+xlW9CIgrOk5eItA7f628XxnLGVGnLDyd8U/dU88Nek46Zgz8un5AXVAf+z/EFdT' b'BY4C8CxoB3sBZwocuXesOH2VAkfuHctu7Qtaa3Tkw/Mu9xflo9HoyIfjxTlXKnDk3rO2ps' b'o6cKLAkXvHYqfUCVgocOTesOImMJ8D00P/dGUBbQbisfP6MNpCmi4CJ8IOvApuZprn8SnI' b'Pa8sYPrFCMRM4+XQcZdFjvKYQX5aQ+r7nb8/lfWIy2/XRgrzWwy9KrQcO5DetbnJ0X5b4+' b'LIecP10or1rvZv0XN5RG1Sc1vb54tJ05NPUymUU5RXBLSOsiCAGLnayKNBlaLd8ovJGLMx' b'GzATzsux33ujBJNJPmFcf8k4OiqMnpWGNWHC1c4MWtl9GBzQImShAFGpy+vR/MOqQG6J0W' b'3kRP3l9XAedeOG9h23IXQP6oDQhRog9JGYtW3GFb2pIfpmIxP3Ajm6ifYxskSxM0vpWD0S' b'oiWid6YaQ8tiMOqbfQrm1L2szdJU2GVtrni06zFjmmOqvSrUpo6bOFwQQZPvtn1oOktDh9' b'EDFUPfQoJS0XtHC7LROYjZTeNosbspCdg9pKn9lCsDa8Z1GPbIVsiLn8sJXcHhsrfrbiEr' b'V8j/jvdkZxjr40yuEpXHhtBZ7ICQwwTcZhE+MR6/nblD5E/rFyPMnQacJrLXwxMFjogmgS' b'i6cOZvXifx1RNoklUS3TzhWvpUUNc8gk9pzAGK5NSFxNh1qZA+nwc3OYfaven5JhtEW1Xu' b'm3P5zDL4wpLdxs0y6NGb6D7EAmE9n7ZmUayYwUO0P4HqEJYqobFtwj30aEPRHBhJPchmBg' b'guomzWfokE3cKAmuW3MsjXCURb01sZC9I7M82fMA/Nt55I5g6LZpLeoVquE89iCuBD1tNF' b'Ojo8UUdF9R7U3iBrd1h4zJazQLryrBLfgl2J5wEYFKISt2IkGGxOvDgtzVNP/c4rUluh7G' b'KZq80mQ8/OwGJRkOCavCzzoHMyK/Fvw8YqNMYSO8ZEvzOc1wMS8qyP2LaCurUCRCOqPLzo' b'HEMSzuveLNMii8LSPOTQS/MctvTSPCU3r2kgT75ZzYCNnpQcTS5J2CXgOZ3ffmcjJUdXYz' b'qNVj+LVcIGARE6OWo+w/eReciTJJ1abIdbveS6SDq5ox7+7fq6X29fekCvtQt4ZchRXHG0' b'NYfhuhbV4Hv0uAeD1UutTM3D9i2+Z6GuAMrgObVEOM0914C8+LHSqIyxM43q2zErzZAXP1' b'KNRtde5pojb3tQelVCEFUfuwbX5zGk02eskTPuSY8q6aInPSwtR+Mhf6f3+hFOd2WHAz/6' b'3Q/0XJ1YuNf4VsUK/1H2w2u0No/y0YZX8B2dwYfckY07gnOrBnltP8MI74BQKdvWIlK0jD' b'0AbkeLSw52jSGrZql14HKxdAF0mEj7MKpUMN+2MdoIxAa+YXufWUzlhRdH5aSPYIs+4yoh' b'XFT/th0uyJfMQzS1sdY3HFMbi2KwGpD/L9verRzkWeZSKl1+NqldGNECqcNUh+/z1Seucp' b'FIyuqVAE59Wjkv/m6sykUu/V02qZwTbwBNcnwWgL5u3DqCzNVmeHUgI+N+1MHn4YBc1JcO' b'GNCf/AehX4nJkbBdt7frlFArOvNkTKgrc4dIRrQekDLOHCIJp59d/8JGl9Go3FMyscky1o' b'KgA+SekLdoKo/IWzTIAP0WTY6+db8xygiXK+23njmhgkZ6Bf2/cAA4je/gaMg5v506kwVw' b'F1myQzY9YmA21x18vLn71vFmxG5dNEfH5g2chh86CkY5ehSH0PhOeRTOwSbHPGHZhRdy0M' b'qGUMKIyN5OmzFp/HzYDSe7WDa3QHgzBoN+DInboo0ZXiFGBvjKMJ/g21+0hVl+F99qhUmC' b'NbZEP+U+o2bnMNGpSkerBrMg1H/FvP3AdGclivWo8w5+dC5PIZFOXB1I7Qox671IjuK3n/' b'xBBnLpLatzfjh9oi5JDEffQUIrtfTVoG0cegF2w/DCq9nmBKkbnpWk7D2vDHArh+mWP8ai' b'1VgGfTZG+xseX6BcSttCZtoZVsUPNRzVpKXU4Ms8VbRCXsqtL0v3LUM8cuaM2M/rxwH9jE' b'wMOXYoPFpvCbwb0LVLP/9bIu6LVG/WAHkVqbtlB1sp2BeExrTeBPzPB7PSxwVT+637hoXD' b'7JpqLiTNuyfcSgu03KnvwWhS4UE5P0MAUzXaDpgeEbMvO3dlf6reeFoZyla8mXGjH3yaEb' b'AqdNrMk0dqqmXyKKsNLb7VUGBoBHDYdj1XhyYz0OetWoVrLRCtwjksWmtrkke9PlMnj0F1' b'LJLH6MWpVfKobF7R2B4jbQjN6XFsBLvMiI1XyJc50dEKOTTVR730gNgxdlASHvt+fMRMZc' b'Lfnh8I4HHHD3gyAITpHyPVBtqIg0SzyQSRQQ8y0xq080MBnex2GMeHP63JoCVpw2jNF036' b'nteP9iCwp8Ia+hgLy+iBE5ZVAxYWkud2sThmKC8xWxZ753ZFN8JHvhx33+3tyWRPBWcOO1' b'wO9nSyp4ILh7109giyI4LxuIP4ikxvzyEHOrgiejydzRVMqB7diToTpvmPPeS2Vlck4kfL' b'GLRRy/PCfAUd09JKV24MEOrCVNE3NOW6NXyvKFvfVkeF7pMWSwNo7bdxSFB+LRLrvoXDgu' b'prkVs6rhVRq7jWbTTUWkgruBYRta62pKi3C0977da6Fx3PxqqHauvAq7agTDtDu+DBMvMm' b'Eb4jlQxtKBwhxFThcXgUexl2GsOjX/eBqvAIXXAv7CnZR3alvM474XPYLN+p+Qr5aGlVvn' b'MDhPLNFX2rfJeG78vX+tbF6ZFQnBaJi3PqsFCcFrlVnFYiXZzWbVScFrq1BFoZji5o61YK' b'2joIBd142he0dS8FbeXRBW0dxH3mUjDpNNMASa9ZWMzVERfQdtSaIZEomAjkuH7g3jFP9k' b'xJHR449ucJTxFiKvukTeRI+gOFBb69tRzxcLZ5viIZL9NjaH3iod5owGlmU6LxgNPMGLI2' b'vasMHSzvSGs1bgFaq3Ck7UuHTW4/dwjJKRCYMDlQ3cHfTgDF7x82iZ5DTJYg/VITkifqA2' b'RRzyEi5DBMl5YIzyEijNFziHDvnkNMzVfggI72CuBSL2EUGWiV5ob0sOcOV3QIq2A4x45v' b'ZjDkoAAuHC7IKnfI/vLHRu3CzpbEUVl5kpCXpq5II8A33nkeB9oGVggXRQzt162BY0r3FB' b'ld1qT1M49VZhBXsQxb1wUHhMpgAH1/wNwCoxsEWote3SGwsvhY50F9+N5bkwVZ10+KMWE3' b'3ppE/m/D5tTcUFphJGInfiXjVE8UIkC9uQAt8UlvLsxJa12a1brfdzt7A4v5DNpPBATVx8' b'FBiwAQbzsg0N1wxvRBXq6QK0NbzzqdOfHK2JgDoF6/gDKnGO6s7ERjaqLG/L1mOE/pLZ5u' b'x5EIXtRsnl7DKso5Uh3e+ITbaBRFC9d7IOhVn/QeSANautOM38G0EI3syOsl7eJPlfjlSx' b'Y1P/WyfpnojWLnwN+c6UhfjXJLhpszWwtEcjs/6jZNIh2NLjmUt57wXQWUIo0MR25vAF82' b'Ho+GSPE/HGUJgcms8sBwIVSVQF9VfILKAgUkkEO0mIc+hUdSwdEbFgWScuEEYD/4syDzJk' b'De5qux2Kk/PLlz5pN8FiC3OUo7zye9/dEw9ON6HzaY2Mu8hf3xWcL5O6b129uPrs7IiA0q' b'UHV1v9fQyU177jwJJ0bpSN91a+lwoy5pddhxSXJkBpIRG/d689ygYf9nRXrUB86nAPuz2m' b'WbJ9vIgmmlaL1MUtPhDrqkXs2ncLymRKRNLRBbqWTpnTFLCSw9K7bcheXGE2vLahXr2mNj' b'udFFKKlgz+vTcRQeqlnEvQ7Spep0eb6MWAVznja9ZqJ65MoKM/Tqyd0pM+v4MgzmEoP79f' b'HenJtvFh62p448vqBIoSbSs7L+ajJFm5udIiTLr5DHMRJs3zR6cJcd3OJRGLTi20zUie6K' b'I3NqU9sFSO+voKy+gvLpFRQiiOCx0BHzSuqIG4vtWN7eq0kVbS7MipBsOkbyyRgJYWt0LL' b'DmXcmrmbG44LhHnKtEb4NN0K7iN53RItSbzuhOgvZaWSK86VwkW/2mM/jRm865oSVkuO7s' b'bW+8UOXMfaTCfkZ2/AoTGw6I3wXNZSpUUFuIbW90sHoVrCIpeo3xYbtG7W3VzCvNOb8O0v' b'9h7rkdL5tZ7Dv3LTXzIuaOj4I3cyOG741HgtSaJxE2Bg2H6Iwr11OPApgplvhHNwI5OhRc' b'6DUqBqpP4tWKjjryJRmXc3Rve14CPIjWyvw7XtQwwVHJ2rGSpSxFQXpPpf3Ur6Ch+Prucn' b'2uqHH46PCMg8cncpYWDidyWguMTuTQmc5V9EvRCXVNRxnCaK2hK/Q+85lOFZGlmtgoIrRO' b'B4zbuoOvmrnD4xYOMLrmH/kZ6X4oUH2mpcKgAR32xS0MsNlHJ5RJ6+RrOko+ctPZ7VIX4W' b'c6U0RWKiLPFBFEd8A4+Q6+Sr7D4+QTPAzP24s3VMoomNvQ9zrzzEAPmnjhQgAUsG+xnWdq' b'mHL4SLMysoJd/ZS0fop+ZuhvA482ObPLgpA7lclqOpxPL7x5ydxdwYIxN1fw0NRW5g3oPH' b'VbQHHJPSjsIqNjtKT7Xl1klcN3dLC2UHRUfOgMoseFsuUyQlxmQeivXE9EOG8vW+508mpC' b'+62tuzw/2ojxDkWpzz2gdspKh/EdrYzHXXrq07OkFxOgJb+VlrRK1KWEdZVoe42MpFucga' b'C9vB+FcMOAVid9bHDTJvpdlKJMem3lAmH86qExRnIB5Vm9CpzH/tgFRpOoBUea3GJW0PmF' b'x3yluWQLZx5xkCsqUIwpmsnNY5oSlhFqjorlPC8zRs2sZ7WC6hlxuO1/vuzMoRERo4rdHL' b'm3EuTINdfkiCypRikzzxmjwp9CypcR/8+Hbse5ogQ9i/iP3GHFbNL7xqxVczHgHh54c4j4' b'Lm/yJfIR+yhiZVFxbddfg8BZxIH+HbIhysieBxj9syMsgKiwduiOjkHO+oon8cUsFFmILy' b'oU9kvCiRLGYf+B9uHCnsXsc8gSdJaaNYQqkEU18bDehyyJ0u0WnHOaSWiYx+9CgqNoMPI+' b'SI2Z5jHrBVolaoRENovZJ24hBFHicJXpFVId5eSpe+A5JhFoFjN3jyJPlIzT8NB35zeJLx' b'LW9nN8kjNGu6jSRfXgdB4enoWVxqzLJkQUVcjTJbTMOC72o191+1po9itXVKRAY9YwbIQT' b'Nbpv3XFgolRtM1Um9G0q01ljAkNVGVaYkNuqxiAtAVeJMbKGoJSwFDUwjKzWFIQSKovDVS' b'C9bVOmMG2KyjJRlpLI7KsnmKCiRvfZshw7jo9jpdTjI6XUwWOltLJwUEodMFJKgYp9I7JC' b'2zeSpcwlQeqVYeR0ZNSJeq4HS7QJPdCxt5Hs5LeOyNIhJtJXhpkowSuzOmRnP35Wj+345r' b'27E417E5II1DYkYPxOC2y0Q73+PU1uqujQ5ftgzAI/5ua5bIkc3V3ewgEL0GIgx6Hg+l3E' b'PDH3dQ7Hm3d1FoY9euIKVS/Sw5EBB/RB3vwPXfbB7IHxfH+KJnXQL7WVkEIdDQrU/cBDBD' b'zFkQbsHNP2CppCaC7Jw8EkAIo+ome0e35ZRhHPfbgVlUF89Rez8BYWkGLAvqTrr7zPqQu3' b'OfX6ofgCIonhHJviYE2iZuZLve+4mEeIt45i9wDYbNhR+7X+xHYKAYrSjApw1JWVJX9l4p' b'U7TNecMRaZeCHBp9N2rfd8IalsJRi+0mTRNXklQEU7U7A+UkDYvRPJjI8svtgjRzccwsFF' b'q8CoL7eeS1slV20p15heQAb+bdufT5H5RuFBOaymmFXyO1XzefJ7dHdKClrt4i1A+i07fu' b'sdO0uHDTvQ2tZ6kvzu9fUVv0Vfn1lCFqDQGf+OJno6df5MA3L5d3cMQ8qnWCXxBlYNutuH' b'tdmFoUdXArYGvLoTcGXg8bo4pFQLTTNGsB2dSWuS36NdziVpn0GG0DnkgJBFBOKrWxAgWk' b'3Oo/6/Rz0MCkYaBDJIzyKzhNeEolfByLA+bZ/7yPIyJRwkLEC6ATQnS3fjc9A3nyFsDMOm' b'igE82mcXnpUtABpgZIbVJDcssAw4MlBjpMogyzi5slcz6HjvdkEwvttwCUjneGHokOGkda' b'/BcMfmwVNguhdpFB0NQCUYLy+m15vbz/i+RlRzoG/dcDnsoQfsZbSqUmG8cNXqJaxj1dPA' b'Iif4qYVxOq2hU8TcGbjH4dirDp55cdr2mzUm/EMop4mGUcF69kz2CunYzag3XTHvwjVZlF' b'PvoxST5GrrxBTH9Q76KmGwLAYMtztjjnR8jnKWYX33kiI0o2e92N0mz9EFXjPSzmqD32K1' b'gYnvc+h2UGSxkQbZSnGEGvIcm1dOCai9SZRiZJqh6Sg5kCK+8BM5cGWQvEJ1Ys057NaHDR' b'OaQoF7jnqXkrQeKQoCvmEarq78Dgi13wBqH7E19Ggj0Tq62kmsDDzuIimhthmlq2AFMTOU' b'toIggor7fL38WwtnpGsLY6xtzz0j6NuNh0YaN50Oz1u5uhHTWQMMcqtUYYHL2p8pmeQWeQ' b'2epkT2Fzl1wtjsNVMzpgv647O+uYoZqcw8UDsiZR61OFJzNR3VHuRpfxzGG9WFQfddd9YH' b'JFnEgAMNmXt0Gs/j/C5bzxhllcfH7icOl8zm6GGQUQDe4akfTsExcjMertF565VtDPrP6m' b'QrCn18xxNSFg2IyP3rO55QrpENR05aPa8A4ZBkKdHUkKEF54qOygAVaECXE/IV2TSgw1cp' b'qhkYk3s685KA48Y9U466vSJnOPhDxxwqZSwv+R0SgIhOehLHruIc5CflF4yhzDzrBeMpmH' b'p5eK7pKDXI3a8SZgPqNVBtwmMm5SLZaSuGDKSzB4SWsBPDBeJa77R0mCeRfjat4m09eJPT' b'IuHhgKvnT1YLj3/vnZNVfe1ivPfWrqrI0Y1XT1bzaxfXwcy8o2tW41nfe/kEffmVi+tgbD' b'7IYDkleb8x+kTjvsUwZmYQljsfuDKfQdeKgKBtOTjoVh7wV7Is7L0rAZQbchzrztyMM+ar' b'AG+6GvPJGil9LbHrYWaxMEVzpf6tiN7Q3BcLE/jzrZBMhhlptuOsX65YL8f6fjuxYHdDsG' b'Vde+ZVRAvPuTW1WK7uEPL0zkwnnLtb46tyx5iOT2I7X7RIvd3mnyF3UFuN1RRi1UoQSK/0' b'5MhcpfSQI0pPY4n4lHG+BBqrQvBk7VWhCu60vaqjxWsVSLGsy1Eo3aO9clpf9jY38PiYO5' b'JL67EJDwXxS8zGpoEcjt6gLcuWc4NHNmrW59hALXNo8AuV3UDaOs1CsovFWM3xIYyQvDTR' b'XaCAGKK9QzpAtqH3tS877+Ij4CwermWxfsbjHgC+Xo+RaBe60ZyE7kcJ6NER5aacI7rd1w' b'FKb/+gTPLTgHo7ewXdWFFo8xts7xU8axbr1jEyzC+jU4dTJDGMrEukZ3jYcqvJ7dSCPTxR' b'gbcXimWVpw+DMeNbKFpsNDPeqetwc/VYhuox7MJlnxk6zYF7rJMUw6q/QMfsRZmrdVbttE' b'3ie3UyT/OIEeKAE5Tc8A35YM65oD7JaAwh3QML6RT+/NXlPFm706tBiOMsl3Qgl/1TTBlq' b'01XJsPLEBTMJyK1yyZLvFgtYf4ZMzxMeuENF3Os7WtrEL3hSB7Df+p7n1GFuF3jqyGBlun' b'RIdPVuTtAtHDBUfwkMY9N3wFg6XAFDmkq9Ots4nwoW3yNlcLUFTr/cskOn8UrjPNN/MKdX' b'Nab2Me8oB8LBnGqm1zsaDYZb550Xpq/vnuNYUHQe1eHXjYV9yLUlx2HWc+LQfrh+oPGpwv' b'1rGyyV/rzuMQnRTmcB9rFVBsJQG4u6CnAka+tw733m6Ctpl4aBrirO6CzAUR6nDvfhzh19' b'lbMTMt7W+0HyqwSiDRlaRUeGDEyTPYFIKQ6nN22jwXz4Q60dNQzmePKu0fO7WU+oYAwvrB' b'SgyPUYivDC3VhLlFEYN1ENRtMRVD9tFjdNDe07bKj4e70aCZ13f7UaiXZ+Q6FoW+t3rJ1M' b'HXqtgSzTwBo/SsKqOZojovfb63WMmt77b7HlGLJSr220qaJ1CbF22NOM9LEPOqkig0ZqwK' b'AektSjZsU0cikoFFjhkOfuEWNLwMsIj3sRz4tRhOSs0iokRs/MkQQz0qlrgaKdgsLwzajV' b'oI5wKe9q+SJz+GjxwsHjyfQ0iRcEWXsIvKCK62lzNfF4NMV23uMlQOgrBo0CwPRxHxnAkd' b'YtT9NRuTLmg7mB2iQCn9pcynF9A6FxhgHcTUWVpdwV1hg8SdLoE17xfezvI0tDdh0AA40u' b'iqP8rnuS2S6zQi0QIL5xi0QskX6Can61QDBDevUCQZ2RVgsEKAi9IsAmenNFgMPFEORZQp' b'5hL7oPQ6FGE4SrIkRJjfYp2of5DiwMMiEEqIR7rYEgIcF0DMSFtRM19ZL6D9XRIRWXh23Q' b'g6HLEXDHNkpk/+UxuEZnd/Fr2I0hAg+ZqtccapSKXnNoNR3lF7LkosqPArob0CcT1peLOs' b'FK6Q7KQp1FSyBu0ARPToE09sRzDZiLBkqTUGCP6BXttd18IM1A3Pt78RgzUOU180utkKBw' b'L2qJBFnydd89hfzFFHevnCM1rzEfwSv/y4SqGdrrQWttNUlM2cwBooNfbZlO8e1VLTrRqp' b'alg6pFWp/2mCeH6ByHpqNhtgBDnr9krDMAodDTRN/kMmlA2lYGBXOSHPzEE2PNIUw8MciH' b'c63LpSXiiSc0skM88aSnaFgtDC0ekDPRbYkINroeUdNRCiFa9wr1/w+rTtuH0A+q0kOU6A' b'TsjLRfWjeEXlp3QFhaJ4Aey+toLEK9TZwn5hYae4SJo8VhPJus4ITGIlcLtSuHj8YAB8fv' b'EuSFR+MwUgvHJtN5adEATC0wHoXK2uORBC7Q2GllwXP/3F3OAWZUutyQ29EFipqOyo0ezX' b'qJ1p+Z/Q71GiUKntO/Cc998SucGbe0ml2tDBCOXNeKvnWJV2b4fgJmfeuj6x4JR9ctEh9d' b'nzksHF23yK2j61YifXTduo3WPCykD6hbRA6oLywpZ8YnnvYH1K17OaBuY9UH1K2D+L6yTD' b'A5oF4GSCKbW8ztlCAgsxoCkeLVEDjTW2B5IKPBA6ULXcDMPqgXcCkMvadeIWGPFY3+4KsR' b'BfFEnW1O2nerhtD9qgNCx0oguEdU0WWZiCq6LFPTUWWmxwOGr/UzzcRVD8prWP0NDTlJ34' b'+wlIdB7aiWydUDg21rwaftBUKK02au0NEZ/ZVh3TqGUt2ZsyRkX/MMfGsZdpkF1tUMpDG8' b'8XSmduiNwIrAugqsNbzrRxahmGDU57MA6/5ApWbCRJzVlWwzRfPVJY/4dUAWw1mpSCtFHw' b'ZZL8TkIcL90VcTWL8xj/nZAJknZ69itZ7QQZkoeX3wbtcZU7DSAEdeO2kujK2Ni9Pl3t6p' b'Vk8tidERKiSB1AJs1NYF8+5VT6kQpOiXkFEpOfCrGzvS619vXYF1ofKHTI2uD0WeRteHaj' b'qq6RUZZ72DtLCIX8J0pF7zFChsHxHa37PHejKHE3JFR4cRNEMeIlkl9mIPax3lFFrMMRVq' b'3k0UVmFZAxf8kG/mDh5otPiQee1UkcHsxIDhch2QSh1EqEr5Q2t403pGS9rrGYbQeoYDgp' b'7RJgN1x1Uy+BMU6DSHsOucLZPhfn082jlT4Qlt7jjz4C3j2QbMIByC1iZcZLrjF1NIEF3D' b'mqYe0PILeGUFOrviaFNQw3WHOzJ8ix7ZWkIOd6ymGvALlMtUo0qBXM40w9+JuMw1qk1s0R' b'cN1/emYr6iTSFzCMXr4p3KXqSGlAMmKBGfR4hHGTWvykDqMkDo2oAZ/k2w8Kyun5wn3vqS' b'B/ftt5uc18ng7YtXyDxdHggjMmlB8vQOMgKNDIxXpI8shXlqPyWHG0srQdvcQpKrS0tH+e' b'lC9DnZMtjoqJLJPl7EjFF4uLI+hne9wz1Pbm/XI1khp5CdegkQgos9MNTGIb4wk7kcX5hJ' b'efbeomWCb8zsaNY6s58pH+Yt7bfet08tZOxb5SrIqrLocUAfoq0vG4ufoebqmlUtHe7MYq' b'FaDHtVnkvK09vEcJbpCHG+AKKVIriwSnKaRO+IG1KpyBXpoCFPAnnrbqc52V4/Nl5RKzpo' b'bOgbzIMqU2L2Ni9e5tWQfOx5YzbvW1+Q1Ap1ZYGgTxsgVqdTC+14UR+GqSFWrQ33lmZtUq' b'IVa+My0qsNcutGKJMKrW8bl6JuG3a4Dqp2pFe2jWN36pEym1SL7m3kCjadk2ZGwKvPqSX6' b'Iy+jZA0Vw2v215aQOt0uCakhg+6vTPvpz91tCsFFQ0BRAhWrcGiWNO2iAXmeoVEdN49GXz' b'OViI6Pm/369HDZWaQhct5SIKPgpKhv+n7PNHP01WgAj/5h81XtvuUCKoYyNveeOUz3BmMs' b'WsRFgq0xRRRsWFBboQj0mQboQ4PoQ4X79r0E+w0DqIPybFyRWTdKzT3mwXXPVqh4t3KexE' b'9+TAoBwn7lLGD3u9f11zeCCwE90hjk9DAcO7v3N9w6lNEo2Oe/xvQ43CQvfLZskrys1/uX' b'oDzWBuFZrmATlcGxnmPNQfpetcC3nz4Rf+rMzZ9ZigGBlLnyAoP7SzQPMy7VNIy0XsxOQf' b'dva0wH/CZUxuD0+jaduLPAxkh/9DTNlOzhYRvZQS+YuNFCPMNFxOxOWNHLRKvtTN2xO7gL' b'ajD+Chkf3V/mbWCZ94XRWAWwbxgvAqD7KeUuUnxVXKL3zhSmFHwVhH0BuQmAvnjZpcbfrZ' b'PNFD1Oz0rx7IPJtULsWZVKITpJrcKjNOkIJVFzDapU6VDse8ulQnS6DM6Z5qZ/NPO/DMCp' b'Cyf2Tbmfolt1KUpYkCfl7l+p7GeaamKjiGytiLBF6YDxqXgHX52Kd3h8Kp7gN+UKutmLXp' b'9FQoPCjBLSC6rQhuzNoaj50Qk4uAuXcUynQoVJDrHuW9ilyVF/rN3b2GUORjAzZhHFhxzm' b'ib6wlOGOzlUYKceLE01RGzS0fxPO6FJB1v7ozgs6unnB25yRxMcHKOnRPVDMVm2JoHXMPR' b'TVV3EoRkTGHRUBBNO6b612zxxmhwKqhtxZtFg0aqUO1KfxvcNIBh+LtJfMA2rPqDbYCTUF' b'kphZrzNINY4x8G/6B75NisYxN4milcDJ2O9gYAJw4r3XGe/OflFL50ht9EZQQ9r39obQnb' b'oDQq9OwLw5XPLD6NNF4s5FXO2zzoUz2mkVxnjte5GMz1hg9HbQaEXbOPUn0qqa1OEsdhe5' b'iSI+4mEktTbgc/P5El4qxlzdABeZnKeMYDiteX++N8eASvpiUs9fyHSV4tzho/Q6OF7/r0' b'qPxnlQWHhkwV1lSbyFPHXAKFucbzMgjkKYKpaEosDRPkDlgjoz+8+hRDAvsvjIOROpGzxD' b'1m2b9KhAmAOvR93YEAj3odEUG/OljQ9XBgnb2IWh7c73hCc6DGk3tUtHqFZnA5Rmn1lSjU' b'6oMtoD5o8vymYONSy6ngX1cuAhzcNTD83sT6pI/rIkSqp5HLSFt4h5ZuQTZhszLy/CYXQ6' b'N0m/iAFfisTpJ6ehvAf60R6OZ+WVuQPch5VLphyasbnkz8wfUgqiHrKbWSpY/vFS6ZfjsL' b'k8mOXaFYnfeXz1q7lFxTC5+N9t/G7BgtBLtzOWgjQkNeQxLJdmgoQF0txgmIPYY7F5pWg7' b'aUE2nEyLrPmhpwQpgV3/nWcOUT/U6ipyJrrNBfFEd7eAVmuEqMhqjXCe/EGtO03+kKM0Nb' b'/3ygCGgDp9l5EcGVmXxK4MjSui46N0DM1f1ea/00lErSPqQVNZFVEzTeW5pjidClRQaTwy' b'1os8/gfPlX0H/l/9XGlUETfWq4T1PT/Xzo+Hjtc6KI1xlfyhl0xRhqKLtZPkD2eCNMdn1D' b'HA3cBTlRjd8REUMUUGNcWA0X2AbWVfe43woGKNuP5+O4unMT7yZbkBM6S7Gsu6mAo08moZ' b'7rCBhWYCjdwaRpyaSqCRW8OQ+mqxOmAj15bj33y1WBOwkWvDifOnFGjk1jLc9f8Wmgg0cm' b'sY/p1XCxUCjdyCIZ3qInG10Ru5IKN8Wiis+U5rTWWFpvJUU6H2emTcejx+1Qg8I24ERHmR' b'j7E2xiTCU9IzpRoL74G0gronQJpVhPjnPRQs2zTBb7RwF1x6z0YeZwuE4T8T6n59Mq+wto' b'K4W2PThSDRQB+8mlGLw2EbQzKQ5XxJ3bP8zbMe8tHUgVQjYNpY+BbkA5op+mBNdQxgLrr1' b'6ZorjEtBWaWBKGVVwvVGqILH6Nz/ArTavZuA9NsbRSKbPjnxjdvwRKyOsCsZxt3IDK4dYc' b'oQbkVWIJcJp2asYqtETdIcrfcNJ0l8NwdpbaI2A61N1DQdWRkgK9ZmQxBjo1nCVIu/KXjO' b'SvSayRj3J7tTQuNOcx8ElYsy0W8spSD9rhamqcdgK4X5bnhLoUVcsVUU2WpHCYPKMZrTzw' b'zt92GKJpByJqdAfnaYQ/L5J6PQQd9qCKGwgsJUChIUJsTdPfGBHTtPZRE6mpsALOg6IGZL' b'YFVi0n1UKwB5asmgk08IjA4eM2BdbgvSb52x49UH5fL0btWucvxTt3fm3NwxMlVeKDoqXw' b'plTrcZiU/b8bBq0Xhcre3IGTNCfz1my8hR27EzZoz8OXYALe0H19qOoYKNfDuOH15rO4oK' b'NnJtOXGyqoCNXFtOGGJrO5AGcOTesWSQre1QGsCRe8uKM6sM2Mi14/iBtrbjqWAj15YjQ2' b'1tR1TBRq7JsZ2tXezPeIsdoF6pdJUFaBS7VuVlcXWoyRxeOvIFHW9o3gZSXUNfoQfTCyaY' b'eB3DoXkSA6cfKT9sOEv7GYyhGw3ou0AKMkbXUJiAzv0Dfbi5LATDfHt3tdiQOny02ODg8b' b'JCbuHRTawTi46Pi881HBsNzhxL3DogNpJnf0X0yjxx4fFo1cIJN178gU5g8WjlI18oNA7d' b'xRofZ19acLyOkbt8HZs/urQj5cd+ZIVZMiiurJuh2uyZ2bXs0THJmYOPvXfJgVCvjtSMRX' b'eEmo46QjTXnlZ0PEvJL23ZXxjE7UVZNv06y1UTZ0C0RjeLOFr0RcQJa57ZMheO223ImjaG' b'9Lm1WczSAWVkxbYCKQM/RydfMMs6aqPBAqlx5wzYqBZChYaGHIjmaYgoOj+A0ovOC2g6yn' b'NUI4giJwQgnOj48KOVreWCtNewUhL6Cg1y9bVEqaFH9xIxyOsTopOA+u16BekteAXf2kKc' b'3mD7rcRbPL2lCL7edoX4Z3/KdoZoQ9bPPKH7N/iOzh8gW6PzB5qO8h+hIRij+yjNLbNonL' b'xVTrTnq90l+2Y53InIrw93NskoTycB0TfuBfRWjubJdzP0BkvnZ55wqbLCj1bY6+QkCnvj' b'vrXOWBYAN0GnMqSrcvS7iZWzZk5svJbUMOTNaC2pWQDU+nlt6KCfk9Z3dDBqfQmHpiOrHs' b'YGfRn/b4cLYnzbdq9rA+3DyX4Kuu+ejZaTuu+wnBIjQfXzeNAOiGBK5Btsnlna22RMHb/f' b'8/+dXCmC6h/wS3hmLbfw3gfnaE9ODCmBW7Lv9enM0mHeS2Fp7cRB3oUVRc592hRcuk57qT' b'3oPVUO0I485t1YUWRfxIUh9Cw56VkPSD/rKVP3HVVFBK+mQitQ29c1LVNm9lNf3OmgG2Zz' b'y8ay/PO6qAhhSpVZQu6Yg5Z1iuZYGcWMpEoN7YcK6DpCRs7grUP13u30SIUm0D0Mdt8sd9' b'+jx9nmib+bccL9tFPXqaetckOPmmBmwKs2aN2OGyHK3j9iUdrPNNfEoyKyB0WEebYDxgtE' b'Dr5aH3K43j3PkhuPVtBdtBu8JKD6A5RjdK2WpqP+oAVj3z8MO7v41AQyrD4pMFosUrhsmU' b'4N9nXoURs5TjgBZosbeDS2oMp2+m7NLEtGpjEspK/mgnU2MH6GTWUHqHF6aZFggFdq4NYZ' b'lYl14Ed1F4B6QLO1iB7jlx4KhnYOik3tKg8G+zoH3bKwc6JqQw/nOsp/h2lzOgeJQd3c0W' b'JS1wrgjeqcFzGjc5HrHTjnJD7EMgmgnGKZKkyOsdQOdIZ4COzxLHflQ3E7baNVs4qAGoVL' b'0vrCtpoAbwSSa/NSh+jnkVaLMoLDnXqrBUvScPSzSPAw0bC+hK9wTyJZtr60D74yDUfRrB' b'K538I64ikMo6TlltzZFUlef2Fo9kCXvXJvlQmTBVodcEDQBwyww1R+px4RMbHoUQRj2/Yh' b'zkx0vduo25xaYNRvlha96jgri497ThaRvtKOgvDYoD0yaL+dmB4x6xLNxH5CVE1pIss00S' b'kidI8OGPe6Dr7qdR0ed7EEo6xiH7rlzceSKlbd3pxvmJmvoCJpOihIGjVfwxlwtriGxU/M' b'FC/LKzT4cLwh1INFaqCgl1lBlAhzDYSgHCzOGkUHV0StvlCj1vZP5jFRqtT8pCnKwsGmTi' b'l6dzmsz91ooYU8PZKhhukJeaPpaCRDTvW7i3o7ZmmB6MCzAfe9tc+hijHKKcY+nK6WdKYW' b'Hq3oWHRkPdI6MF7lKZNblh/zJDb6KAwdHyilxt6zz48WZmx4o/tLl8ktcxEmkqc82Ef0f4' b'YhyZBqwDTuwnBZBPKWvfqKbD9UGq96WHRAGBQNEA+JpYXCgGiAW8OhEUUPhsZlNBQaRA+E' b'BpBhcGYoGQSXjvRDoHEsA6CJTg9/hh0/MbwS6HLkfsDbBuPwHvU7NnefeWcyQuaCyPhYGc' b'iNjojL2XBnK/sZ7TQRs4c3K/epFekZ6oq+bhz1K1p4QeTcDT6pVrIwWDwec0d19O4eyi+6' b'E5KudKvUdNQqIeWw6zcXI6uxtV6/OQW/9ixjzh7zkCdcdBKTZGQk2l+4GIt+T35WNmlIhX' b'UhJNudC80m9lPXPAduzE6w+4yeWVOYPLM2TU6y1IQWbnRSPVlpHPbwwAswpp7a89zs0lF+' b'08vcyw394mHL1w4x2M9nzkV4HslzfEjPTzQSXHnKhNsK9bB+6eGJUXtwd6BxVOqpgf6XmS' b'P3JjTvFDWGzMKTJvCFp5zs3E70oYXzCddJKZ2bcIHRYLYDzWqjd1RpR3ZJ1rqiB++odo68' b'+bHHvZymbF5RQ8zcw5Ueb7Q4HYN1GMolWtKpSHu1yhBarTIAn6TQPTqHbaLxkjPXCYjGj1' b'XUE4uO1+0zC8c9e+mCGNkP5haNR4bSgqO+nU1IrwMiGnsqgs+RMyccFd1BhlI0ZziuG2Tp' b'ODfaI0RVFmH2Wx38recOCwdz2UmHQ7YcxS4PW6rVNEwjpbsTZHH0pqymo+5kmcSvhxYUht' b'q9tURLkbgLLyPh0B4ZrHlKC90IqsRGHQg2ZUsE8zZcXtfRvU6LhLbNUAr04dw5yYdneyQj' b'c5Q1VeB7UHJqNyNH2/JaOpjyklbbvhXJ0fvcGbGr17nz5BytCa5IjzTzBUPvmaYoRcvkHC' b'0frhQdnUmegHF+7bqdvuf8vOZBZxP0V6qXc34Y5ZRab6C2IzJoxgYM+ilIe1kn5s1nbZUP' b'hiyDFfjG6Mu3DdBXnMPqV4mMeNDPW6IqGiBe30eVNOjYQp7F+3D1OGTDPLLw1Wl7eDEXjy' b'bnsFiWWyK+q6VKgUZWCZRVnX+CLnCOVsYaQ8sCGmTQBw6mqAjdrccG5nSoLimfkxw941AS' b'u3Hp6zzzjPHFAZMFOVcPP1QGDQfcTcC3bjjAAOI5V0E3ZO35cO9ZvSs8U+hI/KlhxbV7Vl' b'vwRtRT4VxF3ZJ1fRtChaKJ7sUpFR01CjrcdS9bngvNeGZNSK9TmDh2PSft3WbQd7BNPOOP' b'jksHgcGkK4XTkLeUY8MQRXdpKFEtKUpY2aFTqpZ8KO1sXx1lhp3DhXOKDBfOGTBcOGfIk6' b'6GDZpi97UPM+pZY4Fo6kUwOuJQkPa9oiF0t+iA0C8aIPQ7+cTQI/uXBUEuNT1jpBndwViP' b'eNFFjJVm+tX+KLSrKxlRH3QvkzWGHlXTuQGv2ox1O66+jA99Qfdnfzqb+zdyCzzyMGLGd+' b'VA2ieCavtpTnqk9ntkxE/U7KxfzWZnwhlNaIUxnr42yXiX3uSNgUYzU+P0GM+WFoLJPGgS' b'IKmtTB60SqOvhLs2UybEHQ9Z8vPFnCYRdkaMVmOTVZtYb+r8SOUgASYWGMKBktoi6ogJS9' b'Ye2tF302eCnsx7cpzrhens4gY3TDENGyXDeXhuP4NXB6i5+MwiIQczDdyaj7vw/YzcBaAW' b'r50DPUufeSjM0x0Uz9RzD4a5uoNudUhOVD1fd66jGbvDbh0SLy1LT+eda+nnnJMwpZ8L4C' b'f1zotb7TNHUdoY4t2aJ7NB7RjSU7o06MPkLjg/Tyeprr9E1Y3u5kKdje7m0nQ0dhgGmtFV' b'I514xqiNenzcRLNkPDmoHDJqoHQoz7yFR7Wcoj+xkLNdyR01RORmuNzvnJPSeeARERajXV' b'azUDSDmFrQz+Yciozv9506PEShedIxDBulQ+LBxKAv0YtmlERd/eBOlFDm6FrxCsqtNmAp' b'QUerJJBUvwfNNhFdVYX+IrqqStNR2TIgxIPs//NMc9qnrbUca4uIIXdGs0FaXLktPRac1R' b'7a9xsHVQZ67M29Ms3SUGbZjxNVEnw8GB2o8WrutbDShd01hkAzRn+/8ATZwmlgj45m22GC' b'fUSf0Jkb5GiePf0uV7YCl991ok8Uz266sqZMOR+I/i5bImq/70bHhC4CqrWMGwjZHWv3o0' b'uTnGWRB6mn/ZA1803ZqXnSW+zOFeRNdhGC3Efo18SR5cd+/bRBsHziwRC7R16aPrXEkTtA' b'zdwSPMRPa1jagPLZWr4013NO5D7DRCoCwlTKwWEyRSCaNBjAGHZSceNnmmlCc7J7RYRVdA' b'eMN1gcfLXB4vB4g4XgNrrIDrmnVzPQcvUEe7Yi7W/BMIS+lccB4coOAvoE9czQ8RyQ88vr' b'KU3DJn41u2jYEcQa7MQAXoW1lNZhPRKUWCLeOKtG5NHNYKgP0c1gmo46FlSPy/g2D47Sl/' b'F1HosrMDoZjSx67XZflZ7ROEQGWu8kaGm5Q2SwNH4O57ewNZw7RDSGIp9OHSYaYOUBCZkB' b'8WauPONH0D8MqbSjmnSQOQ3kLc3IhOr1IuN1dLNO4bDvIboPmZCjdajaAkGDMkCsP2UWCt' b'qTAW7pTiYpWnMyLiO9ySC3tCYjtNaZjEspSMMO+tLMkV5bMo6lSI0c8m5OY7JQK0PGtVeF' b'HNEfN0bRnCa8RhnxXeR2tXlyMes5GaK9KLM/UuqylxqkuxqtXCYXubwMIYaFFUeEy8saDc' b'hKS5VEz4HmyWWzDt1HkYIOt41VlpSzIZDd2yFCRH3b2CKQ3jMmxIJJ9HnAJBlzhQXRVmmA' b'nQDpUkUjdxItS4DqpjAIKTeUQUptJmnI8C4xSH3tD8LR14lBd7i4C8qaif30V860M0uraC' b'muvqCsbSwdhbi0mFxQtgIdX1DGHNeQzhDk3ZUdMmTUtxSVye3lYXjVt1Ogz7+EO8yQqZKZ' b'6Ogu148YrzyoluQq43J08xOkj1RGlAVX4PytQcVK0eYS7QlTIJD2m2u3uqvJFe4vJ6Jb9x' b'TxnJ/s7cyy9QQlJxdaMRt8u2eRvsgLPCTQiqMtbzQonsg2158tCk/ox4ebMeh1SBO44fgL' b'HzAPc4jcn4bK8DI2xPeYO0kBEaL8ZQKsdT0v37+Mn8qGwnc1/E2L5Gr0m4+xaPBD3UAPtz' b'ZW8GrldBXgq1czG5S7f5KY/qP7rCoPSCeA6HVvh6yRboXfusVaOjRZ0le1LgN4y+45wr3F' b'cwRqW2cwbgWSJtdhaEwHkSZf2cWXyVfZSyvwrbfSLB0MlEjrW4or0NwsWJIRtgdyRZbFCA' b'hLkgYMS5KWNKe4oAE3QgWt2GDaz2pC5G0IL7uhZ/sahhkEqXo9qEHRS88YW78q3XI+JTlS' b'LRtiV5rlguhYsVwC1JkzA23ejeDuiu8TzAg6qRYCcBKrngabLCOOPo8yizjhjaI4LAfWAK' b'Pbb9vkq5/LIE16WWMFt2iC+uEkNHcL+TrkaV1/iJ3WR31XPObpDvNNRADdTgBGHS+qoJ6r' b'VxDImJjefGe8HTN1UjxTG602yf9isEoPOoB58lU6XVQlP/hVSGxQ+ZHjeiyeoeLogW01TV' b'5ZyFXy6rsVJPl1re4snYHUhzdWoPXhDU1H8i7IkGBqUOM+tG49qAMkeFZ2uAWF+2ou1uME' b'ncF+fbs9hCE169ewU8g4R89ImtBfw0uUYTV9GjNib3WZvKpnhpbJa2i5pSXETB3d8Ksaz2' b'uSaosN85BX1dKhO73q3axZChq+OSbwFuo0RSqixkoHIV+Rnk7dmwrJvKZUwyFNFvTFkAaQ' b'Rwox0CrAzWWAL2cOh07VHeOFmEn7HZ4qB2i/1278Cstk9T2mDmFqHaHb2huT/GJRRYi7NJ' b'zn4LjlZSqRclw7x8PrwV+kY5yEk3g8kn7lRrOXls2kfS+IRX7tRrNTz+b94ryja7SmVX6H' b'L4tRLs2G/m46Zjccab4LxPjzb+PxRl2H9jTYCAZcFhVnLgmnMw0Yy4mTWG0/lr48/7fFu/' b'r7TiStLhnQF7+X0GLsQjNRFHpBfDYBrVuNoaWZQOaoW0ce6SXXWQZa+9Z0pNQhQwbzMMmM' b'H5HdC1noSf1GUIY4pL9GeEbfTLmF/KrPysFV6L1RB98OZqK0Sjj3xHDzpxqB82Xypza3zp' b'JgT4lZ1p+6F4LTqBdqkj+jEx3QCf7kBUpNm0SWjui4xawRmfynkrXNEz4EBD30bb3ehA57' b'2ib6tnRouG8yM18mcnF6Rlz1ZFkSXaNuvOmlLNJ68JiC1uOGpqOByDAkmhTUfs3h1e+6Ut' b'yroSn3oI7iCozqwgJcrdqXcB7Ko7ZEGCaq5E3P9JG8qIAsLdPgInlTCuB0TtLcCB+GsGUW' b'wFg3ZF6Od4pXxvWtkbCMGaORcB5zxzvNqFgRf7TlDIXk7Xp7GlPwt6vdaegmb7eNKzD+vn' b'3HuALV9e2WccXMBGa3LIezXTcJGYc6oSoi029MU5nncZsmokZbQ16dDq8ZwHG9RRN4Q9sM' b'JhbzCI8fxjI8fXHZlBl5vLmCgwYHKDYETAUbH7VnVXasGGcFOPdhijKDDF55YIm4bYpmaj' b'/9agumUm+91oGRC1rwgvxgdIhY+sMb+mmMFWzD8eYYhYi6G6RtMA9mm48wT1NkmJYZMEzL' b'DBlNsTKH6PsyVk0KMaID4ag0QxC5Zji62deKjnqWkgypDSiwqzuvoe29XV163V6BUT+C/s' b'g8VmLPJ6AgBt1PGmFVh2ZieJNttIxJfgtv72KWJkvgLMmX4alDIe9ZAryXaR5D+oJRlCtt' b'4uZIpR+skDN6sIIoftrBShkGLiQhOvGNIC4qg9EJRAfAS0VHGVyQIVVpAup03z/pPrZxWD' b'+c+8c+ejQDQxp4u/4MPUTDVYBv+ZqRPS7GwoNa7CswKkbGrroVdowX3XuwJ9Xj5HJF2i8Y' b'r5JvHFvnyTd9WA36xjdZRCbPO2/wrS8cIK2MOmuSI6NOBnVt1FkZNBh1Gldjo04G16szXJ' b'mhR0e4JgC1jSdD+qN7xIRbHVhFCRs0visQvfW39fEPtSnPGN/M2adlaT9D1xABoXNwcOge' b'AGhtCSn1S+VVi28ZqWeWcCM1an0KwBp+8tO+sV4tzJcYVjraj9ezPPkWLeAgtpuWk2hS37' b'pbJ6NRAaITtgg/OmFL+mh2rybmK2z/WFrtX5UG8FtSltJ7Sh4Jm0oWiXeVbLB6s8gi0W6R' b'hfSukEXUzo8F9HkXi/jtHUuZZvT7wLfOqAusAngYDg7PJpNFwK0MwFD3ndEakhGdR0ShbD' b'vdnOYEzKK/vko+I6oLj+HcLr3KcG4U3zL5Fh0rQwWOjpWRPgzqPnBUQW0lwoYRDYwQNToR' b'A/fRiRjQ0s/D79gsABOib2GDDQmK7OEReGQPP0/+7a59v0z+H+SUGTTsMAEA' )).decode().splitlines() def get_tessdata() -> str: """Detect Tesseract-OCR and return its language support folder. This function can be used to enable OCR via Tesseract even if the environment variable TESSDATA_PREFIX has not been set. If the value of TESSDATA_PREFIX is None, the function tries to locate Tesseract-OCR and fills the required variable. Returns: Folder name of tessdata if Tesseract-OCR is available, otherwise False. """ TESSDATA_PREFIX = os.getenv("TESSDATA_PREFIX") if TESSDATA_PREFIX != None: return TESSDATA_PREFIX if sys.platform == "win32": tessdata = "C:\\Program Files\\Tesseract-OCR\\tessdata" else: tessdata = "/usr/share/tesseract-ocr/4.00/tessdata" if os.path.exists(tessdata): return tessdata """ Try to locate the tesseract-ocr installation. """ # Windows systems: if sys.platform == "win32": try: response = os.popen("where tesseract").read().strip() except: response = "" if not response: print("Tesseract-OCR is not installed") return False dirname = os.path.dirname(response) # path of tesseract.exe tessdata = os.path.join(dirname, "tessdata") # language support if os.path.exists(tessdata): # all ok? return tessdata else: # should not happen! print("unexpected: Tesseract-OCR has no 'tessdata' folder", file=sys.stderr) return False # Unix-like systems: try: response = os.popen("whereis tesseract-ocr").read().strip().split() except: response = "" if len(response) != 2: # if not 2 tokens: no tesseract-ocr print("Tesseract-OCR is not installed") return False # determine tessdata via iteration over subfolders tessdata = None for sub_response in response.iterdir(): for sub_sub in sub_response.iterdir(): if str(sub_sub).endswith("tessdata"): tessdata = sub_sub break if tessdata != None: return tessdata else: print( "unexpected: tesseract-ocr has no 'tessdata' folder", file=sys.stderr, ) return False return False %} ================================================ FILE: src_classic/helper-select.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ void remove_dest_range(fz_context *ctx, pdf_document *pdf, PyObject *numbers) { fz_try(ctx) { int i, j, pno, len, pagecount = pdf_count_pages(ctx, pdf); PyObject *n1 = NULL; pdf_obj *target, *annots, *pageref, *o, *action, *dest; for (i = 0; i < pagecount; i++) { n1 = PyLong_FromLong((long) i); if (PySet_Contains(numbers, n1)) { Py_DECREF(n1); continue; } Py_DECREF(n1); pageref = pdf_lookup_page_obj(ctx, pdf, i); annots = pdf_dict_get(ctx, pageref, PDF_NAME(Annots)); if (!annots) continue; len = pdf_array_len(ctx, annots); for (j = len - 1; j >= 0; j -= 1) { o = pdf_array_get(ctx, annots, j); if (!pdf_name_eq(ctx, pdf_dict_get(ctx, o, PDF_NAME(Subtype)), PDF_NAME(Link))) { continue; } action = pdf_dict_get(ctx, o, PDF_NAME(A)); dest = pdf_dict_get(ctx, o, PDF_NAME(Dest)); if (action) { if (!pdf_name_eq(ctx, pdf_dict_get(ctx, action, PDF_NAME(S)), PDF_NAME(GoTo))) continue; dest = pdf_dict_get(ctx, action, PDF_NAME(D)); } pno = -1; if (pdf_is_array(ctx, dest)) { target = pdf_array_get(ctx, dest, 0); pno = pdf_lookup_page_number(ctx, pdf, target); } else if (pdf_is_string(ctx, dest)) { fz_location location = fz_resolve_link(ctx, &pdf->super, pdf_to_text_string(ctx, dest), NULL, NULL); pno = location.page; } if (pno < 0) { // page number lookup did not work continue; } n1 = PyLong_FromLong((long) pno); if (PySet_Contains(numbers, n1)) { pdf_array_delete(ctx, annots, j); } Py_DECREF(n1); } } } fz_catch(ctx) { fz_rethrow(ctx); } return; } %} ================================================ FILE: src_classic/helper-stext.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ // need own versions of ascender / descender static const float JM_font_ascender(fz_context *ctx, fz_font *font) { if (skip_quad_corrections) { return 0.8f; } return fz_font_ascender(ctx, font); } static const float JM_font_descender(fz_context *ctx, fz_font *font) { if (skip_quad_corrections) { return -0.2f; } return fz_font_descender(ctx, font); } //---------------------------------------------------------------- // Return true if character is considered to be a word delimiter //---------------------------------------------------------------- static const int JM_is_word_delimiter(int c, PyObject *delimiters) { if (c <= 32 || c == 160) return 1; // a standard delimiter // extra delimiters must be a non-empty sequence if (!delimiters || PyObject_Not(delimiters) || !PySequence_Check(delimiters)) { return 0; } // convert to tuple for easier looping PyObject *delims = PySequence_Tuple(delimiters); if (!delims) { PyErr_Clear(); return 0; } // Make 1-char PyObject from character given as integer PyObject *cchar = Py_BuildValue("C", c); // single character PyObject Py_ssize_t i, len = PyTuple_Size(delims); for (i = 0; i < len; i++) { int rc = PyUnicode_Compare(cchar, PyTuple_GET_ITEM(delims, i)); if (rc == 0) { // equal to a delimiter character Py_DECREF(cchar); Py_DECREF(delims); PyErr_Clear(); return 1; } } Py_DECREF(delims); PyErr_Clear(); return 0; } /* inactive //----------------------------------------------------------------------------- // Make OCR text page directly from an fz_page //----------------------------------------------------------------------------- fz_stext_page * JM_new_stext_page_ocr_from_page(fz_context *ctx, fz_page *page, fz_rect rect, int flags, const char *lang, const char *tessdata) { if (!page) return NULL; int with_list = 1; fz_stext_page *tp = NULL; fz_device *dev = NULL, *ocr_dev = NULL; fz_var(dev); fz_var(ocr_dev); fz_var(tp); fz_stext_options options; memset(&options, 0, sizeof options); options.flags = flags; //fz_matrix ctm = fz_identity; fz_matrix ctm1 = fz_make_matrix(100/72, 0, 0, 100/72, 0, 0); fz_matrix ctm2 = fz_make_matrix(400/72, 0, 0, 400/72, 0, 0); fz_try(ctx) { tp = fz_new_stext_page(ctx, rect); dev = fz_new_stext_device(ctx, tp, &options); ocr_dev = fz_new_ocr_device(ctx, dev, fz_identity, rect, with_list, lang, tessdata, NULL); fz_run_page(ctx, page, ocr_dev, fz_identity, NULL); fz_close_device(ctx, ocr_dev); fz_close_device(ctx, dev); } fz_always(ctx) { fz_drop_device(ctx, dev); fz_drop_device(ctx, ocr_dev); } fz_catch(ctx) { fz_drop_stext_page(ctx, tp); fz_rethrow(ctx); } return tp; } */ //--------------------------------------------------------------------------- // APPEND non-ascii runes in unicode escape format to fz_buffer //--------------------------------------------------------------------------- void JM_append_rune(fz_context *ctx, fz_buffer *buff, int ch) { if (ch == 92) { // prevent accidental "\u" etc. fz_append_string(ctx, buff, "\\u005c"); } else if ((ch >= 32 && ch <= 255) || ch == 10) { fz_append_byte(ctx, buff, ch); } else if (ch >= 0xd800 && ch <= 0xdfff) { // surrogate Unicode range fz_append_string(ctx, buff, "\\ufffd"); } else if (ch <= 0xffff) { // 4 hex digits fz_append_printf(ctx, buff, "\\u%04x", ch); } else { // 8 hex digits fz_append_printf(ctx, buff, "\\U%08x", ch); } } // re-compute char quad if ascender/descender values make no sense static fz_quad JM_char_quad(fz_context *ctx, fz_stext_line *line, fz_stext_char *ch) { if (skip_quad_corrections) { // no special handling return ch->quad; } if (line->wmode) { // never touch vertical write mode return ch->quad; } fz_font *font = ch->font; float asc = JM_font_ascender(ctx, font); float dsc = JM_font_descender(ctx, font); float c, s, fsize = ch->size; float asc_dsc = asc - dsc + FLT_EPSILON; if (asc_dsc >= 1 && small_glyph_heights == 0) { // no problem return ch->quad; } if (asc < 1e-3) { // probably Tesseract glyphless font dsc = -0.1f; asc = 0.9f; asc_dsc = 1.0f; } if (small_glyph_heights || asc_dsc < 1) { dsc = dsc / asc_dsc; asc = asc / asc_dsc; } asc_dsc = asc - dsc; asc = asc * fsize / asc_dsc; dsc = dsc * fsize / asc_dsc; /* ------------------------------ Re-compute quad with the adjusted ascender / descender values: Move ch->origin to (0,0) and de-rotate quad, then adjust the corners, re-rotate and move back to ch->origin location. ------------------------------ */ fz_matrix trm1, trm2, xlate1, xlate2; fz_quad quad; c = line->dir.x; // cosine s = line->dir.y; // sine trm1 = fz_make_matrix(c, -s, s, c, 0, 0); // derotate trm2 = fz_make_matrix(c, s, -s, c, 0, 0); // rotate if (c == -1) { // left-right flip trm1.d = 1; trm2.d = 1; } xlate1 = fz_make_matrix(1, 0, 0, 1, -ch->origin.x, -ch->origin.y); xlate2 = fz_make_matrix(1, 0, 0, 1, ch->origin.x, ch->origin.y); quad = fz_transform_quad(ch->quad, xlate1); // move origin to (0,0) quad = fz_transform_quad(quad, trm1); // de-rotate corners // adjust vertical coordinates if (c == 1 && quad.ul.y > 0) { // up-down flip quad.ul.y = asc; quad.ur.y = asc; quad.ll.y = dsc; quad.lr.y = dsc; } else { quad.ul.y = -asc; quad.ur.y = -asc; quad.ll.y = -dsc; quad.lr.y = -dsc; } // adjust horizontal coordinates that are too crazy: // (1) left x must be >= 0 // (2) if bbox width is 0, lookup char advance in font. if (quad.ll.x < 0) { quad.ll.x = 0; quad.ul.x = 0; } float cwidth = quad.lr.x - quad.ll.x; if (cwidth < FLT_EPSILON) { int glyph = fz_encode_character(ctx, font, ch->c); if (glyph) { float fwidth = fz_advance_glyph(ctx, font, glyph, line->wmode); quad.lr.x = quad.ll.x + fwidth * fsize; quad.ur.x = quad.lr.x; } } quad = fz_transform_quad(quad, trm2); // rotate back quad = fz_transform_quad(quad, xlate2); // translate back return quad; } // return rect of char quad static fz_rect JM_char_bbox(fz_context *ctx, fz_stext_line *line, fz_stext_char *ch) { fz_rect r = fz_rect_from_quad(JM_char_quad(ctx, line, ch)); if (!line->wmode) { return r; } if (r.y1 < r.y0 + ch->size) { r.y0 = r.y1 - ch->size; } return r; } //------------------------------------------- // make a buffer from an stext_page's text //------------------------------------------- fz_buffer * JM_new_buffer_from_stext_page(fz_context *ctx, fz_stext_page *page) { fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_rect rect = page->mediabox; fz_buffer *buf = NULL; fz_try(ctx) { buf = fz_new_buffer(ctx, 256); for (block = page->first_block; block; block = block->next) { if (block->type == FZ_STEXT_BLOCK_TEXT) { for (line = block->u.t.first_line; line; line = line->next) { for (ch = line->first_char; ch; ch = ch->next) { if (!JM_rects_overlap(rect, JM_char_bbox(ctx, line, ch)) && !fz_is_infinite_rect(rect)) { continue; } fz_append_rune(ctx, buf, ch->c); } fz_append_byte(ctx, buf, '\n'); } fz_append_byte(ctx, buf, '\n'); } } } fz_catch(ctx) { fz_drop_buffer(ctx, buf); fz_rethrow(ctx); } return buf; } static float hdist(fz_point *dir, fz_point *a, fz_point *b) { float dx = b->x - a->x; float dy = b->y - a->y; return fz_abs(dx * dir->x + dy * dir->y); } static float vdist(fz_point *dir, fz_point *a, fz_point *b) { float dx = b->x - a->x; float dy = b->y - a->y; return fz_abs(dx * dir->y + dy * dir->x); } struct highlight { Py_ssize_t len; PyObject *quads; float hfuzz, vfuzz; }; static void on_highlight_char(fz_context *ctx, void *arg, fz_stext_line *line, fz_stext_char *ch) { struct highlight *hits = arg; float vfuzz = ch->size * hits->vfuzz; float hfuzz = ch->size * hits->hfuzz; fz_quad ch_quad = JM_char_quad(ctx, line, ch); if (hits->len > 0) { PyObject *quad = PySequence_ITEM(hits->quads, hits->len - 1); fz_quad end = JM_quad_from_py(quad); Py_DECREF(quad); if (hdist(&line->dir, &end.lr, &ch_quad.ll) < hfuzz && vdist(&line->dir, &end.lr, &ch_quad.ll) < vfuzz && hdist(&line->dir, &end.ur, &ch_quad.ul) < hfuzz && vdist(&line->dir, &end.ur, &ch_quad.ul) < vfuzz) { end.ur = ch_quad.ur; end.lr = ch_quad.lr; quad = JM_py_from_quad(end); PyList_SetItem(hits->quads, hits->len - 1, quad); return; } } LIST_APPEND_DROP(hits->quads, JM_py_from_quad(ch_quad)); hits->len++; } static inline int canon(int c) { /* TODO: proper unicode case folding */ /* TODO: character equivalence (a matches ä, etc) */ if (c == 0xA0 || c == 0x2028 || c == 0x2029) return ' '; if (c == '\r' || c == '\n' || c == '\t') return ' '; if (c >= 'A' && c <= 'Z') return c - 'A' + 'a'; return c; } static inline int chartocanon(int *c, const char *s) { int n = fz_chartorune(c, s); *c = canon(*c); return n; } static const char *match_string(const char *h, const char *n) { int hc, nc; const char *e = h; h += chartocanon(&hc, h); n += chartocanon(&nc, n); while (hc == nc) { e = h; if (hc == ' ') do h += chartocanon(&hc, h); while (hc == ' '); else h += chartocanon(&hc, h); if (nc == ' ') do n += chartocanon(&nc, n); while (nc == ' '); else n += chartocanon(&nc, n); } return nc == 0 ? e : NULL; } static const char *find_string(const char *s, const char *needle, const char **endp) { const char *end; while (*s) { end = match_string(s, needle); if (end) return *endp = end, s; ++s; } return *endp = NULL, NULL; } PyObject * JM_search_stext_page(fz_context *ctx, fz_stext_page *page, const char *needle) { struct highlight hits; fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_buffer *buffer = NULL; const char *haystack, *begin, *end; fz_rect rect = page->mediabox; int c, inside; if (strlen(needle) == 0) Py_RETURN_NONE; PyObject *quads = PyList_New(0); hits.len = 0; hits.quads = quads; hits.hfuzz = 0.2f; /* merge kerns but not large gaps */ hits.vfuzz = 0.1f; fz_try(ctx) { buffer = JM_new_buffer_from_stext_page(ctx, page); haystack = fz_string_from_buffer(ctx, buffer); begin = find_string(haystack, needle, &end); if (!begin) goto no_more_matches; inside = 0; for (block = page->first_block; block; block = block->next) { if (block->type != FZ_STEXT_BLOCK_TEXT) { continue; } for (line = block->u.t.first_line; line; line = line->next) { for (ch = line->first_char; ch; ch = ch->next) { if (!fz_is_infinite_rect(rect) && !JM_rects_overlap(rect, JM_char_bbox(ctx, line, ch))) { goto next_char; } try_new_match: if (!inside) { if (haystack >= begin) inside = 1; } if (inside) { if (haystack < end) { on_highlight_char(ctx, &hits, line, ch); } else { inside = 0; begin = find_string(haystack, needle, &end); if (!begin) goto no_more_matches; else goto try_new_match; } } haystack += fz_chartorune(&c, haystack); next_char:; } assert(*haystack == '\n'); ++haystack; } assert(*haystack == '\n'); ++haystack; } no_more_matches:; } fz_always(ctx) fz_drop_buffer(ctx, buffer); fz_catch(ctx) fz_rethrow(ctx); return quads; } //----------------------------------------------------------------------------- // Plain text output. An identical copy of fz_print_stext_page_as_text, // but lines within a block are concatenated by space instead a new-line // character (which else leads to 2 new-lines). //----------------------------------------------------------------------------- void JM_print_stext_page_as_text(fz_context *ctx, fz_buffer *buff, fz_stext_page *page) { fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_rect rect = page->mediabox; fz_rect chbbox; int last_char = 0; char utf[10]; int i, n; for (block = page->first_block; block; block = block->next) { if (block->type == FZ_STEXT_BLOCK_TEXT) { for (line = block->u.t.first_line; line; line = line->next) { last_char = 0; for (ch = line->first_char; ch; ch = ch->next) { chbbox = JM_char_bbox(ctx, line, ch); if (fz_is_infinite_rect(rect) || JM_rects_overlap(rect, chbbox)) { last_char = ch->c; JM_append_rune(ctx, buff, ch->c); } } if (last_char != 10 && last_char > 0) { fz_append_string(ctx, buff, "\n"); } } } } } //----------------------------------------------------------------------------- // Functions for wordlist output //----------------------------------------------------------------------------- int JM_append_word(fz_context *ctx, PyObject *lines, fz_buffer *buff, fz_rect *wbbox, int block_n, int line_n, int word_n) { PyObject *s = JM_EscapeStrFromBuffer(ctx, buff); PyObject *litem = Py_BuildValue("ffffOiii", wbbox->x0, wbbox->y0, wbbox->x1, wbbox->y1, s, block_n, line_n, word_n); LIST_APPEND_DROP(lines, litem); Py_DECREF(s); *wbbox = fz_empty_rect; return word_n + 1; // word counter } //----------------------------------------------------------------------------- // Functions for dictionary output //----------------------------------------------------------------------------- static int detect_super_script(fz_stext_line *line, fz_stext_char *ch) { if (line->wmode == 0 && line->dir.x == 1 && line->dir.y == 0) return ch->origin.y < line->first_char->origin.y - ch->size * 0.1f; return 0; } static int JM_char_font_flags(fz_context *ctx, fz_font *font, fz_stext_line *line, fz_stext_char *ch) { int flags = detect_super_script(line, ch); flags += fz_font_is_italic(ctx, font) * TEXT_FONT_ITALIC; flags += fz_font_is_serif(ctx, font) * TEXT_FONT_SERIFED; flags += fz_font_is_monospaced(ctx, font) * TEXT_FONT_MONOSPACED; flags += fz_font_is_bold(ctx, font) * TEXT_FONT_BOLD; return flags; } static const char * JM_font_name(fz_context *ctx, fz_font *font) { const char *name = fz_font_name(ctx, font); const char *s = strchr(name, '+'); if (subset_fontnames || s == NULL || s-name != 6) { return name; } return s + 1; } static fz_rect JM_make_spanlist(fz_context *ctx, PyObject *line_dict, fz_stext_line *line, int raw, fz_buffer *buff, fz_rect tp_rect) { PyObject *span = NULL, *char_list = NULL, *char_dict; PyObject *span_list = PyList_New(0); fz_clear_buffer(ctx, buff); fz_stext_char *ch; fz_rect span_rect = fz_empty_rect; fz_rect line_rect = fz_empty_rect; fz_point span_origin = {0, 0}; typedef struct style_s { float size; int flags; const char *font; int color; float asc; float desc; } char_style; char_style old_style = { -1, -1, "", -1, 0, 0 }, style; for (ch = line->first_char; ch; ch = ch->next) { fz_rect r = JM_char_bbox(ctx, line, ch); if (!JM_rects_overlap(tp_rect, r) && !fz_is_infinite_rect(tp_rect)) { continue; } int flags = JM_char_font_flags(ctx, ch->font, line, ch); fz_point origin = ch->origin; style.size = ch->size; style.flags = flags; style.font = JM_font_name(ctx, ch->font); style.color = ch->color; style.asc = JM_font_ascender(ctx, ch->font); style.desc = JM_font_descender(ctx, ch->font); if (style.size != old_style.size || style.flags != old_style.flags || style.color != old_style.color || strcmp(style.font, old_style.font) != 0) { if (old_style.size >= 0) { // not first one, output previous if (raw) { // put character list in the span DICT_SETITEM_DROP(span, dictkey_chars, char_list); char_list = NULL; } else { // put text string in the span DICT_SETITEM_DROP(span, dictkey_text, JM_EscapeStrFromBuffer(ctx, buff)); fz_clear_buffer(ctx, buff); } DICT_SETITEM_DROP(span, dictkey_origin, JM_py_from_point(span_origin)); DICT_SETITEM_DROP(span, dictkey_bbox, JM_py_from_rect(span_rect)); line_rect = fz_union_rect(line_rect, span_rect); LIST_APPEND_DROP(span_list, span); span = NULL; } span = PyDict_New(); float asc = style.asc, desc = style.desc; if (style.asc < 1e-3) { asc = 0.9f; desc = -0.1f; } DICT_SETITEM_DROP(span, dictkey_size, Py_BuildValue("f", style.size)); DICT_SETITEM_DROP(span, dictkey_flags, Py_BuildValue("i", style.flags)); DICT_SETITEM_DROP(span, dictkey_font, JM_EscapeStrFromStr(style.font)); DICT_SETITEM_DROP(span, dictkey_color, Py_BuildValue("i", style.color)); DICT_SETITEMSTR_DROP(span, "ascender", Py_BuildValue("f", asc)); DICT_SETITEMSTR_DROP(span, "descender", Py_BuildValue("f", desc)); old_style = style; span_rect = r; span_origin = origin; } span_rect = fz_union_rect(span_rect, r); if (raw) { // make and append a char dict char_dict = PyDict_New(); DICT_SETITEM_DROP(char_dict, dictkey_origin, JM_py_from_point(ch->origin)); DICT_SETITEM_DROP(char_dict, dictkey_bbox, JM_py_from_rect(r)); DICT_SETITEM_DROP(char_dict, dictkey_c, Py_BuildValue("C", ch->c)); if (!char_list) { char_list = PyList_New(0); } LIST_APPEND_DROP(char_list, char_dict); } else { // add character byte to buffer JM_append_rune(ctx, buff, ch->c); } } // all characters processed, now flush remaining span if (span) { if (raw) { DICT_SETITEM_DROP(span, dictkey_chars, char_list); char_list = NULL; } else { DICT_SETITEM_DROP(span, dictkey_text, JM_EscapeStrFromBuffer(ctx, buff)); fz_clear_buffer(ctx, buff); } DICT_SETITEM_DROP(span, dictkey_origin, JM_py_from_point(span_origin)); DICT_SETITEM_DROP(span, dictkey_bbox, JM_py_from_rect(span_rect)); if (!fz_is_empty_rect(span_rect)) { LIST_APPEND_DROP(span_list, span); line_rect = fz_union_rect(line_rect, span_rect); } else { Py_DECREF(span); } span = NULL; } if (!fz_is_empty_rect(line_rect)) { DICT_SETITEM_DROP(line_dict, dictkey_spans, span_list); } else { DICT_SETITEM_DROP(line_dict, dictkey_spans, span_list); } return line_rect; } static void JM_make_image_block(fz_context *ctx, fz_stext_block *block, PyObject *block_dict) { fz_image *image = block->u.i.image; fz_buffer *buf = NULL, *freebuf = NULL; fz_compressed_buffer *buffer = fz_compressed_image_buffer(ctx, image); fz_var(buf); fz_var(freebuf); int n = fz_colorspace_n(ctx, image->colorspace); int w = image->w; int h = image->h; const char *ext = NULL; int type = FZ_IMAGE_UNKNOWN; if (buffer) type = buffer->params.type; if (type < FZ_IMAGE_BMP || type == FZ_IMAGE_JBIG2) type = FZ_IMAGE_UNKNOWN; PyObject *bytes = NULL; fz_var(bytes); fz_try(ctx) { if (buffer && type != FZ_IMAGE_UNKNOWN) { buf = buffer->buffer; ext = JM_image_extension(type); } else { buf = freebuf = fz_new_buffer_from_image_as_png(ctx, image, fz_default_color_params); ext = "png"; } bytes = JM_BinFromBuffer(ctx, buf); } fz_always(ctx) { if (!bytes) bytes = JM_BinFromChar(""); DICT_SETITEM_DROP(block_dict, dictkey_width, Py_BuildValue("i", w)); DICT_SETITEM_DROP(block_dict, dictkey_height, Py_BuildValue("i", h)); DICT_SETITEM_DROP(block_dict, dictkey_ext, Py_BuildValue("s", ext)); DICT_SETITEM_DROP(block_dict, dictkey_colorspace, Py_BuildValue("i", n)); DICT_SETITEM_DROP(block_dict, dictkey_xres, Py_BuildValue("i", image->xres)); DICT_SETITEM_DROP(block_dict, dictkey_yres, Py_BuildValue("i", image->xres)); DICT_SETITEM_DROP(block_dict, dictkey_bpc, Py_BuildValue("i", (int) image->bpc)); DICT_SETITEM_DROP(block_dict, dictkey_matrix, JM_py_from_matrix(block->u.i.transform)); DICT_SETITEM_DROP(block_dict, dictkey_size, Py_BuildValue("n", PyBytes_Size(bytes))); DICT_SETITEM_DROP(block_dict, dictkey_image, bytes); fz_drop_buffer(ctx, freebuf); } fz_catch(ctx) {;} return; } static void JM_make_text_block(fz_context *ctx, fz_stext_block *block, PyObject *block_dict, int raw, fz_buffer *buff, fz_rect tp_rect) { fz_stext_line *line; PyObject *line_list = PyList_New(0), *line_dict; fz_rect block_rect = fz_empty_rect; for (line = block->u.t.first_line; line; line = line->next) { if (fz_is_empty_rect(fz_intersect_rect(tp_rect, line->bbox)) && !fz_is_infinite_rect(tp_rect)) { continue; } line_dict = PyDict_New(); fz_rect line_rect = JM_make_spanlist(ctx, line_dict, line, raw, buff, tp_rect); block_rect = fz_union_rect(block_rect, line_rect); DICT_SETITEM_DROP(line_dict, dictkey_wmode, Py_BuildValue("i", line->wmode)); DICT_SETITEM_DROP(line_dict, dictkey_dir, JM_py_from_point(line->dir)); DICT_SETITEM_DROP(line_dict, dictkey_bbox, JM_py_from_rect(line_rect)); LIST_APPEND_DROP(line_list, line_dict); } DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block_rect)); DICT_SETITEM_DROP(block_dict, dictkey_lines, line_list); return; } void JM_make_textpage_dict(fz_context *ctx, fz_stext_page *tp, PyObject *page_dict, int raw) { fz_stext_block *block; fz_buffer *text_buffer = fz_new_buffer(ctx, 128); PyObject *block_dict, *block_list = PyList_New(0); fz_rect tp_rect = tp->mediabox; int block_n = -1; for (block = tp->first_block; block; block = block->next) { block_n++; if (!fz_contains_rect(tp_rect, block->bbox) && !fz_is_infinite_rect(tp_rect) && block->type == FZ_STEXT_BLOCK_IMAGE) { continue; } if (!fz_is_infinite_rect(tp_rect) && fz_is_empty_rect(fz_intersect_rect(tp_rect, block->bbox))) { continue; } block_dict = PyDict_New(); DICT_SETITEM_DROP(block_dict, dictkey_number, Py_BuildValue("i", block_n)); DICT_SETITEM_DROP(block_dict, dictkey_type, Py_BuildValue("i", block->type)); if (block->type == FZ_STEXT_BLOCK_IMAGE) { DICT_SETITEM_DROP(block_dict, dictkey_bbox, JM_py_from_rect(block->bbox)); JM_make_image_block(ctx, block, block_dict); } else { JM_make_text_block(ctx, block, block_dict, raw, text_buffer, tp_rect); } LIST_APPEND_DROP(block_list, block_dict); } DICT_SETITEM_DROP(page_dict, dictkey_blocks, block_list); fz_drop_buffer(ctx, text_buffer); } //--------------------------------------------------------------------- PyObject * JM_copy_rectangle(fz_context *ctx, fz_stext_page *page, fz_rect area) { fz_stext_block *block; fz_stext_line *line; fz_stext_char *ch; fz_buffer *buffer; int need_new_line = 0; PyObject *rc = NULL; fz_try(ctx) { buffer = fz_new_buffer(ctx, 1024); for (block = page->first_block; block; block = block->next) { if (block->type != FZ_STEXT_BLOCK_TEXT) continue; for (line = block->u.t.first_line; line; line = line->next) { int line_had_text = 0; for (ch = line->first_char; ch; ch = ch->next) { fz_rect r = JM_char_bbox(ctx, line, ch); if (JM_rects_overlap(area, r)) { line_had_text = 1; if (need_new_line) { fz_append_string(ctx, buffer, "\n"); need_new_line = 0; } JM_append_rune(ctx, buffer, ch->c); } } if (line_had_text) need_new_line = 1; } } fz_terminate_buffer(ctx, buffer); rc = JM_EscapeStrFromBuffer(ctx, buffer); if (!rc) { rc = EMPTY_STRING; PyErr_Clear(); } } fz_always(ctx) { fz_drop_buffer(ctx, buffer); } fz_catch(ctx) { fz_rethrow(ctx); } return rc; } //--------------------------------------------------------------------- fz_buffer *JM_object_to_buffer(fz_context *ctx, pdf_obj *what, int compress, int ascii) { fz_buffer *res=NULL; fz_output *out=NULL; fz_try(ctx) { res = fz_new_buffer(ctx, 512); out = fz_new_output_with_buffer(ctx, res); pdf_print_obj(ctx, out, what, compress, ascii); } fz_always(ctx) { fz_drop_output(ctx, out); } fz_catch(ctx) { fz_rethrow(ctx); } fz_terminate_buffer(ctx, res); return res; } //----------------------------------------------------------------------------- // Merge the /Resources object created by a text pdf device into the page. // The device may have created multiple /ExtGState/Alp? and /Font/F? objects. // These need to be renamed (renumbered) to not overwrite existing page // objects from previous executions. // Returns the next available numbers n, m for objects /Alp, /F. //----------------------------------------------------------------------------- PyObject *JM_merge_resources(fz_context *ctx, pdf_page *page, pdf_obj *temp_res) { // page objects /Resources, /Resources/ExtGState, /Resources/Font pdf_obj *resources = pdf_dict_get(ctx, page->obj, PDF_NAME(Resources)); pdf_obj *main_extg = pdf_dict_get(ctx, resources, PDF_NAME(ExtGState)); pdf_obj *main_fonts = pdf_dict_get(ctx, resources, PDF_NAME(Font)); // text pdf device objects /ExtGState, /Font pdf_obj *temp_extg = pdf_dict_get(ctx, temp_res, PDF_NAME(ExtGState)); pdf_obj *temp_fonts = pdf_dict_get(ctx, temp_res, PDF_NAME(Font)); int max_alp = -1, max_fonts = -1, i, n; char text[20]; // Handle /Alp objects if (pdf_is_dict(ctx, temp_extg)) // any created at all? { n = pdf_dict_len(ctx, temp_extg); if (pdf_is_dict(ctx, main_extg)) { // does page have /ExtGState yet? for (i = 0; i < pdf_dict_len(ctx, main_extg); i++) { // get highest number of objects named /Alpxxx char *alp = (char *) pdf_to_name(ctx, pdf_dict_get_key(ctx, main_extg, i)); if (strncmp(alp, "Alp", 3) != 0) continue; int j = fz_atoi(alp + 3); if (j > max_alp) max_alp = j; } } else // create a /ExtGState for the page main_extg = pdf_dict_put_dict(ctx, resources, PDF_NAME(ExtGState), n); max_alp += 1; for (i = 0; i < n; i++) // copy over renumbered /Alp objects { char *alp = (char *) pdf_to_name(ctx, pdf_dict_get_key(ctx, temp_extg, i)); int j = fz_atoi(alp + 3) + max_alp; fz_snprintf(text, sizeof(text), "Alp%d", j); // new name pdf_obj *val = pdf_dict_get_val(ctx, temp_extg, i); pdf_dict_puts(ctx, main_extg, text, val); } } if (pdf_is_dict(ctx, main_fonts)) { // has page any fonts yet? for (i = 0; i < pdf_dict_len(ctx, main_fonts); i++) { // get max font number char *font = (char *) pdf_to_name(ctx, pdf_dict_get_key(ctx, main_fonts, i)); if (strncmp(font, "F", 1) != 0) continue; int j = fz_atoi(font + 1); if (j > max_fonts) max_fonts = j; } } else // create a Resources/Font for the page main_fonts = pdf_dict_put_dict(ctx, resources, PDF_NAME(Font), 2); max_fonts += 1; for (i = 0; i < pdf_dict_len(ctx, temp_fonts); i++) { // copy renumbered fonts char *font = (char *) pdf_to_name(ctx, pdf_dict_get_key(ctx, temp_fonts, i)); int j = fz_atoi(font + 1) + max_fonts; fz_snprintf(text, sizeof(text), "F%d", j); pdf_obj *val = pdf_dict_get_val(ctx, temp_fonts, i); pdf_dict_puts(ctx, main_fonts, text, val); } return Py_BuildValue("ii", max_alp, max_fonts); // next available numbers } //----------------------------------------------------------------------------- // version of fz_show_string, which covers SMALL CAPS //----------------------------------------------------------------------------- fz_matrix JM_show_string_cs(fz_context *ctx, fz_text *text, fz_font *user_font, fz_matrix trm, const char *s, int wmode, int bidi_level, fz_bidi_direction markup_dir, fz_text_language language) { fz_font *font=NULL; int gid, ucs; float adv; while (*s) { s += fz_chartorune(&ucs, s); gid = fz_encode_character_sc(ctx, user_font, ucs); if (gid == 0) { gid = fz_encode_character_with_fallback(ctx, user_font, ucs, 0, language, &font); } else { font = user_font; } fz_show_glyph(ctx, text, font, trm, gid, ucs, wmode, bidi_level, markup_dir, language); adv = fz_advance_glyph(ctx, font, gid, wmode); if (wmode == 0) trm = fz_pre_translate(trm, adv, 0); else trm = fz_pre_translate(trm, 0, -adv); } return trm; } //----------------------------------------------------------------------------- // version of fz_show_string, which also covers UCDN script //----------------------------------------------------------------------------- fz_matrix JM_show_string(fz_context *ctx, fz_text *text, fz_font *user_font, fz_matrix trm, const char *s, int wmode, int bidi_level, fz_bidi_direction markup_dir, fz_text_language language, int script) { fz_font *font; int gid, ucs; float adv; while (*s) { s += fz_chartorune(&ucs, s); gid = fz_encode_character_with_fallback(ctx, user_font, ucs, script, language, &font); fz_show_glyph(ctx, text, font, trm, gid, ucs, wmode, bidi_level, markup_dir, language); adv = fz_advance_glyph(ctx, font, gid, wmode); if (wmode == 0) trm = fz_pre_translate(trm, adv, 0); else trm = fz_pre_translate(trm, 0, -adv); } return trm; } //----------------------------------------------------------------------------- // return a fz_font from a number of parameters //----------------------------------------------------------------------------- fz_font *JM_get_font(fz_context *ctx, char *fontname, char *fontfile, PyObject *fontbuffer, int script, int lang, int ordering, int is_bold, int is_italic, int is_serif, int embed) { const unsigned char *data = NULL; int size, index=0; fz_buffer *res = NULL; fz_font *font = NULL; fz_try(ctx) { if (fontfile) goto have_file; if (EXISTS(fontbuffer)) goto have_buffer; if (ordering > -1) goto have_cjk; if (fontname) goto have_base14; goto have_noto; // Base-14 or a MuPDF builtin font have_base14:; font = fz_new_base14_font(ctx, fontname); if (font) { goto fertig; } font = fz_new_builtin_font(ctx, fontname, is_bold, is_italic); goto fertig; // CJK font have_cjk:; font = fz_new_cjk_font(ctx, ordering); goto fertig; // fontfile have_file:; font = fz_new_font_from_file(ctx, NULL, fontfile, index, 0); goto fertig; // fontbuffer have_buffer:; res = JM_BufferFromBytes(ctx, fontbuffer); font = fz_new_font_from_buffer(ctx, NULL, res, index, 0); goto fertig; // Check for NOTO font have_noto:; data = fz_lookup_noto_font(ctx, script, lang, &size, &index); if (data) font = fz_new_font_from_memory(ctx, NULL, data, size, index, 0); if (font) goto fertig; font = fz_load_fallback_font(ctx, script, lang, is_serif, is_bold, is_italic); goto fertig; fertig:; if (!font) { RAISEPY(ctx, MSG_FONT_FAILED, PyExc_RuntimeError); } #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 // if font allows this, set embedding if (!font->flags.never_embed) { fz_set_font_embedding(ctx, font, embed); } #endif } fz_always(ctx) { fz_drop_buffer(ctx, res); } fz_catch(ctx) { fz_rethrow(ctx); } return font; } %} ================================================ FILE: src_classic/helper-xobject.i ================================================ %{ /* # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ */ //----------------------------------------------------------------------------- // Read and concatenate a PDF page's /Conents object(s) in a buffer //----------------------------------------------------------------------------- fz_buffer *JM_read_contents(fz_context * ctx, pdf_obj * pageref) { fz_buffer *res = NULL, *nres = NULL; int i; fz_try(ctx) { pdf_obj *contents = pdf_dict_get(ctx, pageref, PDF_NAME(Contents)); if (pdf_is_array(ctx, contents)) { res = fz_new_buffer(ctx, 1024); for (i = 0; i < pdf_array_len(ctx, contents); i++) { nres = pdf_load_stream(ctx, pdf_array_get(ctx, contents, i)); fz_append_buffer(ctx, res, nres); fz_drop_buffer(ctx, nres); } } else if (contents) { res = pdf_load_stream(ctx, contents); } } fz_catch(ctx) { fz_rethrow(ctx); } return res; } //----------------------------------------------------------------------------- // Make an XObject from a PDF page // For a positive xref assume that its object can be used instead //----------------------------------------------------------------------------- pdf_obj *JM_xobject_from_page(fz_context * ctx, pdf_document * pdfout, fz_page * fsrcpage, int xref, pdf_graft_map *gmap) { pdf_obj *xobj1, *resources = NULL, *o, *spageref; fz_try(ctx) { if (xref > 0) { xobj1 = pdf_new_indirect(ctx, pdfout, xref, 0); } else { fz_buffer *res = NULL; fz_rect mediabox; pdf_page *srcpage = pdf_page_from_fz_page(ctx, fsrcpage); spageref = srcpage->obj; mediabox = pdf_to_rect(ctx, pdf_dict_get_inheritable(ctx, spageref, PDF_NAME(MediaBox))); // Deep-copy resources object of source page o = pdf_dict_get_inheritable(ctx, spageref, PDF_NAME(Resources)); if (gmap) // use graftmap when possible resources = pdf_graft_mapped_object(ctx, gmap, o); else resources = pdf_graft_object(ctx, pdfout, o); // get spgage contents source res = JM_read_contents(ctx, spageref); //------------------------------------------------------------- // create XObject representing the source page //------------------------------------------------------------- xobj1 = pdf_new_xobject(ctx, pdfout, mediabox, fz_identity, NULL, res); // store spage contents JM_update_stream(ctx, pdfout, xobj1, res, 1); fz_drop_buffer(ctx, res); // store spage resources pdf_dict_put_drop(ctx, xobj1, PDF_NAME(Resources), resources); } } fz_catch(ctx) { fz_rethrow(ctx); } return xobj1; } //----------------------------------------------------------------------------- // Insert a buffer as a new separate /Contents object of a page. // 1. Create a new stream object from buffer 'newcont' // 2. If /Contents already is an array, then just prepend or append this object // 3. Else, create new array and put old content obj and this object into it. // If the page had no /Contents before, just create a 1-item array. //----------------------------------------------------------------------------- int JM_insert_contents(fz_context * ctx, pdf_document * pdf, pdf_obj * pageref, fz_buffer * newcont, int overlay) { int xref = 0; pdf_obj *newconts = NULL; pdf_obj *carr = NULL; fz_var(newconts); fz_var(carr); fz_try(ctx) { pdf_obj *contents = pdf_dict_get(ctx, pageref, PDF_NAME(Contents)); newconts = pdf_add_stream(ctx, pdf, newcont, NULL, 0); xref = pdf_to_num(ctx, newconts); if (pdf_is_array(ctx, contents)) { if (overlay) // append new object pdf_array_push(ctx, contents, newconts); else // prepend new object pdf_array_insert(ctx, contents, newconts, 0); } else { carr = pdf_new_array(ctx, pdf, 5); if (overlay) { if (contents) pdf_array_push(ctx, carr, contents); pdf_array_push(ctx, carr, newconts); } else { pdf_array_push(ctx, carr, newconts); if (contents) pdf_array_push(ctx, carr, contents); } pdf_dict_put(ctx, pageref, PDF_NAME(Contents), carr); } } fz_always(ctx) { pdf_drop_obj(ctx, newconts); pdf_drop_obj(ctx, carr); } fz_catch(ctx) { fz_rethrow(ctx); } return xref; } static void show(const char* prefix, PyObject* obj) { if (!obj) { printf( "%s \n", prefix); return; } PyObject* obj_repr = PyObject_Repr( obj); PyObject* obj_repr_u = PyUnicode_AsEncodedString( obj_repr, "utf-8", "~E~"); const char* obj_repr_s = PyString_AsString( obj_repr_u); printf( "%s%s\n", prefix, obj_repr_s); fflush(stdout); } static PyObject *g_img_info = NULL; static fz_matrix g_img_info_matrix = {0}; static fz_image * JM_image_filter(fz_context *ctx, void *opaque, fz_matrix ctm, const char *name, fz_image *image) { fz_quad q = fz_transform_quad(fz_quad_from_rect(fz_unit_rect), ctm); #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 q = fz_transform_quad( q, g_img_info_matrix); #endif PyObject *temp = Py_BuildValue("sN", name, JM_py_from_quad(q)); LIST_APPEND_DROP(g_img_info, temp); return image; } #if FZ_VERSION_MAJOR == 1 && FZ_VERSION_MINOR >= 22 static PyObject * JM_image_reporter(fz_context *ctx, pdf_page *page) { pdf_document *doc = page->doc; pdf_page_transform(ctx, page, NULL, &g_img_info_matrix); pdf_filter_options filter_options = {0}; filter_options.recurse = 0; filter_options.instance_forms = 1; filter_options.ascii = 1; filter_options.no_update = 1; pdf_sanitize_filter_options sanitize_filter_options = {0}; sanitize_filter_options.opaque = page; sanitize_filter_options.image_filter = JM_image_filter; pdf_filter_factory filter_factory[2] = {0}; filter_factory[0].filter = pdf_new_sanitize_filter; filter_factory[0].options = &sanitize_filter_options; filter_options.filters = filter_factory; // was & g_img_info = PyList_New(0); pdf_filter_page_contents(ctx, doc, page, &filter_options); PyObject *rc = PySequence_Tuple(g_img_info); Py_CLEAR(g_img_info); return rc; } #else void JM_filter_content_stream( fz_context * ctx, pdf_document * doc, pdf_obj * in_stm, pdf_obj * in_res, fz_matrix transform, pdf_filter_options * filter, int struct_parents, fz_buffer **out_buf, pdf_obj **out_res) { pdf_processor *proc_buffer = NULL; pdf_processor *proc_filter = NULL; fz_var(proc_buffer); fz_var(proc_filter); *out_buf = NULL; *out_res = NULL; fz_try(ctx) { *out_buf = fz_new_buffer(ctx, 1024); proc_buffer = pdf_new_buffer_processor(ctx, *out_buf, filter->ascii); if (filter->sanitize) { *out_res = pdf_new_dict(ctx, doc, 1); proc_filter = pdf_new_filter_processor(ctx, doc, proc_buffer, in_res, *out_res, struct_parents, transform, filter); pdf_process_contents(ctx, proc_filter, doc, in_res, in_stm, NULL); pdf_close_processor(ctx, proc_filter); } else { *out_res = pdf_keep_obj(ctx, in_res); pdf_process_contents(ctx, proc_buffer, doc, in_res, in_stm, NULL); } pdf_close_processor(ctx, proc_buffer); } fz_always(ctx) { pdf_drop_processor(ctx, proc_filter); pdf_drop_processor(ctx, proc_buffer); } fz_catch(ctx) { fz_drop_buffer(ctx, *out_buf); *out_buf = NULL; pdf_drop_obj(ctx, *out_res); *out_res = NULL; fz_rethrow(ctx); } } PyObject * JM_image_reporter(fz_context *ctx, pdf_page *page) { pdf_document *doc = page->doc; pdf_filter_options filter; memset(&filter, 0, sizeof filter); filter.opaque = page; filter.text_filter = NULL; filter.image_filter = JM_image_filter; filter.end_page = NULL; filter.recurse = 0; filter.instance_forms = 1; filter.sanitize = 1; filter.ascii = 1; pdf_obj *contents, *old_res; pdf_obj *struct_parents_obj; pdf_obj *new_res; fz_buffer *buffer; int struct_parents; fz_matrix ctm = fz_identity; pdf_page_transform(ctx, page, NULL, &ctm); struct_parents_obj = pdf_dict_get(ctx, page->obj, PDF_NAME(StructParents)); struct_parents = -1; if (pdf_is_number(ctx, struct_parents_obj)) struct_parents = pdf_to_int(ctx, struct_parents_obj); contents = pdf_page_contents(ctx, page); old_res = pdf_page_resources(ctx, page); g_img_info = PyList_New(0); JM_filter_content_stream(ctx, doc, contents, old_res, ctm, &filter, struct_parents, &buffer, &new_res); fz_drop_buffer(ctx, buffer); pdf_drop_obj(ctx, new_res); PyObject *rc = PySequence_Tuple(g_img_info); Py_CLEAR(g_img_info); return rc; } #endif %} ================================================ FILE: src_classic/utils.py ================================================ # ------------------------------------------------------------------------ # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html # # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is # maintained and developed by Artifex Software, Inc. https://artifex.com. # ------------------------------------------------------------------------ import io import json import math import os import random import string import tempfile import typing import warnings from fitz_old import * TESSDATA_PREFIX = os.getenv("TESSDATA_PREFIX") point_like = "point_like" rect_like = "rect_like" matrix_like = "matrix_like" quad_like = "quad_like" # ByteString is gone from typing in 3.14. # collections.abc.Buffer available from 3.12 only try: ByteString = typing.ByteString except AttributeError: ByteString = bytes | bytearray | memoryview AnyType = typing.Any OptInt = typing.Union[int, None] OptFloat = typing.Optional[float] OptStr = typing.Optional[str] OptDict = typing.Optional[dict] OptBytes = typing.Optional[ByteString] OptSeq = typing.Optional[typing.Sequence] """ This is a collection of functions to extend PyMupdf. """ def write_text(page: Page, **kwargs) -> None: """Write the text of one or more TextWriter objects. Args: rect: target rectangle. If None, the union of the text writers is used. writers: one or more TextWriter objects. overlay: put in foreground or background. keep_proportion: maintain aspect ratio of rectangle sides. rotate: arbitrary rotation angle. oc: the xref of an optional content object """ if type(page) is not Page: raise ValueError("bad page parameter") s = { k for k in kwargs.keys() if k not in { "rect", "writers", "opacity", "color", "overlay", "keep_proportion", "rotate", "oc", } } if s != set(): raise ValueError("bad keywords: " + str(s)) rect = kwargs.get("rect") writers = kwargs.get("writers") opacity = kwargs.get("opacity") color = kwargs.get("color") overlay = bool(kwargs.get("overlay", True)) keep_proportion = bool(kwargs.get("keep_proportion", True)) rotate = int(kwargs.get("rotate", 0)) oc = int(kwargs.get("oc", 0)) if not writers: raise ValueError("need at least one TextWriter") if type(writers) is TextWriter: if rotate == 0 and rect is None: writers.write_text(page, opacity=opacity, color=color, overlay=overlay) return None else: writers = (writers,) clip = writers[0].text_rect textdoc = Document() tpage = textdoc.new_page(width=page.rect.width, height=page.rect.height) for writer in writers: clip |= writer.text_rect writer.write_text(tpage, opacity=opacity, color=color) if rect is None: rect = clip page.show_pdf_page( rect, textdoc, 0, overlay=overlay, keep_proportion=keep_proportion, rotate=rotate, clip=clip, oc=oc, ) textdoc = None tpage = None def show_pdf_page(*args, **kwargs) -> int: """Show page number 'pno' of PDF 'src' in rectangle 'rect'. Args: rect: (rect-like) where to place the source image src: (document) source PDF pno: (int) source page number overlay: (bool) put in foreground keep_proportion: (bool) do not change width-height-ratio rotate: (int) degrees (multiple of 90) clip: (rect-like) part of source page rectangle Returns: xref of inserted object (for reuse) """ if len(args) not in (3, 4): raise ValueError("bad number of positional parameters") pno = None if len(args) == 3: page, rect, src = args else: page, rect, src, pno = args if pno == None: pno = int(kwargs.get("pno", 0)) overlay = bool(kwargs.get("overlay", True)) keep_proportion = bool(kwargs.get("keep_proportion", True)) rotate = float(kwargs.get("rotate", 0)) oc = int(kwargs.get("oc", 0)) clip = kwargs.get("clip") def calc_matrix(sr, tr, keep=True, rotate=0): """Calculate transformation matrix from source to target rect. Notes: The product of four matrices in this sequence: (1) translate correct source corner to origin, (2) rotate, (3) scale, (4) translate to target's top-left corner. Args: sr: source rect in PDF (!) coordinate system tr: target rect in PDF coordinate system keep: whether to keep source ratio of width to height rotate: rotation angle in degrees Returns: Transformation matrix. """ # calc center point of source rect smp = (sr.tl + sr.br) / 2.0 # calc center point of target rect tmp = (tr.tl + tr.br) / 2.0 # m moves to (0, 0), then rotates m = Matrix(1, 0, 0, 1, -smp.x, -smp.y) * Matrix(rotate) sr1 = sr * m # resulting source rect to calculate scale factors fw = tr.width / sr1.width # scale the width fh = tr.height / sr1.height # scale the height if keep: fw = fh = min(fw, fh) # take min if keeping aspect ratio m *= Matrix(fw, fh) # concat scale matrix m *= Matrix(1, 0, 0, 1, tmp.x, tmp.y) # concat move to target center return JM_TUPLE(m) CheckParent(page) doc = page.parent if not doc.is_pdf or not src.is_pdf: raise ValueError("is no PDF") if rect.is_empty or rect.is_infinite: raise ValueError("rect must be finite and not empty") while pno < 0: # support negative page numbers pno += src.page_count src_page = src[pno] # load source page if src_page.get_contents() == []: raise ValueError("nothing to show - source page empty") tar_rect = rect * ~page.transformation_matrix # target rect in PDF coordinates src_rect = src_page.rect if not clip else src_page.rect & clip # source rect if src_rect.is_empty or src_rect.is_infinite: raise ValueError("clip must be finite and not empty") src_rect = src_rect * ~src_page.transformation_matrix # ... in PDF coord matrix = calc_matrix(src_rect, tar_rect, keep=keep_proportion, rotate=rotate) # list of existing /Form /XObjects ilst = [i[1] for i in doc.get_page_xobjects(page.number)] ilst += [i[7] for i in doc.get_page_images(page.number)] ilst += [i[4] for i in doc.get_page_fonts(page.number)] # create a name not in that list n = "fzFrm" i = 0 _imgname = n + "0" while _imgname in ilst: i += 1 _imgname = n + str(i) isrc = src._graft_id # used as key for graftmaps if doc._graft_id == isrc: raise ValueError("source document must not equal target") # retrieve / make Graftmap for source PDF gmap = doc.Graftmaps.get(isrc, None) if gmap is None: gmap = Graftmap(doc) doc.Graftmaps[isrc] = gmap # take note of generated xref for automatic reuse pno_id = (isrc, pno) # id of src[pno] xref = doc.ShownPages.get(pno_id, 0) xref = page._show_pdf_page( src_page, overlay=overlay, matrix=matrix, xref=xref, oc=oc, clip=src_rect, graftmap=gmap, _imgname=_imgname, ) doc.ShownPages[pno_id] = xref return xref def replace_image(page: Page, xref: int, *, filename=None, pixmap=None, stream=None): """Replace the image referred to by xref. Replace the image by changing the object definition stored under xref. This will leave the pages appearance instructions intact, so the new image is being displayed with the same bbox, rotation etc. By providing a small fully transparent image, an effect as if the image had been deleted can be achieved. A typical use may include replacing large images by a smaller version, e.g. with a lower resolution or graylevel instead of colored. Args: xref: the xref of the image to replace. filename, pixmap, stream: exactly one of these must be provided. The meaning being the same as in Page.insert_image. """ doc = page.parent # the owning document if not doc.xref_is_image(xref): raise ValueError("xref not an image") # insert new image anywhere in page if bool(filename) + bool(stream) + bool(pixmap) != 1: raise ValueError("Exactly one of filename/stream/pixmap must be given") new_xref = page.insert_image( page.rect, filename=filename, stream=stream, pixmap=pixmap ) doc.xref_copy(new_xref, xref) # copy over new to old last_contents_xref = page.get_contents()[-1] # new image insertion has created a new /Contents source, # which we will set to spaces now doc.update_stream(last_contents_xref, b" ") def delete_image(page: Page, xref: int): """Delete the image referred to by xef. Actually replaces by a small transparent Pixmap using method Page.replace_image. Args: xref: xref of the image to delete. """ # make a small 100% transparent pixmap (of just any dimension) pix = fitz_old.Pixmap(fitz_old.csGRAY, (0, 0, 1, 1), 1) pix.clear_with() # clear all samples bytes to 0x00 page.replace_image(xref, pixmap=pix) def insert_image(page, rect, **kwargs): """Insert an image for display in a rectangle. Args: rect: (rect_like) position of image on the page. alpha: (int, optional) set to 0 if image has no transparency. filename: (str, Path, file object) image filename. keep_proportion: (bool) keep width / height ratio (default). mask: (bytes, optional) image consisting of alpha values to use. oc: (int) xref of OCG or OCMD to declare as Optional Content. overlay: (bool) put in foreground (default) or background. pixmap: (Pixmap) use this as image. rotate: (int) rotate by 0, 90, 180 or 270 degrees. stream: (bytes) use this as image. xref: (int) use this as image. 'page' and 'rect' are positional, all other parameters are keywords. If 'xref' is given, that image is used. Other input options are ignored. Else, exactly one of pixmap, stream or filename must be given. 'alpha=0' for non-transparent images improves performance significantly. Affects stream and filename only. Optimum transparent insertions are possible by using filename / stream in conjunction with a 'mask' image of alpha values. Returns: xref (int) of inserted image. Re-use as argument for multiple insertions. """ CheckParent(page) doc = page.parent if not doc.is_pdf: raise ValueError("is no PDF") valid_keys = { "alpha", "filename", "height", "keep_proportion", "mask", "oc", "overlay", "pixmap", "rotate", "stream", "width", "xref", } s = set(kwargs.keys()).difference(valid_keys) if s != set(): raise ValueError(f"bad key argument(s): {s}.") filename = kwargs.get("filename") pixmap = kwargs.get("pixmap") stream = kwargs.get("stream") mask = kwargs.get("mask") rotate = int(kwargs.get("rotate", 0)) width = int(kwargs.get("width", 0)) height = int(kwargs.get("height", 0)) alpha = int(kwargs.get("alpha", -1)) oc = int(kwargs.get("oc", 0)) xref = int(kwargs.get("xref", 0)) keep_proportion = bool(kwargs.get("keep_proportion", True)) overlay = bool(kwargs.get("overlay", True)) if xref == 0 and (bool(filename) + bool(stream) + bool(pixmap) != 1): raise ValueError("xref=0 needs exactly one of filename, pixmap, stream") if filename: if type(filename) is str: pass elif hasattr(filename, "absolute"): filename = str(filename) elif hasattr(filename, "name"): filename = filename.name else: raise ValueError("bad filename") if filename and not os.path.exists(filename): raise FileNotFoundError("No such file: '%s'" % filename) elif stream and type(stream) not in (bytes, bytearray, io.BytesIO): raise ValueError("stream must be bytes-like / BytesIO") elif pixmap and type(pixmap) is not Pixmap: raise ValueError("pixmap must be a Pixmap") if mask and not (stream or filename): raise ValueError("mask requires stream or filename") if mask and type(mask) not in (bytes, bytearray, io.BytesIO): raise ValueError("mask must be bytes-like / BytesIO") while rotate < 0: rotate += 360 while rotate >= 360: rotate -= 360 if rotate not in (0, 90, 180, 270): raise ValueError("bad rotate value") r = Rect(rect) if r.is_empty or r.is_infinite: raise ValueError("rect must be finite and not empty") clip = r * ~page.transformation_matrix # Create a unique image reference name. ilst = [i[7] for i in doc.get_page_images(page.number)] ilst += [i[1] for i in doc.get_page_xobjects(page.number)] ilst += [i[4] for i in doc.get_page_fonts(page.number)] n = "fzImg" # 'fitz image' i = 0 _imgname = n + "0" # first name candidate while _imgname in ilst: i += 1 _imgname = n + str(i) # try new name digests = doc.InsertedImages xref, digests = page._insert_image( filename=filename, pixmap=pixmap, stream=stream, imask=mask, clip=clip, overlay=overlay, oc=oc, xref=xref, rotate=rotate, keep_proportion=keep_proportion, width=width, height=height, alpha=alpha, _imgname=_imgname, digests=digests, ) if digests != None: doc.InsertedImages = digests return xref def search_for(*args, **kwargs) -> list: """Search for a string on a page. Args: text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: a pre-created TextPage Returns: a list of rectangles or quads, each containing one occurrence. """ if len(args) != 2: raise ValueError("bad number of positional parameters") page, text = args quads = kwargs.get("quads", 0) clip = kwargs.get("clip") textpage = kwargs.get("textpage") if clip != None: clip = Rect(clip) flags = kwargs.get( "flags", TEXT_DEHYPHENATE | TEXT_PRESERVE_WHITESPACE | TEXT_PRESERVE_LIGATURES | TEXT_MEDIABOX_CLIP, ) CheckParent(page) tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) # create TextPage elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rlist = tp.search(text, quads=quads) if textpage is None: del tp return rlist def search_page_for( doc: Document, pno: int, text: str, quads: bool = False, clip: rect_like = None, flags: int = TEXT_DEHYPHENATE | TEXT_PRESERVE_LIGATURES | TEXT_PRESERVE_WHITESPACE | TEXT_MEDIABOX_CLIP, textpage: TextPage = None, ) -> list: """Search for a string on a page. Args: pno: page number text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: reuse a prepared textpage Returns: a list of rectangles or quads, each containing an occurrence. """ return doc[pno].search_for( text, quads=quads, clip=clip, flags=flags, textpage=textpage, ) def get_text_blocks( page: Page, clip: rect_like = None, flags: OptInt = None, textpage: TextPage = None, sort: bool = False, ) -> list: """Return the text blocks on a page. Notes: Lines in a block are concatenated with line breaks. Args: flags: (int) control the amount of data parsed into the textpage. Returns: A list of the blocks. Each item contains the containing rectangle coordinates, text lines, block type and running block number. """ CheckParent(page) if flags is None: flags = ( TEXT_PRESERVE_WHITESPACE | TEXT_PRESERVE_IMAGES | TEXT_PRESERVE_LIGATURES | TEXT_MEDIABOX_CLIP ) tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") blocks = tp.extractBLOCKS() if textpage is None: del tp if sort is True: blocks.sort(key=lambda b: (b[3], b[0])) return blocks def get_text_words( page: Page, clip: rect_like = None, flags: OptInt = None, textpage: TextPage = None, sort: bool = False, delimiters=None, ) -> list: """Return the text words as a list with the bbox for each word. Args: flags: (int) control the amount of data parsed into the textpage. delimiters: (str,list) characters to use as word delimiters Returns: Word tuples (x0, y0, x1, y1, "word", bno, lno, wno). """ CheckParent(page) if flags is None: flags = TEXT_PRESERVE_WHITESPACE | TEXT_PRESERVE_LIGATURES | TEXT_MEDIABOX_CLIP tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") words = tp.extractWORDS(delimiters) if textpage is None: del tp if sort is True: words.sort(key=lambda w: (w[3], w[0])) return words def get_textbox( page: Page, rect: rect_like, textpage: TextPage = None, ) -> str: tp = textpage if tp is None: tp = page.get_textpage() elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rc = tp.extractTextbox(rect) if textpage is None: del tp return rc def get_text_selection( page: Page, p1: point_like, p2: point_like, clip: rect_like = None, textpage: TextPage = None, ): CheckParent(page) tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=TEXT_DEHYPHENATE) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") rc = tp.extractSelection(p1, p2) if textpage is None: del tp return rc def get_textpage_ocr( page: Page, flags: int = 0, language: str = "eng", dpi: int = 72, full: bool = False, tessdata: str = None, ) -> TextPage: """Create a Textpage from combined results of normal and OCR text parsing. Args: flags: (int) control content becoming part of the result. language: (str) specify expected language(s). Deafault is "eng" (English). dpi: (int) resolution in dpi, default 72. full: (bool) whether to OCR the full page image, or only its images (default) """ CheckParent(page) if not os.getenv("TESSDATA_PREFIX") and not tessdata: raise RuntimeError("No OCR support: TESSDATA_PREFIX not set") def full_ocr(page, dpi, language, flags): zoom = dpi / 72 mat = Matrix(zoom, zoom) pix = page.get_pixmap(matrix=mat) ocr_pdf = Document( "pdf", pix.pdfocr_tobytes(compress=False, language=language, tessdata=tessdata), ) ocr_page = ocr_pdf.load_page(0) unzoom = page.rect.width / ocr_page.rect.width ctm = Matrix(unzoom, unzoom) * page.derotation_matrix tpage = ocr_page.get_textpage(flags=flags, matrix=ctm) ocr_pdf.close() pix = None tpage.parent = weakref.proxy(page) return tpage # if OCR for the full page, OCR its pixmap @ desired dpi if full is True: return full_ocr(page, dpi, language, flags) # For partial OCR, make a normal textpage, then extend it with text that # is OCRed from each image. # Because of this, we need the images flag bit set ON. tpage = page.get_textpage(flags=flags) for block in page.get_text("dict", flags=TEXT_PRESERVE_IMAGES)["blocks"]: if block["type"] != 1: # only look at images continue bbox = Rect(block["bbox"]) if bbox.width <= 3 or bbox.height <= 3: # ignore tiny stuff continue try: pix = Pixmap(block["image"]) # get image pixmap if pix.n - pix.alpha != 3: # we need to convert this to RGB! pix = Pixmap(csRGB, pix) if pix.alpha: # must remove alpha channel pix = Pixmap(pix, 0) imgdoc = Document( "pdf", pix.pdfocr_tobytes(language=language, tessdata=tessdata) ) # pdf with OCRed page imgpage = imgdoc.load_page(0) # read image as a page pix = None # compute matrix to transform coordinates back to that of 'page' imgrect = imgpage.rect # page size of image PDF shrink = Matrix(1 / imgrect.width, 1 / imgrect.height) mat = shrink * block["transform"] imgpage.extend_textpage(tpage, flags=0, matrix=mat) imgdoc.close() except RuntimeError: tpage = None print("Falling back to full page OCR") return full_ocr(page, dpi, language, flags) return tpage def get_image_info(page: Page, hashes: bool = False, xrefs: bool = False) -> list: """Extract image information only from a TextPage. Args: hashes: (bool) include MD5 hash for each image. xrefs: (bool) try to find the xref for each image. Sets hashes to true. """ doc = page.parent if xrefs and doc.is_pdf: hashes = True if not doc.is_pdf: xrefs = False imginfo = getattr(page, "_image_info", None) if imginfo and not xrefs: return imginfo if not imginfo: tp = page.get_textpage(flags=TEXT_PRESERVE_IMAGES) imginfo = tp.extractIMGINFO(hashes=hashes) del tp if hashes: page._image_info = imginfo if not xrefs or not doc.is_pdf: return imginfo imglist = page.get_images() digests = {} for item in imglist: xref = item[0] pix = Pixmap(doc, xref) digests[pix.digest] = xref del pix for i in range(len(imginfo)): item = imginfo[i] xref = digests.get(item["digest"], 0) item["xref"] = xref imginfo[i] = item return imginfo def get_image_rects(page: Page, name, transform=False) -> list: """Return list of image positions on a page. Args: name: (str, list, int) image identification. May be reference name, an item of the page's image list or an xref. transform: (bool) whether to also return the transformation matrix. Returns: A list of Rect objects or tuples of (Rect, Matrix) for all image locations on the page. """ if type(name) in (list, tuple): xref = name[0] elif type(name) is int: xref = name else: imglist = [i for i in page.get_images() if i[7] == name] if imglist == []: raise ValueError("bad image name") elif len(imglist) != 1: raise ValueError("multiple image names found") xref = imglist[0][0] pix = Pixmap(page.parent, xref) # make pixmap of the image to compute MD5 digest = pix.digest del pix infos = page.get_image_info(hashes=True) if not transform: bboxes = [Rect(im["bbox"]) for im in infos if im["digest"] == digest] else: bboxes = [ (Rect(im["bbox"]), Matrix(im["transform"])) for im in infos if im["digest"] == digest ] return bboxes def get_text( page: Page, option: str = "text", clip: rect_like = None, flags: OptInt = None, textpage: TextPage = None, sort: bool = False, delimiters=None, ): """Extract text from a page or an annotation. This is a unifying wrapper for various methods of the TextPage class. Args: option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. clip: (rect-like) restrict output to this area. flags: bit switches to e.g. exclude images or decompose ligatures. textpage: reuse this TextPage and make no new one. If specified, 'flags' and 'clip' are ignored. Returns: the output of methods get_text_words / get_text_blocks or TextPage methods extractText, extractHTML, extractDICT, extractJSON, extractRAWDICT, extractXHTML or etractXML respectively. Default and misspelling choice is "text". """ formats = { "text": fitz.TEXTFLAGS_TEXT, "html": fitz.TEXTFLAGS_HTML, "json": fitz.TEXTFLAGS_DICT, "rawjson": fitz.TEXTFLAGS_RAWDICT, "xml": fitz.TEXTFLAGS_XML, "xhtml": fitz.TEXTFLAGS_XHTML, "dict": fitz.TEXTFLAGS_DICT, "rawdict": fitz.TEXTFLAGS_RAWDICT, "words": fitz.TEXTFLAGS_WORDS, "blocks": fitz.TEXTFLAGS_BLOCKS, } option = option.lower() if option not in formats: option = "text" if flags is None: flags = formats[option] if option == "words": return get_text_words( page, clip=clip, flags=flags, textpage=textpage, sort=sort, delimiters=delimiters, ) if option == "blocks": return get_text_blocks( page, clip=clip, flags=flags, textpage=textpage, sort=sort ) CheckParent(page) cb = None if option in ("html", "xml", "xhtml"): # no clipping for MuPDF functions clip = page.cropbox if clip != None: clip = Rect(clip) cb = None elif type(page) is Page: cb = page.cropbox # TextPage with or without images tp = textpage if tp is None: tp = page.get_textpage(clip=clip, flags=flags) elif getattr(tp, "parent") != page: raise ValueError("not a textpage of this page") if option == "json": t = tp.extractJSON(cb=cb, sort=sort) elif option == "rawjson": t = tp.extractRAWJSON(cb=cb, sort=sort) elif option == "dict": t = tp.extractDICT(cb=cb, sort=sort) elif option == "rawdict": t = tp.extractRAWDICT(cb=cb, sort=sort) elif option == "html": t = tp.extractHTML() elif option == "xml": t = tp.extractXML() elif option == "xhtml": t = tp.extractXHTML() else: t = tp.extractText(sort=sort) if textpage is None: del tp return t def get_page_text( doc: Document, pno: int, option: str = "text", clip: rect_like = None, flags: OptInt = None, textpage: TextPage = None, sort: bool = False, ) -> typing.Any: """Extract a document page's text by page number. Notes: Convenience function calling page.get_text(). Args: pno: page number option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. Returns: output from page.TextPage(). """ return doc[pno].get_text(option, clip=clip, flags=flags, sort=sort) def get_pixmap( page: Page, *, matrix: matrix_like = Identity, dpi=None, colorspace: Colorspace = csRGB, clip: rect_like = None, alpha: bool = False, annots: bool = True, ) -> Pixmap: """Create pixmap of page. Keyword args: matrix: Matrix for transformation (default: Identity). dpi: desired dots per inch. If given, matrix is ignored. colorspace: (str/Colorspace) cmyk, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) whether to include alpha channel annots: (bool) whether to also render annotations """ CheckParent(page) if dpi: zoom = dpi / 72 matrix = Matrix(zoom, zoom) if type(colorspace) is str: if colorspace.upper() == "GRAY": colorspace = csGRAY elif colorspace.upper() == "CMYK": colorspace = csCMYK else: colorspace = csRGB if colorspace.n not in (1, 3, 4): raise ValueError("unsupported colorspace") dl = page.get_displaylist(annots=annots) pix = dl.get_pixmap(matrix=matrix, colorspace=colorspace, alpha=alpha, clip=clip) dl = None if dpi: pix.set_dpi(dpi, dpi) return pix def get_page_pixmap( doc: Document, pno: int, *, matrix: matrix_like = Identity, dpi=None, colorspace: Colorspace = csRGB, clip: rect_like = None, alpha: bool = False, annots: bool = True, ) -> Pixmap: """Create pixmap of document page by page number. Notes: Convenience function calling page.get_pixmap. Args: pno: (int) page number matrix: Matrix for transformation (default: Identity). colorspace: (str,Colorspace) rgb, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) include alpha channel annots: (bool) also render annotations """ return doc[pno].get_pixmap( matrix=matrix, dpi=dpi, colorspace=colorspace, clip=clip, alpha=alpha, annots=annots, ) def getLinkDict(ln) -> dict: nl = {"kind": ln.dest.kind, "xref": 0} try: nl["from"] = ln.rect except: pass pnt = Point(0, 0) if ln.dest.flags & LINK_FLAG_L_VALID: pnt.x = ln.dest.lt.x if ln.dest.flags & LINK_FLAG_T_VALID: pnt.y = ln.dest.lt.y if ln.dest.kind == LINK_URI: nl["uri"] = ln.dest.uri elif ln.dest.kind == LINK_GOTO: nl["page"] = ln.dest.page nl["to"] = pnt if ln.dest.flags & LINK_FLAG_R_IS_ZOOM: nl["zoom"] = ln.dest.rb.x else: nl["zoom"] = 0.0 elif ln.dest.kind == LINK_GOTOR: nl["file"] = ln.dest.fileSpec.replace("\\", "/") nl["page"] = ln.dest.page if ln.dest.page < 0: nl["to"] = ln.dest.dest else: nl["to"] = pnt if ln.dest.flags & LINK_FLAG_R_IS_ZOOM: nl["zoom"] = ln.dest.rb.x else: nl["zoom"] = 0.0 elif ln.dest.kind == LINK_LAUNCH: nl["file"] = ln.dest.fileSpec.replace("\\", "/") elif ln.dest.kind == LINK_NAMED: nl["name"] = ln.dest.named else: nl["page"] = ln.dest.page return nl def get_links(page: Page) -> list: """Create a list of all links contained in a PDF page. Notes: see PyMuPDF ducmentation for details. """ CheckParent(page) ln = page.first_link links = [] while ln: nl = getLinkDict(ln) links.append(nl) ln = ln.next if links != [] and page.parent.is_pdf: linkxrefs = [x for x in page.annot_xrefs() if x[1] == PDF_ANNOT_LINK] if len(linkxrefs) == len(links): for i in range(len(linkxrefs)): links[i]["xref"] = linkxrefs[i][0] links[i]["id"] = linkxrefs[i][2] return links def get_toc( doc: Document, simple: bool = True, ) -> list: """Create a table of contents. Args: simple: a bool to control output. Returns a list, where each entry consists of outline level, title, page number and link destination (if simple = False). For details see PyMuPDF's documentation. """ def recurse(olItem, liste, lvl): """Recursively follow the outline item chain and record item information in a list.""" while olItem: if olItem.title: title = olItem.title else: title = " " if not olItem.is_external: if olItem.uri: if olItem.page == -1: resolve = doc.resolve_link(olItem.uri) page = resolve[0] + 1 else: page = olItem.page + 1 else: page = -1 else: page = -1 if not simple: link = getLinkDict(olItem) liste.append([lvl, title, page, link]) else: liste.append([lvl, title, page]) if olItem.down: liste = recurse(olItem.down, liste, lvl + 1) olItem = olItem.next return liste # ensure document is open if doc.is_closed: raise ValueError("document closed") doc.init_doc() olItem = doc.outline if not olItem: return [] lvl = 1 liste = [] toc = recurse(olItem, liste, lvl) if doc.is_pdf and simple is False: doc._extend_toc_items(toc) return toc def del_toc_item( doc: Document, idx: int, ) -> None: """Delete TOC / bookmark item by index.""" xref = doc.get_outline_xrefs()[idx] doc._remove_toc_item(xref) def set_toc_item( doc: Document, idx: int, dest_dict: OptDict = None, kind: OptInt = None, pno: OptInt = None, uri: OptStr = None, title: OptStr = None, to: point_like = None, filename: OptStr = None, zoom: float = 0, ) -> None: """Update TOC item by index. It allows changing the item's title and link destination. Args: idx: (int) desired index of the TOC list, as created by get_toc. dest_dict: (dict) destination dictionary as created by get_toc(False). Outrules all other parameters. If None, the remaining parameters are used to make a dest dictionary. kind: (int) kind of link (LINK_GOTO, etc.). If None, then only the title will be updated. If LINK_NONE, the TOC item will be deleted. pno: (int) page number (1-based like in get_toc). Required if LINK_GOTO. uri: (str) the URL, required if LINK_URI. title: (str) the new title. No change if None. to: (point-like) destination on the target page. If omitted, (72, 36) will be used as taget coordinates. filename: (str) destination filename, required for LINK_GOTOR and LINK_LAUNCH. name: (str) a destination name for LINK_NAMED. zoom: (float) a zoom factor for the target location (LINK_GOTO). """ xref = doc.get_outline_xrefs()[idx] page_xref = 0 if type(dest_dict) is dict: if dest_dict["kind"] == LINK_GOTO: pno = dest_dict["page"] page_xref = doc.page_xref(pno) page_height = doc.page_cropbox(pno).height to = dest_dict.get("to", Point(72, 36)) to.y = page_height - to.y dest_dict["to"] = to action = getDestStr(page_xref, dest_dict) if not action.startswith("/A"): raise ValueError("bad bookmark dest") color = dest_dict.get("color") if color: color = list(map(float, color)) if len(color) != 3 or min(color) < 0 or max(color) > 1: raise ValueError("bad color value") bold = dest_dict.get("bold", False) italic = dest_dict.get("italic", False) flags = italic + 2 * bold collapse = dest_dict.get("collapse") return doc._update_toc_item( xref, action=action[2:], title=title, color=color, flags=flags, collapse=collapse, ) if kind == LINK_NONE: # delete bookmark item return doc.del_toc_item(idx) if kind is None and title is None: # treat as no-op return None if kind is None: # only update title text return doc._update_toc_item(xref, action=None, title=title) if kind == LINK_GOTO: if pno is None or pno not in range(1, doc.page_count + 1): raise ValueError("bad page number") page_xref = doc.page_xref(pno - 1) page_height = doc.page_cropbox(pno - 1).height if to is None: to = Point(72, page_height - 36) else: to = Point(to) to.y = page_height - to.y ddict = { "kind": kind, "to": to, "uri": uri, "page": pno, "file": filename, "zoom": zoom, } action = getDestStr(page_xref, ddict) if action == "" or not action.startswith("/A"): raise ValueError("bad bookmark dest") return doc._update_toc_item(xref, action=action[2:], title=title) def get_area(*args) -> float: """Calculate area of rectangle.\nparameter is one of 'px' (default), 'in', 'cm', or 'mm'.""" rect = args[0] if len(args) > 1: unit = args[1] else: unit = "px" u = {"px": (1, 1), "in": (1.0, 72.0), "cm": (2.54, 72.0), "mm": (25.4, 72.0)} f = (u[unit][0] / u[unit][1]) ** 2 return f * rect.width * rect.height def set_metadata(doc: Document, m: dict) -> None: """Update the PDF /Info object. Args: m: a dictionary like doc.metadata. """ if not doc.is_pdf: raise ValueError("is no PDF") if doc.is_closed or doc.is_encrypted: raise ValueError("document closed or encrypted") if type(m) is not dict: raise ValueError("bad metadata") keymap = { "author": "Author", "producer": "Producer", "creator": "Creator", "title": "Title", "format": None, "encryption": None, "creationDate": "CreationDate", "modDate": "ModDate", "subject": "Subject", "keywords": "Keywords", "trapped": "Trapped", } valid_keys = set(keymap.keys()) diff_set = set(m.keys()).difference(valid_keys) if diff_set != set(): msg = "bad dict key(s): %s" % diff_set raise ValueError(msg) t, temp = doc.xref_get_key(-1, "Info") if t != "xref": info_xref = 0 else: info_xref = int(temp.replace("0 R", "")) if m == {} and info_xref == 0: # nothing to do return if info_xref == 0: # no prev metadata: get new xref info_xref = doc.get_new_xref() doc.update_object(info_xref, "<<>>") # fill it with empty object doc.xref_set_key(-1, "Info", "%i 0 R" % info_xref) elif m == {}: # remove existing metadata doc.xref_set_key(-1, "Info", "null") return for key, val in [(k, v) for k, v in m.items() if keymap[k] != None]: pdf_key = keymap[key] if not bool(val) or val in ("none", "null"): val = "null" else: val = get_pdf_str(val) doc.xref_set_key(info_xref, pdf_key, val) doc.init_doc() return def getDestStr(xref: int, ddict: dict) -> str: """Calculate the PDF action string. Notes: Supports Link annotations and outline items (bookmarks). """ if not ddict: return "" str_goto = "/A<>" str_gotor1 = "/A<>>>" str_gotor2 = "/A<>>>" str_launch = "/A<>>>" str_uri = "/A<>" if type(ddict) in (int, float): dest = str_goto % (xref, 0, ddict, 0) return dest d_kind = ddict.get("kind", LINK_NONE) if d_kind == LINK_NONE: return "" if ddict["kind"] == LINK_GOTO: d_zoom = ddict.get("zoom", 0) to = ddict.get("to", Point(0, 0)) d_left, d_top = to dest = str_goto % (xref, d_left, d_top, d_zoom) return dest if ddict["kind"] == LINK_URI: dest = str_uri % (get_pdf_str(ddict["uri"]),) return dest if ddict["kind"] == LINK_LAUNCH: fspec = get_pdf_str(ddict["file"]) dest = str_launch % (fspec, fspec) return dest if ddict["kind"] == LINK_GOTOR and ddict["page"] < 0: fspec = get_pdf_str(ddict["file"]) dest = str_gotor2 % (get_pdf_str(ddict["to"]), fspec, fspec) return dest if ddict["kind"] == LINK_GOTOR and ddict["page"] >= 0: fspec = get_pdf_str(ddict["file"]) dest = str_gotor1 % ( ddict["page"], ddict["to"].x, ddict["to"].y, ddict["zoom"], fspec, fspec, ) return dest return "" def set_toc( doc: Document, toc: list, collapse: int = 1, ) -> int: """Create new outline tree (table of contents, TOC). Args: toc: (list, tuple) each entry must contain level, title, page and optionally top margin on the page. None or '()' remove the TOC. collapse: (int) collapses entries beyond this level. Zero or None shows all entries unfolded. Returns: the number of inserted items, or the number of removed items respectively. """ if doc.is_closed or doc.is_encrypted: raise ValueError("document closed or encrypted") if not doc.is_pdf: raise ValueError("is no PDF") if not toc: # remove all entries return len(doc._delToC()) # validity checks -------------------------------------------------------- if type(toc) not in (list, tuple): raise ValueError("'toc' must be list or tuple") toclen = len(toc) page_count = doc.page_count t0 = toc[0] if type(t0) not in (list, tuple): raise ValueError("items must be sequences of 3 or 4 items") if t0[0] != 1: raise ValueError("hierarchy level of item 0 must be 1") for i in list(range(toclen - 1)): t1 = toc[i] t2 = toc[i + 1] if not -1 <= t1[2] <= page_count: raise ValueError("row %i: page number out of range" % i) if (type(t2) not in (list, tuple)) or len(t2) not in (3, 4): raise ValueError("bad row %i" % (i + 1)) if (type(t2[0]) is not int) or t2[0] < 1: raise ValueError("bad hierarchy level in row %i" % (i + 1)) if t2[0] > t1[0] + 1: raise ValueError("bad hierarchy level in row %i" % (i + 1)) # no formal errors in toc -------------------------------------------------- # -------------------------------------------------------------------------- # make a list of xref numbers, which we can use for our TOC entries # -------------------------------------------------------------------------- old_xrefs = doc._delToC() # del old outlines, get their xref numbers # prepare table of xrefs for new bookmarks old_xrefs = [] xref = [0] + old_xrefs xref[0] = doc._getOLRootNumber() # entry zero is outline root xref number if toclen > len(old_xrefs): # too few old xrefs? for i in range((toclen - len(old_xrefs))): xref.append(doc.get_new_xref()) # acquire new ones lvltab = {0: 0} # to store last entry per hierarchy level # ------------------------------------------------------------------------------ # contains new outline objects as strings - first one is the outline root # ------------------------------------------------------------------------------ olitems = [{"count": 0, "first": -1, "last": -1, "xref": xref[0]}] # ------------------------------------------------------------------------------ # build olitems as a list of PDF-like connnected dictionaries # ------------------------------------------------------------------------------ for i in range(toclen): o = toc[i] lvl = o[0] # level title = get_pdf_str(o[1]) # title pno = min(doc.page_count - 1, max(0, o[2] - 1)) # page number page_xref = doc.page_xref(pno) page_height = doc.page_cropbox(pno).height top = Point(72, page_height - 36) dest_dict = {"to": top, "kind": LINK_GOTO} # fall back target if o[2] < 0: dest_dict["kind"] = LINK_NONE if len(o) > 3: # some target is specified if type(o[3]) in (int, float): # convert a number to a point dest_dict["to"] = Point(72, page_height - o[3]) else: # if something else, make sure we have a dict dest_dict = o[3] if type(o[3]) is dict else dest_dict if "to" not in dest_dict: # target point not in dict? dest_dict["to"] = top # put default in else: # transform target to PDF coordinates point = +dest_dict["to"] point.y = page_height - point.y dest_dict["to"] = point d = {} d["first"] = -1 d["count"] = 0 d["last"] = -1 d["prev"] = -1 d["next"] = -1 d["dest"] = getDestStr(page_xref, dest_dict) d["top"] = dest_dict["to"] d["title"] = title d["parent"] = lvltab[lvl - 1] d["xref"] = xref[i + 1] d["color"] = dest_dict.get("color") d["flags"] = dest_dict.get("italic", 0) + 2 * dest_dict.get("bold", 0) lvltab[lvl] = i + 1 parent = olitems[lvltab[lvl - 1]] # the parent entry if ( dest_dict.get("collapse") or collapse and lvl > collapse ): # suppress expansion parent["count"] -= 1 # make /Count negative else: parent["count"] += 1 # positive /Count if parent["first"] == -1: parent["first"] = i + 1 parent["last"] = i + 1 else: d["prev"] = parent["last"] prev = olitems[parent["last"]] prev["next"] = i + 1 parent["last"] = i + 1 olitems.append(d) # ------------------------------------------------------------------------------ # now create each outline item as a string and insert it in the PDF # ------------------------------------------------------------------------------ for i, ol in enumerate(olitems): txt = "<<" if ol["count"] != 0: txt += "/Count %i" % ol["count"] try: txt += ol["dest"] except: pass try: if ol["first"] > -1: txt += "/First %i 0 R" % xref[ol["first"]] except: pass try: if ol["last"] > -1: txt += "/Last %i 0 R" % xref[ol["last"]] except: pass try: if ol["next"] > -1: txt += "/Next %i 0 R" % xref[ol["next"]] except: pass try: if ol["parent"] > -1: txt += "/Parent %i 0 R" % xref[ol["parent"]] except: pass try: if ol["prev"] > -1: txt += "/Prev %i 0 R" % xref[ol["prev"]] except: pass try: txt += "/Title" + ol["title"] except: pass if ol.get("color") and len(ol["color"]) == 3: txt += "/C[ %g %g %g]" % tuple(ol["color"]) if ol.get("flags", 0) > 0: txt += "/F %i" % ol["flags"] if i == 0: # special: this is the outline root txt += "/Type/Outlines" # so add the /Type entry txt += ">>" doc.update_object(xref[i], txt) # insert the PDF object doc.init_doc() return toclen def do_links( doc1: Document, doc2: Document, from_page: int = -1, to_page: int = -1, start_at: int = -1, ) -> None: """Insert links contained in copied page range into destination PDF. Parameter values **must** equal those of method insert_pdf(), which must have been previously executed. """ # -------------------------------------------------------------------------- # internal function to create the actual "/Annots" object string # -------------------------------------------------------------------------- def cre_annot(lnk, xref_dst, pno_src, ctm): """Create annotation object string for a passed-in link.""" r = lnk["from"] * ctm # rect in PDF coordinates rect = "%g %g %g %g" % tuple(r) if lnk["kind"] == LINK_GOTO: txt = annot_skel["goto1"] # annot_goto idx = pno_src.index(lnk["page"]) p = lnk["to"] * ctm # target point in PDF coordinates annot = txt % (xref_dst[idx], p.x, p.y, lnk["zoom"], rect) elif lnk["kind"] == LINK_GOTOR: if lnk["page"] >= 0: txt = annot_skel["gotor1"] # annot_gotor pnt = lnk.get("to", Point(0, 0)) # destination point if type(pnt) is not Point: pnt = Point(0, 0) annot = txt % ( lnk["page"], pnt.x, pnt.y, lnk["zoom"], lnk["file"], lnk["file"], rect, ) else: txt = annot_skel["gotor2"] # annot_gotor_n to = get_pdf_str(lnk["to"]) to = to[1:-1] f = lnk["file"] annot = txt % (to, f, rect) elif lnk["kind"] == LINK_LAUNCH: txt = annot_skel["launch"] # annot_launch annot = txt % (lnk["file"], lnk["file"], rect) elif lnk["kind"] == LINK_URI: txt = annot_skel["uri"] # annot_uri annot = txt % (lnk["uri"], rect) else: annot = "" return annot # -------------------------------------------------------------------------- # validate & normalize parameters if from_page < 0: fp = 0 elif from_page >= doc2.page_count: fp = doc2.page_count - 1 else: fp = from_page if to_page < 0 or to_page >= doc2.page_count: tp = doc2.page_count - 1 else: tp = to_page if start_at < 0: raise ValueError("'start_at' must be >= 0") sa = start_at incr = 1 if fp <= tp else -1 # page range could be reversed # lists of source / destination page numbers pno_src = list(range(fp, tp + incr, incr)) pno_dst = [sa + i for i in range(len(pno_src))] # lists of source / destination page xrefs xref_src = [] xref_dst = [] for i in range(len(pno_src)): p_src = pno_src[i] p_dst = pno_dst[i] old_xref = doc2.page_xref(p_src) new_xref = doc1.page_xref(p_dst) xref_src.append(old_xref) xref_dst.append(new_xref) # create the links for each copied page in destination PDF for i in range(len(xref_src)): page_src = doc2[pno_src[i]] # load source page links = page_src.get_links() # get all its links if len(links) == 0: # no links there page_src = None continue ctm = ~page_src.transformation_matrix # calc page transformation matrix page_dst = doc1[pno_dst[i]] # load destination page link_tab = [] # store all link definitions here for l in links: if l["kind"] == LINK_GOTO and (l["page"] not in pno_src): continue # GOTO link target not in copied pages annot_text = cre_annot(l, xref_dst, pno_src, ctm) if annot_text: link_tab.append(annot_text) if link_tab != []: page_dst._addAnnot_FromString(tuple(link_tab)) return def getLinkText(page: Page, lnk: dict) -> str: # -------------------------------------------------------------------------- # define skeletons for /Annots object texts # -------------------------------------------------------------------------- ctm = page.transformation_matrix ictm = ~ctm r = lnk["from"] rect = "%g %g %g %g" % tuple(r * ictm) annot = "" if lnk["kind"] == LINK_GOTO: if lnk["page"] >= 0: txt = annot_skel["goto1"] # annot_goto pno = lnk["page"] xref = page.parent.page_xref(pno) pnt = lnk.get("to", Point(0, 0)) # destination point ipnt = pnt * ictm annot = txt % (xref, ipnt.x, ipnt.y, lnk.get("zoom", 0), rect) else: txt = annot_skel["goto2"] # annot_goto_n annot = txt % (get_pdf_str(lnk["to"]), rect) elif lnk["kind"] == LINK_GOTOR: if lnk["page"] >= 0: txt = annot_skel["gotor1"] # annot_gotor pnt = lnk.get("to", Point(0, 0)) # destination point if type(pnt) is not Point: pnt = Point(0, 0) annot = txt % ( lnk["page"], pnt.x, pnt.y, lnk.get("zoom", 0), lnk["file"], lnk["file"], rect, ) else: txt = annot_skel["gotor2"] # annot_gotor_n annot = txt % (get_pdf_str(lnk["to"]), lnk["file"], rect) elif lnk["kind"] == LINK_LAUNCH: txt = annot_skel["launch"] # annot_launch annot = txt % (lnk["file"], lnk["file"], rect) elif lnk["kind"] == LINK_URI: txt = annot_skel["uri"] # txt = annot_uri annot = txt % (lnk["uri"], rect) elif lnk["kind"] == LINK_NAMED: txt = annot_skel["named"] # annot_named annot = txt % (lnk["name"], rect) if not annot: return annot # add a /NM PDF key to the object definition link_names = dict( # existing ids and their xref [(x[0], x[2]) for x in page.annot_xrefs() if x[1] == PDF_ANNOT_LINK] ) old_name = lnk.get("id", "") # id value in the argument if old_name and (lnk["xref"], old_name) in link_names.items(): name = old_name # no new name if this is an update only else: i = 0 stem = TOOLS.set_annot_stem() + "-L%i" while True: name = stem % i if name not in link_names.values(): break i += 1 # add /NM key to object definition annot = annot.replace("/Link", "/Link/NM(%s)" % name) return annot def delete_widget(page: Page, widget: Widget) -> Widget: """Delete widget from page and return the next one.""" CheckParent(page) annot = getattr(widget, "_annot", None) if annot is None: raise ValueError("bad type: widget") nextwidget = widget.next page.delete_annot(annot) widget._annot.__del__() widget._annot.parent = None keylist = list(widget.__dict__.keys()) for key in keylist: del widget.__dict__[key] return nextwidget def update_link(page: Page, lnk: dict) -> None: """Update a link on the current page.""" CheckParent(page) annot = getLinkText(page, lnk) if annot == "": raise ValueError("link kind not supported") page.parent.update_object(lnk["xref"], annot, page=page) return def insert_link(page: Page, lnk: dict, mark: bool = True) -> None: """Insert a new link for the current page.""" CheckParent(page) annot = getLinkText(page, lnk) if annot == "": raise ValueError("link kind not supported") page._addAnnot_FromString((annot,)) return def insert_textbox( page: Page, rect: rect_like, buffer: typing.Union[str, list], fontname: str = "helv", fontfile: OptStr = None, set_simple: int = 0, encoding: int = 0, fontsize: float = 11, lineheight: OptFloat = None, color: OptSeq = None, fill: OptSeq = None, expandtabs: int = 1, align: int = 0, rotate: int = 0, render_mode: int = 0, border_width: float = 0.05, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> float: """Insert text into a given rectangle. Notes: Creates a Shape object, uses its same-named method and commits it. Parameters: rect: (rect-like) area to use for text. buffer: text to be inserted fontname: a Base-14 font, font name or '/name' fontfile: name of a font file fontsize: font size lineheight: overwrite the font property color: RGB color triple expandtabs: handles tabulators with string function align: left, center, right, justified rotate: 0, 90, 180, or 270 degrees morph: morph box with a matrix and a fixpoint overlay: put text in foreground or background Returns: unused or deficit rectangle area (float) """ img = page.new_shape() rc = img.insert_textbox( rect, buffer, fontsize=fontsize, lineheight=lineheight, fontname=fontname, fontfile=fontfile, set_simple=set_simple, encoding=encoding, color=color, fill=fill, expandtabs=expandtabs, render_mode=render_mode, border_width=border_width, align=align, rotate=rotate, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) if rc >= 0: img.commit(overlay) return rc def insert_text( page: Page, point: point_like, text: typing.Union[str, list], fontsize: float = 11, lineheight: OptFloat = None, fontname: str = "helv", fontfile: OptStr = None, set_simple: int = 0, encoding: int = 0, color: OptSeq = None, fill: OptSeq = None, border_width: float = 0.05, render_mode: int = 0, rotate: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ): img = page.new_shape() rc = img.insert_text( point, text, fontsize=fontsize, lineheight=lineheight, fontname=fontname, fontfile=fontfile, set_simple=set_simple, encoding=encoding, color=color, fill=fill, border_width=border_width, render_mode=render_mode, rotate=rotate, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) if rc >= 0: img.commit(overlay) return rc def new_page( doc: Document, pno: int = -1, width: float = 595, height: float = 842, ) -> Page: """Create and return a new page object. Args: pno: (int) insert before this page. Default: after last page. width: (float) page width in points. Default: 595 (ISO A4 width). height: (float) page height in points. Default 842 (ISO A4 height). Returns: A Page object. """ doc._newPage(pno, width=width, height=height) return doc[pno] def insert_page( doc: Document, pno: int, text: typing.Union[str, list, None] = None, fontsize: float = 11, width: float = 595, height: float = 842, fontname: str = "helv", fontfile: OptStr = None, color: OptSeq = (0,), ) -> int: """Create a new PDF page and insert some text. Notes: Function combining Document.new_page() and Page.insert_text(). For parameter details see these methods. """ page = doc.new_page(pno=pno, width=width, height=height) if not bool(text): return 0 rc = page.insert_text( (50, 72), text, fontsize=fontsize, fontname=fontname, fontfile=fontfile, color=color, ) return rc def draw_line( page: Page, p1: point_like, p2: point_like, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc=0, ) -> Point: """Draw a line from point p1 to point p2.""" img = page.new_shape() p = img.draw_line(Point(p1), Point(p2)) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def draw_squiggle( page: Page, p1: point_like, p2: point_like, breadth: float = 2, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a squiggly line from point p1 to point p2.""" img = page.new_shape() p = img.draw_squiggle(Point(p1), Point(p2), breadth=breadth) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def draw_zigzag( page: Page, p1: point_like, p2: point_like, breadth: float = 2, color: OptSeq = (0,), dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a zigzag line from point p1 to point p2.""" img = page.new_shape() p = img.draw_zigzag(Point(p1), Point(p2), breadth=breadth) img.finish( color=color, dashes=dashes, width=width, closePath=False, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return p def draw_rect( page: Page, rect: rect_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, radius=None, ) -> Point: """Draw a rectangle. See Shape class method for details.""" img = page.new_shape() Q = img.draw_rect(Rect(rect), radius=radius) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_quad( page: Page, quad: quad_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, morph: OptSeq = None, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a quadrilateral.""" img = page.new_shape() Q = img.draw_quad(Quad(quad)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_polyline( page: Page, points: list, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptSeq = None, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, closePath: bool = False, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw multiple connected line segments.""" img = page.new_shape() Q = img.draw_polyline(points) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_circle( page: Page, center: point_like, radius: float, color: OptSeq = (0,), fill: OptSeq = None, morph: OptSeq = None, dashes: OptStr = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a circle given its center and radius.""" img = page.new_shape() Q = img.draw_circle(Point(center), radius) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_oval( page: Page, rect: typing.Union[rect_like, quad_like], color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, morph: OptSeq = None, width: float = 1, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw an oval given its containing rectangle or quad.""" img = page.new_shape() Q = img.draw_oval(rect) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_curve( page: Page, p1: point_like, p2: point_like, p3: point_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptSeq = None, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a special Bezier curve from p1 to p3, generating control points on lines p1 to p2 and p2 to p3.""" img = page.new_shape() Q = img.draw_curve(Point(p1), Point(p2), Point(p3)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_bezier( page: Page, p1: point_like, p2: point_like, p3: point_like, p4: point_like, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, width: float = 1, morph: OptStr = None, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a general cubic Bezier curve from p1 to p4 using control points p2 and p3.""" img = page.new_shape() Q = img.draw_bezier(Point(p1), Point(p2), Point(p3), Point(p4)) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q def draw_sector( page: Page, center: point_like, point: point_like, beta: float, color: OptSeq = (0,), fill: OptSeq = None, dashes: OptStr = None, fullSector: bool = True, morph: OptSeq = None, width: float = 1, closePath: bool = False, lineCap: int = 0, lineJoin: int = 0, overlay: bool = True, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> Point: """Draw a circle sector given circle center, one arc end point and the angle of the arc. Parameters: center -- center of circle point -- arc end point beta -- angle of arc (degrees) fullSector -- connect arc ends with center """ img = page.new_shape() Q = img.draw_sector(Point(center), Point(point), beta, fullSector=fullSector) img.finish( color=color, fill=fill, dashes=dashes, width=width, lineCap=lineCap, lineJoin=lineJoin, morph=morph, closePath=closePath, stroke_opacity=stroke_opacity, fill_opacity=fill_opacity, oc=oc, ) img.commit(overlay) return Q # ---------------------------------------------------------------------- # Name: wx.lib.colourdb.py # Purpose: Adds a bunch of colour names and RGB values to the # colour database so they can be found by name # # Author: Robin Dunn # # Created: 13-March-2001 # Copyright: (c) 2001-2017 by Total Control Software # Licence: wxWindows license # Tags: phoenix-port, unittest, documented # ---------------------------------------------------------------------- def getColorList() -> list: """ Returns a list of just the colour names used by this module. :rtype: list of strings """ return [x[0] for x in getColorInfoList()] def getColorInfoList() -> list: """ Returns the list of colour name/value tuples used by this module. :rtype: list of tuples """ return [ ("ALICEBLUE", 240, 248, 255), ("ANTIQUEWHITE", 250, 235, 215), ("ANTIQUEWHITE1", 255, 239, 219), ("ANTIQUEWHITE2", 238, 223, 204), ("ANTIQUEWHITE3", 205, 192, 176), ("ANTIQUEWHITE4", 139, 131, 120), ("AQUAMARINE", 127, 255, 212), ("AQUAMARINE1", 127, 255, 212), ("AQUAMARINE2", 118, 238, 198), ("AQUAMARINE3", 102, 205, 170), ("AQUAMARINE4", 69, 139, 116), ("AZURE", 240, 255, 255), ("AZURE1", 240, 255, 255), ("AZURE2", 224, 238, 238), ("AZURE3", 193, 205, 205), ("AZURE4", 131, 139, 139), ("BEIGE", 245, 245, 220), ("BISQUE", 255, 228, 196), ("BISQUE1", 255, 228, 196), ("BISQUE2", 238, 213, 183), ("BISQUE3", 205, 183, 158), ("BISQUE4", 139, 125, 107), ("BLACK", 0, 0, 0), ("BLANCHEDALMOND", 255, 235, 205), ("BLUE", 0, 0, 255), ("BLUE1", 0, 0, 255), ("BLUE2", 0, 0, 238), ("BLUE3", 0, 0, 205), ("BLUE4", 0, 0, 139), ("BLUEVIOLET", 138, 43, 226), ("BROWN", 165, 42, 42), ("BROWN1", 255, 64, 64), ("BROWN2", 238, 59, 59), ("BROWN3", 205, 51, 51), ("BROWN4", 139, 35, 35), ("BURLYWOOD", 222, 184, 135), ("BURLYWOOD1", 255, 211, 155), ("BURLYWOOD2", 238, 197, 145), ("BURLYWOOD3", 205, 170, 125), ("BURLYWOOD4", 139, 115, 85), ("CADETBLUE", 95, 158, 160), ("CADETBLUE1", 152, 245, 255), ("CADETBLUE2", 142, 229, 238), ("CADETBLUE3", 122, 197, 205), ("CADETBLUE4", 83, 134, 139), ("CHARTREUSE", 127, 255, 0), ("CHARTREUSE1", 127, 255, 0), ("CHARTREUSE2", 118, 238, 0), ("CHARTREUSE3", 102, 205, 0), ("CHARTREUSE4", 69, 139, 0), ("CHOCOLATE", 210, 105, 30), ("CHOCOLATE1", 255, 127, 36), ("CHOCOLATE2", 238, 118, 33), ("CHOCOLATE3", 205, 102, 29), ("CHOCOLATE4", 139, 69, 19), ("COFFEE", 156, 79, 0), ("CORAL", 255, 127, 80), ("CORAL1", 255, 114, 86), ("CORAL2", 238, 106, 80), ("CORAL3", 205, 91, 69), ("CORAL4", 139, 62, 47), ("CORNFLOWERBLUE", 100, 149, 237), ("CORNSILK", 255, 248, 220), ("CORNSILK1", 255, 248, 220), ("CORNSILK2", 238, 232, 205), ("CORNSILK3", 205, 200, 177), ("CORNSILK4", 139, 136, 120), ("CYAN", 0, 255, 255), ("CYAN1", 0, 255, 255), ("CYAN2", 0, 238, 238), ("CYAN3", 0, 205, 205), ("CYAN4", 0, 139, 139), ("DARKBLUE", 0, 0, 139), ("DARKCYAN", 0, 139, 139), ("DARKGOLDENROD", 184, 134, 11), ("DARKGOLDENROD1", 255, 185, 15), ("DARKGOLDENROD2", 238, 173, 14), ("DARKGOLDENROD3", 205, 149, 12), ("DARKGOLDENROD4", 139, 101, 8), ("DARKGREEN", 0, 100, 0), ("DARKGRAY", 169, 169, 169), ("DARKKHAKI", 189, 183, 107), ("DARKMAGENTA", 139, 0, 139), ("DARKOLIVEGREEN", 85, 107, 47), ("DARKOLIVEGREEN1", 202, 255, 112), ("DARKOLIVEGREEN2", 188, 238, 104), ("DARKOLIVEGREEN3", 162, 205, 90), ("DARKOLIVEGREEN4", 110, 139, 61), ("DARKORANGE", 255, 140, 0), ("DARKORANGE1", 255, 127, 0), ("DARKORANGE2", 238, 118, 0), ("DARKORANGE3", 205, 102, 0), ("DARKORANGE4", 139, 69, 0), ("DARKORCHID", 153, 50, 204), ("DARKORCHID1", 191, 62, 255), ("DARKORCHID2", 178, 58, 238), ("DARKORCHID3", 154, 50, 205), ("DARKORCHID4", 104, 34, 139), ("DARKRED", 139, 0, 0), ("DARKSALMON", 233, 150, 122), ("DARKSEAGREEN", 143, 188, 143), ("DARKSEAGREEN1", 193, 255, 193), ("DARKSEAGREEN2", 180, 238, 180), ("DARKSEAGREEN3", 155, 205, 155), ("DARKSEAGREEN4", 105, 139, 105), ("DARKSLATEBLUE", 72, 61, 139), ("DARKSLATEGRAY", 47, 79, 79), ("DARKTURQUOISE", 0, 206, 209), ("DARKVIOLET", 148, 0, 211), ("DEEPPINK", 255, 20, 147), ("DEEPPINK1", 255, 20, 147), ("DEEPPINK2", 238, 18, 137), ("DEEPPINK3", 205, 16, 118), ("DEEPPINK4", 139, 10, 80), ("DEEPSKYBLUE", 0, 191, 255), ("DEEPSKYBLUE1", 0, 191, 255), ("DEEPSKYBLUE2", 0, 178, 238), ("DEEPSKYBLUE3", 0, 154, 205), ("DEEPSKYBLUE4", 0, 104, 139), ("DIMGRAY", 105, 105, 105), ("DODGERBLUE", 30, 144, 255), ("DODGERBLUE1", 30, 144, 255), ("DODGERBLUE2", 28, 134, 238), ("DODGERBLUE3", 24, 116, 205), ("DODGERBLUE4", 16, 78, 139), ("FIREBRICK", 178, 34, 34), ("FIREBRICK1", 255, 48, 48), ("FIREBRICK2", 238, 44, 44), ("FIREBRICK3", 205, 38, 38), ("FIREBRICK4", 139, 26, 26), ("FLORALWHITE", 255, 250, 240), ("FORESTGREEN", 34, 139, 34), ("GAINSBORO", 220, 220, 220), ("GHOSTWHITE", 248, 248, 255), ("GOLD", 255, 215, 0), ("GOLD1", 255, 215, 0), ("GOLD2", 238, 201, 0), ("GOLD3", 205, 173, 0), ("GOLD4", 139, 117, 0), ("GOLDENROD", 218, 165, 32), ("GOLDENROD1", 255, 193, 37), ("GOLDENROD2", 238, 180, 34), ("GOLDENROD3", 205, 155, 29), ("GOLDENROD4", 139, 105, 20), ("GREEN YELLOW", 173, 255, 47), ("GREEN", 0, 255, 0), ("GREEN1", 0, 255, 0), ("GREEN2", 0, 238, 0), ("GREEN3", 0, 205, 0), ("GREEN4", 0, 139, 0), ("GREENYELLOW", 173, 255, 47), ("GRAY", 190, 190, 190), ("GRAY0", 0, 0, 0), ("GRAY1", 3, 3, 3), ("GRAY10", 26, 26, 26), ("GRAY100", 255, 255, 255), ("GRAY11", 28, 28, 28), ("GRAY12", 31, 31, 31), ("GRAY13", 33, 33, 33), ("GRAY14", 36, 36, 36), ("GRAY15", 38, 38, 38), ("GRAY16", 41, 41, 41), ("GRAY17", 43, 43, 43), ("GRAY18", 46, 46, 46), ("GRAY19", 48, 48, 48), ("GRAY2", 5, 5, 5), ("GRAY20", 51, 51, 51), ("GRAY21", 54, 54, 54), ("GRAY22", 56, 56, 56), ("GRAY23", 59, 59, 59), ("GRAY24", 61, 61, 61), ("GRAY25", 64, 64, 64), ("GRAY26", 66, 66, 66), ("GRAY27", 69, 69, 69), ("GRAY28", 71, 71, 71), ("GRAY29", 74, 74, 74), ("GRAY3", 8, 8, 8), ("GRAY30", 77, 77, 77), ("GRAY31", 79, 79, 79), ("GRAY32", 82, 82, 82), ("GRAY33", 84, 84, 84), ("GRAY34", 87, 87, 87), ("GRAY35", 89, 89, 89), ("GRAY36", 92, 92, 92), ("GRAY37", 94, 94, 94), ("GRAY38", 97, 97, 97), ("GRAY39", 99, 99, 99), ("GRAY4", 10, 10, 10), ("GRAY40", 102, 102, 102), ("GRAY41", 105, 105, 105), ("GRAY42", 107, 107, 107), ("GRAY43", 110, 110, 110), ("GRAY44", 112, 112, 112), ("GRAY45", 115, 115, 115), ("GRAY46", 117, 117, 117), ("GRAY47", 120, 120, 120), ("GRAY48", 122, 122, 122), ("GRAY49", 125, 125, 125), ("GRAY5", 13, 13, 13), ("GRAY50", 127, 127, 127), ("GRAY51", 130, 130, 130), ("GRAY52", 133, 133, 133), ("GRAY53", 135, 135, 135), ("GRAY54", 138, 138, 138), ("GRAY55", 140, 140, 140), ("GRAY56", 143, 143, 143), ("GRAY57", 145, 145, 145), ("GRAY58", 148, 148, 148), ("GRAY59", 150, 150, 150), ("GRAY6", 15, 15, 15), ("GRAY60", 153, 153, 153), ("GRAY61", 156, 156, 156), ("GRAY62", 158, 158, 158), ("GRAY63", 161, 161, 161), ("GRAY64", 163, 163, 163), ("GRAY65", 166, 166, 166), ("GRAY66", 168, 168, 168), ("GRAY67", 171, 171, 171), ("GRAY68", 173, 173, 173), ("GRAY69", 176, 176, 176), ("GRAY7", 18, 18, 18), ("GRAY70", 179, 179, 179), ("GRAY71", 181, 181, 181), ("GRAY72", 184, 184, 184), ("GRAY73", 186, 186, 186), ("GRAY74", 189, 189, 189), ("GRAY75", 191, 191, 191), ("GRAY76", 194, 194, 194), ("GRAY77", 196, 196, 196), ("GRAY78", 199, 199, 199), ("GRAY79", 201, 201, 201), ("GRAY8", 20, 20, 20), ("GRAY80", 204, 204, 204), ("GRAY81", 207, 207, 207), ("GRAY82", 209, 209, 209), ("GRAY83", 212, 212, 212), ("GRAY84", 214, 214, 214), ("GRAY85", 217, 217, 217), ("GRAY86", 219, 219, 219), ("GRAY87", 222, 222, 222), ("GRAY88", 224, 224, 224), ("GRAY89", 227, 227, 227), ("GRAY9", 23, 23, 23), ("GRAY90", 229, 229, 229), ("GRAY91", 232, 232, 232), ("GRAY92", 235, 235, 235), ("GRAY93", 237, 237, 237), ("GRAY94", 240, 240, 240), ("GRAY95", 242, 242, 242), ("GRAY96", 245, 245, 245), ("GRAY97", 247, 247, 247), ("GRAY98", 250, 250, 250), ("GRAY99", 252, 252, 252), ("HONEYDEW", 240, 255, 240), ("HONEYDEW1", 240, 255, 240), ("HONEYDEW2", 224, 238, 224), ("HONEYDEW3", 193, 205, 193), ("HONEYDEW4", 131, 139, 131), ("HOTPINK", 255, 105, 180), ("HOTPINK1", 255, 110, 180), ("HOTPINK2", 238, 106, 167), ("HOTPINK3", 205, 96, 144), ("HOTPINK4", 139, 58, 98), ("INDIANRED", 205, 92, 92), ("INDIANRED1", 255, 106, 106), ("INDIANRED2", 238, 99, 99), ("INDIANRED3", 205, 85, 85), ("INDIANRED4", 139, 58, 58), ("IVORY", 255, 255, 240), ("IVORY1", 255, 255, 240), ("IVORY2", 238, 238, 224), ("IVORY3", 205, 205, 193), ("IVORY4", 139, 139, 131), ("KHAKI", 240, 230, 140), ("KHAKI1", 255, 246, 143), ("KHAKI2", 238, 230, 133), ("KHAKI3", 205, 198, 115), ("KHAKI4", 139, 134, 78), ("LAVENDER", 230, 230, 250), ("LAVENDERBLUSH", 255, 240, 245), ("LAVENDERBLUSH1", 255, 240, 245), ("LAVENDERBLUSH2", 238, 224, 229), ("LAVENDERBLUSH3", 205, 193, 197), ("LAVENDERBLUSH4", 139, 131, 134), ("LAWNGREEN", 124, 252, 0), ("LEMONCHIFFON", 255, 250, 205), ("LEMONCHIFFON1", 255, 250, 205), ("LEMONCHIFFON2", 238, 233, 191), ("LEMONCHIFFON3", 205, 201, 165), ("LEMONCHIFFON4", 139, 137, 112), ("LIGHTBLUE", 173, 216, 230), ("LIGHTBLUE1", 191, 239, 255), ("LIGHTBLUE2", 178, 223, 238), ("LIGHTBLUE3", 154, 192, 205), ("LIGHTBLUE4", 104, 131, 139), ("LIGHTCORAL", 240, 128, 128), ("LIGHTCYAN", 224, 255, 255), ("LIGHTCYAN1", 224, 255, 255), ("LIGHTCYAN2", 209, 238, 238), ("LIGHTCYAN3", 180, 205, 205), ("LIGHTCYAN4", 122, 139, 139), ("LIGHTGOLDENROD", 238, 221, 130), ("LIGHTGOLDENROD1", 255, 236, 139), ("LIGHTGOLDENROD2", 238, 220, 130), ("LIGHTGOLDENROD3", 205, 190, 112), ("LIGHTGOLDENROD4", 139, 129, 76), ("LIGHTGOLDENRODYELLOW", 250, 250, 210), ("LIGHTGREEN", 144, 238, 144), ("LIGHTGRAY", 211, 211, 211), ("LIGHTPINK", 255, 182, 193), ("LIGHTPINK1", 255, 174, 185), ("LIGHTPINK2", 238, 162, 173), ("LIGHTPINK3", 205, 140, 149), ("LIGHTPINK4", 139, 95, 101), ("LIGHTSALMON", 255, 160, 122), ("LIGHTSALMON1", 255, 160, 122), ("LIGHTSALMON2", 238, 149, 114), ("LIGHTSALMON3", 205, 129, 98), ("LIGHTSALMON4", 139, 87, 66), ("LIGHTSEAGREEN", 32, 178, 170), ("LIGHTSKYBLUE", 135, 206, 250), ("LIGHTSKYBLUE1", 176, 226, 255), ("LIGHTSKYBLUE2", 164, 211, 238), ("LIGHTSKYBLUE3", 141, 182, 205), ("LIGHTSKYBLUE4", 96, 123, 139), ("LIGHTSLATEBLUE", 132, 112, 255), ("LIGHTSLATEGRAY", 119, 136, 153), ("LIGHTSTEELBLUE", 176, 196, 222), ("LIGHTSTEELBLUE1", 202, 225, 255), ("LIGHTSTEELBLUE2", 188, 210, 238), ("LIGHTSTEELBLUE3", 162, 181, 205), ("LIGHTSTEELBLUE4", 110, 123, 139), ("LIGHTYELLOW", 255, 255, 224), ("LIGHTYELLOW1", 255, 255, 224), ("LIGHTYELLOW2", 238, 238, 209), ("LIGHTYELLOW3", 205, 205, 180), ("LIGHTYELLOW4", 139, 139, 122), ("LIMEGREEN", 50, 205, 50), ("LINEN", 250, 240, 230), ("MAGENTA", 255, 0, 255), ("MAGENTA1", 255, 0, 255), ("MAGENTA2", 238, 0, 238), ("MAGENTA3", 205, 0, 205), ("MAGENTA4", 139, 0, 139), ("MAROON", 176, 48, 96), ("MAROON1", 255, 52, 179), ("MAROON2", 238, 48, 167), ("MAROON3", 205, 41, 144), ("MAROON4", 139, 28, 98), ("MEDIUMAQUAMARINE", 102, 205, 170), ("MEDIUMBLUE", 0, 0, 205), ("MEDIUMORCHID", 186, 85, 211), ("MEDIUMORCHID1", 224, 102, 255), ("MEDIUMORCHID2", 209, 95, 238), ("MEDIUMORCHID3", 180, 82, 205), ("MEDIUMORCHID4", 122, 55, 139), ("MEDIUMPURPLE", 147, 112, 219), ("MEDIUMPURPLE1", 171, 130, 255), ("MEDIUMPURPLE2", 159, 121, 238), ("MEDIUMPURPLE3", 137, 104, 205), ("MEDIUMPURPLE4", 93, 71, 139), ("MEDIUMSEAGREEN", 60, 179, 113), ("MEDIUMSLATEBLUE", 123, 104, 238), ("MEDIUMSPRINGGREEN", 0, 250, 154), ("MEDIUMTURQUOISE", 72, 209, 204), ("MEDIUMVIOLETRED", 199, 21, 133), ("MIDNIGHTBLUE", 25, 25, 112), ("MINTCREAM", 245, 255, 250), ("MISTYROSE", 255, 228, 225), ("MISTYROSE1", 255, 228, 225), ("MISTYROSE2", 238, 213, 210), ("MISTYROSE3", 205, 183, 181), ("MISTYROSE4", 139, 125, 123), ("MOCCASIN", 255, 228, 181), ("MUPDFBLUE", 37, 114, 172), ("NAVAJOWHITE", 255, 222, 173), ("NAVAJOWHITE1", 255, 222, 173), ("NAVAJOWHITE2", 238, 207, 161), ("NAVAJOWHITE3", 205, 179, 139), ("NAVAJOWHITE4", 139, 121, 94), ("NAVY", 0, 0, 128), ("NAVYBLUE", 0, 0, 128), ("OLDLACE", 253, 245, 230), ("OLIVEDRAB", 107, 142, 35), ("OLIVEDRAB1", 192, 255, 62), ("OLIVEDRAB2", 179, 238, 58), ("OLIVEDRAB3", 154, 205, 50), ("OLIVEDRAB4", 105, 139, 34), ("ORANGE", 255, 165, 0), ("ORANGE1", 255, 165, 0), ("ORANGE2", 238, 154, 0), ("ORANGE3", 205, 133, 0), ("ORANGE4", 139, 90, 0), ("ORANGERED", 255, 69, 0), ("ORANGERED1", 255, 69, 0), ("ORANGERED2", 238, 64, 0), ("ORANGERED3", 205, 55, 0), ("ORANGERED4", 139, 37, 0), ("ORCHID", 218, 112, 214), ("ORCHID1", 255, 131, 250), ("ORCHID2", 238, 122, 233), ("ORCHID3", 205, 105, 201), ("ORCHID4", 139, 71, 137), ("PALEGOLDENROD", 238, 232, 170), ("PALEGREEN", 152, 251, 152), ("PALEGREEN1", 154, 255, 154), ("PALEGREEN2", 144, 238, 144), ("PALEGREEN3", 124, 205, 124), ("PALEGREEN4", 84, 139, 84), ("PALETURQUOISE", 175, 238, 238), ("PALETURQUOISE1", 187, 255, 255), ("PALETURQUOISE2", 174, 238, 238), ("PALETURQUOISE3", 150, 205, 205), ("PALETURQUOISE4", 102, 139, 139), ("PALEVIOLETRED", 219, 112, 147), ("PALEVIOLETRED1", 255, 130, 171), ("PALEVIOLETRED2", 238, 121, 159), ("PALEVIOLETRED3", 205, 104, 137), ("PALEVIOLETRED4", 139, 71, 93), ("PAPAYAWHIP", 255, 239, 213), ("PEACHPUFF", 255, 218, 185), ("PEACHPUFF1", 255, 218, 185), ("PEACHPUFF2", 238, 203, 173), ("PEACHPUFF3", 205, 175, 149), ("PEACHPUFF4", 139, 119, 101), ("PERU", 205, 133, 63), ("PINK", 255, 192, 203), ("PINK1", 255, 181, 197), ("PINK2", 238, 169, 184), ("PINK3", 205, 145, 158), ("PINK4", 139, 99, 108), ("PLUM", 221, 160, 221), ("PLUM1", 255, 187, 255), ("PLUM2", 238, 174, 238), ("PLUM3", 205, 150, 205), ("PLUM4", 139, 102, 139), ("POWDERBLUE", 176, 224, 230), ("PURPLE", 160, 32, 240), ("PURPLE1", 155, 48, 255), ("PURPLE2", 145, 44, 238), ("PURPLE3", 125, 38, 205), ("PURPLE4", 85, 26, 139), ("PY_COLOR", 240, 255, 210), ("RED", 255, 0, 0), ("RED1", 255, 0, 0), ("RED2", 238, 0, 0), ("RED3", 205, 0, 0), ("RED4", 139, 0, 0), ("ROSYBROWN", 188, 143, 143), ("ROSYBROWN1", 255, 193, 193), ("ROSYBROWN2", 238, 180, 180), ("ROSYBROWN3", 205, 155, 155), ("ROSYBROWN4", 139, 105, 105), ("ROYALBLUE", 65, 105, 225), ("ROYALBLUE1", 72, 118, 255), ("ROYALBLUE2", 67, 110, 238), ("ROYALBLUE3", 58, 95, 205), ("ROYALBLUE4", 39, 64, 139), ("SADDLEBROWN", 139, 69, 19), ("SALMON", 250, 128, 114), ("SALMON1", 255, 140, 105), ("SALMON2", 238, 130, 98), ("SALMON3", 205, 112, 84), ("SALMON4", 139, 76, 57), ("SANDYBROWN", 244, 164, 96), ("SEAGREEN", 46, 139, 87), ("SEAGREEN1", 84, 255, 159), ("SEAGREEN2", 78, 238, 148), ("SEAGREEN3", 67, 205, 128), ("SEAGREEN4", 46, 139, 87), ("SEASHELL", 255, 245, 238), ("SEASHELL1", 255, 245, 238), ("SEASHELL2", 238, 229, 222), ("SEASHELL3", 205, 197, 191), ("SEASHELL4", 139, 134, 130), ("SIENNA", 160, 82, 45), ("SIENNA1", 255, 130, 71), ("SIENNA2", 238, 121, 66), ("SIENNA3", 205, 104, 57), ("SIENNA4", 139, 71, 38), ("SKYBLUE", 135, 206, 235), ("SKYBLUE1", 135, 206, 255), ("SKYBLUE2", 126, 192, 238), ("SKYBLUE3", 108, 166, 205), ("SKYBLUE4", 74, 112, 139), ("SLATEBLUE", 106, 90, 205), ("SLATEBLUE1", 131, 111, 255), ("SLATEBLUE2", 122, 103, 238), ("SLATEBLUE3", 105, 89, 205), ("SLATEBLUE4", 71, 60, 139), ("SLATEGRAY", 112, 128, 144), ("SNOW", 255, 250, 250), ("SNOW1", 255, 250, 250), ("SNOW2", 238, 233, 233), ("SNOW3", 205, 201, 201), ("SNOW4", 139, 137, 137), ("SPRINGGREEN", 0, 255, 127), ("SPRINGGREEN1", 0, 255, 127), ("SPRINGGREEN2", 0, 238, 118), ("SPRINGGREEN3", 0, 205, 102), ("SPRINGGREEN4", 0, 139, 69), ("STEELBLUE", 70, 130, 180), ("STEELBLUE1", 99, 184, 255), ("STEELBLUE2", 92, 172, 238), ("STEELBLUE3", 79, 148, 205), ("STEELBLUE4", 54, 100, 139), ("TAN", 210, 180, 140), ("TAN1", 255, 165, 79), ("TAN2", 238, 154, 73), ("TAN3", 205, 133, 63), ("TAN4", 139, 90, 43), ("THISTLE", 216, 191, 216), ("THISTLE1", 255, 225, 255), ("THISTLE2", 238, 210, 238), ("THISTLE3", 205, 181, 205), ("THISTLE4", 139, 123, 139), ("TOMATO", 255, 99, 71), ("TOMATO1", 255, 99, 71), ("TOMATO2", 238, 92, 66), ("TOMATO3", 205, 79, 57), ("TOMATO4", 139, 54, 38), ("TURQUOISE", 64, 224, 208), ("TURQUOISE1", 0, 245, 255), ("TURQUOISE2", 0, 229, 238), ("TURQUOISE3", 0, 197, 205), ("TURQUOISE4", 0, 134, 139), ("VIOLET", 238, 130, 238), ("VIOLETRED", 208, 32, 144), ("VIOLETRED1", 255, 62, 150), ("VIOLETRED2", 238, 58, 140), ("VIOLETRED3", 205, 50, 120), ("VIOLETRED4", 139, 34, 82), ("WHEAT", 245, 222, 179), ("WHEAT1", 255, 231, 186), ("WHEAT2", 238, 216, 174), ("WHEAT3", 205, 186, 150), ("WHEAT4", 139, 126, 102), ("WHITE", 255, 255, 255), ("WHITESMOKE", 245, 245, 245), ("YELLOW", 255, 255, 0), ("YELLOW1", 255, 255, 0), ("YELLOW2", 238, 238, 0), ("YELLOW3", 205, 205, 0), ("YELLOW4", 139, 139, 0), ("YELLOWGREEN", 154, 205, 50), ] def getColorInfoDict() -> dict: d = {} for item in getColorInfoList(): d[item[0].lower()] = item[1:] return d def getColor(name: str) -> tuple: """Retrieve RGB color in PDF format by name. Returns: a triple of floats in range 0 to 1. In case of name-not-found, "white" is returned. """ try: c = getColorInfoList()[getColorList().index(name.upper())] return (c[1] / 255.0, c[2] / 255.0, c[3] / 255.0) except: return (1, 1, 1) def getColorHSV(name: str) -> tuple: """Retrieve the hue, saturation, value triple of a color name. Returns: a triple (degree, percent, percent). If not found (-1, -1, -1) is returned. """ try: x = getColorInfoList()[getColorList().index(name.upper())] except: return (-1, -1, -1) r = x[1] / 255.0 g = x[2] / 255.0 b = x[3] / 255.0 cmax = max(r, g, b) V = round(cmax * 100, 1) cmin = min(r, g, b) delta = cmax - cmin if delta == 0: hue = 0 elif cmax == r: hue = 60.0 * (((g - b) / delta) % 6) elif cmax == g: hue = 60.0 * (((b - r) / delta) + 2) else: hue = 60.0 * (((r - g) / delta) + 4) H = int(round(hue)) if cmax == 0: sat = 0 else: sat = delta / cmax S = int(round(sat * 100)) return (H, S, V) def _get_font_properties(doc: Document, xref: int) -> tuple: fontname, ext, stype, buffer = doc.extract_font(xref) asc = 0.8 dsc = -0.2 if ext == "": return fontname, ext, stype, asc, dsc if buffer: try: font = Font(fontbuffer=buffer) asc = font.ascender dsc = font.descender bbox = font.bbox if asc - dsc < 1: if bbox.y0 < dsc: dsc = bbox.y0 asc = 1 - dsc except: asc *= 1.2 dsc *= 1.2 return fontname, ext, stype, asc, dsc if ext != "n/a": try: font = Font(fontname) asc = font.ascender dsc = font.descender except: asc *= 1.2 dsc *= 1.2 else: asc *= 1.2 dsc *= 1.2 return fontname, ext, stype, asc, dsc def get_char_widths( doc: Document, xref: int, limit: int = 256, idx: int = 0, fontdict: OptDict = None ) -> list: """Get list of glyph information of a font. Notes: Must be provided by its XREF number. If we already dealt with the font, it will be recorded in doc.FontInfos. Otherwise we insert an entry there. Finally we return the glyphs for the font. This is a list of (glyph, width) where glyph is an integer controlling the char appearance, and width is a float controlling the char's spacing: width * fontsize is the actual space. For 'simple' fonts, glyph == ord(char) will usually be true. Exceptions are 'Symbol' and 'ZapfDingbats'. We are providing data for these directly here. """ fontinfo = CheckFontInfo(doc, xref) if fontinfo is None: # not recorded yet: create it if fontdict is None: name, ext, stype, asc, dsc = _get_font_properties(doc, xref) fontdict = { "name": name, "type": stype, "ext": ext, "ascender": asc, "descender": dsc, } else: name = fontdict["name"] ext = fontdict["ext"] stype = fontdict["type"] ordering = fontdict["ordering"] simple = fontdict["simple"] if ext == "": raise ValueError("xref is not a font") # check for 'simple' fonts if stype in ("Type1", "MMType1", "TrueType"): simple = True else: simple = False # check for CJK fonts if name in ("Fangti", "Ming"): ordering = 0 elif name in ("Heiti", "Song"): ordering = 1 elif name in ("Gothic", "Mincho"): ordering = 2 elif name in ("Dotum", "Batang"): ordering = 3 else: ordering = -1 fontdict["simple"] = simple if name == "ZapfDingbats": glyphs = zapf_glyphs elif name == "Symbol": glyphs = symbol_glyphs else: glyphs = None fontdict["glyphs"] = glyphs fontdict["ordering"] = ordering fontinfo = [xref, fontdict] doc.FontInfos.append(fontinfo) else: fontdict = fontinfo[1] glyphs = fontdict["glyphs"] simple = fontdict["simple"] ordering = fontdict["ordering"] if glyphs is None: oldlimit = 0 else: oldlimit = len(glyphs) mylimit = max(256, limit) if mylimit <= oldlimit: return glyphs if ordering < 0: # not a CJK font glyphs = doc._get_char_widths( xref, fontdict["name"], fontdict["ext"], fontdict["ordering"], mylimit, idx ) else: # CJK fonts use char codes and width = 1 glyphs = None fontdict["glyphs"] = glyphs fontinfo[1] = fontdict UpdateFontInfo(doc, fontinfo) return glyphs class Shape(object): """Create a new shape.""" @staticmethod def horizontal_angle(C, P): """Return the angle to the horizontal for the connection from C to P. This uses the arcus sine function and resolves its inherent ambiguity by looking up in which quadrant vector S = P - C is located. """ S = Point(P - C).unit # unit vector 'C' -> 'P' alfa = math.asin(abs(S.y)) # absolute angle from horizontal if S.x < 0: # make arcsin result unique if S.y <= 0: # bottom-left alfa = -(math.pi - alfa) else: # top-left alfa = math.pi - alfa else: if S.y >= 0: # top-right pass else: # bottom-right alfa = -alfa return alfa def __init__(self, page: Page): CheckParent(page) self.page = page self.doc = page.parent if not self.doc.is_pdf: raise ValueError("is no PDF") self.height = page.mediabox_size.y self.width = page.mediabox_size.x self.x = page.cropbox_position.x self.y = page.cropbox_position.y self.pctm = page.transformation_matrix # page transf. matrix self.ipctm = ~self.pctm # inverted transf. matrix self.draw_cont = "" self.text_cont = "" self.totalcont = "" self.lastPoint = None self.rect = None def updateRect(self, x): if self.rect is None: if len(x) == 2: self.rect = Rect(x, x) else: self.rect = Rect(x) else: if len(x) == 2: x = Point(x) self.rect.x0 = min(self.rect.x0, x.x) self.rect.y0 = min(self.rect.y0, x.y) self.rect.x1 = max(self.rect.x1, x.x) self.rect.y1 = max(self.rect.y1, x.y) else: x = Rect(x) self.rect.x0 = min(self.rect.x0, x.x0) self.rect.y0 = min(self.rect.y0, x.y0) self.rect.x1 = max(self.rect.x1, x.x1) self.rect.y1 = max(self.rect.y1, x.y1) def draw_line(self, p1: point_like, p2: point_like) -> Point: """Draw a line between two points.""" p1 = Point(p1) p2 = Point(p2) if not (self.lastPoint == p1): self.draw_cont += "%g %g m\n" % JM_TUPLE(p1 * self.ipctm) self.lastPoint = p1 self.updateRect(p1) self.draw_cont += "%g %g l\n" % JM_TUPLE(p2 * self.ipctm) self.updateRect(p2) self.lastPoint = p2 return self.lastPoint def draw_polyline(self, points: list) -> Point: """Draw several connected line segments.""" for i, p in enumerate(points): if i == 0: if not (self.lastPoint == Point(p)): self.draw_cont += "%g %g m\n" % JM_TUPLE(Point(p) * self.ipctm) self.lastPoint = Point(p) else: self.draw_cont += "%g %g l\n" % JM_TUPLE(Point(p) * self.ipctm) self.updateRect(p) self.lastPoint = Point(points[-1]) return self.lastPoint def draw_bezier( self, p1: point_like, p2: point_like, p3: point_like, p4: point_like, ) -> Point: """Draw a standard cubic Bezier curve.""" p1 = Point(p1) p2 = Point(p2) p3 = Point(p3) p4 = Point(p4) if not (self.lastPoint == p1): self.draw_cont += "%g %g m\n" % JM_TUPLE(p1 * self.ipctm) self.draw_cont += "%g %g %g %g %g %g c\n" % JM_TUPLE( list(p2 * self.ipctm) + list(p3 * self.ipctm) + list(p4 * self.ipctm) ) self.updateRect(p1) self.updateRect(p2) self.updateRect(p3) self.updateRect(p4) self.lastPoint = p4 return self.lastPoint def draw_oval(self, tetra: typing.Union[quad_like, rect_like]) -> Point: """Draw an ellipse inside a tetrapod.""" if len(tetra) != 4: raise ValueError("invalid arg length") if hasattr(tetra[0], "__float__"): q = Rect(tetra).quad else: q = Quad(tetra) mt = q.ul + (q.ur - q.ul) * 0.5 mr = q.ur + (q.lr - q.ur) * 0.5 mb = q.ll + (q.lr - q.ll) * 0.5 ml = q.ul + (q.ll - q.ul) * 0.5 if not (self.lastPoint == ml): self.draw_cont += "%g %g m\n" % JM_TUPLE(ml * self.ipctm) self.lastPoint = ml self.draw_curve(ml, q.ll, mb) self.draw_curve(mb, q.lr, mr) self.draw_curve(mr, q.ur, mt) self.draw_curve(mt, q.ul, ml) self.updateRect(q.rect) self.lastPoint = ml return self.lastPoint def draw_circle(self, center: point_like, radius: float) -> Point: """Draw a circle given its center and radius.""" if not radius > EPSILON: raise ValueError("radius must be positive") center = Point(center) p1 = center - (radius, 0) return self.draw_sector(center, p1, 360, fullSector=False) def draw_curve( self, p1: point_like, p2: point_like, p3: point_like, ) -> Point: """Draw a curve between points using one control point.""" kappa = 0.55228474983 p1 = Point(p1) p2 = Point(p2) p3 = Point(p3) k1 = p1 + (p2 - p1) * kappa k2 = p3 + (p2 - p3) * kappa return self.draw_bezier(p1, k1, k2, p3) def draw_sector( self, center: point_like, point: point_like, beta: float, fullSector: bool = True, ) -> Point: """Draw a circle sector.""" center = Point(center) point = Point(point) l3 = "%g %g m\n" l4 = "%g %g %g %g %g %g c\n" l5 = "%g %g l\n" betar = math.radians(-beta) w360 = math.radians(math.copysign(360, betar)) * (-1) w90 = math.radians(math.copysign(90, betar)) w45 = w90 / 2 while abs(betar) > 2 * math.pi: betar += w360 # bring angle below 360 degrees if not (self.lastPoint == point): self.draw_cont += l3 % JM_TUPLE(point * self.ipctm) self.lastPoint = point Q = Point(0, 0) # just make sure it exists C = center P = point S = P - C # vector 'center' -> 'point' rad = abs(S) # circle radius if not rad > EPSILON: raise ValueError("radius must be positive") alfa = self.horizontal_angle(center, point) while abs(betar) > abs(w90): # draw 90 degree arcs q1 = C.x + math.cos(alfa + w90) * rad q2 = C.y + math.sin(alfa + w90) * rad Q = Point(q1, q2) # the arc's end point r1 = C.x + math.cos(alfa + w45) * rad / math.cos(w45) r2 = C.y + math.sin(alfa + w45) * rad / math.cos(w45) R = Point(r1, r2) # crossing point of tangents kappah = (1 - math.cos(w45)) * 4 / 3 / abs(R - Q) kappa = kappah * abs(P - Q) cp1 = P + (R - P) * kappa # control point 1 cp2 = Q + (R - Q) * kappa # control point 2 self.draw_cont += l4 % JM_TUPLE( list(cp1 * self.ipctm) + list(cp2 * self.ipctm) + list(Q * self.ipctm) ) betar -= w90 # reduce parm angle by 90 deg alfa += w90 # advance start angle by 90 deg P = Q # advance to arc end point # draw (remaining) arc if abs(betar) > 1e-3: # significant degrees left? beta2 = betar / 2 q1 = C.x + math.cos(alfa + betar) * rad q2 = C.y + math.sin(alfa + betar) * rad Q = Point(q1, q2) # the arc's end point r1 = C.x + math.cos(alfa + beta2) * rad / math.cos(beta2) r2 = C.y + math.sin(alfa + beta2) * rad / math.cos(beta2) R = Point(r1, r2) # crossing point of tangents # kappa height is 4/3 of segment height kappah = (1 - math.cos(beta2)) * 4 / 3 / abs(R - Q) # kappa height kappa = kappah * abs(P - Q) / (1 - math.cos(betar)) cp1 = P + (R - P) * kappa # control point 1 cp2 = Q + (R - Q) * kappa # control point 2 self.draw_cont += l4 % JM_TUPLE( list(cp1 * self.ipctm) + list(cp2 * self.ipctm) + list(Q * self.ipctm) ) if fullSector: self.draw_cont += l3 % JM_TUPLE(point * self.ipctm) self.draw_cont += l5 % JM_TUPLE(center * self.ipctm) self.draw_cont += l5 % JM_TUPLE(Q * self.ipctm) self.lastPoint = Q return self.lastPoint def draw_rect(self, rect: rect_like, *, radius=None) -> Point: """Draw a rectangle. Args: radius: if not None, the rectangle will have rounded corners. This is the radius of the curvature, given as percentage of the rectangle width or height. Valid are values 0 < v <= 0.5. For a sequence of two values, the corners will have different radii. Otherwise, the percentage will be computed from the shorter side. A value of (0.5, 0.5) will draw an ellipse. """ r = Rect(rect) if radius == None: # standard rectangle self.draw_cont += "%g %g %g %g re\n" % JM_TUPLE( list(r.bl * self.ipctm) + [r.width, r.height] ) self.updateRect(r) self.lastPoint = r.tl return self.lastPoint # rounded corners requested. This requires 1 or 2 values, each # with 0 < value <= 0.5 if hasattr(radius, "__float__"): if radius <= 0 or radius > 0.5: raise ValueError(f"bad radius value {radius}.") d = min(r.width, r.height) * radius px = (d, 0) py = (0, d) elif hasattr(radius, "__len__") and len(radius) == 2: rx, ry = radius px = (rx * r.width, 0) py = (0, ry * r.height) if min(rx, ry) <= 0 or max(rx, ry) > 0.5: raise ValueError(f"bad radius value {radius}.") else: raise ValueError(f"bad radius value {radius}.") lp = self.draw_line(r.tl + py, r.bl - py) lp = self.draw_curve(lp, r.bl, r.bl + px) lp = self.draw_line(lp, r.br - px) lp = self.draw_curve(lp, r.br, r.br - py) lp = self.draw_line(lp, r.tr + py) lp = self.draw_curve(lp, r.tr, r.tr - px) lp = self.draw_line(lp, r.tl + px) self.lastPoint = self.draw_curve(lp, r.tl, r.tl + py) self.updateRect(r) return self.lastPoint def draw_quad(self, quad: quad_like) -> Point: """Draw a Quad.""" q = Quad(quad) return self.draw_polyline([q.ul, q.ll, q.lr, q.ur, q.ul]) def draw_zigzag( self, p1: point_like, p2: point_like, breadth: float = 2, ) -> Point: """Draw a zig-zagged line from p1 to p2.""" p1 = Point(p1) p2 = Point(p2) S = p2 - p1 # vector start - end rad = abs(S) # distance of points cnt = 4 * int(round(rad / (4 * breadth), 0)) # always take full phases if cnt < 4: raise ValueError("points too close") mb = rad / cnt # revised breadth matrix = Matrix(util_hor_matrix(p1, p2)) # normalize line to x-axis i_mat = ~matrix # get original position points = [] # stores edges for i in range(1, cnt): if i % 4 == 1: # point "above" connection p = Point(i, -1) * mb elif i % 4 == 3: # point "below" connection p = Point(i, 1) * mb else: # ignore others continue points.append(p * i_mat) self.draw_polyline([p1] + points + [p2]) # add start and end points return p2 def draw_squiggle( self, p1: point_like, p2: point_like, breadth=2, ) -> Point: """Draw a squiggly line from p1 to p2.""" p1 = Point(p1) p2 = Point(p2) S = p2 - p1 # vector start - end rad = abs(S) # distance of points cnt = 4 * int(round(rad / (4 * breadth), 0)) # always take full phases if cnt < 4: raise ValueError("points too close") mb = rad / cnt # revised breadth matrix = Matrix(util_hor_matrix(p1, p2)) # normalize line to x-axis i_mat = ~matrix # get original position k = 2.4142135623765633 # y of draw_curve helper point points = [] # stores edges for i in range(1, cnt): if i % 4 == 1: # point "above" connection p = Point(i, -k) * mb elif i % 4 == 3: # point "below" connection p = Point(i, k) * mb else: # else on connection line p = Point(i, 0) * mb points.append(p * i_mat) points = [p1] + points + [p2] cnt = len(points) i = 0 while i + 2 < cnt: self.draw_curve(points[i], points[i + 1], points[i + 2]) i += 2 return p2 # ============================================================================== # Shape.insert_text # ============================================================================== def insert_text( self, point: point_like, buffer: typing.Union[str, list], fontsize: float = 11, lineheight: OptFloat = None, fontname: str = "helv", fontfile: OptStr = None, set_simple: bool = 0, encoding: int = 0, color: OptSeq = None, fill: OptSeq = None, render_mode: int = 0, border_width: float = 0.05, rotate: int = 0, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> int: # ensure 'text' is a list of strings, worth dealing with if not bool(buffer): return 0 if type(buffer) not in (list, tuple): text = buffer.splitlines() else: text = buffer if not len(text) > 0: return 0 point = Point(point) try: maxcode = max([ord(c) for c in " ".join(text)]) except: return 0 # ensure valid 'fontname' fname = fontname if fname.startswith("/"): fname = fname[1:] xref = self.page.insert_font( fontname=fname, fontfile=fontfile, encoding=encoding, set_simple=set_simple ) fontinfo = CheckFontInfo(self.doc, xref) fontdict = fontinfo[1] ordering = fontdict["ordering"] simple = fontdict["simple"] bfname = fontdict["name"] ascender = fontdict["ascender"] descender = fontdict["descender"] if lineheight: lheight = fontsize * lineheight elif ascender - descender <= 1: lheight = fontsize * 1.2 else: lheight = fontsize * (ascender - descender) if maxcode > 255: glyphs = self.doc.get_char_widths(xref, maxcode + 1) else: glyphs = fontdict["glyphs"] tab = [] for t in text: if simple and bfname not in ("Symbol", "ZapfDingbats"): g = None else: g = glyphs tab.append(getTJstr(t, g, simple, ordering)) text = tab color_str = ColorCode(color, "c") fill_str = ColorCode(fill, "f") if not fill and render_mode == 0: # ensure fill color when 0 Tr fill = color fill_str = ColorCode(color, "f") morphing = CheckMorph(morph) rot = rotate if rot % 90 != 0: raise ValueError("bad rotate value") while rot < 0: rot += 360 rot = rot % 360 # text rotate = 0, 90, 270, 180 templ1 = "\nq\n%s%sBT\n%s1 0 0 1 %g %g Tm\n/%s %g Tf " templ2 = "TJ\n0 -%g TD\n" cmp90 = "0 1 -1 0 0 0 cm\n" # rotates 90 deg counter-clockwise cmm90 = "0 -1 1 0 0 0 cm\n" # rotates 90 deg clockwise cm180 = "-1 0 0 -1 0 0 cm\n" # rotates by 180 deg. height = self.height width = self.width # setting up for standard rotation directions # case rotate = 0 if morphing: m1 = Matrix(1, 0, 0, 1, morph[0].x + self.x, height - morph[0].y - self.y) mat = ~m1 * morph[1] * m1 cm = "%g %g %g %g %g %g cm\n" % JM_TUPLE(mat) else: cm = "" top = height - point.y - self.y # start of 1st char left = point.x + self.x # start of 1. char space = top # space available headroom = point.y + self.y # distance to page border if rot == 90: left = height - point.y - self.y top = -point.x - self.x cm += cmp90 space = width - abs(top) headroom = point.x + self.x elif rot == 270: left = -height + point.y + self.y top = point.x + self.x cm += cmm90 space = abs(top) headroom = width - point.x - self.x elif rot == 180: left = -point.x - self.x top = -height + point.y + self.y cm += cm180 space = abs(point.y + self.y) headroom = height - point.y - self.y optcont = self.page._get_optional_content(oc) if optcont != None: bdc = "/OC /%s BDC\n" % optcont emc = "EMC\n" else: bdc = emc = "" alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha == None: alpha = "" else: alpha = "/%s gs\n" % alpha nres = templ1 % (bdc, alpha, cm, left, top, fname, fontsize) if render_mode > 0: nres += "%i Tr " % render_mode nres += "%g w " % (border_width * fontsize) if color is not None: nres += color_str if fill is not None: nres += fill_str # ========================================================================= # start text insertion # ========================================================================= nres += text[0] nlines = 1 # set output line counter if len(text) > 1: nres += templ2 % lheight # line 1 else: nres += templ2[:2] for i in range(1, len(text)): if space < lheight: break # no space left on page if i > 1: nres += "\nT* " nres += text[i] + templ2[:2] space -= lheight nlines += 1 nres += "\nET\n%sQ\n" % emc # ===================================================================== # end of text insertion # ===================================================================== # update the /Contents object self.text_cont += nres return nlines # ========================================================================= # Shape.insert_textbox # ========================================================================= def insert_textbox( self, rect: rect_like, buffer: typing.Union[str, list], fontname: OptStr = "helv", fontfile: OptStr = None, fontsize: float = 11, lineheight: OptFloat = None, set_simple: bool = 0, encoding: int = 0, color: OptSeq = None, fill: OptSeq = None, expandtabs: int = 1, border_width: float = 0.05, align: int = 0, render_mode: int = 0, rotate: int = 0, morph: OptSeq = None, stroke_opacity: float = 1, fill_opacity: float = 1, oc: int = 0, ) -> float: """Insert text into a given rectangle. Args: rect -- the textbox to fill buffer -- text to be inserted fontname -- a Base-14 font, font name or '/name' fontfile -- name of a font file fontsize -- font size lineheight -- overwrite the font property color -- RGB stroke color triple fill -- RGB fill color triple render_mode -- text rendering control border_width -- thickness of glyph borders as percentage of fontsize expandtabs -- handles tabulators with string function align -- left, center, right, justified rotate -- 0, 90, 180, or 270 degrees morph -- morph box with a matrix and a fixpoint Returns: unused or deficit rectangle area (float) """ rect = Rect(rect) if rect.is_empty or rect.is_infinite: raise ValueError("text box must be finite and not empty") color_str = ColorCode(color, "c") fill_str = ColorCode(fill, "f") if fill is None and render_mode == 0: # ensure fill color for 0 Tr fill = color fill_str = ColorCode(color, "f") optcont = self.page._get_optional_content(oc) if optcont != None: bdc = "/OC /%s BDC\n" % optcont emc = "EMC\n" else: bdc = emc = "" # determine opacity / transparency alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha == None: alpha = "" else: alpha = "/%s gs\n" % alpha if rotate % 90 != 0: raise ValueError("rotate must be multiple of 90") rot = rotate while rot < 0: rot += 360 rot = rot % 360 # is buffer worth of dealing with? if not bool(buffer): return rect.height if rot in (0, 180) else rect.width cmp90 = "0 1 -1 0 0 0 cm\n" # rotates counter-clockwise cmm90 = "0 -1 1 0 0 0 cm\n" # rotates clockwise cm180 = "-1 0 0 -1 0 0 cm\n" # rotates by 180 deg. height = self.height fname = fontname if fname.startswith("/"): fname = fname[1:] xref = self.page.insert_font( fontname=fname, fontfile=fontfile, encoding=encoding, set_simple=set_simple ) fontinfo = CheckFontInfo(self.doc, xref) fontdict = fontinfo[1] ordering = fontdict["ordering"] simple = fontdict["simple"] glyphs = fontdict["glyphs"] bfname = fontdict["name"] ascender = fontdict["ascender"] descender = fontdict["descender"] if lineheight: lheight_factor = lineheight elif ascender - descender <= 1: lheight_factor = 1.2 else: lheight_factor = ascender - descender lheight = fontsize * lheight_factor # create a list from buffer, split into its lines if type(buffer) in (list, tuple): t0 = "\n".join(buffer) else: t0 = buffer maxcode = max([ord(c) for c in t0]) # replace invalid char codes for simple fonts if simple and maxcode > 255: t0 = "".join([c if ord(c) < 256 else "?" for c in t0]) t0 = t0.splitlines() glyphs = self.doc.get_char_widths(xref, maxcode + 1) if simple and bfname not in ("Symbol", "ZapfDingbats"): tj_glyphs = None else: tj_glyphs = glyphs # ---------------------------------------------------------------------- # calculate pixel length of a string # ---------------------------------------------------------------------- def pixlen(x): """Calculate pixel length of x.""" if ordering < 0: return sum([glyphs[ord(c)][1] for c in x]) * fontsize else: return len(x) * fontsize # --------------------------------------------------------------------- if ordering < 0: blen = glyphs[32][1] * fontsize # pixel size of space character else: blen = fontsize text = "" # output buffer if CheckMorph(morph): m1 = Matrix( 1, 0, 0, 1, morph[0].x + self.x, self.height - morph[0].y - self.y ) mat = ~m1 * morph[1] * m1 cm = "%g %g %g %g %g %g cm\n" % JM_TUPLE(mat) else: cm = "" # --------------------------------------------------------------------- # adjust for text orientation / rotation # --------------------------------------------------------------------- progr = 1 # direction of line progress c_pnt = Point(0, fontsize * ascender) # used for line progress if rot == 0: # normal orientation point = rect.tl + c_pnt # line 1 is 'lheight' below top maxwidth = rect.width # pixels available in one line maxheight = rect.height # available text height elif rot == 90: # rotate counter clockwise c_pnt = Point(fontsize * ascender, 0) # progress in x-direction point = rect.bl + c_pnt # line 1 'lheight' away from left maxwidth = rect.height # pixels available in one line maxheight = rect.width # available text height cm += cmp90 elif rot == 180: # text upside down # progress upwards in y direction c_pnt = -Point(0, fontsize * ascender) point = rect.br + c_pnt # line 1 'lheight' above bottom maxwidth = rect.width # pixels available in one line progr = -1 # subtract lheight for next line maxheight = rect.height # available text height cm += cm180 else: # rotate clockwise (270 or -90) # progress from right to left c_pnt = -Point(fontsize * ascender, 0) point = rect.tr + c_pnt # line 1 'lheight' left of right maxwidth = rect.height # pixels available in one line progr = -1 # subtract lheight for next line maxheight = rect.width # available text height cm += cmm90 # ===================================================================== # line loop # ===================================================================== just_tab = [] # 'justify' indicators per line for i, line in enumerate(t0): line_t = line.expandtabs(expandtabs).split(" ") # split into words num_words = len(line_t) lbuff = "" # init line buffer rest = maxwidth # available line pixels # ================================================================= # word loop # ================================================================= for j in range(num_words): word = line_t[j] pl_w = pixlen(word) # pixel len of word if rest >= pl_w: # does it fit on the line? lbuff += word + " " # yes, append word rest -= pl_w + blen # update available line space continue # next word # word doesn't fit - output line (if not empty) if lbuff: lbuff = lbuff.rstrip() + "\n" # line full, append line break text += lbuff # append to total text just_tab.append(True) # can align-justify lbuff = "" # re-init line buffer rest = maxwidth # re-init avail. space if pl_w <= maxwidth: # word shorter than 1 line? lbuff = word + " " # start the line with it rest = maxwidth - pl_w - blen # update free space continue # long word: split across multiple lines - char by char ... if len(just_tab) > 0: just_tab[-1] = False # cannot align-justify for c in word: if pixlen(lbuff) <= maxwidth - pixlen(c): lbuff += c else: # line full lbuff += "\n" # close line text += lbuff # append to text just_tab.append(False) # cannot align-justify lbuff = c # start new line with this char lbuff += " " # finish long word rest = maxwidth - pixlen(lbuff) # long word stored if lbuff: # unprocessed line content? text += lbuff.rstrip() # append to text just_tab.append(False) # cannot align-justify if i < len(t0) - 1: # not the last line? text += "\n" # insert line break # compute used part of the textbox if text.endswith("\n"): text = text[:-1] lb_count = text.count("\n") + 1 # number of lines written # text height = line count * line height plus one descender value text_height = lheight * lb_count - descender * fontsize more = text_height - maxheight # difference to height limit if more > EPSILON: # landed too much outside rect return (-1) * more # return deficit, don't output more = abs(more) if more < EPSILON: more = 0 # don't bother with epsilons nres = "\nq\n%s%sBT\n" % (bdc, alpha) + cm # initialize output buffer templ = "1 0 0 1 %g %g Tm /%s %g Tf " # center, right, justify: output each line with its own specifics text_t = text.splitlines() # split text in lines again just_tab[-1] = False # never justify last line for i, t in enumerate(text_t): pl = maxwidth - pixlen(t) # length of empty line part pnt = point + c_pnt * (i * lheight_factor) # text start of line if align == 1: # center: right shift by half width if rot in (0, 180): pnt = pnt + Point(pl / 2, 0) * progr else: pnt = pnt - Point(0, pl / 2) * progr elif align == 2: # right: right shift by full width if rot in (0, 180): pnt = pnt + Point(pl, 0) * progr else: pnt = pnt - Point(0, pl) * progr elif align == 3: # justify spaces = t.count(" ") # number of spaces in line if spaces > 0 and just_tab[i]: # if any, and we may justify spacing = pl / spaces # make every space this much larger else: spacing = 0 # keep normal space length top = height - pnt.y - self.y left = pnt.x + self.x if rot == 90: left = height - pnt.y - self.y top = -pnt.x - self.x elif rot == 270: left = -height + pnt.y + self.y top = pnt.x + self.x elif rot == 180: left = -pnt.x - self.x top = -height + pnt.y + self.y nres += templ % (left, top, fname, fontsize) if render_mode > 0: nres += "%i Tr " % render_mode nres += "%g w " % (border_width * fontsize) if align == 3: nres += "%g Tw " % spacing if color is not None: nres += color_str if fill is not None: nres += fill_str nres += "%sTJ\n" % getTJstr(t, tj_glyphs, simple, ordering) nres += "ET\n%sQ\n" % emc self.text_cont += nres self.updateRect(rect) return more def finish( self, width: float = 1, color: OptSeq = (0,), fill: OptSeq = None, lineCap: int = 0, lineJoin: int = 0, dashes: OptStr = None, even_odd: bool = False, morph: OptSeq = None, closePath: bool = True, fill_opacity: float = 1, stroke_opacity: float = 1, oc: int = 0, ) -> None: """Finish the current drawing segment. Notes: Apply colors, opacity, dashes, line style and width, or morphing. Also whether to close the path by connecting last to first point. """ if self.draw_cont == "": # treat empty contents as no-op return if width == 0: # border color makes no sense then color = None elif color == None: # vice versa width = 0 # if color == None and fill == None: # raise ValueError("at least one of 'color' or 'fill' must be given") color_str = ColorCode(color, "c") # ensure proper color string fill_str = ColorCode(fill, "f") # ensure proper fill string optcont = self.page._get_optional_content(oc) if optcont is not None: self.draw_cont = "/OC /%s BDC\n" % optcont + self.draw_cont emc = "EMC\n" else: emc = "" alpha = self.page._set_opacity(CA=stroke_opacity, ca=fill_opacity) if alpha != None: self.draw_cont = "/%s gs\n" % alpha + self.draw_cont if width != 1 and width != 0: self.draw_cont += "%g w\n" % width if lineCap != 0: self.draw_cont = "%i J\n" % lineCap + self.draw_cont if lineJoin != 0: self.draw_cont = "%i j\n" % lineJoin + self.draw_cont if dashes not in (None, "", "[] 0"): self.draw_cont = "%s d\n" % dashes + self.draw_cont if closePath: self.draw_cont += "h\n" self.lastPoint = None if color is not None: self.draw_cont += color_str if fill is not None: self.draw_cont += fill_str if color is not None: if not even_odd: self.draw_cont += "B\n" else: self.draw_cont += "B*\n" else: if not even_odd: self.draw_cont += "f\n" else: self.draw_cont += "f*\n" else: self.draw_cont += "S\n" self.draw_cont += emc if CheckMorph(morph): m1 = Matrix( 1, 0, 0, 1, morph[0].x + self.x, self.height - morph[0].y - self.y ) mat = ~m1 * morph[1] * m1 self.draw_cont = "%g %g %g %g %g %g cm\n" % JM_TUPLE(mat) + self.draw_cont self.totalcont += "\nq\n" + self.draw_cont + "Q\n" self.draw_cont = "" self.lastPoint = None return def commit(self, overlay: bool = True) -> None: """Update the page's /Contents object with Shape data. The argument controls whether data appear in foreground (default) or background.""" CheckParent(self.page) # doc may have died meanwhile self.totalcont += self.text_cont self.totalcont = self.totalcont.encode() if self.totalcont != b"": # make /Contents object with dummy stream xref = TOOLS._insert_contents(self.page, b" ", overlay) # update it with potential compression self.doc.update_stream(xref, self.totalcont) self.lastPoint = None # clean up ... self.rect = None # self.draw_cont = "" # for potential ... self.text_cont = "" # ... self.totalcont = "" # re-use return def apply_redactions(page: Page, images: int = 2) -> bool: """Apply the redaction annotations of the page. Args: page: the PDF page. images: 0 - ignore images, 1 - remove complete overlapping image, 2 - blank out overlapping image parts. """ def center_rect(annot_rect, text, font, fsize): """Calculate minimal sub-rectangle for the overlay text. Notes: Because 'insert_textbox' supports no vertical text centering, we calculate an approximate number of lines here and return a sub-rect with smaller height, which should still be sufficient. Args: annot_rect: the annotation rectangle text: the text to insert. font: the fontname. Must be one of the CJK or Base-14 set, else the rectangle is returned unchanged. fsize: the fontsize Returns: A rectangle to use instead of the annot rectangle. """ if not text: return annot_rect try: text_width = get_text_length(text, font, fsize) except ValueError: # unsupported font return annot_rect line_height = fsize * 1.2 limit = annot_rect.width h = math.ceil(text_width / limit) * line_height # estimate rect height if h >= annot_rect.height: return annot_rect r = annot_rect y = (annot_rect.tl.y + annot_rect.bl.y - h) * 0.5 r.y0 = y return r CheckParent(page) doc = page.parent if doc.is_encrypted or doc.is_closed: raise ValueError("document closed or encrypted") if not doc.is_pdf: raise ValueError("is no PDF") redact_annots = [] # storage of annot values for annot in page.annots(types=(PDF_ANNOT_REDACT,)): # loop redactions redact_annots.append(annot._get_redact_values()) # save annot values if redact_annots == []: # any redactions on this page? return False # no redactions rc = page._apply_redactions(images) # call MuPDF redaction process step if not rc: # should not happen really raise ValueError("Error applying redactions.") # now write replacement text in old redact rectangles shape = page.new_shape() for redact in redact_annots: annot_rect = redact["rect"] fill = redact["fill"] if fill: shape.draw_rect(annot_rect) # colorize the rect background shape.finish(fill=fill, color=fill) if "text" in redact.keys(): # if we also have text text = redact["text"] align = redact.get("align", 0) fname = redact["fontname"] fsize = redact["fontsize"] color = redact["text_color"] # try finding vertical centered sub-rect trect = center_rect(annot_rect, text, fname, fsize) rc = -1 while rc < 0 and fsize >= 4: # while not enough room # (re-) try insertion rc = shape.insert_textbox( trect, text, fontname=fname, fontsize=fsize, color=color, align=align, ) fsize -= 0.5 # reduce font if unsuccessful shape.commit() # append new contents object return True # ------------------------------------------------------------------------------ # Remove potentially sensitive data from a PDF. Similar to the Adobe # Acrobat 'sanitize' function # ------------------------------------------------------------------------------ def scrub( doc: Document, attached_files: bool = True, clean_pages: bool = True, embedded_files: bool = True, hidden_text: bool = True, javascript: bool = True, metadata: bool = True, redactions: bool = True, redact_images: int = 0, remove_links: bool = True, reset_fields: bool = True, reset_responses: bool = True, thumbnails: bool = True, xml_metadata: bool = True, ) -> None: def remove_hidden(cont_lines): """Remove hidden text from a PDF page. Args: cont_lines: list of lines with /Contents content. Should have status from after page.cleanContents(). Returns: List of /Contents lines from which hidden text has been removed. Notes: The input must have been created after the page's /Contents object(s) have been cleaned with page.cleanContents(). This ensures a standard formatting: one command per line, single spaces between operators. This allows for drastic simplification of this code. """ out_lines = [] # will return this in_text = False # indicate if within BT/ET object suppress = False # indicate text suppression active make_return = False for line in cont_lines: if line == b"BT": # start of text object in_text = True # switch on out_lines.append(line) # output it continue if line == b"ET": # end of text object in_text = False # switch off out_lines.append(line) # output it continue if line == b"3 Tr": # text suppression operator suppress = True # switch on make_return = True continue if line[-2:] == b"Tr" and line[0] != b"3": suppress = False # text rendering changed out_lines.append(line) continue if line == b"Q": # unstack command also switches off suppress = False out_lines.append(line) continue if suppress and in_text: # suppress hidden lines continue out_lines.append(line) if make_return: return out_lines else: return None if not doc.is_pdf: # only works for PDF raise ValueError("is no PDF") if doc.is_encrypted or doc.is_closed: raise ValueError("closed or encrypted doc") if clean_pages is False: hidden_text = False redactions = False if metadata: doc.set_metadata({}) # remove standard metadata for page in doc: if reset_fields: # reset form fields (widgets) for widget in page.widgets(): widget.reset() if remove_links: links = page.get_links() # list of all links on page for link in links: # remove all links page.delete_link(link) found_redacts = False for annot in page.annots(): if annot.type[0] == PDF_ANNOT_FILE_ATTACHMENT and attached_files: annot.update_file(buffer=b" ") # set file content to empty if reset_responses: annot.delete_responses() if annot.type[0] == PDF_ANNOT_REDACT: found_redacts = True if redactions and found_redacts: page.apply_redactions(images=redact_images) if not (clean_pages or hidden_text): continue # done with the page page.clean_contents() if not page.get_contents(): continue if hidden_text: xref = page.get_contents()[0] # only one b/o cleaning! cont = doc.xref_stream(xref) cont_lines = remove_hidden(cont.splitlines()) # remove hidden text if cont_lines: # something was actually removed cont = b"\n".join(cont_lines) doc.update_stream(xref, cont) # rewrite the page /Contents if thumbnails: # remove page thumbnails? if doc.xref_get_key(page.xref, "Thumb")[0] != "null": doc.xref_set_key(page.xref, "Thumb", "null") # pages are scrubbed, now perform document-wide scrubbing # remove embedded files if embedded_files: for name in doc.embfile_names(): doc.embfile_del(name) if xml_metadata: doc.del_xml_metadata() if not (xml_metadata or javascript): xref_limit = 0 else: xref_limit = doc.xref_length() for xref in range(1, xref_limit): if not doc.xref_object(xref): msg = "bad xref %i - clean PDF before scrubbing" % xref raise ValueError(msg) if javascript and doc.xref_get_key(xref, "S")[1] == "/JavaScript": # a /JavaScript action object obj = "<>" # replace with a null JavaScript doc.update_object(xref, obj) # update this object continue # no further handling if not xml_metadata: continue if doc.xref_get_key(xref, "Type")[1] == "/Metadata": # delete any metadata object directly doc.update_object(xref, "<<>>") doc.update_stream(xref, b"deleted", new=True) continue if doc.xref_get_key(xref, "Metadata")[0] != "null": doc.xref_set_key(xref, "Metadata", "null") def fill_textbox( writer: TextWriter, rect: rect_like, text: typing.Union[str, list], pos: point_like = None, font: typing.Optional[Font] = None, fontsize: float = 11, lineheight: OptFloat = None, align: int = 0, warn: bool = None, right_to_left: bool = False, small_caps: bool = False, ) -> tuple: """Fill a rectangle with text. Args: writer: TextWriter object (= "self") rect: rect-like to receive the text. text: string or list/tuple of strings. pos: point-like start position of first word. font: Font object (default Font('helv')). fontsize: the fontsize. lineheight: overwrite the font property align: (int) 0 = left, 1 = center, 2 = right, 3 = justify warn: (bool) text overflow action: none, warn, or exception right_to_left: (bool) indicate right-to-left language. """ rect = Rect(rect) if rect.is_empty: raise ValueError("fill rect must not empty.") if type(font) is not Font: font = Font("helv") def textlen(x): """Return length of a string.""" return font.text_length( x, fontsize=fontsize, small_caps=small_caps ) # abbreviation def char_lengths(x): """Return list of single character lengths for a string.""" return font.char_lengths(x, fontsize=fontsize, small_caps=small_caps) def append_this(pos, text): return writer.append( pos, text, font=font, fontsize=fontsize, small_caps=small_caps ) tolerance = fontsize * 0.2 # extra distance to left border space_len = textlen(" ") std_width = rect.width - tolerance std_start = rect.x0 + tolerance def norm_words(width, words): """Cut any word in pieces no longer than 'width'.""" nwords = [] word_lengths = [] for w in words: wl_lst = char_lengths(w) wl = sum(wl_lst) if wl <= width: # nothing to do - copy over nwords.append(w) word_lengths.append(wl) continue # word longer than rect width - split it in parts n = len(wl_lst) while n > 0: wl = sum(wl_lst[:n]) if wl <= width: nwords.append(w[:n]) word_lengths.append(wl) w = w[n:] wl_lst = wl_lst[n:] n = len(wl_lst) else: n -= 1 return nwords, word_lengths def output_justify(start, line): """Justified output of a line.""" # ignore leading / trailing / multiple spaces words = [w for w in line.split(" ") if w != ""] nwords = len(words) if nwords == 0: return if nwords == 1: # single word cannot be justified append_this(start, words[0]) return tl = sum([textlen(w) for w in words]) # total word lengths gaps = nwords - 1 # number of word gaps gapl = (std_width - tl) / gaps # width of each gap for w in words: _, lp = append_this(start, w) # output one word start.x = lp.x + gapl # next start at word end plus gap return asc = font.ascender dsc = font.descender if not lineheight: if asc - dsc <= 1: lheight = 1.2 else: lheight = asc - dsc else: lheight = lineheight LINEHEIGHT = fontsize * lheight # effective line height width = std_width # available horizontal space # starting point of text if pos is not None: pos = Point(pos) else: # default is just below rect top-left pos = rect.tl + (tolerance, fontsize * asc) if not pos in rect: raise ValueError("Text must start in rectangle.") # calculate displacement factor for alignment if align == TEXT_ALIGN_CENTER: factor = 0.5 elif align == TEXT_ALIGN_RIGHT: factor = 1.0 else: factor = 0 # split in lines if just a string was given if type(text) is str: textlines = text.splitlines() else: textlines = [] for line in text: textlines.extend(line.splitlines()) max_lines = int((rect.y1 - pos.y) / LINEHEIGHT) + 1 new_lines = [] # the final list of textbox lines no_justify = [] # no justify for these line numbers for i, line in enumerate(textlines): if line in ("", " "): new_lines.append((line, space_len)) width = rect.width - tolerance no_justify.append((len(new_lines) - 1)) continue if i == 0: width = rect.x1 - pos.x else: width = rect.width - tolerance if right_to_left: # reverses Arabic / Hebrew text front to back line = writer.clean_rtl(line) tl = textlen(line) if tl <= width: # line short enough new_lines.append((line, tl)) no_justify.append((len(new_lines) - 1)) continue # we need to split the line in fitting parts words = line.split(" ") # the words in the line # cut in parts any words that are longer than rect width words, word_lengths = norm_words(std_width, words) n = len(words) while True: line0 = " ".join(words[:n]) wl = sum(word_lengths[:n]) + space_len * (len(word_lengths[:n]) - 1) if wl <= width: new_lines.append((line0, wl)) words = words[n:] word_lengths = word_lengths[n:] n = len(words) line0 = None else: n -= 1 if len(words) == 0: break # ------------------------------------------------------------------------- # List of lines created. Each item is (text, tl), where 'tl' is the PDF # output length (float) and 'text' is the text. Except for justified text, # this is output-ready. # ------------------------------------------------------------------------- nlines = len(new_lines) if nlines > max_lines: msg = "Only fitting %i of %i lines." % (max_lines, nlines) if warn == True: print("Warning: " + msg) elif warn == False: raise ValueError(msg) start = Point() no_justify += [len(new_lines) - 1] # no justifying of last line for i in range(max_lines): try: line, tl = new_lines.pop(0) except IndexError: break if right_to_left: # Arabic, Hebrew line = "".join(reversed(line)) if i == 0: # may have different start for first line start = pos if align == TEXT_ALIGN_JUSTIFY and i not in no_justify and tl < std_width: output_justify(start, line) start.x = std_start start.y += LINEHEIGHT continue if i > 0 or pos.x == std_start: # left, center, right alignments start.x += (width - tl) * factor append_this(start, line) start.x = std_start start.y += LINEHEIGHT return new_lines # return non-written lines # ------------------------------------------------------------------------ # Optional Content functions # ------------------------------------------------------------------------ def get_oc(doc: Document, xref: int) -> int: """Return optional content object xref for an image or form xobject. Args: xref: (int) xref number of an image or form xobject. """ if doc.is_closed or doc.is_encrypted: raise ValueError("document close or encrypted") t, name = doc.xref_get_key(xref, "Subtype") if t != "name" or name not in ("/Image", "/Form"): raise ValueError("bad object type at xref %i" % xref) t, oc = doc.xref_get_key(xref, "OC") if t != "xref": return 0 rc = int(oc.replace("0 R", "")) return rc def set_oc(doc: Document, xref: int, oc: int) -> None: """Attach optional content object to image or form xobject. Args: xref: (int) xref number of an image or form xobject oc: (int) xref number of an OCG or OCMD """ if doc.is_closed or doc.is_encrypted: raise ValueError("document close or encrypted") t, name = doc.xref_get_key(xref, "Subtype") if t != "name" or name not in ("/Image", "/Form"): raise ValueError("bad object type at xref %i" % xref) if oc > 0: t, name = doc.xref_get_key(oc, "Type") if t != "name" or name not in ("/OCG", "/OCMD"): raise ValueError("bad object type at xref %i" % oc) if oc == 0 and "OC" in doc.xref_get_keys(xref): doc.xref_set_key(xref, "OC", "null") return None doc.xref_set_key(xref, "OC", "%i 0 R" % oc) return None def set_ocmd( doc: Document, xref: int = 0, ocgs: typing.Union[list, None] = None, policy: OptStr = None, ve: typing.Union[list, None] = None, ) -> int: """Create or update an OCMD object in a PDF document. Args: xref: (int) 0 for creating a new object, otherwise update existing one. ocgs: (list) OCG xref numbers, which shall be subject to 'policy'. policy: one of 'AllOn', 'AllOff', 'AnyOn', 'AnyOff' (any casing). ve: (list) visibility expression. Use instead of 'ocgs' with 'policy'. Returns: Xref of the created or updated OCMD. """ all_ocgs = set(doc.get_ocgs().keys()) def ve_maker(ve): if type(ve) not in (list, tuple) or len(ve) < 2: raise ValueError("bad 've' format: %s" % ve) if ve[0].lower() not in ("and", "or", "not"): raise ValueError("bad operand: %s" % ve[0]) if ve[0].lower() == "not" and len(ve) != 2: raise ValueError("bad 've' format: %s" % ve) item = "[/%s" % ve[0].title() for x in ve[1:]: if type(x) is int: if x not in all_ocgs: raise ValueError("bad OCG %i" % x) item += " %i 0 R" % x else: item += " %s" % ve_maker(x) item += "]" return item text = "< dict: """Return the definition of an OCMD (optional content membership dictionary). Recognizes PDF dict keys /OCGs (PDF array of OCGs), /P (policy string) and /VE (visibility expression, PDF array). Via string manipulation, this info is converted to a Python dictionary with keys "xref", "ocgs", "policy" and "ve" - ready to recycle as input for 'set_ocmd()'. """ if xref not in range(doc.xref_length()): raise ValueError("bad xref") text = doc.xref_object(xref, compressed=True) if "/Type/OCMD" not in text: raise ValueError("bad object type") textlen = len(text) p0 = text.find("/OCGs[") # look for /OCGs key p1 = text.find("]", p0) if p0 < 0 or p1 < 0: # no OCGs found ocgs = None else: ocgs = text[p0 + 6 : p1].replace("0 R", " ").split() ocgs = list(map(int, ocgs)) p0 = text.find("/P/") # look for /P policy key if p0 < 0: policy = None else: p1 = text.find("ff", p0) if p1 < 0: p1 = text.find("on", p0) if p1 < 0: # some irregular syntax raise ValueError("bad object at xref") else: policy = text[p0 + 3 : p1 + 2] p0 = text.find("/VE[") # look for /VE visibility expression key if p0 < 0: # no visibility expression found ve = None else: lp = rp = 0 # find end of /VE by finding last ']'. p1 = p0 while lp < 1 or lp != rp: p1 += 1 if not p1 < textlen: # some irregular syntax raise ValueError("bad object at xref") if text[p1] == "[": lp += 1 if text[p1] == "]": rp += 1 # p1 now positioned at the last "]" ve = text[p0 + 3 : p1 + 1] # the PDF /VE array ve = ( ve.replace("/And", '"and",') .replace("/Not", '"not",') .replace("/Or", '"or",') ) ve = ve.replace(" 0 R]", "]").replace(" 0 R", ",").replace("][", "],[") try: ve = json.loads(ve) except: print("bad /VE key: ", ve) raise return {"xref": xref, "ocgs": ocgs, "policy": policy, "ve": ve} """ Handle page labels for PDF documents. Reading ------- * compute the label of a page * find page number(s) having the given label. Writing ------- Supports setting (defining) page labels for PDF documents. A big Thank You goes to WILLIAM CHAPMAN who contributed the idea and significant parts of the following code during late December 2020 through early January 2021. """ def rule_dict(item): """Make a Python dict from a PDF page label rule. Args: item -- a tuple (pno, rule) with the start page number and the rule string like <>. Returns: A dict like {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. """ # Jorj McKie, 2021-01-06 pno, rule = item rule = rule[2:-2].split("/")[1:] # strip "<<" and ">>" d = {"startpage": pno, "prefix": "", "firstpagenum": 1} skip = False for i, item in enumerate(rule): if skip: # this item has already been processed skip = False # deactivate skipping again continue if item == "S": # style specification d["style"] = rule[i + 1] # next item has the style skip = True # do not process next item again continue if item.startswith("P"): # prefix specification: extract the string x = item[1:].replace("(", "").replace(")", "") d["prefix"] = x continue if item.startswith("St"): # start page number specification x = int(item[2:]) d["firstpagenum"] = x return d def get_label_pno(pgNo, labels): """Return the label for this page number. Args: pgNo: page number, 0-based. labels: result of doc._get_page_labels(). Returns: The label (str) of the page number. Errors return an empty string. """ # Jorj McKie, 2021-01-06 item = [x for x in labels if x[0] <= pgNo][-1] rule = rule_dict(item) prefix = rule.get("prefix", "") style = rule.get("style", "") pagenumber = pgNo - rule["startpage"] + rule["firstpagenum"] return construct_label(style, prefix, pagenumber) def get_label(page): """Return the label for this PDF page. Args: page: page object. Returns: The label (str) of the page. Errors return an empty string. """ # Jorj McKie, 2021-01-06 labels = page.parent._get_page_labels() if not labels: return "" labels.sort() return get_label_pno(page.number, labels) def get_page_numbers(doc, label, only_one=False): """Return a list of page numbers with the given label. Args: doc: PDF document object (resp. 'self'). label: (str) label. only_one: (bool) stop searching after first hit. Returns: List of page numbers having this label. """ # Jorj McKie, 2021-01-06 numbers = [] if not label: return numbers labels = doc._get_page_labels() if labels == []: return numbers for i in range(doc.page_count): plabel = get_label_pno(i, labels) if plabel == label: numbers.append(i) if only_one: break return numbers def construct_label(style, prefix, pno) -> str: """Construct a label based on style, prefix and page number.""" # William Chapman, 2021-01-06 n_str = "" if style == "D": n_str = str(pno) elif style == "r": n_str = integerToRoman(pno).lower() elif style == "R": n_str = integerToRoman(pno).upper() elif style == "a": n_str = integerToLetter(pno).lower() elif style == "A": n_str = integerToLetter(pno).upper() result = prefix + n_str return result def integerToLetter(i) -> str: """Returns letter sequence string for integer i.""" # William Chapman, Jorj McKie, 2021-01-06 ls = string.ascii_uppercase n, a = 1, i while pow(26, n) <= a: a -= int(math.pow(26, n)) n += 1 str_t = "" for j in reversed(range(n)): f, g = divmod(a, int(math.pow(26, j))) str_t += ls[f] a = g return str_t def integerToRoman(num: int) -> str: """Return roman numeral for an integer.""" # William Chapman, Jorj McKie, 2021-01-06 roman = ( (1000, "M"), (900, "CM"), (500, "D"), (400, "CD"), (100, "C"), (90, "XC"), (50, "L"), (40, "XL"), (10, "X"), (9, "IX"), (5, "V"), (4, "IV"), (1, "I"), ) def roman_num(num): for r, ltr in roman: x, _ = divmod(num, r) yield ltr * x num -= r * x if num <= 0: break return "".join([a for a in roman_num(num)]) def get_page_labels(doc): """Return page label definitions in PDF document. Args: doc: PDF document (resp. 'self'). Returns: A list of dictionaries with the following format: {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. """ # Jorj McKie, 2021-01-10 return [rule_dict(item) for item in doc._get_page_labels()] def set_page_labels(doc, labels): """Add / replace page label definitions in PDF document. Args: doc: PDF document (resp. 'self'). labels: list of label dictionaries like: {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}, as returned by get_page_labels(). """ # William Chapman, 2021-01-06 def create_label_str(label): """Convert Python label dict to correspnding PDF rule string. Args: label: (dict) build rule for the label. Returns: PDF label rule string wrapped in "<<", ">>". """ s = "%i<<" % label["startpage"] if label.get("prefix", "") != "": s += "/P(%s)" % label["prefix"] if label.get("style", "") != "": s += "/S/%s" % label["style"] if label.get("firstpagenum", 1) > 1: s += "/St %i" % label["firstpagenum"] s += ">>" return s def create_nums(labels): """Return concatenated string of all labels rules. Args: labels: (list) dictionaries as created by function 'rule_dict'. Returns: PDF compatible string for page label definitions, ready to be enclosed in PDF array 'Nums[...]'. """ labels.sort(key=lambda x: x["startpage"]) s = "".join([create_label_str(label) for label in labels]) return s doc._set_page_labels(create_nums(labels)) # End of Page Label Code ------------------------------------------------- def has_links(doc: Document) -> bool: """Check whether there are links on any page.""" if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") for i in range(doc.page_count): for item in doc.page_annot_xrefs(i): if item[1] == PDF_ANNOT_LINK: return True return False def has_annots(doc: Document) -> bool: """Check whether there are annotations on any page.""" if doc.is_closed: raise ValueError("document closed") if not doc.is_pdf: raise ValueError("is no PDF") for i in range(doc.page_count): for item in doc.page_annot_xrefs(i): if not (item[1] == PDF_ANNOT_LINK or item[1] == PDF_ANNOT_WIDGET): return True return False # ------------------------------------------------------------------- # Functions to recover the quad contained in a text extraction bbox # ------------------------------------------------------------------- def recover_bbox_quad(line_dir: tuple, span: dict, bbox: tuple) -> Quad: """Compute the quad located inside the bbox. The bbox may be any of the resp. tuples occurring inside the given span. Args: line_dir: (tuple) 'line["dir"]' of the owning line or None. span: (dict) the span. May be from get_texttrace() method. bbox: (tuple) the bbox of the span or any of its characters. Returns: The quad which is wrapped by the bbox. """ if line_dir == None: line_dir = span["dir"] cos, sin = line_dir bbox = Rect(bbox) # make it a rect if TOOLS.set_small_glyph_heights(): # ==> just fontsize as height d = 1 else: d = span["ascender"] - span["descender"] height = d * span["size"] # the quad's rectangle height # The following are distances from the bbox corners, at wich we find the # respective quad points. The computation depends on in which quadrant # the text writing angle is located. hs = height * sin hc = height * cos if hc >= 0 and hs <= 0: # quadrant 1 ul = bbox.bl - (0, hc) ur = bbox.tr + (hs, 0) ll = bbox.bl - (hs, 0) lr = bbox.tr + (0, hc) elif hc <= 0 and hs <= 0: # quadrant 2 ul = bbox.br + (hs, 0) ur = bbox.tl - (0, hc) ll = bbox.br + (0, hc) lr = bbox.tl - (hs, 0) elif hc <= 0 and hs >= 0: # quadrant 3 ul = bbox.tr - (0, hc) ur = bbox.bl + (hs, 0) ll = bbox.tr - (hs, 0) lr = bbox.bl + (0, hc) else: # quadrant 4 ul = bbox.tl + (hs, 0) ur = bbox.br - (0, hc) ll = bbox.tl + (0, hc) lr = bbox.br - (hs, 0) return Quad(ul, ur, ll, lr) def recover_quad(line_dir: tuple, span: dict) -> Quad: """Recover the quadrilateral of a text span. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: the span. Returns: The quadrilateral enveloping the span's text. """ if type(line_dir) is not tuple or len(line_dir) != 2: raise ValueError("bad line dir argument") if type(span) is not dict: raise ValueError("bad span argument") return recover_bbox_quad(line_dir, span, span["bbox"]) def recover_line_quad(line: dict, spans: list = None) -> Quad: """Calculate the line quad for 'dict' / 'rawdict' text extractions. The lower quad points are those of the first, resp. last span quad. The upper points are determined by the maximum span quad height. From this, compute a rect with bottom-left in (0, 0), convert this to a quad and rotate and shift back to cover the text of the spans. Args: spans: (list, optional) sub-list of spans to consider. Returns: Quad covering selected spans. """ if spans == None: # no sub-selection spans = line["spans"] # all spans if len(spans) == 0: raise ValueError("bad span list") line_dir = line["dir"] # text direction cos, sin = line_dir q0 = recover_quad(line_dir, spans[0]) # quad of first span if len(spans) > 1: # get quad of last span q1 = recover_quad(line_dir, spans[-1]) else: q1 = q0 # last = first line_ll = q0.ll # lower-left of line quad line_lr = q1.lr # lower-right of line quad mat0 = planish_line(line_ll, line_lr) # map base line to x-axis such that line_ll goes to (0, 0) x_lr = line_lr * mat0 small = TOOLS.set_small_glyph_heights() # small glyph heights? h = max( [s["size"] * (1 if small else (s["ascender"] - s["descender"])) for s in spans] ) line_rect = Rect(0, -h, x_lr.x, 0) # line rectangle line_quad = line_rect.quad # make it a quad and: line_quad *= ~mat0 return line_quad def recover_span_quad(line_dir: tuple, span: dict, chars: list = None) -> Quad: """Calculate the span quad for 'dict' / 'rawdict' text extractions. Notes: There are two execution paths: 1. For the full span quad, the result of 'recover_quad' is returned. 2. For the quad of a sub-list of characters, the char quads are computed and joined. This is only supported for the "rawdict" extraction option. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: (dict) the span. chars: (list, optional) sub-list of characters to consider. Returns: Quad covering selected characters. """ if line_dir == None: # must be a span from get_texttrace() line_dir = span["dir"] if chars == None: # no sub-selection return recover_quad(line_dir, span) if not "chars" in span.keys(): raise ValueError("need 'rawdict' option to sub-select chars") q0 = recover_char_quad(line_dir, span, chars[0]) # quad of first char if len(chars) > 1: # get quad of last char q1 = recover_char_quad(line_dir, span, chars[-1]) else: q1 = q0 # last = first span_ll = q0.ll # lower-left of span quad span_lr = q1.lr # lower-right of span quad mat0 = planish_line(span_ll, span_lr) # map base line to x-axis such that span_ll goes to (0, 0) x_lr = span_lr * mat0 small = TOOLS.set_small_glyph_heights() # small glyph heights? h = span["size"] * (1 if small else (span["ascender"] - span["descender"])) span_rect = Rect(0, -h, x_lr.x, 0) # line rectangle span_quad = span_rect.quad # make it a quad and: span_quad *= ~mat0 # rotate back and shift back return span_quad def recover_char_quad(line_dir: tuple, span: dict, char: dict) -> Quad: """Recover the quadrilateral of a text character. This requires the "rawdict" option of text extraction. Args: line_dir: (tuple) 'line["dir"]' of the span's line. span: (dict) the span dict. char: (dict) the character dict. Returns: The quadrilateral enveloping the character. """ if line_dir == None: line_dir = span["dir"] if type(line_dir) is not tuple or len(line_dir) != 2: raise ValueError("bad line dir argument") if type(span) is not dict: raise ValueError("bad span argument") if type(char) is dict: bbox = Rect(char["bbox"]) elif type(char) is tuple: bbox = Rect(char[3]) else: raise ValueError("bad span argument") return recover_bbox_quad(line_dir, span, bbox) # ------------------------------------------------------------------- # Building font subsets using fontTools # ------------------------------------------------------------------- def subset_fonts(doc: Document, verbose: bool = False) -> None: """Build font subsets of a PDF. Requires package 'fontTools'. Eligible fonts are potentially replaced by smaller versions. Page text is NOT rewritten and thus should retain properties like being hidden or controlled by optional content. """ # Font binaries: - "buffer" -> (names, xrefs, (unicodes, glyphs)) # An embedded font is uniquely defined by its fontbuffer only. It may have # multiple names and xrefs. # Once the sets of used unicodes and glyphs are known, we compute a # smaller version of the buffer user package fontTools. font_buffers = {} def get_old_widths(xref): """Retrieve old font '/W' and '/DW' values.""" df = doc.xref_get_key(xref, "DescendantFonts") if df[0] != "array": # only handle xref specifications return None, None df_xref = int(df[1][1:-1].replace("0 R", "")) widths = doc.xref_get_key(df_xref, "W") if widths[0] != "array": # no widths key found widths = None else: widths = widths[1] dwidths = doc.xref_get_key(df_xref, "DW") if dwidths[0] != "int": dwidths = None else: dwidths = dwidths[1] return widths, dwidths def set_old_widths(xref, widths, dwidths): """Restore the old '/W' and '/DW' in subsetted font. If either parameter is None or evaluates to False, the corresponding dictionary key will be set to null. """ df = doc.xref_get_key(xref, "DescendantFonts") if df[0] != "array": # only handle xref specs return None df_xref = int(df[1][1:-1].replace("0 R", "")) if (type(widths) is not str or not widths) and doc.xref_get_key(df_xref, "W")[ 0 ] != "null": doc.xref_set_key(df_xref, "W", "null") else: doc.xref_set_key(df_xref, "W", widths) if (type(dwidths) is not str or not dwidths) and doc.xref_get_key( df_xref, "DW" )[0] != "null": doc.xref_set_key(df_xref, "DW", "null") else: doc.xref_set_key(df_xref, "DW", dwidths) return None def set_subset_fontname(new_xref): """Generate a name prefix to tag a font as subset. We use a random generator to select 6 upper case ASCII characters. The prefixed name must be put in the font xref as the "/BaseFont" value and in the FontDescriptor object as the '/FontName' value. """ # The following generates a prefix like 'ABCDEF+' prefix = "".join(random.choices(tuple(string.ascii_uppercase), k=6)) + "+" font_str = doc.xref_object(new_xref, compressed=True) font_str = font_str.replace("/BaseFont/", "/BaseFont/" + prefix) df = doc.xref_get_key(new_xref, "DescendantFonts") if df[0] == "array": df_xref = int(df[1][1:-1].replace("0 R", "")) fd = doc.xref_get_key(df_xref, "FontDescriptor") if fd[0] == "xref": fd_xref = int(fd[1].replace("0 R", "")) fd_str = doc.xref_object(fd_xref, compressed=True) fd_str = fd_str.replace("/FontName/", "/FontName/" + prefix) doc.update_object(fd_xref, fd_str) doc.update_object(new_xref, font_str) return None def build_subset(buffer, unc_set, gid_set): """Build font subset using fontTools. Args: buffer: (bytes) the font given as a binary buffer. unc_set: (set) required glyph ids. Returns: Either None if subsetting is unsuccessful or the subset font buffer. """ try: import fontTools.subset as fts except ImportError: print("This method requires fontTools to be installed.") raise tmp_dir = tempfile.gettempdir() oldfont_path = f"{tmp_dir}/oldfont.ttf" newfont_path = f"{tmp_dir}/newfont.ttf" uncfile_path = f"{tmp_dir}/uncfile.txt" args = [ oldfont_path, "--retain-gids", f"--output-file={newfont_path}", "--layout-features='*'", "--passthrough-tables", "--ignore-missing-glyphs", "--ignore-missing-unicodes", "--symbol-cmap", ] unc_file = open( f"{tmp_dir}/uncfile.txt", "w" ) # store glyph ids or unicodes as file if 0xFFFD in unc_set: # error unicode exists -> use glyphs args.append(f"--gids-file={uncfile_path}") gid_set.add(189) unc_list = list(gid_set) for unc in unc_list: unc_file.write("%i\n" % unc) else: args.append(f"--unicodes-file={uncfile_path}") unc_set.add(255) unc_list = list(unc_set) for unc in unc_list: unc_file.write("%04x\n" % unc) unc_file.close() fontfile = open(oldfont_path, "wb") # store fontbuffer as a file fontfile.write(buffer) fontfile.close() try: os.remove(newfont_path) # remove old file except: pass try: # invoke fontTools subsetter fts.main(args) font = Font(fontfile=newfont_path) new_buffer = font.buffer if len(font.valid_codepoints()) == 0: new_buffer = None except: new_buffer = None try: os.remove(uncfile_path) except: pass try: os.remove(oldfont_path) except: pass try: os.remove(newfont_path) except: pass return new_buffer def repl_fontnames(doc): """Populate 'font_buffers'. For each font candidate, store its xref and the list of names by which PDF text may refer to it (there may be multiple). """ def norm_name(name): """Recreate font name that contains PDF hex codes. E.g. #20 -> space, chr(32) """ while "#" in name: p = name.find("#") c = int(name[p + 1 : p + 3], 16) name = name.replace(name[p : p + 3], chr(c)) return name def get_fontnames(doc, item): """Return a list of fontnames for an item of page.get_fonts(). There may be multiple names e.g. for Type0 fonts. """ fontname = item[3] names = [fontname] fontname = doc.xref_get_key(item[0], "BaseFont")[1][1:] fontname = norm_name(fontname) if fontname not in names: names.append(fontname) descendents = doc.xref_get_key(item[0], "DescendantFonts") if descendents[0] != "array": return names descendents = descendents[1][1:-1] if descendents.endswith(" 0 R"): xref = int(descendents[:-4]) descendents = doc.xref_object(xref, compressed=True) p1 = descendents.find("/BaseFont") if p1 >= 0: p2 = descendents.find("/", p1 + 1) p1 = min(descendents.find("/", p2 + 1), descendents.find(">>", p2 + 1)) fontname = descendents[p2 + 1 : p1] fontname = norm_name(fontname) if fontname not in names: names.append(fontname) return names for i in range(doc.page_count): for f in doc.get_page_fonts(i, full=True): font_xref = f[0] # font xref font_ext = f[1] # font file extension basename = f[3] # font basename if font_ext not in ( # skip if not supported by fontTools "otf", "ttf", "woff", "woff2", ): continue # skip fonts which already are subsets if len(basename) > 6 and basename[6] == "+": continue extr = doc.extract_font(font_xref) fontbuffer = extr[-1] names = get_fontnames(doc, f) name_set, xref_set, subsets = font_buffers.get( fontbuffer, (set(), set(), (set(), set())) ) xref_set.add(font_xref) for name in names: name_set.add(name) font = Font(fontbuffer=fontbuffer) name_set.add(font.name) del font font_buffers[fontbuffer] = (name_set, xref_set, subsets) return None def find_buffer_by_name(name): for buffer in font_buffers.keys(): name_set, _, _ = font_buffers[buffer] if name in name_set: return buffer return None # ----------------- # main function # ----------------- repl_fontnames(doc) # populate font information if not font_buffers: # nothing found to do if verbose: print("No fonts to subset.") return 0 old_fontsize = 0 new_fontsize = 0 for fontbuffer in font_buffers.keys(): old_fontsize += len(fontbuffer) # Scan page text for usage of subsettable fonts for page in doc: # go through the text and extend set of used glyphs by font # we use a modified MuPDF trace device, which delivers us glyph ids. for span in page.get_texttrace(): if type(span) is not dict: # skip useless information continue fontname = span["font"][:33] # fontname for the span buffer = find_buffer_by_name(fontname) if buffer is None: continue name_set, xref_set, (set_ucs, set_gid) = font_buffers[buffer] for c in span["chars"]: set_ucs.add(c[0]) # unicode set_gid.add(c[1]) # glyph id font_buffers[buffer] = (name_set, xref_set, (set_ucs, set_gid)) # build the font subsets for old_buffer in font_buffers.keys(): name_set, xref_set, subsets = font_buffers[old_buffer] new_buffer = build_subset(old_buffer, subsets[0], subsets[1]) fontname = list(name_set)[0] if new_buffer == None or len(new_buffer) >= len(old_buffer): # subset was not created or did not get smaller if verbose: print(f"Cannot subset '{fontname}'.") continue if verbose: print(f"Built subset of font '{fontname}'.") val = doc._insert_font(fontbuffer=new_buffer) # store subset font in PDF new_xref = val[0] # get its xref set_subset_fontname(new_xref) # tag fontname as subset font font_str = doc.xref_object( # get its object definition new_xref, compressed=True, ) # walk through the original font xrefs and replace each by the subset def for font_xref in xref_set: # we need the original '/W' and '/DW' width values width_table, def_width = get_old_widths(font_xref) # ... and replace original font definition at xref with it doc.update_object(font_xref, font_str) # now copy over old '/W' and '/DW' values if width_table or def_width: set_old_widths(font_xref, width_table, def_width) # 'new_xref' remains unused in the PDF and must be removed # by garbage collection. new_fontsize += len(new_buffer) return old_fontsize - new_fontsize # ------------------------------------------------------------------- # Copy XREF object to another XREF # ------------------------------------------------------------------- def xref_copy(doc: Document, source: int, target: int, *, keep: list = None) -> None: """Copy a PDF dictionary object to another one given their xref numbers. Args: doc: PDF document object source: source xref number target: target xref number, the xref must already exist keep: an optional list of 1st level keys in target that should not be removed before copying. Notes: This works similar to the copy() method of dictionaries in Python. The source may be a stream object. """ if doc.xref_is_stream(source): # read new xref stream, maintaining compression stream = doc.xref_stream_raw(source) doc.update_stream( target, stream, compress=False, # keeps source compression new=True, # in case target is no stream ) # empty the target completely, observe exceptions if keep is None: keep = [] for key in doc.xref_get_keys(target): if key in keep: continue doc.xref_set_key(target, key, "null") # copy over all source dict items for key in doc.xref_get_keys(source): item = doc.xref_get_key(source, key) doc.xref_set_key(target, key, item[1]) return None ================================================ FILE: src_classic/version.i ================================================ %pythoncode %{ VersionFitz = "1.24.1" # MuPDF version. VersionBind = "1.24.1" # PyMuPDF version. VersionDate = "2024-04-02 00:00:01" version = (VersionBind, VersionFitz, "20240402000001") pymupdf_version_tuple = tuple( [int(i) for i in VersionFitz.split('.')]) %} ================================================ FILE: tests/README.md ================================================ # PyMuPDF tests To run these tests: * Create and enter a venv. * Install PyMuPDF. * Install the Python packages listed in `PyMuPDF/scripts/gh_release.py:test_packages`. * Run pytest on the PyMuPDF directory. For example, as of 2023-12-11: ``` > python -m pip install pytest fontTools psutil pymupdf-fonts pillow > pytest PyMuPDF ============================= test session starts ============================== platform linux -- Python 3.11.2, pytest-7.4.3, pluggy-1.3.0 rootdir: /home/jules/artifex-remote/PyMuPDF configfile: pytest.ini collected 171 items PyMuPDF/tests/test_2548.py . [ 0%] PyMuPDF/tests/test_2634.py . [ 1%] PyMuPDF/tests/test_2736.py . [ 1%] PyMuPDF/tests/test_2791.py . [ 2%] PyMuPDF/tests/test_2861.py . [ 2%] PyMuPDF/tests/test_annots.py .................. [ 13%] PyMuPDF/tests/test_badfonts.py . [ 14%] PyMuPDF/tests/test_crypting.py . [ 14%] PyMuPDF/tests/test_docs_samples.py ............. [ 22%] PyMuPDF/tests/test_drawings.py ...... [ 25%] PyMuPDF/tests/test_embeddedfiles.py . [ 26%] PyMuPDF/tests/test_extractimage.py .. [ 27%] PyMuPDF/tests/test_flake8.py . [ 28%] PyMuPDF/tests/test_font.py ..... [ 30%] PyMuPDF/tests/test_general.py .......................................... [ 55%] ... [ 57%] PyMuPDF/tests/test_geometry.py ........ [ 61%] PyMuPDF/tests/test_imagebbox.py .. [ 63%] PyMuPDF/tests/test_insertimage.py .. [ 64%] PyMuPDF/tests/test_insertpdf.py .. [ 65%] PyMuPDF/tests/test_linequad.py . [ 66%] PyMuPDF/tests/test_metadata.py .. [ 67%] PyMuPDF/tests/test_nonpdf.py ... [ 69%] PyMuPDF/tests/test_object_manipulation.py .... [ 71%] PyMuPDF/tests/test_optional_content.py .. [ 72%] PyMuPDF/tests/test_pagedelete.py . [ 73%] PyMuPDF/tests/test_pagelabels.py . [ 73%] PyMuPDF/tests/test_pixmap.py .......... [ 79%] PyMuPDF/tests/test_showpdfpage.py . [ 80%] PyMuPDF/tests/test_story.py ... [ 81%] PyMuPDF/tests/test_tables.py ... [ 83%] PyMuPDF/tests/test_tesseract.py . [ 84%] PyMuPDF/tests/test_textbox.py ...... [ 87%] PyMuPDF/tests/test_textextract.py .. [ 88%] PyMuPDF/tests/test_textsearch.py .. [ 90%] PyMuPDF/tests/test_toc.py ........ [ 94%] PyMuPDF/tests/test_widgets.py ........ [ 99%] PyMuPDF/tests/test_word_delimiters.py . [100%] ======================== 171 passed in 78.65s (0:01:18) ======================== > ``` ## Known test failure with non-default build of MuPDF If PyMuPDF has been built with a non-default build of MuPDF (using environmental variable ``PYMUPDF_SETUP_MUPDF_BUILD``), it is possible that ``tests/test_textbox.py:test_textbox3()`` will fail, because it relies on MuPDF having been built with PyMuPDF's customized configuration, ``fitz/_config.h``. One can skip this particular test by adding ``-k 'not test_textbox3'`` to the pytest command line. ## Resuming at a particular test. To skip tests before a particular test, set PYMUPDF_PYTEST_RESUME to the name of the function. For example PYMUPDF_PYTEST_RESUME=test_haslinks. ## Checks on all tests All tests are wrapped by tests/conftest.py:wrap(), which does additional checking. * Checks that pymupdf.TOOLS.mupdf_warnings() is empty. * Checks tests do not modify globals such as small_glyph_heights. ================================================ FILE: tests/conftest.py ================================================ import copy import os import platform import subprocess import sys import pytest # Install required packages. There doesn't seem to be any official way for # us to programmatically specify required test packages in setup.py, or in # pytest. Doing it here seems to be the least ugly approach. # # However our diagnostics do not show up so this can cause an unfortunate pause # before tests start to run. # def install_required_packages(): PYODIDE_ROOT = os.environ.get('PYODIDE_ROOT') if PYODIDE_ROOT: # We can't run child processes, so rely on required test packages # already being installed, e.g. in our wheel's . return packages = 'pytest fontTools pymupdf-fonts flake8 pylint codespell mypy' packages += ' pipcl' if platform.system() == 'Windows' and int.bit_length(sys.maxsize+1) == 32: # No pillow wheel available, and doesn't build easily. pass elif platform.python_implementation() == 'GraalVM': pass else: packages += ' pillow' if platform.system().startswith('MSYS_NT-'): # psutil not available on msys2. pass else: packages += ' psutil' command = f'pip install --upgrade {packages}' print(f'{__file__}:install_required_packages)(): Running: {command}', flush=1) subprocess.run(command, shell=1, check=1) install_required_packages() @pytest.fixture(scope="session", autouse=True) def log_global_env_facts(record_testsuite_property): record_testsuite_property('platform.python_version()', platform.python_version()) # Need to import pymupdf only after we've installed pymupdf-fonts above, # because pymupdf imports pymupdf_fonts, and copes with import failure. import pymupdf PYMUPDF_PYTEST_RESUME = os.environ.get('PYMUPDF_PYTEST_RESUME') @pytest.fixture(autouse=True) def wrap(request): ''' Check that tests return with empty MuPDF warnings buffer. For example this detects failure to call fz_close_output() before fz_drop_output(), which (as of 2024-4-12) generates a warning from MuPDF. As of 2024-09-12 we also detect whether tests leave fds open; but for now do not fail tests, because many tests need fixing. ''' global PYMUPDF_PYTEST_RESUME if PYMUPDF_PYTEST_RESUME: # Skip all tests until we reach a matching name. if PYMUPDF_PYTEST_RESUME == request.function.__name__: print(f'### {PYMUPDF_PYTEST_RESUME=}: resuming at {request.function.__name__=}.') PYMUPDF_PYTEST_RESUME = None else: print(f'### {PYMUPDF_PYTEST_RESUME=}: Skipping {request.function.__name__=}.') return wt = pymupdf.TOOLS.mupdf_warnings() assert not wt, f'{wt=}' if platform.python_implementation() == 'GraalVM': pymupdf.TOOLS.set_small_glyph_heights() else: assert not pymupdf.TOOLS.set_small_glyph_heights() next_fd_before = os.open(__file__, os.O_RDONLY) os.close(next_fd_before) if platform.system() == 'Linux' and platform.python_implementation() != 'GraalVM': test_fds = True else: test_fds = False if test_fds: # Gather detailed information about leaked fds. def get_fds(): import subprocess path = 'PyMuPDF-linx-fds' path_l = 'PyMuPDF-linx-fds-l' command = f'ls /proc/{os.getpid()}/fd > {path}' command_l = f'ls -l /proc/{os.getpid()}/fd > {path_l}' subprocess.run(command, shell=1) subprocess.run(command_l, shell=1) with open(path) as f: ret = f.read() ret = ret.replace('\n', ' ') with open(path_l) as f: ret_l = f.read() return ret, ret_l open_fds_before, open_fds_before_l = get_fds() pymupdf._log_items_clear() pymupdf._log_items_active(True) JM_annot_id_stem = pymupdf.JM_annot_id_stem def get_members(a): ret = dict() for n in dir(a): if not n.startswith('_'): v = getattr(a, n) ret[n] = v return ret # Allow post-test checking that pymupdf._globals has not changed. _globals_pre = get_members(pymupdf._globals) testsfailed_before = request.session.testsfailed # Run the test. rep = yield sys.stdout.flush() # This seems the only way for us to tell that a test has failed. In # particular, is always None. We're implicitly relying on tests not # being run in parallel. # failed = request.session.testsfailed - testsfailed_before assert failed in (0, 1) if failed: # Do not check post-test conditions if the test as failed. This avoids # additional confusing `ERROR` status for failed tests. return # Test has run; check it did not create any MuPDF warnings etc. wt = pymupdf.TOOLS.mupdf_warnings() if not hasattr(pymupdf, 'mupdf'): print(f'Not checking mupdf_warnings on classic.') else: assert not wt, f'Warnings text not empty: {wt=}' assert not pymupdf.TOOLS.set_small_glyph_heights() _globals_post = get_members(pymupdf._globals) if _globals_post != _globals_pre: print(f'Test has changed pymupdf._globals from {_globals_pre=} to {_globals_post=}') assert 0 log_items = pymupdf._log_items() assert not log_items, f'log() was called; {len(log_items)=}.' assert pymupdf.JM_annot_id_stem == JM_annot_id_stem, \ f'pymupdf.JM_annot_id_stem has changed from {JM_annot_id_stem!r} to {pymupdf.JM_annot_id_stem!r}' if test_fds: # Show detailed information about leaked fds. open_fds_after, open_fds_after_l = get_fds() if open_fds_after != open_fds_before: import textwrap print(f'Test has changed process fds:') print(f' {open_fds_before=}') print(f' {open_fds_after=}') print(f'open_fds_before_l:') print(textwrap.indent(open_fds_before_l, ' ')) print(f'open_fds_after_l:') print(textwrap.indent(open_fds_after_l, ' ')) #assert 0 next_fd_after = os.open(__file__, os.O_RDONLY) os.close(next_fd_after) if test_fds and next_fd_after != next_fd_before: print(f'Test has leaked fds, {next_fd_before=} {next_fd_after=}.') #assert 0, f'Test has leaked fds, {next_fd_before=} {next_fd_after=}. {args=} {kwargs=}.' if 0: # This code can be useful to track down test failures caused by other # tests modifying global state. # # We run a particular test menually after each test returns. sys.path.insert(0, os.path.dirname(__file__)) try: import test_tables finally: del sys.path[0] print(f'### Calling test_tables.test_md_styles().') try: test_tables.test_md_styles() except Exception as e: print(f'### test_tables.test_md_styles() failed: {e}') raise else: print(f'### test_tables.test_md_styles() passed.') ================================================ FILE: tests/gentle_compare.py ================================================ import math import pymupdf def gentle_compare(w0, w1): """Check lists of "words" extractions for approximate equality. * both lists must have same length * word items must contain same word strings * word rectangles must be approximately equal """ tolerance = 1e-3 # maximum (Euclidean) norm of difference rectangle word_count = len(w0) # number of words if word_count != len(w1): print(f"different number of words: {word_count}/{len(w1)}") return False for i in range(word_count): if w0[i][4] != w1[i][4]: # word strings must be the same print(f"word {i} mismatch") return False r0 = pymupdf.Rect(w0[i][:4]) # rect of first word r1 = pymupdf.Rect(w1[i][:4]) # rect of second word delta = (r1 - r0).norm() # norm of difference rectangle if delta > tolerance: print(f"word {i}: rectangle mismatch {delta}") return False return True def rms(a, b, verbose=None, out_prefix=''): ''' Returns RMS diff of raw bytes of two sequences. ''' assert len(a) == len(b) e = 0 for i, (aa, bb) in enumerate(zip(a, b)): if verbose and (i % verbose == 0): print(f'{out_prefix}rms(): {i=} {e=} {aa=} {aa=}.') e += (aa - bb) ** 2 rms = math.sqrt(e / len(a)) return rms def pixmaps_rms(a, b, out_prefix=''): ''' Returns RMS diff of raw bytes of two pixmaps. We assert that the pixmaps/sequences are the same size. and can each be a pymupdf.Pixmap or path of a bitmap file. ''' if isinstance(a, str): print(f'{out_prefix}pixmaps_rms(): reading pixmap from {a=}.') a = pymupdf.Pixmap(a) if isinstance(b, str): print(f'{out_prefix}pixmaps_rms(): reading pixmap from {b=}.') b = pymupdf.Pixmap(b) assert a.irect == b.irect, f'Differing rects: {a.irect=} {b.irect=}.' a_mv = a.samples_mv b_mv = b.samples_mv assert len(a_mv) == len(b_mv) ret = rms(a_mv, b_mv, out_prefix=out_prefix) print(f'{out_prefix}pixmaps_rms(): {ret=}.') return ret def pixmaps_diff(a, b, out_prefix=''): ''' Returns a pymupdf.Pixmap that represents the difference between pixmaps and . Each byte in the returned pixmap is `128 + (b_byte - a_byte) // 2`. ''' if isinstance(a, str): print(f'{out_prefix}pixmaps_rms(): reading pixmap from {a=}.') a = pymupdf.Pixmap(a) if isinstance(b, str): print(f'{out_prefix}pixmaps_rms(): reading pixmap from {b=}.') b = pymupdf.Pixmap(b) assert a.irect == b.irect, f'Differing rects: {a.irect=} {b.irect=}.' a_mv = a.samples_mv b_mv = b.samples_mv c = pymupdf.Pixmap(a.tobytes()) c_mv = c.samples_mv assert len(a_mv) == len(b_mv) == len(c_mv) if 1: print(f'{len(a_mv)=}') for i, (a_byte, b_byte, c_byte) in enumerate(zip(a_mv, b_mv, c_mv)): assert 0 <= a_byte < 256 assert 0 <= b_byte < 256 assert 0 <= c_byte < 256 # Set byte to 128 plus half the diff so we represent the full # -255..+255 range. c_mv[i] = 128 + (b_byte - a_byte) // 2 return c ================================================ FILE: tests/resources/full_toc.txt ================================================ [1, 'HAUPTÜBERSICHT', -1, {'kind': 5, 'xref': 2, 'file': '../SDW2006.PDF', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [1, 'Januar 01/2006', -1, {'kind': 5, 'xref': 3, 'file': '01004INH.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0, 'collapse': False}] [2, 'SPEKTROGRAMM', -1, {'kind': 0, 'xref': 4, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Urzeit-Godzilla', -1, {'kind': 5, 'xref': 87, 'file': '01008SP.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Frühchristliche Mosaike im Knast', -1, {'kind': 5, 'xref': 102, 'file': '01008SP.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Evolution auf Eis', -1, {'kind': 5, 'xref': 100, 'file': '01008SP.pdf', 'page': 1, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Entwarnung bei Kondensstreifen', -1, {'kind': 5, 'xref': 98, 'file': '01008SP.pdf', 'page': 1, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Spermatausch beim Schnecken-Sex', -1, {'kind': 5, 'xref': 96, 'file': '01008SP.pdf', 'page': 1, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Mehr Monde für Pluto', -1, {'kind': 5, 'xref': 94, 'file': '01008SP.pdf', 'page': 2, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Endlich ein Malaria-Impfstoff', -1, {'kind': 5, 'xref': 92, 'file': '01008SP.pdf', 'page': 2, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Spuren der ersten Sterne', -1, {'kind': 5, 'xref': 90, 'file': '01008SP.pdf', 'page': 2, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Bild des Monats', -1, {'kind': 5, 'xref': 88, 'file': '01008SP.pdf', 'page': 3, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'FORSCHUNG AKTUELL', -1, {'kind': 0, 'xref': 23, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Der Super-Teilchenfänger in der Pampa', -1, {'kind': 5, 'xref': 24, 'file': '01012FA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Auf der Fährte der Lepra', -1, {'kind': 5, 'xref': 29, 'file': '01012FA.pdf', 'page': 2, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Vampire gegen Schlaganfall', -1, {'kind': 5, 'xref': 27, 'file': '01012FA.pdf', 'page': 4, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Der Flug des Kolibris', -1, {'kind': 5, 'xref': 25, 'file': '01012FA.pdf', 'page': 7, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'THEMEN', -1, {'kind': 0, 'xref': 20, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Entwicklung von Spiralgalaxien', -1, {'kind': 5, 'xref': 21, 'file': '01022HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Geschichtsträchtige Genspuren', -1, {'kind': 5, 'xref': 46, 'file': '01030HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Was Sedimente verraten', -1, {'kind': 5, 'xref': 44, 'file': '01042HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Von Baumringen und Regenmengen', -1, {'kind': 5, 'xref': 42, 'file': '01050HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Software-Agenten in Not', -1, {'kind': 5, 'xref': 40, 'file': '01056HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Künstlicher kalter Antiwasserstoff', -1, {'kind': 5, 'xref': 38, 'file': '01062HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Rüsten gegen eine Pandemie', -1, {'kind': 5, 'xref': 36, 'file': '01072HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Satelliten zeigen Lawinengefahr', -1, {'kind': 5, 'xref': 34, 'file': '01084HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Provokante Verheißung: Update für den Menschen', -1, {'kind': 5, 'xref': 22, 'file': '01100HA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'KOMMENTAR', -1, {'kind': 0, 'xref': 18, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Springers Einwüfe: Holland, die Hydrometropole', -1, {'kind': 5, 'xref': 19, 'file': '01012FA.pdf', 'page': 8, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'WISSENSCHAFT IM ...', -1, {'kind': 0, 'xref': 15, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Alltag: Eine Decke für die Straße', -1, {'kind': 5, 'xref': 16, 'file': '01040WA.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Rückblick: Mozarts Ohr • Per Auto zum Südpol u.a.', -1, {'kind': 5, 'xref': 17, 'file': '01081IR.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'JUNGE WISSENSCHAFT', -1, {'kind': 0, 'xref': 13, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Ein Putzroboter für die Mama', -1, {'kind': 5, 'xref': 14, 'file': '01082JW.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'REZENSIONEN', -1, {'kind': 0, 'xref': 10, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Vulkanismus verstehen und erleben', -1, {'kind': 5, 'xref': 11, 'file': '01090RE.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Warum der Mensch glaubt', -1, {'kind': 5, 'xref': 72, 'file': '01090RE.pdf', 'page': 1, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Biomedizin und Ethik', -1, {'kind': 5, 'xref': 70, 'file': '01090RE.pdf', 'page': 2, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Mythos Meer', -1, {'kind': 5, 'xref': 68, 'file': '01090RE.pdf', 'page': 3, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Warum Frauen nicht schwach ... sind', -1, {'kind': 5, 'xref': 66, 'file': '01090RE.pdf', 'page': 4, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'PISA, Bach, Pythagoras', -1, {'kind': 5, 'xref': 12, 'file': '01090RE.pdf', 'page': 5, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'MATHEMATISCHE UNTERHALTUNGEN', -1, {'kind': 0, 'xref': 8, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Himmliches Ballett', -1, {'kind': 5, 'xref': 9, 'file': '01098MU.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [2, 'WEITERE RUBRIKEN', -1, {'kind': 0, 'xref': 5, 'page': -1, 'collapse': False, 'zoom': 0.0}] [3, 'Editorial', -1, {'kind': 5, 'xref': 6, 'file': '01003ED.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Leserbriefe/Impressum', -1, {'kind': 5, 'xref': 81, 'file': '01006LB.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Preisrätsel', -1, {'kind': 5, 'xref': 79, 'file': '01090RE.pdf', 'page': 6, 'to': Point(0.0, 0.0), 'zoom': 0.0}] [3, 'Vorschau', -1, {'kind': 5, 'xref': 7, 'file': '01106VO.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0}] ================================================ FILE: tests/resources/metadata.txt ================================================ {"format": "PDF 1.6", "title": "RUBRIK_Editorial_01-06.indd", "author": "Natalie Schaefer", "subject": "", "keywords": "", "creator": "", "producer": "Acrobat Distiller 7.0.5 (Windows)", "creationDate": "D:20070113191400+01'00'", "modDate": "D:20070120104154+01'00'", "trapped": "", "encryption": null} ================================================ FILE: tests/resources/simple_toc.txt ================================================ [1, 'HAUPTÜBERSICHT', -1][1, 'Januar 01/2006', -1][2, 'SPEKTROGRAMM', -1][3, 'Urzeit-Godzilla', -1][3, 'Frühchristliche Mosaike im Knast', -1][3, 'Evolution auf Eis', -1][3, 'Entwarnung bei Kondensstreifen', -1][3, 'Spermatausch beim Schnecken-Sex', -1][3, 'Mehr Monde für Pluto', -1][3, 'Endlich ein Malaria-Impfstoff', -1][3, 'Spuren der ersten Sterne', -1][3, 'Bild des Monats', -1][2, 'FORSCHUNG AKTUELL', -1][3, 'Der Super-Teilchenfänger in der Pampa', -1][3, 'Auf der Fährte der Lepra', -1][3, 'Vampire gegen Schlaganfall', -1][3, 'Der Flug des Kolibris', -1][2, 'THEMEN', -1][3, 'Entwicklung von Spiralgalaxien', -1][3, 'Geschichtsträchtige Genspuren', -1][3, 'Was Sedimente verraten', -1][3, 'Von Baumringen und Regenmengen', -1][3, 'Software-Agenten in Not', -1][3, 'Künstlicher kalter Antiwasserstoff', -1][3, 'Rüsten gegen eine Pandemie', -1][3, 'Satelliten zeigen Lawinengefahr', -1][3, 'Provokante Verheißung: Update für den Menschen', -1][2, 'KOMMENTAR', -1][3, 'Springers Einwüfe: Holland, die Hydrometropole', -1][2, 'WISSENSCHAFT IM ...', -1][3, 'Alltag: Eine Decke für die Straße', -1][3, 'Rückblick: Mozarts Ohr • Per Auto zum Südpol u.a.', -1][2, 'JUNGE WISSENSCHAFT', -1][3, 'Ein Putzroboter für die Mama', -1][2, 'REZENSIONEN', -1][3, 'Vulkanismus verstehen und erleben', -1][3, 'Warum der Mensch glaubt', -1][3, 'Biomedizin und Ethik', -1][3, 'Mythos Meer', -1][3, 'Warum Frauen nicht schwach ... sind', -1][3, 'PISA, Bach, Pythagoras', -1][2, 'MATHEMATISCHE UNTERHALTUNGEN', -1][3, 'Himmliches Ballett', -1][2, 'WEITERE RUBRIKEN', -1][3, 'Editorial', -1][3, 'Leserbriefe/Impressum', -1][3, 'Preisrätsel', -1][3, 'Vorschau', -1] ================================================ FILE: tests/resources/symbols.txt ================================================ [{'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('l', (50.0, 50.0), (50.0, 100.0)), ('l', (50.0, 100.0), (100.0, 75.0)), ('l', (100.0, 75.0), (50.0, 50.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 50.0, 100.0, 100.0), 'seqno': 0, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 1.0}, {'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (50.0, 135.0), (63.807098388671875, 135.0), (75.0, 123.8070068359375), (75.0, 110.0)), ('c', (75.0, 110.0), (75.0, 123.8070068359375), (86.19290161132812, 135.0), (100.0, 135.0)), ('c', (100.0, 135.0), (86.19290161132812, 135.0), (75.0, 146.1929931640625), (75.0, 160.0)), ('c', (75.0, 160.0), (75.0, 146.1929931640625), (63.807098388671875, 135.0), (50.0, 135.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 110.0, 100.0, 160.0), 'seqno': 2, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 1.0}, {'closePath': False, 'color': (0.0, 1.0, 0.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.0, 1.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (75.0, 195.0), (50.0, 170.0), (100.0, 170.0), (75.0, 195.0)), ('c', (75.0, 195.0), (100.0, 170.0), (100.0, 220.0), (75.0, 195.0)), ('c', (75.0, 195.0), (50.0, 220.0), (50.0, 170.0), (75.0, 195.0)), ('c', (75.0, 195.0), (100.0, 220.0), (50.0, 220.0), (75.0, 195.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 170.0, 100.0, 220.0), 'seqno': 4, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.30000001192092896}, {'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('l', (75.0, 230.0), (100.0, 255.0)), ('l', (100.0, 255.0), (75.0, 280.0)), ('l', (75.0, 280.0), (50.0, 255.0)), ('l', (50.0, 255.0), (75.0, 230.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 230.0, 100.0, 280.0), 'seqno': 6, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 1.0}, {'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.8039219975471497, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (50.0, 315.0), (50.0, 328.8070068359375), (61.192901611328125, 340.0), (75.0, 340.0)), ('c', (75.0, 340.0), (88.80709838867188, 340.0), (100.0, 328.8070068359375), (100.0, 315.0)), ('c', (100.0, 315.0), (100.0, 301.1929931640625), (88.80709838867188, 290.0), (75.0, 290.0)), ('c', (75.0, 290.0), (61.192901611328125, 290.0), (50.0, 301.1929931640625), (50.0, 315.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 290.0, 100.0, 340.0), 'seqno': 8, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 2.0}, {'closePath': False, 'color': (0.0, 0.0, 0.0), 'dashes': '[] 0', 'items': [('c', (50.0, 315.0), (50.0, 328.8070068359375), (61.192901611328125, 340.0), (75.0, 340.0)), ('c', (75.0, 340.0), (88.80709838867188, 340.0), (100.0, 328.8070068359375), (100.0, 315.0)), ('c', (100.0, 315.0), (100.0, 301.1929931640625), (88.80709838867188, 290.0), (75.0, 290.0)), ('c', (75.0, 290.0), (61.192901611328125, 290.0), (50.0, 301.1929931640625), (50.0, 315.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 290.0, 100.0, 340.0), 'seqno': 10, 'stroke_opacity': 1.0, 'type': 's', 'width': 1.0}, {'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 1.0, 1.0), 'fill_opacity': 1.0, 'items': [('re', (56.5, 312.5, 93.5, 317.5), 1)], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (56.5, 312.5, 93.5, 317.5), 'seqno': 11, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 3.0}, {'closePath': False, 'even_odd': False, 'fill': (1.0, 1.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (50.0, 375.0), (50.0, 388.8070068359375), (61.192901611328125, 400.0), (75.0, 400.0)), ('c', (75.0, 400.0), (88.80709838867188, 400.0), (100.0, 388.8070068359375), (100.0, 375.0)), ('c', (100.0, 375.0), (100.0, 361.1929931640625), (88.80709838867188, 350.0), (75.0, 350.0)), ('c', (75.0, 350.0), (61.192901611328125, 350.0), (50.0, 361.1929931640625), (50.0, 375.0))], 'layer': '', 'rect': (50.0, 350.0, 100.0, 400.0), 'seqno': 13, 'type': 'f'}, {'closePath': False, 'even_odd': False, 'fill': (0.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (60.0, 368.75), (60.0, 372.2019958496094), (62.23860168457031, 375.0), (65.0, 375.0)), ('c', (65.0, 375.0), (67.76139831542969, 375.0), (70.0, 372.2019958496094), (70.0, 368.75)), ('c', (70.0, 368.75), (70.0, 365.2980041503906), (67.76139831542969, 362.5), (65.0, 362.5)), ('c', (65.0, 362.5), (62.23860168457031, 362.5), (60.0, 365.2980041503906), (60.0, 368.75)), ('c', (80.0, 368.75), (80.0, 372.2019958496094), (82.23860168457031, 375.0), (85.0, 375.0)), ('c', (85.0, 375.0), (87.76139831542969, 375.0), (90.0, 372.2019958496094), (90.0, 368.75)), ('c', (90.0, 368.75), (90.0, 365.2980041503906), (87.76139831542969, 362.5), (85.0, 362.5)), ('c', (85.0, 362.5), (82.23860168457031, 362.5), (80.0, 365.2980041503906), (80.0, 368.75))], 'layer': '', 'rect': (60.0, 362.5, 90.0, 375.0), 'seqno': 14, 'type': 'f'}, {'closePath': False, 'color': (0.0, 0.0, 0.0), 'dashes': '[] 0', 'items': [('c', (60.0, 387.5), (68.2843017578125, 380.59600830078125), (81.7156982421875, 380.59600830078125), (90.0, 387.5))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (60.0, 380.59600830078125, 90.0, 387.5), 'seqno': 15, 'stroke_opacity': 1.0, 'type': 's', 'width': 1.0}, {'closePath': False, 'color': (1.0, 0.6470590233802795, 0.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 0.8274509906768799, 0.6078429818153381), 'fill_opacity': 1.0, 'items': [('c', (50.0, 433.6669921875), (60.30929946899414, 433.6669921875), (68.66670227050781, 426.50299072265625), (68.66670227050781, 417.6669921875)), ('c', (68.66670227050781, 417.6669921875), (74.55770111083984, 416.1940002441406), (74.55770111083984, 423.35699462890625), (68.66670227050781, 433.6669921875)), ('l', (68.66670227050781, 433.6669921875), (95.33329772949219, 433.6669921875)), ('c', (95.33329772949219, 433.6669921875), (100.66699981689453, 433.6669921875), (100.66699981689453, 439.0), (95.33329772949219, 439.0)), ('l', (95.33329772949219, 439.0), (79.33329772949219, 439.0)), ('l', (79.33329772949219, 439.0), (87.33329772949219, 439.0)), ('c', (87.33329772949219, 439.0), (92.66670227050781, 439.0), (92.66670227050781, 444.3330078125), (87.33329772949219, 444.3330078125)), ('l', (87.33329772949219, 444.3330078125), (79.33329772949219, 444.3330078125)), ('l', (79.33329772949219, 444.3330078125), (84.66670227050781, 444.3330078125)), ('c', (84.66670227050781, 444.3330078125), (90.0, 444.3330078125), (90.0, 449.6669921875), (84.66670227050781, 449.6669921875)), ('l', (84.66670227050781, 449.6669921875), (79.33329772949219, 449.6669921875)), ('l', (79.33329772949219, 449.6669921875), (83.33329772949219, 449.6669921875)), ('c', (83.33329772949219, 449.6669921875), (88.66670227050781, 449.6669921875), (88.66670227050781, 455.0), (83.33329772949219, 455.0)), ('l', (83.33329772949219, 455.0), (50.0, 455.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 416.1940002441406, 100.66699981689453, 455.0), 'seqno': 16, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 1.0}, {'closePath': False, 'color': (1.0, 0.0, 0.0), 'dashes': '[] 0', 'even_odd': False, 'fill': (1.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (75.0, 485.0), (62.5, 470.0), (50.0, 490.0), (75.0, 510.0)), ('c', (75.0, 485.0), (87.5, 470.0), (100.0, 490.0), (75.0, 510.0)), ('l', (75.0, 510.0), (75.0, 485.0))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (50.0, 470.0, 100.0, 510.0), 'seqno': 18, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 1.0}, {'closePath': False, 'color': (0.9333329796791077, 0.8470590114593506, 0.6823530197143555), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'fill_opacity': 1.0, 'items': [('re', (56.52170181274414, 547.753173828125, 85.5072021484375, 562.2459716796875), 1)], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (56.52170181274414, 547.753173828125, 85.5072021484375, 562.2459716796875), 'seqno': 20, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.07246380299329758}, {'closePath': False, 'color': (0.9333329796791077, 0.8470590114593506, 0.6823530197143555), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.9333329796791077, 0.8470590114593506, 0.6823530197143555), 'fill_opacity': 1.0, 'items': [('l', (56.52170181274414, 547.7540283203125), (59.4202995300293, 550.6519775390625)), ('l', (59.4202995300293, 550.6519775390625), (59.4202995300293, 559.3480224609375)), ('l', (59.4202995300293, 559.3480224609375), (56.52170181274414, 562.2459716796875)), ('l', (85.5072021484375, 547.7540283203125), (82.60870361328125, 550.6519775390625)), ('l', (82.60870361328125, 550.6519775390625), (82.60870361328125, 559.3480224609375)), ('l', (82.60870361328125, 559.3480224609375), (85.5072021484375, 562.2459716796875))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (56.52170181274414, 547.7540283203125, 85.5072021484375, 562.2459716796875), 'seqno': 22, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.07246380299329758}, {'closePath': False, 'color': (0.8039219975471497, 0.7294120192527771, 0.5882350206375122), 'dashes': '[] 0', 'items': [('l', (59.4202995300293, 550.6519775390625), (82.60870361328125, 550.6519775390625)), ('l', (59.4202995300293, 559.3480224609375), (82.60870361328125, 559.3480224609375))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (59.4202995300293, 550.6519775390625, 82.60870361328125, 559.3480224609375), 'seqno': 24, 'stroke_opacity': 1.0, 'type': 's', 'width': 0.07246380299329758}, {'even_odd': False, 'fill': (0.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('re', (56.52170181274414, 547.753173828125, 63.76808166503906, 562.2459716796875), 1)], 'layer': '', 'rect': (56.52170181274414, 547.753173828125, 63.76808166503906, 562.2459716796875), 'seqno': 25, 'type': 'f'}, {'even_odd': False, 'fill': (1.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (56.52170181274414, 547.7540283203125), (47.82609939575195, 547.7540283203125), (47.82609939575195, 562.2459716796875), (56.52170181274414, 562.2459716796875))], 'layer': '', 'rect': (47.82609939575195, 547.7540283203125, 56.52170181274414, 562.2459716796875), 'seqno': 26, 'type': 'f'}, {'even_odd': False, 'fill': (0.9333329796791077, 0.8470590114593506, 0.6823530197143555), 'fill_opacity': 1.0, 'items': [('l', (85.5072021484375, 547.7540283203125), (100.0, 555.0)), ('l', (100.0, 555.0), (85.5072021484375, 562.2459716796875))], 'layer': '', 'rect': (85.5072021484375, 547.7540283203125, 100.0, 562.2459716796875), 'seqno': 27, 'type': 'f'}, {'closePath': False, 'color': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'fill_opacity': 1.0, 'items': [('c', (85.5072021484375, 547.7540283203125), (86.30770111083984, 548.553955078125), (85.00990295410156, 549.8519897460938), (82.60870361328125, 550.6519775390625)), ('l', (82.60870361328125, 550.6519775390625), (85.5072021484375, 547.7540283203125))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (82.60870361328125, 547.7540283203125, 86.30770111083984, 550.6519775390625), 'seqno': 28, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.07246380299329758}, {'closePath': False, 'color': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'fill_opacity': 1.0, 'items': [('c', (82.60870361328125, 550.6519775390625), (87.2510986328125, 553.052978515625), (87.2510986328125, 556.947021484375), (82.60870361328125, 559.3480224609375)), ('l', (82.60870361328125, 559.3480224609375), (82.60870361328125, 550.6519775390625))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (82.60870361328125, 550.6519775390625, 87.2510986328125, 559.3480224609375), 'seqno': 30, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.07246380299329758}, {'closePath': False, 'color': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'dashes': '[] 0', 'even_odd': False, 'fill': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'fill_opacity': 1.0, 'items': [('c', (82.60870361328125, 559.3480224609375), (85.00990295410156, 560.1480102539062), (86.30770111083984, 561.446044921875), (85.5072021484375, 562.2459716796875)), ('l', (85.5072021484375, 562.2459716796875), (82.60870361328125, 559.3480224609375))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (82.60870361328125, 559.3480224609375, 86.30770111083984, 562.2459716796875), 'seqno': 32, 'stroke_opacity': 1.0, 'type': 'fs', 'width': 0.07246380299329758}, {'even_odd': False, 'fill': (0.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('l', (94.2029037475586, 552.1010131835938), (100.0, 555.0)), ('l', (100.0, 555.0), (94.2029037475586, 557.8989868164062)), ('c', (94.2029037475586, 552.1010131835938), (92.60209655761719, 553.7020263671875), (92.60209655761719, 556.2979736328125), (94.2029037475586, 557.8989868164062))], 'layer': '', 'rect': (92.60209655761719, 552.1010131835938, 100.0, 557.8989868164062), 'seqno': 34, 'type': 'f'}, {'closePath': False, 'color': (0.7215690016746521, 0.5254899859428406, 0.04313730075955391), 'dashes': '[] 0', 'items': [('l', (85.5072021484375, 547.7540283203125), (82.60870361328125, 550.6519775390625)), ('l', (82.60870361328125, 550.6519775390625), (82.60870361328125, 559.3480224609375)), ('l', (82.60870361328125, 559.3480224609375), (85.5072021484375, 562.2459716796875))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (82.60870361328125, 547.7540283203125, 85.5072021484375, 562.2459716796875), 'seqno': 35, 'stroke_opacity': 1.0, 'type': 's', 'width': 0.07246380299329758}, {'closePath': False, 'color': (0.0, 0.0, 0.0), 'dashes': '[] 0', 'items': [('l', (63.76810073852539, 547.7540283203125), (85.5072021484375, 547.7540283203125)), ('l', (85.5072021484375, 547.7540283203125), (100.0, 555.0)), ('l', (100.0, 555.0), (85.5072021484375, 562.2459716796875)), ('l', (85.5072021484375, 562.2459716796875), (63.76810073852539, 562.2459716796875))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (63.76810073852539, 547.7540283203125, 100.0, 562.2459716796875), 'seqno': 36, 'stroke_opacity': 1.0, 'type': 's', 'width': 1.0}, {'even_odd': False, 'fill': (0.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('re', (65.94200134277344, 552.826171875, 73.18838500976562, 557.1740112304688), 1), ('c', (73.18840026855469, 552.8259887695312), (75.18939971923828, 554.0269775390625), (75.18939971923828, 555.9730224609375), (73.18840026855469, 557.1740112304688)), ('c', (65.94200134277344, 552.8259887695312), (63.941001892089844, 554.0269775390625), (63.941001892089844, 555.9730224609375), (65.94200134277344, 557.1740112304688))], 'layer': '', 'rect': (63.941001892089844, 552.826171875, 75.18939971923828, 557.1740112304688), 'seqno': 37, 'type': 'f'}, {'closePath': False, 'color': (1.0, 1.0, 1.0), 'dashes': '[] 0', 'items': [('l', (58.937198638916016, 548.47802734375), (58.937198638916016, 561.52197265625)), ('l', (61.352699279785156, 548.47802734375), (61.352699279785156, 561.52197265625)), ('l', (61.352699279785156, 561.52197265625), (61.352699279785156, 548.47802734375))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (58.937198638916016, 548.47802734375, 61.352699279785156, 561.52197265625), 'seqno': 38, 'stroke_opacity': 1.0, 'type': 's', 'width': 1.1594200134277344}, {'closePath': False, 'even_odd': False, 'fill': (1.0, 1.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (50.0, 615.0), (50.0, 628.8070068359375), (61.192901611328125, 640.0), (75.0, 640.0)), ('c', (75.0, 640.0), (88.80709838867188, 640.0), (100.0, 628.8070068359375), (100.0, 615.0)), ('c', (100.0, 615.0), (100.0, 601.1929931640625), (88.80709838867188, 590.0), (75.0, 590.0)), ('c', (75.0, 590.0), (61.192901611328125, 590.0), (50.0, 601.1929931640625), (50.0, 615.0))], 'layer': '', 'rect': (50.0, 590.0, 100.0, 640.0), 'seqno': 39, 'type': 'f'}, {'closePath': False, 'even_odd': False, 'fill': (0.0, 0.0, 0.0), 'fill_opacity': 1.0, 'items': [('c', (60.0, 608.75), (60.0, 612.2020263671875), (62.23860168457031, 615.0), (65.0, 615.0)), ('c', (65.0, 615.0), (67.76139831542969, 615.0), (70.0, 612.2020263671875), (70.0, 608.75)), ('c', (70.0, 608.75), (70.0, 605.2979736328125), (67.76139831542969, 602.5), (65.0, 602.5)), ('c', (65.0, 602.5), (62.23860168457031, 602.5), (60.0, 605.2979736328125), (60.0, 608.75)), ('c', (80.0, 608.75), (80.0, 612.2020263671875), (82.23860168457031, 615.0), (85.0, 615.0)), ('c', (85.0, 615.0), (87.76139831542969, 615.0), (90.0, 612.2020263671875), (90.0, 608.75)), ('c', (90.0, 608.75), (90.0, 605.2979736328125), (87.76139831542969, 602.5), (85.0, 602.5)), ('c', (85.0, 602.5), (82.23860168457031, 602.5), (80.0, 605.2979736328125), (80.0, 608.75))], 'layer': '', 'rect': (60.0, 602.5, 90.0, 615.0), 'seqno': 40, 'type': 'f'}, {'closePath': False, 'color': (0.0, 0.0, 0.0), 'dashes': '[] 0', 'items': [('c', (60.0, 624.375), (68.2843017578125, 633.0040283203125), (81.7156982421875, 633.0040283203125), (90.0, 624.375))], 'layer': '', 'lineCap': (0, 0, 0), 'lineJoin': 0.0, 'rect': (60.0, 624.375, 90.0, 633.0040283203125), 'seqno': 41, 'stroke_opacity': 1.0, 'type': 's', 'width': 1.0}] ================================================ FILE: tests/resources/test_2608_expected ================================================ No significant gamma-ray excess above the expected background is detected from the direction of FRB 20171019A, with 52 gamma candidate events from the source region and 524 background event. A second analysis using an independent event calibration and recon- struction (Parsons & Hinton 2014) confirms this result. A search for variable emission on timescales ranging from milliseconds to sev- eral minutes with tools provided in (Brun et al. 2020) does not reveal any variability above 2.2 𝜎. For the total data set of 1.8 h, 95% confi- dence level (C. L.) upper limits on the photon flux are derived using the method described by Rolke et al. (2005). The energy threshold of the data is highly dependent on the zenith angle of the observa- tions. For these observations, the zenith angles range from 15 to 25 deg, which leads to an energy threshold for the stacked data set of 𝐸th = 120 GeV. The upper limit on the Very High Energy (VHE) ================================================ FILE: tests/resources/test_2608_expected_1.26 ================================================ No significant gamma-ray excess above the expected background is detected from the direction of FRB 20171019A, with 52 gamma candidate events from the source region and 524 background event. A second analysis using an independent event calibration and reconstruction (Parsons & Hinton 2014) confirms this result. A search for variable emission on timescales ranging from milliseconds to several minutes with tools provided in (Brun et al. 2020) does not reveal any variability above 2.2 𝜎. For the total data set of 1.8 h, 95% confidence level (C. L.) upper limits on the photon flux are derived using the method described by Rolke et al. (2005). The energy threshold of the data is highly dependent on the zenith angle of the observations. For these observations, the zenith angles range from 15 to 25 deg, which leads to an energy threshold for the stacked data set of 𝐸th = 120 GeV. The upper limit on the Very High Energy (VHE) ================================================ FILE: tests/resources/test_2608_expected_1.28 ================================================ The XRT summed image is shown in Figure 5. At the edge of the field-of-view, we detect a source spatially coincident with the Wolf 1561 star. As we consider this source unrelated to the FRB, we use the online Swift-XRT data products generator (Evans et al. 2007) (Evans et al. 2009) to derive upper limits in the 0.3- 10 keV range on the count rate of 0.001885 counts.s−1. Using WebPIMMS9 (v4.11a) and assuming a weighted average 𝑁H = 5.12× 1020 cm−2 from the direction of the source estimated from the NASA’s HEASARC 10 online tools (HI4PI Collaboration et al. 2016) and a power law model with a photon index = 2, this upper limit translates to an energy flux of 6.6 × 10−14 erg cm−2 s−1 (8.3 × 10−14 erg cm−2 s−1 unabsorbed). ================================================ FILE: tests/resources/test_3842_expected_1.28.txt ================================================ NIST SP 800-223 High-Performance Computing Security February 2024 iii Table of Contents 1. Introduction ...................................................................................................................................1 2. HPC System Reference Architecture and Main Components ............................................................2 2.1.1. Components of the High-Performance Computing Zone ............................................................. 3 2.1.2. Components of the Data Storage Zone ........................................................................................ 4 2.1.3. Parallel File System ....................................................................................................................... 4 2.1.4. Archival and Campaign Storage .................................................................................................... 5 2.1.5. Burst Buffer .................................................................................................................................. 5 2.1.6. Components of the Access Zone .................................................................................................. 6 2.1.7. Components of the Management Zone ....................................................................................... 6 2.1.8. General Architecture and Characteristics .................................................................................... 6 2.1.9. Basic Services ................................................................................................................................ 7 2.1.10. Configuration Management ....................................................................................................... 7 2.1.11. HPC Scheduler and Workflow Management .............................................................................. 7 2.1.12. HPC Software .............................................................................................................................. 8 2.1.13. User Software ............................................................................................................................. 8 2.1.14. Site-Provided Software and Vendor Software ........................................................................... 8 2.1.15. Containerized Software in HPC .................................................................................................. 9 3. HPC Threat Analysis...................................................................................................................... 10 3.2.1. Access Zone Threats ................................................................................................................... 11 3.2.2. Management Zone Threats ........................................................................................................ 11 3.2.3. High-Performance Computing Zone Threats .............................................................................. 12 3.2.4. Data Storage Zone Threats ......................................................................................................... 12 4. HPC Security Posture, Challenges, and Recommendations ............................................................. 14 5. Conclusions .................................................................................................................................. 19 2.1. Main COMPONENNS..........cccccssccccssssccccssssecccssssecccsessseccessseeecsesseeceesseecsesseeesesseeecesaseecsesseeesessaeeesessaeeesD 3.1. Key HPC Security Characteristics and Use REquireMent............cccsscccessccessecesssecesseecsssecesseeestessstree LO 3.2. Threats to HPC FUNCTION ZONES.........cesccesscesscesscssscesecessssssssssscesscesscessssseeseesseascessssssessesssesssssessssees LO 3.3. Other Threats ........cccccsccssccsscssccssecssscssscssscsseesssesssssesscesscseesesseeecessccssssssssessssssssssesessssssssssssssssesesLO 4.1. HPC Access Control via Network S@gMeNtatiOn ...........ccccscccsssccessecessseceseccsssecessecessecesstecsssecesseessses LA 4.2. Compute Node Sanitization ............cccccssecsssecsessccsseccsseecsseecceseecssseesseecssssesssesessssessseesssssesssessssessses LD 4.3. Data Integrity Protection ............cccccccccccccessssssssccecccessessssssseecccesssesssssseescesssesssssseeesessssssstsssesesssssssesLO 4.4. SECUFING CONTAINELSS ........eccesscccesssccccessseccceesscccessssecccesseeccesseeccessseeccessseccessssescessssesesssssescsssseseessLO 4.5. Achieving Security While Maintaining HPC Performance. ..........cc:cccsscccessscesssecessecesssecesstcessseeesreesss LZ 4.6. Challenges to HPC Security TOols..........c:ccccssccsssecceseecssseccssecessseccsseecssseecsseecssseecsssesssscssssessssssssssessse LD ================================================ FILE: tests/resources/test_3842_partial.txt ================================================ NIST SP 800-223 High-Performance Computing Security February 2024 iii Table of Contents 1. Introduction ...................................................................................................................................1 2. HPC System Reference Architecture and Main Components ............................................................2 2.1.1. Components of the High-Performance Computing Zone ............................................................. 3 2.1.2. Components of the Data Storage Zone ........................................................................................ 4 2.1.3. Parallel File System ....................................................................................................................... 4 2.1.4. Archival and Campaign Storage .................................................................................................... 5 2.1.5. Burst Buffer .................................................................................................................................. 5 2.1.6. Components of the Access Zone .................................................................................................. 6 2.1.7. Components of the Management Zone ....................................................................................... 6 2.1.8. General Architecture and Characteristics .................................................................................... 6 2.1.9. Basic Services ................................................................................................................................ 7 2.1.10. Configuration Management ....................................................................................................... 7 2.1.11. HPC Scheduler and Workflow Management .............................................................................. 7 2.1.12. HPC Software .............................................................................................................................. 8 2.1.13. User Software ............................................................................................................................. 8 2.1.14. Site-Provided Software and Vendor Software ........................................................................... 8 2.1.15. Containerized Software in HPC .................................................................................................. 9 3. HPC Threat Analysis...................................................................................................................... 10 3.2.1. Access Zone Threats ................................................................................................................... 11 3.2.2. Management Zone Threats ........................................................................................................ 11 3.2.3. High-Performance Computing Zone Threats .............................................................................. 12 3.2.4. Data Storage Zone Threats ......................................................................................................... 12 4. HPC Security Posture, Challenges, and Recommendations ............................................................. 14 5. Conclusions .................................................................................................................................. 19 2.1. Main COMPONENNS..........cccccssccccssssccccssssccccssnsecccsssseeccessseeecsessseecssaseecsessseeceessseecseeaseecsessseeesessseeessstseeesD 3.1. Key HPC Security Characteristics and Use REquireMent............cccsscccessscesseceessecesseeesssecesseeestteessteee LO 3.2. Threats to HPC FUNCTION ZONES..........cesccesscesscesscesscesecsssesssecssscesscesscsseessessescesssesscessessssssssssssssssssees LO 3.3. Other Threats ........cccccsccsscssscsssccssscssscssscssscsssesssesssscssscssessseesseeseessesscsssssssessessesssessssssssssssssssssssseesesLO 4.1. HPC Access Control via Network SEgMeNtatiOn ..........:ccccscccsssccessecesssecesecesssecessecessecessteessecessteessee LO 4.2. Compute Node Sanitization ...........cccccessccssssccessecessecesseecssseccseecsseecsseecesseesessscssssesssescssssessssesssessses LD 4.3. Data Integrity Protection ............cccccccccccccsssssssscececccesssssssseceeccessscssssseeeccesesssssssseeesessssssstsssesesssssssesLOD 4.4. SECUFING CONTAINELSS ........ccccssccccssssccccessseeccesseeccsssssecceesssecceessseccesssseecsessseeccsssssescsssssescssssssscssssesesesLO 4.5. Achieving Security While Maintaining HPC Performance. ..........cc:cccssccsssseesssecessecesssecessecessseesseeesee LZ 4.6. Challenges to HPC Security TOols...........c:ccccssccssseccsssecesseecesecessseccsseecssseecsseecseseecssesesstscssssesssessssessse LZ ================================================ FILE: tests/resources/test_open2.fb2 ================================================ computers Chris Clark Sample FB2 book

Short sample of a FictionBook2 book with simple metadata. Based on test_book.md from https://github.com/clach04/sample_reading_media

 ebook,sample,markdown,fb2,FictionBook2 clach04 https://github.com/clach04/sample_reading_media vim and scite https://github.com/clach04/sample_reading_media 1.0

Initial version, written by hand.

 <p>This is a title</p>
<p>Test Header h1</p>

A test paragraph.

Another test paragraph.

<p>Another Test Header h1</p>
<p>A Test Header h2</p>
<p>A Test Header h3</p>

Yet more copy

 ================================================ FILE: tests/resources/test_open2.xhtml ================================================

Some text

================================================ FILE: tests/resources/test_open2.xml ================================================ ================================================ FILE: tests/resources/test_open2_expected.json ================================================ { "tests/resources/test_open2.cbz": { "": { "file": "zip", "stream": "zip" }, ".cbz": { "file": "zip", "stream": "zip" }, ".doc": { "file": "zip", "stream": "zip" }, ".docx": { "file": "zip", "stream": "zip" }, ".epub": { "file": "zip", "stream": "zip" }, ".fb2": { "file": "zip", "stream": "zip" }, ".html": { "file": "zip", "stream": "zip" }, ".jpg": { "file": "zip", "stream": "zip" }, ".mobi": { "file": "zip", "stream": "zip" }, ".pdf": { "file": "zip", "stream": "zip" }, ".svg": { "file": "zip", "stream": "zip" }, ".txt": { "file": "zip", "stream": "zip" }, ".xhtml": { "file": "zip", "stream": "zip" }, ".xml": { "file": "zip", "stream": "zip" }, ".xps": { "file": "zip", "stream": "zip" } }, "tests/resources/test_open2.doc": { "": { "file": "[error]", "stream": "[error]" }, ".cbz": { "file": "cfb", "stream": "cfb" }, ".doc": { "file": "[error]", "stream": "[error]" }, ".docx": { "file": "[error]", "stream": "[error]" }, ".epub": { "file": "[error]", "stream": "[error]" }, ".fb2": { "file": "FictionBook2", "stream": "FictionBook2" }, ".html": { "file": "HTML5", "stream": "HTML5" }, ".jpg": { "file": "Image", "stream": "Image" }, ".mobi": { "file": "[error]", "stream": "[error]" }, ".pdf": { "file": "[error]", "stream": "[error]" }, ".svg": { "file": "SVG", "stream": "SVG" }, ".txt": { "file": "Text", "stream": "Text" }, ".xhtml": { "file": "XHTML", "stream": "XHTML" }, ".xml": { "file": "FictionBook2", "stream": "FictionBook2" }, ".xps": { "file": "[error]", "stream": "[error]" } }, "tests/resources/test_open2.docx": { "": { "file": "Office document", "stream": "Office document" }, ".cbz": { "file": "Office document", "stream": "Office document" }, ".doc": { "file": "Office document", "stream": "Office document" }, ".docx": { "file": "Office document", "stream": "Office document" }, ".epub": { "file": "Office document", "stream": "Office document" }, ".fb2": { "file": "Office document", "stream": "Office document" }, ".html": { "file": "Office document", "stream": "Office document" }, ".jpg": { "file": "Office document", "stream": "Office document" }, ".mobi": { "file": "Office document", "stream": "Office document" }, ".pdf": { "file": "Office document", "stream": "Office document" }, ".svg": { "file": "Office document", "stream": "Office document" }, ".txt": { "file": "Office document", "stream": "Office document" }, ".xhtml": { "file": "Office document", "stream": "Office document" }, ".xml": { "file": "Office document", "stream": "Office document" }, ".xps": { "file": "Office document", "stream": "Office document" } }, "tests/resources/test_open2.epub": { "": { "file": "EPUB", "stream": "EPUB" }, ".cbz": { "file": "zip", "stream": "zip" }, ".doc": { "file": "EPUB", "stream": "EPUB" }, ".docx": { "file": "EPUB", "stream": "EPUB" }, ".epub": { "file": "EPUB", "stream": "EPUB" }, ".fb2": { "file": "EPUB", "stream": "EPUB" }, ".html": { "file": "EPUB", "stream": "EPUB" }, ".jpg": { "file": "EPUB", "stream": "EPUB" }, ".mobi": { "file": "EPUB", "stream": "EPUB" }, ".pdf": { "file": "EPUB", "stream": "EPUB" }, ".svg": { "file": "EPUB", "stream": "EPUB" }, ".txt": { "file": "EPUB", "stream": "EPUB" }, ".xhtml": { "file": "EPUB", "stream": "EPUB" }, ".xml": { "file": "EPUB", "stream": "EPUB" }, ".xps": { "file": "EPUB", "stream": "EPUB" } }, "tests/resources/test_open2.fb2": { "": { "file": "FictionBook2", "stream": "FictionBook2" }, ".cbz": { "file": "FictionBook2", "stream": "FictionBook2" }, ".doc": { "file": "FictionBook2", "stream": "FictionBook2" }, ".docx": { "file": "FictionBook2", "stream": "FictionBook2" }, ".epub": { "file": "FictionBook2", "stream": "FictionBook2" }, ".fb2": { "file": "FictionBook2", "stream": "FictionBook2" }, ".html": { "file": "FictionBook2", "stream": "FictionBook2" }, ".jpg": { "file": "FictionBook2", "stream": "FictionBook2" }, ".mobi": { "file": "FictionBook2", "stream": "FictionBook2" }, ".pdf": { "file": "FictionBook2", "stream": "FictionBook2" }, ".svg": { "file": "FictionBook2", "stream": "FictionBook2" }, ".txt": { "file": "FictionBook2", "stream": "FictionBook2" }, ".xhtml": { "file": "FictionBook2", "stream": "FictionBook2" }, ".xml": { "file": "FictionBook2", "stream": "FictionBook2" }, ".xps": { "file": "FictionBook2", "stream": "FictionBook2" } }, "tests/resources/test_open2.html": { "": { "file": "HTML5", "stream": "HTML5" }, ".cbz": { "file": "HTML5", "stream": "HTML5" }, ".doc": { "file": "HTML5", "stream": "HTML5" }, ".docx": { "file": "HTML5", "stream": "HTML5" }, ".epub": { "file": "HTML5", "stream": "HTML5" }, ".fb2": { "file": "HTML5", "stream": "HTML5" }, ".html": { "file": "HTML5", "stream": "HTML5" }, ".jpg": { "file": "HTML5", "stream": "HTML5" }, ".mobi": { "file": "HTML5", "stream": "HTML5" }, ".pdf": { "file": "HTML5", "stream": "HTML5" }, ".svg": { "file": "HTML5", "stream": "HTML5" }, ".txt": { "file": "HTML5", "stream": "HTML5" }, ".xhtml": { "file": "XHTML", "stream": "XHTML" }, ".xml": { "file": "HTML5", "stream": "HTML5" }, ".xps": { "file": "HTML5", "stream": "HTML5" } }, "tests/resources/test_open2.jpg": { "": { "file": "Image", "stream": "Image" }, ".cbz": { "file": "Image", "stream": "Image" }, ".doc": { "file": "Image", "stream": "Image" }, ".docx": { "file": "Image", "stream": "Image" }, ".epub": { "file": "Image", "stream": "Image" }, ".fb2": { "file": "Image", "stream": "Image" }, ".html": { "file": "Image", "stream": "Image" }, ".jpg": { "file": "Image", "stream": "Image" }, ".mobi": { "file": "Image", "stream": "Image" }, ".pdf": { "file": "Image", "stream": "Image" }, ".svg": { "file": "Image", "stream": "Image" }, ".txt": { "file": "Image", "stream": "Image" }, ".xhtml": { "file": "Image", "stream": "Image" }, ".xml": { "file": "Image", "stream": "Image" }, ".xps": { "file": "Image", "stream": "Image" } }, "tests/resources/test_open2.mobi": { "": { "file": "MOBI", "stream": "MOBI" }, ".cbz": { "file": "MOBI", "stream": "MOBI" }, ".doc": { "file": "MOBI", "stream": "MOBI" }, ".docx": { "file": "MOBI", "stream": "MOBI" }, ".epub": { "file": "MOBI", "stream": "MOBI" }, ".fb2": { "file": "MOBI", "stream": "MOBI" }, ".html": { "file": "MOBI", "stream": "MOBI" }, ".jpg": { "file": "MOBI", "stream": "MOBI" }, ".mobi": { "file": "MOBI", "stream": "MOBI" }, ".pdf": { "file": "MOBI", "stream": "MOBI" }, ".svg": { "file": "MOBI", "stream": "MOBI" }, ".txt": { "file": "MOBI", "stream": "MOBI" }, ".xhtml": { "file": "MOBI", "stream": "MOBI" }, ".xml": { "file": "MOBI", "stream": "MOBI" }, ".xps": { "file": "MOBI", "stream": "MOBI" } }, "tests/resources/test_open2.pdf": { "": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".cbz": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".doc": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".docx": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".epub": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".fb2": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".html": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".jpg": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".mobi": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".pdf": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".svg": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".txt": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".xhtml": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".xml": { "file": "PDF 1.5", "stream": "PDF 1.5" }, ".xps": { "file": "PDF 1.5", "stream": "PDF 1.5" } }, "tests/resources/test_open2.svg": { "": { "file": "SVG", "stream": "SVG" }, ".cbz": { "file": "SVG", "stream": "SVG" }, ".doc": { "file": "SVG", "stream": "SVG" }, ".docx": { "file": "SVG", "stream": "SVG" }, ".epub": { "file": "SVG", "stream": "SVG" }, ".fb2": { "file": "SVG", "stream": "SVG" }, ".html": { "file": "SVG", "stream": "SVG" }, ".jpg": { "file": "SVG", "stream": "SVG" }, ".mobi": { "file": "SVG", "stream": "SVG" }, ".pdf": { "file": "SVG", "stream": "SVG" }, ".svg": { "file": "SVG", "stream": "SVG" }, ".txt": { "file": "SVG", "stream": "SVG" }, ".xhtml": { "file": "SVG", "stream": "SVG" }, ".xml": { "file": "SVG", "stream": "SVG" }, ".xps": { "file": "SVG", "stream": "SVG" } }, "tests/resources/test_open2.xhtml": { "": { "file": "XHTML", "stream": "XHTML" }, ".cbz": { "file": "XHTML", "stream": "XHTML" }, ".doc": { "file": "XHTML", "stream": "XHTML" }, ".docx": { "file": "XHTML", "stream": "XHTML" }, ".epub": { "file": "XHTML", "stream": "XHTML" }, ".fb2": { "file": "XHTML", "stream": "XHTML" }, ".html": { "file": "HTML5", "stream": "HTML5" }, ".jpg": { "file": "XHTML", "stream": "XHTML" }, ".mobi": { "file": "XHTML", "stream": "XHTML" }, ".pdf": { "file": "XHTML", "stream": "XHTML" }, ".svg": { "file": "XHTML", "stream": "XHTML" }, ".txt": { "file": "XHTML", "stream": "XHTML" }, ".xhtml": { "file": "XHTML", "stream": "XHTML" }, ".xml": { "file": "XHTML", "stream": "XHTML" }, ".xps": { "file": "XHTML", "stream": "XHTML" } }, "tests/resources/test_open2.xml": { "": { "file": "[error]", "stream": "[error]" }, ".cbz": { "file": "[error]", "stream": "[error]" }, ".doc": { "file": "[error]", "stream": "[error]" }, ".docx": { "file": "[error]", "stream": "[error]" }, ".epub": { "file": "[error]", "stream": "[error]" }, ".fb2": { "file": "FictionBook2", "stream": "FictionBook2" }, ".html": { "file": "HTML5", "stream": "HTML5" }, ".jpg": { "file": "Image", "stream": "Image" }, ".mobi": { "file": "[error]", "stream": "[error]" }, ".pdf": { "file": "[error]", "stream": "[error]" }, ".svg": { "file": "SVG", "stream": "SVG" }, ".txt": { "file": "Text", "stream": "Text" }, ".xhtml": { "file": "XHTML", "stream": "XHTML" }, ".xml": { "file": "FictionBook2", "stream": "FictionBook2" }, ".xps": { "file": "[error]", "stream": "[error]" } }, "tests/resources/test_open2.xps": { "": { "file": "XPS", "stream": "XPS" }, ".cbz": { "file": "zip", "stream": "zip" }, ".doc": { "file": "XPS", "stream": "XPS" }, ".docx": { "file": "XPS", "stream": "XPS" }, ".epub": { "file": "XPS", "stream": "XPS" }, ".fb2": { "file": "XPS", "stream": "XPS" }, ".html": { "file": "XPS", "stream": "XPS" }, ".jpg": { "file": "XPS", "stream": "XPS" }, ".mobi": { "file": "XPS", "stream": "XPS" }, ".pdf": { "file": "XPS", "stream": "XPS" }, ".svg": { "file": "XPS", "stream": "XPS" }, ".txt": { "file": "XPS", "stream": "XPS" }, ".xhtml": { "file": "XPS", "stream": "XPS" }, ".xml": { "file": "XPS", "stream": "XPS" }, ".xps": { "file": "XPS", "stream": "XPS" } } } ================================================ FILE: tests/run_compound.py ================================================ #! /usr/bin/env python3 ''' Runs a command using different implementations of PyMuPDF: 1. Run with rebased implementation of PyMuPDF. 2. As 1 but also set PYMUPDF_USE_EXTRA=0 to disable use of C++ optimisations. Example usage: ./PyMuPDF/tests/run_compound.py python -m pytest -s PyMuPDF Use `-i ` to select which implementations to use. In ``, `r` means rebased, `R` means rebased without optimisations. For example use the rebased and unoptimised rebased implementations with: ./PyMuPDF/tests/run_compound.py python -m pytest -s PyMuPDF ''' import shlex import os import platform import subprocess import sys import textwrap import time def log(text): print(textwrap.indent(text, 'PyMuPDF:tests/run_compound.py: ')) sys.stdout.flush() def log_star(text): log('#' * 40) log(text) log('#' * 40) def main(): implementations = 'rR' timeout = None i = 1 while i < len(sys.argv): arg = sys.argv[i] if arg == '-i': i += 1 implementations = sys.argv[i] elif arg == '-t': i += 1 timeout = float(sys.argv[i]) elif arg.startswith('-'): raise Exception(f'Unrecognised {arg=}.') else: break i += 1 args = sys.argv[i:] e_rebased = None e_rebased_unoptimised = None endtime = None if timeout: endtime = time.time() + timeout # Check `implementations`. implementations_seen = set() for i in implementations: assert i not in implementations_seen, f'Duplicate implementation {i!r} in {implementations!r}.' if i == 'r': name = 'rebased' elif i == 'R': name = 'rebased (unoptimised)' else: assert 0, f'Unrecognised implementation {i!r} in {implementations!r}.' log(f' {i!r}: will run with PyMuPDF {name}.') implementations_seen.add(i) for i in implementations: log(f'run_compound.py: {i=}') cpu_bits = int.bit_length(sys.maxsize+1) log(f'{os.getcwd()=}') log(f'{platform.machine()=}') log(f'{platform.platform()=}') log(f'{platform.python_version()=}') log(f'{platform.system()=}') if sys.implementation.name != 'graalpy': log(f'{platform.uname()=}') log(f'{sys.executable=}') log(f'{sys.version=}') log(f'{sys.version_info=}') log(f'{list(sys.version_info)=}') log(f'{cpu_bits=}') timeout = None if endtime: timeout = max(0, endtime - time.time()) if i == 'r': # Run with default `pymupdf` (rebased). # log_star( f'Running using pymupdf (rebased): {shlex.join(args)}') e_rebased = subprocess.run( args, shell=0, check=0, timeout=timeout).returncode elif i == 'R': # Run with `pymupdf` (rebased) again, this time with PYMUPDF_USE_EXTRA=0. # env = os.environ.copy() env[ 'PYMUPDF_USE_EXTRA'] = '0' log_star(f'Running using pymupdf (rebased) with PYMUPDF_USE_EXTRA=0: {shlex.join(args)}') e_rebased_unoptimised = subprocess.run( args, shell=0, check=0, env=env, timeout=timeout).returncode else: raise Exception(f'Unrecognised implementation {i!r}.') if e_rebased is not None: log(f'{e_rebased=}') if e_rebased_unoptimised is not None: log(f'{e_rebased_unoptimised=}') if e_rebased or e_rebased_unoptimised: log('Test(s) failed.') return 1 if __name__ == '__main__': try: sys.exit(main()) except (subprocess.CalledProcessError, subprocess.TimeoutExpired) as e: # Terminate relatively quietly, failed commands will usually have # generated diagnostics. log(str(e)) sys.exit(1) ================================================ FILE: tests/test_2548.py ================================================ import os import pymupdf root = os.path.abspath(f'{__file__}/../..') def test_2548(): """Text extraction should fail because of PDF structure cycle. Old MuPDF version did not detect the loop. """ print(f'test_2548(): {pymupdf.mupdf_version_tuple=}') pymupdf.TOOLS.mupdf_warnings(reset=True) doc = pymupdf.open(f'{root}/tests/resources/test_2548.pdf') e = False for page in doc: try: _ = page.get_text() except Exception as ee: print(f'test_2548: {ee=}') expected = "RuntimeError('code=2: cycle in structure tree')" assert repr(ee) == expected, f'Expected {expected=} but got {repr(ee)=}.' e = True wt = pymupdf.TOOLS.mupdf_warnings() print(f'test_2548(): {wt=}') # This checks that PyMuPDF 1.23.7 fixes this bug, and also that earlier # versions with updated MuPDF also fix the bug. if pymupdf.mupdf_version_tuple >= (1, 27, 1): expected = '' elif pymupdf.mupdf_version_tuple >= (1, 27): expected = 'format error: No common ancestor in structure tree\nstructure tree broken, assume tree is missing' expected = '\n'.join([expected] * 5) else: expected = 'format error: cycle in structure tree\nstructure tree broken, assume tree is missing' assert wt == expected, f'expected:\n {expected!r}\nwt:\n {wt!r}\n' assert not e ================================================ FILE: tests/test_2634.py ================================================ import pymupdf import difflib import json import os import pprint def test_2634(): if not hasattr(pymupdf, 'mupdf'): print('test_2634(): Not running on classic.') return path = os.path.abspath(f'{__file__}/../../tests/resources/test_2634.pdf') with pymupdf.open(path) as pdf, pymupdf.open() as new: new.insert_pdf(pdf) new.set_toc(pdf.get_toc(simple=False)) toc_pdf = pdf.get_toc(simple=False) toc_new = new.get_toc(simple=False) def clear_xref(toc): ''' Clear toc items that naturally differ. ''' for item in toc: d = item[3] if 'collapse' in d: d['collapse'] = 'dummy' if 'xref' in d: d['xref'] = 'dummy' clear_xref(toc_pdf) clear_xref(toc_new) print('toc_pdf') for item in toc_pdf: print(item) print() print('toc_new') for item in toc_new: print(item) toc_text_pdf = pprint.pformat(toc_pdf, indent=4).split('\n') toc_text_new = pprint.pformat(toc_new, indent=4).split('\n') diff = difflib.unified_diff( toc_text_pdf, toc_text_new, lineterm='', ) print('\n'.join(diff)) # Check 'to' points are identical apart from rounding errors. # assert len(toc_new) == len(toc_pdf) for a, b in zip(toc_pdf, toc_new): a_dict = a[3] b_dict = b[3] if 'to' in a_dict: assert 'to' in b_dict a_to = a_dict['to'] b_to = b_dict['to'] assert isinstance(a_to, pymupdf.Point) assert isinstance(b_to, pymupdf.Point) if a_to != b_to: print(f'Points not identical: {a_to=} {b_to=}.') assert abs(a_to.x - b_to.x) < 0.01 assert abs(a_to.y - b_to.y) < 0.01 ================================================ FILE: tests/test_2904.py ================================================ import pymupdf import os import sys def test_2904(): print(f'test_2904(): {pymupdf.mupdf_version_tuple=}.') path = os.path.abspath(f'{__file__}/../../tests/resources/test_2904.pdf') pdf_docs = pymupdf.open(path) for page_id, page in enumerate(pdf_docs): page_imgs = page.get_images() for i, img in enumerate(page_imgs): if page_id == 5: #print(f'{page_id=} {i=} {type(img)=} {img=}') sys.stdout.flush() e = None try: recs = page.get_image_rects(img, transform=True) except Exception as ee: print(f'Exception: {page_id=} {i=} {img=}: {ee}') if 0 and hasattr(pymupdf, 'mupdf'): print(f'pymupdf.exception_info:') pymupdf.exception_info() sys.stdout.flush() e = ee if page_id == 5: print(f'{pymupdf.mupdf_version_tuple=}: {page_id=} {i=} {e=} {img=}:') if page_id == 5 and i==3: assert e assert str(e) == 'code=8: Failed to read JPX header' else: assert not e # Clear warnings, as we will have generated many. pymupdf.TOOLS.mupdf_warnings() ================================================ FILE: tests/test_2907.py ================================================ import pymupdf import os.path import pathlib def test_2907(): # This test is for a bug in classic 'segfault trying to call clean_contents # on certain pdfs with python 3.12', which we are not going to fix. if not hasattr(pymupdf, 'mupdf'): print('test_2907(): not running on classic because known to fail.') return path = os.path.abspath(f'{__file__}/../../tests/resources/test_2907.pdf') pdf_file = pathlib.Path(path).read_bytes() fitz_document = pymupdf.open(stream=pdf_file, filetype="application/pdf") pdf_pages = list(fitz_document.pages()) (page,) = pdf_pages page.clean_contents() ================================================ FILE: tests/test_4141.py ================================================ import pymupdf import os.path def test_4141(): """survive missing /Resources object in a number of cases.""" path = os.path.abspath(f"{__file__}/../../tests/resources/test_4141.pdf") doc = pymupdf.open(path) page = doc[0] # make sure the right test file assert doc.xref_get_key(page.xref, "Resources") == ("null", "null") page.insert_htmlbox((100, 100, 200, 200), "Hallo") # will fail without the fix doc.close() doc = pymupdf.open(doc.name) page = doc[0] tw = pymupdf.TextWriter(page.rect) tw.append((100, 100), "Hallo") tw.write_text(page) # will fail without the fix ================================================ FILE: tests/test_4503.py ================================================ """ Test for issue #4503 in pymupdf: Correct recognition of strikeout and underline styles in text spans. """ import os import pymupdf from pymupdf import mupdf STRIKEOUT = mupdf.FZ_STEXT_STRIKEOUT UNDERLINE = mupdf.FZ_STEXT_UNDERLINE def test_4503(): """ Check that the text span with the specified text has the correct styling: strikeout, but no underline. Previously, the text was broken in multiple spans with span breaks at every space. and some parts were not detected as strikeout at all. """ scriptdir = os.path.dirname(os.path.abspath(__file__)) text = "the right to request the state to review and, if appropriate," filename = os.path.join(scriptdir, "resources", "test-4503.pdf") doc = pymupdf.open(filename) page = doc[0] flags = pymupdf.TEXT_ACCURATE_BBOXES | pymupdf.TEXT_COLLECT_STYLES spans = [ s for b in page.get_text("dict", flags=flags)["blocks"] for l in b["lines"] for s in l["spans"] if s["text"] == text ] assert spans, "No spans found with the specified text" span = spans[0] assert span["char_flags"] & STRIKEOUT assert not span["char_flags"] & UNDERLINE ================================================ FILE: tests/test_4505.py ================================================ import pymupdf import os.path def test_4505(): """Copy field flags to Parent widget and all of its kids.""" path = os.path.abspath(f"{__file__}/../../tests/resources/test_4505.pdf") doc = pymupdf.open(path) page = doc[0] text1_flags_before = {} text1_flags_after = {} # extract all widgets having the same field name for w in page.widgets(): if w.field_name != "text_1": continue text1_flags_before[w.xref] = w.field_flags # expected exiting field flags assert text1_flags_before == {8: 1, 10: 0, 33: 0} w = page.load_widget(8) # first of these widgets # give all connected widgets that field flags value w.update(sync_flags=True) # confirm that all connected widgets have the same field flags for w in page.widgets(): if w.field_name != "text_1": continue text1_flags_after[w.xref] = w.field_flags assert text1_flags_after == {8: 1, 10: 1, 33: 1} ================================================ FILE: tests/test_4520.py ================================================ import pymupdf def test_4520(): """Accept source pages without /Contents object in show_pdf_page.""" tar = pymupdf.open() src = pymupdf.open() src.new_page() page = tar.new_page() xref = page.show_pdf_page(page.rect, src, 0) assert xref ================================================ FILE: tests/test_4614.py ================================================ import pymupdf import os def test_4614(): script_dir = os.path.dirname(__file__) filename = os.path.join(script_dir, "resources", "test_4614.pdf") src = pymupdf.open(filename) doc = pymupdf.open() doc.insert_pdf(src) ================================================ FILE: tests/test_4716.py ================================================ import pymupdf import os def test_4716(): """Confirm that ZERO WIDTH JOINER will never start a word.""" script_dir = os.path.dirname(__file__) filename = os.path.join(script_dir, "resources", "test_4716.pdf") doc = pymupdf.open(filename) expected = set(["+25.00", "Любимый", "-10.00"]) word_text = set() for page in doc: words = page.get_text("words") for w in words: word_text.add(w[4]) assert word_text == expected ================================================ FILE: tests/test_4767.py ================================================ import shutil import os import platform import pymupdf import subprocess import sys import sysconfig def test_4767(): ''' Check handling of unsafe paths in `pymupdf embed-extract`. ''' if os.environ.get('PYODIDE_ROOT'): print('test_4767(): not running on Pyodide - cannot run child processes.') return if (1 and platform.system() == 'Windows' and os.environ.get('GITHUB_ACTIONS') == 'true' and os.environ.get('CIBUILDWHEEL') == '1' ): print(f'test_4767(): not running because known to fail on Github/Windows/Cibuildwheel.') # Using -unsafe makes pymupdf return 0 but does not seem to create # output file. return with pymupdf.open() as document: document.new_page() document.embfile_add( 'evil_entry', b'poc:traversal test\n', filename="../../test.txt", ufilename="../../test.txt", desc="poc", ) document.embfile_add( 'evil_entry2', b'poc:traversal test\n', filename="test2.txt", ufilename="test2.txt", desc="poc", ) path = os.path.abspath(f'{__file__}/../../tests/test_4767.pdf') document.save(path) testdir = os.path.abspath(f'{__file__}/../../tests/test_4767_dir').replace('\\', '/') shutil.rmtree(testdir, ignore_errors=1) os.makedirs(f'{testdir}/one/two', exist_ok=1) def run(command, *, check=0, capture=1): print(f'Running: {command}') cp = subprocess.run( command, shell=1, text=1, check=check, stdout=subprocess.PIPE if capture else None, stderr=subprocess.STDOUT if capture else None, ) print(cp.stdout) return cp def get_paths(): paths = list() for dirpath, dirnames, filenames in os.walk(testdir): for filename in filenames: path = f'{dirpath}/{filename}'.replace('\\', '/') paths.append(path) return paths def get_stdout(cp): ''' Strips free-threading warning. ''' stdout = cp.stdout if sysconfig.get_config_var('Py_GIL_DISABLED') == 1 and sys._is_gil_enabled(): line0, stdout = stdout.split('\n', 1) assert 'The global interpreter lock (GIL) has been enabled to load module \'pymupdf._extra\',' in line0 return stdout cp = run(f'cd {testdir}/one/two && {sys.executable} -m pymupdf embed-extract {path} -name evil_entry') assert cp.returncode stdout = get_stdout(cp) print(f'{stdout=}') assert stdout == 'refusing to write stored name outside current directory: ../../test.txt\n' assert not get_paths() cp = run(f'cd {testdir}/one/two && {sys.executable} -m pymupdf embed-extract {path} -name evil_entry -unsafe') assert cp.returncode == 0 stdout = get_stdout(cp) assert stdout == "saved entry 'evil_entry' as '../../test.txt'\n" paths = get_paths() print(f'{paths=}') assert paths == [f'{testdir}/test.txt'] cp = run(f'cd {testdir}/one/two && {sys.executable} -m pymupdf embed-extract {path} -name evil_entry2') assert not cp.returncode stdout = get_stdout(cp) assert stdout == "saved entry 'evil_entry2' as 'test2.txt'\n" paths = get_paths() print(f'{paths=}') assert paths == [f'{testdir}/test.txt', f'{testdir}/one/two/test2.txt'] cp = run(f'cd {testdir}/one/two && {sys.executable} -m pymupdf embed-extract {path} -name evil_entry2') assert cp.returncode stdout = get_stdout(cp) assert stdout == "refusing to overwrite existing file with stored name: test2.txt\n" paths = get_paths() print(f'{paths=}') assert paths == [f'{testdir}/test.txt', f'{testdir}/one/two/test2.txt'] cp = run(f'cd {testdir}/one/two && {sys.executable} -m pymupdf embed-extract {path} -name evil_entry2 -unsafe') assert not cp.returncode stdout = get_stdout(cp) assert stdout == "saved entry 'evil_entry2' as 'test2.txt'\n" paths = get_paths() print(f'{paths=}') assert paths == [f'{testdir}/test.txt', f'{testdir}/one/two/test2.txt'] ================================================ FILE: tests/test_4942.py ================================================ import pymupdf, os def test_4942(): path = os.path.abspath(f"{__file__}/../../tests/resources/test_4942.pdf") document = pymupdf.Document(path) page = document[0] page.clip_to_rect(page.rect) page.get_links() ================================================ FILE: tests/test_annots.py ================================================ # -*- coding: utf-8 -*- """ Test PDF annotation insertions. """ import copy import os import platform import pymupdf import gentle_compare red = (1, 0, 0) blue = (0, 0, 1) gold = (1, 1, 0) green = (0, 1, 0) scriptdir = os.path.dirname(__file__) displ = pymupdf.Rect(0, 50, 0, 50) r = pymupdf.Rect(72, 72, 220, 100) t1 = "têxt üsès Lätiñ charß,\nEUR: €, mu: µ, super scripts: ²³!" rect = pymupdf.Rect(100, 100, 200, 200) def test_caret(): doc = pymupdf.open() page = doc.new_page() annot = page.add_caret_annot(rect.tl) assert annot.type == (14, "Caret") annot.update(rotate=20) page.annot_names() page.annot_xrefs() def test_freetext(): doc = pymupdf.open() page = doc.new_page() annot = page.add_freetext_annot( rect, t1, fontsize=10, rotate=90, text_color=blue, fill_color=gold, align=pymupdf.TEXT_ALIGN_CENTER, ) annot.set_border(width=0.3, dashes=[2]) annot.update(text_color=blue, fill_color=gold) assert annot.type == (2, "FreeText") def test_text(): doc = pymupdf.open() page = doc.new_page() annot = page.add_text_annot(r.tl, t1) assert annot.type == (0, "Text") def test_highlight(): doc = pymupdf.open() page = doc.new_page() annot = page.add_highlight_annot(rect) assert annot.type == (8, "Highlight") def test_underline(): doc = pymupdf.open() page = doc.new_page() annot = page.add_underline_annot(rect) assert annot.type == (9, "Underline") def test_squiggly(): doc = pymupdf.open() page = doc.new_page() annot = page.add_squiggly_annot(rect) assert annot.type == (10, "Squiggly") def test_strikeout(): doc = pymupdf.open() page = doc.new_page() annot = page.add_strikeout_annot(rect) assert annot.type == (11, "StrikeOut") page.delete_annot(annot) def test_polyline(): doc = pymupdf.open() page = doc.new_page() rect = page.rect + (100, 36, -100, -36) cell = pymupdf.make_table(rect, rows=10) for i in range(10): annot = page.add_polyline_annot((cell[i][0].bl, cell[i][0].br)) annot.set_line_ends(i, i) annot.update() for i, annot in enumerate(page.annots()): assert annot.line_ends == (i, i) assert annot.type == (7, "PolyLine") def test_polygon(): doc = pymupdf.open() page = doc.new_page() annot = page.add_polygon_annot([rect.bl, rect.tr, rect.br, rect.tl]) assert annot.type == (6, "Polygon") def test_line(): doc = pymupdf.open() page = doc.new_page() rect = page.rect + (100, 36, -100, -36) cell = pymupdf.make_table(rect, rows=10) for i in range(10): annot = page.add_line_annot(cell[i][0].bl, cell[i][0].br) annot.set_line_ends(i, i) annot.update() for i, annot in enumerate(page.annots()): assert annot.line_ends == (i, i) assert annot.type == (3, "Line") def test_square(): doc = pymupdf.open() page = doc.new_page() annot = page.add_rect_annot(rect) assert annot.type == (4, "Square") def test_circle(): doc = pymupdf.open() page = doc.new_page() annot = page.add_circle_annot(rect) assert annot.type == (5, "Circle") def test_fileattachment(): doc = pymupdf.open() page = doc.new_page() annot = page.add_file_annot(rect.tl, b"just anything for testing", "testdata.txt") assert annot.type == (17, "FileAttachment") def test_stamp(): doc = pymupdf.open() page = doc.new_page() annot = page.add_stamp_annot(r, stamp=0) assert annot.type == (13, "Stamp") assert annot.info["content"] == "Approved" annot_id = annot.info["id"] annot_xref = annot.xref page.load_annot(annot_id) page.load_annot(annot_xref) page = doc.reload_page(page) def test_image_stamp(): doc = pymupdf.open() page = doc.new_page() filename = os.path.join(scriptdir, "resources", "nur-ruhig.jpg") annot = page.add_stamp_annot(r, stamp=filename) assert annot.info["content"] == "Image Stamp" def test_redact1(): doc = pymupdf.open() page = doc.new_page() annot = page.add_redact_annot(r, text="Hello") annot.update( cross_out=True, rotate=-1, ) assert annot.type == (12, "Redact") annot.get_pixmap() info = annot.info annot.set_info(info) assert not annot.has_popup annot.set_popup(r) s = annot.popup_rect assert s == r page.apply_redactions() def test_redact2(): """Test for keeping text and removing graphics.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_redact2' in classic") return filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") doc = pymupdf.open(filename) page = doc[0] all_text0 = page.get_text("words") page.add_redact_annot(page.rect) page.apply_redactions(text=1) t = page.get_text("words") assert t == all_text0 assert not page.get_drawings() def test_redact3(): """Test for removing text and graphics.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_redact3' in classic") return filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") doc = pymupdf.open(filename) page = doc[0] page.add_redact_annot(page.rect) page.apply_redactions() assert not page.get_text("words") assert not page.get_drawings() def test_redact4(): """Test for removing text and keeping graphics.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_redact4' in classic") return filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") doc = pymupdf.open(filename) page = doc[0] line_art = page.get_drawings() page.add_redact_annot(page.rect) page.apply_redactions(graphics=0) doc.save(os.path.normpath(f'{__file__}/../../tests/test_redact4_out.pdf')) assert not page.get_text("words") assert line_art == page.get_drawings() def test_1645(): ''' Test fix for #1645. ''' # The expected output files assume annot_stem is 'jorj'. We need to always # restore this before returning (this is checked by conftest.py). annot_stem = pymupdf.JM_annot_id_stem pymupdf.TOOLS.set_annot_stem('jorj') try: path_in = os.path.abspath( f'{__file__}/../resources/symbol-list.pdf') if pymupdf.mupdf_version_tuple >= (1, 27): path_expected = os.path.abspath( f'{__file__}/../../tests/resources/test_1645_expected-after-1.27.0.pdf') else: path_expected = os.path.abspath( f'{__file__}/../../tests/resources/test_1645_expected.pdf') path_out = os.path.abspath( f'{__file__}/../test_1645_out.pdf') doc = pymupdf.open(path_in) page = doc[0] page_bounds = page.bound() annot_loc = pymupdf.Rect(page_bounds.x0, page_bounds.y0, page_bounds.x0 + 75, page_bounds.y0 + 15) # Check type of page.derotation_matrix - this is #2911. assert isinstance(page.derotation_matrix, pymupdf.Matrix), \ f'Bad type for page.derotation_matrix: {type(page.derotation_matrix)=} {page.derotation_matrix=}.' page.add_freetext_annot( annot_loc * page.derotation_matrix, "TEST", fontsize=18, fill_color=pymupdf.utils.getColor("FIREBRICK1"), rotate=page.rotation, ) doc.save(path_out, garbage=1, deflate=True, no_new_id=True) print(f'Have created {path_out}. comparing with {path_expected}.') with pymupdf.open(path_expected) as doc_expected, pymupdf.open(path_out) as doc_out: rms = gentle_compare.pixmaps_rms( doc_expected[0].get_pixmap(), doc_out[0].get_pixmap(), ) print(f'test_1645: {rms=}') assert rms < 0.1, f'Pixmaps differ: {path_expected=} {path_out=}' finally: # Restore annot_stem. pymupdf.TOOLS.set_annot_stem(annot_stem) def test_1824(): ''' Test for fix for #1824: SegFault when applying redactions overlapping a transparent image. ''' path = os.path.abspath( f'{__file__}/../resources/test_1824.pdf') doc=pymupdf.open(path) page=doc[0] page.apply_redactions() def test_2270(): ''' https://github.com/pymupdf/PyMuPDF/issues/2270 ''' path = os.path.abspath( f'{__file__}/../../tests/resources/test_2270.pdf') with pymupdf.open(path) as document: for page_number, page in enumerate(document): for textBox in page.annots(types=(pymupdf.PDF_ANNOT_FREE_TEXT,pymupdf.PDF_ANNOT_TEXT)): print("textBox.type :", textBox.type) print(f"{textBox.rect=}") print("textBox.get_text('words') : ", textBox.get_text('words')) print("textBox.get_text('text') : ", textBox.get_text('text')) print("textBox.get_textbox(textBox.rect) : ", textBox.get_textbox(textBox.rect)) print("textBox.info['content'] : ", textBox.info['content']) assert textBox.type == (2, 'FreeText') assert textBox.get_text('words')[0][4] == 'abc123' assert textBox.get_text('text') == 'abc123\n' assert textBox.get_textbox(textBox.rect) == 'abc123' assert textBox.info['content'] == 'abc123' # Additional check that Annot.get_textpage() returns a # TextPage that works with page.get_text() - prior to # 2024-01-30 the TextPage had no `.parent` member. textpage = textBox.get_textpage() text = page.get_text() print(f'{text=}') text = page.get_text(textpage=textpage) print(f'{text=}') print(f'{getattr(textpage, "parent")=}') # Check Annotation.get_textpage()'s arg. clip = textBox.rect clip.x1 = clip.x0 + (clip.x1 - clip.x0) / 3 textpage2 = textBox.get_textpage(clip=clip) text = textpage2.extractText() print(f'With {clip=}: {text=}') assert text == 'ab\n' def test_2934_add_redact_annot(): ''' Test fix for bug mentioned in #2934. ''' path = os.path.abspath(f'{__file__}/../../tests/resources/mupdf_explored.pdf') with open(path, 'rb') as f: data = f.read() doc = pymupdf.Document(stream=data) print(f'Is PDF: {doc.is_pdf}') print(f'Number of pages: {doc.page_count}') import json page=doc[0] page_json_str =doc[0].get_text("json") page_json_data = json.loads(page_json_str) span=page_json_data.get("blocks")[0].get("lines")[0].get("spans")[0] page.add_redact_annot(span["bbox"], text="") page.apply_redactions() def test_2969(): ''' https://github.com/pymupdf/PyMuPDF/issues/2969 ''' path = os.path.abspath(f'{__file__}/../../tests/resources/test_2969.pdf') doc = pymupdf.open(path) page = doc[0] first_annot = list(page.annots())[0] first_annot.next def test_file_info(): path = os.path.abspath(f'{__file__}/../../tests/resources/test_annot_file_info.pdf') document = pymupdf.open(path) results = list() for i, page in enumerate(document): print(f'{i=}') annotations = page.annots() for j, annotation in enumerate(annotations): print(f'{j=} {annotation=}') t = annotation.type print(f'{t=}') if t[0] == pymupdf.PDF_ANNOT_FILE_ATTACHMENT: file_info = annotation.file_info print(f'{file_info=}') results.append(file_info) assert results == [ {'filename': 'example.pdf', 'description': '', 'length': 8416, 'size': 8992}, {'filename': 'photo1.jpeg', 'description': '', 'length': 10154, 'size': 8012}, ] def test_3131(): doc = pymupdf.open() page = doc.new_page() page.add_line_annot((0, 0), (1, 1)) page.add_line_annot((1, 0), (0, 1)) first_annot, _ = page.annots() first_annot.next.type def test_3209(): pdf = pymupdf.Document(filetype="pdf") page = pdf.new_page() page.add_ink_annot([[(300,300), (400, 380), (350, 350)]]) n = 0 for annot in page.annots(): n += 1 assert annot.vertices == [[(300.0, 300.0), (400.0, 380.0), (350.0, 350.0)]] assert n == 1 path = os.path.abspath(f'{__file__}/../../tests/test_3209_out.pdf') pdf.save(path) # Check the output PDF that the annotation is correctly drawn def test_3863(): path_in = os.path.normpath(f'{__file__}/../../tests/resources/test_3863.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/test_3863.pdf.pdf') # Create redacted PDF. print(f'Loading {path_in=}.') with pymupdf.open(path_in) as document: for num, page in enumerate(document): print(f"Page {num + 1} - {page.rect}:") for image in page.get_images(full=True): print(f" - Image: {image}") redact_rect = page.rect if page.rotation in (90, 270): redact_rect = pymupdf.Rect(0, 0, page.rect.height, page.rect.width) page.add_redact_annot(redact_rect) page.apply_redactions(images=pymupdf.PDF_REDACT_IMAGE_NONE) print(f'Writing to {path_out=}.') document.save(path_out) with pymupdf.open(path_out) as document: assert len(document) == 8 # Create PNG for each page of redacted PDF. for num, page in enumerate(document): path_png = f'{path_out}.{num}.png' pixmap = page.get_pixmap() print(f'Writing to {path_png=}.') pixmap.save(path_png) # Compare with expected png. print(f'Comparing page PNGs with expected PNGs.') for num, _ in enumerate(document): path_png = f'{path_out}.{num}.png' path_png_expected = f'{path_in}.pdf.{num}.png' print(f'{path_png=}.') print(f'{path_png_expected=}.') rms = gentle_compare.pixmaps_rms(path_png, path_png_expected, ' ') # We get small differences in sysinstall tests, where some # thirdparty libraries can differ. assert rms < 1 def test_3758(): # This test requires input file that is not public, so is usually not # available. path = os.path.normpath(f'{__file__}/../../../test_3758.pdf') if not os.path.exists(path): print(f'test_3758(): not running because does not exist: {path=}.') return import json with pymupdf.open(path) as document: for page in document: info = json.loads(page.get_text('json', flags=pymupdf.TEXTFLAGS_TEXT)) for block_ind, block in enumerate(info['blocks']): for line_ind, line in enumerate(block['lines']): for span_ind, span in enumerate(line['spans']): # print(span) page.add_redact_annot(pymupdf.Rect(*span['bbox'])) page.apply_redactions() wt = pymupdf.TOOLS.mupdf_warnings() assert wt def test_parent(): """Test invalidating parent on page re-assignment.""" doc = pymupdf.open() page = doc.new_page() a = page.add_highlight_annot(page.rect) # insert annotation on page 0 page = doc.new_page() # make a new page, should orphanate annotation try: print(a) # should raise except Exception as e: if platform.system() == 'OpenBSD': assert isinstance(e, pymupdf.mupdf.FzErrorBase), f'Incorrect {type(e)=}.' else: assert isinstance(e, pymupdf.mupdf.FzErrorArgument), f'Incorrect {type(e)=}.' assert str(e) == 'code=4: annotation not bound to any page', f'Incorrect error text {str(e)=}.' else: assert 0, f'Failed to get expected exception.' def test_4047(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4047.pdf') with pymupdf.open(path) as document: page = document[0] fontname = page.get_fonts()[0][3] if fontname not in pymupdf.Base14_fontnames: fontname = "Courier" hits = page.search_for("|") for rect in hits: page.add_redact_annot( rect, " ", fontname=fontname, align=pymupdf.TEXT_ALIGN_CENTER, fontsize=10 ) # Segmentation Fault... page.apply_redactions() def test_4079(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4079.pdf') path_after = os.path.normpath(f'{__file__}/../../tests/resources/test_4079_after.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/test_4079_out') with pymupdf.open(path_after) as document_after: page = document_after[0] pixmap_after_expected = page.get_pixmap() with pymupdf.open(path) as document: page = document[0] rects = [ [164,213,282,227], [282,213,397,233], [434,209,525,243], [169,228,231,243], [377,592,440,607], [373,611,444,626], ] for rect in rects: page.add_redact_annot(rect, fill=(1,0,0)) page.draw_rect(rect, color=(0, 1, 0)) document.save(f'{path_out}_before.pdf') page.apply_redactions(images=0) pixmap_after = page.get_pixmap() document.save(f'{path_out}_after.pdf') rms = gentle_compare.pixmaps_rms(pixmap_after_expected, pixmap_after) diff = gentle_compare.pixmaps_diff(pixmap_after_expected, pixmap_after) path = os.path.normpath(f'{__file__}/../../tests/test_4079_diff.png') diff.save(path) print(f'{rms=}') assert rms == 0 def test_4254(): """Ensure that both annotations are fully created We do this by asserting equal top-used colors in respective pixmaps. """ doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(100, 100, 200, 150) annot = page.add_freetext_annot(rect, "Test Annotation from minimal example") annot.set_border(width=1, dashes=(3, 3)) annot.set_opacity(0.5) try: annot.set_colors(stroke=(1, 0, 0)) except ValueError as e: assert 'cannot be used for FreeText annotations' in str(e), f'{e}' else: assert 0 annot.update() rect = pymupdf.Rect(200, 200, 400, 400) annot2 = page.add_freetext_annot(rect, "Test Annotation from minimal example pt 2") annot2.set_border(width=1, dashes=(3, 3)) annot2.set_opacity(0.5) try: annot2.set_colors(stroke=(1, 0, 0)) except ValueError as e: assert 'cannot be used for FreeText annotations' in str(e), f'{e}' else: assert 0 annot.update() annot2.update() # stores top color for each pixmap top_colors = set() for annot in page.annots(): pix = annot.get_pixmap() top_colors.add(pix.color_topusage()[1]) # only one color must exist assert len(top_colors) == 1 def test_richtext(): """Test creation of rich text FreeText annotations. We create the same annotation on different pages in different ways, with and without using Annotation.update(), and then assert equality of the respective images. """ ds = """font-size: 11pt; font-family: sans-serif;""" bullet = chr(0x2610) + chr(0x2611) + chr(0x2612) text = f"""

PyMuPDF འདི་ ཡིག་ཆ་བཀྲམ་སྤེལ་གྱི་དོན་ལུ་ པའི་ཐོན་ཐུམ་སྒྲིལ་དྲག་ཤོས་དང་མགྱོགས་ཤོས་ཅིག་ཨིན། Here is some bold and italic text, followed by bold-italic. Text-based check boxes: {bullet}.

""" gold = (1, 1, 0) doc = pymupdf.open() # First page. page = doc.new_page() rect = pymupdf.Rect(100, 100, 350, 200) p2 = rect.tr + (50, 30) p3 = p2 + (0, 30) annot = page.add_freetext_annot( rect, text, fill_color=gold, opacity=0.5, rotate=90, border_width=1, dashes=None, richtext=True, callout=(p3, p2, rect.tr), ) pix1 = page.get_pixmap() # Second page. # the annotation is created with minimal parameters, which are supplied # in a separate call to the .update() method. page = doc.new_page() annot = page.add_freetext_annot( rect, text, border_width=1, dashes=None, richtext=True, callout=(p3, p2, rect.tr), ) annot.update(fill_color=gold, opacity=0.5, rotate=90) pix2 = page.get_pixmap() assert pix1.samples == pix2.samples def test_4447(): document = pymupdf.open() page = document.new_page() text_color = (1, 0, 0) fill_color = (0, 1, 0) border_color = (0, 0, 1) annot_rect = pymupdf.Rect(90.1, 486.73, 139.26, 499.46) try: annot = page.add_freetext_annot( annot_rect, "AETERM", fontname="Arial", fontsize=10, text_color=text_color, fill_color=fill_color, border_color=border_color, border_width=1, ) except ValueError as e: assert 'cannot set border_color if rich_text is False' in str(e), str(e) else: assert 0 try: annot = page.add_freetext_annot( (30, 400, 100, 450), "Two", fontname="Arial", fontsize=10, text_color=text_color, fill_color=fill_color, border_color=border_color, border_width=1, ) except ValueError as e: assert 'cannot set border_color if rich_text is False' in str(e), str(e) else: assert 0 annot = page.add_freetext_annot( (30, 500, 100, 550), "Three", fontname="Arial", fontsize=10, text_color=text_color, border_width=1, ) annot.update(text_color=text_color, fill_color=fill_color) try: annot.update(border_color=border_color) except ValueError as e: assert 'cannot set border_color if rich_text is False' in str(e), str(e) else: assert 0 path_out = os.path.normpath(f'{__file__}/../../tests/test_4447.pdf') document.save(path_out) def test_4755(): print() path = os.path.normpath(f'{__file__}/../../tests/resources/test_4755.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/test_4755_out.pdf') with pymupdf.open(path) as document: for page_i, page in enumerate(document): print(f'{page_i=}') caret = page.add_caret_annot((50,50)) colours = [ (0, 0, 1), (0, 1, 0), (1, 0, 0), ] for annot_i, annot in enumerate(page.annots()): print(f'{annot_i=}') #if annot_i != 2: # continue before_rect = copy.deepcopy(annot.rect) def draw_rectangle(rect, c, w): drect = page.add_freetext_annot(rect, str(annot_i), text_color=c) drect.set_border(width=w) drect.update() colour = colours[annot_i] print(f'{colour=}') draw_rectangle(annot.rect, colour, .3) print(f'before: {annot.rect}=') annot.set_rect(annot.rect) print(f' after: {annot.rect}=') print(f'difference: {annot.rect-before_rect=}') draw_rectangle(annot.rect, (0, 1, 0), .3) print() document.save(path_out) print(f' {path=}.') print(f'{path_out=}.') def test_4944(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4944.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/test_4944_out.pdf') print() with pymupdf.open(path) as document: page = document[0] print(f'{page.rotation=}') print(f'{page.rotation_matrix=}') print(f'{page.transformation_matrix=}') text_json = page.get_text('rawjson') #print(text_json) page.add_redact_annot(page.rect) page.apply_redactions(text=pymupdf.PDF_REDACT_TEXT_REMOVE) document.save(path_out) print(repr(page.get_text())) text_json = page.get_text('rawjson') #print(text_json) ================================================ FILE: tests/test_badfonts.py ================================================ """ Ensure we can deal with non-Latin font names. """ import os import pymupdf def test_survive_names(): scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "has-bad-fonts.pdf") doc = pymupdf.open(filename) print("File '%s' uses the following fonts on page 0:" % doc.name) for f in doc.get_page_fonts(0): print(f) ================================================ FILE: tests/test_balance_count.py ================================================ import pymupdf def test_q_count(): """Testing graphics state balances and wrap_contents(). Take page's contents and generate various imbalanced graphics state situations. Each time compare q-count with expected results. Finally confirm we are out of balance using "is_wrapped", wrap the contents object(s) via "wrap_contents()" and confirm success. PDF commands "q" / "Q" stand for "push", respectively "pop". """ doc = pymupdf.open() page = doc.new_page() # the page has no /Contents objects at all yet. Create one causing # an initial imbalance (so prepended "q" is needed) pymupdf.TOOLS._insert_contents(page, b"Q", True) # append assert page._count_q_balance() == (1, 0) assert page.is_wrapped is False # Prepend more data that yield a different type of imbalanced contents: # Although counts of q and Q are equal now, the unshielded 'cm' before # the first 'q' makes the contents unusable for insertions. pymupdf.TOOLS._insert_contents(page, b"1 0 0 -1 0 0 cm q ", False) # prepend assert page.is_wrapped is False if page._count_q_balance() == (0, 0): print("imbalance undetected by q balance count") text = "Hello, World!" page.insert_text((100, 100), text) # establishes balance! # this should have produced a balanced graphics state assert page._count_q_balance() == (0, 0) assert page.is_wrapped # an appended "pop" must be balanced by a prepended "push" pymupdf.TOOLS._insert_contents(page, b"Q", True) # append assert page._count_q_balance() == (1, 0) # a prepended "pop" yet needs another push pymupdf.TOOLS._insert_contents(page, b"Q", False) # prepend assert page._count_q_balance() == (2, 0) # an appended "push" needs an additional "pop" pymupdf.TOOLS._insert_contents(page, b"q", True) # append assert page._count_q_balance() == (2, 1) # wrapping the contents should yield a balanced state again assert page.is_wrapped is False page.wrap_contents() assert page.is_wrapped is True assert page._count_q_balance() == (0, 0) ================================================ FILE: tests/test_barcode.py ================================================ import os import pymupdf def test_barcode(): path = os.path.normpath(f'{__file__}/../../tests/test_barcode_out.pdf') url = 'http://artifex.com' text_in = '012345678901' text_out = '123456789012' # Create empty document and add a qrcode image. with pymupdf.Document() as document: page = document.new_page() pixmap = pymupdf.mupdf.fz_new_barcode_pixmap( pymupdf.mupdf.FZ_BARCODE_QRCODE, url, 512, 4, # ec_level 0, # quiet 1, # hrt ) pixmap = pymupdf.Pixmap('raw', pixmap) page.insert_image( (0, 0, 100, 100), pixmap=pixmap, ) pixmap = pymupdf.mupdf.fz_new_barcode_pixmap( pymupdf.mupdf.FZ_BARCODE_EAN13, text_in, 512, 4, # ec_level 0, # quiet 1, # hrt ) pixmap = pymupdf.Pixmap('raw', pixmap) page.insert_image( (0, 200, 100, 300), pixmap=pixmap, ) document.save(path) with pymupdf.open(path) as document: page = document[0] for i, ii in enumerate(page.get_images()): xref = ii[0] pixmap = pymupdf.Pixmap(document, xref) hrt, barcode_type = pymupdf.mupdf.fz_decode_barcode_from_pixmap2( pixmap.this, 0, # rotate. ) print(f'{hrt=}') if i == 0: assert hrt == url elif i == 1: assert hrt == text_out else: assert 0 ================================================ FILE: tests/test_clip_page.py ================================================ """ Test Page method clip_to_rect. """ import os import pymupdf def test_clip(): """ Clip a Page to a rectangle and confirm that no text has survived that is completely outside the rectangle.. """ scriptdir = os.path.dirname(os.path.abspath(__file__)) rect = pymupdf.Rect(200, 200, 400, 500) filename = os.path.join(scriptdir, "resources", "v110-changes.pdf") doc = pymupdf.open(filename) page = doc[0] page.clip_to_rect(rect) # clip the page to the rectangle # capture font warning message of MuPDF if pymupdf.mupdf_version_tuple < (1, 27): assert pymupdf.TOOLS.mupdf_warnings() == "bogus font ascent/descent values (0 / 0)" # extract all text characters and assert that each one # has a non-empty intersection with the rectangle. chars = [ c for b in page.get_text("rawdict")["blocks"] for l in b["lines"] for s in l["spans"] for c in s["chars"] ] for char in chars: bbox = pymupdf.Rect(char["bbox"]) if bbox.is_empty: continue assert bbox.intersects( rect ), f"Character '{char['c']}' at {bbox} is outside of {rect}." ================================================ FILE: tests/test_cluster_drawings.py ================================================ import os import pymupdf scriptdir = os.path.dirname(__file__) def test_cluster1(): """Confirm correct identification of known examples.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_cluster1' in classic") return filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") doc = pymupdf.open(filename) page = doc[0] assert len(page.cluster_drawings()) == 10 filename = os.path.join(scriptdir, "resources", "chinese-tables.pdf") doc = pymupdf.open(filename) page = doc[0] assert len(page.cluster_drawings()) == 2 def test_cluster2(): """Join disjoint but neighbored drawings.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_cluster2' in classic") return doc = pymupdf.open() page = doc.new_page() r1 = pymupdf.Rect(100, 100, 200, 200) r2 = pymupdf.Rect(203, 203, 400, 400) page.draw_rect(r1) page.draw_rect(r2) assert page.cluster_drawings() == [r1 | r2] def test_cluster3(): """Confirm as separate if neighborhood threshold exceeded.""" if not hasattr(pymupdf, "mupdf"): print("Not executing 'test_cluster3' in classic") return doc = pymupdf.open() page = doc.new_page() r1 = pymupdf.Rect(100, 100, 200, 200) r2 = pymupdf.Rect(204, 200, 400, 400) page.draw_rect(r1) page.draw_rect(r2) assert page.cluster_drawings() == [r1, r2] def test_4599(): print() path = os.path.normpath(f'{__file__}/../../tests/resources/test_4599.pdf') n = 0 with pymupdf.open(path) as document: for page in document: for clip in page.cluster_drawings(): print(clip) n += 1 assert n == 3 ================================================ FILE: tests/test_codespell.py ================================================ import pymupdf import os import platform import shlex import subprocess import sys import textwrap def test_codespell(): ''' Check Python code with codespell. ''' if os.environ.get('PYODIDE_ROOT'): print('test_codespell(): not running on Pyodide - cannot run child processes.') return if platform.system() == 'Windows': # Git commands seem to fail on Github Windows runners. print(f'test_codespell(): Not running on Windows') return root = os.path.abspath(f'{__file__}/../..') # For now we ignore files that we would ideally still look at, because it # is difficult to exclude some text sections. skips = textwrap.dedent(''' *.pdf docs/_static/prism/prism.js docs/_static/prism/prism.js docs/locales/ja/LC_MESSAGES/changes.po docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.po docs/locales/ src_classic/* ''') skips = skips.strip().replace('\n', ',') command = textwrap.dedent(f''' cd {root} && codespell --skip {shlex.quote(skips)} --ignore-words-list re-use,flate,thirdparty,re-using --ignore-regex 'https?://[a-z0-9/_.]+' --ignore-multiline-regex 'codespell:ignore-begin.*codespell:ignore-end' ''') import pipcl git_files = pipcl.git_items(root) command_args_path = os.path.normpath(f'{__file__}/../test_codespell_args.txt') command += f' @{command_args_path}' with open(command_args_path, 'w') as f: for p in git_files: _, ext = os.path.splitext(p) if ext in ('.png', '.pdf', '.jpg', '.svg'): pass else: #command += f' {p}\n' print(p, file=f) if platform.system() != 'Windows': command = command.replace('\n', ' \\\n') if 0: with open(command_args_path) as f: command_args_path_contents = f.read() print(f'command_args_path:{command_args_path_contents}') print(f'Running codespell: {command}') subprocess.run(command, shell=1, check=1) print('test_codespell(): codespell succeeded.') ================================================ FILE: tests/test_crypting.py ================================================ """ Check PDF encryption: * make a PDF with owber and user passwords * open and decrypt as owner or user """ import pymupdf def test_encryption(): text = "some secret information" # keep this data secret perm = int( pymupdf.PDF_PERM_ACCESSIBILITY # always use this | pymupdf.PDF_PERM_PRINT # permit printing | pymupdf.PDF_PERM_COPY # permit copying | pymupdf.PDF_PERM_ANNOTATE # permit annotations ) owner_pass = "owner" # owner password user_pass = "user" # user password encrypt_meth = pymupdf.PDF_ENCRYPT_AES_256 # strongest algorithm doc = pymupdf.open() # empty pdf page = doc.new_page() # empty page page.insert_text((50, 72), text) # insert the data tobytes = doc.tobytes( encryption=encrypt_meth, # set the encryption method owner_pw=owner_pass, # set the owner password user_pw=user_pass, # set the user password permissions=perm, # set permissions ) doc.close() doc = pymupdf.open("pdf", tobytes) assert doc.needs_pass assert doc.is_encrypted rc = doc.authenticate("owner") assert rc == 4 assert not doc.is_encrypted doc.close() doc = pymupdf.open("pdf", tobytes) rc = doc.authenticate("user") assert rc == 2 ================================================ FILE: tests/test_docs_samples.py ================================================ ''' Test sample scripts in docs/samples/. ''' import glob import os import pytest import runpy # We only look at sample scripts that can run standalone (i.e. don't require # sys.argv). # root = os.path.abspath(f'{__file__}/../..') samples = [] for p in glob.glob(f'{root}/docs/samples/*.py'): if os.path.basename(p) in ( 'make-bold.py', # Needs sys.argv[1]. 'multiprocess-gui.py', # GUI. 'multiprocess-render.py', # Needs sys.argv[1]. 'text-lister.py', # Needs sys.argv[1]. ): print(f'Not testing: {p}') else: p = os.path.relpath(p, root) samples.append(p) def _test_all(): # Allow runnings tests directly without pytest. import subprocess import sys e = 0 for sample in samples: print( f'Running: {sample}', flush=1) try: if 0: # Curiously this fails in an odd way when testing compound # package with $PYTHONPATH set. print( f'os.environ is:') for n, v in os.environ.items(): print( f' {n}: {v!r}') command = f'{sys.executable} {sample}' print( f'command is: {command!r}') sys.stdout.flush() subprocess.check_call( command, shell=1, text=1) else: runpy.run_path(sample) except Exception: print( f'Failed: {sample}') e += 1 if e: raise Exception( f'Errors: {e}') # We use pytest.mark.parametrize() to run sample scripts via a fn, which # ensures that pytest treats each script as a test. # @pytest.mark.parametrize('sample', samples) def test_docs_samples(sample): sample = f'{root}/{sample}' runpy.run_path(sample) ================================================ FILE: tests/test_drawings.py ================================================ """ Extract drawings of a PDF page and compare with stored expected result. """ import io import os import sys import pprint import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") symbols = os.path.join(scriptdir, "resources", "symbols.txt") def test_drawings1(): symbols_text = open(symbols).read() # expected result doc = pymupdf.open(filename) page = doc[0] paths = page.get_cdrawings() out = io.StringIO() # pprint output goes here pprint.pprint(paths, stream=out) assert symbols_text == out.getvalue() def test_drawings2(): delta = (0, 20, 0, 20) doc = pymupdf.open() page = doc.new_page() r = pymupdf.Rect(100, 100, 200, 200) page.draw_circle(r.br, 2, color=0) r += delta page.draw_line(r.tl, r.br, color=0) r += delta page.draw_oval(r, color=0) r += delta page.draw_rect(r, color=0) r += delta page.draw_quad(r.quad, color=0) r += delta page.draw_polyline((r.tl, r.tr, r.br), color=0) r += delta page.draw_bezier(r.tl, r.tr, r.br, r.bl, color=0) r += delta page.draw_curve(r.tl, r.tr, r.br, color=0) r += delta page.draw_squiggle(r.tl, r.br, color=0) r += delta rects = [p["rect"] for p in page.get_cdrawings()] bboxes = [b[1] for b in page.get_bboxlog()] for i, r in enumerate(rects): assert pymupdf.Rect(r) in pymupdf.Rect(bboxes[i]) def _dict_difference(a, b): """ Verifies that dictionaries "a", "b" * have the same keys and values, except for key "items": * the items list of "a" must be one shorter but otherwise equal the "b" items Returns last item of b["items"]. """ assert a.keys() == b.keys() for k in a.keys(): v1 = a[k] v2 = b[k] if k != "items": assert v1 == v2 else: assert v1 == v2[:-1] rc = v2[-1] return rc def test_drawings3(): doc = pymupdf.open() page1 = doc.new_page() shape1 = page1.new_shape() shape1.draw_line((10, 10), (10, 50)) shape1.draw_line((10, 50), (100, 100)) shape1.finish(closePath=False) shape1.commit() drawings1 = page1.get_drawings()[0] page2 = doc.new_page() shape2 = page2.new_shape() shape2.draw_line((10, 10), (10, 50)) shape2.draw_line((10, 50), (100, 100)) shape2.finish(closePath=True) shape2.commit() drawings2 = page2.get_drawings()[0] assert _dict_difference(drawings1, drawings2) == ("l", (100, 100), (10, 10)) page3 = doc.new_page() shape3 = page3.new_shape() shape3.draw_line((10, 10), (10, 50)) shape3.draw_line((10, 50), (100, 100)) shape3.draw_line((100, 100), (50, 70)) shape3.finish(closePath=False) shape3.commit() drawings3 = page3.get_drawings()[0] page4 = doc.new_page() shape4 = page4.new_shape() shape4.draw_line((10, 10), (10, 50)) shape4.draw_line((10, 50), (100, 100)) shape4.draw_line((100, 100), (50, 70)) shape4.finish(closePath=True) shape4.commit() drawings4 = page4.get_drawings()[0] assert _dict_difference(drawings3, drawings4) == ("l", (50, 70), (10, 10)) def test_2365(): """Draw a filled rectangle on a new page. Then extract the page's vector graphics and confirm that only one path was generated which has all the right properties.""" doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(100, 100, 200, 200) page.draw_rect( rect, color=pymupdf.pdfcolor["black"], fill=pymupdf.pdfcolor["yellow"], width=3 ) paths = page.get_drawings() assert len(paths) == 1 path = paths[0] assert path["type"] == "fs" assert path["fill"] == pymupdf.pdfcolor["yellow"] assert path["fill_opacity"] == 1 assert path["color"] == pymupdf.pdfcolor["black"] assert path["stroke_opacity"] == 1 assert path["width"] == 3 assert path["rect"] == rect def test_2462(): """ Assertion happens, if this code does NOT bring down the interpreter. Background: We previously ignored clips for non-vector-graphics. However, ending a clip does not refer back the object(s) that have been clipped. In order to correctly compute the "scissor" rectangle, we now keep track of the clipped object type. """ doc = pymupdf.open(f"{scriptdir}/resources/test-2462.pdf") page = doc[0] vg = page.get_drawings(extended=True) def test_2556(): """Ensure that incomplete clip paths will be properly ignored.""" doc = pymupdf.open() # new empty PDF page = doc.new_page() # new page # following contains an incomplete clip c = b"q 50 697.6 400 100.0 re W n q 0 0 m W n Q " xref = doc.get_new_xref() # prepare /Contents object for page doc.update_object(xref, "<<>>") # new xref now is a dictionary doc.update_stream(xref, c) # store drawing commands page.set_contents(xref) # give the page this xref as /Contents # following will bring down interpreter if fix not installed assert page.get_drawings(extended=True) def test_3207(): """Example graphics with multiple "close path" commands within same path. The fix translates a close-path commands into an additional line which connects the current point with a preceding "move" target. The example page has 2 paths which each contain 2 close-path commands after 2 normal "line" commands, i.e. 2 command sequences "move-to, line-to, line-to, close-path". This is converted into 3 connected lines, where the last end point is connect to the start point of the first line. So, in the sequence of lines / points (p0, p1), (p2, p3), (p4, p5), (p6, p7), (p8, p9), (p10, p11) point p5 must equal p0, and p11 must equal p6 (for each of the two paths in the example). """ filename = os.path.join(scriptdir, "resources", "test-3207.pdf") doc = pymupdf.open(filename) page = doc[0] paths = page.get_drawings() assert len(paths) == 2 path0 = paths[0] items = path0["items"] assert len(items) == 6 p0 = items[0][1] p5 = items[2][2] p6 = items[3][1] p11 = items[5][2] assert p0 == p5 assert p6 == p11 path1 = paths[1] items = path1["items"] assert len(items) == 6 p0 = items[0][1] p5 = items[2][2] p6 = items[3][1] p11 = items[5][2] assert p0 == p5 assert p6 == p11 def test_3591(): """Confirm correct scaling factor for rotation matrices.""" filename = os.path.join(scriptdir, "resources", "test-3591.pdf") doc = pymupdf.open(filename) page = doc[0] paths = page.get_drawings() for p in paths: assert p["width"] == 15 def test_4954_1(): path_out = os.path.normpath(f'{__file__}/../../tests/test_4954_1.pdf') with pymupdf.open() as document: page = document.new_page(width=200, height=200) shape = page.new_shape() shape.draw_line((0, 0), (1, 1)) shape.finish(color=(0, 0, 0), width=0.1) shape.commit() content = b'q\n0.12 0 0 0.12 0 0 cm\n2 j\n6 w\n100 100 m\n800 100 l\nS\nQ\n' document.update_stream(page.get_contents()[0], content, compress=0) document.save(path_out) with pymupdf.open(path_out) as document: d = document[0].get_drawings()[-1] print(f'{d["lineJoin"]=}') # Expected: 2, Actual: 0.24 assert d['lineJoin'] == 2 def test_4954_2(): path_out = os.path.normpath(f'{__file__}/../../tests/test_4954_2.pdf') with pymupdf.open() as document: page = document.new_page(width=200, height=200) shape = page.new_shape() shape.draw_line((0, 0), (1, 1)) shape.finish(color=(1, 0, 0), width=0.1) shape.commit() content = b'q\n2 0 0 3 0 0 cm\n1 w\n10 10 m\n90 10 l\nS\nQ\n' document.update_stream(page.get_contents()[0], content, compress=0) document.save(path_out) with pymupdf.open(path_out) as document: d = document[0].get_drawings()[-1] print(f'{d["width"]=}') # Expected: 2.0, Actual: 1.0 assert abs(d['width'] - 2.449) < 0.01 ================================================ FILE: tests/test_embeddedfiles.py ================================================ """ Tests for PDF EmbeddedFiles functions. """ import pymupdf def test_embedded1(): doc = pymupdf.open() buffer = b"123456678790qwexcvnmhofbnmfsdg4589754uiofjkb-" doc.embfile_add( "file1", buffer, filename="testfile.txt", ufilename="testfile-u.txt", desc="Description of some sort", ) assert doc.embfile_count() == 1 assert doc.embfile_names() == ["file1"] assert doc.embfile_info(0)["name"] == "file1" doc.embfile_upd(0, filename="new-filename.txt") assert doc.embfile_info(0)["filename"] == "new-filename.txt" assert doc.embfile_get(0) == buffer doc.embfile_del(0) assert doc.embfile_count() == 0 def test_4050(): with pymupdf.open() as document: document.embfile_add('test', b'foobar', desc='some text') d = document.embfile_info('test') print(f'{d=}') # Date is non-trivial to test for. del d['creationDate'] del d['modDate'] assert d == { 'name': 'test', 'collection': 0, 'filename': 'test', 'ufilename': 'test', 'description': 'some text', 'size': 6, 'length': 6, } ================================================ FILE: tests/test_extractimage.py ================================================ """ Extract images from a PDF file, confirm number of images found. """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "joined.pdf") known_image_count = 21 def test_extract_image(): doc = pymupdf.open(filename) image_count = 1 for xref in range(1, doc.xref_length() - 1): if doc.xref_get_key(xref, "Subtype")[1] != "/Image": continue img = doc.extract_image(xref) if isinstance(img, dict): image_count += 1 assert image_count == known_image_count # this number is know about the file def test_2348(): pdf_path = f'{scriptdir}/test_2348.pdf' document = pymupdf.open() page = document.new_page(width=500, height=842) rect = pymupdf.Rect(20, 20, 480, 820) page.insert_image(rect, filename=f'{scriptdir}/resources/nur-ruhig.jpg') page = document.new_page(width=500, height=842) page.insert_image(rect, filename=f'{scriptdir}/resources/img-transparent.png') document.ez_save(pdf_path) document.close() document = pymupdf.open(pdf_path) page = document[0] imlist = page.get_images() image = document.extract_image(imlist[0][0]) jpeg_extension = image['ext'] page = document[1] imlist = page.get_images() image = document.extract_image(imlist[0][0]) png_extension = image['ext'] print(f'jpeg_extension={jpeg_extension!r} png_extension={png_extension!r}') assert jpeg_extension == 'jpeg' assert png_extension == 'png' def test_delete_image(): doc = pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/test_delete_image.pdf')) page = doc[0] xref = page.get_images()[0][0] page.delete_image(xref) ================================================ FILE: tests/test_flake8.py ================================================ import pymupdf import os import subprocess import sys def test_flake8(): ''' Check Python code with flake8. ''' if os.environ.get('PYODIDE_ROOT'): print('test_flake8(): not running on Pyodide - cannot run child processes.') return ignores = ( 'E123', # closing bracket does not match indentation of opening bracket's line 'E124', # closing bracket does not match visual indentation 'E126', # continuation line over-indented for hanging indent 'E127', # continuation line over-indented for visual indent 'E128', # continuation line under-indented for visual indent 'E131', # continuation line unaligned for hanging indent 'E201', # whitespace after '(' 'E203', # whitespace before ':' 'E221', # E221 multiple spaces before operator 'E225', # missing whitespace around operator 'E226', # missing whitespace around arithmetic operator 'E231', # missing whitespace after ',' 'E241', # multiple spaces after ':' 'E251', # unexpected spaces around keyword / parameter equals 'E252', # missing whitespace around parameter equals 'E261', # at least two spaces before inline comment 'E265', # block comment should start with '# ' 'E271', # multiple spaces after keyword 'E272', # multiple spaces before keyword 'E302', # expected 2 blank lines, found 1 'E305', # expected 2 blank lines after class or function definition, found 1 'E306', # expected 1 blank line before a nested definition, found 0 'E402', # module level import not at top of file 'E501', # line too long (80 > 79 characters) 'E701', # multiple statements on one line (colon) 'E741', # ambiguous variable name 'l' 'F541', # f-string is missing placeholders 'W293', # blank line contains whitespace 'W503', # line break before binary operator 'W504', # line break after binary operator 'E731', # do not assign a lambda expression, use a def ) ignores = ','.join(ignores) root = os.path.abspath(f'{__file__}/../..') def run(command): print(f'test_flake8(): Running: {command}') subprocess.run(command, shell=1, check=1) run(f'flake8 --ignore={ignores} --statistics {root}/src/__init__.py {root}/src/utils.py {root}/src/table.py') print(f'test_flake8(): flake8 succeeded.') ================================================ FILE: tests/test_font.py ================================================ """ Tests for the Font class. """ import os import platform import pymupdf import subprocess import textwrap import util def test_font1(): text = "PyMuPDF" font = pymupdf.Font("helv") assert font.name == "Helvetica" tl = font.text_length(text, fontsize=20) cl = font.char_lengths(text, fontsize=20) assert len(text) == len(cl) assert abs(sum(cl) - tl) < pymupdf.EPSILON for i in range(len(cl)): assert cl[i] == font.glyph_advance(ord(text[i])) * 20 font2 = pymupdf.Font(fontbuffer=font.buffer) codepoints1 = font.valid_codepoints() codepoints2 = font2.valid_codepoints() print('') print(f'{len(codepoints1)=}') print(f'{len(codepoints2)=}') if 0: for i, (ucs1, ucs2) in enumerate(zip(codepoints1, codepoints2)): print(f' {i}: {ucs1=} {ucs2=} {"" if ucs2==ucs2 else "*"}') assert font2.valid_codepoints() == font.valid_codepoints() # Also check we can get font's bbox. bbox1 = font.bbox print(f'{bbox1=}') bbox2 = font.this.fz_font_bbox() assert bbox2 == bbox1 def test_font2(): """Old and new length computation must be the same.""" font = pymupdf.Font("helv") text = "PyMuPDF" assert font.text_length(text) == pymupdf.get_text_length(text) def test_fontname(): """Assert a valid PDF fontname.""" doc = pymupdf.open() page = doc.new_page() assert page.insert_font() # assert: a valid fontname works! detected = False # preset indicator try: # fontname check will fail first - don't need a font at all here page.insert_font(fontname="illegal/char", fontfile="unimportant") except ValueError as e: if str(e).startswith("bad fontname chars"): detected = True # illegal fontname detected assert detected def test_2608(): flags = (pymupdf.TEXT_DEHYPHENATE | pymupdf.TEXT_MEDIABOX_CLIP) with pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/2201.00069.pdf')) as doc: page = doc[0] blocks = page.get_text_blocks(flags=flags) text = blocks[10][4] with open(os.path.abspath(f'{__file__}/../../tests/test_2608_out'), 'wb') as f: f.write(text.encode('utf8')) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_2608_expected') path_expected_1_26 = os.path.normpath(f'{__file__}/../../tests/resources/test_2608_expected_1.26') path_expected_1_28 = os.path.normpath(f'{__file__}/../../tests/resources/test_2608_expected_1.28') if pymupdf.mupdf_version_tuple >= (1, 28): path_expected2 = path_expected_1_28 elif pymupdf.mupdf_version_tuple >= (1, 27): path_expected2 = path_expected else: path_expected2 = path_expected_1_26 with open(path_expected2, 'rb') as f: expected = f.read().decode('utf8') # Github windows x32 seems to insert \r characters; maybe something to # do with the Python installation's line endings settings. expected = expected.replace('\r', '') print(f'test_2608(): {text.encode("utf8")=}') print(f'test_2608(): {expected.encode("utf8")=}') assert text == expected def test_fontarchive(): if os.environ.get('PYODIDE_ROOT'): print('test_fontarchive(): not running on Pyodide - we get ValueError: No font code \'notos\' found in pymupdf-fonts..') return import subprocess arch = pymupdf.Archive() css = pymupdf.css_for_pymupdf_font("notos", archive=arch, name="sans-serif") print(css) print(arch.entry_list) assert arch.entry_list == \ [ { 'fmt': 'tree', 'entries': [ 'notosbo', 'notosbi', 'notosit', 'notos' ], 'path': None } ] def test_load_system_font(): trace = list() def font_f(name, bold, italic, needs_exact_metrics): trace.append((name, bold, italic, needs_exact_metrics)) #print(f'test_load_system_font():font_f(): Looking for font: {name=} {bold=} {italic=} {needs_exact_metrics=}.') return None def f_cjk(name, ordering, serif): trace.append((name, ordering, serif)) #print(f'test_load_system_font():f_cjk(): Looking for font: {name=} {ordering=} {serif=}.') return None def f_fallback(script, language, serif, bold, italic): trace.append((script, language, serif, bold, italic)) #print(f'test_load_system_font():f_fallback(): looking for font: {script=} {language=} {serif=} {bold=} {italic=}.') return None pymupdf.mupdf.fz_install_load_system_font_funcs(font_f, f_cjk, f_fallback) f = pymupdf.mupdf.fz_load_system_font("some-font-name", 0, 0, 0) assert trace == [ ('some-font-name', 0, 0, 0), ], f'Incorrect {trace=}.' print(f'test_load_system_font(): {f.m_internal=}') def test_mupdf_subset_fonts2(): path = os.path.abspath(f'{__file__}/../../tests/resources/2.pdf') with pymupdf.open(path) as doc: n = len(doc) pages = [i*2 for i in range(n//2)] print(f'{pages=}.') pymupdf.mupdf.pdf_subset_fonts2(pymupdf._as_pdf_document(doc), pages) def test_3677(): pymupdf.TOOLS.set_subset_fontnames(True) try: path = os.path.abspath(f'{__file__}/../../tests/resources/test_3677.pdf') font_names_expected = [ 'BCDEEE+Aptos', 'BCDFEE+Aptos', 'BCDGEE+Calibri-Light', 'BCDHEE+Calibri-Light', ] font_names = list() with pymupdf.open(path) as document: for page in document: for block in page.get_text('dict')['blocks']: if block['type'] == 0: if 'lines' in block.keys(): for line in block['lines']: for span in line['spans']: font_name=span['font'] print(font_name) font_names.append(font_name) assert font_names == font_names_expected, f'{font_names=}' finally: pymupdf.TOOLS.set_subset_fontnames(False) def test_3933(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3933.pdf') with pymupdf.open(path) as document: page = document[0] print(f'{len(page.get_fonts())=}') expected = { 'BCDEEE+Calibri': 39, 'BCDFEE+SwissReSan-Regu': 53, 'BCDGEE+SwissReSan-Ital': 20, 'BCDHEE+SwissReSan-Bold': 20, 'BCDIEE+SwissReSan-Regu': 53, 'BCDJEE+Calibri': 39, } for xref, _, _, name, _, _ in page.get_fonts(): _, _, _, content = document.extract_font(xref) if content: font = pymupdf.Font(fontname=name, fontbuffer=content) supported_symbols = font.valid_codepoints() print(f'Font {name}: {len(supported_symbols)=}.', flush=1) assert len(supported_symbols) == expected.get(name) def test_3780(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3780.pdf') with pymupdf.open(path) as document: for page_i, page in enumerate(document): for itm in page.get_fonts(): buff=document.extract_font(itm[0])[-1] font=pymupdf.Font(fontbuffer=buff) print(f'{page_i=}: xref {itm[0]} {font.name=} {font.ascender=} {font.descender=}.') if page_i == 0: d = page.get_text('dict') #for n, v in d.items(): # print(f' {n}: {v!r}') for i, block in enumerate(d['blocks']): print(f'block {i}:') if block['type'] != 0: continue for j, line in enumerate(block['lines']): print(f' line {j}:') for k, span in enumerate(line['spans']): print(f' span {k}:') for n, v in span.items(): print(f' {n}: {v!r}') def test_3887(): print(f'{pymupdf.version=}') path = os.path.normpath(f'{__file__}/../../tests/resources/test_3887.pdf') path2 = os.path.normpath(f'{__file__}/../../tests/resources/test_3887.pdf.ez.pdf') with pymupdf.open(path) as document: document.subset_fonts(fallback=False) document.ez_save(path2) with pymupdf.open(path2) as document: text = f"\u0391\u3001\u0392\u3001\u0393\u3001\u0394\u3001\u0395\u3001\u0396\u3001\u0397\u3001\u0398\u3001\u0399\u3001\u039a\u3001\u039b\u3001\u039c\u3001\u039d\u3001\u039e\u3001\u039f\u3001\u03a0\u3001\u03a1\u3001\u03a3\u3001\u03a4\u3001\u03a5\u3001\u03a6\u3001\u03a7\u3001\u03a8\u3001\u03a9\u3002\u03b1\u3001\u03b2\u3001\u03b3\u3001\u03b4\u3001\u03b5\u3001\u03b6\u3001\u03b7\u3001\u03b8\u3001\u03b9\u3001\u03ba\u3001\u03bb\u3001\u03bc\u3001\u03bd\u3001\u03be\u3001\u03bf\u3001\u03c0\u3001\u03c1\u3001\u03c2\u3001\u03c4\u3001\u03c5\u3001\u03c6\u3001\u03c7\u3001\u03c8\u3001\u03c9\u3002" page = document[0] chars = [c for b in page.get_text("rawdict",flags=0)["blocks"] for l in b["lines"] for s in l["spans"] for c in s["chars"]] output = [c["c"] for c in chars] print(f'text:\n {text}') print(f'output:\n {output}') pixmap = page.get_pixmap() path_pixmap = f'{path}.0.png' pixmap.save(path_pixmap) print(f'Have saved to: {path_pixmap=}') assert set(output)==set(text) def test_4457(): if os.environ.get('PYODIDE_ROOT'): print('test_4457(): not running on Pyodide - cannot run child processes.') return print() files = ( ('https://github.com/user-attachments/files/20862923/test_4457_a.pdf', 'test_4457_a.pdf', None, 4), ('https://github.com/user-attachments/files/20862922/test_4457_b.pdf', 'test_4457_b.pdf', None, 9), ) for url, name, size, rms_old_after_max in files: path = util.download(url, name, size) with pymupdf.open(path) as document: page = document[0] pixmap = document[0].get_pixmap() path_pixmap = f'{path}.png' pixmap.save(path_pixmap) print(f'Have created: {path_pixmap=}') text = page.get_text() path_before = f'{path}.before.pdf' path_after = f'{path}.after.pdf' document.ez_save(path_before, garbage=4) print(f'Have created {path_before=}') document.subset_fonts() document.ez_save(path_after, garbage=4) print(f'Have created {path_after=}') with pymupdf.open(path_before) as document: text_before = document[0].get_text() pixmap_before = document[0].get_pixmap() path_pixmap_before = f'{path_before}.png' pixmap_before.save(path_pixmap_before) print(f'Have created: {path_pixmap_before=}') with pymupdf.open(path_after) as document: text_after = document[0].get_text() pixmap_after = document[0].get_pixmap() path_pixmap_after = f'{path_after}.png' pixmap_after.save(path_pixmap_after) print(f'Have created: {path_pixmap_after=}') import gentle_compare rms_before = gentle_compare.pixmaps_rms(pixmap, pixmap_before) rms_after = gentle_compare.pixmaps_rms(pixmap, pixmap_after) print(f'{rms_before=}') print(f'{rms_after=}') # Create .png file showing differences between and . path_pixmap_after_diff = f'{path_after}.diff.png' pixmap_after_diff = gentle_compare.pixmaps_diff(pixmap, pixmap_after) pixmap_after_diff.save(path_pixmap_after_diff) print(f'Have created: {path_pixmap_after_diff}') # Extract text from , and and write to # files so we can show differences with `diff`. path_text = os.path.normpath(f'{__file__}/../../tests/test_4457.txt') path_text_before = f'{path_text}.before.txt' path_text_after = f'{path_text}.after.txt' with open(path_text, 'w', encoding='utf8') as f: f.write(text) with open(path_text_before, 'w', encoding='utf8') as f: f.write(text_before) with open(path_text_after, 'w', encoding='utf8') as f: f.write(text_after) # Can't write text to stdout on Windows because of encoding errors. if platform.system() != 'Windows': print(f'text:\n{textwrap.indent(text, " ")}') print(f'text_before:\n{textwrap.indent(text_before, " ")}') print(f'text_after:\n{textwrap.indent(text_after, " ")}') print(f'{path_text=}') print(f'{path_text_before=}') print(f'{path_text_after=}') command = f'diff -u {path_text} {path_text_before}' print(f'Running: {command}', flush=1) subprocess.run(command, shell=1) command = f'diff -u {path_text} {path_text_after}' print(f'Running: {command}', flush=1) subprocess.run(command, shell=1) assert text_before == text assert rms_before == 0 if pymupdf.mupdf_version_tuple >= (1, 26, 6): assert rms_after == 0 else: # As of 2025-05-20 there are some differences in some characters, # e.g. the non-ascii characters in `Philipp Krahenbuhl`. See # and . assert abs(rms_after - rms_old_after_max) < 2 # Avoid test failure caused by mupdf warnings. wt = pymupdf.TOOLS.mupdf_warnings() print(f'{wt=}') if pymupdf.mupdf_version_tuple < (1, 27): assert wt == 'bogus font ascent/descent values (0 / 0)\n... repeated 5 times...' ================================================ FILE: tests/test_general.py ================================================ # encoding utf-8 """ * Confirm sample doc has no links and no annots. * Confirm proper release of file handles via Document.close() * Confirm properly raising exceptions in document creation """ import fnmatch import io import json import os import pathlib import pickle import platform import pymupdf import re import shlex import shutil import subprocess import sys import sysconfig import textwrap import time import util import gentle_compare scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "001003ED.pdf") Py_GIL_DISABLED = sysconfig.get_config_var('Py_GIL_DISABLED') try: gil_enabled = sys._is_gil_enabled() except AttributeError: gil_enabled = True regex_gil_stderr = None if Py_GIL_DISABLED and gil_enabled: regex_gil_stderr = '.*The global interpreter lock.*' def test_haslinks(): doc = pymupdf.open(filename) assert doc.has_links() == False def test_hasannots(): doc = pymupdf.open(filename) assert doc.has_annots() == False def test_haswidgets(): doc = pymupdf.open(filename) assert doc.is_form_pdf == False def test_isrepaired(): doc = pymupdf.open(filename) assert doc.is_repaired == False pymupdf.TOOLS.mupdf_warnings() def test_isdirty(): doc = pymupdf.open(filename) assert doc.is_dirty == False def test_cansaveincrementally(): doc = pymupdf.open(filename) assert doc.can_save_incrementally() == True def test_iswrapped(): doc = pymupdf.open(filename) page = doc[0] assert page.is_wrapped if (1, 26, 0) <= pymupdf.mupdf_version_tuple < (1, 27): assert pymupdf.TOOLS.mupdf_warnings() == 'bogus font ascent/descent values (0 / 0)' def test_wrapcontents(): doc = pymupdf.open(filename) page = doc[0] page.wrap_contents() xref = page.get_contents()[0] cont = page.read_contents() doc.update_stream(xref, cont) page.set_contents(xref) assert len(page.get_contents()) == 1 page.clean_contents() wt = pymupdf.TOOLS.mupdf_warnings() if (1, 26, 0) <= pymupdf.mupdf_version_tuple < (1, 27): assert wt == 'bogus font ascent/descent values (0 / 0)\nPDF stream Length incorrect' else: assert wt == 'PDF stream Length incorrect' def test_page_clean_contents(): """Assert that page contents cleaning actually is invoked.""" doc = pymupdf.open() page = doc.new_page() # draw two rectangles - will lead to two /Contents objects page.draw_rect((10, 10, 20, 20)) page.draw_rect((20, 20, 30, 30)) assert len(page.get_contents()) == 2 assert page.read_contents().startswith(b"q") == False # clean / consolidate into one /Contents object page.clean_contents() assert len(page.get_contents()) == 1 assert page.read_contents().startswith(b"q") == True def test_annot_clean_contents(): """Assert that annot contents cleaning actually is invoked.""" doc = pymupdf.open() page = doc.new_page() annot = page.add_highlight_annot((10, 10, 20, 20)) # the annotation appearance will not start with command b"q" # invoke appearance stream cleaning and reformatting annot.clean_contents() # appearance stream should now indeed start with command b"q" assert annot._getAP().startswith(b"q") == True def test_config(): assert pymupdf.TOOLS.fitz_config["py-memory"] in (True, False) def test_glyphnames(): name = "INFINITY" infinity = pymupdf.glyph_name_to_unicode(name) assert pymupdf.unicode_to_glyph_name(infinity) == name def test_rgbcodes(): sRGB = 0xFFFFFF assert pymupdf.sRGB_to_pdf(sRGB) == (1, 1, 1) assert pymupdf.sRGB_to_rgb(sRGB) == (255, 255, 255) def test_pdfstring(): pymupdf.get_pdf_now() pymupdf.get_pdf_str("Beijing, chinesisch 北京") pymupdf.get_text_length("Beijing, chinesisch 北京", fontname="china-s") pymupdf.get_pdf_str("Latin characters êßöäü") def test_open_exceptions(): path = os.path.normpath(f'{__file__}/../../tests/resources/001003ED.pdf') doc = pymupdf.open(path, filetype="xps") assert 'PDF' in doc.metadata["format"] doc = pymupdf.open(path, filetype="xxx") assert 'PDF' in doc.metadata["format"] try: pymupdf.open("x.y") except Exception as e: assert repr(e).startswith("FileNotFoundError") else: assert 0 try: pymupdf.open(stream=b"", filetype="pdf") except RuntimeError as e: assert repr(e).startswith("EmptyFileError"), f'{repr(e)=}' else: print(f'{doc.metadata["format"]=}') assert 0 def test_bug1945(): pdf = pymupdf.open(f'{scriptdir}/resources/bug1945.pdf') buffer_ = io.BytesIO() pdf.save(buffer_, clean=True) def test_bug1971(): for _ in range(2): doc = pymupdf.Document(f'{scriptdir}/resources/bug1971.pdf') page = next(doc.pages()) page.get_drawings() doc.close() assert doc.is_closed def test_default_font(): f = pymupdf.Font() assert str(f) == "Font('Noto Serif Regular')" assert repr(f) == "Font('Noto Serif Regular')" def test_add_ink_annot(): import math document = pymupdf.Document() page = document.new_page() line1 = [] line2 = [] for a in range( 0, 360*2, 15): x = a c = 300 + 200 * math.cos( a * math.pi/180) s = 300 + 100 * math.sin( a * math.pi/180) line1.append( (x, c)) line2.append( (x, s)) page.add_ink_annot( [line1, line2]) page.insert_text((100, 72), 'Hello world') page.add_text_annot((200,200), "Some Text") page.get_bboxlog() path = f'{scriptdir}/resources/test_add_ink_annot.pdf' document.save( path) print( f'Have saved to: path={path!r}') def test_techwriter_append(): print(pymupdf.__doc__) doc = pymupdf.open() page = doc.new_page() tw = pymupdf.TextWriter(page.rect) text = "Red rectangle = TextWriter.text_rect, blue circle = .last_point" r = tw.append((100, 100), text) print(f'r={r!r}') tw.write_text(page) page.draw_rect(tw.text_rect, color=pymupdf.pdfcolor["red"]) page.draw_circle(tw.last_point, 2, color=pymupdf.pdfcolor["blue"]) path = f"{scriptdir}/resources/test_techwriter_append.pdf" doc.ez_save(path) print( f'Have saved to: {path}') def test_opacity(): doc = pymupdf.open() page = doc.new_page() annot1 = page.add_circle_annot((50, 50, 100, 100)) annot1.set_colors(fill=(1, 0, 0), stroke=(1, 0, 0)) annot1.set_opacity(2 / 3) annot1.update(blend_mode="Multiply") annot2 = page.add_circle_annot((75, 75, 125, 125)) annot2.set_colors(fill=(0, 0, 1), stroke=(0, 0, 1)) annot2.set_opacity(1 / 3) annot2.update(blend_mode="Multiply") outfile = f'{scriptdir}/resources/opacity.pdf' doc.save(outfile, expand=True, pretty=True) print("saved", outfile) def test_get_text_dict(): import json doc=pymupdf.open(f'{scriptdir}/resources/v110-changes.pdf') page=doc[0] blocks=page.get_text("dict")["blocks"] # Check no opaque types in `blocks`. json.dumps( blocks, indent=4) if (1, 26, 0) <= pymupdf.mupdf_version_tuple < (1, 27): assert pymupdf.TOOLS.mupdf_warnings() == 'bogus font ascent/descent values (0 / 0)' def test_font(): font = pymupdf.Font() print(repr(font)) bbox = font.glyph_bbox( 65) print( f'bbox={bbox!r}') def test_insert_font(): doc=pymupdf.open(f'{scriptdir}/resources/v110-changes.pdf') page = doc[0] i = page.insert_font() print( f'page.insert_font() => {i}') def test_2173(): from pymupdf import IRect, Pixmap, CS_RGB, Colorspace for i in range( 100): #print( f'i={i!r}') image = Pixmap(Colorspace(CS_RGB), IRect(0, 0, 13, 37)) print( 'test_2173() finished') def test_texttrace(): import time document = pymupdf.Document( f'{scriptdir}/resources/joined.pdf') t = time.time() for page in document: tt = page.get_texttrace() t = time.time() - t print( f'test_texttrace(): t={t!r}') # Repeat, this time writing data to file. import json path = f'{scriptdir}/resources/test_texttrace.txt' print( f'test_texttrace(): Writing to: {path}') with open( path, 'w') as f: for i, page in enumerate(document): tt = page.get_texttrace() print( f'page {i} json:\n{json.dumps(tt, indent=" ")}', file=f) def test_2533(): """Assert correct char bbox in page.get_texttrace(). Search for a unique char on page and confirm that page.get_texttrace() returns the same bbox as the search method. """ if not pymupdf.g_use_extra: print('Not running test_2533() because use_extra=0 known to fail') return pymupdf.TOOLS.set_small_glyph_heights(True) try: doc = pymupdf.open(os.path.join(scriptdir, "resources", "test_2533.pdf")) page = doc[0] NEEDLE = "民" ord_NEEDLE = ord(NEEDLE) for span in page.get_texttrace(): for char in span["chars"]: if char[0] == ord_NEEDLE: bbox = pymupdf.Rect(char[3]) break bbox2 = page.search_for(NEEDLE)[0] assert bbox2 == bbox, f'{bbox=} {bbox2=} {bbox2-bbox=}.' finally: pymupdf.TOOLS.set_small_glyph_heights(False) def test_2645(): """Assert same font size calculation in corner cases. """ folder = os.path.join(scriptdir, "resources") files = ("test_2645_1.pdf", "test_2645_2.pdf", "test_2645_3.pdf") for f in files: doc = pymupdf.open(os.path.join(folder, f)) page = doc[0] fontsize0 = page.get_texttrace()[0]["size"] fontsize1 = page.get_text("dict", flags=pymupdf.TEXTFLAGS_TEXT)["blocks"][0]["lines"][ 0 ]["spans"][0]["size"] assert abs(fontsize0 - fontsize1) < 1e-5 def test_2506(): """Ensure expected font size across text writing angles.""" doc = pymupdf.open() page = doc.new_page() point = pymupdf.Point(100, 300) # insertion point fontsize = 11 # fontsize text = "Hello" # text angles = (0, 30, 60, 90, 120) # some angles # write text with different angles for angle in angles: page.insert_text( point, text, fontsize=fontsize, morph=(point, pymupdf.Matrix(angle)) ) # ensure correct fontsize for get_texttrace() - forgiving rounding problems for span in page.get_texttrace(): print(span["dir"]) assert round(span["size"]) == fontsize # ensure correct fontsize for get_text() - forgiving rounding problems for block in page.get_text("dict")["blocks"]: for line in block["lines"]: print(line["dir"]) for span in line["spans"]: print(span["size"]) assert round(span["size"]) == fontsize def test_2108(): doc = pymupdf.open(f'{scriptdir}/resources/test_2108.pdf') page = doc[0] areas = page.search_for("{sig}") rect = areas[0] page.add_redact_annot(rect) page.apply_redactions() text = page.get_text() text_expected = b'Frau\nClaire Dunphy\nTeststra\xc3\x9fe 5\n12345 Stadt\nVertragsnummer: 12345\nSehr geehrte Frau Dunphy,\nText\nMit freundlichen Gr\xc3\xbc\xc3\x9fen\nTestfirma\nVertrag:\n 12345\nAnsprechpartner:\nJay Pritchet\nTelefon:\n123456\nE-Mail:\ntest@test.de\nDatum:\n07.12.2022\n'.decode('utf8') if 1: # Verbose info. print(f'test_2108(): text is:\n{text}') print(f'') print(f'test_2108(): repr(text) is:\n{text!r}') print(f'') print(f'test_2108(): repr(text.encode("utf8")) is:\n{text.encode("utf8")!r}') print(f'') print(f'test_2108(): text_expected is:\n{text_expected}') print(f'') print(f'test_2108(): repr(text_expected) is:\n{text_expected!r}') print(f'') print(f'test_2108(): repr(text_expected.encode("utf8")) is:\n{text_expected.encode("utf8")!r}') ok1 = (text == text_expected) ok2 = (text.encode("utf8") == text_expected.encode("utf8")) ok3 = (repr(text.encode("utf8")) == repr(text_expected.encode("utf8"))) print(f'') print(f'ok1={ok1}') print(f'ok2={ok2}') print(f'ok3={ok3}') print(f'') print(f'{pymupdf.mupdf_version_tuple=}') print('Asserting text==text_expected') assert text == text_expected def test_2238(): filepath = f'{scriptdir}/resources/test2238.pdf' doc = pymupdf.open(filepath) wt = pymupdf.TOOLS.mupdf_warnings() wt_expected = '' wt_expected += 'garbage bytes before version marker\n' wt_expected += 'syntax error: expected \'obj\' keyword (6 0 ?)\n' wt_expected += 'trying to repair broken xref\n' wt_expected += 'repairing PDF document' assert wt == wt_expected, f'{wt=}' first_page = doc.load_page(0).get_text('text', clip=pymupdf.INFINITE_RECT()) last_page = doc.load_page(-1).get_text('text', clip=pymupdf.INFINITE_RECT()) print(f'first_page={first_page!r}') print(f'last_page={last_page!r}') assert first_page == 'Hello World\n' assert last_page == 'Hello World\n' first_page = doc.load_page(0).get_text('text') last_page = doc.load_page(-1).get_text('text') print(f'first_page={first_page!r}') print(f'last_page={last_page!r}') assert first_page == 'Hello World\n' assert last_page == 'Hello World\n' def test_2093(): if platform.python_implementation() == 'GraalVM': print(f'test_2093(): Not running because slow on GraalVM.') return doc = pymupdf.open(f'{scriptdir}/resources/test2093.pdf') def average_color(page): pixmap = page.get_pixmap() p_average = [0] * pixmap.n for y in range(pixmap.height): for x in range(pixmap.width): p = pixmap.pixel(x, y) for i in range(pixmap.n): p_average[i] += p[i] for i in range(pixmap.n): p_average[i] /= (pixmap.height * pixmap.width) return p_average page = doc.load_page(0) pixel_average_before = average_color(page) rx=135.123 ry=123.56878 rw=69.8409 rh=9.46397 x0 = rx y0 = ry x1 = rx + rw y1 = ry + rh rect = pymupdf.Rect(x0, y0, x1, y1) font = pymupdf.Font("Helvetica") fill_color=(0,0,0) page.add_redact_annot( quad=rect, #text="null", fontname=font.name, fontsize=12, align=pymupdf.TEXT_ALIGN_CENTER, fill=fill_color, text_color=(1,1,1), ) page.apply_redactions() pixel_average_after = average_color(page) print(f'pixel_average_before={pixel_average_before!r}') print(f'pixel_average_after={pixel_average_after!r}') # Before this bug was fixed (MuPDF-1.22): # pixel_average_before=[130.864323120088, 115.23577810900859, 92.9268559996174] # pixel_average_after=[138.68844553555772, 123.05687162237561, 100.74275056194105] # After fix: # pixel_average_before=[130.864323120088, 115.23577810900859, 92.9268559996174] # pixel_average_after=[130.8889209934799, 115.25722751837269, 92.94327384463327] # for i in range(len(pixel_average_before)): diff = pixel_average_before[i] - pixel_average_after[i] assert abs(diff) < 0.1 out = f'{scriptdir}/resources/test2093-out.pdf' doc.save(out) print(f'Have written to: {out}') def test_2182(): print(f'test_2182() started') doc = pymupdf.open(f'{scriptdir}/resources/test2182.pdf') page = doc[0] for annot in page.annots(): print(annot) print(f'test_2182() finished') def test_2246(): """ Test / confirm identical text positions generated by * page.insert_text() versus * TextWriter.write_text() ... under varying situations as follows: 1. MediaBox does not start at (0, 0) 2. CropBox origin is different from that of MediaBox 3. Check for all 4 possible page rotations The test writes the same text at the same positions using `page.insert_text()`, respectively `TextWriter.write_text()`. Then extracts the text spans and confirms that they all occupy the same bbox. This ensures coincidence of text positions of page.of insert_text() (which is assumed correct) and TextWriter.write_text(). """ def bbox_count(rot): """Make a page and insert identical text via different methods. Desired page rotation is a parameter. MediaBox and CropBox are chosen to be "awkward": MediaBox does not start at (0,0) and CropBox is a true subset of MediaBox. """ # bboxes of spans on page: same text positions are represented by ONE bbox bboxes = set() doc = pymupdf.open() # prepare a page with desired MediaBox / CropBox peculiarities mediabox = pymupdf.paper_rect("letter") page = doc.new_page(width=mediabox.width, height=mediabox.height) xref = page.xref newmbox = list(map(float, doc.xref_get_key(xref, "MediaBox")[1][1:-1].split())) newmbox = pymupdf.Rect(newmbox) mbox = newmbox + (10, 20, 10, 20) cbox = mbox + (10, 10, -10, -10) doc.xref_set_key(xref, "MediaBox", "[%g %g %g %g]" % tuple(mbox)) doc.xref_set_key(xref, "CrobBox", "[%g %g %g %g]" % tuple(cbox)) # set page to desired rotation page.set_rotation(rot) page.insert_text((50, 50), "Text inserted at (50,50)") tw = pymupdf.TextWriter(page.rect) tw.append((50, 50), "Text inserted at (50,50)") tw.write_text(page) blocks = page.get_text("dict")["blocks"] for b in blocks: for l in b["lines"]: for s in l["spans"]: # store bbox rounded to 3 decimal places bboxes.add(pymupdf.Rect(pymupdf.JM_TUPLE3(s["bbox"]))) return len(bboxes) # should be 1! # the following tests must all pass assert bbox_count(0) == 1 assert bbox_count(90) == 1 assert bbox_count(180) == 1 assert bbox_count(270) == 1 def test_2430(): """Confirm that multiple font property checks will not destroy Py_None.""" font = pymupdf.Font("helv") for i in range(1000): _ = font.flags def test_2692(): document = pymupdf.Document(f'{scriptdir}/resources/2.pdf') for page in document: pix = page.get_pixmap(clip=pymupdf.Rect(0,0,10,10)) dl = page.get_displaylist(annots=True) pix = dl.get_pixmap( matrix=pymupdf.Identity, colorspace=pymupdf.csRGB, alpha=False, clip=pymupdf.Rect(0,0,10,10), ) pix = dl.get_pixmap( matrix=pymupdf.Identity, #colorspace=pymupdf.csRGB, alpha=False, clip=pymupdf.Rect(0,0,10,10), ) def test_2596(): """Confirm correctly abandoning cache when reloading a page.""" if platform.python_implementation() == 'GraalVM': print(f'test_2596(): not running on Graal.') return doc = pymupdf.Document(f"{scriptdir}/resources/test_2596.pdf") page = doc[0] pix0 = page.get_pixmap() # render the page _ = doc.tobytes(garbage=3) # save with garbage collection # Note this will invalidate cache content for this page. # Reloading the page now empties the cache, so rendering # will deliver the same pixmap page = doc.reload_page(page) pix1 = page.get_pixmap() assert pix1.samples == pix0.samples if pymupdf.mupdf_version_tuple < (1, 26, 6): wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'too many indirections (possible indirection cycle involving 24 0 R)' def test_2730(): """Ensure identical output across text extractions.""" doc = pymupdf.open(f"{scriptdir}/resources/test_2730.pdf") page = doc[0] s1 = set(page.get_text()) # plain text extraction s2 = set(page.get_text(sort=True)) # uses "blocks" extraction s3 = set(page.get_textbox(page.rect)) assert s1 == s2 assert s1 == s3 def test_2553(): """Ensure identical output across text extractions.""" verbose = 0 doc = pymupdf.open(f"{scriptdir}/resources/test_2553.pdf") page = doc[0] # extract plain text, build set of all characters list1 = page.get_text() set1 = set(list1) # extract text blocks, build set of all characters list2 = page.get_text(sort=True) # internally uses "blocks" set2 = set(list2) # extract textbox content, build set of all characters list3 = page.get_textbox(page.rect) set3 = set(list3) def show(l): ret = f'len={len(l)}\n' for c in l: cc = ord(c) if (cc >= 32 and cc < 127) or c == '\n': ret += c else: ret += f' [0x{hex(cc)}]' return ret if verbose: print(f'list1:\n{show(list1)}') print(f'list2:\n{show(list2)}') print(f'list3:\n{show(list3)}') # all sets must be equal assert set1 == set2 assert set1 == set3 # With mupdf later than 1.23.4, this special page contains no invalid # Unicodes. # print(f'Checking no occurrence of 0xFFFD, {pymupdf.mupdf_version_tuple=}.') assert chr(0xFFFD) not in set1 def test_2553_2(): doc = pymupdf.open(f"{scriptdir}/resources/test_2553-2.pdf") page = doc[0] # extract plain text, ensure that there are no 0xFFFD characters text = page.get_text() assert chr(0xfffd) not in text def test_2635(): """Rendering a page before and after cleaning it should yield the same pixmap.""" doc = pymupdf.open(f"{scriptdir}/resources/test_2635.pdf") page = doc[0] pix1 = page.get_pixmap() # pixmap before cleaning page.clean_contents() # clean page pix2 = page.get_pixmap() # pixmap after cleaning assert pix1.samples == pix2.samples # assert equality def test_resolve_names(): """Test PDF name resolution.""" # guard against wrong PyMuPDF architecture version if not hasattr(pymupdf.Document, "resolve_names"): print("PyMuPDF version does not support resolving PDF names") return pickle_in = open(f"{scriptdir}/resources/cython.pickle", "rb") old_names = pickle.load(pickle_in) doc = pymupdf.open(f"{scriptdir}/resources/cython.pdf") new_names = doc.resolve_names() assert new_names == old_names def test_2777(): document = pymupdf.Document() page = document.new_page() print(page.mediabox.width) def test_2710(): doc = pymupdf.open(f'{scriptdir}/resources/test_2710.pdf') page = doc.load_page(0) print(f'test_2710(): {page.cropbox=}') print(f'test_2710(): {page.mediabox=}') print(f'test_2710(): {page.rect=}') def numbers_approx_eq(a, b): return abs(a-b) < 0.001 def points_approx_eq(a, b): return numbers_approx_eq(a.x, b.x) and numbers_approx_eq(a.y, b.y) def rects_approx_eq(a, b): return points_approx_eq(a.bottom_left, b.bottom_left) and points_approx_eq(a.top_right, b.top_right) def assert_rects_approx_eq(a, b): assert rects_approx_eq(a, b), f'Not nearly identical: {a=} {b=}' blocks = page.get_text('blocks') print(f'test_2710(): {blocks=}') assert len(blocks) == 2 block = blocks[1] rect = pymupdf.Rect(block[:4]) text = block[4] print(f'test_2710(): {rect=}') print(f'test_2710(): {text=}') assert text == 'Text at left page border\n' assert_rects_approx_eq(page.cropbox, pymupdf.Rect(30.0, 30.0, 565.3200073242188, 811.9199829101562)) assert_rects_approx_eq(page.mediabox, pymupdf.Rect(0.0, 0.0, 595.3200073242188, 841.9199829101562)) print(f'test_2710(): {pymupdf.mupdf_version_tuple=}') # 2023-11-05: Currently broken in mupdf master. print(f'test_2710(): Not Checking page.rect and rect.') wt = pymupdf.TOOLS.mupdf_warnings() assert wt == ( "syntax error: cannot find ExtGState resource 'GS7'\n" "syntax error: cannot find ExtGState resource 'GS8'\n" "encountered syntax errors; page may not be correct" ) def test_2736(): """Check handling of CropBox changes vis-a-vis a MediaBox with negative coordinates.""" doc = pymupdf.open() page = doc.new_page() # fake a MediaBox for demo purposes doc.xref_set_key(page.xref, "MediaBox", "[-30 -20 595 842]") assert page.cropbox == pymupdf.Rect(-30, 0, 595, 862) assert page.rect == pymupdf.Rect(0, 0, 625, 862) # change the CropBox: shift by (10, 10) in both dimensions. Please note: # To achieve this, 10 must be subtracted from 862! yo must never be negative! page.set_cropbox(pymupdf.Rect(-20, 0, 595, 852)) # get CropBox from the page definition assert doc.xref_get_key(page.xref, "CropBox")[1] == "[-20 -10 595 842]" assert page.rect == pymupdf.Rect(0, 0, 615, 852) error = False text = "" try: # check error detection page.set_cropbox((-35, -10, 595, 842)) except Exception as e: text = str(e) error = True assert error == True assert text == "CropBox not in MediaBox" def test_subset_fonts(): if os.environ.get('PYODIDE_ROOT'): print('test_subset_fonts(): not running on Pyodide - ValueError: No font code \'ubuntu\' found in pymupdf-fonts.') return """Confirm subset_fonts is working.""" if not hasattr(pymupdf, "mupdf"): print("Not testing 'test_subset_fonts' in classic.") return text = "Just some arbitrary text." arch = pymupdf.Archive() css = pymupdf.css_for_pymupdf_font("ubuntu", archive=arch) css += "* {font-family: ubuntu;}" doc = pymupdf.open() page = doc.new_page() page.insert_htmlbox(page.rect, text, css=css, archive=arch) doc.subset_fonts(verbose=True) found = False for xref in range(1, doc.xref_length()): if "+Ubuntu#20Regular" in doc.xref_object(xref): found = True break assert found is True def test_2957_1(): """Text following a redaction must not change coordinates.""" # test file with redactions doc = pymupdf.open(os.path.join(scriptdir, "resources", "test_2957_1.pdf")) page = doc[0] # search for string that must not move by redactions rects0 = page.search_for("6e9f73dfb4384a2b8af6ebba") # sort rectangles vertically rects0 = sorted(rects0, key=lambda r: r.y1) assert len(rects0) == 2 # must be 2 redactions page.apply_redactions() # reload page to finalize updates page = doc.reload_page(page) # the two string must retain their positions (except rounding errors) rects1 = page.search_for("6e9f73dfb4384a2b8af6ebba") rects1 = sorted(rects1, key=lambda r: r.y1) assert page.first_annot is None # make sure annotations have disappeared for i in range(2): r0 = rects0[i].irect # take rounded rects r1 = rects1[i].irect assert r0 == r1 def test_2957_2(): """Redacted text must not change positions of remaining text.""" doc = pymupdf.open(os.path.join(scriptdir, "resources", "test_2957_2.pdf")) page = doc[0] words0 = page.get_text("words") # all words before redacting page.apply_redactions() # remove/redact the word "longer" words1 = page.get_text("words") # extract words again assert len(words1) == len(words0) - 1 # must be one word less assert words0[3][4] == "longer" # just confirm test file is correct one del words0[3] # remove the redacted word from first list for i in range(len(words1)): # compare words w1 = words1[i] # word after redaction bbox1 = pymupdf.Rect(w1[:4]).irect # its IRect coordinates w0 = words0[i] # word before redaction bbox0 = pymupdf.Rect(w0[:4]).irect # its IRect coordinates assert bbox0 == bbox1 # must be same coordinates def test_707560(): """https://bugs.ghostscript.com/show_bug.cgi?id=707560 Ensure that redactions also remove characters with an empty width bbox. """ # Make text that will contain characters with an empty bbox. greetings = ( "Hello, World!", # english "Hallo, Welt!", # german "سلام دنیا!", # persian "வணக்கம், உலகம்!", # tamil "สวัสดีชาวโลก!", # thai "Привіт Світ!", # ucranian "שלום עולם!", # hebrew "ওহে বিশ্ব!", # bengali "你好世界！", # chinese "こんにちは世界！", # japanese "안녕하세요, 월드!", # korean "नमस्कार, विश्व !", # sanskrit "हैलो वर्ल्ड!", # hindi ) text = " ... ".join([g for g in greetings]) where = (50, 50, 400, 500) story = pymupdf.Story(text) bio = io.BytesIO() writer = pymupdf.DocumentWriter(bio) more = True while more: dev = writer.begin_page(pymupdf.paper_rect("a4")) more, _ = story.place(where) story.draw(dev) writer.end_page() writer.close() doc = pymupdf.open("pdf", bio) page = doc[0] text = page.get_text() assert text, "Unexpected: test page has no text." page.add_redact_annot(page.rect) page.apply_redactions() assert not page.get_text(), "Unexpected: text not fully redacted." def test_3070(): with pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/test_3070.pdf')) as pdf: links = pdf[0].get_links() links[0]['uri'] = "https://www.ddg.gg" pdf[0].update_link(links[0]) pdf.save(os.path.abspath(f'{__file__}/../../tests/test_3070_out.pdf')) def test_bboxlog_2885(): doc = pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/test_2885.pdf')) page=doc[0] bbl = page.get_bboxlog() wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 28): assert wt == '' else: assert wt == 'invalid marked content and clip nesting' bbl = page.get_bboxlog(layers=True) wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 28): assert wt == '' else: assert wt == 'invalid marked content and clip nesting' def test_3081(): ''' Check Document.close() closes file handles, even if a Page instance exists. ''' path1 = os.path.abspath(f'{__file__}/../../tests/resources/1.pdf') path2 = os.path.abspath(f'{__file__}/../../tests/test_3081-2.pdf') import shutil import sys import traceback shutil.copy2(path1, path2) # Find next two available fds. next_fd_1 = os.open(path2, os.O_RDONLY) next_fd_2 = os.open(path2, os.O_RDONLY) os.close(next_fd_1) os.close(next_fd_2) def next_fd(): fd = os.open(path2, os.O_RDONLY) os.close(fd) return fd fd1 = next_fd() document = pymupdf.open(path2) page = document[0] fd2 = next_fd() document.close() assert document.this is None assert page.this is None try: document.page_count() except Exception as e: print(f'Received expected exception: {e}') #traceback.print_exc(file=sys.stdout) assert str(e) == 'document closed' else: assert 0, 'Did not receive expected exception.' fd3 = next_fd() try: page.bound() except Exception as e: print(f'Received expected exception: {e}') #traceback.print_exc(file=sys.stdout) assert str(e) == 'page is None' else: assert 0, 'Did not receive expected exception.' page = None fd4 = next_fd() print(f'{next_fd_1=} {next_fd_2=}') print(f'{fd1=} {fd2=} {fd3=} {fd4=}') print(f'{document=}') assert fd1 == next_fd_1 assert fd2 == next_fd_2 # Checks document only uses one fd. assert fd3 == next_fd_1 # Checks no leaked fds after document close. assert fd4 == next_fd_1 # Checks no leaked fds after failed page access. def test_xml(): path = os.path.abspath(f'{__file__}/../../tests/resources/2.pdf') with pymupdf.open(path) as document: document.get_xml_metadata() def test_3112_set_xml_metadata(): document = pymupdf.Document() document.set_xml_metadata('hello world') def test_archive_3126(): p = os.path.abspath(f'{__file__}/../../tests/resources') p = pathlib.Path(p) archive = pymupdf.Archive(p) def test_3140(): css2 = '' path = os.path.abspath(f'{__file__}/../../tests/resources/2.pdf') oldfile = os.path.abspath(f'{__file__}/../../tests/test_3140_old.pdf') newfile = os.path.abspath(f'{__file__}/../../tests/test_3140_new.pdf') import shutil shutil.copy2(path, oldfile) def next_fd(): fd = os.open(path, os.O_RDONLY) os.close(fd) return fd fd1 = next_fd() with pymupdf.open(oldfile) as doc: # open document page = doc[0] rect = pymupdf.Rect(130, 400, 430, 600) CELLS = pymupdf.make_table(rect, cols=3, rows=5) shape = page.new_shape() # create Shape for i in range(5): for j in range(3): qtext = "" + "Ques #" + str(i*3+j+1) + ": " + "" # codespell:ignore atext = "" + "Ans:" + "" # codespell:ignore qtext = qtext + '
' + atext shape.draw_rect(CELLS[i][j]) # draw rectangle page.insert_htmlbox(CELLS[i][j], qtext, css=css2, scale_low=0) shape.finish(width=2.5, color=pymupdf.pdfcolor["blue"], ) shape.commit() # write all stuff to the page doc.subset_fonts() doc.ez_save(newfile) fd2 = next_fd() assert fd2 == fd1, f'{fd1=} {fd2=}' os.remove(oldfile) def test_cli(): if os.environ.get('PYODIDE_ROOT'): print('test_cli(): not running on Pyodide - cannot run child processes.') return import subprocess subprocess.run(f'pymupdf -h', shell=1, check=1) def check_lines(expected_regexes, actual): ''' Checks lines in match regexes in . ''' print(f'### check_lines():', flush=1) def str_to_list(s): if s is None: return list() if isinstance(s, str): return s.split('\n') if s else list() return s expected_regexes = str_to_list(expected_regexes) actual = str_to_list(actual) if expected_regexes and expected_regexes[-1]: expected_regexes.append('') # Always expect a trailing empty line. # Remove `None` regexes and make all regexes match entire lines. expected_regexes = [f'^{i}$' for i in expected_regexes if i is not None] print(f'expected_regexes ({len(expected_regexes)}):') for i in expected_regexes: print(f' {i!r}') print(f'actual ({len(actual)}):') for i in actual: print(f' {i!r}') i_expected = 0 i_actual = 0 while 1: if i_expected == len(expected_regexes) and i_actual == len(actual): break print(f'expected {i_expected+1}/{len(expected_regexes)}') print(f'actual {i_actual+1}/{len(actual)}') assert i_expected < len(expected_regexes) and i_actual < len(actual) expected_regex_line = expected_regexes[i_expected] actual_line = actual[i_actual] if expected_regex_line is None: i_expected += 1 continue print(f' expected_regex: {expected_regex_line!r}', flush=1) print(f' actual: {actual!r}', flush=1) match = re.match(expected_regex_line, actual_line) print(f' {match=}') assert match i_expected += 1 i_actual += 1 assert len(expected_regexes) == len(actual), \ f'expected/actual lines mismatch: {len(expected_regexes)=} {len(actual)=}.' def test_cli_out(): ''' Check redirection of messages and log diagnostics with environment variables PYMUPDF_LOG and PYMUPDF_MESSAGE. ''' if os.environ.get('PYODIDE_ROOT'): print('test_cli_out(): not running on Pyodide - cannot run child processes.') return import platform import re import subprocess import pipcl log_prefix = None if os.environ.get('PYMUPDF_USE_EXTRA') == '0': log_prefix = f'.+Using non-default setting from PYMUPDF_USE_EXTRA: \'0\'' pipcl.show_system() def check( expect_out, expect_err, message=None, log=None, ): ''' Sets PYMUPDF_MESSAGE to `message` and PYMUPDF_LOG to `log`, runs `pymupdf internal`, and checks lines stdout and stderr match regexes in `expect_out` and `expect_err`. Note that we enclose regexes in `^...$`. ''' env = dict() if log: env['PYMUPDF_LOG'] = log if message: env['PYMUPDF_MESSAGE'] = message command = 'pymupdf internal' print(f'Running: {command}', flush=1) if env: print(f'with:') for key in sorted(env.keys()): print(f' {key}={shlex.quote(env[key])}') env = os.environ | env cp = subprocess.run(command, shell=1, check=1, capture_output=1, env=env, text=True) check_lines(expect_out, cp.stdout) check_lines(expect_err, cp.stderr) print(f'test_cli_out(): {Py_GIL_DISABLED=}') print(f'test_cli_out(): {gil_enabled=}') print(f'Checking default, all output to stdout.') regex_gil_stderr = None if Py_GIL_DISABLED and gil_enabled: regex_gil_stderr = '.*The global interpreter lock.*' check( [ log_prefix, 'This is from PyMuPDF message[(][)][.]', '.+This is from PyMuPDF log[(][)].', ], regex_gil_stderr, ) # if platform.system() != 'Windows': print(f'Checking redirection of everything to /dev/null.') check('', regex_gil_stderr, 'path:/dev/null', 'path:/dev/null') # print(f'Checking redirection to files.') path_out = os.path.abspath(f'{__file__}/../../tests/test_cli_out.out') path_err = os.path.abspath(f'{__file__}/../../tests/test_cli_out.err') check('', regex_gil_stderr, f'path:{path_out}', f'path:{path_err}') def read(path): with open(path) as f: return f.read() out = read(path_out) err = read(path_err) check_lines(['This is from PyMuPDF message[(][)][.]'], out) check_lines([log_prefix, '.+This is from PyMuPDF log[(][)][.]'], err) # print(f'Checking redirection to fds.') check( [ 'This is from PyMuPDF message[(][)][.]', ], [ regex_gil_stderr, log_prefix, '.+This is from PyMuPDF log[(][)].', ], 'fd:1', 'fd:2', ) def test_use_python_logging(): ''' Checks pymupdf.use_python_logging(). ''' if os.environ.get('PYODIDE_ROOT'): print('test_cli(): not running on Pyodide - cannot run child processes.') return log_prefix = None if os.environ.get('PYMUPDF_USE_EXTRA') == '0': log_prefix = f'.+Using non-default setting from PYMUPDF_USE_EXTRA: \'0\'' if os.path.basename(__file__).startswith(f'test_fitz_'): # Do nothing, because command `pymupdf` outputs diagnostics containing # `pymupdf` which are not renamed to `fitz`, which breaks our checking. print(f'Not testing with fitz alias.') return def check( code, regexes_stdout, regexes_stderr, env = None, ): code = textwrap.dedent(code) path = os.path.abspath(f'{__file__}/../../tests/resources_test_logging.py') with open(path, 'w') as f: f.write(code) command = f'{sys.executable} {path}' if env: print(f'{env=}.') env = os.environ | env print(f'Running: {command}', flush=1) try: cp = subprocess.run(command, shell=1, check=1, capture_output=1, text=True, env=env) except Exception as e: print(f'Command failed: {command}.', flush=1) print(f'Stdout\n{textwrap.indent(e.stdout, " ")}', flush=1) print(f'Stderr\n{textwrap.indent(e.stderr, " ")}', flush=1) raise check_lines(regexes_stdout, cp.stdout) check_lines(regexes_stderr, cp.stderr) print(f'## Basic use of `logging` sends output to stderr instead of default stdout.') check( ''' import pymupdf pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') pymupdf.set_messages(pylogging=1) pymupdf.set_log(pylogging=1) pymupdf.message('this is pymupdf.message() 2') pymupdf.log('this is pymupdf.log() 2') ''', [ log_prefix, 'this is pymupdf.message[(][)]', '.+this is pymupdf.log[(][)]', ], [ regex_gil_stderr, 'this is pymupdf.message[(][)] 2', '.+this is pymupdf.log[(][)] 2', ], ) print(f'## Calling logging.basicConfig() makes logging output contain : prefixes.') check( ''' import pymupdf import logging logging.basicConfig() pymupdf.set_messages(pylogging=1) pymupdf.set_log(pylogging=1) pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') ''', [ log_prefix, ], [ regex_gil_stderr, 'WARNING:pymupdf:this is pymupdf.message[(][)]', 'WARNING:pymupdf:.+this is pymupdf.log[(][)]', ], ) print(f'## Setting PYMUPDF_USE_PYTHON_LOGGING=1 makes PyMuPDF use logging on startup.') check( ''' import pymupdf pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') ''', '', [ regex_gil_stderr, log_prefix, 'this is pymupdf.message[(][)]', '.+this is pymupdf.log[(][)]', ], env = dict( PYMUPDF_MESSAGE='logging:', PYMUPDF_LOG='logging:', ), ) print(f'## Pass explicit logger to pymupdf.use_python_logging() with logging.basicConfig().') check( ''' import pymupdf import logging logging.basicConfig() logger = logging.getLogger('foo') pymupdf.set_messages(pylogging_logger=logger, pylogging_level=logging.WARNING) pymupdf.set_log(pylogging_logger=logger, pylogging_level=logging.ERROR) pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') ''', [ log_prefix, ], [ regex_gil_stderr, log_prefix, 'WARNING:foo:this is pymupdf.message[(][)]', 'ERROR:foo:.+this is pymupdf.log[(][)]', ], ) print(f'## Check pymupdf.set_messages() pylogging_level args.') check( ''' import pymupdf import logging logging.basicConfig(level=logging.DEBUG) logger = logging.getLogger('pymupdf') pymupdf.set_messages(pylogging_level=logging.CRITICAL) pymupdf.set_log(pylogging_level=logging.INFO) pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') ''', [ log_prefix, ], [ regex_gil_stderr, log_prefix, 'CRITICAL:pymupdf:this is pymupdf.message[(][)]', 'INFO:pymupdf:.+this is pymupdf.log[(][)]', ], ) print(f'## Check messages() with sys.stdout=None.') check( ''' import sys sys.stdout = None import pymupdf pymupdf.message('this is pymupdf.message()') pymupdf.log('this is pymupdf.log()') ''', [], [ regex_gil_stderr, ], ) def relpath(path, start=None): ''' A 'safe' alternative to os.path.relpath(). Avoids an exception on Windows if the drive needs to change - in this case we use os.path.abspath(). ''' try: return os.path.relpath(path, start) except ValueError: # os.path.relpath() fails if trying to change drives. assert platform.system() == 'Windows' return os.path.abspath(path) def test_open(): import re import textwrap import traceback resources = relpath(os.path.abspath(f'{__file__}/../../tests/resources')) # We convert all strings to use `/` instead of os.sep, which avoids # problems with regex's on windows. resources = resources.replace(os.sep, '/') def check(filename=None, stream=None, filetype=None, exception=None): ''' Checks we receive expected exception if specified. ''' if isinstance(filename, str): filename = filename.replace(os.sep, '/') if exception: etype, eregex = exception if isinstance(eregex, (tuple, list)): # Treat as sequence of regexes to look for. eregex = '.*'.join(eregex) try: pymupdf.open(filename=filename, stream=stream, filetype=filetype) except etype as e: text = traceback.format_exc(limit=0) text = text.replace(os.sep, '/') text = textwrap.indent(text, ' ', lambda line: 1) assert re.search(eregex, text, re.DOTALL), \ f'Incorrect exception text, expected {eregex=}, received:\n{text}' print(f'Received expected exception for {filename=} {stream=} {filetype=}:\n{text}') except Exception as e: assert 0, \ f'Incorrect exception, expected {etype}, received {type(e)=}.' else: assert 0, f'Did not received exception, expected {etype=}. {filename=} {stream=} {filetype=} {exception=}' else: document = pymupdf.open(filename=filename, stream=stream, filetype=filetype) return document check(f'{resources}/1.pdf') check(f'{resources}/Bezier.epub') path = 1234 etype = TypeError eregex = re.escape(f'bad filename: type(filename)= filename={path}.') check(path, exception=(etype, eregex)) path = 'test_open-this-file-will-not-exist' etype = pymupdf.FileNotFoundError eregex = f'no such file: \'{path}\'' check(path, exception=(etype, eregex)) path = resources etype = pymupdf.FileDataError eregex = re.escape(f'\'{path}\' is no file') check(path, exception=(etype, eregex)) path = relpath(os.path.abspath(f'{resources}/../test_open_empty')) path = path.replace(os.sep, '/') with open(path, 'w') as f: pass etype = pymupdf.EmptyFileError eregex = re.escape(f'Cannot open empty file: filename={path!r}.') check(path, exception=(etype, eregex)) path = f'{resources}/1.pdf' filetype = 'xps' etype = pymupdf.FileDataError # 2023-12-12: On OpenBSD, for some reason the SWIG catch code only catches # the exception as FzErrorBase. etype2 = 'FzErrorBase' if platform.system() == 'OpenBSD' else 'FzErrorFormat' eregex = ( # With a sysinstall with separate MuPDF install, we get # `mupdf.FzErrorFormat` instead of `pymupdf.mupdf.FzErrorFormat`. So # we just search for the former. re.escape(f'mupdf.{etype2}: code=7: cannot recognize zip archive'), re.escape(f'pymupdf.FileDataError: Failed to open file {path!r} as type {filetype!r}.'), ) check(path, filetype=filetype, exception=None) path = f'{resources}/chinese-tables.pickle' etype = pymupdf.FileDataError etype2 = 'FzErrorBase' if platform.system() == 'OpenBSD' else 'FzErrorUnsupported' etext = ( re.escape(f'mupdf.{etype2}: code=6: cannot find document handler for file: {path}'), re.escape(f'pymupdf.FileDataError: Failed to open file {path!r}.'), ) check(path, exception=(etype, etext)) stream = 123 etype = TypeError etext = re.escape('bad stream: type(stream)=.') check(stream=stream, exception=(etype, etext)) check(stream=b'', exception=(pymupdf.EmptyFileError, re.escape('Cannot open empty stream.'))) def test_open2(): ''' Checks behaviour of fz_open_document() and fz_open_document_with_stream() with different filenames/magic values. ''' if os.environ.get('PYODIDE_ROOT'): print('test_open2(): not running on Pyodide - cannot run child processes.') return if platform.system() == 'Windows': print(f'test_open2(): not running on Windows because `git ls-files` known fail on Github Windows runners.') return root = os.path.normpath(f'{__file__}/../..') root = relpath(root) # Find tests/resources/test_open2.* input files/streams. We calculate # paths relative to the PyMuPDF checkout directory , to allow use # of tests/resources/test_open2_expected.json regardless of the actual # checkout directory. print() import pipcl paths = pipcl.git_items(f'{root}/tests/resources') paths = fnmatch.filter(paths, f'test_open2.*') paths = [f'tests/resources/{i}' for i in paths] # Get list of extensions of input files. extensions = set() extensions.add('.txt') extensions.add('') for path in paths: _, ext = os.path.splitext(path) extensions.add(ext) extensions = sorted(list(extensions)) def get_result(e, document): ''' Return fz_lookup_metadata(document, 'format') or [ERROR]. ''' if e: return f'[error]' else: try: return pymupdf.mupdf.fz_lookup_metadata2(document, 'format') except Exception: return '' def dict_set_path(dict_, *items): for item in items[:-2]: dict_ = dict_.setdefault(item, dict()) dict_[items[-2]] = items[-1] results = dict() # Prevent warnings while we are running. _g_out_message = pymupdf._g_out_message pymupdf._g_out_message = None try: results = dict() for path in paths: print(path) for ext in extensions: path2 = f'{root}/foo{ext}' path3 = shutil.copy2(f'{root}/{path}', path2) assert(path3 == path2) # Test fz_open_document(). e = None document = None try: document = pymupdf.mupdf.fz_open_document(path2) except Exception as ee: e = ee wt = pymupdf.TOOLS.mupdf_warnings() text = get_result(e, document) print(f' fz_open_document({path2}) => {text}') dict_set_path(results, path, ext, 'file', text) # Test fz_open_document_with_stream(). e = None document = None with open(f'{root}/{path}', 'rb') as f: data = f.read() stream = pymupdf.mupdf.fz_open_memory(pymupdf.mupdf.python_buffer_data(data), len(data)) try: document = pymupdf.mupdf.fz_open_document_with_stream(ext, stream) except Exception as ee: e = ee wt = pymupdf.TOOLS.mupdf_warnings() text = get_result(e, document) print(f' fz_open_document_with_stream(magic={ext!r}) => {text}') dict_set_path(results, path, ext, 'stream', text) finally: pymupdf._g_out_message = _g_out_message # Create html table. path_html = os.path.normpath(f'{__file__}/../../tests/test_open2.html') with open(path_html, 'w') as f: f.write(f'\n') f.write(f'\n') f.write(f'

We shall meet again at a place where there is no darkness.

""" MEDIABOX = pymupdf.paper_rect("letter") WHERE = MEDIABOX + (36, 36, -36, -36) # the font files are located in /home/chinese arch = pymupdf.Archive(".") # if not specified user_css, the output pdf has content story = pymupdf.Story(HTML, user_css=CSS, archive=arch) writer = pymupdf.DocumentWriter("output.pdf") more = 1 while more: device = writer.begin_page(MEDIABOX) more, _ = story.place(WHERE) story.draw(device) writer.end_page() writer.close() def test_2753(): def rectfn(rect_num, filled): return pymupdf.Rect(0, 0, 200, 200), pymupdf.Rect(50, 50, 100, 150), None def make_pdf(html, path_out): story = pymupdf.Story(html=html) document = story.write_with_links(rectfn) print(f'test_2753(): Writing to: {path_out=}.') document.save(path_out) return document doc_before = make_pdf( textwrap.dedent('''

Before

After

'''), os.path.abspath(f'{__file__}/../../tests/test_2753-out-before.pdf'), ) doc_after = make_pdf( textwrap.dedent('''

Before

After

'''), os.path.abspath(f'{__file__}/../../tests/test_2753-out-after.pdf'), ) path = os.path.normpath(f'{__file__}/../../tests/test_2753_out') doc_before.save(f'{path}_before.pdf') doc_after.save(f'{path}_after.pdf') assert len(doc_before) == 2 assert len(doc_after) == 2 # codespell:ignore-begin springer_html = '''

SPRINGERS EINWÜRFE: INTIME VERBINDUNGEN

Wieso kann unsereins so vieles, was eine Maus nicht kann? Unser Gehirn ist nicht bloß größer, sondern vor allem überraschend vertrackt verdrahtet.

Der Heilige Gral der Neu­ro­wis­sen­schaft ist die komplette Kartierung des menschlichen Gehirns – die ge­treue Ab­bildung des Ge­strüpps der Nervenzellen mit den baum­för­mi­gen Ver­ästel­ungen der aus ihnen sprie­ßen­den Den­dri­ten und den viel län­ge­ren Axo­nen, wel­che oft der Sig­nal­über­tragung von einem Sin­nes­or­gan oder zu einer Mus­kel­fa­ser die­nen. Zum Gesamtbild gehören die winzigen Knötchen auf den Dendriten; dort sitzen die Synapsen. Das sind Kontakt- und Schalt­stel­len, leb­haf­te Ver­bin­dungen zu anderen Neuronen.

Dieses Dickicht bis zur Ebene einzelner Zel­len zu durchforsten und es räumlich dar­zu­stel­len, ist eine gigantische Aufgabe, die bis vor Kurzem utopisch anmuten musste. Neu­er­dings vermag der junge For­schungs­zweig der Konnektomik (von Englisch: con­nect für ver­bin­den) das Zusammenspiel der Neurone immer besser zu verstehen. Das gelingt mit dem Einsatz dreidimensionaler Elek­tro­nen­mik­ros­ko­pie. Aus Dünn­schicht­auf­nah­men von zerebralen Ge­we­be­pro­ben lassen sich plastische Bil­der ganzer Zellverbände zu­sam­men­setzen.

Da frisches menschliches Hirn­ge­we­be nicht ohne Wei­te­res zu­gäng­lich ist – in der Regel nur nach chirurgischen Eingriffen an Epi­lep­sie­pa­tien­ten –, hält die Maus als Mo­dell­or­ga­nis­mus her. Die evolutionäre Ver­wandt­schaft von Mensch und Nager macht die Wahl plau­sibel. Vor allem das Team um Moritz Helmstaedter am Max-Planck-Institut (MPI) für Hirnforschung in Frankfurt hat in den ver­gangenen Jahren Expertise bei der kon­nek­tomischen Analyse entwickelt.

Aber steckt in unserem Kopf bloß ein auf die tausendfache Neu­ro­nen­an­zahl auf­ge­bläh­tes Mäu­se­hirn? Oder ist menschliches Ner­ven­ge­we­be viel­leicht doch anders gestrickt? Zur Beantwortung dieser Frage unternahm die MPI-Gruppe einen detaillierten Vergleich von Maus, Makake und Mensch (Science 377, abo0924, 2022).

Menschliches Gewebe stammte diesmal nicht von Epileptikern, son­dern von zwei wegen Hirntumoren operierten Patienten. Die For­scher wollten damit vermeiden, dass die oft jahrelange Behandlung mit An­ti­epi­lep­ti­ka das Bild der synaptischen Verknüpfungen trübte. Sie verglichen die Proben mit denen eines Makaken und von fünf Mäusen.

Einerseits ergaben sich – einmal ab­ge­se­hen von den ganz of­fen­sicht­li­chen quan­titativen Unterschieden wie Hirngröße und Neu­ro­nen­anzahl – recht gute Über­ein­stim­mun­gen, die somit den Gebrauch von Tier­modellen recht­fer­ti­gen. Doch in einem Punkt erlebte das MPI-Team eine echte Über­raschung.

Gewisse Nervenzellen, die so genannten In­ter­neurone, zeichnen sich dadurch aus, dass sie aus­schließ­lich mit anderen Ner­ven­zel­len in­ter­agieren. Solche »Zwi­schen­neu­rone« mit meist kurzen Axonen sind nicht primär für das Verarbeiten externer Reize oder das Aus­lösen körperlicher Reaktionen zuständig; sie be­schäf­ti­gen sich bloß mit der Ver­stär­kung oder Dämpfung interner Signale.

Just dieser Neuronentyp ist nun bei Makaken und Menschen nicht nur mehr als doppelt so häufig wie bei Mäusen, sondern obendrein be­son­ders intensiv untereinander ver­flochten. Die meisten Interneurone kop­peln sich fast ausschließlich an ihresgleichen. Dadurch wirkt sich ihr konnektomisches Ge­wicht ver­gleichs­weise zehnmal so stark aus.

Vermutlich ist eine derart mit sich selbst be­schäf­tigte Sig­nal­ver­ar­beitung die Vor­be­ding­ung für ge­stei­gerte Hirn­leis­tungen. Um einen Ver­gleich mit verhältnismäßig pri­mi­ti­ver Tech­nik zu wagen: Bei küns­tli­chen neu­ro­na­len Netzen – Algorithmen nach dem Vor­bild verknüpfter Nervenzellen – ge­nü­gen schon ein, zwei so genannte ver­bor­ge­ne Schich­ten von selbst­be­züg­li­chen Schaltstellen zwischen Input und Output-Ebene, um die ver­blüf­fen­den Erfolge der künstlichen Intel­ligenz her­vor­zu­bringen.

''' #codespell:ignore-end def test_fit_springer(): if not hasattr(pymupdf, 'mupdf'): print(f'test_fit_springer(): not running on classic.') return verbose = 0 story = pymupdf.Story(springer_html) def check(call, expected): ''' Checks that eval(call) returned parameter=expected. Also creates PDF using path that contains `call` in its leafname, ''' fit_result = eval(call) print(f'test_fit_springer(): {call=} => {fit_result=}.') if expected is None: assert not fit_result.big_enough else: document = story.write_with_links(lambda rectnum, filled: (fit_result.rect, fit_result.rect, None)) path = os.path.abspath(f'{__file__}/../../tests/test_fit_springer_{call}_{fit_result.parameter=}_{fit_result.rect=}.pdf') document.save(path) print(f'Have saved document to {path}.') assert abs(fit_result.parameter-expected) < 0.001, f'{expected=} {fit_result.parameter=}' check(f'story.fit_scale(pymupdf.Rect(0, 0, 200, 200), scale_min=1, verbose={verbose})', 3.685728073120117) check(f'story.fit_scale(pymupdf.Rect(0, 0, 595, 842), scale_min=1, verbose={verbose})', 1.0174560546875) check(f'story.fit_scale(pymupdf.Rect(0, 0, 300, 421), scale_min=1, verbose={verbose})', 2.02752685546875) check(f'story.fit_scale(pymupdf.Rect(0, 0, 600, 900), scale_min=1, scale_max=1, verbose={verbose})', 1) check(f'story.fit_height(20, verbose={verbose})', 10782.3291015625) check(f'story.fit_height(200, verbose={verbose})', 2437.4990234375) check(f'story.fit_height(2000, verbose={verbose})', 450.2998046875) check(f'story.fit_height(5000, verbose={verbose})', 378.2998046875) check(f'story.fit_height(5500, verbose={verbose})', 378.2998046875) check(f'story.fit_width(3000, verbose={verbose})', 167.30859375) check(f'story.fit_width(2000, verbose={verbose})', 239.595703125) check(f'story.fit_width(1000, verbose={verbose})', 510.85546875) check(f'story.fit_width(500, verbose={verbose})', 1622.1272945404053) check(f'story.fit_width(400, verbose={verbose})', 2837.507724761963) check(f'story.fit_width(300, width_max=200000, verbose={verbose})', None) check(f'story.fit_width(200, width_max=200000, verbose={verbose})', None) # Run without verbose to check no calls to log() - checked by assert. check('story.fit_scale(pymupdf.Rect(0, 0, 600, 900), scale_min=1, scale_max=1, verbose=0)', 1) check('story.fit_scale(pymupdf.Rect(0, 0, 300, 421), scale_min=1, verbose=0)', 2.02752685546875) def test_write_stabilized_with_links(): def rectfn(rect_num, filled): ''' We return one rect per page. ''' rect = pymupdf.Rect(10, 20, 290, 380) mediabox = pymupdf.Rect(0, 0, 300, 400) #print(f'rectfn(): rect_num={rect_num} filled={filled}') return mediabox, rect, None def contentfn(positions): ret = '' ret += textwrap.dedent('''

Contents

    ''') for position in positions: if position.heading and (position.open_close & 1): text = position.text if position.text else '' if position.id: ret += f'
  • {text}' else: ret += f'
  • {text}' ret += f' page={position.page_num}\n' ret += '
\n' ret += textwrap.dedent(f'''

First section

Contents of first section.

Second section

Contents of second section.

Second section first subsection

Contents of second section first subsection.

IDTEST

Third section

Contents of third section.

NAMETEST. ''') return ret.strip() document = pymupdf.Story.write_stabilized_with_links(contentfn, rectfn) # Check links. links = list() for page in document: links += page.get_links() print(f'{len(links)=}.') external_links = dict() for i, link in enumerate(links): print(f' {i}: {link=}') if link.get('kind') == pymupdf.LINK_URI: uri = link['uri'] external_links.setdefault(uri, 0) external_links[uri] += 1 # Check there is one external link. print(f'{external_links=}') if hasattr(pymupdf, 'mupdf'): assert len(external_links) == 1 assert 'https://artifex.com/' in external_links out_path = __file__.replace('.py', '.pdf') document.save(out_path) def test_archive_creation(): s = pymupdf.Story(archive=pymupdf.Archive('.')) s = pymupdf.Story(archive='.') def test_3813(): import pymupdf HTML = """

Count is fine:

  1. Lorem
    1. Sub Lorem
    2. Sub Lorem
  2. Lorem
  3. Lorem

Broken count:

  1. Lorem
    • Sub Lorem
    • Sub Lorem
  2. Lorem
  3. Lorem
""" MEDIABOX = pymupdf.paper_rect("A4") WHERE = MEDIABOX + (36, 36, -36, -36) story = pymupdf.Story(html=HTML) path = os.path.normpath(f'{__file__}/../../tests/test_3813_out.pdf') writer = pymupdf.DocumentWriter(path) more = 1 while more: device = writer.begin_page(MEDIABOX) more, _ = story.place(WHERE) story.draw(device) writer.end_page() writer.close() with pymupdf.open(path) as document: page = document[0] text = page.get_text() text_utf8 = text.encode() text_expected_utf8 = b'Count is \xef\xac\x81ne:\n1. Lorem\n1. Sub Lorem\n2. Sub Lorem\n2. Lorem\n3. Lorem\nBroken count:\n1. Lorem\n\xe2\x80\xa2 Sub Lorem\n\xe2\x80\xa2 Sub Lorem\n2. Lorem\n3. Lorem\n' text_expected = text_expected_utf8.decode() print(f'text_utf8:\n {text_utf8!r}') print(f'text_expected_utf8:\n {text_expected_utf8!r}') print(f'text:\n {textwrap.indent(text, " ")}') print(f'text_expected:\n {textwrap.indent(text_expected, " ")}') assert text == text_expected ================================================ FILE: tests/test_tables.py ================================================ import os import io from pprint import pprint import textwrap import pickle import platform import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "chinese-tables.pdf") pickle_file = os.path.join(scriptdir, "resources", "chinese-tables.pickle") def test_table1(): """Compare pickled tables with those of the current run.""" pickle_in = open(pickle_file, "rb") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables() cells = tabs[0].cells + tabs[1].cells # all table cell tuples on page extracts = [tabs[0].extract(), tabs[1].extract()] # all table cell content old_data = pickle.load(pickle_in) # previously saved data # Compare cell contents assert old_data["extracts"] == extracts # same cell contents # Compare cell coordinates. # Cell rectangles may get somewhat larger due to more cautious border # computations, but any differences must be small. old_cells = old_data["cells"][0] + old_data["cells"][1] assert len(cells) == len(old_cells) for i in range(len(cells)): c1 = pymupdf.Rect(cells[i]) # new cell coordinates c0 = pymupdf.Rect(old_cells[i]) # old cell coordinates assert c0 in c1 # always: old contained in new assert abs(c1 - c0) < 0.2 # difference must be small def test_table2(): """Confirm header properties.""" doc = pymupdf.open(filename) page = doc[0] tab1, tab2 = page.find_tables().tables # both tables contain their header data assert tab1.header.external == False assert tab1.header.cells == tab1.rows[0].cells assert tab2.header.external == False assert tab2.header.cells == tab2.rows[0].cells def test_2812(): """Ensure table detection and extraction independent from page rotation. Make 4 pages with rotations 0, 90, 180 and 270 degrees respectively. Each page shows the same 8x5 table. We will check that each table is detected and delivers the same content. """ doc = pymupdf.open() # Page 0: rotation 0 page = doc.new_page(width=842, height=595) rect = page.rect + (72, 72, -72, -72) cols = 5 rows = 8 # define the cells, draw the grid and insert unique text in each cell. cells = pymupdf.make_table(rect, rows=rows, cols=cols) for i in range(rows): for j in range(cols): page.draw_rect(cells[i][j]) for i in range(rows): for j in range(cols): page.insert_textbox( cells[i][j], f"cell[{i}][{j}]", align=pymupdf.TEXT_ALIGN_CENTER, ) page.clean_contents() # Page 1: rotation 90 degrees page = doc.new_page() rect = page.rect + (72, 72, -72, -72) cols = 8 rows = 5 cells = pymupdf.make_table(rect, rows=rows, cols=cols) for i in range(rows): for j in range(cols): page.draw_rect(cells[i][j]) for i in range(rows): for j in range(cols): page.insert_textbox( cells[i][j], f"cell[{j}][{rows-i-1}]", rotate=90, align=pymupdf.TEXT_ALIGN_CENTER, ) page.set_rotation(90) page.clean_contents() # Page 2: rotation 180 degrees page = doc.new_page(width=842, height=595) rect = page.rect + (72, 72, -72, -72) cols = 5 rows = 8 cells = pymupdf.make_table(rect, rows=rows, cols=cols) for i in range(rows): for j in range(cols): page.draw_rect(cells[i][j]) for i in range(rows): for j in range(cols): page.insert_textbox( cells[i][j], f"cell[{rows-i-1}][{cols-j-1}]", rotate=180, align=pymupdf.TEXT_ALIGN_CENTER, ) page.set_rotation(180) page.clean_contents() # Page 3: rotation 270 degrees page = doc.new_page() rect = page.rect + (72, 72, -72, -72) cols = 8 rows = 5 cells = pymupdf.make_table(rect, rows=rows, cols=cols) for i in range(rows): for j in range(cols): page.draw_rect(cells[i][j]) for i in range(rows): for j in range(cols): page.insert_textbox( cells[i][j], f"cell[{cols-j-1}][{i}]", rotate=270, align=pymupdf.TEXT_ALIGN_CENTER, ) page.set_rotation(270) page.clean_contents() pdfdata = doc.tobytes() # doc.ez_save("test-2812.pdf") doc.close() # ------------------------------------------------------------------------- # Test PDF prepared. Extract table on each page and # ensure identical extracted table data. # ------------------------------------------------------------------------- doc = pymupdf.open("pdf", pdfdata) extracts = [] for page in doc: tabs = page.find_tables() assert len(tabs.tables) == 1 tab = tabs[0] fp = io.StringIO() pprint(tab.extract(), stream=fp) extracts.append(fp.getvalue()) fp = None assert tab.row_count == 8 assert tab.col_count == 5 e0 = extracts[0] for e in extracts[1:]: assert e == e0 def test_2979(): """This tests fix #2979 and #3001. 2979: identical cell count for each row 3001: no change of global glyph heights """ filename = os.path.join(scriptdir, "resources", "test_2979.pdf") doc = pymupdf.open(filename) page = doc[0] tab = page.find_tables()[0] # extract the table lengths = set() # stores all row cell counts for e in tab.extract(): lengths.add(len(e)) # store number of cells for row # test 2979 assert len(lengths) == 1 # test 3001 assert ( pymupdf.TOOLS.set_small_glyph_heights() is False ), f"{pymupdf.TOOLS.set_small_glyph_heights()=}" wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 28, 0): assert ( wt == '' ) else: assert ( wt == "bogus font ascent/descent values (3117 / -2463)\n... repeated 2 times..." ) def test_3062(): """Tests the fix for #3062. After table extraction, a rotated page should behave and look like as before.""" if platform.python_implementation() == 'GraalVM': print(f'test_3062(): Not running because slow on GraalVM.') return filename = os.path.join(scriptdir, "resources", "test_3062.pdf") doc = pymupdf.open(filename) page = doc[0] tab0 = page.find_tables()[0] cells0 = tab0.cells page = None page = doc[0] tab1 = page.find_tables()[0] cells1 = tab1.cells assert cells1 == cells0 def test_strict_lines(): """Confirm that ignoring borderless rectangles improves table detection.""" filename = os.path.join(scriptdir, "resources", "strict-yes-no.pdf") doc = pymupdf.open(filename) page = doc[0] tab1 = page.find_tables()[0] tab2 = page.find_tables(strategy="lines_strict")[0] assert tab2.row_count < tab1.row_count assert tab2.col_count < tab1.col_count def test_add_lines(): """Test new parameter add_lines for table recognition.""" if platform.python_implementation() == 'GraalVM': print(f'test_add_lines(): Not running because breaks later tests on GraalVM.') return filename = os.path.join(scriptdir, "resources", "small-table.pdf") doc = pymupdf.open(filename) page = doc[0] assert page.find_tables().tables == [] more_lines = [ ((238.9949951171875, 200.0), (238.9949951171875, 300.0)), ((334.5559997558594, 200.0), (334.5559997558594, 300.0)), ((433.1809997558594, 200.0), (433.1809997558594, 300.0)), ] # these 3 additional vertical lines should additional 3 columns tab2 = page.find_tables(add_lines=more_lines)[0] assert tab2.col_count == 4 assert tab2.row_count == 5 def test_3148(): """Ensure correct extraction text of rotated text.""" doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(100, 100, 300, 300) text = ( "rotation 0 degrees", "rotation 90 degrees", "rotation 180 degrees", "rotation 270 degrees", ) degrees = (0, 90, 180, 270) delta = (2, 2, -2, -2) cells = pymupdf.make_table(rect, cols=3, rows=4) for i in range(3): for j in range(4): page.draw_rect(cells[j][i]) k = (i + j) % 4 page.insert_textbox(cells[j][i] + delta, text[k], rotate=degrees[k]) # doc.save("multi-degree.pdf") tabs = page.find_tables() tab = tabs[0] for extract in tab.extract(): for item in extract: item = item.replace("\n", " ") assert item in text def test_3179(): """Test correct separation of multiple tables on page.""" filename = os.path.join(scriptdir, "resources", "test_3179.pdf") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables() assert len(tabs.tables) == 3 def test_battery_file(): """Tests correctly ignoring non-table suspects. Earlier versions erroneously tried to identify table headers where there existed no table at all. """ filename = os.path.join(scriptdir, "resources", "battery-file-22.pdf") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables() assert len(tabs.tables) == 0 def test_markdown(): """Confirm correct markdown output.""" filename = os.path.join(scriptdir, "resources", "strict-yes-no.pdf") doc = pymupdf.open(filename) page = doc[0] tab = page.find_tables(strategy="lines_strict")[0] if pymupdf.mupdf_version_tuple < (1, 26, 3): md_expected = textwrap.dedent(''' |Header1|Header2|Header3| |---|---|---| |Col11
Col12|~~Col21~~
~~Col22~~|Col31
Col32
Col33| |Col13|~~Col23~~|Col34
Col35| |Col14|~~Col24~~|Col36| |Col15|~~Col25~~
~~Col26~~|| ''').lstrip() else: md_expected = ( "|Header1|Header2|Header3|\n" "|---|---|---|\n" "|Col11
Col12|Col21
Col22|Col31
Col32
Col33|\n" "|Col13|Col23|Col34
Col35|\n" "|Col14|Col24|Col36|\n" "|Col15|Col25
Col26||\n\n" ) md = tab.to_markdown() assert md == md_expected, f'Incorrect md:\n{textwrap.indent(md, " ")}' def test_paths_param(): """Confirm acceptance of supplied vector graphics list.""" filename = os.path.join(scriptdir, "resources", "strict-yes-no.pdf") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables(paths=[]) # will cause all tables are missed assert tabs.tables == [] def test_boxes_param(): """Confirm acceptance of supplied boxes list.""" filename = os.path.join(scriptdir, "resources", "small-table.pdf") doc = pymupdf.open(filename) page = doc[0] paths = page.get_drawings() box0 = page.cluster_drawings(drawings=paths)[0] boxes = [box0] words = page.get_text("words") x_vals = [w[0] - 5 for w in words if w[4] in ("min", "max", "avg")] for x in x_vals: r = +box0 r.x1 = x boxes.append(r) y_vals = sorted(set([round(w[3]) for w in words])) for y in y_vals[:-1]: # skip last one to avoid empty row r = +box0 r.y1 = y boxes.append(r) tabs = page.find_tables(paths=[], add_boxes=boxes) tab = tabs.tables[0] assert tab.extract() == [ ["Boiling Points °C", "min", "max", "avg"], ["Noble gases", "-269", "-62", "-170.5"], ["Nonmetals", "-253", "4827", "414.1"], ["Metalloids", "335", "3900", "741.5"], ["Metals", "357", ">5000", "2755.9"], ] def test_dotted_grid(): """Confirm dotted lines are detected as gridlines.""" filename = os.path.join(scriptdir, "resources", "dotted-gridlines.pdf") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables() assert len(tabs.tables) == 3 # must be 3 tables t0, t1, t2 = tabs # extract them # check that they have expected dimensions assert t0.row_count, t0.col_count == (11, 12) assert t1.row_count, t1.col_count == (25, 11) assert t2.row_count, t2.col_count == (1, 10) def test_4017(): path = os.path.normpath(f"{__file__}/../../tests/resources/test_4017.pdf") with pymupdf.open(path) as document: page = document[0] tables = page.find_tables(add_lines=None) print(f"{len(tables.tables)=}.") tables_text = list() for i, table in enumerate(tables): print(f"## {i=}.") t = table.extract() for tt in t: print(f" {tt}") # 2024-11-29: expect current incorrect output for last two tables. expected_a = [ ["Class A/B Overcollateralization", "131.44%", ">=", "122.60%", "", "PASS"], [None, None, None, None, None, "PASS"], ["Class D Overcollateralization", "112.24%", ">=", "106.40%", "", "PASS"], [None, None, None, None, None, "PASS"], ["Event of Default", "156.08%", ">=", "102.50%", "", "PASS"], [None, None, None, None, None, "PASS"], ["Class A/B Interest Coverage", "N/A", ">=", "120.00%", "", "N/A"], [None, None, None, None, None, "N/A"], ["Class D Interest Coverage", "N/A", ">=", "105.00%", "", "N/A"], ] assert tables[-2].extract() == expected_a expected_b = [ [ "Moody's Maximum Rating Factor Test", "2,577", "<=", "3,250", "", "PASS", "2,581", ], [None, None, None, None, None, "PASS", None], [ "Minimum Floating Spread", "3.5006%", ">=", "2.0000%", "", "PASS", "3.4871%", ], [None, None, None, None, None, "PASS", None], [ "Minimum Weighted Average S&P Recovery\nRate Test", "40.50%", ">=", "40.00%", "", "PASS", "40.40%", ], [None, None, None, None, None, "PASS", None], ["Weighted Average Life", "4.83", "<=", "9.00", "", "PASS", "4.92"], ] assert tables[-1].extract() == expected_b def test_md_styles(): """Test output of table with MD-styled cells.""" filename = os.path.join(scriptdir, "resources", "test-styled-table.pdf") doc = pymupdf.open(filename) page = doc[0] tabs = page.find_tables()[0] text = """|Column 1|Column 2|Column 3|\n|---|---|---|\n|Zelle (0,0)|**Bold (0,1)**|Zelle (0,2)|\n|~~Strikeout (1,0), Zeile 1~~
~~Hier kommt Zeile 2.~~|Zelle (1,1)|~~Strikeout (1,2)~~|\n|**`Bold-monospaced`**
**`(2,0)`**|_Italic (2,1)_|**_Bold-italic_**
**_(2,2)_**|\n|Zelle (3,0)|~~**Bold-strikeout**~~
~~**(3,1)**~~|Zelle (3,2)|\n\n""" assert tabs.to_markdown() == text ================================================ FILE: tests/test_tesseract.py ================================================ import os import platform import textwrap import pathlib import pymupdf def test_tesseract(): ''' This checks that MuPDF has been built with tesseract support. By default we don't supply a valid `tessdata` directory, and just assert that attempting to use Tesseract raises the expected error (which checks that MuPDF is built with Tesseract support). But if TESSDATA_PREFIX is set in the environment, we assert that FzPage.get_textpage_ocr() succeeds. ''' path = os.path.abspath( f'{__file__}/../resources/2.pdf') doc = pymupdf.open( path) page = doc[5] tail = 'Tesseract language initialisation failed' if os.environ.get('PYODIDE_ROOT'): e_expected = 'code=6: No OCR support in this build' e_expected_type = pymupdf.mupdf.FzErrorUnsupported else: e_expected = f'code=3: {tail}' if platform.system() == 'OpenBSD': # 2023-12-12: For some reason the SWIG catch code only catches # the exception as FzErrorBase. e_expected_type = pymupdf.mupdf.FzErrorBase print(f'OpenBSD workaround - expecting FzErrorBase, not FzErrorLibrary.') else: e_expected_type = pymupdf.mupdf.FzErrorLibrary tessdata_prefix = os.environ.get('TESSDATA_PREFIX') if tessdata_prefix: tp = page.get_textpage_ocr(full=True) print(f'test_tesseract(): page.get_textpage_ocr() succeeded') else: try: tp = page.get_textpage_ocr(full=True, tessdata='/foo/bar') except Exception as e: e_text = str(e) print(f'Received exception as expected.') print(f'{type(e)=}') print(f'{e_text=}') assert e_text == e_expected, f'Unexpected exception: {e_text!r}' if e_expected_type: print(f'{e_expected_type=}') assert type(e) == e_expected_type, f'{type(e)=} != {e_expected_type=}.' else: assert 0, f'Expected exception {e_expected!r}' def test_3842b(): # Check Tesseract failure when given a bogus languages. # # Note that Tesseract seems to output its own diagnostics. # if os.environ.get('PYODIDE_ROOT'): print('test_3842b(): not running on Pyodide - cannot run child processes.') return path = os.path.normpath(f'{__file__}/../../tests/resources/test_3842.pdf') with pymupdf.open(path) as document: page = document[6] try: partial_tp = page.get_textpage_ocr(flags=0, full=False, language='qwerty') except Exception as e: print(f'test_3842b(): received exception: {e}') if 'No tessdata specified and Tesseract is not installed' in str(e): pass else: assert 'Tesseract language initialisation failed' in str(e) def test_3842(): if os.environ.get('PYODIDE_ROOT'): print('test_3842(): not running on Pyodide - cannot run child processes.') return path = os.path.normpath(f'{__file__}/../../tests/resources/test_3842.pdf') if pymupdf.mupdf_version_tuple >= (1, 28): path_text_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3842_expected_1.28.txt') else: path_text_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3842_partial.txt') text_expected = pathlib.Path(path_text_expected).read_text() with pymupdf.open(path) as document: page = document[6] try: partial_tp = page.get_textpage_ocr(flags=0, full=False, dpi=300) except Exception as e: print(f'test_3842(): received exception: {e}', flush=1) if 'No tessdata specified and Tesseract is not installed' in str(e): pass elif 'Tesseract language initialisation failed' in str(e): pass else: assert 0, f'Unexpected exception text: {str(e)=}' else: text = page.get_text(textpage=partial_tp) with open(os.path.normpath(f'{__file__}/../../tests/resources/test_3842_out'), 'w') as f: f.write(text) print() print(text) print(f'text:\n{text!r}') print(f'text_expected:\n{text_expected!r}') assert text == text_expected ================================================ FILE: tests/test_textbox.py ================================================ """ Fill a given text in a rectangle on some PDF page using 1. TextWriter object 2. Basic text output Check text is indeed contained in given rectangle. """ import pymupdf import gentle_compare import os import textwrap # codespell:ignore-begin text = """Der Kleine Schwertwal (Pseudorca crassidens), auch bekannt als Unechter oder Schwarzer Schwertwal, ist eine Art der Delfine (Delphinidae) und der einzige rezente Vertreter der Gattung Pseudorca. Er ähnelt dem Orca in Form und Proportionen, ist aber einfarbig schwarz und mit einer Maximallänge von etwa sechs Metern deutlich kleiner. Kleine Schwertwale bilden Schulen von durchschnittlich zehn bis fünfzig Tieren, wobei sie sich auch mit anderen Delfinen vergesellschaften und sich meistens abseits der Küsten aufhalten. Sie sind in allen Ozeanen gemäßigter, subtropischer und tropischer Breiten beheimatet, sind jedoch vor allem in wärmeren Jahreszeiten auch bis in die gemäßigte bis subpolare Zone südlich der Südspitze Südamerikas, vor Nordeuropa und bis vor Kanada anzutreffen.""" # codespell:ignore-end def test_textbox1(): """Use TextWriter for text insertion.""" doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(50, 50, 400, 400) blue = (0, 0, 1) tw = pymupdf.TextWriter(page.rect, color=blue) tw.fill_textbox( rect, text, align=pymupdf.TEXT_ALIGN_LEFT, fontsize=12, ) tw.write_text(page, morph=(rect.tl, pymupdf.Matrix(1, 1))) # check text containment assert page.get_text() == page.get_text(clip=rect) page.write_text(writers=tw) def test_textbox2(): """Use basic text insertion.""" doc = pymupdf.open() ocg = doc.add_ocg("ocg1") page = doc.new_page() rect = pymupdf.Rect(50, 50, 400, 400) blue = pymupdf.utils.getColor("lightblue") red = pymupdf.utils.getColorHSV("red") page.insert_textbox( rect, text, align=pymupdf.TEXT_ALIGN_LEFT, fontsize=12, color=blue, oc=ocg, ) # check text containment assert page.get_text() == page.get_text(clip=rect) def test_textbox3(): """Use TextWriter for text insertion.""" doc = pymupdf.open() page = doc.new_page() font = pymupdf.Font("cjk") rect = pymupdf.Rect(50, 50, 400, 400) blue = (0, 0, 1) tw = pymupdf.TextWriter(page.rect, color=blue) tw.fill_textbox( rect, text, align=pymupdf.TEXT_ALIGN_LEFT, font=font, fontsize=12, right_to_left=True, ) tw.write_text(page, morph=(rect.tl, pymupdf.Matrix(1, 1))) # check text containment assert page.get_text() == page.get_text(clip=rect) doc.scrub() doc.subset_fonts() def test_textbox4(): """Use TextWriter for text insertion.""" doc = pymupdf.open() ocg = doc.add_ocg("ocg1") page = doc.new_page() rect = pymupdf.Rect(50, 50, 400, 600) blue = (0, 0, 1) tw = pymupdf.TextWriter(page.rect, color=blue) tw.fill_textbox( rect, text, align=pymupdf.TEXT_ALIGN_LEFT, fontsize=12, font=pymupdf.Font("cour"), right_to_left=True, ) tw.write_text(page, oc=ocg, morph=(rect.tl, pymupdf.Matrix(1, 1))) # check text containment assert page.get_text() == page.get_text(clip=rect) def test_textbox5(): """Using basic text insertion.""" small_glyph_heights0 = pymupdf.TOOLS.set_small_glyph_heights() pymupdf.TOOLS.set_small_glyph_heights(True) try: doc = pymupdf.open() page = doc.new_page() r = pymupdf.Rect(100, 100, 150, 150) text = "words and words and words and more words..." rc = -1 fontsize = 12 page.draw_rect(r) while rc < 0: rc = page.insert_textbox( r, text, fontsize=fontsize, align=pymupdf.TEXT_ALIGN_JUSTIFY, ) fontsize -= 0.5 blocks = page.get_text("blocks") bbox = pymupdf.Rect(blocks[0][:4]) assert bbox in r finally: # Must restore small_glyph_heights, otherwise other tests can fail. pymupdf.TOOLS.set_small_glyph_heights(small_glyph_heights0) def test_2637(): """Ensure correct calculation of fitting text.""" doc = pymupdf.open() page = doc.new_page() text = ( "The morning sun painted the sky with hues of orange and pink. " "Birds chirped harmoniously, greeting the new day. " "Nature awakened, filling the air with life and promise." ) rect = pymupdf.Rect(50, 50, 500, 280) fontsize = 50 rc = -1 while rc < 0: # look for largest font size that makes the text fit rc = page.insert_textbox(rect, text, fontname="hebo", fontsize=fontsize) fontsize -= 1 # confirm text won't lap outside rect blocks = page.get_text("blocks") bbox = pymupdf.Rect(blocks[0][:4]) assert bbox in rect def test_htmlbox1(): """Write HTML-styled text into a rect with different rotations. The text is styled and contains a link. Then extract the text again, and - assert that text was written in the 4 different angles, - assert that text properties are correct (bold, italic, color), - assert that the link has been correctly inserted. We try to insert into a rectangle that is too small, setting scale=False and confirming we have a negative return code. """ if not hasattr(pymupdf, "mupdf"): print("'test_htmlbox1' not executed in classic.") return rect = pymupdf.Rect(100, 100, 200, 200) # this only works with scale=True base_text = """Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""" text = """Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""" doc = pymupdf.Document() for rot in (0, 90, 180, 270): wdirs = ((1, 0), (0, -1), (-1, 0), (0, 1)) # all writing directions page = doc.new_page() spare_height, scale = page.insert_htmlbox(rect, text, rotate=rot, scale_low=1) assert spare_height < 0 assert scale == 1 spare_height, scale = page.insert_htmlbox(rect, text, rotate=rot, scale_low=0) page.draw_rect(rect, (1, 0, 0)) doc.save(os.path.normpath(f'{__file__}/../../tests/test_htmlbox1.pdf')) assert abs(spare_height - 3.8507) < 0.001 assert 0 < scale < 1 page = doc.reload_page(page) link = page.get_links()[0] # extracts the links on the page assert link["uri"] == "https://www.artifex.com" # Assert plain text is complete. # We must remove line breaks and any ligatures for this. assert base_text == page.get_text(flags=0)[:-1].replace("\n", " ") encounters = 0 # counts the words with selected properties for b in page.get_text("dict")["blocks"]: for l in b["lines"]: wdir = l["dir"] # writing direction assert wdir == wdirs[page.number] for s in l["spans"]: stext = s["text"] color = pymupdf.sRGB_to_pdf(s["color"]) bold = bool(s["flags"] & 16) italic = bool(s["flags"] & 2) if stext in ("ullamco", "laboris", "voluptate"): encounters += 1 if stext == "ullamco": assert bold is True assert italic is False assert color == pymupdf.pdfcolor["black"] elif stext == "laboris": assert bold is False assert italic is True assert color == pymupdf.pdfcolor["black"] elif stext == "voluptate": assert bold is True assert italic is False assert color == pymupdf.pdfcolor["green"] else: assert bold is False assert italic is False # all 3 special special words were encountered assert encounters == 3 def test_htmlbox2(): """Test insertion without scaling""" if not hasattr(pymupdf, "mupdf"): print("'test_htmlbox2' not executed in classic.") return doc = pymupdf.open() rect = pymupdf.Rect(100, 100, 200, 200) # large enough to hold text page = doc.new_page() bottoms = set() for rot in (0, 90, 180, 270): spare_height, scale = page.insert_htmlbox( rect, "Hello, World!", scale_low=1, rotate=rot ) assert scale == 1 assert 0 < spare_height < rect.height bottoms.add(spare_height) assert len(bottoms) == 1 # same result for all rotations def test_htmlbox3(): """Test insertion with opacity""" if not hasattr(pymupdf, "mupdf"): print("'test_htmlbox3' not executed in classic.") return rect = pymupdf.Rect(100, 250, 300, 350) text = """Just some text.""" doc = pymupdf.open() page = doc.new_page() # insert some text with opacity page.insert_htmlbox(rect, text, opacity=0.5) # lowlevel-extract inserted text to access opacity span = page.get_texttrace()[0] assert span["opacity"] == 0.5 def test_3559(): doc = pymupdf.Document() page = doc.new_page() text_insert="""

""" rect = pymupdf.Rect(100, 100, 200, 200) page.insert_htmlbox(rect, text_insert) def test_3916(): doc = pymupdf.open() rect = pymupdf.Rect(100, 100, 101, 101) # Too small for the text. page = doc.new_page() spare_height, scale = page.insert_htmlbox(rect, "Hello, World!", scale_low=0.5) assert spare_height == -1 def test_4400(): with pymupdf.open() as document: page = document.new_page() writer = pymupdf.TextWriter(page.rect) text = '111111111' print(f'Calling writer.fill_textbox().', flush=1) writer.fill_textbox(rect=pymupdf.Rect(0, 0, 100, 20), pos=(80, 0), text=text, fontsize=8) def test_4613(): print() text = 3 * 'abcdefghijklmnopqrstuvwxyz\nABCDEFGHIJKLMNOPQRSTUVWXYZ\n' story = pymupdf.Story(text) rect = pymupdf.Rect(10, 10, 100, 100) # Test default operation where we get additional scaling down because of # the long words in our text. print(f'test_4613(): ### Testing default operation.') with pymupdf.open() as doc: page = doc.new_page() spare_height, scale = page.insert_htmlbox(rect, story) print(f'test_4613(): {spare_height=} {scale=}') # The additional down-scaling from the long word widths results in # spare vertical space. page.draw_rect(rect, (1, 0, 0)) path = os.path.normpath(f'{__file__}/../../tests/test_4613.pdf') doc.save(path) path_pixmap = os.path.normpath(f'{__file__}/../../tests/test_4613.png') path_pixmap_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4613.png') pixmap = page.get_pixmap(dpi=300) pixmap.save(path_pixmap) pixmap_diff = gentle_compare.pixmaps_diff(path_pixmap_expected, pixmap) pixmap_diff.save(os.path.normpath(f'{__file__}/../../tests/test_4613-diff.png')) rms = gentle_compare.pixmaps_rms(pixmap, path_pixmap_expected) print(f'{rms=}') assert rms == 0, f'{rms=}' assert abs(spare_height - 45.7536) < 0.1 assert abs(scale - 0.4009) < 0.01 new_text = page.get_text('text', clip=rect) print(f'test_4613(): new_text:') print(textwrap.indent(new_text, ' ')) assert new_text == text # Check with _scale_word_width=False - ignore too-wide words. print(f'test_4613(): ### Testing with _scale_word_width=False.') with pymupdf.open() as doc: page = doc.new_page() spare_height, scale = page.insert_htmlbox(rect, story, _scale_word_width=False) print(f'test_4613(): _scale_word_width=False: {spare_height=} {scale=}') # With _scale_word_width=False we allow long words to extend beyond the # rect, so we should have spare_height == 0 and only a small amount of # down-scaling. assert spare_height == 0 assert abs(scale - 0.914) < 0.01 new_text = page.get_text('text', clip=rect) print(f'test_4613(): new_text:') print(textwrap.indent(new_text, ' ')) assert new_text == textwrap.dedent(''' abcdefghijklmno ABCDEFGHIJKLM abcdefghijklmno ABCDEFGHIJKLM abcdefghijklmno ABCDEFGHIJKLM ''')[1:] # Check that we get no fit if scale_low is not low enough. print(f'test_4613(): ### Testing with scale_low too high to allow a fit.') with pymupdf.open() as doc: page = doc.new_page() scale_low=0.6 spare_height, scale = page.insert_htmlbox(rect, story, scale_low=scale_low) print(f'test_4613(): {scale_low=}: {spare_height=} {scale=}') assert spare_height == -1 assert scale == scale_low ================================================ FILE: tests/test_textextract.py ================================================ """ Extract page text in various formats. No checks performed - just contribute to code coverage. """ import os import platform import sys import textwrap import pymupdf import gentle_compare pymupdfdir = os.path.abspath(f'{__file__}/../..') scriptdir = f'{pymupdfdir}/tests' filename = os.path.join(scriptdir, "resources", "symbol-list.pdf") def test_extract1(): doc = pymupdf.open(filename) page = doc[0] text = page.get_text("text") blocks = page.get_text("blocks") words = page.get_text("words") d1 = page.get_text("dict") d2 = page.get_text("json") d3 = page.get_text("rawdict") d3 = page.get_text("rawjson") text = page.get_text("html") text = page.get_text("xhtml") text = page.get_text("xml") rects = pymupdf.get_highlight_selection(page, start=page.rect.tl, stop=page.rect.br) text = pymupdf.ConversionHeader("xml") text = pymupdf.ConversionTrailer("xml") def _test_extract2(): import sys import time path = f'{scriptdir}/../../PyMuPDF-performance/adobe.pdf' if not os.path.exists(path): print(f'test_extract2(): not running because does not exist: {path}') return doc = pymupdf.open( path) for opt in ( 'dict', 'dict2', 'text', 'blocks', 'words', 'html', 'xhtml', 'xml', 'json', 'rawdict', 'rawjson', ): for flags in None, pymupdf.TEXTFLAGS_TEXT: t0 = time.time() for page in doc: page.get_text(opt, flags=flags) t = time.time() - t0 print(f't={t:.02f}: opt={opt} flags={flags}') sys.stdout.flush() def _test_extract3(): import sys import time path = f'{scriptdir}/../../PyMuPDF-performance/adobe.pdf' if not os.path.exists(path): print(f'test_extract3(): not running because does not exist: {path}') return doc = pymupdf.open( path) t0 = time.time() for page in doc: page.get_text('json') t = time.time() - t0 print(f't={t}') sys.stdout.flush() def test_extract4(): ''' Rebased-specific. ''' if not hasattr(pymupdf, 'mupdf'): return path = f'{pymupdfdir}/tests/resources/2.pdf' document = pymupdf.open(path) page = document[4] out = 'test_stext.html' text = page.get_text('html') with open(out, 'w') as f: f.write(text) print(f'Have written to: {out}') out = 'test_extract.html' writer = pymupdf.mupdf.FzDocumentWriter( out, 'html', pymupdf.mupdf.FzDocumentWriter.OutputType_DOCX, ) device = pymupdf.mupdf.fz_begin_page(writer, pymupdf.mupdf.fz_bound_page(page)) pymupdf.mupdf.fz_run_page(page, device, pymupdf.mupdf.FzMatrix(), pymupdf.mupdf.FzCookie()) pymupdf.mupdf.fz_end_page(writer) pymupdf.mupdf.fz_close_document_writer(writer) print(f'Have written to: {out}') def get_text(page, space_guess): buffer_ = pymupdf.mupdf.FzBuffer( 10) out = pymupdf.mupdf.FzOutput( buffer_) writer = pymupdf.mupdf.FzDocumentWriter( out, f'text,space-guess={space_guess}', pymupdf.mupdf.FzDocumentWriter.OutputType_DOCX, ) device = pymupdf.mupdf.fz_begin_page(writer, pymupdf.mupdf.fz_bound_page(page)) pymupdf.mupdf.fz_run_page(page, device, pymupdf.mupdf.FzMatrix(), pymupdf.mupdf.FzCookie()) pymupdf.mupdf.fz_end_page(writer) pymupdf.mupdf.fz_close_document_writer(writer) text = buffer_.fz_buffer_extract() text = text.decode('utf8') n = text.count(' ') print(f'{space_guess=}: {n=}') return text, n page = document[4] text0, n0 = get_text(page, 0) text1, n1 = get_text(page, 0.5) text2, n2 = get_text(page, 0.001) text2, n2 = get_text(page, 0.1) text2, n2 = get_text(page, 0.3) text2, n2 = get_text(page, 0.9) text2, n2 = get_text(page, 5.9) assert text1 == text0 def test_2954(): ''' Check handling of unknown unicode characters, issue #2954, fixed in mupdf-1.23.9 with addition of FZ_STEXT_USE_CID_FOR_UNKNOWN_UNICODE. ''' path = os.path.abspath(f'{__file__}/../../tests/resources/test_2954.pdf') flags0 = (0 | pymupdf.TEXT_PRESERVE_WHITESPACE | pymupdf.TEXT_PRESERVE_LIGATURES | pymupdf.TEXT_MEDIABOX_CLIP ) document = pymupdf.Document(path) expected_good = ( "IT-204-IP (2021) Page 3 of 5\nNYPA2514 12/06/21\nPartner's share of \n" " modifications (see instructions)\n20\n State additions\nNumber\n" "A ' Total amount\nB '\n State allocated amount\n" "EA '\n20a\nEA '\n20b\nEA '\n20c\nEA '\n20d\nEA '\n20e\nEA '\n20f\n" "Total addition modifications (total of column A, lines 20a through 20f)\n" ". . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . \n" "21\n21\n22\n State subtractions\n" "Number\nA ' Total amount\nB '\n State allocated amount\n" "ES '\n22a\nES '\n22b\nES '\n22c\nES '\n22d\nES '\n22e\nES '\n22f\n23\n23\n" "Total subtraction modifications (total of column A, lines 22a through 22f). . . . . . . . . . . . . . . . . . . . . . . . . . . . \n" "Additions to itemized deductions\n24\nAmount\n" "Letter\n" "24a\n24b\n24c\n24d\n24e\n24f\n" "Total additions to itemized deductions (add lines 24a through 24f)\n" ". . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . \n" "25\n25\n" "Subtractions from itemized deductions\n" "26\nLetter\nAmount\n26a\n26b\n26c\n26d\n26e\n26f\n" "Total subtractions from itemized deductions (add lines 26a through 26f) . . . . . . . . . . . . . . . . . . . . . . . . . . . . \n" "27\n27\n" "This line intentionally left blank. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . \n" "28\n28\n118003213032\n" ) def check_good(text): ''' Returns true if `text` is approximately the same as `expected_good`. 2024-01-09: MuPDF master and 1.23.x give slightly different 'good' output, differing in a missing newline. So we compare without newlines. ''' return text.replace('\n', '') == expected_good.replace('\n', '') n_fffd_good = 0 n_fffd_bad = 749 def get(flags=None): text = [page.get_text(flags=flags) for page in document] assert len(text) == 1 text = text[0] n_fffd = text.count(chr(0xfffd)) if 0: # This print() fails on Windows with UnicodeEncodeError. print(f'{flags=} {n_fffd=} {text=}') return text, n_fffd text_none, n_fffd_none = get() text_0, n_fffd_0 = get(flags0) text_1, n_fffd_1 = get(flags0 | pymupdf.TEXT_USE_CID_FOR_UNKNOWN_UNICODE) assert n_fffd_none == n_fffd_good assert n_fffd_0 == n_fffd_bad assert n_fffd_1 == n_fffd_good assert check_good(text_none) assert not check_good(text_0) assert check_good(text_1) def test_3027(): path = path = f'{pymupdfdir}/tests/resources/2.pdf' doc = pymupdf.open(path) page = doc[0] textpage = page.get_textpage() pymupdf.utils.get_text(page=page, option="dict", textpage=textpage)["blocks"] def test_3186(): # codespell:ignore-begin texts_expected = [ "Assicurazione sulla vita di tipo Unit Linked\nDocumento informativo precontrattuale aggiuntivo\nper i prodotti d\x00investimento assicurativi\n(DIP aggiuntivo IBIP)\nImpresa: AXA MPS Financial DAC \nProdotto: Progetto Protetto New - Global Dividends\nContratto Unit linked (Ramo III)\nData di realizzazione: Aprile 2023\nIl presente documento contiene informazioni aggiuntive e complementari rispetto a quelle presenti nel documento \ncontenente le informazioni chiave per i prodotti di investimento assicurativi (KID) per aiutare il potenziale \ncontraente a capire più nel dettaglio le caratteristiche del prodotto, gli obblighi contrattuali e la situazione \npatrimoniale dell\x00impresa.\nIl Contraente deve prendere visione delle condizioni d\x00assicurazione prima della sottoscrizione del Contratto.\nAXA MPS Financial DAC, Wolfe Tone House, Wolfe Tone Street, Dublin, DO1 HP90, Irlanda; Tel: 00353-1-6439100; \nsito internet: www.axa-mpsfinancial.ie; e-mail: supporto@axa-mpsfinancial.ie;\nAXA MPS Financial DAC, società del Gruppo Assicurativo AXA Italia, iscritta nell\x00Albo delle Imprese di assicurazione \ncon il numero II.00234. \nLa Compagnia mette a disposizione dei clienti i seguenti recapiti per richiedere eventuali informazioni sia in merito alla \nCompagnia sia in relazione al contratto proposto: Tel: 00353-1-6439100; sito internet: www.axa-mpsfinancial.ie; \ne-mail: supporto@axa-mpsfinancial.ie;\nAXA MPS Financial DAC è un\x00impresa di assicurazione di diritto Irlandese, Sede legale 33 Sir John Rogerson's Quay, \nDublino D02 XK09 Irlanda. L\x00Impresa di Assicurazione è stata autorizzata all\x00esercizio dell\x00attività assicurativa con \nprovvedimento n. C33602 emesso dalla Central Bank of Ireland (l\x00Autorità di vigilanza irlandese) in data 14/05/1999 \ned è iscritta in Irlanda presso il Companies Registration Office (registered nr. 293822). \nLa Compagnia opera in Italia esclusivamente in regime di libera prestazione di servizi ai sensi dell\x00art. 24 del D. Lgs. \n07/09/2005, n. 209 e può investire in attivi non consentiti dalla normativa italiana in materia di assicurazione sulla \nvita, ma in conformità con la normativa irlandese di riferimento in quanto soggetta al controllo della Central Bank of \nIreland.\nCon riferimento all\x00ultimo bilancio d\x00esercizio (esercizio 2021) redatto ai sensi dei principi contabili vigenti, il patrimonio \nnetto di AXA MPS Financial DAC ammonta a 139,6 milioni di euro di cui 635 mila euro di capitale sociale interamente \nversato e 138,9 milioni di euro di riserve patrimoniali compreso il risultato di esercizio.\nAl 31 dicembre 2021 il Requisito patrimoniale di solvibilità è pari a 90 milioni di euro (Solvency Capital Requirement, \nSCR). Sulla base delle valutazioni effettuate della Compagnia coerentemente con gli esistenti dettami regolamentari, il \nRequisito patrimoniale minimo al 31 dicembre 2021 ammonta a 40 milioni di euro (Minimum Capital Requirement, \nMCR).\nL'indice di solvibilità di AXA MPS Financial DAC, ovvero l'indice che rappresenta il rapporto tra l'ammontare del margine \ndi solvibilità disponibile e l'ammontare del margine di solvibilità richiesto dalla normativa vigente, e relativo all'ultimo \nbilancio approvato, è pari al 304% (solvency ratio). L'importo dei fondi propri ammissibili a copertura dei requisiti \npatrimoniali è pari a 276 milioni di euro (Eligible Own Funds, EOF).\nPer informazioni patrimoniali sulla società è possibile consultare il sito: www.axa-mpsfinancial.ie/chi-siamo\nSi rinvia alla relazione sulla solvibilità e sulla condizione finanziaria dell\x00impresa (SFCR) disponibile sul sito internet \ndella Compagnia al seguente link www.axa-mpsfinancial.ie/comunicazioni \nAl contratto si applica la legge italiana\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 1 di 9\n", "Quali sono le prestazioni?\nIl contratto prevede le seguenti prestazioni:\na)Prestazioni in caso di vita dell'assicurato\nPrestazione in caso di Riscatto Totale e parziale\nA condizione che siano trascorsi almeno 30 giorni dalla Data di Decorrenza (conclusione del Contratto) e fino all\x00ultimo \nGiorno Lavorativo della terzultima settimana precedente la data di scadenza, il Contraente può riscuotere, interamente \no parzialmente, il Valore di Riscatto. In caso di Riscatto totale, la liquidazione del Valore di Riscatto pone fine al \nContratto con effetto dalla data di ricezione della richiesta.\nIl Contraente ha inoltre la facoltà di esercitare parzialmente il diritto di Riscatto, nella misura minima di 500,00 euro, \nda esercitarsi con le stesse modalità previste per il Riscatto totale. In questo caso, il Contratto rimane in vigore per \nl\x00ammontare residuo, a condizione che il Controvalore delle Quote residue del Contratto non sia inferiore a 1.000,00 \neuro.\nb) Prestazione a Scadenza\nAlla data di scadenza, sempre che l\x00Assicurato sia in vita, l\x00Impresa di Assicurazione corrisponderà agli aventi diritto un \nammontare risultante dal Controvalore delle Quote collegate al Contratto alla scadenza, calcolato come prodotto tra il \nValore Unitario della Quota (rilevato in corrispondenza della data di scadenza) e il numero delle Quote attribuite al \nContratto alla medesima data.\nc) Prestazione in corso di Contratto\nPurché l\x00assicurato sia in vita, nel corso della durata del Contratto, il Fondo Interno mira alla corresponsione di due \nPrestazioni Periodiche. Le prestazioni saranno pari all\x00ammontare risultante dalla moltiplicazione tra il numero di Quote \nassegnate al Contratto il primo giorno Lavorativo della settimana successiva alla Data di Riferimento e 2,50% del \nValore Unitario della Quota registrato alla Data di istituzione del Fondo Interno.\nLe prestazioni verranno liquidate entro trenta giorni dalle Date di Riferimento.\nData di Riferimento\n 1° Prestazione Periodica\n24/04/2024\n 2° Prestazione Periodica\n23/04/2025\nLa corresponsione delle Prestazioni Periodiche non è collegata alla performance positiva o ai ricavi incassati dal Fondo \nInterno, pertanto, la corresponsione potrebbe comportare una riduzione del Controvalore delle Quote senza comportare \nalcuna riduzione del numero di Quote assegnate al Contratto.\nd) Prestazione assicurativa principale in caso di decesso dell'Assicurato\nIn caso di decesso dell\x00Assicurato nel corso della durata contrattuale, è previsto il pagamento ai Beneficiari di un \nimporto pari al Controvalore delle Quote attribuite al Contratto, calcolato come prodotto tra il Valore Unitario della \nQuota rilevato alla Data di Valorizzazione della settimana successiva alla data in cui la notifica di decesso \ndell\x00Assicurato perviene all\x00Impresa di Assicurazione e il numero delle Quote attribuite al Contratto alla medesima data, \nmaggiorato di una percentuale pari allo 0,1%.\nQualora il capitale così determinato fosse inferiore al Premio pagato, sarà liquidato un ulteriore importo pari alla \ndifferenza tra il Premio pagato, al netto della parte di Premio riferita a eventuali Riscatti parziali e l\x00importo caso morte \ncome sopra determinato. Tale importo non potrà essere in ogni caso superiore al 5% del Premio pagato.\nOpzioni contrattuali\nIl Contratto non prevede opzioni contrattuali.\nFondi Assicurativi\nLe prestazioni di cui sopra sono collegate, in base all\x00allocazione del premio come descritto alla sezione \x01Quando e \ncome devo pagare?\x02, al valore delle quote del Fondo Interno denominato PP27 Global Dividends.\nil Fondo interno mira al raggiungimento di un Obiettivo di Protezione del Valore Unitario di Quota, tramite il \nconseguimento di un Valore Unitario di Quota a scadenza almeno pari al 100% del valore di quota registrato alla Data \ndi istituzione dal Fondo Interno.\nIl regolamento di gestione del Fondo Interno è disponibile sul sito dell\x00Impresa di Assicurazione \nwww.axa-mpsfinancial.ie dove puo essere acquisito su supporto duraturo.\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 2 di 9\n", 'Che cosa NON è assicurato\nRischi esclusi\nIl rischio di decesso dell\x00Assicurato è coperto qualunque sia la causa, senza limiti territoriali e senza \ntenere conto dei cambiamenti di professione dell\x00Assicurato, ad eccezione dei seguenti casi:\n\x03 il decesso, entro i primi sette anni dalla data di decorrenza del Contratto, dovuto alla sindrome da \nimmunodeficienza acquisita (AIDS) o ad altra patologia ad essa associata;\n\x03 dolo del Contraente o del Beneficiario;\n\x03 partecipazione attiva dell\x00Assicurato a delitti dolosi;\n\x03 partecipazione dell\x00Assicurato a fatti di guerra, salvo che non derivi da obblighi verso lo Stato \nItaliano: in questo caso la garanzia può essere prestata su richiesta del Contraente, alle condizioni \nstabilite dal competente Ministero;\n\x03 incidente di volo, se l\x00Assicurato viaggia a bordo di un aeromobile non autorizzato al volo o con \npilota non titolare di brevetto idoneo e, in ogni caso, se viaggia in qualità di membro \ndell\x00equipaggio;\n\x03 suicidio, se avviene nei primi due anni dalla Data di Decorrenza del Contratto\nCi sono limiti di copertura?\nNon vi sono ulteriori informazioni rispetto al contenuto del KID.\nChe obblighi ho? Quali obblighi ha l\x00Impresa?\nCosa fare in caso \ndi evento?\nDenuncia\nCon riferimento alla liquidazione delle prestazioni dedotte in Contratto, il Contraente o, se del caso, \nil Beneficiario e il Referente Terzo, sono tenuti a recarsi presso la sede dell\x00intermediario presso il \nquale il Contratto è stato sottoscritto ovvero a inviare preventivamente, a mezzo di lettera \nraccomandata con avviso di ricevimento al seguente recapito:\n\x03 AXA MPS Financial DAC\n\x03 Wolfe Tone House, Wolfe Tone Street,\n\x03 Dublin, DO1 HP90 - Ireland\n\x03 Numero Verde: 800.231.187\n\x03 email: supporto@axa-mpsfinancial.ie\ni documenti di seguito elencati per ciascuna prestazione, al fine di consentire all\x00Impresa di \nAssicurazione di verificare l\x00effettiva esistenza dell\x00obbligo di pagamento.\nin caso di Riscatto totale, il Contraente deve inviare all\x00Impresa di Assicurazione:\n\x04 la richiesta di Riscatto totale firmata dal Contraente, indicando il conto corrente su cui il \npagamento deve essere effettuato. Nel caso il conto corrente sia intestato a persona diversa dal \nContraente o dai beneficiari o sia cointestato, il Contraente deve fornire anche I documenti del \ncointestatario e specificare la relazione con il terzo il cui conto viene indicato.\n\x04 copia di un valido documento di identità del Contraente o di un documento attestante i poteri di \nlegale rappresentante, nel caso in cui il Contraente sia una persona giuridica;\nin caso di Riscatto parziale, il Contraente deve inviare all\x00Impresa di Assicurazione:\n\x04 la richiesta di Riscatto parziale firmata dal Contraente, contenente l\x00indicazione dei Fondi \nInterni/OICR che intende riscattare e il relativo ammontare non ché l\x00indicazione del conto corrente \nbancario sul quale effettuare il pagamento;\n\x04 copia di un valido documento di identità del Contraente, o di un documento attestante i poteri di \nlegale rappresentante, nel caso in cui il Contraente sia una persona giuridica.\nIn caso di richiesta di Riscatto totale o parziale non corredata dalla sopra elencata documentazione, \nl\x00Impresa di Assicurazione effettuerà il disinvestimento delle Quote collegate al Contratto alla data \ndi ricezione della relativa richiesta. L\x00Impresa di Assicurazione provvederà tuttavia alla liquidazione \ndelle somme unicamente al momento di ricezione della documentazione mancante, prive degli \neventuali interessi che dovessero maturare;\nIn caso di decesso dell\x00Assicurato, il Beneficiario/i o il Referente Terzo deve inviare all\x00Impresa di \nAssicurazione:\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 3 di 9\n', '\x04 la richiesta di pagamento sottoscritta da tutti i Beneficiari, con l\x00indicazione del conto corrente \nbancario sul quale effettuare il pagamento; Nel caso il conto corrente sia intestato a persona \ndiversa dal Contraente o dai beneficiari o sia cointestato, il Contraente deve fornire anche I \ndocumenti del cointestatario e specificare la relazione con il terzo il cui conto viene indicato.\n\x04 copia di un valido documento d\x00identità dei Beneficiari o di un documento attestante i poteri di \nlegale rappresentante, nel caso in cui il Beneficiario sia una persona giuridica;\n\x04 il certificato di morte dell\x00Assicurato;\n\x04 la relazione medica sulle cause del decesso;\n\x04 copia autenticata del testamento accompagnato da dichiarazione sostitutiva di atto di notorietà \ncon l\x00indicazione (i) della circostanza che il testamento è l\x00ultimo da considerarsi valido e non è \nstato impugnato e (ii) degli eredi testamentari, le relative età e capacità\ndi agire;\n\x04 in assenza di testamento, atto notorio (o dichiarazione sostitutiva di atto di notorietà) attestante \nche il decesso è avvenuto senza lasciare testamento e che non vi sono altri soggetti cui la legge \nriconosce diritti o quote di eredità;\n\x04 decreto del Giudice Tutelare nel caso di Beneficiari di minore età, con l\x00indicazione della persona \ndesignata alla riscossione;\n\x04 copia del Questionario KYC.\nPrescrizione: Alla data di redazione del presente documento, i diritti dei beneficiari dei contratti di \nassicurazione sulla vita si prescrivono nel termine di dieci anni dal giorno in cui si è verificato il fatto \nsu cui il diritto si fonda. Decorso tale termine e senza che la Compagnia abbia ricevuto alcuna \ncomunicazione e/o disposizione, gli importi derivanti dal contratto saranno devoluti al Fondo \ncostitutivo presso il Ministero dell\x00Economia e delle Finanze \x01depositi dormienti\x02.\nErogazione della prestazione\nL\x00Impresa di Assicurazione esegue il pagamento entro trenta giorni dal ricevimento della \ndocumentazione completa all\x00indirizzo sopra indicato.\n \nLe dichiarazioni del Contraente, e dell\x00Assicurato se diverso dal Contraente, devono essere esatte e \nveritiere. In caso di dichiarazioni inesatte o reticenti relative a circostanze tali che l\x00Impresa di \nAssicurazione non avrebbe dato il suo consenso, non lo avrebbe dato alle medesime condizioni se \navesse conosciuto il vero stato delle cose, l\x00Impresa di Assicurazione ha diritto a:\na) in caso di dolo o colpa grave:\n\x04 impugnare il Contratto dichiarando al Contraente di voler esercitare tale diritto entro tre mesi dal \ngiorno in cui ha conosciuto l\x00inesattezza della dichiarazione o le reticenze;\n\x04 trattenere il Premio relativo al periodo di assicurazione in corso al momento dell\x00impugnazione e, \nin ogni caso, il Premio corrispondente al primo anno;\n\x04 restituire, in caso di decesso dell\x00Assicurato, solo il Controvalore delle Quote acquisite al \nmomento del decesso, se l\x00evento si verifica prima che sia decorso il termine dianzi indicato per \nl\x00impugnazione;\nb) ove non sussista dolo o colpa grave:\n\x04 recedere dal Contratto, mediante dichiarazione da farsi al Contraente entro tre mesi dal giorno in \ncui ha conosciuto l\x00inesattezza della dichiarazione o le reticenze;\n\x04 se il decesso si verifica prima che l\x00inesattezza della dichiarazione o la reticenza sia conosciuta \ndall\x00Impresa di Assicurazione, o prima che l\x00Impresa abbia dichiarato di recedere dal Contratto, di \nridurre la somma dovuta in proporzione alla differenza tra il Premio convenuto e quello che sarebbe \nstato applicato se si fosse conosciuto il vero stato delle cose.\nIl Contraente è tenuto a inoltrare per iscritto alla Compagnia (posta ordinaria e mail) eventuali \ncomunicazioni inerenti:\n-modifiche dell\x00indirizzo presso il quale intende ricevere le comunicazioni relative al contratto;\n-variazione della residenza Europea nel corso della durata del contratto, presso altro Paese \nmembro della Unione Europea;\n-variazione degli estremi di conto corrente bancario.\nIn tal caso è necessario inoltrare la richiesta attraverso l\x00invio del modulo del mandato, compilato e \nsottoscritto dal contraente, reperibile nella sezione \x01comunicazioni\x02 sul sito internet della \ncompagnia all\x00indirizzo www.axa-mpsfinancial.ie\nFATCA (Foreign Account Tax Compliance Act) e CRS (Common Standard Reporting)\nLa normativa denominata rispettivamente FATCA (Foreign Account Tax Compliance Act - \nIntergovernmental Agreement sottoscritto tra Italia e Stati Uniti in data 10 gennaio 2014 e Legge n. \n95 del 18 giugno 2015) e CRS (Common Reporting Standard - Decreto Ministeriale del 28 \ndicembre 2015) impone agli operatori commerciali, al fine di contrastare la frode fiscale e \nl\x00evasione fiscale transfrontaliera, di eseguire la puntuale identificazione della propria clientela al \nfine di determinarne l\x00effettivo status di contribuente estero.\nDichiarazioni \ninesatte o \nreticenti\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 4 di 9\n', "I dati anagrafici e patrimoniali dei Contraenti identificati come fiscalmente residenti negli USA e/o \nin uno o più Paesi aderenti al CRS, dovranno essere trasmessi all\x00autorità fiscale locale, tramite \nl\x00Agenzia delle Entrate.\nL\x00identificazione avviene in fase di stipula del contratto e deve essere ripetuta in caso di \ncambiamento delle condizioni originarie durante tutta la sua durata, mediante l\x00acquisizione di \nautocertificazione rilasciata dai Contraenti. Ogni contraente è tenuto a comunicare \ntempestivamente eventuali variazioni rispetto a quanto dichiarato o rilevato in fase di sottoscrizione \ndel contratto di assicurazione. La Società si riserva inoltre di verificare i dati raccolti e di richiedere \nulteriori informazioni. In caso di autocertificazione che risulti compilata parzialmente o in maniera \nerrata, nonché in caso di mancata/non corretta comunicazione dei propri dati anagrafici, la società \nqualora abbia rilevato indizi di americanità e/o residenze fiscali estere nelle informazioni in suo \npossesso, assocerà al cliente la condizione di contribuente estero, provvedendo alla comunicazione \ndovuta.\nAntiriciclaggio\nIl Contraente è tenuto a fornire alla Compagnia tutte le informazioni necessarie al fine \ndell\x00assolvimento dell\x00adeguata verifica ai fini antiriciclaggio. Qualora la Compagnia, in ragione \ndella mancata collaborazione del Contraente, non sia in grado di portare a compimento l\x00adeguata \nverifica, la stessa non potrà concludere il Contratto o dovrà porre fine allo stesso. In tali ipotesi le \nsomme dovute al Contraente dovranno essere allo stesso versate mediante bonifico a valere un \nconto corrente intestato al Contraente stesso. In tali ipotesi le disponibilità finanziarie \neventualmente già acquisite dalla Compagnia dovranno essere restituite al Contraente liquidando il \nrelativo importo tramite bonifico bancario su un conto corrente bancario indicato dal Contraente e \nallo stesso intestato.\nIn nessun caso l'Impresa di Assicurazione sarà tenuta a fornire alcuna copertura assicurativa, \nsoddisfare richieste di risarcimento o garantire alcuna indennità in virtù del presente contratto, \nqualora tale copertura, pagamento o indennità possa esporla a divieti, sanzioni economiche o \nrestrizioni ai sensi di Risoluzioni delle Nazioni Unite o sanzioni economiche o commerciali, leggi o \nnorme dell\x00Unione Europea, del Regno Unito o degli Stati Uniti d\x00America, ove applicabili in Italia.\nQuando e come devo pagare?\nPremio\nIl Contratto prevede il pagamento di un Premio Unico il cui ammontare minimo è pari a 2.500,00 \neuro, incrementabile di importo pari o in multiplo di 50,00 euro, da corrispondersi in un\x00unica \nsoluzione prima della conclusione del Contratto.\nNon è prevista la possibilità di effettuare versamenti aggiuntivi successivi.\nIl versamento del Premio Unico può essere effettuato mediante addebito su conto corrente \nbancario, indicato nel Modulo di Proposta, previa autorizzazione del titolare del conto corrente.\nIl pagamento dei Premio Unico può essere eseguito mediante addebito su conto corrente bancario, \nprevia autorizzazione, intestato al Contraente oppure tramite bonifico bancario sul conto corrente \ndell\x00Impresa di Assicurazione.\nRimborso\nIl rimborso del Premio Versato è previsto nel caso in cui il Contraente decida di revocare la proposta \nfinché il contratto non è concluso.\nSconti\nAl verificarsi di condizioni particolari ed eccezionali che potrebbero riguardare \x03 a titolo \nesemplificativo ma non esaustivo \x03 il Contraente e la relativa situazione assicurativo/finanziaria, \nl\x00ammontare del Premio pagato e gli investimenti selezionati dal Contraente, l\x00Impresa di \nAssicurazione si riserva la facoltà di applicare sconti sugli oneri previsti dal contratto, concordando \ntale agevolazione con il Contraente.\nQuando comincia la copertura e quando finisce?\nDurata\nIl Contratto ha una durata massima pari a 5 anni 11 mesi e 27 giorni, sino alla data di scadenza \n(11/04/2029, la \x01data di scadenza\x02).\nSospensione\nNon sono possibili delle sospensioni della copertura assicurativa\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 5 di 9\n", 'Come posso revocare la proposta, recedere dal contratto o risolvere il contratto? \nRevoca\nLa Proposta di assicurazione può essere revocata fino alle ore 24:00 del giorno in cui il Contratto è \nconcluso. In tal caso, l\x00Impresa di Assicurazione restituirà al Contraente il Premio pagato entro \ntrenta giorni dal ricevimento della comunicazione di Revoca.\nRecesso\nIl Contraente può recedere dal Contratto entro trenta giorni dalla sua conclusione. Il Recesso dovrà \nessere comunicato all\x00Impresa di Assicurazione mediante lettera raccomandata con avviso di \nricevimento.\nL\x00Impresa di Assicurazione, entro trenta giorni dal ricevimento della comunicazione relativa al \nRecesso, rimborserà al Contraente il Controvalore delle Quote attribuite al Contratto alla data di \nricevimento della richiesta di recesso incrementato dai caricamenti, ove previsti, e dedotte \neventuali agevolazioni.\nRisoluzione\nLa risoluzione del contratto è prevista tramite la richiesta di riscatto totale esercitabile in qualsiasi \nmomento della durata contrattuale\nSono previsti riscatti o riduzioni? Si\n no\nValori di\nriscatto e\nriduzione\nA condizione che siano trascorsi almeno 30 giorni dalla Data di Decorrenza (conclusione del \nContratto) e fino all\x00ultimo Giorno Lavorativo della terzultima settimana precedente la data di \nscadenza, il Contraente può riscuotere, interamente o parzialmente, il Valore di Riscatto. In caso di \nRiscatto totale, la liquidazione del Valore di Riscatto pone fine al Contratto con effetto dalla data di \nricezione della richiesta.\nL\x00importo che sarà corrisposto al Contraente in caso di Riscatto sarà pari al Controvalore delle \nQuote del Fondo Interno attribuite al Contratto alla data di Riscatto, al netto dei costi di Riscatto.\nIn caso di Riscatto, ai fini del calcolo del Valore Unitario della Quota, si farà riferimento alla Data di \nValorizzazione della settimana successiva alla data in cui la comunicazione di Riscatto del \nContraente perviene all\x00Impresa di Assicurazione, corredata di tutta la documentazione, al netto dei \ncosti di Riscatto, salvo il verificarsi di Eventi di Turbativa.\nIl Contraente assume il rischio connesso all\x00andamento negativo del valore delle Quote e, pertanto, \nesiste la possibilità di ricevere un ammontare inferiore all\x00investimento finanziario.\nIn caso di Riscatto del Contratto (totale o parziale), l\x00Impresa di Assicurazione non offre alcuna \ngaranzia finanziaria di rendimento minimo e pertanto il Contraente sopporta il rischio di ottenere un \nValore Unitario di Quota inferiore al 100% del Valore Unitario di Quota del Fondo Interno registrato \nalla Data di Istituzione in considerazione dei rischi connessi alla fluttuazione del valore di mercato \ndegli attivi in cui investe, direttamente o indirettamente, il Fondo Interno.\nRichiesta di\ninformazioni\nPer eventuali richieste di informazioni sul valore di riscatto, il Contraente può rivolgersi alla \nCompagnia AXA MPS Financial DAC \x03 Wolfe Tone House, Wolfe Tone Street, Dublin, DO1 HP90 \x03 \nIreland, Numero Verde 800.231.187, e-mail: supporto@axa-mpsfinancial.ie\nA chi è rivolto questo prodotto?\nL\x00investitore al dettaglio a cui è destinato il prodotto varia in funzione dell\x00opzione di investimento sottostante e \nillustrata nel relativo KID.\nIl prodotto è indirizzato a Contraenti persone fisiche e persone giuridiche a condizione che il Contraente (persona fisica) \ne l\x00Assicurato, al momento della sottoscrizione stessa, abbiano un\x00età compresa tra i 18 anni e i 85 anni.\nQuali costi devo sostenere?\nPer l\x00informativa dettagliata sui costi fare riferimento alle indicazioni del KID.\nIn aggiunta rispetto alle informazioni del KID , indicare i seguenti costi a carico del contraente.\nSpese di emissione:\nIl Contratto prevede una spesa fissa di emissione pari a 25 Euro.\nLa deduzione di tale importo avverrà contestualmente alla deduzione del premio.\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 6 di 9\n', "L\x00obiettivo di protezione è da considerarsi al netto delle spese di emissione.\nCosti per riscatto\nIl Riscatto (totale e parziale) prevede un costo che varia in funzione della data di richiesta e secondo le percentuali di \nseguito indicate:\n1°Anno 5,00%; 2°Anno 3,50%; 3°Anno 2,00%; dal quarto anno in poi 0%;\nCosti di intermediazione\nla quota parte massima percepita dall\x00intermediario con riferimento all\x00intero flusso commissionale relativo al prodotto \nè pari al 35,17%.\nQuali sono i rischi e qual è il potenziale rendimento?\nSia con riferimento alla prestazione in caso di vita dell\x00assicurato, sia con riferimento al capitale caso morte riferito ai \nFondi Assicurativi Interni, la Compagnia non presta alcuna garanzia di rendimento minimo o di conservazione del \ncapitale. Pertanto il controvalore della prestazione della Compagnia potrebbe essere inferiore all\x00importo dei premi \nversati, in considerazione dei rischi connessi alla fluttuazione del valore di mercato degli attivi in cui investe, \ndirettamente o indirettamente il Fondo Interno.\nCOME POSSO PRESENTARE I RECLAMI E RISOLVERE LE CONTROVERSIE?\nAll\x00IVASS\nNel caso in cui il reclamo presentato all\x00impesa assicuratrice abbia esito insoddisfacente o risposta \ntardiva, è possibile rivolgersi all\x00IVASS, Via del Quirinale, 21 - 00187 Roma, fax 06.42133206, Info \nsu: www.ivass.it.\nEventuali reclami potranno inoltre essere indirizzati all\x00Autorità Irlandese competente al seguente \nindirizzo:\nFinancial Services Ombudsman 3rd Floor, Lincoln House, Lincoln Place, Dublin 2, D02 VH29 \x03 \nIreland\nPRIMA DI RICORRERE ALL\x00AUTORITÀ GIUDIZIARIA è possibile, in alcuni casi necessario, \navvalersi di sistemi alternativi di risoluzione delle controversie, quali:\nMediazione\nInterpellando un Organismo di Mediazione tra quelli presenti nell'elenco del Ministero della \nGiustizia, consultabile sul sito www.giustizia.it (Legge 9/8/2013, n.98)\nNegoziazione \nassistita\nTramite richiesta del proprio avvocato all\x00impresa\nAltri Sistemi \nalternative di \nrisoluzione delle \ncontroversie\nEventuali reclami relativi ad un contratto o servizio assicurativo nei confronti dell'Impresa di \nassicurazione o dell'Intermediario assicurativo con cui si entra in contatto, nonché qualsiasi \nrichiesta di informazioni, devono essere preliminarmente presentati per iscritto (posta, email) ad \nAXA MPS Financial DAC - Ufficio Reclami secondo seguenti modalità:\nEmail: reclami@axa-mpsfinancial.ie\nPosta: AXA MPS Financial DAC - Ufficio Reclami\nWolfe Tone House, Wolfe Tone Street,\nDublin DO1 HP90 - Ireland\nNumero Verde 800.231.187\navendo cura di indicare:\n-nome, cognome, indirizzo completo e recapito telefonico del reclamante;\n-numero della polizza e nominativo del contraente;\n-breve ed esaustiva descrizione del motivo di lamentela;\n-ogni altra indicazione e documento utile per descrivere le circostanze.\nSarà cura della Compagnia fornire risposta entro 45 giorni dalla data di ricevimento del reclamo, \ncome previsto dalla normativa vigente.\nNel caso di mancato o parziale accoglimento del reclamo, nella risposta verrà fornita una chiara \nspiegazione della posizione assunta dalla Compagnia in relazione al reclamo stesso ovvero della \nsua mancata risposta.\nQualora il reclamante non abbia ricevuto risposta oppure ritenga la stessa non soddisfacente, \nprima di rivolgersi all'Autorità Giudiziaria, può scrivere all'IVASS (Via del Quirinale, 21 - 00187 \nRoma; fax 06.42.133.745 o 06.42.133.353, ivass@pec.ivass.it) fornendo copia del reclamo già \nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 7 di 9\n", "inoltrato all'impresa ed il relativo riscontro anche utilizzando il modello presente nel sito dell'IVASS \nalla sezione per il Consumatore - come presentare un reclamo.\nEventuali reclami potranno inoltre essere indirizzati all'Autorità Irlandese competente al seguente \nindirizzo:\nFinancial Services Ombudsman\n3rd Floor, Lincoln House,\nLincoln Place, Dublin 2, D02 VH29 Ireland\nIl reclamante può ricorrere ai sistemi alternativi per la risoluzione delle controversie previsti a livello \nnormativo o convenzionale, quali:\n\x04 Mediazione: (Decreto Legislativo n.28/2010 e ss.mm.) puo' essere avviata presentando istanza \nad un Organismo di Mediazione tra quelle presenti nell'elenco del Ministero della Giustizia, \nconsultabile sul sito www.giustizia.it. La legge ne prevede l'obbligatorieta' nel caso in cui si intenda \nesercitare in giudizio i propri diritti in materia di contratti assicurativi o finanziari e di risarcimento \nda responsabilita' medica e sanitaria, costituendo condizione di procedibilita' della domanda.\n\x04 Negoziazione Assistita: (Legge n.162/2014) tramite richiesta del proprio Avvocato all'Impresa. E' \nun accordo mediante il quale le parti convengono di cooperare in buona fede e con lealta' per \nrisolvere in via amichevole la controversia tramite l'assistenza di avvocati. Fine del procedimento e' \nla composizione bonaria della lite, con la sottoscrizione delle parti - assistite dai rispettivi difensori - \ndi un accordo detto convenzione di negoziazione. Viene prevista la sua obbligatorieta' nel caso in \ncui si intenda esercitare in giudizio i propri diritti per ogni controversia in materia di risarcimento del \ndanno da circolazione di veicoli e natanti, ovverosia e' condizione di procedibilita' per l'eventuale \ngiudizio civile. Invece e' facoltativa per ogni altra controversia in materia di risarcimenti o di contratti \nassicurativi o finanziari.\nIn caso di controversia relativa alla determinazione dei danni si puo' ricorrere alla perizia \ncontrattuale prevista dalle Condizioni di Assicurazione per la risoluzione di tale tipologia di \ncontroversie. L'istanza di attivazione della perizia contrattuale dovra' essere indirizzata alla \nCompagnia all' indirizzo\nAXA MPS Financial DAC \nWolfe Tone House, Wolfe Tone Street\nDublin DO1 HP90 - Ireland\nPer maggiori informazioni si rimanda a quanto presente nell'area Reclami del sito \nwww.axa-mpsfinancial.ie. \nPer la risoluzione delle liti transfrontaliere è possibile presentare reclamo all'IVASS o direttamente \nal sistema estero http://ec.europa.eu/internal_market/fin-net/members_en.htm competente \nchiedendo l'attivazione della procedura FIN-NET.\nEventuali reclami relativi la mancata osservanza da parte della Compagnia, degli intermediari e dei \nperiti assicurativi, delle disposizioni del Codice delle assicurazioni, delle relative norme di \nattuazione nonché delle norme sulla commercializzazione a distanza dei prodotti assicurativi \npossono essere presentati direttamente all'IVASS, secondo le modalità sopra indicate.\nSi ricorda che resta salva la facoltà di adire l'autorità giudiziaria.\nREGIME FISCALE\nTrattamento \nfiscale applicabile \nal contratto\nLe seguenti informazioni sintetizzano alcuni aspetti del regime fiscale applicabile al Contratto, ai \nsensi della legislazione tributaria italiana e della prassi vigente alla data di pubblicazione del \npresente documento, fermo restando che le stesse rimangono soggette a possibili cambiamenti che \npotrebbero avere altresì effetti retroattivi. Quanto segue non intende rappresentare un\x00analisi \nesauriente di tutte le conseguenze fiscali del Contratto. I Contraenti sono tenuti a consultare i loro \nconsulenti in merito al regime fiscale proprio del Contratto.\nTasse e imposte\nLe imposte e tasse presenti e future applicabili per legge al Contratto sono a carico del Contraente \no dei Beneficiari e aventi diritto e non è prevista la corresponsione al Contraente di alcuna somma \naggiuntiva volta a compensare eventuali riduzioni dei pagamenti relativi al Contratto.\nTassazione delle somme corrisposte a soggetti non esercenti attività d\x00impresa\n1. In caso di decesso dell\x00Assicurato\nLe somme corrisposte dall\x00Impresa di Assicurazione in caso di decesso dell\x00Assicurato non sono \nsoggette a tassazione IRPEF in capo al percettore e sono esenti dall\x00imposta sulle successioni. Si \nricorda tuttavia che, per effetto della legge 23 dicembre 2014 n. 190 (c.d.\x02Legge di Stabilità\x02), i \nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 8 di 9\n", 'capitali percepiti in caso di morte, a decorrere dal 1 gennaio 2015, in dipendenza di contratti di \nassicurazione sulla vita, a copertura del rischio demografico, sono esenti dall\x00imposta sul reddito \ndelle persone fisiche.\n2. In caso di Riscatto totale o di Riscatto parziale.\nLe somme corrisposte dall\x05Impresa di Assicurazione in caso di Riscatto totale sono soggette ad \nun\x00imposta sostitutiva dell\x00imposta sui redditi nella misura prevista di volta in volta dalla legge. Tale \nimposta, al momento della redazione del presente documento, è pari al 26% sulla differenza \n(plusvalenza) tra il capitale maturato e l\x00ammontare dei premi versati (al netto di eventuali riscatti \nparziali), con l\x00eccezione dei proventi riferibili ai titoli di stato italiani ed equiparati (Paesi facenti \nparte della white list), per i quali l\x00imposta è pari al 12,5%.\nIn caso di Riscatto parziale, ai fini del computo del reddito di capitale da assoggettare alla predetta \nimposta sostitutiva, l\x00ammontare dei premi va rettificato in funzione del rapporto tra il capitale \nerogato ed il valore economico della polizza alla data del Riscatto parziale.\n3. In caso di Recesso\nLe somme corrisposte in caso di Recesso sono soggette all\x00imposta sostitutiva delle imposte sui \nredditi nella misura e con gli stessi criteri indicati per il Riscatto totale del Contratto.\nTassazione delle somme corrisposte a soggetti esercenti attività d\x00impresa\nLe somme corrisposte a soggetti che esercitano l\x00attività d\x00impresa non costituiscono redditi di \ncapitale, bensì redditi d\x00impresa. Su tali somme l\x00Impresa non applica l\x00imposta sostitutiva di cui \nall\x00art. 26-ter del D.P.R. 29 settembre 1973, n. 600.\nSe le somme sono corrisposte a persone fisiche o enti non commerciali in relazione a contratti \nstipulati nell\x00ambito dell\x00attività commerciale, l\x00Impresa non applica l\x00imposta sostitutiva, qualora gli \ninteressati presentino una dichiarazione in merito alla sussistenza di tale requisito.\nL\x00IMPRESA HA L\x00OBBLIGO DI TRASMETTERTI, ENTRO IL 31 MAGGIO DI OGNI ANNO, IL DOCUMENTO \nUNICO DI RENDICONTAZIONE ANNUALE DELLA TUA POSIZIONE ASSICURATIVA\nPER QUESTO CONTRATTO L\x00IMPRESA NON DISPONE DI UN\x00AREA INTERNET DISPOSITIVA RISERVATA \nAL CONTRAENTE (c.d. HOME INSURANCE), PERTANTO DOPO LA SOTTOSCRIZIONE NON POTRAI \nGESTIRE TELEMATICAMENTE IL CONTRATTO MEDESIMO.\nDIP aggiuntivo IBIP - Progetto Protetto New - Global Dividends - Pag. 9 di 9\n', ] # codespell:ignore-end path = os.path.abspath(f'{__file__}/../../tests/resources/test_3186.pdf') fitz_doc = pymupdf.open(path) texts = list() for page in fitz_doc: t = page.get_text() texts.append(t) assert texts == texts_expected, f'Unexpected output: {texts=}' def test_3197(): ''' MuPDF's ActualText support fixes handling of test_3197.pdf. ''' path = os.path.abspath(f'{__file__}/../../tests/resources/test_3197.pdf') text_utf8_expected = [ b'NYSE - Nasdaq Real Time Price \xe2\x80\xa2 USD\nFord Motor Company (F)\n12.14 -0.11 (-0.90%)\nAt close: 4:00 PM EST\nAfter hours: 7:43 PM EST\nAll numbers in thousands\nAnnual\nQuarterly\nDownload\nSummary\nNews\nChart\nConversations\nStatistics\nHistorical Data\nProfile\nFinancials\nAnalysis\nOptions\nHolders\nSustainability\nInsights\nFollow\n12.15 +0.01 (+0.08%)\nIncome Statement\nBalance Sheet\nCash Flow\nSearch for news, symbols or companies\nNews\nFinance\nSports\nSign in\nMy Portfolio\nNews\nMarkets\nSectors\nScreeners\nPersonal Finance\nVideos\nFinance Plus\nBack to classic\nMore\n', b'Related Tickers\nTTM\n12/31/2023\n12/31/2022\n12/31/2021\n12/31/2020\n14,918,000\n14,918,000\n6,853,000\n15,787,000\n24,269,000\n-17,628,000\n-17,628,000\n-4,347,000\n2,745,000\n-18,615,000\n2,584,000\n2,584,000\n2,511,000\n-23,498,000\n2,315,000\n25,110,000\n25,110,000\n25,340,000\n20,737,000\n25,935,000\n-8,236,000\n-8,236,000\n-6,866,000\n-6,227,000\n-5,742,000\n51,659,000\n51,659,000\n45,470,000\n27,901,000\n65,900,000\n-41,965,000\n-41,965,000\n-45,655,000\n-54,164,000\n-60,514,000\n-335,000\n-335,000\n-484,000\n--\n--\n6,682,000\n6,682,000\n-13,000\n9,560,000\n18,527,000\n \nYahoo Finance Plus Essential\naccess required.\nUnlock Access\nBreakdown\nOperating Cash\nFlow\nInvesting Cash\nFlow\nFinancing Cash\nFlow\nEnd Cash Position\nCapital Expenditure\nIssuance of Debt\nRepayment of Debt\nRepurchase of\nCapital Stock\nFree Cash Flow\n12/31/2020 - 6/1/1972\nGM\nGeneral Motors Compa\xe2\x80\xa6\n39.49 +1.23%\n\xc2\xa0\nRIVN\nRivian Automotive, Inc.\n15.39 -3.15%\n\xc2\xa0\nNIO\nNIO Inc.\n5.97 +0.17%\n\xc2\xa0\nSTLA\nStellantis N.V.\n25.63 +0.91%\n\xc2\xa0\nLCID\nLucid Group, Inc.\n3.7000 +0.54%\n\xc2\xa0\nTSLA\nTesla, Inc.\n194.77 +0.52%\n\xc2\xa0\nTM\nToyota Motor Corporati\xe2\x80\xa6\n227.09 +0.14%\n\xc2\xa0\nXPEV\nXPeng Inc.\n9.08 +0.89%\n\xc2\xa0\nFSR\nFisker Inc.\n0.5579 -11.46%\n\xc2\xa0\nCopyright \xc2\xa9 2024 Yahoo.\nAll rights reserved.\nPOPULAR QUOTES\nTesla\nDAX Index\nKOSPI\nDow Jones\nS&P BSE SENSEX\nSPDR S&P 500 ETF Trust\nEXPLORE MORE\nCredit Score Management\nHousing Market\nActive vs. Passive Investing\nShort Selling\nToday\xe2\x80\x99s Mortgage Rates\nHow Much Mortgage Can You Afford\nABOUT\nData Disclaimer\nHelp\nSuggestions\nSitemap\n', ] num_errors = 0 with pymupdf.open(path) as document: for i, page in enumerate(document): text = page.get_text() text_utf8 = text.encode('utf8') if text_utf8 != text_utf8_expected[i]: num_errors += 1 print(f'Error, {i=}.') import difflib print(f' {text_utf8_expected[i]=}') print(f' {text_utf8=}') text_expected = text_utf8_expected[i].decode('utf8') diff = difflib.unified_diff( text_expected.split('\n'), text.split('\n'), lineterm='', ) print(f'Diff expected => actual:') print(textwrap.indent('\n'.join(diff), ' ')) assert not num_errors, f'{num_errors=}' def test_document_text(): if os.environ.get('PYODIDE_ROOT'): print('test_document_text(): not running on Pyodide - multiprocessing not available.') return import platform import time path = os.path.abspath(f'{__file__}/../../tests/resources/mupdf_explored.pdf') concurrency = None def llen(texts): l = 0 for text in texts: l += len(text) if isinstance(text, str) else text return l results = dict() _stats = 1 print('') method = 'single' t = time.time() document = pymupdf.Document(path) texts0 = pymupdf.get_text(path, _stats=_stats) t0 = time.time() - t print(f'{method}: {t0=} {llen(texts0)=}', flush=1) # Dummy run seems to avoid misleading stats with slow first run. method = 'mp' texts = pymupdf.get_text(path, concurrency=concurrency, method=method, _stats=_stats) method = 'mp' t = time.time() texts = pymupdf.get_text(path, concurrency=concurrency, method=method, _stats=_stats) t = time.time() - t print(f'{method}: {concurrency=} {t=} ({t0/t:.2f}x) {llen(texts)=}', flush=1) assert texts == texts0 if platform.system() != 'Windows': method = 'fork' t = time.time() texts = pymupdf.get_text(path, concurrency=concurrency, method='fork', _stats=_stats) t = time.time() - t print(f'{method}: {concurrency=} {t=} ({t0/t:.2f}x) {llen(texts)=}', flush=1) assert texts == texts0 if _stats: pymupdf._log_items_clear() def test_4524(): if os.environ.get('PYODIDE_ROOT'): print('test_4524(): not running on Pyodide - multiprocessing not available.') return path = os.path.abspath(f'{__file__}/../../tests/resources/mupdf_explored.pdf') print('') document = pymupdf.Document(path) texts_single = pymupdf.get_text(path, method='single', pages=[1, 3, 5]) texts_mp = pymupdf.get_text(path, method='mp', pages=[1, 3, 5]) print(f'{len(texts_single)=}') print(f'{len(texts_mp)=}') assert texts_mp == texts_single def test_3594(): verbose = 0 print() d = pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/test_3594.pdf')) for i, p in enumerate(d.pages()): text = p.get_text() print(f'Page {i}:') if verbose: for line in text.split('\n'): print(f' {line!r}') print('='*40) wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple < (1, 26, 8): assert not wt elif pymupdf.mupdf_version_tuple < (1, 28): assert wt == 'Actualtext with no position. Text may be lost or mispositioned.\n... repeated 2 times...' else: assert wt == 'ActualText with no position. Text may be lost or mispositioned.\n... repeated 2 times...' def test_3687(): path1 = pymupdf.open(os.path.normpath(f'{__file__}/../../tests/resources/test_3687.epub')) path2 = pymupdf.open(os.path.normpath(f'{__file__}/../../tests/resources/test_3687-3.epub')) for path in path1, path2: print(f'Looking at {path=}.') with pymupdf.open(path) as document: page = document[0] text = page.get_text("text") print(f'{text=!s}') wt = pymupdf.TOOLS.mupdf_warnings() print(f'{wt=}') assert wt == 'unknown epub version: 3.0' def test_3705(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3705.pdf') def get_all_page_from_pdf(document, last_page=None): if last_page: document.select(list(range(0, last_page))) if document.page_count > 30: document.select(list(range(0, 30))) return iter(page for page in document) filename = os.path.basename(path) doc = pymupdf.open(path) texts0 = list() for i, page in enumerate(get_all_page_from_pdf(doc)): text = page.get_text() print(i, text) texts0.append(text) texts1 = list() doc = pymupdf.open(path) for page in doc: if page.number >= 30: # leave the iterator immediately break text = page.get_text() texts1.append(text) assert texts1 == texts0 wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 27, 1): expected = '' assert wt == expected elif pymupdf.mupdf_version_tuple >= (1, 27): expected = 'format error: No common ancestor in structure tree\nstructure tree broken, assume tree is missing' expected = '\n'.join([expected] * 56) assert wt == expected elif pymupdf.mupdf_version_tuple >= (1, 26, 8): assert wt == 'Actualtext with no position. Text may be lost or mispositioned.\n... repeated 7684 times...' else: assert wt == 'Actualtext with no position. Text may be lost or mispositioned.\n... repeated 434 times...' def test_3650(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3650.pdf') doc = pymupdf.Document(path) blocks = doc[0].get_text("blocks") t = [block[4] for block in blocks] print(f'{t=}') assert t == [ 'RECUEIL DES ACTES ADMINISTRATIFS\n', 'n° 78 du 28 avril 2023\n', ] def test_4026(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4026.pdf') with pymupdf.open(path) as document: page = document[4] blocks = page.get_text('blocks') for i, block in enumerate(blocks): print(f'block {i}: {block}') if pymupdf.mupdf_version_tuple >= (1, 28): # 2026-05-01: Expect slightly better splitting of text into # paragraphs. assert len(blocks) == 8 else: assert len(blocks) == 5 def test_3725(): # This currently just shows the extracted text. We don't check it is as expected. path = os.path.normpath(f'{__file__}/../../tests/resources/test_3725.pdf') with pymupdf.open(path) as document: page = document[0] text = page.get_text() if 0: print(textwrap.indent(text, ' ')) def test_4147(): print() items = list() for expect_visible, path in ( (False, os.path.normpath(f'{__file__}/../../tests/resources/test_4147.pdf')), (True, os.path.normpath(f'{__file__}/../../tests/resources/symbol-list.pdf')), ): print(f'{expect_visible=} {path=}') with pymupdf.open(path) as document: page = document[0] text = page.get_text('rawdict') for block in text['blocks']: if block['type'] == 0: #print(f' block') for line in block['lines']: #print(f' line') for span in line['spans']: #print(f' span') #print(f' span: {span["flags"]=:#x} {span["char_flags"]=:#x}') if expect_visible: assert span['char_flags'] & pymupdf.mupdf.FZ_STEXT_FILLED else: assert not (span['char_flags'] & pymupdf.mupdf.FZ_STEXT_FILLED) assert not (span['char_flags'] & pymupdf.mupdf.FZ_STEXT_STROKED) # Check commit `add 'bidi' to span dict, add 'synthetic' to char dict.` assert span['bidi'] == 0 for ch in span['chars']: assert isinstance(ch['synthetic'], bool) def test_4139(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4139.pdf') flags = (0 | pymupdf.TEXT_PRESERVE_IMAGES | pymupdf.TEXT_PRESERVE_WHITESPACE | pymupdf.TEXT_USE_CID_FOR_UNKNOWN_UNICODE ) with pymupdf.open(path) as document: page = document[0] dicts = page.get_text('dict', flags=flags, sort=True) seen = set() for b_ctr, b in enumerate(dicts['blocks']): for l_ctr, l in enumerate(b.get('lines', [])): for s_ctr, s in enumerate(l['spans']): color = s.get('color') if color is not None and color not in seen: seen.add(color) print(f"B{b_ctr}.L{l_ctr}.S{s_ctr}: {color=} {hex(color)=} {s=}") assert color == 0, f'{s=}' assert s['alpha'] == 255 def test_4245(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4245.pdf') with pymupdf.open(path) as document: page = document[0] regions = page.search_for('Bart Simpson') print(f'{regions=}') page.add_highlight_annot(regions) with pymupdf.open(path) as document: page = document[0] regions = page.search_for('Bart Simpson') for region in regions: highlight = page.add_highlight_annot(region) highlight.update() pixmap = page.get_pixmap() path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4245_out.png') pixmap.save(path_out) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4245_expected.png') rms = gentle_compare.pixmaps_rms(path_expected, pixmap) pixmap_diff = gentle_compare.pixmaps_diff(path_expected, pixmap) path_diff = os.path.normpath(f'{__file__}/../../tests/resources/test_4245_diff.png') pixmap_diff.save(path_diff) print(f'{rms=}') assert rms < 0.01 def test_4180(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4180.pdf') with pymupdf.open(path) as document: page = document[0] regions = page.search_for('Reference is made') for region in regions: page.add_redact_annot(region, fill=(0, 0, 0)) page.apply_redactions() pixmap = page.get_pixmap() path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4180_out.png') pixmap.save(path_out) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4180_expected.png') rms = gentle_compare.pixmaps_rms(path_expected, pixmap) pixmap_diff = gentle_compare.pixmaps_diff(path_expected, pixmap) path_diff = os.path.normpath(f'{__file__}/../../tests/resources/test_4180_diff.png') pixmap_diff.save(path_diff) print(f'{rms=}') assert rms < 0.01 def test_4182(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4182.pdf') with pymupdf.open(path) as document: page = document[0] dict_ = page.get_text('dict') linelist = [] for block in dict_['blocks']: if block['type'] == 0: paranum = block['number'] if 'lines' in block: for line in block.get('lines', ()): for span in line['spans']: if span['text'].strip(): page.draw_rect(span['bbox'], color=(1, 0, 0)) linelist.append([paranum, span['bbox'], repr(span['text'])]) pixmap = page.get_pixmap() path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4182_out.png') pixmap.save(path_out) if platform.system() != 'Windows': # Output on Windows can fail due to non-utf8 stdout. for l in linelist: print(l) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4182_expected.png') pixmap_diff = gentle_compare.pixmaps_diff(path_expected, pixmap) path_diff = os.path.normpath(f'{__file__}/../../tests/resources/test_4182_diff.png') pixmap_diff.save(path_diff) rms = gentle_compare.pixmaps_rms(path_expected, pixmap) print(f'{rms=}') assert rms < 0.01 def test_4179(): if os.environ.get('PYMUPDF_USE_EXTRA') == '0': # Looks like Python code doesn't behave same as C++, probably because # of the code not being correct for Python's native unicode strings. # print(f'test_4179(): Not running with PYMUPDF_USE_EXTRA=0 because known to fail.') return # We check that using TEXT_ACCURATE_BBOXES gives the correct boxes. But # this also requires that we disable PyMuPDF quad corrections. # path = os.path.normpath(f'{__file__}/../../tests/resources/test_4179.pdf') # Disable anti-aliasing to avoid our drawing of multiple identical bboxes # (from normal/accurate bboxes) giving slightly different results. aa = pymupdf.mupdf.fz_aa_level() uqc = pymupdf._globals.skip_quad_corrections pymupdf.TOOLS.set_aa_level(0) pymupdf.TOOLS.unset_quad_corrections(True) assert pymupdf._globals.skip_quad_corrections try: with pymupdf.open(path) as document: page = document[0] char_sqrt = b'\xe2\x88\x9a'.decode() # Search with defaults. bboxes_search = page.search_for(char_sqrt) assert len(bboxes_search) == 1 print(f'bboxes_search[0]:\n {bboxes_search[0]!r}') page.draw_rect(bboxes_search[0], color=(1, 0, 0)) rms = gentle_compare.rms(bboxes_search[0], (250.0489959716797, 91.93604278564453, 258.34783935546875, 101.34073638916016)) assert rms < 0.01 # Search with TEXT_ACCURATE_BBOXES. bboxes_search_accurate = page.search_for( char_sqrt, flags = (0 | pymupdf.TEXT_DEHYPHENATE | pymupdf.TEXT_PRESERVE_WHITESPACE | pymupdf.TEXT_PRESERVE_LIGATURES | pymupdf.TEXT_MEDIABOX_CLIP | pymupdf.TEXT_ACCURATE_BBOXES ), ) assert len(bboxes_search_accurate) == 1 print(f'bboxes_search_accurate[0]\n {bboxes_search_accurate[0]!r}') page.draw_rect(bboxes_search_accurate[0], color=(0, 1, 0)) rms = gentle_compare.rms(bboxes_search_accurate[0], (250.0489959716797, 99.00948333740234, 258.34783935546875, 108.97208404541016)) assert rms < 0.01 # Iterate with TEXT_ACCURATE_BBOXES. bboxes_iterate_accurate = list() dict_ = page.get_text( 'rawdict', flags = pymupdf.TEXT_ACCURATE_BBOXES, ) linelist = [] for block in dict_['blocks']: if block['type'] == 0: if 'lines' in block: for line in block.get('lines', ()): for span in line['spans']: for ch in span['chars']: if ch['c'] == char_sqrt: bbox_iterate_accurate = ch['bbox'] bboxes_iterate_accurate.append(bbox_iterate_accurate) print(f'bbox_iterate_accurate:\n {bbox_iterate_accurate!r}') page.draw_rect(bbox_iterate_accurate, color=(0, 0, 1)) assert bboxes_search_accurate != bboxes_search assert bboxes_iterate_accurate == bboxes_search_accurate pixmap = page.get_pixmap() path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4179_out.png') pixmap.save(path_out) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4179_expected.png') rms = gentle_compare.pixmaps_rms(path_expected, pixmap) pixmap_diff = gentle_compare.pixmaps_diff(path_expected, pixmap) path_out_diff = os.path.normpath(f'{__file__}/../../tests/resources/test_4179_diff.png') pixmap_diff.save(path_out_diff) print(f'Have saved to: {path_out_diff=}') print(f'{rms=}') assert rms < 0.01 finally: pymupdf.TOOLS.set_aa_level(aa) pymupdf.TOOLS.unset_quad_corrections(uqc) def test_extendable_textpage(): # 2025-01-28: # # We can create a pdf with two pages whose text is adjacent when stitched # together vertically: # # Page 1: # # aaaa # # bbbb # cccc # # dddd # # Page 2: # # eeee # # ffff # gggg # # hhhh # # # Create a textpage for both of these pages. Then when extracting text, # we need to get (specifically the `dddd` and `eeee` sequences need to be # treated as the same block): # # aaaa # # bbbb # cccc # # dddd # eeee # # ffff # gggg # # hhhh # print() path = os.path.normpath(f'{__file__}/../../tests/test_extendable_textpage.pdf') with pymupdf.open(filetype='pdf') as document: document.new_page() document.new_page() page0 = document[0] page1 = document[1] y = 100 line_height = 9.6 for i in range(4): page0.insert_text((100, y+line_height), 'abcd'[i] * 16) page1.insert_text((100, y+line_height), 'efgh'[i] * 16) y += line_height if i%2 == 0: y += line_height rect = pymupdf.mupdf.FzRect(100, 100, 200, y) document[0].draw_rect(rect, (1, 0, 0)) document[1].draw_rect(rect, (1, 0, 0)) document.save(path) # Create a stext page for the text regions in both pages of our document, # using direct calls to MuPDF. # with pymupdf.Document(path) as document: # Notes: # # We need to reuse the stext device for second page. Otherwise if we # create a new device, the first text in second page will always be in # a new block, because pen position for new device is (0, 0) and this # will usually be treated as a paragraph gap to the first text. # # At the moment we use infinite mediabox when creating the # fz_stext_page. I don't know what a non-infinite mediabox would be # useful for. # # FZ_STEXT_CLIP_RECT isn't useful at the moment, because we would need # to modify it to be in stext pagae coordinates (i.e. adding ctm.f # to y0 and y1) when we append the second page. But it's internal # data and there's no api to modify it. So for now we don't specify # FZ_STEXT_CLIP_RECT when creating the stext device, so we always # include each page's entire contents. # # We use our knowledge of the text rect in each page to manipulate ctm # so that the stext contains text starting at (0, 0) and extending # downwards. # y = 0 cookie = pymupdf.mupdf.FzCookie() stext_page = pymupdf.mupdf.FzStextPage( pymupdf.mupdf.FzRect(pymupdf.mupdf.FzRect.Fixed_INFINITE), # mediabox ) stext_options = pymupdf.mupdf.FzStextOptions() #stext_options.flags |= pymupdf.mupdf.FZ_STEXT_CLIP_RECT #stext_options.clip = rect.internal() device = pymupdf.mupdf.fz_new_stext_device(stext_page, stext_options) # Add first page to stext_page at (0, y), and update for the next # page. page = document[0] ctm = pymupdf.mupdf.FzMatrix(1, 0, 0, 1, -rect.x0, -rect.y0 + y) pymupdf.mupdf.fz_run_page(page.this, device, ctm, cookie) y += rect.y1 - rect.y0 # Add second page to stext_page at (0, y), and update for the next # page. page = document[1] ctm = pymupdf.mupdf.FzMatrix(1, 0, 0, 1, -rect.x0, -rect.y0 + y) pymupdf.mupdf.fz_run_page(page.this, device, ctm, cookie) y += rect.y1 - rect.y0 # We've finished adding text to stext_page. pymupdf.mupdf.fz_close_device(device) # Create a pymupdf.TextPage() for so we can use # text_page.extractDICT() etc. text_page = pymupdf.TextPage(stext_page) # Read text from stext_page using text_page.extractDICT(). print(f'Using text_page.extractDICT().') print(f'{text_page.this.m_internal.mediabox=}') d = text_page.extractDICT(sort=True) y0_prev = None pno = 0 ydelta = 0 for block in d['blocks']: print(f'block {block["bbox"]=}') for line in block['lines']: print(f' line {line["bbox"]=}') for span in line['spans']: print(f' span {span["bbox"]=}') bbox = span['bbox'] x0, y0, x1, y1 = bbox dy = y0 - y0_prev if y0_prev else 0 y0_prev = y0 print(f' {dy=: 5.2f} height={y1-y0:.02f} {x0:.02f} {y0:.02f} {x1:.02f} {y1:.02f} {span["text"]=}') if 'eee' in span['text']: pno = 1 ydelta = rect.y1 - rect.y0 y0 -= ydelta y1 -= ydelta # Debugging - add green lines on original document # translating final blocks info into original coors. document[pno].draw_rect((x0, y0, x1, y1), (0, 1, 0)) print('\n\n') print(f'Using text_page.extractText()') text = text_page.extractText(True) print(f'{text}') print('\n\n') print(f'Using extractBLOCKS') text = list() for x0, y0, x1, y1, line, no, type_ in text_page.extractBLOCKS(): print(f'block:') print(f' bbox={x0, y0, x1, y1} {no=}') print(f' {line=}') text.append(line) print("\n\n") print(f'extractBLOCKS joined by newlines:') print('\n'.join(text)) # This checks that lines before/after pages break are treated as a # single paragraph. assert text == [ 'aaaaaaaaaaaaaaaa\n', 'bbbbbbbbbbbbbbbb\ncccccccccccccccc\n', 'dddddddddddddddd\neeeeeeeeeeeeeeee\n', 'ffffffffffffffff\ngggggggggggggggg\n', 'hhhhhhhhhhhhhhhh\n', ] path3 = os.path.normpath(f'{__file__}/../../tests/test_extendable_textpage3.pdf') document.save(path3) def test_4363(): print() print(f'{pymupdf.version=}') path = os.path.normpath(f'{__file__}/../../tests/resources/test_4363.pdf') n = 0 texts = list() with pymupdf.open(path) as document: assert len(document) == 1 page = document[0] t = page.search_for('tour') print(f'{t=}') n += len(t) text = page.get_text() texts.append(text) print(f'{n=}') print(f'{len(texts)=}') text = texts[0] print('text:') print(f'{text=}') text_expected = ( 'Deal Roadshow SiteTour\n' 'We know your process. We know your standard.\n' 'Professional Site Tour Video Productions for the Capital Markets.\n' '1\n' ) if text != text_expected: print(f'Expected:\n {text_expected!r}') print(f'Found:\n {text!r}') assert 0 def test_4546(): # This issue will not be fixed (in mupdf) because the test input is faulty. # path = os.path.normpath(f'{__file__}/../../tests/resources/test_4546.pdf') with pymupdf.open(path) as document: page = document[0] text = page.get_text()[:200] # We can't actually test with 1.23.5 because it uses `fitz.` not `pymupdf.`. expected_1_23_5 = b'JOB No.: \nShipper (complete name and address) \xe5\x8f\x91\xe8\xb4\xa7\xe4\xba\xba(\xe5\x90\x8d\xe7\xa7\xb0\xe5\x8f\x8a\xe5\x9c\xb0\n\xe5\x9d\x80) \nSINORICH TRANSPORT LIMITED\nADD:7C,WEST BLDG.,ZHONGQU\nMANSION,211 ZHONGSHAN\nRD. SHANTOU,515041 CN\nTEL:0754-88570001 FAX:0754-88572709\nS/O No. '.decode() # This output is different from expected_1_23_5. expected_mupdf_1_26_1 = b'JOB No.: Shipper (complete name and address) \xe5\x8f\x91\xe8\xb4\xa7\xe4\xba\xba(\xe5\x90\x8d\xe7\xa7\xb0\xe5\x8f\x8a\xe5\x9c\xb0\xe5\x9d\x80) Tel: Fax: \n \nS/O No. \xe6\x89\x98\xe8\xbf\x90\xe5\x8d\x95\xe5\x8f\xb7\xe7\xa0\x81 \nSINORICH TRANSPORT LIMITED \nSHIPPING ORDER \n\xe6\x89\x98\xe8\xbf\x90\xe5\x8d\x95 \n \xe5\xb8\x82\xe5\x9c\xba\xe9\x83\xa8: \n88570009 \n88577019 \n88'.decode() # This output is different from either of the two expected strings. expected_mupdf_1_27_0 = b'JOB No.: \n \nS/O No. \xe6\x89\x98\xe8\xbf\x90\xe5\x8d\x95\xe5\x8f\xb7\xe7\xa0\x81 \nSINORICH TRANSPORT LIMITED \nSHIPPING ORDER \n\xe6\x89\x98\xe8\xbf\x90\xe5\x8d\x95 \n \xe5\xb8\x82\xe5\x9c\xba\xe9\x83\xa8: \n88570009 \n88577019 \n88572702 \n \xe6\x93\x8d\xe4\xbd\x9c\xe9\x83\xa8: \n88570008 \n88570004 \n \xe6\x96\x87\xe4\xbb\xb6\xe9\x83\xa8: \n88570003\n \nNotify Party(complete name and address, '.decode() print(f'expected_1_23_5\n{textwrap.indent(expected_1_23_5, " ")}') print(f'expected_mupdf_1_26_1\n{textwrap.indent(expected_mupdf_1_26_1, " ")}') print(f'{pymupdf.version=}') print(f'text is:\n{textwrap.indent(text, " ")}') print(f'{text=}') print(f'{text.encode()=}') wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 26, 8): assert text == expected_mupdf_1_27_0 if pymupdf.mupdf_version_tuple >= (1, 28): assert wt == 'ActualText with no position. Text may be lost or mispositioned.\n... repeated 120 times...' else: assert wt == 'Actualtext with no position. Text may be lost or mispositioned.\n... repeated 120 times...' elif pymupdf.mupdf_version_tuple >= (1, 26, 1): assert text == expected_mupdf_1_26_1 assert not wt else: print(f'No expected output for {pymupdf.mupdf_version_tuple=}') assert not wt def test_4503(): # Check detection of strikeout text. Behaviour is improved with # mupdf>=1.26.2, and fixed with mupdf>=1.26.3. # path = os.path.normpath(f'{__file__}/../../tests/resources/test_4503.pdf') span_0 = None text_0 = None print() print(f'{pymupdf.mupdf_version_tuple=}') with pymupdf.open(path) as document: page = document[0] # Specify TEXT_COLLECT_STYLES so we collect char_flags, which contains # FZ_STEXT_STRIKEOUT etc. # text = page.get_text('rawdict', flags=pymupdf.TEXTFLAGS_RAWDICT | pymupdf.TEXT_COLLECT_STYLES) for i, block in enumerate(text['blocks']): print(f'block {i}:') for j, line in enumerate(block['lines']): print(f' line {j}:') for k, span in enumerate(line['spans']): text = '' for char in span['chars']: text += char['c'] print(f' span {k}: {span["flags"]=:#x} {span["char_flags"]=:#x}: {text!r}') if 'the right to request the state to review' in text: span_0 = span text_0 = text assert span_0 #print(f'{span_0=}') print(f'{span_0["flags"]=:#x}') print(f'{span_0["char_flags"]=:#x}') print(f'{text_0=}') strikeout = span_0['char_flags'] & pymupdf.mupdf.FZ_STEXT_STRIKEOUT print(f'{strikeout=}') if pymupdf.mupdf_version_tuple >= (1, 26, 3): assert strikeout, f'Expected bit 0 (FZ_STEXT_STRIKEOUT) to be set in {span_0["char_flags"]=:#x}.' assert text_0 == 'the right to request the state to review and, if appropriate,' elif pymupdf.mupdf_version_tuple >= (1, 26, 2): # 2025-06-09: This is still incorrect - the span should include the # following text 'and, if appropriate,'. It looks like following spans # are: # strikeout=0: 'and, ' # strikeout=1: 'if ' # strikeout=0: 'appropri' # strikeout=1: 'ate,' # assert strikeout, f'Expected bit 0 (FZ_STEXT_STRIKEOUT) to be set in {span_0["char_flags"]=:#x}.' assert text_0 == 'the right to request the state to review ' else: # Expecting the bug. assert not strikeout, f'Expected bit 0 (FZ_STEXT_STRIKEOUT) to be unset in {span_0["char_flags"]=:#x}.' assert text_0 == 'notice the right to request the state to review and, if appropriate,' ================================================ FILE: tests/test_textsearch.py ================================================ """ "test_search1": Search for some text on a PDF page, and compare content of returned hit rectangle with the searched text. "test_search2": Text search with 'clip' parameter - clip rectangle contains two occurrences of searched text. Confirm search locations are inside clip. """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename1 = os.path.join(scriptdir, "resources", "2.pdf") filename2 = os.path.join(scriptdir, "resources", "github_sample.pdf") filename3 = os.path.join(scriptdir, "resources", "text-find-ligatures.pdf") def test_search1(): doc = pymupdf.open(filename1) page = doc[0] needle = "mupdf" rlist = page.search_for(needle) assert rlist != [] for rect in rlist: assert needle in page.get_textbox(rect).lower() def test_search2(): doc = pymupdf.open(filename2) page = doc[0] needle = "the" clip = pymupdf.Rect(40.5, 228.31436157226562, 346.5226135253906, 239.5338592529297) rl = page.search_for(needle, clip=clip) assert len(rl) == 2 for r in rl: assert r in clip def test_search3(): """Ensure we find text whether or not it contains ligatures.""" doc = pymupdf.open(filename3) page = doc[0] needle = "flag" hits = page.search_for(needle, flags=pymupdf.TEXTFLAGS_SEARCH) assert len(hits) == 2 # all occurrences found hits = page.search_for( needle, flags=pymupdf.TEXTFLAGS_SEARCH | pymupdf.TEXT_PRESERVE_LIGATURES ) assert len(hits) == 1 # only found text without ligatures ================================================ FILE: tests/test_threads.py ================================================ import os import random import queue import threading import pymupdf def log(text): print(f'{__file__}: {threading.get_native_id()=} {text}', flush=1) def threadfn(queue_to_threads, queue_from_threads): def tlog(text): log(f'### threadfn(): {text}') try: documents = list() while 1: action = queue_to_threads.get() #tlog(f'{action=}') if action == 'quit': break elif isinstance(action, tuple) and len(action) == 2 and action[0] == 'open': path = action[1] #tlog(f'Opening {path=}.') document = pymupdf.open(path) #tlog(f'Have opened {path=}.') documents.append(document) elif action == 'gettext': if documents: document_i = random.randrange(len(documents)) document = documents[document_i] page = document[random.randrange(len(document))] text = page.get_text() elif action == 'close': if len(documents) >= 2: document_i = random.randrange(len(documents)) del documents[document_i] else: assert 0, f'Unrecognised {action=}.' #tlog(f'Sending to queue_from_threads: {threading.current_thread()=}.') queue_from_threads.put(threading.current_thread()) except Exception as e: tlog(f'error: {e}') queue_from_threads.put(e) def test_threads_stress(): print() paths = [ os.path.normpath(f'{__file__}/../../tests/resources/test_3594.pdf'), os.path.normpath(f'{__file__}/../../tests/resources/test_3789.pdf'), ] threads = list() queue_to_threads = queue.Queue() queue_from_threads = queue.Queue() def put(action): #log(f'test_threads_stress(): Sending {action=}.') queue_to_threads.put(action) class Stats: pass stats = Stats() stats.num_opens = 0 stats.num_gettexts = 0 stats.num_threads_max = 0 def start_thread(): thread = threading.Thread(target=threadfn, args=(queue_to_threads, queue_from_threads), daemon=1) threads.append(thread) thread.start() stats.num_threads_max = max(stats.num_threads_max, len(threads)) def quit_thread(): put('quit') stopped_thread = queue_from_threads.get() assert isinstance(stopped_thread, threading.Thread), f'A thread has failed: {stopped_thread}' #log(f'{stopped_thread=}') stopped_thread.join() if 0: log(f'threads ({len(threads)}):') for thread in threads: log(f' {thread=}') log(f'{stopped_thread=}') threads.remove(stopped_thread) def open_document(): path = paths[random.randrange(len(paths))] put(('open', path)) stats.num_opens += 1 for i in range(10): start_thread() open_document() numits = 1000 for i in range(numits): op = random.randrange(100) if 0: log('') log(f'{i+1}/{numits}') log(f'{len(threads)=}.') log(f'{stats.num_opens=}.') log(f'{stats.num_gettexts=}.') log(f'{op=}.') if op < 10: # Create new thread. start_thread() elif op < 15: if len(threads) >= 2: quit_thread() elif op < 30: # Open document in a thread. open_document() elif op == 40: # Close document in a thread. if threads: put('close') elif op < 100: # get text. put('gettext') stats.num_gettexts +=1 else: assert 0, f'Unrecognised {op=}' log(f'End:') log(f'{len(threads)=} {stats.num_opens=} {stats.num_gettexts=} {stats.num_threads_max=}.') for _ in range(len(threads)): quit_thread() # Ignore any warnings, which can occur for some pages in the documents. wt = pymupdf.TOOLS.mupdf_warnings() ================================================ FILE: tests/test_toc.py ================================================ """ * Verify equality of generated TOCs and expected results. * Verify TOC deletion works * Verify manipulation of single TOC item works * Verify stability against circular TOC items """ import os import sys import pymupdf import pathlib scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "001003ED.pdf") filename2 = os.path.join(scriptdir, "resources", "2.pdf") circular = os.path.join(scriptdir, "resources", "circular-toc.pdf") full_toc = os.path.join(scriptdir, "resources", "full_toc.txt") simple_toc = os.path.join(scriptdir, "resources", "simple_toc.txt") file_3820 = os.path.join(scriptdir, "resources", "test-3820.pdf") doc = pymupdf.open(filename) def test_simple_toc(): simple_lines = open(simple_toc, "rb").read() toc = b"".join([str(t).encode() for t in doc.get_toc(True)]) assert toc == simple_lines def test_full_toc(): if not hasattr(pymupdf, "mupdf"): # Classic implementation does not have fix for this test. print(f"Not running test_full_toc on classic implementation.") return expected_path = f"{scriptdir}/resources/full_toc.txt" expected = pathlib.Path(expected_path).read_bytes() # Github windows x32 seems to insert \r characters; maybe something to # do with the Python installation's line endings settings. expected = expected.decode("utf8") expected = expected.replace('\r', '') toc = "\n".join([str(t) for t in doc.get_toc(False)]) toc += "\n" assert toc == expected def test_erase_toc(): doc.set_toc([]) assert doc.get_toc() == [] def test_replace_toc(): toc = doc.get_toc(False) doc.set_toc(toc) def test_setcolors(): doc = pymupdf.open(filename2) toc = doc.get_toc(False) for i in range(len(toc)): d = toc[i][3] d["color"] = (1, 0, 0) d["bold"] = True d["italic"] = True doc.set_toc_item(i, dest_dict=d) toc2 = doc.get_toc(False) assert len(toc2) == len(toc) for t in toc2: d = t[3] assert d["bold"] assert d["italic"] assert d["color"] == (1, 0, 0) def test_circular(): """The test file contains circular bookmarks.""" doc = pymupdf.open(circular) toc = doc.get_toc(False) # this must not loop if pymupdf.mupdf_version_tuple < (1, 27): # Expect warning. wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'Bad or missing prev pointer in outline tree, repairing', \ f'{wt=}' def test_2355(): # Create a test PDF with toc. doc = pymupdf.Document() for _ in range(10): doc.new_page(doc.page_count) doc.set_toc([[1, 'test', 1], [1, 'test2', 5]]) path = 'test_2355.pdf' doc.save(path) # Open many times for i in range(10): with pymupdf.open(path) as new_doc: new_doc.get_toc() # Open once and read many times with pymupdf.open(path) as new_doc: for i in range(10): new_doc.get_toc() def test_2788(): ''' Check handling of Document.get_toc() when toc item has kind=4. ''' if not hasattr(pymupdf, 'mupdf'): # Classic implementation does not have fix for this test. print(f'Not running test_2788 on classic implementation.') return path = os.path.abspath(f'{__file__}/../../tests/resources/test_2788.pdf') document = pymupdf.open(path) toc0 = [[1, 'page2', 2, {'kind': 4, 'xref': 14, 'page': 1, 'to': pymupdf.Point(100.0, 760.0), 'zoom': 0.0, 'nameddest': 'page.2'}]] toc1 = document.get_toc(simple=False) print(f'{toc0=}') print(f'{toc1=}') assert toc1 == toc0 doc.set_toc(toc0) toc2 = document.get_toc(simple=False) print(f'{toc0=}') print(f'{toc2=}') assert toc2 == toc0 # Also test Page.get_links() bugfix from #2817. for page in document: page.get_links() wt = pymupdf.TOOLS.mupdf_warnings() assert wt == ( "syntax error: expected 'obj' keyword (0 3 ?)\n" "trying to repair broken xref\n" "repairing PDF document" ), f'{wt=}' def test_toc_count(): file_in = os.path.abspath(f'{__file__}/../../tests/resources/test_toc_count.pdf') file_out = os.path.abspath(f'{__file__}/../../tests/test_toc_count_out.pdf') def get(doc): outlines = doc.xref_get_key(doc.pdf_catalog(), "Outlines") ret = doc.xref_object(int(outlines[1].split()[0])) return ret print() with pymupdf.open(file_in) as doc: print(f'1: {get(doc)}') toc = doc.get_toc(simple=False) doc.set_toc([]) #print(f'2: {get(doc)}') doc.set_toc(toc) print(f'3: {get(doc)}') doc.save(file_out, garbage=4) with pymupdf.open(file_out) as doc: print(f'4: {get(doc)}') pymupdf._log_items_clear() def test_3347(): ''' Check fix for #3347 - link destination rectangles when source/destination pages have different sizes. ''' doc = pymupdf.open() doc.new_page(width=500, height=800) doc.new_page(width=800, height=500) rects = [ (0, pymupdf.Rect(10, 20, 50, 40), pymupdf.utils.getColor('red')), (0, pymupdf.Rect(300, 350, 400, 450), pymupdf.utils.getColor('green')), (1, pymupdf.Rect(20, 30, 40, 50), pymupdf.utils.getColor('blue')), (1, pymupdf.Rect(350, 300, 450, 400), pymupdf.utils.getColor('black')) ] for page, rect, color in rects: doc[page].draw_rect(rect, color=color) for (from_page, from_rect, _), (to_page, to_rect, _) in zip(rects, rects[1:] + rects[:1]): doc[from_page].insert_link({ 'kind': 1, 'from': from_rect, 'page': to_page, 'to': to_rect.top_left, }) links_expected = [ (0, {'kind': 1, 'xref': 11, 'from': pymupdf.Rect(10.0, 20.0, 50.0, 40.0), 'page': 0, 'to': pymupdf.Point(300.0, 350.0), 'zoom': 0.0, 'id': 'fitz-L0'}), (0, {'kind': 1, 'xref': 12, 'from': pymupdf.Rect(300.0, 350.0, 400.0, 450.0), 'page': 1, 'to': pymupdf.Point(20.0, 30.0), 'zoom': 0.0, 'id': 'fitz-L1'}), (1, {'kind': 1, 'xref': 13, 'from': pymupdf.Rect(20.0, 30.0, 40.0, 50.0), 'page': 1, 'to': pymupdf.Point(350.0, 300.0), 'zoom': 0.0, 'id': 'fitz-L0'}), (1, {'kind': 1, 'xref': 14, 'from': pymupdf.Rect(350.0, 300.0, 450.0, 400.0), 'page': 0, 'to': pymupdf.Point(10.0, 20.0), 'zoom': 0.0, 'id': 'fitz-L1'}), ] path = os.path.normpath(f'{__file__}/../../tests/test_3347_out.pdf') doc.save(path) print(f'Have saved to {path=}.') links_actual = list() for page_i, page in enumerate(doc): links = page.get_links() for link_i, link in enumerate(links): print(f'{page_i=} {link_i=}: {link!r}') links_actual.append( (page_i, link) ) assert links_actual == links_expected def test_3400(): ''' Check fix for #3400 - link destination rectangles when source/destination pages have different rotations. ''' width = 750 height = 1110 circle_middle_point = pymupdf.Point(height / 4, width / 4) print(f'{circle_middle_point=}') with pymupdf.open() as doc: page = doc.new_page(width=width, height=height) page.set_rotation(270) # draw a circle at the middle point to facilitate debugging page.draw_circle(circle_middle_point, color=(0, 0, 1), radius=5, width=2) for i in range(10): for j in range(10): x = i/10 * width y = j/10 * height page.draw_circle(pymupdf.Point(x, y), color=(0,0,0), radius=0.2, width=0.1) page.insert_htmlbox(pymupdf.Rect(x, y, x+width/10, y+height/20), f'({x=:.1f},{y=:.1f})', ) # rotate the middle point by the page rotation for the new toc entry toc_link_coords = circle_middle_point print(f'{toc_link_coords=}') toc = [ ( 1, "Link to circle", 1, { "kind": pymupdf.LINK_GOTO, "page": 1, "to": toc_link_coords, "from": pymupdf.Rect(0, 0, height / 4, width / 4), }, ) ] doc.set_toc(toc, 0) # set the toc page = doc.new_page(width=200, height=300) from_rect = pymupdf.Rect(10, 10, 100, 50) page.insert_htmlbox(from_rect, 'link') link = dict() link['from'] = from_rect link['kind'] = pymupdf.LINK_GOTO link['to'] = toc_link_coords link['page'] = 0 page.insert_link(link) path = os.path.normpath(f'{__file__}/../../tests/test_3400.pdf') doc.save(path) print(f'Saved to {path=}.') links_expected = [ (1, {'kind': 1, 'xref': 1120, 'from': pymupdf.Rect(10.0, 10.0, 100.0, 50.0), 'page': 0, 'to': pymupdf.Point(187.5, 472.5), 'zoom': 0.0, 'id': 'fitz-L0'}) ] links_actual = list() for page_i, page in enumerate(doc): links = page.get_links() for link_i, link in enumerate(links): print(f'({page_i}, {link!r})') links_actual.append( (page_i, link) ) assert links_actual == links_expected def test_3820(): """Ensure all extended TOC items point to pages.""" doc = pymupdf.open(file_3820) toc = doc.get_toc(simple=False) for _, _, epage, dest in toc: assert epage == dest["page"] + 1 ================================================ FILE: tests/test_typing.py ================================================ from __future__ import annotations import os import subprocess import pymupdf def run(command, check=1): print(f'Running: {command}') subprocess.run(command, shell=1, check=check) def test_py_typed(): if os.path.basename(__file__).startswith(f'test_fitz_'): # Don't test the `fitz` alias, because mypy complains. print(f'test_py_typed(): Not testing with fitz alias.') return if os.environ.get('PYODIDE_ROOT'): print('test_py_typed(): not running on Pyodide - cannot run child processes.') return print(f'test_py_typed(): {pymupdf.__path__=}') root = os.path.abspath(f'{__file__}/../..') # Run mypy on this .py file; it will fail at `import pymypdf` if the # pymupdf install does not have a py.typed file. # # This doesn't actually check pymupdf's typing. It looks like # we can do that with `mypy -m pymupdf`, but as of 2026-1-18 this # gives many errors such as: # # ...site-packages/pymupdf/__init__.py:15346: error: point_like? has no attribute "y" [attr-defined] # # It's important to use `--no-incremental`, otherwise if one has # experimented with `mypy -m pymupdf`, this test will get the # same failures, via `.mypy_cache/` directories. # # We run in sub-directory to avoid spurious mypy errors # if there is a local mupdf/ directory. # run(f'cd {root}/tests && mypy --no-incremental {os.path.abspath(__file__)}') def _test_4903(page: pymupdf.Page) -> float: # In 1.27.1, error: Variable "pymupdf.Page" is not valid as a type return page.rect.width # In 1.27.1, error: pymupdf.Page? has no attribute "rect" def _test_4932(page: pymupdf.Page): page.find_tables() ================================================ FILE: tests/test_widgets.py ================================================ # -*- coding: utf-8 -*- """ Test PDF field (widget) insertion. """ import pymupdf import os scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "widgettest.pdf") file_2333 = os.path.join(scriptdir, "resources", "test-2333.pdf") file_4055 = os.path.join(scriptdir, "resources", "test-4055.pdf") doc = pymupdf.open() page = doc.new_page() gold = (1, 1, 0) # define some colors blue = (0, 0, 1) gray = (0.9, 0.9, 0.9) fontsize = 11.0 # define a fontsize lineheight = fontsize + 4.0 rect = pymupdf.Rect(50, 72, 400, 200) def test_text(): doc = pymupdf.open() page = doc.new_page() widget = pymupdf.Widget() # create a widget object widget.border_color = blue # border color widget.border_width = 0.3 # border width widget.border_style = "d" widget.border_dashes = (2, 3) widget.field_name = "Textfield-1" # field name widget.field_label = "arbitrary text - e.g. to help filling the field" widget.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT # field type widget.fill_color = gold # field background widget.rect = rect # set field rectangle widget.text_color = blue # rext color widget.text_font = "TiRo" # use font Times-Roman widget.text_fontsize = fontsize # set fontsize widget.text_maxlen = 50 # restrict number of characters widget.field_value = "Times-Roman" page.add_widget(widget) # create the field field = page.first_widget assert field.field_type_string == "Text" def test_checkbox(): doc = pymupdf.open() page = doc.new_page() widget = pymupdf.Widget() widget.border_style = "b" widget.field_name = "Button-1" widget.field_label = "a simple check box button" widget.field_type = pymupdf.PDF_WIDGET_TYPE_CHECKBOX widget.fill_color = gold widget.rect = rect widget.text_color = blue widget.text_font = "ZaDb" widget.field_value = True page.add_widget(widget) # create the field field = page.first_widget assert field.field_type_string == "CheckBox" # Check #2350 - setting checkbox to readonly. # widget.field_flags |= pymupdf.PDF_FIELD_IS_READ_ONLY widget.update() path = f"{scriptdir}/test_checkbox.pdf" doc.save(path) doc = pymupdf.open(path) page = doc[0] widget = page.first_widget assert widget assert widget.field_flags == pymupdf.PDF_FIELD_IS_READ_ONLY def test_listbox(): doc = pymupdf.open() page = doc.new_page() widget = pymupdf.Widget() widget.field_name = "ListBox-1" widget.field_label = "is not a drop down: scroll with cursor in field" widget.field_type = pymupdf.PDF_WIDGET_TYPE_LISTBOX widget.field_flags = pymupdf.PDF_CH_FIELD_IS_COMMIT_ON_SEL_CHANGE widget.fill_color = gold widget.choice_values = ( "Frankfurt", "Hamburg", "Stuttgart", "Hannover", "Berlin", "München", "Köln", "Potsdam", ) widget.rect = rect widget.text_color = blue widget.text_fontsize = fontsize widget.field_value = widget.choice_values[-1] print("About to add '%s'" % widget.field_name) page.add_widget(widget) # create the field field = page.first_widget assert field.field_type_string == "ListBox" def test_combobox(): doc = pymupdf.open() page = doc.new_page() widget = pymupdf.Widget() widget.field_name = "ComboBox-1" widget.field_label = "an editable combo box ..." widget.field_type = pymupdf.PDF_WIDGET_TYPE_COMBOBOX widget.field_flags = ( pymupdf.PDF_CH_FIELD_IS_COMMIT_ON_SEL_CHANGE | pymupdf.PDF_CH_FIELD_IS_EDIT ) widget.fill_color = gold widget.choice_values = ( "Spanien", "Frankreich", "Holland", "Dänemark", "Schweden", "Norwegen", "England", "Polen", "Russland", "Italien", "Portugal", "Griechenland", ) widget.rect = rect widget.text_color = blue widget.text_fontsize = fontsize widget.field_value = widget.choice_values[-1] page.add_widget(widget) # create the field field = page.first_widget assert field.field_type_string == "ComboBox" def test_text2(): doc = pymupdf.open() doc.new_page() page = [p for p in doc.pages()][0] widget = pymupdf.Widget() widget.field_name = "textfield-2" widget.field_label = "multi-line text with tabs is also possible!" widget.field_flags = pymupdf.PDF_TX_FIELD_IS_MULTILINE widget.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT widget.fill_color = gray widget.rect = rect widget.text_color = blue widget.text_font = "TiRo" widget.text_fontsize = fontsize widget.field_value = "This\n\tis\n\t\ta\n\t\t\tmulti-\n\t\tline\n\ttext." page.add_widget(widget) # create the field widgets = [w for w in page.widgets()] field = widgets[0] assert field.field_type_string == "Text" def test_2333(): doc = pymupdf.open(file_2333) page = doc[0] def values(): return set( ( doc.xref_get_key(635, "AS")[1], doc.xref_get_key(636, "AS")[1], doc.xref_get_key(637, "AS")[1], doc.xref_get_key(638, "AS")[1], doc.xref_get_key(127, "V")[1], ) ) for i, xref in enumerate((635, 636, 637, 638)): w = page.load_widget(xref) w.field_value = True w.update() assert values() == set(("/Off", f"{i}", f"/{i}")) w.field_value = False w.update() assert values() == set(("Off", "/Off")) def test_2411(): """Add combobox values in different formats.""" doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(100, 100, 300, 200) widget = pymupdf.Widget() widget.field_flags = ( pymupdf.PDF_CH_FIELD_IS_COMBO | pymupdf.PDF_CH_FIELD_IS_EDIT | pymupdf.PDF_CH_FIELD_IS_COMMIT_ON_SEL_CHANGE ) widget.field_name = "ComboBox-1" widget.field_label = "an editable combo box ..." widget.field_type = pymupdf.PDF_WIDGET_TYPE_COMBOBOX widget.fill_color = pymupdf.pdfcolor["gold"] widget.rect = rect widget.choice_values = [ ["Spain", "ES"], # double value as list ("Italy", "I"), # double value as tuple "Portugal", # single value ] page.add_widget(widget) def test_2391(): """Confirm that multiple times setting a checkbox to ON/True/Yes will work.""" doc = pymupdf.open(f"{scriptdir}/resources/widgettest.pdf") page = doc[0] # its work when we update first-time for field in page.widgets(types=[pymupdf.PDF_WIDGET_TYPE_CHECKBOX]): field.field_value = True field.update() for i in range(5): pdfdata = doc.tobytes() doc.close() doc = pymupdf.open("pdf", pdfdata) page = doc[0] for field in page.widgets(types=[pymupdf.PDF_WIDGET_TYPE_CHECKBOX]): assert field.field_value == field.on_state() field_field_value = field.on_state() field.update() def test_3216(): document = pymupdf.open(filename) for page in document: while 1: w = page.first_widget print(f"{w=}") if not w: break page.delete_widget(w) def test_add_widget(): doc = pymupdf.open() page = doc.new_page() w = pymupdf.Widget() w.field_type = pymupdf.PDF_WIDGET_TYPE_BUTTON w.rect = pymupdf.Rect(5, 5, 20, 20) w.field_flags = pymupdf.PDF_BTN_FIELD_IS_PUSHBUTTON w.field_name = "button" w.fill_color = (0, 0, 1) w.script = "app.alert('Hello, PDF!');" page.add_widget(w) def test_interfield_calculation(): """Confirm correct working of interfield calculations. We are going to create three pages with a computed result field each. Tests the fix for https://github.com/pymupdf/PyMuPDF/issues/3402. """ # Field bboxes (same on each page) r1 = pymupdf.Rect(100, 100, 300, 120) r2 = pymupdf.Rect(100, 130, 300, 150) r3 = pymupdf.Rect(100, 180, 300, 200) doc = pymupdf.open() pdf = pymupdf._as_pdf_document(doc) # we need underlying PDF document # Make PDF name object for "CO" because it is not defined in MuPDF. CO_name = pymupdf.mupdf.pdf_new_name("CO") # = PDF_NAME(CO) for i in range(3): page = doc.new_page() w = pymupdf.Widget() w.field_name = f"NUM1{page.number}" w.rect = r1 w.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT w.field_value = f"{i*100+1}" w.field_flags = 2 page.add_widget(w) w = pymupdf.Widget() w.field_name = f"NUM2{page.number}" w.rect = r2 w.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT w.field_value = "200" w.field_flags = 2 page.add_widget(w) w = pymupdf.Widget() w.field_name = f"RESULT{page.number}" w.rect = r3 w.field_type = pymupdf.PDF_WIDGET_TYPE_TEXT w.field_value = "Result?" # Script that adds previous two fields. w.script_calc = f"""AFSimple_Calculate("SUM", new Array("NUM1{page.number}", "NUM2{page.number}"));""" page.add_widget(w) # Access the inter-field calculation array. It contains a reference to # all fields which have a JavaScript stored in their "script_calc" # property, i.e. an "AA/C" entry. # Every iteration adds another such field, so this array's length must # always equal the loop index. if i == 0: # only need to execute this on first time through CO = pymupdf.mupdf.pdf_dict_getl( pymupdf.mupdf.pdf_trailer(pdf), pymupdf.PDF_NAME("Root"), pymupdf.PDF_NAME("AcroForm"), CO_name, ) # we confirm CO is an array of foreseeable length assert pymupdf.mupdf.pdf_array_len(CO) == i + 1 # the xref of the i-th item must equal that of the last widget assert ( pymupdf.mupdf.pdf_to_num(pymupdf.mupdf.pdf_array_get(CO, i)) == list(page.widgets())[-1].xref ) def test_3950(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3950.pdf') items = list() with pymupdf.open(path) as document: for page in document: for widget in page.widgets(): items.append(widget.field_label) print(f'test_3950(): {widget.field_label=}.') assert items == [ '{{ named_insured }}', '{{ policy_period_start_date }}', '{{ policy_period_end_date }}', '{{ insurance_line }}', ] def test_4004(): import collections def get_widgets_by_name(doc): """ Extracts and returns a dictionary of widgets indexed by their names. """ widgets_by_name = collections.defaultdict(list) for page_num in range(len(doc)): page = doc.load_page(page_num) for field in page.widgets(): widgets_by_name[field.field_name].append({ "page_num": page_num, "widget": field }) return widgets_by_name # Open document and get widgets path = os.path.normpath(f'{__file__}/../../tests/resources/test_4004.pdf') doc = pymupdf.open(path) widgets_by_name = get_widgets_by_name(doc) # Print widget information for name, widgets in widgets_by_name.items(): print(f"Widget Name: {name}") for entry in widgets: widget = entry["widget"] page_num = entry["page_num"] print(f" Page: {page_num + 1}, Type: {widget.field_type}, Value: {widget.field_value}, Rect: {widget.rect}") # Attempt to update field value w = widgets_by_name["Text1"][0] field = w['widget'] field.value = "1234567890" try: field.update() except Exception as e: assert str(e) == 'Annot is not bound to a page' doc.close() def test_4055(): """Check correct setting of CheckBox "Yes" values. Test scope: * setting on with any of 'True' / 'Yes' / built-in values works * setting off with any of 'False' or 'Off' works """ # this PDF has digits as "Yes" values. doc = pymupdf.open(file_4055) page = doc[0] # Round 1: confirm all check boxes are off for w in page.widgets(types=[2]): # check that this file doesn't use the "Yes" standard assert w.on_state() != "Yes" assert w.field_value == "Off" # all check boxes are off w.field_value = w.on_state() w.update() page = doc.reload_page(page) # reload page to make sure we start fresh # Round 2: confirm that fields contain the PDF's own on values for w in page.widgets(types=[2]): # confirm each value coincides with the "Yes" value assert w.field_value == w.on_state() w.field_value = False # switch to "Off" using False w.update() page = doc.reload_page(page) # Round 3: confirm that 'False' achieved "Off" values for w in page.widgets(types=[2]): assert w.field_value == "Off" w.field_value = True # use True for the next round w.update() page = doc.reload_page(page) # Round 4: confirm that setting to True also worked for w in page.widgets(types=[2]): assert w.field_value == w.on_state() w.field_value = "Off" # set off again w.update() w.field_value = "Yes" w.update() page = doc.reload_page(page) # Round 5: final check: setting to "Yes" also does work for w in page.widgets(types=[2]): assert w.field_value == w.on_state() def test_4965(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4965.pdf') with pymupdf.open(path) as document: for page in document: print(f'test_4965(): {page.number=}') # Iterate over all form fields (widgets) on the page for widget_i, field in enumerate(page.widgets()): # Access field properties name = field.field_name # The internal name of the field value = field.field_value # The data currently in the field f_type = field.field_type # Integer representing the field type print(f' {widget_i=}') print(f' {name=}') print(f' {value=}') print(f' {f_type=}') ================================================ FILE: tests/test_word_delimiters.py ================================================ import pymupdf import string def test_delimiters(): """Test changing word delimiting characters.""" doc = pymupdf.open() page = doc.new_page() text = "word1,word2 - word3. word4?word5." page.insert_text((50, 50), text) # Standard words extraction: # only spaces and line breaks start a new word words0 = [w[4] for w in page.get_text("words")] assert words0 == ["word1,word2", "-", "word3.", "word4?word5."] # extract words again words1 = [w[4] for w in page.get_text("words", delimiters=string.punctuation)] assert words0 != words1 assert " ".join(words1) == "word1 word2 word3 word4 word5" # confirm we will be getting old extraction assert [w[4] for w in page.get_text("words")] == words0 ================================================ FILE: tests/util.py ================================================ import os import subprocess def download(url, name, size=None): ''' Downloads from to a local file and returns its path. If file already exists and matches we do not re-download it. We put local files within a `cache/` directory so that it is not deleted by `git clean` (unless `-d` is specified). ''' path = os.path.normpath(f'{__file__}/../../tests/cache/{name}') if os.path.isfile(path) and (not size or os.stat(path).st_size == size): print(f'Using existing file {path=}.') else: print(f'Downloading from {url=}.') subprocess.run(f'pip install -U requests', check=1, shell=1) import requests r = requests.get(url, path, timeout=10) r.raise_for_status() if size is not None: assert len(r.content) == size os.makedirs(os.path.dirname(path), exist_ok=1) with open(path, 'wb') as f: f.write(r.content) return path def skip_slow_tests(test_name): PYMUPDF_TEST_QUICK = os.environ.get('PYMUPDF_TEST_QUICK') if PYMUPDF_TEST_QUICK == '1': print(f'{test_name}(): skipping test because {PYMUPDF_TEST_QUICK=}.') return True ================================================ FILE: valgrind.supp ================================================ # Valgrind suppression for false-positives from use of shared-libraries. # { sharedlibrary-read Memcheck:Addr8 fun:strncmp fun:is_dst ... fun:fillin_rpath.isra.0 fun:decompose_rpath ... fun:openaux fun:_dl_catch_exception fun:_dl_map_object_deps fun:dl_open_worker_begin fun:_dl_catch_exception }

{time.strftime("%F-%T")}\n') f.write(f'\n') f.write(f'') for ext in extensions: f.write(f'') f.write('\n') for path in sorted(results.keys()): _, ext = os.path.splitext(path) f.write(f'') for ext2 in sorted(results[path].keys()): text_file = results[path][ext2]['file'] text_stream = results[path][ext2]['stream'] b1, b2 = ('', '') if ext2==ext else ('', '') if text_file == text_stream: if text_file == '[error]': f.write(f'') else: f.write(f'') else: f.write(f'') f.write('\n') f.write(f'
Extension/magic') f.write(f'
Data file{ext}
{os.path.basename(path)}
{b1}{text_file}{b2}
{b1}{text_file}{b2}file: {b1}{text_file}{b2}
') f.write(f'stream: {b1}{text_stream}{b2}
\n') f.write(f'/\n') f.write(f'\n') print(f'Have created: {path_html}') path_out = os.path.normpath(f'{__file__}/../../tests/test_open2.json') with open(path_out, 'w') as f: json.dump(results, f, indent=4, sort_keys=1) with open(os.path.normpath(f'{__file__}/../../tests/resources/test_open2_expected.json')) as f: results_expected = json.load(f) if results != results_expected: print(f'results != results_expected:') def show(r, name): text = json.dumps(r, indent=4, sort_keys=1) print(f'{name}:') print(textwrap.indent(text, ' ')) show(results_expected, 'results_expected') show(results, 'results') assert 0 def test_533(): path = os.path.abspath(f'{__file__}/../../tests/resources/2.pdf') doc = pymupdf.open(path) print() for p in doc: print(f'test_533(): for p in doc: {p=}.') for p in list(doc)[:]: print(f'test_533(): for p in list(doc)[:]: {p=}.') for p in doc[:]: print(f'test_533(): for p in doc[:]: {p=}.') def test_3354(): document = pymupdf.open(filename) v = dict(foo='bar') document.metadata = v assert document.metadata == v def test_scientific_numbers(): ''' This is #3381. ''' doc = pymupdf.open() page = doc.new_page(width=595, height=842) point = pymupdf.Point(1e-11, -1e-10) page.insert_text(point, "Test") contents = page.read_contents() print(f'{contents=}') assert b" 1e-" not in contents def test_3615(): print('') print(f'{pymupdf.pymupdf_version=}', flush=1) print(f'{pymupdf.VersionBind=}', flush=1) path = os.path.normpath(f'{__file__}/../../tests/resources/test_3615.epub') doc = pymupdf.open(path) print(doc.pagemode) print(doc.pagelayout) wt = pymupdf.TOOLS.mupdf_warnings() assert wt def test_3654(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3654.docx') content = "" with pymupdf.open(path) as document: for page in document: content += page.get_text() + '\n\n' content = content.strip() def test_3727(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3727.pdf') doc = pymupdf.open(path) for page in doc: page.get_pixmap(matrix = pymupdf.Matrix(2,2)) def test_3569(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3569.pdf') document = pymupdf.open(path) page = document[0] svg = page.get_svg_image(text_as_path=False) print(f'{svg=}') if pymupdf.mupdf_version_tuple >= (1, 27): assert svg == ( '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '**L1-13\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' ) else: assert svg == ( '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '**L1-13\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' '\n' ) wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 28): assert wt == 'unknown cid collection: PDFAUTOCAD-Indentity0\nnon-embedded font using identity encoding: ArialMT (mapping via )\ninvalid marked content sequence / clip nesting' else: assert wt == 'unknown cid collection: PDFAUTOCAD-Indentity0\nnon-embedded font using identity encoding: ArialMT (mapping via )\ninvalid marked content and clip nesting' def test_3450(): # This issue is a slow-down, so we just show time taken - it's not safe # to fail if test takes too long because that can give spurious failures # depending on hardware etc. # # On a mac-mini, PyMuPDF-1.24.8 takes 60s, PyMuPDF-1.24.9 takes 4s. # if os.environ.get('PYMUPDF_RUNNING_ON_VALGRIND') == '1': print(f'test_3450(): not running on valgrind because very slow.', flush=1) return path = os.path.normpath(f'{__file__}/../../tests/resources/test_3450.pdf') pdf = pymupdf.open(path) page = pdf[0] t = time.time() pix = page.get_pixmap(alpha=False, dpi=150) t = time.time() - t print(f'test_3450(): {t=}') def test_3859(): print(f'{pymupdf.mupdf.PDF_NULL=}.') print(f'{pymupdf.mupdf.PDF_TRUE=}.') print(f'{pymupdf.mupdf.PDF_FALSE=}.') for name in ('NULL', 'TRUE', 'FALSE'): name2 = f'PDF_{name}' v = getattr(pymupdf.mupdf, name2) print(f'{name=} {name2=} {v=} {type(v)=}') assert type(v)==pymupdf.mupdf.PdfObj, f'`v` is not a pymupdf.mupdf.PdfObj.' def test_3905(): data = b'A,B,C,D\r\n1,2,1,2\r\n2,2,1,2\r\n' try: document = pymupdf.open(stream=data, filetype='pdf') except pymupdf.FileDataError as e: print(f'test_3905(): e: {e}') else: assert 0 wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'format error: cannot find version marker\ntrying to repair broken xref\nrepairing PDF document' def test_3624(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3624.pdf') path_png_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3624_expected.png') path_png = os.path.normpath(f'{__file__}/../../tests/test_3624.png') with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap(matrix=pymupdf.Matrix(2, 2)) print(f'Saving to {path_png=}.') pixmap.save(path_png) rms = gentle_compare.pixmaps_rms(path_png_expected, path_png) print(f'{rms=}') # We get small differences in sysinstall tests, where some thirdparty # libraries can differ. if rms > 1: pixmap_diff = gentle_compare.pixmaps_diff(path_png_expected, path_png) path_png_diff = os.path.normpath(f'{__file__}/../../tests/test_3624_diff.png') pixmap_diff.save(path_png_diff) assert 0, f'{rms=}' def test_4043(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4043.pdf') doc = pymupdf.open(path) doc.fullcopy_page(1) def test_4018(): document = pymupdf.open() for page in document.pages(-1, -1): pass def test_4034(): # tests/resources/test_4034.pdf is first two pages of input file in # https://github.com/pymupdf/PyMuPDF/issues/4034. path = os.path.normpath(f'{__file__}/../../tests/resources/test_4034.pdf') path_clean = os.path.normpath(f'{__file__}/../../tests/test_4034_out.pdf') with pymupdf.open(path) as document: pixmap1 = document[0].get_pixmap() document.save(path_clean, clean=1) with pymupdf.open(path_clean) as document: page = document[0] pixmap2 = document[0].get_pixmap() rms = gentle_compare.pixmaps_rms(pixmap1, pixmap2) print(f'test_4034(): Comparison of original/cleaned page 0 pixmaps: {rms=}.') assert rms == 0 def test_4309(): document = pymupdf.open() page = document.new_page() document.delete_page() def test_4263(): if os.environ.get('PYODIDE_ROOT'): print('test_4263(): not running on Pyodide - cannot run child processes.') return path = os.path.normpath(f'{__file__}/../../tests/resources/test_4263.pdf') path_out = f'{path}.linerarized.pdf' command = f'pymupdf clean -linear {path} {path_out}' print(f'Running: {command}') cp = subprocess.run(command, shell=1, check=0) # Support for linerarisation dropped in MuPDF-1.26. assert cp.returncode def test_4224(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4224.pdf') with pymupdf.open(path) as document: for page in document.pages(): pixmap = page.get_pixmap(dpi=150) path_pixmap = f'{path}.{page.number}.png' pixmap.save(path_pixmap) print(f'Have created: {path_pixmap}') def test_4319(): # Have not seen this test reproduce issue #4319, but keeping it anyway. path = os.path.normpath(f'{__file__}/../../tests/resources/test_4319.pdf') doc = pymupdf.open() page = doc.new_page() page.insert_text((10, 100), "some text") doc.save(path) doc.close() doc = pymupdf.open(path) page = doc[0] pc = doc.page_count doc.close() os.remove(path) print(f"removed {doc.name=}") def test_3886(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3886.pdf') path_clean0 = os.path.normpath(f'{__file__}/../../tests/resources/test_3886_clean0.pdf') path_clean1 = os.path.normpath(f'{__file__}/../../tests/resources/test_3886_clean1.pdf') with pymupdf.open(path) as document: pixmap = document[0].get_pixmap() document.save(path_clean0, clean=0) with pymupdf.open(path) as document: document.save(path_clean1, clean=1) with pymupdf.open(path_clean0) as document: pixmap_clean0 = document[0].get_pixmap() with pymupdf.open(path_clean1) as document: pixmap_clean1 = document[0].get_pixmap() rms_0 = gentle_compare.pixmaps_rms(pixmap, pixmap_clean0) rms_1 = gentle_compare.pixmaps_rms(pixmap, pixmap_clean1) print(f'test_3886(): {rms_0=} {rms_1=}') def test_4415(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4415.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4415_out.png') path_out_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4415_out_expected.png') with pymupdf.open(path) as document: page = document[0] rot = page.rotation orig = pymupdf.Point(100, 100) # apparent insertion point text = 'Text at Top-Left' mrot = page.derotation_matrix # matrix annihilating page rotation page.insert_text(orig * mrot, text, fontsize=60, rotate=rot) pixmap = page.get_pixmap() pixmap.save(path_out) rms = gentle_compare.pixmaps_rms(path_out_expected, path_out) assert rms == 0, f'{rms=}' def test_4466(): path = os.path.normpath(f'{__file__}/../../tests/test_4466.pdf') with pymupdf.Document(path) as document: for page in document: print(f'{page=}', flush=1) pixmap = page.get_pixmap(clip=(0, 0, 10, 10)) print(f'{pixmap.n=} {pixmap.size=} {pixmap.stride=} {pixmap.width=} {pixmap.height=} {pixmap.x=} {pixmap.y=}', flush=1) pixmap.is_unicolor # Used to crash. def test_4479(): # This passes with pymupdf-1.24.14, fails with pymupdf==1.25.*, passes with # pymupdf-1.26.0. print() path = os.path.normpath(f'{__file__}/../../tests/resources/test_4479.pdf') with pymupdf.open(path) as document: def show(items): for item in items: print(f' {repr(item)}') items = document.layer_ui_configs() show(items) assert items == [ {'depth': 0, 'locked': 0, 'number': 0, 'on': 1, 'text': 'layer_0', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 1, 'on': 1, 'text': 'layer_1', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 2, 'on': 0, 'text': 'layer_2', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 3, 'on': 1, 'text': 'layer_3', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 4, 'on': 1, 'text': 'layer_4', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 5, 'on': 1, 'text': 'layer_5', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 6, 'on': 1, 'text': 'layer_6', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 7, 'on': 1, 'text': 'layer_7', 'type': 'checkbox'}, ] document.set_layer_ui_config(0, pymupdf.PDF_OC_OFF) items = document.layer_ui_configs() show(items) assert items == [ {'depth': 0, 'locked': 0, 'number': 0, 'on': 0, 'text': 'layer_0', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 1, 'on': 1, 'text': 'layer_1', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 2, 'on': 0, 'text': 'layer_2', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 3, 'on': 1, 'text': 'layer_3', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 4, 'on': 1, 'text': 'layer_4', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 5, 'on': 1, 'text': 'layer_5', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 6, 'on': 1, 'text': 'layer_6', 'type': 'checkbox'}, {'depth': 0, 'locked': 0, 'number': 7, 'on': 1, 'text': 'layer_7', 'type': 'checkbox'}, ] def test_4533(): if os.environ.get('PYODIDE_ROOT'): print('test_4533(): not running on Pyodide - cannot run child processes.') return print() path = util.download( 'https://github.com/user-attachments/files/20497146/NineData_user_manual_V3.0.5.pdf', 'test_4533.pdf', size=16864501, ) # This bug is a segv so we run the test in a child process. command = f'{sys.executable} -c "import pymupdf; document = pymupdf.open({path!r}); print(len(document))"' print(f'Running: {command}') cp = subprocess.run(command, shell=1, check=0) e = cp.returncode print(f'{e=}') if pymupdf.mupdf_version_tuple >= (1, 26, 6): assert e == 0 else: assert e != 0 def test_4564(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4564.pdf') print() with pymupdf.open(path) as document: for key in sorted(document.metadata.keys()): value = document.metadata[key] print(f'{key}: {value!r}') if pymupdf.mupdf_version_tuple >= (1, 27): assert document.metadata['producer'] == 'Adobe PSL 1.3e for Canon\x00' else: assert document.metadata['producer'] == 'Adobe PSL 1.3e for Canon\udcc0\udc80' def test_4496(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4496.hwpx') with pymupdf.open(path) as document: print(document.page_count) def test_gitinfo(): # This doesn't really test very much, but can be useful to see the current # values. print('') print(f'test_4496():') print(f'{pymupdf.mupdf_location=}') print(f'{pymupdf.mupdf_version=}') print(f'{pymupdf.pymupdf_git_branch=}') print(f'{pymupdf.pymupdf_git_sha=}') print(f'{pymupdf.pymupdf_version=}') print(f'{pymupdf.pymupdf_git_diff=}') if pymupdf.pymupdf_git_diff: print(f'pymupdf.pymupdf_git_diff:\n{textwrap.indent(pymupdf.pymupdf_git_diff, " ")}') def test_4392(): if os.environ.get('PYODIDE_ROOT'): print('test_4392(): not running on Pyodide - cannot run child processes.') return print('', flush=1) path = os.path.normpath(f'{__file__}/../../tests/test_4392.py') with open(path, 'w') as f: f.write('import pymupdf\n') command = f'pytest {path}' print(f'Running: {command}', flush=1) e1 = subprocess.run(command, shell=1, check=0).returncode print(f'{e1=}') command = f'pytest -Werror {path}' print(f'Running: {command}', flush=1) e2 = subprocess.run(command, shell=1, check=0).returncode print(f'{e2=}') command = f'{sys.executable} -Werror -c "import pymupdf"' print(f'Running: {command}', flush=1) e3 = subprocess.run(command, shell=1, check=0).returncode print(f'{e3=}') print(f'{e1=} {e2=} {e3=}', flush=1) print(f'{pymupdf.swig_version=}', flush=1) print(f'{pymupdf.swig_version_tuple=}', flush=1) assert e1 == 5 if pymupdf.swig_version_tuple >= (4, 4): if sysconfig.get_config_var('Py_GIL_DISABLED') == 1 and sys._is_gil_enabled(): assert e2 == 4 else: assert e2 == 5 if sysconfig.get_config_var('Py_GIL_DISABLED') == 1 and sys._is_gil_enabled(): # GIL warning results in failure because of -Werror. assert e3 == 1 else: assert e3 == 0 else: # We get SEGV's etc with older swig. if platform.system() == 'Windows': assert (e2, e3) == (0xc0000005, 0xc0000005) elif platform.system() == 'Linux': # On plain linux we get (139, 139). On manylinux we get (-11, # -11). On MacOS we get (-11, -11). assert (e2, e3) == (139, 139) or (e2, e3) == (-11, -11) elif platform.system() == 'Darwin': # python3.14t gives (4, -11)? assert (e2, e3) == (-11, -11) or (e2, e3) == (4, -11) else: assert e2 and e3 def test_4639(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4639.pdf') with pymupdf.open(path) as document: page = document[-1] page.get_bboxlog(layers=True) def test_4590(): # Create test PDF. path = os.path.normpath(f'{__file__}/../../tests/test_4590.pdf') with pymupdf.open() as document: page = document.new_page() # Add some text text = 'This PDF contains a file attachment annotation.' page.insert_text((72, 72), text, fontsize=12) # Create a sample file. path_sample = os.path.normpath(f'{__file__}/../../tests/test_4590_annotation_sample.txt') with open(path_sample, 'w') as f: f.write('This is a sample attachment file.') # Read file as bytes with open(path_sample, 'rb') as f: sample = f.read() # Define annotation position (rect or point) annot_pos = pymupdf.Rect(72, 100, 92, 120) # PushPin icon rectangle # Add the file attachment annotation page.add_file_annot( point = annot_pos, buffer_ = sample, filename = 'sample.txt', ufilename = 'sample.txt', desc = 'A test attachment file.', icon = 'PushPin', ) # Save the PDF document.save(path) # Check pymupdf.Document.scrub() works. with pymupdf.open(path) as document: document.scrub() def test_4702(): if os.environ.get('PYODIDE_ROOT'): # util.download() uses subprocess. print('test_4702(): not running on Pyodide - cannot run child processes.') return path = util.download( 'https://github.com/user-attachments/files/22403483/01995b6ca7837b52abaa24e38e8c076d.pdf', 'test_4702.pdf', ) with pymupdf.open(path) as document: for xref in range(1, document.xref_length()): print(f'{xref=}') try: _ = document.xref_object(xref) except Exception as e1: print(f'{e1=}') try: document.update_object(xref, "<<>>") except Exception as e2: print(f'{e2=}') raise wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document' with pymupdf.open(path) as document: for xref in range(1, document.xref_length()): print(f'{xref=}') _ = document.xref_object(xref) wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document' def test_4712(): ''' Crash with "corrupted double-linked list ''' if pymupdf.mupdf_version_tuple < (1, 26, 11): print(f'test_4712m(): Not running because known to fail on mupdf < 1.26.11: {pymupdf.mupdf_version=}.') return path_a = os.path.normpath(f'{__file__}/../../tests/resources/test_4712_a.pdf') path_b = os.path.normpath(f'{__file__}/../../tests/resources/test_4712_b.pdf') doc1 = pymupdf.open(path_a) for i in range(6): doc1.load_page(i).get_pixmap() doc2 = pymupdf.open(path_b) for i in range(6): doc2.load_page(i).get_pixmap() def test_4712m(): if pymupdf.mupdf_version_tuple < (1, 26, 11): print(f'test_4712m(): Not running because known to fail on mupdf < 1.26.11: {pymupdf.mupdf_version=}.') return path_a = os.path.normpath(f'{__file__}/../../tests/resources/test_4712_a.pdf') path_b = os.path.normpath(f'{__file__}/../../tests/resources/test_4712_b.pdf') mupdf = pymupdf.mupdf def get_pixmap(page): displaylist = mupdf.fz_new_display_list_from_page(page) rect = mupdf.fz_bound_display_list(displaylist) irect = mupdf.fz_round_rect(rect) pixmap = mupdf.fz_new_pixmap_with_bbox( mupdf.FzColorspace(mupdf.FzColorspace.Fixed_RGB), irect, mupdf.FzSeparations(), 0, # alpha ) mupdf.fz_clear_pixmap_with_value(pixmap, 0xFF) matrix = mupdf.FzMatrix() device = mupdf.fz_new_draw_device(matrix, pixmap) mupdf.fz_run_display_list( displaylist, device, mupdf.FzMatrix(), mupdf.FzRect(mupdf.FzRect.Fixed_INFINITE), mupdf.FzCookie(), ) mupdf.fz_close_device(device) def process_document(document): for i in range(6): print(f' {i=}', flush=1) page = mupdf.fz_load_page(document, i) get_pixmap(page) print(f'Processing {path_a=}', flush=1) document_a = mupdf.fz_open_document(path_a) process_document(document_a) print(f'Processing {path_b=}', flush=1) document_b = mupdf.fz_open_document(path_b) process_document(document_b) def test_4746(): archive = pymupdf.Archive('.') archive.add(__file__, 'foo') def test_4907(): print() path = os.path.normpath(f'{__file__}/../../tests/resources/test_4907.pdf') with pymupdf.open(path) as document: for i, page in enumerate(document): print(f'{i=}') display_list = page.get_displaylist(annots=False) text_page = display_list.get_textpage() def test_4928(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4928.pdf') with pymupdf.open(path) as document: document.scrub() def test_4902(): print() print(f'test_4902(): {pymupdf.mupdf_version_tuple=}') with pymupdf.open() as doc: page = doc.new_page() text = 'Hello World' bw = 0.4 fontsize = 20 page.insert_text( (72, 72), text, fontsize=fontsize, render_mode=2, color=(1, 0, 0), fill=(0, 1, 0), border_width=bw, ) data = doc.tobytes() with pymupdf.open('pdf', data) as doc: page = doc[0] spans = page.get_texttrace() for i, span in enumerate(spans): cs = ''.join([chr(cc[0]) for cc in span['chars']]) print(f'test_4902(): {i=} {span["linewidth"]=} {cs=}') assert len(spans) == 2 assert spans[0]['linewidth'] is None assert spans[1]['linewidth'] == 8.0 ================================================ FILE: tests/test_geometry.py ================================================ """ * Check various construction methods of rects, points, matrices * Check matrix inversions in variations * Check algebra constructs """ import os import pymupdf def test_rect(): assert tuple(pymupdf.Rect()) == (0, 0, 0, 0) if hasattr(pymupdf, 'mupdf'): assert tuple(pymupdf.Rect(y0=12)) == (0, 12, 0, 0) assert tuple(pymupdf.Rect(10, 20, 100, 200, x1=12)) == (10, 20, 12, 200) p1 = pymupdf.Point(10, 20) p2 = pymupdf.Point(100, 200) p3 = pymupdf.Point(150, 250) r = pymupdf.Rect(10, 20, 100, 200) r_tuple = tuple(r) assert tuple(pymupdf.Rect(p1, p2)) == r_tuple assert tuple(pymupdf.Rect(p1, 100, 200)) == r_tuple assert tuple(pymupdf.Rect(10, 20, p2)) == r_tuple assert tuple(r.include_point(p3)) == (10, 20, 150, 250) r = pymupdf.Rect(10, 20, 100, 200) assert tuple(r.include_rect((100, 200, 110, 220))) == (10, 20, 110, 220) r = pymupdf.Rect(10, 20, 100, 200) # include empty rect makes no change assert tuple(r.include_rect((0, 0, 0, 0))) == r_tuple # include invalid rect makes no change assert tuple(r.include_rect((1, 1, -1, -1))) == r_tuple r = pymupdf.Rect() for i in range(4): r[i] = i + 1 assert r == pymupdf.Rect(1, 2, 3, 4) assert pymupdf.Rect() / 5 == pymupdf.Rect() assert pymupdf.Rect(1, 1, 2, 2) / pymupdf.Identity == pymupdf.Rect(1, 1, 2, 2) failed = False try: r = pymupdf.Rect(1) except: failed = True assert failed failed = False try: r = pymupdf.Rect(1, 2, 3, 4, 5) except: failed = True assert failed failed = False try: r = pymupdf.Rect((1, 2, 3, 4, 5)) except: failed = True assert failed failed = False try: r = pymupdf.Rect(1, 2, 3, "x") except: failed = True assert failed failed = False try: r = pymupdf.Rect() r[5] = 1 except: failed = True assert failed def test_irect(): p1 = pymupdf.Point(10, 20) p2 = pymupdf.Point(100, 200) p3 = pymupdf.Point(150, 250) r = pymupdf.IRect(10, 20, 100, 200) r_tuple = tuple(r) assert tuple(pymupdf.IRect(p1, p2)) == r_tuple assert tuple(pymupdf.IRect(p1, 100, 200)) == r_tuple assert tuple(pymupdf.IRect(10, 20, p2)) == r_tuple assert tuple(r.include_point(p3)) == (10, 20, 150, 250) r = pymupdf.IRect(10, 20, 100, 200) assert tuple(r.include_rect((100, 200, 110, 220))) == (10, 20, 110, 220) r = pymupdf.IRect(10, 20, 100, 200) # include empty rect makes no change assert tuple(r.include_rect((0, 0, 0, 0))) == r_tuple r = pymupdf.IRect() for i in range(4): r[i] = i + 1 assert r == pymupdf.IRect(1, 2, 3, 4) failed = False try: r = pymupdf.IRect(1) except: failed = True assert failed failed = False try: r = pymupdf.IRect(1, 2, 3, 4, 5) except: failed = True assert failed failed = False try: r = pymupdf.IRect((1, 2, 3, 4, 5)) except: failed = True assert failed failed = False try: r = pymupdf.IRect(1, 2, 3, "x") except: failed = True assert failed failed = False try: r = pymupdf.IRect() r[5] = 1 except: failed = True assert failed def test_inversion(): alpha = 255 m1 = pymupdf.Matrix(alpha) m2 = pymupdf.Matrix(-alpha) m3 = m1 * m2 # should equal identity matrix assert abs(m3 - pymupdf.Identity) < pymupdf.EPSILON m = pymupdf.Matrix(1, 0, 1, 0, 1, 0) # not invertible! # inverted matrix must be zero assert ~m == pymupdf.Matrix() def test_matrix(): assert tuple(pymupdf.Matrix()) == (0, 0, 0, 0, 0, 0) assert tuple(pymupdf.Matrix(90)) == (0, 1, -1, 0, 0, 0) if hasattr(pymupdf, 'mupdf'): assert tuple(pymupdf.Matrix(c=1)) == (0, 0, 1, 0, 0, 0) assert tuple(pymupdf.Matrix(90, e=5)) == (0, 1, -1, 0, 5, 0) m45p = pymupdf.Matrix(45) m45m = pymupdf.Matrix(-45) m90 = pymupdf.Matrix(90) assert abs(m90 - m45p * m45p) < pymupdf.EPSILON assert abs(pymupdf.Identity - m45p * m45m) < pymupdf.EPSILON assert abs(m45p - ~m45m) < pymupdf.EPSILON assert pymupdf.Matrix(2, 3, 1) == pymupdf.Matrix(1, 3, 2, 1, 0, 0) m = pymupdf.Matrix(2, 3, 1) m.invert() assert abs(m * pymupdf.Matrix(2, 3, 1) - pymupdf.Identity) < pymupdf.EPSILON assert pymupdf.Matrix(1, 1).pretranslate(2, 3) == pymupdf.Matrix(1, 0, 0, 1, 2, 3) assert pymupdf.Matrix(1, 1).prescale(2, 3) == pymupdf.Matrix(2, 0, 0, 3, 0, 0) assert pymupdf.Matrix(1, 1).preshear(2, 3) == pymupdf.Matrix(1, 3, 2, 1, 0, 0) assert abs(pymupdf.Matrix(1, 1).prerotate(30) - pymupdf.Matrix(30)) < pymupdf.EPSILON small = 1e-6 assert pymupdf.Matrix(1, 1).prerotate(90 + small) == pymupdf.Matrix(90) assert pymupdf.Matrix(1, 1).prerotate(180 + small) == pymupdf.Matrix(180) assert pymupdf.Matrix(1, 1).prerotate(270 + small) == pymupdf.Matrix(270) assert pymupdf.Matrix(1, 1).prerotate(small) == pymupdf.Matrix(0) assert pymupdf.Matrix(1, 1).concat( pymupdf.Matrix(1, 2), pymupdf.Matrix(3, 4) ) == pymupdf.Matrix(3, 0, 0, 8, 0, 0) assert pymupdf.Matrix(1, 2, 3, 4, 5, 6) / 1 == pymupdf.Matrix(1, 2, 3, 4, 5, 6) assert m[0] == m.a assert m[1] == m.b assert m[2] == m.c assert m[3] == m.d assert m[4] == m.e assert m[5] == m.f m = pymupdf.Matrix() for i in range(6): m[i] = i + 1 assert m == pymupdf.Matrix(1, 2, 3, 4, 5, 6) failed = False try: m = pymupdf.Matrix(1, 2, 3) except: failed = True assert failed failed = False try: m = pymupdf.Matrix(1, 2, 3, 4, 5, 6, 7) except: failed = True assert failed failed = False try: m = pymupdf.Matrix((1, 2, 3, 4, 5, 6, 7)) except: failed = True assert failed failed = False try: m = pymupdf.Matrix(1, 2, 3, 4, 5, "x") except: failed = True assert failed failed = False try: m = pymupdf.Matrix(1, 0, 1, 0, 1, 0) n = pymupdf.Matrix(1, 1) / m except: failed = True assert failed def test_point(): assert tuple(pymupdf.Point()) == (0, 0) assert pymupdf.Point(1, -1).unit == pymupdf.Point(5, -5).unit assert pymupdf.Point(-1, -1).abs_unit == pymupdf.Point(1, 1).unit assert pymupdf.Point(1, 1).distance_to(pymupdf.Point(1, 1)) == 0 assert pymupdf.Point(1, 1).distance_to(pymupdf.Rect(1, 1, 2, 2)) == 0 assert pymupdf.Point().distance_to((1, 1, 2, 2)) > 0 failed = False try: p = pymupdf.Point(1, 2, 3) except: failed = True assert failed failed = False try: p = pymupdf.Point((1, 2, 3)) except: failed = True assert failed failed = False try: p = pymupdf.Point(1, "x") except: failed = True assert failed failed = False try: p = pymupdf.Point() p[3] = 1 except: failed = True assert failed def test_algebra(): p = pymupdf.Point(1, 2) m = pymupdf.Matrix(1, 2, 3, 4, 5, 6) r = pymupdf.Rect(1, 1, 2, 2) assert p + p == p * 2 assert p - p == pymupdf.Point() assert m + m == m * 2 assert m - m == pymupdf.Matrix() assert r + r == r * 2 assert r - r == pymupdf.Rect() assert p + 5 == pymupdf.Point(6, 7) assert m + 5 == pymupdf.Matrix(6, 7, 8, 9, 10, 11) assert r.tl in r assert r.tr not in r assert r.br not in r assert r.bl not in r assert p * m == pymupdf.Point(12, 16) assert r * m == pymupdf.Rect(9, 12, 13, 18) assert (pymupdf.Rect(1, 1, 2, 2) & pymupdf.Rect(2, 2, 3, 3)).is_empty assert not pymupdf.Rect(1, 1, 2, 2).intersects((2, 2, 4, 4)) failed = False try: x = m + p except: failed = True assert failed failed = False try: x = m + r except: failed = True assert failed failed = False try: x = p + r except: failed = True assert failed failed = False try: x = r + m except: failed = True assert failed assert m not in r def test_quad(): r = pymupdf.Rect(10, 10, 20, 20) q = r.quad assert q.is_rectangular assert not q.is_empty assert q.is_convex q *= pymupdf.Matrix(1, 1).preshear(2, 3) assert not q.is_rectangular assert not q.is_empty assert q.is_convex assert r.tl not in q assert r not in q assert r.quad not in q failed = False try: q[5] = pymupdf.Point() except: failed = True assert failed failed = False try: q /= (1, 0, 1, 0, 1, 0) except: failed = True assert failed def test_pageboxes(): """Tests concerning ArtBox, TrimBox, BleedBox.""" doc = pymupdf.open() page = doc.new_page() assert page.cropbox == page.artbox == page.bleedbox == page.trimbox rect_methods = ( page.set_cropbox, page.set_artbox, page.set_bleedbox, page.set_trimbox, ) keys = ("CropBox", "ArtBox", "BleedBox", "TrimBox") rect = pymupdf.Rect(100, 200, 400, 700) for f in rect_methods: f(rect) for key in keys: assert doc.xref_get_key(page.xref, key) == ("array", "[100 142 400 642]") assert page.cropbox == page.artbox == page.bleedbox == page.trimbox def test_3163(): b = {'number': 0, 'type': 0, 'bbox': (403.3577880859375, 330.8871765136719, 541.2731323242188, 349.5766296386719), 'lines': [{'spans': [{'size': 14.0, 'flags': 4, 'font': 'SFHello-Medium', 'color': 1907995, 'ascender': 1.07373046875, 'descender': -0.26123046875, 'text': 'Inclusion and diversity', 'origin': (403.3577880859375, 345.9194030761719), 'bbox': (403.3577880859375, 330.8871765136719, 541.2731323242188, 349.5766296386719)}], 'wmode': 0, 'dir': (1.0, 0.0), 'bbox': (403.3577880859375, 330.8871765136719, 541.2731323242188, 349.5766296386719)}]} bbox = pymupdf.IRect(b["bbox"]) def test_3182(): pix = pymupdf.Pixmap(os.path.abspath(f'{__file__}/../../tests/resources/img-transparent.png')) rect = pymupdf.Rect(0, 0, 100, 100) pix.invert_irect(rect) ================================================ FILE: tests/test_imagebbox.py ================================================ """ Ensure equality of bboxes computed via * page.get_image_bbox() * page.get_image_info() * page.get_bboxlog() """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "image-file1.pdf") image = os.path.join(scriptdir, "resources", "img-transparent.png") doc = pymupdf.open(filename) def test_image_bbox(): page = doc[0] imglist = page.get_images(True) bbox_list = [] for item in imglist: bbox_list.append(page.get_image_bbox(item, transform=False)) infos = page.get_image_info(xrefs=True) match = False for im in infos: bbox1 = im["bbox"] match = False for bbox2 in bbox_list: abs_bbox = (bbox2 - bbox1).norm() if abs_bbox < 1e-4: match = True break assert match def test_bboxlog(): doc = pymupdf.open() page = doc.new_page() xref = page.insert_image(page.rect, filename=image) img_info = page.get_image_info(xrefs=True) assert len(img_info) == 1 info = img_info[0] assert info["xref"] == xref bbox_log = page.get_bboxlog() assert len(bbox_log) == 1 box_type, bbox = bbox_log[0] assert box_type == "fill-image" assert bbox == info["bbox"] ================================================ FILE: tests/test_imagemasks.py ================================================ """ Confirm image mask detection in TextPage extractions. """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename1 = os.path.join(scriptdir, "resources", "img-regular.pdf") filename2 = os.path.join(scriptdir, "resources", "img-transparent.pdf") def test_imagemask1(): doc = pymupdf.open(filename1) page = doc[0] blocks = page.get_text("dict")["blocks"] img = blocks[0] assert img["mask"] is None img = page.get_image_info()[0] assert img["has-mask"] is False def test_imagemask2(): doc = pymupdf.open(filename2) page = doc[0] blocks = page.get_text("dict")["blocks"] img = blocks[0] assert type(img["mask"]) is bytes img = page.get_image_info()[0] assert img["has-mask"] is True ================================================ FILE: tests/test_import.py ================================================ import os import subprocess import sys import textwrap def test_import(): if os.environ.get('PYODIDE_ROOT'): print('test_import(): not running on Pyodide - cannot run child processes.') return root = os.path.abspath(f'{__file__}/../../') p = f'{root}/tests/resources_test_import.py' with open(p, 'w') as f: f.write(textwrap.dedent( ''' from pymupdf.utils import * from pymupdf.table import * from pymupdf import * ''' )) subprocess.run(f'{sys.executable} {p}', shell=1, check=1) ================================================ FILE: tests/test_insertimage.py ================================================ """ * Insert same image with different rotations in two places of a page. * Extract bboxes and transformation matrices * Assert image locations are inside given rectangles """ import json import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) imgfile = os.path.join(scriptdir, "resources", "nur-ruhig.jpg") def test_insert(): doc = pymupdf.open() page = doc.new_page() r1 = pymupdf.Rect(50, 50, 100, 100) r2 = pymupdf.Rect(50, 150, 200, 400) page.insert_image(r1, filename=imgfile) page.insert_image(r2, filename=imgfile, rotate=270) info_list = page.get_image_info() assert len(info_list) == 2 bbox1 = pymupdf.Rect(info_list[0]["bbox"]) bbox2 = pymupdf.Rect(info_list[1]["bbox"]) assert bbox1 in r1 assert bbox2 in r2 def test_compress(): document = pymupdf.open(f'{scriptdir}/resources/2.pdf') document_new = pymupdf.open() for page in document: pixmap = page.get_pixmap( colorspace=pymupdf.csRGB, dpi=72, annots=False, ) page_new = document_new.new_page(-1) page_new.insert_image(rect=page_new.bound(), pixmap=pixmap) document_new.save( f'{scriptdir}/resources/2.pdf.compress.pdf', garbage=3, deflate=True, deflate_images=True, deflate_fonts=True, pretty=True, ) def test_3087(): path = os.path.abspath(f'{__file__}/../../tests/resources/test_3087.pdf') doc = pymupdf.open(path) page = doc[0] print(page.get_images()) base = doc.extract_image(5)["image"] mask = doc.extract_image(5)["image"] page = doc.new_page() page.insert_image(page.rect, stream=base, mask=mask) doc = pymupdf.open(path) page = doc[0] print(page.get_images()) base = doc.extract_image(5)["image"] mask = doc.extract_image(6)["image"] page = doc.new_page() page.insert_image(page.rect, stream=base, mask=mask) ================================================ FILE: tests/test_insertpdf.py ================================================ """ * Join multiple PDFs into a new one. * Compare with stored earlier result: - must have identical object definitions - must have different trailers * Try inserting files in a loop. """ import io import os import re import pymupdf from pymupdf import mupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) resources = os.path.join(scriptdir, "resources") def approx_parse( text): ''' Splits into sequence of (text, number) pairs. Where sequence of [0-9.] is not convertible to a number (e.g. '4.5.6'), will be None. ''' ret = [] for m in re.finditer('([^0-9]+)([0-9.]*)', text): text = m.group(1) try: number = float( m.group(2)) except Exception: text += m.group(2) number = None ret.append( (text, number)) return ret def approx_compare( a, b, max_delta): ''' Compares and , allowing numbers to differ by up to . ''' aa = approx_parse( a) bb = approx_parse( b) if len(aa) != len(bb): return 1 ret = 1 for (at, an), (bt, bn) in zip( aa, bb): if at != bt: break if an is not None and bn is not None: if abs( an - bn) >= max_delta: print( f'diff={an-bn}: an={an} bn={bn}') break elif (an is None) != (bn is None): break else: ret = 0 if ret: print( f'Differ:\n a={a!r}\n b={b!r}') return ret def test_insert(): all_text_original = [] # text on input pages all_text_combined = [] # text on resulting output pages # prepare input PDFs doc1 = pymupdf.open() for i in range(5): # just arbitrary number of pages text = f"doc 1, page {i}" # the 'globally' unique text page = doc1.new_page() page.insert_text((100, 72), text) all_text_original.append(text) doc2 = pymupdf.open() for i in range(4): text = f"doc 2, page {i}" page = doc2.new_page() page.insert_text((100, 72), text) all_text_original.append(text) doc3 = pymupdf.open() for i in range(3): text = f"doc 3, page {i}" page = doc3.new_page() page.insert_text((100, 72), text) all_text_original.append(text) doc4 = pymupdf.open() for i in range(6): text = f"doc 4, page {i}" page = doc4.new_page() page.insert_text((100, 72), text) all_text_original.append(text) new_doc = pymupdf.open() # make combined PDF of input files new_doc.insert_pdf(doc1) new_doc.insert_pdf(doc2) new_doc.insert_pdf(doc3) new_doc.insert_pdf(doc4) # read text from all pages and store in list for page in new_doc: all_text_combined.append(page.get_text().replace("\n", "")) # the lists must be equal assert all_text_combined == all_text_original def test_issue1417_insertpdf_in_loop(): """Using a context manager instead of explicitly closing files""" f = os.path.join(resources, "1.pdf") big_doc = pymupdf.open() fd1 = os.open( f, os.O_RDONLY) os.close( fd1) for n in range(0, 1025): with pymupdf.open(f) as pdf: big_doc.insert_pdf(pdf) # Create a raw file descriptor. If the above pymupdf.open() context leaks # a file descriptor, fd will be seen to increment. fd2 = os.open( f, os.O_RDONLY) assert fd2 == fd1 os.close( fd2) big_doc.close() def _test_insert_adobe(): path = os.path.abspath( f'{__file__}/../../../PyMuPDF-performance/adobe.pdf') if not os.path.exists(path): print(f'Not running test_insert_adobe() because does not exist: {os.path.relpath(path)}') return a = pymupdf.Document() b = pymupdf.Document(path) a.insert_pdf(b) def _2861_2871_merge_pdf(content: bytes, coverpage: bytes): with pymupdf.Document(stream=coverpage, filetype="pdf") as coverpage_pdf: with pymupdf.Document(stream=content, filetype="pdf") as content_pdf: coverpage_pdf.insert_pdf(content_pdf) doc = coverpage_pdf.write() return doc def test_2861(): path = os.path.abspath(f'{__file__}/../../tests/resources/test_2861.pdf') with open(path, "rb") as content_pdf: with open(path, "rb") as coverpage_pdf: content = content_pdf.read() coverpage = coverpage_pdf.read() _2861_2871_merge_pdf(content, coverpage) def test_2871(): path = os.path.abspath(f'{__file__}/../../tests/resources/test_2871.pdf') with open(path, "rb") as content_pdf: with open(path, "rb") as coverpage_pdf: content = content_pdf.read() coverpage = coverpage_pdf.read() _2861_2871_merge_pdf(content, coverpage) def test_3789(): file_path = os.path.abspath(f'{__file__}/../../tests/resources/test_3789.pdf') result_path = os.path.abspath(f'{__file__}/../../tests/test_3789_out') pages_per_split = 5 # Clean pdf doc = pymupdf.open(file_path) tmp = io.BytesIO() tmp.write(doc.write(garbage=4, deflate=True)) source_doc = pymupdf.Document('pdf', tmp.getvalue()) tmp.close() # Calculate the number of pages per split file and the number of split files page_range = pages_per_split - 1 split_range = range(0, source_doc.page_count, pages_per_split) num_splits = len(split_range) # Loop through each split range and create a new PDF file for i, start in enumerate(split_range): output_doc = pymupdf.open() # Determine the ending page for this split file to_page = start + page_range if i < num_splits - 1 else -1 output_doc.insert_pdf(source_doc, from_page=start, to_page=to_page) # Save the output document to a file and add the path to the list of split files path = f'{result_path}_{i}.pdf' output_doc.save(path, garbage=2) print(f'Have saved to {path=}.') # If this is the last split file, exit the loop if to_page == -1: break def test_widget_insert(): """Confirm copy of form fields / widgets.""" tar = pymupdf.open(os.path.join(resources, "merge-form1.pdf")) pc0 = tar.page_count # for later assertion src = pymupdf.open(os.path.join(resources, "interfield-calculation.pdf")) pc1 = src.page_count # for later assertion tarpdf = pymupdf._as_pdf_document(tar) tar_field_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(tarpdf), "Root/AcroForm/Fields") ) tar_co_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(tarpdf), "Root/AcroForm/CO") ) srcpdf = pymupdf._as_pdf_document(src) src_field_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(srcpdf), "Root/AcroForm/Fields") ) src_co_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(srcpdf), "Root/AcroForm/CO") ) tar.insert_pdf(src) new_field_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(tarpdf), "Root/AcroForm/Fields") ) new_co_count = mupdf.pdf_array_len( mupdf.pdf_dict_getp(mupdf.pdf_trailer(tarpdf), "Root/AcroForm/CO") ) assert tar.page_count == pc0 + pc1 assert new_field_count == tar_field_count + src_field_count assert new_co_count == tar_co_count + src_co_count def names_and_kids(doc): """Return a list of dictionaries with keys "name" and "kids". "name" is the name of a root field in "Root/AcroForm/Fields", and "kids" is the count of its immediate children. """ rc = [] pdf = pymupdf._as_pdf_document(doc) fields = mupdf.pdf_dict_getl( mupdf.pdf_trailer(pdf), pymupdf.PDF_NAME("Root"), pymupdf.PDF_NAME("AcroForm"), pymupdf.PDF_NAME("Fields"), ) if not fields.pdf_is_array(): return rc root_count = fields.pdf_array_len() if not root_count: return rc for i in range(root_count): field = fields.pdf_array_get(i) kids = field.pdf_dict_get(pymupdf.PDF_NAME("Kids")) kid_count = kids.pdf_array_len() T = field.pdf_dict_get_text_string(pymupdf.PDF_NAME("T")) field_dict = {"name": T, "kids": kid_count} rc.append(field_dict) return rc def test_merge_checks1(): """Merge Form PDFs making any duplicate names unique.""" merge_file1 = os.path.join(resources, "merge-form1.pdf") merge_file2 = os.path.join(resources, "merge-form2.pdf") tar = pymupdf.open(merge_file1) rc0 = names_and_kids(tar) src = pymupdf.open(merge_file2) rc1 = names_and_kids(src) tar.insert_pdf(src, join_duplicates=False) rc2 = names_and_kids(tar) assert len(rc2) == len(rc0) + len(rc1) def test_merge_checks2(): # Join / merge Form PDFs joining any duplicate names in the src PDF. merge_file1 = os.path.join(resources, "merge-form1.pdf") merge_file2 = os.path.join(resources, "merge-form2.pdf") tar = pymupdf.open(merge_file1) rc0 = names_and_kids(tar) # list of root names and kid counts names0 = [itm["name"] for itm in rc0] # root names in target kids0 = sum([itm["kids"] for itm in rc0]) # number of kids in target src = pymupdf.open(merge_file2) rc1 = names_and_kids(src) # list of root namesand kids in source PDF dup_count = 0 # counts duplicate names in source PDF dup_kids = 0 # counts the expected kids after merge for itm in rc1: # walk root fields of source pdf if itm["name"] not in names0: # not a duplicate name continue # if target field has kids, add their count, else add 1 dup_kids0 = sum([i["kids"] for i in rc0 if i["name"] == itm["name"]]) dup_kids += dup_kids0 if dup_kids0 else 1 # if source field has kids add their count, else add 1 dup_kids += itm["kids"] if itm["kids"] else 1 names1 = [itm["name"] for itm in rc1] # names in source tar.insert_pdf(src, join_duplicates=True) # join merging any duplicate names rc2 = names_and_kids(tar) # get names and kid counts in resulting PDF names2 = [itm["name"] for itm in rc2] # resulting names in target kids2 = sum([itm["kids"] for itm in rc2]) # total resulting kid count assert len(set(names0 + names1)) == len(names2) assert kids2 == dup_kids test_4412_path = os.path.normpath(f'{__file__}/../../tests/resources/test_4412.pdf') def test_4412(): # This tests whether a page from a PDF containing widgets found in the wild # can be inserted into a new document with default options (widget=True) # and widget=False. print() for widget in True, False: print(f'{widget=}', flush=1) with pymupdf.open(test_4412_path) as doc, pymupdf.open() as new_doc: buf = io.BytesIO() new_doc.insert_pdf(doc, from_page=1, to_page=1) new_doc.save(buf) assert len(new_doc)==1 def test_4571(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4571.pdf') path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4571_out.pdf') with pymupdf.open() as newdocument: with pymupdf.open(path) as document: newdocument.insert_pdf(document) newdocument.save(path_out, garbage=4, clean=False) print(f'Have saved to: {path_out=}') with open(path_out, 'rb') as f: content = f.read() if pymupdf.mupdf_version_tuple >= (1, 26, 6): # Correct. assert b'<>' in content else: # Incorrect. assert b'<>' in content def test_4958(): print() with pymupdf.Document() as document_orig, pymupdf.Document() as document_copy: document_orig.new_page() document_orig[0].set_rotation(90) document_orig[0].insert_link( { 'kind': 2, 'from': pymupdf.Rect(10, 20, 40, 60), 'uri': 'https://example.org' } ) document_copy.insert_pdf(document_orig, links=True) path_orig = os.path.normpath(f'{__file__}/../../tests/test_4958_out_orig.pdf') path_copy = os.path.normpath(f'{__file__}/../../tests/test_4958_out_copy.pdf') document_orig.save(path_orig) document_copy.save(path_copy) print(f'Have created {path_orig=}') print(f'Have created {path_copy=}') from_rects_orig = [l['from'] for l in document_orig[0].get_links()] from_rects_copy = [l['from'] for l in document_copy[0].get_links()] print(f'test_4958(): orig: {from_rects_orig}') print(f'test_4958(): copy: {from_rects_copy}') assert from_rects_orig == from_rects_copy ================================================ FILE: tests/test_linebreaks.py ================================================ import pymupdf import os.path def test_linebreaks(): """Test avoidance of linebreaks.""" path = os.path.abspath(f"{__file__}/../../tests/resources/test-linebreaks.pdf") doc = pymupdf.open(path) page = doc[0] tp = page.get_textpage(flags=pymupdf.TEXTFLAGS_WORDS) word_count = len(page.get_text("words", textpage=tp)) line_count1 = len(page.get_text(textpage=tp).splitlines()) line_count2 = len(page.get_text(sort=True, textpage=tp).splitlines()) assert word_count == line_count1 assert line_count2 < line_count1 / 2 ================================================ FILE: tests/test_linequad.py ================================================ """ Check approx. equality of search quads versus quads recovered from text extractions. """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "quad-calc-0.pdf") def test_quadcalc(): text = " angle 327" # search for this text doc = pymupdf.open(filename) page = doc[0] # This special page has one block with one line, and # its last span contains the searched text. block = page.get_text("dict", flags=0)["blocks"][0] line = block["lines"][0] # compute quad of last span in line lineq = pymupdf.recover_line_quad(line, spans=line["spans"][-1:]) # let text search find the text returning quad coordinates rl = page.search_for(text, quads=True) searchq = rl[0] assert abs(searchq.ul - lineq.ul) <= 1e-4 assert abs(searchq.ur - lineq.ur) <= 1e-4 assert abs(searchq.ll - lineq.ll) <= 1e-4 assert abs(searchq.lr - lineq.lr) <= 1e-4 ================================================ FILE: tests/test_memory.py ================================================ import pymupdf import util import gc import os import platform import sys def merge_pdf(content: bytes, coverpage: bytes): with pymupdf.Document(stream=coverpage, filetype='pdf') as coverpage_pdf: with pymupdf.Document(stream=content, filetype='pdf') as content_pdf: coverpage_pdf.insert_pdf(content_pdf) doc = coverpage_pdf.write() return doc def test_2791(): ''' Check for memory leaks. ''' if util.skip_slow_tests('test_2791'): return if os.environ.get('PYODIDE_ROOT'): print('test_2791(): not running on Pyodide - No module named \'psutil\'.') return if os.environ.get('PYMUPDF_RUNNING_ON_VALGRIND') == '1': print(f'test_2791(): not running because PYMUPDF_RUNNING_ON_VALGRIND=1.') return if platform.system().startswith('MSYS_NT-'): print(f'test_2791(): not running on msys2 - psutil not available.') return #stat_type = 'tracemalloc' stat_type = 'psutil' if stat_type == 'tracemalloc': import tracemalloc tracemalloc.start(10) def get_stat(): current, peak = tracemalloc.get_traced_memory() return current elif stat_type == 'psutil': # We use RSS, as used by mprof. import psutil process = psutil.Process() def get_stat(): return process.memory_info().rss else: def get_stat(): return 0 n = 1000 verbose = False if platform.python_implementation() == 'GraalVM': n = 10 verbose = True stats = [1] * n for i in range(n): if verbose: print(f'{i+1}/{n}.', flush=1) root = os.path.abspath(f'{__file__}/../../tests/resources') with open(f'{root}/test_2791_content.pdf', 'rb') as content_pdf: with open(f'{root}/test_2791_coverpage.pdf', 'rb') as coverpage_pdf: content = content_pdf.read() coverpage = coverpage_pdf.read() merge_pdf(content, coverpage) sys.stdout.flush() gc.collect() stats[i] = get_stat() print(f'Memory usage {stat_type=}.') for i, stat in enumerate(stats): sys.stdout.write(f' {stat}') #print(f' {i}: {stat}') sys.stdout.write('\n') first = stats[2] last = stats[-1] ratio = last / first print(f'{first=} {last=} {ratio=}') if platform.system() != 'Linux': # Values from psutil indicate larger memory leaks on non-Linux. Don't # yet know whether this is because rss is measured differently or a # genuine leak is being exposed. print(f'test_2791(): not asserting ratio because not running on Linux.') elif not hasattr(pymupdf, 'mupdf'): # Classic implementation has unfixed leaks. print(f'test_2791(): not asserting ratio because using classic implementation.') elif [int(x) for x in platform.python_version_tuple()[:2]] < [3, 11]: print(f'test_2791(): not asserting ratio because python version less than 3.11: {platform.python_version()=}.') elif stat_type == 'tracemalloc': # With tracemalloc Before fix to src/extra.i's calls to # PyObject_CallMethodObjArgs, ratio was 4.26; after it was 1.40. assert ratio > 1 and ratio < 1.6 elif stat_type == 'psutil': # Prior to fix, ratio was 1.043. After the fix, improved to 1.005, but # varies and sometimes as high as 1.010. # 2024-06-03: have seen 0.99919 on musl linux, and sebras reports .025. assert ratio >= 0.990 and ratio < 1.027, f'{ratio=}' else: pass def test_4090(): if os.environ.get('PYODIDE_ROOT'): print('test_4090(): not running on Pyodide - No module named \'psutil\'.') return print(f'test_4090(): {os.environ.get("PYTHONMALLOC")=}.') import psutil process = psutil.Process() rsss = list() def rss(): ret = process.memory_info().rss rsss.append(ret) return ret path = os.path.normpath(f'{__file__}/../../tests/resources/test_4090.pdf') for i in range(100): d = dict() d[i] = dict() with pymupdf.open(path) as document: for j, page in enumerate(document): d[i][j] = page.get_text('rawdict') print(f'test_4090(): {i}: {rss()=}') print(f'test_4090(): {rss()=}') gc.collect() print(f'test_4090(): {rss()=}') r1 = rsss[2] r2 = rsss[-1] r = r2 / r1 if platform.system() == 'Windows': assert 0.93 <= r < 1.05, f'{r1=} {r2=} {r=}.' else: assert 0.95 <= r < 1.05, f'{r1=} {r2=} {r=}.' def show_tracemalloc_diff(snapshot1, snapshot2): top_stats = snapshot2.compare_to(snapshot1, 'lineno') n = 0 mem = 0 for i in top_stats: n += i.count mem += i.size print(f'{n=}') print(f'{mem=}') print("Top 10:") for stat in top_stats[:10]: print(f' {stat}') snapshot_diff = snapshot2.compare_to(snapshot1, key_type='lineno') print(f'snapshot_diff:') count_diff = 0 size_diff = 0 for i, s in enumerate(snapshot_diff): print(f' {i}: {s.count=} {s.count_diff=} {s.size=} {s.size_diff=} {s.traceback=}') count_diff += s.count_diff size_diff += s.size_diff print(f'{count_diff=} {size_diff=}') def test_4125(): if os.environ.get('PYODIDE_ROOT'): print('test_4125(): not running on Pyodide - No module named \'psutil\'.') return if os.environ.get('PYMUPDF_RUNNING_ON_VALGRIND') == '1': print(f'test_4125(): not running because PYMUPDF_RUNNING_ON_VALGRIND=1.') return if platform.system().startswith('MSYS_NT-'): print(f'test_4125(): not running on msys2 - psutil not available.') return print('') print(f'test_4125(): {platform.python_version()=}.') path = os.path.normpath(f'{__file__}/../../tests/resources/test_4125.pdf') import gc import psutil root = os.path.normpath(f'{__file__}/../..') import pipcl process = psutil.Process() class State: pass state = State() state.rsss = list() state.prev = None def get_stat(): rss = process.memory_info().rss if not state.rsss: state.prev = rss state.rsss.append(rss) drss = rss - state.prev state.prev = rss print(f'test_4125():' f' {rss=:,}' f' rss-rss0={rss-state.rsss[0]:,}' f' drss={drss:,}' f'.' ) for i in range(10): with pymupdf.open(path) as document: for page in document: for image_info in page.get_images(full=True): xref, smask, width, height, bpc, colorspace, alt_colorspace, name, filter_, referencer = image_info pixmap = pymupdf.Pixmap(document, xref) if pixmap.colorspace != pymupdf.csRGB: pixmap2 = pymupdf.Pixmap(pymupdf.csRGB, pixmap) del pixmap2 del pixmap pymupdf.TOOLS.store_shrink(100) pymupdf.TOOLS.glyph_cache_empty() gc.collect() get_stat() if platform.system() == 'Linux': rss_delta = state.rsss[-1] - state.rsss[3] print(f'{rss_delta=}') pv = platform.python_version_tuple() pv = (int(pv[0]), int(pv[1])) if pv < (3, 11): # Python < 3.11 has less reliable memory usage so we exclude. print(f'test_4125(): Not checking on {platform.python_version()=} because < 3.11.') else: # Before the fix, each iteration would leak 4.9MB. rss_delta_max = 100*1000 * (len(state.rsss) - 3) assert rss_delta < rss_delta_max else: # Unfortunately on non-Linux Github test machines the RSS values seem # to vary a lot, which causes spurious test failures. So for at least # we don't actually check. # print(f'Not checking results because non-Linux behaviour is too variable.') def _test_4751(): import gc import tracemalloc def analysis(stream_data, do_iter=True): pdf_info = pymupdf.Document(stream=stream_data, filetype='pdf') tmp_list = range(len(pdf_info)) for page_num in tmp_list: page = pdf_info[page_num] raw_info = page.get_text('rawdict')['blocks'] page_widgets_list = page.widgets() if do_iter: for widget_info in page_widgets_list: print(widget_info) del page_widgets_list pdf_info.close() pdf_info = None pymupdf.TOOLS.store_shrink(100) file_path = os.path.normpath(f'{__file__}/../../tests/resources/test_4751.pdf') def log(text): print(text, flush=1) # We filter out all allocations where leaf-most frame is in tracemalloc # itself, or in test_memory.py itself, because these are not relevant # to finding leaks in pymupdf. # tm_filters = [ tracemalloc.Filter(inclusive=False, filename_pattern=tracemalloc.__file__, all_frames=True), tracemalloc.Filter(inclusive=False, filename_pattern=__file__), ] def get_snapshot(): ''' Wrapper for tracemalloc.take_snapshot() that filters out blocks with backtraces that we are not interested in. ''' ret = tracemalloc.take_snapshot() ret2 = ret.filter_traces(tm_filters) #log(f' {len(ret.traces)=} => {len(ret2.traces)=}') return ret2 # Check that `analysis()` does not leak. # num_leaks = 0 with open(file_path,'rb') as f: bytes_data = f.read() tracemalloc.start(30) snapshot_prev = get_snapshot() for it in range(2): log('') log(f'{it=}') current, peak = tracemalloc.get_traced_memory() log(f' {current=} {peak=}') analysis(bytes_data) gc.collect() snapshot = get_snapshot() top_stats = snapshot.compare_to(snapshot_prev, 'traceback') snapshot_prev = snapshot top_stats = sorted(top_stats, key=lambda x: -x.size_diff) for block_num, stat in enumerate(top_stats[0:10]): if stat.size_diff > 0: log(f' Leak detected') log(f' {block_num=} {stat.size_diff=}: {stat}') bt = '' for frame in stat.traceback: bt += f' {frame.filename}:{frame.lineno}\n' log(bt) # We ignore extra allocations in the first iteration. if it != 0: num_leaks += 1 assert not num_leaks, f'{num_leaks=}' def test_4751(): # We run the actual test in a child process, because otherwise previous # tests seem to effect the leak detection causing false positives. It's # possible that these could be real leaks, but they are not the ones # we are testing for here. # if os.path.basename(__file__).startswith(f'test_fitz_'): # Don't test the `fitz` alias, because we assume our leafname. print(f'test_4751(): Not testing with fitz alias.') return if os.environ.get('PYODIDE_ROOT'): print('test_4751(): not running on Pyodide - cannot run child processes.') return GITHUB_ACTIONS = os.environ.get('GITHUB_ACTIONS') if GITHUB_ACTIONS == 'true': # We see additional leaks on Github, don't know why. print(f'test_4751(): {GITHUB_ACTIONS=}; not running on Github because known to fail.') return python_version = [int(i) for i in platform.python_version_tuple()[:2]] python_version_tuple = tuple(python_version) if python_version_tuple < (3, 13): # We see additional leaks with python-3.12. print(f'test_4751(): not running because known to fail on python < 3.13: {platform.python_version_tuple()=}') return import subprocess env_extra = dict(PYTHONPATH = os.path.abspath(f'{__file__}/..')) command = f'{sys.executable} -c "import test_memory; test_memory._test_4751()"' print('', flush=1) print(f'test_4751(): Running: {command!r}', flush=1) print(f'test_4751(): With: {env_extra=}', flush=1) subprocess.run(command, shell=1, check=1, env=os.environ | env_extra) ================================================ FILE: tests/test_metadata.py ================================================ """ 1. Read metadata and compare with stored expected result. 2. Erase metadata and assert object has indeed been deleted. """ import json import os import sys import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "001003ED.pdf") metafile = os.path.join(scriptdir, "resources", "metadata.txt") doc = pymupdf.open(filename) def test_metadata(): assert json.dumps(doc.metadata) == open(metafile).read() def test_erase_meta(): doc.set_metadata({}) # Check PDF trailer and assert that there is no more /Info object # or is set to "null". statement1 = doc.xref_get_key(-1, "Info")[1] == "null" statement2 = "Info" not in doc.xref_get_keys(-1) assert statement2 or statement1 def test_3237(): filename = os.path.abspath(f'{__file__}/../../tests/resources/001003ED.pdf') with pymupdf.open(filename) as doc: # We need to explicitly encode in utf8 on windows. metadata1 = doc.metadata metadata1 = repr(metadata1).encode('utf8') doc.set_metadata({}) metadata2 = doc.metadata metadata2 = repr(metadata2).encode('utf8') print(f'{metadata1=}') print(f'{metadata2=}') assert metadata1 == b'{\'format\': \'PDF 1.6\', \'title\': \'RUBRIK_Editorial_01-06.indd\', \'author\': \'Natalie Schaefer\', \'subject\': \'\', \'keywords\': \'\', \'creator\': \'\', \'producer\': \'Acrobat Distiller 7.0.5 (Windows)\', \'creationDate\': "D:20070113191400+01\'00\'", \'modDate\': "D:20070120104154+01\'00\'", \'trapped\': \'\', \'encryption\': None}' assert metadata2 == b"{'format': 'PDF 1.6', 'title': '', 'author': '', 'subject': '', 'keywords': '', 'creator': '', 'producer': '', 'creationDate': '', 'modDate': '', 'trapped': '', 'encryption': None}" ================================================ FILE: tests/test_mupdf_regressions.py ================================================ import pymupdf import os import gentle_compare scriptdir = os.path.abspath(os.path.dirname(__file__)) def test_707448(): """Confirm page content cleaning does not destroy page appearance.""" filename = os.path.join(scriptdir, "resources", "test-707448.pdf") doc = pymupdf.open(filename) page = doc[0] words0 = page.get_text("words") page.clean_contents(sanitize=True) words1 = page.get_text("words") assert gentle_compare.gentle_compare(words0, words1) def test_707673(): """Confirm page content cleaning does not destroy page appearance. Fails starting with MuPDF v1.23.9. Fixed in: commit 779b8234529cb82aa1e92826854c7bb98b19e44b (golden/master) """ filename = os.path.join(scriptdir, "resources", "test-707673.pdf") doc = pymupdf.open(filename) page = doc[0] words0 = page.get_text("words") page.clean_contents(sanitize=True) words1 = page.get_text("words") ok = gentle_compare.gentle_compare(words0, words1) assert ok def test_707727(): """Confirm page content cleaning does not destroy page appearance. MuPDF issue: https://bugs.ghostscript.com/show_bug.cgi?id=707727 """ filename = os.path.join(scriptdir, "resources", "test_3362.pdf") doc = pymupdf.open(filename) page = doc[0] pix0 = page.get_pixmap() page.clean_contents(sanitize=True) page = doc.reload_page(page) # required to prevent re-use pix1 = page.get_pixmap() rms = gentle_compare.pixmaps_rms(pix0, pix1) print(f'{rms=}', flush=1) pix0.save(os.path.normpath(f'{__file__}/../../tests/test_707727_pix0.png')) pix1.save(os.path.normpath(f'{__file__}/../../tests/test_707727_pix1.png')) # New sanitising gives small fp rounding errors. assert rms < 0.05 def test_707721(): """Confirm text extraction works for nested MCID with Type 3 fonts. PyMuPDF issue https://github.com/pymupdf/PyMuPDF/issues/3357 MuPDF issue: https://bugs.ghostscript.com/show_bug.cgi?id=707721 """ filename = os.path.join(scriptdir, "resources", "test_3357.pdf") doc = pymupdf.open(filename) page = doc[0] ok = page.get_text() assert ok def test_3376(): """Check fix of MuPDF bug 707733. https://bugs.ghostscript.com/show_bug.cgi?id=707733 PyMuPDF issue https://github.com/pymupdf/PyMuPDF/issues/3376 Test file contains a redaction for the first 3 words: "Table of Contents". Test strategy: - extract all words (sorted) - apply redactions - extract words again - confirm: we now have 3 words less and remaining words are equal. """ filename = os.path.join(scriptdir, "resources", "test_3376.pdf") doc = pymupdf.open(filename) page = doc[0] words0 = page.get_text("words", sort=True) words0_s = words0[:3] # first 3 words words0_e = words0[3:] # remaining words assert " ".join([w[4] for w in words0_s]) == "Table of Contents" page.apply_redactions() words1 = page.get_text("words", sort=True) ok = gentle_compare.gentle_compare(words0_e, words1) assert ok ================================================ FILE: tests/test_named_links.py ================================================ import pymupdf import os def test_2886(): """Confirm correct insertion of a 'named' link.""" if not hasattr(pymupdf, "mupdf"): print(f"test_2886(): not running on classic.") return path = os.path.abspath(f"{__file__}/../../tests/resources/cython.pdf") doc = pymupdf.open(path) # name "Doc-Start" is a valid named destination in that file link = { "kind": pymupdf.LINK_NAMED, "from": pymupdf.Rect(0, 0, 50, 50), "name": "Doc-Start", } # insert this link in an arbitrary page & rect page = doc[-1] page.insert_link(link) # need this to update the internal MuPDF annotations array page = doc.reload_page(page) # our new link must be the last in the following list links = page.get_links() l_dict = links[-1] assert l_dict["kind"] == pymupdf.LINK_NAMED assert l_dict["nameddest"] == link["name"] assert l_dict["from"] == link["from"] def test_2922(): """Confirm correct recycling of a 'named' link. Re-insertion of a named link item in 'Page.get_links()' does not have the required "name" key. We test the fallback here that uses key "nameddest" instead. """ if not hasattr(pymupdf, "mupdf"): print(f"test_2922(): not running on classic.") return path = os.path.abspath(f"{__file__}/../../tests/resources/cython.pdf") doc = pymupdf.open(path) page = doc[2] # page has a few links, all are named links = page.get_links() # list of all links link0 = links[0] # take arbitrary link (1st one is ok) page.insert_link(link0) # insert it again page = doc.reload_page(page) # ensure page updates links = page.get_links() # access all links again link1 = links[-1] # re-inserted link # confirm equality of relevant key-values assert link0["nameddest"] == link1["nameddest"] assert link0["page"] == link1["page"] assert link0["to"] == link1["to"] assert link0["from"] == link1["from"] def test_3301(): """Test correct differentiation between URI and LAUNCH links. Links encoded as /URI in PDF are converted to either LINK_URI or LINK_LAUNCH in PyMuPDF. This function ensures that the 'Link.uri' containing a ':' colon is converted to a URI if not explicitly starting with "file://". """ if not hasattr(pymupdf, "mupdf"): print(f"test_3301(): not running on classic.") return # list of links and their expected link "kind" upon extraction text = { "https://www.google.de": pymupdf.LINK_URI, "http://www.google.de": pymupdf.LINK_URI, "mailto:jorj.x.mckie@outlook.de": pymupdf.LINK_URI, "www.wikipedia.de": pymupdf.LINK_LAUNCH, "awkward:resource": pymupdf.LINK_URI, "ftp://www.google.de": pymupdf.LINK_URI, "some.program": pymupdf.LINK_LAUNCH, "file://some.program": pymupdf.LINK_LAUNCH, "another.exe": pymupdf.LINK_LAUNCH, } # make enough "from" rectangles r = pymupdf.Rect(0, 0, 50, 20) rects = [r + (0, r.height * i, 0, r.height * i) for i in range(len(text.keys()))] # make test page and insert above links as kind=LINK_URI doc = pymupdf.open() page = doc.new_page() for i, k in enumerate(text.keys()): link = {"kind": pymupdf.LINK_URI, "uri": k, "from": rects[i]} page.insert_link(link) # re-cycle the PDF preparing for link extraction pdfdata = doc.write() doc = pymupdf.open("pdf", pdfdata) page = doc[0] for link in page.get_links(): # Extract the link text. Must be 'file' or 'uri'. t = link["uri"] if (_ := link.get("file")) is None else _ assert text[t] == link["kind"] ================================================ FILE: tests/test_nonpdf.py ================================================ """ * Check EPUB document is no PDF * Check page access using (chapter, page) notation * Re-layout EPUB ensuring a previous location is memorized """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "Bezier.epub") doc = pymupdf.open(filename) def test_isnopdf(): assert not doc.is_pdf def test_pageids(): assert doc.chapter_count == 7 assert doc.last_location == (6, 1) assert doc.prev_location((6, 0)) == (5, 11) assert doc.next_location((5, 11)) == (6, 0) # Check page numbers have no gaps: i = 0 for chapter in range(doc.chapter_count): for cpno in range(doc.chapter_page_count(chapter)): assert doc.page_number_from_location((chapter, cpno)) == i i += 1 def test_layout(): """Memorize a page location, re-layout with ISO-A4, assert pre-determined location.""" loc = doc.make_bookmark((5, 11)) doc.layout(pymupdf.Rect(pymupdf.paper_rect("a4"))) assert doc.find_bookmark(loc) == (5, 6) ================================================ FILE: tests/test_object_manipulation.py ================================================ """ Check some low-level PDF object manipulations: 1. Set page rotation and compare with string in object definition. 2. Set page rotation via string manipulation and compare with result of proper page property. 3. Read the PDF trailer and verify it has the keys "/Root", "/ID", etc. """ import pymupdf import os scriptdir = os.path.abspath(os.path.dirname(__file__)) resources = os.path.join(scriptdir, "resources") filename = os.path.join(resources, "001003ED.pdf") def test_rotation1(): doc = pymupdf.open() page = doc.new_page() page.set_rotation(270) assert doc.xref_get_key(page.xref, "Rotate") == ("int", "270") def test_rotation2(): doc = pymupdf.open() page = doc.new_page() doc.xref_set_key(page.xref, "Rotate", "270") assert page.rotation == 270 def test_trailer(): """Access PDF trailer information.""" doc = pymupdf.open(filename) xreflen = doc.xref_length() _, xreflen_str = doc.xref_get_key(-1, "Size") assert xreflen == int(xreflen_str) trailer_keys = doc.xref_get_keys(-1) assert "ID" in trailer_keys assert "Root" in trailer_keys def test_valid_name(): """Verify correct PDF names in method xref_set_key.""" doc = pymupdf.open() page = doc.new_page() # testing name in "key": confirm correct spec is accepted doc.xref_set_key(page.xref, "Rotate", "90") assert page.rotation == 90 # check wrong spec is detected error_generated = False try: # illegal char in name (white space) doc.xref_set_key(page.xref, "my rotate", "90") except ValueError as e: assert str(e) == "bad 'key'" error_generated = True assert error_generated # test name in "value": confirm correct spec is accepted doc.xref_set_key(page.xref, "my_rotate/something", "90") assert doc.xref_get_key(page.xref, "my_rotate/something") == ("int", "90") doc.xref_set_key(page.xref, "my_rotate", "/90") assert doc.xref_get_key(page.xref, "my_rotate") == ("name", "/90") # check wrong spec is detected error_generated = False try: # no slash inside name allowed doc.xref_set_key(page.xref, "my_rotate", "/9/0") except ValueError as e: assert str(e) == "bad 'value'" error_generated = True assert error_generated ================================================ FILE: tests/test_objectstreams.py ================================================ import pymupdf def test_objectstream1(): """Test save option "use_objstms". This option compresses PDF object definitions into a special object type "ObjStm". We test its presence by searching for that /Type. """ # make some arbitrary page with content text = "Hello, World! Hallo, Welt!" doc = pymupdf.open() page = doc.new_page() rect = (50, 50, 200, 500) page.insert_htmlbox(rect, text) # place into the rectangle _ = doc.write(use_objstms=True) found = False for xref in range(1, doc.xref_length()): objstring = doc.xref_object(xref, compressed=True) if "/Type/ObjStm" in objstring: found = True break assert found, "No object stream found" def test_objectstream2(): """Test save option "use_objstms". This option compresses PDF object definitions into a special object type "ObjStm". We test its presence by searching for that /Type. """ # make some arbitrary page with content text = "Hello, World! Hallo, Welt!" doc = pymupdf.open() page = doc.new_page() rect = (50, 50, 200, 500) page.insert_htmlbox(rect, text) # place into the rectangle _ = doc.write(use_objstms=False) found = False for xref in range(1, doc.xref_length()): objstring = doc.xref_object(xref, compressed=True) if "/Type/ObjStm" in objstring: found = True break assert not found, "Unexpected: Object stream found!" def test_objectstream3(): """Test ez_save(). Should automatically use object streams """ import io fp = io.BytesIO() # make some arbitrary page with content text = "Hello, World! Hallo, Welt!" doc = pymupdf.open() page = doc.new_page() rect = (50, 50, 200, 500) page.insert_htmlbox(rect, text) # place into the rectangle doc.ez_save(fp) # save PDF to memory found = False for xref in range(1, doc.xref_length()): objstring = doc.xref_object(xref, compressed=True) if "/Type/ObjStm" in objstring: found = True break assert found, "No object stream found!" ================================================ FILE: tests/test_optional_content.py ================================================ """ Test of Optional Content code. """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) filename = os.path.join(scriptdir, "resources", "joined.pdf") def test_oc1(): """Arbitrary calls to OC code to get coverage.""" doc = pymupdf.open() ocg1 = doc.add_ocg("ocg1") ocg2 = doc.add_ocg("ocg2") ocg3 = doc.add_ocg("ocg3") ocmd1 = doc.set_ocmd(xref=0, ocgs=(ocg1, ocg2)) doc.set_layer(-1) doc.add_layer("layer1") test = doc.get_layer() test = doc.get_layers() test = doc.get_ocgs() test = doc.layer_ui_configs() doc.switch_layer(0) def test_oc2(): # source file with at least 4 pages src = pymupdf.open(filename) # new PDF with one page doc = pymupdf.open() page = doc.new_page() # define the 4 rectangle quadrants to receive the source pages r0 = page.rect / 2 r1 = r0 + (r0.width, 0, r0.width, 0) r2 = r0 + (0, r0.height, 0, r0.height) r3 = r2 + (r2.width, 0, r2.width, 0) # make 4 OCGs - one for each source page image. # only first is ON initially ocg0 = doc.add_ocg("ocg0", on=True) ocg1 = doc.add_ocg("ocg1", on=False) ocg2 = doc.add_ocg("ocg2", on=False) ocg3 = doc.add_ocg("ocg3", on=False) ocmd0 = doc.set_ocmd(ve=["and", ocg0, ["not", ["or", ocg1, ocg2, ocg3]]]) ocmd1 = doc.set_ocmd(ve=["and", ocg1, ["not", ["or", ocg0, ocg2, ocg3]]]) ocmd2 = doc.set_ocmd(ve=["and", ocg2, ["not", ["or", ocg1, ocg0, ocg3]]]) ocmd3 = doc.set_ocmd(ve=["and", ocg3, ["not", ["or", ocg1, ocg2, ocg0]]]) ocmds = (ocmd0, ocmd1, ocmd2, ocmd3) # insert the 4 source page images, each connected to one OCG page.show_pdf_page(r0, src, 0, oc=ocmd0) page.show_pdf_page(r1, src, 1, oc=ocmd1) page.show_pdf_page(r2, src, 2, oc=ocmd2) page.show_pdf_page(r3, src, 3, oc=ocmd3) xobj_ocmds = [doc.get_oc(item[0]) for item in page.get_xobjects() if item[1] != 0] assert set(ocmds) <= set(xobj_ocmds) assert set((ocg0, ocg1, ocg2, ocg3)) == set(tuple(doc.get_ocgs().keys())) doc.get_ocmd(ocmd0) page.get_oc_items() def test_3143(): """Support for non-ascii layer names.""" doc = pymupdf.open(os.path.join(scriptdir, "resources", "test-3143.pdf")) page = doc[0] set0 = set([l["text"] for l in doc.layer_ui_configs()]) set1 = set([p["layer"] for p in page.get_drawings()]) set2 = set([b[2] for b in page.get_bboxlog(layers=True)]) assert set0 == set1 == set2 def test_3180(): doc = pymupdf.open() page = doc.new_page() # Define the items for the combo box combo_items = ['first', 'second', 'third'] # Create a combo box field combo_box = pymupdf.Widget() # create a new widget combo_box.field_type = pymupdf.PDF_WIDGET_TYPE_COMBOBOX combo_box.field_name = "myComboBox" combo_box.field_value = combo_items[0] combo_box.choice_values = combo_items combo_box.rect = pymupdf.Rect(50, 50, 200, 75) # position of the combo box combo_box.script_change = """ var value = event.value; app.alert('You selected: ' + value); //var group_id = optional_content_group_ids[value]; """ # Insert the combo box into the page # https://pymupdf.readthedocs.io/en/latest/page.html#Page.add_widget page.add_widget(combo_box) # Create optional content groups # https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/jupyter-notebooks/optional-content.ipynb # Load images and create OCGs for each optional_content_group_ids = {} for i, item in enumerate(combo_items): optional_content_group_id = doc.add_ocg(item, on=False) optional_content_group_ids[item] = optional_content_group_id rect = pymupdf.Rect(50, 100, 250, 300) image_file_name = f'{item}.png' # xref = page.insert_image( # rect, # filename=image_file_name, # oc=optional_content_group_id, # ) first_id = optional_content_group_ids['first'] second_id = optional_content_group_ids['second'] third_id = optional_content_group_ids['third'] # https://pymupdf.readthedocs.io/en/latest/document.html#Document.set_layer doc.set_layer(-1, basestate="OFF") layers = doc.get_layer() doc.set_layer(config=-1, on=[first_id]) # https://pymupdf.readthedocs.io/en/latest/document.html#Document.set_layer_ui_config # configs = doc.layer_ui_configs() # doc.set_layer_ui_config(0, pymupdf.PDF_OC_ON) # doc.set_layer_ui_config('third', action=2) # Save the PDF doc.save(os.path.abspath(f'{__file__}/../../tests/test_3180.pdf')) doc.close() ================================================ FILE: tests/test_page_links.py ================================================ import pymupdf import os def test_page_links_generator(): # open some arbitrary PDF path = os.path.abspath(f"{__file__}/../../tests/resources/2.pdf") doc = pymupdf.open(path) # select an arbitrary page page = doc[-1] # iterate over pages.links link_generator = page.links() links = list(link_generator) assert len(links) == 7 ================================================ FILE: tests/test_pagedelete.py ================================================ """ ---------------------------------------------------- This tests correct functioning of multi-page delete ---------------------------------------------------- Create a PDF in memory with 100 pages with a unique text each. Also create a TOC with a bookmark per page. On every page after the first to-be-deleted page, also insert a link, which points to this page. The bookmark text equals the text on the page for easy verification. Then delete some pages and verify: - the new TOC has empty items exactly for every deleted page - the remaining TOC items still point to the correct page - the document has no more links at all """ import os import pymupdf scriptdir = os.path.dirname(__file__) page_count = 100 # initial document length r = range(5, 35, 5) # contains page numbers we will delete # insert this link on pages after first deleted one link = { "from": pymupdf.Rect(100, 100, 120, 120), "kind": pymupdf.LINK_GOTO, "page": r[0], "to": pymupdf.Point(100, 100), } def test_deletion(): # First prepare the document. doc = pymupdf.open() toc = [] for i in range(page_count): page = doc.new_page() # make a page page.insert_text((100, 100), "%i" % i) # insert unique text if i > r[0]: # insert a link page.insert_link(link) toc.append([1, "%i" % i, i + 1]) # TOC bookmark to this page doc.set_toc(toc) # insert the TOC assert doc.has_links() # check we did insert links # Test page deletion. # Delete pages in range and verify result del doc[r] assert not doc.has_links() # verify all links have gone assert doc.page_count == page_count - len(r) # correct number deleted? toc_new = doc.get_toc() # this is the modified TOC # verify number of emptied items (have page number -1) assert len([item for item in toc_new if item[-1] == -1]) == len(r) # Deleted page numbers must correspond to TOC items with page number -1. for i in r: assert toc_new[i][-1] == -1 # Remaining pages must be correctly pointed to by the non-empty TOC items for item in toc_new: pno = item[-1] if pno == -1: # one of the emptied items continue pno -= 1 # PDF page number text = doc[pno].get_text().replace("\n", "") # toc text must equal text on page assert text == item[1] doc.delete_page(0) # just for the coverage stats del doc[5:10] doc.select(range(doc.page_count)) doc.copy_page(0) doc.move_page(0) doc.fullcopy_page(0) def test_3094(): path = os.path.abspath(f"{__file__}/../../tests/resources/test_2871.pdf") document = pymupdf.open(path) pnos = [i for i in range(0, document.page_count, 2)] document.delete_pages(pnos) def test_3150(): """Assert correct functioning for problem file. Implicitly also check use of new MuPDF function pdf_rearrange_pages() since version 1.23.9. """ filename = os.path.join(scriptdir, "resources", "test-3150.pdf") pages = [3, 3, 3, 2, 3, 1, 0, 0] doc = pymupdf.open(filename) doc.select(pages) assert doc.page_count == len(pages) def test_4462(): path0 = os.path.normpath(f'{__file__}/../../tests/resources/test_4462_0.pdf') path1 = os.path.normpath(f'{__file__}/../../tests/resources/test_4462_1.pdf') path2 = os.path.normpath(f'{__file__}/../../tests/resources/test_4462_2.pdf') with pymupdf.open() as document: document.new_page() document.new_page() document.new_page() document.new_page() document.save(path0) with pymupdf.open(path0) as document: assert len(document) == 4 document.delete_page(-1) document.save(path1) with pymupdf.open(path1) as document: assert len(document) == 3 document.delete_pages(-1) document.save(path2) with pymupdf.open(path2) as document: assert len(document) == 2 def test_4790(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4790.pdf') path2 = os.path.normpath(f'{__file__}/../../tests/test_4790_out.pdf') print() page_to_delete = 1 # Reproduce the problem. with pymupdf.open(path) as document: wt = pymupdf.TOOLS.mupdf_warnings() assert not wt, f'{wt=}' assert len(document) == 2, f'{len(document)=}' document.delete_pages(page_to_delete) assert len(document) == 1, f'{len(document)=}' document.save(path2) wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document', f'{wt=}' with pymupdf.open(path2) as document: # Expect incorrect result. assert len(document) == 2, f'{len(document)=}' # Call mupdf.pdf_repair_xref() before delete_pages(); this works around the # problem. with pymupdf.open(path) as document: document_pdf = pymupdf._as_pdf_document(document) pymupdf.mupdf.pdf_repair_xref(document_pdf) wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document', f'{wt=}' document.delete_pages(page_to_delete) document.save(path2) with pymupdf.open(path2) as document: # Expect correct result. assert len(document) == 1 # Call mupdf.pdf_check_document() before delete_pages(); this works around # the problem. with pymupdf.open(path) as document: document_pdf = pymupdf._as_pdf_document(document) pymupdf.mupdf.pdf_check_document(document_pdf) wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document', f'{wt=}' document.delete_pages(page_to_delete) document.save(path2) with pymupdf.open(path2) as document: # Expect correct result. assert len(document) == 1 # Check that document is marked as repaired after save. with pymupdf.open(path) as document: assert not document.is_repaired, f'{document.is_repaired=}' document.save(path2) assert document.is_repaired, f'{document.is_repaired=}' wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document', f'{wt=}' # Check that raise_on_repair=True works. with pymupdf.open(path) as document: try: document.save(path2, raise_on_repair=True) except Exception as e: print(f'Received expected exception: {e}', flush=1) else: assert 0, 'Did not get expected exception.' wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document' # Check that Document.repair() works. with pymupdf.open(path) as document: document.repair() wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'repairing PDF document' document.delete_pages(page_to_delete) document.save(path2, raise_on_repair=True) with pymupdf.open(path2) as document: # Expect correct result. assert len(document) == 1, f'{len(document)=}' ================================================ FILE: tests/test_pagelabels.py ================================================ """ Define some page labels in a PDF. Check success in various aspects. """ import pymupdf def make_doc(): """Makes a PDF with 10 pages.""" doc = pymupdf.open() for i in range(10): page = doc.new_page() return doc def make_labels(): """Return page label range rules. - Rule 1: labels like "A-n", page 0 is first and has "A-1". - Rule 2: labels as capital Roman numbers, page 4 is first and has "I". """ return [ {"startpage": 0, "prefix": "A-", "style": "D", "firstpagenum": 1}, {"startpage": 4, "prefix": "", "style": "R", "firstpagenum": 1}, ] def test_setlabels(): """Check setting and inquiring page labels. - Make a PDF with 10 pages - Label pages - Inquire labels of pages - Get list of page numbers for a given label. """ doc = make_doc() doc.set_page_labels(make_labels()) page_labels = [p.get_label() for p in doc] answer = ["A-1", "A-2", "A-3", "A-4", "I", "II", "III", "IV", "V", "VI"] assert page_labels == answer, f"page_labels={page_labels}" assert doc.get_page_numbers("V") == [8] assert doc.get_page_labels() == make_labels() def test_labels_styleA(): """Test correct indexing for styles "a", "A".""" doc = make_doc() labels = [ {"startpage": 0, "prefix": "", "style": "a", "firstpagenum": 1}, {"startpage": 5, "prefix": "", "style": "A", "firstpagenum": 1}, ] doc.set_page_labels(labels) pdfdata = doc.tobytes() doc.close() doc = pymupdf.open("pdf", pdfdata) answer = ["a", "b", "c", "d", "e", "A", "B", "C", "D", "E"] page_labels = [page.get_label() for page in doc] assert page_labels == answer assert doc.get_page_labels() == labels ================================================ FILE: tests/test_pixmap.py ================================================ """ Pixmap tests * make pixmap of a page and assert bbox size * make pixmap from a PDF xref and compare with extracted image * pixmap from file and from binary image and compare """ import pymupdf import gentle_compare import os import platform import re import shutil import subprocess import sys import tempfile import pytest import textwrap import time import util scriptdir = os.path.abspath(os.path.dirname(__file__)) epub = os.path.join(scriptdir, "resources", "Bezier.epub") pdf = os.path.join(scriptdir, "resources", "001003ED.pdf") imgfile = os.path.join(scriptdir, "resources", "nur-ruhig.jpg") def test_pagepixmap(): # pixmap from an EPUB page doc = pymupdf.open(epub) page = doc[0] pix = page.get_pixmap() assert pix.irect == page.rect.irect pix = page.get_pixmap(alpha=True) assert pix.alpha assert pix.n == pix.colorspace.n + pix.alpha def test_pdfpixmap(): # pixmap from xref in a PDF doc = pymupdf.open(pdf) # take first image item of first page img = doc.get_page_images(0)[0] # make pixmap of it pix = pymupdf.Pixmap(doc, img[0]) # assert pixmap properties assert pix.width == img[2] assert pix.height == img[3] # extract image and compare metadata extractimg = doc.extract_image(img[0]) assert extractimg["width"] == pix.width assert extractimg["height"] == pix.height def test_filepixmap(): # pixmaps from file and from stream # should lead to same result pix1 = pymupdf.Pixmap(imgfile) stream = open(imgfile, "rb").read() pix2 = pymupdf.Pixmap(stream) assert repr(pix1) == repr(pix2) assert pix1.digest == pix2.digest def test_pilsave(): # pixmaps from file then save to pillow image # make pixmap from this and confirm equality try: pix1 = pymupdf.Pixmap(imgfile) stream = pix1.pil_tobytes("JPEG") pix2 = pymupdf.Pixmap(stream) assert repr(pix1) == repr(pix2) except ModuleNotFoundError: assert platform.system() in ('Windows', 'Emscripten') and sys.maxsize == 2**31 - 1 def test_save(tmpdir): # pixmaps from file then save to image # make pixmap from this and confirm equality pix1 = pymupdf.Pixmap(imgfile) outfile = os.path.join(tmpdir, "foo.png") pix1.save(outfile, output="png") # read it back pix2 = pymupdf.Pixmap(outfile) assert repr(pix1) == repr(pix2) def test_setalpha(): # pixmap from JPEG file, then add an alpha channel # with 30% transparency pix1 = pymupdf.Pixmap(imgfile) opa = int(255 * 0.3) # corresponding to 30% transparency alphas = [opa] * (pix1.width * pix1.height) alphas = bytearray(alphas) pix2 = pymupdf.Pixmap(pix1, 1) # add alpha channel pix2.set_alpha(alphas) # make image 30% transparent samples = pix2.samples # copy of samples # confirm correct the alpha bytes t = bytearray([samples[i] for i in range(3, len(samples), 4)]) assert t == alphas def test_color_count(): ''' This is known to fail if MuPDF is built without PyMuPDF's custom config.h, e.g. in Linux system installs. ''' pm = pymupdf.Pixmap(imgfile) assert pm.color_count() == 40624 def test_memoryview(): pm = pymupdf.Pixmap(imgfile) samples = pm.samples_mv assert isinstance( samples, memoryview) print( f'samples={samples} samples.itemsize={samples.itemsize} samples.nbytes={samples.nbytes} samples.ndim={samples.ndim} samples.shape={samples.shape} samples.strides={samples.strides}') assert samples.itemsize == 1 assert samples.nbytes == 659817 assert samples.ndim == 1 assert samples.shape == (659817,) assert samples.strides == (1,) color = pm.pixel( 100, 100) print( f'color={color}') assert color == (83, 66, 40) def test_samples_ptr(): pm = pymupdf.Pixmap(imgfile) samples = pm.samples_ptr print( f'samples={samples}') assert isinstance( samples, int) def test_2369(): width, height = 13, 37 image = pymupdf.Pixmap(pymupdf.csGRAY, width, height, b"\x00" * (width * height), False) with pymupdf.Document(stream=image.tobytes(output="pam"), filetype="pam") as doc: test_pdf_bytes = doc.convert_to_pdf() with pymupdf.Document(stream=test_pdf_bytes) as doc: page = doc[0] img_xref = page.get_images()[0][0] img = doc.extract_image(img_xref) img_bytes = img["image"] pymupdf.Pixmap(img_bytes) def test_page_idx_int(): doc = pymupdf.open(pdf) with pytest.raises(AssertionError): doc["0"] assert doc[0] assert doc[(0,0)] def test_fz_write_pixmap_as_jpeg(): width, height = 13, 37 image = pymupdf.Pixmap(pymupdf.csGRAY, width, height, b"\x00" * (width * height), False) with pymupdf.Document(stream=image.tobytes(output="jpeg"), filetype="jpeg") as doc: test_pdf_bytes = doc.convert_to_pdf() def test_3020(): pm = pymupdf.Pixmap(imgfile) pm2 = pymupdf.Pixmap(pm, 20, 30, None) pm3 = pymupdf.Pixmap(pymupdf.csGRAY, pm) pm4 = pymupdf.Pixmap(pm, pm3) def test_3050(): ''' This is known to fail if MuPDF is built without it's default third-party libraries, e.g. in Linux system installs. ''' path = os.path.normpath(f'{__file__}/../../tests/resources/001003ED.pdf') with pymupdf.open(path) as pdf_file: page_no = 0 page = pdf_file[page_no] zoom_x = 4.0 zoom_y = 4.0 matrix = pymupdf.Matrix(zoom_x, zoom_y) pix = page.get_pixmap(matrix=matrix) path_out = os.path.normpath(f'{__file__}/../../tests/test_3050_out.png') pix.save(path_out) print(f'{pix.width=} {pix.height=}') def product(x, y): for yy in y: for xx in x: yield (xx, yy) n = 0 # We use a small subset of the image because non-optimised build gets # very slow. for pos in product(range(100), range(100)): if sum(pix.pixel(pos[0], pos[1])) >= 600: n += 1 pix.set_pixel(pos[0], pos[1], (255, 255, 255)) path_out2 = os.path.normpath(f'{__file__}/../../tests/test_3050_out2.png') pix.save(path_out2) path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3050_expected.png') rms = gentle_compare.pixmaps_rms(path_expected, path_out2) print(f'{rms=}') assert rms == 0 wt = pymupdf.TOOLS.mupdf_warnings() if (1, 26, 0) <= pymupdf.mupdf_version_tuple < (1, 27): assert wt == 'bogus font ascent/descent values (0 / 0)\nPDF stream Length incorrect' else: assert wt == 'PDF stream Length incorrect' def test_3058(): doc = pymupdf.Document(os.path.abspath(f'{__file__}/../../tests/resources/test_3058.pdf')) images = doc[0].get_images(full=True) pix = pymupdf.Pixmap(doc, 17) # First bug was that `pix.colorspace` was DeviceRGB. assert str(pix.colorspace) == 'Colorspace(CS_CMYK) - DeviceCMYK' pix = pymupdf.Pixmap(pymupdf.csRGB, pix) assert str(pix.colorspace) == 'Colorspace(CS_RGB) - DeviceRGB' # Second bug was that the image was converted to RGB via greyscale proofing # color space, so image contained only shades of grey. This compressed # easily to a .png file, so we crudely check the bug is fixed by looking at # size of .png file. path = os.path.abspath(f'{__file__}/../../tests/test_3058_out.png') pix.save(path) s = os.path.getsize(path) assert 1800000 < s < 2600000, f'Unexpected size of {path}: {s}' def test_3072(): path = os.path.abspath(f'{__file__}/../../tests/resources/test_3072.pdf') out = os.path.abspath(f'{__file__}/../../tests') doc = pymupdf.open(path) page_48 = doc[0] bbox = [147, 300, 447, 699] rect = pymupdf.Rect(*bbox) zoom = pymupdf.Matrix(3, 3) pix = page_48.get_pixmap(clip=rect, matrix=zoom) image_save_path = f'{out}/1.jpg' pix.save(image_save_path, jpg_quality=95) doc = pymupdf.open(path) page_49 = doc[1] bbox = [147, 543, 447, 768] rect = pymupdf.Rect(*bbox) zoom = pymupdf.Matrix(3, 3) pix = page_49.get_pixmap(clip=rect, matrix=zoom) image_save_path = f'{out}/2.jpg' pix.save(image_save_path, jpg_quality=95) wt = pymupdf.TOOLS.mupdf_warnings() assert wt == ( "syntax error: cannot find ExtGState resource 'BlendMode0'\n" "encountered syntax errors; page may not be correct\n" "syntax error: cannot find ExtGState resource 'BlendMode0'\n" "encountered syntax errors; page may not be correct" ) def test_3134(): doc = pymupdf.Document() page = doc.new_page() page.get_pixmap(clip=pymupdf.Rect(0, 0, 100, 100)).save("test_3134_rect.jpg") page.get_pixmap(clip=pymupdf.IRect(0, 0, 100, 100)).save("test_3134_irect.jpg") stat_rect = os.stat('test_3134_rect.jpg') stat_irect = os.stat('test_3134_irect.jpg') print(f' {stat_rect=}') print(f'{stat_irect=}') assert stat_rect.st_size == stat_irect.st_size def test_3177(): path = os.path.abspath(f'{__file__}/../../tests/resources/img-transparent.png') pixmap = pymupdf.Pixmap(path) pixmap2 = pymupdf.Pixmap(None, pixmap) def test_3493(): ''' If python3-gi is installed, we check fix for #3493, where importing gi would load an older version of libjpeg than is used in MuPDF, and break MuPDF. This test is excluded by default in sysinstall tests, because running commands in a new venv does not seem to pick up pymupdf as expected. ''' if platform.system() != 'Linux': print(f'Not running because not Linux: {platform.system()=}') return import subprocess root = os.path.abspath(f'{__file__}/../..') venv = f'{root}/tests/resources/test_3493_venv' shutil.rmtree(venv, ignore_errors=1) in_path = f'{root}/tests/resources/test_3493.epub' def run(command, check=1, stdout=None): print(f'Running with {check=}: {command}') return subprocess.run(command, shell=1, check=check, stdout=stdout, text=1) def run_code(code, code_path, *, check=True, venv=None, venv_args='', pythonpath=None, stdout=None): code = textwrap.dedent(code) with open(code_path, 'w') as f: f.write(code) prefix = f'PYTHONPATH={pythonpath} ' if pythonpath else '' if venv: # Have seen this fail on Github in a curious way: # # Running: /tmp/tmp.fBeKNLJQKk/venv/bin/python -m venv --system-site-packages /project/tests/resources/test_3493_venv # Error: [Errno 2] No such file or directory: '/project/tests/resources/test_3493_venv/bin/python' # r = run(f'{sys.executable} -m venv {venv_args} {venv}', check=check) if r.returncode: return r r = run(f'. {venv}/bin/activate && {prefix}python {code_path}', check=check, stdout=stdout) else: r = run(f'{prefix}{sys.executable} {code_path}', check=check, stdout=stdout) return r # Find location of system install of `gi`. r = run_code( ''' from gi.repository import GdkPixbuf import gi print(gi.__file__) ''' , f'{root}/tests/resources/test_3493_gi.py', check=0, venv=venv, venv_args='--system-site-packages', stdout=subprocess.PIPE, ) if r.returncode: print(f'test_3493(): Not running test because --system-site-packages venv cannot import gi.') return gi = r.stdout.strip() gi_pythonpath = os.path.abspath(f'{gi}/../..') def do(gi): # Run code that will import gi and pymupdf in different orders, and # return contents of generated .png file as a bytes. out = f'{root}/tests/resources/test_3493_{gi}.png' run_code( f''' if {gi}==0: import pymupdf elif {gi}==1: from gi.repository import GdkPixbuf import pymupdf elif {gi}==2: import pymupdf from gi.repository import GdkPixbuf else: assert 0 document = pymupdf.Document('{in_path}') page = document[0] print(f'{gi=}: saving to: {out}') page.get_pixmap().save('{out}') ''' , os.path.abspath(f'{root}/tests/resources/test_3493_{gi}.py'), pythonpath=gi_pythonpath, ) with open(out, 'rb') as f: return f.read() out0 = do(0) out1 = do(1) out2 = do(2) print(f'{len(out0)=} {len(out1)=} {len(out2)=}.') assert out1 == out0 assert out2 == out0 def test_3848(): if util.skip_slow_tests('test_3848'): return if os.environ.get('PYMUPDF_RUNNING_ON_VALGRIND') == '1': # Takes 40m on Github. print(f'test_3848(): not running on valgrind because very slow.', flush=1) return if platform.python_implementation() == 'GraalVM': print(f'test_3848(): Not running because slow on GraalVM.') return path = os.path.normpath(f'{__file__}/../../tests/resources/test_3848.pdf') with pymupdf.open(path) as document: for i in range(len(document)): page = document.load_page(i) print(f'{page=}.') for annot in page.get_drawings(): if page.get_textbox(annot['rect']): rect = annot['rect'] pixmap = page.get_pixmap(clip=rect) color_bytes = pixmap.color_topusage() def test_3994(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3994.pdf') with pymupdf.open(path) as document: page = document[0] txt_blocks = [blk for blk in page.get_text('dict')['blocks'] if blk['type']==0] for blk in txt_blocks: pix = page.get_pixmap(clip=pymupdf.Rect([int(v) for v in blk['bbox']]), colorspace=pymupdf.csRGB, alpha=False) percent, color = pix.color_topusage() wt = pymupdf.TOOLS.mupdf_warnings() assert wt == 'premature end of data in flate filter\n... repeated 2 times...' def test_3448(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3448.pdf') with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap(alpha=False, dpi=150) path_out = f'{path}.png' pixmap.save(path_out) print(f'Have written to: {path_out}') path_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3448.pdf-expected.png') pixmap_expected = pymupdf.Pixmap(path_expected) rms = gentle_compare.pixmaps_rms(pixmap, pixmap_expected) diff = gentle_compare.pixmaps_diff(pixmap_expected, pixmap) path_diff = os.path.normpath(f'{__file__}/../../tests/test_3448-diff.png') diff.save(path_diff) print(f'{rms=}') assert rms == 0 def test_3854(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3854.pdf') with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap() pixmap.save(os.path.normpath(f'{__file__}/../../tests/test_3854_out.png')) # 2024-11-29: this is the incorrect expected output. path_expected_png = os.path.normpath(f'{__file__}/../../tests/resources/test_3854_expected.png') pixmap_expected = pymupdf.Pixmap(path_expected_png) pixmap_diff = gentle_compare.pixmaps_diff(pixmap_expected, pixmap) path_diff = os.path.normpath(f'{__file__}/../../tests/resources/test_3854_diff.png') pixmap_diff.save(path_diff) rms = gentle_compare.pixmaps_rms(pixmap, pixmap_expected) print(f'{rms=}.') if os.environ.get('PYMUPDF_SYSINSTALL_TEST') == '1': # MuPDF using external third-party libs gives slightly different # behaviour. assert rms < 2 else: assert rms == 0 def test_4155(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_3854.pdf') with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap() mv = pixmap.samples_mv mvb1 = mv.tobytes() del page del pixmap try: mvb2 = mv.tobytes() except ValueError as e: print(f'Received exception: {e}') assert 'operation forbidden on released memoryview object' in str(e) else: assert 0, f'Did not receive expected exception when using defunct memoryview.' def test_4336(): if 0: # Compare with last classic release. import pickle path_out = os.path.normpath(f'{__file__}/../../tests/resources/test_4336_cc') code = textwrap.dedent(f''' import fitz import os import time import pickle path = os.path.normpath(f'{__file__}/../../tests/resources/nur-ruhig.jpg') pixmap = fitz.Pixmap(path) t = time.time() for i in range(10): cc = pixmap.color_count() t = time.time() - t print(f'test_4336(): {{t=}}') with open({path_out!r}, 'wb') as f: pickle.dump(cc, f) ''') path_code = os.path.normpath(f'{__file__}/../../tests/resources/test_4336.py') with open(path_code, 'w') as f: f.write(code) venv = os.path.normpath(f'{__file__}/../../tests/resources/test_4336_venv') command = f'{sys.executable} -m venv {venv}' command += f' && . {venv}/bin/activate' command += f' && pip install --force-reinstall pymupdf==1.23.8' command += f' && python {path_code}' print(f'Running: {command}', flush=1) subprocess.run(command, shell=1, check=1) with open(path_out, 'rb') as f: cc_old = pickle.load(f) else: cc_old = None path = os.path.normpath(f'{__file__}/../../tests/resources/nur-ruhig.jpg') pixmap = pymupdf.Pixmap(path) t = time.time() for i in range(10): cc = pixmap.color_count() t = time.time() - t print(f'test_4336(): {t=}') if cc_old: assert cc == cc_old def test_4435(): # This is slow, e.g. 224s. if util.skip_slow_tests('test_4435'): return print(f'{pymupdf.version=}') path = os.path.normpath(f'{__file__}/../../tests/resources/test_4435.pdf') with pymupdf.open(path) as document: page = document[2] print(f'Calling page.get_pixmap().', flush=1) if ( pymupdf.mupdf_version_tuple >= (1, 27) and ( os.environ.get('PYODIDE_ROOT') or (platform.system() == 'Windows' and sys.maxsize.bit_length()+1 == 32) ) ): # 2025-11-07: Expect alloc failure. try: pixmap = page.get_pixmap(alpha=False, dpi=120) except Exception as e: print(f'Received exception: {type(e)=}: {e}') assert isinstance(e, pymupdf.mupdf.FzErrorSystem), f'Unrecognised {type(e)=}' m = re.match('code=2: malloc [(][0-9]+ bytes[)] failed', str(e)) assert m, f'Unrecognised exception text: {e}' return else: # Hopefully this means that mupdf has been fixed. assert 0, 'Expected alloc failure on pyodide' else: pixmap = page.get_pixmap(alpha=False, dpi=120) print(f'Called page.get_pixmap().', flush=1) if pymupdf.mupdf_version_tuple < (1, 27): assert pymupdf.TOOLS.mupdf_warnings() == 'bogus font ascent/descent values (0 / 0)\n... repeated 9 times...' elif pymupdf.mupdf_version_tuple >= (1, 28, 0): wt_expected = ('limit error: Overly large image\ncannot render glyph\n' * 42).rstrip() assert pymupdf.TOOLS.mupdf_warnings() == wt_expected def test_4423(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4423.pdf') with pymupdf.open(path) as document: path2 = f'{path}.pdf' ee = None try: document.save( path2, garbage=4, expand=1, deflate=True, pretty=True, no_new_id=True, ) except Exception as e: print(f'Exception: {e}') ee = e assert not ee, f'Received unexpected exception: {e}' wt = pymupdf.TOOLS.mupdf_warnings() if pymupdf.mupdf_version_tuple >= (1, 28, 0): assert wt == '' else: assert wt == 'format error: cannot find object in xref (56 0 R)\nformat error: cannot find object in xref (68 0 R)' def test_4445(): if os.environ.get('PYODIDE_ROOT'): print('test_4445(): not running on Pyodide - cannot run child processes.') return print() # Test case is large so we download it instead of having it in PyMuPDF # git. We put it in `cache/` directory do it is not removed by `git clean` # (unless `-d` is specified). import util path = util.download( 'https://github.com/user-attachments/files/19738242/ss.pdf', 'test_4445.pdf', size=2671185, ) with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap() print(f'{pixmap.width=}') print(f'{pixmap.height=}') assert (pixmap.width, pixmap.height) == (792, 612) if 0: path_pixmap = f'{path}.png' pixmap.save(path_pixmap) print(f'Have created {path_pixmap=}') wt = pymupdf.TOOLS.mupdf_warnings() print(f'{wt=}') assert wt == 'broken xref subsection, proceeding anyway.\nTrailer Size is off-by-one. Ignoring.' def test_3806(): print() print(f'{pymupdf.mupdf_version=}') path = os.path.normpath(f'{__file__}/../../tests/resources/test_3806.pdf') path_png_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_3806-expected.png') path_png = os.path.normpath(f'{__file__}/../../tests/test_3806.png') with pymupdf.open(path) as document: pixmap = document[0].get_pixmap() pixmap.save(path_png) rms = gentle_compare.pixmaps_rms(path_png_expected, pixmap) print(f'{rms=}') if pymupdf.mupdf_version_tuple >= (1, 26, 6): assert rms < 0.1 else: assert rms > 50 def test_4388(): print() path_BOZ1 = os.path.normpath(f'{__file__}/../../tests/resources/test_4388_BOZ1.pdf') path_BUL1 = os.path.normpath(f'{__file__}/../../tests/resources/test_4388_BUL1.pdf') path_correct = os.path.normpath(f'{__file__}/../../tests/resources/test_4388_BUL1.pdf.correct.png') path_test = os.path.normpath(f'{__file__}/../../tests/resources/test_4388_BUL1.pdf.test.png') with pymupdf.open(path_BUL1) as bul: pixmap_correct = bul.load_page(0).get_pixmap() pixmap_correct.save(path_correct) pymupdf.TOOLS.store_shrink(100) with pymupdf.open(path_BOZ1) as boz: boz.load_page(0).get_pixmap() with pymupdf.open(path_BUL1) as bul: pixmap_test = bul.load_page(0).get_pixmap() pixmap_test.save(path_test) rms = gentle_compare.pixmaps_rms(pixmap_correct, pixmap_test) print(f'{rms=}') if pymupdf.mupdf_version_tuple >= (1, 26, 6): assert rms == 0 else: assert rms >= 10 def test_4699(): path = os.path.normpath(f'{__file__}/../../tests/resources/test_4699.pdf') path_png_expected = os.path.normpath(f'{__file__}/../../tests/resources/test_4699.png') path_png_actual = os.path.normpath(f'{__file__}/../../tests/test_4699.png') with pymupdf.open(path) as document: page = document[0] pixmap = page.get_pixmap() pixmap.save(path_png_actual) print(f'Have saved to {path_png_actual=}.') rms = gentle_compare.pixmaps_rms(path_png_expected, pixmap) print(f'test_4699(): {rms=}') if pymupdf.mupdf_version_tuple >= (1, 26, 11): assert rms == 0 else: wt = pymupdf.TOOLS.mupdf_warnings() assert 'syntax error: cannot find ExtGState resource' in wt assert rms > 20 ================================================ FILE: tests/test_pylint.py ================================================ import pymupdf import os import re import subprocess import sys import textwrap def test_pylint(): if os.environ.get('PYODIDE_ROOT'): print('test_pylint(): not running on Pyodide - cannot run child processes.') return if not hasattr(pymupdf, 'mupdf'): print(f'test_pylint(): Not running with classic implementation.') return ignores = '' ignores += textwrap.dedent( ''' C0103: Constant name "g_exceptions_verbose" doesn't conform to UPPER_CASE naming style (invalid-name) C0115: Missing class docstring (missing-class-docstring) C0116: Missing function or method docstring (missing-function-docstring) C0301: Line too long (142/100) (line-too-long) C0302: Too many lines in module (23586/1000) (too-many-lines) C0303: Trailing whitespace (trailing-whitespace) C0325: Unnecessary parens after 'not' keyword (superfluous-parens) C0415: Import outside toplevel (traceback) (import-outside-toplevel) R0902: Too many instance attributes (9/7) (too-many-instance-attributes) R0903: Too few public methods (1/2) (too-few-public-methods) R0911: Too many return statements (9/6) (too-many-return-statements) R0913: Too many arguments (6/5) (too-many-arguments) R1705: Unnecessary "elif" after "return", remove the leading "el" from "elif" (no-else-return) R1720: Unnecessary "elif" after "raise", remove the leading "el" from "elif" (no-else-raise) R1724: Unnecessary "elif" after "continue", remove the leading "el" from "elif" (no-else-continue) R1735: Consider using '{}' instead of a call to 'dict'. (use-dict-literal) W0511: Fixme: we don't support JM_MEMORY=1. (fixme) W0622: Redefining built-in 'FileNotFoundError' (redefined-builtin) W0622: Redefining built-in 'open' (redefined-builtin) W1309: Using an f-string that does not have any interpolated variables (f-string-without-interpolation) R1734: Consider using [] instead of list() (use-list-literal) R1727: Boolean condition '0 and g_exceptions_verbose' will always evaluate to '0' (condition-evals-to-constant) R1726: (simplifiable-condition) ''' ) # Items that we might want to fix. ignores += textwrap.dedent( ''' C0114: Missing module docstring (missing-module-docstring) C0117: Consider changing "not rotate % 90 == 0" to "rotate % 90 != 0" (unnecessary-negation) C0123: Use isinstance() rather than type() for a typecheck. (unidiomatic-typecheck) C0200: Consider using enumerate instead of iterating with range and len (consider-using-enumerate) C0201: Consider iterating the dictionary directly instead of calling .keys() (consider-iterating-dictionary) C0209: Formatting a regular string which could be an f-string (consider-using-f-string) C0305: Trailing newlines (trailing-newlines) C0321: More than one statement on a single line (multiple-statements) C1802: Do not use `len(SEQUENCE)` without comparison to determine if a sequence is empty (use-implicit-booleaness-not-len) C1803: "select == []" can be simplified to "not select", if it is strictly a sequence, as an empty list is falsey (use-implicit-booleaness-not-comparison) R0912: Too many branches (18/12) (too-many-branches) R0914: Too many local variables (20/15) (too-many-locals) R0915: Too many statements (58/50) (too-many-statements) R1702: Too many nested blocks (7/5) (too-many-nested-blocks) R1703: The if statement can be replaced with 'var = bool(test)' (simplifiable-if-statement) R1710: Either all return statements in a function should return an expression, or none of them should. (inconsistent-return-statements) R1714: Consider merging these comparisons with 'in' by using 'width not in (1, 0)'. Use a set instead if elements are hashable. (consider-using-in) R1716: Simplify chained comparison between the operands (chained-comparison) R1717: Consider using a dictionary comprehension (consider-using-dict-comprehension) R1718: Consider using a set comprehension (consider-using-set-comprehension) R1719: The if expression can be replaced with 'bool(test)' (simplifiable-if-expression) R1721: Unnecessary use of a comprehension, use list(roman_num(num)) instead. (unnecessary-comprehension) R1728: Consider using a generator instead 'max(len(k) for k in item.keys())' (consider-using-generator) R1728: Consider using a generator instead 'max(len(r.cells) for r in self.rows)' (consider-using-generator) R1730: Consider using 'rowheight = min(rowheight, height)' instead of unnecessary if block (consider-using-min-builtin) R1731: Consider using 'right = max(right, x1)' instead of unnecessary if block (consider-using-max-builtin) W0105: String statement has no effect (pointless-string-statement) W0107: Unnecessary pass statement (unnecessary-pass) W0212: Access to a protected member _graft_id of a client class (protected-access) W0602: Using global for 'CHARS' but no assignment is done (global-variable-not-assigned) W0602: Using global for 'EDGES' but no assignment is done (global-variable-not-assigned) W0603: Using the global statement (global-statement) W0612: Unused variable 'keyvals' (unused-variable) W0613: Unused argument 'kwargs' (unused-argument) W0621: Redefining name 'show' from outer scope (line 159) (redefined-outer-name) W0640: Cell variable o defined in loop (cell-var-from-loop) W0718: Catching too general exception Exception (broad-exception-caught) W0719: Raising too general exception: Exception (broad-exception-raised) C3001: Lambda expression assigned to a variable. Define a function using the "def" keyword instead. (unnecessary-lambda-assignment) R0801: Similar lines in 2 files R0917: Too many positional arguments (7/5) (too-many-positional-arguments) ''' ) ignores_list = list() for line in ignores.split('\n'): if not line or line.startswith('#'): continue m = re.match('^(.....): ', line) assert m, f'Failed to parse {line=}' ignores_list.append(m.group(1)) ignores = ','.join(ignores_list) root = os.path.abspath(f'{__file__}/../..') import pipcl # We want to run pylist on all of our src/*.py files so we find them with # `pipcl.git_items()`. However this seems to fail on github windows with # `fatal: not a git repository (or any of the parent directories): .git` so # we also hard-code the list and verify it matches `git ls-files` on other # platforms. This ensures that we will always pick up new .py files in the # future. # command = f'pylint -d {ignores}' directory = f'{root}/src' directory = directory.replace('/', os.sep) leafs = [ '__init__.py', '__main__.py', '_apply_pages.py', '_wxcolors.py', 'fitz___init__.py', 'fitz_table.py', 'fitz_utils.py', 'pipcl.py', 'pymupdf.py', 'table.py', 'utils.py', 'wdev.py', ] leafs.sort() try: leafs_git = pipcl.git_items(directory) except Exception as e: import platform assert platform.system() == 'Windows' else: leafs_git = [i for i in leafs_git if i.endswith('.py')] leafs_git.sort() assert leafs_git == leafs, f'leafs:\n {leafs!r}\nleafs_git:\n {leafs_git!r}' for leaf in leafs: if leaf == 'pipcl.py': # Has various warnings but it's old code that we will eventually stop using. continue command += f' {directory}/{leaf}' print(f'Running: {command}') subprocess.run(command, shell=1, check=1) ================================================ FILE: tests/test_release.py ================================================ import pymupdf import os import re import sys g_root_abs = os.path.normpath(f'{__file__}/../../') sys.path.insert(0, g_root_abs) sys.path.insert(0, f'{g_root_abs}/src') try: import pipcl import setup finally: del sys.path[0:2] g_root = pipcl.relpath(g_root_abs) def _file_line(path, text, re_match, offset=+2): ''' Returns : for location of regex match. path: filename. text: Contents of . re_match: A re.Match. offset: Added to line number of start of . Default offset=2 is because callers usually grep for leading newline, and line numbers are generally 1-based. ''' text_before = text[:re_match.start()] line = text_before.count('\n') + offset return f'{path}:{line}' def test_release_versions(): ''' PyMuPDF and default MuPDF must have same major.minor version. ''' version_p_tuple = [int(i) for i in setup.version_p.split('.')] version_mupdf_tuple = [int(i) for i in setup.version_mupdf.split('.')] assert version_p_tuple[:2] == version_mupdf_tuple[:2], \ f'PyMuPDF and MuPDF major.minor versions do not match. {setup.version_p=} {setup.version_mupdf=}.' def test_release_bug_template(): ''' Bug report template must list current PyMuPDF version. ''' p = f'{g_root}/.github/ISSUE_TEMPLATE/bug_report.yml' expected = f'\n - {setup.version_p}\n' with open(p) as f: text = f.read() assert expected in text, f'{p}:1: Failed to find line for {setup.version_p=}, {expected!r}.' def test_release_changelog_version(): ''' In changes.txt, first item must match setup.version_p. ''' p = f'{g_root}/changes.txt' with open(p) as f: text = f.read() # We match `**Changes in version a.b.c**' optionally followed by ` (YYYY-MM-DD)`. m = re.search(f'\n[*][*]Changes in version ([0-9.]+)[*][*]( [([0-9-]+[)])?\n', text) assert m, f'Cannot parse {p}.' assert m[1] == setup.version_p, \ f'{_file_line(p, text, m)}: Cannot find {setup.version_p=} in first changelog item: {m[0].strip()!r}.' def test_release_changelog_mupdf_version(): ''' In changes.txt, first mentioned of MuPDF must match setup.version_mupdf. ''' p = f'{g_root}/changes.txt' with open(p) as f: text = f.read() m = re.search(f'\n[*] Use MuPDF-([0-9.]+)[.]\n', text) assert m, f'Cannot parse {p}.' assert m[1] == setup.version_mupdf, \ f'{_file_line(p, text, m)}: First mentioned MuPDF version does not match {setup.version_mupdf=}: {m[0].strip()!r}.' ================================================ FILE: tests/test_remove-rotation.py ================================================ import os import pymupdf from gentle_compare import gentle_compare scriptdir = os.path.dirname(__file__) def test_remove_rotation(): """Remove rotation verifying identical appearance and text.""" filename = os.path.join(scriptdir, "resources", "test-2812.pdf") doc = pymupdf.open(filename) # We always create fresh pages to avoid false positives from cache content. # Text on these pages consists of pairwise different strings, sorting by # these strings must therefore yield identical bounding boxes. for i in range(1, doc.page_count): assert doc[i].rotation # must be a rotated page pix0 = doc[i].get_pixmap() # make image words0 = [] for w in doc[i].get_text("words"): words0.append(list(pymupdf.Rect(w[:4]) * doc[i].rotation_matrix) + [w[4]]) words0.sort(key=lambda w: w[4]) # sort by word strings # derotate page and confirm nothing else has changed doc[i].remove_rotation() assert doc[i].rotation == 0 pix1 = doc[i].get_pixmap() words1 = doc[i].get_text("words") words1.sort(key=lambda w: w[4]) # sort by word strings assert pix1.digest == pix0.digest, f"{pix1.digest}/{pix0.digest}" assert gentle_compare(words0, words1) ================================================ FILE: tests/test_rewrite_images.py ================================================ import pymupdf import os scriptdir = os.path.dirname(__file__) def test_rewrite_images(): """Example for decreasing file size by more than 30%.""" filename = os.path.join(scriptdir, "resources", "test-rewrite-images.pdf") doc = pymupdf.open(filename) size0 = os.path.getsize(doc.name) doc.rewrite_images(dpi_threshold=100, dpi_target=72, quality=33) data = doc.tobytes(garbage=3, deflate=True) size1 = len(data) assert (1 - (size1 / size0)) > 0.3 ================================================ FILE: tests/test_rtl.py ================================================ import pymupdf import os def test_rtl(): path = os.path.normpath(f'{__file__}/../../tests/resources/test-E+A.pdf') doc = pymupdf.open(path) page = doc[0] # set of all RTL characters rtl_chars = set([chr(i) for i in range(0x590, 0x901)]) for w in page.get_text("words"): # every word string must either ONLY contain RTL chars cond1 = rtl_chars.issuperset(w[4]) # ... or NONE. cond2 = rtl_chars.intersection(w[4]) == set() assert cond1 or cond2 ================================================ FILE: tests/test_showpdfpage.py ================================================ """ Tests: * Convert some image to a PDF * Insert it rotated in some rectangle of a PDF page * Assert PDF Form XObject has been created * Assert that image contained in inserted PDF is inside given rectangle """ import os import pymupdf scriptdir = os.path.abspath(os.path.dirname(__file__)) imgfile = os.path.join(scriptdir, "resources", "nur-ruhig.jpg") def test_insert(): doc = pymupdf.open() page = doc.new_page() rect = pymupdf.Rect(50, 50, 100, 100) # insert in here img = pymupdf.open(imgfile) # open image tobytes = img.convert_to_pdf() # get its PDF version (bytes object) src = pymupdf.open("pdf", tobytes) # open as PDF xref = page.show_pdf_page(rect, src, 0, rotate=-23) # insert in rectangle # extract just inserted image info img = page.get_images(True)[0] assert img[-1] == xref # xref of Form XObject! img = page.get_image_info()[0] # read the page's images # Multiple computations may have lead to rounding deviations, so we need # some generosity here: enlarge rect by 1 point in each direction. assert img["bbox"] in rect + (-1, -1, 1, 1) def test_2742(): dest = pymupdf.open() destpage = dest.new_page(width=842, height=595) a5 = pymupdf.Rect(0, 0, destpage.rect.width / 3, destpage.rect.height) shiftright = pymupdf.Rect(destpage.rect.width/3, 0, destpage.rect.width/3, 0) src = pymupdf.open(os.path.abspath(f'{__file__}/../../tests/resources/test_2742.pdf')) destpage.show_pdf_page(a5, src, 0) destpage.show_pdf_page(a5 + shiftright, src, 0) destpage.show_pdf_page(a5 + shiftright + shiftright, src, 0) dest.save(os.path.abspath(f'{__file__}/../../tests/test_2742-out.pdf')) print("The end!") wt = pymupdf.TOOLS.mupdf_warnings() assert wt == ( 'Circular dependencies! Consider page cleaning.\n' '... repeated 3 times...' ), f'{wt=}' ================================================ FILE: tests/test_spikes.py ================================================ import pymupdf import pathlib import os def test_spikes(): """Check suppression of text spikes caused by long miters.""" root = os.path.abspath(f"{__file__}/../..") spikes_yes = pathlib.Path(f"{root}/docs/images/spikes-yes.png") spikes_no = pathlib.Path(f"{root}/docs/images/spikes-no.png") doc = pymupdf.open() text = "NATO MEMBERS" # some text provoking spikes ("N", "M") point = (10, 35) # insert point # make text provoking spikes page = doc.new_page(width=200, height=50) # small page page.insert_text( point, text, fontsize=20, render_mode=1, # stroke text only border_width=0.3, # causes thick border lines miter_limit=None, # do not care about miter spikes ) # write same text in white over the previous for better demo purpose page.insert_text(point, text, fontsize=20, color=(1, 1, 1)) pix1 = page.get_pixmap() assert pix1.tobytes() == spikes_yes.read_bytes() # make text suppressing spikes page = doc.new_page(width=200, height=50) page.insert_text( point, text, fontsize=20, render_mode=1, border_width=0.3, miter_limit=1, # suppress each and every miter spike ) page.insert_text(point, text, fontsize=20, color=(1, 1, 1)) pix2 = page.get_pixmap() assert pix2.tobytes() == spikes_no.read_bytes() ================================================ FILE: tests/test_story.py ================================================ import pymupdf import os import textwrap def test_story(): otf = os.path.abspath(f'{__file__}/../resources/PragmaticaC.otf') # 2023-12-06: latest mupdf throws exception if path uses back-slashes. otf = otf.replace('\\', '/') CSS = f""" @font-face {{font-family: test; src: url({otf});}} """ HTML = """